diff --git a/.eggs/README.txt b/.eggs/README.txt deleted file mode 100644 index 5d016688..00000000 --- a/.eggs/README.txt +++ /dev/null @@ -1,6 +0,0 @@ -This directory contains eggs that were downloaded by setuptools to build, test, and run plug-ins. - -This directory caches those eggs to prevent repeated downloads. - -However, it is safe to delete this directory. - diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/PKG-INFO b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/PKG-INFO deleted file mode 100644 index d497e1e4..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/PKG-INFO +++ /dev/null @@ -1,153 +0,0 @@ -Metadata-Version: 1.1 -Name: boto3 -Version: 1.7.75 -Summary: The AWS SDK for Python -Home-page: https://github.com/boto/boto3 -Author: Amazon Web Services -Author-email: UNKNOWN -License: Apache License 2.0 -Description: =============================== - Boto 3 - The AWS SDK for Python - =============================== - - |Build Status| |Docs| |Version| |Gitter| - - Boto3 is the Amazon Web Services (AWS) Software Development Kit (SDK) for - Python, which allows Python developers to write software that makes use - of services like Amazon S3 and Amazon EC2. You can find the latest, most - up to date, documentation at `Read the Docs`_, including a list of - services that are supported. To see only those features which have been - released, check out the `stable docs`_. - - - .. _boto: https://docs.pythonboto.org/ - .. _`stable docs`: https://boto3.readthedocs.io/en/stable/ - .. _`Read the Docs`: https://boto3.readthedocs.io/en/latest/ - .. |Build Status| image:: http://img.shields.io/travis/boto/boto3/develop.svg?style=flat - :target: https://travis-ci.org/boto/boto3 - :alt: Build Status - .. |Gitter| image:: https://badges.gitter.im/boto/boto3.svg - :target: https://gitter.im/boto/boto3 - :alt: Gitter - .. |Docs| image:: https://readthedocs.org/projects/boto3/badge/?version=latest&style=flat - :target: https://boto3.readthedocs.io/en/latest/ - :alt: Read the docs - .. |Downloads| image:: http://img.shields.io/pypi/dm/boto3.svg?style=flat - :target: https://pypi.python.org/pypi/boto3/ - :alt: Downloads - .. |Version| image:: http://img.shields.io/pypi/v/boto3.svg?style=flat - :target: https://pypi.python.org/pypi/boto3/ - :alt: Version - .. |License| image:: http://img.shields.io/pypi/l/boto3.svg?style=flat - :target: https://github.com/boto/boto3/blob/develop/LICENSE - :alt: License - - Quick Start - ----------- - First, install the library and set a default region: - - .. code-block:: sh - - $ pip install boto3 - - Next, set up credentials (in e.g. ``~/.aws/credentials``): - - .. code-block:: ini - - [default] - aws_access_key_id = YOUR_KEY - aws_secret_access_key = YOUR_SECRET - - Then, set up a default region (in e.g. ``~/.aws/config``): - - .. code-block:: ini - - [default] - region=us-east-1 - - Then, from a Python interpreter: - - .. code-block:: python - - >>> import boto3 - >>> s3 = boto3.resource('s3') - >>> for bucket in s3.buckets.all(): - print(bucket.name) - - Development - ----------- - - Getting Started - ~~~~~~~~~~~~~~~ - Assuming that you have Python and ``virtualenv`` installed, set up your - environment and install the required dependencies like this instead of - the ``pip install boto3`` defined above: - - .. code-block:: sh - - $ git clone https://github.com/boto/boto3.git - $ cd boto3 - $ virtualenv venv - ... - $ . venv/bin/activate - $ pip install -r requirements.txt - $ pip install -e . - - Running Tests - ~~~~~~~~~~~~~ - You can run tests in all supported Python versions using ``tox``. By default, - it will run all of the unit and functional tests, but you can also specify your own - ``nosetests`` options. Note that this requires that you have all supported - versions of Python installed, otherwise you must pass ``-e`` or run the - ``nosetests`` command directly: - - .. code-block:: sh - - $ tox - $ tox -- unit/test_session.py - $ tox -e py26,py33 -- integration/ - - You can also run individual tests with your default Python version: - - .. code-block:: sh - - $ nosetests tests/unit - - Generating Documentation - ~~~~~~~~~~~~~~~~~~~~~~~~ - Sphinx is used for documentation. You can generate HTML locally with the - following: - - .. code-block:: sh - - $ pip install -r requirements-docs.txt - $ cd docs - $ make html - - - Getting Help - ------------ - - We use GitHub issues for tracking bugs and feature requests and have limited - bandwidth to address them. Please use these community resources for getting - help: - - * Ask a question on `Stack Overflow `__ and tag it with `boto3 `__ - * Come join the AWS Python community chat on `gitter `__ - * Open a support ticket with `AWS Support `__ - * If it turns out that you may have found a bug, please `open an issue `__ - -Platform: UNKNOWN -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: Natural Language :: English -Classifier: License :: OSI Approved :: Apache Software License -Classifier: Programming Language :: Python -Classifier: Programming Language :: Python :: 2.6 -Classifier: Programming Language :: Python :: 2.7 -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.3 -Classifier: Programming Language :: Python :: 3.4 -Classifier: Programming Language :: Python :: 3.5 -Classifier: Programming Language :: Python :: 3.6 -Classifier: Programming Language :: Python :: 3.7 diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/SOURCES.txt b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/SOURCES.txt deleted file mode 100644 index e28b09f2..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/SOURCES.txt +++ /dev/null @@ -1,65 +0,0 @@ -CONTRIBUTING.rst -LICENSE -MANIFEST.in -README.rst -requirements.txt -setup.cfg -setup.py -boto3/__init__.py -boto3/compat.py -boto3/exceptions.py -boto3/session.py -boto3/utils.py -boto3.egg-info/PKG-INFO -boto3.egg-info/SOURCES.txt -boto3.egg-info/dependency_links.txt -boto3.egg-info/requires.txt -boto3.egg-info/top_level.txt -boto3/data/cloudformation/2010-05-15/resources-1.json -boto3/data/cloudwatch/2010-08-01/resources-1.json -boto3/data/dynamodb/2012-08-10/resources-1.json -boto3/data/ec2/2014-10-01/resources-1.json -boto3/data/ec2/2015-03-01/resources-1.json -boto3/data/ec2/2015-04-15/resources-1.json -boto3/data/ec2/2015-10-01/resources-1.json -boto3/data/ec2/2016-04-01/resources-1.json -boto3/data/ec2/2016-09-15/resources-1.json -boto3/data/ec2/2016-11-15/resources-1.json -boto3/data/glacier/2012-06-01/resources-1.json -boto3/data/iam/2010-05-08/resources-1.json -boto3/data/opsworks/2013-02-18/resources-1.json -boto3/data/s3/2006-03-01/resources-1.json -boto3/data/sns/2010-03-31/resources-1.json -boto3/data/sqs/2012-11-05/resources-1.json -boto3/docs/__init__.py -boto3/docs/action.py -boto3/docs/attr.py -boto3/docs/base.py -boto3/docs/client.py -boto3/docs/collection.py -boto3/docs/docstring.py -boto3/docs/method.py -boto3/docs/resource.py -boto3/docs/service.py -boto3/docs/subresource.py -boto3/docs/utils.py -boto3/docs/waiter.py -boto3/dynamodb/__init__.py -boto3/dynamodb/conditions.py -boto3/dynamodb/table.py -boto3/dynamodb/transform.py -boto3/dynamodb/types.py -boto3/ec2/__init__.py -boto3/ec2/createtags.py -boto3/ec2/deletetags.py -boto3/resources/__init__.py -boto3/resources/action.py -boto3/resources/base.py -boto3/resources/collection.py -boto3/resources/factory.py -boto3/resources/model.py -boto3/resources/params.py -boto3/resources/response.py -boto3/s3/__init__.py -boto3/s3/inject.py -boto3/s3/transfer.py \ No newline at end of file diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/dependency_links.txt b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/dependency_links.txt deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/dependency_links.txt +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/not-zip-safe b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/not-zip-safe deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/not-zip-safe +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/requires.txt b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/requires.txt deleted file mode 100644 index a56e468b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/requires.txt +++ /dev/null @@ -1,3 +0,0 @@ -botocore>=1.10.75,<1.11.0 -jmespath>=0.7.1,<1.0.0 -s3transfer>=0.1.10,<0.2.0 diff --git a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/top_level.txt b/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/top_level.txt deleted file mode 100644 index 30ddf823..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/EGG-INFO/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -boto3 diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/__init__.py deleted file mode 100644 index ec3f5417..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/__init__.py +++ /dev/null @@ -1,110 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import logging - -from boto3.session import Session - - -__author__ = 'Amazon Web Services' -__version__ = '1.7.75' - - -# The default Boto3 session; autoloaded when needed. -DEFAULT_SESSION = None - - -def setup_default_session(**kwargs): - """ - Set up a default session, passing through any parameters to the session - constructor. There is no need to call this unless you wish to pass custom - parameters, because a default session will be created for you. - """ - global DEFAULT_SESSION - DEFAULT_SESSION = Session(**kwargs) - - -def set_stream_logger(name='boto3', level=logging.DEBUG, format_string=None): - """ - Add a stream handler for the given name and level to the logging module. - By default, this logs all boto3 messages to ``stdout``. - - >>> import boto3 - >>> boto3.set_stream_logger('boto3.resources', logging.INFO) - - For debugging purposes a good choice is to set the stream logger to ``''`` - which is equivalent to saying "log everything". - - .. WARNING:: - Be aware that when logging anything from ``'botocore'`` the full wire - trace will appear in your logs. If your payloads contain sensitive data - this should not be used in production. - - :type name: string - :param name: Log name - :type level: int - :param level: Logging level, e.g. ``logging.INFO`` - :type format_string: str - :param format_string: Log message format - """ - if format_string is None: - format_string = "%(asctime)s %(name)s [%(levelname)s] %(message)s" - - logger = logging.getLogger(name) - logger.setLevel(level) - handler = logging.StreamHandler() - handler.setLevel(level) - formatter = logging.Formatter(format_string) - handler.setFormatter(formatter) - logger.addHandler(handler) - - -def _get_default_session(): - """ - Get the default session, creating one if needed. - - :rtype: :py:class:`~boto3.session.Session` - :return: The default session - """ - if DEFAULT_SESSION is None: - setup_default_session() - - return DEFAULT_SESSION - - -def client(*args, **kwargs): - """ - Create a low-level service client by name using the default session. - - See :py:meth:`boto3.session.Session.client`. - """ - return _get_default_session().client(*args, **kwargs) - - -def resource(*args, **kwargs): - """ - Create a resource service client by name using the default session. - - See :py:meth:`boto3.session.Session.resource`. - """ - return _get_default_session().resource(*args, **kwargs) - - -# Set up logging to ``/dev/null`` like a library is supposed to. -# http://docs.python.org/3.3/howto/logging.html#configuring-logging-for-a-library -class NullHandler(logging.Handler): - def emit(self, record): - pass - - -logging.getLogger('boto3').addHandler(NullHandler()) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/compat.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/compat.py deleted file mode 100644 index 3a7a832f..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/compat.py +++ /dev/null @@ -1,43 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import sys -import os -import errno -import socket - -from botocore.vendored import six - -if six.PY3: - # In python3, socket.error is OSError, which is too general - # for what we want (i.e FileNotFoundError is a subclass of OSError). - # In py3 all the socket related errors are in a newly created - # ConnectionError - SOCKET_ERROR = ConnectionError -else: - SOCKET_ERROR = socket.error - - -if sys.platform.startswith('win'): - def rename_file(current_filename, new_filename): - try: - os.remove(new_filename) - except OSError as e: - if not e.errno == errno.ENOENT: - # We only want to a ignore trying to remove - # a file that does not exist. If it fails - # for any other reason we should be propagating - # that exception. - raise - os.rename(current_filename, new_filename) -else: - rename_file = os.rename diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudformation/2010-05-15/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudformation/2010-05-15/resources-1.json deleted file mode 100644 index fd439375..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudformation/2010-05-15/resources-1.json +++ /dev/null @@ -1,195 +0,0 @@ -{ - "service": { - "actions": { - "CreateStack": { - "request": { "operation": "CreateStack" }, - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "StackName" } - ] - } - } - }, - "has": { - "Event": { - "resource": { - "type": "Event", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Stack": { - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "Stacks": { - "request": { "operation": "DescribeStacks" }, - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Stacks[].StackName" } - ], - "path": "Stacks[]" - } - } - } - }, - "resources": { - "Event": { - "identifiers": [ - { - "name": "Id", - "memberName": "EventId" - } - ], - "shape": "StackEvent" - }, - "Stack": { - "identifiers": [ - { - "name": "Name", - "memberName": "StackName" - } - ], - "shape": "Stack", - "load": { - "request": { - "operation": "DescribeStacks", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - }, - "path": "Stacks[0]" - }, - "actions": { - "CancelUpdate": { - "request": { - "operation": "CancelUpdateStack", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteStack", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateStack", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "Resource": { - "resource": { - "type": "StackResource", - "identifiers": [ - { "target": "StackName", "source": "identifier", "name": "Name" }, - { "target": "LogicalId", "source": "input" } - ] - } - } - }, - "hasMany": { - "Events": { - "request": { - "operation": "DescribeStackEvents", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Event", - "identifiers": [ - { "target": "Id", "source": "response", "path": "StackEvents[].EventId" } - ], - "path": "StackEvents[]" - } - }, - "ResourceSummaries": { - "request": { - "operation": "ListStackResources", - "params": [ - { "target": "StackName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "StackResourceSummary", - "identifiers": [ - { "target": "LogicalId", "source": "response", "path": "StackResourceSummaries[].LogicalResourceId" }, - { "target": "StackName", "source": "requestParameter", "path": "StackName" } - ], - "path": "StackResourceSummaries[]" - } - } - } - }, - "StackResource": { - "identifiers": [ - { "name": "StackName" }, - { - "name": "LogicalId", - "memberName": "LogicalResourceId" - } - ], - "shape": "StackResourceDetail", - "load": { - "request": { - "operation": "DescribeStackResource", - "params": [ - { "target": "LogicalResourceId", "source": "identifier", "name": "LogicalId" }, - { "target": "StackName", "source": "identifier", "name": "StackName" } - ] - }, - "path": "StackResourceDetail" - }, - "has": { - "Stack": { - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "StackName" } - ] - } - } - } - }, - "StackResourceSummary": { - "identifiers": [ - { "name": "StackName" }, - { - "name": "LogicalId", - "memberName": "LogicalResourceId" - } - ], - "shape": "StackResourceSummary", - "has": { - "Resource": { - "resource": { - "type": "StackResource", - "identifiers": [ - { "target": "LogicalId", "source": "identifier", "name": "LogicalId" }, - { "target": "StackName", "source": "identifier", "name": "StackName" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudwatch/2010-08-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudwatch/2010-08-01/resources-1.json deleted file mode 100644 index e0746d04..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/cloudwatch/2010-08-01/resources-1.json +++ /dev/null @@ -1,334 +0,0 @@ -{ - "service": { - "has": { - "Alarm": { - "resource": { - "type": "Alarm", - "identifiers": [ - { - "target": "Name", - "source": "input" - } - ] - } - }, - "Metric": { - "resource": { - "type": "Metric", - "identifiers": [ - { - "target": "Namespace", - "source": "input" - }, - { - "target": "Name", - "source": "input" - } - ] - } - } - }, - "hasMany": { - "Alarms": { - "request": { "operation": "DescribeAlarms" }, - "resource": { - "type": "Alarm", - "identifiers": [ - { - "target": "Name", - "source": "response", - "path": "MetricAlarms[].AlarmName" - } - ], - "path": "MetricAlarms[]" - } - }, - "Metrics": { - "request": { "operation": "ListMetrics" }, - "resource": { - "type": "Metric", - "identifiers": [ - { - "target": "Namespace", - "source": "response", - "path": "Metrics[].Namespace" - }, - { - "target": "Name", - "source": "response", - "path": "Metrics[].MetricName" - } - ], - "path": "Metrics[]" - } - } - } - }, - "resources": { - "Alarm": { - "identifiers": [ - { - "name": "Name", - "memberName": "AlarmName" - } - ], - "shape": "MetricAlarm", - "load": { - "request": { - "operation": "DescribeAlarms", - "params": [ - { - "target": "AlarmNames[0]", - "source": "identifier", - "name": "Name" - } - ] - }, - "path": "MetricAlarms[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteAlarms", - "params": [ - { - "target": "AlarmNames[0]", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "DescribeHistory": { - "request": { - "operation": "DescribeAlarmHistory", - "params": [ - { - "target": "AlarmName", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "DisableActions": { - "request": { - "operation": "DisableAlarmActions", - "params": [ - { - "target": "AlarmNames[0]", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "EnableActions": { - "request": { - "operation": "EnableAlarmActions", - "params": [ - { - "target": "AlarmNames[0]", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "SetState": { - "request": { - "operation": "SetAlarmState", - "params": [ - { - "target": "AlarmName", - "source": "identifier", - "name": "Name" - } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteAlarms", - "params": [ - { - "target": "AlarmNames[]", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "DisableActions": { - "request": { - "operation": "DisableAlarmActions", - "params": [ - { - "target": "AlarmNames[]", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "EnableActions": { - "request": { - "operation": "EnableAlarmActions", - "params": [ - { - "target": "AlarmNames[]", - "source": "identifier", - "name": "Name" - } - ] - } - } - }, - "has": { - "Metric": { - "resource": { - "type": "Metric", - "identifiers": [ - { - "target": "Namespace", - "source": "data", - "path": "Namespace" - }, - { - "target": "Name", - "source": "data", - "path": "MetricName" - } - ] - } - } - } - }, - "Metric": { - "identifiers": [ - { - "name": "Namespace", - "memberName": "Namespace" - }, - { - "name": "Name", - "memberName": "MetricName" - } - ], - "shape": "Metric", - "load": { - "request": { - "operation": "ListMetrics", - "params": [ - { - "target": "MetricName", - "source": "identifier", - "name": "Name" - }, - { - "target": "Namespace", - "source": "identifier", - "name": "Namespace" - } - ] - }, - "path": "Metrics[0]" - }, - "actions": { - "GetStatistics": { - "request": { - "operation": "GetMetricStatistics", - "params": [ - { - "target": "Namespace", - "source": "identifier", - "name": "Namespace" - }, - { - "target": "MetricName", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "PutAlarm": { - "request": { - "operation": "PutMetricAlarm", - "params": [ - { - "target": "Namespace", - "source": "identifier", - "name": "Namespace" - }, - { - "target": "MetricName", - "source": "identifier", - "name": "Name" - } - ] - }, - "resource": { - "type": "Alarm", - "identifiers": [ - { - "target": "Name", - "source": "requestParameter", - "path": "AlarmName" - } - ] - } - }, - "PutData": { - "request": { - "operation": "PutMetricData", - "params": [ - { - "target": "Namespace", - "source": "identifier", - "name": "Namespace" - }, - { - "target": "MetricData[].MetricName", - "source": "identifier", - "name": "Name" - } - ] - } - } - }, - "hasMany": { - "Alarms": { - "request": { - "operation": "DescribeAlarmsForMetric", - "params": [ - { - "target": "Namespace", - "source": "identifier", - "name": "Namespace" - }, - { - "target": "MetricName", - "source": "identifier", - "name": "Name" - } - ] - }, - "resource": { - "type": "Alarm", - "identifiers": [ - { - "target": "Name", - "source": "response", - "path": "MetricAlarms[].AlarmName" - } - ], - "path": "MetricAlarms[]" - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/dynamodb/2012-08-10/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/dynamodb/2012-08-10/resources-1.json deleted file mode 100644 index b79994e2..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/dynamodb/2012-08-10/resources-1.json +++ /dev/null @@ -1,150 +0,0 @@ -{ - "service": { - "actions": { - "BatchGetItem": { - "request": { "operation": "BatchGetItem" } - }, - "BatchWriteItem": { - "request": { "operation": "BatchWriteItem" } - }, - "CreateTable": { - "request": { "operation": "CreateTable" }, - "resource": { - "type": "Table", - "identifiers": [ - { "target": "Name", "source": "response", "path": "TableDescription.TableName" } - ], - "path": "TableDescription" - } - } - }, - "has": { - "Table": { - "resource": { - "type": "Table", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "Tables": { - "request": { "operation": "ListTables" }, - "resource": { - "type": "Table", - "identifiers": [ - { "target": "Name", "source": "response", "path": "TableNames[]" } - ] - } - } - } - }, - "resources": { - "Table": { - "identifiers": [ - { - "name": "Name", - "memberName": "TableName" - } - ], - "shape": "TableDescription", - "load": { - "request": { - "operation": "DescribeTable", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - }, - "path": "Table" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTable", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "DeleteItem": { - "request": { - "operation": "DeleteItem", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "GetItem": { - "request": { - "operation": "GetItem", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "PutItem": { - "request": { - "operation": "PutItem", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "Query": { - "request": { - "operation": "Query", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "Scan": { - "request": { - "operation": "Scan", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateTable", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Table", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "Name" } - ], - "path": "TableDescription" - } - }, - "UpdateItem": { - "request": { - "operation": "UpdateItem", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "waiters":{ - "Exists": { - "waiterName": "TableExists", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - }, - "NotExists": { - "waiterName": "TableNotExists", - "params": [ - { "target": "TableName", "source": "identifier", "name": "Name" } - ] - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2014-10-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2014-10-01/resources-1.json deleted file mode 100644 index 8ccf160a..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2014-10-01/resources-1.json +++ /dev/null @@ -1,2289 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "requestParameter", "path": "Resources[]" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-03-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-03-01/resources-1.json deleted file mode 100644 index 8ccf160a..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-03-01/resources-1.json +++ /dev/null @@ -1,2289 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "requestParameter", "path": "Resources[]" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-04-15/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-04-15/resources-1.json deleted file mode 100644 index 8ccf160a..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-04-15/resources-1.json +++ /dev/null @@ -1,2289 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "requestParameter", "path": "Resources[]" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-10-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-10-01/resources-1.json deleted file mode 100644 index 4831a36b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2015-10-01/resources-1.json +++ /dev/null @@ -1,2567 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ], - "path": "@" - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "ClassicAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "standard" } - ] - }, - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "response", "path": "Addresses[].PublicIp" } - ], - "path": "Addresses[]" - } - }, - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "vpc" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "ClassicAddress": { - "identifiers": [ - { - "name": "PublicIp" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "PublicIps[]", "source": "identifier", "name": "PublicIp" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "PublicIp", "source": "identifier", "name": "PublicIp" } - ] - } - }, - "Disassociate": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - } - } - }, - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "ClassicAddress": { - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "data", "path": "PublicIpAddress" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "NetworkInterfaces": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "data", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPair", - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "KeyPairInfo": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "Association.AssociationId" } - ], - "path": "Association" - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterfaceAssociation": { - "identifiers": [ - { - "name": "Id" - } - ], - "shape": "InstanceNetworkInterfaceAssociation", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "association.association-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0].Association" - }, - "actions": { - "Delete": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Address": { - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "Route": { - "identifiers": [ - { "name": "RouteTableId" }, - { - "name": "DestinationCidrBlock", - "memberName": "DestinationCidrBlock" - } - ], - "shape": "Route", - "actions": { - "Delete": { - "request": { - "operation": "DeleteRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - }, - "Replace": { - "request": { - "operation": "ReplaceRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "RouteTableId" } - ] - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "requestParameter", "path": "DestinationCidrBlock" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Routes": { - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "data", "path": "Routes[].DestinationCidrBlock" } - ], - "path": "Routes[]" - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "VpcPeeringConnectionExists", - "params": [ - { "target": "VpcPeeringConnectionIds[]", "source": "identifier", "name": "Id" } - ], - "path": "VpcPeeringConnections[0]" - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - }, - "VpcAddress": { - "identifiers": [ - { - "name": "AllocationId" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "AllocationIds[0]", "source": "identifier", "name": "AllocationId" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "AllocationId", "source": "identifier", "name": "AllocationId" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AssociationId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-04-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-04-01/resources-1.json deleted file mode 100644 index 4831a36b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-04-01/resources-1.json +++ /dev/null @@ -1,2567 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ], - "path": "@" - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "ClassicAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "standard" } - ] - }, - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "response", "path": "Addresses[].PublicIp" } - ], - "path": "Addresses[]" - } - }, - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "vpc" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "ClassicAddress": { - "identifiers": [ - { - "name": "PublicIp" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "PublicIps[]", "source": "identifier", "name": "PublicIp" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "PublicIp", "source": "identifier", "name": "PublicIp" } - ] - } - }, - "Disassociate": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - } - } - }, - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "ClassicAddress": { - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "data", "path": "PublicIpAddress" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "NetworkInterfaces": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "data", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPair", - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "KeyPairInfo": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "Association.AssociationId" } - ], - "path": "Association" - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterfaceAssociation": { - "identifiers": [ - { - "name": "Id" - } - ], - "shape": "InstanceNetworkInterfaceAssociation", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "association.association-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0].Association" - }, - "actions": { - "Delete": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Address": { - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "Route": { - "identifiers": [ - { "name": "RouteTableId" }, - { - "name": "DestinationCidrBlock", - "memberName": "DestinationCidrBlock" - } - ], - "shape": "Route", - "actions": { - "Delete": { - "request": { - "operation": "DeleteRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - }, - "Replace": { - "request": { - "operation": "ReplaceRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "RouteTableId" } - ] - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "requestParameter", "path": "DestinationCidrBlock" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Routes": { - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "data", "path": "Routes[].DestinationCidrBlock" } - ], - "path": "Routes[]" - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "VpcPeeringConnectionExists", - "params": [ - { "target": "VpcPeeringConnectionIds[]", "source": "identifier", "name": "Id" } - ], - "path": "VpcPeeringConnections[0]" - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - }, - "VpcAddress": { - "identifiers": [ - { - "name": "AllocationId" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "AllocationIds[0]", "source": "identifier", "name": "AllocationId" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "AllocationId", "source": "identifier", "name": "AllocationId" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AssociationId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-09-15/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-09-15/resources-1.json deleted file mode 100644 index 4831a36b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-09-15/resources-1.json +++ /dev/null @@ -1,2567 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ], - "path": "@" - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "ClassicAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "standard" } - ] - }, - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "response", "path": "Addresses[].PublicIp" } - ], - "path": "Addresses[]" - } - }, - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "vpc" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "ClassicAddress": { - "identifiers": [ - { - "name": "PublicIp" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "PublicIps[]", "source": "identifier", "name": "PublicIp" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "PublicIp", "source": "identifier", "name": "PublicIp" } - ] - } - }, - "Disassociate": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - } - } - }, - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "ClassicAddress": { - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "data", "path": "PublicIpAddress" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "NetworkInterfaces": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "data", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPair", - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "KeyPairInfo": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "Association.AssociationId" } - ], - "path": "Association" - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterfaceAssociation": { - "identifiers": [ - { - "name": "Id" - } - ], - "shape": "InstanceNetworkInterfaceAssociation", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "association.association-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0].Association" - }, - "actions": { - "Delete": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Address": { - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "Route": { - "identifiers": [ - { "name": "RouteTableId" }, - { - "name": "DestinationCidrBlock", - "memberName": "DestinationCidrBlock" - } - ], - "shape": "Route", - "actions": { - "Delete": { - "request": { - "operation": "DeleteRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - }, - "Replace": { - "request": { - "operation": "ReplaceRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "RouteTableId" } - ] - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "requestParameter", "path": "DestinationCidrBlock" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Routes": { - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "data", "path": "Routes[].DestinationCidrBlock" } - ], - "path": "Routes[]" - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Associations": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[0].Associations[].RouteTableAssociationId" } - ], - "path": "RouteTables[0].Associations[]" - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "VpcPeeringConnectionExists", - "params": [ - { "target": "VpcPeeringConnectionIds[]", "source": "identifier", "name": "Id" } - ], - "path": "VpcPeeringConnections[0]" - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - }, - "VpcAddress": { - "identifiers": [ - { - "name": "AllocationId" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "AllocationIds[0]", "source": "identifier", "name": "AllocationId" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "AllocationId", "source": "identifier", "name": "AllocationId" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AssociationId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-11-15/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-11-15/resources-1.json deleted file mode 100644 index 9872201d..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/ec2/2016-11-15/resources-1.json +++ /dev/null @@ -1,2582 +0,0 @@ -{ - "service": { - "actions": { - "CreateDhcpOptions": { - "request": { "operation": "CreateDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions.DhcpOptionsId" } - ], - "path": "DhcpOptions" - } - }, - "CreateInstances": { - "request": { "operation": "RunInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateInternetGateway": { - "request": { "operation": "CreateInternetGateway" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateway.InternetGatewayId" } - ], - "path": "InternetGateway" - } - }, - "CreateKeyPair": { - "request": { "operation": "CreateKeyPair" }, - "resource": { - "type": "KeyPair", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ], - "path": "@" - } - }, - "CreateNetworkAcl": { - "request": { "operation": "CreateNetworkAcl" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateNetworkInterface": { - "request": { "operation": "CreateNetworkInterface" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreatePlacementGroup": { - "request": { "operation": "CreatePlacementGroup" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ] - } - }, - "CreateRouteTable": { - "request": { "operation": "CreateRouteTable" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { "operation": "CreateSecurityGroup" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSnapshot": { - "request": { "operation": "CreateSnapshot" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateSubnet": { - "request": { "operation": "CreateSubnet" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { "operation": "CreateTags" } - }, - "CreateVolume": { - "request": { "operation": "CreateVolume" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VolumeId" } - ], - "path": "@" - } - }, - "CreateVpc": { - "request": { "operation": "CreateVpc" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpc.VpcId" } - ], - "path": "Vpc" - } - }, - "CreateVpcPeeringConnection": { - "request": { "operation": "CreateVpcPeeringConnection" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - }, - "DisassociateRouteTable": { - "request": { "operation": "DisassociateRouteTable" } - }, - "ImportKeyPair": { - "request": { "operation": "ImportKeyPair" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyName" } - ] - } - }, - "RegisterImage": { - "request": { "operation": "RegisterImage" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Instance": { - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "InternetGateway": { - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "NetworkAcl": { - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "NetworkInterface": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "RouteTableAssociation": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "SecurityGroup": { - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Snapshot": { - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "VpcPeeringConnection": { - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "ClassicAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "standard" } - ] - }, - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "response", "path": "Addresses[].PublicIp" } - ], - "path": "Addresses[]" - } - }, - "DhcpOptionsSets": { - "request": { "operation": "DescribeDhcpOptions" }, - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "response", "path": "DhcpOptions[].DhcpOptionsId" } - ], - "path": "DhcpOptions[]" - } - }, - "Images": { - "request": { "operation": "DescribeImages" }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Images[].ImageId" } - ], - "path": "Images[]" - } - }, - "Instances": { - "request": { "operation": "DescribeInstances" }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { "operation": "DescribeInternetGateways" }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "KeyPairs": { - "request": { "operation": "DescribeKeyPairs" }, - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "response", "path": "KeyPairs[].KeyName" } - ], - "path": "KeyPairs[]" - } - }, - "NetworkAcls": { - "request": { "operation": "DescribeNetworkAcls" }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { "operation": "DescribeNetworkInterfaces" }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroups": { - "request": { "operation": "DescribePlacementGroups" }, - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PlacementGroups[].GroupName" } - ], - "path": "PlacementGroups[]" - } - }, - "RouteTables": { - "request": { "operation": "DescribeRouteTables" }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { "operation": "DescribeSecurityGroups" }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Snapshots": { - "request": { "operation": "DescribeSnapshots" }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - }, - "Subnets": { - "request": { "operation": "DescribeSubnets" }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - }, - "Volumes": { - "request": { "operation": "DescribeVolumes" }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "domain" }, - { "target": "Filters[0].Values[0]", "source": "string", "value": "vpc" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - }, - "VpcPeeringConnections": { - "request": { "operation": "DescribeVpcPeeringConnections" }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Vpcs": { - "request": { "operation": "DescribeVpcs" }, - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Vpcs[].VpcId" } - ], - "path": "Vpcs[]" - } - } - } - }, - "resources": { - "ClassicAddress": { - "identifiers": [ - { - "name": "PublicIp" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "PublicIps[]", "source": "identifier", "name": "PublicIp" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "PublicIp", "source": "identifier", "name": "PublicIp" } - ] - } - }, - "Disassociate": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "PublicIp", "source": "data", "path": "PublicIp" } - ] - } - } - } - }, - "DhcpOptions": { - "identifiers": [ - { - "name": "Id", - "memberName": "DhcpOptionsId" - } - ], - "shape": "DhcpOptions", - "load": { - "request": { - "operation": "DescribeDhcpOptions", - "params": [ - { "target": "DhcpOptionsIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "DhcpOptions[0]" - }, - "actions": { - "AssociateWithVpc": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteDhcpOptions", - "params": [ - { "target": "DhcpOptionsId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Image": { - "identifiers": [ - { - "name": "Id", - "memberName": "ImageId" - } - ], - "shape": "Image", - "load": { - "request": { - "operation": "DescribeImages", - "params": [ - { "target": "ImageIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Images[0]" - }, - "actions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Deregister": { - "request": { - "operation": "DeregisterImage", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetImageAttribute", - "params": [ - { "target": "ImageId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "ImageExists", - "params": [ - { "target": "ImageIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Images[0]" - } - } - }, - "Instance": { - "identifiers": [ - { - "name": "Id", - "memberName": "InstanceId" - } - ], - "shape": "Instance", - "load": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Reservations[0].Instances[0]" - }, - "actions": { - "AttachClassicLinkVpc": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachVolume": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ConsoleOutput": { - "request": { - "operation": "GetConsoleOutput", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateImage": { - "request": { - "operation": "CreateImage", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "response", "path": "ImageId" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkVpc": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachVolume": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "PasswordData": { - "request": { - "operation": "GetPasswordData", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ReportStatus": { - "request": { - "operation": "ReportInstanceStatus", - "params": [ - { "target": "Instances[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetKernel": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "kernel" } - ] - } - }, - "ResetRamdisk": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "ramdisk" } - ] - } - }, - "ResetSourceDestCheck": { - "request": { - "operation": "ResetInstanceAttribute", - "params": [ - { "target": "InstanceId", "source": "identifier", "name": "Id" }, - { "target": "Attribute", "source": "string", "value": "sourceDestCheck" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[0]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Monitor": { - "request": { - "operation": "MonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Reboot": { - "request": { - "operation": "RebootInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Start": { - "request": { - "operation": "StartInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Stop": { - "request": { - "operation": "StopInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Terminate": { - "request": { - "operation": "TerminateInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "Unmonitor": { - "request": { - "operation": "UnmonitorInstances", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "InstanceExists", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Running": { - "waiterName": "InstanceRunning", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Stopped": { - "waiterName": "InstanceStopped", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - }, - "Terminated": { - "waiterName": "InstanceTerminated", - "params": [ - { "target": "InstanceIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Reservations[0].Instances[0]" - } - }, - "has": { - "ClassicAddress": { - "resource": { - "type": "ClassicAddress", - "identifiers": [ - { "target": "PublicIp", "source": "data", "path": "PublicIpAddress" } - ] - } - }, - "Image": { - "resource": { - "type": "Image", - "identifiers": [ - { "target": "Id", "source": "data", "path": "ImageId" } - ] - } - }, - "KeyPair": { - "resource": { - "type": "KeyPairInfo", - "identifiers": [ - { "target": "Name", "source": "data", "path": "KeyName" } - ] - } - }, - "NetworkInterfaces": { - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "data", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "PlacementGroup": { - "resource": { - "type": "PlacementGroup", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Placement.GroupName" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Volumes": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Volumes[].VolumeId" } - ], - "path": "Volumes[]" - } - }, - "VpcAddresses": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "instance-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "response", "path": "Addresses[].AllocationId" } - ], - "path": "Addresses[]" - } - } - } - }, - "InternetGateway": { - "identifiers": [ - { - "name": "Id", - "memberName": "InternetGatewayId" - } - ], - "shape": "InternetGateway", - "load": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "InternetGatewayIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "InternetGateways[0]" - }, - "actions": { - "AttachToVpc": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromVpc": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "InternetGatewayId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "KeyPair": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPair", - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "KeyPairInfo": { - "identifiers": [ - { - "name": "Name", - "memberName": "KeyName" - } - ], - "shape": "KeyPairInfo", - "load": { - "request": { - "operation": "DescribeKeyPairs", - "params": [ - { "target": "KeyNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "KeyPairs[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteKeyPair", - "params": [ - { "target": "KeyName", "source": "identifier", "name": "Name" } - ] - } - } - } - }, - "NetworkAcl": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkAclId" - } - ], - "shape": "NetworkAcl", - "load": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "NetworkAclIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkAcls[0]" - }, - "actions": { - "CreateEntry": { - "request": { - "operation": "CreateNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkAcl", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "DeleteEntry": { - "request": { - "operation": "DeleteNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceAssociation": { - "request": { - "operation": "ReplaceNetworkAclAssociation", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceEntry": { - "request": { - "operation": "ReplaceNetworkAclEntry", - "params": [ - { "target": "NetworkAclId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterface": { - "identifiers": [ - { - "name": "Id", - "memberName": "NetworkInterfaceId" - } - ], - "shape": "NetworkInterface", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "NetworkInterfaceIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0]" - }, - "actions": { - "AssignPrivateIpAddresses": { - "request": { - "operation": "AssignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Attach": { - "request": { - "operation": "AttachNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteNetworkInterface", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "Detach": { - "request": { - "operation": "DetachNetworkInterface", - "params": [ - { "target": "AttachmentId", "source": "data", "path": "Attachment.AttachmentId" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetNetworkInterfaceAttribute", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - }, - "UnassignPrivateIpAddresses": { - "request": { - "operation": "UnassignPrivateIpAddresses", - "params": [ - { "target": "NetworkInterfaceId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "Association.AssociationId" } - ], - "path": "Association" - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "NetworkInterfaceAssociation": { - "identifiers": [ - { - "name": "Id" - } - ], - "shape": "InstanceNetworkInterfaceAssociation", - "load": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "association.association-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "NetworkInterfaces[0].Association" - }, - "actions": { - "Delete": { - "request": { - "operation": "DisassociateAddress", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Address": { - "resource": { - "type": "VpcAddress", - "identifiers": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - } - }, - "PlacementGroup": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "PlacementGroup", - "load": { - "request": { - "operation": "DescribePlacementGroups", - "params": [ - { "target": "GroupNames[0]", "source": "identifier", "name": "Name" } - ] - }, - "path": "PlacementGroups[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePlacementGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "placement-group-name" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - } - } - }, - "Route": { - "identifiers": [ - { "name": "RouteTableId" }, - { - "name": "DestinationCidrBlock", - "memberName": "DestinationCidrBlock" - } - ], - "shape": "Route", - "actions": { - "Delete": { - "request": { - "operation": "DeleteRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - }, - "Replace": { - "request": { - "operation": "ReplaceRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "RouteTableId" }, - { "target": "DestinationCidrBlock", "source": "identifier", "name": "DestinationCidrBlock" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "RouteTableId" } - ] - } - } - } - }, - "RouteTable": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableId" - } - ], - "shape": "RouteTable", - "load": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "RouteTableIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "RouteTables[0]" - }, - "actions": { - "AssociateWithSubnet": { - "request": { - "operation": "AssociateRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "AssociationId" } - ] - } - }, - "CreateRoute": { - "request": { - "operation": "CreateRoute", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "requestParameter", "path": "DestinationCidrBlock" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRouteTable", - "params": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Associations": { - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "Associations[].RouteTableAssociationId" } - ], - "path": "Associations[]" - } - }, - "Routes": { - "resource": { - "type": "Route", - "identifiers": [ - { "target": "RouteTableId", "source": "identifier", "name": "Id" }, - { "target": "DestinationCidrBlock", "source": "data", "path": "Routes[].DestinationCidrBlock" } - ], - "path": "Routes[]" - } - }, - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - } - }, - "RouteTableAssociation": { - "identifiers": [ - { - "name": "Id", - "memberName": "RouteTableAssociationId" - } - ], - "shape": "RouteTableAssociation", - "actions": { - "Delete": { - "request": { - "operation": "DisassociateRouteTable", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - } - }, - "ReplaceSubnet": { - "request": { - "operation": "ReplaceRouteTableAssociation", - "params": [ - { "target": "AssociationId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTableAssociation", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NewAssociationId" } - ] - } - } - }, - "has": { - "RouteTable": { - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RouteTableId" } - ] - } - }, - "Subnet": { - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "data", "path": "SubnetId" } - ] - } - } - } - }, - "SecurityGroup": { - "identifiers": [ - { - "name": "Id", - "memberName": "GroupId" - } - ], - "shape": "SecurityGroup", - "load": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "GroupIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "SecurityGroups[0]" - }, - "actions": { - "AuthorizeEgress": { - "request": { - "operation": "AuthorizeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "AuthorizeIngress": { - "request": { - "operation": "AuthorizeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSecurityGroup", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeEgress": { - "request": { - "operation": "RevokeSecurityGroupEgress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - }, - "RevokeIngress": { - "request": { - "operation": "RevokeSecurityGroupIngress", - "params": [ - { "target": "GroupId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "Snapshot": { - "identifiers": [ - { - "name": "Id", - "memberName": "SnapshotId" - } - ], - "shape": "Snapshot", - "load": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "SnapshotIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Snapshots[0]" - }, - "actions": { - "Copy": { - "request": { - "operation": "CopySnapshot", - "params": [ - { "target": "SourceSnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSnapshot", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifySnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - }, - "ResetAttribute": { - "request": { - "operation": "ResetSnapshotAttribute", - "params": [ - { "target": "SnapshotId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Completed": { - "waiterName": "SnapshotCompleted", - "params": [ - { "target": "SnapshotIds[]", "source": "identifier", "name": "Id" } - ], - "path": "Snapshots[]" - } - }, - "has": { - "Volume": { - "resource": { - "type": "Volume", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VolumeId" } - ] - } - } - } - }, - "Subnet": { - "identifiers": [ - { - "name": "Id", - "memberName": "SubnetId" - } - ], - "shape": "Subnet", - "load": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "SubnetIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Subnets[0]" - }, - "actions": { - "CreateInstances": { - "request": { - "operation": "RunInstances", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Instances[].InstanceId" } - ], - "path": "Instances[]" - } - }, - "CreateNetworkInterface": { - "request": { - "operation": "CreateNetworkInterface", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterface.NetworkInterfaceId" } - ], - "path": "NetworkInterface" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSubnet", - "params": [ - { "target": "SubnetId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "VpcId" } - ] - } - } - }, - "hasMany": { - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "subnet-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - } - } - }, - "Tag": { - "identifiers": [ - { - "name": "ResourceId", - "memberName": "ResourceId" - }, - { - "name": "Key", - "memberName": "Key" - }, - { - "name": "Value", - "memberName": "Value" - } - ], - "shape": "TagDescription", - "load": { - "request": { - "operation": "DescribeTags", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "key" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Key" }, - { "target": "Filters[1].Name", "source": "string", "value": "value" }, - { "target": "Filters[1].Values[0]", "source": "identifier", "name": "Value" } - ] - }, - "path": "Tags[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[0].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[0].Value", "source": "identifier", "name": "Value" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteTags", - "params": [ - { "target": "Resources[]", "source": "identifier", "name": "ResourceId" }, - { "target": "Tags[*].Key", "source": "identifier", "name": "Key" }, - { "target": "Tags[*].Value", "source": "identifier", "name": "Value" } - ] - } - } - } - }, - "Volume": { - "identifiers": [ - { - "name": "Id", - "memberName": "VolumeId" - } - ], - "shape": "Volume", - "load": { - "request": { - "operation": "DescribeVolumes", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Volumes[0]" - }, - "actions": { - "AttachToInstance": { - "request": { - "operation": "AttachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateSnapshot": { - "request": { - "operation": "CreateSnapshot", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SnapshotId" } - ], - "path": "@" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeStatus": { - "request": { - "operation": "DescribeVolumeStatus", - "params": [ - { "target": "VolumeIds[0]", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachFromInstance": { - "request": { - "operation": "DetachVolume", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableIo": { - "request": { - "operation": "EnableVolumeIO", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVolumeAttribute", - "params": [ - { "target": "VolumeId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Snapshots": { - "request": { - "operation": "DescribeSnapshots", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "volume-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Snapshot", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Snapshots[].SnapshotId" } - ], - "path": "Snapshots[]" - } - } - } - }, - "Vpc": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcId" - } - ], - "shape": "Vpc", - "load": { - "request": { - "operation": "DescribeVpcs", - "params": [ - { "target": "VpcIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Vpcs[0]" - }, - "actions": { - "AssociateDhcpOptions": { - "request": { - "operation": "AssociateDhcpOptions", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachClassicLinkInstance": { - "request": { - "operation": "AttachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "AttachInternetGateway": { - "request": { - "operation": "AttachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "CreateNetworkAcl": { - "request": { - "operation": "CreateNetworkAcl", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcl.NetworkAclId" } - ], - "path": "NetworkAcl" - } - }, - "CreateRouteTable": { - "request": { - "operation": "CreateRouteTable", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTable.RouteTableId" } - ], - "path": "RouteTable" - } - }, - "CreateSecurityGroup": { - "request": { - "operation": "CreateSecurityGroup", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "GroupId" } - ] - } - }, - "CreateSubnet": { - "request": { - "operation": "CreateSubnet", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnet.SubnetId" } - ], - "path": "Subnet" - } - }, - "CreateTags": { - "request": { - "operation": "CreateTags", - "params": [ - { "target": "Resources[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Tag", - "identifiers": [ - { "target": "ResourceId", "source": "identifier", "name": "Id" }, - { "target": "Key", "source": "requestParameter", "path": "Tags[].Key" }, - { "target": "Value", "source": "requestParameter", "path": "Tags[].Value" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DescribeAttribute": { - "request": { - "operation": "DescribeVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachClassicLinkInstance": { - "request": { - "operation": "DetachClassicLinkVpc", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DetachInternetGateway": { - "request": { - "operation": "DetachInternetGateway", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "DisableClassicLink": { - "request": { - "operation": "DisableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "EnableClassicLink": { - "request": { - "operation": "EnableVpcClassicLink", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "ModifyAttribute": { - "request": { - "operation": "ModifyVpcAttribute", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - } - }, - "RequestVpcPeeringConnection": { - "request": { - "operation": "CreateVpcPeeringConnection", - "params": [ - { "target": "VpcId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnection.VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnection" - } - } - }, - "waiters": { - "Available": { - "waiterName": "VpcAvailable", - "params": [ - { "target": "VpcIds[]", "source": "identifier", "name": "Id" } - ] - }, - "Exists": { - "waiterName": "VpcExists", - "params": [ - { "target": "VpcIds[]", "source": "identifier", "name": "Id" } - ] - } - }, - "has": { - "DhcpOptions": { - "resource": { - "type": "DhcpOptions", - "identifiers": [ - { "target": "Id", "source": "data", "path": "DhcpOptionsId" } - ] - } - } - }, - "hasMany": { - "AcceptedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "accepter-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "Instances": { - "request": { - "operation": "DescribeInstances", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Instance", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Reservations[].Instances[].InstanceId" } - ], - "path": "Reservations[].Instances[]" - } - }, - "InternetGateways": { - "request": { - "operation": "DescribeInternetGateways", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "attachment.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "InternetGateway", - "identifiers": [ - { "target": "Id", "source": "response", "path": "InternetGateways[].InternetGatewayId" } - ], - "path": "InternetGateways[]" - } - }, - "NetworkAcls": { - "request": { - "operation": "DescribeNetworkAcls", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkAcl", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkAcls[].NetworkAclId" } - ], - "path": "NetworkAcls[]" - } - }, - "NetworkInterfaces": { - "request": { - "operation": "DescribeNetworkInterfaces", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "NetworkInterface", - "identifiers": [ - { "target": "Id", "source": "response", "path": "NetworkInterfaces[].NetworkInterfaceId" } - ], - "path": "NetworkInterfaces[]" - } - }, - "RequestedVpcPeeringConnections": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "requester-vpc-info.vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "VpcPeeringConnection", - "identifiers": [ - { "target": "Id", "source": "response", "path": "VpcPeeringConnections[].VpcPeeringConnectionId" } - ], - "path": "VpcPeeringConnections[]" - } - }, - "RouteTables": { - "request": { - "operation": "DescribeRouteTables", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "RouteTable", - "identifiers": [ - { "target": "Id", "source": "response", "path": "RouteTables[].RouteTableId" } - ], - "path": "RouteTables[]" - } - }, - "SecurityGroups": { - "request": { - "operation": "DescribeSecurityGroups", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "SecurityGroup", - "identifiers": [ - { "target": "Id", "source": "response", "path": "SecurityGroups[].GroupId" } - ], - "path": "SecurityGroups[]" - } - }, - "Subnets": { - "request": { - "operation": "DescribeSubnets", - "params": [ - { "target": "Filters[0].Name", "source": "string", "value": "vpc-id" }, - { "target": "Filters[0].Values[0]", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Subnet", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Subnets[].SubnetId" } - ], - "path": "Subnets[]" - } - } - } - }, - "VpcPeeringConnection": { - "identifiers": [ - { - "name": "Id", - "memberName": "VpcPeeringConnectionId" - } - ], - "shape": "VpcPeeringConnection", - "load": { - "request": { - "operation": "DescribeVpcPeeringConnections", - "params": [ - { "target": "VpcPeeringConnectionIds[0]", "source": "identifier", "name": "Id" } - ] - }, - "path": "VpcPeeringConnections[0]" - }, - "actions": { - "Accept": { - "request": { - "operation": "AcceptVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Reject": { - "request": { - "operation": "RejectVpcPeeringConnection", - "params": [ - { "target": "VpcPeeringConnectionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "VpcPeeringConnectionExists", - "params": [ - { "target": "VpcPeeringConnectionIds[]", "source": "identifier", "name": "Id" } - ], - "path": "VpcPeeringConnections[0]" - } - }, - "has": { - "AccepterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AccepterVpcInfo.VpcId" } - ] - } - }, - "RequesterVpc": { - "resource": { - "type": "Vpc", - "identifiers": [ - { "target": "Id", "source": "data", "path": "RequesterVpcInfo.VpcId" } - ] - } - } - } - }, - "VpcAddress": { - "identifiers": [ - { - "name": "AllocationId" - } - ], - "shape": "Address", - "load": { - "request": { - "operation": "DescribeAddresses", - "params": [ - { "target": "AllocationIds[0]", "source": "identifier", "name": "AllocationId" } - ] - }, - "path": "Addresses[0]" - }, - "actions": { - "Associate": { - "request": { - "operation": "AssociateAddress", - "params": [ - { "target": "AllocationId", "source": "identifier", "name": "AllocationId" } - ] - } - }, - "Release": { - "request": { - "operation": "ReleaseAddress", - "params": [ - { "target": "AllocationId", "source": "data", "path": "AllocationId" } - ] - } - } - }, - "has": { - "Association": { - "resource": { - "type": "NetworkInterfaceAssociation", - "identifiers": [ - { "target": "Id", "source": "data", "path": "AssociationId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/glacier/2012-06-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/glacier/2012-06-01/resources-1.json deleted file mode 100644 index d1ed48f4..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/glacier/2012-06-01/resources-1.json +++ /dev/null @@ -1,581 +0,0 @@ -{ - "service": { - "actions": { - "CreateVault": { - "request": { - "operation": "CreateVault", - "params": [ - { "target": "accountId", "source": "string", "value": "-" } - ] - }, - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "requestParameter", "path": "accountId" }, - { "target": "Name", "source": "requestParameter", "path": "vaultName" } - ] - } - } - }, - "has": { - "Account": { - "resource": { - "type": "Account", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "Vaults": { - "request": { - "operation": "ListVaults", - "params": [ - { "target": "accountId", "source": "string", "value": "-" } - ] - }, - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "requestParameter", "path": "accountId" }, - { "target": "Name", "source": "response", "path": "VaultList[].VaultName" } - ], - "path": "VaultList[]" - } - } - } - }, - "resources": { - "Account": { - "identifiers": [ - { "name": "Id" } - ], - "actions": { - "CreateVault": { - "request": { - "operation": "CreateVault", - "params": [ - { "target": "accountId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "Id" }, - { "target": "Name", "source": "requestParameter", "path": "vaultName" } - ] - } - } - }, - "has": { - "Vault": { - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "Id" }, - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "Vaults": { - "request": { - "operation": "ListVaults", - "params": [ - { "target": "accountId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "Id" }, - { "target": "Name", "source": "response", "path": "VaultList[].VaultName" } - ], - "path": "VaultList[]" - } - } - } - }, - "Archive": { - "identifiers": [ - { "name": "AccountId" }, - { "name": "VaultName" }, - { "name": "Id" } - ], - "actions": { - "Delete": { - "request": { - "operation": "DeleteArchive", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "archiveId", "source": "identifier", "name": "Id" } - ] - } - }, - "InitiateArchiveRetrieval": { - "request": { - "operation": "InitiateJob", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "jobParameters.Type", "source": "string", "value": "archive-retrieval" }, - { "target": "jobParameters.ArchiveId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "Id", "source": "response", "path": "jobId" }, - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "VaultName" } - ] - } - } - }, - "has": { - "Vault": { - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "Name", "source": "identifier", "name": "VaultName" } - ] - } - } - } - }, - "Job": { - "identifiers": [ - { "name": "AccountId" }, - { "name": "VaultName" }, - { - "name": "Id", - "memberName": "JobId" - } - ], - "shape": "GlacierJobDescription", - "load": { - "request": { - "operation": "DescribeJob", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "jobId", "source": "identifier", "name": "Id" } - ] - }, - "path": "@" - }, - "actions": { - "GetOutput": { - "request": { - "operation": "GetJobOutput", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "jobId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vault": { - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "Name", "source": "identifier", "name": "VaultName" } - ] - } - } - } - }, - "MultipartUpload": { - "identifiers": [ - { "name": "AccountId" }, - { "name": "VaultName" }, - { - "name": "Id", - "memberName": "MultipartUploadId" - } - ], - "shape": "UploadListElement", - "actions": { - "Abort": { - "request": { - "operation": "AbortMultipartUpload", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "uploadId", "source": "identifier", "name": "Id" } - ] - } - }, - "Complete": { - "request": { - "operation": "CompleteMultipartUpload", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "uploadId", "source": "identifier", "name": "Id" } - ] - } - }, - "Parts": { - "request": { - "operation": "ListParts", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "uploadId", "source": "identifier", "name": "Id" } - ] - } - }, - "UploadPart": { - "request": { - "operation": "UploadMultipartPart", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" }, - { "target": "uploadId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Vault": { - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "Name", "source": "identifier", "name": "VaultName" } - ] - } - } - } - }, - "Notification": { - "identifiers": [ - { "name": "AccountId" }, - { "name": "VaultName" } - ], - "shape": "VaultNotificationConfig", - "load": { - "request": { - "operation": "GetVaultNotifications", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" } - ] - }, - "path": "vaultNotificationConfig" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteVaultNotifications", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" } - ] - } - }, - "Set": { - "request": { - "operation": "SetVaultNotifications", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "VaultName" } - ] - } - } - }, - "has": { - "Vault": { - "resource": { - "type": "Vault", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "Name", "source": "identifier", "name": "VaultName" } - ] - } - } - } - }, - "Vault": { - "identifiers": [ - { "name": "AccountId" }, - { - "name": "Name", - "memberName": "VaultName" - } - ], - "shape": "DescribeVaultOutput", - "load": { - "request": { - "operation": "DescribeVault", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - }, - "path": "@" - }, - "actions": { - "Create": { - "request": { - "operation": "CreateVault", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteVault", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - } - }, - "InitiateInventoryRetrieval": { - "request": { - "operation": "InitiateJob", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "jobParameters.Type", "source": "string", "value": "inventory-retrieval" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "Id", "source": "response", "path": "jobId" }, - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" } - ] - } - }, - "InitiateMultipartUpload": { - "request": { - "operation": "InitiateMultipartUpload", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "Id", "source": "response", "path": "uploadId" }, - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" } - ] - } - }, - "UploadArchive": { - "request": { - "operation": "UploadArchive", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - }, - "resource": { - "type": "Archive", - "identifiers": [ - { "target": "Id", "source": "response", "path": "archiveId" }, - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "Account": { - "resource": { - "type": "Account", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "AccountId" } - ] - } - }, - "Archive": { - "resource": { - "type": "Archive", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "input" } - ] - } - }, - "Job": { - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "input" } - ] - } - }, - "MultipartUpload": { - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "input" } - ] - } - }, - "Notification": { - "resource": { - "type": "Notification", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "CompletedJobs": { - "request": { - "operation": "ListJobs", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "completed", "source": "string", "value": "true" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "JobList[].JobId" } - ], - "path": "JobList[]" - } - }, - "FailedJobs": { - "request": { - "operation": "ListJobs", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "statuscode", "source": "string", "value": "Failed" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "JobList[].JobId" } - ], - "path": "JobList[]" - } - }, - "Jobs": { - "request": { - "operation": "ListJobs", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "JobList[].JobId" } - ], - "path": "JobList[]" - } - }, - "JobsInProgress": { - "request": { - "operation": "ListJobs", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "statuscode", "source": "string", "value": "InProgress" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "JobList[].JobId" } - ], - "path": "JobList[]" - } - }, - "MultipartUplaods": { - "request": { - "operation": "ListMultipartUploads", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "UploadsList[].MultipartUploadId" } - ], - "path": "UploadsList[]" - } - }, - "MultipartUploads": { - "request": { - "operation": "ListMultipartUploads", - "params": [ - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "accountId", "source": "identifier", "name": "AccountId" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "UploadsList[].MultipartUploadId" } - ], - "path": "UploadsList[]" - } - }, - "SucceededJobs": { - "request": { - "operation": "ListJobs", - "params": [ - { "target": "accountId", "source": "identifier", "name": "AccountId" }, - { "target": "vaultName", "source": "identifier", "name": "Name" }, - { "target": "statuscode", "source": "string", "value": "Succeeded" } - ] - }, - "resource": { - "type": "Job", - "identifiers": [ - { "target": "AccountId", "source": "identifier", "name": "AccountId" }, - { "target": "VaultName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "JobList[].JobId" } - ], - "path": "JobList[]" - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/iam/2010-05-08/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/iam/2010-05-08/resources-1.json deleted file mode 100644 index 59d18556..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/iam/2010-05-08/resources-1.json +++ /dev/null @@ -1,1721 +0,0 @@ -{ - "service": { - "actions": { - "ChangePassword": { - "request": { "operation": "ChangePassword" } - }, - "CreateAccountAlias": { - "request": { "operation": "CreateAccountAlias" } - }, - "CreateAccountPasswordPolicy": { - "request": { "operation": "UpdateAccountPasswordPolicy" }, - "resource": { - "type": "AccountPasswordPolicy", - "identifiers": [ ] - } - }, - "CreateGroup": { - "request": { "operation": "CreateGroup" }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ], - "path": "Group" - } - }, - "CreateInstanceProfile": { - "request": { "operation": "CreateInstanceProfile" }, - "resource": { - "type": "InstanceProfile", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "InstanceProfileName" } - ], - "path": "InstanceProfile" - } - }, - "CreatePolicy": { - "request": { "operation": "CreatePolicy" }, - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Policy.Arn" } - ] - } - }, - "CreateRole": { - "request": { "operation": "CreateRole" }, - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "RoleName" } - ], - "path": "Role" - } - }, - "CreateSamlProvider": { - "request": { "operation": "CreateSAMLProvider" }, - "resource": { - "type": "SamlProvider", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "SAMLProviderArn" } - ] - } - }, - "CreateServerCertificate": { - "request": { "operation": "UploadServerCertificate" }, - "resource": { - "type": "ServerCertificate", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "ServerCertificateName" } - ] - } - }, - "CreateSigningCertificate": { - "request": { "operation": "UploadSigningCertificate" }, - "resource": { - "type": "SigningCertificate", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Certificate.CertificateId" } - ], - "path": "Certificate" - } - }, - "CreateUser": { - "request": { "operation": "CreateUser" }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "UserName" } - ], - "path": "User" - } - }, - "CreateVirtualMfaDevice": { - "request": { "operation": "CreateVirtualMFADevice" }, - "resource": { - "type": "VirtualMfaDevice", - "identifiers": [ - { "target": "SerialNumber", "source": "response", "path": "VirtualMFADevice.SerialNumber" } - ], - "path": "VirtualMFADevice" - } - } - }, - "has": { - "AccountPasswordPolicy": { - "resource": { - "type": "AccountPasswordPolicy", - "identifiers": [ ] - } - }, - "AccountSummary": { - "resource": { - "type": "AccountSummary", - "identifiers": [ ] - } - }, - "CurrentUser": { - "resource": { - "type": "CurrentUser", - "identifiers": [ ] - } - }, - "Group": { - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "InstanceProfile": { - "resource": { - "type": "InstanceProfile", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "Policy": { - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "PolicyArn", "source": "input" } - ] - } - }, - "Role": { - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "SamlProvider": { - "resource": { - "type": "SamlProvider", - "identifiers": [ - { "target": "Arn", "source": "input" } - ] - } - }, - "ServerCertificate": { - "resource": { - "type": "ServerCertificate", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - }, - "VirtualMfaDevice": { - "resource": { - "type": "VirtualMfaDevice", - "identifiers": [ - { "target": "SerialNumber", "source": "input" } - ] - } - } - }, - "hasMany": { - "Groups": { - "request": { "operation": "ListGroups" }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Groups[].GroupName" } - ], - "path": "Groups[]" - } - }, - "InstanceProfiles": { - "request": { "operation": "ListInstanceProfiles" }, - "resource": { - "type": "InstanceProfile", - "identifiers": [ - { "target": "Name", "source": "response", "path": "InstanceProfiles[].InstanceProfileName" } - ], - "path": "InstanceProfiles[]" - } - }, - "Policies": { - "request": { "operation": "ListPolicies" }, - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Policies[].Arn" } - ], - "path": "Policies[]" - } - }, - "Roles": { - "request": { "operation": "ListRoles" }, - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Roles[].RoleName" } - ], - "path": "Roles[]" - } - }, - "SamlProviders": { - "request": { "operation": "ListSAMLProviders" }, - "resource": { - "type": "SamlProvider", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "SAMLProviderList[].Arn" } - ] - } - }, - "ServerCertificates": { - "request": { "operation": "ListServerCertificates" }, - "resource": { - "type": "ServerCertificate", - "identifiers": [ - { "target": "Name", "source": "response", "path": "ServerCertificateMetadataList[].ServerCertificateName" } - ] - } - }, - "Users": { - "request": { "operation": "ListUsers" }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Users[].UserName" } - ], - "path": "Users[]" - } - }, - "VirtualMfaDevices": { - "request": { "operation": "ListVirtualMFADevices" }, - "resource": { - "type": "VirtualMfaDevice", - "identifiers": [ - { "target": "SerialNumber", "source": "response", "path": "VirtualMFADevices[].SerialNumber" } - ], - "path": "VirtualMFADevices[]" - } - } - } - }, - "resources": { - "AccessKey": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - }, - { - "name": "Id", - "memberName": "AccessKeyId" - } - ], - "shape": "AccessKeyMetadata", - "actions": { - "Activate": { - "request": { - "operation": "UpdateAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Active" } - ] - } - }, - "Deactivate": { - "request": { - "operation": "UpdateAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Inactive" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "UserName" } - ] - } - } - } - }, - "AccessKeyPair": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - }, - { - "name": "Id", - "memberName": "AccessKeyId" - }, - { - "name": "Secret", - "memberName": "SecretAccessKey" - } - ], - "shape": "AccessKey", - "actions": { - "Activate": { - "request": { - "operation": "UpdateAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Active" } - ] - } - }, - "Deactivate": { - "request": { - "operation": "UpdateAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Inactive" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "AccessKeyId", "source": "identifier", "name": "Id" } - ] - } - } - } - }, - "AccountPasswordPolicy": { - "identifiers": [ ], - "shape": "PasswordPolicy", - "load": { - "request": { "operation": "GetAccountPasswordPolicy" }, - "path": "PasswordPolicy" - }, - "actions": { - "Delete": { - "request": { "operation": "DeleteAccountPasswordPolicy" } - }, - "Update": { - "request": { "operation": "UpdateAccountPasswordPolicy" } - } - } - }, - "AccountSummary": { - "identifiers": [ ], - "shape": "GetAccountSummaryResponse", - "load": { - "request": { "operation": "GetAccountSummary" }, - "path": "@" - } - }, - "AssumeRolePolicy": { - "identifiers": [ - { "name": "RoleName" } - ], - "actions": { - "Update": { - "request": { - "operation": "UpdateAssumeRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "RoleName" } - ] - } - } - }, - "has": { - "Role": { - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "RoleName" } - ] - } - } - } - }, - "CurrentUser": { - "identifiers": [ ], - "shape": "User", - "load": { - "request": { "operation": "GetUser" }, - "path": "User" - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "data", "path": "UserName" } - ] - } - } - }, - "hasMany": { - "AccessKeys": { - "request": { "operation": "ListAccessKeys" }, - "resource": { - "type": "AccessKey", - "identifiers": [ - { "target": "UserName", "source": "response", "path": "AccessKeyMetadata[].UserName" }, - { "target": "Id", "source": "response", "path": "AccessKeyMetadata[].AccessKeyId" } - ], - "path": "AccessKeyMetadata[]" - } - }, - "MfaDevices": { - "request": { "operation": "ListMFADevices" }, - "resource": { - "type": "MfaDevice", - "identifiers": [ - { "target": "UserName", "source": "response", "path": "MFADevices[].UserName" }, - { "target": "SerialNumber", "source": "response", "path": "MFADevices[].SerialNumber" } - ], - "path": "MFADevices[]" - } - }, - "SigningCertificates": { - "request": { "operation": "ListSigningCertificates" }, - "resource": { - "type": "SigningCertificate", - "identifiers": [ - { "target": "UserName", "source": "response", "path": "Certificates[].UserName" }, - { "target": "Id", "source": "response", "path": "Certificates[].CertificateId" } - ], - "path": "Certificates[]" - } - } - } - }, - "Group": { - "identifiers": [ - { - "name": "Name", - "memberName": "GroupName" - } - ], - "shape": "Group", - "load": { - "request": { - "operation": "GetGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "path": "Group" - }, - "actions": { - "AddUser": { - "request": { - "operation": "AddUserToGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - }, - "AttachPolicy": { - "request": { - "operation": "AttachGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - }, - "Create": { - "request": { - "operation": "CreateGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "GroupName" } - ], - "path": "Group" - } - }, - "CreatePolicy": { - "request": { - "operation": "PutGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "GroupPolicy", - "identifiers": [ - { "target": "GroupName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "requestParameter", "path": "PolicyName" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - }, - "DetachPolicy": { - "request": { - "operation": "DetachGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - }, - "RemoveUser": { - "request": { - "operation": "RemoveUserFromGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "NewGroupName" } - ] - } - } - }, - "has": { - "Policy": { - "resource": { - "type": "GroupPolicy", - "identifiers": [ - { "target": "GroupName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "AttachedPolicies": { - "request": { - "operation": "ListAttachedGroupPolicies", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "AttachedPolicies[].PolicyArn" } - ] - } - }, - "Policies": { - "request": { - "operation": "ListGroupPolicies", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "GroupPolicy", - "identifiers": [ - { "target": "GroupName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "response", "path": "PolicyNames[]" } - ] - } - }, - "Users": { - "request": { - "operation": "GetGroup", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Users[].UserName" } - ], - "path": "Users[]" - } - } - } - }, - "GroupPolicy": { - "identifiers": [ - { - "name": "GroupName", - "memberName": "GroupName" - }, - { - "name": "Name", - "memberName": "PolicyName" - } - ], - "shape": "GetGroupPolicyResponse", - "load": { - "request": { - "operation": "GetGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "GroupName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "GroupName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - }, - "Put": { - "request": { - "operation": "PutGroupPolicy", - "params": [ - { "target": "GroupName", "source": "identifier", "name": "GroupName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "Group": { - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "GroupName" } - ] - } - } - } - }, - "InstanceProfile": { - "identifiers": [ - { - "name": "Name", - "memberName": "InstanceProfileName" - } - ], - "shape": "InstanceProfile", - "load": { - "request": { - "operation": "GetInstanceProfile", - "params": [ - { "target": "InstanceProfileName", "source": "identifier", "name": "Name" } - ] - }, - "path": "InstanceProfile" - }, - "actions": { - "AddRole": { - "request": { - "operation": "AddRoleToInstanceProfile", - "params": [ - { "target": "InstanceProfileName", "source": "identifier", "name": "Name" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteInstanceProfile", - "params": [ - { "target": "InstanceProfileName", "source": "identifier", "name": "Name" } - ] - } - }, - "RemoveRole": { - "request": { - "operation": "RemoveRoleFromInstanceProfile", - "params": [ - { "target": "InstanceProfileName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "Roles": { - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "data", "path": "Roles[].RoleName" } - ], - "path": "Roles[]" - } - } - } - }, - "LoginProfile": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - } - ], - "shape": "LoginProfile", - "load": { - "request": { - "operation": "GetLoginProfile", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" } - ] - }, - "path": "LoginProfile" - }, - "actions": { - "Create": { - "request": { - "operation": "CreateLoginProfile", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" } - ] - }, - "resource": { - "type": "LoginProfile", - "identifiers": [ - { "target": "UserName", "source": "response", "path": "LoginProfile.UserName" } - ], - "path": "LoginProfile" - } - }, - "Delete": { - "request": { - "operation": "DeleteLoginProfile", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateLoginProfile", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "UserName" } - ] - } - } - } - }, - "MfaDevice": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - }, - { - "name": "SerialNumber", - "memberName": "SerialNumber" - } - ], - "shape": "MFADevice", - "actions": { - "Associate": { - "request": { - "operation": "EnableMFADevice", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "SerialNumber", "source": "identifier", "name": "SerialNumber" } - ] - } - }, - "Disassociate": { - "request": { - "operation": "DeactivateMFADevice", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "SerialNumber", "source": "identifier", "name": "SerialNumber" } - ] - } - }, - "Resync": { - "request": { - "operation": "ResyncMFADevice", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "SerialNumber", "source": "identifier", "name": "SerialNumber" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "UserName" } - ] - } - } - } - }, - "Policy": { - "identifiers": [ - { - "name": "Arn", - "memberName": "Arn" - } - ], - "shape": "Policy", - "load": { - "request": { - "operation": "GetPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "Policy" - }, - "actions": { - "AttachGroup": { - "request": { - "operation": "AttachGroupPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "AttachRole": { - "request": { - "operation": "AttachRolePolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "AttachUser": { - "request": { - "operation": "AttachUserPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "CreateVersion": { - "request": { - "operation": "CreatePolicyVersion", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "PolicyVersion", - "identifiers": [ - { "target": "Arn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "response", "path": "PolicyVersion.VersionId" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeletePolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "DetachGroup": { - "request": { - "operation": "DetachGroupPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "DetachRole": { - "request": { - "operation": "DetachRolePolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "DetachUser": { - "request": { - "operation": "DetachUserPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - } - } - }, - "has": { - "DefaultVersion": { - "resource": { - "type": "PolicyVersion", - "identifiers": [ - { "target": "Arn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "data", "path": "DefaultVersionId" } - ] - } - } - }, - "hasMany": { - "AttachedGroups": { - "request": { - "operation": "ListEntitiesForPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "EntityFilter", "source": "string", "value": "Group" } - ] - }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PolicyGroups[].GroupName" } - ] - } - }, - "AttachedRoles": { - "request": { - "operation": "ListEntitiesForPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "EntityFilter", "source": "string", "value": "Role" } - ] - }, - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PolicyRoles[].RoleName" } - ] - } - }, - "AttachedUsers": { - "request": { - "operation": "ListEntitiesForPolicy", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "EntityFilter", "source": "string", "value": "User" } - ] - }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "response", "path": "PolicyUsers[].UserName" } - ] - } - }, - "Versions": { - "request": { - "operation": "ListPolicyVersions", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "PolicyVersion", - "identifiers": [ - { "target": "Arn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "response", "path": "Versions[].VersionId" } - ], - "path": "Versions[]" - } - } - } - }, - "PolicyVersion": { - "identifiers": [ - { "name": "Arn" }, - { "name": "VersionId" } - ], - "shape": "PolicyVersion", - "load": { - "request": { - "operation": "GetPolicyVersion", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "identifier", "name": "VersionId" } - ] - }, - "path": "PolicyVersion" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeletePolicyVersion", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "identifier", "name": "VersionId" } - ] - } - }, - "SetAsDefault": { - "request": { - "operation": "SetDefaultPolicyVersion", - "params": [ - { "target": "PolicyArn", "source": "identifier", "name": "Arn" }, - { "target": "VersionId", "source": "identifier", "name": "VersionId" } - ] - } - } - } - }, - "Role": { - "identifiers": [ - { - "name": "Name", - "memberName": "RoleName" - } - ], - "shape": "Role", - "load": { - "request": { - "operation": "GetRole", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - }, - "path": "Role" - }, - "actions": { - "AttachPolicy": { - "request": { - "operation": "AttachRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteRole", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - } - }, - "DetachPolicy": { - "request": { - "operation": "DetachRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "AssumeRolePolicy": { - "resource": { - "type": "AssumeRolePolicy", - "identifiers": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - } - }, - "Policy": { - "resource": { - "type": "RolePolicy", - "identifiers": [ - { "target": "RoleName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "AttachedPolicies": { - "request": { - "operation": "ListAttachedRolePolicies", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "AttachedPolicies[].PolicyArn" } - ] - } - }, - "InstanceProfiles": { - "request": { - "operation": "ListInstanceProfilesForRole", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "InstanceProfile", - "identifiers": [ - { "target": "Name", "source": "response", "path": "InstanceProfiles[].InstanceProfileName" } - ], - "path": "InstanceProfiles[]" - } - }, - "Policies": { - "request": { - "operation": "ListRolePolicies", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "RolePolicy", - "identifiers": [ - { "target": "RoleName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "response", "path": "PolicyNames[]" } - ] - } - } - } - }, - "RolePolicy": { - "identifiers": [ - { - "name": "RoleName", - "memberName": "RoleName" - }, - { - "name": "Name", - "memberName": "PolicyName" - } - ], - "shape": "GetRolePolicyResponse", - "load": { - "request": { - "operation": "GetRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "RoleName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "RoleName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - }, - "Put": { - "request": { - "operation": "PutRolePolicy", - "params": [ - { "target": "RoleName", "source": "identifier", "name": "RoleName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "Role": { - "resource": { - "type": "Role", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "RoleName" } - ] - } - } - } - }, - "SamlProvider": { - "identifiers": [ - { "name": "Arn" } - ], - "shape": "GetSAMLProviderResponse", - "load": { - "request": { - "operation": "GetSAMLProvider", - "params": [ - { "target": "SAMLProviderArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteSAMLProvider", - "params": [ - { "target": "SAMLProviderArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateSAMLProvider", - "params": [ - { "target": "SAMLProviderArn", "source": "identifier", "name": "Arn" } - ] - } - } - } - }, - "ServerCertificate": { - "identifiers": [ - { "name": "Name" } - ], - "shape": "ServerCertificate", - "load": { - "request": { - "operation": "GetServerCertificate", - "params": [ - { "target": "ServerCertificateName", "source": "identifier", "name": "Name" } - ] - }, - "path": "ServerCertificate" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteServerCertificate", - "params": [ - { "target": "ServerCertificateName", "source": "identifier", "name": "Name" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateServerCertificate", - "params": [ - { "target": "ServerCertificateName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "ServerCertificate", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "NewServerCertificateName" } - ] - } - } - } - }, - "SigningCertificate": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - }, - { - "name": "Id", - "memberName": "CertificateId" - } - ], - "shape": "SigningCertificate", - "actions": { - "Activate": { - "request": { - "operation": "UpdateSigningCertificate", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "CertificateId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Active" } - ] - } - }, - "Deactivate": { - "request": { - "operation": "UpdateSigningCertificate", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "CertificateId", "source": "identifier", "name": "Id" }, - { "target": "Status", "source": "string", "value": "Inactive" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteSigningCertificate", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "CertificateId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "UserName" } - ] - } - } - } - }, - "User": { - "identifiers": [ - { - "name": "Name", - "memberName": "UserName" - } - ], - "shape": "User", - "load": { - "request": { - "operation": "GetUser", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "path": "User" - }, - "actions": { - "AddGroup": { - "request": { - "operation": "AddUserToGroup", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "AttachPolicy": { - "request": { - "operation": "AttachUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "Create": { - "request": { - "operation": "CreateUser", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "UserName" } - ], - "path": "User" - } - }, - "CreateAccessKeyPair": { - "request": { - "operation": "CreateAccessKey", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "AccessKeyPair", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "AccessKey.AccessKeyId" }, - { "target": "Secret", "source": "response", "path": "AccessKey.SecretAccessKey" } - ], - "path": "AccessKey" - } - }, - "CreateLoginProfile": { - "request": { - "operation": "CreateLoginProfile", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "LoginProfile", - "identifiers": [ - { "target": "UserName", "source": "response", "path": "LoginProfile.UserName" } - ], - "path": "LoginProfile" - } - }, - "CreatePolicy": { - "request": { - "operation": "PutUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "UserPolicy", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "requestParameter", "path": "PolicyName" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteUser", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "DetachPolicy": { - "request": { - "operation": "DetachUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "EnableMfa": { - "request": { - "operation": "EnableMFADevice", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "MfaDevice", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "SerialNumber", "source": "requestParameter", "path": "SerialNumber" } - ] - } - }, - "RemoveGroup": { - "request": { - "operation": "RemoveUserFromGroup", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "Update": { - "request": { - "operation": "UpdateUser", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "NewUserName" } - ] - } - } - }, - "has": { - "AccessKey": { - "resource": { - "type": "AccessKey", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "input" } - ] - } - }, - "LoginProfile": { - "resource": { - "type": "LoginProfile", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - } - }, - "MfaDevice": { - "resource": { - "type": "MfaDevice", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "SerialNumber", "source": "input" } - ] - } - }, - "Policy": { - "resource": { - "type": "UserPolicy", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "input" } - ] - } - }, - "SigningCertificate": { - "resource": { - "type": "SigningCertificate", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "AccessKeys": { - "request": { - "operation": "ListAccessKeys", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "AccessKey", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "AccessKeyMetadata[].AccessKeyId" } - ], - "path": "AccessKeyMetadata[]" - } - }, - "AttachedPolicies": { - "request": { - "operation": "ListAttachedUserPolicies", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Policy", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "AttachedPolicies[].PolicyArn" } - ] - } - }, - "Groups": { - "request": { - "operation": "ListGroupsForUser", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Group", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Groups[].GroupName" } - ], - "path": "Groups[]" - } - }, - "MfaDevices": { - "request": { - "operation": "ListMFADevices", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "MfaDevice", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "SerialNumber", "source": "response", "path": "MFADevices[].SerialNumber" } - ], - "path": "MFADevices[]" - } - }, - "Policies": { - "request": { - "operation": "ListUserPolicies", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "UserPolicy", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Name", "source": "response", "path": "PolicyNames[]" } - ] - } - }, - "SigningCertificates": { - "request": { - "operation": "ListSigningCertificates", - "params": [ - { "target": "UserName", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "SigningCertificate", - "identifiers": [ - { "target": "UserName", "source": "identifier", "name": "Name" }, - { "target": "Id", "source": "response", "path": "Certificates[].CertificateId" } - ], - "path": "Certificates[]" - } - } - } - }, - "UserPolicy": { - "identifiers": [ - { - "name": "UserName", - "memberName": "UserName" - }, - { - "name": "Name", - "memberName": "PolicyName" - } - ], - "shape": "GetUserPolicyResponse", - "load": { - "request": { - "operation": "GetUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - }, - "Put": { - "request": { - "operation": "PutUserPolicy", - "params": [ - { "target": "UserName", "source": "identifier", "name": "UserName" }, - { "target": "PolicyName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "UserName" } - ] - } - } - } - }, - "VirtualMfaDevice": { - "identifiers": [ - { - "name": "SerialNumber", - "memberName": "SerialNumber" - } - ], - "shape": "VirtualMFADevice", - "actions": { - "Delete": { - "request": { - "operation": "DeleteVirtualMFADevice", - "params": [ - { "target": "SerialNumber", "source": "identifier", "name": "SerialNumber" } - ] - } - } - }, - "has": { - "User": { - "resource": { - "type": "User", - "identifiers": [ - { "target": "Name", "source": "data", "path": "User.UserName" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/opsworks/2013-02-18/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/opsworks/2013-02-18/resources-1.json deleted file mode 100644 index 0435b13b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/opsworks/2013-02-18/resources-1.json +++ /dev/null @@ -1,173 +0,0 @@ -{ - "service": { - "actions": { - "CreateStack": { - "request": { "operation": "CreateStack" }, - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Id", "source": "response", "path": "StackId" } - ] - } - } - }, - "has": { - "Layer": { - "resource": { - "type": "Layer", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - }, - "Stack": { - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Id", "source": "input" } - ] - } - } - }, - "hasMany": { - "Stacks": { - "request": { "operation": "DescribeStacks" }, - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Stacks[].StackId" } - ], - "path": "Stacks[]" - } - } - } - }, - "resources": { - "Layer": { - "identifiers": [ - { "name": "Id" } - ], - "shape": "Layer", - "load": { - "request": { - "operation": "DescribeLayers", - "params": [ - { "target": "LayerIds[]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Layers[0]" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteLayer", - "params": [ - { "target": "LayerId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Stack": { - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Id", "source": "data", "path": "StackId" } - ] - } - } - } - }, - "Stack": { - "identifiers": [ - { "name": "Id" } - ], - "shape": "Stack", - "load": { - "request": { - "operation": "DescribeStacks", - "params": [ - { "target": "StackIds[]", "source": "identifier", "name": "Id" } - ] - }, - "path": "Stacks[0]" - }, - "actions": { - "CreateLayer": { - "request": { - "operation": "CreateLayer", - "params": [ - { "target": "StackId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Layer", - "identifiers": [ - { "target": "Id", "source": "response", "path": "LayerId" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteStack", - "params": [ - { "target": "StackId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Summary": { - "resource": { - "type": "StackSummary", - "identifiers": [ - { "target": "StackId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "hasMany": { - "Layers": { - "request": { - "operation": "DescribeLayers", - "params": [ - { "target": "StackId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Layer", - "identifiers": [ - { "target": "Id", "source": "response", "path": "Layers[].LayerId" } - ], - "path": "Layers[]" - } - } - } - }, - "StackSummary": { - "identifiers": [ - { "name": "StackId" } - ], - "shape": "StackSummary", - "load": { - "request": { - "operation": "DescribeStackSummary", - "params": [ - { "target": "StackId", "source": "identifier", "name": "StackId" } - ] - }, - "path": "StackSummary" - }, - "has": { - "Stack": { - "resource": { - "type": "Stack", - "identifiers": [ - { "target": "Id", "source": "identifier", "name": "StackId" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/s3/2006-03-01/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/s3/2006-03-01/resources-1.json deleted file mode 100644 index f1e88c63..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/s3/2006-03-01/resources-1.json +++ /dev/null @@ -1,1249 +0,0 @@ -{ - "service": { - "actions": { - "CreateBucket": { - "request": { "operation": "CreateBucket" }, - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "requestParameter", "path": "Bucket" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "input" } - ] - } - } - }, - "hasMany": { - "Buckets": { - "request": { "operation": "ListBuckets" }, - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "response", "path": "Buckets[].Name" } - ], - "path": "Buckets[]" - } - } - } - }, - "resources": { - "Bucket": { - "identifiers": [ - { "name": "Name" } - ], - "shape": "Bucket", - "actions": { - "Create": { - "request": { - "operation": "CreateBucket", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteBucket", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - } - }, - "DeleteObjects": { - "request": { - "operation": "DeleteObjects", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - } - }, - "PutObject": { - "request": { - "operation": "PutObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" }, - { "target": "Key", "source": "requestParameter", "path": "Key" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "BucketExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - }, - "NotExists": { - "waiterName": "BucketNotExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - } - }, - "has": { - "Acl": { - "resource": { - "type": "BucketAcl", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Cors": { - "resource": { - "type": "BucketCors", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Lifecycle": { - "resource": { - "type": "BucketLifecycle", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "LifecycleConfiguration": { - "resource": { - "type": "BucketLifecycleConfiguration", - "identifiers": [ - { - "target": "BucketName", - "source": "identifier", - "name": "Name" - } - ] - } - }, - "Logging": { - "resource": { - "type": "BucketLogging", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Notification": { - "resource": { - "type": "BucketNotification", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Object": { - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" }, - { "target": "Key", "source": "input" } - ] - } - }, - "Policy": { - "resource": { - "type": "BucketPolicy", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "RequestPayment": { - "resource": { - "type": "BucketRequestPayment", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Tagging": { - "resource": { - "type": "BucketTagging", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Versioning": { - "resource": { - "type": "BucketVersioning", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - }, - "Website": { - "resource": { - "type": "BucketWebsite", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" } - ] - } - } - }, - "hasMany": { - "MultipartUploads": { - "request": { - "operation": "ListMultipartUploads", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" }, - { "target": "ObjectKey", "source": "response", "path": "Uploads[].Key" }, - { "target": "Id", "source": "response", "path": "Uploads[].UploadId" } - ], - "path": "Uploads[]" - } - }, - "ObjectVersions": { - "request": { - "operation": "ListObjectVersions", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "ObjectVersion", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" }, - { "target": "ObjectKey", "source": "response", "path": "[Versions,DeleteMarkers]|[].Key" }, - { "target": "Id", "source": "response", "path": "[Versions,DeleteMarkers]|[].VersionId" } - ], - "path": "[Versions,DeleteMarkers]|[]" - } - }, - "Objects": { - "request": { - "operation": "ListObjects", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "Name" } - ] - }, - "resource": { - "type": "ObjectSummary", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "Name" }, - { "target": "Key", "source": "response", "path": "Contents[].Key" } - ], - "path": "Contents[]" - } - } - } - }, - "BucketAcl": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketAclOutput", - "load": { - "request": { - "operation": "GetBucketAcl", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Put": { - "request": { - "operation": "PutBucketAcl", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketCors": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketCorsOutput", - "load": { - "request": { - "operation": "GetBucketCors", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketCors", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketCors", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketLifecycle": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketLifecycleOutput", - "load": { - "request": { - "operation": "GetBucketLifecycle", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketLifecycle", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketLifecycle", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketLifecycleConfiguration": { - "identifiers": [ - { - "name": "BucketName" - } - ], - "shape": "GetBucketLifecycleConfigurationOutput", - "load": { - "request": { - "operation": "GetBucketLifecycleConfiguration", - "params": [ - { - "target": "Bucket", - "source": "identifier", - "name": "BucketName" - } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketLifecycle", - "params": [ - { - "target": "Bucket", - "source": "identifier", - "name": "BucketName" - } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketLifecycleConfiguration", - "params": [ - { - "target": "Bucket", - "source": "identifier", - "name": "BucketName" - } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { - "target": "Name", - "source": "identifier", - "name": "BucketName" - } - ] - } - } - } - }, - "BucketLogging": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketLoggingOutput", - "load": { - "request": { - "operation": "GetBucketLogging", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Put": { - "request": { - "operation": "PutBucketLogging", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketNotification": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "NotificationConfiguration", - "load": { - "request": { - "operation": "GetBucketNotificationConfiguration", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Put": { - "request": { - "operation": "PutBucketNotificationConfiguration", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketPolicy": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketPolicyOutput", - "load": { - "request": { - "operation": "GetBucketPolicy", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketPolicy", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketPolicy", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketRequestPayment": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketRequestPaymentOutput", - "load": { - "request": { - "operation": "GetBucketRequestPayment", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Put": { - "request": { - "operation": "PutBucketRequestPayment", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketTagging": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketTaggingOutput", - "load": { - "request": { - "operation": "GetBucketTagging", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketTagging", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketTagging", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketVersioning": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketVersioningOutput", - "load": { - "request": { - "operation": "GetBucketVersioning", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Enable": { - "request": { - "operation": "PutBucketVersioning", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "VersioningConfiguration.Status", "source": "string", "value": "Enabled" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketVersioning", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Suspend": { - "request": { - "operation": "PutBucketVersioning", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "VersioningConfiguration.Status", "source": "string", "value": "Suspended" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "BucketWebsite": { - "identifiers": [ - { "name": "BucketName" } - ], - "shape": "GetBucketWebsiteOutput", - "load": { - "request": { - "operation": "GetBucketWebsite", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteBucketWebsite", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - }, - "Put": { - "request": { - "operation": "PutBucketWebsite", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" } - ] - } - } - }, - "has": { - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - } - } - }, - "MultipartUpload": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "ObjectKey" }, - { "name": "Id" } - ], - "shape": "MultipartUpload", - "actions": { - "Abort": { - "request": { - "operation": "AbortMultipartUpload", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "UploadId", "source": "identifier", "name": "Id" } - ] - } - }, - "Complete": { - "request": { - "operation": "CompleteMultipartUpload", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "UploadId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - } - } - }, - "has": { - "Object": { - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - } - }, - "Part": { - "resource": { - "type": "MultipartUploadPart", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "ObjectKey" }, - { "target": "MultipartUploadId", "source": "identifier", "name": "Id" }, - { "target": "PartNumber", "source": "input" } - ] - } - } - }, - "hasMany": { - "Parts": { - "request": { - "operation": "ListParts", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "UploadId", "source": "identifier", "name": "Id" } - ] - }, - "resource": { - "type": "MultipartUploadPart", - "identifiers": [ - { "target": "BucketName", "source": "requestParameter", "path": "Bucket" }, - { "target": "ObjectKey", "source": "requestParameter", "path": "Key" }, - { "target": "MultipartUploadId", "source": "requestParameter", "path": "UploadId" }, - { "target": "PartNumber", "source": "response", "path": "Parts[].PartNumber" } - ], - "path": "Parts[]" - } - } - } - }, - "MultipartUploadPart": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "ObjectKey" }, - { "name": "MultipartUploadId" }, - { - "name": "PartNumber", - "type": "integer", - "memberName": "PartNumber" - } - ], - "shape": "Part", - "actions": { - "CopyFrom": { - "request": { - "operation": "UploadPartCopy", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "UploadId", "source": "identifier", "name": "MultipartUploadId" }, - { "target": "PartNumber", "source": "identifier", "name": "PartNumber" } - ] - } - }, - "Upload": { - "request": { - "operation": "UploadPart", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "UploadId", "source": "identifier", "name": "MultipartUploadId" }, - { "target": "PartNumber", "source": "identifier", "name": "PartNumber" } - ] - } - } - }, - "has": { - "MultipartUpload": { - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "ObjectKey" }, - { "target": "Id", "source": "identifier", "name": "MultipartUploadId" } - ] - } - } - } - }, - "Object": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "Key" } - ], - "shape": "HeadObjectOutput", - "load": { - "request": { - "operation": "HeadObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - }, - "path": "@" - }, - "actions": { - "CopyFrom": { - "request": { - "operation": "CopyObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "Get": { - "request": { - "operation": "GetObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "InitiateMultipartUpload": { - "request": { - "operation": "CreateMultipartUpload", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "response", "path": "UploadId" } - ] - } - }, - "Put": { - "request": { - "operation": "PutObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "RestoreObject": { - "request": { - "operation": "RestoreObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteObjects", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Delete.Objects[].Key", "source": "identifier", "name": "Key" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "ObjectExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - }, - "NotExists": { - "waiterName": "ObjectNotExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "has": { - "Acl": { - "resource": { - "type": "ObjectAcl", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" } - ] - } - }, - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - }, - "MultipartUpload": { - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "input" } - ] - } - }, - "Version": { - "resource": { - "type": "ObjectVersion", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "input" } - ] - } - } - } - }, - "ObjectAcl": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "ObjectKey" } - ], - "shape": "GetObjectAclOutput", - "load": { - "request": { - "operation": "GetObjectAcl", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - }, - "path": "@" - }, - "actions": { - "Put": { - "request": { - "operation": "PutObjectAcl", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - } - } - }, - "has": { - "Object": { - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - } - } - } - }, - "ObjectSummary": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "Key" } - ], - "shape": "Object", - "actions": { - "CopyFrom": { - "request": { - "operation": "CopyObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "Get": { - "request": { - "operation": "GetObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "InitiateMultipartUpload": { - "request": { - "operation": "CreateMultipartUpload", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - }, - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "response", "path": "UploadId" } - ] - } - }, - "Put": { - "request": { - "operation": "PutObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "RestoreObject": { - "request": { - "operation": "RestoreObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteObjects", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Delete.Objects[].Key", "source": "identifier", "name": "Key" } - ] - } - } - }, - "waiters": { - "Exists": { - "waiterName": "ObjectExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - }, - "NotExists": { - "waiterName": "ObjectNotExists", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "has": { - "Acl": { - "resource": { - "type": "ObjectAcl", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" } - ] - } - }, - "Bucket": { - "resource": { - "type": "Bucket", - "identifiers": [ - { "target": "Name", "source": "identifier", "name": "BucketName" } - ] - } - }, - "MultipartUpload": { - "resource": { - "type": "MultipartUpload", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "input" } - ] - } - }, - "Object": { - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "Key" } - ] - } - }, - "Version": { - "resource": { - "type": "ObjectVersion", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "ObjectKey", "source": "identifier", "name": "Key" }, - { "target": "Id", "source": "input" } - ] - } - } - } - }, - "ObjectVersion": { - "identifiers": [ - { "name": "BucketName" }, - { "name": "ObjectKey" }, - { "name": "Id" } - ], - "shape": "ObjectVersion", - "actions": { - "Delete": { - "request": { - "operation": "DeleteObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "VersionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Get": { - "request": { - "operation": "GetObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "VersionId", "source": "identifier", "name": "Id" } - ] - } - }, - "Head": { - "request": { - "operation": "HeadObject", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "VersionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteObjects", - "params": [ - { "target": "Bucket", "source": "identifier", "name": "BucketName" }, - { "target": "Delete.Objects[*].Key", "source": "identifier", "name": "ObjectKey" }, - { "target": "Delete.Objects[*].VersionId", "source": "identifier", "name": "Id" } - ] - } - } - }, - "has": { - "Object": { - "resource": { - "type": "Object", - "identifiers": [ - { "target": "BucketName", "source": "identifier", "name": "BucketName" }, - { "target": "Key", "source": "identifier", "name": "ObjectKey" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sns/2010-03-31/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sns/2010-03-31/resources-1.json deleted file mode 100644 index cee300a8..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sns/2010-03-31/resources-1.json +++ /dev/null @@ -1,327 +0,0 @@ -{ - "service": { - "actions": { - "CreatePlatformApplication": { - "request": { "operation": "CreatePlatformApplication" }, - "resource": { - "type": "PlatformApplication", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "PlatformApplicationArn" } - ] - } - }, - "CreateTopic": { - "request": { "operation": "CreateTopic" }, - "resource": { - "type": "Topic", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "TopicArn" } - ] - } - } - }, - "has": { - "PlatformApplication": { - "resource": { - "type": "PlatformApplication", - "identifiers": [ - { "target": "Arn", "source": "input" } - ] - } - }, - "PlatformEndpoint": { - "resource": { - "type": "PlatformEndpoint", - "identifiers": [ - { "target": "Arn", "source": "input" } - ] - } - }, - "Subscription": { - "resource": { - "type": "Subscription", - "identifiers": [ - { "target": "Arn", "source": "input" } - ] - } - }, - "Topic": { - "resource": { - "type": "Topic", - "identifiers": [ - { "target": "Arn", "source": "input" } - ] - } - } - }, - "hasMany": { - "PlatformApplications": { - "request": { "operation": "ListPlatformApplications" }, - "resource": { - "type": "PlatformApplication", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "PlatformApplications[].PlatformApplicationArn" } - ] - } - }, - "Subscriptions": { - "request": { "operation": "ListSubscriptions" }, - "resource": { - "type": "Subscription", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Subscriptions[].SubscriptionArn" } - ] - } - }, - "Topics": { - "request": { "operation": "ListTopics" }, - "resource": { - "type": "Topic", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Topics[].TopicArn" } - ] - } - } - } - }, - "resources": { - "PlatformApplication": { - "identifiers": [ - { "name": "Arn" } - ], - "shape": "GetPlatformApplicationAttributesResponse", - "load": { - "request": { - "operation": "GetPlatformApplicationAttributes", - "params": [ - { "target": "PlatformApplicationArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "@" - }, - "actions": { - "CreatePlatformEndpoint": { - "request": { - "operation": "CreatePlatformEndpoint", - "params": [ - { "target": "PlatformApplicationArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "PlatformEndpoint", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "EndpointArn" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeletePlatformApplication", - "params": [ - { "target": "PlatformApplicationArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "SetAttributes": { - "request": { - "operation": "SetPlatformApplicationAttributes", - "params": [ - { "target": "PlatformApplicationArn", "source": "identifier", "name": "Arn" } - ] - } - } - }, - "hasMany": { - "Endpoints": { - "request": { - "operation": "ListEndpointsByPlatformApplication", - "params": [ - { "target": "PlatformApplicationArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "PlatformEndpoint", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Endpoints[].EndpointArn" } - ] - } - } - } - }, - "PlatformEndpoint": { - "identifiers": [ - { "name": "Arn" } - ], - "shape": "GetEndpointAttributesResponse", - "load": { - "request": { - "operation": "GetEndpointAttributes", - "params": [ - { "target": "EndpointArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "DeleteEndpoint", - "params": [ - { "target": "EndpointArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "Publish": { - "request": { - "operation": "Publish", - "params": [ - { "target": "TargetArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "SetAttributes": { - "request": { - "operation": "SetEndpointAttributes", - "params": [ - { "target": "EndpointArn", "source": "identifier", "name": "Arn" } - ] - } - } - } - }, - "Subscription": { - "identifiers": [ - { "name": "Arn" } - ], - "shape": "GetSubscriptionAttributesResponse", - "load": { - "request": { - "operation": "GetSubscriptionAttributes", - "params": [ - { "target": "SubscriptionArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "@" - }, - "actions": { - "Delete": { - "request": { - "operation": "Unsubscribe", - "params": [ - { "target": "SubscriptionArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "SetAttributes": { - "request": { - "operation": "SetSubscriptionAttributes", - "params": [ - { "target": "SubscriptionArn", "source": "identifier", "name": "Arn" } - ] - } - } - } - }, - "Topic": { - "identifiers": [ - { "name": "Arn" } - ], - "shape": "GetTopicAttributesResponse", - "load": { - "request": { - "operation": "GetTopicAttributes", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - }, - "path": "@" - }, - "actions": { - "AddPermission": { - "request": { - "operation": "AddPermission", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "ConfirmSubscription": { - "request": { - "operation": "ConfirmSubscription", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "Subscription", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "SubscriptionArn" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteTopic", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "Publish": { - "request": { - "operation": "Publish", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "RemovePermission": { - "request": { - "operation": "RemovePermission", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "SetAttributes": { - "request": { - "operation": "SetTopicAttributes", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - } - }, - "Subscribe": { - "request": { - "operation": "Subscribe", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "Subscription", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "SubscriptionArn" } - ] - } - } - }, - "hasMany": { - "Subscriptions": { - "request": { - "operation": "ListSubscriptionsByTopic", - "params": [ - { "target": "TopicArn", "source": "identifier", "name": "Arn" } - ] - }, - "resource": { - "type": "Subscription", - "identifiers": [ - { "target": "Arn", "source": "response", "path": "Subscriptions[].SubscriptionArn" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sqs/2012-11-05/resources-1.json b/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sqs/2012-11-05/resources-1.json deleted file mode 100644 index b1e74ab0..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/data/sqs/2012-11-05/resources-1.json +++ /dev/null @@ -1,232 +0,0 @@ -{ - "service": { - "actions": { - "CreateQueue": { - "request": { "operation": "CreateQueue" }, - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "response", "path": "QueueUrl" } - ] - } - }, - "GetQueueByName": { - "request": { "operation": "GetQueueUrl" }, - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "response", "path": "QueueUrl" } - ] - } - } - }, - "has": { - "Queue": { - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "input" } - ] - } - } - }, - "hasMany": { - "Queues": { - "request": { "operation": "ListQueues" }, - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "response", "path": "QueueUrls[]" } - ] - } - } - } - }, - "resources": { - "Message": { - "identifiers": [ - { "name": "QueueUrl" }, - { - "name": "ReceiptHandle", - "memberName": "ReceiptHandle" - } - ], - "shape": "Message", - "actions": { - "ChangeVisibility": { - "request": { - "operation": "ChangeMessageVisibility", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "QueueUrl" }, - { "target": "ReceiptHandle", "source": "identifier", "name": "ReceiptHandle" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteMessage", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "QueueUrl" }, - { "target": "ReceiptHandle", "source": "identifier", "name": "ReceiptHandle" } - ] - } - } - }, - "batchActions": { - "Delete": { - "request": { - "operation": "DeleteMessageBatch", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "QueueUrl" }, - { "target": "Entries[*].Id", "source": "data", "path": "MessageId" }, - { "target": "Entries[*].ReceiptHandle", "source": "identifier", "name": "ReceiptHandle" } - ] - } - } - }, - "has": { - "Queue": { - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "identifier", "name": "QueueUrl" } - ] - } - } - } - }, - "Queue": { - "identifiers": [ - { "name": "Url" } - ], - "shape": "GetQueueAttributesResult", - "load": { - "request": { - "operation": "GetQueueAttributes", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" }, - { "target": "AttributeNames[]", "source": "string", "value": "All" } - ] - }, - "path": "@" - }, - "actions": { - "AddPermission": { - "request": { - "operation": "AddPermission", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "ChangeMessageVisibilityBatch": { - "request": { - "operation": "ChangeMessageVisibilityBatch", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "Delete": { - "request": { - "operation": "DeleteQueue", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "DeleteMessages": { - "request": { - "operation": "DeleteMessageBatch", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "Purge": { - "request": { - "operation": "PurgeQueue", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "ReceiveMessages": { - "request": { - "operation": "ReceiveMessage", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - }, - "resource": { - "type": "Message", - "identifiers": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" }, - { "target": "ReceiptHandle", "source": "response", "path": "Messages[].ReceiptHandle" } - ], - "path": "Messages[]" - } - }, - "RemovePermission": { - "request": { - "operation": "RemovePermission", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "SendMessage": { - "request": { - "operation": "SendMessage", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "SendMessages": { - "request": { - "operation": "SendMessageBatch", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - }, - "SetAttributes": { - "request": { - "operation": "SetQueueAttributes", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - } - } - }, - "has": { - "Message": { - "resource": { - "type": "Message", - "identifiers": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" }, - { "target": "ReceiptHandle", "source": "input" } - ] - } - } - }, - "hasMany": { - "DeadLetterSourceQueues": { - "request": { - "operation": "ListDeadLetterSourceQueues", - "params": [ - { "target": "QueueUrl", "source": "identifier", "name": "Url" } - ] - }, - "resource": { - "type": "Queue", - "identifiers": [ - { "target": "Url", "source": "response", "path": "queueUrls[]" } - ] - } - } - } - } - } -} diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/__init__.py deleted file mode 100644 index c18c86e1..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/__init__.py +++ /dev/null @@ -1,39 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import os - -from boto3.docs.service import ServiceDocumenter - - -def generate_docs(root_dir, session): - """Generates the reference documentation for botocore - - This will go through every available AWS service and output ReSTructured - text files documenting each service. - - :param root_dir: The directory to write the reference files to. Each - service's reference documentation is loacated at - root_dir/reference/services/service-name.rst - - :param session: The boto3 session - """ - services_doc_path = os.path.join(root_dir, 'reference', 'services') - if not os.path.exists(services_doc_path): - os.makedirs(services_doc_path) - - for service_name in session.get_available_services(): - docs = ServiceDocumenter(service_name, session).document_service() - service_doc_path = os.path.join( - services_doc_path, service_name + '.rst') - with open(service_doc_path, 'wb') as f: - f.write(docs) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/action.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/action.py deleted file mode 100644 index a1a51ccd..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/action.py +++ /dev/null @@ -1,148 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.model import OperationModel -from botocore.utils import get_service_module_name -from botocore.docs.method import document_model_driven_method -from botocore.docs.method import document_custom_method - -from boto3.docs.base import BaseDocumenter -from boto3.docs.method import document_model_driven_resource_method -from boto3.docs.utils import get_resource_ignore_params -from boto3.docs.utils import get_resource_public_actions -from boto3.docs.utils import add_resource_type_overview - - -class ActionDocumenter(BaseDocumenter): - def document_actions(self, section): - modeled_actions_list = self._resource_model.actions - modeled_actions = {} - for modeled_action in modeled_actions_list: - modeled_actions[modeled_action.name] = modeled_action - resource_actions = get_resource_public_actions( - self._resource.__class__) - self.member_map['actions'] = sorted(resource_actions) - add_resource_type_overview( - section=section, - resource_type='Actions', - description=( - 'Actions call operations on resources. They may ' - 'automatically handle the passing in of arguments set ' - 'from identifiers and some attributes.'), - intro_link='actions_intro') - - for action_name in sorted(resource_actions): - action_section = section.add_new_section(action_name) - if action_name in ['load', 'reload'] and self._resource_model.load: - document_load_reload_action( - section=action_section, - action_name=action_name, - resource_name=self._resource_name, - event_emitter=self._resource.meta.client.meta.events, - load_model=self._resource_model.load, - service_model=self._service_model - ) - elif action_name in modeled_actions: - document_action( - section=action_section, - resource_name=self._resource_name, - event_emitter=self._resource.meta.client.meta.events, - action_model=modeled_actions[action_name], - service_model=self._service_model, - ) - else: - document_custom_method( - action_section, action_name, resource_actions[action_name]) - - -def document_action(section, resource_name, event_emitter, action_model, - service_model, include_signature=True): - """Documents a resource action - - :param section: The section to write to - - :param resource_name: The name of the resource - - :param event_emitter: The event emitter to use to emit events - - :param action_model: The model of the action - - :param service_model: The model of the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - operation_model = service_model.operation_model( - action_model.request.operation) - ignore_params = get_resource_ignore_params(action_model.request.params) - - example_return_value = 'response' - if action_model.resource: - example_return_value = xform_name(action_model.resource.type) - example_resource_name = xform_name(resource_name) - if service_model.service_name == resource_name: - example_resource_name = resource_name - example_prefix = '%s = %s.%s' % ( - example_return_value, example_resource_name, action_model.name) - document_model_driven_resource_method( - section=section, method_name=action_model.name, - operation_model=operation_model, - event_emitter=event_emitter, - method_description=operation_model.documentation, - example_prefix=example_prefix, - exclude_input=ignore_params, - resource_action_model=action_model, - include_signature=include_signature - ) - - -def document_load_reload_action(section, action_name, resource_name, - event_emitter, load_model, service_model, - include_signature=True): - """Documents the resource load action - - :param section: The section to write to - - :param action_name: The name of the loading action should be load or reload - - :param resource_name: The name of the resource - - :param event_emitter: The event emitter to use to emit events - - :param load_model: The model of the load action - - :param service_model: The model of the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - description = ( - 'Calls :py:meth:`%s.Client.%s` to update the attributes of the' - ' %s resource. Note that the load and reload methods are ' - 'the same method and can be used interchangeably.' % ( - get_service_module_name(service_model), - xform_name(load_model.request.operation), - resource_name) - ) - example_resource_name = xform_name(resource_name) - if service_model.service_name == resource_name: - example_resource_name = resource_name - example_prefix = '%s.%s' % (example_resource_name, action_name) - document_model_driven_method( - section=section, method_name=action_name, - operation_model=OperationModel({}, service_model), - event_emitter=event_emitter, - method_description=description, - example_prefix=example_prefix, - include_signature=include_signature - ) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/attr.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/attr.py deleted file mode 100644 index 4ebbc7d5..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/attr.py +++ /dev/null @@ -1,54 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.params import ResponseParamsDocumenter - -from boto3.docs.utils import get_identifier_description - - -class ResourceShapeDocumenter(ResponseParamsDocumenter): - EVENT_NAME = 'resource-shape' - - -def document_attribute(section, service_name, resource_name, attr_name, - event_emitter, attr_model, include_signature=True): - if include_signature: - section.style.start_sphinx_py_attr(attr_name) - # Note that an attribute may have one, may have many, or may have no - # operations that back the resource's shape. So we just set the - # operation_name to the resource name if we ever to hook in and modify - # a particular attribute. - ResourceShapeDocumenter( - service_name=service_name, operation_name=resource_name, - event_emitter=event_emitter).document_params( - section=section, - shape=attr_model) - - -def document_identifier(section, resource_name, identifier_model, - include_signature=True): - if include_signature: - section.style.start_sphinx_py_attr(identifier_model.name) - description = get_identifier_description( - resource_name, identifier_model.name) - description = '*(string)* ' + description - section.write(description) - - -def document_reference(section, reference_model, include_signature=True): - if include_signature: - section.style.start_sphinx_py_attr(reference_model.name) - reference_type = '(:py:class:`%s`) ' % reference_model.resource.type - section.write(reference_type) - section.include_doc_string( - 'The related %s if set, otherwise ``None``.' % reference_model.name - ) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/base.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/base.py deleted file mode 100644 index 1ebd4222..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/base.py +++ /dev/null @@ -1,31 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.compat import OrderedDict - - -class BaseDocumenter(object): - def __init__(self, resource): - self._resource = resource - self._client = self._resource.meta.client - self._resource_model = self._resource.meta.resource_model - self._service_model = self._client.meta.service_model - self._resource_name = self._resource.meta.resource_model.name - self._service_name = self._service_model.service_name - self._service_docs_name = self._client.__class__.__name__ - self.member_map = OrderedDict() - self.represents_service_resource = ( - self._service_name == self._resource_name) - - @property - def class_name(self): - return '%s.%s' % (self._service_docs_name, self._resource_name) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/client.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/client.py deleted file mode 100644 index 7db8c1f1..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/client.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.client import ClientDocumenter - - -class Boto3ClientDocumenter(ClientDocumenter): - def _add_client_creation_example(self, section): - section.style.start_codeblock() - section.style.new_line() - section.write('import boto3') - section.style.new_line() - section.style.new_line() - section.write( - 'client = boto3.client(\'{service}\')'.format( - service=self._service_name) - ) - section.style.end_codeblock() diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/collection.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/collection.py deleted file mode 100644 index 1825ec24..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/collection.py +++ /dev/null @@ -1,234 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.docs.method import get_instance_public_methods -from botocore.docs.utils import DocumentedShape - -from boto3.docs.base import BaseDocumenter -from boto3.docs.utils import get_resource_ignore_params -from boto3.docs.method import document_model_driven_resource_method -from boto3.docs.utils import add_resource_type_overview - - -class CollectionDocumenter(BaseDocumenter): - def document_collections(self, section): - collections = self._resource.meta.resource_model.collections - collections_list = [] - add_resource_type_overview( - section=section, - resource_type='Collections', - description=( - 'Collections provide an interface to iterate over and ' - 'manipulate groups of resources. '), - intro_link='guide_collections') - self.member_map['collections'] = collections_list - for collection in collections: - collection_section = section.add_new_section(collection.name) - collections_list.append(collection.name) - self._document_collection(collection_section, collection) - - def _document_collection(self, section, collection): - methods = get_instance_public_methods( - getattr(self._resource, collection.name)) - document_collection_object(section, collection) - batch_actions = {} - for batch_action in collection.batch_actions: - batch_actions[batch_action.name] = batch_action - - for method in sorted(methods): - method_section = section.add_new_section(method) - if method in batch_actions: - document_batch_action( - section=method_section, - resource_name=self._resource_name, - event_emitter=self._resource.meta.client.meta.events, - batch_action_model=batch_actions[method], - collection_model=collection, - service_model=self._resource.meta.client.meta.service_model - ) - else: - document_collection_method( - section=method_section, - resource_name=self._resource_name, - action_name=method, - event_emitter=self._resource.meta.client.meta.events, - collection_model=collection, - service_model=self._resource.meta.client.meta.service_model - ) - - -def document_collection_object(section, collection_model, - include_signature=True): - """Documents a collection resource object - - :param section: The section to write to - - :param collection_model: The model of the collection - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - if include_signature: - section.style.start_sphinx_py_attr(collection_model.name) - section.include_doc_string( - 'A collection of %s resources' % collection_model.resource.type) - - -def document_batch_action(section, resource_name, event_emitter, - batch_action_model, service_model, collection_model, - include_signature=True): - """Documents a collection's batch action - - :param section: The section to write to - - :param resource_name: The name of the resource - - :param action_name: The name of collection action. Currently only - can be all, filter, limit, or page_size - - :param event_emitter: The event emitter to use to emit events - - :param batch_action_model: The model of the batch action - - :param collection_model: The model of the collection - - :param service_model: The model of the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - operation_model = service_model.operation_model( - batch_action_model.request.operation) - ignore_params = get_resource_ignore_params( - batch_action_model.request.params) - - example_return_value = 'response' - if batch_action_model.resource: - example_return_value = xform_name(batch_action_model.resource.type) - - example_resource_name = xform_name(resource_name) - if service_model.service_name == resource_name: - example_resource_name = resource_name - example_prefix = '%s = %s.%s.%s' % ( - example_return_value, example_resource_name, - collection_model.name, batch_action_model.name - ) - document_model_driven_resource_method( - section=section, method_name=batch_action_model.name, - operation_model=operation_model, - event_emitter=event_emitter, - method_description=operation_model.documentation, - example_prefix=example_prefix, - exclude_input=ignore_params, - resource_action_model=batch_action_model, - include_signature=include_signature - ) - - -def document_collection_method(section, resource_name, action_name, - event_emitter, collection_model, service_model, - include_signature=True): - """Documents a collection method - - :param section: The section to write to - - :param resource_name: The name of the resource - - :param action_name: The name of collection action. Currently only - can be all, filter, limit, or page_size - - :param event_emitter: The event emitter to use to emit events - - :param collection_model: The model of the collection - - :param service_model: The model of the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - operation_model = service_model.operation_model( - collection_model.request.operation) - - underlying_operation_members = [] - if operation_model.input_shape: - underlying_operation_members = operation_model.input_shape.members - - example_resource_name = xform_name(resource_name) - if service_model.service_name == resource_name: - example_resource_name = resource_name - - custom_action_info_dict = { - 'all': { - 'method_description': ( - 'Creates an iterable of all %s resources ' - 'in the collection.' % collection_model.resource.type), - 'example_prefix': '%s_iterator = %s.%s.all' % ( - xform_name(collection_model.resource.type), - example_resource_name, collection_model.name), - 'exclude_input': underlying_operation_members - }, - 'filter': { - 'method_description': ( - 'Creates an iterable of all %s resources ' - 'in the collection filtered by kwargs passed to ' - 'method.' % collection_model.resource.type), - 'example_prefix': '%s_iterator = %s.%s.filter' % ( - xform_name(collection_model.resource.type), - example_resource_name, collection_model.name), - 'exclude_input': get_resource_ignore_params( - collection_model.request.params) - }, - 'limit': { - 'method_description': ( - 'Creates an iterable up to a specified amount of ' - '%s resources in the collection.' % - collection_model.resource.type), - 'example_prefix': '%s_iterator = %s.%s.limit' % ( - xform_name(collection_model.resource.type), - example_resource_name, collection_model.name), - 'include_input': [ - DocumentedShape( - name='count', type_name='integer', - documentation=( - 'The limit to the number of resources ' - 'in the iterable.'))], - 'exclude_input': underlying_operation_members - }, - 'page_size': { - 'method_description': ( - 'Creates an iterable of all %s resources ' - 'in the collection, but limits the number of ' - 'items returned by each service call by the specified ' - 'amount.' % collection_model.resource.type), - 'example_prefix': '%s_iterator = %s.%s.page_size' % ( - xform_name(collection_model.resource.type), - example_resource_name, collection_model.name), - 'include_input': [ - DocumentedShape( - name='count', type_name='integer', - documentation=( - 'The number of items returned by each ' - 'service call'))], - 'exclude_input': underlying_operation_members - } - } - if action_name in custom_action_info_dict: - action_info = custom_action_info_dict[action_name] - document_model_driven_resource_method( - section=section, method_name=action_name, - operation_model=operation_model, - event_emitter=event_emitter, - resource_action_model=collection_model, - include_signature=include_signature, - **action_info - ) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/docstring.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/docstring.py deleted file mode 100644 index 9dd4d396..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/docstring.py +++ /dev/null @@ -1,74 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.docstring import LazyLoadedDocstring - -from boto3.docs.action import document_action -from boto3.docs.action import document_load_reload_action -from boto3.docs.subresource import document_sub_resource -from boto3.docs.attr import document_attribute -from boto3.docs.attr import document_identifier -from boto3.docs.attr import document_reference -from boto3.docs.collection import document_collection_object -from boto3.docs.collection import document_collection_method -from boto3.docs.collection import document_batch_action -from boto3.docs.waiter import document_resource_waiter - - -class ActionDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_action(*args, **kwargs) - - -class LoadReloadDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_load_reload_action(*args, **kwargs) - - -class SubResourceDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_sub_resource(*args, **kwargs) - - -class AttributeDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_attribute(*args, **kwargs) - - -class IdentifierDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_identifier(*args, **kwargs) - - -class ReferenceDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_reference(*args, **kwargs) - - -class CollectionDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_collection_object(*args, **kwargs) - - -class CollectionMethodDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_collection_method(*args, **kwargs) - - -class BatchActionDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_batch_action(*args, **kwargs) - - -class ResourceWaiterDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_resource_waiter(*args, **kwargs) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/method.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/method.py deleted file mode 100644 index fcc398c7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/method.py +++ /dev/null @@ -1,71 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.method import document_model_driven_method - - -def document_model_driven_resource_method( - section, method_name, operation_model, event_emitter, - method_description=None, example_prefix=None, include_input=None, - include_output=None, exclude_input=None, exclude_output=None, - document_output=True, resource_action_model=None, - include_signature=True): - - document_model_driven_method( - section=section, method_name=method_name, - operation_model=operation_model, - event_emitter=event_emitter, - method_description=method_description, - example_prefix=example_prefix, - include_input=include_input, - include_output=include_output, - exclude_input=exclude_input, - exclude_output=exclude_output, - document_output=document_output, - include_signature=include_signature - ) - - # If this action returns a resource modify the return example to - # appropriately reflect that. - if resource_action_model.resource: - if 'return' in section.available_sections: - section.delete_section('return') - resource_type = resource_action_model.resource.type - - new_return_section = section.add_new_section('return') - return_resource_type = '%s.%s' % ( - operation_model.service_model.service_name, - resource_type) - - return_type = ':py:class:`%s`' % return_resource_type - return_description = '%s resource' % (resource_type) - - if _method_returns_resource_list(resource_action_model.resource): - return_type = 'list(%s)' % return_type - return_description = 'A list of %s resources' % ( - resource_type) - - new_return_section.style.new_line() - new_return_section.write( - ':rtype: %s' % return_type) - new_return_section.style.new_line() - new_return_section.write( - ':returns: %s' % return_description) - new_return_section.style.new_line() - - -def _method_returns_resource_list(resource): - for identifier in resource.identifiers: - if identifier.path and '[]' in identifier.path: - return True - - return False diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/resource.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/resource.py deleted file mode 100644 index 17ecc0ae..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/resource.py +++ /dev/null @@ -1,259 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.docs.utils import get_official_service_name - -from boto3.docs.base import BaseDocumenter -from boto3.docs.action import ActionDocumenter -from boto3.docs.waiter import WaiterResourceDocumenter -from boto3.docs.collection import CollectionDocumenter -from boto3.docs.subresource import SubResourceDocumenter -from boto3.docs.attr import document_attribute -from boto3.docs.attr import document_identifier -from boto3.docs.attr import document_reference -from boto3.docs.utils import get_identifier_args_for_signature -from boto3.docs.utils import get_identifier_values_for_example -from boto3.docs.utils import get_identifier_description -from boto3.docs.utils import add_resource_type_overview - - -class ResourceDocumenter(BaseDocumenter): - def __init__(self, resource, botocore_session): - super(ResourceDocumenter, self).__init__(resource) - self._botocore_session = botocore_session - - def document_resource(self, section): - self._add_title(section) - self._add_intro(section) - overview_section = section.add_new_section('member-overview') - self._add_identifiers(section) - self._add_attributes(section) - self._add_references(section) - self._add_actions(section) - self._add_sub_resources(section) - self._add_collections(section) - self._add_waiters(section) - self._add_overview_of_members(overview_section) - - def _add_title(self, section): - section.style.h2(self._resource_name) - - def _add_intro(self, section): - identifier_names = [] - if self._resource_model.identifiers: - for identifier in self._resource_model.identifiers: - identifier_names.append(identifier.name) - - # Write out the class signature. - class_args = get_identifier_args_for_signature(identifier_names) - section.style.start_sphinx_py_class( - class_name='%s(%s)' % (self.class_name, class_args)) - - # Add as short description about the resource - description_section = section.add_new_section('description') - self._add_description(description_section) - - # Add an example of how to instantiate the resource - example_section = section.add_new_section('example') - self._add_example(example_section, identifier_names) - - # Add the description for the parameters to instantiate the - # resource. - param_section = section.add_new_section('params') - self._add_params_description(param_section, identifier_names) - - def _add_description(self, section): - official_service_name = get_official_service_name( - self._service_model) - section.write( - 'A resource representing an %s %s' % ( - official_service_name, self._resource_name)) - - def _add_example(self, section, identifier_names): - section.style.start_codeblock() - section.style.new_line() - section.write('import boto3') - section.style.new_line() - section.style.new_line() - section.write( - '%s = boto3.resource(\'%s\')' % ( - self._service_name, self._service_name) - ) - section.style.new_line() - example_values = get_identifier_values_for_example(identifier_names) - section.write( - '%s = %s.%s(%s)' % ( - xform_name(self._resource_name), self._service_name, - self._resource_name, example_values)) - section.style.end_codeblock() - - def _add_params_description(self, section, identifier_names): - for identifier_name in identifier_names: - description = get_identifier_description( - self._resource_name, identifier_name) - section.write(':type %s: string' % identifier_name) - section.style.new_line() - section.write(':param %s: %s' % ( - identifier_name, description)) - section.style.new_line() - - def _add_overview_of_members(self, section): - for resource_member_type in self.member_map: - section.style.new_line() - section.write('These are the resource\'s available %s:' % ( - resource_member_type)) - section.style.new_line() - for member in self.member_map[resource_member_type]: - if resource_member_type in ['identifiers', 'attributes', - 'references', 'collections']: - section.style.li(':py:attr:`%s`' % member) - else: - section.style.li(':py:meth:`%s()`' % member) - - def _add_identifiers(self, section): - identifiers = self._resource.meta.resource_model.identifiers - section = section.add_new_section('identifiers') - member_list = [] - if identifiers: - self.member_map['identifiers'] = member_list - add_resource_type_overview( - section=section, - resource_type='Identifiers', - description=( - 'Identifiers are properties of a resource that are ' - 'set upon instantation of the resource.'), - intro_link='identifiers_attributes_intro') - for identifier in identifiers: - identifier_section = section.add_new_section(identifier.name) - member_list.append(identifier.name) - document_identifier( - section=identifier_section, - resource_name=self._resource_name, - identifier_model=identifier - ) - - def _add_attributes(self, section): - service_model = self._resource.meta.client.meta.service_model - attributes = {} - if self._resource.meta.resource_model.shape: - shape = service_model.shape_for( - self._resource.meta.resource_model.shape) - attributes = self._resource.meta.resource_model.get_attributes( - shape) - section = section.add_new_section('attributes') - attribute_list = [] - if attributes: - add_resource_type_overview( - section=section, - resource_type='Attributes', - description=( - 'Attributes provide access' - ' to the properties of a resource. Attributes are lazy-' - 'loaded the first time one is accessed via the' - ' :py:meth:`load` method.'), - intro_link='identifiers_attributes_intro') - self.member_map['attributes'] = attribute_list - for attr_name in sorted(attributes): - _, attr_shape = attributes[attr_name] - attribute_section = section.add_new_section(attr_name) - attribute_list.append(attr_name) - document_attribute( - section=attribute_section, - service_name=self._service_name, - resource_name=self._resource_name, - attr_name=attr_name, - event_emitter=self._resource.meta.client.meta.events, - attr_model=attr_shape - ) - - def _add_references(self, section): - section = section.add_new_section('references') - references = self._resource.meta.resource_model.references - reference_list = [] - if references: - add_resource_type_overview( - section=section, - resource_type='References', - description=( - 'References are related resource instances that have ' - 'a belongs-to relationship.'), - intro_link='references_intro') - self.member_map['references'] = reference_list - for reference in references: - reference_section = section.add_new_section(reference.name) - reference_list.append(reference.name) - document_reference( - section=reference_section, - reference_model=reference - ) - - def _add_actions(self, section): - section = section.add_new_section('actions') - actions = self._resource.meta.resource_model.actions - if actions: - documenter = ActionDocumenter(self._resource) - documenter.member_map = self.member_map - documenter.document_actions(section) - - def _add_sub_resources(self, section): - section = section.add_new_section('sub-resources') - sub_resources = self._resource.meta.resource_model.subresources - if sub_resources: - documenter = SubResourceDocumenter(self._resource) - documenter.member_map = self.member_map - documenter.document_sub_resources(section) - - def _add_collections(self, section): - section = section.add_new_section('collections') - collections = self._resource.meta.resource_model.collections - if collections: - documenter = CollectionDocumenter(self._resource) - documenter.member_map = self.member_map - documenter.document_collections(section) - - def _add_waiters(self, section): - section = section.add_new_section('waiters') - waiters = self._resource.meta.resource_model.waiters - if waiters: - service_waiter_model = self._botocore_session.get_waiter_model( - self._service_name) - documenter = WaiterResourceDocumenter( - self._resource, service_waiter_model) - documenter.member_map = self.member_map - documenter.document_resource_waiters(section) - - -class ServiceResourceDocumenter(ResourceDocumenter): - @property - def class_name(self): - return '%s.ServiceResource' % self._service_docs_name - - def _add_title(self, section): - section.style.h2('Service Resource') - - def _add_description(self, section): - official_service_name = get_official_service_name( - self._service_model) - section.write( - 'A resource representing %s' % official_service_name) - - def _add_example(self, section, identifier_names): - section.style.start_codeblock() - section.style.new_line() - section.write('import boto3') - section.style.new_line() - section.style.new_line() - section.write( - '%s = boto3.resource(\'%s\')' % ( - self._service_name, self._service_name)) - section.style.end_codeblock() diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/service.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/service.py deleted file mode 100644 index 9c0fbbe0..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/service.py +++ /dev/null @@ -1,129 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import os - -import boto3 -from botocore.exceptions import DataNotFoundError -from botocore.docs.service import ServiceDocumenter as BaseServiceDocumenter -from botocore.docs.bcdoc.restdoc import DocumentStructure - -from boto3.utils import ServiceContext -from boto3.docs.client import Boto3ClientDocumenter -from boto3.docs.resource import ResourceDocumenter -from boto3.docs.resource import ServiceResourceDocumenter - - -class ServiceDocumenter(BaseServiceDocumenter): - # The path used to find examples - EXAMPLE_PATH = os.path.join(os.path.dirname(boto3.__file__), 'examples') - - def __init__(self, service_name, session): - self._service_name = service_name - self._boto3_session = session - # I know that this is an internal attribute, but the botocore session - # is needed to load the paginator and waiter models. - self._session = session._session - self._client = self._boto3_session.client(service_name) - self._service_resource = None - if self._service_name in self._boto3_session.get_available_resources(): - self._service_resource = self._boto3_session.resource(service_name) - self.sections = [ - 'title', - 'table-of-contents', - 'client', - 'paginators', - 'waiters', - 'service-resource', - 'resources', - 'examples' - ] - - def document_service(self): - """Documents an entire service. - - :returns: The reStructured text of the documented service. - """ - doc_structure = DocumentStructure( - self._service_name, section_names=self.sections, - target='html') - self.title(doc_structure.get_section('title')) - self.table_of_contents(doc_structure.get_section('table-of-contents')) - - self.client_api(doc_structure.get_section('client')) - self.paginator_api(doc_structure.get_section('paginators')) - self.waiter_api(doc_structure.get_section('waiters')) - if self._service_resource: - self._document_service_resource( - doc_structure.get_section('service-resource')) - self._document_resources(doc_structure.get_section('resources')) - self._document_examples(doc_structure.get_section('examples')) - return doc_structure.flush_structure() - - def client_api(self, section): - examples = None - try: - examples = self.get_examples(self._service_name) - except DataNotFoundError: - pass - - Boto3ClientDocumenter(self._client, examples).document_client(section) - - def _document_service_resource(self, section): - ServiceResourceDocumenter( - self._service_resource, self._session).document_resource( - section) - - def _document_resources(self, section): - temp_identifier_value = 'foo' - loader = self._session.get_component('data_loader') - json_resource_model = loader.load_service_model( - self._service_name, 'resources-1') - service_model = self._service_resource.meta.client.meta.service_model - for resource_name in json_resource_model['resources']: - resource_model = json_resource_model['resources'][resource_name] - resource_cls = self._boto3_session.resource_factory.\ - load_from_definition( - resource_name=resource_name, - single_resource_json_definition=resource_model, - service_context=ServiceContext( - service_name=self._service_name, - resource_json_definitions=json_resource_model[ - 'resources'], - service_model=service_model, - service_waiter_model=None - ) - ) - identifiers = resource_cls.meta.resource_model.identifiers - args = [] - for _ in identifiers: - args.append(temp_identifier_value) - resource = resource_cls(*args, client=self._client) - ResourceDocumenter( - resource, self._session).document_resource( - section.add_new_section(resource.meta.resource_model.name)) - - def _get_example_file(self): - return os.path.realpath( - os.path.join(self.EXAMPLE_PATH, - self._service_name + '.rst')) - - def _document_examples(self, section): - examples_file = self._get_example_file() - if os.path.isfile(examples_file): - section.style.h2('Examples') - section.style.new_line() - section.write(".. contents::\n :local:\n :depth: 1") - section.style.new_line() - section.style.new_line() - with open(examples_file, 'r') as f: - section.write(f.read()) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/subresource.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/subresource.py deleted file mode 100644 index 72416067..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/subresource.py +++ /dev/null @@ -1,112 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.utils import get_service_module_name - -from boto3.docs.base import BaseDocumenter -from boto3.docs.utils import get_identifier_args_for_signature -from boto3.docs.utils import get_identifier_values_for_example -from boto3.docs.utils import get_identifier_description -from boto3.docs.utils import add_resource_type_overview - - -class SubResourceDocumenter(BaseDocumenter): - def document_sub_resources(self, section): - add_resource_type_overview( - section=section, - resource_type='Sub-resources', - description=( - 'Sub-resources are methods that create a new instance of a' - ' child resource. This resource\'s identifiers get passed' - ' along to the child.'), - intro_link='subresources_intro') - sub_resources = sorted( - self._resource.meta.resource_model.subresources, - key=lambda sub_resource: sub_resource.name - ) - sub_resources_list = [] - self.member_map['sub-resources'] = sub_resources_list - for sub_resource in sub_resources: - sub_resource_section = section.add_new_section(sub_resource.name) - sub_resources_list.append(sub_resource.name) - document_sub_resource( - section=sub_resource_section, - resource_name=self._resource_name, - sub_resource_model=sub_resource, - service_model=self._service_model - ) - - -def document_sub_resource(section, resource_name, sub_resource_model, - service_model, include_signature=True): - """Documents a resource action - - :param section: The section to write to - - :param resource_name: The name of the resource - - :param sub_resource_model: The model of the subresource - - :param service_model: The model of the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - identifiers_needed = [] - for identifier in sub_resource_model.resource.identifiers: - if identifier.source == 'input': - identifiers_needed.append(xform_name(identifier.target)) - - if include_signature: - signature_args = get_identifier_args_for_signature(identifiers_needed) - section.style.start_sphinx_py_method( - sub_resource_model.name, signature_args) - - method_intro_section = section.add_new_section( - 'method-intro') - description = 'Creates a %s resource.' % sub_resource_model.resource.type - method_intro_section.include_doc_string(description) - example_section = section.add_new_section('example') - example_values = get_identifier_values_for_example(identifiers_needed) - example_resource_name = xform_name(resource_name) - if service_model.service_name == resource_name: - example_resource_name = resource_name - example = '%s = %s.%s(%s)' % ( - xform_name(sub_resource_model.resource.type), - example_resource_name, - sub_resource_model.name, example_values - ) - example_section.style.start_codeblock() - example_section.write(example) - example_section.style.end_codeblock() - - param_section = section.add_new_section('params') - for identifier in identifiers_needed: - description = get_identifier_description( - sub_resource_model.name, identifier) - param_section.write(':type %s: string' % identifier) - param_section.style.new_line() - param_section.write(':param %s: %s' % ( - identifier, description)) - param_section.style.new_line() - - return_section = section.add_new_section('return') - return_section.style.new_line() - return_section.write( - ':rtype: :py:class:`%s.%s`' % ( - get_service_module_name(service_model), - sub_resource_model.resource.type)) - return_section.style.new_line() - return_section.write( - ':returns: A %s resource' % sub_resource_model.resource.type) - return_section.style.new_line() diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/utils.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/utils.py deleted file mode 100644 index 8c96a121..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/utils.py +++ /dev/null @@ -1,142 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import inspect - -import jmespath - -from botocore.compat import six - - -def get_resource_ignore_params(params): - """Helper method to determine which parameters to ignore for actions - - :returns: A list of the parameter names that does not need to be - included in a resource's method call for documentation purposes. - """ - ignore_params = [] - for param in params: - result = jmespath.compile(param.target) - current = result.parsed - # Use JMESPath to find the left most element in the target expression - # which will be the parameter to ignore in the action call. - while current['children']: - current = current['children'][0] - # Make sure the parameter we are about to ignore is a field. - # If it is not, we should ignore the result to avoid false positives. - if current['type'] == 'field': - ignore_params.append(current['value']) - return ignore_params - - -def is_resource_action(action_handle): - if six.PY3: - return inspect.isfunction(action_handle) - else: - return inspect.ismethod(action_handle) - - -def get_resource_public_actions(resource_class): - resource_class_members = inspect.getmembers(resource_class) - resource_methods = {} - for name, member in resource_class_members: - if not name.startswith('_'): - if not name[0].isupper(): - if not name.startswith('wait_until'): - if is_resource_action(member): - resource_methods[name] = member - return resource_methods - - -def get_identifier_values_for_example(identifier_names): - example_values = ['\'%s\'' % identifier for identifier in identifier_names] - return ','.join(example_values) - - -def get_identifier_args_for_signature(identifier_names): - return ','.join(identifier_names) - - -def get_identifier_description(resource_name, identifier_name): - return "The %s's %s identifier. This **must** be set." % ( - resource_name, identifier_name) - - -def add_resource_type_overview(section, resource_type, description, - intro_link=None): - section.style.new_line() - section.write('.. rst-class:: admonition-title') - section.style.new_line() - section.style.new_line() - section.write(resource_type) - section.style.new_line() - section.style.new_line() - section.write(description) - section.style.new_line() - if intro_link is not None: - section.write('For more information about %s refer to the ' - ':ref:`Resources Introduction Guide<%s>`.' % ( - resource_type.lower(), intro_link)) - section.style.new_line() - - -class DocumentModifiedShape(object): - def __init__(self, shape_name, new_type, new_description, - new_example_value): - self._shape_name = shape_name - self._new_type = new_type - self._new_description = new_description - self._new_example_value = new_example_value - - def replace_documentation_for_matching_shape(self, event_name, section, - **kwargs): - if self._shape_name == section.context.get('shape'): - self._replace_documentation(event_name, section) - for section_name in section.available_sections: - sub_section = section.get_section(section_name) - if self._shape_name == sub_section.context.get('shape'): - self._replace_documentation(event_name, sub_section) - else: - self.replace_documentation_for_matching_shape( - event_name, sub_section) - - def _replace_documentation(self, event_name, section): - if event_name.startswith('docs.request-example') or \ - event_name.startswith('docs.response-example'): - section.remove_all_sections() - section.clear_text() - section.write(self._new_example_value) - - if event_name.startswith('docs.request-params') or \ - event_name.startswith('docs.response-params'): - for section_name in section.available_sections: - # Delete any extra members as a new shape is being - # used. - if section_name not in ['param-name', 'param-documentation', - 'end-structure', 'param-type', - 'end-param']: - section.delete_section(section_name) - - # Update the documentation - description_section = section.get_section('param-documentation') - description_section.clear_text() - description_section.write(self._new_description) - - # Update the param type - type_section = section.get_section('param-type') - if type_section.getvalue().decode('utf-8').startswith(':type'): - type_section.clear_text() - type_section.write(':type %s: %s' % ( - section.name, self._new_type)) - else: - type_section.clear_text() - type_section.style.italics('(%s) -- ' % self._new_type) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/waiter.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/waiter.py deleted file mode 100644 index da7e7764..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/docs/waiter.py +++ /dev/null @@ -1,91 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.utils import get_service_module_name -from botocore.docs.method import document_model_driven_method - -from boto3.docs.base import BaseDocumenter -from boto3.docs.utils import get_resource_ignore_params -from boto3.docs.utils import add_resource_type_overview - - -class WaiterResourceDocumenter(BaseDocumenter): - def __init__(self, resource, service_waiter_model): - super(WaiterResourceDocumenter, self).__init__(resource) - self._service_waiter_model = service_waiter_model - - def document_resource_waiters(self, section): - waiters = self._resource.meta.resource_model.waiters - add_resource_type_overview( - section=section, - resource_type='Waiters', - description=( - 'Waiters provide an interface to wait for a resource' - ' to reach a specific state.'), - intro_link='waiters_intro') - waiter_list = [] - self.member_map['waiters'] = waiter_list - for waiter in waiters: - waiter_section = section.add_new_section(waiter.name) - waiter_list.append(waiter.name) - document_resource_waiter( - section=waiter_section, - resource_name=self._resource_name, - event_emitter=self._resource.meta.client.meta.events, - service_model=self._service_model, - resource_waiter_model=waiter, - service_waiter_model=self._service_waiter_model - ) - - -def document_resource_waiter(section, resource_name, event_emitter, - service_model, resource_waiter_model, - service_waiter_model, include_signature=True): - waiter_model = service_waiter_model.get_waiter( - resource_waiter_model.waiter_name) - operation_model = service_model.operation_model( - waiter_model.operation) - - ignore_params = get_resource_ignore_params(resource_waiter_model.params) - service_module_name = get_service_module_name(service_model) - description = ( - 'Waits until this %s is %s. This method calls ' - ':py:meth:`%s.Waiter.%s.wait` which polls. ' - ':py:meth:`%s.Client.%s` every %s seconds until ' - 'a successful state is reached. An error is returned ' - 'after %s failed checks.' % ( - resource_name, ' '.join(resource_waiter_model.name.split('_')[2:]), - service_module_name, - xform_name(resource_waiter_model.waiter_name), - service_module_name, - xform_name(waiter_model.operation), - waiter_model.delay, waiter_model.max_attempts)) - example_prefix = '%s.%s' % ( - xform_name(resource_name), resource_waiter_model.name) - document_model_driven_method( - section=section, method_name=resource_waiter_model.name, - operation_model=operation_model, - event_emitter=event_emitter, - example_prefix=example_prefix, - method_description=description, - exclude_input=ignore_params, - include_signature=include_signature - ) - if 'return' in section.available_sections: - # Waiters do not return anything so we should remove - # any sections that may document the underlying return - # value of the client method. - return_section = section.get_section('return') - return_section.clear_text() - return_section.remove_all_sections() - return_section.write(':returns: None') diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/__init__.py deleted file mode 100644 index c89416d7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/__init__.py +++ /dev/null @@ -1,12 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/conditions.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/conditions.py deleted file mode 100644 index 8e028b92..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/conditions.py +++ /dev/null @@ -1,415 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from collections import namedtuple -import re - -from boto3.exceptions import DynamoDBOperationNotSupportedError -from boto3.exceptions import DynamoDBNeedsConditionError -from boto3.exceptions import DynamoDBNeedsKeyConditionError - - -ATTR_NAME_REGEX = re.compile(r'[^.\[\]]+(?![^\[]*\])') - - -class ConditionBase(object): - - expression_format = '' - expression_operator = '' - has_grouped_values = False - - def __init__(self, *values): - self._values = values - - def __and__(self, other): - if not isinstance(other, ConditionBase): - raise DynamoDBOperationNotSupportedError('AND', other) - return And(self, other) - - def __or__(self, other): - if not isinstance(other, ConditionBase): - raise DynamoDBOperationNotSupportedError('OR', other) - return Or(self, other) - - def __invert__(self): - return Not(self) - - def get_expression(self): - return {'format': self.expression_format, - 'operator': self.expression_operator, - 'values': self._values} - - def __eq__(self, other): - if isinstance(other, type(self)): - if self._values == other._values: - return True - return False - - def __ne__(self, other): - return not self.__eq__(other) - - -class AttributeBase(object): - def __init__(self, name): - self.name = name - - def __and__(self, value): - raise DynamoDBOperationNotSupportedError('AND', self) - - def __or__(self, value): - raise DynamoDBOperationNotSupportedError('OR', self) - - def __invert__(self): - raise DynamoDBOperationNotSupportedError('NOT', self) - - def eq(self, value): - """Creates a condition where the attribute is equal to the value. - - :param value: The value that the attribute is equal to. - """ - return Equals(self, value) - - def lt(self, value): - """Creates a condition where the attribute is less than the value. - - :param value: The value that the attribute is less than. - """ - return LessThan(self, value) - - def lte(self, value): - """Creates a condition where the attribute is less than or equal to the - value. - - :param value: The value that the attribute is less than or equal to. - """ - return LessThanEquals(self, value) - - def gt(self, value): - """Creates a condition where the attribute is greater than the value. - - :param value: The value that the attribute is greater than. - """ - return GreaterThan(self, value) - - def gte(self, value): - """Creates a condition where the attribute is greater than or equal to - the value. - - :param value: The value that the attribute is greater than or equal to. - """ - return GreaterThanEquals(self, value) - - def begins_with(self, value): - """Creates a condition where the attribute begins with the value. - - :param value: The value that the attribute begins with. - """ - return BeginsWith(self, value) - - def between(self, low_value, high_value): - """Creates a condition where the attribute is greater than or equal - to the low value and less than or equal to the high value. - - :param low_value: The value that the attribute is greater than. - :param high_value: The value that the attribute is less than. - """ - return Between(self, low_value, high_value) - - -class ConditionAttributeBase(ConditionBase, AttributeBase): - """This base class is for conditions that can have attribute methods. - - One example is the Size condition. To complete a condition, you need - to apply another AttributeBase method like eq(). - """ - def __init__(self, *values): - ConditionBase.__init__(self, *values) - # This is assuming the first value to the condition is the attribute - # in which can be used to generate its attribute base. - AttributeBase.__init__(self, values[0].name) - - -class ComparisonCondition(ConditionBase): - expression_format = '{0} {operator} {1}' - - -class Equals(ComparisonCondition): - expression_operator = '=' - - -class NotEquals(ComparisonCondition): - expression_operator = '<>' - - -class LessThan(ComparisonCondition): - expression_operator = '<' - - -class LessThanEquals(ComparisonCondition): - expression_operator = '<=' - - -class GreaterThan(ComparisonCondition): - expression_operator = '>' - - -class GreaterThanEquals(ComparisonCondition): - expression_operator = '>=' - - -class In(ComparisonCondition): - expression_operator = 'IN' - has_grouped_values = True - - -class Between(ConditionBase): - expression_operator = 'BETWEEN' - expression_format = '{0} {operator} {1} AND {2}' - - -class BeginsWith(ConditionBase): - expression_operator = 'begins_with' - expression_format = '{operator}({0}, {1})' - - -class Contains(ConditionBase): - expression_operator = 'contains' - expression_format = '{operator}({0}, {1})' - - -class Size(ConditionAttributeBase): - expression_operator = 'size' - expression_format = '{operator}({0})' - - -class AttributeType(ConditionBase): - expression_operator = 'attribute_type' - expression_format = '{operator}({0}, {1})' - - -class AttributeExists(ConditionBase): - expression_operator = 'attribute_exists' - expression_format = '{operator}({0})' - - -class AttributeNotExists(ConditionBase): - expression_operator = 'attribute_not_exists' - expression_format = '{operator}({0})' - - -class And(ConditionBase): - expression_operator = 'AND' - expression_format = '({0} {operator} {1})' - - -class Or(ConditionBase): - expression_operator = 'OR' - expression_format = '({0} {operator} {1})' - - -class Not(ConditionBase): - expression_operator = 'NOT' - expression_format = '({operator} {0})' - - -class Key(AttributeBase): - pass - - -class Attr(AttributeBase): - """Represents an DynamoDB item's attribute.""" - def ne(self, value): - """Creates a condition where the attribute is not equal to the value - - :param value: The value that the attribute is not equal to. - """ - return NotEquals(self, value) - - def is_in(self, value): - """Creates a condition where the attribute is in the value, - - :type value: list - :param value: The value that the attribute is in. - """ - return In(self, value) - - def exists(self): - """Creates a condition where the attribute exists.""" - return AttributeExists(self) - - def not_exists(self): - """Creates a condition where the attribute does not exist.""" - return AttributeNotExists(self) - - def contains(self, value): - """Creates a condition where the attribute contains the value. - - :param value: The value the attribute contains. - """ - return Contains(self, value) - - def size(self): - """Creates a condition for the attribute size. - - Note another AttributeBase method must be called on the returned - size condition to be a valid DynamoDB condition. - """ - return Size(self) - - def attribute_type(self, value): - """Creates a condition for the attribute type. - - :param value: The type of the attribute. - """ - return AttributeType(self, value) - - -BuiltConditionExpression = namedtuple( - 'BuiltConditionExpression', - ['condition_expression', 'attribute_name_placeholders', - 'attribute_value_placeholders'] -) - - -class ConditionExpressionBuilder(object): - """This class is used to build condition expressions with placeholders""" - def __init__(self): - self._name_count = 0 - self._value_count = 0 - self._name_placeholder = 'n' - self._value_placeholder = 'v' - - def _get_name_placeholder(self): - return '#' + self._name_placeholder + str(self._name_count) - - def _get_value_placeholder(self): - return ':' + self._value_placeholder + str(self._value_count) - - def reset(self): - """Resets the placeholder name and values""" - self._name_count = 0 - self._value_count = 0 - - def build_expression(self, condition, is_key_condition=False): - """Builds the condition expression and the dictionary of placeholders. - - :type condition: ConditionBase - :param condition: A condition to be built into a condition expression - string with any necessary placeholders. - - :type is_key_condition: Boolean - :param is_key_condition: True if the expression is for a - KeyConditionExpression. False otherwise. - - :rtype: (string, dict, dict) - :returns: Will return a string representing the condition with - placeholders inserted where necessary, a dictionary of - placeholders for attribute names, and a dictionary of - placeholders for attribute values. Here is a sample return value: - - ('#n0 = :v0', {'#n0': 'myattribute'}, {':v1': 'myvalue'}) - """ - if not isinstance(condition, ConditionBase): - raise DynamoDBNeedsConditionError(condition) - attribute_name_placeholders = {} - attribute_value_placeholders = {} - condition_expression = self._build_expression( - condition, attribute_name_placeholders, - attribute_value_placeholders, is_key_condition=is_key_condition) - return BuiltConditionExpression( - condition_expression=condition_expression, - attribute_name_placeholders=attribute_name_placeholders, - attribute_value_placeholders=attribute_value_placeholders - ) - - def _build_expression(self, condition, attribute_name_placeholders, - attribute_value_placeholders, is_key_condition): - expression_dict = condition.get_expression() - replaced_values = [] - for value in expression_dict['values']: - # Build the necessary placeholders for that value. - # Placeholders are built for both attribute names and values. - replaced_value = self._build_expression_component( - value, attribute_name_placeholders, - attribute_value_placeholders, condition.has_grouped_values, - is_key_condition) - replaced_values.append(replaced_value) - # Fill out the expression using the operator and the - # values that have been replaced with placeholders. - return expression_dict['format'].format( - *replaced_values, operator=expression_dict['operator']) - - def _build_expression_component(self, value, attribute_name_placeholders, - attribute_value_placeholders, - has_grouped_values, is_key_condition): - # Continue to recurse if the value is a ConditionBase in order - # to extract out all parts of the expression. - if isinstance(value, ConditionBase): - return self._build_expression( - value, attribute_name_placeholders, - attribute_value_placeholders, is_key_condition) - # If it is not a ConditionBase, we can recurse no further. - # So we check if it is an attribute and add placeholders for - # its name - elif isinstance(value, AttributeBase): - if is_key_condition and not isinstance(value, Key): - raise DynamoDBNeedsKeyConditionError( - 'Attribute object %s is of type %s. ' - 'KeyConditionExpression only supports Attribute objects ' - 'of type Key' % (value.name, type(value))) - return self._build_name_placeholder( - value, attribute_name_placeholders) - # If it is anything else, we treat it as a value and thus placeholders - # are needed for the value. - else: - return self._build_value_placeholder( - value, attribute_value_placeholders, has_grouped_values) - - def _build_name_placeholder(self, value, attribute_name_placeholders): - attribute_name = value.name - # Figure out which parts of the attribute name that needs replacement. - attribute_name_parts = ATTR_NAME_REGEX.findall(attribute_name) - - # Add a temporary placeholder for each of these parts. - placeholder_format = ATTR_NAME_REGEX.sub('%s', attribute_name) - str_format_args = [] - for part in attribute_name_parts: - name_placeholder = self._get_name_placeholder() - self._name_count += 1 - str_format_args.append(name_placeholder) - # Add the placeholder and value to dictionary of name placeholders. - attribute_name_placeholders[name_placeholder] = part - # Replace the temporary placeholders with the designated placeholders. - return placeholder_format % tuple(str_format_args) - - def _build_value_placeholder(self, value, attribute_value_placeholders, - has_grouped_values=False): - # If the values are grouped, we need to add a placeholder for - # each element inside of the actual value. - if has_grouped_values: - placeholder_list = [] - for v in value: - value_placeholder = self._get_value_placeholder() - self._value_count += 1 - placeholder_list.append(value_placeholder) - attribute_value_placeholders[value_placeholder] = v - # Assuming the values are grouped by parenthesis. - # IN is the currently the only one that uses this so it maybe - # needed to be changed in future. - return '(' + ', '.join(placeholder_list) + ')' - # Otherwise, treat the value as a single value that needs only - # one placeholder. - else: - value_placeholder = self._get_value_placeholder() - self._value_count += 1 - attribute_value_placeholders[value_placeholder] = value - return value_placeholder diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/table.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/table.py deleted file mode 100644 index 4bd9a98e..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/table.py +++ /dev/null @@ -1,156 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import logging - - -logger = logging.getLogger(__name__) - - -def register_table_methods(base_classes, **kwargs): - base_classes.insert(0, TableResource) - - -# This class can be used to add any additional methods we want -# onto a table resource. Ideally to avoid creating a new -# base class for every method we can just update this -# class instead. Just be sure to move the bulk of the -# actual method implementation to another class. -class TableResource(object): - def __init__(self, *args, **kwargs): - super(TableResource, self).__init__(*args, **kwargs) - - def batch_writer(self, overwrite_by_pkeys=None): - """Create a batch writer object. - - This method creates a context manager for writing - objects to Amazon DynamoDB in batch. - - The batch writer will automatically handle buffering and sending items - in batches. In addition, the batch writer will also automatically - handle any unprocessed items and resend them as needed. All you need - to do is call ``put_item`` for any items you want to add, and - ``delete_item`` for any items you want to delete. - - Example usage:: - - with table.batch_writer() as batch: - for _ in xrange(1000000): - batch.put_item(Item={'HashKey': '...', - 'Otherstuff': '...'}) - # You can also delete_items in a batch. - batch.delete_item(Key={'HashKey': 'SomeHashKey'}) - - :type overwrite_by_pkeys: list(string) - :param overwrite_by_pkeys: De-duplicate request items in buffer - if match new request item on specified primary keys. i.e - ``["partition_key1", "sort_key2", "sort_key3"]`` - - """ - return BatchWriter(self.name, self.meta.client, - overwrite_by_pkeys=overwrite_by_pkeys) - - -class BatchWriter(object): - """Automatically handle batch writes to DynamoDB for a single table.""" - def __init__(self, table_name, client, flush_amount=25, - overwrite_by_pkeys=None): - """ - - :type table_name: str - :param table_name: The name of the table. The class handles - batch writes to a single table. - - :type client: ``botocore.client.Client`` - :param client: A botocore client. Note this client - **must** have the dynamodb customizations applied - to it for transforming AttributeValues into the - wire protocol. What this means in practice is that - you need to use a client that comes from a DynamoDB - resource if you're going to instantiate this class - directly, i.e - ``boto3.resource('dynamodb').Table('foo').meta.client``. - - :type flush_amount: int - :param flush_amount: The number of items to keep in - a local buffer before sending a batch_write_item - request to DynamoDB. - - :type overwrite_by_pkeys: list(string) - :param overwrite_by_pkeys: De-duplicate request items in buffer - if match new request item on specified primary keys. i.e - ``["partition_key1", "sort_key2", "sort_key3"]`` - - """ - self._table_name = table_name - self._client = client - self._items_buffer = [] - self._flush_amount = flush_amount - self._overwrite_by_pkeys = overwrite_by_pkeys - - def put_item(self, Item): - self._add_request_and_process({'PutRequest': {'Item': Item}}) - - def delete_item(self, Key): - self._add_request_and_process({'DeleteRequest': {'Key': Key}}) - - def _add_request_and_process(self, request): - if self._overwrite_by_pkeys: - self._remove_dup_pkeys_request_if_any(request) - self._items_buffer.append(request) - self._flush_if_needed() - - def _remove_dup_pkeys_request_if_any(self, request): - pkey_values_new = self._extract_pkey_values(request) - for item in self._items_buffer: - if self._extract_pkey_values(item) == pkey_values_new: - self._items_buffer.remove(item) - logger.debug("With overwrite_by_pkeys enabled, skipping " - "request:%s", item) - - def _extract_pkey_values(self, request): - if request.get('PutRequest'): - return [request['PutRequest']['Item'][key] - for key in self._overwrite_by_pkeys] - elif request.get('DeleteRequest'): - return [request['DeleteRequest']['Key'][key] - for key in self._overwrite_by_pkeys] - return None - - def _flush_if_needed(self): - if len(self._items_buffer) >= self._flush_amount: - self._flush() - - def _flush(self): - items_to_send = self._items_buffer[:self._flush_amount] - self._items_buffer = self._items_buffer[self._flush_amount:] - response = self._client.batch_write_item( - RequestItems={self._table_name: items_to_send}) - unprocessed_items = response['UnprocessedItems'] - - if unprocessed_items and unprocessed_items[self._table_name]: - # Any unprocessed_items are immediately added to the - # next batch we send. - self._items_buffer.extend(unprocessed_items[self._table_name]) - else: - self._items_buffer = [] - logger.debug("Batch write sent %s, unprocessed: %s", - len(items_to_send), len(self._items_buffer)) - - def __enter__(self): - return self - - def __exit__(self, exc_type, exc_value, tb): - # When we exit, we need to keep flushing whatever's left - # until there's nothing left in our items buffer. - while self._items_buffer: - self._flush() diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/transform.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/transform.py deleted file mode 100644 index 6b8002ca..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/transform.py +++ /dev/null @@ -1,300 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import copy -from collections import Mapping, MutableSequence - -from boto3.dynamodb.types import TypeSerializer, TypeDeserializer -from boto3.dynamodb.conditions import ConditionBase -from boto3.dynamodb.conditions import ConditionExpressionBuilder -from boto3.docs.utils import DocumentModifiedShape - - -def register_high_level_interface(base_classes, **kwargs): - base_classes.insert(0, DynamoDBHighLevelResource) - - -def copy_dynamodb_params(params, **kwargs): - return copy.deepcopy(params) - - -class DynamoDBHighLevelResource(object): - def __init__(self, *args, **kwargs): - super(DynamoDBHighLevelResource, self).__init__(*args, **kwargs) - - # Apply handler that creates a copy of the user provided dynamodb - # item such that it can be modified. - self.meta.client.meta.events.register( - 'provide-client-params.dynamodb', - copy_dynamodb_params, - unique_id='dynamodb-create-params-copy' - ) - - self._injector = TransformationInjector() - # Apply the handler that generates condition expressions including - # placeholders. - self.meta.client.meta.events.register( - 'before-parameter-build.dynamodb', - self._injector.inject_condition_expressions, - unique_id='dynamodb-condition-expression') - - # Apply the handler that serializes the request from python - # types to dynamodb types. - self.meta.client.meta.events.register( - 'before-parameter-build.dynamodb', - self._injector.inject_attribute_value_input, - unique_id='dynamodb-attr-value-input') - - # Apply the handler that deserializes the response from dynamodb - # types to python types. - self.meta.client.meta.events.register( - 'after-call.dynamodb', - self._injector.inject_attribute_value_output, - unique_id='dynamodb-attr-value-output') - - # Apply the documentation customizations to account for - # the transformations. - attr_value_shape_docs = DocumentModifiedShape( - 'AttributeValue', - new_type='valid DynamoDB type', - new_description=( - '- The value of the attribute. The valid value types are ' - 'listed in the ' - ':ref:`DynamoDB Reference Guide`.' - ), - new_example_value=( - '\'string\'|123|Binary(b\'bytes\')|True|None|set([\'string\'])' - '|set([123])|set([Binary(b\'bytes\')])|[]|{}') - ) - - key_expression_shape_docs = DocumentModifiedShape( - 'KeyExpression', - new_type=( - 'condition from :py:class:`boto3.dynamodb.conditions.Key` ' - 'method' - ), - new_description=( - 'The condition(s) a key(s) must meet. Valid conditions are ' - 'listed in the ' - ':ref:`DynamoDB Reference Guide`.' - ), - new_example_value='Key(\'mykey\').eq(\'myvalue\')' - ) - - con_expression_shape_docs = DocumentModifiedShape( - 'ConditionExpression', - new_type=( - 'condition from :py:class:`boto3.dynamodb.conditions.Attr` ' - 'method' - ), - new_description=( - 'The condition(s) an attribute(s) must meet. Valid conditions ' - 'are listed in the ' - ':ref:`DynamoDB Reference Guide`.' - ), - new_example_value='Attr(\'myattribute\').eq(\'myvalue\')' - ) - - self.meta.client.meta.events.register( - 'docs.*.dynamodb.*.complete-section', - attr_value_shape_docs.replace_documentation_for_matching_shape, - unique_id='dynamodb-attr-value-docs') - - self.meta.client.meta.events.register( - 'docs.*.dynamodb.*.complete-section', - key_expression_shape_docs.replace_documentation_for_matching_shape, - unique_id='dynamodb-key-expression-docs') - - self.meta.client.meta.events.register( - 'docs.*.dynamodb.*.complete-section', - con_expression_shape_docs.replace_documentation_for_matching_shape, - unique_id='dynamodb-cond-expression-docs') - - -class TransformationInjector(object): - """Injects the transformations into the user provided parameters.""" - def __init__(self, transformer=None, condition_builder=None, - serializer=None, deserializer=None): - self._transformer = transformer - if transformer is None: - self._transformer = ParameterTransformer() - - self._condition_builder = condition_builder - if condition_builder is None: - self._condition_builder = ConditionExpressionBuilder() - - self._serializer = serializer - if serializer is None: - self._serializer = TypeSerializer() - - self._deserializer = deserializer - if deserializer is None: - self._deserializer = TypeDeserializer() - - def inject_condition_expressions(self, params, model, **kwargs): - """Injects the condition expression transformation into the parameters - - This injection includes transformations for ConditionExpression shapes - and KeyExpression shapes. It also handles any placeholder names and - values that are generated when transforming the condition expressions. - """ - self._condition_builder.reset() - generated_names = {} - generated_values = {} - - # Create and apply the Condition Expression transformation. - transformation = ConditionExpressionTransformation( - self._condition_builder, - placeholder_names=generated_names, - placeholder_values=generated_values, - is_key_condition=False - ) - self._transformer.transform( - params, model.input_shape, transformation, - 'ConditionExpression') - - # Create and apply the Key Condition Expression transformation. - transformation = ConditionExpressionTransformation( - self._condition_builder, - placeholder_names=generated_names, - placeholder_values=generated_values, - is_key_condition=True - ) - self._transformer.transform( - params, model.input_shape, transformation, - 'KeyExpression') - - expr_attr_names_input = 'ExpressionAttributeNames' - expr_attr_values_input = 'ExpressionAttributeValues' - - # Now that all of the condition expression transformation are done, - # update the placeholder dictionaries in the request. - if expr_attr_names_input in params: - params[expr_attr_names_input].update(generated_names) - else: - if generated_names: - params[expr_attr_names_input] = generated_names - - if expr_attr_values_input in params: - params[expr_attr_values_input].update(generated_values) - else: - if generated_values: - params[expr_attr_values_input] = generated_values - - def inject_attribute_value_input(self, params, model, **kwargs): - """Injects DynamoDB serialization into parameter input""" - self._transformer.transform( - params, model.input_shape, self._serializer.serialize, - 'AttributeValue') - - def inject_attribute_value_output(self, parsed, model, **kwargs): - """Injects DynamoDB deserialization into responses""" - if model.output_shape is not None: - self._transformer.transform( - parsed, model.output_shape, self._deserializer.deserialize, - 'AttributeValue' - ) - - -class ConditionExpressionTransformation(object): - """Provides a transformation for condition expressions - - The ``ParameterTransformer`` class can call this class directly - to transform the condition expressions in the parameters provided. - """ - def __init__(self, condition_builder, placeholder_names, - placeholder_values, is_key_condition=False): - self._condition_builder = condition_builder - self._placeholder_names = placeholder_names - self._placeholder_values = placeholder_values - self._is_key_condition = is_key_condition - - def __call__(self, value): - if isinstance(value, ConditionBase): - # Create a conditional expression string with placeholders - # for the provided condition. - built_expression = self._condition_builder.build_expression( - value, is_key_condition=self._is_key_condition) - - self._placeholder_names.update( - built_expression.attribute_name_placeholders) - self._placeholder_values.update( - built_expression.attribute_value_placeholders) - - return built_expression.condition_expression - # Use the user provided value if it is not a ConditonBase object. - return value - - -class ParameterTransformer(object): - """Transforms the input to and output from botocore based on shape""" - - def transform(self, params, model, transformation, target_shape): - """Transforms the dynamodb input to or output from botocore - - It applies a specified transformation whenever a specific shape name - is encountered while traversing the parameters in the dictionary. - - :param params: The parameters structure to transform. - :param model: The operation model. - :param transformation: The function to apply the parameter - :param target_shape: The name of the shape to apply the - transformation to - """ - self._transform_parameters( - model, params, transformation, target_shape) - - def _transform_parameters(self, model, params, transformation, - target_shape): - type_name = model.type_name - if type_name in ['structure', 'map', 'list']: - getattr(self, '_transform_%s' % type_name)( - model, params, transformation, target_shape) - - def _transform_structure(self, model, params, transformation, - target_shape): - if not isinstance(params, Mapping): - return - for param in params: - if param in model.members: - member_model = model.members[param] - member_shape = member_model.name - if member_shape == target_shape: - params[param] = transformation(params[param]) - else: - self._transform_parameters( - member_model, params[param], transformation, - target_shape) - - def _transform_map(self, model, params, transformation, target_shape): - if not isinstance(params, Mapping): - return - value_model = model.value - value_shape = value_model.name - for key, value in params.items(): - if value_shape == target_shape: - params[key] = transformation(value) - else: - self._transform_parameters( - value_model, params[key], transformation, target_shape) - - def _transform_list(self, model, params, transformation, target_shape): - if not isinstance(params, MutableSequence): - return - member_model = model.member - member_shape = member_model.name - for i, item in enumerate(params): - if member_shape == target_shape: - params[i] = transformation(item) - else: - self._transform_parameters( - member_model, params[i], transformation, target_shape) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/types.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/types.py deleted file mode 100644 index 56ee1f8e..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/dynamodb/types.py +++ /dev/null @@ -1,297 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from collections import Mapping, Set -from decimal import Decimal, Context, Clamped -from decimal import Overflow, Inexact, Underflow, Rounded - -from botocore.compat import six - - -STRING = 'S' -NUMBER = 'N' -BINARY = 'B' -STRING_SET = 'SS' -NUMBER_SET = 'NS' -BINARY_SET = 'BS' -NULL = 'NULL' -BOOLEAN = 'BOOL' -MAP = 'M' -LIST = 'L' - - -DYNAMODB_CONTEXT = Context( - Emin=-128, Emax=126, prec=38, - traps=[Clamped, Overflow, Inexact, Rounded, Underflow]) - - -BINARY_TYPES = (bytearray, six.binary_type) - - -class Binary(object): - """A class for representing Binary in dynamodb - - Especially for Python 2, use this class to explicitly specify - binary data for item in DynamoDB. It is essentially a wrapper around - binary. Unicode and Python 3 string types are not allowed. - """ - def __init__(self, value): - if not isinstance(value, BINARY_TYPES): - raise TypeError('Value must be of the following types: %s.' % - ', '.join([str(t) for t in BINARY_TYPES])) - self.value = value - - def __eq__(self, other): - if isinstance(other, Binary): - return self.value == other.value - return self.value == other - - def __ne__(self, other): - return not self.__eq__(other) - - def __repr__(self): - return 'Binary(%r)' % self.value - - def __str__(self): - return self.value - - def __hash__(self): - return hash(self.value) - - -class TypeSerializer(object): - """This class serializes Python data types to DynamoDB types.""" - def serialize(self, value): - """The method to serialize the Python data types. - - :param value: A python value to be serialized to DynamoDB. Here are - the various conversions: - - Python DynamoDB - ------ -------- - None {'NULL': True} - True/False {'BOOL': True/False} - int/Decimal {'N': str(value)} - string {'S': string} - Binary/bytearray/bytes (py3 only) {'B': bytes} - set([int/Decimal]) {'NS': [str(value)]} - set([string]) {'SS': [string]) - set([Binary/bytearray/bytes]) {'BS': [bytes]} - list {'L': list} - dict {'M': dict} - - For types that involve numbers, it is recommended that ``Decimal`` - objects are used to be able to round-trip the Python type. - For types that involve binary, it is recommended that ``Binary`` - objects are used to be able to round-trip the Python type. - - :rtype: dict - :returns: A dictionary that represents a dynamoDB data type. These - dictionaries can be directly passed to botocore methods. - """ - dynamodb_type = self._get_dynamodb_type(value) - serializer = getattr(self, '_serialize_%s' % dynamodb_type.lower()) - return {dynamodb_type: serializer(value)} - - def _get_dynamodb_type(self, value): - dynamodb_type = None - - if self._is_null(value): - dynamodb_type = NULL - - elif self._is_boolean(value): - dynamodb_type = BOOLEAN - - elif self._is_number(value): - dynamodb_type = NUMBER - - elif self._is_string(value): - dynamodb_type = STRING - - elif self._is_binary(value): - dynamodb_type = BINARY - - elif self._is_type_set(value, self._is_number): - dynamodb_type = NUMBER_SET - - elif self._is_type_set(value, self._is_string): - dynamodb_type = STRING_SET - - elif self._is_type_set(value, self._is_binary): - dynamodb_type = BINARY_SET - - elif self._is_map(value): - dynamodb_type = MAP - - elif self._is_list(value): - dynamodb_type = LIST - - else: - msg = 'Unsupported type "%s" for value "%s"' % (type(value), value) - raise TypeError(msg) - - return dynamodb_type - - def _is_null(self, value): - if value is None: - return True - return False - - def _is_boolean(self, value): - if isinstance(value, bool): - return True - return False - - def _is_number(self, value): - if isinstance(value, (six.integer_types, Decimal)): - return True - elif isinstance(value, float): - raise TypeError( - 'Float types are not supported. Use Decimal types instead.') - return False - - def _is_string(self, value): - if isinstance(value, six.string_types): - return True - return False - - def _is_binary(self, value): - if isinstance(value, Binary): - return True - elif isinstance(value, bytearray): - return True - elif six.PY3 and isinstance(value, six.binary_type): - return True - return False - - def _is_set(self, value): - if isinstance(value, Set): - return True - return False - - def _is_type_set(self, value, type_validator): - if self._is_set(value): - if False not in map(type_validator, value): - return True - return False - - def _is_map(self, value): - if isinstance(value, Mapping): - return True - return False - - def _is_list(self, value): - if isinstance(value, list): - return True - return False - - def _serialize_null(self, value): - return True - - def _serialize_bool(self, value): - return value - - def _serialize_n(self, value): - number = str(DYNAMODB_CONTEXT.create_decimal(value)) - if number in ['Infinity', 'NaN']: - raise TypeError('Infinity and NaN not supported') - return number - - def _serialize_s(self, value): - return value - - def _serialize_b(self, value): - if isinstance(value, Binary): - value = value.value - return value - - def _serialize_ss(self, value): - return [self._serialize_s(s) for s in value] - - def _serialize_ns(self, value): - return [self._serialize_n(n) for n in value] - - def _serialize_bs(self, value): - return [self._serialize_b(b) for b in value] - - def _serialize_l(self, value): - return [self.serialize(v) for v in value] - - def _serialize_m(self, value): - return dict([(k, self.serialize(v)) for k, v in value.items()]) - - -class TypeDeserializer(object): - """This class deserializes DynamoDB types to Python types.""" - def deserialize(self, value): - """The method to deserialize the DynamoDB data types. - - :param value: A DynamoDB value to be deserialized to a pythonic value. - Here are the various conversions: - - DynamoDB Python - -------- ------ - {'NULL': True} None - {'BOOL': True/False} True/False - {'N': str(value)} Decimal(str(value)) - {'S': string} string - {'B': bytes} Binary(bytes) - {'NS': [str(value)]} set([Decimal(str(value))]) - {'SS': [string]} set([string]) - {'BS': [bytes]} set([bytes]) - {'L': list} list - {'M': dict} dict - - :returns: The pythonic value of the DynamoDB type. - """ - - if not value: - raise TypeError('Value must be a nonempty dictionary whose key ' - 'is a valid dynamodb type.') - dynamodb_type = list(value.keys())[0] - try: - deserializer = getattr( - self, '_deserialize_%s' % dynamodb_type.lower()) - except AttributeError: - raise TypeError( - 'Dynamodb type %s is not supported' % dynamodb_type) - return deserializer(value[dynamodb_type]) - - def _deserialize_null(self, value): - return None - - def _deserialize_bool(self, value): - return value - - def _deserialize_n(self, value): - return DYNAMODB_CONTEXT.create_decimal(value) - - def _deserialize_s(self, value): - return value - - def _deserialize_b(self, value): - return Binary(value) - - def _deserialize_ns(self, value): - return set(map(self._deserialize_n, value)) - - def _deserialize_ss(self, value): - return set(map(self._deserialize_s, value)) - - def _deserialize_bs(self, value): - return set(map(self._deserialize_b, value)) - - def _deserialize_l(self, value): - return [self.deserialize(v) for v in value] - - def _deserialize_m(self, value): - return dict([(k, self.deserialize(v)) for k, v in value.items()]) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/__init__.py deleted file mode 100644 index c89416d7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/__init__.py +++ /dev/null @@ -1,12 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/createtags.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/createtags.py deleted file mode 100644 index 14e0971b..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/createtags.py +++ /dev/null @@ -1,40 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - - -def inject_create_tags(event_name, class_attributes, **kwargs): - """This injects a custom create_tags method onto the ec2 service resource - - This is needed because the resource model is not able to express - creating multiple tag resources based on the fact you can apply a set - of tags to multiple ec2 resources. - """ - class_attributes['create_tags'] = create_tags - - -def create_tags(self, **kwargs): - # Call the client method - self.meta.client.create_tags(**kwargs) - resources = kwargs.get('Resources', []) - tags = kwargs.get('Tags', []) - tag_resources = [] - - # Generate all of the tag resources that just were created with the - # preceding client call. - for resource in resources: - for tag in tags: - # Add each tag from the tag set for each resource to the list - # that is returned by the method. - tag_resource = self.Tag(resource, tag['Key'], tag['Value']) - tag_resources.append(tag_resource) - return tag_resources diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/deletetags.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/deletetags.py deleted file mode 100644 index 0600b7c5..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/ec2/deletetags.py +++ /dev/null @@ -1,34 +0,0 @@ -# Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from boto3.resources.action import CustomModeledAction - - -def inject_delete_tags(event_emitter, **kwargs): - action_model = { - 'request': { - 'operation': 'DeleteTags', - 'params': [{ - 'target': 'Resources[0]', - 'source': 'identifier', - 'name': 'Id' - }] - } - } - action = CustomModeledAction( - 'delete_tags', action_model, delete_tags, event_emitter) - action.inject(**kwargs) - - -def delete_tags(self, **kwargs): - kwargs['Resources'] = [self.id] - return self.meta.client.delete_tags(**kwargs) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/exceptions.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/exceptions.py deleted file mode 100644 index 65a4a006..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/exceptions.py +++ /dev/null @@ -1,109 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -# All exceptions in this class should subclass from Boto3Error. -import botocore.exceptions - - -# All exceptions should subclass from Boto3Error in this module. -class Boto3Error(Exception): - """Base class for all Boto3 errors.""" - - -class ResourceLoadException(Boto3Error): - pass - - -# NOTE: This doesn't appear to be used anywhere. -# It's probably safe to remove this. -class NoVersionFound(Boto3Error): - pass - - -# We're subclassing from botocore.exceptions.DataNotFoundError -# to keep backwards compatibility with anyone that was catching -# this low level Botocore error before this exception was -# introduced in boto3. -# Same thing for ResourceNotExistsError below. -class UnknownAPIVersionError(Boto3Error, - botocore.exceptions.DataNotFoundError): - def __init__(self, service_name, bad_api_version, - available_api_versions): - msg = ( - "The '%s' resource does not an API version of: %s\n" - "Valid API versions are: %s" - % (service_name, bad_api_version, available_api_versions) - ) - # Not using super because we don't want the DataNotFoundError - # to be called, it has a different __init__ signature. - Boto3Error.__init__(self, msg) - - -class ResourceNotExistsError(Boto3Error, - botocore.exceptions.DataNotFoundError): - """Raised when you attempt to create a resource that does not exist.""" - def __init__(self, service_name, available_services, has_low_level_client): - msg = ( - "The '%s' resource does not exist.\n" - "The available resources are:\n" - " - %s\n" % (service_name, '\n - '.join(available_services)) - ) - if has_low_level_client: - msg += ( - "\nConsider using a boto3.client('%s') instead " - "of a resource for '%s'" % (service_name, service_name)) - # Not using super because we don't want the DataNotFoundError - # to be called, it has a different __init__ signature. - Boto3Error.__init__(self, msg) - - -class RetriesExceededError(Boto3Error): - def __init__(self, last_exception, msg='Max Retries Exceeded'): - super(RetriesExceededError, self).__init__(msg) - self.last_exception = last_exception - - -class S3TransferFailedError(Boto3Error): - pass - - -class S3UploadFailedError(Boto3Error): - pass - - -class DynamoDBOperationNotSupportedError(Boto3Error): - """Raised for operantions that are not supported for an operand""" - def __init__(self, operation, value): - msg = ( - '%s operation cannot be applied to value %s of type %s directly. ' - 'Must use AttributeBase object methods (i.e. Attr().eq()). to ' - 'generate ConditionBase instances first.' % - (operation, value, type(value))) - Exception.__init__(self, msg) - -# FIXME: Backward compatibility -DynanmoDBOperationNotSupportedError = DynamoDBOperationNotSupportedError - - -class DynamoDBNeedsConditionError(Boto3Error): - """Raised when input is not a condition""" - def __init__(self, value): - msg = ( - 'Expecting a ConditionBase object. Got %s of type %s. ' - 'Use AttributeBase object methods (i.e. Attr().eq()). to ' - 'generate ConditionBase instances.' % (value, type(value))) - Exception.__init__(self, msg) - - -class DynamoDBNeedsKeyConditionError(Boto3Error): - pass diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/__init__.py deleted file mode 100644 index e69de29b..00000000 diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/action.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/action.py deleted file mode 100644 index 52dea55d..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/action.py +++ /dev/null @@ -1,244 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import logging - -from botocore import xform_name - -from .params import create_request_parameters -from .response import RawHandler, ResourceHandler -from .model import Action - -from boto3.docs.docstring import ActionDocstring -from boto3.utils import inject_attribute - - -logger = logging.getLogger(__name__) - - -class ServiceAction(object): - """ - A class representing a callable action on a resource, for example - ``sqs.get_queue_by_name(...)`` or ``s3.Bucket('foo').delete()``. - The action may construct parameters from existing resource identifiers - and may return either a raw response or a new resource instance. - - :type action_model: :py:class`~boto3.resources.model.Action` - :param action_model: The action model. - - :type factory: ResourceFactory - :param factory: The factory that created the resource class to which - this action is attached. - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - """ - def __init__(self, action_model, factory=None, service_context=None): - self._action_model = action_model - - # In the simplest case we just return the response, but if a - # resource is defined, then we must create these before returning. - resource_response_model = action_model.resource - if resource_response_model: - self._response_handler = ResourceHandler( - search_path=resource_response_model.path, - factory=factory, resource_model=resource_response_model, - service_context=service_context, - operation_name=action_model.request.operation - ) - else: - self._response_handler = RawHandler(action_model.path) - - def __call__(self, parent, *args, **kwargs): - """ - Perform the action's request operation after building operation - parameters and build any defined resources from the response. - - :type parent: :py:class:`~boto3.resources.base.ServiceResource` - :param parent: The resource instance to which this action is attached. - :rtype: dict or ServiceResource or list(ServiceResource) - :return: The response, either as a raw dict or resource instance(s). - """ - operation_name = xform_name(self._action_model.request.operation) - - # First, build predefined params and then update with the - # user-supplied kwargs, which allows overriding the pre-built - # params if needed. - params = create_request_parameters(parent, self._action_model.request) - params.update(kwargs) - - logger.debug('Calling %s:%s with %r', parent.meta.service_name, - operation_name, params) - - response = getattr(parent.meta.client, operation_name)(**params) - - logger.debug('Response: %r', response) - - return self._response_handler(parent, params, response) - - -class BatchAction(ServiceAction): - """ - An action which operates on a batch of items in a collection, typically - a single page of results from the collection's underlying service - operation call. For example, this allows you to delete up to 999 - S3 objects in a single operation rather than calling ``.delete()`` on - each one individually. - - :type action_model: :py:class`~boto3.resources.model.Action` - :param action_model: The action model. - - :type factory: ResourceFactory - :param factory: The factory that created the resource class to which - this action is attached. - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - """ - def __call__(self, parent, *args, **kwargs): - """ - Perform the batch action's operation on every page of results - from the collection. - - :type parent: - :py:class:`~boto3.resources.collection.ResourceCollection` - :param parent: The collection iterator to which this action - is attached. - :rtype: list(dict) - :return: A list of low-level response dicts from each call. - """ - service_name = None - client = None - responses = [] - operation_name = xform_name(self._action_model.request.operation) - - # Unlike the simple action above, a batch action must operate - # on batches (or pages) of items. So we get each page, construct - # the necessary parameters and call the batch operation. - for page in parent.pages(): - params = {} - for index, resource in enumerate(page): - # There is no public interface to get a service name - # or low-level client from a collection, so we get - # these from the first resource in the collection. - if service_name is None: - service_name = resource.meta.service_name - if client is None: - client = resource.meta.client - - create_request_parameters( - resource, self._action_model.request, - params=params, index=index) - - if not params: - # There are no items, no need to make a call. - break - - params.update(kwargs) - - logger.debug('Calling %s:%s with %r', - service_name, operation_name, params) - - response = getattr(client, operation_name)(**params) - - logger.debug('Response: %r', response) - - responses.append( - self._response_handler(parent, params, response)) - - return responses - - -class WaiterAction(object): - """ - A class representing a callable waiter action on a resource, for example - ``s3.Bucket('foo').wait_until_bucket_exists()``. - The waiter action may construct parameters from existing resource - identifiers. - - :type waiter_model: :py:class`~boto3.resources.model.Waiter` - :param waiter_model: The action waiter. - :type waiter_resource_name: string - :param waiter_resource_name: The name of the waiter action for the - resource. It usually begins with a - ``wait_until_`` - """ - def __init__(self, waiter_model, waiter_resource_name): - self._waiter_model = waiter_model - self._waiter_resource_name = waiter_resource_name - - def __call__(self, parent, *args, **kwargs): - """ - Perform the wait operation after building operation - parameters. - - :type parent: :py:class:`~boto3.resources.base.ServiceResource` - :param parent: The resource instance to which this action is attached. - """ - client_waiter_name = xform_name(self._waiter_model.waiter_name) - - # First, build predefined params and then update with the - # user-supplied kwargs, which allows overriding the pre-built - # params if needed. - params = create_request_parameters(parent, self._waiter_model) - params.update(kwargs) - - logger.debug('Calling %s:%s with %r', - parent.meta.service_name, - self._waiter_resource_name, params) - - client = parent.meta.client - waiter = client.get_waiter(client_waiter_name) - response = waiter.wait(**params) - - logger.debug('Response: %r', response) - - -class CustomModeledAction(object): - """A custom, modeled action to inject into a resource.""" - def __init__(self, action_name, action_model, - function, event_emitter): - """ - :type action_name: str - :param action_name: The name of the action to inject, e.g. - 'delete_tags' - - :type action_model: dict - :param action_model: A JSON definition of the action, as if it were - part of the resource model. - - :type function: function - :param function: The function to perform when the action is called. - The first argument should be 'self', which will be the resource - the function is to be called on. - - :type event_emitter: :py:class:`botocore.hooks.BaseEventHooks` - :param event_emitter: The session event emitter. - """ - self.name = action_name - self.model = action_model - self.function = function - self.emitter = event_emitter - - def inject(self, class_attributes, service_context, event_name, **kwargs): - resource_name = event_name.rsplit(".")[-1] - action = Action(self.name, self.model, {}) - self.function.__name__ = self.name - self.function.__doc__ = ActionDocstring( - resource_name=resource_name, - event_emitter=self.emitter, - action_model=action, - service_model=service_context.service_model, - include_signature=False - ) - inject_attribute(class_attributes, self.name, self.function) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/base.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/base.py deleted file mode 100644 index 4e60c5a7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/base.py +++ /dev/null @@ -1,148 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import logging - -import boto3 - - -logger = logging.getLogger(__name__) - - -class ResourceMeta(object): - """ - An object containing metadata about a resource. - """ - def __init__(self, service_name, identifiers=None, client=None, - data=None, resource_model=None): - #: (``string``) The service name, e.g. 's3' - self.service_name = service_name - - if identifiers is None: - identifiers = [] - #: (``list``) List of identifier names - self.identifiers = identifiers - - #: (:py:class:`~botocore.client.BaseClient`) Low-level Botocore client - self.client = client - #: (``dict``) Loaded resource data attributes - self.data = data - - # The resource model for that resource - self.resource_model = resource_model - - def __repr__(self): - return 'ResourceMeta(\'{0}\', identifiers={1})'.format( - self.service_name, self.identifiers) - - def __eq__(self, other): - # Two metas are equal if their components are all equal - if other.__class__.__name__ != self.__class__.__name__: - return False - - return self.__dict__ == other.__dict__ - - def copy(self): - """ - Create a copy of this metadata object. - """ - params = self.__dict__.copy() - service_name = params.pop('service_name') - return ResourceMeta(service_name, **params) - - -class ServiceResource(object): - """ - A base class for resources. - - :type client: botocore.client - :param client: A low-level Botocore client instance - """ - - meta = None - """ - Stores metadata about this resource instance, such as the - ``service_name``, the low-level ``client`` and any cached ``data`` - from when the instance was hydrated. For example:: - - # Get a low-level client from a resource instance - client = resource.meta.client - response = client.operation(Param='foo') - - # Print the resource instance's service short name - print(resource.meta.service_name) - - See :py:class:`ResourceMeta` for more information. - """ - - def __init__(self, *args, **kwargs): - # Always work on a copy of meta, otherwise we would affect other - # instances of the same subclass. - self.meta = self.meta.copy() - - # Create a default client if none was passed - if kwargs.get('client') is not None: - self.meta.client = kwargs.get('client') - else: - self.meta.client = boto3.client(self.meta.service_name) - - # Allow setting identifiers as positional arguments in the order - # in which they were defined in the ResourceJSON. - for i, value in enumerate(args): - setattr(self, '_' + self.meta.identifiers[i], value) - - # Allow setting identifiers via keyword arguments. Here we need - # extra logic to ignore other keyword arguments like ``client``. - for name, value in kwargs.items(): - if name == 'client': - continue - - if name not in self.meta.identifiers: - raise ValueError('Unknown keyword argument: {0}'.format(name)) - - setattr(self, '_' + name, value) - - # Validate that all identifiers have been set. - for identifier in self.meta.identifiers: - if getattr(self, identifier) is None: - raise ValueError( - 'Required parameter {0} not set'.format(identifier)) - - def __repr__(self): - identifiers = [] - for identifier in self.meta.identifiers: - identifiers.append('{0}={1}'.format( - identifier, repr(getattr(self, identifier)))) - return "{0}({1})".format( - self.__class__.__name__, - ', '.join(identifiers), - ) - - def __eq__(self, other): - # Should be instances of the same resource class - if other.__class__.__name__ != self.__class__.__name__: - return False - - # Each of the identifiers should have the same value in both - # instances, e.g. two buckets need the same name to be equal. - for identifier in self.meta.identifiers: - if getattr(self, identifier) != getattr(other, identifier): - return False - - return True - - def __hash__(self): - identifiers = [] - for identifier in self.meta.identifiers: - identifiers.append(getattr(self, identifier)) - return hash((self.__class__.__name__, tuple(identifiers))) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/collection.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/collection.py deleted file mode 100644 index 083f9cdd..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/collection.py +++ /dev/null @@ -1,526 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import copy -import logging - -from botocore import xform_name -from botocore.utils import merge_dicts - -from .action import BatchAction -from .params import create_request_parameters -from .response import ResourceHandler -from ..docs import docstring - - -logger = logging.getLogger(__name__) - - -class ResourceCollection(object): - """ - Represents a collection of resources, which can be iterated through, - optionally with filtering. Collections automatically handle pagination - for you. - - See :ref:`guide_collections` for a high-level overview of collections, - including when remote service requests are performed. - - :type model: :py:class:`~boto3.resources.model.Collection` - :param model: Collection model - :type parent: :py:class:`~boto3.resources.base.ServiceResource` - :param parent: The collection's parent resource - :type handler: :py:class:`~boto3.resources.response.ResourceHandler` - :param handler: The resource response handler used to create resource - instances - """ - def __init__(self, model, parent, handler, **kwargs): - self._model = model - self._parent = parent - self._py_operation_name = xform_name( - model.request.operation) - self._handler = handler - self._params = copy.deepcopy(kwargs) - - def __repr__(self): - return '{0}({1}, {2})'.format( - self.__class__.__name__, - self._parent, - '{0}.{1}'.format( - self._parent.meta.service_name, - self._model.resource.type - ) - ) - - def __iter__(self): - """ - A generator which yields resource instances after doing the - appropriate service operation calls and handling any pagination - on your behalf. - - Page size, item limit, and filter parameters are applied - if they have previously been set. - - >>> bucket = s3.Bucket('boto3') - >>> for obj in bucket.objects.all(): - ... print(obj.key) - 'key1' - 'key2' - - """ - limit = self._params.get('limit', None) - - count = 0 - for page in self.pages(): - for item in page: - yield item - - # If the limit is set and has been reached, then - # we stop processing items here. - count += 1 - if limit is not None and count >= limit: - return - - def _clone(self, **kwargs): - """ - Create a clone of this collection. This is used by the methods - below to provide a chainable interface that returns copies - rather than the original. This allows things like: - - >>> base = collection.filter(Param1=1) - >>> query1 = base.filter(Param2=2) - >>> query2 = base.filter(Param3=3) - >>> query1.params - {'Param1': 1, 'Param2': 2} - >>> query2.params - {'Param1': 1, 'Param3': 3} - - :rtype: :py:class:`ResourceCollection` - :return: A clone of this resource collection - """ - params = copy.deepcopy(self._params) - merge_dicts(params, kwargs, append_lists=True) - clone = self.__class__(self._model, self._parent, - self._handler, **params) - return clone - - def pages(self): - """ - A generator which yields pages of resource instances after - doing the appropriate service operation calls and handling - any pagination on your behalf. Non-paginated calls will - return a single page of items. - - Page size, item limit, and filter parameters are applied - if they have previously been set. - - >>> bucket = s3.Bucket('boto3') - >>> for page in bucket.objects.pages(): - ... for obj in page: - ... print(obj.key) - 'key1' - 'key2' - - :rtype: list(:py:class:`~boto3.resources.base.ServiceResource`) - :return: List of resource instances - """ - client = self._parent.meta.client - cleaned_params = self._params.copy() - limit = cleaned_params.pop('limit', None) - page_size = cleaned_params.pop('page_size', None) - params = create_request_parameters( - self._parent, self._model.request) - merge_dicts(params, cleaned_params, append_lists=True) - - # Is this a paginated operation? If so, we need to get an - # iterator for the various pages. If not, then we simply - # call the operation and return the result as a single - # page in a list. For non-paginated results, we just ignore - # the page size parameter. - if client.can_paginate(self._py_operation_name): - logger.debug('Calling paginated %s:%s with %r', - self._parent.meta.service_name, - self._py_operation_name, params) - paginator = client.get_paginator(self._py_operation_name) - pages = paginator.paginate( - PaginationConfig={ - 'MaxItems': limit, 'PageSize': page_size}, **params) - else: - logger.debug('Calling %s:%s with %r', - self._parent.meta.service_name, - self._py_operation_name, params) - pages = [getattr(client, self._py_operation_name)(**params)] - - # Now that we have a page iterator or single page of results - # we start processing and yielding individual items. - count = 0 - for page in pages: - page_items = [] - for item in self._handler(self._parent, params, page): - page_items.append(item) - - # If the limit is set and has been reached, then - # we stop processing items here. - count += 1 - if limit is not None and count >= limit: - break - - yield page_items - - # Stop reading pages if we've reached out limit - if limit is not None and count >= limit: - break - - def all(self): - """ - Get all items from the collection, optionally with a custom - page size and item count limit. - - This method returns an iterable generator which yields - individual resource instances. Example use:: - - # Iterate through items - >>> for queue in sqs.queues.all(): - ... print(queue.url) - 'https://url1' - 'https://url2' - - # Convert to list - >>> queues = list(sqs.queues.all()) - >>> len(queues) - 2 - """ - return self._clone() - - def filter(self, **kwargs): - """ - Get items from the collection, passing keyword arguments along - as parameters to the underlying service operation, which are - typically used to filter the results. - - This method returns an iterable generator which yields - individual resource instances. Example use:: - - # Iterate through items - >>> for queue in sqs.queues.filter(Param='foo'): - ... print(queue.url) - 'https://url1' - 'https://url2' - - # Convert to list - >>> queues = list(sqs.queues.filter(Param='foo')) - >>> len(queues) - 2 - - :rtype: :py:class:`ResourceCollection` - """ - return self._clone(**kwargs) - - def limit(self, count): - """ - Return at most this many resources. - - >>> for bucket in s3.buckets.limit(5): - ... print(bucket.name) - 'bucket1' - 'bucket2' - 'bucket3' - 'bucket4' - 'bucket5' - - :type count: int - :param count: Return no more than this many items - :rtype: :py:class:`ResourceCollection` - """ - return self._clone(limit=count) - - def page_size(self, count): - """ - Fetch at most this many resources per service request. - - >>> for obj in s3.Bucket('boto3').objects.page_size(100): - ... print(obj.key) - - :type count: int - :param count: Fetch this many items per request - :rtype: :py:class:`ResourceCollection` - """ - return self._clone(page_size=count) - - -class CollectionManager(object): - """ - A collection manager provides access to resource collection instances, - which can be iterated and filtered. The manager exposes some - convenience functions that are also found on resource collections, - such as :py:meth:`~ResourceCollection.all` and - :py:meth:`~ResourceCollection.filter`. - - Get all items:: - - >>> for bucket in s3.buckets.all(): - ... print(bucket.name) - - Get only some items via filtering:: - - >>> for queue in sqs.queues.filter(QueueNamePrefix='AWS'): - ... print(queue.url) - - Get whole pages of items: - - >>> for page in s3.Bucket('boto3').objects.pages(): - ... for obj in page: - ... print(obj.key) - - A collection manager is not iterable. You **must** call one of the - methods that return a :py:class:`ResourceCollection` before trying - to iterate, slice, or convert to a list. - - See the :ref:`guide_collections` guide for a high-level overview - of collections, including when remote service requests are performed. - - :type collection_model: :py:class:`~boto3.resources.model.Collection` - :param model: Collection model - - :type parent: :py:class:`~boto3.resources.base.ServiceResource` - :param parent: The collection's parent resource - - :type factory: :py:class:`~boto3.resources.factory.ResourceFactory` - :param factory: The resource factory to create new resources - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - """ - # The class to use when creating an iterator - _collection_cls = ResourceCollection - - def __init__(self, collection_model, parent, factory, service_context): - self._model = collection_model - operation_name = self._model.request.operation - self._parent = parent - - search_path = collection_model.resource.path - self._handler = ResourceHandler( - search_path=search_path, factory=factory, - resource_model=collection_model.resource, - service_context=service_context, - operation_name=operation_name - ) - - def __repr__(self): - return '{0}({1}, {2})'.format( - self.__class__.__name__, - self._parent, - '{0}.{1}'.format( - self._parent.meta.service_name, - self._model.resource.type - ) - ) - - def iterator(self, **kwargs): - """ - Get a resource collection iterator from this manager. - - :rtype: :py:class:`ResourceCollection` - :return: An iterable representing the collection of resources - """ - return self._collection_cls(self._model, self._parent, - self._handler, **kwargs) - - # Set up some methods to proxy ResourceCollection methods - def all(self): - return self.iterator() - all.__doc__ = ResourceCollection.all.__doc__ - - def filter(self, **kwargs): - return self.iterator(**kwargs) - filter.__doc__ = ResourceCollection.filter.__doc__ - - def limit(self, count): - return self.iterator(limit=count) - limit.__doc__ = ResourceCollection.limit.__doc__ - - def page_size(self, count): - return self.iterator(page_size=count) - page_size.__doc__ = ResourceCollection.page_size.__doc__ - - def pages(self): - return self.iterator().pages() - pages.__doc__ = ResourceCollection.pages.__doc__ - - -class CollectionFactory(object): - """ - A factory to create new - :py:class:`CollectionManager` and :py:class:`ResourceCollection` - subclasses from a :py:class:`~boto3.resources.model.Collection` - model. These subclasses include methods to perform batch operations. - """ - def load_from_definition(self, resource_name, collection_model, - service_context, event_emitter): - """ - Loads a collection from a model, creating a new - :py:class:`CollectionManager` subclass - with the correct properties and methods, named based on the service - and resource name, e.g. ec2.InstanceCollectionManager. It also - creates a new :py:class:`ResourceCollection` subclass which is used - by the new manager class. - - :type resource_name: string - :param resource_name: Name of the resource to look up. For services, - this should match the ``service_name``. - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - - :type event_emitter: :py:class:`~botocore.hooks.HierarchialEmitter` - :param event_emitter: An event emitter - - :rtype: Subclass of :py:class:`CollectionManager` - :return: The collection class. - """ - attrs = {} - collection_name = collection_model.name - - # Create the batch actions for a collection - self._load_batch_actions( - attrs, resource_name, collection_model, - service_context.service_model, event_emitter) - # Add the documentation to the collection class's methods - self._load_documented_collection_methods( - attrs=attrs, resource_name=resource_name, - collection_model=collection_model, - service_model=service_context.service_model, - event_emitter=event_emitter, - base_class=ResourceCollection) - - if service_context.service_name == resource_name: - cls_name = '{0}.{1}Collection'.format( - service_context.service_name, collection_name) - else: - cls_name = '{0}.{1}.{2}Collection'.format( - service_context.service_name, resource_name, collection_name) - - collection_cls = type(str(cls_name), (ResourceCollection,), - attrs) - - # Add the documentation to the collection manager's methods - self._load_documented_collection_methods( - attrs=attrs, resource_name=resource_name, - collection_model=collection_model, - service_model=service_context.service_model, - event_emitter=event_emitter, - base_class=CollectionManager) - attrs['_collection_cls'] = collection_cls - cls_name += 'Manager' - - return type(str(cls_name), (CollectionManager,), attrs) - - def _load_batch_actions(self, attrs, resource_name, collection_model, - service_model, event_emitter): - """ - Batch actions on the collection become methods on both - the collection manager and iterators. - """ - for action_model in collection_model.batch_actions: - snake_cased = xform_name(action_model.name) - attrs[snake_cased] = self._create_batch_action( - resource_name, snake_cased, action_model, collection_model, - service_model, event_emitter) - - def _load_documented_collection_methods( - factory_self, attrs, resource_name, collection_model, - service_model, event_emitter, base_class): - # The base class already has these methods defined. However - # the docstrings are generic and not based for a particular service - # or resource. So we override these methods by proxying to the - # base class's builtin method and adding a docstring - # that pertains to the resource. - - # A collection's all() method. - def all(self): - return base_class.all(self) - - all.__doc__ = docstring.CollectionMethodDocstring( - resource_name=resource_name, - action_name='all', - event_emitter=event_emitter, - collection_model=collection_model, - service_model=service_model, - include_signature=False - ) - attrs['all'] = all - - # The collection's filter() method. - def filter(self, **kwargs): - return base_class.filter(self, **kwargs) - - filter.__doc__ = docstring.CollectionMethodDocstring( - resource_name=resource_name, - action_name='filter', - event_emitter=event_emitter, - collection_model=collection_model, - service_model=service_model, - include_signature=False - ) - attrs['filter'] = filter - - # The collection's limit method. - def limit(self, count): - return base_class.limit(self, count) - - limit.__doc__ = docstring.CollectionMethodDocstring( - resource_name=resource_name, - action_name='limit', - event_emitter=event_emitter, - collection_model=collection_model, - service_model=service_model, - include_signature=False - ) - attrs['limit'] = limit - - # The collection's page_size method. - def page_size(self, count): - return base_class.page_size(self, count) - - page_size.__doc__ = docstring.CollectionMethodDocstring( - resource_name=resource_name, - action_name='page_size', - event_emitter=event_emitter, - collection_model=collection_model, - service_model=service_model, - include_signature=False - ) - attrs['page_size'] = page_size - - def _create_batch_action(factory_self, resource_name, snake_cased, - action_model, collection_model, service_model, - event_emitter): - """ - Creates a new method which makes a batch operation request - to the underlying service API. - """ - action = BatchAction(action_model) - - def batch_action(self, *args, **kwargs): - return action(self, *args, **kwargs) - - batch_action.__name__ = str(snake_cased) - batch_action.__doc__ = docstring.BatchActionDocstring( - resource_name=resource_name, - event_emitter=event_emitter, - batch_action_model=action_model, - service_model=service_model, - collection_model=collection_model, - include_signature=False - ) - return batch_action diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/factory.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/factory.py deleted file mode 100644 index ccd55bfe..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/factory.py +++ /dev/null @@ -1,539 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import logging -from functools import partial - -from .action import ServiceAction -from .action import WaiterAction -from .base import ResourceMeta, ServiceResource -from .collection import CollectionFactory -from .model import ResourceModel -from .response import build_identifiers, ResourceHandler -from ..exceptions import ResourceLoadException -from ..docs import docstring - - -logger = logging.getLogger(__name__) - - -class ResourceFactory(object): - """ - A factory to create new :py:class:`~boto3.resources.base.ServiceResource` - classes from a :py:class:`~boto3.resources.model.ResourceModel`. There are - two types of lookups that can be done: one on the service itself (e.g. an - SQS resource) and another on models contained within the service (e.g. an - SQS Queue resource). - """ - def __init__(self, emitter): - self._collection_factory = CollectionFactory() - self._emitter = emitter - - def load_from_definition(self, resource_name, - single_resource_json_definition, service_context): - """ - Loads a resource from a model, creating a new - :py:class:`~boto3.resources.base.ServiceResource` subclass - with the correct properties and methods, named based on the service - and resource name, e.g. EC2.Instance. - - :type resource_name: string - :param resource_name: Name of the resource to look up. For services, - this should match the ``service_name``. - - :type single_resource_json_definition: dict - :param single_resource_json_definition: - The loaded json of a single service resource or resource - definition. - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - - :rtype: Subclass of :py:class:`~boto3.resources.base.ServiceResource` - :return: The service or resource class. - """ - logger.debug('Loading %s:%s', service_context.service_name, - resource_name) - - # Using the loaded JSON create a ResourceModel object. - resource_model = ResourceModel( - resource_name, single_resource_json_definition, - service_context.resource_json_definitions - ) - - # Do some renaming of the shape if there was a naming collision - # that needed to be accounted for. - shape = None - if resource_model.shape: - shape = service_context.service_model.shape_for( - resource_model.shape) - resource_model.load_rename_map(shape) - - # Set some basic info - meta = ResourceMeta( - service_context.service_name, resource_model=resource_model) - attrs = { - 'meta': meta, - } - - # Create and load all of attributes of the resource class based - # on the models. - - # Identifiers - self._load_identifiers( - attrs=attrs, meta=meta, resource_name=resource_name, - resource_model=resource_model - ) - - # Load/Reload actions - self._load_actions( - attrs=attrs, resource_name=resource_name, - resource_model=resource_model, service_context=service_context - ) - - # Attributes that get auto-loaded - self._load_attributes( - attrs=attrs, meta=meta, resource_name=resource_name, - resource_model=resource_model, - service_context=service_context) - - # Collections and their corresponding methods - self._load_collections( - attrs=attrs, resource_model=resource_model, - service_context=service_context) - - # References and Subresources - self._load_has_relations( - attrs=attrs, resource_name=resource_name, - resource_model=resource_model, service_context=service_context - ) - - # Waiter resource actions - self._load_waiters( - attrs=attrs, resource_name=resource_name, - resource_model=resource_model, service_context=service_context - ) - - # Create the name based on the requested service and resource - cls_name = resource_name - if service_context.service_name == resource_name: - cls_name = 'ServiceResource' - cls_name = service_context.service_name + '.' + cls_name - - base_classes = [ServiceResource] - if self._emitter is not None: - self._emitter.emit( - 'creating-resource-class.%s' % cls_name, - class_attributes=attrs, base_classes=base_classes, - service_context=service_context) - return type(str(cls_name), tuple(base_classes), attrs) - - def _load_identifiers(self, attrs, meta, resource_model, resource_name): - """ - Populate required identifiers. These are arguments without which - the resource cannot be used. Identifiers become arguments for - operations on the resource. - """ - for identifier in resource_model.identifiers: - meta.identifiers.append(identifier.name) - attrs[identifier.name] = self._create_identifier( - identifier, resource_name) - - def _load_actions(self, attrs, resource_name, resource_model, - service_context): - """ - Actions on the resource become methods, with the ``load`` method - being a special case which sets internal data for attributes, and - ``reload`` is an alias for ``load``. - """ - if resource_model.load: - attrs['load'] = self._create_action( - action_model=resource_model.load, resource_name=resource_name, - service_context=service_context, is_load=True) - attrs['reload'] = attrs['load'] - - for action in resource_model.actions: - attrs[action.name] = self._create_action( - action_model=action, resource_name=resource_name, - service_context=service_context) - - def _load_attributes(self, attrs, meta, resource_name, resource_model, - service_context): - """ - Load resource attributes based on the resource shape. The shape - name is referenced in the resource JSON, but the shape itself - is defined in the Botocore service JSON, hence the need for - access to the ``service_model``. - """ - if not resource_model.shape: - return - - shape = service_context.service_model.shape_for( - resource_model.shape) - - identifiers = dict( - (i.member_name, i) - for i in resource_model.identifiers if i.member_name) - attributes = resource_model.get_attributes(shape) - for name, (orig_name, member) in attributes.items(): - if name in identifiers: - prop = self._create_identifier_alias( - resource_name=resource_name, - identifier=identifiers[name], - member_model=member, - service_context=service_context - ) - else: - prop = self._create_autoload_property( - resource_name=resource_name, - name=orig_name, snake_cased=name, - member_model=member, - service_context=service_context - ) - attrs[name] = prop - - def _load_collections(self, attrs, resource_model, service_context): - """ - Load resource collections from the model. Each collection becomes - a :py:class:`~boto3.resources.collection.CollectionManager` instance - on the resource instance, which allows you to iterate and filter - through the collection's items. - """ - for collection_model in resource_model.collections: - attrs[collection_model.name] = self._create_collection( - resource_name=resource_model.name, - collection_model=collection_model, - service_context=service_context - ) - - def _load_has_relations(self, attrs, resource_name, resource_model, - service_context): - """ - Load related resources, which are defined via a ``has`` - relationship but conceptually come in two forms: - - 1. A reference, which is a related resource instance and can be - ``None``, such as an EC2 instance's ``vpc``. - 2. A subresource, which is a resource constructor that will always - return a resource instance which shares identifiers/data with - this resource, such as ``s3.Bucket('name').Object('key')``. - """ - for reference in resource_model.references: - # This is a dangling reference, i.e. we have all - # the data we need to create the resource, so - # this instance becomes an attribute on the class. - attrs[reference.name] = self._create_reference( - reference_model=reference, - resource_name=resource_name, - service_context=service_context - ) - - for subresource in resource_model.subresources: - # This is a sub-resource class you can create - # by passing in an identifier, e.g. s3.Bucket(name). - attrs[subresource.name] = self._create_class_partial( - subresource_model=subresource, - resource_name=resource_name, - service_context=service_context - ) - - self._create_available_subresources_command( - attrs, resource_model.subresources) - - def _create_available_subresources_command(self, attrs, subresources): - _subresources = [subresource.name for subresource in subresources] - _subresources = sorted(_subresources) - - def get_available_subresources(factory_self): - """ - Returns a list of all the available sub-resources for this - Resource. - - :returns: A list containing the name of each sub-resource for this - resource - :rtype: list of str - """ - return _subresources - - attrs['get_available_subresources'] = get_available_subresources - - def _load_waiters(self, attrs, resource_name, resource_model, - service_context): - """ - Load resource waiters from the model. Each waiter allows you to - wait until a resource reaches a specific state by polling the state - of the resource. - """ - for waiter in resource_model.waiters: - attrs[waiter.name] = self._create_waiter( - resource_waiter_model=waiter, - resource_name=resource_name, - service_context=service_context - ) - - def _create_identifier(factory_self, identifier, resource_name): - """ - Creates a read-only property for identifier attributes. - """ - def get_identifier(self): - # The default value is set to ``None`` instead of - # raising an AttributeError because when resources are - # instantiated a check is made such that none of the - # identifiers have a value ``None``. If any are ``None``, - # a more informative user error than a generic AttributeError - # is raised. - return getattr(self, '_' + identifier.name, None) - - get_identifier.__name__ = str(identifier.name) - get_identifier.__doc__ = docstring.IdentifierDocstring( - resource_name=resource_name, - identifier_model=identifier, - include_signature=False - ) - - return property(get_identifier) - - def _create_identifier_alias(factory_self, resource_name, identifier, - member_model, service_context): - """ - Creates a read-only property that aliases an identifier. - """ - def get_identifier(self): - return getattr(self, '_' + identifier.name, None) - - get_identifier.__name__ = str(identifier.member_name) - get_identifier.__doc__ = docstring.AttributeDocstring( - service_name=service_context.service_name, - resource_name=resource_name, - attr_name=identifier.member_name, - event_emitter=factory_self._emitter, - attr_model=member_model, - include_signature=False - ) - - return property(get_identifier) - - def _create_autoload_property(factory_self, resource_name, name, - snake_cased, member_model, service_context): - """ - Creates a new property on the resource to lazy-load its value - via the resource's ``load`` method (if it exists). - """ - # The property loader will check to see if this resource has already - # been loaded and return the cached value if possible. If not, then - # it first checks to see if it CAN be loaded (raise if not), then - # calls the load before returning the value. - def property_loader(self): - if self.meta.data is None: - if hasattr(self, 'load'): - self.load() - else: - raise ResourceLoadException( - '{0} has no load method'.format( - self.__class__.__name__)) - - return self.meta.data.get(name) - - property_loader.__name__ = str(snake_cased) - property_loader.__doc__ = docstring.AttributeDocstring( - service_name=service_context.service_name, - resource_name=resource_name, - attr_name=snake_cased, - event_emitter=factory_self._emitter, - attr_model=member_model, - include_signature=False - ) - - return property(property_loader) - - def _create_waiter(factory_self, resource_waiter_model, resource_name, - service_context): - """ - Creates a new wait method for each resource where both a waiter and - resource model is defined. - """ - waiter = WaiterAction(resource_waiter_model, - waiter_resource_name=resource_waiter_model.name) - - def do_waiter(self, *args, **kwargs): - waiter(self, *args, **kwargs) - - do_waiter.__name__ = str(resource_waiter_model.name) - do_waiter.__doc__ = docstring.ResourceWaiterDocstring( - resource_name=resource_name, - event_emitter=factory_self._emitter, - service_model=service_context.service_model, - resource_waiter_model=resource_waiter_model, - service_waiter_model=service_context.service_waiter_model, - include_signature=False - ) - return do_waiter - - def _create_collection(factory_self, resource_name, collection_model, - service_context): - """ - Creates a new property on the resource to lazy-load a collection. - """ - cls = factory_self._collection_factory.load_from_definition( - resource_name=resource_name, collection_model=collection_model, - service_context=service_context, - event_emitter=factory_self._emitter) - - def get_collection(self): - return cls( - collection_model=collection_model, parent=self, - factory=factory_self, service_context=service_context) - - get_collection.__name__ = str(collection_model.name) - get_collection.__doc__ = docstring.CollectionDocstring( - collection_model=collection_model, include_signature=False) - return property(get_collection) - - def _create_reference(factory_self, reference_model, resource_name, - service_context): - """ - Creates a new property on the resource to lazy-load a reference. - """ - # References are essentially an action with no request - # or response, so we can re-use the response handlers to - # build up resources from identifiers and data members. - handler = ResourceHandler( - search_path=reference_model.resource.path, factory=factory_self, - resource_model=reference_model.resource, - service_context=service_context - ) - - # Are there any identifiers that need access to data members? - # This is important when building the resource below since - # it requires the data to be loaded. - needs_data = any(i.source == 'data' for i in - reference_model.resource.identifiers) - - def get_reference(self): - # We need to lazy-evaluate the reference to handle circular - # references between resources. We do this by loading the class - # when first accessed. - # This is using a *response handler* so we need to make sure - # our data is loaded (if possible) and pass that data into - # the handler as if it were a response. This allows references - # to have their data loaded properly. - if needs_data and self.meta.data is None and hasattr(self, 'load'): - self.load() - return handler(self, {}, self.meta.data) - - get_reference.__name__ = str(reference_model.name) - get_reference.__doc__ = docstring.ReferenceDocstring( - reference_model=reference_model, - include_signature=False - ) - return property(get_reference) - - def _create_class_partial(factory_self, subresource_model, resource_name, - service_context): - """ - Creates a new method which acts as a functools.partial, passing - along the instance's low-level `client` to the new resource - class' constructor. - """ - name = subresource_model.resource.type - - def create_resource(self, *args, **kwargs): - # We need a new method here because we want access to the - # instance's client. - positional_args = [] - - # We lazy-load the class to handle circular references. - json_def = service_context.resource_json_definitions.get(name, {}) - resource_cls = factory_self.load_from_definition( - resource_name=name, - single_resource_json_definition=json_def, - service_context=service_context - ) - - # Assumes that identifiers are in order, which lets you do - # e.g. ``sqs.Queue('foo').Message('bar')`` to create a new message - # linked with the ``foo`` queue and which has a ``bar`` receipt - # handle. If we did kwargs here then future positional arguments - # would lead to failure. - identifiers = subresource_model.resource.identifiers - if identifiers is not None: - for identifier, value in build_identifiers(identifiers, self): - positional_args.append(value) - - return partial(resource_cls, *positional_args, - client=self.meta.client)(*args, **kwargs) - - create_resource.__name__ = str(name) - create_resource.__doc__ = docstring.SubResourceDocstring( - resource_name=resource_name, - sub_resource_model=subresource_model, - service_model=service_context.service_model, - include_signature=False - ) - return create_resource - - def _create_action(factory_self, action_model, resource_name, - service_context, is_load=False): - """ - Creates a new method which makes a request to the underlying - AWS service. - """ - # Create the action in in this closure but before the ``do_action`` - # method below is invoked, which allows instances of the resource - # to share the ServiceAction instance. - action = ServiceAction( - action_model, factory=factory_self, - service_context=service_context - ) - - # A resource's ``load`` method is special because it sets - # values on the resource instead of returning the response. - if is_load: - # We need a new method here because we want access to the - # instance via ``self``. - def do_action(self, *args, **kwargs): - response = action(self, *args, **kwargs) - self.meta.data = response - # Create the docstring for the load/reload mehtods. - lazy_docstring = docstring.LoadReloadDocstring( - action_name=action_model.name, - resource_name=resource_name, - event_emitter=factory_self._emitter, - load_model=action_model, - service_model=service_context.service_model, - include_signature=False - ) - else: - # We need a new method here because we want access to the - # instance via ``self``. - def do_action(self, *args, **kwargs): - response = action(self, *args, **kwargs) - - if hasattr(self, 'load'): - # Clear cached data. It will be reloaded the next - # time that an attribute is accessed. - # TODO: Make this configurable in the future? - self.meta.data = None - - return response - lazy_docstring = docstring.ActionDocstring( - resource_name=resource_name, - event_emitter=factory_self._emitter, - action_model=action_model, - service_model=service_context.service_model, - include_signature=False - ) - - do_action.__name__ = str(action_model.name) - do_action.__doc__ = lazy_docstring - return do_action diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/model.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/model.py deleted file mode 100644 index 5b65b0e2..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/model.py +++ /dev/null @@ -1,622 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -""" -The models defined in this file represent the resource JSON description -format and provide a layer of abstraction from the raw JSON. The advantages -of this are: - -* Pythonic interface (e.g. ``action.request.operation``) -* Consumers need not change for minor JSON changes (e.g. renamed field) - -These models are used both by the resource factory to generate resource -classes as well as by the documentation generator. -""" - -import logging - -from botocore import xform_name - - -logger = logging.getLogger(__name__) - - -class Identifier(object): - """ - A resource identifier, given by its name. - - :type name: string - :param name: The name of the identifier - """ - def __init__(self, name, member_name=None): - #: (``string``) The name of the identifier - self.name = name - self.member_name = member_name - - -class Action(object): - """ - A service operation action. - - :type name: string - :param name: The name of the action - :type definition: dict - :param definition: The JSON definition - :type resource_defs: dict - :param resource_defs: All resources defined in the service - """ - def __init__(self, name, definition, resource_defs): - self._definition = definition - - #: (``string``) The name of the action - self.name = name - #: (:py:class:`Request`) This action's request or ``None`` - self.request = None - if 'request' in definition: - self.request = Request(definition.get('request', {})) - #: (:py:class:`ResponseResource`) This action's resource or ``None`` - self.resource = None - if 'resource' in definition: - self.resource = ResponseResource(definition.get('resource', {}), - resource_defs) - #: (``string``) The JMESPath search path or ``None`` - self.path = definition.get('path') - - -class DefinitionWithParams(object): - """ - An item which has parameters exposed via the ``params`` property. - A request has an operation and parameters, while a waiter has - a name, a low-level waiter name and parameters. - - :type definition: dict - :param definition: The JSON definition - """ - def __init__(self, definition): - self._definition = definition - - @property - def params(self): - """ - Get a list of auto-filled parameters for this request. - - :type: list(:py:class:`Parameter`) - """ - params = [] - - for item in self._definition.get('params', []): - params.append(Parameter(**item)) - - return params - - -class Parameter(object): - """ - An auto-filled parameter which has a source and target. For example, - the ``QueueUrl`` may be auto-filled from a resource's ``url`` identifier - when making calls to ``queue.receive_messages``. - - :type target: string - :param target: The destination parameter name, e.g. ``QueueUrl`` - :type source_type: string - :param source_type: Where the source is defined. - :type source: string - :param source: The source name, e.g. ``Url`` - """ - def __init__(self, target, source, name=None, path=None, value=None, - **kwargs): - #: (``string``) The destination parameter name - self.target = target - #: (``string``) Where the source is defined - self.source = source - #: (``string``) The name of the source, if given - self.name = name - #: (``string``) The JMESPath query of the source - self.path = path - #: (``string|int|float|bool``) The source constant value - self.value = value - - # Complain if we encounter any unknown values. - if kwargs: - logger.warning('Unknown parameter options found: %s', kwargs) - - -class Request(DefinitionWithParams): - """ - A service operation action request. - - :type definition: dict - :param definition: The JSON definition - """ - def __init__(self, definition): - super(Request, self).__init__(definition) - - #: (``string``) The name of the low-level service operation - self.operation = definition.get('operation') - - -class Waiter(DefinitionWithParams): - """ - An event waiter specification. - - :type name: string - :param name: Name of the waiter - :type definition: dict - :param definition: The JSON definition - """ - PREFIX = 'WaitUntil' - - def __init__(self, name, definition): - super(Waiter, self).__init__(definition) - - #: (``string``) The name of this waiter - self.name = name - - #: (``string``) The name of the underlying event waiter - self.waiter_name = definition.get('waiterName') - - -class ResponseResource(object): - """ - A resource response to create after performing an action. - - :type definition: dict - :param definition: The JSON definition - :type resource_defs: dict - :param resource_defs: All resources defined in the service - """ - def __init__(self, definition, resource_defs): - self._definition = definition - self._resource_defs = resource_defs - - #: (``string``) The name of the response resource type - self.type = definition.get('type') - - #: (``string``) The JMESPath search query or ``None`` - self.path = definition.get('path') - - @property - def identifiers(self): - """ - A list of resource identifiers. - - :type: list(:py:class:`Identifier`) - """ - identifiers = [] - - for item in self._definition.get('identifiers', []): - identifiers.append( - Parameter(**item)) - - return identifiers - - @property - def model(self): - """ - Get the resource model for the response resource. - - :type: :py:class:`ResourceModel` - """ - return ResourceModel(self.type, self._resource_defs[self.type], - self._resource_defs) - - -class Collection(Action): - """ - A group of resources. See :py:class:`Action`. - - :type name: string - :param name: The name of the collection - :type definition: dict - :param definition: The JSON definition - :type resource_defs: dict - :param resource_defs: All resources defined in the service - """ - @property - def batch_actions(self): - """ - Get a list of batch actions supported by the resource type - contained in this action. This is a shortcut for accessing - the same information through the resource model. - - :rtype: list(:py:class:`Action`) - """ - return self.resource.model.batch_actions - - -class ResourceModel(object): - """ - A model representing a resource, defined via a JSON description - format. A resource has identifiers, attributes, actions, - sub-resources, references and collections. For more information - on resources, see :ref:`guide_resources`. - - :type name: string - :param name: The name of this resource, e.g. ``sqs`` or ``Queue`` - :type definition: dict - :param definition: The JSON definition - :type resource_defs: dict - :param resource_defs: All resources defined in the service - """ - def __init__(self, name, definition, resource_defs): - self._definition = definition - self._resource_defs = resource_defs - self._renamed = {} - - #: (``string``) The name of this resource - self.name = name - #: (``string``) The service shape name for this resource or ``None`` - self.shape = definition.get('shape') - - def load_rename_map(self, shape=None): - """ - Load a name translation map given a shape. This will set - up renamed values for any collisions, e.g. if the shape, - an action, and a subresource all are all named ``foo`` - then the resource will have an action ``foo``, a subresource - named ``Foo`` and a property named ``foo_attribute``. - This is the order of precedence, from most important to - least important: - - * Load action (resource.load) - * Identifiers - * Actions - * Subresources - * References - * Collections - * Waiters - * Attributes (shape members) - - Batch actions are only exposed on collections, so do not - get modified here. Subresources use upper camel casing, so - are unlikely to collide with anything but other subresources. - - Creates a structure like this:: - - renames = { - ('action', 'id'): 'id_action', - ('collection', 'id'): 'id_collection', - ('attribute', 'id'): 'id_attribute' - } - - # Get the final name for an action named 'id' - name = renames.get(('action', 'id'), 'id') - - :type shape: botocore.model.Shape - :param shape: The underlying shape for this resource. - """ - # Meta is a reserved name for resources - names = set(['meta']) - self._renamed = {} - - if self._definition.get('load'): - names.add('load') - - for item in self._definition.get('identifiers', []): - self._load_name_with_category(names, item['name'], 'identifier') - - for name in self._definition.get('actions', {}): - self._load_name_with_category(names, name, 'action') - - for name, ref in self._get_has_definition().items(): - # Subresources require no data members, just typically - # identifiers and user input. - data_required = False - for identifier in ref['resource']['identifiers']: - if identifier['source'] == 'data': - data_required = True - break - - if not data_required: - self._load_name_with_category(names, name, 'subresource', - snake_case=False) - else: - self._load_name_with_category(names, name, 'reference') - - for name in self._definition.get('hasMany', {}): - self._load_name_with_category(names, name, 'collection') - - for name in self._definition.get('waiters', {}): - self._load_name_with_category(names, Waiter.PREFIX + name, - 'waiter') - - if shape is not None: - for name in shape.members.keys(): - self._load_name_with_category(names, name, 'attribute') - - def _load_name_with_category(self, names, name, category, - snake_case=True): - """ - Load a name with a given category, possibly renaming it - if that name is already in use. The name will be stored - in ``names`` and possibly be set up in ``self._renamed``. - - :type names: set - :param names: Existing names (Python attributes, properties, or - methods) on the resource. - :type name: string - :param name: The original name of the value. - :type category: string - :param category: The value type, such as 'identifier' or 'action' - :type snake_case: bool - :param snake_case: True (default) if the name should be snake cased. - """ - if snake_case: - name = xform_name(name) - - if name in names: - logger.debug('Renaming %s %s %s' % (self.name, category, name)) - self._renamed[(category, name)] = name + '_' + category - name += '_' + category - - if name in names: - # This isn't good, let's raise instead of trying to keep - # renaming this value. - raise ValueError('Problem renaming {0} {1} to {2}!'.format( - self.name, category, name)) - - names.add(name) - - def _get_name(self, category, name, snake_case=True): - """ - Get a possibly renamed value given a category and name. This - uses the rename map set up in ``load_rename_map``, so that - method must be called once first. - - :type category: string - :param category: The value type, such as 'identifier' or 'action' - :type name: string - :param name: The original name of the value - :type snake_case: bool - :param snake_case: True (default) if the name should be snake cased. - :rtype: string - :return: Either the renamed value if it is set, otherwise the - original name. - """ - if snake_case: - name = xform_name(name) - - return self._renamed.get((category, name), name) - - def get_attributes(self, shape): - """ - Get a dictionary of attribute names to original name and shape - models that represent the attributes of this resource. Looks - like the following: - - { - 'some_name': ('SomeName', ) - } - - :type shape: botocore.model.Shape - :param shape: The underlying shape for this resource. - :rtype: dict - :return: Mapping of resource attributes. - """ - attributes = {} - identifier_names = [i.name for i in self.identifiers] - - for name, member in shape.members.items(): - snake_cased = xform_name(name) - if snake_cased in identifier_names: - # Skip identifiers, these are set through other means - continue - snake_cased = self._get_name('attribute', snake_cased, - snake_case=False) - attributes[snake_cased] = (name, member) - - return attributes - - @property - def identifiers(self): - """ - Get a list of resource identifiers. - - :type: list(:py:class:`Identifier`) - """ - identifiers = [] - - for item in self._definition.get('identifiers', []): - name = self._get_name('identifier', item['name']) - member_name = item.get('memberName', None) - if member_name: - member_name = self._get_name('attribute', member_name) - identifiers.append(Identifier(name, member_name)) - - return identifiers - - @property - def load(self): - """ - Get the load action for this resource, if it is defined. - - :type: :py:class:`Action` or ``None`` - """ - action = self._definition.get('load') - - if action is not None: - action = Action('load', action, self._resource_defs) - - return action - - @property - def actions(self): - """ - Get a list of actions for this resource. - - :type: list(:py:class:`Action`) - """ - actions = [] - - for name, item in self._definition.get('actions', {}).items(): - name = self._get_name('action', name) - actions.append(Action(name, item, self._resource_defs)) - - return actions - - @property - def batch_actions(self): - """ - Get a list of batch actions for this resource. - - :type: list(:py:class:`Action`) - """ - actions = [] - - for name, item in self._definition.get('batchActions', {}).items(): - name = self._get_name('batch_action', name) - actions.append(Action(name, item, self._resource_defs)) - - return actions - - def _get_has_definition(self): - """ - Get a ``has`` relationship definition from a model, where the - service resource model is treated special in that it contains - a relationship to every resource defined for the service. This - allows things like ``s3.Object('bucket-name', 'key')`` to - work even though the JSON doesn't define it explicitly. - - :rtype: dict - :return: Mapping of names to subresource and reference - definitions. - """ - if self.name not in self._resource_defs: - # This is the service resource, so let us expose all of - # the defined resources as subresources. - definition = {} - - for name, resource_def in self._resource_defs.items(): - # It's possible for the service to have renamed a - # resource or to have defined multiple names that - # point to the same resource type, so we need to - # take that into account. - found = False - has_items = self._definition.get('has', {}).items() - for has_name, has_def in has_items: - if has_def.get('resource', {}).get('type') == name: - definition[has_name] = has_def - found = True - - if not found: - # Create a relationship definition and attach it - # to the model, such that all identifiers must be - # supplied by the user. It will look something like: - # - # { - # 'resource': { - # 'type': 'ResourceName', - # 'identifiers': [ - # {'target': 'Name1', 'source': 'input'}, - # {'target': 'Name2', 'source': 'input'}, - # ... - # ] - # } - # } - # - fake_has = { - 'resource': { - 'type': name, - 'identifiers': [] - } - } - - for identifier in resource_def.get('identifiers', []): - fake_has['resource']['identifiers'].append({ - 'target': identifier['name'], 'source': 'input' - }) - - definition[name] = fake_has - else: - definition = self._definition.get('has', {}) - - return definition - - def _get_related_resources(self, subresources): - """ - Get a list of sub-resources or references. - - :type subresources: bool - :param subresources: ``True`` to get sub-resources, ``False`` to - get references. - :rtype: list(:py:class:`ResponseResource`) - """ - resources = [] - - for name, definition in self._get_has_definition().items(): - if subresources: - name = self._get_name('subresource', name, snake_case=False) - else: - name = self._get_name('reference', name) - action = Action(name, definition, self._resource_defs) - - data_required = False - for identifier in action.resource.identifiers: - if identifier.source == 'data': - data_required = True - break - - if subresources and not data_required: - resources.append(action) - elif not subresources and data_required: - resources.append(action) - - return resources - - @property - def subresources(self): - """ - Get a list of sub-resources. - - :type: list(:py:class:`ResponseResource`) - """ - return self._get_related_resources(True) - - @property - def references(self): - """ - Get a list of reference resources. - - :type: list(:py:class:`ResponseResource`) - """ - return self._get_related_resources(False) - - @property - def collections(self): - """ - Get a list of collections for this resource. - - :type: list(:py:class:`Collection`) - """ - collections = [] - - for name, item in self._definition.get('hasMany', {}).items(): - name = self._get_name('collection', name) - collections.append(Collection(name, item, self._resource_defs)) - - return collections - - @property - def waiters(self): - """ - Get a list of waiters for this resource. - - :type: list(:py:class:`Waiter`) - """ - waiters = [] - - for name, item in self._definition.get('waiters', {}).items(): - name = self._get_name('waiter', Waiter.PREFIX + name) - waiters.append(Waiter(name, item)) - - return waiters diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/params.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/params.py deleted file mode 100644 index 71bbb6b7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/params.py +++ /dev/null @@ -1,168 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import re - -import jmespath -from botocore import xform_name - -from ..exceptions import ResourceLoadException - - -INDEX_RE = re.compile('\[(.*)\]$') - - -def get_data_member(parent, path): - """ - Get a data member from a parent using a JMESPath search query, - loading the parent if required. If the parent cannot be loaded - and no data is present then an exception is raised. - - :type parent: ServiceResource - :param parent: The resource instance to which contains data we - are interested in. - :type path: string - :param path: The JMESPath expression to query - :raises ResourceLoadException: When no data is present and the - resource cannot be loaded. - :returns: The queried data or ``None``. - """ - # Ensure the parent has its data loaded, if possible. - if parent.meta.data is None: - if hasattr(parent, 'load'): - parent.load() - else: - raise ResourceLoadException( - '{0} has no load method!'.format(parent.__class__.__name__)) - - return jmespath.search(path, parent.meta.data) - - -def create_request_parameters(parent, request_model, params=None, index=None): - """ - Handle request parameters that can be filled in from identifiers, - resource data members or constants. - - By passing ``params``, you can invoke this method multiple times and - build up a parameter dict over time, which is particularly useful - for reverse JMESPath expressions that append to lists. - - :type parent: ServiceResource - :param parent: The resource instance to which this action is attached. - :type request_model: :py:class:`~boto3.resources.model.Request` - :param request_model: The action request model. - :type params: dict - :param params: If set, then add to this existing dict. It is both - edited in-place and returned. - :type index: int - :param index: The position of an item within a list - :rtype: dict - :return: Pre-filled parameters to be sent to the request operation. - """ - if params is None: - params = {} - - for param in request_model.params: - source = param.source - target = param.target - - if source == 'identifier': - # Resource identifier, e.g. queue.url - value = getattr(parent, xform_name(param.name)) - elif source == 'data': - # If this is a data member then it may incur a load - # action before returning the value. - value = get_data_member(parent, param.path) - elif source in ['string', 'integer', 'boolean']: - # These are hard-coded values in the definition - value = param.value - elif source == 'input': - # This is provided by the user, so ignore it here - continue - else: - raise NotImplementedError( - 'Unsupported source type: {0}'.format(source)) - - build_param_structure(params, target, value, index) - - return params - - -def build_param_structure(params, target, value, index=None): - """ - This method provides a basic reverse JMESPath implementation that - lets you go from a JMESPath-like string to a possibly deeply nested - object. The ``params`` are mutated in-place, so subsequent calls - can modify the same element by its index. - - >>> build_param_structure(params, 'test[0]', 1) - >>> print(params) - {'test': [1]} - - >>> build_param_structure(params, 'foo.bar[0].baz', 'hello world') - >>> print(params) - {'test': [1], 'foo': {'bar': [{'baz': 'hello, world'}]}} - - """ - pos = params - parts = target.split('.') - - # First, split into parts like 'foo', 'bar[0]', 'baz' and process - # each piece. It can either be a list or a dict, depending on if - # an index like `[0]` is present. We detect this via a regular - # expression, and keep track of where we are in params via the - # pos variable, walking down to the last item. Once there, we - # set the value. - for i, part in enumerate(parts): - # Is it indexing an array? - result = INDEX_RE.search(part) - if result: - if result.group(1): - if result.group(1) == '*': - part = part[:-3] - else: - # We have an explicit index - index = int(result.group(1)) - part = part[:-len(str(index) + '[]')] - else: - # Index will be set after we know the proper part - # name and that it's a list instance. - index = None - part = part[:-2] - - if part not in pos or not isinstance(pos[part], list): - pos[part] = [] - - # This means we should append, e.g. 'foo[]' - if index is None: - index = len(pos[part]) - - while len(pos[part]) <= index: - # Assume it's a dict until we set the final value below - pos[part].append({}) - - # Last item? Set the value, otherwise set the new position - if i == len(parts) - 1: - pos[part][index] = value - else: - # The new pos is the *item* in the array, not the array! - pos = pos[part][index] - else: - if part not in pos: - pos[part] = {} - - # Last item? Set the value, otherwise set the new position - if i == len(parts) - 1: - pos[part] = value - else: - pos = pos[part] diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/response.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/response.py deleted file mode 100644 index 57803614..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/resources/response.py +++ /dev/null @@ -1,300 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import jmespath -from botocore import xform_name - -from .params import get_data_member - - -def all_not_none(iterable): - """ - Return True if all elements of the iterable are not None (or if the - iterable is empty). This is like the built-in ``all``, except checks - against None, so 0 and False are allowable values. - """ - for element in iterable: - if element is None: - return False - return True - - -def build_identifiers(identifiers, parent, params=None, raw_response=None): - """ - Builds a mapping of identifier names to values based on the - identifier source location, type, and target. Identifier - values may be scalars or lists depending on the source type - and location. - - :type identifiers: list - :param identifiers: List of :py:class:`~boto3.resources.model.Parameter` - definitions - :type parent: ServiceResource - :param parent: The resource instance to which this action is attached. - :type params: dict - :param params: Request parameters sent to the service. - :type raw_response: dict - :param raw_response: Low-level operation response. - :rtype: list - :return: An ordered list of ``(name, value)`` identifier tuples. - """ - results = [] - - for identifier in identifiers: - source = identifier.source - target = identifier.target - - if source == 'response': - value = jmespath.search(identifier.path, raw_response) - elif source == 'requestParameter': - value = jmespath.search(identifier.path, params) - elif source == 'identifier': - value = getattr(parent, xform_name(identifier.name)) - elif source == 'data': - # If this is a data member then it may incur a load - # action before returning the value. - value = get_data_member(parent, identifier.path) - elif source == 'input': - # This value is set by the user, so ignore it here - continue - else: - raise NotImplementedError( - 'Unsupported source type: {0}'.format(source)) - - results.append((xform_name(target), value)) - - return results - - -def build_empty_response(search_path, operation_name, service_model): - """ - Creates an appropriate empty response for the type that is expected, - based on the service model's shape type. For example, a value that - is normally a list would then return an empty list. A structure would - return an empty dict, and a number would return None. - - :type search_path: string - :param search_path: JMESPath expression to search in the response - :type operation_name: string - :param operation_name: Name of the underlying service operation. - :type service_model: :ref:`botocore.model.ServiceModel` - :param service_model: The Botocore service model - :rtype: dict, list, or None - :return: An appropriate empty value - """ - response = None - - operation_model = service_model.operation_model(operation_name) - shape = operation_model.output_shape - - if search_path: - # Walk the search path and find the final shape. For example, given - # a path of ``foo.bar[0].baz``, we first find the shape for ``foo``, - # then the shape for ``bar`` (ignoring the indexing), and finally - # the shape for ``baz``. - for item in search_path.split('.'): - item = item.strip('[0123456789]$') - - if shape.type_name == 'structure': - shape = shape.members[item] - elif shape.type_name == 'list': - shape = shape.member - else: - raise NotImplementedError( - 'Search path hits shape type {0} from {1}'.format( - shape.type_name, item)) - - # Anything not handled here is set to None - if shape.type_name == 'structure': - response = {} - elif shape.type_name == 'list': - response = [] - elif shape.type_name == 'map': - response = {} - - return response - - -class RawHandler(object): - """ - A raw action response handler. This passed through the response - dictionary, optionally after performing a JMESPath search if one - has been defined for the action. - - :type search_path: string - :param search_path: JMESPath expression to search in the response - :rtype: dict - :return: Service response - """ - def __init__(self, search_path): - self.search_path = search_path - - def __call__(self, parent, params, response): - """ - :type parent: ServiceResource - :param parent: The resource instance to which this action is attached. - :type params: dict - :param params: Request parameters sent to the service. - :type response: dict - :param response: Low-level operation response. - """ - # TODO: Remove the '$' check after JMESPath supports it - if self.search_path and self.search_path != '$': - response = jmespath.search(self.search_path, response) - - return response - - -class ResourceHandler(object): - """ - Creates a new resource or list of new resources from the low-level - response based on the given response resource definition. - - :type search_path: string - :param search_path: JMESPath expression to search in the response - - :type factory: ResourceFactory - :param factory: The factory that created the resource class to which - this action is attached. - - :type resource_model: :py:class:`~boto3.resources.model.ResponseResource` - :param resource_model: Response resource model. - - :type service_context: :py:class:`~boto3.utils.ServiceContext` - :param service_context: Context about the AWS service - - :type operation_name: string - :param operation_name: Name of the underlying service operation, if it - exists. - - :rtype: ServiceResource or list - :return: New resource instance(s). - """ - def __init__(self, search_path, factory, resource_model, - service_context, operation_name=None): - self.search_path = search_path - self.factory = factory - self.resource_model = resource_model - self.operation_name = operation_name - self.service_context = service_context - - def __call__(self, parent, params, response): - """ - :type parent: ServiceResource - :param parent: The resource instance to which this action is attached. - :type params: dict - :param params: Request parameters sent to the service. - :type response: dict - :param response: Low-level operation response. - """ - resource_name = self.resource_model.type - json_definition = self.service_context.resource_json_definitions.get( - resource_name) - - # Load the new resource class that will result from this action. - resource_cls = self.factory.load_from_definition( - resource_name=resource_name, - single_resource_json_definition=json_definition, - service_context=self.service_context - ) - raw_response = response - search_response = None - - # Anytime a path is defined, it means the response contains the - # resource's attributes, so resource_data gets set here. It - # eventually ends up in resource.meta.data, which is where - # the attribute properties look for data. - if self.search_path: - search_response = jmespath.search(self.search_path, raw_response) - - # First, we parse all the identifiers, then create the individual - # response resources using them. Any identifiers that are lists - # will have one item consumed from the front of the list for each - # resource that is instantiated. Items which are not a list will - # be set as the same value on each new resource instance. - identifiers = dict(build_identifiers( - self.resource_model.identifiers, parent, params, - raw_response)) - - # If any of the identifiers is a list, then the response is plural - plural = [v for v in identifiers.values() if isinstance(v, list)] - - if plural: - response = [] - - # The number of items in an identifier that is a list will - # determine how many resource instances to create. - for i in range(len(plural[0])): - # Response item data is *only* available if a search path - # was given. This prevents accidentally loading unrelated - # data that may be in the response. - response_item = None - if search_response: - response_item = search_response[i] - response.append( - self.handle_response_item(resource_cls, parent, - identifiers, response_item)) - elif all_not_none(identifiers.values()): - # All identifiers must always exist, otherwise the resource - # cannot be instantiated. - response = self.handle_response_item( - resource_cls, parent, identifiers, search_response) - else: - # The response should be empty, but that may mean an - # empty dict, list, or None based on whether we make - # a remote service call and what shape it is expected - # to return. - response = None - if self.operation_name is not None: - # A remote service call was made, so try and determine - # its shape. - response = build_empty_response( - self.search_path, self.operation_name, - self.service_context.service_model) - - return response - - def handle_response_item(self, resource_cls, parent, identifiers, - resource_data): - """ - Handles the creation of a single response item by setting - parameters and creating the appropriate resource instance. - - :type resource_cls: ServiceResource subclass - :param resource_cls: The resource class to instantiate. - :type parent: ServiceResource - :param parent: The resource instance to which this action is attached. - :type identifiers: dict - :param identifiers: Map of identifier names to value or values. - :type resource_data: dict or None - :param resource_data: Data for resource attributes. - :rtype: ServiceResource - :return: New resource instance. - """ - kwargs = { - 'client': parent.meta.client, - } - - for name, value in identifiers.items(): - # If value is a list, then consume the next item - if isinstance(value, list): - value = value.pop(0) - - kwargs[name] = value - - resource = resource_cls(**kwargs) - - if resource_data is not None: - resource.meta.data = resource_data - - return resource diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/__init__.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/__init__.py deleted file mode 100644 index c89416d7..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/__init__.py +++ /dev/null @@ -1,12 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/inject.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/inject.py deleted file mode 100644 index a1a01835..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/inject.py +++ /dev/null @@ -1,761 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.exceptions import ClientError - -from boto3.s3.transfer import create_transfer_manager -from boto3.s3.transfer import TransferConfig, S3Transfer -from boto3.s3.transfer import ProgressCallbackInvoker -from boto3 import utils - - -def inject_s3_transfer_methods(class_attributes, **kwargs): - utils.inject_attribute(class_attributes, 'upload_file', upload_file) - utils.inject_attribute(class_attributes, 'download_file', download_file) - utils.inject_attribute(class_attributes, 'copy', copy) - utils.inject_attribute(class_attributes, 'upload_fileobj', upload_fileobj) - utils.inject_attribute( - class_attributes, 'download_fileobj', download_fileobj) - - -def inject_bucket_methods(class_attributes, **kwargs): - utils.inject_attribute(class_attributes, 'load', bucket_load) - utils.inject_attribute(class_attributes, 'upload_file', bucket_upload_file) - utils.inject_attribute( - class_attributes, 'download_file', bucket_download_file) - utils.inject_attribute(class_attributes, 'copy', bucket_copy) - utils.inject_attribute( - class_attributes, 'upload_fileobj', bucket_upload_fileobj) - utils.inject_attribute( - class_attributes, 'download_fileobj', bucket_download_fileobj) - - -def inject_object_methods(class_attributes, **kwargs): - utils.inject_attribute(class_attributes, 'upload_file', object_upload_file) - utils.inject_attribute( - class_attributes, 'download_file', object_download_file) - utils.inject_attribute(class_attributes, 'copy', object_copy) - utils.inject_attribute( - class_attributes, 'upload_fileobj', object_upload_fileobj) - utils.inject_attribute( - class_attributes, 'download_fileobj', object_download_fileobj) - - -def inject_object_summary_methods(class_attributes, **kwargs): - utils.inject_attribute(class_attributes, 'load', object_summary_load) - - -def bucket_load(self, *args, **kwargs): - """ - Calls s3.Client.list_buckets() to update the attributes of the Bucket - resource. - """ - # The docstring above is phrased this way to match what the autogenerated - # docs produce. - - # We can't actually get the bucket's attributes from a HeadBucket, - # so we need to use a ListBuckets and search for our bucket. - # However, we may fail if we lack permissions to ListBuckets - # or the bucket is in another account. In which case, creation_date - # will be None. - self.meta.data = {} - try: - response = self.meta.client.list_buckets() - for bucket_data in response['Buckets']: - if bucket_data['Name'] == self.name: - self.meta.data = bucket_data - break - except ClientError as e: - if not e.response.get('Error', {}).get('Code') == 'AccessDenied': - raise - -def object_summary_load(self, *args, **kwargs): - """ - Calls s3.Client.head_object to update the attributes of the ObjectSummary - resource. - """ - response = self.meta.client.head_object( - Bucket=self.bucket_name, Key=self.key) - if 'ContentLength' in response: - response['Size'] = response.pop('ContentLength') - self.meta.data = response - - -def upload_file(self, Filename, Bucket, Key, ExtraArgs=None, - Callback=None, Config=None): - """Upload a file to an S3 object. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.meta.client.upload_file('/tmp/hello.txt', 'mybucket', 'hello.txt') - - Similar behavior as S3Transfer's upload_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to upload. - - :type Bucket: str - :param Bucket: The name of the bucket to upload to. - - :type Key: str - :param Key: The name of the key to upload to. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - with S3Transfer(self, Config) as transfer: - return transfer.upload_file( - filename=Filename, bucket=Bucket, key=Key, - extra_args=ExtraArgs, callback=Callback) - - -def download_file(self, Bucket, Key, Filename, ExtraArgs=None, - Callback=None, Config=None): - """Download an S3 object to a file. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.meta.client.download_file('mybucket', 'hello.txt', '/tmp/hello.txt') - - Similar behavior as S3Transfer's download_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to download to. - - :type Bucket: str - :param Bucket: The name of the bucket to download from. - - :type Key: str - :param Key: The name of the key to download from. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - with S3Transfer(self, Config) as transfer: - return transfer.download_file( - bucket=Bucket, key=Key, filename=Filename, - extra_args=ExtraArgs, callback=Callback) - - -def bucket_upload_file(self, Filename, Key, - ExtraArgs=None, Callback=None, Config=None): - """Upload a file to an S3 object. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.Bucket('mybucket').upload_file('/tmp/hello.txt', 'hello.txt') - - Similar behavior as S3Transfer's upload_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to upload. - - :type Key: str - :param Key: The name of the key to upload to. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - return self.meta.client.upload_file( - Filename=Filename, Bucket=self.name, Key=Key, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - - -def bucket_download_file(self, Key, Filename, - ExtraArgs=None, Callback=None, Config=None): - """Download an S3 object to a file. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.Bucket('mybucket').download_file('hello.txt', '/tmp/hello.txt') - - Similar behavior as S3Transfer's download_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to download to. - - :type Key: str - :param Key: The name of the key to download from. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - return self.meta.client.download_file( - Bucket=self.name, Key=Key, Filename=Filename, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - - -def object_upload_file(self, Filename, - ExtraArgs=None, Callback=None, Config=None): - """Upload a file to an S3 object. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.Object('mybucket', 'hello.txt').upload_file('/tmp/hello.txt') - - Similar behavior as S3Transfer's upload_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to upload. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - return self.meta.client.upload_file( - Filename=Filename, Bucket=self.bucket_name, Key=self.key, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - - -def object_download_file(self, Filename, - ExtraArgs=None, Callback=None, Config=None): - """Download an S3 object to a file. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - s3.Object('mybucket', 'hello.txt').download_file('/tmp/hello.txt') - - Similar behavior as S3Transfer's download_file() method, - except that parameters are capitalized. Detailed examples can be found at - :ref:`S3Transfer's Usage `. - - :type Filename: str - :param Filename: The path to the file to download to. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - transfer. - """ - return self.meta.client.download_file( - Bucket=self.bucket_name, Key=self.key, Filename=Filename, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - - -def copy(self, CopySource, Bucket, Key, ExtraArgs=None, Callback=None, - SourceClient=None, Config=None): - """Copy an object from one S3 location to another. - - This is a managed transfer which will perform a multipart copy in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - copy_source = { - 'Bucket': 'mybucket', - 'Key': 'mykey' - } - s3.meta.client.copy(copy_source, 'otherbucket', 'otherkey') - - :type CopySource: dict - :param CopySource: The name of the source bucket, key name of the - source object, and optional version ID of the source object. The - dictionary format is: - ``{'Bucket': 'bucket', 'Key': 'key', 'VersionId': 'id'}``. Note - that the ``VersionId`` key is optional and may be omitted. - - :type Bucket: str - :param Bucket: The name of the bucket to copy to - - :type Key: str - :param Key: The name of the key to copy to - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the copy. - - :type SourceClient: botocore or boto3 Client - :param SourceClient: The client to be used for operation that - may happen at the source object. For example, this client is - used for the head_object that determines the size of the copy. - If no client is provided, the current client is used as the client - for the source object. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - copy. - """ - subscribers = None - if Callback is not None: - subscribers = [ProgressCallbackInvoker(Callback)] - - config = Config - if config is None: - config = TransferConfig() - - with create_transfer_manager(self, config) as manager: - future = manager.copy( - copy_source=CopySource, bucket=Bucket, key=Key, - extra_args=ExtraArgs, subscribers=subscribers, - source_client=SourceClient) - return future.result() - - -def bucket_copy(self, CopySource, Key, ExtraArgs=None, Callback=None, - SourceClient=None, Config=None): - """Copy an object from one S3 location to an object in this bucket. - - This is a managed transfer which will perform a multipart copy in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - copy_source = { - 'Bucket': 'mybucket', - 'Key': 'mykey' - } - bucket = s3.Bucket('otherbucket') - bucket.copy(copy_source, 'otherkey') - - :type CopySource: dict - :param CopySource: The name of the source bucket, key name of the - source object, and optional version ID of the source object. The - dictionary format is: - ``{'Bucket': 'bucket', 'Key': 'key', 'VersionId': 'id'}``. Note - that the ``VersionId`` key is optional and may be omitted. - - :type Key: str - :param Key: The name of the key to copy to - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the copy. - - :type SourceClient: botocore or boto3 Client - :param SourceClient: The client to be used for operation that - may happen at the source object. For example, this client is - used for the head_object that determines the size of the copy. - If no client is provided, the current client is used as the client - for the source object. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - copy. - """ - return self.meta.client.copy( - CopySource=CopySource, Bucket=self.name, Key=Key, ExtraArgs=ExtraArgs, - Callback=Callback, SourceClient=SourceClient, Config=Config) - - -def object_copy(self, CopySource, ExtraArgs=None, Callback=None, - SourceClient=None, Config=None): - """Copy an object from one S3 location to this object. - - This is a managed transfer which will perform a multipart copy in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - copy_source = { - 'Bucket': 'mybucket', - 'Key': 'mykey' - } - bucket = s3.Bucket('otherbucket') - obj = bucket.Object('otherkey') - obj.copy(copy_source) - - :type CopySource: dict - :param CopySource: The name of the source bucket, key name of the - source object, and optional version ID of the source object. The - dictionary format is: - ``{'Bucket': 'bucket', 'Key': 'key', 'VersionId': 'id'}``. Note - that the ``VersionId`` key is optional and may be omitted. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the copy. - - :type SourceClient: botocore or boto3 Client - :param SourceClient: The client to be used for operation that - may happen at the source object. For example, this client is - used for the head_object that determines the size of the copy. - If no client is provided, the current client is used as the client - for the source object. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - copy. - """ - return self.meta.client.copy( - CopySource=CopySource, Bucket=self.bucket_name, Key=self.key, - ExtraArgs=ExtraArgs, Callback=Callback, SourceClient=SourceClient, - Config=Config) - - -def upload_fileobj(self, Fileobj, Bucket, Key, ExtraArgs=None, - Callback=None, Config=None): - """Upload a file-like object to S3. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart upload in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.client('s3') - - with open('filename', 'rb') as data: - s3.upload_fileobj(data, 'mybucket', 'mykey') - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to upload. At a minimum, it must - implement the `read` method, and must return bytes. - - :type Bucket: str - :param Bucket: The name of the bucket to upload to. - - :type Key: str - :param Key: The name of the key to upload to. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - upload. - """ - if not hasattr(Fileobj, 'read'): - raise ValueError('Fileobj must implement read') - - subscribers = None - if Callback is not None: - subscribers = [ProgressCallbackInvoker(Callback)] - - config = Config - if config is None: - config = TransferConfig() - - with create_transfer_manager(self, config) as manager: - future = manager.upload( - fileobj=Fileobj, bucket=Bucket, key=Key, - extra_args=ExtraArgs, subscribers=subscribers) - return future.result() - - -def bucket_upload_fileobj(self, Fileobj, Key, ExtraArgs=None, - Callback=None, Config=None): - """Upload a file-like object to this bucket. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart upload in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - bucket = s3.Bucket('mybucket') - - with open('filename', 'rb') as data: - bucket.upload_fileobj(data, 'mykey') - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to upload. At a minimum, it must - implement the `read` method, and must return bytes. - - :type Key: str - :param Key: The name of the key to upload to. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - upload. - """ - return self.meta.client.upload_fileobj( - Fileobj=Fileobj, Bucket=self.name, Key=Key, ExtraArgs=ExtraArgs, - Callback=Callback, Config=Config) - - -def object_upload_fileobj(self, Fileobj, ExtraArgs=None, Callback=None, - Config=None): - """Upload a file-like object to this object. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart upload in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - bucket = s3.Bucket('mybucket') - obj = bucket.Object('mykey') - - with open('filename', 'rb') as data: - obj.upload_fileobj(data) - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to upload. At a minimum, it must - implement the `read` method, and must return bytes. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the upload. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - upload. - """ - return self.meta.client.upload_fileobj( - Fileobj=Fileobj, Bucket=self.bucket_name, Key=self.key, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - - -def download_fileobj(self, Bucket, Key, Fileobj, ExtraArgs=None, - Callback=None, Config=None): - """Download an object from S3 to a file-like object. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart download in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.client('s3') - - with open('filename', 'wb') as data: - s3.download_fileobj('mybucket', 'mykey', data) - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to download into. At a minimum, it must - implement the `write` method and must accept bytes. - - :type Bucket: str - :param Bucket: The name of the bucket to download from. - - :type Key: str - :param Key: The name of the key to download from. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - download. - """ - if not hasattr(Fileobj, 'write'): - raise ValueError('Fileobj must implement write') - - subscribers = None - if Callback is not None: - subscribers = [ProgressCallbackInvoker(Callback)] - - config = Config - if config is None: - config = TransferConfig() - - with create_transfer_manager(self, config) as manager: - future = manager.download( - bucket=Bucket, key=Key, fileobj=Fileobj, - extra_args=ExtraArgs, subscribers=subscribers) - return future.result() - - -def bucket_download_fileobj(self, Key, Fileobj, ExtraArgs=None, - Callback=None, Config=None): - """Download an object from this bucket to a file-like-object. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart download in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - bucket = s3.Bucket('mybucket') - - with open('filename', 'wb') as data: - bucket.download_fileobj('mykey', data) - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to download into. At a minimum, it must - implement the `write` method and must accept bytes. - - :type Key: str - :param Key: The name of the key to download from. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - download. - """ - return self.meta.client.download_fileobj( - Bucket=self.name, Key=Key, Fileobj=Fileobj, ExtraArgs=ExtraArgs, - Callback=Callback, Config=Config) - - -def object_download_fileobj(self, Fileobj, ExtraArgs=None, Callback=None, - Config=None): - """Download this object from S3 to a file-like object. - - The file-like object must be in binary mode. - - This is a managed transfer which will perform a multipart download in - multiple threads if necessary. - - Usage:: - - import boto3 - s3 = boto3.resource('s3') - bucket = s3.Bucket('mybucket') - obj = bucket.Object('mykey') - - with open('filename', 'wb') as data: - obj.download_fileobj(data) - - :type Fileobj: a file-like object - :param Fileobj: A file-like object to download into. At a minimum, it must - implement the `write` method and must accept bytes. - - :type ExtraArgs: dict - :param ExtraArgs: Extra arguments that may be passed to the - client operation. - - :type Callback: function - :param Callback: A method which takes a number of bytes transferred to - be periodically called during the download. - - :type Config: boto3.s3.transfer.TransferConfig - :param Config: The transfer configuration to be used when performing the - download. - """ - return self.meta.client.download_fileobj( - Bucket=self.bucket_name, Key=self.key, Fileobj=Fileobj, - ExtraArgs=ExtraArgs, Callback=Callback, Config=Config) - diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/transfer.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/transfer.py deleted file mode 100644 index 5c8b8318..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/s3/transfer.py +++ /dev/null @@ -1,338 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Abstractions over S3's upload/download operations. - -This module provides high level abstractions for efficient -uploads/downloads. It handles several things for the user: - -* Automatically switching to multipart transfers when - a file is over a specific size threshold -* Uploading/downloading a file in parallel -* Progress callbacks to monitor transfers -* Retries. While botocore handles retries for streaming uploads, - it is not possible for it to handle retries for streaming - downloads. This module handles retries for both cases so - you don't need to implement any retry logic yourself. - -This module has a reasonable set of defaults. It also allows you -to configure many aspects of the transfer process including: - -* Multipart threshold size -* Max parallel downloads -* Socket timeouts -* Retry amounts - -There is no support for s3->s3 multipart copies at this -time. - - -.. _ref_s3transfer_usage: - -Usage -===== - -The simplest way to use this module is: - -.. code-block:: python - - client = boto3.client('s3', 'us-west-2') - transfer = S3Transfer(client) - # Upload /tmp/myfile to s3://bucket/key - transfer.upload_file('/tmp/myfile', 'bucket', 'key') - - # Download s3://bucket/key to /tmp/myfile - transfer.download_file('bucket', 'key', '/tmp/myfile') - -The ``upload_file`` and ``download_file`` methods also accept -``**kwargs``, which will be forwarded through to the corresponding -client operation. Here are a few examples using ``upload_file``:: - - # Making the object public - transfer.upload_file('/tmp/myfile', 'bucket', 'key', - extra_args={'ACL': 'public-read'}) - - # Setting metadata - transfer.upload_file('/tmp/myfile', 'bucket', 'key', - extra_args={'Metadata': {'a': 'b', 'c': 'd'}}) - - # Setting content type - transfer.upload_file('/tmp/myfile.json', 'bucket', 'key', - extra_args={'ContentType': "application/json"}) - - -The ``S3Transfer`` class also supports progress callbacks so you can -provide transfer progress to users. Both the ``upload_file`` and -``download_file`` methods take an optional ``callback`` parameter. -Here's an example of how to print a simple progress percentage -to the user: - -.. code-block:: python - - class ProgressPercentage(object): - def __init__(self, filename): - self._filename = filename - self._size = float(os.path.getsize(filename)) - self._seen_so_far = 0 - self._lock = threading.Lock() - - def __call__(self, bytes_amount): - # To simplify we'll assume this is hooked up - # to a single filename. - with self._lock: - self._seen_so_far += bytes_amount - percentage = (self._seen_so_far / self._size) * 100 - sys.stdout.write( - "\r%s %s / %s (%.2f%%)" % ( - self._filename, self._seen_so_far, self._size, - percentage)) - sys.stdout.flush() - - - transfer = S3Transfer(boto3.client('s3', 'us-west-2')) - # Upload /tmp/myfile to s3://bucket/key and print upload progress. - transfer.upload_file('/tmp/myfile', 'bucket', 'key', - callback=ProgressPercentage('/tmp/myfile')) - - - -You can also provide a TransferConfig object to the S3Transfer -object that gives you more fine grained control over the -transfer. For example: - -.. code-block:: python - - client = boto3.client('s3', 'us-west-2') - config = TransferConfig( - multipart_threshold=8 * 1024 * 1024, - max_concurrency=10, - num_download_attempts=10, - ) - transfer = S3Transfer(client, config) - transfer.upload_file('/tmp/foo', 'bucket', 'key') - - -""" -from botocore.exceptions import ClientError -from botocore.compat import six -from s3transfer.exceptions import RetriesExceededError as \ - S3TransferRetriesExceededError -from s3transfer.manager import TransferConfig as S3TransferConfig -from s3transfer.manager import TransferManager -from s3transfer.futures import NonThreadedExecutor -from s3transfer.subscribers import BaseSubscriber -from s3transfer.utils import OSUtils - -from boto3.exceptions import RetriesExceededError, S3UploadFailedError - - -KB = 1024 -MB = KB * KB - - -def create_transfer_manager(client, config, osutil=None): - """Creates a transfer manager based on configuration - - :type client: boto3.client - :param client: The S3 client to use - - :type config: boto3.s3.transfer.TransferConfig - :param config: The transfer config to use - - :type osutil: s3transfer.utils.OSUtils - :param osutil: The os utility to use - - :rtype: s3transfer.manager.TransferManager - :returns: A transfer manager based on parameters provided - """ - executor_cls = None - if not config.use_threads: - executor_cls = NonThreadedExecutor - return TransferManager(client, config, osutil, executor_cls) - - -class TransferConfig(S3TransferConfig): - ALIAS = { - 'max_concurrency': 'max_request_concurrency', - 'max_io_queue': 'max_io_queue_size' - } - - def __init__(self, - multipart_threshold=8 * MB, - max_concurrency=10, - multipart_chunksize=8 * MB, - num_download_attempts=5, - max_io_queue=100, - io_chunksize=256 * KB, - use_threads=True): - """Configuration object for managed S3 transfers - - :param multipart_threshold: The transfer size threshold for which - multipart uploads, downloads, and copies will automatically be - triggered. - - :param max_concurrency: The maximum number of threads that will be - making requests to perform a transfer. If ``use_threads`` is - set to ``False``, the value provided is ignored as the transfer - will only ever use the main thread. - - :param multipart_chunksize: The partition size of each part for a - multipart transfer. - - :param num_download_attempts: The number of download attempts that - will be retried upon errors with downloading an object in S3. - Note that these retries account for errors that occur when - streaming down the data from s3 (i.e. socket errors and read - timeouts that occur after recieving an OK response from s3). - Other retryable exceptions such as throttling errors and 5xx - errors are already retried by botocore (this default is 5). This - does not take into account the number of exceptions retried by - botocore. - - :param max_io_queue: The maximum amount of read parts that can be - queued in memory to be written for a download. The size of each - of these read parts is at most the size of ``io_chunksize``. - - :param io_chunksize: The max size of each chunk in the io queue. - Currently, this is size used when ``read`` is called on the - downloaded stream as well. - - :param use_threads: If True, threads will be used when performing - S3 transfers. If False, no threads will be used in - performing transfers: all logic will be ran in the main thread. - """ - super(TransferConfig, self).__init__( - multipart_threshold=multipart_threshold, - max_request_concurrency=max_concurrency, - multipart_chunksize=multipart_chunksize, - num_download_attempts=num_download_attempts, - max_io_queue_size=max_io_queue, - io_chunksize=io_chunksize, - ) - # Some of the argument names are not the same as the inherited - # S3TransferConfig so we add aliases so you can still access the - # old version of the names. - for alias in self.ALIAS: - setattr(self, alias, getattr(self, self.ALIAS[alias])) - self.use_threads = use_threads - - def __setattr__(self, name, value): - # If the alias name is used, make sure we set the name that it points - # to as that is what actually is used in governing the TransferManager. - if name in self.ALIAS: - super(TransferConfig, self).__setattr__(self.ALIAS[name], value) - # Always set the value of the actual name provided. - super(TransferConfig, self).__setattr__(name, value) - - -class S3Transfer(object): - ALLOWED_DOWNLOAD_ARGS = TransferManager.ALLOWED_DOWNLOAD_ARGS - ALLOWED_UPLOAD_ARGS = TransferManager.ALLOWED_UPLOAD_ARGS - - def __init__(self, client=None, config=None, osutil=None, manager=None): - if not client and not manager: - raise ValueError( - 'Either a boto3.Client or s3transfer.manager.TransferManager ' - 'must be provided' - ) - if manager and any([client, config, osutil]): - raise ValueError( - 'Manager cannot be provided with client, config, ' - 'nor osutil. These parameters are mutually exclusive.' - ) - if config is None: - config = TransferConfig() - if osutil is None: - osutil = OSUtils() - if manager: - self._manager = manager - else: - self._manager = create_transfer_manager(client, config, osutil) - - def upload_file(self, filename, bucket, key, - callback=None, extra_args=None): - """Upload a file to an S3 object. - - Variants have also been injected into S3 client, Bucket and Object. - You don't have to use S3Transfer.upload_file() directly. - - .. seealso:: - :py:meth:`S3.Client.upload_file` - :py:meth:`S3.Client.upload_fileobj` - """ - if not isinstance(filename, six.string_types): - raise ValueError('Filename must be a string') - - subscribers = self._get_subscribers(callback) - future = self._manager.upload( - filename, bucket, key, extra_args, subscribers) - try: - future.result() - # If a client error was raised, add the backwards compatibility layer - # that raises a S3UploadFailedError. These specific errors were only - # ever thrown for upload_parts but now can be thrown for any related - # client error. - except ClientError as e: - raise S3UploadFailedError( - "Failed to upload %s to %s: %s" % ( - filename, '/'.join([bucket, key]), e)) - - def download_file(self, bucket, key, filename, extra_args=None, - callback=None): - """Download an S3 object to a file. - - Variants have also been injected into S3 client, Bucket and Object. - You don't have to use S3Transfer.download_file() directly. - - .. seealso:: - :py:meth:`S3.Client.download_file` - :py:meth:`S3.Client.download_fileobj` - """ - if not isinstance(filename, six.string_types): - raise ValueError('Filename must be a string') - - subscribers = self._get_subscribers(callback) - future = self._manager.download( - bucket, key, filename, extra_args, subscribers) - try: - future.result() - # This is for backwards compatibility where when retries are - # exceeded we need to throw the same error from boto3 instead of - # s3transfer's built in RetriesExceededError as current users are - # catching the boto3 one instead of the s3transfer exception to do - # their own retries. - except S3TransferRetriesExceededError as e: - raise RetriesExceededError(e.last_exception) - - def _get_subscribers(self, callback): - if not callback: - return None - return [ProgressCallbackInvoker(callback)] - - def __enter__(self): - return self - - def __exit__(self, *args): - self._manager.__exit__(*args) - - -class ProgressCallbackInvoker(BaseSubscriber): - """A back-compat wrapper to invoke a provided callback via a subscriber - - :param callback: A callable that takes a single positional argument for - how many bytes were transferred. - """ - def __init__(self, callback): - self._callback = callback - - def on_progress(self, bytes_transferred, **kwargs): - self._callback(bytes_transferred) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/session.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/session.py deleted file mode 100644 index fa981c1c..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/session.py +++ /dev/null @@ -1,452 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import copy -import os - -import botocore.session -from botocore.client import Config -from botocore.exceptions import DataNotFoundError, UnknownServiceError - -import boto3 -import boto3.utils -from boto3.exceptions import ResourceNotExistsError, UnknownAPIVersionError - -from .resources.factory import ResourceFactory - - -class Session(object): - """ - A session stores configuration state and allows you to create service - clients and resources. - - :type aws_access_key_id: string - :param aws_access_key_id: AWS access key ID - :type aws_secret_access_key: string - :param aws_secret_access_key: AWS secret access key - :type aws_session_token: string - :param aws_session_token: AWS temporary session token - :type region_name: string - :param region_name: Default region when creating new connections - :type botocore_session: botocore.session.Session - :param botocore_session: Use this Botocore session instead of creating - a new default one. - :type profile_name: string - :param profile_name: The name of a profile to use. If not given, then - the default profile is used. - """ - def __init__(self, aws_access_key_id=None, aws_secret_access_key=None, - aws_session_token=None, region_name=None, - botocore_session=None, profile_name=None): - if botocore_session is not None: - self._session = botocore_session - else: - # Create a new default session - self._session = botocore.session.get_session() - - # Setup custom user-agent string if it isn't already customized - if self._session.user_agent_name == 'Botocore': - botocore_info = 'Botocore/{0}'.format( - self._session.user_agent_version) - if self._session.user_agent_extra: - self._session.user_agent_extra += ' ' + botocore_info - else: - self._session.user_agent_extra = botocore_info - self._session.user_agent_name = 'Boto3' - self._session.user_agent_version = boto3.__version__ - - if profile_name is not None: - self._session.set_config_variable('profile', profile_name) - - if aws_access_key_id or aws_secret_access_key or aws_session_token: - self._session.set_credentials( - aws_access_key_id, aws_secret_access_key, aws_session_token) - - if region_name is not None: - self._session.set_config_variable('region', region_name) - - self.resource_factory = ResourceFactory( - self._session.get_component('event_emitter')) - self._setup_loader() - self._register_default_handlers() - - def __repr__(self): - return '{0}(region_name={1})'.format( - self.__class__.__name__, - repr(self._session.get_config_variable('region'))) - - @property - def profile_name(self): - """ - The **read-only** profile name. - """ - return self._session.profile or 'default' - - @property - def region_name(self): - """ - The **read-only** region name. - """ - return self._session.get_config_variable('region') - - @property - def events(self): - """ - The event emitter for a session - """ - return self._session.get_component('event_emitter') - - @property - def available_profiles(self): - """ - The profiles available to the session credentials - """ - return self._session.available_profiles - - def _setup_loader(self): - """ - Setup loader paths so that we can load resources. - """ - self._loader = self._session.get_component('data_loader') - self._loader.search_paths.append( - os.path.join(os.path.dirname(__file__), 'data')) - - def get_available_services(self): - """ - Get a list of available services that can be loaded as low-level - clients via :py:meth:`Session.client`. - - :rtype: list - :return: List of service names - """ - return self._session.get_available_services() - - def get_available_resources(self): - """ - Get a list of available services that can be loaded as resource - clients via :py:meth:`Session.resource`. - - :rtype: list - :return: List of service names - """ - return self._loader.list_available_services(type_name='resources-1') - - def get_available_partitions(self): - """Lists the available partitions - - :rtype: list - :return: Returns a list of partition names (e.g., ["aws", "aws-cn"]) - """ - return self._session.get_available_partitions() - - def get_available_regions(self, service_name, partition_name='aws', - allow_non_regional=False): - """Lists the region and endpoint names of a particular partition. - - :type service_name: string - :param service_name: Name of a service to list endpoint for (e.g., s3). - - :type partition_name: string - :param partition_name: Name of the partition to limit endpoints to. - (e.g., aws for the public AWS endpoints, aws-cn for AWS China - endpoints, aws-us-gov for AWS GovCloud (US) Endpoints, etc.) - - :type allow_non_regional: bool - :param allow_non_regional: Set to True to include endpoints that are - not regional endpoints (e.g., s3-external-1, - fips-us-gov-west-1, etc). - - :return: Returns a list of endpoint names (e.g., ["us-east-1"]). - """ - return self._session.get_available_regions( - service_name=service_name, partition_name=partition_name, - allow_non_regional=allow_non_regional) - - def get_credentials(self): - """ - Return the :class:`botocore.credential.Credential` object - associated with this session. If the credentials have not - yet been loaded, this will attempt to load them. If they - have already been loaded, this will return the cached - credentials. - """ - return self._session.get_credentials() - - def client(self, service_name, region_name=None, api_version=None, - use_ssl=True, verify=None, endpoint_url=None, - aws_access_key_id=None, aws_secret_access_key=None, - aws_session_token=None, config=None): - """ - Create a low-level service client by name. - - :type service_name: string - :param service_name: The name of a service, e.g. 's3' or 'ec2'. You - can get a list of available services via - :py:meth:`get_available_services`. - - :type region_name: string - :param region_name: The name of the region associated with the client. - A client is associated with a single region. - - :type api_version: string - :param api_version: The API version to use. By default, botocore will - use the latest API version when creating a client. You only need - to specify this parameter if you want to use a previous API version - of the client. - - :type use_ssl: boolean - :param use_ssl: Whether or not to use SSL. By default, SSL is used. - Note that not all services support non-ssl connections. - - :type verify: boolean/string - :param verify: Whether or not to verify SSL certificates. By default - SSL certificates are verified. You can provide the following - values: - - * False - do not validate SSL certificates. SSL will still be - used (unless use_ssl is False), but SSL certificates - will not be verified. - * path/to/cert/bundle.pem - A filename of the CA cert bundle to - uses. You can specify this argument if you want to use a - different CA cert bundle than the one used by botocore. - - :type endpoint_url: string - :param endpoint_url: The complete URL to use for the constructed - client. Normally, botocore will automatically construct the - appropriate URL to use when communicating with a service. You - can specify a complete URL (including the "http/https" scheme) - to override this behavior. If this value is provided, - then ``use_ssl`` is ignored. - - :type aws_access_key_id: string - :param aws_access_key_id: The access key to use when creating - the client. This is entirely optional, and if not provided, - the credentials configured for the session will automatically - be used. You only need to provide this argument if you want - to override the credentials used for this specific client. - - :type aws_secret_access_key: string - :param aws_secret_access_key: The secret key to use when creating - the client. Same semantics as aws_access_key_id above. - - :type aws_session_token: string - :param aws_session_token: The session token to use when creating - the client. Same semantics as aws_access_key_id above. - - :type config: botocore.client.Config - :param config: Advanced client configuration options. If region_name - is specified in the client config, its value will take precedence - over environment variables and configuration values, but not over - a region_name value passed explicitly to the method. See - `botocore config documentation - `_ - for more details. - - :return: Service client instance - - """ - return self._session.create_client( - service_name, region_name=region_name, api_version=api_version, - use_ssl=use_ssl, verify=verify, endpoint_url=endpoint_url, - aws_access_key_id=aws_access_key_id, - aws_secret_access_key=aws_secret_access_key, - aws_session_token=aws_session_token, config=config) - - def resource(self, service_name, region_name=None, api_version=None, - use_ssl=True, verify=None, endpoint_url=None, - aws_access_key_id=None, aws_secret_access_key=None, - aws_session_token=None, config=None): - """ - Create a resource service client by name. - - :type service_name: string - :param service_name: The name of a service, e.g. 's3' or 'ec2'. You - can get a list of available services via - :py:meth:`get_available_resources`. - - :type region_name: string - :param region_name: The name of the region associated with the client. - A client is associated with a single region. - - :type api_version: string - :param api_version: The API version to use. By default, botocore will - use the latest API version when creating a client. You only need - to specify this parameter if you want to use a previous API version - of the client. - - :type use_ssl: boolean - :param use_ssl: Whether or not to use SSL. By default, SSL is used. - Note that not all services support non-ssl connections. - - :type verify: boolean/string - :param verify: Whether or not to verify SSL certificates. By default - SSL certificates are verified. You can provide the following - values: - - * False - do not validate SSL certificates. SSL will still be - used (unless use_ssl is False), but SSL certificates - will not be verified. - * path/to/cert/bundle.pem - A filename of the CA cert bundle to - uses. You can specify this argument if you want to use a - different CA cert bundle than the one used by botocore. - - :type endpoint_url: string - :param endpoint_url: The complete URL to use for the constructed - client. Normally, botocore will automatically construct the - appropriate URL to use when communicating with a service. You - can specify a complete URL (including the "http/https" scheme) - to override this behavior. If this value is provided, - then ``use_ssl`` is ignored. - - :type aws_access_key_id: string - :param aws_access_key_id: The access key to use when creating - the client. This is entirely optional, and if not provided, - the credentials configured for the session will automatically - be used. You only need to provide this argument if you want - to override the credentials used for this specific client. - - :type aws_secret_access_key: string - :param aws_secret_access_key: The secret key to use when creating - the client. Same semantics as aws_access_key_id above. - - :type aws_session_token: string - :param aws_session_token: The session token to use when creating - the client. Same semantics as aws_access_key_id above. - - :type config: botocore.client.Config - :param config: Advanced client configuration options. If region_name - is specified in the client config, its value will take precedence - over environment variables and configuration values, but not over - a region_name value passed explicitly to the method. If - user_agent_extra is specified in the client config, it overrides - the default user_agent_extra provided by the resource API. See - `botocore config documentation - `_ - for more details. - - :return: Subclass of :py:class:`~boto3.resources.base.ServiceResource` - """ - try: - resource_model = self._loader.load_service_model( - service_name, 'resources-1', api_version) - except UnknownServiceError: - available = self.get_available_resources() - has_low_level_client = ( - service_name in self.get_available_services()) - raise ResourceNotExistsError(service_name, available, - has_low_level_client) - except DataNotFoundError: - # This is because we've provided an invalid API version. - available_api_versions = self._loader.list_api_versions( - service_name, 'resources-1') - raise UnknownAPIVersionError( - service_name, api_version, ', '.join(available_api_versions)) - - if api_version is None: - # Even though botocore's load_service_model() can handle - # using the latest api_version if not provided, we need - # to track this api_version in boto3 in order to ensure - # we're pairing a resource model with a client model - # of the same API version. It's possible for the latest - # API version of a resource model in boto3 to not be - # the same API version as a service model in botocore. - # So we need to look up the api_version if one is not - # provided to ensure we load the same API version of the - # client. - # - # Note: This is relying on the fact that - # loader.load_service_model(..., api_version=None) - # and loader.determine_latest_version(..., 'resources-1') - # both load the same api version of the file. - api_version = self._loader.determine_latest_version( - service_name, 'resources-1') - - # Creating a new resource instance requires the low-level client - # and service model, the resource version and resource JSON data. - # We pass these to the factory and get back a class, which is - # instantiated on top of the low-level client. - if config is not None: - if config.user_agent_extra is None: - config = copy.deepcopy(config) - config.user_agent_extra = 'Resource' - else: - config = Config(user_agent_extra='Resource') - client = self.client( - service_name, region_name=region_name, api_version=api_version, - use_ssl=use_ssl, verify=verify, endpoint_url=endpoint_url, - aws_access_key_id=aws_access_key_id, - aws_secret_access_key=aws_secret_access_key, - aws_session_token=aws_session_token, config=config) - service_model = client.meta.service_model - - # Create a ServiceContext object to serve as a reference to - # important read-only information about the general service. - service_context = boto3.utils.ServiceContext( - service_name=service_name, service_model=service_model, - resource_json_definitions=resource_model['resources'], - service_waiter_model=boto3.utils.LazyLoadedWaiterModel( - self._session, service_name, api_version) - ) - - # Create the service resource class. - cls = self.resource_factory.load_from_definition( - resource_name=service_name, - single_resource_json_definition=resource_model['service'], - service_context=service_context - ) - - return cls(client=client) - - def _register_default_handlers(self): - - # S3 customizations - self._session.register( - 'creating-client-class.s3', - boto3.utils.lazy_call( - 'boto3.s3.inject.inject_s3_transfer_methods')) - self._session.register( - 'creating-resource-class.s3.Bucket', - boto3.utils.lazy_call( - 'boto3.s3.inject.inject_bucket_methods')) - self._session.register( - 'creating-resource-class.s3.Object', - boto3.utils.lazy_call( - 'boto3.s3.inject.inject_object_methods')) - self._session.register( - 'creating-resource-class.s3.ObjectSummary', - boto3.utils.lazy_call( - 'boto3.s3.inject.inject_object_summary_methods')) - - # DynamoDb customizations - self._session.register( - 'creating-resource-class.dynamodb', - boto3.utils.lazy_call( - 'boto3.dynamodb.transform.register_high_level_interface'), - unique_id='high-level-dynamodb') - self._session.register( - 'creating-resource-class.dynamodb.Table', - boto3.utils.lazy_call( - 'boto3.dynamodb.table.register_table_methods'), - unique_id='high-level-dynamodb-table') - - # EC2 Customizations - self._session.register( - 'creating-resource-class.ec2.ServiceResource', - boto3.utils.lazy_call( - 'boto3.ec2.createtags.inject_create_tags')) - - self._session.register( - 'creating-resource-class.ec2.Instance', - boto3.utils.lazy_call( - 'boto3.ec2.deletetags.inject_delete_tags', - event_emitter=self.events)) diff --git a/.eggs/boto3-1.7.75-py2.7.egg/boto3/utils.py b/.eggs/boto3-1.7.75-py2.7.egg/boto3/utils.py deleted file mode 100644 index 826d39d6..00000000 --- a/.eggs/boto3-1.7.75-py2.7.egg/boto3/utils.py +++ /dev/null @@ -1,93 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import sys -from collections import namedtuple - - -_ServiceContext = namedtuple( - 'ServiceContext', - ['service_name', 'service_model', 'service_waiter_model', - 'resource_json_definitions'] -) - - -class ServiceContext(_ServiceContext): - """Provides important service-wide, read-only information about a service - - :type service_name: str - :param service_name: The name of the service - - :type service_model: :py:class:`botocore.model.ServiceModel` - :param service_model: The model of the service. - - :type service_waiter_model: :py:class:`botocore.waiter.WaiterModel` or - a waiter model-like object such as - :py:class:`boto3.utils.LazyLoadedWaiterModel` - :param service_waiter_model: The waiter model of the service. - - :type resource_json_definitions: dict - :param resource_json_definitions: The loaded json models of all resource - shapes for a service. It is equivalient of loading a - ``resource-1.json`` and retrieving the value at the key "resources". - """ - pass - - -def import_module(name): - """Import module given a name. - - Does not support relative imports. - - """ - __import__(name) - return sys.modules[name] - - -def lazy_call(full_name, **kwargs): - parent_kwargs = kwargs - - def _handler(**kwargs): - module, function_name = full_name.rsplit('.', 1) - module = import_module(module) - kwargs.update(parent_kwargs) - return getattr(module, function_name)(**kwargs) - - return _handler - - -def inject_attribute(class_attributes, name, value): - if name in class_attributes: - raise RuntimeError( - 'Cannot inject class attribute "%s", attribute ' - 'already exists in class dict.' % name) - else: - class_attributes[name] = value - - -class LazyLoadedWaiterModel(object): - """A lazily loaded waiter model - - This does not load the service waiter model until an attempt is made - to retrieve the waiter model for a specific waiter. This is helpful - in docstring generation where we do not need to actually need to grab - the waiter-2.json until it is accessed through a ``get_waiter`` call - when the docstring is generated/accessed. - """ - def __init__(self, bc_session, service_name, api_version): - self._session = bc_session - self._service_name = service_name - self._api_version = api_version - - def get_waiter(self, waiter_name): - return self._session.get_waiter_model( - self._service_name, self._api_version).get_waiter(waiter_name) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/PKG-INFO b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/PKG-INFO deleted file mode 100644 index 9c551dba..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/PKG-INFO +++ /dev/null @@ -1,58 +0,0 @@ -Metadata-Version: 1.1 -Name: botocore -Version: 1.10.75 -Summary: Low-level, data-driven core of boto 3. -Home-page: https://github.com/boto/botocore -Author: Amazon Web Services -Author-email: UNKNOWN -License: Apache License 2.0 -Description: botocore - ======== - - .. image:: https://secure.travis-ci.org/boto/botocore.png?branch=develop - :target: http://travis-ci.org/boto/botocore - - .. image:: https://codecov.io/github/boto/botocore/coverage.svg?branch=develop - :target: https://codecov.io/github/boto/botocore?branch=develop - - - A low-level interface to a growing number of Amazon Web Services. The - botocore package is the foundation for the - `AWS CLI `__ as well as - `boto3 `__. - - - Documentation - ------------- - Documentation for ``botocore`` can be found on `Read the Docs `__. - - - Getting Help - ------------ - - We use GitHub issues for tracking bugs and feature requests and have limited - bandwidth to address them. Please use these community resources for getting - help. Please note many of the same resources available for ``boto3`` are - applicable for ``botocore``: - - * Ask a question on `Stack Overflow `__ and tag it with `boto3 `__ - * Come join the AWS Python community chat on `gitter `__ - * Open a support ticket with `AWS Support `__ - * If it turns out that you may have found a bug, please `open an issue `__ - -Platform: UNKNOWN -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: Intended Audience :: System Administrators -Classifier: Natural Language :: English -Classifier: License :: OSI Approved :: Apache Software License -Classifier: Programming Language :: Python -Classifier: Programming Language :: Python :: 2 -Classifier: Programming Language :: Python :: 2.6 -Classifier: Programming Language :: Python :: 2.7 -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.3 -Classifier: Programming Language :: Python :: 3.4 -Classifier: Programming Language :: Python :: 3.5 -Classifier: Programming Language :: Python :: 3.6 -Classifier: Programming Language :: Python :: 3.7 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/SOURCES.txt b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/SOURCES.txt deleted file mode 100644 index 6fa02622..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/SOURCES.txt +++ /dev/null @@ -1,1468 +0,0 @@ -LICENSE.txt -MANIFEST.in -README.rst -requirements.txt -setup.cfg -setup.py -botocore/__init__.py -botocore/args.py -botocore/auth.py -botocore/awsrequest.py -botocore/client.py -botocore/compat.py -botocore/config.py -botocore/configloader.py -botocore/credentials.py -botocore/endpoint.py -botocore/errorfactory.py -botocore/eventstream.py -botocore/exceptions.py -botocore/handlers.py -botocore/history.py -botocore/hooks.py -botocore/loaders.py -botocore/model.py -botocore/paginate.py -botocore/parsers.py -botocore/regions.py -botocore/response.py -botocore/retryhandler.py -botocore/serialize.py -botocore/session.py -botocore/signers.py -botocore/stub.py -botocore/translate.py -botocore/utils.py -botocore/validate.py -botocore/waiter.py -botocore.egg-info/PKG-INFO -botocore.egg-info/SOURCES.txt -botocore.egg-info/dependency_links.txt -botocore.egg-info/requires.txt -botocore.egg-info/top_level.txt -botocore/data/_retry.json -botocore/data/endpoints.json -botocore/data/acm-pca/2017-08-22/paginators-1.json -botocore/data/acm-pca/2017-08-22/service-2.json -botocore/data/acm/2015-12-08/examples-1.json -botocore/data/acm/2015-12-08/paginators-1.json -botocore/data/acm/2015-12-08/service-2.json -botocore/data/acm/2015-12-08/waiters-2.json -botocore/data/alexaforbusiness/2017-11-09/paginators-1.json -botocore/data/alexaforbusiness/2017-11-09/service-2.json -botocore/data/apigateway/2015-07-09/examples-1.json -botocore/data/apigateway/2015-07-09/paginators-1.json -botocore/data/apigateway/2015-07-09/service-2.json -botocore/data/application-autoscaling/2016-02-06/examples-1.json -botocore/data/application-autoscaling/2016-02-06/paginators-1.json -botocore/data/application-autoscaling/2016-02-06/service-2.json -botocore/data/appstream/2016-12-01/examples-1.json -botocore/data/appstream/2016-12-01/paginators-1.json -botocore/data/appstream/2016-12-01/service-2.json -botocore/data/appstream/2016-12-01/waiters-2.json -botocore/data/appsync/2017-07-25/paginators-1.json -botocore/data/appsync/2017-07-25/service-2.json -botocore/data/athena/2017-05-18/paginators-1.json -botocore/data/athena/2017-05-18/service-2.json -botocore/data/autoscaling-plans/2018-01-06/paginators-1.json -botocore/data/autoscaling-plans/2018-01-06/service-2.json -botocore/data/autoscaling/2011-01-01/examples-1.json -botocore/data/autoscaling/2011-01-01/paginators-1.json -botocore/data/autoscaling/2011-01-01/service-2.json -botocore/data/batch/2016-08-10/examples-1.json -botocore/data/batch/2016-08-10/paginators-1.json -botocore/data/batch/2016-08-10/service-2.json -botocore/data/budgets/2016-10-20/examples-1.json -botocore/data/budgets/2016-10-20/paginators-1.json -botocore/data/budgets/2016-10-20/service-2.json -botocore/data/ce/2017-10-25/paginators-1.json -botocore/data/ce/2017-10-25/service-2.json -botocore/data/cloud9/2017-09-23/paginators-1.json -botocore/data/cloud9/2017-09-23/service-2.json -botocore/data/clouddirectory/2016-05-10/paginators-1.json -botocore/data/clouddirectory/2016-05-10/service-2.json -botocore/data/clouddirectory/2017-01-11/paginators-1.json -botocore/data/clouddirectory/2017-01-11/service-2.json -botocore/data/cloudformation/2010-05-15/examples-1.json -botocore/data/cloudformation/2010-05-15/paginators-1.json -botocore/data/cloudformation/2010-05-15/service-2.json -botocore/data/cloudformation/2010-05-15/waiters-2.json -botocore/data/cloudfront/2014-05-31/paginators-1.json -botocore/data/cloudfront/2014-05-31/service-2.json -botocore/data/cloudfront/2014-05-31/waiters-2.json -botocore/data/cloudfront/2014-10-21/paginators-1.json -botocore/data/cloudfront/2014-10-21/service-2.json -botocore/data/cloudfront/2014-10-21/waiters-2.json -botocore/data/cloudfront/2014-11-06/paginators-1.json -botocore/data/cloudfront/2014-11-06/service-2.json -botocore/data/cloudfront/2014-11-06/waiters-2.json -botocore/data/cloudfront/2015-04-17/paginators-1.json -botocore/data/cloudfront/2015-04-17/service-2.json -botocore/data/cloudfront/2015-04-17/waiters-2.json -botocore/data/cloudfront/2015-07-27/paginators-1.json -botocore/data/cloudfront/2015-07-27/service-2.json -botocore/data/cloudfront/2015-07-27/waiters-2.json -botocore/data/cloudfront/2015-09-17/paginators-1.json -botocore/data/cloudfront/2015-09-17/service-2.json -botocore/data/cloudfront/2015-09-17/waiters-2.json -botocore/data/cloudfront/2016-01-13/paginators-1.json -botocore/data/cloudfront/2016-01-13/service-2.json -botocore/data/cloudfront/2016-01-13/waiters-2.json -botocore/data/cloudfront/2016-01-28/paginators-1.json -botocore/data/cloudfront/2016-01-28/service-2.json -botocore/data/cloudfront/2016-01-28/waiters-2.json -botocore/data/cloudfront/2016-08-01/paginators-1.json -botocore/data/cloudfront/2016-08-01/service-2.json -botocore/data/cloudfront/2016-08-01/waiters-2.json -botocore/data/cloudfront/2016-08-20/paginators-1.json -botocore/data/cloudfront/2016-08-20/service-2.json -botocore/data/cloudfront/2016-08-20/waiters-2.json -botocore/data/cloudfront/2016-09-07/paginators-1.json -botocore/data/cloudfront/2016-09-07/service-2.json -botocore/data/cloudfront/2016-09-07/waiters-2.json -botocore/data/cloudfront/2016-09-29/paginators-1.json -botocore/data/cloudfront/2016-09-29/service-2.json -botocore/data/cloudfront/2016-09-29/waiters-2.json -botocore/data/cloudfront/2016-11-25/examples-1.json -botocore/data/cloudfront/2016-11-25/paginators-1.json -botocore/data/cloudfront/2016-11-25/service-2.json -botocore/data/cloudfront/2016-11-25/waiters-2.json -botocore/data/cloudfront/2017-03-25/examples-1.json -botocore/data/cloudfront/2017-03-25/paginators-1.json -botocore/data/cloudfront/2017-03-25/service-2.json -botocore/data/cloudfront/2017-03-25/waiters-2.json -botocore/data/cloudfront/2017-10-30/examples-1.json -botocore/data/cloudfront/2017-10-30/paginators-1.json -botocore/data/cloudfront/2017-10-30/service-2.json -botocore/data/cloudfront/2017-10-30/waiters-2.json -botocore/data/cloudhsm/2014-05-30/examples-1.json -botocore/data/cloudhsm/2014-05-30/paginators-1.json -botocore/data/cloudhsm/2014-05-30/service-2.json -botocore/data/cloudhsmv2/2017-04-28/paginators-1.json -botocore/data/cloudhsmv2/2017-04-28/service-2.json -botocore/data/cloudsearch/2011-02-01/service-2.json -botocore/data/cloudsearch/2013-01-01/paginators-1.json -botocore/data/cloudsearch/2013-01-01/service-2.json -botocore/data/cloudsearchdomain/2013-01-01/examples-1.json -botocore/data/cloudsearchdomain/2013-01-01/service-2.json -botocore/data/cloudtrail/2013-11-01/examples-1.json -botocore/data/cloudtrail/2013-11-01/paginators-1.json -botocore/data/cloudtrail/2013-11-01/service-2.json -botocore/data/cloudwatch/2010-08-01/examples-1.json -botocore/data/cloudwatch/2010-08-01/paginators-1.json -botocore/data/cloudwatch/2010-08-01/service-2.json -botocore/data/cloudwatch/2010-08-01/waiters-2.json -botocore/data/codebuild/2016-10-06/examples-1.json -botocore/data/codebuild/2016-10-06/paginators-1.json -botocore/data/codebuild/2016-10-06/service-2.json -botocore/data/codecommit/2015-04-13/examples-1.json -botocore/data/codecommit/2015-04-13/paginators-1.json -botocore/data/codecommit/2015-04-13/service-2.json -botocore/data/codedeploy/2014-10-06/examples-1.json -botocore/data/codedeploy/2014-10-06/paginators-1.json -botocore/data/codedeploy/2014-10-06/service-2.json -botocore/data/codedeploy/2014-10-06/waiters-2.json -botocore/data/codepipeline/2015-07-09/examples-1.json -botocore/data/codepipeline/2015-07-09/paginators-1.json -botocore/data/codepipeline/2015-07-09/service-2.json -botocore/data/codestar/2017-04-19/paginators-1.json -botocore/data/codestar/2017-04-19/service-2.json -botocore/data/cognito-identity/2014-06-30/examples-1.json -botocore/data/cognito-identity/2014-06-30/paginators-1.json -botocore/data/cognito-identity/2014-06-30/service-2.json -botocore/data/cognito-idp/2016-04-18/examples-1.json -botocore/data/cognito-idp/2016-04-18/paginators-1.json -botocore/data/cognito-idp/2016-04-18/service-2.json -botocore/data/cognito-sync/2014-06-30/service-2.json -botocore/data/comprehend/2017-11-27/paginators-1.json -botocore/data/comprehend/2017-11-27/service-2.json -botocore/data/config/2014-11-12/examples-1.json -botocore/data/config/2014-11-12/paginators-1.json -botocore/data/config/2014-11-12/service-2.json -botocore/data/connect/2017-08-08/paginators-1.json -botocore/data/connect/2017-08-08/service-2.json -botocore/data/cur/2017-01-06/examples-1.json -botocore/data/cur/2017-01-06/paginators-1.json -botocore/data/cur/2017-01-06/service-2.json -botocore/data/datapipeline/2012-10-29/paginators-1.json -botocore/data/datapipeline/2012-10-29/service-2.json -botocore/data/dax/2017-04-19/paginators-1.json -botocore/data/dax/2017-04-19/service-2.json -botocore/data/devicefarm/2015-06-23/examples-1.json -botocore/data/devicefarm/2015-06-23/paginators-1.json -botocore/data/devicefarm/2015-06-23/service-2.json -botocore/data/directconnect/2012-10-25/examples-1.json -botocore/data/directconnect/2012-10-25/paginators-1.json -botocore/data/directconnect/2012-10-25/service-2.json -botocore/data/discovery/2015-11-01/examples-1.json -botocore/data/discovery/2015-11-01/paginators-1.json -botocore/data/discovery/2015-11-01/service-2.json -botocore/data/dlm/2018-01-12/paginators-1.json -botocore/data/dlm/2018-01-12/service-2.json -botocore/data/dms/2016-01-01/examples-1.json -botocore/data/dms/2016-01-01/paginators-1.json -botocore/data/dms/2016-01-01/service-2.json -botocore/data/ds/2015-04-16/examples-1.json -botocore/data/ds/2015-04-16/paginators-1.json -botocore/data/ds/2015-04-16/service-2.json -botocore/data/dynamodb/2012-08-10/examples-1.json -botocore/data/dynamodb/2012-08-10/paginators-1.json -botocore/data/dynamodb/2012-08-10/service-2.json -botocore/data/dynamodb/2012-08-10/waiters-2.json -botocore/data/dynamodbstreams/2012-08-10/examples-1.json -botocore/data/dynamodbstreams/2012-08-10/paginators-1.json -botocore/data/dynamodbstreams/2012-08-10/service-2.json -botocore/data/ec2/2014-09-01/paginators-1.json -botocore/data/ec2/2014-09-01/service-2.json -botocore/data/ec2/2014-09-01/waiters-2.json -botocore/data/ec2/2014-10-01/paginators-1.json -botocore/data/ec2/2014-10-01/service-2.json -botocore/data/ec2/2014-10-01/waiters-2.json -botocore/data/ec2/2015-03-01/paginators-1.json -botocore/data/ec2/2015-03-01/service-2.json -botocore/data/ec2/2015-03-01/waiters-2.json -botocore/data/ec2/2015-04-15/paginators-1.json -botocore/data/ec2/2015-04-15/service-2.json -botocore/data/ec2/2015-04-15/waiters-2.json -botocore/data/ec2/2015-10-01/paginators-1.json -botocore/data/ec2/2015-10-01/service-2.json -botocore/data/ec2/2015-10-01/waiters-2.json -botocore/data/ec2/2016-04-01/paginators-1.json -botocore/data/ec2/2016-04-01/service-2.json -botocore/data/ec2/2016-04-01/waiters-2.json -botocore/data/ec2/2016-09-15/examples-1.json -botocore/data/ec2/2016-09-15/paginators-1.json -botocore/data/ec2/2016-09-15/service-2.json -botocore/data/ec2/2016-09-15/waiters-2.json -botocore/data/ec2/2016-11-15/examples-1.json -botocore/data/ec2/2016-11-15/paginators-1.json -botocore/data/ec2/2016-11-15/service-2.json -botocore/data/ec2/2016-11-15/waiters-2.json -botocore/data/ecr/2015-09-21/examples-1.json -botocore/data/ecr/2015-09-21/paginators-1.json -botocore/data/ecr/2015-09-21/service-2.json -botocore/data/ecs/2014-11-13/examples-1.json -botocore/data/ecs/2014-11-13/paginators-1.json -botocore/data/ecs/2014-11-13/service-2.json -botocore/data/ecs/2014-11-13/waiters-2.json -botocore/data/efs/2015-02-01/examples-1.json -botocore/data/efs/2015-02-01/paginators-1.json -botocore/data/efs/2015-02-01/service-2.json -botocore/data/eks/2017-11-01/paginators-1.json -botocore/data/eks/2017-11-01/service-2.json -botocore/data/elasticache/2014-09-30/paginators-1.json -botocore/data/elasticache/2014-09-30/service-2.json -botocore/data/elasticache/2014-09-30/waiters-2.json -botocore/data/elasticache/2015-02-02/paginators-1.json -botocore/data/elasticache/2015-02-02/service-2.json -botocore/data/elasticache/2015-02-02/waiters-2.json -botocore/data/elasticbeanstalk/2010-12-01/examples-1.json -botocore/data/elasticbeanstalk/2010-12-01/paginators-1.json -botocore/data/elasticbeanstalk/2010-12-01/service-2.json -botocore/data/elastictranscoder/2012-09-25/examples-1.json -botocore/data/elastictranscoder/2012-09-25/paginators-1.json -botocore/data/elastictranscoder/2012-09-25/service-2.json -botocore/data/elastictranscoder/2012-09-25/waiters-2.json -botocore/data/elb/2012-06-01/examples-1.json -botocore/data/elb/2012-06-01/paginators-1.json -botocore/data/elb/2012-06-01/service-2.json -botocore/data/elb/2012-06-01/waiters-2.json -botocore/data/elbv2/2015-12-01/examples-1.json -botocore/data/elbv2/2015-12-01/paginators-1.json -botocore/data/elbv2/2015-12-01/service-2.json -botocore/data/elbv2/2015-12-01/waiters-2.json -botocore/data/emr/2009-03-31/examples-1.json -botocore/data/emr/2009-03-31/paginators-1.json -botocore/data/emr/2009-03-31/service-2.json -botocore/data/emr/2009-03-31/waiters-2.json -botocore/data/es/2015-01-01/paginators-1.json -botocore/data/es/2015-01-01/service-2.json -botocore/data/events/2014-02-03/service-2.json -botocore/data/events/2015-10-07/examples-1.json -botocore/data/events/2015-10-07/paginators-1.json -botocore/data/events/2015-10-07/service-2.json -botocore/data/firehose/2015-08-04/examples-1.json -botocore/data/firehose/2015-08-04/paginators-1.json -botocore/data/firehose/2015-08-04/service-2.json -botocore/data/fms/2018-01-01/paginators-1.json -botocore/data/fms/2018-01-01/service-2.json -botocore/data/gamelift/2015-10-01/examples-1.json -botocore/data/gamelift/2015-10-01/paginators-1.json -botocore/data/gamelift/2015-10-01/service-2.json -botocore/data/glacier/2012-06-01/examples-1.json -botocore/data/glacier/2012-06-01/paginators-1.json -botocore/data/glacier/2012-06-01/service-2.json -botocore/data/glacier/2012-06-01/waiters-2.json -botocore/data/glue/2017-03-31/paginators-1.json -botocore/data/glue/2017-03-31/service-2.json -botocore/data/greengrass/2017-06-07/service-2.json -botocore/data/guardduty/2017-11-28/paginators-1.json -botocore/data/guardduty/2017-11-28/service-2.json -botocore/data/health/2016-08-04/examples-1.json -botocore/data/health/2016-08-04/paginators-1.json -botocore/data/health/2016-08-04/service-2.json -botocore/data/iam/2010-05-08/examples-1.json -botocore/data/iam/2010-05-08/paginators-1.json -botocore/data/iam/2010-05-08/service-2.json -botocore/data/iam/2010-05-08/waiters-2.json -botocore/data/importexport/2010-06-01/paginators-1.json -botocore/data/importexport/2010-06-01/service-2.json -botocore/data/inspector/2015-08-18/service-2.json -botocore/data/inspector/2016-02-16/examples-1.json -botocore/data/inspector/2016-02-16/paginators-1.json -botocore/data/inspector/2016-02-16/service-2.json -botocore/data/iot-data/2015-05-28/service-2.json -botocore/data/iot-jobs-data/2017-09-29/paginators-1.json -botocore/data/iot-jobs-data/2017-09-29/service-2.json -botocore/data/iot/2015-05-28/examples-1.json -botocore/data/iot/2015-05-28/paginators-1.json -botocore/data/iot/2015-05-28/service-2.json -botocore/data/iot1click-devices/2018-05-14/service-2.json -botocore/data/iot1click-projects/2018-05-14/paginators-1.json -botocore/data/iot1click-projects/2018-05-14/service-2.json -botocore/data/iotanalytics/2017-11-27/paginators-1.json -botocore/data/iotanalytics/2017-11-27/service-2.json -botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json -botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json -botocore/data/kinesis-video-media/2017-09-30/paginators-1.json -botocore/data/kinesis-video-media/2017-09-30/service-2.json -botocore/data/kinesis/2013-12-02/examples-1.json -botocore/data/kinesis/2013-12-02/paginators-1.json -botocore/data/kinesis/2013-12-02/service-2.json -botocore/data/kinesis/2013-12-02/waiters-2.json -botocore/data/kinesisanalytics/2015-08-14/examples-1.json -botocore/data/kinesisanalytics/2015-08-14/paginators-1.json -botocore/data/kinesisanalytics/2015-08-14/service-2.json -botocore/data/kinesisvideo/2017-09-30/paginators-1.json -botocore/data/kinesisvideo/2017-09-30/service-2.json -botocore/data/kms/2014-11-01/examples-1.json -botocore/data/kms/2014-11-01/paginators-1.json -botocore/data/kms/2014-11-01/service-2.json -botocore/data/lambda/2014-11-11/service-2.json -botocore/data/lambda/2015-03-31/examples-1.json -botocore/data/lambda/2015-03-31/paginators-1.json -botocore/data/lambda/2015-03-31/service-2.json -botocore/data/lex-models/2017-04-19/paginators-1.json -botocore/data/lex-models/2017-04-19/service-2.json -botocore/data/lex-runtime/2016-11-28/paginators-1.json -botocore/data/lex-runtime/2016-11-28/service-2.json -botocore/data/lightsail/2016-11-28/examples-1.json -botocore/data/lightsail/2016-11-28/paginators-1.json -botocore/data/lightsail/2016-11-28/service-2.json -botocore/data/logs/2014-03-28/examples-1.json -botocore/data/logs/2014-03-28/paginators-1.json -botocore/data/logs/2014-03-28/service-2.json -botocore/data/machinelearning/2014-12-12/examples-1.json -botocore/data/machinelearning/2014-12-12/paginators-1.json -botocore/data/machinelearning/2014-12-12/service-2.json -botocore/data/machinelearning/2014-12-12/waiters-2.json -botocore/data/macie/2017-12-19/paginators-1.json -botocore/data/macie/2017-12-19/service-2.json -botocore/data/marketplace-entitlement/2017-01-11/paginators-1.json -botocore/data/marketplace-entitlement/2017-01-11/service-2.json -botocore/data/marketplacecommerceanalytics/2015-07-01/examples-1.json -botocore/data/marketplacecommerceanalytics/2015-07-01/paginators-1.json -botocore/data/marketplacecommerceanalytics/2015-07-01/service-2.json -botocore/data/mediaconvert/2017-08-29/service-2.json -botocore/data/medialive/2017-10-14/paginators-1.json -botocore/data/medialive/2017-10-14/service-2.json -botocore/data/mediapackage/2017-10-12/paginators-1.json -botocore/data/mediapackage/2017-10-12/service-2.json -botocore/data/mediastore-data/2017-09-01/paginators-1.json -botocore/data/mediastore-data/2017-09-01/service-2.json -botocore/data/mediastore/2017-09-01/paginators-1.json -botocore/data/mediastore/2017-09-01/service-2.json -botocore/data/mediatailor/2018-04-23/paginators-1.json -botocore/data/mediatailor/2018-04-23/service-2.json -botocore/data/meteringmarketplace/2016-01-14/examples-1.json -botocore/data/meteringmarketplace/2016-01-14/service-2.json -botocore/data/mgh/2017-05-31/paginators-1.json -botocore/data/mgh/2017-05-31/service-2.json -botocore/data/mobile/2017-07-01/paginators-1.json -botocore/data/mobile/2017-07-01/service-2.json -botocore/data/mq/2017-11-27/paginators-1.json -botocore/data/mq/2017-11-27/service-2.json -botocore/data/mturk/2017-01-17/paginators-1.json -botocore/data/mturk/2017-01-17/service-2.json -botocore/data/neptune/2014-10-31/paginators-1.json -botocore/data/neptune/2014-10-31/service-2.json -botocore/data/neptune/2014-10-31/waiters-2.json -botocore/data/opsworks/2013-02-18/examples-1.json -botocore/data/opsworks/2013-02-18/paginators-1.json -botocore/data/opsworks/2013-02-18/service-2.json -botocore/data/opsworks/2013-02-18/waiters-2.json -botocore/data/opsworkscm/2016-11-01/examples-1.json -botocore/data/opsworkscm/2016-11-01/paginators-1.json -botocore/data/opsworkscm/2016-11-01/service-2.json -botocore/data/opsworkscm/2016-11-01/waiters-2.json -botocore/data/organizations/2016-11-28/paginators-1.json -botocore/data/organizations/2016-11-28/service-2.json -botocore/data/pi/2018-02-27/paginators-1.json -botocore/data/pi/2018-02-27/service-2.json -botocore/data/pinpoint/2016-12-01/examples-1.json -botocore/data/pinpoint/2016-12-01/service-2.json -botocore/data/polly/2016-06-10/examples-1.json -botocore/data/polly/2016-06-10/paginators-1.json -botocore/data/polly/2016-06-10/service-2.json -botocore/data/pricing/2017-10-15/paginators-1.json -botocore/data/pricing/2017-10-15/service-2.json -botocore/data/rds/2014-09-01/paginators-1.json -botocore/data/rds/2014-09-01/service-2.json -botocore/data/rds/2014-09-01/waiters-2.json -botocore/data/rds/2014-10-31/examples-1.json -botocore/data/rds/2014-10-31/paginators-1.json -botocore/data/rds/2014-10-31/service-2.json -botocore/data/rds/2014-10-31/service-2.sdk-extras.json -botocore/data/rds/2014-10-31/waiters-2.json -botocore/data/redshift/2012-12-01/examples-1.json -botocore/data/redshift/2012-12-01/paginators-1.json -botocore/data/redshift/2012-12-01/service-2.json -botocore/data/redshift/2012-12-01/waiters-2.json -botocore/data/rekognition/2016-06-27/examples-1.json -botocore/data/rekognition/2016-06-27/paginators-1.json -botocore/data/rekognition/2016-06-27/service-2.json -botocore/data/resource-groups/2017-11-27/paginators-1.json -botocore/data/resource-groups/2017-11-27/service-2.json -botocore/data/resourcegroupstaggingapi/2017-01-26/paginators-1.json -botocore/data/resourcegroupstaggingapi/2017-01-26/service-2.json -botocore/data/route53/2013-04-01/examples-1.json -botocore/data/route53/2013-04-01/paginators-1.json -botocore/data/route53/2013-04-01/service-2.json -botocore/data/route53/2013-04-01/waiters-2.json -botocore/data/route53domains/2014-05-15/paginators-1.json -botocore/data/route53domains/2014-05-15/service-2.json -botocore/data/s3/2006-03-01/examples-1.json -botocore/data/s3/2006-03-01/paginators-1.json -botocore/data/s3/2006-03-01/service-2.json -botocore/data/s3/2006-03-01/waiters-2.json -botocore/data/sagemaker-runtime/2017-05-13/paginators-1.json -botocore/data/sagemaker-runtime/2017-05-13/service-2.json -botocore/data/sagemaker/2017-07-24/paginators-1.json -botocore/data/sagemaker/2017-07-24/service-2.json -botocore/data/sagemaker/2017-07-24/waiters-2.json -botocore/data/sdb/2009-04-15/paginators-1.json -botocore/data/sdb/2009-04-15/service-2.json -botocore/data/secretsmanager/2017-10-17/paginators-1.json -botocore/data/secretsmanager/2017-10-17/service-2.json -botocore/data/serverlessrepo/2017-09-08/paginators-1.json -botocore/data/serverlessrepo/2017-09-08/service-2.json -botocore/data/servicecatalog/2015-12-10/examples-1.json -botocore/data/servicecatalog/2015-12-10/paginators-1.json -botocore/data/servicecatalog/2015-12-10/service-2.json -botocore/data/servicediscovery/2017-03-14/paginators-1.json -botocore/data/servicediscovery/2017-03-14/service-2.json -botocore/data/ses/2010-12-01/examples-1.json -botocore/data/ses/2010-12-01/paginators-1.json -botocore/data/ses/2010-12-01/service-2.json -botocore/data/ses/2010-12-01/waiters-2.json -botocore/data/shield/2016-06-02/examples-1.json -botocore/data/shield/2016-06-02/paginators-1.json -botocore/data/shield/2016-06-02/service-2.json -botocore/data/sms/2016-10-24/examples-1.json -botocore/data/sms/2016-10-24/paginators-1.json -botocore/data/sms/2016-10-24/service-2.json -botocore/data/snowball/2016-06-30/examples-1.json -botocore/data/snowball/2016-06-30/paginators-1.json -botocore/data/snowball/2016-06-30/service-2.json -botocore/data/sns/2010-03-31/examples-1.json -botocore/data/sns/2010-03-31/paginators-1.json -botocore/data/sns/2010-03-31/service-2.json -botocore/data/sqs/2012-11-05/examples-1.json -botocore/data/sqs/2012-11-05/paginators-1.json -botocore/data/sqs/2012-11-05/service-2.json -botocore/data/ssm/2014-11-06/examples-1.json -botocore/data/ssm/2014-11-06/paginators-1.json -botocore/data/ssm/2014-11-06/service-2.json -botocore/data/stepfunctions/2016-11-23/examples-1.json -botocore/data/stepfunctions/2016-11-23/paginators-1.json -botocore/data/stepfunctions/2016-11-23/service-2.json -botocore/data/storagegateway/2013-06-30/examples-1.json -botocore/data/storagegateway/2013-06-30/paginators-1.json -botocore/data/storagegateway/2013-06-30/service-2.json -botocore/data/sts/2011-06-15/examples-1.json -botocore/data/sts/2011-06-15/paginators-1.json -botocore/data/sts/2011-06-15/service-2.json -botocore/data/support/2013-04-15/examples-1.json -botocore/data/support/2013-04-15/paginators-1.json -botocore/data/support/2013-04-15/service-2.json -botocore/data/swf/2012-01-25/paginators-1.json -botocore/data/swf/2012-01-25/service-2.json -botocore/data/transcribe/2017-10-26/paginators-1.json -botocore/data/transcribe/2017-10-26/service-2.json -botocore/data/translate/2017-07-01/paginators-1.json -botocore/data/translate/2017-07-01/service-2.json -botocore/data/waf-regional/2016-11-28/examples-1.json -botocore/data/waf-regional/2016-11-28/paginators-1.json -botocore/data/waf-regional/2016-11-28/service-2.json -botocore/data/waf/2015-08-24/examples-1.json -botocore/data/waf/2015-08-24/paginators-1.json -botocore/data/waf/2015-08-24/service-2.json -botocore/data/workdocs/2016-05-01/paginators-1.json -botocore/data/workdocs/2016-05-01/service-2.json -botocore/data/workmail/2017-10-01/paginators-1.json -botocore/data/workmail/2017-10-01/service-2.json -botocore/data/workspaces/2015-04-08/examples-1.json -botocore/data/workspaces/2015-04-08/paginators-1.json -botocore/data/workspaces/2015-04-08/service-2.json -botocore/data/xray/2016-04-12/examples-1.json -botocore/data/xray/2016-04-12/paginators-1.json -botocore/data/xray/2016-04-12/service-2.json -botocore/docs/__init__.py -botocore/docs/client.py -botocore/docs/docstring.py -botocore/docs/example.py -botocore/docs/method.py -botocore/docs/paginator.py -botocore/docs/params.py -botocore/docs/service.py -botocore/docs/shape.py -botocore/docs/sharedexample.py -botocore/docs/utils.py -botocore/docs/waiter.py -botocore/docs/bcdoc/__init__.py -botocore/docs/bcdoc/docevents.py -botocore/docs/bcdoc/docstringparser.py -botocore/docs/bcdoc/restdoc.py -botocore/docs/bcdoc/style.py -botocore/docs/bcdoc/textwriter.py -botocore/vendored/__init__.py -botocore/vendored/six.py -botocore/vendored/requests/__init__.py -botocore/vendored/requests/adapters.py -botocore/vendored/requests/api.py -botocore/vendored/requests/auth.py -botocore/vendored/requests/cacert.pem -botocore/vendored/requests/certs.py -botocore/vendored/requests/compat.py -botocore/vendored/requests/cookies.py -botocore/vendored/requests/exceptions.py -botocore/vendored/requests/hooks.py -botocore/vendored/requests/models.py -botocore/vendored/requests/sessions.py -botocore/vendored/requests/status_codes.py -botocore/vendored/requests/structures.py -botocore/vendored/requests/utils.py -botocore/vendored/requests/packages/__init__.py -botocore/vendored/requests/packages/chardet/__init__.py -botocore/vendored/requests/packages/chardet/big5freq.py -botocore/vendored/requests/packages/chardet/big5prober.py -botocore/vendored/requests/packages/chardet/chardetect.py -botocore/vendored/requests/packages/chardet/chardistribution.py -botocore/vendored/requests/packages/chardet/charsetgroupprober.py -botocore/vendored/requests/packages/chardet/charsetprober.py -botocore/vendored/requests/packages/chardet/codingstatemachine.py -botocore/vendored/requests/packages/chardet/compat.py -botocore/vendored/requests/packages/chardet/constants.py -botocore/vendored/requests/packages/chardet/cp949prober.py -botocore/vendored/requests/packages/chardet/escprober.py -botocore/vendored/requests/packages/chardet/escsm.py -botocore/vendored/requests/packages/chardet/eucjpprober.py -botocore/vendored/requests/packages/chardet/euckrfreq.py -botocore/vendored/requests/packages/chardet/euckrprober.py -botocore/vendored/requests/packages/chardet/euctwfreq.py -botocore/vendored/requests/packages/chardet/euctwprober.py -botocore/vendored/requests/packages/chardet/gb2312freq.py -botocore/vendored/requests/packages/chardet/gb2312prober.py -botocore/vendored/requests/packages/chardet/hebrewprober.py -botocore/vendored/requests/packages/chardet/jisfreq.py -botocore/vendored/requests/packages/chardet/jpcntx.py -botocore/vendored/requests/packages/chardet/langbulgarianmodel.py -botocore/vendored/requests/packages/chardet/langcyrillicmodel.py -botocore/vendored/requests/packages/chardet/langgreekmodel.py -botocore/vendored/requests/packages/chardet/langhebrewmodel.py -botocore/vendored/requests/packages/chardet/langhungarianmodel.py -botocore/vendored/requests/packages/chardet/langthaimodel.py -botocore/vendored/requests/packages/chardet/latin1prober.py -botocore/vendored/requests/packages/chardet/mbcharsetprober.py -botocore/vendored/requests/packages/chardet/mbcsgroupprober.py -botocore/vendored/requests/packages/chardet/mbcssm.py -botocore/vendored/requests/packages/chardet/sbcharsetprober.py -botocore/vendored/requests/packages/chardet/sbcsgroupprober.py -botocore/vendored/requests/packages/chardet/sjisprober.py -botocore/vendored/requests/packages/chardet/universaldetector.py -botocore/vendored/requests/packages/chardet/utf8prober.py -botocore/vendored/requests/packages/urllib3/__init__.py -botocore/vendored/requests/packages/urllib3/_collections.py -botocore/vendored/requests/packages/urllib3/connection.py -botocore/vendored/requests/packages/urllib3/connectionpool.py -botocore/vendored/requests/packages/urllib3/exceptions.py -botocore/vendored/requests/packages/urllib3/fields.py -botocore/vendored/requests/packages/urllib3/filepost.py -botocore/vendored/requests/packages/urllib3/poolmanager.py -botocore/vendored/requests/packages/urllib3/request.py -botocore/vendored/requests/packages/urllib3/response.py -botocore/vendored/requests/packages/urllib3/contrib/__init__.py -botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.py -botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.py -botocore/vendored/requests/packages/urllib3/packages/__init__.py -botocore/vendored/requests/packages/urllib3/packages/ordered_dict.py -botocore/vendored/requests/packages/urllib3/packages/six.py -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.py -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.py -botocore/vendored/requests/packages/urllib3/util/__init__.py -botocore/vendored/requests/packages/urllib3/util/connection.py -botocore/vendored/requests/packages/urllib3/util/request.py -botocore/vendored/requests/packages/urllib3/util/response.py -botocore/vendored/requests/packages/urllib3/util/retry.py -botocore/vendored/requests/packages/urllib3/util/ssl_.py -botocore/vendored/requests/packages/urllib3/util/timeout.py -botocore/vendored/requests/packages/urllib3/util/url.py -docs/Makefile -docs/make.bat -docs/source/client_upgrades.rst -docs/source/conf.py -docs/source/index.rst -docs/source/development/changesfor10.rst -docs/source/development/designnotes.rst -docs/source/development/index.rst -docs/source/reference/config.rst -docs/source/reference/eventstream.rst -docs/source/reference/index.rst -docs/source/reference/loaders.rst -docs/source/reference/response.rst -docs/source/reference/stubber.rst -docs/source/topics/events.rst -docs/source/topics/index.rst -docs/source/topics/paginators.rst -docs/source/tutorial/index.rst -tests/__init__.py -tests/cmd-runner -tests/acceptance/features/environment.py -tests/acceptance/features/smoke/acm/acm.feature -tests/acceptance/features/smoke/autoscaling/autoscaling.feature -tests/acceptance/features/smoke/cloudformation/cloudformation.feature -tests/acceptance/features/smoke/cloudfront/cloudfront.feature -tests/acceptance/features/smoke/cloudhsm/cloudhsm.feature -tests/acceptance/features/smoke/cloudsearch/cloudsearch.feature -tests/acceptance/features/smoke/cloudtrail/cloudtrail.feature -tests/acceptance/features/smoke/cloudwatch/cloudwatch.feature -tests/acceptance/features/smoke/cloudwatchlogs/cloudwatchlogs.feature -tests/acceptance/features/smoke/codecommit/codecommit.feature -tests/acceptance/features/smoke/codedeploy/codedeploy.feature -tests/acceptance/features/smoke/codepipeline/codepipeline.feature -tests/acceptance/features/smoke/cognitoidentity/cognitoidentity.feature -tests/acceptance/features/smoke/cognitosync/cognitosync.feature -tests/acceptance/features/smoke/configservice/configservice.feature -tests/acceptance/features/smoke/datapipeline/datapipeline.feature -tests/acceptance/features/smoke/devicefarm/devicefarm.feature -tests/acceptance/features/smoke/directconnect/directconnect.feature -tests/acceptance/features/smoke/directoryservice/directoryservice.feature -tests/acceptance/features/smoke/dynamodb/dynamodb.feature -tests/acceptance/features/smoke/dynamodbstreams/dynamodbstreams.feature -tests/acceptance/features/smoke/ec2/ec2.feature -tests/acceptance/features/smoke/ecs/ecs.feature -tests/acceptance/features/smoke/efs/efs.feature -tests/acceptance/features/smoke/elasticache/elasticache.feature -tests/acceptance/features/smoke/elasticbeanstalk/elasticbeanstalk.feature -tests/acceptance/features/smoke/elasticloadbalancing/elasticloadbalancing.feature -tests/acceptance/features/smoke/elastictranscoder/elastictranscoder.feature -tests/acceptance/features/smoke/emr/emr.feature -tests/acceptance/features/smoke/es/es.feature -tests/acceptance/features/smoke/glacier/glacier.feature -tests/acceptance/features/smoke/iam/iam.feature -tests/acceptance/features/smoke/importexport/importexport.feature -tests/acceptance/features/smoke/kinesis/kinesis.feature -tests/acceptance/features/smoke/kms/kms.feature -tests/acceptance/features/smoke/lambda/lambda.feature -tests/acceptance/features/smoke/machinelearning/machinelearning.feature -tests/acceptance/features/smoke/opsworks/opsworks.feature -tests/acceptance/features/smoke/rds/rds.feature -tests/acceptance/features/smoke/redshift/redshift.feature -tests/acceptance/features/smoke/route53/route53.feature -tests/acceptance/features/smoke/route53domains/route53domains.feature -tests/acceptance/features/smoke/ses/ses.feature -tests/acceptance/features/smoke/sns/sns.feature -tests/acceptance/features/smoke/sqs/sqs.feature -tests/acceptance/features/smoke/ssm/ssm.feature -tests/acceptance/features/smoke/storagegateway/storagegateway.feature -tests/acceptance/features/smoke/sts/sts.feature -tests/acceptance/features/smoke/support/support.feature -tests/acceptance/features/smoke/swf/swf.feature -tests/acceptance/features/smoke/waf/waf.feature -tests/acceptance/features/smoke/workspaces/workspaces.feature -tests/acceptance/features/steps/base.py -tests/functional/__init__.py -tests/functional/test_alias.py -tests/functional/test_apigateway.py -tests/functional/test_client_class_names.py -tests/functional/test_client_metadata.py -tests/functional/test_cloudformation.py -tests/functional/test_cloudsearchdomain.py -tests/functional/test_cognito_idp.py -tests/functional/test_credentials.py -tests/functional/test_ec2.py -tests/functional/test_endpoints.py -tests/functional/test_h2_required.py -tests/functional/test_history.py -tests/functional/test_iot_data.py -tests/functional/test_kinesis.py -tests/functional/test_lex.py -tests/functional/test_loaders.py -tests/functional/test_machinelearning.py -tests/functional/test_model_completeness.py -tests/functional/test_mturk.py -tests/functional/test_paginate.py -tests/functional/test_paginator_config.py -tests/functional/test_public_apis.py -tests/functional/test_rds.py -tests/functional/test_regions.py -tests/functional/test_retry.py -tests/functional/test_route53.py -tests/functional/test_s3.py -tests/functional/test_service_alias.py -tests/functional/test_service_names.py -tests/functional/test_session.py -tests/functional/test_six_imports.py -tests/functional/test_six_threading.py -tests/functional/test_sts.py -tests/functional/test_stub.py -tests/functional/test_waiter_config.py -tests/functional/docs/__init__.py -tests/functional/docs/test_alias.py -tests/functional/docs/test_autoscaling.py -tests/functional/docs/test_ec2.py -tests/functional/docs/test_glacier.py -tests/functional/docs/test_lex.py -tests/functional/docs/test_s3.py -tests/functional/docs/test_shared_example_config.py -tests/functional/docs/test_streaming_body.py -tests/functional/leak/__init__.py -tests/functional/leak/test_resource_leaks.py -tests/functional/utils/__init__.py -tests/functional/utils/credentialprocess.py -tests/integration/__init__.py -tests/integration/test-credentials -tests/integration/test_apigateway.py -tests/integration/test_client.py -tests/integration/test_cloudformation.py -tests/integration/test_cognito_identity.py -tests/integration/test_credentials.py -tests/integration/test_ec2.py -tests/integration/test_elastictranscoder.py -tests/integration/test_emr.py -tests/integration/test_glacier.py -tests/integration/test_kinesis.py -tests/integration/test_loaders.py -tests/integration/test_rds.py -tests/integration/test_route53.py -tests/integration/test_s3.py -tests/integration/test_session.py -tests/integration/test_smoke.py -tests/integration/test_sts.py -tests/integration/test_utils.py -tests/integration/test_waiters.py -tests/unit/__init__.py -tests/unit/put_object_data -tests/unit/test_args.py -tests/unit/test_awsrequest.py -tests/unit/test_client.py -tests/unit/test_compat.py -tests/unit/test_configloader.py -tests/unit/test_credentials.py -tests/unit/test_endpoint.py -tests/unit/test_errorfactory.py -tests/unit/test_eventstream.py -tests/unit/test_exceptions.py -tests/unit/test_handlers.py -tests/unit/test_history.py -tests/unit/test_hooks.py -tests/unit/test_idempotency.py -tests/unit/test_loaders.py -tests/unit/test_model.py -tests/unit/test_paginate.py -tests/unit/test_parsers.py -tests/unit/test_protocols.py -tests/unit/test_regions.py -tests/unit/test_response.py -tests/unit/test_retryhandler.py -tests/unit/test_s3_addressing.py -tests/unit/test_serialize.py -tests/unit/test_session.py -tests/unit/test_signers.py -tests/unit/test_stub.py -tests/unit/test_translate.py -tests/unit/test_utils.py -tests/unit/test_validate.py -tests/unit/test_waiters.py -tests/unit/auth/__init__.py -tests/unit/auth/test_signers.py -tests/unit/auth/test_sigv4.py -tests/unit/auth/aws4_testsuite/get-header-key-duplicate.authz -tests/unit/auth/aws4_testsuite/get-header-key-duplicate.creq -tests/unit/auth/aws4_testsuite/get-header-key-duplicate.req -tests/unit/auth/aws4_testsuite/get-header-key-duplicate.sreq -tests/unit/auth/aws4_testsuite/get-header-key-duplicate.sts -tests/unit/auth/aws4_testsuite/get-header-value-order.authz -tests/unit/auth/aws4_testsuite/get-header-value-order.creq -tests/unit/auth/aws4_testsuite/get-header-value-order.req -tests/unit/auth/aws4_testsuite/get-header-value-order.sreq -tests/unit/auth/aws4_testsuite/get-header-value-order.sts -tests/unit/auth/aws4_testsuite/get-header-value-trim.authz -tests/unit/auth/aws4_testsuite/get-header-value-trim.creq -tests/unit/auth/aws4_testsuite/get-header-value-trim.req -tests/unit/auth/aws4_testsuite/get-header-value-trim.sreq -tests/unit/auth/aws4_testsuite/get-header-value-trim.sts -tests/unit/auth/aws4_testsuite/get-relative-relative.authz -tests/unit/auth/aws4_testsuite/get-relative-relative.creq -tests/unit/auth/aws4_testsuite/get-relative-relative.req -tests/unit/auth/aws4_testsuite/get-relative-relative.sreq -tests/unit/auth/aws4_testsuite/get-relative-relative.sts -tests/unit/auth/aws4_testsuite/get-relative.authz -tests/unit/auth/aws4_testsuite/get-relative.creq -tests/unit/auth/aws4_testsuite/get-relative.req -tests/unit/auth/aws4_testsuite/get-relative.sreq -tests/unit/auth/aws4_testsuite/get-relative.sts -tests/unit/auth/aws4_testsuite/get-slash-dot-slash.authz -tests/unit/auth/aws4_testsuite/get-slash-dot-slash.creq -tests/unit/auth/aws4_testsuite/get-slash-dot-slash.req -tests/unit/auth/aws4_testsuite/get-slash-dot-slash.sreq -tests/unit/auth/aws4_testsuite/get-slash-dot-slash.sts -tests/unit/auth/aws4_testsuite/get-slash-pointless-dot.authz -tests/unit/auth/aws4_testsuite/get-slash-pointless-dot.creq -tests/unit/auth/aws4_testsuite/get-slash-pointless-dot.req -tests/unit/auth/aws4_testsuite/get-slash-pointless-dot.sreq -tests/unit/auth/aws4_testsuite/get-slash-pointless-dot.sts -tests/unit/auth/aws4_testsuite/get-slash.authz -tests/unit/auth/aws4_testsuite/get-slash.creq -tests/unit/auth/aws4_testsuite/get-slash.req -tests/unit/auth/aws4_testsuite/get-slash.sreq -tests/unit/auth/aws4_testsuite/get-slash.sts -tests/unit/auth/aws4_testsuite/get-slashes.authz -tests/unit/auth/aws4_testsuite/get-slashes.creq -tests/unit/auth/aws4_testsuite/get-slashes.req -tests/unit/auth/aws4_testsuite/get-slashes.sreq -tests/unit/auth/aws4_testsuite/get-slashes.sts -tests/unit/auth/aws4_testsuite/get-space.authz -tests/unit/auth/aws4_testsuite/get-space.creq -tests/unit/auth/aws4_testsuite/get-space.req -tests/unit/auth/aws4_testsuite/get-space.sreq -tests/unit/auth/aws4_testsuite/get-space.sts -tests/unit/auth/aws4_testsuite/get-unreserved.authz -tests/unit/auth/aws4_testsuite/get-unreserved.creq -tests/unit/auth/aws4_testsuite/get-unreserved.req -tests/unit/auth/aws4_testsuite/get-unreserved.sreq -tests/unit/auth/aws4_testsuite/get-unreserved.sts -tests/unit/auth/aws4_testsuite/get-utf8.authz -tests/unit/auth/aws4_testsuite/get-utf8.creq -tests/unit/auth/aws4_testsuite/get-utf8.req -tests/unit/auth/aws4_testsuite/get-utf8.sreq -tests/unit/auth/aws4_testsuite/get-utf8.sts -tests/unit/auth/aws4_testsuite/get-vanilla-empty-query-key.authz -tests/unit/auth/aws4_testsuite/get-vanilla-empty-query-key.creq -tests/unit/auth/aws4_testsuite/get-vanilla-empty-query-key.req -tests/unit/auth/aws4_testsuite/get-vanilla-empty-query-key.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-empty-query-key.sts -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key-case.authz -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key-case.creq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key-case.req -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key-case.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key-case.sts -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key.authz -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key.creq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key.req -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-key.sts -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-value.authz -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-value.creq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-value.req -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-value.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-query-order-value.sts -tests/unit/auth/aws4_testsuite/get-vanilla-query-unreserved.authz -tests/unit/auth/aws4_testsuite/get-vanilla-query-unreserved.creq -tests/unit/auth/aws4_testsuite/get-vanilla-query-unreserved.req -tests/unit/auth/aws4_testsuite/get-vanilla-query-unreserved.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-query-unreserved.sts -tests/unit/auth/aws4_testsuite/get-vanilla-query.authz -tests/unit/auth/aws4_testsuite/get-vanilla-query.creq -tests/unit/auth/aws4_testsuite/get-vanilla-query.req -tests/unit/auth/aws4_testsuite/get-vanilla-query.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-query.sts -tests/unit/auth/aws4_testsuite/get-vanilla-ut8-query.authz -tests/unit/auth/aws4_testsuite/get-vanilla-ut8-query.creq -tests/unit/auth/aws4_testsuite/get-vanilla-ut8-query.req -tests/unit/auth/aws4_testsuite/get-vanilla-ut8-query.sreq -tests/unit/auth/aws4_testsuite/get-vanilla-ut8-query.sts -tests/unit/auth/aws4_testsuite/get-vanilla.authz -tests/unit/auth/aws4_testsuite/get-vanilla.creq -tests/unit/auth/aws4_testsuite/get-vanilla.req -tests/unit/auth/aws4_testsuite/get-vanilla.sreq -tests/unit/auth/aws4_testsuite/get-vanilla.sts -tests/unit/auth/aws4_testsuite/post-header-key-case.authz -tests/unit/auth/aws4_testsuite/post-header-key-case.creq -tests/unit/auth/aws4_testsuite/post-header-key-case.req -tests/unit/auth/aws4_testsuite/post-header-key-case.sreq -tests/unit/auth/aws4_testsuite/post-header-key-case.sts -tests/unit/auth/aws4_testsuite/post-header-key-sort.authz -tests/unit/auth/aws4_testsuite/post-header-key-sort.creq -tests/unit/auth/aws4_testsuite/post-header-key-sort.req -tests/unit/auth/aws4_testsuite/post-header-key-sort.sreq -tests/unit/auth/aws4_testsuite/post-header-key-sort.sts -tests/unit/auth/aws4_testsuite/post-header-value-case.authz -tests/unit/auth/aws4_testsuite/post-header-value-case.creq -tests/unit/auth/aws4_testsuite/post-header-value-case.req -tests/unit/auth/aws4_testsuite/post-header-value-case.sreq -tests/unit/auth/aws4_testsuite/post-header-value-case.sts -tests/unit/auth/aws4_testsuite/post-vanilla-empty-query-value.authz -tests/unit/auth/aws4_testsuite/post-vanilla-empty-query-value.creq -tests/unit/auth/aws4_testsuite/post-vanilla-empty-query-value.req -tests/unit/auth/aws4_testsuite/post-vanilla-empty-query-value.sreq -tests/unit/auth/aws4_testsuite/post-vanilla-empty-query-value.sts -tests/unit/auth/aws4_testsuite/post-vanilla-query-nonunreserved.authz -tests/unit/auth/aws4_testsuite/post-vanilla-query-nonunreserved.creq -tests/unit/auth/aws4_testsuite/post-vanilla-query-nonunreserved.req -tests/unit/auth/aws4_testsuite/post-vanilla-query-nonunreserved.sreq -tests/unit/auth/aws4_testsuite/post-vanilla-query-nonunreserved.sts -tests/unit/auth/aws4_testsuite/post-vanilla-query-space.authz -tests/unit/auth/aws4_testsuite/post-vanilla-query-space.creq -tests/unit/auth/aws4_testsuite/post-vanilla-query-space.req -tests/unit/auth/aws4_testsuite/post-vanilla-query-space.sreq -tests/unit/auth/aws4_testsuite/post-vanilla-query-space.sts -tests/unit/auth/aws4_testsuite/post-vanilla-query.authz -tests/unit/auth/aws4_testsuite/post-vanilla-query.creq -tests/unit/auth/aws4_testsuite/post-vanilla-query.req -tests/unit/auth/aws4_testsuite/post-vanilla-query.sreq -tests/unit/auth/aws4_testsuite/post-vanilla-query.sts -tests/unit/auth/aws4_testsuite/post-vanilla.authz -tests/unit/auth/aws4_testsuite/post-vanilla.creq -tests/unit/auth/aws4_testsuite/post-vanilla.req -tests/unit/auth/aws4_testsuite/post-vanilla.sreq -tests/unit/auth/aws4_testsuite/post-vanilla.sts -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded-parameters.authz -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded-parameters.creq -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded-parameters.req -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded-parameters.sreq -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded-parameters.sts -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded.authz -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded.creq -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded.req -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded.sreq -tests/unit/auth/aws4_testsuite/post-x-www-form-urlencoded.sts -tests/unit/cfg/aws_bad_profile -tests/unit/cfg/aws_config -tests/unit/cfg/aws_config_bad -tests/unit/cfg/aws_config_nested -tests/unit/cfg/aws_config_nested_bad -tests/unit/cfg/aws_config_nocreds -tests/unit/cfg/aws_config_other -tests/unit/cfg/aws_credentials -tests/unit/cfg/aws_third_config -tests/unit/cfg/boto_config -tests/unit/cfg/boto_config_empty -tests/unit/cfg/foo_config -tests/unit/data/baz.json -tests/unit/data/foo.json -tests/unit/data/non_ascii.json -tests/unit/data/aws/s3/2006-03-01.normal.json -tests/unit/data/someservice/2012-10-01.normal.json -tests/unit/data/someservice/2013-08-21.normal.json -tests/unit/data/sub/fie.normal.json -tests/unit/data_overrides/someservice/2012-10-01.json -tests/unit/docs/__init__.py -tests/unit/docs/test_client.py -tests/unit/docs/test_docs.py -tests/unit/docs/test_docstring.py -tests/unit/docs/test_example.py -tests/unit/docs/test_method.py -tests/unit/docs/test_paginator.py -tests/unit/docs/test_params.py -tests/unit/docs/test_service.py -tests/unit/docs/test_sharedexample.py -tests/unit/docs/test_utils.py -tests/unit/docs/test_waiter.py -tests/unit/docs/bcdoc/__init__.py -tests/unit/docs/bcdoc/test_docstringparser.py -tests/unit/docs/bcdoc/test_document.py -tests/unit/docs/bcdoc/test_style.py -tests/unit/protocols/input/ec2.json -tests/unit/protocols/input/json.json -tests/unit/protocols/input/query.json -tests/unit/protocols/input/rest-json.json -tests/unit/protocols/input/rest-xml.json -tests/unit/protocols/output/ec2.json -tests/unit/protocols/output/event-stream.json -tests/unit/protocols/output/json.json -tests/unit/protocols/output/query.json -tests/unit/protocols/output/rest-json.json -tests/unit/protocols/output/rest-xml.json -tests/unit/response_parsing/README.rst -tests/unit/response_parsing/__init__.py -tests/unit/response_parsing/test_response_parsing.py -tests/unit/response_parsing/json/errors/datapipeline-create-pipeline.json -tests/unit/response_parsing/json/errors/directconnect-delete-connection.json -tests/unit/response_parsing/json/errors/dynamodb-put-item.json -tests/unit/response_parsing/json/errors/elastictranscoder-delete-pipeline.json -tests/unit/response_parsing/json/errors/opsworks-delete-stack.json -tests/unit/response_parsing/json/errors/storagegateway-delete-gateway.json -tests/unit/response_parsing/json/errors/swf-deprecate-domain.json -tests/unit/response_parsing/json/expected/datapipeline-create-pipeline.json -tests/unit/response_parsing/json/expected/directconnect-delete-connection.json -tests/unit/response_parsing/json/expected/dynamodb-put-item.json -tests/unit/response_parsing/json/expected/elastictranscoder-delete-pipeline.json -tests/unit/response_parsing/json/expected/elastictranscoder-list-pipelines.json -tests/unit/response_parsing/json/expected/opsworks-delete-stack.json -tests/unit/response_parsing/json/expected/storagegateway-delete-gateway.json -tests/unit/response_parsing/json/expected/swf-deprecate-domain.json -tests/unit/response_parsing/xml/errors/autoscaling-delete-policy.json -tests/unit/response_parsing/xml/errors/autoscaling-delete-policy.xml -tests/unit/response_parsing/xml/errors/cloudformation-cancel-update-stack.json -tests/unit/response_parsing/xml/errors/cloudformation-cancel-update-stack.xml -tests/unit/response_parsing/xml/errors/cloudwatch-describe-alarm-history.json -tests/unit/response_parsing/xml/errors/cloudwatch-describe-alarm-history.xml -tests/unit/response_parsing/xml/errors/ec2-describe-instances.json -tests/unit/response_parsing/xml/errors/ec2-describe-instances.xml -tests/unit/response_parsing/xml/errors/elb-describe-load-balancers.json -tests/unit/response_parsing/xml/errors/elb-describe-load-balancers.xml -tests/unit/response_parsing/xml/errors/iam-get-user.json -tests/unit/response_parsing/xml/errors/iam-get-user.xml -tests/unit/response_parsing/xml/errors/importexport-get-status.json -tests/unit/response_parsing/xml/errors/importexport-get-status.xml -tests/unit/response_parsing/xml/errors/rds-describe-db-instances.json -tests/unit/response_parsing/xml/errors/rds-describe-db-instances.xml -tests/unit/response_parsing/xml/errors/route53-get-hosted-zone.json -tests/unit/response_parsing/xml/errors/route53-get-hosted-zone.xml -tests/unit/response_parsing/xml/errors/s3-create-bucket.json -tests/unit/response_parsing/xml/errors/s3-create-bucket.xml -tests/unit/response_parsing/xml/errors/s3-list-objects.json -tests/unit/response_parsing/xml/errors/s3-list-objects.xml -tests/unit/response_parsing/xml/errors/ses-delete-identity.json -tests/unit/response_parsing/xml/errors/ses-delete-identity.xml -tests/unit/response_parsing/xml/errors/sns-delete-topic.json -tests/unit/response_parsing/xml/errors/sns-delete-topic.xml -tests/unit/response_parsing/xml/errors/sqs-delete-queue.json -tests/unit/response_parsing/xml/errors/sqs-delete-queue.xml -tests/unit/response_parsing/xml/errors/sts-get-session-token.json -tests/unit/response_parsing/xml/errors/sts-get-session-token.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-adjustment-types.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-adjustment-types.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-groups.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-groups.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-instances.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-instances.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-notification-types.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-auto-scaling-notification-types.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-launch-configurations.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-launch-configurations.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-metric-collection-types.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-metric-collection-types.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-notification-configurations.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-notification-configurations.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-policies.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-policies.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-scaling-activities.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-scaling-activities.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-scaling-process-types.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-scaling-process-types.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-scheduled-actions.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-scheduled-actions.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-tags.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-tags.xml -tests/unit/response_parsing/xml/responses/autoscaling-describe-termination-policy-types.json -tests/unit/response_parsing/xml/responses/autoscaling-describe-termination-policy-types.xml -tests/unit/response_parsing/xml/responses/cloudformation-describe-stacks.json -tests/unit/response_parsing/xml/responses/cloudformation-describe-stacks.xml -tests/unit/response_parsing/xml/responses/cloudformation-get-template.json -tests/unit/response_parsing/xml/responses/cloudformation-get-template.xml -tests/unit/response_parsing/xml/responses/cloudformation-list-stacks.json -tests/unit/response_parsing/xml/responses/cloudformation-list-stacks.xml -tests/unit/response_parsing/xml/responses/cloudfront-get-cloud-front-origin-access-identity.json -tests/unit/response_parsing/xml/responses/cloudfront-get-cloud-front-origin-access-identity.xml -tests/unit/response_parsing/xml/responses/cloudfront-get-distribution.json -tests/unit/response_parsing/xml/responses/cloudfront-get-distribution.xml -tests/unit/response_parsing/xml/responses/cloudfront-get-invalidation.json -tests/unit/response_parsing/xml/responses/cloudfront-get-invalidation.xml -tests/unit/response_parsing/xml/responses/cloudfront-get-streaming-distribution.json -tests/unit/response_parsing/xml/responses/cloudfront-get-streaming-distribution.xml -tests/unit/response_parsing/xml/responses/cloudfront-list-cloud-front-origin-access-identities.json -tests/unit/response_parsing/xml/responses/cloudfront-list-cloud-front-origin-access-identities.xml -tests/unit/response_parsing/xml/responses/cloudfront-list-distributions.json -tests/unit/response_parsing/xml/responses/cloudfront-list-distributions.xml -tests/unit/response_parsing/xml/responses/cloudfront-list-invalidations.json -tests/unit/response_parsing/xml/responses/cloudfront-list-invalidations.xml -tests/unit/response_parsing/xml/responses/cloudfront-list-streaming-distributions.json -tests/unit/response_parsing/xml/responses/cloudfront-list-streaming-distributions.xml -tests/unit/response_parsing/xml/responses/cloudwatch-describe-alarm-history.json -tests/unit/response_parsing/xml/responses/cloudwatch-describe-alarm-history.xml -tests/unit/response_parsing/xml/responses/cloudwatch-describe-alarms.json -tests/unit/response_parsing/xml/responses/cloudwatch-describe-alarms.xml -tests/unit/response_parsing/xml/responses/cloudwatch-list-metrics.json -tests/unit/response_parsing/xml/responses/cloudwatch-list-metrics.xml -tests/unit/response_parsing/xml/responses/ec2-allocate-address.json -tests/unit/response_parsing/xml/responses/ec2-allocate-address.xml -tests/unit/response_parsing/xml/responses/ec2-assign-private-ip-addresses.json -tests/unit/response_parsing/xml/responses/ec2-assign-private-ip-addresses.xml -tests/unit/response_parsing/xml/responses/ec2-associate-address.json -tests/unit/response_parsing/xml/responses/ec2-associate-address.xml -tests/unit/response_parsing/xml/responses/ec2-associate-route-table.json -tests/unit/response_parsing/xml/responses/ec2-associate-route-table.xml -tests/unit/response_parsing/xml/responses/ec2-attach-volume.json -tests/unit/response_parsing/xml/responses/ec2-attach-volume.xml -tests/unit/response_parsing/xml/responses/ec2-attach-vpn-gateway.json -tests/unit/response_parsing/xml/responses/ec2-attach-vpn-gateway.xml -tests/unit/response_parsing/xml/responses/ec2-bundle-instance.json -tests/unit/response_parsing/xml/responses/ec2-bundle-instance.xml -tests/unit/response_parsing/xml/responses/ec2-cancel-bundle-task.json -tests/unit/response_parsing/xml/responses/ec2-cancel-bundle-task.xml -tests/unit/response_parsing/xml/responses/ec2-cancel-reserved-instances-listing.json -tests/unit/response_parsing/xml/responses/ec2-cancel-reserved-instances-listing.xml -tests/unit/response_parsing/xml/responses/ec2-cancel-spot-instance-requests.json -tests/unit/response_parsing/xml/responses/ec2-cancel-spot-instance-requests.xml -tests/unit/response_parsing/xml/responses/ec2-confirm-product-instance.json -tests/unit/response_parsing/xml/responses/ec2-confirm-product-instance.xml -tests/unit/response_parsing/xml/responses/ec2-copy-snapshot.json -tests/unit/response_parsing/xml/responses/ec2-copy-snapshot.xml -tests/unit/response_parsing/xml/responses/ec2-create-customer-gateway.json -tests/unit/response_parsing/xml/responses/ec2-create-customer-gateway.xml -tests/unit/response_parsing/xml/responses/ec2-create-dhcp-options.json -tests/unit/response_parsing/xml/responses/ec2-create-dhcp-options.xml -tests/unit/response_parsing/xml/responses/ec2-create-instance-export-task.json -tests/unit/response_parsing/xml/responses/ec2-create-instance-export-task.xml -tests/unit/response_parsing/xml/responses/ec2-create-key-pair.json -tests/unit/response_parsing/xml/responses/ec2-create-key-pair.xml -tests/unit/response_parsing/xml/responses/ec2-create-network-acl.json -tests/unit/response_parsing/xml/responses/ec2-create-network-acl.xml -tests/unit/response_parsing/xml/responses/ec2-create-network-interface.json -tests/unit/response_parsing/xml/responses/ec2-create-network-interface.xml -tests/unit/response_parsing/xml/responses/ec2-create-reserved-instances-listing.json -tests/unit/response_parsing/xml/responses/ec2-create-reserved-instances-listing.xml -tests/unit/response_parsing/xml/responses/ec2-create-route-table.json -tests/unit/response_parsing/xml/responses/ec2-create-route-table.xml -tests/unit/response_parsing/xml/responses/ec2-create-snapshot.json -tests/unit/response_parsing/xml/responses/ec2-create-snapshot.xml -tests/unit/response_parsing/xml/responses/ec2-create-spot-datafeed-subscription.json -tests/unit/response_parsing/xml/responses/ec2-create-spot-datafeed-subscription.xml -tests/unit/response_parsing/xml/responses/ec2-create-subnet.json -tests/unit/response_parsing/xml/responses/ec2-create-subnet.xml -tests/unit/response_parsing/xml/responses/ec2-create-volume.json -tests/unit/response_parsing/xml/responses/ec2-create-volume.xml -tests/unit/response_parsing/xml/responses/ec2-create-vpc.json -tests/unit/response_parsing/xml/responses/ec2-create-vpc.xml -tests/unit/response_parsing/xml/responses/ec2-create-vpn-gateway.json -tests/unit/response_parsing/xml/responses/ec2-create-vpn-gateway.xml -tests/unit/response_parsing/xml/responses/ec2-delete-internet-gateway.json -tests/unit/response_parsing/xml/responses/ec2-delete-internet-gateway.xml -tests/unit/response_parsing/xml/responses/ec2-describe-account-attributes.json -tests/unit/response_parsing/xml/responses/ec2-describe-account-attributes.xml -tests/unit/response_parsing/xml/responses/ec2-describe-addresses.json -tests/unit/response_parsing/xml/responses/ec2-describe-addresses.xml -tests/unit/response_parsing/xml/responses/ec2-describe-availability-zones.json -tests/unit/response_parsing/xml/responses/ec2-describe-availability-zones.xml -tests/unit/response_parsing/xml/responses/ec2-describe-bundle-tasks.json -tests/unit/response_parsing/xml/responses/ec2-describe-bundle-tasks.xml -tests/unit/response_parsing/xml/responses/ec2-describe-customer-gateways.json -tests/unit/response_parsing/xml/responses/ec2-describe-customer-gateways.xml -tests/unit/response_parsing/xml/responses/ec2-describe-dhcp-options.json -tests/unit/response_parsing/xml/responses/ec2-describe-dhcp-options.xml -tests/unit/response_parsing/xml/responses/ec2-describe-export-tasks.json -tests/unit/response_parsing/xml/responses/ec2-describe-export-tasks.xml -tests/unit/response_parsing/xml/responses/ec2-describe-instance-attribute.json -tests/unit/response_parsing/xml/responses/ec2-describe-instance-attribute.xml -tests/unit/response_parsing/xml/responses/ec2-describe-instance-status.json -tests/unit/response_parsing/xml/responses/ec2-describe-instance-status.xml -tests/unit/response_parsing/xml/responses/ec2-describe-instances.json -tests/unit/response_parsing/xml/responses/ec2-describe-instances.xml -tests/unit/response_parsing/xml/responses/ec2-describe-internet-gateways.json -tests/unit/response_parsing/xml/responses/ec2-describe-internet-gateways.xml -tests/unit/response_parsing/xml/responses/ec2-describe-key-pairs.json -tests/unit/response_parsing/xml/responses/ec2-describe-key-pairs.xml -tests/unit/response_parsing/xml/responses/ec2-describe-network-acls.json -tests/unit/response_parsing/xml/responses/ec2-describe-network-acls.xml -tests/unit/response_parsing/xml/responses/ec2-describe-network-interfaces.json -tests/unit/response_parsing/xml/responses/ec2-describe-network-interfaces.xml -tests/unit/response_parsing/xml/responses/ec2-describe-placement-groups.json -tests/unit/response_parsing/xml/responses/ec2-describe-placement-groups.xml -tests/unit/response_parsing/xml/responses/ec2-describe-regions.json -tests/unit/response_parsing/xml/responses/ec2-describe-regions.xml -tests/unit/response_parsing/xml/responses/ec2-describe-reserved-instances-offerings.json -tests/unit/response_parsing/xml/responses/ec2-describe-reserved-instances-offerings.xml -tests/unit/response_parsing/xml/responses/ec2-describe-reserved-instances.json -tests/unit/response_parsing/xml/responses/ec2-describe-reserved-instances.xml -tests/unit/response_parsing/xml/responses/ec2-describe-route-tables.json -tests/unit/response_parsing/xml/responses/ec2-describe-route-tables.xml -tests/unit/response_parsing/xml/responses/ec2-describe-security-groups.json -tests/unit/response_parsing/xml/responses/ec2-describe-security-groups.xml -tests/unit/response_parsing/xml/responses/ec2-describe-snapshots.json -tests/unit/response_parsing/xml/responses/ec2-describe-snapshots.xml -tests/unit/response_parsing/xml/responses/ec2-describe-spot-instance-requests.json -tests/unit/response_parsing/xml/responses/ec2-describe-spot-instance-requests.xml -tests/unit/response_parsing/xml/responses/ec2-describe-spot-price-history.json -tests/unit/response_parsing/xml/responses/ec2-describe-spot-price-history.xml -tests/unit/response_parsing/xml/responses/ec2-describe-subnets.json -tests/unit/response_parsing/xml/responses/ec2-describe-subnets.xml -tests/unit/response_parsing/xml/responses/ec2-describe-tags.json -tests/unit/response_parsing/xml/responses/ec2-describe-tags.xml -tests/unit/response_parsing/xml/responses/ec2-describe-volume-status.json -tests/unit/response_parsing/xml/responses/ec2-describe-volume-status.xml -tests/unit/response_parsing/xml/responses/ec2-describe-volumes.json -tests/unit/response_parsing/xml/responses/ec2-describe-volumes.xml -tests/unit/response_parsing/xml/responses/ec2-describe-vpcs.json -tests/unit/response_parsing/xml/responses/ec2-describe-vpcs.xml -tests/unit/response_parsing/xml/responses/ec2-describe-vpn-connections.json -tests/unit/response_parsing/xml/responses/ec2-describe-vpn-connections.xml -tests/unit/response_parsing/xml/responses/ec2-describe-vpn-gateways.json -tests/unit/response_parsing/xml/responses/ec2-describe-vpn-gateways.xml -tests/unit/response_parsing/xml/responses/ec2-detach-network-interface.json -tests/unit/response_parsing/xml/responses/ec2-detach-network-interface.xml -tests/unit/response_parsing/xml/responses/ec2-detach-volume.json -tests/unit/response_parsing/xml/responses/ec2-detach-volume.xml -tests/unit/response_parsing/xml/responses/ec2-get-password-data.json -tests/unit/response_parsing/xml/responses/ec2-get-password-data.xml -tests/unit/response_parsing/xml/responses/ec2-import-instance.json -tests/unit/response_parsing/xml/responses/ec2-import-instance.xml -tests/unit/response_parsing/xml/responses/ec2-import-key-pair.json -tests/unit/response_parsing/xml/responses/ec2-import-key-pair.xml -tests/unit/response_parsing/xml/responses/ec2-import-volume.json -tests/unit/response_parsing/xml/responses/ec2-import-volume.xml -tests/unit/response_parsing/xml/responses/ec2-modify-snapshot-attribute.json -tests/unit/response_parsing/xml/responses/ec2-modify-snapshot-attribute.xml -tests/unit/response_parsing/xml/responses/ec2-monitor-instances.json -tests/unit/response_parsing/xml/responses/ec2-monitor-instances.xml -tests/unit/response_parsing/xml/responses/ec2-register-image.json -tests/unit/response_parsing/xml/responses/ec2-register-image.xml -tests/unit/response_parsing/xml/responses/ec2-replace-network-acl-association.json -tests/unit/response_parsing/xml/responses/ec2-replace-network-acl-association.xml -tests/unit/response_parsing/xml/responses/ec2-request-spot-instances.json -tests/unit/response_parsing/xml/responses/ec2-request-spot-instances.xml -tests/unit/response_parsing/xml/responses/ec2-run-instances.json -tests/unit/response_parsing/xml/responses/ec2-run-instances.xml -tests/unit/response_parsing/xml/responses/ec2-start-instances.json -tests/unit/response_parsing/xml/responses/ec2-start-instances.xml -tests/unit/response_parsing/xml/responses/ec2-stop-instances.json -tests/unit/response_parsing/xml/responses/ec2-stop-instances.xml -tests/unit/response_parsing/xml/responses/ec2-unmonitor-instances.json -tests/unit/response_parsing/xml/responses/ec2-unmonitor-instances.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-check-dns-availability.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-check-dns-availability.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-application-version.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-application-version.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-application.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-application.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-configuration-template.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-configuration-template.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-environment.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-environment.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-storage-location.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-create-storage-location.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-delete-application.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-delete-application.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-application-versions.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-application-versions.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-applications.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-applications.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-configuration-options.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-configuration-options.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-environments.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-environments.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-events.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-describe-events.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-list-available-solution-stacks.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-list-available-solution-stacks.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-retrieve-environment-info.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-retrieve-environment-info.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-terminate-environment.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-terminate-environment.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-update-application-version.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-update-application-version.xml -tests/unit/response_parsing/xml/responses/elasticbeanstalk-update-application.json -tests/unit/response_parsing/xml/responses/elasticbeanstalk-update-application.xml -tests/unit/response_parsing/xml/responses/elb-describe-load-balancer-policies.json -tests/unit/response_parsing/xml/responses/elb-describe-load-balancer-policies.xml -tests/unit/response_parsing/xml/responses/elb-describe-load-balancer-policy-types.json -tests/unit/response_parsing/xml/responses/elb-describe-load-balancer-policy-types.xml -tests/unit/response_parsing/xml/responses/elb-describe-load-balancers.json -tests/unit/response_parsing/xml/responses/elb-describe-load-balancers.xml -tests/unit/response_parsing/xml/responses/iam-create-virtual-mfa-device.json -tests/unit/response_parsing/xml/responses/iam-create-virtual-mfa-device.xml -tests/unit/response_parsing/xml/responses/iam-get-account-summary.json -tests/unit/response_parsing/xml/responses/iam-get-account-summary.xml -tests/unit/response_parsing/xml/responses/iam-get-group.json -tests/unit/response_parsing/xml/responses/iam-get-group.xml -tests/unit/response_parsing/xml/responses/iam-get-user-policy.json -tests/unit/response_parsing/xml/responses/iam-get-user-policy.xml -tests/unit/response_parsing/xml/responses/iam-get-user.json -tests/unit/response_parsing/xml/responses/iam-get-user.xml -tests/unit/response_parsing/xml/responses/iam-list-access-keys.json -tests/unit/response_parsing/xml/responses/iam-list-access-keys.xml -tests/unit/response_parsing/xml/responses/iam-list-account-aliases.json -tests/unit/response_parsing/xml/responses/iam-list-account-aliases.xml -tests/unit/response_parsing/xml/responses/iam-list-groups.json -tests/unit/response_parsing/xml/responses/iam-list-groups.xml -tests/unit/response_parsing/xml/responses/iam-list-instance-profiles.json -tests/unit/response_parsing/xml/responses/iam-list-instance-profiles.xml -tests/unit/response_parsing/xml/responses/iam-list-mfa-devices.json -tests/unit/response_parsing/xml/responses/iam-list-mfa-devices.xml -tests/unit/response_parsing/xml/responses/iam-list-roles.json -tests/unit/response_parsing/xml/responses/iam-list-roles.xml -tests/unit/response_parsing/xml/responses/iam-list-server-certificates.json -tests/unit/response_parsing/xml/responses/iam-list-server-certificates.xml -tests/unit/response_parsing/xml/responses/iam-list-signing-certificates.json -tests/unit/response_parsing/xml/responses/iam-list-signing-certificates.xml -tests/unit/response_parsing/xml/responses/iam-list-users.json -tests/unit/response_parsing/xml/responses/iam-list-users.xml -tests/unit/response_parsing/xml/responses/iam-list-virtual-mfa-devices.json -tests/unit/response_parsing/xml/responses/iam-list-virtual-mfa-devices.xml -tests/unit/response_parsing/xml/responses/importexport-list-jobs.json -tests/unit/response_parsing/xml/responses/importexport-list-jobs.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-engine-versions.json -tests/unit/response_parsing/xml/responses/rds-describe-db-engine-versions.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-instances.json -tests/unit/response_parsing/xml/responses/rds-describe-db-instances.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-parameter-groups.json -tests/unit/response_parsing/xml/responses/rds-describe-db-parameter-groups.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-security-groups.json -tests/unit/response_parsing/xml/responses/rds-describe-db-security-groups.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-snapshots.json -tests/unit/response_parsing/xml/responses/rds-describe-db-snapshots.xml -tests/unit/response_parsing/xml/responses/rds-describe-db-subnet-groups.json -tests/unit/response_parsing/xml/responses/rds-describe-db-subnet-groups.xml -tests/unit/response_parsing/xml/responses/rds-describe-event-categories.json -tests/unit/response_parsing/xml/responses/rds-describe-event-categories.xml -tests/unit/response_parsing/xml/responses/rds-describe-event-subscriptions.json -tests/unit/response_parsing/xml/responses/rds-describe-event-subscriptions.xml -tests/unit/response_parsing/xml/responses/rds-describe-events.json -tests/unit/response_parsing/xml/responses/rds-describe-events.xml -tests/unit/response_parsing/xml/responses/rds-describe-option-groups.json -tests/unit/response_parsing/xml/responses/rds-describe-option-groups.xml -tests/unit/response_parsing/xml/responses/rds-describe-reserved-db-instances-offerings.json -tests/unit/response_parsing/xml/responses/rds-describe-reserved-db-instances-offerings.xml -tests/unit/response_parsing/xml/responses/rds-describe-reserved-db-instances.json -tests/unit/response_parsing/xml/responses/rds-describe-reserved-db-instances.xml -tests/unit/response_parsing/xml/responses/redshift-authorize-cluster-security-group-ingress.json -tests/unit/response_parsing/xml/responses/redshift-authorize-cluster-security-group-ingress.xml -tests/unit/response_parsing/xml/responses/redshift-copy-cluster-snapshot.json -tests/unit/response_parsing/xml/responses/redshift-copy-cluster-snapshot.xml -tests/unit/response_parsing/xml/responses/redshift-create-cluster-parameter-group.json -tests/unit/response_parsing/xml/responses/redshift-create-cluster-parameter-group.xml -tests/unit/response_parsing/xml/responses/redshift-create-cluster-security-group.json -tests/unit/response_parsing/xml/responses/redshift-create-cluster-security-group.xml -tests/unit/response_parsing/xml/responses/redshift-create-cluster-snapshot.json -tests/unit/response_parsing/xml/responses/redshift-create-cluster-snapshot.xml -tests/unit/response_parsing/xml/responses/redshift-create-cluster-subnet-group.json -tests/unit/response_parsing/xml/responses/redshift-create-cluster-subnet-group.xml -tests/unit/response_parsing/xml/responses/redshift-create-cluster.json -tests/unit/response_parsing/xml/responses/redshift-create-cluster.xml -tests/unit/response_parsing/xml/responses/redshift-delete-cluster-parameter-group.json -tests/unit/response_parsing/xml/responses/redshift-delete-cluster-parameter-group.xml -tests/unit/response_parsing/xml/responses/redshift-delete-cluster-snapshot.json -tests/unit/response_parsing/xml/responses/redshift-delete-cluster-snapshot.xml -tests/unit/response_parsing/xml/responses/redshift-delete-cluster.json -tests/unit/response_parsing/xml/responses/redshift-delete-cluster.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-parameter-groups.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-parameter-groups.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-parameters.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-parameters.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-security-groups.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-security-groups.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-snapshots.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-snapshots.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-subnet-groups.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-subnet-groups.xml -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-versions.json -tests/unit/response_parsing/xml/responses/redshift-describe-cluster-versions.xml -tests/unit/response_parsing/xml/responses/redshift-describe-clusters.json -tests/unit/response_parsing/xml/responses/redshift-describe-clusters.xml -tests/unit/response_parsing/xml/responses/redshift-describe-events.json -tests/unit/response_parsing/xml/responses/redshift-describe-events.xml -tests/unit/response_parsing/xml/responses/redshift-describe-orderable-cluster-options.json -tests/unit/response_parsing/xml/responses/redshift-describe-orderable-cluster-options.xml -tests/unit/response_parsing/xml/responses/redshift-describe-reserved-node-offerings.json -tests/unit/response_parsing/xml/responses/redshift-describe-reserved-node-offerings.xml -tests/unit/response_parsing/xml/responses/redshift-describe-reserved-nodes.json -tests/unit/response_parsing/xml/responses/redshift-describe-reserved-nodes.xml -tests/unit/response_parsing/xml/responses/redshift-describe-resize.json -tests/unit/response_parsing/xml/responses/redshift-describe-resize.xml -tests/unit/response_parsing/xml/responses/redshift-modify-cluster-parameter-group.json -tests/unit/response_parsing/xml/responses/redshift-modify-cluster-parameter-group.xml -tests/unit/response_parsing/xml/responses/redshift-purchase-reserved-node-offering.json -tests/unit/response_parsing/xml/responses/redshift-purchase-reserved-node-offering.xml -tests/unit/response_parsing/xml/responses/redshift-reboot-cluster.json -tests/unit/response_parsing/xml/responses/redshift-reboot-cluster.xml -tests/unit/response_parsing/xml/responses/redshift-reset-cluster-parameter-group.json -tests/unit/response_parsing/xml/responses/redshift-reset-cluster-parameter-group.xml -tests/unit/response_parsing/xml/responses/redshift-restore-from-cluster-snapshot.json -tests/unit/response_parsing/xml/responses/redshift-restore-from-cluster-snapshot.xml -tests/unit/response_parsing/xml/responses/redshift-revoke-cluster-security-group-ingress.json -tests/unit/response_parsing/xml/responses/redshift-revoke-cluster-security-group-ingress.xml -tests/unit/response_parsing/xml/responses/s3-get-bucket-acl.json -tests/unit/response_parsing/xml/responses/s3-get-bucket-acl.xml -tests/unit/response_parsing/xml/responses/s3-get-bucket-location.json -tests/unit/response_parsing/xml/responses/s3-get-bucket-location.xml -tests/unit/response_parsing/xml/responses/s3-get-bucket-logging.json -tests/unit/response_parsing/xml/responses/s3-get-bucket-logging.xml -tests/unit/response_parsing/xml/responses/s3-get-bucket-policy.json -tests/unit/response_parsing/xml/responses/s3-get-bucket-policy.xml -tests/unit/response_parsing/xml/responses/s3-list-buckets.json -tests/unit/response_parsing/xml/responses/s3-list-buckets.xml -tests/unit/response_parsing/xml/responses/s3-list-multipart-uploads#2.json -tests/unit/response_parsing/xml/responses/s3-list-multipart-uploads#2.xml -tests/unit/response_parsing/xml/responses/s3-list-multipart-uploads.json -tests/unit/response_parsing/xml/responses/s3-list-multipart-uploads.xml -tests/unit/response_parsing/xml/responses/s3-list-object-versions.json -tests/unit/response_parsing/xml/responses/s3-list-object-versions.xml -tests/unit/response_parsing/xml/responses/s3-list-objects.json -tests/unit/response_parsing/xml/responses/s3-list-objects.xml -tests/unit/response_parsing/xml/responses/ses-delete-identity.json -tests/unit/response_parsing/xml/responses/ses-delete-identity.xml -tests/unit/response_parsing/xml/responses/ses-get-identity-dkim-attributes.json -tests/unit/response_parsing/xml/responses/ses-get-identity-dkim-attributes.xml -tests/unit/response_parsing/xml/responses/ses-get-identity-notification-attributes.json -tests/unit/response_parsing/xml/responses/ses-get-identity-notification-attributes.xml -tests/unit/response_parsing/xml/responses/ses-get-identity-verification-attributes.json -tests/unit/response_parsing/xml/responses/ses-get-identity-verification-attributes.xml -tests/unit/response_parsing/xml/responses/ses-get-send-quota.json -tests/unit/response_parsing/xml/responses/ses-get-send-quota.xml -tests/unit/response_parsing/xml/responses/ses-get-send-statistics.json -tests/unit/response_parsing/xml/responses/ses-get-send-statistics.xml -tests/unit/response_parsing/xml/responses/ses-list-identities.json -tests/unit/response_parsing/xml/responses/ses-list-identities.xml -tests/unit/response_parsing/xml/responses/ses-send-email.json -tests/unit/response_parsing/xml/responses/ses-send-email.xml -tests/unit/response_parsing/xml/responses/ses-send-raw-email.json -tests/unit/response_parsing/xml/responses/ses-send-raw-email.xml -tests/unit/response_parsing/xml/responses/ses-set-identity-dkim-enabled.json -tests/unit/response_parsing/xml/responses/ses-set-identity-dkim-enabled.xml -tests/unit/response_parsing/xml/responses/ses-verify-domain-dkim.json -tests/unit/response_parsing/xml/responses/ses-verify-domain-dkim.xml -tests/unit/response_parsing/xml/responses/ses-verify-domain-identity.json -tests/unit/response_parsing/xml/responses/ses-verify-domain-identity.xml -tests/unit/response_parsing/xml/responses/sns-add-permission.json -tests/unit/response_parsing/xml/responses/sns-add-permission.xml -tests/unit/response_parsing/xml/responses/sns-confirm-subscription.json -tests/unit/response_parsing/xml/responses/sns-confirm-subscription.xml -tests/unit/response_parsing/xml/responses/sns-create-topic.json -tests/unit/response_parsing/xml/responses/sns-create-topic.xml -tests/unit/response_parsing/xml/responses/sns-get-subscription-attributes.json -tests/unit/response_parsing/xml/responses/sns-get-subscription-attributes.xml -tests/unit/response_parsing/xml/responses/sns-get-topic-attributes.json -tests/unit/response_parsing/xml/responses/sns-get-topic-attributes.xml -tests/unit/response_parsing/xml/responses/sns-list-subscriptions-by-topic.json -tests/unit/response_parsing/xml/responses/sns-list-subscriptions-by-topic.xml -tests/unit/response_parsing/xml/responses/sns-list-subscriptions.json -tests/unit/response_parsing/xml/responses/sns-list-subscriptions.xml -tests/unit/response_parsing/xml/responses/sns-list-topics.json -tests/unit/response_parsing/xml/responses/sns-list-topics.xml -tests/unit/response_parsing/xml/responses/sns-publish.json -tests/unit/response_parsing/xml/responses/sns-publish.xml -tests/unit/response_parsing/xml/responses/sns-subscribe.json -tests/unit/response_parsing/xml/responses/sns-subscribe.xml -tests/unit/response_parsing/xml/responses/sqs-add-permission.json -tests/unit/response_parsing/xml/responses/sqs-add-permission.xml -tests/unit/response_parsing/xml/responses/sqs-change-message-visibility-batch.json -tests/unit/response_parsing/xml/responses/sqs-change-message-visibility-batch.xml -tests/unit/response_parsing/xml/responses/sqs-create-queue.json -tests/unit/response_parsing/xml/responses/sqs-create-queue.xml -tests/unit/response_parsing/xml/responses/sqs-delete-message-batch.json -tests/unit/response_parsing/xml/responses/sqs-delete-message-batch.xml -tests/unit/response_parsing/xml/responses/sqs-get-queue-attributes.json -tests/unit/response_parsing/xml/responses/sqs-get-queue-attributes.xml -tests/unit/response_parsing/xml/responses/sqs-get-queue-url.json -tests/unit/response_parsing/xml/responses/sqs-get-queue-url.xml -tests/unit/response_parsing/xml/responses/sqs-list-queues.json -tests/unit/response_parsing/xml/responses/sqs-list-queues.xml -tests/unit/response_parsing/xml/responses/sqs-receive-message.json -tests/unit/response_parsing/xml/responses/sqs-receive-message.xml -tests/unit/response_parsing/xml/responses/sqs-send-message-batch.json -tests/unit/response_parsing/xml/responses/sqs-send-message-batch.xml -tests/unit/response_parsing/xml/responses/sqs-send-message.json -tests/unit/response_parsing/xml/responses/sqs-send-message.xml -tests/unit/response_parsing/xml/responses/sts-get-session-token.json -tests/unit/response_parsing/xml/responses/sts-get-session-token.xml \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/dependency_links.txt b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/dependency_links.txt deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/dependency_links.txt +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/not-zip-safe b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/not-zip-safe deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/not-zip-safe +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/requires.txt b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/requires.txt deleted file mode 100644 index 11678506..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/requires.txt +++ /dev/null @@ -1,7 +0,0 @@ -jmespath>=0.7.1,<1.0.0 -docutils>=0.10 -python-dateutil>=2.1,<3.0.0 - -[:python_version=="2.6"] -ordereddict==1.1 -simplejson==3.3.0 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/top_level.txt b/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/top_level.txt deleted file mode 100644 index c5b9e129..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/EGG-INFO/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -botocore diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/__init__.py deleted file mode 100644 index 69e2e503..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/__init__.py +++ /dev/null @@ -1,92 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import os -import re -import logging - -__version__ = '1.10.75' - - -class NullHandler(logging.Handler): - def emit(self, record): - pass - -# Configure default logger to do nothing -log = logging.getLogger('botocore') -log.addHandler(NullHandler()) - - -_first_cap_regex = re.compile('(.)([A-Z][a-z]+)') -_end_cap_regex = re.compile('([a-z0-9])([A-Z])') -# The regex below handles the special case where some acryonym -# name is pluralized, e.g GatewayARNs, ListWebACLs, SomeCNAMEs. -_special_case_transform = re.compile('[A-Z]{3,}s$') -# Prepopulate the cache with special cases that don't match -# our regular transformation. -_xform_cache = { - ('CreateCachediSCSIVolume', '_'): 'create_cached_iscsi_volume', - ('CreateCachediSCSIVolume', '-'): 'create-cached-iscsi-volume', - ('DescribeCachediSCSIVolumes', '_'): 'describe_cached_iscsi_volumes', - ('DescribeCachediSCSIVolumes', '-'): 'describe-cached-iscsi-volumes', - ('DescribeStorediSCSIVolumes', '_'): 'describe_stored_iscsi_volumes', - ('DescribeStorediSCSIVolumes', '-'): 'describe-stored-iscsi-volumes', - ('CreateStorediSCSIVolume', '_'): 'create_stored_iscsi_volume', - ('CreateStorediSCSIVolume', '-'): 'create-stored-iscsi-volume', - ('ListHITsForQualificationType', '_'): 'list_hits_for_qualification_type', - ('ListHITsForQualificationType', '-'): 'list-hits-for-qualification-type', -} -# The items in this dict represent partial renames to apply globally to all -# services which might have a matching argument or operation. This way a -# common mis-translation can be fixed without having to call out each -# individual case. -ScalarTypes = ('string', 'integer', 'boolean', 'timestamp', 'float', 'double') - -BOTOCORE_ROOT = os.path.dirname(os.path.abspath(__file__)) - - -# Used to specify anonymous (unsigned) request signature -class UNSIGNED(object): - def __copy__(self): - return self - - def __deepcopy__(self, memodict): - return self - - -UNSIGNED = UNSIGNED() - - -def xform_name(name, sep='_', _xform_cache=_xform_cache): - """Convert camel case to a "pythonic" name. - - If the name contains the ``sep`` character, then it is - returned unchanged. - - """ - if sep in name: - # If the sep is in the name, assume that it's already - # transformed and return the string unchanged. - return name - key = (name, sep) - if key not in _xform_cache: - if _special_case_transform.search(name) is not None: - is_special = _special_case_transform.search(name) - matched = is_special.group() - # Replace something like ARNs, ACLs with _arns, _acls. - name = name[:-len(matched)] + sep + matched.lower() - s1 = _first_cap_regex.sub(r'\1' + sep + r'\2', name) - transformed = _end_cap_regex.sub(r'\1' + sep + r'\2', s1).lower() - _xform_cache[key] = transformed - return _xform_cache[key] diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/args.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/args.py deleted file mode 100644 index fb6b5bc2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/args.py +++ /dev/null @@ -1,208 +0,0 @@ -# Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Internal module to help with normalizing botocore client args. - -This module (and all function/classes within this module) should be -considered internal, and *not* a public API. - -""" -import copy -import logging - -import botocore.serialize -from botocore.signers import RequestSigner -from botocore.config import Config -from botocore.endpoint import EndpointCreator - - -logger = logging.getLogger(__name__) - - -class ClientArgsCreator(object): - def __init__(self, event_emitter, user_agent, response_parser_factory, - loader, exceptions_factory): - self._event_emitter = event_emitter - self._user_agent = user_agent - self._response_parser_factory = response_parser_factory - self._loader = loader - self._exceptions_factory = exceptions_factory - - def get_client_args(self, service_model, region_name, is_secure, - endpoint_url, verify, credentials, scoped_config, - client_config, endpoint_bridge): - final_args = self.compute_client_args( - service_model, client_config, endpoint_bridge, region_name, - endpoint_url, is_secure, scoped_config) - - service_name = final_args['service_name'] - parameter_validation = final_args['parameter_validation'] - endpoint_config = final_args['endpoint_config'] - protocol = final_args['protocol'] - config_kwargs = final_args['config_kwargs'] - s3_config = final_args['s3_config'] - partition = endpoint_config['metadata'].get('partition', None) - - signing_region = endpoint_config['signing_region'] - endpoint_region_name = endpoint_config['region_name'] - if signing_region is None and endpoint_region_name is None: - signing_region, endpoint_region_name = \ - self._get_default_s3_region(service_name, endpoint_bridge) - config_kwargs['region_name'] = endpoint_region_name - - event_emitter = copy.copy(self._event_emitter) - signer = RequestSigner( - service_name, signing_region, - endpoint_config['signing_name'], - endpoint_config['signature_version'], - credentials, event_emitter) - - config_kwargs['s3'] = s3_config - new_config = Config(**config_kwargs) - endpoint_creator = EndpointCreator(event_emitter) - - endpoint = endpoint_creator.create_endpoint( - service_model, region_name=endpoint_region_name, - endpoint_url=endpoint_config['endpoint_url'], verify=verify, - response_parser_factory=self._response_parser_factory, - max_pool_connections=new_config.max_pool_connections, - proxies=new_config.proxies, - timeout=(new_config.connect_timeout, new_config.read_timeout)) - - serializer = botocore.serialize.create_serializer( - protocol, parameter_validation) - response_parser = botocore.parsers.create_parser(protocol) - return { - 'serializer': serializer, - 'endpoint': endpoint, - 'response_parser': response_parser, - 'event_emitter': event_emitter, - 'request_signer': signer, - 'service_model': service_model, - 'loader': self._loader, - 'client_config': new_config, - 'partition': partition, - 'exceptions_factory': self._exceptions_factory - } - - def compute_client_args(self, service_model, client_config, - endpoint_bridge, region_name, endpoint_url, - is_secure, scoped_config): - service_name = service_model.endpoint_prefix - protocol = service_model.metadata['protocol'] - parameter_validation = True - if client_config and not client_config.parameter_validation: - parameter_validation = False - elif scoped_config: - raw_value = str(scoped_config.get('parameter_validation', '')) - if raw_value.lower() == 'false': - parameter_validation = False - - endpoint_config = endpoint_bridge.resolve( - service_name, region_name, endpoint_url, is_secure) - - # Override the user agent if specified in the client config. - user_agent = self._user_agent - if client_config is not None: - if client_config.user_agent is not None: - user_agent = client_config.user_agent - if client_config.user_agent_extra is not None: - user_agent += ' %s' % client_config.user_agent_extra - - # Create a new client config to be passed to the client based - # on the final values. We do not want the user to be able - # to try to modify an existing client with a client config. - config_kwargs = dict( - region_name=endpoint_config['region_name'], - signature_version=endpoint_config['signature_version'], - user_agent=user_agent) - if client_config is not None: - config_kwargs.update( - connect_timeout=client_config.connect_timeout, - read_timeout=client_config.read_timeout, - max_pool_connections=client_config.max_pool_connections, - proxies=client_config.proxies, - retries=client_config.retries - ) - s3_config = self.compute_s3_config(scoped_config, - client_config) - return { - 'service_name': service_name, - 'parameter_validation': parameter_validation, - 'user_agent': user_agent, - 'endpoint_config': endpoint_config, - 'protocol': protocol, - 'config_kwargs': config_kwargs, - 's3_config': s3_config, - } - - def compute_s3_config(self, scoped_config, client_config): - s3_configuration = None - - # Check the scoped config first. - if scoped_config is not None: - s3_configuration = scoped_config.get('s3') - # Until we have proper validation of the config file (including - # nested types), we have to account for the fact that the s3 - # key could be parsed as a string, e.g 's3 = foo'. - # In the case we'll ignore the key for now. - if not isinstance(s3_configuration, dict): - logger.debug("The s3 config key is not a dictionary type, " - "ignoring its value of: %s", s3_configuration) - s3_configuration = None - - # Convert logic for several s3 keys in the scoped config - # so that the various strings map to the appropriate boolean value. - if s3_configuration: - boolean_keys = ['use_accelerate_endpoint', - 'use_dualstack_endpoint', - 'payload_signing_enabled'] - s3_configuration = self._convert_config_to_bool( - s3_configuration, boolean_keys) - - # Next specific client config values takes precedence over - # specific values in the scoped config. - if client_config is not None: - if client_config.s3 is not None: - if s3_configuration is None: - s3_configuration = client_config.s3 - else: - # The current s3_configuration dictionary may be - # from a source that only should be read from so - # we want to be safe and just make a copy of it to modify - # before it actually gets updated. - s3_configuration = s3_configuration.copy() - s3_configuration.update(client_config.s3) - - return s3_configuration - - def _convert_config_to_bool(self, config_dict, keys): - # Make sure any further modifications to this section of the config - # will not affect the scoped config by making a copy of it. - config_copy = config_dict.copy() - present_keys = [k for k in keys if k in config_copy] - for key in present_keys: - # Normalize on different possible values of True - if config_copy[key] in [True, 'True', 'true']: - config_copy[key] = True - else: - config_copy[key] = False - return config_copy - - def _get_default_s3_region(self, service_name, endpoint_bridge): - # If a user is providing a custom URL, the endpoint resolver will - # refuse to infer a signing region. If we want to default to s3v4, - # we have to account for this. - if service_name == 's3': - endpoint = endpoint_bridge.resolve('s3') - return endpoint['signing_region'], endpoint['region_name'] - return None, None diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/auth.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/auth.py deleted file mode 100644 index b81764be..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/auth.py +++ /dev/null @@ -1,867 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import base64 -import datetime -from hashlib import sha256 -from hashlib import sha1 -import hmac -import logging -from email.utils import formatdate -from operator import itemgetter -import functools -import time -import calendar -import json - -from botocore.exceptions import NoCredentialsError -from botocore.utils import normalize_url_path, percent_encode_sequence -from botocore.compat import HTTPHeaders -from botocore.compat import quote, unquote, urlsplit, parse_qs -from botocore.compat import urlunsplit -from botocore.compat import encodebytes -from botocore.compat import six -from botocore.compat import json -from botocore.compat import MD5_AVAILABLE -from botocore.compat import ensure_unicode - -logger = logging.getLogger(__name__) - - -EMPTY_SHA256_HASH = ( - 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855') -# This is the buffer size used when calculating sha256 checksums. -# Experimenting with various buffer sizes showed that this value generally -# gave the best result (in terms of performance). -PAYLOAD_BUFFER = 1024 * 1024 -ISO8601 = '%Y-%m-%dT%H:%M:%SZ' -SIGV4_TIMESTAMP = '%Y%m%dT%H%M%SZ' -SIGNED_HEADERS_BLACKLIST = [ - 'expect', - 'user-agent', - 'x-amzn-trace-id', -] -UNSIGNED_PAYLOAD = 'UNSIGNED-PAYLOAD' - - -class BaseSigner(object): - REQUIRES_REGION = False - - def add_auth(self, request): - raise NotImplementedError("add_auth") - - -class SigV2Auth(BaseSigner): - """ - Sign a request with Signature V2. - """ - - def __init__(self, credentials): - self.credentials = credentials - - def calc_signature(self, request, params): - logger.debug("Calculating signature using v2 auth.") - split = urlsplit(request.url) - path = split.path - if len(path) == 0: - path = '/' - string_to_sign = '%s\n%s\n%s\n' % (request.method, - split.netloc, - path) - lhmac = hmac.new(self.credentials.secret_key.encode('utf-8'), - digestmod=sha256) - pairs = [] - for key in sorted(params): - # Any previous signature should not be a part of this - # one, so we skip that particular key. This prevents - # issues during retries. - if key == 'Signature': - continue - value = six.text_type(params[key]) - pairs.append(quote(key.encode('utf-8'), safe='') + '=' + - quote(value.encode('utf-8'), safe='-_~')) - qs = '&'.join(pairs) - string_to_sign += qs - logger.debug('String to sign: %s', string_to_sign) - lhmac.update(string_to_sign.encode('utf-8')) - b64 = base64.b64encode(lhmac.digest()).strip().decode('utf-8') - return (qs, b64) - - def add_auth(self, request): - # The auth handler is the last thing called in the - # preparation phase of a prepared request. - # Because of this we have to parse the query params - # from the request body so we can update them with - # the sigv2 auth params. - if self.credentials is None: - raise NoCredentialsError - if request.data: - # POST - params = request.data - else: - # GET - params = request.params - params['AWSAccessKeyId'] = self.credentials.access_key - params['SignatureVersion'] = '2' - params['SignatureMethod'] = 'HmacSHA256' - params['Timestamp'] = time.strftime(ISO8601, time.gmtime()) - if self.credentials.token: - params['SecurityToken'] = self.credentials.token - qs, signature = self.calc_signature(request, params) - params['Signature'] = signature - return request - - -class SigV3Auth(BaseSigner): - def __init__(self, credentials): - self.credentials = credentials - - def add_auth(self, request): - if self.credentials is None: - raise NoCredentialsError - if 'Date' in request.headers: - del request.headers['Date'] - request.headers['Date'] = formatdate(usegmt=True) - if self.credentials.token: - if 'X-Amz-Security-Token' in request.headers: - del request.headers['X-Amz-Security-Token'] - request.headers['X-Amz-Security-Token'] = self.credentials.token - new_hmac = hmac.new(self.credentials.secret_key.encode('utf-8'), - digestmod=sha256) - new_hmac.update(request.headers['Date'].encode('utf-8')) - encoded_signature = encodebytes(new_hmac.digest()).strip() - signature = ('AWS3-HTTPS AWSAccessKeyId=%s,Algorithm=%s,Signature=%s' % - (self.credentials.access_key, 'HmacSHA256', - encoded_signature.decode('utf-8'))) - if 'X-Amzn-Authorization' in request.headers: - del request.headers['X-Amzn-Authorization'] - request.headers['X-Amzn-Authorization'] = signature - - -class SigV4Auth(BaseSigner): - """ - Sign a request with Signature V4. - """ - REQUIRES_REGION = True - - def __init__(self, credentials, service_name, region_name): - self.credentials = credentials - # We initialize these value here so the unit tests can have - # valid values. But these will get overriden in ``add_auth`` - # later for real requests. - self._region_name = region_name - self._service_name = service_name - - def _sign(self, key, msg, hex=False): - if hex: - sig = hmac.new(key, msg.encode('utf-8'), sha256).hexdigest() - else: - sig = hmac.new(key, msg.encode('utf-8'), sha256).digest() - return sig - - def headers_to_sign(self, request): - """ - Select the headers from the request that need to be included - in the StringToSign. - """ - header_map = HTTPHeaders() - for name, value in request.headers.items(): - lname = name.lower() - if lname not in SIGNED_HEADERS_BLACKLIST: - header_map[lname] = value - if 'host' not in header_map: - header_map['host'] = self._canonical_host(request.url) - return header_map - - def _canonical_host(self, url): - url_parts = urlsplit(url) - default_ports = { - 'http': 80, - 'https': 443 - } - if any(url_parts.scheme == scheme and url_parts.port == port - for scheme, port in default_ports.items()): - # No need to include the port if it's the default port. - return url_parts.hostname - # Strip out auth if it's present in the netloc. - return url_parts.netloc.rsplit('@', 1)[-1] - - def canonical_query_string(self, request): - # The query string can come from two parts. One is the - # params attribute of the request. The other is from the request - # url (in which case we have to re-split the url into its components - # and parse out the query string component). - if request.params: - return self._canonical_query_string_params(request.params) - else: - return self._canonical_query_string_url(urlsplit(request.url)) - - def _canonical_query_string_params(self, params): - l = [] - for param in sorted(params): - value = str(params[param]) - l.append('%s=%s' % (quote(param, safe='-_.~'), - quote(value, safe='-_.~'))) - cqs = '&'.join(l) - return cqs - - def _canonical_query_string_url(self, parts): - canonical_query_string = '' - if parts.query: - # [(key, value), (key2, value2)] - key_val_pairs = [] - for pair in parts.query.split('&'): - key, _, value = pair.partition('=') - key_val_pairs.append((key, value)) - sorted_key_vals = [] - # Sort by the key names, and in the case of - # repeated keys, then sort by the value. - for key, value in sorted(key_val_pairs): - sorted_key_vals.append('%s=%s' % (key, value)) - canonical_query_string = '&'.join(sorted_key_vals) - return canonical_query_string - - def canonical_headers(self, headers_to_sign): - """ - Return the headers that need to be included in the StringToSign - in their canonical form by converting all header keys to lower - case, sorting them in alphabetical order and then joining - them into a string, separated by newlines. - """ - headers = [] - sorted_header_names = sorted(set(headers_to_sign)) - for key in sorted_header_names: - value = ','.join(self._header_value(v) for v in - sorted(headers_to_sign.get_all(key))) - headers.append('%s:%s' % (key, ensure_unicode(value))) - return '\n'.join(headers) - - def _header_value(self, value): - # From the sigv4 docs: - # Lowercase(HeaderName) + ':' + Trimall(HeaderValue) - # - # The Trimall function removes excess white space before and after - # values, and converts sequential spaces to a single space. - return ' '.join(value.split()) - - def signed_headers(self, headers_to_sign): - l = ['%s' % n.lower().strip() for n in set(headers_to_sign)] - l = sorted(l) - return ';'.join(l) - - def payload(self, request): - if not self._should_sha256_sign_payload(request): - # When payload signing is disabled, we use this static string in - # place of the payload checksum. - return UNSIGNED_PAYLOAD - if request.body and hasattr(request.body, 'seek'): - position = request.body.tell() - read_chunksize = functools.partial(request.body.read, - PAYLOAD_BUFFER) - checksum = sha256() - for chunk in iter(read_chunksize, b''): - checksum.update(chunk) - hex_checksum = checksum.hexdigest() - request.body.seek(position) - return hex_checksum - elif request.body: - # The request serialization has ensured that - # request.body is a bytes() type. - return sha256(request.body).hexdigest() - else: - return EMPTY_SHA256_HASH - - def _should_sha256_sign_payload(self, request): - # Payloads will always be signed over insecure connections. - if not request.url.startswith('https'): - return True - - # Certain operations may have payload signing disabled by default. - # Since we don't have access to the operation model, we pass in this - # bit of metadata through the request context. - return request.context.get('payload_signing_enabled', True) - - def canonical_request(self, request): - cr = [request.method.upper()] - path = self._normalize_url_path(urlsplit(request.url).path) - cr.append(path) - cr.append(self.canonical_query_string(request)) - headers_to_sign = self.headers_to_sign(request) - cr.append(self.canonical_headers(headers_to_sign) + '\n') - cr.append(self.signed_headers(headers_to_sign)) - if 'X-Amz-Content-SHA256' in request.headers: - body_checksum = request.headers['X-Amz-Content-SHA256'] - else: - body_checksum = self.payload(request) - cr.append(body_checksum) - return '\n'.join(cr) - - def _normalize_url_path(self, path): - normalized_path = quote(normalize_url_path(path), safe='/~') - return normalized_path - - def scope(self, request): - scope = [self.credentials.access_key] - scope.append(request.context['timestamp'][0:8]) - scope.append(self._region_name) - scope.append(self._service_name) - scope.append('aws4_request') - return '/'.join(scope) - - def credential_scope(self, request): - scope = [] - scope.append(request.context['timestamp'][0:8]) - scope.append(self._region_name) - scope.append(self._service_name) - scope.append('aws4_request') - return '/'.join(scope) - - def string_to_sign(self, request, canonical_request): - """ - Return the canonical StringToSign as well as a dict - containing the original version of all headers that - were included in the StringToSign. - """ - sts = ['AWS4-HMAC-SHA256'] - sts.append(request.context['timestamp']) - sts.append(self.credential_scope(request)) - sts.append(sha256(canonical_request.encode('utf-8')).hexdigest()) - return '\n'.join(sts) - - def signature(self, string_to_sign, request): - key = self.credentials.secret_key - k_date = self._sign(('AWS4' + key).encode('utf-8'), - request.context['timestamp'][0:8]) - k_region = self._sign(k_date, self._region_name) - k_service = self._sign(k_region, self._service_name) - k_signing = self._sign(k_service, 'aws4_request') - return self._sign(k_signing, string_to_sign, hex=True) - - def add_auth(self, request): - if self.credentials is None: - raise NoCredentialsError - datetime_now = datetime.datetime.utcnow() - request.context['timestamp'] = datetime_now.strftime(SIGV4_TIMESTAMP) - # This could be a retry. Make sure the previous - # authorization header is removed first. - self._modify_request_before_signing(request) - canonical_request = self.canonical_request(request) - logger.debug("Calculating signature using v4 auth.") - logger.debug('CanonicalRequest:\n%s', canonical_request) - string_to_sign = self.string_to_sign(request, canonical_request) - logger.debug('StringToSign:\n%s', string_to_sign) - signature = self.signature(string_to_sign, request) - logger.debug('Signature:\n%s', signature) - - self._inject_signature_to_request(request, signature) - - def _inject_signature_to_request(self, request, signature): - l = ['AWS4-HMAC-SHA256 Credential=%s' % self.scope(request)] - headers_to_sign = self.headers_to_sign(request) - l.append('SignedHeaders=%s' % self.signed_headers(headers_to_sign)) - l.append('Signature=%s' % signature) - request.headers['Authorization'] = ', '.join(l) - return request - - def _modify_request_before_signing(self, request): - if 'Authorization' in request.headers: - del request.headers['Authorization'] - self._set_necessary_date_headers(request) - if self.credentials.token: - if 'X-Amz-Security-Token' in request.headers: - del request.headers['X-Amz-Security-Token'] - request.headers['X-Amz-Security-Token'] = self.credentials.token - - if not request.context.get('payload_signing_enabled', True): - if 'X-Amz-Content-SHA256' in request.headers: - del request.headers['X-Amz-Content-SHA256'] - request.headers['X-Amz-Content-SHA256'] = UNSIGNED_PAYLOAD - - def _set_necessary_date_headers(self, request): - # The spec allows for either the Date _or_ the X-Amz-Date value to be - # used so we check both. If there's a Date header, we use the date - # header. Otherwise we use the X-Amz-Date header. - if 'Date' in request.headers: - del request.headers['Date'] - datetime_timestamp = datetime.datetime.strptime( - request.context['timestamp'], SIGV4_TIMESTAMP) - request.headers['Date'] = formatdate( - int(calendar.timegm(datetime_timestamp.timetuple()))) - if 'X-Amz-Date' in request.headers: - del request.headers['X-Amz-Date'] - else: - if 'X-Amz-Date' in request.headers: - del request.headers['X-Amz-Date'] - request.headers['X-Amz-Date'] = request.context['timestamp'] - - -class S3SigV4Auth(SigV4Auth): - def __init__(self, credentials, service_name, region_name): - super(S3SigV4Auth, self).__init__( - credentials, service_name, region_name) - self._default_region_name = region_name - - def add_auth(self, request): - # If we ever decide to share auth sessions, this could potentially be - # a source of concurrency bugs. - signing_context = request.context.get('signing', {}) - self._region_name = signing_context.get( - 'region', self._default_region_name) - super(S3SigV4Auth, self).add_auth(request) - - def _modify_request_before_signing(self, request): - super(S3SigV4Auth, self)._modify_request_before_signing(request) - if 'X-Amz-Content-SHA256' in request.headers: - del request.headers['X-Amz-Content-SHA256'] - - request.headers['X-Amz-Content-SHA256'] = self.payload(request) - - def _should_sha256_sign_payload(self, request): - # S3 allows optional body signing, so to minimize the performance - # impact, we opt to not SHA256 sign the body on streaming uploads, - # provided that we're on https. - client_config = request.context.get('client_config') - s3_config = getattr(client_config, 's3', None) - - # The config could be None if it isn't set, or if the customer sets it - # to None. - if s3_config is None: - s3_config = {} - - # The explicit configuration takes precedence over any implicit - # configuration. - sign_payload = s3_config.get('payload_signing_enabled', None) - if sign_payload is not None: - return sign_payload - - # We require that both content-md5 be present and https be enabled - # to implicitly disable body signing. The combination of TLS and - # content-md5 is sufficiently secure and durable for us to be - # confident in the request without body signing. - if not request.url.startswith('https') or \ - 'Content-MD5' not in request.headers: - return True - - # If the input is streaming we disable body signing by default. - if request.context.get('has_streaming_input', False): - return False - - # If the S3-specific checks had no results, delegate to the generic - # checks. - return super(S3SigV4Auth, self)._should_sha256_sign_payload(request) - - def _normalize_url_path(self, path): - # For S3, we do not normalize the path. - return path - - -class SigV4QueryAuth(SigV4Auth): - DEFAULT_EXPIRES = 3600 - - def __init__(self, credentials, service_name, region_name, - expires=DEFAULT_EXPIRES): - super(SigV4QueryAuth, self).__init__(credentials, service_name, - region_name) - self._expires = expires - - def _modify_request_before_signing(self, request): - # We automatically set this header, so if it's the auto-set value we - # want to get rid of it since it doesn't make sense for presigned urls. - content_type = request.headers.get('content-type') - blacklisted_content_type = ( - 'application/x-www-form-urlencoded; charset=utf-8' - ) - if content_type == blacklisted_content_type: - del request.headers['content-type'] - - # Note that we're not including X-Amz-Signature. - # From the docs: "The Canonical Query String must include all the query - # parameters from the preceding table except for X-Amz-Signature. - signed_headers = self.signed_headers(self.headers_to_sign(request)) - - auth_params = { - 'X-Amz-Algorithm': 'AWS4-HMAC-SHA256', - 'X-Amz-Credential': self.scope(request), - 'X-Amz-Date': request.context['timestamp'], - 'X-Amz-Expires': self._expires, - 'X-Amz-SignedHeaders': signed_headers, - } - if self.credentials.token is not None: - auth_params['X-Amz-Security-Token'] = self.credentials.token - # Now parse the original query string to a dict, inject our new query - # params, and serialize back to a query string. - url_parts = urlsplit(request.url) - # parse_qs makes each value a list, but in our case we know we won't - # have repeated keys so we know we have single element lists which we - # can convert back to scalar values. - query_dict = dict( - [(k, v[0]) for k, v in - parse_qs(url_parts.query, keep_blank_values=True).items()]) - # The spec is particular about this. It *has* to be: - # https://?& - # You can't mix the two types of params together, i.e just keep doing - # new_query_params.update(op_params) - # new_query_params.update(auth_params) - # percent_encode_sequence(new_query_params) - operation_params = '' - if request.data: - # We also need to move the body params into the query string. To - # do this, we first have to convert it to a dict. - query_dict.update(self._get_body_as_dict(request)) - request.data = '' - if query_dict: - operation_params = percent_encode_sequence(query_dict) + '&' - new_query_string = (operation_params + - percent_encode_sequence(auth_params)) - # url_parts is a tuple (and therefore immutable) so we need to create - # a new url_parts with the new query string. - # - - # scheme - 0 - # netloc - 1 - # path - 2 - # query - 3 <-- we're replacing this. - # fragment - 4 - p = url_parts - new_url_parts = (p[0], p[1], p[2], new_query_string, p[4]) - request.url = urlunsplit(new_url_parts) - - def _get_body_as_dict(self, request): - # For query services, request.data is form-encoded and is already a - # dict, but for other services such as rest-json it could be a json - # string or bytes. In those cases we attempt to load the data as a - # dict. - data = request.data - if isinstance(data, six.binary_type): - data = json.loads(data.decode('utf-8')) - elif isinstance(data, six.string_types): - data = json.loads(data) - return data - - def _inject_signature_to_request(self, request, signature): - # Rather than calculating an "Authorization" header, for the query - # param quth, we just append an 'X-Amz-Signature' param to the end - # of the query string. - request.url += '&X-Amz-Signature=%s' % signature - - -class S3SigV4QueryAuth(SigV4QueryAuth): - """S3 SigV4 auth using query parameters. - - This signer will sign a request using query parameters and signature - version 4, i.e a "presigned url" signer. - - Based off of: - - http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html - - """ - def _normalize_url_path(self, path): - # For S3, we do not normalize the path. - return path - - def payload(self, request): - # From the doc link above: - # "You don't include a payload hash in the Canonical Request, because - # when you create a presigned URL, you don't know anything about the - # payload. Instead, you use a constant string "UNSIGNED-PAYLOAD". - return UNSIGNED_PAYLOAD - - -class S3SigV4PostAuth(SigV4Auth): - """ - Presigns a s3 post - - Implementation doc here: - http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-UsingHTTPPOST.html - """ - def add_auth(self, request): - datetime_now = datetime.datetime.utcnow() - request.context['timestamp'] = datetime_now.strftime(SIGV4_TIMESTAMP) - - fields = {} - if request.context.get('s3-presign-post-fields', None) is not None: - fields = request.context['s3-presign-post-fields'] - - policy = {} - conditions = [] - if request.context.get('s3-presign-post-policy', None) is not None: - policy = request.context['s3-presign-post-policy'] - if policy.get('conditions', None) is not None: - conditions = policy['conditions'] - - policy['conditions'] = conditions - - fields['x-amz-algorithm'] = 'AWS4-HMAC-SHA256' - fields['x-amz-credential'] = self.scope(request) - fields['x-amz-date'] = request.context['timestamp'] - - conditions.append({'x-amz-algorithm': 'AWS4-HMAC-SHA256'}) - conditions.append({'x-amz-credential': self.scope(request)}) - conditions.append({'x-amz-date': request.context['timestamp']}) - - if self.credentials.token is not None: - fields['x-amz-security-token'] = self.credentials.token - conditions.append({'x-amz-security-token': self.credentials.token}) - - # Dump the base64 encoded policy into the fields dictionary. - fields['policy'] = base64.b64encode( - json.dumps(policy).encode('utf-8')).decode('utf-8') - - fields['x-amz-signature'] = self.signature(fields['policy'], request) - - request.context['s3-presign-post-fields'] = fields - request.context['s3-presign-post-policy'] = policy - - -class HmacV1Auth(BaseSigner): - - # List of Query String Arguments of Interest - QSAOfInterest = ['accelerate', 'acl', 'cors', 'defaultObjectAcl', - 'location', 'logging', 'partNumber', 'policy', - 'requestPayment', 'torrent', - 'versioning', 'versionId', 'versions', 'website', - 'uploads', 'uploadId', 'response-content-type', - 'response-content-language', 'response-expires', - 'response-cache-control', 'response-content-disposition', - 'response-content-encoding', 'delete', 'lifecycle', - 'tagging', 'restore', 'storageClass', 'notification', - 'replication', 'requestPayment', 'analytics', 'metrics', - 'inventory', 'select', 'select-type'] - - def __init__(self, credentials, service_name=None, region_name=None): - self.credentials = credentials - - def sign_string(self, string_to_sign): - new_hmac = hmac.new(self.credentials.secret_key.encode('utf-8'), - digestmod=sha1) - new_hmac.update(string_to_sign.encode('utf-8')) - return encodebytes(new_hmac.digest()).strip().decode('utf-8') - - def canonical_standard_headers(self, headers): - interesting_headers = ['content-md5', 'content-type', 'date'] - hoi = [] - if 'Date' in headers: - del headers['Date'] - headers['Date'] = self._get_date() - for ih in interesting_headers: - found = False - for key in headers: - lk = key.lower() - if headers[key] is not None and lk == ih: - hoi.append(headers[key].strip()) - found = True - if not found: - hoi.append('') - return '\n'.join(hoi) - - def canonical_custom_headers(self, headers): - hoi = [] - custom_headers = {} - for key in headers: - lk = key.lower() - if headers[key] is not None: - if lk.startswith('x-amz-'): - custom_headers[lk] = ','.join(v.strip() for v in - headers.get_all(key)) - sorted_header_keys = sorted(custom_headers.keys()) - for key in sorted_header_keys: - hoi.append("%s:%s" % (key, custom_headers[key])) - return '\n'.join(hoi) - - def unquote_v(self, nv): - """ - TODO: Do we need this? - """ - if len(nv) == 1: - return nv - else: - return (nv[0], unquote(nv[1])) - - def canonical_resource(self, split, auth_path=None): - # don't include anything after the first ? in the resource... - # unless it is one of the QSA of interest, defined above - # NOTE: - # The path in the canonical resource should always be the - # full path including the bucket name, even for virtual-hosting - # style addressing. The ``auth_path`` keeps track of the full - # path for the canonical resource and would be passed in if - # the client was using virtual-hosting style. - if auth_path is not None: - buf = auth_path - else: - buf = split.path - if split.query: - qsa = split.query.split('&') - qsa = [a.split('=', 1) for a in qsa] - qsa = [self.unquote_v(a) for a in qsa - if a[0] in self.QSAOfInterest] - if len(qsa) > 0: - qsa.sort(key=itemgetter(0)) - qsa = ['='.join(a) for a in qsa] - buf += '?' - buf += '&'.join(qsa) - return buf - - def canonical_string(self, method, split, headers, expires=None, - auth_path=None): - cs = method.upper() + '\n' - cs += self.canonical_standard_headers(headers) + '\n' - custom_headers = self.canonical_custom_headers(headers) - if custom_headers: - cs += custom_headers + '\n' - cs += self.canonical_resource(split, auth_path=auth_path) - return cs - - def get_signature(self, method, split, headers, expires=None, - auth_path=None): - if self.credentials.token: - del headers['x-amz-security-token'] - headers['x-amz-security-token'] = self.credentials.token - string_to_sign = self.canonical_string(method, - split, - headers, - auth_path=auth_path) - logger.debug('StringToSign:\n%s', string_to_sign) - return self.sign_string(string_to_sign) - - def add_auth(self, request): - if self.credentials is None: - raise NoCredentialsError - logger.debug("Calculating signature using hmacv1 auth.") - split = urlsplit(request.url) - logger.debug('HTTP request method: %s', request.method) - signature = self.get_signature(request.method, split, - request.headers, - auth_path=request.auth_path) - self._inject_signature(request, signature) - - def _get_date(self): - return formatdate(usegmt=True) - - def _inject_signature(self, request, signature): - if 'Authorization' in request.headers: - # We have to do this because request.headers is not - # normal dictionary. It has the (unintuitive) behavior - # of aggregating repeated setattr calls for the same - # key value. For example: - # headers['foo'] = 'a'; headers['foo'] = 'b' - # list(headers) will print ['foo', 'foo']. - del request.headers['Authorization'] - request.headers['Authorization'] = ( - "AWS %s:%s" % (self.credentials.access_key, signature)) - - -class HmacV1QueryAuth(HmacV1Auth): - """ - Generates a presigned request for s3. - - Spec from this document: - - http://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html - #RESTAuthenticationQueryStringAuth - - """ - DEFAULT_EXPIRES = 3600 - - def __init__(self, credentials, expires=DEFAULT_EXPIRES): - self.credentials = credentials - self._expires = expires - - def _get_date(self): - return str(int(time.time() + int(self._expires))) - - def _inject_signature(self, request, signature): - query_dict = {} - query_dict['AWSAccessKeyId'] = self.credentials.access_key - query_dict['Signature'] = signature - - for header_key in request.headers: - lk = header_key.lower() - # For query string requests, Expires is used instead of the - # Date header. - if header_key == 'Date': - query_dict['Expires'] = request.headers['Date'] - # We only want to include relevant headers in the query string. - # These can be anything that starts with x-amz, is Content-MD5, - # or is Content-Type. - elif lk.startswith('x-amz-') or lk in ['content-md5', - 'content-type']: - query_dict[lk] = request.headers[lk] - # Combine all of the identified headers into an encoded - # query string - new_query_string = percent_encode_sequence(query_dict) - - # Create a new url with the presigned url. - p = urlsplit(request.url) - if p[3]: - # If there was a pre-existing query string, we should - # add that back before injecting the new query string. - new_query_string = '%s&%s' % (p[3], new_query_string) - new_url_parts = (p[0], p[1], p[2], new_query_string, p[4]) - request.url = urlunsplit(new_url_parts) - - -class HmacV1PostAuth(HmacV1Auth): - """ - Generates a presigned post for s3. - - Spec from this document: - - http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingHTTPPOST.html - """ - def add_auth(self, request): - fields = {} - if request.context.get('s3-presign-post-fields', None) is not None: - fields = request.context['s3-presign-post-fields'] - - policy = {} - conditions = [] - if request.context.get('s3-presign-post-policy', None) is not None: - policy = request.context['s3-presign-post-policy'] - if policy.get('conditions', None) is not None: - conditions = policy['conditions'] - - policy['conditions'] = conditions - - fields['AWSAccessKeyId'] = self.credentials.access_key - - if self.credentials.token is not None: - fields['x-amz-security-token'] = self.credentials.token - conditions.append({'x-amz-security-token': self.credentials.token}) - - # Dump the base64 encoded policy into the fields dictionary. - fields['policy'] = base64.b64encode( - json.dumps(policy).encode('utf-8')).decode('utf-8') - - fields['signature'] = self.sign_string(fields['policy']) - - request.context['s3-presign-post-fields'] = fields - request.context['s3-presign-post-policy'] = policy - - -# Defined at the bottom instead of the top of the module because the Auth -# classes weren't defined yet. -AUTH_TYPE_MAPS = { - 'v2': SigV2Auth, - 'v4': SigV4Auth, - 'v4-query': SigV4QueryAuth, - 'v3': SigV3Auth, - 'v3https': SigV3Auth, - 's3': HmacV1Auth, - 's3-query': HmacV1QueryAuth, - 's3-presign-post': HmacV1PostAuth, - 's3v4': S3SigV4Auth, - 's3v4-query': S3SigV4QueryAuth, - 's3v4-presign-post': S3SigV4PostAuth, - -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/awsrequest.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/awsrequest.py deleted file mode 100644 index c26ebc07..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/awsrequest.py +++ /dev/null @@ -1,455 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import sys -import logging -import select -import functools -import socket -import inspect - -from botocore.compat import six -from botocore.compat import HTTPHeaders, HTTPResponse, urlunsplit, urlsplit,\ - urlparse -from botocore.exceptions import UnseekableStreamError -from botocore.utils import percent_encode_sequence -from botocore.vendored.requests import models -from botocore.vendored.requests.sessions import REDIRECT_STATI -from botocore.vendored.requests.packages.urllib3.connection import \ - VerifiedHTTPSConnection -from botocore.vendored.requests.packages.urllib3.connection import \ - HTTPConnection -from botocore.vendored.requests.packages.urllib3.connectionpool import \ - HTTPConnectionPool -from botocore.vendored.requests.packages.urllib3.connectionpool import \ - HTTPSConnectionPool - - -logger = logging.getLogger(__name__) - - -class AWSHTTPResponse(HTTPResponse): - # The *args, **kwargs is used because the args are slightly - # different in py2.6 than in py2.7/py3. - def __init__(self, *args, **kwargs): - self._status_tuple = kwargs.pop('status_tuple') - HTTPResponse.__init__(self, *args, **kwargs) - - def _read_status(self): - if self._status_tuple is not None: - status_tuple = self._status_tuple - self._status_tuple = None - return status_tuple - else: - return HTTPResponse._read_status(self) - - -class AWSHTTPConnection(HTTPConnection): - """HTTPConnection that supports Expect 100-continue. - - This is conceptually a subclass of httplib.HTTPConnection (though - technically we subclass from urllib3, which subclasses - httplib.HTTPConnection) and we only override this class to support Expect - 100-continue, which we need for S3. As far as I can tell, this is - general purpose enough to not be specific to S3, but I'm being - tentative and keeping it in botocore because I've only tested - this against AWS services. - - """ - def __init__(self, *args, **kwargs): - HTTPConnection.__init__(self, *args, **kwargs) - self._original_response_cls = self.response_class - # We'd ideally hook into httplib's states, but they're all - # __mangled_vars so we use our own state var. This variable is set - # when we receive an early response from the server. If this value is - # set to True, any calls to send() are noops. This value is reset to - # false every time _send_request is called. This is to workaround the - # fact that py2.6 (and only py2.6) has a separate send() call for the - # body in _send_request, as opposed to endheaders(), which is where the - # body is sent in all versions > 2.6. - self._response_received = False - self._expect_header_set = False - - def close(self): - HTTPConnection.close(self) - # Reset all of our instance state we were tracking. - self._response_received = False - self._expect_header_set = False - self.response_class = self._original_response_cls - - def _tunnel(self): - # Works around a bug in py26 which is fixed in later versions of - # python. Bug involves hitting an infinite loop if readline() returns - # nothing as opposed to just ``\r\n``. - # As much as I don't like having if py2: code blocks, this seems - # the cleanest way to handle this workaround. Fortunately, the - # difference from py26 to py3 is very minimal. We're essentially - # just overriding the while loop. - if sys.version_info[:2] != (2, 6): - return HTTPConnection._tunnel(self) - - # Otherwise we workaround the issue. - self._set_hostport(self._tunnel_host, self._tunnel_port) - self.send("CONNECT %s:%d HTTP/1.0\r\n" % (self.host, self.port)) - for header, value in self._tunnel_headers.iteritems(): - self.send("%s: %s\r\n" % (header, value)) - self.send("\r\n") - response = self.response_class(self.sock, strict=self.strict, - method=self._method) - (version, code, message) = response._read_status() - - if code != 200: - self.close() - raise socket.error("Tunnel connection failed: %d %s" % - (code, message.strip())) - while True: - line = response.fp.readline() - if not line: - break - if line in (b'\r\n', b'\n', b''): - break - - def _send_request(self, method, url, body, headers, *args, **kwargs): - self._response_received = False - if headers.get('Expect', b'') == b'100-continue': - self._expect_header_set = True - else: - self._expect_header_set = False - self.response_class = self._original_response_cls - rval = HTTPConnection._send_request( - self, method, url, body, headers, *args, **kwargs) - self._expect_header_set = False - return rval - - def _convert_to_bytes(self, mixed_buffer): - # Take a list of mixed str/bytes and convert it - # all into a single bytestring. - # Any six.text_types will be encoded as utf-8. - bytes_buffer = [] - for chunk in mixed_buffer: - if isinstance(chunk, six.text_type): - bytes_buffer.append(chunk.encode('utf-8')) - else: - bytes_buffer.append(chunk) - msg = b"\r\n".join(bytes_buffer) - return msg - - def _send_output(self, message_body=None, *args, **kwargs): - self._buffer.extend((b"", b"")) - msg = self._convert_to_bytes(self._buffer) - del self._buffer[:] - # If msg and message_body are sent in a single send() call, - # it will avoid performance problems caused by the interaction - # between delayed ack and the Nagle algorithm. - if isinstance(message_body, bytes): - msg += message_body - message_body = None - self.send(msg) - if self._expect_header_set: - # This is our custom behavior. If the Expect header was - # set, it will trigger this custom behavior. - logger.debug("Waiting for 100 Continue response.") - # Wait for 1 second for the server to send a response. - read, write, exc = select.select([self.sock], [], [self.sock], 1) - if read: - self._handle_expect_response(message_body) - return - else: - # From the RFC: - # Because of the presence of older implementations, the - # protocol allows ambiguous situations in which a client may - # send "Expect: 100-continue" without receiving either a 417 - # (Expectation Failed) status or a 100 (Continue) status. - # Therefore, when a client sends this header field to an origin - # server (possibly via a proxy) from which it has never seen a - # 100 (Continue) status, the client SHOULD NOT wait for an - # indefinite period before sending the request body. - logger.debug("No response seen from server, continuing to " - "send the response body.") - if message_body is not None: - # message_body was not a string (i.e. it is a file), and - # we must run the risk of Nagle. - self.send(message_body) - - def _consume_headers(self, fp): - # Most servers (including S3) will just return - # the CLRF after the 100 continue response. However, - # some servers (I've specifically seen this for squid when - # used as a straight HTTP proxy) will also inject a - # Connection: keep-alive header. To account for this - # we'll read until we read '\r\n', and ignore any headers - # that come immediately after the 100 continue response. - current = None - while current != b'\r\n': - current = fp.readline() - - def _handle_expect_response(self, message_body): - # This is called when we sent the request headers containing - # an Expect: 100-continue header and received a response. - # We now need to figure out what to do. - fp = self.sock.makefile('rb', 0) - try: - maybe_status_line = fp.readline() - parts = maybe_status_line.split(None, 2) - if self._is_100_continue_status(maybe_status_line): - self._consume_headers(fp) - logger.debug("100 Continue response seen, " - "now sending request body.") - self._send_message_body(message_body) - elif len(parts) == 3 and parts[0].startswith(b'HTTP/'): - # From the RFC: - # Requirements for HTTP/1.1 origin servers: - # - # - Upon receiving a request which includes an Expect - # request-header field with the "100-continue" - # expectation, an origin server MUST either respond with - # 100 (Continue) status and continue to read from the - # input stream, or respond with a final status code. - # - # So if we don't get a 100 Continue response, then - # whatever the server has sent back is the final response - # and don't send the message_body. - logger.debug("Received a non 100 Continue response " - "from the server, NOT sending request body.") - status_tuple = (parts[0].decode('ascii'), - int(parts[1]), parts[2].decode('ascii')) - response_class = functools.partial( - AWSHTTPResponse, status_tuple=status_tuple) - self.response_class = response_class - self._response_received = True - finally: - fp.close() - - def _send_message_body(self, message_body): - if message_body is not None: - self.send(message_body) - - def send(self, str): - if self._response_received: - logger.debug("send() called, but reseponse already received. " - "Not sending data.") - return - return HTTPConnection.send(self, str) - - def _is_100_continue_status(self, maybe_status_line): - parts = maybe_status_line.split(None, 2) - # Check for HTTP/ 100 Continue\r\n - return ( - len(parts) >= 3 and parts[0].startswith(b'HTTP/') and - parts[1] == b'100') - - -class AWSHTTPSConnection(VerifiedHTTPSConnection): - pass - - -# Now we need to set the methods we overrode from AWSHTTPConnection -# onto AWSHTTPSConnection. This is just a shortcut to avoid -# copy/pasting the same code into AWSHTTPSConnection. -for name, function in AWSHTTPConnection.__dict__.items(): - if inspect.isfunction(function): - setattr(AWSHTTPSConnection, name, function) - - -def prepare_request_dict(request_dict, endpoint_url, context=None, - user_agent=None): - """ - This method prepares a request dict to be created into an - AWSRequestObject. This prepares the request dict by adding the - url and the user agent to the request dict. - - :type request_dict: dict - :param request_dict: The request dict (created from the - ``serialize`` module). - - :type user_agent: string - :param user_agent: The user agent to use for this request. - - :type endpoint_url: string - :param endpoint_url: The full endpoint url, which contains at least - the scheme, the hostname, and optionally any path components. - """ - r = request_dict - if user_agent is not None: - headers = r['headers'] - headers['User-Agent'] = user_agent - url = _urljoin(endpoint_url, r['url_path']) - if r['query_string']: - encoded_query_string = percent_encode_sequence(r['query_string']) - if '?' not in url: - url += '?%s' % encoded_query_string - else: - url += '&%s' % encoded_query_string - r['url'] = url - r['context'] = context - if context is None: - r['context'] = {} - - -def create_request_object(request_dict): - """ - This method takes a request dict and creates an AWSRequest object - from it. - - :type request_dict: dict - :param request_dict: The request dict (created from the - ``prepare_request_dict`` method). - - :rtype: ``botocore.awsrequest.AWSRequest`` - :return: An AWSRequest object based on the request_dict. - - """ - r = request_dict - request_object = AWSRequest( - method=r['method'], url=r['url'], data=r['body'], headers=r['headers']) - request_object.context.update(r['context']) - return request_object - - -def _urljoin(endpoint_url, url_path): - p = urlsplit(endpoint_url) - # - - # scheme - p[0] - # netloc - p[1] - # path - p[2] - # query - p[3] - # fragment - p[4] - if not url_path or url_path == '/': - # If there's no path component, ensure the URL ends with - # a '/' for backwards compatibility. - if not p[2]: - return endpoint_url + '/' - return endpoint_url - if p[2].endswith('/') and url_path.startswith('/'): - new_path = p[2][:-1] + url_path - else: - new_path = p[2] + url_path - reconstructed = urlunsplit((p[0], p[1], new_path, p[3], p[4])) - return reconstructed - - -class AWSRequest(models.RequestEncodingMixin, models.Request): - def __init__(self, *args, **kwargs): - self.auth_path = None - if 'auth_path' in kwargs: - self.auth_path = kwargs['auth_path'] - del kwargs['auth_path'] - models.Request.__init__(self, *args, **kwargs) - headers = HTTPHeaders() - if self.headers is not None: - for key, value in self.headers.items(): - headers[key] = value - self.headers = headers - # This is a dictionary to hold information that is used when - # processing the request. What is inside of ``context`` is open-ended. - # For example, it may have a timestamp key that is used for holding - # what the timestamp is when signing the request. Note that none - # of the information that is inside of ``context`` is directly - # sent over the wire; the information is only used to assist in - # creating what is sent over the wire. - self.context = {} - - def prepare(self): - """Constructs a :class:`AWSPreparedRequest `.""" - # Eventually I think it would be nice to add hooks into this process. - p = AWSPreparedRequest(self) - p.prepare_method(self.method) - p.prepare_url(self.url, self.params) - p.prepare_headers(self.headers) - p.prepare_cookies(self.cookies) - p.prepare_body(self.data, self.files) - p.prepare_auth(self.auth) - return p - - @property - def body(self): - p = models.PreparedRequest() - p.prepare_headers({}) - p.prepare_body(self.data, self.files) - if isinstance(p.body, six.text_type): - p.body = p.body.encode('utf-8') - return p.body - - -class AWSPreparedRequest(models.PreparedRequest): - """Represents a prepared request. - - :ivar method: HTTP Method - :ivar url: The full url - :ivar headers: The HTTP headers to send. - :ivar body: The HTTP body. - :ivar hooks: The set of callback hooks. - - In addition to the above attributes, the following attributes are - available: - - :ivar query_params: The original query parameters. - :ivar post_param: The original POST params (dict). - - """ - def __init__(self, original_request): - self.original = original_request - super(AWSPreparedRequest, self).__init__() - self.hooks.setdefault('response', []).append( - self.reset_stream_on_redirect) - - def reset_stream_on_redirect(self, response, **kwargs): - if response.status_code in REDIRECT_STATI and \ - self._looks_like_file(self.body): - logger.debug("Redirect received, rewinding stream: %s", self.body) - self.reset_stream() - - def _looks_like_file(self, body): - return hasattr(body, 'read') and hasattr(body, 'seek') - - def reset_stream(self): - # Trying to reset a stream when there is a no stream will - # just immediately return. It's not an error, it will produce - # the same result as if we had actually reset the stream (we'll send - # the entire body contents again if we need to). - # Same case if the body is a string/bytes type. - if self.body is None or isinstance(self.body, six.text_type) or \ - isinstance(self.body, six.binary_type): - return - try: - logger.debug("Rewinding stream: %s", self.body) - self.body.seek(0) - except Exception as e: - logger.debug("Unable to rewind stream: %s", e) - raise UnseekableStreamError(stream_object=self.body) - - def prepare_body(self, data, files, json=None): - """Prepares the given HTTP body data.""" - super(AWSPreparedRequest, self).prepare_body(data, files, json) - - # Calculate the Content-Length by trying to seek the file as - # requests cannot determine content length for some seekable file-like - # objects. - if 'Content-Length' not in self.headers: - if hasattr(data, 'seek') and hasattr(data, 'tell'): - orig_pos = data.tell() - data.seek(0, 2) - end_file_pos = data.tell() - self.headers['Content-Length'] = str(end_file_pos - orig_pos) - data.seek(orig_pos) - # If the Content-Length was added this way, a - # Transfer-Encoding was added by requests because it did - # not add a Content-Length header. However, the - # Transfer-Encoding header is not supported for - # AWS Services so remove it if it is added. - if 'Transfer-Encoding' in self.headers: - self.headers.pop('Transfer-Encoding') - - -HTTPSConnectionPool.ConnectionCls = AWSHTTPSConnection -HTTPConnectionPool.ConnectionCls = AWSHTTPConnection diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/client.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/client.py deleted file mode 100644 index d34d4b1a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/client.py +++ /dev/null @@ -1,864 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import logging -import functools - -from botocore import waiter, xform_name -from botocore.auth import AUTH_TYPE_MAPS -from botocore.awsrequest import prepare_request_dict -from botocore.docs.docstring import ClientMethodDocstring -from botocore.docs.docstring import PaginatorDocstring -from botocore.exceptions import ClientError, DataNotFoundError -from botocore.exceptions import OperationNotPageableError -from botocore.exceptions import UnknownSignatureVersionError -from botocore.hooks import first_non_none_response -from botocore.model import ServiceModel -from botocore.paginate import Paginator -from botocore.utils import CachedProperty -from botocore.utils import get_service_module_name -from botocore.utils import switch_host_s3_accelerate -from botocore.utils import S3RegionRedirector -from botocore.utils import fix_s3_host -from botocore.utils import switch_to_virtual_host_style -from botocore.utils import S3_ACCELERATE_WHITELIST -from botocore.args import ClientArgsCreator -from botocore.compat import urlsplit -from botocore import UNSIGNED -# Keep this imported. There's pre-existing code that uses -# "from botocore.client import Config". -from botocore.config import Config -from botocore.history import get_global_history_recorder - - -logger = logging.getLogger(__name__) -history_recorder = get_global_history_recorder() - - -class ClientCreator(object): - """Creates client objects for a service.""" - def __init__(self, loader, endpoint_resolver, user_agent, event_emitter, - retry_handler_factory, retry_config_translator, - response_parser_factory=None, exceptions_factory=None): - self._loader = loader - self._endpoint_resolver = endpoint_resolver - self._user_agent = user_agent - self._event_emitter = event_emitter - self._retry_handler_factory = retry_handler_factory - self._retry_config_translator = retry_config_translator - self._response_parser_factory = response_parser_factory - self._exceptions_factory = exceptions_factory - - def create_client(self, service_name, region_name, is_secure=True, - endpoint_url=None, verify=None, - credentials=None, scoped_config=None, - api_version=None, - client_config=None): - responses = self._event_emitter.emit( - 'choose-service-name', service_name=service_name) - service_name = first_non_none_response(responses, default=service_name) - service_model = self._load_service_model(service_name, api_version) - cls = self._create_client_class(service_name, service_model) - endpoint_bridge = ClientEndpointBridge( - self._endpoint_resolver, scoped_config, client_config, - service_signing_name=service_model.metadata.get('signingName')) - client_args = self._get_client_args( - service_model, region_name, is_secure, endpoint_url, - verify, credentials, scoped_config, client_config, endpoint_bridge) - service_client = cls(**client_args) - self._register_retries(service_client) - self._register_s3_events( - service_client, endpoint_bridge, endpoint_url, client_config, - scoped_config) - return service_client - - def create_client_class(self, service_name, api_version=None): - service_model = self._load_service_model(service_name, api_version) - return self._create_client_class(service_name, service_model) - - def _create_client_class(self, service_name, service_model): - class_attributes = self._create_methods(service_model) - py_name_to_operation_name = self._create_name_mapping(service_model) - class_attributes['_PY_TO_OP_NAME'] = py_name_to_operation_name - bases = [BaseClient] - self._event_emitter.emit('creating-client-class.%s' % service_name, - class_attributes=class_attributes, - base_classes=bases) - class_name = get_service_module_name(service_model) - cls = type(str(class_name), tuple(bases), class_attributes) - return cls - - def _load_service_model(self, service_name, api_version=None): - json_model = self._loader.load_service_model(service_name, 'service-2', - api_version=api_version) - service_model = ServiceModel(json_model, service_name=service_name) - return service_model - - def _register_retries(self, client): - endpoint_prefix = client.meta.service_model.endpoint_prefix - - # First, we load the entire retry config for all services, - # then pull out just the information we need. - original_config = self._loader.load_data('_retry') - if not original_config: - return - - retry_config = self._retry_config_translator.build_retry_config( - endpoint_prefix, original_config.get('retry', {}), - original_config.get('definitions', {}), - client.meta.config.retries - ) - - logger.debug("Registering retry handlers for service: %s", - client.meta.service_model.service_name) - handler = self._retry_handler_factory.create_retry_handler( - retry_config, endpoint_prefix) - unique_id = 'retry-config-%s' % endpoint_prefix - client.meta.events.register('needs-retry.%s' % endpoint_prefix, - handler, unique_id=unique_id) - - def _register_s3_events(self, client, endpoint_bridge, endpoint_url, - client_config, scoped_config): - if client.meta.service_model.service_name != 's3': - return - S3RegionRedirector(endpoint_bridge, client).register() - self._set_s3_addressing_style( - endpoint_url, client.meta.config.s3, client.meta.events, - client.meta.partition - ) - # Enable accelerate if the configuration is set to to true or the - # endpoint being used matches one of the accelerate endpoints. - if self._is_s3_accelerate(endpoint_url, client.meta.config.s3): - # Also make sure that the hostname gets switched to - # s3-accelerate.amazonaws.com - client.meta.events.register_first( - 'before-sign.s3', switch_host_s3_accelerate) - - self._set_s3_presign_signature_version( - client.meta, client_config, scoped_config) - - def _set_s3_addressing_style(self, endpoint_url, s3_config, event_emitter, - partition): - if s3_config is None: - s3_config = {} - - addressing_style = self._get_s3_addressing_style( - endpoint_url, s3_config) - handler = self._get_s3_addressing_handler( - endpoint_url, s3_config, addressing_style, partition) - if handler is not None: - event_emitter.register('before-sign.s3', handler) - - def _get_s3_addressing_style(self, endpoint_url, s3_config): - # Use virtual host style addressing if accelerate is enabled or if - # the given endpoint url is an accelerate endpoint. - accelerate = s3_config.get('use_accelerate_endpoint', False) - if accelerate or self._is_s3_accelerate(endpoint_url, s3_config): - return 'virtual' - - # If a particular addressing style is configured, use it. - configured_addressing_style = s3_config.get('addressing_style') - if configured_addressing_style: - return configured_addressing_style - - def _get_s3_addressing_handler(self, endpoint_url, s3_config, - addressing_style, partition): - # If virtual host style was configured, use it regardless of whether - # or not the bucket looks dns compatible. - if addressing_style == 'virtual': - logger.debug("Using S3 virtual host style addressing.") - return switch_to_virtual_host_style - - # If path style is configured, no additional steps are needed. If - # endpoint_url was specified, don't default to virtual. We could - # potentially default provided endpoint urls to virtual hosted - # style, but for now it is avoided. - if addressing_style == 'path' or endpoint_url is not None: - logger.debug("Using S3 path style addressing.") - return None - - logger.debug("Defaulting to S3 virtual host style addressing with " - "path style addressing fallback.") - - # By default, try to use virtual style with path fallback. - return fix_s3_host - - def _is_s3_accelerate(self, endpoint_url, s3_config): - # Accelerate has been explicitly configured. - if s3_config is not None and s3_config.get('use_accelerate_endpoint'): - return True - - # Accelerate mode is turned on automatically if an endpoint url is - # provided that matches the accelerate scheme. - if endpoint_url is None: - return False - - # Accelerate is only valid for Amazon endpoints. - netloc = urlsplit(endpoint_url).netloc - if not netloc.endswith('amazonaws.com'): - return False - - # The first part of the url should always be s3-accelerate. - parts = netloc.split('.') - if parts[0] != 's3-accelerate': - return False - - # Url parts between 's3-accelerate' and 'amazonaws.com' which - # represent different url features. - feature_parts = parts[1:-2] - - # There should be no duplicate url parts. - if len(feature_parts) != len(set(feature_parts)): - return False - - # Remaining parts must all be in the whitelist. - return all(p in S3_ACCELERATE_WHITELIST for p in feature_parts) - - def _set_s3_presign_signature_version(self, client_meta, - client_config, scoped_config): - # This will return the manually configured signature version, or None - # if none was manually set. If a customer manually sets the signature - # version, we always want to use what they set. - provided_signature_version = _get_configured_signature_version( - 's3', client_config, scoped_config) - if provided_signature_version is not None: - return - - # Check to see if the region is a region that we know about. If we - # don't know about a region, then we can safely assume it's a new - # region that is sigv4 only, since all new S3 regions only allow sigv4. - regions = self._endpoint_resolver.get_available_endpoints( - 's3', client_meta.partition) - if client_meta.region_name not in regions: - return - - # If it is a region we know about, we want to default to sigv2, so here - # we check to see if it is available. - endpoint = self._endpoint_resolver.construct_endpoint( - 's3', client_meta.region_name) - signature_versions = endpoint['signatureVersions'] - if 's3' not in signature_versions: - return - - # We now know that we're in a known region that supports sigv2 and - # the customer hasn't set a signature version so we default the - # signature version to sigv2. - client_meta.events.register( - 'choose-signer.s3', self._default_s3_presign_to_sigv2) - - def _default_s3_presign_to_sigv2(self, signature_version, **kwargs): - """ - Returns the 's3' (sigv2) signer if presigning an s3 request. This is - intended to be used to set the default signature version for the signer - to sigv2. - - :type signature_version: str - :param signature_version: The current client signature version. - - :type signing_name: str - :param signing_name: The signing name of the service. - - :return: 's3' if the request is an s3 presign request, None otherwise - """ - for suffix in ['-query', '-presign-post']: - if signature_version.endswith(suffix): - return 's3' + suffix - - def _get_client_args(self, service_model, region_name, is_secure, - endpoint_url, verify, credentials, - scoped_config, client_config, endpoint_bridge): - args_creator = ClientArgsCreator( - self._event_emitter, self._user_agent, - self._response_parser_factory, self._loader, - self._exceptions_factory) - return args_creator.get_client_args( - service_model, region_name, is_secure, endpoint_url, - verify, credentials, scoped_config, client_config, endpoint_bridge) - - def _create_methods(self, service_model): - op_dict = {} - for operation_name in service_model.operation_names: - py_operation_name = xform_name(operation_name) - op_dict[py_operation_name] = self._create_api_method( - py_operation_name, operation_name, service_model) - return op_dict - - def _create_name_mapping(self, service_model): - # py_name -> OperationName, for every operation available - # for a service. - mapping = {} - for operation_name in service_model.operation_names: - py_operation_name = xform_name(operation_name) - mapping[py_operation_name] = operation_name - return mapping - - def _create_api_method(self, py_operation_name, operation_name, - service_model): - def _api_call(self, *args, **kwargs): - # We're accepting *args so that we can give a more helpful - # error message than TypeError: _api_call takes exactly - # 1 argument. - if args: - raise TypeError( - "%s() only accepts keyword arguments." % py_operation_name) - # The "self" in this scope is referring to the BaseClient. - return self._make_api_call(operation_name, kwargs) - - _api_call.__name__ = str(py_operation_name) - - # Add the docstring to the client method - operation_model = service_model.operation_model(operation_name) - docstring = ClientMethodDocstring( - operation_model=operation_model, - method_name=operation_name, - event_emitter=self._event_emitter, - method_description=operation_model.documentation, - example_prefix='response = client.%s' % py_operation_name, - include_signature=False - ) - _api_call.__doc__ = docstring - return _api_call - - -class ClientEndpointBridge(object): - """Bridges endpoint data and client creation - - This class handles taking out the relevant arguments from the endpoint - resolver and determining which values to use, taking into account any - client configuration options and scope configuration options. - - This class also handles determining what, if any, region to use if no - explicit region setting is provided. For example, Amazon S3 client will - utilize "us-east-1" by default if no region can be resolved.""" - - DEFAULT_ENDPOINT = '{service}.{region}.amazonaws.com' - - def __init__(self, endpoint_resolver, scoped_config=None, - client_config=None, default_endpoint=None, - service_signing_name=None): - self.service_signing_name = service_signing_name - self.endpoint_resolver = endpoint_resolver - self.scoped_config = scoped_config - self.client_config = client_config - self.default_endpoint = default_endpoint or self.DEFAULT_ENDPOINT - - def resolve(self, service_name, region_name=None, endpoint_url=None, - is_secure=True): - region_name = self._check_default_region(service_name, region_name) - resolved = self.endpoint_resolver.construct_endpoint( - service_name, region_name) - if resolved: - return self._create_endpoint( - resolved, service_name, region_name, endpoint_url, is_secure) - else: - return self._assume_endpoint(service_name, region_name, - endpoint_url, is_secure) - - def _check_default_region(self, service_name, region_name): - if region_name is not None: - return region_name - # Use the client_config region if no explicit region was provided. - if self.client_config and self.client_config.region_name is not None: - return self.client_config.region_name - - def _create_endpoint(self, resolved, service_name, region_name, - endpoint_url, is_secure): - region_name, signing_region = self._pick_region_values( - resolved, region_name, endpoint_url) - if endpoint_url is None: - if self._is_s3_dualstack_mode(service_name): - endpoint_url = self._create_dualstack_endpoint( - service_name, region_name, - resolved['dnsSuffix'], is_secure) - else: - # Use the sslCommonName over the hostname for Python 2.6 compat. - hostname = resolved.get('sslCommonName', resolved.get('hostname')) - endpoint_url = self._make_url(hostname, is_secure, - resolved.get('protocols', [])) - signature_version = self._resolve_signature_version( - service_name, resolved) - signing_name = self._resolve_signing_name(service_name, resolved) - return self._create_result( - service_name=service_name, region_name=region_name, - signing_region=signing_region, signing_name=signing_name, - endpoint_url=endpoint_url, metadata=resolved, - signature_version=signature_version) - - def _is_s3_dualstack_mode(self, service_name): - if service_name != 's3': - return False - # TODO: This normalization logic is duplicated from the - # ClientArgsCreator class. Consolidate everything to - # ClientArgsCreator. _resolve_signature_version also has similarly - # duplicated logic. - client_config = self.client_config - if client_config is not None and client_config.s3 is not None and \ - 'use_dualstack_endpoint' in client_config.s3: - # Client config trumps scoped config. - return client_config.s3['use_dualstack_endpoint'] - if self.scoped_config is None: - return False - enabled = self.scoped_config.get('s3', {}).get( - 'use_dualstack_endpoint', False) - if enabled in [True, 'True', 'true']: - return True - return False - - def _create_dualstack_endpoint(self, service_name, region_name, - dns_suffix, is_secure): - hostname = '{service}.dualstack.{region}.{dns_suffix}'.format( - service=service_name, region=region_name, - dns_suffix=dns_suffix) - # Dualstack supports http and https so were hardcoding this value for - # now. This can potentially move into the endpoints.json file. - return self._make_url(hostname, is_secure, ['http', 'https']) - - def _assume_endpoint(self, service_name, region_name, endpoint_url, - is_secure): - if endpoint_url is None: - # Expand the default hostname URI template. - hostname = self.default_endpoint.format( - service=service_name, region=region_name) - endpoint_url = self._make_url(hostname, is_secure, - ['http', 'https']) - logger.debug('Assuming an endpoint for %s, %s: %s', - service_name, region_name, endpoint_url) - # We still want to allow the user to provide an explicit version. - signature_version = self._resolve_signature_version( - service_name, {'signatureVersions': ['v4']}) - signing_name = self._resolve_signing_name(service_name, resolved={}) - return self._create_result( - service_name=service_name, region_name=region_name, - signing_region=region_name, signing_name=signing_name, - signature_version=signature_version, endpoint_url=endpoint_url, - metadata={}) - - def _create_result(self, service_name, region_name, signing_region, - signing_name, endpoint_url, signature_version, - metadata): - return { - 'service_name': service_name, - 'region_name': region_name, - 'signing_region': signing_region, - 'signing_name': signing_name, - 'endpoint_url': endpoint_url, - 'signature_version': signature_version, - 'metadata': metadata - } - - def _make_url(self, hostname, is_secure, supported_protocols): - if is_secure and 'https' in supported_protocols: - scheme = 'https' - else: - scheme = 'http' - return '%s://%s' % (scheme, hostname) - - def _resolve_signing_name(self, service_name, resolved): - # CredentialScope overrides everything else. - if 'credentialScope' in resolved \ - and 'service' in resolved['credentialScope']: - return resolved['credentialScope']['service'] - # Use the signingName from the model if present. - if self.service_signing_name: - return self.service_signing_name - # Just assume is the same as the service name. - return service_name - - def _pick_region_values(self, resolved, region_name, endpoint_url): - signing_region = region_name - if endpoint_url is None: - # Do not use the region name or signing name from the resolved - # endpoint if the user explicitly provides an endpoint_url. This - # would happen if we resolve to an endpoint where the service has - # a "defaults" section that overrides all endpoint with a single - # hostname and credentialScope. This has been the case historically - # for how STS has worked. The only way to resolve an STS endpoint - # was to provide a region_name and an endpoint_url. In that case, - # we would still resolve an endpoint, but we would not use the - # resolved endpointName or signingRegion because we want to allow - # custom endpoints. - region_name = resolved['endpointName'] - signing_region = region_name - if 'credentialScope' in resolved \ - and 'region' in resolved['credentialScope']: - signing_region = resolved['credentialScope']['region'] - return region_name, signing_region - - def _resolve_signature_version(self, service_name, resolved): - configured_version = _get_configured_signature_version( - service_name, self.client_config, self.scoped_config) - if configured_version is not None: - return configured_version - - # Pick a signature version from the endpoint metadata if present. - if 'signatureVersions' in resolved: - potential_versions = resolved['signatureVersions'] - if service_name == 's3': - return 's3v4' - if 'v4' in potential_versions: - return 'v4' - # Now just iterate over the signature versions in order until we - # find the first one that is known to Botocore. - for known in AUTH_TYPE_MAPS: - if known in potential_versions: - return known - raise UnknownSignatureVersionError( - signature_version=resolved.get('signatureVersions')) - - -class BaseClient(object): - - # This is actually reassigned with the py->op_name mapping - # when the client creator creates the subclass. This value is used - # because calls such as client.get_paginator('list_objects') use the - # snake_case name, but we need to know the ListObjects form. - # xform_name() does the ListObjects->list_objects conversion, but - # we need the reverse mapping here. - _PY_TO_OP_NAME = {} - - def __init__(self, serializer, endpoint, response_parser, - event_emitter, request_signer, service_model, loader, - client_config, partition, exceptions_factory): - self._serializer = serializer - self._endpoint = endpoint - self._response_parser = response_parser - self._request_signer = request_signer - self._cache = {} - self._loader = loader - self._client_config = client_config - self.meta = ClientMeta(event_emitter, self._client_config, - endpoint.host, service_model, - self._PY_TO_OP_NAME, partition) - self._exceptions_factory = exceptions_factory - self._exceptions = None - self._register_handlers() - - def __getattr__(self, item): - event_name = 'getattr.%s.%s' % (self._service_model.service_name, item) - handler, event_response = self.meta.events.emit_until_response( - event_name, client=self) - - if event_response is not None: - return event_response - - raise AttributeError( - "'%s' object has no attribute '%s'" % ( - self.__class__.__name__, item) - ) - - def _register_handlers(self): - # Register the handler required to sign requests. - self.meta.events.register('request-created.%s' % - self.meta.service_model.endpoint_prefix, - self._request_signer.handler) - - @property - def _service_model(self): - return self.meta.service_model - - def _make_api_call(self, operation_name, api_params): - operation_model = self._service_model.operation_model(operation_name) - service_name = self._service_model.service_name - history_recorder.record('API_CALL', { - 'service': service_name, - 'operation': operation_name, - 'params': api_params, - }) - if operation_model.deprecated: - logger.debug('Warning: %s.%s() is deprecated', - service_name, operation_name) - request_context = { - 'client_region': self.meta.region_name, - 'client_config': self.meta.config, - 'has_streaming_input': operation_model.has_streaming_input, - 'auth_type': operation_model.auth_type, - } - request_dict = self._convert_to_request_dict( - api_params, operation_model, context=request_context) - - handler, event_response = self.meta.events.emit_until_response( - 'before-call.{endpoint_prefix}.{operation_name}'.format( - endpoint_prefix=self._service_model.endpoint_prefix, - operation_name=operation_name), - model=operation_model, params=request_dict, - request_signer=self._request_signer, context=request_context) - - if event_response is not None: - http, parsed_response = event_response - else: - http, parsed_response = self._endpoint.make_request( - operation_model, request_dict) - - self.meta.events.emit( - 'after-call.{endpoint_prefix}.{operation_name}'.format( - endpoint_prefix=self._service_model.endpoint_prefix, - operation_name=operation_name), - http_response=http, parsed=parsed_response, - model=operation_model, context=request_context - ) - - if http.status_code >= 300: - error_code = parsed_response.get("Error", {}).get("Code") - error_class = self.exceptions.from_code(error_code) - raise error_class(parsed_response, operation_name) - else: - return parsed_response - - def _convert_to_request_dict(self, api_params, operation_model, - context=None): - api_params = self._emit_api_params( - api_params, operation_model, context) - request_dict = self._serializer.serialize_to_request( - api_params, operation_model) - prepare_request_dict(request_dict, endpoint_url=self._endpoint.host, - user_agent=self._client_config.user_agent, - context=context) - return request_dict - - def _emit_api_params(self, api_params, operation_model, context): - # Given the API params provided by the user and the operation_model - # we can serialize the request to a request_dict. - operation_name = operation_model.name - - # Emit an event that allows users to modify the parameters at the - # beginning of the method. It allows handlers to modify existing - # parameters or return a new set of parameters to use. - responses = self.meta.events.emit( - 'provide-client-params.{endpoint_prefix}.{operation_name}'.format( - endpoint_prefix=self._service_model.endpoint_prefix, - operation_name=operation_name), - params=api_params, model=operation_model, context=context) - api_params = first_non_none_response(responses, default=api_params) - - event_name = ( - 'before-parameter-build.{endpoint_prefix}.{operation_name}') - self.meta.events.emit( - event_name.format( - endpoint_prefix=self._service_model.endpoint_prefix, - operation_name=operation_name), - params=api_params, model=operation_model, context=context) - return api_params - - def get_paginator(self, operation_name): - """Create a paginator for an operation. - - :type operation_name: string - :param operation_name: The operation name. This is the same name - as the method name on the client. For example, if the - method name is ``create_foo``, and you'd normally invoke the - operation as ``client.create_foo(**kwargs)``, if the - ``create_foo`` operation can be paginated, you can use the - call ``client.get_paginator("create_foo")``. - - :raise OperationNotPageableError: Raised if the operation is not - pageable. You can use the ``client.can_paginate`` method to - check if an operation is pageable. - - :rtype: L{botocore.paginate.Paginator} - :return: A paginator object. - - """ - if not self.can_paginate(operation_name): - raise OperationNotPageableError(operation_name=operation_name) - else: - actual_operation_name = self._PY_TO_OP_NAME[operation_name] - - # Create a new paginate method that will serve as a proxy to - # the underlying Paginator.paginate method. This is needed to - # attach a docstring to the method. - def paginate(self, **kwargs): - return Paginator.paginate(self, **kwargs) - - paginator_config = self._cache['page_config'][ - actual_operation_name] - # Add the docstring for the paginate method. - paginate.__doc__ = PaginatorDocstring( - paginator_name=actual_operation_name, - event_emitter=self.meta.events, - service_model=self.meta.service_model, - paginator_config=paginator_config, - include_signature=False - ) - - # Rename the paginator class based on the type of paginator. - paginator_class_name = str('%s.Paginator.%s' % ( - get_service_module_name(self.meta.service_model), - actual_operation_name)) - - # Create the new paginator class - documented_paginator_cls = type( - paginator_class_name, (Paginator,), {'paginate': paginate}) - - operation_model = self._service_model.operation_model(actual_operation_name) - paginator = documented_paginator_cls( - getattr(self, operation_name), - paginator_config, - operation_model) - return paginator - - def can_paginate(self, operation_name): - """Check if an operation can be paginated. - - :type operation_name: string - :param operation_name: The operation name. This is the same name - as the method name on the client. For example, if the - method name is ``create_foo``, and you'd normally invoke the - operation as ``client.create_foo(**kwargs)``, if the - ``create_foo`` operation can be paginated, you can use the - call ``client.get_paginator("create_foo")``. - - :return: ``True`` if the operation can be paginated, - ``False`` otherwise. - - """ - if 'page_config' not in self._cache: - try: - page_config = self._loader.load_service_model( - self._service_model.service_name, - 'paginators-1', - self._service_model.api_version)['pagination'] - self._cache['page_config'] = page_config - except DataNotFoundError: - self._cache['page_config'] = {} - actual_operation_name = self._PY_TO_OP_NAME[operation_name] - return actual_operation_name in self._cache['page_config'] - - def _get_waiter_config(self): - if 'waiter_config' not in self._cache: - try: - waiter_config = self._loader.load_service_model( - self._service_model.service_name, - 'waiters-2', - self._service_model.api_version) - self._cache['waiter_config'] = waiter_config - except DataNotFoundError: - self._cache['waiter_config'] = {} - return self._cache['waiter_config'] - - def get_waiter(self, waiter_name): - """Returns an object that can wait for some condition. - - :type waiter_name: str - :param waiter_name: The name of the waiter to get. See the waiters - section of the service docs for a list of available waiters. - - :returns: The specified waiter object. - :rtype: botocore.waiter.Waiter - """ - config = self._get_waiter_config() - if not config: - raise ValueError("Waiter does not exist: %s" % waiter_name) - model = waiter.WaiterModel(config) - mapping = {} - for name in model.waiter_names: - mapping[xform_name(name)] = name - if waiter_name not in mapping: - raise ValueError("Waiter does not exist: %s" % waiter_name) - - return waiter.create_waiter_with_client( - mapping[waiter_name], model, self) - - @CachedProperty - def waiter_names(self): - """Returns a list of all available waiters.""" - config = self._get_waiter_config() - if not config: - return [] - model = waiter.WaiterModel(config) - # Waiter configs is a dict, we just want the waiter names - # which are the keys in the dict. - return [xform_name(name) for name in model.waiter_names] - - @property - def exceptions(self): - if self._exceptions is None: - self._exceptions = self._load_exceptions() - return self._exceptions - - def _load_exceptions(self): - return self._exceptions_factory.create_client_exceptions( - self._service_model) - - -class ClientMeta(object): - """Holds additional client methods. - - This class holds additional information for clients. It exists for - two reasons: - - * To give advanced functionality to clients - * To namespace additional client attributes from the operation - names which are mapped to methods at runtime. This avoids - ever running into collisions with operation names. - - """ - - def __init__(self, events, client_config, endpoint_url, service_model, - method_to_api_mapping, partition): - self.events = events - self._client_config = client_config - self._endpoint_url = endpoint_url - self._service_model = service_model - self._method_to_api_mapping = method_to_api_mapping - self._partition = partition - - @property - def service_model(self): - return self._service_model - - @property - def region_name(self): - return self._client_config.region_name - - @property - def endpoint_url(self): - return self._endpoint_url - - @property - def config(self): - return self._client_config - - @property - def method_to_api_mapping(self): - return self._method_to_api_mapping - - @property - def partition(self): - return self._partition - - -def _get_configured_signature_version(service_name, client_config, - scoped_config): - """ - Gets the manually configured signature version. - - :returns: the customer configured signature version, or None if no - signature version was configured. - """ - # Client config overrides everything. - if client_config and client_config.signature_version is not None: - return client_config.signature_version - - # Scoped config overrides picking from the endpoint metadata. - if scoped_config is not None: - # A given service may have service specific configuration in the - # config file, so we need to check there as well. - service_config = scoped_config.get(service_name) - if service_config is not None and isinstance(service_config, dict): - version = service_config.get('signature_version') - if version: - logger.debug( - "Switching signature version for service %s " - "to version %s based on config file override.", - service_name, version) - return version - return None diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/compat.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/compat.py deleted file mode 100644 index edf4df46..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/compat.py +++ /dev/null @@ -1,379 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import copy -import datetime -import sys -import inspect -import warnings -import hashlib -import logging -import shlex -from math import floor - -from botocore.vendored import six -from botocore.exceptions import MD5UnavailableError -from botocore.vendored.requests.packages.urllib3 import exceptions - -logger = logging.getLogger(__name__) - - -if six.PY3: - from botocore.vendored.six.moves import http_client - - class HTTPHeaders(http_client.HTTPMessage): - pass - - from urllib.parse import quote - from urllib.parse import urlencode - from urllib.parse import unquote - from urllib.parse import unquote_plus - from urllib.parse import urlparse - from urllib.parse import urlsplit - from urllib.parse import urlunsplit - from urllib.parse import urljoin - from urllib.parse import parse_qsl - from urllib.parse import parse_qs - from http.client import HTTPResponse - from io import IOBase as _IOBase - from base64 import encodebytes - from email.utils import formatdate - from itertools import zip_longest - file_type = _IOBase - zip = zip - - # In python3, unquote takes a str() object, url decodes it, - # then takes the bytestring and decodes it to utf-8. - # Python2 we'll have to do this ourself (see below). - unquote_str = unquote_plus - - def set_socket_timeout(http_response, timeout): - """Set the timeout of the socket from an HTTPResponse. - - :param http_response: An instance of ``httplib.HTTPResponse`` - - """ - http_response._fp.fp.raw._sock.settimeout(timeout) - - def accepts_kwargs(func): - # In python3.4.1, there's backwards incompatible - # changes when using getargspec with functools.partials. - return inspect.getfullargspec(func)[2] - - def ensure_unicode(s, encoding=None, errors=None): - # NOOP in Python 3, because every string is already unicode - return s - - def ensure_bytes(s, encoding='utf-8', errors='strict'): - if isinstance(s, str): - return s.encode(encoding, errors) - if isinstance(s, bytes): - return s - raise ValueError("Expected str or bytes, received %s." % type(s)) - -else: - from urllib import quote - from urllib import urlencode - from urllib import unquote - from urllib import unquote_plus - from urlparse import urlparse - from urlparse import urlsplit - from urlparse import urlunsplit - from urlparse import urljoin - from urlparse import parse_qsl - from urlparse import parse_qs - from email.message import Message - from email.Utils import formatdate - file_type = file - from itertools import izip as zip - from itertools import izip_longest as zip_longest - from httplib import HTTPResponse - from base64 import encodestring as encodebytes - - class HTTPHeaders(Message): - - # The __iter__ method is not available in python2.x, so we have - # to port the py3 version. - def __iter__(self): - for field, value in self._headers: - yield field - - def unquote_str(value, encoding='utf-8'): - # In python2, unquote() gives us a string back that has the urldecoded - # bits, but not the unicode parts. We need to decode this manually. - # unquote has special logic in which if it receives a unicode object it - # will decode it to latin1. This is hard coded. To avoid this, we'll - # encode the string with the passed in encoding before trying to - # unquote it. - byte_string = value.encode(encoding) - return unquote_plus(byte_string).decode(encoding) - - def set_socket_timeout(http_response, timeout): - """Set the timeout of the socket from an HTTPResponse. - - :param http_response: An instance of ``httplib.HTTPResponse`` - - """ - http_response._fp.fp._sock.settimeout(timeout) - - def accepts_kwargs(func): - return inspect.getargspec(func)[2] - - def ensure_unicode(s, encoding='utf-8', errors='strict'): - if isinstance(s, six.text_type): - return s - return unicode(s, encoding, errors) - - def ensure_bytes(s, encoding='utf-8', errors='strict'): - if isinstance(s, unicode): - return s.encode(encoding, errors) - if isinstance(s, str): - return s - raise ValueError("Expected str or unicode, received %s." % type(s)) - -try: - from collections import OrderedDict -except ImportError: - # Python2.6 we use the 3rd party back port. - from ordereddict import OrderedDict - - -if sys.version_info[:2] == (2, 6): - import simplejson as json - # In py26, invalid xml parsed by element tree - # will raise a plain old SyntaxError instead of - # a real exception, so we need to abstract this change. - XMLParseError = SyntaxError - - # Handle https://github.com/shazow/urllib3/issues/497 for py2.6. In - # python2.6, there is a known issue where sometimes we cannot read the SAN - # from an SSL cert (http://bugs.python.org/issue13034). However, newer - # versions of urllib3 will warn you when there is no SAN. While we could - # just turn off this warning in urllib3 altogether, we _do_ want warnings - # when they're legitimate warnings. This method tries to scope the warning - # filter to be as specific as possible. - def filter_ssl_san_warnings(): - warnings.filterwarnings( - 'ignore', - message="Certificate has no.*subjectAltName.*", - category=exceptions.SecurityWarning, - module=r".*urllib3\.connection") -else: - import xml.etree.cElementTree - XMLParseError = xml.etree.cElementTree.ParseError - import json - - def filter_ssl_san_warnings(): - # Noop for non-py26 versions. We will parse the SAN - # appropriately. - pass - - -def filter_ssl_warnings(): - # Ignore warnings related to SNI as it is not being used in validations. - warnings.filterwarnings( - 'ignore', - message="A true SSLContext object is not available.*", - category=exceptions.InsecurePlatformWarning, - module=r".*urllib3\.util\.ssl_") - filter_ssl_san_warnings() - - -@classmethod -def from_dict(cls, d): - new_instance = cls() - for key, value in d.items(): - new_instance[key] = value - return new_instance - - -@classmethod -def from_pairs(cls, pairs): - new_instance = cls() - for key, value in pairs: - new_instance[key] = value - return new_instance - -HTTPHeaders.from_dict = from_dict -HTTPHeaders.from_pairs = from_pairs - - -def copy_kwargs(kwargs): - """ - There is a bug in Python versions < 2.6.5 that prevents you - from passing unicode keyword args (#4978). This function - takes a dictionary of kwargs and returns a copy. If you are - using Python < 2.6.5, it also encodes the keys to avoid this bug. - Oh, and version_info wasn't a namedtuple back then, either! - """ - vi = sys.version_info - if vi[0] == 2 and vi[1] <= 6 and vi[3] < 5: - copy_kwargs = {} - for key in kwargs: - copy_kwargs[key.encode('utf-8')] = kwargs[key] - else: - copy_kwargs = copy.copy(kwargs) - return copy_kwargs - - -def total_seconds(delta): - """ - Returns the total seconds in a ``datetime.timedelta``. - - Python 2.6 does not have ``timedelta.total_seconds()``, so we have - to calculate this ourselves. On 2.7 or better, we'll take advantage of the - built-in method. - - The math was pulled from the ``datetime`` docs - (http://docs.python.org/2.7/library/datetime.html#datetime.timedelta.total_seconds). - - :param delta: The timedelta object - :type delta: ``datetime.timedelta`` - """ - if sys.version_info[:2] != (2, 6): - return delta.total_seconds() - - day_in_seconds = delta.days * 24 * 3600.0 - micro_in_seconds = delta.microseconds / 10.0**6 - return day_in_seconds + delta.seconds + micro_in_seconds - - -# Checks to see if md5 is available on this system. A given system might not -# have access to it for various reasons, such as FIPS mode being enabled. -try: - hashlib.md5() - MD5_AVAILABLE = True -except ValueError: - MD5_AVAILABLE = False - - -def get_md5(*args, **kwargs): - """ - Attempts to get an md5 hashing object. - - :param raise_error_if_unavailable: raise an error if md5 is unavailable on - this system. If False, None will be returned if it is unavailable. - :type raise_error_if_unavailable: bool - :param args: Args to pass to the MD5 constructor - :param kwargs: Key word arguments to pass to the MD5 constructor - :return: An MD5 hashing object if available. If it is unavailable, None - is returned if raise_error_if_unavailable is set to False. - """ - if MD5_AVAILABLE: - return hashlib.md5(*args, **kwargs) - else: - raise MD5UnavailableError() - - -def compat_shell_split(s, platform=None): - if platform is None: - platform = sys.platform - - if platform == "win32": - return _windows_shell_split(s) - else: - return shlex.split(s) - - -def _windows_shell_split(s): - """Splits up a windows command as the built-in command parser would. - - Windows has potentially bizarre rules depending on where you look. When - spawning a process via the Windows C runtime (which is what python does - when you call popen) the rules are as follows: - - https://docs.microsoft.com/en-us/cpp/cpp/parsing-cpp-command-line-arguments - - To summarize: - - * Only space and tab are valid delimiters - * Double quotes are the only valid quotes - * Backslash is interpreted literally unless it is part of a chain that - leads up to a double quote. Then the backslashes escape the backslashes, - and if there is an odd number the final backslash escapes the quote. - - :param s: The command string to split up into parts. - :return: A list of command components. - """ - if not s: - return [] - - components = [] - buff = [] - is_quoted = False - num_backslashes = 0 - for character in s: - if character == '\\': - # We can't simply append backslashes because we don't know if - # they are being used as escape characters or not. Instead we - # keep track of how many we've encountered and handle them when - # we encounter a different character. - num_backslashes += 1 - elif character == '"': - if num_backslashes > 0: - # The backslashes are in a chain leading up to a double - # quote, so they are escaping each other. - buff.append('\\' * int(floor(num_backslashes / 2))) - remainder = num_backslashes % 2 - num_backslashes = 0 - if remainder == 1: - # The number of backslashes is uneven, so they are also - # escaping the double quote, so it needs to be added to - # the current component buffer. - buff.append('"') - continue - - # We've encountered a double quote that is not escaped, - # so we toggle is_quoted. - is_quoted = not is_quoted - - # If there are quotes, then we may want an empty string. To be - # safe, we add an empty string to the buffer so that we make - # sure it sticks around if there's nothing else between quotes. - # If there is other stuff between quotes, the empty string will - # disappear during the joining process. - buff.append('') - elif character in [' ', '\t'] and not is_quoted: - # Since the backslashes aren't leading up to a quote, we put in - # the exact number of backslashes. - if num_backslashes > 0: - buff.append('\\' * num_backslashes) - num_backslashes = 0 - - # Excess whitespace is ignored, so only add the components list - # if there is anything in the buffer. - if buff: - components.append(''.join(buff)) - buff = [] - else: - # Since the backslashes aren't leading up to a quote, we put in - # the exact number of backslashes. - if num_backslashes > 0: - buff.append('\\' * num_backslashes) - num_backslashes = 0 - buff.append(character) - - # Quotes must be terminated. - if is_quoted: - raise ValueError('No closing quotation in string: %s' % s) - - # There may be some leftover backslashes, so we need to add them in. - # There's no quote so we add the exact number. - if num_backslashes > 0: - buff.append('\\' * num_backslashes) - - # Add the final component in if there is anything in the buffer. - if buff: - components.append(''.join(buff)) - - return components diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/config.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/config.py deleted file mode 100644 index 4b2e4c50..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/config.py +++ /dev/null @@ -1,208 +0,0 @@ -# Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import copy -from botocore.compat import OrderedDict - -from botocore.endpoint import DEFAULT_TIMEOUT, MAX_POOL_CONNECTIONS -from botocore.exceptions import InvalidS3AddressingStyleError -from botocore.exceptions import InvalidRetryConfigurationError -from botocore.exceptions import InvalidMaxRetryAttemptsError - - -class Config(object): - """Advanced configuration for Botocore clients. - - :type region_name: str - :param region_name: The region to use in instantiating the client - - :type signature_version: str - :param signature_version: The signature version when signing requests. - - :type user_agent: str - :param user_agent: The value to use in the User-Agent header. - - :type user_agent_extra: str - :param user_agent_extra: The value to append to the current User-Agent - header value. - - :type connect_timeout: int - :param connect_timeout: The time in seconds till a timeout exception is - thrown when attempting to make a connection. The default is 60 - seconds. - - :type read_timeout: int - :param read_timeout: The time in seconds till a timeout exception is - thrown when attempting to read from a connection. The default is - 60 seconds. - - :type parameter_validation: bool - :param parameter_validation: Whether parameter validation should occur - when serializing requests. The default is True. You can disable - parameter validation for performance reasons. Otherwise, it's - recommended to leave parameter validation enabled. - - :type max_pool_connections: int - :param max_pool_connections: The maximum number of connections to - keep in a connection pool. If this value is not set, the default - value of 10 is used. - - :type proxies: dict - :param proxies: A dictionary of proxy servers to use by protocol or - endpoint, e.g.: - {'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}. - The proxies are used on each request. - - :type s3: dict - :param s3: A dictionary of s3 specific configurations. - Valid keys are: - - * 'use_accelerate_endpoint' -- Refers to whether to use the S3 - Accelerate endpoint. The value must be a boolean. If True, the - client will use the S3 Accelerate endpoint. If the S3 Accelerate - endpoint is being used then the addressing style will always - be virtual. - - * 'payload_signing_enabled' -- Refers to whether or not to SHA256 - sign sigv4 payloads. By default, this is disabled for streaming - uploads (UploadPart and PutObject). - - * 'addressing_style' -- Refers to the style in which to address - s3 endpoints. Values must be a string that equals: - - * auto -- Addressing style is chosen for user. Depending - on the configuration of client, the endpoint may be addressed in - the virtual or the path style. Note that this is the default - behavior if no style is specified. - - * virtual -- Addressing style is always virtual. The name of the - bucket must be DNS compatible or an exception will be thrown. - Endpoints will be addressed as such: mybucket.s3.amazonaws.com - - * path -- Addressing style is always by path. Endpoints will be - addressed as such: s3.amazonaws.com/mybucket - - :type retries: dict - :param retries: A dictionary for retry specific configurations. - Valid keys are: - - * 'max_attempts' -- An integer representing the maximum number of - retry attempts that will be made on a single request. For - example, setting this value to 2 will result in the request - being retried at most two times after the initial request. Setting - this value to 0 will result in no retries ever being attempted on - the initial request. If not provided, the number of retries will - default to whatever is modeled, which is typically four retries. - """ - OPTION_DEFAULTS = OrderedDict([ - ('region_name', None), - ('signature_version', None), - ('user_agent', None), - ('user_agent_extra', None), - ('connect_timeout', DEFAULT_TIMEOUT), - ('read_timeout', DEFAULT_TIMEOUT), - ('parameter_validation', True), - ('max_pool_connections', MAX_POOL_CONNECTIONS), - ('proxies', None), - ('s3', None), - ('retries', None) - ]) - - def __init__(self, *args, **kwargs): - self._user_provided_options = self._record_user_provided_options( - args, kwargs) - - # Merge the user_provided options onto the default options - config_vars = copy.copy(self.OPTION_DEFAULTS) - config_vars.update(self._user_provided_options) - - # Set the attributes based on the config_vars - for key, value in config_vars.items(): - setattr(self, key, value) - - # Validate the s3 options - self._validate_s3_configuration(self.s3) - - self._validate_retry_configuration(self.retries) - - def _record_user_provided_options(self, args, kwargs): - option_order = list(self.OPTION_DEFAULTS) - user_provided_options = {} - - # Iterate through the kwargs passed through to the constructor and - # map valid keys to the dictionary - for key, value in kwargs.items(): - if key in self.OPTION_DEFAULTS: - user_provided_options[key] = value - # The key must exist in the available options - else: - raise TypeError( - 'Got unexpected keyword argument \'%s\'' % key) - - # The number of args should not be longer than the allowed - # options - if len(args) > len(option_order): - raise TypeError( - 'Takes at most %s arguments (%s given)' % ( - len(option_order), len(args))) - - # Iterate through the args passed through to the constructor and map - # them to appropriate keys. - for i, arg in enumerate(args): - # If it a kwarg was specified for the arg, then error out - if option_order[i] in user_provided_options: - raise TypeError( - 'Got multiple values for keyword argument \'%s\'' % ( - option_order[i])) - user_provided_options[option_order[i]] = arg - - return user_provided_options - - def _validate_s3_configuration(self, s3): - if s3 is not None: - addressing_style = s3.get('addressing_style') - if addressing_style not in ['virtual', 'auto', 'path', None]: - raise InvalidS3AddressingStyleError( - s3_addressing_style=addressing_style) - - def _validate_retry_configuration(self, retries): - if retries is not None: - for key in retries: - if key not in ['max_attempts']: - raise InvalidRetryConfigurationError( - retry_config_option=key) - if key == 'max_attempts' and retries[key] < 0: - raise InvalidMaxRetryAttemptsError( - provided_max_attempts=retries[key] - ) - - def merge(self, other_config): - """Merges the config object with another config object - - This will merge in all non-default values from the provided config - and return a new config object - - :type other_config: botocore.config.Config - :param other config: Another config object to merge with. The values - in the provided config object will take precedence in the merging - - :returns: A config object built from the merged values of both - config objects. - """ - # Make a copy of the current attributes in the config object. - config_options = copy.copy(self._user_provided_options) - - # Merge in the user provided options from the other config - config_options.update(other_config._user_provided_options) - - # Return a new config object with the merged properties. - return Config(**config_options) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/configloader.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/configloader.py deleted file mode 100644 index 385f05f7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/configloader.py +++ /dev/null @@ -1,272 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import os -import shlex -import copy -import sys - -from botocore.compat import six - -import botocore.exceptions - - -def multi_file_load_config(*filenames): - """Load and combine multiple INI configs with profiles. - - This function will take a list of filesnames and return - a single dictionary that represents the merging of the loaded - config files. - - If any of the provided filenames does not exist, then that file - is ignored. It is therefore ok to provide a list of filenames, - some of which may not exist. - - Configuration files are **not** deep merged, only the top level - keys are merged. The filenames should be passed in order of - precedence. The first config file has precedence over the - second config file, which has precedence over the third config file, - etc. The only exception to this is that the "profiles" key is - merged to combine profiles from multiple config files into a - single profiles mapping. However, if a profile is defined in - multiple config files, then the config file with the highest - precedence is used. Profile values themselves are not merged. - For example:: - - FileA FileB FileC - [foo] [foo] [bar] - a=1 a=2 a=3 - b=2 - - [bar] [baz] [profile a] - a=2 a=3 region=e - - [profile a] [profile b] [profile c] - region=c region=d region=f - - The final result of ``multi_file_load_config(FileA, FileB, FileC)`` - would be:: - - {"foo": {"a": 1}, "bar": {"a": 2}, "baz": {"a": 3}, - "profiles": {"a": {"region": "c"}}, {"b": {"region": d"}}, - {"c": {"region": "f"}}} - - Note that the "foo" key comes from A, even though it's defined in both - FileA and FileB. Because "foo" was defined in FileA first, then the values - for "foo" from FileA are used and the values for "foo" from FileB are - ignored. Also note where the profiles originate from. Profile "a" - comes FileA, profile "b" comes from FileB, and profile "c" comes - from FileC. - - """ - configs = [] - profiles = [] - for filename in filenames: - try: - loaded = load_config(filename) - except botocore.exceptions.ConfigNotFound: - continue - profiles.append(loaded.pop('profiles')) - configs.append(loaded) - merged_config = _merge_list_of_dicts(configs) - merged_profiles = _merge_list_of_dicts(profiles) - merged_config['profiles'] = merged_profiles - return merged_config - - -def _merge_list_of_dicts(list_of_dicts): - merged_dicts = {} - for single_dict in list_of_dicts: - for key, value in single_dict.items(): - if key not in merged_dicts: - merged_dicts[key] = value - return merged_dicts - - -def load_config(config_filename): - """Parse a INI config with profiles. - - This will parse an INI config file and map top level profiles - into a top level "profile" key. - - If you want to parse an INI file and map all section names to - top level keys, use ``raw_config_parse`` instead. - - """ - parsed = raw_config_parse(config_filename) - return build_profile_map(parsed) - - -def raw_config_parse(config_filename, parse_subsections=True): - """Returns the parsed INI config contents. - - Each section name is a top level key. - - :param config_filename: The name of the INI file to parse - - :param parse_subsections: If True, parse indented blocks as - subsections that represent their own configuration dictionary. - For example, if the config file had the contents:: - - s3 = - signature_version = s3v4 - addressing_style = path - - The resulting ``raw_config_parse`` would be:: - - {'s3': {'signature_version': 's3v4', 'addressing_style': 'path'}} - - If False, do not try to parse subsections and return the indented - block as its literal value:: - - {'s3': '\nsignature_version = s3v4\naddressing_style = path'} - - :returns: A dict with keys for each profile found in the config - file and the value of each key being a dict containing name - value pairs found in that profile. - - :raises: ConfigNotFound, ConfigParseError - """ - config = {} - path = config_filename - if path is not None: - path = os.path.expandvars(path) - path = os.path.expanduser(path) - if not os.path.isfile(path): - raise botocore.exceptions.ConfigNotFound(path=_unicode_path(path)) - cp = six.moves.configparser.RawConfigParser() - try: - cp.read([path]) - except six.moves.configparser.Error: - raise botocore.exceptions.ConfigParseError( - path=_unicode_path(path)) - else: - for section in cp.sections(): - config[section] = {} - for option in cp.options(section): - config_value = cp.get(section, option) - if parse_subsections and config_value.startswith('\n'): - # Then we need to parse the inner contents as - # hierarchical. We support a single level - # of nesting for now. - try: - config_value = _parse_nested(config_value) - except ValueError: - raise botocore.exceptions.ConfigParseError( - path=_unicode_path(path)) - config[section][option] = config_value - return config - - -def _unicode_path(path): - if isinstance(path, six.text_type): - return path - # According to the documentation getfilesystemencoding can return None - # on unix in which case the default encoding is used instead. - filesystem_encoding = sys.getfilesystemencoding() - if filesystem_encoding is None: - filesystem_encoding = sys.getdefaultencoding() - return path.decode(filesystem_encoding, 'replace') - - -def _parse_nested(config_value): - # Given a value like this: - # \n - # foo = bar - # bar = baz - # We need to parse this into - # {'foo': 'bar', 'bar': 'baz} - parsed = {} - for line in config_value.splitlines(): - line = line.strip() - if not line: - continue - # The caller will catch ValueError - # and raise an appropriate error - # if this fails. - key, value = line.split('=', 1) - parsed[key.strip()] = value.strip() - return parsed - - -def build_profile_map(parsed_ini_config): - """Convert the parsed INI config into a profile map. - - The config file format requires that every profile except the - default to be prepended with "profile", e.g.:: - - [profile test] - aws_... = foo - aws_... = bar - - [profile bar] - aws_... = foo - aws_... = bar - - # This is *not* a profile - [preview] - otherstuff = 1 - - # Neither is this - [foobar] - morestuff = 2 - - The build_profile_map will take a parsed INI config file where each top - level key represents a section name, and convert into a format where all - the profiles are under a single top level "profiles" key, and each key in - the sub dictionary is a profile name. For example, the above config file - would be converted from:: - - {"profile test": {"aws_...": "foo", "aws...": "bar"}, - "profile bar": {"aws...": "foo", "aws...": "bar"}, - "preview": {"otherstuff": ...}, - "foobar": {"morestuff": ...}, - } - - into:: - - {"profiles": {"test": {"aws_...": "foo", "aws...": "bar"}, - "bar": {"aws...": "foo", "aws...": "bar"}, - "preview": {"otherstuff": ...}, - "foobar": {"morestuff": ...}, - } - - If there are no profiles in the provided parsed INI contents, then - an empty dict will be the value associated with the ``profiles`` key. - - .. note:: - - This will not mutate the passed in parsed_ini_config. Instead it will - make a deepcopy and return that value. - - """ - parsed_config = copy.deepcopy(parsed_ini_config) - profiles = {} - final_config = {} - for key, values in parsed_config.items(): - if key.startswith("profile"): - try: - parts = shlex.split(key) - except ValueError: - continue - if len(parts) == 2: - profiles[parts[1]] = values - elif key == 'default': - # default section is special and is considered a profile - # name but we don't require you use 'profile "default"' - # as a section. - profiles[key] = values - else: - final_config[key] = values - final_config['profiles'] = profiles - return final_config diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/credentials.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/credentials.py deleted file mode 100644 index d82c04d2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/credentials.py +++ /dev/null @@ -1,1673 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import time -import datetime -import logging -import os -import getpass -import threading -import json -import subprocess -from collections import namedtuple -from copy import deepcopy -from hashlib import sha1 -import json - -from dateutil.parser import parse -from dateutil.tz import tzlocal - -import botocore.configloader -import botocore.compat -from botocore.compat import total_seconds -from botocore.compat import compat_shell_split -from botocore.exceptions import UnknownCredentialError -from botocore.exceptions import PartialCredentialsError -from botocore.exceptions import ConfigNotFound -from botocore.exceptions import InvalidConfigError -from botocore.exceptions import InfiniteLoopConfigError -from botocore.exceptions import RefreshWithMFAUnsupportedError -from botocore.exceptions import MetadataRetrievalError -from botocore.exceptions import CredentialRetrievalError -from botocore.utils import InstanceMetadataFetcher, parse_key_val_file -from botocore.utils import ContainerMetadataFetcher - - -logger = logging.getLogger(__name__) -ReadOnlyCredentials = namedtuple('ReadOnlyCredentials', - ['access_key', 'secret_key', 'token']) - - -def create_credential_resolver(session, cache=None): - """Create a default credential resolver. - - This creates a pre-configured credential resolver - that includes the default lookup chain for - credentials. - - """ - profile_name = session.get_config_variable('profile') or 'default' - credential_file = session.get_config_variable('credentials_file') - config_file = session.get_config_variable('config_file') - metadata_timeout = session.get_config_variable('metadata_service_timeout') - num_attempts = session.get_config_variable('metadata_service_num_attempts') - if cache is None: - cache = {} - - env_provider = EnvProvider() - container_provider = ContainerProvider() - instance_metadata_provider = InstanceMetadataProvider( - iam_role_fetcher=InstanceMetadataFetcher( - timeout=metadata_timeout, - num_attempts=num_attempts, - user_agent=session.user_agent()) - ) - assume_role_provider = AssumeRoleProvider( - load_config=lambda: session.full_config, - client_creator=session.create_client, - cache=cache, - profile_name=profile_name, - credential_sourcer=CanonicalNameCredentialSourcer([ - env_provider, container_provider, instance_metadata_provider - ]) - ) - providers = [ - env_provider, - assume_role_provider, - SharedCredentialProvider( - creds_filename=credential_file, - profile_name=profile_name - ), - ProcessProvider(profile_name=profile_name, - load_config=lambda: session.full_config), - # The new config file has precedence over the legacy - # config file. - ConfigProvider(config_filename=config_file, profile_name=profile_name), - OriginalEC2Provider(), - BotoProvider(), - container_provider, - instance_metadata_provider - ] - - explicit_profile = session.get_config_variable('profile', - methods=('instance',)) - if explicit_profile is not None: - # An explicitly provided profile will negate an EnvProvider. - # We will defer to providers that understand the "profile" - # concept to retrieve credentials. - # The one edge case if is all three values are provided via - # env vars: - # export AWS_ACCESS_KEY_ID=foo - # export AWS_SECRET_ACCESS_KEY=bar - # export AWS_PROFILE=baz - # Then, just like our client() calls, the explicit credentials - # will take precedence. - # - # This precedence is enforced by leaving the EnvProvider in the chain. - # This means that the only way a "profile" would win is if the - # EnvProvider does not return credentials, which is what we want - # in this scenario. - providers.remove(env_provider) - logger.debug('Skipping environment variable credential check' - ' because profile name was explicitly set.') - - resolver = CredentialResolver(providers=providers) - return resolver - - -def get_credentials(session): - resolver = create_credential_resolver(session) - return resolver.load_credentials() - - -def _local_now(): - return datetime.datetime.now(tzlocal()) - - -def _parse_if_needed(value): - if isinstance(value, datetime.datetime): - return value - return parse(value) - - -def _serialize_if_needed(value, iso=False): - if isinstance(value, datetime.datetime): - if iso: - return value.isoformat() - return value.strftime('%Y-%m-%dT%H:%M:%S%Z') - return value - - -def create_assume_role_refresher(client, params): - def refresh(): - response = client.assume_role(**params) - credentials = response['Credentials'] - # We need to normalize the credential names to - # the values expected by the refresh creds. - return { - 'access_key': credentials['AccessKeyId'], - 'secret_key': credentials['SecretAccessKey'], - 'token': credentials['SessionToken'], - 'expiry_time': _serialize_if_needed(credentials['Expiration']), - } - return refresh - - -def create_mfa_serial_refresher(actual_refresh): - - class _Refresher(object): - def __init__(self, refresh): - self._refresh = refresh - self._has_been_called = False - - def __call__(self): - if self._has_been_called: - # We can explore an option in the future to support - # reprompting for MFA, but for now we just error out - # when the temp creds expire. - raise RefreshWithMFAUnsupportedError() - self._has_been_called = True - return self._refresh() - - return _Refresher(actual_refresh) - - -class JSONFileCache(object): - """JSON file cache. - This provides a dict like interface that stores JSON serializable - objects. - The objects are serialized to JSON and stored in a file. These - values can be retrieved at a later time. - """ - - CACHE_DIR = os.path.expanduser(os.path.join('~', '.aws', 'boto', 'cache')) - - def __init__(self, working_dir=CACHE_DIR): - self._working_dir = working_dir - - def __contains__(self, cache_key): - actual_key = self._convert_cache_key(cache_key) - return os.path.isfile(actual_key) - - def __getitem__(self, cache_key): - """Retrieve value from a cache key.""" - actual_key = self._convert_cache_key(cache_key) - try: - with open(actual_key) as f: - return json.load(f) - except (OSError, ValueError, IOError): - raise KeyError(cache_key) - - def __setitem__(self, cache_key, value): - full_key = self._convert_cache_key(cache_key) - try: - file_content = json.dumps(value, default=_serialize_if_needed) - except (TypeError, ValueError): - raise ValueError("Value cannot be cached, must be " - "JSON serializable: %s" % value) - if not os.path.isdir(self._working_dir): - os.makedirs(self._working_dir) - with os.fdopen(os.open(full_key, - os.O_WRONLY | os.O_CREAT, 0o600), 'w') as f: - f.truncate() - f.write(file_content) - - def _convert_cache_key(self, cache_key): - full_path = os.path.join(self._working_dir, cache_key + '.json') - return full_path - - -class Credentials(object): - """ - Holds the credentials needed to authenticate requests. - - :ivar access_key: The access key part of the credentials. - :ivar secret_key: The secret key part of the credentials. - :ivar token: The security token, valid only for session credentials. - :ivar method: A string which identifies where the credentials - were found. - """ - - def __init__(self, access_key, secret_key, token=None, - method=None): - self.access_key = access_key - self.secret_key = secret_key - self.token = token - - if method is None: - method = 'explicit' - self.method = method - - self._normalize() - - def _normalize(self): - # Keys would sometimes (accidentally) contain non-ascii characters. - # It would cause a confusing UnicodeDecodeError in Python 2. - # We explicitly convert them into unicode to avoid such error. - # - # Eventually the service will decide whether to accept the credential. - # This also complies with the behavior in Python 3. - self.access_key = botocore.compat.ensure_unicode(self.access_key) - self.secret_key = botocore.compat.ensure_unicode(self.secret_key) - - def get_frozen_credentials(self): - return ReadOnlyCredentials(self.access_key, - self.secret_key, - self.token) - - -class RefreshableCredentials(Credentials): - """ - Holds the credentials needed to authenticate requests. In addition, it - knows how to refresh itself. - - :ivar access_key: The access key part of the credentials. - :ivar secret_key: The secret key part of the credentials. - :ivar token: The security token, valid only for session credentials. - :ivar method: A string which identifies where the credentials - were found. - """ - # The time at which we'll attempt to refresh, but not - # block if someone else is refreshing. - _advisory_refresh_timeout = 15 * 60 - # The time at which all threads will block waiting for - # refreshed credentials. - _mandatory_refresh_timeout = 10 * 60 - - def __init__(self, access_key, secret_key, token, - expiry_time, refresh_using, method, - time_fetcher=_local_now): - self._refresh_using = refresh_using - self._access_key = access_key - self._secret_key = secret_key - self._token = token - self._expiry_time = expiry_time - self._time_fetcher = time_fetcher - self._refresh_lock = threading.Lock() - self.method = method - self._frozen_credentials = ReadOnlyCredentials( - access_key, secret_key, token) - self._normalize() - - def _normalize(self): - self._access_key = botocore.compat.ensure_unicode(self._access_key) - self._secret_key = botocore.compat.ensure_unicode(self._secret_key) - - @classmethod - def create_from_metadata(cls, metadata, refresh_using, method): - instance = cls( - access_key=metadata['access_key'], - secret_key=metadata['secret_key'], - token=metadata['token'], - expiry_time=cls._expiry_datetime(metadata['expiry_time']), - method=method, - refresh_using=refresh_using - ) - return instance - - @property - def access_key(self): - """Warning: Using this property can lead to race conditions if you - access another property subsequently along the refresh boundary. - Please use get_frozen_credentials instead. - """ - self._refresh() - return self._access_key - - @access_key.setter - def access_key(self, value): - self._access_key = value - - @property - def secret_key(self): - """Warning: Using this property can lead to race conditions if you - access another property subsequently along the refresh boundary. - Please use get_frozen_credentials instead. - """ - self._refresh() - return self._secret_key - - @secret_key.setter - def secret_key(self, value): - self._secret_key = value - - @property - def token(self): - """Warning: Using this property can lead to race conditions if you - access another property subsequently along the refresh boundary. - Please use get_frozen_credentials instead. - """ - self._refresh() - return self._token - - @token.setter - def token(self, value): - self._token = value - - def _seconds_remaining(self): - delta = self._expiry_time - self._time_fetcher() - return total_seconds(delta) - - def refresh_needed(self, refresh_in=None): - """Check if a refresh is needed. - - A refresh is needed if the expiry time associated - with the temporary credentials is less than the - provided ``refresh_in``. If ``time_delta`` is not - provided, ``self.advisory_refresh_needed`` will be used. - - For example, if your temporary credentials expire - in 10 minutes and the provided ``refresh_in`` is - ``15 * 60``, then this function will return ``True``. - - :type refresh_in: int - :param refresh_in: The number of seconds before the - credentials expire in which refresh attempts should - be made. - - :return: True if refresh neeeded, False otherwise. - - """ - if self._expiry_time is None: - # No expiration, so assume we don't need to refresh. - return False - - if refresh_in is None: - refresh_in = self._advisory_refresh_timeout - # The credentials should be refreshed if they're going to expire - # in less than 5 minutes. - if self._seconds_remaining() >= refresh_in: - # There's enough time left. Don't refresh. - return False - logger.debug("Credentials need to be refreshed.") - return True - - def _is_expired(self): - # Checks if the current credentials are expired. - return self.refresh_needed(refresh_in=0) - - def _refresh(self): - # In the common case where we don't need a refresh, we - # can immediately exit and not require acquiring the - # refresh lock. - if not self.refresh_needed(self._advisory_refresh_timeout): - return - - # acquire() doesn't accept kwargs, but False is indicating - # that we should not block if we can't acquire the lock. - # If we aren't able to acquire the lock, we'll trigger - # the else clause. - if self._refresh_lock.acquire(False): - try: - if not self.refresh_needed(self._advisory_refresh_timeout): - return - is_mandatory_refresh = self.refresh_needed( - self._mandatory_refresh_timeout) - self._protected_refresh(is_mandatory=is_mandatory_refresh) - return - finally: - self._refresh_lock.release() - elif self.refresh_needed(self._mandatory_refresh_timeout): - # If we're within the mandatory refresh window, - # we must block until we get refreshed credentials. - with self._refresh_lock: - if not self.refresh_needed(self._mandatory_refresh_timeout): - return - self._protected_refresh(is_mandatory=True) - - def _protected_refresh(self, is_mandatory): - # precondition: this method should only be called if you've acquired - # the self._refresh_lock. - try: - metadata = self._refresh_using() - except Exception as e: - period_name = 'mandatory' if is_mandatory else 'advisory' - logger.warning("Refreshing temporary credentials failed " - "during %s refresh period.", - period_name, exc_info=True) - if is_mandatory: - # If this is a mandatory refresh, then - # all errors that occur when we attempt to refresh - # credentials are propagated back to the user. - raise - # Otherwise we'll just return. - # The end result will be that we'll use the current - # set of temporary credentials we have. - return - self._set_from_data(metadata) - self._frozen_credentials = ReadOnlyCredentials( - self._access_key, self._secret_key, self._token) - if self._is_expired(): - # We successfully refreshed credentials but for whatever - # reason, our refreshing function returned credentials - # that are still expired. In this scenario, the only - # thing we can do is let the user know and raise - # an exception. - msg = ("Credentials were refreshed, but the " - "refreshed credentials are still expired.") - logger.warning(msg) - raise RuntimeError(msg) - - @staticmethod - def _expiry_datetime(time_str): - return parse(time_str) - - def _set_from_data(self, data): - self.access_key = data['access_key'] - self.secret_key = data['secret_key'] - self.token = data['token'] - self._expiry_time = parse(data['expiry_time']) - logger.debug("Retrieved credentials will expire at: %s", - self._expiry_time) - self._normalize() - - def get_frozen_credentials(self): - """Return immutable credentials. - - The ``access_key``, ``secret_key``, and ``token`` properties - on this class will always check and refresh credentials if - needed before returning the particular credentials. - - This has an edge case where you can get inconsistent - credentials. Imagine this: - - # Current creds are "t1" - tmp.access_key ---> expired? no, so return t1.access_key - # ---- time is now expired, creds need refreshing to "t2" ---- - tmp.secret_key ---> expired? yes, refresh and return t2.secret_key - - This means we're using the access key from t1 with the secret key - from t2. To fix this issue, you can request a frozen credential object - which is guaranteed not to change. - - The frozen credentials returned from this method should be used - immediately and then discarded. The typical usage pattern would - be:: - - creds = RefreshableCredentials(...) - some_code = SomeSignerObject() - # I'm about to sign the request. - # The frozen credentials are only used for the - # duration of generate_presigned_url and will be - # immediately thrown away. - request = some_code.sign_some_request( - with_credentials=creds.get_frozen_credentials()) - print("Signed request:", request) - - """ - self._refresh() - return self._frozen_credentials - - -class DeferredRefreshableCredentials(RefreshableCredentials): - """Refreshable credentials that don't require initial credentials. - - refresh_using will be called upon first access. - """ - def __init__(self, refresh_using, method, time_fetcher=_local_now): - self._refresh_using = refresh_using - self._access_key = None - self._secret_key = None - self._token = None - self._expiry_time = None - self._time_fetcher = time_fetcher - self._refresh_lock = threading.Lock() - self.method = method - self._frozen_credentials = None - - def refresh_needed(self, refresh_in=None): - if self._frozen_credentials is None: - return True - return super(DeferredRefreshableCredentials, self).refresh_needed( - refresh_in - ) - - -class CachedCredentialFetcher(object): - def __init__(self, cache=None, expiry_window_seconds=60 * 15): - if cache is None: - cache = {} - self._cache = cache - self._cache_key = self._create_cache_key() - self._expiry_window_seconds = expiry_window_seconds - - def _create_cache_key(self): - raise NotImplementedError('_create_cache_key()') - - def _make_file_safe(self, filename): - # Replace :, path sep, and / to make it the string filename safe. - filename = filename.replace(':', '_').replace(os.path.sep, '_') - return filename.replace('/', '_') - - def _get_credentials(self): - raise NotImplementedError('_get_credentials()') - - def fetch_credentials(self): - return self._get_cached_credentials() - - def _get_cached_credentials(self): - """Get up-to-date credentials. - - This will check the cache for up-to-date credentials, calling assume - role if none are available. - """ - response = self._load_from_cache() - if response is None: - response = self._get_credentials() - self._write_to_cache(response) - else: - logger.debug("Credentials for role retrieved from cache.") - - creds = response['Credentials'] - expiration = _serialize_if_needed(creds['Expiration'], iso=True) - return { - 'access_key': creds['AccessKeyId'], - 'secret_key': creds['SecretAccessKey'], - 'token': creds['SessionToken'], - 'expiry_time': expiration, - } - - def _load_from_cache(self): - if self._cache_key in self._cache: - creds = deepcopy(self._cache[self._cache_key]) - if not self._is_expired(creds): - return creds - else: - logger.debug( - "Credentials were found in cache, but they are expired." - ) - return None - - def _write_to_cache(self, response): - self._cache[self._cache_key] = deepcopy(response) - - def _is_expired(self, credentials): - """Check if credentials are expired.""" - end_time = _parse_if_needed(credentials['Credentials']['Expiration']) - seconds = total_seconds(end_time - _local_now()) - return seconds < self._expiry_window_seconds - - -class AssumeRoleCredentialFetcher(CachedCredentialFetcher): - def __init__(self, client_creator, source_credentials, role_arn, - extra_args=None, mfa_prompter=None, cache=None, - expiry_window_seconds=60 * 15): - """ - :type client_creator: callable - :param client_creator: A callable that creates a client taking - arguments like ``Session.create_client``. - - :type source_credentials: Credentials - :param source_credentials: The credentials to use to create the - client for the call to AssumeRole. - - :type role_arn: str - :param role_arn: The ARN of the role to be assumed. - - :type extra_args: dict - :param extra_args: Any additional arguments to add to the assume - role request using the format of the botocore operation. - Possible keys include, but may not be limited to, - DurationSeconds, Policy, SerialNumber, ExternalId and - RoleSessionName. - - :type mfa_prompter: callable - :param mfa_prompter: A callable that returns input provided by the - user (i.e raw_input, getpass.getpass, etc.). - - :type cache: dict - :param cache: An object that supports ``__getitem__``, - ``__setitem__``, and ``__contains__``. An example of this is - the ``JSONFileCache`` class in aws-cli. - - :type expiry_window_seconds: int - :param expiry_window_seconds: The amount of time, in seconds, - """ - self._client_creator = client_creator - self._source_credentials = source_credentials - self._role_arn = role_arn - - if extra_args is None: - self._assume_kwargs = {} - else: - self._assume_kwargs = deepcopy(extra_args) - self._assume_kwargs['RoleArn'] = self._role_arn - - self._role_session_name = self._assume_kwargs.get('RoleSessionName') - self._using_default_session_name = False - if not self._role_session_name: - self._role_session_name = 'botocore-session-%s' % ( - int(time.time())) - self._assume_kwargs['RoleSessionName'] = self._role_session_name - self._using_default_session_name = True - - self._mfa_prompter = mfa_prompter - if self._mfa_prompter is None: - self._mfa_prompter = getpass.getpass - - super(AssumeRoleCredentialFetcher, self).__init__( - cache, expiry_window_seconds - ) - - def _create_cache_key(self): - """Create a predictable cache key for the current configuration. - - The cache key is intended to be compatible with file names. - """ - args = deepcopy(self._assume_kwargs) - - # The role session name gets randomly generated, so we don't want it - # in the hash. - if self._using_default_session_name: - del args['RoleSessionName'] - - if 'Policy' in args: - # To have a predictable hash, the keys of the policy must be - # sorted, so we have to load it here to make sure it gets sorted - # later on. - args['Policy'] = json.loads(args['Policy']) - - args = json.dumps(args, sort_keys=True) - argument_hash = sha1(args.encode('utf-8')).hexdigest() - return self._make_file_safe(argument_hash) - - def _get_credentials(self): - """Get credentials by calling assume role.""" - kwargs = self._assume_role_kwargs() - client = self._create_client() - return client.assume_role(**kwargs) - - def _assume_role_kwargs(self): - """Get the arguments for assume role based on current configuration.""" - assume_role_kwargs = self._assume_kwargs - mfa_serial = assume_role_kwargs.get('SerialNumber') - - if mfa_serial is not None: - prompt = 'Enter MFA code for %s: ' % mfa_serial - token_code = self._mfa_prompter(prompt) - - assume_role_kwargs = deepcopy(assume_role_kwargs) - assume_role_kwargs['TokenCode'] = token_code - - return assume_role_kwargs - - def _create_client(self): - """Create an STS client using the source credentials.""" - frozen_credentials = self._source_credentials.get_frozen_credentials() - return self._client_creator( - 'sts', - aws_access_key_id=frozen_credentials.access_key, - aws_secret_access_key=frozen_credentials.secret_key, - aws_session_token=frozen_credentials.token, - ) - - -class CredentialProvider(object): - # A short name to identify the provider within botocore. - METHOD = None - - # A name to identify the provider for use in cross-sdk features like - # assume role's `credential_source` configuration option. These names - # are to be treated in a case-insensitive way. NOTE: any providers not - # implemented in botocore MUST prefix their canonical names with - # 'custom' or we DO NOT guarantee that it will work with any features - # that this provides. - CANONICAL_NAME = None - - def __init__(self, session=None): - self.session = session - - def load(self): - """ - Loads the credentials from their source & sets them on the object. - - Subclasses should implement this method (by reading from disk, the - environment, the network or wherever), returning ``True`` if they were - found & loaded. - - If not found, this method should return ``False``, indictating that the - ``CredentialResolver`` should fall back to the next available method. - - The default implementation does nothing, assuming the user has set the - ``access_key/secret_key/token`` themselves. - - :returns: Whether credentials were found & set - :rtype: Credentials - """ - return True - - def _extract_creds_from_mapping(self, mapping, *key_names): - found = [] - for key_name in key_names: - try: - found.append(mapping[key_name]) - except KeyError: - raise PartialCredentialsError(provider=self.METHOD, - cred_var=key_name) - return found - - -class ProcessProvider(CredentialProvider): - - METHOD = 'custom-process' - - def __init__(self, profile_name, load_config, popen=subprocess.Popen): - self._profile_name = profile_name - self._load_config = load_config - self._loaded_config = None - self._popen = popen - - def load(self): - credential_process = self._credential_process - if credential_process is None: - return - - creds_dict = self._retrieve_credentials_using(credential_process) - if creds_dict.get('expiry_time') is not None: - return RefreshableCredentials.create_from_metadata( - creds_dict, - lambda: self._retrieve_credentials_using(credential_process), - self.METHOD - ) - - return Credentials( - access_key=creds_dict['access_key'], - secret_key=creds_dict['secret_key'], - token=creds_dict.get('token'), - method=self.METHOD - ) - - def _retrieve_credentials_using(self, credential_process): - # We're not using shell=True, so we need to pass the - # command and all arguments as a list. - process_list = compat_shell_split(credential_process) - p = self._popen(process_list, - stdout=subprocess.PIPE, - stderr=subprocess.PIPE) - stdout, stderr = p.communicate() - if p.returncode != 0: - raise CredentialRetrievalError( - provider=self.METHOD, error_msg=stderr.decode('utf-8')) - parsed = botocore.compat.json.loads(stdout.decode('utf-8')) - version = parsed.get('Version', '') - if version != 1: - raise CredentialRetrievalError( - provider=self.METHOD, - error_msg=("Unsupported version '%s' for credential process " - "provider, supported versions: 1" % version)) - try: - return { - 'access_key': parsed['AccessKeyId'], - 'secret_key': parsed['SecretAccessKey'], - 'token': parsed.get('SessionToken'), - 'expiry_time': parsed.get('Expiration'), - } - except KeyError as e: - raise CredentialRetrievalError( - provider=self.METHOD, - error_msg="Missing required key in response: %s" % e - ) - - @property - def _credential_process(self): - if self._loaded_config is None: - self._loaded_config = self._load_config() - profile_config = self._loaded_config.get( - 'profiles', {}).get(self._profile_name, {}) - return profile_config.get('credential_process') - - -class InstanceMetadataProvider(CredentialProvider): - METHOD = 'iam-role' - CANONICAL_NAME = 'Ec2InstanceMetadata' - - def __init__(self, iam_role_fetcher): - self._role_fetcher = iam_role_fetcher - - def load(self): - fetcher = self._role_fetcher - # We do the first request, to see if we get useful data back. - # If not, we'll pass & move on to whatever's next in the credential - # chain. - metadata = fetcher.retrieve_iam_role_credentials() - if not metadata: - return None - logger.debug('Found credentials from IAM Role: %s', - metadata['role_name']) - # We manually set the data here, since we already made the request & - # have it. When the expiry is hit, the credentials will auto-refresh - # themselves. - creds = RefreshableCredentials.create_from_metadata( - metadata, - method=self.METHOD, - refresh_using=fetcher.retrieve_iam_role_credentials, - ) - return creds - - -class EnvProvider(CredentialProvider): - METHOD = 'env' - CANONICAL_NAME = 'Environment' - ACCESS_KEY = 'AWS_ACCESS_KEY_ID' - SECRET_KEY = 'AWS_SECRET_ACCESS_KEY' - # The token can come from either of these env var. - # AWS_SESSION_TOKEN is what other AWS SDKs have standardized on. - TOKENS = ['AWS_SECURITY_TOKEN', 'AWS_SESSION_TOKEN'] - EXPIRY_TIME = 'AWS_CREDENTIAL_EXPIRATION' - - def __init__(self, environ=None, mapping=None): - """ - - :param environ: The environment variables (defaults to - ``os.environ`` if no value is provided). - :param mapping: An optional mapping of variable names to - environment variable names. Use this if you want to - change the mapping of access_key->AWS_ACCESS_KEY_ID, etc. - The dict can have up to 3 keys: ``access_key``, ``secret_key``, - ``session_token``. - """ - if environ is None: - environ = os.environ - self.environ = environ - self._mapping = self._build_mapping(mapping) - - def _build_mapping(self, mapping): - # Mapping of variable name to env var name. - var_mapping = {} - if mapping is None: - # Use the class var default. - var_mapping['access_key'] = self.ACCESS_KEY - var_mapping['secret_key'] = self.SECRET_KEY - var_mapping['token'] = self.TOKENS - var_mapping['expiry_time'] = self.EXPIRY_TIME - else: - var_mapping['access_key'] = mapping.get( - 'access_key', self.ACCESS_KEY) - var_mapping['secret_key'] = mapping.get( - 'secret_key', self.SECRET_KEY) - var_mapping['token'] = mapping.get( - 'token', self.TOKENS) - if not isinstance(var_mapping['token'], list): - var_mapping['token'] = [var_mapping['token']] - var_mapping['expiry_time'] = mapping.get( - 'expiry_time', self.EXPIRY_TIME) - return var_mapping - - def load(self): - """ - Search for credentials in explicit environment variables. - """ - if self._mapping['access_key'] in self.environ: - logger.info('Found credentials in environment variables.') - fetcher = self._create_credentials_fetcher() - credentials = fetcher(require_expiry=False) - - expiry_time = credentials['expiry_time'] - if expiry_time is not None: - expiry_time = parse(expiry_time) - return RefreshableCredentials( - credentials['access_key'], credentials['secret_key'], - credentials['token'], expiry_time, - refresh_using=fetcher, method=self.METHOD - ) - - return Credentials( - credentials['access_key'], credentials['secret_key'], - credentials['token'], method=self.METHOD - ) - else: - return None - - def _create_credentials_fetcher(self): - mapping = self._mapping - method = self.METHOD - environ = self.environ - - def fetch_credentials(require_expiry=True): - credentials = {} - - access_key = environ.get(mapping['access_key']) - if access_key is None: - raise PartialCredentialsError( - provider=method, cred_var=mapping['access_key']) - credentials['access_key'] = access_key - - secret_key = environ.get(mapping['secret_key']) - if secret_key is None: - raise PartialCredentialsError( - provider=method, cred_var=mapping['secret_key']) - credentials['secret_key'] = secret_key - - token = None - for token_env_var in mapping['token']: - if token_env_var in environ: - token = environ[token_env_var] - break - credentials['token'] = token - - expiry_time = environ.get(mapping['expiry_time']) - if require_expiry and expiry_time is None: - raise PartialCredentialsError( - provider=method, cred_var=mapping['expiry_time']) - credentials['expiry_time'] = expiry_time - - return credentials - - return fetch_credentials - - -class OriginalEC2Provider(CredentialProvider): - METHOD = 'ec2-credentials-file' - CANONICAL_NAME = 'Ec2Config' - - CRED_FILE_ENV = 'AWS_CREDENTIAL_FILE' - ACCESS_KEY = 'AWSAccessKeyId' - SECRET_KEY = 'AWSSecretKey' - - def __init__(self, environ=None, parser=None): - if environ is None: - environ = os.environ - if parser is None: - parser = parse_key_val_file - self._environ = environ - self._parser = parser - - def load(self): - """ - Search for a credential file used by original EC2 CLI tools. - """ - if 'AWS_CREDENTIAL_FILE' in self._environ: - full_path = os.path.expanduser( - self._environ['AWS_CREDENTIAL_FILE']) - creds = self._parser(full_path) - if self.ACCESS_KEY in creds: - logger.info('Found credentials in AWS_CREDENTIAL_FILE.') - access_key = creds[self.ACCESS_KEY] - secret_key = creds[self.SECRET_KEY] - # EC2 creds file doesn't support session tokens. - return Credentials(access_key, secret_key, method=self.METHOD) - else: - return None - - -class SharedCredentialProvider(CredentialProvider): - METHOD = 'shared-credentials-file' - CANONICAL_NAME = 'SharedCredentials' - - ACCESS_KEY = 'aws_access_key_id' - SECRET_KEY = 'aws_secret_access_key' - # Same deal as the EnvProvider above. Botocore originally supported - # aws_security_token, but the SDKs are standardizing on aws_session_token - # so we support both. - TOKENS = ['aws_security_token', 'aws_session_token'] - - def __init__(self, creds_filename, profile_name=None, ini_parser=None): - self._creds_filename = creds_filename - if profile_name is None: - profile_name = 'default' - self._profile_name = profile_name - if ini_parser is None: - ini_parser = botocore.configloader.raw_config_parse - self._ini_parser = ini_parser - - def load(self): - try: - available_creds = self._ini_parser(self._creds_filename) - except ConfigNotFound: - return None - if self._profile_name in available_creds: - config = available_creds[self._profile_name] - if self.ACCESS_KEY in config: - logger.info("Found credentials in shared credentials file: %s", - self._creds_filename) - access_key, secret_key = self._extract_creds_from_mapping( - config, self.ACCESS_KEY, self.SECRET_KEY) - token = self._get_session_token(config) - return Credentials(access_key, secret_key, token, - method=self.METHOD) - - def _get_session_token(self, config): - for token_envvar in self.TOKENS: - if token_envvar in config: - return config[token_envvar] - - -class ConfigProvider(CredentialProvider): - """INI based config provider with profile sections.""" - METHOD = 'config-file' - CANONICAL_NAME = 'SharedConfig' - - ACCESS_KEY = 'aws_access_key_id' - SECRET_KEY = 'aws_secret_access_key' - # Same deal as the EnvProvider above. Botocore originally supported - # aws_security_token, but the SDKs are standardizing on aws_session_token - # so we support both. - TOKENS = ['aws_security_token', 'aws_session_token'] - - def __init__(self, config_filename, profile_name, config_parser=None): - """ - - :param config_filename: The session configuration scoped to the current - profile. This is available via ``session.config``. - :param profile_name: The name of the current profile. - :param config_parser: A config parser callable. - - """ - self._config_filename = config_filename - self._profile_name = profile_name - if config_parser is None: - config_parser = botocore.configloader.load_config - self._config_parser = config_parser - - def load(self): - """ - If there is are credentials in the configuration associated with - the session, use those. - """ - try: - full_config = self._config_parser(self._config_filename) - except ConfigNotFound: - return None - if self._profile_name in full_config['profiles']: - profile_config = full_config['profiles'][self._profile_name] - if self.ACCESS_KEY in profile_config: - logger.info("Credentials found in config file: %s", - self._config_filename) - access_key, secret_key = self._extract_creds_from_mapping( - profile_config, self.ACCESS_KEY, self.SECRET_KEY) - token = self._get_session_token(profile_config) - return Credentials(access_key, secret_key, token, - method=self.METHOD) - else: - return None - - def _get_session_token(self, profile_config): - for token_name in self.TOKENS: - if token_name in profile_config: - return profile_config[token_name] - - -class BotoProvider(CredentialProvider): - METHOD = 'boto-config' - CANONICAL_NAME = 'Boto2Config' - - BOTO_CONFIG_ENV = 'BOTO_CONFIG' - DEFAULT_CONFIG_FILENAMES = ['/etc/boto.cfg', '~/.boto'] - ACCESS_KEY = 'aws_access_key_id' - SECRET_KEY = 'aws_secret_access_key' - - def __init__(self, environ=None, ini_parser=None): - if environ is None: - environ = os.environ - if ini_parser is None: - ini_parser = botocore.configloader.raw_config_parse - self._environ = environ - self._ini_parser = ini_parser - - def load(self): - """ - Look for credentials in boto config file. - """ - if self.BOTO_CONFIG_ENV in self._environ: - potential_locations = [self._environ[self.BOTO_CONFIG_ENV]] - else: - potential_locations = self.DEFAULT_CONFIG_FILENAMES - for filename in potential_locations: - try: - config = self._ini_parser(filename) - except ConfigNotFound: - # Move on to the next potential config file name. - continue - if 'Credentials' in config: - credentials = config['Credentials'] - if self.ACCESS_KEY in credentials: - logger.info("Found credentials in boto config file: %s", - filename) - access_key, secret_key = self._extract_creds_from_mapping( - credentials, self.ACCESS_KEY, self.SECRET_KEY) - return Credentials(access_key, secret_key, - method=self.METHOD) - - -class AssumeRoleProvider(CredentialProvider): - METHOD = 'assume-role' - # The AssumeRole provider is logically part of the SharedConfig and - # SharedCredentials providers. Since the purpose of the canonical name - # is to provide cross-sdk compatibility, calling code will need to be - # aware that either of those providers should be tied to the AssumeRole - # provider as much as possible. - CANONICAL_NAME = None - ROLE_CONFIG_VAR = 'role_arn' - # Credentials are considered expired (and will be refreshed) once the total - # remaining time left until the credentials expires is less than the - # EXPIRY_WINDOW. - EXPIRY_WINDOW_SECONDS = 60 * 15 - - def __init__(self, load_config, client_creator, cache, profile_name, - prompter=getpass.getpass, credential_sourcer=None): - """ - :type load_config: callable - :param load_config: A function that accepts no arguments, and - when called, will return the full configuration dictionary - for the session (``session.full_config``). - - :type client_creator: callable - :param client_creator: A factory function that will create - a client when called. Has the same interface as - ``botocore.session.Session.create_client``. - - :type cache: dict - :param cache: An object that supports ``__getitem__``, - ``__setitem__``, and ``__contains__``. An example - of this is the ``JSONFileCache`` class in the CLI. - - :type profile_name: str - :param profile_name: The name of the profile. - - :type prompter: callable - :param prompter: A callable that returns input provided - by the user (i.e raw_input, getpass.getpass, etc.). - - :type credential_sourcer: CanonicalNameCredentialSourcer - :param credential_sourcer: A credential provider that takes a - configuration, which is used to provide the source credentials - for the STS call. - """ - #: The cache used to first check for assumed credentials. - #: This is checked before making the AssumeRole API - #: calls and can be useful if you have short lived - #: scripts and you'd like to avoid calling AssumeRole - #: until the credentials are expired. - self.cache = cache - self._load_config = load_config - # client_creator is a callable that creates function. - # It's basically session.create_client - self._client_creator = client_creator - self._profile_name = profile_name - self._prompter = prompter - # The _loaded_config attribute will be populated from the - # load_config() function once the configuration is actually - # loaded. The reason we go through all this instead of just - # requiring that the loaded_config be passed to us is to that - # we can defer configuration loaded until we actually try - # to load credentials (as opposed to when the object is - # instantiated). - self._loaded_config = {} - self._credential_sourcer = credential_sourcer - self._visited_profiles = [self._profile_name] - - def load(self): - self._loaded_config = self._load_config() - profiles = self._loaded_config.get('profiles', {}) - profile = profiles.get(self._profile_name, {}) - if self._has_assume_role_config_vars(profile): - return self._load_creds_via_assume_role(self._profile_name) - - def _has_assume_role_config_vars(self, profile): - return self.ROLE_CONFIG_VAR in profile - - def _load_creds_via_assume_role(self, profile_name): - role_config = self._get_role_config(profile_name) - source_credentials = self._resolve_source_credentials( - role_config, profile_name - ) - - extra_args = {} - role_session_name = role_config.get('role_session_name') - if role_session_name is not None: - extra_args['RoleSessionName'] = role_session_name - - external_id = role_config.get('external_id') - if external_id is not None: - extra_args['ExternalId'] = external_id - - mfa_serial = role_config.get('mfa_serial') - if mfa_serial is not None: - extra_args['SerialNumber'] = mfa_serial - - fetcher = AssumeRoleCredentialFetcher( - client_creator=self._client_creator, - source_credentials=source_credentials, - role_arn=role_config['role_arn'], - extra_args=extra_args, - mfa_prompter=self._prompter, - cache=self.cache, - ) - refresher = fetcher.fetch_credentials - if mfa_serial is not None: - refresher = create_mfa_serial_refresher(refresher) - - # The initial credentials are empty and the expiration time is set - # to now so that we can delay the call to assume role until it is - # strictly needed. - return DeferredRefreshableCredentials( - method=self.METHOD, - refresh_using=refresher, - time_fetcher=_local_now - ) - - def _get_role_config(self, profile_name): - """Retrieves and validates the role configuration for the profile.""" - profiles = self._loaded_config.get('profiles', {}) - - profile = profiles[profile_name] - source_profile = profile.get('source_profile') - role_arn = profile['role_arn'] - credential_source = profile.get('credential_source') - mfa_serial = profile.get('mfa_serial') - external_id = profile.get('external_id') - role_session_name = profile.get('role_session_name') - - role_config = { - 'role_arn': role_arn, - 'external_id': external_id, - 'mfa_serial': mfa_serial, - 'role_session_name': role_session_name, - 'source_profile': source_profile, - 'credential_source': credential_source - } - - # Either the credential source or the source profile must be - # specified, but not both. - if credential_source is not None and source_profile is not None: - raise InvalidConfigError( - error_msg=( - 'The profile "%s" contains both source_profile and ' - 'credential_source.' % profile_name - ) - ) - elif credential_source is None and source_profile is None: - raise PartialCredentialsError( - provider=self.METHOD, - cred_var='source_profile or credential_source' - ) - elif credential_source is not None: - self._validate_credential_source( - profile_name, credential_source) - else: - self._validate_source_profile(profile_name, source_profile) - - return role_config - - def _validate_credential_source(self, parent_profile, credential_source): - if self._credential_sourcer is None: - raise InvalidConfigError(error_msg=( - 'The credential_source "%s" is specified in profile "%s", ' - 'but no source provider was configured.' % ( - credential_source, parent_profile) - )) - if not self._credential_sourcer.is_supported(credential_source): - raise InvalidConfigError(error_msg=( - 'The credential source "%s" referenced in profile "%s" is not ' - 'valid.' % (credential_source, parent_profile) - )) - - def _source_profile_has_credentials(self, profile): - return any([ - self._has_static_credentials(profile), - self._has_assume_role_config_vars(profile), - ]) - - def _validate_source_profile(self, parent_profile_name, - source_profile_name): - profiles = self._loaded_config.get('profiles', {}) - if source_profile_name not in profiles: - raise InvalidConfigError( - error_msg=( - 'The source_profile "%s" referenced in ' - 'the profile "%s" does not exist.' % ( - source_profile_name, parent_profile_name) - ) - ) - - source_profile = profiles[source_profile_name] - - # Ensure the profile has valid credential type - if not self._source_profile_has_credentials(source_profile): - raise InvalidConfigError( - error_msg=( - 'The source_profile "%s" must specify either static ' - 'credentials or an assume role configuration' % ( - source_profile_name) - ) - ) - - # Make sure we aren't going into an infinite loop. If we haven't - # visited the profile yet, we're good. - if source_profile_name not in self._visited_profiles: - return - - # If we have visited the profile and the profile isn't simply - # referencing itself, that's an infinite loop. - if source_profile_name != parent_profile_name: - raise InfiniteLoopConfigError( - source_profile=source_profile_name, - visited_profiles=self._visited_profiles - ) - - # A profile is allowed to reference itself so that it can source - # static credentials and have configuration all in the same - # profile. This will only ever work for the top level assume - # role because the static credentials will otherwise take - # precedence. - if not self._has_static_credentials(source_profile): - raise InfiniteLoopConfigError( - source_profile=source_profile_name, - visited_profiles=self._visited_profiles - ) - - def _has_static_credentials(self, profile): - static_keys = ['aws_secret_access_key', 'aws_access_key_id'] - return any(static_key in profile for static_key in static_keys) - - def _resolve_source_credentials(self, role_config, profile_name): - credential_source = role_config.get('credential_source') - if credential_source is not None: - return self._resolve_credentials_from_source( - credential_source, profile_name - ) - - source_profile = role_config['source_profile'] - self._visited_profiles.append(source_profile) - return self._resolve_credentials_from_profile(source_profile) - - def _resolve_credentials_from_profile(self, profile_name): - profiles = self._loaded_config.get('profiles', {}) - profile = profiles[profile_name] - - if self._has_static_credentials(profile): - return self._resolve_static_credentials_from_profile(profile) - - return self._load_creds_via_assume_role(profile_name) - - def _resolve_static_credentials_from_profile(self, profile): - try: - return Credentials( - access_key=profile['aws_access_key_id'], - secret_key=profile['aws_secret_access_key'], - token=profile.get('aws_session_token') - ) - except KeyError as e: - raise PartialCredentialsError( - provider=self.METHOD, cred_var=str(e)) - - def _resolve_credentials_from_source(self, credential_source, - profile_name): - credentials = self._credential_sourcer.source_credentials( - credential_source) - if credentials is None: - raise CredentialRetrievalError( - provider=credential_source, - error_msg=( - 'No credentials found in credential_source referenced ' - 'in profile %s' % profile_name - ) - ) - return credentials - - -class CanonicalNameCredentialSourcer(object): - def __init__(self, providers): - self._providers = providers - - def is_supported(self, source_name): - """Validates a given source name. - - :type source_name: str - :param source_name: The value of credential_source in the config - file. This is the canonical name of the credential provider. - - :rtype: bool - :returns: True if the credential provider is supported, - False otherwise. - """ - return source_name in [p.CANONICAL_NAME for p in self._providers] - - def source_credentials(self, source_name): - """Loads source credentials based on the provided configuration. - - :type source_name: str - :param source_name: The value of credential_source in the config - file. This is the canonical name of the credential provider. - - :rtype: Credentials - """ - source = self._get_provider(source_name) - if isinstance(source, CredentialResolver): - return source.load_credentials() - return source.load() - - def _get_provider(self, canonical_name): - """Return a credential provider by its canonical name. - - :type canonical_name: str - :param canonical_name: The canonical name of the provider. - - :raises UnknownCredentialError: Raised if no - credential provider by the provided name - is found. - """ - provider = self._get_provider_by_canonical_name(canonical_name) - - # The AssumeRole provider should really be part of the SharedConfig - # provider rather than being its own thing, but it is not. It is - # effectively part of both the SharedConfig provider and the - # SharedCredentials provider now due to the way it behaves. - # Therefore if we want either of those providers we should return - # the AssumeRole provider with it. - if canonical_name.lower() in ['sharedconfig', 'sharedcredentials']: - assume_role_provider = self._get_provider_by_method('assume-role') - if assume_role_provider is not None: - # The SharedConfig or SharedCredentials provider may not be - # present if it was removed for some reason, but the - # AssumeRole provider could still be present. In that case, - # return the assume role provider by itself. - if provider is None: - return assume_role_provider - - # If both are present, return them both as a - # CredentialResolver so that calling code can treat them as - # a single entity. - return CredentialResolver([assume_role_provider, provider]) - - if provider is None: - raise UnknownCredentialError(name=canonical_name) - - return provider - - def _get_provider_by_canonical_name(self, canonical_name): - """Return a credential provider by its canonical name. - - This function is strict, it does not attempt to address - compatibility issues. - """ - for provider in self._providers: - name = provider.CANONICAL_NAME - # Canonical names are case-insensitive - if name and name.lower() == canonical_name.lower(): - return provider - - def _get_provider_by_method(self, method): - """Return a credential provider by its METHOD name.""" - for provider in self._providers: - if provider.METHOD == method: - return provider - - -class ContainerProvider(CredentialProvider): - METHOD = 'container-role' - CANONICAL_NAME = 'EcsContainer' - ENV_VAR = 'AWS_CONTAINER_CREDENTIALS_RELATIVE_URI' - ENV_VAR_FULL = 'AWS_CONTAINER_CREDENTIALS_FULL_URI' - ENV_VAR_AUTH_TOKEN = 'AWS_CONTAINER_AUTHORIZATION_TOKEN' - - def __init__(self, environ=None, fetcher=None): - if environ is None: - environ = os.environ - if fetcher is None: - fetcher = ContainerMetadataFetcher() - self._environ = environ - self._fetcher = fetcher - - def load(self): - # This cred provider is only triggered if the self.ENV_VAR is set, - # which only happens if you opt into this feature. - if self.ENV_VAR in self._environ or self.ENV_VAR_FULL in self._environ: - return self._retrieve_or_fail() - - def _retrieve_or_fail(self): - if self._provided_relative_uri(): - full_uri = self._fetcher.full_url(self._environ[self.ENV_VAR]) - else: - full_uri = self._environ[self.ENV_VAR_FULL] - headers = self._build_headers() - fetcher = self._create_fetcher(full_uri, headers) - creds = fetcher() - return RefreshableCredentials( - access_key=creds['access_key'], - secret_key=creds['secret_key'], - token=creds['token'], - method=self.METHOD, - expiry_time=_parse_if_needed(creds['expiry_time']), - refresh_using=fetcher, - ) - - def _build_headers(self): - headers = {} - auth_token = self._environ.get(self.ENV_VAR_AUTH_TOKEN) - if auth_token is not None: - return { - 'Authorization': auth_token - } - - def _create_fetcher(self, full_uri, headers): - def fetch_creds(): - try: - response = self._fetcher.retrieve_full_uri( - full_uri, headers=headers) - except MetadataRetrievalError as e: - logger.debug("Error retrieving container metadata: %s", e, - exc_info=True) - raise CredentialRetrievalError(provider=self.METHOD, - error_msg=str(e)) - return { - 'access_key': response['AccessKeyId'], - 'secret_key': response['SecretAccessKey'], - 'token': response['Token'], - 'expiry_time': response['Expiration'], - } - - return fetch_creds - - def _provided_relative_uri(self): - return self.ENV_VAR in self._environ - - -class CredentialResolver(object): - def __init__(self, providers): - """ - - :param providers: A list of ``CredentialProvider`` instances. - - """ - self.providers = providers - - def insert_before(self, name, credential_provider): - """ - Inserts a new instance of ``CredentialProvider`` into the chain that - will be tried before an existing one. - - :param name: The short name of the credentials you'd like to insert the - new credentials before. (ex. ``env`` or ``config``). Existing names - & ordering can be discovered via ``self.available_methods``. - :type name: string - - :param cred_instance: An instance of the new ``Credentials`` object - you'd like to add to the chain. - :type cred_instance: A subclass of ``Credentials`` - """ - try: - offset = [p.METHOD for p in self.providers].index(name) - except ValueError: - raise UnknownCredentialError(name=name) - self.providers.insert(offset, credential_provider) - - def insert_after(self, name, credential_provider): - """ - Inserts a new type of ``Credentials`` instance into the chain that will - be tried after an existing one. - - :param name: The short name of the credentials you'd like to insert the - new credentials after. (ex. ``env`` or ``config``). Existing names - & ordering can be discovered via ``self.available_methods``. - :type name: string - - :param cred_instance: An instance of the new ``Credentials`` object - you'd like to add to the chain. - :type cred_instance: A subclass of ``Credentials`` - """ - offset = self._get_provider_offset(name) - self.providers.insert(offset + 1, credential_provider) - - def remove(self, name): - """ - Removes a given ``Credentials`` instance from the chain. - - :param name: The short name of the credentials instance to remove. - :type name: string - """ - available_methods = [p.METHOD for p in self.providers] - if name not in available_methods: - # It's not present. Fail silently. - return - - offset = available_methods.index(name) - self.providers.pop(offset) - - def get_provider(self, name): - """Return a credential provider by name. - - :type name: str - :param name: The name of the provider. - - :raises UnknownCredentialError: Raised if no - credential provider by the provided name - is found. - """ - return self.providers[self._get_provider_offset(name)] - - def _get_provider_offset(self, name): - try: - return [p.METHOD for p in self.providers].index(name) - except ValueError: - raise UnknownCredentialError(name=name) - - def load_credentials(self): - """ - Goes through the credentials chain, returning the first ``Credentials`` - that could be loaded. - """ - # First provider to return a non-None response wins. - for provider in self.providers: - logger.debug("Looking for credentials via: %s", provider.METHOD) - creds = provider.load() - if creds is not None: - return creds - - # If we got here, no credentials could be found. - # This feels like it should be an exception, but historically, ``None`` - # is returned. - # - # +1 - # -js - return None diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/_retry.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/_retry.json deleted file mode 100644 index c477c9bd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/_retry.json +++ /dev/null @@ -1,261 +0,0 @@ -{ - "definitions": { - "throttling": { - "applies_when": { - "response": { - "service_error_code": "Throttling", - "http_status_code": 400 - } - } - }, - "throttling_exception": { - "applies_when": { - "response": { - "service_error_code": "ThrottlingException", - "http_status_code": 400 - } - } - }, - "throttled_exception": { - "applies_when": { - "response": { - "service_error_code": "ThrottledException", - "http_status_code": 400 - } - } - }, - "request_throttled_exception": { - "applies_when": { - "response": { - "service_error_code": "RequestThrottledException", - "http_status_code": 400 - } - } - }, - "too_many_requests": { - "applies_when": { - "response": { - "http_status_code": 429 - } - } - }, - "general_socket_errors": { - "applies_when": { - "socket_errors": ["GENERAL_CONNECTION_ERROR"] - } - }, - "general_server_error": { - "applies_when": { - "response": { - "http_status_code": 500 - } - } - }, - "bad_gateway": { - "applies_when": { - "response": { - "http_status_code": 502 - } - } - }, - "service_unavailable": { - "applies_when": { - "response": { - "http_status_code": 503 - } - } - }, - "gateway_timeout": { - "applies_when": { - "response": { - "http_status_code": 504 - } - } - }, - "limit_exceeded": { - "applies_when": { - "response": { - "http_status_code": 509 - } - } - } - }, - "retry": { - "__default__": { - "max_attempts": 5, - "delay": { - "type": "exponential", - "base": "rand", - "growth_factor": 2 - }, - "policies": { - "general_socket_errors": {"$ref": "general_socket_errors"}, - "general_server_error": {"$ref": "general_server_error"}, - "bad_gateway": {"$ref": "bad_gateway"}, - "service_unavailable": {"$ref": "service_unavailable"}, - "gateway_timeout": {"$ref": "gateway_timeout"}, - "limit_exceeded": {"$ref": "limit_exceeded"}, - "throttling_exception": {"$ref": "throttling_exception"}, - "throttled_exception": {"$ref": "throttled_exception"}, - "request_throttled_exception": {"$ref": "request_throttled_exception"}, - "throttling": {"$ref": "throttling"}, - "too_many_requests": {"$ref": "too_many_requests"} - } - }, - "organizations": { - "__default__": { - "policies": { - "too_many_requests": { - "applies_when": { - "response": { - "service_error_code": "TooManyRequestsException", - "http_status_code": 400 - } - } - } - } - } - }, - "dynamodb": { - "__default__": { - "max_attempts": 10, - "delay": { - "type": "exponential", - "base": 0.05, - "growth_factor": 2 - }, - "policies": { - "throughput_exceeded": { - "applies_when": { - "response": { - "service_error_code": "ProvisionedThroughputExceededException", - "http_status_code": 400 - } - } - }, - "crc32": { - "applies_when": { - "response": { - "crc32body": "x-amz-crc32" - } - } - } - } - } - }, - "ec2": { - "__default__": { - "policies": { - "request_limit_exceeded": { - "applies_when": { - "response": { - "service_error_code": "RequestLimitExceeded", - "http_status_code": 503 - } - } - } - } - } - }, - "cloudsearch": { - "__default__": { - "policies": { - "request_limit_exceeded": { - "applies_when": { - "response": { - "service_error_code": "BandwidthLimitExceeded", - "http_status_code": 509 - } - } - } - } - } - }, - "kinesis": { - "DescribeStream": { - "policies": { - "request_limit_exceeded": { - "applies_when": { - "response": { - "service_error_code": "LimitExceededException", - "http_status_code": 400 - } - } - } - } - } - }, - "sqs": { - "__default__": { - "policies": { - "request_limit_exceeded": { - "applies_when": { - "response": { - "service_error_code": "RequestThrottled", - "http_status_code": 403 - } - } - } - } - } - }, - "s3": { - "__default__": { - "policies": { - "timeouts": { - "applies_when": { - "response": { - "http_status_code": 400, - "service_error_code": "RequestTimeout" - } - } - }, - "contentmd5": { - "applies_when": { - "response": { - "http_status_code": 400, - "service_error_code": "BadDigest" - } - } - } - } - } - }, - "glacier": { - "__default__": { - "policies": { - "timeouts": { - "applies_when": { - "response": { - "http_status_code": 408, - "service_error_code": "RequestTimeoutException" - } - } - } - } - } - }, - "route53": { - "__default__": { - "policies": { - "request_limit_exceeded": { - "applies_when": { - "response": { - "service_error_code": "Throttling", - "http_status_code": 400 - } - } - }, - "still_processing": { - "applies_when": { - "response": { - "service_error_code": "PriorRequestNotComplete", - "http_status_code": 400 - } - } - } - } - } - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/service-2.json deleted file mode 100644 index f24c7ba6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm-pca/2017-08-22/service-2.json +++ /dev/null @@ -1,1261 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-08-22", - "endpointPrefix":"acm-pca", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"ACM-PCA", - "serviceFullName":"AWS Certificate Manager Private Certificate Authority", - "serviceId":"ACM PCA", - "signatureVersion":"v4", - "targetPrefix":"ACMPrivateCA", - "uid":"acm-pca-2017-08-22" - }, - "operations":{ - "CreateCertificateAuthority":{ - "name":"CreateCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCertificateAuthorityRequest"}, - "output":{"shape":"CreateCertificateAuthorityResponse"}, - "errors":[ - {"shape":"InvalidArgsException"}, - {"shape":"InvalidPolicyException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a private subordinate certificate authority (CA). You must specify the CA configuration, the revocation configuration, the CA type, and an optional idempotency token. The CA configuration specifies the name of the algorithm and key size to be used to create the CA private key, the type of signing algorithm that the CA uses to sign, and X.500 subject information. The CRL (certificate revocation list) configuration specifies the CRL expiration period in days (the validity period of the CRL), the Amazon S3 bucket that will contain the CRL, and a CNAME alias for the S3 bucket that is included in certificates issued by the CA. If successful, this operation returns the Amazon Resource Name (ARN) of the CA.

", - "idempotent":true - }, - "CreateCertificateAuthorityAuditReport":{ - "name":"CreateCertificateAuthorityAuditReport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCertificateAuthorityAuditReportRequest"}, - "output":{"shape":"CreateCertificateAuthorityAuditReportResponse"}, - "errors":[ - {"shape":"RequestInProgressException"}, - {"shape":"RequestFailedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidArgsException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Creates an audit report that lists every time that the your CA private key is used. The report is saved in the Amazon S3 bucket that you specify on input. The IssueCertificate and RevokeCertificate operations use the private key. You can generate a new report every 30 minutes.

", - "idempotent":true - }, - "DeleteCertificateAuthority":{ - "name":"DeleteCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCertificateAuthorityRequest"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Deletes a private certificate authority (CA). You must provide the ARN (Amazon Resource Name) of the private CA that you want to delete. You can find the ARN by calling the ListCertificateAuthorities operation. Before you can delete a CA, you must disable it. Call the UpdateCertificateAuthority operation and set the CertificateAuthorityStatus parameter to DISABLED.

Additionally, you can delete a CA if you are waiting for it to be created (the Status field of the CertificateAuthority is CREATING). You can also delete it if the CA has been created but you haven't yet imported the signed certificate (the Status is PENDING_CERTIFICATE) into ACM PCA.

If the CA is in one of the aforementioned states and you call DeleteCertificateAuthority, the CA's status changes to DELETED. However, the CA won't be permentantly deleted until the restoration period has passed. By default, if you do not set the PermanentDeletionTimeInDays parameter, the CA remains restorable for 30 days. You can set the parameter from 7 to 30 days. The DescribeCertificateAuthority operation returns the time remaining in the restoration window of a Private CA in the DELETED state. To restore an eligable CA, call the RestoreCertificateAuthority operation.

" - }, - "DescribeCertificateAuthority":{ - "name":"DescribeCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCertificateAuthorityRequest"}, - "output":{"shape":"DescribeCertificateAuthorityResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Lists information about your private certificate authority (CA). You specify the private CA on input by its ARN (Amazon Resource Name). The output contains the status of your CA. This can be any of the following:

  • CREATING - ACM PCA is creating your private certificate authority.

  • PENDING_CERTIFICATE - The certificate is pending. You must use your on-premises root or subordinate CA to sign your private CA CSR and then import it into PCA.

  • ACTIVE - Your private CA is active.

  • DISABLED - Your private CA has been disabled.

  • EXPIRED - Your private CA certificate has expired.

  • FAILED - Your private CA has failed. Your CA can fail because of problems such a network outage or backend AWS failure or other errors. A failed CA can never return to the pending state. You must create a new CA.

  • DELETED - Your private CA is within the restoration period, after which it will be permanently deleted. The length of time remaining in the CA's restoration period will also be included in this operation's output.

" - }, - "DescribeCertificateAuthorityAuditReport":{ - "name":"DescribeCertificateAuthorityAuditReport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCertificateAuthorityAuditReportRequest"}, - "output":{"shape":"DescribeCertificateAuthorityAuditReportResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidArgsException"} - ], - "documentation":"

Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport operation. Audit information is created every time the certificate authority (CA) private key is used. The private key is used when you call the IssueCertificate operation or the RevokeCertificate operation.

" - }, - "GetCertificate":{ - "name":"GetCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCertificateRequest"}, - "output":{"shape":"GetCertificateResponse"}, - "errors":[ - {"shape":"RequestInProgressException"}, - {"shape":"RequestFailedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Retrieves a certificate from your private CA. The ARN of the certificate is returned when you call the IssueCertificate operation. You must specify both the ARN of your private CA and the ARN of the issued certificate when calling the GetCertificate operation. You can retrieve the certificate if it is in the ISSUED state. You can call the CreateCertificateAuthorityAuditReport operation to create a report that contains information about all of the certificates issued and revoked by your private CA.

" - }, - "GetCertificateAuthorityCertificate":{ - "name":"GetCertificateAuthorityCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCertificateAuthorityCertificateRequest"}, - "output":{"shape":"GetCertificateAuthorityCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Retrieves the certificate and certificate chain for your private certificate authority (CA). Both the certificate and the chain are base64 PEM-encoded. The chain does not include the CA certificate. Each certificate in the chain signs the one before it.

" - }, - "GetCertificateAuthorityCsr":{ - "name":"GetCertificateAuthorityCsr", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCertificateAuthorityCsrRequest"}, - "output":{"shape":"GetCertificateAuthorityCsrResponse"}, - "errors":[ - {"shape":"RequestInProgressException"}, - {"shape":"RequestFailedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Retrieves the certificate signing request (CSR) for your private certificate authority (CA). The CSR is created when you call the CreateCertificateAuthority operation. Take the CSR to your on-premises X.509 infrastructure and sign it by using your root or a subordinate CA. Then import the signed certificate back into ACM PCA by calling the ImportCertificateAuthorityCertificate operation. The CSR is returned as a base64 PEM-encoded string.

" - }, - "ImportCertificateAuthorityCertificate":{ - "name":"ImportCertificateAuthorityCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportCertificateAuthorityCertificateRequest"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"RequestInProgressException"}, - {"shape":"RequestFailedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"}, - {"shape":"MalformedCertificateException"}, - {"shape":"CertificateMismatchException"} - ], - "documentation":"

Imports your signed private CA certificate into ACM PCA. Before you can call this operation, you must create the private certificate authority by calling the CreateCertificateAuthority operation. You must then generate a certificate signing request (CSR) by calling the GetCertificateAuthorityCsr operation. Take the CSR to your on-premises CA and use the root certificate or a subordinate certificate to sign it. Create a certificate chain and copy the signed certificate and the certificate chain to your working directory.

Your certificate chain must not include the private CA certificate that you are importing.

Your on-premises CA certificate must be the last certificate in your chain. The subordinate certificate, if any, that your root CA signed must be next to last. The subordinate certificate signed by the preceding subordinate CA must come next, and so on until your chain is built.

The chain must be PEM-encoded.

" - }, - "IssueCertificate":{ - "name":"IssueCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IssueCertificateRequest"}, - "output":{"shape":"IssueCertificateResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidArgsException"}, - {"shape":"MalformedCSRException"} - ], - "documentation":"

Uses your private certificate authority (CA) to issue a client certificate. This operation returns the Amazon Resource Name (ARN) of the certificate. You can retrieve the certificate by calling the GetCertificate operation and specifying the ARN.

You cannot use the ACM ListCertificateAuthorities operation to retrieve the ARNs of the certificates that you issue by using ACM PCA.

", - "idempotent":true - }, - "ListCertificateAuthorities":{ - "name":"ListCertificateAuthorities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCertificateAuthoritiesRequest"}, - "output":{"shape":"ListCertificateAuthoritiesResponse"}, - "errors":[ - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the private certificate authorities that you created by using the CreateCertificateAuthority operation.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Lists the tags, if any, that are associated with your private CA. Tags are labels that you can use to identify and organize your CAs. Each tag consists of a key and an optional value. Call the TagCertificateAuthority operation to add one or more tags to your CA. Call the UntagCertificateAuthority operation to remove tags.

" - }, - "RestoreCertificateAuthority":{ - "name":"RestoreCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreCertificateAuthorityRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Restores a certificate authority (CA) that is in the DELETED state. You can restore a CA during the period that you defined in the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthority operation. Currently, you can specify 7 to 30 days. If you did not specify a PermanentDeletionTimeInDays value, by default you can restore the CA at any time in a 30 day period. You can check the time remaining in the restoration period of a private CA in the DELETED state by calling the DescribeCertificateAuthority or ListCertificateAuthorities operations. The status of a restored CA is set to its pre-deletion status when the RestoreCertificateAuthority operation returns. To change its status to ACTIVE, call the UpdateCertificateAuthority operation. If the private CA was in the PENDING_CERTIFICATE state at deletion, you must use the ImportCertificateAuthorityCertificate operation to import a certificate authority into the private CA before it can be activated. You cannot restore a CA after the restoration period has ended.

" - }, - "RevokeCertificate":{ - "name":"RevokeCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeCertificateRequest"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"RequestAlreadyProcessedException"}, - {"shape":"RequestInProgressException"}, - {"shape":"RequestFailedException"} - ], - "documentation":"

Revokes a certificate that you issued by calling the IssueCertificate operation. If you enable a certificate revocation list (CRL) when you create or update your private CA, information about the revoked certificates will be included in the CRL. ACM PCA writes the CRL to an S3 bucket that you specify. For more information about revocation, see the CrlConfiguration structure. ACM PCA also writes revocation information to the audit report. For more information, see CreateCertificateAuthorityAuditReport.

" - }, - "TagCertificateAuthority":{ - "name":"TagCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagCertificateAuthorityRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidTagException"}, - {"shape":"TooManyTagsException"} - ], - "documentation":"

Adds one or more tags to your private CA. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. You specify the private CA on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair. You can apply a tag to just one private CA if you want to identify a specific characteristic of that CA, or you can apply the same tag to multiple private CAs if you want to filter for a common relationship among those CAs. To remove one or more tags, use the UntagCertificateAuthority operation. Call the ListTags operation to see what tags are associated with your CA.

" - }, - "UntagCertificateAuthority":{ - "name":"UntagCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagCertificateAuthorityRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidTagException"} - ], - "documentation":"

Remove one or more tags from your private CA. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this operation, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value. To add tags to a private CA, use the TagCertificateAuthority. Call the ListTags operation to see what tags are associated with your CA.

" - }, - "UpdateCertificateAuthority":{ - "name":"UpdateCertificateAuthority", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCertificateAuthorityRequest"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgsException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidPolicyException"} - ], - "documentation":"

Updates the status or configuration of a private certificate authority (CA). Your private CA must be in the ACTIVE or DISABLED state before you can update it. You can disable a private CA that is in the ACTIVE state or make a CA that is in the DISABLED state active again.

" - } - }, - "shapes":{ - "ASN1Subject":{ - "type":"structure", - "members":{ - "Country":{ - "shape":"CountryCodeString", - "documentation":"

Two-digit code that specifies the country in which the certificate subject located.

" - }, - "Organization":{ - "shape":"String64", - "documentation":"

Legal name of the organization with which the certificate subject is affiliated.

" - }, - "OrganizationalUnit":{ - "shape":"String64", - "documentation":"

A subdivision or unit of the organization (such as sales or finance) with which the certificate subject is affiliated.

" - }, - "DistinguishedNameQualifier":{ - "shape":"DistinguishedNameQualifierString", - "documentation":"

Disambiguating information for the certificate subject.

" - }, - "State":{ - "shape":"String128", - "documentation":"

State in which the subject of the certificate is located.

" - }, - "CommonName":{ - "shape":"String64", - "documentation":"

Fully qualified domain name (FQDN) associated with the certificate subject.

" - }, - "SerialNumber":{ - "shape":"String64", - "documentation":"

The certificate serial number.

" - }, - "Locality":{ - "shape":"String128", - "documentation":"

The locality (such as a city or town) in which the certificate subject is located.

" - }, - "Title":{ - "shape":"String64", - "documentation":"

A title such as Mr. or Ms., which is pre-pended to the name to refer formally to the certificate subject.

" - }, - "Surname":{ - "shape":"String40", - "documentation":"

Family name. In the US and the UK, for example, the surname of an individual is ordered last. In Asian cultures the surname is typically ordered first.

" - }, - "GivenName":{ - "shape":"String16", - "documentation":"

First name.

" - }, - "Initials":{ - "shape":"String5", - "documentation":"

Concatenation that typically contains the first letter of the GivenName, the first letter of the middle name if one exists, and the first letter of the SurName.

" - }, - "Pseudonym":{ - "shape":"String128", - "documentation":"

Typically a shortened version of a longer GivenName. For example, Jonathan is often shortened to John. Elizabeth is often shortened to Beth, Liz, or Eliza.

" - }, - "GenerationQualifier":{ - "shape":"String3", - "documentation":"

Typically a qualifier appended to the name of an individual. Examples include Jr. for junior, Sr. for senior, and III for third.

" - } - }, - "documentation":"

Contains information about the certificate subject. The certificate can be one issued by your private certificate authority (CA) or it can be your private CA certificate. The Subject field in the certificate identifies the entity that owns or controls the public key in the certificate. The entity can be a user, computer, device, or service. The Subject must contain an X.500 distinguished name (DN). A DN is a sequence of relative distinguished names (RDNs). The RDNs are separated by commas in the certificate. The DN must be unique for each entity, but your private CA can issue more than one certificate with the same DN to the same entity.

" - }, - "Arn":{ - "type":"string", - "max":200, - "min":5, - "pattern":"arn:[\\w+=/,.@-]+:[\\w+=/,.@-]+:[\\w+=/,.@-]*:[0-9]+:[\\w+=,.@-]+(/[\\w+=/,.@-]+)*" - }, - "AuditReportId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"[a-z0-9]{8}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{12}" - }, - "AuditReportResponseFormat":{ - "type":"string", - "enum":[ - "JSON", - "CSV" - ] - }, - "AuditReportStatus":{ - "type":"string", - "enum":[ - "CREATING", - "SUCCESS", - "FAILED" - ] - }, - "Boolean":{"type":"boolean"}, - "CertificateAuthorities":{ - "type":"list", - "member":{"shape":"CertificateAuthority"} - }, - "CertificateAuthority":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) for your private certificate authority (CA). The format is 12345678-1234-1234-1234-123456789012 .

" - }, - "CreatedAt":{ - "shape":"TStamp", - "documentation":"

Date and time at which your private CA was created.

" - }, - "LastStateChangeAt":{ - "shape":"TStamp", - "documentation":"

Date and time at which your private CA was last updated.

" - }, - "Type":{ - "shape":"CertificateAuthorityType", - "documentation":"

Type of your private CA.

" - }, - "Serial":{ - "shape":"String", - "documentation":"

Serial number of your private CA.

" - }, - "Status":{ - "shape":"CertificateAuthorityStatus", - "documentation":"

Status of your private CA.

" - }, - "NotBefore":{ - "shape":"TStamp", - "documentation":"

Date and time before which your private CA certificate is not valid.

" - }, - "NotAfter":{ - "shape":"TStamp", - "documentation":"

Date and time after which your private CA certificate is not valid.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

Reason the request to create your private CA failed.

" - }, - "CertificateAuthorityConfiguration":{ - "shape":"CertificateAuthorityConfiguration", - "documentation":"

Your private CA configuration.

" - }, - "RevocationConfiguration":{ - "shape":"RevocationConfiguration", - "documentation":"

Information about the certificate revocation list (CRL) created and maintained by your private CA.

" - }, - "RestorableUntil":{ - "shape":"TStamp", - "documentation":"

The period during which a deleted CA can be restored. For more information, see the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthorityRequest operation.

" - } - }, - "documentation":"

Contains information about your private certificate authority (CA). Your private CA can issue and revoke X.509 digital certificates. Digital certificates verify that the entity named in the certificate Subject field owns or controls the public key contained in the Subject Public Key Info field. Call the CreateCertificateAuthority operation to create your private CA. You must then call the GetCertificateAuthorityCertificate operation to retrieve a private CA certificate signing request (CSR). Take the CSR to your on-premises CA and sign it with the root CA certificate or a subordinate certificate. Call the ImportCertificateAuthorityCertificate operation to import the signed certificate into AWS Certificate Manager (ACM).

" - }, - "CertificateAuthorityConfiguration":{ - "type":"structure", - "required":[ - "KeyAlgorithm", - "SigningAlgorithm", - "Subject" - ], - "members":{ - "KeyAlgorithm":{ - "shape":"KeyAlgorithm", - "documentation":"

Type of the public key algorithm and size, in bits, of the key pair that your key pair creates when it issues a certificate.

" - }, - "SigningAlgorithm":{ - "shape":"SigningAlgorithm", - "documentation":"

Name of the algorithm your private CA uses to sign certificate requests.

" - }, - "Subject":{ - "shape":"ASN1Subject", - "documentation":"

Structure that contains X.500 distinguished name information for your private CA.

" - } - }, - "documentation":"

Contains configuration information for your private certificate authority (CA). This includes information about the class of public key algorithm and the key pair that your private CA creates when it issues a certificate, the signature algorithm it uses used when issuing certificates, and its X.500 distinguished name. You must specify this information when you call the CreateCertificateAuthority operation.

" - }, - "CertificateAuthorityStatus":{ - "type":"string", - "enum":[ - "CREATING", - "PENDING_CERTIFICATE", - "ACTIVE", - "DELETED", - "DISABLED", - "EXPIRED", - "FAILED" - ] - }, - "CertificateAuthorityType":{ - "type":"string", - "enum":["SUBORDINATE"] - }, - "CertificateBody":{"type":"string"}, - "CertificateBodyBlob":{ - "type":"blob", - "max":32768, - "min":1 - }, - "CertificateChain":{"type":"string"}, - "CertificateChainBlob":{ - "type":"blob", - "max":2097152, - "min":0 - }, - "CertificateMismatchException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The certificate authority certificate you are importing does not comply with conditions specified in the certificate that signed it.

", - "exception":true - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

A previous update to your private CA is still ongoing.

", - "exception":true - }, - "CountryCodeString":{ - "type":"string", - "pattern":"[A-Za-z]{2}" - }, - "CreateCertificateAuthorityAuditReportRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "S3BucketName", - "AuditReportResponseFormat" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) of the CA to be audited. This is of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Name of the S3 bucket that will contain the audit report.

" - }, - "AuditReportResponseFormat":{ - "shape":"AuditReportResponseFormat", - "documentation":"

Format in which to create the report. This can be either JSON or CSV.

" - } - } - }, - "CreateCertificateAuthorityAuditReportResponse":{ - "type":"structure", - "members":{ - "AuditReportId":{ - "shape":"AuditReportId", - "documentation":"

An alphanumeric string that contains a report identifier.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The key that uniquely identifies the report file in your S3 bucket.

" - } - } - }, - "CreateCertificateAuthorityRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityConfiguration", - "CertificateAuthorityType" - ], - "members":{ - "CertificateAuthorityConfiguration":{ - "shape":"CertificateAuthorityConfiguration", - "documentation":"

Name and bit size of the private key algorithm, the name of the signing algorithm, and X.500 certificate subject information.

" - }, - "RevocationConfiguration":{ - "shape":"RevocationConfiguration", - "documentation":"

Contains a Boolean value that you can use to enable a certification revocation list (CRL) for the CA, the name of the S3 bucket to which ACM PCA will write the CRL, and an optional CNAME alias that you can use to hide the name of your bucket in the CRL Distribution Points extension of your CA certificate. For more information, see the CrlConfiguration structure.

" - }, - "CertificateAuthorityType":{ - "shape":"CertificateAuthorityType", - "documentation":"

The type of the certificate authority. Currently, this must be SUBORDINATE.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

Alphanumeric string that can be used to distinguish between calls to CreateCertificateAuthority. Idempotency tokens time out after five minutes. Therefore, if you call CreateCertificateAuthority multiple times with the same idempotency token within a five minute period, ACM PCA recognizes that you are requesting only one certificate. As a result, ACM PCA issues only one. If you change the idempotency token for each call, however, ACM PCA recognizes that you are requesting multiple certificates.

" - } - } - }, - "CreateCertificateAuthorityResponse":{ - "type":"structure", - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

If successful, the Amazon Resource Name (ARN) of the certificate authority (CA). This is of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - } - } - }, - "CrlConfiguration":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Boolean value that specifies whether certificate revocation lists (CRLs) are enabled. You can use this value to enable certificate revocation for a new CA when you call the CreateCertificateAuthority operation or for an existing CA when you call the UpdateCertificateAuthority operation.

", - "box":true - }, - "ExpirationInDays":{ - "shape":"Integer1To5000", - "documentation":"

Number of days until a certificate expires.

", - "box":true - }, - "CustomCname":{ - "shape":"String253", - "documentation":"

Name inserted into the certificate CRL Distribution Points extension that enables the use of an alias for the CRL distribution point. Use this value if you don't want the name of your S3 bucket to be public.

" - }, - "S3BucketName":{ - "shape":"String3To255", - "documentation":"

Name of the S3 bucket that contains the CRL. If you do not provide a value for the CustomCname argument, the name of your S3 bucket is placed into the CRL Distribution Points extension of the issued certificate. You can change the name of your bucket by calling the UpdateCertificateAuthority operation. You must specify a bucket policy that allows ACM PCA to write the CRL to your bucket.

" - } - }, - "documentation":"

Contains configuration information for a certificate revocation list (CRL). Your private certificate authority (CA) creates base CRLs. Delta CRLs are not supported. You can enable CRLs for your new or an existing private CA by setting the Enabled parameter to true. Your private CA writes CRLs to an S3 bucket that you specify in the S3BucketName parameter. You can hide the name of your bucket by specifying a value for the CustomCname parameter. Your private CA copies the CNAME or the S3 bucket name to the CRL Distribution Points extension of each certificate it issues. Your S3 bucket policy must give write permission to ACM PCA.

Your private CA uses the value in the ExpirationInDays parameter to calculate the nextUpdate field in the CRL. The CRL is refreshed at 1/2 the age of next update or when a certificate is revoked. When a certificate is revoked, it is recorded in the next CRL that is generated and in the next audit report. Only time valid certificates are listed in the CRL. Expired certificates are not included.

CRLs contain the following fields:

  • Version: The current version number defined in RFC 5280 is V2. The integer value is 0x1.

  • Signature Algorithm: The name of the algorithm used to sign the CRL.

  • Issuer: The X.500 distinguished name of your private CA that issued the CRL.

  • Last Update: The issue date and time of this CRL.

  • Next Update: The day and time by which the next CRL will be issued.

  • Revoked Certificates: List of revoked certificates. Each list item contains the following information.

    • Serial Number: The serial number, in hexadecimal format, of the revoked certificate.

    • Revocation Date: Date and time the certificate was revoked.

    • CRL Entry Extensions: Optional extensions for the CRL entry.

      • X509v3 CRL Reason Code: Reason the certificate was revoked.

  • CRL Extensions: Optional extensions for the CRL.

    • X509v3 Authority Key Identifier: Identifies the public key associated with the private key used to sign the certificate.

    • X509v3 CRL Number:: Decimal sequence number for the CRL.

  • Signature Algorithm: Algorithm used by your private CA to sign the CRL.

  • Signature Value: Signature computed over the CRL.

Certificate revocation lists created by ACM PCA are DER-encoded. You can use the following OpenSSL command to list a CRL.

openssl crl -inform DER -text -in crl_path -noout

" - }, - "CsrBlob":{ - "type":"blob", - "max":32768, - "min":1 - }, - "CsrBody":{"type":"string"}, - "DeleteCertificateAuthorityRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must have the following form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - }, - "PermanentDeletionTimeInDays":{ - "shape":"PermanentDeletionTimeInDays", - "documentation":"

The number of days to make a CA restorable after it has been deleted. This can be anywhere from 7 to 30 days, with 30 being the default.

" - } - } - }, - "DescribeCertificateAuthorityAuditReportRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "AuditReportId" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the private CA. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - }, - "AuditReportId":{ - "shape":"AuditReportId", - "documentation":"

The report ID returned by calling the CreateCertificateAuthorityAuditReport operation.

" - } - } - }, - "DescribeCertificateAuthorityAuditReportResponse":{ - "type":"structure", - "members":{ - "AuditReportStatus":{ - "shape":"AuditReportStatus", - "documentation":"

Specifies whether report creation is in progress, has succeeded, or has failed.

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Name of the S3 bucket that contains the report.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

S3 key that uniquely identifies the report file in your S3 bucket.

" - }, - "CreatedAt":{ - "shape":"TStamp", - "documentation":"

The date and time at which the report was created.

" - } - } - }, - "DescribeCertificateAuthorityRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - } - } - }, - "DescribeCertificateAuthorityResponse":{ - "type":"structure", - "members":{ - "CertificateAuthority":{ - "shape":"CertificateAuthority", - "documentation":"

A CertificateAuthority structure that contains information about your private CA.

" - } - } - }, - "DistinguishedNameQualifierString":{ - "type":"string", - "max":64, - "min":0, - "pattern":"[a-zA-Z0-9'()+-.?:/= ]*" - }, - "FailureReason":{ - "type":"string", - "enum":[ - "REQUEST_TIMED_OUT", - "UNSUPPORTED_ALGORITHM", - "OTHER" - ] - }, - "GetCertificateAuthorityCertificateRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of your private CA. This is of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - } - } - }, - "GetCertificateAuthorityCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"CertificateBody", - "documentation":"

Base64-encoded certificate authority (CA) certificate.

" - }, - "CertificateChain":{ - "shape":"CertificateChain", - "documentation":"

Base64-encoded certificate chain that includes any intermediate certificates and chains up to root on-premises certificate that you used to sign your private CA certificate. The chain does not include your private CA certificate.

" - } - } - }, - "GetCertificateAuthorityCsrRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - } - } - }, - "GetCertificateAuthorityCsrResponse":{ - "type":"structure", - "members":{ - "Csr":{ - "shape":"CsrBody", - "documentation":"

The base64 PEM-encoded certificate signing request (CSR) for your private CA certificate.

" - } - } - }, - "GetCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "CertificateArn" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

" - }, - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The ARN of the issued certificate. The ARN contains the certificate serial number and must be in the following form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012/certificate/286535153982981100925020015808220737245

" - } - } - }, - "GetCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"CertificateBody", - "documentation":"

The base64 PEM-encoded certificate specified by the CertificateArn parameter.

" - }, - "CertificateChain":{ - "shape":"CertificateChain", - "documentation":"

The base64 PEM-encoded certificate chain that chains up to the on-premises root CA certificate that you used to sign your private CA certificate.

" - } - } - }, - "IdempotencyToken":{ - "type":"string", - "max":36, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]*" - }, - "ImportCertificateAuthorityCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "Certificate", - "CertificateChain" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "Certificate":{ - "shape":"CertificateBodyBlob", - "documentation":"

The PEM-encoded certificate for your private CA. This must be signed by using your on-premises CA.

" - }, - "CertificateChain":{ - "shape":"CertificateChainBlob", - "documentation":"

A PEM-encoded file that contains all of your certificates, other than the certificate you're importing, chaining up to your root CA. Your on-premises root certificate is the last in the chain, and each certificate in the chain signs the one preceding.

" - } - } - }, - "Integer1To5000":{ - "type":"integer", - "max":5000, - "min":1 - }, - "InvalidArgsException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

One or more of the specified arguments was not valid.

", - "exception":true - }, - "InvalidArnException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The requested Amazon Resource Name (ARN) does not refer to an existing resource.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The token specified in the NextToken argument is not valid. Use the token returned from your previous call to ListCertificateAuthorities.

", - "exception":true - }, - "InvalidPolicyException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The S3 bucket policy is not valid. The policy must give ACM PCA rights to read from and write to the bucket and find the bucket location.

", - "exception":true - }, - "InvalidStateException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The private CA is in a state during which a report cannot be generated.

", - "exception":true - }, - "InvalidTagException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The tag associated with the CA is not valid. The invalid argument is contained in the message field.

", - "exception":true - }, - "IssueCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "Csr", - "SigningAlgorithm", - "Validity" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "Csr":{ - "shape":"CsrBlob", - "documentation":"

The certificate signing request (CSR) for the certificate you want to issue. You can use the following OpenSSL command to create the CSR and a 2048 bit RSA private key.

openssl req -new -newkey rsa:2048 -days 365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

If you have a configuration file, you can use the following OpenSSL command. The usr_cert block in the configuration file contains your X509 version 3 extensions.

openssl req -new -config openssl_rsa.cnf -extensions usr_cert -newkey rsa:2048 -days -365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

" - }, - "SigningAlgorithm":{ - "shape":"SigningAlgorithm", - "documentation":"

The name of the algorithm that will be used to sign the certificate to be issued.

" - }, - "Validity":{ - "shape":"Validity", - "documentation":"

The type of the validity period.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

Custom string that can be used to distinguish between calls to the IssueCertificate operation. Idempotency tokens time out after one hour. Therefore, if you call IssueCertificate multiple times with the same idempotency token within 5 minutes, ACM PCA recognizes that you are requesting only one certificate and will issue only one. If you change the idempotency token for each call, PCA recognizes that you are requesting multiple certificates.

" - } - } - }, - "IssueCertificateResponse":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the issued certificate and the certificate serial number. This is of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012/certificate/286535153982981100925020015808220737245

" - } - } - }, - "KeyAlgorithm":{ - "type":"string", - "enum":[ - "RSA_2048", - "RSA_4096", - "EC_prime256v1", - "EC_secp384r1" - ] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

An ACM PCA limit has been exceeded. See the exception message returned to determine the limit that was exceeded.

", - "exception":true - }, - "ListCertificateAuthoritiesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of the NextToken parameter from the response you just received.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Use this parameter when paginating results to specify the maximum number of items to return in the response on each page. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

" - } - } - }, - "ListCertificateAuthoritiesResponse":{ - "type":"structure", - "members":{ - "CertificateAuthorities":{ - "shape":"CertificateAuthorities", - "documentation":"

Summary information about each certificate authority you have created.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the list is truncated, this value is present and should be used for the NextToken parameter in a subsequent pagination request.

" - } - } - }, - "ListTagsRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

" - } - } - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The tags associated with your private CA.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the list is truncated, this value is present and should be used for the NextToken parameter in a subsequent pagination request.

" - } - } - }, - "MalformedCSRException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The certificate signing request is invalid.

", - "exception":true - }, - "MalformedCertificateException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

One or more fields in the certificate are invalid.

", - "exception":true - }, - "MaxResults":{ - "type":"integer", - "max":1000, - "min":1 - }, - "NextToken":{ - "type":"string", - "max":500, - "min":1 - }, - "PermanentDeletionTimeInDays":{ - "type":"integer", - "max":30, - "min":7 - }, - "PositiveLong":{ - "type":"long", - "min":1 - }, - "RequestAlreadyProcessedException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Your request has already been completed.

", - "exception":true - }, - "RequestFailedException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request has failed for an unspecified reason.

", - "exception":true - }, - "RequestInProgressException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Your request is already in progress.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

A resource such as a private CA, S3 bucket, certificate, or audit report cannot be found.

", - "exception":true - }, - "RestoreCertificateAuthorityRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - } - } - }, - "RevocationConfiguration":{ - "type":"structure", - "members":{ - "CrlConfiguration":{ - "shape":"CrlConfiguration", - "documentation":"

Configuration of the certificate revocation list (CRL), if any, maintained by your private CA.

" - } - }, - "documentation":"

Certificate revocation information used by the CreateCertificateAuthority and UpdateCertificateAuthority operations. Your private certificate authority (CA) can create and maintain a certificate revocation list (CRL). A CRL contains information about certificates revoked by your CA. For more information, see RevokeCertificate.

" - }, - "RevocationReason":{ - "type":"string", - "enum":[ - "UNSPECIFIED", - "KEY_COMPROMISE", - "CERTIFICATE_AUTHORITY_COMPROMISE", - "AFFILIATION_CHANGED", - "SUPERSEDED", - "CESSATION_OF_OPERATION", - "PRIVILEGE_WITHDRAWN", - "A_A_COMPROMISE" - ] - }, - "RevokeCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "CertificateSerial", - "RevocationReason" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) of the private CA that issued the certificate to be revoked. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "CertificateSerial":{ - "shape":"String128", - "documentation":"

Serial number of the certificate to be revoked. This must be in hexadecimal format. You can retrieve the serial number by calling GetCertificate with the Amazon Resource Name (ARN) of the certificate you want and the ARN of your private CA. The GetCertificate operation retrieves the certificate in the PEM format. You can use the following OpenSSL command to list the certificate in text format and copy the hexadecimal serial number.

openssl x509 -in file_path -text -noout

You can also copy the serial number from the console or use the DescribeCertificate operation in the AWS Certificate Manager API Reference.

" - }, - "RevocationReason":{ - "shape":"RevocationReason", - "documentation":"

Specifies why you revoked the certificate.

" - } - } - }, - "SigningAlgorithm":{ - "type":"string", - "enum":[ - "SHA256WITHECDSA", - "SHA384WITHECDSA", - "SHA512WITHECDSA", - "SHA256WITHRSA", - "SHA384WITHRSA", - "SHA512WITHRSA" - ] - }, - "String":{"type":"string"}, - "String128":{ - "type":"string", - "max":128, - "min":0 - }, - "String16":{ - "type":"string", - "max":16, - "min":0 - }, - "String253":{ - "type":"string", - "max":253, - "min":0 - }, - "String3":{ - "type":"string", - "max":3, - "min":0 - }, - "String3To255":{ - "type":"string", - "max":255, - "min":3 - }, - "String40":{ - "type":"string", - "max":40, - "min":0 - }, - "String5":{ - "type":"string", - "max":5, - "min":0 - }, - "String64":{ - "type":"string", - "max":64, - "min":0 - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

Key (name) of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

Value of the tag.

" - } - }, - "documentation":"

Tags are labels that you can use to identify and organize your private CAs. Each tag consists of a key and an optional value. You can associate up to 50 tags with a private CA. To add one or more tags to a private CA, call the TagCertificateAuthority operation. To remove a tag, call the UntagCertificateAuthority operation.

" - }, - "TagCertificateAuthorityRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "Tags" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

List of tags to be associated with the CA.

" - } - } - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

You can associate up to 50 tags with a private CA. Exception information is contained in the exception message field.

", - "exception":true - }, - "UntagCertificateAuthorityRequest":{ - "type":"structure", - "required":[ - "CertificateAuthorityArn", - "Tags" - ], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

List of tags to be removed from the CA.

" - } - } - }, - "UpdateCertificateAuthorityRequest":{ - "type":"structure", - "required":["CertificateAuthorityArn"], - "members":{ - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) of the private CA that issued the certificate to be revoked. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "RevocationConfiguration":{ - "shape":"RevocationConfiguration", - "documentation":"

Revocation information for your private CA.

" - }, - "Status":{ - "shape":"CertificateAuthorityStatus", - "documentation":"

Status of your private CA.

" - } - } - }, - "Validity":{ - "type":"structure", - "required":[ - "Value", - "Type" - ], - "members":{ - "Value":{ - "shape":"PositiveLong", - "documentation":"

Time period.

", - "box":true - }, - "Type":{ - "shape":"ValidityPeriodType", - "documentation":"

Specifies whether the Value parameter represents days, months, or years.

" - } - }, - "documentation":"

Length of time for which the certificate issued by your private certificate authority (CA), or by the private CA itself, is valid in days, months, or years. You can issue a certificate by calling the IssueCertificate operation.

" - }, - "ValidityPeriodType":{ - "type":"string", - "enum":[ - "END_DATE", - "ABSOLUTE", - "DAYS", - "MONTHS", - "YEARS" - ] - } - }, - "documentation":"

You can use the ACM PCA API to create a private certificate authority (CA). You must first call the CreateCertificateAuthority operation. If successful, the operation returns an Amazon Resource Name (ARN) for your private CA. Use this ARN as input to the GetCertificateAuthorityCsr operation to retrieve the certificate signing request (CSR) for your private CA certificate. Sign the CSR using the root or an intermediate CA in your on-premises PKI hierarchy, and call the ImportCertificateAuthorityCertificate to import your signed private CA certificate into ACM PCA.

Use your private CA to issue and revoke certificates. These are private certificates that identify and secure client computers, servers, applications, services, devices, and users over SSLS/TLS connections within your organization. Call the IssueCertificate operation to issue a certificate. Call the RevokeCertificate operation to revoke a certificate.

Certificates issued by your private CA can be trusted only within your organization, not publicly.

Your private CA can optionally create a certificate revocation list (CRL) to track the certificates you revoke. To create a CRL, you must specify a RevocationConfiguration object when you call the CreateCertificateAuthority operation. ACM PCA writes the CRL to an S3 bucket that you specify. You must specify a bucket policy that grants ACM PCA write permission.

You can also call the CreateCertificateAuthorityAuditReport to create an optional audit report that lists every time the CA private key is used. The private key is used for signing when the IssueCertificate or RevokeCertificate operation is called.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/paginators-1.json deleted file mode 100644 index 2e2e4f9a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "ListCertificates": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxItems", - "result_key": "CertificateSummaryList" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/service-2.json deleted file mode 100644 index 5845ed9e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/service-2.json +++ /dev/null @@ -1,1114 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-12-08", - "endpointPrefix":"acm", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"ACM", - "serviceFullName":"AWS Certificate Manager", - "serviceId":"ACM", - "signatureVersion":"v4", - "targetPrefix":"CertificateManager", - "uid":"acm-2015-12-08" - }, - "operations":{ - "AddTagsToCertificate":{ - "name":"AddTagsToCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToCertificateRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidTagException"}, - {"shape":"TooManyTagsException"} - ], - "documentation":"

Adds one or more tags to an ACM certificate. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. You specify the certificate on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair.

You can apply a tag to just one certificate if you want to identify a specific characteristic of that certificate, or you can apply the same tag to multiple certificates if you want to filter for a common relationship among those certificates. Similarly, you can apply the same tag to multiple resources if you want to specify a relationship among those resources. For example, you can add the same tag to an ACM certificate and an Elastic Load Balancing load balancer to indicate that they are both used by the same website. For more information, see Tagging ACM certificates.

To remove one or more tags, use the RemoveTagsFromCertificate action. To view all of the tags that have been applied to the certificate, use the ListTagsForCertificate action.

" - }, - "DeleteCertificate":{ - "name":"DeleteCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCertificateRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Deletes a certificate and its associated private key. If this action succeeds, the certificate no longer appears in the list that can be displayed by calling the ListCertificates action or be retrieved by calling the GetCertificate action. The certificate will not be available for use by AWS services integrated with ACM.

You cannot delete an ACM certificate that is being used by another AWS service. To delete a certificate that is in use, the certificate association must first be removed.

" - }, - "DescribeCertificate":{ - "name":"DescribeCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCertificateRequest"}, - "output":{"shape":"DescribeCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Returns detailed metadata about the specified ACM certificate.

" - }, - "ExportCertificate":{ - "name":"ExportCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExportCertificateRequest"}, - "output":{"shape":"ExportCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"RequestInProgressException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Exports a private certificate issued by a private certificate authority (CA) for use anywhere. You can export the certificate, the certificate chain, and the encrypted private key associated with the public key embedded in the certificate. You must store the private key securely. The private key is a 2048 bit RSA key. You must provide a passphrase for the private key when exporting it. You can use the following OpenSSL command to decrypt it later. Provide the passphrase when prompted.

openssl rsa -in encrypted_key.pem -out decrypted_key.pem

" - }, - "GetCertificate":{ - "name":"GetCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCertificateRequest"}, - "output":{"shape":"GetCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"RequestInProgressException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Retrieves a certificate specified by an ARN and its certificate chain . The chain is an ordered list of certificates that contains the end entity certificate, intermediate certificates of subordinate CAs, and the root certificate in that order. The certificate and certificate chain are base64 encoded. If you want to decode the certificate to see the individual fields, you can use OpenSSL.

" - }, - "ImportCertificate":{ - "name":"ImportCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportCertificateRequest"}, - "output":{"shape":"ImportCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Imports a certificate into AWS Certificate Manager (ACM) to use with services that are integrated with ACM. Note that integrated services allow only certificate types and keys they support to be associated with their resources. Further, their support differs depending on whether the certificate is imported into IAM or into ACM. For more information, see the documentation for each service. For more information about importing certificates into ACM, see Importing Certificates in the AWS Certificate Manager User Guide.

ACM does not provide managed renewal for certificates that you import.

Note the following guidelines when importing third party certificates:

  • You must enter the private key that matches the certificate you are importing.

  • The private key must be unencrypted. You cannot import a private key that is protected by a password or a passphrase.

  • If the certificate you are importing is not self-signed, you must enter its certificate chain.

  • If a certificate chain is included, the issuer must be the subject of one of the certificates in the chain.

  • The certificate, private key, and certificate chain must be PEM-encoded.

  • The current time must be between the Not Before and Not After certificate fields.

  • The Issuer field must not be empty.

  • The OCSP authority URL, if present, must not exceed 1000 characters.

  • To import a new certificate, omit the CertificateArn argument. Include this argument only when you want to replace a previously imported certificate.

  • When you import a certificate by using the CLI, you must specify the certificate, the certificate chain, and the private key by their file names preceded by file://. For example, you can specify a certificate saved in the C:\\temp folder as file://C:\\temp\\certificate_to_import.pem. If you are making an HTTP or HTTPS Query request, include these arguments as BLOBs.

  • When you import a certificate by using an SDK, you must specify the certificate, the certificate chain, and the private key files in the manner required by the programming language you're using.

This operation returns the Amazon Resource Name (ARN) of the imported certificate.

" - }, - "ListCertificates":{ - "name":"ListCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCertificatesRequest"}, - "output":{"shape":"ListCertificatesResponse"}, - "documentation":"

Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate.

" - }, - "ListTagsForCertificate":{ - "name":"ListTagsForCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForCertificateRequest"}, - "output":{"shape":"ListTagsForCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Lists the tags that have been applied to the ACM certificate. Use the certificate's Amazon Resource Name (ARN) to specify the certificate. To add a tag to an ACM certificate, use the AddTagsToCertificate action. To delete a tag, use the RemoveTagsFromCertificate action.

" - }, - "RemoveTagsFromCertificate":{ - "name":"RemoveTagsFromCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromCertificateRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidTagException"} - ], - "documentation":"

Remove one or more tags from an ACM certificate. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this function, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value.

To add tags to a certificate, use the AddTagsToCertificate action. To view all of the tags that have been applied to a specific ACM certificate, use the ListTagsForCertificate action.

" - }, - "RequestCertificate":{ - "name":"RequestCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestCertificateRequest"}, - "output":{"shape":"RequestCertificateResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidDomainValidationOptionsException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Requests an ACM certificate for use with other AWS services. To request an ACM certificate, you must specify a fully qualified domain name (FQDN) in the DomainName parameter. You can also specify additional FQDNs in the SubjectAlternativeNames parameter.

If you are requesting a private certificate, domain validation is not required. If you are requesting a public certificate, each domain name that you specify must be validated to verify that you own or control the domain. You can use DNS validation or email validation. We recommend that you use DNS validation. ACM issues public certificates after receiving approval from the domain owner.

" - }, - "ResendValidationEmail":{ - "name":"ResendValidationEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResendValidationEmailRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidDomainValidationOptionsException"} - ], - "documentation":"

Resends the email that requests domain ownership validation. The domain owner or an authorized representative must approve the ACM certificate before it can be issued. The certificate can be approved by clicking a link in the mail to navigate to the Amazon certificate approval website and then clicking I Approve. However, the validation email can be blocked by spam filters. Therefore, if you do not receive the original mail, you can request that the mail be resent within 72 hours of requesting the ACM certificate. If more than 72 hours have elapsed since your original request or since your last attempt to resend validation mail, you must request a new certificate. For more information about setting up your contact email addresses, see Configure Email for your Domain.

" - }, - "UpdateCertificateOptions":{ - "name":"UpdateCertificateOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCertificateOptionsRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidStateException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Updates a certificate. Currently, you can use this function to specify whether to opt in to or out of recording your certificate in a certificate transparency log. For more information, see Opting Out of Certificate Transparency Logging.

" - } - }, - "shapes":{ - "AddTagsToCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateArn", - "Tags" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the ACM certificate to which the tag is to be applied. This must be of the form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The key-value pair that defines the tag. The tag value is optional.

" - } - } - }, - "Arn":{ - "type":"string", - "max":2048, - "min":20, - "pattern":"arn:[\\w+=/,.@-]+:[\\w+=/,.@-]+:[\\w+=/,.@-]*:[0-9]+:[\\w+=,.@-]+(/[\\w+=,.@-]+)*" - }, - "CertificateBody":{ - "type":"string", - "max":32768, - "min":1, - "pattern":"-{5}BEGIN CERTIFICATE-{5}\\u000D?\\u000A([A-Za-z0-9/+]{64}\\u000D?\\u000A)*[A-Za-z0-9/+]{1,64}={0,2}\\u000D?\\u000A-{5}END CERTIFICATE-{5}(\\u000D?\\u000A)?" - }, - "CertificateBodyBlob":{ - "type":"blob", - "max":32768, - "min":1 - }, - "CertificateChain":{ - "type":"string", - "max":2097152, - "min":1, - "pattern":"(-{5}BEGIN CERTIFICATE-{5}\\u000D?\\u000A([A-Za-z0-9/+]{64}\\u000D?\\u000A)*[A-Za-z0-9/+]{1,64}={0,2}\\u000D?\\u000A-{5}END CERTIFICATE-{5}\\u000D?\\u000A)*-{5}BEGIN CERTIFICATE-{5}\\u000D?\\u000A([A-Za-z0-9/+]{64}\\u000D?\\u000A)*[A-Za-z0-9/+]{1,64}={0,2}\\u000D?\\u000A-{5}END CERTIFICATE-{5}(\\u000D?\\u000A)?" - }, - "CertificateChainBlob":{ - "type":"blob", - "max":2097152, - "min":1 - }, - "CertificateDetail":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the certificate. For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "DomainName":{ - "shape":"DomainNameString", - "documentation":"

The fully qualified domain name for the certificate, such as www.example.com or example.com.

" - }, - "SubjectAlternativeNames":{ - "shape":"DomainList", - "documentation":"

One or more domain names (subject alternative names) included in the certificate. This list contains the domain names that are bound to the public key that is contained in the certificate. The subject alternative names include the canonical domain name (CN) of the certificate and additional domain names that can be used to connect to the website.

" - }, - "DomainValidationOptions":{ - "shape":"DomainValidationList", - "documentation":"

Contains information about the initial validation of each domain name that occurs as a result of the RequestCertificate request. This field exists only when the certificate type is AMAZON_ISSUED.

" - }, - "Serial":{ - "shape":"String", - "documentation":"

The serial number of the certificate.

" - }, - "Subject":{ - "shape":"String", - "documentation":"

The name of the entity that is associated with the public key contained in the certificate.

" - }, - "Issuer":{ - "shape":"String", - "documentation":"

The name of the certificate authority that issued and signed the certificate.

" - }, - "CreatedAt":{ - "shape":"TStamp", - "documentation":"

The time at which the certificate was requested. This value exists only when the certificate type is AMAZON_ISSUED.

" - }, - "IssuedAt":{ - "shape":"TStamp", - "documentation":"

The time at which the certificate was issued. This value exists only when the certificate type is AMAZON_ISSUED.

" - }, - "ImportedAt":{ - "shape":"TStamp", - "documentation":"

The date and time at which the certificate was imported. This value exists only when the certificate type is IMPORTED.

" - }, - "Status":{ - "shape":"CertificateStatus", - "documentation":"

The status of the certificate.

" - }, - "RevokedAt":{ - "shape":"TStamp", - "documentation":"

The time at which the certificate was revoked. This value exists only when the certificate status is REVOKED.

" - }, - "RevocationReason":{ - "shape":"RevocationReason", - "documentation":"

The reason the certificate was revoked. This value exists only when the certificate status is REVOKED.

" - }, - "NotBefore":{ - "shape":"TStamp", - "documentation":"

The time before which the certificate is not valid.

" - }, - "NotAfter":{ - "shape":"TStamp", - "documentation":"

The time after which the certificate is not valid.

" - }, - "KeyAlgorithm":{ - "shape":"KeyAlgorithm", - "documentation":"

The algorithm that was used to generate the public-private key pair.

" - }, - "SignatureAlgorithm":{ - "shape":"String", - "documentation":"

The algorithm that was used to sign the certificate.

" - }, - "InUseBy":{ - "shape":"InUseList", - "documentation":"

A list of ARNs for the AWS resources that are using the certificate. A certificate can be used by multiple AWS resources.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

The reason the certificate request failed. This value exists only when the certificate status is FAILED. For more information, see Certificate Request Failed in the AWS Certificate Manager User Guide.

" - }, - "Type":{ - "shape":"CertificateType", - "documentation":"

The source of the certificate. For certificates provided by ACM, this value is AMAZON_ISSUED. For certificates that you imported with ImportCertificate, this value is IMPORTED. ACM does not provide managed renewal for imported certificates. For more information about the differences between certificates that you import and those that ACM provides, see Importing Certificates in the AWS Certificate Manager User Guide.

" - }, - "RenewalSummary":{ - "shape":"RenewalSummary", - "documentation":"

Contains information about the status of ACM's managed renewal for the certificate. This field exists only when the certificate type is AMAZON_ISSUED.

" - }, - "KeyUsages":{ - "shape":"KeyUsageList", - "documentation":"

A list of Key Usage X.509 v3 extension objects. Each object is a string value that identifies the purpose of the public key contained in the certificate. Possible extension values include DIGITAL_SIGNATURE, KEY_ENCHIPHERMENT, NON_REPUDIATION, and more.

" - }, - "ExtendedKeyUsages":{ - "shape":"ExtendedKeyUsageList", - "documentation":"

Contains a list of Extended Key Usage X.509 v3 extension objects. Each object specifies a purpose for which the certificate public key can be used and consists of a name and an object identifier (OID).

" - }, - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the ACM PCA private certificate authority (CA) that issued the certificate. This has the following format:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - }, - "RenewalEligibility":{ - "shape":"RenewalEligibility", - "documentation":"

Specifies whether the certificate is eligible for renewal.

" - }, - "Options":{ - "shape":"CertificateOptions", - "documentation":"

Value that specifies whether to add the certificate to a transparency log. Certificate transparency makes it possible to detect SSL certificates that have been mistakenly or maliciously issued. A browser might respond to certificate that has not been logged by showing an error message. The logs are cryptographically secure.

" - } - }, - "documentation":"

Contains metadata about an ACM certificate. This structure is returned in the response to a DescribeCertificate request.

" - }, - "CertificateOptions":{ - "type":"structure", - "members":{ - "CertificateTransparencyLoggingPreference":{ - "shape":"CertificateTransparencyLoggingPreference", - "documentation":"

You can opt out of certificate transparency logging by specifying the DISABLED option. Opt in by specifying ENABLED.

" - } - }, - "documentation":"

Structure that contains options for your certificate. Currently, you can use this only to specify whether to opt in to or out of certificate transparency logging. Some browsers require that public certificates issued for your domain be recorded in a log. Certificates that are not logged typically generate a browser error. Transparency makes it possible for you to detect SSL/TLS certificates that have been mistakenly or maliciously issued for your domain. For general information, see Certificate Transparency Logging.

" - }, - "CertificateStatus":{ - "type":"string", - "enum":[ - "PENDING_VALIDATION", - "ISSUED", - "INACTIVE", - "EXPIRED", - "VALIDATION_TIMED_OUT", - "REVOKED", - "FAILED" - ] - }, - "CertificateStatuses":{ - "type":"list", - "member":{"shape":"CertificateStatus"} - }, - "CertificateSummary":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) of the certificate. This is of the form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "DomainName":{ - "shape":"DomainNameString", - "documentation":"

Fully qualified domain name (FQDN), such as www.example.com or example.com, for the certificate.

" - } - }, - "documentation":"

This structure is returned in the response object of ListCertificates action.

" - }, - "CertificateSummaryList":{ - "type":"list", - "member":{"shape":"CertificateSummary"} - }, - "CertificateTransparencyLoggingPreference":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "CertificateType":{ - "type":"string", - "enum":[ - "IMPORTED", - "AMAZON_ISSUED", - "PRIVATE" - ] - }, - "DeleteCertificateRequest":{ - "type":"structure", - "required":["CertificateArn"], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the ACM certificate to be deleted. This must be of the form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - } - }, - "DescribeCertificateRequest":{ - "type":"structure", - "required":["CertificateArn"], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the ACM certificate. The ARN must have the following form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - } - }, - "DescribeCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"CertificateDetail", - "documentation":"

Metadata about an ACM certificate.

" - } - } - }, - "DomainList":{ - "type":"list", - "member":{"shape":"DomainNameString"}, - "max":100, - "min":1 - }, - "DomainNameString":{ - "type":"string", - "max":253, - "min":1, - "pattern":"^(\\*\\.)?(((?!-)[A-Za-z0-9-]{0,62}[A-Za-z0-9])\\.)+((?!-)[A-Za-z0-9-]{1,62}[A-Za-z0-9])$" - }, - "DomainStatus":{ - "type":"string", - "enum":[ - "PENDING_VALIDATION", - "SUCCESS", - "FAILED" - ] - }, - "DomainValidation":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainNameString", - "documentation":"

A fully qualified domain name (FQDN) in the certificate. For example, www.example.com or example.com.

" - }, - "ValidationEmails":{ - "shape":"ValidationEmailList", - "documentation":"

A list of email addresses that ACM used to send domain validation emails.

" - }, - "ValidationDomain":{ - "shape":"DomainNameString", - "documentation":"

The domain name that ACM used to send domain validation emails.

" - }, - "ValidationStatus":{ - "shape":"DomainStatus", - "documentation":"

The validation status of the domain name. This can be one of the following values:

  • PENDING_VALIDATION

  • SUCCESS

  • FAILED

" - }, - "ResourceRecord":{ - "shape":"ResourceRecord", - "documentation":"

Contains the CNAME record that you add to your DNS database for domain validation. For more information, see Use DNS to Validate Domain Ownership.

" - }, - "ValidationMethod":{ - "shape":"ValidationMethod", - "documentation":"

Specifies the domain validation method.

" - } - }, - "documentation":"

Contains information about the validation of each domain name in the certificate.

" - }, - "DomainValidationList":{ - "type":"list", - "member":{"shape":"DomainValidation"}, - "max":1000, - "min":1 - }, - "DomainValidationOption":{ - "type":"structure", - "required":[ - "DomainName", - "ValidationDomain" - ], - "members":{ - "DomainName":{ - "shape":"DomainNameString", - "documentation":"

A fully qualified domain name (FQDN) in the certificate request.

" - }, - "ValidationDomain":{ - "shape":"DomainNameString", - "documentation":"

The domain name that you want ACM to use to send you validation emails. This domain name is the suffix of the email addresses that you want ACM to use. This must be the same as the DomainName value or a superdomain of the DomainName value. For example, if you request a certificate for testing.example.com, you can specify example.com for this value. In that case, ACM sends domain validation emails to the following five addresses:

  • admin@example.com

  • administrator@example.com

  • hostmaster@example.com

  • postmaster@example.com

  • webmaster@example.com

" - } - }, - "documentation":"

Contains information about the domain names that you want ACM to use to send you emails that enable you to validate domain ownership.

" - }, - "DomainValidationOptionList":{ - "type":"list", - "member":{"shape":"DomainValidationOption"}, - "max":100, - "min":1 - }, - "ExportCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateArn", - "Passphrase" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

An Amazon Resource Name (ARN) of the issued certificate. This must be of the form:

arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012

" - }, - "Passphrase":{ - "shape":"PassphraseBlob", - "documentation":"

Passphrase to associate with the encrypted exported private key. If you want to later decrypt the private key, you must have the passphrase. You can use the following OpenSSL command to decrypt a private key:

openssl rsa -in encrypted_key.pem -out decrypted_key.pem

" - } - } - }, - "ExportCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"CertificateBody", - "documentation":"

The base64 PEM-encoded certificate.

" - }, - "CertificateChain":{ - "shape":"CertificateChain", - "documentation":"

The base64 PEM-encoded certificate chain. This does not include the certificate that you are exporting.

" - }, - "PrivateKey":{ - "shape":"PrivateKey", - "documentation":"

The PEM-encoded private key associated with the public key in the certificate.

" - } - } - }, - "ExtendedKeyUsage":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ExtendedKeyUsageName", - "documentation":"

The name of an Extended Key Usage value.

" - }, - "OID":{ - "shape":"String", - "documentation":"

An object identifier (OID) for the extension value. OIDs are strings of numbers separated by periods. The following OIDs are defined in RFC 3280 and RFC 5280.

  • 1.3.6.1.5.5.7.3.1 (TLS_WEB_SERVER_AUTHENTICATION)

  • 1.3.6.1.5.5.7.3.2 (TLS_WEB_CLIENT_AUTHENTICATION)

  • 1.3.6.1.5.5.7.3.3 (CODE_SIGNING)

  • 1.3.6.1.5.5.7.3.4 (EMAIL_PROTECTION)

  • 1.3.6.1.5.5.7.3.8 (TIME_STAMPING)

  • 1.3.6.1.5.5.7.3.9 (OCSP_SIGNING)

  • 1.3.6.1.5.5.7.3.5 (IPSEC_END_SYSTEM)

  • 1.3.6.1.5.5.7.3.6 (IPSEC_TUNNEL)

  • 1.3.6.1.5.5.7.3.7 (IPSEC_USER)

" - } - }, - "documentation":"

The Extended Key Usage X.509 v3 extension defines one or more purposes for which the public key can be used. This is in addition to or in place of the basic purposes specified by the Key Usage extension.

" - }, - "ExtendedKeyUsageFilterList":{ - "type":"list", - "member":{"shape":"ExtendedKeyUsageName"} - }, - "ExtendedKeyUsageList":{ - "type":"list", - "member":{"shape":"ExtendedKeyUsage"} - }, - "ExtendedKeyUsageName":{ - "type":"string", - "enum":[ - "TLS_WEB_SERVER_AUTHENTICATION", - "TLS_WEB_CLIENT_AUTHENTICATION", - "CODE_SIGNING", - "EMAIL_PROTECTION", - "TIME_STAMPING", - "OCSP_SIGNING", - "IPSEC_END_SYSTEM", - "IPSEC_TUNNEL", - "IPSEC_USER", - "ANY", - "NONE", - "CUSTOM" - ] - }, - "FailureReason":{ - "type":"string", - "enum":[ - "NO_AVAILABLE_CONTACTS", - "ADDITIONAL_VERIFICATION_REQUIRED", - "DOMAIN_NOT_ALLOWED", - "INVALID_PUBLIC_DOMAIN", - "CAA_ERROR", - "PCA_LIMIT_EXCEEDED", - "PCA_INVALID_ARN", - "PCA_INVALID_STATE", - "PCA_REQUEST_FAILED", - "PCA_RESOURCE_NOT_FOUND", - "PCA_INVALID_ARGS", - "OTHER" - ] - }, - "Filters":{ - "type":"structure", - "members":{ - "extendedKeyUsage":{ - "shape":"ExtendedKeyUsageFilterList", - "documentation":"

Specify one or more ExtendedKeyUsage extension values.

" - }, - "keyUsage":{ - "shape":"KeyUsageFilterList", - "documentation":"

Specify one or more KeyUsage extension values.

" - }, - "keyTypes":{ - "shape":"KeyAlgorithmList", - "documentation":"

Specify one or more algorithms that can be used to generate key pairs.

" - } - }, - "documentation":"

This structure can be used in the ListCertificates action to filter the output of the certificate list.

" - }, - "GetCertificateRequest":{ - "type":"structure", - "required":["CertificateArn"], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains a certificate ARN in the following format:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - } - }, - "GetCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"CertificateBody", - "documentation":"

String that contains the ACM certificate represented by the ARN specified at input.

" - }, - "CertificateChain":{ - "shape":"CertificateChain", - "documentation":"

The certificate chain that contains the root certificate issued by the certificate authority (CA).

" - } - } - }, - "IdempotencyToken":{ - "type":"string", - "max":32, - "min":1, - "pattern":"\\w+" - }, - "ImportCertificateRequest":{ - "type":"structure", - "required":[ - "Certificate", - "PrivateKey" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of an imported certificate to replace. To import a new certificate, omit this field.

" - }, - "Certificate":{ - "shape":"CertificateBodyBlob", - "documentation":"

The certificate to import.

" - }, - "PrivateKey":{ - "shape":"PrivateKeyBlob", - "documentation":"

The private key that matches the public key in the certificate.

" - }, - "CertificateChain":{ - "shape":"CertificateChainBlob", - "documentation":"

The PEM encoded certificate chain.

" - } - } - }, - "ImportCertificateResponse":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the imported certificate.

" - } - } - }, - "InUseList":{ - "type":"list", - "member":{"shape":"String"} - }, - "InvalidArnException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The requested Amazon Resource Name (ARN) does not refer to an existing resource.

", - "exception":true - }, - "InvalidDomainValidationOptionsException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

One or more values in the DomainValidationOption structure is incorrect.

", - "exception":true - }, - "InvalidStateException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Processing has reached an invalid state.

", - "exception":true - }, - "InvalidTagException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

One or both of the values that make up the key-value pair is not valid. For example, you cannot specify a tag value that begins with aws:.

", - "exception":true - }, - "KeyAlgorithm":{ - "type":"string", - "enum":[ - "RSA_2048", - "RSA_1024", - "RSA_4096", - "EC_prime256v1", - "EC_secp384r1", - "EC_secp521r1" - ] - }, - "KeyAlgorithmList":{ - "type":"list", - "member":{"shape":"KeyAlgorithm"} - }, - "KeyUsage":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"KeyUsageName", - "documentation":"

A string value that contains a Key Usage extension name.

" - } - }, - "documentation":"

The Key Usage X.509 v3 extension defines the purpose of the public key contained in the certificate.

" - }, - "KeyUsageFilterList":{ - "type":"list", - "member":{"shape":"KeyUsageName"} - }, - "KeyUsageList":{ - "type":"list", - "member":{"shape":"KeyUsage"} - }, - "KeyUsageName":{ - "type":"string", - "enum":[ - "DIGITAL_SIGNATURE", - "NON_REPUDIATION", - "KEY_ENCIPHERMENT", - "DATA_ENCIPHERMENT", - "KEY_AGREEMENT", - "CERTIFICATE_SIGNING", - "CRL_SIGNING", - "ENCIPHER_ONLY", - "DECIPHER_ONLY", - "ANY", - "CUSTOM" - ] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

An ACM limit has been exceeded.

", - "exception":true - }, - "ListCertificatesRequest":{ - "type":"structure", - "members":{ - "CertificateStatuses":{ - "shape":"CertificateStatuses", - "documentation":"

Filter the certificate list by status value.

" - }, - "Includes":{ - "shape":"Filters", - "documentation":"

Filter the certificate list. For more information, see the Filters structure.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter only when paginating results and only in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

" - }, - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

" - } - } - }, - "ListCertificatesResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the list is truncated, this value is present and contains the value to use for the NextToken parameter in a subsequent pagination request.

" - }, - "CertificateSummaryList":{ - "shape":"CertificateSummaryList", - "documentation":"

A list of ACM certificates.

" - } - } - }, - "ListTagsForCertificateRequest":{ - "type":"structure", - "required":["CertificateArn"], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the ACM certificate for which you want to list the tags. This must have the following form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - } - }, - "ListTagsForCertificateResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The key-value pairs that define the applied tags.

" - } - } - }, - "MaxItems":{ - "type":"integer", - "max":1000, - "min":1 - }, - "NextToken":{ - "type":"string", - "max":320, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]*" - }, - "PassphraseBlob":{ - "type":"blob", - "max":128, - "min":4, - "sensitive":true - }, - "PrivateKey":{ - "type":"string", - "max":524288, - "min":1, - "pattern":"-{5}BEGIN PRIVATE KEY-{5}\\u000D?\\u000A([A-Za-z0-9/+]{64}\\u000D?\\u000A)*[A-Za-z0-9/+]{1,64}={0,2}\\u000D?\\u000A-{5}END PRIVATE KEY-{5}(\\u000D?\\u000A)?", - "sensitive":true - }, - "PrivateKeyBlob":{ - "type":"blob", - "max":524288, - "min":1, - "sensitive":true - }, - "RecordType":{ - "type":"string", - "enum":["CNAME"] - }, - "RemoveTagsFromCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateArn", - "Tags" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the ACM Certificate with one or more tags that you want to remove. This must be of the form:

arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The key-value pair that defines the tag to remove.

" - } - } - }, - "RenewalEligibility":{ - "type":"string", - "enum":[ - "ELIGIBLE", - "INELIGIBLE" - ] - }, - "RenewalStatus":{ - "type":"string", - "enum":[ - "PENDING_AUTO_RENEWAL", - "PENDING_VALIDATION", - "SUCCESS", - "FAILED" - ] - }, - "RenewalSummary":{ - "type":"structure", - "required":[ - "RenewalStatus", - "DomainValidationOptions" - ], - "members":{ - "RenewalStatus":{ - "shape":"RenewalStatus", - "documentation":"

The status of ACM's managed renewal of the certificate.

" - }, - "DomainValidationOptions":{ - "shape":"DomainValidationList", - "documentation":"

Contains information about the validation of each domain name in the certificate, as it pertains to ACM's managed renewal. This is different from the initial validation that occurs as a result of the RequestCertificate request. This field exists only when the certificate type is AMAZON_ISSUED.

" - } - }, - "documentation":"

Contains information about the status of ACM's managed renewal for the certificate. This structure exists only when the certificate type is AMAZON_ISSUED.

" - }, - "RequestCertificateRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainNameString", - "documentation":"

Fully qualified domain name (FQDN), such as www.example.com, that you want to secure with an ACM certificate. Use an asterisk (*) to create a wildcard certificate that protects several sites in the same domain. For example, *.example.com protects www.example.com, site.example.com, and images.example.com.

The first domain name you enter cannot exceed 63 octets, including periods. Each subsequent Subject Alternative Name (SAN), however, can be up to 253 octets in length.

" - }, - "ValidationMethod":{ - "shape":"ValidationMethod", - "documentation":"

The method you want to use if you are requesting a public certificate to validate that you own or control domain. You can validate with DNS or validate with email. We recommend that you use DNS validation.

" - }, - "SubjectAlternativeNames":{ - "shape":"DomainList", - "documentation":"

Additional FQDNs to be included in the Subject Alternative Name extension of the ACM certificate. For example, add the name www.example.net to a certificate for which the DomainName field is www.example.com if users can reach your site by using either name. The maximum number of domain names that you can add to an ACM certificate is 100. However, the initial limit is 10 domain names. If you need more than 10 names, you must request a limit increase. For more information, see Limits.

The maximum length of a SAN DNS name is 253 octets. The name is made up of multiple labels separated by periods. No label can be longer than 63 octets. Consider the following examples:

  • (63 octets).(63 octets).(63 octets).(61 octets) is legal because the total length is 253 octets (63+1+63+1+63+1+61) and no label exceeds 63 octets.

  • (64 octets).(63 octets).(63 octets).(61 octets) is not legal because the total length exceeds 253 octets (64+1+63+1+63+1+61) and the first label exceeds 63 octets.

  • (63 octets).(63 octets).(63 octets).(62 octets) is not legal because the total length of the DNS name (63+1+63+1+63+1+62) exceeds 253 octets.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

Customer chosen string that can be used to distinguish between calls to RequestCertificate. Idempotency tokens time out after one hour. Therefore, if you call RequestCertificate multiple times with the same idempotency token within one hour, ACM recognizes that you are requesting only one certificate and will issue only one. If you change the idempotency token for each call, ACM recognizes that you are requesting multiple certificates.

" - }, - "DomainValidationOptions":{ - "shape":"DomainValidationOptionList", - "documentation":"

The domain name that you want ACM to use to send you emails so that you can validate domain ownership.

" - }, - "Options":{ - "shape":"CertificateOptions", - "documentation":"

Currently, you can use this parameter to specify whether to add the certificate to a certificate transparency log. Certificate transparency makes it possible to detect SSL/TLS certificates that have been mistakenly or maliciously issued. Certificates that have not been logged typically produce an error message in a browser. For more information, see Opting Out of Certificate Transparency Logging.

" - }, - "CertificateAuthorityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the private certificate authority (CA) that will be used to issue the certificate. If you do not provide an ARN and you are trying to request a private certificate, ACM will attempt to issue a public certificate. For more information about private CAs, see the AWS Certificate Manager Private Certificate Authority (PCA) user guide. The ARN must have the following form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

" - } - } - }, - "RequestCertificateResponse":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the issued certificate. This must be of the form:

arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012

" - } - } - }, - "RequestInProgressException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The certificate request is in process and the certificate in your account has not yet been issued.

", - "exception":true - }, - "ResendValidationEmailRequest":{ - "type":"structure", - "required":[ - "CertificateArn", - "Domain", - "ValidationDomain" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

String that contains the ARN of the requested certificate. The certificate ARN is generated and returned by the RequestCertificate action as soon as the request is made. By default, using this parameter causes email to be sent to all top-level domains you specified in the certificate request. The ARN must be of the form:

arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012

" - }, - "Domain":{ - "shape":"DomainNameString", - "documentation":"

The fully qualified domain name (FQDN) of the certificate that needs to be validated.

" - }, - "ValidationDomain":{ - "shape":"DomainNameString", - "documentation":"

The base validation domain that will act as the suffix of the email addresses that are used to send the emails. This must be the same as the Domain value or a superdomain of the Domain value. For example, if you requested a certificate for site.subdomain.example.com and specify a ValidationDomain of subdomain.example.com, ACM sends email to the domain registrant, technical contact, and administrative contact in WHOIS and the following five addresses:

  • admin@subdomain.example.com

  • administrator@subdomain.example.com

  • hostmaster@subdomain.example.com

  • postmaster@subdomain.example.com

  • webmaster@subdomain.example.com

" - } - } - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The certificate is in use by another AWS service in the caller's account. Remove the association and try again.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The specified certificate cannot be found in the caller's account or the caller's account cannot be found.

", - "exception":true - }, - "ResourceRecord":{ - "type":"structure", - "required":[ - "Name", - "Type", - "Value" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the DNS record to create in your domain. This is supplied by ACM.

" - }, - "Type":{ - "shape":"RecordType", - "documentation":"

The type of DNS record. Currently this can be CNAME.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the CNAME record to add to your DNS database. This is supplied by ACM.

" - } - }, - "documentation":"

Contains a DNS record value that you can use to can use to validate ownership or control of a domain. This is used by the DescribeCertificate action.

" - }, - "RevocationReason":{ - "type":"string", - "enum":[ - "UNSPECIFIED", - "KEY_COMPROMISE", - "CA_COMPROMISE", - "AFFILIATION_CHANGED", - "SUPERCEDED", - "CESSATION_OF_OPERATION", - "CERTIFICATE_HOLD", - "REMOVE_FROM_CRL", - "PRIVILEGE_WITHDRAWN", - "A_A_COMPROMISE" - ] - }, - "String":{"type":"string"}, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

A key-value pair that identifies or specifies metadata about an ACM resource.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request contains too many tags. Try the request again with fewer tags.

", - "exception":true - }, - "UpdateCertificateOptionsRequest":{ - "type":"structure", - "required":[ - "CertificateArn", - "Options" - ], - "members":{ - "CertificateArn":{ - "shape":"Arn", - "documentation":"

ARN of the requested certificate to update. This must be of the form:

arn:aws:acm:us-east-1:account:certificate/12345678-1234-1234-1234-123456789012

" - }, - "Options":{ - "shape":"CertificateOptions", - "documentation":"

Use to update the options for your certificate. Currently, you can specify whether to add your certificate to a transparency log. Certificate transparency makes it possible to detect SSL/TLS certificates that have been mistakenly or maliciously issued. Certificates that have not been logged typically produce an error message in a browser.

" - } - } - }, - "ValidationEmailList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ValidationMethod":{ - "type":"string", - "enum":[ - "EMAIL", - "DNS" - ] - } - }, - "documentation":"AWS Certificate Manager

Welcome to the AWS Certificate Manager (ACM) API documentation.

You can use ACM to manage SSL/TLS certificates for your AWS-based websites and applications. For general information about using ACM, see the AWS Certificate Manager User Guide .

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/waiters-2.json deleted file mode 100644 index 1fba453d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/acm/2015-12-08/waiters-2.json +++ /dev/null @@ -1,35 +0,0 @@ -{ - "version": 2, - "waiters": { - "CertificateValidated": { - "delay": 60, - "maxAttempts": 40, - "operation": "DescribeCertificate", - "acceptors": [ - { - "matcher": "pathAll", - "expected": "SUCCESS", - "argument": "Certificate.DomainValidationOptions[].ValidationStatus", - "state": "success" - }, - { - "matcher": "pathAny", - "expected": "PENDING_VALIDATION", - "argument": "Certificate.DomainValidationOptions[].ValidationStatus", - "state": "retry" - }, - { - "matcher": "path", - "expected": "FAILED", - "argument": "Certificate.Status", - "state": "failure" - }, - { - "matcher": "error", - "expected": "ResourceNotFoundException", - "state": "failure" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json deleted file mode 100644 index a91b700d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json +++ /dev/null @@ -1,46 +0,0 @@ -{ - "pagination": { - "ListSkills": { - "result_key": "SkillSummaries", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchUsers": { - "result_key": "Users", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTags": { - "result_key": "Tags", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchProfiles": { - "result_key": "Profiles", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchSkillGroups": { - "result_key": "SkillGroups", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchDevices": { - "result_key": "Devices", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchRooms": { - "result_key": "Rooms", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/service-2.json deleted file mode 100644 index 1e5ccc9c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/alexaforbusiness/2017-11-09/service-2.json +++ /dev/null @@ -1,2843 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-11-09", - "endpointPrefix":"a4b", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Alexa For Business", - "serviceId":"Alexa For Business", - "signatureVersion":"v4", - "targetPrefix":"AlexaForBusiness", - "uid":"alexaforbusiness-2017-11-09" - }, - "operations":{ - "AssociateContactWithAddressBook":{ - "name":"AssociateContactWithAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateContactWithAddressBookRequest"}, - "output":{"shape":"AssociateContactWithAddressBookResponse"}, - "errors":[ - {"shape":"LimitExceededException"} - ], - "documentation":"

Associates a contact with a given address book.

" - }, - "AssociateDeviceWithRoom":{ - "name":"AssociateDeviceWithRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDeviceWithRoomRequest"}, - "output":{"shape":"AssociateDeviceWithRoomResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"DeviceNotRegisteredException"} - ], - "documentation":"

Associates a device with a given room. This applies all the settings from the room profile to the device, and all the skills in any skill groups added to that room. This operation requires the device to be online, or else a manual sync is required.

" - }, - "AssociateSkillGroupWithRoom":{ - "name":"AssociateSkillGroupWithRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateSkillGroupWithRoomRequest"}, - "output":{"shape":"AssociateSkillGroupWithRoomResponse"}, - "documentation":"

Associates a skill group with a given room. This enables all skills in the associated skill group on all devices in the room.

" - }, - "CreateAddressBook":{ - "name":"CreateAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAddressBookRequest"}, - "output":{"shape":"CreateAddressBookResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an address book with the specified details.

" - }, - "CreateContact":{ - "name":"CreateContact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateContactRequest"}, - "output":{"shape":"CreateContactResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a contact with the specified details.

" - }, - "CreateProfile":{ - "name":"CreateProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProfileRequest"}, - "output":{"shape":"CreateProfileResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"AlreadyExistsException"} - ], - "documentation":"

Creates a new room profile with the specified details.

" - }, - "CreateRoom":{ - "name":"CreateRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRoomRequest"}, - "output":{"shape":"CreateRoomResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a room with the specified details.

" - }, - "CreateSkillGroup":{ - "name":"CreateSkillGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSkillGroupRequest"}, - "output":{"shape":"CreateSkillGroupResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a skill group with a specified name and description.

" - }, - "CreateUser":{ - "name":"CreateUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserRequest"}, - "output":{"shape":"CreateUserResponse"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a user.

" - }, - "DeleteAddressBook":{ - "name":"DeleteAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAddressBookRequest"}, - "output":{"shape":"DeleteAddressBookResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes an address book by the address book ARN.

" - }, - "DeleteContact":{ - "name":"DeleteContact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteContactRequest"}, - "output":{"shape":"DeleteContactResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a contact by the contact ARN.

" - }, - "DeleteProfile":{ - "name":"DeleteProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProfileRequest"}, - "output":{"shape":"DeleteProfileResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a room profile by the profile ARN.

" - }, - "DeleteRoom":{ - "name":"DeleteRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRoomRequest"}, - "output":{"shape":"DeleteRoomResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a room by the room ARN.

" - }, - "DeleteRoomSkillParameter":{ - "name":"DeleteRoomSkillParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRoomSkillParameterRequest"}, - "output":{"shape":"DeleteRoomSkillParameterResponse"}, - "documentation":"

Deletes room skill parameter details by room, skill, and parameter key ID.

" - }, - "DeleteSkillGroup":{ - "name":"DeleteSkillGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSkillGroupRequest"}, - "output":{"shape":"DeleteSkillGroupResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a skill group by skill group ARN.

" - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserRequest"}, - "output":{"shape":"DeleteUserResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a specified user by user ARN and enrollment ARN.

" - }, - "DisassociateContactFromAddressBook":{ - "name":"DisassociateContactFromAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateContactFromAddressBookRequest"}, - "output":{"shape":"DisassociateContactFromAddressBookResponse"}, - "documentation":"

Disassociates a contact from a given address book.

" - }, - "DisassociateDeviceFromRoom":{ - "name":"DisassociateDeviceFromRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateDeviceFromRoomRequest"}, - "output":{"shape":"DisassociateDeviceFromRoomResponse"}, - "errors":[ - {"shape":"DeviceNotRegisteredException"} - ], - "documentation":"

Disassociates a device from its current room. The device continues to be connected to the Wi-Fi network and is still registered to the account. The device settings and skills are removed from the room.

" - }, - "DisassociateSkillGroupFromRoom":{ - "name":"DisassociateSkillGroupFromRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateSkillGroupFromRoomRequest"}, - "output":{"shape":"DisassociateSkillGroupFromRoomResponse"}, - "documentation":"

Disassociates a skill group from a specified room. This disables all skills in the skill group on all devices in the room.

" - }, - "GetAddressBook":{ - "name":"GetAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAddressBookRequest"}, - "output":{"shape":"GetAddressBookResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets address the book details by the address book ARN.

" - }, - "GetContact":{ - "name":"GetContact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContactRequest"}, - "output":{"shape":"GetContactResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets the contact details by the contact ARN.

" - }, - "GetDevice":{ - "name":"GetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeviceRequest"}, - "output":{"shape":"GetDeviceResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets the details of a device by device ARN.

" - }, - "GetProfile":{ - "name":"GetProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetProfileRequest"}, - "output":{"shape":"GetProfileResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets the details of a room profile by profile ARN.

" - }, - "GetRoom":{ - "name":"GetRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRoomRequest"}, - "output":{"shape":"GetRoomResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets room details by room ARN.

" - }, - "GetRoomSkillParameter":{ - "name":"GetRoomSkillParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRoomSkillParameterRequest"}, - "output":{"shape":"GetRoomSkillParameterResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets room skill parameter details by room, skill, and parameter key ARN.

" - }, - "GetSkillGroup":{ - "name":"GetSkillGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSkillGroupRequest"}, - "output":{"shape":"GetSkillGroupResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Gets skill group details by skill group ARN.

" - }, - "ListDeviceEvents":{ - "name":"ListDeviceEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeviceEventsRequest"}, - "output":{"shape":"ListDeviceEventsResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Lists the device event history, including device connection status, for up to 30 days.

" - }, - "ListSkills":{ - "name":"ListSkills", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSkillsRequest"}, - "output":{"shape":"ListSkillsResponse"}, - "documentation":"

Lists all enabled skills in a specific skill group.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Lists all tags for the specified resource.

" - }, - "PutRoomSkillParameter":{ - "name":"PutRoomSkillParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRoomSkillParameterRequest"}, - "output":{"shape":"PutRoomSkillParameterResponse"}, - "documentation":"

Updates room skill parameter details by room, skill, and parameter key ID. Not all skills have a room skill parameter.

" - }, - "ResolveRoom":{ - "name":"ResolveRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResolveRoomRequest"}, - "output":{"shape":"ResolveRoomResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Determines the details for the room from which a skill request was invoked. This operation is used by skill developers.

" - }, - "RevokeInvitation":{ - "name":"RevokeInvitation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeInvitationRequest"}, - "output":{"shape":"RevokeInvitationResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Revokes an invitation and invalidates the enrollment URL.

" - }, - "SearchAddressBooks":{ - "name":"SearchAddressBooks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchAddressBooksRequest"}, - "output":{"shape":"SearchAddressBooksResponse"}, - "documentation":"

Searches address books and lists the ones that meet a set of filter and sort criteria.

" - }, - "SearchContacts":{ - "name":"SearchContacts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchContactsRequest"}, - "output":{"shape":"SearchContactsResponse"}, - "documentation":"

Searches contacts and lists the ones that meet a set of filter and sort criteria.

" - }, - "SearchDevices":{ - "name":"SearchDevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchDevicesRequest"}, - "output":{"shape":"SearchDevicesResponse"}, - "documentation":"

Searches devices and lists the ones that meet a set of filter criteria.

" - }, - "SearchProfiles":{ - "name":"SearchProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchProfilesRequest"}, - "output":{"shape":"SearchProfilesResponse"}, - "documentation":"

Searches room profiles and lists the ones that meet a set of filter criteria.

" - }, - "SearchRooms":{ - "name":"SearchRooms", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchRoomsRequest"}, - "output":{"shape":"SearchRoomsResponse"}, - "documentation":"

Searches rooms and lists the ones that meet a set of filter and sort criteria.

" - }, - "SearchSkillGroups":{ - "name":"SearchSkillGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchSkillGroupsRequest"}, - "output":{"shape":"SearchSkillGroupsResponse"}, - "documentation":"

Searches skill groups and lists the ones that meet a set of filter and sort criteria.

" - }, - "SearchUsers":{ - "name":"SearchUsers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchUsersRequest"}, - "output":{"shape":"SearchUsersResponse"}, - "documentation":"

Searches users and lists the ones that meet a set of filter and sort criteria.

" - }, - "SendInvitation":{ - "name":"SendInvitation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendInvitationRequest"}, - "output":{"shape":"SendInvitationResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidUserStatusException"} - ], - "documentation":"

Sends an enrollment invitation email with a URL to a user. The URL is valid for 72 hours or until you call this operation again, whichever comes first.

" - }, - "StartDeviceSync":{ - "name":"StartDeviceSync", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartDeviceSyncRequest"}, - "output":{"shape":"StartDeviceSyncResponse"}, - "errors":[ - {"shape":"DeviceNotRegisteredException"} - ], - "documentation":"

Resets a device and its account to the known default settings, by clearing all information and settings set by previous users.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Adds metadata tags to a specified resource.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Removes metadata tags from a specified resource.

" - }, - "UpdateAddressBook":{ - "name":"UpdateAddressBook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAddressBookRequest"}, - "output":{"shape":"UpdateAddressBookResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"NameInUseException"} - ], - "documentation":"

Updates address book details by the address book ARN.

" - }, - "UpdateContact":{ - "name":"UpdateContact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateContactRequest"}, - "output":{"shape":"UpdateContactResponse"}, - "errors":[ - {"shape":"NotFoundException"} - ], - "documentation":"

Updates the contact details by the contact ARN.

" - }, - "UpdateDevice":{ - "name":"UpdateDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDeviceRequest"}, - "output":{"shape":"UpdateDeviceResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DeviceNotRegisteredException"} - ], - "documentation":"

Updates the device name by device ARN.

" - }, - "UpdateProfile":{ - "name":"UpdateProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProfileRequest"}, - "output":{"shape":"UpdateProfileResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"NameInUseException"} - ], - "documentation":"

Updates an existing room profile by room profile ARN.

" - }, - "UpdateRoom":{ - "name":"UpdateRoom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRoomRequest"}, - "output":{"shape":"UpdateRoomResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"NameInUseException"} - ], - "documentation":"

Updates room details by room ARN.

" - }, - "UpdateSkillGroup":{ - "name":"UpdateSkillGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSkillGroupRequest"}, - "output":{"shape":"UpdateSkillGroupResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"NameInUseException"} - ], - "documentation":"

Updates skill group details by skill group ARN.

" - } - }, - "shapes":{ - "Address":{ - "type":"string", - "max":500, - "min":1 - }, - "AddressBook":{ - "type":"structure", - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address book.

" - }, - "Name":{ - "shape":"AddressBookName", - "documentation":"

The name of the address book.

" - }, - "Description":{ - "shape":"AddressBookDescription", - "documentation":"

The description of the address book.

" - } - }, - "documentation":"

An address book with attributes.

" - }, - "AddressBookData":{ - "type":"structure", - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address book.

" - }, - "Name":{ - "shape":"AddressBookName", - "documentation":"

The name of the address book.

" - }, - "Description":{ - "shape":"AddressBookDescription", - "documentation":"

The description of the address book.

" - } - }, - "documentation":"

Information related to an address book.

" - }, - "AddressBookDataList":{ - "type":"list", - "member":{"shape":"AddressBookData"} - }, - "AddressBookDescription":{ - "type":"string", - "max":200, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "AddressBookName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The resource being created already exists. HTTP Status Code: 400

", - "exception":true - }, - "Arn":{ - "type":"string", - "pattern":"arn:[a-z0-9-\\.]{1,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[^/].{0,1023}" - }, - "AssociateContactWithAddressBookRequest":{ - "type":"structure", - "required":[ - "ContactArn", - "AddressBookArn" - ], - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact to associate with an address book.

" - }, - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address book with which to associate the contact.

" - } - } - }, - "AssociateContactWithAddressBookResponse":{ - "type":"structure", - "members":{ - } - }, - "AssociateDeviceWithRoomRequest":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the device to associate to a room. Required.

" - }, - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room with which to associate the device. Required.

" - } - } - }, - "AssociateDeviceWithRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "AssociateSkillGroupWithRoomRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group to associate with a room. Required.

" - }, - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room with which to associate the skill group. Required.

" - } - } - }, - "AssociateSkillGroupWithRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "Boolean":{"type":"boolean"}, - "ClientRequestToken":{ - "type":"string", - "documentation":"User specified token that is used to support idempotency during Create Resource", - "max":150, - "min":10, - "pattern":"[a-zA-Z0-9][a-zA-Z0-9_-]*" - }, - "ConnectionStatus":{ - "type":"string", - "enum":[ - "ONLINE", - "OFFLINE" - ] - }, - "Contact":{ - "type":"structure", - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact.

" - }, - "DisplayName":{ - "shape":"ContactName", - "documentation":"

The name of the contact to display on the console.

" - }, - "FirstName":{ - "shape":"ContactName", - "documentation":"

The first name of the contact, used to call the contact on the device.

" - }, - "LastName":{ - "shape":"ContactName", - "documentation":"

The last name of the contact, used to call the contact on the device.

" - }, - "PhoneNumber":{ - "shape":"E164PhoneNumber", - "documentation":"

The phone number of the contact.

" - } - }, - "documentation":"

A contact with attributes.

" - }, - "ContactData":{ - "type":"structure", - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact.

" - }, - "DisplayName":{ - "shape":"ContactName", - "documentation":"

The name of the contact to display on the console.

" - }, - "FirstName":{ - "shape":"ContactName", - "documentation":"

The first name of the contact, used to call the contact on the device.

" - }, - "LastName":{ - "shape":"ContactName", - "documentation":"

The last name of the contact, used to call the contact on the device.

" - }, - "PhoneNumber":{ - "shape":"E164PhoneNumber", - "documentation":"

The phone number of the contact.

" - } - }, - "documentation":"

Information related to a contact.

" - }, - "ContactDataList":{ - "type":"list", - "member":{"shape":"ContactData"} - }, - "ContactName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "CreateAddressBookRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"AddressBookName", - "documentation":"

The name of the address book.

" - }, - "Description":{ - "shape":"AddressBookDescription", - "documentation":"

The description of the address book.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, user-specified identifier for the request that ensures idempotency.

", - "idempotencyToken":true - } - } - }, - "CreateAddressBookResponse":{ - "type":"structure", - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created address book.

" - } - } - }, - "CreateContactRequest":{ - "type":"structure", - "required":[ - "FirstName", - "PhoneNumber" - ], - "members":{ - "DisplayName":{ - "shape":"ContactName", - "documentation":"

The name of the contact to display on the console.

" - }, - "FirstName":{ - "shape":"ContactName", - "documentation":"

The first name of the contact that is used to call the contact on the device.

" - }, - "LastName":{ - "shape":"ContactName", - "documentation":"

The last name of the contact that is used to call the contact on the device.

" - }, - "PhoneNumber":{ - "shape":"E164PhoneNumber", - "documentation":"

The phone number of the contact in E.164 format.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, user-specified identifier for this request that ensures idempotency.

", - "idempotencyToken":true - } - } - }, - "CreateContactResponse":{ - "type":"structure", - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created address book.

" - } - } - }, - "CreateProfileRequest":{ - "type":"structure", - "required":[ - "ProfileName", - "Timezone", - "Address", - "DistanceUnit", - "TemperatureUnit", - "WakeWord" - ], - "members":{ - "ProfileName":{ - "shape":"ProfileName", - "documentation":"

The name of a room profile.

" - }, - "Timezone":{ - "shape":"Timezone", - "documentation":"

The time zone used by a room profile.

" - }, - "Address":{ - "shape":"Address", - "documentation":"

The valid address for the room.

" - }, - "DistanceUnit":{ - "shape":"DistanceUnit", - "documentation":"

The distance unit to be used by devices in the profile.

" - }, - "TemperatureUnit":{ - "shape":"TemperatureUnit", - "documentation":"

The temperature unit to be used by devices in the profile.

" - }, - "WakeWord":{ - "shape":"WakeWord", - "documentation":"

A wake word for Alexa, Echo, Amazon, or a computer.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

The user-specified token that is used during the creation of a profile.

", - "idempotencyToken":true - }, - "SetupModeDisabled":{ - "shape":"Boolean", - "documentation":"

Whether room profile setup is enabled.

" - }, - "MaxVolumeLimit":{ - "shape":"MaxVolumeLimit", - "documentation":"

The maximum volume limit for a room profile.

" - }, - "PSTNEnabled":{ - "shape":"Boolean", - "documentation":"

Whether PSTN calling is enabled.

" - } - } - }, - "CreateProfileResponse":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created room profile in the response.

" - } - } - }, - "CreateRoomRequest":{ - "type":"structure", - "required":["RoomName"], - "members":{ - "RoomName":{ - "shape":"RoomName", - "documentation":"

The name for the room.

" - }, - "Description":{ - "shape":"RoomDescription", - "documentation":"

The description for the room.

" - }, - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The profile ARN for the room.

" - }, - "ProviderCalendarId":{ - "shape":"ProviderCalendarId", - "documentation":"

The calendar ARN for the room.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, user-specified identifier for this request that ensures idempotency.

", - "idempotencyToken":true - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the room.

" - } - } - }, - "CreateRoomResponse":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created room in the response.

" - } - } - }, - "CreateSkillGroupRequest":{ - "type":"structure", - "required":["SkillGroupName"], - "members":{ - "SkillGroupName":{ - "shape":"SkillGroupName", - "documentation":"

The name for the skill group.

" - }, - "Description":{ - "shape":"SkillGroupDescription", - "documentation":"

The description for the skill group.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, user-specified identifier for this request that ensures idempotency.

", - "idempotencyToken":true - } - } - }, - "CreateSkillGroupResponse":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created skill group in the response.

" - } - } - }, - "CreateUserRequest":{ - "type":"structure", - "required":["UserId"], - "members":{ - "UserId":{ - "shape":"user_UserId", - "documentation":"

The ARN for the user.

" - }, - "FirstName":{ - "shape":"user_FirstName", - "documentation":"

The first name for the user.

" - }, - "LastName":{ - "shape":"user_LastName", - "documentation":"

The last name for the user.

" - }, - "Email":{ - "shape":"Email", - "documentation":"

The email address for the user.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, user-specified identifier for this request that ensures idempotency.

", - "idempotencyToken":true - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the user.

" - } - } - }, - "CreateUserResponse":{ - "type":"structure", - "members":{ - "UserArn":{ - "shape":"Arn", - "documentation":"

The ARN of the newly created user in the response.

" - } - } - }, - "DeleteAddressBookRequest":{ - "type":"structure", - "required":["AddressBookArn"], - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address book to delete.

" - } - } - }, - "DeleteAddressBookResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteContactRequest":{ - "type":"structure", - "required":["ContactArn"], - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact to delete.

" - } - } - }, - "DeleteContactResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteProfileRequest":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room profile to delete. Required.

" - } - } - }, - "DeleteProfileResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteRoomRequest":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room to delete. Required.

" - } - } - }, - "DeleteRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteRoomSkillParameterRequest":{ - "type":"structure", - "required":[ - "SkillId", - "ParameterKey" - ], - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room from which to remove the room skill parameter details.

" - }, - "SkillId":{ - "shape":"SkillId", - "documentation":"

The ID of the skill from which to remove the room skill parameter details.

" - }, - "ParameterKey":{ - "shape":"RoomSkillParameterKey", - "documentation":"

The room skill parameter key for which to remove details.

" - } - } - }, - "DeleteRoomSkillParameterResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteSkillGroupRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group to delete. Required.

" - } - } - }, - "DeleteSkillGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteUserRequest":{ - "type":"structure", - "required":["EnrollmentId"], - "members":{ - "UserArn":{ - "shape":"Arn", - "documentation":"

The ARN of the user to delete in the organization. Required.

" - }, - "EnrollmentId":{ - "shape":"EnrollmentId", - "documentation":"

The ARN of the user's enrollment in the organization. Required.

" - } - } - }, - "DeleteUserResponse":{ - "type":"structure", - "members":{ - } - }, - "Device":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of a device.

" - }, - "DeviceSerialNumber":{ - "shape":"DeviceSerialNumber", - "documentation":"

The serial number of a device.

" - }, - "DeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of a device.

" - }, - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The name of a device.

" - }, - "SoftwareVersion":{ - "shape":"SoftwareVersion", - "documentation":"

The software version of a device.

" - }, - "MacAddress":{ - "shape":"MacAddress", - "documentation":"

The MAC address of a device.

" - }, - "RoomArn":{ - "shape":"Arn", - "documentation":"

The room ARN of a device.

" - }, - "DeviceStatus":{ - "shape":"DeviceStatus", - "documentation":"

The status of a device. If the status is not READY, check the DeviceStatusInfo value for details.

" - }, - "DeviceStatusInfo":{ - "shape":"DeviceStatusInfo", - "documentation":"

Detailed information about a device's status.

" - } - }, - "documentation":"

A device with attributes.

" - }, - "DeviceData":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of a device.

" - }, - "DeviceSerialNumber":{ - "shape":"DeviceSerialNumber", - "documentation":"

The serial number of a device.

" - }, - "DeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of a device.

" - }, - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The name of a device.

" - }, - "SoftwareVersion":{ - "shape":"SoftwareVersion", - "documentation":"

The software version of a device.

" - }, - "MacAddress":{ - "shape":"MacAddress", - "documentation":"

The MAC address of a device.

" - }, - "DeviceStatus":{ - "shape":"DeviceStatus", - "documentation":"

The status of a device.

" - }, - "RoomArn":{ - "shape":"Arn", - "documentation":"

The room ARN associated with a device.

" - }, - "RoomName":{ - "shape":"RoomName", - "documentation":"

The name of the room associated with a device.

" - }, - "DeviceStatusInfo":{ - "shape":"DeviceStatusInfo", - "documentation":"

Detailed information about a device's status.

" - } - }, - "documentation":"

Device attributes.

" - }, - "DeviceDataList":{ - "type":"list", - "member":{"shape":"DeviceData"} - }, - "DeviceEvent":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"DeviceEventType", - "documentation":"

The type of device event.

" - }, - "Value":{ - "shape":"DeviceEventValue", - "documentation":"

The value of the event.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time (in epoch) when the event occurred.

" - } - }, - "documentation":"

The list of device events.

" - }, - "DeviceEventList":{ - "type":"list", - "member":{"shape":"DeviceEvent"} - }, - "DeviceEventType":{ - "type":"string", - "enum":[ - "CONNECTION_STATUS", - "DEVICE_STATUS" - ] - }, - "DeviceEventValue":{"type":"string"}, - "DeviceName":{ - "type":"string", - "max":100, - "min":2, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "DeviceNotRegisteredException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request failed because this device is no longer registered and therefore no longer managed by this account.

", - "exception":true - }, - "DeviceSerialNumber":{ - "type":"string", - "pattern":"[a-zA-Z0-9]{1,200}" - }, - "DeviceStatus":{ - "type":"string", - "enum":[ - "READY", - "PENDING", - "WAS_OFFLINE", - "DEREGISTERED" - ] - }, - "DeviceStatusDetail":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"DeviceStatusDetailCode", - "documentation":"

The device status detail code.

" - } - }, - "documentation":"

Details of a device’s status.

" - }, - "DeviceStatusDetailCode":{ - "type":"string", - "enum":[ - "DEVICE_SOFTWARE_UPDATE_NEEDED", - "DEVICE_WAS_OFFLINE" - ] - }, - "DeviceStatusDetails":{ - "type":"list", - "member":{"shape":"DeviceStatusDetail"} - }, - "DeviceStatusInfo":{ - "type":"structure", - "members":{ - "DeviceStatusDetails":{ - "shape":"DeviceStatusDetails", - "documentation":"

One or more device status detail descriptions.

" - }, - "ConnectionStatus":{ - "shape":"ConnectionStatus", - "documentation":"

The latest available information about the connection status of a device.

" - } - }, - "documentation":"

Detailed information about a device's status.

" - }, - "DeviceType":{ - "type":"string", - "pattern":"[a-zA-Z0-9]{1,200}" - }, - "DisassociateContactFromAddressBookRequest":{ - "type":"structure", - "required":[ - "ContactArn", - "AddressBookArn" - ], - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact to disassociate from an address book.

" - }, - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address from which to disassociate the contact.

" - } - } - }, - "DisassociateContactFromAddressBookResponse":{ - "type":"structure", - "members":{ - } - }, - "DisassociateDeviceFromRoomRequest":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the device to disassociate from a room. Required.

" - } - } - }, - "DisassociateDeviceFromRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "DisassociateSkillGroupFromRoomRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group to disassociate from a room. Required.

" - }, - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room from which the skill group is to be disassociated. Required.

" - } - } - }, - "DisassociateSkillGroupFromRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "DistanceUnit":{ - "type":"string", - "enum":[ - "METRIC", - "IMPERIAL" - ] - }, - "E164PhoneNumber":{ - "type":"string", - "pattern":"^\\+\\d{8,}$" - }, - "Email":{ - "type":"string", - "max":128, - "min":1, - "pattern":"([0-9a-zA-Z]([+-.\\w]*[0-9a-zA-Z])*@([0-9a-zA-Z][-\\w]*[0-9a-zA-Z]\\.)+[a-zA-Z]{2,9})" - }, - "EnrollmentId":{ - "type":"string", - "max":128, - "min":0 - }, - "EnrollmentStatus":{ - "type":"string", - "enum":[ - "INITIALIZED", - "PENDING", - "REGISTERED", - "DISASSOCIATING", - "DEREGISTERING" - ] - }, - "ErrorMessage":{"type":"string"}, - "Feature":{ - "type":"string", - "enum":[ - "BLUETOOTH", - "VOLUME", - "NOTIFICATIONS", - "LISTS", - "SKILLS", - "ALL" - ] - }, - "Features":{ - "type":"list", - "member":{"shape":"Feature"} - }, - "Filter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"FilterKey", - "documentation":"

The key of a filter.

" - }, - "Values":{ - "shape":"FilterValueList", - "documentation":"

The values of a filter.

" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

" - }, - "FilterKey":{ - "type":"string", - "max":500, - "min":1 - }, - "FilterList":{ - "type":"list", - "member":{"shape":"Filter"}, - "max":25 - }, - "FilterValue":{ - "type":"string", - "max":500, - "min":1 - }, - "FilterValueList":{ - "type":"list", - "member":{"shape":"FilterValue"}, - "max":5 - }, - "GetAddressBookRequest":{ - "type":"structure", - "required":["AddressBookArn"], - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the address book for which to request details.

" - } - } - }, - "GetAddressBookResponse":{ - "type":"structure", - "members":{ - "AddressBook":{ - "shape":"AddressBook", - "documentation":"

The details of the requested address book.

" - } - } - }, - "GetContactRequest":{ - "type":"structure", - "required":["ContactArn"], - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact for which to request details.

" - } - } - }, - "GetContactResponse":{ - "type":"structure", - "members":{ - "Contact":{ - "shape":"Contact", - "documentation":"

The details of the requested contact.

" - } - } - }, - "GetDeviceRequest":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the device for which to request details. Required.

" - } - } - }, - "GetDeviceResponse":{ - "type":"structure", - "members":{ - "Device":{ - "shape":"Device", - "documentation":"

The details of the device requested. Required.

" - } - } - }, - "GetProfileRequest":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room profile for which to request details. Required.

" - } - } - }, - "GetProfileResponse":{ - "type":"structure", - "members":{ - "Profile":{ - "shape":"Profile", - "documentation":"

The details of the room profile requested. Required.

" - } - } - }, - "GetRoomRequest":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room for which to request details. Required.

" - } - } - }, - "GetRoomResponse":{ - "type":"structure", - "members":{ - "Room":{ - "shape":"Room", - "documentation":"

The details of the room requested.

" - } - } - }, - "GetRoomSkillParameterRequest":{ - "type":"structure", - "required":[ - "SkillId", - "ParameterKey" - ], - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room from which to get the room skill parameter details.

" - }, - "SkillId":{ - "shape":"SkillId", - "documentation":"

The ARN of the skill from which to get the room skill parameter details. Required.

" - }, - "ParameterKey":{ - "shape":"RoomSkillParameterKey", - "documentation":"

The room skill parameter key for which to get details. Required.

" - } - } - }, - "GetRoomSkillParameterResponse":{ - "type":"structure", - "members":{ - "RoomSkillParameter":{ - "shape":"RoomSkillParameter", - "documentation":"

The details of the room skill parameter requested. Required.

" - } - } - }, - "GetSkillGroupRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group for which to get details. Required.

" - } - } - }, - "GetSkillGroupResponse":{ - "type":"structure", - "members":{ - "SkillGroup":{ - "shape":"SkillGroup", - "documentation":"

The details of the skill group requested. Required.

" - } - } - }, - "InvalidUserStatusException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The attempt to update a user is invalid due to the user's current status. HTTP Status Code: 400

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400

", - "exception":true - }, - "ListDeviceEventsRequest":{ - "type":"structure", - "required":["DeviceArn"], - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of a device.

" - }, - "EventType":{ - "shape":"DeviceEventType", - "documentation":"

The event type to filter device events. If EventType isn't specified, this returns a list of all device events in reverse chronological order. If EventType is specified, this returns a list of device events for that EventType in reverse chronological order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults. When the end of results is reached, the response has a value of null.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. The default value is 50. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - } - } - }, - "ListDeviceEventsResponse":{ - "type":"structure", - "members":{ - "DeviceEvents":{ - "shape":"DeviceEventList", - "documentation":"

The device events requested for the device ARN.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - } - } - }, - "ListSkillsRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group for which to list enabled skills. Required.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.

" - }, - "MaxResults":{ - "shape":"SkillListMaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.

" - } - } - }, - "ListSkillsResponse":{ - "type":"structure", - "members":{ - "SkillSummaries":{ - "shape":"SkillSummaryList", - "documentation":"

The list of enabled skills requested. Required.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - } - } - }, - "ListTagsRequest":{ - "type":"structure", - "required":["Arn"], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the specified resource for which to list tags.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - } - } - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The tags requested for the specified resource.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - } - } - }, - "MacAddress":{"type":"string"}, - "MaxResults":{ - "type":"integer", - "max":50, - "min":1 - }, - "MaxVolumeLimit":{"type":"integer"}, - "NameInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The name sent in the request is already in use. HTTP Status Code: 400

", - "exception":true - }, - "NextToken":{ - "type":"string", - "max":1000, - "min":1 - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The resource is not found. HTTP Status Code: 400

", - "exception":true - }, - "Profile":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of a room profile.

" - }, - "ProfileName":{ - "shape":"ProfileName", - "documentation":"

The name of a room profile.

" - }, - "Address":{ - "shape":"Address", - "documentation":"

The address of a room profile.

" - }, - "Timezone":{ - "shape":"Timezone", - "documentation":"

The time zone of a room profile.

" - }, - "DistanceUnit":{ - "shape":"DistanceUnit", - "documentation":"

The distance unit of a room profile.

" - }, - "TemperatureUnit":{ - "shape":"TemperatureUnit", - "documentation":"

The temperature unit of a room profile.

" - }, - "WakeWord":{ - "shape":"WakeWord", - "documentation":"

The wake word of a room profile.

" - }, - "SetupModeDisabled":{ - "shape":"Boolean", - "documentation":"

The setup mode of a room profile.

" - }, - "MaxVolumeLimit":{ - "shape":"MaxVolumeLimit", - "documentation":"

The max volume limit of a room profile.

" - }, - "PSTNEnabled":{ - "shape":"Boolean", - "documentation":"

The PSTN setting of a room profile.

" - } - }, - "documentation":"

A room profile with attributes.

" - }, - "ProfileData":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of a room profile.

" - }, - "ProfileName":{ - "shape":"ProfileName", - "documentation":"

The name of a room profile.

" - }, - "Address":{ - "shape":"Address", - "documentation":"

The address of a room profile.

" - }, - "Timezone":{ - "shape":"Timezone", - "documentation":"

The timezone of a room profile.

" - }, - "DistanceUnit":{ - "shape":"DistanceUnit", - "documentation":"

The distance unit of a room profile.

" - }, - "TemperatureUnit":{ - "shape":"TemperatureUnit", - "documentation":"

The temperature unit of a room profile.

" - }, - "WakeWord":{ - "shape":"WakeWord", - "documentation":"

The wake word of a room profile.

" - } - }, - "documentation":"

The data of a room profile.

" - }, - "ProfileDataList":{ - "type":"list", - "member":{"shape":"ProfileData"} - }, - "ProfileName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "ProviderCalendarId":{ - "type":"string", - "max":100, - "min":0 - }, - "PutRoomSkillParameterRequest":{ - "type":"structure", - "required":[ - "SkillId", - "RoomSkillParameter" - ], - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room associated with the room skill parameter. Required.

" - }, - "SkillId":{ - "shape":"SkillId", - "documentation":"

The ARN of the skill associated with the room skill parameter. Required.

" - }, - "RoomSkillParameter":{ - "shape":"RoomSkillParameter", - "documentation":"

The updated room skill parameter. Required.

" - } - } - }, - "PutRoomSkillParameterResponse":{ - "type":"structure", - "members":{ - } - }, - "ResolveRoomRequest":{ - "type":"structure", - "required":[ - "UserId", - "SkillId" - ], - "members":{ - "UserId":{ - "shape":"UserId", - "documentation":"

The ARN of the user. Required.

" - }, - "SkillId":{ - "shape":"SkillId", - "documentation":"

The ARN of the skill that was requested. Required.

" - } - } - }, - "ResolveRoomResponse":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room from which the skill request was invoked.

" - }, - "RoomName":{ - "shape":"RoomName", - "documentation":"

The name of the room from which the skill request was invoked.

" - }, - "RoomSkillParameters":{ - "shape":"RoomSkillParameters", - "documentation":"

Response to get the room profile request. Required.

" - } - } - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "ClientRequestToken":{"shape":"ClientRequestToken"} - }, - "documentation":"

The resource in the request is already in use. HTTP Status Code: 400

", - "exception":true - }, - "RevokeInvitationRequest":{ - "type":"structure", - "members":{ - "UserArn":{ - "shape":"Arn", - "documentation":"

The ARN of the user for whom to revoke an enrollment invitation. Required.

" - }, - "EnrollmentId":{ - "shape":"EnrollmentId", - "documentation":"

The ARN of the enrollment invitation to revoke. Required.

" - } - } - }, - "RevokeInvitationResponse":{ - "type":"structure", - "members":{ - } - }, - "Room":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of a room.

" - }, - "RoomName":{ - "shape":"RoomName", - "documentation":"

The name of a room.

" - }, - "Description":{ - "shape":"RoomDescription", - "documentation":"

The description of a room.

" - }, - "ProviderCalendarId":{ - "shape":"ProviderCalendarId", - "documentation":"

The provider calendar ARN of a room.

" - }, - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The profile ARN of a room.

" - } - }, - "documentation":"

A room with attributes.

" - }, - "RoomData":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of a room.

" - }, - "RoomName":{ - "shape":"RoomName", - "documentation":"

The name of a room.

" - }, - "Description":{ - "shape":"RoomDescription", - "documentation":"

The description of a room.

" - }, - "ProviderCalendarId":{ - "shape":"ProviderCalendarId", - "documentation":"

The provider calendar ARN of a room.

" - }, - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The profile ARN of a room.

" - }, - "ProfileName":{ - "shape":"ProfileName", - "documentation":"

The profile name of a room.

" - } - }, - "documentation":"

The data of a room.

" - }, - "RoomDataList":{ - "type":"list", - "member":{"shape":"RoomData"} - }, - "RoomDescription":{ - "type":"string", - "max":200, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "RoomName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "RoomSkillParameter":{ - "type":"structure", - "required":[ - "ParameterKey", - "ParameterValue" - ], - "members":{ - "ParameterKey":{ - "shape":"RoomSkillParameterKey", - "documentation":"

The parameter key of a room skill parameter. ParameterKey is an enumerated type that only takes “DEFAULT” or “SCOPE” as valid values.

" - }, - "ParameterValue":{ - "shape":"RoomSkillParameterValue", - "documentation":"

The parameter value of a room skill parameter.

" - } - }, - "documentation":"

A skill parameter associated with a room.

" - }, - "RoomSkillParameterKey":{ - "type":"string", - "max":256, - "min":1 - }, - "RoomSkillParameterValue":{ - "type":"string", - "max":512, - "min":1 - }, - "RoomSkillParameters":{ - "type":"list", - "member":{"shape":"RoomSkillParameter"} - }, - "SearchAddressBooksRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of address books. The supported filter key is AddressBookName.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of address books. The supported sort key is AddressBookName.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - } - } - }, - "SearchAddressBooksResponse":{ - "type":"structure", - "members":{ - "AddressBooks":{ - "shape":"AddressBookDataList", - "documentation":"

The address books that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of address books returned.

" - } - } - }, - "SearchContactsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of address books. The supported filter keys are DisplayName, FirstName, LastName, and AddressBookArns.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of contacts. The supported sort keys are DisplayName, FirstName, and LastName.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - } - } - }, - "SearchContactsResponse":{ - "type":"structure", - "members":{ - "Contacts":{ - "shape":"ContactDataList", - "documentation":"

The contacts that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of contacts returned.

" - } - } - }, - "SearchDevicesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of devices. Supported filter keys are DeviceName, DeviceStatus, DeviceStatusDetailCode, RoomName, DeviceType, DeviceSerialNumber, UnassociatedOnly, and ConnectionStatus (ONLINE and OFFLINE).

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of devices. Supported sort keys are DeviceName, DeviceStatus, RoomName, DeviceType, DeviceSerialNumber, and ConnectionStatus.

" - } - } - }, - "SearchDevicesResponse":{ - "type":"structure", - "members":{ - "Devices":{ - "shape":"DeviceDataList", - "documentation":"

The devices that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of devices returned.

" - } - } - }, - "SearchProfilesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of room profiles. Supported filter keys are ProfileName and Address. Required.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of room profiles. Supported sort keys are ProfileName and Address.

" - } - } - }, - "SearchProfilesResponse":{ - "type":"structure", - "members":{ - "Profiles":{ - "shape":"ProfileDataList", - "documentation":"

The profiles that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of room profiles returned.

" - } - } - }, - "SearchRoomsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of rooms. The supported filter keys are RoomName and ProfileName.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of rooms. The supported sort keys are RoomName and ProfileName.

" - } - } - }, - "SearchRoomsResponse":{ - "type":"structure", - "members":{ - "Rooms":{ - "shape":"RoomDataList", - "documentation":"

The rooms that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of rooms returned.

" - } - } - }, - "SearchSkillGroupsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use to list a specified set of skill groups. The supported filter key is SkillGroupName.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the specified set of skill groups. The supported sort key is SkillGroupName.

" - } - } - }, - "SearchSkillGroupsResponse":{ - "type":"structure", - "members":{ - "SkillGroups":{ - "shape":"SkillGroupDataList", - "documentation":"

The skill groups that meet the filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of skill groups returned.

" - } - } - }, - "SearchUsersRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

" - }, - "SortCriteria":{ - "shape":"SortList", - "documentation":"

The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

" - } - } - }, - "SearchUsersResponse":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"UserDataList", - "documentation":"

The users that meet the specified set of filter criteria, in sort order.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned to indicate that there is more data available.

" - }, - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of users returned.

" - } - } - }, - "SendInvitationRequest":{ - "type":"structure", - "members":{ - "UserArn":{ - "shape":"Arn", - "documentation":"

The ARN of the user to whom to send an invitation. Required.

" - } - } - }, - "SendInvitationResponse":{ - "type":"structure", - "members":{ - } - }, - "SkillGroup":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of a skill group.

" - }, - "SkillGroupName":{ - "shape":"SkillGroupName", - "documentation":"

The name of a skill group.

" - }, - "Description":{ - "shape":"SkillGroupDescription", - "documentation":"

The description of a skill group.

" - } - }, - "documentation":"

A skill group with attributes.

" - }, - "SkillGroupData":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The skill group ARN of a skill group.

" - }, - "SkillGroupName":{ - "shape":"SkillGroupName", - "documentation":"

The skill group name of a skill group.

" - }, - "Description":{ - "shape":"SkillGroupDescription", - "documentation":"

The description of a skill group.

" - } - }, - "documentation":"

The attributes of a skill group.

" - }, - "SkillGroupDataList":{ - "type":"list", - "member":{"shape":"SkillGroupData"} - }, - "SkillGroupDescription":{ - "type":"string", - "max":200, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "SkillGroupName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "SkillId":{ - "type":"string", - "pattern":"(^amzn1\\.ask\\.skill\\.[0-9a-f\\-]{1,200})|(^amzn1\\.echo-sdk-ams\\.app\\.[0-9a-f\\-]{1,200})" - }, - "SkillListMaxResults":{ - "type":"integer", - "max":10, - "min":1 - }, - "SkillName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" - }, - "SkillSummary":{ - "type":"structure", - "members":{ - "SkillId":{ - "shape":"SkillId", - "documentation":"

The ARN of the skill summary.

" - }, - "SkillName":{ - "shape":"SkillName", - "documentation":"

The name of the skill.

" - }, - "SupportsLinking":{ - "shape":"boolean", - "documentation":"

Linking support for a skill.

" - } - }, - "documentation":"

The summary of skills.

" - }, - "SkillSummaryList":{ - "type":"list", - "member":{"shape":"SkillSummary"} - }, - "SoftwareVersion":{"type":"string"}, - "Sort":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"SortKey", - "documentation":"

The sort key of a sort object.

" - }, - "Value":{ - "shape":"SortValue", - "documentation":"

The sort value of a sort object.

" - } - }, - "documentation":"

An object representing a sort criteria.

" - }, - "SortKey":{ - "type":"string", - "max":500, - "min":1 - }, - "SortList":{ - "type":"list", - "member":{"shape":"Sort"}, - "max":25 - }, - "SortValue":{ - "type":"string", - "enum":[ - "ASC", - "DESC" - ] - }, - "StartDeviceSyncRequest":{ - "type":"structure", - "required":["Features"], - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room with which the device to sync is associated. Required.

" - }, - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the device to sync. Required.

" - }, - "Features":{ - "shape":"Features", - "documentation":"

Request structure to start the device sync. Required.

" - } - } - }, - "StartDeviceSyncResponse":{ - "type":"structure", - "members":{ - } - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of a tag. Tag keys are case-sensitive.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of a tag. Tag values are case-sensitive and can be null.

" - } - }, - "documentation":"

A key-value pair that can be associated with a resource.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Arn", - "Tags" - ], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource to which to add metadata tags. Required.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be added to the specified resource. Do not provide system tags. Required.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TemperatureUnit":{ - "type":"string", - "enum":[ - "FAHRENHEIT", - "CELSIUS" - ] - }, - "Timestamp":{"type":"timestamp"}, - "Timezone":{ - "type":"string", - "max":100, - "min":1 - }, - "TotalCount":{"type":"integer"}, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Arn", - "TagKeys" - ], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource from which to remove metadata tags. Required.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The tags to be removed from the specified resource. Do not provide system tags. Required.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateAddressBookRequest":{ - "type":"structure", - "required":["AddressBookArn"], - "members":{ - "AddressBookArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room to update.

" - }, - "Name":{ - "shape":"AddressBookName", - "documentation":"

The updated name of the room.

" - }, - "Description":{ - "shape":"AddressBookDescription", - "documentation":"

The updated description of the room.

" - } - } - }, - "UpdateAddressBookResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateContactRequest":{ - "type":"structure", - "required":["ContactArn"], - "members":{ - "ContactArn":{ - "shape":"Arn", - "documentation":"

The ARN of the contact to update.

" - }, - "DisplayName":{ - "shape":"ContactName", - "documentation":"

The updated display name of the contact.

" - }, - "FirstName":{ - "shape":"ContactName", - "documentation":"

The updated first name of the contact.

" - }, - "LastName":{ - "shape":"ContactName", - "documentation":"

The updated last name of the contact.

" - }, - "PhoneNumber":{ - "shape":"E164PhoneNumber", - "documentation":"

The updated phone number of the contact.

" - } - } - }, - "UpdateContactResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateDeviceRequest":{ - "type":"structure", - "members":{ - "DeviceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the device to update. Required.

" - }, - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The updated device name. Required.

" - } - } - }, - "UpdateDeviceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateProfileRequest":{ - "type":"structure", - "members":{ - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room profile to update. Required.

" - }, - "ProfileName":{ - "shape":"ProfileName", - "documentation":"

The updated name for the room profile.

" - }, - "Timezone":{ - "shape":"Timezone", - "documentation":"

The updated timezone for the room profile.

" - }, - "Address":{ - "shape":"Address", - "documentation":"

The updated address for the room profile.

" - }, - "DistanceUnit":{ - "shape":"DistanceUnit", - "documentation":"

The updated distance unit for the room profile.

" - }, - "TemperatureUnit":{ - "shape":"TemperatureUnit", - "documentation":"

The updated temperature unit for the room profile.

" - }, - "WakeWord":{ - "shape":"WakeWord", - "documentation":"

The updated wake word for the room profile.

" - }, - "SetupModeDisabled":{ - "shape":"Boolean", - "documentation":"

Whether the setup mode of the profile is enabled.

" - }, - "MaxVolumeLimit":{ - "shape":"MaxVolumeLimit", - "documentation":"

The updated maximum volume limit for the room profile.

" - }, - "PSTNEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the PSTN setting of the room profile is enabled.

" - } - } - }, - "UpdateProfileResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateRoomRequest":{ - "type":"structure", - "members":{ - "RoomArn":{ - "shape":"Arn", - "documentation":"

The ARN of the room to update.

" - }, - "RoomName":{ - "shape":"RoomName", - "documentation":"

The updated name for the room.

" - }, - "Description":{ - "shape":"RoomDescription", - "documentation":"

The updated description for the room.

" - }, - "ProviderCalendarId":{ - "shape":"ProviderCalendarId", - "documentation":"

The updated provider calendar ARN for the room.

" - }, - "ProfileArn":{ - "shape":"Arn", - "documentation":"

The updated profile ARN for the room.

" - } - } - }, - "UpdateRoomResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateSkillGroupRequest":{ - "type":"structure", - "members":{ - "SkillGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the skill group to update.

" - }, - "SkillGroupName":{ - "shape":"SkillGroupName", - "documentation":"

The updated name for the skill group.

" - }, - "Description":{ - "shape":"SkillGroupDescription", - "documentation":"

The updated description for the skill group.

" - } - } - }, - "UpdateSkillGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "UserData":{ - "type":"structure", - "members":{ - "UserArn":{ - "shape":"Arn", - "documentation":"

The ARN of a user.

" - }, - "FirstName":{ - "shape":"user_FirstName", - "documentation":"

The first name of a user.

" - }, - "LastName":{ - "shape":"user_LastName", - "documentation":"

The last name of a user.

" - }, - "Email":{ - "shape":"Email", - "documentation":"

The email of a user.

" - }, - "EnrollmentStatus":{ - "shape":"EnrollmentStatus", - "documentation":"

The enrollment status of a user.

" - }, - "EnrollmentId":{ - "shape":"EnrollmentId", - "documentation":"

The enrollment ARN of a user.

" - } - }, - "documentation":"

Information related to a user.

" - }, - "UserDataList":{ - "type":"list", - "member":{"shape":"UserData"} - }, - "UserId":{ - "type":"string", - "pattern":"amzn1\\.[A-Za-z0-9+-\\/=.]{1,300}" - }, - "WakeWord":{ - "type":"string", - "enum":[ - "ALEXA", - "AMAZON", - "ECHO", - "COMPUTER" - ] - }, - "boolean":{"type":"boolean"}, - "user_FirstName":{ - "type":"string", - "max":30, - "min":0, - "pattern":"([A-Za-z\\-' 0-9._]|\\p{IsLetter})*" - }, - "user_LastName":{ - "type":"string", - "max":30, - "min":0, - "pattern":"([A-Za-z\\-' 0-9._]|\\p{IsLetter})*" - }, - "user_UserId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9@_+.-]*" - } - }, - "documentation":"

Alexa for Business makes it easy for you to use Alexa in your organization. Alexa for Business gives you the tools you need for managing Alexa devices, enroll your users, and assign skills, at scale. You can build your own context-aware voice skills using the Alexa Skills Kit and the Alexa for Business API operations. You can make also these available as private skills for your organization. Alexa for Business makes it easy to voice-enable your products and services, providing context-aware voice experiences for your customers.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/paginators-1.json deleted file mode 100644 index c7a44f17..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/paginators-1.json +++ /dev/null @@ -1,76 +0,0 @@ -{ - "pagination": { - "GetApiKeys": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetBasePathMappings": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetClientCertificates": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetDeployments": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetDomainNames": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetModels": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetResources": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetRestApis": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetUsage": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetUsagePlans": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetUsagePlanKeys": { - "input_token": "position", - "output_token": "position", - "limit_key": "limit", - "result_key": "items" - }, - "GetVpcLinks": { - "input_token": "position", - "limit_key": "limit", - "output_token": "position", - "result_key": "items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/service-2.json deleted file mode 100644 index cc0dc9f6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/apigateway/2015-07-09/service-2.json +++ /dev/null @@ -1,7026 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-07-09", - "endpointPrefix":"apigateway", - "protocol":"rest-json", - "serviceFullName":"Amazon API Gateway", - "serviceId":"API Gateway", - "signatureVersion":"v4", - "uid":"apigateway-2015-07-09" - }, - "operations":{ - "CreateApiKey":{ - "name":"CreateApiKey", - "http":{ - "method":"POST", - "requestUri":"/apikeys", - "responseCode":201 - }, - "input":{"shape":"CreateApiKeyRequest"}, - "output":{"shape":"ApiKey"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Create an ApiKey resource.

" - }, - "CreateAuthorizer":{ - "name":"CreateAuthorizer", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/authorizers", - "responseCode":201 - }, - "input":{"shape":"CreateAuthorizerRequest"}, - "output":{"shape":"Authorizer"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Adds a new Authorizer resource to an existing RestApi resource.

" - }, - "CreateBasePathMapping":{ - "name":"CreateBasePathMapping", - "http":{ - "method":"POST", - "requestUri":"/domainnames/{domain_name}/basepathmappings", - "responseCode":201 - }, - "input":{"shape":"CreateBasePathMappingRequest"}, - "output":{"shape":"BasePathMapping"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a new BasePathMapping resource.

" - }, - "CreateDeployment":{ - "name":"CreateDeployment", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/deployments", - "responseCode":201 - }, - "input":{"shape":"CreateDeploymentRequest"}, - "output":{"shape":"Deployment"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a Deployment resource, which makes a specified RestApi callable over the internet.

" - }, - "CreateDocumentationPart":{ - "name":"CreateDocumentationPart", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/documentation/parts", - "responseCode":201 - }, - "input":{"shape":"CreateDocumentationPartRequest"}, - "output":{"shape":"DocumentationPart"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "CreateDocumentationVersion":{ - "name":"CreateDocumentationVersion", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/documentation/versions", - "responseCode":201 - }, - "input":{"shape":"CreateDocumentationVersionRequest"}, - "output":{"shape":"DocumentationVersion"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "CreateDomainName":{ - "name":"CreateDomainName", - "http":{ - "method":"POST", - "requestUri":"/domainnames", - "responseCode":201 - }, - "input":{"shape":"CreateDomainNameRequest"}, - "output":{"shape":"DomainName"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a new domain name.

" - }, - "CreateModel":{ - "name":"CreateModel", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/models", - "responseCode":201 - }, - "input":{"shape":"CreateModelRequest"}, - "output":{"shape":"Model"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Adds a new Model resource to an existing RestApi resource.

" - }, - "CreateRequestValidator":{ - "name":"CreateRequestValidator", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/requestvalidators", - "responseCode":201 - }, - "input":{"shape":"CreateRequestValidatorRequest"}, - "output":{"shape":"RequestValidator"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a ReqeustValidator of a given RestApi.

" - }, - "CreateResource":{ - "name":"CreateResource", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/resources/{parent_id}", - "responseCode":201 - }, - "input":{"shape":"CreateResourceRequest"}, - "output":{"shape":"Resource"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a Resource resource.

" - }, - "CreateRestApi":{ - "name":"CreateRestApi", - "http":{ - "method":"POST", - "requestUri":"/restapis", - "responseCode":201 - }, - "input":{"shape":"CreateRestApiRequest"}, - "output":{"shape":"RestApi"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a new RestApi resource.

" - }, - "CreateStage":{ - "name":"CreateStage", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/stages", - "responseCode":201 - }, - "input":{"shape":"CreateStageRequest"}, - "output":{"shape":"Stage"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a new Stage resource that references a pre-existing Deployment for the API.

" - }, - "CreateUsagePlan":{ - "name":"CreateUsagePlan", - "http":{ - "method":"POST", - "requestUri":"/usageplans", - "responseCode":201 - }, - "input":{"shape":"CreateUsagePlanRequest"}, - "output":{"shape":"UsagePlan"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.

" - }, - "CreateUsagePlanKey":{ - "name":"CreateUsagePlanKey", - "http":{ - "method":"POST", - "requestUri":"/usageplans/{usageplanId}/keys", - "responseCode":201 - }, - "input":{"shape":"CreateUsagePlanKeyRequest"}, - "output":{"shape":"UsagePlanKey"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a usage plan key for adding an existing API key to a usage plan.

" - }, - "CreateVpcLink":{ - "name":"CreateVpcLink", - "http":{ - "method":"POST", - "requestUri":"/vpclinks", - "responseCode":202 - }, - "input":{"shape":"CreateVpcLinkRequest"}, - "output":{"shape":"VpcLink"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.

" - }, - "DeleteApiKey":{ - "name":"DeleteApiKey", - "http":{ - "method":"DELETE", - "requestUri":"/apikeys/{api_Key}", - "responseCode":202 - }, - "input":{"shape":"DeleteApiKeyRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the ApiKey resource.

" - }, - "DeleteAuthorizer":{ - "name":"DeleteAuthorizer", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteAuthorizerRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Deletes an existing Authorizer resource.

" - }, - "DeleteBasePathMapping":{ - "name":"DeleteBasePathMapping", - "http":{ - "method":"DELETE", - "requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}", - "responseCode":202 - }, - "input":{"shape":"DeleteBasePathMappingRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the BasePathMapping resource.

" - }, - "DeleteClientCertificate":{ - "name":"DeleteClientCertificate", - "http":{ - "method":"DELETE", - "requestUri":"/clientcertificates/{clientcertificate_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteClientCertificateRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes the ClientCertificate resource.

" - }, - "DeleteDeployment":{ - "name":"DeleteDeployment", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteDeploymentRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.

" - }, - "DeleteDocumentationPart":{ - "name":"DeleteDocumentationPart", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/documentation/parts/{part_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteDocumentationPartRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"} - ] - }, - "DeleteDocumentationVersion":{ - "name":"DeleteDocumentationVersion", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/documentation/versions/{doc_version}", - "responseCode":202 - }, - "input":{"shape":"DeleteDocumentationVersionRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "DeleteDomainName":{ - "name":"DeleteDomainName", - "http":{ - "method":"DELETE", - "requestUri":"/domainnames/{domain_name}", - "responseCode":202 - }, - "input":{"shape":"DeleteDomainNameRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the DomainName resource.

" - }, - "DeleteGatewayResponse":{ - "name":"DeleteGatewayResponse", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/gatewayresponses/{response_type}", - "responseCode":202 - }, - "input":{"shape":"DeleteGatewayResponseRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.

" - }, - "DeleteIntegration":{ - "name":"DeleteIntegration", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration", - "responseCode":204 - }, - "input":{"shape":"DeleteIntegrationRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Represents a delete integration.

" - }, - "DeleteIntegrationResponse":{ - "name":"DeleteIntegrationResponse", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}", - "responseCode":204 - }, - "input":{"shape":"DeleteIntegrationResponseRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Represents a delete integration response.

" - }, - "DeleteMethod":{ - "name":"DeleteMethod", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}", - "responseCode":204 - }, - "input":{"shape":"DeleteMethodRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Deletes an existing Method resource.

" - }, - "DeleteMethodResponse":{ - "name":"DeleteMethodResponse", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}", - "responseCode":204 - }, - "input":{"shape":"DeleteMethodResponseRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Deletes an existing MethodResponse resource.

" - }, - "DeleteModel":{ - "name":"DeleteModel", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/models/{model_name}", - "responseCode":202 - }, - "input":{"shape":"DeleteModelRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Deletes a model.

" - }, - "DeleteRequestValidator":{ - "name":"DeleteRequestValidator", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteRequestValidatorRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Deletes a RequestValidator of a given RestApi.

" - }, - "DeleteResource":{ - "name":"DeleteResource", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteResourceRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes a Resource resource.

" - }, - "DeleteRestApi":{ - "name":"DeleteRestApi", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteRestApiRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Deletes the specified API.

" - }, - "DeleteStage":{ - "name":"DeleteStage", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}", - "responseCode":202 - }, - "input":{"shape":"DeleteStageRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Deletes a Stage resource.

" - }, - "DeleteUsagePlan":{ - "name":"DeleteUsagePlan", - "http":{ - "method":"DELETE", - "requestUri":"/usageplans/{usageplanId}", - "responseCode":202 - }, - "input":{"shape":"DeleteUsagePlanRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a usage plan of a given plan Id.

" - }, - "DeleteUsagePlanKey":{ - "name":"DeleteUsagePlanKey", - "http":{ - "method":"DELETE", - "requestUri":"/usageplans/{usageplanId}/keys/{keyId}", - "responseCode":202 - }, - "input":{"shape":"DeleteUsagePlanKeyRequest"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes a usage plan key and remove the underlying API key from the associated usage plan.

" - }, - "DeleteVpcLink":{ - "name":"DeleteVpcLink", - "http":{ - "method":"DELETE", - "requestUri":"/vpclinks/{vpclink_id}", - "responseCode":202 - }, - "input":{"shape":"DeleteVpcLinkRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Deletes an existing VpcLink of a specified identifier.

" - }, - "FlushStageAuthorizersCache":{ - "name":"FlushStageAuthorizersCache", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}/cache/authorizers", - "responseCode":202 - }, - "input":{"shape":"FlushStageAuthorizersCacheRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Flushes all authorizer cache entries on a stage.

" - }, - "FlushStageCache":{ - "name":"FlushStageCache", - "http":{ - "method":"DELETE", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}/cache/data", - "responseCode":202 - }, - "input":{"shape":"FlushStageCacheRequest"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Flushes a stage's cache.

" - }, - "GenerateClientCertificate":{ - "name":"GenerateClientCertificate", - "http":{ - "method":"POST", - "requestUri":"/clientcertificates", - "responseCode":201 - }, - "input":{"shape":"GenerateClientCertificateRequest"}, - "output":{"shape":"ClientCertificate"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Generates a ClientCertificate resource.

" - }, - "GetAccount":{ - "name":"GetAccount", - "http":{ - "method":"GET", - "requestUri":"/account" - }, - "input":{"shape":"GetAccountRequest"}, - "output":{"shape":"Account"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about the current Account resource.

" - }, - "GetApiKey":{ - "name":"GetApiKey", - "http":{ - "method":"GET", - "requestUri":"/apikeys/{api_Key}" - }, - "input":{"shape":"GetApiKeyRequest"}, - "output":{"shape":"ApiKey"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about the current ApiKey resource.

" - }, - "GetApiKeys":{ - "name":"GetApiKeys", - "http":{ - "method":"GET", - "requestUri":"/apikeys" - }, - "input":{"shape":"GetApiKeysRequest"}, - "output":{"shape":"ApiKeys"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about the current ApiKeys resource.

" - }, - "GetAuthorizer":{ - "name":"GetAuthorizer", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}" - }, - "input":{"shape":"GetAuthorizerRequest"}, - "output":{"shape":"Authorizer"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describe an existing Authorizer resource.

" - }, - "GetAuthorizers":{ - "name":"GetAuthorizers", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/authorizers" - }, - "input":{"shape":"GetAuthorizersRequest"}, - "output":{"shape":"Authorizers"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describe an existing Authorizers resource.

" - }, - "GetBasePathMapping":{ - "name":"GetBasePathMapping", - "http":{ - "method":"GET", - "requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}" - }, - "input":{"shape":"GetBasePathMappingRequest"}, - "output":{"shape":"BasePathMapping"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describe a BasePathMapping resource.

" - }, - "GetBasePathMappings":{ - "name":"GetBasePathMappings", - "http":{ - "method":"GET", - "requestUri":"/domainnames/{domain_name}/basepathmappings" - }, - "input":{"shape":"GetBasePathMappingsRequest"}, - "output":{"shape":"BasePathMappings"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Represents a collection of BasePathMapping resources.

" - }, - "GetClientCertificate":{ - "name":"GetClientCertificate", - "http":{ - "method":"GET", - "requestUri":"/clientcertificates/{clientcertificate_id}" - }, - "input":{"shape":"GetClientCertificateRequest"}, - "output":{"shape":"ClientCertificate"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about the current ClientCertificate resource.

" - }, - "GetClientCertificates":{ - "name":"GetClientCertificates", - "http":{ - "method":"GET", - "requestUri":"/clientcertificates" - }, - "input":{"shape":"GetClientCertificatesRequest"}, - "output":{"shape":"ClientCertificates"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a collection of ClientCertificate resources.

" - }, - "GetDeployment":{ - "name":"GetDeployment", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}" - }, - "input":{"shape":"GetDeploymentRequest"}, - "output":{"shape":"Deployment"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Gets information about a Deployment resource.

" - }, - "GetDeployments":{ - "name":"GetDeployments", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/deployments" - }, - "input":{"shape":"GetDeploymentsRequest"}, - "output":{"shape":"Deployments"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Gets information about a Deployments collection.

" - }, - "GetDocumentationPart":{ - "name":"GetDocumentationPart", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/documentation/parts/{part_id}" - }, - "input":{"shape":"GetDocumentationPartRequest"}, - "output":{"shape":"DocumentationPart"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetDocumentationParts":{ - "name":"GetDocumentationParts", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/documentation/parts" - }, - "input":{"shape":"GetDocumentationPartsRequest"}, - "output":{"shape":"DocumentationParts"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetDocumentationVersion":{ - "name":"GetDocumentationVersion", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/documentation/versions/{doc_version}" - }, - "input":{"shape":"GetDocumentationVersionRequest"}, - "output":{"shape":"DocumentationVersion"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetDocumentationVersions":{ - "name":"GetDocumentationVersions", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/documentation/versions" - }, - "input":{"shape":"GetDocumentationVersionsRequest"}, - "output":{"shape":"DocumentationVersions"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetDomainName":{ - "name":"GetDomainName", - "http":{ - "method":"GET", - "requestUri":"/domainnames/{domain_name}" - }, - "input":{"shape":"GetDomainNameRequest"}, - "output":{"shape":"DomainName"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Represents a domain name that is contained in a simpler, more intuitive URL that can be called.

" - }, - "GetDomainNames":{ - "name":"GetDomainNames", - "http":{ - "method":"GET", - "requestUri":"/domainnames" - }, - "input":{"shape":"GetDomainNamesRequest"}, - "output":{"shape":"DomainNames"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Represents a collection of DomainName resources.

" - }, - "GetExport":{ - "name":"GetExport", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}/exports/{export_type}", - "responseCode":200 - }, - "input":{"shape":"GetExportRequest"}, - "output":{"shape":"ExportResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Exports a deployed version of a RestApi in a specified format.

" - }, - "GetGatewayResponse":{ - "name":"GetGatewayResponse", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/gatewayresponses/{response_type}" - }, - "input":{"shape":"GetGatewayResponseRequest"}, - "output":{"shape":"GatewayResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a GatewayResponse of a specified response type on the given RestApi.

" - }, - "GetGatewayResponses":{ - "name":"GetGatewayResponses", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/gatewayresponses" - }, - "input":{"shape":"GetGatewayResponsesRequest"}, - "output":{"shape":"GatewayResponses"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.

" - }, - "GetIntegration":{ - "name":"GetIntegration", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration" - }, - "input":{"shape":"GetIntegrationRequest"}, - "output":{"shape":"Integration"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Get the integration settings.

" - }, - "GetIntegrationResponse":{ - "name":"GetIntegrationResponse", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}" - }, - "input":{"shape":"GetIntegrationResponseRequest"}, - "output":{"shape":"IntegrationResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Represents a get integration response.

" - }, - "GetMethod":{ - "name":"GetMethod", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}" - }, - "input":{"shape":"GetMethodRequest"}, - "output":{"shape":"Method"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describe an existing Method resource.

" - }, - "GetMethodResponse":{ - "name":"GetMethodResponse", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}" - }, - "input":{"shape":"GetMethodResponseRequest"}, - "output":{"shape":"MethodResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describes a MethodResponse resource.

" - }, - "GetModel":{ - "name":"GetModel", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/models/{model_name}" - }, - "input":{"shape":"GetModelRequest"}, - "output":{"shape":"Model"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describes an existing model defined for a RestApi resource.

" - }, - "GetModelTemplate":{ - "name":"GetModelTemplate", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/models/{model_name}/default_template" - }, - "input":{"shape":"GetModelTemplateRequest"}, - "output":{"shape":"Template"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Generates a sample mapping template that can be used to transform a payload into the structure of a model.

" - }, - "GetModels":{ - "name":"GetModels", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/models" - }, - "input":{"shape":"GetModelsRequest"}, - "output":{"shape":"Models"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Describes existing Models defined for a RestApi resource.

" - }, - "GetRequestValidator":{ - "name":"GetRequestValidator", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}" - }, - "input":{"shape":"GetRequestValidatorRequest"}, - "output":{"shape":"RequestValidator"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a RequestValidator of a given RestApi.

" - }, - "GetRequestValidators":{ - "name":"GetRequestValidators", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/requestvalidators" - }, - "input":{"shape":"GetRequestValidatorsRequest"}, - "output":{"shape":"RequestValidators"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets the RequestValidators collection of a given RestApi.

" - }, - "GetResource":{ - "name":"GetResource", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}" - }, - "input":{"shape":"GetResourceRequest"}, - "output":{"shape":"Resource"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists information about a resource.

" - }, - "GetResources":{ - "name":"GetResources", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/resources" - }, - "input":{"shape":"GetResourcesRequest"}, - "output":{"shape":"Resources"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists information about a collection of Resource resources.

" - }, - "GetRestApi":{ - "name":"GetRestApi", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}" - }, - "input":{"shape":"GetRestApiRequest"}, - "output":{"shape":"RestApi"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the RestApi resource in the collection.

" - }, - "GetRestApis":{ - "name":"GetRestApis", - "http":{ - "method":"GET", - "requestUri":"/restapis" - }, - "input":{"shape":"GetRestApisRequest"}, - "output":{"shape":"RestApis"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the RestApis resources for your collection.

" - }, - "GetSdk":{ - "name":"GetSdk", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}/sdks/{sdk_type}", - "responseCode":200 - }, - "input":{"shape":"GetSdkRequest"}, - "output":{"shape":"SdkResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Generates a client SDK for a RestApi and Stage.

" - }, - "GetSdkType":{ - "name":"GetSdkType", - "http":{ - "method":"GET", - "requestUri":"/sdktypes/{sdktype_id}" - }, - "input":{"shape":"GetSdkTypeRequest"}, - "output":{"shape":"SdkType"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetSdkTypes":{ - "name":"GetSdkTypes", - "http":{ - "method":"GET", - "requestUri":"/sdktypes" - }, - "input":{"shape":"GetSdkTypesRequest"}, - "output":{"shape":"SdkTypes"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "GetStage":{ - "name":"GetStage", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}" - }, - "input":{"shape":"GetStageRequest"}, - "output":{"shape":"Stage"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about a Stage resource.

" - }, - "GetStages":{ - "name":"GetStages", - "http":{ - "method":"GET", - "requestUri":"/restapis/{restapi_id}/stages" - }, - "input":{"shape":"GetStagesRequest"}, - "output":{"shape":"Stages"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets information about one or more Stage resources.

" - }, - "GetTags":{ - "name":"GetTags", - "http":{ - "method":"GET", - "requestUri":"/tags/{resource_arn}" - }, - "input":{"shape":"GetTagsRequest"}, - "output":{"shape":"Tags"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Gets the Tags collection for a given resource.

" - }, - "GetUsage":{ - "name":"GetUsage", - "http":{ - "method":"GET", - "requestUri":"/usageplans/{usageplanId}/usage" - }, - "input":{"shape":"GetUsageRequest"}, - "output":{"shape":"Usage"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets the usage data of a usage plan in a specified time interval.

" - }, - "GetUsagePlan":{ - "name":"GetUsagePlan", - "http":{ - "method":"GET", - "requestUri":"/usageplans/{usageplanId}" - }, - "input":{"shape":"GetUsagePlanRequest"}, - "output":{"shape":"UsagePlan"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a usage plan of a given plan identifier.

" - }, - "GetUsagePlanKey":{ - "name":"GetUsagePlanKey", - "http":{ - "method":"GET", - "requestUri":"/usageplans/{usageplanId}/keys/{keyId}", - "responseCode":200 - }, - "input":{"shape":"GetUsagePlanKeyRequest"}, - "output":{"shape":"UsagePlanKey"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a usage plan key of a given key identifier.

" - }, - "GetUsagePlanKeys":{ - "name":"GetUsagePlanKeys", - "http":{ - "method":"GET", - "requestUri":"/usageplans/{usageplanId}/keys" - }, - "input":{"shape":"GetUsagePlanKeysRequest"}, - "output":{"shape":"UsagePlanKeys"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets all the usage plan keys representing the API keys added to a specified usage plan.

" - }, - "GetUsagePlans":{ - "name":"GetUsagePlans", - "http":{ - "method":"GET", - "requestUri":"/usageplans" - }, - "input":{"shape":"GetUsagePlansRequest"}, - "output":{"shape":"UsagePlans"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Gets all the usage plans of the caller's account.

" - }, - "GetVpcLink":{ - "name":"GetVpcLink", - "http":{ - "method":"GET", - "requestUri":"/vpclinks/{vpclink_id}" - }, - "input":{"shape":"GetVpcLinkRequest"}, - "output":{"shape":"VpcLink"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets a specified VPC link under the caller's account in a region.

" - }, - "GetVpcLinks":{ - "name":"GetVpcLinks", - "http":{ - "method":"GET", - "requestUri":"/vpclinks" - }, - "input":{"shape":"GetVpcLinksRequest"}, - "output":{"shape":"VpcLinks"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Gets the VpcLinks collection under the caller's account in a selected region.

" - }, - "ImportApiKeys":{ - "name":"ImportApiKeys", - "http":{ - "method":"POST", - "requestUri":"/apikeys?mode=import", - "responseCode":201 - }, - "input":{"shape":"ImportApiKeysRequest"}, - "output":{"shape":"ApiKeyIds"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Import API keys from an external source, such as a CSV-formatted file.

" - }, - "ImportDocumentationParts":{ - "name":"ImportDocumentationParts", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/documentation/parts" - }, - "input":{"shape":"ImportDocumentationPartsRequest"}, - "output":{"shape":"DocumentationPartIds"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "ImportRestApi":{ - "name":"ImportRestApi", - "http":{ - "method":"POST", - "requestUri":"/restapis?mode=import", - "responseCode":201 - }, - "input":{"shape":"ImportRestApiRequest"}, - "output":{"shape":"RestApi"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

A feature of the API Gateway control service for creating a new API from an external API definition file.

" - }, - "PutGatewayResponse":{ - "name":"PutGatewayResponse", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/gatewayresponses/{response_type}", - "responseCode":201 - }, - "input":{"shape":"PutGatewayResponseRequest"}, - "output":{"shape":"GatewayResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.

" - }, - "PutIntegration":{ - "name":"PutIntegration", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration", - "responseCode":201 - }, - "input":{"shape":"PutIntegrationRequest"}, - "output":{"shape":"Integration"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Sets up a method's integration.

" - }, - "PutIntegrationResponse":{ - "name":"PutIntegrationResponse", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}", - "responseCode":201 - }, - "input":{"shape":"PutIntegrationResponseRequest"}, - "output":{"shape":"IntegrationResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Represents a put integration.

" - }, - "PutMethod":{ - "name":"PutMethod", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}", - "responseCode":201 - }, - "input":{"shape":"PutMethodRequest"}, - "output":{"shape":"Method"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Add a method to an existing Resource resource.

" - }, - "PutMethodResponse":{ - "name":"PutMethodResponse", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}", - "responseCode":201 - }, - "input":{"shape":"PutMethodResponseRequest"}, - "output":{"shape":"MethodResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Adds a MethodResponse to an existing Method resource.

" - }, - "PutRestApi":{ - "name":"PutRestApi", - "http":{ - "method":"PUT", - "requestUri":"/restapis/{restapi_id}" - }, - "input":{"shape":"PutRestApiRequest"}, - "output":{"shape":"RestApi"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

A feature of the API Gateway control service for updating an existing API with an input of external API definitions. The update can take the form of merging the supplied definition into the existing API or overwriting the existing API.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"PUT", - "requestUri":"/tags/{resource_arn}", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Adds or updates a tag on a given resource.

" - }, - "TestInvokeAuthorizer":{ - "name":"TestInvokeAuthorizer", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}" - }, - "input":{"shape":"TestInvokeAuthorizerRequest"}, - "output":{"shape":"TestInvokeAuthorizerResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.

" - }, - "TestInvokeMethod":{ - "name":"TestInvokeMethod", - "http":{ - "method":"POST", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}" - }, - "input":{"shape":"TestInvokeMethodRequest"}, - "output":{"shape":"TestInvokeMethodResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Simulate the execution of a Method in your RestApi with headers, parameters, and an incoming request body.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"DELETE", - "requestUri":"/tags/{resource_arn}", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Removes a tag from a given resource.

" - }, - "UpdateAccount":{ - "name":"UpdateAccount", - "http":{ - "method":"PATCH", - "requestUri":"/account" - }, - "input":{"shape":"UpdateAccountRequest"}, - "output":{"shape":"Account"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about the current Account resource.

" - }, - "UpdateApiKey":{ - "name":"UpdateApiKey", - "http":{ - "method":"PATCH", - "requestUri":"/apikeys/{api_Key}" - }, - "input":{"shape":"UpdateApiKeyRequest"}, - "output":{"shape":"ApiKey"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Changes information about an ApiKey resource.

" - }, - "UpdateAuthorizer":{ - "name":"UpdateAuthorizer", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/authorizers/{authorizer_id}" - }, - "input":{"shape":"UpdateAuthorizerRequest"}, - "output":{"shape":"Authorizer"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates an existing Authorizer resource.

" - }, - "UpdateBasePathMapping":{ - "name":"UpdateBasePathMapping", - "http":{ - "method":"PATCH", - "requestUri":"/domainnames/{domain_name}/basepathmappings/{base_path}" - }, - "input":{"shape":"UpdateBasePathMappingRequest"}, - "output":{"shape":"BasePathMapping"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about the BasePathMapping resource.

" - }, - "UpdateClientCertificate":{ - "name":"UpdateClientCertificate", - "http":{ - "method":"PATCH", - "requestUri":"/clientcertificates/{clientcertificate_id}" - }, - "input":{"shape":"UpdateClientCertificateRequest"}, - "output":{"shape":"ClientCertificate"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Changes information about an ClientCertificate resource.

" - }, - "UpdateDeployment":{ - "name":"UpdateDeployment", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/deployments/{deployment_id}" - }, - "input":{"shape":"UpdateDeploymentRequest"}, - "output":{"shape":"Deployment"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Changes information about a Deployment resource.

" - }, - "UpdateDocumentationPart":{ - "name":"UpdateDocumentationPart", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/documentation/parts/{part_id}" - }, - "input":{"shape":"UpdateDocumentationPartRequest"}, - "output":{"shape":"DocumentationPart"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "UpdateDocumentationVersion":{ - "name":"UpdateDocumentationVersion", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/documentation/versions/{doc_version}" - }, - "input":{"shape":"UpdateDocumentationVersionRequest"}, - "output":{"shape":"DocumentationVersion"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ] - }, - "UpdateDomainName":{ - "name":"UpdateDomainName", - "http":{ - "method":"PATCH", - "requestUri":"/domainnames/{domain_name}" - }, - "input":{"shape":"UpdateDomainNameRequest"}, - "output":{"shape":"DomainName"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about the DomainName resource.

" - }, - "UpdateGatewayResponse":{ - "name":"UpdateGatewayResponse", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/gatewayresponses/{response_type}" - }, - "input":{"shape":"UpdateGatewayResponseRequest"}, - "output":{"shape":"GatewayResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates a GatewayResponse of a specified response type on the given RestApi.

" - }, - "UpdateIntegration":{ - "name":"UpdateIntegration", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration" - }, - "input":{"shape":"UpdateIntegrationRequest"}, - "output":{"shape":"Integration"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Represents an update integration.

" - }, - "UpdateIntegrationResponse":{ - "name":"UpdateIntegrationResponse", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}" - }, - "input":{"shape":"UpdateIntegrationResponseRequest"}, - "output":{"shape":"IntegrationResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Represents an update integration response.

" - }, - "UpdateMethod":{ - "name":"UpdateMethod", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}" - }, - "input":{"shape":"UpdateMethodRequest"}, - "output":{"shape":"Method"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates an existing Method resource.

" - }, - "UpdateMethodResponse":{ - "name":"UpdateMethodResponse", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}", - "responseCode":201 - }, - "input":{"shape":"UpdateMethodResponseRequest"}, - "output":{"shape":"MethodResponse"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates an existing MethodResponse resource.

" - }, - "UpdateModel":{ - "name":"UpdateModel", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/models/{model_name}" - }, - "input":{"shape":"UpdateModelRequest"}, - "output":{"shape":"Model"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about a model.

" - }, - "UpdateRequestValidator":{ - "name":"UpdateRequestValidator", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}" - }, - "input":{"shape":"UpdateRequestValidatorRequest"}, - "output":{"shape":"RequestValidator"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates a RequestValidator of a given RestApi.

" - }, - "UpdateResource":{ - "name":"UpdateResource", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/resources/{resource_id}" - }, - "input":{"shape":"UpdateResourceRequest"}, - "output":{"shape":"Resource"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about a Resource resource.

" - }, - "UpdateRestApi":{ - "name":"UpdateRestApi", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}" - }, - "input":{"shape":"UpdateRestApiRequest"}, - "output":{"shape":"RestApi"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about the specified API.

" - }, - "UpdateStage":{ - "name":"UpdateStage", - "http":{ - "method":"PATCH", - "requestUri":"/restapis/{restapi_id}/stages/{stage_name}" - }, - "input":{"shape":"UpdateStageRequest"}, - "output":{"shape":"Stage"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"BadRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Changes information about a Stage resource.

" - }, - "UpdateUsage":{ - "name":"UpdateUsage", - "http":{ - "method":"PATCH", - "requestUri":"/usageplans/{usageplanId}/keys/{keyId}/usage" - }, - "input":{"shape":"UpdateUsageRequest"}, - "output":{"shape":"Usage"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.

" - }, - "UpdateUsagePlan":{ - "name":"UpdateUsagePlan", - "http":{ - "method":"PATCH", - "requestUri":"/usageplans/{usageplanId}" - }, - "input":{"shape":"UpdateUsagePlanRequest"}, - "output":{"shape":"UsagePlan"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Updates a usage plan of a given plan Id.

" - }, - "UpdateVpcLink":{ - "name":"UpdateVpcLink", - "http":{ - "method":"PATCH", - "requestUri":"/vpclinks/{vpclink_id}" - }, - "input":{"shape":"UpdateVpcLinkRequest"}, - "output":{"shape":"VpcLink"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates an existing VpcLink of a specified identifier.

" - } - }, - "shapes":{ - "AccessLogSettings":{ - "type":"structure", - "members":{ - "format":{ - "shape":"String", - "documentation":"

A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.

" - }, - "destinationArn":{ - "shape":"String", - "documentation":"

The ARN of the CloudWatch Logs log group to receive access logs.

" - } - }, - "documentation":"

Access log settings, including the access log format and access log destination ARN.

" - }, - "Account":{ - "type":"structure", - "members":{ - "cloudwatchRoleArn":{ - "shape":"String", - "documentation":"

The ARN of an Amazon CloudWatch role for the current Account.

" - }, - "throttleSettings":{ - "shape":"ThrottleSettings", - "documentation":"

Specifies the API request limits configured for the current Account.

" - }, - "features":{ - "shape":"ListOfString", - "documentation":"

A list of features supported for the account. When usage plans are enabled, the features list will include an entry of \"UsagePlans\".

" - }, - "apiKeyVersion":{ - "shape":"String", - "documentation":"

The version of the API keys used for the account.

" - } - }, - "documentation":"

Represents an AWS account that is associated with API Gateway.

To view the account info, call GET on this resource.

Error Codes

The following exception may be thrown when the request fails.

  • UnauthorizedException
  • NotFoundException
  • TooManyRequestsException

For detailed error code information, including the corresponding HTTP Status Codes, see API Gateway Error Codes

Example: Get the information about an account.

Request
GET /account HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160531T184618Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} 
Response

The successful response returns a 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/account-apigateway-{rel}.html\", \"name\": \"account\", \"templated\": true }, \"self\": { \"href\": \"/account\" }, \"account:update\": { \"href\": \"/account\" } }, \"cloudwatchRoleArn\": \"arn:aws:iam::123456789012:role/apigAwsProxyRole\", \"throttleSettings\": { \"rateLimit\": 500, \"burstLimit\": 1000 } } 

In addition to making the REST API call directly, you can use the AWS CLI and an AWS SDK to access this resource.

" - }, - "ApiKey":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier of the API Key.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of the API Key.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the API Key.

" - }, - "customerId":{ - "shape":"String", - "documentation":"

An AWS Marketplace customer identifier , when integrating with the AWS SaaS Marketplace.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the API Key.

" - }, - "enabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether the API Key can be used by callers.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the API Key was created.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the API Key was last updated.

" - }, - "stageKeys":{ - "shape":"ListOfString", - "documentation":"

A list of Stage resources that are associated with the ApiKey resource.

" - } - }, - "documentation":"

A resource that can be distributed to callers for executing Method resources that require an API key. API keys can be mapped to any Stage on any RestApi, which indicates that the callers with the API key can make requests to that stage.

" - }, - "ApiKeyIds":{ - "type":"structure", - "members":{ - "ids":{ - "shape":"ListOfString", - "documentation":"

A list of all the ApiKey identifiers.

" - }, - "warnings":{ - "shape":"ListOfString", - "documentation":"

A list of warning messages.

" - } - }, - "documentation":"

The identifier of an ApiKey used in a UsagePlan.

" - }, - "ApiKeySourceType":{ - "type":"string", - "enum":[ - "HEADER", - "AUTHORIZER" - ] - }, - "ApiKeys":{ - "type":"structure", - "members":{ - "warnings":{ - "shape":"ListOfString", - "documentation":"

A list of warning messages logged during the import of API keys when the failOnWarnings option is set to true.

" - }, - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfApiKey", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of API keys as represented by an ApiKeys resource.

" - }, - "ApiKeysFormat":{ - "type":"string", - "enum":["csv"] - }, - "ApiStage":{ - "type":"structure", - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

API Id of the associated API stage in a usage plan.

" - }, - "stage":{ - "shape":"String", - "documentation":"

API stage name of the associated API stage in a usage plan.

" - }, - "throttle":{ - "shape":"MapOfApiStageThrottleSettings", - "documentation":"

Map containing method level throttling information for API stage in a usage plan.

" - } - }, - "documentation":"

API stage name of the associated API stage in a usage plan.

" - }, - "Authorizer":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier for the authorizer resource.

" - }, - "name":{ - "shape":"String", - "documentation":"

[Required] The name of the authorizer.

" - }, - "type":{ - "shape":"AuthorizerType", - "documentation":"

The authorizer type. Valid values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, and COGNITO_USER_POOLS for using an Amazon Cognito user pool.

" - }, - "providerARNs":{ - "shape":"ListOfARNs", - "documentation":"

A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. For a TOKEN or REQUEST authorizer, this is not defined.

" - }, - "authType":{ - "shape":"String", - "documentation":"

Optional customer-defined field, used in Swagger imports and exports without functional impact.

" - }, - "authorizerUri":{ - "shape":"String", - "documentation":"

Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

" - }, - "authorizerCredentials":{ - "shape":"String", - "documentation":"

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

" - }, - "identitySource":{ - "shape":"String", - "documentation":"

The identity source for which authorization is requested.

  • For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies the request header mapping expression for the custom header holding the authorization token submitted by the client. For example, if the token header name is Auth, the header mapping expression is method.request.header.Auth.
  • For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header, a Name query string parameter are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

" - }, - "identityValidationExpression":{ - "shape":"String", - "documentation":"

A validation expression for the incoming identity token. For TOKEN authorizers, this value is a regular expression. API Gateway will match the aud field of the incoming token from the client against the specified regular expression. It will invoke the authorizer's Lambda function when there is a match. Otherwise, it will return a 401 Unauthorized response without calling the Lambda function. The validation expression does not apply to the REQUEST authorizer.

" - }, - "authorizerResultTtlInSeconds":{ - "shape":"NullableInteger", - "documentation":"

The TTL in seconds of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

" - } - }, - "documentation":"

Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.

" - }, - "AuthorizerType":{ - "type":"string", - "documentation":"

The authorizer type. Valid values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, and COGNITO_USER_POOLS for using an Amazon Cognito user pool.

", - "enum":[ - "TOKEN", - "REQUEST", - "COGNITO_USER_POOLS" - ] - }, - "Authorizers":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfAuthorizer", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of Authorizer resources.

" - }, - "BadRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The submitted request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "BasePathMapping":{ - "type":"structure", - "members":{ - "basePath":{ - "shape":"String", - "documentation":"

The base path name that callers of the API must provide as part of the URL after the domain name.

" - }, - "restApiId":{ - "shape":"String", - "documentation":"

The string identifier of the associated RestApi.

" - }, - "stage":{ - "shape":"String", - "documentation":"

The name of the associated stage.

" - } - }, - "documentation":"

Represents the base path that callers of the API must provide as part of the URL after the domain name.

A custom domain name plus a BasePathMapping specification identifies a deployed RestApi in a given stage of the owner Account.
" - }, - "BasePathMappings":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfBasePathMapping", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of BasePathMapping resources.

" - }, - "Blob":{"type":"blob"}, - "Boolean":{"type":"boolean"}, - "CacheClusterSize":{ - "type":"string", - "documentation":"

Returns the size of the CacheCluster.

", - "enum":[ - "0.5", - "1.6", - "6.1", - "13.5", - "28.4", - "58.2", - "118", - "237" - ] - }, - "CacheClusterStatus":{ - "type":"string", - "documentation":"

Returns the status of the CacheCluster.

", - "enum":[ - "CREATE_IN_PROGRESS", - "AVAILABLE", - "DELETE_IN_PROGRESS", - "NOT_AVAILABLE", - "FLUSH_IN_PROGRESS" - ] - }, - "CanarySettings":{ - "type":"structure", - "members":{ - "percentTraffic":{ - "shape":"Double", - "documentation":"

The percent (0-100) of traffic diverted to a canary deployment.

" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

The ID of the canary deployment.

" - }, - "stageVariableOverrides":{ - "shape":"MapOfStringToString", - "documentation":"

Stage variables overridden for a canary release deployment, including new stage variables introduced in the canary. These stage variables are represented as a string-to-string map between stage variable names and their values.

" - }, - "useStageCache":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether the canary deployment uses the stage cache or not.

" - } - }, - "documentation":"

Configuration settings of a canary deployment.

" - }, - "ClientCertificate":{ - "type":"structure", - "members":{ - "clientCertificateId":{ - "shape":"String", - "documentation":"

The identifier of the client certificate.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the client certificate.

" - }, - "pemEncodedCertificate":{ - "shape":"String", - "documentation":"

The PEM-encoded public key of the client certificate, which can be used to configure certificate authentication in the integration endpoint .

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the client certificate was created.

" - }, - "expirationDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the client certificate will expire.

" - } - }, - "documentation":"

Represents a client certificate used to configure client-side SSL authentication while sending requests to the integration endpoint.

Client certificates are used to authenticate an API by the backend server. To authenticate an API client (or user), use IAM roles and policies, a custom Authorizer or an Amazon Cognito user pool.
" - }, - "ClientCertificates":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfClientCertificate", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of ClientCertificate resources.

" - }, - "ConflictException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request configuration has conflicts. For details, see the accompanying error message.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ConnectionType":{ - "type":"string", - "enum":[ - "INTERNET", - "VPC_LINK" - ] - }, - "ContentHandlingStrategy":{ - "type":"string", - "enum":[ - "CONVERT_TO_BINARY", - "CONVERT_TO_TEXT" - ] - }, - "CreateApiKeyRequest":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the ApiKey.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the ApiKey.

" - }, - "enabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether the ApiKey can be used by callers.

" - }, - "generateDistinctId":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) the key identifier is distinct from the created API key value.

" - }, - "value":{ - "shape":"String", - "documentation":"

Specifies a value of the API key.

" - }, - "stageKeys":{ - "shape":"ListOfStageKeys", - "documentation":"

DEPRECATED FOR USAGE PLANS - Specifies stages associated with the API key.

" - }, - "customerId":{ - "shape":"String", - "documentation":"

An AWS Marketplace customer identifier , when integrating with the AWS SaaS Marketplace.

" - } - }, - "documentation":"

Request to create an ApiKey resource.

" - }, - "CreateAuthorizerRequest":{ - "type":"structure", - "required":[ - "restApiId", - "name", - "type" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "name":{ - "shape":"String", - "documentation":"

[Required] The name of the authorizer.

" - }, - "type":{ - "shape":"AuthorizerType", - "documentation":"

[Required] The authorizer type. Valid values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda function using incoming request parameters, and COGNITO_USER_POOLS for using an Amazon Cognito user pool.

" - }, - "providerARNs":{ - "shape":"ListOfARNs", - "documentation":"

A list of the Amazon Cognito user pool ARNs for the COGNITO_USER_POOLS authorizer. Each element is of this format: arn:aws:cognito-idp:{region}:{account_id}:userpool/{user_pool_id}. For a TOKEN or REQUEST authorizer, this is not defined.

" - }, - "authType":{ - "shape":"String", - "documentation":"

Optional customer-defined field, used in Swagger imports and exports without functional impact.

" - }, - "authorizerUri":{ - "shape":"String", - "documentation":"

Specifies the authorizer's Uniform Resource Identifier (URI). For TOKEN or REQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:{account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form arn:aws:apigateway:{region}:lambda:path/{service_api}, where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

" - }, - "authorizerCredentials":{ - "shape":"String", - "documentation":"

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

" - }, - "identitySource":{ - "shape":"String", - "documentation":"

The identity source for which authorization is requested.

  • For a TOKEN or COGNITO_USER_POOLS authorizer, this is required and specifies the request header mapping expression for the custom header holding the authorization token submitted by the client. For example, if the token header name is Auth, the header mapping expression is method.request.header.Auth.
  • For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header, a Name query string parameter are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

" - }, - "identityValidationExpression":{ - "shape":"String", - "documentation":"

A validation expression for the incoming identity token. For TOKEN authorizers, this value is a regular expression. API Gateway will match the aud field of the incoming token from the client against the specified regular expression. It will invoke the authorizer's Lambda function when there is a match. Otherwise, it will return a 401 Unauthorized response without calling the Lambda function. The validation expression does not apply to the REQUEST authorizer.

" - }, - "authorizerResultTtlInSeconds":{ - "shape":"NullableInteger", - "documentation":"

The TTL in seconds of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

" - } - }, - "documentation":"

Request to add a new Authorizer to an existing RestApi resource.

" - }, - "CreateBasePathMappingRequest":{ - "type":"structure", - "required":[ - "domainName", - "restApiId" - ], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The domain name of the BasePathMapping resource to create.

", - "location":"uri", - "locationName":"domain_name" - }, - "basePath":{ - "shape":"String", - "documentation":"

The base path name that callers of the API must provide as part of the URL after the domain name. This value must be unique for all of the mappings across a single API. Leave this blank if you do not want callers to specify a base path name after the domain name.

" - }, - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

" - }, - "stage":{ - "shape":"String", - "documentation":"

The name of the API's stage that you want to use for this mapping. Leave this blank if you do not want callers to explicitly specify the stage name after any base path name.

" - } - }, - "documentation":"

Requests API Gateway to create a new BasePathMapping resource.

" - }, - "CreateDeploymentRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

The name of the Stage resource for the Deployment resource to create.

" - }, - "stageDescription":{ - "shape":"String", - "documentation":"

The description of the Stage resource for the Deployment resource to create.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description for the Deployment resource to create.

" - }, - "cacheClusterEnabled":{ - "shape":"NullableBoolean", - "documentation":"

Enables a cache cluster for the Stage resource specified in the input.

" - }, - "cacheClusterSize":{ - "shape":"CacheClusterSize", - "documentation":"

Specifies the cache cluster size for the Stage resource specified in the input, if a cache cluster is enabled.

" - }, - "variables":{ - "shape":"MapOfStringToString", - "documentation":"

A map that defines the stage variables for the Stage resource that is associated with the new deployment. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

" - }, - "canarySettings":{ - "shape":"DeploymentCanarySettings", - "documentation":"

The input configuration for the canary deployment when the deployment is a canary release deployment.

" - } - }, - "documentation":"

Requests API Gateway to create a Deployment resource.

" - }, - "CreateDocumentationPartRequest":{ - "type":"structure", - "required":[ - "restApiId", - "location", - "properties" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "location":{ - "shape":"DocumentationPartLocation", - "documentation":"

[Required] The location of the targeted API entity of the to-be-created documentation part.

" - }, - "properties":{ - "shape":"String", - "documentation":"

[Required] The new documentation content map of the targeted API entity. Enclosed key-value pairs are API-specific, but only Swagger-compliant key-value pairs can be exported and, hence, published.

" - } - }, - "documentation":"

Creates a new documentation part of a given API.

" - }, - "CreateDocumentationVersionRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationVersion" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

[Required] The version identifier of the new snapshot.

" - }, - "stageName":{ - "shape":"String", - "documentation":"

The stage name to be associated with the new documentation snapshot.

" - }, - "description":{ - "shape":"String", - "documentation":"

A description about the new documentation snapshot.

" - } - }, - "documentation":"

Creates a new documentation version of a given API.

" - }, - "CreateDomainNameRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The name of the DomainName resource.

" - }, - "certificateName":{ - "shape":"String", - "documentation":"

The user-friendly name of the certificate that will be used by edge-optimized endpoint for this domain name.

" - }, - "certificateBody":{ - "shape":"String", - "documentation":"

[Deprecated] The body of the server certificate that will be used by edge-optimized endpoint for this domain name provided by your certificate authority.

" - }, - "certificatePrivateKey":{ - "shape":"String", - "documentation":"

[Deprecated] Your edge-optimized endpoint's domain name certificate's private key.

" - }, - "certificateChain":{ - "shape":"String", - "documentation":"

[Deprecated] The intermediate certificates and optionally the root certificate, one after the other without any blank lines, used by an edge-optimized endpoint for this domain name. If you include the root certificate, your certificate chain must start with intermediate certificates and end with the root certificate. Use the intermediate certificates that were provided by your certificate authority. Do not include any intermediaries that are not in the chain of trust path.

" - }, - "certificateArn":{ - "shape":"String", - "documentation":"

The reference to an AWS-managed certificate that will be used by edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source.

" - }, - "regionalCertificateName":{ - "shape":"String", - "documentation":"

The user-friendly name of the certificate that will be used by regional endpoint for this domain name.

" - }, - "regionalCertificateArn":{ - "shape":"String", - "documentation":"

The reference to an AWS-managed certificate that will be used by regional endpoint for this domain name. AWS Certificate Manager is the only supported source.

" - }, - "endpointConfiguration":{ - "shape":"EndpointConfiguration", - "documentation":"

The endpoint configuration of this DomainName showing the endpoint types of the domain name.

" - } - }, - "documentation":"

A request to create a new domain name.

" - }, - "CreateModelRequest":{ - "type":"structure", - "required":[ - "restApiId", - "name", - "contentType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The RestApi identifier under which the Model will be created.

", - "location":"uri", - "locationName":"restapi_id" - }, - "name":{ - "shape":"String", - "documentation":"

[Required] The name of the model. Must be alphanumeric.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the model.

" - }, - "schema":{ - "shape":"String", - "documentation":"

The schema for the model. For application/json models, this should be JSON schema draft 4 model.

" - }, - "contentType":{ - "shape":"String", - "documentation":"

[Required] The content-type for the model.

" - } - }, - "documentation":"

Request to add a new Model to an existing RestApi resource.

" - }, - "CreateRequestValidatorRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the to-be-created RequestValidator.

" - }, - "validateRequestBody":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether to validate request body according to the configured model schema for the method (true) or not (false).

" - }, - "validateRequestParameters":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether to validate request parameters, true, or not false.

" - } - }, - "documentation":"

Creates a RequestValidator of a given RestApi.

" - }, - "CreateResourceRequest":{ - "type":"structure", - "required":[ - "restApiId", - "parentId", - "pathPart" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "parentId":{ - "shape":"String", - "documentation":"

[Required] The parent resource's identifier.

", - "location":"uri", - "locationName":"parent_id" - }, - "pathPart":{ - "shape":"String", - "documentation":"

The last path segment for this resource.

" - } - }, - "documentation":"

Requests API Gateway to create a Resource resource.

" - }, - "CreateRestApiRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

[Required] The name of the RestApi.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the RestApi.

" - }, - "version":{ - "shape":"String", - "documentation":"

A version identifier for the API.

" - }, - "cloneFrom":{ - "shape":"String", - "documentation":"

The ID of the RestApi that you want to clone from.

" - }, - "binaryMediaTypes":{ - "shape":"ListOfString", - "documentation":"

The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.

" - }, - "minimumCompressionSize":{ - "shape":"NullableInteger", - "documentation":"

A nullable integer that is used to enable compression (with non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable compression (with a null value) on an API. When compression is enabled, compression or decompression is not applied on the payload if the payload size is smaller than this value. Setting it to zero allows compression for any payload size.

" - }, - "apiKeySource":{ - "shape":"ApiKeySourceType", - "documentation":"

The source of the API key for metering requests according to a usage plan. Valid values are:

  • HEADER to read the API key from the X-API-Key header of a request.
  • AUTHORIZER to read the API key from the UsageIdentifierKey from a custom authorizer.

" - }, - "endpointConfiguration":{ - "shape":"EndpointConfiguration", - "documentation":"

The endpoint configuration of this RestApi showing the endpoint types of the API.

" - }, - "policy":{ - "shape":"String", - "documentation":"A stringified JSON policy document that applies to this RestApi regardless of the caller and Method configuration." - } - }, - "documentation":"

The POST Request to add a new RestApi resource to your collection.

" - }, - "CreateStageRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName", - "deploymentId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name for the Stage resource.

" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Deployment resource for the Stage resource.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the Stage resource.

" - }, - "cacheClusterEnabled":{ - "shape":"Boolean", - "documentation":"

Whether cache clustering is enabled for the stage.

" - }, - "cacheClusterSize":{ - "shape":"CacheClusterSize", - "documentation":"

The stage's cache cluster size.

" - }, - "variables":{ - "shape":"MapOfStringToString", - "documentation":"

A map that defines the stage variables for the new Stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

The version of the associated API documentation.

" - }, - "canarySettings":{ - "shape":"CanarySettings", - "documentation":"

The canary deployment settings of this stage.

" - }, - "tags":{ - "shape":"MapOfStringToString", - "documentation":"

The key-value map of strings. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start with aws:. The tag value can be up to 256 characters.

" - } - }, - "documentation":"

Requests API Gateway to create a Stage resource.

" - }, - "CreateUsagePlanKeyRequest":{ - "type":"structure", - "required":[ - "usagePlanId", - "keyId", - "keyType" - ], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the UsagePlan resource representing the usage plan containing the to-be-created UsagePlanKey resource representing a plan customer.

", - "location":"uri", - "locationName":"usageplanId" - }, - "keyId":{ - "shape":"String", - "documentation":"

[Required] The identifier of a UsagePlanKey resource for a plan customer.

" - }, - "keyType":{ - "shape":"String", - "documentation":"

[Required] The type of a UsagePlanKey resource for a plan customer.

" - } - }, - "documentation":"

The POST request to create a usage plan key for adding an existing API key to a usage plan.

" - }, - "CreateUsagePlanRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

[Required] The name of the usage plan.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the usage plan.

" - }, - "apiStages":{ - "shape":"ListOfApiStage", - "documentation":"

The associated API stages of the usage plan.

" - }, - "throttle":{ - "shape":"ThrottleSettings", - "documentation":"

The throttling limits of the usage plan.

" - }, - "quota":{ - "shape":"QuotaSettings", - "documentation":"

The quota of the usage plan.

" - } - }, - "documentation":"

The POST request to create a usage plan with the name, description, throttle limits and quota limits, as well as the associated API stages, specified in the payload.

" - }, - "CreateVpcLinkRequest":{ - "type":"structure", - "required":[ - "name", - "targetArns" - ], - "members":{ - "name":{ - "shape":"String", - "documentation":"

[Required] The name used to label and identify the VPC link.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the VPC link.

" - }, - "targetArns":{ - "shape":"ListOfString", - "documentation":"

[Required] The ARNs of network load balancers of the VPC targeted by the VPC link. The network load balancers must be owned by the same AWS account of the API owner.

" - } - }, - "documentation":"

Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.

" - }, - "DeleteApiKeyRequest":{ - "type":"structure", - "required":["apiKey"], - "members":{ - "apiKey":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ApiKey resource to be deleted.

", - "location":"uri", - "locationName":"api_Key" - } - }, - "documentation":"

A request to delete the ApiKey resource.

" - }, - "DeleteAuthorizerRequest":{ - "type":"structure", - "required":[ - "restApiId", - "authorizerId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Authorizer resource.

", - "location":"uri", - "locationName":"authorizer_id" - } - }, - "documentation":"

Request to delete an existing Authorizer resource.

" - }, - "DeleteBasePathMappingRequest":{ - "type":"structure", - "required":[ - "domainName", - "basePath" - ], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The domain name of the BasePathMapping resource to delete.

", - "location":"uri", - "locationName":"domain_name" - }, - "basePath":{ - "shape":"String", - "documentation":"

[Required] The base path name of the BasePathMapping resource to delete.

", - "location":"uri", - "locationName":"base_path" - } - }, - "documentation":"

A request to delete the BasePathMapping resource.

" - }, - "DeleteClientCertificateRequest":{ - "type":"structure", - "required":["clientCertificateId"], - "members":{ - "clientCertificateId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ClientCertificate resource to be deleted.

", - "location":"uri", - "locationName":"clientcertificate_id" - } - }, - "documentation":"

A request to delete the ClientCertificate resource.

" - }, - "DeleteDeploymentRequest":{ - "type":"structure", - "required":[ - "restApiId", - "deploymentId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Deployment resource to delete.

", - "location":"uri", - "locationName":"deployment_id" - } - }, - "documentation":"

Requests API Gateway to delete a Deployment resource.

" - }, - "DeleteDocumentationPartRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationPartId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationPartId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the to-be-deleted documentation part.

", - "location":"uri", - "locationName":"part_id" - } - }, - "documentation":"

Deletes an existing documentation part of an API.

" - }, - "DeleteDocumentationVersionRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationVersion" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

[Required] The version identifier of a to-be-deleted documentation snapshot.

", - "location":"uri", - "locationName":"doc_version" - } - }, - "documentation":"

Deletes an existing documentation version of an API.

" - }, - "DeleteDomainNameRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The name of the DomainName resource to be deleted.

", - "location":"uri", - "locationName":"domain_name" - } - }, - "documentation":"

A request to delete the DomainName resource.

" - }, - "DeleteGatewayResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "responseType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "responseType":{ - "shape":"GatewayResponseType", - "documentation":"

[Required]

The response type of the associated GatewayResponse. Valid values are

  • ACCESS_DENIED
  • API_CONFIGURATION_ERROR
  • AUTHORIZER_FAILURE
  • AUTHORIZER_CONFIGURATION_ERROR
  • BAD_REQUEST_PARAMETERS
  • BAD_REQUEST_BODY
  • DEFAULT_4XX
  • DEFAULT_5XX
  • EXPIRED_TOKEN
  • INVALID_SIGNATURE
  • INTEGRATION_FAILURE
  • INTEGRATION_TIMEOUT
  • INVALID_API_KEY
  • MISSING_AUTHENTICATION_TOKEN
  • QUOTA_EXCEEDED
  • REQUEST_TOO_LARGE
  • RESOURCE_NOT_FOUND
  • THROTTLED
  • UNAUTHORIZED
  • UNSUPPORTED_MEDIA_TYPE

", - "location":"uri", - "locationName":"response_type" - } - }, - "documentation":"

Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.

" - }, - "DeleteIntegrationRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a delete integration request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a delete integration request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - } - }, - "documentation":"

Represents a delete integration request.

" - }, - "DeleteIntegrationResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a delete integration response request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a delete integration response request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] Specifies a delete integration response request's status code.

", - "location":"uri", - "locationName":"status_code" - } - }, - "documentation":"

Represents a delete integration response request.

" - }, - "DeleteMethodRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the Method resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - } - }, - "documentation":"

Request to delete an existing Method resource.

" - }, - "DeleteMethodResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the MethodResponse resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] The status code identifier for the MethodResponse resource.

", - "location":"uri", - "locationName":"status_code" - } - }, - "documentation":"

A request to delete an existing MethodResponse resource.

" - }, - "DeleteModelRequest":{ - "type":"structure", - "required":[ - "restApiId", - "modelName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "modelName":{ - "shape":"String", - "documentation":"

[Required] The name of the model to delete.

", - "location":"uri", - "locationName":"model_name" - } - }, - "documentation":"

Request to delete an existing model in an existing RestApi resource.

" - }, - "DeleteRequestValidatorRequest":{ - "type":"structure", - "required":[ - "restApiId", - "requestValidatorId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "requestValidatorId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the RequestValidator to be deleted.

", - "location":"uri", - "locationName":"requestvalidator_id" - } - }, - "documentation":"

Deletes a specified RequestValidator of a given RestApi.

" - }, - "DeleteResourceRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Resource resource.

", - "location":"uri", - "locationName":"resource_id" - } - }, - "documentation":"

Request to delete a Resource.

" - }, - "DeleteRestApiRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - } - }, - "documentation":"

Request to delete the specified API from your collection.

" - }, - "DeleteStageRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the Stage resource to delete.

", - "location":"uri", - "locationName":"stage_name" - } - }, - "documentation":"

Requests API Gateway to delete a Stage resource.

" - }, - "DeleteUsagePlanKeyRequest":{ - "type":"structure", - "required":[ - "usagePlanId", - "keyId" - ], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the UsagePlan resource representing the usage plan containing the to-be-deleted UsagePlanKey resource representing a plan customer.

", - "location":"uri", - "locationName":"usageplanId" - }, - "keyId":{ - "shape":"String", - "documentation":"

[Required] The Id of the UsagePlanKey resource to be deleted.

", - "location":"uri", - "locationName":"keyId" - } - }, - "documentation":"

The DELETE request to delete a usage plan key and remove the underlying API key from the associated usage plan.

" - }, - "DeleteUsagePlanRequest":{ - "type":"structure", - "required":["usagePlanId"], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the to-be-deleted usage plan.

", - "location":"uri", - "locationName":"usageplanId" - } - }, - "documentation":"

The DELETE request to delete a usage plan of a given plan Id.

" - }, - "DeleteVpcLinkRequest":{ - "type":"structure", - "required":["vpcLinkId"], - "members":{ - "vpcLinkId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the VpcLink. It is used in an Integration to reference this VpcLink.

", - "location":"uri", - "locationName":"vpclink_id" - } - }, - "documentation":"

Deletes an existing VpcLink of a specified identifier.

" - }, - "Deployment":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier for the deployment resource.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description for the deployment resource.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date and time that the deployment resource was created.

" - }, - "apiSummary":{ - "shape":"PathToMapOfMethodSnapshot", - "documentation":"

A summary of the RestApi at the date and time that the deployment resource was created.

" - } - }, - "documentation":"

An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable over the Internet.

To create a deployment, call POST on the Deployments resource of a RestApi. To view, update, or delete a deployment, call GET, PATCH, or DELETE on the specified deployment resource (/restapis/{restapi_id}/deployments/{deployment_id}).
" - }, - "DeploymentCanarySettings":{ - "type":"structure", - "members":{ - "percentTraffic":{ - "shape":"Double", - "documentation":"

The percentage (0.0-100.0) of traffic routed to the canary deployment.

" - }, - "stageVariableOverrides":{ - "shape":"MapOfStringToString", - "documentation":"

A stage variable overrides used for the canary release deployment. They can override existing stage variables or add new stage variables for the canary release deployment. These stage variables are represented as a string-to-string map between stage variable names and their values.

" - }, - "useStageCache":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether the canary release deployment uses the stage cache or not.

" - } - }, - "documentation":"

The input configuration for a canary deployment.

" - }, - "Deployments":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfDeployment", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection resource that contains zero or more references to your existing deployments, and links that guide you on how to interact with your collection. The collection offers a paginated view of the contained deployments.

To create a new deployment of a RestApi, make a POST request against this resource. To view, update, or delete an existing deployment, make a GET, PATCH, or DELETE request, respectively, on a specified Deployment resource.
" - }, - "DocumentationPart":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The DocumentationPart identifier, generated by API Gateway when the DocumentationPart is created.

" - }, - "location":{ - "shape":"DocumentationPartLocation", - "documentation":"

The location of the API entity to which the documentation applies. Valid fields depend on the targeted API entity type. All the valid location fields are not required. If not explicitly specified, a valid location field is treated as a wildcard and associated documentation content may be inherited by matching entities, unless overridden.

" - }, - "properties":{ - "shape":"String", - "documentation":"

A content map of API-specific key-value pairs describing the targeted API entity. The map must be encoded as a JSON string, e.g., \"{ \\\"description\\\": \\\"The API does ...\\\" }\". Only Swagger-compliant documentation-related fields from the properties map are exported and, hence, published as part of the API entity definitions, while the original documentation parts are exported in a Swagger extension of x-amazon-apigateway-documentation.

" - } - }, - "documentation":"

A documentation part for a targeted API entity.

A documentation part consists of a content map (properties) and a target (location). The target specifies an API entity to which the documentation content applies. The supported API entity types are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Valid location fields depend on the API entity type. All valid fields are not required.

The content map is a JSON string of API-specific key-value pairs. Although an API can use any shape for the content map, only the Swagger-compliant documentation fields will be injected into the associated API entity definition in the exported Swagger definition file.

" - }, - "DocumentationPartIds":{ - "type":"structure", - "members":{ - "ids":{ - "shape":"ListOfString", - "documentation":"

A list of the returned documentation part identifiers.

" - }, - "warnings":{ - "shape":"ListOfString", - "documentation":"

A list of warning messages reported during import of documentation parts.

" - } - }, - "documentation":"

A collection of the imported DocumentationPart identifiers.

This is used to return the result when documentation parts in an external (e.g., Swagger) file are imported into API Gateway
" - }, - "DocumentationPartLocation":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"DocumentationPartType", - "documentation":"

[Required] The type of API entity to which the documentation content applies. Valid values are API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. Content inheritance does not apply to any entity of the API, AUTHORIZER, METHOD, MODEL, REQUEST_BODY, or RESOURCE type.

" - }, - "path":{ - "shape":"String", - "documentation":"

The URL path of the target. It is a valid field for the API entity types of RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is / for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other location attributes, the child entity's path attribute must match that of the parent entity as a prefix.

" - }, - "method":{ - "shape":"String", - "documentation":"

The HTTP verb of a method. It is a valid field for the API entity types of METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's method attribute must match that of the parent entity exactly.

" - }, - "statusCode":{ - "shape":"DocumentationPartLocationStatusCode", - "documentation":"

The HTTP status code of a response. It is a valid field for the API entity types of RESPONSE, RESPONSE_HEADER, and RESPONSE_BODY. The default value is * for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other location attributes, the child entity's statusCode attribute must match that of the parent entity exactly.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the targeted API entity. It is a valid and required field for the API entity types of AUTHORIZER, MODEL, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY and RESPONSE_HEADER. It is an invalid field for any other entity type.

" - } - }, - "documentation":"

Specifies the target API entity to which the documentation applies.

" - }, - "DocumentationPartLocationStatusCode":{ - "type":"string", - "pattern":"^([1-5]\\d\\d|\\*|\\s*)$" - }, - "DocumentationPartType":{ - "type":"string", - "enum":[ - "API", - "AUTHORIZER", - "MODEL", - "RESOURCE", - "METHOD", - "PATH_PARAMETER", - "QUERY_PARAMETER", - "REQUEST_HEADER", - "REQUEST_BODY", - "RESPONSE", - "RESPONSE_HEADER", - "RESPONSE_BODY" - ] - }, - "DocumentationParts":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfDocumentationPart", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

The collection of documentation parts of an API.

" - }, - "DocumentationVersion":{ - "type":"structure", - "members":{ - "version":{ - "shape":"String", - "documentation":"

The version identifier of the API documentation snapshot.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date when the API documentation snapshot is created.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the API documentation snapshot.

" - } - }, - "documentation":"

A snapshot of the documentation of an API.

Publishing API documentation involves creating a documentation version associated with an API stage and exporting the versioned documentation to an external (e.g., Swagger) file.

" - }, - "DocumentationVersions":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfDocumentationVersion", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

The collection of documentation snapshots of an API.

Use the DocumentationVersions to manage documentation snapshots associated with various API stages.

" - }, - "DomainName":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

The custom domain name as an API host name, for example, my-api.example.com.

" - }, - "certificateName":{ - "shape":"String", - "documentation":"

The name of the certificate that will be used by edge-optimized endpoint for this domain name.

" - }, - "certificateArn":{ - "shape":"String", - "documentation":"

The reference to an AWS-managed certificate that will be used by edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source.

" - }, - "certificateUploadDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the certificate that was used by edge-optimized endpoint for this domain name was uploaded.

" - }, - "regionalDomainName":{ - "shape":"String", - "documentation":"

The domain name associated with the regional endpoint for this custom domain name. You set up this association by adding a DNS record that points the custom domain name to this regional domain name. The regional domain name is returned by API Gateway when you create a regional endpoint.

" - }, - "regionalHostedZoneId":{ - "shape":"String", - "documentation":"

The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint. For more information, see Set up a Regional Custom Domain Name and AWS Regions and Endpoints for API Gateway.

" - }, - "regionalCertificateName":{ - "shape":"String", - "documentation":"

The name of the certificate that will be used for validating the regional domain name.

" - }, - "regionalCertificateArn":{ - "shape":"String", - "documentation":"

The reference to an AWS-managed certificate that will be used for validating the regional domain name. AWS Certificate Manager is the only supported source.

" - }, - "distributionDomainName":{ - "shape":"String", - "documentation":"

The domain name of the Amazon CloudFront distribution associated with this custom domain name for an edge-optimized endpoint. You set up this association when adding a DNS record pointing the custom domain name to this distribution name. For more information about CloudFront distributions, see the Amazon CloudFront documentation.

" - }, - "distributionHostedZoneId":{ - "shape":"String", - "documentation":"

The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized endpoint. The valid value is Z2FDTNDATAQYW2 for all the regions. For more information, see Set up a Regional Custom Domain Name and AWS Regions and Endpoints for API Gateway.

" - }, - "endpointConfiguration":{ - "shape":"EndpointConfiguration", - "documentation":"

The endpoint configuration of this DomainName showing the endpoint types of the domain name.

" - } - }, - "documentation":"

Represents a custom domain name as a user-friendly host name of an API (RestApi).

When you deploy an API, API Gateway creates a default host name for the API. This default API host name is of the {restapi-id}.execute-api.{region}.amazonaws.com format. With the default host name, you can access the API's root resource with the URL of https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}/. When you set up a custom domain name of apis.example.com for this API, you can then access the same resource using the URL of the https://apis.examples.com/myApi, where myApi is the base path mapping (BasePathMapping) of your API under the custom domain name.

" - }, - "DomainNames":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfDomainName", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of DomainName resources.

" - }, - "Double":{"type":"double"}, - "EndpointConfiguration":{ - "type":"structure", - "members":{ - "types":{ - "shape":"ListOfEndpointType", - "documentation":"

A list of endpoint types of an API (RestApi) or its custom domain name (DomainName). For an edge-optimized API and its custom domain name, the endpoint type is \"EDGE\". For a regional API and its custom domain name, the endpoint type is REGIONAL. For a private API, the endpoint type is PRIVATE.

" - } - }, - "documentation":"

The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.

" - }, - "EndpointType":{ - "type":"string", - "documentation":"

The endpoint type. The valid values are EDGE for edge-optimized API setup, most suitable for mobile applications; REGIONAL for regional API endpoint setup, most suitable for calling from AWS Region; and PRIVATE for private APIs.

", - "enum":[ - "REGIONAL", - "EDGE", - "PRIVATE" - ] - }, - "ExportResponse":{ - "type":"structure", - "members":{ - "contentType":{ - "shape":"String", - "documentation":"

The content-type header value in the HTTP response. This will correspond to a valid 'accept' type in the request.

", - "location":"header", - "locationName":"Content-Type" - }, - "contentDisposition":{ - "shape":"String", - "documentation":"

The content-disposition header value in the HTTP response.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "body":{ - "shape":"Blob", - "documentation":"

The binary blob response to GetExport, which contains the export.

" - } - }, - "documentation":"

The binary blob response to GetExport, which contains the generated SDK.

", - "payload":"body" - }, - "FlushStageAuthorizersCacheRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

The name of the stage to flush.

", - "location":"uri", - "locationName":"stage_name" - } - }, - "documentation":"

Request to flush authorizer cache entries on a specified stage.

" - }, - "FlushStageCacheRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the stage to flush its cache.

", - "location":"uri", - "locationName":"stage_name" - } - }, - "documentation":"

Requests API Gateway to flush a stage's cache.

" - }, - "GatewayResponse":{ - "type":"structure", - "members":{ - "responseType":{ - "shape":"GatewayResponseType", - "documentation":"

The response type of the associated GatewayResponse. Valid values are

  • ACCESS_DENIED
  • API_CONFIGURATION_ERROR
  • AUTHORIZER_FAILURE
  • AUTHORIZER_CONFIGURATION_ERROR
  • BAD_REQUEST_PARAMETERS
  • BAD_REQUEST_BODY
  • DEFAULT_4XX
  • DEFAULT_5XX
  • EXPIRED_TOKEN
  • INVALID_SIGNATURE
  • INTEGRATION_FAILURE
  • INTEGRATION_TIMEOUT
  • INVALID_API_KEY
  • MISSING_AUTHENTICATION_TOKEN
  • QUOTA_EXCEEDED
  • REQUEST_TOO_LARGE
  • RESOURCE_NOT_FOUND
  • THROTTLED
  • UNAUTHORIZED
  • UNSUPPORTED_MEDIA_TYPE

" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

The HTTP status code for this GatewayResponse.

" - }, - "responseParameters":{ - "shape":"MapOfStringToString", - "documentation":"

Response parameters (paths, query strings and headers) of the GatewayResponse as a string-to-string map of key-value pairs.

" - }, - "responseTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Response templates of the GatewayResponse as a string-to-string map of key-value pairs.

" - }, - "defaultResponse":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether this GatewayResponse is the default gateway response (true) or not (false). A default gateway response is one generated by API Gateway without any customization by an API developer.

" - } - }, - "documentation":"

A gateway response of a given response type and status code, with optional response parameters and mapping templates.

For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway

Example: Get a Gateway Response of a given response type

Request

This example shows how to get a gateway response of the MISSING_AUTHENTICATION_TOKEN type.

GET /restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T202516Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=1b52460e3159c1a26cff29093855d50ea141c1c5b937528fecaf60f51129697a Cache-Control: no-cache Postman-Token: 3b2a1ce9-c848-2e26-2e2f-9c2caefbed45 

The response type is specified as a URL path.

Response

The successful operation returns the 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html\", \"name\": \"gatewayresponse\", \"templated\": true }, \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" }, \"gatewayresponse:delete\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" } }, \"defaultResponse\": false, \"responseParameters\": { \"gatewayresponse.header.x-request-path\": \"method.request.path.petId\", \"gatewayresponse.header.Access-Control-Allow-Origin\": \"'a.b.c'\", \"gatewayresponse.header.x-request-query\": \"method.request.querystring.q\", \"gatewayresponse.header.x-request-header\": \"method.request.header.Accept\" }, \"responseTemplates\": { \"application/json\": \"{\\n \\\"message\\\": $context.error.messageString,\\n \\\"type\\\": \\\"$context.error.responseType\\\",\\n \\\"stage\\\": \\\"$context.stage\\\",\\n \\\"resourcePath\\\": \\\"$context.resourcePath\\\",\\n \\\"stageVariables.a\\\": \\\"$stageVariables.a\\\",\\n \\\"statusCode\\\": \\\"'404'\\\"\\n}\" }, \"responseType\": \"MISSING_AUTHENTICATION_TOKEN\", \"statusCode\": \"404\" }

" - }, - "GatewayResponseType":{ - "type":"string", - "enum":[ - "DEFAULT_4XX", - "DEFAULT_5XX", - "RESOURCE_NOT_FOUND", - "UNAUTHORIZED", - "INVALID_API_KEY", - "ACCESS_DENIED", - "AUTHORIZER_FAILURE", - "AUTHORIZER_CONFIGURATION_ERROR", - "INVALID_SIGNATURE", - "EXPIRED_TOKEN", - "MISSING_AUTHENTICATION_TOKEN", - "INTEGRATION_FAILURE", - "INTEGRATION_TIMEOUT", - "API_CONFIGURATION_ERROR", - "UNSUPPORTED_MEDIA_TYPE", - "BAD_REQUEST_PARAMETERS", - "BAD_REQUEST_BODY", - "REQUEST_TOO_LARGE", - "THROTTLED", - "QUOTA_EXCEEDED" - ] - }, - "GatewayResponses":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfGatewayResponse", - "documentation":"

Returns the entire collection, because of no pagination support.

", - "locationName":"item" - } - }, - "documentation":"

The collection of the GatewayResponse instances of a RestApi as a responseType-to-GatewayResponse object map of key-value pairs. As such, pagination is not supported for querying this collection.

For more information about valid gateway response types, see Gateway Response Types Supported by API Gateway

Example: Get the collection of gateway responses of an API

Request

This example request shows how to retrieve the GatewayResponses collection from an API.

GET /restapis/o81lxisefl/gatewayresponses HTTP/1.1 Host: beta-apigateway.us-east-1.amazonaws.com Content-Type: application/json X-Amz-Date: 20170503T220604Z Authorization: AWS4-HMAC-SHA256 Credential={access-key-id}/20170503/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=59b42fe54a76a5de8adf2c67baa6d39206f8e9ad49a1d77ccc6a5da3103a398a Cache-Control: no-cache Postman-Token: 5637af27-dc29-fc5c-9dfe-0645d52cb515 

Response

The successful operation returns the 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-gatewayresponse-{rel}.html\", \"name\": \"gatewayresponse\", \"templated\": true }, \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses\" }, \"first\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses\" }, \"gatewayresponse:by-type\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"item\": [ { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/THROTTLED\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE\" }, { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE\" } ] }, \"_embedded\": { \"item\": [ { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_FAILURE\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"INTEGRATION_FAILURE\", \"statusCode\": \"504\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/RESOURCE_NOT_FOUND\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"RESOURCE_NOT_FOUND\", \"statusCode\": \"404\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/REQUEST_TOO_LARGE\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"REQUEST_TOO_LARGE\", \"statusCode\": \"413\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/THROTTLED\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/THROTTLED\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"THROTTLED\", \"statusCode\": \"429\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNSUPPORTED_MEDIA_TYPE\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"UNSUPPORTED_MEDIA_TYPE\", \"statusCode\": \"415\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_CONFIGURATION_ERROR\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"AUTHORIZER_CONFIGURATION_ERROR\", \"statusCode\": \"500\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_5XX\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"DEFAULT_5XX\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/DEFAULT_4XX\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"DEFAULT_4XX\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_PARAMETERS\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"BAD_REQUEST_PARAMETERS\", \"statusCode\": \"400\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/BAD_REQUEST_BODY\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"BAD_REQUEST_BODY\", \"statusCode\": \"400\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/EXPIRED_TOKEN\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"EXPIRED_TOKEN\", \"statusCode\": \"403\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/ACCESS_DENIED\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"ACCESS_DENIED\", \"statusCode\": \"403\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_API_KEY\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"INVALID_API_KEY\", \"statusCode\": \"403\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/UNAUTHORIZED\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"UNAUTHORIZED\", \"statusCode\": \"401\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/API_CONFIGURATION_ERROR\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"API_CONFIGURATION_ERROR\", \"statusCode\": \"500\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/QUOTA_EXCEEDED\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"QUOTA_EXCEEDED\", \"statusCode\": \"429\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INTEGRATION_TIMEOUT\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"INTEGRATION_TIMEOUT\", \"statusCode\": \"504\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/MISSING_AUTHENTICATION_TOKEN\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"MISSING_AUTHENTICATION_TOKEN\", \"statusCode\": \"403\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/INVALID_SIGNATURE\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"INVALID_SIGNATURE\", \"statusCode\": \"403\" }, { \"_links\": { \"self\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE\" }, \"gatewayresponse:put\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/{response_type}\", \"templated\": true }, \"gatewayresponse:update\": { \"href\": \"/restapis/o81lxisefl/gatewayresponses/AUTHORIZER_FAILURE\" } }, \"defaultResponse\": true, \"responseParameters\": {}, \"responseTemplates\": { \"application/json\": \"{\\\"message\\\":$context.error.messageString}\" }, \"responseType\": \"AUTHORIZER_FAILURE\", \"statusCode\": \"500\" } ] } }

" - }, - "GenerateClientCertificateRequest":{ - "type":"structure", - "members":{ - "description":{ - "shape":"String", - "documentation":"

The description of the ClientCertificate.

" - } - }, - "documentation":"

A request to generate a ClientCertificate resource.

" - }, - "GetAccountRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Requests API Gateway to get information about the current Account resource.

" - }, - "GetApiKeyRequest":{ - "type":"structure", - "required":["apiKey"], - "members":{ - "apiKey":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ApiKey resource.

", - "location":"uri", - "locationName":"api_Key" - }, - "includeValue":{ - "shape":"NullableBoolean", - "documentation":"

A boolean flag to specify whether (true) or not (false) the result contains the key value.

", - "location":"querystring", - "locationName":"includeValue" - } - }, - "documentation":"

A request to get information about the current ApiKey resource.

" - }, - "GetApiKeysRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - }, - "nameQuery":{ - "shape":"String", - "documentation":"

The name of queried API keys.

", - "location":"querystring", - "locationName":"name" - }, - "customerId":{ - "shape":"String", - "documentation":"

The identifier of a customer in AWS Marketplace or an external system, such as a developer portal.

", - "location":"querystring", - "locationName":"customerId" - }, - "includeValues":{ - "shape":"NullableBoolean", - "documentation":"

A boolean flag to specify whether (true) or not (false) the result contains key values.

", - "location":"querystring", - "locationName":"includeValues" - } - }, - "documentation":"

A request to get information about the current ApiKeys resource.

" - }, - "GetAuthorizerRequest":{ - "type":"structure", - "required":[ - "restApiId", - "authorizerId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Authorizer resource.

", - "location":"uri", - "locationName":"authorizer_id" - } - }, - "documentation":"

Request to describe an existing Authorizer resource.

" - }, - "GetAuthorizersRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Request to describe an existing Authorizers resource.

" - }, - "GetBasePathMappingRequest":{ - "type":"structure", - "required":[ - "domainName", - "basePath" - ], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The domain name of the BasePathMapping resource to be described.

", - "location":"uri", - "locationName":"domain_name" - }, - "basePath":{ - "shape":"String", - "documentation":"

[Required] The base path name that callers of the API must provide as part of the URL after the domain name. This value must be unique for all of the mappings across a single API. Leave this blank if you do not want callers to specify any base path name after the domain name.

", - "location":"uri", - "locationName":"base_path" - } - }, - "documentation":"

Request to describe a BasePathMapping resource.

" - }, - "GetBasePathMappingsRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The domain name of a BasePathMapping resource.

", - "location":"uri", - "locationName":"domain_name" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

A request to get information about a collection of BasePathMapping resources.

" - }, - "GetClientCertificateRequest":{ - "type":"structure", - "required":["clientCertificateId"], - "members":{ - "clientCertificateId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ClientCertificate resource to be described.

", - "location":"uri", - "locationName":"clientcertificate_id" - } - }, - "documentation":"

A request to get information about the current ClientCertificate resource.

" - }, - "GetClientCertificatesRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

A request to get information about a collection of ClientCertificate resources.

" - }, - "GetDeploymentRequest":{ - "type":"structure", - "required":[ - "restApiId", - "deploymentId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Deployment resource to get information about.

", - "location":"uri", - "locationName":"deployment_id" - }, - "embed":{ - "shape":"ListOfString", - "documentation":"

A query parameter to retrieve the specified embedded resources of the returned Deployment resource in the response. In a REST API call, this embed parameter value is a list of comma-separated strings, as in GET /restapis/{restapi_id}/deployments/{deployment_id}?embed=var1,var2. The SDK and other platform-dependent libraries might use a different format for the list. Currently, this request supports only retrieval of the embedded API summary this way. Hence, the parameter value must be a single-valued list containing only the \"apisummary\" string. For example, GET /restapis/{restapi_id}/deployments/{deployment_id}?embed=apisummary.

", - "location":"querystring", - "locationName":"embed" - } - }, - "documentation":"

Requests API Gateway to get information about a Deployment resource.

" - }, - "GetDeploymentsRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Requests API Gateway to get information about a Deployments collection.

" - }, - "GetDocumentationPartRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationPartId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationPartId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"part_id" - } - }, - "documentation":"

Gets a specified documentation part of a given API.

" - }, - "GetDocumentationPartsRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "type":{ - "shape":"DocumentationPartType", - "documentation":"

The type of API entities of the to-be-retrieved documentation parts.

", - "location":"querystring", - "locationName":"type" - }, - "nameQuery":{ - "shape":"String", - "documentation":"

The name of API entities of the to-be-retrieved documentation parts.

", - "location":"querystring", - "locationName":"name" - }, - "path":{ - "shape":"String", - "documentation":"

The path of API entities of the to-be-retrieved documentation parts.

", - "location":"querystring", - "locationName":"path" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - }, - "locationStatus":{ - "shape":"LocationStatusType", - "documentation":"

The status of the API documentation parts to retrieve. Valid values are DOCUMENTED for retrieving DocumentationPart resources with content and UNDOCUMENTED for DocumentationPart resources without content.

", - "location":"querystring", - "locationName":"locationStatus" - } - }, - "documentation":"

Gets the documentation parts of an API. The result may be filtered by the type, name, or path of API entities (targets).

" - }, - "GetDocumentationVersionRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationVersion" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

[Required] The version identifier of the to-be-retrieved documentation snapshot.

", - "location":"uri", - "locationName":"doc_version" - } - }, - "documentation":"

Gets a documentation snapshot of an API.

" - }, - "GetDocumentationVersionsRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Gets the documentation versions of an API.

" - }, - "GetDomainNameRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The name of the DomainName resource.

", - "location":"uri", - "locationName":"domain_name" - } - }, - "documentation":"

Request to get the name of a DomainName resource.

" - }, - "GetDomainNamesRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Request to describe a collection of DomainName resources.

" - }, - "GetExportRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName", - "exportType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the Stage that will be exported.

", - "location":"uri", - "locationName":"stage_name" - }, - "exportType":{ - "shape":"String", - "documentation":"

[Required] The type of export. Currently only 'swagger' is supported.

", - "location":"uri", - "locationName":"export_type" - }, - "parameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map of query string parameters that specify properties of the export, depending on the requested exportType. For exportType swagger, any combination of the following parameters are supported: extensions='integrations' or extensions='apigateway' will export the API with x-amazon-apigateway-integration extensions. extensions='authorizers' will export the API with x-amazon-apigateway-authorizer extensions. postman will export the API with Postman extensions, allowing for import to the Postman tool

", - "location":"querystring" - }, - "accepts":{ - "shape":"String", - "documentation":"

The content-type of the export, for example application/json. Currently application/json and application/yaml are supported for exportType of swagger. This should be specified in the Accept header for direct API requests.

", - "location":"header", - "locationName":"Accept" - } - }, - "documentation":"

Request a new export of a RestApi for a particular Stage.

" - }, - "GetGatewayResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "responseType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "responseType":{ - "shape":"GatewayResponseType", - "documentation":"

[Required]

The response type of the associated GatewayResponse. Valid values are

  • ACCESS_DENIED
  • API_CONFIGURATION_ERROR
  • AUTHORIZER_FAILURE
  • AUTHORIZER_CONFIGURATION_ERROR
  • BAD_REQUEST_PARAMETERS
  • BAD_REQUEST_BODY
  • DEFAULT_4XX
  • DEFAULT_5XX
  • EXPIRED_TOKEN
  • INVALID_SIGNATURE
  • INTEGRATION_FAILURE
  • INTEGRATION_TIMEOUT
  • INVALID_API_KEY
  • MISSING_AUTHENTICATION_TOKEN
  • QUOTA_EXCEEDED
  • REQUEST_TOO_LARGE
  • RESOURCE_NOT_FOUND
  • THROTTLED
  • UNAUTHORIZED
  • UNSUPPORTED_MEDIA_TYPE

", - "location":"uri", - "locationName":"response_type" - } - }, - "documentation":"

Gets a GatewayResponse of a specified response type on the given RestApi.

" - }, - "GetGatewayResponsesRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set. The GatewayResponse collection does not support pagination and the position does not apply here.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500. The GatewayResponses collection does not support pagination and the limit does not apply here.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.

" - }, - "GetIntegrationRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a get integration request's resource identifier

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a get integration request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - } - }, - "documentation":"

Represents a request to get the integration configuration.

" - }, - "GetIntegrationResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a get integration response request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a get integration response request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] Specifies a get integration response request's status code.

", - "location":"uri", - "locationName":"status_code" - } - }, - "documentation":"

Represents a get integration response request.

" - }, - "GetMethodRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the Method resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies the method request's HTTP method type.

", - "location":"uri", - "locationName":"http_method" - } - }, - "documentation":"

Request to describe an existing Method resource.

" - }, - "GetMethodResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the MethodResponse resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] The status code for the MethodResponse resource.

", - "location":"uri", - "locationName":"status_code" - } - }, - "documentation":"

Request to describe a MethodResponse resource.

" - }, - "GetModelRequest":{ - "type":"structure", - "required":[ - "restApiId", - "modelName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The RestApi identifier under which the Model exists.

", - "location":"uri", - "locationName":"restapi_id" - }, - "modelName":{ - "shape":"String", - "documentation":"

[Required] The name of the model as an identifier.

", - "location":"uri", - "locationName":"model_name" - }, - "flatten":{ - "shape":"Boolean", - "documentation":"

A query parameter of a Boolean value to resolve (true) all external model references and returns a flattened model schema or not (false) The default is false.

", - "location":"querystring", - "locationName":"flatten" - } - }, - "documentation":"

Request to list information about a model in an existing RestApi resource.

" - }, - "GetModelTemplateRequest":{ - "type":"structure", - "required":[ - "restApiId", - "modelName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "modelName":{ - "shape":"String", - "documentation":"

[Required] The name of the model for which to generate a template.

", - "location":"uri", - "locationName":"model_name" - } - }, - "documentation":"

Request to generate a sample mapping template used to transform the payload.

" - }, - "GetModelsRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Request to list existing Models defined for a RestApi resource.

" - }, - "GetRequestValidatorRequest":{ - "type":"structure", - "required":[ - "restApiId", - "requestValidatorId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "requestValidatorId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the RequestValidator to be retrieved.

", - "location":"uri", - "locationName":"requestvalidator_id" - } - }, - "documentation":"

Gets a RequestValidator of a given RestApi.

" - }, - "GetRequestValidatorsRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Gets the RequestValidators collection of a given RestApi.

" - }, - "GetResourceRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The identifier for the Resource resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "embed":{ - "shape":"ListOfString", - "documentation":"

A query parameter to retrieve the specified resources embedded in the returned Resource representation in the response. This embed parameter value is a list of comma-separated strings. Currently, the request supports only retrieval of the embedded Method resources this way. The query parameter value must be a single-valued list and contain the \"methods\" string. For example, GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods.

", - "location":"querystring", - "locationName":"embed" - } - }, - "documentation":"

Request to list information about a resource.

" - }, - "GetResourcesRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - }, - "embed":{ - "shape":"ListOfString", - "documentation":"

A query parameter used to retrieve the specified resources embedded in the returned Resources resource in the response. This embed parameter value is a list of comma-separated strings. Currently, the request supports only retrieval of the embedded Method resources this way. The query parameter value must be a single-valued list and contain the \"methods\" string. For example, GET /restapis/{restapi_id}/resources?embed=methods.

", - "location":"querystring", - "locationName":"embed" - } - }, - "documentation":"

Request to list information about a collection of resources.

" - }, - "GetRestApiRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - } - }, - "documentation":"

The GET request to list an existing RestApi defined for your collection.

" - }, - "GetRestApisRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

The GET request to list existing RestApis defined for your collection.

" - }, - "GetSdkRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName", - "sdkType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the Stage that the SDK will use.

", - "location":"uri", - "locationName":"stage_name" - }, - "sdkType":{ - "shape":"String", - "documentation":"

[Required] The language for the generated SDK. Currently java, javascript, android, objectivec (for iOS), swift (for iOS), and ruby are supported.

", - "location":"uri", - "locationName":"sdk_type" - }, - "parameters":{ - "shape":"MapOfStringToString", - "documentation":"

A string-to-string key-value map of query parameters sdkType-dependent properties of the SDK. For sdkType of objectivec or swift, a parameter named classPrefix is required. For sdkType of android, parameters named groupId, artifactId, artifactVersion, and invokerPackage are required. For sdkType of java, parameters named serviceName and javaPackageName are required.

", - "location":"querystring" - } - }, - "documentation":"

Request a new generated client SDK for a RestApi and Stage.

" - }, - "GetSdkTypeRequest":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"String", - "documentation":"

[Required] The identifier of the queried SdkType instance.

", - "location":"uri", - "locationName":"sdktype_id" - } - }, - "documentation":"

Get an SdkType instance.

" - }, - "GetSdkTypesRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Get the SdkTypes collection.

" - }, - "GetStageRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the Stage resource to get information about.

", - "location":"uri", - "locationName":"stage_name" - } - }, - "documentation":"

Requests API Gateway to get information about a Stage resource.

" - }, - "GetStagesRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

The stages' deployment identifiers.

", - "location":"querystring", - "locationName":"deploymentId" - } - }, - "documentation":"

Requests API Gateway to get information about one or more Stage resources.

" - }, - "GetTagsRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"String", - "documentation":"

[Required] The ARN of a resource that can be tagged. The resource ARN must be URL-encoded. At present, Stage is the only taggable resource.

", - "location":"uri", - "locationName":"resource_arn" - }, - "position":{ - "shape":"String", - "documentation":"

(Not currently supported) The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

(Not currently supported) The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Gets the Tags collection for a given resource.

" - }, - "GetUsagePlanKeyRequest":{ - "type":"structure", - "required":[ - "usagePlanId", - "keyId" - ], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the UsagePlan resource representing the usage plan containing the to-be-retrieved UsagePlanKey resource representing a plan customer.

", - "location":"uri", - "locationName":"usageplanId" - }, - "keyId":{ - "shape":"String", - "documentation":"

[Required] The key Id of the to-be-retrieved UsagePlanKey resource representing a plan customer.

", - "location":"uri", - "locationName":"keyId" - } - }, - "documentation":"

The GET request to get a usage plan key of a given key identifier.

" - }, - "GetUsagePlanKeysRequest":{ - "type":"structure", - "required":["usagePlanId"], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the UsagePlan resource representing the usage plan containing the to-be-retrieved UsagePlanKey resource representing a plan customer.

", - "location":"uri", - "locationName":"usageplanId" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - }, - "nameQuery":{ - "shape":"String", - "documentation":"

A query parameter specifying the name of the to-be-returned usage plan keys.

", - "location":"querystring", - "locationName":"name" - } - }, - "documentation":"

The GET request to get all the usage plan keys representing the API keys added to a specified usage plan.

" - }, - "GetUsagePlanRequest":{ - "type":"structure", - "required":["usagePlanId"], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the UsagePlan resource to be retrieved.

", - "location":"uri", - "locationName":"usageplanId" - } - }, - "documentation":"

The GET request to get a usage plan of a given plan identifier.

" - }, - "GetUsagePlansRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "keyId":{ - "shape":"String", - "documentation":"

The identifier of the API key associated with the usage plans.

", - "location":"querystring", - "locationName":"keyId" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

The GET request to get all the usage plans of the caller's account.

" - }, - "GetUsageRequest":{ - "type":"structure", - "required":[ - "usagePlanId", - "startDate", - "endDate" - ], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the usage plan associated with the usage data.

", - "location":"uri", - "locationName":"usageplanId" - }, - "keyId":{ - "shape":"String", - "documentation":"

The Id of the API key associated with the resultant usage data.

", - "location":"querystring", - "locationName":"keyId" - }, - "startDate":{ - "shape":"String", - "documentation":"

[Required] The starting date (e.g., 2016-01-01) of the usage data.

", - "location":"querystring", - "locationName":"startDate" - }, - "endDate":{ - "shape":"String", - "documentation":"

[Required] The ending date (e.g., 2016-12-31) of the usage data.

", - "location":"querystring", - "locationName":"endDate" - }, - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

The GET request to get the usage data of a usage plan in a specified time interval.

" - }, - "GetVpcLinkRequest":{ - "type":"structure", - "required":["vpcLinkId"], - "members":{ - "vpcLinkId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the VpcLink. It is used in an Integration to reference this VpcLink.

", - "location":"uri", - "locationName":"vpclink_id" - } - }, - "documentation":"

Gets a specified VPC link under the caller's account in a region.

" - }, - "GetVpcLinksRequest":{ - "type":"structure", - "members":{ - "position":{ - "shape":"String", - "documentation":"

The current pagination position in the paged result set.

", - "location":"querystring", - "locationName":"position" - }, - "limit":{ - "shape":"NullableInteger", - "documentation":"

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Gets the VpcLinks collection under the caller's account in a selected region.

" - }, - "ImportApiKeysRequest":{ - "type":"structure", - "required":[ - "body", - "format" - ], - "members":{ - "body":{ - "shape":"Blob", - "documentation":"

The payload of the POST request to import API keys. For the payload format, see API Key File Format.

" - }, - "format":{ - "shape":"ApiKeysFormat", - "documentation":"

A query parameter to specify the input format to imported API keys. Currently, only the csv format is supported.

", - "location":"querystring", - "locationName":"format" - }, - "failOnWarnings":{ - "shape":"Boolean", - "documentation":"

A query parameter to indicate whether to rollback ApiKey importation (true) or not (false) when error is encountered.

", - "location":"querystring", - "locationName":"failonwarnings" - } - }, - "documentation":"

The POST request to import API keys from an external source, such as a CSV-formatted file.

", - "payload":"body" - }, - "ImportDocumentationPartsRequest":{ - "type":"structure", - "required":[ - "restApiId", - "body" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "mode":{ - "shape":"PutMode", - "documentation":"

A query parameter to indicate whether to overwrite (OVERWRITE) any existing DocumentationParts definition or to merge (MERGE) the new definition into the existing one. The default value is MERGE.

", - "location":"querystring", - "locationName":"mode" - }, - "failOnWarnings":{ - "shape":"Boolean", - "documentation":"

A query parameter to specify whether to rollback the documentation importation (true) or not (false) when a warning is encountered. The default value is false.

", - "location":"querystring", - "locationName":"failonwarnings" - }, - "body":{ - "shape":"Blob", - "documentation":"

[Required] Raw byte array representing the to-be-imported documentation parts. To import from a Swagger file, this is a JSON object.

" - } - }, - "documentation":"

Import documentation parts from an external (e.g., Swagger) definition file.

", - "payload":"body" - }, - "ImportRestApiRequest":{ - "type":"structure", - "required":["body"], - "members":{ - "failOnWarnings":{ - "shape":"Boolean", - "documentation":"

A query parameter to indicate whether to rollback the API creation (true) or not (false) when a warning is encountered. The default value is false.

", - "location":"querystring", - "locationName":"failonwarnings" - }, - "parameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map of context-specific query string parameters specifying the behavior of different API importing operations. The following shows operation-specific parameters and their supported values.

To exclude DocumentationParts from the import, set parameters as ignore=documentation.

To configure the endpoint type, set parameters as endpointConfigurationTypes=EDGE, endpointConfigurationTypes=REGIONAL, or endpointConfigurationTypes=PRIVATE. The default endpoint type is EDGE.

To handle imported basePath, set parameters as basePath=ignore, basePath=prepend or basePath=split.

For example, the AWS CLI command to exclude documentation from the imported API is:

aws apigateway import-rest-api --parameters ignore=documentation --body 'file:///path/to/imported-api-body.json'

The AWS CLI command to set the regional endpoint on the imported API is:

aws apigateway import-rest-api --parameters endpointConfigurationTypes=REGIONAL --body 'file:///path/to/imported-api-body.json'
", - "location":"querystring" - }, - "body":{ - "shape":"Blob", - "documentation":"

[Required] The POST request body containing external API definitions. Currently, only Swagger definition JSON files are supported. The maximum size of the API definition file is 2MB.

" - } - }, - "documentation":"

A POST request to import an API to API Gateway using an input of an API definition file.

", - "payload":"body" - }, - "Integer":{"type":"integer"}, - "Integration":{ - "type":"structure", - "members":{ - "type":{ - "shape":"IntegrationType", - "documentation":"

Specifies an API method integration type. The valid value is one of the following:

  • AWS: for integrating the API method request with an AWS service action, including the Lambda function-invoking action. With the Lambda function-invoking action, this is referred to as the Lambda custom integration. With any other AWS service action, this is known as AWS integration.
  • AWS_PROXY: for integrating the API method request with the Lambda function-invoking action with the client request passed through as-is. This integration is also referred to as the Lambda proxy integration.
  • HTTP: for integrating the API method request with an HTTP endpoint, including a private HTTP endpoint within a VPC. This integration is also referred to as the HTTP custom integration.
  • HTTP_PROXY: for integrating the API method request with an HTTP endpoint, including a private HTTP endpoint within a VPC, with the client request passed through as-is. This is also referred to as the HTTP proxy integration.
  • MOCK: for integrating the API method request with API Gateway as a \"loop-back\" endpoint without invoking any backend.

For the HTTP and HTTP proxy integrations, each integration can specify a protocol (http/https), port and path. Standard 80 and 443 ports are supported as well as custom ports above 1024. An HTTP or HTTP proxy integration with a connectionType of VPC_LINK is referred to as a private integration and uses a VpcLink to connect API Gateway to a network load balancer of a VPC.

" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

Specifies the integration's HTTP method type.

" - }, - "uri":{ - "shape":"String", - "documentation":"

Specifies Uniform Resource Identifier (URI) of the integration endpoint.

  • For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification, for either standard integration, where connectionType is not VPC_LINK, or private integration, where connectionType is VPC_LINK. For a private HTTP integration, the URI is not used for routing.

  • For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. Here, {Region} is the API Gateway region (e.g., us-east-1); {service} is the name of the integrated AWS service (e.g., s3); and {subdomain} is a designated subdomain supported by certain AWS service for fast host-name lookup. action can be used for an AWS service action-based API, using an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} refers to a supported action {name} plus any required input parameters. Alternatively, path can be used for an AWS service path-based API. The ensuing service_api refers to the path to an AWS service resource, including the region of the integrated AWS service, if applicable. For example, for integration with the S3 API of GetObject, the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key}

" - }, - "connectionType":{ - "shape":"ConnectionType", - "documentation":"

The type of the network connection to the integration endpoint. The valid value is INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and a network load balancer in a VPC. The default value is INTERNET.

" - }, - "connectionId":{ - "shape":"String", - "documentation":"

The (id) of the VpcLink used for the integration when connectionType=VPC_LINK and undefined, otherwise.

" - }, - "credentials":{ - "shape":"String", - "documentation":"

Specifies the credentials required for the integration, if any. For AWS integrations, three options are available. To specify an IAM Role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To require that the caller's identity be passed through from the request, specify the string arn:aws:iam::\\*:user/\\*. To use resource-based permissions on supported AWS services, specify null.

" - }, - "requestParameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map specifying request parameters that are passed from the method request to the back end. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the back end. The method request parameter value must match the pattern of method.request.{location}.{name}, where location is querystring, path, or header and name must be a valid and unique method request parameter name.

" - }, - "requestTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value.

" - }, - "passthroughBehavior":{ - "shape":"String", - "documentation":"

Specifies how the method request body of an unmapped content type will be passed through the integration request to the back end without transformation. A content type is unmapped if no mapping template is defined in the integration or the content type does not match any of the mapped content types, as specified in requestTemplates. The valid value is one of the following:

  • WHEN_NO_MATCH: passes the method request body through the integration request to the back end without transformation when the method request content type does not match any content type associated with the mapping templates defined in the integration request.
  • WHEN_NO_TEMPLATES: passes the method request body through the integration request to the back end without transformation when no mapping template is defined in the integration request. If a template is defined when this option is selected, the method request of an unmapped content-type will be rejected with an HTTP 415 Unsupported Media Type response.
  • NEVER: rejects the method request with an HTTP 415 Unsupported Media Type response when either the method request content type does not match any content type associated with the mapping templates defined in the integration request or no mapping template is defined in the integration request.
" - }, - "contentHandling":{ - "shape":"ContentHandlingStrategy", - "documentation":"

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:

  • CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded string to the corresponding binary blob.

  • CONVERT_TO_TEXT: Converts a request payload from a binary blob to a Base64-encoded string.

If this property is not defined, the request payload will be passed through from the method request to integration request without modification, provided that the passthroughBehaviors is configured to support payload pass-through.

" - }, - "timeoutInMillis":{ - "shape":"Integer", - "documentation":"

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 milliseconds or 29 seconds.

" - }, - "cacheNamespace":{ - "shape":"String", - "documentation":"

Specifies the integration's cache namespace.

" - }, - "cacheKeyParameters":{ - "shape":"ListOfString", - "documentation":"

Specifies the integration's cache key parameters.

" - }, - "integrationResponses":{ - "shape":"MapOfIntegrationResponse", - "documentation":"

Specifies the integration's responses.

Example: Get integration responses of a method

Request

GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160607T191449Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160607/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} 
Response

The successful response returns 200 OK status and a payload as follows:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html\", \"name\": \"integrationresponse\", \"templated\": true }, \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\", \"title\": \"200\" }, \"integrationresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" }, \"integrationresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" } }, \"responseParameters\": { \"method.response.header.Content-Type\": \"'application/xml'\" }, \"responseTemplates\": { \"application/json\": \"$util.urlDecode(\\\"%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\\\")\\n\" }, \"statusCode\": \"200\" }

" - } - }, - "documentation":"

Represents an HTTP, HTTP_PROXY, AWS, AWS_PROXY, or Mock integration.

In the API Gateway console, the built-in Lambda integration is an AWS integration.
" - }, - "IntegrationResponse":{ - "type":"structure", - "members":{ - "statusCode":{ - "shape":"StatusCode", - "documentation":"

Specifies the status code that is used to map the integration response to an existing MethodResponse.

" - }, - "selectionPattern":{ - "shape":"String", - "documentation":"

Specifies the regular expression (regex) pattern used to choose an integration response based on the response from the back end. For example, if the success response returns nothing and the error response returns some string, you could use the .+ regex to match error response. However, make sure that the error response does not contain any newline (\\n) character in such cases. If the back end is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS back ends, the HTTP status code is matched.

" - }, - "responseParameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map specifying response parameters that are passed to the method response from the back end. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name is a valid and unique response header name and JSON-expression is a valid JSON expression without the $ prefix.

" - }, - "responseTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Specifies the templates used to transform the integration response body. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.

" - }, - "contentHandling":{ - "shape":"ContentHandlingStrategy", - "documentation":"

Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:

  • CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.

  • CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.

If this property is not defined, the response payload will be passed through from the integration response to the method response without modification.

" - } - }, - "documentation":"

Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end response.

" - }, - "IntegrationType":{ - "type":"string", - "documentation":"

The integration type. The valid value is HTTP for integrating an API method with an HTTP backend; AWS with any AWS service endpoints; MOCK for testing without actually invoking the backend; HTTP_PROXY for integrating with the HTTP proxy integration; AWS_PROXY for integrating with the Lambda proxy integration.

", - "enum":[ - "HTTP", - "AWS", - "MOCK", - "HTTP_PROXY", - "AWS_PROXY" - ] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"String"} - }, - "documentation":"

The request exceeded the rate limit. Retry after the specified time period.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListOfARNs":{ - "type":"list", - "member":{"shape":"ProviderARN"} - }, - "ListOfApiKey":{ - "type":"list", - "member":{"shape":"ApiKey"} - }, - "ListOfApiStage":{ - "type":"list", - "member":{"shape":"ApiStage"} - }, - "ListOfAuthorizer":{ - "type":"list", - "member":{"shape":"Authorizer"} - }, - "ListOfBasePathMapping":{ - "type":"list", - "member":{"shape":"BasePathMapping"} - }, - "ListOfClientCertificate":{ - "type":"list", - "member":{"shape":"ClientCertificate"} - }, - "ListOfDeployment":{ - "type":"list", - "member":{"shape":"Deployment"} - }, - "ListOfDocumentationPart":{ - "type":"list", - "member":{"shape":"DocumentationPart"} - }, - "ListOfDocumentationVersion":{ - "type":"list", - "member":{"shape":"DocumentationVersion"} - }, - "ListOfDomainName":{ - "type":"list", - "member":{"shape":"DomainName"} - }, - "ListOfEndpointType":{ - "type":"list", - "member":{"shape":"EndpointType"} - }, - "ListOfGatewayResponse":{ - "type":"list", - "member":{"shape":"GatewayResponse"} - }, - "ListOfLong":{ - "type":"list", - "member":{"shape":"Long"} - }, - "ListOfModel":{ - "type":"list", - "member":{"shape":"Model"} - }, - "ListOfPatchOperation":{ - "type":"list", - "member":{"shape":"PatchOperation"}, - "documentation":"A list of operations describing the updates to apply to the specified resource. The patches are applied in the order specified in the list." - }, - "ListOfRequestValidator":{ - "type":"list", - "member":{"shape":"RequestValidator"} - }, - "ListOfResource":{ - "type":"list", - "member":{"shape":"Resource"} - }, - "ListOfRestApi":{ - "type":"list", - "member":{"shape":"RestApi"} - }, - "ListOfSdkConfigurationProperty":{ - "type":"list", - "member":{"shape":"SdkConfigurationProperty"} - }, - "ListOfSdkType":{ - "type":"list", - "member":{"shape":"SdkType"} - }, - "ListOfStage":{ - "type":"list", - "member":{"shape":"Stage"} - }, - "ListOfStageKeys":{ - "type":"list", - "member":{"shape":"StageKey"} - }, - "ListOfString":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListOfUsage":{ - "type":"list", - "member":{"shape":"ListOfLong"} - }, - "ListOfUsagePlan":{ - "type":"list", - "member":{"shape":"UsagePlan"} - }, - "ListOfUsagePlanKey":{ - "type":"list", - "member":{"shape":"UsagePlanKey"} - }, - "ListOfVpcLink":{ - "type":"list", - "member":{"shape":"VpcLink"} - }, - "LocationStatusType":{ - "type":"string", - "enum":[ - "DOCUMENTED", - "UNDOCUMENTED" - ] - }, - "Long":{"type":"long"}, - "MapOfApiStageThrottleSettings":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"ThrottleSettings"} - }, - "MapOfHeaderValues":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "MapOfIntegrationResponse":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"IntegrationResponse"} - }, - "MapOfKeyUsages":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"ListOfUsage"} - }, - "MapOfMethod":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"Method"} - }, - "MapOfMethodResponse":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"MethodResponse"} - }, - "MapOfMethodSettings":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"MethodSetting"} - }, - "MapOfMethodSnapshot":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"MethodSnapshot"} - }, - "MapOfStringToBoolean":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"NullableBoolean"} - }, - "MapOfStringToList":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"ListOfString"} - }, - "MapOfStringToString":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Method":{ - "type":"structure", - "members":{ - "httpMethod":{ - "shape":"String", - "documentation":"

The method's HTTP verb.

" - }, - "authorizationType":{ - "shape":"String", - "documentation":"

The method's authorization type. Valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS for using a Cognito user pool.

" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

The identifier of an Authorizer to use on this method. The authorizationType must be CUSTOM.

" - }, - "apiKeyRequired":{ - "shape":"NullableBoolean", - "documentation":"

A boolean flag specifying whether a valid ApiKey is required to invoke this method.

" - }, - "requestValidatorId":{ - "shape":"String", - "documentation":"

The identifier of a RequestValidator for request validation.

" - }, - "operationName":{ - "shape":"String", - "documentation":"

A human-friendly operation identifier for the method. For example, you can assign the operationName of ListPets for the GET /pets method in PetStore example.

" - }, - "requestParameters":{ - "shape":"MapOfStringToBoolean", - "documentation":"

A key-value map defining required or optional method request parameters that can be accepted by API Gateway. A key is a method request parameter name matching the pattern of method.request.{location}.{name}, where location is querystring, path, or header and name is a valid and unique parameter name. The value associated with the key is a Boolean flag indicating whether the parameter is required (true) or optional (false). The method request parameter names defined here are available in Integration to be mapped to integration request parameters or templates.

" - }, - "requestModels":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map specifying data schemas, represented by Model resources, (as the mapped value) of the request payloads of given content types (as the mapping key).

" - }, - "methodResponses":{ - "shape":"MapOfMethodResponse", - "documentation":"

Gets a method response associated with a given HTTP status code.

The collection of method responses are encapsulated in a key-value map, where the key is a response's HTTP status code and the value is a MethodResponse resource that specifies the response returned to the caller from the back end through the integration response.

Example: Get a 200 OK response of a GET method

Request

GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com Content-Length: 117 X-Amz-Date: 20160613T215008Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response

The successful response returns a 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html\", \"name\": \"methodresponse\", \"templated\": true }, \"self\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200\", \"title\": \"200\" }, \"methodresponse:delete\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200\" }, \"methodresponse:update\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200\" } }, \"responseModels\": { \"application/json\": \"Empty\" }, \"responseParameters\": { \"method.response.header.operator\": false, \"method.response.header.operand_2\": false, \"method.response.header.operand_1\": false }, \"statusCode\": \"200\" }

" - }, - "methodIntegration":{ - "shape":"Integration", - "documentation":"

Gets the method's integration responsible for passing the client-submitted request to the back end and performing necessary transformations to make the request compliant with the back end.

Example:

Request

GET /restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com Content-Length: 117 X-Amz-Date: 20160613T213210Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160613/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response

The successful response returns a 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": [ { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html\", \"name\": \"integration\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html\", \"name\": \"integrationresponse\", \"templated\": true } ], \"self\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration\" }, \"integration:delete\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration\" }, \"integration:responses\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integration:update\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration\" }, \"integrationresponse:put\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/{status_code}\", \"templated\": true } }, \"cacheKeyParameters\": [], \"cacheNamespace\": \"0cjtch\", \"credentials\": \"arn:aws:iam::123456789012:role/apigAwsProxyRole\", \"httpMethod\": \"POST\", \"passthroughBehavior\": \"WHEN_NO_MATCH\", \"requestTemplates\": { \"application/json\": \"{\\n \\\"a\\\": \\\"$input.params('operand1')\\\",\\n \\\"b\\\": \\\"$input.params('operand2')\\\", \\n \\\"op\\\": \\\"$input.params('operator')\\\" \\n}\" }, \"type\": \"AWS\", \"uri\": \"arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations\", \"_embedded\": { \"integration:responses\": { \"_links\": { \"self\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integrationresponse:delete\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200\" }, \"integrationresponse:update\": { \"href\": \"/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200\" } }, \"responseParameters\": { \"method.response.header.operator\": \"integration.response.body.op\", \"method.response.header.operand_2\": \"integration.response.body.b\", \"method.response.header.operand_1\": \"integration.response.body.a\" }, \"responseTemplates\": { \"application/json\": \"#set($res = $input.path('$'))\\n{\\n \\\"result\\\": \\\"$res.a, $res.b, $res.op => $res.c\\\",\\n \\\"a\\\" : \\\"$res.a\\\",\\n \\\"b\\\" : \\\"$res.b\\\",\\n \\\"op\\\" : \\\"$res.op\\\",\\n \\\"c\\\" : \\\"$res.c\\\"\\n}\" }, \"selectionPattern\": \"\", \"statusCode\": \"200\" } } }

" - }, - "authorizationScopes":{ - "shape":"ListOfString", - "documentation":"

A list of authorization scopes configured on the method. The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation. The authorization works by matching the method scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any method scopes matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the method scope is configured, the client must provide an access token instead of an identity token for authorization purposes.

" - } - }, - "documentation":"

Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resource. Both consist of a request and one or more responses. The method request takes the client input that is passed to the back end through the integration request. A method response returns the output from the back end to the client through an integration response. A method request is embodied in a Method resource, whereas an integration request is embodied in an Integration resource. On the other hand, a method response is represented by a MethodResponse resource, whereas an integration response is represented by an IntegrationResponse resource.

Example: Retrive the GET method on a specified resource

Request

The following example request retrieves the information about the GET method on an API resource (3kzxbg5sa2) of an API (fugvjdxtri).

GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T210259Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response

The successful response returns a 200 OK status code and a payload similar to the following:

{ \"_links\": { \"curies\": [ { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html\", \"name\": \"integration\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html\", \"name\": \"integrationresponse\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html\", \"name\": \"method\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html\", \"name\": \"methodresponse\", \"templated\": true } ], \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\", \"name\": \"GET\", \"title\": \"GET\" }, \"integration:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"method:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\" }, \"method:integration\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"method:responses\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"method:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\" }, \"methodresponse:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}\", \"templated\": true } }, \"apiKeyRequired\": true, \"authorizationType\": \"NONE\", \"httpMethod\": \"GET\", \"_embedded\": { \"method:integration\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integration:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integration:responses\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integration:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integrationresponse:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}\", \"templated\": true } }, \"cacheKeyParameters\": [], \"cacheNamespace\": \"3kzxbg5sa2\", \"credentials\": \"arn:aws:iam::123456789012:role/apigAwsProxyRole\", \"httpMethod\": \"POST\", \"passthroughBehavior\": \"WHEN_NO_MATCH\", \"requestParameters\": { \"integration.request.header.Content-Type\": \"'application/x-amz-json-1.1'\" }, \"requestTemplates\": { \"application/json\": \"{\\n}\" }, \"type\": \"AWS\", \"uri\": \"arn:aws:apigateway:us-east-1:kinesis:action/ListStreams\", \"_embedded\": { \"integration:responses\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integrationresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" }, \"integrationresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" } }, \"responseParameters\": { \"method.response.header.Content-Type\": \"'application/xml'\" }, \"responseTemplates\": { \"application/json\": \"$util.urlDecode(\\\"%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E\\\")\" }, \"statusCode\": \"200\" } } }, \"method:responses\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"methodresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" }, \"methodresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" } }, \"responseModels\": { \"application/json\": \"Empty\" }, \"responseParameters\": { \"method.response.header.Content-Type\": false }, \"statusCode\": \"200\" } } }

In the example above, the response template for the 200 OK response maps the JSON output from the ListStreams action in the back end to an XML output. The mapping template is URL-encoded as %3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E and the output is decoded using the $util.urlDecode() helper function.

" - }, - "MethodResponse":{ - "type":"structure", - "members":{ - "statusCode":{ - "shape":"StatusCode", - "documentation":"

The method response's status code.

" - }, - "responseParameters":{ - "shape":"MapOfStringToBoolean", - "documentation":"

A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header and the value specifies whether the associated method response header is required or not. The expression of the key must match the pattern method.response.header.{name}, where name is a valid and unique header name. API Gateway passes certain integration response data to the method response headers specified here according to the mapping you prescribe in the API's IntegrationResponse. The integration response data that can be mapped include an integration response header expressed in integration.response.header.{name}, a static value enclosed within a pair of single quotes (e.g., 'application/json'), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression}, where JSON-expression is a valid JSON expression without the $ prefix.)

" - }, - "responseModels":{ - "shape":"MapOfStringToString", - "documentation":"

Specifies the Model resources used for the response's content-type. Response models are represented as a key/value map, with a content-type as the key and a Model name as the value.

" - } - }, - "documentation":"

Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.

Example: A MethodResponse instance of an API

Request

The example request retrieves a MethodResponse of the 200 status code.

GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response

The successful response returns 200 OK status and a payload as follows:

{ \"_links\": { \"curies\": { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html\", \"name\": \"methodresponse\", \"templated\": true }, \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\", \"title\": \"200\" }, \"methodresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" }, \"methodresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" } }, \"responseModels\": { \"application/json\": \"Empty\" }, \"responseParameters\": { \"method.response.header.Content-Type\": false }, \"statusCode\": \"200\" }

" - }, - "MethodSetting":{ - "type":"structure", - "members":{ - "metricsEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether Amazon CloudWatch metrics are enabled for this method. The PATCH path for this setting is /{method_setting_key}/metrics/enabled, and the value is a Boolean.

" - }, - "loggingLevel":{ - "shape":"String", - "documentation":"

Specifies the logging level for this method, which effects the log entries pushed to Amazon CloudWatch Logs. The PATCH path for this setting is /{method_setting_key}/logging/loglevel, and the available levels are OFF, ERROR, and INFO.

" - }, - "dataTraceEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether data trace logging is enabled for this method, which effects the log entries pushed to Amazon CloudWatch Logs. The PATCH path for this setting is /{method_setting_key}/logging/dataTrace, and the value is a Boolean.

" - }, - "throttlingBurstLimit":{ - "shape":"Integer", - "documentation":"

Specifies the throttling burst limit. The PATCH path for this setting is /{method_setting_key}/throttling/burstLimit, and the value is an integer.

" - }, - "throttlingRateLimit":{ - "shape":"Double", - "documentation":"

Specifies the throttling rate limit. The PATCH path for this setting is /{method_setting_key}/throttling/rateLimit, and the value is a double.

" - }, - "cachingEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether responses should be cached and returned for requests. A cache cluster must be enabled on the stage for responses to be cached. The PATCH path for this setting is /{method_setting_key}/caching/enabled, and the value is a Boolean.

" - }, - "cacheTtlInSeconds":{ - "shape":"Integer", - "documentation":"

Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response will be cached. The PATCH path for this setting is /{method_setting_key}/caching/ttlInSeconds, and the value is an integer.

" - }, - "cacheDataEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the cached responses are encrypted. The PATCH path for this setting is /{method_setting_key}/caching/dataEncrypted, and the value is a Boolean.

" - }, - "requireAuthorizationForCacheControl":{ - "shape":"Boolean", - "documentation":"

Specifies whether authorization is required for a cache invalidation request. The PATCH path for this setting is /{method_setting_key}/caching/requireAuthorizationForCacheControl, and the value is a Boolean.

" - }, - "unauthorizedCacheControlHeaderStrategy":{ - "shape":"UnauthorizedCacheControlHeaderStrategy", - "documentation":"

Specifies how to handle unauthorized requests for cache invalidation. The PATCH path for this setting is /{method_setting_key}/caching/unauthorizedCacheControlHeaderStrategy, and the available values are FAIL_WITH_403, SUCCEED_WITH_RESPONSE_HEADER, SUCCEED_WITHOUT_RESPONSE_HEADER.

" - } - }, - "documentation":"

Specifies the method setting properties.

" - }, - "MethodSnapshot":{ - "type":"structure", - "members":{ - "authorizationType":{ - "shape":"String", - "documentation":"

The method's authorization type. Valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS for using a Cognito user pool.

" - }, - "apiKeyRequired":{ - "shape":"Boolean", - "documentation":"

Specifies whether the method requires a valid ApiKey.

" - } - }, - "documentation":"

Represents a summary of a Method resource, given a particular date and time.

" - }, - "Model":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier for the model resource.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the model. Must be an alphanumeric string.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the model.

" - }, - "schema":{ - "shape":"String", - "documentation":"

The schema for the model. For application/json models, this should be JSON schema draft 4 model. Do not include \"\\*/\" characters in the description of any properties because such \"\\*/\" characters may be interpreted as the closing marker for comments in some languages, such as Java or JavaScript, causing the installation of your API's SDK generated by API Gateway to fail.

" - }, - "contentType":{ - "shape":"String", - "documentation":"

The content-type for the model.

" - } - }, - "documentation":"

Represents the data structure of a method's request or response payload.

A request model defines the data structure of the client-supplied request payload. A response model defines the data structure of the response payload returned by the back end. Although not required, models are useful for mapping payloads between the front end and back end.

A model is used for generating an API's SDK, validating the input request body, and creating a skeletal mapping template.

" - }, - "Models":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfModel", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of Model resources.

" - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The requested resource is not found. Make sure that the request URI is correct.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NullableBoolean":{"type":"boolean"}, - "NullableInteger":{"type":"integer"}, - "Op":{ - "type":"string", - "enum":[ - "add", - "remove", - "replace", - "move", - "copy", - "test" - ] - }, - "PatchOperation":{ - "type":"structure", - "members":{ - "op":{ - "shape":"Op", - "documentation":"

An update operation to be performed with this PATCH request. The valid value can be add, remove, replace or copy. Not all valid operations are supported for a given resource. Support of the operations depends on specific operational contexts. Attempts to apply an unsupported operation on a resource will return an error message.

" - }, - "path":{ - "shape":"String", - "documentation":"

The op operation's target, as identified by a JSON Pointer value that references a location within the targeted resource. For example, if the target resource has an updateable property of {\"name\":\"value\"}, the path for this property is /name. If the name property value is a JSON object (e.g., {\"name\": {\"child/name\": \"child-value\"}}), the path for the child/name property will be /name/child~1name. Any slash (\"/\") character appearing in path names must be escaped with \"~1\", as shown in the example above. Each op operation can have only one path associated with it.

" - }, - "value":{ - "shape":"String", - "documentation":"

The new target value of the update operation. It is applicable for the add or replace operation. When using AWS CLI to update a property of a JSON value, enclose the JSON object with a pair of single quotes in a Linux shell, e.g., '{\"a\": ...}'. In a Windows shell, see Using JSON for Parameters.

" - }, - "from":{ - "shape":"String", - "documentation":"

The copy update operation's source as identified by a JSON-Pointer value referencing the location within the targeted resource to copy the value from. For example, to promote a canary deployment, you copy the canary deployment ID to the affiliated deployment ID by calling a PATCH request on a Stage resource with \"op\":\"copy\", \"from\":\"/canarySettings/deploymentId\" and \"path\":\"/deploymentId\".

" - } - }, - "documentation":"A single patch operation to apply to the specified resource. Please refer to http://tools.ietf.org/html/rfc6902#section-4 for an explanation of how each operation is used." - }, - "PathToMapOfMethodSnapshot":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"MapOfMethodSnapshot"} - }, - "ProviderARN":{"type":"string"}, - "PutGatewayResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "responseType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "responseType":{ - "shape":"GatewayResponseType", - "documentation":"

[Required]

The response type of the associated GatewayResponse. Valid values are

  • ACCESS_DENIED
  • API_CONFIGURATION_ERROR
  • AUTHORIZER_FAILURE
  • AUTHORIZER_CONFIGURATION_ERROR
  • BAD_REQUEST_PARAMETERS
  • BAD_REQUEST_BODY
  • DEFAULT_4XX
  • DEFAULT_5XX
  • EXPIRED_TOKEN
  • INVALID_SIGNATURE
  • INTEGRATION_FAILURE
  • INTEGRATION_TIMEOUT
  • INVALID_API_KEY
  • MISSING_AUTHENTICATION_TOKEN
  • QUOTA_EXCEEDED
  • REQUEST_TOO_LARGE
  • RESOURCE_NOT_FOUND
  • THROTTLED
  • UNAUTHORIZED
  • UNSUPPORTED_MEDIA_TYPE

", - "location":"uri", - "locationName":"response_type" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"The HTTP status code of the GatewayResponse." - }, - "responseParameters":{ - "shape":"MapOfStringToString", - "documentation":"

Response parameters (paths, query strings and headers) of the GatewayResponse as a string-to-string map of key-value pairs.

" - }, - "responseTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Response templates of the GatewayResponse as a string-to-string map of key-value pairs.

" - } - }, - "documentation":"

Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.

" - }, - "PutIntegrationRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "type" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a put integration request's resource ID.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a put integration request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "type":{ - "shape":"IntegrationType", - "documentation":"

[Required] Specifies a put integration input's type.

" - }, - "integrationHttpMethod":{ - "shape":"String", - "documentation":"

Specifies a put integration HTTP method. When the integration type is HTTP or AWS, this field is required.

", - "locationName":"httpMethod" - }, - "uri":{ - "shape":"String", - "documentation":"

Specifies Uniform Resource Identifier (URI) of the integration endpoint.

  • For HTTP or HTTP_PROXY integrations, the URI must be a fully formed, encoded HTTP(S) URL according to the RFC-3986 specification, for either standard integration, where connectionType is not VPC_LINK, or private integration, where connectionType is VPC_LINK. For a private HTTP integration, the URI is not used for routing.

  • For AWS or AWS_PROXY integrations, the URI is of the form arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api}. Here, {Region} is the API Gateway region (e.g., us-east-1); {service} is the name of the integrated AWS service (e.g., s3); and {subdomain} is a designated subdomain supported by certain AWS service for fast host-name lookup. action can be used for an AWS service action-based API, using an Action={name}&{p1}={v1}&p2={v2}... query string. The ensuing {service_api} refers to a supported action {name} plus any required input parameters. Alternatively, path can be used for an AWS service path-based API. The ensuing service_api refers to the path to an AWS service resource, including the region of the integrated AWS service, if applicable. For example, for integration with the S3 API of GetObject, the uri can be either arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} or arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key}

" - }, - "connectionType":{ - "shape":"ConnectionType", - "documentation":"

The type of the network connection to the integration endpoint. The valid value is INTERNET for connections through the public routable internet or VPC_LINK for private connections between API Gateway and a network load balancer in a VPC. The default value is INTERNET.

" - }, - "connectionId":{ - "shape":"String", - "documentation":"

The (id) of the VpcLink used for the integration when connectionType=VPC_LINK and undefined, otherwise.

" - }, - "credentials":{ - "shape":"String", - "documentation":"

Specifies whether credentials are required for a put integration.

" - }, - "requestParameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map specifying request parameters that are passed from the method request to the back end. The key is an integration request parameter name and the associated value is a method request parameter value or static value that must be enclosed within single quotes and pre-encoded as required by the back end. The method request parameter value must match the pattern of method.request.{location}.{name}, where location is querystring, path, or header and name must be a valid and unique method request parameter name.

" - }, - "requestTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Represents a map of Velocity templates that are applied on the request payload based on the value of the Content-Type header sent by the client. The content type value is the key in this map, and the template (as a String) is the value.

" - }, - "passthroughBehavior":{ - "shape":"String", - "documentation":"

Specifies the pass-through behavior for incoming requests based on the Content-Type header in the request, and the available mapping templates specified as the requestTemplates property on the Integration resource. There are three valid values: WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and NEVER.

  • WHEN_NO_MATCH passes the request body for unmapped content types through to the integration back end without transformation.

  • NEVER rejects unmapped content types with an HTTP 415 'Unsupported Media Type' response.

  • WHEN_NO_TEMPLATES allows pass-through when the integration has NO content types mapped to templates. However if there is at least one content type defined, unmapped content types will be rejected with the same 415 response.

" - }, - "cacheNamespace":{ - "shape":"String", - "documentation":"

Specifies a put integration input's cache namespace.

" - }, - "cacheKeyParameters":{ - "shape":"ListOfString", - "documentation":"

Specifies a put integration input's cache key parameters.

" - }, - "contentHandling":{ - "shape":"ContentHandlingStrategy", - "documentation":"

Specifies how to handle request payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:

  • CONVERT_TO_BINARY: Converts a request payload from a Base64-encoded string to the corresponding binary blob.

  • CONVERT_TO_TEXT: Converts a request payload from a binary blob to a Base64-encoded string.

If this property is not defined, the request payload will be passed through from the method request to integration request without modification, provided that the passthroughBehaviors is configured to support payload pass-through.

" - }, - "timeoutInMillis":{ - "shape":"NullableInteger", - "documentation":"

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000 milliseconds or 29 seconds.

" - } - }, - "documentation":"

Sets up a method's integration.

" - }, - "PutIntegrationResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a put integration response request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a put integration response request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] Specifies the status code that is used to map the integration response to an existing MethodResponse.

", - "location":"uri", - "locationName":"status_code" - }, - "selectionPattern":{ - "shape":"String", - "documentation":"

Specifies the selection pattern of a put integration response.

" - }, - "responseParameters":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map specifying response parameters that are passed to the method response from the back end. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The mapped non-static value must match the pattern of integration.response.header.{name} or integration.response.body.{JSON-expression}, where name must be a valid and unique response header name and JSON-expression a valid JSON expression without the $ prefix.

" - }, - "responseTemplates":{ - "shape":"MapOfStringToString", - "documentation":"

Specifies a put integration response's templates.

" - }, - "contentHandling":{ - "shape":"ContentHandlingStrategy", - "documentation":"

Specifies how to handle response payload content type conversions. Supported values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the following behaviors:

  • CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.

  • CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.

If this property is not defined, the response payload will be passed through from the integration response to the method response without modification.

" - } - }, - "documentation":"

Represents a put integration response request.

" - }, - "PutMethodRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "authorizationType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the new Method resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies the method request's HTTP method type.

", - "location":"uri", - "locationName":"http_method" - }, - "authorizationType":{ - "shape":"String", - "documentation":"

[Required] The method's authorization type. Valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, CUSTOM for using a custom authorizer, or COGNITO_USER_POOLS for using a Cognito user pool.

" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

Specifies the identifier of an Authorizer to use on this Method, if the type is CUSTOM or COGNITO_USER_POOLS. The authorizer identifier is generated by API Gateway when you created the authorizer.

" - }, - "apiKeyRequired":{ - "shape":"Boolean", - "documentation":"

Specifies whether the method required a valid ApiKey.

" - }, - "operationName":{ - "shape":"String", - "documentation":"

A human-friendly operation identifier for the method. For example, you can assign the operationName of ListPets for the GET /pets method in PetStore example.

" - }, - "requestParameters":{ - "shape":"MapOfStringToBoolean", - "documentation":"

A key-value map defining required or optional method request parameters that can be accepted by API Gateway. A key defines a method request parameter name matching the pattern of method.request.{location}.{name}, where location is querystring, path, or header and name is a valid and unique parameter name. The value associated with the key is a Boolean flag indicating whether the parameter is required (true) or optional (false). The method request parameter names defined here are available in Integration to be mapped to integration request parameters or body-mapping templates.

" - }, - "requestModels":{ - "shape":"MapOfStringToString", - "documentation":"

Specifies the Model resources used for the request's content type. Request models are represented as a key/value map, with a content type as the key and a Model name as the value.

" - }, - "requestValidatorId":{ - "shape":"String", - "documentation":"

The identifier of a RequestValidator for validating the method request.

" - }, - "authorizationScopes":{ - "shape":"ListOfString", - "documentation":"

A list of authorization scopes configured on the method. The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation. The authorization works by matching the method scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any method scopes matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the method scope is configured, the client must provide an access token instead of an identity token for authorization purposes.

" - } - }, - "documentation":"

Request to add a method to an existing Resource resource.

" - }, - "PutMethodResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the Method resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] The method response's status code.

", - "location":"uri", - "locationName":"status_code" - }, - "responseParameters":{ - "shape":"MapOfStringToBoolean", - "documentation":"

A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header name and the associated value is a Boolean flag indicating whether the method response parameter is required or not. The method response header names must match the pattern of method.response.header.{name}, where name is a valid and unique header name. The response parameter names defined here are available in the integration response to be mapped from an integration response header expressed in integration.response.header.{name}, a static value enclosed within a pair of single quotes (e.g., 'application/json'), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression}, where JSON-expression is a valid JSON expression without the $ prefix.)

" - }, - "responseModels":{ - "shape":"MapOfStringToString", - "documentation":"

Specifies the Model resources used for the response's content type. Response models are represented as a key/value map, with a content type as the key and a Model name as the value.

" - } - }, - "documentation":"

Request to add a MethodResponse to an existing Method resource.

" - }, - "PutMode":{ - "type":"string", - "enum":[ - "merge", - "overwrite" - ] - }, - "PutRestApiRequest":{ - "type":"structure", - "required":[ - "restApiId", - "body" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "mode":{ - "shape":"PutMode", - "documentation":"

The mode query parameter to specify the update mode. Valid values are \"merge\" and \"overwrite\". By default, the update mode is \"merge\".

", - "location":"querystring", - "locationName":"mode" - }, - "failOnWarnings":{ - "shape":"Boolean", - "documentation":"

A query parameter to indicate whether to rollback the API update (true) or not (false) when a warning is encountered. The default value is false.

", - "location":"querystring", - "locationName":"failonwarnings" - }, - "parameters":{ - "shape":"MapOfStringToString", - "documentation":"

Custom header parameters as part of the request. For example, to exclude DocumentationParts from an imported API, set ignore=documentation as a parameters value, as in the AWS CLI command of aws apigateway import-rest-api --parameters ignore=documentation --body 'file:///path/to/imported-api-body.json'.

", - "location":"querystring" - }, - "body":{ - "shape":"Blob", - "documentation":"

[Required] The PUT request body containing external API definitions. Currently, only Swagger definition JSON files are supported. The maximum size of the API definition file is 2MB.

" - } - }, - "documentation":"

A PUT request to update an existing API, with external API definitions specified as the request body.

", - "payload":"body" - }, - "QuotaPeriodType":{ - "type":"string", - "enum":[ - "DAY", - "WEEK", - "MONTH" - ] - }, - "QuotaSettings":{ - "type":"structure", - "members":{ - "limit":{ - "shape":"Integer", - "documentation":"

The maximum number of requests that can be made in a given time period.

" - }, - "offset":{ - "shape":"Integer", - "documentation":"

The number of requests subtracted from the given limit in the initial time period.

" - }, - "period":{ - "shape":"QuotaPeriodType", - "documentation":"

The time period in which the limit applies. Valid values are \"DAY\", \"WEEK\" or \"MONTH\".

" - } - }, - "documentation":"

Quotas configured for a usage plan.

" - }, - "RequestValidator":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier of this RequestValidator.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of this RequestValidator

" - }, - "validateRequestBody":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether to validate a request body according to the configured Model schema.

" - }, - "validateRequestParameters":{ - "shape":"Boolean", - "documentation":"

A Boolean flag to indicate whether to validate request parameters (true) or not (false).

" - } - }, - "documentation":"

A set of validation rules for incoming Method requests.

In Swagger, a RequestValidator of an API is defined by the x-amazon-apigateway-request-validators.requestValidator object. It the referenced using the x-amazon-apigateway-request-validator property.

" - }, - "RequestValidators":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfRequestValidator", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

A collection of RequestValidator resources of a given RestApi.

In Swagger, the RequestValidators of an API is defined by the x-amazon-apigateway-request-validators extension.

" - }, - "Resource":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The resource's identifier.

" - }, - "parentId":{ - "shape":"String", - "documentation":"

The parent resource's identifier.

" - }, - "pathPart":{ - "shape":"String", - "documentation":"

The last path segment for this resource.

" - }, - "path":{ - "shape":"String", - "documentation":"

The full path for this resource.

" - }, - "resourceMethods":{ - "shape":"MapOfMethod", - "documentation":"

Gets an API resource's method of a given HTTP verb.

The resource methods are a map of methods indexed by methods' HTTP verbs enabled on the resource. This method map is included in the 200 OK response of the GET /restapis/{restapi_id}/resources/{resource_id} or GET /restapis/{restapi_id}/resources/{resource_id}?embed=methods request.

Example: Get the GET method of an API resource

Request
GET /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20170223T031827Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20170223/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
{ \"_links\": { \"curies\": [ { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-{rel}.html\", \"name\": \"integration\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-{rel}.html\", \"name\": \"integrationresponse\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-{rel}.html\", \"name\": \"method\", \"templated\": true }, { \"href\": \"http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html\", \"name\": \"methodresponse\", \"templated\": true } ], \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\", \"name\": \"GET\", \"title\": \"GET\" }, \"integration:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"method:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\" }, \"method:integration\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"method:responses\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"method:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET\" }, \"methodresponse:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/{status_code}\", \"templated\": true } }, \"apiKeyRequired\": false, \"authorizationType\": \"NONE\", \"httpMethod\": \"GET\", \"_embedded\": { \"method:integration\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integration:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integration:responses\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integration:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration\" }, \"integrationresponse:put\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/{status_code}\", \"templated\": true } }, \"cacheKeyParameters\": [], \"cacheNamespace\": \"3kzxbg5sa2\", \"credentials\": \"arn:aws:iam::123456789012:role/apigAwsProxyRole\", \"httpMethod\": \"POST\", \"passthroughBehavior\": \"WHEN_NO_MATCH\", \"requestParameters\": { \"integration.request.header.Content-Type\": \"'application/x-amz-json-1.1'\" }, \"requestTemplates\": { \"application/json\": \"{\\n}\" }, \"type\": \"AWS\", \"uri\": \"arn:aws:apigateway:us-east-1:kinesis:action/ListStreams\", \"_embedded\": { \"integration:responses\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"integrationresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" }, \"integrationresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200\" } }, \"responseParameters\": { \"method.response.header.Content-Type\": \"'application/xml'\" }, \"responseTemplates\": { \"application/json\": \"$util.urlDecode(\\\"%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E\\\")\\n\" }, \"statusCode\": \"200\" } } }, \"method:responses\": { \"_links\": { \"self\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\", \"name\": \"200\", \"title\": \"200\" }, \"methodresponse:delete\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" }, \"methodresponse:update\": { \"href\": \"/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200\" } }, \"responseModels\": { \"application/json\": \"Empty\" }, \"responseParameters\": { \"method.response.header.Content-Type\": false }, \"statusCode\": \"200\" } } }

If the OPTIONS is enabled on the resource, you can follow the example here to get that method. Just replace the GET of the last path segment in the request URL with OPTIONS.

" - } - }, - "documentation":"

Represents an API resource.

" - }, - "Resources":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfResource", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of Resource resources.

" - }, - "RestApi":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The API's identifier. This identifier is unique across all of your APIs in API Gateway.

" - }, - "name":{ - "shape":"String", - "documentation":"

The API's name.

" - }, - "description":{ - "shape":"String", - "documentation":"

The API's description.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the API was created.

" - }, - "version":{ - "shape":"String", - "documentation":"

A version identifier for the API.

" - }, - "warnings":{ - "shape":"ListOfString", - "documentation":"

The warning messages reported when failonwarnings is turned on during API import.

" - }, - "binaryMediaTypes":{ - "shape":"ListOfString", - "documentation":"

The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.

" - }, - "minimumCompressionSize":{ - "shape":"NullableInteger", - "documentation":"

A nullable integer that is used to enable compression (with non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable compression (with a null value) on an API. When compression is enabled, compression or decompression is not applied on the payload if the payload size is smaller than this value. Setting it to zero allows compression for any payload size.

" - }, - "apiKeySource":{ - "shape":"ApiKeySourceType", - "documentation":"

The source of the API key for metering requests according to a usage plan. Valid values are:

  • HEADER to read the API key from the X-API-Key header of a request.
  • AUTHORIZER to read the API key from the UsageIdentifierKey from a custom authorizer.

" - }, - "endpointConfiguration":{ - "shape":"EndpointConfiguration", - "documentation":"

The endpoint configuration of this RestApi showing the endpoint types of the API.

" - }, - "policy":{ - "shape":"String", - "documentation":"A stringified JSON policy document that applies to this RestApi regardless of the caller and Method configuration." - } - }, - "documentation":"

Represents a REST API.

" - }, - "RestApis":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfRestApi", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Contains references to your APIs and links that guide you in how to interact with your collection. A collection offers a paginated view of your APIs.

" - }, - "SdkConfigurationProperty":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of a an SdkType configuration property.

" - }, - "friendlyName":{ - "shape":"String", - "documentation":"

The user-friendly name of an SdkType configuration property.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of an SdkType configuration property.

" - }, - "required":{ - "shape":"Boolean", - "documentation":"

A boolean flag of an SdkType configuration property to indicate if the associated SDK configuration property is required (true) or not (false).

" - }, - "defaultValue":{ - "shape":"String", - "documentation":"

The default value of an SdkType configuration property.

" - } - }, - "documentation":"

A configuration property of an SDK type.

" - }, - "SdkResponse":{ - "type":"structure", - "members":{ - "contentType":{ - "shape":"String", - "documentation":"

The content-type header value in the HTTP response.

", - "location":"header", - "locationName":"Content-Type" - }, - "contentDisposition":{ - "shape":"String", - "documentation":"

The content-disposition header value in the HTTP response.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "body":{ - "shape":"Blob", - "documentation":"

The binary blob response to GetSdk, which contains the generated SDK.

" - } - }, - "documentation":"

The binary blob response to GetSdk, which contains the generated SDK.

", - "payload":"body" - }, - "SdkType":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier of an SdkType instance.

" - }, - "friendlyName":{ - "shape":"String", - "documentation":"

The user-friendly name of an SdkType instance.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of an SdkType.

" - }, - "configurationProperties":{ - "shape":"ListOfSdkConfigurationProperty", - "documentation":"

A list of configuration properties of an SdkType.

" - } - }, - "documentation":"

A type of SDK that API Gateway can generate.

" - }, - "SdkTypes":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfSdkType", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

The collection of SdkType instances.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"String"} - }, - "documentation":"

The requested service is not available. For details see the accompanying error message. Retry after the specified time period.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "Stage":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"String", - "documentation":"

The identifier of the Deployment that the stage points to.

" - }, - "clientCertificateId":{ - "shape":"String", - "documentation":"

The identifier of a client certificate for an API stage.

" - }, - "stageName":{ - "shape":"String", - "documentation":"

The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway.

" - }, - "description":{ - "shape":"String", - "documentation":"

The stage's description.

" - }, - "cacheClusterEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether a cache cluster is enabled for the stage.

" - }, - "cacheClusterSize":{ - "shape":"CacheClusterSize", - "documentation":"

The size of the cache cluster for the stage, if enabled.

" - }, - "cacheClusterStatus":{ - "shape":"CacheClusterStatus", - "documentation":"

The status of the cache cluster for the stage, if enabled.

" - }, - "methodSettings":{ - "shape":"MapOfMethodSettings", - "documentation":"

A map that defines the method settings for a Stage resource. Keys (designated as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} for an individual method override, or /\\*/\\* for overriding all methods in the stage.

" - }, - "variables":{ - "shape":"MapOfStringToString", - "documentation":"

A map that defines the stage variables for a Stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

The version of the associated API documentation.

" - }, - "accessLogSettings":{ - "shape":"AccessLogSettings", - "documentation":"

Settings for logging access in this stage.

" - }, - "canarySettings":{ - "shape":"CanarySettings", - "documentation":"

Settings for the canary deployment in this stage.

" - }, - "tags":{ - "shape":"MapOfStringToString", - "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the stage was created.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The timestamp when the stage last updated.

" - } - }, - "documentation":"

Represents a unique identifier for a version of a deployed RestApi that is callable by users.

" - }, - "StageKey":{ - "type":"structure", - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

The string identifier of the associated RestApi.

" - }, - "stageName":{ - "shape":"String", - "documentation":"

The stage name associated with the stage key.

" - } - }, - "documentation":"

A reference to a unique stage identified in the format {restApiId}/{stage}.

" - }, - "Stages":{ - "type":"structure", - "members":{ - "item":{ - "shape":"ListOfStage", - "documentation":"

The current page of elements from this collection.

" - } - }, - "documentation":"

A list of Stage resources that are associated with the ApiKey resource.

" - }, - "StatusCode":{ - "type":"string", - "documentation":"

The status code.

", - "pattern":"[1-5]\\d\\d" - }, - "String":{"type":"string"}, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tags" - ], - "members":{ - "resourceArn":{ - "shape":"String", - "documentation":"

[Required] The ARN of a resource that can be tagged. The resource ARN must be URL-encoded. At present, Stage is the only taggable resource.

", - "location":"uri", - "locationName":"resource_arn" - }, - "tags":{ - "shape":"MapOfStringToString", - "documentation":"

[Required] The key-value map of strings. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start with aws:. The tag value can be up to 256 characters.

" - } - }, - "documentation":"

Adds or updates a tag on a given resource.

" - }, - "Tags":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"MapOfStringToString", - "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" - } - }, - "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" - }, - "Template":{ - "type":"structure", - "members":{ - "value":{ - "shape":"String", - "documentation":"

The Apache Velocity Template Language (VTL) template content used for the template resource.

" - } - }, - "documentation":"

Represents a mapping template used to transform a payload.

" - }, - "TestInvokeAuthorizerRequest":{ - "type":"structure", - "required":[ - "restApiId", - "authorizerId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

[Required] Specifies a test invoke authorizer request's Authorizer ID.

", - "location":"uri", - "locationName":"authorizer_id" - }, - "headers":{ - "shape":"MapOfHeaderValues", - "documentation":"

[Required] A key-value map of headers to simulate an incoming invocation request. This is where the incoming authorization token, or identity source, should be specified.

" - }, - "pathWithQueryString":{ - "shape":"String", - "documentation":"

[Optional] The URI path, including query string, of the simulated invocation request. Use this to specify path parameters and query string parameters.

" - }, - "body":{ - "shape":"String", - "documentation":"

[Optional] The simulated request body of an incoming invocation request.

" - }, - "stageVariables":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map of stage variables to simulate an invocation on a deployed Stage.

" - }, - "additionalContext":{ - "shape":"MapOfStringToString", - "documentation":"

[Optional] A key-value map of additional context variables.

" - } - }, - "documentation":"

Make a request to simulate the execution of an Authorizer.

" - }, - "TestInvokeAuthorizerResponse":{ - "type":"structure", - "members":{ - "clientStatus":{ - "shape":"Integer", - "documentation":"

The HTTP status code that the client would have received. Value is 0 if the authorizer succeeded.

" - }, - "log":{ - "shape":"String", - "documentation":"

The API Gateway execution log for the test authorizer request.

" - }, - "latency":{ - "shape":"Long", - "documentation":"

The execution latency of the test authorizer request.

" - }, - "principalId":{ - "shape":"String", - "documentation":"

The principal identity returned by the Authorizer

" - }, - "policy":{ - "shape":"String", - "documentation":"

The JSON policy document returned by the Authorizer

" - }, - "authorization":{"shape":"MapOfStringToList"}, - "claims":{ - "shape":"MapOfStringToString", - "documentation":"

The open identity claims, with any supported custom attributes, returned from the Cognito Your User Pool configured for the API.

" - } - }, - "documentation":"

Represents the response of the test invoke request for a custom Authorizer

" - }, - "TestInvokeMethodRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies a test invoke method request's resource ID.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies a test invoke method request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "pathWithQueryString":{ - "shape":"String", - "documentation":"

The URI path, including query string, of the simulated invocation request. Use this to specify path parameters and query string parameters.

" - }, - "body":{ - "shape":"String", - "documentation":"

The simulated request body of an incoming invocation request.

" - }, - "headers":{ - "shape":"MapOfHeaderValues", - "documentation":"

A key-value map of headers to simulate an incoming invocation request.

" - }, - "clientCertificateId":{ - "shape":"String", - "documentation":"

A ClientCertificate identifier to use in the test invocation. API Gateway will use the certificate when making the HTTPS request to the defined back-end endpoint.

" - }, - "stageVariables":{ - "shape":"MapOfStringToString", - "documentation":"

A key-value map of stage variables to simulate an invocation on a deployed Stage.

" - } - }, - "documentation":"

Make a request to simulate the execution of a Method.

" - }, - "TestInvokeMethodResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"Integer", - "documentation":"

The HTTP status code.

" - }, - "body":{ - "shape":"String", - "documentation":"

The body of the HTTP response.

" - }, - "headers":{ - "shape":"MapOfHeaderValues", - "documentation":"

The headers of the HTTP response.

" - }, - "log":{ - "shape":"String", - "documentation":"

The API Gateway execution log for the test invoke request.

" - }, - "latency":{ - "shape":"Long", - "documentation":"

The execution latency of the test invoke request.

" - } - }, - "documentation":"

Represents the response of the test invoke request in the HTTP method.

" - }, - "ThrottleSettings":{ - "type":"structure", - "members":{ - "burstLimit":{ - "shape":"Integer", - "documentation":"

The API request burst limit, the maximum rate limit over a time ranging from one to a few seconds, depending upon whether the underlying token bucket is at its full capacity.

" - }, - "rateLimit":{ - "shape":"Double", - "documentation":"

The API request steady-state rate limit.

" - } - }, - "documentation":"

The API request rate limits.

" - }, - "Timestamp":{"type":"timestamp"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"String"} - }, - "documentation":"

The request has reached its throttling limit. Retry after the specified time period.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UnauthorizedCacheControlHeaderStrategy":{ - "type":"string", - "enum":[ - "FAIL_WITH_403", - "SUCCEED_WITH_RESPONSE_HEADER", - "SUCCEED_WITHOUT_RESPONSE_HEADER" - ] - }, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request is denied because the caller has insufficient permissions.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tagKeys" - ], - "members":{ - "resourceArn":{ - "shape":"String", - "documentation":"

[Required] The ARN of a resource that can be tagged. The resource ARN must be URL-encoded. At present, Stage is the only taggable resource.

", - "location":"uri", - "locationName":"resource_arn" - }, - "tagKeys":{ - "shape":"ListOfString", - "documentation":"

[Required] The Tag keys to delete.

", - "location":"querystring", - "locationName":"tagKeys" - } - }, - "documentation":"

Removes a tag from a given resource.

" - }, - "UpdateAccountRequest":{ - "type":"structure", - "members":{ - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Requests API Gateway to change information about the current Account resource.

" - }, - "UpdateApiKeyRequest":{ - "type":"structure", - "required":["apiKey"], - "members":{ - "apiKey":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ApiKey resource to be updated.

", - "location":"uri", - "locationName":"api_Key" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

A request to change information about an ApiKey resource.

" - }, - "UpdateAuthorizerRequest":{ - "type":"structure", - "required":[ - "restApiId", - "authorizerId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "authorizerId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Authorizer resource.

", - "location":"uri", - "locationName":"authorizer_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Request to update an existing Authorizer resource.

" - }, - "UpdateBasePathMappingRequest":{ - "type":"structure", - "required":[ - "domainName", - "basePath" - ], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The domain name of the BasePathMapping resource to change.

", - "location":"uri", - "locationName":"domain_name" - }, - "basePath":{ - "shape":"String", - "documentation":"

[Required] The base path of the BasePathMapping resource to change.

", - "location":"uri", - "locationName":"base_path" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

A request to change information about the BasePathMapping resource.

" - }, - "UpdateClientCertificateRequest":{ - "type":"structure", - "required":["clientCertificateId"], - "members":{ - "clientCertificateId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the ClientCertificate resource to be updated.

", - "location":"uri", - "locationName":"clientcertificate_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

A request to change information about an ClientCertificate resource.

" - }, - "UpdateDeploymentRequest":{ - "type":"structure", - "required":[ - "restApiId", - "deploymentId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "deploymentId":{ - "shape":"String", - "documentation":"

The replacement identifier for the Deployment resource to change information about.

", - "location":"uri", - "locationName":"deployment_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Requests API Gateway to change information about a Deployment resource.

" - }, - "UpdateDocumentationPartRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationPartId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationPartId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the to-be-updated documentation part.

", - "location":"uri", - "locationName":"part_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Updates an existing documentation part of a given API.

" - }, - "UpdateDocumentationVersionRequest":{ - "type":"structure", - "required":[ - "restApiId", - "documentationVersion" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi..

", - "location":"uri", - "locationName":"restapi_id" - }, - "documentationVersion":{ - "shape":"String", - "documentation":"

[Required] The version identifier of the to-be-updated documentation version.

", - "location":"uri", - "locationName":"doc_version" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Updates an existing documentation version of an API.

" - }, - "UpdateDomainNameRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"String", - "documentation":"

[Required] The name of the DomainName resource to be changed.

", - "location":"uri", - "locationName":"domain_name" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

A request to change information about the DomainName resource.

" - }, - "UpdateGatewayResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "responseType" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "responseType":{ - "shape":"GatewayResponseType", - "documentation":"

[Required]

The response type of the associated GatewayResponse. Valid values are

  • ACCESS_DENIED
  • API_CONFIGURATION_ERROR
  • AUTHORIZER_FAILURE
  • AUTHORIZER_CONFIGURATION_ERROR
  • BAD_REQUEST_PARAMETERS
  • BAD_REQUEST_BODY
  • DEFAULT_4XX
  • DEFAULT_5XX
  • EXPIRED_TOKEN
  • INVALID_SIGNATURE
  • INTEGRATION_FAILURE
  • INTEGRATION_TIMEOUT
  • INVALID_API_KEY
  • MISSING_AUTHENTICATION_TOKEN
  • QUOTA_EXCEEDED
  • REQUEST_TOO_LARGE
  • RESOURCE_NOT_FOUND
  • THROTTLED
  • UNAUTHORIZED
  • UNSUPPORTED_MEDIA_TYPE

", - "location":"uri", - "locationName":"response_type" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Updates a GatewayResponse of a specified response type on the given RestApi.

" - }, - "UpdateIntegrationRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Represents an update integration request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Represents an update integration request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Represents an update integration request.

" - }, - "UpdateIntegrationResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] Specifies an update integration response request's resource identifier.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] Specifies an update integration response request's HTTP method.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] Specifies an update integration response request's status code.

", - "location":"uri", - "locationName":"status_code" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Represents an update integration response request.

" - }, - "UpdateMethodRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the Method resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Request to update an existing Method resource.

" - }, - "UpdateMethodResponseRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId", - "httpMethod", - "statusCode" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The Resource identifier for the MethodResponse resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "httpMethod":{ - "shape":"String", - "documentation":"

[Required] The HTTP verb of the Method resource.

", - "location":"uri", - "locationName":"http_method" - }, - "statusCode":{ - "shape":"StatusCode", - "documentation":"

[Required] The status code for the MethodResponse resource.

", - "location":"uri", - "locationName":"status_code" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

A request to update an existing MethodResponse resource.

" - }, - "UpdateModelRequest":{ - "type":"structure", - "required":[ - "restApiId", - "modelName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "modelName":{ - "shape":"String", - "documentation":"

[Required] The name of the model to update.

", - "location":"uri", - "locationName":"model_name" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Request to update an existing model in an existing RestApi resource.

" - }, - "UpdateRequestValidatorRequest":{ - "type":"structure", - "required":[ - "restApiId", - "requestValidatorId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "requestValidatorId":{ - "shape":"String", - "documentation":"

[Required] The identifier of RequestValidator to be updated.

", - "location":"uri", - "locationName":"requestvalidator_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Updates a RequestValidator of a given RestApi.

" - }, - "UpdateResourceRequest":{ - "type":"structure", - "required":[ - "restApiId", - "resourceId" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "resourceId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the Resource resource.

", - "location":"uri", - "locationName":"resource_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Request to change information about a Resource resource.

" - }, - "UpdateRestApiRequest":{ - "type":"structure", - "required":["restApiId"], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Request to update an existing RestApi resource in your collection.

" - }, - "UpdateStageRequest":{ - "type":"structure", - "required":[ - "restApiId", - "stageName" - ], - "members":{ - "restApiId":{ - "shape":"String", - "documentation":"

[Required] The string identifier of the associated RestApi.

", - "location":"uri", - "locationName":"restapi_id" - }, - "stageName":{ - "shape":"String", - "documentation":"

[Required] The name of the Stage resource to change information about.

", - "location":"uri", - "locationName":"stage_name" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Requests API Gateway to change information about a Stage resource.

" - }, - "UpdateUsagePlanRequest":{ - "type":"structure", - "required":["usagePlanId"], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the to-be-updated usage plan.

", - "location":"uri", - "locationName":"usageplanId" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

The PATCH request to update a usage plan of a given plan Id.

" - }, - "UpdateUsageRequest":{ - "type":"structure", - "required":[ - "usagePlanId", - "keyId" - ], - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

[Required] The Id of the usage plan associated with the usage data.

", - "location":"uri", - "locationName":"usageplanId" - }, - "keyId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the API key associated with the usage plan in which a temporary extension is granted to the remaining quota.

", - "location":"uri", - "locationName":"keyId" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

The PATCH request to grant a temporary extension to the remaining quota of a usage plan associated with a specified API key.

" - }, - "UpdateVpcLinkRequest":{ - "type":"structure", - "required":["vpcLinkId"], - "members":{ - "vpcLinkId":{ - "shape":"String", - "documentation":"

[Required] The identifier of the VpcLink. It is used in an Integration to reference this VpcLink.

", - "location":"uri", - "locationName":"vpclink_id" - }, - "patchOperations":{ - "shape":"ListOfPatchOperation", - "documentation":"

A list of update operations to be applied to the specified resource and in the order specified in this list.

" - } - }, - "documentation":"

Updates an existing VpcLink of a specified identifier.

" - }, - "Usage":{ - "type":"structure", - "members":{ - "usagePlanId":{ - "shape":"String", - "documentation":"

The plan Id associated with this usage data.

" - }, - "startDate":{ - "shape":"String", - "documentation":"

The starting date of the usage data.

" - }, - "endDate":{ - "shape":"String", - "documentation":"

The ending date of the usage data.

" - }, - "position":{"shape":"String"}, - "items":{ - "shape":"MapOfKeyUsages", - "documentation":"

The usage data, as daily logs of used and remaining quotas, over the specified time interval indexed over the API keys in a usage plan. For example, {..., \"values\" : { \"{api_key}\" : [ [0, 100], [10, 90], [100, 10]]}, where {api_key} stands for an API key value and the daily log entry is of the format [used quota, remaining quota].

", - "locationName":"values" - } - }, - "documentation":"

Represents the usage data of a usage plan.

" - }, - "UsagePlan":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier of a UsagePlan resource.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of a usage plan.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of a usage plan.

" - }, - "apiStages":{ - "shape":"ListOfApiStage", - "documentation":"

The associated API stages of a usage plan.

" - }, - "throttle":{ - "shape":"ThrottleSettings", - "documentation":"

The request throttle limits of a usage plan.

" - }, - "quota":{ - "shape":"QuotaSettings", - "documentation":"

The maximum number of permitted requests per a given unit time interval.

" - }, - "productCode":{ - "shape":"String", - "documentation":"

The AWS Markeplace product identifier to associate with the usage plan as a SaaS product on AWS Marketplace.

" - } - }, - "documentation":"

Represents a usage plan than can specify who can assess associated API stages with specified request limits and quotas.

In a usage plan, you associate an API by specifying the API's Id and a stage name of the specified API. You add plan customers by adding API keys to the plan.

" - }, - "UsagePlanKey":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The Id of a usage plan key.

" - }, - "type":{ - "shape":"String", - "documentation":"

The type of a usage plan key. Currently, the valid key type is API_KEY.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of a usage plan key.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of a usage plan key.

" - } - }, - "documentation":"

Represents a usage plan key to identify a plan customer.

To associate an API stage with a selected API key in a usage plan, you must create a UsagePlanKey resource to represent the selected ApiKey.

\" " - }, - "UsagePlanKeys":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfUsagePlanKey", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents the collection of usage plan keys added to usage plans for the associated API keys and, possibly, other types of keys.

" - }, - "UsagePlans":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfUsagePlan", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

Represents a collection of usage plans for an AWS account.

" - }, - "VpcLink":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The identifier of the VpcLink. It is used in an Integration to reference this VpcLink.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name used to label and identify the VPC link.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the VPC link.

" - }, - "targetArns":{ - "shape":"ListOfString", - "documentation":"

The ARNs of network load balancers of the VPC targeted by the VPC link. The network load balancers must be owned by the same AWS account of the API owner.

" - }, - "status":{ - "shape":"VpcLinkStatus", - "documentation":"

The status of the VPC link. The valid values are AVAILABLE, PENDING, DELETING, or FAILED. Deploying an API will wait if the status is PENDING and will fail if the status is DELETING.

" - }, - "statusMessage":{ - "shape":"String", - "documentation":"

A description about the VPC link status.

" - } - }, - "documentation":"

A API Gateway VPC link for a RestApi to access resources in an Amazon Virtual Private Cloud (VPC).

To enable access to a resource in an Amazon Virtual Private Cloud through Amazon API Gateway, you, as an API developer, create a VpcLink resource targeted for one or more network load balancers of the VPC and then integrate an API method with a private integration that uses the VpcLink. The private integration has an integration type of HTTP or HTTP_PROXY and has a connection type of VPC_LINK. The integration uses the connectionId property to identify the VpcLink used.

" - }, - "VpcLinkStatus":{ - "type":"string", - "enum":[ - "AVAILABLE", - "PENDING", - "DELETING", - "FAILED" - ] - }, - "VpcLinks":{ - "type":"structure", - "members":{ - "position":{"shape":"String"}, - "items":{ - "shape":"ListOfVpcLink", - "documentation":"

The current page of elements from this collection.

", - "locationName":"item" - } - }, - "documentation":"

The collection of VPC links under the caller's account in a region.

" - } - }, - "documentation":"Amazon API Gateway

Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/examples-1.json deleted file mode 100644 index 53415ece..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/examples-1.json +++ /dev/null @@ -1,257 +0,0 @@ -{ - "version": "1.0", - "examples": { - "DeleteScalingPolicy": [ - { - "input": { - "PolicyName": "web-app-cpu-lt-25", - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes a scaling policy for the Amazon ECS service called web-app, which is running in the default cluster.", - "id": "to-delete-a-scaling-policy-1470863892689", - "title": "To delete a scaling policy" - } - ], - "DeregisterScalableTarget": [ - { - "input": { - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deregisters a scalable target for an Amazon ECS service called web-app that is running in the default cluster.", - "id": "to-deregister-a-scalable-target-1470864164895", - "title": "To deregister a scalable target" - } - ], - "DescribeScalableTargets": [ - { - "input": { - "ServiceNamespace": "ecs" - }, - "output": { - "ScalableTargets": [ - { - "CreationTime": "2016-05-06T11:21:46.199Z", - "MaxCapacity": 10, - "MinCapacity": 1, - "ResourceId": "service/default/web-app", - "RoleARN": "arn:aws:iam::012345678910:role/ApplicationAutoscalingECSRole", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the scalable targets for the ecs service namespace.", - "id": "to-describe-scalable-targets-1470864286961", - "title": "To describe scalable targets" - } - ], - "DescribeScalingActivities": [ - { - "input": { - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs" - }, - "output": { - "ScalingActivities": [ - { - "ActivityId": "e6c5f7d1-dbbb-4a3f-89b2-51f33e766399", - "Cause": "monitor alarm web-app-cpu-lt-25 in state ALARM triggered policy web-app-cpu-lt-25", - "Description": "Setting desired count to 1.", - "EndTime": "2016-05-06T16:04:32.111Z", - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs", - "StartTime": "2016-05-06T16:03:58.171Z", - "StatusCode": "Successful", - "StatusMessage": "Successfully set desired count to 1. Change successfully fulfilled by ecs." - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the scaling activities for an Amazon ECS service called web-app that is running in the default cluster.", - "id": "to-describe-scaling-activities-for-a-scalable-target-1470864398629", - "title": "To describe scaling activities for a scalable target" - } - ], - "DescribeScalingPolicies": [ - { - "input": { - "ServiceNamespace": "ecs" - }, - "output": { - "NextToken": "", - "ScalingPolicies": [ - { - "Alarms": [ - { - "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-gt-75", - "AlarmName": "web-app-cpu-gt-75" - } - ], - "CreationTime": "2016-05-06T12:11:39.230Z", - "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75", - "PolicyName": "web-app-cpu-gt-75", - "PolicyType": "StepScaling", - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs", - "StepScalingPolicyConfiguration": { - "AdjustmentType": "PercentChangeInCapacity", - "Cooldown": 60, - "StepAdjustments": [ - { - "MetricIntervalLowerBound": 0, - "ScalingAdjustment": 200 - } - ] - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the scaling policies for the ecs service namespace.", - "id": "to-describe-scaling-policies-1470864609734", - "title": "To describe scaling policies" - } - ], - "PutScalingPolicy": [ - { - "input": { - "PolicyName": "web-app-cpu-gt-75", - "PolicyType": "StepScaling", - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs", - "StepScalingPolicyConfiguration": { - "AdjustmentType": "PercentChangeInCapacity", - "Cooldown": 60, - "StepAdjustments": [ - { - "MetricIntervalLowerBound": 0, - "ScalingAdjustment": 200 - } - ] - } - }, - "output": { - "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example applies a scaling policy to an Amazon ECS service called web-app in the default cluster. The policy increases the desired count of the service by 200%, with a cool down period of 60 seconds.", - "id": "to-apply-a-scaling-policy-to-an-amazon-ecs-service-1470864779862", - "title": "To apply a scaling policy to an Amazon ECS service" - }, - { - "input": { - "PolicyName": "fleet-cpu-gt-75", - "PolicyType": "StepScaling", - "ResourceId": "spot-fleet-request/sfr-45e69d8a-be48-4539-bbf3-3464e99c50c3", - "ScalableDimension": "ec2:spot-fleet-request:TargetCapacity", - "ServiceNamespace": "ec2", - "StepScalingPolicyConfiguration": { - "AdjustmentType": "PercentChangeInCapacity", - "Cooldown": 180, - "StepAdjustments": [ - { - "MetricIntervalLowerBound": 0, - "ScalingAdjustment": 200 - } - ] - } - }, - "output": { - "PolicyARN": "arn:aws:autoscaling:us-east-1:012345678910:scalingPolicy:89406401-0cb7-4130-b770-d97cca0e446b:resource/ec2/spot-fleet-request/sfr-45e69d8a-be48-4539-bbf3-3464e99c50c3:policyName/fleet-cpu-gt-75" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example applies a scaling policy to an Amazon EC2 Spot fleet. The policy increases the target capacity of the spot fleet by 200%, with a cool down period of 180 seconds.\",\n ", - "id": "to-apply-a-scaling-policy-to-an-amazon-ec2-spot-fleet-1472073278469", - "title": "To apply a scaling policy to an Amazon EC2 Spot fleet" - } - ], - "RegisterScalableTarget": [ - { - "input": { - "MaxCapacity": 10, - "MinCapacity": 1, - "ResourceId": "service/default/web-app", - "RoleARN": "arn:aws:iam::012345678910:role/ApplicationAutoscalingECSRole", - "ScalableDimension": "ecs:service:DesiredCount", - "ServiceNamespace": "ecs" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers a scalable target from an Amazon ECS service called web-app that is running on the default cluster, with a minimum desired count of 1 task and a maximum desired count of 10 tasks.", - "id": "to-register-a-new-scalable-target-1470864910380", - "title": "To register an ECS service as a scalable target" - }, - { - "input": { - "MaxCapacity": 10, - "MinCapacity": 1, - "ResourceId": "spot-fleet-request/sfr-45e69d8a-be48-4539-bbf3-3464e99c50c3", - "RoleARN": "arn:aws:iam::012345678910:role/ApplicationAutoscalingSpotRole", - "ScalableDimension": "ec2:spot-fleet-request:TargetCapacity", - "ServiceNamespace": "ec2" - }, - "output": { - }, - "comments": { - }, - "description": "This example registers a scalable target from an Amazon EC2 Spot fleet with a minimum target capacity of 1 and a maximum of 10.", - "id": "to-register-an-ec2-spot-fleet-as-a-scalable-target-1472072899649", - "title": "To register an EC2 Spot fleet as a scalable target" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/paginators-1.json deleted file mode 100644 index 178af24d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "DescribeScalableTargets": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ScalableTargets" - }, - "DescribeScalingActivities": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ScalingActivities" - }, - "DescribeScalingPolicies": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ScalingPolicies" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/service-2.json deleted file mode 100644 index 6ea4e64a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/application-autoscaling/2016-02-06/service-2.json +++ /dev/null @@ -1,1183 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-02-06", - "endpointPrefix":"autoscaling", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Application Auto Scaling", - "serviceId":"Application Auto Scaling", - "signatureVersion":"v4", - "signingName":"application-autoscaling", - "targetPrefix":"AnyScaleFrontendService", - "uid":"application-autoscaling-2016-02-06" - }, - "operations":{ - "DeleteScalingPolicy":{ - "name":"DeleteScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteScalingPolicyRequest"}, - "output":{"shape":"DeleteScalingPolicyResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deletes the specified Application Auto Scaling scaling policy.

Deleting a policy deletes the underlying alarm action, but does not delete the CloudWatch alarm associated with the scaling policy, even if it no longer has an associated action.

To create a scaling policy or update an existing one, see PutScalingPolicy.

" - }, - "DeleteScheduledAction":{ - "name":"DeleteScheduledAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteScheduledActionRequest"}, - "output":{"shape":"DeleteScheduledActionResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deletes the specified Application Auto Scaling scheduled action.

" - }, - "DeregisterScalableTarget":{ - "name":"DeregisterScalableTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterScalableTargetRequest"}, - "output":{"shape":"DeregisterScalableTargetResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deregisters a scalable target.

Deregistering a scalable target deletes the scaling policies that are associated with it.

To create a scalable target or update an existing one, see RegisterScalableTarget.

" - }, - "DescribeScalableTargets":{ - "name":"DescribeScalableTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalableTargetsRequest"}, - "output":{"shape":"DescribeScalableTargetsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Gets information about the scalable targets in the specified namespace.

You can filter the results using the ResourceIds and ScalableDimension parameters.

To create a scalable target or update an existing one, see RegisterScalableTarget. If you are no longer using a scalable target, you can deregister it using DeregisterScalableTarget.

" - }, - "DescribeScalingActivities":{ - "name":"DescribeScalingActivities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingActivitiesRequest"}, - "output":{"shape":"DescribeScalingActivitiesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Provides descriptive information about the scaling activities in the specified namespace from the previous six weeks.

You can filter the results using the ResourceId and ScalableDimension parameters.

Scaling activities are triggered by CloudWatch alarms that are associated with scaling policies. To view the scaling policies for a service namespace, see DescribeScalingPolicies. To create a scaling policy or update an existing one, see PutScalingPolicy.

" - }, - "DescribeScalingPolicies":{ - "name":"DescribeScalingPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingPoliciesRequest"}, - "output":{"shape":"DescribeScalingPoliciesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"FailedResourceAccessException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Describes the scaling policies for the specified service namespace.

You can filter the results using the ResourceId, ScalableDimension, and PolicyNames parameters.

To create a scaling policy or update an existing one, see PutScalingPolicy. If you are no longer using a scaling policy, you can delete it using DeleteScalingPolicy.

" - }, - "DescribeScheduledActions":{ - "name":"DescribeScheduledActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledActionsRequest"}, - "output":{"shape":"DescribeScheduledActionsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Describes the scheduled actions for the specified service namespace.

You can filter the results using the ResourceId, ScalableDimension, and ScheduledActionNames parameters.

To create a scheduled action or update an existing one, see PutScheduledAction. If you are no longer using a scheduled action, you can delete it using DeleteScheduledAction.

" - }, - "PutScalingPolicy":{ - "name":"PutScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutScalingPolicyRequest"}, - "output":{"shape":"PutScalingPolicyResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"FailedResourceAccessException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Creates or updates a policy for an Application Auto Scaling scalable target.

Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scaling policy applies to the scalable target identified by those three attributes. You cannot create a scaling policy until you register the scalable target using RegisterScalableTarget.

To update a policy, specify its policy name and the parameters that you want to change. Any parameters that you don't specify are not changed by this update request.

You can view the scaling policies for a service namespace using DescribeScalingPolicies. If you are no longer using a scaling policy, you can delete it using DeleteScalingPolicy.

" - }, - "PutScheduledAction":{ - "name":"PutScheduledAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutScheduledActionRequest"}, - "output":{"shape":"PutScheduledActionResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Creates or updates a scheduled action for an Application Auto Scaling scalable target.

Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scheduled action applies to the scalable target identified by those three attributes. You cannot create a scheduled action until you register the scalable target using RegisterScalableTarget.

To update an action, specify its name and the parameters that you want to change. If you don't specify start and end times, the old values are deleted. Any other parameters that you don't specify are not changed by this update request.

You can view the scheduled actions using DescribeScheduledActions. If you are no longer using a scheduled action, you can delete it using DeleteScheduledAction.

" - }, - "RegisterScalableTarget":{ - "name":"RegisterScalableTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterScalableTargetRequest"}, - "output":{"shape":"RegisterScalableTargetResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Registers or updates a scalable target. A scalable target is a resource that Application Auto Scaling can scale out or scale in. After you have registered a scalable target, you can use this operation to update the minimum and maximum values for its scalable dimension.

After you register a scalable target, you can create and apply scaling policies using PutScalingPolicy. You can view the scaling policies for a service namespace using DescribeScalableTargets. If you no longer need a scalable target, you can deregister it using DeregisterScalableTarget.

" - } - }, - "shapes":{ - "AdjustmentType":{ - "type":"string", - "enum":[ - "ChangeInCapacity", - "PercentChangeInCapacity", - "ExactCapacity" - ] - }, - "Alarm":{ - "type":"structure", - "required":[ - "AlarmName", - "AlarmARN" - ], - "members":{ - "AlarmName":{ - "shape":"ResourceId", - "documentation":"

The name of the alarm.

" - }, - "AlarmARN":{ - "shape":"ResourceId", - "documentation":"

The Amazon Resource Name (ARN) of the alarm.

" - } - }, - "documentation":"

Represents a CloudWatch alarm associated with a scaling policy.

" - }, - "Alarms":{ - "type":"list", - "member":{"shape":"Alarm"} - }, - "ConcurrentUpdateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.

", - "exception":true - }, - "Cooldown":{"type":"integer"}, - "CustomizedMetricSpecification":{ - "type":"structure", - "required":[ - "MetricName", - "Namespace", - "Statistic" - ], - "members":{ - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Namespace":{ - "shape":"MetricNamespace", - "documentation":"

The namespace of the metric.

" - }, - "Dimensions":{ - "shape":"MetricDimensions", - "documentation":"

The dimensions of the metric.

" - }, - "Statistic":{ - "shape":"MetricStatistic", - "documentation":"

The statistic of the metric.

" - }, - "Unit":{ - "shape":"MetricUnit", - "documentation":"

The unit of the metric.

" - } - }, - "documentation":"

Configures a customized metric for a target tracking policy.

" - }, - "DeleteScalingPolicyRequest":{ - "type":"structure", - "required":[ - "PolicyName", - "ServiceNamespace", - "ResourceId", - "ScalableDimension" - ], - "members":{ - "PolicyName":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The name of the scaling policy.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scalable target. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - } - } - }, - "DeleteScalingPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteScheduledActionRequest":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ScheduledActionName", - "ResourceId" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ScheduledActionName":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The name of the scheduled action.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scheduled action. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - } - } - }, - "DeleteScheduledActionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeregisterScalableTargetRequest":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ResourceId", - "ScalableDimension" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scalable target. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension associated with the scalable target. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - } - } - }, - "DeregisterScalableTargetResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeScalableTargetsRequest":{ - "type":"structure", - "required":["ServiceNamespace"], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceIds":{ - "shape":"ResourceIdsMaxLen1600", - "documentation":"

The identifier of the resource associated with the scalable target. This string consists of the resource type and unique identifier. If you specify a scalable dimension, you must also specify a resource ID.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension associated with the scalable target. This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scalable targets. This value can be between 1 and 50. The default value is 50.

If this parameter is used, the operation returns up to MaxResults results at a time, along with a NextToken value. To get the next set of results, include the NextToken value in a subsequent call. If this parameter is not used, the operation returns up to 50 results and a NextToken value, if applicable.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScalableTargetsResponse":{ - "type":"structure", - "members":{ - "ScalableTargets":{ - "shape":"ScalableTargets", - "documentation":"

The scalable targets that match the request parameters.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DescribeScalingActivitiesRequest":{ - "type":"structure", - "required":["ServiceNamespace"], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling activity. This string consists of the resource type and unique identifier. If you specify a scalable dimension, you must also specify a resource ID.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scalable targets. This value can be between 1 and 50. The default value is 50.

If this parameter is used, the operation returns up to MaxResults results at a time, along with a NextToken value. To get the next set of results, include the NextToken value in a subsequent call. If this parameter is not used, the operation returns up to 50 results and a NextToken value, if applicable.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScalingActivitiesResponse":{ - "type":"structure", - "members":{ - "ScalingActivities":{ - "shape":"ScalingActivities", - "documentation":"

A list of scaling activity objects.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DescribeScalingPoliciesRequest":{ - "type":"structure", - "required":["ServiceNamespace"], - "members":{ - "PolicyNames":{ - "shape":"ResourceIdsMaxLen1600", - "documentation":"

The names of the scaling policies to describe.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling policy. This string consists of the resource type and unique identifier. If you specify a scalable dimension, you must also specify a resource ID.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scalable targets. This value can be between 1 and 50. The default value is 50.

If this parameter is used, the operation returns up to MaxResults results at a time, along with a NextToken value. To get the next set of results, include the NextToken value in a subsequent call. If this parameter is not used, the operation returns up to 50 results and a NextToken value, if applicable.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScalingPoliciesResponse":{ - "type":"structure", - "members":{ - "ScalingPolicies":{ - "shape":"ScalingPolicies", - "documentation":"

Information about the scaling policies.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DescribeScheduledActionsRequest":{ - "type":"structure", - "required":["ServiceNamespace"], - "members":{ - "ScheduledActionNames":{ - "shape":"ResourceIdsMaxLen1600", - "documentation":"

The names of the scheduled actions to describe.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scheduled action. This string consists of the resource type and unique identifier. If you specify a scalable dimension, you must also specify a resource ID.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scheduled action results. This value can be between 1 and 50. The default value is 50.

If this parameter is used, the operation returns up to MaxResults results at a time, along with a NextToken value. To get the next set of results, include the NextToken value in a subsequent call. If this parameter is not used, the operation returns up to 50 results and a NextToken value, if applicable.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScheduledActionsResponse":{ - "type":"structure", - "members":{ - "ScheduledActions":{ - "shape":"ScheduledActions", - "documentation":"

Information about the scheduled actions.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DisableScaleIn":{"type":"boolean"}, - "ErrorMessage":{"type":"string"}, - "FailedResourceAccessException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Failed access to resources caused an exception. This exception is thrown when Application Auto Scaling is unable to retrieve the alarms associated with a scaling policy due to a client error, for example, if the role ARN specified for a scalable target does not have permission to call the CloudWatch DescribeAlarms on your behalf.

", - "exception":true - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service encountered an internal error.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The next token supplied was invalid.

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

A per-account resource limit is exceeded. For more information, see Application Auto Scaling Limits.

", - "exception":true - }, - "MaxResults":{"type":"integer"}, - "MetricAggregationType":{ - "type":"string", - "enum":[ - "Average", - "Minimum", - "Maximum" - ] - }, - "MetricDimension":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"MetricDimensionName", - "documentation":"

The name of the dimension.

" - }, - "Value":{ - "shape":"MetricDimensionValue", - "documentation":"

The value of the dimension.

" - } - }, - "documentation":"

Describes the dimension of a metric.

" - }, - "MetricDimensionName":{"type":"string"}, - "MetricDimensionValue":{"type":"string"}, - "MetricDimensions":{ - "type":"list", - "member":{"shape":"MetricDimension"} - }, - "MetricName":{"type":"string"}, - "MetricNamespace":{"type":"string"}, - "MetricScale":{"type":"double"}, - "MetricStatistic":{ - "type":"string", - "enum":[ - "Average", - "Minimum", - "Maximum", - "SampleCount", - "Sum" - ] - }, - "MetricType":{ - "type":"string", - "enum":[ - "DynamoDBReadCapacityUtilization", - "DynamoDBWriteCapacityUtilization", - "ALBRequestCountPerTarget", - "RDSReaderAverageCPUUtilization", - "RDSReaderAverageDatabaseConnections", - "EC2SpotFleetRequestAverageCPUUtilization", - "EC2SpotFleetRequestAverageNetworkIn", - "EC2SpotFleetRequestAverageNetworkOut", - "SageMakerVariantInvocationsPerInstance", - "ECSServiceAverageCPUUtilization", - "ECSServiceAverageMemoryUtilization" - ] - }, - "MetricUnit":{"type":"string"}, - "MinAdjustmentMagnitude":{"type":"integer"}, - "ObjectNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified object could not be found. For any operation that depends on the existence of a scalable target, this exception is thrown if the scalable target with the specified service namespace, resource ID, and scalable dimension does not exist. For any operation that deletes or deregisters a resource, this exception is thrown if the resource cannot be found.

", - "exception":true - }, - "PolicyName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"\\p{Print}+" - }, - "PolicyType":{ - "type":"string", - "enum":[ - "StepScaling", - "TargetTrackingScaling" - ] - }, - "PredefinedMetricSpecification":{ - "type":"structure", - "required":["PredefinedMetricType"], - "members":{ - "PredefinedMetricType":{ - "shape":"MetricType", - "documentation":"

The metric type. The ALBRequestCountPerTarget metric type applies only to Spot fleet requests and ECS services.

" - }, - "ResourceLabel":{ - "shape":"ResourceLabel", - "documentation":"

Identifies the resource associated with the metric type. You can't specify a resource label unless the metric type is ALBRequestCountPerTarget and there is a target group attached to the Spot fleet request or ECS service.

The format is app/<load-balancer-name>/<load-balancer-id>/targetgroup/<target-group-name>/<target-group-id>, where:

  • app/<load-balancer-name>/<load-balancer-id> is the final portion of the load balancer ARN

  • targetgroup/<target-group-name>/<target-group-id> is the final portion of the target group ARN.

" - } - }, - "documentation":"

Configures a predefined metric for a target tracking policy.

" - }, - "PutScalingPolicyRequest":{ - "type":"structure", - "required":[ - "PolicyName", - "ServiceNamespace", - "ResourceId", - "ScalableDimension" - ], - "members":{ - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the scaling policy.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling policy. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The policy type. This parameter is required if you are creating a policy.

For DynamoDB, only TargetTrackingScaling is supported. For Amazon ECS, Spot Fleet, and Amazon RDS, both StepScaling and TargetTrackingScaling are supported. For any other service, only StepScaling is supported.

" - }, - "StepScalingPolicyConfiguration":{ - "shape":"StepScalingPolicyConfiguration", - "documentation":"

A step scaling policy.

This parameter is required if you are creating a policy and the policy type is StepScaling.

" - }, - "TargetTrackingScalingPolicyConfiguration":{ - "shape":"TargetTrackingScalingPolicyConfiguration", - "documentation":"

A target tracking policy.

This parameter is required if you are creating a policy and the policy type is TargetTrackingScaling.

" - } - } - }, - "PutScalingPolicyResponse":{ - "type":"structure", - "required":["PolicyARN"], - "members":{ - "PolicyARN":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The Amazon Resource Name (ARN) of the resulting scaling policy.

" - }, - "Alarms":{ - "shape":"Alarms", - "documentation":"

The CloudWatch alarms created for the target tracking policy.

" - } - } - }, - "PutScheduledActionRequest":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ScheduledActionName", - "ResourceId" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "Schedule":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The schedule for this action. The following formats are supported:

  • At expressions - at(yyyy-mm-ddThh:mm:ss)

  • Rate expressions - rate(value unit)

  • Cron expressions - cron(fields)

At expressions are useful for one-time schedules. Specify the time, in UTC.

For rate expressions, value is a positive integer and unit is minute | minutes | hour | hours | day | days.

For more information about cron expressions, see Cron Expressions in the Amazon CloudWatch Events User Guide.

" - }, - "ScheduledActionName":{ - "shape":"ScheduledActionName", - "documentation":"

The name of the scheduled action.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scheduled action. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This parameter is required if you are creating a scheduled action. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The date and time for the scheduled action to start.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The date and time for the scheduled action to end.

" - }, - "ScalableTargetAction":{ - "shape":"ScalableTargetAction", - "documentation":"

The new minimum and maximum capacity. You can set both values or just one. During the scheduled time, if the current capacity is below the minimum capacity, Application Auto Scaling scales out to the minimum capacity. If the current capacity is above the maximum capacity, Application Auto Scaling scales in to the maximum capacity.

" - } - } - }, - "PutScheduledActionResponse":{ - "type":"structure", - "members":{ - } - }, - "RegisterScalableTargetRequest":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ResourceId", - "ScalableDimension" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scalable target. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension associated with the scalable target. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MinCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The minimum value to scale to in response to a scale in event. This parameter is required if you are registering a scalable target.

" - }, - "MaxCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The maximum value to scale to in response to a scale out event. This parameter is required if you are registering a scalable target.

" - }, - "RoleARN":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

Application Auto Scaling creates a service-linked role that grants it permissions to modify the scalable target on your behalf. For more information, see Service-Linked Roles for Application Auto Scaling.

For resources that are not supported using a service-linked role, this parameter is required and must specify the ARN of an IAM role that allows Application Auto Scaling to modify the scalable target on your behalf.

" - } - } - }, - "RegisterScalableTargetResponse":{ - "type":"structure", - "members":{ - } - }, - "ResourceCapacity":{"type":"integer"}, - "ResourceId":{ - "type":"string", - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "ResourceIdMaxLen1600":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "ResourceIdsMaxLen1600":{ - "type":"list", - "member":{"shape":"ResourceIdMaxLen1600"} - }, - "ResourceLabel":{ - "type":"string", - "max":1023, - "min":1 - }, - "ScalableDimension":{ - "type":"string", - "enum":[ - "ecs:service:DesiredCount", - "ec2:spot-fleet-request:TargetCapacity", - "elasticmapreduce:instancegroup:InstanceCount", - "appstream:fleet:DesiredCapacity", - "dynamodb:table:ReadCapacityUnits", - "dynamodb:table:WriteCapacityUnits", - "dynamodb:index:ReadCapacityUnits", - "dynamodb:index:WriteCapacityUnits", - "rds:cluster:ReadReplicaCount", - "sagemaker:variant:DesiredInstanceCount", - "custom-resource:ResourceType:Property" - ] - }, - "ScalableTarget":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ResourceId", - "ScalableDimension", - "MinCapacity", - "MaxCapacity", - "RoleARN", - "CreationTime" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scalable target. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension associated with the scalable target. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "MinCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The minimum value to scale to in response to a scale in event.

" - }, - "MaxCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The maximum value to scale to in response to a scale out event.

" - }, - "RoleARN":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The ARN of an IAM role that allows Application Auto Scaling to modify the scalable target on your behalf.

" - }, - "CreationTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp for when the scalable target was created.

" - } - }, - "documentation":"

Represents a scalable target.

" - }, - "ScalableTargetAction":{ - "type":"structure", - "members":{ - "MinCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The minimum capacity.

" - }, - "MaxCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The maximum capacity.

" - } - }, - "documentation":"

Represents the minimum and maximum capacity for a scheduled action.

" - }, - "ScalableTargets":{ - "type":"list", - "member":{"shape":"ScalableTarget"} - }, - "ScalingActivities":{ - "type":"list", - "member":{"shape":"ScalingActivity"} - }, - "ScalingActivity":{ - "type":"structure", - "required":[ - "ActivityId", - "ServiceNamespace", - "ResourceId", - "ScalableDimension", - "Description", - "Cause", - "StartTime", - "StatusCode" - ], - "members":{ - "ActivityId":{ - "shape":"ResourceId", - "documentation":"

The unique identifier of the scaling activity.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling activity. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "Description":{ - "shape":"XmlString", - "documentation":"

A simple description of what action the scaling activity intends to accomplish.

" - }, - "Cause":{ - "shape":"XmlString", - "documentation":"

A simple description of what caused the scaling activity to happen.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp for when the scaling activity began.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp for when the scaling activity ended.

" - }, - "StatusCode":{ - "shape":"ScalingActivityStatusCode", - "documentation":"

Indicates the status of the scaling activity.

" - }, - "StatusMessage":{ - "shape":"XmlString", - "documentation":"

A simple message about the current status of the scaling activity.

" - }, - "Details":{ - "shape":"XmlString", - "documentation":"

The details about the scaling activity.

" - } - }, - "documentation":"

Represents a scaling activity.

" - }, - "ScalingActivityStatusCode":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Successful", - "Overridden", - "Unfulfilled", - "Failed" - ] - }, - "ScalingAdjustment":{"type":"integer"}, - "ScalingPolicies":{ - "type":"list", - "member":{"shape":"ScalingPolicy"} - }, - "ScalingPolicy":{ - "type":"structure", - "required":[ - "PolicyARN", - "PolicyName", - "ServiceNamespace", - "ResourceId", - "ScalableDimension", - "PolicyType", - "CreationTime" - ], - "members":{ - "PolicyARN":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The Amazon Resource Name (ARN) of the scaling policy.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the scaling policy.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling policy. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The scaling policy type.

" - }, - "StepScalingPolicyConfiguration":{ - "shape":"StepScalingPolicyConfiguration", - "documentation":"

A step scaling policy.

" - }, - "TargetTrackingScalingPolicyConfiguration":{ - "shape":"TargetTrackingScalingPolicyConfiguration", - "documentation":"

A target tracking policy.

" - }, - "Alarms":{ - "shape":"Alarms", - "documentation":"

The CloudWatch alarms associated with the scaling policy.

" - }, - "CreationTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp for when the scaling policy was created.

" - } - }, - "documentation":"

Represents a scaling policy.

" - }, - "ScheduledAction":{ - "type":"structure", - "required":[ - "ScheduledActionName", - "ScheduledActionARN", - "ServiceNamespace", - "Schedule", - "ResourceId", - "CreationTime" - ], - "members":{ - "ScheduledActionName":{ - "shape":"ScheduledActionName", - "documentation":"

The name of the scheduled action.

" - }, - "ScheduledActionARN":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The Amazon Resource Name (ARN) of the scheduled action.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service. For more information, see AWS Service Namespaces in the Amazon Web Services General Reference.

" - }, - "Schedule":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The schedule for this action. The following formats are supported:

  • At expressions - at(yyyy-mm-ddThh:mm:ss)

  • Rate expressions - rate(value unit)

  • Cron expressions - cron(fields)

At expressions are useful for one-time schedules. Specify the time, in UTC.

For rate expressions, value is a positive integer and unit is minute | minutes | hour | hours | day | days.

For more information about cron expressions, see Cron Expressions in the Amazon CloudWatch Events User Guide.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The identifier of the resource associated with the scaling policy. This string consists of the resource type and unique identifier.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • EMR cluster - The resource type is instancegroup and the unique identifier is the cluster ID and instance group ID. Example: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0.

  • AppStream 2.0 fleet - The resource type is fleet and the unique identifier is the fleet name. Example: fleet/sample-fleet.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

  • Amazon SageMaker endpoint variants - The resource type is variant and the unique identifier is the resource ID. Example: endpoint/my-end-point/variant/KMeansClustering.

  • Custom resources are not supported with a resource type. This parameter must specify the OutputValue from the CloudFormation template stack used to access the resources. The unique identifier is defined by the service provider.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR Instance Group.

  • appstream:fleet:DesiredCapacity - The desired capacity of an AppStream 2.0 fleet.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

  • sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for an Amazon SageMaker model endpoint variant.

  • custom-resource:ResourceType:Property - The scalable dimension for a custom resource provided by your own application or service.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The date and time that the action is scheduled to begin.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The date and time that the action is scheduled to end.

" - }, - "ScalableTargetAction":{ - "shape":"ScalableTargetAction", - "documentation":"

The new minimum and maximum capacity. You can set both values or just one. During the scheduled time, if the current capacity is below the minimum capacity, Application Auto Scaling scales out to the minimum capacity. If the current capacity is above the maximum capacity, Application Auto Scaling scales in to the maximum capacity.

" - }, - "CreationTime":{ - "shape":"TimestampType", - "documentation":"

The date and time that the scheduled action was created.

" - } - }, - "documentation":"

Represents a scheduled action.

" - }, - "ScheduledActionName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"(?!((^[ ]+.*)|(.*([\\u0000-\\u001f]|[\\u007f-\\u009f]|[:/|])+.*)|(.*[ ]+$))).+" - }, - "ScheduledActions":{ - "type":"list", - "member":{"shape":"ScheduledAction"} - }, - "ServiceNamespace":{ - "type":"string", - "enum":[ - "ecs", - "elasticmapreduce", - "ec2", - "appstream", - "dynamodb", - "rds", - "sagemaker", - "custom-resource" - ] - }, - "StepAdjustment":{ - "type":"structure", - "required":["ScalingAdjustment"], - "members":{ - "MetricIntervalLowerBound":{ - "shape":"MetricScale", - "documentation":"

The lower bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the lower bound is inclusive (the metric must be greater than or equal to the threshold plus the lower bound). Otherwise, it is exclusive (the metric must be greater than the threshold plus the lower bound). A null value indicates negative infinity.

" - }, - "MetricIntervalUpperBound":{ - "shape":"MetricScale", - "documentation":"

The upper bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the upper bound is exclusive (the metric must be less than the threshold plus the upper bound). Otherwise, it is inclusive (the metric must be less than or equal to the threshold plus the upper bound). A null value indicates positive infinity.

The upper bound must be greater than the lower bound.

" - }, - "ScalingAdjustment":{ - "shape":"ScalingAdjustment", - "documentation":"

The amount by which to scale, based on the specified adjustment type. A positive value adds to the current scalable dimension while a negative number removes from the current scalable dimension.

" - } - }, - "documentation":"

Represents a step adjustment for a StepScalingPolicyConfiguration. Describes an adjustment based on the difference between the value of the aggregated CloudWatch metric and the breach threshold that you've defined for the alarm.

For the following examples, suppose that you have an alarm with a breach threshold of 50:

  • To trigger the adjustment when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0 and an upper bound of 10.

  • To trigger the adjustment when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10 and an upper bound of 0.

There are a few rules for the step adjustments for your step policy:

  • The ranges of your step adjustments can't overlap or have a gap.

  • At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.

  • At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.

  • The upper and lower bound can't be null in the same step adjustment.

" - }, - "StepAdjustments":{ - "type":"list", - "member":{"shape":"StepAdjustment"} - }, - "StepScalingPolicyConfiguration":{ - "type":"structure", - "members":{ - "AdjustmentType":{ - "shape":"AdjustmentType", - "documentation":"

The adjustment type, which specifies how the ScalingAdjustment parameter in a StepAdjustment is interpreted.

" - }, - "StepAdjustments":{ - "shape":"StepAdjustments", - "documentation":"

A set of adjustments that enable you to scale based on the size of the alarm breach.

" - }, - "MinAdjustmentMagnitude":{ - "shape":"MinAdjustmentMagnitude", - "documentation":"

The minimum number to adjust your scalable dimension as a result of a scaling activity. If the adjustment type is PercentChangeInCapacity, the scaling policy changes the scalable dimension of the scalable target by this amount.

" - }, - "Cooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes where previous trigger-related scaling activities can influence future scaling events.

For scale out policies, while the cooldown period is in effect, the capacity that has been added by the previous scale out event that initiated the cooldown is calculated as part of the desired capacity for the next scale out. The intention is to continuously (but not excessively) scale out. For example, an alarm triggers a step scaling policy to scale out an Amazon ECS service by 2 tasks, the scaling activity completes successfully, and a cooldown period of 5 minutes starts. During the Cooldown period, if the alarm triggers the same policy again but at a more aggressive step adjustment to scale out the service by 3 tasks, the 2 tasks that were added in the previous scale out event are considered part of that capacity and only 1 additional task is added to the desired count.

For scale in policies, the cooldown period is used to block subsequent scale in requests until it has expired. The intention is to scale in conservatively to protect your application's availability. However, if another alarm triggers a scale out policy during the cooldown period after a scale-in, Application Auto Scaling scales out your scalable target immediately.

" - }, - "MetricAggregationType":{ - "shape":"MetricAggregationType", - "documentation":"

The aggregation type for the CloudWatch metrics. Valid values are Minimum, Maximum, and Average.

" - } - }, - "documentation":"

Represents a step scaling policy configuration.

" - }, - "TargetTrackingScalingPolicyConfiguration":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "TargetValue":{ - "shape":"MetricScale", - "documentation":"

The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2).

" - }, - "PredefinedMetricSpecification":{ - "shape":"PredefinedMetricSpecification", - "documentation":"

A predefined metric.

" - }, - "CustomizedMetricSpecification":{ - "shape":"CustomizedMetricSpecification", - "documentation":"

A customized metric.

" - }, - "ScaleOutCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scale out activity completes before another scale out activity can start.

While the cooldown period is in effect, the capacity that has been added by the previous scale out event that initiated the cooldown is calculated as part of the desired capacity for the next scale out. The intention is to continuously (but not excessively) scale out.

" - }, - "ScaleInCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scale in activity completes before another scale in activity can start.

The cooldown period is used to block subsequent scale in requests until it has expired. The intention is to scale in conservatively to protect your application's availability. However, if another alarm triggers a scale out policy during the cooldown period after a scale-in, Application Auto Scaling scales out your scalable target immediately.

" - }, - "DisableScaleIn":{ - "shape":"DisableScaleIn", - "documentation":"

Indicates whether scale in by the target tracking policy is disabled. If the value is true, scale in is disabled and the target tracking policy won't remove capacity from the scalable resource. Otherwise, scale in is enabled and the target tracking policy can remove capacity from the scalable resource. The default value is false.

" - } - }, - "documentation":"

Represents a target tracking scaling policy configuration.

" - }, - "TimestampType":{"type":"timestamp"}, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An exception was thrown for a validation issue. Review the available parameters for the API request.

", - "exception":true - }, - "XmlString":{ - "type":"string", - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - } - }, - "documentation":"

With Application Auto Scaling, you can configure automatic scaling for your scalable resources. You can use Application Auto Scaling to accomplish the following tasks:

  • Define scaling policies to automatically scale your AWS or custom resources

  • Scale your resources in response to CloudWatch alarms

  • Schedule one-time or recurring scaling actions

  • View the history of your scaling events

Application Auto Scaling can scale the following resources:

To learn more about Application Auto Scaling, see the Application Auto Scaling User Guide.

To configure automatic scaling for multiple resources across multiple services, use AWS Auto Scaling to create a scaling plan for your application. For more information, see the AWS Auto Scaling User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/service-2.json deleted file mode 100644 index 5bc8b0af..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/service-2.json +++ /dev/null @@ -1,2733 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-12-01", - "endpointPrefix":"appstream2", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon AppStream", - "serviceId":"AppStream", - "signatureVersion":"v4", - "signingName":"appstream", - "targetPrefix":"PhotonAdminProxyService", - "uid":"appstream-2016-12-01" - }, - "operations":{ - "AssociateFleet":{ - "name":"AssociateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateFleetRequest"}, - "output":{"shape":"AssociateFleetResult"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"IncompatibleImageException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Associates the specified fleet with the specified stack.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"IncompatibleImageException"} - ], - "documentation":"

Copies the image within the same region or to a new region within the same AWS account. Note that any tags you added to the image will not be copied.

" - }, - "CreateDirectoryConfig":{ - "name":"CreateDirectoryConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDirectoryConfigRequest"}, - "output":{"shape":"CreateDirectoryConfigResult"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"} - ], - "documentation":"

Creates a Directory Config object in AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

" - }, - "CreateFleet":{ - "name":"CreateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFleetRequest"}, - "output":{"shape":"CreateFleetResult"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"InvalidRoleException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"IncompatibleImageException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Creates a fleet. A fleet consists of streaming instances that run a specified image.

" - }, - "CreateImageBuilder":{ - "name":"CreateImageBuilder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageBuilderRequest"}, - "output":{"shape":"CreateImageBuilderResult"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRoleException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"IncompatibleImageException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Creates an image builder. An image builder is a virtual machine that is used to create an image.

The initial state of the builder is PENDING. When it is ready, the state is RUNNING.

" - }, - "CreateImageBuilderStreamingURL":{ - "name":"CreateImageBuilderStreamingURL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageBuilderStreamingURLRequest"}, - "output":{"shape":"CreateImageBuilderStreamingURLResult"}, - "errors":[ - {"shape":"OperationNotPermittedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a URL to start an image builder streaming session.

" - }, - "CreateStack":{ - "name":"CreateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStackRequest"}, - "output":{"shape":"CreateStackResult"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidRoleException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.

" - }, - "CreateStreamingURL":{ - "name":"CreateStreamingURL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStreamingURLRequest"}, - "output":{"shape":"CreateStreamingURLResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user. A streaming URL enables application streaming to be tested without user setup.

" - }, - "DeleteDirectoryConfig":{ - "name":"DeleteDirectoryConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDirectoryConfigRequest"}, - "output":{"shape":"DeleteDirectoryConfigResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes the specified Directory Config object from AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

" - }, - "DeleteFleet":{ - "name":"DeleteFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFleetRequest"}, - "output":{"shape":"DeleteFleetResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes the specified fleet.

" - }, - "DeleteImage":{ - "name":"DeleteImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteImageRequest"}, - "output":{"shape":"DeleteImageResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes the specified image. You cannot delete an image when it is in use. After you delete an image, you cannot provision new capacity using the image.

" - }, - "DeleteImageBuilder":{ - "name":"DeleteImageBuilder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteImageBuilderRequest"}, - "output":{"shape":"DeleteImageBuilderResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes the specified image builder and releases the capacity.

" - }, - "DeleteImagePermissions":{ - "name":"DeleteImagePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteImagePermissionsRequest"}, - "output":{"shape":"DeleteImagePermissionsResult"}, - "errors":[ - {"shape":"ResourceNotAvailableException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes permissions for the specified private image. After you delete permissions for an image, AWS accounts to which you previously granted these permissions can no longer use the image.

" - }, - "DeleteStack":{ - "name":"DeleteStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStackRequest"}, - "output":{"shape":"DeleteStackResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes the specified stack. After the stack is deleted, the application streaming environment provided by the stack is no longer available to users. Also, any reservations made for application streaming sessions for the stack are released.

" - }, - "DescribeDirectoryConfigs":{ - "name":"DescribeDirectoryConfigs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDirectoryConfigsRequest"}, - "output":{"shape":"DescribeDirectoryConfigsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names for these objects are provided. Otherwise, all Directory Config objects in the account are described. These objects include the information required to join streaming instances to an Active Directory domain.

Although the response syntax in this topic includes the account password, this password is not returned in the actual response.

" - }, - "DescribeFleets":{ - "name":"DescribeFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetsRequest"}, - "output":{"shape":"DescribeFleetsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described.

" - }, - "DescribeImageBuilders":{ - "name":"DescribeImageBuilders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageBuildersRequest"}, - "output":{"shape":"DescribeImageBuildersResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described.

" - }, - "DescribeImagePermissions":{ - "name":"DescribeImagePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagePermissionsRequest"}, - "output":{"shape":"DescribeImagePermissionsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes the permissions for a private image that you own.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "errors":[ - {"shape":"InvalidParameterCombinationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes one or more specified images, if the image names are provided. Otherwise, all images in the account are described.

" - }, - "DescribeSessions":{ - "name":"DescribeSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSessionsRequest"}, - "output":{"shape":"DescribeSessionsResult"}, - "errors":[ - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a user ID is provided for the stack and fleet, only streaming sessions for that user are described. If an authentication type is not provided, the default is to authenticate users using a streaming URL.

" - }, - "DescribeStacks":{ - "name":"DescribeStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStacksRequest"}, - "output":{"shape":"DescribeStacksResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.

" - }, - "DisassociateFleet":{ - "name":"DisassociateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateFleetRequest"}, - "output":{"shape":"DisassociateFleetResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Disassociates the specified fleet from the specified stack.

" - }, - "ExpireSession":{ - "name":"ExpireSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExpireSessionRequest"}, - "output":{"shape":"ExpireSessionResult"}, - "documentation":"

Immediately stops the specified streaming session.

" - }, - "ListAssociatedFleets":{ - "name":"ListAssociatedFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssociatedFleetsRequest"}, - "output":{"shape":"ListAssociatedFleetsResult"}, - "documentation":"

Retrieves the name of the fleet that is associated with the specified stack.

" - }, - "ListAssociatedStacks":{ - "name":"ListAssociatedStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssociatedStacksRequest"}, - "output":{"shape":"ListAssociatedStacksResult"}, - "documentation":"

Retrieves the name of the stack with which the specified fleet is associated.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list of all tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Developer Guide.

" - }, - "StartFleet":{ - "name":"StartFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartFleetRequest"}, - "output":{"shape":"StartFleetResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Starts the specified fleet.

" - }, - "StartImageBuilder":{ - "name":"StartImageBuilder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartImageBuilderRequest"}, - "output":{"shape":"StartImageBuilderResult"}, - "errors":[ - {"shape":"ResourceNotAvailableException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"IncompatibleImageException"} - ], - "documentation":"

Starts the specified image builder.

" - }, - "StopFleet":{ - "name":"StopFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopFleetRequest"}, - "output":{"shape":"StopFleetResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Stops the specified fleet.

" - }, - "StopImageBuilder":{ - "name":"StopImageBuilder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopImageBuilderRequest"}, - "output":{"shape":"StopImageBuilderResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Stops the specified image builder.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Adds or overwrites one or more tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

Each tag consists of a key and an optional value. If a resource already has a tag with the same key, this operation updates its value.

To list the current tags for your resources, use ListTagsForResource. To disassociate tags from your resources, use UntagResource.

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Developer Guide.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociates one or more specified tags from the specified AppStream 2.0 resource.

To list the current tags for your resources, use ListTagsForResource.

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Developer Guide.

" - }, - "UpdateDirectoryConfig":{ - "name":"UpdateDirectoryConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDirectoryConfigRequest"}, - "output":{"shape":"UpdateDirectoryConfigResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Updates the specified Directory Config object in AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

" - }, - "UpdateFleet":{ - "name":"UpdateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateFleetRequest"}, - "output":{"shape":"UpdateFleetResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"InvalidRoleException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"IncompatibleImageException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Updates the specified fleet.

If the fleet is in the STOPPED state, you can update any attribute except the fleet name. If the fleet is in the RUNNING state, you can update the DisplayName and ComputeCapacity attributes. If the fleet is in the STARTING or STOPPING state, you can't update it.

" - }, - "UpdateImagePermissions":{ - "name":"UpdateImagePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateImagePermissionsRequest"}, - "output":{"shape":"UpdateImagePermissionsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceNotAvailableException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Adds or updates permissions for the specified private image.

" - }, - "UpdateStack":{ - "name":"UpdateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStackRequest"}, - "output":{"shape":"UpdateStackResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidRoleException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidAccountStatusException"}, - {"shape":"IncompatibleImageException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Updates the specified fields for the specified stack.

" - } - }, - "shapes":{ - "AccountName":{ - "type":"string", - "min":1, - "sensitive":true - }, - "AccountPassword":{ - "type":"string", - "max":127, - "min":1, - "sensitive":true - }, - "Action":{ - "type":"string", - "enum":[ - "CLIPBOARD_COPY_FROM_LOCAL_DEVICE", - "CLIPBOARD_COPY_TO_LOCAL_DEVICE", - "FILE_UPLOAD", - "FILE_DOWNLOAD", - "PRINTING_TO_LOCAL_DEVICE" - ] - }, - "Application":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the application.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The application name for display.

" - }, - "IconURL":{ - "shape":"String", - "documentation":"

The URL for the application icon. This URL might be time-limited.

" - }, - "LaunchPath":{ - "shape":"String", - "documentation":"

The path to the application executable in the instance.

" - }, - "LaunchParameters":{ - "shape":"String", - "documentation":"

The arguments that are passed to the application at launch.

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

If there is a problem, the application can be disabled after image creation.

" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

Additional attributes that describe the application.

" - } - }, - "documentation":"

Describes an application in the application catalog.

" - }, - "Applications":{ - "type":"list", - "member":{"shape":"Application"} - }, - "AppstreamAgentVersion":{ - "type":"string", - "max":100, - "min":1 - }, - "Arn":{ - "type":"string", - "pattern":"^arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}$" - }, - "ArnList":{ - "type":"list", - "member":{"shape":"Arn"} - }, - "AssociateFleetRequest":{ - "type":"structure", - "required":[ - "FleetName", - "StackName" - ], - "members":{ - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - }, - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack.

" - } - } - }, - "AssociateFleetResult":{ - "type":"structure", - "members":{ - } - }, - "AuthenticationType":{ - "type":"string", - "enum":[ - "API", - "SAML", - "USERPOOL" - ] - }, - "AwsAccountId":{ - "type":"string", - "pattern":"^\\d+$" - }, - "AwsAccountIdList":{ - "type":"list", - "member":{"shape":"AwsAccountId"}, - "max":5, - "min":1 - }, - "Boolean":{"type":"boolean"}, - "BooleanObject":{"type":"boolean"}, - "ComputeCapacity":{ - "type":"structure", - "required":["DesiredInstances"], - "members":{ - "DesiredInstances":{ - "shape":"Integer", - "documentation":"

The desired number of streaming instances.

" - } - }, - "documentation":"

Describes the capacity for a fleet.

" - }, - "ComputeCapacityStatus":{ - "type":"structure", - "required":["Desired"], - "members":{ - "Desired":{ - "shape":"Integer", - "documentation":"

The desired number of streaming instances.

" - }, - "Running":{ - "shape":"Integer", - "documentation":"

The total number of simultaneous streaming instances that are running.

" - }, - "InUse":{ - "shape":"Integer", - "documentation":"

The number of instances in use for streaming.

" - }, - "Available":{ - "shape":"Integer", - "documentation":"

The number of currently available instances that can be used to stream sessions.

" - } - }, - "documentation":"

Describes the capacity status for a fleet.

" - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An API error occurred. Wait a few minutes and try again.

", - "exception":true - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceImageName", - "DestinationImageName", - "DestinationRegion" - ], - "members":{ - "SourceImageName":{ - "shape":"Name", - "documentation":"

The name of the image to copy.

" - }, - "DestinationImageName":{ - "shape":"Name", - "documentation":"

The name that the image will have when it is copied to the destination.

" - }, - "DestinationRegion":{ - "shape":"RegionName", - "documentation":"

The destination region to which the image will be copied. This parameter is required, even if you are copying an image within the same region.

" - }, - "DestinationImageDescription":{ - "shape":"Description", - "documentation":"

The description that the image will have when it is copied to the destination.

" - } - } - }, - "CopyImageResponse":{ - "type":"structure", - "members":{ - "DestinationImageName":{ - "shape":"Name", - "documentation":"

The name of the destination image.

" - } - } - }, - "CreateDirectoryConfigRequest":{ - "type":"structure", - "required":[ - "DirectoryName", - "OrganizationalUnitDistinguishedNames", - "ServiceAccountCredentials" - ], - "members":{ - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The fully qualified name of the directory (for example, corp.example.com).

" - }, - "OrganizationalUnitDistinguishedNames":{ - "shape":"OrganizationalUnitDistinguishedNamesList", - "documentation":"

The distinguished names of the organizational units for computer accounts.

" - }, - "ServiceAccountCredentials":{ - "shape":"ServiceAccountCredentials", - "documentation":"

The credentials for the service account used by the streaming instance to connect to the directory.

" - } - } - }, - "CreateDirectoryConfigResult":{ - "type":"structure", - "members":{ - "DirectoryConfig":{ - "shape":"DirectoryConfig", - "documentation":"

Information about the directory configuration.

" - } - } - }, - "CreateFleetRequest":{ - "type":"structure", - "required":[ - "Name", - "InstanceType", - "ComputeCapacity" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

A unique name for the fleet.

" - }, - "ImageName":{ - "shape":"String", - "documentation":"

The name of the image used to create the fleet.

" - }, - "ImageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the public, private, or shared image to use.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type to use when launching fleet instances. The following instance types are available:

  • stream.standard.medium

  • stream.standard.large

  • stream.compute.large

  • stream.compute.xlarge

  • stream.compute.2xlarge

  • stream.compute.4xlarge

  • stream.compute.8xlarge

  • stream.memory.large

  • stream.memory.xlarge

  • stream.memory.2xlarge

  • stream.memory.4xlarge

  • stream.memory.8xlarge

  • stream.graphics-design.large

  • stream.graphics-design.xlarge

  • stream.graphics-design.2xlarge

  • stream.graphics-design.4xlarge

  • stream.graphics-desktop.2xlarge

  • stream.graphics-pro.4xlarge

  • stream.graphics-pro.8xlarge

  • stream.graphics-pro.16xlarge

" - }, - "FleetType":{ - "shape":"FleetType", - "documentation":"

The fleet type.

ALWAYS_ON

Provides users with instant-on access to their apps. You are charged for all running instances in your fleet, even if no users are streaming apps.

ON_DEMAND

Provide users with access to applications after they connect, which takes one to two minutes. You are charged for instance streaming when users are connected and a small hourly fee for instances that are not streaming apps.

" - }, - "ComputeCapacity":{ - "shape":"ComputeCapacity", - "documentation":"

The desired capacity for the fleet.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VPC configuration for the fleet.

" - }, - "MaxUserDurationInSeconds":{ - "shape":"Integer", - "documentation":"

The maximum time that a streaming session can run, in seconds. Specify a value between 600 and 57600.

" - }, - "DisconnectTimeoutInSeconds":{ - "shape":"Integer", - "documentation":"

The time after disconnection when a session is considered to have ended, in seconds. If a user who was disconnected reconnects within this time interval, the user is connected to their previous session. Specify a value between 60 and 57600.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

The fleet name for display.

" - }, - "EnableDefaultInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables default internet access for the fleet.

" - }, - "DomainJoinInfo":{ - "shape":"DomainJoinInfo", - "documentation":"

The information needed to join a Microsoft Active Directory domain.

" - } - } - }, - "CreateFleetResult":{ - "type":"structure", - "members":{ - "Fleet":{ - "shape":"Fleet", - "documentation":"

Information about the fleet.

" - } - } - }, - "CreateImageBuilderRequest":{ - "type":"structure", - "required":[ - "Name", - "InstanceType" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

A unique name for the image builder.

" - }, - "ImageName":{ - "shape":"String", - "documentation":"

The name of the image used to create the builder.

" - }, - "ImageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the public, private, or shared image to use.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type to use when launching the image builder.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

The image builder name for display.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VPC configuration for the image builder. You can specify only one subnet.

" - }, - "EnableDefaultInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables default internet access for the image builder.

" - }, - "DomainJoinInfo":{ - "shape":"DomainJoinInfo", - "documentation":"

The information needed to join a Microsoft Active Directory domain.

" - }, - "AppstreamAgentVersion":{ - "shape":"AppstreamAgentVersion", - "documentation":"

The version of the AppStream 2.0 agent to use for this image builder. To use the latest version of the AppStream 2.0 agent, specify [LATEST].

" - } - } - }, - "CreateImageBuilderResult":{ - "type":"structure", - "members":{ - "ImageBuilder":{ - "shape":"ImageBuilder", - "documentation":"

Information about the image builder.

" - } - } - }, - "CreateImageBuilderStreamingURLRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the image builder.

" - }, - "Validity":{ - "shape":"Long", - "documentation":"

The time that the streaming URL will be valid, in seconds. Specify a value between 1 and 604800 seconds. The default is 3600 seconds.

" - } - } - }, - "CreateImageBuilderStreamingURLResult":{ - "type":"structure", - "members":{ - "StreamingURL":{ - "shape":"String", - "documentation":"

The URL to start the AppStream 2.0 streaming session.

" - }, - "Expires":{ - "shape":"Timestamp", - "documentation":"

The elapsed time, in seconds after the Unix epoch, when this URL expires.

" - } - } - }, - "CreateStackRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the stack.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

The stack name for display.

" - }, - "StorageConnectors":{ - "shape":"StorageConnectorList", - "documentation":"

The storage connectors to enable.

" - }, - "RedirectURL":{ - "shape":"RedirectURL", - "documentation":"

The URL that users are redirected to after their streaming session ends.

" - }, - "FeedbackURL":{ - "shape":"FeedbackURL", - "documentation":"

The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.

" - }, - "UserSettings":{ - "shape":"UserSettingList", - "documentation":"

The actions that are enabled or disabled for users during their streaming sessions. By default, these actions are enabled.

" - } - } - }, - "CreateStackResult":{ - "type":"structure", - "members":{ - "Stack":{ - "shape":"Stack", - "documentation":"

Information about the stack.

" - } - } - }, - "CreateStreamingURLRequest":{ - "type":"structure", - "required":[ - "StackName", - "FleetName", - "UserId" - ], - "members":{ - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack.

" - }, - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - }, - "UserId":{ - "shape":"StreamingUrlUserId", - "documentation":"

The ID of the user.

" - }, - "ApplicationId":{ - "shape":"String", - "documentation":"

The name of the application to launch after the session starts. This is the name that you specified as Name in the Image Assistant.

" - }, - "Validity":{ - "shape":"Long", - "documentation":"

The time that the streaming URL will be valid, in seconds. Specify a value between 1 and 604800 seconds. The default is 60 seconds.

" - }, - "SessionContext":{ - "shape":"String", - "documentation":"

The session context. For more information, see Session Context in the Amazon AppStream 2.0 Developer Guide.

" - } - } - }, - "CreateStreamingURLResult":{ - "type":"structure", - "members":{ - "StreamingURL":{ - "shape":"String", - "documentation":"

The URL to start the AppStream 2.0 streaming session.

" - }, - "Expires":{ - "shape":"Timestamp", - "documentation":"

The elapsed time, in seconds after the Unix epoch, when this URL expires.

" - } - } - }, - "DeleteDirectoryConfigRequest":{ - "type":"structure", - "required":["DirectoryName"], - "members":{ - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The name of the directory configuration.

" - } - } - }, - "DeleteDirectoryConfigResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteFleetRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - } - } - }, - "DeleteFleetResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteImageBuilderRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the image builder.

" - } - } - }, - "DeleteImageBuilderResult":{ - "type":"structure", - "members":{ - "ImageBuilder":{ - "shape":"ImageBuilder", - "documentation":"

Information about the image builder.

" - } - } - }, - "DeleteImagePermissionsRequest":{ - "type":"structure", - "required":[ - "Name", - "SharedAccountId" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the private image.

" - }, - "SharedAccountId":{ - "shape":"AwsAccountId", - "documentation":"

The 12-digit ID of the AWS account for which to delete image permissions.

" - } - } - }, - "DeleteImagePermissionsResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the image.

" - } - } - }, - "DeleteImageResult":{ - "type":"structure", - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

Information about the image.

" - } - } - }, - "DeleteStackRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the stack.

" - } - } - }, - "DeleteStackResult":{ - "type":"structure", - "members":{ - } - }, - "DescribeDirectoryConfigsRequest":{ - "type":"structure", - "members":{ - "DirectoryNames":{ - "shape":"DirectoryNameList", - "documentation":"

The directory names.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum size of each page of results.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "DescribeDirectoryConfigsResult":{ - "type":"structure", - "members":{ - "DirectoryConfigs":{ - "shape":"DirectoryConfigList", - "documentation":"

Information about the directory configurations. Note that although the response syntax in this topic includes the account password, this password is not returned in the actual response.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "DescribeFleetsRequest":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The names of the fleets to describe.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "DescribeFleetsResult":{ - "type":"structure", - "members":{ - "Fleets":{ - "shape":"FleetList", - "documentation":"

Information about the fleets.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "DescribeImageBuildersRequest":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The names of the image builders to describe.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum size of each page of results.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "DescribeImageBuildersResult":{ - "type":"structure", - "members":{ - "ImageBuilders":{ - "shape":"ImageBuilderList", - "documentation":"

Information about the image builders.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "DescribeImagePermissionsRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the private image for which to describe permissions. The image must be one that you own.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum size of each results page.

" - }, - "SharedAwsAccountIds":{ - "shape":"AwsAccountIdList", - "documentation":"

The 12-digit ID of one or more AWS accounts with which the image is shared.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results. If this value is empty, only the first page is retrieved.

" - } - } - }, - "DescribeImagePermissionsResult":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the private image.

" - }, - "SharedImagePermissionsList":{ - "shape":"SharedImagePermissionsList", - "documentation":"

The permissions for a private image that you own.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results. If this value is empty, only the first page is retrieved.

" - } - } - }, - "DescribeImagesMaxResults":{ - "type":"integer", - "box":true, - "max":25, - "min":0 - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The names of the images to describe.

" - }, - "Arns":{ - "shape":"ArnList", - "documentation":"

The ARNs of the public, private, and shared images to describe.

" - }, - "Type":{ - "shape":"VisibilityType", - "documentation":"

The type of image (public, private, or shared) to describe.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results. If this value is empty, only the first page is retrieved.

" - }, - "MaxResults":{ - "shape":"DescribeImagesMaxResults", - "documentation":"

The maximum size of each page of results.

" - } - } - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about the images.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results. If there are no more pages, this value is null.

" - } - } - }, - "DescribeSessionsRequest":{ - "type":"structure", - "required":[ - "StackName", - "FleetName" - ], - "members":{ - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack. This value is case-sensitive.

" - }, - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet. This value is case-sensitive.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The user ID.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - }, - "Limit":{ - "shape":"Integer", - "documentation":"

The size of each page of results. The default value is 20 and the maximum value is 50.

" - }, - "AuthenticationType":{ - "shape":"AuthenticationType", - "documentation":"

The authentication method. Specify API for a user authenticated using a streaming URL or SAML for a SAML federated user. The default is to authenticate users using a streaming URL.

" - } - } - }, - "DescribeSessionsResult":{ - "type":"structure", - "members":{ - "Sessions":{ - "shape":"SessionList", - "documentation":"

Information about the streaming sessions.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "DescribeStacksRequest":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The names of the stacks to describe.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "DescribeStacksResult":{ - "type":"structure", - "members":{ - "Stacks":{ - "shape":"StackList", - "documentation":"

Information about the stacks.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "Description":{ - "type":"string", - "max":256 - }, - "DirectoryConfig":{ - "type":"structure", - "required":["DirectoryName"], - "members":{ - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The fully qualified name of the directory (for example, corp.example.com).

" - }, - "OrganizationalUnitDistinguishedNames":{ - "shape":"OrganizationalUnitDistinguishedNamesList", - "documentation":"

The distinguished names of the organizational units for computer accounts.

" - }, - "ServiceAccountCredentials":{ - "shape":"ServiceAccountCredentials", - "documentation":"

The credentials for the service account used by the streaming instance to connect to the directory.

" - }, - "CreatedTime":{ - "shape":"Timestamp", - "documentation":"

The time the directory configuration was created.

" - } - }, - "documentation":"

Configuration information for the directory used to join domains.

" - }, - "DirectoryConfigList":{ - "type":"list", - "member":{"shape":"DirectoryConfig"} - }, - "DirectoryName":{"type":"string"}, - "DirectoryNameList":{ - "type":"list", - "member":{"shape":"DirectoryName"} - }, - "DisassociateFleetRequest":{ - "type":"structure", - "required":[ - "FleetName", - "StackName" - ], - "members":{ - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - }, - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack.

" - } - } - }, - "DisassociateFleetResult":{ - "type":"structure", - "members":{ - } - }, - "DisplayName":{ - "type":"string", - "max":100 - }, - "Domain":{ - "type":"string", - "documentation":"GSuite domain for GDrive integration.", - "max":64 - }, - "DomainJoinInfo":{ - "type":"structure", - "members":{ - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The fully qualified name of the directory (for example, corp.example.com).

" - }, - "OrganizationalUnitDistinguishedName":{ - "shape":"OrganizationalUnitDistinguishedName", - "documentation":"

The distinguished name of the organizational unit for computer accounts.

" - } - }, - "documentation":"

Contains the information needed to join a Microsoft Active Directory domain.

" - }, - "DomainList":{ - "type":"list", - "member":{"shape":"Domain"}, - "max":10 - }, - "ErrorMessage":{ - "type":"string", - "documentation":"

The error message in the exception.

" - }, - "ExpireSessionRequest":{ - "type":"structure", - "required":["SessionId"], - "members":{ - "SessionId":{ - "shape":"String", - "documentation":"

The ID of the streaming session.

" - } - } - }, - "ExpireSessionResult":{ - "type":"structure", - "members":{ - } - }, - "FeedbackURL":{ - "type":"string", - "max":1000 - }, - "Fleet":{ - "type":"structure", - "required":[ - "Arn", - "Name", - "InstanceType", - "ComputeCapacityStatus", - "State" - ], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN for the fleet.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The fleet name for display.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for display.

" - }, - "ImageName":{ - "shape":"String", - "documentation":"

The name of the image used to create the fleet.

" - }, - "ImageArn":{ - "shape":"Arn", - "documentation":"

The ARN for the public, private, or shared image.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type to use when launching fleet instances.

" - }, - "FleetType":{ - "shape":"FleetType", - "documentation":"

The fleet type.

ALWAYS_ON

Provides users with instant-on access to their apps. You are charged for all running instances in your fleet, even if no users are streaming apps.

ON_DEMAND

Provide users with access to applications after they connect, which takes one to two minutes. You are charged for instance streaming when users are connected and a small hourly fee for instances that are not streaming apps.

" - }, - "ComputeCapacityStatus":{ - "shape":"ComputeCapacityStatus", - "documentation":"

The capacity status for the fleet.

" - }, - "MaxUserDurationInSeconds":{ - "shape":"Integer", - "documentation":"

The maximum time that a streaming session can run, in seconds. Specify a value between 600 and 57600.

" - }, - "DisconnectTimeoutInSeconds":{ - "shape":"Integer", - "documentation":"

The time after disconnection when a session is considered to have ended, in seconds. If a user who was disconnected reconnects within this time interval, the user is connected to their previous session. Specify a value between 60 and 57600.

" - }, - "State":{ - "shape":"FleetState", - "documentation":"

The current state for the fleet.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VPC configuration for the fleet.

" - }, - "CreatedTime":{ - "shape":"Timestamp", - "documentation":"

The time the fleet was created.

" - }, - "FleetErrors":{ - "shape":"FleetErrors", - "documentation":"

The fleet errors.

" - }, - "EnableDefaultInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether default internet access is enabled for the fleet.

" - }, - "DomainJoinInfo":{ - "shape":"DomainJoinInfo", - "documentation":"

The information needed to join a Microsoft Active Directory domain.

" - } - }, - "documentation":"

Contains the parameters for a fleet.

" - }, - "FleetAttribute":{ - "type":"string", - "documentation":"

The fleet attribute.

", - "enum":[ - "VPC_CONFIGURATION", - "VPC_CONFIGURATION_SECURITY_GROUP_IDS", - "DOMAIN_JOIN_INFO" - ] - }, - "FleetAttributes":{ - "type":"list", - "member":{"shape":"FleetAttribute"}, - "documentation":"

The fleet attributes.

" - }, - "FleetError":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"FleetErrorCode", - "documentation":"

The error code.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

The error message.

" - } - }, - "documentation":"

Describes a fleet error.

" - }, - "FleetErrorCode":{ - "type":"string", - "enum":[ - "IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION", - "IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION", - "IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION", - "NETWORK_INTERFACE_LIMIT_EXCEEDED", - "INTERNAL_SERVICE_ERROR", - "IAM_SERVICE_ROLE_IS_MISSING", - "SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES", - "IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION", - "SUBNET_NOT_FOUND", - "IMAGE_NOT_FOUND", - "INVALID_SUBNET_CONFIGURATION", - "SECURITY_GROUPS_NOT_FOUND", - "IGW_NOT_ATTACHED", - "IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION", - "DOMAIN_JOIN_ERROR_FILE_NOT_FOUND", - "DOMAIN_JOIN_ERROR_ACCESS_DENIED", - "DOMAIN_JOIN_ERROR_LOGON_FAILURE", - "DOMAIN_JOIN_ERROR_INVALID_PARAMETER", - "DOMAIN_JOIN_ERROR_MORE_DATA", - "DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN", - "DOMAIN_JOIN_ERROR_NOT_SUPPORTED", - "DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME", - "DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED", - "DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED", - "DOMAIN_JOIN_NERR_PASSWORD_EXPIRED", - "DOMAIN_JOIN_INTERNAL_SERVICE_ERROR" - ] - }, - "FleetErrors":{ - "type":"list", - "member":{"shape":"FleetError"} - }, - "FleetList":{ - "type":"list", - "member":{"shape":"Fleet"}, - "documentation":"

The fleets.

" - }, - "FleetState":{ - "type":"string", - "enum":[ - "STARTING", - "RUNNING", - "STOPPING", - "STOPPED" - ] - }, - "FleetType":{ - "type":"string", - "enum":[ - "ALWAYS_ON", - "ON_DEMAND" - ] - }, - "Image":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the image.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the image.

" - }, - "BaseImageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the image from which this image was created.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The image name for display.

" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The image starts in the PENDING state. If image creation succeeds, the state is AVAILABLE. If image creation fails, the state is FAILED.

" - }, - "Visibility":{ - "shape":"VisibilityType", - "documentation":"

Indicates whether the image is public or private.

" - }, - "ImageBuilderSupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether an image builder can be launched from this image.

" - }, - "Platform":{ - "shape":"PlatformType", - "documentation":"

The operating system platform of the image.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for display.

" - }, - "StateChangeReason":{ - "shape":"ImageStateChangeReason", - "documentation":"

The reason why the last state change occurred.

" - }, - "Applications":{ - "shape":"Applications", - "documentation":"

The applications associated with the image.

" - }, - "CreatedTime":{ - "shape":"Timestamp", - "documentation":"

The time the image was created.

" - }, - "PublicBaseImageReleasedDate":{ - "shape":"Timestamp", - "documentation":"

The release date of the public base image. For private images, this date is the release date of the base image from which the image was created.

" - }, - "AppstreamAgentVersion":{ - "shape":"AppstreamAgentVersion", - "documentation":"

The version of the AppStream 2.0 agent to use for instances that are launched from this image.

" - }, - "ImagePermissions":{ - "shape":"ImagePermissions", - "documentation":"

The permissions to provide to the destination AWS account for the specified image.

" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageBuilder":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the image builder.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN for the image builder.

" - }, - "ImageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the image from which this builder was created.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The image builder name for display.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VPC configuration of the image builder.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type for the image builder.

" - }, - "Platform":{ - "shape":"PlatformType", - "documentation":"

The operating system platform of the image builder.

" - }, - "State":{ - "shape":"ImageBuilderState", - "documentation":"

The state of the image builder.

" - }, - "StateChangeReason":{ - "shape":"ImageBuilderStateChangeReason", - "documentation":"

The reason why the last state change occurred.

" - }, - "CreatedTime":{ - "shape":"Timestamp", - "documentation":"

The time stamp when the image builder was created.

" - }, - "EnableDefaultInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables default internet access for the image builder.

" - }, - "DomainJoinInfo":{ - "shape":"DomainJoinInfo", - "documentation":"

The information needed to join a Microsoft Active Directory domain.

" - }, - "ImageBuilderErrors":{ - "shape":"ResourceErrors", - "documentation":"

The image builder errors.

" - }, - "AppstreamAgentVersion":{ - "shape":"AppstreamAgentVersion", - "documentation":"

The version of the AppStream 2.0 agent that is currently being used by this image builder.

" - } - }, - "documentation":"

Describes a streaming instance used for editing an image. New images are created from a snapshot through an image builder.

" - }, - "ImageBuilderList":{ - "type":"list", - "member":{"shape":"ImageBuilder"} - }, - "ImageBuilderState":{ - "type":"string", - "enum":[ - "PENDING", - "UPDATING_AGENT", - "RUNNING", - "STOPPING", - "STOPPED", - "REBOOTING", - "SNAPSHOTTING", - "DELETING", - "FAILED" - ] - }, - "ImageBuilderStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"ImageBuilderStateChangeReasonCode", - "documentation":"

The state change reason code.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The state change reason message.

" - } - }, - "documentation":"

Describes the reason why the last image builder state change occurred.

" - }, - "ImageBuilderStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "IMAGE_UNAVAILABLE" - ] - }, - "ImageList":{ - "type":"list", - "member":{"shape":"Image"} - }, - "ImagePermissions":{ - "type":"structure", - "members":{ - "allowFleet":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the image can be used for a fleet.

" - }, - "allowImageBuilder":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the image can be used for an image builder.

" - } - }, - "documentation":"

Describes the permissions for an image.

" - }, - "ImageState":{ - "type":"string", - "enum":[ - "PENDING", - "AVAILABLE", - "FAILED", - "COPYING", - "DELETING" - ] - }, - "ImageStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"ImageStateChangeReasonCode", - "documentation":"

The state change reason code.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The state change reason message.

" - } - }, - "documentation":"

Describes the reason why the last image state change occurred.

" - }, - "ImageStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "IMAGE_BUILDER_NOT_AVAILABLE", - "IMAGE_COPY_FAILURE" - ] - }, - "IncompatibleImageException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The image does not support storage connectors.

", - "exception":true - }, - "Integer":{"type":"integer"}, - "InvalidAccountStatusException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The resource cannot be created because your AWS account is suspended. For assistance, contact AWS Support.

", - "exception":true - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Indicates an incorrect combination of parameters, or a missing parameter.

", - "exception":true - }, - "InvalidRoleException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified role is invalid.

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The requested limit exceeds the permitted limit for an account.

", - "exception":true - }, - "ListAssociatedFleetsRequest":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "ListAssociatedFleetsResult":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The name of the fleet.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "ListAssociatedStacksRequest":{ - "type":"structure", - "required":["FleetName"], - "members":{ - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

" - } - } - }, - "ListAssociatedStacksResult":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"StringList", - "documentation":"

The name of the stack.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

The information about the tags.

" - } - } - }, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "box":true, - "max":500, - "min":0 - }, - "Metadata":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Name":{ - "type":"string", - "pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,100}$" - }, - "NetworkAccessConfiguration":{ - "type":"structure", - "members":{ - "EniPrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the elastic network interface that is attached to instances in your VPC.

" - }, - "EniId":{ - "shape":"String", - "documentation":"

The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.

" - } - }, - "documentation":"

The network details of the fleet instance for the streaming session.

" - }, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The attempted operation is not permitted.

", - "exception":true - }, - "OrganizationalUnitDistinguishedName":{ - "type":"string", - "max":2000 - }, - "OrganizationalUnitDistinguishedNamesList":{ - "type":"list", - "member":{"shape":"OrganizationalUnitDistinguishedName"} - }, - "Permission":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "PlatformType":{ - "type":"string", - "enum":["WINDOWS"] - }, - "RedirectURL":{ - "type":"string", - "max":1000 - }, - "RegionName":{ - "type":"string", - "max":32, - "min":1 - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource already exists.

", - "exception":true - }, - "ResourceError":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"FleetErrorCode", - "documentation":"

The error code.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

The error message.

" - }, - "ErrorTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time the error occurred.

" - } - }, - "documentation":"

Describes a resource error.

" - }, - "ResourceErrors":{ - "type":"list", - "member":{"shape":"ResourceError"} - }, - "ResourceIdentifier":{ - "type":"string", - "documentation":"

The ARN of the resource.

", - "min":1 - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource is in use.

", - "exception":true - }, - "ResourceNotAvailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource exists and is not in use, but isn't available.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource was not found.

", - "exception":true - }, - "SecurityGroupIdList":{ - "type":"list", - "member":{"shape":"String"}, - "documentation":"

The security group IDs.

", - "max":5 - }, - "ServiceAccountCredentials":{ - "type":"structure", - "required":[ - "AccountName", - "AccountPassword" - ], - "members":{ - "AccountName":{ - "shape":"AccountName", - "documentation":"

The user name of the account. This account must have the following privileges: create computer objects, join computers to the domain, and change/reset the password on descendant computer objects for the organizational units specified.

" - }, - "AccountPassword":{ - "shape":"AccountPassword", - "documentation":"

The password for the account.

" - } - }, - "documentation":"

Describes the credentials for the service account used by the streaming instance to connect to the directory.

" - }, - "Session":{ - "type":"structure", - "required":[ - "Id", - "UserId", - "StackName", - "FleetName", - "State" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The ID of the streaming session.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier of the user for whom the session was created.

" - }, - "StackName":{ - "shape":"String", - "documentation":"

The name of the stack for the streaming session.

" - }, - "FleetName":{ - "shape":"String", - "documentation":"

The name of the fleet for the streaming session.

" - }, - "State":{ - "shape":"SessionState", - "documentation":"

The current state of the streaming session.

" - }, - "AuthenticationType":{ - "shape":"AuthenticationType", - "documentation":"

The authentication method. The user is authenticated using a streaming URL (API) or SAML federation (SAML).

" - }, - "NetworkAccessConfiguration":{ - "shape":"NetworkAccessConfiguration", - "documentation":"

The network details for the streaming session.

" - } - }, - "documentation":"

Describes a streaming session.

" - }, - "SessionList":{ - "type":"list", - "member":{"shape":"Session"}, - "documentation":"

List of sessions.

" - }, - "SessionState":{ - "type":"string", - "documentation":"

Possible values for the state of a streaming session.

", - "enum":[ - "ACTIVE", - "PENDING", - "EXPIRED" - ] - }, - "SharedImagePermissions":{ - "type":"structure", - "required":[ - "sharedAccountId", - "imagePermissions" - ], - "members":{ - "sharedAccountId":{ - "shape":"AwsAccountId", - "documentation":"

The 12-digit ID of the AWS account with which the image is shared.

" - }, - "imagePermissions":{ - "shape":"ImagePermissions", - "documentation":"

Describes the permissions for a shared image.

" - } - }, - "documentation":"

Describes the permissions that are available to the specified AWS account for a shared image.

" - }, - "SharedImagePermissionsList":{ - "type":"list", - "member":{"shape":"SharedImagePermissions"} - }, - "Stack":{ - "type":"structure", - "required":["Name"], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the stack.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the stack.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The stack name for display.

" - }, - "CreatedTime":{ - "shape":"Timestamp", - "documentation":"

The time the stack was created.

" - }, - "StorageConnectors":{ - "shape":"StorageConnectorList", - "documentation":"

The storage connectors to enable.

" - }, - "RedirectURL":{ - "shape":"RedirectURL", - "documentation":"

The URL that users are redirected to after their streaming session ends.

" - }, - "FeedbackURL":{ - "shape":"FeedbackURL", - "documentation":"

The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.

" - }, - "StackErrors":{ - "shape":"StackErrors", - "documentation":"

The errors for the stack.

" - }, - "UserSettings":{ - "shape":"UserSettingList", - "documentation":"

The actions that are enabled or disabled for users during their streaming sessions. By default these actions are enabled.

" - } - }, - "documentation":"

Describes a stack.

" - }, - "StackAttribute":{ - "type":"string", - "enum":[ - "STORAGE_CONNECTORS", - "STORAGE_CONNECTOR_HOMEFOLDERS", - "STORAGE_CONNECTOR_GOOGLE_DRIVE", - "STORAGE_CONNECTOR_ONE_DRIVE", - "REDIRECT_URL", - "FEEDBACK_URL", - "THEME_NAME", - "USER_SETTINGS" - ] - }, - "StackAttributes":{ - "type":"list", - "member":{"shape":"StackAttribute"} - }, - "StackError":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"StackErrorCode", - "documentation":"

The error code.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

The error message.

" - } - }, - "documentation":"

Describes a stack error.

" - }, - "StackErrorCode":{ - "type":"string", - "enum":[ - "STORAGE_CONNECTOR_ERROR", - "INTERNAL_SERVICE_ERROR" - ] - }, - "StackErrors":{ - "type":"list", - "member":{"shape":"StackError"}, - "documentation":"

The stack errors.

" - }, - "StackList":{ - "type":"list", - "member":{"shape":"Stack"}, - "documentation":"

The stacks.

" - }, - "StartFleetRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - } - } - }, - "StartFleetResult":{ - "type":"structure", - "members":{ - } - }, - "StartImageBuilderRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the image builder.

" - }, - "AppstreamAgentVersion":{ - "shape":"AppstreamAgentVersion", - "documentation":"

The version of the AppStream 2.0 agent to use for this image builder. To use the latest version of the AppStream 2.0 agent, specify [LATEST].

" - } - } - }, - "StartImageBuilderResult":{ - "type":"structure", - "members":{ - "ImageBuilder":{ - "shape":"ImageBuilder", - "documentation":"

Information about the image builder.

" - } - } - }, - "StopFleetRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the fleet.

" - } - } - }, - "StopFleetResult":{ - "type":"structure", - "members":{ - } - }, - "StopImageBuilderRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the image builder.

" - } - } - }, - "StopImageBuilderResult":{ - "type":"structure", - "members":{ - "ImageBuilder":{ - "shape":"ImageBuilder", - "documentation":"

Information about the image builder.

" - } - } - }, - "StorageConnector":{ - "type":"structure", - "required":["ConnectorType"], - "members":{ - "ConnectorType":{ - "shape":"StorageConnectorType", - "documentation":"

The type of storage connector.

" - }, - "ResourceIdentifier":{ - "shape":"ResourceIdentifier", - "documentation":"

The ARN of the storage connector.

" - }, - "Domains":{ - "shape":"DomainList", - "documentation":"

The names of the domains for the G Suite account.

" - } - }, - "documentation":"

Describes a connector to enable persistent storage for users.

" - }, - "StorageConnectorList":{ - "type":"list", - "member":{"shape":"StorageConnector"}, - "documentation":"

The storage connectors.

" - }, - "StorageConnectorType":{ - "type":"string", - "documentation":"

The type of storage connector.

", - "enum":[ - "HOMEFOLDERS", - "GOOGLE_DRIVE", - "ONE_DRIVE" - ] - }, - "StreamingUrlUserId":{ - "type":"string", - "max":32, - "min":2, - "pattern":"[\\w+=,.@-]*" - }, - "String":{ - "type":"string", - "min":1 - }, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubnetIdList":{ - "type":"list", - "member":{"shape":"String"}, - "documentation":"

The subnet IDs.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^(^(?!aws:).[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags to associate. A tag is a key-value pair (the value is optional). For example, Environment=Test, or, if you do not specify a value, Environment=.

If you do not specify a value, we set the value to an empty string.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"}, - "max":50, - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The tag keys for the tags to disassociate.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateDirectoryConfigRequest":{ - "type":"structure", - "required":["DirectoryName"], - "members":{ - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The name of the Directory Config object.

" - }, - "OrganizationalUnitDistinguishedNames":{ - "shape":"OrganizationalUnitDistinguishedNamesList", - "documentation":"

The distinguished names of the organizational units for computer accounts.

" - }, - "ServiceAccountCredentials":{ - "shape":"ServiceAccountCredentials", - "documentation":"

The credentials for the service account used by the streaming instance to connect to the directory.

" - } - } - }, - "UpdateDirectoryConfigResult":{ - "type":"structure", - "members":{ - "DirectoryConfig":{ - "shape":"DirectoryConfig", - "documentation":"

Information about the Directory Config object.

" - } - } - }, - "UpdateFleetRequest":{ - "type":"structure", - "members":{ - "ImageName":{ - "shape":"String", - "documentation":"

The name of the image used to create the fleet.

" - }, - "ImageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the public, private, or shared image to use.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A unique name for the fleet.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type to use when launching fleet instances. The following instance types are available:

  • stream.standard.medium

  • stream.standard.large

  • stream.compute.large

  • stream.compute.xlarge

  • stream.compute.2xlarge

  • stream.compute.4xlarge

  • stream.compute.8xlarge

  • stream.memory.large

  • stream.memory.xlarge

  • stream.memory.2xlarge

  • stream.memory.4xlarge

  • stream.memory.8xlarge

  • stream.graphics-design.large

  • stream.graphics-design.xlarge

  • stream.graphics-design.2xlarge

  • stream.graphics-design.4xlarge

  • stream.graphics-desktop.2xlarge

  • stream.graphics-pro.4xlarge

  • stream.graphics-pro.8xlarge

  • stream.graphics-pro.16xlarge

" - }, - "ComputeCapacity":{ - "shape":"ComputeCapacity", - "documentation":"

The desired capacity for the fleet.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VPC configuration for the fleet.

" - }, - "MaxUserDurationInSeconds":{ - "shape":"Integer", - "documentation":"

The maximum time that a streaming session can run, in seconds. Specify a value between 600 and 57600.

" - }, - "DisconnectTimeoutInSeconds":{ - "shape":"Integer", - "documentation":"

The time after disconnection when a session is considered to have ended, in seconds. If a user who was disconnected reconnects within this time interval, the user is connected to their previous session. Specify a value between 60 and 57600.

" - }, - "DeleteVpcConfig":{ - "shape":"Boolean", - "documentation":"

Deletes the VPC association for the specified fleet.

", - "deprecated":true - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for display.

" - }, - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

The fleet name for display.

" - }, - "EnableDefaultInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables default internet access for the fleet.

" - }, - "DomainJoinInfo":{ - "shape":"DomainJoinInfo", - "documentation":"

The information needed to join a Microsoft Active Directory domain.

" - }, - "AttributesToDelete":{ - "shape":"FleetAttributes", - "documentation":"

The fleet attributes to delete.

" - } - } - }, - "UpdateFleetResult":{ - "type":"structure", - "members":{ - "Fleet":{ - "shape":"Fleet", - "documentation":"

Information about the fleet.

" - } - } - }, - "UpdateImagePermissionsRequest":{ - "type":"structure", - "required":[ - "Name", - "SharedAccountId", - "ImagePermissions" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the private image.

" - }, - "SharedAccountId":{ - "shape":"AwsAccountId", - "documentation":"

The 12-digit ID of the AWS account for which you want add or update image permissions.

" - }, - "ImagePermissions":{ - "shape":"ImagePermissions", - "documentation":"

The permissions for the image.

" - } - } - }, - "UpdateImagePermissionsResult":{ - "type":"structure", - "members":{ - } - }, - "UpdateStackRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

The stack name for display.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for display.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the stack.

" - }, - "StorageConnectors":{ - "shape":"StorageConnectorList", - "documentation":"

The storage connectors to enable.

" - }, - "DeleteStorageConnectors":{ - "shape":"Boolean", - "documentation":"

Deletes the storage connectors currently enabled for the stack.

", - "deprecated":true - }, - "RedirectURL":{ - "shape":"RedirectURL", - "documentation":"

The URL that users are redirected to after their streaming session ends.

" - }, - "FeedbackURL":{ - "shape":"FeedbackURL", - "documentation":"

The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.

" - }, - "AttributesToDelete":{ - "shape":"StackAttributes", - "documentation":"

The stack attributes to delete.

" - }, - "UserSettings":{ - "shape":"UserSettingList", - "documentation":"

The actions that are enabled or disabled for users during their streaming sessions. By default, these actions are enabled.

" - } - } - }, - "UpdateStackResult":{ - "type":"structure", - "members":{ - "Stack":{ - "shape":"Stack", - "documentation":"

Information about the stack.

" - } - } - }, - "UserId":{ - "type":"string", - "max":32, - "min":2 - }, - "UserSetting":{ - "type":"structure", - "required":[ - "Action", - "Permission" - ], - "members":{ - "Action":{ - "shape":"Action", - "documentation":"

The action that is enabled or disabled.

" - }, - "Permission":{ - "shape":"Permission", - "documentation":"

Indicates whether the action is enabled or disabled.

" - } - }, - "documentation":"

Describes an action and whether the action is enabled or disabled for users during their streaming sessions.

" - }, - "UserSettingList":{ - "type":"list", - "member":{"shape":"UserSetting"}, - "min":1 - }, - "VisibilityType":{ - "type":"string", - "enum":[ - "PUBLIC", - "PRIVATE", - "SHARED" - ] - }, - "VpcConfig":{ - "type":"structure", - "members":{ - "SubnetIds":{ - "shape":"SubnetIdList", - "documentation":"

The subnets to which a network interface is established from the fleet instance.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdList", - "documentation":"

The security groups for the fleet.

" - } - }, - "documentation":"

Describes VPC configuration information.

" - } - }, - "documentation":"Amazon AppStream 2.0

You can use Amazon AppStream 2.0 to stream desktop applications to any device running a web browser, without rewriting them.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/waiters-2.json deleted file mode 100644 index f53f609c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appstream/2016-12-01/waiters-2.json +++ /dev/null @@ -1,55 +0,0 @@ -{ - "version": 2, - "waiters": { - "FleetStarted": { - "delay": 30, - "maxAttempts": 40, - "operation": "DescribeFleets", - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Fleets[].State", - "expected": "ACTIVE" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Fleets[].State", - "expected": "PENDING_DEACTIVATE" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Fleets[].State", - "expected": "INACTIVE" - } - ] - }, - "FleetStopped": { - "delay": 30, - "maxAttempts": 40, - "operation": "DescribeFleets", - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Fleets[].State", - "expected": "INACTIVE" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Fleets[].State", - "expected": "PENDING_ACTIVATE" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Fleets[].State", - "expected": "ACTIVE" - } - ] - } - } -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/service-2.json deleted file mode 100644 index 8d8e1747..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/appsync/2017-07-25/service-2.json +++ /dev/null @@ -1,1918 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-07-25", - "endpointPrefix":"appsync", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"AWSAppSync", - "serviceFullName":"AWS AppSync", - "serviceId":"AppSync", - "signatureVersion":"v4", - "signingName":"appsync", - "uid":"appsync-2017-07-25" - }, - "operations":{ - "CreateApiKey":{ - "name":"CreateApiKey", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/apikeys" - }, - "input":{"shape":"CreateApiKeyRequest"}, - "output":{"shape":"CreateApiKeyResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ApiKeyLimitExceededException"}, - {"shape":"ApiKeyValidityOutOfBoundsException"} - ], - "documentation":"

Creates a unique key that you can distribute to clients who are executing your API.

" - }, - "CreateDataSource":{ - "name":"CreateDataSource", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/datasources" - }, - "input":{"shape":"CreateDataSourceRequest"}, - "output":{"shape":"CreateDataSourceResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a DataSource object.

" - }, - "CreateGraphqlApi":{ - "name":"CreateGraphqlApi", - "http":{ - "method":"POST", - "requestUri":"/v1/apis" - }, - "input":{"shape":"CreateGraphqlApiRequest"}, - "output":{"shape":"CreateGraphqlApiResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ApiLimitExceededException"} - ], - "documentation":"

Creates a GraphqlApi object.

" - }, - "CreateResolver":{ - "name":"CreateResolver", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/types/{typeName}/resolvers" - }, - "input":{"shape":"CreateResolverRequest"}, - "output":{"shape":"CreateResolverResponse"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a Resolver object.

A resolver converts incoming requests into a format that a data source can understand and converts the data source's responses into GraphQL.

" - }, - "CreateType":{ - "name":"CreateType", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/types" - }, - "input":{"shape":"CreateTypeRequest"}, - "output":{"shape":"CreateTypeResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a Type object.

" - }, - "DeleteApiKey":{ - "name":"DeleteApiKey", - "http":{ - "method":"DELETE", - "requestUri":"/v1/apis/{apiId}/apikeys/{id}" - }, - "input":{"shape":"DeleteApiKeyRequest"}, - "output":{"shape":"DeleteApiKeyResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes an API key.

" - }, - "DeleteDataSource":{ - "name":"DeleteDataSource", - "http":{ - "method":"DELETE", - "requestUri":"/v1/apis/{apiId}/datasources/{name}" - }, - "input":{"shape":"DeleteDataSourceRequest"}, - "output":{"shape":"DeleteDataSourceResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a DataSource object.

" - }, - "DeleteGraphqlApi":{ - "name":"DeleteGraphqlApi", - "http":{ - "method":"DELETE", - "requestUri":"/v1/apis/{apiId}" - }, - "input":{"shape":"DeleteGraphqlApiRequest"}, - "output":{"shape":"DeleteGraphqlApiResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a GraphqlApi object.

" - }, - "DeleteResolver":{ - "name":"DeleteResolver", - "http":{ - "method":"DELETE", - "requestUri":"/v1/apis/{apiId}/types/{typeName}/resolvers/{fieldName}" - }, - "input":{"shape":"DeleteResolverRequest"}, - "output":{"shape":"DeleteResolverResponse"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a Resolver object.

" - }, - "DeleteType":{ - "name":"DeleteType", - "http":{ - "method":"DELETE", - "requestUri":"/v1/apis/{apiId}/types/{typeName}" - }, - "input":{"shape":"DeleteTypeRequest"}, - "output":{"shape":"DeleteTypeResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a Type object.

" - }, - "GetDataSource":{ - "name":"GetDataSource", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/datasources/{name}" - }, - "input":{"shape":"GetDataSourceRequest"}, - "output":{"shape":"GetDataSourceResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Retrieves a DataSource object.

" - }, - "GetGraphqlApi":{ - "name":"GetGraphqlApi", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}" - }, - "input":{"shape":"GetGraphqlApiRequest"}, - "output":{"shape":"GetGraphqlApiResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Retrieves a GraphqlApi object.

" - }, - "GetIntrospectionSchema":{ - "name":"GetIntrospectionSchema", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/schema" - }, - "input":{"shape":"GetIntrospectionSchemaRequest"}, - "output":{"shape":"GetIntrospectionSchemaResponse"}, - "errors":[ - {"shape":"GraphQLSchemaException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Retrieves the introspection schema for a GraphQL API.

" - }, - "GetResolver":{ - "name":"GetResolver", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/types/{typeName}/resolvers/{fieldName}" - }, - "input":{"shape":"GetResolverRequest"}, - "output":{"shape":"GetResolverResponse"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves a Resolver object.

" - }, - "GetSchemaCreationStatus":{ - "name":"GetSchemaCreationStatus", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/schemacreation" - }, - "input":{"shape":"GetSchemaCreationStatusRequest"}, - "output":{"shape":"GetSchemaCreationStatusResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Retrieves the current status of a schema creation operation.

" - }, - "GetType":{ - "name":"GetType", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/types/{typeName}" - }, - "input":{"shape":"GetTypeRequest"}, - "output":{"shape":"GetTypeResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Retrieves a Type object.

" - }, - "ListApiKeys":{ - "name":"ListApiKeys", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/apikeys" - }, - "input":{"shape":"ListApiKeysRequest"}, - "output":{"shape":"ListApiKeysResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the API keys for a given API.

API keys are deleted automatically sometime after they expire. However, they may still be included in the response until they have actually been deleted. You can safely call DeleteApiKey to manually delete a key before it's automatically deleted.

" - }, - "ListDataSources":{ - "name":"ListDataSources", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/datasources" - }, - "input":{"shape":"ListDataSourcesRequest"}, - "output":{"shape":"ListDataSourcesResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the data sources for a given API.

" - }, - "ListGraphqlApis":{ - "name":"ListGraphqlApis", - "http":{ - "method":"GET", - "requestUri":"/v1/apis" - }, - "input":{"shape":"ListGraphqlApisRequest"}, - "output":{"shape":"ListGraphqlApisResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists your GraphQL APIs.

" - }, - "ListResolvers":{ - "name":"ListResolvers", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/types/{typeName}/resolvers" - }, - "input":{"shape":"ListResolversRequest"}, - "output":{"shape":"ListResolversResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the resolvers for a given API and type.

" - }, - "ListTypes":{ - "name":"ListTypes", - "http":{ - "method":"GET", - "requestUri":"/v1/apis/{apiId}/types" - }, - "input":{"shape":"ListTypesRequest"}, - "output":{"shape":"ListTypesResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the types for a given API.

" - }, - "StartSchemaCreation":{ - "name":"StartSchemaCreation", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/schemacreation" - }, - "input":{"shape":"StartSchemaCreationRequest"}, - "output":{"shape":"StartSchemaCreationResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Adds a new schema to your GraphQL API.

This operation is asynchronous. Use to determine when it has completed.

" - }, - "UpdateApiKey":{ - "name":"UpdateApiKey", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/apikeys/{id}" - }, - "input":{"shape":"UpdateApiKeyRequest"}, - "output":{"shape":"UpdateApiKeyResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ApiKeyValidityOutOfBoundsException"} - ], - "documentation":"

Updates an API key.

" - }, - "UpdateDataSource":{ - "name":"UpdateDataSource", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/datasources/{name}" - }, - "input":{"shape":"UpdateDataSourceRequest"}, - "output":{"shape":"UpdateDataSourceResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a DataSource object.

" - }, - "UpdateGraphqlApi":{ - "name":"UpdateGraphqlApi", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}" - }, - "input":{"shape":"UpdateGraphqlApiRequest"}, - "output":{"shape":"UpdateGraphqlApiResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a GraphqlApi object.

" - }, - "UpdateResolver":{ - "name":"UpdateResolver", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/types/{typeName}/resolvers/{fieldName}" - }, - "input":{"shape":"UpdateResolverRequest"}, - "output":{"shape":"UpdateResolverResponse"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a Resolver object.

" - }, - "UpdateType":{ - "name":"UpdateType", - "http":{ - "method":"POST", - "requestUri":"/v1/apis/{apiId}/types/{typeName}" - }, - "input":{"shape":"UpdateTypeRequest"}, - "output":{"shape":"UpdateTypeResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a Type object.

" - } - }, - "shapes":{ - "ApiKey":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The API key ID.

" - }, - "description":{ - "shape":"String", - "documentation":"

A description of the purpose of the API key.

" - }, - "expires":{ - "shape":"Long", - "documentation":"

The time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour.

" - } - }, - "documentation":"

Describes an API key.

Customers invoke AWS AppSync GraphQL APIs with API keys as an identity mechanism. There are two key versions:

da1: This version was introduced at launch in November 2017. These keys always expire after 7 days. Key expiration is managed by DynamoDB TTL. The keys will cease to be valid after Feb 21, 2018 and should not be used after that date.

  • ListApiKeys returns the expiration time in milliseconds.

  • CreateApiKey returns the expiration time in milliseconds.

  • UpdateApiKey is not available for this key version.

  • DeleteApiKey deletes the item from the table.

  • Expiration is stored in DynamoDB as milliseconds. This results in a bug where keys are not automatically deleted because DynamoDB expects the TTL to be stored in seconds. As a one-time action, we will delete these keys from the table after Feb 21, 2018.

da2: This version was introduced in February 2018 when AppSync added support to extend key expiration.

  • ListApiKeys returns the expiration time in seconds.

  • CreateApiKey returns the expiration time in seconds and accepts a user-provided expiration time in seconds.

  • UpdateApiKey returns the expiration time in seconds and accepts a user-provided expiration time in seconds. Key expiration can only be updated while the key has not expired.

  • DeleteApiKey deletes the item from the table.

  • Expiration is stored in DynamoDB as seconds.

" - }, - "ApiKeyLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The API key exceeded a limit. Try your request again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ApiKeyValidityOutOfBoundsException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The API key expiration must be set to a value between 1 and 365 days from creation (for CreateApiKey) or from update (for UpdateApiKey).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ApiKeys":{ - "type":"list", - "member":{"shape":"ApiKey"} - }, - "ApiLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The GraphQL API exceeded a limit. Try your request again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "AuthenticationType":{ - "type":"string", - "enum":[ - "API_KEY", - "AWS_IAM", - "AMAZON_COGNITO_USER_POOLS", - "OPENID_CONNECT" - ] - }, - "BadRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Blob":{"type":"blob"}, - "Boolean":{"type":"boolean"}, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Another modification is being made. That modification must complete before you can make your change.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CreateApiKeyRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The ID for your GraphQL API.

", - "location":"uri", - "locationName":"apiId" - }, - "description":{ - "shape":"String", - "documentation":"

A description of the purpose of the API key.

" - }, - "expires":{ - "shape":"Long", - "documentation":"

The time from creation time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour. The default value for this parameter is 7 days from creation time. For more information, see .

" - } - } - }, - "CreateApiKeyResponse":{ - "type":"structure", - "members":{ - "apiKey":{ - "shape":"ApiKey", - "documentation":"

The API key.

" - } - } - }, - "CreateDataSourceRequest":{ - "type":"structure", - "required":[ - "apiId", - "name", - "type" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID for the GraphQL API for the DataSource.

", - "location":"uri", - "locationName":"apiId" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

A user-supplied name for the DataSource.

" - }, - "description":{ - "shape":"String", - "documentation":"

A description of the DataSource.

" - }, - "type":{ - "shape":"DataSourceType", - "documentation":"

The type of the DataSource.

" - }, - "serviceRoleArn":{ - "shape":"String", - "documentation":"

The IAM service role ARN for the data source. The system assumes this role when accessing the data source.

" - }, - "dynamodbConfig":{ - "shape":"DynamodbDataSourceConfig", - "documentation":"

DynamoDB settings.

" - }, - "lambdaConfig":{ - "shape":"LambdaDataSourceConfig", - "documentation":"

AWS Lambda settings.

" - }, - "elasticsearchConfig":{ - "shape":"ElasticsearchDataSourceConfig", - "documentation":"

Amazon Elasticsearch settings.

" - }, - "httpConfig":{ - "shape":"HttpDataSourceConfig", - "documentation":"

Http endpoint settings.

" - } - } - }, - "CreateDataSourceResponse":{ - "type":"structure", - "members":{ - "dataSource":{ - "shape":"DataSource", - "documentation":"

The DataSource object.

" - } - } - }, - "CreateGraphqlApiRequest":{ - "type":"structure", - "required":[ - "name", - "authenticationType" - ], - "members":{ - "name":{ - "shape":"String", - "documentation":"

A user-supplied name for the GraphqlApi.

" - }, - "logConfig":{ - "shape":"LogConfig", - "documentation":"

The Amazon CloudWatch logs configuration.

" - }, - "authenticationType":{ - "shape":"AuthenticationType", - "documentation":"

The authentication type: API key, IAM, or Amazon Cognito User Pools.

" - }, - "userPoolConfig":{ - "shape":"UserPoolConfig", - "documentation":"

The Amazon Cognito User Pool configuration.

" - }, - "openIDConnectConfig":{ - "shape":"OpenIDConnectConfig", - "documentation":"

The Open Id Connect configuration configuration.

" - } - } - }, - "CreateGraphqlApiResponse":{ - "type":"structure", - "members":{ - "graphqlApi":{ - "shape":"GraphqlApi", - "documentation":"

The GraphqlApi.

" - } - } - }, - "CreateResolverRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "fieldName", - "dataSourceName", - "requestMappingTemplate" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The ID for the GraphQL API for which the resolver is being created.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The name of the Type.

", - "location":"uri", - "locationName":"typeName" - }, - "fieldName":{ - "shape":"ResourceName", - "documentation":"

The name of the field to attach the resolver to.

" - }, - "dataSourceName":{ - "shape":"ResourceName", - "documentation":"

The name of the data source for which the resolver is being created.

" - }, - "requestMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The mapping template to be used for requests.

A resolver uses a request mapping template to convert a GraphQL expression into a format that a data source can understand. Mapping templates are written in Apache Velocity Template Language (VTL).

" - }, - "responseMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The mapping template to be used for responses from the data source.

" - } - } - }, - "CreateResolverResponse":{ - "type":"structure", - "members":{ - "resolver":{ - "shape":"Resolver", - "documentation":"

The Resolver object.

" - } - } - }, - "CreateTypeRequest":{ - "type":"structure", - "required":[ - "apiId", - "definition", - "format" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "definition":{ - "shape":"String", - "documentation":"

The type definition, in GraphQL Schema Definition Language (SDL) format.

For more information, see the GraphQL SDL documentation.

" - }, - "format":{ - "shape":"TypeDefinitionFormat", - "documentation":"

The type format: SDL or JSON.

" - } - } - }, - "CreateTypeResponse":{ - "type":"structure", - "members":{ - "type":{ - "shape":"Type", - "documentation":"

The Type object.

" - } - } - }, - "DataSource":{ - "type":"structure", - "members":{ - "dataSourceArn":{ - "shape":"String", - "documentation":"

The data source ARN.

" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the data source.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the data source.

" - }, - "type":{ - "shape":"DataSourceType", - "documentation":"

The type of the data source.

  • AMAZON_DYNAMODB: The data source is an Amazon DynamoDB table.

  • AMAZON_ELASTICSEARCH: The data source is an Amazon Elasticsearch Service domain.

  • AWS_LAMBDA: The data source is an AWS Lambda function.

  • NONE: There is no data source. This type is used when when you wish to invoke a GraphQL operation without connecting to a data source, such as performing data transformation with resolvers or triggering a subscription to be invoked from a mutation.

  • HTTP: The data source is an HTTP endpoint.

" - }, - "serviceRoleArn":{ - "shape":"String", - "documentation":"

The IAM service role ARN for the data source. The system assumes this role when accessing the data source.

" - }, - "dynamodbConfig":{ - "shape":"DynamodbDataSourceConfig", - "documentation":"

DynamoDB settings.

" - }, - "lambdaConfig":{ - "shape":"LambdaDataSourceConfig", - "documentation":"

Lambda settings.

" - }, - "elasticsearchConfig":{ - "shape":"ElasticsearchDataSourceConfig", - "documentation":"

Amazon Elasticsearch settings.

" - }, - "httpConfig":{ - "shape":"HttpDataSourceConfig", - "documentation":"

Http endpoint settings.

" - } - }, - "documentation":"

Describes a data source.

" - }, - "DataSourceType":{ - "type":"string", - "enum":[ - "AWS_LAMBDA", - "AMAZON_DYNAMODB", - "AMAZON_ELASTICSEARCH", - "NONE", - "HTTP" - ] - }, - "DataSources":{ - "type":"list", - "member":{"shape":"DataSource"} - }, - "DefaultAction":{ - "type":"string", - "enum":[ - "ALLOW", - "DENY" - ] - }, - "DeleteApiKeyRequest":{ - "type":"structure", - "required":[ - "apiId", - "id" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "id":{ - "shape":"String", - "documentation":"

The ID for the API key.

", - "location":"uri", - "locationName":"id" - } - } - }, - "DeleteApiKeyResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteDataSourceRequest":{ - "type":"structure", - "required":[ - "apiId", - "name" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the data source.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DeleteDataSourceResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteGraphqlApiRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - } - } - }, - "DeleteGraphqlApiResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteResolverRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "fieldName" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The name of the resolver type.

", - "location":"uri", - "locationName":"typeName" - }, - "fieldName":{ - "shape":"ResourceName", - "documentation":"

The resolver field name.

", - "location":"uri", - "locationName":"fieldName" - } - } - }, - "DeleteResolverResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteTypeRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The type name.

", - "location":"uri", - "locationName":"typeName" - } - } - }, - "DeleteTypeResponse":{ - "type":"structure", - "members":{ - } - }, - "DynamodbDataSourceConfig":{ - "type":"structure", - "required":[ - "tableName", - "awsRegion" - ], - "members":{ - "tableName":{ - "shape":"String", - "documentation":"

The table name.

" - }, - "awsRegion":{ - "shape":"String", - "documentation":"

The AWS region.

" - }, - "useCallerCredentials":{ - "shape":"Boolean", - "documentation":"

Set to TRUE to use Amazon Cognito credentials with this data source.

" - } - }, - "documentation":"

Describes a DynamoDB data source configuration.

" - }, - "ElasticsearchDataSourceConfig":{ - "type":"structure", - "required":[ - "endpoint", - "awsRegion" - ], - "members":{ - "endpoint":{ - "shape":"String", - "documentation":"

The endpoint.

" - }, - "awsRegion":{ - "shape":"String", - "documentation":"

The AWS region.

" - } - }, - "documentation":"

Describes an Elasticsearch data source configuration.

" - }, - "ErrorMessage":{"type":"string"}, - "FieldLogLevel":{ - "type":"string", - "enum":[ - "NONE", - "ERROR", - "ALL" - ] - }, - "GetDataSourceRequest":{ - "type":"structure", - "required":[ - "apiId", - "name" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the data source.

", - "location":"uri", - "locationName":"name" - } - } - }, - "GetDataSourceResponse":{ - "type":"structure", - "members":{ - "dataSource":{ - "shape":"DataSource", - "documentation":"

The DataSource object.

" - } - } - }, - "GetGraphqlApiRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID for the GraphQL API.

", - "location":"uri", - "locationName":"apiId" - } - } - }, - "GetGraphqlApiResponse":{ - "type":"structure", - "members":{ - "graphqlApi":{ - "shape":"GraphqlApi", - "documentation":"

The GraphqlApi object.

" - } - } - }, - "GetIntrospectionSchemaRequest":{ - "type":"structure", - "required":[ - "apiId", - "format" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "format":{ - "shape":"OutputType", - "documentation":"

The schema format: SDL or JSON.

", - "location":"querystring", - "locationName":"format" - } - } - }, - "GetIntrospectionSchemaResponse":{ - "type":"structure", - "members":{ - "schema":{ - "shape":"Blob", - "documentation":"

The schema, in GraphQL Schema Definition Language (SDL) format.

For more information, see the GraphQL SDL documentation.

" - } - }, - "payload":"schema" - }, - "GetResolverRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "fieldName" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The resolver type name.

", - "location":"uri", - "locationName":"typeName" - }, - "fieldName":{ - "shape":"ResourceName", - "documentation":"

The resolver field name.

", - "location":"uri", - "locationName":"fieldName" - } - } - }, - "GetResolverResponse":{ - "type":"structure", - "members":{ - "resolver":{ - "shape":"Resolver", - "documentation":"

The Resolver object.

" - } - } - }, - "GetSchemaCreationStatusRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - } - } - }, - "GetSchemaCreationStatusResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"SchemaStatus", - "documentation":"

The current state of the schema (PROCESSING, ACTIVE, or DELETING). Once the schema is in the ACTIVE state, you can add data.

" - }, - "details":{ - "shape":"String", - "documentation":"

Detailed information about the status of the schema creation operation.

" - } - } - }, - "GetTypeRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "format" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The type name.

", - "location":"uri", - "locationName":"typeName" - }, - "format":{ - "shape":"TypeDefinitionFormat", - "documentation":"

The type format: SDL or JSON.

", - "location":"querystring", - "locationName":"format" - } - } - }, - "GetTypeResponse":{ - "type":"structure", - "members":{ - "type":{ - "shape":"Type", - "documentation":"

The Type object.

" - } - } - }, - "GraphQLSchemaException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The GraphQL schema is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "GraphqlApi":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The API name.

" - }, - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

" - }, - "authenticationType":{ - "shape":"AuthenticationType", - "documentation":"

The authentication type.

" - }, - "logConfig":{ - "shape":"LogConfig", - "documentation":"

The Amazon CloudWatch Logs configuration.

" - }, - "userPoolConfig":{ - "shape":"UserPoolConfig", - "documentation":"

The Amazon Cognito User Pool configuration.

" - }, - "openIDConnectConfig":{ - "shape":"OpenIDConnectConfig", - "documentation":"

The Open Id Connect configuration.

" - }, - "arn":{ - "shape":"String", - "documentation":"

The ARN.

" - }, - "uris":{ - "shape":"MapOfStringToString", - "documentation":"

The URIs.

" - } - }, - "documentation":"

Describes a GraphQL API.

" - }, - "GraphqlApis":{ - "type":"list", - "member":{"shape":"GraphqlApi"} - }, - "HttpDataSourceConfig":{ - "type":"structure", - "members":{ - "endpoint":{ - "shape":"String", - "documentation":"

The Http url endpoint. You can either specify the domain name or ip and port combination and the url scheme must be http(s). If the port is not specified, AWS AppSync will use the default port 80 for http endpoint and port 443 for https endpoints.

" - } - }, - "documentation":"

Describes a Http data source configuration.

" - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

An internal AWS AppSync error occurred. Try your request again.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "LambdaDataSourceConfig":{ - "type":"structure", - "required":["lambdaFunctionArn"], - "members":{ - "lambdaFunctionArn":{ - "shape":"String", - "documentation":"

The ARN for the Lambda function.

" - } - }, - "documentation":"

Describes a Lambda data source configuration.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request exceeded a limit. Try your request again.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListApiKeysRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results you want the request to return.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListApiKeysResponse":{ - "type":"structure", - "members":{ - "apiKeys":{ - "shape":"ApiKeys", - "documentation":"

The ApiKey objects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be passed in the next request to this operation to return the next set of items in the list.

" - } - } - }, - "ListDataSourcesRequest":{ - "type":"structure", - "required":["apiId"], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results you want the request to return.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListDataSourcesResponse":{ - "type":"structure", - "members":{ - "dataSources":{ - "shape":"DataSources", - "documentation":"

The DataSource objects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be passed in the next request to this operation to return the next set of items in the list.

" - } - } - }, - "ListGraphqlApisRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results you want the request to return.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListGraphqlApisResponse":{ - "type":"structure", - "members":{ - "graphqlApis":{ - "shape":"GraphqlApis", - "documentation":"

The GraphqlApi objects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be passed in the next request to this operation to return the next set of items in the list.

" - } - } - }, - "ListResolversRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"String", - "documentation":"

The type name.

", - "location":"uri", - "locationName":"typeName" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results you want the request to return.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListResolversResponse":{ - "type":"structure", - "members":{ - "resolvers":{ - "shape":"Resolvers", - "documentation":"

The Resolver objects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be passed in the next request to this operation to return the next set of items in the list.

" - } - } - }, - "ListTypesRequest":{ - "type":"structure", - "required":[ - "apiId", - "format" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "format":{ - "shape":"TypeDefinitionFormat", - "documentation":"

The type format: SDL or JSON.

", - "location":"querystring", - "locationName":"format" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results you want the request to return.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListTypesResponse":{ - "type":"structure", - "members":{ - "types":{ - "shape":"TypeList", - "documentation":"

The Type objects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be passed in the next request to this operation to return the next set of items in the list.

" - } - } - }, - "LogConfig":{ - "type":"structure", - "required":[ - "fieldLogLevel", - "cloudWatchLogsRoleArn" - ], - "members":{ - "fieldLogLevel":{ - "shape":"FieldLogLevel", - "documentation":"

The field logging level. Values can be NONE, ERROR, ALL.

  • NONE: No field-level logs are captured.

  • ERROR: Logs the following information only for the fields that are in error:

    • The error section in the server response.

    • Field-level errors.

    • The generated request/response functions that got resolved for error fields.

  • ALL: The following information is logged for all fields in the query:

    • Field-level tracing information.

    • The generated request/response functions that got resolved for each field.

" - }, - "cloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

The service role that AWS AppSync will assume to publish to Amazon CloudWatch logs in your account.

" - } - }, - "documentation":"

The CloudWatch Logs configuration.

" - }, - "Long":{"type":"long"}, - "MapOfStringToString":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "MappingTemplate":{ - "type":"string", - "max":65536, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":25, - "min":0 - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The resource specified in the request was not found. Check the resource and try again.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "OpenIDConnectConfig":{ - "type":"structure", - "required":["issuer"], - "members":{ - "issuer":{ - "shape":"String", - "documentation":"

The issuer for the open id connect configuration. The issuer returned by discovery MUST exactly match the value of iss in the ID Token.

" - }, - "clientId":{ - "shape":"String", - "documentation":"

The client identifier of the Relying party at the OpenID Provider. This identifier is typically obtained when the Relying party is registered with the OpenID Provider. You can specify a regular expression so the AWS AppSync can validate against multiple client identifiers at a time

" - }, - "iatTTL":{ - "shape":"Long", - "documentation":"

The number of milliseconds a token is valid after being issued to a user.

" - }, - "authTTL":{ - "shape":"Long", - "documentation":"

The number of milliseconds a token is valid after being authenticated.

" - } - }, - "documentation":"

Describes an Open Id Connect configuration.

" - }, - "OutputType":{ - "type":"string", - "enum":[ - "SDL", - "JSON" - ] - }, - "PaginationToken":{ - "type":"string", - "pattern":"[\\\\S]+" - }, - "Resolver":{ - "type":"structure", - "members":{ - "typeName":{ - "shape":"ResourceName", - "documentation":"

The resolver type name.

" - }, - "fieldName":{ - "shape":"ResourceName", - "documentation":"

The resolver field name.

" - }, - "dataSourceName":{ - "shape":"ResourceName", - "documentation":"

The resolver data source name.

" - }, - "resolverArn":{ - "shape":"String", - "documentation":"

The resolver ARN.

" - }, - "requestMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The request mapping template.

" - }, - "responseMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The response mapping template.

" - } - }, - "documentation":"

Describes a resolver.

" - }, - "Resolvers":{ - "type":"list", - "member":{"shape":"Resolver"} - }, - "ResourceName":{ - "type":"string", - "pattern":"[_A-Za-z][_0-9A-Za-z]*" - }, - "SchemaStatus":{ - "type":"string", - "enum":[ - "PROCESSING", - "ACTIVE", - "DELETING" - ] - }, - "StartSchemaCreationRequest":{ - "type":"structure", - "required":[ - "apiId", - "definition" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "definition":{ - "shape":"Blob", - "documentation":"

The schema definition, in GraphQL schema language format.

" - } - } - }, - "StartSchemaCreationResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"SchemaStatus", - "documentation":"

The current state of the schema (PROCESSING, ACTIVE, or DELETING). Once the schema is in the ACTIVE state, you can add data.

" - } - } - }, - "String":{"type":"string"}, - "Type":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The type name.

" - }, - "description":{ - "shape":"String", - "documentation":"

The type description.

" - }, - "arn":{ - "shape":"String", - "documentation":"

The type ARN.

" - }, - "definition":{ - "shape":"String", - "documentation":"

The type definition.

" - }, - "format":{ - "shape":"TypeDefinitionFormat", - "documentation":"

The type format: SDL or JSON.

" - } - }, - "documentation":"

Describes a type.

" - }, - "TypeDefinitionFormat":{ - "type":"string", - "enum":[ - "SDL", - "JSON" - ] - }, - "TypeList":{ - "type":"list", - "member":{"shape":"Type"} - }, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

You are not authorized to perform this operation.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UpdateApiKeyRequest":{ - "type":"structure", - "required":[ - "apiId", - "id" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The ID for the GraphQL API

", - "location":"uri", - "locationName":"apiId" - }, - "id":{ - "shape":"String", - "documentation":"

The API key ID.

", - "location":"uri", - "locationName":"id" - }, - "description":{ - "shape":"String", - "documentation":"

A description of the purpose of the API key.

" - }, - "expires":{ - "shape":"Long", - "documentation":"

The time from update time after which the API key expires. The date is represented as seconds since the epoch. For more information, see .

" - } - } - }, - "UpdateApiKeyResponse":{ - "type":"structure", - "members":{ - "apiKey":{ - "shape":"ApiKey", - "documentation":"

The API key.

" - } - } - }, - "UpdateDataSourceRequest":{ - "type":"structure", - "required":[ - "apiId", - "name", - "type" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

The new name for the data source.

", - "location":"uri", - "locationName":"name" - }, - "description":{ - "shape":"String", - "documentation":"

The new description for the data source.

" - }, - "type":{ - "shape":"DataSourceType", - "documentation":"

The new data source type.

" - }, - "serviceRoleArn":{ - "shape":"String", - "documentation":"

The new service role ARN for the data source.

" - }, - "dynamodbConfig":{ - "shape":"DynamodbDataSourceConfig", - "documentation":"

The new DynamoDB configuration.

" - }, - "lambdaConfig":{ - "shape":"LambdaDataSourceConfig", - "documentation":"

The new Lambda configuration.

" - }, - "elasticsearchConfig":{ - "shape":"ElasticsearchDataSourceConfig", - "documentation":"

The new Elasticsearch configuration.

" - }, - "httpConfig":{ - "shape":"HttpDataSourceConfig", - "documentation":"

The new http endpoint configuration

" - } - } - }, - "UpdateDataSourceResponse":{ - "type":"structure", - "members":{ - "dataSource":{ - "shape":"DataSource", - "documentation":"

The updated DataSource object.

" - } - } - }, - "UpdateGraphqlApiRequest":{ - "type":"structure", - "required":[ - "apiId", - "name" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "name":{ - "shape":"String", - "documentation":"

The new name for the GraphqlApi object.

" - }, - "logConfig":{ - "shape":"LogConfig", - "documentation":"

The Amazon CloudWatch logs configuration for the GraphqlApi object.

" - }, - "authenticationType":{ - "shape":"AuthenticationType", - "documentation":"

The new authentication type for the GraphqlApi object.

" - }, - "userPoolConfig":{ - "shape":"UserPoolConfig", - "documentation":"

The new Amazon Cognito User Pool configuration for the GraphqlApi object.

" - }, - "openIDConnectConfig":{ - "shape":"OpenIDConnectConfig", - "documentation":"

The Open Id Connect configuration configuration for the GraphqlApi object.

" - } - } - }, - "UpdateGraphqlApiResponse":{ - "type":"structure", - "members":{ - "graphqlApi":{ - "shape":"GraphqlApi", - "documentation":"

The updated GraphqlApi object.

" - } - } - }, - "UpdateResolverRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "fieldName", - "dataSourceName", - "requestMappingTemplate" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The new type name.

", - "location":"uri", - "locationName":"typeName" - }, - "fieldName":{ - "shape":"ResourceName", - "documentation":"

The new field name.

", - "location":"uri", - "locationName":"fieldName" - }, - "dataSourceName":{ - "shape":"ResourceName", - "documentation":"

The new data source name.

" - }, - "requestMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The new request mapping template.

" - }, - "responseMappingTemplate":{ - "shape":"MappingTemplate", - "documentation":"

The new response mapping template.

" - } - } - }, - "UpdateResolverResponse":{ - "type":"structure", - "members":{ - "resolver":{ - "shape":"Resolver", - "documentation":"

The updated Resolver object.

" - } - } - }, - "UpdateTypeRequest":{ - "type":"structure", - "required":[ - "apiId", - "typeName", - "format" - ], - "members":{ - "apiId":{ - "shape":"String", - "documentation":"

The API ID.

", - "location":"uri", - "locationName":"apiId" - }, - "typeName":{ - "shape":"ResourceName", - "documentation":"

The new type name.

", - "location":"uri", - "locationName":"typeName" - }, - "definition":{ - "shape":"String", - "documentation":"

The new definition.

" - }, - "format":{ - "shape":"TypeDefinitionFormat", - "documentation":"

The new type format: SDL or JSON.

" - } - } - }, - "UpdateTypeResponse":{ - "type":"structure", - "members":{ - "type":{ - "shape":"Type", - "documentation":"

The updated Type object.

" - } - } - }, - "UserPoolConfig":{ - "type":"structure", - "required":[ - "userPoolId", - "awsRegion", - "defaultAction" - ], - "members":{ - "userPoolId":{ - "shape":"String", - "documentation":"

The user pool ID.

" - }, - "awsRegion":{ - "shape":"String", - "documentation":"

The AWS region in which the user pool was created.

" - }, - "defaultAction":{ - "shape":"DefaultAction", - "documentation":"

The action that you want your GraphQL API to take when a request that uses Amazon Cognito User Pool authentication doesn't match the Amazon Cognito User Pool configuration.

" - }, - "appIdClientRegex":{ - "shape":"String", - "documentation":"

A regular expression for validating the incoming Amazon Cognito User Pool app client ID.

" - } - }, - "documentation":"

Describes an Amazon Cognito User Pool configuration.

" - } - }, - "documentation":"

AWS AppSync provides API actions for creating and interacting with data sources using GraphQL from your application.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/paginators-1.json deleted file mode 100644 index 8cefb4a0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/paginators-1.json +++ /dev/null @@ -1,23 +0,0 @@ -{ - "pagination": { - "ListNamedQueries": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "NamedQueryIds" - }, - "ListQueryExecutions": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "QueryExecutionIds" - }, - "GetQueryResults": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ResultSet.Rows", - "non_aggregate_keys": ["ResultSet.ResultSetMetadata"] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/service-2.json deleted file mode 100644 index c2c5e79e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/athena/2017-05-18/service-2.json +++ /dev/null @@ -1,874 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-05-18", - "endpointPrefix":"athena", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Athena", - "serviceId":"Athena", - "signatureVersion":"v4", - "targetPrefix":"AmazonAthena", - "uid":"athena-2017-05-18" - }, - "operations":{ - "BatchGetNamedQuery":{ - "name":"BatchGetNamedQuery", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetNamedQueryInput"}, - "output":{"shape":"BatchGetNamedQueryOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Returns the details of a single named query or a list of up to 50 queries, which you provide as an array of query ID strings. Use ListNamedQueries to get the list of named query IDs. If information could not be retrieved for a submitted query ID, information about the query ID submitted is listed under UnprocessedNamedQueryId. Named queries are different from executed queries. Use BatchGetQueryExecution to get details about each unique query execution, and ListQueryExecutions to get a list of query execution IDs.

" - }, - "BatchGetQueryExecution":{ - "name":"BatchGetQueryExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetQueryExecutionInput"}, - "output":{"shape":"BatchGetQueryExecutionOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Returns the details of a single query execution or a list of up to 50 query executions, which you provide as an array of query execution ID strings. To get a list of query execution IDs, use ListQueryExecutions. Query executions are different from named (saved) queries. Use BatchGetNamedQuery to get details about named queries.

" - }, - "CreateNamedQuery":{ - "name":"CreateNamedQuery", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNamedQueryInput"}, - "output":{"shape":"CreateNamedQueryOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Creates a named query.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", - "idempotent":true - }, - "DeleteNamedQuery":{ - "name":"DeleteNamedQuery", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNamedQueryInput"}, - "output":{"shape":"DeleteNamedQueryOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Deletes a named query.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", - "idempotent":true - }, - "GetNamedQuery":{ - "name":"GetNamedQuery", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetNamedQueryInput"}, - "output":{"shape":"GetNamedQueryOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Returns information about a single query.

" - }, - "GetQueryExecution":{ - "name":"GetQueryExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQueryExecutionInput"}, - "output":{"shape":"GetQueryExecutionOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Returns information about a single execution of a query. Each time a query executes, information about the query execution is saved with a unique ID.

" - }, - "GetQueryResults":{ - "name":"GetQueryResults", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQueryResultsInput"}, - "output":{"shape":"GetQueryResultsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Returns the results of a single query execution specified by QueryExecutionId. This request does not execute the query but returns results. Use StartQueryExecution to run a query.

" - }, - "ListNamedQueries":{ - "name":"ListNamedQueries", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListNamedQueriesInput"}, - "output":{"shape":"ListNamedQueriesOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides a list of all available query IDs.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

" - }, - "ListQueryExecutions":{ - "name":"ListQueryExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListQueryExecutionsInput"}, - "output":{"shape":"ListQueryExecutionsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides a list of all available query execution IDs.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

" - }, - "StartQueryExecution":{ - "name":"StartQueryExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartQueryExecutionInput"}, - "output":{"shape":"StartQueryExecutionOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Runs (executes) the SQL query statements contained in the Query string.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", - "idempotent":true - }, - "StopQueryExecution":{ - "name":"StopQueryExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopQueryExecutionInput"}, - "output":{"shape":"StopQueryExecutionOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Stops a query execution.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", - "idempotent":true - } - }, - "shapes":{ - "BatchGetNamedQueryInput":{ - "type":"structure", - "required":["NamedQueryIds"], - "members":{ - "NamedQueryIds":{ - "shape":"NamedQueryIdList", - "documentation":"

An array of query IDs.

" - } - } - }, - "BatchGetNamedQueryOutput":{ - "type":"structure", - "members":{ - "NamedQueries":{ - "shape":"NamedQueryList", - "documentation":"

Information about the named query IDs submitted.

" - }, - "UnprocessedNamedQueryIds":{ - "shape":"UnprocessedNamedQueryIdList", - "documentation":"

Information about provided query IDs.

" - } - } - }, - "BatchGetQueryExecutionInput":{ - "type":"structure", - "required":["QueryExecutionIds"], - "members":{ - "QueryExecutionIds":{ - "shape":"QueryExecutionIdList", - "documentation":"

An array of query execution IDs.

" - } - } - }, - "BatchGetQueryExecutionOutput":{ - "type":"structure", - "members":{ - "QueryExecutions":{ - "shape":"QueryExecutionList", - "documentation":"

Information about a query execution.

" - }, - "UnprocessedQueryExecutionIds":{ - "shape":"UnprocessedQueryExecutionIdList", - "documentation":"

Information about the query executions that failed to run.

" - } - } - }, - "Boolean":{"type":"boolean"}, - "ColumnInfo":{ - "type":"structure", - "required":[ - "Name", - "Type" - ], - "members":{ - "CatalogName":{ - "shape":"String", - "documentation":"

The catalog to which the query results belong.

" - }, - "SchemaName":{ - "shape":"String", - "documentation":"

The schema name (database name) to which the query results belong.

" - }, - "TableName":{ - "shape":"String", - "documentation":"

The table name for the query results.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the column.

" - }, - "Label":{ - "shape":"String", - "documentation":"

A column label.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The data type of the column.

" - }, - "Precision":{ - "shape":"Integer", - "documentation":"

For DECIMAL data types, specifies the total number of digits, up to 38. For performance reasons, we recommend up to 18 digits.

" - }, - "Scale":{ - "shape":"Integer", - "documentation":"

For DECIMAL data types, specifies the total number of digits in the fractional part of the value. Defaults to 0.

" - }, - "Nullable":{ - "shape":"ColumnNullable", - "documentation":"

Indicates the column's nullable status.

" - }, - "CaseSensitive":{ - "shape":"Boolean", - "documentation":"

Indicates whether values in the column are case-sensitive.

" - } - }, - "documentation":"

Information about the columns in a query execution result.

" - }, - "ColumnInfoList":{ - "type":"list", - "member":{"shape":"ColumnInfo"} - }, - "ColumnNullable":{ - "type":"string", - "enum":[ - "NOT_NULL", - "NULLABLE", - "UNKNOWN" - ] - }, - "CreateNamedQueryInput":{ - "type":"structure", - "required":[ - "Name", - "Database", - "QueryString" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The plain language name for the query.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A brief explanation of the query.

" - }, - "Database":{ - "shape":"DatabaseString", - "documentation":"

The database to which the query belongs.

" - }, - "QueryString":{ - "shape":"QueryString", - "documentation":"

The text of the query itself. In other words, all query statements.

" - }, - "ClientRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another CreateNamedQuery request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the QueryString, an error is returned.

This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.

", - "idempotencyToken":true - } - } - }, - "CreateNamedQueryOutput":{ - "type":"structure", - "members":{ - "NamedQueryId":{ - "shape":"NamedQueryId", - "documentation":"

The unique ID of the query.

" - } - } - }, - "DatabaseString":{ - "type":"string", - "max":32, - "min":1 - }, - "Date":{"type":"timestamp"}, - "Datum":{ - "type":"structure", - "members":{ - "VarCharValue":{ - "shape":"datumString", - "documentation":"

The value of the datum.

" - } - }, - "documentation":"

A piece of data (a field in the table).

" - }, - "DeleteNamedQueryInput":{ - "type":"structure", - "required":["NamedQueryId"], - "members":{ - "NamedQueryId":{ - "shape":"NamedQueryId", - "documentation":"

The unique ID of the query to delete.

", - "idempotencyToken":true - } - } - }, - "DeleteNamedQueryOutput":{ - "type":"structure", - "members":{ - } - }, - "DescriptionString":{ - "type":"string", - "max":1024, - "min":1 - }, - "EncryptionConfiguration":{ - "type":"structure", - "required":["EncryptionOption"], - "members":{ - "EncryptionOption":{ - "shape":"EncryptionOption", - "documentation":"

Indicates whether Amazon S3 server-side encryption with Amazon S3-managed keys (SSE-S3), server-side encryption with KMS-managed keys (SSE-KMS), or client-side encryption with KMS-managed keys (CSE-KMS) is used.

" - }, - "KmsKey":{ - "shape":"String", - "documentation":"

For SSE-KMS and CSE-KMS, this is the KMS key ARN or ID.

" - } - }, - "documentation":"

If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption option used.

" - }, - "EncryptionOption":{ - "type":"string", - "enum":[ - "SSE_S3", - "SSE_KMS", - "CSE_KMS" - ] - }, - "ErrorCode":{ - "type":"string", - "max":256, - "min":1 - }, - "ErrorMessage":{"type":"string"}, - "GetNamedQueryInput":{ - "type":"structure", - "required":["NamedQueryId"], - "members":{ - "NamedQueryId":{ - "shape":"NamedQueryId", - "documentation":"

The unique ID of the query. Use ListNamedQueries to get query IDs.

" - } - } - }, - "GetNamedQueryOutput":{ - "type":"structure", - "members":{ - "NamedQuery":{ - "shape":"NamedQuery", - "documentation":"

Information about the query.

" - } - } - }, - "GetQueryExecutionInput":{ - "type":"structure", - "required":["QueryExecutionId"], - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique ID of the query execution.

" - } - } - }, - "GetQueryExecutionOutput":{ - "type":"structure", - "members":{ - "QueryExecution":{ - "shape":"QueryExecution", - "documentation":"

Information about the query execution.

" - } - } - }, - "GetQueryResultsInput":{ - "type":"structure", - "required":["QueryExecutionId"], - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique ID of the query execution.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

The token that specifies where to start pagination if a previous request was truncated.

" - }, - "MaxResults":{ - "shape":"MaxQueryResults", - "documentation":"

The maximum number of results (rows) to return in this request.

" - } - } - }, - "GetQueryResultsOutput":{ - "type":"structure", - "members":{ - "ResultSet":{ - "shape":"ResultSet", - "documentation":"

The results of the query execution.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A token to be used by the next request if this request is truncated.

" - } - } - }, - "IdempotencyToken":{ - "type":"string", - "max":128, - "min":32 - }, - "Integer":{"type":"integer"}, - "InternalServerException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Indicates a platform issue, which may be due to a transient condition or outage.

", - "exception":true, - "fault":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "AthenaErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Indicates that something is wrong with the input to the request. For example, a required parameter may be missing or out of range.

", - "exception":true - }, - "ListNamedQueriesInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

The token that specifies where to start pagination if a previous request was truncated.

" - }, - "MaxResults":{ - "shape":"MaxNamedQueriesCount", - "documentation":"

The maximum number of queries to return in this request.

" - } - } - }, - "ListNamedQueriesOutput":{ - "type":"structure", - "members":{ - "NamedQueryIds":{ - "shape":"NamedQueryIdList", - "documentation":"

The list of unique query IDs.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A token to be used by the next request if this request is truncated.

" - } - } - }, - "ListQueryExecutionsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

The token that specifies where to start pagination if a previous request was truncated.

" - }, - "MaxResults":{ - "shape":"MaxQueryExecutionsCount", - "documentation":"

The maximum number of query executions to return in this request.

" - } - } - }, - "ListQueryExecutionsOutput":{ - "type":"structure", - "members":{ - "QueryExecutionIds":{ - "shape":"QueryExecutionIdList", - "documentation":"

The unique IDs of each query execution as an array of strings.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A token to be used by the next request if this request is truncated.

" - } - } - }, - "Long":{"type":"long"}, - "MaxNamedQueriesCount":{ - "type":"integer", - "box":true, - "max":50, - "min":0 - }, - "MaxQueryExecutionsCount":{ - "type":"integer", - "box":true, - "max":50, - "min":0 - }, - "MaxQueryResults":{ - "type":"integer", - "box":true, - "max":1000, - "min":0 - }, - "NameString":{ - "type":"string", - "max":128, - "min":1 - }, - "NamedQuery":{ - "type":"structure", - "required":[ - "Name", - "Database", - "QueryString" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The plain-language name of the query.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A brief description of the query.

" - }, - "Database":{ - "shape":"DatabaseString", - "documentation":"

The database to which the query belongs.

" - }, - "QueryString":{ - "shape":"QueryString", - "documentation":"

The SQL query statements that comprise the query.

" - }, - "NamedQueryId":{ - "shape":"NamedQueryId", - "documentation":"

The unique identifier of the query.

" - } - }, - "documentation":"

A query, where QueryString is the SQL query statements that comprise the query.

" - }, - "NamedQueryId":{"type":"string"}, - "NamedQueryIdList":{ - "type":"list", - "member":{"shape":"NamedQueryId"}, - "max":50, - "min":1 - }, - "NamedQueryList":{ - "type":"list", - "member":{"shape":"NamedQuery"} - }, - "QueryExecution":{ - "type":"structure", - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique identifier for each query execution.

" - }, - "Query":{ - "shape":"QueryString", - "documentation":"

The SQL query statements which the query execution ran.

" - }, - "ResultConfiguration":{ - "shape":"ResultConfiguration", - "documentation":"

The location in Amazon S3 where query results were stored and the encryption option, if any, used for query results.

" - }, - "QueryExecutionContext":{ - "shape":"QueryExecutionContext", - "documentation":"

The database in which the query execution occurred.

" - }, - "Status":{ - "shape":"QueryExecutionStatus", - "documentation":"

The completion date, current state, submission time, and state change reason (if applicable) for the query execution.

" - }, - "Statistics":{ - "shape":"QueryExecutionStatistics", - "documentation":"

The amount of data scanned during the query execution and the amount of time that it took to execute.

" - } - }, - "documentation":"

Information about a single instance of a query execution.

" - }, - "QueryExecutionContext":{ - "type":"structure", - "members":{ - "Database":{ - "shape":"DatabaseString", - "documentation":"

The name of the database.

" - } - }, - "documentation":"

The database in which the query execution occurs.

" - }, - "QueryExecutionId":{"type":"string"}, - "QueryExecutionIdList":{ - "type":"list", - "member":{"shape":"QueryExecutionId"}, - "max":50, - "min":1 - }, - "QueryExecutionList":{ - "type":"list", - "member":{"shape":"QueryExecution"} - }, - "QueryExecutionState":{ - "type":"string", - "enum":[ - "QUEUED", - "RUNNING", - "SUCCEEDED", - "FAILED", - "CANCELLED" - ] - }, - "QueryExecutionStatistics":{ - "type":"structure", - "members":{ - "EngineExecutionTimeInMillis":{ - "shape":"Long", - "documentation":"

The number of milliseconds that the query took to execute.

" - }, - "DataScannedInBytes":{ - "shape":"Long", - "documentation":"

The number of bytes in the data that was queried.

" - } - }, - "documentation":"

The amount of data scanned during the query execution and the amount of time that it took to execute.

" - }, - "QueryExecutionStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"QueryExecutionState", - "documentation":"

The state of query execution. SUBMITTED indicates that the query is queued for execution. RUNNING indicates that the query is scanning data and returning results. SUCCEEDED indicates that the query completed without error. FAILED indicates that the query experienced an error and did not complete processing. CANCELLED indicates that user input interrupted query execution.

" - }, - "StateChangeReason":{ - "shape":"String", - "documentation":"

Further detail about the status of the query.

" - }, - "SubmissionDateTime":{ - "shape":"Date", - "documentation":"

The date and time that the query was submitted.

" - }, - "CompletionDateTime":{ - "shape":"Date", - "documentation":"

The date and time that the query completed.

" - } - }, - "documentation":"

The completion date, current state, submission time, and state change reason (if applicable) for the query execution.

" - }, - "QueryString":{ - "type":"string", - "max":262144, - "min":1 - }, - "ResultConfiguration":{ - "type":"structure", - "required":["OutputLocation"], - "members":{ - "OutputLocation":{ - "shape":"String", - "documentation":"

The location in S3 where query results are stored.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

If query results are encrypted in S3, indicates the S3 encryption option used (for example, SSE-KMS or CSE-KMS and key information.

" - } - }, - "documentation":"

The location in Amazon S3 where query results are stored and the encryption option, if any, used for query results.

" - }, - "ResultSet":{ - "type":"structure", - "members":{ - "Rows":{ - "shape":"RowList", - "documentation":"

The rows in the table.

" - }, - "ResultSetMetadata":{ - "shape":"ResultSetMetadata", - "documentation":"

The metadata that describes the column structure and data types of a table of query results.

" - } - }, - "documentation":"

The metadata and rows that comprise a query result set. The metadata describes the column structure and data types.

" - }, - "ResultSetMetadata":{ - "type":"structure", - "members":{ - "ColumnInfo":{ - "shape":"ColumnInfoList", - "documentation":"

Information about the columns in a query execution result.

" - } - }, - "documentation":"

The metadata that describes the column structure and data types of a table of query results.

" - }, - "Row":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"datumList", - "documentation":"

The data that populates a row in a query result table.

" - } - }, - "documentation":"

The rows that comprise a query result table.

" - }, - "RowList":{ - "type":"list", - "member":{"shape":"Row"} - }, - "StartQueryExecutionInput":{ - "type":"structure", - "required":[ - "QueryString", - "ResultConfiguration" - ], - "members":{ - "QueryString":{ - "shape":"QueryString", - "documentation":"

The SQL query statements to be executed.

" - }, - "ClientRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another StartQueryExecution request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the QueryString, an error is returned.

This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.

", - "idempotencyToken":true - }, - "QueryExecutionContext":{ - "shape":"QueryExecutionContext", - "documentation":"

The database within which the query executes.

" - }, - "ResultConfiguration":{ - "shape":"ResultConfiguration", - "documentation":"

Specifies information about where and how to save the results of the query execution.

" - } - } - }, - "StartQueryExecutionOutput":{ - "type":"structure", - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique ID of the query that ran as a result of this request.

" - } - } - }, - "StopQueryExecutionInput":{ - "type":"structure", - "required":["QueryExecutionId"], - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique ID of the query execution to stop.

", - "idempotencyToken":true - } - } - }, - "StopQueryExecutionOutput":{ - "type":"structure", - "members":{ - } - }, - "String":{"type":"string"}, - "ThrottleReason":{ - "type":"string", - "enum":["CONCURRENT_QUERY_LIMIT_EXCEEDED"] - }, - "Token":{"type":"string"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "Reason":{"shape":"ThrottleReason"} - }, - "documentation":"

Indicates that the request was throttled.

", - "exception":true - }, - "UnprocessedNamedQueryId":{ - "type":"structure", - "members":{ - "NamedQueryId":{ - "shape":"NamedQueryId", - "documentation":"

The unique identifier of the named query.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code returned when the processing request for the named query failed, if applicable.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message returned when the processing request for the named query failed, if applicable.

" - } - }, - "documentation":"

Information about a named query ID that could not be processed.

" - }, - "UnprocessedNamedQueryIdList":{ - "type":"list", - "member":{"shape":"UnprocessedNamedQueryId"} - }, - "UnprocessedQueryExecutionId":{ - "type":"structure", - "members":{ - "QueryExecutionId":{ - "shape":"QueryExecutionId", - "documentation":"

The unique identifier of the query execution.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code returned when the query execution failed to process, if applicable.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message returned when the query execution failed to process, if applicable.

" - } - }, - "documentation":"

Describes a query execution that failed to process.

" - }, - "UnprocessedQueryExecutionIdList":{ - "type":"list", - "member":{"shape":"UnprocessedQueryExecutionId"} - }, - "datumList":{ - "type":"list", - "member":{"shape":"Datum"} - }, - "datumString":{"type":"string"} - }, - "documentation":"

Amazon Athena is an interactive query service that lets you use standard SQL to analyze data directly in Amazon S3. You can point Athena at your data in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is serverless, so there is no infrastructure to set up or manage. You pay only for the queries you run. Athena scales automatically—executing queries in parallel—so results are fast, even with large datasets and complex queries. For more information, see What is Amazon Athena in the Amazon Athena User Guide.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/service-2.json deleted file mode 100644 index 89a34b27..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling-plans/2018-01-06/service-2.json +++ /dev/null @@ -1,755 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2018-01-06", - "endpointPrefix":"autoscaling", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Auto Scaling Plans", - "serviceId":"Auto Scaling Plans", - "signatureVersion":"v4", - "signingName":"autoscaling-plans", - "targetPrefix":"AnyScaleScalingPlannerFrontendService", - "uid":"autoscaling-plans-2018-01-06" - }, - "operations":{ - "CreateScalingPlan":{ - "name":"CreateScalingPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateScalingPlanRequest"}, - "output":{"shape":"CreateScalingPlanResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Creates a scaling plan.

A scaling plan contains a set of instructions used to configure dynamic scaling for the scalable resources in your application. AWS Auto Scaling creates target tracking scaling policies based on the scaling instructions in your scaling plan.

" - }, - "DeleteScalingPlan":{ - "name":"DeleteScalingPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteScalingPlanRequest"}, - "output":{"shape":"DeleteScalingPlanResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deletes the specified scaling plan.

" - }, - "DescribeScalingPlanResources":{ - "name":"DescribeScalingPlanResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingPlanResourcesRequest"}, - "output":{"shape":"DescribeScalingPlanResourcesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Describes the scalable resources in the specified scaling plan.

" - }, - "DescribeScalingPlans":{ - "name":"DescribeScalingPlans", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingPlansRequest"}, - "output":{"shape":"DescribeScalingPlansResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Describes the specified scaling plans or all of your scaling plans.

" - }, - "UpdateScalingPlan":{ - "name":"UpdateScalingPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateScalingPlanRequest"}, - "output":{"shape":"UpdateScalingPlanResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ConcurrentUpdateException"}, - {"shape":"InternalServiceException"}, - {"shape":"ObjectNotFoundException"} - ], - "documentation":"

Updates the scaling plan for the specified scaling plan.

You cannot update a scaling plan if it is in the process of being created, updated, or deleted.

" - } - }, - "shapes":{ - "ApplicationSource":{ - "type":"structure", - "members":{ - "CloudFormationStackARN":{ - "shape":"XmlString", - "documentation":"

The Amazon Resource Name (ARN) of a CloudFormation stack.

" - }, - "TagFilters":{ - "shape":"TagFilters", - "documentation":"

A set of tags (up to 50).

" - } - }, - "documentation":"

Represents an application source.

" - }, - "ApplicationSources":{ - "type":"list", - "member":{"shape":"ApplicationSource"} - }, - "ConcurrentUpdateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Concurrent updates caused an exception, for example, if you request an update to a scaling plan that already has a pending update.

", - "exception":true - }, - "Cooldown":{"type":"integer"}, - "CreateScalingPlanRequest":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ApplicationSource", - "ScalingInstructions" - ], - "members":{ - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan. Names cannot contain vertical bars, colons, or forward slashes.

" - }, - "ApplicationSource":{ - "shape":"ApplicationSource", - "documentation":"

A CloudFormation stack or set of tags. You can create one scaling plan per application source.

" - }, - "ScalingInstructions":{ - "shape":"ScalingInstructions", - "documentation":"

The scaling instructions.

" - } - } - }, - "CreateScalingPlanResponse":{ - "type":"structure", - "required":["ScalingPlanVersion"], - "members":{ - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan. This value is always 1.

" - } - } - }, - "CustomizedScalingMetricSpecification":{ - "type":"structure", - "required":[ - "MetricName", - "Namespace", - "Statistic" - ], - "members":{ - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Namespace":{ - "shape":"MetricNamespace", - "documentation":"

The namespace of the metric.

" - }, - "Dimensions":{ - "shape":"MetricDimensions", - "documentation":"

The dimensions of the metric.

" - }, - "Statistic":{ - "shape":"MetricStatistic", - "documentation":"

The statistic of the metric.

" - }, - "Unit":{ - "shape":"MetricUnit", - "documentation":"

The unit of the metric.

" - } - }, - "documentation":"

Represents a customized metric for a target tracking policy.

" - }, - "DeleteScalingPlanRequest":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ScalingPlanVersion" - ], - "members":{ - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan.

" - } - } - }, - "DeleteScalingPlanResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeScalingPlanResourcesRequest":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ScalingPlanVersion" - ], - "members":{ - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scalable resources to return. This value can be between 1 and 50. The default value is 50.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScalingPlanResourcesResponse":{ - "type":"structure", - "members":{ - "ScalingPlanResources":{ - "shape":"ScalingPlanResources", - "documentation":"

Information about the scalable resources.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DescribeScalingPlansRequest":{ - "type":"structure", - "members":{ - "ScalingPlanNames":{ - "shape":"ScalingPlanNames", - "documentation":"

The names of the scaling plans (up to 10). If you specify application sources, you cannot specify scaling plan names.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan. If you specify a scaling plan version, you must also specify a scaling plan name.

" - }, - "ApplicationSources":{ - "shape":"ApplicationSources", - "documentation":"

The sources for the applications (up to 10). If you specify scaling plan names, you cannot specify application sources.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of scalable resources to return. This value can be between 1 and 50. The default value is 50.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

" - } - } - }, - "DescribeScalingPlansResponse":{ - "type":"structure", - "members":{ - "ScalingPlans":{ - "shape":"ScalingPlans", - "documentation":"

Information about the scaling plans.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token required to get the next set of results. This value is null if there are no more results to return.

" - } - } - }, - "DisableScaleIn":{"type":"boolean"}, - "ErrorMessage":{"type":"string"}, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service encountered an internal error.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The token provided is not valid.

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Your account exceeded a limit. This exception is thrown when a per-account resource limit is exceeded.

", - "exception":true - }, - "MaxResults":{"type":"integer"}, - "MetricDimension":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"MetricDimensionName", - "documentation":"

The name of the dimension.

" - }, - "Value":{ - "shape":"MetricDimensionValue", - "documentation":"

The value of the dimension.

" - } - }, - "documentation":"

Represents a dimension for a customized metric.

" - }, - "MetricDimensionName":{"type":"string"}, - "MetricDimensionValue":{"type":"string"}, - "MetricDimensions":{ - "type":"list", - "member":{"shape":"MetricDimension"} - }, - "MetricName":{"type":"string"}, - "MetricNamespace":{"type":"string"}, - "MetricScale":{"type":"double"}, - "MetricStatistic":{ - "type":"string", - "enum":[ - "Average", - "Minimum", - "Maximum", - "SampleCount", - "Sum" - ] - }, - "MetricUnit":{"type":"string"}, - "NextToken":{"type":"string"}, - "ObjectNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified object could not be found.

", - "exception":true - }, - "PolicyName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"\\p{Print}+" - }, - "PolicyType":{ - "type":"string", - "enum":["TargetTrackingScaling"] - }, - "PredefinedScalingMetricSpecification":{ - "type":"structure", - "required":["PredefinedScalingMetricType"], - "members":{ - "PredefinedScalingMetricType":{ - "shape":"ScalingMetricType", - "documentation":"

The metric type. The ALBRequestCountPerTarget metric type applies only to Auto Scaling groups, Sport Fleet requests, and ECS services.

" - }, - "ResourceLabel":{ - "shape":"ResourceLabel", - "documentation":"

Identifies the resource associated with the metric type. You can't specify a resource label unless the metric type is ALBRequestCountPerTarget and there is a target group for an Application Load Balancer attached to the Auto Scaling group, Spot Fleet request, or ECS service.

The format is app/<load-balancer-name>/<load-balancer-id>/targetgroup/<target-group-name>/<target-group-id>, where:

  • app/<load-balancer-name>/<load-balancer-id> is the final portion of the load balancer ARN

  • targetgroup/<target-group-name>/<target-group-id> is the final portion of the target group ARN.

" - } - }, - "documentation":"

Represents a predefined metric for a target tracking policy.

" - }, - "ResourceCapacity":{"type":"integer"}, - "ResourceIdMaxLen1600":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "ResourceLabel":{ - "type":"string", - "max":1023, - "min":1 - }, - "ScalableDimension":{ - "type":"string", - "enum":[ - "autoscaling:autoScalingGroup:DesiredCapacity", - "ecs:service:DesiredCount", - "ec2:spot-fleet-request:TargetCapacity", - "rds:cluster:ReadReplicaCount", - "dynamodb:table:ReadCapacityUnits", - "dynamodb:table:WriteCapacityUnits", - "dynamodb:index:ReadCapacityUnits", - "dynamodb:index:WriteCapacityUnits" - ] - }, - "ScalingInstruction":{ - "type":"structure", - "required":[ - "ServiceNamespace", - "ResourceId", - "ScalableDimension", - "MinCapacity", - "MaxCapacity", - "TargetTrackingConfigurations" - ], - "members":{ - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The ID of the resource. This string consists of the resource type and unique identifier.

  • Auto Scaling group - The resource type is autoScalingGroup and the unique identifier is the name of the Auto Scaling group. Example: autoScalingGroup/my-asg.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension associated with the resource.

  • autoscaling:autoScalingGroup:DesiredCapacity - The desired capacity of an Auto Scaling group.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

" - }, - "MinCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The minimum value to scale to in response to a scale in event.

" - }, - "MaxCapacity":{ - "shape":"ResourceCapacity", - "documentation":"

The maximum value to scale to in response to a scale out event.

" - }, - "TargetTrackingConfigurations":{ - "shape":"TargetTrackingConfigurations", - "documentation":"

The target tracking scaling policies (up to 10).

" - } - }, - "documentation":"

Specifies the scaling configuration for a scalable resource.

" - }, - "ScalingInstructions":{ - "type":"list", - "member":{"shape":"ScalingInstruction"} - }, - "ScalingMetricType":{ - "type":"string", - "enum":[ - "ASGAverageCPUUtilization", - "ASGAverageNetworkIn", - "ASGAverageNetworkOut", - "DynamoDBReadCapacityUtilization", - "DynamoDBWriteCapacityUtilization", - "ECSServiceAverageCPUUtilization", - "ECSServiceAverageMemoryUtilization", - "ALBRequestCountPerTarget", - "RDSReaderAverageCPUUtilization", - "RDSReaderAverageDatabaseConnections", - "EC2SpotFleetRequestAverageCPUUtilization", - "EC2SpotFleetRequestAverageNetworkIn", - "EC2SpotFleetRequestAverageNetworkOut" - ] - }, - "ScalingPlan":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ScalingPlanVersion", - "ApplicationSource", - "ScalingInstructions", - "StatusCode" - ], - "members":{ - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan.

" - }, - "ApplicationSource":{ - "shape":"ApplicationSource", - "documentation":"

The application source.

" - }, - "ScalingInstructions":{ - "shape":"ScalingInstructions", - "documentation":"

The scaling instructions.

" - }, - "StatusCode":{ - "shape":"ScalingPlanStatusCode", - "documentation":"

The status of the scaling plan.

  • Active - The scaling plan is active.

  • ActiveWithProblems - The scaling plan is active, but the scaling configuration for one or more resources could not be applied.

  • CreationInProgress - The scaling plan is being created.

  • CreationFailed - The scaling plan could not be created.

  • DeletionInProgress - The scaling plan is being deleted.

  • DeletionFailed - The scaling plan could not be deleted.

" - }, - "StatusMessage":{ - "shape":"XmlString", - "documentation":"

A simple message about the current status of the scaling plan.

" - }, - "StatusStartTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp when the scaling plan entered the current status.

" - }, - "CreationTime":{ - "shape":"TimestampType", - "documentation":"

The Unix timestamp when the scaling plan was created.

" - } - }, - "documentation":"

Represents a scaling plan.

" - }, - "ScalingPlanName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\p{Print}&&[^|:/]]+" - }, - "ScalingPlanNames":{ - "type":"list", - "member":{"shape":"ScalingPlanName"} - }, - "ScalingPlanResource":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ScalingPlanVersion", - "ServiceNamespace", - "ResourceId", - "ScalableDimension", - "ScalingStatusCode" - ], - "members":{ - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version of the scaling plan.

" - }, - "ServiceNamespace":{ - "shape":"ServiceNamespace", - "documentation":"

The namespace of the AWS service.

" - }, - "ResourceId":{ - "shape":"ResourceIdMaxLen1600", - "documentation":"

The ID of the resource. This string consists of the resource type and unique identifier.

  • Auto Scaling group - The resource type is autoScalingGroup and the unique identifier is the name of the Auto Scaling group. Example: autoScalingGroup/my-asg.

  • ECS service - The resource type is service and the unique identifier is the cluster name and service name. Example: service/default/sample-webapp.

  • Spot fleet request - The resource type is spot-fleet-request and the unique identifier is the Spot fleet request ID. Example: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.

  • DynamoDB table - The resource type is table and the unique identifier is the resource ID. Example: table/my-table.

  • DynamoDB global secondary index - The resource type is index and the unique identifier is the resource ID. Example: table/my-table/index/my-table-index.

  • Aurora DB cluster - The resource type is cluster and the unique identifier is the cluster name. Example: cluster:my-db-cluster.

" - }, - "ScalableDimension":{ - "shape":"ScalableDimension", - "documentation":"

The scalable dimension for the resource.

  • autoscaling:autoScalingGroup:DesiredCapacity - The desired capacity of an Auto Scaling group.

  • ecs:service:DesiredCount - The desired task count of an ECS service.

  • ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot fleet request.

  • dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a DynamoDB table.

  • dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a DynamoDB table.

  • dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a DynamoDB global secondary index.

  • dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a DynamoDB global secondary index.

  • rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB cluster. Available for Aurora MySQL-compatible edition.

" - }, - "ScalingPolicies":{ - "shape":"ScalingPolicies", - "documentation":"

The scaling policies.

" - }, - "ScalingStatusCode":{ - "shape":"ScalingStatusCode", - "documentation":"

The scaling status of the resource.

  • Active - The scaling configuration is active.

  • Inactive - The scaling configuration is not active because the scaling plan is being created or the scaling configuration could not be applied. Check the status message for more information.

  • PartiallyActive - The scaling configuration is partially active because the scaling plan is being created or deleted or the scaling configuration could not be fully applied. Check the status message for more information.

" - }, - "ScalingStatusMessage":{ - "shape":"XmlString", - "documentation":"

A simple message about the current scaling status of the resource.

" - } - }, - "documentation":"

Represents a scalable resource.

" - }, - "ScalingPlanResources":{ - "type":"list", - "member":{"shape":"ScalingPlanResource"} - }, - "ScalingPlanStatusCode":{ - "type":"string", - "enum":[ - "Active", - "ActiveWithProblems", - "CreationInProgress", - "CreationFailed", - "DeletionInProgress", - "DeletionFailed", - "UpdateInProgress", - "UpdateFailed" - ] - }, - "ScalingPlanVersion":{"type":"long"}, - "ScalingPlans":{ - "type":"list", - "member":{"shape":"ScalingPlan"} - }, - "ScalingPolicies":{ - "type":"list", - "member":{"shape":"ScalingPolicy"} - }, - "ScalingPolicy":{ - "type":"structure", - "required":[ - "PolicyName", - "PolicyType" - ], - "members":{ - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the scaling policy.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The type of scaling policy.

" - }, - "TargetTrackingConfiguration":{ - "shape":"TargetTrackingConfiguration", - "documentation":"

The target tracking scaling policy.

" - } - }, - "documentation":"

Represents a scaling policy.

" - }, - "ScalingStatusCode":{ - "type":"string", - "enum":[ - "Inactive", - "PartiallyActive", - "Active" - ] - }, - "ServiceNamespace":{ - "type":"string", - "enum":[ - "autoscaling", - "ecs", - "ec2", - "rds", - "dynamodb" - ] - }, - "TagFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"XmlStringMaxLen128", - "documentation":"

The tag key.

" - }, - "Values":{ - "shape":"TagValues", - "documentation":"

The tag values (0 to 20).

" - } - }, - "documentation":"

Represents a tag.

" - }, - "TagFilters":{ - "type":"list", - "member":{"shape":"TagFilter"} - }, - "TagValues":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - }, - "TargetTrackingConfiguration":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "PredefinedScalingMetricSpecification":{ - "shape":"PredefinedScalingMetricSpecification", - "documentation":"

A predefined metric.

" - }, - "CustomizedScalingMetricSpecification":{ - "shape":"CustomizedScalingMetricSpecification", - "documentation":"

A customized metric.

" - }, - "TargetValue":{ - "shape":"MetricScale", - "documentation":"

The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2).

" - }, - "DisableScaleIn":{ - "shape":"DisableScaleIn", - "documentation":"

Indicates whether scale in by the target tracking policy is disabled. If the value is true, scale in is disabled and the target tracking policy won't remove capacity from the scalable resource. Otherwise, scale in is enabled and the target tracking policy can remove capacity from the scalable resource. The default value is false.

" - }, - "ScaleOutCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scale out activity completes before another scale out activity can start. This value is not used if the scalable resource is an Auto Scaling group.

While the cooldown period is in effect, the capacity that has been added by the previous scale out event that initiated the cooldown is calculated as part of the desired capacity for the next scale out. The intention is to continuously (but not excessively) scale out.

" - }, - "ScaleInCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scale in activity completes before another scale in activity can start. This value is not used if the scalable resource is an Auto Scaling group.

The cooldown period is used to block subsequent scale in requests until it has expired. The intention is to scale in conservatively to protect your application's availability. However, if another alarm triggers a scale out policy during the cooldown period after a scale-in, AWS Auto Scaling scales out your scalable target immediately.

" - }, - "EstimatedInstanceWarmup":{ - "shape":"Cooldown", - "documentation":"

The estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics. This value is used only if the resource is an Auto Scaling group.

" - } - }, - "documentation":"

Represents a target tracking scaling policy.

" - }, - "TargetTrackingConfigurations":{ - "type":"list", - "member":{"shape":"TargetTrackingConfiguration"} - }, - "TimestampType":{"type":"timestamp"}, - "UpdateScalingPlanRequest":{ - "type":"structure", - "required":[ - "ScalingPlanName", - "ScalingPlanVersion" - ], - "members":{ - "ApplicationSource":{ - "shape":"ApplicationSource", - "documentation":"

A CloudFormation stack or set of tags.

" - }, - "ScalingPlanName":{ - "shape":"ScalingPlanName", - "documentation":"

The name of the scaling plan.

" - }, - "ScalingInstructions":{ - "shape":"ScalingInstructions", - "documentation":"

The scaling instructions.

" - }, - "ScalingPlanVersion":{ - "shape":"ScalingPlanVersion", - "documentation":"

The version number.

" - } - } - }, - "UpdateScalingPlanResponse":{ - "type":"structure", - "members":{ - } - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An exception was thrown for a validation issue. Review the parameters provided.

", - "exception":true - }, - "XmlString":{ - "type":"string", - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen128":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen256":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - } - }, - "documentation":"AWS Auto Scaling

Use AWS Auto Scaling to quickly discover all the scalable AWS resources for your application and configure dynamic scaling for your scalable resources.

To get started, create a scaling plan with a set of instructions used to configure dynamic scaling for the scalable resources in your application. AWS Auto Scaling creates target tracking scaling policies for the scalable resources in your scaling plan. Target tracking scaling policies adjust the capacity of your scalable resource as required to maintain resource utilization at the target value that you specified.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/examples-1.json deleted file mode 100644 index 9dcaf88d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/examples-1.json +++ /dev/null @@ -1,1395 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AttachInstances": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified instance to the specified Auto Scaling group.", - "id": "autoscaling-attach-instances-1", - "title": "To attach an instance to an Auto Scaling group" - } - ], - "AttachLoadBalancerTargetGroups": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "TargetGroupARNs": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified target group to the specified Auto Scaling group.", - "id": "autoscaling-attach-load-balancer-target-groups-1", - "title": "To attach a target group to an Auto Scaling group" - } - ], - "AttachLoadBalancers": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LoadBalancerNames": [ - "my-load-balancer" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified load balancer to the specified Auto Scaling group.", - "id": "autoscaling-attach-load-balancers-1", - "title": "To attach a load balancer to an Auto Scaling group" - } - ], - "CompleteLifecycleAction": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LifecycleActionResult": "CONTINUE", - "LifecycleActionToken": "bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635", - "LifecycleHookName": "my-lifecycle-hook" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example notifies Auto Scaling that the specified lifecycle action is complete so that it can finish launching or terminating the instance.", - "id": "autoscaling-complete-lifecycle-action-1", - "title": "To complete the lifecycle action" - } - ], - "CreateAutoScalingGroup": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LaunchConfigurationName": "my-launch-config", - "MaxSize": 3, - "MinSize": 1, - "VPCZoneIdentifier": "subnet-4176792c" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Auto Scaling group.", - "id": "autoscaling-create-auto-scaling-group-1", - "title": "To create an Auto Scaling group" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "AvailabilityZones": [ - "us-west-2c" - ], - "HealthCheckGracePeriod": 120, - "HealthCheckType": "ELB", - "LaunchConfigurationName": "my-launch-config", - "LoadBalancerNames": [ - "my-load-balancer" - ], - "MaxSize": 3, - "MinSize": 1 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.", - "id": "autoscaling-create-auto-scaling-group-2", - "title": "To create an Auto Scaling group with an attached load balancer" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "HealthCheckGracePeriod": 120, - "HealthCheckType": "ELB", - "LaunchConfigurationName": "my-launch-config", - "MaxSize": 3, - "MinSize": 1, - "TargetGroupARNs": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - ], - "VPCZoneIdentifier": "subnet-4176792c, subnet-65ea5f08" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Auto Scaling group and attaches the specified target group.", - "id": "autoscaling-create-auto-scaling-group-3", - "title": "To create an Auto Scaling group with an attached target group" - } - ], - "CreateLaunchConfiguration": [ - { - "input": { - "IamInstanceProfile": "my-iam-role", - "ImageId": "ami-12345678", - "InstanceType": "m3.medium", - "LaunchConfigurationName": "my-launch-config", - "SecurityGroups": [ - "sg-eb2af88e" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a launch configuration.", - "id": "autoscaling-create-launch-configuration-1", - "title": "To create a launch configuration" - } - ], - "CreateOrUpdateTags": [ - { - "input": { - "Tags": [ - { - "Key": "Role", - "PropagateAtLaunch": true, - "ResourceId": "my-auto-scaling-group", - "ResourceType": "auto-scaling-group", - "Value": "WebServer" - }, - { - "Key": "Dept", - "PropagateAtLaunch": true, - "ResourceId": "my-auto-scaling-group", - "ResourceType": "auto-scaling-group", - "Value": "Research" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds two tags to the specified Auto Scaling group.", - "id": "autoscaling-create-or-update-tags-1", - "title": "To create or update tags for an Auto Scaling group" - } - ], - "DeleteAutoScalingGroup": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified Auto Scaling group.", - "id": "autoscaling-delete-auto-scaling-group-1", - "title": "To delete an Auto Scaling group" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "ForceDelete": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified Auto Scaling group and all its instances.", - "id": "autoscaling-delete-auto-scaling-group-2", - "title": "To delete an Auto Scaling group and all its instances" - } - ], - "DeleteLaunchConfiguration": [ - { - "input": { - "LaunchConfigurationName": "my-launch-config" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified launch configuration.", - "id": "autoscaling-delete-launch-configuration-1", - "title": "To delete a launch configuration" - } - ], - "DeleteLifecycleHook": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LifecycleHookName": "my-lifecycle-hook" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified lifecycle hook.", - "id": "autoscaling-delete-lifecycle-hook-1", - "title": "To delete a lifecycle hook" - } - ], - "DeleteNotificationConfiguration": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified notification from the specified Auto Scaling group.", - "id": "autoscaling-delete-notification-configuration-1", - "title": "To delete an Auto Scaling notification" - } - ], - "DeletePolicy": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "PolicyName": "ScaleIn" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified Auto Scaling policy.", - "id": "autoscaling-delete-policy-1", - "title": "To delete an Auto Scaling policy" - } - ], - "DeleteScheduledAction": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "ScheduledActionName": "my-scheduled-action" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified scheduled action from the specified Auto Scaling group.", - "id": "autoscaling-delete-scheduled-action-1", - "title": "To delete a scheduled action from an Auto Scaling group" - } - ], - "DeleteTags": [ - { - "input": { - "Tags": [ - { - "Key": "Dept", - "ResourceId": "my-auto-scaling-group", - "ResourceType": "auto-scaling-group", - "Value": "Research" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified tag from the specified Auto Scaling group.", - "id": "autoscaling-delete-tags-1", - "title": "To delete a tag from an Auto Scaling group" - } - ], - "DescribeAccountLimits": [ - { - "output": { - "MaxNumberOfAutoScalingGroups": 20, - "MaxNumberOfLaunchConfigurations": 100, - "NumberOfAutoScalingGroups": 3, - "NumberOfLaunchConfigurations": 5 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Auto Scaling limits for your AWS account.", - "id": "autoscaling-describe-account-limits-1", - "title": "To describe your Auto Scaling account limits" - } - ], - "DescribeAdjustmentTypes": [ - { - "output": { - "AdjustmentTypes": [ - { - "AdjustmentType": "ChangeInCapacity" - }, - { - "AdjustmentType": "ExactCapcity" - }, - { - "AdjustmentType": "PercentChangeInCapacity" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the available adjustment types.", - "id": "autoscaling-describe-adjustment-types-1", - "title": "To describe the Auto Scaling adjustment types" - } - ], - "DescribeAutoScalingGroups": [ - { - "input": { - "AutoScalingGroupNames": [ - "my-auto-scaling-group" - ] - }, - "output": { - "AutoScalingGroups": [ - { - "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-auto-scaling-group", - "AutoScalingGroupName": "my-auto-scaling-group", - "AvailabilityZones": [ - "us-west-2c" - ], - "CreatedTime": "2013-08-19T20:53:25.584Z", - "DefaultCooldown": 300, - "DesiredCapacity": 1, - "EnabledMetrics": [ - - ], - "HealthCheckGracePeriod": 300, - "HealthCheckType": "EC2", - "Instances": [ - { - "AvailabilityZone": "us-west-2c", - "HealthStatus": "Healthy", - "InstanceId": "i-4ba0837f", - "LaunchConfigurationName": "my-launch-config", - "LifecycleState": "InService" - } - ], - "LaunchConfigurationName": "my-launch-config", - "LoadBalancerNames": [ - - ], - "MaxSize": 1, - "MinSize": 0, - "NewInstancesProtectedFromScaleIn": false, - "SuspendedProcesses": [ - - ], - "Tags": [ - - ], - "TerminationPolicies": [ - "Default" - ], - "VPCZoneIdentifier": "subnet-12345678" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Auto Scaling group.", - "id": "autoscaling-describe-auto-scaling-groups-1", - "title": "To describe an Auto Scaling group" - } - ], - "DescribeAutoScalingInstances": [ - { - "input": { - "InstanceIds": [ - "i-4ba0837f" - ] - }, - "output": { - "AutoScalingInstances": [ - { - "AutoScalingGroupName": "my-auto-scaling-group", - "AvailabilityZone": "us-west-2c", - "HealthStatus": "HEALTHY", - "InstanceId": "i-4ba0837f", - "LaunchConfigurationName": "my-launch-config", - "LifecycleState": "InService", - "ProtectedFromScaleIn": false - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Auto Scaling instance.", - "id": "autoscaling-describe-auto-scaling-instances-1", - "title": "To describe one or more Auto Scaling instances" - } - ], - "DescribeAutoScalingNotificationTypes": [ - { - "output": { - "AutoScalingNotificationTypes": [ - "autoscaling:EC2_INSTANCE_LAUNCH", - "autoscaling:EC2_INSTANCE_LAUNCH_ERROR", - "autoscaling:EC2_INSTANCE_TERMINATE", - "autoscaling:EC2_INSTANCE_TERMINATE_ERROR", - "autoscaling:TEST_NOTIFICATION" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the available notification types.", - "id": "autoscaling-describe-auto-scaling-notification-types-1", - "title": "To describe the Auto Scaling notification types" - } - ], - "DescribeLaunchConfigurations": [ - { - "input": { - "LaunchConfigurationNames": [ - "my-launch-config" - ] - }, - "output": { - "LaunchConfigurations": [ - { - "AssociatePublicIpAddress": true, - "BlockDeviceMappings": [ - - ], - "CreatedTime": "2014-05-07T17:39:28.599Z", - "EbsOptimized": false, - "ImageId": "ami-043a5034", - "InstanceMonitoring": { - "Enabled": true - }, - "InstanceType": "t1.micro", - "LaunchConfigurationARN": "arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:98d3b196-4cf9-4e88-8ca1-8547c24ced8b:launchConfigurationName/my-launch-config", - "LaunchConfigurationName": "my-launch-config", - "SecurityGroups": [ - "sg-67ef0308" - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified launch configuration.", - "id": "autoscaling-describe-launch-configurations-1", - "title": "To describe Auto Scaling launch configurations" - } - ], - "DescribeLifecycleHookTypes": [ - { - "output": { - "LifecycleHookTypes": [ - "autoscaling:EC2_INSTANCE_LAUNCHING", - "autoscaling:EC2_INSTANCE_TERMINATING" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the available lifecycle hook types.", - "id": "autoscaling-describe-lifecycle-hook-types-1", - "title": "To describe the available types of lifecycle hooks" - } - ], - "DescribeLifecycleHooks": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "LifecycleHooks": [ - { - "AutoScalingGroupName": "my-auto-scaling-group", - "DefaultResult": "ABANDON", - "GlobalTimeout": 172800, - "HeartbeatTimeout": 3600, - "LifecycleHookName": "my-lifecycle-hook", - "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING", - "NotificationTargetARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic", - "RoleARN": "arn:aws:iam::123456789012:role/my-auto-scaling-role" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the lifecycle hooks for the specified Auto Scaling group.", - "id": "autoscaling-describe-lifecycle-hooks-1", - "title": "To describe your lifecycle hooks" - } - ], - "DescribeLoadBalancerTargetGroups": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "LoadBalancerTargetGroups": [ - { - "LoadBalancerTargetGroupARN": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "State": "Added" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the target groups attached to the specified Auto Scaling group.", - "id": "autoscaling-describe-load-balancer-target-groups-1", - "title": "To describe the target groups for an Auto Scaling group" - } - ], - "DescribeLoadBalancers": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "LoadBalancers": [ - { - "LoadBalancerName": "my-load-balancer", - "State": "Added" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the load balancers attached to the specified Auto Scaling group.", - "id": "autoscaling-describe-load-balancers-1", - "title": "To describe the load balancers for an Auto Scaling group" - } - ], - "DescribeMetricCollectionTypes": [ - { - "output": { - "Granularities": [ - { - "Granularity": "1Minute" - } - ], - "Metrics": [ - { - "Metric": "GroupMinSize" - }, - { - "Metric": "GroupMaxSize" - }, - { - "Metric": "GroupDesiredCapacity" - }, - { - "Metric": "GroupInServiceInstances" - }, - { - "Metric": "GroupPendingInstances" - }, - { - "Metric": "GroupTerminatingInstances" - }, - { - "Metric": "GroupStandbyInstances" - }, - { - "Metric": "GroupTotalInstances" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the available metric collection types.", - "id": "autoscaling-describe-metric-collection-types-1", - "title": "To describe the Auto Scaling metric collection types" - } - ], - "DescribeNotificationConfigurations": [ - { - "input": { - "AutoScalingGroupNames": [ - "my-auto-scaling-group" - ] - }, - "output": { - "NotificationConfigurations": [ - { - "AutoScalingGroupName": "my-auto-scaling-group", - "NotificationType": "autoscaling:TEST_NOTIFICATION", - "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" - }, - { - "AutoScalingGroupName": "my-auto-scaling-group", - "NotificationType": "autoscaling:TEST_NOTIFICATION", - "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the notification configurations for the specified Auto Scaling group.", - "id": "autoscaling-describe-notification-configurations-1", - "title": "To describe Auto Scaling notification configurations" - } - ], - "DescribePolicies": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "ScalingPolicies": [ - { - "AdjustmentType": "ChangeInCapacity", - "Alarms": [ - - ], - "AutoScalingGroupName": "my-auto-scaling-group", - "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn", - "PolicyName": "ScaleIn", - "ScalingAdjustment": -1 - }, - { - "AdjustmentType": "PercentChangeInCapacity", - "Alarms": [ - - ], - "AutoScalingGroupName": "my-auto-scaling-group", - "Cooldown": 60, - "MinAdjustmentStep": 2, - "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2b435159-cf77-4e89-8c0e-d63b497baad7:autoScalingGroupName/my-auto-scaling-group:policyName/ScalePercentChange", - "PolicyName": "ScalePercentChange", - "ScalingAdjustment": 25 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the policies for the specified Auto Scaling group.", - "id": "autoscaling-describe-policies-1", - "title": "To describe Auto Scaling policies" - } - ], - "DescribeScalingActivities": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "Activities": [ - { - "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699", - "AutoScalingGroupName": "my-auto-scaling-group", - "Cause": "At 2013-08-19T20:53:25Z a user request created an AutoScalingGroup changing the desired capacity from 0 to 1. At 2013-08-19T20:53:29Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 1.", - "Description": "Launching a new EC2 instance: i-4ba0837f", - "Details": "details", - "EndTime": "2013-08-19T20:54:02Z", - "Progress": 100, - "StartTime": "2013-08-19T20:53:29.930Z", - "StatusCode": "Successful" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the scaling activities for the specified Auto Scaling group.", - "id": "autoscaling-describe-scaling-activities-1", - "title": "To describe the scaling activities for an Auto Scaling group" - } - ], - "DescribeScalingProcessTypes": [ - { - "output": { - "Processes": [ - { - "ProcessName": "AZRebalance" - }, - { - "ProcessName": "AddToLoadBalancer" - }, - { - "ProcessName": "AlarmNotification" - }, - { - "ProcessName": "HealthCheck" - }, - { - "ProcessName": "Launch" - }, - { - "ProcessName": "ReplaceUnhealthy" - }, - { - "ProcessName": "ScheduledActions" - }, - { - "ProcessName": "Terminate" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Auto Scaling process types.", - "id": "autoscaling-describe-scaling-process-types-1", - "title": "To describe the Auto Scaling process types" - } - ], - "DescribeScheduledActions": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group" - }, - "output": { - "ScheduledUpdateGroupActions": [ - { - "AutoScalingGroupName": "my-auto-scaling-group", - "DesiredCapacity": 4, - "MaxSize": 6, - "MinSize": 2, - "Recurrence": "30 0 1 12 0", - "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-auto-scaling-group:scheduledActionName/my-scheduled-action", - "ScheduledActionName": "my-scheduled-action", - "StartTime": "2016-12-01T00:30:00Z", - "Time": "2016-12-01T00:30:00Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the scheduled actions for the specified Auto Scaling group.", - "id": "autoscaling-describe-scheduled-actions-1", - "title": "To describe scheduled actions" - } - ], - "DescribeTags": [ - { - "input": { - "Filters": [ - { - "Name": "auto-scaling-group", - "Values": [ - "my-auto-scaling-group" - ] - } - ] - }, - "output": { - "Tags": [ - { - "Key": "Dept", - "PropagateAtLaunch": true, - "ResourceId": "my-auto-scaling-group", - "ResourceType": "auto-scaling-group", - "Value": "Research" - }, - { - "Key": "Role", - "PropagateAtLaunch": true, - "ResourceId": "my-auto-scaling-group", - "ResourceType": "auto-scaling-group", - "Value": "WebServer" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the tags for the specified Auto Scaling group.", - "id": "autoscaling-describe-tags-1", - "title": "To describe tags" - } - ], - "DescribeTerminationPolicyTypes": [ - { - "output": { - "TerminationPolicyTypes": [ - "ClosestToNextInstanceHour", - "Default", - "NewestInstance", - "OldestInstance", - "OldestLaunchConfiguration" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the available termination policy types.", - "id": "autoscaling-describe-termination-policy-types-1", - "title": "To describe termination policy types" - } - ], - "DetachInstances": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ], - "ShouldDecrementDesiredCapacity": true - }, - "output": { - "Activities": [ - { - "ActivityId": "5091cb52-547a-47ce-a236-c9ccbc2cb2c9", - "AutoScalingGroupName": "my-auto-scaling-group", - "Cause": "At 2015-04-12T15:02:16Z instance i-93633f9b was detached in response to a user request, shrinking the capacity from 2 to 1.", - "Description": "Detaching EC2 instance: i-93633f9b", - "Details": "details", - "Progress": 50, - "StartTime": "2015-04-12T15:02:16.179Z", - "StatusCode": "InProgress" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified instance from the specified Auto Scaling group.", - "id": "autoscaling-detach-instances-1", - "title": "To detach an instance from an Auto Scaling group" - } - ], - "DetachLoadBalancerTargetGroups": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "TargetGroupARNs": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified target group from the specified Auto Scaling group", - "id": "autoscaling-detach-load-balancer-target-groups-1", - "title": "To detach a target group from an Auto Scaling group" - } - ], - "DetachLoadBalancers": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LoadBalancerNames": [ - "my-load-balancer" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified load balancer from the specified Auto Scaling group.", - "id": "autoscaling-detach-load-balancers-1", - "title": "To detach a load balancer from an Auto Scaling group" - } - ], - "DisableMetricsCollection": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "Metrics": [ - "GroupDesiredCapacity" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables collecting data for the GroupDesiredCapacity metric for the specified Auto Scaling group.", - "id": "autoscaling-disable-metrics-collection-1", - "title": "To disable metrics collection for an Auto Scaling group" - } - ], - "EnableMetricsCollection": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "Granularity": "1Minute" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables data collection for the specified Auto Scaling group.", - "id": "autoscaling-enable-metrics-collection-1", - "title": "To enable metrics collection for an Auto Scaling group" - } - ], - "EnterStandby": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ], - "ShouldDecrementDesiredCapacity": true - }, - "output": { - "Activities": [ - { - "ActivityId": "ffa056b4-6ed3-41ba-ae7c-249dfae6eba1", - "AutoScalingGroupName": "my-auto-scaling-group", - "Cause": "At 2015-04-12T15:10:23Z instance i-93633f9b was moved to standby in response to a user request, shrinking the capacity from 2 to 1.", - "Description": "Moving EC2 instance to Standby: i-93633f9b", - "Details": "details", - "Progress": 50, - "StartTime": "2015-04-12T15:10:23.640Z", - "StatusCode": "InProgress" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example puts the specified instance into standby mode.", - "id": "autoscaling-enter-standby-1", - "title": "To move instances into standby mode" - } - ], - "ExecutePolicy": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "HonorCooldown": true, - "PolicyName": "ScaleIn" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example executes the specified Auto Scaling policy for the specified Auto Scaling group.", - "id": "autoscaling-execute-policy-1", - "title": "To execute an Auto Scaling policy" - } - ], - "ExitStandby": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ] - }, - "output": { - "Activities": [ - { - "ActivityId": "142928e1-a2dc-453a-9b24-b85ad6735928", - "AutoScalingGroupName": "my-auto-scaling-group", - "Cause": "At 2015-04-12T15:14:29Z instance i-93633f9b was moved out of standby in response to a user request, increasing the capacity from 1 to 2.", - "Description": "Moving EC2 instance out of Standby: i-93633f9b", - "Details": "details", - "Progress": 30, - "StartTime": "2015-04-12T15:14:29.886Z", - "StatusCode": "PreInService" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example moves the specified instance out of standby mode.", - "id": "autoscaling-exit-standby-1", - "title": "To move instances out of standby mode" - } - ], - "PutLifecycleHook": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LifecycleHookName": "my-lifecycle-hook", - "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING", - "NotificationTargetARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic --role-arn", - "RoleARN": "arn:aws:iam::123456789012:role/my-auto-scaling-role" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a lifecycle hook.", - "id": "autoscaling-put-lifecycle-hook-1", - "title": "To create a lifecycle hook" - } - ], - "PutNotificationConfiguration": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "NotificationTypes": [ - "autoscaling:TEST_NOTIFICATION" - ], - "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified notification to the specified Auto Scaling group.", - "id": "autoscaling-put-notification-configuration-1", - "title": "To add an Auto Scaling notification" - } - ], - "PutScalingPolicy": [ - { - "input": { - "AdjustmentType": "ChangeInCapacity", - "AutoScalingGroupName": "my-auto-scaling-group", - "PolicyName": "ScaleIn", - "ScalingAdjustment": -1 - }, - "output": { - "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified policy to the specified Auto Scaling group.", - "id": "autoscaling-put-scaling-policy-1", - "title": "To add a scaling policy to an Auto Scaling group" - } - ], - "PutScheduledUpdateGroupAction": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "DesiredCapacity": 4, - "EndTime": "2014-05-12T08:00:00Z", - "MaxSize": 6, - "MinSize": 2, - "ScheduledActionName": "my-scheduled-action", - "StartTime": "2014-05-12T08:00:00Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified scheduled action to the specified Auto Scaling group.", - "id": "autoscaling-put-scheduled-update-group-action-1", - "title": "To add a scheduled action to an Auto Scaling group" - } - ], - "RecordLifecycleActionHeartbeat": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LifecycleActionToken": "bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635", - "LifecycleHookName": "my-lifecycle-hook" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example records a lifecycle action heartbeat to keep the instance in a pending state.", - "id": "autoscaling-record-lifecycle-action-heartbeat-1", - "title": "To record a lifecycle action heartbeat" - } - ], - "ResumeProcesses": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "ScalingProcesses": [ - "AlarmNotification" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example resumes the specified suspended scaling process for the specified Auto Scaling group.", - "id": "autoscaling-resume-processes-1", - "title": "To resume Auto Scaling processes" - } - ], - "SetDesiredCapacity": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "DesiredCapacity": 2, - "HonorCooldown": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the desired capacity for the specified Auto Scaling group.", - "id": "autoscaling-set-desired-capacity-1", - "title": "To set the desired capacity for an Auto Scaling group" - } - ], - "SetInstanceHealth": [ - { - "input": { - "HealthStatus": "Unhealthy", - "InstanceId": "i-93633f9b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the health status of the specified instance to Unhealthy.", - "id": "autoscaling-set-instance-health-1", - "title": "To set the health status of an instance" - } - ], - "SetInstanceProtection": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ], - "ProtectedFromScaleIn": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables instance protection for the specified instance.", - "id": "autoscaling-set-instance-protection-1", - "title": "To enable instance protection for an instance" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "InstanceIds": [ - "i-93633f9b" - ], - "ProtectedFromScaleIn": false - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables instance protection for the specified instance.", - "id": "autoscaling-set-instance-protection-2", - "title": "To disable instance protection for an instance" - } - ], - "SuspendProcesses": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "ScalingProcesses": [ - "AlarmNotification" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example suspends the specified scaling process for the specified Auto Scaling group.", - "id": "autoscaling-suspend-processes-1", - "title": "To suspend Auto Scaling processes" - } - ], - "TerminateInstanceInAutoScalingGroup": [ - { - "input": { - "InstanceId": "i-93633f9b", - "ShouldDecrementDesiredCapacity": false - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example terminates the specified instance from the specified Auto Scaling group without updating the size of the group. Auto Scaling launches a replacement instance after the specified instance terminates.", - "id": "autoscaling-terminate-instance-in-auto-scaling-group-1", - "title": "To terminate an instance in an Auto Scaling group" - } - ], - "UpdateAutoScalingGroup": [ - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "LaunchConfigurationName": "new-launch-config" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the launch configuration of the specified Auto Scaling group.", - "id": "autoscaling-update-auto-scaling-group-1", - "title": "To update the launch configuration" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "MaxSize": 3, - "MinSize": 1 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the minimum size and maximum size of the specified Auto Scaling group.", - "id": "autoscaling-update-auto-scaling-group-2", - "title": "To update the minimum and maximum size" - }, - { - "input": { - "AutoScalingGroupName": "my-auto-scaling-group", - "NewInstancesProtectedFromScaleIn": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables instance protection for the specified Auto Scaling group.", - "id": "autoscaling-update-auto-scaling-group-3", - "title": "To enable instance protection" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/paginators-1.json deleted file mode 100644 index 31bc0944..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/paginators-1.json +++ /dev/null @@ -1,52 +0,0 @@ -{ - "pagination": { - "DescribeAutoScalingGroups": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "AutoScalingGroups" - }, - "DescribeAutoScalingInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "AutoScalingInstances" - }, - "DescribeLaunchConfigurations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "LaunchConfigurations" - }, - "DescribeNotificationConfigurations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "NotificationConfigurations" - }, - "DescribePolicies": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "ScalingPolicies" - }, - "DescribeScalingActivities": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "Activities" - }, - "DescribeScheduledActions": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "ScheduledUpdateGroupActions" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "Tags" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/service-2.json deleted file mode 100644 index 936ab811..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/autoscaling/2011-01-01/service-2.json +++ /dev/null @@ -1,3596 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2011-01-01", - "endpointPrefix":"autoscaling", - "protocol":"query", - "serviceFullName":"Auto Scaling", - "serviceId":"Auto Scaling", - "signatureVersion":"v4", - "uid":"autoscaling-2011-01-01", - "xmlNamespace":"http://autoscaling.amazonaws.com/doc/2011-01-01/" - }, - "operations":{ - "AttachInstances":{ - "name":"AttachInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInstancesQuery"}, - "errors":[ - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Attaches one or more EC2 instances to the specified Auto Scaling group.

When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.

If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.

For more information, see Attach EC2 Instances to Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "AttachLoadBalancerTargetGroups":{ - "name":"AttachLoadBalancerTargetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachLoadBalancerTargetGroupsType"}, - "output":{ - "shape":"AttachLoadBalancerTargetGroupsResultType", - "resultWrapper":"AttachLoadBalancerTargetGroupsResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Attaches one or more target groups to the specified Auto Scaling group.

To describe the target groups for an Auto Scaling group, use DescribeLoadBalancerTargetGroups. To detach the target group from the Auto Scaling group, use DetachLoadBalancerTargetGroups.

For more information, see Attach a Load Balancer to Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "AttachLoadBalancers":{ - "name":"AttachLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachLoadBalancersType"}, - "output":{ - "shape":"AttachLoadBalancersResultType", - "resultWrapper":"AttachLoadBalancersResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Attaches one or more Classic Load Balancers to the specified Auto Scaling group.

To attach an Application Load Balancer instead, see AttachLoadBalancerTargetGroups.

To describe the load balancers for an Auto Scaling group, use DescribeLoadBalancers. To detach the load balancer from the Auto Scaling group, use DetachLoadBalancers.

For more information, see Attach a Load Balancer to Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "CompleteLifecycleAction":{ - "name":"CompleteLifecycleAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CompleteLifecycleActionType"}, - "output":{ - "shape":"CompleteLifecycleActionAnswer", - "resultWrapper":"CompleteLifecycleActionResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Completes the lifecycle action for the specified token or instance with the specified result.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

  1. (Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

  2. (Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

  3. Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

  4. If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

  5. If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle in the Auto Scaling User Guide.

" - }, - "CreateAutoScalingGroup":{ - "name":"CreateAutoScalingGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAutoScalingGroupType"}, - "errors":[ - {"shape":"AlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Creates an Auto Scaling group with the specified name and attributes.

If you exceed your maximum limit of Auto Scaling groups, the call fails. For information about viewing this limit, see DescribeAccountLimits. For information about updating this limit, see Auto Scaling Limits in the Auto Scaling User Guide.

For more information, see Auto Scaling Groups in the Auto Scaling User Guide.

" - }, - "CreateLaunchConfiguration":{ - "name":"CreateLaunchConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLaunchConfigurationType"}, - "errors":[ - {"shape":"AlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Creates a launch configuration.

If you exceed your maximum limit of launch configurations, the call fails. For information about viewing this limit, see DescribeAccountLimits. For information about updating this limit, see Auto Scaling Limits in the Auto Scaling User Guide.

For more information, see Launch Configurations in the Auto Scaling User Guide.

" - }, - "CreateOrUpdateTags":{ - "name":"CreateOrUpdateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateOrUpdateTagsType"}, - "errors":[ - {"shape":"LimitExceededFault"}, - {"shape":"AlreadyExistsFault"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ResourceInUseFault"} - ], - "documentation":"

Creates or updates tags for the specified Auto Scaling group.

When you specify a tag with a key that already exists, the operation overwrites the previous tag definition, and you do not get an error message.

For more information, see Tagging Auto Scaling Groups and Instances in the Auto Scaling User Guide.

" - }, - "DeleteAutoScalingGroup":{ - "name":"DeleteAutoScalingGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAutoScalingGroupType"}, - "errors":[ - {"shape":"ScalingActivityInProgressFault"}, - {"shape":"ResourceInUseFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Deletes the specified Auto Scaling group.

If the group has instances or scaling activities in progress, you must specify the option to force the deletion in order for it to succeed.

If the group has policies, deleting the group deletes the policies, the underlying alarm actions, and any alarm that no longer has an associated action.

To remove instances from the Auto Scaling group before deleting it, call DetachInstances with the list of instances and the option to decrement the desired capacity so that Auto Scaling does not launch replacement instances.

To terminate all instances before deleting the Auto Scaling group, call UpdateAutoScalingGroup and set the minimum size and desired capacity of the Auto Scaling group to zero.

" - }, - "DeleteLaunchConfiguration":{ - "name":"DeleteLaunchConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LaunchConfigurationNameType"}, - "errors":[ - {"shape":"ResourceInUseFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Deletes the specified launch configuration.

The launch configuration must not be attached to an Auto Scaling group. When this call completes, the launch configuration is no longer available for use.

" - }, - "DeleteLifecycleHook":{ - "name":"DeleteLifecycleHook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLifecycleHookType"}, - "output":{ - "shape":"DeleteLifecycleHookAnswer", - "resultWrapper":"DeleteLifecycleHookResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Deletes the specified lifecycle hook.

If there are any outstanding lifecycle actions, they are completed first (ABANDON for launching instances, CONTINUE for terminating instances).

" - }, - "DeleteNotificationConfiguration":{ - "name":"DeleteNotificationConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNotificationConfigurationType"}, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Deletes the specified notification.

" - }, - "DeletePolicy":{ - "name":"DeletePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePolicyType"}, - "errors":[ - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Deletes the specified Auto Scaling policy.

Deleting a policy deletes the underlying alarm action, but does not delete the alarm, even if it no longer has an associated action.

" - }, - "DeleteScheduledAction":{ - "name":"DeleteScheduledAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteScheduledActionType"}, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Deletes the specified scheduled action.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsType"}, - "errors":[ - {"shape":"ResourceContentionFault"}, - {"shape":"ResourceInUseFault"} - ], - "documentation":"

Deletes the specified tags.

" - }, - "DescribeAccountLimits":{ - "name":"DescribeAccountLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeAccountLimitsAnswer", - "resultWrapper":"DescribeAccountLimitsResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the current Auto Scaling resource limits for your AWS account.

For information about requesting an increase in these limits, see Auto Scaling Limits in the Auto Scaling User Guide.

" - }, - "DescribeAdjustmentTypes":{ - "name":"DescribeAdjustmentTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeAdjustmentTypesAnswer", - "resultWrapper":"DescribeAdjustmentTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the policy adjustment types for use with PutScalingPolicy.

" - }, - "DescribeAutoScalingGroups":{ - "name":"DescribeAutoScalingGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AutoScalingGroupNamesType"}, - "output":{ - "shape":"AutoScalingGroupsType", - "resultWrapper":"DescribeAutoScalingGroupsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes one or more Auto Scaling groups.

" - }, - "DescribeAutoScalingInstances":{ - "name":"DescribeAutoScalingInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAutoScalingInstancesType"}, - "output":{ - "shape":"AutoScalingInstancesType", - "resultWrapper":"DescribeAutoScalingInstancesResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes one or more Auto Scaling instances.

" - }, - "DescribeAutoScalingNotificationTypes":{ - "name":"DescribeAutoScalingNotificationTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeAutoScalingNotificationTypesAnswer", - "resultWrapper":"DescribeAutoScalingNotificationTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the notification types that are supported by Auto Scaling.

" - }, - "DescribeLaunchConfigurations":{ - "name":"DescribeLaunchConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LaunchConfigurationNamesType"}, - "output":{ - "shape":"LaunchConfigurationsType", - "resultWrapper":"DescribeLaunchConfigurationsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes one or more launch configurations.

" - }, - "DescribeLifecycleHookTypes":{ - "name":"DescribeLifecycleHookTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeLifecycleHookTypesAnswer", - "resultWrapper":"DescribeLifecycleHookTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the available types of lifecycle hooks.

" - }, - "DescribeLifecycleHooks":{ - "name":"DescribeLifecycleHooks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLifecycleHooksType"}, - "output":{ - "shape":"DescribeLifecycleHooksAnswer", - "resultWrapper":"DescribeLifecycleHooksResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the lifecycle hooks for the specified Auto Scaling group.

" - }, - "DescribeLoadBalancerTargetGroups":{ - "name":"DescribeLoadBalancerTargetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancerTargetGroupsRequest"}, - "output":{ - "shape":"DescribeLoadBalancerTargetGroupsResponse", - "resultWrapper":"DescribeLoadBalancerTargetGroupsResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the target groups for the specified Auto Scaling group.

" - }, - "DescribeLoadBalancers":{ - "name":"DescribeLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancersRequest"}, - "output":{ - "shape":"DescribeLoadBalancersResponse", - "resultWrapper":"DescribeLoadBalancersResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the load balancers for the specified Auto Scaling group.

Note that this operation describes only Classic Load Balancers. If you have Application Load Balancers, use DescribeLoadBalancerTargetGroups instead.

" - }, - "DescribeMetricCollectionTypes":{ - "name":"DescribeMetricCollectionTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeMetricCollectionTypesAnswer", - "resultWrapper":"DescribeMetricCollectionTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the available CloudWatch metrics for Auto Scaling.

Note that the GroupStandbyInstances metric is not returned by default. You must explicitly request this metric when calling EnableMetricsCollection.

" - }, - "DescribeNotificationConfigurations":{ - "name":"DescribeNotificationConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNotificationConfigurationsType"}, - "output":{ - "shape":"DescribeNotificationConfigurationsAnswer", - "resultWrapper":"DescribeNotificationConfigurationsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the notification actions associated with the specified Auto Scaling group.

" - }, - "DescribePolicies":{ - "name":"DescribePolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePoliciesType"}, - "output":{ - "shape":"PoliciesType", - "resultWrapper":"DescribePoliciesResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Describes the policies for the specified Auto Scaling group.

" - }, - "DescribeScalingActivities":{ - "name":"DescribeScalingActivities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingActivitiesType"}, - "output":{ - "shape":"ActivitiesType", - "resultWrapper":"DescribeScalingActivitiesResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes one or more scaling activities for the specified Auto Scaling group.

" - }, - "DescribeScalingProcessTypes":{ - "name":"DescribeScalingProcessTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"ProcessesType", - "resultWrapper":"DescribeScalingProcessTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the scaling process types for use with ResumeProcesses and SuspendProcesses.

" - }, - "DescribeScheduledActions":{ - "name":"DescribeScheduledActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledActionsType"}, - "output":{ - "shape":"ScheduledActionsType", - "resultWrapper":"DescribeScheduledActionsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the actions scheduled for your Auto Scaling group that haven't run. To describe the actions that have already run, use DescribeScalingActivities.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsType"}, - "output":{ - "shape":"TagsType", - "resultWrapper":"DescribeTagsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the specified tags.

You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.

You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.

" - }, - "DescribeTerminationPolicyTypes":{ - "name":"DescribeTerminationPolicyTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeTerminationPolicyTypesAnswer", - "resultWrapper":"DescribeTerminationPolicyTypesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Describes the termination policies supported by Auto Scaling.

" - }, - "DetachInstances":{ - "name":"DetachInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInstancesQuery"}, - "output":{ - "shape":"DetachInstancesAnswer", - "resultWrapper":"DetachInstancesResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Removes one or more instances from the specified Auto Scaling group.

After the instances are detached, you can manage them independent of the Auto Scaling group.

If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.

If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.

For more information, see Detach EC2 Instances from Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "DetachLoadBalancerTargetGroups":{ - "name":"DetachLoadBalancerTargetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachLoadBalancerTargetGroupsType"}, - "output":{ - "shape":"DetachLoadBalancerTargetGroupsResultType", - "resultWrapper":"DetachLoadBalancerTargetGroupsResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Detaches one or more target groups from the specified Auto Scaling group.

" - }, - "DetachLoadBalancers":{ - "name":"DetachLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachLoadBalancersType"}, - "output":{ - "shape":"DetachLoadBalancersResultType", - "resultWrapper":"DetachLoadBalancersResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Detaches one or more Classic Load Balancers from the specified Auto Scaling group.

Note that this operation detaches only Classic Load Balancers. If you have Application Load Balancers, use DetachLoadBalancerTargetGroups instead.

When you detach a load balancer, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using DescribeLoadBalancers. Note that the instances remain running.

" - }, - "DisableMetricsCollection":{ - "name":"DisableMetricsCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableMetricsCollectionQuery"}, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Disables group metrics for the specified Auto Scaling group.

" - }, - "EnableMetricsCollection":{ - "name":"EnableMetricsCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableMetricsCollectionQuery"}, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Enables group metrics for the specified Auto Scaling group. For more information, see Monitoring Your Auto Scaling Groups and Instances in the Auto Scaling User Guide.

" - }, - "EnterStandby":{ - "name":"EnterStandby", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnterStandbyQuery"}, - "output":{ - "shape":"EnterStandbyAnswer", - "resultWrapper":"EnterStandbyResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Moves the specified instances into the standby state.

For more information, see Temporarily Removing Instances from Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "ExecutePolicy":{ - "name":"ExecutePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExecutePolicyType"}, - "errors":[ - {"shape":"ScalingActivityInProgressFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Executes the specified policy.

" - }, - "ExitStandby":{ - "name":"ExitStandby", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExitStandbyQuery"}, - "output":{ - "shape":"ExitStandbyAnswer", - "resultWrapper":"ExitStandbyResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Moves the specified instances out of the standby state.

For more information, see Temporarily Removing Instances from Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "PutLifecycleHook":{ - "name":"PutLifecycleHook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutLifecycleHookType"}, - "output":{ - "shape":"PutLifecycleHookAnswer", - "resultWrapper":"PutLifecycleHookResult" - }, - "errors":[ - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Creates or updates a lifecycle hook for the specified Auto Scaling Group.

A lifecycle hook tells Auto Scaling that you want to perform an action on an instance that is not actively in service; for example, either when the instance launches or before the instance terminates.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

  1. (Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

  2. (Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

  3. Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

  4. If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

  5. If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle Hooks in the Auto Scaling User Guide.

If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling group, the call fails. For information about updating this limit, see AWS Service Limits in the Amazon Web Services General Reference.

" - }, - "PutNotificationConfiguration":{ - "name":"PutNotificationConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutNotificationConfigurationType"}, - "errors":[ - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Configures an Auto Scaling group to send notifications when specified events take place. Subscribers to the specified topic can have messages delivered to an endpoint such as a web server or an email address.

This configuration overwrites any existing configuration.

For more information see Getting SNS Notifications When Your Auto Scaling Group Scales in the Auto Scaling User Guide.

" - }, - "PutScalingPolicy":{ - "name":"PutScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutScalingPolicyType"}, - "output":{ - "shape":"PolicyARNType", - "resultWrapper":"PutScalingPolicyResult" - }, - "errors":[ - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Creates or updates a policy for an Auto Scaling group. To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.

If you exceed your maximum limit of step adjustments, which by default is 20 per region, the call fails. For information about updating this limit, see AWS Service Limits in the Amazon Web Services General Reference.

" - }, - "PutScheduledUpdateGroupAction":{ - "name":"PutScheduledUpdateGroupAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutScheduledUpdateGroupActionType"}, - "errors":[ - {"shape":"AlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Creates or updates a scheduled scaling action for an Auto Scaling group. When updating a scheduled scaling action, if you leave a parameter unspecified, the corresponding value remains unchanged.

For more information, see Scheduled Scaling in the Auto Scaling User Guide.

" - }, - "RecordLifecycleActionHeartbeat":{ - "name":"RecordLifecycleActionHeartbeat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RecordLifecycleActionHeartbeatType"}, - "output":{ - "shape":"RecordLifecycleActionHeartbeatAnswer", - "resultWrapper":"RecordLifecycleActionHeartbeatResult" - }, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Records a heartbeat for the lifecycle action associated with the specified token or instance. This extends the timeout by the length of time defined using PutLifecycleHook.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

  1. (Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

  2. (Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

  3. Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

  4. If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

  5. If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle in the Auto Scaling User Guide.

" - }, - "ResumeProcesses":{ - "name":"ResumeProcesses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScalingProcessQuery"}, - "errors":[ - {"shape":"ResourceInUseFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Resumes the specified suspended Auto Scaling processes, or all suspended process, for the specified Auto Scaling group.

For more information, see Suspending and Resuming Auto Scaling Processes in the Auto Scaling User Guide.

" - }, - "SetDesiredCapacity":{ - "name":"SetDesiredCapacity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetDesiredCapacityType"}, - "errors":[ - {"shape":"ScalingActivityInProgressFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Sets the size of the specified Auto Scaling group.

For more information about desired capacity, see What Is Auto Scaling? in the Auto Scaling User Guide.

" - }, - "SetInstanceHealth":{ - "name":"SetInstanceHealth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetInstanceHealthQuery"}, - "errors":[ - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Sets the health status of the specified instance.

For more information, see Health Checks in the Auto Scaling User Guide.

" - }, - "SetInstanceProtection":{ - "name":"SetInstanceProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetInstanceProtectionQuery"}, - "output":{ - "shape":"SetInstanceProtectionAnswer", - "resultWrapper":"SetInstanceProtectionResult" - }, - "errors":[ - {"shape":"LimitExceededFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Updates the instance protection settings of the specified instances.

For more information, see Instance Protection in the Auto Scaling User Guide.

" - }, - "SuspendProcesses":{ - "name":"SuspendProcesses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScalingProcessQuery"}, - "errors":[ - {"shape":"ResourceInUseFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Suspends the specified Auto Scaling processes, or all processes, for the specified Auto Scaling group.

Note that if you suspend either the Launch or Terminate process types, it can prevent other process types from functioning properly.

To resume processes that have been suspended, use ResumeProcesses.

For more information, see Suspending and Resuming Auto Scaling Processes in the Auto Scaling User Guide.

" - }, - "TerminateInstanceInAutoScalingGroup":{ - "name":"TerminateInstanceInAutoScalingGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstanceInAutoScalingGroupType"}, - "output":{ - "shape":"ActivityType", - "resultWrapper":"TerminateInstanceInAutoScalingGroupResult" - }, - "errors":[ - {"shape":"ScalingActivityInProgressFault"}, - {"shape":"ResourceContentionFault"} - ], - "documentation":"

Terminates the specified instance and optionally adjusts the desired group size.

This call simply makes a termination request. The instance is not terminated immediately.

" - }, - "UpdateAutoScalingGroup":{ - "name":"UpdateAutoScalingGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAutoScalingGroupType"}, - "errors":[ - {"shape":"ScalingActivityInProgressFault"}, - {"shape":"ResourceContentionFault"}, - {"shape":"ServiceLinkedRoleFailure"} - ], - "documentation":"

Updates the configuration for the specified Auto Scaling group.

The new settings take effect on any scaling activities after this call returns. Scaling activities that are currently in progress aren't affected.

To update an Auto Scaling group with a launch configuration with InstanceMonitoring set to false, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using DisableMetricsCollection.

Note the following:

  • If you specify a new value for MinSize without specifying a value for DesiredCapacity, and the new MinSize is larger than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MinSize.

  • If you specify a new value for MaxSize without specifying a value for DesiredCapacity, and the new MaxSize is smaller than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MaxSize.

  • All other optional parameters are left unchanged if not specified.

" - } - }, - "shapes":{ - "Activities":{ - "type":"list", - "member":{"shape":"Activity"} - }, - "ActivitiesType":{ - "type":"structure", - "required":["Activities"], - "members":{ - "Activities":{ - "shape":"Activities", - "documentation":"

The scaling activities. Activities are sorted by start time. Activities still in progress are described first.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "Activity":{ - "type":"structure", - "required":[ - "ActivityId", - "AutoScalingGroupName", - "Cause", - "StartTime", - "StatusCode" - ], - "members":{ - "ActivityId":{ - "shape":"XmlString", - "documentation":"

The ID of the activity.

" - }, - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group.

" - }, - "Description":{ - "shape":"XmlString", - "documentation":"

A friendly, more verbose description of the activity.

" - }, - "Cause":{ - "shape":"XmlStringMaxLen1023", - "documentation":"

The reason the activity began.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The start time of the activity.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The end time of the activity.

" - }, - "StatusCode":{ - "shape":"ScalingActivityStatusCode", - "documentation":"

The current status of the activity.

" - }, - "StatusMessage":{ - "shape":"XmlStringMaxLen255", - "documentation":"

A friendly, more verbose description of the activity status.

" - }, - "Progress":{ - "shape":"Progress", - "documentation":"

A value between 0 and 100 that indicates the progress of the activity.

" - }, - "Details":{ - "shape":"XmlString", - "documentation":"

The details about the activity.

" - } - }, - "documentation":"

Describes scaling activity, which is a long-running process that represents a change to your Auto Scaling group, such as changing its size or replacing an instance.

" - }, - "ActivityIds":{ - "type":"list", - "member":{"shape":"XmlString"} - }, - "ActivityType":{ - "type":"structure", - "members":{ - "Activity":{ - "shape":"Activity", - "documentation":"

A scaling activity.

" - } - } - }, - "AdjustmentType":{ - "type":"structure", - "members":{ - "AdjustmentType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The policy adjustment type. The valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.

" - } - }, - "documentation":"

Describes a policy adjustment type.

For more information, see Dynamic Scaling in the Auto Scaling User Guide.

" - }, - "AdjustmentTypes":{ - "type":"list", - "member":{"shape":"AdjustmentType"} - }, - "Alarm":{ - "type":"structure", - "members":{ - "AlarmName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the alarm.

" - }, - "AlarmARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the alarm.

" - } - }, - "documentation":"

Describes an alarm.

" - }, - "Alarms":{ - "type":"list", - "member":{"shape":"Alarm"} - }, - "AlreadyExistsFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

You already have an Auto Scaling group or launch configuration with this name.

", - "error":{ - "code":"AlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AsciiStringMaxLen255":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[A-Za-z0-9\\-_\\/]+" - }, - "AssociatePublicIpAddress":{"type":"boolean"}, - "AttachInstancesQuery":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

The IDs of the instances. You can specify up to 20 instances.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - } - } - }, - "AttachLoadBalancerTargetGroupsResultType":{ - "type":"structure", - "members":{ - } - }, - "AttachLoadBalancerTargetGroupsType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "TargetGroupARNs" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "TargetGroupARNs":{ - "shape":"TargetGroupARNs", - "documentation":"

The Amazon Resource Names (ARN) of the target groups. You can specify up to 10 target groups.

" - } - } - }, - "AttachLoadBalancersResultType":{ - "type":"structure", - "members":{ - } - }, - "AttachLoadBalancersType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "LoadBalancerNames" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

The names of the load balancers. You can specify up to 10 load balancers.

" - } - } - }, - "AutoScalingGroup":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "MinSize", - "MaxSize", - "DesiredCapacity", - "DefaultCooldown", - "AvailabilityZones", - "HealthCheckType", - "CreatedTime" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group.

" - }, - "AutoScalingGroupARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Auto Scaling group.

" - }, - "LaunchConfigurationName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the associated launch configuration.

" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template for the group.

" - }, - "MinSize":{ - "shape":"AutoScalingGroupMinSize", - "documentation":"

The minimum size of the group.

" - }, - "MaxSize":{ - "shape":"AutoScalingGroupMaxSize", - "documentation":"

The maximum size of the group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The desired size of the group.

" - }, - "DefaultCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes before another scaling activity can start.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

One or more Availability Zones for the group.

" - }, - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

One or more load balancers associated with the group.

" - }, - "TargetGroupARNs":{ - "shape":"TargetGroupARNs", - "documentation":"

The Amazon Resource Names (ARN) of the target groups for your load balancer.

" - }, - "HealthCheckType":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The service to use for the health checks. The valid values are EC2 and ELB.

" - }, - "HealthCheckGracePeriod":{ - "shape":"HealthCheckGracePeriod", - "documentation":"

The amount of time, in seconds, that Auto Scaling waits before checking the health status of an EC2 instance that has come into service.

" - }, - "Instances":{ - "shape":"Instances", - "documentation":"

The EC2 instances associated with the group.

" - }, - "CreatedTime":{ - "shape":"TimestampType", - "documentation":"

The date and time the group was created.

" - }, - "SuspendedProcesses":{ - "shape":"SuspendedProcesses", - "documentation":"

The suspended processes associated with the group.

" - }, - "PlacementGroup":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the placement group into which you'll launch your instances, if any. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "VPCZoneIdentifier":{ - "shape":"XmlStringMaxLen2047", - "documentation":"

One or more subnet IDs, if applicable, separated by commas.

If you specify VPCZoneIdentifier and AvailabilityZones, ensure that the Availability Zones of the subnets match the values for AvailabilityZones.

" - }, - "EnabledMetrics":{ - "shape":"EnabledMetrics", - "documentation":"

The metrics enabled for the group.

" - }, - "Status":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The current state of the group when DeleteAutoScalingGroup is in progress.

" - }, - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

The tags for the group.

" - }, - "TerminationPolicies":{ - "shape":"TerminationPolicies", - "documentation":"

The termination policies for the group.

" - }, - "NewInstancesProtectedFromScaleIn":{ - "shape":"InstanceProtected", - "documentation":"

Indicates whether newly launched instances are protected from termination by Auto Scaling when scaling in.

" - }, - "ServiceLinkedRoleARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other AWS services on your behalf.

" - } - }, - "documentation":"

Describes an Auto Scaling group.

" - }, - "AutoScalingGroupDesiredCapacity":{"type":"integer"}, - "AutoScalingGroupMaxSize":{"type":"integer"}, - "AutoScalingGroupMinSize":{"type":"integer"}, - "AutoScalingGroupNames":{ - "type":"list", - "member":{"shape":"ResourceName"} - }, - "AutoScalingGroupNamesType":{ - "type":"structure", - "members":{ - "AutoScalingGroupNames":{ - "shape":"AutoScalingGroupNames", - "documentation":"

The names of the Auto Scaling groups. If you omit this parameter, all Auto Scaling groups are described.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "AutoScalingGroups":{ - "type":"list", - "member":{"shape":"AutoScalingGroup"} - }, - "AutoScalingGroupsType":{ - "type":"structure", - "required":["AutoScalingGroups"], - "members":{ - "AutoScalingGroups":{ - "shape":"AutoScalingGroups", - "documentation":"

The groups.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "AutoScalingInstanceDetails":{ - "type":"structure", - "required":[ - "InstanceId", - "AutoScalingGroupName", - "AvailabilityZone", - "LifecycleState", - "HealthStatus", - "ProtectedFromScaleIn" - ], - "members":{ - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - }, - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group for the instance.

" - }, - "AvailabilityZone":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The Availability Zone for the instance.

" - }, - "LifecycleState":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The lifecycle state for the instance. For more information, see Auto Scaling Lifecycle in the Auto Scaling User Guide.

" - }, - "HealthStatus":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The last reported health status of this instance. \"Healthy\" means that the instance is healthy and should remain in service. \"Unhealthy\" means that the instance is unhealthy and Auto Scaling should terminate and replace it.

" - }, - "LaunchConfigurationName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The launch configuration used to launch the instance. This value is not available if you attached the instance to the Auto Scaling group.

" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template for the instance.

" - }, - "ProtectedFromScaleIn":{ - "shape":"InstanceProtected", - "documentation":"

Indicates whether the instance is protected from termination by Auto Scaling when scaling in.

" - } - }, - "documentation":"

Describes an EC2 instance associated with an Auto Scaling group.

" - }, - "AutoScalingInstances":{ - "type":"list", - "member":{"shape":"AutoScalingInstanceDetails"} - }, - "AutoScalingInstancesType":{ - "type":"structure", - "members":{ - "AutoScalingInstances":{ - "shape":"AutoScalingInstances", - "documentation":"

The instances.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "AutoScalingNotificationTypes":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"} - }, - "AvailabilityZones":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"}, - "min":1 - }, - "BlockDeviceEbsDeleteOnTermination":{"type":"boolean"}, - "BlockDeviceEbsEncrypted":{"type":"boolean"}, - "BlockDeviceEbsIops":{ - "type":"integer", - "max":20000, - "min":100 - }, - "BlockDeviceEbsVolumeSize":{ - "type":"integer", - "max":16384, - "min":1 - }, - "BlockDeviceEbsVolumeType":{ - "type":"string", - "max":255, - "min":1 - }, - "BlockDeviceMapping":{ - "type":"structure", - "required":["DeviceName"], - "members":{ - "VirtualName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the virtual device (for example, ephemeral0).

" - }, - "DeviceName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The device name exposed to the EC2 instance (for example, /dev/sdh or xvdh).

" - }, - "Ebs":{ - "shape":"Ebs", - "documentation":"

The information about the Amazon EBS volume.

" - }, - "NoDevice":{ - "shape":"NoDevice", - "documentation":"

Suppresses a device mapping.

If this parameter is true for the root device, the instance might fail the EC2 health check. Auto Scaling launches a replacement instance if the instance fails the health check.

" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappings":{ - "type":"list", - "member":{"shape":"BlockDeviceMapping"} - }, - "ClassicLinkVPCSecurityGroups":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"} - }, - "CompleteLifecycleActionAnswer":{ - "type":"structure", - "members":{ - } - }, - "CompleteLifecycleActionType":{ - "type":"structure", - "required":[ - "LifecycleHookName", - "AutoScalingGroupName", - "LifecycleActionResult" - ], - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LifecycleActionToken":{ - "shape":"LifecycleActionToken", - "documentation":"

A universally unique identifier (UUID) that identifies a specific lifecycle action associated with an instance. Auto Scaling sends this token to the notification target you specified when you created the lifecycle hook.

" - }, - "LifecycleActionResult":{ - "shape":"LifecycleActionResult", - "documentation":"

The action for the group to take. This parameter can be either CONTINUE or ABANDON.

" - }, - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - } - } - }, - "Cooldown":{"type":"integer"}, - "CreateAutoScalingGroupType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "MinSize", - "MaxSize" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group. This name must be unique within the scope of your AWS account.

" - }, - "LaunchConfigurationName":{ - "shape":"ResourceName", - "documentation":"

The name of the launch configuration. You must specify one of the following: a launch configuration, a launch template, or an EC2 instance.

" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template to use to launch instances. You must specify one of the following: a launch template, a launch configuration, or an EC2 instance.

" - }, - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance used to create a launch configuration for the group. You must specify one of the following: an EC2 instance, a launch configuration, or a launch template.

When you specify an ID of an instance, Auto Scaling creates a new launch configuration and associates it with the group. This launch configuration derives its attributes from the specified instance, with the exception of the block device mapping.

For more information, see Create an Auto Scaling Group Using an EC2 Instance in the Auto Scaling User Guide.

" - }, - "MinSize":{ - "shape":"AutoScalingGroupMinSize", - "documentation":"

The minimum size of the group.

" - }, - "MaxSize":{ - "shape":"AutoScalingGroupMaxSize", - "documentation":"

The maximum size of the group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group. If you do not specify a desired capacity, the default is the minimum size of the group.

" - }, - "DefaultCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.

For more information, see Auto Scaling Cooldowns in the Auto Scaling User Guide.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

One or more Availability Zones for the group. This parameter is optional if you specify one or more subnets.

" - }, - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

One or more Classic Load Balancers. To specify an Application Load Balancer, use TargetGroupARNs instead.

For more information, see Using a Load Balancer With an Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "TargetGroupARNs":{ - "shape":"TargetGroupARNs", - "documentation":"

The Amazon Resource Names (ARN) of the target groups.

" - }, - "HealthCheckType":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The service to use for the health checks. The valid values are EC2 and ELB.

By default, health checks use Amazon EC2 instance status checks to determine the health of an instance. For more information, see Health Checks in the Auto Scaling User Guide.

" - }, - "HealthCheckGracePeriod":{ - "shape":"HealthCheckGracePeriod", - "documentation":"

The amount of time, in seconds, that Auto Scaling waits before checking the health status of an EC2 instance that has come into service. During this time, any health check failures for the instance are ignored. The default is 0.

This parameter is required if you are adding an ELB health check.

For more information, see Health Checks in the Auto Scaling User Guide.

" - }, - "PlacementGroup":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the placement group into which you'll launch your instances, if any. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "VPCZoneIdentifier":{ - "shape":"XmlStringMaxLen2047", - "documentation":"

A comma-separated list of subnet identifiers for your virtual private cloud (VPC).

If you specify subnets and Availability Zones with this call, ensure that the subnets' Availability Zones match the Availability Zones specified.

For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.

" - }, - "TerminationPolicies":{ - "shape":"TerminationPolicies", - "documentation":"

One or more termination policies used to select the instance to terminate. These policies are executed in the order that they are listed.

For more information, see Controlling Which Instances Auto Scaling Terminates During Scale In in the Auto Scaling User Guide.

" - }, - "NewInstancesProtectedFromScaleIn":{ - "shape":"InstanceProtected", - "documentation":"

Indicates whether newly launched instances are protected from termination by Auto Scaling when scaling in.

" - }, - "LifecycleHookSpecificationList":{ - "shape":"LifecycleHookSpecifications", - "documentation":"

One or more lifecycle hooks.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

For more information, see Tagging Auto Scaling Groups and Instances in the Auto Scaling User Guide.

" - }, - "ServiceLinkedRoleARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other AWS services on your behalf. By default, Auto Scaling uses a service-linked role named AWSServiceRoleForAutoScaling, which it creates if it does not exist.

" - } - } - }, - "CreateLaunchConfigurationType":{ - "type":"structure", - "required":["LaunchConfigurationName"], - "members":{ - "LaunchConfigurationName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the launch configuration. This name must be unique within the scope of your AWS account.

" - }, - "ImageId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.

If you do not specify InstanceId, you must specify ImageId.

For more information, see Finding an AMI in the Amazon Elastic Compute Cloud User Guide.

" - }, - "KeyName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the key pair. For more information, see Amazon EC2 Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

One or more security groups with which to associate the instances.

If your instances are launched in EC2-Classic, you can either specify security group names or the security group IDs. For more information about security groups for EC2-Classic, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide.

If your instances are launched into a VPC, specify security group IDs. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "ClassicLinkVPCId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter is supported only if you are launching EC2-Classic instances. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ClassicLinkVPCSecurityGroups":{ - "shape":"ClassicLinkVPCSecurityGroups", - "documentation":"

The IDs of one or more security groups for the specified ClassicLink-enabled VPC. This parameter is required if you specify a ClassicLink-enabled VPC, and is not supported otherwise. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UserData":{ - "shape":"XmlStringUserData", - "documentation":"

The user data to make available to the launched EC2 instances. For more information, see Instance Metadata and User Data in the Amazon Elastic Compute Cloud User Guide.

" - }, - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, with the exception of the block device mapping.

If you do not specify InstanceId, you must specify both ImageId and InstanceType.

To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.

For more information, see Create a Launch Configuration Using an EC2 Instance in the Auto Scaling User Guide.

" - }, - "InstanceType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The instance type of the EC2 instance.

If you do not specify InstanceId, you must specify InstanceType.

For information about available instance types, see Available Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "KernelId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the kernel associated with the AMI.

" - }, - "RamdiskId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the RAM disk associated with the AMI.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappings", - "documentation":"

One or more mappings that specify how block devices are exposed to the instance. For more information, see Block Device Mapping in the Amazon Elastic Compute Cloud User Guide.

" - }, - "InstanceMonitoring":{ - "shape":"InstanceMonitoring", - "documentation":"

Enables detailed monitoring (true) or basic monitoring (false) for the Auto Scaling instances. The default is true.

" - }, - "SpotPrice":{ - "shape":"SpotPrice", - "documentation":"

The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot market price. For more information, see Launching Spot Instances in Your Auto Scaling Group in the Auto Scaling User Guide.

" - }, - "IamInstanceProfile":{ - "shape":"XmlStringMaxLen1600", - "documentation":"

The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.

EC2 instances launched with an IAM role will automatically have AWS security credentials available. You can use IAM roles with Auto Scaling to automatically enable applications running on your EC2 instances to securely access other AWS resources. For more information, see Launch Auto Scaling Instances with an IAM Role in the Auto Scaling User Guide.

" - }, - "EbsOptimized":{ - "shape":"EbsOptimized", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O. By default, the instance is not optimized for EBS I/O. The optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization is not available with all instance types. Additional usage charges apply. For more information, see Amazon EBS-Optimized Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AssociatePublicIpAddress":{ - "shape":"AssociatePublicIpAddress", - "documentation":"

Used for groups that launch instances into a virtual private cloud (VPC). Specifies whether to assign a public IP address to each instance. For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.

If you specify this parameter, be sure to specify at least one subnet when you create your group.

Default: If the instance is launched into a default subnet, the default is to assign a public IP address. If the instance is launched into a nondefault subnet, the default is not to assign a public IP address.

" - }, - "PlacementTenancy":{ - "shape":"XmlStringMaxLen64", - "documentation":"

The tenancy of the instance. An instance with a tenancy of dedicated runs on single-tenant hardware and can only be launched into a VPC.

You must set the value of this parameter to dedicated if want to launch Dedicated Instances into a shared tenancy VPC (VPC with instance placement tenancy attribute set to default).

If you specify this parameter, be sure to specify at least one subnet when you create your group.

For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.

Valid values: default | dedicated

" - } - } - }, - "CreateOrUpdateTagsType":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - } - } - }, - "CustomizedMetricSpecification":{ - "type":"structure", - "required":[ - "MetricName", - "Namespace", - "Statistic" - ], - "members":{ - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Namespace":{ - "shape":"MetricNamespace", - "documentation":"

The namespace of the metric.

" - }, - "Dimensions":{ - "shape":"MetricDimensions", - "documentation":"

The dimensions of the metric.

" - }, - "Statistic":{ - "shape":"MetricStatistic", - "documentation":"

The statistic of the metric.

" - }, - "Unit":{ - "shape":"MetricUnit", - "documentation":"

The unit of the metric.

" - } - }, - "documentation":"

Configures a customized metric for a target tracking policy.

" - }, - "DeleteAutoScalingGroupType":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ForceDelete":{ - "shape":"ForceDelete", - "documentation":"

Specifies that the group will be deleted along with all instances associated with the group, without waiting for all instances to be terminated. This parameter also deletes any lifecycle actions associated with the group.

" - } - } - }, - "DeleteLifecycleHookAnswer":{ - "type":"structure", - "members":{ - } - }, - "DeleteLifecycleHookType":{ - "type":"structure", - "required":[ - "LifecycleHookName", - "AutoScalingGroupName" - ], - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - } - } - }, - "DeleteNotificationConfigurationType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "TopicARN" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "TopicARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic.

" - } - } - }, - "DeletePolicyType":{ - "type":"structure", - "required":["PolicyName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "PolicyName":{ - "shape":"ResourceName", - "documentation":"

The name or Amazon Resource Name (ARN) of the policy.

" - } - } - }, - "DeleteScheduledActionType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "ScheduledActionName" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ScheduledActionName":{ - "shape":"ResourceName", - "documentation":"

The name of the action to delete.

" - } - } - }, - "DeleteTagsType":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - } - } - }, - "DescribeAccountLimitsAnswer":{ - "type":"structure", - "members":{ - "MaxNumberOfAutoScalingGroups":{ - "shape":"MaxNumberOfAutoScalingGroups", - "documentation":"

The maximum number of groups allowed for your AWS account. The default limit is 20 per region.

" - }, - "MaxNumberOfLaunchConfigurations":{ - "shape":"MaxNumberOfLaunchConfigurations", - "documentation":"

The maximum number of launch configurations allowed for your AWS account. The default limit is 100 per region.

" - }, - "NumberOfAutoScalingGroups":{ - "shape":"NumberOfAutoScalingGroups", - "documentation":"

The current number of groups for your AWS account.

" - }, - "NumberOfLaunchConfigurations":{ - "shape":"NumberOfLaunchConfigurations", - "documentation":"

The current number of launch configurations for your AWS account.

" - } - } - }, - "DescribeAdjustmentTypesAnswer":{ - "type":"structure", - "members":{ - "AdjustmentTypes":{ - "shape":"AdjustmentTypes", - "documentation":"

The policy adjustment types.

" - } - } - }, - "DescribeAutoScalingInstancesType":{ - "type":"structure", - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

The instances to describe; up to 50 instance IDs. If you omit this parameter, all Auto Scaling instances are described. If you specify an ID that does not exist, it is ignored with no error.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 50.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeAutoScalingNotificationTypesAnswer":{ - "type":"structure", - "members":{ - "AutoScalingNotificationTypes":{ - "shape":"AutoScalingNotificationTypes", - "documentation":"

The notification types.

" - } - } - }, - "DescribeLifecycleHookTypesAnswer":{ - "type":"structure", - "members":{ - "LifecycleHookTypes":{ - "shape":"AutoScalingNotificationTypes", - "documentation":"

The lifecycle hook types.

" - } - } - }, - "DescribeLifecycleHooksAnswer":{ - "type":"structure", - "members":{ - "LifecycleHooks":{ - "shape":"LifecycleHooks", - "documentation":"

The lifecycle hooks for the specified group.

" - } - } - }, - "DescribeLifecycleHooksType":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LifecycleHookNames":{ - "shape":"LifecycleHookNames", - "documentation":"

The names of one or more lifecycle hooks. If you omit this parameter, all lifecycle hooks are described.

" - } - } - }, - "DescribeLoadBalancerTargetGroupsRequest":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 100 and the maximum value is 100.

" - } - } - }, - "DescribeLoadBalancerTargetGroupsResponse":{ - "type":"structure", - "members":{ - "LoadBalancerTargetGroups":{ - "shape":"LoadBalancerTargetGroupStates", - "documentation":"

Information about the target groups.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeLoadBalancersRequest":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 100 and the maximum value is 100.

" - } - } - }, - "DescribeLoadBalancersResponse":{ - "type":"structure", - "members":{ - "LoadBalancers":{ - "shape":"LoadBalancerStates", - "documentation":"

The load balancers.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMetricCollectionTypesAnswer":{ - "type":"structure", - "members":{ - "Metrics":{ - "shape":"MetricCollectionTypes", - "documentation":"

One or more metrics.

" - }, - "Granularities":{ - "shape":"MetricGranularityTypes", - "documentation":"

The granularities for the metrics.

" - } - } - }, - "DescribeNotificationConfigurationsAnswer":{ - "type":"structure", - "required":["NotificationConfigurations"], - "members":{ - "NotificationConfigurations":{ - "shape":"NotificationConfigurations", - "documentation":"

The notification configurations.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeNotificationConfigurationsType":{ - "type":"structure", - "members":{ - "AutoScalingGroupNames":{ - "shape":"AutoScalingGroupNames", - "documentation":"

The name of the Auto Scaling group.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "DescribePoliciesType":{ - "type":"structure", - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The names of one or more policies. If you omit this parameter, all policies are described. If an group name is provided, the results are limited to that group. This list is limited to 50 items. If you specify an unknown policy name, it is ignored with no error.

" - }, - "PolicyTypes":{ - "shape":"PolicyTypes", - "documentation":"

One or more policy types. Valid values are SimpleScaling and StepScaling.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to be returned with each call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "DescribeScalingActivitiesType":{ - "type":"structure", - "members":{ - "ActivityIds":{ - "shape":"ActivityIds", - "documentation":"

The activity IDs of the desired scaling activities. If you omit this parameter, all activities for the past six weeks are described. If you specify an Auto Scaling group, the results are limited to that group. The list of requested activities cannot contain more than 50 items. If unknown activities are requested, they are ignored with no error.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 100 and the maximum value is 100.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeScheduledActionsType":{ - "type":"structure", - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ScheduledActionNames":{ - "shape":"ScheduledActionNames", - "documentation":"

Describes one or more scheduled actions. If you omit this parameter, all scheduled actions are described. If you specify an unknown scheduled action, it is ignored with no error.

You can describe up to a maximum of 50 instances with a single call. If there are more items to return, the call returns a token. To get the next set of items, repeat the call with the returned token.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The earliest scheduled start time to return. If scheduled action names are provided, this parameter is ignored.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The latest scheduled start time to return. If scheduled action names are provided, this parameter is ignored.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "DescribeTagsType":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"Filters", - "documentation":"

A filter used to scope the tags to return.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "DescribeTerminationPolicyTypesAnswer":{ - "type":"structure", - "members":{ - "TerminationPolicyTypes":{ - "shape":"TerminationPolicies", - "documentation":"

The termination policies supported by Auto Scaling (OldestInstance, OldestLaunchConfiguration, NewestInstance, ClosestToNextInstanceHour, and Default).

" - } - } - }, - "DetachInstancesAnswer":{ - "type":"structure", - "members":{ - "Activities":{ - "shape":"Activities", - "documentation":"

The activities related to detaching the instances from the Auto Scaling group.

" - } - } - }, - "DetachInstancesQuery":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "ShouldDecrementDesiredCapacity" - ], - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

The IDs of the instances. You can specify up to 20 instances.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ShouldDecrementDesiredCapacity":{ - "shape":"ShouldDecrementDesiredCapacity", - "documentation":"

Indicates whether the Auto Scaling group decrements the desired capacity value by the number of instances detached.

" - } - } - }, - "DetachLoadBalancerTargetGroupsResultType":{ - "type":"structure", - "members":{ - } - }, - "DetachLoadBalancerTargetGroupsType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "TargetGroupARNs" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "TargetGroupARNs":{ - "shape":"TargetGroupARNs", - "documentation":"

The Amazon Resource Names (ARN) of the target groups. You can specify up to 10 target groups.

" - } - } - }, - "DetachLoadBalancersResultType":{ - "type":"structure", - "members":{ - } - }, - "DetachLoadBalancersType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "LoadBalancerNames" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

The names of the load balancers. You can specify up to 10 load balancers.

" - } - } - }, - "DisableMetricsCollectionQuery":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "Metrics":{ - "shape":"Metrics", - "documentation":"

One or more of the following metrics. If you omit this parameter, all metrics are disabled.

  • GroupMinSize

  • GroupMaxSize

  • GroupDesiredCapacity

  • GroupInServiceInstances

  • GroupPendingInstances

  • GroupStandbyInstances

  • GroupTerminatingInstances

  • GroupTotalInstances

" - } - } - }, - "DisableScaleIn":{"type":"boolean"}, - "Ebs":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"BlockDeviceEbsVolumeSize", - "documentation":"

The volume size, in GiB. For standard volumes, specify a value from 1 to 1,024. For io1 volumes, specify a value from 4 to 16,384. For gp2 volumes, specify a value from 1 to 16,384. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you create a volume from a snapshot and you don't specify a volume size, the default is the snapshot size.

" - }, - "VolumeType":{ - "shape":"BlockDeviceEbsVolumeType", - "documentation":"

The volume type. For more information, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Valid values: standard | io1 | gp2

Default: standard

" - }, - "DeleteOnTermination":{ - "shape":"BlockDeviceEbsDeleteOnTermination", - "documentation":"

Indicates whether the volume is deleted on instance termination. The default is true.

" - }, - "Iops":{ - "shape":"BlockDeviceEbsIops", - "documentation":"

The number of I/O operations per second (IOPS) to provision for the volume.

Constraint: Required when the volume type is io1.

" - }, - "Encrypted":{ - "shape":"BlockDeviceEbsEncrypted", - "documentation":"

Indicates whether the volume should be encrypted. Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or an unencrypted volume from an encrypted snapshot. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "documentation":"

Describes an Amazon EBS volume.

" - }, - "EbsOptimized":{"type":"boolean"}, - "EnableMetricsCollectionQuery":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "Granularity" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "Metrics":{ - "shape":"Metrics", - "documentation":"

One or more of the following metrics. If you omit this parameter, all metrics are enabled.

  • GroupMinSize

  • GroupMaxSize

  • GroupDesiredCapacity

  • GroupInServiceInstances

  • GroupPendingInstances

  • GroupStandbyInstances

  • GroupTerminatingInstances

  • GroupTotalInstances

" - }, - "Granularity":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The granularity to associate with the metrics to collect. The only valid value is 1Minute.

" - } - } - }, - "EnabledMetric":{ - "type":"structure", - "members":{ - "Metric":{ - "shape":"XmlStringMaxLen255", - "documentation":"

One of the following metrics:

  • GroupMinSize

  • GroupMaxSize

  • GroupDesiredCapacity

  • GroupInServiceInstances

  • GroupPendingInstances

  • GroupStandbyInstances

  • GroupTerminatingInstances

  • GroupTotalInstances

" - }, - "Granularity":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The granularity of the metric. The only valid value is 1Minute.

" - } - }, - "documentation":"

Describes an enabled metric.

" - }, - "EnabledMetrics":{ - "type":"list", - "member":{"shape":"EnabledMetric"} - }, - "EnterStandbyAnswer":{ - "type":"structure", - "members":{ - "Activities":{ - "shape":"Activities", - "documentation":"

The activities related to moving instances into Standby mode.

" - } - } - }, - "EnterStandbyQuery":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "ShouldDecrementDesiredCapacity" - ], - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

The IDs of the instances. You can specify up to 20 instances.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ShouldDecrementDesiredCapacity":{ - "shape":"ShouldDecrementDesiredCapacity", - "documentation":"

Indicates whether to decrement the desired capacity of the Auto Scaling group by the number of instances moved to Standby mode.

" - } - } - }, - "EstimatedInstanceWarmup":{"type":"integer"}, - "ExecutePolicyType":{ - "type":"structure", - "required":["PolicyName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "PolicyName":{ - "shape":"ResourceName", - "documentation":"

The name or ARN of the policy.

" - }, - "HonorCooldown":{ - "shape":"HonorCooldown", - "documentation":"

Indicates whether Auto Scaling waits for the cooldown period to complete before executing the policy.

This parameter is not supported if the policy type is StepScaling.

For more information, see Auto Scaling Cooldowns in the Auto Scaling User Guide.

" - }, - "MetricValue":{ - "shape":"MetricScale", - "documentation":"

The metric value to compare to BreachThreshold. This enables you to execute a policy of type StepScaling and determine which step adjustment to use. For example, if the breach threshold is 50 and you want to use a step adjustment with a lower bound of 0 and an upper bound of 10, you can set the metric value to 59.

If you specify a metric value that doesn't correspond to a step adjustment for the policy, the call returns an error.

This parameter is required if the policy type is StepScaling and not supported otherwise.

" - }, - "BreachThreshold":{ - "shape":"MetricScale", - "documentation":"

The breach threshold for the alarm.

This parameter is required if the policy type is StepScaling and not supported otherwise.

" - } - } - }, - "ExitStandbyAnswer":{ - "type":"structure", - "members":{ - "Activities":{ - "shape":"Activities", - "documentation":"

The activities related to moving instances out of Standby mode.

" - } - } - }, - "ExitStandbyQuery":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

The IDs of the instances. You can specify up to 20 instances.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - } - } - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the filter. The valid values are: \"auto-scaling-group\", \"key\", \"value\", and \"propagate-at-launch\".

" - }, - "Values":{ - "shape":"Values", - "documentation":"

The value of the filter.

" - } - }, - "documentation":"

Describes a filter.

" - }, - "Filters":{ - "type":"list", - "member":{"shape":"Filter"} - }, - "ForceDelete":{"type":"boolean"}, - "GlobalTimeout":{"type":"integer"}, - "HealthCheckGracePeriod":{"type":"integer"}, - "HeartbeatTimeout":{"type":"integer"}, - "HonorCooldown":{"type":"boolean"}, - "Instance":{ - "type":"structure", - "required":[ - "InstanceId", - "AvailabilityZone", - "LifecycleState", - "HealthStatus", - "ProtectedFromScaleIn" - ], - "members":{ - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - }, - "AvailabilityZone":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The Availability Zone in which the instance is running.

" - }, - "LifecycleState":{ - "shape":"LifecycleState", - "documentation":"

A description of the current lifecycle state. Note that the Quarantined state is not used.

" - }, - "HealthStatus":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The last reported health status of the instance. \"Healthy\" means that the instance is healthy and should remain in service. \"Unhealthy\" means that the instance is unhealthy and Auto Scaling should terminate and replace it.

" - }, - "LaunchConfigurationName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The launch configuration associated with the instance.

" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template for the instance.

" - }, - "ProtectedFromScaleIn":{ - "shape":"InstanceProtected", - "documentation":"

Indicates whether the instance is protected from termination by Auto Scaling when scaling in.

" - } - }, - "documentation":"

Describes an EC2 instance.

" - }, - "InstanceIds":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen19"} - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"MonitoringEnabled", - "documentation":"

If true, detailed monitoring is enabled. Otherwise, basic monitoring is enabled.

" - } - }, - "documentation":"

Describes whether detailed monitoring is enabled for the Auto Scaling instances.

" - }, - "InstanceProtected":{"type":"boolean"}, - "Instances":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InvalidNextToken":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

The NextToken value is not valid.

", - "error":{ - "code":"InvalidNextToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LaunchConfiguration":{ - "type":"structure", - "required":[ - "LaunchConfigurationName", - "ImageId", - "InstanceType", - "CreatedTime" - ], - "members":{ - "LaunchConfigurationName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the launch configuration.

" - }, - "LaunchConfigurationARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the launch configuration.

" - }, - "ImageId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the Amazon Machine Image (AMI).

" - }, - "KeyName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the key pair.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The security groups to associate with the instances.

" - }, - "ClassicLinkVPCId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter can only be used if you are launching EC2-Classic instances. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ClassicLinkVPCSecurityGroups":{ - "shape":"ClassicLinkVPCSecurityGroups", - "documentation":"

The IDs of one or more security groups for the VPC specified in ClassicLinkVPCId. This parameter is required if you specify a ClassicLink-enabled VPC, and cannot be used otherwise. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UserData":{ - "shape":"XmlStringUserData", - "documentation":"

The user data available to the instances.

" - }, - "InstanceType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The instance type for the instances.

" - }, - "KernelId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the kernel associated with the AMI.

" - }, - "RamdiskId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the RAM disk associated with the AMI.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappings", - "documentation":"

A block device mapping, which specifies the block devices for the instance.

" - }, - "InstanceMonitoring":{ - "shape":"InstanceMonitoring", - "documentation":"

Controls whether instances in this group are launched with detailed (true) or basic (false) monitoring.

" - }, - "SpotPrice":{ - "shape":"SpotPrice", - "documentation":"

The price to bid when launching Spot Instances.

" - }, - "IamInstanceProfile":{ - "shape":"XmlStringMaxLen1600", - "documentation":"

The name or Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.

" - }, - "CreatedTime":{ - "shape":"TimestampType", - "documentation":"

The creation date and time for the launch configuration.

" - }, - "EbsOptimized":{ - "shape":"EbsOptimized", - "documentation":"

Controls whether the instance is optimized for EBS I/O (true) or not (false).

" - }, - "AssociatePublicIpAddress":{ - "shape":"AssociatePublicIpAddress", - "documentation":"

[EC2-VPC] Indicates whether to assign a public IP address to each instance.

" - }, - "PlacementTenancy":{ - "shape":"XmlStringMaxLen64", - "documentation":"

The tenancy of the instance, either default or dedicated. An instance with dedicated tenancy runs in an isolated, single-tenant hardware and can only be launched into a VPC.

" - } - }, - "documentation":"

Describes a launch configuration.

" - }, - "LaunchConfigurationNameType":{ - "type":"structure", - "required":["LaunchConfigurationName"], - "members":{ - "LaunchConfigurationName":{ - "shape":"ResourceName", - "documentation":"

The name of the launch configuration.

" - } - } - }, - "LaunchConfigurationNames":{ - "type":"list", - "member":{"shape":"ResourceName"} - }, - "LaunchConfigurationNamesType":{ - "type":"structure", - "members":{ - "LaunchConfigurationNames":{ - "shape":"LaunchConfigurationNames", - "documentation":"

The launch configuration names. If you omit this parameter, all launch configurations are described.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.

" - } - } - }, - "LaunchConfigurations":{ - "type":"list", - "member":{"shape":"LaunchConfiguration"} - }, - "LaunchConfigurationsType":{ - "type":"structure", - "required":["LaunchConfigurations"], - "members":{ - "LaunchConfigurations":{ - "shape":"LaunchConfigurations", - "documentation":"

The launch configurations.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "LaunchTemplateName":{ - "type":"string", - "max":128, - "min":3, - "pattern":"[a-zA-Z0-9\\(\\)\\.-/_]+" - }, - "LaunchTemplateSpecification":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The ID of the launch template. You must specify either a template ID or a template name.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either a template name or a template ID.

" - }, - "Version":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The version number, $Latest, or $Default. If the value is $Latest, Auto Scaling selects the latest version of the launch template when launching instances. If the value is $Default, Auto Scaling selects the default version of the launch template when launching instances. The default value is $Default.

" - } - }, - "documentation":"

Describes a launch template.

" - }, - "LifecycleActionResult":{"type":"string"}, - "LifecycleActionToken":{ - "type":"string", - "max":36, - "min":36 - }, - "LifecycleHook":{ - "type":"structure", - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group for the lifecycle hook.

" - }, - "LifecycleTransition":{ - "shape":"LifecycleTransition", - "documentation":"

The state of the EC2 instance to which you want to attach the lifecycle hook. For a list of lifecycle hook types, see DescribeLifecycleHookTypes.

" - }, - "NotificationTargetARN":{ - "shape":"ResourceName", - "documentation":"

The ARN of the target that Auto Scaling sends notifications to when an instance is in the transition state for the lifecycle hook. The notification target can be either an SQS queue or an SNS topic.

" - }, - "RoleARN":{ - "shape":"ResourceName", - "documentation":"

The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target.

" - }, - "NotificationMetadata":{ - "shape":"XmlStringMaxLen1023", - "documentation":"

Additional information that you want to include any time Auto Scaling sends a message to the notification target.

" - }, - "HeartbeatTimeout":{ - "shape":"HeartbeatTimeout", - "documentation":"

The maximum time, in seconds, that can elapse before the lifecycle hook times out. If the lifecycle hook times out, Auto Scaling performs the default action. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.

" - }, - "GlobalTimeout":{ - "shape":"GlobalTimeout", - "documentation":"

The maximum time, in seconds, that an instance can remain in a Pending:Wait or Terminating:Wait state. The maximum is 172800 seconds (48 hours) or 100 times HeartbeatTimeout, whichever is smaller.

" - }, - "DefaultResult":{ - "shape":"LifecycleActionResult", - "documentation":"

Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The valid values are CONTINUE and ABANDON. The default value is CONTINUE.

" - } - }, - "documentation":"

Describes a lifecycle hook, which tells Auto Scaling that you want to perform an action whenever it launches instances or whenever it terminates instances.

For more information, see Auto Scaling Lifecycle Hooks in the Auto Scaling User Guide.

" - }, - "LifecycleHookNames":{ - "type":"list", - "member":{"shape":"AsciiStringMaxLen255"}, - "max":50 - }, - "LifecycleHookSpecification":{ - "type":"structure", - "required":[ - "LifecycleHookName", - "LifecycleTransition" - ], - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "LifecycleTransition":{ - "shape":"LifecycleTransition", - "documentation":"

The state of the EC2 instance to which you want to attach the lifecycle hook. For a list of lifecycle hook types, see DescribeLifecycleHookTypes.

" - }, - "NotificationMetadata":{ - "shape":"XmlStringMaxLen1023", - "documentation":"

Additional information that you want to include any time Auto Scaling sends a message to the notification target.

" - }, - "HeartbeatTimeout":{ - "shape":"HeartbeatTimeout", - "documentation":"

The maximum time, in seconds, that can elapse before the lifecycle hook times out. If the lifecycle hook times out, Auto Scaling performs the default action. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.

" - }, - "DefaultResult":{ - "shape":"LifecycleActionResult", - "documentation":"

Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The valid values are CONTINUE and ABANDON.

" - }, - "NotificationTargetARN":{ - "shape":"NotificationTargetResourceName", - "documentation":"

The ARN of the target that Auto Scaling sends notifications to when an instance is in the transition state for the lifecycle hook. The notification target can be either an SQS queue or an SNS topic.

" - }, - "RoleARN":{ - "shape":"ResourceName", - "documentation":"

The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target.

" - } - }, - "documentation":"

Describes a lifecycle hook, which tells Auto Scaling that you want to perform an action whenever it launches instances or whenever it terminates instances.

For more information, see Auto Scaling Lifecycle Hooks in the Auto Scaling User Guide.

" - }, - "LifecycleHookSpecifications":{ - "type":"list", - "member":{"shape":"LifecycleHookSpecification"} - }, - "LifecycleHooks":{ - "type":"list", - "member":{"shape":"LifecycleHook"} - }, - "LifecycleState":{ - "type":"string", - "enum":[ - "Pending", - "Pending:Wait", - "Pending:Proceed", - "Quarantined", - "InService", - "Terminating", - "Terminating:Wait", - "Terminating:Proceed", - "Terminated", - "Detaching", - "Detached", - "EnteringStandby", - "Standby" - ] - }, - "LifecycleTransition":{"type":"string"}, - "LimitExceededFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LoadBalancerNames":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"} - }, - "LoadBalancerState":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the load balancer.

" - }, - "State":{ - "shape":"XmlStringMaxLen255", - "documentation":"

One of the following load balancer states:

  • Adding - The instances in the group are being registered with the load balancer.

  • Added - All instances in the group are registered with the load balancer.

  • InService - At least one instance in the group passed an ELB health check.

  • Removing - The instances in the group are being deregistered from the load balancer. If connection draining is enabled, Elastic Load Balancing waits for in-flight requests to complete before deregistering the instances.

  • Removed - All instances in the group are deregistered from the load balancer.

" - } - }, - "documentation":"

Describes the state of a Classic Load Balancer.

If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is InService.

If you attach a load balancer to an existing Auto Scaling group, the initial state is Adding. The state transitions to Added after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to InService after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the Added state.

" - }, - "LoadBalancerStates":{ - "type":"list", - "member":{"shape":"LoadBalancerState"} - }, - "LoadBalancerTargetGroupState":{ - "type":"structure", - "members":{ - "LoadBalancerTargetGroupARN":{ - "shape":"XmlStringMaxLen511", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "State":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The state of the target group.

  • Adding - The Auto Scaling instances are being registered with the target group.

  • Added - All Auto Scaling instances are registered with the target group.

  • InService - At least one Auto Scaling instance passed an ELB health check.

  • Removing - The Auto Scaling instances are being deregistered from the target group. If connection draining is enabled, Elastic Load Balancing waits for in-flight requests to complete before deregistering the instances.

  • Removed - All Auto Scaling instances are deregistered from the target group.

" - } - }, - "documentation":"

Describes the state of a target group.

If you attach a target group to an existing Auto Scaling group, the initial state is Adding. The state transitions to Added after all Auto Scaling instances are registered with the target group. If ELB health checks are enabled, the state transitions to InService after at least one Auto Scaling instance passes the health check. If EC2 health checks are enabled instead, the target group remains in the Added state.

" - }, - "LoadBalancerTargetGroupStates":{ - "type":"list", - "member":{"shape":"LoadBalancerTargetGroupState"} - }, - "MaxNumberOfAutoScalingGroups":{"type":"integer"}, - "MaxNumberOfLaunchConfigurations":{"type":"integer"}, - "MaxRecords":{"type":"integer"}, - "MetricCollectionType":{ - "type":"structure", - "members":{ - "Metric":{ - "shape":"XmlStringMaxLen255", - "documentation":"

One of the following metrics:

  • GroupMinSize

  • GroupMaxSize

  • GroupDesiredCapacity

  • GroupInServiceInstances

  • GroupPendingInstances

  • GroupStandbyInstances

  • GroupTerminatingInstances

  • GroupTotalInstances

" - } - }, - "documentation":"

Describes a metric.

" - }, - "MetricCollectionTypes":{ - "type":"list", - "member":{"shape":"MetricCollectionType"} - }, - "MetricDimension":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"MetricDimensionName", - "documentation":"

The name of the dimension.

" - }, - "Value":{ - "shape":"MetricDimensionValue", - "documentation":"

The value of the dimension.

" - } - }, - "documentation":"

Describes the dimension of a metric.

" - }, - "MetricDimensionName":{"type":"string"}, - "MetricDimensionValue":{"type":"string"}, - "MetricDimensions":{ - "type":"list", - "member":{"shape":"MetricDimension"} - }, - "MetricGranularityType":{ - "type":"structure", - "members":{ - "Granularity":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The granularity. The only valid value is 1Minute.

" - } - }, - "documentation":"

Describes a granularity of a metric.

" - }, - "MetricGranularityTypes":{ - "type":"list", - "member":{"shape":"MetricGranularityType"} - }, - "MetricName":{"type":"string"}, - "MetricNamespace":{"type":"string"}, - "MetricScale":{"type":"double"}, - "MetricStatistic":{ - "type":"string", - "enum":[ - "Average", - "Minimum", - "Maximum", - "SampleCount", - "Sum" - ] - }, - "MetricType":{ - "type":"string", - "enum":[ - "ASGAverageCPUUtilization", - "ASGAverageNetworkIn", - "ASGAverageNetworkOut", - "ALBRequestCountPerTarget" - ] - }, - "MetricUnit":{"type":"string"}, - "Metrics":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"} - }, - "MinAdjustmentMagnitude":{"type":"integer"}, - "MinAdjustmentStep":{ - "type":"integer", - "deprecated":true - }, - "MonitoringEnabled":{"type":"boolean"}, - "NoDevice":{"type":"boolean"}, - "NotificationConfiguration":{ - "type":"structure", - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "TopicARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic.

" - }, - "NotificationType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

One of the following event notification types:

  • autoscaling:EC2_INSTANCE_LAUNCH

  • autoscaling:EC2_INSTANCE_LAUNCH_ERROR

  • autoscaling:EC2_INSTANCE_TERMINATE

  • autoscaling:EC2_INSTANCE_TERMINATE_ERROR

  • autoscaling:TEST_NOTIFICATION

" - } - }, - "documentation":"

Describes a notification.

" - }, - "NotificationConfigurations":{ - "type":"list", - "member":{"shape":"NotificationConfiguration"} - }, - "NotificationTargetResourceName":{ - "type":"string", - "max":1600, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "NumberOfAutoScalingGroups":{"type":"integer"}, - "NumberOfLaunchConfigurations":{"type":"integer"}, - "PoliciesType":{ - "type":"structure", - "members":{ - "ScalingPolicies":{ - "shape":"ScalingPolicies", - "documentation":"

The scaling policies.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "PolicyARNType":{ - "type":"structure", - "members":{ - "PolicyARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the policy.

" - }, - "Alarms":{ - "shape":"Alarms", - "documentation":"

The CloudWatch alarms created for the target tracking policy.

" - } - }, - "documentation":"

Contains the output of PutScalingPolicy.

" - }, - "PolicyIncrement":{"type":"integer"}, - "PolicyNames":{ - "type":"list", - "member":{"shape":"ResourceName"} - }, - "PolicyTypes":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen64"} - }, - "PredefinedMetricSpecification":{ - "type":"structure", - "required":["PredefinedMetricType"], - "members":{ - "PredefinedMetricType":{ - "shape":"MetricType", - "documentation":"

The metric type.

" - }, - "ResourceLabel":{ - "shape":"XmlStringMaxLen1023", - "documentation":"

Identifies the resource associated with the metric type. The following predefined metrics are available:

  • ASGAverageCPUUtilization - average CPU utilization of the Auto Scaling group

  • ASGAverageNetworkIn - average number of bytes received on all network interfaces by the Auto Scaling group

  • ASGAverageNetworkOut - average number of bytes sent out on all network interfaces by the Auto Scaling group

  • ALBRequestCountPerTarget - number of requests completed per target in an Application Load Balancer target group

For predefined metric types ASGAverageCPUUtilization, ASGAverageNetworkIn, and ASGAverageNetworkOut, the parameter must not be specified as the resource associated with the metric type is the Auto Scaling group. For predefined metric type ALBRequestCountPerTarget, the parameter must be specified in the format: app/load-balancer-name/load-balancer-id/targetgroup/target-group-name/target-group-id , where app/load-balancer-name/load-balancer-id is the final portion of the load balancer ARN, and targetgroup/target-group-name/target-group-id is the final portion of the target group ARN. The target group must be attached to the Auto Scaling group.

" - } - }, - "documentation":"

Configures a predefined metric for a target tracking policy.

" - }, - "ProcessNames":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen255"} - }, - "ProcessType":{ - "type":"structure", - "required":["ProcessName"], - "members":{ - "ProcessName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

One of the following processes:

  • Launch

  • Terminate

  • AddToLoadBalancer

  • AlarmNotification

  • AZRebalance

  • HealthCheck

  • ReplaceUnhealthy

  • ScheduledActions

" - } - }, - "documentation":"

Describes a process type.

For more information, see Auto Scaling Processes in the Auto Scaling User Guide.

" - }, - "Processes":{ - "type":"list", - "member":{"shape":"ProcessType"} - }, - "ProcessesType":{ - "type":"structure", - "members":{ - "Processes":{ - "shape":"Processes", - "documentation":"

The names of the process types.

" - } - } - }, - "Progress":{"type":"integer"}, - "PropagateAtLaunch":{"type":"boolean"}, - "ProtectedFromScaleIn":{"type":"boolean"}, - "PutLifecycleHookAnswer":{ - "type":"structure", - "members":{ - } - }, - "PutLifecycleHookType":{ - "type":"structure", - "required":[ - "LifecycleHookName", - "AutoScalingGroupName" - ], - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LifecycleTransition":{ - "shape":"LifecycleTransition", - "documentation":"

The instance state to which you want to attach the lifecycle hook. For a list of lifecycle hook types, see DescribeLifecycleHookTypes.

This parameter is required for new lifecycle hooks, but optional when updating existing hooks.

" - }, - "RoleARN":{ - "shape":"ResourceName", - "documentation":"

The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target.

This parameter is required for new lifecycle hooks, but optional when updating existing hooks.

" - }, - "NotificationTargetARN":{ - "shape":"NotificationTargetResourceName", - "documentation":"

The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This target can be either an SQS queue or an SNS topic. If you specify an empty string, this overrides the current ARN.

This operation uses the JSON format when sending notifications to an Amazon SQS queue, and an email key/value pair format when sending notifications to an Amazon SNS topic.

When you specify a notification target, Auto Scaling sends it a test message. Test messages contains the following additional key/value pair: \"Event\": \"autoscaling:TEST_NOTIFICATION\".

" - }, - "NotificationMetadata":{ - "shape":"XmlStringMaxLen1023", - "documentation":"

Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.

" - }, - "HeartbeatTimeout":{ - "shape":"HeartbeatTimeout", - "documentation":"

The maximum time, in seconds, that can elapse before the lifecycle hook times out. The range is from 30 to 7200 seconds. The default is 3600 seconds (1 hour).

If the lifecycle hook times out, Auto Scaling performs the default action. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.

" - }, - "DefaultResult":{ - "shape":"LifecycleActionResult", - "documentation":"

Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. This parameter can be either CONTINUE or ABANDON. The default value is ABANDON.

" - } - } - }, - "PutNotificationConfigurationType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "TopicARN", - "NotificationTypes" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "TopicARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic.

" - }, - "NotificationTypes":{ - "shape":"AutoScalingNotificationTypes", - "documentation":"

The type of event that will cause the notification to be sent. For details about notification types supported by Auto Scaling, see DescribeAutoScalingNotificationTypes.

" - } - } - }, - "PutScalingPolicyType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "PolicyName" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "PolicyName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the policy.

" - }, - "PolicyType":{ - "shape":"XmlStringMaxLen64", - "documentation":"

The policy type. The valid values are SimpleScaling, StepScaling, and TargetTrackingScaling. If the policy type is null, the value is treated as SimpleScaling.

" - }, - "AdjustmentType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The adjustment type. The valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.

This parameter is supported if the policy type is SimpleScaling or StepScaling.

For more information, see Dynamic Scaling in the Auto Scaling User Guide.

" - }, - "MinAdjustmentStep":{ - "shape":"MinAdjustmentStep", - "documentation":"

Available for backward compatibility. Use MinAdjustmentMagnitude instead.

" - }, - "MinAdjustmentMagnitude":{ - "shape":"MinAdjustmentMagnitude", - "documentation":"

The minimum number of instances to scale. If the value of AdjustmentType is PercentChangeInCapacity, the scaling policy changes the DesiredCapacity of the Auto Scaling group by at least this many instances. Otherwise, the error is ValidationError.

This parameter is supported if the policy type is SimpleScaling or StepScaling.

" - }, - "ScalingAdjustment":{ - "shape":"PolicyIncrement", - "documentation":"

The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.

This parameter is required if the policy type is SimpleScaling and not supported otherwise.

" - }, - "Cooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes and before the next scaling activity can start. If this parameter is not specified, the default cooldown period for the group applies.

This parameter is supported if the policy type is SimpleScaling.

For more information, see Auto Scaling Cooldowns in the Auto Scaling User Guide.

" - }, - "MetricAggregationType":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The aggregation type for the CloudWatch metrics. The valid values are Minimum, Maximum, and Average. If the aggregation type is null, the value is treated as Average.

This parameter is supported if the policy type is StepScaling.

" - }, - "StepAdjustments":{ - "shape":"StepAdjustments", - "documentation":"

A set of adjustments that enable you to scale based on the size of the alarm breach.

This parameter is required if the policy type is StepScaling and not supported otherwise.

" - }, - "EstimatedInstanceWarmup":{ - "shape":"EstimatedInstanceWarmup", - "documentation":"

The estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics. The default is to use the value specified for the default cooldown period for the group.

This parameter is supported if the policy type is StepScaling or TargetTrackingScaling.

" - }, - "TargetTrackingConfiguration":{ - "shape":"TargetTrackingConfiguration", - "documentation":"

A target tracking policy.

This parameter is required if the policy type is TargetTrackingScaling and not supported otherwise.

" - } - } - }, - "PutScheduledUpdateGroupActionType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "ScheduledActionName" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ScheduledActionName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of this scaling action.

" - }, - "Time":{ - "shape":"TimestampType", - "documentation":"

This parameter is deprecated.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The time for this action to start, in \"YYYY-MM-DDThh:mm:ssZ\" format in UTC/GMT only (for example, 2014-06-01T00:00:00Z).

If you specify Recurrence and StartTime, Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.

If you try to schedule your action in the past, Auto Scaling returns an error message.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The time for the recurring schedule to end. Auto Scaling does not perform the action after this time.

" - }, - "Recurrence":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The recurring schedule for this action, in Unix cron syntax format. For more information, see Cron in Wikipedia.

" - }, - "MinSize":{ - "shape":"AutoScalingGroupMinSize", - "documentation":"

The minimum size for the Auto Scaling group.

" - }, - "MaxSize":{ - "shape":"AutoScalingGroupMaxSize", - "documentation":"

The maximum size for the Auto Scaling group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The number of EC2 instances that should be running in the group.

" - } - } - }, - "RecordLifecycleActionHeartbeatAnswer":{ - "type":"structure", - "members":{ - } - }, - "RecordLifecycleActionHeartbeatType":{ - "type":"structure", - "required":[ - "LifecycleHookName", - "AutoScalingGroupName" - ], - "members":{ - "LifecycleHookName":{ - "shape":"AsciiStringMaxLen255", - "documentation":"

The name of the lifecycle hook.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LifecycleActionToken":{ - "shape":"LifecycleActionToken", - "documentation":"

A token that uniquely identifies a specific lifecycle action associated with an instance. Auto Scaling sends this token to the notification target you specified when you created the lifecycle hook.

" - }, - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - } - } - }, - "ResourceContentionFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

", - "error":{ - "code":"ResourceContention", - "httpStatusCode":500, - "senderFault":true - }, - "exception":true - }, - "ResourceInUseFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

The operation can't be performed because the resource is in use.

", - "error":{ - "code":"ResourceInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ResourceName":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "ScalingActivityInProgressFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"XmlStringMaxLen255", - "documentation":"

" - } - }, - "documentation":"

The operation can't be performed because there are scaling activities in progress.

", - "error":{ - "code":"ScalingActivityInProgress", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ScalingActivityStatusCode":{ - "type":"string", - "enum":[ - "PendingSpotBidPlacement", - "WaitingForSpotInstanceRequestId", - "WaitingForSpotInstanceId", - "WaitingForInstanceId", - "PreInService", - "InProgress", - "WaitingForELBConnectionDraining", - "MidLifecycleAction", - "WaitingForInstanceWarmup", - "Successful", - "Failed", - "Cancelled" - ] - }, - "ScalingPolicies":{ - "type":"list", - "member":{"shape":"ScalingPolicy"} - }, - "ScalingPolicy":{ - "type":"structure", - "members":{ - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group.

" - }, - "PolicyName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the scaling policy.

" - }, - "PolicyARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the policy.

" - }, - "PolicyType":{ - "shape":"XmlStringMaxLen64", - "documentation":"

The policy type. Valid values are SimpleScaling and StepScaling.

" - }, - "AdjustmentType":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The adjustment type, which specifies how ScalingAdjustment is interpreted. Valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.

" - }, - "MinAdjustmentStep":{ - "shape":"MinAdjustmentStep", - "documentation":"

Available for backward compatibility. Use MinAdjustmentMagnitude instead.

" - }, - "MinAdjustmentMagnitude":{ - "shape":"MinAdjustmentMagnitude", - "documentation":"

The minimum number of instances to scale. If the value of AdjustmentType is PercentChangeInCapacity, the scaling policy changes the DesiredCapacity of the Auto Scaling group by at least this many instances. Otherwise, the error is ValidationError.

" - }, - "ScalingAdjustment":{ - "shape":"PolicyIncrement", - "documentation":"

The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.

" - }, - "Cooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes before any further dynamic scaling activities can start.

" - }, - "StepAdjustments":{ - "shape":"StepAdjustments", - "documentation":"

A set of adjustments that enable you to scale based on the size of the alarm breach.

" - }, - "MetricAggregationType":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The aggregation type for the CloudWatch metrics. Valid values are Minimum, Maximum, and Average.

" - }, - "EstimatedInstanceWarmup":{ - "shape":"EstimatedInstanceWarmup", - "documentation":"

The estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics.

" - }, - "Alarms":{ - "shape":"Alarms", - "documentation":"

The CloudWatch alarms related to the policy.

" - }, - "TargetTrackingConfiguration":{ - "shape":"TargetTrackingConfiguration", - "documentation":"

A target tracking policy.

" - } - }, - "documentation":"

Describes a scaling policy.

" - }, - "ScalingProcessQuery":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ScalingProcesses":{ - "shape":"ProcessNames", - "documentation":"

One or more of the following processes. If you omit this parameter, all processes are specified.

  • Launch

  • Terminate

  • HealthCheck

  • ReplaceUnhealthy

  • AZRebalance

  • AlarmNotification

  • ScheduledActions

  • AddToLoadBalancer

" - } - } - }, - "ScheduledActionNames":{ - "type":"list", - "member":{"shape":"ResourceName"} - }, - "ScheduledActionsType":{ - "type":"structure", - "members":{ - "ScheduledUpdateGroupActions":{ - "shape":"ScheduledUpdateGroupActions", - "documentation":"

The scheduled actions.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "ScheduledUpdateGroupAction":{ - "type":"structure", - "members":{ - "AutoScalingGroupName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ScheduledActionName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the scheduled action.

" - }, - "ScheduledActionARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the scheduled action.

" - }, - "Time":{ - "shape":"TimestampType", - "documentation":"

This parameter is deprecated.

" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The date and time that the action is scheduled to begin. This date and time can be up to one month in the future.

When StartTime and EndTime are specified with Recurrence, they form the boundaries of when the recurring action will start and stop.

" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The date and time that the action is scheduled to end. This date and time can be up to one month in the future.

" - }, - "Recurrence":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The recurring schedule for the action.

" - }, - "MinSize":{ - "shape":"AutoScalingGroupMinSize", - "documentation":"

The minimum size of the group.

" - }, - "MaxSize":{ - "shape":"AutoScalingGroupMaxSize", - "documentation":"

The maximum size of the group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The number of instances you prefer to maintain in the group.

" - } - }, - "documentation":"

Describes a scheduled update to an Auto Scaling group.

" - }, - "ScheduledUpdateGroupActions":{ - "type":"list", - "member":{"shape":"ScheduledUpdateGroupAction"} - }, - "SecurityGroups":{ - "type":"list", - "member":{"shape":"XmlString"} - }, - "ServiceLinkedRoleFailure":{ - "type":"structure", - "members":{ - "message":{"shape":"XmlStringMaxLen255"} - }, - "documentation":"

The service-linked role is not yet ready for use.

", - "error":{ - "code":"ServiceLinkedRoleFailure", - "httpStatusCode":500, - "senderFault":true - }, - "exception":true - }, - "SetDesiredCapacityType":{ - "type":"structure", - "required":[ - "AutoScalingGroupName", - "DesiredCapacity" - ], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The number of EC2 instances that should be running in the Auto Scaling group.

" - }, - "HonorCooldown":{ - "shape":"HonorCooldown", - "documentation":"

Indicates whether Auto Scaling waits for the cooldown period to complete before initiating a scaling activity to set your Auto Scaling group to its new capacity. By default, Auto Scaling does not honor the cooldown period during manual scaling activities.

" - } - } - }, - "SetInstanceHealthQuery":{ - "type":"structure", - "required":[ - "InstanceId", - "HealthStatus" - ], - "members":{ - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - }, - "HealthStatus":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The health status of the instance. Set to Healthy if you want the instance to remain in service. Set to Unhealthy if you want the instance to be out of service. Auto Scaling will terminate and replace the unhealthy instance.

" - }, - "ShouldRespectGracePeriod":{ - "shape":"ShouldRespectGracePeriod", - "documentation":"

If the Auto Scaling group of the specified instance has a HealthCheckGracePeriod specified for the group, by default, this call will respect the grace period. Set this to False, if you do not want the call to respect the grace period associated with the group.

For more information, see the description of the health check grace period for CreateAutoScalingGroup.

" - } - } - }, - "SetInstanceProtectionAnswer":{ - "type":"structure", - "members":{ - } - }, - "SetInstanceProtectionQuery":{ - "type":"structure", - "required":[ - "InstanceIds", - "AutoScalingGroupName", - "ProtectedFromScaleIn" - ], - "members":{ - "InstanceIds":{ - "shape":"InstanceIds", - "documentation":"

One or more instance IDs.

" - }, - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "ProtectedFromScaleIn":{ - "shape":"ProtectedFromScaleIn", - "documentation":"

Indicates whether the instance is protected from termination by Auto Scaling when scaling in.

" - } - } - }, - "ShouldDecrementDesiredCapacity":{"type":"boolean"}, - "ShouldRespectGracePeriod":{"type":"boolean"}, - "SpotPrice":{ - "type":"string", - "max":255, - "min":1 - }, - "StepAdjustment":{ - "type":"structure", - "required":["ScalingAdjustment"], - "members":{ - "MetricIntervalLowerBound":{ - "shape":"MetricScale", - "documentation":"

The lower bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the lower bound is inclusive (the metric must be greater than or equal to the threshold plus the lower bound). Otherwise, it is exclusive (the metric must be greater than the threshold plus the lower bound). A null value indicates negative infinity.

" - }, - "MetricIntervalUpperBound":{ - "shape":"MetricScale", - "documentation":"

The upper bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the upper bound is exclusive (the metric must be less than the threshold plus the upper bound). Otherwise, it is inclusive (the metric must be less than or equal to the threshold plus the upper bound). A null value indicates positive infinity.

The upper bound must be greater than the lower bound.

" - }, - "ScalingAdjustment":{ - "shape":"PolicyIncrement", - "documentation":"

The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.

" - } - }, - "documentation":"

Describes an adjustment based on the difference between the value of the aggregated CloudWatch metric and the breach threshold that you've defined for the alarm.

For the following examples, suppose that you have an alarm with a breach threshold of 50:

  • If you want the adjustment to be triggered when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0 and an upper bound of 10.

  • If you want the adjustment to be triggered when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10 and an upper bound of 0.

There are a few rules for the step adjustments for your step policy:

  • The ranges of your step adjustments can't overlap or have a gap.

  • At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.

  • At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.

  • The upper and lower bound can't be null in the same step adjustment.

" - }, - "StepAdjustments":{ - "type":"list", - "member":{"shape":"StepAdjustment"} - }, - "SuspendedProcess":{ - "type":"structure", - "members":{ - "ProcessName":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the suspended process.

" - }, - "SuspensionReason":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The reason that the process was suspended.

" - } - }, - "documentation":"

Describes an Auto Scaling process that has been suspended. For more information, see ProcessType.

" - }, - "SuspendedProcesses":{ - "type":"list", - "member":{"shape":"SuspendedProcess"} - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "ResourceId":{ - "shape":"XmlString", - "documentation":"

The name of the group.

" - }, - "ResourceType":{ - "shape":"XmlString", - "documentation":"

The type of resource. The only supported value is auto-scaling-group.

" - }, - "Key":{ - "shape":"TagKey", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The tag value.

" - }, - "PropagateAtLaunch":{ - "shape":"PropagateAtLaunch", - "documentation":"

Determines whether the tag is added to new instances as they are launched in the group.

" - } - }, - "documentation":"

Describes a tag for an Auto Scaling group.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"XmlString", - "documentation":"

The name of the group.

" - }, - "ResourceType":{ - "shape":"XmlString", - "documentation":"

The type of resource. The only supported value is auto-scaling-group.

" - }, - "Key":{ - "shape":"TagKey", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The tag value.

" - }, - "PropagateAtLaunch":{ - "shape":"PropagateAtLaunch", - "documentation":"

Determines whether the tag is added to new instances as they are launched in the group.

" - } - }, - "documentation":"

Describes a tag for an Auto Scaling group.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{"shape":"TagDescription"} - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagsType":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

One or more tags.

" - }, - "NextToken":{ - "shape":"XmlString", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "TargetGroupARNs":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen511"} - }, - "TargetTrackingConfiguration":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "PredefinedMetricSpecification":{ - "shape":"PredefinedMetricSpecification", - "documentation":"

A predefined metric. You can specify either a predefined metric or a customized metric.

" - }, - "CustomizedMetricSpecification":{ - "shape":"CustomizedMetricSpecification", - "documentation":"

A customized metric.

" - }, - "TargetValue":{ - "shape":"MetricScale", - "documentation":"

The target value for the metric.

" - }, - "DisableScaleIn":{ - "shape":"DisableScaleIn", - "documentation":"

Indicates whether scale in by the target tracking policy is disabled. If scale in is disabled, the target tracking policy won't remove instances from the Auto Scaling group. Otherwise, the target tracking policy can remove instances from the Auto Scaling group. The default is disabled.

" - } - }, - "documentation":"

Represents a target tracking policy configuration.

" - }, - "TerminateInstanceInAutoScalingGroupType":{ - "type":"structure", - "required":[ - "InstanceId", - "ShouldDecrementDesiredCapacity" - ], - "members":{ - "InstanceId":{ - "shape":"XmlStringMaxLen19", - "documentation":"

The ID of the instance.

" - }, - "ShouldDecrementDesiredCapacity":{ - "shape":"ShouldDecrementDesiredCapacity", - "documentation":"

Indicates whether terminating the instance also decrements the size of the Auto Scaling group.

" - } - } - }, - "TerminationPolicies":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen1600"} - }, - "TimestampType":{"type":"timestamp"}, - "UpdateAutoScalingGroupType":{ - "type":"structure", - "required":["AutoScalingGroupName"], - "members":{ - "AutoScalingGroupName":{ - "shape":"ResourceName", - "documentation":"

The name of the Auto Scaling group.

" - }, - "LaunchConfigurationName":{ - "shape":"ResourceName", - "documentation":"

The name of the launch configuration. If you specify a launch configuration, you can't specify a launch template.

" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template to use to specify the updates. If you specify a launch template, you can't specify a launch configuration.

" - }, - "MinSize":{ - "shape":"AutoScalingGroupMinSize", - "documentation":"

The minimum size of the Auto Scaling group.

" - }, - "MaxSize":{ - "shape":"AutoScalingGroupMaxSize", - "documentation":"

The maximum size of the Auto Scaling group.

" - }, - "DesiredCapacity":{ - "shape":"AutoScalingGroupDesiredCapacity", - "documentation":"

The number of EC2 instances that should be running in the Auto Scaling group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group.

" - }, - "DefaultCooldown":{ - "shape":"Cooldown", - "documentation":"

The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.

For more information, see Auto Scaling Cooldowns in the Auto Scaling User Guide.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

One or more Availability Zones for the group.

" - }, - "HealthCheckType":{ - "shape":"XmlStringMaxLen32", - "documentation":"

The service to use for the health checks. The valid values are EC2 and ELB.

" - }, - "HealthCheckGracePeriod":{ - "shape":"HealthCheckGracePeriod", - "documentation":"

The amount of time, in seconds, that Auto Scaling waits before checking the health status of an EC2 instance that has come into service. The default is 0.

For more information, see Health Checks in the Auto Scaling User Guide.

" - }, - "PlacementGroup":{ - "shape":"XmlStringMaxLen255", - "documentation":"

The name of the placement group into which you'll launch your instances, if any. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "VPCZoneIdentifier":{ - "shape":"XmlStringMaxLen2047", - "documentation":"

The ID of the subnet, if you are launching into a VPC. You can specify several subnets in a comma-separated list.

When you specify VPCZoneIdentifier with AvailabilityZones, ensure that the subnets' Availability Zones match the values you specify for AvailabilityZones.

For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.

" - }, - "TerminationPolicies":{ - "shape":"TerminationPolicies", - "documentation":"

A standalone termination policy or a list of termination policies used to select the instance to terminate. The policies are executed in the order that they are listed.

For more information, see Controlling Which Instances Auto Scaling Terminates During Scale In in the Auto Scaling User Guide.

" - }, - "NewInstancesProtectedFromScaleIn":{ - "shape":"InstanceProtected", - "documentation":"

Indicates whether newly launched instances are protected from termination by Auto Scaling when scaling in.

" - }, - "ServiceLinkedRoleARN":{ - "shape":"ResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other AWS services on your behalf.

" - } - } - }, - "Values":{ - "type":"list", - "member":{"shape":"XmlString"} - }, - "XmlString":{ - "type":"string", - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen1023":{ - "type":"string", - "max":1023, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen1600":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen19":{ - "type":"string", - "max":19, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen2047":{ - "type":"string", - "max":2047, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen255":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen32":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen511":{ - "type":"string", - "max":511, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen64":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringUserData":{ - "type":"string", - "max":21847, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - } - }, - "documentation":"Amazon EC2 Auto Scaling

Amazon EC2 Auto Scaling is designed to automatically launch or terminate EC2 instances based on user-defined policies, schedules, and health checks. Use this service in conjunction with the AWS Auto Scaling, Amazon CloudWatch, and Elastic Load Balancing services.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/examples-1.json deleted file mode 100644 index ddaaf42d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/examples-1.json +++ /dev/null @@ -1,589 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CancelJob": [ - { - "input": { - "jobId": "1d828f65-7a4d-42e8-996d-3b900ed59dc4", - "reason": "Cancelling job." - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels a job with the specified job ID.", - "id": "to-cancel-a-job-1481152314733", - "title": "To cancel a job" - } - ], - "CreateComputeEnvironment": [ - { - "input": { - "type": "MANAGED", - "computeEnvironmentName": "C4OnDemand", - "computeResources": { - "type": "EC2", - "desiredvCpus": 48, - "ec2KeyPair": "id_rsa", - "instanceRole": "ecsInstanceRole", - "instanceTypes": [ - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge" - ], - "maxvCpus": 128, - "minvCpus": 0, - "securityGroupIds": [ - "sg-cf5093b2" - ], - "subnets": [ - "subnet-220c0e0a", - "subnet-1a95556d", - "subnet-978f6dce" - ], - "tags": { - "Name": "Batch Instance - C4OnDemand" - } - }, - "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole", - "state": "ENABLED" - }, - "output": { - "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/C4OnDemand", - "computeEnvironmentName": "C4OnDemand" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a managed compute environment with specific C4 instance types that are launched on demand. The compute environment is called C4OnDemand.", - "id": "to-create-a-managed-ec2-compute-environment-1481152600017", - "title": "To create a managed EC2 compute environment" - }, - { - "input": { - "type": "MANAGED", - "computeEnvironmentName": "M4Spot", - "computeResources": { - "type": "SPOT", - "bidPercentage": 20, - "desiredvCpus": 4, - "ec2KeyPair": "id_rsa", - "instanceRole": "ecsInstanceRole", - "instanceTypes": [ - "m4" - ], - "maxvCpus": 128, - "minvCpus": 0, - "securityGroupIds": [ - "sg-cf5093b2" - ], - "spotIamFleetRole": "arn:aws:iam::012345678910:role/aws-ec2-spot-fleet-role", - "subnets": [ - "subnet-220c0e0a", - "subnet-1a95556d", - "subnet-978f6dce" - ], - "tags": { - "Name": "Batch Instance - M4Spot" - } - }, - "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole", - "state": "ENABLED" - }, - "output": { - "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/M4Spot", - "computeEnvironmentName": "M4Spot" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a managed compute environment with the M4 instance type that is launched when the Spot bid price is at or below 20% of the On-Demand price for the instance type. The compute environment is called M4Spot.", - "id": "to-create-a-managed-ec2-spot-compute-environment-1481152844190", - "title": "To create a managed EC2 Spot compute environment" - } - ], - "CreateJobQueue": [ - { - "input": { - "computeEnvironmentOrder": [ - { - "computeEnvironment": "M4Spot", - "order": 1 - } - ], - "jobQueueName": "LowPriority", - "priority": 10, - "state": "ENABLED" - }, - "output": { - "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/LowPriority", - "jobQueueName": "LowPriority" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a job queue called LowPriority that uses the M4Spot compute environment.", - "id": "to-create-a-job-queue-with-a-single-compute-environment-1481152967946", - "title": "To create a job queue with a single compute environment" - }, - { - "input": { - "computeEnvironmentOrder": [ - { - "computeEnvironment": "C4OnDemand", - "order": 1 - }, - { - "computeEnvironment": "M4Spot", - "order": 2 - } - ], - "jobQueueName": "HighPriority", - "priority": 1, - "state": "ENABLED" - }, - "output": { - "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", - "jobQueueName": "HighPriority" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a job queue called HighPriority that uses the C4OnDemand compute environment with an order of 1 and the M4Spot compute environment with an order of 2.", - "id": "to-create-a-job-queue-with-multiple-compute-environments-1481153027051", - "title": "To create a job queue with multiple compute environments" - } - ], - "DeleteComputeEnvironment": [ - { - "input": { - "computeEnvironment": "P2OnDemand" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the P2OnDemand compute environment.", - "id": "to-delete-a-compute-environment-1481153105644", - "title": "To delete a compute environment" - } - ], - "DeleteJobQueue": [ - { - "input": { - "jobQueue": "GPGPU" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the GPGPU job queue.", - "id": "to-delete-a-job-queue-1481153508134", - "title": "To delete a job queue" - } - ], - "DeregisterJobDefinition": [ - { - "input": { - "jobDefinition": "sleep10" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deregisters a job definition called sleep10.", - "id": "to-deregister-a-job-definition-1481153579565", - "title": "To deregister a job definition" - } - ], - "DescribeComputeEnvironments": [ - { - "input": { - "computeEnvironments": [ - "P2OnDemand" - ] - }, - "output": { - "computeEnvironments": [ - { - "type": "MANAGED", - "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand", - "computeEnvironmentName": "P2OnDemand", - "computeResources": { - "type": "EC2", - "desiredvCpus": 48, - "ec2KeyPair": "id_rsa", - "instanceRole": "ecsInstanceRole", - "instanceTypes": [ - "p2" - ], - "maxvCpus": 128, - "minvCpus": 0, - "securityGroupIds": [ - "sg-cf5093b2" - ], - "subnets": [ - "subnet-220c0e0a", - "subnet-1a95556d", - "subnet-978f6dce" - ], - "tags": { - "Name": "Batch Instance - P2OnDemand" - } - }, - "ecsClusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/P2OnDemand_Batch_2c06f29d-d1fe-3a49-879d-42394c86effc", - "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole", - "state": "ENABLED", - "status": "VALID", - "statusReason": "ComputeEnvironment Healthy" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the P2OnDemand compute environment.", - "id": "to-describe-a-compute-environment-1481153713334", - "title": "To describe a compute environment" - } - ], - "DescribeJobDefinitions": [ - { - "input": { - "status": "ACTIVE" - }, - "output": { - "jobDefinitions": [ - { - "type": "container", - "containerProperties": { - "command": [ - "sleep", - "60" - ], - "environment": [ - - ], - "image": "busybox", - "memory": 128, - "mountPoints": [ - - ], - "ulimits": [ - - ], - "vcpus": 1, - "volumes": [ - - ] - }, - "jobDefinitionArn": "arn:aws:batch:us-east-1:012345678910:job-definition/sleep60:1", - "jobDefinitionName": "sleep60", - "revision": 1, - "status": "ACTIVE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all of your active job definitions.", - "id": "to-describe-active-job-definitions-1481153895831", - "title": "To describe active job definitions" - } - ], - "DescribeJobQueues": [ - { - "input": { - "jobQueues": [ - "HighPriority" - ] - }, - "output": { - "jobQueues": [ - { - "computeEnvironmentOrder": [ - { - "computeEnvironment": "arn:aws:batch:us-east-1:012345678910:compute-environment/C4OnDemand", - "order": 1 - } - ], - "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", - "jobQueueName": "HighPriority", - "priority": 1, - "state": "ENABLED", - "status": "VALID", - "statusReason": "JobQueue Healthy" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the HighPriority job queue.", - "id": "to-describe-a-job-queue-1481153995804", - "title": "To describe a job queue" - } - ], - "DescribeJobs": [ - { - "input": { - "jobs": [ - "24fa2d7a-64c4-49d2-8b47-f8da4fbde8e9" - ] - }, - "output": { - "jobs": [ - { - "container": { - "command": [ - "sleep", - "60" - ], - "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/5406d7cd-58bd-4b8f-9936-48d7c6b1526c", - "environment": [ - - ], - "exitCode": 0, - "image": "busybox", - "memory": 128, - "mountPoints": [ - - ], - "ulimits": [ - - ], - "vcpus": 1, - "volumes": [ - - ] - }, - "createdAt": 1480460782010, - "dependsOn": [ - - ], - "jobDefinition": "sleep60", - "jobId": "24fa2d7a-64c4-49d2-8b47-f8da4fbde8e9", - "jobName": "example", - "jobQueue": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority", - "parameters": { - }, - "startedAt": 1480460816500, - "status": "SUCCEEDED", - "stoppedAt": 1480460880699 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes a job with the specified job ID.", - "id": "to-describe-a-specific-job-1481154090490", - "title": "To describe a specific job" - } - ], - "ListJobs": [ - { - "input": { - "jobQueue": "HighPriority" - }, - "output": { - "jobSummaryList": [ - { - "jobId": "e66ff5fd-a1ff-4640-b1a2-0b0a142f49bb", - "jobName": "example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the running jobs in the HighPriority job queue.", - "id": "to-list-running-jobs-1481154202164", - "title": "To list running jobs" - }, - { - "input": { - "jobQueue": "HighPriority", - "jobStatus": "SUBMITTED" - }, - "output": { - "jobSummaryList": [ - { - "jobId": "68f0c163-fbd4-44e6-9fd1-25b14a434786", - "jobName": "example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists jobs in the HighPriority job queue that are in the SUBMITTED job status.", - "id": "to-list-submitted-jobs-1481154251623", - "title": "To list submitted jobs" - } - ], - "RegisterJobDefinition": [ - { - "input": { - "type": "container", - "containerProperties": { - "command": [ - "sleep", - "10" - ], - "image": "busybox", - "memory": 128, - "vcpus": 1 - }, - "jobDefinitionName": "sleep10" - }, - "output": { - "jobDefinitionArn": "arn:aws:batch:us-east-1:012345678910:job-definition/sleep10:1", - "jobDefinitionName": "sleep10", - "revision": 1 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers a job definition for a simple container job.", - "id": "to-register-a-job-definition-1481154325325", - "title": "To register a job definition" - } - ], - "SubmitJob": [ - { - "input": { - "jobDefinition": "sleep60", - "jobName": "example", - "jobQueue": "HighPriority" - }, - "output": { - "jobId": "876da822-4198-45f2-a252-6cea32512ea8", - "jobName": "example" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example submits a simple container job called example to the HighPriority job queue.", - "id": "to-submit-a-job-to-a-queue-1481154481673", - "title": "To submit a job to a queue" - } - ], - "TerminateJob": [ - { - "input": { - "jobId": "61e743ed-35e4-48da-b2de-5c8333821c84", - "reason": "Terminating job." - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example terminates a job with the specified job ID.", - "id": "to-terminate-a-job-1481154558276", - "title": "To terminate a job" - } - ], - "UpdateComputeEnvironment": [ - { - "input": { - "computeEnvironment": "P2OnDemand", - "state": "DISABLED" - }, - "output": { - "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand", - "computeEnvironmentName": "P2OnDemand" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables the P2OnDemand compute environment so it can be deleted.", - "id": "to-update-a-compute-environment-1481154702731", - "title": "To update a compute environment" - } - ], - "UpdateJobQueue": [ - { - "input": { - "jobQueue": "GPGPU", - "state": "DISABLED" - }, - "output": { - "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/GPGPU", - "jobQueueName": "GPGPU" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables a job queue so that it can be deleted.", - "id": "to-update-a-job-queue-1481154806981", - "title": "To update a job queue" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/service-2.json deleted file mode 100644 index 4da311ff..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/batch/2016-08-10/service-2.json +++ /dev/null @@ -1,1660 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-08-10", - "endpointPrefix":"batch", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"AWS Batch", - "serviceFullName":"AWS Batch", - "serviceId":"Batch", - "signatureVersion":"v4", - "uid":"batch-2016-08-10" - }, - "operations":{ - "CancelJob":{ - "name":"CancelJob", - "http":{ - "method":"POST", - "requestUri":"/v1/canceljob" - }, - "input":{"shape":"CancelJobRequest"}, - "output":{"shape":"CancelJobResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Cancels a job in an AWS Batch job queue. Jobs that are in the SUBMITTED, PENDING, or RUNNABLE state are cancelled. Jobs that have progressed to STARTING or RUNNING are not cancelled (but the API operation still succeeds, even if no job is cancelled); these jobs must be terminated with the TerminateJob operation.

" - }, - "CreateComputeEnvironment":{ - "name":"CreateComputeEnvironment", - "http":{ - "method":"POST", - "requestUri":"/v1/createcomputeenvironment" - }, - "input":{"shape":"CreateComputeEnvironmentRequest"}, - "output":{"shape":"CreateComputeEnvironmentResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Creates an AWS Batch compute environment. You can create MANAGED or UNMANAGED compute environments.

In a managed compute environment, AWS Batch manages the compute resources within the environment, based on the compute resources that you specify. Instances launched into a managed compute environment use a recent, approved version of the Amazon ECS-optimized AMI. You can choose to use Amazon EC2 On-Demand Instances in your managed compute environment, or you can use Amazon EC2 Spot Instances that only launch when the Spot bid price is below a specified percentage of the On-Demand price.

In an unmanaged compute environment, you can manage your own compute resources. This provides more compute resource configuration options, such as using a custom AMI, but you must ensure that your AMI meets the Amazon ECS container instance AMI specification. For more information, see Container Instance AMIs in the Amazon Elastic Container Service Developer Guide. After you have created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that is associated with it and then manually launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS Container Instance in the Amazon Elastic Container Service Developer Guide.

" - }, - "CreateJobQueue":{ - "name":"CreateJobQueue", - "http":{ - "method":"POST", - "requestUri":"/v1/createjobqueue" - }, - "input":{"shape":"CreateJobQueueRequest"}, - "output":{"shape":"CreateJobQueueResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Creates an AWS Batch job queue. When you create a job queue, you associate one or more compute environments to the queue and assign an order of preference for the compute environments.

You also set a priority to the job queue that determines the order in which the AWS Batch scheduler places jobs onto its associated compute environments. For example, if a compute environment is associated with more than one job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute environment.

" - }, - "DeleteComputeEnvironment":{ - "name":"DeleteComputeEnvironment", - "http":{ - "method":"POST", - "requestUri":"/v1/deletecomputeenvironment" - }, - "input":{"shape":"DeleteComputeEnvironmentRequest"}, - "output":{"shape":"DeleteComputeEnvironmentResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Deletes an AWS Batch compute environment.

Before you can delete a compute environment, you must set its state to DISABLED with the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation.

" - }, - "DeleteJobQueue":{ - "name":"DeleteJobQueue", - "http":{ - "method":"POST", - "requestUri":"/v1/deletejobqueue" - }, - "input":{"shape":"DeleteJobQueueRequest"}, - "output":{"shape":"DeleteJobQueueResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Deletes the specified job queue. You must first disable submissions for a queue with the UpdateJobQueue operation. All jobs in the queue are terminated when you delete a job queue.

It is not necessary to disassociate compute environments from a queue before submitting a DeleteJobQueue request.

" - }, - "DeregisterJobDefinition":{ - "name":"DeregisterJobDefinition", - "http":{ - "method":"POST", - "requestUri":"/v1/deregisterjobdefinition" - }, - "input":{"shape":"DeregisterJobDefinitionRequest"}, - "output":{"shape":"DeregisterJobDefinitionResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Deregisters an AWS Batch job definition.

" - }, - "DescribeComputeEnvironments":{ - "name":"DescribeComputeEnvironments", - "http":{ - "method":"POST", - "requestUri":"/v1/describecomputeenvironments" - }, - "input":{"shape":"DescribeComputeEnvironmentsRequest"}, - "output":{"shape":"DescribeComputeEnvironmentsResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Describes one or more of your compute environments.

If you are using an unmanaged compute environment, you can use the DescribeComputeEnvironment operation to determine the ecsClusterArn that you should launch your Amazon ECS container instances into.

" - }, - "DescribeJobDefinitions":{ - "name":"DescribeJobDefinitions", - "http":{ - "method":"POST", - "requestUri":"/v1/describejobdefinitions" - }, - "input":{"shape":"DescribeJobDefinitionsRequest"}, - "output":{"shape":"DescribeJobDefinitionsResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Describes a list of job definitions. You can specify a status (such as ACTIVE) to only return job definitions that match that status.

" - }, - "DescribeJobQueues":{ - "name":"DescribeJobQueues", - "http":{ - "method":"POST", - "requestUri":"/v1/describejobqueues" - }, - "input":{"shape":"DescribeJobQueuesRequest"}, - "output":{"shape":"DescribeJobQueuesResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Describes one or more of your job queues.

" - }, - "DescribeJobs":{ - "name":"DescribeJobs", - "http":{ - "method":"POST", - "requestUri":"/v1/describejobs" - }, - "input":{"shape":"DescribeJobsRequest"}, - "output":{"shape":"DescribeJobsResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Describes a list of AWS Batch jobs.

" - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"POST", - "requestUri":"/v1/listjobs" - }, - "input":{"shape":"ListJobsRequest"}, - "output":{"shape":"ListJobsResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Returns a list of task jobs for a specified job queue. You can filter the results by job status with the jobStatus parameter. If you do not specify a status, only RUNNING jobs are returned.

" - }, - "RegisterJobDefinition":{ - "name":"RegisterJobDefinition", - "http":{ - "method":"POST", - "requestUri":"/v1/registerjobdefinition" - }, - "input":{"shape":"RegisterJobDefinitionRequest"}, - "output":{"shape":"RegisterJobDefinitionResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Registers an AWS Batch job definition.

" - }, - "SubmitJob":{ - "name":"SubmitJob", - "http":{ - "method":"POST", - "requestUri":"/v1/submitjob" - }, - "input":{"shape":"SubmitJobRequest"}, - "output":{"shape":"SubmitJobResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Submits an AWS Batch job from a job definition. Parameters specified during SubmitJob override parameters defined in the job definition.

" - }, - "TerminateJob":{ - "name":"TerminateJob", - "http":{ - "method":"POST", - "requestUri":"/v1/terminatejob" - }, - "input":{"shape":"TerminateJobRequest"}, - "output":{"shape":"TerminateJobResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Terminates a job in a job queue. Jobs that are in the STARTING or RUNNING state are terminated, which causes them to transition to FAILED. Jobs that have not progressed to the STARTING state are cancelled.

" - }, - "UpdateComputeEnvironment":{ - "name":"UpdateComputeEnvironment", - "http":{ - "method":"POST", - "requestUri":"/v1/updatecomputeenvironment" - }, - "input":{"shape":"UpdateComputeEnvironmentRequest"}, - "output":{"shape":"UpdateComputeEnvironmentResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Updates an AWS Batch compute environment.

" - }, - "UpdateJobQueue":{ - "name":"UpdateJobQueue", - "http":{ - "method":"POST", - "requestUri":"/v1/updatejobqueue" - }, - "input":{"shape":"UpdateJobQueueRequest"}, - "output":{"shape":"UpdateJobQueueResponse"}, - "errors":[ - {"shape":"ClientException"}, - {"shape":"ServerException"} - ], - "documentation":"

Updates a job queue.

" - } - }, - "shapes":{ - "ArrayJobDependency":{ - "type":"string", - "enum":[ - "N_TO_N", - "SEQUENTIAL" - ] - }, - "ArrayJobStatusSummary":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"Integer"} - }, - "ArrayProperties":{ - "type":"structure", - "members":{ - "size":{ - "shape":"Integer", - "documentation":"

The size of the array job.

" - } - }, - "documentation":"

An object representing an AWS Batch array job.

" - }, - "ArrayPropertiesDetail":{ - "type":"structure", - "members":{ - "statusSummary":{ - "shape":"ArrayJobStatusSummary", - "documentation":"

A summary of the number of array job children in each available job status. This parameter is returned for parent array jobs.

" - }, - "size":{ - "shape":"Integer", - "documentation":"

The size of the array job. This parameter is returned for parent array jobs.

" - }, - "index":{ - "shape":"Integer", - "documentation":"

The job index within the array that is associated with this job. This parameter is returned for array job children.

" - } - }, - "documentation":"

An object representing the array properties of a job.

" - }, - "ArrayPropertiesSummary":{ - "type":"structure", - "members":{ - "size":{ - "shape":"Integer", - "documentation":"

The size of the array job. This parameter is returned for parent array jobs.

" - }, - "index":{ - "shape":"Integer", - "documentation":"

The job index within the array that is associated with this job. This parameter is returned for children of array jobs.

" - } - }, - "documentation":"

An object representing the array properties of a job.

" - }, - "AttemptContainerDetail":{ - "type":"structure", - "members":{ - "containerInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon ECS container instance that hosts the job attempt.

" - }, - "taskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon ECS task that is associated with the job attempt. Each container attempt receives a task ARN when they reach the STARTING status.

" - }, - "exitCode":{ - "shape":"Integer", - "documentation":"

The exit code for the job attempt. A non-zero exit code is considered a failure.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A short (255 max characters) human-readable string to provide additional details about a running or stopped container.

" - }, - "logStreamName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch Logs log stream associated with the container. The log group for AWS Batch jobs is /aws/batch/job. Each container attempt receives a log stream name when they reach the RUNNING status.

" - } - }, - "documentation":"

An object representing the details of a container that is part of a job attempt.

" - }, - "AttemptDetail":{ - "type":"structure", - "members":{ - "container":{ - "shape":"AttemptContainerDetail", - "documentation":"

Details about the container in this job attempt.

" - }, - "startedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp (in seconds and milliseconds) for when the attempt was started (when the attempt transitioned from the STARTING state to the RUNNING state).

" - }, - "stoppedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp (in seconds and milliseconds) for when the attempt was stopped (when the attempt transitioned from the RUNNING state to a terminal state, such as SUCCEEDED or FAILED).

" - }, - "statusReason":{ - "shape":"String", - "documentation":"

A short, human-readable string to provide additional details about the current status of the job attempt.

" - } - }, - "documentation":"

An object representing a job attempt.

" - }, - "AttemptDetails":{ - "type":"list", - "member":{"shape":"AttemptDetail"} - }, - "Boolean":{"type":"boolean"}, - "CEState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "CEStatus":{ - "type":"string", - "enum":[ - "CREATING", - "UPDATING", - "DELETING", - "DELETED", - "VALID", - "INVALID" - ] - }, - "CEType":{ - "type":"string", - "enum":[ - "MANAGED", - "UNMANAGED" - ] - }, - "CRType":{ - "type":"string", - "enum":[ - "EC2", - "SPOT" - ] - }, - "CancelJobRequest":{ - "type":"structure", - "required":[ - "jobId", - "reason" - ], - "members":{ - "jobId":{ - "shape":"String", - "documentation":"

The AWS Batch job ID of the job to cancel.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A message to attach to the job that explains the reason for canceling it. This message is returned by future DescribeJobs operations on the job. This message is also recorded in the AWS Batch activity logs.

" - } - } - }, - "CancelJobResponse":{ - "type":"structure", - "members":{ - } - }, - "ClientException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a client action, such as using an action or resource on behalf of a user that doesn't have permissions to use the action or resource, or specifying an identifier that is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ComputeEnvironmentDetail":{ - "type":"structure", - "required":[ - "computeEnvironmentName", - "computeEnvironmentArn", - "ecsClusterArn" - ], - "members":{ - "computeEnvironmentName":{ - "shape":"String", - "documentation":"

The name of the compute environment.

" - }, - "computeEnvironmentArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the compute environment.

" - }, - "ecsClusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the underlying Amazon ECS cluster used by the compute environment.

" - }, - "type":{ - "shape":"CEType", - "documentation":"

The type of the compute environment.

" - }, - "state":{ - "shape":"CEState", - "documentation":"

The state of the compute environment. The valid values are ENABLED or DISABLED. An ENABLED state indicates that you can register instances with the compute environment and that the associated instances can accept jobs.

" - }, - "status":{ - "shape":"CEStatus", - "documentation":"

The current status of the compute environment (for example, CREATING or VALID).

" - }, - "statusReason":{ - "shape":"String", - "documentation":"

A short, human-readable string to provide additional details about the current status of the compute environment.

" - }, - "computeResources":{ - "shape":"ComputeResource", - "documentation":"

The compute resources defined for the compute environment.

" - }, - "serviceRole":{ - "shape":"String", - "documentation":"

The service role associated with the compute environment that allows AWS Batch to make calls to AWS API operations on your behalf.

" - } - }, - "documentation":"

An object representing an AWS Batch compute environment.

" - }, - "ComputeEnvironmentDetailList":{ - "type":"list", - "member":{"shape":"ComputeEnvironmentDetail"} - }, - "ComputeEnvironmentOrder":{ - "type":"structure", - "required":[ - "order", - "computeEnvironment" - ], - "members":{ - "order":{ - "shape":"Integer", - "documentation":"

The order of the compute environment.

" - }, - "computeEnvironment":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the compute environment.

" - } - }, - "documentation":"

The order in which compute environments are tried for job placement within a queue. Compute environments are tried in ascending order. For example, if two compute environments are associated with a job queue, the compute environment with a lower order integer value is tried for job placement first.

" - }, - "ComputeEnvironmentOrders":{ - "type":"list", - "member":{"shape":"ComputeEnvironmentOrder"} - }, - "ComputeResource":{ - "type":"structure", - "required":[ - "type", - "minvCpus", - "maxvCpus", - "instanceTypes", - "subnets", - "securityGroupIds", - "instanceRole" - ], - "members":{ - "type":{ - "shape":"CRType", - "documentation":"

The type of compute environment.

" - }, - "minvCpus":{ - "shape":"Integer", - "documentation":"

The minimum number of EC2 vCPUs that an environment should maintain.

" - }, - "maxvCpus":{ - "shape":"Integer", - "documentation":"

The maximum number of EC2 vCPUs that an environment can reach.

" - }, - "desiredvCpus":{ - "shape":"Integer", - "documentation":"

The desired number of EC2 vCPUS in the compute environment.

" - }, - "instanceTypes":{ - "shape":"StringList", - "documentation":"

The instances types that may be launched. You can specify instance families to launch any instance type within those families (for example, c4 or p3), or you can specify specific sizes within a family (such as c4.8xlarge). You can also choose optimal to pick instance types (from the latest C, M, and R instance families) on the fly that match the demand of your job queues.

" - }, - "imageId":{ - "shape":"String", - "documentation":"

The Amazon Machine Image (AMI) ID used for instances launched in the compute environment.

" - }, - "subnets":{ - "shape":"StringList", - "documentation":"

The VPC subnets into which the compute resources are launched.

" - }, - "securityGroupIds":{ - "shape":"StringList", - "documentation":"

The EC2 security group that is associated with instances launched in the compute environment.

" - }, - "ec2KeyPair":{ - "shape":"String", - "documentation":"

The EC2 key pair that is used for instances launched in the compute environment.

" - }, - "instanceRole":{ - "shape":"String", - "documentation":"

The Amazon ECS instance profile applied to Amazon EC2 instances in a compute environment. You can specify the short name or full Amazon Resource Name (ARN) of an instance profile. For example, ecsInstanceRole or arn:aws:iam::<aws_account_id>:instance-profile/ecsInstanceRole. For more information, see Amazon ECS Instance Role in the AWS Batch User Guide.

" - }, - "tags":{ - "shape":"TagsMap", - "documentation":"

Key-value pair tags to be applied to resources that are launched in the compute environment.

" - }, - "bidPercentage":{ - "shape":"Integer", - "documentation":"

The minimum percentage that a Spot Instance price must be when compared with the On-Demand price for that instance type before instances are launched. For example, if your bid percentage is 20%, then the Spot price must be below 20% of the current On-Demand price for that EC2 instance.

" - }, - "spotIamFleetRole":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon EC2 Spot Fleet IAM role applied to a SPOT compute environment.

" - } - }, - "documentation":"

An object representing an AWS Batch compute resource.

" - }, - "ComputeResourceUpdate":{ - "type":"structure", - "members":{ - "minvCpus":{ - "shape":"Integer", - "documentation":"

The minimum number of EC2 vCPUs that an environment should maintain.

" - }, - "maxvCpus":{ - "shape":"Integer", - "documentation":"

The maximum number of EC2 vCPUs that an environment can reach.

" - }, - "desiredvCpus":{ - "shape":"Integer", - "documentation":"

The desired number of EC2 vCPUS in the compute environment.

" - } - }, - "documentation":"

An object representing the attributes of a compute environment that can be updated.

" - }, - "ContainerDetail":{ - "type":"structure", - "members":{ - "image":{ - "shape":"String", - "documentation":"

The image used to start the container.

" - }, - "vcpus":{ - "shape":"Integer", - "documentation":"

The number of VCPUs allocated for the job.

" - }, - "memory":{ - "shape":"Integer", - "documentation":"

The number of MiB of memory reserved for the job.

" - }, - "command":{ - "shape":"StringList", - "documentation":"

The command that is passed to the container.

" - }, - "jobRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) associated with the job upon execution.

" - }, - "volumes":{ - "shape":"Volumes", - "documentation":"

A list of volumes associated with the job.

" - }, - "environment":{ - "shape":"EnvironmentVariables", - "documentation":"

The environment variables to pass to a container.

Environment variables must not start with AWS_BATCH; this naming convention is reserved for variables that are set by the AWS Batch service.

" - }, - "mountPoints":{ - "shape":"MountPoints", - "documentation":"

The mount points for data volumes in your container.

" - }, - "readonlyRootFilesystem":{ - "shape":"Boolean", - "documentation":"

When this parameter is true, the container is given read-only access to its root file system.

" - }, - "ulimits":{ - "shape":"Ulimits", - "documentation":"

A list of ulimit values to set in the container.

" - }, - "privileged":{ - "shape":"Boolean", - "documentation":"

When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user).

" - }, - "user":{ - "shape":"String", - "documentation":"

The user name to use inside the container.

" - }, - "exitCode":{ - "shape":"Integer", - "documentation":"

The exit code to return upon completion.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A short (255 max characters) human-readable string to provide additional details about a running or stopped container.

" - }, - "containerInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the container instance on which the container is running.

" - }, - "taskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon ECS task that is associated with the container job. Each container attempt receives a task ARN when they reach the STARTING status.

" - }, - "logStreamName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch Logs log stream associated with the container. The log group for AWS Batch jobs is /aws/batch/job. Each container attempt receives a log stream name when they reach the RUNNING status.

" - } - }, - "documentation":"

An object representing the details of a container that is part of a job.

" - }, - "ContainerOverrides":{ - "type":"structure", - "members":{ - "vcpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs to reserve for the container. This value overrides the value set in the job definition.

" - }, - "memory":{ - "shape":"Integer", - "documentation":"

The number of MiB of memory reserved for the job. This value overrides the value set in the job definition.

" - }, - "command":{ - "shape":"StringList", - "documentation":"

The command to send to the container that overrides the default command from the Docker image or the job definition.

" - }, - "environment":{ - "shape":"EnvironmentVariables", - "documentation":"

The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the job definition.

Environment variables must not start with AWS_BATCH; this naming convention is reserved for variables that are set by the AWS Batch service.

" - } - }, - "documentation":"

The overrides that should be sent to a container.

" - }, - "ContainerProperties":{ - "type":"structure", - "required":[ - "image", - "vcpus", - "memory" - ], - "members":{ - "image":{ - "shape":"String", - "documentation":"

The image used to start a container. This string is passed directly to the Docker daemon. Images in the Docker Hub registry are available by default. Other repositories are specified with repository-url/image:tag . Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed. This parameter maps to Image in the Create a container section of the Docker Remote API and the IMAGE parameter of docker run.

  • Images in Amazon ECR repositories use the full registry and repository URI (for example, 012345678910.dkr.ecr.<region-name>.amazonaws.com/<repository-name>).

  • Images in official repositories on Docker Hub use a single name (for example, ubuntu or mongo).

  • Images in other repositories on Docker Hub are qualified with an organization name (for example, amazon/amazon-ecs-agent).

  • Images in other online repositories are qualified further by a domain name (for example, quay.io/assemblyline/ubuntu).

" - }, - "vcpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. You must specify at least one vCPU.

" - }, - "memory":{ - "shape":"Integer", - "documentation":"

The hard limit (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job.

If you are trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory Management in the AWS Batch User Guide.

" - }, - "command":{ - "shape":"StringList", - "documentation":"

The command that is passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see https://docs.docker.com/engine/reference/builder/#cmd.

" - }, - "jobRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that the container can assume for AWS permissions.

" - }, - "volumes":{ - "shape":"Volumes", - "documentation":"

A list of data volumes used in a job.

" - }, - "environment":{ - "shape":"EnvironmentVariables", - "documentation":"

The environment variables to pass to a container. This parameter maps to Env in the Create a container section of the Docker Remote API and the --env option to docker run.

We do not recommend using plaintext environment variables for sensitive information, such as credential data.

Environment variables must not start with AWS_BATCH; this naming convention is reserved for variables that are set by the AWS Batch service.

" - }, - "mountPoints":{ - "shape":"MountPoints", - "documentation":"

The mount points for data volumes in your container. This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

" - }, - "readonlyRootFilesystem":{ - "shape":"Boolean", - "documentation":"

When this parameter is true, the container is given read-only access to its root file system. This parameter maps to ReadonlyRootfs in the Create a container section of the Docker Remote API and the --read-only option to docker run.

" - }, - "privileged":{ - "shape":"Boolean", - "documentation":"

When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user). This parameter maps to Privileged in the Create a container section of the Docker Remote API and the --privileged option to docker run.

" - }, - "ulimits":{ - "shape":"Ulimits", - "documentation":"

A list of ulimits to set in the container. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

" - }, - "user":{ - "shape":"String", - "documentation":"

The user name to use inside the container. This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

" - } - }, - "documentation":"

Container properties are used in job definitions to describe the container that is launched as part of a job.

" - }, - "ContainerSummary":{ - "type":"structure", - "members":{ - "exitCode":{ - "shape":"Integer", - "documentation":"

The exit code to return upon completion.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A short (255 max characters) human-readable string to provide additional details about a running or stopped container.

" - } - }, - "documentation":"

An object representing summary details of a container within a job.

" - }, - "CreateComputeEnvironmentRequest":{ - "type":"structure", - "required":[ - "computeEnvironmentName", - "type", - "serviceRole" - ], - "members":{ - "computeEnvironmentName":{ - "shape":"String", - "documentation":"

The name for your compute environment. Up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

" - }, - "type":{ - "shape":"CEType", - "documentation":"

The type of the compute environment.

" - }, - "state":{ - "shape":"CEState", - "documentation":"

The state of the compute environment. If the state is ENABLED, then the compute environment accepts jobs from a queue and can scale out automatically based on queues.

" - }, - "computeResources":{ - "shape":"ComputeResource", - "documentation":"

Details of the compute resources managed by the compute environment. This parameter is required for managed compute environments.

" - }, - "serviceRole":{ - "shape":"String", - "documentation":"

The full Amazon Resource Name (ARN) of the IAM role that allows AWS Batch to make calls to other AWS services on your behalf.

If your specified role has a path other than /, then you must either specify the full role ARN (this is recommended) or prefix the role name with the path.

Depending on how you created your AWS Batch service role, its ARN may contain the service-role path prefix. When you only specify the name of the service role, AWS Batch assumes that your ARN does not use the service-role path prefix. Because of this, we recommend that you specify the full ARN of your service role when you create compute environments.

" - } - } - }, - "CreateComputeEnvironmentResponse":{ - "type":"structure", - "members":{ - "computeEnvironmentName":{ - "shape":"String", - "documentation":"

The name of the compute environment.

" - }, - "computeEnvironmentArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the compute environment.

" - } - } - }, - "CreateJobQueueRequest":{ - "type":"structure", - "required":[ - "jobQueueName", - "priority", - "computeEnvironmentOrder" - ], - "members":{ - "jobQueueName":{ - "shape":"String", - "documentation":"

The name of the job queue.

" - }, - "state":{ - "shape":"JQState", - "documentation":"

The state of the job queue. If the job queue state is ENABLED, it is able to accept jobs.

" - }, - "priority":{ - "shape":"Integer", - "documentation":"

The priority of the job queue. Job queues with a higher priority (or a higher integer value for the priority parameter) are evaluated first when associated with same compute environment. Priority is determined in descending order, for example, a job queue with a priority value of 10 is given scheduling preference over a job queue with a priority value of 1.

" - }, - "computeEnvironmentOrder":{ - "shape":"ComputeEnvironmentOrders", - "documentation":"

The set of compute environments mapped to a job queue and their order relative to each other. The job scheduler uses this parameter to determine which compute environment should execute a given job. Compute environments must be in the VALID state before you can associate them with a job queue. You can associate up to three compute environments with a job queue.

" - } - } - }, - "CreateJobQueueResponse":{ - "type":"structure", - "required":[ - "jobQueueName", - "jobQueueArn" - ], - "members":{ - "jobQueueName":{ - "shape":"String", - "documentation":"

The name of the job queue.

" - }, - "jobQueueArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the job queue.

" - } - } - }, - "DeleteComputeEnvironmentRequest":{ - "type":"structure", - "required":["computeEnvironment"], - "members":{ - "computeEnvironment":{ - "shape":"String", - "documentation":"

The name or Amazon Resource Name (ARN) of the compute environment to delete.

" - } - } - }, - "DeleteComputeEnvironmentResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteJobQueueRequest":{ - "type":"structure", - "required":["jobQueue"], - "members":{ - "jobQueue":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the queue to delete.

" - } - } - }, - "DeleteJobQueueResponse":{ - "type":"structure", - "members":{ - } - }, - "DeregisterJobDefinitionRequest":{ - "type":"structure", - "required":["jobDefinition"], - "members":{ - "jobDefinition":{ - "shape":"String", - "documentation":"

The name and revision (name:revision) or full Amazon Resource Name (ARN) of the job definition to deregister.

" - } - } - }, - "DeregisterJobDefinitionResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeComputeEnvironmentsRequest":{ - "type":"structure", - "members":{ - "computeEnvironments":{ - "shape":"StringList", - "documentation":"

A list of up to 100 compute environment names or full Amazon Resource Name (ARN) entries.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of cluster results returned by DescribeComputeEnvironments in paginated output. When this parameter is used, DescribeComputeEnvironments only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeComputeEnvironments request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeComputeEnvironments returns up to 100 results and a nextToken value if applicable.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated DescribeComputeEnvironments request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - } - } - }, - "DescribeComputeEnvironmentsResponse":{ - "type":"structure", - "members":{ - "computeEnvironments":{ - "shape":"ComputeEnvironmentDetailList", - "documentation":"

The list of compute environments.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future DescribeComputeEnvironments request. When the results of a DescribeJobDefinitions request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "DescribeJobDefinitionsRequest":{ - "type":"structure", - "members":{ - "jobDefinitions":{ - "shape":"StringList", - "documentation":"

A space-separated list of up to 100 job definition names or full Amazon Resource Name (ARN) entries.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results returned by DescribeJobDefinitions in paginated output. When this parameter is used, DescribeJobDefinitions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeJobDefinitions request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeJobDefinitions returns up to 100 results and a nextToken value if applicable.

" - }, - "jobDefinitionName":{ - "shape":"String", - "documentation":"

The name of the job definition to describe.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status with which to filter job definitions.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated DescribeJobDefinitions request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - } - } - }, - "DescribeJobDefinitionsResponse":{ - "type":"structure", - "members":{ - "jobDefinitions":{ - "shape":"JobDefinitionList", - "documentation":"

The list of job definitions.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future DescribeJobDefinitions request. When the results of a DescribeJobDefinitions request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "DescribeJobQueuesRequest":{ - "type":"structure", - "members":{ - "jobQueues":{ - "shape":"StringList", - "documentation":"

A list of up to 100 queue names or full queue Amazon Resource Name (ARN) entries.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results returned by DescribeJobQueues in paginated output. When this parameter is used, DescribeJobQueues only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeJobQueues request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeJobQueues returns up to 100 results and a nextToken value if applicable.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated DescribeJobQueues request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - } - } - }, - "DescribeJobQueuesResponse":{ - "type":"structure", - "members":{ - "jobQueues":{ - "shape":"JobQueueDetailList", - "documentation":"

The list of job queues.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future DescribeJobQueues request. When the results of a DescribeJobQueues request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "DescribeJobsRequest":{ - "type":"structure", - "required":["jobs"], - "members":{ - "jobs":{ - "shape":"StringList", - "documentation":"

A space-separated list of up to 100 job IDs.

" - } - } - }, - "DescribeJobsResponse":{ - "type":"structure", - "members":{ - "jobs":{ - "shape":"JobDetailList", - "documentation":"

The list of jobs.

" - } - } - }, - "EnvironmentVariables":{ - "type":"list", - "member":{"shape":"KeyValuePair"} - }, - "Host":{ - "type":"structure", - "members":{ - "sourcePath":{ - "shape":"String", - "documentation":"

The path on the host container instance that is presented to the container. If this parameter is empty, then the Docker daemon has assigned a host path for you. If the host parameter contains a sourcePath file location, then the data volume persists at the specified location on the host container instance until you delete it manually. If the sourcePath value does not exist on the host container instance, the Docker daemon creates it. If the location does exist, the contents of the source path folder are exported.

" - } - }, - "documentation":"

The contents of the host parameter determine whether your data volume persists on the host container instance and where it is stored. If the host parameter is empty, then the Docker daemon assigns a host path for your data volume, but the data is not guaranteed to persist after the containers associated with it stop running.

" - }, - "Integer":{"type":"integer"}, - "JQState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "JQStatus":{ - "type":"string", - "enum":[ - "CREATING", - "UPDATING", - "DELETING", - "DELETED", - "VALID", - "INVALID" - ] - }, - "JobDefinition":{ - "type":"structure", - "required":[ - "jobDefinitionName", - "jobDefinitionArn", - "revision", - "type" - ], - "members":{ - "jobDefinitionName":{ - "shape":"String", - "documentation":"

The name of the job definition.

" - }, - "jobDefinitionArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the job definition.

" - }, - "revision":{ - "shape":"Integer", - "documentation":"

The revision of the job definition.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the job definition.

" - }, - "type":{ - "shape":"String", - "documentation":"

The type of job definition.

" - }, - "parameters":{ - "shape":"ParametersMap", - "documentation":"

Default parameters or parameter substitution placeholders that are set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.

" - }, - "retryStrategy":{ - "shape":"RetryStrategy", - "documentation":"

The retry strategy to use for failed jobs that are submitted with this job definition.

" - }, - "containerProperties":{ - "shape":"ContainerProperties", - "documentation":"

An object with various properties specific to container-based jobs.

" - }, - "timeout":{ - "shape":"JobTimeout", - "documentation":"

The timeout configuration for jobs that are submitted with this job definition. You can specify a timeout duration after which AWS Batch terminates your jobs if they have not finished.

" - } - }, - "documentation":"

An object representing an AWS Batch job definition.

" - }, - "JobDefinitionList":{ - "type":"list", - "member":{"shape":"JobDefinition"} - }, - "JobDefinitionType":{ - "type":"string", - "enum":["container"] - }, - "JobDependency":{ - "type":"structure", - "members":{ - "jobId":{ - "shape":"String", - "documentation":"

The job ID of the AWS Batch job associated with this dependency.

" - }, - "type":{ - "shape":"ArrayJobDependency", - "documentation":"

The type of the job dependency.

" - } - }, - "documentation":"

An object representing an AWS Batch job dependency.

" - }, - "JobDependencyList":{ - "type":"list", - "member":{"shape":"JobDependency"} - }, - "JobDetail":{ - "type":"structure", - "required":[ - "jobName", - "jobId", - "jobQueue", - "status", - "startedAt", - "jobDefinition" - ], - "members":{ - "jobName":{ - "shape":"String", - "documentation":"

The name of the job.

" - }, - "jobId":{ - "shape":"String", - "documentation":"

The ID for the job.

" - }, - "jobQueue":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the job queue with which the job is associated.

" - }, - "status":{ - "shape":"JobStatus", - "documentation":"

The current status for the job.

" - }, - "attempts":{ - "shape":"AttemptDetails", - "documentation":"

A list of job attempts associated with this job.

" - }, - "statusReason":{ - "shape":"String", - "documentation":"

A short, human-readable string to provide additional details about the current status of the job.

" - }, - "createdAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp (in seconds and milliseconds) for when the job was created. For non-array jobs and parent array jobs, this is when the job entered the SUBMITTED state (at the time SubmitJob was called). For array child jobs, this is when the child job was spawned by its parent and entered the PENDING state.

" - }, - "retryStrategy":{ - "shape":"RetryStrategy", - "documentation":"

The retry strategy to use for this job if an attempt fails.

" - }, - "startedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp (in seconds and milliseconds) for when the job was started (when the job transitioned from the STARTING state to the RUNNING state).

" - }, - "stoppedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp (in seconds and milliseconds) for when the job was stopped (when the job transitioned from the RUNNING state to a terminal state, such as SUCCEEDED or FAILED).

" - }, - "dependsOn":{ - "shape":"JobDependencyList", - "documentation":"

A list of job names or IDs on which this job depends.

" - }, - "jobDefinition":{ - "shape":"String", - "documentation":"

The job definition that is used by this job.

" - }, - "parameters":{ - "shape":"ParametersMap", - "documentation":"

Additional parameters passed to the job that replace parameter substitution placeholders or override any corresponding parameter defaults from the job definition.

" - }, - "container":{ - "shape":"ContainerDetail", - "documentation":"

An object representing the details of the container that is associated with the job.

" - }, - "arrayProperties":{ - "shape":"ArrayPropertiesDetail", - "documentation":"

The array properties of the job, if it is an array job.

" - }, - "timeout":{ - "shape":"JobTimeout", - "documentation":"

The timeout configuration for the job.

" - } - }, - "documentation":"

An object representing an AWS Batch job.

" - }, - "JobDetailList":{ - "type":"list", - "member":{"shape":"JobDetail"} - }, - "JobQueueDetail":{ - "type":"structure", - "required":[ - "jobQueueName", - "jobQueueArn", - "state", - "priority", - "computeEnvironmentOrder" - ], - "members":{ - "jobQueueName":{ - "shape":"String", - "documentation":"

The name of the job queue.

" - }, - "jobQueueArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the job queue.

" - }, - "state":{ - "shape":"JQState", - "documentation":"

Describes the ability of the queue to accept new jobs.

" - }, - "status":{ - "shape":"JQStatus", - "documentation":"

The status of the job queue (for example, CREATING or VALID).

" - }, - "statusReason":{ - "shape":"String", - "documentation":"

A short, human-readable string to provide additional details about the current status of the job queue.

" - }, - "priority":{ - "shape":"Integer", - "documentation":"

The priority of the job queue.

" - }, - "computeEnvironmentOrder":{ - "shape":"ComputeEnvironmentOrders", - "documentation":"

The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

" - } - }, - "documentation":"

An object representing the details of an AWS Batch job queue.

" - }, - "JobQueueDetailList":{ - "type":"list", - "member":{"shape":"JobQueueDetail"} - }, - "JobStatus":{ - "type":"string", - "enum":[ - "SUBMITTED", - "PENDING", - "RUNNABLE", - "STARTING", - "RUNNING", - "SUCCEEDED", - "FAILED" - ] - }, - "JobSummary":{ - "type":"structure", - "required":[ - "jobId", - "jobName" - ], - "members":{ - "jobId":{ - "shape":"String", - "documentation":"

The ID of the job.

" - }, - "jobName":{ - "shape":"String", - "documentation":"

The name of the job.

" - }, - "createdAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp for when the job was created. For non-array jobs and parent array jobs, this is when the job entered the SUBMITTED state (at the time SubmitJob was called). For array child jobs, this is when the child job was spawned by its parent and entered the PENDING state.

" - }, - "status":{ - "shape":"JobStatus", - "documentation":"

The current status for the job.

" - }, - "statusReason":{ - "shape":"String", - "documentation":"

A short, human-readable string to provide additional details about the current status of the job.

" - }, - "startedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp for when the job was started (when the job transitioned from the STARTING state to the RUNNING state).

" - }, - "stoppedAt":{ - "shape":"Long", - "documentation":"

The Unix time stamp for when the job was stopped (when the job transitioned from the RUNNING state to a terminal state, such as SUCCEEDED or FAILED).

" - }, - "container":{ - "shape":"ContainerSummary", - "documentation":"

An object representing the details of the container that is associated with the job.

" - }, - "arrayProperties":{ - "shape":"ArrayPropertiesSummary", - "documentation":"

The array properties of the job, if it is an array job.

" - } - }, - "documentation":"

An object representing summary details of a job.

" - }, - "JobSummaryList":{ - "type":"list", - "member":{"shape":"JobSummary"} - }, - "JobTimeout":{ - "type":"structure", - "members":{ - "attemptDurationSeconds":{ - "shape":"Integer", - "documentation":"

The time duration in seconds (measured from the job attempt's startedAt timestamp) after which AWS Batch terminates your jobs if they have not finished.

" - } - }, - "documentation":"

An object representing a job timeout configuration.

" - }, - "KeyValuePair":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the key-value pair. For environment variables, this is the name of the environment variable.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of the key-value pair. For environment variables, this is the value of the environment variable.

" - } - }, - "documentation":"

A key-value pair object.

" - }, - "ListJobsRequest":{ - "type":"structure", - "members":{ - "jobQueue":{ - "shape":"String", - "documentation":"

The name or full Amazon Resource Name (ARN) of the job queue with which to list jobs.

" - }, - "arrayJobId":{ - "shape":"String", - "documentation":"

The job ID for an array job. Specifying an array job ID with this parameter lists all child jobs from within the specified array.

" - }, - "jobStatus":{ - "shape":"JobStatus", - "documentation":"

The job status with which to filter jobs in the specified queue. If you do not specify a status, only RUNNING jobs are returned.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results returned by ListJobs in paginated output. When this parameter is used, ListJobs only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListJobs request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListJobs returns up to 100 results and a nextToken value if applicable.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListJobs request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - } - } - }, - "ListJobsResponse":{ - "type":"structure", - "required":["jobSummaryList"], - "members":{ - "jobSummaryList":{ - "shape":"JobSummaryList", - "documentation":"

A list of job summaries that match the request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListJobs request. When the results of a ListJobs request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "Long":{"type":"long"}, - "MountPoint":{ - "type":"structure", - "members":{ - "containerPath":{ - "shape":"String", - "documentation":"

The path on the container at which to mount the host volume.

" - }, - "readOnly":{ - "shape":"Boolean", - "documentation":"

If this value is true, the container has read-only access to the volume; otherwise, the container can write to the volume. The default value is false.

" - }, - "sourceVolume":{ - "shape":"String", - "documentation":"

The name of the volume to mount.

" - } - }, - "documentation":"

Details on a Docker volume mount point that is used in a job's container properties.

" - }, - "MountPoints":{ - "type":"list", - "member":{"shape":"MountPoint"} - }, - "ParametersMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "RegisterJobDefinitionRequest":{ - "type":"structure", - "required":[ - "jobDefinitionName", - "type" - ], - "members":{ - "jobDefinitionName":{ - "shape":"String", - "documentation":"

The name of the job definition to register. Up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

" - }, - "type":{ - "shape":"JobDefinitionType", - "documentation":"

The type of job definition.

" - }, - "parameters":{ - "shape":"ParametersMap", - "documentation":"

Default parameter substitution placeholders to set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.

" - }, - "containerProperties":{ - "shape":"ContainerProperties", - "documentation":"

An object with various properties specific for container-based jobs. This parameter is required if the type parameter is container.

" - }, - "retryStrategy":{ - "shape":"RetryStrategy", - "documentation":"

The retry strategy to use for failed jobs that are submitted with this job definition. Any retry strategy that is specified during a SubmitJob operation overrides the retry strategy defined here. If a job is terminated due to a timeout, it is not retried.

" - }, - "timeout":{ - "shape":"JobTimeout", - "documentation":"

The timeout configuration for jobs that are submitted with this job definition, after which AWS Batch terminates your jobs if they have not finished. If a job is terminated due to a timeout, it is not retried. The minimum value for the timeout is 60 seconds. Any timeout configuration that is specified during a SubmitJob operation overrides the timeout configuration defined here. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide.

" - } - } - }, - "RegisterJobDefinitionResponse":{ - "type":"structure", - "required":[ - "jobDefinitionName", - "jobDefinitionArn", - "revision" - ], - "members":{ - "jobDefinitionName":{ - "shape":"String", - "documentation":"

The name of the job definition.

" - }, - "jobDefinitionArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the job definition.

" - }, - "revision":{ - "shape":"Integer", - "documentation":"

The revision of the job definition.

" - } - } - }, - "RetryStrategy":{ - "type":"structure", - "members":{ - "attempts":{ - "shape":"Integer", - "documentation":"

The number of times to move a job to the RUNNABLE status. You may specify between 1 and 10 attempts. If the value of attempts is greater than one, the job is retried if it fails until it has moved to RUNNABLE that many times.

" - } - }, - "documentation":"

The retry strategy associated with a job.

" - }, - "ServerException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a server issue.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubmitJobRequest":{ - "type":"structure", - "required":[ - "jobName", - "jobQueue", - "jobDefinition" - ], - "members":{ - "jobName":{ - "shape":"String", - "documentation":"

The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

" - }, - "jobQueue":{ - "shape":"String", - "documentation":"

The job queue into which the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.

" - }, - "arrayProperties":{ - "shape":"ArrayProperties", - "documentation":"

The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see Array Jobs in the AWS Batch User Guide.

" - }, - "dependsOn":{ - "shape":"JobDependencyList", - "documentation":"

A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a SEQUENTIAL type dependency without specifying a job ID for array jobs so that each child array job completes sequentially, starting at index 0. You can also specify an N_TO_N type dependency with a job ID for array jobs so that each index child of this job must wait for the corresponding index child of each dependency to complete before it can begin.

" - }, - "jobDefinition":{ - "shape":"String", - "documentation":"

The job definition used by this job. This value can be either a name:revision or the Amazon Resource Name (ARN) for the job definition.

" - }, - "parameters":{ - "shape":"ParametersMap", - "documentation":"

Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job definition. Parameters are specified as a key and value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.

" - }, - "containerOverrides":{ - "shape":"ContainerOverrides", - "documentation":"

A list of container overrides in JSON format that specify the name of a container in the specified job definition and the overrides it should receive. You can override the default command for a container (that is specified in the job definition or the Docker image) with a command override. You can also override existing environment variables (that are specified in the job definition or Docker image) on a container or add new environment variables to it with an environment override.

" - }, - "retryStrategy":{ - "shape":"RetryStrategy", - "documentation":"

The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is specified here, it overrides the retry strategy defined in the job definition.

" - }, - "timeout":{ - "shape":"JobTimeout", - "documentation":"

The timeout configuration for this SubmitJob operation. You can specify a timeout duration after which AWS Batch terminates your jobs if they have not finished. If a job is terminated due to a timeout, it is not retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout configuration specified in the job definition. For array jobs, child jobs have the same timeout configuration as the parent job. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide.

" - } - } - }, - "SubmitJobResponse":{ - "type":"structure", - "required":[ - "jobName", - "jobId" - ], - "members":{ - "jobName":{ - "shape":"String", - "documentation":"

The name of the job.

" - }, - "jobId":{ - "shape":"String", - "documentation":"

The unique identifier for the job.

" - } - } - }, - "TagsMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "TerminateJobRequest":{ - "type":"structure", - "required":[ - "jobId", - "reason" - ], - "members":{ - "jobId":{ - "shape":"String", - "documentation":"

The AWS Batch job ID of the job to terminate.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A message to attach to the job that explains the reason for canceling it. This message is returned by future DescribeJobs operations on the job. This message is also recorded in the AWS Batch activity logs.

" - } - } - }, - "TerminateJobResponse":{ - "type":"structure", - "members":{ - } - }, - "Ulimit":{ - "type":"structure", - "required":[ - "hardLimit", - "name", - "softLimit" - ], - "members":{ - "hardLimit":{ - "shape":"Integer", - "documentation":"

The hard limit for the ulimit type.

" - }, - "name":{ - "shape":"String", - "documentation":"

The type of the ulimit.

" - }, - "softLimit":{ - "shape":"Integer", - "documentation":"

The soft limit for the ulimit type.

" - } - }, - "documentation":"

The ulimit settings to pass to the container.

" - }, - "Ulimits":{ - "type":"list", - "member":{"shape":"Ulimit"} - }, - "UpdateComputeEnvironmentRequest":{ - "type":"structure", - "required":["computeEnvironment"], - "members":{ - "computeEnvironment":{ - "shape":"String", - "documentation":"

The name or full Amazon Resource Name (ARN) of the compute environment to update.

" - }, - "state":{ - "shape":"CEState", - "documentation":"

The state of the compute environment. Compute environments in the ENABLED state can accept jobs from a queue and scale in or out automatically based on the workload demand of its associated queues.

" - }, - "computeResources":{ - "shape":"ComputeResourceUpdate", - "documentation":"

Details of the compute resources managed by the compute environment. Required for a managed compute environment.

" - }, - "serviceRole":{ - "shape":"String", - "documentation":"

The full Amazon Resource Name (ARN) of the IAM role that allows AWS Batch to make calls to other AWS services on your behalf.

If your specified role has a path other than /, then you must either specify the full role ARN (this is recommended) or prefix the role name with the path.

Depending on how you created your AWS Batch service role, its ARN may contain the service-role path prefix. When you only specify the name of the service role, AWS Batch assumes that your ARN does not use the service-role path prefix. Because of this, we recommend that you specify the full ARN of your service role when you create compute environments.

" - } - } - }, - "UpdateComputeEnvironmentResponse":{ - "type":"structure", - "members":{ - "computeEnvironmentName":{ - "shape":"String", - "documentation":"

The name of compute environment.

" - }, - "computeEnvironmentArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the compute environment.

" - } - } - }, - "UpdateJobQueueRequest":{ - "type":"structure", - "required":["jobQueue"], - "members":{ - "jobQueue":{ - "shape":"String", - "documentation":"

The name or the Amazon Resource Name (ARN) of the job queue.

" - }, - "state":{ - "shape":"JQState", - "documentation":"

Describes the queue's ability to accept new jobs.

" - }, - "priority":{ - "shape":"Integer", - "documentation":"

The priority of the job queue. Job queues with a higher priority (or a higher integer value for the priority parameter) are evaluated first when associated with same compute environment. Priority is determined in descending order, for example, a job queue with a priority value of 10 is given scheduling preference over a job queue with a priority value of 1.

" - }, - "computeEnvironmentOrder":{ - "shape":"ComputeEnvironmentOrders", - "documentation":"

Details the set of compute environments mapped to a job queue and their order relative to each other. This is one of the parameters used by the job scheduler to determine which compute environment should execute a given job.

" - } - } - }, - "UpdateJobQueueResponse":{ - "type":"structure", - "members":{ - "jobQueueName":{ - "shape":"String", - "documentation":"

The name of the job queue.

" - }, - "jobQueueArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the job queue.

" - } - } - }, - "Volume":{ - "type":"structure", - "members":{ - "host":{ - "shape":"Host", - "documentation":"

The contents of the host parameter determine whether your data volume persists on the host container instance and where it is stored. If the host parameter is empty, then the Docker daemon assigns a host path for your data volume. However, the data is not guaranteed to persist after the containers associated with it stop running.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. This name is referenced in the sourceVolume parameter of container definition mountPoints.

" - } - }, - "documentation":"

A data volume used in a job's container properties.

" - }, - "Volumes":{ - "type":"list", - "member":{"shape":"Volume"} - } - }, - "documentation":"

AWS Batch enables you to run batch computing workloads on the AWS Cloud. Batch computing is a common way for developers, scientists, and engineers to access large amounts of compute resources, and AWS Batch removes the undifferentiated heavy lifting of configuring and managing the required infrastructure. AWS Batch will be familiar to users of traditional batch computing software. This service can efficiently provision resources in response to jobs submitted in order to eliminate capacity constraints, reduce compute costs, and deliver results quickly.

As a fully managed service, AWS Batch enables developers, scientists, and engineers to run batch computing workloads of any scale. AWS Batch automatically provisions compute resources and optimizes the workload distribution based on the quantity and scale of the workloads. With AWS Batch, there is no need to install or manage batch computing software, which allows you to focus on analyzing results and solving problems. AWS Batch reduces operational complexities, saves time, and reduces costs, which makes it easy for developers, scientists, and engineers to run their batch jobs in the AWS Cloud.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/service-2.json deleted file mode 100644 index 67723dc8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/budgets/2016-10-20/service-2.json +++ /dev/null @@ -1,1055 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-10-20", - "endpointPrefix":"budgets", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWSBudgets", - "serviceFullName":"AWS Budgets", - "serviceId":"Budgets", - "signatureVersion":"v4", - "targetPrefix":"AWSBudgetServiceGateway", - "uid":"budgets-2016-10-20" - }, - "operations":{ - "CreateBudget":{ - "name":"CreateBudget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBudgetRequest"}, - "output":{"shape":"CreateBudgetResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"CreationLimitExceededException"}, - {"shape":"DuplicateRecordException"} - ], - "documentation":"

Creates a budget and, if included, notifications and subscribers.

" - }, - "CreateNotification":{ - "name":"CreateNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNotificationRequest"}, - "output":{"shape":"CreateNotificationResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"CreationLimitExceededException"}, - {"shape":"DuplicateRecordException"} - ], - "documentation":"

Creates a notification. You must create the budget before you create the associated notification.

" - }, - "CreateSubscriber":{ - "name":"CreateSubscriber", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubscriberRequest"}, - "output":{"shape":"CreateSubscriberResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"CreationLimitExceededException"}, - {"shape":"DuplicateRecordException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Creates a subscriber. You must create the associated budget and notification before you create the subscriber.

" - }, - "DeleteBudget":{ - "name":"DeleteBudget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBudgetRequest"}, - "output":{"shape":"DeleteBudgetResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a budget. You can delete your budget at any time.

Deleting a budget also deletes the notifications and subscribers associated with that budget.

" - }, - "DeleteNotification":{ - "name":"DeleteNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNotificationRequest"}, - "output":{"shape":"DeleteNotificationResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a notification.

Deleting a notification also deletes the subscribers associated with the notification.

" - }, - "DeleteSubscriber":{ - "name":"DeleteSubscriber", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubscriberRequest"}, - "output":{"shape":"DeleteSubscriberResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a subscriber.

Deleting the last subscriber to a notification also deletes the notification.

" - }, - "DescribeBudget":{ - "name":"DescribeBudget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBudgetRequest"}, - "output":{"shape":"DescribeBudgetResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Describes a budget.

" - }, - "DescribeBudgets":{ - "name":"DescribeBudgets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBudgetsRequest"}, - "output":{"shape":"DescribeBudgetsResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Lists the budgets associated with an account.

" - }, - "DescribeNotificationsForBudget":{ - "name":"DescribeNotificationsForBudget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNotificationsForBudgetRequest"}, - "output":{"shape":"DescribeNotificationsForBudgetResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Lists the notifications associated with a budget.

" - }, - "DescribeSubscribersForNotification":{ - "name":"DescribeSubscribersForNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubscribersForNotificationRequest"}, - "output":{"shape":"DescribeSubscribersForNotificationResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Lists the subscribers associated with a notification.

" - }, - "UpdateBudget":{ - "name":"UpdateBudget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateBudgetRequest"}, - "output":{"shape":"UpdateBudgetResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend. When a budget is modified, the calculatedSpend drops to zero until AWS has new usage data to use for forecasting.

" - }, - "UpdateNotification":{ - "name":"UpdateNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNotificationRequest"}, - "output":{"shape":"UpdateNotificationResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"DuplicateRecordException"} - ], - "documentation":"

Updates a notification.

" - }, - "UpdateSubscriber":{ - "name":"UpdateSubscriber", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSubscriberRequest"}, - "output":{"shape":"UpdateSubscriberResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"DuplicateRecordException"} - ], - "documentation":"

Updates a subscriber.

" - } - }, - "shapes":{ - "AccountId":{ - "type":"string", - "documentation":"

The account ID of the customer. It should be a 12 digit number.

", - "max":12, - "min":12 - }, - "Budget":{ - "type":"structure", - "required":[ - "BudgetName", - "TimeUnit", - "BudgetType" - ], - "members":{ - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of a budget. Unique within accounts. : and \\ characters are not allowed in the BudgetName.

" - }, - "BudgetLimit":{ - "shape":"Spend", - "documentation":"

The total amount of cost, usage, or RI utilization that you want to track with your budget.

BudgetLimit is required for cost or usage budgets, but optional for RI utilization budgets. RI utilization budgets default to the only valid value for RI utilization budgets, which is 100.

" - }, - "CostFilters":{ - "shape":"CostFilters", - "documentation":"

The cost filters applied to a budget, such as service or region.

" - }, - "CostTypes":{ - "shape":"CostTypes", - "documentation":"

The types of costs included in this budget.

" - }, - "TimeUnit":{ - "shape":"TimeUnit", - "documentation":"

The length of time until a budget resets the actual and forecasted spend.

" - }, - "TimePeriod":{ - "shape":"TimePeriod", - "documentation":"

The period of time covered by a budget. Has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date.

If you created your budget and didn't specify a start date, AWS defaults to the start of your chosen time period (i.e. DAILY, MONTHLY, QUARTERLY, ANNUALLY). For example, if you created your budget on January 24th 2018, chose DAILY, and didn't set a start date, AWS set your start date to 01/24/18 00:00 UTC. If you chose MONTHLY, AWS set your start date to 01/01/18 00:00 UTC. If you didn't specify an end date, AWS set your end date to 06/15/87 00:00 UTC. The defaults are the same for the AWS Billing and Cost Management console and the API.

You can change either date with the UpdateBudget operation.

After the end date, AWS deletes the budget and all associated notifications and subscribers.

" - }, - "CalculatedSpend":{ - "shape":"CalculatedSpend", - "documentation":"

The actual and forecasted cost or usage being tracked by a budget.

" - }, - "BudgetType":{ - "shape":"BudgetType", - "documentation":"

Whether this budget tracks monetary costs, usage, or RI utilization.

" - } - }, - "documentation":"

Represents the output of the CreateBudget operation. The content consists of the detailed metadata and data file information, and the current status of the budget.

The ARN pattern for a budget is: arn:aws:budgetservice::AccountId:budget/budgetName

" - }, - "BudgetName":{ - "type":"string", - "documentation":"

A string represents the budget name. No \":\" and \"\\\" character is allowed.

", - "max":100, - "pattern":"[^:\\\\]+" - }, - "BudgetType":{ - "type":"string", - "documentation":"

The type of a budget. It should be COST, USAGE, or RI_UTILIZATION.

", - "enum":[ - "USAGE", - "COST", - "RI_UTILIZATION", - "RI_COVERAGE" - ] - }, - "Budgets":{ - "type":"list", - "member":{"shape":"Budget"}, - "documentation":"

A list of budgets

" - }, - "CalculatedSpend":{ - "type":"structure", - "required":["ActualSpend"], - "members":{ - "ActualSpend":{ - "shape":"Spend", - "documentation":"

The amount of cost, usage, or RI units that you have used.

" - }, - "ForecastedSpend":{ - "shape":"Spend", - "documentation":"

The amount of cost, usage, or RI units that you are forecasted to use.

" - } - }, - "documentation":"

The spend objects associated with this budget. The actualSpend tracks how much you've used, cost, usage, or RI units, and the forecastedSpend tracks how much you are predicted to spend if your current usage remains steady.

For example, if it is the 20th of the month and you have spent 50 dollars on Amazon EC2, your actualSpend is 50 USD, and your forecastedSpend is 75 USD.

" - }, - "ComparisonOperator":{ - "type":"string", - "documentation":"

The comparison operator of a notification. Currently we support less than, equal to and greater than.

", - "enum":[ - "GREATER_THAN", - "LESS_THAN", - "EQUAL_TO" - ] - }, - "CostFilters":{ - "type":"map", - "key":{"shape":"GenericString"}, - "value":{"shape":"DimensionValues"}, - "documentation":"

A map that represents the cost filters applied to the budget.

" - }, - "CostTypes":{ - "type":"structure", - "members":{ - "IncludeTax":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes taxes.

The default value is true.

" - }, - "IncludeSubscription":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes subscriptions.

The default value is true.

" - }, - "UseBlended":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget uses blended rate.

The default value is false.

" - }, - "IncludeRefund":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes refunds.

The default value is true.

" - }, - "IncludeCredit":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes credits.

The default value is true.

" - }, - "IncludeUpfront":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes upfront RI costs.

The default value is true.

" - }, - "IncludeRecurring":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes recurring fees such as monthly RI fees.

The default value is true.

" - }, - "IncludeOtherSubscription":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes non-RI subscription costs.

The default value is true.

" - }, - "IncludeSupport":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes support subscription fees.

The default value is true.

" - }, - "IncludeDiscount":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget includes discounts.

The default value is true.

" - }, - "UseAmortized":{ - "shape":"NullableBoolean", - "documentation":"

Specifies whether a budget uses the amortized rate.

The default value is false.

" - } - }, - "documentation":"

The types of cost included in a budget, such as tax and subscriptions.

" - }, - "CreateBudgetRequest":{ - "type":"structure", - "required":[ - "AccountId", - "Budget" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget.

" - }, - "Budget":{ - "shape":"Budget", - "documentation":"

The budget object that you want to create.

" - }, - "NotificationsWithSubscribers":{ - "shape":"NotificationWithSubscribersList", - "documentation":"

A notification that you want to associate with a budget. A budget can have up to five notifications, and each notification can have one SNS subscriber and up to ten email subscribers. If you include notifications and subscribers in your CreateBudget call, AWS creates the notifications and subscribers for you.

" - } - }, - "documentation":"

Request of CreateBudget

" - }, - "CreateBudgetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of CreateBudget

" - }, - "CreateNotificationRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification", - "Subscribers" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget that you want to create a notification for.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget that you want AWS to notified you about. Budget names must be unique within an account.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification that you want to create.

" - }, - "Subscribers":{ - "shape":"Subscribers", - "documentation":"

A list of subscribers that you want to associate with the notification. Each notification can have one SNS subscriber and up to ten email subscribers.

" - } - }, - "documentation":"

Request of CreateNotification

" - }, - "CreateNotificationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of CreateNotification

" - }, - "CreateSubscriberRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification", - "Subscriber" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId associated with the budget that you want to create a subscriber for.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget that you want to subscribe to. Budget names must be unique within an account.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification that you want to create a subscriber for.

" - }, - "Subscriber":{ - "shape":"Subscriber", - "documentation":"

The subscriber that you want to associate with a budget notification.

" - } - }, - "documentation":"

Request of CreateSubscriber

" - }, - "CreateSubscriberResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of CreateSubscriber

" - }, - "CreationLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

You've exceeded the notification or subscriber limit.

", - "exception":true - }, - "DeleteBudgetRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget that you want to delete.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget that you want to delete.

" - } - }, - "documentation":"

Request of DeleteBudget

" - }, - "DeleteBudgetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of DeleteBudget

" - }, - "DeleteNotificationRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose notification you want to delete.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose notification you want to delete.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification that you want to delete.

" - } - }, - "documentation":"

Request of DeleteNotification

" - }, - "DeleteNotificationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of DeleteNotification

" - }, - "DeleteSubscriberRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification", - "Subscriber" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose subscriber you want to delete.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose subscriber you want to delete.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification whose subscriber you want to delete.

" - }, - "Subscriber":{ - "shape":"Subscriber", - "documentation":"

The subscriber that you want to delete.

" - } - }, - "documentation":"

Request of DeleteSubscriber

" - }, - "DeleteSubscriberResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of DeleteSubscriber

" - }, - "DescribeBudgetRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget that you want a description of.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget that you want a description of.

" - } - }, - "documentation":"

Request of DescribeBudget

" - }, - "DescribeBudgetResponse":{ - "type":"structure", - "members":{ - "Budget":{ - "shape":"Budget", - "documentation":"

The description of the budget.

" - } - }, - "documentation":"

Response of DescribeBudget

" - }, - "DescribeBudgetsRequest":{ - "type":"structure", - "required":["AccountId"], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budgets that you want descriptions of.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Optional integer. Specifies the maximum number of results to return in response.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

Request of DescribeBudgets

" - }, - "DescribeBudgetsResponse":{ - "type":"structure", - "members":{ - "Budgets":{ - "shape":"Budgets", - "documentation":"

A list of budgets.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results that you can retrieve.

" - } - }, - "documentation":"

Response of DescribeBudgets

" - }, - "DescribeNotificationsForBudgetRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose notifications you want descriptions of.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose notifications you want descriptions of.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Optional integer. Specifies the maximum number of results to return in response.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

Request of DescribeNotificationsForBudget

" - }, - "DescribeNotificationsForBudgetResponse":{ - "type":"structure", - "members":{ - "Notifications":{ - "shape":"Notifications", - "documentation":"

A list of notifications associated with a budget.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results that you can retrieve.

" - } - }, - "documentation":"

Response of GetNotificationsForBudget

" - }, - "DescribeSubscribersForNotificationRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose subscribers you want descriptions of.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose subscribers you want descriptions of.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification whose subscribers you want to list.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Optional integer. Specifies the maximum number of results to return in response.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

Request of DescribeSubscribersForNotification

" - }, - "DescribeSubscribersForNotificationResponse":{ - "type":"structure", - "members":{ - "Subscribers":{ - "shape":"Subscribers", - "documentation":"

A list of subscribers associated with a notification.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

The pagination token that indicates the next set of results that you can retrieve.

" - } - }, - "documentation":"

Response of DescribeSubscribersForNotification

" - }, - "DimensionValues":{ - "type":"list", - "member":{"shape":"GenericString"} - }, - "DuplicateRecordException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The budget name already exists. Budget names must be unique within an account.

", - "exception":true - }, - "ExpiredNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The pagination token expired.

", - "exception":true - }, - "GenericString":{ - "type":"string", - "documentation":"

A generic String.

" - }, - "GenericTimestamp":{ - "type":"timestamp", - "documentation":"

A generic timestamp. In Java it is transformed to a Date object.

" - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

An error on the server occurred during the processing of your request. Try again later.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The pagination token is invalid.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

", - "exception":true - }, - "MaxResults":{ - "type":"integer", - "documentation":"

An integer to represent how many entries a paginated response contains. Maximum is set to 100.

", - "box":true, - "max":100, - "min":1 - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

We can’t locate the resource that you specified.

", - "exception":true - }, - "Notification":{ - "type":"structure", - "required":[ - "NotificationType", - "ComparisonOperator", - "Threshold" - ], - "members":{ - "NotificationType":{ - "shape":"NotificationType", - "documentation":"

Whether the notification is for how much you have spent (ACTUAL) or for how much you are forecasted to spend (FORECASTED).

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The comparison used for this notification.

" - }, - "Threshold":{ - "shape":"NotificationThreshold", - "documentation":"

The threshold associated with a notification. Thresholds are always a percentage.

" - }, - "ThresholdType":{ - "shape":"ThresholdType", - "documentation":"

The type of threshold for a notification. For ACTUAL thresholds, AWS notifies you when you go over the threshold, and for FORECASTED thresholds AWS notifies you when you are forecasted to go over the threshold.

" - } - }, - "documentation":"

A notification associated with a budget. A budget can have up to five notifications.

Each notification must have at least one subscriber. A notification can have one SNS subscriber and up to ten email subscribers, for a total of 11 subscribers.

For example, if you have a budget for 200 dollars and you want to be notified when you go over 160 dollars, create a notification with the following parameters:

  • A notificationType of ACTUAL

  • A comparisonOperator of GREATER_THAN

  • A notification threshold of 80

" - }, - "NotificationThreshold":{ - "type":"double", - "documentation":"

The threshold of a notification. It should be a number between 0 and 1,000,000,000.

", - "max":1000000000, - "min":0.1 - }, - "NotificationType":{ - "type":"string", - "documentation":"

The type of a notification. It should be ACTUAL or FORECASTED.

", - "enum":[ - "ACTUAL", - "FORECASTED" - ] - }, - "NotificationWithSubscribers":{ - "type":"structure", - "required":[ - "Notification", - "Subscribers" - ], - "members":{ - "Notification":{ - "shape":"Notification", - "documentation":"

The notification associated with a budget.

" - }, - "Subscribers":{ - "shape":"Subscribers", - "documentation":"

A list of subscribers who are subscribed to this notification.

" - } - }, - "documentation":"

A notification with subscribers. A notification can have one SNS subscriber and up to ten email subscribers, for a total of 11 subscribers.

" - }, - "NotificationWithSubscribersList":{ - "type":"list", - "member":{"shape":"NotificationWithSubscribers"}, - "documentation":"

A list of Notifications, each with a list of subscribers.

", - "max":5 - }, - "Notifications":{ - "type":"list", - "member":{"shape":"Notification"}, - "documentation":"

A list of notifications.

" - }, - "NullableBoolean":{ - "type":"boolean", - "box":true - }, - "NumericValue":{ - "type":"string", - "documentation":"

A string to represent NumericValue.

", - "pattern":"([0-9]*\\.)?[0-9]+" - }, - "Spend":{ - "type":"structure", - "required":[ - "Amount", - "Unit" - ], - "members":{ - "Amount":{ - "shape":"NumericValue", - "documentation":"

The cost or usage amount associated with a budget forecast, actual spend, or budget threshold.

" - }, - "Unit":{ - "shape":"UnitValue", - "documentation":"

The unit of measurement used for the budget forecast, actual spend, or budget threshold, such as dollars or GB.

" - } - }, - "documentation":"

The amount of cost or usage being measured for a budget.

For example, a Spend for 3 GB of S3 usage would have the following parameters:

  • An Amount of 3

  • A unit of GB

" - }, - "Subscriber":{ - "type":"structure", - "required":[ - "SubscriptionType", - "Address" - ], - "members":{ - "SubscriptionType":{ - "shape":"SubscriptionType", - "documentation":"

The type of notification that AWS sends to a subscriber.

" - }, - "Address":{ - "shape":"SubscriberAddress", - "documentation":"

The address that AWS sends budget notifications to, either an SNS topic or an email.

" - } - }, - "documentation":"

The subscriber to a budget notification. The subscriber consists of a subscription type and either an Amazon Simple Notification Service topic or an email address.

For example, an email subscriber would have the following parameters:

  • A subscriptionType of EMAIL

  • An address of example@example.com

" - }, - "SubscriberAddress":{ - "type":"string", - "documentation":"

String containing email or sns topic for the subscriber address.

", - "min":1 - }, - "Subscribers":{ - "type":"list", - "member":{"shape":"Subscriber"}, - "documentation":"

A list of subscribers.

", - "max":11, - "min":1 - }, - "SubscriptionType":{ - "type":"string", - "documentation":"

The subscription type of the subscriber. It can be SMS or EMAIL.

", - "enum":[ - "SNS", - "EMAIL" - ] - }, - "ThresholdType":{ - "type":"string", - "documentation":"

The type of threshold for a notification. It can be PERCENTAGE or ABSOLUTE_VALUE.

", - "enum":[ - "PERCENTAGE", - "ABSOLUTE_VALUE" - ] - }, - "TimePeriod":{ - "type":"structure", - "members":{ - "Start":{ - "shape":"GenericTimestamp", - "documentation":"

The start date for a budget. If you created your budget and didn't specify a start date, AWS defaults to the start of your chosen time period (i.e. DAILY, MONTHLY, QUARTERLY, ANNUALLY). For example, if you created your budget on January 24th 2018, chose DAILY, and didn't set a start date, AWS set your start date to 01/24/18 00:00 UTC. If you chose MONTHLY, AWS set your start date to 01/01/18 00:00 UTC. The defaults are the same for the AWS Billing and Cost Management console and the API.

You can change your start date with the UpdateBudget operation.

" - }, - "End":{ - "shape":"GenericTimestamp", - "documentation":"

The end date for a budget. If you didn't specify an end date, AWS set your end date to 06/15/87 00:00 UTC. The defaults are the same for the AWS Billing and Cost Management console and the API.

After the end date, AWS deletes the budget and all associated notifications and subscribers. You can change your end date with the UpdateBudget operation.

" - } - }, - "documentation":"

The period of time covered by a budget. Has a start date and an end date. The start date must come before the end date. There are no restrictions on the end date.

" - }, - "TimeUnit":{ - "type":"string", - "documentation":"

The time unit of the budget. e.g. MONTHLY, QUARTERLY, etc.

", - "enum":[ - "DAILY", - "MONTHLY", - "QUARTERLY", - "ANNUALLY" - ] - }, - "UnitValue":{ - "type":"string", - "documentation":"

A string to represent budget spend unit. It should be not null and not empty.

", - "min":1 - }, - "UpdateBudgetRequest":{ - "type":"structure", - "required":[ - "AccountId", - "NewBudget" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget that you want to update.

" - }, - "NewBudget":{ - "shape":"Budget", - "documentation":"

The budget that you want to update your budget to.

" - } - }, - "documentation":"

Request of UpdateBudget

" - }, - "UpdateBudgetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of UpdateBudget

" - }, - "UpdateNotificationRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "OldNotification", - "NewNotification" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose notification you want to update.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose notification you want to update.

" - }, - "OldNotification":{ - "shape":"Notification", - "documentation":"

The previous notification associated with a budget.

" - }, - "NewNotification":{ - "shape":"Notification", - "documentation":"

The updated notification to be associated with a budget.

" - } - }, - "documentation":"

Request of UpdateNotification

" - }, - "UpdateNotificationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of UpdateNotification

" - }, - "UpdateSubscriberRequest":{ - "type":"structure", - "required":[ - "AccountId", - "BudgetName", - "Notification", - "OldSubscriber", - "NewSubscriber" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The accountId that is associated with the budget whose subscriber you want to update.

" - }, - "BudgetName":{ - "shape":"BudgetName", - "documentation":"

The name of the budget whose subscriber you want to update.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The notification whose subscriber you want to update.

" - }, - "OldSubscriber":{ - "shape":"Subscriber", - "documentation":"

The previous subscriber associated with a budget notification.

" - }, - "NewSubscriber":{ - "shape":"Subscriber", - "documentation":"

The updated subscriber associated with a budget notification.

" - } - }, - "documentation":"

Request of UpdateSubscriber

" - }, - "UpdateSubscriberResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response of UpdateSubscriber

" - }, - "errorMessage":{ - "type":"string", - "documentation":"

The error message the exception carries.

" - } - }, - "documentation":"

Budgets enable you to plan your service usage, service costs, and your RI utilization. You can also track how close your plan is to your budgeted amount or to the free tier limits. Budgets provide you with a quick way to see your usage-to-date and current estimated charges from AWS and to see how much your predicted usage accrues in charges by the end of the month. Budgets also compare current estimates and charges to the amount that you indicated you want to use or spend and lets you see how much of your budget has been used. AWS updates your budget status several times a day. Budgets track your unblended costs, subscriptions, and refunds. You can create the following types of budgets:

  • Cost budgets allow you to say how much you want to spend on a service.

  • Usage budgets allow you to say how many hours you want to use for one or more services.

  • RI utilization budgets allow you to define a utilization threshold and receive alerts when RIs are tracking below that threshold.

You can create up to 20,000 budgets per AWS master account. Your first two budgets are free of charge. Each additional budget costs $0.02 per day. You can set up optional notifications that warn you if you exceed, or are forecasted to exceed, your budgeted amount. You can have notifications sent to an Amazon SNS topic, to an email address, or to both. For more information, see Creating an Amazon SNS Topic for Budget Notifications. AWS Free Tier usage alerts via AWS Budgets are provided for you, and do not count toward your budget limits.

Service Endpoint

The AWS Budgets API provides the following endpoint:

  • https://budgets.amazonaws.com

For information about costs associated with the AWS Budgets API, see AWS Cost Management Pricing.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/service-2.json deleted file mode 100644 index edd511dc..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ce/2017-10-25/service-2.json +++ /dev/null @@ -1,1303 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-25", - "endpointPrefix":"ce", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWS Cost Explorer", - "serviceFullName":"AWS Cost Explorer Service", - "serviceId":"Cost Explorer", - "signatureVersion":"v4", - "signingName":"ce", - "targetPrefix":"AWSInsightsIndexService", - "uid":"ce-2017-10-25" - }, - "operations":{ - "GetCostAndUsage":{ - "name":"GetCostAndUsage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCostAndUsageRequest"}, - "output":{"shape":"GetCostAndUsageResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"BillExpirationException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"RequestChangedException"} - ], - "documentation":"

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Master accounts in an organization in AWS Organizations have access to all member accounts.

" - }, - "GetDimensionValues":{ - "name":"GetDimensionValues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDimensionValuesRequest"}, - "output":{"shape":"GetDimensionValuesResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"BillExpirationException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"RequestChangedException"} - ], - "documentation":"

Retrieves all available filter values for a specified filter over a period of time. You can search the dimension values for an arbitrary string.

" - }, - "GetReservationCoverage":{ - "name":"GetReservationCoverage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservationCoverageRequest"}, - "output":{"shape":"GetReservationCoverageResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves the reservation coverage for your account. This allows you to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's master account can see the coverage of the associated member accounts. For any time period, you can filter data about reservation usage by the following dimensions:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • SERVICE

  • TAG

  • TENANCY

To determine valid values for a dimension, use the GetDimensionValues operation.

" - }, - "GetReservationPurchaseRecommendation":{ - "name":"GetReservationPurchaseRecommendation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservationPurchaseRecommendationRequest"}, - "output":{"shape":"GetReservationPurchaseRecommendationResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

AWS generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After AWS has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.

For example, AWS automatically aggregates your EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. AWS recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible RI. AWS also shows the equal number of normalized units so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large, because that is the smallest size instance in the c4 instance family.

" - }, - "GetReservationUtilization":{ - "name":"GetReservationUtilization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservationUtilizationRequest"}, - "output":{"shape":"GetReservationUtilizationResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves the reservation utilization for your account. Master accounts in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

" - }, - "GetTags":{ - "name":"GetTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTagsRequest"}, - "output":{"shape":"GetTagsResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"BillExpirationException"}, - {"shape":"DataUnavailableException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"RequestChangedException"} - ], - "documentation":"

Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

" - } - }, - "shapes":{ - "AccountScope":{ - "type":"string", - "enum":[ - "PAYER", - "LINKED" - ] - }, - "AmortizedRecurringFee":{"type":"string"}, - "AmortizedUpfrontFee":{"type":"string"}, - "AttributeType":{"type":"string"}, - "AttributeValue":{"type":"string"}, - "Attributes":{ - "type":"map", - "key":{"shape":"AttributeType"}, - "value":{"shape":"AttributeValue"} - }, - "BillExpirationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The requested report expired. Update the date interval and try again.

", - "exception":true - }, - "Context":{ - "type":"string", - "enum":[ - "COST_AND_USAGE", - "RESERVATIONS" - ] - }, - "Coverage":{ - "type":"structure", - "members":{ - "CoverageHours":{ - "shape":"CoverageHours", - "documentation":"

The amount of instance usage that a reservation covered, in hours.

" - } - }, - "documentation":"

The amount of instance usage that a reservation covered.

" - }, - "CoverageByTime":{ - "type":"structure", - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The period over which this coverage was used.

" - }, - "Groups":{ - "shape":"ReservationCoverageGroups", - "documentation":"

The groups of instances that are covered by a reservation.

" - }, - "Total":{ - "shape":"Coverage", - "documentation":"

The total reservation coverage, in hours.

" - } - }, - "documentation":"

Reservation coverage for a specified period, in hours.

" - }, - "CoverageHours":{ - "type":"structure", - "members":{ - "OnDemandHours":{ - "shape":"OnDemandHours", - "documentation":"

The number of instance running hours that are covered by On-Demand Instances.

" - }, - "ReservedHours":{ - "shape":"ReservedHours", - "documentation":"

The number of instance running hours that are covered by reservations.

" - }, - "TotalRunningHours":{ - "shape":"TotalRunningHours", - "documentation":"

The total instance usage, in hours.

" - }, - "CoverageHoursPercentage":{ - "shape":"CoverageHoursPercentage", - "documentation":"

The percentage of instance hours that are covered by a reservation.

" - } - }, - "documentation":"

How long a running instance either used a reservation or was On-Demand.

" - }, - "CoverageHoursPercentage":{"type":"string"}, - "CoveragesByTime":{ - "type":"list", - "member":{"shape":"CoverageByTime"} - }, - "DataUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The requested data is unavailable.

", - "exception":true - }, - "DateInterval":{ - "type":"structure", - "required":[ - "Start", - "End" - ], - "members":{ - "Start":{ - "shape":"YearMonthDay", - "documentation":"

The beginning of the time period that you want the usage and costs for. The start date is inclusive. For example, if start is 2017-01-01, AWS retrieves cost and usage data starting at 2017-01-01 up to the end date.

" - }, - "End":{ - "shape":"YearMonthDay", - "documentation":"

The end of the time period that you want the usage and costs for. The end date is exclusive. For example, if end is 2017-05-01, AWS retrieves cost and usage data from the start date up to, but not including, 2017-05-01.

" - } - }, - "documentation":"

The time period that you want the usage and costs for.

" - }, - "Dimension":{ - "type":"string", - "enum":[ - "AZ", - "INSTANCE_TYPE", - "LINKED_ACCOUNT", - "OPERATION", - "PURCHASE_TYPE", - "REGION", - "SERVICE", - "USAGE_TYPE", - "USAGE_TYPE_GROUP", - "RECORD_TYPE", - "OPERATING_SYSTEM", - "TENANCY", - "SCOPE", - "PLATFORM", - "SUBSCRIPTION_ID", - "LEGAL_ENTITY_NAME", - "DEPLOYMENT_OPTION", - "DATABASE_ENGINE", - "CACHE_ENGINE", - "INSTANCE_TYPE_FAMILY" - ] - }, - "DimensionValues":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"Dimension", - "documentation":"

The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones.

" - }, - "Values":{ - "shape":"Values", - "documentation":"

The metadata values that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

" - } - }, - "documentation":"

The metadata that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

" - }, - "DimensionValuesWithAttributes":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Value", - "documentation":"

The value of a dimension with a specific attribute.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

The attribute that applies to a specific Dimension.

" - } - }, - "documentation":"

The metadata of a specific type that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

" - }, - "DimensionValuesWithAttributesList":{ - "type":"list", - "member":{"shape":"DimensionValuesWithAttributes"} - }, - "EC2InstanceDetails":{ - "type":"structure", - "members":{ - "Family":{ - "shape":"GenericString", - "documentation":"

The instance family of the recommended reservation.

" - }, - "InstanceType":{ - "shape":"GenericString", - "documentation":"

The type of instance that AWS recommends.

" - }, - "Region":{ - "shape":"GenericString", - "documentation":"

The AWS Region of the recommended reservation.

" - }, - "AvailabilityZone":{ - "shape":"GenericString", - "documentation":"

The Availability Zone of the recommended reservation.

" - }, - "Platform":{ - "shape":"GenericString", - "documentation":"

The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.

" - }, - "Tenancy":{ - "shape":"GenericString", - "documentation":"

Whether the recommended reservation is dedicated or shared.

" - }, - "CurrentGeneration":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommendation is for a current generation instance.

" - }, - "SizeFlexEligible":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommended reservation is size flexible.

" - } - }, - "documentation":"

Details about the EC2 instances that AWS recommends that you purchase.

" - }, - "EC2Specification":{ - "type":"structure", - "members":{ - "OfferingClass":{ - "shape":"OfferingClass", - "documentation":"

Whether you want a recommendation for standard or convertible reservations.

" - } - }, - "documentation":"

The EC2 hardware specifications that you want AWS to provide recommendations for.

" - }, - "ESInstanceDetails":{ - "type":"structure", - "members":{ - "InstanceClass":{ - "shape":"GenericString", - "documentation":"

The class of instance that AWS recommends.

" - }, - "InstanceSize":{ - "shape":"GenericString", - "documentation":"

The size of instance that AWS recommends.

" - }, - "Region":{ - "shape":"GenericString", - "documentation":"

The AWS Region of the recommended reservation.

" - }, - "CurrentGeneration":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommendation is for a current generation instance.

" - }, - "SizeFlexEligible":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommended reservation is size flexible.

" - } - }, - "documentation":"

Details about the ES instances that AWS recommends that you purchase.

" - }, - "ElastiCacheInstanceDetails":{ - "type":"structure", - "members":{ - "Family":{ - "shape":"GenericString", - "documentation":"

The instance family of the recommended reservation.

" - }, - "NodeType":{ - "shape":"GenericString", - "documentation":"

The type of node that AWS recommends.

" - }, - "Region":{ - "shape":"GenericString", - "documentation":"

The AWS Region of the recommended reservation.

" - }, - "ProductDescription":{ - "shape":"GenericString", - "documentation":"

The description of the recommended reservation.

" - }, - "CurrentGeneration":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommendation is for a current generation instance.

" - }, - "SizeFlexEligible":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommended reservation is size flexible.

" - } - }, - "documentation":"

Details about the ElastiCache instances that AWS recommends that you purchase.

" - }, - "Entity":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "Estimated":{"type":"boolean"}, - "Expression":{ - "type":"structure", - "members":{ - "Or":{ - "shape":"Expressions", - "documentation":"

Return results that match either Dimension object.

" - }, - "And":{ - "shape":"Expressions", - "documentation":"

Return results that match both Dimension objects.

" - }, - "Not":{ - "shape":"Expression", - "documentation":"

Return results that don't match a Dimension object.

" - }, - "Dimensions":{ - "shape":"DimensionValues", - "documentation":"

The specific Dimension to use for Expression.

" - }, - "Tags":{ - "shape":"TagValues", - "documentation":"

The specific Tag to use for Expression.

" - } - }, - "documentation":"

Use Expression to filter by cost or by usage. There are two patterns:

  • Simple dimension values - You can set the dimension name and values for the filters that you plan to use. For example, you can filter for INSTANCE_TYPE==m4.xlarge OR INSTANCE_TYPE==c4.large. The Expression for that looks like this:

    { \"Dimensions\": { \"Key\": \"INSTANCE_TYPE\", \"Values\": [ \"m4.xlarge\", “c4.large” ] } }

    The list of dimension values are OR'd together to retrieve cost or usage data. You can create Expression and DimensionValues objects using either with* methods or set* methods in multiple lines.

  • Compound dimension values with logical operations - You can use multiple Expression types and the logical operators AND/OR/NOT to create a list of one or more Expression objects. This allows you to filter on more advanced options. For example, you can filter on ((INSTANCE_TYPE == m4.large OR INSTANCE_TYPE == m3.large) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). The Expression for that looks like this:

    { \"And\": [ {\"Or\": [ {\"Dimensions\": { \"Key\": \"INSTANCE_TYPE\", \"Values\": [ \"m4.x.large\", \"c4.large\" ] }}, {\"Tags\": { \"Key\": \"TagName\", \"Values\": [\"Value1\"] } } ]}, {\"Not\": {\"Dimensions\": { \"Key\": \"USAGE_TYPE\", \"Values\": [\"DataTransfer\"] }}} ] }

    Because each Expression can have only one operator, the service returns an error if more than one is specified. The following example shows an Expression object that creates an error.

    { \"And\": [ ... ], \"DimensionValues\": { \"Dimension\": \"USAGE_TYPE\", \"Values\": [ \"DataTransfer\" ] } }

" - }, - "Expressions":{ - "type":"list", - "member":{"shape":"Expression"} - }, - "GenericBoolean":{"type":"boolean"}, - "GenericString":{"type":"string"}, - "GetCostAndUsageRequest":{ - "type":"structure", - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

Sets the start and end dates for retrieving AWS costs. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

" - }, - "Granularity":{ - "shape":"Granularity", - "documentation":"

Sets the AWS cost granularity to MONTHLY or DAILY. If Granularity isn't set, the response object doesn't include the Granularity, either MONTHLY or DAILY.

" - }, - "Filter":{ - "shape":"Expression", - "documentation":"

Filters AWS costs by different dimensions. For example, you can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated with that account's usage of that service. You can nest Expression objects to define any combination of dimension filters. For more information, see Expression.

" - }, - "Metrics":{ - "shape":"MetricNames", - "documentation":"

Which metrics are returned in the query. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.

Valid values are AmortizedCost, BlendedCost, UnblendedCost, and UsageQuantity.

If you return the UsageQuantity metric, the service aggregates all usage numbers without taking into account the units. For example, if you aggregate usageQuantity across all of EC2, the results aren't meaningful because EC2 compute hours and data transfer are measured in different units (for example, hours vs. GB). To get more meaningful UsageQuantity metrics, filter by UsageType or UsageTypeGroups.

Metrics is required for GetCostAndUsage requests.

" - }, - "GroupBy":{ - "shape":"GroupDefinitions", - "documentation":"

You can group AWS costs using up to two different groups, either dimensions, tag keys, or both.

When you group by tag key, you get all tag values, including empty strings.

Valid values are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, LINKED_ACCOUNT, OPERATION, PLATFORM, PURCHASE_TYPE, SERVICE, TAGS, TENANCY, and USAGE_TYPE.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetCostAndUsageResponse":{ - "type":"structure", - "members":{ - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - }, - "GroupDefinitions":{ - "shape":"GroupDefinitions", - "documentation":"

The groups that are specified by the Filter or GroupBy parameters in the request.

" - }, - "ResultsByTime":{ - "shape":"ResultsByTime", - "documentation":"

The time period that is covered by the results in the response.

" - } - } - }, - "GetDimensionValuesRequest":{ - "type":"structure", - "required":[ - "TimePeriod", - "Dimension" - ], - "members":{ - "SearchString":{ - "shape":"SearchString", - "documentation":"

The value that you want to search the filter values for.

" - }, - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The start and end dates for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

" - }, - "Dimension":{ - "shape":"Dimension", - "documentation":"

The name of the dimension. Each Dimension is available for different a Context. For more information, see Context.

" - }, - "Context":{ - "shape":"Context", - "documentation":"

The context for the call to GetDimensionValues. This can be RESERVATIONS or COST_AND_USAGE. The default value is COST_AND_USAGE. If the context is set to RESERVATIONS, the resulting dimension values can be used in the GetReservationUtilization operation. If the context is set to COST_AND_USAGE the resulting dimension values can be used in the GetCostAndUsage operation.

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LEGAL_ENTITY_NAME - The name of the organization that sells you AWS services, such as Amazon Web Services.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account.

  • OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.

  • OPERATION - The action performed. Examples include RunInstance and CreateBucket.

  • PLATFORM - The EC2 operating system. Examples are Windows or Linux.

  • PURCHASE_TYPE - The reservation type of the purchase to which this usage is related. Examples include On-Demand Instances and Standard Reserved Instances.

  • SERVICE - The AWS service such as Amazon DynamoDB.

  • USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.

  • USAGE_TYPE_GROUP - The grouping of common usage types. An example is EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.

  • RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax refunds, and credits.

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.

  • DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account.

  • PLATFORM - The EC2 operating system. Examples are Windows or Linux.

  • REGION - The AWS Region.

  • SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.

  • TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).

  • TENANCY - The tenancy of a resource. Examples are shared or dedicated.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetDimensionValuesResponse":{ - "type":"structure", - "required":[ - "DimensionValues", - "ReturnSize", - "TotalSize" - ], - "members":{ - "DimensionValues":{ - "shape":"DimensionValuesWithAttributesList", - "documentation":"

The filters that you used to filter your request. Some dimensions are available only for a specific context:

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LEGAL_ENTITY_NAME - The name of the organization that sells you AWS services, such as Amazon Web Services.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account.

  • OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.

  • OPERATION - The action performed. Examples include RunInstance and CreateBucket.

  • PLATFORM - The EC2 operating system. Examples are Windows or Linux.

  • PURCHASE_TYPE - The reservation type of the purchase to which this usage is related. Examples include On-Demand Instances and Standard Reserved Instances.

  • SERVICE - The AWS service such as Amazon DynamoDB.

  • USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.

  • USAGE_TYPE_GROUP - The grouping of common usage types. An example is EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.

  • RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax refunds, and credits.

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.

  • DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account.

  • PLATFORM - The EC2 operating system. Examples are Windows or Linux.

  • REGION - The AWS Region.

  • SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.

  • TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).

  • TENANCY - The tenancy of a resource. Examples are shared or dedicated.

" - }, - "ReturnSize":{ - "shape":"PageSize", - "documentation":"

The number of results that AWS returned at one time.

" - }, - "TotalSize":{ - "shape":"PageSize", - "documentation":"

The total number of search results.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetReservationCoverageRequest":{ - "type":"structure", - "required":["TimePeriod"], - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The start and end dates of the period for which you want to retrieve data about reservation coverage. You can retrieve data for a maximum of 13 months: the last 12 months and the current month. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

" - }, - "GroupBy":{ - "shape":"GroupDefinitions", - "documentation":"

You can group the data by the following attributes:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • TAG

  • TENANCY

" - }, - "Granularity":{ - "shape":"Granularity", - "documentation":"

The granularity of the AWS cost data for the reservation. Valid values are MONTHLY and DAILY.

If GroupBy is set, Granularity can't be set. If Granularity isn't set, the response object doesn't include Granularity, either MONTHLY or DAILY.

" - }, - "Filter":{ - "shape":"Expression", - "documentation":"

Filters utilization data by dimensions. You can filter by the following dimensions:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • SERVICE

  • TAG

  • TENANCY

GetReservationCoverage uses the same Expression object as the other operations, but only AND is supported among each dimension. You can nest only one level deep. If there are multiple values for a dimension, they are OR'd together.

If you don't provide a SERVICE filter, Cost Explorer defaults to EC2.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - }, - "documentation":"

You can use the following request parameters to query for how much of your instance usage is covered by a reservation.

" - }, - "GetReservationCoverageResponse":{ - "type":"structure", - "required":["CoveragesByTime"], - "members":{ - "CoveragesByTime":{ - "shape":"CoveragesByTime", - "documentation":"

The amount of time that your reservations covered.

" - }, - "Total":{ - "shape":"Coverage", - "documentation":"

The total amount of instance usage that is covered by a reservation.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetReservationPurchaseRecommendationRequest":{ - "type":"structure", - "required":["Service"], - "members":{ - "AccountId":{ - "shape":"GenericString", - "documentation":"

The account ID that is associated with the recommendation.

" - }, - "Service":{ - "shape":"GenericString", - "documentation":"

The specific service that you want recommendations for.

" - }, - "AccountScope":{ - "shape":"AccountScope", - "documentation":"

The account scope that you want recommendations for. PAYER means that AWS includes the master account and any member accounts when it calculates its recommendations. LINKED means that AWS includes only member accounts when it calculates its recommendations.

Valid values are PAYER and LINKED.

" - }, - "LookbackPeriodInDays":{ - "shape":"LookbackPeriodInDays", - "documentation":"

The number of previous days that you want AWS to consider when it calculates your recommendations.

" - }, - "TermInYears":{ - "shape":"TermInYears", - "documentation":"

The reservation term that you want recommendations for.

" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The reservation purchase option that you want recommendations for.

" - }, - "ServiceSpecification":{ - "shape":"ServiceSpecification", - "documentation":"

The hardware specifications for the service instances that you want recommendations for, such as standard or convertible EC2 instances.

" - }, - "PageSize":{ - "shape":"NonNegativeInteger", - "documentation":"

The number of recommendations that you want returned in a single response object.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The pagination token that indicates the next set of results that you want to retrieve.

" - } - } - }, - "GetReservationPurchaseRecommendationResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"ReservationPurchaseRecommendationMetadata", - "documentation":"

Information about this specific recommendation call, such as the time stamp for when Cost Explorer generated this recommendation.

" - }, - "Recommendations":{ - "shape":"ReservationPurchaseRecommendations", - "documentation":"

Recommendations for reservations to purchase.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The pagination token for the next set of retrievable results.

" - } - } - }, - "GetReservationUtilizationRequest":{ - "type":"structure", - "required":["TimePeriod"], - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

Sets the start and end dates for retrieving Reserved Instance (RI) utilization. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

" - }, - "GroupBy":{ - "shape":"GroupDefinitions", - "documentation":"

Groups only by SUBSCRIPTION_ID. Metadata is included.

" - }, - "Granularity":{ - "shape":"Granularity", - "documentation":"

If GroupBy is set, Granularity can't be set. If Granularity isn't set, the response object doesn't include Granularity, either MONTHLY or DAILY. If both GroupBy and Granularity aren't set, GetReservationUtilization defaults to DAILY.

" - }, - "Filter":{ - "shape":"Expression", - "documentation":"

Filters utilization data by dimensions. You can filter by the following dimensions:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • SERVICE

  • SCOPE

  • TENANCY

GetReservationUtilization uses the same Expression object as the other operations, but only AND is supported among each dimension, and nesting is supported up to only one level deep. If there are multiple values for a dimension, they are OR'd together.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetReservationUtilizationResponse":{ - "type":"structure", - "required":["UtilizationsByTime"], - "members":{ - "UtilizationsByTime":{ - "shape":"UtilizationsByTime", - "documentation":"

The amount of time that you utilized your RIs.

" - }, - "Total":{ - "shape":"ReservationAggregates", - "documentation":"

The total amount of time that you utilized your RIs.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetTagsRequest":{ - "type":"structure", - "required":["TimePeriod"], - "members":{ - "SearchString":{ - "shape":"SearchString", - "documentation":"

The value that you want to search for.

" - }, - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The start and end dates for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

" - }, - "TagKey":{ - "shape":"TagKey", - "documentation":"

The key of the tag that you want to return values for.

" - }, - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - } - } - }, - "GetTagsResponse":{ - "type":"structure", - "required":[ - "Tags", - "ReturnSize", - "TotalSize" - ], - "members":{ - "NextPageToken":{ - "shape":"NextPageToken", - "documentation":"

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags that match your request.

" - }, - "ReturnSize":{ - "shape":"PageSize", - "documentation":"

The number of query results that AWS returns at a time.

" - }, - "TotalSize":{ - "shape":"PageSize", - "documentation":"

The total number of query results.

" - } - } - }, - "Granularity":{ - "type":"string", - "enum":[ - "DAILY", - "MONTHLY" - ] - }, - "Group":{ - "type":"structure", - "members":{ - "Keys":{ - "shape":"Keys", - "documentation":"

The keys that are included in this group.

" - }, - "Metrics":{ - "shape":"Metrics", - "documentation":"

The metrics that are included in this group.

" - } - }, - "documentation":"

One level of grouped data within the results.

" - }, - "GroupDefinition":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"GroupDefinitionType", - "documentation":"

The string that represents the type of group.

" - }, - "Key":{ - "shape":"GroupDefinitionKey", - "documentation":"

The string that represents a key for a specified group.

" - } - }, - "documentation":"

Represents a group when you specify a group by criteria, or in the response to a query with a specific grouping.

" - }, - "GroupDefinitionKey":{"type":"string"}, - "GroupDefinitionType":{ - "type":"string", - "enum":[ - "DIMENSION", - "TAG" - ] - }, - "GroupDefinitions":{ - "type":"list", - "member":{"shape":"GroupDefinition"} - }, - "Groups":{ - "type":"list", - "member":{"shape":"Group"} - }, - "InstanceDetails":{ - "type":"structure", - "members":{ - "EC2InstanceDetails":{ - "shape":"EC2InstanceDetails", - "documentation":"

The EC2 instances that AWS recommends that you purchase.

" - }, - "RDSInstanceDetails":{ - "shape":"RDSInstanceDetails", - "documentation":"

The RDS instances that AWS recommends that you purchase.

" - }, - "RedshiftInstanceDetails":{ - "shape":"RedshiftInstanceDetails", - "documentation":"

The Amazon Redshift instances that AWS recommends that you purchase.

" - }, - "ElastiCacheInstanceDetails":{ - "shape":"ElastiCacheInstanceDetails", - "documentation":"

The ElastiCache instances that AWS recommends that you purchase.

" - }, - "ESInstanceDetails":{ - "shape":"ESInstanceDetails", - "documentation":"

The Amazon ES instances that AWS recommends that you purchase.

" - } - }, - "documentation":"

Details about the instances that AWS recommends that you purchase.

" - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The pagination token is invalid. Try again without a pagination token.

", - "exception":true - }, - "Key":{"type":"string"}, - "Keys":{ - "type":"list", - "member":{"shape":"Key"} - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You made too many calls in a short period of time. Try again later.

", - "exception":true - }, - "LookbackPeriodInDays":{ - "type":"string", - "enum":[ - "SEVEN_DAYS", - "THIRTY_DAYS", - "SIXTY_DAYS" - ] - }, - "MetricAmount":{"type":"string"}, - "MetricName":{"type":"string"}, - "MetricNames":{ - "type":"list", - "member":{"shape":"MetricName"} - }, - "MetricUnit":{"type":"string"}, - "MetricValue":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"MetricAmount", - "documentation":"

The actual number that represents the metric.

" - }, - "Unit":{ - "shape":"MetricUnit", - "documentation":"

The unit that the metric is given in.

" - } - }, - "documentation":"

The aggregated value for a metric.

" - }, - "Metrics":{ - "type":"map", - "key":{"shape":"MetricName"}, - "value":{"shape":"MetricValue"} - }, - "NetRISavings":{"type":"string"}, - "NextPageToken":{"type":"string"}, - "NonNegativeInteger":{ - "type":"integer", - "min":0 - }, - "OfferingClass":{ - "type":"string", - "enum":[ - "STANDARD", - "CONVERTIBLE" - ] - }, - "OnDemandCostOfRIHoursUsed":{"type":"string"}, - "OnDemandHours":{"type":"string"}, - "PageSize":{"type":"integer"}, - "PaymentOption":{ - "type":"string", - "enum":[ - "NO_UPFRONT", - "PARTIAL_UPFRONT", - "ALL_UPFRONT", - "LIGHT_UTILIZATION", - "MEDIUM_UTILIZATION", - "HEAVY_UTILIZATION" - ] - }, - "PurchasedHours":{"type":"string"}, - "RDSInstanceDetails":{ - "type":"structure", - "members":{ - "Family":{ - "shape":"GenericString", - "documentation":"

The instance family of the recommended reservation.

" - }, - "InstanceType":{ - "shape":"GenericString", - "documentation":"

The type of instance that AWS recommends.

" - }, - "Region":{ - "shape":"GenericString", - "documentation":"

The AWS Region of the recommended reservation.

" - }, - "DatabaseEngine":{ - "shape":"GenericString", - "documentation":"

The database engine that the recommended reservation supports.

" - }, - "DatabaseEdition":{ - "shape":"GenericString", - "documentation":"

The database edition that the recommended reservation supports.

" - }, - "DeploymentOption":{ - "shape":"GenericString", - "documentation":"

Whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.

" - }, - "LicenseModel":{ - "shape":"GenericString", - "documentation":"

The license model that the recommended reservation supports.

" - }, - "CurrentGeneration":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommendation is for a current generation instance.

" - }, - "SizeFlexEligible":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommended reservation is size flexible.

" - } - }, - "documentation":"

Details about the RDS instances that AWS recommends that you purchase.

" - }, - "RedshiftInstanceDetails":{ - "type":"structure", - "members":{ - "Family":{ - "shape":"GenericString", - "documentation":"

The instance family of the recommended reservation.

" - }, - "NodeType":{ - "shape":"GenericString", - "documentation":"

The type of node that AWS recommends.

" - }, - "Region":{ - "shape":"GenericString", - "documentation":"

The AWS Region of the recommended reservation.

" - }, - "CurrentGeneration":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommendation is for a current generation instance.

" - }, - "SizeFlexEligible":{ - "shape":"GenericBoolean", - "documentation":"

Whether the recommended reservation is size flexible.

" - } - }, - "documentation":"

Details about the Amazon Redshift instances that AWS recommends that you purchase.

" - }, - "RequestChangedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Your request parameters changed between pages. Try again with the old parameters or without a pagination token.

", - "exception":true - }, - "ReservationAggregates":{ - "type":"structure", - "members":{ - "UtilizationPercentage":{ - "shape":"UtilizationPercentage", - "documentation":"

The percentage of RI time that you used.

" - }, - "PurchasedHours":{ - "shape":"PurchasedHours", - "documentation":"

How many RI hours that you purchased.

" - }, - "TotalActualHours":{ - "shape":"TotalActualHours", - "documentation":"

The total number of RI hours that you used.

" - }, - "UnusedHours":{ - "shape":"UnusedHours", - "documentation":"

The number of RI hours that you didn't use.

" - }, - "OnDemandCostOfRIHoursUsed":{ - "shape":"OnDemandCostOfRIHoursUsed", - "documentation":"

How much your RIs would cost if charged On-Demand rates.

" - }, - "NetRISavings":{ - "shape":"NetRISavings", - "documentation":"

How much you saved due to purchasing and utilizing RIs. AWS calculates this by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed.

" - }, - "TotalPotentialRISavings":{ - "shape":"TotalPotentialRISavings", - "documentation":"

How much you could save if you use your entire reservation.

" - }, - "AmortizedUpfrontFee":{ - "shape":"AmortizedUpfrontFee", - "documentation":"

The upfront cost of your RI, amortized over the RI period.

" - }, - "AmortizedRecurringFee":{ - "shape":"AmortizedRecurringFee", - "documentation":"

The monthly cost of your RI, amortized over the RI period.

" - }, - "TotalAmortizedFee":{ - "shape":"TotalAmortizedFee", - "documentation":"

The total cost of your RI, amortized over the RI period.

" - } - }, - "documentation":"

The aggregated numbers for your Reserved Instance (RI) usage.

" - }, - "ReservationCoverageGroup":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"Attributes", - "documentation":"

The attributes for this group of reservations.

" - }, - "Coverage":{ - "shape":"Coverage", - "documentation":"

How much instance usage this group of reservations covered.

" - } - }, - "documentation":"

A group of reservations that share a set of attributes.

" - }, - "ReservationCoverageGroups":{ - "type":"list", - "member":{"shape":"ReservationCoverageGroup"} - }, - "ReservationGroupKey":{"type":"string"}, - "ReservationGroupValue":{"type":"string"}, - "ReservationPurchaseRecommendation":{ - "type":"structure", - "members":{ - "AccountScope":{ - "shape":"AccountScope", - "documentation":"

The account scope that AWS recommends that you purchase this instance for. For example, you can purchase this reservation for an entire organization in AWS Organizations.

" - }, - "LookbackPeriodInDays":{ - "shape":"LookbackPeriodInDays", - "documentation":"

How many days of previous usage that AWS considers when making this recommendation.

" - }, - "TermInYears":{ - "shape":"TermInYears", - "documentation":"

The term of the reservation that you want recommendations for, in years.

" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option for the reservation. For example, AllUpfront or NoUpfront.

" - }, - "ServiceSpecification":{ - "shape":"ServiceSpecification", - "documentation":"

Hardware specifications for the service that you want recommendations for.

" - }, - "RecommendationDetails":{ - "shape":"ReservationPurchaseRecommendationDetails", - "documentation":"

Details about the recommended purchases.

" - }, - "RecommendationSummary":{ - "shape":"ReservationPurchaseRecommendationSummary", - "documentation":"

A summary about the recommended purchase.

" - } - }, - "documentation":"

A specific reservation that AWS recommends for purchase.

" - }, - "ReservationPurchaseRecommendationDetail":{ - "type":"structure", - "members":{ - "InstanceDetails":{ - "shape":"InstanceDetails", - "documentation":"

Details about the instances that AWS recommends that you purchase.

" - }, - "RecommendedNumberOfInstancesToPurchase":{ - "shape":"GenericString", - "documentation":"

The number of instances that AWS recommends that you purchase.

" - }, - "RecommendedNormalizedUnitsToPurchase":{ - "shape":"GenericString", - "documentation":"

The number of normalized units that AWS recommends that you purchase.

" - }, - "MinimumNumberOfInstancesUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The minimum number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "MinimumNormalizedUnitsUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The minimum number of hours that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "MaximumNumberOfInstancesUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The maximum number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "MaximumNormalizedUnitsUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The maximum number of normalized units that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "AverageNumberOfInstancesUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The average number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "AverageNormalizedUnitsUsedPerHour":{ - "shape":"GenericString", - "documentation":"

The average number of normalized units that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

" - }, - "AverageUtilization":{ - "shape":"GenericString", - "documentation":"

The average utilization of your instances. AWS uses this to calculate your recommended reservation purchases.

" - }, - "EstimatedBreakEvenInMonths":{ - "shape":"GenericString", - "documentation":"

How long AWS estimates that it takes for this instance to start saving you money, in months.

" - }, - "CurrencyCode":{ - "shape":"GenericString", - "documentation":"

The currency code that AWS used to calculate the costs for this instance.

" - }, - "EstimatedMonthlySavingsAmount":{ - "shape":"GenericString", - "documentation":"

How much AWS estimates that this specific recommendation could save you in a month.

" - }, - "EstimatedMonthlySavingsPercentage":{ - "shape":"GenericString", - "documentation":"

How much AWS estimates that this specific recommendation could save you in a month, as a percentage of your overall costs.

" - }, - "EstimatedMonthlyOnDemandCost":{ - "shape":"GenericString", - "documentation":"

How much AWS estimates that you spend on On-Demand Instances in a month.

" - }, - "EstimatedReservationCostForLookbackPeriod":{ - "shape":"GenericString", - "documentation":"

How much AWS estimates that you would have spent for all usage during the specified historical period if you had had a reservation.

" - }, - "UpfrontCost":{ - "shape":"GenericString", - "documentation":"

How much purchasing this instance costs you upfront.

" - }, - "RecurringStandardMonthlyCost":{ - "shape":"GenericString", - "documentation":"

How much purchasing this instance costs you on a monthly basis.

" - } - }, - "documentation":"

Details about your recommended reservation purchase.

" - }, - "ReservationPurchaseRecommendationDetails":{ - "type":"list", - "member":{"shape":"ReservationPurchaseRecommendationDetail"} - }, - "ReservationPurchaseRecommendationMetadata":{ - "type":"structure", - "members":{ - "RecommendationId":{ - "shape":"GenericString", - "documentation":"

The ID for this specific recommendation.

" - }, - "GenerationTimestamp":{ - "shape":"GenericString", - "documentation":"

The time stamp for when AWS made this recommendation.

" - } - }, - "documentation":"

Information about this specific recommendation, such as the time stamp for when AWS made a specific recommendation.

" - }, - "ReservationPurchaseRecommendationSummary":{ - "type":"structure", - "members":{ - "TotalEstimatedMonthlySavingsAmount":{ - "shape":"GenericString", - "documentation":"

The total amount that AWS estimates that this recommendation could save you in a month.

" - }, - "TotalEstimatedMonthlySavingsPercentage":{ - "shape":"GenericString", - "documentation":"

The total amount that AWS estimates that this recommendation could save you in a month, as a percentage of your costs.

" - }, - "CurrencyCode":{ - "shape":"GenericString", - "documentation":"

The currency code used for this recommendation.

" - } - }, - "documentation":"

A summary about this recommendation, such as the currency code, the amount that AWS estimates that you could save, and the total amount of reservation to purchase.

" - }, - "ReservationPurchaseRecommendations":{ - "type":"list", - "member":{"shape":"ReservationPurchaseRecommendation"} - }, - "ReservationUtilizationGroup":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"ReservationGroupKey", - "documentation":"

The key for a specific RI attribute.

" - }, - "Value":{ - "shape":"ReservationGroupValue", - "documentation":"

The value of a specific RI attribute.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

The attributes for this group of RIs.

" - }, - "Utilization":{ - "shape":"ReservationAggregates", - "documentation":"

How much you used this group of RIs.

" - } - }, - "documentation":"

A group of Reserved Instances (RIs) that share a set of attributes.

" - }, - "ReservationUtilizationGroups":{ - "type":"list", - "member":{"shape":"ReservationUtilizationGroup"} - }, - "ReservedHours":{"type":"string"}, - "ResultByTime":{ - "type":"structure", - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The time period covered by a result.

" - }, - "Total":{ - "shape":"Metrics", - "documentation":"

The total amount of cost or usage accrued during the time period.

" - }, - "Groups":{ - "shape":"Groups", - "documentation":"

The groups that are included in this time period.

" - }, - "Estimated":{ - "shape":"Estimated", - "documentation":"

Whether this result is estimated.

" - } - }, - "documentation":"

The result that is associated with a time period.

" - }, - "ResultsByTime":{ - "type":"list", - "member":{"shape":"ResultByTime"} - }, - "SearchString":{"type":"string"}, - "ServiceSpecification":{ - "type":"structure", - "members":{ - "EC2Specification":{ - "shape":"EC2Specification", - "documentation":"

The EC2 hardware specifications that you want AWS to provide recommendations for.

" - } - }, - "documentation":"

Hardware specifications for the service that you want recommendations for.

" - }, - "TagKey":{"type":"string"}, - "TagList":{ - "type":"list", - "member":{"shape":"Entity"} - }, - "TagValues":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key for a tag.

" - }, - "Values":{ - "shape":"Values", - "documentation":"

The specific value of a tag.

" - } - }, - "documentation":"

The values that are available for a tag.

" - }, - "TermInYears":{ - "type":"string", - "enum":[ - "ONE_YEAR", - "THREE_YEARS" - ] - }, - "TotalActualHours":{"type":"string"}, - "TotalAmortizedFee":{"type":"string"}, - "TotalPotentialRISavings":{"type":"string"}, - "TotalRunningHours":{"type":"string"}, - "UnusedHours":{"type":"string"}, - "UtilizationByTime":{ - "type":"structure", - "members":{ - "TimePeriod":{ - "shape":"DateInterval", - "documentation":"

The period of time over which this utilization was used.

" - }, - "Groups":{ - "shape":"ReservationUtilizationGroups", - "documentation":"

The groups that are included in this utilization result.

" - }, - "Total":{ - "shape":"ReservationAggregates", - "documentation":"

The total number of RI hours that were used.

" - } - }, - "documentation":"

The amount of utilization, in hours.

" - }, - "UtilizationPercentage":{"type":"string"}, - "UtilizationsByTime":{ - "type":"list", - "member":{"shape":"UtilizationByTime"} - }, - "Value":{"type":"string"}, - "Values":{ - "type":"list", - "member":{"shape":"Value"} - }, - "YearMonthDay":{ - "type":"string", - "pattern":"\\d{4}-\\d{2}-\\d{2}" - } - }, - "documentation":"

The Cost Explorer API allows you to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data, such as the number of daily write operations for Amazon DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

  • https://ce.us-east-1.amazonaws.com

For information about costs associated with the Cost Explorer API, see AWS Cost Management Pricing.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/paginators-1.json deleted file mode 100644 index 1c4c2ff5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "DescribeEnvironmentMemberships": { - "result_key": "memberships", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListEnvironments": { - "result_key": "environmentIds", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/service-2.json deleted file mode 100644 index 46ef6d69..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloud9/2017-09-23/service-2.json +++ /dev/null @@ -1,696 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-23", - "endpointPrefix":"cloud9", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Cloud9", - "serviceId":"Cloud9", - "signatureVersion":"v4", - "targetPrefix":"AWSCloud9WorkspaceManagementService", - "uid":"cloud9-2017-09-23" - }, - "operations":{ - "CreateEnvironmentEC2":{ - "name":"CreateEnvironmentEC2", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEnvironmentEC2Request"}, - "output":{"shape":"CreateEnvironmentEC2Result"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment.

", - "idempotent":true - }, - "CreateEnvironmentMembership":{ - "name":"CreateEnvironmentMembership", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEnvironmentMembershipRequest"}, - "output":{"shape":"CreateEnvironmentMembershipResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Adds an environment member to an AWS Cloud9 development environment.

", - "idempotent":true - }, - "DeleteEnvironment":{ - "name":"DeleteEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEnvironmentRequest"}, - "output":{"shape":"DeleteEnvironmentResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Deletes an AWS Cloud9 development environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.

", - "idempotent":true - }, - "DeleteEnvironmentMembership":{ - "name":"DeleteEnvironmentMembership", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEnvironmentMembershipRequest"}, - "output":{"shape":"DeleteEnvironmentMembershipResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Deletes an environment member from an AWS Cloud9 development environment.

", - "idempotent":true - }, - "DescribeEnvironmentMemberships":{ - "name":"DescribeEnvironmentMemberships", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentMembershipsRequest"}, - "output":{"shape":"DescribeEnvironmentMembershipsResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Gets information about environment members for an AWS Cloud9 development environment.

" - }, - "DescribeEnvironmentStatus":{ - "name":"DescribeEnvironmentStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentStatusRequest"}, - "output":{"shape":"DescribeEnvironmentStatusResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Gets status information for an AWS Cloud9 development environment.

" - }, - "DescribeEnvironments":{ - "name":"DescribeEnvironments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentsRequest"}, - "output":{"shape":"DescribeEnvironmentsResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Gets information about AWS Cloud9 development environments.

" - }, - "ListEnvironments":{ - "name":"ListEnvironments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEnvironmentsRequest"}, - "output":{"shape":"ListEnvironmentsResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Gets a list of AWS Cloud9 development environment identifiers.

" - }, - "UpdateEnvironment":{ - "name":"UpdateEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEnvironmentRequest"}, - "output":{"shape":"UpdateEnvironmentResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Changes the settings of an existing AWS Cloud9 development environment.

", - "idempotent":true - }, - "UpdateEnvironmentMembership":{ - "name":"UpdateEnvironmentMembership", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEnvironmentMembershipRequest"}, - "output":{"shape":"UpdateEnvironmentMembershipResult"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ConflictException"}, - {"shape":"NotFoundException"}, - {"shape":"ForbiddenException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Changes the settings of an existing environment member for an AWS Cloud9 development environment.

", - "idempotent":true - } - }, - "shapes":{ - "AutomaticStopTimeMinutes":{ - "type":"integer", - "box":true, - "max":20160 - }, - "BadRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The target request is invalid.

", - "exception":true - }, - "BoundedEnvironmentIdList":{ - "type":"list", - "member":{"shape":"EnvironmentId"}, - "max":25, - "min":1 - }, - "ClientRequestToken":{ - "type":"string", - "pattern":"[\\x20-\\x7E]{10,128}" - }, - "ConflictException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A conflict occurred.

", - "exception":true - }, - "CreateEnvironmentEC2Request":{ - "type":"structure", - "required":[ - "name", - "instanceType" - ], - "members":{ - "name":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to create.

This name is visible to other AWS IAM users in the same AWS account.

" - }, - "description":{ - "shape":"EnvironmentDescription", - "documentation":"

The description of the environment to create.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, case-sensitive string that helps AWS Cloud9 to ensure this operation completes no more than one time.

For more information, see Client Tokens in the Amazon EC2 API Reference.

" - }, - "instanceType":{ - "shape":"InstanceType", - "documentation":"

The type of instance to connect to the environment (for example, t2.micro).

" - }, - "subnetId":{ - "shape":"SubnetId", - "documentation":"

The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.

" - }, - "automaticStopTimeMinutes":{ - "shape":"AutomaticStopTimeMinutes", - "documentation":"

The number of minutes until the running instance is shut down after the environment has last been used.

" - }, - "ownerArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the environment owner. This ARN can be the ARN of any AWS IAM principal. If this value is not specified, the ARN defaults to this environment's creator.

" - } - } - }, - "CreateEnvironmentEC2Result":{ - "type":"structure", - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment that was created.

" - } - } - }, - "CreateEnvironmentMembershipRequest":{ - "type":"structure", - "required":[ - "environmentId", - "userArn", - "permissions" - ], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment that contains the environment member you want to add.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the environment member you want to add.

" - }, - "permissions":{ - "shape":"MemberPermissions", - "documentation":"

The type of environment member permissions you want to associate with this environment member. Available values include:

  • read-only: Has read-only access to the environment.

  • read-write: Has read-write access to the environment.

" - } - } - }, - "CreateEnvironmentMembershipResult":{ - "type":"structure", - "members":{ - "membership":{ - "shape":"EnvironmentMember", - "documentation":"

Information about the environment member that was added.

" - } - } - }, - "DeleteEnvironmentMembershipRequest":{ - "type":"structure", - "required":[ - "environmentId", - "userArn" - ], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to delete the environment member from.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the environment member to delete from the environment.

" - } - } - }, - "DeleteEnvironmentMembershipResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteEnvironmentRequest":{ - "type":"structure", - "required":["environmentId"], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to delete.

" - } - } - }, - "DeleteEnvironmentResult":{ - "type":"structure", - "members":{ - } - }, - "DescribeEnvironmentMembershipsRequest":{ - "type":"structure", - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of an individual environment member to get information about. If no value is specified, information about all environment members are returned.

" - }, - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to get environment member information about.

" - }, - "permissions":{ - "shape":"PermissionsList", - "documentation":"

The type of environment member permissions to get information about. Available values include:

  • owner: Owns the environment.

  • read-only: Has read-only access to the environment.

  • read-write: Has read-write access to the environment.

If no value is specified, information about all environment members are returned.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

During a previous call, if there are more than 25 items in the list, only the first 25 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of environment members to get information about.

" - } - } - }, - "DescribeEnvironmentMembershipsResult":{ - "type":"structure", - "members":{ - "memberships":{ - "shape":"EnvironmentMembersList", - "documentation":"

Information about the environment members for the environment.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

If there are more than 25 items in the list, only the first 25 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call.

" - } - } - }, - "DescribeEnvironmentStatusRequest":{ - "type":"structure", - "required":["environmentId"], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to get status information about.

" - } - } - }, - "DescribeEnvironmentStatusResult":{ - "type":"structure", - "members":{ - "status":{ - "shape":"EnvironmentStatus", - "documentation":"

The status of the environment. Available values include:

  • connecting: The environment is connecting.

  • creating: The environment is being created.

  • deleting: The environment is being deleted.

  • error: The environment is in an error state.

  • ready: The environment is ready.

  • stopped: The environment is stopped.

  • stopping: The environment is stopping.

" - }, - "message":{ - "shape":"String", - "documentation":"

Any informational message about the status of the environment.

" - } - } - }, - "DescribeEnvironmentsRequest":{ - "type":"structure", - "required":["environmentIds"], - "members":{ - "environmentIds":{ - "shape":"BoundedEnvironmentIdList", - "documentation":"

The IDs of individual environments to get information about.

" - } - } - }, - "DescribeEnvironmentsResult":{ - "type":"structure", - "members":{ - "environments":{ - "shape":"EnvironmentList", - "documentation":"

Information about the environments that are returned.

" - } - } - }, - "Environment":{ - "type":"structure", - "members":{ - "id":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment.

" - }, - "name":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment.

" - }, - "description":{ - "shape":"EnvironmentDescription", - "documentation":"

The description for the environment.

" - }, - "type":{ - "shape":"EnvironmentType", - "documentation":"

The type of environment. Valid values include the following:

  • ec2: An Amazon Elastic Compute Cloud (Amazon EC2) instance connects to the environment.

  • ssh: Your own server connects to the environment.

" - }, - "arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the environment.

" - }, - "ownerArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the environment owner.

" - } - }, - "documentation":"

Information about an AWS Cloud9 development environment.

" - }, - "EnvironmentDescription":{ - "type":"string", - "max":200 - }, - "EnvironmentId":{ - "type":"string", - "pattern":"^[a-zA-Z0-9]{8,32}$" - }, - "EnvironmentIdList":{ - "type":"list", - "member":{"shape":"EnvironmentId"} - }, - "EnvironmentList":{ - "type":"list", - "member":{"shape":"Environment"} - }, - "EnvironmentMember":{ - "type":"structure", - "members":{ - "permissions":{ - "shape":"Permissions", - "documentation":"

The type of environment member permissions associated with this environment member. Available values include:

  • owner: Owns the environment.

  • read-only: Has read-only access to the environment.

  • read-write: Has read-write access to the environment.

" - }, - "userId":{ - "shape":"String", - "documentation":"

The user ID in AWS Identity and Access Management (AWS IAM) of the environment member.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the environment member.

" - }, - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment for the environment member.

" - }, - "lastAccess":{ - "shape":"Timestamp", - "documentation":"

The time, expressed in epoch time format, when the environment member last opened the environment.

" - } - }, - "documentation":"

Information about an environment member for an AWS Cloud9 development environment.

" - }, - "EnvironmentMembersList":{ - "type":"list", - "member":{"shape":"EnvironmentMember"} - }, - "EnvironmentName":{ - "type":"string", - "max":60, - "min":1 - }, - "EnvironmentStatus":{ - "type":"string", - "enum":[ - "error", - "creating", - "connecting", - "ready", - "stopping", - "stopped", - "deleting" - ] - }, - "EnvironmentType":{ - "type":"string", - "enum":[ - "ssh", - "ec2" - ] - }, - "ForbiddenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An access permissions issue occurred.

", - "exception":true - }, - "InstanceType":{ - "type":"string", - "max":20, - "min":5, - "pattern":"^[a-z][1-9][.][a-z0-9]+$" - }, - "InternalServerErrorException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An internal server error occurred.

", - "exception":true, - "fault":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A service limit was exceeded.

", - "exception":true - }, - "ListEnvironmentsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"String", - "documentation":"

During a previous call, if there are more than 25 items in the list, only the first 25 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of environments to get identifiers for.

" - } - } - }, - "ListEnvironmentsResult":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"String", - "documentation":"

If there are more than 25 items in the list, only the first 25 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call.

" - }, - "environmentIds":{ - "shape":"EnvironmentIdList", - "documentation":"

The list of environment identifiers.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":25, - "min":0 - }, - "MemberPermissions":{ - "type":"string", - "enum":[ - "read-write", - "read-only" - ] - }, - "NotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The target resource cannot be found.

", - "exception":true - }, - "Permissions":{ - "type":"string", - "enum":[ - "owner", - "read-write", - "read-only" - ] - }, - "PermissionsList":{ - "type":"list", - "member":{"shape":"Permissions"} - }, - "String":{"type":"string"}, - "SubnetId":{ - "type":"string", - "max":30, - "min":5 - }, - "Timestamp":{"type":"timestamp"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Too many service requests were made over the given time period.

", - "exception":true - }, - "UpdateEnvironmentMembershipRequest":{ - "type":"structure", - "required":[ - "environmentId", - "userArn", - "permissions" - ], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment for the environment member whose settings you want to change.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the environment member whose settings you want to change.

" - }, - "permissions":{ - "shape":"MemberPermissions", - "documentation":"

The replacement type of environment member permissions you want to associate with this environment member. Available values include:

  • read-only: Has read-only access to the environment.

  • read-write: Has read-write access to the environment.

" - } - } - }, - "UpdateEnvironmentMembershipResult":{ - "type":"structure", - "members":{ - "membership":{ - "shape":"EnvironmentMember", - "documentation":"

Information about the environment member whose settings were changed.

" - } - } - }, - "UpdateEnvironmentRequest":{ - "type":"structure", - "required":["environmentId"], - "members":{ - "environmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to change settings.

" - }, - "name":{ - "shape":"EnvironmentName", - "documentation":"

A replacement name for the environment.

" - }, - "description":{ - "shape":"EnvironmentDescription", - "documentation":"

Any new or replacement description for the environment.

" - } - } - }, - "UpdateEnvironmentResult":{ - "type":"structure", - "members":{ - } - }, - "UserArn":{ - "type":"string", - "pattern":"arn:aws:(iam|sts)::\\d+:\\S+" - } - }, - "documentation":"AWS Cloud9

AWS Cloud9 is a collection of tools that you can use to code, build, run, test, debug, and release software in the cloud.

For more information about AWS Cloud9, see the AWS Cloud9 User Guide.

AWS Cloud9 supports these operations:

  • CreateEnvironmentEC2: Creates an AWS Cloud9 development environment, launches an Amazon EC2 instance, and then connects from the instance to the environment.

  • CreateEnvironmentMembership: Adds an environment member to an environment.

  • DeleteEnvironment: Deletes an environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.

  • DeleteEnvironmentMembership: Deletes an environment member from an environment.

  • DescribeEnvironmentMemberships: Gets information about environment members for an environment.

  • DescribeEnvironments: Gets information about environments.

  • DescribeEnvironmentStatus: Gets status information for an environment.

  • ListEnvironments: Gets a list of environment identifiers.

  • UpdateEnvironment: Changes the settings of an existing environment.

  • UpdateEnvironmentMembership: Changes the settings of an existing environment member for an environment.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/paginators-1.json deleted file mode 100644 index 22cc439e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/paginators-1.json +++ /dev/null @@ -1,100 +0,0 @@ -{ - "pagination": { - "ListObjectParentPaths": { - "result_key": "PathToObjectIdentifiersList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListFacetNames": { - "result_key": "FacetNames", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListPublishedSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListDirectories": { - "result_key": "Directories", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListDevelopmentSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTypedLinkFacetNames": { - "result_key": "FacetNames", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListIndex": { - "result_key": "IndexAttachments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListFacetAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListObjectPolicies": { - "result_key": "AttachedPolicyIds", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTagsForResource": { - "result_key": "Tags", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListAttachedIndices": { - "result_key": "IndexAttachments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "LookupPolicy": { - "result_key": "PolicyToPathList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListPolicyAttachments": { - "result_key": "ObjectIdentifiers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListObjectAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListAppliedSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTypedLinkFacetAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/service-2.json deleted file mode 100644 index ca413a04..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2016-05-10/service-2.json +++ /dev/null @@ -1,5924 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-05-10", - "endpointPrefix":"clouddirectory", - "protocol":"rest-json", - "serviceFullName":"Amazon CloudDirectory", - "serviceId":"CloudDirectory", - "signatureVersion":"v4", - "signingName":"clouddirectory", - "uid":"clouddirectory-2016-05-10" - }, - "operations":{ - "AddFacetToObject":{ - "name":"AddFacetToObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/facets", - "responseCode":200 - }, - "input":{"shape":"AddFacetToObjectRequest"}, - "output":{"shape":"AddFacetToObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Adds a new Facet to an object. An object can have more than one facet applied on it.

" - }, - "ApplySchema":{ - "name":"ApplySchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/apply", - "responseCode":200 - }, - "input":{"shape":"ApplySchemaRequest"}, - "output":{"shape":"ApplySchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"} - ], - "documentation":"

Copies the input published schema, at the specified version, into the Directory with the same name and version as that of the published schema.

" - }, - "AttachObject":{ - "name":"AttachObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attach", - "responseCode":200 - }, - "input":{"shape":"AttachObjectRequest"}, - "output":{"shape":"AttachObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ValidationException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Attaches an existing object to another object. An object can be accessed in two ways:

  1. Using the path

  2. Using ObjectIdentifier

" - }, - "AttachPolicy":{ - "name":"AttachPolicy", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/attach", - "responseCode":200 - }, - "input":{"shape":"AttachPolicyRequest"}, - "output":{"shape":"AttachPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "AttachToIndex":{ - "name":"AttachToIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index/attach", - "responseCode":200 - }, - "input":{"shape":"AttachToIndexRequest"}, - "output":{"shape":"AttachToIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"IndexedAttributeMissingException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Attaches the specified object to the specified index.

" - }, - "AttachTypedLink":{ - "name":"AttachTypedLink", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attach", - "responseCode":200 - }, - "input":{"shape":"AttachTypedLinkRequest"}, - "output":{"shape":"AttachTypedLinkResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ValidationException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "BatchRead":{ - "name":"BatchRead", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/batchread", - "responseCode":200 - }, - "input":{"shape":"BatchReadRequest"}, - "output":{"shape":"BatchReadResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"} - ], - "documentation":"

Performs all the read operations in a batch.

" - }, - "BatchWrite":{ - "name":"BatchWrite", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/batchwrite", - "responseCode":200 - }, - "input":{"shape":"BatchWriteRequest"}, - "output":{"shape":"BatchWriteResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"BatchWriteException"} - ], - "documentation":"

Performs all the write operations in a batch. Either all the operations succeed or none.

" - }, - "CreateDirectory":{ - "name":"CreateDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/create", - "responseCode":200 - }, - "input":{"shape":"CreateDirectoryRequest"}, - "output":{"shape":"CreateDirectoryResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a Directory by copying the published schema into the directory. A directory cannot be created without a schema.

" - }, - "CreateFacet":{ - "name":"CreateFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/create", - "responseCode":200 - }, - "input":{"shape":"CreateFacetRequest"}, - "output":{"shape":"CreateFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetAlreadyExistsException"}, - {"shape":"InvalidRuleException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Creates a new Facet in a schema. Facet creation is allowed only in development or applied schemas.

" - }, - "CreateIndex":{ - "name":"CreateIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index", - "responseCode":200 - }, - "input":{"shape":"CreateIndexRequest"}, - "output":{"shape":"CreateIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"UnsupportedIndexTypeException"} - ], - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "CreateObject":{ - "name":"CreateObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object", - "responseCode":200 - }, - "input":{"shape":"CreateObjectRequest"}, - "output":{"shape":"CreateObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"UnsupportedIndexTypeException"} - ], - "documentation":"

Creates an object in a Directory. Additionally attaches the object to a parent, if a parent reference and LinkName is specified. An object is simply a collection of Facet attributes. You can also use this API call to create a policy object, if the facet from which you create the object is a policy facet.

" - }, - "CreateSchema":{ - "name":"CreateSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/create", - "responseCode":200 - }, - "input":{"shape":"CreateSchemaRequest"}, - "output":{"shape":"CreateSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"SchemaAlreadyExistsException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Creates a new schema in a development state. A schema can exist in three phases:

  • Development: This is a mutable phase of the schema. All new schemas are in the development phase. Once the schema is finalized, it can be published.

  • Published: Published schemas are immutable and have a version associated with them.

  • Applied: Applied schemas are mutable in a way that allows you to add new schema facets. You can also add new, nonrequired attributes to existing schema facets. You can apply only published schemas to directories.

" - }, - "CreateTypedLinkFacet":{ - "name":"CreateTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/create", - "responseCode":200 - }, - "input":{"shape":"CreateTypedLinkFacetRequest"}, - "output":{"shape":"CreateTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetAlreadyExistsException"}, - {"shape":"InvalidRuleException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Creates a TypedLinkFacet. For more information, see Typed link.

" - }, - "DeleteDirectory":{ - "name":"DeleteDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory", - "responseCode":200 - }, - "input":{"shape":"DeleteDirectoryRequest"}, - "output":{"shape":"DeleteDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryNotDisabledException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Deletes a directory. Only disabled directories can be deleted. A deleted directory cannot be undone. Exercise extreme caution when deleting directories.

" - }, - "DeleteFacet":{ - "name":"DeleteFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteFacetRequest"}, - "output":{"shape":"DeleteFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"FacetInUseException"} - ], - "documentation":"

Deletes a given Facet. All attributes and Rules that are associated with the facet will be deleted. Only development schema facets are allowed deletion.

" - }, - "DeleteObject":{ - "name":"DeleteObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteObjectRequest"}, - "output":{"shape":"DeleteObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ObjectNotDetachedException"} - ], - "documentation":"

Deletes an object and its associated attributes. Only objects with no children and no parents can be deleted.

" - }, - "DeleteSchema":{ - "name":"DeleteSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema", - "responseCode":200 - }, - "input":{"shape":"DeleteSchemaRequest"}, - "output":{"shape":"DeleteSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"StillContainsLinksException"} - ], - "documentation":"

Deletes a given schema. Schemas in a development and published state can only be deleted.

" - }, - "DeleteTypedLinkFacet":{ - "name":"DeleteTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteTypedLinkFacetRequest"}, - "output":{"shape":"DeleteTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Deletes a TypedLinkFacet. For more information, see Typed link.

" - }, - "DetachFromIndex":{ - "name":"DetachFromIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index/detach", - "responseCode":200 - }, - "input":{"shape":"DetachFromIndexRequest"}, - "output":{"shape":"DetachFromIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ObjectAlreadyDetachedException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Detaches the specified object from the specified index.

" - }, - "DetachObject":{ - "name":"DetachObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/detach", - "responseCode":200 - }, - "input":{"shape":"DetachObjectRequest"}, - "output":{"shape":"DetachObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotNodeException"} - ], - "documentation":"

Detaches a given object from the parent object. The object that is to be detached from the parent is specified by the link name.

" - }, - "DetachPolicy":{ - "name":"DetachPolicy", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/detach", - "responseCode":200 - }, - "input":{"shape":"DetachPolicyRequest"}, - "output":{"shape":"DetachPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Detaches a policy from an object.

" - }, - "DetachTypedLink":{ - "name":"DetachTypedLink", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/detach", - "responseCode":200 - }, - "input":{"shape":"DetachTypedLinkRequest"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "DisableDirectory":{ - "name":"DisableDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/disable", - "responseCode":200 - }, - "input":{"shape":"DisableDirectoryRequest"}, - "output":{"shape":"DisableDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Disables the specified directory. Disabled directories cannot be read or written to. Only enabled directories can be disabled. Disabled directories may be reenabled.

" - }, - "EnableDirectory":{ - "name":"EnableDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/enable", - "responseCode":200 - }, - "input":{"shape":"EnableDirectoryRequest"}, - "output":{"shape":"EnableDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Enables the specified directory. Only disabled directories can be enabled. Once enabled, the directory can then be read and written to.

" - }, - "GetAppliedSchemaVersion":{ - "name":"GetAppliedSchemaVersion", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/getappliedschema", - "responseCode":200 - }, - "input":{"shape":"GetAppliedSchemaVersionRequest"}, - "output":{"shape":"GetAppliedSchemaVersionResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns current applied schema version ARN, including the minor version in use.

" - }, - "GetDirectory":{ - "name":"GetDirectory", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/get", - "responseCode":200 - }, - "input":{"shape":"GetDirectoryRequest"}, - "output":{"shape":"GetDirectoryResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Retrieves metadata about a directory.

" - }, - "GetFacet":{ - "name":"GetFacet", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet", - "responseCode":200 - }, - "input":{"shape":"GetFacetRequest"}, - "output":{"shape":"GetFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Gets details of the Facet, such as facet name, attributes, Rules, or ObjectType. You can call this on all kinds of schema facets -- published, development, or applied.

" - }, - "GetLinkAttributes":{ - "name":"GetLinkAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attributes/get", - "responseCode":200 - }, - "input":{"shape":"GetLinkAttributesRequest"}, - "output":{"shape":"GetLinkAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Retrieves attributes that are associated with a typed link.

" - }, - "GetObjectAttributes":{ - "name":"GetObjectAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attributes/get", - "responseCode":200 - }, - "input":{"shape":"GetObjectAttributesRequest"}, - "output":{"shape":"GetObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "GetObjectInformation":{ - "name":"GetObjectInformation", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/information", - "responseCode":200 - }, - "input":{"shape":"GetObjectInformationRequest"}, - "output":{"shape":"GetObjectInformationResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves metadata about an object.

" - }, - "GetSchemaAsJson":{ - "name":"GetSchemaAsJson", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/json", - "responseCode":200 - }, - "input":{"shape":"GetSchemaAsJsonRequest"}, - "output":{"shape":"GetSchemaAsJsonResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Retrieves a JSON representation of the schema. See JSON Schema Format for more information.

" - }, - "GetTypedLinkFacetInformation":{ - "name":"GetTypedLinkFacetInformation", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/get", - "responseCode":200 - }, - "input":{"shape":"GetTypedLinkFacetInformationRequest"}, - "output":{"shape":"GetTypedLinkFacetInformationResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Returns the identity attribute order for a specific TypedLinkFacet. For more information, see Typed link.

" - }, - "ListAppliedSchemaArns":{ - "name":"ListAppliedSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/applied", - "responseCode":200 - }, - "input":{"shape":"ListAppliedSchemaArnsRequest"}, - "output":{"shape":"ListAppliedSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists schema major versions applied to a directory. If SchemaArn is provided, lists the minor version.

" - }, - "ListAttachedIndices":{ - "name":"ListAttachedIndices", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/indices", - "responseCode":200 - }, - "input":{"shape":"ListAttachedIndicesRequest"}, - "output":{"shape":"ListAttachedIndicesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists indices attached to the specified object.

" - }, - "ListDevelopmentSchemaArns":{ - "name":"ListDevelopmentSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/development", - "responseCode":200 - }, - "input":{"shape":"ListDevelopmentSchemaArnsRequest"}, - "output":{"shape":"ListDevelopmentSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves each Amazon Resource Name (ARN) of schemas in the development state.

" - }, - "ListDirectories":{ - "name":"ListDirectories", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/list", - "responseCode":200 - }, - "input":{"shape":"ListDirectoriesRequest"}, - "output":{"shape":"ListDirectoriesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists directories created within an account.

" - }, - "ListFacetAttributes":{ - "name":"ListFacetAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/attributes", - "responseCode":200 - }, - "input":{"shape":"ListFacetAttributesRequest"}, - "output":{"shape":"ListFacetAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves attributes attached to the facet.

" - }, - "ListFacetNames":{ - "name":"ListFacetNames", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/list", - "responseCode":200 - }, - "input":{"shape":"ListFacetNamesRequest"}, - "output":{"shape":"ListFacetNamesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves the names of facets that exist in a schema.

" - }, - "ListIncomingTypedLinks":{ - "name":"ListIncomingTypedLinks", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/incoming", - "responseCode":200 - }, - "input":{"shape":"ListIncomingTypedLinksRequest"}, - "output":{"shape":"ListIncomingTypedLinksResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIndex":{ - "name":"ListIndex", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/index/targets", - "responseCode":200 - }, - "input":{"shape":"ListIndexRequest"}, - "output":{"shape":"ListIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"FacetValidationException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListObjectAttributes":{ - "name":"ListObjectAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attributes", - "responseCode":200 - }, - "input":{"shape":"ListObjectAttributesRequest"}, - "output":{"shape":"ListObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "name":"ListObjectChildren", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/children", - "responseCode":200 - }, - "input":{"shape":"ListObjectChildrenRequest"}, - "output":{"shape":"ListObjectChildrenResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NotNodeException"} - ], - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "ListObjectParentPaths":{ - "name":"ListObjectParentPaths", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/parentpaths", - "responseCode":200 - }, - "input":{"shape":"ListObjectParentPathsRequest"}, - "output":{"shape":"ListObjectParentPathsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

Use this API to evaluate all parents for an object. The call returns all objects from the root of the directory up to the requested object. The API returns the number of paths based on user-defined MaxResults, in case there are multiple paths to the parent. The order of the paths and nodes returned is consistent among multiple API calls unless the objects are deleted or moved. Paths not leading to the directory root are ignored from the target object.

" - }, - "ListObjectParents":{ - "name":"ListObjectParents", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/parent", - "responseCode":200 - }, - "input":{"shape":"ListObjectParentsRequest"}, - "output":{"shape":"ListObjectParentsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"CannotListParentOfRootException"} - ], - "documentation":"

Lists parent objects that are associated with a given object in pagination fashion.

" - }, - "ListObjectPolicies":{ - "name":"ListObjectPolicies", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/policy", - "responseCode":200 - }, - "input":{"shape":"ListObjectPoliciesRequest"}, - "output":{"shape":"ListObjectPoliciesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListOutgoingTypedLinks":{ - "name":"ListOutgoingTypedLinks", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/outgoing", - "responseCode":200 - }, - "input":{"shape":"ListOutgoingTypedLinksRequest"}, - "output":{"shape":"ListOutgoingTypedLinksResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListPolicyAttachments":{ - "name":"ListPolicyAttachments", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/attachment", - "responseCode":200 - }, - "input":{"shape":"ListPolicyAttachmentsRequest"}, - "output":{"shape":"ListPolicyAttachmentsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "ListPublishedSchemaArns":{ - "name":"ListPublishedSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/published", - "responseCode":200 - }, - "input":{"shape":"ListPublishedSchemaArnsRequest"}, - "output":{"shape":"ListPublishedSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the major version families of each published schema. If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/tags", - "responseCode":200 - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

Returns tags for a resource. Tagging is currently supported only for directories with a limit of 50 tags per directory. All 50 tags are returned for a given directory with this API call.

" - }, - "ListTypedLinkFacetAttributes":{ - "name":"ListTypedLinkFacetAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/attributes", - "responseCode":200 - }, - "input":{"shape":"ListTypedLinkFacetAttributesRequest"}, - "output":{"shape":"ListTypedLinkFacetAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns a paginated list of all attribute definitions for a particular TypedLinkFacet. For more information, see Typed link.

" - }, - "ListTypedLinkFacetNames":{ - "name":"ListTypedLinkFacetNames", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/list", - "responseCode":200 - }, - "input":{"shape":"ListTypedLinkFacetNamesRequest"}, - "output":{"shape":"ListTypedLinkFacetNamesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns a paginated list of TypedLink facet names for a particular schema. For more information, see Typed link.

" - }, - "LookupPolicy":{ - "name":"LookupPolicy", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/lookup", - "responseCode":200 - }, - "input":{"shape":"LookupPolicyRequest"}, - "output":{"shape":"LookupPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "PublishSchema":{ - "name":"PublishSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/publish", - "responseCode":200 - }, - "input":{"shape":"PublishSchemaRequest"}, - "output":{"shape":"PublishSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"SchemaAlreadyPublishedException"} - ], - "documentation":"

Publishes a development schema with a major version and a recommended minor version.

" - }, - "PutSchemaFromJson":{ - "name":"PutSchemaFromJson", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/json", - "responseCode":200 - }, - "input":{"shape":"PutSchemaFromJsonRequest"}, - "output":{"shape":"PutSchemaFromJsonResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidSchemaDocException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Allows a schema to be updated using JSON upload. Only available for development schemas. See JSON Schema Format for more information.

" - }, - "RemoveFacetFromObject":{ - "name":"RemoveFacetFromObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/facets/delete", - "responseCode":200 - }, - "input":{"shape":"RemoveFacetFromObjectRequest"}, - "output":{"shape":"RemoveFacetFromObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Removes the specified facet from the specified object.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/tags/add", - "responseCode":200 - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

An API operation for adding tags to a resource.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/tags/remove", - "responseCode":200 - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

An API operation for removing tags from a resource.

" - }, - "UpdateFacet":{ - "name":"UpdateFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet", - "responseCode":200 - }, - "input":{"shape":"UpdateFacetRequest"}, - "output":{"shape":"UpdateFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidFacetUpdateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Does the following:

  1. Adds new Attributes, Rules, or ObjectTypes.

  2. Updates existing Attributes, Rules, or ObjectTypes.

  3. Deletes existing Attributes, Rules, or ObjectTypes.

" - }, - "UpdateLinkAttributes":{ - "name":"UpdateLinkAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attributes/update", - "responseCode":200 - }, - "input":{"shape":"UpdateLinkAttributesRequest"}, - "output":{"shape":"UpdateLinkAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Updates a given typed link’s attributes. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder.

" - }, - "UpdateObjectAttributes":{ - "name":"UpdateObjectAttributes", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/update", - "responseCode":200 - }, - "input":{"shape":"UpdateObjectAttributesRequest"}, - "output":{"shape":"UpdateObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Updates a given object's attributes.

" - }, - "UpdateSchema":{ - "name":"UpdateSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/update", - "responseCode":200 - }, - "input":{"shape":"UpdateSchemaRequest"}, - "output":{"shape":"UpdateSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the schema name with a new name. Only development schema names can be updated.

" - }, - "UpdateTypedLinkFacet":{ - "name":"UpdateTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet", - "responseCode":200 - }, - "input":{"shape":"UpdateTypedLinkFacetRequest"}, - "output":{"shape":"UpdateTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"FacetValidationException"}, - {"shape":"InvalidFacetUpdateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Updates a TypedLinkFacet. For more information, see Typed link.

" - }, - "UpgradeAppliedSchema":{ - "name":"UpgradeAppliedSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/upgradeapplied", - "responseCode":200 - }, - "input":{"shape":"UpgradeAppliedSchemaRequest"}, - "output":{"shape":"UpgradeAppliedSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"IncompatibleSchemaException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"} - ], - "documentation":"

Upgrades a single directory in-place using the PublishedSchemaArn with schema updates found in MinorVersion. Backwards-compatible minor version upgrades are instantaneously available for readers on all objects in the directory. Note: This is a synchronous API call and upgrades only one schema on a given directory per call. To upgrade multiple directories from one schema, you would need to call this API on each directory.

" - }, - "UpgradePublishedSchema":{ - "name":"UpgradePublishedSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/upgradepublished", - "responseCode":200 - }, - "input":{"shape":"UpgradePublishedSchemaRequest"}, - "output":{"shape":"UpgradePublishedSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"IncompatibleSchemaException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Upgrades a published schema under a new minor version revision using the current contents of DevelopmentSchemaArn.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Access denied. Check your permissions.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "AddFacetToObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifiers for the facet that you are adding to the object. See SchemaFacet for details.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

Attributes on the facet that you are adding to the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object you are adding the specified facet to.

" - } - } - }, - "AddFacetToObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "ApplySchemaRequest":{ - "type":"structure", - "required":[ - "PublishedSchemaArn", - "DirectoryArn" - ], - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

Published schema Amazon Resource Name (ARN) that needs to be copied. For more information, see arns.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory into which the schema is copied. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "ApplySchemaResponse":{ - "type":"structure", - "members":{ - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

The applied schema ARN that is associated with the copied schema in the Directory. You can use this ARN to describe the schema information applied on this directory. For more information, see arns.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the Directory. For more information, see arns.

" - } - } - }, - "Arn":{"type":"string"}, - "Arns":{ - "type":"list", - "member":{"shape":"Arn"} - }, - "AttachObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ParentReference", - "ChildReference", - "LinkName" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent object reference.

" - }, - "ChildReference":{ - "shape":"ObjectReference", - "documentation":"

The child object reference to be attached to the object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The link name with which the child object is attached to the parent.

" - } - } - }, - "AttachObjectResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The attached ObjectIdentifier, which is the child ObjectIdentifier.

" - } - } - }, - "AttachPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that is associated with the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object to which the policy will be attached.

" - } - } - }, - "AttachPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "AttachToIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where the object and index exist.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index that you are attaching the object to.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that you are attaching to the index.

" - } - } - }, - "AttachToIndexResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was attached to the index.

" - } - } - }, - "AttachTypedLinkRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SourceObjectReference", - "TargetObjectReference", - "TypedLinkFacet", - "Attributes" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to attach the typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "Attributes":{ - "shape":"AttributeNameAndValueList", - "documentation":"

A set of attributes that are associated with the typed link.

" - } - } - }, - "AttachTypedLinkResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Returns a typed link specifier as output.

" - } - } - }, - "AttributeKey":{ - "type":"structure", - "required":[ - "SchemaArn", - "FacetName", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.

" - }, - "FacetName":{ - "shape":"FacetName", - "documentation":"

The name of the facet that the attribute exists within.

" - }, - "Name":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - } - }, - "documentation":"

A unique identifier for an attribute.

" - }, - "AttributeKeyAndValue":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute.

" - }, - "Value":{ - "shape":"TypedAttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

The combination of an attribute key and an attribute value.

" - }, - "AttributeKeyAndValueList":{ - "type":"list", - "member":{"shape":"AttributeKeyAndValue"} - }, - "AttributeKeyList":{ - "type":"list", - "member":{"shape":"AttributeKey"} - }, - "AttributeName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "AttributeNameAndValue":{ - "type":"structure", - "required":[ - "AttributeName", - "Value" - ], - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The attribute name of the typed link.

" - }, - "Value":{ - "shape":"TypedAttributeValue", - "documentation":"

The value for the typed link.

" - } - }, - "documentation":"

Identifies the attribute name and value for a typed link.

" - }, - "AttributeNameAndValueList":{ - "type":"list", - "member":{"shape":"AttributeNameAndValue"} - }, - "AttributeNameList":{ - "type":"list", - "member":{"shape":"AttributeName"} - }, - "BatchAddFacetToObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectAttributeList", - "ObjectReference" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Represents the facet being added to the object.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes to set on the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being mutated.

" - } - }, - "documentation":"

Represents the output of a batch add facet to object operation.

" - }, - "BatchAddFacetToObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a batch add facet to object operation.

" - }, - "BatchAttachObject":{ - "type":"structure", - "required":[ - "ParentReference", - "ChildReference", - "LinkName" - ], - "members":{ - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent object reference.

" - }, - "ChildReference":{ - "shape":"ObjectReference", - "documentation":"

The child object reference that is to be attached to the object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - } - }, - "documentation":"

Represents the output of an AttachObject operation.

" - }, - "BatchAttachObjectResponse":{ - "type":"structure", - "members":{ - "attachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that has been attached.

" - } - }, - "documentation":"

Represents the output batch AttachObject response operation.

" - }, - "BatchAttachPolicy":{ - "type":"structure", - "required":[ - "PolicyReference", - "ObjectReference" - ], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that is associated with the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object to which the policy will be attached.

" - } - }, - "documentation":"

Attaches a policy object to a regular object inside a BatchRead operation. For more information, see AttachPolicy and BatchReadRequest$Operations.

" - }, - "BatchAttachPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of an AttachPolicy response operation.

" - }, - "BatchAttachToIndex":{ - "type":"structure", - "required":[ - "IndexReference", - "TargetReference" - ], - "members":{ - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index that you are attaching the object to.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that you are attaching to the index.

" - } - }, - "documentation":"

Attaches the specified object to the specified index inside a BatchRead operation. For more information, see AttachToIndex and BatchReadRequest$Operations.

" - }, - "BatchAttachToIndexResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was attached to the index.

" - } - }, - "documentation":"

Represents the output of a AttachToIndex response operation.

" - }, - "BatchAttachTypedLink":{ - "type":"structure", - "required":[ - "SourceObjectReference", - "TargetObjectReference", - "TypedLinkFacet", - "Attributes" - ], - "members":{ - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "Attributes":{ - "shape":"AttributeNameAndValueList", - "documentation":"

A set of attributes that are associated with the typed link.

" - } - }, - "documentation":"

Attaches a typed link to a specified source and target object inside a BatchRead operation. For more information, see AttachTypedLink and BatchReadRequest$Operations.

" - }, - "BatchAttachTypedLinkResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Returns a typed link specifier as output.

" - } - }, - "documentation":"

Represents the output of a AttachTypedLink response operation.

" - }, - "BatchCreateIndex":{ - "type":"structure", - "required":[ - "OrderedIndexedAttributeList", - "IsUnique" - ], - "members":{ - "OrderedIndexedAttributeList":{ - "shape":"AttributeKeyList", - "documentation":"

Specifies the attributes that should be indexed on. Currently only a single attribute is supported.

" - }, - "IsUnique":{ - "shape":"Bool", - "documentation":"

Indicates whether the attribute that is being indexed has unique values or not.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the parent object that contains the index object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link between the parent object and the index object.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Creates an index object inside of a BatchRead operation. For more information, see CreateIndex and BatchReadRequest$Operations.

" - }, - "BatchCreateIndexResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the index created by this operation.

" - } - }, - "documentation":"

Represents the output of a CreateIndex response operation.

" - }, - "BatchCreateObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectAttributeList" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacetList", - "documentation":"

A list of FacetArns that will be associated with the object. For more information, see arns.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

An attribute map, which contains an attribute ARN as the key and attribute value as the map value.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

If specified, the parent reference to which this object will be attached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Represents the output of a CreateObject operation.

" - }, - "BatchCreateObjectResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ID that is associated with the object.

" - } - }, - "documentation":"

Represents the output of a CreateObject response operation.

" - }, - "BatchDeleteObject":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object.

" - } - }, - "documentation":"

Represents the output of a DeleteObject operation.

" - }, - "BatchDeleteObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DeleteObject response operation.

" - }, - "BatchDetachFromIndex":{ - "type":"structure", - "required":[ - "IndexReference", - "TargetReference" - ], - "members":{ - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index object.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being detached from the index.

" - } - }, - "documentation":"

Detaches the specified object from the specified index inside a BatchRead operation. For more information, see DetachFromIndex and BatchReadRequest$Operations.

" - }, - "BatchDetachFromIndexResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was detached from the index.

" - } - }, - "documentation":"

Represents the output of a DetachFromIndex response operation.

" - }, - "BatchDetachObject":{ - "type":"structure", - "required":[ - "ParentReference", - "LinkName" - ], - "members":{ - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

Parent reference from which the object with the specified link name is detached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Represents the output of a DetachObject operation.

" - }, - "BatchDetachObjectResponse":{ - "type":"structure", - "members":{ - "detachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the detached object.

" - } - }, - "documentation":"

Represents the output of a DetachObject response operation.

" - }, - "BatchDetachPolicy":{ - "type":"structure", - "required":[ - "PolicyReference", - "ObjectReference" - ], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policy object will be detached.

" - } - }, - "documentation":"

Detaches the specified policy from the specified directory inside a BatchWrite operation. For more information, see DetachPolicy and BatchWriteRequest$Operations.

" - }, - "BatchDetachPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DetachPolicy response operation.

" - }, - "BatchDetachTypedLink":{ - "type":"structure", - "required":["TypedLinkSpecifier"], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Used to accept a typed link specifier as input.

" - } - }, - "documentation":"

Detaches a typed link from a specified source and target object inside a BatchRead operation. For more information, see DetachTypedLink and BatchReadRequest$Operations.

" - }, - "BatchDetachTypedLinkResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DetachTypedLink response operation.

" - }, - "BatchGetLinkAttributes":{ - "type":"structure", - "required":[ - "TypedLinkSpecifier", - "AttributeNames" - ], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attribute names whose values will be retrieved.

" - } - }, - "documentation":"

Retrieves attributes that are associated with a typed link inside a BatchRead operation. For more information, see GetLinkAttributes and BatchReadRequest$Operations.

" - }, - "BatchGetLinkAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the typed link.

" - } - }, - "documentation":"

Represents the output of a GetLinkAttributes response operation.

" - }, - "BatchGetObjectAttributes":{ - "type":"structure", - "required":[ - "ObjectReference", - "SchemaFacet", - "AttributeNames" - ], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be retrieved.

" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

List of attribute names whose values will be retrieved.

" - } - }, - "documentation":"

Retrieves attributes within a facet that are associated with an object inside an BatchRead operation. For more information, see GetObjectAttributes and BatchReadRequest$Operations.

" - }, - "BatchGetObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attribute values that are associated with an object.

" - } - }, - "documentation":"

Represents the output of a GetObjectAttributes response operation.

" - }, - "BatchGetObjectInformation":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object.

" - } - }, - "documentation":"

Retrieves metadata about an object inside a BatchRead operation. For more information, see GetObjectInformation and BatchReadRequest$Operations.

" - }, - "BatchGetObjectInformationResponse":{ - "type":"structure", - "members":{ - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

The facets attached to the specified object.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the specified object.

" - } - }, - "documentation":"

Represents the output of a GetObjectInformation response operation.

" - }, - "BatchListAttachedIndices":{ - "type":"structure", - "required":["TargetReference"], - "members":{ - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that has indices attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Lists indices attached to an object inside a BatchRead operation. For more information, see ListAttachedIndices and BatchReadRequest$Operations.

" - }, - "BatchListAttachedIndicesResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The indices attached to the specified object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListAttachedIndices response operation.

" - }, - "BatchListIncomingTypedLinks":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object inside a BatchRead operation. For more information, see ListIncomingTypedLinks and BatchReadRequest$Operations.

" - }, - "BatchListIncomingTypedLinksResponse":{ - "type":"structure", - "members":{ - "LinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns one or more typed link specifiers as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListIncomingTypedLinks response operation.

" - }, - "BatchListIndex":{ - "type":"structure", - "required":["IndexReference"], - "members":{ - "RangesOnIndexedValues":{ - "shape":"ObjectAttributeRangeList", - "documentation":"

Specifies the ranges of indexed values that you want to query.

" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

The reference to the index to list.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Lists objects attached to the specified index inside a BatchRead operation. For more information, see ListIndex and BatchReadRequest$Operations.

" - }, - "BatchListIndexResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The objects and indexed values attached to the index.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListIndex response operation.

" - }, - "BatchListObjectAttributes":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference of the object whose attributes need to be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "FacetFilter":{ - "shape":"SchemaFacet", - "documentation":"

Used to filter the list of object attributes that are associated with a certain facet.

" - } - }, - "documentation":"

Represents the output of a ListObjectAttributes operation.

" - }, - "BatchListObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes map that is associated with the object. AttributeArn is the key; attribute value is the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectAttributes response operation.

" - }, - "BatchListObjectChildren":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference of the object for which child objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

Maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - }, - "documentation":"

Represents the output of a ListObjectChildren operation.

" - }, - "BatchListObjectChildrenResponse":{ - "type":"structure", - "members":{ - "Children":{ - "shape":"LinkNameToObjectIdentifierMap", - "documentation":"

The children structure, which is a map with the key as the LinkName and ObjectIdentifier as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectChildren response operation.

" - }, - "BatchListObjectParentPaths":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects inside a BatchRead operation. For more information, see ListObjectParentPaths and BatchReadRequest$Operations.

" - }, - "BatchListObjectParentPathsResponse":{ - "type":"structure", - "members":{ - "PathToObjectIdentifiersList":{ - "shape":"PathToObjectIdentifiersList", - "documentation":"

Returns the path to the ObjectIdentifiers that are associated with the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectParentPaths response operation.

" - }, - "BatchListObjectPolicies":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns policies attached to an object in pagination fashion inside a BatchRead operation. For more information, see ListObjectPolicies and BatchReadRequest$Operations.

" - }, - "BatchListObjectPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicyIds":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of policy ObjectIdentifiers, that are attached to the object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectPolicies response operation.

" - }, - "BatchListOutgoingTypedLinks":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object inside a BatchRead operation. For more information, see ListOutgoingTypedLinks and BatchReadRequest$Operations.

" - }, - "BatchListOutgoingTypedLinksResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns a typed link specifier as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListOutgoingTypedLinks response operation.

" - }, - "BatchListPolicyAttachments":{ - "type":"structure", - "required":["PolicyReference"], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the policy object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached inside a BatchRead operation. For more information, see ListPolicyAttachments and BatchReadRequest$Operations.

" - }, - "BatchListPolicyAttachmentsResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of ObjectIdentifiers to which the policy is attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListPolicyAttachments response operation.

" - }, - "BatchLookupPolicy":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policies will be looked up.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Lists all policies from the root of the Directory to the object specified inside a BatchRead operation. For more information, see LookupPolicy and BatchReadRequest$Operations.

" - }, - "BatchLookupPolicyResponse":{ - "type":"structure", - "members":{ - "PolicyToPathList":{ - "shape":"PolicyToPathList", - "documentation":"

Provides list of path to policies. Policies contain PolicyId, ObjectIdentifier, and PolicyType. For more information, see Policies.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a LookupPolicy response operation.

" - }, - "BatchOperationIndex":{"type":"integer"}, - "BatchReadException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"BatchReadExceptionType", - "documentation":"

A type of exception, such as InvalidArnException.

" - }, - "Message":{ - "shape":"ExceptionMessage", - "documentation":"

An exception message that is associated with the failure.

" - } - }, - "documentation":"

The batch read exception structure, which contains the exception type and message.

" - }, - "BatchReadExceptionType":{ - "type":"string", - "enum":[ - "ValidationException", - "InvalidArnException", - "ResourceNotFoundException", - "InvalidNextTokenException", - "AccessDeniedException", - "NotNodeException", - "FacetValidationException", - "CannotListParentOfRootException", - "NotIndexException", - "NotPolicyException", - "DirectoryNotEnabledException", - "LimitExceededException", - "InternalServiceException" - ] - }, - "BatchReadOperation":{ - "type":"structure", - "members":{ - "ListObjectAttributes":{ - "shape":"BatchListObjectAttributes", - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "shape":"BatchListObjectChildren", - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "ListAttachedIndices":{ - "shape":"BatchListAttachedIndices", - "documentation":"

Lists indices attached to an object.

" - }, - "ListObjectParentPaths":{ - "shape":"BatchListObjectParentPaths", - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

" - }, - "GetObjectInformation":{ - "shape":"BatchGetObjectInformation", - "documentation":"

Retrieves metadata about an object.

" - }, - "GetObjectAttributes":{ - "shape":"BatchGetObjectAttributes", - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "ListObjectPolicies":{ - "shape":"BatchListObjectPolicies", - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListPolicyAttachments":{ - "shape":"BatchListPolicyAttachments", - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "LookupPolicy":{ - "shape":"BatchLookupPolicy", - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "ListIndex":{ - "shape":"BatchListIndex", - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListOutgoingTypedLinks":{ - "shape":"BatchListOutgoingTypedLinks", - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIncomingTypedLinks":{ - "shape":"BatchListIncomingTypedLinks", - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "GetLinkAttributes":{ - "shape":"BatchGetLinkAttributes", - "documentation":"

Retrieves attributes that are associated with a typed link.

" - } - }, - "documentation":"

Represents the output of a BatchRead operation.

" - }, - "BatchReadOperationList":{ - "type":"list", - "member":{"shape":"BatchReadOperation"} - }, - "BatchReadOperationResponse":{ - "type":"structure", - "members":{ - "SuccessfulResponse":{ - "shape":"BatchReadSuccessfulResponse", - "documentation":"

Identifies which operation in a batch has succeeded.

" - }, - "ExceptionResponse":{ - "shape":"BatchReadException", - "documentation":"

Identifies which operation in a batch has failed.

" - } - }, - "documentation":"

Represents the output of a BatchRead response operation.

" - }, - "BatchReadOperationResponseList":{ - "type":"list", - "member":{"shape":"BatchReadOperationResponse"} - }, - "BatchReadRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Operations" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Operations":{ - "shape":"BatchReadOperationList", - "documentation":"

A list of operations that are part of the batch.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "BatchReadResponse":{ - "type":"structure", - "members":{ - "Responses":{ - "shape":"BatchReadOperationResponseList", - "documentation":"

A list of all the responses for each batch read.

" - } - } - }, - "BatchReadSuccessfulResponse":{ - "type":"structure", - "members":{ - "ListObjectAttributes":{ - "shape":"BatchListObjectAttributesResponse", - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "shape":"BatchListObjectChildrenResponse", - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "GetObjectInformation":{ - "shape":"BatchGetObjectInformationResponse", - "documentation":"

Retrieves metadata about an object.

" - }, - "GetObjectAttributes":{ - "shape":"BatchGetObjectAttributesResponse", - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "ListAttachedIndices":{ - "shape":"BatchListAttachedIndicesResponse", - "documentation":"

Lists indices attached to an object.

" - }, - "ListObjectParentPaths":{ - "shape":"BatchListObjectParentPathsResponse", - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

" - }, - "ListObjectPolicies":{ - "shape":"BatchListObjectPoliciesResponse", - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListPolicyAttachments":{ - "shape":"BatchListPolicyAttachmentsResponse", - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "LookupPolicy":{ - "shape":"BatchLookupPolicyResponse", - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "ListIndex":{ - "shape":"BatchListIndexResponse", - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListOutgoingTypedLinks":{ - "shape":"BatchListOutgoingTypedLinksResponse", - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIncomingTypedLinks":{ - "shape":"BatchListIncomingTypedLinksResponse", - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "GetLinkAttributes":{ - "shape":"BatchGetLinkAttributesResponse", - "documentation":"

The list of attributes to retrieve from the typed link.

" - } - }, - "documentation":"

Represents the output of a BatchRead success response operation.

" - }, - "BatchReferenceName":{"type":"string"}, - "BatchRemoveFacetFromObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

The facet to remove from the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object whose facet will be removed.

" - } - }, - "documentation":"

A batch operation to remove a facet from an object.

" - }, - "BatchRemoveFacetFromObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty result that represents success.

" - }, - "BatchUpdateLinkAttributes":{ - "type":"structure", - "required":[ - "TypedLinkSpecifier", - "AttributeUpdates" - ], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeUpdates":{ - "shape":"LinkAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - }, - "documentation":"

Updates a given typed link’s attributes inside a BatchRead operation. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder. For more information, see UpdateLinkAttributes and BatchReadRequest$Operations.

" - }, - "BatchUpdateLinkAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a UpdateLinkAttributes response operation.

" - }, - "BatchUpdateObjectAttributes":{ - "type":"structure", - "required":[ - "ObjectReference", - "AttributeUpdates" - ], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object.

" - }, - "AttributeUpdates":{ - "shape":"ObjectAttributeUpdateList", - "documentation":"

Attributes update structure.

" - } - }, - "documentation":"

Represents the output of a BatchUpdate operation.

" - }, - "BatchUpdateObjectAttributesResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

ID that is associated with the object.

" - } - }, - "documentation":"

Represents the output of a BatchUpdate response operation.

" - }, - "BatchWriteException":{ - "type":"structure", - "members":{ - "Index":{"shape":"BatchOperationIndex"}, - "Type":{"shape":"BatchWriteExceptionType"}, - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A BatchWrite exception has occurred.

", - "exception":true - }, - "BatchWriteExceptionType":{ - "type":"string", - "enum":[ - "InternalServiceException", - "ValidationException", - "InvalidArnException", - "LinkNameAlreadyInUseException", - "StillContainsLinksException", - "FacetValidationException", - "ObjectNotDetachedException", - "ResourceNotFoundException", - "AccessDeniedException", - "InvalidAttachmentException", - "NotIndexException", - "NotNodeException", - "IndexedAttributeMissingException", - "ObjectAlreadyDetachedException", - "NotPolicyException", - "DirectoryNotEnabledException", - "LimitExceededException", - "UnsupportedIndexTypeException" - ] - }, - "BatchWriteOperation":{ - "type":"structure", - "members":{ - "CreateObject":{ - "shape":"BatchCreateObject", - "documentation":"

Creates an object.

" - }, - "AttachObject":{ - "shape":"BatchAttachObject", - "documentation":"

Attaches an object to a Directory.

" - }, - "DetachObject":{ - "shape":"BatchDetachObject", - "documentation":"

Detaches an object from a Directory.

" - }, - "UpdateObjectAttributes":{ - "shape":"BatchUpdateObjectAttributes", - "documentation":"

Updates a given object's attributes.

" - }, - "DeleteObject":{ - "shape":"BatchDeleteObject", - "documentation":"

Deletes an object in a Directory.

" - }, - "AddFacetToObject":{ - "shape":"BatchAddFacetToObject", - "documentation":"

A batch operation that adds a facet to an object.

" - }, - "RemoveFacetFromObject":{ - "shape":"BatchRemoveFacetFromObject", - "documentation":"

A batch operation that removes a facet from an object.

" - }, - "AttachPolicy":{ - "shape":"BatchAttachPolicy", - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "DetachPolicy":{ - "shape":"BatchDetachPolicy", - "documentation":"

Detaches a policy from a Directory.

" - }, - "CreateIndex":{ - "shape":"BatchCreateIndex", - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "AttachToIndex":{ - "shape":"BatchAttachToIndex", - "documentation":"

Attaches the specified object to the specified index.

" - }, - "DetachFromIndex":{ - "shape":"BatchDetachFromIndex", - "documentation":"

Detaches the specified object from the specified index.

" - }, - "AttachTypedLink":{ - "shape":"BatchAttachTypedLink", - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "DetachTypedLink":{ - "shape":"BatchDetachTypedLink", - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "UpdateLinkAttributes":{ - "shape":"BatchUpdateLinkAttributes", - "documentation":"

Updates a given object's attributes.

" - } - }, - "documentation":"

Represents the output of a BatchWrite operation.

" - }, - "BatchWriteOperationList":{ - "type":"list", - "member":{"shape":"BatchWriteOperation"} - }, - "BatchWriteOperationResponse":{ - "type":"structure", - "members":{ - "CreateObject":{ - "shape":"BatchCreateObjectResponse", - "documentation":"

Creates an object in a Directory.

" - }, - "AttachObject":{ - "shape":"BatchAttachObjectResponse", - "documentation":"

Attaches an object to a Directory.

" - }, - "DetachObject":{ - "shape":"BatchDetachObjectResponse", - "documentation":"

Detaches an object from a Directory.

" - }, - "UpdateObjectAttributes":{ - "shape":"BatchUpdateObjectAttributesResponse", - "documentation":"

Updates a given object’s attributes.

" - }, - "DeleteObject":{ - "shape":"BatchDeleteObjectResponse", - "documentation":"

Deletes an object in a Directory.

" - }, - "AddFacetToObject":{ - "shape":"BatchAddFacetToObjectResponse", - "documentation":"

The result of an add facet to object batch operation.

" - }, - "RemoveFacetFromObject":{ - "shape":"BatchRemoveFacetFromObjectResponse", - "documentation":"

The result of a batch remove facet from object operation.

" - }, - "AttachPolicy":{ - "shape":"BatchAttachPolicyResponse", - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "DetachPolicy":{ - "shape":"BatchDetachPolicyResponse", - "documentation":"

Detaches a policy from a Directory.

" - }, - "CreateIndex":{ - "shape":"BatchCreateIndexResponse", - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "AttachToIndex":{ - "shape":"BatchAttachToIndexResponse", - "documentation":"

Attaches the specified object to the specified index.

" - }, - "DetachFromIndex":{ - "shape":"BatchDetachFromIndexResponse", - "documentation":"

Detaches the specified object from the specified index.

" - }, - "AttachTypedLink":{ - "shape":"BatchAttachTypedLinkResponse", - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "DetachTypedLink":{ - "shape":"BatchDetachTypedLinkResponse", - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "UpdateLinkAttributes":{ - "shape":"BatchUpdateLinkAttributesResponse", - "documentation":"

Represents the output of a BatchWrite response operation.

" - } - }, - "documentation":"

Represents the output of a BatchWrite response operation.

" - }, - "BatchWriteOperationResponseList":{ - "type":"list", - "member":{"shape":"BatchWriteOperationResponse"} - }, - "BatchWriteRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Operations" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Operations":{ - "shape":"BatchWriteOperationList", - "documentation":"

A list of operations that are part of the batch.

" - } - } - }, - "BatchWriteResponse":{ - "type":"structure", - "members":{ - "Responses":{ - "shape":"BatchWriteOperationResponseList", - "documentation":"

A list of all the responses for each batch write.

" - } - } - }, - "BinaryAttributeValue":{"type":"blob"}, - "Bool":{"type":"boolean"}, - "BooleanAttributeValue":{"type":"boolean"}, - "CannotListParentOfRootException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Cannot list the parents of a Directory root.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ConsistencyLevel":{ - "type":"string", - "enum":[ - "SERIALIZABLE", - "EVENTUAL" - ] - }, - "CreateDirectoryRequest":{ - "type":"structure", - "required":[ - "Name", - "SchemaArn" - ], - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the Directory. Should be unique per account, per region.

" - }, - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the published schema that will be copied into the data Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "CreateDirectoryResponse":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Name", - "ObjectIdentifier", - "AppliedSchemaArn" - ], - "members":{ - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The ARN that is associated with the Directory. For more information, see arns.

" - }, - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the Directory.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The root object node of the created directory.

" - }, - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the published schema in the Directory. Once a published schema is copied into the directory, it has its own ARN, which is referred to applied schema ARN. For more information, see arns.

" - } - } - }, - "CreateFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name", - "ObjectType" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The schema ARN in which the new Facet will be created. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the Facet, which is unique for a given schema.

" - }, - "Attributes":{ - "shape":"FacetAttributeList", - "documentation":"

The attributes that are associated with the Facet.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

Specifies whether a given object created from this facet is of type node, leaf node, policy or index.

  • Node: Can have multiple children but one parent.

  • Leaf node: Cannot have children but can have multiple parents.

  • Policy: Allows you to store a policy document and policy type. For more information, see Policies.

  • Index: Can be created with the Index API.

" - } - } - }, - "CreateFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "OrderedIndexedAttributeList", - "IsUnique" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory where the index should be created.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "OrderedIndexedAttributeList":{ - "shape":"AttributeKeyList", - "documentation":"

Specifies the attributes that should be indexed on. Currently only a single attribute is supported.

" - }, - "IsUnique":{ - "shape":"Bool", - "documentation":"

Indicates whether the attribute that is being indexed has unique values or not.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the parent object that contains the index object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link between the parent object and the index object.

" - } - } - }, - "CreateIndexResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the index created by this operation.

" - } - } - }, - "CreateObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacets" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory in which the object will be created. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

A list of schema facets to be associated with the object. Do not provide minor version components. See SchemaFacet for details.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attribute map whose attribute ARN contains the key and attribute value as the map value.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

If specified, the parent reference to which this object will be attached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of link that is used to attach this object to a parent.

" - } - } - }, - "CreateObjectResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The identifier that is associated with the object.

" - } - } - }, - "CreateSchemaRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"SchemaName", - "documentation":"

The name that is associated with the schema. This is unique to each account and in each region.

" - } - } - }, - "CreateSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

" - } - } - }, - "CreateTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Facet" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Facet":{ - "shape":"TypedLinkFacet", - "documentation":"

Facet structure that is associated with the typed link facet.

" - } - } - }, - "CreateTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "Date":{"type":"timestamp"}, - "DatetimeAttributeValue":{"type":"timestamp"}, - "DeleteDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to delete.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DeleteDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the deleted directory.

" - } - } - }, - "DeleteFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet to delete.

" - } - } - }, - "DeleteFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference that identifies the object.

" - } - } - }, - "DeleteObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteSchemaRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DeleteSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The input ARN that is returned as part of the response. For more information, see arns.

" - } - } - }, - "DeleteTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - } - }, - "DeleteTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "DetachFromIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory the index and object exist in.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index object.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being detached from the index.

" - } - } - }, - "DetachFromIndexResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was detached from the index.

" - } - } - }, - "DetachObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ParentReference", - "LinkName" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent reference from which the object with the specified link name is detached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The link name associated with the object that needs to be detached.

" - } - } - }, - "DetachObjectResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier that was detached from the object.

" - } - } - }, - "DetachPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policy object will be detached.

" - } - } - }, - "DetachPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "DetachTypedLinkRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to detach the typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Used to accept a typed link specifier as input.

" - } - } - }, - "Directory":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the directory.

" - }, - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the directory. For more information, see arns.

" - }, - "State":{ - "shape":"DirectoryState", - "documentation":"

The state of the directory. Can be either Enabled, Disabled, or Deleted.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the directory was created.

" - } - }, - "documentation":"

Directory structure that includes the directory name and directory ARN.

" - }, - "DirectoryAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a Directory could not be created due to a naming conflict. Choose a different name and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryArn":{"type":"string"}, - "DirectoryDeletedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A directory that has been deleted and to which access has been attempted. Note: The requested resource will eventually cease to exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryList":{ - "type":"list", - "member":{"shape":"Directory"} - }, - "DirectoryName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "DirectoryNotDisabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An operation can only operate on a disabled directory.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryNotEnabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Operations are only permitted on enabled directories.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED", - "DELETED" - ] - }, - "DisableDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to disable.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DisableDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that has been disabled.

" - } - } - }, - "EnableDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to enable.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "EnableDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the enabled directory.

" - } - } - }, - "ExceptionMessage":{"type":"string"}, - "Facet":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the Facet.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.

" - } - }, - "documentation":"

A structure that contains Name, ARN, Attributes, Rules, and ObjectTypes. See Facets for more information.

" - }, - "FacetAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A facet with the same name already exists.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetAttribute":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"AttributeName", - "documentation":"

The name of the facet attribute.

" - }, - "AttributeDefinition":{ - "shape":"FacetAttributeDefinition", - "documentation":"

A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.

" - }, - "AttributeReference":{ - "shape":"FacetAttributeReference", - "documentation":"

An attribute reference that is associated with the attribute. See Attribute References for more information.

" - }, - "RequiredBehavior":{ - "shape":"RequiredAttributeBehavior", - "documentation":"

The required behavior of the FacetAttribute.

" - } - }, - "documentation":"

An attribute that is associated with the Facet.

" - }, - "FacetAttributeDefinition":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"FacetAttributeType", - "documentation":"

The type of the attribute.

" - }, - "DefaultValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The default value of the attribute (if configured).

" - }, - "IsImmutable":{ - "shape":"Bool", - "documentation":"

Whether the attribute is mutable or not.

" - }, - "Rules":{ - "shape":"RuleMap", - "documentation":"

Validation rules attached to the attribute definition.

" - } - }, - "documentation":"

A facet attribute definition. See Attribute References for more information.

" - }, - "FacetAttributeList":{ - "type":"list", - "member":{"shape":"FacetAttribute"} - }, - "FacetAttributeReference":{ - "type":"structure", - "required":[ - "TargetFacetName", - "TargetAttributeName" - ], - "members":{ - "TargetFacetName":{ - "shape":"FacetName", - "documentation":"

The target facet name that is associated with the facet reference. See Attribute References for more information.

" - }, - "TargetAttributeName":{ - "shape":"AttributeName", - "documentation":"

The target attribute name that is associated with the facet reference. See Attribute References for more information.

" - } - }, - "documentation":"

The facet attribute reference that specifies the attribute definition that contains the attribute facet name and attribute name.

" - }, - "FacetAttributeType":{ - "type":"string", - "enum":[ - "STRING", - "BINARY", - "BOOLEAN", - "NUMBER", - "DATETIME" - ] - }, - "FacetAttributeUpdate":{ - "type":"structure", - "members":{ - "Attribute":{ - "shape":"FacetAttribute", - "documentation":"

The attribute to update.

" - }, - "Action":{ - "shape":"UpdateActionType", - "documentation":"

The action to perform when updating the attribute.

" - } - }, - "documentation":"

A structure that contains information used to update an attribute.

" - }, - "FacetAttributeUpdateList":{ - "type":"list", - "member":{"shape":"FacetAttributeUpdate"} - }, - "FacetInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when deleting a facet that contains an attribute that is a target to an attribute reference in a different facet.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "FacetNameList":{ - "type":"list", - "member":{"shape":"FacetName"} - }, - "FacetNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified Facet could not be found.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The Facet that you provided was not well formed or could not be validated with the schema.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "GetAppliedSchemaVersionRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the applied schema.

" - } - } - }, - "GetAppliedSchemaVersionResponse":{ - "type":"structure", - "members":{ - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

Current applied schema ARN, including the minor version in use if one was provided.

" - } - } - }, - "GetDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The ARN of the directory.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "GetDirectoryResponse":{ - "type":"structure", - "required":["Directory"], - "members":{ - "Directory":{ - "shape":"Directory", - "documentation":"

Metadata about the directory.

" - } - } - }, - "GetFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet to retrieve.

" - } - } - }, - "GetFacetResponse":{ - "type":"structure", - "members":{ - "Facet":{ - "shape":"Facet", - "documentation":"

The Facet structure that is associated with the facet.

" - } - } - }, - "GetLinkAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier", - "AttributeNames" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the typed link resides. For more information, see arns or Typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attribute names whose values will be retrieved.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the attributes on a typed link.

" - } - } - }, - "GetLinkAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the typed link.

" - } - } - }, - "GetObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference", - "SchemaFacet", - "AttributeNames" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be retrieved.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the attributes on an object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

List of attribute names whose values will be retrieved.

" - } - } - }, - "GetObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the object.

" - } - } - }, - "GetObjectInformationRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory being retrieved.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the object information.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "GetObjectInformationResponse":{ - "type":"structure", - "members":{ - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

The facets attached to the specified object. Although the response does not include minor version information, the most recently applied minor version of each Facet is in effect. See GetAppliedSchemaVersion for details.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the specified object.

" - } - } - }, - "GetSchemaAsJsonRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to retrieve.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "GetSchemaAsJsonResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"SchemaName", - "documentation":"

The name of the retrieved schema.

" - }, - "Document":{ - "shape":"SchemaJsonDocument", - "documentation":"

The JSON representation of the schema document.

" - } - } - }, - "GetTypedLinkFacetInformationRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - } - }, - "GetTypedLinkFacetInformationResponse":{ - "type":"structure", - "members":{ - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed link.

" - } - } - }, - "IncompatibleSchemaException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates a failure occurred while performing a check for backward compatibility between the specified schema and the schema that is currently applied to the directory.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "IndexAttachment":{ - "type":"structure", - "members":{ - "IndexedAttributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The indexed attribute values.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

In response to ListIndex, the ObjectIdentifier of the object attached to the index. In response to ListAttachedIndices, the ObjectIdentifier of the index attached to the object. This field will always contain the ObjectIdentifier of the object on the opposite side of the attachment specified in the query.

" - } - }, - "documentation":"

Represents an index and an attached object.

" - }, - "IndexAttachmentList":{ - "type":"list", - "member":{"shape":"IndexAttachment"} - }, - "IndexedAttributeMissingException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An object has been attempted to be attached to an object that does not have the appropriate attribute value.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates a problem that must be resolved by Amazon Web Services. This might be a transient error in which case you can retry your request until it succeeds. Otherwise, go to the AWS Service Health Dashboard site to see if there are any operational issues with the service.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "InvalidArnException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the provided ARN value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidAttachmentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that an attempt to attach an object with the same link name or to apply a schema with the same name has occurred. Rename the link or the schema and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidFacetUpdateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An attempt to modify a Facet resulted in an invalid schema exception.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the NextToken value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRuleException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when any of the rule parameter keys or values are invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidSchemaDocException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the provided SchemaDoc value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTaggingRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Can occur for multiple reasons such as when you tag a resource that doesn’t exist or if you specify a higher number of tags for a resource than the allowed limit. Allowed limit is 50 tags per resource.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that limits are exceeded. See Limits for more information.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LinkAttributeAction":{ - "type":"structure", - "members":{ - "AttributeActionType":{ - "shape":"UpdateActionType", - "documentation":"

A type that can be either UPDATE_OR_CREATE or DELETE.

" - }, - "AttributeUpdateValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value that you want to update to.

" - } - }, - "documentation":"

The action to take on a typed link attribute value. Updates are only supported for attributes which don’t contribute to link identity.

" - }, - "LinkAttributeUpdate":{ - "type":"structure", - "members":{ - "AttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute being updated.

" - }, - "AttributeAction":{ - "shape":"LinkAttributeAction", - "documentation":"

The action to perform as part of the attribute update.

" - } - }, - "documentation":"

Structure that contains attribute update information.

" - }, - "LinkAttributeUpdateList":{ - "type":"list", - "member":{"shape":"LinkAttributeUpdate"} - }, - "LinkName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[^\\/\\[\\]\\(\\):\\{\\}#@!?\\s\\\\;]+" - }, - "LinkNameAlreadyInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a link could not be created due to a naming conflict. Choose a different name and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LinkNameToObjectIdentifierMap":{ - "type":"map", - "key":{"shape":"LinkName"}, - "value":{"shape":"ObjectIdentifier"} - }, - "ListAppliedSchemaArnsRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory you are listing.

" - }, - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The response for ListAppliedSchemaArns when this parameter is used will list all minor version ARNs for a major version.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListAppliedSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of schemas that are applied to the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListAttachedIndicesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that has indices attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to use for this operation.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListAttachedIndicesResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The indices attached to the specified object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListDevelopmentSchemaArnsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListDevelopmentSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of retrieved development schemas.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListDirectoriesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "state":{ - "shape":"DirectoryState", - "documentation":"

The state of the directories in the list. Can be either Enabled, Disabled, or Deleted.

" - } - } - }, - "ListDirectoriesResponse":{ - "type":"structure", - "required":["Directories"], - "members":{ - "Directories":{ - "shape":"DirectoryList", - "documentation":"

Lists all directories that are associated with your account in pagination fashion.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListFacetAttributesRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema where the facet resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet whose attributes will be retrieved.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListFacetAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"FacetAttributeList", - "documentation":"

The attributes attached to the facet.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListFacetNamesRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) to retrieve facet names from.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListFacetNamesResponse":{ - "type":"structure", - "members":{ - "FacetNames":{ - "shape":"FacetNameList", - "documentation":"

The names of facets that exist within the schema.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListIncomingTypedLinksRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to list the typed links.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

" - } - } - }, - "ListIncomingTypedLinksResponse":{ - "type":"structure", - "members":{ - "LinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns one or more typed link specifiers as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that the index exists in.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "RangesOnIndexedValues":{ - "shape":"ObjectAttributeRangeList", - "documentation":"

Specifies the ranges of indexed values that you want to query.

" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

The reference to the index to list.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of objects in a single page to retrieve from the index during a request. For more information, see AWS Directory Service Limits.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListIndexResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The objects and indexed values attached to the index.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - }, - "FacetFilter":{ - "shape":"SchemaFacet", - "documentation":"

Used to filter the list of object attributes that are associated with a certain facet.

" - } - } - }, - "ListObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

Attributes map that is associated with the object. AttributeArn is the key, and attribute value is the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectChildrenRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object for which child objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectChildrenResponse":{ - "type":"structure", - "members":{ - "Children":{ - "shape":"LinkNameToObjectIdentifierMap", - "documentation":"

Children structure, which is a map with key as the LinkName and ObjectIdentifier as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectParentPathsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to which the parent path applies.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose parent paths are listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - } - }, - "ListObjectParentPathsResponse":{ - "type":"structure", - "members":{ - "PathToObjectIdentifiersList":{ - "shape":"PathToObjectIdentifiersList", - "documentation":"

Returns the path to the ObjectIdentifiers that are associated with the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectParentsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object for which parent objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectParentsResponse":{ - "type":"structure", - "members":{ - "Parents":{ - "shape":"ObjectIdentifierToLinkNameMap", - "documentation":"

The parent structure, which is a map with key as the ObjectIdentifier and LinkName as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectPoliciesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object for which policies will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicyIds":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of policy ObjectIdentifiers, that are attached to the object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListOutgoingTypedLinksRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to list the typed links.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

" - } - } - }, - "ListOutgoingTypedLinksResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns a typed link specifier as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListPolicyAttachmentsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the policy object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListPolicyAttachmentsResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of ObjectIdentifiers to which the policy is attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListPublishedSchemaArnsRequest":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The response for ListPublishedSchemaArns when this parameter is used will list all minor version ARNs for a major version.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListPublishedSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of published schemas.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token. This is for future use. Currently pagination is not supported for tagging.

" - }, - "MaxResults":{ - "shape":"TagsNumberResults", - "documentation":"

The MaxResults parameter sets the maximum number of results returned in a single page. This is for future use and is not supported currently.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag key value pairs that are associated with the response.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListTypedLinkFacetAttributesRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListTypedLinkFacetAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"TypedLinkAttributeDefinitionList", - "documentation":"

An ordered set of attributes associate with the typed link.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListTypedLinkFacetNamesRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListTypedLinkFacetNamesResponse":{ - "type":"structure", - "members":{ - "FacetNames":{ - "shape":"TypedLinkNameList", - "documentation":"

The names of typed link facets that exist within the schema.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "LookupPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policies will be looked up.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - } - }, - "LookupPolicyResponse":{ - "type":"structure", - "members":{ - "PolicyToPathList":{ - "shape":"PolicyToPathList", - "documentation":"

Provides list of path to policies. Policies contain PolicyId, ObjectIdentifier, and PolicyType. For more information, see Policies.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "NextToken":{"type":"string"}, - "NotIndexException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation can only operate on index objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotNodeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when any invalid operations are performed on an object that is not a node, such as calling ListObjectChildren for a leaf node object.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotPolicyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation can only operate on policy objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NumberAttributeValue":{"type":"string"}, - "NumberResults":{ - "type":"integer", - "min":1 - }, - "ObjectAlreadyDetachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the object is not attached to the index.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ObjectAttributeAction":{ - "type":"structure", - "members":{ - "ObjectAttributeActionType":{ - "shape":"UpdateActionType", - "documentation":"

A type that can be either Update or Delete.

" - }, - "ObjectAttributeUpdateValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value that you want to update to.

" - } - }, - "documentation":"

The action to take on the object attribute.

" - }, - "ObjectAttributeRange":{ - "type":"structure", - "members":{ - "AttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute that the attribute range covers.

" - }, - "Range":{ - "shape":"TypedAttributeValueRange", - "documentation":"

The range of attribute values being selected.

" - } - }, - "documentation":"

A range of attributes.

" - }, - "ObjectAttributeRangeList":{ - "type":"list", - "member":{"shape":"ObjectAttributeRange"} - }, - "ObjectAttributeUpdate":{ - "type":"structure", - "members":{ - "ObjectAttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute being updated.

" - }, - "ObjectAttributeAction":{ - "shape":"ObjectAttributeAction", - "documentation":"

The action to perform as part of the attribute update.

" - } - }, - "documentation":"

Structure that contains attribute update information.

" - }, - "ObjectAttributeUpdateList":{ - "type":"list", - "member":{"shape":"ObjectAttributeUpdate"} - }, - "ObjectIdentifier":{"type":"string"}, - "ObjectIdentifierList":{ - "type":"list", - "member":{"shape":"ObjectIdentifier"} - }, - "ObjectIdentifierToLinkNameMap":{ - "type":"map", - "key":{"shape":"ObjectIdentifier"}, - "value":{"shape":"LinkName"} - }, - "ObjectNotDetachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation cannot be completed because the object has not been detached from the tree.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ObjectReference":{ - "type":"structure", - "members":{ - "Selector":{ - "shape":"SelectorObjectReference", - "documentation":"

A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Accessing Objects. You can identify an object in one of the following ways:

  • $ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier

  • /some/path - Identifies the object based on path

  • #SomeBatchReference - Identifies the object in a batch call

" - } - }, - "documentation":"

The reference that identifies an object.

" - }, - "ObjectType":{ - "type":"string", - "enum":[ - "NODE", - "LEAF_NODE", - "POLICY", - "INDEX" - ] - }, - "PathString":{"type":"string"}, - "PathToObjectIdentifiers":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"PathString", - "documentation":"

The path that is used to identify the object starting from directory root.

" - }, - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

Lists ObjectIdentifiers starting from directory root to the object in the request.

" - } - }, - "documentation":"

Returns the path to the ObjectIdentifiers that is associated with the directory.

" - }, - "PathToObjectIdentifiersList":{ - "type":"list", - "member":{"shape":"PathToObjectIdentifiers"} - }, - "PolicyAttachment":{ - "type":"structure", - "members":{ - "PolicyId":{ - "shape":"ObjectIdentifier", - "documentation":"

The ID of PolicyAttachment.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier that is associated with PolicyAttachment.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The type of policy that can be associated with PolicyAttachment.

" - } - }, - "documentation":"

Contains the PolicyType, PolicyId, and the ObjectIdentifier to which it is attached. For more information, see Policies.

" - }, - "PolicyAttachmentList":{ - "type":"list", - "member":{"shape":"PolicyAttachment"} - }, - "PolicyToPath":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"PathString", - "documentation":"

The path that is referenced from the root.

" - }, - "Policies":{ - "shape":"PolicyAttachmentList", - "documentation":"

List of policy objects.

" - } - }, - "documentation":"

Used when a regular object exists in a Directory and you want to find all of the policies that are associated with that object and the parent to that object.

" - }, - "PolicyToPathList":{ - "type":"list", - "member":{"shape":"PolicyToPath"} - }, - "PolicyType":{"type":"string"}, - "PublishSchemaRequest":{ - "type":"structure", - "required":[ - "DevelopmentSchemaArn", - "Version" - ], - "members":{ - "DevelopmentSchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Version":{ - "shape":"Version", - "documentation":"

The major version under which the schema will be published. Schemas have both a major and minor version associated with them.

" - }, - "MinorVersion":{ - "shape":"Version", - "documentation":"

The minor version under which the schema will be published. This parameter is recommended. Schemas have both a major and minor version associated with them.

" - }, - "Name":{ - "shape":"SchemaName", - "documentation":"

The new name under which the schema will be published. If this is not provided, the development schema is considered.

" - } - } - }, - "PublishSchemaResponse":{ - "type":"structure", - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the published schema. For more information, see arns.

" - } - } - }, - "PutSchemaFromJsonRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Document" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to update.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Document":{ - "shape":"SchemaJsonDocument", - "documentation":"

The replacement JSON schema.

" - } - } - }, - "PutSchemaFromJsonResponse":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to update.

" - } - } - }, - "RangeMode":{ - "type":"string", - "enum":[ - "FIRST", - "LAST", - "LAST_BEFORE_MISSING_VALUES", - "INCLUSIVE", - "EXCLUSIVE" - ] - }, - "RemoveFacetFromObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory in which the object resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

The facet to remove. See SchemaFacet for details.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object to remove the facet from.

" - } - } - }, - "RemoveFacetFromObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "RequiredAttributeBehavior":{ - "type":"string", - "enum":[ - "REQUIRED_ALWAYS", - "NOT_REQUIRED" - ] - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified resource could not be found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "RetryableConflictException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when a conflict with a previous successful write is detected. For example, if a write operation occurs on an object and then an attempt is made to read the object using “SERIALIZABLE” consistency, this exception may result. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "Rule":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"RuleType", - "documentation":"

The type of attribute validation rule.

" - }, - "Parameters":{ - "shape":"RuleParameterMap", - "documentation":"

The minimum and maximum parameters that are associated with the rule.

" - } - }, - "documentation":"

Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.

" - }, - "RuleKey":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "RuleMap":{ - "type":"map", - "key":{"shape":"RuleKey"}, - "value":{"shape":"Rule"} - }, - "RuleParameterKey":{"type":"string"}, - "RuleParameterMap":{ - "type":"map", - "key":{"shape":"RuleParameterKey"}, - "value":{"shape":"RuleParameterValue"} - }, - "RuleParameterValue":{"type":"string"}, - "RuleType":{ - "type":"string", - "enum":[ - "BINARY_LENGTH", - "NUMBER_COMPARISON", - "STRING_FROM_SET", - "STRING_LENGTH" - ] - }, - "SchemaAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a schema could not be created due to a naming conflict. Please select a different name and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SchemaAlreadyPublishedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a schema is already published.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SchemaFacet":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions.

" - }, - "FacetName":{ - "shape":"FacetName", - "documentation":"

The name of the facet.

" - } - }, - "documentation":"

A facet.

" - }, - "SchemaFacetList":{ - "type":"list", - "member":{"shape":"SchemaFacet"} - }, - "SchemaJsonDocument":{"type":"string"}, - "SchemaName":{ - "type":"string", - "max":32, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "SelectorObjectReference":{"type":"string"}, - "StillContainsLinksException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The object could not be deleted because links still exist. Remove the links and then try the operation again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "StringAttributeValue":{"type":"string"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key that is associated with the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value that is associated with the tag.

" - } - }, - "documentation":"

The tag structure that contains a tag key and value.

" - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag key-value pairs.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{"type":"string"}, - "TagsNumberResults":{ - "type":"integer", - "min":50 - }, - "TypedAttributeValue":{ - "type":"structure", - "members":{ - "StringValue":{ - "shape":"StringAttributeValue", - "documentation":"

A string data value.

" - }, - "BinaryValue":{ - "shape":"BinaryAttributeValue", - "documentation":"

A binary data value.

" - }, - "BooleanValue":{ - "shape":"BooleanAttributeValue", - "documentation":"

A Boolean data value.

" - }, - "NumberValue":{ - "shape":"NumberAttributeValue", - "documentation":"

A number data value.

" - }, - "DatetimeValue":{ - "shape":"DatetimeAttributeValue", - "documentation":"

A date and time value.

" - } - }, - "documentation":"

Represents the data for a typed attribute. You can set one, and only one, of the elements. Each attribute in an item is a name-value pair. Attributes have a single value.

" - }, - "TypedAttributeValueRange":{ - "type":"structure", - "required":[ - "StartMode", - "EndMode" - ], - "members":{ - "StartMode":{ - "shape":"RangeMode", - "documentation":"

The inclusive or exclusive range start.

" - }, - "StartValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value to start the range at.

" - }, - "EndMode":{ - "shape":"RangeMode", - "documentation":"

The inclusive or exclusive range end.

" - }, - "EndValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The attribute value to terminate the range at.

" - } - }, - "documentation":"

A range of attribute values. For more information, see Range Filters.

" - }, - "TypedLinkAttributeDefinition":{ - "type":"structure", - "required":[ - "Name", - "Type", - "RequiredBehavior" - ], - "members":{ - "Name":{ - "shape":"AttributeName", - "documentation":"

The unique name of the typed link attribute.

" - }, - "Type":{ - "shape":"FacetAttributeType", - "documentation":"

The type of the attribute.

" - }, - "DefaultValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The default value of the attribute (if configured).

" - }, - "IsImmutable":{ - "shape":"Bool", - "documentation":"

Whether the attribute is mutable or not.

" - }, - "Rules":{ - "shape":"RuleMap", - "documentation":"

Validation rules that are attached to the attribute definition.

" - }, - "RequiredBehavior":{ - "shape":"RequiredAttributeBehavior", - "documentation":"

The required behavior of the TypedLinkAttributeDefinition.

" - } - }, - "documentation":"

A typed link attribute definition.

" - }, - "TypedLinkAttributeDefinitionList":{ - "type":"list", - "member":{"shape":"TypedLinkAttributeDefinition"} - }, - "TypedLinkAttributeRange":{ - "type":"structure", - "required":["Range"], - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The unique name of the typed link attribute.

" - }, - "Range":{ - "shape":"TypedAttributeValueRange", - "documentation":"

The range of attribute values that are being selected.

" - } - }, - "documentation":"

Identifies the range of attributes that are used by a specified filter.

" - }, - "TypedLinkAttributeRangeList":{ - "type":"list", - "member":{"shape":"TypedLinkAttributeRange"} - }, - "TypedLinkFacet":{ - "type":"structure", - "required":[ - "Name", - "Attributes", - "IdentityAttributeOrder" - ], - "members":{ - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "Attributes":{ - "shape":"TypedLinkAttributeDefinitionList", - "documentation":"

A set of key-value pairs associated with the typed link. Typed link attributes are used when you have data values that are related to the link itself, and not to one of the two objects being linked. Identity attributes also serve to distinguish the link from others of the same type between the same objects.

" - }, - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The set of attributes that distinguish links made from this facet from each other, in the order of significance. Listing typed links can filter on the values of these attributes. See ListOutgoingTypedLinks and ListIncomingTypedLinks for details.

" - } - }, - "documentation":"

Defines the typed links structure and its attributes. To create a typed link facet, use the CreateTypedLinkFacet API.

" - }, - "TypedLinkFacetAttributeUpdate":{ - "type":"structure", - "required":[ - "Attribute", - "Action" - ], - "members":{ - "Attribute":{ - "shape":"TypedLinkAttributeDefinition", - "documentation":"

The attribute to update.

" - }, - "Action":{ - "shape":"UpdateActionType", - "documentation":"

The action to perform when updating the attribute.

" - } - }, - "documentation":"

A typed link facet attribute update.

" - }, - "TypedLinkFacetAttributeUpdateList":{ - "type":"list", - "member":{"shape":"TypedLinkFacetAttributeUpdate"} - }, - "TypedLinkName":{ - "type":"string", - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "TypedLinkNameList":{ - "type":"list", - "member":{"shape":"TypedLinkName"} - }, - "TypedLinkSchemaAndFacetName":{ - "type":"structure", - "required":[ - "SchemaArn", - "TypedLinkName" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

" - }, - "TypedLinkName":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - }, - "documentation":"

Identifies the schema Amazon Resource Name (ARN) and facet name for the typed link.

" - }, - "TypedLinkSpecifier":{ - "type":"structure", - "required":[ - "TypedLinkFacet", - "SourceObjectReference", - "TargetObjectReference", - "IdentityAttributeValues" - ], - "members":{ - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "IdentityAttributeValues":{ - "shape":"AttributeNameAndValueList", - "documentation":"

Identifies the attribute value to update.

" - } - }, - "documentation":"

Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.

" - }, - "TypedLinkSpecifierList":{ - "type":"list", - "member":{"shape":"TypedLinkSpecifier"} - }, - "UnsupportedIndexTypeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested index type is not supported.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

Keys of the tag that need to be removed from the resource.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateActionType":{ - "type":"string", - "enum":[ - "CREATE_OR_UPDATE", - "DELETE" - ] - }, - "UpdateFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet.

" - }, - "AttributeUpdates":{ - "shape":"FacetAttributeUpdateList", - "documentation":"

List of attributes that need to be updated in a given schema Facet. Each attribute is followed by AttributeAction, which specifies the type of update operation to perform.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.

" - } - } - }, - "UpdateFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateLinkAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier", - "AttributeUpdates" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the updated typed link resides. For more information, see arns or Typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeUpdates":{ - "shape":"LinkAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - } - }, - "UpdateLinkAttributesResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference", - "AttributeUpdates" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object.

" - }, - "AttributeUpdates":{ - "shape":"ObjectAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - } - }, - "UpdateObjectAttributesResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the updated object.

" - } - } - }, - "UpdateSchemaRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"SchemaName", - "documentation":"

The name of the schema.

" - } - } - }, - "UpdateSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the updated schema. For more information, see arns.

" - } - } - }, - "UpdateTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name", - "AttributeUpdates", - "IdentityAttributeOrder" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "AttributeUpdates":{ - "shape":"TypedLinkFacetAttributeUpdateList", - "documentation":"

Attributes update structure.

" - }, - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to a typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed link.

" - } - } - }, - "UpdateTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "UpgradeAppliedSchemaRequest":{ - "type":"structure", - "required":[ - "PublishedSchemaArn", - "DirectoryArn" - ], - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The revision of the published schema to upgrade the directory to.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN for the directory to which the upgraded schema will be applied.

" - }, - "DryRun":{ - "shape":"Bool", - "documentation":"

Used for testing whether the major version schemas are backward compatible or not. If schema compatibility fails, an exception would be thrown else the call would succeed but no changes will be saved. This parameter is optional.

" - } - } - }, - "UpgradeAppliedSchemaResponse":{ - "type":"structure", - "members":{ - "UpgradedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the upgraded schema that is returned as part of the response.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that is returned as part of the response.

" - } - } - }, - "UpgradePublishedSchemaRequest":{ - "type":"structure", - "required":[ - "DevelopmentSchemaArn", - "PublishedSchemaArn", - "MinorVersion" - ], - "members":{ - "DevelopmentSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the development schema with the changes used for the upgrade.

" - }, - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the published schema to be upgraded.

" - }, - "MinorVersion":{ - "shape":"Version", - "documentation":"

Identifies the minor version of the published schema that will be created. This parameter is NOT optional.

" - }, - "DryRun":{ - "shape":"Bool", - "documentation":"

Used for testing whether the Development schema provided is backwards compatible, or not, with the publish schema provided by the user to be upgraded. If schema compatibility fails, an exception would be thrown else the call would succeed. This parameter is optional and defaults to false.

" - } - } - }, - "UpgradePublishedSchemaResponse":{ - "type":"structure", - "members":{ - "UpgradedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the upgraded schema that is returned as part of the response.

" - } - } - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that your request is malformed in some manner. See the exception message.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Version":{ - "type":"string", - "max":10, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - } - }, - "documentation":"Amazon Cloud Directory

Amazon Cloud Directory is a component of the AWS Directory Service that simplifies the development and management of cloud-scale web, mobile, and IoT applications. This guide describes the Cloud Directory operations that you can call programmatically and includes detailed information on data types and errors. For information about AWS Directory Services features, see AWS Directory Service and the AWS Directory Service Administration Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/paginators-1.json deleted file mode 100644 index 22cc439e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/paginators-1.json +++ /dev/null @@ -1,100 +0,0 @@ -{ - "pagination": { - "ListObjectParentPaths": { - "result_key": "PathToObjectIdentifiersList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListFacetNames": { - "result_key": "FacetNames", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListPublishedSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListDirectories": { - "result_key": "Directories", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListDevelopmentSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTypedLinkFacetNames": { - "result_key": "FacetNames", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListIndex": { - "result_key": "IndexAttachments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListFacetAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListObjectPolicies": { - "result_key": "AttachedPolicyIds", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTagsForResource": { - "result_key": "Tags", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListAttachedIndices": { - "result_key": "IndexAttachments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "LookupPolicy": { - "result_key": "PolicyToPathList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListPolicyAttachments": { - "result_key": "ObjectIdentifiers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListObjectAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListAppliedSchemaArns": { - "result_key": "SchemaArns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTypedLinkFacetAttributes": { - "result_key": "Attributes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/service-2.json deleted file mode 100644 index e9d5ee69..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/clouddirectory/2017-01-11/service-2.json +++ /dev/null @@ -1,5991 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-01-11", - "endpointPrefix":"clouddirectory", - "protocol":"rest-json", - "serviceFullName":"Amazon CloudDirectory", - "serviceId":"CloudDirectory", - "signatureVersion":"v4", - "signingName":"clouddirectory", - "uid":"clouddirectory-2017-01-11" - }, - "operations":{ - "AddFacetToObject":{ - "name":"AddFacetToObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/facets", - "responseCode":200 - }, - "input":{"shape":"AddFacetToObjectRequest"}, - "output":{"shape":"AddFacetToObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Adds a new Facet to an object. An object can have more than one facet applied on it.

" - }, - "ApplySchema":{ - "name":"ApplySchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/apply", - "responseCode":200 - }, - "input":{"shape":"ApplySchemaRequest"}, - "output":{"shape":"ApplySchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"SchemaAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"} - ], - "documentation":"

Copies the input published schema, at the specified version, into the Directory with the same name and version as that of the published schema.

" - }, - "AttachObject":{ - "name":"AttachObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attach", - "responseCode":200 - }, - "input":{"shape":"AttachObjectRequest"}, - "output":{"shape":"AttachObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ValidationException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Attaches an existing object to another object. An object can be accessed in two ways:

  1. Using the path

  2. Using ObjectIdentifier

" - }, - "AttachPolicy":{ - "name":"AttachPolicy", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/attach", - "responseCode":200 - }, - "input":{"shape":"AttachPolicyRequest"}, - "output":{"shape":"AttachPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "AttachToIndex":{ - "name":"AttachToIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index/attach", - "responseCode":200 - }, - "input":{"shape":"AttachToIndexRequest"}, - "output":{"shape":"AttachToIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"IndexedAttributeMissingException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Attaches the specified object to the specified index.

" - }, - "AttachTypedLink":{ - "name":"AttachTypedLink", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attach", - "responseCode":200 - }, - "input":{"shape":"AttachTypedLinkRequest"}, - "output":{"shape":"AttachTypedLinkResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"ValidationException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "BatchRead":{ - "name":"BatchRead", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/batchread", - "responseCode":200 - }, - "input":{"shape":"BatchReadRequest"}, - "output":{"shape":"BatchReadResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"} - ], - "documentation":"

Performs all the read operations in a batch.

" - }, - "BatchWrite":{ - "name":"BatchWrite", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/batchwrite", - "responseCode":200 - }, - "input":{"shape":"BatchWriteRequest"}, - "output":{"shape":"BatchWriteResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"BatchWriteException"} - ], - "documentation":"

Performs all the write operations in a batch. Either all the operations succeed or none.

" - }, - "CreateDirectory":{ - "name":"CreateDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/create", - "responseCode":200 - }, - "input":{"shape":"CreateDirectoryRequest"}, - "output":{"shape":"CreateDirectoryResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a Directory by copying the published schema into the directory. A directory cannot be created without a schema.

" - }, - "CreateFacet":{ - "name":"CreateFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/create", - "responseCode":200 - }, - "input":{"shape":"CreateFacetRequest"}, - "output":{"shape":"CreateFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetAlreadyExistsException"}, - {"shape":"InvalidRuleException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Creates a new Facet in a schema. Facet creation is allowed only in development or applied schemas.

" - }, - "CreateIndex":{ - "name":"CreateIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index", - "responseCode":200 - }, - "input":{"shape":"CreateIndexRequest"}, - "output":{"shape":"CreateIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"UnsupportedIndexTypeException"} - ], - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "CreateObject":{ - "name":"CreateObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object", - "responseCode":200 - }, - "input":{"shape":"CreateObjectRequest"}, - "output":{"shape":"CreateObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"UnsupportedIndexTypeException"} - ], - "documentation":"

Creates an object in a Directory. Additionally attaches the object to a parent, if a parent reference and LinkName is specified. An object is simply a collection of Facet attributes. You can also use this API call to create a policy object, if the facet from which you create the object is a policy facet.

" - }, - "CreateSchema":{ - "name":"CreateSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/create", - "responseCode":200 - }, - "input":{"shape":"CreateSchemaRequest"}, - "output":{"shape":"CreateSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"SchemaAlreadyExistsException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Creates a new schema in a development state. A schema can exist in three phases:

  • Development: This is a mutable phase of the schema. All new schemas are in the development phase. Once the schema is finalized, it can be published.

  • Published: Published schemas are immutable and have a version associated with them.

  • Applied: Applied schemas are mutable in a way that allows you to add new schema facets. You can also add new, nonrequired attributes to existing schema facets. You can apply only published schemas to directories.

" - }, - "CreateTypedLinkFacet":{ - "name":"CreateTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/create", - "responseCode":200 - }, - "input":{"shape":"CreateTypedLinkFacetRequest"}, - "output":{"shape":"CreateTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetAlreadyExistsException"}, - {"shape":"InvalidRuleException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Creates a TypedLinkFacet. For more information, see Typed link.

" - }, - "DeleteDirectory":{ - "name":"DeleteDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory", - "responseCode":200 - }, - "input":{"shape":"DeleteDirectoryRequest"}, - "output":{"shape":"DeleteDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryNotDisabledException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Deletes a directory. Only disabled directories can be deleted. A deleted directory cannot be undone. Exercise extreme caution when deleting directories.

" - }, - "DeleteFacet":{ - "name":"DeleteFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteFacetRequest"}, - "output":{"shape":"DeleteFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"FacetInUseException"} - ], - "documentation":"

Deletes a given Facet. All attributes and Rules that are associated with the facet will be deleted. Only development schema facets are allowed deletion.

" - }, - "DeleteObject":{ - "name":"DeleteObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteObjectRequest"}, - "output":{"shape":"DeleteObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ObjectNotDetachedException"} - ], - "documentation":"

Deletes an object and its associated attributes. Only objects with no children and no parents can be deleted.

" - }, - "DeleteSchema":{ - "name":"DeleteSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema", - "responseCode":200 - }, - "input":{"shape":"DeleteSchemaRequest"}, - "output":{"shape":"DeleteSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"StillContainsLinksException"} - ], - "documentation":"

Deletes a given schema. Schemas in a development and published state can only be deleted.

" - }, - "DeleteTypedLinkFacet":{ - "name":"DeleteTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/delete", - "responseCode":200 - }, - "input":{"shape":"DeleteTypedLinkFacetRequest"}, - "output":{"shape":"DeleteTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Deletes a TypedLinkFacet. For more information, see Typed link.

" - }, - "DetachFromIndex":{ - "name":"DetachFromIndex", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/index/detach", - "responseCode":200 - }, - "input":{"shape":"DetachFromIndexRequest"}, - "output":{"shape":"DetachFromIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ObjectAlreadyDetachedException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Detaches the specified object from the specified index.

" - }, - "DetachObject":{ - "name":"DetachObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/detach", - "responseCode":200 - }, - "input":{"shape":"DetachObjectRequest"}, - "output":{"shape":"DetachObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotNodeException"} - ], - "documentation":"

Detaches a given object from the parent object. The object that is to be detached from the parent is specified by the link name.

" - }, - "DetachPolicy":{ - "name":"DetachPolicy", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/detach", - "responseCode":200 - }, - "input":{"shape":"DetachPolicyRequest"}, - "output":{"shape":"DetachPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Detaches a policy from an object.

" - }, - "DetachTypedLink":{ - "name":"DetachTypedLink", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/detach", - "responseCode":200 - }, - "input":{"shape":"DetachTypedLinkRequest"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "DisableDirectory":{ - "name":"DisableDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/disable", - "responseCode":200 - }, - "input":{"shape":"DisableDirectoryRequest"}, - "output":{"shape":"DisableDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Disables the specified directory. Disabled directories cannot be read or written to. Only enabled directories can be disabled. Disabled directories may be reenabled.

" - }, - "EnableDirectory":{ - "name":"EnableDirectory", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/enable", - "responseCode":200 - }, - "input":{"shape":"EnableDirectoryRequest"}, - "output":{"shape":"EnableDirectoryResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DirectoryDeletedException"}, - {"shape":"InternalServiceException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"RetryableConflictException"}, - {"shape":"InvalidArnException"} - ], - "documentation":"

Enables the specified directory. Only disabled directories can be enabled. Once enabled, the directory can then be read and written to.

" - }, - "GetAppliedSchemaVersion":{ - "name":"GetAppliedSchemaVersion", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/getappliedschema", - "responseCode":200 - }, - "input":{"shape":"GetAppliedSchemaVersionRequest"}, - "output":{"shape":"GetAppliedSchemaVersionResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns current applied schema version ARN, including the minor version in use.

" - }, - "GetDirectory":{ - "name":"GetDirectory", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/get", - "responseCode":200 - }, - "input":{"shape":"GetDirectoryRequest"}, - "output":{"shape":"GetDirectoryResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Retrieves metadata about a directory.

" - }, - "GetFacet":{ - "name":"GetFacet", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet", - "responseCode":200 - }, - "input":{"shape":"GetFacetRequest"}, - "output":{"shape":"GetFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Gets details of the Facet, such as facet name, attributes, Rules, or ObjectType. You can call this on all kinds of schema facets -- published, development, or applied.

" - }, - "GetLinkAttributes":{ - "name":"GetLinkAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attributes/get", - "responseCode":200 - }, - "input":{"shape":"GetLinkAttributesRequest"}, - "output":{"shape":"GetLinkAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Retrieves attributes that are associated with a typed link.

" - }, - "GetObjectAttributes":{ - "name":"GetObjectAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attributes/get", - "responseCode":200 - }, - "input":{"shape":"GetObjectAttributesRequest"}, - "output":{"shape":"GetObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "GetObjectInformation":{ - "name":"GetObjectInformation", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/information", - "responseCode":200 - }, - "input":{"shape":"GetObjectInformationRequest"}, - "output":{"shape":"GetObjectInformationResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves metadata about an object.

" - }, - "GetSchemaAsJson":{ - "name":"GetSchemaAsJson", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/json", - "responseCode":200 - }, - "input":{"shape":"GetSchemaAsJsonRequest"}, - "output":{"shape":"GetSchemaAsJsonResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Retrieves a JSON representation of the schema. See JSON Schema Format for more information.

" - }, - "GetTypedLinkFacetInformation":{ - "name":"GetTypedLinkFacetInformation", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/get", - "responseCode":200 - }, - "input":{"shape":"GetTypedLinkFacetInformationRequest"}, - "output":{"shape":"GetTypedLinkFacetInformationResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetNotFoundException"} - ], - "documentation":"

Returns the identity attribute order for a specific TypedLinkFacet. For more information, see Typed link.

" - }, - "ListAppliedSchemaArns":{ - "name":"ListAppliedSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/applied", - "responseCode":200 - }, - "input":{"shape":"ListAppliedSchemaArnsRequest"}, - "output":{"shape":"ListAppliedSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists schema major versions applied to a directory. If SchemaArn is provided, lists the minor version.

" - }, - "ListAttachedIndices":{ - "name":"ListAttachedIndices", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/indices", - "responseCode":200 - }, - "input":{"shape":"ListAttachedIndicesRequest"}, - "output":{"shape":"ListAttachedIndicesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists indices attached to the specified object.

" - }, - "ListDevelopmentSchemaArns":{ - "name":"ListDevelopmentSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/development", - "responseCode":200 - }, - "input":{"shape":"ListDevelopmentSchemaArnsRequest"}, - "output":{"shape":"ListDevelopmentSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves each Amazon Resource Name (ARN) of schemas in the development state.

" - }, - "ListDirectories":{ - "name":"ListDirectories", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/directory/list", - "responseCode":200 - }, - "input":{"shape":"ListDirectoriesRequest"}, - "output":{"shape":"ListDirectoriesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists directories created within an account.

" - }, - "ListFacetAttributes":{ - "name":"ListFacetAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/attributes", - "responseCode":200 - }, - "input":{"shape":"ListFacetAttributesRequest"}, - "output":{"shape":"ListFacetAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves attributes attached to the facet.

" - }, - "ListFacetNames":{ - "name":"ListFacetNames", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/facet/list", - "responseCode":200 - }, - "input":{"shape":"ListFacetNamesRequest"}, - "output":{"shape":"ListFacetNamesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Retrieves the names of facets that exist in a schema.

" - }, - "ListIncomingTypedLinks":{ - "name":"ListIncomingTypedLinks", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/incoming", - "responseCode":200 - }, - "input":{"shape":"ListIncomingTypedLinksRequest"}, - "output":{"shape":"ListIncomingTypedLinksResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIndex":{ - "name":"ListIndex", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/index/targets", - "responseCode":200 - }, - "input":{"shape":"ListIndexRequest"}, - "output":{"shape":"ListIndexResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"FacetValidationException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotIndexException"} - ], - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListManagedSchemaArns":{ - "name":"ListManagedSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/managed", - "responseCode":200 - }, - "input":{"shape":"ListManagedSchemaArnsRequest"}, - "output":{"shape":"ListManagedSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"ValidationException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the major version families of each managed schema. If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.

" - }, - "ListObjectAttributes":{ - "name":"ListObjectAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/attributes", - "responseCode":200 - }, - "input":{"shape":"ListObjectAttributesRequest"}, - "output":{"shape":"ListObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "name":"ListObjectChildren", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/children", - "responseCode":200 - }, - "input":{"shape":"ListObjectChildrenRequest"}, - "output":{"shape":"ListObjectChildrenResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NotNodeException"} - ], - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "ListObjectParentPaths":{ - "name":"ListObjectParentPaths", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/parentpaths", - "responseCode":200 - }, - "input":{"shape":"ListObjectParentPathsRequest"}, - "output":{"shape":"ListObjectParentPathsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

Use this API to evaluate all parents for an object. The call returns all objects from the root of the directory up to the requested object. The API returns the number of paths based on user-defined MaxResults, in case there are multiple paths to the parent. The order of the paths and nodes returned is consistent among multiple API calls unless the objects are deleted or moved. Paths not leading to the directory root are ignored from the target object.

" - }, - "ListObjectParents":{ - "name":"ListObjectParents", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/parent", - "responseCode":200 - }, - "input":{"shape":"ListObjectParentsRequest"}, - "output":{"shape":"ListObjectParentsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"CannotListParentOfRootException"} - ], - "documentation":"

Lists parent objects that are associated with a given object in pagination fashion.

" - }, - "ListObjectPolicies":{ - "name":"ListObjectPolicies", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/object/policy", - "responseCode":200 - }, - "input":{"shape":"ListObjectPoliciesRequest"}, - "output":{"shape":"ListObjectPoliciesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListOutgoingTypedLinks":{ - "name":"ListOutgoingTypedLinks", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/outgoing", - "responseCode":200 - }, - "input":{"shape":"ListOutgoingTypedLinksRequest"}, - "output":{"shape":"ListOutgoingTypedLinksResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListPolicyAttachments":{ - "name":"ListPolicyAttachments", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/attachment", - "responseCode":200 - }, - "input":{"shape":"ListPolicyAttachmentsRequest"}, - "output":{"shape":"ListPolicyAttachmentsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotPolicyException"} - ], - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "ListPublishedSchemaArns":{ - "name":"ListPublishedSchemaArns", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/published", - "responseCode":200 - }, - "input":{"shape":"ListPublishedSchemaArnsRequest"}, - "output":{"shape":"ListPublishedSchemaArnsResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the major version families of each published schema. If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/tags", - "responseCode":200 - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

Returns tags for a resource. Tagging is currently supported only for directories with a limit of 50 tags per directory. All 50 tags are returned for a given directory with this API call.

" - }, - "ListTypedLinkFacetAttributes":{ - "name":"ListTypedLinkFacetAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/attributes", - "responseCode":200 - }, - "input":{"shape":"ListTypedLinkFacetAttributesRequest"}, - "output":{"shape":"ListTypedLinkFacetAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns a paginated list of all attribute definitions for a particular TypedLinkFacet. For more information, see Typed link.

" - }, - "ListTypedLinkFacetNames":{ - "name":"ListTypedLinkFacetNames", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet/list", - "responseCode":200 - }, - "input":{"shape":"ListTypedLinkFacetNamesRequest"}, - "output":{"shape":"ListTypedLinkFacetNamesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns a paginated list of TypedLink facet names for a particular schema. For more information, see Typed link.

" - }, - "LookupPolicy":{ - "name":"LookupPolicy", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/policy/lookup", - "responseCode":200 - }, - "input":{"shape":"LookupPolicyRequest"}, - "output":{"shape":"LookupPolicyResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "PublishSchema":{ - "name":"PublishSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/publish", - "responseCode":200 - }, - "input":{"shape":"PublishSchemaRequest"}, - "output":{"shape":"PublishSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"SchemaAlreadyPublishedException"} - ], - "documentation":"

Publishes a development schema with a major version and a recommended minor version.

" - }, - "PutSchemaFromJson":{ - "name":"PutSchemaFromJson", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/json", - "responseCode":200 - }, - "input":{"shape":"PutSchemaFromJsonRequest"}, - "output":{"shape":"PutSchemaFromJsonResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidSchemaDocException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Allows a schema to be updated using JSON upload. Only available for development schemas. See JSON Schema Format for more information.

" - }, - "RemoveFacetFromObject":{ - "name":"RemoveFacetFromObject", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/facets/delete", - "responseCode":200 - }, - "input":{"shape":"RemoveFacetFromObjectRequest"}, - "output":{"shape":"RemoveFacetFromObjectResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Removes the specified facet from the specified object.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/tags/add", - "responseCode":200 - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

An API operation for adding tags to a resource.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/tags/remove", - "responseCode":200 - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidTaggingRequestException"} - ], - "documentation":"

An API operation for removing tags from a resource.

" - }, - "UpdateFacet":{ - "name":"UpdateFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/facet", - "responseCode":200 - }, - "input":{"shape":"UpdateFacetRequest"}, - "output":{"shape":"UpdateFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidFacetUpdateException"}, - {"shape":"FacetValidationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Does the following:

  1. Adds new Attributes, Rules, or ObjectTypes.

  2. Updates existing Attributes, Rules, or ObjectTypes.

  3. Deletes existing Attributes, Rules, or ObjectTypes.

" - }, - "UpdateLinkAttributes":{ - "name":"UpdateLinkAttributes", - "http":{ - "method":"POST", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/attributes/update", - "responseCode":200 - }, - "input":{"shape":"UpdateLinkAttributesRequest"}, - "output":{"shape":"UpdateLinkAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Updates a given typed link’s attributes. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder.

" - }, - "UpdateObjectAttributes":{ - "name":"UpdateObjectAttributes", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/object/update", - "responseCode":200 - }, - "input":{"shape":"UpdateObjectAttributesRequest"}, - "output":{"shape":"UpdateObjectAttributesResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"DirectoryNotEnabledException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LinkNameAlreadyInUseException"}, - {"shape":"FacetValidationException"} - ], - "documentation":"

Updates a given object's attributes.

" - }, - "UpdateSchema":{ - "name":"UpdateSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/update", - "responseCode":200 - }, - "input":{"shape":"UpdateSchemaRequest"}, - "output":{"shape":"UpdateSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the schema name with a new name. Only development schema names can be updated.

" - }, - "UpdateTypedLinkFacet":{ - "name":"UpdateTypedLinkFacet", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/typedlink/facet", - "responseCode":200 - }, - "input":{"shape":"UpdateTypedLinkFacetRequest"}, - "output":{"shape":"UpdateTypedLinkFacetResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"FacetValidationException"}, - {"shape":"InvalidFacetUpdateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"FacetNotFoundException"}, - {"shape":"InvalidRuleException"} - ], - "documentation":"

Updates a TypedLinkFacet. For more information, see Typed link.

" - }, - "UpgradeAppliedSchema":{ - "name":"UpgradeAppliedSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/upgradeapplied", - "responseCode":200 - }, - "input":{"shape":"UpgradeAppliedSchemaRequest"}, - "output":{"shape":"UpgradeAppliedSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"IncompatibleSchemaException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"SchemaAlreadyExistsException"} - ], - "documentation":"

Upgrades a single directory in-place using the PublishedSchemaArn with schema updates found in MinorVersion. Backwards-compatible minor version upgrades are instantaneously available for readers on all objects in the directory. Note: This is a synchronous API call and upgrades only one schema on a given directory per call. To upgrade multiple directories from one schema, you would need to call this API on each directory.

" - }, - "UpgradePublishedSchema":{ - "name":"UpgradePublishedSchema", - "http":{ - "method":"PUT", - "requestUri":"/amazonclouddirectory/2017-01-11/schema/upgradepublished", - "responseCode":200 - }, - "input":{"shape":"UpgradePublishedSchemaRequest"}, - "output":{"shape":"UpgradePublishedSchemaResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidArnException"}, - {"shape":"RetryableConflictException"}, - {"shape":"ValidationException"}, - {"shape":"IncompatibleSchemaException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidAttachmentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Upgrades a published schema under a new minor version revision using the current contents of DevelopmentSchemaArn.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Access denied. Check your permissions.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "AddFacetToObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifiers for the facet that you are adding to the object. See SchemaFacet for details.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

Attributes on the facet that you are adding to the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object you are adding the specified facet to.

" - } - } - }, - "AddFacetToObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "ApplySchemaRequest":{ - "type":"structure", - "required":[ - "PublishedSchemaArn", - "DirectoryArn" - ], - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

Published schema Amazon Resource Name (ARN) that needs to be copied. For more information, see arns.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory into which the schema is copied. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "ApplySchemaResponse":{ - "type":"structure", - "members":{ - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

The applied schema ARN that is associated with the copied schema in the Directory. You can use this ARN to describe the schema information applied on this directory. For more information, see arns.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the Directory. For more information, see arns.

" - } - } - }, - "Arn":{"type":"string"}, - "Arns":{ - "type":"list", - "member":{"shape":"Arn"} - }, - "AttachObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ParentReference", - "ChildReference", - "LinkName" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent object reference.

" - }, - "ChildReference":{ - "shape":"ObjectReference", - "documentation":"

The child object reference to be attached to the object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The link name with which the child object is attached to the parent.

" - } - } - }, - "AttachObjectResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The attached ObjectIdentifier, which is the child ObjectIdentifier.

" - } - } - }, - "AttachPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that is associated with the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object to which the policy will be attached.

" - } - } - }, - "AttachPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "AttachToIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where the object and index exist.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index that you are attaching the object to.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that you are attaching to the index.

" - } - } - }, - "AttachToIndexResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was attached to the index.

" - } - } - }, - "AttachTypedLinkRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SourceObjectReference", - "TargetObjectReference", - "TypedLinkFacet", - "Attributes" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to attach the typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "Attributes":{ - "shape":"AttributeNameAndValueList", - "documentation":"

A set of attributes that are associated with the typed link.

" - } - } - }, - "AttachTypedLinkResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Returns a typed link specifier as output.

" - } - } - }, - "AttributeKey":{ - "type":"structure", - "required":[ - "SchemaArn", - "FacetName", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the schema that contains the facet and attribute.

" - }, - "FacetName":{ - "shape":"FacetName", - "documentation":"

The name of the facet that the attribute exists within.

" - }, - "Name":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - } - }, - "documentation":"

A unique identifier for an attribute.

" - }, - "AttributeKeyAndValue":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute.

" - }, - "Value":{ - "shape":"TypedAttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

The combination of an attribute key and an attribute value.

" - }, - "AttributeKeyAndValueList":{ - "type":"list", - "member":{"shape":"AttributeKeyAndValue"} - }, - "AttributeKeyList":{ - "type":"list", - "member":{"shape":"AttributeKey"} - }, - "AttributeName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "AttributeNameAndValue":{ - "type":"structure", - "required":[ - "AttributeName", - "Value" - ], - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The attribute name of the typed link.

" - }, - "Value":{ - "shape":"TypedAttributeValue", - "documentation":"

The value for the typed link.

" - } - }, - "documentation":"

Identifies the attribute name and value for a typed link.

" - }, - "AttributeNameAndValueList":{ - "type":"list", - "member":{"shape":"AttributeNameAndValue"} - }, - "AttributeNameList":{ - "type":"list", - "member":{"shape":"AttributeName"} - }, - "BatchAddFacetToObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectAttributeList", - "ObjectReference" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Represents the facet being added to the object.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes to set on the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being mutated.

" - } - }, - "documentation":"

Represents the output of a batch add facet to object operation.

" - }, - "BatchAddFacetToObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a batch add facet to object operation.

" - }, - "BatchAttachObject":{ - "type":"structure", - "required":[ - "ParentReference", - "ChildReference", - "LinkName" - ], - "members":{ - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent object reference.

" - }, - "ChildReference":{ - "shape":"ObjectReference", - "documentation":"

The child object reference that is to be attached to the object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - } - }, - "documentation":"

Represents the output of an AttachObject operation.

" - }, - "BatchAttachObjectResponse":{ - "type":"structure", - "members":{ - "attachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that has been attached.

" - } - }, - "documentation":"

Represents the output batch AttachObject response operation.

" - }, - "BatchAttachPolicy":{ - "type":"structure", - "required":[ - "PolicyReference", - "ObjectReference" - ], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that is associated with the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object to which the policy will be attached.

" - } - }, - "documentation":"

Attaches a policy object to a regular object inside a BatchRead operation. For more information, see AttachPolicy and BatchReadRequest$Operations.

" - }, - "BatchAttachPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of an AttachPolicy response operation.

" - }, - "BatchAttachToIndex":{ - "type":"structure", - "required":[ - "IndexReference", - "TargetReference" - ], - "members":{ - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index that you are attaching the object to.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that you are attaching to the index.

" - } - }, - "documentation":"

Attaches the specified object to the specified index inside a BatchRead operation. For more information, see AttachToIndex and BatchReadRequest$Operations.

" - }, - "BatchAttachToIndexResponse":{ - "type":"structure", - "members":{ - "AttachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was attached to the index.

" - } - }, - "documentation":"

Represents the output of a AttachToIndex response operation.

" - }, - "BatchAttachTypedLink":{ - "type":"structure", - "required":[ - "SourceObjectReference", - "TargetObjectReference", - "TypedLinkFacet", - "Attributes" - ], - "members":{ - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "Attributes":{ - "shape":"AttributeNameAndValueList", - "documentation":"

A set of attributes that are associated with the typed link.

" - } - }, - "documentation":"

Attaches a typed link to a specified source and target object inside a BatchRead operation. For more information, see AttachTypedLink and BatchReadRequest$Operations.

" - }, - "BatchAttachTypedLinkResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Returns a typed link specifier as output.

" - } - }, - "documentation":"

Represents the output of a AttachTypedLink response operation.

" - }, - "BatchCreateIndex":{ - "type":"structure", - "required":[ - "OrderedIndexedAttributeList", - "IsUnique" - ], - "members":{ - "OrderedIndexedAttributeList":{ - "shape":"AttributeKeyList", - "documentation":"

Specifies the attributes that should be indexed on. Currently only a single attribute is supported.

" - }, - "IsUnique":{ - "shape":"Bool", - "documentation":"

Indicates whether the attribute that is being indexed has unique values or not.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the parent object that contains the index object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link between the parent object and the index object.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Creates an index object inside of a BatchRead operation. For more information, see CreateIndex and BatchReadRequest$Operations.

" - }, - "BatchCreateIndexResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the index created by this operation.

" - } - }, - "documentation":"

Represents the output of a CreateIndex response operation.

" - }, - "BatchCreateObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectAttributeList" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacetList", - "documentation":"

A list of FacetArns that will be associated with the object. For more information, see arns.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

An attribute map, which contains an attribute ARN as the key and attribute value as the map value.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

If specified, the parent reference to which this object will be attached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Represents the output of a CreateObject operation.

" - }, - "BatchCreateObjectResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ID that is associated with the object.

" - } - }, - "documentation":"

Represents the output of a CreateObject response operation.

" - }, - "BatchDeleteObject":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object.

" - } - }, - "documentation":"

Represents the output of a DeleteObject operation.

" - }, - "BatchDeleteObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DeleteObject response operation.

" - }, - "BatchDetachFromIndex":{ - "type":"structure", - "required":[ - "IndexReference", - "TargetReference" - ], - "members":{ - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index object.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being detached from the index.

" - } - }, - "documentation":"

Detaches the specified object from the specified index inside a BatchRead operation. For more information, see DetachFromIndex and BatchReadRequest$Operations.

" - }, - "BatchDetachFromIndexResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was detached from the index.

" - } - }, - "documentation":"

Represents the output of a DetachFromIndex response operation.

" - }, - "BatchDetachObject":{ - "type":"structure", - "required":[ - "ParentReference", - "LinkName" - ], - "members":{ - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

Parent reference from which the object with the specified link name is detached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link.

" - }, - "BatchReferenceName":{ - "shape":"BatchReferenceName", - "documentation":"

The batch reference name. See Batches for more information.

" - } - }, - "documentation":"

Represents the output of a DetachObject operation.

" - }, - "BatchDetachObjectResponse":{ - "type":"structure", - "members":{ - "detachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the detached object.

" - } - }, - "documentation":"

Represents the output of a DetachObject response operation.

" - }, - "BatchDetachPolicy":{ - "type":"structure", - "required":[ - "PolicyReference", - "ObjectReference" - ], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policy object will be detached.

" - } - }, - "documentation":"

Detaches the specified policy from the specified directory inside a BatchWrite operation. For more information, see DetachPolicy and BatchWriteRequest$Operations.

" - }, - "BatchDetachPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DetachPolicy response operation.

" - }, - "BatchDetachTypedLink":{ - "type":"structure", - "required":["TypedLinkSpecifier"], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Used to accept a typed link specifier as input.

" - } - }, - "documentation":"

Detaches a typed link from a specified source and target object inside a BatchRead operation. For more information, see DetachTypedLink and BatchReadRequest$Operations.

" - }, - "BatchDetachTypedLinkResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a DetachTypedLink response operation.

" - }, - "BatchGetLinkAttributes":{ - "type":"structure", - "required":[ - "TypedLinkSpecifier", - "AttributeNames" - ], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attribute names whose values will be retrieved.

" - } - }, - "documentation":"

Retrieves attributes that are associated with a typed link inside a BatchRead operation. For more information, see GetLinkAttributes and BatchReadRequest$Operations.

" - }, - "BatchGetLinkAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the typed link.

" - } - }, - "documentation":"

Represents the output of a GetLinkAttributes response operation.

" - }, - "BatchGetObjectAttributes":{ - "type":"structure", - "required":[ - "ObjectReference", - "SchemaFacet", - "AttributeNames" - ], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be retrieved.

" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

List of attribute names whose values will be retrieved.

" - } - }, - "documentation":"

Retrieves attributes within a facet that are associated with an object inside an BatchRead operation. For more information, see GetObjectAttributes and BatchReadRequest$Operations.

" - }, - "BatchGetObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attribute values that are associated with an object.

" - } - }, - "documentation":"

Represents the output of a GetObjectAttributes response operation.

" - }, - "BatchGetObjectInformation":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object.

" - } - }, - "documentation":"

Retrieves metadata about an object inside a BatchRead operation. For more information, see GetObjectInformation and BatchReadRequest$Operations.

" - }, - "BatchGetObjectInformationResponse":{ - "type":"structure", - "members":{ - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

The facets attached to the specified object.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the specified object.

" - } - }, - "documentation":"

Represents the output of a GetObjectInformation response operation.

" - }, - "BatchListAttachedIndices":{ - "type":"structure", - "required":["TargetReference"], - "members":{ - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that has indices attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Lists indices attached to an object inside a BatchRead operation. For more information, see ListAttachedIndices and BatchReadRequest$Operations.

" - }, - "BatchListAttachedIndicesResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The indices attached to the specified object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListAttachedIndices response operation.

" - }, - "BatchListIncomingTypedLinks":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object inside a BatchRead operation. For more information, see ListIncomingTypedLinks and BatchReadRequest$Operations.

" - }, - "BatchListIncomingTypedLinksResponse":{ - "type":"structure", - "members":{ - "LinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns one or more typed link specifiers as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListIncomingTypedLinks response operation.

" - }, - "BatchListIndex":{ - "type":"structure", - "required":["IndexReference"], - "members":{ - "RangesOnIndexedValues":{ - "shape":"ObjectAttributeRangeList", - "documentation":"

Specifies the ranges of indexed values that you want to query.

" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

The reference to the index to list.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Lists objects attached to the specified index inside a BatchRead operation. For more information, see ListIndex and BatchReadRequest$Operations.

" - }, - "BatchListIndexResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The objects and indexed values attached to the index.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListIndex response operation.

" - }, - "BatchListObjectAttributes":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference of the object whose attributes need to be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "FacetFilter":{ - "shape":"SchemaFacet", - "documentation":"

Used to filter the list of object attributes that are associated with a certain facet.

" - } - }, - "documentation":"

Represents the output of a ListObjectAttributes operation.

" - }, - "BatchListObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes map that is associated with the object. AttributeArn is the key; attribute value is the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectAttributes response operation.

" - }, - "BatchListObjectChildren":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference of the object for which child objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

Maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - }, - "documentation":"

Represents the output of a ListObjectChildren operation.

" - }, - "BatchListObjectChildrenResponse":{ - "type":"structure", - "members":{ - "Children":{ - "shape":"LinkNameToObjectIdentifierMap", - "documentation":"

The children structure, which is a map with the key as the LinkName and ObjectIdentifier as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectChildren response operation.

" - }, - "BatchListObjectParentPaths":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects inside a BatchRead operation. For more information, see ListObjectParentPaths and BatchReadRequest$Operations.

" - }, - "BatchListObjectParentPathsResponse":{ - "type":"structure", - "members":{ - "PathToObjectIdentifiersList":{ - "shape":"PathToObjectIdentifiersList", - "documentation":"

Returns the path to the ObjectIdentifiers that are associated with the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectParentPaths response operation.

" - }, - "BatchListObjectPolicies":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns policies attached to an object in pagination fashion inside a BatchRead operation. For more information, see ListObjectPolicies and BatchReadRequest$Operations.

" - }, - "BatchListObjectPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicyIds":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of policy ObjectIdentifiers, that are attached to the object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListObjectPolicies response operation.

" - }, - "BatchListOutgoingTypedLinks":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object inside a BatchRead operation. For more information, see ListOutgoingTypedLinks and BatchReadRequest$Operations.

" - }, - "BatchListOutgoingTypedLinksResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns a typed link specifier as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListOutgoingTypedLinks response operation.

" - }, - "BatchListPolicyAttachments":{ - "type":"structure", - "required":["PolicyReference"], - "members":{ - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the policy object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached inside a BatchRead operation. For more information, see ListPolicyAttachments and BatchReadRequest$Operations.

" - }, - "BatchListPolicyAttachmentsResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of ObjectIdentifiers to which the policy is attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a ListPolicyAttachments response operation.

" - }, - "BatchLookupPolicy":{ - "type":"structure", - "required":["ObjectReference"], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policies will be looked up.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - }, - "documentation":"

Lists all policies from the root of the Directory to the object specified inside a BatchRead operation. For more information, see LookupPolicy and BatchReadRequest$Operations.

" - }, - "BatchLookupPolicyResponse":{ - "type":"structure", - "members":{ - "PolicyToPathList":{ - "shape":"PolicyToPathList", - "documentation":"

Provides list of path to policies. Policies contain PolicyId, ObjectIdentifier, and PolicyType. For more information, see Policies.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the output of a LookupPolicy response operation.

" - }, - "BatchOperationIndex":{"type":"integer"}, - "BatchReadException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"BatchReadExceptionType", - "documentation":"

A type of exception, such as InvalidArnException.

" - }, - "Message":{ - "shape":"ExceptionMessage", - "documentation":"

An exception message that is associated with the failure.

" - } - }, - "documentation":"

The batch read exception structure, which contains the exception type and message.

" - }, - "BatchReadExceptionType":{ - "type":"string", - "enum":[ - "ValidationException", - "InvalidArnException", - "ResourceNotFoundException", - "InvalidNextTokenException", - "AccessDeniedException", - "NotNodeException", - "FacetValidationException", - "CannotListParentOfRootException", - "NotIndexException", - "NotPolicyException", - "DirectoryNotEnabledException", - "LimitExceededException", - "InternalServiceException" - ] - }, - "BatchReadOperation":{ - "type":"structure", - "members":{ - "ListObjectAttributes":{ - "shape":"BatchListObjectAttributes", - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "shape":"BatchListObjectChildren", - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "ListAttachedIndices":{ - "shape":"BatchListAttachedIndices", - "documentation":"

Lists indices attached to an object.

" - }, - "ListObjectParentPaths":{ - "shape":"BatchListObjectParentPaths", - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

" - }, - "GetObjectInformation":{ - "shape":"BatchGetObjectInformation", - "documentation":"

Retrieves metadata about an object.

" - }, - "GetObjectAttributes":{ - "shape":"BatchGetObjectAttributes", - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "ListObjectPolicies":{ - "shape":"BatchListObjectPolicies", - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListPolicyAttachments":{ - "shape":"BatchListPolicyAttachments", - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "LookupPolicy":{ - "shape":"BatchLookupPolicy", - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "ListIndex":{ - "shape":"BatchListIndex", - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListOutgoingTypedLinks":{ - "shape":"BatchListOutgoingTypedLinks", - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIncomingTypedLinks":{ - "shape":"BatchListIncomingTypedLinks", - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "GetLinkAttributes":{ - "shape":"BatchGetLinkAttributes", - "documentation":"

Retrieves attributes that are associated with a typed link.

" - } - }, - "documentation":"

Represents the output of a BatchRead operation.

" - }, - "BatchReadOperationList":{ - "type":"list", - "member":{"shape":"BatchReadOperation"} - }, - "BatchReadOperationResponse":{ - "type":"structure", - "members":{ - "SuccessfulResponse":{ - "shape":"BatchReadSuccessfulResponse", - "documentation":"

Identifies which operation in a batch has succeeded.

" - }, - "ExceptionResponse":{ - "shape":"BatchReadException", - "documentation":"

Identifies which operation in a batch has failed.

" - } - }, - "documentation":"

Represents the output of a BatchRead response operation.

" - }, - "BatchReadOperationResponseList":{ - "type":"list", - "member":{"shape":"BatchReadOperationResponse"} - }, - "BatchReadRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Operations" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Operations":{ - "shape":"BatchReadOperationList", - "documentation":"

A list of operations that are part of the batch.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "BatchReadResponse":{ - "type":"structure", - "members":{ - "Responses":{ - "shape":"BatchReadOperationResponseList", - "documentation":"

A list of all the responses for each batch read.

" - } - } - }, - "BatchReadSuccessfulResponse":{ - "type":"structure", - "members":{ - "ListObjectAttributes":{ - "shape":"BatchListObjectAttributesResponse", - "documentation":"

Lists all attributes that are associated with an object.

" - }, - "ListObjectChildren":{ - "shape":"BatchListObjectChildrenResponse", - "documentation":"

Returns a paginated list of child objects that are associated with a given object.

" - }, - "GetObjectInformation":{ - "shape":"BatchGetObjectInformationResponse", - "documentation":"

Retrieves metadata about an object.

" - }, - "GetObjectAttributes":{ - "shape":"BatchGetObjectAttributesResponse", - "documentation":"

Retrieves attributes within a facet that are associated with an object.

" - }, - "ListAttachedIndices":{ - "shape":"BatchListAttachedIndicesResponse", - "documentation":"

Lists indices attached to an object.

" - }, - "ListObjectParentPaths":{ - "shape":"BatchListObjectParentPathsResponse", - "documentation":"

Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects. For more information about objects, see Directory Structure.

" - }, - "ListObjectPolicies":{ - "shape":"BatchListObjectPoliciesResponse", - "documentation":"

Returns policies attached to an object in pagination fashion.

" - }, - "ListPolicyAttachments":{ - "shape":"BatchListPolicyAttachmentsResponse", - "documentation":"

Returns all of the ObjectIdentifiers to which a given policy is attached.

" - }, - "LookupPolicy":{ - "shape":"BatchLookupPolicyResponse", - "documentation":"

Lists all policies from the root of the Directory to the object specified. If there are no policies present, an empty list is returned. If policies are present, and if some objects don't have the policies attached, it returns the ObjectIdentifier for such objects. If policies are present, it returns ObjectIdentifier, policyId, and policyType. Paths that don't lead to the root from the target object are ignored. For more information, see Policies.

" - }, - "ListIndex":{ - "shape":"BatchListIndexResponse", - "documentation":"

Lists objects attached to the specified index.

" - }, - "ListOutgoingTypedLinks":{ - "shape":"BatchListOutgoingTypedLinksResponse", - "documentation":"

Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "ListIncomingTypedLinks":{ - "shape":"BatchListIncomingTypedLinksResponse", - "documentation":"

Returns a paginated list of all the incoming TypedLinkSpecifier information for an object. It also supports filtering by typed link facet and identity attributes. For more information, see Typed link.

" - }, - "GetLinkAttributes":{ - "shape":"BatchGetLinkAttributesResponse", - "documentation":"

The list of attributes to retrieve from the typed link.

" - } - }, - "documentation":"

Represents the output of a BatchRead success response operation.

" - }, - "BatchReferenceName":{"type":"string"}, - "BatchRemoveFacetFromObject":{ - "type":"structure", - "required":[ - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

The facet to remove from the object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object whose facet will be removed.

" - } - }, - "documentation":"

A batch operation to remove a facet from an object.

" - }, - "BatchRemoveFacetFromObjectResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty result that represents success.

" - }, - "BatchUpdateLinkAttributes":{ - "type":"structure", - "required":[ - "TypedLinkSpecifier", - "AttributeUpdates" - ], - "members":{ - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeUpdates":{ - "shape":"LinkAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - }, - "documentation":"

Updates a given typed link’s attributes inside a BatchRead operation. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder. For more information, see UpdateLinkAttributes and BatchReadRequest$Operations.

" - }, - "BatchUpdateLinkAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the output of a UpdateLinkAttributes response operation.

" - }, - "BatchUpdateObjectAttributes":{ - "type":"structure", - "required":[ - "ObjectReference", - "AttributeUpdates" - ], - "members":{ - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object.

" - }, - "AttributeUpdates":{ - "shape":"ObjectAttributeUpdateList", - "documentation":"

Attributes update structure.

" - } - }, - "documentation":"

Represents the output of a BatchUpdate operation.

" - }, - "BatchUpdateObjectAttributesResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

ID that is associated with the object.

" - } - }, - "documentation":"

Represents the output of a BatchUpdate response operation.

" - }, - "BatchWriteException":{ - "type":"structure", - "members":{ - "Index":{"shape":"BatchOperationIndex"}, - "Type":{"shape":"BatchWriteExceptionType"}, - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A BatchWrite exception has occurred.

", - "exception":true - }, - "BatchWriteExceptionType":{ - "type":"string", - "enum":[ - "InternalServiceException", - "ValidationException", - "InvalidArnException", - "LinkNameAlreadyInUseException", - "StillContainsLinksException", - "FacetValidationException", - "ObjectNotDetachedException", - "ResourceNotFoundException", - "AccessDeniedException", - "InvalidAttachmentException", - "NotIndexException", - "NotNodeException", - "IndexedAttributeMissingException", - "ObjectAlreadyDetachedException", - "NotPolicyException", - "DirectoryNotEnabledException", - "LimitExceededException", - "UnsupportedIndexTypeException" - ] - }, - "BatchWriteOperation":{ - "type":"structure", - "members":{ - "CreateObject":{ - "shape":"BatchCreateObject", - "documentation":"

Creates an object.

" - }, - "AttachObject":{ - "shape":"BatchAttachObject", - "documentation":"

Attaches an object to a Directory.

" - }, - "DetachObject":{ - "shape":"BatchDetachObject", - "documentation":"

Detaches an object from a Directory.

" - }, - "UpdateObjectAttributes":{ - "shape":"BatchUpdateObjectAttributes", - "documentation":"

Updates a given object's attributes.

" - }, - "DeleteObject":{ - "shape":"BatchDeleteObject", - "documentation":"

Deletes an object in a Directory.

" - }, - "AddFacetToObject":{ - "shape":"BatchAddFacetToObject", - "documentation":"

A batch operation that adds a facet to an object.

" - }, - "RemoveFacetFromObject":{ - "shape":"BatchRemoveFacetFromObject", - "documentation":"

A batch operation that removes a facet from an object.

" - }, - "AttachPolicy":{ - "shape":"BatchAttachPolicy", - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "DetachPolicy":{ - "shape":"BatchDetachPolicy", - "documentation":"

Detaches a policy from a Directory.

" - }, - "CreateIndex":{ - "shape":"BatchCreateIndex", - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "AttachToIndex":{ - "shape":"BatchAttachToIndex", - "documentation":"

Attaches the specified object to the specified index.

" - }, - "DetachFromIndex":{ - "shape":"BatchDetachFromIndex", - "documentation":"

Detaches the specified object from the specified index.

" - }, - "AttachTypedLink":{ - "shape":"BatchAttachTypedLink", - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "DetachTypedLink":{ - "shape":"BatchDetachTypedLink", - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "UpdateLinkAttributes":{ - "shape":"BatchUpdateLinkAttributes", - "documentation":"

Updates a given object's attributes.

" - } - }, - "documentation":"

Represents the output of a BatchWrite operation.

" - }, - "BatchWriteOperationList":{ - "type":"list", - "member":{"shape":"BatchWriteOperation"} - }, - "BatchWriteOperationResponse":{ - "type":"structure", - "members":{ - "CreateObject":{ - "shape":"BatchCreateObjectResponse", - "documentation":"

Creates an object in a Directory.

" - }, - "AttachObject":{ - "shape":"BatchAttachObjectResponse", - "documentation":"

Attaches an object to a Directory.

" - }, - "DetachObject":{ - "shape":"BatchDetachObjectResponse", - "documentation":"

Detaches an object from a Directory.

" - }, - "UpdateObjectAttributes":{ - "shape":"BatchUpdateObjectAttributesResponse", - "documentation":"

Updates a given object’s attributes.

" - }, - "DeleteObject":{ - "shape":"BatchDeleteObjectResponse", - "documentation":"

Deletes an object in a Directory.

" - }, - "AddFacetToObject":{ - "shape":"BatchAddFacetToObjectResponse", - "documentation":"

The result of an add facet to object batch operation.

" - }, - "RemoveFacetFromObject":{ - "shape":"BatchRemoveFacetFromObjectResponse", - "documentation":"

The result of a batch remove facet from object operation.

" - }, - "AttachPolicy":{ - "shape":"BatchAttachPolicyResponse", - "documentation":"

Attaches a policy object to a regular object. An object can have a limited number of attached policies.

" - }, - "DetachPolicy":{ - "shape":"BatchDetachPolicyResponse", - "documentation":"

Detaches a policy from a Directory.

" - }, - "CreateIndex":{ - "shape":"BatchCreateIndexResponse", - "documentation":"

Creates an index object. See Indexing for more information.

" - }, - "AttachToIndex":{ - "shape":"BatchAttachToIndexResponse", - "documentation":"

Attaches the specified object to the specified index.

" - }, - "DetachFromIndex":{ - "shape":"BatchDetachFromIndexResponse", - "documentation":"

Detaches the specified object from the specified index.

" - }, - "AttachTypedLink":{ - "shape":"BatchAttachTypedLinkResponse", - "documentation":"

Attaches a typed link to a specified source and target object. For more information, see Typed link.

" - }, - "DetachTypedLink":{ - "shape":"BatchDetachTypedLinkResponse", - "documentation":"

Detaches a typed link from a specified source and target object. For more information, see Typed link.

" - }, - "UpdateLinkAttributes":{ - "shape":"BatchUpdateLinkAttributesResponse", - "documentation":"

Represents the output of a BatchWrite response operation.

" - } - }, - "documentation":"

Represents the output of a BatchWrite response operation.

" - }, - "BatchWriteOperationResponseList":{ - "type":"list", - "member":{"shape":"BatchWriteOperationResponse"} - }, - "BatchWriteRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Operations" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Operations":{ - "shape":"BatchWriteOperationList", - "documentation":"

A list of operations that are part of the batch.

" - } - } - }, - "BatchWriteResponse":{ - "type":"structure", - "members":{ - "Responses":{ - "shape":"BatchWriteOperationResponseList", - "documentation":"

A list of all the responses for each batch write.

" - } - } - }, - "BinaryAttributeValue":{"type":"blob"}, - "Bool":{"type":"boolean"}, - "BooleanAttributeValue":{"type":"boolean"}, - "CannotListParentOfRootException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Cannot list the parents of a Directory root.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ConsistencyLevel":{ - "type":"string", - "enum":[ - "SERIALIZABLE", - "EVENTUAL" - ] - }, - "CreateDirectoryRequest":{ - "type":"structure", - "required":[ - "Name", - "SchemaArn" - ], - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the Directory. Should be unique per account, per region.

" - }, - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the published schema that will be copied into the data Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "CreateDirectoryResponse":{ - "type":"structure", - "required":[ - "DirectoryArn", - "Name", - "ObjectIdentifier", - "AppliedSchemaArn" - ], - "members":{ - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The ARN that is associated with the Directory. For more information, see arns.

" - }, - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the Directory.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The root object node of the created directory.

" - }, - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the published schema in the Directory. Once a published schema is copied into the directory, it has its own ARN, which is referred to applied schema ARN. For more information, see arns.

" - } - } - }, - "CreateFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The schema ARN in which the new Facet will be created. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the Facet, which is unique for a given schema.

" - }, - "Attributes":{ - "shape":"FacetAttributeList", - "documentation":"

The attributes that are associated with the Facet.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

Specifies whether a given object created from this facet is of type node, leaf node, policy or index.

  • Node: Can have multiple children but one parent.

  • Leaf node: Cannot have children but can have multiple parents.

  • Policy: Allows you to store a policy document and policy type. For more information, see Policies.

  • Index: Can be created with the Index API.

" - }, - "FacetStyle":{ - "shape":"FacetStyle", - "documentation":"

There are two different styles that you can define on any given facet, Static and Dynamic. For static facets, all attributes must be defined in the schema. For dynamic facets, attributes can be defined during data plane operations.

" - } - } - }, - "CreateFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "OrderedIndexedAttributeList", - "IsUnique" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory where the index should be created.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "OrderedIndexedAttributeList":{ - "shape":"AttributeKeyList", - "documentation":"

Specifies the attributes that should be indexed on. Currently only a single attribute is supported.

" - }, - "IsUnique":{ - "shape":"Bool", - "documentation":"

Indicates whether the attribute that is being indexed has unique values or not.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the parent object that contains the index object.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of the link between the parent object and the index object.

" - } - } - }, - "CreateIndexResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the index created by this operation.

" - } - } - }, - "CreateObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacets" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory in which the object will be created. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

A list of schema facets to be associated with the object. Do not provide minor version components. See SchemaFacet for details.

" - }, - "ObjectAttributeList":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attribute map whose attribute ARN contains the key and attribute value as the map value.

" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

If specified, the parent reference to which this object will be attached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The name of link that is used to attach this object to a parent.

" - } - } - }, - "CreateObjectResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The identifier that is associated with the object.

" - } - } - }, - "CreateSchemaRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"SchemaName", - "documentation":"

The name that is associated with the schema. This is unique to each account and in each region.

" - } - } - }, - "CreateSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

" - } - } - }, - "CreateTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Facet" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Facet":{ - "shape":"TypedLinkFacet", - "documentation":"

Facet structure that is associated with the typed link facet.

" - } - } - }, - "CreateTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "Date":{"type":"timestamp"}, - "DatetimeAttributeValue":{"type":"timestamp"}, - "DeleteDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to delete.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DeleteDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the deleted directory.

" - } - } - }, - "DeleteFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet to delete.

" - } - } - }, - "DeleteFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference that identifies the object.

" - } - } - }, - "DeleteObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteSchemaRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DeleteSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The input ARN that is returned as part of the response. For more information, see arns.

" - } - } - }, - "DeleteTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - } - }, - "DeleteTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "DetachFromIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory the index and object exist in.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the index object.

" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object being detached from the index.

" - } - } - }, - "DetachFromIndexResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the object that was detached from the index.

" - } - } - }, - "DetachObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ParentReference", - "LinkName" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ParentReference":{ - "shape":"ObjectReference", - "documentation":"

The parent reference from which the object with the specified link name is detached.

" - }, - "LinkName":{ - "shape":"LinkName", - "documentation":"

The link name associated with the object that needs to be detached.

" - } - } - }, - "DetachObjectResponse":{ - "type":"structure", - "members":{ - "DetachedObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier that was detached from the object.

" - } - } - }, - "DetachPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where both objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the policy object.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policy object will be detached.

" - } - } - }, - "DetachPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "DetachTypedLinkRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to detach the typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Used to accept a typed link specifier as input.

" - } - } - }, - "Directory":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The name of the directory.

" - }, - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the directory. For more information, see arns.

" - }, - "State":{ - "shape":"DirectoryState", - "documentation":"

The state of the directory. Can be either Enabled, Disabled, or Deleted.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the directory was created.

" - } - }, - "documentation":"

Directory structure that includes the directory name and directory ARN.

" - }, - "DirectoryAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a Directory could not be created due to a naming conflict. Choose a different name and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryArn":{"type":"string"}, - "DirectoryDeletedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A directory that has been deleted and to which access has been attempted. Note: The requested resource will eventually cease to exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryList":{ - "type":"list", - "member":{"shape":"Directory"} - }, - "DirectoryName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "DirectoryNotDisabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An operation can only operate on a disabled directory.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryNotEnabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Operations are only permitted on enabled directories.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DirectoryState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED", - "DELETED" - ] - }, - "DisableDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to disable.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "DisableDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that has been disabled.

" - } - } - }, - "EnableDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to enable.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "EnableDirectoryResponse":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the enabled directory.

" - } - } - }, - "ExceptionMessage":{"type":"string"}, - "Facet":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the Facet.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.

" - }, - "FacetStyle":{ - "shape":"FacetStyle", - "documentation":"

There are two different styles that you can define on any given facet, Static and Dynamic. For static facets, all attributes must be defined in the schema. For dynamic facets, attributes can be defined during data plane operations.

" - } - }, - "documentation":"

A structure that contains Name, ARN, Attributes, Rules, and ObjectTypes. See Facets for more information.

" - }, - "FacetAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A facet with the same name already exists.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetAttribute":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"AttributeName", - "documentation":"

The name of the facet attribute.

" - }, - "AttributeDefinition":{ - "shape":"FacetAttributeDefinition", - "documentation":"

A facet attribute consists of either a definition or a reference. This structure contains the attribute definition. See Attribute References for more information.

" - }, - "AttributeReference":{ - "shape":"FacetAttributeReference", - "documentation":"

An attribute reference that is associated with the attribute. See Attribute References for more information.

" - }, - "RequiredBehavior":{ - "shape":"RequiredAttributeBehavior", - "documentation":"

The required behavior of the FacetAttribute.

" - } - }, - "documentation":"

An attribute that is associated with the Facet.

" - }, - "FacetAttributeDefinition":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"FacetAttributeType", - "documentation":"

The type of the attribute.

" - }, - "DefaultValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The default value of the attribute (if configured).

" - }, - "IsImmutable":{ - "shape":"Bool", - "documentation":"

Whether the attribute is mutable or not.

" - }, - "Rules":{ - "shape":"RuleMap", - "documentation":"

Validation rules attached to the attribute definition.

" - } - }, - "documentation":"

A facet attribute definition. See Attribute References for more information.

" - }, - "FacetAttributeList":{ - "type":"list", - "member":{"shape":"FacetAttribute"} - }, - "FacetAttributeReference":{ - "type":"structure", - "required":[ - "TargetFacetName", - "TargetAttributeName" - ], - "members":{ - "TargetFacetName":{ - "shape":"FacetName", - "documentation":"

The target facet name that is associated with the facet reference. See Attribute References for more information.

" - }, - "TargetAttributeName":{ - "shape":"AttributeName", - "documentation":"

The target attribute name that is associated with the facet reference. See Attribute References for more information.

" - } - }, - "documentation":"

The facet attribute reference that specifies the attribute definition that contains the attribute facet name and attribute name.

" - }, - "FacetAttributeType":{ - "type":"string", - "enum":[ - "STRING", - "BINARY", - "BOOLEAN", - "NUMBER", - "DATETIME", - "VARIANT" - ] - }, - "FacetAttributeUpdate":{ - "type":"structure", - "members":{ - "Attribute":{ - "shape":"FacetAttribute", - "documentation":"

The attribute to update.

" - }, - "Action":{ - "shape":"UpdateActionType", - "documentation":"

The action to perform when updating the attribute.

" - } - }, - "documentation":"

A structure that contains information used to update an attribute.

" - }, - "FacetAttributeUpdateList":{ - "type":"list", - "member":{"shape":"FacetAttributeUpdate"} - }, - "FacetInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when deleting a facet that contains an attribute that is a target to an attribute reference in a different facet.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "FacetNameList":{ - "type":"list", - "member":{"shape":"FacetName"} - }, - "FacetNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified Facet could not be found.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FacetStyle":{ - "type":"string", - "enum":[ - "STATIC", - "DYNAMIC" - ] - }, - "FacetValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The Facet that you provided was not well formed or could not be validated with the schema.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "GetAppliedSchemaVersionRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the applied schema.

" - } - } - }, - "GetAppliedSchemaVersionResponse":{ - "type":"structure", - "members":{ - "AppliedSchemaArn":{ - "shape":"Arn", - "documentation":"

Current applied schema ARN, including the minor version in use if one was provided.

" - } - } - }, - "GetDirectoryRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"DirectoryArn", - "documentation":"

The ARN of the directory.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "GetDirectoryResponse":{ - "type":"structure", - "required":["Directory"], - "members":{ - "Directory":{ - "shape":"Directory", - "documentation":"

Metadata about the directory.

" - } - } - }, - "GetFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet to retrieve.

" - } - } - }, - "GetFacetResponse":{ - "type":"structure", - "members":{ - "Facet":{ - "shape":"Facet", - "documentation":"

The Facet structure that is associated with the facet.

" - } - } - }, - "GetLinkAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier", - "AttributeNames" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the typed link resides. For more information, see arns or Typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attribute names whose values will be retrieved.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the attributes on a typed link.

" - } - } - }, - "GetLinkAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the typed link.

" - } - } - }, - "GetObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference", - "SchemaFacet", - "AttributeNames" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be retrieved.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the attributes on an object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

Identifier for the facet whose attributes will be retrieved. See SchemaFacet for details.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

List of attribute names whose values will be retrieved.

" - } - } - }, - "GetObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The attributes that are associated with the object.

" - } - } - }, - "GetObjectInformationRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory being retrieved.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level at which to retrieve the object information.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "GetObjectInformationResponse":{ - "type":"structure", - "members":{ - "SchemaFacets":{ - "shape":"SchemaFacetList", - "documentation":"

The facets attached to the specified object. Although the response does not include minor version information, the most recently applied minor version of each Facet is in effect. See GetAppliedSchemaVersion for details.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the specified object.

" - } - } - }, - "GetSchemaAsJsonRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to retrieve.

", - "location":"header", - "locationName":"x-amz-data-partition" - } - } - }, - "GetSchemaAsJsonResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"SchemaName", - "documentation":"

The name of the retrieved schema.

" - }, - "Document":{ - "shape":"SchemaJsonDocument", - "documentation":"

The JSON representation of the schema document.

" - } - } - }, - "GetTypedLinkFacetInformationRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - } - }, - "GetTypedLinkFacetInformationResponse":{ - "type":"structure", - "members":{ - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed link.

" - } - } - }, - "IncompatibleSchemaException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates a failure occurred while performing a check for backward compatibility between the specified schema and the schema that is currently applied to the directory.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "IndexAttachment":{ - "type":"structure", - "members":{ - "IndexedAttributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

The indexed attribute values.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

In response to ListIndex, the ObjectIdentifier of the object attached to the index. In response to ListAttachedIndices, the ObjectIdentifier of the index attached to the object. This field will always contain the ObjectIdentifier of the object on the opposite side of the attachment specified in the query.

" - } - }, - "documentation":"

Represents an index and an attached object.

" - }, - "IndexAttachmentList":{ - "type":"list", - "member":{"shape":"IndexAttachment"} - }, - "IndexedAttributeMissingException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An object has been attempted to be attached to an object that does not have the appropriate attribute value.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates a problem that must be resolved by Amazon Web Services. This might be a transient error in which case you can retry your request until it succeeds. Otherwise, go to the AWS Service Health Dashboard site to see if there are any operational issues with the service.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "InvalidArnException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the provided ARN value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidAttachmentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that an attempt to attach an object with the same link name or to apply a schema with the same name has occurred. Rename the link or the schema and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidFacetUpdateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An attempt to modify a Facet resulted in an invalid schema exception.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the NextToken value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRuleException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when any of the rule parameter keys or values are invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidSchemaDocException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the provided SchemaDoc value is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTaggingRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Can occur for multiple reasons such as when you tag a resource that doesn’t exist or if you specify a higher number of tags for a resource than the allowed limit. Allowed limit is 50 tags per resource.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that limits are exceeded. See Limits for more information.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LinkAttributeAction":{ - "type":"structure", - "members":{ - "AttributeActionType":{ - "shape":"UpdateActionType", - "documentation":"

A type that can be either UPDATE_OR_CREATE or DELETE.

" - }, - "AttributeUpdateValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value that you want to update to.

" - } - }, - "documentation":"

The action to take on a typed link attribute value. Updates are only supported for attributes which don’t contribute to link identity.

" - }, - "LinkAttributeUpdate":{ - "type":"structure", - "members":{ - "AttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute being updated.

" - }, - "AttributeAction":{ - "shape":"LinkAttributeAction", - "documentation":"

The action to perform as part of the attribute update.

" - } - }, - "documentation":"

Structure that contains attribute update information.

" - }, - "LinkAttributeUpdateList":{ - "type":"list", - "member":{"shape":"LinkAttributeUpdate"} - }, - "LinkName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[^\\/\\[\\]\\(\\):\\{\\}#@!?\\s\\\\;]+" - }, - "LinkNameAlreadyInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a link could not be created due to a naming conflict. Choose a different name and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LinkNameToObjectIdentifierMap":{ - "type":"map", - "key":{"shape":"LinkName"}, - "value":{"shape":"ObjectIdentifier"} - }, - "ListAppliedSchemaArnsRequest":{ - "type":"structure", - "required":["DirectoryArn"], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory you are listing.

" - }, - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The response for ListAppliedSchemaArns when this parameter is used will list all minor version ARNs for a major version.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListAppliedSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of schemas that are applied to the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListAttachedIndicesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TargetReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TargetReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object that has indices attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to use for this operation.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListAttachedIndicesResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The indices attached to the specified object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListDevelopmentSchemaArnsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListDevelopmentSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of retrieved development schemas.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListDirectoriesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "state":{ - "shape":"DirectoryState", - "documentation":"

The state of the directories in the list. Can be either Enabled, Disabled, or Deleted.

" - } - } - }, - "ListDirectoriesResponse":{ - "type":"structure", - "required":["Directories"], - "members":{ - "Directories":{ - "shape":"DirectoryList", - "documentation":"

Lists all directories that are associated with your account in pagination fashion.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListFacetAttributesRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema where the facet resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet whose attributes will be retrieved.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListFacetAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"FacetAttributeList", - "documentation":"

The attributes attached to the facet.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListFacetNamesRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) to retrieve facet names from.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListFacetNamesResponse":{ - "type":"structure", - "members":{ - "FacetNames":{ - "shape":"FacetNameList", - "documentation":"

The names of facets that exist within the schema.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListIncomingTypedLinksRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to list the typed links.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

" - } - } - }, - "ListIncomingTypedLinksResponse":{ - "type":"structure", - "members":{ - "LinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns one or more typed link specifiers as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListIndexRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "IndexReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that the index exists in.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "RangesOnIndexedValues":{ - "shape":"ObjectAttributeRangeList", - "documentation":"

Specifies the ranges of indexed values that you want to query.

" - }, - "IndexReference":{ - "shape":"ObjectReference", - "documentation":"

The reference to the index to list.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of objects in a single page to retrieve from the index during a request. For more information, see AWS Directory Service Limits.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListIndexResponse":{ - "type":"structure", - "members":{ - "IndexAttachments":{ - "shape":"IndexAttachmentList", - "documentation":"

The objects and indexed values attached to the index.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListManagedSchemaArnsRequest":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The response for ListManagedSchemaArns. When this parameter is used, all minor version ARNs for a major version are listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListManagedSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs for all AWS managed schemas.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose attributes will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - }, - "FacetFilter":{ - "shape":"SchemaFacet", - "documentation":"

Used to filter the list of object attributes that are associated with a certain facet.

" - } - } - }, - "ListObjectAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeKeyAndValueList", - "documentation":"

Attributes map that is associated with the object. AttributeArn is the key, and attribute value is the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectChildrenRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object for which child objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectChildrenResponse":{ - "type":"structure", - "members":{ - "Children":{ - "shape":"LinkNameToObjectIdentifierMap", - "documentation":"

Children structure, which is a map with key as the LinkName and ObjectIdentifier as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectParentPathsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory to which the parent path applies.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object whose parent paths are listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - } - }, - "ListObjectParentPathsResponse":{ - "type":"structure", - "members":{ - "PathToObjectIdentifiersList":{ - "shape":"PathToObjectIdentifiersList", - "documentation":"

Returns the path to the ObjectIdentifiers that are associated with the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectParentsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object for which parent objects are being listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectParentsResponse":{ - "type":"structure", - "members":{ - "Parents":{ - "shape":"ObjectIdentifierToLinkNameMap", - "documentation":"

The parent structure, which is a map with key as the ObjectIdentifier and LinkName as the value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListObjectPoliciesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object for which policies will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListObjectPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicyIds":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of policy ObjectIdentifiers, that are attached to the object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListOutgoingTypedLinksRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the directory where you want to list the typed links.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference that identifies the object whose attributes will be listed.

" - }, - "FilterAttributeRanges":{ - "shape":"TypedLinkAttributeRangeList", - "documentation":"

Provides range filters for multiple attributes. When providing ranges to typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range.

" - }, - "FilterTypedLink":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Filters are interpreted in the order of the attributes defined on the typed link facet, not the order they are supplied to any API calls.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

The consistency level to execute the request at.

" - } - } - }, - "ListOutgoingTypedLinksResponse":{ - "type":"structure", - "members":{ - "TypedLinkSpecifiers":{ - "shape":"TypedLinkSpecifierList", - "documentation":"

Returns a typed link specifier as output.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListPolicyAttachmentsRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "PolicyReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where objects reside. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "PolicyReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the policy object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - }, - "ConsistencyLevel":{ - "shape":"ConsistencyLevel", - "documentation":"

Represents the manner and timing in which the successful write or update of an object is reflected in a subsequent read operation of that same object.

", - "location":"header", - "locationName":"x-amz-consistency-level" - } - } - }, - "ListPolicyAttachmentsResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

A list of ObjectIdentifiers to which the policy is attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListPublishedSchemaArnsRequest":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The response for ListPublishedSchemaArns when this parameter is used will list all minor version ARNs for a major version.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListPublishedSchemaArnsResponse":{ - "type":"structure", - "members":{ - "SchemaArns":{ - "shape":"Arns", - "documentation":"

The ARNs of published schemas.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token. This is for future use. Currently pagination is not supported for tagging.

" - }, - "MaxResults":{ - "shape":"TagsNumberResults", - "documentation":"

The MaxResults parameter sets the maximum number of results returned in a single page. This is for future use and is not supported currently.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag key value pairs that are associated with the response.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListTypedLinkFacetAttributesRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListTypedLinkFacetAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"TypedLinkAttributeDefinitionList", - "documentation":"

An ordered set of attributes associate with the typed link.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "ListTypedLinkFacetNamesRequest":{ - "type":"structure", - "required":["SchemaArn"], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of results to retrieve.

" - } - } - }, - "ListTypedLinkFacetNamesResponse":{ - "type":"structure", - "members":{ - "FacetNames":{ - "shape":"TypedLinkNameList", - "documentation":"

The names of typed link facets that exist within the schema.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "LookupPolicyRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Reference that identifies the object whose policies will be looked up.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"NumberResults", - "documentation":"

The maximum number of items to be retrieved in a single call. This is an approximate number.

" - } - } - }, - "LookupPolicyResponse":{ - "type":"structure", - "members":{ - "PolicyToPathList":{ - "shape":"PolicyToPathList", - "documentation":"

Provides list of path to policies. Policies contain PolicyId, ObjectIdentifier, and PolicyType. For more information, see Policies.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token.

" - } - } - }, - "NextToken":{"type":"string"}, - "NotIndexException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation can only operate on index objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotNodeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when any invalid operations are performed on an object that is not a node, such as calling ListObjectChildren for a leaf node object.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotPolicyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation can only operate on policy objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NumberAttributeValue":{"type":"string"}, - "NumberResults":{ - "type":"integer", - "min":1 - }, - "ObjectAlreadyDetachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the object is not attached to the index.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ObjectAttributeAction":{ - "type":"structure", - "members":{ - "ObjectAttributeActionType":{ - "shape":"UpdateActionType", - "documentation":"

A type that can be either Update or Delete.

" - }, - "ObjectAttributeUpdateValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value that you want to update to.

" - } - }, - "documentation":"

The action to take on the object attribute.

" - }, - "ObjectAttributeRange":{ - "type":"structure", - "members":{ - "AttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute that the attribute range covers.

" - }, - "Range":{ - "shape":"TypedAttributeValueRange", - "documentation":"

The range of attribute values being selected.

" - } - }, - "documentation":"

A range of attributes.

" - }, - "ObjectAttributeRangeList":{ - "type":"list", - "member":{"shape":"ObjectAttributeRange"} - }, - "ObjectAttributeUpdate":{ - "type":"structure", - "members":{ - "ObjectAttributeKey":{ - "shape":"AttributeKey", - "documentation":"

The key of the attribute being updated.

" - }, - "ObjectAttributeAction":{ - "shape":"ObjectAttributeAction", - "documentation":"

The action to perform as part of the attribute update.

" - } - }, - "documentation":"

Structure that contains attribute update information.

" - }, - "ObjectAttributeUpdateList":{ - "type":"list", - "member":{"shape":"ObjectAttributeUpdate"} - }, - "ObjectIdentifier":{"type":"string"}, - "ObjectIdentifierList":{ - "type":"list", - "member":{"shape":"ObjectIdentifier"} - }, - "ObjectIdentifierToLinkNameMap":{ - "type":"map", - "key":{"shape":"ObjectIdentifier"}, - "value":{"shape":"LinkName"} - }, - "ObjectNotDetachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested operation cannot be completed because the object has not been detached from the tree.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ObjectReference":{ - "type":"structure", - "members":{ - "Selector":{ - "shape":"SelectorObjectReference", - "documentation":"

A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Accessing Objects. You can identify an object in one of the following ways:

  • $ObjectIdentifier - An object identifier is an opaque string provided by Amazon Cloud Directory. When creating objects, the system will provide you with the identifier of the created object. An object’s identifier is immutable and no two objects will ever share the same object identifier

  • /some/path - Identifies the object based on path

  • #SomeBatchReference - Identifies the object in a batch call

" - } - }, - "documentation":"

The reference that identifies an object.

" - }, - "ObjectType":{ - "type":"string", - "enum":[ - "NODE", - "LEAF_NODE", - "POLICY", - "INDEX" - ] - }, - "PathString":{"type":"string"}, - "PathToObjectIdentifiers":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"PathString", - "documentation":"

The path that is used to identify the object starting from directory root.

" - }, - "ObjectIdentifiers":{ - "shape":"ObjectIdentifierList", - "documentation":"

Lists ObjectIdentifiers starting from directory root to the object in the request.

" - } - }, - "documentation":"

Returns the path to the ObjectIdentifiers that is associated with the directory.

" - }, - "PathToObjectIdentifiersList":{ - "type":"list", - "member":{"shape":"PathToObjectIdentifiers"} - }, - "PolicyAttachment":{ - "type":"structure", - "members":{ - "PolicyId":{ - "shape":"ObjectIdentifier", - "documentation":"

The ID of PolicyAttachment.

" - }, - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier that is associated with PolicyAttachment.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The type of policy that can be associated with PolicyAttachment.

" - } - }, - "documentation":"

Contains the PolicyType, PolicyId, and the ObjectIdentifier to which it is attached. For more information, see Policies.

" - }, - "PolicyAttachmentList":{ - "type":"list", - "member":{"shape":"PolicyAttachment"} - }, - "PolicyToPath":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"PathString", - "documentation":"

The path that is referenced from the root.

" - }, - "Policies":{ - "shape":"PolicyAttachmentList", - "documentation":"

List of policy objects.

" - } - }, - "documentation":"

Used when a regular object exists in a Directory and you want to find all of the policies that are associated with that object and the parent to that object.

" - }, - "PolicyToPathList":{ - "type":"list", - "member":{"shape":"PolicyToPath"} - }, - "PolicyType":{"type":"string"}, - "PublishSchemaRequest":{ - "type":"structure", - "required":[ - "DevelopmentSchemaArn", - "Version" - ], - "members":{ - "DevelopmentSchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Version":{ - "shape":"Version", - "documentation":"

The major version under which the schema will be published. Schemas have both a major and minor version associated with them.

" - }, - "MinorVersion":{ - "shape":"Version", - "documentation":"

The minor version under which the schema will be published. This parameter is recommended. Schemas have both a major and minor version associated with them.

" - }, - "Name":{ - "shape":"SchemaName", - "documentation":"

The new name under which the schema will be published. If this is not provided, the development schema is considered.

" - } - } - }, - "PublishSchemaResponse":{ - "type":"structure", - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the published schema. For more information, see arns.

" - } - } - }, - "PutSchemaFromJsonRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Document" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to update.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Document":{ - "shape":"SchemaJsonDocument", - "documentation":"

The replacement JSON schema.

" - } - } - }, - "PutSchemaFromJsonResponse":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema to update.

" - } - } - }, - "RangeMode":{ - "type":"string", - "enum":[ - "FIRST", - "LAST", - "LAST_BEFORE_MISSING_VALUES", - "INCLUSIVE", - "EXCLUSIVE" - ] - }, - "RemoveFacetFromObjectRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "SchemaFacet", - "ObjectReference" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory in which the object resides.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "SchemaFacet":{ - "shape":"SchemaFacet", - "documentation":"

The facet to remove. See SchemaFacet for details.

" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

A reference to the object to remove the facet from.

" - } - } - }, - "RemoveFacetFromObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "RequiredAttributeBehavior":{ - "type":"string", - "enum":[ - "REQUIRED_ALWAYS", - "NOT_REQUIRED" - ] - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified resource could not be found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "RetryableConflictException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Occurs when a conflict with a previous successful write is detected. For example, if a write operation occurs on an object and then an attempt is made to read the object using “SERIALIZABLE” consistency, this exception may result. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "Rule":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"RuleType", - "documentation":"

The type of attribute validation rule.

" - }, - "Parameters":{ - "shape":"RuleParameterMap", - "documentation":"

The minimum and maximum parameters that are associated with the rule.

" - } - }, - "documentation":"

Contains an Amazon Resource Name (ARN) and parameters that are associated with the rule.

" - }, - "RuleKey":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "RuleMap":{ - "type":"map", - "key":{"shape":"RuleKey"}, - "value":{"shape":"Rule"} - }, - "RuleParameterKey":{"type":"string"}, - "RuleParameterMap":{ - "type":"map", - "key":{"shape":"RuleParameterKey"}, - "value":{"shape":"RuleParameterValue"} - }, - "RuleParameterValue":{"type":"string"}, - "RuleType":{ - "type":"string", - "enum":[ - "BINARY_LENGTH", - "NUMBER_COMPARISON", - "STRING_FROM_SET", - "STRING_LENGTH" - ] - }, - "SchemaAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a schema could not be created due to a naming conflict. Please select a different name and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SchemaAlreadyPublishedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that a schema is already published.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SchemaFacet":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions.

" - }, - "FacetName":{ - "shape":"FacetName", - "documentation":"

The name of the facet.

" - } - }, - "documentation":"

A facet.

" - }, - "SchemaFacetList":{ - "type":"list", - "member":{"shape":"SchemaFacet"} - }, - "SchemaJsonDocument":{"type":"string"}, - "SchemaName":{ - "type":"string", - "max":32, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "SelectorObjectReference":{"type":"string"}, - "StillContainsLinksException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The object could not be deleted because links still exist. Remove the links and then try the operation again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "StringAttributeValue":{"type":"string"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key that is associated with the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value that is associated with the tag.

" - } - }, - "documentation":"

The tag structure that contains a tag key and value.

" - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag key-value pairs.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{"type":"string"}, - "TagsNumberResults":{ - "type":"integer", - "min":50 - }, - "TypedAttributeValue":{ - "type":"structure", - "members":{ - "StringValue":{ - "shape":"StringAttributeValue", - "documentation":"

A string data value.

" - }, - "BinaryValue":{ - "shape":"BinaryAttributeValue", - "documentation":"

A binary data value.

" - }, - "BooleanValue":{ - "shape":"BooleanAttributeValue", - "documentation":"

A Boolean data value.

" - }, - "NumberValue":{ - "shape":"NumberAttributeValue", - "documentation":"

A number data value.

" - }, - "DatetimeValue":{ - "shape":"DatetimeAttributeValue", - "documentation":"

A date and time value.

" - } - }, - "documentation":"

Represents the data for a typed attribute. You can set one, and only one, of the elements. Each attribute in an item is a name-value pair. Attributes have a single value.

" - }, - "TypedAttributeValueRange":{ - "type":"structure", - "required":[ - "StartMode", - "EndMode" - ], - "members":{ - "StartMode":{ - "shape":"RangeMode", - "documentation":"

The inclusive or exclusive range start.

" - }, - "StartValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The value to start the range at.

" - }, - "EndMode":{ - "shape":"RangeMode", - "documentation":"

The inclusive or exclusive range end.

" - }, - "EndValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The attribute value to terminate the range at.

" - } - }, - "documentation":"

A range of attribute values. For more information, see Range Filters.

" - }, - "TypedLinkAttributeDefinition":{ - "type":"structure", - "required":[ - "Name", - "Type", - "RequiredBehavior" - ], - "members":{ - "Name":{ - "shape":"AttributeName", - "documentation":"

The unique name of the typed link attribute.

" - }, - "Type":{ - "shape":"FacetAttributeType", - "documentation":"

The type of the attribute.

" - }, - "DefaultValue":{ - "shape":"TypedAttributeValue", - "documentation":"

The default value of the attribute (if configured).

" - }, - "IsImmutable":{ - "shape":"Bool", - "documentation":"

Whether the attribute is mutable or not.

" - }, - "Rules":{ - "shape":"RuleMap", - "documentation":"

Validation rules that are attached to the attribute definition.

" - }, - "RequiredBehavior":{ - "shape":"RequiredAttributeBehavior", - "documentation":"

The required behavior of the TypedLinkAttributeDefinition.

" - } - }, - "documentation":"

A typed link attribute definition.

" - }, - "TypedLinkAttributeDefinitionList":{ - "type":"list", - "member":{"shape":"TypedLinkAttributeDefinition"} - }, - "TypedLinkAttributeRange":{ - "type":"structure", - "required":["Range"], - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The unique name of the typed link attribute.

" - }, - "Range":{ - "shape":"TypedAttributeValueRange", - "documentation":"

The range of attribute values that are being selected.

" - } - }, - "documentation":"

Identifies the range of attributes that are used by a specified filter.

" - }, - "TypedLinkAttributeRangeList":{ - "type":"list", - "member":{"shape":"TypedLinkAttributeRange"} - }, - "TypedLinkFacet":{ - "type":"structure", - "required":[ - "Name", - "Attributes", - "IdentityAttributeOrder" - ], - "members":{ - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "Attributes":{ - "shape":"TypedLinkAttributeDefinitionList", - "documentation":"

A set of key-value pairs associated with the typed link. Typed link attributes are used when you have data values that are related to the link itself, and not to one of the two objects being linked. Identity attributes also serve to distinguish the link from others of the same type between the same objects.

" - }, - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The set of attributes that distinguish links made from this facet from each other, in the order of significance. Listing typed links can filter on the values of these attributes. See ListOutgoingTypedLinks and ListIncomingTypedLinks for details.

" - } - }, - "documentation":"

Defines the typed links structure and its attributes. To create a typed link facet, use the CreateTypedLinkFacet API.

" - }, - "TypedLinkFacetAttributeUpdate":{ - "type":"structure", - "required":[ - "Attribute", - "Action" - ], - "members":{ - "Attribute":{ - "shape":"TypedLinkAttributeDefinition", - "documentation":"

The attribute to update.

" - }, - "Action":{ - "shape":"UpdateActionType", - "documentation":"

The action to perform when updating the attribute.

" - } - }, - "documentation":"

A typed link facet attribute update.

" - }, - "TypedLinkFacetAttributeUpdateList":{ - "type":"list", - "member":{"shape":"TypedLinkFacetAttributeUpdate"} - }, - "TypedLinkName":{ - "type":"string", - "pattern":"^[a-zA-Z0-9._-]*$" - }, - "TypedLinkNameList":{ - "type":"list", - "member":{"shape":"TypedLinkName"} - }, - "TypedLinkSchemaAndFacetName":{ - "type":"structure", - "required":[ - "SchemaArn", - "TypedLinkName" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

" - }, - "TypedLinkName":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - } - }, - "documentation":"

Identifies the schema Amazon Resource Name (ARN) and facet name for the typed link.

" - }, - "TypedLinkSpecifier":{ - "type":"structure", - "required":[ - "TypedLinkFacet", - "SourceObjectReference", - "TargetObjectReference", - "IdentityAttributeValues" - ], - "members":{ - "TypedLinkFacet":{ - "shape":"TypedLinkSchemaAndFacetName", - "documentation":"

Identifies the typed link facet that is associated with the typed link.

" - }, - "SourceObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the source object that the typed link will attach to.

" - }, - "TargetObjectReference":{ - "shape":"ObjectReference", - "documentation":"

Identifies the target object that the typed link will attach to.

" - }, - "IdentityAttributeValues":{ - "shape":"AttributeNameAndValueList", - "documentation":"

Identifies the attribute value to update.

" - } - }, - "documentation":"

Contains all the information that is used to uniquely identify a typed link. The parameters discussed in this topic are used to uniquely specify the typed link being operated on. The AttachTypedLink API returns a typed link specifier while the DetachTypedLink API accepts one as input. Similarly, the ListIncomingTypedLinks and ListOutgoingTypedLinks API operations provide typed link specifiers as output. You can also construct a typed link specifier from scratch.

" - }, - "TypedLinkSpecifierList":{ - "type":"list", - "member":{"shape":"TypedLinkSpecifier"} - }, - "UnsupportedIndexTypeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that the requested index type is not supported.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

Keys of the tag that need to be removed from the resource.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateActionType":{ - "type":"string", - "enum":[ - "CREATE_OR_UPDATE", - "DELETE" - ] - }, - "UpdateFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Facet. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"FacetName", - "documentation":"

The name of the facet.

" - }, - "AttributeUpdates":{ - "shape":"FacetAttributeUpdateList", - "documentation":"

List of attributes that need to be updated in a given schema Facet. Each attribute is followed by AttributeAction, which specifies the type of update operation to perform.

" - }, - "ObjectType":{ - "shape":"ObjectType", - "documentation":"

The object type that is associated with the facet. See CreateFacetRequest$ObjectType for more details.

" - } - } - }, - "UpdateFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateLinkAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "TypedLinkSpecifier", - "AttributeUpdates" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the updated typed link resides. For more information, see arns or Typed link.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "TypedLinkSpecifier":{ - "shape":"TypedLinkSpecifier", - "documentation":"

Allows a typed link specifier to be accepted as input.

" - }, - "AttributeUpdates":{ - "shape":"LinkAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - } - }, - "UpdateLinkAttributesResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateObjectAttributesRequest":{ - "type":"structure", - "required":[ - "DirectoryArn", - "ObjectReference", - "AttributeUpdates" - ], - "members":{ - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the Directory where the object resides. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "ObjectReference":{ - "shape":"ObjectReference", - "documentation":"

The reference that identifies the object.

" - }, - "AttributeUpdates":{ - "shape":"ObjectAttributeUpdateList", - "documentation":"

The attributes update structure.

" - } - } - }, - "UpdateObjectAttributesResponse":{ - "type":"structure", - "members":{ - "ObjectIdentifier":{ - "shape":"ObjectIdentifier", - "documentation":"

The ObjectIdentifier of the updated object.

" - } - } - }, - "UpdateSchemaRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the development schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"SchemaName", - "documentation":"

The name of the schema.

" - } - } - }, - "UpdateSchemaResponse":{ - "type":"structure", - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN that is associated with the updated schema. For more information, see arns.

" - } - } - }, - "UpdateTypedLinkFacetRequest":{ - "type":"structure", - "required":[ - "SchemaArn", - "Name", - "AttributeUpdates", - "IdentityAttributeOrder" - ], - "members":{ - "SchemaArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", - "location":"header", - "locationName":"x-amz-data-partition" - }, - "Name":{ - "shape":"TypedLinkName", - "documentation":"

The unique name of the typed link facet.

" - }, - "AttributeUpdates":{ - "shape":"TypedLinkFacetAttributeUpdateList", - "documentation":"

Attributes update structure.

" - }, - "IdentityAttributeOrder":{ - "shape":"AttributeNameList", - "documentation":"

The order of identity attributes for the facet, from most significant to least significant. The ability to filter typed links considers the order that the attributes are defined on the typed link facet. When providing ranges to a typed link selection, any inexact ranges must be specified at the end. Any attributes that do not have a range specified are presumed to match the entire range. Filters are interpreted in the order of the attributes on the typed link facet, not the order in which they are supplied to any API calls. For more information about identity attributes, see Typed link.

" - } - } - }, - "UpdateTypedLinkFacetResponse":{ - "type":"structure", - "members":{ - } - }, - "UpgradeAppliedSchemaRequest":{ - "type":"structure", - "required":[ - "PublishedSchemaArn", - "DirectoryArn" - ], - "members":{ - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The revision of the published schema to upgrade the directory to.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN for the directory to which the upgraded schema will be applied.

" - }, - "DryRun":{ - "shape":"Bool", - "documentation":"

Used for testing whether the major version schemas are backward compatible or not. If schema compatibility fails, an exception would be thrown else the call would succeed but no changes will be saved. This parameter is optional.

" - } - } - }, - "UpgradeAppliedSchemaResponse":{ - "type":"structure", - "members":{ - "UpgradedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the upgraded schema that is returned as part of the response.

" - }, - "DirectoryArn":{ - "shape":"Arn", - "documentation":"

The ARN of the directory that is returned as part of the response.

" - } - } - }, - "UpgradePublishedSchemaRequest":{ - "type":"structure", - "required":[ - "DevelopmentSchemaArn", - "PublishedSchemaArn", - "MinorVersion" - ], - "members":{ - "DevelopmentSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the development schema with the changes used for the upgrade.

" - }, - "PublishedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the published schema to be upgraded.

" - }, - "MinorVersion":{ - "shape":"Version", - "documentation":"

Identifies the minor version of the published schema that will be created. This parameter is NOT optional.

" - }, - "DryRun":{ - "shape":"Bool", - "documentation":"

Used for testing whether the Development schema provided is backwards compatible, or not, with the publish schema provided by the user to be upgraded. If schema compatibility fails, an exception would be thrown else the call would succeed. This parameter is optional and defaults to false.

" - } - } - }, - "UpgradePublishedSchemaResponse":{ - "type":"structure", - "members":{ - "UpgradedSchemaArn":{ - "shape":"Arn", - "documentation":"

The ARN of the upgraded schema that is returned as part of the response.

" - } - } - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Indicates that your request is malformed in some manner. See the exception message.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Version":{ - "type":"string", - "max":10, - "min":1, - "pattern":"^[a-zA-Z0-9._-]*$" - } - }, - "documentation":"Amazon Cloud Directory

Amazon Cloud Directory is a component of the AWS Directory Service that simplifies the development and management of cloud-scale web, mobile, and IoT applications. This guide describes the Cloud Directory operations that you can call programmatically and includes detailed information on data types and errors. For information about AWS Directory Services features, see AWS Directory Service and the AWS Directory Service Administration Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/examples-1.json deleted file mode 100644 index e7802626..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/examples-1.json +++ /dev/null @@ -1,158 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CancelUpdateStack": [ - { - "input": { - "StackName": "MyStack" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels an update of the specified stack.", - "id": "to-cancel-a-stack-update-that-is-in-progress-1472747085196", - "title": "To cancel a stack update in progress" - } - ], - "UpdateStack": [ - { - "input": { - "NotificationARNs": [ - - ], - "Parameters": [ - { - "ParameterKey": "KeyPairName", - "ParameterValue": "ExampleKeyPair" - }, - { - "ParameterKey": "SubnetIDs", - "ParameterValue": "ExampleSubnetID1, ExampleSubnetID2" - } - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template" - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the template and input parameters for the specified stack.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - }, - { - "input": { - "NotificationARNs": [ - - ], - "Parameters": [ - { - "ParameterKey": "KeyPairName", - "UsePreviousValue": true - }, - { - "ParameterKey": "SubnetIDs", - "ParameterValue": "SampleSubnetID1, UpdatedSampleSubnetID2" - } - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template" - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates only the the specified parameter value for the specified stack. If you don't specify a parameter value, AWS CloudFormation uses the default value from the template.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - }, - { - "input": { - "Capabilities": [ - - ], - "NotificationARNs": [ - "arn:aws:sns:use-east-1:123456789012:mytopic1", - "arn:aws:sns:us-east-1:123456789012:mytopic2" - ], - "Parameters": [ - - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template", - "UsePreviousTemplate": true - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds two stack notification topics to the specified stack.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - } - ], - "ValidateTemplate": [ - { - "input": { - "TemplateBody": "MyTemplate.json" - }, - "output": { - "Capabilities": [ - - ], - "CapabilitiesReason": "", - "Description": "AWS CloudFormation Example Template S3_Bucket: An example template that shows how to create a publicly-accessible S3 bucket. IMPORTANT: This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", - "Parameters": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example validates the specified template.", - "id": "to-validate-an-aws-cloudformation-template-1472839072307", - "title": "To validate an AWS CloudFormation template" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/paginators-1.json deleted file mode 100644 index 8485fd56..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/paginators-1.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "pagination": { - "DescribeStackEvents": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "StackEvents" - }, - "DescribeStacks": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Stacks" - }, - "ListStackResources": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "StackResourceSummaries" - }, - "ListStacks": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "StackSummaries" - }, - "ListExports": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Exports" - }, - "ListImports": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Imports" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/service-2.json deleted file mode 100644 index db15133e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/service-2.json +++ /dev/null @@ -1,3784 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-05-15", - "endpointPrefix":"cloudformation", - "protocol":"query", - "serviceFullName":"AWS CloudFormation", - "serviceId":"CloudFormation", - "signatureVersion":"v4", - "uid":"cloudformation-2010-05-15", - "xmlNamespace":"http://cloudformation.amazonaws.com/doc/2010-05-15/" - }, - "operations":{ - "CancelUpdateStack":{ - "name":"CancelUpdateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelUpdateStackInput"}, - "errors":[ - {"shape":"TokenAlreadyExistsException"} - ], - "documentation":"

Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration.

You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.

" - }, - "ContinueUpdateRollback":{ - "name":"ContinueUpdateRollback", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ContinueUpdateRollbackInput"}, - "output":{ - "shape":"ContinueUpdateRollbackOutput", - "resultWrapper":"ContinueUpdateRollbackResult" - }, - "errors":[ - {"shape":"TokenAlreadyExistsException"} - ], - "documentation":"

For a specified stack that is in the UPDATE_ROLLBACK_FAILED state, continues rolling it back to the UPDATE_ROLLBACK_COMPLETE state. Depending on the cause of the failure, you can manually fix the error and continue the rollback. By continuing the rollback, you can return your stack to a working state (the UPDATE_ROLLBACK_COMPLETE state), and then try to update the stack again.

A stack goes into the UPDATE_ROLLBACK_FAILED state when AWS CloudFormation cannot roll back all changes after a failed stack update. For example, you might have a stack that is rolling back to an old database instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update rollback to fail.

" - }, - "CreateChangeSet":{ - "name":"CreateChangeSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateChangeSetInput"}, - "output":{ - "shape":"CreateChangeSetOutput", - "resultWrapper":"CreateChangeSetResult" - }, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InsufficientCapabilitiesException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a list of changes that will be applied to a stack so that you can review the changes before executing them. You can create a change set for a stack that doesn't exist or an existing stack. If you create a change set for a stack that doesn't exist, the change set shows all of the resources that AWS CloudFormation will create. If you create a change set for an existing stack, AWS CloudFormation compares the stack's information with the information that you submit in the change set and lists the differences. Use change sets to understand which resources AWS CloudFormation will create or change, and how it will change resources in an existing stack, before you create or update a stack.

To create a change set for a stack that doesn't exist, for the ChangeSetType parameter, specify CREATE. To create a change set for an existing stack, specify UPDATE for the ChangeSetType parameter. After the CreateChangeSet call successfully completes, AWS CloudFormation starts creating the change set. To check the status of the change set or to review it, use the DescribeChangeSet action.

When you are satisfied with the changes the change set will make, execute the change set by using the ExecuteChangeSet action. AWS CloudFormation doesn't make changes until you execute the change set.

" - }, - "CreateStack":{ - "name":"CreateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStackInput"}, - "output":{ - "shape":"CreateStackOutput", - "resultWrapper":"CreateStackResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"TokenAlreadyExistsException"}, - {"shape":"InsufficientCapabilitiesException"} - ], - "documentation":"

Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the DescribeStacks API.

" - }, - "CreateStackInstances":{ - "name":"CreateStackInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStackInstancesInput"}, - "output":{ - "shape":"CreateStackInstancesOutput", - "resultWrapper":"CreateStackInstancesResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationInProgressException"}, - {"shape":"OperationIdAlreadyExistsException"}, - {"shape":"StaleRequestException"}, - {"shape":"InvalidOperationException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates stack instances for the specified accounts, within the specified regions. A stack instance refers to a stack in a specific account and region. Accounts and Regions are required parameters—you must specify at least one account and one region.

" - }, - "CreateStackSet":{ - "name":"CreateStackSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStackSetInput"}, - "output":{ - "shape":"CreateStackSetOutput", - "resultWrapper":"CreateStackSetResult" - }, - "errors":[ - {"shape":"NameAlreadyExistsException"}, - {"shape":"CreatedButModifiedException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a stack set.

" - }, - "DeleteChangeSet":{ - "name":"DeleteChangeSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteChangeSetInput"}, - "output":{ - "shape":"DeleteChangeSetOutput", - "resultWrapper":"DeleteChangeSetResult" - }, - "errors":[ - {"shape":"InvalidChangeSetStatusException"} - ], - "documentation":"

Deletes the specified change set. Deleting change sets ensures that no one executes the wrong change set.

If the call successfully completes, AWS CloudFormation successfully deleted the change set.

" - }, - "DeleteStack":{ - "name":"DeleteStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStackInput"}, - "errors":[ - {"shape":"TokenAlreadyExistsException"} - ], - "documentation":"

Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the DescribeStacks API if the deletion has been completed successfully.

" - }, - "DeleteStackInstances":{ - "name":"DeleteStackInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStackInstancesInput"}, - "output":{ - "shape":"DeleteStackInstancesOutput", - "resultWrapper":"DeleteStackInstancesResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationInProgressException"}, - {"shape":"OperationIdAlreadyExistsException"}, - {"shape":"StaleRequestException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Deletes stack instances for the specified accounts, in the specified regions.

" - }, - "DeleteStackSet":{ - "name":"DeleteStackSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStackSetInput"}, - "output":{ - "shape":"DeleteStackSetOutput", - "resultWrapper":"DeleteStackSetResult" - }, - "errors":[ - {"shape":"StackSetNotEmptyException"}, - {"shape":"OperationInProgressException"} - ], - "documentation":"

Deletes a stack set. Before you can delete a stack set, all of its member stack instances must be deleted. For more information about how to do this, see DeleteStackInstances.

" - }, - "DescribeAccountLimits":{ - "name":"DescribeAccountLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountLimitsInput"}, - "output":{ - "shape":"DescribeAccountLimitsOutput", - "resultWrapper":"DescribeAccountLimitsResult" - }, - "documentation":"

Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.

" - }, - "DescribeChangeSet":{ - "name":"DescribeChangeSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeChangeSetInput"}, - "output":{ - "shape":"DescribeChangeSetOutput", - "resultWrapper":"DescribeChangeSetResult" - }, - "errors":[ - {"shape":"ChangeSetNotFoundException"} - ], - "documentation":"

Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the change set. For more information, see Updating Stacks Using Change Sets in the AWS CloudFormation User Guide.

" - }, - "DescribeStackEvents":{ - "name":"DescribeStackEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackEventsInput"}, - "output":{ - "shape":"DescribeStackEventsOutput", - "resultWrapper":"DescribeStackEventsResult" - }, - "documentation":"

Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.

You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).

" - }, - "DescribeStackInstance":{ - "name":"DescribeStackInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackInstanceInput"}, - "output":{ - "shape":"DescribeStackInstanceOutput", - "resultWrapper":"DescribeStackInstanceResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"StackInstanceNotFoundException"} - ], - "documentation":"

Returns the stack instance that's associated with the specified stack set, AWS account, and region.

For a list of stack instances that are associated with a specific stack set, use ListStackInstances.

" - }, - "DescribeStackResource":{ - "name":"DescribeStackResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackResourceInput"}, - "output":{ - "shape":"DescribeStackResourceOutput", - "resultWrapper":"DescribeStackResourceResult" - }, - "documentation":"

Returns a description of the specified resource in the specified stack.

For deleted stacks, DescribeStackResource returns resource information for up to 90 days after the stack has been deleted.

" - }, - "DescribeStackResources":{ - "name":"DescribeStackResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackResourcesInput"}, - "output":{ - "shape":"DescribeStackResourcesOutput", - "resultWrapper":"DescribeStackResourcesResult" - }, - "documentation":"

Returns AWS resource descriptions for running and deleted stacks. If StackName is specified, all the associated resources that are part of the stack are returned. If PhysicalResourceId is specified, the associated resources of the stack that the resource belongs to are returned.

Only the first 100 resources will be returned. If your stack has more resources than this, you should use ListStackResources instead.

For deleted stacks, DescribeStackResources returns resource information for up to 90 days after the stack has been deleted.

You must specify either StackName or PhysicalResourceId, but not both. In addition, you can specify LogicalResourceId to filter the returned result. For more information about resources, the LogicalResourceId and PhysicalResourceId, go to the AWS CloudFormation User Guide.

A ValidationError is returned if you specify both StackName and PhysicalResourceId in the same request.

" - }, - "DescribeStackSet":{ - "name":"DescribeStackSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackSetInput"}, - "output":{ - "shape":"DescribeStackSetOutput", - "resultWrapper":"DescribeStackSetResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"} - ], - "documentation":"

Returns the description of the specified stack set.

" - }, - "DescribeStackSetOperation":{ - "name":"DescribeStackSetOperation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackSetOperationInput"}, - "output":{ - "shape":"DescribeStackSetOperationOutput", - "resultWrapper":"DescribeStackSetOperationResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationNotFoundException"} - ], - "documentation":"

Returns the description of the specified stack set operation.

" - }, - "DescribeStacks":{ - "name":"DescribeStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStacksInput"}, - "output":{ - "shape":"DescribeStacksOutput", - "resultWrapper":"DescribeStacksResult" - }, - "documentation":"

Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.

If the stack does not exist, an AmazonCloudFormationException is returned.

" - }, - "EstimateTemplateCost":{ - "name":"EstimateTemplateCost", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EstimateTemplateCostInput"}, - "output":{ - "shape":"EstimateTemplateCostOutput", - "resultWrapper":"EstimateTemplateCostResult" - }, - "documentation":"

Returns the estimated monthly cost of a template. The return value is an AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template.

" - }, - "ExecuteChangeSet":{ - "name":"ExecuteChangeSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExecuteChangeSetInput"}, - "output":{ - "shape":"ExecuteChangeSetOutput", - "resultWrapper":"ExecuteChangeSetResult" - }, - "errors":[ - {"shape":"InvalidChangeSetStatusException"}, - {"shape":"ChangeSetNotFoundException"}, - {"shape":"InsufficientCapabilitiesException"}, - {"shape":"TokenAlreadyExistsException"} - ], - "documentation":"

Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, AWS CloudFormation starts updating the stack. Use the DescribeStacks action to view the status of the update.

When you execute a change set, AWS CloudFormation deletes all other change sets associated with the stack because they aren't valid for the updated stack.

If a stack policy is associated with the stack, AWS CloudFormation enforces the policy during the update. You can't specify a temporary stack policy that overrides the current policy.

" - }, - "GetStackPolicy":{ - "name":"GetStackPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetStackPolicyInput"}, - "output":{ - "shape":"GetStackPolicyOutput", - "resultWrapper":"GetStackPolicyResult" - }, - "documentation":"

Returns the stack policy for a specified stack. If a stack doesn't have a policy, a null value is returned.

" - }, - "GetTemplate":{ - "name":"GetTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTemplateInput"}, - "output":{ - "shape":"GetTemplateOutput", - "resultWrapper":"GetTemplateResult" - }, - "errors":[ - {"shape":"ChangeSetNotFoundException"} - ], - "documentation":"

Returns the template body for a specified stack. You can get the template for running or deleted stacks.

For deleted stacks, GetTemplate returns the template for up to 90 days after the stack has been deleted.

If the template does not exist, a ValidationError is returned.

" - }, - "GetTemplateSummary":{ - "name":"GetTemplateSummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTemplateSummaryInput"}, - "output":{ - "shape":"GetTemplateSummaryOutput", - "resultWrapper":"GetTemplateSummaryResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"} - ], - "documentation":"

Returns information about a new or existing template. The GetTemplateSummary action is useful for viewing parameter information, such as default parameter values and parameter types, before you create or update a stack or stack set.

You can use the GetTemplateSummary action when you submit a template, or you can get template information for a stack set, or a running or deleted stack.

For deleted stacks, GetTemplateSummary returns the template information for up to 90 days after the stack has been deleted. If the template does not exist, a ValidationError is returned.

" - }, - "ListChangeSets":{ - "name":"ListChangeSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListChangeSetsInput"}, - "output":{ - "shape":"ListChangeSetsOutput", - "resultWrapper":"ListChangeSetsResult" - }, - "documentation":"

Returns the ID and status of each active change set for a stack. For example, AWS CloudFormation lists change sets that are in the CREATE_IN_PROGRESS or CREATE_PENDING state.

" - }, - "ListExports":{ - "name":"ListExports", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListExportsInput"}, - "output":{ - "shape":"ListExportsOutput", - "resultWrapper":"ListExportsResult" - }, - "documentation":"

Lists all exported output values in the account and region in which you call this action. Use this action to see the exported output values that you can import into other stacks. To import values, use the Fn::ImportValue function.

For more information, see AWS CloudFormation Export Stack Output Values.

" - }, - "ListImports":{ - "name":"ListImports", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListImportsInput"}, - "output":{ - "shape":"ListImportsOutput", - "resultWrapper":"ListImportsResult" - }, - "documentation":"

Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.

For more information about importing an exported output value, see the Fn::ImportValue function.

" - }, - "ListStackInstances":{ - "name":"ListStackInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStackInstancesInput"}, - "output":{ - "shape":"ListStackInstancesOutput", - "resultWrapper":"ListStackInstancesResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"} - ], - "documentation":"

Returns summary information about stack instances that are associated with the specified stack set. You can filter for stack instances that are associated with a specific AWS account name or region.

" - }, - "ListStackResources":{ - "name":"ListStackResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStackResourcesInput"}, - "output":{ - "shape":"ListStackResourcesOutput", - "resultWrapper":"ListStackResourcesResult" - }, - "documentation":"

Returns descriptions of all resources of the specified stack.

For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted.

" - }, - "ListStackSetOperationResults":{ - "name":"ListStackSetOperationResults", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStackSetOperationResultsInput"}, - "output":{ - "shape":"ListStackSetOperationResultsOutput", - "resultWrapper":"ListStackSetOperationResultsResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationNotFoundException"} - ], - "documentation":"

Returns summary information about the results of a stack set operation.

" - }, - "ListStackSetOperations":{ - "name":"ListStackSetOperations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStackSetOperationsInput"}, - "output":{ - "shape":"ListStackSetOperationsOutput", - "resultWrapper":"ListStackSetOperationsResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"} - ], - "documentation":"

Returns summary information about operations performed on a stack set.

" - }, - "ListStackSets":{ - "name":"ListStackSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStackSetsInput"}, - "output":{ - "shape":"ListStackSetsOutput", - "resultWrapper":"ListStackSetsResult" - }, - "documentation":"

Returns summary information about stack sets that are associated with the user.

" - }, - "ListStacks":{ - "name":"ListStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStacksInput"}, - "output":{ - "shape":"ListStacksOutput", - "resultWrapper":"ListStacksResult" - }, - "documentation":"

Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).

" - }, - "SetStackPolicy":{ - "name":"SetStackPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetStackPolicyInput"}, - "documentation":"

Sets a stack policy for a specified stack.

" - }, - "SignalResource":{ - "name":"SignalResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SignalResourceInput"}, - "documentation":"

Sends a signal to the specified resource with a success or failure status. You can use the SignalResource API in conjunction with a creation policy or update policy. AWS CloudFormation doesn't proceed with a stack creation or update until resources receive the required number of signals or the timeout period is exceeded. The SignalResource API is useful in cases where you want to send signals from anywhere other than an Amazon EC2 instance.

" - }, - "StopStackSetOperation":{ - "name":"StopStackSetOperation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopStackSetOperationInput"}, - "output":{ - "shape":"StopStackSetOperationOutput", - "resultWrapper":"StopStackSetOperationResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationNotFoundException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Stops an in-progress operation on a stack set and its associated stack instances.

" - }, - "UpdateStack":{ - "name":"UpdateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStackInput"}, - "output":{ - "shape":"UpdateStackOutput", - "resultWrapper":"UpdateStackResult" - }, - "errors":[ - {"shape":"InsufficientCapabilitiesException"}, - {"shape":"TokenAlreadyExistsException"} - ], - "documentation":"

Updates a stack as specified in the template. After the call completes successfully, the stack update starts. You can check the status of the stack via the DescribeStacks action.

To get a copy of the template for an existing stack, you can use the GetTemplate action.

For more information about creating an update template, updating a stack, and monitoring the progress of the update, see Updating a Stack.

" - }, - "UpdateStackInstances":{ - "name":"UpdateStackInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStackInstancesInput"}, - "output":{ - "shape":"UpdateStackInstancesOutput", - "resultWrapper":"UpdateStackInstancesResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"StackInstanceNotFoundException"}, - {"shape":"OperationInProgressException"}, - {"shape":"OperationIdAlreadyExistsException"}, - {"shape":"StaleRequestException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Updates the parameter values for stack instances for the specified accounts, within the specified regions. A stack instance refers to a stack in a specific account and region.

You can only update stack instances in regions and accounts where they already exist; to create additional stack instances, use CreateStackInstances.

During stack set updates, any parameters overridden for a stack instance are not updated, but retain their overridden value.

You can only update the parameter values that are specified in the stack set; to add or delete a parameter itself, use UpdateStackSet to update the stack set template. If you add a parameter to a template, before you can override the parameter value specified in the stack set you must first use UpdateStackSet to update all stack instances with the updated template and parameter value specified in the stack set. Once a stack instance has been updated with the new parameter, you can then override the parameter value using UpdateStackInstances.

" - }, - "UpdateStackSet":{ - "name":"UpdateStackSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStackSetInput"}, - "output":{ - "shape":"UpdateStackSetOutput", - "resultWrapper":"UpdateStackSetResult" - }, - "errors":[ - {"shape":"StackSetNotFoundException"}, - {"shape":"OperationInProgressException"}, - {"shape":"OperationIdAlreadyExistsException"}, - {"shape":"StaleRequestException"}, - {"shape":"InvalidOperationException"}, - {"shape":"StackInstanceNotFoundException"} - ], - "documentation":"

Updates the stack set, and associated stack instances in the specified accounts and regions.

Even if the stack set operation created by updating the stack set fails (completely or partially, below or above a specified failure tolerance), the stack set is updated with your changes. Subsequent CreateStackInstances calls on the specified stack set use the updated stack set.

" - }, - "UpdateTerminationProtection":{ - "name":"UpdateTerminationProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTerminationProtectionInput"}, - "output":{ - "shape":"UpdateTerminationProtectionOutput", - "resultWrapper":"UpdateTerminationProtectionResult" - }, - "documentation":"

Updates termination protection for the specified stack. If a user attempts to delete a stack with termination protection enabled, the operation fails and the stack remains unchanged. For more information, see Protecting a Stack From Being Deleted in the AWS CloudFormation User Guide.

For nested stacks, termination protection is set on the root stack and cannot be changed directly on the nested stack.

" - }, - "ValidateTemplate":{ - "name":"ValidateTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ValidateTemplateInput"}, - "output":{ - "shape":"ValidateTemplateOutput", - "resultWrapper":"ValidateTemplateResult" - }, - "documentation":"

Validates a specified template. AWS CloudFormation first checks if the template is valid JSON. If it isn't, AWS CloudFormation checks if the template is valid YAML. If both these checks fail, AWS CloudFormation returns a template validation error.

" - } - }, - "shapes":{ - "Account":{ - "type":"string", - "pattern":"[0-9]{12}" - }, - "AccountGateResult":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"AccountGateStatus", - "documentation":"

The status of the account gate function.

  • SUCCEEDED: The account gate function has determined that the account and region passes any requirements for a stack set operation to occur. AWS CloudFormation proceeds with the stack operation in that account and region.

  • FAILED: The account gate function has determined that the account and region does not meet the requirements for a stack set operation to occur. AWS CloudFormation cancels the stack set operation in that account and region, and sets the stack set operation result status for that account and region to FAILED.

  • SKIPPED: AWS CloudFormation has skipped calling the account gate function for this account and region, for one of the following reasons:

    • An account gate function has not been specified for the account and region. AWS CloudFormation proceeds with the stack set operation in this account and region.

    • The AWSCloudFormationStackSetExecutionRole of the stack set adminstration account lacks permissions to invoke the function. AWS CloudFormation proceeds with the stack set operation in this account and region.

    • Either no action is necessary, or no action is possible, on the stack. AWS CloudFormation skips the stack set operation in this account and region.

" - }, - "StatusReason":{ - "shape":"AccountGateStatusReason", - "documentation":"

The reason for the account gate status assigned to this account and region for the stack set operation.

" - } - }, - "documentation":"

Structure that contains the results of the account gate function which AWS CloudFormation invokes, if present, before proceeding with a stack set operation in an account and region.

For each account and region, AWS CloudFormation lets you specify a Lamdba function that encapsulates any requirements that must be met before CloudFormation can proceed with a stack set operation in that account and region. CloudFormation invokes the function each time a stack set operation is requested for that account and region; if the function returns FAILED, CloudFormation cancels the operation in that account and region, and sets the stack set operation result status for that account and region to FAILED.

For more information, see Configuring a target account gate.

" - }, - "AccountGateStatus":{ - "type":"string", - "enum":[ - "SUCCEEDED", - "FAILED", - "SKIPPED" - ] - }, - "AccountGateStatusReason":{"type":"string"}, - "AccountLimit":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"LimitName", - "documentation":"

The name of the account limit. Currently, the only account limit is StackLimit.

" - }, - "Value":{ - "shape":"LimitValue", - "documentation":"

The value that is associated with the account limit name.

" - } - }, - "documentation":"

The AccountLimit data type.

" - }, - "AccountLimitList":{ - "type":"list", - "member":{"shape":"AccountLimit"} - }, - "AccountList":{ - "type":"list", - "member":{"shape":"Account"} - }, - "AllowedValue":{"type":"string"}, - "AllowedValues":{ - "type":"list", - "member":{"shape":"AllowedValue"} - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The resource with the name requested already exists.

", - "error":{ - "code":"AlreadyExistsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Arn":{"type":"string"}, - "CancelUpdateStackInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this CancelUpdateStack request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to cancel an update on a stack with the same name. You might retry CancelUpdateStack requests to ensure that AWS CloudFormation successfully received them.

" - } - }, - "documentation":"

The input for the CancelUpdateStack action.

" - }, - "Capabilities":{ - "type":"list", - "member":{"shape":"Capability"} - }, - "CapabilitiesReason":{"type":"string"}, - "Capability":{ - "type":"string", - "enum":[ - "CAPABILITY_IAM", - "CAPABILITY_NAMED_IAM" - ] - }, - "CausingEntity":{"type":"string"}, - "Change":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"ChangeType", - "documentation":"

The type of entity that AWS CloudFormation changes. Currently, the only entity type is Resource.

" - }, - "ResourceChange":{ - "shape":"ResourceChange", - "documentation":"

A ResourceChange structure that describes the resource and action that AWS CloudFormation will perform.

" - } - }, - "documentation":"

The Change structure describes the changes AWS CloudFormation will perform if you execute the change set.

" - }, - "ChangeAction":{ - "type":"string", - "enum":[ - "Add", - "Modify", - "Remove" - ] - }, - "ChangeSetId":{ - "type":"string", - "min":1, - "pattern":"arn:[-a-zA-Z0-9:/]*" - }, - "ChangeSetName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z][-a-zA-Z0-9]*" - }, - "ChangeSetNameOrId":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[a-zA-Z][-a-zA-Z0-9]*|arn:[-a-zA-Z0-9:/]*" - }, - "ChangeSetNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the ListChangeSets action.

", - "error":{ - "code":"ChangeSetNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ChangeSetStatus":{ - "type":"string", - "enum":[ - "CREATE_PENDING", - "CREATE_IN_PROGRESS", - "CREATE_COMPLETE", - "DELETE_COMPLETE", - "FAILED" - ] - }, - "ChangeSetStatusReason":{"type":"string"}, - "ChangeSetSummaries":{ - "type":"list", - "member":{"shape":"ChangeSetSummary"} - }, - "ChangeSetSummary":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

The ID of the stack with which the change set is associated.

" - }, - "StackName":{ - "shape":"StackName", - "documentation":"

The name of the stack with which the change set is associated.

" - }, - "ChangeSetId":{ - "shape":"ChangeSetId", - "documentation":"

The ID of the change set.

" - }, - "ChangeSetName":{ - "shape":"ChangeSetName", - "documentation":"

The name of the change set.

" - }, - "ExecutionStatus":{ - "shape":"ExecutionStatus", - "documentation":"

If the change set execution status is AVAILABLE, you can execute the change set. If you can’t execute the change set, the status indicates why. For example, a change set might be in an UNAVAILABLE state because AWS CloudFormation is still creating it or in an OBSOLETE state because the stack was already updated.

" - }, - "Status":{ - "shape":"ChangeSetStatus", - "documentation":"

The state of the change set, such as CREATE_IN_PROGRESS, CREATE_COMPLETE, or FAILED.

" - }, - "StatusReason":{ - "shape":"ChangeSetStatusReason", - "documentation":"

A description of the change set's status. For example, if your change set is in the FAILED state, AWS CloudFormation shows the error message.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

The start time when the change set was created, in UTC.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Descriptive information about the change set.

" - } - }, - "documentation":"

The ChangeSetSummary structure describes a change set, its status, and the stack with which it's associated.

" - }, - "ChangeSetType":{ - "type":"string", - "enum":[ - "CREATE", - "UPDATE" - ] - }, - "ChangeSource":{ - "type":"string", - "enum":[ - "ResourceReference", - "ParameterReference", - "ResourceAttribute", - "DirectModification", - "Automatic" - ] - }, - "ChangeType":{ - "type":"string", - "enum":["Resource"] - }, - "Changes":{ - "type":"list", - "member":{"shape":"Change"} - }, - "ClientRequestToken":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9][-a-zA-Z0-9]*" - }, - "ClientToken":{ - "type":"string", - "max":128, - "min":1 - }, - "ContinueUpdateRollbackInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The name or the unique ID of the stack that you want to continue rolling back.

Don't specify the name of a nested stack (a stack that was created by using the AWS::CloudFormation::Stack resource). Instead, use this operation on the parent stack (the stack that contains the AWS::CloudFormation::Stack resource).

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to roll back the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege.

If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

" - }, - "ResourcesToSkip":{ - "shape":"ResourcesToSkip", - "documentation":"

A list of the logical IDs of the resources that AWS CloudFormation skips during the continue update rollback operation. You can specify only resources that are in the UPDATE_FAILED state because a rollback failed. You can't specify resources that are in the UPDATE_FAILED state for other reasons, for example, because an update was cancelled. To check why a resource update failed, use the DescribeStackResources action, and view the resource status reason.

Specify this property to skip rolling back resources that AWS CloudFormation can't successfully roll back. We recommend that you troubleshoot resources before skipping them. AWS CloudFormation sets the status of the specified resources to UPDATE_COMPLETE and continues to roll back the stack. After the rollback is complete, the state of the skipped resources will be inconsistent with the state of the resources in the stack template. Before performing another stack update, you must update the stack or resources to be consistent with each other. If you don't, subsequent stack updates might fail, and the stack will become unrecoverable.

Specify the minimum number of resources required to successfully roll back your stack. For example, a failed resource update might cause dependent resources to fail. In this case, it might not be necessary to skip the dependent resources.

To skip resources that are part of nested stacks, use the following format: NestedStackName.ResourceLogicalID. If you want to specify the logical ID of a stack resource (Type: AWS::CloudFormation::Stack) in the ResourcesToSkip list, then its corresponding embedded stack must be in one of the following states: DELETE_IN_PROGRESS, DELETE_COMPLETE, or DELETE_FAILED.

Don't confuse a child stack's name with its corresponding logical ID defined in the parent stack. For an example of a continue update rollback operation with nested stacks, see Using ResourcesToSkip to recover a nested stacks hierarchy.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this ContinueUpdateRollback request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to continue the rollback to a stack with the same name. You might retry ContinueUpdateRollback requests to ensure that AWS CloudFormation successfully received them.

" - } - }, - "documentation":"

The input for the ContinueUpdateRollback action.

" - }, - "ContinueUpdateRollbackOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for a ContinueUpdateRollback action.

" - }, - "CreateChangeSetInput":{ - "type":"structure", - "required":[ - "StackName", - "ChangeSetName" - ], - "members":{ - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates the change set by comparing this stack's information with the information that you submit, such as a modified template or different parameter input values.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

A structure that contains the body of the revised template, with a minimum length of 1 byte and a maximum length of 51,200 bytes. AWS CloudFormation generates the change set by comparing this template with the template of the stack that you specified.

Conditional: You must specify only TemplateBody or TemplateURL.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

The location of the file that contains the revised template. The URL must point to a template (max size: 460,800 bytes) that is located in an S3 bucket. AWS CloudFormation generates the change set by comparing this template with the stack that you specified.

Conditional: You must specify only TemplateBody or TemplateURL.

" - }, - "UsePreviousTemplate":{ - "shape":"UsePreviousTemplate", - "documentation":"

Whether to reuse the template that is associated with the stack to create the change set.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures that specify input parameters for the change set. For more information, see the Parameter data type.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.

The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The following resources require you to specify this parameter: AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::InstanceProfile, AWS::IAM::Policy, AWS::IAM::Role, AWS::IAM::User, and AWS::IAM::UserToGroupAddition. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.

If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action returns an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "ResourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

The template resource types that you have permissions to work with if you execute this change set, such as AWS::EC2::Instance, AWS::EC2::*, or Custom::MyCustomInstance.

If the list of resource types doesn't include a resource type that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for condition keys in IAM policies for AWS CloudFormation. For more information, see Controlling Access with AWS Identity and Access Management in the AWS CloudFormation User Guide.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes when executing the change set. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege.

If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

" - }, - "RollbackConfiguration":{ - "shape":"RollbackConfiguration", - "documentation":"

The rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

" - }, - "NotificationARNs":{ - "shape":"NotificationARNs", - "documentation":"

The Amazon Resource Names (ARNs) of Amazon Simple Notification Service (Amazon SNS) topics that AWS CloudFormation associates with the stack. To remove all associated notification topics, specify an empty list.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to resources in the stack. You can specify a maximum of 50 tags.

" - }, - "ChangeSetName":{ - "shape":"ChangeSetName", - "documentation":"

The name of the change set. The name must be unique among all change sets that are associated with the specified stack.

A change set name can contain only alphanumeric, case sensitive characters and hyphens. It must start with an alphabetic character and cannot exceed 128 characters.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique identifier for this CreateChangeSet request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to create another change set with the same name. You might retry CreateChangeSet requests to ensure that AWS CloudFormation successfully received them.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description to help you identify this change set.

" - }, - "ChangeSetType":{ - "shape":"ChangeSetType", - "documentation":"

The type of change set operation. To create a change set for a new stack, specify CREATE. To create a change set for an existing stack, specify UPDATE.

If you create a change set for a new stack, AWS Cloudformation creates a stack with a unique stack ID, but no template or resources. The stack will be in the REVIEW_IN_PROGRESS state until you execute the change set.

By default, AWS CloudFormation specifies UPDATE. You can't use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.

" - } - }, - "documentation":"

The input for the CreateChangeSet action.

" - }, - "CreateChangeSetOutput":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ChangeSetId", - "documentation":"

The Amazon Resource Name (ARN) of the change set.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

The unique ID of the stack.

" - } - }, - "documentation":"

The output for the CreateChangeSet action.

" - }, - "CreateStackInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name that is associated with the stack. The name must be unique in the region in which you are creating the stack.

A stack name can contain only alphanumeric characters (case sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but not both.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to the Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but not both.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures that specify input parameters for the stack. For more information, see the Parameter data type.

" - }, - "DisableRollback":{ - "shape":"DisableRollback", - "documentation":"

Set to true to disable rollback of the stack if stack creation failed. You can specify either DisableRollback or OnFailure, but not both.

Default: false

" - }, - "RollbackConfiguration":{ - "shape":"RollbackConfiguration", - "documentation":"

The rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

" - }, - "TimeoutInMinutes":{ - "shape":"TimeoutMinutes", - "documentation":"

The amount of time that can pass before the stack status becomes CREATE_FAILED; if DisableRollback is not set or is set to false, the stack will be rolled back.

" - }, - "NotificationARNs":{ - "shape":"NotificationARNs", - "documentation":"

The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the SNS console or your Command Line Interface (CLI).

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

A list of values that you must specify before AWS CloudFormation can create certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.

The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The following resources require you to specify this parameter: AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::InstanceProfile, AWS::IAM::Policy, AWS::IAM::Role, AWS::IAM::User, and AWS::IAM::UserToGroupAddition. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.

If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action returns an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "ResourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

The template resource types that you have permissions to work with for this create stack action, such as AWS::EC2::Instance, AWS::EC2::*, or Custom::MyCustomInstance. Use the following syntax to describe template resource types: AWS::* (for all AWS resource), Custom::* (for all custom resources), Custom::logical_ID (for a specific custom resource), AWS::service_name::* (for all resources of a particular AWS service), and AWS::service_name::resource_logical_ID (for a specific AWS resource).

If the list of resource types doesn't include a resource that you're creating, the stack creation fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see Controlling Access with AWS Identity and Access Management.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to create the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege.

If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

" - }, - "OnFailure":{ - "shape":"OnFailure", - "documentation":"

Determines what action will be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either OnFailure or DisableRollback, but not both.

Default: ROLLBACK

" - }, - "StackPolicyBody":{ - "shape":"StackPolicyBody", - "documentation":"

Structure containing the stack policy body. For more information, go to Prevent Updates to Stack Resources in the AWS CloudFormation User Guide. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

" - }, - "StackPolicyURL":{ - "shape":"StackPolicyURL", - "documentation":"

Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this CreateStack request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to create a stack with the same name. You might retry CreateStack requests to ensure that AWS CloudFormation successfully received them.

All events triggered by a given stack operation are assigned the same client request token, which you can use to track operations. For example, if you execute a CreateStack operation with the token token1, then all the StackEvents generated by that operation will have ClientRequestToken set as token1.

In the console, stack operations display the client request token on the Events tab. Stack operations that are initiated from the console use the token format Console-StackOperation-ID, which helps you easily identify the stack operation . For example, if you create a stack using the console, each stack event would be assigned the same token in the following format: Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

" - }, - "EnableTerminationProtection":{ - "shape":"EnableTerminationProtection", - "documentation":"

Whether to enable termination protection on the specified stack. If a user attempts to delete a stack with termination protection enabled, the operation fails and the stack remains unchanged. For more information, see Protecting a Stack From Being Deleted in the AWS CloudFormation User Guide. Termination protection is disabled on stacks by default.

For nested stacks, termination protection is set on the root stack and cannot be changed directly on the nested stack.

" - } - }, - "documentation":"

The input for CreateStack action.

" - }, - "CreateStackInstancesInput":{ - "type":"structure", - "required":[ - "StackSetName", - "Accounts", - "Regions" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to create stack instances from.

" - }, - "Accounts":{ - "shape":"AccountList", - "documentation":"

The names of one or more AWS accounts that you want to create stack instances in the specified region(s) for.

" - }, - "Regions":{ - "shape":"RegionList", - "documentation":"

The names of one or more regions where you want to create stack instances using the specified AWS account(s).

" - }, - "ParameterOverrides":{ - "shape":"Parameters", - "documentation":"

A list of stack set parameters whose values you want to override in the selected stack instances.

Any overridden parameter values will be applied to all stack instances in the specified accounts and regions. When specifying parameters and their values, be aware of how AWS CloudFormation sets parameter values during stack instance operations:

  • To override the current value for a parameter, include the parameter and specify its value.

  • To leave a parameter set to its present value, you can do one of the following:

    • Do not include the parameter in the list.

    • Include the parameter and specify UsePreviousValue as true. (You cannot specify both a value and set UsePreviousValue to true.)

  • To set all overridden parameter back to the values specified in the stack set, specify a parameter list but do not include any parameters.

  • To leave all parameters set to their present values, do not specify this property at all.

During stack set updates, any parameter values overridden for a stack instance are not updated, but retain their overridden value.

You can only override the parameter values that are specified in the stack set; to add or delete a parameter itself, use UpdateStackSet to update the stack set template.

" - }, - "OperationPreferences":{ - "shape":"StackSetOperationPreferences", - "documentation":"

Preferences for how AWS CloudFormation performs this stack set operation.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

The operation ID also functions as an idempotency token, to ensure that AWS CloudFormation performs the stack set operation only once, even if you retry the request multiple times. You might retry stack set operation requests to ensure that AWS CloudFormation successfully received them.

If you don't specify an operation ID, the SDK generates one automatically.

Repeating this stack set operation with a new operation ID retries all stack instances whose status is OUTDATED.

", - "idempotencyToken":true - } - } - }, - "CreateStackInstancesOutput":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

" - } - } - }, - "CreateStackOutput":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

Unique identifier of the stack.

" - } - }, - "documentation":"

The output for a CreateStack action.

" - }, - "CreateStackSetInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name to associate with the stack set. The name must be unique in the region where you create your stack set.

A stack name can contain only alphanumeric characters (case-sensitive) and hyphens. It must start with an alphabetic character and can't be longer than 128 characters.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the stack set. You can use the description to identify the stack set's purpose or other important information.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

The structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but not both.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

The location of the file that contains the template body. The URL must point to a template (maximum size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but not both.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The input parameters for the stack set template.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

A list of values that you must specify before AWS CloudFormation can create certain stack sets. Some stack set templates might include resources that can affect permissions in your AWS account—for example, by creating new AWS Identity and Access Management (IAM) users. For those stack sets, you must explicitly acknowledge their capabilities by specifying this parameter.

The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The following resources require you to specify this parameter:

  • AWS::IAM::AccessKey

  • AWS::IAM::Group

  • AWS::IAM::InstanceProfile

  • AWS::IAM::Policy

  • AWS::IAM::Role

  • AWS::IAM::User

  • AWS::IAM::UserToGroupAddition

If your stack template contains these resources, we recommend that you review all permissions that are associated with them and edit their permissions if necessary.

If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action returns an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The key-value pairs to associate with this stack set and the stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the stacks. A maximum number of 50 tags can be specified.

If you specify tags as part of a CreateStackSet action, AWS CloudFormation checks to see if you have the required IAM permission to tag resources. If you don't, the entire CreateStackSet action fails with an access denied error, and the stack set is not created.

" - }, - "AdministrationRoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Number (ARN) of the IAM role to use to create this stack set.

Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see Prerequisites: Granting Permissions for Stack Set Operations in the AWS CloudFormation User Guide.

" - }, - "ExecutionRoleName":{ - "shape":"ExecutionRoleName", - "documentation":"

The name of the IAM execution role to use to create the stack set. If you do not specify an execution role, AWS CloudFormation uses the AWSCloudFormationStackSetExecutionRole role for the stack set operation.

Specify an IAM role only if you are using customized execution roles to control which stack resources users and groups can include in their stack sets.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this CreateStackSet request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to create another stack set with the same name. You might retry CreateStackSet requests to ensure that AWS CloudFormation successfully received them.

If you don't specify an operation ID, the SDK generates one automatically.

", - "idempotencyToken":true - } - } - }, - "CreateStackSetOutput":{ - "type":"structure", - "members":{ - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The ID of the stack set that you're creating.

" - } - } - }, - "CreatedButModifiedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource exists, but has been changed.

", - "error":{ - "code":"CreatedButModifiedException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "CreationTime":{"type":"timestamp"}, - "DeleteChangeSetInput":{ - "type":"structure", - "required":["ChangeSetName"], - "members":{ - "ChangeSetName":{ - "shape":"ChangeSetNameOrId", - "documentation":"

The name or Amazon Resource Name (ARN) of the change set that you want to delete.

" - }, - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

If you specified the name of a change set to delete, specify the stack name or ID (ARN) that is associated with it.

" - } - }, - "documentation":"

The input for the DeleteChangeSet action.

" - }, - "DeleteChangeSetOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the DeleteChangeSet action.

" - }, - "DeleteStackInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack.

" - }, - "RetainResources":{ - "shape":"RetainResources", - "documentation":"

For stacks in the DELETE_FAILED state, a list of resource logical IDs that are associated with the resources you want to retain. During deletion, AWS CloudFormation deletes the stack but does not delete the retained resources.

Retaining resources is useful when you cannot delete a resource, such as a non-empty S3 bucket, but you want to delete the stack.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to delete the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf.

If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this DeleteStack request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to delete a stack with the same name. You might retry DeleteStack requests to ensure that AWS CloudFormation successfully received them.

All events triggered by a given stack operation are assigned the same client request token, which you can use to track operations. For example, if you execute a CreateStack operation with the token token1, then all the StackEvents generated by that operation will have ClientRequestToken set as token1.

In the console, stack operations display the client request token on the Events tab. Stack operations that are initiated from the console use the token format Console-StackOperation-ID, which helps you easily identify the stack operation . For example, if you create a stack using the console, each stack event would be assigned the same token in the following format: Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

" - } - }, - "documentation":"

The input for DeleteStack action.

" - }, - "DeleteStackInstancesInput":{ - "type":"structure", - "required":[ - "StackSetName", - "Accounts", - "Regions", - "RetainStacks" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to delete stack instances for.

" - }, - "Accounts":{ - "shape":"AccountList", - "documentation":"

The names of the AWS accounts that you want to delete stack instances for.

" - }, - "Regions":{ - "shape":"RegionList", - "documentation":"

The regions where you want to delete stack set instances.

" - }, - "OperationPreferences":{ - "shape":"StackSetOperationPreferences", - "documentation":"

Preferences for how AWS CloudFormation performs this stack set operation.

" - }, - "RetainStacks":{ - "shape":"RetainStacks", - "documentation":"

Removes the stack instances from the specified stack set, but doesn't delete the stacks. You can't reassociate a retained stack or add an existing, saved stack to a new stack set.

For more information, see Stack set operation options.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

If you don't specify an operation ID, the SDK generates one automatically.

The operation ID also functions as an idempotency token, to ensure that AWS CloudFormation performs the stack set operation only once, even if you retry the request multiple times. You can retry stack set operation requests to ensure that AWS CloudFormation successfully received them.

Repeating this stack set operation with a new operation ID retries all stack instances whose status is OUTDATED.

", - "idempotencyToken":true - } - } - }, - "DeleteStackInstancesOutput":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

" - } - } - }, - "DeleteStackSetInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you're deleting. You can obtain this value by running ListStackSets.

" - } - } - }, - "DeleteStackSetOutput":{ - "type":"structure", - "members":{ - } - }, - "DeletionTime":{"type":"timestamp"}, - "DescribeAccountLimitsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of limits that you want to retrieve.

" - } - }, - "documentation":"

The input for the DescribeAccountLimits action.

" - }, - "DescribeAccountLimitsOutput":{ - "type":"structure", - "members":{ - "AccountLimits":{ - "shape":"AccountLimitList", - "documentation":"

An account limit structure that contain a list of AWS CloudFormation account limits and their values.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB in size, a string that identifies the next page of limits. If no additional page exists, this value is null.

" - } - }, - "documentation":"

The output for the DescribeAccountLimits action.

" - }, - "DescribeChangeSetInput":{ - "type":"structure", - "required":["ChangeSetName"], - "members":{ - "ChangeSetName":{ - "shape":"ChangeSetNameOrId", - "documentation":"

The name or Amazon Resource Name (ARN) of the change set that you want to describe.

" - }, - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

If you specified the name of a change set, specify the stack name or ID (ARN) of the change set you want to describe.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string (provided by the DescribeChangeSet response output) that identifies the next page of information that you want to retrieve.

" - } - }, - "documentation":"

The input for the DescribeChangeSet action.

" - }, - "DescribeChangeSetOutput":{ - "type":"structure", - "members":{ - "ChangeSetName":{ - "shape":"ChangeSetName", - "documentation":"

The name of the change set.

" - }, - "ChangeSetId":{ - "shape":"ChangeSetId", - "documentation":"

The ARN of the change set.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

The ARN of the stack that is associated with the change set.

" - }, - "StackName":{ - "shape":"StackName", - "documentation":"

The name of the stack that is associated with the change set.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Information about the change set.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures that describes the input parameters and their values used to create the change set. For more information, see the Parameter data type.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

The start time when the change set was created, in UTC.

" - }, - "ExecutionStatus":{ - "shape":"ExecutionStatus", - "documentation":"

If the change set execution status is AVAILABLE, you can execute the change set. If you can’t execute the change set, the status indicates why. For example, a change set might be in an UNAVAILABLE state because AWS CloudFormation is still creating it or in an OBSOLETE state because the stack was already updated.

" - }, - "Status":{ - "shape":"ChangeSetStatus", - "documentation":"

The current status of the change set, such as CREATE_IN_PROGRESS, CREATE_COMPLETE, or FAILED.

" - }, - "StatusReason":{ - "shape":"ChangeSetStatusReason", - "documentation":"

A description of the change set's status. For example, if your attempt to create a change set failed, AWS CloudFormation shows the error message.

" - }, - "NotificationARNs":{ - "shape":"NotificationARNs", - "documentation":"

The ARNs of the Amazon Simple Notification Service (Amazon SNS) topics that will be associated with the stack if you execute the change set.

" - }, - "RollbackConfiguration":{ - "shape":"RollbackConfiguration", - "documentation":"

The rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

If you execute the change set, the tags that will be associated with the stack.

" - }, - "Changes":{ - "shape":"Changes", - "documentation":"

A list of Change structures that describes the resources AWS CloudFormation changes if you execute the change set.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB, a string that identifies the next page of changes. If there is no additional page, this value is null.

" - } - }, - "documentation":"

The output for the DescribeChangeSet action.

" - }, - "DescribeStackEventsInput":{ - "type":"structure", - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of events that you want to retrieve.

" - } - }, - "documentation":"

The input for DescribeStackEvents action.

" - }, - "DescribeStackEventsOutput":{ - "type":"structure", - "members":{ - "StackEvents":{ - "shape":"StackEvents", - "documentation":"

A list of StackEvents structures.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB in size, a string that identifies the next page of events. If no additional page exists, this value is null.

" - } - }, - "documentation":"

The output for a DescribeStackEvents action.

" - }, - "DescribeStackInstanceInput":{ - "type":"structure", - "required":[ - "StackSetName", - "StackInstanceAccount", - "StackInstanceRegion" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or the unique stack ID of the stack set that you want to get stack instance information for.

" - }, - "StackInstanceAccount":{ - "shape":"Account", - "documentation":"

The ID of an AWS account that's associated with this stack instance.

" - }, - "StackInstanceRegion":{ - "shape":"Region", - "documentation":"

The name of a region that's associated with this stack instance.

" - } - } - }, - "DescribeStackInstanceOutput":{ - "type":"structure", - "members":{ - "StackInstance":{ - "shape":"StackInstance", - "documentation":"

The stack instance that matches the specified request parameters.

" - } - } - }, - "DescribeStackResourceInput":{ - "type":"structure", - "required":[ - "StackName", - "LogicalResourceId" - ], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource as specified in the template.

Default: There is no default value.

" - } - }, - "documentation":"

The input for DescribeStackResource action.

" - }, - "DescribeStackResourceOutput":{ - "type":"structure", - "members":{ - "StackResourceDetail":{ - "shape":"StackResourceDetail", - "documentation":"

A StackResourceDetail structure containing the description of the specified resource in the specified stack.

" - } - }, - "documentation":"

The output for a DescribeStackResource action.

" - }, - "DescribeStackResourcesInput":{ - "type":"structure", - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

Required: Conditional. If you do not specify StackName, you must specify PhysicalResourceId.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource as specified in the template.

Default: There is no default value.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation.

For example, for an Amazon Elastic Compute Cloud (EC2) instance, PhysicalResourceId corresponds to the InstanceId. You can pass the EC2 InstanceId to DescribeStackResources to find which stack the instance belongs to and what other resources are part of the stack.

Required: Conditional. If you do not specify PhysicalResourceId, you must specify StackName.

Default: There is no default value.

" - } - }, - "documentation":"

The input for DescribeStackResources action.

" - }, - "DescribeStackResourcesOutput":{ - "type":"structure", - "members":{ - "StackResources":{ - "shape":"StackResources", - "documentation":"

A list of StackResource structures.

" - } - }, - "documentation":"

The output for a DescribeStackResources action.

" - }, - "DescribeStackSetInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set whose description you want.

" - } - } - }, - "DescribeStackSetOperationInput":{ - "type":"structure", - "required":[ - "StackSetName", - "OperationId" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or the unique stack ID of the stack set for the stack operation.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique ID of the stack set operation.

" - } - } - }, - "DescribeStackSetOperationOutput":{ - "type":"structure", - "members":{ - "StackSetOperation":{ - "shape":"StackSetOperation", - "documentation":"

The specified stack set operation.

" - } - } - }, - "DescribeStackSetOutput":{ - "type":"structure", - "members":{ - "StackSet":{ - "shape":"StackSet", - "documentation":"

The specified stack set.

" - } - } - }, - "DescribeStacksInput":{ - "type":"structure", - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of stacks that you want to retrieve.

" - } - }, - "documentation":"

The input for DescribeStacks action.

" - }, - "DescribeStacksOutput":{ - "type":"structure", - "members":{ - "Stacks":{ - "shape":"Stacks", - "documentation":"

A list of stack structures.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null.

" - } - }, - "documentation":"

The output for a DescribeStacks action.

" - }, - "Description":{ - "type":"string", - "max":1024, - "min":1 - }, - "DisableRollback":{"type":"boolean"}, - "EnableTerminationProtection":{"type":"boolean"}, - "EstimateTemplateCostInput":{ - "type":"structure", - "members":{ - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to Template Anatomy in the AWS CloudFormation User Guide.)

Conditional: You must pass TemplateBody or TemplateURL. If both are passed, only TemplateBody is used.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must pass TemplateURL or TemplateBody. If both are passed, only TemplateBody is used.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures that specify input parameters.

" - } - }, - "documentation":"

The input for an EstimateTemplateCost action.

" - }, - "EstimateTemplateCostOutput":{ - "type":"structure", - "members":{ - "Url":{ - "shape":"Url", - "documentation":"

An AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template.

" - } - }, - "documentation":"

The output for a EstimateTemplateCost action.

" - }, - "EvaluationType":{ - "type":"string", - "enum":[ - "Static", - "Dynamic" - ] - }, - "EventId":{"type":"string"}, - "ExecuteChangeSetInput":{ - "type":"structure", - "required":["ChangeSetName"], - "members":{ - "ChangeSetName":{ - "shape":"ChangeSetNameOrId", - "documentation":"

The name or ARN of the change set that you want use to update the specified stack.

" - }, - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

If you specified the name of a change set, specify the stack name or ID (ARN) that is associated with the change set you want to execute.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this ExecuteChangeSet request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to execute a change set to update a stack with the same name. You might retry ExecuteChangeSet requests to ensure that AWS CloudFormation successfully received them.

" - } - }, - "documentation":"

The input for the ExecuteChangeSet action.

" - }, - "ExecuteChangeSetOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the ExecuteChangeSet action.

" - }, - "ExecutionRoleName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z_0-9+=,.@-]+" - }, - "ExecutionStatus":{ - "type":"string", - "enum":[ - "UNAVAILABLE", - "AVAILABLE", - "EXECUTE_IN_PROGRESS", - "EXECUTE_COMPLETE", - "EXECUTE_FAILED", - "OBSOLETE" - ] - }, - "Export":{ - "type":"structure", - "members":{ - "ExportingStackId":{ - "shape":"StackId", - "documentation":"

The stack that contains the exported output name and value.

" - }, - "Name":{ - "shape":"ExportName", - "documentation":"

The name of exported output value. Use this name and the Fn::ImportValue function to import the associated value into other stacks. The name is defined in the Export field in the associated stack's Outputs section.

" - }, - "Value":{ - "shape":"ExportValue", - "documentation":"

The value of the exported output, such as a resource physical ID. This value is defined in the Export field in the associated stack's Outputs section.

" - } - }, - "documentation":"

The Export structure describes the exported output values for a stack.

" - }, - "ExportName":{"type":"string"}, - "ExportValue":{"type":"string"}, - "Exports":{ - "type":"list", - "member":{"shape":"Export"} - }, - "FailureToleranceCount":{ - "type":"integer", - "min":0 - }, - "FailureTolerancePercentage":{ - "type":"integer", - "max":100, - "min":0 - }, - "GetStackPolicyInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or unique stack ID that is associated with the stack whose policy you want to get.

" - } - }, - "documentation":"

The input for the GetStackPolicy action.

" - }, - "GetStackPolicyOutput":{ - "type":"structure", - "members":{ - "StackPolicyBody":{ - "shape":"StackPolicyBody", - "documentation":"

Structure containing the stack policy body. (For more information, go to Prevent Updates to Stack Resources in the AWS CloudFormation User Guide.)

" - } - }, - "documentation":"

The output for the GetStackPolicy action.

" - }, - "GetTemplateInput":{ - "type":"structure", - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

" - }, - "ChangeSetName":{ - "shape":"ChangeSetNameOrId", - "documentation":"

The name or Amazon Resource Name (ARN) of a change set for which AWS CloudFormation returns the associated template. If you specify a name, you must also specify the StackName.

" - }, - "TemplateStage":{ - "shape":"TemplateStage", - "documentation":"

For templates that include transforms, the stage of the template that AWS CloudFormation returns. To get the user-submitted template, specify Original. To get the template after AWS CloudFormation has processed all transforms, specify Processed.

If the template doesn't include transforms, Original and Processed return the same template. By default, AWS CloudFormation specifies Original.

" - } - }, - "documentation":"

The input for a GetTemplate action.

" - }, - "GetTemplateOutput":{ - "type":"structure", - "members":{ - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body. (For more information, go to Template Anatomy in the AWS CloudFormation User Guide.)

AWS CloudFormation returns the same template that was used when the stack was created.

" - }, - "StagesAvailable":{ - "shape":"StageList", - "documentation":"

The stage of the template that you can retrieve. For stacks, the Original and Processed templates are always available. For change sets, the Original template is always available. After AWS CloudFormation finishes creating the change set, the Processed template becomes available.

" - } - }, - "documentation":"

The output for GetTemplate action.

" - }, - "GetTemplateSummaryInput":{ - "type":"structure", - "members":{ - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information about templates, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify only one of the following parameters: StackName, StackSetName, TemplateBody, or TemplateURL.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information about templates, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify only one of the following parameters: StackName, StackSetName, TemplateBody, or TemplateURL.

" - }, - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The name or the stack ID that is associated with the stack, which are not always interchangeable. For running stacks, you can specify either the stack's name or its unique stack ID. For deleted stack, you must specify the unique stack ID.

Conditional: You must specify only one of the following parameters: StackName, StackSetName, TemplateBody, or TemplateURL.

" - }, - "StackSetName":{ - "shape":"StackSetNameOrId", - "documentation":"

The name or unique ID of the stack set from which the stack was created.

Conditional: You must specify only one of the following parameters: StackName, StackSetName, TemplateBody, or TemplateURL.

" - } - }, - "documentation":"

The input for the GetTemplateSummary action.

" - }, - "GetTemplateSummaryOutput":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParameterDeclarations", - "documentation":"

A list of parameter declarations that describe various properties for each parameter.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The value that is defined in the Description property of the template.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the CreateStack or UpdateStack actions with your template; otherwise, those actions return an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "CapabilitiesReason":{ - "shape":"CapabilitiesReason", - "documentation":"

The list of resources that generated the values in the Capabilities response element.

" - }, - "ResourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

A list of all the template resource types that are defined in the template, such as AWS::EC2::Instance, AWS::Dynamo::Table, and Custom::MyCustomInstance.

" - }, - "Version":{ - "shape":"Version", - "documentation":"

The AWS template format version, which identifies the capabilities of the template.

" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

The value that is defined for the Metadata property of the template.

" - }, - "DeclaredTransforms":{ - "shape":"TransformsList", - "documentation":"

A list of the transforms that are declared in the template.

" - } - }, - "documentation":"

The output for the GetTemplateSummary action.

" - }, - "Imports":{ - "type":"list", - "member":{"shape":"StackName"} - }, - "InsufficientCapabilitiesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The template contains resources with capabilities that weren't specified in the Capabilities parameter.

", - "error":{ - "code":"InsufficientCapabilitiesException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidChangeSetStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified change set can't be used to update the stack. For example, the change set status might be CREATE_IN_PROGRESS, or the stack status might be UPDATE_IN_PROGRESS.

", - "error":{ - "code":"InvalidChangeSetStatus", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified operation isn't valid.

", - "error":{ - "code":"InvalidOperationException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LastUpdatedTime":{"type":"timestamp"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for the resource has already been reached.

For information on stack set limitations, see Limitations of StackSets.

", - "error":{ - "code":"LimitExceededException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LimitName":{"type":"string"}, - "LimitValue":{"type":"integer"}, - "ListChangeSetsInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The name or the Amazon Resource Name (ARN) of the stack for which you want to list change sets.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string (provided by the ListChangeSets response output) that identifies the next page of change sets that you want to retrieve.

" - } - }, - "documentation":"

The input for the ListChangeSets action.

" - }, - "ListChangeSetsOutput":{ - "type":"structure", - "members":{ - "Summaries":{ - "shape":"ChangeSetSummaries", - "documentation":"

A list of ChangeSetSummary structures that provides the ID and status of each change set for the specified stack.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB, a string that identifies the next page of change sets. If there is no additional page, this value is null.

" - } - }, - "documentation":"

The output for the ListChangeSets action.

" - }, - "ListExportsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string (provided by the ListExports response output) that identifies the next page of exported output values that you asked to retrieve.

" - } - } - }, - "ListExportsOutput":{ - "type":"structure", - "members":{ - "Exports":{ - "shape":"Exports", - "documentation":"

The output for the ListExports action.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 100 exported output values, a string that identifies the next page of exports. If there is no additional page, this value is null.

" - } - } - }, - "ListImportsInput":{ - "type":"structure", - "required":["ExportName"], - "members":{ - "ExportName":{ - "shape":"ExportName", - "documentation":"

The name of the exported output value. AWS CloudFormation returns the stack names that are importing this value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string (provided by the ListImports response output) that identifies the next page of stacks that are importing the specified exported output value.

" - } - } - }, - "ListImportsOutput":{ - "type":"structure", - "members":{ - "Imports":{ - "shape":"Imports", - "documentation":"

A list of stack names that are importing the specified exported output value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of exports. If there is no additional page, this value is null.

" - } - } - }, - "ListStackInstancesInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to list stack instances for.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the previous request didn't return all of the remaining results, the response's NextToken parameter value is set to a token. To retrieve the next set of results, call ListStackInstances again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - }, - "StackInstanceAccount":{ - "shape":"Account", - "documentation":"

The name of the AWS account that you want to list stack instances for.

" - }, - "StackInstanceRegion":{ - "shape":"Region", - "documentation":"

The name of the region where you want to list stack instances.

" - } - } - }, - "ListStackInstancesOutput":{ - "type":"structure", - "members":{ - "Summaries":{ - "shape":"StackInstanceSummaries", - "documentation":"

A list of StackInstanceSummary structures that contain information about the specified stack instances.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the request doesn't return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListStackInstances again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.

" - } - } - }, - "ListStackResourcesInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of stack resources that you want to retrieve.

" - } - }, - "documentation":"

The input for the ListStackResource action.

" - }, - "ListStackResourcesOutput":{ - "type":"structure", - "members":{ - "StackResourceSummaries":{ - "shape":"StackResourceSummaries", - "documentation":"

A list of StackResourceSummary structures.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB, a string that identifies the next page of stack resources. If no additional page exists, this value is null.

" - } - }, - "documentation":"

The output for a ListStackResources action.

" - }, - "ListStackSetOperationResultsInput":{ - "type":"structure", - "required":[ - "StackSetName", - "OperationId" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to get operation results for.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The ID of the stack set operation.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the previous request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call ListStackSetOperationResults again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "ListStackSetOperationResultsOutput":{ - "type":"structure", - "members":{ - "Summaries":{ - "shape":"StackSetOperationResultSummaries", - "documentation":"

A list of StackSetOperationResultSummary structures that contain information about the specified operation results, for accounts and regions that are included in the operation.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the request doesn't return all results, NextToken is set to a token. To retrieve the next set of results, call ListOperationResults again and assign that token to the request object's NextToken parameter. If there are no remaining results, NextToken is set to null.

" - } - } - }, - "ListStackSetOperationsInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to get operation summaries for.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the previous paginated request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call ListStackSetOperations again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "ListStackSetOperationsOutput":{ - "type":"structure", - "members":{ - "Summaries":{ - "shape":"StackSetOperationSummaries", - "documentation":"

A list of StackSetOperationSummary structures that contain summary information about operations for the specified stack set.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the request doesn't return all results, NextToken is set to a token. To retrieve the next set of results, call ListOperationResults again and assign that token to the request object's NextToken parameter. If there are no remaining results, NextToken is set to null.

" - } - } - }, - "ListStackSetsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the previous paginated request didn't return all of the remaining results, the response object's NextToken parameter value is set to a token. To retrieve the next set of results, call ListStackSets again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - }, - "Status":{ - "shape":"StackSetStatus", - "documentation":"

The status of the stack sets that you want to get summary information about.

" - } - } - }, - "ListStackSetsOutput":{ - "type":"structure", - "members":{ - "Summaries":{ - "shape":"StackSetSummaries", - "documentation":"

A list of StackSetSummary structures that contain information about the user's stack sets.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the request doesn't return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListStackInstances again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.

" - } - } - }, - "ListStacksInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string that identifies the next page of stacks that you want to retrieve.

" - }, - "StackStatusFilter":{ - "shape":"StackStatusFilter", - "documentation":"

Stack status to use as a filter. Specify one or more stack status codes to list only stacks with the specified status codes. For a complete list of stack status codes, see the StackStatus parameter of the Stack data type.

" - } - }, - "documentation":"

The input for ListStacks action.

" - }, - "ListStacksOutput":{ - "type":"structure", - "members":{ - "StackSummaries":{ - "shape":"StackSummaries", - "documentation":"

A list of StackSummary structures containing information about the specified stacks.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null.

" - } - }, - "documentation":"

The output for ListStacks action.

" - }, - "LogicalResourceId":{"type":"string"}, - "MaxConcurrentCount":{ - "type":"integer", - "min":1 - }, - "MaxConcurrentPercentage":{ - "type":"integer", - "max":100, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "Metadata":{"type":"string"}, - "MonitoringTimeInMinutes":{ - "type":"integer", - "max":180, - "min":0 - }, - "NameAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified name is already in use.

", - "error":{ - "code":"NameAlreadyExistsException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "NoEcho":{"type":"boolean"}, - "NotificationARN":{"type":"string"}, - "NotificationARNs":{ - "type":"list", - "member":{"shape":"NotificationARN"}, - "max":5 - }, - "OnFailure":{ - "type":"string", - "enum":[ - "DO_NOTHING", - "ROLLBACK", - "DELETE" - ] - }, - "OperationIdAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified operation ID already exists.

", - "error":{ - "code":"OperationIdAlreadyExistsException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "OperationInProgressException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Another operation is currently in progress for this stack set. Only one operation can be performed for a stack set at a given time.

", - "error":{ - "code":"OperationInProgressException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "OperationNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified ID refers to an operation that doesn't exist.

", - "error":{ - "code":"OperationNotFoundException", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "Output":{ - "type":"structure", - "members":{ - "OutputKey":{ - "shape":"OutputKey", - "documentation":"

The key associated with the output.

" - }, - "OutputValue":{ - "shape":"OutputValue", - "documentation":"

The value associated with the output.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

User defined description associated with the output.

" - }, - "ExportName":{ - "shape":"ExportName", - "documentation":"

The name of the export associated with the output.

" - } - }, - "documentation":"

The Output data type.

" - }, - "OutputKey":{"type":"string"}, - "OutputValue":{"type":"string"}, - "Outputs":{ - "type":"list", - "member":{"shape":"Output"} - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterKey":{ - "shape":"ParameterKey", - "documentation":"

The key associated with the parameter. If you don't specify a key and value for a particular parameter, AWS CloudFormation uses the default value that is specified in your template.

" - }, - "ParameterValue":{ - "shape":"ParameterValue", - "documentation":"

The input value associated with the parameter.

" - }, - "UsePreviousValue":{ - "shape":"UsePreviousValue", - "documentation":"

During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify true, do not specify a parameter value.

" - }, - "ResolvedValue":{ - "shape":"ParameterValue", - "documentation":"

Read-only. The value that corresponds to a Systems Manager parameter key. This field is returned only for SSM parameter types in the template.

" - } - }, - "documentation":"

The Parameter data type.

" - }, - "ParameterConstraints":{ - "type":"structure", - "members":{ - "AllowedValues":{ - "shape":"AllowedValues", - "documentation":"

A list of values that are permitted for a parameter.

" - } - }, - "documentation":"

A set of criteria that AWS CloudFormation uses to validate parameter values. Although other constraints might be defined in the stack template, AWS CloudFormation returns only the AllowedValues property.

" - }, - "ParameterDeclaration":{ - "type":"structure", - "members":{ - "ParameterKey":{ - "shape":"ParameterKey", - "documentation":"

The name that is associated with the parameter.

" - }, - "DefaultValue":{ - "shape":"ParameterValue", - "documentation":"

The default value of the parameter.

" - }, - "ParameterType":{ - "shape":"ParameterType", - "documentation":"

The type of parameter.

" - }, - "NoEcho":{ - "shape":"NoEcho", - "documentation":"

Flag that indicates whether the parameter value is shown as plain text in logs and in the AWS Management Console.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description that is associate with the parameter.

" - }, - "ParameterConstraints":{ - "shape":"ParameterConstraints", - "documentation":"

The criteria that AWS CloudFormation uses to validate parameter values.

" - } - }, - "documentation":"

The ParameterDeclaration data type.

" - }, - "ParameterDeclarations":{ - "type":"list", - "member":{"shape":"ParameterDeclaration"} - }, - "ParameterKey":{"type":"string"}, - "ParameterType":{"type":"string"}, - "ParameterValue":{"type":"string"}, - "Parameters":{ - "type":"list", - "member":{"shape":"Parameter"} - }, - "PhysicalResourceId":{"type":"string"}, - "PropertyName":{"type":"string"}, - "Reason":{"type":"string"}, - "Region":{"type":"string"}, - "RegionList":{ - "type":"list", - "member":{"shape":"Region"} - }, - "Replacement":{ - "type":"string", - "enum":[ - "True", - "False", - "Conditional" - ] - }, - "RequiresRecreation":{ - "type":"string", - "enum":[ - "Never", - "Conditionally", - "Always" - ] - }, - "ResourceAttribute":{ - "type":"string", - "enum":[ - "Properties", - "Metadata", - "CreationPolicy", - "UpdatePolicy", - "DeletionPolicy", - "Tags" - ] - }, - "ResourceChange":{ - "type":"structure", - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), or Remove (deletes a resource).

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The resource's logical ID, which is defined in the stack's template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The resource's physical ID (resource name). Resources that you are adding don't have physical IDs because they haven't been created.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of AWS CloudFormation resource, such as AWS::S3::Bucket.

" - }, - "Replacement":{ - "shape":"Replacement", - "documentation":"

For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the RequiresRecreation property in the ResourceTargetDefinition structure. For example, if the RequiresRecreation field is Always and the Evaluation field is Static, Replacement is True. If the RequiresRecreation field is Always and the Evaluation field is Dynamic, Replacement is Conditionally.

If you have multiple changes with different RequiresRecreation values, the Replacement value depends on the change with the most impact. A RequiresRecreation value of Always has the most impact, followed by Conditionally, and then Never.

" - }, - "Scope":{ - "shape":"Scope", - "documentation":"

For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.

" - }, - "Details":{ - "shape":"ResourceChangeDetails", - "documentation":"

For the Modify action, a list of ResourceChangeDetail structures that describes the changes that AWS CloudFormation will make to the resource.

" - } - }, - "documentation":"

The ResourceChange structure describes the resource and the action that AWS CloudFormation will perform on it if you execute this change set.

" - }, - "ResourceChangeDetail":{ - "type":"structure", - "members":{ - "Target":{ - "shape":"ResourceTargetDefinition", - "documentation":"

A ResourceTargetDefinition structure that describes the field that AWS CloudFormation will change and whether the resource will be recreated.

" - }, - "Evaluation":{ - "shape":"EvaluationType", - "documentation":"

Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set.

For Static evaluations, AWS CloudFormation can determine that the target value will change, and its value. For example, if you directly modify the InstanceType property of an EC2 instance, AWS CloudFormation knows that this property value will change, and its value, so this is a Static evaluation.

For Dynamic evaluations, cannot determine the target value because it depends on the result of an intrinsic function, such as a Ref or Fn::GetAtt intrinsic function, when the stack is updated. For example, if your template includes a reference to a resource that is conditionally recreated, the value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID, so all references to that resource will also be updated.

" - }, - "ChangeSource":{ - "shape":"ChangeSource", - "documentation":"

The group to which the CausingEntity value belongs. There are five entity groups:

  • ResourceReference entities are Ref intrinsic functions that refer to resources in the template, such as { \"Ref\" : \"MyEC2InstanceResource\" }.

  • ParameterReference entities are Ref intrinsic functions that get template parameter values, such as { \"Ref\" : \"MyPasswordParameter\" }.

  • ResourceAttribute entities are Fn::GetAtt intrinsic functions that get resource attribute values, such as { \"Fn::GetAtt\" : [ \"MyEC2InstanceResource\", \"PublicDnsName\" ] }.

  • DirectModification entities are changes that are made directly to the template.

  • Automatic entities are AWS::CloudFormation::Stack resource types, which are also known as nested stacks. If you made no changes to the AWS::CloudFormation::Stack resource, AWS CloudFormation sets the ChangeSource to Automatic because the nested stack's template might have changed. Changes to a nested stack's template aren't visible to AWS CloudFormation until you run an update on the parent stack.

" - }, - "CausingEntity":{ - "shape":"CausingEntity", - "documentation":"

The identity of the entity that triggered this change. This entity is a member of the group that is specified by the ChangeSource field. For example, if you modified the value of the KeyPairName parameter, the CausingEntity is the name of the parameter (KeyPairName).

If the ChangeSource value is DirectModification, no value is given for CausingEntity.

" - } - }, - "documentation":"

For a resource with Modify as the action, the ResourceChange structure describes the changes AWS CloudFormation will make to that resource.

" - }, - "ResourceChangeDetails":{ - "type":"list", - "member":{"shape":"ResourceChangeDetail"} - }, - "ResourceProperties":{"type":"string"}, - "ResourceSignalStatus":{ - "type":"string", - "enum":[ - "SUCCESS", - "FAILURE" - ] - }, - "ResourceSignalUniqueId":{ - "type":"string", - "max":64, - "min":1 - }, - "ResourceStatus":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "CREATE_FAILED", - "CREATE_COMPLETE", - "DELETE_IN_PROGRESS", - "DELETE_FAILED", - "DELETE_COMPLETE", - "DELETE_SKIPPED", - "UPDATE_IN_PROGRESS", - "UPDATE_FAILED", - "UPDATE_COMPLETE" - ] - }, - "ResourceStatusReason":{"type":"string"}, - "ResourceTargetDefinition":{ - "type":"structure", - "members":{ - "Attribute":{ - "shape":"ResourceAttribute", - "documentation":"

Indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.

" - }, - "Name":{ - "shape":"PropertyName", - "documentation":"

If the Attribute value is Properties, the name of the property. For all other attributes, the value is null.

" - }, - "RequiresRecreation":{ - "shape":"RequiresRecreation", - "documentation":"

If the Attribute value is Properties, indicates whether a change to this property causes the resource to be recreated. The value can be Never, Always, or Conditionally. To determine the conditions for a Conditionally recreation, see the update behavior for that property in the AWS CloudFormation User Guide.

" - } - }, - "documentation":"

The field that AWS CloudFormation will change, such as the name of a resource's property, and whether the resource will be recreated.

" - }, - "ResourceToSkip":{ - "type":"string", - "pattern":"[a-zA-Z0-9]+|[a-zA-Z][-a-zA-Z0-9]*\\.[a-zA-Z0-9]+" - }, - "ResourceType":{ - "type":"string", - "max":256, - "min":1 - }, - "ResourceTypes":{ - "type":"list", - "member":{"shape":"ResourceType"} - }, - "ResourcesToSkip":{ - "type":"list", - "member":{"shape":"ResourceToSkip"} - }, - "RetainResources":{ - "type":"list", - "member":{"shape":"LogicalResourceId"} - }, - "RetainStacks":{"type":"boolean"}, - "RetainStacksNullable":{"type":"boolean"}, - "RoleARN":{ - "type":"string", - "max":2048, - "min":20 - }, - "RollbackConfiguration":{ - "type":"structure", - "members":{ - "RollbackTriggers":{ - "shape":"RollbackTriggers", - "documentation":"

The triggers to monitor during stack creation or update actions.

By default, AWS CloudFormation saves the rollback triggers specified for a stack and applies them to any subsequent update operations for the stack, unless you specify otherwise. If you do specify rollback triggers for this parameter, those triggers replace any list of triggers previously specified for the stack. This means:

  • To use the rollback triggers previously specified for this stack, if any, don't specify this parameter.

  • To specify new or updated rollback triggers, you must specify all the triggers that you want used for this stack, even triggers you've specifed before (for example, when creating the stack or during a previous stack update). Any triggers that you don't include in the updated list of triggers are no longer applied to the stack.

  • To remove all currently specified triggers, specify an empty list for this parameter.

If a specified trigger is missing, the entire stack operation fails and is rolled back.

" - }, - "MonitoringTimeInMinutes":{ - "shape":"MonitoringTimeInMinutes", - "documentation":"

The amount of time, in minutes, during which CloudFormation should monitor all the rollback triggers after the stack creation or update operation deploys all necessary resources.

The default is 0 minutes.

If you specify a monitoring period but do not specify any rollback triggers, CloudFormation still waits the specified period of time before cleaning up old resources after update operations. You can use this monitoring period to perform any manual stack validation desired, and manually cancel the stack creation or update (using CancelUpdateStack, for example) as necessary.

If you specify 0 for this parameter, CloudFormation still monitors the specified rollback triggers during stack creation and update operations. Then, for update operations, it begins disposing of old resources immediately once the operation completes.

" - } - }, - "documentation":"

Structure containing the rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

Rollback triggers enable you to have AWS CloudFormation monitor the state of your application during stack creation and updating, and to roll back that operation if the application breaches the threshold of any of the alarms you've specified. For more information, see Monitor and Roll Back Stack Operations.

" - }, - "RollbackTrigger":{ - "type":"structure", - "required":[ - "Arn", - "Type" - ], - "members":{ - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the rollback trigger.

If a specified trigger is missing, the entire stack operation fails and is rolled back.

" - }, - "Type":{ - "shape":"Type", - "documentation":"

The resource type of the rollback trigger. Currently, AWS::CloudWatch::Alarm is the only supported resource type.

" - } - }, - "documentation":"

A rollback trigger AWS CloudFormation monitors during creation and updating of stacks. If any of the alarms you specify goes to ALARM state during the stack operation or within the specified monitoring period afterwards, CloudFormation rolls back the entire stack operation.

" - }, - "RollbackTriggers":{ - "type":"list", - "member":{"shape":"RollbackTrigger"}, - "max":5 - }, - "Scope":{ - "type":"list", - "member":{"shape":"ResourceAttribute"} - }, - "SetStackPolicyInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or unique stack ID that you want to associate a policy with.

" - }, - "StackPolicyBody":{ - "shape":"StackPolicyBody", - "documentation":"

Structure containing the stack policy body. For more information, go to Prevent Updates to Stack Resources in the AWS CloudFormation User Guide. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

" - }, - "StackPolicyURL":{ - "shape":"StackPolicyURL", - "documentation":"

Location of a file containing the stack policy. The URL must point to a policy (maximum size: 16 KB) located in an S3 bucket in the same region as the stack. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

" - } - }, - "documentation":"

The input for the SetStackPolicy action.

" - }, - "SignalResourceInput":{ - "type":"structure", - "required":[ - "StackName", - "LogicalResourceId", - "UniqueId", - "Status" - ], - "members":{ - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The stack name or unique stack ID that includes the resource that you want to signal.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical ID of the resource that you want to signal. The logical ID is the name of the resource that given in the template.

" - }, - "UniqueId":{ - "shape":"ResourceSignalUniqueId", - "documentation":"

A unique ID of the signal. When you signal Amazon EC2 instances or Auto Scaling groups, specify the instance ID that you are signaling as the unique ID. If you send multiple signals to a single resource (such as signaling a wait condition), each signal requires a different unique ID.

" - }, - "Status":{ - "shape":"ResourceSignalStatus", - "documentation":"

The status of the signal, which is either success or failure. A failure signal causes AWS CloudFormation to immediately fail the stack creation or update.

" - } - }, - "documentation":"

The input for the SignalResource action.

" - }, - "Stack":{ - "type":"structure", - "required":[ - "StackName", - "CreationTime", - "StackStatus" - ], - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

Unique identifier of the stack.

" - }, - "StackName":{ - "shape":"StackName", - "documentation":"

The name associated with the stack.

" - }, - "ChangeSetId":{ - "shape":"ChangeSetId", - "documentation":"

The unique ID of the change set.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A user-defined description associated with the stack.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

The time at which the stack was created.

" - }, - "DeletionTime":{ - "shape":"DeletionTime", - "documentation":"

The time the stack was deleted.

" - }, - "LastUpdatedTime":{ - "shape":"LastUpdatedTime", - "documentation":"

The time the stack was last updated. This field will only be returned if the stack has been updated at least once.

" - }, - "RollbackConfiguration":{ - "shape":"RollbackConfiguration", - "documentation":"

The rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

" - }, - "StackStatus":{ - "shape":"StackStatus", - "documentation":"

Current status of the stack.

" - }, - "StackStatusReason":{ - "shape":"StackStatusReason", - "documentation":"

Success/failure message associated with the stack status.

" - }, - "DisableRollback":{ - "shape":"DisableRollback", - "documentation":"

Boolean to enable or disable rollback on stack creation failures:

  • true: disable rollback

  • false: enable rollback

" - }, - "NotificationARNs":{ - "shape":"NotificationARNs", - "documentation":"

SNS topic ARNs to which stack related events are published.

" - }, - "TimeoutInMinutes":{ - "shape":"TimeoutMinutes", - "documentation":"

The amount of time within which stack creation should complete.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

The capabilities allowed in the stack.

" - }, - "Outputs":{ - "shape":"Outputs", - "documentation":"

A list of output structures.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that is associated with the stack. During a stack operation, AWS CloudFormation uses this role's credentials to make calls on your behalf.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A list of Tags that specify information about the stack.

" - }, - "EnableTerminationProtection":{ - "shape":"EnableTerminationProtection", - "documentation":"

Whether termination protection is enabled for the stack.

For nested stacks, termination protection is set on the root stack and cannot be changed directly on the nested stack. For more information, see Protecting a Stack From Being Deleted in the AWS CloudFormation User Guide.

" - }, - "ParentId":{ - "shape":"StackId", - "documentation":"

For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this stack. For the first level of nested stacks, the root stack is also the parent stack.

For more information, see Working with Nested Stacks in the AWS CloudFormation User Guide.

" - }, - "RootId":{ - "shape":"StackId", - "documentation":"

For nested stacks--stacks created as resources for another stack--the stack ID of the the top-level stack to which the nested stack ultimately belongs.

For more information, see Working with Nested Stacks in the AWS CloudFormation User Guide.

" - } - }, - "documentation":"

The Stack data type.

" - }, - "StackEvent":{ - "type":"structure", - "required":[ - "StackId", - "EventId", - "StackName", - "Timestamp" - ], - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

The unique ID name of the instance of the stack.

" - }, - "EventId":{ - "shape":"EventId", - "documentation":"

The unique ID of this event.

" - }, - "StackName":{ - "shape":"StackName", - "documentation":"

The name associated with a stack.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource specified in the template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The name or unique identifier associated with the physical instance of the resource.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

Type of resource. (For more information, go to AWS Resource Types Reference in the AWS CloudFormation User Guide.)

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time the status was updated.

" - }, - "ResourceStatus":{ - "shape":"ResourceStatus", - "documentation":"

Current status of the resource.

" - }, - "ResourceStatusReason":{ - "shape":"ResourceStatusReason", - "documentation":"

Success/failure message associated with the resource.

" - }, - "ResourceProperties":{ - "shape":"ResourceProperties", - "documentation":"

BLOB of the properties used to create the resource.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

The token passed to the operation that generated this event.

All events triggered by a given stack operation are assigned the same client request token, which you can use to track operations. For example, if you execute a CreateStack operation with the token token1, then all the StackEvents generated by that operation will have ClientRequestToken set as token1.

In the console, stack operations display the client request token on the Events tab. Stack operations that are initiated from the console use the token format Console-StackOperation-ID, which helps you easily identify the stack operation . For example, if you create a stack using the console, each stack event would be assigned the same token in the following format: Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

" - } - }, - "documentation":"

The StackEvent data type.

" - }, - "StackEvents":{ - "type":"list", - "member":{"shape":"StackEvent"} - }, - "StackId":{"type":"string"}, - "StackInstance":{ - "type":"structure", - "members":{ - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The name or unique ID of the stack set that the stack instance is associated with.

" - }, - "Region":{ - "shape":"Region", - "documentation":"

The name of the AWS region that the stack instance is associated with.

" - }, - "Account":{ - "shape":"Account", - "documentation":"

The name of the AWS account that the stack instance is associated with.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

The ID of the stack instance.

" - }, - "ParameterOverrides":{ - "shape":"Parameters", - "documentation":"

A list of parameters from the stack set template whose values have been overridden in this stack instance.

" - }, - "Status":{ - "shape":"StackInstanceStatus", - "documentation":"

The status of the stack instance, in terms of its synchronization with its associated stack set.

  • INOPERABLE: A DeleteStackInstances operation has failed and left the stack in an unstable state. Stacks in this state are excluded from further UpdateStackSet operations. You might need to perform a DeleteStackInstances operation, with RetainStacks set to true, to delete the stack instance, and then delete the stack manually.

  • OUTDATED: The stack isn't currently up to date with the stack set because:

    • The associated stack failed during a CreateStackSet or UpdateStackSet operation.

    • The stack was part of a CreateStackSet or UpdateStackSet operation that failed or was stopped before the stack was created or updated.

  • CURRENT: The stack is currently up to date with the stack set.

" - }, - "StatusReason":{ - "shape":"Reason", - "documentation":"

The explanation for the specific status code that is assigned to this stack instance.

" - } - }, - "documentation":"

An AWS CloudFormation stack, in a specific account and region, that's part of a stack set operation. A stack instance is a reference to an attempted or actual stack in a given account within a given region. A stack instance can exist without a stack—for example, if the stack couldn't be created for some reason. A stack instance is associated with only one stack set. Each stack instance contains the ID of its associated stack set, as well as the ID of the actual stack and the stack status.

" - }, - "StackInstanceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified stack instance doesn't exist.

", - "error":{ - "code":"StackInstanceNotFoundException", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "StackInstanceStatus":{ - "type":"string", - "enum":[ - "CURRENT", - "OUTDATED", - "INOPERABLE" - ] - }, - "StackInstanceSummaries":{ - "type":"list", - "member":{"shape":"StackInstanceSummary"} - }, - "StackInstanceSummary":{ - "type":"structure", - "members":{ - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The name or unique ID of the stack set that the stack instance is associated with.

" - }, - "Region":{ - "shape":"Region", - "documentation":"

The name of the AWS region that the stack instance is associated with.

" - }, - "Account":{ - "shape":"Account", - "documentation":"

The name of the AWS account that the stack instance is associated with.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

The ID of the stack instance.

" - }, - "Status":{ - "shape":"StackInstanceStatus", - "documentation":"

The status of the stack instance, in terms of its synchronization with its associated stack set.

  • INOPERABLE: A DeleteStackInstances operation has failed and left the stack in an unstable state. Stacks in this state are excluded from further UpdateStackSet operations. You might need to perform a DeleteStackInstances operation, with RetainStacks set to true, to delete the stack instance, and then delete the stack manually.

  • OUTDATED: The stack isn't currently up to date with the stack set because:

    • The associated stack failed during a CreateStackSet or UpdateStackSet operation.

    • The stack was part of a CreateStackSet or UpdateStackSet operation that failed or was stopped before the stack was created or updated.

  • CURRENT: The stack is currently up to date with the stack set.

" - }, - "StatusReason":{ - "shape":"Reason", - "documentation":"

The explanation for the specific status code assigned to this stack instance.

" - } - }, - "documentation":"

The structure that contains summary information about a stack instance.

" - }, - "StackName":{"type":"string"}, - "StackNameOrId":{ - "type":"string", - "min":1, - "pattern":"([a-zA-Z][-a-zA-Z0-9]*)|(arn:\\b(aws|aws-us-gov|aws-cn)\\b:[-a-zA-Z0-9:/._+]*)" - }, - "StackPolicyBody":{ - "type":"string", - "max":16384, - "min":1 - }, - "StackPolicyDuringUpdateBody":{ - "type":"string", - "max":16384, - "min":1 - }, - "StackPolicyDuringUpdateURL":{ - "type":"string", - "max":1350, - "min":1 - }, - "StackPolicyURL":{ - "type":"string", - "max":1350, - "min":1 - }, - "StackResource":{ - "type":"structure", - "required":[ - "LogicalResourceId", - "ResourceType", - "Timestamp", - "ResourceStatus" - ], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name associated with the stack.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

Unique identifier of the stack.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource specified in the template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

Type of resource. (For more information, go to AWS Resource Types Reference in the AWS CloudFormation User Guide.)

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time the status was updated.

" - }, - "ResourceStatus":{ - "shape":"ResourceStatus", - "documentation":"

Current status of the resource.

" - }, - "ResourceStatusReason":{ - "shape":"ResourceStatusReason", - "documentation":"

Success/failure message associated with the resource.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

User defined description associated with the resource.

" - } - }, - "documentation":"

The StackResource data type.

" - }, - "StackResourceDetail":{ - "type":"structure", - "required":[ - "LogicalResourceId", - "ResourceType", - "LastUpdatedTimestamp", - "ResourceStatus" - ], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name associated with the stack.

" - }, - "StackId":{ - "shape":"StackId", - "documentation":"

Unique identifier of the stack.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource specified in the template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The name or unique identifier that corresponds to a physical instance ID of a resource supported by AWS CloudFormation.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

Type of resource. ((For more information, go to AWS Resource Types Reference in the AWS CloudFormation User Guide.)

" - }, - "LastUpdatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

Time the status was updated.

" - }, - "ResourceStatus":{ - "shape":"ResourceStatus", - "documentation":"

Current status of the resource.

" - }, - "ResourceStatusReason":{ - "shape":"ResourceStatusReason", - "documentation":"

Success/failure message associated with the resource.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

User defined description associated with the resource.

" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

The content of the Metadata attribute declared for the resource. For more information, see Metadata Attribute in the AWS CloudFormation User Guide.

" - } - }, - "documentation":"

Contains detailed information about the specified stack resource.

" - }, - "StackResourceSummaries":{ - "type":"list", - "member":{"shape":"StackResourceSummary"} - }, - "StackResourceSummary":{ - "type":"structure", - "required":[ - "LogicalResourceId", - "ResourceType", - "LastUpdatedTimestamp", - "ResourceStatus" - ], - "members":{ - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The logical name of the resource specified in the template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The name or unique identifier that corresponds to a physical instance ID of the resource.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

Type of resource. (For more information, go to AWS Resource Types Reference in the AWS CloudFormation User Guide.)

" - }, - "LastUpdatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

Time the status was updated.

" - }, - "ResourceStatus":{ - "shape":"ResourceStatus", - "documentation":"

Current status of the resource.

" - }, - "ResourceStatusReason":{ - "shape":"ResourceStatusReason", - "documentation":"

Success/failure message associated with the resource.

" - } - }, - "documentation":"

Contains high-level information about the specified stack resource.

" - }, - "StackResources":{ - "type":"list", - "member":{"shape":"StackResource"} - }, - "StackSet":{ - "type":"structure", - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name that's associated with the stack set.

" - }, - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The ID of the stack set.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the stack set that you specify when the stack set is created or updated.

" - }, - "Status":{ - "shape":"StackSetStatus", - "documentation":"

The status of the stack set.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

The structure that contains the body of the template that was used to create or update the stack set.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of input parameters for a stack set.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

The capabilities that are allowed in the stack set. Some stack set templates might include resources that can affect permissions in your AWS account—for example, by creating new AWS Identity and Access Management (IAM) users. For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.

" - }, - "StackSetARN":{ - "shape":"StackSetARN", - "documentation":"

The Amazon Resource Number (ARN) of the stack set.

" - }, - "AdministrationRoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Number (ARN) of the IAM role used to create or update the stack set.

Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see Prerequisites: Granting Permissions for Stack Set Operations in the AWS CloudFormation User Guide.

" - }, - "ExecutionRoleName":{ - "shape":"ExecutionRoleName", - "documentation":"

The name of the IAM execution role used to create or update the stack set.

Use customized execution roles to control which stack resources users and groups can include in their stack sets.

" - } - }, - "documentation":"

A structure that contains information about a stack set. A stack set enables you to provision stacks into AWS accounts and across regions by using a single CloudFormation template. In the stack set, you specify the template to use, as well as any parameters and capabilities that the template requires.

" - }, - "StackSetARN":{"type":"string"}, - "StackSetId":{"type":"string"}, - "StackSetName":{"type":"string"}, - "StackSetNameOrId":{ - "type":"string", - "pattern":"[a-zA-Z][-a-zA-Z0-9]*(?::[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12})?" - }, - "StackSetNotEmptyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You can't yet delete this stack set, because it still contains one or more stack instances. Delete all stack instances from the stack set before deleting the stack set.

", - "error":{ - "code":"StackSetNotEmptyException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "StackSetNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified stack set doesn't exist.

", - "error":{ - "code":"StackSetNotFoundException", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "StackSetOperation":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique ID of a stack set operation.

" - }, - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The ID of the stack set.

" - }, - "Action":{ - "shape":"StackSetOperationAction", - "documentation":"

The type of stack set operation: CREATE, UPDATE, or DELETE. Create and delete operations affect only the specified stack set instances that are associated with the specified stack set. Update operations affect both the stack set itself, as well as all associated stack set instances.

" - }, - "Status":{ - "shape":"StackSetOperationStatus", - "documentation":"

The status of the operation.

  • FAILED: The operation exceeded the specified failure tolerance. The failure tolerance value that you've set for an operation is applied for each region during stack create and update operations. If the number of failed stacks within a region exceeds the failure tolerance, the status of the operation in the region is set to FAILED. This in turn sets the status of the operation as a whole to FAILED, and AWS CloudFormation cancels the operation in any remaining regions.

  • RUNNING: The operation is currently being performed.

  • STOPPED: The user has cancelled the operation.

  • STOPPING: The operation is in the process of stopping, at user request.

  • SUCCEEDED: The operation completed creating or updating all the specified stacks without exceeding the failure tolerance for the operation.

" - }, - "OperationPreferences":{ - "shape":"StackSetOperationPreferences", - "documentation":"

The preferences for how AWS CloudFormation performs this stack set operation.

" - }, - "RetainStacks":{ - "shape":"RetainStacksNullable", - "documentation":"

For stack set operations of action type DELETE, specifies whether to remove the stack instances from the specified stack set, but doesn't delete the stacks. You can't reassociate a retained stack, or add an existing, saved stack to a new stack set.

" - }, - "AdministrationRoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Number (ARN) of the IAM role used to perform this stack set operation.

Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see Define Permissions for Multiple Administrators in the AWS CloudFormation User Guide.

" - }, - "ExecutionRoleName":{ - "shape":"ExecutionRoleName", - "documentation":"

The name of the IAM execution role used to create or update the stack set.

Use customized execution roles to control which stack resources users and groups can include in their stack sets.

" - }, - "CreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which the operation was initiated. Note that the creation times for the stack set operation might differ from the creation time of the individual stacks themselves. This is because AWS CloudFormation needs to perform preparatory work for the operation, such as dispatching the work to the requested regions, before actually creating the first stacks.

" - }, - "EndTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which the stack set operation ended, across all accounts and regions specified. Note that this doesn't necessarily mean that the stack set operation was successful, or even attempted, in each account or region.

" - } - }, - "documentation":"

The structure that contains information about a stack set operation.

" - }, - "StackSetOperationAction":{ - "type":"string", - "enum":[ - "CREATE", - "UPDATE", - "DELETE" - ] - }, - "StackSetOperationPreferences":{ - "type":"structure", - "members":{ - "RegionOrder":{ - "shape":"RegionList", - "documentation":"

The order of the regions in where you want to perform the stack operation.

" - }, - "FailureToleranceCount":{ - "shape":"FailureToleranceCount", - "documentation":"

The number of accounts, per region, for which this operation can fail before AWS CloudFormation stops the operation in that region. If the operation is stopped in a region, AWS CloudFormation doesn't attempt the operation in any subsequent regions.

Conditional: You must specify either FailureToleranceCount or FailureTolerancePercentage (but not both).

" - }, - "FailureTolerancePercentage":{ - "shape":"FailureTolerancePercentage", - "documentation":"

The percentage of accounts, per region, for which this stack operation can fail before AWS CloudFormation stops the operation in that region. If the operation is stopped in a region, AWS CloudFormation doesn't attempt the operation in any subsequent regions.

When calculating the number of accounts based on the specified percentage, AWS CloudFormation rounds down to the next whole number.

Conditional: You must specify either FailureToleranceCount or FailureTolerancePercentage, but not both.

" - }, - "MaxConcurrentCount":{ - "shape":"MaxConcurrentCount", - "documentation":"

The maximum number of accounts in which to perform this operation at one time. This is dependent on the value of FailureToleranceCountMaxConcurrentCount is at most one more than the FailureToleranceCount .

Note that this setting lets you specify the maximum for operations. For large deployments, under certain circumstances the actual number of accounts acted upon concurrently may be lower due to service throttling.

Conditional: You must specify either MaxConcurrentCount or MaxConcurrentPercentage, but not both.

" - }, - "MaxConcurrentPercentage":{ - "shape":"MaxConcurrentPercentage", - "documentation":"

The maximum percentage of accounts in which to perform this operation at one time.

When calculating the number of accounts based on the specified percentage, AWS CloudFormation rounds down to the next whole number. This is true except in cases where rounding down would result is zero. In this case, CloudFormation sets the number as one instead.

Note that this setting lets you specify the maximum for operations. For large deployments, under certain circumstances the actual number of accounts acted upon concurrently may be lower due to service throttling.

Conditional: You must specify either MaxConcurrentCount or MaxConcurrentPercentage, but not both.

" - } - }, - "documentation":"

The user-specified preferences for how AWS CloudFormation performs a stack set operation.

For more information on maximum concurrent accounts and failure tolerance, see Stack set operation options.

" - }, - "StackSetOperationResultStatus":{ - "type":"string", - "enum":[ - "PENDING", - "RUNNING", - "SUCCEEDED", - "FAILED", - "CANCELLED" - ] - }, - "StackSetOperationResultSummaries":{ - "type":"list", - "member":{"shape":"StackSetOperationResultSummary"} - }, - "StackSetOperationResultSummary":{ - "type":"structure", - "members":{ - "Account":{ - "shape":"Account", - "documentation":"

The name of the AWS account for this operation result.

" - }, - "Region":{ - "shape":"Region", - "documentation":"

The name of the AWS region for this operation result.

" - }, - "Status":{ - "shape":"StackSetOperationResultStatus", - "documentation":"

The result status of the stack set operation for the given account in the given region.

  • CANCELLED: The operation in the specified account and region has been cancelled. This is either because a user has stopped the stack set operation, or because the failure tolerance of the stack set operation has been exceeded.

  • FAILED: The operation in the specified account and region failed.

    If the stack set operation fails in enough accounts within a region, the failure tolerance for the stack set operation as a whole might be exceeded.

  • RUNNING: The operation in the specified account and region is currently in progress.

  • PENDING: The operation in the specified account and region has yet to start.

  • SUCCEEDED: The operation in the specified account and region completed successfully.

" - }, - "StatusReason":{ - "shape":"Reason", - "documentation":"

The reason for the assigned result status.

" - }, - "AccountGateResult":{ - "shape":"AccountGateResult", - "documentation":"

The results of the account gate function AWS CloudFormation invokes, if present, before proceeding with stack set operations in an account

" - } - }, - "documentation":"

The structure that contains information about a specified operation's results for a given account in a given region.

" - }, - "StackSetOperationStatus":{ - "type":"string", - "enum":[ - "RUNNING", - "SUCCEEDED", - "FAILED", - "STOPPING", - "STOPPED" - ] - }, - "StackSetOperationSummaries":{ - "type":"list", - "member":{"shape":"StackSetOperationSummary"} - }, - "StackSetOperationSummary":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique ID of the stack set operation.

" - }, - "Action":{ - "shape":"StackSetOperationAction", - "documentation":"

The type of operation: CREATE, UPDATE, or DELETE. Create and delete operations affect only the specified stack instances that are associated with the specified stack set. Update operations affect both the stack set itself as well as all associated stack set instances.

" - }, - "Status":{ - "shape":"StackSetOperationStatus", - "documentation":"

The overall status of the operation.

  • FAILED: The operation exceeded the specified failure tolerance. The failure tolerance value that you've set for an operation is applied for each region during stack create and update operations. If the number of failed stacks within a region exceeds the failure tolerance, the status of the operation in the region is set to FAILED. This in turn sets the status of the operation as a whole to FAILED, and AWS CloudFormation cancels the operation in any remaining regions.

  • RUNNING: The operation is currently being performed.

  • STOPPED: The user has cancelled the operation.

  • STOPPING: The operation is in the process of stopping, at user request.

  • SUCCEEDED: The operation completed creating or updating all the specified stacks without exceeding the failure tolerance for the operation.

" - }, - "CreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which the operation was initiated. Note that the creation times for the stack set operation might differ from the creation time of the individual stacks themselves. This is because AWS CloudFormation needs to perform preparatory work for the operation, such as dispatching the work to the requested regions, before actually creating the first stacks.

" - }, - "EndTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which the stack set operation ended, across all accounts and regions specified. Note that this doesn't necessarily mean that the stack set operation was successful, or even attempted, in each account or region.

" - } - }, - "documentation":"

The structures that contain summary information about the specified operation.

" - }, - "StackSetStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "DELETED" - ] - }, - "StackSetSummaries":{ - "type":"list", - "member":{"shape":"StackSetSummary"} - }, - "StackSetSummary":{ - "type":"structure", - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name of the stack set.

" - }, - "StackSetId":{ - "shape":"StackSetId", - "documentation":"

The ID of the stack set.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the stack set that you specify when the stack set is created or updated.

" - }, - "Status":{ - "shape":"StackSetStatus", - "documentation":"

The status of the stack set.

" - } - }, - "documentation":"

The structures that contain summary information about the specified stack set.

" - }, - "StackStatus":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "CREATE_FAILED", - "CREATE_COMPLETE", - "ROLLBACK_IN_PROGRESS", - "ROLLBACK_FAILED", - "ROLLBACK_COMPLETE", - "DELETE_IN_PROGRESS", - "DELETE_FAILED", - "DELETE_COMPLETE", - "UPDATE_IN_PROGRESS", - "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", - "UPDATE_COMPLETE", - "UPDATE_ROLLBACK_IN_PROGRESS", - "UPDATE_ROLLBACK_FAILED", - "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", - "UPDATE_ROLLBACK_COMPLETE", - "REVIEW_IN_PROGRESS" - ] - }, - "StackStatusFilter":{ - "type":"list", - "member":{"shape":"StackStatus"} - }, - "StackStatusReason":{"type":"string"}, - "StackSummaries":{ - "type":"list", - "member":{"shape":"StackSummary"} - }, - "StackSummary":{ - "type":"structure", - "required":[ - "StackName", - "CreationTime", - "StackStatus" - ], - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

Unique stack identifier.

" - }, - "StackName":{ - "shape":"StackName", - "documentation":"

The name associated with the stack.

" - }, - "TemplateDescription":{ - "shape":"TemplateDescription", - "documentation":"

The template description of the template used to create the stack.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

The time the stack was created.

" - }, - "LastUpdatedTime":{ - "shape":"LastUpdatedTime", - "documentation":"

The time the stack was last updated. This field will only be returned if the stack has been updated at least once.

" - }, - "DeletionTime":{ - "shape":"DeletionTime", - "documentation":"

The time the stack was deleted.

" - }, - "StackStatus":{ - "shape":"StackStatus", - "documentation":"

The current status of the stack.

" - }, - "StackStatusReason":{ - "shape":"StackStatusReason", - "documentation":"

Success/Failure message associated with the stack status.

" - }, - "ParentId":{ - "shape":"StackId", - "documentation":"

For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this stack. For the first level of nested stacks, the root stack is also the parent stack.

For more information, see Working with Nested Stacks in the AWS CloudFormation User Guide.

" - }, - "RootId":{ - "shape":"StackId", - "documentation":"

For nested stacks--stacks created as resources for another stack--the stack ID of the the top-level stack to which the nested stack ultimately belongs.

For more information, see Working with Nested Stacks in the AWS CloudFormation User Guide.

" - } - }, - "documentation":"

The StackSummary Data Type

" - }, - "Stacks":{ - "type":"list", - "member":{"shape":"Stack"} - }, - "StageList":{ - "type":"list", - "member":{"shape":"TemplateStage"} - }, - "StaleRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Another operation has been performed on this stack set since the specified operation was performed.

", - "error":{ - "code":"StaleRequestException", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "StopStackSetOperationInput":{ - "type":"structure", - "required":[ - "StackSetName", - "OperationId" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to stop the operation for.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The ID of the stack operation.

" - } - } - }, - "StopStackSetOperationOutput":{ - "type":"structure", - "members":{ - } - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

Required. A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (AWS) have the reserved prefix: aws:.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

Required. A string containing the value for this tag. You can specify a maximum of 256 characters for a tag value.

" - } - }, - "documentation":"

The Tag type enables you to specify a key-value pair that can be used to store information about an AWS CloudFormation stack.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1 - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50 - }, - "TemplateBody":{ - "type":"string", - "min":1 - }, - "TemplateDescription":{"type":"string"}, - "TemplateParameter":{ - "type":"structure", - "members":{ - "ParameterKey":{ - "shape":"ParameterKey", - "documentation":"

The name associated with the parameter.

" - }, - "DefaultValue":{ - "shape":"ParameterValue", - "documentation":"

The default value associated with the parameter.

" - }, - "NoEcho":{ - "shape":"NoEcho", - "documentation":"

Flag indicating whether the parameter should be displayed as plain text in logs and UIs.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

User defined description associated with the parameter.

" - } - }, - "documentation":"

The TemplateParameter data type.

" - }, - "TemplateParameters":{ - "type":"list", - "member":{"shape":"TemplateParameter"} - }, - "TemplateStage":{ - "type":"string", - "enum":[ - "Original", - "Processed" - ] - }, - "TemplateURL":{ - "type":"string", - "max":1024, - "min":1 - }, - "TimeoutMinutes":{ - "type":"integer", - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "TokenAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A client request token already exists.

", - "error":{ - "code":"TokenAlreadyExistsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TransformName":{"type":"string"}, - "TransformsList":{ - "type":"list", - "member":{"shape":"TransformName"} - }, - "Type":{"type":"string"}, - "UpdateStackInput":{ - "type":"structure", - "required":["StackName"], - "members":{ - "StackName":{ - "shape":"StackName", - "documentation":"

The name or unique stack ID of the stack to update.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to Template Anatomy in the AWS CloudFormation User Guide.)

Conditional: You must specify only one of the following parameters: TemplateBody, TemplateURL, or set the UsePreviousTemplate to true.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify only one of the following parameters: TemplateBody, TemplateURL, or set the UsePreviousTemplate to true.

" - }, - "UsePreviousTemplate":{ - "shape":"UsePreviousTemplate", - "documentation":"

Reuse the existing template that is associated with the stack that you are updating.

Conditional: You must specify only one of the following parameters: TemplateBody, TemplateURL, or set the UsePreviousTemplate to true.

" - }, - "StackPolicyDuringUpdateBody":{ - "shape":"StackPolicyDuringUpdateBody", - "documentation":"

Structure containing the temporary overriding stack policy body. You can specify either the StackPolicyDuringUpdateBody or the StackPolicyDuringUpdateURL parameter, but not both.

If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used.

" - }, - "StackPolicyDuringUpdateURL":{ - "shape":"StackPolicyDuringUpdateURL", - "documentation":"

Location of a file containing the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the StackPolicyDuringUpdateBody or the StackPolicyDuringUpdateURL parameter, but not both.

If you want to update protected resources, specify a temporary overriding stack policy during this update. If you do not specify a stack policy, the current policy that is associated with the stack will be used.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of Parameter structures that specify input parameters for the stack. For more information, see the Parameter data type.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

A list of values that you must specify before AWS CloudFormation can update certain stacks. Some stack templates might include resources that can affect permissions in your AWS account, for example, by creating new AWS Identity and Access Management (IAM) users. For those stacks, you must explicitly acknowledge their capabilities by specifying this parameter.

The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The following resources require you to specify this parameter: AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::InstanceProfile, AWS::IAM::Policy, AWS::IAM::Role, AWS::IAM::User, and AWS::IAM::UserToGroupAddition. If your stack template contains these resources, we recommend that you review all permissions associated with them and edit their permissions if necessary.

If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action returns an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "ResourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

The template resource types that you have permissions to work with for this update stack action, such as AWS::EC2::Instance, AWS::EC2::*, or Custom::MyCustomInstance.

If the list of resource types doesn't include a resource that you're updating, the stack update fails. By default, AWS CloudFormation grants permissions to all resource types. AWS Identity and Access Management (IAM) uses this parameter for AWS CloudFormation-specific condition keys in IAM policies. For more information, see Controlling Access with AWS Identity and Access Management.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM) role that AWS CloudFormation assumes to update the stack. AWS CloudFormation uses the role's credentials to make calls on your behalf. AWS CloudFormation always uses this role for all future operations on the stack. As long as users have permission to operate on the stack, AWS CloudFormation uses this role even if the users don't have permission to pass it. Ensure that the role grants least privilege.

If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

" - }, - "RollbackConfiguration":{ - "shape":"RollbackConfiguration", - "documentation":"

The rollback triggers for AWS CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

" - }, - "StackPolicyBody":{ - "shape":"StackPolicyBody", - "documentation":"

Structure containing a new stack policy body. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged.

" - }, - "StackPolicyURL":{ - "shape":"StackPolicyURL", - "documentation":"

Location of a file containing the updated stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in the same region as the stack. You can specify either the StackPolicyBody or the StackPolicyURL parameter, but not both.

You might update the stack policy, for example, in order to protect a new resource that you created during a stack update. If you do not specify a stack policy, the current policy that is associated with the stack is unchanged.

" - }, - "NotificationARNs":{ - "shape":"NotificationARNs", - "documentation":"

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that AWS CloudFormation associates with the stack. Specify an empty list to remove all notification topics.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 50 tags.

If you don't specify this parameter, AWS CloudFormation doesn't modify the stack's tags. If you specify an empty value, AWS CloudFormation removes all associated tags.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique identifier for this UpdateStack request. Specify this token if you plan to retry requests so that AWS CloudFormation knows that you're not attempting to update a stack with the same name. You might retry UpdateStack requests to ensure that AWS CloudFormation successfully received them.

All events triggered by a given stack operation are assigned the same client request token, which you can use to track operations. For example, if you execute a CreateStack operation with the token token1, then all the StackEvents generated by that operation will have ClientRequestToken set as token1.

In the console, stack operations display the client request token on the Events tab. Stack operations that are initiated from the console use the token format Console-StackOperation-ID, which helps you easily identify the stack operation . For example, if you create a stack using the console, each stack event would be assigned the same token in the following format: Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

" - } - }, - "documentation":"

The input for an UpdateStack action.

" - }, - "UpdateStackInstancesInput":{ - "type":"structure", - "required":[ - "StackSetName", - "Accounts", - "Regions" - ], - "members":{ - "StackSetName":{ - "shape":"StackSetNameOrId", - "documentation":"

The name or unique ID of the stack set associated with the stack instances.

" - }, - "Accounts":{ - "shape":"AccountList", - "documentation":"

The names of one or more AWS accounts for which you want to update parameter values for stack instances. The overridden parameter values will be applied to all stack instances in the specified accounts and regions.

" - }, - "Regions":{ - "shape":"RegionList", - "documentation":"

The names of one or more regions in which you want to update parameter values for stack instances. The overridden parameter values will be applied to all stack instances in the specified accounts and regions.

" - }, - "ParameterOverrides":{ - "shape":"Parameters", - "documentation":"

A list of input parameters whose values you want to update for the specified stack instances.

Any overridden parameter values will be applied to all stack instances in the specified accounts and regions. When specifying parameters and their values, be aware of how AWS CloudFormation sets parameter values during stack instance update operations:

  • To override the current value for a parameter, include the parameter and specify its value.

  • To leave a parameter set to its present value, you can do one of the following:

    • Do not include the parameter in the list.

    • Include the parameter and specify UsePreviousValue as true. (You cannot specify both a value and set UsePreviousValue to true.)

  • To set all overridden parameter back to the values specified in the stack set, specify a parameter list but do not include any parameters.

  • To leave all parameters set to their present values, do not specify this property at all.

During stack set updates, any parameter values overridden for a stack instance are not updated, but retain their overridden value.

You can only override the parameter values that are specified in the stack set; to add or delete a parameter itself, use UpdateStackSet to update the stack set template. If you add a parameter to a template, before you can override the parameter value specified in the stack set you must first use UpdateStackSet to update all stack instances with the updated template and parameter value specified in the stack set. Once a stack instance has been updated with the new parameter, you can then override the parameter value using UpdateStackInstances.

" - }, - "OperationPreferences":{ - "shape":"StackSetOperationPreferences", - "documentation":"

Preferences for how AWS CloudFormation performs this stack set operation.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

The operation ID also functions as an idempotency token, to ensure that AWS CloudFormation performs the stack set operation only once, even if you retry the request multiple times. You might retry stack set operation requests to ensure that AWS CloudFormation successfully received them.

If you don't specify an operation ID, the SDK generates one automatically.

", - "idempotencyToken":true - } - } - }, - "UpdateStackInstancesOutput":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique identifier for this stack set operation.

" - } - } - }, - "UpdateStackOutput":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

Unique identifier of the stack.

" - } - }, - "documentation":"

The output for an UpdateStack action.

" - }, - "UpdateStackSetInput":{ - "type":"structure", - "required":["StackSetName"], - "members":{ - "StackSetName":{ - "shape":"StackSetName", - "documentation":"

The name or unique ID of the stack set that you want to update.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A brief description of updates that you are making.

" - }, - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

The structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify only one of the following parameters: TemplateBody or TemplateURL—or set UsePreviousTemplate to true.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

The location of the file that contains the template body. The URL must point to a template (maximum size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, see Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must specify only one of the following parameters: TemplateBody or TemplateURL—or set UsePreviousTemplate to true.

" - }, - "UsePreviousTemplate":{ - "shape":"UsePreviousTemplate", - "documentation":"

Use the existing template that's associated with the stack set that you're updating.

Conditional: You must specify only one of the following parameters: TemplateBody or TemplateURL—or set UsePreviousTemplate to true.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A list of input parameters for the stack set template.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

A list of values that you must specify before AWS CloudFormation can create certain stack sets. Some stack set templates might include resources that can affect permissions in your AWS account—for example, by creating new AWS Identity and Access Management (IAM) users. For those stack sets, you must explicitly acknowledge their capabilities by specifying this parameter.

The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The following resources require you to specify this parameter:

  • AWS::IAM::AccessKey

  • AWS::IAM::Group

  • AWS::IAM::InstanceProfile

  • AWS::IAM::Policy

  • AWS::IAM::Role

  • AWS::IAM::User

  • AWS::IAM::UserToGroupAddition

If your stack template contains these resources, we recommend that you review all permissions that are associated with them and edit their permissions if necessary.

If you have IAM resources, you can specify either capability. If you have IAM resources with custom names, you must specify CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action returns an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The key-value pairs to associate with this stack set and the stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the stacks. You can specify a maximum number of 50 tags.

If you specify tags for this parameter, those tags replace any list of tags that are currently associated with this stack set. This means:

  • If you don't specify this parameter, AWS CloudFormation doesn't modify the stack's tags.

  • If you specify any tags using this parameter, you must specify all the tags that you want associated with this stack set, even tags you've specifed before (for example, when creating the stack set or during a previous update of the stack set.). Any tags that you don't include in the updated list of tags are removed from the stack set, and therefore from the stacks and resources as well.

  • If you specify an empty value, AWS CloudFormation removes all currently associated tags.

If you specify new tags as part of an UpdateStackSet action, AWS CloudFormation checks to see if you have the required IAM permission to tag resources. If you omit tags that are currently associated with the stack set from the list of tags you specify, AWS CloudFormation assumes that you want to remove those tags from the stack set, and checks to see if you have permission to untag resources. If you don't have the necessary permission(s), the entire UpdateStackSet action fails with an access denied error, and the stack set is not updated.

" - }, - "OperationPreferences":{ - "shape":"StackSetOperationPreferences", - "documentation":"

Preferences for how AWS CloudFormation performs this stack set operation.

" - }, - "AdministrationRoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Number (ARN) of the IAM role to use to update this stack set.

Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see Define Permissions for Multiple Administrators in the AWS CloudFormation User Guide.

If you specify a customized administrator role, AWS CloudFormation uses that role to update the stack. If you do not specify a customized administrator role, AWS CloudFormation performs the update using the role previously associated with the stack set, so long as you have permissions to perform operations on the stack set.

" - }, - "ExecutionRoleName":{ - "shape":"ExecutionRoleName", - "documentation":"

The name of the IAM execution role to use to update the stack set. If you do not specify an execution role, AWS CloudFormation uses the AWSCloudFormationStackSetExecutionRole role for the stack set operation.

Specify an IAM role only if you are using customized execution roles to control which stack resources users and groups can include in their stack sets.

If you specify a customized execution role, AWS CloudFormation uses that role to update the stack. If you do not specify a customized execution role, AWS CloudFormation performs the update using the role previously associated with the stack set, so long as you have permissions to perform operations on the stack set.

" - }, - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique ID for this stack set operation.

The operation ID also functions as an idempotency token, to ensure that AWS CloudFormation performs the stack set operation only once, even if you retry the request multiple times. You might retry stack set operation requests to ensure that AWS CloudFormation successfully received them.

If you don't specify an operation ID, AWS CloudFormation generates one automatically.

Repeating this stack set operation with a new operation ID retries all stack instances whose status is OUTDATED.

", - "idempotencyToken":true - }, - "Accounts":{ - "shape":"AccountList", - "documentation":"

The accounts in which to update associated stack instances. If you specify accounts, you must also specify the regions in which to update stack set instances.

To update all the stack instances associated with this stack set, do not specify the Accounts or Regions properties.

If the stack set update includes changes to the template (that is, if the TemplateBody or TemplateURL properties are specified), or the Parameters property, AWS CloudFormation marks all stack instances with a status of OUTDATED prior to updating the stack instances in the specified accounts and regions. If the stack set update does not include changes to the template or parameters, AWS CloudFormation updates the stack instances in the specified accounts and regions, while leaving all other stack instances with their existing stack instance status.

" - }, - "Regions":{ - "shape":"RegionList", - "documentation":"

The regions in which to update associated stack instances. If you specify regions, you must also specify accounts in which to update stack set instances.

To update all the stack instances associated with this stack set, do not specify the Accounts or Regions properties.

If the stack set update includes changes to the template (that is, if the TemplateBody or TemplateURL properties are specified), or the Parameters property, AWS CloudFormation marks all stack instances with a status of OUTDATED prior to updating the stack instances in the specified accounts and regions. If the stack set update does not include changes to the template or parameters, AWS CloudFormation updates the stack instances in the specified accounts and regions, while leaving all other stack instances with their existing stack instance status.

" - } - } - }, - "UpdateStackSetOutput":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"ClientRequestToken", - "documentation":"

The unique ID for this stack set operation.

" - } - } - }, - "UpdateTerminationProtectionInput":{ - "type":"structure", - "required":[ - "EnableTerminationProtection", - "StackName" - ], - "members":{ - "EnableTerminationProtection":{ - "shape":"EnableTerminationProtection", - "documentation":"

Whether to enable termination protection on the specified stack.

" - }, - "StackName":{ - "shape":"StackNameOrId", - "documentation":"

The name or unique ID of the stack for which you want to set termination protection.

" - } - } - }, - "UpdateTerminationProtectionOutput":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"StackId", - "documentation":"

The unique ID of the stack.

" - } - } - }, - "Url":{"type":"string"}, - "UsePreviousTemplate":{"type":"boolean"}, - "UsePreviousValue":{"type":"boolean"}, - "ValidateTemplateInput":{ - "type":"structure", - "members":{ - "TemplateBody":{ - "shape":"TemplateBody", - "documentation":"

Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must pass TemplateURL or TemplateBody. If both are passed, only TemplateBody is used.

" - }, - "TemplateURL":{ - "shape":"TemplateURL", - "documentation":"

Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to Template Anatomy in the AWS CloudFormation User Guide.

Conditional: You must pass TemplateURL or TemplateBody. If both are passed, only TemplateBody is used.

" - } - }, - "documentation":"

The input for ValidateTemplate action.

" - }, - "ValidateTemplateOutput":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"TemplateParameters", - "documentation":"

A list of TemplateParameter structures.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description found within the template.

" - }, - "Capabilities":{ - "shape":"Capabilities", - "documentation":"

The capabilities found within the template. If your template contains IAM resources, you must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you use the CreateStack or UpdateStack actions with your template; otherwise, those actions return an InsufficientCapabilities error.

For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.

" - }, - "CapabilitiesReason":{ - "shape":"CapabilitiesReason", - "documentation":"

The list of resources that generated the values in the Capabilities response element.

" - }, - "DeclaredTransforms":{ - "shape":"TransformsList", - "documentation":"

A list of the transforms that are declared in the template.

" - } - }, - "documentation":"

The output for ValidateTemplate action.

" - }, - "Version":{"type":"string"} - }, - "documentation":"AWS CloudFormation

AWS CloudFormation allows you to create and manage AWS infrastructure deployments predictably and repeatedly. You can use AWS CloudFormation to leverage AWS products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly scalable, cost-effective applications without creating or configuring the underlying AWS infrastructure.

With AWS CloudFormation, you declare all of your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. AWS CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.

For more information about AWS CloudFormation, see the AWS CloudFormation Product Page.

Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product's technical documentation at docs.aws.amazon.com.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/waiters-2.json deleted file mode 100644 index 4e8c8282..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudformation/2010-05-15/waiters-2.json +++ /dev/null @@ -1,182 +0,0 @@ -{ - "version": 2, - "waiters": { - "StackExists": { - "delay": 5, - "operation": "DescribeStacks", - "maxAttempts": 20, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "ValidationError", - "state": "retry" - } - ] - }, - "StackCreateComplete": { - "delay": 30, - "operation": "DescribeStacks", - "maxAttempts": 120, - "description": "Wait until stack status is CREATE_COMPLETE.", - "acceptors": [ - { - "argument": "Stacks[].StackStatus", - "expected": "CREATE_COMPLETE", - "matcher": "pathAll", - "state": "success" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "CREATE_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "DELETE_COMPLETE", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "DELETE_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "ROLLBACK_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "ROLLBACK_COMPLETE", - "matcher": "pathAny", - "state": "failure" - }, - { - "expected": "ValidationError", - "matcher": "error", - "state": "failure" - } - ] - }, - "StackDeleteComplete": { - "delay": 30, - "operation": "DescribeStacks", - "maxAttempts": 120, - "description": "Wait until stack status is DELETE_COMPLETE.", - "acceptors": [ - { - "argument": "Stacks[].StackStatus", - "expected": "DELETE_COMPLETE", - "matcher": "pathAll", - "state": "success" - }, - { - "expected": "ValidationError", - "matcher": "error", - "state": "success" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "DELETE_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "CREATE_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "ROLLBACK_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "UPDATE_ROLLBACK_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "UPDATE_ROLLBACK_IN_PROGRESS", - "matcher": "pathAny", - "state": "failure" - } - ] - }, - "StackUpdateComplete": { - "delay": 30, - "maxAttempts": 120, - "operation": "DescribeStacks", - "description": "Wait until stack status is UPDATE_COMPLETE.", - "acceptors": [ - { - "argument": "Stacks[].StackStatus", - "expected": "UPDATE_COMPLETE", - "matcher": "pathAll", - "state": "success" - }, - { - "expected": "UPDATE_FAILED", - "matcher": "pathAny", - "state": "failure", - "argument": "Stacks[].StackStatus" - }, - { - "argument": "Stacks[].StackStatus", - "expected": "UPDATE_ROLLBACK_FAILED", - "matcher": "pathAny", - "state": "failure" - }, - { - "expected": "UPDATE_ROLLBACK_COMPLETE", - "matcher": "pathAny", - "state": "failure", - "argument": "Stacks[].StackStatus" - }, - { - "expected": "ValidationError", - "matcher": "error", - "state": "failure" - } - ] - }, - "ChangeSetCreateComplete": { - "delay": 30, - "operation": "DescribeChangeSet", - "maxAttempts": 120, - "description": "Wait until change set status is CREATE_COMPLETE.", - "acceptors": [ - { - "argument": "Status", - "expected": "CREATE_COMPLETE", - "matcher": "path", - "state": "success" - }, - { - "argument": "Status", - "expected": "FAILED", - "matcher": "path", - "state": "failure" - }, - { - "expected": "ValidationError", - "matcher": "error", - "state": "failure" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/service-2.json deleted file mode 100644 index 975a6496..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/service-2.json +++ /dev/null @@ -1,3540 +0,0 @@ -{ - "metadata":{ - "apiVersion":"2014-05-31", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "protocol":"rest-xml" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2014_05_31", - "http":{ - "method":"POST", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{ - "shape":"CreateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to create a new origin access identity." - }, - "output":{ - "shape":"CreateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CloudFrontOriginAccessIdentityAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyCloudFrontOriginAccessIdentities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2014_05_31", - "http":{ - "method":"POST", - "requestUri":"/2014-05-31/distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateDistributionRequest", - "documentation":"The request to create a new distribution." - }, - "output":{ - "shape":"CreateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"DistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"TooManyDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2014_05_31", - "http":{ - "method":"POST", - "requestUri":"/2014-05-31/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{ - "shape":"CreateInvalidationRequest", - "documentation":"The request to create an invalidation." - }, - "output":{ - "shape":"CreateInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"BatchTooLarge", - "error":{"httpStatusCode":413}, - "exception":true - }, - { - "shape":"TooManyInvalidationsInProgress", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2014_05_31", - "http":{ - "method":"POST", - "requestUri":"/2014-05-31/streaming-distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateStreamingDistributionRequest", - "documentation":"The request to create a new streaming distribution." - }, - "output":{ - "shape":"CreateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"StreamingDistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"TooManyStreamingDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2014_05_31", - "http":{ - "method":"DELETE", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to delete a origin access identity." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"CloudFrontOriginAccessIdentityInUse", - "error":{"httpStatusCode":409}, - "exception":true - } - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2014_05_31", - "http":{ - "method":"DELETE", - "requestUri":"/2014-05-31/distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteDistributionRequest", - "documentation":"The request to delete a distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"DistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2014_05_31", - "http":{ - "method":"DELETE", - "requestUri":"/2014-05-31/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteStreamingDistributionRequest", - "documentation":"The request to delete a streaming distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"StreamingDistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront/{Id}" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to get an origin access identity's information." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigRequest", - "documentation":"The request to get an origin access identity's configuration." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/distribution/{Id}" - }, - "input":{ - "shape":"GetDistributionRequest", - "documentation":"The request to get a distribution's information." - }, - "output":{ - "shape":"GetDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/distribution/{Id}/config" - }, - "input":{ - "shape":"GetDistributionConfigRequest", - "documentation":"The request to get a distribution configuration." - }, - "output":{ - "shape":"GetDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{ - "shape":"GetInvalidationRequest", - "documentation":"The request to get an invalidation's information." - }, - "output":{ - "shape":"GetInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchInvalidation", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/streaming-distribution/{Id}" - }, - "input":{ - "shape":"GetStreamingDistributionRequest", - "documentation":"The request to get a streaming distribution's information." - }, - "output":{ - "shape":"GetStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"GetStreamingDistributionConfigRequest", - "documentation":"To request to get a streaming distribution configuration." - }, - "output":{ - "shape":"GetStreamingDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront" - }, - "input":{ - "shape":"ListCloudFrontOriginAccessIdentitiesRequest", - "documentation":"The request to list origin access identities." - }, - "output":{ - "shape":"ListCloudFrontOriginAccessIdentitiesResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/distribution" - }, - "input":{ - "shape":"ListDistributionsRequest", - "documentation":"The request to list your distributions." - }, - "output":{ - "shape":"ListDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List distributions." - }, - "ListInvalidations":{ - "name":"ListInvalidations2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/distribution/{DistributionId}/invalidation" - }, - "input":{ - "shape":"ListInvalidationsRequest", - "documentation":"The request to list invalidations." - }, - "output":{ - "shape":"ListInvalidationsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2014_05_31", - "http":{ - "method":"GET", - "requestUri":"/2014-05-31/streaming-distribution" - }, - "input":{ - "shape":"ListStreamingDistributionsRequest", - "documentation":"The request to list your streaming distributions." - }, - "output":{ - "shape":"ListStreamingDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2014_05_31", - "http":{ - "method":"PUT", - "requestUri":"/2014-05-31/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"UpdateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to update an origin access identity." - }, - "output":{ - "shape":"UpdateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2014_05_31", - "http":{ - "method":"PUT", - "requestUri":"/2014-05-31/distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateDistributionRequest", - "documentation":"The request to update a distribution." - }, - "output":{ - "shape":"UpdateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2014_05_31", - "http":{ - "method":"PUT", - "requestUri":"/2014-05-31/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateStreamingDistributionRequest", - "documentation":"The request to update a streaming distribution." - }, - "output":{ - "shape":"UpdateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests) and 7 (for DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT requests)." - }, - "Items":{ - "shape":"AllowedMethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - } - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are two options: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT requests. If you choose the second option, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AllowedMethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"DistributionConfig" - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"InvalidationBatch" - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID." - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"StreamingDistributionConfig" - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The origin access identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a origin access identity.", - "required":["Id"] - }, - "DeleteDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a distribution.", - "required":["Id"] - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a streaming distribution.", - "required":["Id"] - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Aliases", - "DefaultRootObject", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "Comment", - "Logging", - "PriceClass", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's configuration.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's information.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution configuration.", - "required":["Id"] - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution's information.", - "required":["Id"] - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The invalidation's id." - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"To request to get a streaming distribution configuration.", - "required":["Id"] - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"The request to get a streaming distribution's information.", - "required":["Id"] - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of origin access identities you want in the response body." - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions you want in the response body." - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of invalidation batches you want in the response body." - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of streaming distributions you want in the response body." - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Aliases", - "Comment", - "Logging", - "TrustedSigners", - "PriceClass", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"DistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-05-31/"}, - "locationName":"StreamingDistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate." - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-05-31/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/service-2.json deleted file mode 100644 index 8e751657..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/service-2.json +++ /dev/null @@ -1,3588 +0,0 @@ -{ - "metadata":{ - "apiVersion":"2014-10-21", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "protocol":"rest-xml" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2014_10_21", - "http":{ - "method":"POST", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{ - "shape":"CreateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to create a new origin access identity." - }, - "output":{ - "shape":"CreateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CloudFrontOriginAccessIdentityAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyCloudFrontOriginAccessIdentities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2014_10_21", - "http":{ - "method":"POST", - "requestUri":"/2014-10-21/distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateDistributionRequest", - "documentation":"The request to create a new distribution." - }, - "output":{ - "shape":"CreateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"DistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"TooManyDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidProtocolSettings", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - } - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2014_10_21", - "http":{ - "method":"POST", - "requestUri":"/2014-10-21/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{ - "shape":"CreateInvalidationRequest", - "documentation":"The request to create an invalidation." - }, - "output":{ - "shape":"CreateInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"BatchTooLarge", - "error":{"httpStatusCode":413}, - "exception":true - }, - { - "shape":"TooManyInvalidationsInProgress", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2014_10_21", - "http":{ - "method":"POST", - "requestUri":"/2014-10-21/streaming-distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateStreamingDistributionRequest", - "documentation":"The request to create a new streaming distribution." - }, - "output":{ - "shape":"CreateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"StreamingDistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"TooManyStreamingDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2014_10_21", - "http":{ - "method":"DELETE", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to delete a origin access identity." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"CloudFrontOriginAccessIdentityInUse", - "error":{"httpStatusCode":409}, - "exception":true - } - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2014_10_21", - "http":{ - "method":"DELETE", - "requestUri":"/2014-10-21/distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteDistributionRequest", - "documentation":"The request to delete a distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"DistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2014_10_21", - "http":{ - "method":"DELETE", - "requestUri":"/2014-10-21/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteStreamingDistributionRequest", - "documentation":"The request to delete a streaming distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"StreamingDistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront/{Id}" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to get an origin access identity's information." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigRequest", - "documentation":"The request to get an origin access identity's configuration." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/distribution/{Id}" - }, - "input":{ - "shape":"GetDistributionRequest", - "documentation":"The request to get a distribution's information." - }, - "output":{ - "shape":"GetDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/distribution/{Id}/config" - }, - "input":{ - "shape":"GetDistributionConfigRequest", - "documentation":"The request to get a distribution configuration." - }, - "output":{ - "shape":"GetDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{ - "shape":"GetInvalidationRequest", - "documentation":"The request to get an invalidation's information." - }, - "output":{ - "shape":"GetInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchInvalidation", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/streaming-distribution/{Id}" - }, - "input":{ - "shape":"GetStreamingDistributionRequest", - "documentation":"The request to get a streaming distribution's information." - }, - "output":{ - "shape":"GetStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"GetStreamingDistributionConfigRequest", - "documentation":"To request to get a streaming distribution configuration." - }, - "output":{ - "shape":"GetStreamingDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront" - }, - "input":{ - "shape":"ListCloudFrontOriginAccessIdentitiesRequest", - "documentation":"The request to list origin access identities." - }, - "output":{ - "shape":"ListCloudFrontOriginAccessIdentitiesResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/distribution" - }, - "input":{ - "shape":"ListDistributionsRequest", - "documentation":"The request to list your distributions." - }, - "output":{ - "shape":"ListDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List distributions." - }, - "ListInvalidations":{ - "name":"ListInvalidations2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/distribution/{DistributionId}/invalidation" - }, - "input":{ - "shape":"ListInvalidationsRequest", - "documentation":"The request to list invalidations." - }, - "output":{ - "shape":"ListInvalidationsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2014_10_21", - "http":{ - "method":"GET", - "requestUri":"/2014-10-21/streaming-distribution" - }, - "input":{ - "shape":"ListStreamingDistributionsRequest", - "documentation":"The request to list your streaming distributions." - }, - "output":{ - "shape":"ListStreamingDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2014_10_21", - "http":{ - "method":"PUT", - "requestUri":"/2014-10-21/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"UpdateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to update an origin access identity." - }, - "output":{ - "shape":"UpdateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2014_10_21", - "http":{ - "method":"PUT", - "requestUri":"/2014-10-21/distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateDistributionRequest", - "documentation":"The request to update a distribution." - }, - "output":{ - "shape":"UpdateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2014_10_21", - "http":{ - "method":"PUT", - "requestUri":"/2014-10-21/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateStreamingDistributionRequest", - "documentation":"The request to update a streaming distribution." - }, - "output":{ - "shape":"UpdateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"DistributionConfig" - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"InvalidationBatch" - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID." - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"StreamingDistributionConfig" - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The origin access identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a origin access identity.", - "required":["Id"] - }, - "DeleteDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a distribution.", - "required":["Id"] - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a streaming distribution.", - "required":["Id"] - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Aliases", - "DefaultRootObject", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "Comment", - "Logging", - "PriceClass", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's configuration.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's information.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution configuration.", - "required":["Id"] - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution's information.", - "required":["Id"] - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The invalidation's id." - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"To request to get a streaming distribution configuration.", - "required":["Id"] - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"The request to get a streaming distribution's information.", - "required":["Id"] - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of origin access identities you want in the response body." - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions you want in the response body." - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of invalidation batches you want in the response body." - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of streaming distributions you want in the response body." - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Aliases", - "Comment", - "Logging", - "TrustedSigners", - "PriceClass", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"DistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-10-21/"}, - "locationName":"StreamingDistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate." - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-10-21/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/service-2.json deleted file mode 100644 index c58646ef..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/service-2.json +++ /dev/null @@ -1,3585 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-11-06", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "protocol":"rest-xml" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2014_11_06", - "http":{ - "method":"POST", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{ - "shape":"CreateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to create a new origin access identity." - }, - "output":{ - "shape":"CreateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CloudFrontOriginAccessIdentityAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyCloudFrontOriginAccessIdentities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2014_11_06", - "http":{ - "method":"POST", - "requestUri":"/2014-11-06/distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateDistributionRequest", - "documentation":"The request to create a new distribution." - }, - "output":{ - "shape":"CreateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"DistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"TooManyDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidProtocolSettings", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - } - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2014_11_06", - "http":{ - "method":"POST", - "requestUri":"/2014-11-06/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{ - "shape":"CreateInvalidationRequest", - "documentation":"The request to create an invalidation." - }, - "output":{ - "shape":"CreateInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"BatchTooLarge", - "error":{"httpStatusCode":413}, - "exception":true - }, - { - "shape":"TooManyInvalidationsInProgress", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2014_11_06", - "http":{ - "method":"POST", - "requestUri":"/2014-11-06/streaming-distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateStreamingDistributionRequest", - "documentation":"The request to create a new streaming distribution." - }, - "output":{ - "shape":"CreateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"StreamingDistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"TooManyStreamingDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2014_11_06", - "http":{ - "method":"DELETE", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to delete a origin access identity." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"CloudFrontOriginAccessIdentityInUse", - "error":{"httpStatusCode":409}, - "exception":true - } - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2014_11_06", - "http":{ - "method":"DELETE", - "requestUri":"/2014-11-06/distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteDistributionRequest", - "documentation":"The request to delete a distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"DistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2014_11_06", - "http":{ - "method":"DELETE", - "requestUri":"/2014-11-06/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteStreamingDistributionRequest", - "documentation":"The request to delete a streaming distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"StreamingDistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront/{Id}" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to get an origin access identity's information." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigRequest", - "documentation":"The request to get an origin access identity's configuration." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/distribution/{Id}" - }, - "input":{ - "shape":"GetDistributionRequest", - "documentation":"The request to get a distribution's information." - }, - "output":{ - "shape":"GetDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/distribution/{Id}/config" - }, - "input":{ - "shape":"GetDistributionConfigRequest", - "documentation":"The request to get a distribution configuration." - }, - "output":{ - "shape":"GetDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{ - "shape":"GetInvalidationRequest", - "documentation":"The request to get an invalidation's information." - }, - "output":{ - "shape":"GetInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchInvalidation", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/streaming-distribution/{Id}" - }, - "input":{ - "shape":"GetStreamingDistributionRequest", - "documentation":"The request to get a streaming distribution's information." - }, - "output":{ - "shape":"GetStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"GetStreamingDistributionConfigRequest", - "documentation":"To request to get a streaming distribution configuration." - }, - "output":{ - "shape":"GetStreamingDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront" - }, - "input":{ - "shape":"ListCloudFrontOriginAccessIdentitiesRequest", - "documentation":"The request to list origin access identities." - }, - "output":{ - "shape":"ListCloudFrontOriginAccessIdentitiesResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/distribution" - }, - "input":{ - "shape":"ListDistributionsRequest", - "documentation":"The request to list your distributions." - }, - "output":{ - "shape":"ListDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List distributions." - }, - "ListInvalidations":{ - "name":"ListInvalidations2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/distribution/{DistributionId}/invalidation" - }, - "input":{ - "shape":"ListInvalidationsRequest", - "documentation":"The request to list invalidations." - }, - "output":{ - "shape":"ListInvalidationsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2014_11_06", - "http":{ - "method":"GET", - "requestUri":"/2014-11-06/streaming-distribution" - }, - "input":{ - "shape":"ListStreamingDistributionsRequest", - "documentation":"The request to list your streaming distributions." - }, - "output":{ - "shape":"ListStreamingDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2014_11_06", - "http":{ - "method":"PUT", - "requestUri":"/2014-11-06/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"UpdateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to update an origin access identity." - }, - "output":{ - "shape":"UpdateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2014_11_06", - "http":{ - "method":"PUT", - "requestUri":"/2014-11-06/distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateDistributionRequest", - "documentation":"The request to update a distribution." - }, - "output":{ - "shape":"UpdateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2014_11_06", - "http":{ - "method":"PUT", - "requestUri":"/2014-11-06/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateStreamingDistributionRequest", - "documentation":"The request to update a streaming distribution." - }, - "output":{ - "shape":"UpdateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"DistributionConfig" - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"InvalidationBatch" - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID." - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"StreamingDistributionConfig" - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The origin access identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a origin access identity.", - "required":["Id"] - }, - "DeleteDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a distribution.", - "required":["Id"] - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a streaming distribution.", - "required":["Id"] - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's configuration.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's information.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution configuration.", - "required":["Id"] - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution's information.", - "required":["Id"] - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The invalidation's id." - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"To request to get a streaming distribution configuration.", - "required":["Id"] - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"The request to get a streaming distribution's information.", - "required":["Id"] - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of origin access identities you want in the response body." - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions you want in the response body." - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of invalidation batches you want in the response body." - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of streaming distributions you want in the response body." - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"DistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2014-11-06/"}, - "locationName":"StreamingDistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate." - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2014-11-06/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/service-2.json deleted file mode 100644 index 53756041..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/service-2.json +++ /dev/null @@ -1,3637 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-04-17", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "protocol":"rest-xml" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2015_04_17", - "http":{ - "method":"POST", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{ - "shape":"CreateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to create a new origin access identity." - }, - "output":{ - "shape":"CreateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CloudFrontOriginAccessIdentityAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyCloudFrontOriginAccessIdentities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2015_04_17", - "http":{ - "method":"POST", - "requestUri":"/2015-04-17/distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateDistributionRequest", - "documentation":"The request to create a new distribution." - }, - "output":{ - "shape":"CreateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"DistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidMinimumProtocolVersion", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"TooManyDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidProtocolSettings", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - { - "shape":"InvalidTTLOrder", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2015_04_17", - "http":{ - "method":"POST", - "requestUri":"/2015-04-17/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{ - "shape":"CreateInvalidationRequest", - "documentation":"The request to create an invalidation." - }, - "output":{ - "shape":"CreateInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"BatchTooLarge", - "error":{"httpStatusCode":413}, - "exception":true - }, - { - "shape":"TooManyInvalidationsInProgress", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2015_04_17", - "http":{ - "method":"POST", - "requestUri":"/2015-04-17/streaming-distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateStreamingDistributionRequest", - "documentation":"The request to create a new streaming distribution." - }, - "output":{ - "shape":"CreateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"StreamingDistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"TooManyStreamingDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2015_04_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to delete a origin access identity." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"CloudFrontOriginAccessIdentityInUse", - "error":{"httpStatusCode":409}, - "exception":true - } - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2015_04_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-04-17/distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteDistributionRequest", - "documentation":"The request to delete a distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"DistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2015_04_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-04-17/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteStreamingDistributionRequest", - "documentation":"The request to delete a streaming distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"StreamingDistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront/{Id}" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to get an origin access identity's information." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigRequest", - "documentation":"The request to get an origin access identity's configuration." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/distribution/{Id}" - }, - "input":{ - "shape":"GetDistributionRequest", - "documentation":"The request to get a distribution's information." - }, - "output":{ - "shape":"GetDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/distribution/{Id}/config" - }, - "input":{ - "shape":"GetDistributionConfigRequest", - "documentation":"The request to get a distribution configuration." - }, - "output":{ - "shape":"GetDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{ - "shape":"GetInvalidationRequest", - "documentation":"The request to get an invalidation's information." - }, - "output":{ - "shape":"GetInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchInvalidation", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/streaming-distribution/{Id}" - }, - "input":{ - "shape":"GetStreamingDistributionRequest", - "documentation":"The request to get a streaming distribution's information." - }, - "output":{ - "shape":"GetStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"GetStreamingDistributionConfigRequest", - "documentation":"To request to get a streaming distribution configuration." - }, - "output":{ - "shape":"GetStreamingDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront" - }, - "input":{ - "shape":"ListCloudFrontOriginAccessIdentitiesRequest", - "documentation":"The request to list origin access identities." - }, - "output":{ - "shape":"ListCloudFrontOriginAccessIdentitiesResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/distribution" - }, - "input":{ - "shape":"ListDistributionsRequest", - "documentation":"The request to list your distributions." - }, - "output":{ - "shape":"ListDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List distributions." - }, - "ListInvalidations":{ - "name":"ListInvalidations2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/distribution/{DistributionId}/invalidation" - }, - "input":{ - "shape":"ListInvalidationsRequest", - "documentation":"The request to list invalidations." - }, - "output":{ - "shape":"ListInvalidationsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2015_04_17", - "http":{ - "method":"GET", - "requestUri":"/2015-04-17/streaming-distribution" - }, - "input":{ - "shape":"ListStreamingDistributionsRequest", - "documentation":"The request to list your streaming distributions." - }, - "output":{ - "shape":"ListStreamingDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2015_04_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-04-17/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"UpdateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to update an origin access identity." - }, - "output":{ - "shape":"UpdateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2015_04_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-04-17/distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateDistributionRequest", - "documentation":"The request to update a distribution." - }, - "output":{ - "shape":"UpdateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidMinimumProtocolVersion", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidTTLOrder", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2015_04_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-04-17/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateStreamingDistributionRequest", - "documentation":"The request to update a streaming distribution." - }, - "output":{ - "shape":"UpdateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"DistributionConfig" - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"InvalidationBatch" - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID." - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"StreamingDistributionConfig" - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The origin access identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a origin access identity.", - "required":["Id"] - }, - "DeleteDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a distribution.", - "required":["Id"] - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a streaming distribution.", - "required":["Id"] - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"} - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's configuration.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's information.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution configuration.", - "required":["Id"] - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution's information.", - "required":["Id"] - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The invalidation's id." - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"To request to get a streaming distribution configuration.", - "required":["Id"] - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"The request to get a streaming distribution's information.", - "required":["Id"] - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of origin access identities you want in the response body." - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions you want in the response body." - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of invalidation batches you want in the response body." - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of streaming distributions you want in the response body." - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"DistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-04-17/"}, - "locationName":"StreamingDistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate." - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-04-17/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/service-2.json deleted file mode 100644 index f909a548..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/service-2.json +++ /dev/null @@ -1,3731 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-07-27", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "protocol":"rest-xml" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2015_07_27", - "http":{ - "method":"POST", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{ - "shape":"CreateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to create a new origin access identity." - }, - "output":{ - "shape":"CreateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CloudFrontOriginAccessIdentityAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyCloudFrontOriginAccessIdentities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2015_07_27", - "http":{ - "method":"POST", - "requestUri":"/2015-07-27/distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateDistributionRequest", - "documentation":"The request to create a new distribution." - }, - "output":{ - "shape":"CreateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"DistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidMinimumProtocolVersion", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"TooManyDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidProtocolSettings", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - { - "shape":"InvalidTTLOrder", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidWebACLId", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2015_07_27", - "http":{ - "method":"POST", - "requestUri":"/2015-07-27/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{ - "shape":"CreateInvalidationRequest", - "documentation":"The request to create an invalidation." - }, - "output":{ - "shape":"CreateInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"BatchTooLarge", - "error":{"httpStatusCode":413}, - "exception":true - }, - { - "shape":"TooManyInvalidationsInProgress", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2015_07_27", - "http":{ - "method":"POST", - "requestUri":"/2015-07-27/streaming-distribution", - "responseCode":201 - }, - "input":{ - "shape":"CreateStreamingDistributionRequest", - "documentation":"The request to create a new streaming distribution." - }, - "output":{ - "shape":"CreateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"StreamingDistributionAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidOrigin", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"TooManyStreamingDistributions", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2015_07_27", - "http":{ - "method":"DELETE", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to delete a origin access identity." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"CloudFrontOriginAccessIdentityInUse", - "error":{"httpStatusCode":409}, - "exception":true - } - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2015_07_27", - "http":{ - "method":"DELETE", - "requestUri":"/2015-07-27/distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteDistributionRequest", - "documentation":"The request to delete a distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"DistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2015_07_27", - "http":{ - "method":"DELETE", - "requestUri":"/2015-07-27/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{ - "shape":"DeleteStreamingDistributionRequest", - "documentation":"The request to delete a streaming distribution." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"StreamingDistributionNotDisabled", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - } - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront/{Id}" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to get an origin access identity's information." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigRequest", - "documentation":"The request to get an origin access identity's configuration." - }, - "output":{ - "shape":"GetCloudFrontOriginAccessIdentityConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distribution/{Id}" - }, - "input":{ - "shape":"GetDistributionRequest", - "documentation":"The request to get a distribution's information." - }, - "output":{ - "shape":"GetDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distribution/{Id}/config" - }, - "input":{ - "shape":"GetDistributionConfigRequest", - "documentation":"The request to get a distribution configuration." - }, - "output":{ - "shape":"GetDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{ - "shape":"GetInvalidationRequest", - "documentation":"The request to get an invalidation's information." - }, - "output":{ - "shape":"GetInvalidationResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchInvalidation", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/streaming-distribution/{Id}" - }, - "input":{ - "shape":"GetStreamingDistributionRequest", - "documentation":"The request to get a streaming distribution's information." - }, - "output":{ - "shape":"GetStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"GetStreamingDistributionConfigRequest", - "documentation":"To request to get a streaming distribution configuration." - }, - "output":{ - "shape":"GetStreamingDistributionConfigResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront" - }, - "input":{ - "shape":"ListCloudFrontOriginAccessIdentitiesRequest", - "documentation":"The request to list origin access identities." - }, - "output":{ - "shape":"ListCloudFrontOriginAccessIdentitiesResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distribution" - }, - "input":{ - "shape":"ListDistributionsRequest", - "documentation":"The request to list your distributions." - }, - "output":{ - "shape":"ListDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distributionsByWebACLId/{WebACLId}" - }, - "input":{ - "shape":"ListDistributionsByWebACLIdRequest", - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "output":{ - "shape":"ListDistributionsByWebACLIdResult", - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidWebACLId", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/distribution/{DistributionId}/invalidation" - }, - "input":{ - "shape":"ListInvalidationsRequest", - "documentation":"The request to list invalidations." - }, - "output":{ - "shape":"ListInvalidationsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - } - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2015_07_27", - "http":{ - "method":"GET", - "requestUri":"/2015-07-27/streaming-distribution" - }, - "input":{ - "shape":"ListStreamingDistributionsRequest", - "documentation":"The request to list your streaming distributions." - }, - "output":{ - "shape":"ListStreamingDistributionsResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - } - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2015_07_27", - "http":{ - "method":"PUT", - "requestUri":"/2015-07-27/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{ - "shape":"UpdateCloudFrontOriginAccessIdentityRequest", - "documentation":"The request to update an origin access identity." - }, - "output":{ - "shape":"UpdateCloudFrontOriginAccessIdentityResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchCloudFrontOriginAccessIdentity", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2015_07_27", - "http":{ - "method":"PUT", - "requestUri":"/2015-07-27/distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateDistributionRequest", - "documentation":"The request to update a distribution." - }, - "output":{ - "shape":"UpdateDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - { - "shape":"InvalidDefaultRootObject", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - { - "shape":"InvalidRelativePath", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - { - "shape":"InvalidErrorCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidResponseCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InvalidViewerCertificate", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidMinimumProtocolVersion", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidRequiredProtocol", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - { - "shape":"NoSuchOrigin", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - { - "shape":"TooManyOrigins", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - { - "shape":"TooManyCacheBehaviors", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - { - "shape":"TooManyCookieNamesInWhiteList", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - { - "shape":"InvalidForwardCookies", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - { - "shape":"TooManyHeadersInForwardedValues", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidHeadersForS3Origin", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - { - "shape":"TooManyCertificates", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - { - "shape":"InvalidLocationCode", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidGeoRestrictionParameter", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidTTLOrder", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidWebACLId", - "error":{"httpStatusCode":400}, - "exception":true - } - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2015_07_27", - "http":{ - "method":"PUT", - "requestUri":"/2015-07-27/streaming-distribution/{Id}/config" - }, - "input":{ - "shape":"UpdateStreamingDistributionRequest", - "documentation":"The request to update a streaming distribution." - }, - "output":{ - "shape":"UpdateStreamingDistributionResult", - "documentation":"The returned result of the corresponding request." - }, - "errors":[ - { - "shape":"AccessDenied", - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - { - "shape":"CNAMEAlreadyExists", - "error":{"httpStatusCode":409}, - "exception":true - }, - { - "shape":"IllegalUpdate", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - { - "shape":"InvalidIfMatchVersion", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - { - "shape":"MissingBody", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - { - "shape":"NoSuchStreamingDistribution", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - { - "shape":"PreconditionFailed", - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - { - "shape":"TooManyStreamingDistributionCNAMEs", - "error":{"httpStatusCode":400}, - "exception":true - }, - { - "shape":"InvalidArgument", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - { - "shape":"InvalidOriginAccessIdentity", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - { - "shape":"TooManyTrustedSigners", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - { - "shape":"TrustedSignerDoesNotExist", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - { - "shape":"InconsistentQuantities", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - } - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":403}, - "exception":true, - "documentation":"Access denied." - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"DistributionConfig" - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"InvalidationBatch" - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID." - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"StreamingDistributionConfig" - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "location":"header", - "locationName":"Location", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution created." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The origin access identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a origin access identity.", - "required":["Id"] - }, - "DeleteDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a distribution.", - "required":["Id"] - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to delete a streaming distribution.", - "required":["Id"] - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution." - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's configuration.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - } - }, - "documentation":"The request to get an origin access identity's information.", - "required":["Id"] - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution configuration.", - "required":["Id"] - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - } - }, - "documentation":"The request to get a distribution's information.", - "required":["Id"] - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The invalidation's id." - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"To request to get a streaming distribution configuration.", - "required":["Id"] - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - } - }, - "documentation":"The request to get a streaming distribution's information.", - "required":["Id"] - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Origin and CallerReference cannot be updated." - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The value of Quantity and the size of Items do not match." - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The argument is invalid." - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The default root object file name is too big or contains an invalid character." - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected." - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The If-Match version is missing or not valid for the distribution." - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket." - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The origin access identity is not valid or doesn't exist." - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI)." - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/)." - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration." - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of origin access identities you want in the response body." - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)" - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100." - }, - "WebACLId":{ - "shape":"string", - "location":"uri", - "locationName":"WebACLId", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL." - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)" - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100." - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "location":"uri", - "locationName":"DistributionId", - "documentation":"The distribution's id." - }, - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of invalidation batches you want in the response body." - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "location":"querystring", - "locationName":"Marker", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page)." - }, - "MaxItems":{ - "shape":"string", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"The maximum number of streaming distributions you want in the response body." - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set." - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified origin access identity does not exist." - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified distribution does not exist." - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified invalidation does not exist." - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"No origin exists with the specified Origin Id." - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"The specified streaming distribution does not exist." - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":412}, - "exception":true, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false." - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore cache behaviors for the distribution." - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore custom ssl certificates." - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed." - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior." - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more CNAMEs than are allowed per distribution." - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed." - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects." - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"You cannot create anymore origins for the distribution." - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed." - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"Your request contains more trusted signers than are allowed per distribution." - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"One or more of your trusted signers do not exist." - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"CloudFrontOriginAccessIdentityConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The identity's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"DistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-07-27/"}, - "locationName":"StreamingDistributionConfig" - }, - "Id":{ - "shape":"string", - "location":"uri", - "locationName":"Id", - "documentation":"The streaming distribution's id." - }, - "IfMatch":{ - "shape":"string", - "location":"header", - "locationName":"If-Match", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate." - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-07-27/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/service-2.json deleted file mode 100644 index 6e2ac454..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/service-2.json +++ /dev/null @@ -1,2928 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-09-17", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2015_09_17", - "http":{ - "method":"POST", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2015_09_17", - "http":{ - "method":"POST", - "requestUri":"/2015-09-17/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2015_09_17", - "http":{ - "method":"POST", - "requestUri":"/2015-09-17/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2015_09_17", - "http":{ - "method":"POST", - "requestUri":"/2015-09-17/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2015_09_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2015_09_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-09-17/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2015_09_17", - "http":{ - "method":"DELETE", - "requestUri":"/2015-09-17/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2015_09_17", - "http":{ - "method":"GET", - "requestUri":"/2015-09-17/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2015_09_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-09-17/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2015_09_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-09-17/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2015_09_17", - "http":{ - "method":"PUT", - "requestUri":"/2015-09-17/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer" - ] - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2015-09-17/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), set to the IAM certificate identifier of the custom viewer certificate for this distribution." - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to \"cloudfront\". If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), set to \"iam\", and update the Certificate field with the IAM certificate identifier of the custom viewer certificate for this distribution." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use \"iam\" as CertificateSource and specify the IAM certificate Id as the Certificate. If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate.", - "deprecated":true - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"Note: this field is deprecated. Please use \"cloudfront\" as CertificateSource and omit specifying a Certificate. If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId.", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2015-09-17/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/service-2.json deleted file mode 100644 index d66c803b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/service-2.json +++ /dev/null @@ -1,3021 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-01-13", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_01_13", - "http":{ - "method":"POST", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_01_13", - "http":{ - "method":"POST", - "requestUri":"/2016-01-13/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_01_13", - "http":{ - "method":"POST", - "requestUri":"/2016-01-13/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_01_13", - "http":{ - "method":"POST", - "requestUri":"/2016-01-13/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_01_13", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_01_13", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-13/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_01_13", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-13/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_01_13", - "http":{ - "method":"GET", - "requestUri":"/2016-01-13/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_01_13", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-13/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_01_13", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-13/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_01_13", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-13/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom headers for this origin." - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"A complex type that contains the custom headers for this Origin." - } - }, - "documentation":"A complex type that contains the list of Custom Headers for each origin." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"A complex type that contains information about the custom headers associated with this Origin." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"The header's name." - }, - "HeaderValue":{ - "shape":"string", - "documentation":"The header's value." - } - }, - "documentation":"A complex type that contains information related to a Header" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"A complex type that contains one SslProtocol element for each SSL/TLS protocol that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - } - }, - "documentation":"A complex type that contains the list of SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-13/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), you can use your own IAM or ACM certificate. For ACM, set to the ACM certificate ARN. For IAM, set to the IAM certificate identifier." - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to \"cloudfront\". If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), you can use your own IAM or ACM certificate. To use an ACM certificate, set to \"acm\" and update the Certificate to the ACM certificate ARN. To use an IAM certificate, set to \"iam\" and update the Certificate to the IAM certificate identifier." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use \"iam\" as CertificateSource and specify the IAM certificate Id as the Certificate. If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value or CloudFrontDefaultCertificate.", - "deprecated":true - }, - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"Note: this field is deprecated. Please use \"cloudfront\" as CertificateSource and omit specifying a Certificate. If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an IAMCertificateId.", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-13/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/service-2.json deleted file mode 100644 index 18046819..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/service-2.json +++ /dev/null @@ -1,3026 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-01-28", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_01_28", - "http":{ - "method":"POST", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_01_28", - "http":{ - "method":"POST", - "requestUri":"/2016-01-28/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Create a new distribution." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_01_28", - "http":{ - "method":"POST", - "requestUri":"/2016-01-28/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_01_28", - "http":{ - "method":"POST", - "requestUri":"/2016-01-28/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_01_28", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_01_28", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-28/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_01_28", - "http":{ - "method":"DELETE", - "requestUri":"/2016-01-28/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_01_28", - "http":{ - "method":"GET", - "requestUri":"/2016-01-28/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_01_28", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-28/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_01_28", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-28/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_01_28", - "http":{ - "method":"PUT", - "requestUri":"/2016-01-28/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom headers for this origin." - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"A complex type that contains the custom headers for this Origin." - } - }, - "documentation":"A complex type that contains the list of Custom Headers for each origin." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"A complex type that contains information about the custom headers associated with this Origin." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"The header's name." - }, - "HeaderValue":{ - "shape":"string", - "documentation":"The header's value." - } - }, - "documentation":"A complex type that contains information related to a Header" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"A complex type that contains one SslProtocol element for each SSL/TLS protocol that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - } - }, - "documentation":"A complex type that contains the list of SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-01-28/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an ACMCertificateArn or IAMCertificateId." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate." - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the ACM certificate ARN of the custom viewer certificate for this distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "Certificate":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-01-28/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/service-2.json deleted file mode 100644 index 3e5291e7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/service-2.json +++ /dev/null @@ -1,3433 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-08-01", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Create a new distribution." - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"} - ], - "documentation":"Create a new distribution with tags." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"Create a new streaming distribution with tags." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_08_01", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_08_01", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-01/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_08_01", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-01/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2016_08_01", - "http":{ - "method":"GET", - "requestUri":"/2016-08-01/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"List tags for a CloudFront resource." - }, - "TagResource":{ - "name":"TagResource2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Add tags to a CloudFront resource." - }, - "UntagResource":{ - "name":"UntagResource2016_08_01", - "http":{ - "method":"POST", - "requestUri":"/2016-08-01/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Remove tags from a CloudFront resource." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_08_01", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-01/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_08_01", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-01/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_08_01", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-01/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create a new distribution with tags", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to create a new streaming distribution with tags.", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom headers for this origin." - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"A complex type that contains the custom headers for this Origin." - } - }, - "documentation":"A complex type that contains the list of Custom Headers for each origin." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"A distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A distribution Configuration and a list of tags to be associated with the distribution." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified tagging for a CloudFront resource is invalid. For more information, see the error text.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"The request to list tags for a CloudFront resource." - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified CloudFront resource does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"A complex type that contains information about the custom headers associated with this Origin." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"The header's name." - }, - "HeaderValue":{ - "shape":"string", - "documentation":"The header's value." - } - }, - "documentation":"A complex type that contains information related to a Header" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"A complex type that contains one SslProtocol element for each SSL/TLS protocol that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - } - }, - "documentation":"A complex type that contains the list of SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"A streaming distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A streaming distribution Configuration and a list of tags to be associated with the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - }, - "Value":{ - "shape":"TagValue", - "documentation":"A string that contains an optional Tag value. The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - } - }, - "documentation":"A complex type that contains Tag key and Tag value." - }, - "TagKey":{ - "type":"string", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"A complex type that contains Tag key elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements.", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to add tags to a CloudFront resource.", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"A complex type that contains Tag elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"A complex type that contains zero or more Tag key elements.", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - } - }, - "documentation":"The request to remove tags from a CloudFront resource.", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-01/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an ACMCertificateArn or IAMCertificateId." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate." - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the ACM certificate ARN of the custom viewer certificate for this distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "Certificate":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

Amazon CloudFront is a global content delivery network (CDN) service that accelerates delivery of your websites, APIs, video content or other web assets. It integrates with other Amazon Web Services products to give developers and businesses an easy way to accelerate content to end users with no minimum usage commitments.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-01/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/service-2.json deleted file mode 100644 index d0681d35..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/service-2.json +++ /dev/null @@ -1,3480 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-08-20", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Create a new distribution." - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Create a new distribution with tags." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"Create a new streaming distribution with tags." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_08_20", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_08_20", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-20/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_08_20", - "http":{ - "method":"DELETE", - "requestUri":"/2016-08-20/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2016_08_20", - "http":{ - "method":"GET", - "requestUri":"/2016-08-20/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"List tags for a CloudFront resource." - }, - "TagResource":{ - "name":"TagResource2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Add tags to a CloudFront resource." - }, - "UntagResource":{ - "name":"UntagResource2016_08_20", - "http":{ - "method":"POST", - "requestUri":"/2016-08-20/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Remove tags from a CloudFront resource." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_08_20", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-20/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_08_20", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-20/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_08_20", - "http":{ - "method":"PUT", - "requestUri":"/2016-08-20/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create a new distribution with tags", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to create a new streaming distribution with tags.", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom headers for this origin." - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"A complex type that contains the custom headers for this Origin." - } - }, - "documentation":"A complex type that contains the list of Custom Headers for each origin." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"A distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A distribution Configuration and a list of tags to be associated with the distribution." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

  • If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.
  • If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.
  • If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.
" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified tagging for a CloudFront resource is invalid. For more information, see the error text.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"The request to list tags for a CloudFront resource." - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified CloudFront resource does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"A complex type that contains information about the custom headers associated with this Origin." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"The header's name." - }, - "HeaderValue":{ - "shape":"string", - "documentation":"The header's value." - } - }, - "documentation":"A complex type that contains information related to a Header" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"A complex type that contains one SslProtocol element for each SSL/TLS protocol that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - } - }, - "documentation":"A complex type that contains the list of SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted query string parameters for this cache behavior." - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"Optional: A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items." - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"A streaming distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A streaming distribution Configuration and a list of tags to be associated with the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - }, - "Value":{ - "shape":"TagValue", - "documentation":"A string that contains an optional Tag value. The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - } - }, - "documentation":"A complex type that contains Tag key and Tag value." - }, - "TagKey":{ - "type":"string", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"A complex type that contains Tag key elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements.", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to add tags to a CloudFront resource.", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"A complex type that contains Tag elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"A complex type that contains zero or more Tag key elements.", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - } - }, - "documentation":"The request to remove tags from a CloudFront resource.", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-08-20/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an ACMCertificateArn or IAMCertificateId." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate." - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the ACM certificate ARN of the custom viewer certificate for this distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "Certificate":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

Amazon CloudFront is a global content delivery network (CDN) service that accelerates delivery of your websites, APIs, video content or other web assets. It integrates with other Amazon Web Services products to give developers and businesses an easy way to accelerate content to end users with no minimum usage commitments.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-08-20/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/service-2.json deleted file mode 100644 index 15b6d9bd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/service-2.json +++ /dev/null @@ -1,3496 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-09-07", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new origin access identity." - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Create a new distribution." - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Create a new distribution with tags." - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new invalidation." - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Create a new streaming distribution." - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"Create a new streaming distribution with tags." - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_09_07", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"Delete an origin access identity." - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_09_07", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-07/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a distribution." - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_09_07", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-07/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"Delete a streaming distribution." - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an origin access identity." - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about an origin access identity." - }, - "GetDistribution":{ - "name":"GetDistribution2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a distribution." - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a distribution." - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about an invalidation." - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the information about a streaming distribution." - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"Get the configuration information about a streaming distribution." - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List origin access identities." - }, - "ListDistributions":{ - "name":"ListDistributions2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List distributions." - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"List the distributions that are associated with a specified AWS WAF web ACL." - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"List invalidation batches." - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"List streaming distributions." - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2016_09_07", - "http":{ - "method":"GET", - "requestUri":"/2016-09-07/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"List tags for a CloudFront resource." - }, - "TagResource":{ - "name":"TagResource2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Add tags to a CloudFront resource." - }, - "UntagResource":{ - "name":"UntagResource2016_09_07", - "http":{ - "method":"POST", - "requestUri":"/2016-09-07/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"Remove tags from a CloudFront resource." - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_09_07", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-07/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update an origin access identity." - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_09_07", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-07/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"Update a distribution." - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_09_07", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-07/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"Update a streaming distribution." - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Access denied.", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Each active trusted signer." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of unique trusted signers included in all cache behaviors. For example, if three cache behaviors all list the same three AWS accounts, the value of Quantity for ActiveTrustedSigners will be 3." - }, - "Items":{ - "shape":"SignerList", - "documentation":"A complex type that contains one Signer complex type for each unique trusted signer that is specified in the TrustedSigners complex type, including trusted signers in the default cache behavior and in all of the other cache behaviors." - } - }, - "documentation":"A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for the default cache behavior or for any of the other cache behaviors for this distribution. These are accounts that you want to allow to create signed URLs for private content." - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of CNAMEs, if any, for this distribution." - }, - "Items":{ - "shape":"AliasList", - "documentation":"Optional: A complex type that contains CNAME elements, if any, for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin." - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GET and HEAD requests. - CloudFront forwards only GET, HEAD and OPTIONS requests. - CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests. If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you may not want users to have permission to delete objects from your origin." - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"The pattern (for example, images/*.jpg) that specifies which requests you want this cache behavior to apply to. When CloudFront receives an end-user request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior." - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes how CloudFront processes requests. You can create up to 10 cache behaviors.You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin will never be used. If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error. To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element. To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution." - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of cache behaviors for this distribution." - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests)." - }, - "Items":{ - "shape":"MethodsList", - "documentation":"A complex type that contains the HTTP methods that you want CloudFront to cache responses to." - } - }, - "documentation":"A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GET and HEAD requests. - CloudFront caches responses to GET, HEAD, and OPTIONS requests. If you pick the second choice for your S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers and Origin headers for the responses to be cached correctly." - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The current configuration information for the identity." - } - }, - "documentation":"CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created. If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the origin access identity." - } - }, - "documentation":"Origin access identity configuration." - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of CloudFront origin access identities that were created by the current AWS account." - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account." - } - }, - "documentation":"The CloudFrontOriginAccessIdentityList type." - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The ID for the origin access identity. For example: E74FTE3AJFJ256A." - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment for this origin access identity, as originally specified when created." - } - }, - "documentation":"Summary of the information about a CloudFront origin access identity." - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted cookies for this cache behavior." - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"Optional: A complex type that contains whitelisted cookies for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"Use this element to specify whether you want CloudFront to forward cookies to the origin that is associated with this cache behavior. You can specify all, none or whitelist. If you choose All, CloudFront forwards all cookies regardless of how many your application uses." - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"A complex type that specifies the whitelisted cookies, if any, that you want CloudFront to forward to your origin that is associated with this cache behavior." - } - }, - "documentation":"A complex type that specifies the cookie preferences associated with this cache behavior." - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create a new origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create a new distribution.", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create a new distribution with tags", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The batch information for the invalidation.", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create an invalidation.", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create a new streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to create a new streaming distribution with tags.", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "Location":{ - "shape":"string", - "documentation":"The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution created.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"The 4xx or 5xx HTTP status code that you want to customize. For a list of HTTP status codes that you can customize, see CloudFront documentation." - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"The path of the custom error page (for example, /custom_404.html). The path is relative to the distribution and must begin with a slash (/). If the path includes any non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not return the custom error page to the viewer." - }, - "ResponseCode":{ - "shape":"string", - "documentation":"The HTTP status code that you want CloudFront to return with the custom error page to the viewer. For a list of HTTP status codes that you can replace, see CloudFront Documentation." - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time you want HTTP error codes to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated. You can specify a value from 0 to 31,536,000." - } - }, - "documentation":"A complex type that describes how you'd prefer CloudFront to respond to requests that result in either a 4xx or 5xx response. You can control whether a custom error page should be displayed, what the desired response code should be for this error page and how long should the error response be cached by CloudFront. If you don't want to specify any custom error responses, include only an empty CustomErrorResponses element. To delete all custom error responses in an existing distribution, update the distribution configuration and include only an empty CustomErrorResponses element. To add, change, or remove one or more custom error responses, update the distribution configuration and specify all of the custom error responses that you want to include in the updated distribution." - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom error responses for this distribution." - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"Optional: A complex type that contains custom error responses for this distribution. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of custom headers for this origin." - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"A complex type that contains the custom headers for this Origin." - } - }, - "documentation":"A complex type that contains the list of Custom Headers for each origin." - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"The HTTP port the custom origin listens on." - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"The HTTPS port the custom origin listens on." - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"The origin protocol policy to apply to your origin." - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - } - }, - "documentation":"A customer origin." - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior." - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"Use this element to specify the protocol that users can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. If you want CloudFront to allow end users to use any available protocol, specify allow-all. If you want CloudFront to require HTTPS, specify https. If you want CloudFront to respond to an HTTP request with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL, specify redirect-to-https. The viewer then resubmits the request using the HTTPS URL." - }, - "MinTTL":{ - "shape":"long", - "documentation":"The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront queries your origin to see whether the object has been updated.You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"Indicates whether you want to distribute media files in Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false." - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"If you don't configure your origin to add a Cache-Control max-age directive or an Expires header, DefaultTTL is the default amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "MaxTTL":{ - "shape":"long", - "documentation":"The maximum amount of time (in seconds) that an object is in a CloudFront cache before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. You can specify a value from 0 to 3,153,600,000 seconds (100 years)." - }, - "Compress":{ - "shape":"boolean", - "documentation":"Whether you want CloudFront to automatically compress content for web requests that include Accept-Encoding: gzip in the request header. If so, specify true; if not, specify false. CloudFront compresses files larger than 1000 bytes and less than 1 megabyte for both Amazon S3 and custom origins. When a CloudFront edge location is unusually busy, some files might not be compressed. The value of the Content-Type header must be on the list of file types that CloudFront will compress. For the current list, see Serving Compressed Content in the Amazon CloudFront Developer Guide. If you configure CloudFront to compress content, CloudFront removes the ETag response header from the objects that it compresses. The ETag header indicates that the version in a CloudFront edge cache is identical to the version on the origin server, but after compression the two versions are no longer identical. As a result, for compressed objects, CloudFront can't use the ETag header to determine whether an expired object in the CloudFront edge cache is still the latest version." - } - }, - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The origin access identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a origin access identity." - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a distribution." - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to delete a streaming distribution." - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"The number of invalidation batches currently in progress." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The current configuration information for the distribution." - } - }, - "documentation":"A distribution." - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The caller reference you attempted to create the distribution with is associated with another distribution.", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the DistributionConfig object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create a distribution, and the content of the DistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"The object that you want CloudFront to return (for example, index.html) when an end user requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/index.html). Specifying a default root object avoids exposing the contents of your distribution. If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element. To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element. To replace the default root object, update the distribution configuration and specify the new object." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponse elements." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the distribution." - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"(Optional) If you're using AWS WAF to filter CloudFront requests, the Id of the AWS WAF web ACL that is associated with the distribution." - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"(Optional) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version." - } - }, - "documentation":"A distribution Configuration." - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"A distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A distribution Configuration and a list of tags to be associated with the distribution." - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A distribution list." - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId", - "HttpVersion" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution." - }, - "Origins":{ - "shape":"Origins", - "documentation":"A complex type that contains information about origins for this distribution." - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements.You must create exactly one default cache behavior." - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"A complex type that contains zero or more CacheBehavior elements." - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"A complex type that contains zero or more CustomErrorResponses elements." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"The Web ACL Id (if any) associated with the distribution." - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront distribution." - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

  • If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.
  • If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.
  • If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.
" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"A complex type that specifies how CloudFront handles cookies." - }, - "Headers":{ - "shape":"Headers", - "documentation":"A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior." - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"A complex type that specifies how CloudFront handles query strings, cookies and headers." - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"The method that you want to use to restrict distribution of your content by country: - none: No geo restriction is enabled, meaning access to content is not restricted by client geo location. - blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content. - whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content." - }, - "Quantity":{ - "shape":"integer", - "documentation":"When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items." - }, - "Items":{ - "shape":"LocationList", - "documentation":"A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country. CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes." - } - }, - "documentation":"A complex type that controls the countries in which your content is distributed. For more information about geo restriction, go to Customizing Error Responses in the Amazon CloudFront Developer Guide. CloudFront determines the location of your users using MaxMind GeoIP databases. For information about the accuracy of these databases, see How accurate are your GeoIP databases? on the MaxMind website." - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's configuration." - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The origin access identity's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an origin access identity's information." - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution configuration." - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a distribution's information." - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"The invalidation's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get an invalidation's information." - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"The invalidation's information." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"To request to get a streaming distribution configuration." - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"The request to get a streaming distribution's information." - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of different headers that you want CloudFront to forward to the origin and to vary on for this cache behavior. The maximum number of headers that you can specify by name is 10. If you want CloudFront to forward all headers to the origin and vary on all of them, specify 1 for Quantity and * for Name. If you don't want CloudFront to forward any additional headers to the origin or to vary on any headers, specify 0 for Quantity and omit Items." - }, - "Items":{ - "shape":"HeaderList", - "documentation":"Optional: A complex type that contains a Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items." - } - }, - "documentation":"A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior. For the headers that you specify, CloudFront also caches separate versions of a given object based on the header values in viewer requests; this is known as varying on headers. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to vary on the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value." - }, - "HttpVersion":{ - "type":"string", - "enum":[ - "http1.1", - "http2" - ] - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Origin and CallerReference cannot be updated.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The value of Quantity and the size of Items do not match.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The argument is invalid.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The default root object file name is too big or contains an invalid character.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The If-Match version is missing or not valid for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The origin access identity is not valid or doesn't exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that Support Server Name Indication (SNI).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The relative path is too big, is not URL-encoded, or does not begin with a slash (/).", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified tagging for a CloudFront resource is invalid. For more information, see the error text.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the invalidation request. For example: IDFDVBD632BHDS5." - }, - "Status":{ - "shape":"string", - "documentation":"The status of the invalidation request. When the invalidation batch is finished, the status is Completed." - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"The date and time the invalidation request was first made." - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"The current invalidation information for the batch request." - } - }, - "documentation":"An invalidation." - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"The path of the object to invalidate. The path is relative to the distribution and must begin with a slash (/). You must enclose each invalidation object with the Path element tags. If the path includes non-ASCII characters or unsafe characters as defined in RFC 1783 (http://www.ietf.org/rfc/rfc1738.txt), URL encode those characters. Do not URL encode any other characters in the path, or CloudFront will not invalidate the old version of the updated object." - }, - "CallerReference":{ - "shape":"string", - "documentation":"A unique name that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the Path object), a new distribution is created. If the CallerReference is a value you already sent in a previous request to create an invalidation batch, and the content of each Path element is identical to the original request, the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a distribution but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error." - } - }, - "documentation":"An invalidation batch." - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your invalidation batches where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of invalidation batches that were created by the current AWS account." - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"A complex type that contains one InvalidationSummary element for each invalidation batch that was created by the current AWS account." - } - }, - "documentation":"An invalidation list." - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The unique ID for an invalidation request." - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"The status of an invalidation request." - } - }, - "documentation":"Summary of an invalidation request." - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of active CloudFront key pairs for AwsAccountNumber." - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of origin access identities you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list origin access identities." - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"The CloudFrontOriginAccessIdentityList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"The Id of the AWS WAF web ACL for which you want to list the associated distributions. If you specify \"null\" for the Id, the request returns a list of the distributions that aren't associated with a web ACL.", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"The request to list distributions that are associated with a specified AWS WAF web ACL." - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your distributions." - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"The DistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of invalidation batches you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list invalidations." - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"Information about invalidation batches." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"Use this when paginating results to indicate where to begin in your list of streaming distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"The maximum number of streaming distributions you want in the response body.", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"The request to list your streaming distributions." - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"The StreamingDistributionList type." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"The request to list tags for a CloudFront resource." - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix and IncludeCookies, the values are automatically deleted." - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for the distribution." - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"This operation requires a body. Ensure that the body is present and the Content-Type header is set.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified origin access identity does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified invalidation does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"No origin exists with the specified Origin Id.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified CloudFront resource does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The specified streaming distribution does not exist.", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"A unique identifier for the origin. The value of Id must be unique within the distribution. You use the value of Id when you create a cache behavior. The Id identifies the origin that CloudFront routes a request to when the request matches the path pattern for that cache behavior." - }, - "DomainName":{ - "shape":"string", - "documentation":"Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. Custom origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com." - }, - "OriginPath":{ - "shape":"string", - "documentation":"An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName." - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"A complex type that contains information about the custom headers associated with this Origin." - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead." - } - }, - "documentation":"A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files.You must create at least one origin." - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"The header's name." - }, - "HeaderValue":{ - "shape":"string", - "documentation":"The header's value." - } - }, - "documentation":"A complex type that contains information related to a Header" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"A complex type that contains one SslProtocol element for each SSL/TLS protocol that you want to allow CloudFront to use when establishing an HTTPS connection with this origin." - } - }, - "documentation":"A complex type that contains the list of SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS." - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of origins for this distribution." - }, - "Items":{ - "shape":"OriginList", - "documentation":"A complex type that contains origins for this distribution." - } - }, - "documentation":"A complex type that contains information about origins for this distribution." - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of objects that you want to invalidate." - }, - "Items":{ - "shape":"PathList", - "documentation":"A complex type that contains a list of the objects that you want to invalidate." - } - }, - "documentation":"A complex type that contains information about the objects that you want to invalidate." - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"The precondition given in one or more of the request-header fields evaluated to false.", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"The number of whitelisted query string parameters for this cache behavior." - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"Optional: A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items." - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"A complex type that identifies ways in which you want to restrict distribution of your content." - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"The DNS name of the S3 origin." - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"Your S3 origin's origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that end users can only access objects in an Amazon S3 bucket through CloudFront. If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. Use the format origin-access-identity/cloudfront/Id where Id is the value that CloudFront returned in the Id element when you created the origin access identity." - } - }, - "documentation":"A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead." - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"Specifies an AWS account that can create signed URLs. Values: self, which indicates that the AWS account that was used to create the distribution can created signed URLs, or an AWS account number. Omit the dashes in the account number." - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber." - } - }, - "documentation":"A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any." - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the streaming distribution. For example: EGTXBD79H29TRA8." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"The current status of the streaming distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net." - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs." - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The current configuration information for the streaming distribution." - } - }, - "documentation":"A streaming distribution." - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"A unique number that ensures the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"Any comments you want to include about the streaming distribution." - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"A complex type that controls whether access logs are written for the streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"A complex type that contains information about price class for this streaming distribution." - }, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the streaming distribution is enabled to accept end user requests for content." - } - }, - "documentation":"The configuration for the streaming distribution." - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"A streaming distribution Configuration." - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements." - } - }, - "documentation":"A streaming distribution Configuration and a list of tags to be associated with the streaming distribution." - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"The value you provided for the Marker request parameter." - }, - "NextMarker":{ - "shape":"string", - "documentation":"If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your streaming distributions where they left off." - }, - "MaxItems":{ - "shape":"integer", - "documentation":"The value you provided for the MaxItems request parameter." - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of streaming distributions that were created by the current AWS account." - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account." - } - }, - "documentation":"A streaming distribution list." - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"The identifier for the distribution. For example: EDFDVBD632BHDS5." - }, - "ARN":{ - "shape":"string", - "documentation":"The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account Id." - }, - "Status":{ - "shape":"string", - "documentation":"Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system." - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"The date and time the distribution was last modified." - }, - "DomainName":{ - "shape":"string", - "documentation":"The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net." - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution." - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution." - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "Comment":{ - "shape":"string", - "documentation":"The comment originally specified when this distribution was created." - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"Whether the distribution is enabled to accept end user requests for content." - } - }, - "documentation":"A summary of the information for an Amazon CloudFront streaming distribution." - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted." - }, - "Bucket":{ - "shape":"string", - "documentation":"The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com." - }, - "Prefix":{ - "shape":"string", - "documentation":"An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element." - } - }, - "documentation":"A complex type that controls whether access logs are written for this streaming distribution." - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - }, - "Value":{ - "shape":"TagValue", - "documentation":"A string that contains an optional Tag value. The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @." - } - }, - "documentation":"A complex type that contains Tag key and Tag value." - }, - "TagKey":{ - "type":"string", - "documentation":"A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"A complex type that contains Tag key elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"A complex type that contains zero or more Tag elements.", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to add tags to a CloudFront resource.", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"A complex type that contains Tag elements" - } - }, - "documentation":"A complex type that contains zero or more Tag elements." - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore cache behaviors for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore custom ssl certificates.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of origin access identities allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more cookie names in the whitelist than are allowed per cache behavior.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more CNAMEs than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"You cannot create anymore origins for the distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Processing your request would cause you to exceed the maximum number of streaming distributions allowed.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"Your request contains more trusted signers than are allowed per distribution.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"One or more of your trusted signers do not exist.", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"Specifies whether you want to require end users to use signed URLs to access the files specified by PathPattern and TargetOriginId." - }, - "Quantity":{ - "shape":"integer", - "documentation":"The number of trusted signers for this cache behavior." - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items." - } - }, - "documentation":"A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, go to Using a Signed URL to Serve Private Content in the Amazon CloudFront Developer Guide. If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution." - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"An ARN of a CloudFront resource.", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"A complex type that contains zero or more Tag key elements.", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - } - }, - "documentation":"The request to remove tags from a CloudFront resource.", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"The identity's configuration information.", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - }, - "Id":{ - "shape":"string", - "documentation":"The identity's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update an origin access identity.", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"The origin access identity's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"The distribution's configuration information.", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - }, - "Id":{ - "shape":"string", - "documentation":"The distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a distribution.", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"The distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"The streaming distribution's configuration information.", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-07/"} - }, - "Id":{ - "shape":"string", - "documentation":"The streaming distribution's id.", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"The value of the ETag header you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"The request to update a streaming distribution.", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"The streaming distribution's information." - }, - "ETag":{ - "shape":"string", - "documentation":"The current version of the configuration. For example: E2QWRUHAPOMQZL.", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"The returned result of the corresponding request.", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an ACMCertificateArn or IAMCertificateId." - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate." - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the ACM certificate ARN of the custom viewer certificate for this distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate." - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"If you specify a value for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests. Valid values are vip and sni-only. If you specify vip, CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges. If you specify sni-only, CloudFront can only respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. Do not specify a value for SSLSupportMethod if you specified true for CloudFrontDefaultCertificate." - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"Specify the minimum version of the SSL protocol that you want CloudFront to use, SSLv3 or TLSv1, for HTTPS connections. CloudFront will serve your objects only to browsers or devices that support at least the SSL version that you specify. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using dedicated IP (if you specify vip for SSLSupportMethod), you can choose SSLv3 or TLSv1 as the MinimumProtocolVersion. If you're using a custom certificate (if you specify a value for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion." - }, - "Certificate":{ - "shape":"string", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"Note: this field is deprecated. Please use one of [ACMCertificateArn, IAMCertificateId, CloudFrontDefaultCertificate].", - "deprecated":true - } - }, - "documentation":"A complex type that contains information about viewer certificates for this distribution." - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

Amazon CloudFront is a global content delivery network (CDN) service that accelerates delivery of your websites, APIs, video content or other web assets. It integrates with other Amazon Web Services products to give developers and businesses an easy way to accelerate content to end users with no minimum usage commitments.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-07/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/service-2.json deleted file mode 100644 index c920205e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/service-2.json +++ /dev/null @@ -1,3496 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-09-29", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"

Creates a new web distribution. Send a GET request to the /CloudFront API version/distribution/distribution ID resource.

" - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"

Create a new distribution with tags.

" - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Create a new invalidation.

" - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

" - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"

Create a new streaming distribution with tags.

" - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_09_29", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"

Delete an origin access identity.

" - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_09_29", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-29/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a distribution.

" - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_09_29", - "http":{ - "method":"DELETE", - "requestUri":"/2016-09-29/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an origin access identity.

" - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about an origin access identity.

" - }, - "GetDistribution":{ - "name":"GetDistribution2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about a distribution.

" - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a distribution.

" - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an invalidation.

" - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Gets information about a specified RTMP distribution, including the distribution configuration.

" - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a streaming distribution.

" - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

Lists origin access identities.

" - }, - "ListDistributions":{ - "name":"ListDistributions2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List distributions.

" - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"

List the distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Lists invalidation batches.

" - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List streaming distributions.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2016_09_29", - "http":{ - "method":"GET", - "requestUri":"/2016-09-29/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

List tags for a CloudFront resource.

" - }, - "TagResource":{ - "name":"TagResource2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Add tags to a CloudFront resource.

" - }, - "UntagResource":{ - "name":"UntagResource2016_09_29", - "http":{ - "method":"POST", - "requestUri":"/2016-09-29/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Remove tags from a CloudFront resource.

" - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_09_29", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-29/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update an origin access identity.

" - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_09_29", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-29/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"} - ], - "documentation":"

Update a distribution.

" - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_09_29", - "http":{ - "method":"PUT", - "requestUri":"/2016-09-29/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update a streaming distribution.

" - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Access denied.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Enabled is true if any of the AWS accounts listed in the TrustedSigners complex type for this RTMP distribution have active CloudFront key pairs. If not, Enabled is false.

For more information, see ActiveTrustedSigners.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"SignerList", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer that is specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CNAME aliases, if any, that you want to associate with this distribution.

" - }, - "Items":{ - "shape":"AliasList", - "documentation":"

A complex type that contains the CNAME aliases, if any, that you want to associate with this distribution.

" - } - }, - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD, and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin.

" - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"

A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:

  • CloudFront forwards only GET and HEAD requests.

  • CloudFront forwards only GET, HEAD, and OPTIONS requests.

  • CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests.

If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin.

" - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"

The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution.

You can optionally include a slash (/) at the beginning of the path pattern. For example, /images/*.jpg. CloudFront behavior is the same with or without the leading /.

The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior.

For more information, see Path Pattern in the Amazon CloudFront Developer Guide.

" - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{ - "shape":"long", - "documentation":"

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that describes how CloudFront processes requests.

You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.

For the current limit on the number of cache behaviors that you can add to a distribution, see Amazon CloudFront Limits in the AWS General Reference.

If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error.

To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.

To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.

For more information about cache behaviors, see Cache Behaviors in the Amazon CloudFront Developer Guide.

" - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of cache behaviors for this distribution.

" - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"

Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to cache responses to.

" - } - }, - "documentation":"

A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:

  • CloudFront caches responses to GET and HEAD requests.

  • CloudFront caches responses to GET, HEAD, and OPTIONS requests.

If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly.

" - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

" - } - }, - "documentation":"

CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created.

If the CallerReference is a value already sent in a previous identity request, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request.

If the CallerReference is a value you already sent in a previous request to create an identity, but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the origin access identity.

" - } - }, - "documentation":"

Origin access identity configuration. Send a GET request to the /CloudFront API version/CloudFront/identity ID/config resource.

" - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of origin access identities you want in the response body.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CloudFront origin access identities that were created by the current AWS account.

" - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"

A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account.

" - } - }, - "documentation":"

Lists the origin access identities for CloudFront.Send a GET request to the /CloudFront API version/origin-access-identity/cloudfront resource. The response includes a CloudFrontOriginAccessIdentityList element with zero or more CloudFrontOriginAccessIdentitySummary child elements. By default, your entire list of origin access identities is returned in one single page. If the list is long, you can paginate it using the MaxItems and Marker parameters.

" - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment for this origin access identity, as originally specified when created.

" - } - }, - "documentation":"

Summary of the information about a CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different cookies that you want CloudFront to forward to the origin for this cache behavior.

" - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"

A complex type that contains one Name element for each cookie that you want CloudFront to forward to the origin for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"

Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNames complex type.

Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for the Forward element.

" - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"

Required if you specify whitelist for the value of Forward:. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies.

If you specify all or none for the value of Forward, omit WhitelistedNames. If you change the value of Forward from whitelist to all or none and you don't delete the WhitelistedNames element and its child elements, CloudFront deletes them automatically.

For the current limit on the number of cookie names that you can whitelist for each cache behavior, see Amazon CloudFront Limits in the AWS General Reference.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create a new origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create a new distribution.

", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create a new distribution with tags.

", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The batch information for the invalidation.

", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create an invalidation.

", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.

", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create a new streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to create a new streaming distribution with tags.

", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"

The HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"

The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by ErrorCode, for example, /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:

  • The value of PathPattern matches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named /4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example, /4xx-errors/*.

  • The value of TargetOriginId specifies the value of the ID element for the origin that contains your custom error pages.

If you specify a value for ResponsePagePath, you must also specify a value for ResponseCode. If you don't want to specify a value, include an empty element, <ResponsePagePath>, in the XML document.

We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.

" - }, - "ResponseCode":{ - "shape":"string", - "documentation":"

The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example:

  • Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.

  • If you don't care about distinguishing among different client errors or server errors, you can specify 400 or 500 as the ResponseCode for all 4xx or 5xx errors.

  • You might want to return a 200 status code (OK) and static website so your customers don't know that your website is down.

If you specify a value for ResponseCode, you must also specify a value for ResponsePagePath. If you don't want to specify a value, include an empty element, <ResponseCode>, in the XML document.

" - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available.

If you don't want to specify a value, include an empty element, <ErrorCachingMinTTL>, in the XML document.

For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP status codes for which you want to specify a custom error page and/or a caching duration. If Quantity is 0, you can omit Items.

" - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"

A complex type that contains a CustomErrorResponse element for each HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of custom headers, if any, for this distribution.

" - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"

Optional: A list that contains one OriginCustomHeader element for each custom header that you want CloudFront to forward to the origin. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that contains the list of Custom Headers for each origin.

" - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"

The HTTP port the custom origin listens on.

" - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"

The HTTPS port the custom origin listens on.

" - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"

The origin protocol policy to apply to your origin.

" - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"

The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS.

" - } - }, - "documentation":"

A customer origin.

" - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{"shape":"long"}, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The origin access identity's ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

Deletes a origin access identity.

" - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the following steps.

To delete a web distribution using the CloudFront API:

  1. Disable the web distribution

  2. Submit a GET Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 2.

  5. Review the response to the PUT Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Distribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 6.

  8. Review the response to your DELETE Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to delete a streaming distribution.

" - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"

The number of invalidation batches currently in progress.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs.

" - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.

" - } - }, - "documentation":"

The distribution's information.

" - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The caller reference you attempted to create the distribution with is associated with another distribution.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique value (for example, a date-time stamp) that ensures that the request can't be replayed.

If the value of CallerReference is new (regardless of the content of the DistributionConfig object), CloudFront creates a new distribution.

If CallerReference is a value you already sent in a previous request to create a distribution, and if the content of the DistributionConfig is identical to the original request (ignoring white space), CloudFront returns the same the response that it returned to the original request.

If CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"

The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/product-description.html). Specifying a default root object avoids exposing the contents of your distribution.

Specify only the object name, for example, index.html. Do not add a / before the object name.

If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element.

To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element.

To replace the default root object, update the distribution configuration and specify the new object.

For more information about the default root object, see Creating a Default Root Object in the Amazon CloudFront Developer Guide.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that controls the following:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the distribution.

If you don't want to specify a comment, include an empty Comment element.

To delete an existing comment, update the distribution configuration and include an empty Comment element.

To add or change a comment, update the distribution configuration and specify the new comment.

" - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the distribution.

For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify PriceClass_All, CloudFront responds to requests for your objects from all CloudFront edge locations.

If you specify a price class other than PriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance.

For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes map to CloudFront regions, see Amazon CloudFront Pricing.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket.

If you do not want to enable logging when you create a distribution, or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements.

If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

A unique identifier that specifies the AWS WAF web ACL, if any, to associate with this distribution.

AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about AWS WAF, see the AWS WAF Developer Guide.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

(Optional) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 automatically use an earlier HTTP version.

For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or later, and must support Server Name Identification (SNI).

In general, configuring CloudFront to communicate with viewers using HTTP/2 reduces latency. You can improve performance by optimizing for HTTP/2. For more information, do an Internet search for \"http/2 optimization.\"

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify true. If you specify false, CloudFront responds to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.

In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the IpAddress parameter to restrict the IP addresses that can access your content, do not enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide.

If you're using an Amazon Route 53 alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:

  • You enable IPv6 for the distribution

  • You're using alternate domain names in the URLs for your objects

For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Amazon Route 53 Developer Guide.

If you created a CNAME resource record set, either with Amazon Route 53 or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request.

" - } - }, - "documentation":"

A distribution configuration.

" - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

A distribution configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A distribution Configuration and a list of tags to be associated with the distribution.

" - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"

A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A distribution list.

" - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId", - "HttpVersion", - "IsIPV6Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that contains zero or more CustomErrorResponses elements.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept user requests for content.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

The Web ACL Id (if any) associated with the distribution.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.

" - } - }, - "documentation":"

A summary of the information about a CloudFront distribution.

" - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.

If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.

If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.

For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.

" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "Headers":{ - "shape":"Headers", - "documentation":"

A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior.

" - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"

The method that you want to use to restrict distribution of your content by country:

  • none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.

  • blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content.

  • whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items.

" - }, - "Items":{ - "shape":"LocationList", - "documentation":"

A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist).

The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country.

CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes.

" - } - }, - "documentation":"

A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using MaxMind GeoIP databases.

" - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType.

" - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The origin access identity's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an origin access identity's information.

" - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution configuration.

" - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution's information.

" - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request, for example, IDFDVBD632BHDS5.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an invalidation's information.

" - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information. For more information, see Invalidation Complex Type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

To request to get a streaming distribution configuration.

" - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a streaming distribution's information.

" - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different headers that you want CloudFront to forward to the origin for this cache behavior. You can configure each cache behavior in a web distribution to do one of the following:

  • Forward all headers to your origin: Specify 1 for Quantity and * for Name.

    If you configure CloudFront to forward all headers to your origin, CloudFront doesn't cache the objects associated with this cache behavior. Instead, it sends every request to the origin.

  • Forward a whitelist of headers you specify: Specify the number of headers that you want to forward, and specify the header names in Name elements. CloudFront caches your objects based on the values in all of the specified headers. CloudFront also forwards the headers that it forwards by default, but it caches your objects based only on the headers that you specify.

  • Forward only the default headers: Specify 0 for Quantity and omit Items. In this configuration, CloudFront doesn't cache based on the values in the request headers.

" - }, - "Items":{ - "shape":"HeaderList", - "documentation":"

A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior.

For the headers that you specify, CloudFront also caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to cache your content based on values in the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value. For more information about caching based on header values, see How CloudFront Forwards and Caches Headers in the Amazon CloudFront Developer Guide.

" - }, - "HttpVersion":{ - "type":"string", - "enum":[ - "http1.1", - "http2" - ] - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Origin and CallerReference cannot be updated.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The value of Quantity and the size of Items do not match.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The argument is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The default root object file name is too big or contains an invalid character.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The If-Match version is missing or not valid for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The origin access identity is not valid or doesn't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request. For example: IDFDVBD632BHDS5.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The status of the invalidation request. When the invalidation batch is finished, the status is Completed.

" - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"

The date and time the invalidation request was first made.

" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The current invalidation information for the batch request.

" - } - }, - "documentation":"

An invalidation.

" - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "CallerReference":{ - "shape":"string", - "documentation":"

A value that you specify to uniquely identify an invalidation request. CloudFront uses the value to prevent you from accidentally resubmitting an identical request. Whenever you create a new invalidation request, you must specify a new value for CallerReference and change other values in the request as applicable. One way to ensure that the value of CallerReference is unique is to use a timestamp, for example, 20120301090000.

If you make a second invalidation request with the same value for CallerReference, and if the rest of the request is the same, CloudFront doesn't create a new invalidation request. Instead, CloudFront returns information about the invalidation request that you previously created with the same CallerReference.

If CallerReference is a value you already sent in a previous invalidation batch request but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error.

" - } - }, - "documentation":"

An invalidation batch.

" - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value that you can use for the Marker request parameter to continue listing your invalidation batches where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value that you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of invalidation batches that were created by the current AWS account.

" - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"

A complex type that contains one InvalidationSummary element for each invalidation batch created by the current AWS account.

" - } - }, - "documentation":"

The InvalidationList complex type describes the list of invalidation objects. For more information about invalidation, see Invalidating Objects (Web Distributions Only) in the Amazon CloudFront Developer Guide.

" - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The unique ID for an invalidation request.

" - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"

The status of an invalidation request.

" - } - }, - "documentation":"

A summary of an invalidation request.

" - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of active CloudFront key pairs for AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of origin access identities you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list origin access identities.

" - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"

The CloudFrontOriginAccessIdentityList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"

The ID of the AWS WAF web ACL that you want to list the associated distributions. If you specify \"null\" for the ID, the request returns a list of the distributions that aren't associated with a web ACL.

", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"

The request to list distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.

", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your distributions.

" - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"

Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of invalidation batches that you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list invalidations.

" - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"

Information about invalidation batches.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The value that you provided for the MaxItems request parameter.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your streaming distributions.

" - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"

The StreamingDistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"

The request to list tags for a CloudFront resource.

" - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, the values are automatically deleted.

" - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for the distribution.

" - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires a body. Ensure that the body is present and the Content-Type header is set.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified origin access identity does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified invalidation does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

No origin exists with the specified Origin Id.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified streaming distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

A unique identifier for the origin. The value of Id must be unique within the distribution.

When you specify the value of TargetOriginId for the default cache behavior or for another cache behavior, you indicate the origin to which you want the cache behavior to route requests by specifying the value of the Id element for that origin. When a request matches the path pattern for that cache behavior, CloudFront routes the request to the specified origin. For more information, see Cache Behavior Settings in the Amazon CloudFront Developer Guide.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com.

Constraints for Amazon S3 origins:

  • If you configured Amazon S3 Transfer Acceleration for your bucket, do not specify the s3-accelerate endpoint for DomainName.

  • The bucket name must be between 3 and 63 characters long (inclusive).

  • The bucket name must contain only lowercase characters, numbers, periods, underscores, and dashes.

  • The bucket name must not contain adjacent periods.

Custom Origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com.

Constraints for custom origins:

  • DomainName must be a valid DNS name that contains only a-z, A-Z, 0-9, dot (.), hyphen (-), or underscore (_) characters.

  • The name cannot exceed 128 characters.

" - }, - "OriginPath":{ - "shape":"string", - "documentation":"

An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName, for example, example.com/production. Do not include a / at the end of the directory name.

For example, suppose you've specified the following values for your distribution:

  • DomainName: An Amazon S3 bucket named myawsbucket.

  • OriginPath: /production

  • CNAME: example.com

When a user enters example.com/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/index.html.

When a user enters example.com/acme/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/acme/index.html.

" - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"

A complex type that contains names and values for the custom headers that you want.

" - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"

A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead.

" - } - }, - "documentation":"

A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files. You must create at least one origin.

For the current limit on the number of origins that you can create for a distribution, see Amazon CloudFront Limits in the AWS General Reference.

" - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"

The name of a header that you want CloudFront to forward to your origin. For more information, see Forwarding Custom Headers to Your Origin (Web Distributions Only) in the Amazon Amazon CloudFront Developer Guide.

" - }, - "HeaderValue":{ - "shape":"string", - "documentation":"

The value for the header that you specified in the HeaderName field.

" - } - }, - "documentation":"

A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.

" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin.

" - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"

A list that contains allowed SSL/TLS protocols for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin.

" - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of origins for this distribution.

" - }, - "Items":{ - "shape":"OriginList", - "documentation":"

A complex type that contains origins for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of objects that you want to invalidate.

" - }, - "Items":{ - "shape":"PathList", - "documentation":"

A complex type that contains a list of the paths that you want to invalidate.

" - } - }, - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The precondition given in one or more of the request-header fields evaluated to false.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of whitelisted query string parameters for this cache behavior.

" - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"

(Optional) A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items.

" - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"

A complex type that identifies ways in which you want to restrict distribution of your content.

" - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"

The DNS name of the Amazon S3 origin.

" - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the RTMP distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an Amazon S3 bucket through CloudFront.

If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content in the Amazon Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:

origin-access-identity/CloudFront/ID-of-origin-access-identity

where ID-of-origin-access-identity is the value that CloudFront returned in the ID element when you created the origin access identity.

If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"

An AWS account that is included in the TrustedSigners complex type for this RTMP distribution. Valid values include:

  • self, which is the AWS account used to create the distribution.

  • An AWS account number.

" - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any.

" - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the RTMP distribution. For example: EGTXBD79EXAMPLE.

" - }, - "ARN":{"shape":"string"}, - "Status":{ - "shape":"string", - "documentation":"

The current status of the RTMP distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The current configuration information for the RTMP distribution.

" - } - }, - "documentation":"

A streaming distribution.

" - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures that the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the streaming distribution.

" - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies any AWS accounts that you want to permit to create signed URLs for private content. If you want the distribution to use signed URLs, include this element; if you want the distribution to use public URLs, remove this element. For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

A complex type that contains information about price class for this streaming distribution.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the streaming distribution is enabled to accept user requests for content.

" - } - }, - "documentation":"

The RTMP distribution's configuration information.

" - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

A streaming distribution Configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A streaming distribution Configuration and a list of tags to be associated with the streaming distribution.

" - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your RTMP distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of streaming distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"

A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A streaming distribution list.

" - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items.If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept end user requests for content.

" - } - }, - "documentation":"

A summary of the information for an Amazon CloudFront streaming distribution.

" - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for this streaming distribution.

" - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

A string that contains an optional Tag value.

The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - } - }, - "documentation":"

A complex type that contains Tag key and Tag value.

" - }, - "TagKey":{ - "type":"string", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"

A complex type that contains Tag key elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to add tags to a CloudFront resource.

", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"

A complex type that contains Tag elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more cache behaviors for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create anymore custom SSL/TLS certificates.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of origin access identities allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more cookie names in the whitelist than are allowed per cache behavior.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more CNAMEs than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more origins for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more trusted signers than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

One or more of your trusted signers do not exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want to require viewers to use signed URLs to access the files specified by PathPattern and TargetOriginId.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of trusted signers for this cache behavior.

" - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"

Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

For more information about updating the distribution configuration, see DistributionConfig .

" - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

A complex type that contains zero or more Tag key elements.

", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - } - }, - "documentation":"

The request to remove tags from a CloudFront resource.

", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The identity's configuration information.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The identity's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update an origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a distribution.

", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-09-29/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"

If you want viewers to use HTTPS to request your objects and you're using the CloudFront domain name of your distribution in your object URLs (for example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit this value if you are setting an ACMCertificateArn or IAMCertificateId.

" - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"

If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the IAM certificate identifier of the custom viewer certificate for this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate.

" - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"

If you want viewers to use HTTPS to request your objects and you're using an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), specify the ACM certificate ARN of the custom viewer certificate for this distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate.

" - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"

If you specify a value for ACMCertificateArn or for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests: using a method that works for all clients or one that works for most clients:

  • vip: CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges.

  • sni-only: CloudFront can respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. If some of your users' browsers don't support SNI, we recommend that you do one of the following:

    • Use the vip option (dedicated IP addresses) instead of sni-only.

    • Use the CloudFront SSL/TLS certificate instead of a custom certificate. This requires that you use the CloudFront domain name of your distribution in the URLs for your objects, for example, https://d111111abcdef8.cloudfront.net/logo.png.

    • If you can control which browser your users use, upgrade the browser to one that supports SNI.

    • Use HTTP instead of HTTPS.

Do not specify a value for SSLSupportMethod if you specified <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>.

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"

Specify the minimum version of the SSL/TLS protocol that you want CloudFront to use for HTTPS connections between viewers and CloudFront: SSLv3 or TLSv1. CloudFront serves your objects only to viewers that support SSL/TLS version that you specify and later versions. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. Note the following:

  • If you specify <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>, the minimum SSL protocol version is TLSv1 and can't be changed.

  • If you're using a custom certificate (if you specify a value for ACMCertificateArn or for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion.

" - }, - "Certificate":{ - "shape":"string", - "documentation":"

Include one of these values to specify the following:

  • Whether you want viewers to use HTTP or HTTPS to request your objects.

  • If you want viewers to use HTTPS, whether you're using an alternate domain name such as example.com or the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net.

  • If you're using an alternate domain name, whether AWS Certificate Manager (ACM) provided the certificate, or you purchased a certificate from a third-party certificate authority and imported it into ACM or uploaded it to the IAM certificate store.

You must specify one (and only one) of the three values. Do not specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP to request your objects: Specify the following value:

<CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

In addition, specify allow-all for ViewerProtocolPolicy for all of your cache behaviors.

If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:

  • If you're using an alternate domain name, such as example.com: Specify one of the following values, depending on whether ACM provided your certificate or you purchased your certificate from third-party certificate authority:

    • <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate that you want to use for this distribution.

    • <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate ID is the ID that IAM returned when you added the certificate to the IAM certificate store.

    If you specify ACMCertificateArn or IAMCertificateId, you must also specify a value for SSLSupportMethod.

    If you choose to use an ACM certificate or a certificate in the IAM certificate store, we recommend that you use only an alternate domain name in your object URLs (https://example.com/logo.jpg). If you use the domain name that is associated with your CloudFront distribution (https://d111111abcdef8.cloudfront.net/logo.jpg) and the viewer supports SNI, then CloudFront behaves normally. However, if the browser does not support SNI, the user's experience depends on the value that you choose for SSLSupportMethod:

    • vip: The viewer displays a warning because there is a mismatch between the CloudFront domain name and the domain name in your SSL/TLS certificate.

    • sni-only: CloudFront drops the connection with the browser without returning the object.

  • If you're using the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net : Specify the following value:

    <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

    If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:

    • <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy>

    • <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy>

    You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:

    • <OriginProtocolPolicy>https-only<OriginProtocolPolicy>

    • <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy>

    For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"

This field is deprecated. You can use one of the following: [ACMCertificateArn, IAMCertificateId, or CloudFrontDefaultCertificate].

", - "deprecated":true - } - }, - "documentation":"

A complex type that specifies the following:

  • Which SSL/TLS certificate to use when viewers request objects using HTTPS

  • Whether you want CloudFront to use dedicated IP addresses or SNI when you're using alternate domain names in your object names

  • The minimum protocol version that you want CloudFront to use when communicating with viewers

For more information, see Using an HTTPS Connection to Access Your Objects in the Amazon Amazon CloudFront Developer Guide.

" - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about the CloudFront API actions, data types, and errors. For detailed information about CloudFront features and their associated API calls, see the Amazon CloudFront Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-09-29/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/service-2.json deleted file mode 100644 index dd90e013..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/service-2.json +++ /dev/null @@ -1,3577 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-25", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "uid":"cloudfront-2016-11-25" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "CreateDistribution":{ - "name":"CreateDistribution2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"} - ], - "documentation":"

Creates a new web distribution. Send a GET request to the /CloudFront API version/distribution/distribution ID resource.

" - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"} - ], - "documentation":"

Create a new distribution with tags.

" - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Create a new invalidation.

" - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

" - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"

Create a new streaming distribution with tags.

" - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2016_11_25", - "http":{ - "method":"DELETE", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"

Delete an origin access identity.

" - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2016_11_25", - "http":{ - "method":"DELETE", - "requestUri":"/2016-11-25/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a distribution.

" - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2016_11_25", - "http":{ - "method":"DELETE", - "requestUri":"/2016-11-25/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an origin access identity.

" - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about an origin access identity.

" - }, - "GetDistribution":{ - "name":"GetDistribution2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about a distribution.

" - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a distribution.

" - }, - "GetInvalidation":{ - "name":"GetInvalidation2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an invalidation.

" - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Gets information about a specified RTMP distribution, including the distribution configuration.

" - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a streaming distribution.

" - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

Lists origin access identities.

" - }, - "ListDistributions":{ - "name":"ListDistributions2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List distributions.

" - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"

List the distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListInvalidations":{ - "name":"ListInvalidations2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Lists invalidation batches.

" - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List streaming distributions.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2016_11_25", - "http":{ - "method":"GET", - "requestUri":"/2016-11-25/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

List tags for a CloudFront resource.

" - }, - "TagResource":{ - "name":"TagResource2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Add tags to a CloudFront resource.

" - }, - "UntagResource":{ - "name":"UntagResource2016_11_25", - "http":{ - "method":"POST", - "requestUri":"/2016-11-25/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Remove tags from a CloudFront resource.

" - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2016_11_25", - "http":{ - "method":"PUT", - "requestUri":"/2016-11-25/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update an origin access identity.

" - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2016_11_25", - "http":{ - "method":"PUT", - "requestUri":"/2016-11-25/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"} - ], - "documentation":"

Update a distribution.

" - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2016_11_25", - "http":{ - "method":"PUT", - "requestUri":"/2016-11-25/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update a streaming distribution.

" - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Access denied.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Enabled is true if any of the AWS accounts listed in the TrustedSigners complex type for this RTMP distribution have active CloudFront key pairs. If not, Enabled is false.

For more information, see ActiveTrustedSigners.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"SignerList", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer that is specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CNAME aliases, if any, that you want to associate with this distribution.

" - }, - "Items":{ - "shape":"AliasList", - "documentation":"

A complex type that contains the CNAME aliases, if any, that you want to associate with this distribution.

" - } - }, - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD, and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin.

" - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"

A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:

  • CloudFront forwards only GET and HEAD requests.

  • CloudFront forwards only GET, HEAD, and OPTIONS requests.

  • CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests.

If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin.

" - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"

The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution.

You can optionally include a slash (/) at the beginning of the path pattern. For example, /images/*.jpg. CloudFront behavior is the same with or without the leading /.

The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior.

For more information, see Path Pattern in the Amazon CloudFront Developer Guide.

" - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{ - "shape":"long", - "documentation":"

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - } - }, - "documentation":"

A complex type that describes how CloudFront processes requests.

You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.

For the current limit on the number of cache behaviors that you can add to a distribution, see Amazon CloudFront Limits in the AWS General Reference.

If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error.

To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.

To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.

For more information about cache behaviors, see Cache Behaviors in the Amazon CloudFront Developer Guide.

" - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of cache behaviors for this distribution.

" - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"

Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to cache responses to.

" - } - }, - "documentation":"

A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:

  • CloudFront caches responses to GET and HEAD requests.

  • CloudFront caches responses to GET, HEAD, and OPTIONS requests.

If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly.

" - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

" - } - }, - "documentation":"

CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created.

If the CallerReference is a value already sent in a previous identity request, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request.

If the CallerReference is a value you already sent in a previous request to create an identity, but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the origin access identity.

" - } - }, - "documentation":"

Origin access identity configuration. Send a GET request to the /CloudFront API version/CloudFront/identity ID/config resource.

" - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of origin access identities you want in the response body.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CloudFront origin access identities that were created by the current AWS account.

" - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"

A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account.

" - } - }, - "documentation":"

Lists the origin access identities for CloudFront.Send a GET request to the /CloudFront API version/origin-access-identity/cloudfront resource. The response includes a CloudFrontOriginAccessIdentityList element with zero or more CloudFrontOriginAccessIdentitySummary child elements. By default, your entire list of origin access identities is returned in one single page. If the list is long, you can paginate it using the MaxItems and Marker parameters.

" - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment for this origin access identity, as originally specified when created.

" - } - }, - "documentation":"

Summary of the information about a CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different cookies that you want CloudFront to forward to the origin for this cache behavior.

" - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"

A complex type that contains one Name element for each cookie that you want CloudFront to forward to the origin for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"

Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNames complex type.

Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for the Forward element.

" - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"

Required if you specify whitelist for the value of Forward:. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies.

If you specify all or none for the value of Forward, omit WhitelistedNames. If you change the value of Forward from whitelist to all or none and you don't delete the WhitelistedNames element and its child elements, CloudFront deletes them automatically.

For the current limit on the number of cookie names that you can whitelist for each cache behavior, see Amazon CloudFront Limits in the AWS General Reference.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create a new origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create a new distribution.

", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create a new distribution with tags.

", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The batch information for the invalidation.

", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create an invalidation.

", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.

", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create a new streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to create a new streaming distribution with tags.

", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"

The HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"

The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by ErrorCode, for example, /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:

  • The value of PathPattern matches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named /4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example, /4xx-errors/*.

  • The value of TargetOriginId specifies the value of the ID element for the origin that contains your custom error pages.

If you specify a value for ResponsePagePath, you must also specify a value for ResponseCode. If you don't want to specify a value, include an empty element, <ResponsePagePath>, in the XML document.

We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.

" - }, - "ResponseCode":{ - "shape":"string", - "documentation":"

The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example:

  • Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.

  • If you don't care about distinguishing among different client errors or server errors, you can specify 400 or 500 as the ResponseCode for all 4xx or 5xx errors.

  • You might want to return a 200 status code (OK) and static website so your customers don't know that your website is down.

If you specify a value for ResponseCode, you must also specify a value for ResponsePagePath. If you don't want to specify a value, include an empty element, <ResponseCode>, in the XML document.

" - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available.

If you don't want to specify a value, include an empty element, <ErrorCachingMinTTL>, in the XML document.

For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP status codes for which you want to specify a custom error page and/or a caching duration. If Quantity is 0, you can omit Items.

" - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"

A complex type that contains a CustomErrorResponse element for each HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of custom headers, if any, for this distribution.

" - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"

Optional: A list that contains one OriginCustomHeader element for each custom header that you want CloudFront to forward to the origin. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that contains the list of Custom Headers for each origin.

" - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"

The HTTP port the custom origin listens on.

" - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"

The HTTPS port the custom origin listens on.

" - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"

The origin protocol policy to apply to your origin.

" - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"

The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS.

" - } - }, - "documentation":"

A customer origin.

" - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{"shape":"long"}, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - } - }, - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The origin access identity's ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

Deletes a origin access identity.

" - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the following steps.

To delete a web distribution using the CloudFront API:

  1. Disable the web distribution

  2. Submit a GET Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 2.

  5. Review the response to the PUT Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Distribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 6.

  8. Review the response to your DELETE Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to delete a streaming distribution.

" - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"

The number of invalidation batches currently in progress.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs.

" - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.

" - } - }, - "documentation":"

The distribution's information.

" - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The caller reference you attempted to create the distribution with is associated with another distribution.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique value (for example, a date-time stamp) that ensures that the request can't be replayed.

If the value of CallerReference is new (regardless of the content of the DistributionConfig object), CloudFront creates a new distribution.

If CallerReference is a value you already sent in a previous request to create a distribution, and if the content of the DistributionConfig is identical to the original request (ignoring white space), CloudFront returns the same the response that it returned to the original request.

If CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"

The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/product-description.html). Specifying a default root object avoids exposing the contents of your distribution.

Specify only the object name, for example, index.html. Do not add a / before the object name.

If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element.

To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element.

To replace the default root object, update the distribution configuration and specify the new object.

For more information about the default root object, see Creating a Default Root Object in the Amazon CloudFront Developer Guide.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that controls the following:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the distribution.

If you don't want to specify a comment, include an empty Comment element.

To delete an existing comment, update the distribution configuration and include an empty Comment element.

To add or change a comment, update the distribution configuration and specify the new comment.

" - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the distribution.

For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify PriceClass_All, CloudFront responds to requests for your objects from all CloudFront edge locations.

If you specify a price class other than PriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance.

For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes map to CloudFront regions, see Amazon CloudFront Pricing.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket.

If you do not want to enable logging when you create a distribution, or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements.

If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

A unique identifier that specifies the AWS WAF web ACL, if any, to associate with this distribution.

AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about AWS WAF, see the AWS WAF Developer Guide.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

(Optional) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 automatically use an earlier HTTP version.

For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or later, and must support Server Name Identification (SNI).

In general, configuring CloudFront to communicate with viewers using HTTP/2 reduces latency. You can improve performance by optimizing for HTTP/2. For more information, do an Internet search for \"http/2 optimization.\"

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify true. If you specify false, CloudFront responds to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.

In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the IpAddress parameter to restrict the IP addresses that can access your content, do not enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide.

If you're using an Amazon Route 53 alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:

  • You enable IPv6 for the distribution

  • You're using alternate domain names in the URLs for your objects

For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Amazon Route 53 Developer Guide.

If you created a CNAME resource record set, either with Amazon Route 53 or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request.

" - } - }, - "documentation":"

A distribution configuration.

" - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

A distribution configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A distribution Configuration and a list of tags to be associated with the distribution.

" - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"

A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A distribution list.

" - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId", - "HttpVersion", - "IsIPV6Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that contains zero or more CustomErrorResponses elements.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept user requests for content.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

The Web ACL Id (if any) associated with the distribution.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.

" - } - }, - "documentation":"

A summary of the information about a CloudFront distribution.

" - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "EventType":{ - "type":"string", - "enum":[ - "viewer-request", - "viewer-response", - "origin-request", - "origin-response" - ] - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.

If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.

If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.

For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.

" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "Headers":{ - "shape":"Headers", - "documentation":"

A complex type that specifies the Headers, if any, that you want CloudFront to vary upon for this cache behavior.

" - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"

The method that you want to use to restrict distribution of your content by country:

  • none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.

  • blacklist: The Location elements specify the countries in which you do not want CloudFront to distribute your content.

  • whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items.

" - }, - "Items":{ - "shape":"LocationList", - "documentation":"

A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist).

The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country.

CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list in the CloudFront console, which includes both country names and codes.

" - } - }, - "documentation":"

A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using MaxMind GeoIP databases.

" - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType.

" - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The origin access identity's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an origin access identity's information.

" - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution configuration.

" - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution's information.

" - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request, for example, IDFDVBD632BHDS5.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an invalidation's information.

" - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information. For more information, see Invalidation Complex Type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

To request to get a streaming distribution configuration.

" - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a streaming distribution's information.

" - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different headers that you want CloudFront to forward to the origin for this cache behavior. You can configure each cache behavior in a web distribution to do one of the following:

  • Forward all headers to your origin: Specify 1 for Quantity and * for Name.

    If you configure CloudFront to forward all headers to your origin, CloudFront doesn't cache the objects associated with this cache behavior. Instead, it sends every request to the origin.

  • Forward a whitelist of headers you specify: Specify the number of headers that you want to forward, and specify the header names in Name elements. CloudFront caches your objects based on the values in all of the specified headers. CloudFront also forwards the headers that it forwards by default, but it caches your objects based only on the headers that you specify.

  • Forward only the default headers: Specify 0 for Quantity and omit Items. In this configuration, CloudFront doesn't cache based on the values in the request headers.

" - }, - "Items":{ - "shape":"HeaderList", - "documentation":"

A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior.

For the headers that you specify, CloudFront also caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to cache your content based on values in the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value. For more information about caching based on header values, see How CloudFront Forwards and Caches Headers in the Amazon CloudFront Developer Guide.

" - }, - "HttpVersion":{ - "type":"string", - "enum":[ - "http1.1", - "http2" - ] - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Origin and CallerReference cannot be updated.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The value of Quantity and the size of Items do not match.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The argument is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The default root object file name is too big or contains an invalid character.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The If-Match version is missing or not valid for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLambdaFunctionAssociation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified Lambda function association is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The origin access identity is not valid or doesn't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request. For example: IDFDVBD632BHDS5.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The status of the invalidation request. When the invalidation batch is finished, the status is Completed.

" - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"

The date and time the invalidation request was first made.

" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The current invalidation information for the batch request.

" - } - }, - "documentation":"

An invalidation.

" - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "CallerReference":{ - "shape":"string", - "documentation":"

A value that you specify to uniquely identify an invalidation request. CloudFront uses the value to prevent you from accidentally resubmitting an identical request. Whenever you create a new invalidation request, you must specify a new value for CallerReference and change other values in the request as applicable. One way to ensure that the value of CallerReference is unique is to use a timestamp, for example, 20120301090000.

If you make a second invalidation request with the same value for CallerReference, and if the rest of the request is the same, CloudFront doesn't create a new invalidation request. Instead, CloudFront returns information about the invalidation request that you previously created with the same CallerReference.

If CallerReference is a value you already sent in a previous invalidation batch request but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error.

" - } - }, - "documentation":"

An invalidation batch.

" - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value that you can use for the Marker request parameter to continue listing your invalidation batches where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value that you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of invalidation batches that were created by the current AWS account.

" - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"

A complex type that contains one InvalidationSummary element for each invalidation batch created by the current AWS account.

" - } - }, - "documentation":"

The InvalidationList complex type describes the list of invalidation objects. For more information about invalidation, see Invalidating Objects (Web Distributions Only) in the Amazon CloudFront Developer Guide.

" - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The unique ID for an invalidation request.

" - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"

The status of an invalidation request.

" - } - }, - "documentation":"

A summary of an invalidation request.

" - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of active CloudFront key pairs for AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "LambdaFunctionAssociation":{ - "type":"structure", - "members":{ - "LambdaFunctionARN":{ - "shape":"string", - "documentation":"

The ARN of the Lambda function.

" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

Specifies the event type that triggers a Lambda function invocation. Valid values are:

  • viewer-request

  • origin-request

  • viewer-response

  • origin-response

" - } - }, - "documentation":"

A complex type that contains a Lambda function association.

" - }, - "LambdaFunctionAssociationList":{ - "type":"list", - "member":{ - "shape":"LambdaFunctionAssociation", - "locationName":"LambdaFunctionAssociation" - } - }, - "LambdaFunctionAssociations":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of Lambda function associations for this cache behavior.

" - }, - "Items":{ - "shape":"LambdaFunctionAssociationList", - "documentation":"

Optional: A complex type that contains LambdaFunctionAssociation items for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies a list of Lambda functions associations for a cache behavior.

If you want to invoke one or more Lambda functions triggered by requests that match the PathPattern of the cache behavior, specify the applicable values for Quantity and Items. Note that there can be up to 4 LambdaFunctionAssociation items in this list (one for each possible value of EventType) and each EventType can be associated with the Lambda function only once.

If you don't want to invoke any Lambda functions for the requests that match PathPattern, specify 0 for Quantity and omit Items.

" - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of origin access identities you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list origin access identities.

" - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"

The CloudFrontOriginAccessIdentityList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"

The ID of the AWS WAF web ACL that you want to list the associated distributions. If you specify \"null\" for the ID, the request returns a list of the distributions that aren't associated with a web ACL.

", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"

The request to list distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.

", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your distributions.

" - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"

Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of invalidation batches that you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list invalidations.

" - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"

Information about invalidation batches.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The value that you provided for the MaxItems request parameter.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your streaming distributions.

" - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"

The StreamingDistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"

The request to list tags for a CloudFront resource.

" - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, the values are automatically deleted.

" - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you do not want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for the distribution.

" - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires a body. Ensure that the body is present and the Content-Type header is set.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified origin access identity does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified invalidation does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

No origin exists with the specified Origin Id.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified streaming distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

A unique identifier for the origin. The value of Id must be unique within the distribution.

When you specify the value of TargetOriginId for the default cache behavior or for another cache behavior, you indicate the origin to which you want the cache behavior to route requests by specifying the value of the Id element for that origin. When a request matches the path pattern for that cache behavior, CloudFront routes the request to the specified origin. For more information, see Cache Behavior Settings in the Amazon CloudFront Developer Guide.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com.

Constraints for Amazon S3 origins:

  • If you configured Amazon S3 Transfer Acceleration for your bucket, do not specify the s3-accelerate endpoint for DomainName.

  • The bucket name must be between 3 and 63 characters long (inclusive).

  • The bucket name must contain only lowercase characters, numbers, periods, underscores, and dashes.

  • The bucket name must not contain adjacent periods.

Custom Origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com.

Constraints for custom origins:

  • DomainName must be a valid DNS name that contains only a-z, A-Z, 0-9, dot (.), hyphen (-), or underscore (_) characters.

  • The name cannot exceed 128 characters.

" - }, - "OriginPath":{ - "shape":"string", - "documentation":"

An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName, for example, example.com/production. Do not include a / at the end of the directory name.

For example, suppose you've specified the following values for your distribution:

  • DomainName: An Amazon S3 bucket named myawsbucket.

  • OriginPath: /production

  • CNAME: example.com

When a user enters example.com/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/index.html.

When a user enters example.com/acme/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/acme/index.html.

" - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"

A complex type that contains names and values for the custom headers that you want.

" - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"

A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead.

" - } - }, - "documentation":"

A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files. You must create at least one origin.

For the current limit on the number of origins that you can create for a distribution, see Amazon CloudFront Limits in the AWS General Reference.

" - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"

The name of a header that you want CloudFront to forward to your origin. For more information, see Forwarding Custom Headers to Your Origin (Web Distributions Only) in the Amazon Amazon CloudFront Developer Guide.

" - }, - "HeaderValue":{ - "shape":"string", - "documentation":"

The value for the header that you specified in the HeaderName field.

" - } - }, - "documentation":"

A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.

" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin.

" - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"

A list that contains allowed SSL/TLS protocols for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin.

" - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of origins for this distribution.

" - }, - "Items":{ - "shape":"OriginList", - "documentation":"

A complex type that contains origins for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of objects that you want to invalidate.

" - }, - "Items":{ - "shape":"PathList", - "documentation":"

A complex type that contains a list of the paths that you want to invalidate.

" - } - }, - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The precondition given in one or more of the request-header fields evaluated to false.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of whitelisted query string parameters for this cache behavior.

" - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"

(Optional) A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items.

" - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"

A complex type that identifies ways in which you want to restrict distribution of your content.

" - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"

The DNS name of the Amazon S3 origin.

" - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the RTMP distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an Amazon S3 bucket through CloudFront.

If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content in the Amazon Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:

origin-access-identity/CloudFront/ID-of-origin-access-identity

where ID-of-origin-access-identity is the value that CloudFront returned in the ID element when you created the origin access identity.

If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"

An AWS account that is included in the TrustedSigners complex type for this RTMP distribution. Valid values include:

  • self, which is the AWS account used to create the distribution.

  • An AWS account number.

" - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any.

" - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the RTMP distribution. For example: EGTXBD79EXAMPLE.

" - }, - "ARN":{"shape":"string"}, - "Status":{ - "shape":"string", - "documentation":"

The current status of the RTMP distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the streaming distribution. For example: s5c39gqb8ow64r.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The current configuration information for the RTMP distribution.

" - } - }, - "documentation":"

A streaming distribution.

" - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures that the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the streaming distribution.

" - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies any AWS accounts that you want to permit to create signed URLs for private content. If you want the distribution to use signed URLs, include this element; if you want the distribution to use public URLs, remove this element. For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

A complex type that contains information about price class for this streaming distribution.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the streaming distribution is enabled to accept user requests for content.

" - } - }, - "documentation":"

The RTMP distribution's configuration information.

" - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

A streaming distribution Configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A streaming distribution Configuration and a list of tags to be associated with the streaming distribution.

" - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your RTMP distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of streaming distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"

A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A streaming distribution list.

" - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items.If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept end user requests for content.

" - } - }, - "documentation":"

A summary of the information for an Amazon CloudFront streaming distribution.

" - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you do not want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you do not want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for this streaming distribution.

" - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

A string that contains an optional Tag value.

The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - } - }, - "documentation":"

A complex type that contains Tag key and Tag value.

" - }, - "TagKey":{ - "type":"string", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"

A complex type that contains Tag key elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to add tags to a CloudFront resource.

", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"

A complex type that contains Tag elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more cache behaviors for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create anymore custom SSL/TLS certificates.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of origin access identities allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more cookie names in the whitelist than are allowed per cache behavior.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more CNAMEs than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionsWithLambdaAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyLambdaFunctionAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more Lambda function associations than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more origins for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more trusted signers than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

One or more of your trusted signers do not exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want to require viewers to use signed URLs to access the files specified by PathPattern and TargetOriginId.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of trusted signers for this cache behavior.

" - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"

Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

For more information about updating the distribution configuration, see DistributionConfig .

" - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

A complex type that contains zero or more Tag key elements.

", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - } - }, - "documentation":"

The request to remove tags from a CloudFront resource.

", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The identity's configuration information.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The identity's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update an origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a distribution.

", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2016-11-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{"shape":"boolean"}, - "IAMCertificateId":{"shape":"string"}, - "ACMCertificateArn":{"shape":"string"}, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"

If you specify a value for ACMCertificateArn or for IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests: using a method that works for all clients or one that works for most clients:

  • vip: CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you must request permission to use this feature, and you incur additional monthly charges.

  • sni-only: CloudFront can respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. If some of your users' browsers don't support SNI, we recommend that you do one of the following:

    • Use the vip option (dedicated IP addresses) instead of sni-only.

    • Use the CloudFront SSL/TLS certificate instead of a custom certificate. This requires that you use the CloudFront domain name of your distribution in the URLs for your objects, for example, https://d111111abcdef8.cloudfront.net/logo.png.

    • If you can control which browser your users use, upgrade the browser to one that supports SNI.

    • Use HTTP instead of HTTPS.

Do not specify a value for SSLSupportMethod if you specified <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>.

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"

Specify the minimum version of the SSL/TLS protocol that you want CloudFront to use for HTTPS connections between viewers and CloudFront: SSLv3 or TLSv1. CloudFront serves your objects only to viewers that support SSL/TLS version that you specify and later versions. The TLSv1 protocol is more secure, so we recommend that you specify SSLv3 only if your users are using browsers or devices that don't support TLSv1. Note the following:

  • If you specify <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>, the minimum SSL protocol version is TLSv1 and can't be changed.

  • If you're using a custom certificate (if you specify a value for ACMCertificateArn or for IAMCertificateId) and if you're using SNI (if you specify sni-only for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion.

" - }, - "Certificate":{ - "shape":"string", - "documentation":"

Include one of these values to specify the following:

  • Whether you want viewers to use HTTP or HTTPS to request your objects.

  • If you want viewers to use HTTPS, whether you're using an alternate domain name such as example.com or the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net.

  • If you're using an alternate domain name, whether AWS Certificate Manager (ACM) provided the certificate, or you purchased a certificate from a third-party certificate authority and imported it into ACM or uploaded it to the IAM certificate store.

You must specify one (and only one) of the three values. Do not specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP to request your objects: Specify the following value:

<CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

In addition, specify allow-all for ViewerProtocolPolicy for all of your cache behaviors.

If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:

  • If you're using an alternate domain name, such as example.com: Specify one of the following values, depending on whether ACM provided your certificate or you purchased your certificate from third-party certificate authority:

    • <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate that you want to use for this distribution.

    • <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate ID is the ID that IAM returned when you added the certificate to the IAM certificate store.

    If you specify ACMCertificateArn or IAMCertificateId, you must also specify a value for SSLSupportMethod.

    If you choose to use an ACM certificate or a certificate in the IAM certificate store, we recommend that you use only an alternate domain name in your object URLs (https://example.com/logo.jpg). If you use the domain name that is associated with your CloudFront distribution (https://d111111abcdef8.cloudfront.net/logo.jpg) and the viewer supports SNI, then CloudFront behaves normally. However, if the browser does not support SNI, the user's experience depends on the value that you choose for SSLSupportMethod:

    • vip: The viewer displays a warning because there is a mismatch between the CloudFront domain name and the domain name in your SSL/TLS certificate.

    • sni-only: CloudFront drops the connection with the browser without returning the object.

  • If you're using the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net : Specify the following value:

    <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

    If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:

    • <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy>

    • <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy>

    You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:

    • <OriginProtocolPolicy>https-only<OriginProtocolPolicy>

    • <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy>

    For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"

This field is deprecated. You can use one of the following: [ACMCertificateArn, IAMCertificateId, or CloudFrontDefaultCertificate].

", - "deprecated":true - } - }, - "documentation":"

A complex type that specifies the following:

  • Which SSL/TLS certificate to use when viewers request objects using HTTPS

  • Whether you want CloudFront to use dedicated IP addresses or SNI when you're using alternate domain names in your object names

  • The minimum protocol version that you want CloudFront to use when communicating with viewers

For more information, see Using an HTTPS Connection to Access Your Objects in the Amazon Amazon CloudFront Developer Guide.

" - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about the CloudFront API actions, data types, and errors. For detailed information about CloudFront features and their associated API calls, see the Amazon CloudFront Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/waiters-2.json deleted file mode 100644 index 6e044bc5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2016-11-25/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 60, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/service-2.json deleted file mode 100644 index 092482e1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/service-2.json +++ /dev/null @@ -1,3653 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-03-25", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "signatureVersion":"v4", - "uid":"cloudfront-2017-03-25" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "CreateDistribution":{ - "name":"CreateDistribution2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"} - ], - "documentation":"

Creates a new web distribution. Send a POST request to the /CloudFront API version/distribution/distribution ID resource.

" - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"} - ], - "documentation":"

Create a new distribution with tags.

" - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Create a new invalidation.

" - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

" - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"

Create a new streaming distribution with tags.

" - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2017_03_25", - "http":{ - "method":"DELETE", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"

Delete an origin access identity.

" - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2017_03_25", - "http":{ - "method":"DELETE", - "requestUri":"/2017-03-25/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a distribution.

" - }, - "DeleteServiceLinkedRole":{ - "name":"DeleteServiceLinkedRole2017_03_25", - "http":{ - "method":"DELETE", - "requestUri":"/2017-03-25/service-linked-role/{RoleName}", - "responseCode":204 - }, - "input":{"shape":"DeleteServiceLinkedRoleRequest"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"AccessDenied"}, - {"shape":"ResourceInUse"}, - {"shape":"NoSuchResource"} - ] - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2017_03_25", - "http":{ - "method":"DELETE", - "requestUri":"/2017-03-25/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an origin access identity.

" - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about an origin access identity.

" - }, - "GetDistribution":{ - "name":"GetDistribution2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about a distribution.

" - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a distribution.

" - }, - "GetInvalidation":{ - "name":"GetInvalidation2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an invalidation.

" - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Gets information about a specified RTMP distribution, including the distribution configuration.

" - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a streaming distribution.

" - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

Lists origin access identities.

" - }, - "ListDistributions":{ - "name":"ListDistributions2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List distributions.

" - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"

List the distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListInvalidations":{ - "name":"ListInvalidations2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Lists invalidation batches.

" - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List streaming distributions.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2017_03_25", - "http":{ - "method":"GET", - "requestUri":"/2017-03-25/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

List tags for a CloudFront resource.

" - }, - "TagResource":{ - "name":"TagResource2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Add tags to a CloudFront resource.

" - }, - "UntagResource":{ - "name":"UntagResource2017_03_25", - "http":{ - "method":"POST", - "requestUri":"/2017-03-25/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Remove tags from a CloudFront resource.

" - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2017_03_25", - "http":{ - "method":"PUT", - "requestUri":"/2017-03-25/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update an origin access identity.

" - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2017_03_25", - "http":{ - "method":"PUT", - "requestUri":"/2017-03-25/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"} - ], - "documentation":"

Updates the configuration for a web distribution. Perform the following steps.

For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console in the Amazon CloudFront Developer Guide.

To update a web distribution using the CloudFront API

  1. Submit a GetDistributionConfig request to get the current configuration and an Etag header for the distribution.

    If you update the distribution again, you need to get a new Etag header.

  2. Update the XML document that was returned in the response to your GetDistributionConfig request to include the desired changes. You can't change the value of CallerReference. If you try to change this value, CloudFront returns an IllegalUpdate error.

    The new configuration replaces the existing configuration; the values that you specify in an UpdateDistribution request are not merged into the existing configuration. When you add, delete, or replace values in an element that allows multiple values (for example, CNAME), you must specify all of the values that you want to appear in the updated distribution. In addition, you must update the corresponding Quantity element.

  3. Submit an UpdateDistribution request to update the configuration for your distribution:

    • In the request body, include the XML document that you updated in Step 2. The request body must include an XML document with a DistributionConfig element.

    • Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GetDistributionConfig request in Step 1.

  4. Review the response to the UpdateDistribution request to confirm that the configuration was successfully updated.

  5. Optional: Submit a GetDistribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

    Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a distribution. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values you're actually specifying.

" - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2017_03_25", - "http":{ - "method":"PUT", - "requestUri":"/2017-03-25/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update a streaming distribution.

" - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Access denied.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Enabled is true if any of the AWS accounts listed in the TrustedSigners complex type for this RTMP distribution have active CloudFront key pairs. If not, Enabled is false.

For more information, see ActiveTrustedSigners.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"SignerList", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer that is specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CNAME aliases, if any, that you want to associate with this distribution.

" - }, - "Items":{ - "shape":"AliasList", - "documentation":"

A complex type that contains the CNAME aliases, if any, that you want to associate with this distribution.

" - } - }, - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD, and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin.

" - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"

A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:

  • CloudFront forwards only GET and HEAD requests.

  • CloudFront forwards only GET, HEAD, and OPTIONS requests.

  • CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests.

If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin.

" - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"

The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution.

You can optionally include a slash (/) at the beginning of the path pattern. For example, /images/*.jpg. CloudFront behavior is the same with or without the leading /.

The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior.

For more information, see Path Pattern in the Amazon CloudFront Developer Guide.

" - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{ - "shape":"long", - "documentation":"

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - } - }, - "documentation":"

A complex type that describes how CloudFront processes requests.

You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.

For the current limit on the number of cache behaviors that you can add to a distribution, see Amazon CloudFront Limits in the AWS General Reference.

If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error.

To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.

To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.

For more information about cache behaviors, see Cache Behaviors in the Amazon CloudFront Developer Guide.

" - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of cache behaviors for this distribution.

" - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"

Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to cache responses to.

" - } - }, - "documentation":"

A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:

  • CloudFront caches responses to GET and HEAD requests.

  • CloudFront caches responses to GET, HEAD, and OPTIONS requests.

If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly.

" - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity, for example, E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

" - } - }, - "documentation":"

CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created.

If the CallerReference is a value already sent in a previous identity request, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request.

If the CallerReference is a value you already sent in a previous request to create an identity, but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the origin access identity.

" - } - }, - "documentation":"

Origin access identity configuration. Send a GET request to the /CloudFront API version/CloudFront/identity ID/config resource.

" - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of origin access identities you want in the response body.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CloudFront origin access identities that were created by the current AWS account.

" - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"

A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account.

" - } - }, - "documentation":"

Lists the origin access identities for CloudFront.Send a GET request to the /CloudFront API version/origin-access-identity/cloudfront resource. The response includes a CloudFrontOriginAccessIdentityList element with zero or more CloudFrontOriginAccessIdentitySummary child elements. By default, your entire list of origin access identities is returned in one single page. If the list is long, you can paginate it using the MaxItems and Marker parameters.

" - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment for this origin access identity, as originally specified when created.

" - } - }, - "documentation":"

Summary of the information about a CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different cookies that you want CloudFront to forward to the origin for this cache behavior.

" - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"

A complex type that contains one Name element for each cookie that you want CloudFront to forward to the origin for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"

Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNames complex type.

Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for the Forward element.

" - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"

Required if you specify whitelist for the value of Forward:. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies.

If you specify all or none for the value of Forward, omit WhitelistedNames. If you change the value of Forward from whitelist to all or none and you don't delete the WhitelistedNames element and its child elements, CloudFront deletes them automatically.

For the current limit on the number of cookie names that you can whitelist for each cache behavior, see Amazon CloudFront Limits in the AWS General Reference.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create a new origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create a new distribution.

", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create a new distribution with tags.

", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The batch information for the invalidation.

", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create an invalidation.

", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.

", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create a new streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to create a new streaming distribution with tags.

", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"

The HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"

The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by ErrorCode, for example, /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:

  • The value of PathPattern matches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named /4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example, /4xx-errors/*.

  • The value of TargetOriginId specifies the value of the ID element for the origin that contains your custom error pages.

If you specify a value for ResponsePagePath, you must also specify a value for ResponseCode. If you don't want to specify a value, include an empty element, <ResponsePagePath>, in the XML document.

We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.

" - }, - "ResponseCode":{ - "shape":"string", - "documentation":"

The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example:

  • Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.

  • If you don't care about distinguishing among different client errors or server errors, you can specify 400 or 500 as the ResponseCode for all 4xx or 5xx errors.

  • You might want to return a 200 status code (OK) and static website so your customers don't know that your website is down.

If you specify a value for ResponseCode, you must also specify a value for ResponsePagePath. If you don't want to specify a value, include an empty element, <ResponseCode>, in the XML document.

" - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available.

If you don't want to specify a value, include an empty element, <ErrorCachingMinTTL>, in the XML document.

For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP status codes for which you want to specify a custom error page and/or a caching duration. If Quantity is 0, you can omit Items.

" - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"

A complex type that contains a CustomErrorResponse element for each HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of custom headers, if any, for this distribution.

" - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"

Optional: A list that contains one OriginCustomHeader element for each custom header that you want CloudFront to forward to the origin. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that contains the list of Custom Headers for each origin.

" - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"

The HTTP port the custom origin listens on.

" - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"

The HTTPS port the custom origin listens on.

" - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"

The origin protocol policy to apply to your origin.

" - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"

The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS.

" - }, - "OriginReadTimeout":{ - "shape":"integer", - "documentation":"

You can create a custom origin read timeout. All timeout units are in seconds. The default origin read timeout is 30 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 4 seconds; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

" - }, - "OriginKeepaliveTimeout":{ - "shape":"integer", - "documentation":"

You can create a custom keep-alive timeout. All timeout units are in seconds. The default keep-alive timeout is 5 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 1 second; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

" - } - }, - "documentation":"

A customer origin.

" - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{"shape":"long"}, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - } - }, - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The origin access identity's ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

Deletes a origin access identity.

" - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the following steps.

To delete a web distribution using the CloudFront API:

  1. Disable the web distribution

  2. Submit a GET Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 2.

  5. Review the response to the PUT Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Distribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 6.

  8. Review the response to your DELETE Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "DeleteServiceLinkedRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"string", - "location":"uri", - "locationName":"RoleName" - } - } - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to delete a streaming distribution.

" - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"

The number of invalidation batches currently in progress.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs.

" - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.

" - } - }, - "documentation":"

The distribution's information.

" - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The caller reference you attempted to create the distribution with is associated with another distribution.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique value (for example, a date-time stamp) that ensures that the request can't be replayed.

If the value of CallerReference is new (regardless of the content of the DistributionConfig object), CloudFront creates a new distribution.

If CallerReference is a value you already sent in a previous request to create a distribution, and if the content of the DistributionConfig is identical to the original request (ignoring white space), CloudFront returns the same the response that it returned to the original request.

If CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"

The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/product-description.html). Specifying a default root object avoids exposing the contents of your distribution.

Specify only the object name, for example, index.html. Don't add a / before the object name.

If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element.

To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element.

To replace the default root object, update the distribution configuration and specify the new object.

For more information about the default root object, see Creating a Default Root Object in the Amazon CloudFront Developer Guide.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that controls the following:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the distribution.

If you don't want to specify a comment, include an empty Comment element.

To delete an existing comment, update the distribution configuration and include an empty Comment element.

To add or change a comment, update the distribution configuration and specify the new comment.

" - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the distribution.

For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify PriceClass_All, CloudFront responds to requests for your objects from all CloudFront edge locations.

If you specify a price class other than PriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance.

For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes map to CloudFront regions, see Amazon CloudFront Pricing.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

From this field, you can enable or disable the selected distribution.

If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

A unique identifier that specifies the AWS WAF web ACL, if any, to associate with this distribution.

AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about AWS WAF, see the AWS WAF Developer Guide.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

(Optional) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 automatically use an earlier HTTP version.

For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or later, and must support Server Name Identification (SNI).

In general, configuring CloudFront to communicate with viewers using HTTP/2 reduces latency. You can improve performance by optimizing for HTTP/2. For more information, do an Internet search for \"http/2 optimization.\"

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify true. If you specify false, CloudFront responds to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.

In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the IpAddress parameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide.

If you're using an Amazon Route 53 alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:

  • You enable IPv6 for the distribution

  • You're using alternate domain names in the URLs for your objects

For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Amazon Route 53 Developer Guide.

If you created a CNAME resource record set, either with Amazon Route 53 or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request.

" - } - }, - "documentation":"

A distribution configuration.

" - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

A distribution configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A distribution Configuration and a list of tags to be associated with the distribution.

" - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"

A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A distribution list.

" - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId", - "HttpVersion", - "IsIPV6Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that contains zero or more CustomErrorResponses elements.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept user requests for content.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

The Web ACL Id (if any) associated with the distribution.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.

" - } - }, - "documentation":"

A summary of the information about a CloudFront distribution.

" - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "EventType":{ - "type":"string", - "enum":[ - "viewer-request", - "viewer-response", - "origin-request", - "origin-response" - ] - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.

If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.

If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.

For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.

" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "Headers":{ - "shape":"Headers", - "documentation":"

A complex type that specifies the Headers, if any, that you want CloudFront to base caching on for this cache behavior.

" - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"

The method that you want to use to restrict distribution of your content by country:

  • none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.

  • blacklist: The Location elements specify the countries in which you don't want CloudFront to distribute your content.

  • whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items.

" - }, - "Items":{ - "shape":"LocationList", - "documentation":"

A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist).

The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country.

CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.

" - } - }, - "documentation":"

A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using MaxMind GeoIP databases.

" - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType.

" - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The origin access identity's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an origin access identity's information.

" - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution configuration.

" - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution's information.

" - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request, for example, IDFDVBD632BHDS5.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an invalidation's information.

" - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information. For more information, see Invalidation Complex Type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

To request to get a streaming distribution configuration.

" - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a streaming distribution's information.

" - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different headers that you want CloudFront to base caching on for this cache behavior. You can configure each cache behavior in a web distribution to do one of the following:

  • Forward all headers to your origin: Specify 1 for Quantity and * for Name.

    CloudFront doesn't cache the objects that are associated with this cache behavior. Instead, CloudFront sends every request to the origin.

  • Forward a whitelist of headers you specify: Specify the number of headers that you want CloudFront to base caching on. Then specify the header names in Name elements. CloudFront caches your objects based on the values in the specified headers.

  • Forward only the default headers: Specify 0 for Quantity and omit Items. In this configuration, CloudFront doesn't cache based on the values in the request headers.

Regardless of which option you choose, CloudFront forwards headers to your origin based on whether the origin is an S3 bucket or a custom origin. See the following documentation:

" - }, - "Items":{ - "shape":"HeaderList", - "documentation":"

A list that contains one Name element for each header that you want CloudFront to use for caching in this cache behavior. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that specifies the request headers, if any, that you want CloudFront to base caching on for this cache behavior.

For the headers that you specify, CloudFront caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for logo.jpg contain a custom product header that has a value of either acme or apex, and you configure CloudFront to cache your content based on values in the product header. CloudFront forwards the product header to the origin and caches the response from the origin once for each header value. For more information about caching based on header values, see How CloudFront Forwards and Caches Headers in the Amazon CloudFront Developer Guide.

" - }, - "HttpVersion":{ - "type":"string", - "enum":[ - "http1.1", - "http2" - ] - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Origin and CallerReference cannot be updated.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The value of Quantity and the size of Items don't match.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The argument is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The default root object file name is too big or contains an invalid character.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The If-Match version is missing or not valid for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLambdaFunctionAssociation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified Lambda function association is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The origin access identity is not valid or doesn't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginKeepaliveTimeout":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginReadTimeout":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request. For example: IDFDVBD632BHDS5.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The status of the invalidation request. When the invalidation batch is finished, the status is Completed.

" - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"

The date and time the invalidation request was first made.

" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The current invalidation information for the batch request.

" - } - }, - "documentation":"

An invalidation.

" - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "CallerReference":{ - "shape":"string", - "documentation":"

A value that you specify to uniquely identify an invalidation request. CloudFront uses the value to prevent you from accidentally resubmitting an identical request. Whenever you create a new invalidation request, you must specify a new value for CallerReference and change other values in the request as applicable. One way to ensure that the value of CallerReference is unique is to use a timestamp, for example, 20120301090000.

If you make a second invalidation request with the same value for CallerReference, and if the rest of the request is the same, CloudFront doesn't create a new invalidation request. Instead, CloudFront returns information about the invalidation request that you previously created with the same CallerReference.

If CallerReference is a value you already sent in a previous invalidation batch request but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error.

" - } - }, - "documentation":"

An invalidation batch.

" - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value that you can use for the Marker request parameter to continue listing your invalidation batches where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value that you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of invalidation batches that were created by the current AWS account.

" - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"

A complex type that contains one InvalidationSummary element for each invalidation batch created by the current AWS account.

" - } - }, - "documentation":"

The InvalidationList complex type describes the list of invalidation objects. For more information about invalidation, see Invalidating Objects (Web Distributions Only) in the Amazon CloudFront Developer Guide.

" - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The unique ID for an invalidation request.

" - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"

The status of an invalidation request.

" - } - }, - "documentation":"

A summary of an invalidation request.

" - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of active CloudFront key pairs for AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "LambdaFunctionAssociation":{ - "type":"structure", - "members":{ - "LambdaFunctionARN":{ - "shape":"string", - "documentation":"

The ARN of the Lambda function. You must specify the ARN of a function version; you can't specify a Lambda alias or $LATEST.

" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

Specifies the event type that triggers a Lambda function invocation. You can specify the following values:

  • viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.

  • origin-request: The function executes only when CloudFront forwards a request to your origin. When the requested object is in the edge cache, the function doesn't execute.

  • origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.

    If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.

  • viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache.

    If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.

" - } - }, - "documentation":"

A complex type that contains a Lambda function association.

" - }, - "LambdaFunctionAssociationList":{ - "type":"list", - "member":{ - "shape":"LambdaFunctionAssociation", - "locationName":"LambdaFunctionAssociation" - } - }, - "LambdaFunctionAssociations":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of Lambda function associations for this cache behavior.

" - }, - "Items":{ - "shape":"LambdaFunctionAssociationList", - "documentation":"

Optional: A complex type that contains LambdaFunctionAssociation items for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies a list of Lambda functions associations for a cache behavior.

If you want to invoke one or more Lambda functions triggered by requests that match the PathPattern of the cache behavior, specify the applicable values for Quantity and Items. Note that there can be up to 4 LambdaFunctionAssociation items in this list (one for each possible value of EventType) and each EventType can be associated with the Lambda function only once.

If you don't want to invoke any Lambda functions for the requests that match PathPattern, specify 0 for Quantity and omit Items.

" - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of origin access identities you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list origin access identities.

" - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"

The CloudFrontOriginAccessIdentityList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"

The ID of the AWS WAF web ACL that you want to list the associated distributions. If you specify \"null\" for the ID, the request returns a list of the distributions that aren't associated with a web ACL.

", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"

The request to list distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.

", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your distributions.

" - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"

Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of invalidation batches that you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list invalidations.

" - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"

Information about invalidation batches.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"InvalidationList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The value that you provided for the MaxItems request parameter.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your streaming distributions.

" - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"

The StreamingDistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"

The request to list tags for a CloudFront resource.

" - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, the values are automatically deleted.

" - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for the distribution.

" - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1_2016", - "TLSv1.1_2016", - "TLSv1.2_2018" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires a body. Ensure that the body is present and the Content-Type header is set.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified origin access identity does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified invalidation does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

No origin exists with the specified Origin Id.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified streaming distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

A unique identifier for the origin. The value of Id must be unique within the distribution.

When you specify the value of TargetOriginId for the default cache behavior or for another cache behavior, you indicate the origin to which you want the cache behavior to route requests by specifying the value of the Id element for that origin. When a request matches the path pattern for that cache behavior, CloudFront routes the request to the specified origin. For more information, see Cache Behavior Settings in the Amazon CloudFront Developer Guide.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com.

Constraints for Amazon S3 origins:

  • If you configured Amazon S3 Transfer Acceleration for your bucket, don't specify the s3-accelerate endpoint for DomainName.

  • The bucket name must be between 3 and 63 characters long (inclusive).

  • The bucket name must contain only lowercase characters, numbers, periods, underscores, and dashes.

  • The bucket name must not contain adjacent periods.

Custom Origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com.

Constraints for custom origins:

  • DomainName must be a valid DNS name that contains only a-z, A-Z, 0-9, dot (.), hyphen (-), or underscore (_) characters.

  • The name cannot exceed 128 characters.

" - }, - "OriginPath":{ - "shape":"string", - "documentation":"

An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName, for example, example.com/production. Do not include a / at the end of the directory name.

For example, suppose you've specified the following values for your distribution:

  • DomainName: An Amazon S3 bucket named myawsbucket.

  • OriginPath: /production

  • CNAME: example.com

When a user enters example.com/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/index.html.

When a user enters example.com/acme/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/acme/index.html.

" - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"

A complex type that contains names and values for the custom headers that you want.

" - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"

A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead.

" - } - }, - "documentation":"

A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files. You must create at least one origin.

For the current limit on the number of origins that you can create for a distribution, see Amazon CloudFront Limits in the AWS General Reference.

" - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"

The name of a header that you want CloudFront to forward to your origin. For more information, see Forwarding Custom Headers to Your Origin (Web Distributions Only) in the Amazon Amazon CloudFront Developer Guide.

" - }, - "HeaderValue":{ - "shape":"string", - "documentation":"

The value for the header that you specified in the HeaderName field.

" - } - }, - "documentation":"

A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.

" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin.

" - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"

A list that contains allowed SSL/TLS protocols for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin.

" - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of origins for this distribution.

" - }, - "Items":{ - "shape":"OriginList", - "documentation":"

A complex type that contains origins for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of objects that you want to invalidate.

" - }, - "Items":{ - "shape":"PathList", - "documentation":"

A complex type that contains a list of the paths that you want to invalidate.

" - } - }, - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The precondition given in one or more of the request-header fields evaluated to false.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of whitelisted query string parameters for this cache behavior.

" - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"

(Optional) A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items.

" - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "ResourceInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"

A complex type that identifies ways in which you want to restrict distribution of your content.

" - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"

The DNS name of the Amazon S3 origin.

" - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the RTMP distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an Amazon S3 bucket through CloudFront.

If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content in the Amazon Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:

origin-access-identity/cloudfront/ID-of-origin-access-identity

where ID-of-origin-access-identity is the value that CloudFront returned in the ID element when you created the origin access identity.

If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"

An AWS account that is included in the TrustedSigners complex type for this RTMP distribution. Valid values include:

  • self, which is the AWS account used to create the distribution.

  • An AWS account number.

" - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any.

" - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the RTMP distribution. For example: EGTXBD79EXAMPLE.

" - }, - "ARN":{"shape":"string"}, - "Status":{ - "shape":"string", - "documentation":"

The current status of the RTMP distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the streaming distribution, for example, s5c39gqb8ow64r.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The current configuration information for the RTMP distribution.

" - } - }, - "documentation":"

A streaming distribution.

" - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures that the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the streaming distribution.

" - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies any AWS accounts that you want to permit to create signed URLs for private content. If you want the distribution to use signed URLs, include this element; if you want the distribution to use public URLs, remove this element. For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

A complex type that contains information about price class for this streaming distribution.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the streaming distribution is enabled to accept user requests for content.

" - } - }, - "documentation":"

The RTMP distribution's configuration information.

" - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

A streaming distribution Configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A streaming distribution Configuration and a list of tags to be associated with the streaming distribution.

" - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your RTMP distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of streaming distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"

A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A streaming distribution list.

" - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution, for example, EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items.If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept end user requests for content.

" - } - }, - "documentation":"

A summary of the information for an Amazon CloudFront streaming distribution.

" - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for this streaming distribution.

" - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

A string that contains an optional Tag value.

The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - } - }, - "documentation":"

A complex type that contains Tag key and Tag value.

" - }, - "TagKey":{ - "type":"string", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"

A complex type that contains Tag key elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to add tags to a CloudFront resource.

", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"

A complex type that contains Tag elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more cache behaviors for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create anymore custom SSL/TLS certificates.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of origin access identities allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more cookie names in the whitelist than are allowed per cache behavior.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more CNAMEs than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionsWithLambdaAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyLambdaFunctionAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more Lambda function associations than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more origins for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more trusted signers than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

One or more of your trusted signers don't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want to require viewers to use signed URLs to access the files specified by PathPattern and TargetOriginId.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of trusted signers for this cache behavior.

" - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"

Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

For more information about updating the distribution configuration, see DistributionConfig .

" - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

A complex type that contains zero or more Tag key elements.

", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - } - }, - "documentation":"

The request to remove tags from a CloudFront resource.

", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The identity's configuration information.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The identity's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update an origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a distribution.

", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-03-25/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"

For information about how and when to use CloudFrontDefaultCertificate, see ViewerCertificate.

" - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"

For information about how and when to use IAMCertificateId, see ViewerCertificate.

" - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"

For information about how and when to use ACMCertificateArn, see ViewerCertificate.

" - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"

If you specify a value for ViewerCertificate$ACMCertificateArn or for ViewerCertificate$IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests: using a method that works for all clients or one that works for most clients:

  • vip: CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you will incur additional monthly charges.

  • sni-only: CloudFront can respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. If some of your users' browsers don't support SNI, we recommend that you do one of the following:

    • Use the vip option (dedicated IP addresses) instead of sni-only.

    • Use the CloudFront SSL/TLS certificate instead of a custom certificate. This requires that you use the CloudFront domain name of your distribution in the URLs for your objects, for example, https://d111111abcdef8.cloudfront.net/logo.png.

    • If you can control which browser your users use, upgrade the browser to one that supports SNI.

    • Use HTTP instead of HTTPS.

Don't specify a value for SSLSupportMethod if you specified <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>.

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"

Specify the security policy that you want CloudFront to use for HTTPS connections. A security policy determines two settings:

  • The minimum SSL/TLS protocol that CloudFront uses to communicate with viewers

  • The cipher that CloudFront uses to encrypt the content that it returns to viewers

On the CloudFront console, this setting is called Security policy.

We recommend that you specify TLSv1.1_2016 unless your users are using browsers or devices that do not support TLSv1.1 or later.

When both of the following are true, you must specify TLSv1 or later for the security policy:

  • You're using a custom certificate: you specified a value for ACMCertificateArn or for IAMCertificateId

  • You're using SNI: you specified sni-only for SSLSupportMethod

If you specify true for CloudFrontDefaultCertificate, CloudFront automatically sets the security policy to TLSv1 regardless of the value that you specify for MinimumProtocolVersion.

For information about the relationship between the security policy that you choose and the protocols and ciphers that CloudFront uses to communicate with viewers, see Supported SSL/TLS Protocols and Ciphers for Communication Between Viewers and CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "Certificate":{ - "shape":"string", - "documentation":"

This field has been deprecated. Use one of the following fields instead:

", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"

This field has been deprecated. Use one of the following fields instead:

", - "deprecated":true - } - }, - "documentation":"

A complex type that specifies the following:

  • Whether you want viewers to use HTTP or HTTPS to request your objects.

  • If you want viewers to use HTTPS, whether you're using an alternate domain name such as example.com or the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net.

  • If you're using an alternate domain name, whether AWS Certificate Manager (ACM) provided the certificate, or you purchased a certificate from a third-party certificate authority and imported it into ACM or uploaded it to the IAM certificate store.

You must specify only one of the following values:

Don't specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP instead of HTTPS to request your objects: Specify the following value:

<CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

In addition, specify allow-all for ViewerProtocolPolicy for all of your cache behaviors.

If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:

  • If you're using an alternate domain name, such as example.com: Specify one of the following values, depending on whether ACM provided your certificate or you purchased your certificate from third-party certificate authority:

    • <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate that you want to use for this distribution.

    • <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate ID is the ID that IAM returned when you added the certificate to the IAM certificate store.

    If you specify ACMCertificateArn or IAMCertificateId, you must also specify a value for SSLSupportMethod.

    If you choose to use an ACM certificate or a certificate in the IAM certificate store, we recommend that you use only an alternate domain name in your object URLs (https://example.com/logo.jpg). If you use the domain name that is associated with your CloudFront distribution (such as https://d111111abcdef8.cloudfront.net/logo.jpg) and the viewer supports SNI, then CloudFront behaves normally. However, if the browser does not support SNI, the user's experience depends on the value that you choose for SSLSupportMethod:

    • vip: The viewer displays a warning because there is a mismatch between the CloudFront domain name and the domain name in your SSL/TLS certificate.

    • sni-only: CloudFront drops the connection with the browser without returning the object.

  • If you're using the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net : Specify the following value:

    <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:

  • <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy>

  • <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy>

You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:

  • <OriginProtocolPolicy>https-only<OriginProtocolPolicy>

  • <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy>

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/waiters-2.json deleted file mode 100644 index edd74b2a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-03-25/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 30, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/paginators-1.json deleted file mode 100644 index 51fbb907..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListCloudFrontOriginAccessIdentities": { - "input_token": "Marker", - "output_token": "CloudFrontOriginAccessIdentityList.NextMarker", - "limit_key": "MaxItems", - "more_results": "CloudFrontOriginAccessIdentityList.IsTruncated", - "result_key": "CloudFrontOriginAccessIdentityList.Items" - }, - "ListDistributions": { - "input_token": "Marker", - "output_token": "DistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "DistributionList.IsTruncated", - "result_key": "DistributionList.Items" - }, - "ListInvalidations": { - "input_token": "Marker", - "output_token": "InvalidationList.NextMarker", - "limit_key": "MaxItems", - "more_results": "InvalidationList.IsTruncated", - "result_key": "InvalidationList.Items" - }, - "ListStreamingDistributions": { - "input_token": "Marker", - "output_token": "StreamingDistributionList.NextMarker", - "limit_key": "MaxItems", - "more_results": "StreamingDistributionList.IsTruncated", - "result_key": "StreamingDistributionList.Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/service-2.json deleted file mode 100644 index 3dad99bf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/service-2.json +++ /dev/null @@ -1,5187 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-30", - "endpointPrefix":"cloudfront", - "globalEndpoint":"cloudfront.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"CloudFront", - "serviceFullName":"Amazon CloudFront", - "serviceId":"CloudFront", - "signatureVersion":"v4", - "uid":"cloudfront-2017-10-30" - }, - "operations":{ - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront", - "responseCode":201 - }, - "input":{"shape":"CreateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"CreateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"CloudFrontOriginAccessIdentityAlreadyExists"}, - {"shape":"MissingBody"}, - {"shape":"TooManyCloudFrontOriginAccessIdentities"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "CreateDistribution":{ - "name":"CreateDistribution2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/distribution", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionRequest"}, - "output":{"shape":"CreateDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"}, - {"shape":"IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior"}, - {"shape":"TooManyDistributionsAssociatedToFieldLevelEncryptionConfig"} - ], - "documentation":"

Creates a new web distribution. Send a POST request to the /CloudFront API version/distribution/distribution ID resource.

" - }, - "CreateDistributionWithTags":{ - "name":"CreateDistributionWithTags2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateDistributionWithTagsRequest"}, - "output":{"shape":"CreateDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"DistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"MissingBody"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"TooManyDistributions"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidProtocolSettings"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"InvalidTagging"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"}, - {"shape":"IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior"}, - {"shape":"TooManyDistributionsAssociatedToFieldLevelEncryptionConfig"} - ], - "documentation":"

Create a new distribution with tags.

" - }, - "CreateFieldLevelEncryptionConfig":{ - "name":"CreateFieldLevelEncryptionConfig2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/field-level-encryption", - "responseCode":201 - }, - "input":{"shape":"CreateFieldLevelEncryptionConfigRequest"}, - "output":{"shape":"CreateFieldLevelEncryptionConfigResult"}, - "errors":[ - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"}, - {"shape":"FieldLevelEncryptionConfigAlreadyExists"}, - {"shape":"TooManyFieldLevelEncryptionConfigs"}, - {"shape":"TooManyFieldLevelEncryptionQueryArgProfiles"}, - {"shape":"TooManyFieldLevelEncryptionContentTypeProfiles"}, - {"shape":"QueryArgProfileEmpty"} - ], - "documentation":"

Create a new field-level encryption configuration.

" - }, - "CreateFieldLevelEncryptionProfile":{ - "name":"CreateFieldLevelEncryptionProfile2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/field-level-encryption-profile", - "responseCode":201 - }, - "input":{"shape":"CreateFieldLevelEncryptionProfileRequest"}, - "output":{"shape":"CreateFieldLevelEncryptionProfileResult"}, - "errors":[ - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchPublicKey"}, - {"shape":"FieldLevelEncryptionProfileAlreadyExists"}, - {"shape":"FieldLevelEncryptionProfileSizeExceeded"}, - {"shape":"TooManyFieldLevelEncryptionProfiles"}, - {"shape":"TooManyFieldLevelEncryptionEncryptionEntities"}, - {"shape":"TooManyFieldLevelEncryptionFieldPatterns"} - ], - "documentation":"

Create a field-level encryption profile.

" - }, - "CreateInvalidation":{ - "name":"CreateInvalidation2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/distribution/{DistributionId}/invalidation", - "responseCode":201 - }, - "input":{"shape":"CreateInvalidationRequest"}, - "output":{"shape":"CreateInvalidationResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"MissingBody"}, - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"BatchTooLarge"}, - {"shape":"TooManyInvalidationsInProgress"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Create a new invalidation.

" - }, - "CreatePublicKey":{ - "name":"CreatePublicKey2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/public-key", - "responseCode":201 - }, - "input":{"shape":"CreatePublicKeyRequest"}, - "output":{"shape":"CreatePublicKeyResult"}, - "errors":[ - {"shape":"PublicKeyAlreadyExists"}, - {"shape":"InvalidArgument"}, - {"shape":"TooManyPublicKeys"} - ], - "documentation":"

Add a new public key to CloudFront to use, for example, for field-level encryption. You can add a maximum of 10 public keys with one AWS account.

" - }, - "CreateStreamingDistribution":{ - "name":"CreateStreamingDistribution2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/streaming-distribution", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionRequest"}, - "output":{"shape":"CreateStreamingDistributionResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

" - }, - "CreateStreamingDistributionWithTags":{ - "name":"CreateStreamingDistributionWithTags2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/streaming-distribution?WithTags", - "responseCode":201 - }, - "input":{"shape":"CreateStreamingDistributionWithTagsRequest"}, - "output":{"shape":"CreateStreamingDistributionWithTagsResult"}, - "errors":[ - {"shape":"CNAMEAlreadyExists"}, - {"shape":"StreamingDistributionAlreadyExists"}, - {"shape":"InvalidOrigin"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"AccessDenied"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"MissingBody"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"TooManyStreamingDistributions"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidTagging"} - ], - "documentation":"

Create a new streaming distribution with tags.

" - }, - "DeleteCloudFrontOriginAccessIdentity":{ - "name":"DeleteCloudFrontOriginAccessIdentity2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteCloudFrontOriginAccessIdentityRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"CloudFrontOriginAccessIdentityInUse"} - ], - "documentation":"

Delete an origin access identity.

" - }, - "DeleteDistribution":{ - "name":"DeleteDistribution2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"DistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a distribution.

" - }, - "DeleteFieldLevelEncryptionConfig":{ - "name":"DeleteFieldLevelEncryptionConfig2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/field-level-encryption/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteFieldLevelEncryptionConfigRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"}, - {"shape":"PreconditionFailed"}, - {"shape":"FieldLevelEncryptionConfigInUse"} - ], - "documentation":"

Remove a field-level encryption configuration.

" - }, - "DeleteFieldLevelEncryptionProfile":{ - "name":"DeleteFieldLevelEncryptionProfile2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/field-level-encryption-profile/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteFieldLevelEncryptionProfileRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"}, - {"shape":"PreconditionFailed"}, - {"shape":"FieldLevelEncryptionProfileInUse"} - ], - "documentation":"

Remove a field-level encryption profile.

" - }, - "DeletePublicKey":{ - "name":"DeletePublicKey2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/public-key/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeletePublicKeyRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"PublicKeyInUse"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchPublicKey"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Remove a public key you previously added to CloudFront.

" - }, - "DeleteStreamingDistribution":{ - "name":"DeleteStreamingDistribution2017_10_30", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-30/streaming-distribution/{Id}", - "responseCode":204 - }, - "input":{"shape":"DeleteStreamingDistributionRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"StreamingDistributionNotDisabled"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "GetCloudFrontOriginAccessIdentity":{ - "name":"GetCloudFrontOriginAccessIdentity2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront/{Id}" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an origin access identity.

" - }, - "GetCloudFrontOriginAccessIdentityConfig":{ - "name":"GetCloudFrontOriginAccessIdentityConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"GetCloudFrontOriginAccessIdentityConfigRequest"}, - "output":{"shape":"GetCloudFrontOriginAccessIdentityConfigResult"}, - "errors":[ - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about an origin access identity.

" - }, - "GetDistribution":{ - "name":"GetDistribution2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distribution/{Id}" - }, - "input":{"shape":"GetDistributionRequest"}, - "output":{"shape":"GetDistributionResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about a distribution.

" - }, - "GetDistributionConfig":{ - "name":"GetDistributionConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distribution/{Id}/config" - }, - "input":{"shape":"GetDistributionConfigRequest"}, - "output":{"shape":"GetDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a distribution.

" - }, - "GetFieldLevelEncryption":{ - "name":"GetFieldLevelEncryption2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption/{Id}" - }, - "input":{"shape":"GetFieldLevelEncryptionRequest"}, - "output":{"shape":"GetFieldLevelEncryptionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"} - ], - "documentation":"

Get the field-level encryption configuration information.

" - }, - "GetFieldLevelEncryptionConfig":{ - "name":"GetFieldLevelEncryptionConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption/{Id}/config" - }, - "input":{"shape":"GetFieldLevelEncryptionConfigRequest"}, - "output":{"shape":"GetFieldLevelEncryptionConfigResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"} - ], - "documentation":"

Get the field-level encryption configuration information.

" - }, - "GetFieldLevelEncryptionProfile":{ - "name":"GetFieldLevelEncryptionProfile2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption-profile/{Id}" - }, - "input":{"shape":"GetFieldLevelEncryptionProfileRequest"}, - "output":{"shape":"GetFieldLevelEncryptionProfileResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"} - ], - "documentation":"

Get the field-level encryption profile information.

" - }, - "GetFieldLevelEncryptionProfileConfig":{ - "name":"GetFieldLevelEncryptionProfileConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption-profile/{Id}/config" - }, - "input":{"shape":"GetFieldLevelEncryptionProfileConfigRequest"}, - "output":{"shape":"GetFieldLevelEncryptionProfileConfigResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"} - ], - "documentation":"

Get the field-level encryption profile configuration information.

" - }, - "GetInvalidation":{ - "name":"GetInvalidation2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distribution/{DistributionId}/invalidation/{Id}" - }, - "input":{"shape":"GetInvalidationRequest"}, - "output":{"shape":"GetInvalidationResult"}, - "errors":[ - {"shape":"NoSuchInvalidation"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the information about an invalidation.

" - }, - "GetPublicKey":{ - "name":"GetPublicKey2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/public-key/{Id}" - }, - "input":{"shape":"GetPublicKeyRequest"}, - "output":{"shape":"GetPublicKeyResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchPublicKey"} - ], - "documentation":"

Get the public key information.

" - }, - "GetPublicKeyConfig":{ - "name":"GetPublicKeyConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/public-key/{Id}/config" - }, - "input":{"shape":"GetPublicKeyConfigRequest"}, - "output":{"shape":"GetPublicKeyConfigResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"NoSuchPublicKey"} - ], - "documentation":"

Return public key configuration informaation

" - }, - "GetStreamingDistribution":{ - "name":"GetStreamingDistribution2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/streaming-distribution/{Id}" - }, - "input":{"shape":"GetStreamingDistributionRequest"}, - "output":{"shape":"GetStreamingDistributionResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Gets information about a specified RTMP distribution, including the distribution configuration.

" - }, - "GetStreamingDistributionConfig":{ - "name":"GetStreamingDistributionConfig2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/streaming-distribution/{Id}/config" - }, - "input":{"shape":"GetStreamingDistributionConfigRequest"}, - "output":{"shape":"GetStreamingDistributionConfigResult"}, - "errors":[ - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Get the configuration information about a streaming distribution.

" - }, - "ListCloudFrontOriginAccessIdentities":{ - "name":"ListCloudFrontOriginAccessIdentities2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront" - }, - "input":{"shape":"ListCloudFrontOriginAccessIdentitiesRequest"}, - "output":{"shape":"ListCloudFrontOriginAccessIdentitiesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

Lists origin access identities.

" - }, - "ListDistributions":{ - "name":"ListDistributions2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distribution" - }, - "input":{"shape":"ListDistributionsRequest"}, - "output":{"shape":"ListDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List distributions.

" - }, - "ListDistributionsByWebACLId":{ - "name":"ListDistributionsByWebACLId2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distributionsByWebACLId/{WebACLId}" - }, - "input":{"shape":"ListDistributionsByWebACLIdRequest"}, - "output":{"shape":"ListDistributionsByWebACLIdResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"InvalidWebACLId"} - ], - "documentation":"

List the distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListFieldLevelEncryptionConfigs":{ - "name":"ListFieldLevelEncryptionConfigs2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption" - }, - "input":{"shape":"ListFieldLevelEncryptionConfigsRequest"}, - "output":{"shape":"ListFieldLevelEncryptionConfigsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List all field-level encryption configurations that have been created in CloudFront for this account.

" - }, - "ListFieldLevelEncryptionProfiles":{ - "name":"ListFieldLevelEncryptionProfiles2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/field-level-encryption-profile" - }, - "input":{"shape":"ListFieldLevelEncryptionProfilesRequest"}, - "output":{"shape":"ListFieldLevelEncryptionProfilesResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

Request a list of field-level encryption profiles that have been created in CloudFront for this account.

" - }, - "ListInvalidations":{ - "name":"ListInvalidations2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/distribution/{DistributionId}/invalidation" - }, - "input":{"shape":"ListInvalidationsRequest"}, - "output":{"shape":"ListInvalidationsResult"}, - "errors":[ - {"shape":"InvalidArgument"}, - {"shape":"NoSuchDistribution"}, - {"shape":"AccessDenied"} - ], - "documentation":"

Lists invalidation batches.

" - }, - "ListPublicKeys":{ - "name":"ListPublicKeys2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/public-key" - }, - "input":{"shape":"ListPublicKeysRequest"}, - "output":{"shape":"ListPublicKeysResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List all public keys that have been added to CloudFront for this account.

" - }, - "ListStreamingDistributions":{ - "name":"ListStreamingDistributions2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/streaming-distribution" - }, - "input":{"shape":"ListStreamingDistributionsRequest"}, - "output":{"shape":"ListStreamingDistributionsResult"}, - "errors":[ - {"shape":"InvalidArgument"} - ], - "documentation":"

List streaming distributions.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource2017_10_30", - "http":{ - "method":"GET", - "requestUri":"/2017-10-30/tagging" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

List tags for a CloudFront resource.

" - }, - "TagResource":{ - "name":"TagResource2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/tagging?Operation=Tag", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Add tags to a CloudFront resource.

" - }, - "UntagResource":{ - "name":"UntagResource2017_10_30", - "http":{ - "method":"POST", - "requestUri":"/2017-10-30/tagging?Operation=Untag", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidTagging"}, - {"shape":"NoSuchResource"} - ], - "documentation":"

Remove tags from a CloudFront resource.

" - }, - "UpdateCloudFrontOriginAccessIdentity":{ - "name":"UpdateCloudFrontOriginAccessIdentity2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/origin-access-identity/cloudfront/{Id}/config" - }, - "input":{"shape":"UpdateCloudFrontOriginAccessIdentityRequest"}, - "output":{"shape":"UpdateCloudFrontOriginAccessIdentityResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchCloudFrontOriginAccessIdentity"}, - {"shape":"PreconditionFailed"}, - {"shape":"InvalidArgument"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update an origin access identity.

" - }, - "UpdateDistribution":{ - "name":"UpdateDistribution2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/distribution/{Id}/config" - }, - "input":{"shape":"UpdateDistributionRequest"}, - "output":{"shape":"UpdateDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyDistributionCNAMEs"}, - {"shape":"InvalidDefaultRootObject"}, - {"shape":"InvalidRelativePath"}, - {"shape":"InvalidErrorCode"}, - {"shape":"InvalidResponseCode"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InvalidViewerCertificate"}, - {"shape":"InvalidMinimumProtocolVersion"}, - {"shape":"InvalidRequiredProtocol"}, - {"shape":"NoSuchOrigin"}, - {"shape":"TooManyOrigins"}, - {"shape":"TooManyCacheBehaviors"}, - {"shape":"TooManyCookieNamesInWhiteList"}, - {"shape":"InvalidForwardCookies"}, - {"shape":"TooManyHeadersInForwardedValues"}, - {"shape":"InvalidHeadersForS3Origin"}, - {"shape":"InconsistentQuantities"}, - {"shape":"TooManyCertificates"}, - {"shape":"InvalidLocationCode"}, - {"shape":"InvalidGeoRestrictionParameter"}, - {"shape":"InvalidTTLOrder"}, - {"shape":"InvalidWebACLId"}, - {"shape":"TooManyOriginCustomHeaders"}, - {"shape":"TooManyQueryStringParameters"}, - {"shape":"InvalidQueryStringParameters"}, - {"shape":"TooManyDistributionsWithLambdaAssociations"}, - {"shape":"TooManyLambdaFunctionAssociations"}, - {"shape":"InvalidLambdaFunctionAssociation"}, - {"shape":"InvalidOriginReadTimeout"}, - {"shape":"InvalidOriginKeepaliveTimeout"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"}, - {"shape":"IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior"}, - {"shape":"TooManyDistributionsAssociatedToFieldLevelEncryptionConfig"} - ], - "documentation":"

Updates the configuration for a web distribution. Perform the following steps.

For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console in the Amazon CloudFront Developer Guide.

To update a web distribution using the CloudFront API

  1. Submit a GetDistributionConfig request to get the current configuration and an Etag header for the distribution.

    If you update the distribution again, you need to get a new Etag header.

  2. Update the XML document that was returned in the response to your GetDistributionConfig request to include the desired changes. You can't change the value of CallerReference. If you try to change this value, CloudFront returns an IllegalUpdate error.

    The new configuration replaces the existing configuration; the values that you specify in an UpdateDistribution request are not merged into the existing configuration. When you add, delete, or replace values in an element that allows multiple values (for example, CNAME), you must specify all of the values that you want to appear in the updated distribution. In addition, you must update the corresponding Quantity element.

  3. Submit an UpdateDistribution request to update the configuration for your distribution:

    • In the request body, include the XML document that you updated in Step 2. The request body must include an XML document with a DistributionConfig element.

    • Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GetDistributionConfig request in Step 1.

  4. Review the response to the UpdateDistribution request to confirm that the configuration was successfully updated.

  5. Optional: Submit a GetDistribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

    Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a distribution. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values you're actually specifying.

" - }, - "UpdateFieldLevelEncryptionConfig":{ - "name":"UpdateFieldLevelEncryptionConfig2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/field-level-encryption/{Id}/config" - }, - "input":{"shape":"UpdateFieldLevelEncryptionConfigRequest"}, - "output":{"shape":"UpdateFieldLevelEncryptionConfigResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"IllegalUpdate"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"}, - {"shape":"NoSuchFieldLevelEncryptionConfig"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyFieldLevelEncryptionQueryArgProfiles"}, - {"shape":"TooManyFieldLevelEncryptionContentTypeProfiles"}, - {"shape":"QueryArgProfileEmpty"} - ], - "documentation":"

Update a field-level encryption configuration.

" - }, - "UpdateFieldLevelEncryptionProfile":{ - "name":"UpdateFieldLevelEncryptionProfile2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/field-level-encryption-profile/{Id}/config" - }, - "input":{"shape":"UpdateFieldLevelEncryptionProfileRequest"}, - "output":{"shape":"UpdateFieldLevelEncryptionProfileResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"FieldLevelEncryptionProfileAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InconsistentQuantities"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"NoSuchPublicKey"}, - {"shape":"NoSuchFieldLevelEncryptionProfile"}, - {"shape":"PreconditionFailed"}, - {"shape":"FieldLevelEncryptionProfileSizeExceeded"}, - {"shape":"TooManyFieldLevelEncryptionEncryptionEntities"}, - {"shape":"TooManyFieldLevelEncryptionFieldPatterns"} - ], - "documentation":"

Update a field-level encryption profile.

" - }, - "UpdatePublicKey":{ - "name":"UpdatePublicKey2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/public-key/{Id}/config" - }, - "input":{"shape":"UpdatePublicKeyRequest"}, - "output":{"shape":"UpdatePublicKeyResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CannotChangeImmutablePublicKeyFields"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"IllegalUpdate"}, - {"shape":"NoSuchPublicKey"}, - {"shape":"PreconditionFailed"} - ], - "documentation":"

Update public key information. Note that the only value you can change is the comment.

" - }, - "UpdateStreamingDistribution":{ - "name":"UpdateStreamingDistribution2017_10_30", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-30/streaming-distribution/{Id}/config" - }, - "input":{"shape":"UpdateStreamingDistributionRequest"}, - "output":{"shape":"UpdateStreamingDistributionResult"}, - "errors":[ - {"shape":"AccessDenied"}, - {"shape":"CNAMEAlreadyExists"}, - {"shape":"IllegalUpdate"}, - {"shape":"InvalidIfMatchVersion"}, - {"shape":"MissingBody"}, - {"shape":"NoSuchStreamingDistribution"}, - {"shape":"PreconditionFailed"}, - {"shape":"TooManyStreamingDistributionCNAMEs"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidOriginAccessIdentity"}, - {"shape":"TooManyTrustedSigners"}, - {"shape":"TrustedSignerDoesNotExist"}, - {"shape":"InconsistentQuantities"} - ], - "documentation":"

Update a streaming distribution.

" - } - }, - "shapes":{ - "AccessDenied":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Access denied.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "ActiveTrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Enabled is true if any of the AWS accounts listed in the TrustedSigners complex type for this RTMP distribution have active CloudFront key pairs. If not, Enabled is false.

For more information, see ActiveTrustedSigners.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"SignerList", - "documentation":"

A complex type that contains one Signer complex type for each trusted signer that is specified in the TrustedSigners complex type.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "AliasList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"CNAME" - } - }, - "Aliases":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CNAME aliases, if any, that you want to associate with this distribution.

" - }, - "Items":{ - "shape":"AliasList", - "documentation":"

A complex type that contains the CNAME aliases, if any, that you want to associate with this distribution.

" - } - }, - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "AllowedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods that you want CloudFront to forward to your origin. Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD, and OPTIONS requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to process and forward to your origin.

" - }, - "CachedMethods":{"shape":"CachedMethods"} - }, - "documentation":"

A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:

  • CloudFront forwards only GET and HEAD requests.

  • CloudFront forwards only GET, HEAD, and OPTIONS requests.

  • CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests.

If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin.

" - }, - "AwsAccountNumberList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"AwsAccountNumber" - } - }, - "BatchTooLarge":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":413}, - "exception":true - }, - "CNAMEAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CacheBehavior":{ - "type":"structure", - "required":[ - "PathPattern", - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "PathPattern":{ - "shape":"string", - "documentation":"

The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution.

You can optionally include a slash (/) at the beginning of the path pattern. For example, /images/*.jpg. CloudFront behavior is the same with or without the leading /.

The path pattern for the default cache behavior is * and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior.

For more information, see Path Pattern in the Amazon CloudFront Developer Guide.

" - }, - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{ - "shape":"long", - "documentation":"

The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - }, - "FieldLevelEncryptionId":{"shape":"string"} - }, - "documentation":"

A complex type that describes how CloudFront processes requests.

You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.

For the current limit on the number of cache behaviors that you can add to a distribution, see Amazon CloudFront Limits in the AWS General Reference.

If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error.

To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.

To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.

For more information about cache behaviors, see Cache Behaviors in the Amazon CloudFront Developer Guide.

" - }, - "CacheBehaviorList":{ - "type":"list", - "member":{ - "shape":"CacheBehavior", - "locationName":"CacheBehavior" - } - }, - "CacheBehaviors":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of cache behaviors for this distribution.

" - }, - "Items":{ - "shape":"CacheBehaviorList", - "documentation":"

Optional: A complex type that contains cache behaviors for this distribution. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CachedMethods":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP methods for which you want CloudFront to cache responses. Valid values are 2 (for caching responses to GET and HEAD requests) and 3 (for caching responses to GET, HEAD, and OPTIONS requests).

" - }, - "Items":{ - "shape":"MethodsList", - "documentation":"

A complex type that contains the HTTP methods that you want CloudFront to cache responses to.

" - } - }, - "documentation":"

A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:

  • CloudFront caches responses to GET and HEAD requests.

  • CloudFront caches responses to GET, HEAD, and OPTIONS requests.

If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly.

" - }, - "CannotChangeImmutablePublicKeyFields":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You can't change the value of a public key.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "CertificateSource":{ - "type":"string", - "enum":[ - "cloudfront", - "iam", - "acm" - ] - }, - "CloudFrontOriginAccessIdentity":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity, for example, E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

" - } - }, - "documentation":"

CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentityAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Comment" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created.

If the CallerReference is a value already sent in a previous identity request, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request.

If the CallerReference is a value you already sent in a previous request to create an identity, but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the origin access identity.

" - } - }, - "documentation":"

Origin access identity configuration. Send a GET request to the /CloudFront API version/CloudFront/identity ID/config resource.

" - }, - "CloudFrontOriginAccessIdentityInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "CloudFrontOriginAccessIdentityList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your origin access identities where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of origin access identities you want in the response body.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more origin access identities remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more items in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of CloudFront origin access identities that were created by the current AWS account.

" - }, - "Items":{ - "shape":"CloudFrontOriginAccessIdentitySummaryList", - "documentation":"

A complex type that contains one CloudFrontOriginAccessIdentitySummary element for each origin access identity that was created by the current AWS account.

" - } - }, - "documentation":"

Lists the origin access identities for CloudFront.Send a GET request to the /CloudFront API version/origin-access-identity/cloudfront resource. The response includes a CloudFrontOriginAccessIdentityList element with zero or more CloudFrontOriginAccessIdentitySummary child elements. By default, your entire list of origin access identities is returned in one single page. If the list is long, you can paginate it using the MaxItems and Marker parameters.

" - }, - "CloudFrontOriginAccessIdentitySummary":{ - "type":"structure", - "required":[ - "Id", - "S3CanonicalUserId", - "Comment" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for the origin access identity. For example: E74FTE3AJFJ256A.

" - }, - "S3CanonicalUserId":{ - "shape":"string", - "documentation":"

The Amazon S3 canonical user ID for the origin access identity, which you use when giving the origin access identity read permission to an object in Amazon S3.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment for this origin access identity, as originally specified when created.

" - } - }, - "documentation":"

Summary of the information about a CloudFront origin access identity.

" - }, - "CloudFrontOriginAccessIdentitySummaryList":{ - "type":"list", - "member":{ - "shape":"CloudFrontOriginAccessIdentitySummary", - "locationName":"CloudFrontOriginAccessIdentitySummary" - } - }, - "ContentTypeProfile":{ - "type":"structure", - "required":[ - "Format", - "ContentType" - ], - "members":{ - "Format":{ - "shape":"Format", - "documentation":"

The format for a field-level encryption content type-profile mapping.

" - }, - "ProfileId":{ - "shape":"string", - "documentation":"

The profile ID for a field-level encryption content type-profile mapping.

" - }, - "ContentType":{ - "shape":"string", - "documentation":"

The content type for a field-level encryption content type-profile mapping.

" - } - }, - "documentation":"

A field-level encryption content type profile.

" - }, - "ContentTypeProfileConfig":{ - "type":"structure", - "required":["ForwardWhenContentTypeIsUnknown"], - "members":{ - "ForwardWhenContentTypeIsUnknown":{ - "shape":"boolean", - "documentation":"

The setting in a field-level encryption content type-profile mapping that specifies what to do when an unknown content type is provided for the profile. If true, content is forwarded without being encrypted when the content type is unknown. If false (the default), an error is returned when the content type is unknown.

" - }, - "ContentTypeProfiles":{ - "shape":"ContentTypeProfiles", - "documentation":"

The configuration for a field-level encryption content type-profile.

" - } - }, - "documentation":"

The configuration for a field-level encryption content type-profile mapping.

" - }, - "ContentTypeProfileList":{ - "type":"list", - "member":{ - "shape":"ContentTypeProfile", - "locationName":"ContentTypeProfile" - } - }, - "ContentTypeProfiles":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of field-level encryption content type-profile mappings.

" - }, - "Items":{ - "shape":"ContentTypeProfileList", - "documentation":"

Items in a field-level encryption content type-profile mapping.

" - } - }, - "documentation":"

Field-level encryption content type-profile.

" - }, - "CookieNameList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "CookieNames":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different cookies that you want CloudFront to forward to the origin for this cache behavior.

" - }, - "Items":{ - "shape":"CookieNameList", - "documentation":"

A complex type that contains one Name element for each cookie that you want CloudFront to forward to the origin for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CookiePreference":{ - "type":"structure", - "required":["Forward"], - "members":{ - "Forward":{ - "shape":"ItemSelection", - "documentation":"

Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNames complex type.

Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for the Forward element.

" - }, - "WhitelistedNames":{ - "shape":"CookieNames", - "documentation":"

Required if you specify whitelist for the value of Forward:. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies.

If you specify all or none for the value of Forward, omit WhitelistedNames. If you change the value of Forward from whitelist to all or none and you don't delete the WhitelistedNames element and its child elements, CloudFront deletes them automatically.

For the current limit on the number of cookie names that you can whitelist for each cache behavior, see Amazon CloudFront Limits in the AWS General Reference.

" - } - }, - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "CreateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["CloudFrontOriginAccessIdentityConfig"], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The current configuration information for the identity.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create a new origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "CreateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new origin access identity just created. For example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "CreateDistributionRequest":{ - "type":"structure", - "required":["DistributionConfig"], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create a new distribution.

", - "payload":"DistributionConfig" - }, - "CreateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateDistributionWithTagsRequest":{ - "type":"structure", - "required":["DistributionConfigWithTags"], - "members":{ - "DistributionConfigWithTags":{ - "shape":"DistributionConfigWithTags", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create a new distribution with tags.

", - "payload":"DistributionConfigWithTags" - }, - "CreateDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "CreateFieldLevelEncryptionConfigRequest":{ - "type":"structure", - "required":["FieldLevelEncryptionConfig"], - "members":{ - "FieldLevelEncryptionConfig":{ - "shape":"FieldLevelEncryptionConfig", - "documentation":"

The request to create a new field-level encryption configuration.

", - "locationName":"FieldLevelEncryptionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "payload":"FieldLevelEncryptionConfig" - }, - "CreateFieldLevelEncryptionConfigResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryption":{ - "shape":"FieldLevelEncryption", - "documentation":"

Returned when you create a new field-level encryption configuration.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new configuration resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/field-level-encryption-config/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field level encryption configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryption" - }, - "CreateFieldLevelEncryptionProfileRequest":{ - "type":"structure", - "required":["FieldLevelEncryptionProfileConfig"], - "members":{ - "FieldLevelEncryptionProfileConfig":{ - "shape":"FieldLevelEncryptionProfileConfig", - "documentation":"

The request to create a field-level encryption profile.

", - "locationName":"FieldLevelEncryptionProfileConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "payload":"FieldLevelEncryptionProfileConfig" - }, - "CreateFieldLevelEncryptionProfileResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionProfile":{ - "shape":"FieldLevelEncryptionProfile", - "documentation":"

Returned when you create a new field-level encryption profile.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new profile resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/field-level-encryption-profile/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field level encryption profile. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryptionProfile" - }, - "CreateInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "InvalidationBatch" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"DistributionId" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The batch information for the invalidation.

", - "locationName":"InvalidationBatch", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create an invalidation.

", - "payload":"InvalidationBatch" - }, - "CreateInvalidationResult":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the distribution and invalidation batch request, including the Invalidation ID.

", - "location":"header", - "locationName":"Location" - }, - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "CreatePublicKeyRequest":{ - "type":"structure", - "required":["PublicKeyConfig"], - "members":{ - "PublicKeyConfig":{ - "shape":"PublicKeyConfig", - "documentation":"

The request to add a public key to CloudFront.

", - "locationName":"PublicKeyConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "payload":"PublicKeyConfig" - }, - "CreatePublicKeyResult":{ - "type":"structure", - "members":{ - "PublicKey":{ - "shape":"PublicKey", - "documentation":"

Returned when you add a public key.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new public key resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/cloudfront-public-key/EDFDVBD632BHDS5.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the public key. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"PublicKey" - }, - "CreateStreamingDistributionRequest":{ - "type":"structure", - "required":["StreamingDistributionConfig"], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create a new streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "CreateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution created.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CreateStreamingDistributionWithTagsRequest":{ - "type":"structure", - "required":["StreamingDistributionConfigWithTags"], - "members":{ - "StreamingDistributionConfigWithTags":{ - "shape":"StreamingDistributionConfigWithTags", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfigWithTags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to create a new streaming distribution with tags.

", - "payload":"StreamingDistributionConfigWithTags" - }, - "CreateStreamingDistributionWithTagsResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "Location":{ - "shape":"string", - "documentation":"

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8.

", - "location":"header", - "locationName":"Location" - }, - "ETag":{ - "shape":"string", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "CustomErrorResponse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{ - "shape":"integer", - "documentation":"

The HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - }, - "ResponsePagePath":{ - "shape":"string", - "documentation":"

The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by ErrorCode, for example, /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:

  • The value of PathPattern matches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named /4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example, /4xx-errors/*.

  • The value of TargetOriginId specifies the value of the ID element for the origin that contains your custom error pages.

If you specify a value for ResponsePagePath, you must also specify a value for ResponseCode. If you don't want to specify a value, include an empty element, <ResponsePagePath>, in the XML document.

We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.

" - }, - "ResponseCode":{ - "shape":"string", - "documentation":"

The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example:

  • Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.

  • If you don't care about distinguishing among different client errors or server errors, you can specify 400 or 500 as the ResponseCode for all 4xx or 5xx errors.

  • You might want to return a 200 status code (OK) and static website so your customers don't know that your website is down.

If you specify a value for ResponseCode, you must also specify a value for ResponsePagePath. If you don't want to specify a value, include an empty element, <ResponseCode>, in the XML document.

" - }, - "ErrorCachingMinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available.

If you don't want to specify a value, include an empty element, <ErrorCachingMinTTL>, in the XML document.

For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomErrorResponseList":{ - "type":"list", - "member":{ - "shape":"CustomErrorResponse", - "locationName":"CustomErrorResponse" - } - }, - "CustomErrorResponses":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of HTTP status codes for which you want to specify a custom error page and/or a caching duration. If Quantity is 0, you can omit Items.

" - }, - "Items":{ - "shape":"CustomErrorResponseList", - "documentation":"

A complex type that contains a CustomErrorResponse element for each HTTP status code for which you want to specify a custom error page and/or a caching duration.

" - } - }, - "documentation":"

A complex type that controls:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "CustomHeaders":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of custom headers, if any, for this distribution.

" - }, - "Items":{ - "shape":"OriginCustomHeadersList", - "documentation":"

Optional: A list that contains one OriginCustomHeader element for each custom header that you want CloudFront to forward to the origin. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that contains the list of Custom Headers for each origin.

" - }, - "CustomOriginConfig":{ - "type":"structure", - "required":[ - "HTTPPort", - "HTTPSPort", - "OriginProtocolPolicy" - ], - "members":{ - "HTTPPort":{ - "shape":"integer", - "documentation":"

The HTTP port the custom origin listens on.

" - }, - "HTTPSPort":{ - "shape":"integer", - "documentation":"

The HTTPS port the custom origin listens on.

" - }, - "OriginProtocolPolicy":{ - "shape":"OriginProtocolPolicy", - "documentation":"

The origin protocol policy to apply to your origin.

" - }, - "OriginSslProtocols":{ - "shape":"OriginSslProtocols", - "documentation":"

The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS.

" - }, - "OriginReadTimeout":{ - "shape":"integer", - "documentation":"

You can create a custom origin read timeout. All timeout units are in seconds. The default origin read timeout is 30 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 4 seconds; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

" - }, - "OriginKeepaliveTimeout":{ - "shape":"integer", - "documentation":"

You can create a custom keep-alive timeout. All timeout units are in seconds. The default keep-alive timeout is 5 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 1 second; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

" - } - }, - "documentation":"

A customer origin.

" - }, - "DefaultCacheBehavior":{ - "type":"structure", - "required":[ - "TargetOriginId", - "ForwardedValues", - "TrustedSigners", - "ViewerProtocolPolicy", - "MinTTL" - ], - "members":{ - "TargetOriginId":{ - "shape":"string", - "documentation":"

The value of ID for the origin that you want CloudFront to route requests to when a request matches the path pattern either for a cache behavior or for the default cache behavior.

" - }, - "ForwardedValues":{ - "shape":"ForwardedValues", - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "ViewerProtocolPolicy":{ - "shape":"ViewerProtocolPolicy", - "documentation":"

The protocol that viewers can use to access the files in the origin specified by TargetOriginId when a request matches the path pattern in PathPattern. You can specify the following options:

  • allow-all: Viewers can use HTTP or HTTPS.

  • redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.

  • https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).

For more information about requiring the HTTPS protocol, see Using an HTTPS Connection to Access Your Objects in the Amazon CloudFront Developer Guide.

The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MinTTL":{ - "shape":"long", - "documentation":"

The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon Amazon CloudFront Developer Guide.

You must specify 0 for MinTTL if you configure CloudFront to forward all headers to your origin (under Headers, if you specify 1 for Quantity and * for Name).

" - }, - "AllowedMethods":{"shape":"AllowedMethods"}, - "SmoothStreaming":{ - "shape":"boolean", - "documentation":"

Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specify false. If you specify true for SmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value of PathPattern.

" - }, - "DefaultTTL":{ - "shape":"long", - "documentation":"

The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects. For more information, see Specifying How Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.

" - }, - "MaxTTL":{"shape":"long"}, - "Compress":{ - "shape":"boolean", - "documentation":"

Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.

" - }, - "LambdaFunctionAssociations":{ - "shape":"LambdaFunctionAssociations", - "documentation":"

A complex type that contains zero or more Lambda function associations for a cache behavior.

" - }, - "FieldLevelEncryptionId":{"shape":"string"} - }, - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "DeleteCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The origin access identity's ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header you received from a previous GET or PUT request. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

Deletes a origin access identity.

" - }, - "DeleteDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the following steps.

To delete a web distribution using the CloudFront API:

  1. Disable the web distribution

  2. Submit a GET Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 2.

  5. Review the response to the PUT Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Distribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 6.

  8. Review the response to your DELETE Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" - }, - "DeleteFieldLevelEncryptionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID of the configuration you want to delete from CloudFront.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the configuration identity to delete. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - } - }, - "DeleteFieldLevelEncryptionProfileRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Request the ID of the profile you want to delete from CloudFront.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the profile to delete. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - } - }, - "DeletePublicKeyRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID of the public key you want to remove from CloudFront.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the public key identity to delete. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - } - }, - "DeleteStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution ID.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when you disabled the streaming distribution. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to delete a streaming distribution.

" - }, - "Distribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "InProgressInvalidationBatches", - "DomainName", - "ActiveTrustedSigners", - "DistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "InProgressInvalidationBatches":{ - "shape":"integer", - "documentation":"

The number of invalidation batches currently in progress.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

CloudFront automatically adds this element to the response only if you've set up the distribution to serve private content with signed URLs. The element lists the key pair IDs that CloudFront is aware of for each trusted signer. The Signer child element lists the AWS account number of the trusted signer (or an empty Self element if the signer is you). The Signer element also includes the IDs of any active key pairs associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create working signed URLs.

" - }, - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.

" - } - }, - "documentation":"

The distribution's information.

" - }, - "DistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The caller reference you attempted to create the distribution with is associated with another distribution.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Origins", - "DefaultCacheBehavior", - "Comment", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique value (for example, a date-time stamp) that ensures that the request can't be replayed.

If the value of CallerReference is new (regardless of the content of the DistributionConfig object), CloudFront creates a new distribution.

If CallerReference is a value you already sent in a previous request to create a distribution, and if the content of the DistributionConfig is identical to the original request (ignoring white space), CloudFront returns the same the response that it returned to the original request.

If CallerReference is a value you already sent in a previous request to create a distribution but the content of the DistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "DefaultRootObject":{ - "shape":"string", - "documentation":"

The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/product-description.html). Specifying a default root object avoids exposing the contents of your distribution.

Specify only the object name, for example, index.html. Don't add a / before the object name.

If you don't want to specify a default root object when you create a distribution, include an empty DefaultRootObject element.

To delete the default root object from an existing distribution, update the distribution configuration and include an empty DefaultRootObject element.

To replace the default root object, update the distribution configuration and specify the new object.

For more information about the default root object, see Creating a Default Root Object in the Amazon CloudFront Developer Guide.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that controls the following:

  • Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.

  • How long CloudFront caches HTTP status codes in the 4xx and 5xx range.

For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the distribution.

If you don't want to specify a comment, include an empty Comment element.

To delete an existing comment, update the distribution configuration and include an empty Comment element.

To add or change a comment, update the distribution configuration and specify the new comment.

" - }, - "Logging":{ - "shape":"LoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the distribution.

For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify PriceClass_All, CloudFront responds to requests for your objects from all CloudFront edge locations.

If you specify a price class other than PriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance.

For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes map to CloudFront regions, see Amazon CloudFront Pricing.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

From this field, you can enable or disable the selected distribution.

If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

A unique identifier that specifies the AWS WAF web ACL, if any, to associate with this distribution.

AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about AWS WAF, see the AWS WAF Developer Guide.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

(Optional) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 automatically use an earlier HTTP version.

For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or later, and must support Server Name Identification (SNI).

In general, configuring CloudFront to communicate with viewers using HTTP/2 reduces latency. You can improve performance by optimizing for HTTP/2. For more information, do an Internet search for \"http/2 optimization.\"

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify true. If you specify false, CloudFront responds to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.

In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the IpAddress parameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide.

If you're using an Amazon Route 53 alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:

  • You enable IPv6 for the distribution

  • You're using alternate domain names in the URLs for your objects

For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Amazon Route 53 Developer Guide.

If you created a CNAME resource record set, either with Amazon Route 53 or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request.

" - } - }, - "documentation":"

A distribution configuration.

" - }, - "DistributionConfigWithTags":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Tags" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

A distribution configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A distribution Configuration and a list of tags to be associated with the distribution.

" - }, - "DistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"DistributionSummaryList", - "documentation":"

A complex type that contains one DistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A distribution list.

" - }, - "DistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "DistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "Aliases", - "Origins", - "DefaultCacheBehavior", - "CacheBehaviors", - "CustomErrorResponses", - "Comment", - "PriceClass", - "Enabled", - "ViewerCertificate", - "Restrictions", - "WebACLId", - "HttpVersion", - "IsIPV6Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution. For example: EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

" - }, - "Origins":{ - "shape":"Origins", - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "DefaultCacheBehavior":{ - "shape":"DefaultCacheBehavior", - "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" - }, - "CacheBehaviors":{ - "shape":"CacheBehaviors", - "documentation":"

A complex type that contains zero or more CacheBehavior elements.

" - }, - "CustomErrorResponses":{ - "shape":"CustomErrorResponses", - "documentation":"

A complex type that contains zero or more CustomErrorResponses elements.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept user requests for content.

" - }, - "ViewerCertificate":{"shape":"ViewerCertificate"}, - "Restrictions":{"shape":"Restrictions"}, - "WebACLId":{ - "shape":"string", - "documentation":"

The Web ACL Id (if any) associated with the distribution.

" - }, - "HttpVersion":{ - "shape":"HttpVersion", - "documentation":"

Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

" - }, - "IsIPV6Enabled":{ - "shape":"boolean", - "documentation":"

Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.

" - } - }, - "documentation":"

A summary of the information about a CloudFront distribution.

" - }, - "DistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"DistributionSummary", - "locationName":"DistributionSummary" - } - }, - "EncryptionEntities":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

Number of field pattern items in a field-level encryption content type-profile mapping.

" - }, - "Items":{ - "shape":"EncryptionEntityList", - "documentation":"

An array of field patterns in a field-level encryption content type-profile mapping.

" - } - }, - "documentation":"

Complex data type for field-level encryption profiles that includes all of the encryption entities.

" - }, - "EncryptionEntity":{ - "type":"structure", - "required":[ - "PublicKeyId", - "ProviderId", - "FieldPatterns" - ], - "members":{ - "PublicKeyId":{ - "shape":"string", - "documentation":"

The public key associated with a set of field-level encryption patterns, to be used when encrypting the fields that match the patterns.

" - }, - "ProviderId":{ - "shape":"string", - "documentation":"

The provider associated with the public key being used for encryption. This value must also be provided with the private key for applications to be able to decrypt data.

" - }, - "FieldPatterns":{ - "shape":"FieldPatterns", - "documentation":"

Field patterns in a field-level encryption content type profile specify the fields that you want to be encrypted. You can provide the full field name, or any beginning characters followed by a wildcard (*). You can't overlap field patterns. For example, you can't have both ABC* and AB*. Note that field patterns are case-sensitive.

" - } - }, - "documentation":"

Complex data type for field-level encryption profiles that includes the encryption key and field pattern specifications.

" - }, - "EncryptionEntityList":{ - "type":"list", - "member":{ - "shape":"EncryptionEntity", - "locationName":"EncryptionEntity" - } - }, - "EventType":{ - "type":"string", - "enum":[ - "viewer-request", - "viewer-response", - "origin-request", - "origin-response" - ] - }, - "FieldLevelEncryption":{ - "type":"structure", - "required":[ - "Id", - "LastModifiedTime", - "FieldLevelEncryptionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The configuration ID for a field-level encryption configuration which includes a set of profiles that specify certain selected data fields to be encrypted by specific public keys.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The last time the field-level encryption configuration was changed.

" - }, - "FieldLevelEncryptionConfig":{ - "shape":"FieldLevelEncryptionConfig", - "documentation":"

A complex data type that includes the profile configurations specified for field-level encryption.

" - } - }, - "documentation":"

A complex data type that includes the profile configurations and other options specified for field-level encryption.

" - }, - "FieldLevelEncryptionConfig":{ - "type":"structure", - "required":["CallerReference"], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

An optional comment about the configuration.

" - }, - "QueryArgProfileConfig":{ - "shape":"QueryArgProfileConfig", - "documentation":"

A complex data type that specifies when to forward content if a profile isn't found and the profile that can be provided as a query argument in a request.

" - }, - "ContentTypeProfileConfig":{ - "shape":"ContentTypeProfileConfig", - "documentation":"

A complex data type that specifies when to forward content if a content type isn't recognized and profiles to use as by default in a request if a query argument doesn't specify a profile to use.

" - } - }, - "documentation":"

A complex data type that includes the profile configurations specified for field-level encryption.

" - }, - "FieldLevelEncryptionConfigAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified configuration for field-level encryption already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FieldLevelEncryptionConfigInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified configuration for field-level encryption is in use.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FieldLevelEncryptionList":{ - "type":"structure", - "required":[ - "MaxItems", - "Quantity" - ], - "members":{ - "NextMarker":{ - "shape":"string", - "documentation":"

If there are more elements to be listed, this element is present and contains the value that you can use for the Marker request parameter to continue listing your configurations where you left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of elements you want in the response body.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of field-level encryption items.

" - }, - "Items":{ - "shape":"FieldLevelEncryptionSummaryList", - "documentation":"

An array of field-level encryption items.

" - } - }, - "documentation":"

List of field-level encrpytion configurations.

" - }, - "FieldLevelEncryptionProfile":{ - "type":"structure", - "required":[ - "Id", - "LastModifiedTime", - "FieldLevelEncryptionProfileConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The ID for a field-level encryption profile configuration which includes a set of profiles that specify certain selected data fields to be encrypted by specific public keys.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The last time the field-level encryption profile was updated.

" - }, - "FieldLevelEncryptionProfileConfig":{ - "shape":"FieldLevelEncryptionProfileConfig", - "documentation":"

A complex data type that includes the profile name and the encryption entities for the field-level encryption profile.

" - } - }, - "documentation":"

A complex data type for field-level encryption profiles.

" - }, - "FieldLevelEncryptionProfileAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified profile for field-level encryption already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FieldLevelEncryptionProfileConfig":{ - "type":"structure", - "required":[ - "Name", - "CallerReference", - "EncryptionEntities" - ], - "members":{ - "Name":{ - "shape":"string", - "documentation":"

Profile name for the field-level encryption profile.

" - }, - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

An optional comment for the field-level encryption profile.

" - }, - "EncryptionEntities":{ - "shape":"EncryptionEntities", - "documentation":"

A complex data type of encryption entities for the field-level encryption profile that include the public key ID, provider, and field patterns for specifying which fields to encrypt with this key.

" - } - }, - "documentation":"

A complex data type of profiles for the field-level encryption.

" - }, - "FieldLevelEncryptionProfileInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified profile for field-level encryption is in use.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FieldLevelEncryptionProfileList":{ - "type":"structure", - "required":[ - "MaxItems", - "Quantity" - ], - "members":{ - "NextMarker":{ - "shape":"string", - "documentation":"

If there are more elements to be listed, this element is present and contains the value that you can use for the Marker request parameter to continue listing your profiles where you left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of field-level encryption profiles you want in the response body.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of field-level encryption profiles.

" - }, - "Items":{ - "shape":"FieldLevelEncryptionProfileSummaryList", - "documentation":"

The field-level encryption profile items.

" - } - }, - "documentation":"

List of field-level encryption profiles.

" - }, - "FieldLevelEncryptionProfileSizeExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum size of a profile for field-level encryption was exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "FieldLevelEncryptionProfileSummary":{ - "type":"structure", - "required":[ - "Id", - "LastModifiedTime", - "Name", - "EncryptionEntities" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

ID for the field-level encryption profile summary.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The time when the the field-level encryption profile summary was last updated.

" - }, - "Name":{ - "shape":"string", - "documentation":"

Name for the field-level encryption profile summary.

" - }, - "EncryptionEntities":{ - "shape":"EncryptionEntities", - "documentation":"

A complex data type of encryption entities for the field-level encryption profile that include the public key ID, provider, and field patterns for specifying which fields to encrypt with this key.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

An optional comment for the field-level encryption profile summary.

" - } - }, - "documentation":"

The field-level encryption profile summary.

" - }, - "FieldLevelEncryptionProfileSummaryList":{ - "type":"list", - "member":{ - "shape":"FieldLevelEncryptionProfileSummary", - "locationName":"FieldLevelEncryptionProfileSummary" - } - }, - "FieldLevelEncryptionSummary":{ - "type":"structure", - "required":[ - "Id", - "LastModifiedTime" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The unique ID of a field-level encryption item.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The last time that the summary of field-level encryption items was modified.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

An optional comment about the field-level encryption item.

" - }, - "QueryArgProfileConfig":{ - "shape":"QueryArgProfileConfig", - "documentation":"

A summary of a query argument-profile mapping.

" - }, - "ContentTypeProfileConfig":{ - "shape":"ContentTypeProfileConfig", - "documentation":"

A summary of a content type-profile mapping.

" - } - }, - "documentation":"

A summary of a field-level encryption item.

" - }, - "FieldLevelEncryptionSummaryList":{ - "type":"list", - "member":{ - "shape":"FieldLevelEncryptionSummary", - "locationName":"FieldLevelEncryptionSummary" - } - }, - "FieldPatternList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"FieldPattern" - } - }, - "FieldPatterns":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of field-level encryption field patterns.

" - }, - "Items":{ - "shape":"FieldPatternList", - "documentation":"

An array of the field-level encryption field patterns.

" - } - }, - "documentation":"

A complex data type that includes the field patterns to match for field-level encryption.

" - }, - "Format":{ - "type":"string", - "enum":["URLEncoded"] - }, - "ForwardedValues":{ - "type":"structure", - "required":[ - "QueryString", - "Cookies" - ], - "members":{ - "QueryString":{ - "shape":"boolean", - "documentation":"

Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryString and on the values that you specify for QueryStringCacheKeys, if any:

If you specify true for QueryString and you don't specify any values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin.

If you specify true for QueryString and you specify one or more values for QueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify.

If you specify false for QueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters.

For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.

" - }, - "Cookies":{ - "shape":"CookiePreference", - "documentation":"

A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.

" - }, - "Headers":{ - "shape":"Headers", - "documentation":"

A complex type that specifies the Headers, if any, that you want CloudFront to base caching on for this cache behavior.

" - }, - "QueryStringCacheKeys":{ - "shape":"QueryStringCacheKeys", - "documentation":"

A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.

" - } - }, - "documentation":"

A complex type that specifies how CloudFront handles query strings and cookies.

" - }, - "GeoRestriction":{ - "type":"structure", - "required":[ - "RestrictionType", - "Quantity" - ], - "members":{ - "RestrictionType":{ - "shape":"GeoRestrictionType", - "documentation":"

The method that you want to use to restrict distribution of your content by country:

  • none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.

  • blacklist: The Location elements specify the countries in which you don't want CloudFront to distribute your content.

  • whitelist: The Location elements specify the countries in which you want CloudFront to distribute your content.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

When geo restriction is enabled, this is the number of countries in your whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, and you can omit Items.

" - }, - "Items":{ - "shape":"LocationList", - "documentation":"

A complex type that contains a Location element for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist).

The Location element is a two-letter, uppercase country code for a country that you want to include in your blacklist or whitelist. Include one Location element for each country.

CloudFront and MaxMind both use ISO 3166 country codes. For the current list of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.

" - } - }, - "documentation":"

A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using MaxMind GeoIP databases.

" - }, - "GeoRestrictionType":{ - "type":"string", - "enum":[ - "blacklist", - "whitelist", - "none" - ] - }, - "GetCloudFrontOriginAccessIdentityConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType.

" - }, - "GetCloudFrontOriginAccessIdentityConfigResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The origin access identity's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "GetCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identity's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an origin access identity's information.

" - }, - "GetCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "GetDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution configuration.

" - }, - "GetDistributionConfigResult":{ - "type":"structure", - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionConfig" - }, - "GetDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a distribution's information.

" - }, - "GetDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "GetFieldLevelEncryptionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Request the ID for the field-level encryption configuration information.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetFieldLevelEncryptionConfigResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionConfig":{ - "shape":"FieldLevelEncryptionConfig", - "documentation":"

Return the field-level encryption configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field level encryption configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryptionConfig" - }, - "GetFieldLevelEncryptionProfileConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Get the ID for the field-level encryption profile configuration information.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetFieldLevelEncryptionProfileConfigResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionProfileConfig":{ - "shape":"FieldLevelEncryptionProfileConfig", - "documentation":"

Return the field-level encryption profile configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field-level encryption profile configuration result. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryptionProfileConfig" - }, - "GetFieldLevelEncryptionProfileRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Get the ID for the field-level encryption profile information.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetFieldLevelEncryptionProfileResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionProfile":{ - "shape":"FieldLevelEncryptionProfile", - "documentation":"

Return the field-level encryption profile information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field level encryption profile. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryptionProfile" - }, - "GetFieldLevelEncryptionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Request the ID for the field-level encryption configuration information.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetFieldLevelEncryptionResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryption":{ - "shape":"FieldLevelEncryption", - "documentation":"

Return the field-level encryption configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the field level encryption configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryption" - }, - "GetInvalidationRequest":{ - "type":"structure", - "required":[ - "DistributionId", - "Id" - ], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request, for example, IDFDVBD632BHDS5.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get an invalidation's information.

" - }, - "GetInvalidationResult":{ - "type":"structure", - "members":{ - "Invalidation":{ - "shape":"Invalidation", - "documentation":"

The invalidation's information. For more information, see Invalidation Complex Type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Invalidation" - }, - "GetPublicKeyConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Request the ID for the public key configuration.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetPublicKeyConfigResult":{ - "type":"structure", - "members":{ - "PublicKeyConfig":{ - "shape":"PublicKeyConfig", - "documentation":"

Return the result for the public key configuration.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the public key configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"PublicKeyConfig" - }, - "GetPublicKeyRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

Request the ID for the public key.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetPublicKeyResult":{ - "type":"structure", - "members":{ - "PublicKey":{ - "shape":"PublicKey", - "documentation":"

Return the public key.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the public key. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"PublicKey" - }, - "GetStreamingDistributionConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

To request to get a streaming distribution configuration.

" - }, - "GetStreamingDistributionConfigResult":{ - "type":"structure", - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionConfig" - }, - "GetStreamingDistributionRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's ID.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The request to get a streaming distribution's information.

" - }, - "GetStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "HeaderList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "Headers":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of different headers that you want CloudFront to base caching on for this cache behavior. You can configure each cache behavior in a web distribution to do one of the following:

  • Forward all headers to your origin: Specify 1 for Quantity and * for Name.

    CloudFront doesn't cache the objects that are associated with this cache behavior. Instead, CloudFront sends every request to the origin.

  • Forward a whitelist of headers you specify: Specify the number of headers that you want CloudFront to base caching on. Then specify the header names in Name elements. CloudFront caches your objects based on the values in the specified headers.

  • Forward only the default headers: Specify 0 for Quantity and omit Items. In this configuration, CloudFront doesn't cache based on the values in the request headers.

Regardless of which option you choose, CloudFront forwards headers to your origin based on whether the origin is an S3 bucket or a custom origin. See the following documentation:

" - }, - "Items":{ - "shape":"HeaderList", - "documentation":"

A list that contains one Name element for each header that you want CloudFront to use for caching in this cache behavior. If Quantity is 0, omit Items.

" - } - }, - "documentation":"

A complex type that specifies the request headers, if any, that you want CloudFront to base caching on for this cache behavior.

For the headers that you specify, CloudFront caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for logo.jpg contain a custom product header that has a value of either acme or apex, and you configure CloudFront to cache your content based on values in the product header. CloudFront forwards the product header to the origin and caches the response from the origin once for each header value. For more information about caching based on header values, see How CloudFront Forwards and Caches Headers in the Amazon CloudFront Developer Guide.

" - }, - "HttpVersion":{ - "type":"string", - "enum":[ - "http1.1", - "http2" - ] - }, - "IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified configuration for field-level encryption can't be associated with the specified cache behavior.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "IllegalUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Origin and CallerReference cannot be updated.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InconsistentQuantities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The value of Quantity and the size of Items don't match.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The argument is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDefaultRootObject":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The default root object file name is too big or contains an invalid character.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidErrorCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidForwardCookies":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidGeoRestrictionParameter":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidHeadersForS3Origin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidIfMatchVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The If-Match version is missing or not valid for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLambdaFunctionAssociation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified Lambda function association is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidLocationCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidMinimumProtocolVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The origin access identity is not valid or doesn't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginKeepaliveTimeout":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOriginReadTimeout":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidProtocolSettings":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRelativePath":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequiredProtocol":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseCode":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTTLOrder":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTagging":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidViewerCertificate":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidWebACLId":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "Invalidation":{ - "type":"structure", - "required":[ - "Id", - "Status", - "CreateTime", - "InvalidationBatch" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the invalidation request. For example: IDFDVBD632BHDS5.

" - }, - "Status":{ - "shape":"string", - "documentation":"

The status of the invalidation request. When the invalidation batch is finished, the status is Completed.

" - }, - "CreateTime":{ - "shape":"timestamp", - "documentation":"

The date and time the invalidation request was first made.

" - }, - "InvalidationBatch":{ - "shape":"InvalidationBatch", - "documentation":"

The current invalidation information for the batch request.

" - } - }, - "documentation":"

An invalidation.

" - }, - "InvalidationBatch":{ - "type":"structure", - "required":[ - "Paths", - "CallerReference" - ], - "members":{ - "Paths":{ - "shape":"Paths", - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "CallerReference":{ - "shape":"string", - "documentation":"

A value that you specify to uniquely identify an invalidation request. CloudFront uses the value to prevent you from accidentally resubmitting an identical request. Whenever you create a new invalidation request, you must specify a new value for CallerReference and change other values in the request as applicable. One way to ensure that the value of CallerReference is unique is to use a timestamp, for example, 20120301090000.

If you make a second invalidation request with the same value for CallerReference, and if the rest of the request is the same, CloudFront doesn't create a new invalidation request. Instead, CloudFront returns information about the invalidation request that you previously created with the same CallerReference.

If CallerReference is a value you already sent in a previous invalidation batch request but the content of any Path is different from the original request, CloudFront returns an InvalidationBatchAlreadyExists error.

" - } - }, - "documentation":"

An invalidation batch.

" - }, - "InvalidationList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value that you can use for the Marker request parameter to continue listing your invalidation batches where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value that you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more invalidation batches in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of invalidation batches that were created by the current AWS account.

" - }, - "Items":{ - "shape":"InvalidationSummaryList", - "documentation":"

A complex type that contains one InvalidationSummary element for each invalidation batch created by the current AWS account.

" - } - }, - "documentation":"

The InvalidationList complex type describes the list of invalidation objects. For more information about invalidation, see Invalidating Objects (Web Distributions Only) in the Amazon CloudFront Developer Guide.

" - }, - "InvalidationSummary":{ - "type":"structure", - "required":[ - "Id", - "CreateTime", - "Status" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The unique ID for an invalidation request.

" - }, - "CreateTime":{"shape":"timestamp"}, - "Status":{ - "shape":"string", - "documentation":"

The status of an invalidation request.

" - } - }, - "documentation":"

A summary of an invalidation request.

" - }, - "InvalidationSummaryList":{ - "type":"list", - "member":{ - "shape":"InvalidationSummary", - "locationName":"InvalidationSummary" - } - }, - "ItemSelection":{ - "type":"string", - "enum":[ - "none", - "whitelist", - "all" - ] - }, - "KeyPairIdList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"KeyPairId" - } - }, - "KeyPairIds":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of active CloudFront key pairs for AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "Items":{ - "shape":"KeyPairIdList", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - } - }, - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

For more information, see ActiveTrustedSigners.

" - }, - "LambdaFunctionARN":{"type":"string"}, - "LambdaFunctionAssociation":{ - "type":"structure", - "required":[ - "LambdaFunctionARN", - "EventType" - ], - "members":{ - "LambdaFunctionARN":{ - "shape":"LambdaFunctionARN", - "documentation":"

The ARN of the Lambda function. You must specify the ARN of a function version; you can't specify a Lambda alias or $LATEST.

" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

Specifies the event type that triggers a Lambda function invocation. You can specify the following values:

  • viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.

  • origin-request: The function executes only when CloudFront forwards a request to your origin. When the requested object is in the edge cache, the function doesn't execute.

  • origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.

    If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.

  • viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache.

    If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.

" - } - }, - "documentation":"

A complex type that contains a Lambda function association.

" - }, - "LambdaFunctionAssociationList":{ - "type":"list", - "member":{ - "shape":"LambdaFunctionAssociation", - "locationName":"LambdaFunctionAssociation" - } - }, - "LambdaFunctionAssociations":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of Lambda function associations for this cache behavior.

" - }, - "Items":{ - "shape":"LambdaFunctionAssociationList", - "documentation":"

Optional: A complex type that contains LambdaFunctionAssociation items for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies a list of Lambda functions associations for a cache behavior.

If you want to invoke one or more Lambda functions triggered by requests that match the PathPattern of the cache behavior, specify the applicable values for Quantity and Items. Note that there can be up to 4 LambdaFunctionAssociation items in this list (one for each possible value of EventType) and each EventType can be associated with the Lambda function only once.

If you don't want to invoke any Lambda functions for the requests that match PathPattern, specify 0 for Quantity and omit Items.

" - }, - "ListCloudFrontOriginAccessIdentitiesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of origin access identities. The results include identities in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last identity on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of origin access identities you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list origin access identities.

" - }, - "ListCloudFrontOriginAccessIdentitiesResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentityList":{ - "shape":"CloudFrontOriginAccessIdentityList", - "documentation":"

The CloudFrontOriginAccessIdentityList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentityList" - }, - "ListDistributionsByWebACLIdRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "WebACLId":{ - "shape":"string", - "documentation":"

The ID of the AWS WAF web ACL that you want to list the associated distributions. If you specify \"null\" for the ID, the request returns a list of the distributions that aren't associated with a web ACL.

", - "location":"uri", - "locationName":"WebACLId" - } - }, - "documentation":"

The request to list distributions that are associated with a specified AWS WAF web ACL.

" - }, - "ListDistributionsByWebACLIdResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.

", - "payload":"DistributionList" - }, - "ListDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of distributions. The results include distributions in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last distribution on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of distributions you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your distributions.

" - }, - "ListDistributionsResult":{ - "type":"structure", - "members":{ - "DistributionList":{ - "shape":"DistributionList", - "documentation":"

The DistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"DistributionList" - }, - "ListFieldLevelEncryptionConfigsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of configurations. The results include configurations in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last configuration on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of field-level encryption configurations you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - } - }, - "ListFieldLevelEncryptionConfigsResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionList":{ - "shape":"FieldLevelEncryptionList", - "documentation":"

Returns a list of all field-level encryption configurations that have been created in CloudFront for this account.

" - } - }, - "payload":"FieldLevelEncryptionList" - }, - "ListFieldLevelEncryptionProfilesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of profiles. The results include profiles in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last profile on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of field-level encryption profiles you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - } - }, - "ListFieldLevelEncryptionProfilesResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionProfileList":{ - "shape":"FieldLevelEncryptionProfileList", - "documentation":"

Returns a list of the field-level encryption profiles that have been created in CloudFront for this account.

" - } - }, - "payload":"FieldLevelEncryptionProfileList" - }, - "ListInvalidationsRequest":{ - "type":"structure", - "required":["DistributionId"], - "members":{ - "DistributionId":{ - "shape":"string", - "documentation":"

The distribution's ID.

", - "location":"uri", - "locationName":"DistributionId" - }, - "Marker":{ - "shape":"string", - "documentation":"

Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set Marker to the value of the NextMarker from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of invalidation batches that you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list invalidations.

" - }, - "ListInvalidationsResult":{ - "type":"structure", - "members":{ - "InvalidationList":{ - "shape":"InvalidationList", - "documentation":"

Information about invalidation batches.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"InvalidationList" - }, - "ListPublicKeysRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

Use this when paginating results to indicate where to begin in your list of public keys. The results include public keys in the list that occur after the marker. To get the next page of results, set the Marker to the value of the NextMarker from the current page's response (which is also the ID of the last public key on that page).

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The maximum number of public keys you want in the response body.

", - "location":"querystring", - "locationName":"MaxItems" - } - } - }, - "ListPublicKeysResult":{ - "type":"structure", - "members":{ - "PublicKeyList":{ - "shape":"PublicKeyList", - "documentation":"

Returns a list of all public keys that have been added to CloudFront for this account.

" - } - }, - "payload":"PublicKeyList" - }, - "ListStreamingDistributionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value that you provided for the Marker request parameter.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"string", - "documentation":"

The value that you provided for the MaxItems request parameter.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

The request to list your streaming distributions.

" - }, - "ListStreamingDistributionsResult":{ - "type":"structure", - "members":{ - "StreamingDistributionList":{ - "shape":"StreamingDistributionList", - "documentation":"

The StreamingDistributionList type.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistributionList" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - } - }, - "documentation":"

The request to list tags for a CloudFront resource.

" - }, - "ListTagsForResourceResult":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Tags" - }, - "LocationList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Location" - } - }, - "LoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, the values are automatically deleted.

" - }, - "IncludeCookies":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for the distribution.

" - }, - "Method":{ - "type":"string", - "enum":[ - "GET", - "HEAD", - "POST", - "PUT", - "PATCH", - "OPTIONS", - "DELETE" - ] - }, - "MethodsList":{ - "type":"list", - "member":{ - "shape":"Method", - "locationName":"Method" - } - }, - "MinimumProtocolVersion":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1_2016", - "TLSv1.1_2016", - "TLSv1.2_2018" - ] - }, - "MissingBody":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

This operation requires a body. Ensure that the body is present and the Content-Type header is set.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoSuchCloudFrontOriginAccessIdentity":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified origin access identity does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchFieldLevelEncryptionConfig":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified configuration for field-level encryption doesn't exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchFieldLevelEncryptionProfile":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified profile for field-level encryption doesn't exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchInvalidation":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified invalidation does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchOrigin":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

No origin exists with the specified Origin Id.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchPublicKey":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified public key doesn't exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchResource":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchStreamingDistribution":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified streaming distribution does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Origin":{ - "type":"structure", - "required":[ - "Id", - "DomainName" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

A unique identifier for the origin. The value of Id must be unique within the distribution.

When you specify the value of TargetOriginId for the default cache behavior or for another cache behavior, you indicate the origin to which you want the cache behavior to route requests by specifying the value of the Id element for that origin. When a request matches the path pattern for that cache behavior, CloudFront routes the request to the specified origin. For more information, see Cache Behavior Settings in the Amazon CloudFront Developer Guide.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com.

Constraints for Amazon S3 origins:

  • If you configured Amazon S3 Transfer Acceleration for your bucket, don't specify the s3-accelerate endpoint for DomainName.

  • The bucket name must be between 3 and 63 characters long (inclusive).

  • The bucket name must contain only lowercase characters, numbers, periods, underscores, and dashes.

  • The bucket name must not contain adjacent periods.

Custom Origins: The DNS domain name for the HTTP server from which you want CloudFront to get objects for this origin, for example, www.example.com.

Constraints for custom origins:

  • DomainName must be a valid DNS name that contains only a-z, A-Z, 0-9, dot (.), hyphen (-), or underscore (_) characters.

  • The name cannot exceed 128 characters.

" - }, - "OriginPath":{ - "shape":"string", - "documentation":"

An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin. When you include the OriginPath element, specify the directory name, beginning with a /. CloudFront appends the directory name to the value of DomainName, for example, example.com/production. Do not include a / at the end of the directory name.

For example, suppose you've specified the following values for your distribution:

  • DomainName: An Amazon S3 bucket named myawsbucket.

  • OriginPath: /production

  • CNAME: example.com

When a user enters example.com/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/index.html.

When a user enters example.com/acme/index.html in a browser, CloudFront sends a request to Amazon S3 for myawsbucket/production/acme/index.html.

" - }, - "CustomHeaders":{ - "shape":"CustomHeaders", - "documentation":"

A complex type that contains names and values for the custom headers that you want.

" - }, - "S3OriginConfig":{ - "shape":"S3OriginConfig", - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "CustomOriginConfig":{ - "shape":"CustomOriginConfig", - "documentation":"

A complex type that contains information about a custom origin. If the origin is an Amazon S3 bucket, use the S3OriginConfig element instead.

" - } - }, - "documentation":"

A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files. You must create at least one origin.

For the current limit on the number of origins that you can create for a distribution, see Amazon CloudFront Limits in the AWS General Reference.

" - }, - "OriginCustomHeader":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"string", - "documentation":"

The name of a header that you want CloudFront to forward to your origin. For more information, see Forwarding Custom Headers to Your Origin (Web Distributions Only) in the Amazon Amazon CloudFront Developer Guide.

" - }, - "HeaderValue":{ - "shape":"string", - "documentation":"

The value for the header that you specified in the HeaderName field.

" - } - }, - "documentation":"

A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.

" - }, - "OriginCustomHeadersList":{ - "type":"list", - "member":{ - "shape":"OriginCustomHeader", - "locationName":"OriginCustomHeader" - } - }, - "OriginList":{ - "type":"list", - "member":{ - "shape":"Origin", - "locationName":"Origin" - }, - "min":1 - }, - "OriginProtocolPolicy":{ - "type":"string", - "enum":[ - "http-only", - "match-viewer", - "https-only" - ] - }, - "OriginSslProtocols":{ - "type":"structure", - "required":[ - "Quantity", - "Items" - ], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of SSL/TLS protocols that you want to allow CloudFront to use when establishing an HTTPS connection with this origin.

" - }, - "Items":{ - "shape":"SslProtocolsList", - "documentation":"

A list that contains allowed SSL/TLS protocols for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin.

" - }, - "Origins":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of origins for this distribution.

" - }, - "Items":{ - "shape":"OriginList", - "documentation":"

A complex type that contains origins for this distribution.

" - } - }, - "documentation":"

A complex type that contains information about origins for this distribution.

" - }, - "PathList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Path" - } - }, - "Paths":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of objects that you want to invalidate.

" - }, - "Items":{ - "shape":"PathList", - "documentation":"

A complex type that contains a list of the paths that you want to invalidate.

" - } - }, - "documentation":"

A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide.

" - }, - "PreconditionFailed":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The precondition given in one or more of the request-header fields evaluated to false.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "PriceClass":{ - "type":"string", - "enum":[ - "PriceClass_100", - "PriceClass_200", - "PriceClass_All" - ] - }, - "PublicKey":{ - "type":"structure", - "required":[ - "Id", - "CreatedTime", - "PublicKeyConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

A unique ID assigned to a public key you've added to CloudFront.

" - }, - "CreatedTime":{ - "shape":"timestamp", - "documentation":"

A time you added a public key to CloudFront.

" - }, - "PublicKeyConfig":{ - "shape":"PublicKeyConfig", - "documentation":"

A complex data type for a public key you add to CloudFront to use with features like field-level encryption.

" - } - }, - "documentation":"

A complex data type of public keys you add to CloudFront to use with features like field-level encryption.

" - }, - "PublicKeyAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified public key already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "PublicKeyConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "Name", - "EncodedKey" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures the request can't be replayed.

" - }, - "Name":{ - "shape":"string", - "documentation":"

The name for a public key you add to CloudFront to use with features like field-level encryption.

" - }, - "EncodedKey":{ - "shape":"string", - "documentation":"

The encoded public key that you want to add to CloudFront to use with features like field-level encryption.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

An optional comment about a public key.

" - } - }, - "documentation":"

Information about a public key you add to CloudFront to use with features like field-level encryption.

" - }, - "PublicKeyInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The specified public key is in use.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "PublicKeyList":{ - "type":"structure", - "required":[ - "MaxItems", - "Quantity" - ], - "members":{ - "NextMarker":{ - "shape":"string", - "documentation":"

If there are more elements to be listed, this element is present and contains the value that you can use for the Marker request parameter to continue listing your public keys where you left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The maximum number of public keys you want in the response body.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of public keys you added to CloudFront to use with features like field-level encryption.

" - }, - "Items":{ - "shape":"PublicKeySummaryList", - "documentation":"

An array of information about a public key you add to CloudFront to use with features like field-level encryption.

" - } - }, - "documentation":"

A list of public keys you've added to CloudFront to use with features like field-level encryption.

" - }, - "PublicKeySummary":{ - "type":"structure", - "required":[ - "Id", - "Name", - "CreatedTime", - "EncodedKey" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

ID for public key information summary.

" - }, - "Name":{ - "shape":"string", - "documentation":"

Name for public key information summary.

" - }, - "CreatedTime":{ - "shape":"timestamp", - "documentation":"

Creation time for public key information summary.

" - }, - "EncodedKey":{ - "shape":"string", - "documentation":"

Encoded key for public key information summary.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Comment for public key information summary.

" - } - }, - "documentation":"

Public key information summary.

" - }, - "PublicKeySummaryList":{ - "type":"list", - "member":{ - "shape":"PublicKeySummary", - "locationName":"PublicKeySummary" - } - }, - "QueryArgProfile":{ - "type":"structure", - "required":[ - "QueryArg", - "ProfileId" - ], - "members":{ - "QueryArg":{ - "shape":"string", - "documentation":"

Query argument for field-level encryption query argument-profile mapping.

" - }, - "ProfileId":{ - "shape":"string", - "documentation":"

ID of profile to use for field-level encryption query argument-profile mapping

" - } - }, - "documentation":"

Query argument-profile mapping for field-level encryption.

" - }, - "QueryArgProfileConfig":{ - "type":"structure", - "required":["ForwardWhenQueryArgProfileIsUnknown"], - "members":{ - "ForwardWhenQueryArgProfileIsUnknown":{ - "shape":"boolean", - "documentation":"

Flag to set if you want a request to be forwarded to the origin even if the profile specified by the field-level encryption query argument, fle-profile, is unknown.

" - }, - "QueryArgProfiles":{ - "shape":"QueryArgProfiles", - "documentation":"

Profiles specified for query argument-profile mapping for field-level encryption.

" - } - }, - "documentation":"

Configuration for query argument-profile mapping for field-level encryption.

" - }, - "QueryArgProfileEmpty":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

No profile specified for the field-level encryption query argument.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "QueryArgProfileList":{ - "type":"list", - "member":{ - "shape":"QueryArgProfile", - "locationName":"QueryArgProfile" - } - }, - "QueryArgProfiles":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

Number of profiles for query argument-profile mapping for field-level encryption.

" - }, - "Items":{ - "shape":"QueryArgProfileList", - "documentation":"

Number of items for query argument-profile mapping for field-level encryption.

" - } - }, - "documentation":"

Query argument-profile mapping for field-level encryption.

" - }, - "QueryStringCacheKeys":{ - "type":"structure", - "required":["Quantity"], - "members":{ - "Quantity":{ - "shape":"integer", - "documentation":"

The number of whitelisted query string parameters for this cache behavior.

" - }, - "Items":{ - "shape":"QueryStringCacheKeysList", - "documentation":"

(Optional) A list that contains the query string parameters that you want CloudFront to use as a basis for caching for this cache behavior. If Quantity is 0, you can omit Items.

" - } - } - }, - "QueryStringCacheKeysList":{ - "type":"list", - "member":{ - "shape":"string", - "locationName":"Name" - } - }, - "ResourceARN":{ - "type":"string", - "pattern":"arn:aws:cloudfront::[0-9]+:.*" - }, - "Restrictions":{ - "type":"structure", - "required":["GeoRestriction"], - "members":{ - "GeoRestriction":{"shape":"GeoRestriction"} - }, - "documentation":"

A complex type that identifies ways in which you want to restrict distribution of your content.

" - }, - "S3Origin":{ - "type":"structure", - "required":[ - "DomainName", - "OriginAccessIdentity" - ], - "members":{ - "DomainName":{ - "shape":"string", - "documentation":"

The DNS name of the Amazon S3 origin.

" - }, - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the RTMP distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an Amazon S3 bucket through CloudFront.

If you want end users to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content in the Amazon Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "S3OriginConfig":{ - "type":"structure", - "required":["OriginAccessIdentity"], - "members":{ - "OriginAccessIdentity":{ - "shape":"string", - "documentation":"

The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:

origin-access-identity/cloudfront/ID-of-origin-access-identity

where ID-of-origin-access-identity is the value that CloudFront returned in the ID element when you created the origin access identity.

If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element.

To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty OriginAccessIdentity element.

To replace the origin access identity, update the distribution configuration and specify the new origin access identity.

For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - } - }, - "documentation":"

A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.

" - }, - "SSLSupportMethod":{ - "type":"string", - "enum":[ - "sni-only", - "vip" - ] - }, - "Signer":{ - "type":"structure", - "members":{ - "AwsAccountNumber":{ - "shape":"string", - "documentation":"

An AWS account that is included in the TrustedSigners complex type for this RTMP distribution. Valid values include:

  • self, which is the AWS account used to create the distribution.

  • An AWS account number.

" - }, - "KeyPairIds":{ - "shape":"KeyPairIds", - "documentation":"

A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.

" - } - }, - "documentation":"

A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any.

" - }, - "SignerList":{ - "type":"list", - "member":{ - "shape":"Signer", - "locationName":"Signer" - } - }, - "SslProtocol":{ - "type":"string", - "enum":[ - "SSLv3", - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - }, - "SslProtocolsList":{ - "type":"list", - "member":{ - "shape":"SslProtocol", - "locationName":"SslProtocol" - } - }, - "StreamingDistribution":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "DomainName", - "ActiveTrustedSigners", - "StreamingDistributionConfig" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the RTMP distribution. For example: EGTXBD79EXAMPLE.

" - }, - "ARN":{"shape":"string"}, - "Status":{ - "shape":"string", - "documentation":"

The current status of the RTMP distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name that corresponds to the streaming distribution, for example, s5c39gqb8ow64r.cloudfront.net.

" - }, - "ActiveTrustedSigners":{ - "shape":"ActiveTrustedSigners", - "documentation":"

A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.

The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.

For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The current configuration information for the RTMP distribution.

" - } - }, - "documentation":"

A streaming distribution.

" - }, - "StreamingDistributionAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionConfig":{ - "type":"structure", - "required":[ - "CallerReference", - "S3Origin", - "Comment", - "TrustedSigners", - "Enabled" - ], - "members":{ - "CallerReference":{ - "shape":"string", - "documentation":"

A unique number that ensures that the request can't be replayed. If the CallerReference is new (no matter the content of the StreamingDistributionConfig object), a new streaming distribution is created. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution, and the content of the StreamingDistributionConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request. If the CallerReference is a value that you already sent in a previous request to create a streaming distribution but the content of the StreamingDistributionConfig is different from the original request, CloudFront returns a DistributionAlreadyExists error.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

Any comments you want to include about the streaming distribution.

" - }, - "Logging":{ - "shape":"StreamingLoggingConfig", - "documentation":"

A complex type that controls whether access logs are written for the streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies any AWS accounts that you want to permit to create signed URLs for private content. If you want the distribution to use signed URLs, include this element; if you want the distribution to use public URLs, remove this element. For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "PriceClass":{ - "shape":"PriceClass", - "documentation":"

A complex type that contains information about price class for this streaming distribution.

" - }, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the streaming distribution is enabled to accept user requests for content.

" - } - }, - "documentation":"

The RTMP distribution's configuration information.

" - }, - "StreamingDistributionConfigWithTags":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Tags" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

A streaming distribution Configuration.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

" - } - }, - "documentation":"

A streaming distribution Configuration and a list of tags to be associated with the streaming distribution.

" - }, - "StreamingDistributionList":{ - "type":"structure", - "required":[ - "Marker", - "MaxItems", - "IsTruncated", - "Quantity" - ], - "members":{ - "Marker":{ - "shape":"string", - "documentation":"

The value you provided for the Marker request parameter.

" - }, - "NextMarker":{ - "shape":"string", - "documentation":"

If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your RTMP distributions where they left off.

" - }, - "MaxItems":{ - "shape":"integer", - "documentation":"

The value you provided for the MaxItems request parameter.

" - }, - "IsTruncated":{ - "shape":"boolean", - "documentation":"

A flag that indicates whether more streaming distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of streaming distributions that were created by the current AWS account.

" - }, - "Items":{ - "shape":"StreamingDistributionSummaryList", - "documentation":"

A complex type that contains one StreamingDistributionSummary element for each distribution that was created by the current AWS account.

" - } - }, - "documentation":"

A streaming distribution list.

" - }, - "StreamingDistributionNotDisabled":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":409}, - "exception":true - }, - "StreamingDistributionSummary":{ - "type":"structure", - "required":[ - "Id", - "ARN", - "Status", - "LastModifiedTime", - "DomainName", - "S3Origin", - "Aliases", - "TrustedSigners", - "Comment", - "PriceClass", - "Enabled" - ], - "members":{ - "Id":{ - "shape":"string", - "documentation":"

The identifier for the distribution, for example, EDFDVBD632BHDS5.

" - }, - "ARN":{ - "shape":"string", - "documentation":"

The ARN (Amazon Resource Name) for the streaming distribution. For example: arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, where 123456789012 is your AWS account ID.

" - }, - "Status":{ - "shape":"string", - "documentation":"

Indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated throughout the Amazon CloudFront system.

" - }, - "LastModifiedTime":{ - "shape":"timestamp", - "documentation":"

The date and time the distribution was last modified.

" - }, - "DomainName":{ - "shape":"string", - "documentation":"

The domain name corresponding to the distribution, for example, d111111abcdef8.cloudfront.net.

" - }, - "S3Origin":{ - "shape":"S3Origin", - "documentation":"

A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.

" - }, - "Aliases":{ - "shape":"Aliases", - "documentation":"

A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.

" - }, - "TrustedSigners":{ - "shape":"TrustedSigners", - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items.If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

" - }, - "Comment":{ - "shape":"string", - "documentation":"

The comment originally specified when this distribution was created.

" - }, - "PriceClass":{"shape":"PriceClass"}, - "Enabled":{ - "shape":"boolean", - "documentation":"

Whether the distribution is enabled to accept end user requests for content.

" - } - }, - "documentation":"

A summary of the information for an Amazon CloudFront streaming distribution.

" - }, - "StreamingDistributionSummaryList":{ - "type":"list", - "member":{ - "shape":"StreamingDistributionSummary", - "locationName":"StreamingDistributionSummary" - } - }, - "StreamingLoggingConfig":{ - "type":"structure", - "required":[ - "Enabled", - "Bucket", - "Prefix" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and Prefix, the values are automatically deleted.

" - }, - "Bucket":{ - "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" - } - }, - "documentation":"

A complex type that controls whether access logs are written for this streaming distribution.

" - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

A string that contains an optional Tag value.

The string length should be between 0 and 256 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

" - } - }, - "documentation":"

A complex type that contains Tag key and Tag value.

" - }, - "TagKey":{ - "type":"string", - "documentation":"

A string that contains Tag key.

The string length should be between 1 and 128 characters. Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.

", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - } - }, - "TagKeys":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagKeyList", - "documentation":"

A complex type that contains Tag key elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A complex type that contains zero or more Tag elements.

", - "locationName":"Tags", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to add tags to a CloudFront resource.

", - "payload":"Tags" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"TagList", - "documentation":"

A complex type that contains Tag elements.

" - } - }, - "documentation":"

A complex type that contains zero or more Tag elements.

" - }, - "TooManyCacheBehaviors":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more cache behaviors for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCertificates":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create anymore custom SSL/TLS certificates.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCloudFrontOriginAccessIdentities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of origin access identities allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyCookieNamesInWhiteList":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more cookie names in the whitelist than are allowed per cache behavior.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more CNAMEs than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionsAssociatedToFieldLevelEncryptionConfig":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of distributions have been associated with the specified configuration for field-level encryption.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyDistributionsWithLambdaAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionConfigs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of configurations for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionContentTypeProfiles":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of content type profiles for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionEncryptionEntities":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of encryption entities for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionFieldPatterns":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of field patterns for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionProfiles":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of profiles for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyFieldLevelEncryptionQueryArgProfiles":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of query arg profiles for field-level encryption have been created.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyHeadersInForwardedValues":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyInvalidationsInProgress":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyLambdaFunctionAssociations":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more Lambda function associations than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOriginCustomHeaders":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyOrigins":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

You cannot create more origins for the distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyPublicKeys":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

The maximum number of public keys for field-level encryption have been created. To create a new public key, delete one of the existing keys.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyQueryStringParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributionCNAMEs":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyStreamingDistributions":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrustedSigners":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

Your request contains more trusted signers than are allowed per distribution.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSignerDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"string"} - }, - "documentation":"

One or more of your trusted signers don't exist.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrustedSigners":{ - "type":"structure", - "required":[ - "Enabled", - "Quantity" - ], - "members":{ - "Enabled":{ - "shape":"boolean", - "documentation":"

Specifies whether you want to require viewers to use signed URLs to access the files specified by PathPattern and TargetOriginId.

" - }, - "Quantity":{ - "shape":"integer", - "documentation":"

The number of trusted signers for this cache behavior.

" - }, - "Items":{ - "shape":"AwsAccountNumberList", - "documentation":"

Optional: A complex type that contains trusted signers for this cache behavior. If Quantity is 0, you can omit Items.

" - } - }, - "documentation":"

A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content.

If you want to require signed URLs in requests for objects in the target origin that match the PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront in the Amazon Amazon CloudFront Developer Guide.

If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.

To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.

For more information about updating the distribution configuration, see DistributionConfig .

" - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"ResourceARN", - "documentation":"

An ARN of a CloudFront resource.

", - "location":"querystring", - "locationName":"Resource" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

A complex type that contains zero or more Tag key elements.

", - "locationName":"TagKeys", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - } - }, - "documentation":"

The request to remove tags from a CloudFront resource.

", - "payload":"TagKeys" - }, - "UpdateCloudFrontOriginAccessIdentityRequest":{ - "type":"structure", - "required":[ - "CloudFrontOriginAccessIdentityConfig", - "Id" - ], - "members":{ - "CloudFrontOriginAccessIdentityConfig":{ - "shape":"CloudFrontOriginAccessIdentityConfig", - "documentation":"

The identity's configuration information.

", - "locationName":"CloudFrontOriginAccessIdentityConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The identity's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the identity's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update an origin access identity.

", - "payload":"CloudFrontOriginAccessIdentityConfig" - }, - "UpdateCloudFrontOriginAccessIdentityResult":{ - "type":"structure", - "members":{ - "CloudFrontOriginAccessIdentity":{ - "shape":"CloudFrontOriginAccessIdentity", - "documentation":"

The origin access identity's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"CloudFrontOriginAccessIdentity" - }, - "UpdateDistributionRequest":{ - "type":"structure", - "required":[ - "DistributionConfig", - "Id" - ], - "members":{ - "DistributionConfig":{ - "shape":"DistributionConfig", - "documentation":"

The distribution's configuration information.

", - "locationName":"DistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a distribution.

", - "payload":"DistributionConfig" - }, - "UpdateDistributionResult":{ - "type":"structure", - "members":{ - "Distribution":{ - "shape":"Distribution", - "documentation":"

The distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"Distribution" - }, - "UpdateFieldLevelEncryptionConfigRequest":{ - "type":"structure", - "required":[ - "FieldLevelEncryptionConfig", - "Id" - ], - "members":{ - "FieldLevelEncryptionConfig":{ - "shape":"FieldLevelEncryptionConfig", - "documentation":"

Request to update a field-level encryption configuration.

", - "locationName":"FieldLevelEncryptionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The ID of the configuration you want to update.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the configuration identity to update. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "payload":"FieldLevelEncryptionConfig" - }, - "UpdateFieldLevelEncryptionConfigResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryption":{ - "shape":"FieldLevelEncryption", - "documentation":"

Return the results of updating the configuration.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when updating the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryption" - }, - "UpdateFieldLevelEncryptionProfileRequest":{ - "type":"structure", - "required":[ - "FieldLevelEncryptionProfileConfig", - "Id" - ], - "members":{ - "FieldLevelEncryptionProfileConfig":{ - "shape":"FieldLevelEncryptionProfileConfig", - "documentation":"

Request to update a field-level encryption profile.

", - "locationName":"FieldLevelEncryptionProfileConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The ID of the field-level encryption profile request.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the profile identity to update. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "payload":"FieldLevelEncryptionProfileConfig" - }, - "UpdateFieldLevelEncryptionProfileResult":{ - "type":"structure", - "members":{ - "FieldLevelEncryptionProfile":{ - "shape":"FieldLevelEncryptionProfile", - "documentation":"

Return the results of updating the profile.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The result of the field-level encryption profile request.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"FieldLevelEncryptionProfile" - }, - "UpdatePublicKeyRequest":{ - "type":"structure", - "required":[ - "PublicKeyConfig", - "Id" - ], - "members":{ - "PublicKeyConfig":{ - "shape":"PublicKeyConfig", - "documentation":"

Request to update public key information.

", - "locationName":"PublicKeyConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

ID of the public key to be updated.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the public key to update. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "payload":"PublicKeyConfig" - }, - "UpdatePublicKeyResult":{ - "type":"structure", - "members":{ - "PublicKey":{ - "shape":"PublicKey", - "documentation":"

Return the results of updating the public key.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the update public key result. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "payload":"PublicKey" - }, - "UpdateStreamingDistributionRequest":{ - "type":"structure", - "required":[ - "StreamingDistributionConfig", - "Id" - ], - "members":{ - "StreamingDistributionConfig":{ - "shape":"StreamingDistributionConfig", - "documentation":"

The streaming distribution's configuration information.

", - "locationName":"StreamingDistributionConfig", - "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2017-10-30/"} - }, - "Id":{ - "shape":"string", - "documentation":"

The streaming distribution's id.

", - "location":"uri", - "locationName":"Id" - }, - "IfMatch":{ - "shape":"string", - "documentation":"

The value of the ETag header that you received when retrieving the streaming distribution's configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"If-Match" - } - }, - "documentation":"

The request to update a streaming distribution.

", - "payload":"StreamingDistributionConfig" - }, - "UpdateStreamingDistributionResult":{ - "type":"structure", - "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" - }, - "ETag":{ - "shape":"string", - "documentation":"

The current version of the configuration. For example: E2QWRUHAPOMQZL.

", - "location":"header", - "locationName":"ETag" - } - }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" - }, - "ViewerCertificate":{ - "type":"structure", - "members":{ - "CloudFrontDefaultCertificate":{ - "shape":"boolean", - "documentation":"

For information about how and when to use CloudFrontDefaultCertificate, see ViewerCertificate.

" - }, - "IAMCertificateId":{ - "shape":"string", - "documentation":"

For information about how and when to use IAMCertificateId, see ViewerCertificate.

" - }, - "ACMCertificateArn":{ - "shape":"string", - "documentation":"

For information about how and when to use ACMCertificateArn, see ViewerCertificate.

" - }, - "SSLSupportMethod":{ - "shape":"SSLSupportMethod", - "documentation":"

If you specify a value for ViewerCertificate$ACMCertificateArn or for ViewerCertificate$IAMCertificateId, you must also specify how you want CloudFront to serve HTTPS requests: using a method that works for all clients or one that works for most clients:

  • vip: CloudFront uses dedicated IP addresses for your content and can respond to HTTPS requests from any viewer. However, you will incur additional monthly charges.

  • sni-only: CloudFront can respond to HTTPS requests from viewers that support Server Name Indication (SNI). All modern browsers support SNI, but some browsers still in use don't support SNI. If some of your users' browsers don't support SNI, we recommend that you do one of the following:

    • Use the vip option (dedicated IP addresses) instead of sni-only.

    • Use the CloudFront SSL/TLS certificate instead of a custom certificate. This requires that you use the CloudFront domain name of your distribution in the URLs for your objects, for example, https://d111111abcdef8.cloudfront.net/logo.png.

    • If you can control which browser your users use, upgrade the browser to one that supports SNI.

    • Use HTTP instead of HTTPS.

Don't specify a value for SSLSupportMethod if you specified <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>.

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "MinimumProtocolVersion":{ - "shape":"MinimumProtocolVersion", - "documentation":"

Specify the security policy that you want CloudFront to use for HTTPS connections. A security policy determines two settings:

  • The minimum SSL/TLS protocol that CloudFront uses to communicate with viewers

  • The cipher that CloudFront uses to encrypt the content that it returns to viewers

On the CloudFront console, this setting is called Security policy.

We recommend that you specify TLSv1.1_2016 unless your users are using browsers or devices that do not support TLSv1.1 or later.

When both of the following are true, you must specify TLSv1 or later for the security policy:

  • You're using a custom certificate: you specified a value for ACMCertificateArn or for IAMCertificateId

  • You're using SNI: you specified sni-only for SSLSupportMethod

If you specify true for CloudFrontDefaultCertificate, CloudFront automatically sets the security policy to TLSv1 regardless of the value that you specify for MinimumProtocolVersion.

For information about the relationship between the security policy that you choose and the protocols and ciphers that CloudFront uses to communicate with viewers, see Supported SSL/TLS Protocols and Ciphers for Communication Between Viewers and CloudFront in the Amazon CloudFront Developer Guide.

" - }, - "Certificate":{ - "shape":"string", - "documentation":"

This field has been deprecated. Use one of the following fields instead:

", - "deprecated":true - }, - "CertificateSource":{ - "shape":"CertificateSource", - "documentation":"

This field has been deprecated. Use one of the following fields instead:

", - "deprecated":true - } - }, - "documentation":"

A complex type that specifies the following:

  • Whether you want viewers to use HTTP or HTTPS to request your objects.

  • If you want viewers to use HTTPS, whether you're using an alternate domain name such as example.com or the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net.

  • If you're using an alternate domain name, whether AWS Certificate Manager (ACM) provided the certificate, or you purchased a certificate from a third-party certificate authority and imported it into ACM or uploaded it to the IAM certificate store.

You must specify only one of the following values:

Don't specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP instead of HTTPS to request your objects: Specify the following value:

<CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

In addition, specify allow-all for ViewerProtocolPolicy for all of your cache behaviors.

If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:

  • If you're using an alternate domain name, such as example.com: Specify one of the following values, depending on whether ACM provided your certificate or you purchased your certificate from third-party certificate authority:

    • <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate that you want to use for this distribution.

    • <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate ID is the ID that IAM returned when you added the certificate to the IAM certificate store.

    If you specify ACMCertificateArn or IAMCertificateId, you must also specify a value for SSLSupportMethod.

    If you choose to use an ACM certificate or a certificate in the IAM certificate store, we recommend that you use only an alternate domain name in your object URLs (https://example.com/logo.jpg). If you use the domain name that is associated with your CloudFront distribution (such as https://d111111abcdef8.cloudfront.net/logo.jpg) and the viewer supports SNI, then CloudFront behaves normally. However, if the browser does not support SNI, the user's experience depends on the value that you choose for SSLSupportMethod:

    • vip: The viewer displays a warning because there is a mismatch between the CloudFront domain name and the domain name in your SSL/TLS certificate.

    • sni-only: CloudFront drops the connection with the browser without returning the object.

  • If you're using the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net : Specify the following value:

    <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:

  • <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy>

  • <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy>

You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:

  • <OriginProtocolPolicy>https-only<OriginProtocolPolicy>

  • <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy>

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.

" - }, - "ViewerProtocolPolicy":{ - "type":"string", - "enum":[ - "allow-all", - "https-only", - "redirect-to-https" - ] - }, - "boolean":{"type":"boolean"}, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"Amazon CloudFront

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/waiters-2.json deleted file mode 100644 index edd74b2a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudfront/2017-10-30/waiters-2.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "version": 2, - "waiters": { - "DistributionDeployed": { - "delay": 60, - "operation": "GetDistribution", - "maxAttempts": 25, - "description": "Wait until a distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "Distribution.Status" - } - ] - }, - "InvalidationCompleted": { - "delay": 20, - "operation": "GetInvalidation", - "maxAttempts": 30, - "description": "Wait until an invalidation has completed.", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "Invalidation.Status" - } - ] - }, - "StreamingDistributionDeployed": { - "delay": 60, - "operation": "GetStreamingDistribution", - "maxAttempts": 25, - "description": "Wait until a streaming distribution is deployed.", - "acceptors": [ - { - "expected": "Deployed", - "matcher": "path", - "state": "success", - "argument": "StreamingDistribution.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/service-2.json deleted file mode 100644 index 139daddb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsm/2014-05-30/service-2.json +++ /dev/null @@ -1,1197 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-05-30", - "endpointPrefix":"cloudhsm", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CloudHSM", - "serviceFullName":"Amazon CloudHSM", - "serviceId":"CloudHSM", - "signatureVersion":"v4", - "targetPrefix":"CloudHsmFrontendService", - "uid":"cloudhsm-2014-05-30" - }, - "operations":{ - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceRequest"}, - "output":{"shape":"AddTagsToResourceResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Adds or overwrites one or more tags for the specified AWS CloudHSM resource.

Each tag consists of a key and a value. Tag keys must be unique to each resource.

" - }, - "CreateHapg":{ - "name":"CreateHapg", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHapgRequest"}, - "output":{"shape":"CreateHapgResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Creates a high-availability partition group. A high-availability partition group is a group of partitions that spans multiple physical HSMs.

" - }, - "CreateHsm":{ - "name":"CreateHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHsmRequest"}, - "output":{"shape":"CreateHsmResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Creates an uninitialized HSM instance.

There is an upfront fee charged for each HSM instance that you create with the CreateHsm operation. If you accidentally provision an HSM and want to request a refund, delete the instance using the DeleteHsm operation, go to the AWS Support Center, create a new case, and select Account and Billing Support.

It can take up to 20 minutes to create and provision an HSM. You can monitor the status of the HSM with the DescribeHsm operation. The HSM is ready to be initialized when the status changes to RUNNING.

" - }, - "CreateLunaClient":{ - "name":"CreateLunaClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLunaClientRequest"}, - "output":{"shape":"CreateLunaClientResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Creates an HSM client.

" - }, - "DeleteHapg":{ - "name":"DeleteHapg", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHapgRequest"}, - "output":{"shape":"DeleteHapgResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Deletes a high-availability partition group.

" - }, - "DeleteHsm":{ - "name":"DeleteHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHsmRequest"}, - "output":{"shape":"DeleteHsmResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Deletes an HSM. After completion, this operation cannot be undone and your key material cannot be recovered.

" - }, - "DeleteLunaClient":{ - "name":"DeleteLunaClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLunaClientRequest"}, - "output":{"shape":"DeleteLunaClientResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Deletes a client.

" - }, - "DescribeHapg":{ - "name":"DescribeHapg", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHapgRequest"}, - "output":{"shape":"DescribeHapgResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Retrieves information about a high-availability partition group.

" - }, - "DescribeHsm":{ - "name":"DescribeHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHsmRequest"}, - "output":{"shape":"DescribeHsmResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Retrieves information about an HSM. You can identify the HSM by its ARN or its serial number.

" - }, - "DescribeLunaClient":{ - "name":"DescribeLunaClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLunaClientRequest"}, - "output":{"shape":"DescribeLunaClientResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Retrieves information about an HSM client.

" - }, - "GetConfig":{ - "name":"GetConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConfigRequest"}, - "output":{"shape":"GetConfigResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Gets the configuration files necessary to connect to all high availability partition groups the client is associated with.

" - }, - "ListAvailableZones":{ - "name":"ListAvailableZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAvailableZonesRequest"}, - "output":{"shape":"ListAvailableZonesResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Lists the Availability Zones that have available AWS CloudHSM capacity.

" - }, - "ListHapgs":{ - "name":"ListHapgs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHapgsRequest"}, - "output":{"shape":"ListHapgsResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Lists the high-availability partition groups for the account.

This operation supports pagination with the use of the NextToken member. If more results are available, the NextToken member of the response contains a token that you pass in the next call to ListHapgs to retrieve the next set of items.

" - }, - "ListHsms":{ - "name":"ListHsms", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHsmsRequest"}, - "output":{"shape":"ListHsmsResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Retrieves the identifiers of all of the HSMs provisioned for the current customer.

This operation supports pagination with the use of the NextToken member. If more results are available, the NextToken member of the response contains a token that you pass in the next call to ListHsms to retrieve the next set of items.

" - }, - "ListLunaClients":{ - "name":"ListLunaClients", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListLunaClientsRequest"}, - "output":{"shape":"ListLunaClientsResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Lists all of the clients.

This operation supports pagination with the use of the NextToken member. If more results are available, the NextToken member of the response contains a token that you pass in the next call to ListLunaClients to retrieve the next set of items.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Returns a list of all tags for the specified AWS CloudHSM resource.

" - }, - "ModifyHapg":{ - "name":"ModifyHapg", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHapgRequest"}, - "output":{"shape":"ModifyHapgResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Modifies an existing high-availability partition group.

" - }, - "ModifyHsm":{ - "name":"ModifyHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHsmRequest"}, - "output":{"shape":"ModifyHsmResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Modifies an HSM.

This operation can result in the HSM being offline for up to 15 minutes while the AWS CloudHSM service is reconfigured. If you are modifying a production HSM, you should ensure that your AWS CloudHSM service is configured for high availability, and consider executing this operation during a maintenance window.

" - }, - "ModifyLunaClient":{ - "name":"ModifyLunaClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyLunaClientRequest"}, - "output":{"shape":"ModifyLunaClientResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Modifies the certificate used by the client.

This action can potentially start a workflow to install the new certificate on the client's HSMs.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceRequest"}, - "output":{"shape":"RemoveTagsFromResourceResponse"}, - "errors":[ - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInternalException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Removes one or more tags from the specified AWS CloudHSM resource.

To remove a tag, specify only the tag key to remove (not the value). To overwrite the value for an existing tag, use AddTagsToResource.

" - } - }, - "shapes":{ - "AZ":{ - "type":"string", - "pattern":"[a-zA-Z0-9\\-]*" - }, - "AZList":{ - "type":"list", - "member":{"shape":"AZ"} - }, - "AddTagsToResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagList" - ], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS CloudHSM resource to tag.

" - }, - "TagList":{ - "shape":"TagList", - "documentation":"

One or more tags.

" - } - } - }, - "AddTagsToResourceResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the operation.

" - } - } - }, - "Boolean":{"type":"boolean"}, - "Certificate":{ - "type":"string", - "max":2400, - "min":600, - "pattern":"[\\w :+=./\\n-]*" - }, - "CertificateFingerprint":{ - "type":"string", - "pattern":"([0-9a-fA-F][0-9a-fA-F]:){15}[0-9a-fA-F][0-9a-fA-F]" - }, - "ClientArn":{ - "type":"string", - "pattern":"arn:aws(-iso)?:cloudhsm:[a-zA-Z0-9\\-]*:[0-9]{12}:client-[0-9a-f]{8}" - }, - "ClientLabel":{ - "type":"string", - "pattern":"[a-zA-Z0-9_.-]{2,64}" - }, - "ClientList":{ - "type":"list", - "member":{"shape":"ClientArn"} - }, - "ClientToken":{ - "type":"string", - "pattern":"[a-zA-Z0-9]{1,64}" - }, - "ClientVersion":{ - "type":"string", - "enum":[ - "5.1", - "5.3" - ] - }, - "CloudHsmInternalException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that an internal error occurred.

", - "exception":true, - "fault":true - }, - "CloudHsmObjectState":{ - "type":"string", - "enum":[ - "READY", - "UPDATING", - "DEGRADED" - ] - }, - "CloudHsmServiceException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

Additional information about the error.

" - }, - "retryable":{ - "shape":"Boolean", - "documentation":"

Indicates if the action can be retried.

" - } - }, - "documentation":"

Indicates that an exception occurred in the AWS CloudHSM service.

", - "exception":true - }, - "CreateHapgRequest":{ - "type":"structure", - "required":["Label"], - "members":{ - "Label":{ - "shape":"Label", - "documentation":"

The label of the new high-availability partition group.

" - } - }, - "documentation":"

Contains the inputs for the CreateHapgRequest action.

" - }, - "CreateHapgResponse":{ - "type":"structure", - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group.

" - } - }, - "documentation":"

Contains the output of the CreateHAPartitionGroup action.

" - }, - "CreateHsmRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "SshKey", - "IamRoleArn", - "SubscriptionType" - ], - "members":{ - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The identifier of the subnet in your VPC in which to place the HSM.

", - "locationName":"SubnetId" - }, - "SshKey":{ - "shape":"SshKey", - "documentation":"

The SSH public key to install on the HSM.

", - "locationName":"SshKey" - }, - "EniIp":{ - "shape":"IpAddress", - "documentation":"

The IP address to assign to the HSM's ENI.

If an IP address is not specified, an IP address will be randomly chosen from the CIDR range of the subnet.

", - "locationName":"EniIp" - }, - "IamRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The ARN of an IAM role to enable the AWS CloudHSM service to allocate an ENI on your behalf.

", - "locationName":"IamRoleArn" - }, - "ExternalId":{ - "shape":"ExternalId", - "documentation":"

The external ID from IamRoleArn, if present.

", - "locationName":"ExternalId" - }, - "SubscriptionType":{ - "shape":"SubscriptionType", - "locationName":"SubscriptionType" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A user-defined token to ensure idempotence. Subsequent calls to this operation with the same token will be ignored.

", - "locationName":"ClientToken" - }, - "SyslogIp":{ - "shape":"IpAddress", - "documentation":"

The IP address for the syslog monitoring server. The AWS CloudHSM service only supports one syslog monitoring server.

", - "locationName":"SyslogIp" - } - }, - "documentation":"

Contains the inputs for the CreateHsm operation.

", - "locationName":"CreateHsmRequest" - }, - "CreateHsmResponse":{ - "type":"structure", - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM.

" - } - }, - "documentation":"

Contains the output of the CreateHsm operation.

" - }, - "CreateLunaClientRequest":{ - "type":"structure", - "required":["Certificate"], - "members":{ - "Label":{ - "shape":"ClientLabel", - "documentation":"

The label for the client.

" - }, - "Certificate":{ - "shape":"Certificate", - "documentation":"

The contents of a Base64-Encoded X.509 v3 certificate to be installed on the HSMs used by this client.

" - } - }, - "documentation":"

Contains the inputs for the CreateLunaClient action.

" - }, - "CreateLunaClientResponse":{ - "type":"structure", - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - } - }, - "documentation":"

Contains the output of the CreateLunaClient action.

" - }, - "DeleteHapgRequest":{ - "type":"structure", - "required":["HapgArn"], - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group to delete.

" - } - }, - "documentation":"

Contains the inputs for the DeleteHapg action.

" - }, - "DeleteHapgResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the action.

" - } - }, - "documentation":"

Contains the output of the DeleteHapg action.

" - }, - "DeleteHsmRequest":{ - "type":"structure", - "required":["HsmArn"], - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM to delete.

", - "locationName":"HsmArn" - } - }, - "documentation":"

Contains the inputs for the DeleteHsm operation.

", - "locationName":"DeleteHsmRequest" - }, - "DeleteHsmResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the operation.

" - } - }, - "documentation":"

Contains the output of the DeleteHsm operation.

" - }, - "DeleteLunaClientRequest":{ - "type":"structure", - "required":["ClientArn"], - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client to delete.

" - } - } - }, - "DeleteLunaClientResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the action.

" - } - } - }, - "DescribeHapgRequest":{ - "type":"structure", - "required":["HapgArn"], - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group to describe.

" - } - }, - "documentation":"

Contains the inputs for the DescribeHapg action.

" - }, - "DescribeHapgResponse":{ - "type":"structure", - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group.

" - }, - "HapgSerial":{ - "shape":"String", - "documentation":"

The serial number of the high-availability partition group.

" - }, - "HsmsLastActionFailed":{ - "shape":"HsmList", - "documentation":"

" - }, - "HsmsPendingDeletion":{ - "shape":"HsmList", - "documentation":"

" - }, - "HsmsPendingRegistration":{ - "shape":"HsmList", - "documentation":"

" - }, - "Label":{ - "shape":"Label", - "documentation":"

The label for the high-availability partition group.

" - }, - "LastModifiedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time the high-availability partition group was last modified.

" - }, - "PartitionSerialList":{ - "shape":"PartitionSerialList", - "documentation":"

The list of partition serial numbers that belong to the high-availability partition group.

" - }, - "State":{ - "shape":"CloudHsmObjectState", - "documentation":"

The state of the high-availability partition group.

" - } - }, - "documentation":"

Contains the output of the DescribeHapg action.

" - }, - "DescribeHsmRequest":{ - "type":"structure", - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM. Either the HsmArn or the SerialNumber parameter must be specified.

" - }, - "HsmSerialNumber":{ - "shape":"HsmSerialNumber", - "documentation":"

The serial number of the HSM. Either the HsmArn or the HsmSerialNumber parameter must be specified.

" - } - }, - "documentation":"

Contains the inputs for the DescribeHsm operation.

" - }, - "DescribeHsmResponse":{ - "type":"structure", - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM.

" - }, - "Status":{ - "shape":"HsmStatus", - "documentation":"

The status of the HSM.

" - }, - "StatusDetails":{ - "shape":"String", - "documentation":"

Contains additional information about the status of the HSM.

" - }, - "AvailabilityZone":{ - "shape":"AZ", - "documentation":"

The Availability Zone that the HSM is in.

" - }, - "EniId":{ - "shape":"EniId", - "documentation":"

The identifier of the elastic network interface (ENI) attached to the HSM.

" - }, - "EniIp":{ - "shape":"IpAddress", - "documentation":"

The IP address assigned to the HSM's ENI.

" - }, - "SubscriptionType":{"shape":"SubscriptionType"}, - "SubscriptionStartDate":{ - "shape":"Timestamp", - "documentation":"

The subscription start date.

" - }, - "SubscriptionEndDate":{ - "shape":"Timestamp", - "documentation":"

The subscription end date.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC that the HSM is in.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The identifier of the subnet that the HSM is in.

" - }, - "IamRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The ARN of the IAM role assigned to the HSM.

" - }, - "SerialNumber":{ - "shape":"HsmSerialNumber", - "documentation":"

The serial number of the HSM.

" - }, - "VendorName":{ - "shape":"String", - "documentation":"

The name of the HSM vendor.

" - }, - "HsmType":{ - "shape":"String", - "documentation":"

The HSM model type.

" - }, - "SoftwareVersion":{ - "shape":"String", - "documentation":"

The HSM software version.

" - }, - "SshPublicKey":{ - "shape":"SshKey", - "documentation":"

The public SSH key.

" - }, - "SshKeyLastUpdated":{ - "shape":"Timestamp", - "documentation":"

The date and time that the SSH key was last updated.

" - }, - "ServerCertUri":{ - "shape":"String", - "documentation":"

The URI of the certificate server.

" - }, - "ServerCertLastUpdated":{ - "shape":"Timestamp", - "documentation":"

The date and time that the server certificate was last updated.

" - }, - "Partitions":{ - "shape":"PartitionList", - "documentation":"

The list of partitions on the HSM.

" - } - }, - "documentation":"

Contains the output of the DescribeHsm operation.

" - }, - "DescribeLunaClientRequest":{ - "type":"structure", - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - }, - "CertificateFingerprint":{ - "shape":"CertificateFingerprint", - "documentation":"

The certificate fingerprint.

" - } - } - }, - "DescribeLunaClientResponse":{ - "type":"structure", - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - }, - "Certificate":{ - "shape":"Certificate", - "documentation":"

The certificate installed on the HSMs used by this client.

" - }, - "CertificateFingerprint":{ - "shape":"CertificateFingerprint", - "documentation":"

The certificate fingerprint.

" - }, - "LastModifiedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time the client was last modified.

" - }, - "Label":{ - "shape":"Label", - "documentation":"

The label of the client.

" - } - } - }, - "EniId":{ - "type":"string", - "pattern":"eni-[0-9a-f]{8}" - }, - "ExternalId":{ - "type":"string", - "pattern":"[\\w :+=./-]*" - }, - "GetConfigRequest":{ - "type":"structure", - "required":[ - "ClientArn", - "ClientVersion", - "HapgList" - ], - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - }, - "ClientVersion":{ - "shape":"ClientVersion", - "documentation":"

The client version.

" - }, - "HapgList":{ - "shape":"HapgList", - "documentation":"

A list of ARNs that identify the high-availability partition groups that are associated with the client.

" - } - } - }, - "GetConfigResponse":{ - "type":"structure", - "members":{ - "ConfigType":{ - "shape":"String", - "documentation":"

The type of credentials.

" - }, - "ConfigFile":{ - "shape":"String", - "documentation":"

The chrystoki.conf configuration file.

" - }, - "ConfigCred":{ - "shape":"String", - "documentation":"

The certificate file containing the server.pem files of the HSMs.

" - } - } - }, - "HapgArn":{ - "type":"string", - "pattern":"arn:aws(-iso)?:cloudhsm:[a-zA-Z0-9\\-]*:[0-9]{12}:hapg-[0-9a-f]{8}" - }, - "HapgList":{ - "type":"list", - "member":{"shape":"HapgArn"} - }, - "HsmArn":{ - "type":"string", - "documentation":"

An ARN that identifies an HSM.

", - "pattern":"arn:aws(-iso)?:cloudhsm:[a-zA-Z0-9\\-]*:[0-9]{12}:hsm-[0-9a-f]{8}" - }, - "HsmList":{ - "type":"list", - "member":{"shape":"HsmArn"}, - "documentation":"

Contains a list of ARNs that identify the HSMs.

" - }, - "HsmSerialNumber":{ - "type":"string", - "pattern":"\\d{1,16}" - }, - "HsmStatus":{ - "type":"string", - "enum":[ - "PENDING", - "RUNNING", - "UPDATING", - "SUSPENDED", - "TERMINATING", - "TERMINATED", - "DEGRADED" - ] - }, - "IamRoleArn":{ - "type":"string", - "pattern":"arn:aws(-iso)?:iam::[0-9]{12}:role/[a-zA-Z0-9_\\+=,\\.\\-@]{1,64}" - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that one or more of the request parameters are not valid.

", - "exception":true - }, - "IpAddress":{ - "type":"string", - "pattern":"\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}" - }, - "Label":{ - "type":"string", - "pattern":"[a-zA-Z0-9_.-]{1,64}" - }, - "ListAvailableZonesRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the inputs for the ListAvailableZones action.

" - }, - "ListAvailableZonesResponse":{ - "type":"structure", - "members":{ - "AZList":{ - "shape":"AZList", - "documentation":"

The list of Availability Zones that have available AWS CloudHSM capacity.

" - } - } - }, - "ListHapgsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The NextToken value from a previous call to ListHapgs. Pass null if this is the first call.

" - } - } - }, - "ListHapgsResponse":{ - "type":"structure", - "required":["HapgList"], - "members":{ - "HapgList":{ - "shape":"HapgList", - "documentation":"

The list of high-availability partition groups.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If not null, more results are available. Pass this value to ListHapgs to retrieve the next set of items.

" - } - } - }, - "ListHsmsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The NextToken value from a previous call to ListHsms. Pass null if this is the first call.

" - } - } - }, - "ListHsmsResponse":{ - "type":"structure", - "members":{ - "HsmList":{ - "shape":"HsmList", - "documentation":"

The list of ARNs that identify the HSMs.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If not null, more results are available. Pass this value to ListHsms to retrieve the next set of items.

" - } - }, - "documentation":"

Contains the output of the ListHsms operation.

" - }, - "ListLunaClientsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The NextToken value from a previous call to ListLunaClients. Pass null if this is the first call.

" - } - } - }, - "ListLunaClientsResponse":{ - "type":"structure", - "required":["ClientList"], - "members":{ - "ClientList":{ - "shape":"ClientList", - "documentation":"

The list of clients.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If not null, more results are available. Pass this to ListLunaClients to retrieve the next set of items.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS CloudHSM resource.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "required":["TagList"], - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

One or more tags.

" - } - } - }, - "ModifyHapgRequest":{ - "type":"structure", - "required":["HapgArn"], - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group to modify.

" - }, - "Label":{ - "shape":"Label", - "documentation":"

The new label for the high-availability partition group.

" - }, - "PartitionSerialList":{ - "shape":"PartitionSerialList", - "documentation":"

The list of partition serial numbers to make members of the high-availability partition group.

" - } - } - }, - "ModifyHapgResponse":{ - "type":"structure", - "members":{ - "HapgArn":{ - "shape":"HapgArn", - "documentation":"

The ARN of the high-availability partition group.

" - } - } - }, - "ModifyHsmRequest":{ - "type":"structure", - "required":["HsmArn"], - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM to modify.

", - "locationName":"HsmArn" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The new identifier of the subnet that the HSM is in. The new subnet must be in the same Availability Zone as the current subnet.

", - "locationName":"SubnetId" - }, - "EniIp":{ - "shape":"IpAddress", - "documentation":"

The new IP address for the elastic network interface (ENI) attached to the HSM.

If the HSM is moved to a different subnet, and an IP address is not specified, an IP address will be randomly chosen from the CIDR range of the new subnet.

", - "locationName":"EniIp" - }, - "IamRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The new IAM role ARN.

", - "locationName":"IamRoleArn" - }, - "ExternalId":{ - "shape":"ExternalId", - "documentation":"

The new external ID.

", - "locationName":"ExternalId" - }, - "SyslogIp":{ - "shape":"IpAddress", - "documentation":"

The new IP address for the syslog monitoring server. The AWS CloudHSM service only supports one syslog monitoring server.

", - "locationName":"SyslogIp" - } - }, - "documentation":"

Contains the inputs for the ModifyHsm operation.

", - "locationName":"ModifyHsmRequest" - }, - "ModifyHsmResponse":{ - "type":"structure", - "members":{ - "HsmArn":{ - "shape":"HsmArn", - "documentation":"

The ARN of the HSM.

" - } - }, - "documentation":"

Contains the output of the ModifyHsm operation.

" - }, - "ModifyLunaClientRequest":{ - "type":"structure", - "required":[ - "ClientArn", - "Certificate" - ], - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - }, - "Certificate":{ - "shape":"Certificate", - "documentation":"

The new certificate for the client.

" - } - } - }, - "ModifyLunaClientResponse":{ - "type":"structure", - "members":{ - "ClientArn":{ - "shape":"ClientArn", - "documentation":"

The ARN of the client.

" - } - } - }, - "PaginationToken":{ - "type":"string", - "pattern":"[a-zA-Z0-9+/]*" - }, - "PartitionArn":{ - "type":"string", - "pattern":"arn:aws(-iso)?:cloudhsm:[a-zA-Z0-9\\-]*:[0-9]{12}:hsm-[0-9a-f]{8}/partition-[0-9]{6,12}" - }, - "PartitionList":{ - "type":"list", - "member":{"shape":"PartitionArn"} - }, - "PartitionSerial":{ - "type":"string", - "pattern":"\\d{6,12}" - }, - "PartitionSerialList":{ - "type":"list", - "member":{"shape":"PartitionSerial"} - }, - "RemoveTagsFromResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeyList" - ], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS CloudHSM resource.

" - }, - "TagKeyList":{ - "shape":"TagKeyList", - "documentation":"

The tag key or keys to remove.

Specify only the tag key to remove (not the value). To overwrite the value for an existing tag, use AddTagsToResource.

" - } - } - }, - "RemoveTagsFromResourceResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the operation.

" - } - } - }, - "SshKey":{ - "type":"string", - "pattern":"[a-zA-Z0-9+/= ._:\\\\@-]*" - }, - "String":{ - "type":"string", - "pattern":"[\\w :+=./\\\\-]*" - }, - "SubnetId":{ - "type":"string", - "pattern":"subnet-[0-9a-f]{8}" - }, - "SubscriptionType":{ - "type":"string", - "documentation":"

Specifies the type of subscription for the HSM.

  • PRODUCTION - The HSM is being used in a production environment.

  • TRIAL - The HSM is being used in a product trial.

", - "enum":["PRODUCTION"] - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

A key-value pair that identifies or specifies metadata about an AWS CloudHSM resource.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0 - }, - "Timestamp":{ - "type":"string", - "pattern":"\\d*" - }, - "VpcId":{ - "type":"string", - "pattern":"vpc-[0-9a-f]{8}" - } - }, - "documentation":"AWS CloudHSM Service

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/paginators-1.json deleted file mode 100644 index 19c403f0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "DescribeBackups": { - "result_key": "Backups", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "DescribeClusters": { - "result_key": "Clusters", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTags": { - "result_key": "TagList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/service-2.json deleted file mode 100644 index a73737c2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudhsmv2/2017-04-28/service-2.json +++ /dev/null @@ -1,892 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-04-28", - "endpointPrefix":"cloudhsmv2", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CloudHSM V2", - "serviceFullName":"AWS CloudHSM V2", - "serviceId":"CloudHSM V2", - "signatureVersion":"v4", - "signingName":"cloudhsm", - "targetPrefix":"BaldrApiService", - "uid":"cloudhsmv2-2017-04-28" - }, - "operations":{ - "CopyBackupToRegion":{ - "name":"CopyBackupToRegion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyBackupToRegionRequest"}, - "output":{"shape":"CopyBackupToRegionResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ] - }, - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterRequest"}, - "output":{"shape":"CreateClusterResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Creates a new AWS CloudHSM cluster.

" - }, - "CreateHsm":{ - "name":"CreateHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHsmRequest"}, - "output":{"shape":"CreateHsmResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Creates a new hardware security module (HSM) in the specified AWS CloudHSM cluster.

" - }, - "DeleteCluster":{ - "name":"DeleteCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterRequest"}, - "output":{"shape":"DeleteClusterResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Deletes the specified AWS CloudHSM cluster. Before you can delete a cluster, you must delete all HSMs in the cluster. To see if the cluster contains any HSMs, use DescribeClusters. To delete an HSM, use DeleteHsm.

" - }, - "DeleteHsm":{ - "name":"DeleteHsm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHsmRequest"}, - "output":{"shape":"DeleteHsmResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Deletes the specified HSM. To specify an HSM, you can use its identifier (ID), the IP address of the HSM's elastic network interface (ENI), or the ID of the HSM's ENI. You need to specify only one of these values. To find these values, use DescribeClusters.

" - }, - "DescribeBackups":{ - "name":"DescribeBackups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBackupsRequest"}, - "output":{"shape":"DescribeBackupsResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Gets information about backups of AWS CloudHSM clusters.

This is a paginated operation, which means that each response might contain only a subset of all the backups. When the response contains only a subset of backups, it includes a NextToken value. Use this value in a subsequent DescribeBackups request to get more backups. When you receive a response with no NextToken (or an empty or null value), that means there are no more backups to get.

" - }, - "DescribeClusters":{ - "name":"DescribeClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClustersRequest"}, - "output":{"shape":"DescribeClustersResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Gets information about AWS CloudHSM clusters.

This is a paginated operation, which means that each response might contain only a subset of all the clusters. When the response contains only a subset of clusters, it includes a NextToken value. Use this value in a subsequent DescribeClusters request to get more clusters. When you receive a response with no NextToken (or an empty or null value), that means there are no more clusters to get.

" - }, - "InitializeCluster":{ - "name":"InitializeCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InitializeClusterRequest"}, - "output":{"shape":"InitializeClusterResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Claims an AWS CloudHSM cluster by submitting the cluster certificate issued by your issuing certificate authority (CA) and the CA's root certificate. Before you can claim a cluster, you must sign the cluster's certificate signing request (CSR) with your issuing CA. To get the cluster's CSR, use DescribeClusters.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Gets a list of tags for the specified AWS CloudHSM cluster.

This is a paginated operation, which means that each response might contain only a subset of all the tags. When the response contains only a subset of tags, it includes a NextToken value. Use this value in a subsequent ListTags request to get more tags. When you receive a response with no NextToken (or an empty or null value), that means there are no more tags to get.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Adds or overwrites one or more tags for the specified AWS CloudHSM cluster.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"CloudHsmInternalFailureException"}, - {"shape":"CloudHsmServiceException"}, - {"shape":"CloudHsmResourceNotFoundException"}, - {"shape":"CloudHsmInvalidRequestException"}, - {"shape":"CloudHsmAccessDeniedException"} - ], - "documentation":"

Removes the specified tag or tags from the specified AWS CloudHSM cluster.

" - } - }, - "shapes":{ - "Backup":{ - "type":"structure", - "required":["BackupId"], - "members":{ - "BackupId":{ - "shape":"BackupId", - "documentation":"

The identifier (ID) of the backup.

" - }, - "BackupState":{ - "shape":"BackupState", - "documentation":"

The state of the backup.

" - }, - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the cluster that was backed up.

" - }, - "CreateTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time when the backup was created.

" - }, - "CopyTimestamp":{"shape":"Timestamp"}, - "SourceRegion":{"shape":"Region"}, - "SourceBackup":{"shape":"BackupId"}, - "SourceCluster":{"shape":"ClusterId"} - }, - "documentation":"

Contains information about a backup of an AWS CloudHSM cluster.

" - }, - "BackupId":{ - "type":"string", - "pattern":"backup-[2-7a-zA-Z]{11,16}" - }, - "BackupPolicy":{ - "type":"string", - "enum":["DEFAULT"] - }, - "BackupState":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "READY", - "DELETED" - ] - }, - "Backups":{ - "type":"list", - "member":{"shape":"Backup"} - }, - "Boolean":{"type":"boolean"}, - "Cert":{ - "type":"string", - "max":5000, - "pattern":"[a-zA-Z0-9+-/=\\s]*" - }, - "Certificates":{ - "type":"structure", - "members":{ - "ClusterCsr":{ - "shape":"Cert", - "documentation":"

The cluster's certificate signing request (CSR). The CSR exists only when the cluster's state is UNINITIALIZED.

" - }, - "HsmCertificate":{ - "shape":"Cert", - "documentation":"

The HSM certificate issued (signed) by the HSM hardware.

" - }, - "AwsHardwareCertificate":{ - "shape":"Cert", - "documentation":"

The HSM hardware certificate issued (signed) by AWS CloudHSM.

" - }, - "ManufacturerHardwareCertificate":{ - "shape":"Cert", - "documentation":"

The HSM hardware certificate issued (signed) by the hardware manufacturer.

" - }, - "ClusterCertificate":{ - "shape":"Cert", - "documentation":"

The cluster certificate issued (signed) by the issuing certificate authority (CA) of the cluster's owner.

" - } - }, - "documentation":"

Contains one or more certificates or a certificate signing request (CSR).

" - }, - "CloudHsmAccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The request was rejected because the requester does not have permission to perform the requested operation.

", - "exception":true - }, - "CloudHsmInternalFailureException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The request was rejected because of an AWS CloudHSM internal failure. The request can be retried.

", - "exception":true, - "fault":true - }, - "CloudHsmInvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The request was rejected because it is not a valid request.

", - "exception":true - }, - "CloudHsmResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The request was rejected because it refers to a resource that cannot be found.

", - "exception":true - }, - "CloudHsmServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The request was rejected because an error occurred.

", - "exception":true - }, - "Cluster":{ - "type":"structure", - "members":{ - "BackupPolicy":{ - "shape":"BackupPolicy", - "documentation":"

The cluster's backup policy.

" - }, - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The cluster's identifier (ID).

" - }, - "CreateTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time when the cluster was created.

" - }, - "Hsms":{ - "shape":"Hsms", - "documentation":"

Contains information about the HSMs in the cluster.

" - }, - "HsmType":{ - "shape":"HsmType", - "documentation":"

The type of HSM that the cluster contains.

" - }, - "PreCoPassword":{ - "shape":"PreCoPassword", - "documentation":"

The default password for the cluster's Pre-Crypto Officer (PRECO) user.

" - }, - "SecurityGroup":{ - "shape":"SecurityGroup", - "documentation":"

The identifier (ID) of the cluster's security group.

" - }, - "SourceBackupId":{ - "shape":"BackupId", - "documentation":"

The identifier (ID) of the backup used to create the cluster. This value exists only when the cluster was created from a backup.

" - }, - "State":{ - "shape":"ClusterState", - "documentation":"

The cluster's state.

" - }, - "StateMessage":{ - "shape":"StateMessage", - "documentation":"

A description of the cluster's state.

" - }, - "SubnetMapping":{ - "shape":"ExternalSubnetMapping", - "documentation":"

A map of the cluster's subnets and their corresponding Availability Zones.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier (ID) of the virtual private cloud (VPC) that contains the cluster.

" - }, - "Certificates":{ - "shape":"Certificates", - "documentation":"

Contains one or more certificates or a certificate signing request (CSR).

" - } - }, - "documentation":"

Contains information about an AWS CloudHSM cluster.

" - }, - "ClusterId":{ - "type":"string", - "pattern":"cluster-[2-7a-zA-Z]{11,16}" - }, - "ClusterState":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "UNINITIALIZED", - "INITIALIZE_IN_PROGRESS", - "INITIALIZED", - "ACTIVE", - "UPDATE_IN_PROGRESS", - "DELETE_IN_PROGRESS", - "DELETED", - "DEGRADED" - ] - }, - "Clusters":{ - "type":"list", - "member":{"shape":"Cluster"} - }, - "CopyBackupToRegionRequest":{ - "type":"structure", - "required":[ - "DestinationRegion", - "BackupId" - ], - "members":{ - "DestinationRegion":{"shape":"Region"}, - "BackupId":{"shape":"BackupId"} - } - }, - "CopyBackupToRegionResponse":{ - "type":"structure", - "members":{ - "DestinationBackup":{"shape":"DestinationBackup"} - } - }, - "CreateClusterRequest":{ - "type":"structure", - "required":[ - "SubnetIds", - "HsmType" - ], - "members":{ - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

The identifiers (IDs) of the subnets where you are creating the cluster. You must specify at least one subnet. If you specify multiple subnets, they must meet the following criteria:

  • All subnets must be in the same virtual private cloud (VPC).

  • You can specify only one subnet per Availability Zone.

" - }, - "HsmType":{ - "shape":"HsmType", - "documentation":"

The type of HSM to use in the cluster. Currently the only allowed value is hsm1.medium.

" - }, - "SourceBackupId":{ - "shape":"BackupId", - "documentation":"

The identifier (ID) of the cluster backup to restore. Use this value to restore the cluster from a backup instead of creating a new cluster. To find the backup ID, use DescribeBackups.

" - } - } - }, - "CreateClusterResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

Information about the cluster that was created.

" - } - } - }, - "CreateHsmRequest":{ - "type":"structure", - "required":[ - "ClusterId", - "AvailabilityZone" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the HSM's cluster. To find the cluster ID, use DescribeClusters.

" - }, - "AvailabilityZone":{ - "shape":"ExternalAz", - "documentation":"

The Availability Zone where you are creating the HSM. To find the cluster's Availability Zones, use DescribeClusters.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

The HSM's IP address. If you specify an IP address, use an available address from the subnet that maps to the Availability Zone where you are creating the HSM. If you don't specify an IP address, one is chosen for you from that subnet.

" - } - } - }, - "CreateHsmResponse":{ - "type":"structure", - "members":{ - "Hsm":{ - "shape":"Hsm", - "documentation":"

Information about the HSM that was created.

" - } - } - }, - "DeleteClusterRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the cluster that you are deleting. To find the cluster ID, use DescribeClusters.

" - } - } - }, - "DeleteClusterResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

Information about the cluster that was deleted.

" - } - } - }, - "DeleteHsmRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the cluster that contains the HSM that you are deleting.

" - }, - "HsmId":{ - "shape":"HsmId", - "documentation":"

The identifier (ID) of the HSM that you are deleting.

" - }, - "EniId":{ - "shape":"EniId", - "documentation":"

The identifier (ID) of the elastic network interface (ENI) of the HSM that you are deleting.

" - }, - "EniIp":{ - "shape":"IpAddress", - "documentation":"

The IP address of the elastic network interface (ENI) of the HSM that you are deleting.

" - } - } - }, - "DeleteHsmResponse":{ - "type":"structure", - "members":{ - "HsmId":{ - "shape":"HsmId", - "documentation":"

The identifier (ID) of the HSM that was deleted.

" - } - } - }, - "DescribeBackupsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that you received in the previous response. Use this value to get more backups.

" - }, - "MaxResults":{ - "shape":"MaxSize", - "documentation":"

The maximum number of backups to return in the response. When there are more backups than the number you specify, the response contains a NextToken value.

" - }, - "Filters":{ - "shape":"Filters", - "documentation":"

One or more filters to limit the items returned in the response.

Use the backupIds filter to return only the specified backups. Specify backups by their backup identifier (ID).

Use the clusterIds filter to return only the backups for the specified clusters. Specify clusters by their cluster identifier (ID).

Use the states filter to return only backups that match the specified state.

" - }, - "SortAscending":{"shape":"Boolean"} - } - }, - "DescribeBackupsResponse":{ - "type":"structure", - "members":{ - "Backups":{ - "shape":"Backups", - "documentation":"

A list of backups.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque string that indicates that the response contains only a subset of backups. Use this value in a subsequent DescribeBackups request to get more backups.

" - } - } - }, - "DescribeClustersRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"Filters", - "documentation":"

One or more filters to limit the items returned in the response.

Use the clusterIds filter to return only the specified clusters. Specify clusters by their cluster identifier (ID).

Use the vpcIds filter to return only the clusters in the specified virtual private clouds (VPCs). Specify VPCs by their VPC identifier (ID).

Use the states filter to return only clusters that match the specified state.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that you received in the previous response. Use this value to get more clusters.

" - }, - "MaxResults":{ - "shape":"MaxSize", - "documentation":"

The maximum number of clusters to return in the response. When there are more clusters than the number you specify, the response contains a NextToken value.

" - } - } - }, - "DescribeClustersResponse":{ - "type":"structure", - "members":{ - "Clusters":{ - "shape":"Clusters", - "documentation":"

A list of clusters.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque string that indicates that the response contains only a subset of clusters. Use this value in a subsequent DescribeClusters request to get more clusters.

" - } - } - }, - "DestinationBackup":{ - "type":"structure", - "members":{ - "CreateTimestamp":{"shape":"Timestamp"}, - "SourceRegion":{"shape":"Region"}, - "SourceBackup":{"shape":"BackupId"}, - "SourceCluster":{"shape":"ClusterId"} - } - }, - "EniId":{ - "type":"string", - "pattern":"eni-[0-9a-fA-F]{8,17}" - }, - "ExternalAz":{ - "type":"string", - "pattern":"[a-z]{2}(-(gov))?-(east|west|north|south|central){1,2}-\\d[a-z]" - }, - "ExternalSubnetMapping":{ - "type":"map", - "key":{"shape":"ExternalAz"}, - "value":{"shape":"SubnetId"} - }, - "Field":{ - "type":"string", - "pattern":"[a-zA-Z0-9_-]+" - }, - "Filters":{ - "type":"map", - "key":{"shape":"Field"}, - "value":{"shape":"Strings"} - }, - "Hsm":{ - "type":"structure", - "required":["HsmId"], - "members":{ - "AvailabilityZone":{ - "shape":"ExternalAz", - "documentation":"

The Availability Zone that contains the HSM.

" - }, - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the cluster that contains the HSM.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The subnet that contains the HSM's elastic network interface (ENI).

" - }, - "EniId":{ - "shape":"EniId", - "documentation":"

The identifier (ID) of the HSM's elastic network interface (ENI).

" - }, - "EniIp":{ - "shape":"IpAddress", - "documentation":"

The IP address of the HSM's elastic network interface (ENI).

" - }, - "HsmId":{ - "shape":"HsmId", - "documentation":"

The HSM's identifier (ID).

" - }, - "State":{ - "shape":"HsmState", - "documentation":"

The HSM's state.

" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

A description of the HSM's state.

" - } - }, - "documentation":"

Contains information about a hardware security module (HSM) in an AWS CloudHSM cluster.

" - }, - "HsmId":{ - "type":"string", - "pattern":"hsm-[2-7a-zA-Z]{11,16}" - }, - "HsmState":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "ACTIVE", - "DEGRADED", - "DELETE_IN_PROGRESS", - "DELETED" - ] - }, - "HsmType":{ - "type":"string", - "pattern":"(hsm1\\.medium)" - }, - "Hsms":{ - "type":"list", - "member":{"shape":"Hsm"} - }, - "InitializeClusterRequest":{ - "type":"structure", - "required":[ - "ClusterId", - "SignedCert", - "TrustAnchor" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier (ID) of the cluster that you are claiming. To find the cluster ID, use DescribeClusters.

" - }, - "SignedCert":{ - "shape":"Cert", - "documentation":"

The cluster certificate issued (signed) by your issuing certificate authority (CA). The certificate must be in PEM format and can contain a maximum of 5000 characters.

" - }, - "TrustAnchor":{ - "shape":"Cert", - "documentation":"

The issuing certificate of the issuing certificate authority (CA) that issued (signed) the cluster certificate. This can be a root (self-signed) certificate or a certificate chain that begins with the certificate that issued the cluster certificate and ends with a root certificate. The certificate or certificate chain must be in PEM format and can contain a maximum of 5000 characters.

" - } - } - }, - "InitializeClusterResponse":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ClusterState", - "documentation":"

The cluster's state.

" - }, - "StateMessage":{ - "shape":"StateMessage", - "documentation":"

A description of the cluster's state.

" - } - } - }, - "IpAddress":{ - "type":"string", - "pattern":"\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}" - }, - "ListTagsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"ClusterId", - "documentation":"

The cluster identifier (ID) for the cluster whose tags you are getting. To find the cluster ID, use DescribeClusters.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that you received in the previous response. Use this value to get more tags.

" - }, - "MaxResults":{ - "shape":"MaxSize", - "documentation":"

The maximum number of tags to return in the response. When there are more tags than the number you specify, the response contains a NextToken value.

" - } - } - }, - "ListTagsResponse":{ - "type":"structure", - "required":["TagList"], - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

A list of tags.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque string that indicates that the response contains only a subset of tags. Use this value in a subsequent ListTags request to get more tags.

" - } - } - }, - "MaxSize":{ - "type":"integer", - "max":100, - "min":1 - }, - "NextToken":{ - "type":"string", - "max":256, - "pattern":".*" - }, - "PreCoPassword":{ - "type":"string", - "max":32, - "min":7 - }, - "Region":{ - "type":"string", - "pattern":"[a-z]{2}(-(gov))?-(east|west|north|south|central){1,2}-\\d" - }, - "SecurityGroup":{ - "type":"string", - "pattern":"sg-[0-9a-fA-F]" - }, - "StateMessage":{ - "type":"string", - "max":300, - "pattern":".*" - }, - "String":{"type":"string"}, - "Strings":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubnetId":{ - "type":"string", - "pattern":"subnet-[0-9a-fA-F]{8,17}" - }, - "SubnetIds":{ - "type":"list", - "member":{"shape":"SubnetId"}, - "max":10, - "min":1 - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Contains a tag. A tag is a key-value pair.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "TagList" - ], - "members":{ - "ResourceId":{ - "shape":"ClusterId", - "documentation":"

The cluster identifier (ID) for the cluster that you are tagging. To find the cluster ID, use DescribeClusters.

" - }, - "TagList":{ - "shape":"TagList", - "documentation":"

A list of one or more tags.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Timestamp":{"type":"timestamp"}, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "TagKeyList" - ], - "members":{ - "ResourceId":{ - "shape":"ClusterId", - "documentation":"

The cluster identifier (ID) for the cluster whose tags you are removing. To find the cluster ID, use DescribeClusters.

" - }, - "TagKeyList":{ - "shape":"TagKeyList", - "documentation":"

A list of one or more tag keys for the tags that you are removing. Specify only the tag keys, not the tag values.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "VpcId":{ - "type":"string", - "pattern":"vpc-[0-9a-fA-F]" - }, - "errorMessage":{"type":"string"} - }, - "documentation":"

For more information about AWS CloudHSM, see AWS CloudHSM and the AWS CloudHSM User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2011-02-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2011-02-01/service-2.json deleted file mode 100644 index 98364bdb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2011-02-01/service-2.json +++ /dev/null @@ -1,2096 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2011-02-01", - "endpointPrefix":"cloudsearch", - "serviceFullName":"Amazon CloudSearch", - "signatureVersion":"v4", - "xmlNamespace":"http://cloudsearch.amazonaws.com/doc/2011-02-01/", - "protocol":"query" - }, - "documentation":"Amazon CloudSearch Configuration Service

You use the configuration service to create, configure, and manage search domains. Configuration service requests are submitted using the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted via HTTP GET or POST with a query parameter named Action.

The endpoint for configuration service requests is region-specific: cloudsearch.region.amazonaws.com. For example, cloudsearch.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints.

", - "operations":{ - "CreateDomain":{ - "name":"CreateDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDomainRequest"}, - "output":{ - "shape":"CreateDomainResponse", - "documentation":"

A response message that contains the status of a newly created domain.

", - "resultWrapper":"CreateDomainResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - } - ], - "documentation":"

Creates a new search domain.

" - }, - "DefineIndexField":{ - "name":"DefineIndexField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DefineIndexFieldRequest"}, - "output":{ - "shape":"DefineIndexFieldResponse", - "documentation":"

A response message that contains the status of an updated index field.

", - "resultWrapper":"DefineIndexFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures an IndexField for the search domain. Used to create new fields and modify existing ones. If the field exists, the new configuration replaces the old one. You can configure a maximum of 200 index fields.

" - }, - "DefineRankExpression":{ - "name":"DefineRankExpression", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DefineRankExpressionRequest"}, - "output":{ - "shape":"DefineRankExpressionResponse", - "documentation":"

A response message that contains the status of an updated RankExpression.

", - "resultWrapper":"DefineRankExpressionResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures a RankExpression for the search domain. Used to create new rank expressions and modify existing ones. If the expression exists, the new configuration replaces the old one. You can configure a maximum of 50 rank expressions.

" - }, - "DeleteDomain":{ - "name":"DeleteDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDomainRequest"}, - "output":{ - "shape":"DeleteDomainResponse", - "documentation":"

A response message that contains the status of a newly deleted domain, or no status if the domain has already been completely deleted.

", - "resultWrapper":"DeleteDomainResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - } - ], - "documentation":"

Permanently deletes a search domain and all of its data.

" - }, - "DeleteIndexField":{ - "name":"DeleteIndexField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIndexFieldRequest"}, - "output":{ - "shape":"DeleteIndexFieldResponse", - "documentation":"

A response message that contains the status of a deleted index field.

", - "resultWrapper":"DeleteIndexFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Removes an IndexField from the search domain.

" - }, - "DeleteRankExpression":{ - "name":"DeleteRankExpression", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRankExpressionRequest"}, - "output":{ - "shape":"DeleteRankExpressionResponse", - "documentation":"

A response message that contains the status of a deleted RankExpression.

", - "resultWrapper":"DeleteRankExpressionResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Removes a RankExpression from the search domain.

" - }, - "DescribeAvailabilityOptions":{ - "name":"DescribeAvailabilityOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeAvailabilityOptionsRequest", - "documentation":"

Container for the parameters to the DescribeAvailabilityOptions operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeAvailabilityOptionsResponse", - "documentation":"

The result of a DescribeAvailabilityOptions request. Indicates whether or not the Multi-AZ option is enabled for the domain specified in the request.

", - "resultWrapper":"DescribeAvailabilityOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"DisabledOperationException", - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - } - ], - "documentation":"

Gets the availability options configured for a domain. By default, shows the configuration with any pending changes. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeDefaultSearchField":{ - "name":"DescribeDefaultSearchField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDefaultSearchFieldRequest"}, - "output":{ - "shape":"DescribeDefaultSearchFieldResponse", - "documentation":"

A response message that contains the default search field for a search domain.

", - "resultWrapper":"DescribeDefaultSearchFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the default search field configured for the search domain.

" - }, - "DescribeDomains":{ - "name":"DescribeDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDomainsRequest"}, - "output":{ - "shape":"DescribeDomainsResponse", - "documentation":"

A response message that contains the status of one or more domains.

", - "resultWrapper":"DescribeDomainsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - } - ], - "documentation":"

Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default.

" - }, - "DescribeIndexFields":{ - "name":"DescribeIndexFields", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIndexFieldsRequest"}, - "output":{ - "shape":"DescribeIndexFieldsResponse", - "documentation":"

A response message that contains the index fields for a search domain.

", - "resultWrapper":"DescribeIndexFieldsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets information about the index fields configured for the search domain. Can be limited to specific fields by name. Shows all fields by default.

" - }, - "DescribeRankExpressions":{ - "name":"DescribeRankExpressions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRankExpressionsRequest"}, - "output":{ - "shape":"DescribeRankExpressionsResponse", - "documentation":"

A response message that contains the rank expressions for a search domain.

", - "resultWrapper":"DescribeRankExpressionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the rank expressions configured for the search domain. Can be limited to specific rank expressions by name. Shows all rank expressions by default.

" - }, - "DescribeServiceAccessPolicies":{ - "name":"DescribeServiceAccessPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServiceAccessPoliciesRequest"}, - "output":{ - "shape":"DescribeServiceAccessPoliciesResponse", - "documentation":"

A response message that contains the access policies for a domain.

", - "resultWrapper":"DescribeServiceAccessPoliciesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets information about the resource-based policies that control access to the domain's document and search services.

" - }, - "DescribeStemmingOptions":{ - "name":"DescribeStemmingOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStemmingOptionsRequest"}, - "output":{ - "shape":"DescribeStemmingOptionsResponse", - "documentation":"

A response message that contains the stemming options for a search domain.

", - "resultWrapper":"DescribeStemmingOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the stemming dictionary configured for the search domain.

" - }, - "DescribeStopwordOptions":{ - "name":"DescribeStopwordOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStopwordOptionsRequest"}, - "output":{ - "shape":"DescribeStopwordOptionsResponse", - "documentation":"

A response message that contains the stopword options for a search domain.

", - "resultWrapper":"DescribeStopwordOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the stopwords configured for the search domain.

" - }, - "DescribeSynonymOptions":{ - "name":"DescribeSynonymOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSynonymOptionsRequest"}, - "output":{ - "shape":"DescribeSynonymOptionsResponse", - "documentation":"

A response message that contains the synonym options for a search domain.

", - "resultWrapper":"DescribeSynonymOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the synonym dictionary configured for the search domain.

" - }, - "IndexDocuments":{ - "name":"IndexDocuments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IndexDocumentsRequest"}, - "output":{ - "shape":"IndexDocumentsResponse", - "documentation":"

The result of an IndexDocuments action.

", - "resultWrapper":"IndexDocumentsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Tells the search domain to start indexing its documents using the latest text processing options and IndexFields. This operation must be invoked to make options whose OptionStatus has OptionState of RequiresIndexDocuments visible in search results.

" - }, - "UpdateAvailabilityOptions":{ - "name":"UpdateAvailabilityOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"UpdateAvailabilityOptionsRequest", - "documentation":"

Container for the parameters to the UpdateAvailabilityOptions operation. Specifies the name of the domain you want to update and the Multi-AZ availability option.

" - }, - "output":{ - "shape":"UpdateAvailabilityOptionsResponse", - "documentation":"

The result of a UpdateAvailabilityOptions request. Contains the status of the domain's availability options.

", - "resultWrapper":"UpdateAvailabilityOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"DisabledOperationException", - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - } - ], - "documentation":"

Configures the availability options for a domain. Enabling the Multi-AZ option expands an Amazon CloudSearch domain to an additional Availability Zone in the same Region to increase fault tolerance in the event of a service disruption. Changes to the Multi-AZ option can take about half an hour to become active. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

" - }, - "UpdateDefaultSearchField":{ - "name":"UpdateDefaultSearchField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDefaultSearchFieldRequest"}, - "output":{ - "shape":"UpdateDefaultSearchFieldResponse", - "documentation":"

A response message that contains the status of an updated default search field.

", - "resultWrapper":"UpdateDefaultSearchFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures the default search field for the search domain. The default search field is the text field that is searched when a search request does not specify which fields to search. By default, it is configured to include the contents of all of the domain's text fields.

" - }, - "UpdateServiceAccessPolicies":{ - "name":"UpdateServiceAccessPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServiceAccessPoliciesRequest"}, - "output":{ - "shape":"UpdateServiceAccessPoliciesResponse", - "documentation":"

A response message that contains the status of updated access policies.

", - "resultWrapper":"UpdateServiceAccessPoliciesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - } - ], - "documentation":"

Configures the policies that control access to the domain's document and search services. The maximum size of an access policy document is 100 KB.

" - }, - "UpdateStemmingOptions":{ - "name":"UpdateStemmingOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStemmingOptionsRequest"}, - "output":{ - "shape":"UpdateStemmingOptionsResponse", - "documentation":"

A response message that contains the status of updated stemming options.

", - "resultWrapper":"UpdateStemmingOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures a stemming dictionary for the search domain. The stemming dictionary is used during indexing and when processing search requests. The maximum size of the stemming dictionary is 500 KB.

" - }, - "UpdateStopwordOptions":{ - "name":"UpdateStopwordOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStopwordOptionsRequest"}, - "output":{ - "shape":"UpdateStopwordOptionsResponse", - "documentation":"

A response message that contains the status of updated stopword options.

", - "resultWrapper":"UpdateStopwordOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures stopwords for the search domain. Stopwords are used during indexing and when processing search requests. The maximum size of the stopwords dictionary is 10 KB.

" - }, - "UpdateSynonymOptions":{ - "name":"UpdateSynonymOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSynonymOptionsRequest"}, - "output":{ - "shape":"UpdateSynonymOptionsResponse", - "documentation":"

A response message that contains the status of updated synonym options.

", - "resultWrapper":"UpdateSynonymOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures a synonym dictionary for the search domain. The synonym dictionary is used during indexing to configure mappings for terms that occur in text fields. The maximum size of the synonym dictionary is 100 KB.

" - } - }, - "shapes":{ - "AccessPoliciesStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"PolicyDocument"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

A PolicyDocument that specifies access policies for the search domain's services, and the current status of those policies.

" - }, - "Arn":{ - "type":"string", - "documentation":"

An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.

" - }, - "AvailabilityOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"MultiAZ", - "documentation":"

The availability options configured for the domain.

" - }, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The status and configuration of the domain's availability options.

" - }, - "BaseException":{ - "type":"structure", - "members":{ - "Code":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - "Boolean":{"type":"boolean"}, - "CreateDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "CreateDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{"shape":"DomainStatus"} - }, - "documentation":"

A response message that contains the status of a newly created domain.

" - }, - "DefaultSearchFieldStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"FieldName", - "documentation":"

The name of the IndexField to use as the default search field. The default is an empty string, which automatically searches all text fields.

" - }, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of the DefaultSearchField configured for this search domain and its current status.

" - }, - "DefineIndexFieldRequest":{ - "type":"structure", - "required":[ - "DomainName", - "IndexField" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "IndexField":{"shape":"IndexField"} - } - }, - "DefineIndexFieldResponse":{ - "type":"structure", - "required":["IndexField"], - "members":{ - "IndexField":{"shape":"IndexFieldStatus"} - }, - "documentation":"

A response message that contains the status of an updated index field.

" - }, - "DefineRankExpressionRequest":{ - "type":"structure", - "required":[ - "DomainName", - "RankExpression" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "RankExpression":{"shape":"NamedRankExpression"} - } - }, - "DefineRankExpressionResponse":{ - "type":"structure", - "required":["RankExpression"], - "members":{ - "RankExpression":{"shape":"RankExpressionStatus"} - }, - "documentation":"

A response message that contains the status of an updated RankExpression.

" - }, - "DeleteDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DeleteDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{"shape":"DomainStatus"} - }, - "documentation":"

A response message that contains the status of a newly deleted domain, or no status if the domain has already been completely deleted.

" - }, - "DeleteIndexFieldRequest":{ - "type":"structure", - "required":[ - "DomainName", - "IndexFieldName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "IndexFieldName":{"shape":"FieldName"} - } - }, - "DeleteIndexFieldResponse":{ - "type":"structure", - "required":["IndexField"], - "members":{ - "IndexField":{"shape":"IndexFieldStatus"} - }, - "documentation":"

A response message that contains the status of a deleted index field.

" - }, - "DeleteRankExpressionRequest":{ - "type":"structure", - "required":[ - "DomainName", - "RankName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "RankName":{ - "shape":"FieldName", - "documentation":"

The name of the RankExpression to delete.

" - } - } - }, - "DeleteRankExpressionResponse":{ - "type":"structure", - "required":["RankExpression"], - "members":{ - "RankExpression":{"shape":"RankExpressionStatus"} - }, - "documentation":"

A response message that contains the status of a deleted RankExpression.

" - }, - "DescribeAvailabilityOptionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - } - }, - "documentation":"

Container for the parameters to the DescribeAvailabilityOptions operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeAvailabilityOptionsResponse":{ - "type":"structure", - "members":{ - "AvailabilityOptions":{ - "shape":"AvailabilityOptionsStatus", - "documentation":"

The availability options configured for the domain. Indicates whether Multi-AZ is enabled for the domain.

" - } - }, - "documentation":"

The result of a DescribeAvailabilityOptions request. Indicates whether or not the Multi-AZ option is enabled for the domain specified in the request.

" - }, - "DescribeDefaultSearchFieldRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DescribeDefaultSearchFieldResponse":{ - "type":"structure", - "required":["DefaultSearchField"], - "members":{ - "DefaultSearchField":{ - "shape":"DefaultSearchFieldStatus", - "documentation":"

The name of the IndexField to use for search requests issued with the q parameter. The default is the empty string, which automatically searches all text fields.

" - } - }, - "documentation":"

A response message that contains the default search field for a search domain.

" - }, - "DescribeDomainsRequest":{ - "type":"structure", - "members":{ - "DomainNames":{ - "shape":"DomainNameList", - "documentation":"

Limits the DescribeDomains response to the specified search domains.

" - } - } - }, - "DescribeDomainsResponse":{ - "type":"structure", - "required":["DomainStatusList"], - "members":{ - "DomainStatusList":{"shape":"DomainStatusList"} - }, - "documentation":"

A response message that contains the status of one or more domains.

" - }, - "DescribeIndexFieldsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"}, - "FieldNames":{ - "shape":"FieldNameList", - "documentation":"

Limits the DescribeIndexFields response to the specified fields.

" - } - } - }, - "DescribeIndexFieldsResponse":{ - "type":"structure", - "required":["IndexFields"], - "members":{ - "IndexFields":{ - "shape":"IndexFieldStatusList", - "documentation":"

The index fields configured for the domain.

" - } - }, - "documentation":"

A response message that contains the index fields for a search domain.

" - }, - "DescribeRankExpressionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"}, - "RankNames":{ - "shape":"FieldNameList", - "documentation":"

Limits the DescribeRankExpressions response to the specified fields.

" - } - } - }, - "DescribeRankExpressionsResponse":{ - "type":"structure", - "required":["RankExpressions"], - "members":{ - "RankExpressions":{ - "shape":"RankExpressionStatusList", - "documentation":"

The rank expressions configured for the domain.

" - } - }, - "documentation":"

A response message that contains the rank expressions for a search domain.

" - }, - "DescribeServiceAccessPoliciesRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DescribeServiceAccessPoliciesResponse":{ - "type":"structure", - "required":["AccessPolicies"], - "members":{ - "AccessPolicies":{"shape":"AccessPoliciesStatus"} - }, - "documentation":"

A response message that contains the access policies for a domain.

" - }, - "DescribeStemmingOptionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DescribeStemmingOptionsResponse":{ - "type":"structure", - "required":["Stems"], - "members":{ - "Stems":{"shape":"StemmingOptionsStatus"} - }, - "documentation":"

A response message that contains the stemming options for a search domain.

" - }, - "DescribeStopwordOptionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DescribeStopwordOptionsResponse":{ - "type":"structure", - "required":["Stopwords"], - "members":{ - "Stopwords":{"shape":"StopwordOptionsStatus"} - }, - "documentation":"

A response message that contains the stopword options for a search domain.

" - }, - "DescribeSynonymOptionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "DescribeSynonymOptionsResponse":{ - "type":"structure", - "required":["Synonyms"], - "members":{ - "Synonyms":{"shape":"SynonymOptionsStatus"} - }, - "documentation":"

A response message that contains the synonym options for a search domain.

" - }, - "DisabledOperationException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - }, - "DocumentCount":{ - "type":"long", - "min":0 - }, - "DomainId":{ - "type":"string", - "min":1, - "max":64, - "documentation":"

An internally generated unique identifier for a domain.

" - }, - "DomainName":{ - "type":"string", - "min":3, - "max":28, - "pattern":"[a-z][a-z0-9\\-]+", - "documentation":"

A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.

" - }, - "DomainNameList":{ - "type":"list", - "member":{"shape":"DomainName"}, - "documentation":"

A list of domain names.

" - }, - "DomainStatus":{ - "type":"structure", - "required":[ - "DomainId", - "DomainName", - "RequiresIndexDocuments" - ], - "members":{ - "DomainId":{"shape":"DomainId"}, - "DomainName":{"shape":"DomainName"}, - "Created":{ - "shape":"Boolean", - "documentation":"

True if the search domain is created. It can take several minutes to initialize a domain when CreateDomain is called. Newly created search domains are returned from DescribeDomains with a false value for Created until domain creation is complete.

" - }, - "Deleted":{ - "shape":"Boolean", - "documentation":"

True if the search domain has been deleted. The system must clean up resources dedicated to the search domain when DeleteDomain is called. Newly deleted search domains are returned from DescribeDomains with a true value for IsDeleted for several minutes until resource cleanup is complete.

" - }, - "NumSearchableDocs":{ - "shape":"DocumentCount", - "documentation":"

The number of documents that have been submitted to the domain and indexed.

" - }, - "DocService":{ - "shape":"ServiceEndpoint", - "documentation":"

The service endpoint for updating documents in a search domain.

" - }, - "SearchService":{ - "shape":"ServiceEndpoint", - "documentation":"

The service endpoint for requesting search results from a search domain.

" - }, - "RequiresIndexDocuments":{ - "shape":"Boolean", - "documentation":"

True if IndexDocuments needs to be called to activate the current domain configuration.

" - }, - "Processing":{ - "shape":"Boolean", - "documentation":"

True if processing is being done to activate the current domain configuration.

" - }, - "SearchInstanceType":{ - "shape":"SearchInstanceType", - "documentation":"

The instance type (such as search.m1.small) that is being used to process search requests.

" - }, - "SearchPartitionCount":{ - "shape":"PartitionCount", - "documentation":"

The number of partitions across which the search index is spread.

" - }, - "SearchInstanceCount":{ - "shape":"InstanceCount", - "documentation":"

The number of search instances that are available to process search requests.

" - } - }, - "documentation":"

The current status of the search domain.

" - }, - "DomainStatusList":{ - "type":"list", - "member":{"shape":"DomainStatus"}, - "documentation":"

The current status of all of your search domains.

" - }, - "ErrorCode":{ - "type":"string", - "documentation":"

A machine-parsable string error or warning code.

" - }, - "ErrorMessage":{ - "type":"string", - "documentation":"

A human-readable string error or warning message.

" - }, - "FieldName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-z][a-z0-9_]*", - "documentation":"

A string that represents the name of an index field. Field names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Uppercase letters and hyphens are not allowed. The names \"body\", \"docid\", and \"text_relevance\" are reserved and cannot be specified as field or rank expression names.

" - }, - "FieldNameList":{ - "type":"list", - "member":{"shape":"FieldName"} - }, - "FieldValue":{ - "type":"string", - "min":0, - "max":1024, - "documentation":"

The value of a field or source document attribute.

" - }, - "IndexDocumentsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - } - }, - "IndexDocumentsResponse":{ - "type":"structure", - "members":{ - "FieldNames":{ - "shape":"FieldNameList", - "documentation":"

The names of the fields that are currently being processed due to an IndexDocuments action.

" - } - }, - "documentation":"

The result of an IndexDocuments action.

" - }, - "IndexField":{ - "type":"structure", - "required":[ - "IndexFieldName", - "IndexFieldType" - ], - "members":{ - "IndexFieldName":{ - "shape":"FieldName", - "documentation":"

The name of a field in the search index. Field names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Uppercase letters and hyphens are not allowed. The names \"body\", \"docid\", and \"text_relevance\" are reserved and cannot be specified as field or rank expression names.

" - }, - "IndexFieldType":{ - "shape":"IndexFieldType", - "documentation":"

The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.

" - }, - "UIntOptions":{ - "shape":"UIntOptions", - "documentation":"

Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.

" - }, - "LiteralOptions":{ - "shape":"LiteralOptions", - "documentation":"

Options for literal field. Present if IndexFieldType specifies the field is of type literal.

" - }, - "TextOptions":{ - "shape":"TextOptions", - "documentation":"

Options for text field. Present if IndexFieldType specifies the field is of type text.

" - }, - "SourceAttributes":{ - "shape":"SourceAttributeList", - "documentation":"

An optional list of source attributes that provide data for this index field. If not specified, the data is pulled from a source attribute with the same name as this IndexField. When one or more source attributes are specified, an optional data transformation can be applied to the source data when populating the index field. You can configure a maximum of 20 sources for an IndexField.

" - } - }, - "documentation":"

Defines a field in the index, including its name, type, and the source of its data. The IndexFieldType indicates which of the options will be present. It is invalid to specify options for a type other than the IndexFieldType.

" - }, - "IndexFieldStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"IndexField"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of an IndexField and its current status.

" - }, - "IndexFieldStatusList":{ - "type":"list", - "member":{"shape":"IndexFieldStatus"} - }, - "IndexFieldType":{ - "type":"string", - "enum":[ - "uint", - "literal", - "text" - ], - "documentation":"

The type of IndexField.

" - }, - "InstanceCount":{ - "type":"integer", - "min":1 - }, - "InternalException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - "InvalidTypeException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - "Language":{ - "type":"string", - "pattern":"[a-zA-Z]{2,8}(?:-[a-zA-Z]{2,8})*", - "documentation":"

An IETF RFC 4646 language code. Only the primary language is considered. English (en) is currently the only supported language.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - "LiteralOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"

The default value for a literal field. Optional.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether search is enabled for this field. Default: False.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether facets are enabled for this field. Default: False.

" - }, - "ResultEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether values of this field can be returned in search results and used for ranking. Default: False.

" - } - }, - "documentation":"

Options that define a literal field in the search index.

" - }, - "MultiAZ":{"type":"boolean"}, - "NamedRankExpression":{ - "type":"structure", - "required":[ - "RankName", - "RankExpression" - ], - "members":{ - "RankName":{ - "shape":"FieldName", - "documentation":"

The name of a rank expression. Rank expression names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Uppercase letters and hyphens are not allowed. The names \"body\", \"docid\", and \"text_relevance\" are reserved and cannot be specified as field or rank expression names.

" - }, - "RankExpression":{ - "shape":"RankExpression", - "documentation":"

The expression to evaluate for ranking or thresholding while processing a search request. The RankExpression syntax is based on JavaScript expressions and supports:

  • Integer, floating point, hex and octal literals
  • Shortcut evaluation of logical operators such that an expression a || b evaluates to the value a, if a is true, without evaluating b at all
  • JavaScript order of precedence for operators
  • Arithmetic operators: + - * / %
  • Boolean operators (including the ternary operator)
  • Bitwise operators
  • Comparison operators
  • Common mathematic functions: abs ceil erf exp floor lgamma ln log2 log10 max min sqrt pow
  • Trigonometric library functions: acosh acos asinh asin atanh atan cosh cos sinh sin tanh tan
  • Random generation of a number between 0 and 1: rand
  • Current time in epoch: time
  • The min max functions that operate on a variable argument list

Intermediate results are calculated as double precision floating point values. The final return value of a RankExpression is automatically converted from floating point to a 32-bit unsigned integer by rounding to the nearest integer, with a natural floor of 0 and a ceiling of max(uint32_t), 4294967295. Mathematical errors such as dividing by 0 will fail during evaluation and return a value of 0.

The source data for a RankExpression can be the name of an IndexField of type uint, another RankExpression or the reserved name text_relevance. The text_relevance source is defined to return an integer from 0 to 1000 (inclusive) to indicate how relevant a document is to the search request, taking into account repetition of search terms in the document and proximity of search terms to each other in each matching IndexField in the document.

For more information about using rank expressions to customize ranking, see the Amazon CloudSearch Developer Guide.

" - } - }, - "documentation":"

A named expression that can be evaluated at search time and used for ranking or thresholding in a search query.

" - }, - "OptionState":{ - "type":"string", - "enum":[ - "RequiresIndexDocuments", - "Processing", - "Active" - ], - "documentation":"

The state of processing a change to an option.

" - }, - "OptionStatus":{ - "type":"structure", - "required":[ - "CreationDate", - "UpdateDate", - "State" - ], - "members":{ - "CreationDate":{ - "shape":"UpdateTimestamp", - "documentation":"

A timestamp for when this option was created.

" - }, - "UpdateDate":{ - "shape":"UpdateTimestamp", - "documentation":"

A timestamp for when this option was last updated.

" - }, - "UpdateVersion":{ - "shape":"UIntValue", - "documentation":"

A unique integer that indicates when this option was last updated.

" - }, - "State":{ - "shape":"OptionState", - "documentation":"

The state of processing a change to an option. Possible values:

  • RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
  • Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
  • Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
" - }, - "PendingDeletion":{ - "shape":"Boolean", - "documentation":"

Indicates that the option will be deleted once processing is complete.

" - } - }, - "documentation":"

The status of an option, including when it was last updated and whether it is actively in use for searches.

" - }, - "PartitionCount":{ - "type":"integer", - "min":1 - }, - "PolicyDocument":{ - "type":"string", - "documentation":"

An IAM access policy as described in The Access Policy Language in Using AWS Identity and Access Management. The maximum size of an access policy document is 100 KB.

Example: {\"Statement\": [{\"Effect\":\"Allow\", \"Action\": \"*\", \"Resource\": \"arn:aws:cs:us-east-1:1234567890:search/movies\", \"Condition\": { \"IpAddress\": { \"aws:SourceIp\": [\"203.0.113.1/32\"] } }}, {\"Effect\":\"Allow\", \"Action\": \"*\", \"Resource\": \"arn:aws:cs:us-east-1:1234567890:documents/movies\", \"Condition\": { \"IpAddress\": { \"aws:SourceIp\": [\"203.0.113.1/32\"] } }} ] }

" - }, - "RankExpression":{ - "type":"string", - "min":1, - "max":10240, - "documentation":"

The current status of the rank expression.

" - }, - "RankExpressionStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"NamedRankExpression", - "documentation":"

The expression that is evaluated for ranking or thresholding while processing a search request.

" - }, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of a RankExpression and its current status.

" - }, - "RankExpressionStatusList":{ - "type":"list", - "member":{"shape":"RankExpressionStatus"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - "SearchInstanceType":{"type":"string"}, - "ServiceEndpoint":{ - "type":"structure", - "members":{ - "Arn":{"shape":"Arn"}, - "Endpoint":{"shape":"ServiceUrl"} - }, - "documentation":"

The endpoint to which service requests can be submitted, including the actual URL prefix for sending requests and the Amazon Resource Name (ARN) so the endpoint can be referenced in other API calls such as UpdateServiceAccessPolicies.

" - }, - "ServiceUrl":{ - "type":"string", - "documentation":"

The URL (including /version/pathPrefix) to which service requests can be submitted.

" - }, - "SourceAttribute":{ - "type":"structure", - "required":["SourceDataFunction"], - "members":{ - "SourceDataFunction":{ - "shape":"SourceDataFunction", - "documentation":"

Identifies the transformation to apply when copying data from a source attribute.

" - }, - "SourceDataCopy":{ - "shape":"SourceData", - "documentation":"

Copies data from a source document attribute to an IndexField.

" - }, - "SourceDataTrimTitle":{ - "shape":"SourceDataTrimTitle", - "documentation":"

Trims common title words from a source document attribute when populating an IndexField. This can be used to create an IndexField you can use for sorting.

" - }, - "SourceDataMap":{ - "shape":"SourceDataMap", - "documentation":"

Maps source document attribute values to new values when populating the IndexField.

" - } - }, - "documentation":"

Identifies the source data for an index field. An optional data transformation can be applied to the source data when populating the index field. By default, the value of the source attribute is copied to the index field.

" - }, - "SourceAttributeList":{ - "type":"list", - "member":{"shape":"SourceAttribute"} - }, - "SourceData":{ - "type":"structure", - "required":["SourceName"], - "members":{ - "SourceName":{ - "shape":"FieldName", - "documentation":"

The name of the document source field to add to this IndexField.

" - }, - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"

The default value to use if the source attribute is not specified in a document. Optional.

" - } - }, - "documentation":"

The source attribute name and an optional default value to use if a document doesn't have an attribute of that name.

" - }, - "SourceDataFunction":{ - "type":"string", - "enum":[ - "Copy", - "TrimTitle", - "Map" - ] - }, - "SourceDataMap":{ - "type":"structure", - "required":["SourceName"], - "members":{ - "SourceName":{ - "shape":"FieldName", - "documentation":"

The name of the document source field to add to this IndexField.

" - }, - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"

The default value to use if the source attribute is not specified in a document. Optional.

" - }, - "Cases":{ - "shape":"StringCaseMap", - "documentation":"

A map that translates source field values to custom values.

" - } - }, - "documentation":"

Specifies how to map source attribute values to custom values when populating an IndexField.

" - }, - "SourceDataTrimTitle":{ - "type":"structure", - "required":["SourceName"], - "members":{ - "SourceName":{ - "shape":"FieldName", - "documentation":"

The name of the document source field to add to this IndexField.

" - }, - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"

The default value to use if the source attribute is not specified in a document. Optional.

" - }, - "Separator":{ - "shape":"String", - "documentation":"

The separator that follows the text to trim.

" - }, - "Language":{"shape":"Language"} - }, - "documentation":"

Specifies how to trim common words from the beginning of a field to enable title sorting by that field.

" - }, - "StemmingOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"StemsDocument"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The stemming options configured for this search domain and the current status of those options.

" - }, - "StemsDocument":{ - "type":"string", - "documentation":"

Maps terms to their stems, serialized as a JSON document. The document has a single object with one property \"stems\" whose value is an object mapping terms to their stems. The maximum size of a stemming document is 500 KB. Example: { \"stems\": {\"people\": \"person\", \"walking\": \"walk\"} }

" - }, - "StopwordOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"StopwordsDocument"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The stopword options configured for this search domain and the current status of those options.

" - }, - "StopwordsDocument":{ - "type":"string", - "documentation":"

Lists stopwords serialized as a JSON document. The document has a single object with one property \"stopwords\" whose value is an array of strings. The maximum size of a stopwords document is 10 KB. Example: { \"stopwords\": [\"a\", \"an\", \"the\", \"of\"] }

" - }, - "String":{"type":"string"}, - "StringCaseMap":{ - "type":"map", - "key":{"shape":"FieldValue"}, - "value":{"shape":"FieldValue"} - }, - "SynonymOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"SynonymsDocument"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The synonym options configured for this search domain and the current status of those options.

" - }, - "SynonymsDocument":{ - "type":"string", - "documentation":"

Maps terms to their synonyms, serialized as a JSON document. The document has a single object with one property \"synonyms\" whose value is an object mapping terms to their synonyms. Each synonym is a simple string or an array of strings. The maximum size of a stopwords document is 100 KB. Example: { \"synonyms\": {\"cat\": [\"feline\", \"kitten\"], \"puppy\": \"dog\"} }

" - }, - "TextOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"

The default value for a text field. Optional.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether facets are enabled for this field. Default: False.

" - }, - "ResultEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether values of this field can be returned in search results and used for ranking. Default: False.

" - }, - "TextProcessor":{ - "shape":"FieldName", - "documentation":"

The text processor to apply to this field. Optional. Possible values:

  • cs_text_no_stemming: turns off stemming for the field.

Default: none

" - } - }, - "documentation":"

Options that define a text field in the search index.

" - }, - "UIntOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"UIntValue", - "documentation":"

The default value for an unsigned integer field. Optional.

" - } - }, - "documentation":"

Options that define a uint field in the search index.

" - }, - "UIntValue":{ - "type":"integer", - "min":0 - }, - "UpdateAvailabilityOptionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "MultiAZ" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

You expand an existing search domain to a second Availability Zone by setting the Multi-AZ option to true. Similarly, you can turn off the Multi-AZ option to downgrade the domain to a single Availability Zone by setting the Multi-AZ option to false.

" - } - }, - "documentation":"

Container for the parameters to the UpdateAvailabilityOptions operation. Specifies the name of the domain you want to update and the Multi-AZ availability option.

" - }, - "UpdateAvailabilityOptionsResponse":{ - "type":"structure", - "members":{ - "AvailabilityOptions":{ - "shape":"AvailabilityOptionsStatus", - "documentation":"

The newly-configured availability options. Indicates whether Multi-AZ is enabled for the domain.

" - } - }, - "documentation":"

The result of a UpdateAvailabilityOptions request. Contains the status of the domain's availability options.

" - }, - "UpdateDefaultSearchFieldRequest":{ - "type":"structure", - "required":[ - "DomainName", - "DefaultSearchField" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "DefaultSearchField":{ - "shape":"String", - "documentation":"

The text field to search if the search request does not specify which field to search. The default search field is used when search terms are specified with the q parameter, or if a match expression specified with the bq parameter does not constrain the search to a particular field. The default is an empty string, which automatically searches all text fields.

" - } - } - }, - "UpdateDefaultSearchFieldResponse":{ - "type":"structure", - "required":["DefaultSearchField"], - "members":{ - "DefaultSearchField":{"shape":"DefaultSearchFieldStatus"} - }, - "documentation":"

A response message that contains the status of an updated default search field.

" - }, - "UpdateServiceAccessPoliciesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "AccessPolicies" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "AccessPolicies":{"shape":"PolicyDocument"} - } - }, - "UpdateServiceAccessPoliciesResponse":{ - "type":"structure", - "required":["AccessPolicies"], - "members":{ - "AccessPolicies":{"shape":"AccessPoliciesStatus"} - }, - "documentation":"

A response message that contains the status of updated access policies.

" - }, - "UpdateStemmingOptionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Stems" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "Stems":{"shape":"StemsDocument"} - } - }, - "UpdateStemmingOptionsResponse":{ - "type":"structure", - "required":["Stems"], - "members":{ - "Stems":{"shape":"StemmingOptionsStatus"} - }, - "documentation":"

A response message that contains the status of updated stemming options.

" - }, - "UpdateStopwordOptionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Stopwords" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "Stopwords":{"shape":"StopwordsDocument"} - } - }, - "UpdateStopwordOptionsResponse":{ - "type":"structure", - "required":["Stopwords"], - "members":{ - "Stopwords":{"shape":"StopwordOptionsStatus"} - }, - "documentation":"

A response message that contains the status of updated stopword options.

" - }, - "UpdateSynonymOptionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Synonyms" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "Synonyms":{"shape":"SynonymsDocument"} - } - }, - "UpdateSynonymOptionsResponse":{ - "type":"structure", - "required":["Synonyms"], - "members":{ - "Synonyms":{"shape":"SynonymOptionsStatus"} - }, - "documentation":"

A response message that contains the status of updated synonym options.

" - }, - "UpdateTimestamp":{"type":"timestamp"} - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/service-2.json deleted file mode 100644 index 6c232754..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearch/2013-01-01/service-2.json +++ /dev/null @@ -1,2707 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-01-01", - "endpointPrefix":"cloudsearch", - "serviceFullName":"Amazon CloudSearch", - "serviceId":"CloudSearch", - "signatureVersion":"v4", - "xmlNamespace":"http://cloudsearch.amazonaws.com/doc/2013-01-01/", - "protocol":"query", - "uid":"cloudsearch-2013-01-01" - }, - "documentation":"Amazon CloudSearch Configuration Service

You use the Amazon CloudSearch configuration service to create, configure, and manage search domains. Configuration service requests are submitted using the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted via HTTP GET or POST with a query parameter named Action.

The endpoint for configuration service requests is region-specific: cloudsearch.region.amazonaws.com. For example, cloudsearch.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints.

", - "operations":{ - "BuildSuggesters":{ - "name":"BuildSuggesters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"BuildSuggestersRequest", - "documentation":"

Container for the parameters to the BuildSuggester operation. Specifies the name of the domain you want to update.

" - }, - "output":{ - "shape":"BuildSuggestersResponse", - "documentation":"

The result of a BuildSuggester request. Contains a list of the fields used for suggestions.

", - "resultWrapper":"BuildSuggestersResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Indexes the search suggestions. For more information, see Configuring Suggesters in the Amazon CloudSearch Developer Guide.

" - }, - "CreateDomain":{ - "name":"CreateDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDomainRequest", - "documentation":"

Container for the parameters to the CreateDomain operation. Specifies a name for the new search domain.

" - }, - "output":{ - "shape":"CreateDomainResponse", - "documentation":"

The result of a CreateDomainRequest. Contains the status of a newly created domain.

", - "resultWrapper":"CreateDomainResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - } - ], - "documentation":"

Creates a new search domain. For more information, see Creating a Search Domain in the Amazon CloudSearch Developer Guide.

" - }, - "DefineAnalysisScheme":{ - "name":"DefineAnalysisScheme", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DefineAnalysisSchemeRequest", - "documentation":"

Container for the parameters to the DefineAnalysisScheme operation. Specifies the name of the domain you want to update and the analysis scheme configuration.

" - }, - "output":{ - "shape":"DefineAnalysisSchemeResponse", - "documentation":"

The result of a DefineAnalysisScheme request. Contains the status of the newly-configured analysis scheme.

", - "resultWrapper":"DefineAnalysisSchemeResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures an analysis scheme that can be applied to a text or text-array field to define language-specific text processing options. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

" - }, - "DefineExpression":{ - "name":"DefineExpression", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DefineExpressionRequest", - "documentation":"

Container for the parameters to the DefineExpression operation. Specifies the name of the domain you want to update and the expression you want to configure.

" - }, - "output":{ - "shape":"DefineExpressionResponse", - "documentation":"

The result of a DefineExpression request. Contains the status of the newly-configured expression.

", - "resultWrapper":"DefineExpressionResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures an Expression for the search domain. Used to create new expressions and modify existing ones. If the expression exists, the new configuration replaces the old one. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

" - }, - "DefineIndexField":{ - "name":"DefineIndexField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DefineIndexFieldRequest", - "documentation":"

Container for the parameters to the DefineIndexField operation. Specifies the name of the domain you want to update and the index field configuration.

" - }, - "output":{ - "shape":"DefineIndexFieldResponse", - "documentation":"

The result of a DefineIndexField request. Contains the status of the newly-configured index field.

", - "resultWrapper":"DefineIndexFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures an IndexField for the search domain. Used to create new fields and modify existing ones. You must specify the name of the domain you are configuring and an index field configuration. The index field configuration specifies a unique name, the index field type, and the options you want to configure for the field. The options you can specify depend on the IndexFieldType. If the field exists, the new configuration replaces the old one. For more information, see Configuring Index Fields in the Amazon CloudSearch Developer Guide.

" - }, - "DefineSuggester":{ - "name":"DefineSuggester", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DefineSuggesterRequest", - "documentation":"

Container for the parameters to the DefineSuggester operation. Specifies the name of the domain you want to update and the suggester configuration.

" - }, - "output":{ - "shape":"DefineSuggesterResponse", - "documentation":"

The result of a DefineSuggester request. Contains the status of the newly-configured suggester.

", - "resultWrapper":"DefineSuggesterResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Configures a suggester for a domain. A suggester enables you to display possible matches before users finish typing their queries. When you configure a suggester, you must specify the name of the text field you want to search for possible matches and a unique name for the suggester. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

" - }, - "DeleteAnalysisScheme":{ - "name":"DeleteAnalysisScheme", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteAnalysisSchemeRequest", - "documentation":"

Container for the parameters to the DeleteAnalysisScheme operation. Specifies the name of the domain you want to update and the analysis scheme you want to delete.

" - }, - "output":{ - "shape":"DeleteAnalysisSchemeResponse", - "documentation":"

The result of a DeleteAnalysisScheme request. Contains the status of the deleted analysis scheme.

", - "resultWrapper":"DeleteAnalysisSchemeResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Deletes an analysis scheme. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

" - }, - "DeleteDomain":{ - "name":"DeleteDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDomainRequest", - "documentation":"

Container for the parameters to the DeleteDomain operation. Specifies the name of the domain you want to delete.

" - }, - "output":{ - "shape":"DeleteDomainResponse", - "documentation":"

The result of a DeleteDomain request. Contains the status of a newly deleted domain, or no status if the domain has already been completely deleted.

", - "resultWrapper":"DeleteDomainResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - } - ], - "documentation":"

Permanently deletes a search domain and all of its data. Once a domain has been deleted, it cannot be recovered. For more information, see Deleting a Search Domain in the Amazon CloudSearch Developer Guide.

" - }, - "DeleteExpression":{ - "name":"DeleteExpression", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteExpressionRequest", - "documentation":"

Container for the parameters to the DeleteExpression operation. Specifies the name of the domain you want to update and the name of the expression you want to delete.

" - }, - "output":{ - "shape":"DeleteExpressionResponse", - "documentation":"

The result of a DeleteExpression request. Specifies the expression being deleted.

", - "resultWrapper":"DeleteExpressionResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Removes an Expression from the search domain. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

" - }, - "DeleteIndexField":{ - "name":"DeleteIndexField", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteIndexFieldRequest", - "documentation":"

Container for the parameters to the DeleteIndexField operation. Specifies the name of the domain you want to update and the name of the index field you want to delete.

" - }, - "output":{ - "shape":"DeleteIndexFieldResponse", - "documentation":"

The result of a DeleteIndexField request.

", - "resultWrapper":"DeleteIndexFieldResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Removes an IndexField from the search domain. For more information, see Configuring Index Fields in the Amazon CloudSearch Developer Guide.

" - }, - "DeleteSuggester":{ - "name":"DeleteSuggester", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteSuggesterRequest", - "documentation":"

Container for the parameters to the DeleteSuggester operation. Specifies the name of the domain you want to update and name of the suggester you want to delete.

" - }, - "output":{ - "shape":"DeleteSuggesterResponse", - "documentation":"

The result of a DeleteSuggester request. Contains the status of the deleted suggester.

", - "resultWrapper":"DeleteSuggesterResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Deletes a suggester. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeAnalysisSchemes":{ - "name":"DescribeAnalysisSchemes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeAnalysisSchemesRequest", - "documentation":"

Container for the parameters to the DescribeAnalysisSchemes operation. Specifies the name of the domain you want to describe. To limit the response to particular analysis schemes, specify the names of the analysis schemes you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeAnalysisSchemesResponse", - "documentation":"

The result of a DescribeAnalysisSchemes request. Contains the analysis schemes configured for the domain specified in the request.

", - "resultWrapper":"DescribeAnalysisSchemesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the analysis schemes configured for a domain. An analysis scheme defines language-specific text processing options for a text field. Can be limited to specific analysis schemes by name. By default, shows all analysis schemes and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeAvailabilityOptions":{ - "name":"DescribeAvailabilityOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeAvailabilityOptionsRequest", - "documentation":"

Container for the parameters to the DescribeAvailabilityOptions operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeAvailabilityOptionsResponse", - "documentation":"

The result of a DescribeAvailabilityOptions request. Indicates whether or not the Multi-AZ option is enabled for the domain specified in the request.

", - "resultWrapper":"DescribeAvailabilityOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"DisabledOperationException", - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - } - ], - "documentation":"

Gets the availability options configured for a domain. By default, shows the configuration with any pending changes. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeDomains":{ - "name":"DescribeDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDomainsRequest", - "documentation":"

Container for the parameters to the DescribeDomains operation. By default shows the status of all domains. To restrict the response to particular domains, specify the names of the domains you want to describe.

" - }, - "output":{ - "shape":"DescribeDomainsResponse", - "documentation":"

The result of a DescribeDomains request. Contains the status of the domains specified in the request or all domains owned by the account.

", - "resultWrapper":"DescribeDomainsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - } - ], - "documentation":"

Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default. To get the number of searchable documents in a domain, use the console or submit a matchall request to your domain's search endpoint: q=matchall&amp;q.parser=structured&amp;size=0. For more information, see Getting Information about a Search Domain in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeExpressions":{ - "name":"DescribeExpressions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeExpressionsRequest", - "documentation":"

Container for the parameters to the DescribeDomains operation. Specifies the name of the domain you want to describe. To restrict the response to particular expressions, specify the names of the expressions you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeExpressionsResponse", - "documentation":"

The result of a DescribeExpressions request. Contains the expressions configured for the domain specified in the request.

", - "resultWrapper":"DescribeExpressionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the expressions configured for the search domain. Can be limited to specific expressions by name. By default, shows all expressions and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeIndexFields":{ - "name":"DescribeIndexFields", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeIndexFieldsRequest", - "documentation":"

Container for the parameters to the DescribeIndexFields operation. Specifies the name of the domain you want to describe. To restrict the response to particular index fields, specify the names of the index fields you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeIndexFieldsResponse", - "documentation":"

The result of a DescribeIndexFields request. Contains the index fields configured for the domain specified in the request.

", - "resultWrapper":"DescribeIndexFieldsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets information about the index fields configured for the search domain. Can be limited to specific fields by name. By default, shows all fields and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Getting Domain Information in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeScalingParameters":{ - "name":"DescribeScalingParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeScalingParametersRequest", - "documentation":"

Container for the parameters to the DescribeScalingParameters operation. Specifies the name of the domain you want to describe.

" - }, - "output":{ - "shape":"DescribeScalingParametersResponse", - "documentation":"

The result of a DescribeScalingParameters request. Contains the scaling parameters configured for the domain specified in the request.

", - "resultWrapper":"DescribeScalingParametersResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the scaling parameters configured for a domain. A domain's scaling parameters specify the desired search instance type and replication count. For more information, see Configuring Scaling Options in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeServiceAccessPolicies":{ - "name":"DescribeServiceAccessPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeServiceAccessPoliciesRequest", - "documentation":"

Container for the parameters to the DescribeServiceAccessPolicies operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeServiceAccessPoliciesResponse", - "documentation":"

The result of a DescribeServiceAccessPolicies request.

", - "resultWrapper":"DescribeServiceAccessPoliciesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets information about the access policies that control access to the domain's document and search endpoints. By default, shows the configuration with any pending changes. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Access for a Search Domain in the Amazon CloudSearch Developer Guide.

" - }, - "DescribeSuggesters":{ - "name":"DescribeSuggesters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSuggestersRequest", - "documentation":"

Container for the parameters to the DescribeSuggester operation. Specifies the name of the domain you want to describe. To restrict the response to particular suggesters, specify the names of the suggesters you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "output":{ - "shape":"DescribeSuggestersResponse", - "documentation":"

The result of a DescribeSuggesters request.

", - "resultWrapper":"DescribeSuggestersResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Gets the suggesters configured for a domain. A suggester enables you to display possible matches before users finish typing their queries. Can be limited to specific suggesters by name. By default, shows all suggesters and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

" - }, - "IndexDocuments":{ - "name":"IndexDocuments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"IndexDocumentsRequest", - "documentation":"

Container for the parameters to the IndexDocuments operation. Specifies the name of the domain you want to re-index.

" - }, - "output":{ - "shape":"IndexDocumentsResponse", - "documentation":"

The result of an IndexDocuments request. Contains the status of the indexing operation, including the fields being indexed.

", - "resultWrapper":"IndexDocumentsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - } - ], - "documentation":"

Tells the search domain to start indexing its documents using the latest indexing options. This operation must be invoked to activate options whose OptionStatus is RequiresIndexDocuments.

" - }, - "ListDomainNames":{ - "name":"ListDomainNames", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"ListDomainNamesResponse", - "documentation":"

The result of a ListDomainNames request. Contains a list of the domains owned by an account.

", - "resultWrapper":"ListDomainNamesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - } - ], - "documentation":"

Lists all search domains owned by an account.

" - }, - "UpdateAvailabilityOptions":{ - "name":"UpdateAvailabilityOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"UpdateAvailabilityOptionsRequest", - "documentation":"

Container for the parameters to the UpdateAvailabilityOptions operation. Specifies the name of the domain you want to update and the Multi-AZ availability option.

" - }, - "output":{ - "shape":"UpdateAvailabilityOptionsResponse", - "documentation":"

The result of a UpdateAvailabilityOptions request. Contains the status of the domain's availability options.

", - "resultWrapper":"UpdateAvailabilityOptionsResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"DisabledOperationException", - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - } - ], - "documentation":"

Configures the availability options for a domain. Enabling the Multi-AZ option expands an Amazon CloudSearch domain to an additional Availability Zone in the same Region to increase fault tolerance in the event of a service disruption. Changes to the Multi-AZ option can take about half an hour to become active. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

" - }, - "UpdateScalingParameters":{ - "name":"UpdateScalingParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"UpdateScalingParametersRequest", - "documentation":"

Container for the parameters to the UpdateScalingParameters operation. Specifies the name of the domain you want to update and the scaling parameters you want to configure.

" - }, - "output":{ - "shape":"UpdateScalingParametersResponse", - "documentation":"

The result of a UpdateScalingParameters request. Contains the status of the newly-configured scaling parameters.

", - "resultWrapper":"UpdateScalingParametersResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - } - ], - "documentation":"

Configures scaling parameters for a domain. A domain's scaling parameters specify the desired search instance type and replication count. Amazon CloudSearch will still automatically scale your domain based on the volume of data and traffic, but not below the desired instance type and replication count. If the Multi-AZ option is enabled, these values control the resources used per Availability Zone. For more information, see Configuring Scaling Options in the Amazon CloudSearch Developer Guide.

" - }, - "UpdateServiceAccessPolicies":{ - "name":"UpdateServiceAccessPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"UpdateServiceAccessPoliciesRequest", - "documentation":"

Container for the parameters to the UpdateServiceAccessPolicies operation. Specifies the name of the domain you want to update and the access rules you want to configure.

" - }, - "output":{ - "shape":"UpdateServiceAccessPoliciesResponse", - "documentation":"

The result of an UpdateServiceAccessPolicies request. Contains the new access policies.

", - "resultWrapper":"UpdateServiceAccessPoliciesResult" - }, - "errors":[ - { - "shape":"BaseException", - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - { - "shape":"InternalException", - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - { - "shape":"InvalidTypeException", - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - } - ], - "documentation":"

Configures the access rules that control access to the domain's document and search endpoints. For more information, see Configuring Access for an Amazon CloudSearch Domain.

" - } - }, - "shapes":{ - "APIVersion":{ - "type":"string", - "documentation":"

The Amazon CloudSearch API version for a domain: 2011-02-01 or 2013-01-01.

" - }, - "ARN":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN) of the search domain. See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.

" - }, - "AccessPoliciesStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"PolicyDocument"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The configured access rules for the domain's document and search endpoints, and the current status of those rules.

" - }, - "AlgorithmicStemming":{ - "type":"string", - "enum":[ - "none", - "minimal", - "light", - "full" - ] - }, - "AnalysisOptions":{ - "type":"structure", - "members":{ - "Synonyms":{ - "shape":"String", - "documentation":"

A JSON object that defines synonym groups and aliases. A synonym group is an array of arrays, where each sub-array is a group of terms where each term in the group is considered a synonym of every other term in the group. The aliases value is an object that contains a collection of string:value pairs where the string specifies a term and the array of values specifies each of the aliases for that term. An alias is considered a synonym of the specified term, but the term is not considered a synonym of the alias. For more information about specifying synonyms, see Synonyms in the Amazon CloudSearch Developer Guide.

" - }, - "Stopwords":{ - "shape":"String", - "documentation":"

A JSON array of terms to ignore during indexing and searching. For example, [\"a\", \"an\", \"the\", \"of\"]. The stopwords dictionary must explicitly list each word you want to ignore. Wildcards and regular expressions are not supported.

" - }, - "StemmingDictionary":{ - "shape":"String", - "documentation":"

A JSON object that contains a collection of string:value pairs that each map a term to its stem. For example, {\"term1\": \"stem1\", \"term2\": \"stem2\", \"term3\": \"stem3\"}. The stemming dictionary is applied in addition to any algorithmic stemming. This enables you to override the results of the algorithmic stemming to correct specific cases of overstemming or understemming. The maximum size of a stemming dictionary is 500 KB.

" - }, - "JapaneseTokenizationDictionary":{ - "shape":"String", - "documentation":"

A JSON array that contains a collection of terms, tokens, readings and part of speech for Japanese Tokenizaiton. The Japanese tokenization dictionary enables you to override the default tokenization for selected terms. This is only valid for Japanese language fields.

" - }, - "AlgorithmicStemming":{ - "shape":"AlgorithmicStemming", - "documentation":"

The level of algorithmic stemming to perform: none, minimal, light, or full. The available levels vary depending on the language. For more information, see Language Specific Text Processing Settings in the Amazon CloudSearch Developer Guide

" - } - }, - "documentation":"

Synonyms, stopwords, and stemming options for an analysis scheme. Includes tokenization dictionary for Japanese.

" - }, - "AnalysisScheme":{ - "type":"structure", - "required":[ - "AnalysisSchemeName", - "AnalysisSchemeLanguage" - ], - "members":{ - "AnalysisSchemeName":{"shape":"StandardName"}, - "AnalysisSchemeLanguage":{"shape":"AnalysisSchemeLanguage"}, - "AnalysisOptions":{"shape":"AnalysisOptions"} - }, - "documentation":"

Configuration information for an analysis scheme. Each analysis scheme has a unique name and specifies the language of the text to be processed. The following options can be configured for an analysis scheme: Synonyms, Stopwords, StemmingDictionary, JapaneseTokenizationDictionary and AlgorithmicStemming.

" - }, - "AnalysisSchemeLanguage":{ - "type":"string", - "enum":[ - "ar", - "bg", - "ca", - "cs", - "da", - "de", - "el", - "en", - "es", - "eu", - "fa", - "fi", - "fr", - "ga", - "gl", - "he", - "hi", - "hu", - "hy", - "id", - "it", - "ja", - "ko", - "lv", - "mul", - "nl", - "no", - "pt", - "ro", - "ru", - "sv", - "th", - "tr", - "zh-Hans", - "zh-Hant" - ], - "documentation":"

An IETF RFC 4646 language code or mul for multiple languages.

" - }, - "AnalysisSchemeStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"AnalysisScheme"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The status and configuration of an AnalysisScheme.

" - }, - "AnalysisSchemeStatusList":{ - "type":"list", - "member":{"shape":"AnalysisSchemeStatus"}, - "documentation":"

A list of the analysis schemes configured for a domain.

" - }, - "AvailabilityOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"MultiAZ", - "documentation":"

The availability options configured for the domain.

" - }, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The status and configuration of the domain's availability options.

" - }, - "BaseException":{ - "type":"structure", - "members":{ - "Code":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"

An error occurred while processing the request.

" - }, - "Boolean":{"type":"boolean"}, - "BuildSuggestersRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - }, - "documentation":"

Container for the parameters to the BuildSuggester operation. Specifies the name of the domain you want to update.

" - }, - "BuildSuggestersResponse":{ - "type":"structure", - "members":{ - "FieldNames":{"shape":"FieldNameList"} - }, - "documentation":"

The result of a BuildSuggester request. Contains a list of the fields used for suggestions.

" - }, - "CreateDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

A name for the domain you are creating. Allowed characters are a-z (lower-case letters), 0-9, and hyphen (-). Domain names must start with a letter or number and be at least 3 and no more than 28 characters long.

" - } - }, - "documentation":"

Container for the parameters to the CreateDomain operation. Specifies a name for the new search domain.

" - }, - "CreateDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{"shape":"DomainStatus"} - }, - "documentation":"

The result of a CreateDomainRequest. Contains the status of a newly created domain.

" - }, - "DateArrayOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceFields":{ - "shape":"FieldNameCommaList", - "documentation":"

A list of source fields to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - } - }, - "documentation":"

Options for a field that contains an array of dates. Present if IndexFieldType specifies the field is of type date-array. All options are enabled by default.

" - }, - "DateOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceField":{"shape":"FieldName"}, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - } - }, - "documentation":"

Options for a date field. Dates and times are specified in UTC (Coordinated Universal Time) according to IETF RFC3339: yyyy-mm-ddT00:00:00Z. Present if IndexFieldType specifies the field is of type date. All options are enabled by default.

" - }, - "DefineAnalysisSchemeRequest":{ - "type":"structure", - "required":[ - "DomainName", - "AnalysisScheme" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "AnalysisScheme":{"shape":"AnalysisScheme"} - }, - "documentation":"

Container for the parameters to the DefineAnalysisScheme operation. Specifies the name of the domain you want to update and the analysis scheme configuration.

" - }, - "DefineAnalysisSchemeResponse":{ - "type":"structure", - "required":["AnalysisScheme"], - "members":{ - "AnalysisScheme":{"shape":"AnalysisSchemeStatus"} - }, - "documentation":"

The result of a DefineAnalysisScheme request. Contains the status of the newly-configured analysis scheme.

" - }, - "DefineExpressionRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Expression" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "Expression":{"shape":"Expression"} - }, - "documentation":"

Container for the parameters to the DefineExpression operation. Specifies the name of the domain you want to update and the expression you want to configure.

" - }, - "DefineExpressionResponse":{ - "type":"structure", - "required":["Expression"], - "members":{ - "Expression":{"shape":"ExpressionStatus"} - }, - "documentation":"

The result of a DefineExpression request. Contains the status of the newly-configured expression.

" - }, - "DefineIndexFieldRequest":{ - "type":"structure", - "required":[ - "DomainName", - "IndexField" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "IndexField":{ - "shape":"IndexField", - "documentation":"

The index field and field options you want to configure.

" - } - }, - "documentation":"

Container for the parameters to the DefineIndexField operation. Specifies the name of the domain you want to update and the index field configuration.

" - }, - "DefineIndexFieldResponse":{ - "type":"structure", - "required":["IndexField"], - "members":{ - "IndexField":{"shape":"IndexFieldStatus"} - }, - "documentation":"

The result of a DefineIndexField request. Contains the status of the newly-configured index field.

" - }, - "DefineSuggesterRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Suggester" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "Suggester":{"shape":"Suggester"} - }, - "documentation":"

Container for the parameters to the DefineSuggester operation. Specifies the name of the domain you want to update and the suggester configuration.

" - }, - "DefineSuggesterResponse":{ - "type":"structure", - "required":["Suggester"], - "members":{ - "Suggester":{"shape":"SuggesterStatus"} - }, - "documentation":"

The result of a DefineSuggester request. Contains the status of the newly-configured suggester.

" - }, - "DeleteAnalysisSchemeRequest":{ - "type":"structure", - "required":[ - "DomainName", - "AnalysisSchemeName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "AnalysisSchemeName":{ - "shape":"StandardName", - "documentation":"

The name of the analysis scheme you want to delete.

" - } - }, - "documentation":"

Container for the parameters to the DeleteAnalysisScheme operation. Specifies the name of the domain you want to update and the analysis scheme you want to delete.

" - }, - "DeleteAnalysisSchemeResponse":{ - "type":"structure", - "required":["AnalysisScheme"], - "members":{ - "AnalysisScheme":{ - "shape":"AnalysisSchemeStatus", - "documentation":"

The status of the analysis scheme being deleted.

" - } - }, - "documentation":"

The result of a DeleteAnalysisScheme request. Contains the status of the deleted analysis scheme.

" - }, - "DeleteDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to permanently delete.

" - } - }, - "documentation":"

Container for the parameters to the DeleteDomain operation. Specifies the name of the domain you want to delete.

" - }, - "DeleteDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{"shape":"DomainStatus"} - }, - "documentation":"

The result of a DeleteDomain request. Contains the status of a newly deleted domain, or no status if the domain has already been completely deleted.

" - }, - "DeleteExpressionRequest":{ - "type":"structure", - "required":[ - "DomainName", - "ExpressionName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "ExpressionName":{ - "shape":"StandardName", - "documentation":"

The name of the Expression to delete.

" - } - }, - "documentation":"

Container for the parameters to the DeleteExpression operation. Specifies the name of the domain you want to update and the name of the expression you want to delete.

" - }, - "DeleteExpressionResponse":{ - "type":"structure", - "required":["Expression"], - "members":{ - "Expression":{ - "shape":"ExpressionStatus", - "documentation":"

The status of the expression being deleted.

" - } - }, - "documentation":"

The result of a DeleteExpression request. Specifies the expression being deleted.

" - }, - "DeleteIndexFieldRequest":{ - "type":"structure", - "required":[ - "DomainName", - "IndexFieldName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "IndexFieldName":{ - "shape":"DynamicFieldName", - "documentation":"

The name of the index field your want to remove from the domain's indexing options.

" - } - }, - "documentation":"

Container for the parameters to the DeleteIndexField operation. Specifies the name of the domain you want to update and the name of the index field you want to delete.

" - }, - "DeleteIndexFieldResponse":{ - "type":"structure", - "required":["IndexField"], - "members":{ - "IndexField":{ - "shape":"IndexFieldStatus", - "documentation":"

The status of the index field being deleted.

" - } - }, - "documentation":"

The result of a DeleteIndexField request.

" - }, - "DeleteSuggesterRequest":{ - "type":"structure", - "required":[ - "DomainName", - "SuggesterName" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "SuggesterName":{ - "shape":"StandardName", - "documentation":"

Specifies the name of the suggester you want to delete.

" - } - }, - "documentation":"

Container for the parameters to the DeleteSuggester operation. Specifies the name of the domain you want to update and name of the suggester you want to delete.

" - }, - "DeleteSuggesterResponse":{ - "type":"structure", - "required":["Suggester"], - "members":{ - "Suggester":{ - "shape":"SuggesterStatus", - "documentation":"

The status of the suggester being deleted.

" - } - }, - "documentation":"

The result of a DeleteSuggester request. Contains the status of the deleted suggester.

" - }, - "DescribeAnalysisSchemesRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "AnalysisSchemeNames":{ - "shape":"StandardNameList", - "documentation":"

The analysis schemes you want to describe.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeAnalysisSchemes operation. Specifies the name of the domain you want to describe. To limit the response to particular analysis schemes, specify the names of the analysis schemes you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeAnalysisSchemesResponse":{ - "type":"structure", - "required":["AnalysisSchemes"], - "members":{ - "AnalysisSchemes":{ - "shape":"AnalysisSchemeStatusList", - "documentation":"

The analysis scheme descriptions.

" - } - }, - "documentation":"

The result of a DescribeAnalysisSchemes request. Contains the analysis schemes configured for the domain specified in the request.

" - }, - "DescribeAvailabilityOptionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeAvailabilityOptions operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeAvailabilityOptionsResponse":{ - "type":"structure", - "members":{ - "AvailabilityOptions":{ - "shape":"AvailabilityOptionsStatus", - "documentation":"

The availability options configured for the domain. Indicates whether Multi-AZ is enabled for the domain.

" - } - }, - "documentation":"

The result of a DescribeAvailabilityOptions request. Indicates whether or not the Multi-AZ option is enabled for the domain specified in the request.

" - }, - "DescribeDomainsRequest":{ - "type":"structure", - "members":{ - "DomainNames":{ - "shape":"DomainNameList", - "documentation":"

The names of the domains you want to include in the response.

" - } - }, - "documentation":"

Container for the parameters to the DescribeDomains operation. By default shows the status of all domains. To restrict the response to particular domains, specify the names of the domains you want to describe.

" - }, - "DescribeDomainsResponse":{ - "type":"structure", - "required":["DomainStatusList"], - "members":{ - "DomainStatusList":{"shape":"DomainStatusList"} - }, - "documentation":"

The result of a DescribeDomains request. Contains the status of the domains specified in the request or all domains owned by the account.

" - }, - "DescribeExpressionsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "ExpressionNames":{ - "shape":"StandardNameList", - "documentation":"

Limits the DescribeExpressions response to the specified expressions. If not specified, all expressions are shown.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeDomains operation. Specifies the name of the domain you want to describe. To restrict the response to particular expressions, specify the names of the expressions you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeExpressionsResponse":{ - "type":"structure", - "required":["Expressions"], - "members":{ - "Expressions":{ - "shape":"ExpressionStatusList", - "documentation":"

The expressions configured for the domain.

" - } - }, - "documentation":"

The result of a DescribeExpressions request. Contains the expressions configured for the domain specified in the request.

" - }, - "DescribeIndexFieldsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "FieldNames":{ - "shape":"DynamicFieldNameList", - "documentation":"

A list of the index fields you want to describe. If not specified, information is returned for all configured index fields.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeIndexFields operation. Specifies the name of the domain you want to describe. To restrict the response to particular index fields, specify the names of the index fields you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeIndexFieldsResponse":{ - "type":"structure", - "required":["IndexFields"], - "members":{ - "IndexFields":{ - "shape":"IndexFieldStatusList", - "documentation":"

The index fields configured for the domain.

" - } - }, - "documentation":"

The result of a DescribeIndexFields request. Contains the index fields configured for the domain specified in the request.

" - }, - "DescribeScalingParametersRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - }, - "documentation":"

Container for the parameters to the DescribeScalingParameters operation. Specifies the name of the domain you want to describe.

" - }, - "DescribeScalingParametersResponse":{ - "type":"structure", - "required":["ScalingParameters"], - "members":{ - "ScalingParameters":{"shape":"ScalingParametersStatus"} - }, - "documentation":"

The result of a DescribeScalingParameters request. Contains the scaling parameters configured for the domain specified in the request.

" - }, - "DescribeServiceAccessPoliciesRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeServiceAccessPolicies operation. Specifies the name of the domain you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeServiceAccessPoliciesResponse":{ - "type":"structure", - "required":["AccessPolicies"], - "members":{ - "AccessPolicies":{ - "shape":"AccessPoliciesStatus", - "documentation":"

The access rules configured for the domain specified in the request.

" - } - }, - "documentation":"

The result of a DescribeServiceAccessPolicies request.

" - }, - "DescribeSuggestersRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain you want to describe.

" - }, - "SuggesterNames":{ - "shape":"StandardNameList", - "documentation":"

The suggesters you want to describe.

" - }, - "Deployed":{ - "shape":"Boolean", - "documentation":"

Whether to display the deployed configuration (true) or include any pending changes (false). Defaults to false.

" - } - }, - "documentation":"

Container for the parameters to the DescribeSuggester operation. Specifies the name of the domain you want to describe. To restrict the response to particular suggesters, specify the names of the suggesters you want to describe. To show the active configuration and exclude any pending changes, set the Deployed option to true.

" - }, - "DescribeSuggestersResponse":{ - "type":"structure", - "required":["Suggesters"], - "members":{ - "Suggesters":{ - "shape":"SuggesterStatusList", - "documentation":"

The suggesters configured for the domain specified in the request.

" - } - }, - "documentation":"

The result of a DescribeSuggesters request.

" - }, - "DisabledOperationException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DisabledAction", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted an operation which is not enabled.

" - }, - "DocumentSuggesterOptions":{ - "type":"structure", - "required":["SourceField"], - "members":{ - "SourceField":{ - "shape":"FieldName", - "documentation":"

The name of the index field you want to use for suggestions.

" - }, - "FuzzyMatching":{ - "shape":"SuggesterFuzzyMatching", - "documentation":"

The level of fuzziness allowed when suggesting matches for a string: none, low, or high. With none, the specified string is treated as an exact prefix. With low, suggestions must differ from the specified string by no more than one character. With high, suggestions can differ by up to two characters. The default is none.

" - }, - "SortExpression":{ - "shape":"String", - "documentation":"

An expression that computes a score for each suggestion to control how they are sorted. The scores are rounded to the nearest integer, with a floor of 0 and a ceiling of 2^31-1. A document's relevance score is not computed for suggestions, so sort expressions cannot reference the _score value. To sort suggestions using a numeric field or existing expression, simply specify the name of the field or expression. If no expression is configured for the suggester, the suggestions are sorted with the closest matches listed first.

" - } - }, - "documentation":"

Options for a search suggester.

" - }, - "DomainId":{ - "type":"string", - "min":1, - "max":64, - "documentation":"

An internally generated unique identifier for a domain.

" - }, - "DomainName":{ - "type":"string", - "min":3, - "max":28, - "pattern":"[a-z][a-z0-9\\-]+", - "documentation":"

A string that represents the name of a domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

" - }, - "DomainNameList":{ - "type":"list", - "member":{"shape":"DomainName"}, - "documentation":"

A list of domain names.

" - }, - "DomainNameMap":{ - "type":"map", - "key":{"shape":"DomainName"}, - "value":{"shape":"APIVersion"}, - "documentation":"

A collection of domain names.

" - }, - "DomainStatus":{ - "type":"structure", - "required":[ - "DomainId", - "DomainName", - "RequiresIndexDocuments" - ], - "members":{ - "DomainId":{"shape":"DomainId"}, - "DomainName":{"shape":"DomainName"}, - "ARN":{"shape":"ARN"}, - "Created":{ - "shape":"Boolean", - "documentation":"

True if the search domain is created. It can take several minutes to initialize a domain when CreateDomain is called. Newly created search domains are returned from DescribeDomains with a false value for Created until domain creation is complete.

" - }, - "Deleted":{ - "shape":"Boolean", - "documentation":"

True if the search domain has been deleted. The system must clean up resources dedicated to the search domain when DeleteDomain is called. Newly deleted search domains are returned from DescribeDomains with a true value for IsDeleted for several minutes until resource cleanup is complete.

" - }, - "DocService":{ - "shape":"ServiceEndpoint", - "documentation":"

The service endpoint for updating documents in a search domain.

" - }, - "SearchService":{ - "shape":"ServiceEndpoint", - "documentation":"

The service endpoint for requesting search results from a search domain.

" - }, - "RequiresIndexDocuments":{ - "shape":"Boolean", - "documentation":"

True if IndexDocuments needs to be called to activate the current domain configuration.

" - }, - "Processing":{ - "shape":"Boolean", - "documentation":"

True if processing is being done to activate the current domain configuration.

" - }, - "SearchInstanceType":{ - "shape":"SearchInstanceType", - "documentation":"

The instance type that is being used to process search requests.

" - }, - "SearchPartitionCount":{ - "shape":"PartitionCount", - "documentation":"

The number of partitions across which the search index is spread.

" - }, - "SearchInstanceCount":{ - "shape":"InstanceCount", - "documentation":"

The number of search instances that are available to process search requests.

" - }, - "Limits":{"shape":"Limits"} - }, - "documentation":"

The current status of the search domain.

" - }, - "DomainStatusList":{ - "type":"list", - "member":{"shape":"DomainStatus"}, - "documentation":"

A list that contains the status of each requested domain.

" - }, - "Double":{"type":"double"}, - "DoubleArrayOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"Double", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceFields":{ - "shape":"FieldNameCommaList", - "documentation":"

A list of source fields to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - } - }, - "documentation":"

Options for a field that contains an array of double-precision 64-bit floating point values. Present if IndexFieldType specifies the field is of type double-array. All options are enabled by default.

" - }, - "DoubleOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"Double", - "documentation":"

A value to use for the field if the field isn't specified for a document. This can be important if you are using the field in an expression and that field is not present in every document.

" - }, - "SourceField":{ - "shape":"FieldName", - "documentation":"

The name of the source field to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - } - }, - "documentation":"

Options for a double-precision 64-bit floating point field. Present if IndexFieldType specifies the field is of type double. All options are enabled by default.

" - }, - "DynamicFieldName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"([a-z][a-z0-9_]*\\*?|\\*[a-z0-9_]*)" - }, - "DynamicFieldNameList":{ - "type":"list", - "member":{"shape":"DynamicFieldName"} - }, - "ErrorCode":{ - "type":"string", - "documentation":"

A machine-parsable string error or warning code.

" - }, - "ErrorMessage":{ - "type":"string", - "documentation":"

A human-readable string error or warning message.

" - }, - "Expression":{ - "type":"structure", - "required":[ - "ExpressionName", - "ExpressionValue" - ], - "members":{ - "ExpressionName":{"shape":"StandardName"}, - "ExpressionValue":{"shape":"ExpressionValue"} - }, - "documentation":"

A named expression that can be evaluated at search time. Can be used to sort the search results, define other expressions, or return computed information in the search results.

" - }, - "ExpressionStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"Expression", - "documentation":"

The expression that is evaluated for sorting while processing a search request.

" - }, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of an Expression and its current status.

" - }, - "ExpressionStatusList":{ - "type":"list", - "member":{"shape":"ExpressionStatus"}, - "documentation":"

Contains the status of multiple expressions.

" - }, - "ExpressionValue":{ - "type":"string", - "min":1, - "max":10240, - "documentation":"

The expression to evaluate for sorting while processing a search request. The Expression syntax is based on JavaScript expressions. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

" - }, - "FieldName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-z][a-z0-9_]*", - "documentation":"

A string that represents the name of an index field. CloudSearch supports regular index fields as well as dynamic fields. A dynamic field's name defines a pattern that begins or ends with a wildcard. Any document fields that don't map to a regular index field but do match a dynamic field's pattern are configured with the dynamic field's indexing options.

Regular field names begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Dynamic field names must begin or end with a wildcard (*). The wildcard can also be the only character in a dynamic field name. Multiple wildcards, and wildcards embedded within a string are not supported.

The name score is reserved and cannot be used as a field name. To reference a document's ID, you can use the name _id.

" - }, - "FieldNameCommaList":{ - "type":"string", - "pattern":"\\s*[a-z*][a-z0-9_]*\\*?\\s*(,\\s*[a-z*][a-z0-9_]*\\*?\\s*)*" - }, - "FieldNameList":{ - "type":"list", - "member":{"shape":"FieldName"}, - "documentation":"

A list of field names.

" - }, - "FieldValue":{ - "type":"string", - "min":0, - "max":1024, - "documentation":"

The value of a field attribute.

" - }, - "IndexDocumentsRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{"shape":"DomainName"} - }, - "documentation":"

Container for the parameters to the IndexDocuments operation. Specifies the name of the domain you want to re-index.

" - }, - "IndexDocumentsResponse":{ - "type":"structure", - "members":{ - "FieldNames":{ - "shape":"FieldNameList", - "documentation":"

The names of the fields that are currently being indexed.

" - } - }, - "documentation":"

The result of an IndexDocuments request. Contains the status of the indexing operation, including the fields being indexed.

" - }, - "IndexField":{ - "type":"structure", - "required":[ - "IndexFieldName", - "IndexFieldType" - ], - "members":{ - "IndexFieldName":{ - "shape":"DynamicFieldName", - "documentation":"

A string that represents the name of an index field. CloudSearch supports regular index fields as well as dynamic fields. A dynamic field's name defines a pattern that begins or ends with a wildcard. Any document fields that don't map to a regular index field but do match a dynamic field's pattern are configured with the dynamic field's indexing options.

Regular field names begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Dynamic field names must begin or end with a wildcard (*). The wildcard can also be the only character in a dynamic field name. Multiple wildcards, and wildcards embedded within a string are not supported.

The name score is reserved and cannot be used as a field name. To reference a document's ID, you can use the name _id.

" - }, - "IndexFieldType":{"shape":"IndexFieldType"}, - "IntOptions":{"shape":"IntOptions"}, - "DoubleOptions":{"shape":"DoubleOptions"}, - "LiteralOptions":{"shape":"LiteralOptions"}, - "TextOptions":{"shape":"TextOptions"}, - "DateOptions":{"shape":"DateOptions"}, - "LatLonOptions":{"shape":"LatLonOptions"}, - "IntArrayOptions":{"shape":"IntArrayOptions"}, - "DoubleArrayOptions":{"shape":"DoubleArrayOptions"}, - "LiteralArrayOptions":{"shape":"LiteralArrayOptions"}, - "TextArrayOptions":{"shape":"TextArrayOptions"}, - "DateArrayOptions":{"shape":"DateArrayOptions"} - }, - "documentation":"

Configuration information for a field in the index, including its name, type, and options. The supported options depend on the IndexFieldType.

" - }, - "IndexFieldStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"IndexField"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of an IndexField and its current status.

" - }, - "IndexFieldStatusList":{ - "type":"list", - "member":{"shape":"IndexFieldStatus"}, - "documentation":"

Contains the status of multiple index fields.

" - }, - "IndexFieldType":{ - "type":"string", - "enum":[ - "int", - "double", - "literal", - "text", - "date", - "latlon", - "int-array", - "double-array", - "literal-array", - "text-array", - "date-array" - ], - "documentation":"

The type of field. The valid options for a field depend on the field type. For more information about the supported field types, see Configuring Index Fields in the Amazon CloudSearch Developer Guide.

" - }, - "InstanceCount":{ - "type":"integer", - "min":1 - }, - "IntArrayOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"Long", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceFields":{ - "shape":"FieldNameCommaList", - "documentation":"

A list of source fields to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - } - }, - "documentation":"

Options for a field that contains an array of 64-bit signed integers. Present if IndexFieldType specifies the field is of type int-array. All options are enabled by default.

" - }, - "IntOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"Long", - "documentation":"A value to use for the field if the field isn't specified for a document. This can be important if you are using the field in an expression and that field is not present in every document." - }, - "SourceField":{ - "shape":"FieldName", - "documentation":"

The name of the source field to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - } - }, - "documentation":"

Options for a 64-bit signed integer field. Present if IndexFieldType specifies the field is of type int. All options are enabled by default.

" - }, - "InternalException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InternalException", - "httpStatusCode":500 - }, - "exception":true, - "documentation":"

An internal error occurred while processing the request. If this problem persists, report an issue from the Service Health Dashboard.

" - }, - "InvalidTypeException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidType", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it specified an invalid type definition.

" - }, - "LatLonOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceField":{"shape":"FieldName"}, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - } - }, - "documentation":"

Options for a latlon field. A latlon field contains a location stored as a latitude and longitude value pair. Present if IndexFieldType specifies the field is of type latlon. All options are enabled by default.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because a resource limit has already been met.

" - }, - "Limits":{ - "type":"structure", - "required":[ - "MaximumReplicationCount", - "MaximumPartitionCount" - ], - "members":{ - "MaximumReplicationCount":{"shape":"MaximumReplicationCount"}, - "MaximumPartitionCount":{"shape":"MaximumPartitionCount"} - } - }, - "ListDomainNamesResponse":{ - "type":"structure", - "members":{ - "DomainNames":{ - "shape":"DomainNameMap", - "documentation":"

The names of the search domains owned by an account.

" - } - }, - "documentation":"

The result of a ListDomainNames request. Contains a list of the domains owned by an account.

" - }, - "LiteralArrayOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceFields":{ - "shape":"FieldNameCommaList", - "documentation":"

A list of source fields to map to the field.

" - }, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - } - }, - "documentation":"

Options for a field that contains an array of literal strings. Present if IndexFieldType specifies the field is of type literal-array. All options are enabled by default.

" - }, - "LiteralOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceField":{"shape":"FieldName"}, - "FacetEnabled":{ - "shape":"Boolean", - "documentation":"

Whether facet information can be returned for the field.

" - }, - "SearchEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field are searchable.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - } - }, - "documentation":"

Options for literal field. Present if IndexFieldType specifies the field is of type literal. All options are enabled by default.

" - }, - "Long":{"type":"long"}, - "MaximumPartitionCount":{ - "type":"integer", - "min":1 - }, - "MaximumReplicationCount":{ - "type":"integer", - "min":1 - }, - "MultiAZ":{"type":"boolean"}, - "OptionState":{ - "type":"string", - "enum":[ - "RequiresIndexDocuments", - "Processing", - "Active", - "FailedToValidate" - ], - "documentation":"

The state of processing a change to an option. One of:

  • RequiresIndexDocuments: The option's latest value will not be deployed until IndexDocuments has been called and indexing is complete.
  • Processing: The option's latest value is in the process of being activated.
  • Active: The option's latest value is fully deployed.
  • FailedToValidate: The option value is not compatible with the domain's data and cannot be used to index the data. You must either modify the option value or update or remove the incompatible documents.
" - }, - "OptionStatus":{ - "type":"structure", - "required":[ - "CreationDate", - "UpdateDate", - "State" - ], - "members":{ - "CreationDate":{ - "shape":"UpdateTimestamp", - "documentation":"

A timestamp for when this option was created.

" - }, - "UpdateDate":{ - "shape":"UpdateTimestamp", - "documentation":"

A timestamp for when this option was last updated.

" - }, - "UpdateVersion":{ - "shape":"UIntValue", - "documentation":"

A unique integer that indicates when this option was last updated.

" - }, - "State":{ - "shape":"OptionState", - "documentation":"

The state of processing a change to an option. Possible values:

  • RequiresIndexDocuments: the option's latest value will not be deployed until IndexDocuments has been called and indexing is complete.
  • Processing: the option's latest value is in the process of being activated.
  • Active: the option's latest value is completely deployed.
  • FailedToValidate: the option value is not compatible with the domain's data and cannot be used to index the data. You must either modify the option value or update or remove the incompatible documents.
" - }, - "PendingDeletion":{ - "shape":"Boolean", - "documentation":"

Indicates that the option will be deleted once processing is complete.

" - } - }, - "documentation":"

The status of domain configuration option.

" - }, - "PartitionCount":{ - "type":"integer", - "min":1, - "documentation":"

The number of partitions used to hold the domain's index.

" - }, - "PartitionInstanceType":{ - "type":"string", - "enum":[ - "search.m1.small", - "search.m1.large", - "search.m2.xlarge", - "search.m2.2xlarge", - "search.m3.medium", - "search.m3.large", - "search.m3.xlarge", - "search.m3.2xlarge" - ], - "documentation":"

The instance type (such as search.m1.small) on which an index partition is hosted.

" - }, - "PolicyDocument":{ - "type":"string", - "documentation":"

Access rules for a domain's document or search service endpoints. For more information, see Configuring Access for a Search Domain in the Amazon CloudSearch Developer Guide. The maximum size of a policy document is 100 KB.

" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

The request was rejected because it attempted to reference a resource that does not exist.

" - }, - "ScalingParameters":{ - "type":"structure", - "members":{ - "DesiredInstanceType":{ - "shape":"PartitionInstanceType", - "documentation":"

The instance type that you want to preconfigure for your domain. For example, search.m1.small.

" - }, - "DesiredReplicationCount":{ - "shape":"UIntValue", - "documentation":"

The number of replicas you want to preconfigure for each index partition.

" - }, - "DesiredPartitionCount":{ - "shape":"UIntValue", - "documentation":"

The number of partitions you want to preconfigure for your domain. Only valid when you select m2.2xlarge as the desired instance type.

" - } - }, - "documentation":"

The desired instance type and desired number of replicas of each index partition.

" - }, - "ScalingParametersStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"ScalingParameters"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The status and configuration of a search domain's scaling parameters.

" - }, - "SearchInstanceType":{ - "type":"string", - "documentation":"

The instance type (such as search.m1.small) that is being used to process search requests.

" - }, - "ServiceEndpoint":{ - "type":"structure", - "members":{ - "Endpoint":{"shape":"ServiceUrl"} - }, - "documentation":"

The endpoint to which service requests can be submitted.

" - }, - "ServiceUrl":{ - "type":"string", - "documentation":"

The endpoint to which service requests can be submitted. For example, search-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.cloudsearch.amazonaws.com or doc-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.cloudsearch.amazonaws.com.

" - }, - "StandardName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-z][a-z0-9_]*", - "documentation":"

Names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore).

" - }, - "StandardNameList":{ - "type":"list", - "member":{"shape":"StandardName"} - }, - "String":{"type":"string"}, - "Suggester":{ - "type":"structure", - "required":[ - "SuggesterName", - "DocumentSuggesterOptions" - ], - "members":{ - "SuggesterName":{"shape":"StandardName"}, - "DocumentSuggesterOptions":{"shape":"DocumentSuggesterOptions"} - }, - "documentation":"

Configuration information for a search suggester. Each suggester has a unique name and specifies the text field you want to use for suggestions. The following options can be configured for a suggester: FuzzyMatching, SortExpression.

" - }, - "SuggesterFuzzyMatching":{ - "type":"string", - "enum":[ - "none", - "low", - "high" - ] - }, - "SuggesterStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{"shape":"Suggester"}, - "Status":{"shape":"OptionStatus"} - }, - "documentation":"

The value of a Suggester and its current status.

" - }, - "SuggesterStatusList":{ - "type":"list", - "member":{"shape":"SuggesterStatus"}, - "documentation":"

Contains the status of multiple suggesters.

" - }, - "TextArrayOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceFields":{ - "shape":"FieldNameCommaList", - "documentation":"

A list of source fields to map to the field.

" - }, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "HighlightEnabled":{ - "shape":"Boolean", - "documentation":"

Whether highlights can be returned for the field.

" - }, - "AnalysisScheme":{ - "shape":"Word", - "documentation":"

The name of an analysis scheme for a text-array field.

" - } - }, - "documentation":"

Options for a field that contains an array of text strings. Present if IndexFieldType specifies the field is of type text-array. A text-array field is always searchable. All options are enabled by default.

" - }, - "TextOptions":{ - "type":"structure", - "members":{ - "DefaultValue":{ - "shape":"FieldValue", - "documentation":"A value to use for the field if the field isn't specified for a document." - }, - "SourceField":{"shape":"FieldName"}, - "ReturnEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the contents of the field can be returned in the search results.

" - }, - "SortEnabled":{ - "shape":"Boolean", - "documentation":"

Whether the field can be used to sort the search results.

" - }, - "HighlightEnabled":{ - "shape":"Boolean", - "documentation":"

Whether highlights can be returned for the field.

" - }, - "AnalysisScheme":{ - "shape":"Word", - "documentation":"

The name of an analysis scheme for a text field.

" - } - }, - "documentation":"

Options for text field. Present if IndexFieldType specifies the field is of type text. A text field is always searchable. All options are enabled by default.

" - }, - "UIntValue":{ - "type":"integer", - "min":0 - }, - "UpdateAvailabilityOptionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "MultiAZ" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

You expand an existing search domain to a second Availability Zone by setting the Multi-AZ option to true. Similarly, you can turn off the Multi-AZ option to downgrade the domain to a single Availability Zone by setting the Multi-AZ option to false.

" - } - }, - "documentation":"

Container for the parameters to the UpdateAvailabilityOptions operation. Specifies the name of the domain you want to update and the Multi-AZ availability option.

" - }, - "UpdateAvailabilityOptionsResponse":{ - "type":"structure", - "members":{ - "AvailabilityOptions":{ - "shape":"AvailabilityOptionsStatus", - "documentation":"

The newly-configured availability options. Indicates whether Multi-AZ is enabled for the domain.

" - } - }, - "documentation":"

The result of a UpdateAvailabilityOptions request. Contains the status of the domain's availability options.

" - }, - "UpdateScalingParametersRequest":{ - "type":"structure", - "required":[ - "DomainName", - "ScalingParameters" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "ScalingParameters":{"shape":"ScalingParameters"} - }, - "documentation":"

Container for the parameters to the UpdateScalingParameters operation. Specifies the name of the domain you want to update and the scaling parameters you want to configure.

" - }, - "UpdateScalingParametersResponse":{ - "type":"structure", - "required":["ScalingParameters"], - "members":{ - "ScalingParameters":{"shape":"ScalingParametersStatus"} - }, - "documentation":"

The result of a UpdateScalingParameters request. Contains the status of the newly-configured scaling parameters.

" - }, - "UpdateServiceAccessPoliciesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "AccessPolicies" - ], - "members":{ - "DomainName":{"shape":"DomainName"}, - "AccessPolicies":{ - "shape":"PolicyDocument", - "documentation":"

The access rules you want to configure. These rules replace any existing rules.

" - } - }, - "documentation":"

Container for the parameters to the UpdateServiceAccessPolicies operation. Specifies the name of the domain you want to update and the access rules you want to configure.

" - }, - "UpdateServiceAccessPoliciesResponse":{ - "type":"structure", - "required":["AccessPolicies"], - "members":{ - "AccessPolicies":{ - "shape":"AccessPoliciesStatus", - "documentation":"

The access rules configured for the domain.

" - } - }, - "documentation":"

The result of an UpdateServiceAccessPolicies request. Contains the new access policies.

" - }, - "UpdateTimestamp":{"type":"timestamp"}, - "Word":{ - "type":"string", - "pattern":"[\\S]+" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/service-2.json deleted file mode 100644 index 018b114d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudsearchdomain/2013-01-01/service-2.json +++ /dev/null @@ -1,548 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-01-01", - "endpointPrefix":"cloudsearchdomain", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"Amazon CloudSearch Domain", - "serviceId":"CloudSearch Domain", - "signatureVersion":"v4", - "signingName":"cloudsearch", - "uid":"cloudsearchdomain-2013-01-01" - }, - "operations":{ - "Search":{ - "name":"Search", - "http":{ - "method":"GET", - "requestUri":"/2013-01-01/search?format=sdk&pretty=true" - }, - "input":{"shape":"SearchRequest"}, - "output":{"shape":"SearchResponse"}, - "errors":[ - {"shape":"SearchException"} - ], - "documentation":"

Retrieves a list of documents that match the specified search criteria. How you specify the search criteria depends on which query parser you use. Amazon CloudSearch supports four query parsers:

  • simple: search all text and text-array fields for the specified string. Search for phrases, individual terms, and prefixes.
  • structured: search specific fields, construct compound queries using Boolean operators, and use advanced features such as term boosting and proximity searching.
  • lucene: specify search criteria using the Apache Lucene query parser syntax.
  • dismax: specify search criteria using the simplified subset of the Apache Lucene query parser syntax defined by the DisMax query parser.

For more information, see Searching Your Data in the Amazon CloudSearch Developer Guide.

The endpoint for submitting Search requests is domain-specific. You submit search requests to a domain's search endpoint. To get the search endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. A domain's endpoints are also displayed on the domain dashboard in the Amazon CloudSearch console.

" - }, - "Suggest":{ - "name":"Suggest", - "http":{ - "method":"GET", - "requestUri":"/2013-01-01/suggest?format=sdk&pretty=true" - }, - "input":{"shape":"SuggestRequest"}, - "output":{"shape":"SuggestResponse"}, - "errors":[ - {"shape":"SearchException"} - ], - "documentation":"

Retrieves autocomplete suggestions for a partial query string. You can use suggestions enable you to display likely matches before users finish typing. In Amazon CloudSearch, suggestions are based on the contents of a particular text field. When you request suggestions, Amazon CloudSearch finds all of the documents whose values in the suggester field start with the specified query string. The beginning of the field must match the query string to be considered a match.

For more information about configuring suggesters and retrieving suggestions, see Getting Suggestions in the Amazon CloudSearch Developer Guide.

The endpoint for submitting Suggest requests is domain-specific. You submit suggest requests to a domain's search endpoint. To get the search endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. A domain's endpoints are also displayed on the domain dashboard in the Amazon CloudSearch console.

" - }, - "UploadDocuments":{ - "name":"UploadDocuments", - "http":{ - "method":"POST", - "requestUri":"/2013-01-01/documents/batch?format=sdk" - }, - "input":{"shape":"UploadDocumentsRequest"}, - "output":{"shape":"UploadDocumentsResponse"}, - "errors":[ - {"shape":"DocumentServiceException"} - ], - "documentation":"

Posts a batch of documents to a search domain for indexing. A document batch is a collection of add and delete operations that represent the documents you want to add, update, or delete from your domain. Batches can be described in either JSON or XML. Each item that you want Amazon CloudSearch to return as a search result (such as a product) is represented as a document. Every document has a unique ID and one or more fields that contain the data that you want to search and return in results. Individual documents cannot contain more than 1 MB of data. The entire batch cannot exceed 5 MB. To get the best possible upload performance, group add and delete operations in batches that are close the 5 MB limit. Submitting a large volume of single-document batches can overload a domain's document service.

The endpoint for submitting UploadDocuments requests is domain-specific. To get the document endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. A domain's endpoints are also displayed on the domain dashboard in the Amazon CloudSearch console.

For more information about formatting your data for Amazon CloudSearch, see Preparing Your Data in the Amazon CloudSearch Developer Guide. For more information about uploading data for indexing, see Uploading Data in the Amazon CloudSearch Developer Guide.

" - } - }, - "shapes":{ - "Adds":{"type":"long"}, - "Blob":{ - "type":"blob", - "streaming":true - }, - "Bucket":{ - "type":"structure", - "members":{ - "value":{ - "shape":"String", - "documentation":"

The facet value being counted.

" - }, - "count":{ - "shape":"Long", - "documentation":"

The number of hits that contain the facet value in the specified facet field.

" - } - }, - "documentation":"

A container for facet information.

" - }, - "BucketInfo":{ - "type":"structure", - "members":{ - "buckets":{ - "shape":"BucketList", - "documentation":"

A list of the calculated facet values and counts.

" - } - }, - "documentation":"

A container for the calculated facet values and counts.

" - }, - "BucketList":{ - "type":"list", - "member":{"shape":"Bucket"} - }, - "ContentType":{ - "type":"string", - "enum":[ - "application/json", - "application/xml" - ] - }, - "Cursor":{"type":"string"}, - "Deletes":{"type":"long"}, - "DocumentServiceException":{ - "type":"structure", - "members":{ - "status":{ - "shape":"String", - "documentation":"

The return status of a document upload request, error or success.

" - }, - "message":{ - "shape":"String", - "documentation":"

The description of the errors returned by the document service.

" - } - }, - "documentation":"

Information about any problems encountered while processing an upload request.

", - "exception":true - }, - "DocumentServiceWarning":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The description for a warning returned by the document service.

" - } - }, - "documentation":"

A warning returned by the document service when an issue is discovered while processing an upload request.

" - }, - "DocumentServiceWarnings":{ - "type":"list", - "member":{"shape":"DocumentServiceWarning"} - }, - "Double":{"type":"double"}, - "Expr":{"type":"string"}, - "Exprs":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Facet":{"type":"string"}, - "Facets":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"BucketInfo"} - }, - "FieldStats":{ - "type":"structure", - "members":{ - "min":{ - "shape":"String", - "documentation":"

The minimum value found in the specified field in the result set.

If the field is numeric (int, int-array, double, or double-array), min is the string representation of a double-precision 64-bit floating point value. If the field is date or date-array, min is the string representation of a date with the format specified in IETF RFC3339: yyyy-mm-ddTHH:mm:ss.SSSZ.

" - }, - "max":{ - "shape":"String", - "documentation":"

The maximum value found in the specified field in the result set.

If the field is numeric (int, int-array, double, or double-array), max is the string representation of a double-precision 64-bit floating point value. If the field is date or date-array, max is the string representation of a date with the format specified in IETF RFC3339: yyyy-mm-ddTHH:mm:ss.SSSZ.

" - }, - "count":{ - "shape":"Long", - "documentation":"

The number of documents that contain a value in the specified field in the result set.

" - }, - "missing":{ - "shape":"Long", - "documentation":"

The number of documents that do not contain a value in the specified field in the result set.

" - }, - "sum":{ - "shape":"Double", - "documentation":"

The sum of the field values across the documents in the result set. null for date fields.

" - }, - "sumOfSquares":{ - "shape":"Double", - "documentation":"

The sum of all field values in the result set squared.

" - }, - "mean":{ - "shape":"String", - "documentation":"

The average of the values found in the specified field in the result set.

If the field is numeric (int, int-array, double, or double-array), mean is the string representation of a double-precision 64-bit floating point value. If the field is date or date-array, mean is the string representation of a date with the format specified in IETF RFC3339: yyyy-mm-ddTHH:mm:ss.SSSZ.

" - }, - "stddev":{ - "shape":"Double", - "documentation":"

The standard deviation of the values in the specified field in the result set.

" - } - }, - "documentation":"

The statistics for a field calculated in the request.

" - }, - "FieldValue":{ - "type":"list", - "member":{"shape":"String"} - }, - "Fields":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"FieldValue"} - }, - "FilterQuery":{"type":"string"}, - "Highlight":{"type":"string"}, - "Highlights":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Hit":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The document ID of a document that matches the search request.

" - }, - "fields":{ - "shape":"Fields", - "documentation":"

The fields returned from a document that matches the search request.

" - }, - "exprs":{ - "shape":"Exprs", - "documentation":"

The expressions returned from a document that matches the search request.

" - }, - "highlights":{ - "shape":"Highlights", - "documentation":"

The highlights returned from a document that matches the search request.

" - } - }, - "documentation":"

Information about a document that matches the search request.

" - }, - "HitList":{ - "type":"list", - "member":{"shape":"Hit"} - }, - "Hits":{ - "type":"structure", - "members":{ - "found":{ - "shape":"Long", - "documentation":"

The total number of documents that match the search request.

" - }, - "start":{ - "shape":"Long", - "documentation":"

The index of the first matching document.

" - }, - "cursor":{ - "shape":"String", - "documentation":"

A cursor that can be used to retrieve the next set of matching documents when you want to page through a large result set.

" - }, - "hit":{ - "shape":"HitList", - "documentation":"

A document that matches the search request.

" - } - }, - "documentation":"

The collection of documents that match the search request.

" - }, - "Long":{"type":"long"}, - "Partial":{"type":"boolean"}, - "Query":{"type":"string"}, - "QueryOptions":{"type":"string"}, - "QueryParser":{ - "type":"string", - "enum":[ - "simple", - "structured", - "lucene", - "dismax" - ] - }, - "Return":{"type":"string"}, - "SearchException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

A description of the error returned by the search service.

" - } - }, - "documentation":"

Information about any problems encountered while processing a search request.

", - "exception":true - }, - "SearchRequest":{ - "type":"structure", - "required":["query"], - "members":{ - "cursor":{ - "shape":"Cursor", - "documentation":"

Retrieves a cursor value you can use to page through large result sets. Use the size parameter to control the number of hits to include in each response. You can specify either the cursor or start parameter in a request; they are mutually exclusive. To get the first cursor, set the cursor value to initial. In subsequent requests, specify the cursor value returned in the hits section of the response.

For more information, see Paginating Results in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"cursor" - }, - "expr":{ - "shape":"Expr", - "documentation":"

Defines one or more numeric expressions that can be used to sort results or specify search or filter criteria. You can also specify expressions as return fields.

You specify the expressions in JSON using the form {\"EXPRESSIONNAME\":\"EXPRESSION\"}. You can define and use multiple expressions in a search request. For example:

{\"expression1\":\"_score*rating\", \"expression2\":\"(1/rank)*year\"}

For information about the variables, operators, and functions you can use in expressions, see Writing Expressions in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"expr" - }, - "facet":{ - "shape":"Facet", - "documentation":"

Specifies one or more fields for which to get facet information, and options that control how the facet information is returned. Each specified field must be facet-enabled in the domain configuration. The fields and options are specified in JSON using the form {\"FIELD\":{\"OPTION\":VALUE,\"OPTION:\"STRING\"},\"FIELD\":{\"OPTION\":VALUE,\"OPTION\":\"STRING\"}}.

You can specify the following faceting options:

  • buckets specifies an array of the facet values or ranges to count. Ranges are specified using the same syntax that you use to search for a range of values. For more information, see Searching for a Range of Values in the Amazon CloudSearch Developer Guide. Buckets are returned in the order they are specified in the request. The sort and size options are not valid if you specify buckets.

  • size specifies the maximum number of facets to include in the results. By default, Amazon CloudSearch returns counts for the top 10. The size parameter is only valid when you specify the sort option; it cannot be used in conjunction with buckets.

  • sort specifies how you want to sort the facets in the results: bucket or count. Specify bucket to sort alphabetically or numerically by facet value (in ascending order). Specify count to sort by the facet counts computed for each facet value (in descending order). To retrieve facet counts for particular values or ranges of values, use the buckets option instead of sort.

If no facet options are specified, facet counts are computed for all field values, the facets are sorted by facet count, and the top 10 facets are returned in the results.

To count particular buckets of values, use the buckets option. For example, the following request uses the buckets option to calculate and return facet counts by decade.

{\"year\":{\"buckets\":[\"[1970,1979]\",\"[1980,1989]\",\"[1990,1999]\",\"[2000,2009]\",\"[2010,}\"]}}

To sort facets by facet count, use the count option. For example, the following request sets the sort option to count to sort the facet values by facet count, with the facet values that have the most matching documents listed first. Setting the size option to 3 returns only the top three facet values.

{\"year\":{\"sort\":\"count\",\"size\":3}}

To sort the facets by value, use the bucket option. For example, the following request sets the sort option to bucket to sort the facet values numerically by year, with earliest year listed first.

{\"year\":{\"sort\":\"bucket\"}}

For more information, see Getting and Using Facet Information in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"facet" - }, - "filterQuery":{ - "shape":"FilterQuery", - "documentation":"

Specifies a structured query that filters the results of a search without affecting how the results are scored and sorted. You use filterQuery in conjunction with the query parameter to filter the documents that match the constraints specified in the query parameter. Specifying a filter controls only which matching documents are included in the results, it has no effect on how they are scored and sorted. The filterQuery parameter supports the full structured query syntax.

For more information about using filters, see Filtering Matching Documents in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"fq" - }, - "highlight":{ - "shape":"Highlight", - "documentation":"

Retrieves highlights for matches in the specified text or text-array fields. Each specified field must be highlight enabled in the domain configuration. The fields and options are specified in JSON using the form {\"FIELD\":{\"OPTION\":VALUE,\"OPTION:\"STRING\"},\"FIELD\":{\"OPTION\":VALUE,\"OPTION\":\"STRING\"}}.

You can specify the following highlight options:

  • format: specifies the format of the data in the text field: text or html. When data is returned as HTML, all non-alphanumeric characters are encoded. The default is html.
  • max_phrases: specifies the maximum number of occurrences of the search term(s) you want to highlight. By default, the first occurrence is highlighted.
  • pre_tag: specifies the string to prepend to an occurrence of a search term. The default for HTML highlights is &lt;em&gt;. The default for text highlights is *.
  • post_tag: specifies the string to append to an occurrence of a search term. The default for HTML highlights is &lt;/em&gt;. The default for text highlights is *.

If no highlight options are specified for a field, the returned field text is treated as HTML and the first match is highlighted with emphasis tags: &lt;em>search-term&lt;/em&gt;.

For example, the following request retrieves highlights for the actors and title fields.

{ \"actors\": {}, \"title\": {\"format\": \"text\",\"max_phrases\": 2,\"pre_tag\": \"\",\"post_tag\": \"\"} }

", - "location":"querystring", - "locationName":"highlight" - }, - "partial":{ - "shape":"Partial", - "documentation":"

Enables partial results to be returned if one or more index partitions are unavailable. When your search index is partitioned across multiple search instances, by default Amazon CloudSearch only returns results if every partition can be queried. This means that the failure of a single search instance can result in 5xx (internal server) errors. When you enable partial results, Amazon CloudSearch returns whatever results are available and includes the percentage of documents searched in the search results (percent-searched). This enables you to more gracefully degrade your users' search experience. For example, rather than displaying no results, you could display the partial results and a message indicating that the results might be incomplete due to a temporary system outage.

", - "location":"querystring", - "locationName":"partial" - }, - "query":{ - "shape":"Query", - "documentation":"

Specifies the search criteria for the request. How you specify the search criteria depends on the query parser used for the request and the parser options specified in the queryOptions parameter. By default, the simple query parser is used to process requests. To use the structured, lucene, or dismax query parser, you must also specify the queryParser parameter.

For more information about specifying search criteria, see Searching Your Data in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"q" - }, - "queryOptions":{ - "shape":"QueryOptions", - "documentation":"

Configures options for the query parser specified in the queryParser parameter. You specify the options in JSON using the following form {\"OPTION1\":\"VALUE1\",\"OPTION2\":VALUE2\"...\"OPTIONN\":\"VALUEN\"}.

The options you can configure vary according to which parser you use:

  • defaultOperator: The default operator used to combine individual terms in the search string. For example: defaultOperator: 'or'. For the dismax parser, you specify a percentage that represents the percentage of terms in the search string (rounded down) that must match, rather than a default operator. A value of 0% is the equivalent to OR, and a value of 100% is equivalent to AND. The percentage must be specified as a value in the range 0-100 followed by the percent (%) symbol. For example, defaultOperator: 50%. Valid values: and, or, a percentage in the range 0%-100% (dismax). Default: and (simple, structured, lucene) or 100 (dismax). Valid for: simple, structured, lucene, and dismax.
  • fields: An array of the fields to search when no fields are specified in a search. If no fields are specified in a search and this option is not specified, all text and text-array fields are searched. You can specify a weight for each field to control the relative importance of each field when Amazon CloudSearch calculates relevance scores. To specify a field weight, append a caret (^) symbol and the weight to the field name. For example, to boost the importance of the title field over the description field you could specify: \"fields\":[\"title^5\",\"description\"]. Valid values: The name of any configured field and an optional numeric value greater than zero. Default: All text and text-array fields. Valid for: simple, structured, lucene, and dismax.
  • operators: An array of the operators or special characters you want to disable for the simple query parser. If you disable the and, or, or not operators, the corresponding operators (+, |, -) have no special meaning and are dropped from the search string. Similarly, disabling prefix disables the wildcard operator (*) and disabling phrase disables the ability to search for phrases by enclosing phrases in double quotes. Disabling precedence disables the ability to control order of precedence using parentheses. Disabling near disables the ability to use the ~ operator to perform a sloppy phrase search. Disabling the fuzzy operator disables the ability to use the ~ operator to perform a fuzzy search. escape disables the ability to use a backslash (\\) to escape special characters within the search string. Disabling whitespace is an advanced option that prevents the parser from tokenizing on whitespace, which can be useful for Vietnamese. (It prevents Vietnamese words from being split incorrectly.) For example, you could disable all operators other than the phrase operator to support just simple term and phrase queries: \"operators\":[\"and\",\"not\",\"or\", \"prefix\"]. Valid values: and, escape, fuzzy, near, not, or, phrase, precedence, prefix, whitespace. Default: All operators and special characters are enabled. Valid for: simple.
  • phraseFields: An array of the text or text-array fields you want to use for phrase searches. When the terms in the search string appear in close proximity within a field, the field scores higher. You can specify a weight for each field to boost that score. The phraseSlop option controls how much the matches can deviate from the search string and still be boosted. To specify a field weight, append a caret (^) symbol and the weight to the field name. For example, to boost phrase matches in the title field over the abstract field, you could specify: \"phraseFields\":[\"title^3\", \"plot\"] Valid values: The name of any text or text-array field and an optional numeric value greater than zero. Default: No fields. If you don't specify any fields with phraseFields, proximity scoring is disabled even if phraseSlop is specified. Valid for: dismax.
  • phraseSlop: An integer value that specifies how much matches can deviate from the search phrase and still be boosted according to the weights specified in the phraseFields option; for example, phraseSlop: 2. You must also specify phraseFields to enable proximity scoring. Valid values: positive integers. Default: 0. Valid for: dismax.
  • explicitPhraseSlop: An integer value that specifies how much a match can deviate from the search phrase when the phrase is enclosed in double quotes in the search string. (Phrases that exceed this proximity distance are not considered a match.) For example, to specify a slop of three for dismax phrase queries, you would specify \"explicitPhraseSlop\":3. Valid values: positive integers. Default: 0. Valid for: dismax.
  • tieBreaker: When a term in the search string is found in a document's field, a score is calculated for that field based on how common the word is in that field compared to other documents. If the term occurs in multiple fields within a document, by default only the highest scoring field contributes to the document's overall score. You can specify a tieBreaker value to enable the matches in lower-scoring fields to contribute to the document's score. That way, if two documents have the same max field score for a particular term, the score for the document that has matches in more fields will be higher. The formula for calculating the score with a tieBreaker is (max field score) + (tieBreaker) * (sum of the scores for the rest of the matching fields). Set tieBreaker to 0 to disregard all but the highest scoring field (pure max): \"tieBreaker\":0. Set to 1 to sum the scores from all fields (pure sum): \"tieBreaker\":1. Valid values: 0.0 to 1.0. Default: 0.0. Valid for: dismax.
", - "location":"querystring", - "locationName":"q.options" - }, - "queryParser":{ - "shape":"QueryParser", - "documentation":"

Specifies which query parser to use to process the request. If queryParser is not specified, Amazon CloudSearch uses the simple query parser.

Amazon CloudSearch supports four query parsers:

  • simple: perform simple searches of text and text-array fields. By default, the simple query parser searches all text and text-array fields. You can specify which fields to search by with the queryOptions parameter. If you prefix a search term with a plus sign (+) documents must contain the term to be considered a match. (This is the default, unless you configure the default operator with the queryOptions parameter.) You can use the - (NOT), | (OR), and * (wildcard) operators to exclude particular terms, find results that match any of the specified terms, or search for a prefix. To search for a phrase rather than individual terms, enclose the phrase in double quotes. For more information, see Searching for Text in the Amazon CloudSearch Developer Guide.
  • structured: perform advanced searches by combining multiple expressions to define the search criteria. You can also search within particular fields, search for values and ranges of values, and use advanced options such as term boosting, matchall, and near. For more information, see Constructing Compound Queries in the Amazon CloudSearch Developer Guide.
  • lucene: search using the Apache Lucene query parser syntax. For more information, see Apache Lucene Query Parser Syntax.
  • dismax: search using the simplified subset of the Apache Lucene query parser syntax defined by the DisMax query parser. For more information, see DisMax Query Parser Syntax.
", - "location":"querystring", - "locationName":"q.parser" - }, - "return":{ - "shape":"Return", - "documentation":"

Specifies the field and expression values to include in the response. Multiple fields or expressions are specified as a comma-separated list. By default, a search response includes all return enabled fields (_all_fields). To return only the document IDs for the matching documents, specify _no_fields. To retrieve the relevance score calculated for each document, specify _score.

", - "location":"querystring", - "locationName":"return" - }, - "size":{ - "shape":"Size", - "documentation":"

Specifies the maximum number of search hits to include in the response.

", - "location":"querystring", - "locationName":"size" - }, - "sort":{ - "shape":"Sort", - "documentation":"

Specifies the fields or custom expressions to use to sort the search results. Multiple fields or expressions are specified as a comma-separated list. You must specify the sort direction (asc or desc) for each field; for example, year desc,title asc. To use a field to sort results, the field must be sort-enabled in the domain configuration. Array type fields cannot be used for sorting. If no sort parameter is specified, results are sorted by their default relevance scores in descending order: _score desc. You can also sort by document ID (_id asc) and version (_version desc).

For more information, see Sorting Results in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"sort" - }, - "start":{ - "shape":"Start", - "documentation":"

Specifies the offset of the first search hit you want to return. Note that the result set is zero-based; the first result is at index 0. You can specify either the start or cursor parameter in a request, they are mutually exclusive.

For more information, see Paginating Results in the Amazon CloudSearch Developer Guide.

", - "location":"querystring", - "locationName":"start" - }, - "stats":{ - "shape":"Stat", - "documentation":"

Specifies one or more fields for which to get statistics information. Each specified field must be facet-enabled in the domain configuration. The fields are specified in JSON using the form:

{\"FIELD-A\":{},\"FIELD-B\":{}}

There are currently no options supported for statistics.

", - "location":"querystring", - "locationName":"stats" - } - }, - "documentation":"

Container for the parameters to the Search request.

" - }, - "SearchResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"SearchStatus", - "documentation":"

The status information returned for the search request.

" - }, - "hits":{ - "shape":"Hits", - "documentation":"

The documents that match the search criteria.

" - }, - "facets":{ - "shape":"Facets", - "documentation":"

The requested facet information.

" - }, - "stats":{ - "shape":"Stats", - "documentation":"

The requested field statistics information.

" - } - }, - "documentation":"

The result of a Search request. Contains the documents that match the specified search criteria and any requested fields, highlights, and facet information.

" - }, - "SearchStatus":{ - "type":"structure", - "members":{ - "timems":{ - "shape":"Long", - "documentation":"

How long it took to process the request, in milliseconds.

" - }, - "rid":{ - "shape":"String", - "documentation":"

The encrypted resource ID for the request.

" - } - }, - "documentation":"

Contains the resource id (rid) and the time it took to process the request (timems).

" - }, - "Size":{"type":"long"}, - "Sort":{"type":"string"}, - "Start":{"type":"long"}, - "Stat":{"type":"string"}, - "Stats":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"FieldStats"}, - "documentation":"

The statistics calculated in the request.

" - }, - "String":{"type":"string"}, - "SuggestModel":{ - "type":"structure", - "members":{ - "query":{ - "shape":"String", - "documentation":"

The query string specified in the suggest request.

" - }, - "found":{ - "shape":"Long", - "documentation":"

The number of documents that were found to match the query string.

" - }, - "suggestions":{ - "shape":"Suggestions", - "documentation":"

The documents that match the query string.

" - } - }, - "documentation":"

Container for the suggestion information returned in a SuggestResponse.

" - }, - "SuggestRequest":{ - "type":"structure", - "required":[ - "query", - "suggester" - ], - "members":{ - "query":{ - "shape":"Query", - "documentation":"

Specifies the string for which you want to get suggestions.

", - "location":"querystring", - "locationName":"q" - }, - "suggester":{ - "shape":"Suggester", - "documentation":"

Specifies the name of the suggester to use to find suggested matches.

", - "location":"querystring", - "locationName":"suggester" - }, - "size":{ - "shape":"SuggestionsSize", - "documentation":"

Specifies the maximum number of suggestions to return.

", - "location":"querystring", - "locationName":"size" - } - }, - "documentation":"

Container for the parameters to the Suggest request.

" - }, - "SuggestResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"SuggestStatus", - "documentation":"

The status of a SuggestRequest. Contains the resource ID (rid) and how long it took to process the request (timems).

" - }, - "suggest":{ - "shape":"SuggestModel", - "documentation":"

Container for the matching search suggestion information.

" - } - }, - "documentation":"

Contains the response to a Suggest request.

" - }, - "SuggestStatus":{ - "type":"structure", - "members":{ - "timems":{ - "shape":"Long", - "documentation":"

How long it took to process the request, in milliseconds.

" - }, - "rid":{ - "shape":"String", - "documentation":"

The encrypted resource ID for the request.

" - } - }, - "documentation":"

Contains the resource id (rid) and the time it took to process the request (timems).

" - }, - "Suggester":{"type":"string"}, - "SuggestionMatch":{ - "type":"structure", - "members":{ - "suggestion":{ - "shape":"String", - "documentation":"

The string that matches the query string specified in the SuggestRequest.

" - }, - "score":{ - "shape":"Long", - "documentation":"

The relevance score of a suggested match.

" - }, - "id":{ - "shape":"String", - "documentation":"

The document ID of the suggested document.

" - } - }, - "documentation":"

An autocomplete suggestion that matches the query string specified in a SuggestRequest.

" - }, - "Suggestions":{ - "type":"list", - "member":{"shape":"SuggestionMatch"} - }, - "SuggestionsSize":{"type":"long"}, - "UploadDocumentsRequest":{ - "type":"structure", - "required":[ - "documents", - "contentType" - ], - "members":{ - "documents":{ - "shape":"Blob", - "documentation":"

A batch of documents formatted in JSON or HTML.

" - }, - "contentType":{ - "shape":"ContentType", - "documentation":"

The format of the batch you are uploading. Amazon CloudSearch supports two document batch formats:

  • application/json
  • application/xml
", - "location":"header", - "locationName":"Content-Type" - } - }, - "documentation":"

Container for the parameters to the UploadDocuments request.

", - "payload":"documents" - }, - "UploadDocumentsResponse":{ - "type":"structure", - "members":{ - "status":{ - "shape":"String", - "documentation":"

The status of an UploadDocumentsRequest.

" - }, - "adds":{ - "shape":"Adds", - "documentation":"

The number of documents that were added to the search domain.

" - }, - "deletes":{ - "shape":"Deletes", - "documentation":"

The number of documents that were deleted from the search domain.

" - }, - "warnings":{ - "shape":"DocumentServiceWarnings", - "documentation":"

Any warnings returned by the document service about the documents being uploaded.

" - } - }, - "documentation":"

Contains the response to an UploadDocuments request.

" - } - }, - "documentation":"

You use the AmazonCloudSearch2013 API to upload documents to a search domain and search those documents.

The endpoints for submitting UploadDocuments, Search, and Suggest requests are domain-specific. To get the endpoints for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. The domain endpoints are also displayed on the domain dashboard in the Amazon CloudSearch console. You submit suggest requests to the search endpoint.

For more information, see the Amazon CloudSearch Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/paginators-1.json deleted file mode 100644 index b550340c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "LookupEvents": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Events" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/service-2.json deleted file mode 100644 index cc0ba898..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudtrail/2013-11-01/service-2.json +++ /dev/null @@ -1,1390 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-11-01", - "endpointPrefix":"cloudtrail", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CloudTrail", - "serviceFullName":"AWS CloudTrail", - "serviceId":"CloudTrail", - "signatureVersion":"v4", - "targetPrefix":"com.amazonaws.cloudtrail.v20131101.CloudTrail_20131101", - "uid":"cloudtrail-2013-11-01" - }, - "operations":{ - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsRequest"}, - "output":{"shape":"AddTagsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"CloudTrailARNInvalidException"}, - {"shape":"ResourceTypeNotSupportedException"}, - {"shape":"TagsLimitExceededException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidTagParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Adds one or more tags to a trail, up to a limit of 50. Tags must be unique per trail. Overwrites an existing tag's value when a new value is specified for an existing tag key. If you specify a key without a value, the tag will be created with the specified key and a value of null. You can tag a trail that applies to all regions only from the region in which the trail was created (that is, from its home region).

", - "idempotent":true - }, - "CreateTrail":{ - "name":"CreateTrail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTrailRequest"}, - "output":{"shape":"CreateTrailResponse"}, - "errors":[ - {"shape":"MaximumNumberOfTrailsExceededException"}, - {"shape":"TrailAlreadyExistsException"}, - {"shape":"S3BucketDoesNotExistException"}, - {"shape":"InsufficientS3BucketPolicyException"}, - {"shape":"InsufficientSnsTopicPolicyException"}, - {"shape":"InsufficientEncryptionPolicyException"}, - {"shape":"InvalidS3BucketNameException"}, - {"shape":"InvalidS3PrefixException"}, - {"shape":"InvalidSnsTopicNameException"}, - {"shape":"InvalidKmsKeyIdException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"TrailNotProvidedException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"KmsKeyNotFoundException"}, - {"shape":"KmsKeyDisabledException"}, - {"shape":"KmsException"}, - {"shape":"InvalidCloudWatchLogsLogGroupArnException"}, - {"shape":"InvalidCloudWatchLogsRoleArnException"}, - {"shape":"CloudWatchLogsDeliveryUnavailableException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket. A maximum of five trails can exist in a region, irrespective of the region in which they were created.

", - "idempotent":true - }, - "DeleteTrail":{ - "name":"DeleteTrail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTrailRequest"}, - "output":{"shape":"DeleteTrailResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidHomeRegionException"} - ], - "documentation":"

Deletes a trail. This operation must be called from the region in which the trail was created. DeleteTrail cannot be called on the shadow trails (replicated trails in other regions) of a trail that is enabled in all regions.

", - "idempotent":true - }, - "DescribeTrails":{ - "name":"DescribeTrails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrailsRequest"}, - "output":{"shape":"DescribeTrailsResponse"}, - "errors":[ - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Retrieves settings for the trail associated with the current region for your account.

", - "idempotent":true - }, - "GetEventSelectors":{ - "name":"GetEventSelectors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetEventSelectorsRequest"}, - "output":{"shape":"GetEventSelectorsResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Describes the settings for the event selectors that you configured for your trail. The information returned for your event selectors includes the following:

  • The S3 objects that you are logging for data events.

  • If your event selector includes management events.

  • If your event selector includes read-only events, write-only events, or all.

For more information, see Logging Data and Management Events for Trails in the AWS CloudTrail User Guide.

", - "idempotent":true - }, - "GetTrailStatus":{ - "name":"GetTrailStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTrailStatusRequest"}, - "output":{"shape":"GetTrailStatusResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"} - ], - "documentation":"

Returns a JSON-formatted list of information about the specified trail. Fields include information on delivery errors, Amazon SNS and Amazon S3 errors, and start and stop logging times for each trail. This operation returns trail status from a single region. To return trail status from all regions, you must call the operation on each region.

", - "idempotent":true - }, - "ListPublicKeys":{ - "name":"ListPublicKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPublicKeysRequest"}, - "output":{"shape":"ListPublicKeysResponse"}, - "errors":[ - {"shape":"InvalidTimeRangeException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidTokenException"} - ], - "documentation":"

Returns all public keys whose private keys were used to sign the digest files within the specified time range. The public key is needed to validate digest files that were signed with its corresponding private key.

CloudTrail uses different private/public key pairs per region. Each digest file is signed with a private key unique to its region. Therefore, when you validate a digest file from a particular region, you must look in the same region for its corresponding public key.

", - "idempotent":true - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"CloudTrailARNInvalidException"}, - {"shape":"ResourceTypeNotSupportedException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidTokenException"} - ], - "documentation":"

Lists the tags for the trail in the current region.

", - "idempotent":true - }, - "LookupEvents":{ - "name":"LookupEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LookupEventsRequest"}, - "output":{"shape":"LookupEventsResponse"}, - "errors":[ - {"shape":"InvalidLookupAttributesException"}, - {"shape":"InvalidTimeRangeException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Looks up API activity events captured by CloudTrail that create, update, or delete resources in your account. Events for a region can be looked up for the times in which you had CloudTrail turned on in that region during the last seven days. Lookup supports the following attributes:

  • Event ID

  • Event name

  • Event source

  • Resource name

  • Resource type

  • User name

All attributes are optional. The default number of results returned is 10, with a maximum of 50 possible. The response includes a token that you can use to get the next page of results.

The rate of lookup requests is limited to one per second per account. If this limit is exceeded, a throttling error occurs.

Events that occurred during the selected time range will not be available for lookup if CloudTrail logging was not enabled when the events occurred.

", - "idempotent":true - }, - "PutEventSelectors":{ - "name":"PutEventSelectors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutEventSelectorsRequest"}, - "output":{"shape":"PutEventSelectorsResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidHomeRegionException"}, - {"shape":"InvalidEventSelectorsException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Configures an event selector for your trail. Use event selectors to specify whether you want your trail to log management and/or data events. When an event occurs in your account, CloudTrail evaluates the event selectors in all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

Example

  1. You create an event selector for a trail and specify that you want write-only events.

  2. The EC2 GetConsoleOutput and RunInstances API operations occur in your account.

  3. CloudTrail evaluates whether the events match your event selectors.

  4. The RunInstances is a write-only event and it matches your event selector. The trail logs the event.

  5. The GetConsoleOutput is a read-only event but it doesn't match your event selector. The trail doesn't log the event.

The PutEventSelectors operation must be called from the region in which the trail was created; otherwise, an InvalidHomeRegionException is thrown.

You can configure up to five event selectors for each trail. For more information, see Logging Data and Management Events for Trails in the AWS CloudTrail User Guide.

", - "idempotent":true - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsRequest"}, - "output":{"shape":"RemoveTagsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"CloudTrailARNInvalidException"}, - {"shape":"ResourceTypeNotSupportedException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidTagParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Removes the specified tags from a trail.

", - "idempotent":true - }, - "StartLogging":{ - "name":"StartLogging", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartLoggingRequest"}, - "output":{"shape":"StartLoggingResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidHomeRegionException"} - ], - "documentation":"

Starts the recording of AWS API calls and log file delivery for a trail. For a trail that is enabled in all regions, this operation must be called from the region in which the trail was created. This operation cannot be called on the shadow trails (replicated trails in other regions) of a trail that is enabled in all regions.

", - "idempotent":true - }, - "StopLogging":{ - "name":"StopLogging", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopLoggingRequest"}, - "output":{"shape":"StopLoggingResponse"}, - "errors":[ - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"InvalidHomeRegionException"} - ], - "documentation":"

Suspends the recording of AWS API calls and log file delivery for the specified trail. Under most circumstances, there is no need to use this action. You can update a trail without stopping it first. This action is the only way to stop recording. For a trail enabled in all regions, this operation must be called from the region in which the trail was created, or an InvalidHomeRegionException will occur. This operation cannot be called on the shadow trails (replicated trails in other regions) of a trail enabled in all regions.

", - "idempotent":true - }, - "UpdateTrail":{ - "name":"UpdateTrail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTrailRequest"}, - "output":{"shape":"UpdateTrailResponse"}, - "errors":[ - {"shape":"S3BucketDoesNotExistException"}, - {"shape":"InsufficientS3BucketPolicyException"}, - {"shape":"InsufficientSnsTopicPolicyException"}, - {"shape":"InsufficientEncryptionPolicyException"}, - {"shape":"TrailNotFoundException"}, - {"shape":"InvalidS3BucketNameException"}, - {"shape":"InvalidS3PrefixException"}, - {"shape":"InvalidSnsTopicNameException"}, - {"shape":"InvalidKmsKeyIdException"}, - {"shape":"InvalidTrailNameException"}, - {"shape":"TrailNotProvidedException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"InvalidHomeRegionException"}, - {"shape":"KmsKeyNotFoundException"}, - {"shape":"KmsKeyDisabledException"}, - {"shape":"KmsException"}, - {"shape":"InvalidCloudWatchLogsLogGroupArnException"}, - {"shape":"InvalidCloudWatchLogsRoleArnException"}, - {"shape":"CloudWatchLogsDeliveryUnavailableException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Updates the settings that specify delivery of log files. Changes to a trail do not require stopping the CloudTrail service. Use this action to designate an existing bucket for log delivery. If the existing bucket has previously been a target for CloudTrail log files, an IAM policy exists for the bucket. UpdateTrail must be called from the region in which the trail was created; otherwise, an InvalidHomeRegionException is thrown.

", - "idempotent":true - } - }, - "shapes":{ - "AddTagsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail to which one or more tags will be added. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "TagsList":{ - "shape":"TagsList", - "documentation":"

Contains a list of CloudTrail tags, up to a limit of 50

" - } - }, - "documentation":"

Specifies the tags to add to a trail.

" - }, - "AddTagsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "Boolean":{"type":"boolean"}, - "ByteBuffer":{"type":"blob"}, - "CloudTrailARNInvalidException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when an operation is called with an invalid trail ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", - "exception":true - }, - "CloudWatchLogsDeliveryUnavailableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cannot set a CloudWatch Logs delivery for this region.

", - "exception":true - }, - "CreateTrailRequest":{ - "type":"structure", - "required":[ - "Name", - "S3BucketName" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name of the trail. The name must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid.

  • Not be in IP address format (for example, 192.168.5.4)

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon S3 bucket designated for publishing log files. See Amazon S3 Bucket Naming Requirements.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files. The maximum length is 200 characters.

" - }, - "SnsTopicName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon SNS topic defined for notification of log file delivery. The maximum length is 256 characters.

" - }, - "IncludeGlobalServiceEvents":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail is publishing events from global services such as IAM to the log files.

" - }, - "IsMultiRegionTrail":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail is created in the current region or in all regions. The default is false.

" - }, - "EnableLogFileValidation":{ - "shape":"Boolean", - "documentation":"

Specifies whether log file integrity validation is enabled. The default is false.

When you disable log file integrity validation, the chain of digest files is broken after one hour. CloudTrail will not create digest files for log files that were delivered during a period in which log file integrity validation was disabled. For example, if you enable log file integrity validation at noon on January 1, disable it at noon on January 2, and re-enable it at noon on January 10, digest files will not be created for the log files delivered from noon on January 2 to noon on January 10. The same applies whenever you stop CloudTrail logging or delete a trail.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"String", - "documentation":"

Specifies a log group name using an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered. Not required unless you specify CloudWatchLogsRoleArn.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

  • alias/MyAliasName

  • arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • 12345678-1234-1234-1234-123456789012

" - } - }, - "documentation":"

Specifies the settings for each trail.

" - }, - "CreateTrailResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name of the trail.

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon S3 bucket designated for publishing log files.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.

" - }, - "SnsTopicName":{ - "shape":"String", - "documentation":"

This field is deprecated. Use SnsTopicARN.

", - "deprecated":true - }, - "SnsTopicARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

" - }, - "IncludeGlobalServiceEvents":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail is publishing events from global services such as IAM to the log files.

" - }, - "IsMultiRegionTrail":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail exists in one region or in all regions.

" - }, - "TrailARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail that was created. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "LogFileValidationEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether log file integrity validation is enabled.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"String", - "documentation":"

Specifies the Amazon Resource Name (ARN) of the log group to which CloudTrail logs will be delivered.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "DataResource":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.

" - }, - "Values":{ - "shape":"DataResourceValues", - "documentation":"

A list of ARN-like strings for the specified S3 objects.

To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.

To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.

" - } - }, - "documentation":"

The Amazon S3 objects that you specify in your event selectors for your trail to log data events. Data events are object-level API operations that access S3 objects, such as GetObject, DeleteObject, and PutObject. You can specify up to 250 S3 buckets and object prefixes for a trail.

Example

  1. You create an event selector for a trail and specify an S3 bucket and an empty prefix, such as arn:aws:s3:::bucket-1/.

  2. You upload an image file to bucket-1.

  3. The PutObject API operation occurs on an object in the S3 bucket that you specified in the event selector. The trail processes and logs the event.

  4. You upload another image file to a different S3 bucket named arn:aws:s3:::bucket-2.

  5. The event occurs on an object in an S3 bucket that you didn't specify in the event selector. The trail doesn’t log the event.

" - }, - "DataResourceValues":{ - "type":"list", - "member":{"shape":"String"} - }, - "DataResources":{ - "type":"list", - "member":{"shape":"DataResource"} - }, - "Date":{"type":"timestamp"}, - "DeleteTrailRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name or the CloudTrail ARN of the trail to be deleted. The format of a trail ARN is: arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - } - }, - "documentation":"

The request that specifies the name of a trail to delete.

" - }, - "DeleteTrailResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "DescribeTrailsRequest":{ - "type":"structure", - "members":{ - "trailNameList":{ - "shape":"TrailNameList", - "documentation":"

Specifies a list of trail names, trail ARNs, or both, of the trails to describe. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

If an empty list is specified, information for the trail in the current region is returned.

  • If an empty list is specified and IncludeShadowTrails is false, then information for all trails in the current region is returned.

  • If an empty list is specified and IncludeShadowTrails is null or true, then information for all trails in the current region and any associated shadow trails in other regions is returned.

If one or more trail names are specified, information is returned only if the names match the names of trails belonging only to the current region. To return information about a trail in another region, you must specify its trail ARN.

" - }, - "includeShadowTrails":{ - "shape":"Boolean", - "documentation":"

Specifies whether to include shadow trails in the response. A shadow trail is the replication in a region of a trail that was created in a different region. The default is true.

" - } - }, - "documentation":"

Returns information about the trail.

" - }, - "DescribeTrailsResponse":{ - "type":"structure", - "members":{ - "trailList":{ - "shape":"TrailList", - "documentation":"

The list of trail objects.

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "Event":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"String", - "documentation":"

The CloudTrail ID of the event returned.

" - }, - "EventName":{ - "shape":"String", - "documentation":"

The name of the event returned.

" - }, - "EventTime":{ - "shape":"Date", - "documentation":"

The date and time of the event returned.

" - }, - "EventSource":{ - "shape":"String", - "documentation":"

The AWS service that the request was made to.

" - }, - "Username":{ - "shape":"String", - "documentation":"

A user name or role name of the requester that called the API in the event returned.

" - }, - "Resources":{ - "shape":"ResourceList", - "documentation":"

A list of resources referenced by the event returned.

" - }, - "CloudTrailEvent":{ - "shape":"String", - "documentation":"

A JSON string that contains a representation of the event returned.

" - } - }, - "documentation":"

Contains information about an event that was returned by a lookup request. The result includes a representation of a CloudTrail event.

" - }, - "EventSelector":{ - "type":"structure", - "members":{ - "ReadWriteType":{ - "shape":"ReadWriteType", - "documentation":"

Specify if you want your trail to log read-only events, write-only events, or all. For example, the EC2 GetConsoleOutput is a read-only API operation and RunInstances is a write-only API operation.

By default, the value is All.

" - }, - "IncludeManagementEvents":{ - "shape":"Boolean", - "documentation":"

Specify if you want your event selector to include management events for your trail.

For more information, see Management Events in the AWS CloudTrail User Guide.

By default, the value is true.

" - }, - "DataResources":{ - "shape":"DataResources", - "documentation":"

CloudTrail supports logging only data events for S3 objects. You can specify up to 250 S3 buckets and object prefixes for a trail.

For more information, see Data Events in the AWS CloudTrail User Guide.

" - } - }, - "documentation":"

Use event selectors to specify whether you want your trail to log management and/or data events. When an event occurs in your account, CloudTrail evaluates the event selector for all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

You can configure up to five event selectors for a trail.

" - }, - "EventSelectors":{ - "type":"list", - "member":{"shape":"EventSelector"} - }, - "EventsList":{ - "type":"list", - "member":{"shape":"Event"} - }, - "GetEventSelectorsRequest":{ - "type":"structure", - "required":["TrailName"], - "members":{ - "TrailName":{ - "shape":"String", - "documentation":"

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid.

  • Not be in IP address format (for example, 192.168.5.4)

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - } - } - }, - "GetEventSelectorsResponse":{ - "type":"structure", - "members":{ - "TrailARN":{ - "shape":"String", - "documentation":"

The specified trail ARN that has the event selectors.

" - }, - "EventSelectors":{ - "shape":"EventSelectors", - "documentation":"

The event selectors that are configured for the trail.

" - } - } - }, - "GetTrailStatusRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name or the CloudTrail ARN of the trail for which you are requesting status. To get the status of a shadow trail (a replication of the trail in another region), you must specify its ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - } - }, - "documentation":"

The name of a trail about which you want the current status.

" - }, - "GetTrailStatusResponse":{ - "type":"structure", - "members":{ - "IsLogging":{ - "shape":"Boolean", - "documentation":"

Whether the CloudTrail is currently logging AWS API calls.

" - }, - "LatestDeliveryError":{ - "shape":"String", - "documentation":"

Displays any Amazon S3 error that CloudTrail encountered when attempting to deliver log files to the designated bucket. For more information see the topic Error Responses in the Amazon S3 API Reference.

This error occurs only when there is a problem with the destination S3 bucket and will not occur for timeouts. To resolve the issue, create a new bucket and call UpdateTrail to specify the new bucket, or fix the existing objects so that CloudTrail can again write to the bucket.

" - }, - "LatestNotificationError":{ - "shape":"String", - "documentation":"

Displays any Amazon SNS error that CloudTrail encountered when attempting to send a notification. For more information about Amazon SNS errors, see the Amazon SNS Developer Guide.

" - }, - "LatestDeliveryTime":{ - "shape":"Date", - "documentation":"

Specifies the date and time that CloudTrail last delivered log files to an account's Amazon S3 bucket.

" - }, - "LatestNotificationTime":{ - "shape":"Date", - "documentation":"

Specifies the date and time of the most recent Amazon SNS notification that CloudTrail has written a new log file to an account's Amazon S3 bucket.

" - }, - "StartLoggingTime":{ - "shape":"Date", - "documentation":"

Specifies the most recent date and time when CloudTrail started recording API calls for an AWS account.

" - }, - "StopLoggingTime":{ - "shape":"Date", - "documentation":"

Specifies the most recent date and time when CloudTrail stopped recording API calls for an AWS account.

" - }, - "LatestCloudWatchLogsDeliveryError":{ - "shape":"String", - "documentation":"

Displays any CloudWatch Logs error that CloudTrail encountered when attempting to deliver logs to CloudWatch Logs.

" - }, - "LatestCloudWatchLogsDeliveryTime":{ - "shape":"Date", - "documentation":"

Displays the most recent date and time when CloudTrail delivered logs to CloudWatch Logs.

" - }, - "LatestDigestDeliveryTime":{ - "shape":"Date", - "documentation":"

Specifies the date and time that CloudTrail last delivered a digest file to an account's Amazon S3 bucket.

" - }, - "LatestDigestDeliveryError":{ - "shape":"String", - "documentation":"

Displays any Amazon S3 error that CloudTrail encountered when attempting to deliver a digest file to the designated bucket. For more information see the topic Error Responses in the Amazon S3 API Reference.

This error occurs only when there is a problem with the destination S3 bucket and will not occur for timeouts. To resolve the issue, create a new bucket and call UpdateTrail to specify the new bucket, or fix the existing objects so that CloudTrail can again write to the bucket.

" - }, - "LatestDeliveryAttemptTime":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - }, - "LatestNotificationAttemptTime":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - }, - "LatestNotificationAttemptSucceeded":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - }, - "LatestDeliveryAttemptSucceeded":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - }, - "TimeLoggingStarted":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - }, - "TimeLoggingStopped":{ - "shape":"String", - "documentation":"

This field is deprecated.

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "InsufficientEncryptionPolicyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the policy on the S3 bucket or KMS key is not sufficient.

", - "exception":true - }, - "InsufficientS3BucketPolicyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the policy on the S3 bucket is not sufficient.

", - "exception":true - }, - "InsufficientSnsTopicPolicyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the policy on the SNS topic is not sufficient.

", - "exception":true - }, - "InvalidCloudWatchLogsLogGroupArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided CloudWatch log group is not valid.

", - "exception":true - }, - "InvalidCloudWatchLogsRoleArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided role is not valid.

", - "exception":true - }, - "InvalidEventSelectorsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the PutEventSelectors operation is called with an invalid number of event selectors, data resources, or an invalid value for a parameter:

  • Specify a valid number of event selectors (1 to 5) for a trail.

  • Specify a valid number of data resources (1 to 250) for an event selector.

  • Specify a valid value for a parameter. For example, specifying the ReadWriteType parameter with a value of read-only is invalid.

", - "exception":true - }, - "InvalidHomeRegionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when an operation is called on a trail from a region other than the region in which the trail was created.

", - "exception":true - }, - "InvalidKmsKeyIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the KMS key ARN is invalid.

", - "exception":true - }, - "InvalidLookupAttributesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Occurs when an invalid lookup attribute is specified.

", - "exception":true - }, - "InvalidMaxResultsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown if the limit specified is invalid.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Invalid token or token that was previously used in a request with different parameters. This exception is thrown if the token is invalid.

", - "exception":true - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the combination of parameters provided is not valid.

", - "exception":true - }, - "InvalidS3BucketNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided S3 bucket name is not valid.

", - "exception":true - }, - "InvalidS3PrefixException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided S3 prefix is not valid.

", - "exception":true - }, - "InvalidSnsTopicNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided SNS topic name is not valid.

", - "exception":true - }, - "InvalidTagParameterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the key or value specified for the tag does not match the regular expression ^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-@]*)$.

", - "exception":true - }, - "InvalidTimeRangeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Occurs if the timestamp values are invalid. Either the start time occurs after the end time or the time range is outside the range of possible values.

", - "exception":true - }, - "InvalidTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Reserved for future use.

", - "exception":true - }, - "InvalidTrailNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the provided trail name is not valid. Trail names must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid.

  • Not be in IP address format (for example, 192.168.5.4)

", - "exception":true - }, - "KmsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when there is an issue with the specified KMS key and the trail can’t be updated.

", - "exception":true - }, - "KmsKeyDisabledException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is deprecated.

", - "deprecated":true, - "exception":true - }, - "KmsKeyNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the KMS key does not exist, or when the S3 bucket and the KMS key are not in the same region.

", - "exception":true - }, - "ListPublicKeysRequest":{ - "type":"structure", - "members":{ - "StartTime":{ - "shape":"Date", - "documentation":"

Optionally specifies, in UTC, the start of the time range to look up public keys for CloudTrail digest files. If not specified, the current time is used, and the current public key is returned.

" - }, - "EndTime":{ - "shape":"Date", - "documentation":"

Optionally specifies, in UTC, the end of the time range to look up public keys for CloudTrail digest files. If not specified, the current time is used.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

Requests the public keys for a specified time range.

" - }, - "ListPublicKeysResponse":{ - "type":"structure", - "members":{ - "PublicKeyList":{ - "shape":"PublicKeyList", - "documentation":"

Contains an array of PublicKey objects.

The returned public keys may have validity time ranges that overlap.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "ListTagsRequest":{ - "type":"structure", - "required":["ResourceIdList"], - "members":{ - "ResourceIdList":{ - "shape":"ResourceIdList", - "documentation":"

Specifies a list of trail ARNs whose tags will be listed. The list has a limit of 20 ARNs. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

Specifies a list of trail tags to return.

" - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "ResourceTagList":{ - "shape":"ResourceTagList", - "documentation":"

A list of resource tags.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "LookupAttribute":{ - "type":"structure", - "required":[ - "AttributeKey", - "AttributeValue" - ], - "members":{ - "AttributeKey":{ - "shape":"LookupAttributeKey", - "documentation":"

Specifies an attribute on which to filter the events returned.

" - }, - "AttributeValue":{ - "shape":"String", - "documentation":"

Specifies a value for the specified AttributeKey.

" - } - }, - "documentation":"

Specifies an attribute and value that filter the events returned.

" - }, - "LookupAttributeKey":{ - "type":"string", - "enum":[ - "EventId", - "EventName", - "Username", - "ResourceType", - "ResourceName", - "EventSource" - ] - }, - "LookupAttributesList":{ - "type":"list", - "member":{"shape":"LookupAttribute"} - }, - "LookupEventsRequest":{ - "type":"structure", - "members":{ - "LookupAttributes":{ - "shape":"LookupAttributesList", - "documentation":"

Contains a list of lookup attributes. Currently the list can contain only one item.

" - }, - "StartTime":{ - "shape":"Date", - "documentation":"

Specifies that only events that occur after or at the specified time are returned. If the specified start time is after the specified end time, an error is returned.

" - }, - "EndTime":{ - "shape":"Date", - "documentation":"

Specifies that only events that occur before or at the specified time are returned. If the specified end time is before the specified start time, an error is returned.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The number of events to return. Possible values are 1 through 50. The default is 10.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to get the next page of results after a previous API call. This token must be passed in with the same parameters that were specified in the the original call. For example, if the original call specified an AttributeKey of 'Username' with a value of 'root', the call with NextToken should include those same parameters.

" - } - }, - "documentation":"

Contains a request for LookupEvents.

" - }, - "LookupEventsResponse":{ - "type":"structure", - "members":{ - "Events":{ - "shape":"EventsList", - "documentation":"

A list of events returned based on the lookup attributes specified and the CloudTrail event. The events list is sorted by time. The most recent event is listed first.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to get the next page of results after a previous API call. If the token does not appear, there are no more results to return. The token must be passed in with the same parameters as the previous call. For example, if the original call specified an AttributeKey of 'Username' with a value of 'root', the call with NextToken should include those same parameters.

" - } - }, - "documentation":"

Contains a response to a LookupEvents action.

" - }, - "MaxResults":{ - "type":"integer", - "max":50, - "min":1 - }, - "MaximumNumberOfTrailsExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the maximum number of trails is reached.

", - "exception":true - }, - "NextToken":{"type":"string"}, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the requested operation is not permitted.

", - "exception":true - }, - "PublicKey":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"ByteBuffer", - "documentation":"

The DER encoded public key value in PKCS#1 format.

" - }, - "ValidityStartTime":{ - "shape":"Date", - "documentation":"

The starting time of validity of the public key.

" - }, - "ValidityEndTime":{ - "shape":"Date", - "documentation":"

The ending time of validity of the public key.

" - }, - "Fingerprint":{ - "shape":"String", - "documentation":"

The fingerprint of the public key.

" - } - }, - "documentation":"

Contains information about a returned public key.

" - }, - "PublicKeyList":{ - "type":"list", - "member":{"shape":"PublicKey"} - }, - "PutEventSelectorsRequest":{ - "type":"structure", - "required":[ - "TrailName", - "EventSelectors" - ], - "members":{ - "TrailName":{ - "shape":"String", - "documentation":"

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid.

  • Not be in IP address format (for example, 192.168.5.4)

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "EventSelectors":{ - "shape":"EventSelectors", - "documentation":"

Specifies the settings for your event selectors. You can configure up to five event selectors for a trail.

" - } - } - }, - "PutEventSelectorsResponse":{ - "type":"structure", - "members":{ - "TrailARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail that was updated with event selectors. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "EventSelectors":{ - "shape":"EventSelectors", - "documentation":"

Specifies the event selectors configured for your trail.

" - } - } - }, - "ReadWriteType":{ - "type":"string", - "enum":[ - "ReadOnly", - "WriteOnly", - "All" - ] - }, - "RemoveTagsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail from which tags should be removed. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "TagsList":{ - "shape":"TagsList", - "documentation":"

Specifies a list of tags to be removed.

" - } - }, - "documentation":"

Specifies the tags to remove from a trail.

" - }, - "RemoveTagsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "Resource":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"String", - "documentation":"

The type of a resource referenced by the event returned. When the resource type cannot be determined, null is returned. Some examples of resource types are: Instance for EC2, Trail for CloudTrail, DBInstance for RDS, and AccessKey for IAM. For a list of resource types supported for event lookup, see Resource Types Supported for Event Lookup.

" - }, - "ResourceName":{ - "shape":"String", - "documentation":"

The name of the resource referenced by the event returned. These are user-created names whose values will depend on the environment. For example, the resource name might be \"auto-scaling-test-group\" for an Auto Scaling Group or \"i-1234567\" for an EC2 Instance.

" - } - }, - "documentation":"

Specifies the type and name of a resource referenced by an event.

" - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceList":{ - "type":"list", - "member":{"shape":"Resource"}, - "documentation":"

A list of resources referenced by the event returned.

" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the specified resource is not found.

", - "exception":true - }, - "ResourceTag":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

Specifies the ARN of the resource.

" - }, - "TagsList":{ - "shape":"TagsList", - "documentation":"

A list of tags.

" - } - }, - "documentation":"

A resource tag.

" - }, - "ResourceTagList":{ - "type":"list", - "member":{"shape":"ResourceTag"} - }, - "ResourceTypeNotSupportedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the specified resource type is not supported by CloudTrail.

", - "exception":true - }, - "S3BucketDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the specified S3 bucket does not exist.

", - "exception":true - }, - "StartLoggingRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail logs AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - } - }, - "documentation":"

The request to CloudTrail to start logging AWS API calls for an account.

" - }, - "StartLoggingResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "StopLoggingRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail will stop logging AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - } - }, - "documentation":"

Passes the request to CloudTrail to stop logging AWS API calls for the specified account.

" - }, - "StopLoggingResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - }, - "String":{"type":"string"}, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.

" - } - }, - "documentation":"

A custom key-value pair associated with a resource such as a CloudTrail trail.

" - }, - "TagsLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of tags per trail has exceeded the permitted amount. Currently, the limit is 50.

", - "exception":true - }, - "TagsList":{ - "type":"list", - "member":{"shape":"Tag"}, - "documentation":"

A list of tags.

" - }, - "Trail":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Name of the trail set by calling CreateTrail. The maximum length is 128 characters.

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Name of the Amazon S3 bucket into which CloudTrail delivers your trail files. See Amazon S3 Bucket Naming Requirements.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.The maximum length is 200 characters.

" - }, - "SnsTopicName":{ - "shape":"String", - "documentation":"

This field is deprecated. Use SnsTopicARN.

", - "deprecated":true - }, - "SnsTopicARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

" - }, - "IncludeGlobalServiceEvents":{ - "shape":"Boolean", - "documentation":"

Set to True to include AWS API calls from AWS global services such as IAM. Otherwise, False.

" - }, - "IsMultiRegionTrail":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail belongs only to one region or exists in all regions.

" - }, - "HomeRegion":{ - "shape":"String", - "documentation":"

The region in which the trail was created.

" - }, - "TrailARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "LogFileValidationEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether log file validation is enabled.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"String", - "documentation":"

Specifies an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

" - }, - "HasCustomEventSelectors":{ - "shape":"Boolean", - "documentation":"

Specifies if the trail has custom event selectors.

" - } - }, - "documentation":"

The settings for a trail.

" - }, - "TrailAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the specified trail already exists.

", - "exception":true - }, - "TrailList":{ - "type":"list", - "member":{"shape":"Trail"} - }, - "TrailNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "TrailNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the trail with the given name is not found.

", - "exception":true - }, - "TrailNotProvidedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is deprecated.

", - "exception":true - }, - "UnsupportedOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown when the requested operation is not supported.

", - "exception":true - }, - "UpdateTrailRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name of the trail or trail ARN. If Name is a trail name, the string must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like my-_namespace and my--namespace are invalid.

  • Not be in IP address format (for example, 192.168.5.4)

If Name is a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon S3 bucket designated for publishing log files. See Amazon S3 Bucket Naming Requirements.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files. The maximum length is 200 characters.

" - }, - "SnsTopicName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon SNS topic defined for notification of log file delivery. The maximum length is 256 characters.

" - }, - "IncludeGlobalServiceEvents":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail is publishing events from global services such as IAM to the log files.

" - }, - "IsMultiRegionTrail":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail applies only to the current region or to all regions. The default is false. If the trail exists only in the current region and this value is set to true, shadow trails (replications of the trail) will be created in the other regions. If the trail exists in all regions and this value is set to false, the trail will remain in the region where it was created, and its shadow trails in other regions will be deleted.

" - }, - "EnableLogFileValidation":{ - "shape":"Boolean", - "documentation":"

Specifies whether log file validation is enabled. The default is false.

When you disable log file integrity validation, the chain of digest files is broken after one hour. CloudTrail will not create digest files for log files that were delivered during a period in which log file integrity validation was disabled. For example, if you enable log file integrity validation at noon on January 1, disable it at noon on January 2, and re-enable it at noon on January 10, digest files will not be created for the log files delivered from noon on January 2 to noon on January 10. The same applies whenever you stop CloudTrail logging or delete a trail.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"String", - "documentation":"

Specifies a log group name using an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered. Not required unless you specify CloudWatchLogsRoleArn.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

  • alias/MyAliasName

  • arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • 12345678-1234-1234-1234-123456789012

" - } - }, - "documentation":"

Specifies settings to update for the trail.

" - }, - "UpdateTrailResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Specifies the name of the trail.

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

Specifies the name of the Amazon S3 bucket designated for publishing log files.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.

" - }, - "SnsTopicName":{ - "shape":"String", - "documentation":"

This field is deprecated. Use SnsTopicARN.

", - "deprecated":true - }, - "SnsTopicARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

" - }, - "IncludeGlobalServiceEvents":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail is publishing events from global services such as IAM to the log files.

" - }, - "IsMultiRegionTrail":{ - "shape":"Boolean", - "documentation":"

Specifies whether the trail exists in one region or in all regions.

" - }, - "TrailARN":{ - "shape":"String", - "documentation":"

Specifies the ARN of the trail that was updated. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" - }, - "LogFileValidationEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether log file integrity validation is enabled.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"String", - "documentation":"

Specifies the Amazon Resource Name (ARN) of the log group to which CloudTrail logs will be delivered.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"String", - "documentation":"

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

" - } - }, - "documentation":"

Returns the objects or data listed below if successful. Otherwise, returns an error.

" - } - }, - "documentation":"AWS CloudTrail

This is the CloudTrail API Reference. It provides descriptions of actions, data types, common parameters, and common errors for CloudTrail.

CloudTrail is a web service that records AWS API calls for your AWS account and delivers log files to an Amazon S3 bucket. The recorded information includes the identity of the user, the start time of the AWS API call, the source IP address, the request parameters, and the response elements returned by the service.

As an alternative to the API, you can use one of the AWS SDKs, which consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to AWSCloudTrail. For example, the SDKs take care of cryptographically signing requests, managing errors, and retrying requests automatically. For information about the AWS SDKs, including how to download and install them, see the Tools for Amazon Web Services page.

See the AWS CloudTrail User Guide for information about the data that is included with each AWS API call listed in the log files.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/paginators-1.json deleted file mode 100644 index b0bf527f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/paginators-1.json +++ /dev/null @@ -1,26 +0,0 @@ -{ - "pagination": { - "DescribeAlarmHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "AlarmHistoryItems" - }, - "DescribeAlarms": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "MetricAlarms" - }, - "ListDashboards": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "DashboardEntries" - }, - "ListMetrics": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Metrics" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/service-2.json deleted file mode 100644 index a572ec7b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/service-2.json +++ /dev/null @@ -1,1726 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-08-01", - "endpointPrefix":"monitoring", - "protocol":"query", - "serviceAbbreviation":"CloudWatch", - "serviceFullName":"Amazon CloudWatch", - "serviceId":"CloudWatch", - "signatureVersion":"v4", - "uid":"monitoring-2010-08-01", - "xmlNamespace":"http://monitoring.amazonaws.com/doc/2010-08-01/" - }, - "operations":{ - "DeleteAlarms":{ - "name":"DeleteAlarms", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAlarmsInput"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Deletes the specified alarms. In the event of an error, no alarms are deleted.

" - }, - "DeleteDashboards":{ - "name":"DeleteDashboards", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDashboardsInput"}, - "output":{ - "shape":"DeleteDashboardsOutput", - "resultWrapper":"DeleteDashboardsResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"DashboardNotFoundError"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Deletes all dashboards that you specify. You may specify up to 100 dashboards to delete. If there is an error during this call, no dashboards are deleted.

" - }, - "DescribeAlarmHistory":{ - "name":"DescribeAlarmHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAlarmHistoryInput"}, - "output":{ - "shape":"DescribeAlarmHistoryOutput", - "resultWrapper":"DescribeAlarmHistoryResult" - }, - "errors":[ - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieves the history for the specified alarm. You can filter the results by date range or item type. If an alarm name is not specified, the histories for all alarms are returned.

CloudWatch retains the history of an alarm even if you delete the alarm.

" - }, - "DescribeAlarms":{ - "name":"DescribeAlarms", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAlarmsInput"}, - "output":{ - "shape":"DescribeAlarmsOutput", - "resultWrapper":"DescribeAlarmsResult" - }, - "errors":[ - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieves the specified alarms. If no alarms are specified, all alarms are returned. Alarms can be retrieved by using only a prefix for the alarm name, the alarm state, or a prefix for any action.

" - }, - "DescribeAlarmsForMetric":{ - "name":"DescribeAlarmsForMetric", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAlarmsForMetricInput"}, - "output":{ - "shape":"DescribeAlarmsForMetricOutput", - "resultWrapper":"DescribeAlarmsForMetricResult" - }, - "documentation":"

Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit.

" - }, - "DisableAlarmActions":{ - "name":"DisableAlarmActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableAlarmActionsInput"}, - "documentation":"

Disables the actions for the specified alarms. When an alarm's actions are disabled, the alarm actions do not execute when the alarm state changes.

" - }, - "EnableAlarmActions":{ - "name":"EnableAlarmActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableAlarmActionsInput"}, - "documentation":"

Enables the actions for the specified alarms.

" - }, - "GetDashboard":{ - "name":"GetDashboard", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDashboardInput"}, - "output":{ - "shape":"GetDashboardOutput", - "resultWrapper":"GetDashboardResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"DashboardNotFoundError"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Displays the details of the dashboard that you specify.

To copy an existing dashboard, use GetDashboard, and then use the data returned within DashboardBody as the template for the new dashboard when you call PutDashboard to create the copy.

" - }, - "GetMetricData":{ - "name":"GetMetricData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMetricDataInput"}, - "output":{ - "shape":"GetMetricDataOutput", - "resultWrapper":"GetMetricDataResult" - }, - "errors":[ - {"shape":"InvalidNextToken"} - ], - "documentation":"

You can use the GetMetricData API to retrieve as many as 100 different metrics in a single request, with a total of as many as 100,800 datapoints. You can also optionally perform math expressions on the values of the returned statistics, to create new time series that represent new insights into your data. For example, using Lambda metrics, you could divide the Errors metric by the Invocations metric to get an error rate time series. For more information about metric math expressions, see Metric Math Syntax and Functions in the Amazon CloudWatch User Guide.

Calls to the GetMetricData API have a different pricing structure than calls to GetMetricStatistics. For more information about pricing, see Amazon CloudWatch Pricing.

" - }, - "GetMetricStatistics":{ - "name":"GetMetricStatistics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMetricStatisticsInput"}, - "output":{ - "shape":"GetMetricStatisticsOutput", - "resultWrapper":"GetMetricStatisticsResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Gets statistics for the specified metric.

The maximum number of data points returned from a single call is 1,440. If you request more than 1,440 data points, CloudWatch returns an error. To reduce the number of data points, you can narrow the specified time range and make multiple requests across adjacent time ranges, or you can increase the specified period. Data points are not returned in chronological order.

CloudWatch aggregates data points based on the length of the period that you specify. For example, if you request statistics with a one-hour period, CloudWatch aggregates all data points with time stamps that fall within each one-hour period. Therefore, the number of values aggregated by CloudWatch is larger than the number of data points returned.

CloudWatch needs raw data points to calculate percentile statistics. If you publish data using a statistic set instead, you can only retrieve percentile statistics for this data if one of the following conditions is true:

  • The SampleCount value of the statistic set is 1.

  • The Min and the Max values of the statistic set are equal.

Amazon CloudWatch retains metric data as follows:

  • Data points with a period of less than 60 seconds are available for 3 hours. These data points are high-resolution metrics and are available only for custom metrics that have been defined with a StorageResolution of 1.

  • Data points with a period of 60 seconds (1-minute) are available for 15 days.

  • Data points with a period of 300 seconds (5-minute) are available for 63 days.

  • Data points with a period of 3600 seconds (1 hour) are available for 455 days (15 months).

Data points that are initially published with a shorter period are aggregated together for long-term storage. For example, if you collect data using a period of 1 minute, the data remains available for 15 days with 1-minute resolution. After 15 days, this data is still available, but is aggregated and retrievable only with a resolution of 5 minutes. After 63 days, the data is further aggregated and is available with a resolution of 1 hour.

CloudWatch started retaining 5-minute and 1-hour metric data as of July 9, 2016.

For information about metrics and dimensions supported by AWS services, see the Amazon CloudWatch Metrics and Dimensions Reference in the Amazon CloudWatch User Guide.

" - }, - "ListDashboards":{ - "name":"ListDashboards", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDashboardsInput"}, - "output":{ - "shape":"ListDashboardsOutput", - "resultWrapper":"ListDashboardsResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Returns a list of the dashboards for your account. If you include DashboardNamePrefix, only those dashboards with names starting with the prefix are listed. Otherwise, all dashboards in your account are listed.

" - }, - "ListMetrics":{ - "name":"ListMetrics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListMetricsInput"}, - "output":{ - "shape":"ListMetricsOutput", - "resultWrapper":"ListMetricsResult" - }, - "errors":[ - {"shape":"InternalServiceFault"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

List the specified metrics. You can use the returned metrics with GetMetricStatistics to obtain statistical data.

Up to 500 results are returned for any one call. To retrieve additional results, use the returned token with subsequent calls.

After you create a metric, allow up to fifteen minutes before the metric appears. Statistics about the metric, however, are available sooner using GetMetricStatistics.

" - }, - "PutDashboard":{ - "name":"PutDashboard", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutDashboardInput"}, - "output":{ - "shape":"PutDashboardOutput", - "resultWrapper":"PutDashboardResult" - }, - "errors":[ - {"shape":"DashboardInvalidInputError"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Creates a dashboard if it does not already exist, or updates an existing dashboard. If you update a dashboard, the entire contents are replaced with what you specify here.

You can have up to 500 dashboards per account. All dashboards in your account are global, not region-specific.

A simple way to create a dashboard using PutDashboard is to copy an existing dashboard. To copy an existing dashboard using the console, you can load the dashboard and then use the View/edit source command in the Actions menu to display the JSON block for that dashboard. Another way to copy a dashboard is to use GetDashboard, and then use the data returned within DashboardBody as the template for the new dashboard when you call PutDashboard.

When you create a dashboard with PutDashboard, a good practice is to add a text widget at the top of the dashboard with a message that the dashboard was created by script and should not be changed in the console. This message could also point console users to the location of the DashboardBody script or the CloudFormation template used to create the dashboard.

" - }, - "PutMetricAlarm":{ - "name":"PutMetricAlarm", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutMetricAlarmInput"}, - "errors":[ - {"shape":"LimitExceededFault"} - ], - "documentation":"

Creates or updates an alarm and associates it with the specified metric. Optionally, this operation can associate one or more Amazon SNS resources with the alarm.

When this operation creates an alarm, the alarm state is immediately set to INSUFFICIENT_DATA. The alarm is evaluated and its state is set appropriately. Any actions associated with the state are then executed.

When you update an existing alarm, its state is left unchanged, but the update completely overwrites the previous configuration of the alarm.

If you are an IAM user, you must have Amazon EC2 permissions for some operations:

  • iam:CreateServiceLinkedRole for all alarms with EC2 actions

  • ec2:DescribeInstanceStatus and ec2:DescribeInstances for all alarms on EC2 instance status metrics

  • ec2:StopInstances for alarms with stop actions

  • ec2:TerminateInstances for alarms with terminate actions

  • ec2:DescribeInstanceRecoveryAttribute and ec2:RecoverInstances for alarms with recover actions

If you have read/write permissions for Amazon CloudWatch but not for Amazon EC2, you can still create an alarm, but the stop or terminate actions are not performed. However, if you are later granted the required permissions, the alarm actions that you created earlier are performed.

If you are using an IAM role (for example, an EC2 instance profile), you cannot stop or terminate the instance using alarm actions. However, you can still see the alarm state and perform any other actions such as Amazon SNS notifications or Auto Scaling policies.

If you are using temporary security credentials granted using AWS STS, you cannot stop or terminate an EC2 instance using alarm actions.

You must create at least one stop, terminate, or reboot alarm using either the Amazon EC2 or CloudWatch consoles to create the EC2ActionsAccess IAM role. After this IAM role is created, you can create stop, terminate, or reboot alarms using a command-line interface or API.

" - }, - "PutMetricData":{ - "name":"PutMetricData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutMetricDataInput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"InternalServiceFault"} - ], - "documentation":"

Publishes metric data points to Amazon CloudWatch. CloudWatch associates the data points with the specified metric. If the specified metric does not exist, CloudWatch creates the metric. When CloudWatch creates a metric, it can take up to fifteen minutes for the metric to appear in calls to ListMetrics.

Each PutMetricData request is limited to 40 KB in size for HTTP POST requests.

Although the Value parameter accepts numbers of type Double, CloudWatch rejects values that are either too small or too large. Values must be in the range of 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2). In addition, special values (for example, NaN, +Infinity, -Infinity) are not supported.

You can use up to 10 dimensions per metric to further clarify what data the metric collects. For more information about specifying dimensions, see Publishing Metrics in the Amazon CloudWatch User Guide.

Data points with time stamps from 24 hours ago or longer can take at least 48 hours to become available for GetMetricStatistics from the time they are submitted.

CloudWatch needs raw data points to calculate percentile statistics. If you publish data using a statistic set instead, you can only retrieve percentile statistics for this data if one of the following conditions is true:

  • The SampleCount value of the statistic set is 1

  • The Min and the Max values of the statistic set are equal

" - }, - "SetAlarmState":{ - "name":"SetAlarmState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetAlarmStateInput"}, - "errors":[ - {"shape":"ResourceNotFound"}, - {"shape":"InvalidFormatFault"} - ], - "documentation":"

Temporarily sets the state of an alarm for testing purposes. When the updated state differs from the previous value, the action configured for the appropriate state is invoked. For example, if your alarm is configured to send an Amazon SNS message when an alarm is triggered, temporarily changing the alarm state to ALARM sends an SNS message. The alarm returns to its actual state (often within seconds). Because the alarm state change happens quickly, it is typically only visible in the alarm's History tab in the Amazon CloudWatch console or through DescribeAlarmHistory.

" - } - }, - "shapes":{ - "ActionPrefix":{ - "type":"string", - "max":1024, - "min":1 - }, - "ActionsEnabled":{"type":"boolean"}, - "AlarmArn":{ - "type":"string", - "max":1600, - "min":1 - }, - "AlarmDescription":{ - "type":"string", - "max":1024, - "min":0 - }, - "AlarmHistoryItem":{ - "type":"structure", - "members":{ - "AlarmName":{ - "shape":"AlarmName", - "documentation":"

The descriptive name for the alarm.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp for the alarm history item.

" - }, - "HistoryItemType":{ - "shape":"HistoryItemType", - "documentation":"

The type of alarm history item.

" - }, - "HistorySummary":{ - "shape":"HistorySummary", - "documentation":"

A summary of the alarm history, in text format.

" - }, - "HistoryData":{ - "shape":"HistoryData", - "documentation":"

Data about the alarm, in JSON format.

" - } - }, - "documentation":"

Represents the history of a specific alarm.

" - }, - "AlarmHistoryItems":{ - "type":"list", - "member":{"shape":"AlarmHistoryItem"} - }, - "AlarmName":{ - "type":"string", - "max":255, - "min":1 - }, - "AlarmNamePrefix":{ - "type":"string", - "max":255, - "min":1 - }, - "AlarmNames":{ - "type":"list", - "member":{"shape":"AlarmName"}, - "max":100 - }, - "AwsQueryErrorMessage":{"type":"string"}, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "GreaterThanOrEqualToThreshold", - "GreaterThanThreshold", - "LessThanThreshold", - "LessThanOrEqualToThreshold" - ] - }, - "DashboardArn":{"type":"string"}, - "DashboardBody":{"type":"string"}, - "DashboardEntries":{ - "type":"list", - "member":{"shape":"DashboardEntry"} - }, - "DashboardEntry":{ - "type":"structure", - "members":{ - "DashboardName":{ - "shape":"DashboardName", - "documentation":"

The name of the dashboard.

" - }, - "DashboardArn":{ - "shape":"DashboardArn", - "documentation":"

The Amazon Resource Name (ARN) of the dashboard.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

The time stamp of when the dashboard was last modified, either by an API call or through the console. This number is expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.

" - }, - "Size":{ - "shape":"Size", - "documentation":"

The size of the dashboard, in bytes.

" - } - }, - "documentation":"

Represents a specific dashboard.

" - }, - "DashboardErrorMessage":{"type":"string"}, - "DashboardInvalidInputError":{ - "type":"structure", - "members":{ - "message":{"shape":"DashboardErrorMessage"}, - "dashboardValidationMessages":{"shape":"DashboardValidationMessages"} - }, - "documentation":"

Some part of the dashboard data is invalid.

", - "error":{ - "code":"InvalidParameterInput", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DashboardName":{"type":"string"}, - "DashboardNamePrefix":{"type":"string"}, - "DashboardNames":{ - "type":"list", - "member":{"shape":"DashboardName"} - }, - "DashboardNotFoundError":{ - "type":"structure", - "members":{ - "message":{"shape":"DashboardErrorMessage"} - }, - "documentation":"

The specified dashboard does not exist.

", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DashboardValidationMessage":{ - "type":"structure", - "members":{ - "DataPath":{ - "shape":"DataPath", - "documentation":"

The data path related to the message.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A message describing the error or warning.

" - } - }, - "documentation":"

An error or warning for the operation.

" - }, - "DashboardValidationMessages":{ - "type":"list", - "member":{"shape":"DashboardValidationMessage"} - }, - "DataPath":{"type":"string"}, - "Datapoint":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp used for the data point.

" - }, - "SampleCount":{ - "shape":"DatapointValue", - "documentation":"

The number of metric values that contributed to the aggregate value of this data point.

" - }, - "Average":{ - "shape":"DatapointValue", - "documentation":"

The average of the metric values that correspond to the data point.

" - }, - "Sum":{ - "shape":"DatapointValue", - "documentation":"

The sum of the metric values for the data point.

" - }, - "Minimum":{ - "shape":"DatapointValue", - "documentation":"

The minimum metric value for the data point.

" - }, - "Maximum":{ - "shape":"DatapointValue", - "documentation":"

The maximum metric value for the data point.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The standard unit for the data point.

" - }, - "ExtendedStatistics":{ - "shape":"DatapointValueMap", - "documentation":"

The percentile statistic for the data point.

" - } - }, - "documentation":"

Encapsulates the statistical data that CloudWatch computes from metric data.

", - "xmlOrder":[ - "Timestamp", - "SampleCount", - "Average", - "Sum", - "Minimum", - "Maximum", - "Unit", - "ExtendedStatistics" - ] - }, - "DatapointValue":{"type":"double"}, - "DatapointValueMap":{ - "type":"map", - "key":{"shape":"ExtendedStatistic"}, - "value":{"shape":"DatapointValue"} - }, - "DatapointValues":{ - "type":"list", - "member":{"shape":"DatapointValue"} - }, - "Datapoints":{ - "type":"list", - "member":{"shape":"Datapoint"} - }, - "DatapointsToAlarm":{ - "type":"integer", - "min":1 - }, - "DeleteAlarmsInput":{ - "type":"structure", - "required":["AlarmNames"], - "members":{ - "AlarmNames":{ - "shape":"AlarmNames", - "documentation":"

The alarms to be deleted.

" - } - } - }, - "DeleteDashboardsInput":{ - "type":"structure", - "required":["DashboardNames"], - "members":{ - "DashboardNames":{ - "shape":"DashboardNames", - "documentation":"

The dashboards to be deleted. This parameter is required.

" - } - } - }, - "DeleteDashboardsOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeAlarmHistoryInput":{ - "type":"structure", - "members":{ - "AlarmName":{ - "shape":"AlarmName", - "documentation":"

The name of the alarm.

" - }, - "HistoryItemType":{ - "shape":"HistoryItemType", - "documentation":"

The type of alarm histories to retrieve.

" - }, - "StartDate":{ - "shape":"Timestamp", - "documentation":"

The starting date to retrieve alarm history.

" - }, - "EndDate":{ - "shape":"Timestamp", - "documentation":"

The ending date to retrieve alarm history.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of alarm history records to retrieve.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - } - } - }, - "DescribeAlarmHistoryOutput":{ - "type":"structure", - "members":{ - "AlarmHistoryItems":{ - "shape":"AlarmHistoryItems", - "documentation":"

The alarm histories, in JSON format.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token that marks the start of the next batch of returned results.

" - } - } - }, - "DescribeAlarmsForMetricInput":{ - "type":"structure", - "required":[ - "MetricName", - "Namespace" - ], - "members":{ - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace of the metric.

" - }, - "Statistic":{ - "shape":"Statistic", - "documentation":"

The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics.

" - }, - "ExtendedStatistic":{ - "shape":"ExtendedStatistic", - "documentation":"

The percentile statistic for the metric. Specify a value between p0.0 and p100.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to succeed.

" - }, - "Period":{ - "shape":"Period", - "documentation":"

The period, in seconds, over which the statistic is applied.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit for the metric.

" - } - } - }, - "DescribeAlarmsForMetricOutput":{ - "type":"structure", - "members":{ - "MetricAlarms":{ - "shape":"MetricAlarms", - "documentation":"

The information for each alarm with the specified metric.

" - } - } - }, - "DescribeAlarmsInput":{ - "type":"structure", - "members":{ - "AlarmNames":{ - "shape":"AlarmNames", - "documentation":"

The names of the alarms.

" - }, - "AlarmNamePrefix":{ - "shape":"AlarmNamePrefix", - "documentation":"

The alarm name prefix. If this parameter is specified, you cannot specify AlarmNames.

" - }, - "StateValue":{ - "shape":"StateValue", - "documentation":"

The state value to be used in matching alarms.

" - }, - "ActionPrefix":{ - "shape":"ActionPrefix", - "documentation":"

The action name prefix.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

The maximum number of alarm descriptions to retrieve.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - } - } - }, - "DescribeAlarmsOutput":{ - "type":"structure", - "members":{ - "MetricAlarms":{ - "shape":"MetricAlarms", - "documentation":"

The information for the specified alarms.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token that marks the start of the next batch of returned results.

" - } - } - }, - "Dimension":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"DimensionName", - "documentation":"

The name of the dimension.

" - }, - "Value":{ - "shape":"DimensionValue", - "documentation":"

The value representing the dimension measurement.

" - } - }, - "documentation":"

Expands the identity of a metric.

", - "xmlOrder":[ - "Name", - "Value" - ] - }, - "DimensionFilter":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DimensionName", - "documentation":"

The dimension name to be matched.

" - }, - "Value":{ - "shape":"DimensionValue", - "documentation":"

The value of the dimension to be matched.

" - } - }, - "documentation":"

Represents filters for a dimension.

" - }, - "DimensionFilters":{ - "type":"list", - "member":{"shape":"DimensionFilter"}, - "max":10 - }, - "DimensionName":{ - "type":"string", - "max":255, - "min":1 - }, - "DimensionValue":{ - "type":"string", - "max":255, - "min":1 - }, - "Dimensions":{ - "type":"list", - "member":{"shape":"Dimension"}, - "max":10 - }, - "DisableAlarmActionsInput":{ - "type":"structure", - "required":["AlarmNames"], - "members":{ - "AlarmNames":{ - "shape":"AlarmNames", - "documentation":"

The names of the alarms.

" - } - } - }, - "EnableAlarmActionsInput":{ - "type":"structure", - "required":["AlarmNames"], - "members":{ - "AlarmNames":{ - "shape":"AlarmNames", - "documentation":"

The names of the alarms.

" - } - } - }, - "ErrorMessage":{ - "type":"string", - "max":255, - "min":1 - }, - "EvaluateLowSampleCountPercentile":{ - "type":"string", - "max":255, - "min":1 - }, - "EvaluationPeriods":{ - "type":"integer", - "min":1 - }, - "ExtendedStatistic":{ - "type":"string", - "pattern":"p(\\d{1,2}(\\.\\d{0,2})?|100)" - }, - "ExtendedStatistics":{ - "type":"list", - "member":{"shape":"ExtendedStatistic"}, - "max":10, - "min":1 - }, - "FaultDescription":{"type":"string"}, - "GetDashboardInput":{ - "type":"structure", - "required":["DashboardName"], - "members":{ - "DashboardName":{ - "shape":"DashboardName", - "documentation":"

The name of the dashboard to be described.

" - } - } - }, - "GetDashboardOutput":{ - "type":"structure", - "members":{ - "DashboardArn":{ - "shape":"DashboardArn", - "documentation":"

The Amazon Resource Name (ARN) of the dashboard.

" - }, - "DashboardBody":{ - "shape":"DashboardBody", - "documentation":"

The detailed information about the dashboard, including what widgets are included and their location on the dashboard. For more information about the DashboardBody syntax, see CloudWatch-Dashboard-Body-Structure.

" - }, - "DashboardName":{ - "shape":"DashboardName", - "documentation":"

The name of the dashboard.

" - } - } - }, - "GetMetricDataInput":{ - "type":"structure", - "required":[ - "MetricDataQueries", - "StartTime", - "EndTime" - ], - "members":{ - "MetricDataQueries":{ - "shape":"MetricDataQueries", - "documentation":"

The metric queries to be returned. A single GetMetricData call can include as many as 100 MetricDataQuery structures. Each of these structures can specify either a metric to retrieve, or a math expression to perform on retrieved data.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The time stamp indicating the earliest data to be returned.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time stamp indicating the latest data to be returned.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Include this value, if it was returned by the previous call, to get the next set of data points.

" - }, - "ScanBy":{ - "shape":"ScanBy", - "documentation":"

The order in which data points should be returned. TimestampDescending returns the newest data first and paginates when the MaxDatapoints limit is reached. TimestampAscending returns the oldest data first and paginates when the MaxDatapoints limit is reached.

" - }, - "MaxDatapoints":{ - "shape":"GetMetricDataMaxDatapoints", - "documentation":"

The maximum number of data points the request should return before paginating. If you omit this, the default of 100,800 is used.

" - } - } - }, - "GetMetricDataMaxDatapoints":{"type":"integer"}, - "GetMetricDataOutput":{ - "type":"structure", - "members":{ - "MetricDataResults":{ - "shape":"MetricDataResults", - "documentation":"

The metrics that are returned, including the metric name, namespace, and dimensions.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token that marks the next batch of returned results.

" - } - } - }, - "GetMetricStatisticsInput":{ - "type":"structure", - "required":[ - "Namespace", - "MetricName", - "StartTime", - "EndTime", - "Period" - ], - "members":{ - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace of the metric, with or without spaces.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric, with or without spaces.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions. If the metric contains multiple dimensions, you must include a value for each dimension. CloudWatch treats each unique combination of dimensions as a separate metric. If a specific combination of dimensions was not published, you can't retrieve statistics for it. You must specify the same dimensions that were used when the metrics were created. For an example, see Dimension Combinations in the Amazon CloudWatch User Guide. For more information about specifying dimensions, see Publishing Metrics in the Amazon CloudWatch User Guide.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The time stamp that determines the first data point to return. Start times are evaluated relative to the time that CloudWatch receives the request.

The value specified is inclusive; results include data points with the specified time stamp. The time stamp must be in ISO 8601 UTC format (for example, 2016-10-03T23:00:00Z).

CloudWatch rounds the specified time stamp as follows:

  • Start time less than 15 days ago - Round down to the nearest whole minute. For example, 12:32:34 is rounded down to 12:32:00.

  • Start time between 15 and 63 days ago - Round down to the nearest 5-minute clock interval. For example, 12:32:34 is rounded down to 12:30:00.

  • Start time greater than 63 days ago - Round down to the nearest 1-hour clock interval. For example, 12:32:34 is rounded down to 12:00:00.

If you set Period to 5, 10, or 30, the start time of your request is rounded down to the nearest time that corresponds to even 5-, 10-, or 30-second divisions of a minute. For example, if you make a query at (HH:mm:ss) 01:05:23 for the previous 10-second period, the start time of your request is rounded down and you receive data from 01:05:10 to 01:05:20. If you make a query at 15:07:17 for the previous 5 minutes of data, using a period of 5 seconds, you receive data timestamped between 15:02:15 and 15:07:15.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time stamp that determines the last data point to return.

The value specified is exclusive; results include data points up to the specified time stamp. The time stamp must be in ISO 8601 UTC format (for example, 2016-10-10T23:00:00Z).

" - }, - "Period":{ - "shape":"Period", - "documentation":"

The granularity, in seconds, of the returned data points. For metrics with regular resolution, a period can be as short as one minute (60 seconds) and must be a multiple of 60. For high-resolution metrics that are collected at intervals of less than one minute, the period can be 1, 5, 10, 30, 60, or any multiple of 60. High-resolution metrics are those metrics stored by a PutMetricData call that includes a StorageResolution of 1 second.

If the StartTime parameter specifies a time stamp that is greater than 3 hours ago, you must specify the period as follows or no data points in that time range is returned:

  • Start time between 3 hours and 15 days ago - Use a multiple of 60 seconds (1 minute).

  • Start time between 15 and 63 days ago - Use a multiple of 300 seconds (5 minutes).

  • Start time greater than 63 days ago - Use a multiple of 3600 seconds (1 hour).

" - }, - "Statistics":{ - "shape":"Statistics", - "documentation":"

The metric statistics, other than percentile. For percentile statistics, use ExtendedStatistics. When calling GetMetricStatistics, you must specify either Statistics or ExtendedStatistics, but not both.

" - }, - "ExtendedStatistics":{ - "shape":"ExtendedStatistics", - "documentation":"

The percentile statistics. Specify values between p0.0 and p100. When calling GetMetricStatistics, you must specify either Statistics or ExtendedStatistics, but not both.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit for a given metric. Metrics may be reported in multiple units. Not supplying a unit results in all units being returned. If you specify only a unit that the metric does not report, the results of the call are null.

" - } - } - }, - "GetMetricStatisticsOutput":{ - "type":"structure", - "members":{ - "Label":{ - "shape":"MetricLabel", - "documentation":"

A label for the specified metric.

" - }, - "Datapoints":{ - "shape":"Datapoints", - "documentation":"

The data points for the specified metric.

" - } - } - }, - "HistoryData":{ - "type":"string", - "max":4095, - "min":1 - }, - "HistoryItemType":{ - "type":"string", - "enum":[ - "ConfigurationUpdate", - "StateUpdate", - "Action" - ] - }, - "HistorySummary":{ - "type":"string", - "max":255, - "min":1 - }, - "InternalServiceFault":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"FaultDescription", - "documentation":"

" - } - }, - "documentation":"

Request processing has failed due to some unknown error, exception, or failure.

", - "error":{ - "code":"InternalServiceError", - "httpStatusCode":500 - }, - "exception":true, - "xmlOrder":["Message"] - }, - "InvalidFormatFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Data was not syntactically valid JSON.

", - "error":{ - "code":"InvalidFormat", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidNextToken":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

The next token specified is invalid.

", - "error":{ - "code":"InvalidNextToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Parameters were used together that cannot be used together.

", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

" - } - }, - "documentation":"

The value of an input parameter is bad or out-of-range.

", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LastModified":{"type":"timestamp"}, - "LimitExceededFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

The quota for alarms for this customer has already been reached.

", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ListDashboardsInput":{ - "type":"structure", - "members":{ - "DashboardNamePrefix":{ - "shape":"DashboardNamePrefix", - "documentation":"

If you specify this parameter, only the dashboards with names starting with the specified string are listed. The maximum length is 255, and valid characters are A-Z, a-z, 0-9, \".\", \"-\", and \"_\".

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - } - } - }, - "ListDashboardsOutput":{ - "type":"structure", - "members":{ - "DashboardEntries":{ - "shape":"DashboardEntries", - "documentation":"

The list of matching dashboards.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token that marks the start of the next batch of returned results.

" - } - } - }, - "ListMetricsInput":{ - "type":"structure", - "members":{ - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace to filter against.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric to filter against.

" - }, - "Dimensions":{ - "shape":"DimensionFilters", - "documentation":"

The dimensions to filter against.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - } - } - }, - "ListMetricsOutput":{ - "type":"structure", - "members":{ - "Metrics":{ - "shape":"Metrics", - "documentation":"

The metrics.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token that marks the start of the next batch of returned results.

" - } - }, - "xmlOrder":[ - "Metrics", - "NextToken" - ] - }, - "MaxRecords":{ - "type":"integer", - "max":100, - "min":1 - }, - "Message":{"type":"string"}, - "MessageData":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"MessageDataCode", - "documentation":"

The error code or status code associated with the message.

" - }, - "Value":{ - "shape":"MessageDataValue", - "documentation":"

The message text.

" - } - }, - "documentation":"

A message returned by the GetMetricDataAPI, including a code and a description.

" - }, - "MessageDataCode":{"type":"string"}, - "MessageDataValue":{"type":"string"}, - "Metric":{ - "type":"structure", - "members":{ - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace of the metric.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions for the metric.

" - } - }, - "documentation":"

Represents a specific metric.

", - "xmlOrder":[ - "Namespace", - "MetricName", - "Dimensions" - ] - }, - "MetricAlarm":{ - "type":"structure", - "members":{ - "AlarmName":{ - "shape":"AlarmName", - "documentation":"

The name of the alarm.

" - }, - "AlarmArn":{ - "shape":"AlarmArn", - "documentation":"

The Amazon Resource Name (ARN) of the alarm.

" - }, - "AlarmDescription":{ - "shape":"AlarmDescription", - "documentation":"

The description of the alarm.

" - }, - "AlarmConfigurationUpdatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp of the last update to the alarm configuration.

" - }, - "ActionsEnabled":{ - "shape":"ActionsEnabled", - "documentation":"

Indicates whether actions should be executed during any changes to the alarm state.

" - }, - "OKActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to the OK state from any other state. Each action is specified as an Amazon Resource Name (ARN).

" - }, - "AlarmActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to the ALARM state from any other state. Each action is specified as an Amazon Resource Name (ARN).

" - }, - "InsufficientDataActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN).

" - }, - "StateValue":{ - "shape":"StateValue", - "documentation":"

The state value for the alarm.

" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

An explanation for the alarm state, in text format.

" - }, - "StateReasonData":{ - "shape":"StateReasonData", - "documentation":"

An explanation for the alarm state, in JSON format.

" - }, - "StateUpdatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp of the last update to the alarm state.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric associated with the alarm.

" - }, - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace of the metric associated with the alarm.

" - }, - "Statistic":{ - "shape":"Statistic", - "documentation":"

The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use ExtendedStatistic.

" - }, - "ExtendedStatistic":{ - "shape":"ExtendedStatistic", - "documentation":"

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions for the metric associated with the alarm.

" - }, - "Period":{ - "shape":"Period", - "documentation":"

The period, in seconds, over which the statistic is applied.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit of the metric associated with the alarm.

" - }, - "EvaluationPeriods":{ - "shape":"EvaluationPeriods", - "documentation":"

The number of periods over which data is compared to the specified threshold.

" - }, - "DatapointsToAlarm":{ - "shape":"DatapointsToAlarm", - "documentation":"

The number of datapoints that must be breaching to trigger the alarm.

" - }, - "Threshold":{ - "shape":"Threshold", - "documentation":"

The value to compare with the specified statistic.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.

" - }, - "TreatMissingData":{ - "shape":"TreatMissingData", - "documentation":"

Sets how this alarm is to handle missing data points. If this parameter is omitted, the default behavior of missing is used.

" - }, - "EvaluateLowSampleCountPercentile":{ - "shape":"EvaluateLowSampleCountPercentile", - "documentation":"

Used only for alarms based on percentiles. If ignore, the alarm state does not change during periods with too few data points to be statistically significant. If evaluate or this parameter is not used, the alarm is always evaluated and possibly changes state no matter how many data points are available.

" - } - }, - "documentation":"

Represents an alarm.

", - "xmlOrder":[ - "AlarmName", - "AlarmArn", - "AlarmDescription", - "AlarmConfigurationUpdatedTimestamp", - "ActionsEnabled", - "OKActions", - "AlarmActions", - "InsufficientDataActions", - "StateValue", - "StateReason", - "StateReasonData", - "StateUpdatedTimestamp", - "MetricName", - "Namespace", - "Statistic", - "Dimensions", - "Period", - "Unit", - "EvaluationPeriods", - "Threshold", - "ComparisonOperator", - "ExtendedStatistic", - "TreatMissingData", - "EvaluateLowSampleCountPercentile", - "DatapointsToAlarm" - ] - }, - "MetricAlarms":{ - "type":"list", - "member":{"shape":"MetricAlarm"} - }, - "MetricData":{ - "type":"list", - "member":{"shape":"MetricDatum"} - }, - "MetricDataQueries":{ - "type":"list", - "member":{"shape":"MetricDataQuery"} - }, - "MetricDataQuery":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"MetricId", - "documentation":"

A short name used to tie this structure to the results in the response. This name must be unique within a single call to GetMetricData. If you are performing math expressions on this set of data, this name represents that data and can serve as a variable in the mathematical expression. The valid characters are letters, numbers, and underscore. The first character must be a lowercase letter.

" - }, - "MetricStat":{ - "shape":"MetricStat", - "documentation":"

The metric to be returned, along with statistics, period, and units. Use this parameter only if this structure is performing a data retrieval and not performing a math expression on the returned data.

Within one MetricDataQuery structure, you must specify either Expression or MetricStat but not both.

" - }, - "Expression":{ - "shape":"MetricExpression", - "documentation":"

The math expression to be performed on the returned data, if this structure is performing a math expression. For more information about metric math expressions, see Metric Math Syntax and Functions in the Amazon CloudWatch User Guide.

Within one MetricDataQuery structure, you must specify either Expression or MetricStat but not both.

" - }, - "Label":{ - "shape":"MetricLabel", - "documentation":"

A human-readable label for this metric or expression. This is especially useful if this is an expression, so that you know what the value represents. If the metric or expression is shown in a CloudWatch dashboard widget, the label is shown. If Label is omitted, CloudWatch generates a default.

" - }, - "ReturnData":{ - "shape":"ReturnData", - "documentation":"

Indicates whether to return the time stamps and raw data values of this metric. If you are performing this call just to do math expressions and do not also need the raw data returned, you can specify False. If you omit this, the default of True is used.

" - } - }, - "documentation":"

This structure indicates the metric data to return, and whether this call is just retrieving a batch set of data for one metric, or is performing a math expression on metric data. A single GetMetricData call can include up to 100 MetricDataQuery structures.

" - }, - "MetricDataResult":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"MetricId", - "documentation":"

The short name you specified to represent this metric.

" - }, - "Label":{ - "shape":"MetricLabel", - "documentation":"

The human-readable label associated with the data.

" - }, - "Timestamps":{ - "shape":"Timestamps", - "documentation":"

The time stamps for the data points, formatted in Unix timestamp format. The number of time stamps always matches the number of values and the value for Timestamps[x] is Values[x].

" - }, - "Values":{ - "shape":"DatapointValues", - "documentation":"

The data points for the metric corresponding to Timestamps. The number of values always matches the number of time stamps and the time stamp for Values[x] is Timestamps[x].

" - }, - "StatusCode":{ - "shape":"StatusCode", - "documentation":"

The status of the returned data. Complete indicates that all data points in the requested time range were returned. PartialData means that an incomplete set of data points were returned. You can use the NextToken value that was returned and repeat your request to get more data points. NextToken is not returned if you are performing a math expression. InternalError indicates that an error occurred. Retry your request using NextToken, if present.

" - }, - "Messages":{ - "shape":"MetricDataResultMessages", - "documentation":"

A list of messages with additional information about the data returned.

" - } - }, - "documentation":"

A GetMetricData call returns an array of MetricDataResult structures. Each of these structures includes the data points for that metric, along with the time stamps of those data points and other identifying information.

" - }, - "MetricDataResultMessages":{ - "type":"list", - "member":{"shape":"MessageData"} - }, - "MetricDataResults":{ - "type":"list", - "member":{"shape":"MetricDataResult"} - }, - "MetricDatum":{ - "type":"structure", - "required":["MetricName"], - "members":{ - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions associated with the metric.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time the metric data was received, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.

" - }, - "Value":{ - "shape":"DatapointValue", - "documentation":"

The value for the metric.

Although the parameter accepts numbers of type Double, CloudWatch rejects values that are either too small or too large. Values must be in the range of 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2). In addition, special values (for example, NaN, +Infinity, -Infinity) are not supported.

" - }, - "StatisticValues":{ - "shape":"StatisticSet", - "documentation":"

The statistical values for the metric.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit of the metric.

" - }, - "StorageResolution":{ - "shape":"StorageResolution", - "documentation":"

Valid values are 1 and 60. Setting this to 1 specifies this metric as a high-resolution metric, so that CloudWatch stores the metric with sub-minute resolution down to one second. Setting this to 60 specifies this metric as a regular-resolution metric, which CloudWatch stores at 1-minute resolution. Currently, high resolution is available only for custom metrics. For more information about high-resolution metrics, see High-Resolution Metrics in the Amazon CloudWatch User Guide.

This field is optional, if you do not specify it the default of 60 is used.

" - } - }, - "documentation":"

Encapsulates the information sent to either create a metric or add new values to be aggregated into an existing metric.

" - }, - "MetricExpression":{ - "type":"string", - "max":1024, - "min":1 - }, - "MetricId":{ - "type":"string", - "max":255, - "min":1 - }, - "MetricLabel":{"type":"string"}, - "MetricName":{ - "type":"string", - "max":255, - "min":1 - }, - "MetricStat":{ - "type":"structure", - "required":[ - "Metric", - "Period", - "Stat" - ], - "members":{ - "Metric":{ - "shape":"Metric", - "documentation":"

The metric to return, including the metric name, namespace, and dimensions.

" - }, - "Period":{ - "shape":"Period", - "documentation":"

The period to use when retrieving the metric.

" - }, - "Stat":{ - "shape":"Stat", - "documentation":"

The statistic to return. It can include any CloudWatch statistic or extended statistic.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit to use for the returned data points.

" - } - }, - "documentation":"

This structure defines the metric to be returned, along with the statistics, period, and units.

" - }, - "Metrics":{ - "type":"list", - "member":{"shape":"Metric"} - }, - "MissingRequiredParameterException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

" - } - }, - "documentation":"

An input parameter that is required is missing.

", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Namespace":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[^:].*" - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":0 - }, - "Period":{ - "type":"integer", - "min":1 - }, - "PutDashboardInput":{ - "type":"structure", - "required":[ - "DashboardName", - "DashboardBody" - ], - "members":{ - "DashboardName":{ - "shape":"DashboardName", - "documentation":"

The name of the dashboard. If a dashboard with this name already exists, this call modifies that dashboard, replacing its current contents. Otherwise, a new dashboard is created. The maximum length is 255, and valid characters are A-Z, a-z, 0-9, \"-\", and \"_\". This parameter is required.

" - }, - "DashboardBody":{ - "shape":"DashboardBody", - "documentation":"

The detailed information about the dashboard in JSON format, including the widgets to include and their location on the dashboard. This parameter is required.

For more information about the syntax, see CloudWatch-Dashboard-Body-Structure.

" - } - } - }, - "PutDashboardOutput":{ - "type":"structure", - "members":{ - "DashboardValidationMessages":{ - "shape":"DashboardValidationMessages", - "documentation":"

If the input for PutDashboard was correct and the dashboard was successfully created or modified, this result is empty.

If this result includes only warning messages, then the input was valid enough for the dashboard to be created or modified, but some elements of the dashboard may not render.

If this result includes error messages, the input was not valid and the operation failed.

" - } - } - }, - "PutMetricAlarmInput":{ - "type":"structure", - "required":[ - "AlarmName", - "MetricName", - "Namespace", - "Period", - "EvaluationPeriods", - "Threshold", - "ComparisonOperator" - ], - "members":{ - "AlarmName":{ - "shape":"AlarmName", - "documentation":"

The name for the alarm. This name must be unique within the AWS account.

" - }, - "AlarmDescription":{ - "shape":"AlarmDescription", - "documentation":"

The description for the alarm.

" - }, - "ActionsEnabled":{ - "shape":"ActionsEnabled", - "documentation":"

Indicates whether actions should be executed during any changes to the alarm state.

" - }, - "OKActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to an OK state from any other state. Each action is specified as an Amazon Resource Name (ARN).

Valid Values: arn:aws:automate:region:ec2:stop | arn:aws:automate:region:ec2:terminate | arn:aws:automate:region:ec2:recover | arn:aws:sns:region:account-id:sns-topic-name | arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name

Valid Values (for use with IAM roles): arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Reboot/1.0

" - }, - "AlarmActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to the ALARM state from any other state. Each action is specified as an Amazon Resource Name (ARN).

Valid Values: arn:aws:automate:region:ec2:stop | arn:aws:automate:region:ec2:terminate | arn:aws:automate:region:ec2:recover | arn:aws:sns:region:account-id:sns-topic-name | arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name

Valid Values (for use with IAM roles): arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Reboot/1.0

" - }, - "InsufficientDataActions":{ - "shape":"ResourceList", - "documentation":"

The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN).

Valid Values: arn:aws:automate:region:ec2:stop | arn:aws:automate:region:ec2:terminate | arn:aws:automate:region:ec2:recover | arn:aws:sns:region:account-id:sns-topic-name | arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name

Valid Values (for use with IAM roles): arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:region:{account-id}:action/actions/AWS_EC2.InstanceId.Reboot/1.0

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name for the metric associated with the alarm.

" - }, - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace for the metric associated with the alarm.

" - }, - "Statistic":{ - "shape":"Statistic", - "documentation":"

The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use ExtendedStatistic. When you call PutMetricAlarm, you must specify either Statistic or ExtendedStatistic, but not both.

" - }, - "ExtendedStatistic":{ - "shape":"ExtendedStatistic", - "documentation":"

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100. When you call PutMetricAlarm, you must specify either Statistic or ExtendedStatistic, but not both.

" - }, - "Dimensions":{ - "shape":"Dimensions", - "documentation":"

The dimensions for the metric associated with the alarm.

" - }, - "Period":{ - "shape":"Period", - "documentation":"

The period, in seconds, over which the specified statistic is applied. Valid values are 10, 30, and any multiple of 60.

Be sure to specify 10 or 30 only for metrics that are stored by a PutMetricData call with a StorageResolution of 1. If you specify a period of 10 or 30 for a metric that does not have sub-minute resolution, the alarm still attempts to gather data at the period rate that you specify. In this case, it does not receive data for the attempts that do not correspond to a one-minute data resolution, and the alarm may often lapse into INSUFFICENT_DATA status. Specifying 10 or 30 also sets this alarm as a high-resolution alarm, which has a higher charge than other alarms. For more information about pricing, see Amazon CloudWatch Pricing.

An alarm's total current evaluation period can be no longer than one day, so Period multiplied by EvaluationPeriods cannot be more than 86,400 seconds.

" - }, - "Unit":{ - "shape":"StandardUnit", - "documentation":"

The unit of measure for the statistic. For example, the units for the Amazon EC2 NetworkIn metric are Bytes because NetworkIn tracks the number of bytes that an instance receives on all network interfaces. You can also specify a unit when you create a custom metric. Units help provide conceptual meaning to your data. Metric data points that specify a unit of measure, such as Percent, are aggregated separately.

If you specify a unit, you must use a unit that is appropriate for the metric. Otherwise, the CloudWatch alarm can get stuck in the INSUFFICIENT DATA state.

" - }, - "EvaluationPeriods":{ - "shape":"EvaluationPeriods", - "documentation":"

The number of periods over which data is compared to the specified threshold. If you are setting an alarm which requires that a number of consecutive data points be breaching to trigger the alarm, this value specifies that number. If you are setting an \"M out of N\" alarm, this value is the N.

An alarm's total current evaluation period can be no longer than one day, so this number multiplied by Period cannot be more than 86,400 seconds.

" - }, - "DatapointsToAlarm":{ - "shape":"DatapointsToAlarm", - "documentation":"

The number of datapoints that must be breaching to trigger the alarm. This is used only if you are setting an \"M out of N\" alarm. In that case, this value is the M. For more information, see Evaluating an Alarm in the Amazon CloudWatch User Guide.

" - }, - "Threshold":{ - "shape":"Threshold", - "documentation":"

The value against which the specified statistic is compared.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.

" - }, - "TreatMissingData":{ - "shape":"TreatMissingData", - "documentation":"

Sets how this alarm is to handle missing data points. If TreatMissingData is omitted, the default behavior of missing is used. For more information, see Configuring How CloudWatch Alarms Treats Missing Data.

Valid Values: breaching | notBreaching | ignore | missing

" - }, - "EvaluateLowSampleCountPercentile":{ - "shape":"EvaluateLowSampleCountPercentile", - "documentation":"

Used only for alarms based on percentiles. If you specify ignore, the alarm state does not change during periods with too few data points to be statistically significant. If you specify evaluate or omit this parameter, the alarm is always evaluated and possibly changes state no matter how many data points are available. For more information, see Percentile-Based CloudWatch Alarms and Low Data Samples.

Valid Values: evaluate | ignore

" - } - } - }, - "PutMetricDataInput":{ - "type":"structure", - "required":[ - "Namespace", - "MetricData" - ], - "members":{ - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace for the metric data.

You cannot specify a namespace that begins with \"AWS/\". Namespaces that begin with \"AWS/\" are reserved for use by Amazon Web Services products.

" - }, - "MetricData":{ - "shape":"MetricData", - "documentation":"

The data for the metric.

" - } - } - }, - "ResourceList":{ - "type":"list", - "member":{"shape":"ResourceName"}, - "max":5 - }, - "ResourceName":{ - "type":"string", - "max":1024, - "min":1 - }, - "ResourceNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

The named resource does not exist.

", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReturnData":{"type":"boolean"}, - "ScanBy":{ - "type":"string", - "enum":[ - "TimestampDescending", - "TimestampAscending" - ] - }, - "SetAlarmStateInput":{ - "type":"structure", - "required":[ - "AlarmName", - "StateValue", - "StateReason" - ], - "members":{ - "AlarmName":{ - "shape":"AlarmName", - "documentation":"

The name for the alarm. This name must be unique within the AWS account. The maximum length is 255 characters.

" - }, - "StateValue":{ - "shape":"StateValue", - "documentation":"

The value of the state.

" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason that this alarm is set to this specific state, in text format.

" - }, - "StateReasonData":{ - "shape":"StateReasonData", - "documentation":"

The reason that this alarm is set to this specific state, in JSON format.

" - } - } - }, - "Size":{"type":"long"}, - "StandardUnit":{ - "type":"string", - "enum":[ - "Seconds", - "Microseconds", - "Milliseconds", - "Bytes", - "Kilobytes", - "Megabytes", - "Gigabytes", - "Terabytes", - "Bits", - "Kilobits", - "Megabits", - "Gigabits", - "Terabits", - "Percent", - "Count", - "Bytes/Second", - "Kilobytes/Second", - "Megabytes/Second", - "Gigabytes/Second", - "Terabytes/Second", - "Bits/Second", - "Kilobits/Second", - "Megabits/Second", - "Gigabits/Second", - "Terabits/Second", - "Count/Second", - "None" - ] - }, - "Stat":{"type":"string"}, - "StateReason":{ - "type":"string", - "max":1023, - "min":0 - }, - "StateReasonData":{ - "type":"string", - "max":4000, - "min":0 - }, - "StateValue":{ - "type":"string", - "enum":[ - "OK", - "ALARM", - "INSUFFICIENT_DATA" - ] - }, - "Statistic":{ - "type":"string", - "enum":[ - "SampleCount", - "Average", - "Sum", - "Minimum", - "Maximum" - ] - }, - "StatisticSet":{ - "type":"structure", - "required":[ - "SampleCount", - "Sum", - "Minimum", - "Maximum" - ], - "members":{ - "SampleCount":{ - "shape":"DatapointValue", - "documentation":"

The number of samples used for the statistic set.

" - }, - "Sum":{ - "shape":"DatapointValue", - "documentation":"

The sum of values for the sample set.

" - }, - "Minimum":{ - "shape":"DatapointValue", - "documentation":"

The minimum value of the sample set.

" - }, - "Maximum":{ - "shape":"DatapointValue", - "documentation":"

The maximum value of the sample set.

" - } - }, - "documentation":"

Represents a set of statistics that describes a specific metric.

" - }, - "Statistics":{ - "type":"list", - "member":{"shape":"Statistic"}, - "max":5, - "min":1 - }, - "StatusCode":{ - "type":"string", - "enum":[ - "Complete", - "InternalError", - "PartialData" - ] - }, - "StorageResolution":{ - "type":"integer", - "min":1 - }, - "Threshold":{"type":"double"}, - "Timestamp":{"type":"timestamp"}, - "Timestamps":{ - "type":"list", - "member":{"shape":"Timestamp"} - }, - "TreatMissingData":{ - "type":"string", - "max":255, - "min":1 - } - }, - "documentation":"

Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the applications you run on AWS in real time. You can use CloudWatch to collect and track metrics, which are the variables you want to measure for your resources and applications.

CloudWatch alarms send notifications or automatically change the resources you are monitoring based on rules that you define. For example, you can monitor the CPU usage and disk reads and writes of your Amazon EC2 instances. Then, use this data to determine whether you should launch additional instances to handle increased load. You can also use this data to stop under-used instances to save money.

In addition to monitoring the built-in metrics that come with AWS, you can monitor your own custom metrics. With CloudWatch, you gain system-wide visibility into resource utilization, application performance, and operational health.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/waiters-2.json deleted file mode 100644 index cb0cf0bf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cloudwatch/2010-08-01/waiters-2.json +++ /dev/null @@ -1,18 +0,0 @@ -{ - "version": 2, - "waiters": { - "AlarmExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeAlarms", - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(MetricAlarms[]) > `0`", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/paginators-1.json deleted file mode 100644 index 3ac2ff1f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/paginators-1.json +++ /dev/null @@ -1,19 +0,0 @@ -{ - "pagination": { - "ListBuilds": { - "output_token": "nextToken", - "input_token": "nextToken", - "result_key": "ids" - }, - "ListProjects": { - "output_token": "nextToken", - "input_token": "nextToken", - "result_key": "projects" - }, - "ListBuildsForProject": { - "output_token": "nextToken", - "input_token": "nextToken", - "result_key": "ids" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/service-2.json deleted file mode 100644 index a85376fb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codebuild/2016-10-06/service-2.json +++ /dev/null @@ -1,1580 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-10-06", - "endpointPrefix":"codebuild", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS CodeBuild", - "serviceId":"CodeBuild", - "signatureVersion":"v4", - "targetPrefix":"CodeBuild_20161006", - "uid":"codebuild-2016-10-06" - }, - "operations":{ - "BatchDeleteBuilds":{ - "name":"BatchDeleteBuilds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteBuildsInput"}, - "output":{"shape":"BatchDeleteBuildsOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Deletes one or more builds.

" - }, - "BatchGetBuilds":{ - "name":"BatchGetBuilds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetBuildsInput"}, - "output":{"shape":"BatchGetBuildsOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets information about builds.

" - }, - "BatchGetProjects":{ - "name":"BatchGetProjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetProjectsInput"}, - "output":{"shape":"BatchGetProjectsOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets information about build projects.

" - }, - "CreateProject":{ - "name":"CreateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProjectInput"}, - "output":{"shape":"CreateProjectOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"AccountLimitExceededException"} - ], - "documentation":"

Creates a build project.

" - }, - "CreateWebhook":{ - "name":"CreateWebhook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateWebhookInput"}, - "output":{"shape":"CreateWebhookOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"OAuthProviderException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

For an existing AWS CodeBuild build project that has its source code stored in a GitHub repository, enables AWS CodeBuild to begin automatically rebuilding the source code every time a code change is pushed to the repository.

If you enable webhooks for an AWS CodeBuild project, and the project is used as a build step in AWS CodePipeline, then two identical builds will be created for each commit. One build is triggered through webhooks, and one through AWS CodePipeline. Because billing is on a per-build basis, you will be billed for both builds. Therefore, if you are using AWS CodePipeline, we recommend that you disable webhooks in CodeBuild. In the AWS CodeBuild console, clear the Webhook box. For more information, see step 5 in Change a Build Project's Settings.

" - }, - "DeleteProject":{ - "name":"DeleteProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProjectInput"}, - "output":{"shape":"DeleteProjectOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Deletes a build project.

" - }, - "DeleteWebhook":{ - "name":"DeleteWebhook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteWebhookInput"}, - "output":{"shape":"DeleteWebhookOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OAuthProviderException"} - ], - "documentation":"

For an existing AWS CodeBuild build project that has its source code stored in a GitHub repository, stops AWS CodeBuild from automatically rebuilding the source code every time a code change is pushed to the repository.

" - }, - "InvalidateProjectCache":{ - "name":"InvalidateProjectCache", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InvalidateProjectCacheInput"}, - "output":{"shape":"InvalidateProjectCacheOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Resets the cache for a project.

" - }, - "ListBuilds":{ - "name":"ListBuilds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBuildsInput"}, - "output":{"shape":"ListBuildsOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets a list of build IDs, with each build ID representing a single build.

" - }, - "ListBuildsForProject":{ - "name":"ListBuildsForProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBuildsForProjectInput"}, - "output":{"shape":"ListBuildsForProjectOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets a list of build IDs for the specified build project, with each build ID representing a single build.

" - }, - "ListCuratedEnvironmentImages":{ - "name":"ListCuratedEnvironmentImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCuratedEnvironmentImagesInput"}, - "output":{"shape":"ListCuratedEnvironmentImagesOutput"}, - "documentation":"

Gets information about Docker images that are managed by AWS CodeBuild.

" - }, - "ListProjects":{ - "name":"ListProjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProjectsInput"}, - "output":{"shape":"ListProjectsOutput"}, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets a list of build project names, with each build project name representing a single build project.

" - }, - "StartBuild":{ - "name":"StartBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartBuildInput"}, - "output":{"shape":"StartBuildOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccountLimitExceededException"} - ], - "documentation":"

Starts running a build.

" - }, - "StopBuild":{ - "name":"StopBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopBuildInput"}, - "output":{"shape":"StopBuildOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Attempts to stop running a build.

" - }, - "UpdateProject":{ - "name":"UpdateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProjectInput"}, - "output":{"shape":"UpdateProjectOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Changes the settings of a build project.

" - }, - "UpdateWebhook":{ - "name":"UpdateWebhook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateWebhookInput"}, - "output":{"shape":"UpdateWebhookOutput"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OAuthProviderException"} - ], - "documentation":"

Updates the webhook associated with an AWS CodeBuild build project.

" - } - }, - "shapes":{ - "AccountLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An AWS service limit was exceeded for the calling AWS account.

", - "exception":true - }, - "ArtifactNamespace":{ - "type":"string", - "enum":[ - "NONE", - "BUILD_ID" - ] - }, - "ArtifactPackaging":{ - "type":"string", - "enum":[ - "NONE", - "ZIP" - ] - }, - "ArtifactsType":{ - "type":"string", - "enum":[ - "CODEPIPELINE", - "S3", - "NO_ARTIFACTS" - ] - }, - "BatchDeleteBuildsInput":{ - "type":"structure", - "required":["ids"], - "members":{ - "ids":{ - "shape":"BuildIds", - "documentation":"

The IDs of the builds to delete.

" - } - } - }, - "BatchDeleteBuildsOutput":{ - "type":"structure", - "members":{ - "buildsDeleted":{ - "shape":"BuildIds", - "documentation":"

The IDs of the builds that were successfully deleted.

" - }, - "buildsNotDeleted":{ - "shape":"BuildsNotDeleted", - "documentation":"

Information about any builds that could not be successfully deleted.

" - } - } - }, - "BatchGetBuildsInput":{ - "type":"structure", - "required":["ids"], - "members":{ - "ids":{ - "shape":"BuildIds", - "documentation":"

The IDs of the builds.

" - } - } - }, - "BatchGetBuildsOutput":{ - "type":"structure", - "members":{ - "builds":{ - "shape":"Builds", - "documentation":"

Information about the requested builds.

" - }, - "buildsNotFound":{ - "shape":"BuildIds", - "documentation":"

The IDs of builds for which information could not be found.

" - } - } - }, - "BatchGetProjectsInput":{ - "type":"structure", - "required":["names"], - "members":{ - "names":{ - "shape":"ProjectNames", - "documentation":"

The names of the build projects.

" - } - } - }, - "BatchGetProjectsOutput":{ - "type":"structure", - "members":{ - "projects":{ - "shape":"Projects", - "documentation":"

Information about the requested build projects.

" - }, - "projectsNotFound":{ - "shape":"ProjectNames", - "documentation":"

The names of build projects for which information could not be found.

" - } - } - }, - "Boolean":{"type":"boolean"}, - "Build":{ - "type":"structure", - "members":{ - "id":{ - "shape":"NonEmptyString", - "documentation":"

The unique ID for the build.

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the build.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

When the build process started, expressed in Unix time format.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

When the build process ended, expressed in Unix time format.

" - }, - "currentPhase":{ - "shape":"String", - "documentation":"

The current build phase.

" - }, - "buildStatus":{ - "shape":"StatusType", - "documentation":"

The current status of the build. Valid values include:

  • FAILED: The build failed.

  • FAULT: The build faulted.

  • IN_PROGRESS: The build is still in progress.

  • STOPPED: The build stopped.

  • SUCCEEDED: The build succeeded.

  • TIMED_OUT: The build timed out.

" - }, - "sourceVersion":{ - "shape":"NonEmptyString", - "documentation":"

Any version identifier for the version of the source code to be built.

" - }, - "projectName":{ - "shape":"NonEmptyString", - "documentation":"

The name of the AWS CodeBuild project.

" - }, - "phases":{ - "shape":"BuildPhases", - "documentation":"

Information about all previous build phases that are completed and information about any current build phase that is not yet complete.

" - }, - "source":{ - "shape":"ProjectSource", - "documentation":"

Information about the source code to be built.

" - }, - "artifacts":{ - "shape":"BuildArtifacts", - "documentation":"

Information about the output artifacts for the build.

" - }, - "cache":{ - "shape":"ProjectCache", - "documentation":"

Information about the cache for the build.

" - }, - "environment":{ - "shape":"ProjectEnvironment", - "documentation":"

Information about the build environment for this build.

" - }, - "serviceRole":{ - "shape":"NonEmptyString", - "documentation":"

The name of a service role used for this build.

" - }, - "logs":{ - "shape":"LogsLocation", - "documentation":"

Information about the build's logs in Amazon CloudWatch Logs.

" - }, - "timeoutInMinutes":{ - "shape":"WrapperInt", - "documentation":"

How long, in minutes, for AWS CodeBuild to wait before timing out this build if it does not get marked as completed.

" - }, - "buildComplete":{ - "shape":"Boolean", - "documentation":"

Whether the build has finished. True if completed; otherwise, false.

" - }, - "initiator":{ - "shape":"String", - "documentation":"

The entity that started the build. Valid values include:

  • If AWS CodePipeline started the build, the pipeline's name (for example, codepipeline/my-demo-pipeline).

  • If an AWS Identity and Access Management (IAM) user started the build, the user's name (for example MyUserName).

  • If the Jenkins plugin for AWS CodeBuild started the build, the string CodeBuild-Jenkins-Plugin.

" - }, - "vpcConfig":{ - "shape":"VpcConfig", - "documentation":"

If your AWS CodeBuild project accesses resources in an Amazon VPC, you provide this parameter that identifies the VPC ID and the list of security group IDs and subnet IDs. The security groups and subnets must belong to the same VPC. You must provide at least one security group and one subnet ID.

" - }, - "networkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Describes a network interface.

" - }, - "encryptionKey":{ - "shape":"NonEmptyString", - "documentation":"

The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.

This is expressed either as the CMK's Amazon Resource Name (ARN) or, if specified, the CMK's alias (using the format alias/alias-name ).

" - } - }, - "documentation":"

Information about a build.

" - }, - "BuildArtifacts":{ - "type":"structure", - "members":{ - "location":{ - "shape":"String", - "documentation":"

Information about the location of the build artifacts.

" - }, - "sha256sum":{ - "shape":"String", - "documentation":"

The SHA-256 hash of the build artifact.

You can use this hash along with a checksum tool to confirm both file integrity and authenticity.

This value is available only if the build project's packaging value is set to ZIP.

" - }, - "md5sum":{ - "shape":"String", - "documentation":"

The MD5 hash of the build artifact.

You can use this hash along with a checksum tool to confirm both file integrity and authenticity.

This value is available only if the build project's packaging value is set to ZIP.

" - }, - "overrideArtifactName":{ - "shape":"WrapperBoolean", - "documentation":"

If this flag is set, a name specified in the buildspec file overrides the artifact name. The name specified in a buildspec file is calculated at build time and uses the Shell Command Language. For example, you can append a date and time to your artifact name so that it is always unique.

" - }, - "encryptionDisabled":{ - "shape":"WrapperBoolean", - "documentation":"

Information that tells you if encryption for build artifacts is disabled.

" - } - }, - "documentation":"

Information about build output artifacts.

" - }, - "BuildIds":{ - "type":"list", - "member":{"shape":"NonEmptyString"}, - "max":100, - "min":1 - }, - "BuildNotDeleted":{ - "type":"structure", - "members":{ - "id":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the build that could not be successfully deleted.

" - }, - "statusCode":{ - "shape":"String", - "documentation":"

Additional information about the build that could not be successfully deleted.

" - } - }, - "documentation":"

Information about a build that could not be successfully deleted.

" - }, - "BuildPhase":{ - "type":"structure", - "members":{ - "phaseType":{ - "shape":"BuildPhaseType", - "documentation":"

The name of the build phase. Valid values include:

  • BUILD: Core build activities typically occur in this build phase.

  • COMPLETED: The build has been completed.

  • DOWNLOAD_SOURCE: Source code is being downloaded in this build phase.

  • FINALIZING: The build process is completing in this build phase.

  • INSTALL: Installation activities typically occur in this build phase.

  • POST_BUILD: Post-build activities typically occur in this build phase.

  • PRE_BUILD: Pre-build activities typically occur in this build phase.

  • PROVISIONING: The build environment is being set up.

  • SUBMITTED: The build has been submitted.

  • UPLOAD_ARTIFACTS: Build output artifacts are being uploaded to the output location.

" - }, - "phaseStatus":{ - "shape":"StatusType", - "documentation":"

The current status of the build phase. Valid values include:

  • FAILED: The build phase failed.

  • FAULT: The build phase faulted.

  • IN_PROGRESS: The build phase is still in progress.

  • STOPPED: The build phase stopped.

  • SUCCEEDED: The build phase succeeded.

  • TIMED_OUT: The build phase timed out.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

When the build phase started, expressed in Unix time format.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

When the build phase ended, expressed in Unix time format.

" - }, - "durationInSeconds":{ - "shape":"WrapperLong", - "documentation":"

How long, in seconds, between the starting and ending times of the build's phase.

" - }, - "contexts":{ - "shape":"PhaseContexts", - "documentation":"

Additional information about a build phase, especially to help troubleshoot a failed build.

" - } - }, - "documentation":"

Information about a stage for a build.

" - }, - "BuildPhaseType":{ - "type":"string", - "enum":[ - "SUBMITTED", - "PROVISIONING", - "DOWNLOAD_SOURCE", - "INSTALL", - "PRE_BUILD", - "BUILD", - "POST_BUILD", - "UPLOAD_ARTIFACTS", - "FINALIZING", - "COMPLETED" - ] - }, - "BuildPhases":{ - "type":"list", - "member":{"shape":"BuildPhase"} - }, - "Builds":{ - "type":"list", - "member":{"shape":"Build"} - }, - "BuildsNotDeleted":{ - "type":"list", - "member":{"shape":"BuildNotDeleted"} - }, - "CacheType":{ - "type":"string", - "enum":[ - "NO_CACHE", - "S3" - ] - }, - "ComputeType":{ - "type":"string", - "enum":[ - "BUILD_GENERAL1_SMALL", - "BUILD_GENERAL1_MEDIUM", - "BUILD_GENERAL1_LARGE" - ] - }, - "CreateProjectInput":{ - "type":"structure", - "required":[ - "name", - "source", - "artifacts", - "environment", - "serviceRole" - ], - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

The name of the build project.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

A description that makes the build project easy to identify.

" - }, - "source":{ - "shape":"ProjectSource", - "documentation":"

Information about the build input source code for the build project.

" - }, - "artifacts":{ - "shape":"ProjectArtifacts", - "documentation":"

Information about the build output artifacts for the build project.

" - }, - "cache":{ - "shape":"ProjectCache", - "documentation":"

Stores recently used information so that it can be quickly accessed at a later time.

" - }, - "environment":{ - "shape":"ProjectEnvironment", - "documentation":"

Information about the build environment for the build project.

" - }, - "serviceRole":{ - "shape":"NonEmptyString", - "documentation":"

The ARN of the AWS Identity and Access Management (IAM) role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.

" - }, - "timeoutInMinutes":{ - "shape":"TimeOut", - "documentation":"

How long, in minutes, from 5 to 480 (8 hours), for AWS CodeBuild to wait until timing out any build that has not been marked as completed. The default is 60 minutes.

" - }, - "encryptionKey":{ - "shape":"NonEmptyString", - "documentation":"

The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.

You can specify either the CMK's Amazon Resource Name (ARN) or, if available, the CMK's alias (using the format alias/alias-name ).

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

A set of tags for this build project.

These tags are available for use by AWS services that support AWS CodeBuild build project tags.

" - }, - "vpcConfig":{ - "shape":"VpcConfig", - "documentation":"

VpcConfig enables AWS CodeBuild to access resources in an Amazon VPC.

" - }, - "badgeEnabled":{ - "shape":"WrapperBoolean", - "documentation":"

Set this to true to generate a publicly-accessible URL for your project's build badge.

" - } - } - }, - "CreateProjectOutput":{ - "type":"structure", - "members":{ - "project":{ - "shape":"Project", - "documentation":"

Information about the build project that was created.

" - } - } - }, - "CreateWebhookInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the AWS CodeBuild project.

" - }, - "branchFilter":{ - "shape":"String", - "documentation":"

A regular expression used to determine which branches in a repository are built when a webhook is triggered. If the name of a branch matches the regular expression, then it is built. If it doesn't match, then it is not. If branchFilter is empty, then all branches are built.

" - } - } - }, - "CreateWebhookOutput":{ - "type":"structure", - "members":{ - "webhook":{ - "shape":"Webhook", - "documentation":"

Information about a webhook in GitHub that connects repository events to a build project in AWS CodeBuild.

" - } - } - }, - "DeleteProjectInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"NonEmptyString", - "documentation":"

The name of the build project.

" - } - } - }, - "DeleteProjectOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteWebhookInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the AWS CodeBuild project.

" - } - } - }, - "DeleteWebhookOutput":{ - "type":"structure", - "members":{ - } - }, - "EnvironmentImage":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the Docker image.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the Docker image.

" - }, - "versions":{ - "shape":"ImageVersions", - "documentation":"

A list of environment image versions.

" - } - }, - "documentation":"

Information about a Docker image that is managed by AWS CodeBuild.

" - }, - "EnvironmentImages":{ - "type":"list", - "member":{"shape":"EnvironmentImage"} - }, - "EnvironmentLanguage":{ - "type":"structure", - "members":{ - "language":{ - "shape":"LanguageType", - "documentation":"

The programming language for the Docker images.

" - }, - "images":{ - "shape":"EnvironmentImages", - "documentation":"

The list of Docker images that are related by the specified programming language.

" - } - }, - "documentation":"

A set of Docker images that are related by programming language and are managed by AWS CodeBuild.

" - }, - "EnvironmentLanguages":{ - "type":"list", - "member":{"shape":"EnvironmentLanguage"} - }, - "EnvironmentPlatform":{ - "type":"structure", - "members":{ - "platform":{ - "shape":"PlatformType", - "documentation":"

The platform's name.

" - }, - "languages":{ - "shape":"EnvironmentLanguages", - "documentation":"

The list of programming languages that are available for the specified platform.

" - } - }, - "documentation":"

A set of Docker images that are related by platform and are managed by AWS CodeBuild.

" - }, - "EnvironmentPlatforms":{ - "type":"list", - "member":{"shape":"EnvironmentPlatform"} - }, - "EnvironmentType":{ - "type":"string", - "enum":[ - "WINDOWS_CONTAINER", - "LINUX_CONTAINER" - ] - }, - "EnvironmentVariable":{ - "type":"structure", - "required":[ - "name", - "value" - ], - "members":{ - "name":{ - "shape":"NonEmptyString", - "documentation":"

The name or key of the environment variable.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of the environment variable.

We strongly discourage using environment variables to store sensitive values, especially AWS secret key IDs and secret access keys. Environment variables can be displayed in plain text using tools such as the AWS CodeBuild console and the AWS Command Line Interface (AWS CLI).

" - }, - "type":{ - "shape":"EnvironmentVariableType", - "documentation":"

The type of environment variable. Valid values include:

  • PARAMETER_STORE: An environment variable stored in Amazon EC2 Systems Manager Parameter Store.

  • PLAINTEXT: An environment variable in plaintext format.

" - } - }, - "documentation":"

Information about an environment variable for a build project or a build.

" - }, - "EnvironmentVariableType":{ - "type":"string", - "enum":[ - "PLAINTEXT", - "PARAMETER_STORE" - ] - }, - "EnvironmentVariables":{ - "type":"list", - "member":{"shape":"EnvironmentVariable"} - }, - "GitCloneDepth":{ - "type":"integer", - "min":0 - }, - "ImageVersions":{ - "type":"list", - "member":{"shape":"String"} - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The input value that was provided is not valid.

", - "exception":true - }, - "InvalidateProjectCacheInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"NonEmptyString", - "documentation":"

The name of the AWS CodeBuild build project that the cache will be reset for.

" - } - } - }, - "InvalidateProjectCacheOutput":{ - "type":"structure", - "members":{ - } - }, - "KeyInput":{ - "type":"string", - "max":127, - "min":1, - "pattern":"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=@+\\\\-]*)$" - }, - "LanguageType":{ - "type":"string", - "enum":[ - "JAVA", - "PYTHON", - "NODE_JS", - "RUBY", - "GOLANG", - "DOCKER", - "ANDROID", - "DOTNET", - "BASE" - ] - }, - "ListBuildsForProjectInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"NonEmptyString", - "documentation":"

The name of the AWS CodeBuild project.

" - }, - "sortOrder":{ - "shape":"SortOrderType", - "documentation":"

The order to list build IDs. Valid values include:

  • ASCENDING: List the build IDs in ascending order by build ID.

  • DESCENDING: List the build IDs in descending order by build ID.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

During a previous call, if there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.

" - } - } - }, - "ListBuildsForProjectOutput":{ - "type":"structure", - "members":{ - "ids":{ - "shape":"BuildIds", - "documentation":"

A list of build IDs for the specified build project, with each build ID representing a single build.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

If there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call.

" - } - } - }, - "ListBuildsInput":{ - "type":"structure", - "members":{ - "sortOrder":{ - "shape":"SortOrderType", - "documentation":"

The order to list build IDs. Valid values include:

  • ASCENDING: List the build IDs in ascending order by build ID.

  • DESCENDING: List the build IDs in descending order by build ID.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

During a previous call, if there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.

" - } - } - }, - "ListBuildsOutput":{ - "type":"structure", - "members":{ - "ids":{ - "shape":"BuildIds", - "documentation":"

A list of build IDs, with each build ID representing a single build.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

If there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call.

" - } - } - }, - "ListCuratedEnvironmentImagesInput":{ - "type":"structure", - "members":{ - } - }, - "ListCuratedEnvironmentImagesOutput":{ - "type":"structure", - "members":{ - "platforms":{ - "shape":"EnvironmentPlatforms", - "documentation":"

Information about supported platforms for Docker images that are managed by AWS CodeBuild.

" - } - } - }, - "ListProjectsInput":{ - "type":"structure", - "members":{ - "sortBy":{ - "shape":"ProjectSortByType", - "documentation":"

The criterion to be used to list build project names. Valid values include:

  • CREATED_TIME: List the build project names based on when each build project was created.

  • LAST_MODIFIED_TIME: List the build project names based on when information about each build project was last changed.

  • NAME: List the build project names based on each build project's name.

Use sortOrder to specify in what order to list the build project names based on the preceding criteria.

" - }, - "sortOrder":{ - "shape":"SortOrderType", - "documentation":"

The order in which to list build projects. Valid values include:

  • ASCENDING: List the build project names in ascending order.

  • DESCENDING: List the build project names in descending order.

Use sortBy to specify the criterion to be used to list build project names.

" - }, - "nextToken":{ - "shape":"NonEmptyString", - "documentation":"

During a previous call, if there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.

" - } - } - }, - "ListProjectsOutput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"String", - "documentation":"

If there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a next token. To get the next batch of items in the list, call this operation again, adding the next token to the call.

" - }, - "projects":{ - "shape":"ProjectNames", - "documentation":"

The list of build project names, with each build project name representing a single build project.

" - } - } - }, - "LogsLocation":{ - "type":"structure", - "members":{ - "groupName":{ - "shape":"String", - "documentation":"

The name of the Amazon CloudWatch Logs group for the build logs.

" - }, - "streamName":{ - "shape":"String", - "documentation":"

The name of the Amazon CloudWatch Logs stream for the build logs.

" - }, - "deepLink":{ - "shape":"String", - "documentation":"

The URL to an individual build log in Amazon CloudWatch Logs.

" - } - }, - "documentation":"

Information about build logs in Amazon CloudWatch Logs.

" - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "subnetId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the subnet.

" - }, - "networkInterfaceId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the network interface.

" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NonEmptyString":{ - "type":"string", - "min":1 - }, - "OAuthProviderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There was a problem with the underlying OAuth provider.

", - "exception":true - }, - "PhaseContext":{ - "type":"structure", - "members":{ - "statusCode":{ - "shape":"String", - "documentation":"

The status code for the context of the build phase.

" - }, - "message":{ - "shape":"String", - "documentation":"

An explanation of the build phase's context. This explanation might include a command ID and an exit code.

" - } - }, - "documentation":"

Additional information about a build phase that has an error. You can use this information to help troubleshoot a failed build.

" - }, - "PhaseContexts":{ - "type":"list", - "member":{"shape":"PhaseContext"} - }, - "PlatformType":{ - "type":"string", - "enum":[ - "DEBIAN", - "AMAZON_LINUX", - "UBUNTU", - "WINDOWS_SERVER" - ] - }, - "Project":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

The name of the build project.

" - }, - "arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the build project.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

A description that makes the build project easy to identify.

" - }, - "source":{ - "shape":"ProjectSource", - "documentation":"

Information about the build input source code for this build project.

" - }, - "artifacts":{ - "shape":"ProjectArtifacts", - "documentation":"

Information about the build output artifacts for the build project.

" - }, - "cache":{ - "shape":"ProjectCache", - "documentation":"

Information about the cache for the build project.

" - }, - "environment":{ - "shape":"ProjectEnvironment", - "documentation":"

Information about the build environment for this build project.

" - }, - "serviceRole":{ - "shape":"NonEmptyString", - "documentation":"

The ARN of the AWS Identity and Access Management (IAM) role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.

" - }, - "timeoutInMinutes":{ - "shape":"TimeOut", - "documentation":"

How long, in minutes, from 5 to 480 (8 hours), for AWS CodeBuild to wait before timing out any related build that did not get marked as completed. The default is 60 minutes.

" - }, - "encryptionKey":{ - "shape":"NonEmptyString", - "documentation":"

The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.

This is expressed either as the CMK's Amazon Resource Name (ARN) or, if specified, the CMK's alias (using the format alias/alias-name ).

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The tags for this build project.

These tags are available for use by AWS services that support AWS CodeBuild build project tags.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

When the build project was created, expressed in Unix time format.

" - }, - "lastModified":{ - "shape":"Timestamp", - "documentation":"

When the build project's settings were last modified, expressed in Unix time format.

" - }, - "webhook":{ - "shape":"Webhook", - "documentation":"

Information about a webhook in GitHub that connects repository events to a build project in AWS CodeBuild.

" - }, - "vpcConfig":{ - "shape":"VpcConfig", - "documentation":"

Information about the VPC configuration that AWS CodeBuild will access.

" - }, - "badge":{ - "shape":"ProjectBadge", - "documentation":"

Information about the build badge for the build project.

" - } - }, - "documentation":"

Information about a build project.

" - }, - "ProjectArtifacts":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"ArtifactsType", - "documentation":"

The type of build output artifact. Valid values include:

  • CODEPIPELINE: The build project will have build output generated through AWS CodePipeline.

  • NO_ARTIFACTS: The build project will not produce any build output.

  • S3: The build project will store build output in Amazon Simple Storage Service (Amazon S3).

" - }, - "location":{ - "shape":"String", - "documentation":"

Information about the build output artifact location, as follows:

  • If type is set to CODEPIPELINE, then AWS CodePipeline will ignore this value if specified. This is because AWS CodePipeline manages its build output locations instead of AWS CodeBuild.

  • If type is set to NO_ARTIFACTS, then this value will be ignored if specified, because no build output will be produced.

  • If type is set to S3, this is the name of the output bucket.

" - }, - "path":{ - "shape":"String", - "documentation":"

Along with namespaceType and name, the pattern that AWS CodeBuild will use to name and store the output artifact, as follows:

  • If type is set to CODEPIPELINE, then AWS CodePipeline will ignore this value if specified. This is because AWS CodePipeline manages its build output names instead of AWS CodeBuild.

  • If type is set to NO_ARTIFACTS, then this value will be ignored if specified, because no build output will be produced.

  • If type is set to S3, this is the path to the output artifact. If path is not specified, then path will not be used.

For example, if path is set to MyArtifacts, namespaceType is set to NONE, and name is set to MyArtifact.zip, then the output artifact would be stored in the output bucket at MyArtifacts/MyArtifact.zip.

" - }, - "namespaceType":{ - "shape":"ArtifactNamespace", - "documentation":"

Along with path and name, the pattern that AWS CodeBuild will use to determine the name and location to store the output artifact, as follows:

  • If type is set to CODEPIPELINE, then AWS CodePipeline will ignore this value if specified. This is because AWS CodePipeline manages its build output names instead of AWS CodeBuild.

  • If type is set to NO_ARTIFACTS, then this value will be ignored if specified, because no build output will be produced.

  • If type is set to S3, then valid values include:

    • BUILD_ID: Include the build ID in the location of the build output artifact.

    • NONE: Do not include the build ID. This is the default if namespaceType is not specified.

For example, if path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, then the output artifact would be stored in MyArtifacts/build-ID/MyArtifact.zip.

" - }, - "name":{ - "shape":"String", - "documentation":"

Along with path and namespaceType, the pattern that AWS CodeBuild will use to name and store the output artifact, as follows:

  • If type is set to CODEPIPELINE, then AWS CodePipeline will ignore this value if specified. This is because AWS CodePipeline manages its build output names instead of AWS CodeBuild.

  • If type is set to NO_ARTIFACTS, then this value will be ignored if specified, because no build output will be produced.

  • If type is set to S3, this is the name of the output artifact object. If you set the name to be a forward slash (\"/\"), then the artifact is stored in the root of the output bucket.

For example:

  • If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, then the output artifact would be stored in MyArtifacts/build-ID/MyArtifact.zip.

  • If path is empty, namespaceType is set to NONE, and name is set to \"/\", then the output artifact would be stored in the root of the output bucket.

  • If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to \"/\", then the output artifact would be stored in MyArtifacts/build-ID .

" - }, - "packaging":{ - "shape":"ArtifactPackaging", - "documentation":"

The type of build output artifact to create, as follows:

  • If type is set to CODEPIPELINE, then AWS CodePipeline will ignore this value if specified. This is because AWS CodePipeline manages its build output artifacts instead of AWS CodeBuild.

  • If type is set to NO_ARTIFACTS, then this value will be ignored if specified, because no build output will be produced.

  • If type is set to S3, valid values include:

    • NONE: AWS CodeBuild will create in the output bucket a folder containing the build output. This is the default if packaging is not specified.

    • ZIP: AWS CodeBuild will create in the output bucket a ZIP file containing the build output.

" - }, - "overrideArtifactName":{ - "shape":"WrapperBoolean", - "documentation":"

If this flag is set, a name specified in the buildspec file overrides the artifact name. The name specified in a buildspec file is calculated at build time and uses the Shell Command Language. For example, you can append a date and time to your artifact name so that it is always unique.

" - }, - "encryptionDisabled":{ - "shape":"WrapperBoolean", - "documentation":"

Set to true if you do not want your output artifacts encrypted. This option is only valid if your artifacts type is Amazon S3. If this is set with another artifacts type, an invalidInputException will be thrown.

" - } - }, - "documentation":"

Information about the build output artifacts for the build project.

" - }, - "ProjectBadge":{ - "type":"structure", - "members":{ - "badgeEnabled":{ - "shape":"Boolean", - "documentation":"

Set this to true to generate a publicly-accessible URL for your project's build badge.

" - }, - "badgeRequestUrl":{ - "shape":"String", - "documentation":"

The publicly-accessible URL through which you can access the build badge for your project.

" - } - }, - "documentation":"

Information about the build badge for the build project.

" - }, - "ProjectCache":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"CacheType", - "documentation":"

The type of cache used by the build project. Valid values include:

  • NO_CACHE: The build project will not use any cache.

  • S3: The build project will read and write from/to S3.

" - }, - "location":{ - "shape":"String", - "documentation":"

Information about the cache location, as follows:

  • NO_CACHE: This value will be ignored.

  • S3: This is the S3 bucket name/prefix.

" - } - }, - "documentation":"

Information about the cache for the build project.

" - }, - "ProjectDescription":{ - "type":"string", - "max":255, - "min":0 - }, - "ProjectEnvironment":{ - "type":"structure", - "required":[ - "type", - "image", - "computeType" - ], - "members":{ - "type":{ - "shape":"EnvironmentType", - "documentation":"

The type of build environment to use for related builds.

" - }, - "image":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the Docker image to use for this build project.

" - }, - "computeType":{ - "shape":"ComputeType", - "documentation":"

Information about the compute resources the build project will use. Available values include:

  • BUILD_GENERAL1_SMALL: Use up to 3 GB memory and 2 vCPUs for builds.

  • BUILD_GENERAL1_MEDIUM: Use up to 7 GB memory and 4 vCPUs for builds.

  • BUILD_GENERAL1_LARGE: Use up to 15 GB memory and 8 vCPUs for builds.

" - }, - "environmentVariables":{ - "shape":"EnvironmentVariables", - "documentation":"

A set of environment variables to make available to builds for this build project.

" - }, - "privilegedMode":{ - "shape":"WrapperBoolean", - "documentation":"

Enables running the Docker daemon inside a Docker container. Set to true only if the build project is be used to build Docker images, and the specified build environment image is not provided by AWS CodeBuild with Docker support. Otherwise, all associated builds that attempt to interact with the Docker daemon will fail. Note that you must also start the Docker daemon so that builds can interact with it. One way to do this is to initialize the Docker daemon during the install phase of your build spec by running the following build commands. (Do not run the following build commands if the specified build environment image is provided by AWS CodeBuild with Docker support.)

If the operating system's base image is Ubuntu Linux:

- nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://0.0.0.0:2375 --storage-driver=overlay& - timeout 15 sh -c \"until docker info; do echo .; sleep 1; done\"

If the operating system's base image is Alpine Linux, add the -t argument to timeout:

- nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://0.0.0.0:2375 --storage-driver=overlay& - timeout 15 -t sh -c \"until docker info; do echo .; sleep 1; done\"

" - }, - "certificate":{ - "shape":"String", - "documentation":"

The certificate to use with this build project.

" - } - }, - "documentation":"

Information about the build environment of the build project.

" - }, - "ProjectName":{ - "type":"string", - "max":255, - "min":2, - "pattern":"[A-Za-z0-9][A-Za-z0-9\\-_]{1,254}" - }, - "ProjectNames":{ - "type":"list", - "member":{"shape":"NonEmptyString"}, - "max":100, - "min":1 - }, - "ProjectSortByType":{ - "type":"string", - "enum":[ - "NAME", - "CREATED_TIME", - "LAST_MODIFIED_TIME" - ] - }, - "ProjectSource":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"SourceType", - "documentation":"

The type of repository that contains the source code to be built. Valid values include:

  • BITBUCKET: The source code is in a Bitbucket repository.

  • CODECOMMIT: The source code is in an AWS CodeCommit repository.

  • CODEPIPELINE: The source code settings are specified in the source action of a pipeline in AWS CodePipeline.

  • GITHUB: The source code is in a GitHub repository.

  • S3: The source code is in an Amazon Simple Storage Service (Amazon S3) input bucket.

" - }, - "location":{ - "shape":"String", - "documentation":"

Information about the location of the source code to be built. Valid values include:

  • For source code settings that are specified in the source action of a pipeline in AWS CodePipeline, location should not be specified. If it is specified, AWS CodePipeline will ignore it. This is because AWS CodePipeline uses the settings in a pipeline's source action instead of this value.

  • For source code in an AWS CodeCommit repository, the HTTPS clone URL to the repository that contains the source code and the build spec (for example, https://git-codecommit.region-ID.amazonaws.com/v1/repos/repo-name ).

  • For source code in an Amazon Simple Storage Service (Amazon S3) input bucket, the path to the ZIP file that contains the source code (for example, bucket-name/path/to/object-name.zip)

  • For source code in a GitHub repository, the HTTPS clone URL to the repository that contains the source and the build spec. Also, you must connect your AWS account to your GitHub account. To do this, use the AWS CodeBuild console to begin creating a build project. When you use the console to connect (or reconnect) with GitHub, on the GitHub Authorize application page that displays, for Organization access, choose Request access next to each repository you want to allow AWS CodeBuild to have access to. Then choose Authorize application. (After you have connected to your GitHub account, you do not need to finish creating the build project, and you may then leave the AWS CodeBuild console.) To instruct AWS CodeBuild to then use this connection, in the source object, set the auth object's type value to OAUTH.

  • For source code in a Bitbucket repository, the HTTPS clone URL to the repository that contains the source and the build spec. Also, you must connect your AWS account to your Bitbucket account. To do this, use the AWS CodeBuild console to begin creating a build project. When you use the console to connect (or reconnect) with Bitbucket, on the Bitbucket Confirm access to your account page that displays, choose Grant access. (After you have connected to your Bitbucket account, you do not need to finish creating the build project, and you may then leave the AWS CodeBuild console.) To instruct AWS CodeBuild to then use this connection, in the source object, set the auth object's type value to OAUTH.

" - }, - "gitCloneDepth":{ - "shape":"GitCloneDepth", - "documentation":"

Information about the git clone depth for the build project.

" - }, - "buildspec":{ - "shape":"String", - "documentation":"

The build spec declaration to use for the builds in this build project.

If this value is not specified, a build spec must be included along with the source code to be built.

" - }, - "auth":{ - "shape":"SourceAuth", - "documentation":"

Information about the authorization settings for AWS CodeBuild to access the source code to be built.

This information is for the AWS CodeBuild console's use only. Your code should not get or set this information directly (unless the build project's source type value is BITBUCKET or GITHUB).

" - }, - "reportBuildStatus":{ - "shape":"WrapperBoolean", - "documentation":"

Set to true to report the status of a build's start and finish to your source provider. This option is only valid when your source provider is GitHub. If this is set and you use a different source provider, an invalidInputException is thrown.

" - }, - "insecureSsl":{ - "shape":"WrapperBoolean", - "documentation":"

Enable this flag to ignore SSL warnings while connecting to the project source code.

" - } - }, - "documentation":"

Information about the build input source code for the build project.

" - }, - "Projects":{ - "type":"list", - "member":{"shape":"Project"} - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified AWS resource cannot be created, because an AWS resource with the same settings already exists.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified AWS resource cannot be found.

", - "exception":true - }, - "SecurityGroupIds":{ - "type":"list", - "member":{"shape":"NonEmptyString"}, - "max":5 - }, - "SortOrderType":{ - "type":"string", - "enum":[ - "ASCENDING", - "DESCENDING" - ] - }, - "SourceAuth":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"SourceAuthType", - "documentation":"

The authorization type to use. The only valid value is OAUTH, which represents the OAuth authorization type.

" - }, - "resource":{ - "shape":"String", - "documentation":"

The resource value that applies to the specified authorization type.

" - } - }, - "documentation":"

Information about the authorization settings for AWS CodeBuild to access the source code to be built.

This information is for the AWS CodeBuild console's use only. Your code should not get or set this information directly (unless the build project's source type value is BITBUCKET or GITHUB).

" - }, - "SourceAuthType":{ - "type":"string", - "enum":["OAUTH"] - }, - "SourceType":{ - "type":"string", - "enum":[ - "CODECOMMIT", - "CODEPIPELINE", - "GITHUB", - "S3", - "BITBUCKET", - "GITHUB_ENTERPRISE" - ] - }, - "StartBuildInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"NonEmptyString", - "documentation":"

The name of the AWS CodeBuild build project to start running a build.

" - }, - "sourceVersion":{ - "shape":"String", - "documentation":"

A version of the build input to be built, for this build only. If not specified, the latest version will be used. If specified, must be one of:

  • For AWS CodeCommit: the commit ID to use.

  • For GitHub: the commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a pull request ID is specified, it must use the format pr/pull-request-ID (for example pr/25). If a branch name is specified, the branch's HEAD commit ID will be used. If not specified, the default branch's HEAD commit ID will be used.

  • For Bitbucket: the commit ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a branch name is specified, the branch's HEAD commit ID will be used. If not specified, the default branch's HEAD commit ID will be used.

  • For Amazon Simple Storage Service (Amazon S3): the version ID of the object representing the build input ZIP file to use.

" - }, - "artifactsOverride":{ - "shape":"ProjectArtifacts", - "documentation":"

Build output artifact settings that override, for this build only, the latest ones already defined in the build project.

" - }, - "environmentVariablesOverride":{ - "shape":"EnvironmentVariables", - "documentation":"

A set of environment variables that overrides, for this build only, the latest ones already defined in the build project.

" - }, - "sourceTypeOverride":{ - "shape":"SourceType", - "documentation":"

A source input type for this build that overrides the source input defined in the build project

" - }, - "sourceLocationOverride":{ - "shape":"String", - "documentation":"

A location that overrides for this build the source location for the one defined in the build project.

" - }, - "sourceAuthOverride":{ - "shape":"SourceAuth", - "documentation":"

An authorization type for this build that overrides the one defined in the build project. This override applies only if the build project's source is BitBucket or GitHub.

" - }, - "gitCloneDepthOverride":{ - "shape":"GitCloneDepth", - "documentation":"

The user-defined depth of history, with a minimum value of 0, that overrides, for this build only, any previous depth of history defined in the build project.

" - }, - "buildspecOverride":{ - "shape":"String", - "documentation":"

A build spec declaration that overrides, for this build only, the latest one already defined in the build project.

" - }, - "insecureSslOverride":{ - "shape":"WrapperBoolean", - "documentation":"

Enable this flag to override the insecure SSL setting that is specified in the build project. The insecure SSL setting determines whether to ignore SSL warnings while connecting to the project source code. This override applies only if the build's source is GitHub Enterprise.

" - }, - "reportBuildStatusOverride":{ - "shape":"WrapperBoolean", - "documentation":"

Set to true to report to your source provider the status of a build's start and completion. If you use this option with a source provider other than GitHub, an invalidInputException is thrown.

" - }, - "environmentTypeOverride":{ - "shape":"EnvironmentType", - "documentation":"

A container type for this build that overrides the one specified in the build project.

" - }, - "imageOverride":{ - "shape":"NonEmptyString", - "documentation":"

The name of an image for this build that overrides the one specified in the build project.

" - }, - "computeTypeOverride":{ - "shape":"ComputeType", - "documentation":"

The name of a compute type for this build that overrides the one specified in the build project.

" - }, - "certificateOverride":{ - "shape":"String", - "documentation":"

The name of a certificate for this build that overrides the one specified in the build project.

" - }, - "cacheOverride":{ - "shape":"ProjectCache", - "documentation":"

A ProjectCache object specified for this build that overrides the one defined in the build project.

" - }, - "serviceRoleOverride":{ - "shape":"NonEmptyString", - "documentation":"

The name of a service role for this build that overrides the one specified in the build project.

" - }, - "privilegedModeOverride":{ - "shape":"WrapperBoolean", - "documentation":"

Enable this flag to override privileged mode in the build project.

" - }, - "timeoutInMinutesOverride":{ - "shape":"TimeOut", - "documentation":"

The number of build timeout minutes, from 5 to 480 (8 hours), that overrides, for this build only, the latest setting already defined in the build project.

" - }, - "idempotencyToken":{ - "shape":"String", - "documentation":"

A unique, case sensitive identifier you provide to ensure the idempotency of the StartBuild request. The token is included in the StartBuild request and is valid for 12 hours. If you repeat the StartBuild request with the same token, but change a parameter, AWS CodeBuild returns a parameter mismatch error.

" - } - } - }, - "StartBuildOutput":{ - "type":"structure", - "members":{ - "build":{ - "shape":"Build", - "documentation":"

Information about the build to be run.

" - } - } - }, - "StatusType":{ - "type":"string", - "enum":[ - "SUCCEEDED", - "FAILED", - "FAULT", - "TIMED_OUT", - "IN_PROGRESS", - "STOPPED" - ] - }, - "StopBuildInput":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the build.

" - } - } - }, - "StopBuildOutput":{ - "type":"structure", - "members":{ - "build":{ - "shape":"Build", - "documentation":"

Information about the build.

" - } - } - }, - "String":{"type":"string"}, - "Subnets":{ - "type":"list", - "member":{"shape":"NonEmptyString"}, - "max":16 - }, - "Tag":{ - "type":"structure", - "members":{ - "key":{ - "shape":"KeyInput", - "documentation":"

The tag's key.

" - }, - "value":{ - "shape":"ValueInput", - "documentation":"

The tag's value.

" - } - }, - "documentation":"

A tag, consisting of a key and a value.

This tag is available for use by AWS services that support tags in AWS CodeBuild.

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":0 - }, - "TimeOut":{ - "type":"integer", - "max":480, - "min":5 - }, - "Timestamp":{"type":"timestamp"}, - "UpdateProjectInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"NonEmptyString", - "documentation":"

The name of the build project.

You cannot change a build project's name.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

A new or replacement description of the build project.

" - }, - "source":{ - "shape":"ProjectSource", - "documentation":"

Information to be changed about the build input source code for the build project.

" - }, - "artifacts":{ - "shape":"ProjectArtifacts", - "documentation":"

Information to be changed about the build output artifacts for the build project.

" - }, - "cache":{ - "shape":"ProjectCache", - "documentation":"

Stores recently used information so that it can be quickly accessed at a later time.

" - }, - "environment":{ - "shape":"ProjectEnvironment", - "documentation":"

Information to be changed about the build environment for the build project.

" - }, - "serviceRole":{ - "shape":"NonEmptyString", - "documentation":"

The replacement ARN of the AWS Identity and Access Management (IAM) role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.

" - }, - "timeoutInMinutes":{ - "shape":"TimeOut", - "documentation":"

The replacement value in minutes, from 5 to 480 (8 hours), for AWS CodeBuild to wait before timing out any related build that did not get marked as completed.

" - }, - "encryptionKey":{ - "shape":"NonEmptyString", - "documentation":"

The replacement AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.

You can specify either the CMK's Amazon Resource Name (ARN) or, if available, the CMK's alias (using the format alias/alias-name ).

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The replacement set of tags for this build project.

These tags are available for use by AWS services that support AWS CodeBuild build project tags.

" - }, - "vpcConfig":{ - "shape":"VpcConfig", - "documentation":"

VpcConfig enables AWS CodeBuild to access resources in an Amazon VPC.

" - }, - "badgeEnabled":{ - "shape":"WrapperBoolean", - "documentation":"

Set this to true to generate a publicly-accessible URL for your project's build badge.

" - } - } - }, - "UpdateProjectOutput":{ - "type":"structure", - "members":{ - "project":{ - "shape":"Project", - "documentation":"

Information about the build project that was changed.

" - } - } - }, - "UpdateWebhookInput":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the AWS CodeBuild project.

" - }, - "branchFilter":{ - "shape":"String", - "documentation":"

A regular expression used to determine which branches in a repository are built when a webhook is triggered. If the name of a branch matches the regular expression, then it is built. If it doesn't match, then it is not. If branchFilter is empty, then all branches are built.

" - }, - "rotateSecret":{ - "shape":"Boolean", - "documentation":"

A boolean value that specifies whether the associated repository's secret token should be updated.

" - } - } - }, - "UpdateWebhookOutput":{ - "type":"structure", - "members":{ - "webhook":{ - "shape":"Webhook", - "documentation":"

Information about a repository's webhook that is associated with a project in AWS CodeBuild.

" - } - } - }, - "ValueInput":{ - "type":"string", - "max":255, - "min":1, - "pattern":"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=@+\\\\-]*)$" - }, - "VpcConfig":{ - "type":"structure", - "members":{ - "vpcId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the Amazon VPC.

" - }, - "subnets":{ - "shape":"Subnets", - "documentation":"

A list of one or more subnet IDs in your Amazon VPC.

" - }, - "securityGroupIds":{ - "shape":"SecurityGroupIds", - "documentation":"

A list of one or more security groups IDs in your Amazon VPC.

" - } - }, - "documentation":"

Information about the VPC configuration that AWS CodeBuild will access.

" - }, - "Webhook":{ - "type":"structure", - "members":{ - "url":{ - "shape":"NonEmptyString", - "documentation":"

The URL to the webhook.

" - }, - "payloadUrl":{ - "shape":"NonEmptyString", - "documentation":"

The CodeBuild endpoint where webhook events are sent.

" - }, - "secret":{ - "shape":"NonEmptyString", - "documentation":"

The secret token of the associated repository.

" - }, - "branchFilter":{ - "shape":"String", - "documentation":"

A regular expression used to determine which branches in a repository are built when a webhook is triggered. If the name of a branch matches the regular expression, then it is built. If it doesn't match, then it is not. If branchFilter is empty, then all branches are built.

" - }, - "lastModifiedSecret":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating the last time a repository's secret token was modified.

" - } - }, - "documentation":"

Information about a webhook in GitHub that connects repository events to a build project in AWS CodeBuild.

" - }, - "WrapperBoolean":{"type":"boolean"}, - "WrapperInt":{"type":"integer"}, - "WrapperLong":{"type":"long"} - }, - "documentation":"AWS CodeBuild

AWS CodeBuild is a fully managed build service in the cloud. AWS CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy. AWS CodeBuild eliminates the need to provision, manage, and scale your own build servers. It provides prepackaged build environments for the most popular programming languages and build tools, such as Apache Maven, Gradle, and more. You can also fully customize build environments in AWS CodeBuild to use your own build tools. AWS CodeBuild scales automatically to meet peak build requests, and you pay only for the build time you consume. For more information about AWS CodeBuild, see the AWS CodeBuild User Guide.

AWS CodeBuild supports these operations:

  • BatchDeleteBuilds: Deletes one or more builds.

  • BatchGetProjects: Gets information about one or more build projects. A build project defines how AWS CodeBuild will run a build. This includes information such as where to get the source code to build, the build environment to use, the build commands to run, and where to store the build output. A build environment represents a combination of operating system, programming language runtime, and tools that AWS CodeBuild will use to run a build. Also, you can add tags to build projects to help manage your resources and costs.

  • CreateProject: Creates a build project.

  • CreateWebhook: For an existing AWS CodeBuild build project that has its source code stored in a GitHub repository, enables AWS CodeBuild to begin automatically rebuilding the source code every time a code change is pushed to the repository.

  • UpdateWebhook: Changes the settings of an existing webhook.

  • DeleteProject: Deletes a build project.

  • DeleteWebhook: For an existing AWS CodeBuild build project that has its source code stored in a GitHub repository, stops AWS CodeBuild from automatically rebuilding the source code every time a code change is pushed to the repository.

  • ListProjects: Gets a list of build project names, with each build project name representing a single build project.

  • UpdateProject: Changes the settings of an existing build project.

  • BatchGetBuilds: Gets information about one or more builds.

  • ListBuilds: Gets a list of build IDs, with each build ID representing a single build.

  • ListBuildsForProject: Gets a list of build IDs for the specified build project, with each build ID representing a single build.

  • StartBuild: Starts running a build.

  • StopBuild: Attempts to stop running a build.

  • ListCuratedEnvironmentImages: Gets information about Docker images that are managed by AWS CodeBuild.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/paginators-1.json deleted file mode 100644 index b3310fca..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/paginators-1.json +++ /dev/null @@ -1,44 +0,0 @@ -{ - "pagination": { - "ListBranches": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "branches" - }, - "ListRepositories": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "repositories" - }, - "GetCommentsForComparedCommit": { - "result_key": "commentsForComparedCommitData", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "DescribePullRequestEvents": { - "result_key": "pullRequestEvents", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetCommentsForPullRequest": { - "result_key": "commentsForPullRequestData", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListPullRequests": { - "result_key": "pullRequestIds", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetDifferences": { - "result_key": "differences", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/service-2.json deleted file mode 100644 index d3c23312..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codecommit/2015-04-13/service-2.json +++ /dev/null @@ -1,3549 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-04-13", - "endpointPrefix":"codecommit", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CodeCommit", - "serviceFullName":"AWS CodeCommit", - "serviceId":"CodeCommit", - "signatureVersion":"v4", - "targetPrefix":"CodeCommit_20150413", - "uid":"codecommit-2015-04-13" - }, - "operations":{ - "BatchGetRepositories":{ - "name":"BatchGetRepositories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetRepositoriesInput"}, - "output":{"shape":"BatchGetRepositoriesOutput"}, - "errors":[ - {"shape":"RepositoryNamesRequiredException"}, - {"shape":"MaximumRepositoryNamesExceededException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about one or more repositories.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

" - }, - "CreateBranch":{ - "name":"CreateBranch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBranchInput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"BranchNameRequiredException"}, - {"shape":"BranchNameExistsException"}, - {"shape":"InvalidBranchNameException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Creates a new branch in a repository and points the branch to a commit.

Calling the create branch operation does not set a repository's default branch. To do this, call the update default branch operation.

" - }, - "CreatePullRequest":{ - "name":"CreatePullRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePullRequestInput"}, - "output":{"shape":"CreatePullRequestOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"ClientRequestTokenRequiredException"}, - {"shape":"InvalidClientRequestTokenException"}, - {"shape":"IdempotencyParameterMismatchException"}, - {"shape":"ReferenceNameRequiredException"}, - {"shape":"InvalidReferenceNameException"}, - {"shape":"ReferenceDoesNotExistException"}, - {"shape":"ReferenceTypeNotSupportedException"}, - {"shape":"TitleRequiredException"}, - {"shape":"InvalidTitleException"}, - {"shape":"InvalidDescriptionException"}, - {"shape":"TargetsRequiredException"}, - {"shape":"InvalidTargetsException"}, - {"shape":"TargetRequiredException"}, - {"shape":"InvalidTargetException"}, - {"shape":"MultipleRepositoriesInPullRequestException"}, - {"shape":"MaximumOpenPullRequestsExceededException"}, - {"shape":"SourceAndDestinationAreSameException"} - ], - "documentation":"

Creates a pull request in the specified repository.

" - }, - "CreateRepository":{ - "name":"CreateRepository", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRepositoryInput"}, - "output":{"shape":"CreateRepositoryOutput"}, - "errors":[ - {"shape":"RepositoryNameExistsException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"InvalidRepositoryDescriptionException"}, - {"shape":"RepositoryLimitExceededException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Creates a new, empty repository.

" - }, - "DeleteBranch":{ - "name":"DeleteBranch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBranchInput"}, - "output":{"shape":"DeleteBranchOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"BranchNameRequiredException"}, - {"shape":"InvalidBranchNameException"}, - {"shape":"DefaultBranchCannotBeDeletedException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Deletes a branch from a repository, unless that branch is the default branch for the repository.

" - }, - "DeleteCommentContent":{ - "name":"DeleteCommentContent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCommentContentInput"}, - "output":{"shape":"DeleteCommentContentOutput"}, - "errors":[ - {"shape":"CommentDoesNotExistException"}, - {"shape":"CommentIdRequiredException"}, - {"shape":"InvalidCommentIdException"}, - {"shape":"CommentDeletedException"} - ], - "documentation":"

Deletes the content of a comment made on a change, file, or commit in a repository.

" - }, - "DeleteRepository":{ - "name":"DeleteRepository", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRepositoryInput"}, - "output":{"shape":"DeleteRepositoryOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Deletes a repository. If a specified repository was already deleted, a null repository ID will be returned.

Deleting a repository also deletes all associated objects and metadata. After a repository is deleted, all future push calls to the deleted repository will fail.

" - }, - "DescribePullRequestEvents":{ - "name":"DescribePullRequestEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePullRequestEventsInput"}, - "output":{"shape":"DescribePullRequestEventsOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"InvalidPullRequestEventTypeException"}, - {"shape":"InvalidActorArnException"}, - {"shape":"ActorDoesNotExistException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidContinuationTokenException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about one or more pull request events.

" - }, - "GetBlob":{ - "name":"GetBlob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetBlobInput"}, - "output":{"shape":"GetBlobOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"BlobIdRequiredException"}, - {"shape":"InvalidBlobIdException"}, - {"shape":"BlobIdDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"FileTooLargeException"} - ], - "documentation":"

Returns the base-64 encoded content of an individual blob within a repository.

" - }, - "GetBranch":{ - "name":"GetBranch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetBranchInput"}, - "output":{"shape":"GetBranchOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"BranchNameRequiredException"}, - {"shape":"InvalidBranchNameException"}, - {"shape":"BranchDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about a repository branch, including its name and the last commit ID.

" - }, - "GetComment":{ - "name":"GetComment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCommentInput"}, - "output":{"shape":"GetCommentOutput"}, - "errors":[ - {"shape":"CommentDoesNotExistException"}, - {"shape":"CommentIdRequiredException"}, - {"shape":"InvalidCommentIdException"}, - {"shape":"CommentDeletedException"} - ], - "documentation":"

Returns the content of a comment made on a change, file, or commit in a repository.

" - }, - "GetCommentsForComparedCommit":{ - "name":"GetCommentsForComparedCommit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCommentsForComparedCommitInput"}, - "output":{"shape":"GetCommentsForComparedCommitOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidContinuationTokenException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about comments made on the comparison between two commits.

" - }, - "GetCommentsForPullRequest":{ - "name":"GetCommentsForPullRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCommentsForPullRequestInput"}, - "output":{"shape":"GetCommentsForPullRequestOutput"}, - "errors":[ - {"shape":"PullRequestIdRequiredException"}, - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidContinuationTokenException"}, - {"shape":"RepositoryNotAssociatedWithPullRequestException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns comments made on a pull request.

" - }, - "GetCommit":{ - "name":"GetCommit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCommitInput"}, - "output":{"shape":"GetCommitOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"CommitIdDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about a commit, including commit message and committer information.

" - }, - "GetDifferences":{ - "name":"GetDifferences", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDifferencesInput"}, - "output":{"shape":"GetDifferencesOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"InvalidContinuationTokenException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"CommitRequiredException"}, - {"shape":"InvalidCommitException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidPathException"}, - {"shape":"PathDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference). Results can be limited to a specified path.

" - }, - "GetMergeConflicts":{ - "name":"GetMergeConflicts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMergeConflictsInput"}, - "output":{"shape":"GetMergeConflictsOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"MergeOptionRequiredException"}, - {"shape":"InvalidMergeOptionException"}, - {"shape":"InvalidDestinationCommitSpecifierException"}, - {"shape":"InvalidSourceCommitSpecifierException"}, - {"shape":"CommitRequiredException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidCommitException"}, - {"shape":"TipsDivergenceExceededException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about merge conflicts between the before and after commit IDs for a pull request in a repository.

" - }, - "GetPullRequest":{ - "name":"GetPullRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPullRequestInput"}, - "output":{"shape":"GetPullRequestOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Gets information about a pull request in a specified repository.

" - }, - "GetRepository":{ - "name":"GetRepository", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRepositoryInput"}, - "output":{"shape":"GetRepositoryOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns information about a repository.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

" - }, - "GetRepositoryTriggers":{ - "name":"GetRepositoryTriggers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRepositoryTriggersInput"}, - "output":{"shape":"GetRepositoryTriggersOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Gets information about triggers configured for a repository.

" - }, - "ListBranches":{ - "name":"ListBranches", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBranchesInput"}, - "output":{"shape":"ListBranchesOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"InvalidContinuationTokenException"} - ], - "documentation":"

Gets information about one or more branches in a repository.

" - }, - "ListPullRequests":{ - "name":"ListPullRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPullRequestsInput"}, - "output":{"shape":"ListPullRequestsOutput"}, - "errors":[ - {"shape":"InvalidPullRequestStatusException"}, - {"shape":"InvalidAuthorArnException"}, - {"shape":"AuthorDoesNotExistException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidMaxResultsException"}, - {"shape":"InvalidContinuationTokenException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Returns a list of pull requests for a specified repository. The return list can be refined by pull request status or pull request author ARN.

" - }, - "ListRepositories":{ - "name":"ListRepositories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRepositoriesInput"}, - "output":{"shape":"ListRepositoriesOutput"}, - "errors":[ - {"shape":"InvalidSortByException"}, - {"shape":"InvalidOrderException"}, - {"shape":"InvalidContinuationTokenException"} - ], - "documentation":"

Gets information about one or more repositories.

" - }, - "MergePullRequestByFastForward":{ - "name":"MergePullRequestByFastForward", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MergePullRequestByFastForwardInput"}, - "output":{"shape":"MergePullRequestByFastForwardOutput"}, - "errors":[ - {"shape":"ManualMergeRequiredException"}, - {"shape":"PullRequestAlreadyClosedException"}, - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"TipOfSourceReferenceIsDifferentException"}, - {"shape":"ReferenceDoesNotExistException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Closes a pull request and attempts to merge the source commit of a pull request into the specified destination branch for that pull request at the specified commit using the fast-forward merge option.

" - }, - "PostCommentForComparedCommit":{ - "name":"PostCommentForComparedCommit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PostCommentForComparedCommitInput"}, - "output":{"shape":"PostCommentForComparedCommitOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"ClientRequestTokenRequiredException"}, - {"shape":"InvalidClientRequestTokenException"}, - {"shape":"IdempotencyParameterMismatchException"}, - {"shape":"CommentContentRequiredException"}, - {"shape":"CommentContentSizeLimitExceededException"}, - {"shape":"InvalidFileLocationException"}, - {"shape":"InvalidRelativeFileVersionEnumException"}, - {"shape":"PathRequiredException"}, - {"shape":"InvalidFilePositionException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"BeforeCommitIdAndAfterCommitIdAreSameException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidPathException"}, - {"shape":"PathDoesNotExistException"} - ], - "documentation":"

Posts a comment on the comparison between two commits.

", - "idempotent":true - }, - "PostCommentForPullRequest":{ - "name":"PostCommentForPullRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PostCommentForPullRequestInput"}, - "output":{"shape":"PostCommentForPullRequestOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"RepositoryNotAssociatedWithPullRequestException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"ClientRequestTokenRequiredException"}, - {"shape":"InvalidClientRequestTokenException"}, - {"shape":"IdempotencyParameterMismatchException"}, - {"shape":"CommentContentRequiredException"}, - {"shape":"CommentContentSizeLimitExceededException"}, - {"shape":"InvalidFileLocationException"}, - {"shape":"InvalidRelativeFileVersionEnumException"}, - {"shape":"PathRequiredException"}, - {"shape":"InvalidFilePositionException"}, - {"shape":"CommitIdRequiredException"}, - {"shape":"InvalidCommitIdException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"CommitDoesNotExistException"}, - {"shape":"InvalidPathException"}, - {"shape":"PathDoesNotExistException"}, - {"shape":"PathRequiredException"}, - {"shape":"BeforeCommitIdAndAfterCommitIdAreSameException"} - ], - "documentation":"

Posts a comment on a pull request.

", - "idempotent":true - }, - "PostCommentReply":{ - "name":"PostCommentReply", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PostCommentReplyInput"}, - "output":{"shape":"PostCommentReplyOutput"}, - "errors":[ - {"shape":"ClientRequestTokenRequiredException"}, - {"shape":"InvalidClientRequestTokenException"}, - {"shape":"IdempotencyParameterMismatchException"}, - {"shape":"CommentContentRequiredException"}, - {"shape":"CommentContentSizeLimitExceededException"}, - {"shape":"CommentDoesNotExistException"}, - {"shape":"CommentIdRequiredException"}, - {"shape":"InvalidCommentIdException"} - ], - "documentation":"

Posts a comment in reply to an existing comment on a comparison between commits or a pull request.

", - "idempotent":true - }, - "PutFile":{ - "name":"PutFile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutFileInput"}, - "output":{"shape":"PutFileOutput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"ParentCommitIdRequiredException"}, - {"shape":"InvalidParentCommitIdException"}, - {"shape":"ParentCommitDoesNotExistException"}, - {"shape":"ParentCommitIdOutdatedException"}, - {"shape":"FileContentRequiredException"}, - {"shape":"FileContentSizeLimitExceededException"}, - {"shape":"PathRequiredException"}, - {"shape":"InvalidPathException"}, - {"shape":"BranchNameRequiredException"}, - {"shape":"InvalidBranchNameException"}, - {"shape":"BranchDoesNotExistException"}, - {"shape":"BranchNameIsTagNameException"}, - {"shape":"InvalidFileModeException"}, - {"shape":"NameLengthExceededException"}, - {"shape":"InvalidEmailException"}, - {"shape":"CommitMessageLengthExceededException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"}, - {"shape":"SameFileContentException"}, - {"shape":"FileNameConflictsWithDirectoryNameException"}, - {"shape":"DirectoryNameConflictsWithFileNameException"} - ], - "documentation":"

Adds or updates a file in an AWS CodeCommit repository.

" - }, - "PutRepositoryTriggers":{ - "name":"PutRepositoryTriggers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRepositoryTriggersInput"}, - "output":{"shape":"PutRepositoryTriggersOutput"}, - "errors":[ - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryTriggersListRequiredException"}, - {"shape":"MaximumRepositoryTriggersExceededException"}, - {"shape":"InvalidRepositoryTriggerNameException"}, - {"shape":"InvalidRepositoryTriggerDestinationArnException"}, - {"shape":"InvalidRepositoryTriggerRegionException"}, - {"shape":"InvalidRepositoryTriggerCustomDataException"}, - {"shape":"MaximumBranchesExceededException"}, - {"shape":"InvalidRepositoryTriggerBranchNameException"}, - {"shape":"InvalidRepositoryTriggerEventsException"}, - {"shape":"RepositoryTriggerNameRequiredException"}, - {"shape":"RepositoryTriggerDestinationArnRequiredException"}, - {"shape":"RepositoryTriggerBranchNameListRequiredException"}, - {"shape":"RepositoryTriggerEventsListRequiredException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Replaces all triggers for a repository. This can be used to create or delete triggers.

" - }, - "TestRepositoryTriggers":{ - "name":"TestRepositoryTriggers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestRepositoryTriggersInput"}, - "output":{"shape":"TestRepositoryTriggersOutput"}, - "errors":[ - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"RepositoryTriggersListRequiredException"}, - {"shape":"MaximumRepositoryTriggersExceededException"}, - {"shape":"InvalidRepositoryTriggerNameException"}, - {"shape":"InvalidRepositoryTriggerDestinationArnException"}, - {"shape":"InvalidRepositoryTriggerRegionException"}, - {"shape":"InvalidRepositoryTriggerCustomDataException"}, - {"shape":"MaximumBranchesExceededException"}, - {"shape":"InvalidRepositoryTriggerBranchNameException"}, - {"shape":"InvalidRepositoryTriggerEventsException"}, - {"shape":"RepositoryTriggerNameRequiredException"}, - {"shape":"RepositoryTriggerDestinationArnRequiredException"}, - {"shape":"RepositoryTriggerBranchNameListRequiredException"}, - {"shape":"RepositoryTriggerEventsListRequiredException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Tests the functionality of repository triggers by sending information to the trigger target. If real data is available in the repository, the test will send data from the last commit. If no data is available, sample data will be generated.

" - }, - "UpdateComment":{ - "name":"UpdateComment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCommentInput"}, - "output":{"shape":"UpdateCommentOutput"}, - "errors":[ - {"shape":"CommentContentRequiredException"}, - {"shape":"CommentContentSizeLimitExceededException"}, - {"shape":"CommentDoesNotExistException"}, - {"shape":"CommentIdRequiredException"}, - {"shape":"InvalidCommentIdException"}, - {"shape":"CommentNotCreatedByCallerException"}, - {"shape":"CommentDeletedException"} - ], - "documentation":"

Replaces the contents of a comment.

" - }, - "UpdateDefaultBranch":{ - "name":"UpdateDefaultBranch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDefaultBranchInput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"BranchNameRequiredException"}, - {"shape":"InvalidBranchNameException"}, - {"shape":"BranchDoesNotExistException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Sets or changes the default branch name for the specified repository.

If you use this operation to change the default branch name to the current default branch name, a success message is returned even though the default branch did not change.

" - }, - "UpdatePullRequestDescription":{ - "name":"UpdatePullRequestDescription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePullRequestDescriptionInput"}, - "output":{"shape":"UpdatePullRequestDescriptionOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"InvalidDescriptionException"}, - {"shape":"PullRequestAlreadyClosedException"} - ], - "documentation":"

Replaces the contents of the description of a pull request.

" - }, - "UpdatePullRequestStatus":{ - "name":"UpdatePullRequestStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePullRequestStatusInput"}, - "output":{"shape":"UpdatePullRequestStatusOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"InvalidPullRequestStatusUpdateException"}, - {"shape":"InvalidPullRequestStatusException"}, - {"shape":"PullRequestStatusRequiredException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Updates the status of a pull request.

" - }, - "UpdatePullRequestTitle":{ - "name":"UpdatePullRequestTitle", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePullRequestTitleInput"}, - "output":{"shape":"UpdatePullRequestTitleOutput"}, - "errors":[ - {"shape":"PullRequestDoesNotExistException"}, - {"shape":"InvalidPullRequestIdException"}, - {"shape":"PullRequestIdRequiredException"}, - {"shape":"TitleRequiredException"}, - {"shape":"InvalidTitleException"}, - {"shape":"PullRequestAlreadyClosedException"} - ], - "documentation":"

Replaces the title of a pull request.

" - }, - "UpdateRepositoryDescription":{ - "name":"UpdateRepositoryDescription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRepositoryDescriptionInput"}, - "errors":[ - {"shape":"RepositoryNameRequiredException"}, - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"InvalidRepositoryNameException"}, - {"shape":"InvalidRepositoryDescriptionException"}, - {"shape":"EncryptionIntegrityChecksFailedException"}, - {"shape":"EncryptionKeyAccessDeniedException"}, - {"shape":"EncryptionKeyDisabledException"}, - {"shape":"EncryptionKeyNotFoundException"}, - {"shape":"EncryptionKeyUnavailableException"} - ], - "documentation":"

Sets or changes the comment or description for a repository.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

" - }, - "UpdateRepositoryName":{ - "name":"UpdateRepositoryName", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRepositoryNameInput"}, - "errors":[ - {"shape":"RepositoryDoesNotExistException"}, - {"shape":"RepositoryNameExistsException"}, - {"shape":"RepositoryNameRequiredException"}, - {"shape":"InvalidRepositoryNameException"} - ], - "documentation":"

Renames a repository. The repository name must be unique across the calling AWS account. In addition, repository names are limited to 100 alphanumeric, dash, and underscore characters, and cannot include certain characters. The suffix \".git\" is prohibited. For a full description of the limits on repository names, see Limits in the AWS CodeCommit User Guide.

" - } - }, - "shapes":{ - "AccountId":{"type":"string"}, - "ActorDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon Resource Name (ARN) does not exist in the AWS account.

", - "exception":true - }, - "AdditionalData":{"type":"string"}, - "Arn":{"type":"string"}, - "AuthorDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon Resource Name (ARN) does not exist in the AWS account.

", - "exception":true - }, - "BatchGetRepositoriesInput":{ - "type":"structure", - "required":["repositoryNames"], - "members":{ - "repositoryNames":{ - "shape":"RepositoryNameList", - "documentation":"

The names of the repositories to get information about.

" - } - }, - "documentation":"

Represents the input of a batch get repositories operation.

" - }, - "BatchGetRepositoriesOutput":{ - "type":"structure", - "members":{ - "repositories":{ - "shape":"RepositoryMetadataList", - "documentation":"

A list of repositories returned by the batch get repositories operation.

" - }, - "repositoriesNotFound":{ - "shape":"RepositoryNotFoundList", - "documentation":"

Returns a list of repository names for which information could not be found.

" - } - }, - "documentation":"

Represents the output of a batch get repositories operation.

" - }, - "BeforeCommitIdAndAfterCommitIdAreSameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The before commit ID and the after commit ID are the same, which is not valid. The before commit ID and the after commit ID must be different commit IDs.

", - "exception":true - }, - "BlobIdDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified blob does not exist.

", - "exception":true - }, - "BlobIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A blob ID is required but was not specified.

", - "exception":true - }, - "BlobMetadata":{ - "type":"structure", - "members":{ - "blobId":{ - "shape":"ObjectId", - "documentation":"

The full ID of the blob.

" - }, - "path":{ - "shape":"Path", - "documentation":"

The path to the blob and any associated file name, if any.

" - }, - "mode":{ - "shape":"Mode", - "documentation":"

The file mode permissions of the blob. File mode permission codes include:

  • 100644 indicates read/write

  • 100755 indicates read/write/execute

  • 160000 indicates a submodule

  • 120000 indicates a symlink

" - } - }, - "documentation":"

Returns information about a specific Git blob object.

" - }, - "BranchDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified branch does not exist.

", - "exception":true - }, - "BranchInfo":{ - "type":"structure", - "members":{ - "branchName":{ - "shape":"BranchName", - "documentation":"

The name of the branch.

" - }, - "commitId":{ - "shape":"CommitId", - "documentation":"

The ID of the last commit made to the branch.

" - } - }, - "documentation":"

Returns information about a branch.

" - }, - "BranchName":{ - "type":"string", - "max":256, - "min":1 - }, - "BranchNameExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified branch name already exists.

", - "exception":true - }, - "BranchNameIsTagNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified branch name is not valid because it is a tag name. Type the name of a current branch in the repository. For a list of valid branch names, use ListBranches.

", - "exception":true - }, - "BranchNameList":{ - "type":"list", - "member":{"shape":"BranchName"} - }, - "BranchNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A branch name is required but was not specified.

", - "exception":true - }, - "ChangeTypeEnum":{ - "type":"string", - "enum":[ - "A", - "M", - "D" - ] - }, - "ClientRequestToken":{"type":"string"}, - "ClientRequestTokenRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A client request token is required. A client request token is an unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

", - "exception":true - }, - "CloneUrlHttp":{"type":"string"}, - "CloneUrlSsh":{"type":"string"}, - "Comment":{ - "type":"structure", - "members":{ - "commentId":{ - "shape":"CommentId", - "documentation":"

The system-generated comment ID.

" - }, - "content":{ - "shape":"Content", - "documentation":"

The content of the comment.

" - }, - "inReplyTo":{ - "shape":"CommentId", - "documentation":"

The ID of the comment for which this comment is a reply, if any.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The date and time the comment was created, in timestamp format.

" - }, - "lastModifiedDate":{ - "shape":"LastModifiedDate", - "documentation":"

The date and time the comment was most recently modified, in timestamp format.

" - }, - "authorArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the person who posted the comment.

" - }, - "deleted":{ - "shape":"IsCommentDeleted", - "documentation":"

A Boolean value indicating whether the comment has been deleted.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

" - } - }, - "documentation":"

Returns information about a specific comment.

" - }, - "CommentContentRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The comment is empty. You must provide some content for a comment. The content cannot be null.

", - "exception":true - }, - "CommentContentSizeLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The comment is too large. Comments are limited to 1,000 characters.

", - "exception":true - }, - "CommentDeletedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This comment has already been deleted. You cannot edit or delete a deleted comment.

", - "exception":true - }, - "CommentDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

No comment exists with the provided ID. Verify that you have provided the correct ID, and then try again.

", - "exception":true - }, - "CommentId":{"type":"string"}, - "CommentIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The comment ID is missing or null. A comment ID is required.

", - "exception":true - }, - "CommentNotCreatedByCallerException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot modify or delete this comment. Only comment authors can modify or delete their comments.

", - "exception":true - }, - "Comments":{ - "type":"list", - "member":{"shape":"Comment"} - }, - "CommentsForComparedCommit":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the compared commits.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit used to establish the 'before' of the comparison.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit used to establish the 'after' of the comparison.

" - }, - "beforeBlobId":{ - "shape":"ObjectId", - "documentation":"

The full blob ID of the commit used to establish the 'before' of the comparison.

" - }, - "afterBlobId":{ - "shape":"ObjectId", - "documentation":"

The full blob ID of the commit used to establish the 'after' of the comparison.

" - }, - "location":{ - "shape":"Location", - "documentation":"

Location information about the comment on the comparison, including the file name, line number, and whether the version of the file where the comment was made is 'BEFORE' or 'AFTER'.

" - }, - "comments":{ - "shape":"Comments", - "documentation":"

An array of comment objects. Each comment object contains information about a comment on the comparison between commits.

" - } - }, - "documentation":"

Returns information about comments on the comparison between two commits.

" - }, - "CommentsForComparedCommitData":{ - "type":"list", - "member":{"shape":"CommentsForComparedCommit"} - }, - "CommentsForPullRequest":{ - "type":"structure", - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the pull request.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit that was the tip of the destination branch when the pull request was created. This commit will be superceded by the after commit in the source branch when and if you merge the source branch into the destination branch.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

he full commit ID of the commit that was the tip of the source branch at the time the comment was made.

" - }, - "beforeBlobId":{ - "shape":"ObjectId", - "documentation":"

The full blob ID of the file on which you want to comment on the destination commit.

" - }, - "afterBlobId":{ - "shape":"ObjectId", - "documentation":"

The full blob ID of the file on which you want to comment on the source commit.

" - }, - "location":{ - "shape":"Location", - "documentation":"

Location information about the comment on the pull request, including the file name, line number, and whether the version of the file where the comment was made is 'BEFORE' (destination branch) or 'AFTER' (source branch).

" - }, - "comments":{ - "shape":"Comments", - "documentation":"

An array of comment objects. Each comment object contains information about a comment on the pull request.

" - } - }, - "documentation":"

Returns information about comments on a pull request.

" - }, - "CommentsForPullRequestData":{ - "type":"list", - "member":{"shape":"CommentsForPullRequest"} - }, - "Commit":{ - "type":"structure", - "members":{ - "commitId":{ - "shape":"ObjectId", - "documentation":"

The full SHA of the specified commit.

" - }, - "treeId":{ - "shape":"ObjectId", - "documentation":"

Tree information for the specified commit.

" - }, - "parents":{ - "shape":"ParentList", - "documentation":"

A list of parent commits for the specified commit. Each parent commit ID is the full commit ID.

" - }, - "message":{ - "shape":"Message", - "documentation":"

The commit message associated with the specified commit.

" - }, - "author":{ - "shape":"UserInfo", - "documentation":"

Information about the author of the specified commit. Information includes the date in timestamp format with GMT offset, the name of the author, and the email address for the author, as configured in Git.

" - }, - "committer":{ - "shape":"UserInfo", - "documentation":"

Information about the person who committed the specified commit, also known as the committer. Information includes the date in timestamp format with GMT offset, the name of the committer, and the email address for the committer, as configured in Git.

For more information about the difference between an author and a committer in Git, see Viewing the Commit History in Pro Git by Scott Chacon and Ben Straub.

" - }, - "additionalData":{ - "shape":"AdditionalData", - "documentation":"

Any additional data associated with the specified commit.

" - } - }, - "documentation":"

Returns information about a specific commit.

" - }, - "CommitDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified commit does not exist or no commit was specified, and the specified repository has no default branch.

", - "exception":true - }, - "CommitId":{"type":"string"}, - "CommitIdDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified commit ID does not exist.

", - "exception":true - }, - "CommitIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A commit ID was not specified.

", - "exception":true - }, - "CommitMessageLengthExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The commit message is too long. Provide a shorter string.

", - "exception":true - }, - "CommitName":{"type":"string"}, - "CommitRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A commit was not specified.

", - "exception":true - }, - "Content":{"type":"string"}, - "CreateBranchInput":{ - "type":"structure", - "required":[ - "repositoryName", - "branchName", - "commitId" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository in which you want to create the new branch.

" - }, - "branchName":{ - "shape":"BranchName", - "documentation":"

The name of the new branch to create.

" - }, - "commitId":{ - "shape":"CommitId", - "documentation":"

The ID of the commit to point the new branch to.

" - } - }, - "documentation":"

Represents the input of a create branch operation.

" - }, - "CreatePullRequestInput":{ - "type":"structure", - "required":[ - "title", - "targets" - ], - "members":{ - "title":{ - "shape":"Title", - "documentation":"

The title of the pull request. This title will be used to identify the pull request to other users in the repository.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the pull request.

" - }, - "targets":{ - "shape":"TargetList", - "documentation":"

The targets for the pull request, including the source of the code to be reviewed (the source branch), and the destination where the creator of the pull request intends the code to be merged after the pull request is closed (the destination branch).

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

The AWS SDKs prepopulate client request tokens. If using an AWS SDK, you do not have to generate an idempotency token, as this will be done for you.

", - "idempotencyToken":true - } - } - }, - "CreatePullRequestOutput":{ - "type":"structure", - "required":["pullRequest"], - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the newly created pull request.

" - } - } - }, - "CreateRepositoryInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the new repository to be created.

The repository name must be unique across the calling AWS account. In addition, repository names are limited to 100 alphanumeric, dash, and underscore characters, and cannot include certain characters. For a full description of the limits on repository names, see Limits in the AWS CodeCommit User Guide. The suffix \".git\" is prohibited.

" - }, - "repositoryDescription":{ - "shape":"RepositoryDescription", - "documentation":"

A comment or description about the new repository.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

" - } - }, - "documentation":"

Represents the input of a create repository operation.

" - }, - "CreateRepositoryOutput":{ - "type":"structure", - "members":{ - "repositoryMetadata":{ - "shape":"RepositoryMetadata", - "documentation":"

Information about the newly created repository.

" - } - }, - "documentation":"

Represents the output of a create repository operation.

" - }, - "CreationDate":{"type":"timestamp"}, - "Date":{"type":"string"}, - "DefaultBranchCannotBeDeletedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified branch is the default branch for the repository, and cannot be deleted. To delete this branch, you must first set another branch as the default branch.

", - "exception":true - }, - "DeleteBranchInput":{ - "type":"structure", - "required":[ - "repositoryName", - "branchName" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the branch to be deleted.

" - }, - "branchName":{ - "shape":"BranchName", - "documentation":"

The name of the branch to delete.

" - } - }, - "documentation":"

Represents the input of a delete branch operation.

" - }, - "DeleteBranchOutput":{ - "type":"structure", - "members":{ - "deletedBranch":{ - "shape":"BranchInfo", - "documentation":"

Information about the branch deleted by the operation, including the branch name and the commit ID that was the tip of the branch.

" - } - }, - "documentation":"

Represents the output of a delete branch operation.

" - }, - "DeleteCommentContentInput":{ - "type":"structure", - "required":["commentId"], - "members":{ - "commentId":{ - "shape":"CommentId", - "documentation":"

The unique, system-generated ID of the comment. To get this ID, use GetCommentsForComparedCommit or GetCommentsForPullRequest.

" - } - } - }, - "DeleteCommentContentOutput":{ - "type":"structure", - "members":{ - "comment":{ - "shape":"Comment", - "documentation":"

Information about the comment you just deleted.

" - } - } - }, - "DeleteRepositoryInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to delete.

" - } - }, - "documentation":"

Represents the input of a delete repository operation.

" - }, - "DeleteRepositoryOutput":{ - "type":"structure", - "members":{ - "repositoryId":{ - "shape":"RepositoryId", - "documentation":"

The ID of the repository that was deleted.

" - } - }, - "documentation":"

Represents the output of a delete repository operation.

" - }, - "DescribePullRequestEventsInput":{ - "type":"structure", - "required":["pullRequestId"], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "pullRequestEventType":{ - "shape":"PullRequestEventType", - "documentation":"

Optional. The pull request event type about which you want to return information.

" - }, - "actorArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the user whose actions resulted in the event. Examples include updating the pull request with additional commits or changing the status of a pull request.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

A non-negative integer used to limit the number of returned results. The default is 100 events, which is also the maximum number of events that can be returned in a result.

" - } - } - }, - "DescribePullRequestEventsOutput":{ - "type":"structure", - "required":["pullRequestEvents"], - "members":{ - "pullRequestEvents":{ - "shape":"PullRequestEventList", - "documentation":"

Information about the pull request events.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that can be used in a request to return the next batch of the results.

" - } - } - }, - "Description":{ - "type":"string", - "max":10240 - }, - "Difference":{ - "type":"structure", - "members":{ - "beforeBlob":{ - "shape":"BlobMetadata", - "documentation":"

Information about a beforeBlob data type object, including the ID, the file mode permission code, and the path.

" - }, - "afterBlob":{ - "shape":"BlobMetadata", - "documentation":"

Information about an afterBlob data type object, including the ID, the file mode permission code, and the path.

" - }, - "changeType":{ - "shape":"ChangeTypeEnum", - "documentation":"

Whether the change type of the difference is an addition (A), deletion (D), or modification (M).

" - } - }, - "documentation":"

Returns information about a set of differences for a commit specifier.

" - }, - "DifferenceList":{ - "type":"list", - "member":{"shape":"Difference"} - }, - "DirectoryNameConflictsWithFileNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A file cannot be added to the repository because the specified path name has the same name as a file that already exists in this repository. Either provide a different name for the file, or specify a different path for the file.

", - "exception":true - }, - "Email":{"type":"string"}, - "EncryptionIntegrityChecksFailedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An encryption integrity check failed.

", - "exception":true, - "fault":true - }, - "EncryptionKeyAccessDeniedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An encryption key could not be accessed.

", - "exception":true - }, - "EncryptionKeyDisabledException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The encryption key is disabled.

", - "exception":true - }, - "EncryptionKeyNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

No encryption key was found.

", - "exception":true - }, - "EncryptionKeyUnavailableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The encryption key is not available.

", - "exception":true - }, - "EventDate":{"type":"timestamp"}, - "FileContent":{ - "type":"blob", - "max":6291456 - }, - "FileContentRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file cannot be added because it is empty. Empty files cannot be added to the repository with this API.

", - "exception":true - }, - "FileContentSizeLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file cannot be added because it is too large. The maximum file size that can be added using PutFile is 6 MB. For files larger than 6 MB but smaller than 2 GB, add them using a Git client.

", - "exception":true - }, - "FileModeTypeEnum":{ - "type":"string", - "enum":[ - "EXECUTABLE", - "NORMAL", - "SYMLINK" - ] - }, - "FileNameConflictsWithDirectoryNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A file cannot be added to the repository because the specified file name has the same name as a directory in this repository. Either provide another name for the file, or add the file in a directory that does not match the file name.

", - "exception":true - }, - "FileTooLargeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified file exceeds the file size limit for AWS CodeCommit. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide.

", - "exception":true - }, - "GetBlobInput":{ - "type":"structure", - "required":[ - "repositoryName", - "blobId" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the blob.

" - }, - "blobId":{ - "shape":"ObjectId", - "documentation":"

The ID of the blob, which is its SHA-1 pointer.

" - } - }, - "documentation":"

Represents the input of a get blob operation.

" - }, - "GetBlobOutput":{ - "type":"structure", - "required":["content"], - "members":{ - "content":{ - "shape":"blob", - "documentation":"

The content of the blob, usually a file.

" - } - }, - "documentation":"

Represents the output of a get blob operation.

" - }, - "GetBranchInput":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the branch for which you want to retrieve information.

" - }, - "branchName":{ - "shape":"BranchName", - "documentation":"

The name of the branch for which you want to retrieve information.

" - } - }, - "documentation":"

Represents the input of a get branch operation.

" - }, - "GetBranchOutput":{ - "type":"structure", - "members":{ - "branch":{ - "shape":"BranchInfo", - "documentation":"

The name of the branch.

" - } - }, - "documentation":"

Represents the output of a get branch operation.

" - }, - "GetCommentInput":{ - "type":"structure", - "required":["commentId"], - "members":{ - "commentId":{ - "shape":"CommentId", - "documentation":"

The unique, system-generated ID of the comment. To get this ID, use GetCommentsForComparedCommit or GetCommentsForPullRequest.

" - } - } - }, - "GetCommentOutput":{ - "type":"structure", - "members":{ - "comment":{ - "shape":"Comment", - "documentation":"

The contents of the comment.

" - } - } - }, - "GetCommentsForComparedCommitInput":{ - "type":"structure", - "required":[ - "repositoryName", - "afterCommitId" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to compare commits.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

To establish the directionality of the comparison, the full commit ID of the 'before' commit.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

To establish the directionality of the comparison, the full commit ID of the 'after' commit.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

A non-negative integer used to limit the number of returned results. The default is 100 comments, and is configurable up to 500.

" - } - } - }, - "GetCommentsForComparedCommitOutput":{ - "type":"structure", - "members":{ - "commentsForComparedCommitData":{ - "shape":"CommentsForComparedCommitData", - "documentation":"

A list of comment objects on the compared commit.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that can be used in a request to return the next batch of the results.

" - } - } - }, - "GetCommentsForPullRequestInput":{ - "type":"structure", - "required":["pullRequestId"], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the pull request.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the destination branch that was the tip of the branch at the time the pull request was created.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the source branch that was the tip of the branch at the time the comment was made.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

A non-negative integer used to limit the number of returned results. The default is 100 comments. You can return up to 500 comments with a single request.

" - } - } - }, - "GetCommentsForPullRequestOutput":{ - "type":"structure", - "members":{ - "commentsForPullRequestData":{ - "shape":"CommentsForPullRequestData", - "documentation":"

An array of comment objects on the pull request.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that can be used in a request to return the next batch of the results.

" - } - } - }, - "GetCommitInput":{ - "type":"structure", - "required":[ - "repositoryName", - "commitId" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to which the commit was made.

" - }, - "commitId":{ - "shape":"ObjectId", - "documentation":"

The commit ID. Commit IDs are the full SHA of the commit.

" - } - }, - "documentation":"

Represents the input of a get commit operation.

" - }, - "GetCommitOutput":{ - "type":"structure", - "required":["commit"], - "members":{ - "commit":{ - "shape":"Commit", - "documentation":"

A commit data type object that contains information about the specified commit.

" - } - }, - "documentation":"

Represents the output of a get commit operation.

" - }, - "GetDifferencesInput":{ - "type":"structure", - "required":[ - "repositoryName", - "afterCommitSpecifier" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to get differences.

" - }, - "beforeCommitSpecifier":{ - "shape":"CommitName", - "documentation":"

The branch, tag, HEAD, or other fully qualified reference used to identify a commit. For example, the full commit ID. Optional. If not specified, all changes prior to the afterCommitSpecifier value will be shown. If you do not use beforeCommitSpecifier in your request, consider limiting the results with maxResults.

" - }, - "afterCommitSpecifier":{ - "shape":"CommitName", - "documentation":"

The branch, tag, HEAD, or other fully qualified reference used to identify a commit.

" - }, - "beforePath":{ - "shape":"Path", - "documentation":"

The file path in which to check for differences. Limits the results to this path. Can also be used to specify the previous name of a directory or folder. If beforePath and afterPath are not specified, differences will be shown for all paths.

" - }, - "afterPath":{ - "shape":"Path", - "documentation":"

The file path in which to check differences. Limits the results to this path. Can also be used to specify the changed name of a directory or folder, if it has changed. If not specified, differences will be shown for all paths.

" - }, - "MaxResults":{ - "shape":"Limit", - "documentation":"

A non-negative integer used to limit the number of returned results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - } - } - }, - "GetDifferencesOutput":{ - "type":"structure", - "members":{ - "differences":{ - "shape":"DifferenceList", - "documentation":"

A differences data type object that contains information about the differences, including whether the difference is added, modified, or deleted (A, D, M).

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that can be used in a request to return the next batch of the results.

" - } - } - }, - "GetMergeConflictsInput":{ - "type":"structure", - "required":[ - "repositoryName", - "destinationCommitSpecifier", - "sourceCommitSpecifier", - "mergeOption" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where the pull request was created.

" - }, - "destinationCommitSpecifier":{ - "shape":"CommitName", - "documentation":"

The branch, tag, HEAD, or other fully qualified reference used to identify a commit. For example, a branch name or a full commit ID.

" - }, - "sourceCommitSpecifier":{ - "shape":"CommitName", - "documentation":"

The branch, tag, HEAD, or other fully qualified reference used to identify a commit. For example, a branch name or a full commit ID.

" - }, - "mergeOption":{ - "shape":"MergeOptionTypeEnum", - "documentation":"

The merge option or strategy you want to use to merge the code. The only valid value is FAST_FORWARD_MERGE.

" - } - } - }, - "GetMergeConflictsOutput":{ - "type":"structure", - "required":[ - "mergeable", - "destinationCommitId", - "sourceCommitId" - ], - "members":{ - "mergeable":{ - "shape":"IsMergeable", - "documentation":"

A Boolean value that indicates whether the code is mergable by the specified merge option.

" - }, - "destinationCommitId":{ - "shape":"CommitId", - "documentation":"

The commit ID of the destination commit specifier that was used in the merge evaluation.

" - }, - "sourceCommitId":{ - "shape":"CommitId", - "documentation":"

The commit ID of the source commit specifier that was used in the merge evaluation.

" - } - } - }, - "GetPullRequestInput":{ - "type":"structure", - "required":["pullRequestId"], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - } - } - }, - "GetPullRequestOutput":{ - "type":"structure", - "required":["pullRequest"], - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the specified pull request.

" - } - } - }, - "GetRepositoryInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to get information about.

" - } - }, - "documentation":"

Represents the input of a get repository operation.

" - }, - "GetRepositoryOutput":{ - "type":"structure", - "members":{ - "repositoryMetadata":{ - "shape":"RepositoryMetadata", - "documentation":"

Information about the repository.

" - } - }, - "documentation":"

Represents the output of a get repository operation.

" - }, - "GetRepositoryTriggersInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository for which the trigger is configured.

" - } - }, - "documentation":"

Represents the input of a get repository triggers operation.

" - }, - "GetRepositoryTriggersOutput":{ - "type":"structure", - "members":{ - "configurationId":{ - "shape":"RepositoryTriggersConfigurationId", - "documentation":"

The system-generated unique ID for the trigger.

" - }, - "triggers":{ - "shape":"RepositoryTriggersList", - "documentation":"

The JSON block of configuration information for each trigger.

" - } - }, - "documentation":"

Represents the output of a get repository triggers operation.

" - }, - "IdempotencyParameterMismatchException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The client request token is not valid. Either the token is not in a valid format, or the token has been used in a previous request and cannot be re-used.

", - "exception":true - }, - "InvalidActorArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Amazon Resource Name (ARN) is not valid. Make sure that you have provided the full ARN for the user who initiated the change for the pull request, and then try again.

", - "exception":true - }, - "InvalidAuthorArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Amazon Resource Name (ARN) is not valid. Make sure that you have provided the full ARN for the author of the pull request, and then try again.

", - "exception":true - }, - "InvalidBlobIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified blob is not valid.

", - "exception":true - }, - "InvalidBranchNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reference name is not valid.

", - "exception":true - }, - "InvalidClientRequestTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The client request token is not valid.

", - "exception":true - }, - "InvalidCommentIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The comment ID is not in a valid format. Make sure that you have provided the full comment ID.

", - "exception":true - }, - "InvalidCommitException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified commit is not valid.

", - "exception":true - }, - "InvalidCommitIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified commit ID is not valid.

", - "exception":true - }, - "InvalidContinuationTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified continuation token is not valid.

", - "exception":true - }, - "InvalidDescriptionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request description is not valid. Descriptions are limited to 1,000 characters in length.

", - "exception":true - }, - "InvalidDestinationCommitSpecifierException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The destination commit specifier is not valid. You must provide a valid branch name, tag, or full commit ID.

", - "exception":true - }, - "InvalidEmailException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified email address either contains one or more characters that are not allowed, or it exceeds the maximum number of characters allowed for an email address.

", - "exception":true - }, - "InvalidFileLocationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The location of the file is not valid. Make sure that you include the extension of the file as well as the file name.

", - "exception":true - }, - "InvalidFileModeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified file mode permission is not valid. For a list of valid file mode permissions, see PutFile.

", - "exception":true - }, - "InvalidFilePositionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The position is not valid. Make sure that the line number exists in the version of the file you want to comment on.

", - "exception":true - }, - "InvalidMaxResultsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified number of maximum results is not valid.

", - "exception":true - }, - "InvalidMergeOptionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified merge option is not valid. The only valid value is FAST_FORWARD_MERGE.

", - "exception":true - }, - "InvalidOrderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified sort order is not valid.

", - "exception":true - }, - "InvalidParentCommitIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The parent commit ID is not valid. The commit ID cannot be empty, and must match the head commit ID for the branch of the repository where you want to add or update a file.

", - "exception":true - }, - "InvalidPathException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified path is not valid.

", - "exception":true - }, - "InvalidPullRequestEventTypeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request event type is not valid.

", - "exception":true - }, - "InvalidPullRequestIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request is in the specified repository, and then try again.

", - "exception":true - }, - "InvalidPullRequestStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request status is not valid. The only valid values are OPEN and CLOSED.

", - "exception":true - }, - "InvalidPullRequestStatusUpdateException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request status update is not valid. The only valid update is from OPEN to CLOSED.

", - "exception":true - }, - "InvalidReferenceNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reference name format is not valid. Reference names must conform to the Git references format, for example refs/heads/master. For more information, see Git Internals - Git References or consult your Git documentation.

", - "exception":true - }, - "InvalidRelativeFileVersionEnumException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Either the enum is not in a valid format, or the specified file version enum is not valid in respect to the current file version.

", - "exception":true - }, - "InvalidRepositoryDescriptionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified repository description is not valid.

", - "exception":true - }, - "InvalidRepositoryNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

", - "exception":true - }, - "InvalidRepositoryTriggerBranchNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more branch names specified for the trigger is not valid.

", - "exception":true - }, - "InvalidRepositoryTriggerCustomDataException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The custom data provided for the trigger is not valid.

", - "exception":true - }, - "InvalidRepositoryTriggerDestinationArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most common reason for this error is that the ARN does not meet the requirements for the service type.

", - "exception":true - }, - "InvalidRepositoryTriggerEventsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more events specified for the trigger is not valid. Check to make sure that all events specified match the requirements for allowed events.

", - "exception":true - }, - "InvalidRepositoryTriggerNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The name of the trigger is not valid.

", - "exception":true - }, - "InvalidRepositoryTriggerRegionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The region for the trigger target does not match the region for the repository. Triggers must be created in the same region as the target for the trigger.

", - "exception":true - }, - "InvalidSortByException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified sort by value is not valid.

", - "exception":true - }, - "InvalidSourceCommitSpecifierException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The source commit specifier is not valid. You must provide a valid branch name, tag, or full commit ID.

", - "exception":true - }, - "InvalidTargetException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The target for the pull request is not valid. A target must contain the full values for the repository name, source branch, and destination branch for the pull request.

", - "exception":true - }, - "InvalidTargetsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The targets for the pull request is not valid or not in a valid format. Targets are a list of target objects. Each target object must contain the full values for the repository name, source branch, and destination branch for a pull request.

", - "exception":true - }, - "InvalidTitleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The title of the pull request is not valid. Pull request titles cannot exceed 100 characters in length.

", - "exception":true - }, - "IsCommentDeleted":{"type":"boolean"}, - "IsMergeable":{"type":"boolean"}, - "IsMerged":{"type":"boolean"}, - "LastModifiedDate":{"type":"timestamp"}, - "Limit":{ - "type":"integer", - "box":true - }, - "ListBranchesInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the branches.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that allows the operation to batch the results.

" - } - }, - "documentation":"

Represents the input of a list branches operation.

" - }, - "ListBranchesOutput":{ - "type":"structure", - "members":{ - "branches":{ - "shape":"BranchNameList", - "documentation":"

The list of branch names.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that returns the batch of the results.

" - } - }, - "documentation":"

Represents the output of a list branches operation.

" - }, - "ListPullRequestsInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository for which you want to list pull requests.

" - }, - "authorArn":{ - "shape":"Arn", - "documentation":"

Optional. The Amazon Resource Name (ARN) of the user who created the pull request. If used, this filters the results to pull requests created by that user.

" - }, - "pullRequestStatus":{ - "shape":"PullRequestStatusEnum", - "documentation":"

Optional. The status of the pull request. If used, this refines the results to the pull requests that match the specified status.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

A non-negative integer used to limit the number of returned results.

" - } - } - }, - "ListPullRequestsOutput":{ - "type":"structure", - "required":["pullRequestIds"], - "members":{ - "pullRequestIds":{ - "shape":"PullRequestIdList", - "documentation":"

The system-generated IDs of the pull requests.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that when provided in a request, returns the next batch of the results.

" - } - } - }, - "ListRepositoriesInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that allows the operation to batch the results of the operation. Batch sizes are 1,000 for list repository operations. When the client sends the token back to AWS CodeCommit, another page of 1,000 records is retrieved.

" - }, - "sortBy":{ - "shape":"SortByEnum", - "documentation":"

The criteria used to sort the results of a list repositories operation.

" - }, - "order":{ - "shape":"OrderEnum", - "documentation":"

The order in which to sort the results of a list repositories operation.

" - } - }, - "documentation":"

Represents the input of a list repositories operation.

" - }, - "ListRepositoriesOutput":{ - "type":"structure", - "members":{ - "repositories":{ - "shape":"RepositoryNameIdPairList", - "documentation":"

Lists the repositories called by the list repositories operation.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An enumeration token that allows the operation to batch the results of the operation. Batch sizes are 1,000 for list repository operations. When the client sends the token back to AWS CodeCommit, another page of 1,000 records is retrieved.

" - } - }, - "documentation":"

Represents the output of a list repositories operation.

" - }, - "Location":{ - "type":"structure", - "members":{ - "filePath":{ - "shape":"Path", - "documentation":"

The name of the file being compared, including its extension and subdirectory, if any.

" - }, - "filePosition":{ - "shape":"Position", - "documentation":"

The position of a change within a compared file, in line number format.

" - }, - "relativeFileVersion":{ - "shape":"RelativeFileVersionEnum", - "documentation":"

In a comparison of commits or a pull request, whether the change is in the 'before' or 'after' of that comparison.

" - } - }, - "documentation":"

Returns information about the location of a change or comment in the comparison between two commits or a pull request.

" - }, - "ManualMergeRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request cannot be merged automatically into the destination branch. You must manually merge the branches and resolve any conflicts.

", - "exception":true - }, - "MaxResults":{"type":"integer"}, - "MaximumBranchesExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of branches for the trigger was exceeded.

", - "exception":true - }, - "MaximumOpenPullRequestsExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot create the pull request because the repository has too many open pull requests. The maximum number of open pull requests for a repository is 1,000. Close one or more open pull requests, and then try again.

", - "exception":true - }, - "MaximumRepositoryNamesExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum number of allowed repository names was exceeded. Currently, this number is 25.

", - "exception":true - }, - "MaximumRepositoryTriggersExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of triggers allowed for the repository was exceeded.

", - "exception":true - }, - "MergeMetadata":{ - "type":"structure", - "members":{ - "isMerged":{ - "shape":"IsMerged", - "documentation":"

A Boolean value indicating whether the merge has been made.

" - }, - "mergedBy":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the user who merged the branches.

" - } - }, - "documentation":"

Returns information about a merge or potential merge between a source reference and a destination reference in a pull request.

" - }, - "MergeOptionRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A merge option or stategy is required, and none was provided.

", - "exception":true - }, - "MergeOptionTypeEnum":{ - "type":"string", - "enum":["FAST_FORWARD_MERGE"] - }, - "MergePullRequestByFastForwardInput":{ - "type":"structure", - "required":[ - "pullRequestId", - "repositoryName" - ], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where the pull request was created.

" - }, - "sourceCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the original or updated commit in the pull request source branch. Pass this value if you want an exception thrown if the current commit ID of the tip of the source branch does not match this commit ID.

" - } - } - }, - "MergePullRequestByFastForwardOutput":{ - "type":"structure", - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the specified pull request, including information about the merge.

" - } - } - }, - "Message":{"type":"string"}, - "Mode":{"type":"string"}, - "MultipleRepositoriesInPullRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot include more than one repository in a pull request. Make sure you have specified only one repository name in your request, and then try again.

", - "exception":true - }, - "Name":{"type":"string"}, - "NameLengthExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file name is not valid because it has exceeded the character limit for file names. File names, including the path to the file, cannot exceed the character limit.

", - "exception":true - }, - "NextToken":{"type":"string"}, - "ObjectId":{"type":"string"}, - "OrderEnum":{ - "type":"string", - "enum":[ - "ascending", - "descending" - ] - }, - "ParentCommitDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The parent commit ID is not valid. The specified parent commit ID does not exist in the specified branch of the repository.

", - "exception":true - }, - "ParentCommitIdOutdatedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file could not be added because the provided parent commit ID is not the current tip of the specified branch. To view the full commit ID of the current head of the branch, use GetBranch.

", - "exception":true - }, - "ParentCommitIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A parent commit ID is required. To view the full commit ID of a branch in a repository, use GetBranch or a Git command (for example, git pull or git log).

", - "exception":true - }, - "ParentList":{ - "type":"list", - "member":{"shape":"ObjectId"} - }, - "Path":{"type":"string"}, - "PathDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified path does not exist.

", - "exception":true - }, - "PathRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The filePath for a location cannot be empty or null.

", - "exception":true - }, - "Position":{"type":"long"}, - "PostCommentForComparedCommitInput":{ - "type":"structure", - "required":[ - "repositoryName", - "afterCommitId", - "content" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to post a comment on the comparison between commits.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

To establish the directionality of the comparison, the full commit ID of the 'before' commit.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

To establish the directionality of the comparison, the full commit ID of the 'after' commit.

" - }, - "location":{ - "shape":"Location", - "documentation":"

The location of the comparison where you want to comment.

" - }, - "content":{ - "shape":"Content", - "documentation":"

The content of the comment you want to make.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

", - "idempotencyToken":true - } - } - }, - "PostCommentForComparedCommitOutput":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you posted a comment on the comparison between commits.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

In the directionality you established, the full commit ID of the 'before' commit.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

In the directionality you established, the full commit ID of the 'after' commit.

" - }, - "beforeBlobId":{ - "shape":"ObjectId", - "documentation":"

In the directionality you established, the blob ID of the 'before' blob.

" - }, - "afterBlobId":{ - "shape":"ObjectId", - "documentation":"

In the directionality you established, the blob ID of the 'after' blob.

" - }, - "location":{ - "shape":"Location", - "documentation":"

The location of the comment in the comparison between the two commits.

" - }, - "comment":{ - "shape":"Comment", - "documentation":"

The content of the comment you posted.

" - } - } - }, - "PostCommentForPullRequestInput":{ - "type":"structure", - "required":[ - "pullRequestId", - "repositoryName", - "beforeCommitId", - "afterCommitId", - "content" - ], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to post a comment on a pull request.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the destination branch that was the tip of the branch at the time the pull request was created.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the source branch that is the current tip of the branch for the pull request when you post the comment.

" - }, - "location":{ - "shape":"Location", - "documentation":"

The location of the change where you want to post your comment. If no location is provided, the comment will be posted as a general comment on the pull request difference between the before commit ID and the after commit ID.

" - }, - "content":{ - "shape":"Content", - "documentation":"

The content of your comment on the change.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

", - "idempotencyToken":true - } - } - }, - "PostCommentForPullRequestOutput":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you posted a comment on a pull request.

" - }, - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the source branch used to create the pull request, or in the case of an updated pull request, the full commit ID of the commit used to update the pull request.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the destination branch where the pull request will be merged.

" - }, - "beforeBlobId":{ - "shape":"ObjectId", - "documentation":"

In the directionality of the pull request, the blob ID of the 'before' blob.

" - }, - "afterBlobId":{ - "shape":"ObjectId", - "documentation":"

In the directionality of the pull request, the blob ID of the 'after' blob.

" - }, - "location":{ - "shape":"Location", - "documentation":"

The location of the change where you posted your comment.

" - }, - "comment":{ - "shape":"Comment", - "documentation":"

The content of the comment you posted.

" - } - } - }, - "PostCommentReplyInput":{ - "type":"structure", - "required":[ - "inReplyTo", - "content" - ], - "members":{ - "inReplyTo":{ - "shape":"CommentId", - "documentation":"

The system-generated ID of the comment to which you want to reply. To get this ID, use GetCommentsForComparedCommit or GetCommentsForPullRequest.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

", - "idempotencyToken":true - }, - "content":{ - "shape":"Content", - "documentation":"

The contents of your reply to a comment.

" - } - } - }, - "PostCommentReplyOutput":{ - "type":"structure", - "members":{ - "comment":{ - "shape":"Comment", - "documentation":"

Information about the reply to a comment.

" - } - } - }, - "PullRequest":{ - "type":"structure", - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request.

" - }, - "title":{ - "shape":"Title", - "documentation":"

The user-defined title of the pull request. This title is displayed in the list of pull requests to other users of the repository.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The user-defined description of the pull request. This description can be used to clarify what should be reviewed and other details of the request.

" - }, - "lastActivityDate":{ - "shape":"LastModifiedDate", - "documentation":"

The day and time of the last user or system activity on the pull request, in timestamp format.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The date and time the pull request was originally created, in timestamp format.

" - }, - "pullRequestStatus":{ - "shape":"PullRequestStatusEnum", - "documentation":"

The status of the pull request. Pull request status can only change from OPEN to CLOSED.

" - }, - "authorArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the user who created the pull request.

" - }, - "pullRequestTargets":{ - "shape":"PullRequestTargetList", - "documentation":"

The targets of the pull request, including the source branch and destination branch for the pull request.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A unique, client-generated idempotency token that when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request will return information about the initial request that used that token.

" - } - }, - "documentation":"

Returns information about a pull request.

" - }, - "PullRequestAlreadyClosedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request status cannot be updated because it is already closed.

", - "exception":true - }, - "PullRequestDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pull request ID could not be found. Make sure that you have specified the correct repository name and pull request ID, and then try again.

", - "exception":true - }, - "PullRequestEvent":{ - "type":"structure", - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request.

" - }, - "eventDate":{ - "shape":"EventDate", - "documentation":"

The day and time of the pull request event, in timestamp format.

" - }, - "pullRequestEventType":{ - "shape":"PullRequestEventType", - "documentation":"

The type of the pull request event, for example a status change event (PULL_REQUEST_STATUS_CHANGED) or update event (PULL_REQUEST_SOURCE_REFERENCE_UPDATED).

" - }, - "actorArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the user whose actions resulted in the event. Examples include updating the pull request with additional commits or changing the status of a pull request.

" - }, - "pullRequestStatusChangedEventMetadata":{ - "shape":"PullRequestStatusChangedEventMetadata", - "documentation":"

Information about the change in status for the pull request event.

" - }, - "pullRequestSourceReferenceUpdatedEventMetadata":{ - "shape":"PullRequestSourceReferenceUpdatedEventMetadata", - "documentation":"

Information about the updated source branch for the pull request event.

" - }, - "pullRequestMergedStateChangedEventMetadata":{ - "shape":"PullRequestMergedStateChangedEventMetadata", - "documentation":"

Information about the change in mergability state for the pull request event.

" - } - }, - "documentation":"

Returns information about a pull request event.

" - }, - "PullRequestEventList":{ - "type":"list", - "member":{"shape":"PullRequestEvent"} - }, - "PullRequestEventType":{ - "type":"string", - "enum":[ - "PULL_REQUEST_CREATED", - "PULL_REQUEST_STATUS_CHANGED", - "PULL_REQUEST_SOURCE_REFERENCE_UPDATED", - "PULL_REQUEST_MERGE_STATE_CHANGED" - ] - }, - "PullRequestId":{"type":"string"}, - "PullRequestIdList":{ - "type":"list", - "member":{"shape":"PullRequestId"} - }, - "PullRequestIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A pull request ID is required, but none was provided.

", - "exception":true - }, - "PullRequestMergedStateChangedEventMetadata":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where the pull request was created.

" - }, - "destinationReference":{ - "shape":"ReferenceName", - "documentation":"

The name of the branch that the pull request will be merged into.

" - }, - "mergeMetadata":{ - "shape":"MergeMetadata", - "documentation":"

Information about the merge state change event.

" - } - }, - "documentation":"

Returns information about the change in the merge state for a pull request event.

" - }, - "PullRequestSourceReferenceUpdatedEventMetadata":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where the pull request was updated.

" - }, - "beforeCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the destination branch that was the tip of the branch at the time the pull request was updated.

" - }, - "afterCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the commit in the source branch that was the tip of the branch at the time the pull request was updated.

" - } - }, - "documentation":"

Information about an update to the source branch of a pull request.

" - }, - "PullRequestStatusChangedEventMetadata":{ - "type":"structure", - "members":{ - "pullRequestStatus":{ - "shape":"PullRequestStatusEnum", - "documentation":"

The changed status of the pull request.

" - } - }, - "documentation":"

Information about a change to the status of a pull request.

" - }, - "PullRequestStatusEnum":{ - "type":"string", - "enum":[ - "OPEN", - "CLOSED" - ] - }, - "PullRequestStatusRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A pull request status is required, but none was provided.

", - "exception":true - }, - "PullRequestTarget":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the pull request source and destination branches.

" - }, - "sourceReference":{ - "shape":"ReferenceName", - "documentation":"

The branch of the repository that contains the changes for the pull request. Also known as the source branch.

" - }, - "destinationReference":{ - "shape":"ReferenceName", - "documentation":"

The branch of the repository where the pull request changes will be merged into. Also known as the destination branch.

" - }, - "destinationCommit":{ - "shape":"CommitId", - "documentation":"

The full commit ID that is the tip of the destination branch. This is the commit where the pull request was or will be merged.

" - }, - "sourceCommit":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the tip of the source branch used to create the pull request. If the pull request branch is updated by a push while the pull request is open, the commit ID will change to reflect the new tip of the branch.

" - }, - "mergeMetadata":{ - "shape":"MergeMetadata", - "documentation":"

Returns metadata about the state of the merge, including whether the merge has been made.

" - } - }, - "documentation":"

Returns information about a pull request target.

" - }, - "PullRequestTargetList":{ - "type":"list", - "member":{"shape":"PullRequestTarget"} - }, - "PutFileInput":{ - "type":"structure", - "required":[ - "repositoryName", - "branchName", - "fileContent", - "filePath" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to add or update the file.

" - }, - "branchName":{ - "shape":"BranchName", - "documentation":"

The name of the branch where you want to add or update the file.

" - }, - "fileContent":{ - "shape":"FileContent", - "documentation":"

The content of the file, in binary object format.

" - }, - "filePath":{ - "shape":"Path", - "documentation":"

The name of the file you want to add or update, including the relative path to the file in the repository.

If the path does not currently exist in the repository, the path will be created as part of adding the file.

" - }, - "fileMode":{ - "shape":"FileModeTypeEnum", - "documentation":"

The file mode permissions of the blob. Valid file mode permissions are listed below.

" - }, - "parentCommitId":{ - "shape":"CommitId", - "documentation":"

The full commit ID of the head commit in the branch where you want to add or update the file. If the commit ID does not match the ID of the head commit at the time of the operation, an error will occur, and the file will not be added or updated.

" - }, - "commitMessage":{ - "shape":"Message", - "documentation":"

A message about why this file was added or updated. While optional, adding a message is strongly encouraged in order to provide a more useful commit history for your repository.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the person adding or updating the file. While optional, adding a name is strongly encouraged in order to provide a more useful commit history for your repository.

" - }, - "email":{ - "shape":"Email", - "documentation":"

An email address for the person adding or updating the file.

" - } - } - }, - "PutFileOutput":{ - "type":"structure", - "required":[ - "commitId", - "blobId", - "treeId" - ], - "members":{ - "commitId":{ - "shape":"ObjectId", - "documentation":"

The full SHA of the commit that contains this file change.

" - }, - "blobId":{ - "shape":"ObjectId", - "documentation":"

The ID of the blob, which is its SHA-1 pointer.

" - }, - "treeId":{ - "shape":"ObjectId", - "documentation":"

Tree information for the commit that contains this file change.

" - } - } - }, - "PutRepositoryTriggersInput":{ - "type":"structure", - "required":[ - "repositoryName", - "triggers" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository where you want to create or update the trigger.

" - }, - "triggers":{ - "shape":"RepositoryTriggersList", - "documentation":"

The JSON block of configuration information for each trigger.

" - } - }, - "documentation":"

Represents the input ofa put repository triggers operation.

" - }, - "PutRepositoryTriggersOutput":{ - "type":"structure", - "members":{ - "configurationId":{ - "shape":"RepositoryTriggersConfigurationId", - "documentation":"

The system-generated unique ID for the create or update operation.

" - } - }, - "documentation":"

Represents the output of a put repository triggers operation.

" - }, - "ReferenceDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reference does not exist. You must provide a full commit ID.

", - "exception":true - }, - "ReferenceName":{"type":"string"}, - "ReferenceNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A reference name is required, but none was provided.

", - "exception":true - }, - "ReferenceTypeNotSupportedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reference is not a supported type.

", - "exception":true - }, - "RelativeFileVersionEnum":{ - "type":"string", - "enum":[ - "BEFORE", - "AFTER" - ] - }, - "RepositoryDescription":{ - "type":"string", - "max":1000 - }, - "RepositoryDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified repository does not exist.

", - "exception":true - }, - "RepositoryId":{"type":"string"}, - "RepositoryLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A repository resource limit was exceeded.

", - "exception":true - }, - "RepositoryMetadata":{ - "type":"structure", - "members":{ - "accountId":{ - "shape":"AccountId", - "documentation":"

The ID of the AWS account associated with the repository.

" - }, - "repositoryId":{ - "shape":"RepositoryId", - "documentation":"

The ID of the repository.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository's name.

" - }, - "repositoryDescription":{ - "shape":"RepositoryDescription", - "documentation":"

A comment or description about the repository.

" - }, - "defaultBranch":{ - "shape":"BranchName", - "documentation":"

The repository's default branch name.

" - }, - "lastModifiedDate":{ - "shape":"LastModifiedDate", - "documentation":"

The date and time the repository was last modified, in timestamp format.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The date and time the repository was created, in timestamp format.

" - }, - "cloneUrlHttp":{ - "shape":"CloneUrlHttp", - "documentation":"

The URL to use for cloning the repository over HTTPS.

" - }, - "cloneUrlSsh":{ - "shape":"CloneUrlSsh", - "documentation":"

The URL to use for cloning the repository over SSH.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the repository.

" - } - }, - "documentation":"

Information about a repository.

" - }, - "RepositoryMetadataList":{ - "type":"list", - "member":{"shape":"RepositoryMetadata"} - }, - "RepositoryName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[\\w\\.-]+" - }, - "RepositoryNameExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified repository name already exists.

", - "exception":true - }, - "RepositoryNameIdPair":{ - "type":"structure", - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name associated with the repository.

" - }, - "repositoryId":{ - "shape":"RepositoryId", - "documentation":"

The ID associated with the repository.

" - } - }, - "documentation":"

Information about a repository name and ID.

" - }, - "RepositoryNameIdPairList":{ - "type":"list", - "member":{"shape":"RepositoryNameIdPair"} - }, - "RepositoryNameList":{ - "type":"list", - "member":{"shape":"RepositoryName"} - }, - "RepositoryNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A repository name is required but was not specified.

", - "exception":true - }, - "RepositoryNamesRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A repository names object is required but was not specified.

", - "exception":true - }, - "RepositoryNotAssociatedWithPullRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The repository does not contain any pull requests with that pull request ID. Check to make sure you have provided the correct repository name for the pull request.

", - "exception":true - }, - "RepositoryNotFoundList":{ - "type":"list", - "member":{"shape":"RepositoryName"} - }, - "RepositoryTrigger":{ - "type":"structure", - "required":[ - "name", - "destinationArn", - "events" - ], - "members":{ - "name":{ - "shape":"RepositoryTriggerName", - "documentation":"

The name of the trigger.

" - }, - "destinationArn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource that is the target for a trigger. For example, the ARN of a topic in Amazon Simple Notification Service (SNS).

" - }, - "customData":{ - "shape":"RepositoryTriggerCustomData", - "documentation":"

Any custom data associated with the trigger that will be included in the information sent to the target of the trigger.

" - }, - "branches":{ - "shape":"BranchNameList", - "documentation":"

The branches that will be included in the trigger configuration. If you specify an empty array, the trigger will apply to all branches.

While no content is required in the array, you must include the array itself.

" - }, - "events":{ - "shape":"RepositoryTriggerEventList", - "documentation":"

The repository events that will cause the trigger to run actions in another service, such as sending a notification through Amazon Simple Notification Service (SNS).

The valid value \"all\" cannot be used with any other values.

" - } - }, - "documentation":"

Information about a trigger for a repository.

" - }, - "RepositoryTriggerBranchNameListRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

At least one branch name is required but was not specified in the trigger configuration.

", - "exception":true - }, - "RepositoryTriggerCustomData":{"type":"string"}, - "RepositoryTriggerDestinationArnRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A destination ARN for the target service for the trigger is required but was not specified.

", - "exception":true - }, - "RepositoryTriggerEventEnum":{ - "type":"string", - "enum":[ - "all", - "updateReference", - "createReference", - "deleteReference" - ] - }, - "RepositoryTriggerEventList":{ - "type":"list", - "member":{"shape":"RepositoryTriggerEventEnum"} - }, - "RepositoryTriggerEventsListRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

At least one event for the trigger is required but was not specified.

", - "exception":true - }, - "RepositoryTriggerExecutionFailure":{ - "type":"structure", - "members":{ - "trigger":{ - "shape":"RepositoryTriggerName", - "documentation":"

The name of the trigger that did not run.

" - }, - "failureMessage":{ - "shape":"RepositoryTriggerExecutionFailureMessage", - "documentation":"

Additional message information about the trigger that did not run.

" - } - }, - "documentation":"

A trigger failed to run.

" - }, - "RepositoryTriggerExecutionFailureList":{ - "type":"list", - "member":{"shape":"RepositoryTriggerExecutionFailure"} - }, - "RepositoryTriggerExecutionFailureMessage":{"type":"string"}, - "RepositoryTriggerName":{"type":"string"}, - "RepositoryTriggerNameList":{ - "type":"list", - "member":{"shape":"RepositoryTriggerName"} - }, - "RepositoryTriggerNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A name for the trigger is required but was not specified.

", - "exception":true - }, - "RepositoryTriggersConfigurationId":{"type":"string"}, - "RepositoryTriggersList":{ - "type":"list", - "member":{"shape":"RepositoryTrigger"} - }, - "RepositoryTriggersListRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The list of triggers for the repository is required but was not specified.

", - "exception":true - }, - "SameFileContentException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file was not added or updated because the content of the file is exactly the same as the content of that file in the repository and branch that you specified.

", - "exception":true - }, - "SortByEnum":{ - "type":"string", - "enum":[ - "repositoryName", - "lastModifiedDate" - ] - }, - "SourceAndDestinationAreSameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The source branch and the destination branch for the pull request are the same. You must specify different branches for the source and destination.

", - "exception":true - }, - "Target":{ - "type":"structure", - "required":[ - "repositoryName", - "sourceReference" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that contains the pull request.

" - }, - "sourceReference":{ - "shape":"ReferenceName", - "documentation":"

The branch of the repository that contains the changes for the pull request. Also known as the source branch.

" - }, - "destinationReference":{ - "shape":"ReferenceName", - "documentation":"

The branch of the repository where the pull request changes will be merged into. Also known as the destination branch.

" - } - }, - "documentation":"

Returns information about a target for a pull request.

" - }, - "TargetList":{ - "type":"list", - "member":{"shape":"Target"} - }, - "TargetRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A pull request target is required. It cannot be empty or null. A pull request target must contain the full values for the repository name, source branch, and destination branch for the pull request.

", - "exception":true - }, - "TargetsRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An array of target objects is required. It cannot be empty or null.

", - "exception":true - }, - "TestRepositoryTriggersInput":{ - "type":"structure", - "required":[ - "repositoryName", - "triggers" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository in which to test the triggers.

" - }, - "triggers":{ - "shape":"RepositoryTriggersList", - "documentation":"

The list of triggers to test.

" - } - }, - "documentation":"

Represents the input of a test repository triggers operation.

" - }, - "TestRepositoryTriggersOutput":{ - "type":"structure", - "members":{ - "successfulExecutions":{ - "shape":"RepositoryTriggerNameList", - "documentation":"

The list of triggers that were successfully tested. This list provides the names of the triggers that were successfully tested, separated by commas.

" - }, - "failedExecutions":{ - "shape":"RepositoryTriggerExecutionFailureList", - "documentation":"

The list of triggers that were not able to be tested. This list provides the names of the triggers that could not be tested, separated by commas.

" - } - }, - "documentation":"

Represents the output of a test repository triggers operation.

" - }, - "TipOfSourceReferenceIsDifferentException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The tip of the source branch in the destination repository does not match the tip of the source branch specified in your request. The pull request might have been updated. Make sure that you have the latest changes.

", - "exception":true - }, - "TipsDivergenceExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The divergence between the tips of the provided commit specifiers is too great to determine whether there might be any merge conflicts. Locally compare the specifiers using git diff or a diff tool.

", - "exception":true - }, - "Title":{ - "type":"string", - "max":150 - }, - "TitleRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A pull request title is required. It cannot be empty or null.

", - "exception":true - }, - "UpdateCommentInput":{ - "type":"structure", - "required":[ - "commentId", - "content" - ], - "members":{ - "commentId":{ - "shape":"CommentId", - "documentation":"

The system-generated ID of the comment you want to update. To get this ID, use GetCommentsForComparedCommit or GetCommentsForPullRequest.

" - }, - "content":{ - "shape":"Content", - "documentation":"

The updated content with which you want to replace the existing content of the comment.

" - } - } - }, - "UpdateCommentOutput":{ - "type":"structure", - "members":{ - "comment":{ - "shape":"Comment", - "documentation":"

Information about the updated comment.

" - } - } - }, - "UpdateDefaultBranchInput":{ - "type":"structure", - "required":[ - "repositoryName", - "defaultBranchName" - ], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to set or change the default branch for.

" - }, - "defaultBranchName":{ - "shape":"BranchName", - "documentation":"

The name of the branch to set as the default.

" - } - }, - "documentation":"

Represents the input of an update default branch operation.

" - }, - "UpdatePullRequestDescriptionInput":{ - "type":"structure", - "required":[ - "pullRequestId", - "description" - ], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The updated content of the description for the pull request. This content will replace the existing description.

" - } - } - }, - "UpdatePullRequestDescriptionOutput":{ - "type":"structure", - "required":["pullRequest"], - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the updated pull request.

" - } - } - }, - "UpdatePullRequestStatusInput":{ - "type":"structure", - "required":[ - "pullRequestId", - "pullRequestStatus" - ], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "pullRequestStatus":{ - "shape":"PullRequestStatusEnum", - "documentation":"

The status of the pull request. The only valid operations are to update the status from OPEN to OPEN, OPEN to CLOSED or from from CLOSED to CLOSED.

" - } - } - }, - "UpdatePullRequestStatusOutput":{ - "type":"structure", - "required":["pullRequest"], - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the pull request.

" - } - } - }, - "UpdatePullRequestTitleInput":{ - "type":"structure", - "required":[ - "pullRequestId", - "title" - ], - "members":{ - "pullRequestId":{ - "shape":"PullRequestId", - "documentation":"

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

" - }, - "title":{ - "shape":"Title", - "documentation":"

The updated title of the pull request. This will replace the existing title.

" - } - } - }, - "UpdatePullRequestTitleOutput":{ - "type":"structure", - "required":["pullRequest"], - "members":{ - "pullRequest":{ - "shape":"PullRequest", - "documentation":"

Information about the updated pull request.

" - } - } - }, - "UpdateRepositoryDescriptionInput":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to set or change the comment or description for.

" - }, - "repositoryDescription":{ - "shape":"RepositoryDescription", - "documentation":"

The new comment or description for the specified repository. Repository descriptions are limited to 1,000 characters.

" - } - }, - "documentation":"

Represents the input of an update repository description operation.

" - }, - "UpdateRepositoryNameInput":{ - "type":"structure", - "required":[ - "oldName", - "newName" - ], - "members":{ - "oldName":{ - "shape":"RepositoryName", - "documentation":"

The existing name of the repository.

" - }, - "newName":{ - "shape":"RepositoryName", - "documentation":"

The new name for the repository.

" - } - }, - "documentation":"

Represents the input of an update repository description operation.

" - }, - "UserInfo":{ - "type":"structure", - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the user who made the specified commit.

" - }, - "email":{ - "shape":"Email", - "documentation":"

The email address associated with the user who made the commit, if any.

" - }, - "date":{ - "shape":"Date", - "documentation":"

The date when the specified commit was commited, in timestamp format with GMT offset.

" - } - }, - "documentation":"

Information about the user who made a specified commit.

" - }, - "blob":{"type":"blob"} - }, - "documentation":"AWS CodeCommit

This is the AWS CodeCommit API Reference. This reference provides descriptions of the operations and data types for AWS CodeCommit API along with usage examples.

You can use the AWS CodeCommit API to work with the following objects:

Repositories, by calling the following:

  • BatchGetRepositories, which returns information about one or more repositories associated with your AWS account.

  • CreateRepository, which creates an AWS CodeCommit repository.

  • DeleteRepository, which deletes an AWS CodeCommit repository.

  • GetRepository, which returns information about a specified repository.

  • ListRepositories, which lists all AWS CodeCommit repositories associated with your AWS account.

  • UpdateRepositoryDescription, which sets or updates the description of the repository.

  • UpdateRepositoryName, which changes the name of the repository. If you change the name of a repository, no other users of that repository will be able to access it until you send them the new HTTPS or SSH URL to use.

Branches, by calling the following:

  • CreateBranch, which creates a new branch in a specified repository.

  • DeleteBranch, which deletes the specified branch in a repository unless it is the default branch.

  • GetBranch, which returns information about a specified branch.

  • ListBranches, which lists all branches for a specified repository.

  • UpdateDefaultBranch, which changes the default branch for a repository.

Files, by calling the following:

  • PutFile, which adds or modifies a file in a specified repository and branch.

Information about committed code in a repository, by calling the following:

  • GetBlob, which returns the base-64 encoded content of an individual Git blob object within a repository.

  • GetCommit, which returns information about a commit, including commit messages and author and committer information.

  • GetDifferences, which returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference).

Pull requests, by calling the following:

Information about comments in a repository, by calling the following:

Triggers, by calling the following:

  • GetRepositoryTriggers, which returns information about triggers configured for a repository.

  • PutRepositoryTriggers, which replaces all triggers for a repository and can be used to create or delete triggers.

  • TestRepositoryTriggers, which tests the functionality of a repository trigger by sending data to the trigger target.

For information about how to use AWS CodeCommit, see the AWS CodeCommit User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/paginators-1.json deleted file mode 100644 index cea07e68..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/paginators-1.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "pagination": { - "ListApplicationRevisions": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "revisions" - }, - "ListApplications": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "applications" - }, - "ListDeploymentConfigs": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "deploymentConfigsList" - }, - "ListDeploymentGroups": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "deploymentGroups" - }, - "ListDeploymentInstances": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "instancesList" - }, - "ListDeployments": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "deployments" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/service-2.json deleted file mode 100644 index 04992201..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/service-2.json +++ /dev/null @@ -1,3905 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-10-06", - "endpointPrefix":"codedeploy", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CodeDeploy", - "serviceFullName":"AWS CodeDeploy", - "serviceId":"CodeDeploy", - "signatureVersion":"v4", - "targetPrefix":"CodeDeploy_20141006", - "timestampFormat":"unixTimestamp", - "uid":"codedeploy-2014-10-06" - }, - "operations":{ - "AddTagsToOnPremisesInstances":{ - "name":"AddTagsToOnPremisesInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToOnPremisesInstancesInput"}, - "errors":[ - {"shape":"InstanceNameRequiredException"}, - {"shape":"InvalidInstanceNameException"}, - {"shape":"TagRequiredException"}, - {"shape":"InvalidTagException"}, - {"shape":"TagLimitExceededException"}, - {"shape":"InstanceLimitExceededException"}, - {"shape":"InstanceNotRegisteredException"} - ], - "documentation":"

Adds tags to on-premises instances.

" - }, - "BatchGetApplicationRevisions":{ - "name":"BatchGetApplicationRevisions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetApplicationRevisionsInput"}, - "output":{"shape":"BatchGetApplicationRevisionsOutput"}, - "errors":[ - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"RevisionRequiredException"}, - {"shape":"InvalidRevisionException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more application revisions.

" - }, - "BatchGetApplications":{ - "name":"BatchGetApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetApplicationsInput"}, - "output":{"shape":"BatchGetApplicationsOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more applications.

" - }, - "BatchGetDeploymentGroups":{ - "name":"BatchGetDeploymentGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetDeploymentGroupsInput"}, - "output":{"shape":"BatchGetDeploymentGroupsOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more deployment groups.

" - }, - "BatchGetDeploymentInstances":{ - "name":"BatchGetDeploymentInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetDeploymentInstancesInput"}, - "output":{"shape":"BatchGetDeploymentInstancesOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"InstanceIdRequiredException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"InvalidInstanceNameException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more instance that are part of a deployment group.

" - }, - "BatchGetDeployments":{ - "name":"BatchGetDeployments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetDeploymentsInput"}, - "output":{"shape":"BatchGetDeploymentsOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more deployments.

" - }, - "BatchGetOnPremisesInstances":{ - "name":"BatchGetOnPremisesInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetOnPremisesInstancesInput"}, - "output":{"shape":"BatchGetOnPremisesInstancesOutput"}, - "errors":[ - {"shape":"InstanceNameRequiredException"}, - {"shape":"InvalidInstanceNameException"}, - {"shape":"BatchLimitExceededException"} - ], - "documentation":"

Gets information about one or more on-premises instances.

" - }, - "ContinueDeployment":{ - "name":"ContinueDeployment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ContinueDeploymentInput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"DeploymentAlreadyCompletedException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"DeploymentIsNotInReadyStateException"}, - {"shape":"UnsupportedActionForDeploymentTypeException"} - ], - "documentation":"

For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.)

" - }, - "CreateApplication":{ - "name":"CreateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationInput"}, - "output":{"shape":"CreateApplicationOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationAlreadyExistsException"}, - {"shape":"ApplicationLimitExceededException"}, - {"shape":"InvalidComputePlatformException"} - ], - "documentation":"

Creates an application.

" - }, - "CreateDeployment":{ - "name":"CreateDeployment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDeploymentInput"}, - "output":{"shape":"CreateDeploymentOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"DeploymentGroupDoesNotExistException"}, - {"shape":"RevisionRequiredException"}, - {"shape":"RevisionDoesNotExistException"}, - {"shape":"InvalidRevisionException"}, - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigDoesNotExistException"}, - {"shape":"DescriptionTooLongException"}, - {"shape":"DeploymentLimitExceededException"}, - {"shape":"InvalidTargetInstancesException"}, - {"shape":"InvalidAutoRollbackConfigException"}, - {"shape":"InvalidLoadBalancerInfoException"}, - {"shape":"InvalidFileExistsBehaviorException"}, - {"shape":"InvalidRoleException"}, - {"shape":"InvalidAutoScalingGroupException"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidUpdateOutdatedInstancesOnlyValueException"}, - {"shape":"InvalidIgnoreApplicationStopFailuresValueException"}, - {"shape":"InvalidGitHubAccountTokenException"} - ], - "documentation":"

Deploys an application revision through the specified deployment group.

" - }, - "CreateDeploymentConfig":{ - "name":"CreateDeploymentConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDeploymentConfigInput"}, - "output":{"shape":"CreateDeploymentConfigOutput"}, - "errors":[ - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigNameRequiredException"}, - {"shape":"DeploymentConfigAlreadyExistsException"}, - {"shape":"InvalidMinimumHealthyHostValueException"}, - {"shape":"DeploymentConfigLimitExceededException"}, - {"shape":"InvalidComputePlatformException"}, - {"shape":"InvalidTrafficRoutingConfigurationException"} - ], - "documentation":"

Creates a deployment configuration.

" - }, - "CreateDeploymentGroup":{ - "name":"CreateDeploymentGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDeploymentGroupInput"}, - "output":{"shape":"CreateDeploymentGroupOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"DeploymentGroupAlreadyExistsException"}, - {"shape":"InvalidEC2TagException"}, - {"shape":"InvalidTagException"}, - {"shape":"InvalidAutoScalingGroupException"}, - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigDoesNotExistException"}, - {"shape":"RoleRequiredException"}, - {"shape":"InvalidRoleException"}, - {"shape":"DeploymentGroupLimitExceededException"}, - {"shape":"LifecycleHookLimitExceededException"}, - {"shape":"InvalidTriggerConfigException"}, - {"shape":"TriggerTargetsLimitExceededException"}, - {"shape":"InvalidAlarmConfigException"}, - {"shape":"AlarmsLimitExceededException"}, - {"shape":"InvalidAutoRollbackConfigException"}, - {"shape":"InvalidLoadBalancerInfoException"}, - {"shape":"InvalidDeploymentStyleException"}, - {"shape":"InvalidBlueGreenDeploymentConfigurationException"}, - {"shape":"InvalidEC2TagCombinationException"}, - {"shape":"InvalidOnPremisesTagCombinationException"}, - {"shape":"TagSetListLimitExceededException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Creates a deployment group to which application revisions will be deployed.

" - }, - "DeleteApplication":{ - "name":"DeleteApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationInput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"} - ], - "documentation":"

Deletes an application.

" - }, - "DeleteDeploymentConfig":{ - "name":"DeleteDeploymentConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDeploymentConfigInput"}, - "errors":[ - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigNameRequiredException"}, - {"shape":"DeploymentConfigInUseException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Deletes a deployment configuration.

A deployment configuration cannot be deleted if it is currently in use. Predefined configurations cannot be deleted.

" - }, - "DeleteDeploymentGroup":{ - "name":"DeleteDeploymentGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDeploymentGroupInput"}, - "output":{"shape":"DeleteDeploymentGroupOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"InvalidRoleException"} - ], - "documentation":"

Deletes a deployment group.

" - }, - "DeleteGitHubAccountToken":{ - "name":"DeleteGitHubAccountToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGitHubAccountTokenInput"}, - "output":{"shape":"DeleteGitHubAccountTokenOutput"}, - "errors":[ - {"shape":"GitHubAccountTokenNameRequiredException"}, - {"shape":"GitHubAccountTokenDoesNotExistException"}, - {"shape":"InvalidGitHubAccountTokenNameException"}, - {"shape":"ResourceValidationException"}, - {"shape":"OperationNotSupportedException"} - ], - "documentation":"

Deletes a GitHub account connection.

" - }, - "DeregisterOnPremisesInstance":{ - "name":"DeregisterOnPremisesInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterOnPremisesInstanceInput"}, - "errors":[ - {"shape":"InstanceNameRequiredException"}, - {"shape":"InvalidInstanceNameException"} - ], - "documentation":"

Deregisters an on-premises instance.

" - }, - "GetApplication":{ - "name":"GetApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetApplicationInput"}, - "output":{"shape":"GetApplicationOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"} - ], - "documentation":"

Gets information about an application.

" - }, - "GetApplicationRevision":{ - "name":"GetApplicationRevision", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetApplicationRevisionInput"}, - "output":{"shape":"GetApplicationRevisionOutput"}, - "errors":[ - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"RevisionDoesNotExistException"}, - {"shape":"RevisionRequiredException"}, - {"shape":"InvalidRevisionException"} - ], - "documentation":"

Gets information about an application revision.

" - }, - "GetDeployment":{ - "name":"GetDeployment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeploymentInput"}, - "output":{"shape":"GetDeploymentOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"DeploymentDoesNotExistException"} - ], - "documentation":"

Gets information about a deployment.

" - }, - "GetDeploymentConfig":{ - "name":"GetDeploymentConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeploymentConfigInput"}, - "output":{"shape":"GetDeploymentConfigOutput"}, - "errors":[ - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigNameRequiredException"}, - {"shape":"DeploymentConfigDoesNotExistException"} - ], - "documentation":"

Gets information about a deployment configuration.

" - }, - "GetDeploymentGroup":{ - "name":"GetDeploymentGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeploymentGroupInput"}, - "output":{"shape":"GetDeploymentGroupOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"DeploymentGroupDoesNotExistException"} - ], - "documentation":"

Gets information about a deployment group.

" - }, - "GetDeploymentInstance":{ - "name":"GetDeploymentInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeploymentInstanceInput"}, - "output":{"shape":"GetDeploymentInstanceOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"InstanceIdRequiredException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"InstanceDoesNotExistException"}, - {"shape":"InvalidInstanceNameException"} - ], - "documentation":"

Gets information about an instance as part of a deployment.

" - }, - "GetOnPremisesInstance":{ - "name":"GetOnPremisesInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOnPremisesInstanceInput"}, - "output":{"shape":"GetOnPremisesInstanceOutput"}, - "errors":[ - {"shape":"InstanceNameRequiredException"}, - {"shape":"InstanceNotRegisteredException"}, - {"shape":"InvalidInstanceNameException"} - ], - "documentation":"

Gets information about an on-premises instance.

" - }, - "ListApplicationRevisions":{ - "name":"ListApplicationRevisions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListApplicationRevisionsInput"}, - "output":{"shape":"ListApplicationRevisionsOutput"}, - "errors":[ - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"InvalidSortByException"}, - {"shape":"InvalidSortOrderException"}, - {"shape":"InvalidBucketNameFilterException"}, - {"shape":"InvalidKeyPrefixFilterException"}, - {"shape":"BucketNameFilterRequiredException"}, - {"shape":"InvalidDeployedStateFilterException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists information about revisions for an application.

" - }, - "ListApplications":{ - "name":"ListApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListApplicationsInput"}, - "output":{"shape":"ListApplicationsOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the applications registered with the applicable IAM user or AWS account.

" - }, - "ListDeploymentConfigs":{ - "name":"ListDeploymentConfigs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeploymentConfigsInput"}, - "output":{"shape":"ListDeploymentConfigsOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the deployment configurations with the applicable IAM user or AWS account.

" - }, - "ListDeploymentGroups":{ - "name":"ListDeploymentGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeploymentGroupsInput"}, - "output":{"shape":"ListDeploymentGroupsOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the deployment groups for an application registered with the applicable IAM user or AWS account.

" - }, - "ListDeploymentInstances":{ - "name":"ListDeploymentInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeploymentInstancesInput"}, - "output":{"shape":"ListDeploymentInstancesOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"DeploymentNotStartedException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"InvalidInstanceStatusException"}, - {"shape":"InvalidInstanceTypeException"}, - {"shape":"InvalidDeploymentInstanceTypeException"} - ], - "documentation":"

Lists the instance for a deployment associated with the applicable IAM user or AWS account.

" - }, - "ListDeployments":{ - "name":"ListDeployments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeploymentsInput"}, - "output":{"shape":"ListDeploymentsOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"DeploymentGroupDoesNotExistException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"InvalidTimeRangeException"}, - {"shape":"InvalidDeploymentStatusException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS account.

" - }, - "ListGitHubAccountTokenNames":{ - "name":"ListGitHubAccountTokenNames", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGitHubAccountTokenNamesInput"}, - "output":{"shape":"ListGitHubAccountTokenNamesOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceValidationException"}, - {"shape":"OperationNotSupportedException"} - ], - "documentation":"

Lists the names of stored connections to GitHub accounts.

" - }, - "ListOnPremisesInstances":{ - "name":"ListOnPremisesInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOnPremisesInstancesInput"}, - "output":{"shape":"ListOnPremisesInstancesOutput"}, - "errors":[ - {"shape":"InvalidRegistrationStatusException"}, - {"shape":"InvalidTagFilterException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets a list of names for one or more on-premises instances.

Unless otherwise specified, both registered and deregistered on-premises instance names will be listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.

" - }, - "PutLifecycleEventHookExecutionStatus":{ - "name":"PutLifecycleEventHookExecutionStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutLifecycleEventHookExecutionStatusInput"}, - "output":{"shape":"PutLifecycleEventHookExecutionStatusOutput"}, - "errors":[ - {"shape":"InvalidLifecycleEventHookExecutionStatusException"}, - {"shape":"InvalidLifecycleEventHookExecutionIdException"}, - {"shape":"LifecycleEventAlreadyCompletedException"}, - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"UnsupportedActionForDeploymentTypeException"} - ], - "documentation":"

Sets the result of a Lambda validation function. The function validates one or both lifecycle events (BeforeAllowTraffic and AfterAllowTraffic) and returns Succeeded or Failed.

" - }, - "RegisterApplicationRevision":{ - "name":"RegisterApplicationRevision", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterApplicationRevisionInput"}, - "errors":[ - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"DescriptionTooLongException"}, - {"shape":"RevisionRequiredException"}, - {"shape":"InvalidRevisionException"} - ], - "documentation":"

Registers with AWS CodeDeploy a revision for the specified application.

" - }, - "RegisterOnPremisesInstance":{ - "name":"RegisterOnPremisesInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterOnPremisesInstanceInput"}, - "errors":[ - {"shape":"InstanceNameAlreadyRegisteredException"}, - {"shape":"IamArnRequiredException"}, - {"shape":"IamSessionArnAlreadyRegisteredException"}, - {"shape":"IamUserArnAlreadyRegisteredException"}, - {"shape":"InstanceNameRequiredException"}, - {"shape":"IamUserArnRequiredException"}, - {"shape":"InvalidInstanceNameException"}, - {"shape":"InvalidIamSessionArnException"}, - {"shape":"InvalidIamUserArnException"}, - {"shape":"MultipleIamArnsProvidedException"} - ], - "documentation":"

Registers an on-premises instance.

Only one IAM ARN (an IAM session ARN or IAM user ARN) is supported in the request. You cannot use both.

" - }, - "RemoveTagsFromOnPremisesInstances":{ - "name":"RemoveTagsFromOnPremisesInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromOnPremisesInstancesInput"}, - "errors":[ - {"shape":"InstanceNameRequiredException"}, - {"shape":"InvalidInstanceNameException"}, - {"shape":"TagRequiredException"}, - {"shape":"InvalidTagException"}, - {"shape":"TagLimitExceededException"}, - {"shape":"InstanceLimitExceededException"}, - {"shape":"InstanceNotRegisteredException"} - ], - "documentation":"

Removes one or more tags from one or more on-premises instances.

" - }, - "SkipWaitTimeForInstanceTermination":{ - "name":"SkipWaitTimeForInstanceTermination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SkipWaitTimeForInstanceTerminationInput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"DeploymentAlreadyCompletedException"}, - {"shape":"InvalidDeploymentIdException"}, - {"shape":"DeploymentNotStartedException"}, - {"shape":"UnsupportedActionForDeploymentTypeException"} - ], - "documentation":"

In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is completed.

" - }, - "StopDeployment":{ - "name":"StopDeployment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopDeploymentInput"}, - "output":{"shape":"StopDeploymentOutput"}, - "errors":[ - {"shape":"DeploymentIdRequiredException"}, - {"shape":"DeploymentDoesNotExistException"}, - {"shape":"DeploymentAlreadyCompletedException"}, - {"shape":"InvalidDeploymentIdException"} - ], - "documentation":"

Attempts to stop an ongoing deployment.

" - }, - "UpdateApplication":{ - "name":"UpdateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationInput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationAlreadyExistsException"}, - {"shape":"ApplicationDoesNotExistException"} - ], - "documentation":"

Changes the name of an application.

" - }, - "UpdateDeploymentGroup":{ - "name":"UpdateDeploymentGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDeploymentGroupInput"}, - "output":{"shape":"UpdateDeploymentGroupOutput"}, - "errors":[ - {"shape":"ApplicationNameRequiredException"}, - {"shape":"InvalidApplicationNameException"}, - {"shape":"ApplicationDoesNotExistException"}, - {"shape":"InvalidDeploymentGroupNameException"}, - {"shape":"DeploymentGroupAlreadyExistsException"}, - {"shape":"DeploymentGroupNameRequiredException"}, - {"shape":"DeploymentGroupDoesNotExistException"}, - {"shape":"InvalidEC2TagException"}, - {"shape":"InvalidTagException"}, - {"shape":"InvalidAutoScalingGroupException"}, - {"shape":"InvalidDeploymentConfigNameException"}, - {"shape":"DeploymentConfigDoesNotExistException"}, - {"shape":"InvalidRoleException"}, - {"shape":"LifecycleHookLimitExceededException"}, - {"shape":"InvalidTriggerConfigException"}, - {"shape":"TriggerTargetsLimitExceededException"}, - {"shape":"InvalidAlarmConfigException"}, - {"shape":"AlarmsLimitExceededException"}, - {"shape":"InvalidAutoRollbackConfigException"}, - {"shape":"InvalidLoadBalancerInfoException"}, - {"shape":"InvalidDeploymentStyleException"}, - {"shape":"InvalidBlueGreenDeploymentConfigurationException"}, - {"shape":"InvalidEC2TagCombinationException"}, - {"shape":"InvalidOnPremisesTagCombinationException"}, - {"shape":"TagSetListLimitExceededException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Changes information about a deployment group.

" - } - }, - "shapes":{ - "AddTagsToOnPremisesInstancesInput":{ - "type":"structure", - "required":[ - "tags", - "instanceNames" - ], - "members":{ - "tags":{ - "shape":"TagList", - "documentation":"

The tag key-value pairs to add to the on-premises instances.

Keys and values are both required. Keys cannot be null or empty strings. Value-only tags are not allowed.

" - }, - "instanceNames":{ - "shape":"InstanceNameList", - "documentation":"

The names of the on-premises instances to which to add tags.

" - } - }, - "documentation":"

Represents the input of, and adds tags to, an on-premises instance operation.

" - }, - "AdditionalDeploymentStatusInfo":{ - "type":"string", - "deprecated":true - }, - "Alarm":{ - "type":"structure", - "members":{ - "name":{ - "shape":"AlarmName", - "documentation":"

The name of the alarm. Maximum length is 255 characters. Each alarm name can be used only once in a list of alarms.

" - } - }, - "documentation":"

Information about an alarm.

" - }, - "AlarmConfiguration":{ - "type":"structure", - "members":{ - "enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the alarm configuration is enabled.

" - }, - "ignorePollAlarmFailure":{ - "shape":"Boolean", - "documentation":"

Indicates whether a deployment should continue if information about the current state of alarms cannot be retrieved from Amazon CloudWatch. The default value is false.

  • true: The deployment will proceed even if alarm status information can't be retrieved from Amazon CloudWatch.

  • false: The deployment will stop if alarm status information can't be retrieved from Amazon CloudWatch.

" - }, - "alarms":{ - "shape":"AlarmList", - "documentation":"

A list of alarms configured for the deployment group. A maximum of 10 alarms can be added to a deployment group.

" - } - }, - "documentation":"

Information about alarms associated with the deployment group.

" - }, - "AlarmList":{ - "type":"list", - "member":{"shape":"Alarm"} - }, - "AlarmName":{"type":"string"}, - "AlarmsLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum number of alarms for a deployment group (10) was exceeded.

", - "exception":true - }, - "ApplicationAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An application with the specified name already exists with the applicable IAM user or AWS account.

", - "exception":true - }, - "ApplicationDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The application does not exist with the applicable IAM user or AWS account.

", - "exception":true - }, - "ApplicationId":{"type":"string"}, - "ApplicationInfo":{ - "type":"structure", - "members":{ - "applicationId":{ - "shape":"ApplicationId", - "documentation":"

The application ID.

" - }, - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The application name.

" - }, - "createTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the application was created.

" - }, - "linkedToGitHub":{ - "shape":"Boolean", - "documentation":"

True if the user has authenticated with GitHub for the specified application; otherwise, false.

" - }, - "gitHubAccountName":{ - "shape":"GitHubAccountTokenName", - "documentation":"

The name for a connection to a GitHub account.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for deployment of the application (Lambda or Server).

" - } - }, - "documentation":"

Information about an application.

" - }, - "ApplicationLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

More applications were attempted to be created than are allowed.

", - "exception":true - }, - "ApplicationName":{ - "type":"string", - "max":100, - "min":1 - }, - "ApplicationNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The minimum number of required application names was not specified.

", - "exception":true - }, - "ApplicationRevisionSortBy":{ - "type":"string", - "enum":[ - "registerTime", - "firstUsedTime", - "lastUsedTime" - ] - }, - "ApplicationsInfoList":{ - "type":"list", - "member":{"shape":"ApplicationInfo"} - }, - "ApplicationsList":{ - "type":"list", - "member":{"shape":"ApplicationName"} - }, - "AutoRollbackConfiguration":{ - "type":"structure", - "members":{ - "enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether a defined automatic rollback configuration is currently enabled.

" - }, - "events":{ - "shape":"AutoRollbackEventsList", - "documentation":"

The event type or types that trigger a rollback.

" - } - }, - "documentation":"

Information about a configuration for automatically rolling back to a previous version of an application revision when a deployment doesn't complete successfully.

" - }, - "AutoRollbackEvent":{ - "type":"string", - "enum":[ - "DEPLOYMENT_FAILURE", - "DEPLOYMENT_STOP_ON_ALARM", - "DEPLOYMENT_STOP_ON_REQUEST" - ] - }, - "AutoRollbackEventsList":{ - "type":"list", - "member":{"shape":"AutoRollbackEvent"} - }, - "AutoScalingGroup":{ - "type":"structure", - "members":{ - "name":{ - "shape":"AutoScalingGroupName", - "documentation":"

The Auto Scaling group name.

" - }, - "hook":{ - "shape":"AutoScalingGroupHook", - "documentation":"

An Auto Scaling lifecycle event hook name.

" - } - }, - "documentation":"

Information about an Auto Scaling group.

" - }, - "AutoScalingGroupHook":{"type":"string"}, - "AutoScalingGroupList":{ - "type":"list", - "member":{"shape":"AutoScalingGroup"} - }, - "AutoScalingGroupName":{"type":"string"}, - "AutoScalingGroupNameList":{ - "type":"list", - "member":{"shape":"AutoScalingGroupName"} - }, - "BatchGetApplicationRevisionsInput":{ - "type":"structure", - "required":[ - "applicationName", - "revisions" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application about which to get revision information.

" - }, - "revisions":{ - "shape":"RevisionLocationList", - "documentation":"

Information to get about the application revisions, including type and location.

" - } - }, - "documentation":"

Represents the input of a BatchGetApplicationRevisions operation.

" - }, - "BatchGetApplicationRevisionsOutput":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application that corresponds to the revisions.

" - }, - "errorMessage":{ - "shape":"ErrorMessage", - "documentation":"

Information about errors that may have occurred during the API call.

" - }, - "revisions":{ - "shape":"RevisionInfoList", - "documentation":"

Additional information about the revisions, including the type and location.

" - } - }, - "documentation":"

Represents the output of a BatchGetApplicationRevisions operation.

" - }, - "BatchGetApplicationsInput":{ - "type":"structure", - "required":["applicationNames"], - "members":{ - "applicationNames":{ - "shape":"ApplicationsList", - "documentation":"

A list of application names separated by spaces.

" - } - }, - "documentation":"

Represents the input of a BatchGetApplications operation.

" - }, - "BatchGetApplicationsOutput":{ - "type":"structure", - "members":{ - "applicationsInfo":{ - "shape":"ApplicationsInfoList", - "documentation":"

Information about the applications.

" - } - }, - "documentation":"

Represents the output of a BatchGetApplications operation.

" - }, - "BatchGetDeploymentGroupsInput":{ - "type":"structure", - "required":[ - "applicationName", - "deploymentGroupNames" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupNames":{ - "shape":"DeploymentGroupsList", - "documentation":"

The deployment groups' names.

" - } - }, - "documentation":"

Represents the input of a BatchGetDeploymentGroups operation.

" - }, - "BatchGetDeploymentGroupsOutput":{ - "type":"structure", - "members":{ - "deploymentGroupsInfo":{ - "shape":"DeploymentGroupInfoList", - "documentation":"

Information about the deployment groups.

" - }, - "errorMessage":{ - "shape":"ErrorMessage", - "documentation":"

Information about errors that may have occurred during the API call.

" - } - }, - "documentation":"

Represents the output of a BatchGetDeploymentGroups operation.

" - }, - "BatchGetDeploymentInstancesInput":{ - "type":"structure", - "required":[ - "deploymentId", - "instanceIds" - ], - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The unique ID of a deployment.

" - }, - "instanceIds":{ - "shape":"InstancesList", - "documentation":"

The unique IDs of instances in the deployment group.

" - } - }, - "documentation":"

Represents the input of a BatchGetDeploymentInstances operation.

" - }, - "BatchGetDeploymentInstancesOutput":{ - "type":"structure", - "members":{ - "instancesSummary":{ - "shape":"InstanceSummaryList", - "documentation":"

Information about the instance.

" - }, - "errorMessage":{ - "shape":"ErrorMessage", - "documentation":"

Information about errors that may have occurred during the API call.

" - } - }, - "documentation":"

Represents the output of a BatchGetDeploymentInstances operation.

" - }, - "BatchGetDeploymentsInput":{ - "type":"structure", - "required":["deploymentIds"], - "members":{ - "deploymentIds":{ - "shape":"DeploymentsList", - "documentation":"

A list of deployment IDs, separated by spaces.

" - } - }, - "documentation":"

Represents the input of a BatchGetDeployments operation.

" - }, - "BatchGetDeploymentsOutput":{ - "type":"structure", - "members":{ - "deploymentsInfo":{ - "shape":"DeploymentsInfoList", - "documentation":"

Information about the deployments.

" - } - }, - "documentation":"

Represents the output of a BatchGetDeployments operation.

" - }, - "BatchGetOnPremisesInstancesInput":{ - "type":"structure", - "required":["instanceNames"], - "members":{ - "instanceNames":{ - "shape":"InstanceNameList", - "documentation":"

The names of the on-premises instances about which to get information.

" - } - }, - "documentation":"

Represents the input of a BatchGetOnPremisesInstances operation.

" - }, - "BatchGetOnPremisesInstancesOutput":{ - "type":"structure", - "members":{ - "instanceInfos":{ - "shape":"InstanceInfoList", - "documentation":"

Information about the on-premises instances.

" - } - }, - "documentation":"

Represents the output of a BatchGetOnPremisesInstances operation.

" - }, - "BatchLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum number of names or IDs allowed for this request (100) was exceeded.

", - "exception":true - }, - "BlueGreenDeploymentConfiguration":{ - "type":"structure", - "members":{ - "terminateBlueInstancesOnDeploymentSuccess":{ - "shape":"BlueInstanceTerminationOption", - "documentation":"

Information about whether to terminate instances in the original fleet during a blue/green deployment.

" - }, - "deploymentReadyOption":{ - "shape":"DeploymentReadyOption", - "documentation":"

Information about the action to take when newly provisioned instances are ready to receive traffic in a blue/green deployment.

" - }, - "greenFleetProvisioningOption":{ - "shape":"GreenFleetProvisioningOption", - "documentation":"

Information about how instances are provisioned for a replacement environment in a blue/green deployment.

" - } - }, - "documentation":"

Information about blue/green deployment options for a deployment group.

" - }, - "BlueInstanceTerminationOption":{ - "type":"structure", - "members":{ - "action":{ - "shape":"InstanceAction", - "documentation":"

The action to take on instances in the original environment after a successful blue/green deployment.

  • TERMINATE: Instances are terminated after a specified wait time.

  • KEEP_ALIVE: Instances are left running after they are deregistered from the load balancer and removed from the deployment group.

" - }, - "terminationWaitTimeInMinutes":{ - "shape":"Duration", - "documentation":"

The number of minutes to wait after a successful blue/green deployment before terminating instances from the original environment. The maximum setting is 2880 minutes (2 days).

" - } - }, - "documentation":"

Information about whether instances in the original environment are terminated when a blue/green deployment is successful.

" - }, - "Boolean":{"type":"boolean"}, - "BucketNameFilterRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A bucket name is required, but was not provided.

", - "exception":true - }, - "BundleType":{ - "type":"string", - "enum":[ - "tar", - "tgz", - "zip", - "YAML", - "JSON" - ] - }, - "CommitId":{"type":"string"}, - "ComputePlatform":{ - "type":"string", - "enum":[ - "Server", - "Lambda" - ] - }, - "ContinueDeploymentInput":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The deployment ID of the blue/green deployment for which you want to start rerouting traffic to the replacement environment.

" - } - } - }, - "CreateApplicationInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application. This name must be unique with the applicable IAM user or AWS account.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for the deployment (Lambda or Server).

" - } - }, - "documentation":"

Represents the input of a CreateApplication operation.

" - }, - "CreateApplicationOutput":{ - "type":"structure", - "members":{ - "applicationId":{ - "shape":"ApplicationId", - "documentation":"

A unique application ID.

" - } - }, - "documentation":"

Represents the output of a CreateApplication operation.

" - }, - "CreateDeploymentConfigInput":{ - "type":"structure", - "required":["deploymentConfigName"], - "members":{ - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The name of the deployment configuration to create.

" - }, - "minimumHealthyHosts":{ - "shape":"MinimumHealthyHosts", - "documentation":"

The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.

The type parameter takes either of the following values:

  • HOST_COUNT: The value parameter represents the minimum number of healthy instances as an absolute value.

  • FLEET_PERCENT: The value parameter represents the minimum number of healthy instances as a percentage of the total number of instances in the deployment. If you specify FLEET_PERCENT, at the start of the deployment, AWS CodeDeploy converts the percentage to the equivalent number of instance and rounds up fractional instances.

The value parameter takes an integer.

For example, to set a minimum of 95% healthy instance, specify a type of FLEET_PERCENT and a value of 95.

" - }, - "trafficRoutingConfig":{ - "shape":"TrafficRoutingConfig", - "documentation":"

The configuration that specifies how the deployment traffic will be routed.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for the deployment (Lambda or Server>).

" - } - }, - "documentation":"

Represents the input of a CreateDeploymentConfig operation.

" - }, - "CreateDeploymentConfigOutput":{ - "type":"structure", - "members":{ - "deploymentConfigId":{ - "shape":"DeploymentConfigId", - "documentation":"

A unique deployment configuration ID.

" - } - }, - "documentation":"

Represents the output of a CreateDeploymentConfig operation.

" - }, - "CreateDeploymentGroupInput":{ - "type":"structure", - "required":[ - "applicationName", - "deploymentGroupName", - "serviceRoleArn" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The name of a new deployment group for the specified application.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.

CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.

For more information about the predefined deployment configurations in AWS CodeDeploy, see Working with Deployment Groups in AWS CodeDeploy in the AWS CodeDeploy User Guide.

" - }, - "ec2TagFilters":{ - "shape":"EC2TagFilterList", - "documentation":"

The Amazon EC2 tags on which to filter. The deployment group will include EC2 instances with any of the specified tags. Cannot be used in the same call as ec2TagSet.

" - }, - "onPremisesInstanceTagFilters":{ - "shape":"TagFilterList", - "documentation":"

The on-premises instance tags on which to filter. The deployment group will include on-premises instances with any of the specified tags. Cannot be used in the same call as OnPremisesTagSet.

" - }, - "autoScalingGroups":{ - "shape":"AutoScalingGroupNameList", - "documentation":"

A list of associated Auto Scaling groups.

" - }, - "serviceRoleArn":{ - "shape":"Role", - "documentation":"

A service role ARN that allows AWS CodeDeploy to act on the user's behalf when interacting with AWS services.

" - }, - "triggerConfigurations":{ - "shape":"TriggerConfigList", - "documentation":"

Information about triggers to create when the deployment group is created. For examples, see Create a Trigger for an AWS CodeDeploy Event in the AWS CodeDeploy User Guide.

" - }, - "alarmConfiguration":{ - "shape":"AlarmConfiguration", - "documentation":"

Information to add about Amazon CloudWatch alarms when the deployment group is created.

" - }, - "autoRollbackConfiguration":{ - "shape":"AutoRollbackConfiguration", - "documentation":"

Configuration information for an automatic rollback that is added when a deployment group is created.

" - }, - "deploymentStyle":{ - "shape":"DeploymentStyle", - "documentation":"

Information about the type of deployment, in-place or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.

" - }, - "blueGreenDeploymentConfiguration":{ - "shape":"BlueGreenDeploymentConfiguration", - "documentation":"

Information about blue/green deployment options for a deployment group.

" - }, - "loadBalancerInfo":{ - "shape":"LoadBalancerInfo", - "documentation":"

Information about the load balancer used in a deployment.

" - }, - "ec2TagSet":{ - "shape":"EC2TagSet", - "documentation":"

Information about groups of tags applied to EC2 instances. The deployment group will include only EC2 instances identified by all the tag groups. Cannot be used in the same call as ec2TagFilters.

" - }, - "onPremisesTagSet":{ - "shape":"OnPremisesTagSet", - "documentation":"

Information about groups of tags applied to on-premises instances. The deployment group will include only on-premises instances identified by all the tag groups. Cannot be used in the same call as onPremisesInstanceTagFilters.

" - } - }, - "documentation":"

Represents the input of a CreateDeploymentGroup operation.

" - }, - "CreateDeploymentGroupOutput":{ - "type":"structure", - "members":{ - "deploymentGroupId":{ - "shape":"DeploymentGroupId", - "documentation":"

A unique deployment group ID.

" - } - }, - "documentation":"

Represents the output of a CreateDeploymentGroup operation.

" - }, - "CreateDeploymentInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The name of the deployment group.

" - }, - "revision":{ - "shape":"RevisionLocation", - "documentation":"

The type and location of the revision to deploy.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The name of a deployment configuration associated with the applicable IAM user or AWS account.

If not specified, the value configured in the deployment group will be used as the default. If the deployment group does not have a deployment configuration associated with it, then CodeDeployDefault.OneAtATime will be used by default.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A comment about the deployment.

" - }, - "ignoreApplicationStopFailures":{ - "shape":"Boolean", - "documentation":"

If set to true, then if the deployment causes the ApplicationStop deployment lifecycle event to an instance to fail, the deployment to that instance will not be considered to have failed at that point and will continue on to the BeforeInstall deployment lifecycle event.

If set to false or not specified, then if the deployment causes the ApplicationStop deployment lifecycle event to fail to an instance, the deployment to that instance will stop, and the deployment to that instance will be considered to have failed.

" - }, - "targetInstances":{ - "shape":"TargetInstances", - "documentation":"

Information about the instances that will belong to the replacement environment in a blue/green deployment.

" - }, - "autoRollbackConfiguration":{ - "shape":"AutoRollbackConfiguration", - "documentation":"

Configuration information for an automatic rollback that is added when a deployment is created.

" - }, - "updateOutdatedInstancesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether to deploy to all instances or only to instances that are not running the latest application revision.

" - }, - "fileExistsBehavior":{ - "shape":"FileExistsBehavior", - "documentation":"

Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

The fileExistsBehavior parameter takes any of the following values:

  • DISALLOW: The deployment fails. This is also the default behavior if no option is specified.

  • OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.

  • RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.

" - } - }, - "documentation":"

Represents the input of a CreateDeployment operation.

" - }, - "CreateDeploymentOutput":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

A unique deployment ID.

" - } - }, - "documentation":"

Represents the output of a CreateDeployment operation.

" - }, - "DeleteApplicationInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - } - }, - "documentation":"

Represents the input of a DeleteApplication operation.

" - }, - "DeleteDeploymentConfigInput":{ - "type":"structure", - "required":["deploymentConfigName"], - "members":{ - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The name of a deployment configuration associated with the applicable IAM user or AWS account.

" - } - }, - "documentation":"

Represents the input of a DeleteDeploymentConfig operation.

" - }, - "DeleteDeploymentGroupInput":{ - "type":"structure", - "required":[ - "applicationName", - "deploymentGroupName" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The name of an existing deployment group for the specified application.

" - } - }, - "documentation":"

Represents the input of a DeleteDeploymentGroup operation.

" - }, - "DeleteDeploymentGroupOutput":{ - "type":"structure", - "members":{ - "hooksNotCleanedUp":{ - "shape":"AutoScalingGroupList", - "documentation":"

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, AWS CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group. If the output contains data, AWS CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the Amazon EC2 instances in the Auto Scaling group.

" - } - }, - "documentation":"

Represents the output of a DeleteDeploymentGroup operation.

" - }, - "DeleteGitHubAccountTokenInput":{ - "type":"structure", - "members":{ - "tokenName":{ - "shape":"GitHubAccountTokenName", - "documentation":"

The name of the GitHub account connection to delete.

" - } - }, - "documentation":"

Represents the input of a DeleteGitHubAccount operation.

" - }, - "DeleteGitHubAccountTokenOutput":{ - "type":"structure", - "members":{ - "tokenName":{ - "shape":"GitHubAccountTokenName", - "documentation":"

The name of the GitHub account connection that was deleted.

" - } - }, - "documentation":"

Represents the output of a DeleteGitHubAccountToken operation.

" - }, - "DeploymentAlreadyCompletedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment is already complete.

", - "exception":true - }, - "DeploymentConfigAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A deployment configuration with the specified name already exists with the applicable IAM user or AWS account.

", - "exception":true - }, - "DeploymentConfigDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment configuration does not exist with the applicable IAM user or AWS account.

", - "exception":true - }, - "DeploymentConfigId":{"type":"string"}, - "DeploymentConfigInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment configuration is still in use.

", - "exception":true - }, - "DeploymentConfigInfo":{ - "type":"structure", - "members":{ - "deploymentConfigId":{ - "shape":"DeploymentConfigId", - "documentation":"

The deployment configuration ID.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The deployment configuration name.

" - }, - "minimumHealthyHosts":{ - "shape":"MinimumHealthyHosts", - "documentation":"

Information about the number or percentage of minimum healthy instance.

" - }, - "createTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the deployment configuration was created.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for the deployment (Lambda or Server).

" - }, - "trafficRoutingConfig":{ - "shape":"TrafficRoutingConfig", - "documentation":"

The configuration specifying how the deployment traffic will be routed. Only deployments with a Lambda compute platform can specify this.

" - } - }, - "documentation":"

Information about a deployment configuration.

" - }, - "DeploymentConfigLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment configurations limit was exceeded.

", - "exception":true - }, - "DeploymentConfigName":{ - "type":"string", - "max":100, - "min":1 - }, - "DeploymentConfigNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment configuration name was not specified.

", - "exception":true - }, - "DeploymentConfigsList":{ - "type":"list", - "member":{"shape":"DeploymentConfigName"} - }, - "DeploymentCreator":{ - "type":"string", - "enum":[ - "user", - "autoscaling", - "codeDeployRollback" - ] - }, - "DeploymentDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment does not exist with the applicable IAM user or AWS account.

", - "exception":true - }, - "DeploymentGroupAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A deployment group with the specified name already exists with the applicable IAM user or AWS account.

", - "exception":true - }, - "DeploymentGroupDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The named deployment group does not exist with the applicable IAM user or AWS account.

", - "exception":true - }, - "DeploymentGroupId":{"type":"string"}, - "DeploymentGroupInfo":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The application name.

" - }, - "deploymentGroupId":{ - "shape":"DeploymentGroupId", - "documentation":"

The deployment group ID.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The deployment group name.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The deployment configuration name.

" - }, - "ec2TagFilters":{ - "shape":"EC2TagFilterList", - "documentation":"

The Amazon EC2 tags on which to filter. The deployment group includes EC2 instances with any of the specified tags.

" - }, - "onPremisesInstanceTagFilters":{ - "shape":"TagFilterList", - "documentation":"

The on-premises instance tags on which to filter. The deployment group includes on-premises instances with any of the specified tags.

" - }, - "autoScalingGroups":{ - "shape":"AutoScalingGroupList", - "documentation":"

A list of associated Auto Scaling groups.

" - }, - "serviceRoleArn":{ - "shape":"Role", - "documentation":"

A service role ARN.

" - }, - "targetRevision":{ - "shape":"RevisionLocation", - "documentation":"

Information about the deployment group's target revision, including type and location.

" - }, - "triggerConfigurations":{ - "shape":"TriggerConfigList", - "documentation":"

Information about triggers associated with the deployment group.

" - }, - "alarmConfiguration":{ - "shape":"AlarmConfiguration", - "documentation":"

A list of alarms associated with the deployment group.

" - }, - "autoRollbackConfiguration":{ - "shape":"AutoRollbackConfiguration", - "documentation":"

Information about the automatic rollback configuration associated with the deployment group.

" - }, - "deploymentStyle":{ - "shape":"DeploymentStyle", - "documentation":"

Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.

" - }, - "blueGreenDeploymentConfiguration":{ - "shape":"BlueGreenDeploymentConfiguration", - "documentation":"

Information about blue/green deployment options for a deployment group.

" - }, - "loadBalancerInfo":{ - "shape":"LoadBalancerInfo", - "documentation":"

Information about the load balancer to use in a deployment.

" - }, - "lastSuccessfulDeployment":{ - "shape":"LastDeploymentInfo", - "documentation":"

Information about the most recent successful deployment to the deployment group.

" - }, - "lastAttemptedDeployment":{ - "shape":"LastDeploymentInfo", - "documentation":"

Information about the most recent attempted deployment to the deployment group.

" - }, - "ec2TagSet":{ - "shape":"EC2TagSet", - "documentation":"

Information about groups of tags applied to an EC2 instance. The deployment group includes only EC2 instances identified by all the tag groups. Cannot be used in the same call as ec2TagFilters.

" - }, - "onPremisesTagSet":{ - "shape":"OnPremisesTagSet", - "documentation":"

Information about groups of tags applied to an on-premises instance. The deployment group includes only on-premises instances identified by all the tag groups. Cannot be used in the same call as onPremisesInstanceTagFilters.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for the deployment group (Lambda or Server).

" - } - }, - "documentation":"

Information about a deployment group.

" - }, - "DeploymentGroupInfoList":{ - "type":"list", - "member":{"shape":"DeploymentGroupInfo"} - }, - "DeploymentGroupLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment groups limit was exceeded.

", - "exception":true - }, - "DeploymentGroupName":{ - "type":"string", - "max":100, - "min":1 - }, - "DeploymentGroupNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment group name was not specified.

", - "exception":true - }, - "DeploymentGroupsList":{ - "type":"list", - "member":{"shape":"DeploymentGroupName"} - }, - "DeploymentId":{"type":"string"}, - "DeploymentIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

At least one deployment ID must be specified.

", - "exception":true - }, - "DeploymentInfo":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The application name.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The deployment group name.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The deployment configuration name.

" - }, - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The deployment ID.

" - }, - "previousRevision":{ - "shape":"RevisionLocation", - "documentation":"

Information about the application revision that was deployed to the deployment group before the most recent successful deployment.

" - }, - "revision":{ - "shape":"RevisionLocation", - "documentation":"

Information about the location of stored application artifacts and the service from which to retrieve them.

" - }, - "status":{ - "shape":"DeploymentStatus", - "documentation":"

The current state of the deployment as a whole.

" - }, - "errorInformation":{ - "shape":"ErrorInformation", - "documentation":"

Information about any error associated with this deployment.

" - }, - "createTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the deployment was created.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the deployment was deployed to the deployment group.

In some cases, the reported value of the start time may be later than the complete time. This is due to differences in the clock settings of back-end servers that participate in the deployment process.

" - }, - "completeTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the deployment was complete.

" - }, - "deploymentOverview":{ - "shape":"DeploymentOverview", - "documentation":"

A summary of the deployment status of the instances in the deployment.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A comment about the deployment.

" - }, - "creator":{ - "shape":"DeploymentCreator", - "documentation":"

The means by which the deployment was created:

  • user: A user created the deployment.

  • autoscaling: Auto Scaling created the deployment.

  • codeDeployRollback: A rollback process created the deployment.

" - }, - "ignoreApplicationStopFailures":{ - "shape":"Boolean", - "documentation":"

If true, then if the deployment causes the ApplicationStop deployment lifecycle event to an instance to fail, the deployment to that instance will not be considered to have failed at that point and will continue on to the BeforeInstall deployment lifecycle event.

If false or not specified, then if the deployment causes the ApplicationStop deployment lifecycle event to an instance to fail, the deployment to that instance will stop, and the deployment to that instance will be considered to have failed.

" - }, - "autoRollbackConfiguration":{ - "shape":"AutoRollbackConfiguration", - "documentation":"

Information about the automatic rollback configuration associated with the deployment.

" - }, - "updateOutdatedInstancesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether only instances that are not running the latest application revision are to be deployed to.

" - }, - "rollbackInfo":{ - "shape":"RollbackInfo", - "documentation":"

Information about a deployment rollback.

" - }, - "deploymentStyle":{ - "shape":"DeploymentStyle", - "documentation":"

Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.

" - }, - "targetInstances":{ - "shape":"TargetInstances", - "documentation":"

Information about the instances that belong to the replacement environment in a blue/green deployment.

" - }, - "instanceTerminationWaitTimeStarted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the wait period set for the termination of instances in the original environment has started. Status is 'false' if the KEEP_ALIVE option is specified; otherwise, 'true' as soon as the termination wait period starts.

" - }, - "blueGreenDeploymentConfiguration":{ - "shape":"BlueGreenDeploymentConfiguration", - "documentation":"

Information about blue/green deployment options for this deployment.

" - }, - "loadBalancerInfo":{ - "shape":"LoadBalancerInfo", - "documentation":"

Information about the load balancer used in the deployment.

" - }, - "additionalDeploymentStatusInfo":{ - "shape":"AdditionalDeploymentStatusInfo", - "documentation":"

Provides information about the results of a deployment, such as whether instances in the original environment in a blue/green deployment were not terminated.

" - }, - "fileExistsBehavior":{ - "shape":"FileExistsBehavior", - "documentation":"

Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

  • DISALLOW: The deployment fails. This is also the default behavior if no option is specified.

  • OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.

  • RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.

" - }, - "deploymentStatusMessages":{ - "shape":"DeploymentStatusMessageList", - "documentation":"

Messages that contain information about the status of a deployment.

" - }, - "computePlatform":{ - "shape":"ComputePlatform", - "documentation":"

The destination platform type for the deployment (Lambda or Server).

" - } - }, - "documentation":"

Information about a deployment.

" - }, - "DeploymentIsNotInReadyStateException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment does not have a status of Ready and can't continue yet.

", - "exception":true - }, - "DeploymentLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of allowed deployments was exceeded.

", - "exception":true - }, - "DeploymentNotStartedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified deployment has not started.

", - "exception":true - }, - "DeploymentOption":{ - "type":"string", - "enum":[ - "WITH_TRAFFIC_CONTROL", - "WITHOUT_TRAFFIC_CONTROL" - ] - }, - "DeploymentOverview":{ - "type":"structure", - "members":{ - "Pending":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in the deployment in a pending state.

" - }, - "InProgress":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in which the deployment is in progress.

" - }, - "Succeeded":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in the deployment to which revisions have been successfully deployed.

" - }, - "Failed":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in the deployment in a failed state.

" - }, - "Skipped":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in the deployment in a skipped state.

" - }, - "Ready":{ - "shape":"InstanceCount", - "documentation":"

The number of instances in a replacement environment ready to receive traffic in a blue/green deployment.

" - } - }, - "documentation":"

Information about the deployment status of the instances in the deployment.

" - }, - "DeploymentReadyAction":{ - "type":"string", - "enum":[ - "CONTINUE_DEPLOYMENT", - "STOP_DEPLOYMENT" - ] - }, - "DeploymentReadyOption":{ - "type":"structure", - "members":{ - "actionOnTimeout":{ - "shape":"DeploymentReadyAction", - "documentation":"

Information about when to reroute traffic from an original environment to a replacement environment in a blue/green deployment.

  • CONTINUE_DEPLOYMENT: Register new instances with the load balancer immediately after the new application revision is installed on the instances in the replacement environment.

  • STOP_DEPLOYMENT: Do not register new instances with a load balancer unless traffic rerouting is started using ContinueDeployment. If traffic rerouting is not started before the end of the specified wait period, the deployment status is changed to Stopped.

" - }, - "waitTimeInMinutes":{ - "shape":"Duration", - "documentation":"

The number of minutes to wait before the status of a blue/green deployment changed to Stopped if rerouting is not started manually. Applies only to the STOP_DEPLOYMENT option for actionOnTimeout

" - } - }, - "documentation":"

Information about how traffic is rerouted to instances in a replacement environment in a blue/green deployment.

" - }, - "DeploymentStatus":{ - "type":"string", - "enum":[ - "Created", - "Queued", - "InProgress", - "Succeeded", - "Failed", - "Stopped", - "Ready" - ] - }, - "DeploymentStatusList":{ - "type":"list", - "member":{"shape":"DeploymentStatus"} - }, - "DeploymentStatusMessageList":{ - "type":"list", - "member":{"shape":"ErrorMessage"} - }, - "DeploymentStyle":{ - "type":"structure", - "members":{ - "deploymentType":{ - "shape":"DeploymentType", - "documentation":"

Indicates whether to run an in-place deployment or a blue/green deployment.

" - }, - "deploymentOption":{ - "shape":"DeploymentOption", - "documentation":"

Indicates whether to route deployment traffic behind a load balancer.

" - } - }, - "documentation":"

Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.

" - }, - "DeploymentType":{ - "type":"string", - "enum":[ - "IN_PLACE", - "BLUE_GREEN" - ] - }, - "DeploymentsInfoList":{ - "type":"list", - "member":{"shape":"DeploymentInfo"} - }, - "DeploymentsList":{ - "type":"list", - "member":{"shape":"DeploymentId"} - }, - "DeregisterOnPremisesInstanceInput":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"InstanceName", - "documentation":"

The name of the on-premises instance to deregister.

" - } - }, - "documentation":"

Represents the input of a DeregisterOnPremisesInstance operation.

" - }, - "Description":{"type":"string"}, - "DescriptionTooLongException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The description is too long.

", - "exception":true - }, - "Diagnostics":{ - "type":"structure", - "members":{ - "errorCode":{ - "shape":"LifecycleErrorCode", - "documentation":"

The associated error code:

  • Success: The specified script ran.

  • ScriptMissing: The specified script was not found in the specified location.

  • ScriptNotExecutable: The specified script is not a recognized executable file type.

  • ScriptTimedOut: The specified script did not finish running in the specified time period.

  • ScriptFailed: The specified script failed to run as expected.

  • UnknownError: The specified script did not run for an unknown reason.

" - }, - "scriptName":{ - "shape":"ScriptName", - "documentation":"

The name of the script.

" - }, - "message":{ - "shape":"LifecycleMessage", - "documentation":"

The message associated with the error.

" - }, - "logTail":{ - "shape":"LogTail", - "documentation":"

The last portion of the diagnostic log.

If available, AWS CodeDeploy returns up to the last 4 KB of the diagnostic log.

" - } - }, - "documentation":"

Diagnostic information about executable scripts that are part of a deployment.

" - }, - "Duration":{"type":"integer"}, - "EC2TagFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"Key", - "documentation":"

The tag filter key.

" - }, - "Value":{ - "shape":"Value", - "documentation":"

The tag filter value.

" - }, - "Type":{ - "shape":"EC2TagFilterType", - "documentation":"

The tag filter type:

  • KEY_ONLY: Key only.

  • VALUE_ONLY: Value only.

  • KEY_AND_VALUE: Key and value.

" - } - }, - "documentation":"

Information about an EC2 tag filter.

" - }, - "EC2TagFilterList":{ - "type":"list", - "member":{"shape":"EC2TagFilter"} - }, - "EC2TagFilterType":{ - "type":"string", - "enum":[ - "KEY_ONLY", - "VALUE_ONLY", - "KEY_AND_VALUE" - ] - }, - "EC2TagSet":{ - "type":"structure", - "members":{ - "ec2TagSetList":{ - "shape":"EC2TagSetList", - "documentation":"

A list containing other lists of EC2 instance tag groups. In order for an instance to be included in the deployment group, it must be identified by all the tag groups in the list.

" - } - }, - "documentation":"

Information about groups of EC2 instance tags.

" - }, - "EC2TagSetList":{ - "type":"list", - "member":{"shape":"EC2TagFilterList"} - }, - "ELBInfo":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ELBName", - "documentation":"

For blue/green deployments, the name of the load balancer that will be used to route traffic from original instances to replacement instances in a blue/green deployment. For in-place deployments, the name of the load balancer that instances are deregistered from so they are not serving traffic during a deployment, and then re-registered with after the deployment completes.

" - } - }, - "documentation":"

Information about a load balancer in Elastic Load Balancing to use in a deployment. Instances are registered directly with a load balancer, and traffic is routed to the load balancer.

" - }, - "ELBInfoList":{ - "type":"list", - "member":{"shape":"ELBInfo"} - }, - "ELBName":{"type":"string"}, - "ETag":{"type":"string"}, - "ErrorCode":{ - "type":"string", - "enum":[ - "DEPLOYMENT_GROUP_MISSING", - "APPLICATION_MISSING", - "REVISION_MISSING", - "IAM_ROLE_MISSING", - "IAM_ROLE_PERMISSIONS", - "NO_EC2_SUBSCRIPTION", - "OVER_MAX_INSTANCES", - "NO_INSTANCES", - "TIMEOUT", - "HEALTH_CONSTRAINTS_INVALID", - "HEALTH_CONSTRAINTS", - "INTERNAL_ERROR", - "THROTTLED", - "ALARM_ACTIVE", - "AGENT_ISSUE", - "AUTO_SCALING_IAM_ROLE_PERMISSIONS", - "AUTO_SCALING_CONFIGURATION", - "MANUAL_STOP", - "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", - "MISSING_ELB_INFORMATION", - "MISSING_GITHUB_TOKEN", - "ELASTIC_LOAD_BALANCING_INVALID", - "ELB_INVALID_INSTANCE", - "INVALID_LAMBDA_CONFIGURATION", - "INVALID_LAMBDA_FUNCTION", - "HOOK_EXECUTION_FAILURE" - ] - }, - "ErrorInformation":{ - "type":"structure", - "members":{ - "code":{ - "shape":"ErrorCode", - "documentation":"

For information about additional error codes, see Error Codes for AWS CodeDeploy in the AWS CodeDeploy User Guide.

The error code:

  • APPLICATION_MISSING: The application was missing. This error code will most likely be raised if the application is deleted after the deployment is created but before it is started.

  • DEPLOYMENT_GROUP_MISSING: The deployment group was missing. This error code will most likely be raised if the deployment group is deleted after the deployment is created but before it is started.

  • HEALTH_CONSTRAINTS: The deployment failed on too many instances to be successfully deployed within the instance health constraints specified.

  • HEALTH_CONSTRAINTS_INVALID: The revision cannot be successfully deployed within the instance health constraints specified.

  • IAM_ROLE_MISSING: The service role cannot be accessed.

  • IAM_ROLE_PERMISSIONS: The service role does not have the correct permissions.

  • INTERNAL_ERROR: There was an internal error.

  • NO_EC2_SUBSCRIPTION: The calling account is not subscribed to the Amazon EC2 service.

  • NO_INSTANCES: No instance were specified, or no instance can be found.

  • OVER_MAX_INSTANCES: The maximum number of instance was exceeded.

  • THROTTLED: The operation was throttled because the calling account exceeded the throttling limits of one or more AWS services.

  • TIMEOUT: The deployment has timed out.

  • REVISION_MISSING: The revision ID was missing. This error code will most likely be raised if the revision is deleted after the deployment is created but before it is started.

" - }, - "message":{ - "shape":"ErrorMessage", - "documentation":"

An accompanying error message.

" - } - }, - "documentation":"

Information about a deployment error.

" - }, - "ErrorMessage":{"type":"string"}, - "FileExistsBehavior":{ - "type":"string", - "enum":[ - "DISALLOW", - "OVERWRITE", - "RETAIN" - ] - }, - "GenericRevisionInfo":{ - "type":"structure", - "members":{ - "description":{ - "shape":"Description", - "documentation":"

A comment about the revision.

" - }, - "deploymentGroups":{ - "shape":"DeploymentGroupsList", - "documentation":"

The deployment groups for which this is the current target revision.

" - }, - "firstUsedTime":{ - "shape":"Timestamp", - "documentation":"

When the revision was first used by AWS CodeDeploy.

" - }, - "lastUsedTime":{ - "shape":"Timestamp", - "documentation":"

When the revision was last used by AWS CodeDeploy.

" - }, - "registerTime":{ - "shape":"Timestamp", - "documentation":"

When the revision was registered with AWS CodeDeploy.

" - } - }, - "documentation":"

Information about an application revision.

" - }, - "GetApplicationInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - } - }, - "documentation":"

Represents the input of a GetApplication operation.

" - }, - "GetApplicationOutput":{ - "type":"structure", - "members":{ - "application":{ - "shape":"ApplicationInfo", - "documentation":"

Information about the application.

" - } - }, - "documentation":"

Represents the output of a GetApplication operation.

" - }, - "GetApplicationRevisionInput":{ - "type":"structure", - "required":[ - "applicationName", - "revision" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application that corresponds to the revision.

" - }, - "revision":{ - "shape":"RevisionLocation", - "documentation":"

Information about the application revision to get, including type and location.

" - } - }, - "documentation":"

Represents the input of a GetApplicationRevision operation.

" - }, - "GetApplicationRevisionOutput":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application that corresponds to the revision.

" - }, - "revision":{ - "shape":"RevisionLocation", - "documentation":"

Additional information about the revision, including type and location.

" - }, - "revisionInfo":{ - "shape":"GenericRevisionInfo", - "documentation":"

General information about the revision.

" - } - }, - "documentation":"

Represents the output of a GetApplicationRevision operation.

" - }, - "GetDeploymentConfigInput":{ - "type":"structure", - "required":["deploymentConfigName"], - "members":{ - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The name of a deployment configuration associated with the applicable IAM user or AWS account.

" - } - }, - "documentation":"

Represents the input of a GetDeploymentConfig operation.

" - }, - "GetDeploymentConfigOutput":{ - "type":"structure", - "members":{ - "deploymentConfigInfo":{ - "shape":"DeploymentConfigInfo", - "documentation":"

Information about the deployment configuration.

" - } - }, - "documentation":"

Represents the output of a GetDeploymentConfig operation.

" - }, - "GetDeploymentGroupInput":{ - "type":"structure", - "required":[ - "applicationName", - "deploymentGroupName" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The name of an existing deployment group for the specified application.

" - } - }, - "documentation":"

Represents the input of a GetDeploymentGroup operation.

" - }, - "GetDeploymentGroupOutput":{ - "type":"structure", - "members":{ - "deploymentGroupInfo":{ - "shape":"DeploymentGroupInfo", - "documentation":"

Information about the deployment group.

" - } - }, - "documentation":"

Represents the output of a GetDeploymentGroup operation.

" - }, - "GetDeploymentInput":{ - "type":"structure", - "required":["deploymentId"], - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

A deployment ID associated with the applicable IAM user or AWS account.

" - } - }, - "documentation":"

Represents the input of a GetDeployment operation.

" - }, - "GetDeploymentInstanceInput":{ - "type":"structure", - "required":[ - "deploymentId", - "instanceId" - ], - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The unique ID of a deployment.

" - }, - "instanceId":{ - "shape":"InstanceId", - "documentation":"

The unique ID of an instance in the deployment group.

" - } - }, - "documentation":"

Represents the input of a GetDeploymentInstance operation.

" - }, - "GetDeploymentInstanceOutput":{ - "type":"structure", - "members":{ - "instanceSummary":{ - "shape":"InstanceSummary", - "documentation":"

Information about the instance.

" - } - }, - "documentation":"

Represents the output of a GetDeploymentInstance operation.

" - }, - "GetDeploymentOutput":{ - "type":"structure", - "members":{ - "deploymentInfo":{ - "shape":"DeploymentInfo", - "documentation":"

Information about the deployment.

" - } - }, - "documentation":"

Represents the output of a GetDeployment operation.

" - }, - "GetOnPremisesInstanceInput":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"InstanceName", - "documentation":"

The name of the on-premises instance about which to get information.

" - } - }, - "documentation":"

Represents the input of a GetOnPremisesInstance operation.

" - }, - "GetOnPremisesInstanceOutput":{ - "type":"structure", - "members":{ - "instanceInfo":{ - "shape":"InstanceInfo", - "documentation":"

Information about the on-premises instance.

" - } - }, - "documentation":"

Represents the output of a GetOnPremisesInstance operation.

" - }, - "GitHubAccountTokenDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

No GitHub account connection exists with the named specified in the call.

", - "exception":true - }, - "GitHubAccountTokenName":{"type":"string"}, - "GitHubAccountTokenNameList":{ - "type":"list", - "member":{"shape":"GitHubAccountTokenName"} - }, - "GitHubAccountTokenNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The call is missing a required GitHub account connection name.

", - "exception":true - }, - "GitHubLocation":{ - "type":"structure", - "members":{ - "repository":{ - "shape":"Repository", - "documentation":"

The GitHub account and repository pair that stores a reference to the commit that represents the bundled artifacts for the application revision.

Specified as account/repository.

" - }, - "commitId":{ - "shape":"CommitId", - "documentation":"

The SHA1 commit ID of the GitHub commit that represents the bundled artifacts for the application revision.

" - } - }, - "documentation":"

Information about the location of application artifacts stored in GitHub.

" - }, - "GreenFleetProvisioningAction":{ - "type":"string", - "enum":[ - "DISCOVER_EXISTING", - "COPY_AUTO_SCALING_GROUP" - ] - }, - "GreenFleetProvisioningOption":{ - "type":"structure", - "members":{ - "action":{ - "shape":"GreenFleetProvisioningAction", - "documentation":"

The method used to add instances to a replacement environment.

  • DISCOVER_EXISTING: Use instances that already exist or will be created manually.

  • COPY_AUTO_SCALING_GROUP: Use settings from a specified Auto Scaling group to define and create instances in a new Auto Scaling group.

" - } - }, - "documentation":"

Information about the instances that belong to the replacement environment in a blue/green deployment.

" - }, - "IamArnRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

No IAM ARN was included in the request. You must use an IAM session ARN or IAM user ARN in the request.

", - "exception":true - }, - "IamSessionArn":{"type":"string"}, - "IamSessionArnAlreadyRegisteredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request included an IAM session ARN that has already been used to register a different instance.

", - "exception":true - }, - "IamUserArn":{"type":"string"}, - "IamUserArnAlreadyRegisteredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified IAM user ARN is already registered with an on-premises instance.

", - "exception":true - }, - "IamUserArnRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An IAM user ARN was not specified.

", - "exception":true - }, - "InstanceAction":{ - "type":"string", - "enum":[ - "TERMINATE", - "KEEP_ALIVE" - ] - }, - "InstanceArn":{"type":"string"}, - "InstanceCount":{"type":"long"}, - "InstanceDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified instance does not exist in the deployment group.

", - "exception":true - }, - "InstanceId":{"type":"string"}, - "InstanceIdRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The instance ID was not specified.

", - "exception":true - }, - "InstanceInfo":{ - "type":"structure", - "members":{ - "instanceName":{ - "shape":"InstanceName", - "documentation":"

The name of the on-premises instance.

" - }, - "iamSessionArn":{ - "shape":"IamSessionArn", - "documentation":"

The ARN of the IAM session associated with the on-premises instance.

" - }, - "iamUserArn":{ - "shape":"IamUserArn", - "documentation":"

The IAM user ARN associated with the on-premises instance.

" - }, - "instanceArn":{ - "shape":"InstanceArn", - "documentation":"

The ARN of the on-premises instance.

" - }, - "registerTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the on-premises instance was registered.

" - }, - "deregisterTime":{ - "shape":"Timestamp", - "documentation":"

If the on-premises instance was deregistered, the time at which the on-premises instance was deregistered.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The tags currently associated with the on-premises instance.

" - } - }, - "documentation":"

Information about an on-premises instance.

" - }, - "InstanceInfoList":{ - "type":"list", - "member":{"shape":"InstanceInfo"} - }, - "InstanceLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum number of allowed on-premises instances in a single call was exceeded.

", - "exception":true - }, - "InstanceName":{"type":"string"}, - "InstanceNameAlreadyRegisteredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified on-premises instance name is already registered.

", - "exception":true - }, - "InstanceNameList":{ - "type":"list", - "member":{"shape":"InstanceName"} - }, - "InstanceNameRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An on-premises instance name was not specified.

", - "exception":true - }, - "InstanceNotRegisteredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified on-premises instance is not registered.

", - "exception":true - }, - "InstanceStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Succeeded", - "Failed", - "Skipped", - "Unknown", - "Ready" - ] - }, - "InstanceStatusList":{ - "type":"list", - "member":{"shape":"InstanceStatus"} - }, - "InstanceSummary":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The deployment ID.

" - }, - "instanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - }, - "status":{ - "shape":"InstanceStatus", - "documentation":"

The deployment status for this instance:

  • Pending: The deployment is pending for this instance.

  • In Progress: The deployment is in progress for this instance.

  • Succeeded: The deployment has succeeded for this instance.

  • Failed: The deployment has failed for this instance.

  • Skipped: The deployment has been skipped for this instance.

  • Unknown: The deployment status is unknown for this instance.

" - }, - "lastUpdatedAt":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the instance information was last updated.

" - }, - "lifecycleEvents":{ - "shape":"LifecycleEventList", - "documentation":"

A list of lifecycle events for this instance.

" - }, - "instanceType":{ - "shape":"InstanceType", - "documentation":"

Information about which environment an instance belongs to in a blue/green deployment.

  • BLUE: The instance is part of the original environment.

  • GREEN: The instance is part of the replacement environment.

" - } - }, - "documentation":"

Information about an instance in a deployment.

" - }, - "InstanceSummaryList":{ - "type":"list", - "member":{"shape":"InstanceSummary"} - }, - "InstanceType":{ - "type":"string", - "enum":[ - "Blue", - "Green" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "InstancesList":{ - "type":"list", - "member":{"shape":"InstanceId"} - }, - "InvalidAlarmConfigException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The format of the alarm configuration is invalid. Possible causes include:

  • The alarm list is null.

  • The alarm object is null.

  • The alarm name is empty or null or exceeds the 255 character limit.

  • Two alarms with the same name have been specified.

  • The alarm configuration is enabled but the alarm list is empty.

", - "exception":true - }, - "InvalidApplicationNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The application name was specified in an invalid format.

", - "exception":true - }, - "InvalidAutoRollbackConfigException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The automatic rollback configuration was specified in an invalid format. For example, automatic rollback is enabled but an invalid triggering event type or no event types were listed.

", - "exception":true - }, - "InvalidAutoScalingGroupException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Auto Scaling group was specified in an invalid format or does not exist.

", - "exception":true - }, - "InvalidBlueGreenDeploymentConfigurationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The configuration for the blue/green deployment group was provided in an invalid format. For information about deployment configuration format, see CreateDeploymentConfig.

", - "exception":true - }, - "InvalidBucketNameFilterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The bucket name either doesn't exist or was specified in an invalid format.

", - "exception":true - }, - "InvalidComputePlatformException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The computePlatform is invalid. The computePlatform should be Lambda or Server.

", - "exception":true - }, - "InvalidDeployedStateFilterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployed state filter was specified in an invalid format.

", - "exception":true - }, - "InvalidDeploymentConfigNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment configuration name was specified in an invalid format.

", - "exception":true - }, - "InvalidDeploymentGroupNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The deployment group name was specified in an invalid format.

", - "exception":true - }, - "InvalidDeploymentIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

At least one of the deployment IDs was specified in an invalid format.

", - "exception":true - }, - "InvalidDeploymentInstanceTypeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An instance type was specified for an in-place deployment. Instance types are supported for blue/green deployments only.

", - "exception":true - }, - "InvalidDeploymentStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified deployment status doesn't exist or cannot be determined.

", - "exception":true - }, - "InvalidDeploymentStyleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid deployment style was specified. Valid deployment types include \"IN_PLACE\" and \"BLUE_GREEN\". Valid deployment options include \"WITH_TRAFFIC_CONTROL\" and \"WITHOUT_TRAFFIC_CONTROL\".

", - "exception":true - }, - "InvalidEC2TagCombinationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A call was submitted that specified both Ec2TagFilters and Ec2TagSet, but only one of these data types can be used in a single call.

", - "exception":true - }, - "InvalidEC2TagException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The tag was specified in an invalid format.

", - "exception":true - }, - "InvalidFileExistsBehaviorException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy handles files or directories that already exist in a deployment target location but weren't part of the previous successful deployment. Valid values include \"DISALLOW\", \"OVERWRITE\", and \"RETAIN\".

", - "exception":true - }, - "InvalidGitHubAccountTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The GitHub token is not valid.

", - "exception":true - }, - "InvalidGitHubAccountTokenNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The format of the specified GitHub account connection name is invalid.

", - "exception":true - }, - "InvalidIamSessionArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The IAM session ARN was specified in an invalid format.

", - "exception":true - }, - "InvalidIamUserArnException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The IAM user ARN was specified in an invalid format.

", - "exception":true - }, - "InvalidIgnoreApplicationStopFailuresValueException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", - "exception":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified input was specified in an invalid format.

", - "exception":true - }, - "InvalidInstanceIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

", - "exception":true - }, - "InvalidInstanceNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified on-premises instance name was specified in an invalid format.

", - "exception":true - }, - "InvalidInstanceStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified instance status does not exist.

", - "exception":true - }, - "InvalidInstanceTypeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid instance type was specified for instances in a blue/green deployment. Valid values include \"Blue\" for an original environment and \"Green\" for a replacement environment.

", - "exception":true - }, - "InvalidKeyPrefixFilterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified key prefix filter was specified in an invalid format.

", - "exception":true - }, - "InvalidLifecycleEventHookExecutionIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A lifecycle event hook is invalid. Review the hooks section in your AppSpec file to ensure the lifecycle events and hooks functions are valid.

", - "exception":true - }, - "InvalidLifecycleEventHookExecutionStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a Lambda validation function that verifies a lifecycle event is invalid. It should return Succeeded or Failed.

", - "exception":true - }, - "InvalidLoadBalancerInfoException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid load balancer name, or no load balancer name, was specified.

", - "exception":true - }, - "InvalidMinimumHealthyHostValueException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The minimum healthy instance value was specified in an invalid format.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The next token was specified in an invalid format.

", - "exception":true - }, - "InvalidOnPremisesTagCombinationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A call was submitted that specified both OnPremisesTagFilters and OnPremisesTagSet, but only one of these data types can be used in a single call.

", - "exception":true - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid operation was detected.

", - "exception":true - }, - "InvalidRegistrationStatusException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The registration status was specified in an invalid format.

", - "exception":true - }, - "InvalidRevisionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The revision was specified in an invalid format.

", - "exception":true - }, - "InvalidRoleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The service role ARN was specified in an invalid format. Or, if an Auto Scaling group was specified, the specified service role does not grant the appropriate permissions to Auto Scaling.

", - "exception":true - }, - "InvalidSortByException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The column name to sort by is either not present or was specified in an invalid format.

", - "exception":true - }, - "InvalidSortOrderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The sort order was specified in an invalid format.

", - "exception":true - }, - "InvalidTagException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified tag was specified in an invalid format.

", - "exception":true - }, - "InvalidTagFilterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified tag filter was specified in an invalid format.

", - "exception":true - }, - "InvalidTargetInstancesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The target instance configuration is invalid. Possible causes include:

  • Configuration data for target instances was entered for an in-place deployment.

  • The limit of 10 tags for a tag type was exceeded.

  • The combined length of the tag names exceeded the limit.

  • A specified tag is not currently applied to any instances.

", - "exception":true - }, - "InvalidTimeRangeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified time range was specified in an invalid format.

", - "exception":true - }, - "InvalidTrafficRoutingConfigurationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The configuration that specifies how traffic is routed during a deployment is invalid.

", - "exception":true - }, - "InvalidTriggerConfigException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The trigger was specified in an invalid format.

", - "exception":true - }, - "InvalidUpdateOutdatedInstancesOnlyValueException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, false is expected. For EC2/On-premises deployments, true or false is expected.

", - "exception":true - }, - "Key":{"type":"string"}, - "LastDeploymentInfo":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The deployment ID.

" - }, - "status":{ - "shape":"DeploymentStatus", - "documentation":"

The status of the most recent deployment.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the most recent deployment to the deployment group completed.

" - }, - "createTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the most recent deployment to the deployment group started.

" - } - }, - "documentation":"

Information about the most recent attempted or successful deployment to a deployment group.

" - }, - "LifecycleErrorCode":{ - "type":"string", - "enum":[ - "Success", - "ScriptMissing", - "ScriptNotExecutable", - "ScriptTimedOut", - "ScriptFailed", - "UnknownError" - ] - }, - "LifecycleEvent":{ - "type":"structure", - "members":{ - "lifecycleEventName":{ - "shape":"LifecycleEventName", - "documentation":"

The deployment lifecycle event name, such as ApplicationStop, BeforeInstall, AfterInstall, ApplicationStart, or ValidateService.

" - }, - "diagnostics":{ - "shape":"Diagnostics", - "documentation":"

Diagnostic information about the deployment lifecycle event.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the deployment lifecycle event started.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp indicating when the deployment lifecycle event ended.

" - }, - "status":{ - "shape":"LifecycleEventStatus", - "documentation":"

The deployment lifecycle event status:

  • Pending: The deployment lifecycle event is pending.

  • InProgress: The deployment lifecycle event is in progress.

  • Succeeded: The deployment lifecycle event ran successfully.

  • Failed: The deployment lifecycle event has failed.

  • Skipped: The deployment lifecycle event has been skipped.

  • Unknown: The deployment lifecycle event is unknown.

" - } - }, - "documentation":"

Information about a deployment lifecycle event.

" - }, - "LifecycleEventAlreadyCompletedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An attempt to return the status of an already completed lifecycle event occurred.

", - "exception":true - }, - "LifecycleEventHookExecutionId":{"type":"string"}, - "LifecycleEventList":{ - "type":"list", - "member":{"shape":"LifecycleEvent"} - }, - "LifecycleEventName":{"type":"string"}, - "LifecycleEventStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Succeeded", - "Failed", - "Skipped", - "Unknown" - ] - }, - "LifecycleHookLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The limit for lifecycle hooks was exceeded.

", - "exception":true - }, - "LifecycleMessage":{"type":"string"}, - "ListApplicationRevisionsInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "sortBy":{ - "shape":"ApplicationRevisionSortBy", - "documentation":"

The column name to use to sort the list results:

  • registerTime: Sort by the time the revisions were registered with AWS CodeDeploy.

  • firstUsedTime: Sort by the time the revisions were first used in a deployment.

  • lastUsedTime: Sort by the time the revisions were last used in a deployment.

If not specified or set to null, the results will be returned in an arbitrary order.

" - }, - "sortOrder":{ - "shape":"SortOrder", - "documentation":"

The order in which to sort the list results:

  • ascending: ascending order.

  • descending: descending order.

If not specified, the results will be sorted in ascending order.

If set to null, the results will be sorted in an arbitrary order.

" - }, - "s3Bucket":{ - "shape":"S3Bucket", - "documentation":"

An Amazon S3 bucket name to limit the search for revisions.

If set to null, all of the user's buckets will be searched.

" - }, - "s3KeyPrefix":{ - "shape":"S3Key", - "documentation":"

A key prefix for the set of Amazon S3 objects to limit the search for revisions.

" - }, - "deployed":{ - "shape":"ListStateFilterAction", - "documentation":"

Whether to list revisions based on whether the revision is the target revision of an deployment group:

  • include: List revisions that are target revisions of a deployment group.

  • exclude: Do not list revisions that are target revisions of a deployment group.

  • ignore: List all revisions.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list application revisions call. It can be used to return the next set of applications in the list.

" - } - }, - "documentation":"

Represents the input of a ListApplicationRevisions operation.

" - }, - "ListApplicationRevisionsOutput":{ - "type":"structure", - "members":{ - "revisions":{ - "shape":"RevisionLocationList", - "documentation":"

A list of locations that contain the matching revisions.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier will also be returned. It can be used in a subsequent list application revisions call to return the next set of application revisions in the list.

" - } - }, - "documentation":"

Represents the output of a ListApplicationRevisions operation.

" - }, - "ListApplicationsInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list applications call. It can be used to return the next set of applications in the list.

" - } - }, - "documentation":"

Represents the input of a ListApplications operation.

" - }, - "ListApplicationsOutput":{ - "type":"structure", - "members":{ - "applications":{ - "shape":"ApplicationsList", - "documentation":"

A list of application names.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list applications call to return the next set of applications, will also be returned. in the list.

" - } - }, - "documentation":"

Represents the output of a ListApplications operation.

" - }, - "ListDeploymentConfigsInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list deployment configurations call. It can be used to return the next set of deployment configurations in the list.

" - } - }, - "documentation":"

Represents the input of a ListDeploymentConfigs operation.

" - }, - "ListDeploymentConfigsOutput":{ - "type":"structure", - "members":{ - "deploymentConfigsList":{ - "shape":"DeploymentConfigsList", - "documentation":"

A list of deployment configurations, including built-in configurations such as CodeDeployDefault.OneAtATime.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list deployment configurations call to return the next set of deployment configurations in the list.

" - } - }, - "documentation":"

Represents the output of a ListDeploymentConfigs operation.

" - }, - "ListDeploymentGroupsInput":{ - "type":"structure", - "required":["applicationName"], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list deployment groups call. It can be used to return the next set of deployment groups in the list.

" - } - }, - "documentation":"

Represents the input of a ListDeploymentGroups operation.

" - }, - "ListDeploymentGroupsOutput":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The application name.

" - }, - "deploymentGroups":{ - "shape":"DeploymentGroupsList", - "documentation":"

A list of corresponding deployment group names.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list deployment groups call to return the next set of deployment groups in the list.

" - } - }, - "documentation":"

Represents the output of a ListDeploymentGroups operation.

" - }, - "ListDeploymentInstancesInput":{ - "type":"structure", - "required":["deploymentId"], - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The unique ID of a deployment.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list deployment instances call. It can be used to return the next set of deployment instances in the list.

" - }, - "instanceStatusFilter":{ - "shape":"InstanceStatusList", - "documentation":"

A subset of instances to list by status:

  • Pending: Include those instance with pending deployments.

  • InProgress: Include those instance where deployments are still in progress.

  • Succeeded: Include those instances with successful deployments.

  • Failed: Include those instance with failed deployments.

  • Skipped: Include those instance with skipped deployments.

  • Unknown: Include those instance with deployments in an unknown state.

" - }, - "instanceTypeFilter":{ - "shape":"InstanceTypeList", - "documentation":"

The set of instances in a blue/green deployment, either those in the original environment (\"BLUE\") or those in the replacement environment (\"GREEN\"), for which you want to view instance information.

" - } - }, - "documentation":"

Represents the input of a ListDeploymentInstances operation.

" - }, - "ListDeploymentInstancesOutput":{ - "type":"structure", - "members":{ - "instancesList":{ - "shape":"InstancesList", - "documentation":"

A list of instance IDs.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list deployment instances call to return the next set of deployment instances in the list.

" - } - }, - "documentation":"

Represents the output of a ListDeploymentInstances operation.

" - }, - "ListDeploymentsInput":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "deploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The name of an existing deployment group for the specified application.

" - }, - "includeOnlyStatuses":{ - "shape":"DeploymentStatusList", - "documentation":"

A subset of deployments to list by status:

  • Created: Include created deployments in the resulting list.

  • Queued: Include queued deployments in the resulting list.

  • In Progress: Include in-progress deployments in the resulting list.

  • Succeeded: Include successful deployments in the resulting list.

  • Failed: Include failed deployments in the resulting list.

  • Stopped: Include stopped deployments in the resulting list.

" - }, - "createTimeRange":{ - "shape":"TimeRange", - "documentation":"

A time range (start and end) for returning a subset of the list of deployments.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list deployments call. It can be used to return the next set of deployments in the list.

" - } - }, - "documentation":"

Represents the input of a ListDeployments operation.

" - }, - "ListDeploymentsOutput":{ - "type":"structure", - "members":{ - "deployments":{ - "shape":"DeploymentsList", - "documentation":"

A list of deployment IDs.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list deployments call to return the next set of deployments in the list.

" - } - }, - "documentation":"

Represents the output of a ListDeployments operation.

" - }, - "ListGitHubAccountTokenNamesInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous ListGitHubAccountTokenNames call. It can be used to return the next set of names in the list.

" - } - }, - "documentation":"

Represents the input of a ListGitHubAccountTokenNames operation.

" - }, - "ListGitHubAccountTokenNamesOutput":{ - "type":"structure", - "members":{ - "tokenNameList":{ - "shape":"GitHubAccountTokenNameList", - "documentation":"

A list of names of connections to GitHub accounts.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent ListGitHubAccountTokenNames call to return the next set of names in the list.

" - } - }, - "documentation":"

Represents the output of a ListGitHubAccountTokenNames operation.

" - }, - "ListOnPremisesInstancesInput":{ - "type":"structure", - "members":{ - "registrationStatus":{ - "shape":"RegistrationStatus", - "documentation":"

The registration status of the on-premises instances:

  • Deregistered: Include deregistered on-premises instances in the resulting list.

  • Registered: Include registered on-premises instances in the resulting list.

" - }, - "tagFilters":{ - "shape":"TagFilterList", - "documentation":"

The on-premises instance tags that will be used to restrict the corresponding on-premises instance names returned.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier returned from the previous list on-premises instances call. It can be used to return the next set of on-premises instances in the list.

" - } - }, - "documentation":"

Represents the input of a ListOnPremisesInstances operation.

" - }, - "ListOnPremisesInstancesOutput":{ - "type":"structure", - "members":{ - "instanceNames":{ - "shape":"InstanceNameList", - "documentation":"

The list of matching on-premises instance names.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list on-premises instances call to return the next set of on-premises instances in the list.

" - } - }, - "documentation":"

Represents the output of list on-premises instances operation.

" - }, - "ListStateFilterAction":{ - "type":"string", - "enum":[ - "include", - "exclude", - "ignore" - ] - }, - "LoadBalancerInfo":{ - "type":"structure", - "members":{ - "elbInfoList":{ - "shape":"ELBInfoList", - "documentation":"

An array containing information about the load balancer to use for load balancing in a deployment. In Elastic Load Balancing, load balancers are used with Classic Load Balancers.

Adding more than one load balancer to the array is not supported.

" - }, - "targetGroupInfoList":{ - "shape":"TargetGroupInfoList", - "documentation":"

An array containing information about the target group to use for load balancing in a deployment. In Elastic Load Balancing, target groups are used with Application Load Balancers.

Adding more than one target group to the array is not supported.

" - } - }, - "documentation":"

Information about the Elastic Load Balancing load balancer or target group used in a deployment.

" - }, - "LogTail":{"type":"string"}, - "Message":{"type":"string"}, - "MinimumHealthyHosts":{ - "type":"structure", - "members":{ - "value":{ - "shape":"MinimumHealthyHostsValue", - "documentation":"

The minimum healthy instance value.

" - }, - "type":{ - "shape":"MinimumHealthyHostsType", - "documentation":"

The minimum healthy instance type:

  • HOST_COUNT: The minimum number of healthy instance as an absolute value.

  • FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment will be successful if six or more instances are deployed to successfully; otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment will be successful if four or more instance are deployed to successfully; otherwise, the deployment fails.

In a call to the get deployment configuration operation, CodeDeployDefault.OneAtATime will return a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy will try to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment still succeeds.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide.

" - } - }, - "documentation":"

Information about minimum healthy instance.

" - }, - "MinimumHealthyHostsType":{ - "type":"string", - "enum":[ - "HOST_COUNT", - "FLEET_PERCENT" - ] - }, - "MinimumHealthyHostsValue":{"type":"integer"}, - "MultipleIamArnsProvidedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Both an IAM user ARN and an IAM session ARN were included in the request. Use only one ARN type.

", - "exception":true - }, - "NextToken":{"type":"string"}, - "NullableBoolean":{"type":"boolean"}, - "OnPremisesTagSet":{ - "type":"structure", - "members":{ - "onPremisesTagSetList":{ - "shape":"OnPremisesTagSetList", - "documentation":"

A list containing other lists of on-premises instance tag groups. In order for an instance to be included in the deployment group, it must be identified by all the tag groups in the list.

" - } - }, - "documentation":"

Information about groups of on-premises instance tags.

" - }, - "OnPremisesTagSetList":{ - "type":"list", - "member":{"shape":"TagFilterList"} - }, - "OperationNotSupportedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The API used does not support the deployment.

", - "exception":true - }, - "Percentage":{"type":"integer"}, - "PutLifecycleEventHookExecutionStatusInput":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The ID of the deployment. Pass this ID to a Lambda function that validates a deployment lifecycle event.

" - }, - "lifecycleEventHookExecutionId":{ - "shape":"LifecycleEventHookExecutionId", - "documentation":"

The execution ID of a deployment's lifecycle hook. A deployment lifecycle hook is specified in the hooks section of the AppSpec file.

" - }, - "status":{ - "shape":"LifecycleEventStatus", - "documentation":"

The result of a Lambda function that validates a deployment lifecycle event (Succeeded or Failed).

" - } - } - }, - "PutLifecycleEventHookExecutionStatusOutput":{ - "type":"structure", - "members":{ - "lifecycleEventHookExecutionId":{ - "shape":"LifecycleEventHookExecutionId", - "documentation":"

The execution ID of the lifecycle event hook. A hook is specified in the hooks section of the deployment's AppSpec file.

" - } - } - }, - "RawString":{ - "type":"structure", - "members":{ - "content":{ - "shape":"RawStringContent", - "documentation":"

The YAML-formatted or JSON-formatted revision string. It includes information about which Lambda function to update and optional Lambda functions that validate deployment lifecycle events.

" - }, - "sha256":{ - "shape":"RawStringSha256", - "documentation":"

The SHA256 hash value of the revision that is specified as a RawString.

" - } - }, - "documentation":"

A revision for an AWS Lambda deployment that is a YAML-formatted or JSON-formatted string. For AWS Lambda deployments, the revision is the same as the AppSpec file.

" - }, - "RawStringContent":{"type":"string"}, - "RawStringSha256":{"type":"string"}, - "RegisterApplicationRevisionInput":{ - "type":"structure", - "required":[ - "applicationName", - "revision" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A comment about the revision.

" - }, - "revision":{ - "shape":"RevisionLocation", - "documentation":"

Information about the application revision to register, including type and location.

" - } - }, - "documentation":"

Represents the input of a RegisterApplicationRevision operation.

" - }, - "RegisterOnPremisesInstanceInput":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"InstanceName", - "documentation":"

The name of the on-premises instance to register.

" - }, - "iamSessionArn":{ - "shape":"IamSessionArn", - "documentation":"

The ARN of the IAM session to associate with the on-premises instance.

" - }, - "iamUserArn":{ - "shape":"IamUserArn", - "documentation":"

The ARN of the IAM user to associate with the on-premises instance.

" - } - }, - "documentation":"

Represents the input of the register on-premises instance operation.

" - }, - "RegistrationStatus":{ - "type":"string", - "enum":[ - "Registered", - "Deregistered" - ] - }, - "RemoveTagsFromOnPremisesInstancesInput":{ - "type":"structure", - "required":[ - "tags", - "instanceNames" - ], - "members":{ - "tags":{ - "shape":"TagList", - "documentation":"

The tag key-value pairs to remove from the on-premises instances.

" - }, - "instanceNames":{ - "shape":"InstanceNameList", - "documentation":"

The names of the on-premises instances from which to remove tags.

" - } - }, - "documentation":"

Represents the input of a RemoveTagsFromOnPremisesInstances operation.

" - }, - "Repository":{"type":"string"}, - "ResourceValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource could not be validated.

", - "exception":true - }, - "RevisionDoesNotExistException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The named revision does not exist with the applicable IAM user or AWS account.

", - "exception":true - }, - "RevisionInfo":{ - "type":"structure", - "members":{ - "revisionLocation":{ - "shape":"RevisionLocation", - "documentation":"

Information about the location and type of an application revision.

" - }, - "genericRevisionInfo":{ - "shape":"GenericRevisionInfo", - "documentation":"

Information about an application revision, including usage details and associated deployment groups.

" - } - }, - "documentation":"

Information about an application revision.

" - }, - "RevisionInfoList":{ - "type":"list", - "member":{"shape":"RevisionInfo"} - }, - "RevisionLocation":{ - "type":"structure", - "members":{ - "revisionType":{ - "shape":"RevisionLocationType", - "documentation":"

The type of application revision:

  • S3: An application revision stored in Amazon S3.

  • GitHub: An application revision stored in GitHub (EC2/On-premises deployments only)

  • String: A YAML-formatted or JSON-formatted string (AWS Lambda deployments only)

" - }, - "s3Location":{ - "shape":"S3Location", - "documentation":"

Information about the location of a revision stored in Amazon S3.

" - }, - "gitHubLocation":{ - "shape":"GitHubLocation", - "documentation":"

Information about the location of application artifacts stored in GitHub.

" - }, - "string":{ - "shape":"RawString", - "documentation":"

Information about the location of an AWS Lambda deployment revision stored as a RawString.

" - } - }, - "documentation":"

Information about the location of an application revision.

" - }, - "RevisionLocationList":{ - "type":"list", - "member":{"shape":"RevisionLocation"} - }, - "RevisionLocationType":{ - "type":"string", - "enum":[ - "S3", - "GitHub", - "String" - ] - }, - "RevisionRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The revision ID was not specified.

", - "exception":true - }, - "Role":{"type":"string"}, - "RoleRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The role ID was not specified.

", - "exception":true - }, - "RollbackInfo":{ - "type":"structure", - "members":{ - "rollbackDeploymentId":{ - "shape":"DeploymentId", - "documentation":"

The ID of the deployment rollback.

" - }, - "rollbackTriggeringDeploymentId":{ - "shape":"DeploymentId", - "documentation":"

The deployment ID of the deployment that was underway and triggered a rollback deployment because it failed or was stopped.

" - }, - "rollbackMessage":{ - "shape":"Description", - "documentation":"

Information describing the status of a deployment rollback; for example, whether the deployment can't be rolled back, is in progress, failed, or succeeded.

" - } - }, - "documentation":"

Information about a deployment rollback.

" - }, - "S3Bucket":{"type":"string"}, - "S3Key":{"type":"string"}, - "S3Location":{ - "type":"structure", - "members":{ - "bucket":{ - "shape":"S3Bucket", - "documentation":"

The name of the Amazon S3 bucket where the application revision is stored.

" - }, - "key":{ - "shape":"S3Key", - "documentation":"

The name of the Amazon S3 object that represents the bundled artifacts for the application revision.

" - }, - "bundleType":{ - "shape":"BundleType", - "documentation":"

The file type of the application revision. Must be one of the following:

  • tar: A tar archive file.

  • tgz: A compressed tar archive file.

  • zip: A zip archive file.

" - }, - "version":{ - "shape":"VersionId", - "documentation":"

A specific version of the Amazon S3 object that represents the bundled artifacts for the application revision.

If the version is not specified, the system will use the most recent version by default.

" - }, - "eTag":{ - "shape":"ETag", - "documentation":"

The ETag of the Amazon S3 object that represents the bundled artifacts for the application revision.

If the ETag is not specified as an input parameter, ETag validation of the object will be skipped.

" - } - }, - "documentation":"

Information about the location of application artifacts stored in Amazon S3.

" - }, - "ScriptName":{"type":"string"}, - "SkipWaitTimeForInstanceTerminationInput":{ - "type":"structure", - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The ID of the blue/green deployment for which you want to skip the instance termination wait time.

" - } - } - }, - "SortOrder":{ - "type":"string", - "enum":[ - "ascending", - "descending" - ] - }, - "StopDeploymentInput":{ - "type":"structure", - "required":["deploymentId"], - "members":{ - "deploymentId":{ - "shape":"DeploymentId", - "documentation":"

The unique ID of a deployment.

" - }, - "autoRollbackEnabled":{ - "shape":"NullableBoolean", - "documentation":"

Indicates, when a deployment is stopped, whether instances that have been updated should be rolled back to the previous version of the application revision.

" - } - }, - "documentation":"

Represents the input of a StopDeployment operation.

" - }, - "StopDeploymentOutput":{ - "type":"structure", - "members":{ - "status":{ - "shape":"StopStatus", - "documentation":"

The status of the stop deployment operation:

  • Pending: The stop operation is pending.

  • Succeeded: The stop operation was successful.

" - }, - "statusMessage":{ - "shape":"Message", - "documentation":"

An accompanying status message.

" - } - }, - "documentation":"

Represents the output of a StopDeployment operation.

" - }, - "StopStatus":{ - "type":"string", - "enum":[ - "Pending", - "Succeeded" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"Key", - "documentation":"

The tag's key.

" - }, - "Value":{ - "shape":"Value", - "documentation":"

The tag's value.

" - } - }, - "documentation":"

Information about a tag.

" - }, - "TagFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"Key", - "documentation":"

The on-premises instance tag filter key.

" - }, - "Value":{ - "shape":"Value", - "documentation":"

The on-premises instance tag filter value.

" - }, - "Type":{ - "shape":"TagFilterType", - "documentation":"

The on-premises instance tag filter type:

  • KEY_ONLY: Key only.

  • VALUE_ONLY: Value only.

  • KEY_AND_VALUE: Key and value.

" - } - }, - "documentation":"

Information about an on-premises instance tag filter.

" - }, - "TagFilterList":{ - "type":"list", - "member":{"shape":"TagFilter"} - }, - "TagFilterType":{ - "type":"string", - "enum":[ - "KEY_ONLY", - "VALUE_ONLY", - "KEY_AND_VALUE" - ] - }, - "TagLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum allowed number of tags was exceeded.

", - "exception":true - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A tag was not specified.

", - "exception":true - }, - "TagSetListLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of tag groups included in the tag set list exceeded the maximum allowed limit of 3.

", - "exception":true - }, - "TargetGroupInfo":{ - "type":"structure", - "members":{ - "name":{ - "shape":"TargetGroupName", - "documentation":"

For blue/green deployments, the name of the target group that instances in the original environment are deregistered from, and instances in the replacement environment registered with. For in-place deployments, the name of the target group that instances are deregistered from, so they are not serving traffic during a deployment, and then re-registered with after the deployment completes.

" - } - }, - "documentation":"

Information about a target group in Elastic Load Balancing to use in a deployment. Instances are registered as targets in a target group, and traffic is routed to the target group.

" - }, - "TargetGroupInfoList":{ - "type":"list", - "member":{"shape":"TargetGroupInfo"} - }, - "TargetGroupName":{"type":"string"}, - "TargetInstances":{ - "type":"structure", - "members":{ - "tagFilters":{ - "shape":"EC2TagFilterList", - "documentation":"

The tag filter key, type, and value used to identify Amazon EC2 instances in a replacement environment for a blue/green deployment. Cannot be used in the same call as ec2TagSet.

" - }, - "autoScalingGroups":{ - "shape":"AutoScalingGroupNameList", - "documentation":"

The names of one or more Auto Scaling groups to identify a replacement environment for a blue/green deployment.

" - }, - "ec2TagSet":{ - "shape":"EC2TagSet", - "documentation":"

Information about the groups of EC2 instance tags that an instance must be identified by in order for it to be included in the replacement environment for a blue/green deployment. Cannot be used in the same call as tagFilters.

" - } - }, - "documentation":"

Information about the instances to be used in the replacement environment in a blue/green deployment.

" - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An API function was called too frequently.

", - "exception":true - }, - "TimeBasedCanary":{ - "type":"structure", - "members":{ - "canaryPercentage":{ - "shape":"Percentage", - "documentation":"

The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

" - }, - "canaryInterval":{ - "shape":"WaitTimeInMins", - "documentation":"

The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.

" - } - }, - "documentation":"

A configuration that shifts traffic from one version of a Lambda function to another in two increments. The original and target Lambda function versions are specified in the deployment's AppSpec file.

" - }, - "TimeBasedLinear":{ - "type":"structure", - "members":{ - "linearPercentage":{ - "shape":"Percentage", - "documentation":"

The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

" - }, - "linearInterval":{ - "shape":"WaitTimeInMins", - "documentation":"

The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.

" - } - }, - "documentation":"

A configuration that shifts traffic from one version of a Lambda function to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions are specified in the deployment's AppSpec file.

" - }, - "TimeRange":{ - "type":"structure", - "members":{ - "start":{ - "shape":"Timestamp", - "documentation":"

The start time of the time range.

Specify null to leave the start time open-ended.

" - }, - "end":{ - "shape":"Timestamp", - "documentation":"

The end time of the time range.

Specify null to leave the end time open-ended.

" - } - }, - "documentation":"

Information about a time range.

" - }, - "Timestamp":{"type":"timestamp"}, - "TrafficRoutingConfig":{ - "type":"structure", - "members":{ - "type":{ - "shape":"TrafficRoutingType", - "documentation":"

The type of traffic shifting (TimeBasedCanary or TimeBasedLinear) used by a deployment configuration .

" - }, - "timeBasedCanary":{ - "shape":"TimeBasedCanary", - "documentation":"

A configuration that shifts traffic from one version of a Lambda function to another in two increments. The original and target Lambda function versions are specified in the deployment's AppSpec file.

" - }, - "timeBasedLinear":{ - "shape":"TimeBasedLinear", - "documentation":"

A configuration that shifts traffic from one version of a Lambda function to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions are specified in the deployment's AppSpec file.

" - } - }, - "documentation":"

The configuration that specifies how traffic is shifted from one version of a Lambda function to another version during an AWS Lambda deployment.

" - }, - "TrafficRoutingType":{ - "type":"string", - "enum":[ - "TimeBasedCanary", - "TimeBasedLinear", - "AllAtOnce" - ] - }, - "TriggerConfig":{ - "type":"structure", - "members":{ - "triggerName":{ - "shape":"TriggerName", - "documentation":"

The name of the notification trigger.

" - }, - "triggerTargetArn":{ - "shape":"TriggerTargetArn", - "documentation":"

The ARN of the Amazon Simple Notification Service topic through which notifications about deployment or instance events are sent.

" - }, - "triggerEvents":{ - "shape":"TriggerEventTypeList", - "documentation":"

The event type or types for which notifications are triggered.

" - } - }, - "documentation":"

Information about notification triggers for the deployment group.

" - }, - "TriggerConfigList":{ - "type":"list", - "member":{"shape":"TriggerConfig"} - }, - "TriggerEventType":{ - "type":"string", - "enum":[ - "DeploymentStart", - "DeploymentSuccess", - "DeploymentFailure", - "DeploymentStop", - "DeploymentRollback", - "DeploymentReady", - "InstanceStart", - "InstanceSuccess", - "InstanceFailure", - "InstanceReady" - ] - }, - "TriggerEventTypeList":{ - "type":"list", - "member":{"shape":"TriggerEventType"} - }, - "TriggerName":{"type":"string"}, - "TriggerTargetArn":{"type":"string"}, - "TriggerTargetsLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The maximum allowed number of triggers was exceeded.

", - "exception":true - }, - "UnsupportedActionForDeploymentTypeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A call was submitted that is not supported for the specified deployment type.

", - "exception":true - }, - "UpdateApplicationInput":{ - "type":"structure", - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The current name of the application you want to change.

" - }, - "newApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The new name to give the application.

" - } - }, - "documentation":"

Represents the input of an UpdateApplication operation.

" - }, - "UpdateDeploymentGroupInput":{ - "type":"structure", - "required":[ - "applicationName", - "currentDeploymentGroupName" - ], - "members":{ - "applicationName":{ - "shape":"ApplicationName", - "documentation":"

The application name corresponding to the deployment group to update.

" - }, - "currentDeploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The current name of the deployment group.

" - }, - "newDeploymentGroupName":{ - "shape":"DeploymentGroupName", - "documentation":"

The new name of the deployment group, if you want to change it.

" - }, - "deploymentConfigName":{ - "shape":"DeploymentConfigName", - "documentation":"

The replacement deployment configuration name to use, if you want to change it.

" - }, - "ec2TagFilters":{ - "shape":"EC2TagFilterList", - "documentation":"

The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.

" - }, - "onPremisesInstanceTagFilters":{ - "shape":"TagFilterList", - "documentation":"

The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.

" - }, - "autoScalingGroups":{ - "shape":"AutoScalingGroupNameList", - "documentation":"

The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them. To keep the Auto Scaling groups, enter their names. To remove Auto Scaling groups, do not enter any Auto Scaling group names.

" - }, - "serviceRoleArn":{ - "shape":"Role", - "documentation":"

A replacement ARN for the service role, if you want to change it.

" - }, - "triggerConfigurations":{ - "shape":"TriggerConfigList", - "documentation":"

Information about triggers to change when the deployment group is updated. For examples, see Modify Triggers in an AWS CodeDeploy Deployment Group in the AWS CodeDeploy User Guide.

" - }, - "alarmConfiguration":{ - "shape":"AlarmConfiguration", - "documentation":"

Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.

" - }, - "autoRollbackConfiguration":{ - "shape":"AutoRollbackConfiguration", - "documentation":"

Information for an automatic rollback configuration that is added or changed when a deployment group is updated.

" - }, - "deploymentStyle":{ - "shape":"DeploymentStyle", - "documentation":"

Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.

" - }, - "blueGreenDeploymentConfiguration":{ - "shape":"BlueGreenDeploymentConfiguration", - "documentation":"

Information about blue/green deployment options for a deployment group.

" - }, - "loadBalancerInfo":{ - "shape":"LoadBalancerInfo", - "documentation":"

Information about the load balancer used in a deployment.

" - }, - "ec2TagSet":{ - "shape":"EC2TagSet", - "documentation":"

Information about groups of tags applied to on-premises instances. The deployment group will include only EC2 instances identified by all the tag groups.

" - }, - "onPremisesTagSet":{ - "shape":"OnPremisesTagSet", - "documentation":"

Information about an on-premises instance tag set. The deployment group will include only on-premises instances identified by all the tag groups.

" - } - }, - "documentation":"

Represents the input of an UpdateDeploymentGroup operation.

" - }, - "UpdateDeploymentGroupOutput":{ - "type":"structure", - "members":{ - "hooksNotCleanedUp":{ - "shape":"AutoScalingGroupList", - "documentation":"

If the output contains no data, and the corresponding deployment group contained at least one Auto Scaling group, AWS CodeDeploy successfully removed all corresponding Auto Scaling lifecycle event hooks from the AWS account. If the output contains data, AWS CodeDeploy could not remove some Auto Scaling lifecycle event hooks from the AWS account.

" - } - }, - "documentation":"

Represents the output of an UpdateDeploymentGroup operation.

" - }, - "Value":{"type":"string"}, - "VersionId":{"type":"string"}, - "WaitTimeInMins":{"type":"integer"} - }, - "documentation":"AWS CodeDeploy

AWS CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances, on-premises instances running in your own facility, or serverless AWS Lambda functions.

You can deploy a nearly unlimited variety of application content, such as an updated Lambda function, code, web and configuration files, executables, packages, scripts, multimedia files, and so on. AWS CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use AWS CodeDeploy.

AWS CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.

AWS CodeDeploy Components

Use the information in this guide to help you work with the following AWS CodeDeploy components:

  • Application: A name that uniquely identifies the application you want to deploy. AWS CodeDeploy uses this name, which functions as a container, to ensure the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment.

  • Deployment group: A set of individual instances or CodeDeploy Lambda applications. A Lambda deployment group contains a group of applications. An EC2/On-premises deployment group contains individually tagged instances, Amazon EC2 instances in Auto Scaling groups, or both.

  • Deployment configuration: A set of deployment rules and deployment success and failure conditions used by AWS CodeDeploy during a deployment.

  • Deployment: The process and the components used in the process of updating a Lambda function or of installing content on one or more instances.

  • Application revisions: For an AWS Lambda deployment, this is an AppSpec file that specifies the Lambda function to update and one or more functions to validate deployment lifecycle events. For an EC2/On-premises deployment, this is an archive file containing source content—source code, web pages, executable files, and deployment scripts—along with an AppSpec file. Revisions are stored in Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For GitHub, a revision is uniquely identified by its commit ID.

This guide also contains information to help you get details about the instances in your deployments, to make on-premises instances available for AWS CodeDeploy deployments, and to get details about a Lambda function deployment.

AWS CodeDeploy Information Resources

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/waiters-2.json deleted file mode 100644 index 0fea4fac..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codedeploy/2014-10-06/waiters-2.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "version": 2, - "waiters": { - "DeploymentSuccessful": { - "delay": 15, - "operation": "GetDeployment", - "maxAttempts": 120, - "acceptors": [ - { - "expected": "Succeeded", - "matcher": "path", - "state": "success", - "argument": "deploymentInfo.status" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "deploymentInfo.status" - }, - { - "expected": "Stopped", - "matcher": "path", - "state": "failure", - "argument": "deploymentInfo.status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/service-2.json deleted file mode 100644 index 722b2b51..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codepipeline/2015-07-09/service-2.json +++ /dev/null @@ -1,3043 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-07-09", - "endpointPrefix":"codepipeline", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CodePipeline", - "serviceFullName":"AWS CodePipeline", - "serviceId":"CodePipeline", - "signatureVersion":"v4", - "targetPrefix":"CodePipeline_20150709", - "uid":"codepipeline-2015-07-09" - }, - "operations":{ - "AcknowledgeJob":{ - "name":"AcknowledgeJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcknowledgeJobInput"}, - "output":{"shape":"AcknowledgeJobOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNonceException"}, - {"shape":"JobNotFoundException"} - ], - "documentation":"

Returns information about a specified job and whether that job has been received by the job worker. Only used for custom actions.

" - }, - "AcknowledgeThirdPartyJob":{ - "name":"AcknowledgeThirdPartyJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcknowledgeThirdPartyJobInput"}, - "output":{"shape":"AcknowledgeThirdPartyJobOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNonceException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InvalidClientTokenException"} - ], - "documentation":"

Confirms a job worker has received the specified job. Only used for partner actions.

" - }, - "CreateCustomActionType":{ - "name":"CreateCustomActionType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomActionTypeInput"}, - "output":{"shape":"CreateCustomActionTypeOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a new custom action that can be used in all pipelines associated with the AWS account. Only used for custom actions.

" - }, - "CreatePipeline":{ - "name":"CreatePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePipelineInput"}, - "output":{"shape":"CreatePipelineOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNameInUseException"}, - {"shape":"InvalidStageDeclarationException"}, - {"shape":"InvalidActionDeclarationException"}, - {"shape":"InvalidBlockerDeclarationException"}, - {"shape":"InvalidStructureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a pipeline.

" - }, - "DeleteCustomActionType":{ - "name":"DeleteCustomActionType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomActionTypeInput"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Marks a custom action as deleted. PollForJobs for the custom action will fail after the action is marked for deletion. Only used for custom actions.

To re-create a custom action after it has been deleted you must use a string in the version field that has never been used before. This string can be an incremented version number, for example. To restore a deleted custom action, use a JSON file that is identical to the deleted action, including the original string in the version field.

" - }, - "DeletePipeline":{ - "name":"DeletePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePipelineInput"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Deletes the specified pipeline.

" - }, - "DeleteWebhook":{ - "name":"DeleteWebhook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteWebhookInput"}, - "output":{"shape":"DeleteWebhookOutput"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Deletes a previously created webhook by name. Deleting the webhook stops AWS CodePipeline from starting a pipeline every time an external event occurs. The API will return successfully when trying to delete a webhook that is already deleted. If a deleted webhook is re-created by calling PutWebhook with the same name, it will have a different URL.

" - }, - "DeregisterWebhookWithThirdParty":{ - "name":"DeregisterWebhookWithThirdParty", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterWebhookWithThirdPartyInput"}, - "output":{"shape":"DeregisterWebhookWithThirdPartyOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"WebhookNotFoundException"} - ], - "documentation":"

Removes the connection between the webhook that was created by CodePipeline and the external tool with events to be detected. Currently only supported for webhooks that target an action type of GitHub.

" - }, - "DisableStageTransition":{ - "name":"DisableStageTransition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableStageTransitionInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"StageNotFoundException"} - ], - "documentation":"

Prevents artifacts in a pipeline from transitioning to the next stage in the pipeline.

" - }, - "EnableStageTransition":{ - "name":"EnableStageTransition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableStageTransitionInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"StageNotFoundException"} - ], - "documentation":"

Enables artifacts in a pipeline to transition to a stage in a pipeline.

" - }, - "GetJobDetails":{ - "name":"GetJobDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobDetailsInput"}, - "output":{"shape":"GetJobDetailsOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"JobNotFoundException"} - ], - "documentation":"

Returns information about a job. Only used for custom actions.

When this API is called, AWS CodePipeline returns temporary credentials for the Amazon S3 bucket used to store artifacts for the pipeline, if the action requires access to that Amazon S3 bucket for input or output artifacts. Additionally, this API returns any secret values defined for the action.

" - }, - "GetPipeline":{ - "name":"GetPipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPipelineInput"}, - "output":{"shape":"GetPipelineOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"PipelineVersionNotFoundException"} - ], - "documentation":"

Returns the metadata, structure, stages, and actions of a pipeline. Can be used to return the entire structure of a pipeline in JSON format, which can then be modified and used to update the pipeline structure with UpdatePipeline.

" - }, - "GetPipelineExecution":{ - "name":"GetPipelineExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPipelineExecutionInput"}, - "output":{"shape":"GetPipelineExecutionOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"PipelineExecutionNotFoundException"} - ], - "documentation":"

Returns information about an execution of a pipeline, including details about artifacts, the pipeline execution ID, and the name, version, and status of the pipeline.

" - }, - "GetPipelineState":{ - "name":"GetPipelineState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPipelineStateInput"}, - "output":{"shape":"GetPipelineStateOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"} - ], - "documentation":"

Returns information about the state of a pipeline, including the stages and actions.

" - }, - "GetThirdPartyJobDetails":{ - "name":"GetThirdPartyJobDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetThirdPartyJobDetailsInput"}, - "output":{"shape":"GetThirdPartyJobDetailsOutput"}, - "errors":[ - {"shape":"JobNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidClientTokenException"}, - {"shape":"InvalidJobException"} - ], - "documentation":"

Requests the details of a job for a third party action. Only used for partner actions.

When this API is called, AWS CodePipeline returns temporary credentials for the Amazon S3 bucket used to store artifacts for the pipeline, if the action requires access to that Amazon S3 bucket for input or output artifacts. Additionally, this API returns any secret values defined for the action.

" - }, - "ListActionTypes":{ - "name":"ListActionTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListActionTypesInput"}, - "output":{"shape":"ListActionTypesOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets a summary of all AWS CodePipeline action types associated with your account.

" - }, - "ListPipelineExecutions":{ - "name":"ListPipelineExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPipelineExecutionsInput"}, - "output":{"shape":"ListPipelineExecutionsOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets a summary of the most recent executions for a pipeline.

" - }, - "ListPipelines":{ - "name":"ListPipelines", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPipelinesInput"}, - "output":{"shape":"ListPipelinesOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets a summary of all of the pipelines associated with your account.

" - }, - "ListWebhooks":{ - "name":"ListWebhooks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWebhooksInput"}, - "output":{"shape":"ListWebhooksOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets a listing of all the webhooks in this region for this account. The output lists all webhooks and includes the webhook URL and ARN, as well the configuration for each webhook.

" - }, - "PollForJobs":{ - "name":"PollForJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PollForJobsInput"}, - "output":{"shape":"PollForJobsOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ActionTypeNotFoundException"} - ], - "documentation":"

Returns information about any jobs for AWS CodePipeline to act upon. PollForJobs is only valid for action types with \"Custom\" in the owner field. If the action type contains \"AWS\" or \"ThirdParty\" in the owner field, the PollForJobs action returns an error.

When this API is called, AWS CodePipeline returns temporary credentials for the Amazon S3 bucket used to store artifacts for the pipeline, if the action requires access to that Amazon S3 bucket for input or output artifacts. Additionally, this API returns any secret values defined for the action.

" - }, - "PollForThirdPartyJobs":{ - "name":"PollForThirdPartyJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PollForThirdPartyJobsInput"}, - "output":{"shape":"PollForThirdPartyJobsOutput"}, - "errors":[ - {"shape":"ActionTypeNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Determines whether there are any third party jobs for a job worker to act on. Only used for partner actions.

When this API is called, AWS CodePipeline returns temporary credentials for the Amazon S3 bucket used to store artifacts for the pipeline, if the action requires access to that Amazon S3 bucket for input or output artifacts.

" - }, - "PutActionRevision":{ - "name":"PutActionRevision", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutActionRevisionInput"}, - "output":{"shape":"PutActionRevisionOutput"}, - "errors":[ - {"shape":"PipelineNotFoundException"}, - {"shape":"StageNotFoundException"}, - {"shape":"ActionNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Provides information to AWS CodePipeline about new revisions to a source.

" - }, - "PutApprovalResult":{ - "name":"PutApprovalResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutApprovalResultInput"}, - "output":{"shape":"PutApprovalResultOutput"}, - "errors":[ - {"shape":"InvalidApprovalTokenException"}, - {"shape":"ApprovalAlreadyCompletedException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"StageNotFoundException"}, - {"shape":"ActionNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Provides the response to a manual approval request to AWS CodePipeline. Valid responses include Approved and Rejected.

" - }, - "PutJobFailureResult":{ - "name":"PutJobFailureResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutJobFailureResultInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InvalidJobStateException"} - ], - "documentation":"

Represents the failure of a job as returned to the pipeline by a job worker. Only used for custom actions.

" - }, - "PutJobSuccessResult":{ - "name":"PutJobSuccessResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutJobSuccessResultInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InvalidJobStateException"} - ], - "documentation":"

Represents the success of a job as returned to the pipeline by a job worker. Only used for custom actions.

" - }, - "PutThirdPartyJobFailureResult":{ - "name":"PutThirdPartyJobFailureResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutThirdPartyJobFailureResultInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"InvalidClientTokenException"} - ], - "documentation":"

Represents the failure of a third party job as returned to the pipeline by a job worker. Only used for partner actions.

" - }, - "PutThirdPartyJobSuccessResult":{ - "name":"PutThirdPartyJobSuccessResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutThirdPartyJobSuccessResultInput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"InvalidClientTokenException"} - ], - "documentation":"

Represents the success of a third party job as returned to the pipeline by a job worker. Only used for partner actions.

" - }, - "PutWebhook":{ - "name":"PutWebhook", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutWebhookInput"}, - "output":{"shape":"PutWebhookOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidWebhookFilterPatternException"}, - {"shape":"InvalidWebhookAuthenticationParametersException"}, - {"shape":"PipelineNotFoundException"} - ], - "documentation":"

Defines a webhook and returns a unique webhook URL generated by CodePipeline. This URL can be supplied to third party source hosting providers to call every time there's a code change. When CodePipeline receives a POST request on this URL, the pipeline defined in the webhook is started as long as the POST request satisfied the authentication and filtering requirements supplied when defining the webhook. RegisterWebhookWithThirdParty and DeregisterWebhookWithThirdParty APIs can be used to automatically configure supported third parties to call the generated webhook URL.

" - }, - "RegisterWebhookWithThirdParty":{ - "name":"RegisterWebhookWithThirdParty", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterWebhookWithThirdPartyInput"}, - "output":{"shape":"RegisterWebhookWithThirdPartyOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"WebhookNotFoundException"} - ], - "documentation":"

Configures a connection between the webhook that was created and the external tool with events to be detected.

" - }, - "RetryStageExecution":{ - "name":"RetryStageExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetryStageExecutionInput"}, - "output":{"shape":"RetryStageExecutionOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"}, - {"shape":"StageNotFoundException"}, - {"shape":"StageNotRetryableException"}, - {"shape":"NotLatestPipelineExecutionException"} - ], - "documentation":"

Resumes the pipeline execution by retrying the last failed actions in a stage.

" - }, - "StartPipelineExecution":{ - "name":"StartPipelineExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartPipelineExecutionInput"}, - "output":{"shape":"StartPipelineExecutionOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"PipelineNotFoundException"} - ], - "documentation":"

Starts the specified pipeline. Specifically, it begins processing the latest commit to the source location specified as part of the pipeline.

" - }, - "UpdatePipeline":{ - "name":"UpdatePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePipelineInput"}, - "output":{"shape":"UpdatePipelineOutput"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidStageDeclarationException"}, - {"shape":"InvalidActionDeclarationException"}, - {"shape":"InvalidBlockerDeclarationException"}, - {"shape":"InvalidStructureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Updates a specified pipeline with edits or changes to its structure. Use a JSON file with the pipeline structure in conjunction with UpdatePipeline to provide the full structure of the pipeline. Updating the pipeline increases the version number of the pipeline by 1.

" - } - }, - "shapes":{ - "AWSSessionCredentials":{ - "type":"structure", - "required":[ - "accessKeyId", - "secretAccessKey", - "sessionToken" - ], - "members":{ - "accessKeyId":{ - "shape":"AccessKeyId", - "documentation":"

The access key for the session.

" - }, - "secretAccessKey":{ - "shape":"SecretAccessKey", - "documentation":"

The secret access key for the session.

" - }, - "sessionToken":{ - "shape":"SessionToken", - "documentation":"

The token for the session.

" - } - }, - "documentation":"

Represents an AWS session credentials object. These credentials are temporary credentials that are issued by AWS Secure Token Service (STS). They can be used to access input and output artifacts in the Amazon S3 bucket used to store artifact for the pipeline in AWS CodePipeline.

", - "sensitive":true - }, - "AccessKeyId":{"type":"string"}, - "AccountId":{ - "type":"string", - "pattern":"[0-9]{12}" - }, - "AcknowledgeJobInput":{ - "type":"structure", - "required":[ - "jobId", - "nonce" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID of the job for which you want to confirm receipt.

" - }, - "nonce":{ - "shape":"Nonce", - "documentation":"

A system-generated random number that AWS CodePipeline uses to ensure that the job is being worked on by only one job worker. Get this number from the response of the PollForJobs request that returned this job.

" - } - }, - "documentation":"

Represents the input of an AcknowledgeJob action.

" - }, - "AcknowledgeJobOutput":{ - "type":"structure", - "members":{ - "status":{ - "shape":"JobStatus", - "documentation":"

Whether the job worker has received the specified job.

" - } - }, - "documentation":"

Represents the output of an AcknowledgeJob action.

" - }, - "AcknowledgeThirdPartyJobInput":{ - "type":"structure", - "required":[ - "jobId", - "nonce", - "clientToken" - ], - "members":{ - "jobId":{ - "shape":"ThirdPartyJobId", - "documentation":"

The unique system-generated ID of the job.

" - }, - "nonce":{ - "shape":"Nonce", - "documentation":"

A system-generated random number that AWS CodePipeline uses to ensure that the job is being worked on by only one job worker. Get this number from the response to a GetThirdPartyJobDetails request.

" - }, - "clientToken":{ - "shape":"ClientToken", - "documentation":"

The clientToken portion of the clientId and clientToken pair used to verify that the calling entity is allowed access to the job and its details.

" - } - }, - "documentation":"

Represents the input of an AcknowledgeThirdPartyJob action.

" - }, - "AcknowledgeThirdPartyJobOutput":{ - "type":"structure", - "members":{ - "status":{ - "shape":"JobStatus", - "documentation":"

The status information for the third party job, if any.

" - } - }, - "documentation":"

Represents the output of an AcknowledgeThirdPartyJob action.

" - }, - "ActionCategory":{ - "type":"string", - "enum":[ - "Source", - "Build", - "Deploy", - "Test", - "Invoke", - "Approval" - ] - }, - "ActionConfiguration":{ - "type":"structure", - "members":{ - "configuration":{ - "shape":"ActionConfigurationMap", - "documentation":"

The configuration data for the action.

" - } - }, - "documentation":"

Represents information about an action configuration.

" - }, - "ActionConfigurationKey":{ - "type":"string", - "max":50, - "min":1 - }, - "ActionConfigurationMap":{ - "type":"map", - "key":{"shape":"ActionConfigurationKey"}, - "value":{"shape":"ActionConfigurationValue"} - }, - "ActionConfigurationProperty":{ - "type":"structure", - "required":[ - "name", - "required", - "key", - "secret" - ], - "members":{ - "name":{ - "shape":"ActionConfigurationKey", - "documentation":"

The name of the action configuration property.

" - }, - "required":{ - "shape":"Boolean", - "documentation":"

Whether the configuration property is a required value.

" - }, - "key":{ - "shape":"Boolean", - "documentation":"

Whether the configuration property is a key.

" - }, - "secret":{ - "shape":"Boolean", - "documentation":"

Whether the configuration property is secret. Secrets are hidden from all calls except for GetJobDetails, GetThirdPartyJobDetails, PollForJobs, and PollForThirdPartyJobs.

When updating a pipeline, passing * * * * * without changing any other values of the action will preserve the prior value of the secret.

" - }, - "queryable":{ - "shape":"Boolean", - "documentation":"

Indicates that the property will be used in conjunction with PollForJobs. When creating a custom action, an action can have up to one queryable property. If it has one, that property must be both required and not secret.

If you create a pipeline with a custom action type, and that custom action contains a queryable property, the value for that configuration property is subject to additional restrictions. The value must be less than or equal to twenty (20) characters. The value can contain only alphanumeric characters, underscores, and hyphens.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the action configuration property that will be displayed to users.

" - }, - "type":{ - "shape":"ActionConfigurationPropertyType", - "documentation":"

The type of the configuration property.

" - } - }, - "documentation":"

Represents information about an action configuration property.

" - }, - "ActionConfigurationPropertyList":{ - "type":"list", - "member":{"shape":"ActionConfigurationProperty"}, - "max":10 - }, - "ActionConfigurationPropertyType":{ - "type":"string", - "enum":[ - "String", - "Number", - "Boolean" - ] - }, - "ActionConfigurationQueryableValue":{ - "type":"string", - "max":50, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "ActionConfigurationValue":{ - "type":"string", - "max":1000, - "min":1 - }, - "ActionContext":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ActionName", - "documentation":"

The name of the action within the context of a job.

" - } - }, - "documentation":"

Represents the context of an action within the stage of a pipeline to a job worker.

" - }, - "ActionDeclaration":{ - "type":"structure", - "required":[ - "name", - "actionTypeId" - ], - "members":{ - "name":{ - "shape":"ActionName", - "documentation":"

The action declaration's name.

" - }, - "actionTypeId":{ - "shape":"ActionTypeId", - "documentation":"

The configuration information for the action type.

" - }, - "runOrder":{ - "shape":"ActionRunOrder", - "documentation":"

The order in which actions are run.

" - }, - "configuration":{ - "shape":"ActionConfigurationMap", - "documentation":"

The action declaration's configuration.

" - }, - "outputArtifacts":{ - "shape":"OutputArtifactList", - "documentation":"

The name or ID of the result of the action declaration, such as a test or build artifact.

" - }, - "inputArtifacts":{ - "shape":"InputArtifactList", - "documentation":"

The name or ID of the artifact consumed by the action, such as a test or build artifact.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the IAM service role that will perform the declared action. This is assumed through the roleArn for the pipeline.

" - } - }, - "documentation":"

Represents information about an action declaration.

" - }, - "ActionExecution":{ - "type":"structure", - "members":{ - "status":{ - "shape":"ActionExecutionStatus", - "documentation":"

The status of the action, or for a completed action, the last status of the action.

" - }, - "summary":{ - "shape":"ExecutionSummary", - "documentation":"

A summary of the run of the action.

" - }, - "lastStatusChange":{ - "shape":"Timestamp", - "documentation":"

The last status change of the action.

" - }, - "token":{ - "shape":"ActionExecutionToken", - "documentation":"

The system-generated token used to identify a unique approval request. The token for each open approval request can be obtained using the GetPipelineState command and is used to validate that the approval request corresponding to this token is still valid.

" - }, - "lastUpdatedBy":{ - "shape":"LastUpdatedBy", - "documentation":"

The ARN of the user who last changed the pipeline.

" - }, - "externalExecutionId":{ - "shape":"ExecutionId", - "documentation":"

The external ID of the run of the action.

" - }, - "externalExecutionUrl":{ - "shape":"Url", - "documentation":"

The URL of a resource external to AWS that will be used when running the action, for example an external repository URL.

" - }, - "percentComplete":{ - "shape":"Percentage", - "documentation":"

A percentage of completeness of the action as it runs.

" - }, - "errorDetails":{ - "shape":"ErrorDetails", - "documentation":"

The details of an error returned by a URL external to AWS.

" - } - }, - "documentation":"

Represents information about the run of an action.

" - }, - "ActionExecutionStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Succeeded", - "Failed" - ] - }, - "ActionExecutionToken":{"type":"string"}, - "ActionName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[A-Za-z0-9.@\\-_]+" - }, - "ActionNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified action cannot be found.

", - "exception":true - }, - "ActionOwner":{ - "type":"string", - "enum":[ - "AWS", - "ThirdParty", - "Custom" - ] - }, - "ActionProvider":{ - "type":"string", - "max":25, - "min":1, - "pattern":"[0-9A-Za-z_-]+" - }, - "ActionRevision":{ - "type":"structure", - "required":[ - "revisionId", - "revisionChangeId", - "created" - ], - "members":{ - "revisionId":{ - "shape":"Revision", - "documentation":"

The system-generated unique ID that identifies the revision number of the action.

" - }, - "revisionChangeId":{ - "shape":"RevisionChangeIdentifier", - "documentation":"

The unique identifier of the change that set the state to this revision, for example a deployment ID or timestamp.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

The date and time when the most recent version of the action was created, in timestamp format.

" - } - }, - "documentation":"

Represents information about the version (or revision) of an action.

" - }, - "ActionRunOrder":{ - "type":"integer", - "max":999, - "min":1 - }, - "ActionState":{ - "type":"structure", - "members":{ - "actionName":{ - "shape":"ActionName", - "documentation":"

The name of the action.

" - }, - "currentRevision":{ - "shape":"ActionRevision", - "documentation":"

Represents information about the version (or revision) of an action.

" - }, - "latestExecution":{ - "shape":"ActionExecution", - "documentation":"

Represents information about the run of an action.

" - }, - "entityUrl":{ - "shape":"Url", - "documentation":"

A URL link for more information about the state of the action, such as a deployment group details page.

" - }, - "revisionUrl":{ - "shape":"Url", - "documentation":"

A URL link for more information about the revision, such as a commit details page.

" - } - }, - "documentation":"

Represents information about the state of an action.

" - }, - "ActionStateList":{ - "type":"list", - "member":{"shape":"ActionState"} - }, - "ActionType":{ - "type":"structure", - "required":[ - "id", - "inputArtifactDetails", - "outputArtifactDetails" - ], - "members":{ - "id":{ - "shape":"ActionTypeId", - "documentation":"

Represents information about an action type.

" - }, - "settings":{ - "shape":"ActionTypeSettings", - "documentation":"

The settings for the action type.

" - }, - "actionConfigurationProperties":{ - "shape":"ActionConfigurationPropertyList", - "documentation":"

The configuration properties for the action type.

" - }, - "inputArtifactDetails":{ - "shape":"ArtifactDetails", - "documentation":"

The details of the input artifact for the action, such as its commit ID.

" - }, - "outputArtifactDetails":{ - "shape":"ArtifactDetails", - "documentation":"

The details of the output artifact of the action, such as its commit ID.

" - } - }, - "documentation":"

Returns information about the details of an action type.

" - }, - "ActionTypeId":{ - "type":"structure", - "required":[ - "category", - "owner", - "provider", - "version" - ], - "members":{ - "category":{ - "shape":"ActionCategory", - "documentation":"

A category defines what kind of action can be taken in the stage, and constrains the provider type for the action. Valid categories are limited to one of the values below.

" - }, - "owner":{ - "shape":"ActionOwner", - "documentation":"

The creator of the action being called.

" - }, - "provider":{ - "shape":"ActionProvider", - "documentation":"

The provider of the service being called by the action. Valid providers are determined by the action category. For example, an action in the Deploy category type might have a provider of AWS CodeDeploy, which would be specified as CodeDeploy.

" - }, - "version":{ - "shape":"Version", - "documentation":"

A string that describes the action version.

" - } - }, - "documentation":"

Represents information about an action type.

" - }, - "ActionTypeList":{ - "type":"list", - "member":{"shape":"ActionType"} - }, - "ActionTypeNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified action type cannot be found.

", - "exception":true - }, - "ActionTypeSettings":{ - "type":"structure", - "members":{ - "thirdPartyConfigurationUrl":{ - "shape":"Url", - "documentation":"

The URL of a sign-up page where users can sign up for an external service and perform initial configuration of the action provided by that service.

" - }, - "entityUrlTemplate":{ - "shape":"UrlTemplate", - "documentation":"

The URL returned to the AWS CodePipeline console that provides a deep link to the resources of the external system, such as the configuration page for an AWS CodeDeploy deployment group. This link is provided as part of the action display within the pipeline.

" - }, - "executionUrlTemplate":{ - "shape":"UrlTemplate", - "documentation":"

The URL returned to the AWS CodePipeline console that contains a link to the top-level landing page for the external system, such as console page for AWS CodeDeploy. This link is shown on the pipeline view page in the AWS CodePipeline console and provides a link to the execution entity of the external action.

" - }, - "revisionUrlTemplate":{ - "shape":"UrlTemplate", - "documentation":"

The URL returned to the AWS CodePipeline console that contains a link to the page where customers can update or change the configuration of the external action.

" - } - }, - "documentation":"

Returns information about the settings for an action type.

" - }, - "ApprovalAlreadyCompletedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The approval action has already been approved or rejected.

", - "exception":true - }, - "ApprovalResult":{ - "type":"structure", - "required":[ - "summary", - "status" - ], - "members":{ - "summary":{ - "shape":"ApprovalSummary", - "documentation":"

The summary of the current status of the approval request.

" - }, - "status":{ - "shape":"ApprovalStatus", - "documentation":"

The response submitted by a reviewer assigned to an approval action request.

" - } - }, - "documentation":"

Represents information about the result of an approval request.

" - }, - "ApprovalStatus":{ - "type":"string", - "enum":[ - "Approved", - "Rejected" - ] - }, - "ApprovalSummary":{ - "type":"string", - "max":512, - "min":0 - }, - "ApprovalToken":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "Artifact":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ArtifactName", - "documentation":"

The artifact's name.

" - }, - "revision":{ - "shape":"Revision", - "documentation":"

The artifact's revision ID. Depending on the type of object, this could be a commit ID (GitHub) or a revision ID (Amazon S3).

" - }, - "location":{ - "shape":"ArtifactLocation", - "documentation":"

The location of an artifact.

" - } - }, - "documentation":"

Represents information about an artifact that will be worked upon by actions in the pipeline.

" - }, - "ArtifactDetails":{ - "type":"structure", - "required":[ - "minimumCount", - "maximumCount" - ], - "members":{ - "minimumCount":{ - "shape":"MinimumArtifactCount", - "documentation":"

The minimum number of artifacts allowed for the action type.

" - }, - "maximumCount":{ - "shape":"MaximumArtifactCount", - "documentation":"

The maximum number of artifacts allowed for the action type.

" - } - }, - "documentation":"

Returns information about the details of an artifact.

" - }, - "ArtifactList":{ - "type":"list", - "member":{"shape":"Artifact"} - }, - "ArtifactLocation":{ - "type":"structure", - "members":{ - "type":{ - "shape":"ArtifactLocationType", - "documentation":"

The type of artifact in the location.

" - }, - "s3Location":{ - "shape":"S3ArtifactLocation", - "documentation":"

The Amazon S3 bucket that contains the artifact.

" - } - }, - "documentation":"

Represents information about the location of an artifact.

" - }, - "ArtifactLocationType":{ - "type":"string", - "enum":["S3"] - }, - "ArtifactName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[a-zA-Z0-9_\\-]+" - }, - "ArtifactRevision":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ArtifactName", - "documentation":"

The name of an artifact. This name might be system-generated, such as \"MyApp\", or might be defined by the user when an action is created.

" - }, - "revisionId":{ - "shape":"Revision", - "documentation":"

The revision ID of the artifact.

" - }, - "revisionChangeIdentifier":{ - "shape":"RevisionChangeIdentifier", - "documentation":"

An additional identifier for a revision, such as a commit date or, for artifacts stored in Amazon S3 buckets, the ETag value.

" - }, - "revisionSummary":{ - "shape":"RevisionSummary", - "documentation":"

Summary information about the most recent revision of the artifact. For GitHub and AWS CodeCommit repositories, the commit message. For Amazon S3 buckets or actions, the user-provided content of a codepipeline-artifact-revision-summary key specified in the object metadata.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

The date and time when the most recent revision of the artifact was created, in timestamp format.

" - }, - "revisionUrl":{ - "shape":"Url", - "documentation":"

The commit ID for the artifact revision. For artifacts stored in GitHub or AWS CodeCommit repositories, the commit ID is linked to a commit details page.

" - } - }, - "documentation":"

Represents revision details of an artifact.

" - }, - "ArtifactRevisionList":{ - "type":"list", - "member":{"shape":"ArtifactRevision"} - }, - "ArtifactStore":{ - "type":"structure", - "required":[ - "type", - "location" - ], - "members":{ - "type":{ - "shape":"ArtifactStoreType", - "documentation":"

The type of the artifact store, such as S3.

" - }, - "location":{ - "shape":"ArtifactStoreLocation", - "documentation":"

The Amazon S3 bucket used for storing the artifacts for a pipeline. You can specify the name of an S3 bucket but not a folder within the bucket. A folder to contain the pipeline artifacts is created for you based on the name of the pipeline. You can use any Amazon S3 bucket in the same AWS Region as the pipeline to store your pipeline artifacts.

" - }, - "encryptionKey":{ - "shape":"EncryptionKey", - "documentation":"

The encryption key used to encrypt the data in the artifact store, such as an AWS Key Management Service (AWS KMS) key. If this is undefined, the default key for Amazon S3 is used.

" - } - }, - "documentation":"

The Amazon S3 bucket where artifacts are stored for the pipeline.

" - }, - "ArtifactStoreLocation":{ - "type":"string", - "max":63, - "min":3, - "pattern":"[a-zA-Z0-9\\-\\.]+" - }, - "ArtifactStoreType":{ - "type":"string", - "enum":["S3"] - }, - "BlockerDeclaration":{ - "type":"structure", - "required":[ - "name", - "type" - ], - "members":{ - "name":{ - "shape":"BlockerName", - "documentation":"

Reserved for future use.

" - }, - "type":{ - "shape":"BlockerType", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

Reserved for future use.

" - }, - "BlockerName":{ - "type":"string", - "max":100, - "min":1 - }, - "BlockerType":{ - "type":"string", - "enum":["Schedule"] - }, - "Boolean":{"type":"boolean"}, - "ClientId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "ClientToken":{ - "type":"string", - "max":256, - "min":1 - }, - "Code":{"type":"string"}, - "ContinuationToken":{ - "type":"string", - "max":2048, - "min":1 - }, - "CreateCustomActionTypeInput":{ - "type":"structure", - "required":[ - "category", - "provider", - "version", - "inputArtifactDetails", - "outputArtifactDetails" - ], - "members":{ - "category":{ - "shape":"ActionCategory", - "documentation":"

The category of the custom action, such as a build action or a test action.

Although Source and Approval are listed as valid values, they are not currently functional. These values are reserved for future use.

" - }, - "provider":{ - "shape":"ActionProvider", - "documentation":"

The provider of the service used in the custom action, such as AWS CodeDeploy.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version identifier of the custom action.

" - }, - "settings":{ - "shape":"ActionTypeSettings", - "documentation":"

Returns information about the settings for an action type.

" - }, - "configurationProperties":{ - "shape":"ActionConfigurationPropertyList", - "documentation":"

The configuration properties for the custom action.

You can refer to a name in the configuration properties of the custom action within the URL templates by following the format of {Config:name}, as long as the configuration property is both required and not secret. For more information, see Create a Custom Action for a Pipeline.

" - }, - "inputArtifactDetails":{ - "shape":"ArtifactDetails", - "documentation":"

The details of the input artifact for the action, such as its commit ID.

" - }, - "outputArtifactDetails":{ - "shape":"ArtifactDetails", - "documentation":"

The details of the output artifact of the action, such as its commit ID.

" - } - }, - "documentation":"

Represents the input of a CreateCustomActionType operation.

" - }, - "CreateCustomActionTypeOutput":{ - "type":"structure", - "required":["actionType"], - "members":{ - "actionType":{ - "shape":"ActionType", - "documentation":"

Returns information about the details of an action type.

" - } - }, - "documentation":"

Represents the output of a CreateCustomActionType operation.

" - }, - "CreatePipelineInput":{ - "type":"structure", - "required":["pipeline"], - "members":{ - "pipeline":{ - "shape":"PipelineDeclaration", - "documentation":"

Represents the structure of actions and stages to be performed in the pipeline.

" - } - }, - "documentation":"

Represents the input of a CreatePipeline action.

" - }, - "CreatePipelineOutput":{ - "type":"structure", - "members":{ - "pipeline":{ - "shape":"PipelineDeclaration", - "documentation":"

Represents the structure of actions and stages to be performed in the pipeline.

" - } - }, - "documentation":"

Represents the output of a CreatePipeline action.

" - }, - "CurrentRevision":{ - "type":"structure", - "required":[ - "revision", - "changeIdentifier" - ], - "members":{ - "revision":{ - "shape":"Revision", - "documentation":"

The revision ID of the current version of an artifact.

" - }, - "changeIdentifier":{ - "shape":"RevisionChangeIdentifier", - "documentation":"

The change identifier for the current revision.

" - }, - "created":{ - "shape":"Time", - "documentation":"

The date and time when the most recent revision of the artifact was created, in timestamp format.

" - }, - "revisionSummary":{ - "shape":"RevisionSummary", - "documentation":"

The summary of the most recent revision of the artifact.

" - } - }, - "documentation":"

Represents information about a current revision.

" - }, - "DeleteCustomActionTypeInput":{ - "type":"structure", - "required":[ - "category", - "provider", - "version" - ], - "members":{ - "category":{ - "shape":"ActionCategory", - "documentation":"

The category of the custom action that you want to delete, such as source or deploy.

" - }, - "provider":{ - "shape":"ActionProvider", - "documentation":"

The provider of the service used in the custom action, such as AWS CodeDeploy.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the custom action to delete.

" - } - }, - "documentation":"

Represents the input of a DeleteCustomActionType operation. The custom action will be marked as deleted.

" - }, - "DeletePipelineInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline to be deleted.

" - } - }, - "documentation":"

Represents the input of a DeletePipeline action.

" - }, - "DeleteWebhookInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"WebhookName", - "documentation":"

The name of the webhook you want to delete.

" - } - } - }, - "DeleteWebhookOutput":{ - "type":"structure", - "members":{ - } - }, - "DeregisterWebhookWithThirdPartyInput":{ - "type":"structure", - "members":{ - "webhookName":{ - "shape":"WebhookName", - "documentation":"

The name of the webhook you want to deregister.

" - } - } - }, - "DeregisterWebhookWithThirdPartyOutput":{ - "type":"structure", - "members":{ - } - }, - "Description":{ - "type":"string", - "max":160, - "min":1 - }, - "DisableStageTransitionInput":{ - "type":"structure", - "required":[ - "pipelineName", - "stageName", - "transitionType", - "reason" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline in which you want to disable the flow of artifacts from one stage to another.

" - }, - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the stage where you want to disable the inbound or outbound transition of artifacts.

" - }, - "transitionType":{ - "shape":"StageTransitionType", - "documentation":"

Specifies whether artifacts will be prevented from transitioning into the stage and being processed by the actions in that stage (inbound), or prevented from transitioning from the stage after they have been processed by the actions in that stage (outbound).

" - }, - "reason":{ - "shape":"DisabledReason", - "documentation":"

The reason given to the user why a stage is disabled, such as waiting for manual approval or manual tests. This message is displayed in the pipeline console UI.

" - } - }, - "documentation":"

Represents the input of a DisableStageTransition action.

" - }, - "DisabledReason":{ - "type":"string", - "max":300, - "min":1, - "pattern":"[a-zA-Z0-9!@ \\(\\)\\.\\*\\?\\-]+" - }, - "EnableStageTransitionInput":{ - "type":"structure", - "required":[ - "pipelineName", - "stageName", - "transitionType" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline in which you want to enable the flow of artifacts from one stage to another.

" - }, - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the stage where you want to enable the transition of artifacts, either into the stage (inbound) or from that stage to the next stage (outbound).

" - }, - "transitionType":{ - "shape":"StageTransitionType", - "documentation":"

Specifies whether artifacts will be allowed to enter the stage and be processed by the actions in that stage (inbound) or whether already-processed artifacts will be allowed to transition to the next stage (outbound).

" - } - }, - "documentation":"

Represents the input of an EnableStageTransition action.

" - }, - "Enabled":{"type":"boolean"}, - "EncryptionKey":{ - "type":"structure", - "required":[ - "id", - "type" - ], - "members":{ - "id":{ - "shape":"EncryptionKeyId", - "documentation":"

The ID used to identify the key. For an AWS KMS key, this is the key ID or key ARN.

" - }, - "type":{ - "shape":"EncryptionKeyType", - "documentation":"

The type of encryption key, such as an AWS Key Management Service (AWS KMS) key. When creating or updating a pipeline, the value must be set to 'KMS'.

" - } - }, - "documentation":"

Represents information about the key used to encrypt data in the artifact store, such as an AWS Key Management Service (AWS KMS) key.

" - }, - "EncryptionKeyId":{ - "type":"string", - "max":100, - "min":1 - }, - "EncryptionKeyType":{ - "type":"string", - "enum":["KMS"] - }, - "ErrorDetails":{ - "type":"structure", - "members":{ - "code":{ - "shape":"Code", - "documentation":"

The system ID or error number code of the error.

" - }, - "message":{ - "shape":"Message", - "documentation":"

The text of the error message.

" - } - }, - "documentation":"

Represents information about an error in AWS CodePipeline.

" - }, - "ExecutionDetails":{ - "type":"structure", - "members":{ - "summary":{ - "shape":"ExecutionSummary", - "documentation":"

The summary of the current status of the actions.

" - }, - "externalExecutionId":{ - "shape":"ExecutionId", - "documentation":"

The system-generated unique ID of this action used to identify this job worker in any external systems, such as AWS CodeDeploy.

" - }, - "percentComplete":{ - "shape":"Percentage", - "documentation":"

The percentage of work completed on the action, represented on a scale of zero to one hundred percent.

" - } - }, - "documentation":"

The details of the actions taken and results produced on an artifact as it passes through stages in the pipeline.

" - }, - "ExecutionId":{ - "type":"string", - "max":1500, - "min":1 - }, - "ExecutionSummary":{ - "type":"string", - "max":2048, - "min":1 - }, - "FailureDetails":{ - "type":"structure", - "required":[ - "type", - "message" - ], - "members":{ - "type":{ - "shape":"FailureType", - "documentation":"

The type of the failure.

" - }, - "message":{ - "shape":"Message", - "documentation":"

The message about the failure.

" - }, - "externalExecutionId":{ - "shape":"ExecutionId", - "documentation":"

The external ID of the run of the action that failed.

" - } - }, - "documentation":"

Represents information about failure details.

" - }, - "FailureType":{ - "type":"string", - "enum":[ - "JobFailed", - "ConfigurationError", - "PermissionError", - "RevisionOutOfSync", - "RevisionUnavailable", - "SystemUnavailable" - ] - }, - "GetJobDetailsInput":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID for the job.

" - } - }, - "documentation":"

Represents the input of a GetJobDetails action.

" - }, - "GetJobDetailsOutput":{ - "type":"structure", - "members":{ - "jobDetails":{ - "shape":"JobDetails", - "documentation":"

The details of the job.

If AWSSessionCredentials is used, a long-running job can call GetJobDetails again to obtain new credentials.

" - } - }, - "documentation":"

Represents the output of a GetJobDetails action.

" - }, - "GetPipelineExecutionInput":{ - "type":"structure", - "required":[ - "pipelineName", - "pipelineExecutionId" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline about which you want to get execution details.

" - }, - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the pipeline execution about which you want to get execution details.

" - } - }, - "documentation":"

Represents the input of a GetPipelineExecution action.

" - }, - "GetPipelineExecutionOutput":{ - "type":"structure", - "members":{ - "pipelineExecution":{ - "shape":"PipelineExecution", - "documentation":"

Represents information about the execution of a pipeline.

" - } - }, - "documentation":"

Represents the output of a GetPipelineExecution action.

" - }, - "GetPipelineInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline for which you want to get information. Pipeline names must be unique under an Amazon Web Services (AWS) user account.

" - }, - "version":{ - "shape":"PipelineVersion", - "documentation":"

The version number of the pipeline. If you do not specify a version, defaults to the most current version.

" - } - }, - "documentation":"

Represents the input of a GetPipeline action.

" - }, - "GetPipelineOutput":{ - "type":"structure", - "members":{ - "pipeline":{ - "shape":"PipelineDeclaration", - "documentation":"

Represents the structure of actions and stages to be performed in the pipeline.

" - }, - "metadata":{ - "shape":"PipelineMetadata", - "documentation":"

Represents the pipeline metadata information returned as part of the output of a GetPipeline action.

" - } - }, - "documentation":"

Represents the output of a GetPipeline action.

" - }, - "GetPipelineStateInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline about which you want to get information.

" - } - }, - "documentation":"

Represents the input of a GetPipelineState action.

" - }, - "GetPipelineStateOutput":{ - "type":"structure", - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline for which you want to get the state.

" - }, - "pipelineVersion":{ - "shape":"PipelineVersion", - "documentation":"

The version number of the pipeline.

A newly-created pipeline is always assigned a version number of 1.

" - }, - "stageStates":{ - "shape":"StageStateList", - "documentation":"

A list of the pipeline stage output information, including stage name, state, most recent run details, whether the stage is disabled, and other data.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

The date and time the pipeline was created, in timestamp format.

" - }, - "updated":{ - "shape":"Timestamp", - "documentation":"

The date and time the pipeline was last updated, in timestamp format.

" - } - }, - "documentation":"

Represents the output of a GetPipelineState action.

" - }, - "GetThirdPartyJobDetailsInput":{ - "type":"structure", - "required":[ - "jobId", - "clientToken" - ], - "members":{ - "jobId":{ - "shape":"ThirdPartyJobId", - "documentation":"

The unique system-generated ID used for identifying the job.

" - }, - "clientToken":{ - "shape":"ClientToken", - "documentation":"

The clientToken portion of the clientId and clientToken pair used to verify that the calling entity is allowed access to the job and its details.

" - } - }, - "documentation":"

Represents the input of a GetThirdPartyJobDetails action.

" - }, - "GetThirdPartyJobDetailsOutput":{ - "type":"structure", - "members":{ - "jobDetails":{ - "shape":"ThirdPartyJobDetails", - "documentation":"

The details of the job, including any protected values defined for the job.

" - } - }, - "documentation":"

Represents the output of a GetThirdPartyJobDetails action.

" - }, - "InputArtifact":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"ArtifactName", - "documentation":"

The name of the artifact to be worked on, for example, \"My App\".

The input artifact of an action must exactly match the output artifact declared in a preceding action, but the input artifact does not have to be the next action in strict sequence from the action that provided the output artifact. Actions in parallel can declare different output artifacts, which are in turn consumed by different following actions.

" - } - }, - "documentation":"

Represents information about an artifact to be worked on, such as a test or build artifact.

" - }, - "InputArtifactList":{ - "type":"list", - "member":{"shape":"InputArtifact"} - }, - "InvalidActionDeclarationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified action declaration was specified in an invalid format.

", - "exception":true - }, - "InvalidApprovalTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The approval request already received a response or has expired.

", - "exception":true - }, - "InvalidBlockerDeclarationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Reserved for future use.

", - "exception":true - }, - "InvalidClientTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The client token was specified in an invalid format

", - "exception":true - }, - "InvalidJobException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified job was specified in an invalid format or cannot be found.

", - "exception":true - }, - "InvalidJobStateException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified job state was specified in an invalid format.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The next token was specified in an invalid format. Make sure that the next token you provided is the token returned by a previous call.

", - "exception":true - }, - "InvalidNonceException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified nonce was specified in an invalid format.

", - "exception":true - }, - "InvalidStageDeclarationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified stage declaration was specified in an invalid format.

", - "exception":true - }, - "InvalidStructureException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified structure was specified in an invalid format.

", - "exception":true - }, - "InvalidWebhookAuthenticationParametersException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified authentication type is in an invalid format.

", - "exception":true - }, - "InvalidWebhookFilterPatternException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified event filter rule is in an invalid format.

", - "exception":true - }, - "Job":{ - "type":"structure", - "members":{ - "id":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID of the job.

" - }, - "data":{ - "shape":"JobData", - "documentation":"

Additional data about a job.

" - }, - "nonce":{ - "shape":"Nonce", - "documentation":"

A system-generated random number that AWS CodePipeline uses to ensure that the job is being worked on by only one job worker. Use this number in an AcknowledgeJob request.

" - }, - "accountId":{ - "shape":"AccountId", - "documentation":"

The ID of the AWS account to use when performing the job.

" - } - }, - "documentation":"

Represents information about a job.

" - }, - "JobData":{ - "type":"structure", - "members":{ - "actionTypeId":{ - "shape":"ActionTypeId", - "documentation":"

Represents information about an action type.

" - }, - "actionConfiguration":{ - "shape":"ActionConfiguration", - "documentation":"

Represents information about an action configuration.

" - }, - "pipelineContext":{ - "shape":"PipelineContext", - "documentation":"

Represents information about a pipeline to a job worker.

" - }, - "inputArtifacts":{ - "shape":"ArtifactList", - "documentation":"

The artifact supplied to the job.

" - }, - "outputArtifacts":{ - "shape":"ArtifactList", - "documentation":"

The output of the job.

" - }, - "artifactCredentials":{ - "shape":"AWSSessionCredentials", - "documentation":"

Represents an AWS session credentials object. These credentials are temporary credentials that are issued by AWS Secure Token Service (STS). They can be used to access input and output artifacts in the Amazon S3 bucket used to store artifact for the pipeline in AWS CodePipeline.

" - }, - "continuationToken":{ - "shape":"ContinuationToken", - "documentation":"

A system-generated token, such as a AWS CodeDeploy deployment ID, that a job requires in order to continue the job asynchronously.

" - }, - "encryptionKey":{ - "shape":"EncryptionKey", - "documentation":"

Represents information about the key used to encrypt data in the artifact store, such as an AWS Key Management Service (AWS KMS) key.

" - } - }, - "documentation":"

Represents additional information about a job required for a job worker to complete the job.

" - }, - "JobDetails":{ - "type":"structure", - "members":{ - "id":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID of the job.

" - }, - "data":{ - "shape":"JobData", - "documentation":"

Represents additional information about a job required for a job worker to complete the job.

" - }, - "accountId":{ - "shape":"AccountId", - "documentation":"

The AWS account ID associated with the job.

" - } - }, - "documentation":"

Represents information about the details of a job.

" - }, - "JobId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "JobList":{ - "type":"list", - "member":{"shape":"Job"} - }, - "JobNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified job was specified in an invalid format or cannot be found.

", - "exception":true - }, - "JobStatus":{ - "type":"string", - "enum":[ - "Created", - "Queued", - "Dispatched", - "InProgress", - "TimedOut", - "Succeeded", - "Failed" - ] - }, - "JsonPath":{ - "type":"string", - "max":150, - "min":1 - }, - "LastChangedAt":{"type":"timestamp"}, - "LastChangedBy":{"type":"string"}, - "LastUpdatedBy":{"type":"string"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of pipelines associated with the AWS account has exceeded the limit allowed for the account.

", - "exception":true - }, - "ListActionTypesInput":{ - "type":"structure", - "members":{ - "actionOwnerFilter":{ - "shape":"ActionOwner", - "documentation":"

Filters the list of action types to those created by a specified entity.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier that was returned from the previous list action types call, which can be used to return the next set of action types in the list.

" - } - }, - "documentation":"

Represents the input of a ListActionTypes action.

" - }, - "ListActionTypesOutput":{ - "type":"structure", - "required":["actionTypes"], - "members":{ - "actionTypes":{ - "shape":"ActionTypeList", - "documentation":"

Provides details of the action types.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the amount of returned information is significantly large, an identifier is also returned which can be used in a subsequent list action types call to return the next set of action types in the list.

" - } - }, - "documentation":"

Represents the output of a ListActionTypes action.

" - }, - "ListPipelineExecutionsInput":{ - "type":"structure", - "required":["pipelineName"], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline for which you want to get execution summary information.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned nextToken value. The available pipeline execution history is limited to the most recent 12 months, based on pipeline execution start times. Default value is 100.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token that was returned from the previous ListPipelineExecutions call, which can be used to return the next set of pipeline executions in the list.

" - } - }, - "documentation":"

Represents the input of a ListPipelineExecutions action.

" - }, - "ListPipelineExecutionsOutput":{ - "type":"structure", - "members":{ - "pipelineExecutionSummaries":{ - "shape":"PipelineExecutionSummaryList", - "documentation":"

A list of executions in the history of a pipeline.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used in the next ListPipelineExecutions call. To view all items in the list, continue to call this operation with each subsequent token until no more nextToken values are returned.

" - } - }, - "documentation":"

Represents the output of a ListPipelineExecutions action.

" - }, - "ListPipelinesInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

An identifier that was returned from the previous list pipelines call, which can be used to return the next set of pipelines in the list.

" - } - }, - "documentation":"

Represents the input of a ListPipelines action.

" - }, - "ListPipelinesOutput":{ - "type":"structure", - "members":{ - "pipelines":{ - "shape":"PipelineList", - "documentation":"

The list of pipelines.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the amount of returned information is significantly large, an identifier is also returned which can be used in a subsequent list pipelines call to return the next set of pipelines in the list.

" - } - }, - "documentation":"

Represents the output of a ListPipelines action.

" - }, - "ListWebhookItem":{ - "type":"structure", - "required":[ - "definition", - "url" - ], - "members":{ - "definition":{ - "shape":"WebhookDefinition", - "documentation":"

The detail returned for each webhook, such as the webhook authentication type and filter rules.

" - }, - "url":{ - "shape":"WebhookUrl", - "documentation":"

A unique URL generated by CodePipeline. When a POST request is made to this URL, the defined pipeline is started as long as the body of the post request satisfies the defined authentication and filtering conditions. Deleting and re-creating a webhook will make the old URL invalid and generate a new URL.

" - }, - "errorMessage":{ - "shape":"WebhookErrorMessage", - "documentation":"

The text of the error message about the webhook.

" - }, - "errorCode":{ - "shape":"WebhookErrorCode", - "documentation":"

The number code of the error.

" - }, - "lastTriggered":{ - "shape":"WebhookLastTriggered", - "documentation":"

The date and time a webhook was last successfully triggered, in timestamp format.

" - }, - "arn":{ - "shape":"WebhookArn", - "documentation":"

The Amazon Resource Name (ARN) of the webhook.

" - } - }, - "documentation":"

The detail returned for each webhook after listing webhooks, such as the webhook URL, the webhook name, and the webhook ARN.

" - }, - "ListWebhooksInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token that was returned from the previous ListWebhooks call, which can be used to return the next set of webhooks in the list.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned nextToken value.

" - } - } - }, - "ListWebhooksOutput":{ - "type":"structure", - "members":{ - "webhooks":{ - "shape":"WebhookList", - "documentation":"

The JSON detail returned for each webhook in the list output for the ListWebhooks call.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the amount of returned information is significantly large, an identifier is also returned and can be used in a subsequent ListWebhooks call to return the next set of webhooks in the list.

" - } - } - }, - "MatchEquals":{ - "type":"string", - "max":150, - "min":1 - }, - "MaxBatchSize":{ - "type":"integer", - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "MaximumArtifactCount":{ - "type":"integer", - "max":5, - "min":0 - }, - "Message":{ - "type":"string", - "max":5000, - "min":1 - }, - "MinimumArtifactCount":{ - "type":"integer", - "max":5, - "min":0 - }, - "NextToken":{ - "type":"string", - "max":2048, - "min":1 - }, - "Nonce":{ - "type":"string", - "max":50, - "min":1 - }, - "NotLatestPipelineExecutionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The stage has failed in a later run of the pipeline and the pipelineExecutionId associated with the request is out of date.

", - "exception":true - }, - "OutputArtifact":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"ArtifactName", - "documentation":"

The name of the output of an artifact, such as \"My App\".

The input artifact of an action must exactly match the output artifact declared in a preceding action, but the input artifact does not have to be the next action in strict sequence from the action that provided the output artifact. Actions in parallel can declare different output artifacts, which are in turn consumed by different following actions.

Output artifact names must be unique within a pipeline.

" - } - }, - "documentation":"

Represents information about the output of an action.

" - }, - "OutputArtifactList":{ - "type":"list", - "member":{"shape":"OutputArtifact"} - }, - "Percentage":{ - "type":"integer", - "max":100, - "min":0 - }, - "PipelineArn":{ - "type":"string", - "pattern":"arn:aws(-[\\w]+)*:codepipeline:.+:[0-9]{12}:.+" - }, - "PipelineContext":{ - "type":"structure", - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline. This is a user-specified value. Pipeline names must be unique across all pipeline names under an Amazon Web Services account.

" - }, - "stage":{ - "shape":"StageContext", - "documentation":"

The stage of the pipeline.

" - }, - "action":{ - "shape":"ActionContext", - "documentation":"

The context of an action to a job worker within the stage of a pipeline.

" - } - }, - "documentation":"

Represents information about a pipeline to a job worker.

" - }, - "PipelineDeclaration":{ - "type":"structure", - "required":[ - "name", - "roleArn", - "artifactStore", - "stages" - ], - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the action to be performed.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) for AWS CodePipeline to use to either perform actions with no actionRoleArn, or to use to assume roles for actions with an actionRoleArn.

" - }, - "artifactStore":{ - "shape":"ArtifactStore", - "documentation":"

Represents information about the Amazon S3 bucket where artifacts are stored for the pipeline.

" - }, - "stages":{ - "shape":"PipelineStageDeclarationList", - "documentation":"

The stage in which to perform the action.

" - }, - "version":{ - "shape":"PipelineVersion", - "documentation":"

The version number of the pipeline. A new pipeline always has a version number of 1. This number is automatically incremented when a pipeline is updated.

" - } - }, - "documentation":"

Represents the structure of actions and stages to be performed in the pipeline.

" - }, - "PipelineExecution":{ - "type":"structure", - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline that was executed.

" - }, - "pipelineVersion":{ - "shape":"PipelineVersion", - "documentation":"

The version number of the pipeline that was executed.

" - }, - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the pipeline execution.

" - }, - "status":{ - "shape":"PipelineExecutionStatus", - "documentation":"

The status of the pipeline execution.

  • InProgress: The pipeline execution is currently running.

  • Succeeded: The pipeline execution was completed successfully.

  • Superseded: While this pipeline execution was waiting for the next stage to be completed, a newer pipeline execution advanced and continued through the pipeline instead.

  • Failed: The pipeline execution was not completed successfully.

" - }, - "artifactRevisions":{ - "shape":"ArtifactRevisionList", - "documentation":"

A list of ArtifactRevision objects included in a pipeline execution.

" - } - }, - "documentation":"

Represents information about an execution of a pipeline.

" - }, - "PipelineExecutionId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "PipelineExecutionNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The pipeline execution was specified in an invalid format or cannot be found, or an execution ID does not belong to the specified pipeline.

", - "exception":true - }, - "PipelineExecutionStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Succeeded", - "Superseded", - "Failed" - ] - }, - "PipelineExecutionSummary":{ - "type":"structure", - "members":{ - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the pipeline execution.

" - }, - "status":{ - "shape":"PipelineExecutionStatus", - "documentation":"

The status of the pipeline execution.

  • InProgress: The pipeline execution is currently running.

  • Succeeded: The pipeline execution was completed successfully.

  • Superseded: While this pipeline execution was waiting for the next stage to be completed, a newer pipeline execution advanced and continued through the pipeline instead.

  • Failed: The pipeline execution was not completed successfully.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

The date and time when the pipeline execution began, in timestamp format.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The date and time of the last change to the pipeline execution, in timestamp format.

" - }, - "sourceRevisions":{"shape":"SourceRevisionList"} - }, - "documentation":"

Summary information about a pipeline execution.

" - }, - "PipelineExecutionSummaryList":{ - "type":"list", - "member":{"shape":"PipelineExecutionSummary"} - }, - "PipelineList":{ - "type":"list", - "member":{"shape":"PipelineSummary"} - }, - "PipelineMetadata":{ - "type":"structure", - "members":{ - "pipelineArn":{ - "shape":"PipelineArn", - "documentation":"

The Amazon Resource Name (ARN) of the pipeline.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

The date and time the pipeline was created, in timestamp format.

" - }, - "updated":{ - "shape":"Timestamp", - "documentation":"

The date and time the pipeline was last updated, in timestamp format.

" - } - }, - "documentation":"

Information about a pipeline.

" - }, - "PipelineName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[A-Za-z0-9.@\\-_]+" - }, - "PipelineNameInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified pipeline name is already in use.

", - "exception":true - }, - "PipelineNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified pipeline was specified in an invalid format or cannot be found.

", - "exception":true - }, - "PipelineStageDeclarationList":{ - "type":"list", - "member":{"shape":"StageDeclaration"} - }, - "PipelineSummary":{ - "type":"structure", - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline.

" - }, - "version":{ - "shape":"PipelineVersion", - "documentation":"

The version number of the pipeline.

" - }, - "created":{ - "shape":"Timestamp", - "documentation":"

The date and time the pipeline was created, in timestamp format.

" - }, - "updated":{ - "shape":"Timestamp", - "documentation":"

The date and time of the last update to the pipeline, in timestamp format.

" - } - }, - "documentation":"

Returns a summary of a pipeline.

" - }, - "PipelineVersion":{ - "type":"integer", - "min":1 - }, - "PipelineVersionNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified pipeline version was specified in an invalid format or cannot be found.

", - "exception":true - }, - "PollForJobsInput":{ - "type":"structure", - "required":["actionTypeId"], - "members":{ - "actionTypeId":{ - "shape":"ActionTypeId", - "documentation":"

Represents information about an action type.

" - }, - "maxBatchSize":{ - "shape":"MaxBatchSize", - "documentation":"

The maximum number of jobs to return in a poll for jobs call.

" - }, - "queryParam":{ - "shape":"QueryParamMap", - "documentation":"

A map of property names and values. For an action type with no queryable properties, this value must be null or an empty map. For an action type with a queryable property, you must supply that property as a key in the map. Only jobs whose action configuration matches the mapped value will be returned.

" - } - }, - "documentation":"

Represents the input of a PollForJobs action.

" - }, - "PollForJobsOutput":{ - "type":"structure", - "members":{ - "jobs":{ - "shape":"JobList", - "documentation":"

Information about the jobs to take action on.

" - } - }, - "documentation":"

Represents the output of a PollForJobs action.

" - }, - "PollForThirdPartyJobsInput":{ - "type":"structure", - "required":["actionTypeId"], - "members":{ - "actionTypeId":{ - "shape":"ActionTypeId", - "documentation":"

Represents information about an action type.

" - }, - "maxBatchSize":{ - "shape":"MaxBatchSize", - "documentation":"

The maximum number of jobs to return in a poll for jobs call.

" - } - }, - "documentation":"

Represents the input of a PollForThirdPartyJobs action.

" - }, - "PollForThirdPartyJobsOutput":{ - "type":"structure", - "members":{ - "jobs":{ - "shape":"ThirdPartyJobList", - "documentation":"

Information about the jobs to take action on.

" - } - }, - "documentation":"

Represents the output of a PollForThirdPartyJobs action.

" - }, - "PutActionRevisionInput":{ - "type":"structure", - "required":[ - "pipelineName", - "stageName", - "actionName", - "actionRevision" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline that will start processing the revision to the source.

" - }, - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the stage that contains the action that will act upon the revision.

" - }, - "actionName":{ - "shape":"ActionName", - "documentation":"

The name of the action that will process the revision.

" - }, - "actionRevision":{ - "shape":"ActionRevision", - "documentation":"

Represents information about the version (or revision) of an action.

" - } - }, - "documentation":"

Represents the input of a PutActionRevision action.

" - }, - "PutActionRevisionOutput":{ - "type":"structure", - "members":{ - "newRevision":{ - "shape":"Boolean", - "documentation":"

Indicates whether the artifact revision was previously used in an execution of the specified pipeline.

" - }, - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the current workflow state of the pipeline.

" - } - }, - "documentation":"

Represents the output of a PutActionRevision action.

" - }, - "PutApprovalResultInput":{ - "type":"structure", - "required":[ - "pipelineName", - "stageName", - "actionName", - "result", - "token" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline that contains the action.

" - }, - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the stage that contains the action.

" - }, - "actionName":{ - "shape":"ActionName", - "documentation":"

The name of the action for which approval is requested.

" - }, - "result":{ - "shape":"ApprovalResult", - "documentation":"

Represents information about the result of the approval request.

" - }, - "token":{ - "shape":"ApprovalToken", - "documentation":"

The system-generated token used to identify a unique approval request. The token for each open approval request can be obtained using the GetPipelineState action and is used to validate that the approval request corresponding to this token is still valid.

" - } - }, - "documentation":"

Represents the input of a PutApprovalResult action.

" - }, - "PutApprovalResultOutput":{ - "type":"structure", - "members":{ - "approvedAt":{ - "shape":"Timestamp", - "documentation":"

The timestamp showing when the approval or rejection was submitted.

" - } - }, - "documentation":"

Represents the output of a PutApprovalResult action.

" - }, - "PutJobFailureResultInput":{ - "type":"structure", - "required":[ - "jobId", - "failureDetails" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID of the job that failed. This is the same ID returned from PollForJobs.

" - }, - "failureDetails":{ - "shape":"FailureDetails", - "documentation":"

The details about the failure of a job.

" - } - }, - "documentation":"

Represents the input of a PutJobFailureResult action.

" - }, - "PutJobSuccessResultInput":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique system-generated ID of the job that succeeded. This is the same ID returned from PollForJobs.

" - }, - "currentRevision":{ - "shape":"CurrentRevision", - "documentation":"

The ID of the current revision of the artifact successfully worked upon by the job.

" - }, - "continuationToken":{ - "shape":"ContinuationToken", - "documentation":"

A token generated by a job worker, such as an AWS CodeDeploy deployment ID, that a successful job provides to identify a custom action in progress. Future jobs will use this token in order to identify the running instance of the action. It can be reused to return additional information about the progress of the custom action. When the action is complete, no continuation token should be supplied.

" - }, - "executionDetails":{ - "shape":"ExecutionDetails", - "documentation":"

The execution details of the successful job, such as the actions taken by the job worker.

" - } - }, - "documentation":"

Represents the input of a PutJobSuccessResult action.

" - }, - "PutThirdPartyJobFailureResultInput":{ - "type":"structure", - "required":[ - "jobId", - "clientToken", - "failureDetails" - ], - "members":{ - "jobId":{ - "shape":"ThirdPartyJobId", - "documentation":"

The ID of the job that failed. This is the same ID returned from PollForThirdPartyJobs.

" - }, - "clientToken":{ - "shape":"ClientToken", - "documentation":"

The clientToken portion of the clientId and clientToken pair used to verify that the calling entity is allowed access to the job and its details.

" - }, - "failureDetails":{ - "shape":"FailureDetails", - "documentation":"

Represents information about failure details.

" - } - }, - "documentation":"

Represents the input of a PutThirdPartyJobFailureResult action.

" - }, - "PutThirdPartyJobSuccessResultInput":{ - "type":"structure", - "required":[ - "jobId", - "clientToken" - ], - "members":{ - "jobId":{ - "shape":"ThirdPartyJobId", - "documentation":"

The ID of the job that successfully completed. This is the same ID returned from PollForThirdPartyJobs.

" - }, - "clientToken":{ - "shape":"ClientToken", - "documentation":"

The clientToken portion of the clientId and clientToken pair used to verify that the calling entity is allowed access to the job and its details.

" - }, - "currentRevision":{ - "shape":"CurrentRevision", - "documentation":"

Represents information about a current revision.

" - }, - "continuationToken":{ - "shape":"ContinuationToken", - "documentation":"

A token generated by a job worker, such as an AWS CodeDeploy deployment ID, that a successful job provides to identify a partner action in progress. Future jobs will use this token in order to identify the running instance of the action. It can be reused to return additional information about the progress of the partner action. When the action is complete, no continuation token should be supplied.

" - }, - "executionDetails":{ - "shape":"ExecutionDetails", - "documentation":"

The details of the actions taken and results produced on an artifact as it passes through stages in the pipeline.

" - } - }, - "documentation":"

Represents the input of a PutThirdPartyJobSuccessResult action.

" - }, - "PutWebhookInput":{ - "type":"structure", - "required":["webhook"], - "members":{ - "webhook":{ - "shape":"WebhookDefinition", - "documentation":"

The detail provided in an input file to create the webhook, such as the webhook name, the pipeline name, and the action name. Give the webhook a unique name which identifies the webhook being defined. You may choose to name the webhook after the pipeline and action it targets so that you can easily recognize what it's used for later.

" - } - } - }, - "PutWebhookOutput":{ - "type":"structure", - "members":{ - "webhook":{ - "shape":"ListWebhookItem", - "documentation":"

The detail returned from creating the webhook, such as the webhook name, webhook URL, and webhook ARN.

" - } - } - }, - "QueryParamMap":{ - "type":"map", - "key":{"shape":"ActionConfigurationKey"}, - "value":{"shape":"ActionConfigurationQueryableValue"}, - "max":1, - "min":0 - }, - "RegisterWebhookWithThirdPartyInput":{ - "type":"structure", - "members":{ - "webhookName":{ - "shape":"WebhookName", - "documentation":"

The name of an existing webhook created with PutWebhook to register with a supported third party.

" - } - } - }, - "RegisterWebhookWithThirdPartyOutput":{ - "type":"structure", - "members":{ - } - }, - "RetryStageExecutionInput":{ - "type":"structure", - "required":[ - "pipelineName", - "stageName", - "pipelineExecutionId", - "retryMode" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline that contains the failed stage.

" - }, - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the failed stage to be retried.

" - }, - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the pipeline execution in the failed stage to be retried. Use the GetPipelineState action to retrieve the current pipelineExecutionId of the failed stage

" - }, - "retryMode":{ - "shape":"StageRetryMode", - "documentation":"

The scope of the retry attempt. Currently, the only supported value is FAILED_ACTIONS.

" - } - }, - "documentation":"

Represents the input of a RetryStageExecution action.

" - }, - "RetryStageExecutionOutput":{ - "type":"structure", - "members":{ - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the current workflow execution in the failed stage.

" - } - }, - "documentation":"

Represents the output of a RetryStageExecution action.

" - }, - "Revision":{ - "type":"string", - "max":1500, - "min":1 - }, - "RevisionChangeIdentifier":{ - "type":"string", - "max":100, - "min":1 - }, - "RevisionSummary":{ - "type":"string", - "max":2048, - "min":1 - }, - "RoleArn":{ - "type":"string", - "max":1024, - "pattern":"arn:aws(-[\\w]+)*:iam::[0-9]{12}:role/.*" - }, - "S3ArtifactLocation":{ - "type":"structure", - "required":[ - "bucketName", - "objectKey" - ], - "members":{ - "bucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the Amazon S3 bucket.

" - }, - "objectKey":{ - "shape":"S3ObjectKey", - "documentation":"

The key of the object in the Amazon S3 bucket, which uniquely identifies the object in the bucket.

" - } - }, - "documentation":"

The location of the Amazon S3 bucket that contains a revision.

" - }, - "S3BucketName":{"type":"string"}, - "S3ObjectKey":{"type":"string"}, - "SecretAccessKey":{"type":"string"}, - "SessionToken":{"type":"string"}, - "SourceRevision":{ - "type":"structure", - "required":["actionName"], - "members":{ - "actionName":{"shape":"ActionName"}, - "revisionId":{"shape":"Revision"}, - "revisionSummary":{"shape":"RevisionSummary"}, - "revisionUrl":{"shape":"Url"} - } - }, - "SourceRevisionList":{ - "type":"list", - "member":{"shape":"SourceRevision"} - }, - "StageActionDeclarationList":{ - "type":"list", - "member":{"shape":"ActionDeclaration"} - }, - "StageBlockerDeclarationList":{ - "type":"list", - "member":{"shape":"BlockerDeclaration"} - }, - "StageContext":{ - "type":"structure", - "members":{ - "name":{ - "shape":"StageName", - "documentation":"

The name of the stage.

" - } - }, - "documentation":"

Represents information about a stage to a job worker.

" - }, - "StageDeclaration":{ - "type":"structure", - "required":[ - "name", - "actions" - ], - "members":{ - "name":{ - "shape":"StageName", - "documentation":"

The name of the stage.

" - }, - "blockers":{ - "shape":"StageBlockerDeclarationList", - "documentation":"

Reserved for future use.

" - }, - "actions":{ - "shape":"StageActionDeclarationList", - "documentation":"

The actions included in a stage.

" - } - }, - "documentation":"

Represents information about a stage and its definition.

" - }, - "StageExecution":{ - "type":"structure", - "required":[ - "pipelineExecutionId", - "status" - ], - "members":{ - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The ID of the pipeline execution associated with the stage.

" - }, - "status":{ - "shape":"StageExecutionStatus", - "documentation":"

The status of the stage, or for a completed stage, the last status of the stage.

" - } - }, - "documentation":"

Represents information about the run of a stage.

" - }, - "StageExecutionStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Failed", - "Succeeded" - ] - }, - "StageName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[A-Za-z0-9.@\\-_]+" - }, - "StageNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified stage was specified in an invalid format or cannot be found.

", - "exception":true - }, - "StageNotRetryableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified stage can't be retried because the pipeline structure or stage state changed after the stage was not completed; the stage contains no failed actions; one or more actions are still in progress; or another retry attempt is already in progress.

", - "exception":true - }, - "StageRetryMode":{ - "type":"string", - "enum":["FAILED_ACTIONS"] - }, - "StageState":{ - "type":"structure", - "members":{ - "stageName":{ - "shape":"StageName", - "documentation":"

The name of the stage.

" - }, - "inboundTransitionState":{ - "shape":"TransitionState", - "documentation":"

The state of the inbound transition, which is either enabled or disabled.

" - }, - "actionStates":{ - "shape":"ActionStateList", - "documentation":"

The state of the stage.

" - }, - "latestExecution":{ - "shape":"StageExecution", - "documentation":"

Information about the latest execution in the stage, including its ID and status.

" - } - }, - "documentation":"

Represents information about the state of the stage.

" - }, - "StageStateList":{ - "type":"list", - "member":{"shape":"StageState"} - }, - "StageTransitionType":{ - "type":"string", - "enum":[ - "Inbound", - "Outbound" - ] - }, - "StartPipelineExecutionInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline to start.

" - } - }, - "documentation":"

Represents the input of a StartPipelineExecution action.

" - }, - "StartPipelineExecutionOutput":{ - "type":"structure", - "members":{ - "pipelineExecutionId":{ - "shape":"PipelineExecutionId", - "documentation":"

The unique system-generated ID of the pipeline execution that was started.

" - } - }, - "documentation":"

Represents the output of a StartPipelineExecution action.

" - }, - "ThirdPartyJob":{ - "type":"structure", - "members":{ - "clientId":{ - "shape":"ClientId", - "documentation":"

The clientToken portion of the clientId and clientToken pair used to verify that the calling entity is allowed access to the job and its details.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The identifier used to identify the job in AWS CodePipeline.

" - } - }, - "documentation":"

A response to a PollForThirdPartyJobs request returned by AWS CodePipeline when there is a job to be worked upon by a partner action.

" - }, - "ThirdPartyJobData":{ - "type":"structure", - "members":{ - "actionTypeId":{ - "shape":"ActionTypeId", - "documentation":"

Represents information about an action type.

" - }, - "actionConfiguration":{ - "shape":"ActionConfiguration", - "documentation":"

Represents information about an action configuration.

" - }, - "pipelineContext":{ - "shape":"PipelineContext", - "documentation":"

Represents information about a pipeline to a job worker.

" - }, - "inputArtifacts":{ - "shape":"ArtifactList", - "documentation":"

The name of the artifact that will be worked upon by the action, if any. This name might be system-generated, such as \"MyApp\", or might be defined by the user when the action is created. The input artifact name must match the name of an output artifact generated by an action in an earlier action or stage of the pipeline.

" - }, - "outputArtifacts":{ - "shape":"ArtifactList", - "documentation":"

The name of the artifact that will be the result of the action, if any. This name might be system-generated, such as \"MyBuiltApp\", or might be defined by the user when the action is created.

" - }, - "artifactCredentials":{ - "shape":"AWSSessionCredentials", - "documentation":"

Represents an AWS session credentials object. These credentials are temporary credentials that are issued by AWS Secure Token Service (STS). They can be used to access input and output artifacts in the Amazon S3 bucket used to store artifact for the pipeline in AWS CodePipeline.

" - }, - "continuationToken":{ - "shape":"ContinuationToken", - "documentation":"

A system-generated token, such as a AWS CodeDeploy deployment ID, that a job requires in order to continue the job asynchronously.

" - }, - "encryptionKey":{ - "shape":"EncryptionKey", - "documentation":"

The encryption key used to encrypt and decrypt data in the artifact store for the pipeline, such as an AWS Key Management Service (AWS KMS) key. This is optional and might not be present.

" - } - }, - "documentation":"

Represents information about the job data for a partner action.

" - }, - "ThirdPartyJobDetails":{ - "type":"structure", - "members":{ - "id":{ - "shape":"ThirdPartyJobId", - "documentation":"

The identifier used to identify the job details in AWS CodePipeline.

" - }, - "data":{ - "shape":"ThirdPartyJobData", - "documentation":"

The data to be returned by the third party job worker.

" - }, - "nonce":{ - "shape":"Nonce", - "documentation":"

A system-generated random number that AWS CodePipeline uses to ensure that the job is being worked on by only one job worker. Use this number in an AcknowledgeThirdPartyJob request.

" - } - }, - "documentation":"

The details of a job sent in response to a GetThirdPartyJobDetails request.

" - }, - "ThirdPartyJobId":{ - "type":"string", - "max":512, - "min":1 - }, - "ThirdPartyJobList":{ - "type":"list", - "member":{"shape":"ThirdPartyJob"} - }, - "Time":{"type":"timestamp"}, - "Timestamp":{"type":"timestamp"}, - "TransitionState":{ - "type":"structure", - "members":{ - "enabled":{ - "shape":"Enabled", - "documentation":"

Whether the transition between stages is enabled (true) or disabled (false).

" - }, - "lastChangedBy":{ - "shape":"LastChangedBy", - "documentation":"

The ID of the user who last changed the transition state.

" - }, - "lastChangedAt":{ - "shape":"LastChangedAt", - "documentation":"

The timestamp when the transition state was last changed.

" - }, - "disabledReason":{ - "shape":"DisabledReason", - "documentation":"

The user-specified reason why the transition between two stages of a pipeline was disabled.

" - } - }, - "documentation":"

Represents information about the state of transitions between one stage and another stage.

" - }, - "UpdatePipelineInput":{ - "type":"structure", - "required":["pipeline"], - "members":{ - "pipeline":{ - "shape":"PipelineDeclaration", - "documentation":"

The name of the pipeline to be updated.

" - } - }, - "documentation":"

Represents the input of an UpdatePipeline action.

" - }, - "UpdatePipelineOutput":{ - "type":"structure", - "members":{ - "pipeline":{ - "shape":"PipelineDeclaration", - "documentation":"

The structure of the updated pipeline.

" - } - }, - "documentation":"

Represents the output of an UpdatePipeline action.

" - }, - "Url":{ - "type":"string", - "max":2048, - "min":1 - }, - "UrlTemplate":{ - "type":"string", - "max":2048, - "min":1 - }, - "ValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The validation was specified in an invalid format.

", - "exception":true - }, - "Version":{ - "type":"string", - "max":9, - "min":1, - "pattern":"[0-9A-Za-z_-]+" - }, - "WebhookArn":{"type":"string"}, - "WebhookAuthConfiguration":{ - "type":"structure", - "members":{ - "AllowedIPRange":{"shape":"WebhookAuthConfigurationAllowedIPRange"}, - "SecretToken":{"shape":"WebhookAuthConfigurationSecretToken"} - } - }, - "WebhookAuthConfigurationAllowedIPRange":{ - "type":"string", - "max":100, - "min":1 - }, - "WebhookAuthConfigurationSecretToken":{ - "type":"string", - "max":100, - "min":1 - }, - "WebhookAuthenticationType":{ - "type":"string", - "enum":[ - "GITHUB_HMAC", - "IP", - "UNAUTHENTICATED" - ] - }, - "WebhookDefinition":{ - "type":"structure", - "required":[ - "name", - "targetPipeline", - "targetAction", - "filters", - "authentication", - "authenticationConfiguration" - ], - "members":{ - "name":{ - "shape":"WebhookName", - "documentation":"

The name of the webhook.

" - }, - "targetPipeline":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline you want to connect to the webhook.

" - }, - "targetAction":{ - "shape":"ActionName", - "documentation":"

The name of the action in a pipeline you want to connect to the webhook. The action must be from the source (first) stage of the pipeline.

" - }, - "filters":{ - "shape":"WebhookFilters", - "documentation":"

A list of rules applied to the body/payload sent in the POST request to a webhook URL. All defined rules must pass for the request to be accepted and the pipeline started.

" - }, - "authentication":{ - "shape":"WebhookAuthenticationType", - "documentation":"

Supported options are GITHUB_HMAC, IP and UNAUTHENTICATED.

  • GITHUB_HMAC implements the authentication scheme described here: https://developer.github.com/webhooks/securing/

  • IP will reject webhooks trigger requests unless they originate from an IP within the IP range whitelisted in the authentication configuration.

  • UNAUTHENTICATED will accept all webhook trigger requests regardless of origin.

" - }, - "authenticationConfiguration":{ - "shape":"WebhookAuthConfiguration", - "documentation":"

Properties that configure the authentication applied to incoming webhook trigger requests. The required properties depend on the authentication type. For GITHUB_HMAC, only the SecretToken property must be set. For IP, only the AllowedIPRange property must be set to a valid CIDR range. For UNAUTHENTICATED, no properties can be set.

" - } - }, - "documentation":"

Represents information about a webhook and its definition.

" - }, - "WebhookErrorCode":{"type":"string"}, - "WebhookErrorMessage":{"type":"string"}, - "WebhookFilterRule":{ - "type":"structure", - "required":["jsonPath"], - "members":{ - "jsonPath":{ - "shape":"JsonPath", - "documentation":"

A JsonPath expression that will be applied to the body/payload of the webhook. The value selected by JsonPath expression must match the value specified in the matchEquals field, otherwise the request will be ignored. More information on JsonPath expressions can be found here: https://github.com/json-path/JsonPath.

" - }, - "matchEquals":{ - "shape":"MatchEquals", - "documentation":"

The value selected by the JsonPath expression must match what is supplied in the MatchEquals field, otherwise the request will be ignored. Properties from the target action configuration can be included as placeholders in this value by surrounding the action configuration key with curly braces. For example, if the value supplied here is \"refs/heads/{Branch}\" and the target action has an action configuration property called \"Branch\" with a value of \"master\", the MatchEquals value will be evaluated as \"refs/heads/master\". A list of action configuration properties for built-in action types can be found here: Pipeline Structure Reference Action Requirements.

" - } - }, - "documentation":"

The event criteria that specify when a webhook notification is sent to your URL.

" - }, - "WebhookFilters":{ - "type":"list", - "member":{"shape":"WebhookFilterRule"}, - "max":5 - }, - "WebhookLastTriggered":{"type":"timestamp"}, - "WebhookList":{ - "type":"list", - "member":{"shape":"ListWebhookItem"} - }, - "WebhookName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[A-Za-z0-9.@\\-_]+" - }, - "WebhookNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified webhook was entered in an invalid format or cannot be found.

", - "exception":true - }, - "WebhookUrl":{ - "type":"string", - "max":1000, - "min":1 - } - }, - "documentation":"AWS CodePipeline

Overview

This is the AWS CodePipeline API Reference. This guide provides descriptions of the actions and data types for AWS CodePipeline. Some functionality for your pipeline is only configurable through the API. For additional information, see the AWS CodePipeline User Guide.

You can use the AWS CodePipeline API to work with pipelines, stages, actions, and transitions, as described below.

Pipelines are models of automated release processes. Each pipeline is uniquely named, and consists of stages, actions, and transitions.

You can work with pipelines by calling:

  • CreatePipeline, which creates a uniquely-named pipeline.

  • DeletePipeline, which deletes the specified pipeline.

  • GetPipeline, which returns information about the pipeline structure and pipeline metadata, including the pipeline Amazon Resource Name (ARN).

  • GetPipelineExecution, which returns information about a specific execution of a pipeline.

  • GetPipelineState, which returns information about the current state of the stages and actions of a pipeline.

  • ListPipelines, which gets a summary of all of the pipelines associated with your account.

  • ListPipelineExecutions, which gets a summary of the most recent executions for a pipeline.

  • StartPipelineExecution, which runs the the most recent revision of an artifact through the pipeline.

  • UpdatePipeline, which updates a pipeline with edits or changes to the structure of the pipeline.

Pipelines include stages. Each stage contains one or more actions that must complete before the next stage begins. A stage will result in success or failure. If a stage fails, then the pipeline stops at that stage and will remain stopped until either a new version of an artifact appears in the source location, or a user takes action to re-run the most recent artifact through the pipeline. You can call GetPipelineState, which displays the status of a pipeline, including the status of stages in the pipeline, or GetPipeline, which returns the entire structure of the pipeline, including the stages of that pipeline. For more information about the structure of stages and actions, also refer to the AWS CodePipeline Pipeline Structure Reference.

Pipeline stages include actions, which are categorized into categories such as source or build actions performed within a stage of a pipeline. For example, you can use a source action to import artifacts into a pipeline from a source such as Amazon S3. Like stages, you do not work with actions directly in most cases, but you do define and interact with actions when working with pipeline operations such as CreatePipeline and GetPipelineState. Valid action categories are:

  • Source

  • Build

  • Test

  • Deploy

  • Approval

  • Invoke

Pipelines also include transitions, which allow the transition of artifacts from one stage to the next in a pipeline after the actions in one stage complete.

You can work with transitions by calling:

Using the API to integrate with AWS CodePipeline

For third-party integrators or developers who want to create their own integrations with AWS CodePipeline, the expected sequence varies from the standard API user. In order to integrate with AWS CodePipeline, developers will need to work with the following items:

Jobs, which are instances of an action. For example, a job for a source action might import a revision of an artifact from a source.

You can work with jobs by calling:

Third party jobs, which are instances of an action created by a partner action and integrated into AWS CodePipeline. Partner actions are created by members of the AWS Partner Network.

You can work with third party jobs by calling:

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/service-2.json deleted file mode 100644 index 2c53e815..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/codestar/2017-04-19/service-2.json +++ /dev/null @@ -1,1212 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-04-19", - "endpointPrefix":"codestar", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"CodeStar", - "serviceFullName":"AWS CodeStar", - "serviceId":"CodeStar", - "signatureVersion":"v4", - "targetPrefix":"CodeStar_20170419", - "uid":"codestar-2017-04-19" - }, - "operations":{ - "AssociateTeamMember":{ - "name":"AssociateTeamMember", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateTeamMemberRequest"}, - "output":{"shape":"AssociateTeamMemberResult"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ProjectNotFoundException"}, - {"shape":"TeamMemberAlreadyAssociatedException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidServiceRoleException"}, - {"shape":"ProjectConfigurationException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds an IAM user to the team for an AWS CodeStar project.

" - }, - "CreateProject":{ - "name":"CreateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProjectRequest"}, - "output":{"shape":"CreateProjectResult"}, - "errors":[ - {"shape":"ProjectAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ValidationException"}, - {"shape":"ProjectCreationFailedException"}, - {"shape":"InvalidServiceRoleException"}, - {"shape":"ProjectConfigurationException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Reserved for future use. To create a project, use the AWS CodeStar console.

" - }, - "CreateUserProfile":{ - "name":"CreateUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserProfileRequest"}, - "output":{"shape":"CreateUserProfileResult"}, - "errors":[ - {"shape":"UserProfileAlreadyExistsException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Creates a profile for a user that includes user preferences, such as the display name and email address assocciated with the user, in AWS CodeStar. The user profile is not project-specific. Information in the user profile is displayed wherever the user's information appears to other users in AWS CodeStar.

" - }, - "DeleteProject":{ - "name":"DeleteProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProjectRequest"}, - "output":{"shape":"DeleteProjectResult"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidServiceRoleException"} - ], - "documentation":"

Deletes a project, including project resources. Does not delete users associated with the project, but does delete the IAM roles that allowed access to the project.

" - }, - "DeleteUserProfile":{ - "name":"DeleteUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserProfileRequest"}, - "output":{"shape":"DeleteUserProfileResult"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Deletes a user profile in AWS CodeStar, including all personal preference data associated with that profile, such as display name and email address. It does not delete the history of that user, for example the history of commits made by that user.

" - }, - "DescribeProject":{ - "name":"DescribeProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProjectRequest"}, - "output":{"shape":"DescribeProjectResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidServiceRoleException"}, - {"shape":"ProjectConfigurationException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Describes a project and its resources.

" - }, - "DescribeUserProfile":{ - "name":"DescribeUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserProfileRequest"}, - "output":{"shape":"DescribeUserProfileResult"}, - "errors":[ - {"shape":"UserProfileNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Describes a user in AWS CodeStar and the user attributes across all projects.

" - }, - "DisassociateTeamMember":{ - "name":"DisassociateTeamMember", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateTeamMemberRequest"}, - "output":{"shape":"DisassociateTeamMemberResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidServiceRoleException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Removes a user from a project. Removing a user from a project also removes the IAM policies from that user that allowed access to the project and its resources. Disassociating a team member does not remove that user's profile from AWS CodeStar. It does not remove the user from IAM.

" - }, - "ListProjects":{ - "name":"ListProjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProjectsRequest"}, - "output":{"shape":"ListProjectsResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Lists all projects in AWS CodeStar associated with your AWS account.

" - }, - "ListResources":{ - "name":"ListResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourcesRequest"}, - "output":{"shape":"ListResourcesResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Lists resources associated with a project in AWS CodeStar.

" - }, - "ListTagsForProject":{ - "name":"ListTagsForProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForProjectRequest"}, - "output":{"shape":"ListTagsForProjectResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Gets the tags for a project.

" - }, - "ListTeamMembers":{ - "name":"ListTeamMembers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTeamMembersRequest"}, - "output":{"shape":"ListTeamMembersResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Lists all team members associated with a project.

" - }, - "ListUserProfiles":{ - "name":"ListUserProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUserProfilesRequest"}, - "output":{"shape":"ListUserProfilesResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Lists all the user profiles configured for your AWS account in AWS CodeStar.

" - }, - "TagProject":{ - "name":"TagProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagProjectRequest"}, - "output":{"shape":"TagProjectResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds tags to a project.

" - }, - "UntagProject":{ - "name":"UntagProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagProjectRequest"}, - "output":{"shape":"UntagProjectResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Removes tags from a project.

" - }, - "UpdateProject":{ - "name":"UpdateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProjectRequest"}, - "output":{"shape":"UpdateProjectResult"}, - "errors":[ - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Updates a project in AWS CodeStar.

" - }, - "UpdateTeamMember":{ - "name":"UpdateTeamMember", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTeamMemberRequest"}, - "output":{"shape":"UpdateTeamMemberResult"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ProjectNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InvalidServiceRoleException"}, - {"shape":"ProjectConfigurationException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"TeamMemberNotFoundException"} - ], - "documentation":"

Updates a team member's attributes in an AWS CodeStar project. For example, you can change a team member's role in the project, or change whether they have remote access to project resources.

" - }, - "UpdateUserProfile":{ - "name":"UpdateUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserProfileRequest"}, - "output":{"shape":"UpdateUserProfileResult"}, - "errors":[ - {"shape":"UserProfileNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Updates a user's profile in AWS CodeStar. The user profile is not project-specific. Information in the user profile is displayed wherever the user's information appears to other users in AWS CodeStar.

" - } - }, - "shapes":{ - "AssociateTeamMemberRequest":{ - "type":"structure", - "required":[ - "projectId", - "userArn", - "projectRole" - ], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the project to which you will add the IAM user.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A user- or system-generated token that identifies the entity that requested the team member association to the project. This token can be used to repeat the request.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) for the IAM user you want to add to the AWS CodeStar project.

" - }, - "projectRole":{ - "shape":"Role", - "documentation":"

The AWS CodeStar project role that will apply to this user. This role determines what actions a user can take in an AWS CodeStar project.

" - }, - "remoteAccessAllowed":{ - "shape":"RemoteAccessAllowed", - "documentation":"

Whether the team member is allowed to use an SSH public/private key pair to remotely access project resources, for example Amazon EC2 instances.

", - "box":true - } - } - }, - "AssociateTeamMemberResult":{ - "type":"structure", - "members":{ - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

The user- or system-generated token from the initial request that can be used to repeat the request.

" - } - } - }, - "ClientRequestToken":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^[\\w:/-]+$" - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Another modification is being made. That modification must complete before you can make your change.

", - "exception":true - }, - "CreateProjectRequest":{ - "type":"structure", - "required":[ - "name", - "id" - ], - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

Reserved for future use.

" - }, - "id":{ - "shape":"ProjectId", - "documentation":"

Reserved for future use.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

Reserved for future use.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Reserved for future use.

" - } - } - }, - "CreateProjectResult":{ - "type":"structure", - "required":[ - "id", - "arn" - ], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

Reserved for future use.

" - }, - "arn":{ - "shape":"ProjectArn", - "documentation":"

Reserved for future use.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Reserved for future use.

" - }, - "projectTemplateId":{ - "shape":"ProjectTemplateId", - "documentation":"

Reserved for future use.

" - } - } - }, - "CreateUserProfileRequest":{ - "type":"structure", - "required":[ - "userArn", - "displayName", - "emailAddress" - ], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user in IAM.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The name that will be displayed as the friendly name for the user in AWS CodeStar.

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address that will be displayed as part of the user's profile in AWS CodeStar.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user in AWS CodeStar. If a project owner allows the user remote access to project resources, this public key will be used along with the user's private key for SSH access.

" - } - } - }, - "CreateUserProfileResult":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user in IAM.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The name that is displayed as the friendly name for the user in AWS CodeStar.

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address that is displayed as part of the user's profile in AWS CodeStar.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user in AWS CodeStar. This is the public portion of the public/private keypair the user can use to access project resources if a project owner allows the user remote access to those resources.

" - }, - "createdTimestamp":{ - "shape":"CreatedTimestamp", - "documentation":"

The date the user profile was created, in timestamp format.

" - }, - "lastModifiedTimestamp":{ - "shape":"LastModifiedTimestamp", - "documentation":"

The date the user profile was last modified, in timestamp format.

" - } - } - }, - "CreatedTimestamp":{"type":"timestamp"}, - "DeleteProjectRequest":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project to be deleted in AWS CodeStar.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A user- or system-generated token that identifies the entity that requested project deletion. This token can be used to repeat the request.

" - }, - "deleteStack":{ - "shape":"DeleteStack", - "documentation":"

Whether to send a delete request for the primary stack in AWS CloudFormation originally used to generate the project and its resources. This option will delete all AWS resources for the project (except for any buckets in Amazon S3) as well as deleting the project itself. Recommended for most use cases.

" - } - } - }, - "DeleteProjectResult":{ - "type":"structure", - "members":{ - "stackId":{ - "shape":"StackId", - "documentation":"

The ID of the primary stack in AWS CloudFormation that will be deleted as part of deleting the project and its resources.

" - }, - "projectArn":{ - "shape":"ProjectArn", - "documentation":"

The Amazon Resource Name (ARN) of the deleted project.

" - } - } - }, - "DeleteStack":{"type":"boolean"}, - "DeleteUserProfileRequest":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user to delete from AWS CodeStar.

" - } - } - }, - "DeleteUserProfileResult":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user deleted from AWS CodeStar.

" - } - } - }, - "DescribeProjectRequest":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project.

" - } - } - }, - "DescribeProjectResult":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

The display name for the project.

" - }, - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project.

" - }, - "arn":{ - "shape":"ProjectArn", - "documentation":"

The Amazon Resource Name (ARN) for the project.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

The description of the project, if any.

" - }, - "clientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

A user- or system-generated token that identifies the entity that requested project creation.

" - }, - "createdTimeStamp":{ - "shape":"CreatedTimestamp", - "documentation":"

The date and time the project was created, in timestamp format.

" - }, - "stackId":{ - "shape":"StackId", - "documentation":"

The ID of the primary stack in AWS CloudFormation used to generate resources for the project.

" - }, - "projectTemplateId":{ - "shape":"ProjectTemplateId", - "documentation":"

The ID for the AWS CodeStar project template used to create the project.

" - } - } - }, - "DescribeUserProfileRequest":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user.

" - } - } - }, - "DescribeUserProfileResult":{ - "type":"structure", - "required":[ - "userArn", - "createdTimestamp", - "lastModifiedTimestamp" - ], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The display name shown for the user in AWS CodeStar projects. For example, this could be set to both first and last name (\"Mary Major\") or a single name (\"Mary\"). The display name is also used to generate the initial icon associated with the user in AWS CodeStar projects. If spaces are included in the display name, the first character that appears after the space will be used as the second character in the user initial icon. The initial icon displays a maximum of two characters, so a display name with more than one space (for example \"Mary Jane Major\") would generate an initial icon using the first character and the first character after the space (\"MJ\", not \"MM\").

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address for the user. Optional.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user. This SSH public key is associated with the user profile, and can be used in conjunction with the associated private key for access to project resources, such as Amazon EC2 instances, if a project owner grants remote access to those resources.

" - }, - "createdTimestamp":{ - "shape":"CreatedTimestamp", - "documentation":"

The date and time when the user profile was created in AWS CodeStar, in timestamp format.

" - }, - "lastModifiedTimestamp":{ - "shape":"LastModifiedTimestamp", - "documentation":"

The date and time when the user profile was last modified, in timestamp format.

" - } - } - }, - "DisassociateTeamMemberRequest":{ - "type":"structure", - "required":[ - "projectId", - "userArn" - ], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the AWS CodeStar project from which you want to remove a team member.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM user or group whom you want to remove from the project.

" - } - } - }, - "DisassociateTeamMemberResult":{ - "type":"structure", - "members":{ - } - }, - "Email":{ - "type":"string", - "max":128, - "min":3, - "pattern":"^[\\w-.+]+@[\\w-.+]+$", - "sensitive":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The next token is not valid.

", - "exception":true - }, - "InvalidServiceRoleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The service role is not valid.

", - "exception":true - }, - "LastModifiedTimestamp":{"type":"timestamp"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A resource limit has been exceeded.

", - "exception":true - }, - "ListProjectsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token to be used to return the next set of results, if the results cannot be returned in one response.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum amount of data that can be contained in a single set of results.

", - "box":true - } - } - }, - "ListProjectsResult":{ - "type":"structure", - "required":["projects"], - "members":{ - "projects":{ - "shape":"ProjectsList", - "documentation":"

A list of projects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token to use when requesting the next set of results, if there are more results to be returned.

" - } - } - }, - "ListResourcesRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the project.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token for the next set of results, if the results cannot be returned in one response.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum amount of data that can be contained in a single set of results.

", - "box":true - } - } - }, - "ListResourcesResult":{ - "type":"structure", - "members":{ - "resources":{ - "shape":"ResourcesResult", - "documentation":"

An array of resources associated with the project.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token to use when requesting the next set of results, if there are more results to be returned.

" - } - } - }, - "ListTagsForProjectRequest":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project to get tags for.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

Reserved for future use.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

Reserved for future use.

", - "box":true - } - } - }, - "ListTagsForProjectResult":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"Tags", - "documentation":"

The tags for the project.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

Reserved for future use.

" - } - } - }, - "ListTeamMembersRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the project for which you want to list team members.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token for the next set of results, if the results cannot be returned in one response.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of team members you want returned in a response.

", - "box":true - } - } - }, - "ListTeamMembersResult":{ - "type":"structure", - "required":["teamMembers"], - "members":{ - "teamMembers":{ - "shape":"TeamMemberResult", - "documentation":"

A list of team member objects for the project.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token to use when requesting the next set of results, if there are more results to be returned.

" - } - } - }, - "ListUserProfilesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token for the next set of results, if the results cannot be returned in one response.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a response.

", - "box":true - } - } - }, - "ListUserProfilesResult":{ - "type":"structure", - "required":["userProfiles"], - "members":{ - "userProfiles":{ - "shape":"UserProfilesList", - "documentation":"

All the user profiles configured in AWS CodeStar for an AWS account.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The continuation token to use when requesting the next set of results, if there are more results to be returned.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "PaginationToken":{ - "type":"string", - "max":512, - "min":1, - "pattern":"^[\\w/+=]+$" - }, - "ProjectAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An AWS CodeStar project with the same ID already exists in this region for the AWS account. AWS CodeStar project IDs must be unique within a region for the AWS account.

", - "exception":true - }, - "ProjectArn":{ - "type":"string", - "pattern":"^arn:aws[^:\\s]*:codestar:[^:\\s]+:[0-9]{12}:project\\/[a-z]([a-z0-9|-])+$" - }, - "ProjectConfigurationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Project configuration information is required but not specified.

", - "exception":true - }, - "ProjectCreationFailedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The project creation request was valid, but a nonspecific exception or error occurred during project creation. The project could not be created in AWS CodeStar.

", - "exception":true - }, - "ProjectDescription":{ - "type":"string", - "max":1024, - "pattern":"^$|^\\S(.*\\S)?$", - "sensitive":true - }, - "ProjectId":{ - "type":"string", - "max":15, - "min":2, - "pattern":"^[a-z][a-z0-9-]+$" - }, - "ProjectName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^\\S(.*\\S)?$", - "sensitive":true - }, - "ProjectNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified AWS CodeStar project was not found.

", - "exception":true - }, - "ProjectSummary":{ - "type":"structure", - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the project.

" - }, - "projectArn":{ - "shape":"ProjectArn", - "documentation":"

The Amazon Resource Name (ARN) of the project.

" - } - }, - "documentation":"

Information about the metadata for a project.

" - }, - "ProjectTemplateId":{ - "type":"string", - "min":1, - "pattern":"^arn:aws[^:\\s]{0,5}:codestar:[^:\\s]+::project-template\\/[a-z0-9-]+$" - }, - "ProjectsList":{ - "type":"list", - "member":{"shape":"ProjectSummary"} - }, - "RemoteAccessAllowed":{"type":"boolean"}, - "Resource":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"ResourceId", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - } - }, - "documentation":"

Information about a resource for a project.

" - }, - "ResourceId":{ - "type":"string", - "min":11, - "pattern":"^arn\\:aws\\:\\S.*\\:.*" - }, - "ResourcesResult":{ - "type":"list", - "member":{"shape":"Resource"} - }, - "Role":{ - "type":"string", - "pattern":"^(Owner|Viewer|Contributor)$" - }, - "SshPublicKey":{ - "type":"string", - "max":16384, - "pattern":"^[\\t\\r\\n\\u0020-\\u00FF]*$" - }, - "StackId":{ - "type":"string", - "pattern":"^arn:aws[^:\\s]*:cloudformation:[^:\\s]+:[0-9]{12}:stack\\/[^:\\s]+\\/[^:\\s]+$" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagProjectRequest":{ - "type":"structure", - "required":[ - "id", - "tags" - ], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project you want to add a tag to.

" - }, - "tags":{ - "shape":"Tags", - "documentation":"

The tags you want to add to the project.

" - } - } - }, - "TagProjectResult":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"Tags", - "documentation":"

The tags for the project.

" - } - } - }, - "TagValue":{ - "type":"string", - "max":256, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"} - }, - "TeamMember":{ - "type":"structure", - "required":[ - "userArn", - "projectRole" - ], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user in IAM.

" - }, - "projectRole":{ - "shape":"Role", - "documentation":"

The role assigned to the user in the project. Project roles have different levels of access. For more information, see Working with Teams in the AWS CodeStar User Guide.

" - }, - "remoteAccessAllowed":{ - "shape":"RemoteAccessAllowed", - "documentation":"

Whether the user is allowed to remotely access project resources using an SSH public/private key pair.

", - "box":true - } - }, - "documentation":"

Information about a team member in a project.

" - }, - "TeamMemberAlreadyAssociatedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The team member is already associated with a role in this project.

", - "exception":true - }, - "TeamMemberNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified team member was not found.

", - "exception":true - }, - "TeamMemberResult":{ - "type":"list", - "member":{"shape":"TeamMember"} - }, - "UntagProjectRequest":{ - "type":"structure", - "required":[ - "id", - "tags" - ], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project to remove tags from.

" - }, - "tags":{ - "shape":"TagKeys", - "documentation":"

The tags to remove from the project.

" - } - } - }, - "UntagProjectResult":{ - "type":"structure", - "members":{ - } - }, - "UpdateProjectRequest":{ - "type":"structure", - "required":["id"], - "members":{ - "id":{ - "shape":"ProjectId", - "documentation":"

The ID of the project you want to update.

" - }, - "name":{ - "shape":"ProjectName", - "documentation":"

The name of the project you want to update.

" - }, - "description":{ - "shape":"ProjectDescription", - "documentation":"

The description of the project, if any.

" - } - } - }, - "UpdateProjectResult":{ - "type":"structure", - "members":{ - } - }, - "UpdateTeamMemberRequest":{ - "type":"structure", - "required":[ - "projectId", - "userArn" - ], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

The ID of the project.

" - }, - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user for whom you want to change team membership attributes.

" - }, - "projectRole":{ - "shape":"Role", - "documentation":"

The role assigned to the user in the project. Project roles have different levels of access. For more information, see Working with Teams in the AWS CodeStar User Guide.

" - }, - "remoteAccessAllowed":{ - "shape":"RemoteAccessAllowed", - "documentation":"

Whether a team member is allowed to remotely access project resources using the SSH public key associated with the user's profile. Even if this is set to True, the user must associate a public key with their profile before the user can access resources.

", - "box":true - } - } - }, - "UpdateTeamMemberResult":{ - "type":"structure", - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user whose team membership attributes were updated.

" - }, - "projectRole":{ - "shape":"Role", - "documentation":"

The project role granted to the user.

" - }, - "remoteAccessAllowed":{ - "shape":"RemoteAccessAllowed", - "documentation":"

Whether a team member is allowed to remotely access project resources using the SSH public key associated with the user's profile.

", - "box":true - } - } - }, - "UpdateUserProfileRequest":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The name that will be displayed as the friendly name for the user in AWS CodeStar.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The name that is displayed as the friendly name for the user in AWS CodeStar.

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address that is displayed as part of the user's profile in AWS CodeStar.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user in AWS CodeStar. If a project owner allows the user remote access to project resources, this public key will be used along with the user's private key for SSH access.

" - } - } - }, - "UpdateUserProfileResult":{ - "type":"structure", - "required":["userArn"], - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user in IAM.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The name that is displayed as the friendly name for the user in AWS CodeStar.

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address that is displayed as part of the user's profile in AWS CodeStar.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user in AWS CodeStar. This is the public portion of the public/private keypair the user can use to access project resources if a project owner allows the user remote access to those resources.

" - }, - "createdTimestamp":{ - "shape":"CreatedTimestamp", - "documentation":"

The date the user profile was created, in timestamp format.

" - }, - "lastModifiedTimestamp":{ - "shape":"LastModifiedTimestamp", - "documentation":"

The date the user profile was last modified, in timestamp format.

" - } - } - }, - "UserArn":{ - "type":"string", - "max":95, - "min":32, - "pattern":"^arn:aws:iam::\\d{12}:user(?:(\\u002F)|(\\u002F[\\u0021-\\u007E]+\\u002F))[\\w+=,.@-]+$" - }, - "UserProfileAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A user profile with that name already exists in this region for the AWS account. AWS CodeStar user profile names must be unique within a region for the AWS account.

", - "exception":true - }, - "UserProfileDisplayName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^\\S(.*\\S)?$" - }, - "UserProfileNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The user profile was not found.

", - "exception":true - }, - "UserProfileSummary":{ - "type":"structure", - "members":{ - "userArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the user in IAM.

" - }, - "displayName":{ - "shape":"UserProfileDisplayName", - "documentation":"

The display name of a user in AWS CodeStar. For example, this could be set to both first and last name (\"Mary Major\") or a single name (\"Mary\"). The display name is also used to generate the initial icon associated with the user in AWS CodeStar projects. If spaces are included in the display name, the first character that appears after the space will be used as the second character in the user initial icon. The initial icon displays a maximum of two characters, so a display name with more than one space (for example \"Mary Jane Major\") would generate an initial icon using the first character and the first character after the space (\"MJ\", not \"MM\").

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address associated with the user.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The SSH public key associated with the user in AWS CodeStar. If a project owner allows the user remote access to project resources, this public key will be used along with the user's private key for SSH access.

" - } - }, - "documentation":"

Information about a user's profile in AWS CodeStar.

" - }, - "UserProfilesList":{ - "type":"list", - "member":{"shape":"UserProfileSummary"} - }, - "ValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified input is either not valid, or it could not be validated.

", - "exception":true - } - }, - "documentation":"AWS CodeStar

This is the API reference for AWS CodeStar. This reference provides descriptions of the operations and data types for the AWS CodeStar API along with usage examples.

You can use the AWS CodeStar API to work with:

Projects and their resources, by calling the following:

  • DeleteProject, which deletes a project.

  • DescribeProject, which lists the attributes of a project.

  • ListProjects, which lists all projects associated with your AWS account.

  • ListResources, which lists the resources associated with a project.

  • ListTagsForProject, which lists the tags associated with a project.

  • TagProject, which adds tags to a project.

  • UntagProject, which removes tags from a project.

  • UpdateProject, which updates the attributes of a project.

Teams and team members, by calling the following:

  • AssociateTeamMember, which adds an IAM user to the team for a project.

  • DisassociateTeamMember, which removes an IAM user from the team for a project.

  • ListTeamMembers, which lists all the IAM users in the team for a project, including their roles and attributes.

  • UpdateTeamMember, which updates a team member's attributes in a project.

Users, by calling the following:

  • CreateUserProfile, which creates a user profile that contains data associated with the user across all projects.

  • DeleteUserProfile, which deletes all user profile information across all projects.

  • DescribeUserProfile, which describes the profile of a user.

  • ListUserProfiles, which lists all user profiles.

  • UpdateUserProfile, which updates the profile for a user.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/service-2.json deleted file mode 100644 index 2b255458..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-identity/2014-06-30/service-2.json +++ /dev/null @@ -1,1341 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-06-30", - "endpointPrefix":"cognito-identity", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Cognito Identity", - "serviceId":"Cognito Identity", - "signatureVersion":"v4", - "targetPrefix":"AWSCognitoIdentityService", - "uid":"cognito-identity-2014-06-30" - }, - "operations":{ - "CreateIdentityPool":{ - "name":"CreateIdentityPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateIdentityPoolInput"}, - "output":{"shape":"IdentityPool"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a new identity pool. The identity pool is a store of user identity information that is specific to your AWS account. The limit on identity pools is 60 per account. The keys for SupportedLoginProviders are as follows:

  • Facebook: graph.facebook.com

  • Google: accounts.google.com

  • Amazon: www.amazon.com

  • Twitter: api.twitter.com

  • Digits: www.digits.com

You must use AWS Developer credentials to call this API.

" - }, - "DeleteIdentities":{ - "name":"DeleteIdentities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIdentitiesInput"}, - "output":{"shape":"DeleteIdentitiesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes identities from an identity pool. You can specify a list of 1-60 identities that you want to delete.

You must use AWS Developer credentials to call this API.

" - }, - "DeleteIdentityPool":{ - "name":"DeleteIdentityPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIdentityPoolInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes a user pool. Once a pool is deleted, users will not be able to authenticate with the pool.

You must use AWS Developer credentials to call this API.

" - }, - "DescribeIdentity":{ - "name":"DescribeIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityInput"}, - "output":{"shape":"IdentityDescription"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns metadata related to the given identity, including when the identity was created and any associated linked logins.

You must use AWS Developer credentials to call this API.

" - }, - "DescribeIdentityPool":{ - "name":"DescribeIdentityPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityPoolInput"}, - "output":{"shape":"IdentityPool"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets details about a particular identity pool, including the pool name, ID description, creation date, and current number of users.

You must use AWS Developer credentials to call this API.

" - }, - "GetCredentialsForIdentity":{ - "name":"GetCredentialsForIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCredentialsForIdentityInput"}, - "output":{"shape":"GetCredentialsForIdentityResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidIdentityPoolConfigurationException"}, - {"shape":"InternalErrorException"}, - {"shape":"ExternalServiceException"} - ], - "documentation":"

Returns credentials for the provided identity ID. Any provided logins will be validated against supported login providers. If the token is for cognito-identity.amazonaws.com, it will be passed through to AWS Security Token Service with the appropriate role for the token.

This is a public API. You do not need any credentials to call this API.

" - }, - "GetId":{ - "name":"GetId", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdInput"}, - "output":{"shape":"GetIdResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"LimitExceededException"}, - {"shape":"ExternalServiceException"} - ], - "documentation":"

Generates (or retrieves) a Cognito ID. Supplying multiple logins will create an implicit linked account.

This is a public API. You do not need any credentials to call this API.

" - }, - "GetIdentityPoolRoles":{ - "name":"GetIdentityPoolRoles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityPoolRolesInput"}, - "output":{"shape":"GetIdentityPoolRolesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the roles for an identity pool.

You must use AWS Developer credentials to call this API.

" - }, - "GetOpenIdToken":{ - "name":"GetOpenIdToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOpenIdTokenInput"}, - "output":{"shape":"GetOpenIdTokenResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"ExternalServiceException"} - ], - "documentation":"

Gets an OpenID token, using a known Cognito ID. This known Cognito ID is returned by GetId. You can optionally add additional logins for the identity. Supplying multiple logins creates an implicit link.

The OpenId token is valid for 15 minutes.

This is a public API. You do not need any credentials to call this API.

" - }, - "GetOpenIdTokenForDeveloperIdentity":{ - "name":"GetOpenIdTokenForDeveloperIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOpenIdTokenForDeveloperIdentityInput"}, - "output":{"shape":"GetOpenIdTokenForDeveloperIdentityResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"DeveloperUserAlreadyRegisteredException"} - ], - "documentation":"

Registers (or retrieves) a Cognito IdentityId and an OpenID Connect token for a user authenticated by your backend authentication process. Supplying multiple logins will create an implicit linked account. You can only specify one developer provider as part of the Logins map, which is linked to the identity pool. The developer provider is the \"domain\" by which Cognito will refer to your users.

You can use GetOpenIdTokenForDeveloperIdentity to create a new identity and to link new logins (that is, user credentials issued by a public provider or developer provider) to an existing identity. When you want to create a new identity, the IdentityId should be null. When you want to associate a new login with an existing authenticated/unauthenticated identity, you can do so by providing the existing IdentityId. This API will create the identity in the specified IdentityPoolId.

You must use AWS Developer credentials to call this API.

" - }, - "ListIdentities":{ - "name":"ListIdentities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIdentitiesInput"}, - "output":{"shape":"ListIdentitiesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the identities in a pool.

You must use AWS Developer credentials to call this API.

" - }, - "ListIdentityPools":{ - "name":"ListIdentityPools", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIdentityPoolsInput"}, - "output":{"shape":"ListIdentityPoolsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists all of the Cognito identity pools registered for your account.

You must use AWS Developer credentials to call this API.

" - }, - "LookupDeveloperIdentity":{ - "name":"LookupDeveloperIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LookupDeveloperIdentityInput"}, - "output":{"shape":"LookupDeveloperIdentityResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Retrieves the IdentityID associated with a DeveloperUserIdentifier or the list of DeveloperUserIdentifiers associated with an IdentityId for an existing identity. Either IdentityID or DeveloperUserIdentifier must not be null. If you supply only one of these values, the other value will be searched in the database and returned as a part of the response. If you supply both, DeveloperUserIdentifier will be matched against IdentityID. If the values are verified against the database, the response returns both values and is the same as the request. Otherwise a ResourceConflictException is thrown.

You must use AWS Developer credentials to call this API.

" - }, - "MergeDeveloperIdentities":{ - "name":"MergeDeveloperIdentities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MergeDeveloperIdentitiesInput"}, - "output":{"shape":"MergeDeveloperIdentitiesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Merges two users having different IdentityIds, existing in the same identity pool, and identified by the same developer provider. You can use this action to request that discrete users be merged and identified as a single user in the Cognito environment. Cognito associates the given source user (SourceUserIdentifier) with the IdentityId of the DestinationUserIdentifier. Only developer-authenticated users can be merged. If the users to be merged are associated with the same public provider, but as two different users, an exception will be thrown.

You must use AWS Developer credentials to call this API.

" - }, - "SetIdentityPoolRoles":{ - "name":"SetIdentityPoolRoles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityPoolRolesInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Sets the roles for an identity pool. These roles are used when making calls to GetCredentialsForIdentity action.

You must use AWS Developer credentials to call this API.

" - }, - "UnlinkDeveloperIdentity":{ - "name":"UnlinkDeveloperIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnlinkDeveloperIdentityInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Unlinks a DeveloperUserIdentifier from an existing identity. Unlinked developer users will be considered new identities next time they are seen. If, for a given Cognito identity, you remove all federated identities as well as the developer user identifier, the Cognito identity becomes inaccessible.

You must use AWS Developer credentials to call this API.

" - }, - "UnlinkIdentity":{ - "name":"UnlinkIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnlinkIdentityInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"ExternalServiceException"} - ], - "documentation":"

Unlinks a federated identity from an existing account. Unlinked logins will be considered new identities next time they are seen. Removing the last linked login will make this identity inaccessible.

This is a public API. You do not need any credentials to call this API.

" - }, - "UpdateIdentityPool":{ - "name":"UpdateIdentityPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IdentityPool"}, - "output":{"shape":"IdentityPool"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Updates a user pool.

You must use AWS Developer credentials to call this API.

" - } - }, - "shapes":{ - "ARNString":{ - "type":"string", - "max":2048, - "min":20 - }, - "AccessKeyString":{"type":"string"}, - "AccountId":{ - "type":"string", - "max":15, - "min":1, - "pattern":"\\d+" - }, - "AmbiguousRoleResolutionType":{ - "type":"string", - "enum":[ - "AuthenticatedRole", - "Deny" - ] - }, - "ClaimName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "ClaimValue":{ - "type":"string", - "max":128, - "min":1 - }, - "CognitoIdentityProvider":{ - "type":"structure", - "members":{ - "ProviderName":{ - "shape":"CognitoIdentityProviderName", - "documentation":"

The provider name for an Amazon Cognito Identity User Pool. For example, cognito-idp.us-east-1.amazonaws.com/us-east-1_123456789.

" - }, - "ClientId":{ - "shape":"CognitoIdentityProviderClientId", - "documentation":"

The client ID for the Amazon Cognito Identity User Pool.

" - }, - "ServerSideTokenCheck":{ - "shape":"CognitoIdentityProviderTokenCheck", - "documentation":"

TRUE if server-side token validation is enabled for the identity provider’s token.

", - "box":true - } - }, - "documentation":"

A provider representing an Amazon Cognito Identity User Pool and its client ID.

" - }, - "CognitoIdentityProviderClientId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w_]+" - }, - "CognitoIdentityProviderList":{ - "type":"list", - "member":{"shape":"CognitoIdentityProvider"} - }, - "CognitoIdentityProviderName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w._:/-]+" - }, - "CognitoIdentityProviderTokenCheck":{"type":"boolean"}, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a ConcurrentModificationException.

" - } - }, - "documentation":"

Thrown if there are parallel requests to modify a resource.

", - "exception":true - }, - "CreateIdentityPoolInput":{ - "type":"structure", - "required":[ - "IdentityPoolName", - "AllowUnauthenticatedIdentities" - ], - "members":{ - "IdentityPoolName":{ - "shape":"IdentityPoolName", - "documentation":"

A string that you provide.

" - }, - "AllowUnauthenticatedIdentities":{ - "shape":"IdentityPoolUnauthenticated", - "documentation":"

TRUE if the identity pool supports unauthenticated logins.

" - }, - "SupportedLoginProviders":{ - "shape":"IdentityProviders", - "documentation":"

Optional key:value pairs mapping provider names to provider app IDs.

" - }, - "DeveloperProviderName":{ - "shape":"DeveloperProviderName", - "documentation":"

The \"domain\" by which Cognito will refer to your users. This name acts as a placeholder that allows your backend and the Cognito service to communicate about the developer provider. For the DeveloperProviderName, you can use letters as well as period (.), underscore (_), and dash (-).

Once you have set a developer provider name, you cannot change it. Please take care in setting this parameter.

" - }, - "OpenIdConnectProviderARNs":{ - "shape":"OIDCProviderList", - "documentation":"

A list of OpendID Connect provider ARNs.

" - }, - "CognitoIdentityProviders":{ - "shape":"CognitoIdentityProviderList", - "documentation":"

An array of Amazon Cognito Identity user pools and their client IDs.

" - }, - "SamlProviderARNs":{ - "shape":"SAMLProviderList", - "documentation":"

An array of Amazon Resource Names (ARNs) of the SAML provider for your identity pool.

" - } - }, - "documentation":"

Input to the CreateIdentityPool action.

" - }, - "Credentials":{ - "type":"structure", - "members":{ - "AccessKeyId":{ - "shape":"AccessKeyString", - "documentation":"

The Access Key portion of the credentials.

" - }, - "SecretKey":{ - "shape":"SecretKeyString", - "documentation":"

The Secret Access Key portion of the credentials

" - }, - "SessionToken":{ - "shape":"SessionTokenString", - "documentation":"

The Session Token portion of the credentials

" - }, - "Expiration":{ - "shape":"DateType", - "documentation":"

The date at which these credentials will expire.

" - } - }, - "documentation":"

Credentials for the provided identity ID.

" - }, - "DateType":{"type":"timestamp"}, - "DeleteIdentitiesInput":{ - "type":"structure", - "required":["IdentityIdsToDelete"], - "members":{ - "IdentityIdsToDelete":{ - "shape":"IdentityIdList", - "documentation":"

A list of 1-60 identities that you want to delete.

" - } - }, - "documentation":"

Input to the DeleteIdentities action.

" - }, - "DeleteIdentitiesResponse":{ - "type":"structure", - "members":{ - "UnprocessedIdentityIds":{ - "shape":"UnprocessedIdentityIdList", - "documentation":"

An array of UnprocessedIdentityId objects, each of which contains an ErrorCode and IdentityId.

" - } - }, - "documentation":"

Returned in response to a successful DeleteIdentities operation.

" - }, - "DeleteIdentityPoolInput":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - } - }, - "documentation":"

Input to the DeleteIdentityPool action.

" - }, - "DescribeIdentityInput":{ - "type":"structure", - "required":["IdentityId"], - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - } - }, - "documentation":"

Input to the DescribeIdentity action.

" - }, - "DescribeIdentityPoolInput":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - } - }, - "documentation":"

Input to the DescribeIdentityPool action.

" - }, - "DeveloperProviderName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w._-]+" - }, - "DeveloperUserAlreadyRegisteredException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

This developer user identifier is already registered with Cognito.

" - } - }, - "documentation":"

The provided developer user identifier is already registered with Cognito under a different identity ID.

", - "exception":true - }, - "DeveloperUserIdentifier":{ - "type":"string", - "max":1024, - "min":1 - }, - "DeveloperUserIdentifierList":{ - "type":"list", - "member":{"shape":"DeveloperUserIdentifier"} - }, - "ErrorCode":{ - "type":"string", - "enum":[ - "AccessDenied", - "InternalServerError" - ] - }, - "ExternalServiceException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by an ExternalServiceException

" - } - }, - "documentation":"

An exception thrown when a dependent service such as Facebook or Twitter is not responding

", - "exception":true - }, - "GetCredentialsForIdentityInput":{ - "type":"structure", - "required":["IdentityId"], - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsMap", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens.

" - }, - "CustomRoleArn":{ - "shape":"ARNString", - "documentation":"

The Amazon Resource Name (ARN) of the role to be assumed when multiple roles were received in the token from the identity provider. For example, a SAML-based identity provider. This parameter is optional for identity providers that do not support role customization.

" - } - }, - "documentation":"

Input to the GetCredentialsForIdentity action.

" - }, - "GetCredentialsForIdentityResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Credentials":{ - "shape":"Credentials", - "documentation":"

Credentials for the provided identity ID.

" - } - }, - "documentation":"

Returned in response to a successful GetCredentialsForIdentity operation.

" - }, - "GetIdInput":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

A standard AWS account ID (9+ digits).

" - }, - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsMap", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens. The available provider names for Logins are as follows:

  • Facebook: graph.facebook.com

  • Amazon Cognito Identity Provider: cognito-idp.us-east-1.amazonaws.com/us-east-1_123456789

  • Google: accounts.google.com

  • Amazon: www.amazon.com

  • Twitter: api.twitter.com

  • Digits: www.digits.com

" - } - }, - "documentation":"

Input to the GetId action.

" - }, - "GetIdResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - } - }, - "documentation":"

Returned in response to a GetId request.

" - }, - "GetIdentityPoolRolesInput":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - } - }, - "documentation":"

Input to the GetIdentityPoolRoles action.

" - }, - "GetIdentityPoolRolesResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "Roles":{ - "shape":"RolesMap", - "documentation":"

The map of roles associated with this pool. Currently only authenticated and unauthenticated roles are supported.

" - }, - "RoleMappings":{ - "shape":"RoleMappingMap", - "documentation":"

How users for a specific identity provider are to mapped to roles. This is a String-to-RoleMapping object map. The string identifies the identity provider, for example, \"graph.facebook.com\" or \"cognito-idp-east-1.amazonaws.com/us-east-1_abcdefghi:app_client_id\".

" - } - }, - "documentation":"

Returned in response to a successful GetIdentityPoolRoles operation.

" - }, - "GetOpenIdTokenForDeveloperIdentityInput":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "Logins" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsMap", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens. Each name-value pair represents a user from a public provider or developer provider. If the user is from a developer provider, the name-value pair will follow the syntax \"developer_provider_name\": \"developer_user_identifier\". The developer provider is the \"domain\" by which Cognito will refer to your users; you provided this domain while creating/updating the identity pool. The developer user identifier is an identifier from your backend that uniquely identifies a user. When you create an identity pool, you can specify the supported logins.

" - }, - "TokenDuration":{ - "shape":"TokenDuration", - "documentation":"

The expiration time of the token, in seconds. You can specify a custom expiration time for the token so that you can cache it. If you don't provide an expiration time, the token is valid for 15 minutes. You can exchange the token with Amazon STS for temporary AWS credentials, which are valid for a maximum of one hour. The maximum token duration you can set is 24 hours. You should take care in setting the expiration time for a token, as there are significant security implications: an attacker could use a leaked token to access your AWS resources for the token's duration.

" - } - }, - "documentation":"

Input to the GetOpenIdTokenForDeveloperIdentity action.

" - }, - "GetOpenIdTokenForDeveloperIdentityResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Token":{ - "shape":"OIDCToken", - "documentation":"

An OpenID token.

" - } - }, - "documentation":"

Returned in response to a successful GetOpenIdTokenForDeveloperIdentity request.

" - }, - "GetOpenIdTokenInput":{ - "type":"structure", - "required":["IdentityId"], - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsMap", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens. When using graph.facebook.com and www.amazon.com, supply the access_token returned from the provider's authflow. For accounts.google.com, an Amazon Cognito Identity Provider, or any other OpenId Connect provider, always include the id_token.

" - } - }, - "documentation":"

Input to the GetOpenIdToken action.

" - }, - "GetOpenIdTokenResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID. Note that the IdentityId returned may not match the one passed on input.

" - }, - "Token":{ - "shape":"OIDCToken", - "documentation":"

An OpenID token, valid for 15 minutes.

" - } - }, - "documentation":"

Returned in response to a successful GetOpenIdToken request.

" - }, - "HideDisabled":{"type":"boolean"}, - "IdentitiesList":{ - "type":"list", - "member":{"shape":"IdentityDescription"} - }, - "IdentityDescription":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsList", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

Date on which the identity was created.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

Date on which the identity was last modified.

" - } - }, - "documentation":"

A description of the identity.

" - }, - "IdentityId":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+:[0-9a-f-]+" - }, - "IdentityIdList":{ - "type":"list", - "member":{"shape":"IdentityId"}, - "max":60, - "min":1 - }, - "IdentityPool":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityPoolName", - "AllowUnauthenticatedIdentities" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "IdentityPoolName":{ - "shape":"IdentityPoolName", - "documentation":"

A string that you provide.

" - }, - "AllowUnauthenticatedIdentities":{ - "shape":"IdentityPoolUnauthenticated", - "documentation":"

TRUE if the identity pool supports unauthenticated logins.

" - }, - "SupportedLoginProviders":{ - "shape":"IdentityProviders", - "documentation":"

Optional key:value pairs mapping provider names to provider app IDs.

" - }, - "DeveloperProviderName":{ - "shape":"DeveloperProviderName", - "documentation":"

The \"domain\" by which Cognito will refer to your users.

" - }, - "OpenIdConnectProviderARNs":{ - "shape":"OIDCProviderList", - "documentation":"

A list of OpendID Connect provider ARNs.

" - }, - "CognitoIdentityProviders":{ - "shape":"CognitoIdentityProviderList", - "documentation":"

A list representing an Amazon Cognito Identity User Pool and its client ID.

" - }, - "SamlProviderARNs":{ - "shape":"SAMLProviderList", - "documentation":"

An array of Amazon Resource Names (ARNs) of the SAML provider for your identity pool.

" - } - }, - "documentation":"

An object representing an Amazon Cognito identity pool.

" - }, - "IdentityPoolId":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+:[0-9a-f-]+" - }, - "IdentityPoolName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w ]+" - }, - "IdentityPoolShortDescription":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "IdentityPoolName":{ - "shape":"IdentityPoolName", - "documentation":"

A string that you provide.

" - } - }, - "documentation":"

A description of the identity pool.

" - }, - "IdentityPoolUnauthenticated":{"type":"boolean"}, - "IdentityPoolsList":{ - "type":"list", - "member":{"shape":"IdentityPoolShortDescription"} - }, - "IdentityProviderId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w.;_/-]+" - }, - "IdentityProviderName":{ - "type":"string", - "max":128, - "min":1 - }, - "IdentityProviderToken":{ - "type":"string", - "max":50000, - "min":1 - }, - "IdentityProviders":{ - "type":"map", - "key":{"shape":"IdentityProviderName"}, - "value":{"shape":"IdentityProviderId"}, - "max":10 - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by an InternalErrorException.

" - } - }, - "documentation":"

Thrown when the service encounters an error during processing the request.

", - "exception":true, - "fault":true - }, - "InvalidIdentityPoolConfigurationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned for an InvalidIdentityPoolConfigurationException

" - } - }, - "documentation":"

Thrown if the identity pool has no role associated for the given auth type (auth/unauth) or if the AssumeRole fails.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by an InvalidParameterException.

" - } - }, - "documentation":"

Thrown for missing or bad input parameter(s).

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a LimitExceededException.

" - } - }, - "documentation":"

Thrown when the total number of user pools has exceeded a preset limit.

", - "exception":true - }, - "ListIdentitiesInput":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "MaxResults" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "MaxResults":{ - "shape":"QueryLimit", - "documentation":"

The maximum number of identities to return.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - }, - "HideDisabled":{ - "shape":"HideDisabled", - "documentation":"

An optional boolean parameter that allows you to hide disabled identities. If omitted, the ListIdentities API will include disabled identities in the response.

" - } - }, - "documentation":"

Input to the ListIdentities action.

" - }, - "ListIdentitiesResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "Identities":{ - "shape":"IdentitiesList", - "documentation":"

An object containing a set of identities and associated mappings.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - } - }, - "documentation":"

The response to a ListIdentities request.

" - }, - "ListIdentityPoolsInput":{ - "type":"structure", - "required":["MaxResults"], - "members":{ - "MaxResults":{ - "shape":"QueryLimit", - "documentation":"

The maximum number of identities to return.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - } - }, - "documentation":"

Input to the ListIdentityPools action.

" - }, - "ListIdentityPoolsResponse":{ - "type":"structure", - "members":{ - "IdentityPools":{ - "shape":"IdentityPoolsList", - "documentation":"

The identity pools returned by the ListIdentityPools action.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - } - }, - "documentation":"

The result of a successful ListIdentityPools action.

" - }, - "LoginsList":{ - "type":"list", - "member":{"shape":"IdentityProviderName"} - }, - "LoginsMap":{ - "type":"map", - "key":{"shape":"IdentityProviderName"}, - "value":{"shape":"IdentityProviderToken"}, - "max":10 - }, - "LookupDeveloperIdentityInput":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "DeveloperUserIdentifier":{ - "shape":"DeveloperUserIdentifier", - "documentation":"

A unique ID used by your backend authentication process to identify a user. Typically, a developer identity provider would issue many developer user identifiers, in keeping with the number of users.

" - }, - "MaxResults":{ - "shape":"QueryLimit", - "documentation":"

The maximum number of identities to return.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token. The first call you make will have NextToken set to null. After that the service will return NextToken values as needed. For example, let's say you make a request with MaxResults set to 10, and there are 20 matches in the database. The service will return a pagination token as a part of the response. This token can be used to call the API again and get results starting from the 11th match.

" - } - }, - "documentation":"

Input to the LookupDeveloperIdentityInput action.

" - }, - "LookupDeveloperIdentityResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "DeveloperUserIdentifierList":{ - "shape":"DeveloperUserIdentifierList", - "documentation":"

This is the list of developer user identifiers associated with an identity ID. Cognito supports the association of multiple developer user identifiers with an identity ID.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token. The first call you make will have NextToken set to null. After that the service will return NextToken values as needed. For example, let's say you make a request with MaxResults set to 10, and there are 20 matches in the database. The service will return a pagination token as a part of the response. This token can be used to call the API again and get results starting from the 11th match.

" - } - }, - "documentation":"

Returned in response to a successful LookupDeveloperIdentity action.

" - }, - "MappingRule":{ - "type":"structure", - "required":[ - "Claim", - "MatchType", - "Value", - "RoleARN" - ], - "members":{ - "Claim":{ - "shape":"ClaimName", - "documentation":"

The claim name that must be present in the token, for example, \"isAdmin\" or \"paid\".

" - }, - "MatchType":{ - "shape":"MappingRuleMatchType", - "documentation":"

The match condition that specifies how closely the claim value in the IdP token must match Value.

" - }, - "Value":{ - "shape":"ClaimValue", - "documentation":"

A brief string that the claim must match, for example, \"paid\" or \"yes\".

" - }, - "RoleARN":{ - "shape":"ARNString", - "documentation":"

The role ARN.

" - } - }, - "documentation":"

A rule that maps a claim name, a claim value, and a match type to a role ARN.

" - }, - "MappingRuleMatchType":{ - "type":"string", - "enum":[ - "Equals", - "Contains", - "StartsWith", - "NotEqual" - ] - }, - "MappingRulesList":{ - "type":"list", - "member":{"shape":"MappingRule"}, - "max":25, - "min":1 - }, - "MergeDeveloperIdentitiesInput":{ - "type":"structure", - "required":[ - "SourceUserIdentifier", - "DestinationUserIdentifier", - "DeveloperProviderName", - "IdentityPoolId" - ], - "members":{ - "SourceUserIdentifier":{ - "shape":"DeveloperUserIdentifier", - "documentation":"

User identifier for the source user. The value should be a DeveloperUserIdentifier.

" - }, - "DestinationUserIdentifier":{ - "shape":"DeveloperUserIdentifier", - "documentation":"

User identifier for the destination user. The value should be a DeveloperUserIdentifier.

" - }, - "DeveloperProviderName":{ - "shape":"DeveloperProviderName", - "documentation":"

The \"domain\" by which Cognito will refer to your users. This is a (pseudo) domain name that you provide while creating an identity pool. This name acts as a placeholder that allows your backend and the Cognito service to communicate about the developer provider. For the DeveloperProviderName, you can use letters as well as period (.), underscore (_), and dash (-).

" - }, - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - } - }, - "documentation":"

Input to the MergeDeveloperIdentities action.

" - }, - "MergeDeveloperIdentitiesResponse":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - } - }, - "documentation":"

Returned in response to a successful MergeDeveloperIdentities action.

" - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a NotAuthorizedException

" - } - }, - "documentation":"

Thrown when a user is not authorized to access the requested resource.

", - "exception":true - }, - "OIDCProviderList":{ - "type":"list", - "member":{"shape":"ARNString"} - }, - "OIDCToken":{"type":"string"}, - "PaginationKey":{ - "type":"string", - "min":1, - "pattern":"[\\S]+" - }, - "QueryLimit":{ - "type":"integer", - "max":60, - "min":1 - }, - "ResourceConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a ResourceConflictException.

" - } - }, - "documentation":"

Thrown when a user tries to use a login which is already linked to another account.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a ResourceNotFoundException.

" - } - }, - "documentation":"

Thrown when the requested resource (for example, a dataset or record) does not exist.

", - "exception":true - }, - "RoleMapping":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"RoleMappingType", - "documentation":"

The role mapping type. Token will use cognito:roles and cognito:preferred_role claims from the Cognito identity provider token to map groups to roles. Rules will attempt to match claims from the token to map to a role.

" - }, - "AmbiguousRoleResolution":{ - "shape":"AmbiguousRoleResolutionType", - "documentation":"

If you specify Token or Rules as the Type, AmbiguousRoleResolution is required.

Specifies the action to be taken if either no rules match the claim value for the Rules type, or there is no cognito:preferred_role claim and there are multiple cognito:roles matches for the Token type.

" - }, - "RulesConfiguration":{ - "shape":"RulesConfigurationType", - "documentation":"

The rules to be used for mapping users to roles.

If you specify Rules as the role mapping type, RulesConfiguration is required.

" - } - }, - "documentation":"

A role mapping.

" - }, - "RoleMappingMap":{ - "type":"map", - "key":{"shape":"IdentityProviderName"}, - "value":{"shape":"RoleMapping"}, - "max":10 - }, - "RoleMappingType":{ - "type":"string", - "enum":[ - "Token", - "Rules" - ] - }, - "RoleType":{ - "type":"string", - "pattern":"(un)?authenticated" - }, - "RolesMap":{ - "type":"map", - "key":{"shape":"RoleType"}, - "value":{"shape":"ARNString"}, - "max":2 - }, - "RulesConfigurationType":{ - "type":"structure", - "required":["Rules"], - "members":{ - "Rules":{ - "shape":"MappingRulesList", - "documentation":"

An array of rules. You can specify up to 25 rules per identity provider.

Rules are evaluated in order. The first one to match specifies the role.

" - } - }, - "documentation":"

A container for rules.

" - }, - "SAMLProviderList":{ - "type":"list", - "member":{"shape":"ARNString"} - }, - "SecretKeyString":{"type":"string"}, - "SessionTokenString":{"type":"string"}, - "SetIdentityPoolRolesInput":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "Roles" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "Roles":{ - "shape":"RolesMap", - "documentation":"

The map of roles associated with this pool. For a given role, the key will be either \"authenticated\" or \"unauthenticated\" and the value will be the Role ARN.

" - }, - "RoleMappings":{ - "shape":"RoleMappingMap", - "documentation":"

How users for a specific identity provider are to mapped to roles. This is a string to RoleMapping object map. The string identifies the identity provider, for example, \"graph.facebook.com\" or \"cognito-idp-east-1.amazonaws.com/us-east-1_abcdefghi:app_client_id\".

Up to 25 rules can be specified per identity provider.

" - } - }, - "documentation":"

Input to the SetIdentityPoolRoles action.

" - }, - "String":{"type":"string"}, - "TokenDuration":{ - "type":"long", - "max":86400, - "min":1 - }, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

Message returned by a TooManyRequestsException

" - } - }, - "documentation":"

Thrown when a request is throttled.

", - "exception":true - }, - "UnlinkDeveloperIdentityInput":{ - "type":"structure", - "required":[ - "IdentityId", - "IdentityPoolId", - "DeveloperProviderName", - "DeveloperUserIdentifier" - ], - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

An identity pool ID in the format REGION:GUID.

" - }, - "DeveloperProviderName":{ - "shape":"DeveloperProviderName", - "documentation":"

The \"domain\" by which Cognito will refer to your users.

" - }, - "DeveloperUserIdentifier":{ - "shape":"DeveloperUserIdentifier", - "documentation":"

A unique ID used by your backend authentication process to identify a user.

" - } - }, - "documentation":"

Input to the UnlinkDeveloperIdentity action.

" - }, - "UnlinkIdentityInput":{ - "type":"structure", - "required":[ - "IdentityId", - "Logins", - "LoginsToRemove" - ], - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "Logins":{ - "shape":"LoginsMap", - "documentation":"

A set of optional name-value pairs that map provider names to provider tokens.

" - }, - "LoginsToRemove":{ - "shape":"LoginsList", - "documentation":"

Provider names to unlink from this identity.

" - } - }, - "documentation":"

Input to the UnlinkIdentity action.

" - }, - "UnprocessedIdentityId":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"

A unique identifier in the format REGION:GUID.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code indicating the type of error that occurred.

" - } - }, - "documentation":"

An array of UnprocessedIdentityId objects, each of which contains an ErrorCode and IdentityId.

" - }, - "UnprocessedIdentityIdList":{ - "type":"list", - "member":{"shape":"UnprocessedIdentityId"}, - "max":60 - } - }, - "documentation":"Amazon Cognito

Amazon Cognito is a web service that delivers scoped temporary credentials to mobile devices and other untrusted environments. Amazon Cognito uniquely identifies a device and supplies the user with a consistent identity over the lifetime of an application.

Using Amazon Cognito, you can enable authentication with one or more third-party identity providers (Facebook, Google, or Login with Amazon), and you can also choose to support unauthenticated access from your app. Cognito delivers a unique identifier for each user and acts as an OpenID token provider trusted by AWS Security Token Service (STS) to access temporary, limited-privilege AWS credentials.

To provide end-user credentials, first make an unsigned call to GetId. If the end user is authenticated with one of the supported identity providers, set the Logins map with the identity provider token. GetId returns a unique identifier for the user.

Next, make an unsigned call to GetCredentialsForIdentity. This call expects the same Logins map as the GetId call, as well as the IdentityID originally returned by GetId. Assuming your identity pool has been configured via the SetIdentityPoolRoles operation, GetCredentialsForIdentity will return AWS credentials for your use. If your pool has not been configured with SetIdentityPoolRoles, or if you want to follow legacy flow, make an unsigned call to GetOpenIdToken, which returns the OpenID token necessary to call STS and retrieve AWS credentials. This call expects the same Logins map as the GetId call, as well as the IdentityID originally returned by GetId. The token returned by GetOpenIdToken can be passed to the STS operation AssumeRoleWithWebIdentity to retrieve AWS credentials.

If you want to use Amazon Cognito in an Android, iOS, or Unity application, you will probably want to make API calls via the AWS Mobile SDK. To learn more, see the AWS Mobile SDK Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/service-2.json deleted file mode 100644 index f861dd24..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-idp/2016-04-18/service-2.json +++ /dev/null @@ -1,7636 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-04-18", - "endpointPrefix":"cognito-idp", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Cognito Identity Provider", - "serviceId":"Cognito Identity Provider", - "signatureVersion":"v4", - "targetPrefix":"AWSCognitoIdentityProviderService", - "uid":"cognito-idp-2016-04-18" - }, - "operations":{ - "AddCustomAttributes":{ - "name":"AddCustomAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddCustomAttributesRequest"}, - "output":{"shape":"AddCustomAttributesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserImportInProgressException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Adds additional user attributes to the user pool schema.

" - }, - "AdminAddUserToGroup":{ - "name":"AdminAddUserToGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminAddUserToGroupRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Adds the specified user to the specified group.

Requires developer credentials.

" - }, - "AdminConfirmSignUp":{ - "name":"AdminConfirmSignUp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminConfirmSignUpRequest"}, - "output":{"shape":"AdminConfirmSignUpResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyFailedAttemptsException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Confirms user registration as an admin without using a confirmation code. Works on any user.

Requires developer credentials.

" - }, - "AdminCreateUser":{ - "name":"AdminCreateUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminCreateUserRequest"}, - "output":{"shape":"AdminCreateUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UsernameExistsException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"PreconditionNotMetException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UnsupportedUserStateException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates a new user in the specified user pool.

If MessageAction is not set, the default is to send a welcome message via email or phone (SMS).

This message is based on a template that you configured in your call to or . This template includes your custom sign-up instructions and placeholders for user name and temporary password.

Alternatively, you can call AdminCreateUser with “SUPPRESS” for the MessageAction parameter, and Amazon Cognito will not send any email.

In either case, the user will be in the FORCE_CHANGE_PASSWORD state until they sign in and change their password.

AdminCreateUser requires developer credentials.

" - }, - "AdminDeleteUser":{ - "name":"AdminDeleteUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminDeleteUserRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes a user as an administrator. Works on any user.

Requires developer credentials.

" - }, - "AdminDeleteUserAttributes":{ - "name":"AdminDeleteUserAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminDeleteUserAttributesRequest"}, - "output":{"shape":"AdminDeleteUserAttributesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes the user attributes in a user pool as an administrator. Works on any user.

Requires developer credentials.

" - }, - "AdminDisableProviderForUser":{ - "name":"AdminDisableProviderForUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminDisableProviderForUserRequest"}, - "output":{"shape":"AdminDisableProviderForUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"AliasExistsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Disables the user from signing in with the specified external (SAML or social) identity provider. If the user to disable is a Cognito User Pools native username + password user, they are not permitted to use their password to sign-in. If the user to disable is a linked external IdP user, any link between that user and an existing user is removed. The next time the external user (no longer attached to the previously linked DestinationUser) signs in, they must create a new user account. See .

This action is enabled only for admin access and requires developer credentials.

The ProviderName must match the value specified when creating an IdP for the pool.

To disable a native username + password user, the ProviderName value must be Cognito and the ProviderAttributeName must be Cognito_Subject, with the ProviderAttributeValue being the name that is used in the user pool for the user.

The ProviderAttributeName must always be Cognito_Subject for social identity providers. The ProviderAttributeValue must always be the exact subject that was used when the user was originally linked as a source user.

For de-linking a SAML identity, there are two scenarios. If the linked identity has not yet been used to sign-in, the ProviderAttributeName and ProviderAttributeValue must be the same values that were used for the SourceUser when the identities were originally linked in the call. (If the linking was done with ProviderAttributeName set to Cognito_Subject, the same applies here). However, if the user has already signed in, the ProviderAttributeName must be Cognito_Subject and ProviderAttributeValue must be the subject of the SAML assertion.

" - }, - "AdminDisableUser":{ - "name":"AdminDisableUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminDisableUserRequest"}, - "output":{"shape":"AdminDisableUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Disables the specified user as an administrator. Works on any user.

Requires developer credentials.

" - }, - "AdminEnableUser":{ - "name":"AdminEnableUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminEnableUserRequest"}, - "output":{"shape":"AdminEnableUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Enables the specified user as an administrator. Works on any user.

Requires developer credentials.

" - }, - "AdminForgetDevice":{ - "name":"AdminForgetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminForgetDeviceRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Forgets the device, as an administrator.

Requires developer credentials.

" - }, - "AdminGetDevice":{ - "name":"AdminGetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminGetDeviceRequest"}, - "output":{"shape":"AdminGetDeviceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Gets the device, as an administrator.

Requires developer credentials.

" - }, - "AdminGetUser":{ - "name":"AdminGetUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminGetUserRequest"}, - "output":{"shape":"AdminGetUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the specified user by user name in a user pool as an administrator. Works on any user.

Requires developer credentials.

" - }, - "AdminInitiateAuth":{ - "name":"AdminInitiateAuth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminInitiateAuthRequest"}, - "output":{"shape":"AdminInitiateAuthResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"MFAMethodNotFoundException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"} - ], - "documentation":"

Initiates the authentication flow, as an administrator.

Requires developer credentials.

" - }, - "AdminLinkProviderForUser":{ - "name":"AdminLinkProviderForUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminLinkProviderForUserRequest"}, - "output":{"shape":"AdminLinkProviderForUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"AliasExistsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Links an existing user account in a user pool (DestinationUser) to an identity from an external identity provider (SourceUser) based on a specified attribute name and value from the external identity provider. This allows you to create a link from the existing user account to an external federated user identity that has not yet been used to sign in, so that the federated user identity can be used to sign in as the existing user account.

For example, if there is an existing user with a username and password, this API links that user to a federated user identity, so that when the federated user identity is used, the user signs in as the existing user account.

Because this API allows a user with an external federated identity to sign in as an existing user in the user pool, it is critical that it only be used with external identity providers and provider attributes that have been trusted by the application owner.

See also .

This action is enabled only for admin access and requires developer credentials.

" - }, - "AdminListDevices":{ - "name":"AdminListDevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminListDevicesRequest"}, - "output":{"shape":"AdminListDevicesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Lists devices, as an administrator.

Requires developer credentials.

" - }, - "AdminListGroupsForUser":{ - "name":"AdminListGroupsForUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminListGroupsForUserRequest"}, - "output":{"shape":"AdminListGroupsForUserResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the groups that the user belongs to.

Requires developer credentials.

" - }, - "AdminListUserAuthEvents":{ - "name":"AdminListUserAuthEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminListUserAuthEventsRequest"}, - "output":{"shape":"AdminListUserAuthEventsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserPoolAddOnNotEnabledException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists a history of user activity and any risks detected as part of Amazon Cognito advanced security.

" - }, - "AdminRemoveUserFromGroup":{ - "name":"AdminRemoveUserFromGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminRemoveUserFromGroupRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Removes the specified user from the specified group.

Requires developer credentials.

" - }, - "AdminResetUserPassword":{ - "name":"AdminResetUserPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminResetUserPasswordRequest"}, - "output":{"shape":"AdminResetUserPasswordResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Resets the specified user's password in a user pool as an administrator. Works on any user.

When a developer calls this API, the current password is invalidated, so it must be changed. If a user tries to sign in after the API is called, the app will get a PasswordResetRequiredException exception back and should direct the user down the flow to reset the password, which is the same as the forgot password flow. In addition, if the user pool has phone verification selected and a verified phone number exists for the user, or if email verification is selected and a verified email exists for the user, calling this API will also result in sending a message to the end user with the code to change their password.

Requires developer credentials.

" - }, - "AdminRespondToAuthChallenge":{ - "name":"AdminRespondToAuthChallenge", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminRespondToAuthChallengeRequest"}, - "output":{"shape":"AdminRespondToAuthChallengeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"InternalErrorException"}, - {"shape":"MFAMethodNotFoundException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"AliasExistsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"SoftwareTokenMFANotFoundException"} - ], - "documentation":"

Responds to an authentication challenge, as an administrator.

Requires developer credentials.

" - }, - "AdminSetUserMFAPreference":{ - "name":"AdminSetUserMFAPreference", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminSetUserMFAPreferenceRequest"}, - "output":{"shape":"AdminSetUserMFAPreferenceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Sets the user's multi-factor authentication (MFA) preference.

" - }, - "AdminSetUserSettings":{ - "name":"AdminSetUserSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminSetUserSettingsRequest"}, - "output":{"shape":"AdminSetUserSettingsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Sets all the user settings for a specified user name. Works on any user.

Requires developer credentials.

" - }, - "AdminUpdateAuthEventFeedback":{ - "name":"AdminUpdateAuthEventFeedback", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminUpdateAuthEventFeedbackRequest"}, - "output":{"shape":"AdminUpdateAuthEventFeedbackResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserPoolAddOnNotEnabledException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Provides feedback for an authentication event as to whether it was from a valid user. This feedback is used for improving the risk evaluation decision for the user pool as part of Amazon Cognito advanced security.

" - }, - "AdminUpdateDeviceStatus":{ - "name":"AdminUpdateDeviceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminUpdateDeviceStatusRequest"}, - "output":{"shape":"AdminUpdateDeviceStatusResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates the device status as an administrator.

Requires developer credentials.

" - }, - "AdminUpdateUserAttributes":{ - "name":"AdminUpdateUserAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminUpdateUserAttributesRequest"}, - "output":{"shape":"AdminUpdateUserAttributesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"AliasExistsException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates the specified user's attributes, including developer attributes, as an administrator. Works on any user.

For custom attributes, you must prepend the custom: prefix to the attribute name.

In addition to updating user attributes, this API can also be used to mark phone and email as verified.

Requires developer credentials.

" - }, - "AdminUserGlobalSignOut":{ - "name":"AdminUserGlobalSignOut", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AdminUserGlobalSignOutRequest"}, - "output":{"shape":"AdminUserGlobalSignOutResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Signs out users from all devices, as an administrator.

Requires developer credentials.

" - }, - "AssociateSoftwareToken":{ - "name":"AssociateSoftwareToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateSoftwareTokenRequest"}, - "output":{"shape":"AssociateSoftwareTokenResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"}, - {"shape":"SoftwareTokenMFANotFoundException"} - ], - "documentation":"

Returns a unique generated shared secret key code for the user account. The request takes an access token or a session string, but not both.

" - }, - "ChangePassword":{ - "name":"ChangePassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ChangePasswordRequest"}, - "output":{"shape":"ChangePasswordResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Changes the password for a specified user in a user pool.

", - "authtype":"none" - }, - "ConfirmDevice":{ - "name":"ConfirmDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmDeviceRequest"}, - "output":{"shape":"ConfirmDeviceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"UsernameExistsException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Confirms tracking of the device. This API call is the call that begins device tracking.

" - }, - "ConfirmForgotPassword":{ - "name":"ConfirmForgotPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmForgotPasswordRequest"}, - "output":{"shape":"ConfirmForgotPasswordResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"TooManyFailedAttemptsException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Allows a user to enter a confirmation code to reset a forgotten password.

", - "authtype":"none" - }, - "ConfirmSignUp":{ - "name":"ConfirmSignUp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmSignUpRequest"}, - "output":{"shape":"ConfirmSignUpResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyFailedAttemptsException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"AliasExistsException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Confirms registration of a user and handles the existing alias from a previous user.

", - "authtype":"none" - }, - "CreateGroup":{ - "name":"CreateGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGroupRequest"}, - "output":{"shape":"CreateGroupResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"GroupExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates a new group in the specified user pool.

Requires developer credentials.

" - }, - "CreateIdentityProvider":{ - "name":"CreateIdentityProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateIdentityProviderRequest"}, - "output":{"shape":"CreateIdentityProviderResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"DuplicateProviderException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates an identity provider for a user pool.

" - }, - "CreateResourceServer":{ - "name":"CreateResourceServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateResourceServerRequest"}, - "output":{"shape":"CreateResourceServerResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates a new OAuth2.0 resource server and defines custom scopes in it.

" - }, - "CreateUserImportJob":{ - "name":"CreateUserImportJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserImportJobRequest"}, - "output":{"shape":"CreateUserImportJobResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PreconditionNotMetException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates the user import job.

" - }, - "CreateUserPool":{ - "name":"CreateUserPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserPoolRequest"}, - "output":{"shape":"CreateUserPoolResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserPoolTaggingException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates a new Amazon Cognito user pool and sets the password policy for the pool.

" - }, - "CreateUserPoolClient":{ - "name":"CreateUserPoolClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserPoolClientRequest"}, - "output":{"shape":"CreateUserPoolClientResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ScopeDoesNotExistException"}, - {"shape":"InvalidOAuthFlowException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates the user pool client.

" - }, - "CreateUserPoolDomain":{ - "name":"CreateUserPoolDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserPoolDomainRequest"}, - "output":{"shape":"CreateUserPoolDomainResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates a new domain for a user pool.

" - }, - "DeleteGroup":{ - "name":"DeleteGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGroupRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes a group. Currently only groups with no members can be deleted.

Requires developer credentials.

" - }, - "DeleteIdentityProvider":{ - "name":"DeleteIdentityProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIdentityProviderRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedIdentityProviderException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes an identity provider for a user pool.

" - }, - "DeleteResourceServer":{ - "name":"DeleteResourceServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteResourceServerRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes a resource server.

" - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Allows a user to delete himself or herself.

", - "authtype":"none" - }, - "DeleteUserAttributes":{ - "name":"DeleteUserAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserAttributesRequest"}, - "output":{"shape":"DeleteUserAttributesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes the attributes for a user.

", - "authtype":"none" - }, - "DeleteUserPool":{ - "name":"DeleteUserPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserPoolRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserImportInProgressException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes the specified Amazon Cognito user pool.

" - }, - "DeleteUserPoolClient":{ - "name":"DeleteUserPoolClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserPoolClientRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Allows the developer to delete the user pool client.

" - }, - "DeleteUserPoolDomain":{ - "name":"DeleteUserPoolDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserPoolDomainRequest"}, - "output":{"shape":"DeleteUserPoolDomainResponse"}, - "errors":[ - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes a domain for a user pool.

" - }, - "DescribeIdentityProvider":{ - "name":"DescribeIdentityProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityProviderRequest"}, - "output":{"shape":"DescribeIdentityProviderResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets information about a specific identity provider.

" - }, - "DescribeResourceServer":{ - "name":"DescribeResourceServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResourceServerRequest"}, - "output":{"shape":"DescribeResourceServerResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Describes a resource server.

" - }, - "DescribeRiskConfiguration":{ - "name":"DescribeRiskConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRiskConfigurationRequest"}, - "output":{"shape":"DescribeRiskConfigurationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserPoolAddOnNotEnabledException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Describes the risk configuration.

" - }, - "DescribeUserImportJob":{ - "name":"DescribeUserImportJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserImportJobRequest"}, - "output":{"shape":"DescribeUserImportJobResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Describes the user import job.

" - }, - "DescribeUserPool":{ - "name":"DescribeUserPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserPoolRequest"}, - "output":{"shape":"DescribeUserPoolResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserPoolTaggingException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns the configuration information and metadata of the specified user pool.

" - }, - "DescribeUserPoolClient":{ - "name":"DescribeUserPoolClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserPoolClientRequest"}, - "output":{"shape":"DescribeUserPoolClientResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Client method for returning the configuration information and metadata of the specified user pool client.

" - }, - "DescribeUserPoolDomain":{ - "name":"DescribeUserPoolDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserPoolDomainRequest"}, - "output":{"shape":"DescribeUserPoolDomainResponse"}, - "errors":[ - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets information about a domain.

" - }, - "ForgetDevice":{ - "name":"ForgetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ForgetDeviceRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Forgets the specified device.

" - }, - "ForgotPassword":{ - "name":"ForgotPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ForgotPasswordRequest"}, - "output":{"shape":"ForgotPasswordResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Calling this API causes a message to be sent to the end user with a confirmation code that is required to change the user's password. For the Username parameter, you can use the username or user alias. If a verified phone number exists for the user, the confirmation code is sent to the phone number. Otherwise, if a verified email exists, the confirmation code is sent to the email. If neither a verified phone number nor a verified email exists, InvalidParameterException is thrown. To use the confirmation code for resetting the password, call .

", - "authtype":"none" - }, - "GetCSVHeader":{ - "name":"GetCSVHeader", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCSVHeaderRequest"}, - "output":{"shape":"GetCSVHeaderResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the header information for the .csv file to be used as input for the user import job.

" - }, - "GetDevice":{ - "name":"GetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeviceRequest"}, - "output":{"shape":"GetDeviceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the device.

" - }, - "GetGroup":{ - "name":"GetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGroupRequest"}, - "output":{"shape":"GetGroupResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets a group.

Requires developer credentials.

" - }, - "GetIdentityProviderByIdentifier":{ - "name":"GetIdentityProviderByIdentifier", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityProviderByIdentifierRequest"}, - "output":{"shape":"GetIdentityProviderByIdentifierResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the specified identity provider.

" - }, - "GetSigningCertificate":{ - "name":"GetSigningCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSigningCertificateRequest"}, - "output":{"shape":"GetSigningCertificateResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

This method takes a user pool ID, and returns the signing certificate.

" - }, - "GetUICustomization":{ - "name":"GetUICustomization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUICustomizationRequest"}, - "output":{"shape":"GetUICustomizationResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the UI Customization information for a particular app client's app UI, if there is something set. If nothing is set for the particular client, but there is an existing pool level customization (app clientId will be ALL), then that is returned. If nothing is present, then an empty shape is returned.

" - }, - "GetUser":{ - "name":"GetUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserRequest"}, - "output":{"shape":"GetUserResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the user attributes and metadata for a user.

", - "authtype":"none" - }, - "GetUserAttributeVerificationCode":{ - "name":"GetUserAttributeVerificationCode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserAttributeVerificationCodeRequest"}, - "output":{"shape":"GetUserAttributeVerificationCodeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"LimitExceededException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the user attribute verification code for the specified attribute name.

", - "authtype":"none" - }, - "GetUserPoolMfaConfig":{ - "name":"GetUserPoolMfaConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserPoolMfaConfigRequest"}, - "output":{"shape":"GetUserPoolMfaConfigResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Gets the user pool multi-factor authentication (MFA) configuration.

" - }, - "GlobalSignOut":{ - "name":"GlobalSignOut", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GlobalSignOutRequest"}, - "output":{"shape":"GlobalSignOutResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Signs out users from all devices.

" - }, - "InitiateAuth":{ - "name":"InitiateAuth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InitiateAuthRequest"}, - "output":{"shape":"InitiateAuthResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Initiates the authentication flow.

" - }, - "ListDevices":{ - "name":"ListDevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDevicesRequest"}, - "output":{"shape":"ListDevicesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the devices.

" - }, - "ListGroups":{ - "name":"ListGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupsRequest"}, - "output":{"shape":"ListGroupsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the groups associated with a user pool.

Requires developer credentials.

" - }, - "ListIdentityProviders":{ - "name":"ListIdentityProviders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIdentityProvidersRequest"}, - "output":{"shape":"ListIdentityProvidersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists information about all identity providers for a user pool.

" - }, - "ListResourceServers":{ - "name":"ListResourceServers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourceServersRequest"}, - "output":{"shape":"ListResourceServersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the resource servers for a user pool.

" - }, - "ListUserImportJobs":{ - "name":"ListUserImportJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUserImportJobsRequest"}, - "output":{"shape":"ListUserImportJobsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the user import jobs.

" - }, - "ListUserPoolClients":{ - "name":"ListUserPoolClients", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUserPoolClientsRequest"}, - "output":{"shape":"ListUserPoolClientsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the clients that have been created for the specified user pool.

" - }, - "ListUserPools":{ - "name":"ListUserPools", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUserPoolsRequest"}, - "output":{"shape":"ListUserPoolsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the user pools associated with an AWS account.

" - }, - "ListUsers":{ - "name":"ListUsers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUsersRequest"}, - "output":{"shape":"ListUsersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the users in the Amazon Cognito user pool.

" - }, - "ListUsersInGroup":{ - "name":"ListUsersInGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUsersInGroupRequest"}, - "output":{"shape":"ListUsersInGroupResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Lists the users in the specified group.

Requires developer credentials.

" - }, - "ResendConfirmationCode":{ - "name":"ResendConfirmationCode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResendConfirmationCodeRequest"}, - "output":{"shape":"ResendConfirmationCodeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Resends the confirmation (for confirmation of registration) to a specific user in the user pool.

", - "authtype":"none" - }, - "RespondToAuthChallenge":{ - "name":"RespondToAuthChallenge", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RespondToAuthChallengeRequest"}, - "output":{"shape":"RespondToAuthChallengeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"MFAMethodNotFoundException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"AliasExistsException"}, - {"shape":"InternalErrorException"}, - {"shape":"SoftwareTokenMFANotFoundException"} - ], - "documentation":"

Responds to the authentication challenge.

" - }, - "SetRiskConfiguration":{ - "name":"SetRiskConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetRiskConfigurationRequest"}, - "output":{"shape":"SetRiskConfigurationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserPoolAddOnNotEnabledException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Configures actions on detected risks. To delete the risk configuration for UserPoolId or ClientId, pass null values for all four configuration types.

To enable Amazon Cognito advanced security features, update the user pool to include the UserPoolAddOns keyAdvancedSecurityMode.

See .

" - }, - "SetUICustomization":{ - "name":"SetUICustomization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetUICustomizationRequest"}, - "output":{"shape":"SetUICustomizationResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Sets the UI customization information for a user pool's built-in app UI.

You can specify app UI customization settings for a single client (with a specific clientId) or for all clients (by setting the clientId to ALL). If you specify ALL, the default configuration will be used for every client that has no UI customization set previously. If you specify UI customization settings for a particular client, it will no longer fall back to the ALL configuration.

To use this API, your user pool must have a domain associated with it. Otherwise, there is no place to host the app's pages, and the service will throw an error.

" - }, - "SetUserMFAPreference":{ - "name":"SetUserMFAPreference", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetUserMFAPreferenceRequest"}, - "output":{"shape":"SetUserMFAPreferenceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Set the user's multi-factor authentication (MFA) method preference.

" - }, - "SetUserPoolMfaConfig":{ - "name":"SetUserPoolMfaConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetUserPoolMfaConfigRequest"}, - "output":{"shape":"SetUserPoolMfaConfigResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Set the user pool MFA configuration.

" - }, - "SetUserSettings":{ - "name":"SetUserSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetUserSettingsRequest"}, - "output":{"shape":"SetUserSettingsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Sets the user settings like multi-factor authentication (MFA). If MFA is to be removed for a particular attribute pass the attribute with code delivery as null. If null list is passed, all MFA options are removed.

", - "authtype":"none" - }, - "SignUp":{ - "name":"SignUp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SignUpRequest"}, - "output":{"shape":"SignUpResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"UsernameExistsException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"CodeDeliveryFailureException"} - ], - "documentation":"

Registers the user in the specified user pool and creates a user name, password, and user attributes.

", - "authtype":"none" - }, - "StartUserImportJob":{ - "name":"StartUserImportJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartUserImportJobRequest"}, - "output":{"shape":"StartUserImportJobResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"PreconditionNotMetException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Starts the user import.

" - }, - "StopUserImportJob":{ - "name":"StopUserImportJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopUserImportJobRequest"}, - "output":{"shape":"StopUserImportJobResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"}, - {"shape":"PreconditionNotMetException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Stops the user import job.

" - }, - "UpdateAuthEventFeedback":{ - "name":"UpdateAuthEventFeedback", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAuthEventFeedbackRequest"}, - "output":{"shape":"UpdateAuthEventFeedbackResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserPoolAddOnNotEnabledException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Provides the feedback for an authentication event whether it was from a valid user or not. This feedback is used for improving the risk evaluation decision for the user pool as part of Amazon Cognito advanced security.

" - }, - "UpdateDeviceStatus":{ - "name":"UpdateDeviceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDeviceStatusRequest"}, - "output":{"shape":"UpdateDeviceStatusResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates the device status.

" - }, - "UpdateGroup":{ - "name":"UpdateGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGroupRequest"}, - "output":{"shape":"UpdateGroupResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates the specified group with the specified attributes.

Requires developer credentials.

" - }, - "UpdateIdentityProvider":{ - "name":"UpdateIdentityProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateIdentityProviderRequest"}, - "output":{"shape":"UpdateIdentityProviderResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedIdentityProviderException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates identity provider information for a user pool.

" - }, - "UpdateResourceServer":{ - "name":"UpdateResourceServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateResourceServerRequest"}, - "output":{"shape":"UpdateResourceServerResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Updates the name and scopes of resource server. All other fields are read-only.

" - }, - "UpdateUserAttributes":{ - "name":"UpdateUserAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserAttributesRequest"}, - "output":{"shape":"UpdateUserAttributesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UnexpectedLambdaException"}, - {"shape":"UserLambdaValidationException"}, - {"shape":"InvalidLambdaResponseException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"AliasExistsException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"}, - {"shape":"CodeDeliveryFailureException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Allows a user to update a specific attribute (one at a time).

", - "authtype":"none" - }, - "UpdateUserPool":{ - "name":"UpdateUserPool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserPoolRequest"}, - "output":{"shape":"UpdateUserPoolResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UserImportInProgressException"}, - {"shape":"InternalErrorException"}, - {"shape":"InvalidSmsRoleAccessPolicyException"}, - {"shape":"InvalidSmsRoleTrustRelationshipException"}, - {"shape":"UserPoolTaggingException"}, - {"shape":"InvalidEmailRoleAccessPolicyException"} - ], - "documentation":"

Updates the specified user pool with the specified attributes.

" - }, - "UpdateUserPoolClient":{ - "name":"UpdateUserPoolClient", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserPoolClientRequest"}, - "output":{"shape":"UpdateUserPoolClientResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"ScopeDoesNotExistException"}, - {"shape":"InvalidOAuthFlowException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Allows the developer to update the specified user pool client and password policy.

" - }, - "VerifySoftwareToken":{ - "name":"VerifySoftwareToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifySoftwareTokenRequest"}, - "output":{"shape":"VerifySoftwareTokenResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidUserPoolConfigurationException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"}, - {"shape":"EnableSoftwareTokenMFAException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"SoftwareTokenMFANotFoundException"}, - {"shape":"CodeMismatchException"} - ], - "documentation":"

Use this API to register a user's entered TOTP code and mark the user's software token MFA status as \"verified\" if successful. The request takes an access token or a session string, but not both.

" - }, - "VerifyUserAttribute":{ - "name":"VerifyUserAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyUserAttributeRequest"}, - "output":{"shape":"VerifyUserAttributeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"CodeMismatchException"}, - {"shape":"ExpiredCodeException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"LimitExceededException"}, - {"shape":"PasswordResetRequiredException"}, - {"shape":"UserNotFoundException"}, - {"shape":"UserNotConfirmedException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Verifies the specified user attributes in the user pool.

", - "authtype":"none" - } - }, - "shapes":{ - "AWSAccountIdType":{"type":"string"}, - "AccountTakeoverActionNotifyType":{"type":"boolean"}, - "AccountTakeoverActionType":{ - "type":"structure", - "required":[ - "Notify", - "EventAction" - ], - "members":{ - "Notify":{ - "shape":"AccountTakeoverActionNotifyType", - "documentation":"

Flag specifying whether to send a notification.

" - }, - "EventAction":{ - "shape":"AccountTakeoverEventActionType", - "documentation":"

The event action.

  • BLOCK Choosing this action will block the request.

  • MFA_IF_CONFIGURED Throw MFA challenge if user has configured it, else allow the request.

  • MFA_REQUIRED Throw MFA challenge if user has configured it, else block the request.

  • NO_ACTION Allow the user sign-in.

" - } - }, - "documentation":"

Account takeover action type.

" - }, - "AccountTakeoverActionsType":{ - "type":"structure", - "members":{ - "LowAction":{ - "shape":"AccountTakeoverActionType", - "documentation":"

Action to take for a low risk.

" - }, - "MediumAction":{ - "shape":"AccountTakeoverActionType", - "documentation":"

Action to take for a medium risk.

" - }, - "HighAction":{ - "shape":"AccountTakeoverActionType", - "documentation":"

Action to take for a high risk.

" - } - }, - "documentation":"

Account takeover actions type.

" - }, - "AccountTakeoverEventActionType":{ - "type":"string", - "enum":[ - "BLOCK", - "MFA_IF_CONFIGURED", - "MFA_REQUIRED", - "NO_ACTION" - ] - }, - "AccountTakeoverRiskConfigurationType":{ - "type":"structure", - "required":["Actions"], - "members":{ - "NotifyConfiguration":{ - "shape":"NotifyConfigurationType", - "documentation":"

The notify configuration used to construct email notifications.

" - }, - "Actions":{ - "shape":"AccountTakeoverActionsType", - "documentation":"

Account takeover risk configuration actions

" - } - }, - "documentation":"

Configuration for mitigation actions and notification for different levels of risk detected for a potential account takeover.

" - }, - "AddCustomAttributesRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "CustomAttributes" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to add custom attributes.

" - }, - "CustomAttributes":{ - "shape":"CustomAttributesListType", - "documentation":"

An array of custom attributes, such as Mutable and Name.

" - } - }, - "documentation":"

Represents the request to add custom attributes.

" - }, - "AddCustomAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server for the request to add custom attributes.

" - }, - "AdminAddUserToGroupRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "GroupName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The username for the user.

" - }, - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The group name.

" - } - } - }, - "AdminConfirmSignUpRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for which you want to confirm user registration.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name for which you want to confirm user registration.

" - } - }, - "documentation":"

Represents the request to confirm user registration.

" - }, - "AdminConfirmSignUpResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server for the request to confirm registration.

" - }, - "AdminCreateUserConfigType":{ - "type":"structure", - "members":{ - "AllowAdminCreateUserOnly":{ - "shape":"BooleanType", - "documentation":"

Set to True if only the administrator is allowed to create user profiles. Set to False if users can sign themselves up via an app.

" - }, - "UnusedAccountValidityDays":{ - "shape":"AdminCreateUserUnusedAccountValidityDaysType", - "documentation":"

The user account expiration limit, in days, after which the account is no longer usable. To reset the account after that time limit, you must call AdminCreateUser again, specifying \"RESEND\" for the MessageAction parameter. The default value for this parameter is 7.

" - }, - "InviteMessageTemplate":{ - "shape":"MessageTemplateType", - "documentation":"

The message template to be used for the welcome message to new users.

See also Customizing User Invitation Messages.

" - } - }, - "documentation":"

The configuration for creating a new user profile.

" - }, - "AdminCreateUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where the user will be created.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The username for the user. Must be unique within the user pool. Must be a UTF-8 string between 1 and 128 characters. After the user is created, the username cannot be changed.

" - }, - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs that contain user attributes and attribute values to be set for the user to be created. You can create a user without specifying any attributes other than Username. However, any attributes that you specify as required (in or in the Attributes tab of the console) must be supplied either by you (in your call to AdminCreateUser) or by the user (when he or she signs up in response to your welcome message).

For custom attributes, you must prepend the custom: prefix to the attribute name.

To send a message inviting the user to sign up, you must specify the user's email address or phone number. This can be done in your call to AdminCreateUser or in the Users tab of the Amazon Cognito console for managing your user pools.

In your call to AdminCreateUser, you can set the email_verified attribute to True, and you can set the phone_number_verified attribute to True. (You can also do this by calling .)

  • email: The email address of the user to whom the message that contains the code and username will be sent. Required if the email_verified attribute is set to True, or if \"EMAIL\" is specified in the DesiredDeliveryMediums parameter.

  • phone_number: The phone number of the user to whom the message that contains the code and username will be sent. Required if the phone_number_verified attribute is set to True, or if \"SMS\" is specified in the DesiredDeliveryMediums parameter.

" - }, - "ValidationData":{ - "shape":"AttributeListType", - "documentation":"

The user's validation data. This is an array of name-value pairs that contain user attributes and attribute values that you can use for custom validation, such as restricting the types of user accounts that can be registered. For example, you might choose to allow or disallow user sign-up based on the user's domain.

To configure custom validation, you must create a Pre Sign-up Lambda trigger for the user pool as described in the Amazon Cognito Developer Guide. The Lambda trigger receives the validation data and uses it in the validation process.

The user's validation data is not persisted.

" - }, - "TemporaryPassword":{ - "shape":"PasswordType", - "documentation":"

The user's temporary password. This password must conform to the password policy that you specified when you created the user pool.

The temporary password is valid only once. To complete the Admin Create User flow, the user must enter the temporary password in the sign-in page along with a new password to be used in all future sign-ins.

This parameter is not required. If you do not specify a value, Amazon Cognito generates one for you.

The temporary password can only be used until the user account expiration limit that you specified when you created the user pool. To reset the account after that time limit, you must call AdminCreateUser again, specifying \"RESEND\" for the MessageAction parameter.

" - }, - "ForceAliasCreation":{ - "shape":"ForceAliasCreation", - "documentation":"

This parameter is only used if the phone_number_verified or email_verified attribute is set to True. Otherwise, it is ignored.

If this parameter is set to True and the phone number or email address specified in the UserAttributes parameter already exists as an alias with a different user, the API call will migrate the alias from the previous user to the newly created user. The previous user will no longer be able to log in using that alias.

If this parameter is set to False, the API throws an AliasExistsException error if the alias already exists. The default value is False.

" - }, - "MessageAction":{ - "shape":"MessageActionType", - "documentation":"

Set to \"RESEND\" to resend the invitation message to a user that already exists and reset the expiration limit on the user's account. Set to \"SUPPRESS\" to suppress sending the message. Only one value can be specified.

" - }, - "DesiredDeliveryMediums":{ - "shape":"DeliveryMediumListType", - "documentation":"

Specify \"EMAIL\" if email will be used to send the welcome message. Specify \"SMS\" if the phone number will be used. The default value is \"SMS\". More than one value can be specified.

" - } - }, - "documentation":"

Represents the request to create a user in the specified user pool.

" - }, - "AdminCreateUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"UserType", - "documentation":"

The newly created user.

" - } - }, - "documentation":"

Represents the response from the server to the request to create the user.

" - }, - "AdminCreateUserUnusedAccountValidityDaysType":{ - "type":"integer", - "max":365, - "min":0 - }, - "AdminDeleteUserAttributesRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "UserAttributeNames" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to delete user attributes.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user from which you would like to delete attributes.

" - }, - "UserAttributeNames":{ - "shape":"AttributeNameListType", - "documentation":"

An array of strings representing the user attribute names you wish to delete.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - } - }, - "documentation":"

Represents the request to delete user attributes as an administrator.

" - }, - "AdminDeleteUserAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response received from the server for a request to delete user attributes.

" - }, - "AdminDeleteUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to delete the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to delete.

" - } - }, - "documentation":"

Represents the request to delete a user as an administrator.

" - }, - "AdminDisableProviderForUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "User" - ], - "members":{ - "UserPoolId":{ - "shape":"StringType", - "documentation":"

The user pool ID for the user pool.

" - }, - "User":{ - "shape":"ProviderUserIdentifierType", - "documentation":"

The user to be disabled.

" - } - } - }, - "AdminDisableProviderForUserResponse":{ - "type":"structure", - "members":{ - } - }, - "AdminDisableUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to disable the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to disable.

" - } - }, - "documentation":"

Represents the request to disable any user as an administrator.

" - }, - "AdminDisableUserResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response received from the server to disable the user as an administrator.

" - }, - "AdminEnableUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to enable the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to enable.

" - } - }, - "documentation":"

Represents the request that enables the user as an administrator.

" - }, - "AdminEnableUserResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server for the request to enable a user as an administrator.

" - }, - "AdminForgetDeviceRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "DeviceKey" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name.

" - }, - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - } - }, - "documentation":"

Sends the forgot device request, as an administrator.

" - }, - "AdminGetDeviceRequest":{ - "type":"structure", - "required":[ - "DeviceKey", - "UserPoolId", - "Username" - ], - "members":{ - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name.

" - } - }, - "documentation":"

Represents the request to get the device, as an administrator.

" - }, - "AdminGetDeviceResponse":{ - "type":"structure", - "required":["Device"], - "members":{ - "Device":{ - "shape":"DeviceType", - "documentation":"

The device.

" - } - }, - "documentation":"

Gets the device response, as an administrator.

" - }, - "AdminGetUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to get information about the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to retrieve.

" - } - }, - "documentation":"

Represents the request to get the specified user as an administrator.

" - }, - "AdminGetUserResponse":{ - "type":"structure", - "required":["Username"], - "members":{ - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user about whom you are receiving information.

" - }, - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs representing user attributes.

" - }, - "UserCreateDate":{ - "shape":"DateType", - "documentation":"

The date the user was created.

" - }, - "UserLastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the user was last modified.

" - }, - "Enabled":{ - "shape":"BooleanType", - "documentation":"

Indicates that the status is enabled.

" - }, - "UserStatus":{ - "shape":"UserStatusType", - "documentation":"

The user status. Can be one of the following:

  • UNCONFIRMED - User has been created but not confirmed.

  • CONFIRMED - User has been confirmed.

  • ARCHIVED - User is no longer active.

  • COMPROMISED - User is disabled due to a potential security threat.

  • UNKNOWN - User status is not known.

" - }, - "MFAOptions":{ - "shape":"MFAOptionListType", - "documentation":"

Specifies the options for MFA (e.g., email or phone number).

" - }, - "PreferredMfaSetting":{ - "shape":"StringType", - "documentation":"

The user's preferred MFA setting.

" - }, - "UserMFASettingList":{ - "shape":"UserMFASettingListType", - "documentation":"

The list of the user's MFA settings.

" - } - }, - "documentation":"

Represents the response from the server from the request to get the specified user as an administrator.

" - }, - "AdminInitiateAuthRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientId", - "AuthFlow" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The ID of the Amazon Cognito user pool.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - }, - "AuthFlow":{ - "shape":"AuthFlowType", - "documentation":"

The authentication flow for this call to execute. The API action will depend on this value. For example:

  • REFRESH_TOKEN_AUTH will take in a valid refresh token and return new tokens.

  • USER_SRP_AUTH will take in USERNAME and SRP_A and return the SRP variables to be used for next challenge execution.

  • USER_PASSWORD_AUTH will take in USERNAME and PASSWORD and return the next challenge or tokens.

Valid values include:

  • USER_SRP_AUTH: Authentication flow for the Secure Remote Password (SRP) protocol.

  • REFRESH_TOKEN_AUTH/REFRESH_TOKEN: Authentication flow for refreshing the access token and ID token by supplying a valid refresh token.

  • CUSTOM_AUTH: Custom authentication flow.

  • ADMIN_NO_SRP_AUTH: Non-SRP authentication flow; you can pass in the USERNAME and PASSWORD directly if the flow is enabled for calling the app client.

  • USER_PASSWORD_AUTH: Non-SRP authentication flow; USERNAME and PASSWORD are passed directly. If a user migration Lambda trigger is set, this flow will invoke the user migration Lambda if the USERNAME is not found in the user pool.

" - }, - "AuthParameters":{ - "shape":"AuthParametersType", - "documentation":"

The authentication parameters. These are inputs corresponding to the AuthFlow that you are invoking. The required values depend on the value of AuthFlow:

  • For USER_SRP_AUTH: USERNAME (required), SRP_A (required), SECRET_HASH (required if the app client is configured with a client secret), DEVICE_KEY

  • For REFRESH_TOKEN_AUTH/REFRESH_TOKEN: REFRESH_TOKEN (required), SECRET_HASH (required if the app client is configured with a client secret), DEVICE_KEY

  • For ADMIN_NO_SRP_AUTH: USERNAME (required), SECRET_HASH (if app client is configured with client secret), PASSWORD (required), DEVICE_KEY

  • For CUSTOM_AUTH: USERNAME (required), SECRET_HASH (if app client is configured with client secret), DEVICE_KEY

" - }, - "ClientMetadata":{ - "shape":"ClientMetadataType", - "documentation":"

This is a random key-value pair map which can contain any key and will be passed to your PreAuthentication Lambda trigger as-is. It can be used to implement additional validations around authentication.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The analytics metadata for collecting Amazon Pinpoint metrics for AdminInitiateAuth calls.

" - }, - "ContextData":{ - "shape":"ContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

Initiates the authorization request, as an administrator.

" - }, - "AdminInitiateAuthResponse":{ - "type":"structure", - "members":{ - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The name of the challenge which you are responding to with this call. This is returned to you in the AdminInitiateAuth response if you need to pass another challenge.

  • MFA_SETUP: If MFA is required, users who do not have at least one of the MFA methods set up are presented with an MFA_SETUP challenge. The user must set up at least one MFA type to continue to authenticate.

  • SELECT_MFA_TYPE: Selects the MFA type. Valid MFA options are SMS_MFA for text SMS MFA, and SOFTWARE_TOKEN_MFA for TOTP software token MFA.

  • SMS_MFA: Next challenge is to supply an SMS_MFA_CODE, delivered via SMS.

  • PASSWORD_VERIFIER: Next challenge is to supply PASSWORD_CLAIM_SIGNATURE, PASSWORD_CLAIM_SECRET_BLOCK, and TIMESTAMP after the client-side SRP calculations.

  • CUSTOM_CHALLENGE: This is returned if your custom authentication flow determines that the user should pass another challenge before tokens are issued.

  • DEVICE_SRP_AUTH: If device tracking was enabled on your user pool and the previous challenges were passed, this challenge is returned so that Amazon Cognito can start tracking this device.

  • DEVICE_PASSWORD_VERIFIER: Similar to PASSWORD_VERIFIER, but for devices only.

  • ADMIN_NO_SRP_AUTH: This is returned if you need to authenticate with USERNAME and PASSWORD directly. An app client must be enabled to use this flow.

  • NEW_PASSWORD_REQUIRED: For users which are required to change their passwords after successful first login. This challenge should be passed with NEW_PASSWORD and any other required attributes.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If AdminInitiateAuth or AdminRespondToAuthChallenge API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next AdminRespondToAuthChallenge API call.

" - }, - "ChallengeParameters":{ - "shape":"ChallengeParametersType", - "documentation":"

The challenge parameters. These are returned to you in the AdminInitiateAuth response if you need to pass another challenge. The responses in this parameter should be used to compute inputs to the next call (AdminRespondToAuthChallenge).

All challenges require USERNAME and SECRET_HASH (if applicable).

The value of the USER_ID_FOR_SRP attribute will be the user's actual username, not an alias (such as email address or phone number), even if you specified an alias in your call to AdminInitiateAuth. This is because, in the AdminRespondToAuthChallenge API ChallengeResponses, the USERNAME attribute cannot be an alias.

" - }, - "AuthenticationResult":{ - "shape":"AuthenticationResultType", - "documentation":"

The result of the authentication response. This is only returned if the caller does not need to pass another challenge. If the caller does need to pass another challenge before it gets tokens, ChallengeName, ChallengeParameters, and Session are returned.

" - } - }, - "documentation":"

Initiates the authentication response, as an administrator.

" - }, - "AdminLinkProviderForUserRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "DestinationUser", - "SourceUser" - ], - "members":{ - "UserPoolId":{ - "shape":"StringType", - "documentation":"

The user pool ID for the user pool.

" - }, - "DestinationUser":{ - "shape":"ProviderUserIdentifierType", - "documentation":"

The existing user in the user pool to be linked to the external identity provider user account. Can be a native (Username + Password) Cognito User Pools user or a federated user (for example, a SAML or Facebook user). If the user doesn't exist, an exception is thrown. This is the user that is returned when the new user (with the linked identity provider attribute) signs in.

For a native username + password user, the ProviderAttributeValue for the DestinationUser should be the username in the user pool. For a federated user, it should be the provider-specific user_id.

The ProviderAttributeName of the DestinationUser is ignored.

The ProviderName should be set to Cognito for users in Cognito user pools.

" - }, - "SourceUser":{ - "shape":"ProviderUserIdentifierType", - "documentation":"

An external identity provider account for a user who does not currently exist yet in the user pool. This user must be a federated user (for example, a SAML or Facebook user), not another native user.

If the SourceUser is a federated social identity provider user (Facebook, Google, or Login with Amazon), you must set the ProviderAttributeName to Cognito_Subject. For social identity providers, the ProviderName will be Facebook, Google, or LoginWithAmazon, and Cognito will automatically parse the Facebook, Google, and Login with Amazon tokens for id, sub, and user_id, respectively. The ProviderAttributeValue for the user must be the same value as the id, sub, or user_id value found in the social identity provider token.

For SAML, the ProviderAttributeName can be any value that matches a claim in the SAML assertion. If you wish to link SAML users based on the subject of the SAML assertion, you should map the subject to a claim through the SAML identity provider and submit that claim name as the ProviderAttributeName. If you set ProviderAttributeName to Cognito_Subject, Cognito will automatically parse the default unique identifier found in the subject from the SAML token.

" - } - } - }, - "AdminLinkProviderForUserResponse":{ - "type":"structure", - "members":{ - } - }, - "AdminListDevicesRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

The limit of the devices request.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Represents the request to list devices, as an administrator.

" - }, - "AdminListDevicesResponse":{ - "type":"structure", - "members":{ - "Devices":{ - "shape":"DeviceListType", - "documentation":"

The devices in the list of devices response.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

The pagination token.

" - } - }, - "documentation":"

Lists the device's response, as an administrator.

" - }, - "AdminListGroupsForUserRequest":{ - "type":"structure", - "required":[ - "Username", - "UserPoolId" - ], - "members":{ - "Username":{ - "shape":"UsernameType", - "documentation":"

The username for the user.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

The limit of the request to list groups.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "AdminListGroupsForUserResponse":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupListType", - "documentation":"

The groups that the user belongs to.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "AdminListUserAuthEventsRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user pool username or an alias.

" - }, - "MaxResults":{ - "shape":"QueryLimitType", - "documentation":"

The maximum number of authentication events to return.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - } - } - }, - "AdminListUserAuthEventsResponse":{ - "type":"structure", - "members":{ - "AuthEvents":{ - "shape":"AuthEventsType", - "documentation":"

The response object. It includes the EventID, EventType, CreationDate, EventRisk, and EventResponse.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

A pagination token.

" - } - } - }, - "AdminRemoveUserFromGroupRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "GroupName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The username for the user.

" - }, - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The group name.

" - } - } - }, - "AdminResetUserPasswordRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to reset the user's password.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user whose password you wish to reset.

" - } - }, - "documentation":"

Represents the request to reset a user's password as an administrator.

" - }, - "AdminResetUserPasswordResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server to reset a user password as an administrator.

" - }, - "AdminRespondToAuthChallengeRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientId", - "ChallengeName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The ID of the Amazon Cognito user pool.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - }, - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The challenge name. For more information, see .

" - }, - "ChallengeResponses":{ - "shape":"ChallengeResponsesType", - "documentation":"

The challenge responses. These are inputs corresponding to the value of ChallengeName, for example:

  • SMS_MFA: SMS_MFA_CODE, USERNAME, SECRET_HASH (if app client is configured with client secret).

  • PASSWORD_VERIFIER: PASSWORD_CLAIM_SIGNATURE, PASSWORD_CLAIM_SECRET_BLOCK, TIMESTAMP, USERNAME, SECRET_HASH (if app client is configured with client secret).

  • ADMIN_NO_SRP_AUTH: PASSWORD, USERNAME, SECRET_HASH (if app client is configured with client secret).

  • NEW_PASSWORD_REQUIRED: NEW_PASSWORD, any other required attributes, USERNAME, SECRET_HASH (if app client is configured with client secret).

The value of the USERNAME attribute must be the user's actual username, not an alias (such as email address or phone number). To make this easier, the AdminInitiateAuth response includes the actual username value in the USERNAMEUSER_ID_FOR_SRP attribute, even if you specified an alias in your call to AdminInitiateAuth.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If InitiateAuth or RespondToAuthChallenge API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next RespondToAuthChallenge API call.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The analytics metadata for collecting Amazon Pinpoint metrics for AdminRespondToAuthChallenge calls.

" - }, - "ContextData":{ - "shape":"ContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

The request to respond to the authentication challenge, as an administrator.

" - }, - "AdminRespondToAuthChallengeResponse":{ - "type":"structure", - "members":{ - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The name of the challenge. For more information, see .

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If the or API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next RespondToAuthChallenge API call.

" - }, - "ChallengeParameters":{ - "shape":"ChallengeParametersType", - "documentation":"

The challenge parameters. For more information, see .

" - }, - "AuthenticationResult":{ - "shape":"AuthenticationResultType", - "documentation":"

The result returned by the server in response to the authentication request.

" - } - }, - "documentation":"

Responds to the authentication challenge, as an administrator.

" - }, - "AdminSetUserMFAPreferenceRequest":{ - "type":"structure", - "required":[ - "Username", - "UserPoolId" - ], - "members":{ - "SMSMfaSettings":{ - "shape":"SMSMfaSettingsType", - "documentation":"

The SMS text message MFA settings.

" - }, - "SoftwareTokenMfaSettings":{ - "shape":"SoftwareTokenMfaSettingsType", - "documentation":"

The time-based one-time password software token MFA settings.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user pool username or alias.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - } - } - }, - "AdminSetUserMFAPreferenceResponse":{ - "type":"structure", - "members":{ - } - }, - "AdminSetUserSettingsRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "MFAOptions" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to set the user's settings, such as MFA options.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user for whom you wish to set user settings.

" - }, - "MFAOptions":{ - "shape":"MFAOptionListType", - "documentation":"

Specifies the options for MFA (e.g., email or phone number).

" - } - }, - "documentation":"

Represents the request to set user settings as an administrator.

" - }, - "AdminSetUserSettingsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server to set user settings as an administrator.

" - }, - "AdminUpdateAuthEventFeedbackRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "EventId", - "FeedbackValue" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user pool username.

" - }, - "EventId":{ - "shape":"EventIdType", - "documentation":"

The authentication event ID.

" - }, - "FeedbackValue":{ - "shape":"FeedbackValueType", - "documentation":"

The authentication event feedback value.

" - } - } - }, - "AdminUpdateAuthEventFeedbackResponse":{ - "type":"structure", - "members":{ - } - }, - "AdminUpdateDeviceStatusRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "DeviceKey" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name.

" - }, - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "DeviceRememberedStatus":{ - "shape":"DeviceRememberedStatusType", - "documentation":"

The status indicating whether a device has been remembered or not.

" - } - }, - "documentation":"

The request to update the device status, as an administrator.

" - }, - "AdminUpdateDeviceStatusResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The status response from the request to update the device, as an administrator.

" - }, - "AdminUpdateUserAttributesRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "UserAttributes" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to update user attributes.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user for whom you want to update user attributes.

" - }, - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs representing user attributes.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - } - }, - "documentation":"

Represents the request to update the user's attributes as an administrator.

" - }, - "AdminUpdateUserAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server for the request to update user attributes as an administrator.

" - }, - "AdminUserGlobalSignOutRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name.

" - } - }, - "documentation":"

The request to sign out of all devices, as an administrator.

" - }, - "AdminUserGlobalSignOutResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The global sign-out response, as an administrator.

" - }, - "AdvancedSecurityModeType":{ - "type":"string", - "enum":[ - "OFF", - "AUDIT", - "ENFORCED" - ] - }, - "AliasAttributeType":{ - "type":"string", - "enum":[ - "phone_number", - "email", - "preferred_username" - ] - }, - "AliasAttributesListType":{ - "type":"list", - "member":{"shape":"AliasAttributeType"} - }, - "AliasExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message sent to the user when an alias exists.

" - } - }, - "documentation":"

This exception is thrown when a user tries to confirm the account with an email or phone number that has already been supplied as an alias from a different account. This exception tells user that an account with this email or phone already exists.

", - "exception":true - }, - "AnalyticsConfigurationType":{ - "type":"structure", - "required":[ - "ApplicationId", - "RoleArn", - "ExternalId" - ], - "members":{ - "ApplicationId":{ - "shape":"HexStringType", - "documentation":"

The application ID for an Amazon Pinpoint application.

" - }, - "RoleArn":{ - "shape":"ArnType", - "documentation":"

The ARN of an IAM role that authorizes Amazon Cognito to publish events to Amazon Pinpoint analytics.

" - }, - "ExternalId":{ - "shape":"StringType", - "documentation":"

The external ID.

" - }, - "UserDataShared":{ - "shape":"BooleanType", - "documentation":"

If UserDataShared is true, Amazon Cognito will include user data in the events it publishes to Amazon Pinpoint analytics.

" - } - }, - "documentation":"

The Amazon Pinpoint analytics configuration for collecting metrics for a user pool.

" - }, - "AnalyticsMetadataType":{ - "type":"structure", - "members":{ - "AnalyticsEndpointId":{ - "shape":"StringType", - "documentation":"

The endpoint ID.

" - } - }, - "documentation":"

An Amazon Pinpoint analytics endpoint.

An endpoint uniquely identifies a mobile device, email address, or phone number that can receive messages from Amazon Pinpoint analytics.

" - }, - "ArnType":{ - "type":"string", - "max":2048, - "min":20, - "pattern":"arn:[\\w+=/,.@-]+:[\\w+=/,.@-]+:([\\w+=/,.@-]*)?:[0-9]+:[\\w+=/,.@-]+(:[\\w+=/,.@-]+)?(:[\\w+=/,.@-]+)?" - }, - "AssociateSoftwareTokenRequest":{ - "type":"structure", - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. This allows authentication of the user as part of the MFA setup process.

" - } - } - }, - "AssociateSoftwareTokenResponse":{ - "type":"structure", - "members":{ - "SecretCode":{ - "shape":"SecretCodeType", - "documentation":"

A unique generated shared secret code that is used in the TOTP algorithm to generate a one time code.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. This allows authentication of the user as part of the MFA setup process.

" - } - } - }, - "AttributeDataType":{ - "type":"string", - "enum":[ - "String", - "Number", - "DateTime", - "Boolean" - ] - }, - "AttributeListType":{ - "type":"list", - "member":{"shape":"AttributeType"} - }, - "AttributeMappingKeyType":{ - "type":"string", - "max":32, - "min":1 - }, - "AttributeMappingType":{ - "type":"map", - "key":{"shape":"AttributeMappingKeyType"}, - "value":{"shape":"StringType"} - }, - "AttributeNameListType":{ - "type":"list", - "member":{"shape":"AttributeNameType"} - }, - "AttributeNameType":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "AttributeType":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"AttributeNameType", - "documentation":"

The name of the attribute.

" - }, - "Value":{ - "shape":"AttributeValueType", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Specifies whether the attribute is standard or custom.

" - }, - "AttributeValueType":{ - "type":"string", - "max":2048, - "sensitive":true - }, - "AuthEventType":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"StringType", - "documentation":"

The event ID.

" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The creation date

" - }, - "EventResponse":{ - "shape":"EventResponseType", - "documentation":"

The event response.

" - }, - "EventRisk":{ - "shape":"EventRiskType", - "documentation":"

The event risk.

" - }, - "ChallengeResponses":{ - "shape":"ChallengeResponseListType", - "documentation":"

The challenge responses.

" - }, - "EventContextData":{ - "shape":"EventContextDataType", - "documentation":"

The user context data captured at the time of an event request. It provides additional information about the client from which event the request is received.

" - }, - "EventFeedback":{ - "shape":"EventFeedbackType", - "documentation":"

A flag specifying the user feedback captured at the time of an event request is good or bad.

" - } - }, - "documentation":"

The authentication event type.

" - }, - "AuthEventsType":{ - "type":"list", - "member":{"shape":"AuthEventType"} - }, - "AuthFlowType":{ - "type":"string", - "enum":[ - "USER_SRP_AUTH", - "REFRESH_TOKEN_AUTH", - "REFRESH_TOKEN", - "CUSTOM_AUTH", - "ADMIN_NO_SRP_AUTH", - "USER_PASSWORD_AUTH" - ] - }, - "AuthParametersType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "AuthenticationResultType":{ - "type":"structure", - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - }, - "ExpiresIn":{ - "shape":"IntegerType", - "documentation":"

The expiration period of the authentication result in seconds.

" - }, - "TokenType":{ - "shape":"StringType", - "documentation":"

The token type.

" - }, - "RefreshToken":{ - "shape":"TokenModelType", - "documentation":"

The refresh token.

" - }, - "IdToken":{ - "shape":"TokenModelType", - "documentation":"

The ID token.

" - }, - "NewDeviceMetadata":{ - "shape":"NewDeviceMetadataType", - "documentation":"

The new device metadata from an authentication result.

" - } - }, - "documentation":"

The authentication result.

" - }, - "BlockedIPRangeListType":{ - "type":"list", - "member":{"shape":"StringType"}, - "max":20 - }, - "BooleanType":{"type":"boolean"}, - "CSSType":{"type":"string"}, - "CSSVersionType":{"type":"string"}, - "CallbackURLsListType":{ - "type":"list", - "member":{"shape":"RedirectUrlType"}, - "max":100, - "min":0 - }, - "ChallengeName":{ - "type":"string", - "enum":[ - "Password", - "Mfa" - ] - }, - "ChallengeNameType":{ - "type":"string", - "enum":[ - "SMS_MFA", - "SOFTWARE_TOKEN_MFA", - "SELECT_MFA_TYPE", - "MFA_SETUP", - "PASSWORD_VERIFIER", - "CUSTOM_CHALLENGE", - "DEVICE_SRP_AUTH", - "DEVICE_PASSWORD_VERIFIER", - "ADMIN_NO_SRP_AUTH", - "NEW_PASSWORD_REQUIRED" - ] - }, - "ChallengeParametersType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "ChallengeResponse":{ - "type":"string", - "enum":[ - "Success", - "Failure" - ] - }, - "ChallengeResponseListType":{ - "type":"list", - "member":{"shape":"ChallengeResponseType"} - }, - "ChallengeResponseType":{ - "type":"structure", - "members":{ - "ChallengeName":{ - "shape":"ChallengeName", - "documentation":"

The challenge name

" - }, - "ChallengeResponse":{ - "shape":"ChallengeResponse", - "documentation":"

The challenge response.

" - } - }, - "documentation":"

The challenge response type.

" - }, - "ChallengeResponsesType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "ChangePasswordRequest":{ - "type":"structure", - "required":[ - "PreviousPassword", - "ProposedPassword", - "AccessToken" - ], - "members":{ - "PreviousPassword":{ - "shape":"PasswordType", - "documentation":"

The old password.

" - }, - "ProposedPassword":{ - "shape":"PasswordType", - "documentation":"

The new password.

" - }, - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - } - }, - "documentation":"

Represents the request to change a user password.

" - }, - "ChangePasswordResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response from the server to the change password request.

" - }, - "ClientIdType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+]+", - "sensitive":true - }, - "ClientMetadataType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "ClientNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w\\s+=,.@-]+" - }, - "ClientPermissionListType":{ - "type":"list", - "member":{"shape":"ClientPermissionType"} - }, - "ClientPermissionType":{ - "type":"string", - "max":2048, - "min":1 - }, - "ClientSecretType":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\w+]+", - "sensitive":true - }, - "CodeDeliveryDetailsListType":{ - "type":"list", - "member":{"shape":"CodeDeliveryDetailsType"} - }, - "CodeDeliveryDetailsType":{ - "type":"structure", - "members":{ - "Destination":{ - "shape":"StringType", - "documentation":"

The destination for the code delivery details.

" - }, - "DeliveryMedium":{ - "shape":"DeliveryMediumType", - "documentation":"

The delivery medium (email message or phone number).

" - }, - "AttributeName":{ - "shape":"AttributeNameType", - "documentation":"

The attribute name.

" - } - }, - "documentation":"

The code delivery details being returned from the server.

" - }, - "CodeDeliveryFailureException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message sent when a verification code fails to deliver successfully.

" - } - }, - "documentation":"

This exception is thrown when a verification code fails to deliver successfully.

", - "exception":true - }, - "CodeMismatchException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message provided when the code mismatch exception is thrown.

" - } - }, - "documentation":"

This exception is thrown if the provided code does not match what the server was expecting.

", - "exception":true - }, - "CompletionMessageType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w]+" - }, - "CompromisedCredentialsActionsType":{ - "type":"structure", - "required":["EventAction"], - "members":{ - "EventAction":{ - "shape":"CompromisedCredentialsEventActionType", - "documentation":"

The event action.

" - } - }, - "documentation":"

The compromised credentials actions type

" - }, - "CompromisedCredentialsEventActionType":{ - "type":"string", - "enum":[ - "BLOCK", - "NO_ACTION" - ] - }, - "CompromisedCredentialsRiskConfigurationType":{ - "type":"structure", - "required":["Actions"], - "members":{ - "EventFilter":{ - "shape":"EventFiltersType", - "documentation":"

Perform the action for these events. The default is to perform all events if no event filter is specified.

" - }, - "Actions":{ - "shape":"CompromisedCredentialsActionsType", - "documentation":"

The compromised credentials risk configuration actions.

" - } - }, - "documentation":"

The compromised credentials risk configuration type.

" - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message provided when the concurrent exception is thrown.

" - } - }, - "documentation":"

This exception is thrown if two or more modifications are happening concurrently.

", - "exception":true - }, - "ConfirmDeviceRequest":{ - "type":"structure", - "required":[ - "AccessToken", - "DeviceKey" - ], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - }, - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "DeviceSecretVerifierConfig":{ - "shape":"DeviceSecretVerifierConfigType", - "documentation":"

The configuration of the device secret verifier.

" - }, - "DeviceName":{ - "shape":"DeviceNameType", - "documentation":"

The device name.

" - } - }, - "documentation":"

Confirms the device request.

" - }, - "ConfirmDeviceResponse":{ - "type":"structure", - "members":{ - "UserConfirmationNecessary":{ - "shape":"BooleanType", - "documentation":"

Indicates whether the user confirmation is necessary to confirm the device response.

" - } - }, - "documentation":"

Confirms the device response.

" - }, - "ConfirmForgotPasswordRequest":{ - "type":"structure", - "required":[ - "ClientId", - "Username", - "ConfirmationCode", - "Password" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID of the app associated with the user pool.

" - }, - "SecretHash":{ - "shape":"SecretHashType", - "documentation":"

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user for whom you want to enter a code to retrieve a forgotten password.

" - }, - "ConfirmationCode":{ - "shape":"ConfirmationCodeType", - "documentation":"

The confirmation code sent by a user's request to retrieve a forgotten password. For more information, see

" - }, - "Password":{ - "shape":"PasswordType", - "documentation":"

The password sent by a user's request to retrieve a forgotten password.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for ConfirmForgotPassword calls.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

The request representing the confirmation for a password reset.

" - }, - "ConfirmForgotPasswordResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response from the server that results from a user's request to retrieve a forgotten password.

" - }, - "ConfirmSignUpRequest":{ - "type":"structure", - "required":[ - "ClientId", - "Username", - "ConfirmationCode" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the app client associated with the user pool.

" - }, - "SecretHash":{ - "shape":"SecretHashType", - "documentation":"

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user whose registration you wish to confirm.

" - }, - "ConfirmationCode":{ - "shape":"ConfirmationCodeType", - "documentation":"

The confirmation code sent by a user's request to confirm registration.

" - }, - "ForceAliasCreation":{ - "shape":"ForceAliasCreation", - "documentation":"

Boolean to be specified to force user confirmation irrespective of existing alias. By default set to False. If this parameter is set to True and the phone number/email used for sign up confirmation already exists as an alias with a different user, the API call will migrate the alias from the previous user to the newly created user being confirmed. If set to False, the API will throw an AliasExistsException error.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for ConfirmSignUp calls.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

Represents the request to confirm registration of a user.

" - }, - "ConfirmSignUpResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server for the registration confirmation.

" - }, - "ConfirmationCodeType":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"[\\S]+" - }, - "ContextDataType":{ - "type":"structure", - "required":[ - "IpAddress", - "ServerName", - "ServerPath", - "HttpHeaders" - ], - "members":{ - "IpAddress":{ - "shape":"StringType", - "documentation":"

Source IP address of your user.

" - }, - "ServerName":{ - "shape":"StringType", - "documentation":"

Your server endpoint where this API is invoked.

" - }, - "ServerPath":{ - "shape":"StringType", - "documentation":"

Your server path where this API is invoked.

" - }, - "HttpHeaders":{ - "shape":"HttpHeaderList", - "documentation":"

HttpHeaders received on your server in same order.

" - }, - "EncodedData":{ - "shape":"StringType", - "documentation":"

Encoded data containing device fingerprinting details, collected using the Amazon Cognito context data collection library.

" - } - }, - "documentation":"

Contextual user data type used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - }, - "CreateGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserPoolId" - ], - "members":{ - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group. Must be unique.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

A string containing the description of the group.

" - }, - "RoleArn":{ - "shape":"ArnType", - "documentation":"

The role ARN for the group.

" - }, - "Precedence":{ - "shape":"PrecedenceType", - "documentation":"

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

" - } - } - }, - "CreateGroupResponse":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"GroupType", - "documentation":"

The group object for the group.

" - } - } - }, - "CreateIdentityProviderRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ProviderName", - "ProviderType", - "ProviderDetails" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ProviderName":{ - "shape":"ProviderNameTypeV1", - "documentation":"

The identity provider name.

" - }, - "ProviderType":{ - "shape":"IdentityProviderTypeType", - "documentation":"

The identity provider type.

" - }, - "ProviderDetails":{ - "shape":"ProviderDetailsType", - "documentation":"

The identity provider details, such as MetadataURL and MetadataFile.

" - }, - "AttributeMapping":{ - "shape":"AttributeMappingType", - "documentation":"

A mapping of identity provider attributes to standard and custom user pool attributes.

" - }, - "IdpIdentifiers":{ - "shape":"IdpIdentifiersListType", - "documentation":"

A list of identity provider identifiers.

" - } - } - }, - "CreateIdentityProviderResponse":{ - "type":"structure", - "required":["IdentityProvider"], - "members":{ - "IdentityProvider":{ - "shape":"IdentityProviderType", - "documentation":"

The newly created identity provider object.

" - } - } - }, - "CreateResourceServerRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Identifier", - "Name" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Identifier":{ - "shape":"ResourceServerIdentifierType", - "documentation":"

A unique resource server identifier for the resource server. This could be an HTTPS endpoint where the resource server is located. For example, https://my-weather-api.example.com.

" - }, - "Name":{ - "shape":"ResourceServerNameType", - "documentation":"

A friendly name for the resource server.

" - }, - "Scopes":{ - "shape":"ResourceServerScopeListType", - "documentation":"

A list of scopes. Each scope is map, where the keys are name and description.

" - } - } - }, - "CreateResourceServerResponse":{ - "type":"structure", - "required":["ResourceServer"], - "members":{ - "ResourceServer":{ - "shape":"ResourceServerType", - "documentation":"

The newly created resource server.

" - } - } - }, - "CreateUserImportJobRequest":{ - "type":"structure", - "required":[ - "JobName", - "UserPoolId", - "CloudWatchLogsRoleArn" - ], - "members":{ - "JobName":{ - "shape":"UserImportJobNameType", - "documentation":"

The job name for the user import job.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"ArnType", - "documentation":"

The role ARN for the Amazon CloudWatch Logging role for the user import job.

" - } - }, - "documentation":"

Represents the request to create the user import job.

" - }, - "CreateUserImportJobResponse":{ - "type":"structure", - "members":{ - "UserImportJob":{ - "shape":"UserImportJobType", - "documentation":"

The job object that represents the user import job.

" - } - }, - "documentation":"

Represents the response from the server to the request to create the user import job.

" - }, - "CreateUserPoolClientRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to create a user pool client.

" - }, - "ClientName":{ - "shape":"ClientNameType", - "documentation":"

The client name for the user pool client you would like to create.

" - }, - "GenerateSecret":{ - "shape":"GenerateSecret", - "documentation":"

Boolean to specify whether you want to generate a secret for the user pool client being created.

" - }, - "RefreshTokenValidity":{ - "shape":"RefreshTokenValidityType", - "documentation":"

The time limit, in days, after which the refresh token is no longer valid and cannot be used.

" - }, - "ReadAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The read attributes.

" - }, - "WriteAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The write attributes.

" - }, - "ExplicitAuthFlows":{ - "shape":"ExplicitAuthFlowsListType", - "documentation":"

The explicit authentication flows.

" - }, - "SupportedIdentityProviders":{ - "shape":"SupportedIdentityProvidersListType", - "documentation":"

A list of provider names for the identity providers that are supported on this client.

" - }, - "CallbackURLs":{ - "shape":"CallbackURLsListType", - "documentation":"

A list of allowed redirect (callback) URLs for the identity providers.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "LogoutURLs":{ - "shape":"LogoutURLsListType", - "documentation":"

A list of allowed logout URLs for the identity providers.

" - }, - "DefaultRedirectURI":{ - "shape":"RedirectUrlType", - "documentation":"

The default redirect URI. Must be in the CallbackURLs list.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "AllowedOAuthFlows":{ - "shape":"OAuthFlowsType", - "documentation":"

Set to code to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.

Set to token to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.

" - }, - "AllowedOAuthScopes":{ - "shape":"ScopeListType", - "documentation":"

A list of allowed OAuth scopes. Currently supported values are \"phone\", \"email\", \"openid\", and \"Cognito\".

" - }, - "AllowedOAuthFlowsUserPoolClient":{ - "shape":"BooleanType", - "documentation":"

Set to True if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.

" - }, - "AnalyticsConfiguration":{ - "shape":"AnalyticsConfigurationType", - "documentation":"

The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.

" - } - }, - "documentation":"

Represents the request to create a user pool client.

" - }, - "CreateUserPoolClientResponse":{ - "type":"structure", - "members":{ - "UserPoolClient":{ - "shape":"UserPoolClientType", - "documentation":"

The user pool client that was just created.

" - } - }, - "documentation":"

Represents the response from the server to create a user pool client.

" - }, - "CreateUserPoolDomainRequest":{ - "type":"structure", - "required":[ - "Domain", - "UserPoolId" - ], - "members":{ - "Domain":{ - "shape":"DomainType", - "documentation":"

The domain string.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - } - } - }, - "CreateUserPoolDomainResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateUserPoolRequest":{ - "type":"structure", - "required":["PoolName"], - "members":{ - "PoolName":{ - "shape":"UserPoolNameType", - "documentation":"

A string used to name the user pool.

" - }, - "Policies":{ - "shape":"UserPoolPolicyType", - "documentation":"

The policies associated with the new user pool.

" - }, - "LambdaConfig":{ - "shape":"LambdaConfigType", - "documentation":"

The Lambda trigger configuration information for the new user pool.

In a push model, event sources (such as Amazon S3 and custom applications) need permission to invoke a function. So you will need to make an extra call to add permission for these event sources to invoke your Lambda function.

For more information on using the Lambda API to add permission, see AddPermission .

For adding permission using the AWS CLI, see add-permission .

" - }, - "AutoVerifiedAttributes":{ - "shape":"VerifiedAttributesListType", - "documentation":"

The attributes to be auto-verified. Possible values: email, phone_number.

" - }, - "AliasAttributes":{ - "shape":"AliasAttributesListType", - "documentation":"

Attributes supported as an alias for this user pool. Possible values: phone_number, email, or preferred_username.

" - }, - "UsernameAttributes":{ - "shape":"UsernameAttributesListType", - "documentation":"

Specifies whether email addresses or phone numbers can be specified as usernames when a user signs up.

" - }, - "SmsVerificationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

A string representing the SMS verification message.

" - }, - "EmailVerificationMessage":{ - "shape":"EmailVerificationMessageType", - "documentation":"

A string representing the email verification message.

" - }, - "EmailVerificationSubject":{ - "shape":"EmailVerificationSubjectType", - "documentation":"

A string representing the email verification subject.

" - }, - "VerificationMessageTemplate":{ - "shape":"VerificationMessageTemplateType", - "documentation":"

The template for the verification message that the user sees when the app requests permission to access the user's information.

" - }, - "SmsAuthenticationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

A string representing the SMS authentication message.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

Specifies MFA configuration details.

" - }, - "DeviceConfiguration":{ - "shape":"DeviceConfigurationType", - "documentation":"

The device configuration.

" - }, - "EmailConfiguration":{ - "shape":"EmailConfigurationType", - "documentation":"

The email configuration.

" - }, - "SmsConfiguration":{ - "shape":"SmsConfigurationType", - "documentation":"

The SMS configuration.

" - }, - "UserPoolTags":{ - "shape":"UserPoolTagsType", - "documentation":"

The cost allocation tags for the user pool. For more information, see Adding Cost Allocation Tags to Your User Pool

" - }, - "AdminCreateUserConfig":{ - "shape":"AdminCreateUserConfigType", - "documentation":"

The configuration for AdminCreateUser requests.

" - }, - "Schema":{ - "shape":"SchemaAttributesListType", - "documentation":"

An array of schema attributes for the new user pool. These attributes can be standard or custom attributes.

" - }, - "UserPoolAddOns":{ - "shape":"UserPoolAddOnsType", - "documentation":"

Used to enable advanced security risk detection. Set the key AdvancedSecurityMode to the value \"AUDIT\".

" - } - }, - "documentation":"

Represents the request to create a user pool.

" - }, - "CreateUserPoolResponse":{ - "type":"structure", - "members":{ - "UserPool":{ - "shape":"UserPoolType", - "documentation":"

A container for the user pool details.

" - } - }, - "documentation":"

Represents the response from the server for the request to create a user pool.

" - }, - "CustomAttributeNameType":{ - "type":"string", - "max":20, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "CustomAttributesListType":{ - "type":"list", - "member":{"shape":"SchemaAttributeType"}, - "max":25, - "min":1 - }, - "DateType":{"type":"timestamp"}, - "DefaultEmailOptionType":{ - "type":"string", - "enum":[ - "CONFIRM_WITH_LINK", - "CONFIRM_WITH_CODE" - ] - }, - "DeleteGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserPoolId" - ], - "members":{ - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - } - } - }, - "DeleteIdentityProviderRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ProviderName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The identity provider name.

" - } - } - }, - "DeleteResourceServerRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Identifier" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that hosts the resource server.

" - }, - "Identifier":{ - "shape":"ResourceServerIdentifierType", - "documentation":"

The identifier for the resource server.

" - } - } - }, - "DeleteUserAttributesRequest":{ - "type":"structure", - "required":[ - "UserAttributeNames", - "AccessToken" - ], - "members":{ - "UserAttributeNames":{ - "shape":"AttributeNameListType", - "documentation":"

An array of strings representing the user attribute names you wish to delete.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - }, - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token used in the request to delete user attributes.

" - } - }, - "documentation":"

Represents the request to delete user attributes.

" - }, - "DeleteUserAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server to delete user attributes.

" - }, - "DeleteUserPoolClientRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to delete the client.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID of the app associated with the user pool.

" - } - }, - "documentation":"

Represents the request to delete a user pool client.

" - }, - "DeleteUserPoolDomainRequest":{ - "type":"structure", - "required":[ - "Domain", - "UserPoolId" - ], - "members":{ - "Domain":{ - "shape":"DomainType", - "documentation":"

The domain string.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - } - } - }, - "DeleteUserPoolDomainResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteUserPoolRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool you want to delete.

" - } - }, - "documentation":"

Represents the request to delete a user pool.

" - }, - "DeleteUserRequest":{ - "type":"structure", - "required":["AccessToken"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token from a request to delete a user.

" - } - }, - "documentation":"

Represents the request to delete a user.

" - }, - "DeliveryMediumListType":{ - "type":"list", - "member":{"shape":"DeliveryMediumType"} - }, - "DeliveryMediumType":{ - "type":"string", - "enum":[ - "SMS", - "EMAIL" - ] - }, - "DescribeIdentityProviderRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ProviderName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The identity provider name.

" - } - } - }, - "DescribeIdentityProviderResponse":{ - "type":"structure", - "required":["IdentityProvider"], - "members":{ - "IdentityProvider":{ - "shape":"IdentityProviderType", - "documentation":"

The identity provider that was deleted.

" - } - } - }, - "DescribeResourceServerRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Identifier" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that hosts the resource server.

" - }, - "Identifier":{ - "shape":"ResourceServerIdentifierType", - "documentation":"

The identifier for the resource server

" - } - } - }, - "DescribeResourceServerResponse":{ - "type":"structure", - "required":["ResourceServer"], - "members":{ - "ResourceServer":{ - "shape":"ResourceServerType", - "documentation":"

The resource server.

" - } - } - }, - "DescribeRiskConfigurationRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - } - } - }, - "DescribeRiskConfigurationResponse":{ - "type":"structure", - "required":["RiskConfiguration"], - "members":{ - "RiskConfiguration":{ - "shape":"RiskConfigurationType", - "documentation":"

The risk configuration.

" - } - } - }, - "DescribeUserImportJobRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "JobId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "JobId":{ - "shape":"UserImportJobIdType", - "documentation":"

The job ID for the user import job.

" - } - }, - "documentation":"

Represents the request to describe the user import job.

" - }, - "DescribeUserImportJobResponse":{ - "type":"structure", - "members":{ - "UserImportJob":{ - "shape":"UserImportJobType", - "documentation":"

The job object that represents the user import job.

" - } - }, - "documentation":"

Represents the response from the server to the request to describe the user import job.

" - }, - "DescribeUserPoolClientRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool you want to describe.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID of the app associated with the user pool.

" - } - }, - "documentation":"

Represents the request to describe a user pool client.

" - }, - "DescribeUserPoolClientResponse":{ - "type":"structure", - "members":{ - "UserPoolClient":{ - "shape":"UserPoolClientType", - "documentation":"

The user pool client from a server response to describe the user pool client.

" - } - }, - "documentation":"

Represents the response from the server from a request to describe the user pool client.

" - }, - "DescribeUserPoolDomainRequest":{ - "type":"structure", - "required":["Domain"], - "members":{ - "Domain":{ - "shape":"DomainType", - "documentation":"

The domain string.

" - } - } - }, - "DescribeUserPoolDomainResponse":{ - "type":"structure", - "members":{ - "DomainDescription":{ - "shape":"DomainDescriptionType", - "documentation":"

A domain description object containing information about the domain.

" - } - } - }, - "DescribeUserPoolRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool you want to describe.

" - } - }, - "documentation":"

Represents the request to describe the user pool.

" - }, - "DescribeUserPoolResponse":{ - "type":"structure", - "members":{ - "UserPool":{ - "shape":"UserPoolType", - "documentation":"

The container of metadata returned by the server to describe the pool.

" - } - }, - "documentation":"

Represents the response to describe the user pool.

" - }, - "DescriptionType":{ - "type":"string", - "max":2048 - }, - "DeviceConfigurationType":{ - "type":"structure", - "members":{ - "ChallengeRequiredOnNewDevice":{ - "shape":"BooleanType", - "documentation":"

Indicates whether a challenge is required on a new device. Only applicable to a new device.

" - }, - "DeviceOnlyRememberedOnUserPrompt":{ - "shape":"BooleanType", - "documentation":"

If true, a device is only remembered on user prompt.

" - } - }, - "documentation":"

The configuration for the user pool's device tracking.

" - }, - "DeviceKeyType":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+_[0-9a-f-]+" - }, - "DeviceListType":{ - "type":"list", - "member":{"shape":"DeviceType"} - }, - "DeviceNameType":{ - "type":"string", - "max":1024, - "min":1 - }, - "DeviceRememberedStatusType":{ - "type":"string", - "enum":[ - "remembered", - "not_remembered" - ] - }, - "DeviceSecretVerifierConfigType":{ - "type":"structure", - "members":{ - "PasswordVerifier":{ - "shape":"StringType", - "documentation":"

The password verifier.

" - }, - "Salt":{ - "shape":"StringType", - "documentation":"

The salt.

" - } - }, - "documentation":"

The device verifier against which it will be authenticated.

" - }, - "DeviceType":{ - "type":"structure", - "members":{ - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "DeviceAttributes":{ - "shape":"AttributeListType", - "documentation":"

The device attributes.

" - }, - "DeviceCreateDate":{ - "shape":"DateType", - "documentation":"

The creation date of the device.

" - }, - "DeviceLastModifiedDate":{ - "shape":"DateType", - "documentation":"

The last modified date of the device.

" - }, - "DeviceLastAuthenticatedDate":{ - "shape":"DateType", - "documentation":"

The date in which the device was last authenticated.

" - } - }, - "documentation":"

The device type.

" - }, - "DomainDescriptionType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "AWSAccountId":{ - "shape":"AWSAccountIdType", - "documentation":"

The AWS account ID for the user pool owner.

" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

The domain string.

" - }, - "S3Bucket":{ - "shape":"S3BucketType", - "documentation":"

The S3 bucket where the static files for this domain are stored.

" - }, - "CloudFrontDistribution":{ - "shape":"ArnType", - "documentation":"

The ARN of the CloudFront distribution.

" - }, - "Version":{ - "shape":"DomainVersionType", - "documentation":"

The app version.

" - }, - "Status":{ - "shape":"DomainStatusType", - "documentation":"

The domain status.

" - } - }, - "documentation":"

A container for information about a domain.

" - }, - "DomainStatusType":{ - "type":"string", - "enum":[ - "CREATING", - "DELETING", - "UPDATING", - "ACTIVE", - "FAILED" - ] - }, - "DomainType":{ - "type":"string", - "max":63, - "min":1, - "pattern":"^[a-z0-9](?:[a-z0-9\\-]{0,61}[a-z0-9])?$" - }, - "DomainVersionType":{ - "type":"string", - "max":20, - "min":1 - }, - "DuplicateProviderException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when the provider is already supported by the user pool.

", - "exception":true - }, - "EmailAddressType":{ - "type":"string", - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+@[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "EmailConfigurationType":{ - "type":"structure", - "members":{ - "SourceArn":{ - "shape":"ArnType", - "documentation":"

The Amazon Resource Name (ARN) of the email source.

" - }, - "ReplyToEmailAddress":{ - "shape":"EmailAddressType", - "documentation":"

The destination to which the receiver of the email should reply to.

" - } - }, - "documentation":"

The email configuration type.

" - }, - "EmailNotificationBodyType":{ - "type":"string", - "max":20000, - "min":6, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]+" - }, - "EmailNotificationSubjectType":{ - "type":"string", - "max":140, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s]+" - }, - "EmailVerificationMessageByLinkType":{ - "type":"string", - "max":20000, - "min":6, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]*\\{##[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]*##\\}[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]*" - }, - "EmailVerificationMessageType":{ - "type":"string", - "max":20000, - "min":6, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]*\\{####\\}[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s*]*" - }, - "EmailVerificationSubjectByLinkType":{ - "type":"string", - "max":140, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s]+" - }, - "EmailVerificationSubjectType":{ - "type":"string", - "max":140, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}\\s]+" - }, - "EnableSoftwareTokenMFAException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when there is a code mismatch and the service fails to configure the software token TOTP multi-factor authentication (MFA).

", - "exception":true - }, - "EventContextDataType":{ - "type":"structure", - "members":{ - "IpAddress":{ - "shape":"StringType", - "documentation":"

The user's IP address.

" - }, - "DeviceName":{ - "shape":"StringType", - "documentation":"

The user's device name.

" - }, - "Timezone":{ - "shape":"StringType", - "documentation":"

The user's time zone.

" - }, - "City":{ - "shape":"StringType", - "documentation":"

The user's city.

" - }, - "Country":{ - "shape":"StringType", - "documentation":"

The user's country.

" - } - }, - "documentation":"

Specifies the user context data captured at the time of an event request.

" - }, - "EventFeedbackType":{ - "type":"structure", - "required":[ - "FeedbackValue", - "Provider" - ], - "members":{ - "FeedbackValue":{ - "shape":"FeedbackValueType", - "documentation":"

The event feedback value.

" - }, - "Provider":{ - "shape":"StringType", - "documentation":"

The provider.

" - }, - "FeedbackDate":{ - "shape":"DateType", - "documentation":"

The event feedback date.

" - } - }, - "documentation":"

Specifies the event feedback type.

" - }, - "EventFilterType":{ - "type":"string", - "enum":[ - "SIGN_IN", - "PASSWORD_CHANGE", - "SIGN_UP" - ] - }, - "EventFiltersType":{ - "type":"list", - "member":{"shape":"EventFilterType"} - }, - "EventIdType":{ - "type":"string", - "max":50, - "min":1, - "pattern":"[\\w+-]+" - }, - "EventResponseType":{ - "type":"string", - "enum":[ - "Success", - "Failure" - ] - }, - "EventRiskType":{ - "type":"structure", - "members":{ - "RiskDecision":{ - "shape":"RiskDecisionType", - "documentation":"

The risk decision.

" - }, - "RiskLevel":{ - "shape":"RiskLevelType", - "documentation":"

The risk level.

" - } - }, - "documentation":"

The event risk type.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "SignIn", - "SignUp", - "ForgotPassword" - ] - }, - "ExpiredCodeException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the expired code exception is thrown.

" - } - }, - "documentation":"

This exception is thrown if a code has expired.

", - "exception":true - }, - "ExplicitAuthFlowsListType":{ - "type":"list", - "member":{"shape":"ExplicitAuthFlowsType"} - }, - "ExplicitAuthFlowsType":{ - "type":"string", - "enum":[ - "ADMIN_NO_SRP_AUTH", - "CUSTOM_AUTH_FLOW_ONLY", - "USER_PASSWORD_AUTH" - ] - }, - "FeedbackValueType":{ - "type":"string", - "enum":[ - "Valid", - "Invalid" - ] - }, - "ForceAliasCreation":{"type":"boolean"}, - "ForgetDeviceRequest":{ - "type":"structure", - "required":["DeviceKey"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token for the forgotten device request.

" - }, - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - } - }, - "documentation":"

Represents the request to forget the device.

" - }, - "ForgotPasswordRequest":{ - "type":"structure", - "required":[ - "ClientId", - "Username" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "SecretHash":{ - "shape":"SecretHashType", - "documentation":"

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user for whom you want to enter a code to reset a forgotten password.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for ForgotPassword calls.

" - } - }, - "documentation":"

Represents the request to reset a user's password.

" - }, - "ForgotPasswordResponse":{ - "type":"structure", - "members":{ - "CodeDeliveryDetails":{ - "shape":"CodeDeliveryDetailsType", - "documentation":"

The code delivery details returned by the server in response to the request to reset a password.

" - } - }, - "documentation":"

Respresents the response from the server regarding the request to reset a password.

" - }, - "GenerateSecret":{"type":"boolean"}, - "GetCSVHeaderRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are to be imported into.

" - } - }, - "documentation":"

Represents the request to get the header information for the .csv file for the user import job.

" - }, - "GetCSVHeaderResponse":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are to be imported into.

" - }, - "CSVHeader":{ - "shape":"ListOfStringTypes", - "documentation":"

The header information for the .csv file for the user import job.

" - } - }, - "documentation":"

Represents the response from the server to the request to get the header information for the .csv file for the user import job.

" - }, - "GetDeviceRequest":{ - "type":"structure", - "required":["DeviceKey"], - "members":{ - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - } - }, - "documentation":"

Represents the request to get the device.

" - }, - "GetDeviceResponse":{ - "type":"structure", - "required":["Device"], - "members":{ - "Device":{ - "shape":"DeviceType", - "documentation":"

The device.

" - } - }, - "documentation":"

Gets the device response.

" - }, - "GetGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserPoolId" - ], - "members":{ - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - } - } - }, - "GetGroupResponse":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"GroupType", - "documentation":"

The group object for the group.

" - } - } - }, - "GetIdentityProviderByIdentifierRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "IdpIdentifier" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "IdpIdentifier":{ - "shape":"IdpIdentifierType", - "documentation":"

The identity provider ID.

" - } - } - }, - "GetIdentityProviderByIdentifierResponse":{ - "type":"structure", - "required":["IdentityProvider"], - "members":{ - "IdentityProvider":{ - "shape":"IdentityProviderType", - "documentation":"

The identity provider object.

" - } - } - }, - "GetSigningCertificateRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - } - }, - "documentation":"

Request to get a signing certificate from Cognito.

" - }, - "GetSigningCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"StringType", - "documentation":"

The signing certificate.

" - } - }, - "documentation":"

Response from Cognito for a signing certificate request.

" - }, - "GetUICustomizationRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The client ID for the client app.

" - } - } - }, - "GetUICustomizationResponse":{ - "type":"structure", - "required":["UICustomization"], - "members":{ - "UICustomization":{ - "shape":"UICustomizationType", - "documentation":"

The UI customization information.

" - } - } - }, - "GetUserAttributeVerificationCodeRequest":{ - "type":"structure", - "required":[ - "AccessToken", - "AttributeName" - ], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token returned by the server response to get the user attribute verification code.

" - }, - "AttributeName":{ - "shape":"AttributeNameType", - "documentation":"

The attribute name returned by the server response to get the user attribute verification code.

" - } - }, - "documentation":"

Represents the request to get user attribute verification.

" - }, - "GetUserAttributeVerificationCodeResponse":{ - "type":"structure", - "members":{ - "CodeDeliveryDetails":{ - "shape":"CodeDeliveryDetailsType", - "documentation":"

The code delivery details returned by the server in response to the request to get the user attribute verification code.

" - } - }, - "documentation":"

The verification code response returned by the server response to get the user attribute verification code.

" - }, - "GetUserPoolMfaConfigRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - } - } - }, - "GetUserPoolMfaConfigResponse":{ - "type":"structure", - "members":{ - "SmsMfaConfiguration":{ - "shape":"SmsMfaConfigType", - "documentation":"

The SMS text message multi-factor (MFA) configuration.

" - }, - "SoftwareTokenMfaConfiguration":{ - "shape":"SoftwareTokenMfaConfigType", - "documentation":"

The software token multi-factor (MFA) configuration.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

The multi-factor (MFA) configuration.

" - } - } - }, - "GetUserRequest":{ - "type":"structure", - "required":["AccessToken"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token returned by the server response to get information about the user.

" - } - }, - "documentation":"

Represents the request to get information about the user.

" - }, - "GetUserResponse":{ - "type":"structure", - "required":[ - "Username", - "UserAttributes" - ], - "members":{ - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to retrieve from the get user request.

" - }, - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs representing user attributes.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - }, - "MFAOptions":{ - "shape":"MFAOptionListType", - "documentation":"

Specifies the options for MFA (e.g., email or phone number).

" - }, - "PreferredMfaSetting":{ - "shape":"StringType", - "documentation":"

The user's preferred MFA setting.

" - }, - "UserMFASettingList":{ - "shape":"UserMFASettingListType", - "documentation":"

The list of the user's MFA settings.

" - } - }, - "documentation":"

Represents the response from the server from the request to get information about the user.

" - }, - "GlobalSignOutRequest":{ - "type":"structure", - "required":["AccessToken"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - } - }, - "documentation":"

Represents the request to sign out all devices.

" - }, - "GlobalSignOutResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response to the request to sign out all devices.

" - }, - "GroupExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when Amazon Cognito encounters a group that already exists in the user pool.

", - "exception":true - }, - "GroupListType":{ - "type":"list", - "member":{"shape":"GroupType"} - }, - "GroupNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "GroupType":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

A string containing the description of the group.

" - }, - "RoleArn":{ - "shape":"ArnType", - "documentation":"

The role ARN for the group.

" - }, - "Precedence":{ - "shape":"PrecedenceType", - "documentation":"

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. If a user belongs to two or more groups, it is the group with the highest precedence whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens. Groups with higher Precedence values take precedence over groups with lower Precedence values or with null Precedence values.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the group was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the group was created.

" - } - }, - "documentation":"

The group type.

" - }, - "HexStringType":{ - "type":"string", - "pattern":"^[0-9a-fA-F]+$" - }, - "HttpHeader":{ - "type":"structure", - "members":{ - "headerName":{ - "shape":"StringType", - "documentation":"

The header name

" - }, - "headerValue":{ - "shape":"StringType", - "documentation":"

The header value.

" - } - }, - "documentation":"

The HTTP header.

" - }, - "HttpHeaderList":{ - "type":"list", - "member":{"shape":"HttpHeader"} - }, - "IdentityProviderType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The identity provider name.

" - }, - "ProviderType":{ - "shape":"IdentityProviderTypeType", - "documentation":"

The identity provider type.

" - }, - "ProviderDetails":{ - "shape":"ProviderDetailsType", - "documentation":"

The identity provider details, such as MetadataURL and MetadataFile.

" - }, - "AttributeMapping":{ - "shape":"AttributeMappingType", - "documentation":"

A mapping of identity provider attributes to standard and custom user pool attributes.

" - }, - "IdpIdentifiers":{ - "shape":"IdpIdentifiersListType", - "documentation":"

A list of identity provider identifiers.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the identity provider was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the identity provider was created.

" - } - }, - "documentation":"

A container for information about an identity provider.

" - }, - "IdentityProviderTypeType":{ - "type":"string", - "enum":[ - "SAML", - "Facebook", - "Google", - "LoginWithAmazon", - "OIDC" - ] - }, - "IdpIdentifierType":{ - "type":"string", - "max":40, - "min":1, - "pattern":"[\\w\\s+=.@-]+" - }, - "IdpIdentifiersListType":{ - "type":"list", - "member":{"shape":"IdpIdentifierType"}, - "max":50, - "min":0 - }, - "ImageFileType":{"type":"blob"}, - "ImageUrlType":{"type":"string"}, - "InitiateAuthRequest":{ - "type":"structure", - "required":[ - "AuthFlow", - "ClientId" - ], - "members":{ - "AuthFlow":{ - "shape":"AuthFlowType", - "documentation":"

The authentication flow for this call to execute. The API action will depend on this value. For example:

  • REFRESH_TOKEN_AUTH will take in a valid refresh token and return new tokens.

  • USER_SRP_AUTH will take in USERNAME and SRP_A and return the SRP variables to be used for next challenge execution.

  • USER_PASSWORD_AUTH will take in USERNAME and PASSWORD and return the next challenge or tokens.

Valid values include:

  • USER_SRP_AUTH: Authentication flow for the Secure Remote Password (SRP) protocol.

  • REFRESH_TOKEN_AUTH/REFRESH_TOKEN: Authentication flow for refreshing the access token and ID token by supplying a valid refresh token.

  • CUSTOM_AUTH: Custom authentication flow.

  • USER_PASSWORD_AUTH: Non-SRP authentication flow; USERNAME and PASSWORD are passed directly. If a user migration Lambda trigger is set, this flow will invoke the user migration Lambda if the USERNAME is not found in the user pool.

ADMIN_NO_SRP_AUTH is not a valid value.

" - }, - "AuthParameters":{ - "shape":"AuthParametersType", - "documentation":"

The authentication parameters. These are inputs corresponding to the AuthFlow that you are invoking. The required values depend on the value of AuthFlow:

  • For USER_SRP_AUTH: USERNAME (required), SRP_A (required), SECRET_HASH (required if the app client is configured with a client secret), DEVICE_KEY

  • For REFRESH_TOKEN_AUTH/REFRESH_TOKEN: REFRESH_TOKEN (required), SECRET_HASH (required if the app client is configured with a client secret), DEVICE_KEY

  • For CUSTOM_AUTH: USERNAME (required), SECRET_HASH (if app client is configured with client secret), DEVICE_KEY

" - }, - "ClientMetadata":{ - "shape":"ClientMetadataType", - "documentation":"

This is a random key-value pair map which can contain any key and will be passed to your PreAuthentication Lambda trigger as-is. It can be used to implement additional validations around authentication.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for InitiateAuth calls.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

Initiates the authentication request.

" - }, - "InitiateAuthResponse":{ - "type":"structure", - "members":{ - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The name of the challenge which you are responding to with this call. This is returned to you in the AdminInitiateAuth response if you need to pass another challenge.

Valid values include the following. Note that all of these challenges require USERNAME and SECRET_HASH (if applicable) in the parameters.

  • SMS_MFA: Next challenge is to supply an SMS_MFA_CODE, delivered via SMS.

  • PASSWORD_VERIFIER: Next challenge is to supply PASSWORD_CLAIM_SIGNATURE, PASSWORD_CLAIM_SECRET_BLOCK, and TIMESTAMP after the client-side SRP calculations.

  • CUSTOM_CHALLENGE: This is returned if your custom authentication flow determines that the user should pass another challenge before tokens are issued.

  • DEVICE_SRP_AUTH: If device tracking was enabled on your user pool and the previous challenges were passed, this challenge is returned so that Amazon Cognito can start tracking this device.

  • DEVICE_PASSWORD_VERIFIER: Similar to PASSWORD_VERIFIER, but for devices only.

  • NEW_PASSWORD_REQUIRED: For users which are required to change their passwords after successful first login. This challenge should be passed with NEW_PASSWORD and any other required attributes.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If the or API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next RespondToAuthChallenge API call.

" - }, - "ChallengeParameters":{ - "shape":"ChallengeParametersType", - "documentation":"

The challenge parameters. These are returned to you in the InitiateAuth response if you need to pass another challenge. The responses in this parameter should be used to compute inputs to the next call (RespondToAuthChallenge).

All challenges require USERNAME and SECRET_HASH (if applicable).

" - }, - "AuthenticationResult":{ - "shape":"AuthenticationResultType", - "documentation":"

The result of the authentication response. This is only returned if the caller does not need to pass another challenge. If the caller does need to pass another challenge before it gets tokens, ChallengeName, ChallengeParameters, and Session are returned.

" - } - }, - "documentation":"

Initiates the authentication response.

" - }, - "IntegerType":{"type":"integer"}, - "InternalErrorException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when Amazon Cognito throws an internal error exception.

" - } - }, - "documentation":"

This exception is thrown when Amazon Cognito encounters an internal error.

", - "exception":true, - "fault":true - }, - "InvalidEmailRoleAccessPolicyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when you have an unverified email address or the identity policy is not set on an email address that Amazon Cognito can access.

" - } - }, - "documentation":"

This exception is thrown when Amazon Cognito is not allowed to use your email identity. HTTP status code: 400.

", - "exception":true - }, - "InvalidLambdaResponseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service throws an invalid AWS Lambda response exception.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service encounters an invalid AWS Lambda response.

", - "exception":true - }, - "InvalidOAuthFlowException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when the specified OAuth flow is invalid.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service throws an invalid parameter exception.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service encounters an invalid parameter.

", - "exception":true - }, - "InvalidPasswordException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service throws an invalid user password exception.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service encounters an invalid password.

", - "exception":true - }, - "InvalidSmsRoleAccessPolicyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message retuned when the invalid SMS role access policy exception is thrown.

" - } - }, - "documentation":"

This exception is returned when the role provided for SMS configuration does not have permission to publish using Amazon SNS.

", - "exception":true - }, - "InvalidSmsRoleTrustRelationshipException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the role trust relationship for the SMS message is invalid.

" - } - }, - "documentation":"

This exception is thrown when the trust relationship is invalid for the role provided for SMS configuration. This can happen if you do not trust cognito-idp.amazonaws.com or the external ID provided in the role does not match what is provided in the SMS configuration for the user pool.

", - "exception":true - }, - "InvalidUserPoolConfigurationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the user pool configuration is invalid.

" - } - }, - "documentation":"

This exception is thrown when the user pool configuration is invalid.

", - "exception":true - }, - "LambdaConfigType":{ - "type":"structure", - "members":{ - "PreSignUp":{ - "shape":"ArnType", - "documentation":"

A pre-registration AWS Lambda trigger.

" - }, - "CustomMessage":{ - "shape":"ArnType", - "documentation":"

A custom Message AWS Lambda trigger.

" - }, - "PostConfirmation":{ - "shape":"ArnType", - "documentation":"

A post-confirmation AWS Lambda trigger.

" - }, - "PreAuthentication":{ - "shape":"ArnType", - "documentation":"

A pre-authentication AWS Lambda trigger.

" - }, - "PostAuthentication":{ - "shape":"ArnType", - "documentation":"

A post-authentication AWS Lambda trigger.

" - }, - "DefineAuthChallenge":{ - "shape":"ArnType", - "documentation":"

Defines the authentication challenge.

" - }, - "CreateAuthChallenge":{ - "shape":"ArnType", - "documentation":"

Creates an authentication challenge.

" - }, - "VerifyAuthChallengeResponse":{ - "shape":"ArnType", - "documentation":"

Verifies the authentication challenge response.

" - }, - "PreTokenGeneration":{ - "shape":"ArnType", - "documentation":"

A Lambda trigger that is invoked before token generation.

" - }, - "UserMigration":{ - "shape":"ArnType", - "documentation":"

The user migration Lambda config type.

" - } - }, - "documentation":"

Specifies the configuration for AWS Lambda triggers.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when Amazon Cognito throws a limit exceeded exception.

" - } - }, - "documentation":"

This exception is thrown when a user exceeds the limit for a requested AWS resource.

", - "exception":true - }, - "ListDevicesRequest":{ - "type":"structure", - "required":["AccessToken"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access tokens for the request to list devices.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

The limit of the device request.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

The pagination token for the list request.

" - } - }, - "documentation":"

Represents the request to list the devices.

" - }, - "ListDevicesResponse":{ - "type":"structure", - "members":{ - "Devices":{ - "shape":"DeviceListType", - "documentation":"

The devices returned in the list devices response.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

The pagination token for the list device response.

" - } - }, - "documentation":"

Represents the response to list devices.

" - }, - "ListGroupsRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

The limit of the request to list groups.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListGroupsResponse":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupListType", - "documentation":"

The group objects for the groups.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListIdentityProvidersRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "MaxResults":{ - "shape":"ListProvidersLimitType", - "documentation":"

The maximum number of identity providers to return.

" - }, - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

A pagination token.

" - } - } - }, - "ListIdentityProvidersResponse":{ - "type":"structure", - "required":["Providers"], - "members":{ - "Providers":{ - "shape":"ProvidersListType", - "documentation":"

A list of identity provider objects.

" - }, - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

A pagination token.

" - } - } - }, - "ListOfStringTypes":{ - "type":"list", - "member":{"shape":"StringType"} - }, - "ListProvidersLimitType":{ - "type":"integer", - "max":60, - "min":1 - }, - "ListResourceServersLimitType":{ - "type":"integer", - "max":50, - "min":1 - }, - "ListResourceServersRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "MaxResults":{ - "shape":"ListResourceServersLimitType", - "documentation":"

The maximum number of resource servers to return.

" - }, - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

A pagination token.

" - } - } - }, - "ListResourceServersResponse":{ - "type":"structure", - "required":["ResourceServers"], - "members":{ - "ResourceServers":{ - "shape":"ResourceServersListType", - "documentation":"

The resource servers.

" - }, - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

A pagination token.

" - } - } - }, - "ListUserImportJobsRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "MaxResults" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "MaxResults":{ - "shape":"PoolQueryLimitType", - "documentation":"

The maximum number of import jobs you want the request to return.

" - }, - "PaginationToken":{ - "shape":"PaginationKeyType", - "documentation":"

An identifier that was returned from the previous call to ListUserImportJobs, which can be used to return the next set of import jobs in the list.

" - } - }, - "documentation":"

Represents the request to list the user import jobs.

" - }, - "ListUserImportJobsResponse":{ - "type":"structure", - "members":{ - "UserImportJobs":{ - "shape":"UserImportJobsListType", - "documentation":"

The user import jobs.

" - }, - "PaginationToken":{ - "shape":"PaginationKeyType", - "documentation":"

An identifier that can be used to return the next set of user import jobs in the list.

" - } - }, - "documentation":"

Represents the response from the server to the request to list the user import jobs.

" - }, - "ListUserPoolClientsRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to list user pool clients.

" - }, - "MaxResults":{ - "shape":"QueryLimit", - "documentation":"

The maximum number of results you want the request to return when listing the user pool clients.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the request to list the user pool clients.

" - }, - "ListUserPoolClientsResponse":{ - "type":"structure", - "members":{ - "UserPoolClients":{ - "shape":"UserPoolClientListType", - "documentation":"

The user pool clients in the response that lists user pool clients.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the response from the server that lists user pool clients.

" - }, - "ListUserPoolsRequest":{ - "type":"structure", - "required":["MaxResults"], - "members":{ - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - }, - "MaxResults":{ - "shape":"PoolQueryLimitType", - "documentation":"

The maximum number of results you want the request to return when listing the user pools.

" - } - }, - "documentation":"

Represents the request to list user pools.

" - }, - "ListUserPoolsResponse":{ - "type":"structure", - "members":{ - "UserPools":{ - "shape":"UserPoolListType", - "documentation":"

The user pools from the response to list users.

" - }, - "NextToken":{ - "shape":"PaginationKeyType", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the response to list user pools.

" - }, - "ListUsersInGroupRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "GroupName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

The limit of the request to list users.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListUsersInGroupResponse":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"UsersListType", - "documentation":"

The users returned in the request to list users.

" - }, - "NextToken":{ - "shape":"PaginationKey", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListUsersRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool on which the search should be performed.

" - }, - "AttributesToGet":{ - "shape":"SearchedAttributeNamesListType", - "documentation":"

An array of strings, where each string is the name of a user attribute to be returned for each user in the search results. If the array is null, all attributes are returned.

" - }, - "Limit":{ - "shape":"QueryLimitType", - "documentation":"

Maximum number of users to be returned.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - }, - "Filter":{ - "shape":"UserFilterType", - "documentation":"

A filter string of the form \"AttributeName Filter-Type \"AttributeValue\"\". Quotation marks within the filter string must be escaped using the backslash (\\) character. For example, \"family_name = \\\"Reddy\\\"\".

  • AttributeName: The name of the attribute to search for. You can only search for one attribute at a time.

  • Filter-Type: For an exact match, use =, for example, \"given_name = \\\"Jon\\\"\". For a prefix (\"starts with\") match, use ^=, for example, \"given_name ^= \\\"Jon\\\"\".

  • AttributeValue: The attribute value that must be matched for each user.

If the filter string is empty, ListUsers returns all users in the user pool.

You can only search for the following standard attributes:

  • username (case-sensitive)

  • email

  • phone_number

  • name

  • given_name

  • family_name

  • preferred_username

  • cognito:user_status (called Enabled in the Console) (case-sensitive)

  • status (case-insensitive)

  • sub

Custom attributes are not searchable.

For more information, see Searching for Users Using the ListUsers API and Examples of Using the ListUsers API in the Amazon Cognito Developer Guide.

" - } - }, - "documentation":"

Represents the request to list users.

" - }, - "ListUsersResponse":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"UsersListType", - "documentation":"

The users returned in the request to list users.

" - }, - "PaginationToken":{ - "shape":"SearchPaginationTokenType", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

The response from the request to list users.

" - }, - "LogoutURLsListType":{ - "type":"list", - "member":{"shape":"RedirectUrlType"}, - "max":100, - "min":0 - }, - "LongType":{"type":"long"}, - "MFAMethodNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when Amazon Cognito throws an MFA method not found exception.

" - } - }, - "documentation":"

This exception is thrown when Amazon Cognito cannot find a multi-factor authentication (MFA) method.

", - "exception":true - }, - "MFAOptionListType":{ - "type":"list", - "member":{"shape":"MFAOptionType"} - }, - "MFAOptionType":{ - "type":"structure", - "members":{ - "DeliveryMedium":{ - "shape":"DeliveryMediumType", - "documentation":"

The delivery medium (email message or SMS message) to send the MFA code.

" - }, - "AttributeName":{ - "shape":"AttributeNameType", - "documentation":"

The attribute name of the MFA option type.

" - } - }, - "documentation":"

Specifies the different settings for multi-factor authentication (MFA).

" - }, - "MessageActionType":{ - "type":"string", - "enum":[ - "RESEND", - "SUPPRESS" - ] - }, - "MessageTemplateType":{ - "type":"structure", - "members":{ - "SMSMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The message template for SMS messages.

" - }, - "EmailMessage":{ - "shape":"EmailVerificationMessageType", - "documentation":"

The message template for email messages.

" - }, - "EmailSubject":{ - "shape":"EmailVerificationSubjectType", - "documentation":"

The subject line for email messages.

" - } - }, - "documentation":"

The message template structure.

" - }, - "MessageType":{"type":"string"}, - "NewDeviceMetadataType":{ - "type":"structure", - "members":{ - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "DeviceGroupKey":{ - "shape":"StringType", - "documentation":"

The device group key.

" - } - }, - "documentation":"

The new device metadata type.

" - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns a not authorized exception.

" - } - }, - "documentation":"

This exception is thrown when a user is not authorized.

", - "exception":true - }, - "NotifyConfigurationType":{ - "type":"structure", - "required":["SourceArn"], - "members":{ - "From":{ - "shape":"StringType", - "documentation":"

The email address that is sending the email. It must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES.

" - }, - "ReplyTo":{ - "shape":"StringType", - "documentation":"

The destination to which the receiver of an email should reply to.

" - }, - "SourceArn":{ - "shape":"ArnType", - "documentation":"

The Amazon Resource Name (ARN) of the identity that is associated with the sending authorization policy. It permits Amazon Cognito to send for the email address specified in the From parameter.

" - }, - "BlockEmail":{ - "shape":"NotifyEmailType", - "documentation":"

Email template used when a detected risk event is blocked.

" - }, - "NoActionEmail":{ - "shape":"NotifyEmailType", - "documentation":"

The email template used when a detected risk event is allowed.

" - }, - "MfaEmail":{ - "shape":"NotifyEmailType", - "documentation":"

The MFA email template used when MFA is challenged as part of a detected risk.

" - } - }, - "documentation":"

The notify configuration type.

" - }, - "NotifyEmailType":{ - "type":"structure", - "required":["Subject"], - "members":{ - "Subject":{ - "shape":"EmailNotificationSubjectType", - "documentation":"

The subject.

" - }, - "HtmlBody":{ - "shape":"EmailNotificationBodyType", - "documentation":"

The HTML body.

" - }, - "TextBody":{ - "shape":"EmailNotificationBodyType", - "documentation":"

The text body.

" - } - }, - "documentation":"

The notify email type.

" - }, - "NumberAttributeConstraintsType":{ - "type":"structure", - "members":{ - "MinValue":{ - "shape":"StringType", - "documentation":"

The minimum value of an attribute that is of the number data type.

" - }, - "MaxValue":{ - "shape":"StringType", - "documentation":"

The maximum value of an attribute that is of the number data type.

" - } - }, - "documentation":"

The minimum and maximum value of an attribute that is of the number data type.

" - }, - "OAuthFlowType":{ - "type":"string", - "enum":[ - "code", - "implicit", - "client_credentials" - ] - }, - "OAuthFlowsType":{ - "type":"list", - "member":{"shape":"OAuthFlowType"}, - "max":3, - "min":0 - }, - "PaginationKey":{ - "type":"string", - "min":1, - "pattern":"[\\S]+" - }, - "PaginationKeyType":{ - "type":"string", - "min":1, - "pattern":"[\\S]+" - }, - "PasswordPolicyMinLengthType":{ - "type":"integer", - "max":99, - "min":6 - }, - "PasswordPolicyType":{ - "type":"structure", - "members":{ - "MinimumLength":{ - "shape":"PasswordPolicyMinLengthType", - "documentation":"

The minimum length of the password policy that you have set. Cannot be less than 6.

" - }, - "RequireUppercase":{ - "shape":"BooleanType", - "documentation":"

In the password policy that you have set, refers to whether you have required users to use at least one uppercase letter in their password.

" - }, - "RequireLowercase":{ - "shape":"BooleanType", - "documentation":"

In the password policy that you have set, refers to whether you have required users to use at least one lowercase letter in their password.

" - }, - "RequireNumbers":{ - "shape":"BooleanType", - "documentation":"

In the password policy that you have set, refers to whether you have required users to use at least one number in their password.

" - }, - "RequireSymbols":{ - "shape":"BooleanType", - "documentation":"

In the password policy that you have set, refers to whether you have required users to use at least one symbol in their password.

" - } - }, - "documentation":"

The password policy type.

" - }, - "PasswordResetRequiredException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when a password reset is required.

" - } - }, - "documentation":"

This exception is thrown when a password reset is required.

", - "exception":true - }, - "PasswordType":{ - "type":"string", - "max":256, - "min":6, - "pattern":"[\\S]+", - "sensitive":true - }, - "PoolQueryLimitType":{ - "type":"integer", - "max":60, - "min":1 - }, - "PreSignedUrlType":{ - "type":"string", - "max":2048, - "min":0 - }, - "PrecedenceType":{ - "type":"integer", - "min":0 - }, - "PreconditionNotMetException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when a precondition is not met.

" - } - }, - "documentation":"

This exception is thrown when a precondition is not met.

", - "exception":true - }, - "ProviderDescription":{ - "type":"structure", - "members":{ - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The identity provider name.

" - }, - "ProviderType":{ - "shape":"IdentityProviderTypeType", - "documentation":"

The identity provider type.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the provider was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the provider was added to the user pool.

" - } - }, - "documentation":"

A container for identity provider details.

" - }, - "ProviderDetailsType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "ProviderNameType":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "ProviderNameTypeV1":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[^_][\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}][^_]+" - }, - "ProviderUserIdentifierType":{ - "type":"structure", - "members":{ - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The name of the provider, for example, Facebook, Google, or Login with Amazon.

" - }, - "ProviderAttributeName":{ - "shape":"StringType", - "documentation":"

The name of the provider attribute to link to, for example, NameID.

" - }, - "ProviderAttributeValue":{ - "shape":"StringType", - "documentation":"

The value of the provider attribute to link to, for example, xxxxx_account.

" - } - }, - "documentation":"

A container for information about an identity provider for a user pool.

" - }, - "ProvidersListType":{ - "type":"list", - "member":{"shape":"ProviderDescription"}, - "max":50, - "min":0 - }, - "QueryLimit":{ - "type":"integer", - "max":60, - "min":1 - }, - "QueryLimitType":{ - "type":"integer", - "max":60, - "min":0 - }, - "RedirectUrlType":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+" - }, - "RefreshTokenValidityType":{ - "type":"integer", - "max":3650, - "min":0 - }, - "ResendConfirmationCodeRequest":{ - "type":"structure", - "required":[ - "ClientId", - "Username" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "SecretHash":{ - "shape":"SecretHashType", - "documentation":"

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user to whom you wish to resend a confirmation code.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for ResendConfirmationCode calls.

" - } - }, - "documentation":"

Represents the request to resend the confirmation code.

" - }, - "ResendConfirmationCodeResponse":{ - "type":"structure", - "members":{ - "CodeDeliveryDetails":{ - "shape":"CodeDeliveryDetailsType", - "documentation":"

The code delivery details returned by the server in response to the request to resend the confirmation code.

" - } - }, - "documentation":"

The response from the server when the Amazon Cognito Your User Pools service makes the request to resend a confirmation code.

" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns a resource not found exception.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service cannot find the requested resource.

", - "exception":true - }, - "ResourceServerIdentifierType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\x21\\x23-\\x5B\\x5D-\\x7E]+" - }, - "ResourceServerNameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w\\s+=,.@-]+" - }, - "ResourceServerScopeDescriptionType":{ - "type":"string", - "max":256, - "min":1 - }, - "ResourceServerScopeListType":{ - "type":"list", - "member":{"shape":"ResourceServerScopeType"}, - "max":25 - }, - "ResourceServerScopeNameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\x21\\x23-\\x2E\\x30-\\x5B\\x5D-\\x7E]+" - }, - "ResourceServerScopeType":{ - "type":"structure", - "required":[ - "ScopeName", - "ScopeDescription" - ], - "members":{ - "ScopeName":{ - "shape":"ResourceServerScopeNameType", - "documentation":"

The name of the scope.

" - }, - "ScopeDescription":{ - "shape":"ResourceServerScopeDescriptionType", - "documentation":"

A description of the scope.

" - } - }, - "documentation":"

A resource server scope.

" - }, - "ResourceServerType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that hosts the resource server.

" - }, - "Identifier":{ - "shape":"ResourceServerIdentifierType", - "documentation":"

The identifier for the resource server.

" - }, - "Name":{ - "shape":"ResourceServerNameType", - "documentation":"

The name of the resource server.

" - }, - "Scopes":{ - "shape":"ResourceServerScopeListType", - "documentation":"

A list of scopes that are defined for the resource server.

" - } - }, - "documentation":"

A container for information about a resource server for a user pool.

" - }, - "ResourceServersListType":{ - "type":"list", - "member":{"shape":"ResourceServerType"} - }, - "RespondToAuthChallengeRequest":{ - "type":"structure", - "required":[ - "ClientId", - "ChallengeName" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - }, - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The challenge name. For more information, see .

ADMIN_NO_SRP_AUTH is not a valid value.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If InitiateAuth or RespondToAuthChallenge API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next RespondToAuthChallenge API call.

" - }, - "ChallengeResponses":{ - "shape":"ChallengeResponsesType", - "documentation":"

The challenge responses. These are inputs corresponding to the value of ChallengeName, for example:

  • SMS_MFA: SMS_MFA_CODE, USERNAME, SECRET_HASH (if app client is configured with client secret).

  • PASSWORD_VERIFIER: PASSWORD_CLAIM_SIGNATURE, PASSWORD_CLAIM_SECRET_BLOCK, TIMESTAMP, USERNAME, SECRET_HASH (if app client is configured with client secret).

  • NEW_PASSWORD_REQUIRED: NEW_PASSWORD, any other required attributes, USERNAME, SECRET_HASH (if app client is configured with client secret).

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for RespondToAuthChallenge calls.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

The request to respond to an authentication challenge.

" - }, - "RespondToAuthChallengeResponse":{ - "type":"structure", - "members":{ - "ChallengeName":{ - "shape":"ChallengeNameType", - "documentation":"

The challenge name. For more information, see .

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service. If the or API call determines that the caller needs to go through another challenge, they return a session with other challenge parameters. This session should be passed as it is to the next RespondToAuthChallenge API call.

" - }, - "ChallengeParameters":{ - "shape":"ChallengeParametersType", - "documentation":"

The challenge parameters. For more information, see .

" - }, - "AuthenticationResult":{ - "shape":"AuthenticationResultType", - "documentation":"

The result returned by the server in response to the request to respond to the authentication challenge.

" - } - }, - "documentation":"

The response to respond to the authentication challenge.

" - }, - "RiskConfigurationType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID.

" - }, - "CompromisedCredentialsRiskConfiguration":{ - "shape":"CompromisedCredentialsRiskConfigurationType", - "documentation":"

The compromised credentials risk configuration object including the EventFilter and the EventAction

" - }, - "AccountTakeoverRiskConfiguration":{ - "shape":"AccountTakeoverRiskConfigurationType", - "documentation":"

The account takeover risk configuration object including the NotifyConfiguration object and Actions to take in the case of an account takeover.

" - }, - "RiskExceptionConfiguration":{ - "shape":"RiskExceptionConfigurationType", - "documentation":"

The configuration to override the risk decision.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The last modified date.

" - } - }, - "documentation":"

The risk configuration type.

" - }, - "RiskDecisionType":{ - "type":"string", - "enum":[ - "NoRisk", - "AccountTakeover", - "Block" - ] - }, - "RiskExceptionConfigurationType":{ - "type":"structure", - "members":{ - "BlockedIPRangeList":{ - "shape":"BlockedIPRangeListType", - "documentation":"

Overrides the risk decision to always block the pre-authentication requests. The IP range is in CIDR notation: a compact representation of an IP address and its associated routing prefix.

" - }, - "SkippedIPRangeList":{ - "shape":"SkippedIPRangeListType", - "documentation":"

Risk detection is not performed on the IP addresses in the range list. The IP range is in CIDR notation.

" - } - }, - "documentation":"

The type of the configuration to override the risk decision.

" - }, - "RiskLevelType":{ - "type":"string", - "enum":[ - "Low", - "Medium", - "High" - ] - }, - "S3BucketType":{ - "type":"string", - "max":1024, - "min":3, - "pattern":"^[0-9A-Za-z\\.\\-_]*(?Specifies whether SMS text message MFA is enabled.

" - }, - "PreferredMfa":{ - "shape":"BooleanType", - "documentation":"

The preferred MFA method.

" - } - }, - "documentation":"

The SMS multi-factor authentication (MFA) settings type.

" - }, - "SchemaAttributeType":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"CustomAttributeNameType", - "documentation":"

A schema attribute of the name type.

" - }, - "AttributeDataType":{ - "shape":"AttributeDataType", - "documentation":"

The attribute data type.

" - }, - "DeveloperOnlyAttribute":{ - "shape":"BooleanType", - "documentation":"

Specifies whether the attribute type is developer only.

", - "box":true - }, - "Mutable":{ - "shape":"BooleanType", - "documentation":"

Specifies whether the value of the attribute can be changed.

", - "box":true - }, - "Required":{ - "shape":"BooleanType", - "documentation":"

Specifies whether a user pool attribute is required. If the attribute is required and the user does not provide a value, registration or sign-in will fail.

", - "box":true - }, - "NumberAttributeConstraints":{ - "shape":"NumberAttributeConstraintsType", - "documentation":"

Specifies the constraints for an attribute of the number type.

" - }, - "StringAttributeConstraints":{ - "shape":"StringAttributeConstraintsType", - "documentation":"

Specifies the constraints for an attribute of the string type.

" - } - }, - "documentation":"

Contains information about the schema attribute.

" - }, - "SchemaAttributesListType":{ - "type":"list", - "member":{"shape":"SchemaAttributeType"}, - "max":50, - "min":1 - }, - "ScopeDoesNotExistException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when the specified scope does not exist.

", - "exception":true - }, - "ScopeListType":{ - "type":"list", - "member":{"shape":"ScopeType"}, - "max":25 - }, - "ScopeType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\x21\\x23-\\x5B\\x5D-\\x7E]+" - }, - "SearchPaginationTokenType":{ - "type":"string", - "min":1, - "pattern":"[\\S]+" - }, - "SearchedAttributeNamesListType":{ - "type":"list", - "member":{"shape":"AttributeNameType"} - }, - "SecretCodeType":{ - "type":"string", - "min":16, - "pattern":"[A-Za-z0-9]+", - "sensitive":true - }, - "SecretHashType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=/]+", - "sensitive":true - }, - "SessionType":{ - "type":"string", - "max":2048, - "min":20 - }, - "SetRiskConfigurationRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The app client ID. If ClientId is null, then the risk configuration is mapped to userPoolId. When the client ID is null, the same risk configuration is applied to all the clients in the userPool.

Otherwise, ClientId is mapped to the client. When the client ID is not null, the user pool configuration is overridden and the risk configuration for the client is used instead.

" - }, - "CompromisedCredentialsRiskConfiguration":{ - "shape":"CompromisedCredentialsRiskConfigurationType", - "documentation":"

The compromised credentials risk configuration.

" - }, - "AccountTakeoverRiskConfiguration":{ - "shape":"AccountTakeoverRiskConfigurationType", - "documentation":"

The account takeover risk configuration.

" - }, - "RiskExceptionConfiguration":{ - "shape":"RiskExceptionConfigurationType", - "documentation":"

The configuration to override the risk decision.

" - } - } - }, - "SetRiskConfigurationResponse":{ - "type":"structure", - "required":["RiskConfiguration"], - "members":{ - "RiskConfiguration":{ - "shape":"RiskConfigurationType", - "documentation":"

The risk configuration.

" - } - } - }, - "SetUICustomizationRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The client ID for the client app.

" - }, - "CSS":{ - "shape":"CSSType", - "documentation":"

The CSS values in the UI customization.

" - }, - "ImageFile":{ - "shape":"ImageFileType", - "documentation":"

The uploaded logo image for the UI customization.

" - } - } - }, - "SetUICustomizationResponse":{ - "type":"structure", - "required":["UICustomization"], - "members":{ - "UICustomization":{ - "shape":"UICustomizationType", - "documentation":"

The UI customization information.

" - } - } - }, - "SetUserMFAPreferenceRequest":{ - "type":"structure", - "required":["AccessToken"], - "members":{ - "SMSMfaSettings":{ - "shape":"SMSMfaSettingsType", - "documentation":"

The SMS text message multi-factor authentication (MFA) settings.

" - }, - "SoftwareTokenMfaSettings":{ - "shape":"SoftwareTokenMfaSettingsType", - "documentation":"

The time-based one-time password software token MFA settings.

" - }, - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - } - } - }, - "SetUserMFAPreferenceResponse":{ - "type":"structure", - "members":{ - } - }, - "SetUserPoolMfaConfigRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "SmsMfaConfiguration":{ - "shape":"SmsMfaConfigType", - "documentation":"

The SMS text message MFA configuration.

" - }, - "SoftwareTokenMfaConfiguration":{ - "shape":"SoftwareTokenMfaConfigType", - "documentation":"

The software token MFA configuration.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

The MFA configuration.

" - } - } - }, - "SetUserPoolMfaConfigResponse":{ - "type":"structure", - "members":{ - "SmsMfaConfiguration":{ - "shape":"SmsMfaConfigType", - "documentation":"

The SMS text message MFA configuration.

" - }, - "SoftwareTokenMfaConfiguration":{ - "shape":"SoftwareTokenMfaConfigType", - "documentation":"

The software token MFA configuration.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

The MFA configuration.

" - } - } - }, - "SetUserSettingsRequest":{ - "type":"structure", - "required":[ - "AccessToken", - "MFAOptions" - ], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token for the set user settings request.

" - }, - "MFAOptions":{ - "shape":"MFAOptionListType", - "documentation":"

Specifies the options for MFA (e.g., email or phone number).

" - } - }, - "documentation":"

Represents the request to set user settings.

" - }, - "SetUserSettingsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response from the server for a set user settings request.

" - }, - "SignUpRequest":{ - "type":"structure", - "required":[ - "ClientId", - "Username", - "Password" - ], - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "SecretHash":{ - "shape":"SecretHashType", - "documentation":"

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to register.

" - }, - "Password":{ - "shape":"PasswordType", - "documentation":"

The password of the user you wish to register.

" - }, - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs representing user attributes.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - }, - "ValidationData":{ - "shape":"AttributeListType", - "documentation":"

The validation data in the request to register a user.

" - }, - "AnalyticsMetadata":{ - "shape":"AnalyticsMetadataType", - "documentation":"

The Amazon Pinpoint analytics metadata for collecting metrics for SignUp calls.

" - }, - "UserContextData":{ - "shape":"UserContextDataType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

Represents the request to register a user.

" - }, - "SignUpResponse":{ - "type":"structure", - "required":[ - "UserConfirmed", - "UserSub" - ], - "members":{ - "UserConfirmed":{ - "shape":"BooleanType", - "documentation":"

A response from the server indicating that a user registration has been confirmed.

" - }, - "CodeDeliveryDetails":{ - "shape":"CodeDeliveryDetailsType", - "documentation":"

The code delivery details returned by the server response to the user registration request.

" - }, - "UserSub":{ - "shape":"StringType", - "documentation":"

The UUID of the authenticated user. This is not the same as username.

" - } - }, - "documentation":"

The response from the server for a registration request.

" - }, - "SkippedIPRangeListType":{ - "type":"list", - "member":{"shape":"StringType"}, - "max":20 - }, - "SmsConfigurationType":{ - "type":"structure", - "required":["SnsCallerArn"], - "members":{ - "SnsCallerArn":{ - "shape":"ArnType", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) caller.

" - }, - "ExternalId":{ - "shape":"StringType", - "documentation":"

The external ID.

" - } - }, - "documentation":"

The SMS configuration type.

" - }, - "SmsMfaConfigType":{ - "type":"structure", - "members":{ - "SmsAuthenticationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The SMS authentication message.

" - }, - "SmsConfiguration":{ - "shape":"SmsConfigurationType", - "documentation":"

The SMS configuration.

" - } - }, - "documentation":"

The SMS text message multi-factor authentication (MFA) configuration type.

" - }, - "SmsVerificationMessageType":{ - "type":"string", - "max":140, - "min":6, - "pattern":".*\\{####\\}.*" - }, - "SoftwareTokenMFANotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when the software token TOTP multi-factor authentication (MFA) is not enabled for the user pool.

", - "exception":true - }, - "SoftwareTokenMFAUserCodeType":{ - "type":"string", - "max":6, - "min":6, - "pattern":"[0-9]+" - }, - "SoftwareTokenMfaConfigType":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"BooleanType", - "documentation":"

Specifies whether software token MFA is enabled.

" - } - }, - "documentation":"

The type used for enabling software token MFA at the user pool level.

" - }, - "SoftwareTokenMfaSettingsType":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"BooleanType", - "documentation":"

Specifies whether software token MFA is enabled.

" - }, - "PreferredMfa":{ - "shape":"BooleanType", - "documentation":"

The preferred MFA method.

" - } - }, - "documentation":"

The type used for enabling software token MFA at the user level.

" - }, - "StartUserImportJobRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "JobId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "JobId":{ - "shape":"UserImportJobIdType", - "documentation":"

The job ID for the user import job.

" - } - }, - "documentation":"

Represents the request to start the user import job.

" - }, - "StartUserImportJobResponse":{ - "type":"structure", - "members":{ - "UserImportJob":{ - "shape":"UserImportJobType", - "documentation":"

The job object that represents the user import job.

" - } - }, - "documentation":"

Represents the response from the server to the request to start the user import job.

" - }, - "StatusType":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "StopUserImportJobRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "JobId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "JobId":{ - "shape":"UserImportJobIdType", - "documentation":"

The job ID for the user import job.

" - } - }, - "documentation":"

Represents the request to stop the user import job.

" - }, - "StopUserImportJobResponse":{ - "type":"structure", - "members":{ - "UserImportJob":{ - "shape":"UserImportJobType", - "documentation":"

The job object that represents the user import job.

" - } - }, - "documentation":"

Represents the response from the server to the request to stop the user import job.

" - }, - "StringAttributeConstraintsType":{ - "type":"structure", - "members":{ - "MinLength":{ - "shape":"StringType", - "documentation":"

The minimum length.

" - }, - "MaxLength":{ - "shape":"StringType", - "documentation":"

The maximum length.

" - } - }, - "documentation":"

The constraints associated with a string attribute.

" - }, - "StringType":{"type":"string"}, - "SupportedIdentityProvidersListType":{ - "type":"list", - "member":{"shape":"ProviderNameType"} - }, - "TokenModelType":{ - "type":"string", - "pattern":"[A-Za-z0-9-_=.]+", - "sensitive":true - }, - "TooManyFailedAttemptsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns a too many failed attempts exception.

" - } - }, - "documentation":"

This exception is thrown when the user has made too many failed attempts for a given action (e.g., sign in).

", - "exception":true - }, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns a too many requests exception.

" - } - }, - "documentation":"

This exception is thrown when the user has made too many requests for a given operation.

", - "exception":true - }, - "UICustomizationType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The client ID for the client app.

" - }, - "ImageUrl":{ - "shape":"ImageUrlType", - "documentation":"

The logo image for the UI customization.

" - }, - "CSS":{ - "shape":"CSSType", - "documentation":"

The CSS values in the UI customization.

" - }, - "CSSVersion":{ - "shape":"CSSVersionType", - "documentation":"

The CSS version number.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The last-modified date for the UI customization.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The creation date for the UI customization.

" - } - }, - "documentation":"

A container for the UI customization information for a user pool's built-in app UI.

" - }, - "UnexpectedLambdaException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns an unexpected AWS Lambda exception.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service encounters an unexpected exception with the AWS Lambda service.

", - "exception":true - }, - "UnsupportedIdentityProviderException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when the specified identifier is not supported.

", - "exception":true - }, - "UnsupportedUserStateException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the user is in an unsupported state.

" - } - }, - "documentation":"

The request failed because the user is in an unsupported state.

", - "exception":true - }, - "UpdateAuthEventFeedbackRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Username", - "EventId", - "FeedbackToken", - "FeedbackValue" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The user pool username.

" - }, - "EventId":{ - "shape":"EventIdType", - "documentation":"

The event ID.

" - }, - "FeedbackToken":{ - "shape":"TokenModelType", - "documentation":"

The feedback token.

" - }, - "FeedbackValue":{ - "shape":"FeedbackValueType", - "documentation":"

The authentication event feedback value.

" - } - } - }, - "UpdateAuthEventFeedbackResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateDeviceStatusRequest":{ - "type":"structure", - "required":[ - "AccessToken", - "DeviceKey" - ], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - }, - "DeviceKey":{ - "shape":"DeviceKeyType", - "documentation":"

The device key.

" - }, - "DeviceRememberedStatus":{ - "shape":"DeviceRememberedStatusType", - "documentation":"

The status of whether a device is remembered.

" - } - }, - "documentation":"

Represents the request to update the device status.

" - }, - "UpdateDeviceStatusResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response to the request to update the device status.

" - }, - "UpdateGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserPoolId" - ], - "members":{ - "GroupName":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

A string containing the new description of the group.

" - }, - "RoleArn":{ - "shape":"ArnType", - "documentation":"

The new role ARN for the group. This is used for setting the cognito:roles and cognito:preferred_role claims in the token.

" - }, - "Precedence":{ - "shape":"PrecedenceType", - "documentation":"

The new precedence value for the group. For more information about this parameter, see .

" - } - } - }, - "UpdateGroupResponse":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"GroupType", - "documentation":"

The group object for the group.

" - } - } - }, - "UpdateIdentityProviderRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ProviderName" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID.

" - }, - "ProviderName":{ - "shape":"ProviderNameType", - "documentation":"

The identity provider name.

" - }, - "ProviderDetails":{ - "shape":"ProviderDetailsType", - "documentation":"

The identity provider details to be updated, such as MetadataURL and MetadataFile.

" - }, - "AttributeMapping":{ - "shape":"AttributeMappingType", - "documentation":"

The identity provider attribute mapping to be changed.

" - }, - "IdpIdentifiers":{ - "shape":"IdpIdentifiersListType", - "documentation":"

A list of identity provider identifiers.

" - } - } - }, - "UpdateIdentityProviderResponse":{ - "type":"structure", - "required":["IdentityProvider"], - "members":{ - "IdentityProvider":{ - "shape":"IdentityProviderType", - "documentation":"

The identity provider object.

" - } - } - }, - "UpdateResourceServerRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "Identifier", - "Name" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool.

" - }, - "Identifier":{ - "shape":"ResourceServerIdentifierType", - "documentation":"

The identifier for the resource server.

" - }, - "Name":{ - "shape":"ResourceServerNameType", - "documentation":"

The name of the resource server.

" - }, - "Scopes":{ - "shape":"ResourceServerScopeListType", - "documentation":"

The scope values to be set for the resource server.

" - } - } - }, - "UpdateResourceServerResponse":{ - "type":"structure", - "required":["ResourceServer"], - "members":{ - "ResourceServer":{ - "shape":"ResourceServerType", - "documentation":"

The resource server.

" - } - } - }, - "UpdateUserAttributesRequest":{ - "type":"structure", - "required":[ - "UserAttributes", - "AccessToken" - ], - "members":{ - "UserAttributes":{ - "shape":"AttributeListType", - "documentation":"

An array of name-value pairs representing user attributes.

For custom attributes, you must prepend the custom: prefix to the attribute name.

" - }, - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token for the request to update user attributes.

" - } - }, - "documentation":"

Represents the request to update user attributes.

" - }, - "UpdateUserAttributesResponse":{ - "type":"structure", - "members":{ - "CodeDeliveryDetailsList":{ - "shape":"CodeDeliveryDetailsListType", - "documentation":"

The code delivery details list from the server for the request to update user attributes.

" - } - }, - "documentation":"

Represents the response from the server for the request to update user attributes.

" - }, - "UpdateUserPoolClientRequest":{ - "type":"structure", - "required":[ - "UserPoolId", - "ClientId" - ], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to update the user pool client.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "ClientName":{ - "shape":"ClientNameType", - "documentation":"

The client name from the update user pool client request.

" - }, - "RefreshTokenValidity":{ - "shape":"RefreshTokenValidityType", - "documentation":"

The time limit, in days, after which the refresh token is no longer valid and cannot be used.

" - }, - "ReadAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The read-only attributes of the user pool.

" - }, - "WriteAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The writeable attributes of the user pool.

" - }, - "ExplicitAuthFlows":{ - "shape":"ExplicitAuthFlowsListType", - "documentation":"

Explicit authentication flows.

" - }, - "SupportedIdentityProviders":{ - "shape":"SupportedIdentityProvidersListType", - "documentation":"

A list of provider names for the identity providers that are supported on this client.

" - }, - "CallbackURLs":{ - "shape":"CallbackURLsListType", - "documentation":"

A list of allowed redirect (callback) URLs for the identity providers.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "LogoutURLs":{ - "shape":"LogoutURLsListType", - "documentation":"

A list of allowed logout URLs for the identity providers.

" - }, - "DefaultRedirectURI":{ - "shape":"RedirectUrlType", - "documentation":"

The default redirect URI. Must be in the CallbackURLs list.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "AllowedOAuthFlows":{ - "shape":"OAuthFlowsType", - "documentation":"

Set to code to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.

Set to token to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.

" - }, - "AllowedOAuthScopes":{ - "shape":"ScopeListType", - "documentation":"

A list of allowed OAuth scopes. Currently supported values are \"phone\", \"email\", \"openid\", and \"Cognito\".

" - }, - "AllowedOAuthFlowsUserPoolClient":{ - "shape":"BooleanType", - "documentation":"

Set to TRUE if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.

" - }, - "AnalyticsConfiguration":{ - "shape":"AnalyticsConfigurationType", - "documentation":"

The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.

" - } - }, - "documentation":"

Represents the request to update the user pool client.

" - }, - "UpdateUserPoolClientResponse":{ - "type":"structure", - "members":{ - "UserPoolClient":{ - "shape":"UserPoolClientType", - "documentation":"

The user pool client value from the response from the server when an update user pool client request is made.

" - } - }, - "documentation":"

Represents the response from the server to the request to update the user pool client.

" - }, - "UpdateUserPoolRequest":{ - "type":"structure", - "required":["UserPoolId"], - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool you want to update.

" - }, - "Policies":{ - "shape":"UserPoolPolicyType", - "documentation":"

A container with the policies you wish to update in a user pool.

" - }, - "LambdaConfig":{ - "shape":"LambdaConfigType", - "documentation":"

The AWS Lambda configuration information from the request to update the user pool.

" - }, - "AutoVerifiedAttributes":{ - "shape":"VerifiedAttributesListType", - "documentation":"

The attributes that are automatically verified when the Amazon Cognito service makes a request to update user pools.

" - }, - "SmsVerificationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

A container with information about the SMS verification message.

" - }, - "EmailVerificationMessage":{ - "shape":"EmailVerificationMessageType", - "documentation":"

The contents of the email verification message.

" - }, - "EmailVerificationSubject":{ - "shape":"EmailVerificationSubjectType", - "documentation":"

The subject of the email verification message.

" - }, - "VerificationMessageTemplate":{ - "shape":"VerificationMessageTemplateType", - "documentation":"

The template for verification messages.

" - }, - "SmsAuthenticationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The contents of the SMS authentication message.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

Can be one of the following values:

  • OFF - MFA tokens are not required and cannot be specified during user registration.

  • ON - MFA tokens are required for all user registrations. You can only specify required when you are initially creating a user pool.

  • OPTIONAL - Users have the option when registering to create an MFA token.

" - }, - "DeviceConfiguration":{ - "shape":"DeviceConfigurationType", - "documentation":"

Device configuration.

" - }, - "EmailConfiguration":{ - "shape":"EmailConfigurationType", - "documentation":"

Email configuration.

" - }, - "SmsConfiguration":{ - "shape":"SmsConfigurationType", - "documentation":"

SMS configuration.

" - }, - "UserPoolTags":{ - "shape":"UserPoolTagsType", - "documentation":"

The cost allocation tags for the user pool. For more information, see Adding Cost Allocation Tags to Your User Pool

" - }, - "AdminCreateUserConfig":{ - "shape":"AdminCreateUserConfigType", - "documentation":"

The configuration for AdminCreateUser requests.

" - }, - "UserPoolAddOns":{ - "shape":"UserPoolAddOnsType", - "documentation":"

Used to enable advanced security risk detection. Set the key AdvancedSecurityMode to the value \"AUDIT\".

" - } - }, - "documentation":"

Represents the request to update the user pool.

" - }, - "UpdateUserPoolResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the response from the server when you make a request to update the user pool.

" - }, - "UserContextDataType":{ - "type":"structure", - "members":{ - "EncodedData":{ - "shape":"StringType", - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - } - }, - "documentation":"

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

" - }, - "UserFilterType":{ - "type":"string", - "max":256 - }, - "UserImportInProgressException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the user pool has an import job running.

" - } - }, - "documentation":"

This exception is thrown when you are trying to modify a user pool while a user import job is in progress for that pool.

", - "exception":true - }, - "UserImportJobIdType":{ - "type":"string", - "max":55, - "min":1, - "pattern":"import-[0-9a-zA-Z-]+" - }, - "UserImportJobNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w\\s+=,.@-]+" - }, - "UserImportJobStatusType":{ - "type":"string", - "enum":[ - "Created", - "Pending", - "InProgress", - "Stopping", - "Expired", - "Stopped", - "Failed", - "Succeeded" - ] - }, - "UserImportJobType":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"UserImportJobNameType", - "documentation":"

The job name for the user import job.

" - }, - "JobId":{ - "shape":"UserImportJobIdType", - "documentation":"

The job ID for the user import job.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool that the users are being imported into.

" - }, - "PreSignedUrl":{ - "shape":"PreSignedUrlType", - "documentation":"

The pre-signed URL to be used to upload the .csv file.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the user import job was created.

" - }, - "StartDate":{ - "shape":"DateType", - "documentation":"

The date when the user import job was started.

" - }, - "CompletionDate":{ - "shape":"DateType", - "documentation":"

The date when the user import job was completed.

" - }, - "Status":{ - "shape":"UserImportJobStatusType", - "documentation":"

The status of the user import job. One of the following:

  • Created - The job was created but not started.

  • Pending - A transition state. You have started the job, but it has not begun importing users yet.

  • InProgress - The job has started, and users are being imported.

  • Stopping - You have stopped the job, but the job has not stopped importing users yet.

  • Stopped - You have stopped the job, and the job has stopped importing users.

  • Succeeded - The job has completed successfully.

  • Failed - The job has stopped due to an error.

  • Expired - You created a job, but did not start the job within 24-48 hours. All data associated with the job was deleted, and the job cannot be started.

" - }, - "CloudWatchLogsRoleArn":{ - "shape":"ArnType", - "documentation":"

The role ARN for the Amazon CloudWatch Logging role for the user import job. For more information, see \"Creating the CloudWatch Logs IAM Role\" in the Amazon Cognito Developer Guide.

" - }, - "ImportedUsers":{ - "shape":"LongType", - "documentation":"

The number of users that were successfully imported.

" - }, - "SkippedUsers":{ - "shape":"LongType", - "documentation":"

The number of users that were skipped.

" - }, - "FailedUsers":{ - "shape":"LongType", - "documentation":"

The number of users that could not be imported.

" - }, - "CompletionMessage":{ - "shape":"CompletionMessageType", - "documentation":"

The message returned when the user import job is completed.

" - } - }, - "documentation":"

The user import job type.

" - }, - "UserImportJobsListType":{ - "type":"list", - "member":{"shape":"UserImportJobType"}, - "max":50, - "min":1 - }, - "UserLambdaValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when the Amazon Cognito service returns a user validation exception with the AWS Lambda service.

" - } - }, - "documentation":"

This exception is thrown when the Amazon Cognito service encounters a user validation exception with the AWS Lambda service.

", - "exception":true - }, - "UserMFASettingListType":{ - "type":"list", - "member":{"shape":"StringType"} - }, - "UserNotConfirmedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when a user is not confirmed successfully.

" - } - }, - "documentation":"

This exception is thrown when a user is not confirmed successfully.

", - "exception":true - }, - "UserNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when a user is not found.

" - } - }, - "documentation":"

This exception is thrown when a user is not found.

", - "exception":true - }, - "UserPoolAddOnNotEnabledException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when user pool add-ons are not enabled.

", - "exception":true - }, - "UserPoolAddOnsType":{ - "type":"structure", - "required":["AdvancedSecurityMode"], - "members":{ - "AdvancedSecurityMode":{ - "shape":"AdvancedSecurityModeType", - "documentation":"

The advanced security mode.

" - } - }, - "documentation":"

The user pool add-ons type.

" - }, - "UserPoolClientDescription":{ - "type":"structure", - "members":{ - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool where you want to describe the user pool client.

" - }, - "ClientName":{ - "shape":"ClientNameType", - "documentation":"

The client name from the user pool client description.

" - } - }, - "documentation":"

The description of the user pool client.

" - }, - "UserPoolClientListType":{ - "type":"list", - "member":{"shape":"UserPoolClientDescription"} - }, - "UserPoolClientType":{ - "type":"structure", - "members":{ - "UserPoolId":{ - "shape":"UserPoolIdType", - "documentation":"

The user pool ID for the user pool client.

" - }, - "ClientName":{ - "shape":"ClientNameType", - "documentation":"

The client name from the user pool request of the client type.

" - }, - "ClientId":{ - "shape":"ClientIdType", - "documentation":"

The ID of the client associated with the user pool.

" - }, - "ClientSecret":{ - "shape":"ClientSecretType", - "documentation":"

The client secret from the user pool request of the client type.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the user pool client was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the user pool client was created.

" - }, - "RefreshTokenValidity":{ - "shape":"RefreshTokenValidityType", - "documentation":"

The time limit, in days, after which the refresh token is no longer valid and cannot be used.

" - }, - "ReadAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The Read-only attributes.

" - }, - "WriteAttributes":{ - "shape":"ClientPermissionListType", - "documentation":"

The writeable attributes.

" - }, - "ExplicitAuthFlows":{ - "shape":"ExplicitAuthFlowsListType", - "documentation":"

The explicit authentication flows.

" - }, - "SupportedIdentityProviders":{ - "shape":"SupportedIdentityProvidersListType", - "documentation":"

A list of provider names for the identity providers that are supported on this client.

" - }, - "CallbackURLs":{ - "shape":"CallbackURLsListType", - "documentation":"

A list of allowed redirect (callback) URLs for the identity providers.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "LogoutURLs":{ - "shape":"LogoutURLsListType", - "documentation":"

A list of allowed logout URLs for the identity providers.

" - }, - "DefaultRedirectURI":{ - "shape":"RedirectUrlType", - "documentation":"

The default redirect URI. Must be in the CallbackURLs list.

A redirect URI must:

  • Be an absolute URI.

  • Be registered with the authorization server.

  • Not use HTTP without TLS (i.e. use HTTPS instead of HTTP).

  • Not include a fragment component.

See OAuth 2.0 - Redirection Endpoint.

" - }, - "AllowedOAuthFlows":{ - "shape":"OAuthFlowsType", - "documentation":"

Set to code to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.

Set to token to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.

" - }, - "AllowedOAuthScopes":{ - "shape":"ScopeListType", - "documentation":"

A list of allowed OAuth scopes. Currently supported values are \"phone\", \"email\", \"openid\", and \"Cognito\".

" - }, - "AllowedOAuthFlowsUserPoolClient":{ - "shape":"BooleanType", - "documentation":"

Set to TRUE if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.

", - "box":true - }, - "AnalyticsConfiguration":{ - "shape":"AnalyticsConfigurationType", - "documentation":"

The Amazon Pinpoint analytics configuration for the user pool client.

" - } - }, - "documentation":"

Contains information about a user pool client.

" - }, - "UserPoolDescriptionType":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"UserPoolIdType", - "documentation":"

The ID in a user pool description.

" - }, - "Name":{ - "shape":"UserPoolNameType", - "documentation":"

The name in a user pool description.

" - }, - "LambdaConfig":{ - "shape":"LambdaConfigType", - "documentation":"

The AWS Lambda configuration information in a user pool description.

" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The user pool status in a user pool description.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the user pool description was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the user pool description was created.

" - } - }, - "documentation":"

A user pool description.

" - }, - "UserPoolIdType":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+_[0-9a-zA-Z]+" - }, - "UserPoolListType":{ - "type":"list", - "member":{"shape":"UserPoolDescriptionType"} - }, - "UserPoolMfaType":{ - "type":"string", - "enum":[ - "OFF", - "ON", - "OPTIONAL" - ] - }, - "UserPoolNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w\\s+=,.@-]+" - }, - "UserPoolPolicyType":{ - "type":"structure", - "members":{ - "PasswordPolicy":{ - "shape":"PasswordPolicyType", - "documentation":"

The password policy.

" - } - }, - "documentation":"

The policy associated with a user pool.

" - }, - "UserPoolTaggingException":{ - "type":"structure", - "members":{ - "message":{"shape":"MessageType"} - }, - "documentation":"

This exception is thrown when a user pool tag cannot be set or updated.

", - "exception":true - }, - "UserPoolTagsType":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "UserPoolType":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"UserPoolIdType", - "documentation":"

The ID of the user pool.

" - }, - "Name":{ - "shape":"UserPoolNameType", - "documentation":"

The name of the user pool.

" - }, - "Policies":{ - "shape":"UserPoolPolicyType", - "documentation":"

The policies associated with the user pool.

" - }, - "LambdaConfig":{ - "shape":"LambdaConfigType", - "documentation":"

The AWS Lambda triggers associated with the user pool.

" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status of a user pool.

" - }, - "LastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the user pool was last modified.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date the user pool was created.

" - }, - "SchemaAttributes":{ - "shape":"SchemaAttributesListType", - "documentation":"

A container with the schema attributes of a user pool.

" - }, - "AutoVerifiedAttributes":{ - "shape":"VerifiedAttributesListType", - "documentation":"

Specifies the attributes that are auto-verified in a user pool.

" - }, - "AliasAttributes":{ - "shape":"AliasAttributesListType", - "documentation":"

Specifies the attributes that are aliased in a user pool.

" - }, - "UsernameAttributes":{ - "shape":"UsernameAttributesListType", - "documentation":"

Specifies whether email addresses or phone numbers can be specified as usernames when a user signs up.

" - }, - "SmsVerificationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The contents of the SMS verification message.

" - }, - "EmailVerificationMessage":{ - "shape":"EmailVerificationMessageType", - "documentation":"

The contents of the email verification message.

" - }, - "EmailVerificationSubject":{ - "shape":"EmailVerificationSubjectType", - "documentation":"

The subject of the email verification message.

" - }, - "VerificationMessageTemplate":{ - "shape":"VerificationMessageTemplateType", - "documentation":"

The template for verification messages.

" - }, - "SmsAuthenticationMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The contents of the SMS authentication message.

" - }, - "MfaConfiguration":{ - "shape":"UserPoolMfaType", - "documentation":"

Can be one of the following values:

  • OFF - MFA tokens are not required and cannot be specified during user registration.

  • ON - MFA tokens are required for all user registrations. You can only specify required when you are initially creating a user pool.

  • OPTIONAL - Users have the option when registering to create an MFA token.

" - }, - "DeviceConfiguration":{ - "shape":"DeviceConfigurationType", - "documentation":"

The device configuration.

" - }, - "EstimatedNumberOfUsers":{ - "shape":"IntegerType", - "documentation":"

A number estimating the size of the user pool.

" - }, - "EmailConfiguration":{ - "shape":"EmailConfigurationType", - "documentation":"

The email configuration.

" - }, - "SmsConfiguration":{ - "shape":"SmsConfigurationType", - "documentation":"

The SMS configuration.

" - }, - "UserPoolTags":{ - "shape":"UserPoolTagsType", - "documentation":"

The cost allocation tags for the user pool. For more information, see Adding Cost Allocation Tags to Your User Pool

" - }, - "SmsConfigurationFailure":{ - "shape":"StringType", - "documentation":"

The reason why the SMS configuration cannot send the messages to your users.

" - }, - "EmailConfigurationFailure":{ - "shape":"StringType", - "documentation":"

The reason why the email configuration cannot send the messages to your users.

" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Holds the domain prefix if the user pool has a domain associated with it.

" - }, - "AdminCreateUserConfig":{ - "shape":"AdminCreateUserConfigType", - "documentation":"

The configuration for AdminCreateUser requests.

" - }, - "UserPoolAddOns":{ - "shape":"UserPoolAddOnsType", - "documentation":"

The user pool add-ons.

" - }, - "Arn":{ - "shape":"ArnType", - "documentation":"

The Amazon Resource Name (ARN) for the user pool.

" - } - }, - "documentation":"

A container for information about the user pool.

" - }, - "UserStatusType":{ - "type":"string", - "enum":[ - "UNCONFIRMED", - "CONFIRMED", - "ARCHIVED", - "COMPROMISED", - "UNKNOWN", - "RESET_REQUIRED", - "FORCE_CHANGE_PASSWORD" - ] - }, - "UserType":{ - "type":"structure", - "members":{ - "Username":{ - "shape":"UsernameType", - "documentation":"

The user name of the user you wish to describe.

" - }, - "Attributes":{ - "shape":"AttributeListType", - "documentation":"

A container with information about the user type attributes.

" - }, - "UserCreateDate":{ - "shape":"DateType", - "documentation":"

The creation date of the user.

" - }, - "UserLastModifiedDate":{ - "shape":"DateType", - "documentation":"

The last modified date of the user.

" - }, - "Enabled":{ - "shape":"BooleanType", - "documentation":"

Specifies whether the user is enabled.

" - }, - "UserStatus":{ - "shape":"UserStatusType", - "documentation":"

The user status. Can be one of the following:

  • UNCONFIRMED - User has been created but not confirmed.

  • CONFIRMED - User has been confirmed.

  • ARCHIVED - User is no longer active.

  • COMPROMISED - User is disabled due to a potential security threat.

  • UNKNOWN - User status is not known.

" - }, - "MFAOptions":{ - "shape":"MFAOptionListType", - "documentation":"

The MFA options for the user.

" - } - }, - "documentation":"

The user type.

" - }, - "UsernameAttributeType":{ - "type":"string", - "enum":[ - "phone_number", - "email" - ] - }, - "UsernameAttributesListType":{ - "type":"list", - "member":{"shape":"UsernameAttributeType"} - }, - "UsernameExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"MessageType", - "documentation":"

The message returned when Amazon Cognito throws a user name exists exception.

" - } - }, - "documentation":"

This exception is thrown when Amazon Cognito encounters a user name that already exists in the user pool.

", - "exception":true - }, - "UsernameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\p{L}\\p{M}\\p{S}\\p{N}\\p{P}]+", - "sensitive":true - }, - "UsersListType":{ - "type":"list", - "member":{"shape":"UserType"} - }, - "VerificationMessageTemplateType":{ - "type":"structure", - "members":{ - "SmsMessage":{ - "shape":"SmsVerificationMessageType", - "documentation":"

The SMS message template.

" - }, - "EmailMessage":{ - "shape":"EmailVerificationMessageType", - "documentation":"

The email message template.

" - }, - "EmailSubject":{ - "shape":"EmailVerificationSubjectType", - "documentation":"

The subject line for the email message template.

" - }, - "EmailMessageByLink":{ - "shape":"EmailVerificationMessageByLinkType", - "documentation":"

The email message template for sending a confirmation link to the user.

" - }, - "EmailSubjectByLink":{ - "shape":"EmailVerificationSubjectByLinkType", - "documentation":"

The subject line for the email message template for sending a confirmation link to the user.

" - }, - "DefaultEmailOption":{ - "shape":"DefaultEmailOptionType", - "documentation":"

The default email option.

" - } - }, - "documentation":"

The template for verification messages.

" - }, - "VerifiedAttributeType":{ - "type":"string", - "enum":[ - "phone_number", - "email" - ] - }, - "VerifiedAttributesListType":{ - "type":"list", - "member":{"shape":"VerifiedAttributeType"} - }, - "VerifySoftwareTokenRequest":{ - "type":"structure", - "required":["UserCode"], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

The access token.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service.

" - }, - "UserCode":{ - "shape":"SoftwareTokenMFAUserCodeType", - "documentation":"

The one time password computed using the secret code returned by

" - }, - "FriendlyDeviceName":{ - "shape":"StringType", - "documentation":"

The friendly device name.

" - } - } - }, - "VerifySoftwareTokenResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VerifySoftwareTokenResponseType", - "documentation":"

The status of the verify software token.

" - }, - "Session":{ - "shape":"SessionType", - "documentation":"

The session which should be passed both ways in challenge-response calls to the service.

" - } - } - }, - "VerifySoftwareTokenResponseType":{ - "type":"string", - "enum":[ - "SUCCESS", - "ERROR" - ] - }, - "VerifyUserAttributeRequest":{ - "type":"structure", - "required":[ - "AccessToken", - "AttributeName", - "Code" - ], - "members":{ - "AccessToken":{ - "shape":"TokenModelType", - "documentation":"

Represents the access token of the request to verify user attributes.

" - }, - "AttributeName":{ - "shape":"AttributeNameType", - "documentation":"

The attribute name in the request to verify user attributes.

" - }, - "Code":{ - "shape":"ConfirmationCodeType", - "documentation":"

The verification code in the request to verify user attributes.

" - } - }, - "documentation":"

Represents the request to verify user attributes.

" - }, - "VerifyUserAttributeResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

A container representing the response from the server from the request to verify user attributes.

" - } - }, - "documentation":"

Using the Amazon Cognito User Pools API, you can create a user pool to manage directories and users. You can authenticate a user to obtain tokens related to user identity and access policies.

This API reference provides information about user pools in Amazon Cognito User Pools.

For more information, see the Amazon Cognito Documentation.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-sync/2014-06-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-sync/2014-06-30/service-2.json deleted file mode 100644 index 68c5ab5b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cognito-sync/2014-06-30/service-2.json +++ /dev/null @@ -1,2441 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-06-30", - "endpointPrefix":"cognito-sync", - "jsonVersion":"1.1", - "serviceFullName":"Amazon Cognito Sync", - "serviceId":"Cognito Sync", - "signatureVersion":"v4", - "protocol":"rest-json", - "uid":"cognito-sync-2014-06-30" - }, - "documentation":"Amazon Cognito Sync

Amazon Cognito Sync provides an AWS service and client library that enable cross-device syncing of application-related user data. High-level client libraries are available for both iOS and Android. You can use these libraries to persist data locally so that it's available even if the device is offline. Developer credentials don't need to be stored on the mobile device to access the service. You can use Amazon Cognito to obtain a normalized user ID and credentials. User data is persisted in a dataset that can store up to 1 MB of key-value pairs, and you can have up to 20 datasets per user identity.

With Amazon Cognito Sync, the data stored for each identity is accessible only to credentials assigned to that identity. In order to use the Cognito Sync service, you need to make API calls using credentials retrieved with Amazon Cognito Identity service.

If you want to use Cognito Sync in an Android or iOS application, you will probably want to make API calls via the AWS Mobile SDK. To learn more, see the Developer Guide for Android and the Developer Guide for iOS.

", - "operations":{ - "BulkPublish":{ - "name":"BulkPublish", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/bulkpublish", - "responseCode":200 - }, - "input":{ - "shape":"BulkPublishRequest", - "documentation":"The input for the BulkPublish operation." - }, - "output":{ - "shape":"BulkPublishResponse", - "documentation":"The output for the BulkPublish operation." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"DuplicateRequestException", - "error":{ - "code":"DuplicateRequest", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"An exception thrown when there is an IN_PROGRESS bulk publish operation for the given identity pool." - }, - { - "shape":"AlreadyStreamedException", - "error":{ - "code":"AlreadyStreamed", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"An exception thrown when a bulk publish operation is requested less than 24 hours after a previous bulk publish operation completed successfully." - } - ], - "documentation":"

Initiates a bulk publish of all existing datasets for an Identity Pool to the configured stream. Customers are limited to one successful bulk publish per 24 hours. Bulk publish is an asynchronous request, customers can see the status of the request via the GetBulkPublishDetails operation.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "DeleteDataset":{ - "name":"DeleteDataset", - "http":{ - "method":"DELETE", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}", - "responseCode":200 - }, - "input":{ - "shape":"DeleteDatasetRequest", - "documentation":"A request to delete the specific dataset." - }, - "output":{ - "shape":"DeleteDatasetResponse", - "documentation":"Response to a successful DeleteDataset request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - }, - { - "shape":"ResourceConflictException", - "error":{ - "code":"ResourceConflict", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if an update can't be applied because the resource was changed by another call and this would result in a conflict." - } - ], - "documentation":"

Deletes the specific dataset. The dataset will be deleted permanently, and the action can't be undone. Datasets that this dataset was merged with will no longer report the merge. Any subsequent operation on this dataset will result in a ResourceNotFoundException.

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

" - }, - "DescribeDataset":{ - "name":"DescribeDataset", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}", - "responseCode":200 - }, - "input":{ - "shape":"DescribeDatasetRequest", - "documentation":"A request for meta data about a dataset (creation date, number of records, size) by owner and dataset name." - }, - "output":{ - "shape":"DescribeDatasetResponse", - "documentation":"Response to a successful DescribeDataset request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets meta data about a dataset by identity and dataset name. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use Cognito Identity credentials to make this API call.

" - }, - "DescribeIdentityPoolUsage":{ - "name":"DescribeIdentityPoolUsage", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}", - "responseCode":200 - }, - "input":{ - "shape":"DescribeIdentityPoolUsageRequest", - "documentation":"A request for usage information about the identity pool." - }, - "output":{ - "shape":"DescribeIdentityPoolUsageResponse", - "documentation":"Response to a successful DescribeIdentityPoolUsage request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets usage details (for example, data storage) about a particular identity pool.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "DescribeIdentityUsage":{ - "name":"DescribeIdentityUsage", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}", - "responseCode":200 - }, - "input":{ - "shape":"DescribeIdentityUsageRequest", - "documentation":"A request for information about the usage of an identity pool." - }, - "output":{ - "shape":"DescribeIdentityUsageResponse", - "documentation":"The response to a successful DescribeIdentityUsage request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets usage information for an identity, including number of datasets and data usage.

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

" - }, - "GetBulkPublishDetails":{ - "name":"GetBulkPublishDetails", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/getBulkPublishDetails", - "responseCode":200 - }, - "input":{ - "shape":"GetBulkPublishDetailsRequest", - "documentation":"The input for the GetBulkPublishDetails operation." - }, - "output":{ - "shape":"GetBulkPublishDetailsResponse", - "documentation":"The output for the GetBulkPublishDetails operation." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - } - ], - "documentation":"

Get the status of the last BulkPublish operation for an identity pool.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "GetCognitoEvents":{ - "name":"GetCognitoEvents", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/events", - "responseCode":200 - }, - "input":{ - "shape":"GetCognitoEventsRequest", - "documentation":"

A request for a list of the configured Cognito Events

" - }, - "output":{ - "shape":"GetCognitoEventsResponse", - "documentation":"

The response from the GetCognitoEvents request

" - }, - "errors":[ - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets the events and the corresponding Lambda functions associated with an identity pool.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "GetIdentityPoolConfiguration":{ - "name":"GetIdentityPoolConfiguration", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/configuration", - "responseCode":200 - }, - "input":{ - "shape":"GetIdentityPoolConfigurationRequest", - "documentation":"

The input for the GetIdentityPoolConfiguration operation.

" - }, - "output":{ - "shape":"GetIdentityPoolConfigurationResponse", - "documentation":"

The output for the GetIdentityPoolConfiguration operation.

" - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets the configuration settings of an identity pool.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "ListDatasets":{ - "name":"ListDatasets", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets", - "responseCode":200 - }, - "input":{ - "shape":"ListDatasetsRequest", - "documentation":"Request for a list of datasets for an identity." - }, - "output":{ - "shape":"ListDatasetsResponse", - "documentation":"Returned for a successful ListDatasets request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Lists datasets for an identity. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

ListDatasets can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use the Cognito Identity credentials to make this API call.

" - }, - "ListIdentityPoolUsage":{ - "name":"ListIdentityPoolUsage", - "http":{ - "method":"GET", - "requestUri":"/identitypools", - "responseCode":200 - }, - "input":{ - "shape":"ListIdentityPoolUsageRequest", - "documentation":"A request for usage information on an identity pool." - }, - "output":{ - "shape":"ListIdentityPoolUsageResponse", - "documentation":"Returned for a successful ListIdentityPoolUsage request." - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Gets a list of identity pools registered with Cognito.

ListIdentityPoolUsage can only be called with developer credentials. You cannot make this API call with the temporary user credentials provided by Cognito Identity.

" - }, - "ListRecords":{ - "name":"ListRecords", - "http":{ - "method":"GET", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}/records", - "responseCode":200 - }, - "input":{ - "shape":"ListRecordsRequest", - "documentation":"A request for a list of records." - }, - "output":{ - "shape":"ListRecordsResponse", - "documentation":"Returned for a successful ListRecordsRequest." - }, - "errors":[ - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - } - ], - "documentation":"

Gets paginated records, optionally changed after a particular sync count for a dataset and identity. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

ListRecords can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use Cognito Identity credentials to make this API call.

" - }, - "RegisterDevice":{ - "name":"RegisterDevice", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/identity/{IdentityId}/device", - "responseCode":200 - }, - "input":{ - "shape":"RegisterDeviceRequest", - "documentation":"

A request to RegisterDevice.

" - }, - "output":{ - "shape":"RegisterDeviceResponse", - "documentation":"

Response to a RegisterDevice request.

" - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"InvalidConfigurationException", - "error":{ - "code":"InvalidConfiguration", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Registers a device to receive push sync notifications.

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

" - }, - "SetCognitoEvents":{ - "name":"SetCognitoEvents", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/events", - "responseCode":200 - }, - "input":{ - "shape":"SetCognitoEventsRequest", - "documentation":"

A request to configure Cognito Events\"

\"" - }, - "errors":[ - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Sets the AWS Lambda function for a given event type for an identity pool. This request only updates the key/value pair specified. Other key/values pairs are not updated. To remove a key value pair, pass a empty value for the particular key.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "SetIdentityPoolConfiguration":{ - "name":"SetIdentityPoolConfiguration", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/configuration", - "responseCode":200 - }, - "input":{ - "shape":"SetIdentityPoolConfigurationRequest", - "documentation":"

The input for the SetIdentityPoolConfiguration operation.

" - }, - "output":{ - "shape":"SetIdentityPoolConfigurationResponse", - "documentation":"

The output for the SetIdentityPoolConfiguration operation

" - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - }, - { - "shape":"ConcurrentModificationException", - "error":{ - "code":"ConcurrentModification", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Thrown if there are parallel requests to modify a resource.

" - } - ], - "documentation":"

Sets the necessary configuration for push sync.

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

" - }, - "SubscribeToDataset":{ - "name":"SubscribeToDataset", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}/subscriptions/{DeviceId}", - "responseCode":200 - }, - "input":{ - "shape":"SubscribeToDatasetRequest", - "documentation":"

A request to SubscribeToDatasetRequest.

" - }, - "output":{ - "shape":"SubscribeToDatasetResponse", - "documentation":"

Response to a SubscribeToDataset request.

" - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"InvalidConfigurationException", - "error":{ - "code":"InvalidConfiguration", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Subscribes to receive notifications when a dataset is modified by another device.

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

" - }, - "UnsubscribeFromDataset":{ - "name":"UnsubscribeFromDataset", - "http":{ - "method":"DELETE", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}/subscriptions/{DeviceId}", - "responseCode":200 - }, - "input":{ - "shape":"UnsubscribeFromDatasetRequest", - "documentation":"

A request to UnsubscribeFromDataset.

" - }, - "output":{ - "shape":"UnsubscribeFromDatasetResponse", - "documentation":"

Response to an UnsubscribeFromDataset request.

" - }, - "errors":[ - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - { - "shape":"InvalidConfigurationException", - "error":{ - "code":"InvalidConfiguration", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - } - ], - "documentation":"

Unsubscribes from receiving notifications when a dataset is modified by another device.

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

" - }, - "UpdateRecords":{ - "name":"UpdateRecords", - "http":{ - "method":"POST", - "requestUri":"/identitypools/{IdentityPoolId}/identities/{IdentityId}/datasets/{DatasetName}", - "responseCode":200 - }, - "input":{ - "shape":"UpdateRecordsRequest", - "documentation":"A request to post updates to records or add and delete records for a dataset and user." - }, - "output":{ - "shape":"UpdateRecordsResponse", - "documentation":"Returned for a successful UpdateRecordsRequest." - }, - "errors":[ - { - "shape":"InvalidParameterException", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - { - "shape":"LimitExceededException", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when the limit on the number of objects or operations has been exceeded." - }, - { - "shape":"NotAuthorizedException", - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - { - "shape":"ResourceNotFoundException", - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - { - "shape":"ResourceConflictException", - "error":{ - "code":"ResourceConflict", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if an update can't be applied because the resource was changed by another call and this would result in a conflict." - }, - { - "shape":"InvalidLambdaFunctionOutputException", - "error":{ - "code":"InvalidLambdaFunctionOutput", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The AWS Lambda function returned invalid output or an exception.

" - }, - { - "shape":"LambdaThrottledException", - "error":{ - "code":"LambdaThrottled", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"

AWS Lambda throttled your account, please contact AWS Support

" - }, - { - "shape":"TooManyRequestsException", - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - }, - { - "shape":"InternalErrorException", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - } - ], - "documentation":"

Posts updates to records and adds and deletes records for a dataset and user.

The sync count in the record patch is your last known sync count for that record. The server will reject an UpdateRecords request with a ResourceConflictException if you try to patch a record with a new value but a stale sync count.

For example, if the sync count on the server is 5 for a key called highScore and you try and submit a new highScore with sync count of 4, the request will be rejected. To obtain the current sync count for a record, call ListRecords. On a successful update of the record, the response returns the new sync count for that record. You should present that sync count the next time you try to update that same record. When the record does not exist, specify the sync count as 0.

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

" - } - }, - "shapes":{ - "AlreadyStreamedException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"The message associated with the AlreadyStreamedException exception." - } - }, - "error":{ - "code":"AlreadyStreamed", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"An exception thrown when a bulk publish operation is requested less than 24 hours after a previous bulk publish operation completed successfully." - }, - "ApplicationArn":{ - "type":"string", - "pattern":"arn:aws:sns:[-0-9a-z]+:\\d+:app/[A-Z_]+/[a-zA-Z0-9_.-]+" - }, - "ApplicationArnList":{ - "type":"list", - "member":{"shape":"ApplicationArn"} - }, - "AssumeRoleArn":{ - "type":"string", - "min":20, - "max":2048, - "pattern":"arn:aws:iam::\\d+:role/.*" - }, - "Boolean":{"type":"boolean"}, - "BulkPublishRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - } - }, - "documentation":"The input for the BulkPublish operation." - }, - "BulkPublishResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - } - }, - "documentation":"The output for the BulkPublish operation." - }, - "BulkPublishStatus":{ - "type":"string", - "enum":[ - "NOT_STARTED", - "IN_PROGRESS", - "FAILED", - "SUCCEEDED" - ] - }, - "ClientContext":{"type":"string"}, - "CognitoEventType":{"type":"string"}, - "CognitoStreams":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"The name of the Cognito stream to receive updates. This stream must be in the developers account and in the same region as the identity pool." - }, - "RoleArn":{ - "shape":"AssumeRoleArn", - "documentation":"The ARN of the role Amazon Cognito can assume in order to publish to the stream. This role must grant access to Amazon Cognito (cognito-sync) to invoke PutRecord on your Cognito stream." - }, - "StreamingStatus":{ - "shape":"StreamingStatus", - "documentation":"Status of the Cognito streams. Valid values are:

ENABLED - Streaming of updates to identity pool is enabled.

DISABLED - Streaming of updates to identity pool is disabled. Bulk publish will also fail if StreamingStatus is DISABLED.

" - } - }, - "documentation":"Configuration options for configure Cognito streams." - }, - "ConcurrentModificationException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"String", - "documentation":"

The message returned by a ConcurrentModicationException.

" - } - }, - "error":{ - "code":"ConcurrentModification", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Thrown if there are parallel requests to modify a resource.

" - }, - "Dataset":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "DatasetName":{ - "shape":"DatasetName", - "documentation":"A string of up to 128 characters. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (dash), and '.' (dot)." - }, - "CreationDate":{ - "shape":"Date", - "documentation":"Date on which the dataset was created." - }, - "LastModifiedDate":{ - "shape":"Date", - "documentation":"Date when the dataset was last modified." - }, - "LastModifiedBy":{ - "shape":"String", - "documentation":"The device that made the last change to this dataset." - }, - "DataStorage":{ - "shape":"Long", - "documentation":"Total size in bytes of the records in this dataset." - }, - "NumRecords":{ - "shape":"Long", - "documentation":"Number of records in this dataset." - } - }, - "documentation":"A collection of data for an identity pool. An identity pool can have multiple datasets. A dataset is per identity and can be general or associated with a particular entity in an application (like a saved game). Datasets are automatically created if they don't exist. Data is synced by dataset, and a dataset can hold up to 1MB of key-value pairs." - }, - "DatasetList":{ - "type":"list", - "member":{"shape":"Dataset"} - }, - "DatasetName":{ - "type":"string", - "min":1, - "max":128, - "pattern":"[a-zA-Z0-9_.:-]+" - }, - "Date":{"type":"timestamp"}, - "DeleteDatasetRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"A string of up to 128 characters. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (dash), and '.' (dot)." - } - }, - "documentation":"A request to delete the specific dataset." - }, - "DeleteDatasetResponse":{ - "type":"structure", - "members":{ - "Dataset":{ - "shape":"Dataset", - "documentation":"A collection of data for an identity pool. An identity pool can have multiple datasets. A dataset is per identity and can be general or associated with a particular entity in an application (like a saved game). Datasets are automatically created if they don't exist. Data is synced by dataset, and a dataset can hold up to 1MB of key-value pairs." - } - }, - "documentation":"Response to a successful DeleteDataset request." - }, - "DescribeDatasetRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"A string of up to 128 characters. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (dash), and '.' (dot)." - } - }, - "documentation":"A request for meta data about a dataset (creation date, number of records, size) by owner and dataset name." - }, - "DescribeDatasetResponse":{ - "type":"structure", - "members":{ - "Dataset":{ - "shape":"Dataset", - "documentation":"Meta data for a collection of data for an identity. An identity can have multiple datasets. A dataset can be general or associated with a particular entity in an application (like a saved game). Datasets are automatically created if they don't exist. Data is synced by dataset, and a dataset can hold up to 1MB of key-value pairs." - } - }, - "documentation":"Response to a successful DescribeDataset request." - }, - "DescribeIdentityPoolUsageRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - } - }, - "documentation":"A request for usage information about the identity pool." - }, - "DescribeIdentityPoolUsageResponse":{ - "type":"structure", - "members":{ - "IdentityPoolUsage":{ - "shape":"IdentityPoolUsage", - "documentation":"Information about the usage of the identity pool." - } - }, - "documentation":"Response to a successful DescribeIdentityPoolUsage request." - }, - "DescribeIdentityUsageRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - } - }, - "documentation":"A request for information about the usage of an identity pool." - }, - "DescribeIdentityUsageResponse":{ - "type":"structure", - "members":{ - "IdentityUsage":{ - "shape":"IdentityUsage", - "documentation":"Usage information for the identity." - } - }, - "documentation":"The response to a successful DescribeIdentityUsage request." - }, - "DeviceId":{ - "type":"string", - "min":1, - "max":256 - }, - "DuplicateRequestException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"The message associated with the DuplicateRequestException exception." - } - }, - "error":{ - "code":"DuplicateRequest", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"An exception thrown when there is an IN_PROGRESS bulk publish operation for the given identity pool." - }, - "Events":{ - "type":"map", - "key":{"shape":"CognitoEventType"}, - "value":{"shape":"LambdaFunctionArn"}, - "max":1 - }, - "ExceptionMessage":{"type":"string"}, - "GetBulkPublishDetailsRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - } - }, - "documentation":"The input for the GetBulkPublishDetails operation." - }, - "GetBulkPublishDetailsResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "BulkPublishStartTime":{ - "shape":"Date", - "documentation":"The date/time at which the last bulk publish was initiated." - }, - "BulkPublishCompleteTime":{ - "shape":"Date", - "documentation":"If BulkPublishStatus is SUCCEEDED, the time the last bulk publish operation completed." - }, - "BulkPublishStatus":{ - "shape":"BulkPublishStatus", - "documentation":"Status of the last bulk publish operation, valid values are:

NOT_STARTED - No bulk publish has been requested for this identity pool

IN_PROGRESS - Data is being published to the configured stream

SUCCEEDED - All data for the identity pool has been published to the configured stream

FAILED - Some portion of the data has failed to publish, check FailureMessage for the cause.

" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"If BulkPublishStatus is FAILED this field will contain the error message that caused the bulk publish to fail." - } - }, - "documentation":"The output for the GetBulkPublishDetails operation." - }, - "GetCognitoEventsRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

The Cognito Identity Pool ID for the request

" - } - }, - "documentation":"

A request for a list of the configured Cognito Events

" - }, - "GetCognitoEventsResponse":{ - "type":"structure", - "members":{ - "Events":{ - "shape":"Events", - "documentation":"

The Cognito Events returned from the GetCognitoEvents request

" - } - }, - "documentation":"

The response from the GetCognitoEvents request

" - }, - "GetIdentityPoolConfigurationRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. This is the ID of the pool for which to return a configuration.

" - } - }, - "documentation":"

The input for the GetIdentityPoolConfiguration operation.

" - }, - "GetIdentityPoolConfigurationResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito.

" - }, - "PushSync":{ - "shape":"PushSync", - "documentation":"

Options to apply to this identity pool for push synchronization.

" - }, - "CognitoStreams":{ - "shape":"CognitoStreams", - "documentation":"Options to apply to this identity pool for Amazon Cognito streams." - } - }, - "documentation":"

The output for the GetIdentityPoolConfiguration operation.

" - }, - "IdentityId":{ - "type":"string", - "min":1, - "max":55, - "pattern":"[\\w-]+:[0-9a-f-]+" - }, - "IdentityPoolId":{ - "type":"string", - "min":1, - "max":55, - "pattern":"[\\w-]+:[0-9a-f-]+" - }, - "IdentityPoolUsage":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "SyncSessionsCount":{ - "shape":"Long", - "documentation":"Number of sync sessions for the identity pool." - }, - "DataStorage":{ - "shape":"Long", - "documentation":"Data storage information for the identity pool." - }, - "LastModifiedDate":{ - "shape":"Date", - "documentation":"Date on which the identity pool was last modified." - } - }, - "documentation":"Usage information for the identity pool." - }, - "IdentityPoolUsageList":{ - "type":"list", - "member":{"shape":"IdentityPoolUsage"} - }, - "IdentityUsage":{ - "type":"structure", - "members":{ - "IdentityId":{ - "shape":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "LastModifiedDate":{ - "shape":"Date", - "documentation":"Date on which the identity was last modified." - }, - "DatasetCount":{ - "shape":"Integer", - "documentation":"Number of datasets for the identity." - }, - "DataStorage":{ - "shape":"Long", - "documentation":"Total data storage for this identity." - } - }, - "documentation":"Usage information for the identity." - }, - "Integer":{"type":"integer"}, - "IntegerString":{"type":"integer"}, - "InternalErrorException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by InternalErrorException." - } - }, - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true, - "documentation":"Indicates an internal service error." - }, - "InvalidConfigurationException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by InvalidConfigurationException." - } - }, - "error":{ - "code":"InvalidConfiguration", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidLambdaFunctionOutputException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

A message returned when an InvalidLambdaFunctionOutputException occurs

" - } - }, - "error":{ - "code":"InvalidLambdaFunctionOutput", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The AWS Lambda function returned invalid output or an exception.

" - }, - "InvalidParameterException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by InvalidParameterException." - } - }, - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a request parameter does not comply with the associated constraints." - }, - "LambdaFunctionArn":{"type":"string"}, - "LambdaThrottledException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

A message returned when an LambdaThrottledException is thrown

" - } - }, - "error":{ - "code":"LambdaThrottled", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"

AWS Lambda throttled your account, please contact AWS Support

" - }, - "LimitExceededException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by LimitExceededException." - } - }, - "error":{ - "code":"LimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when the limit on the number of objects or operations has been exceeded." - }, - "ListDatasetsRequest":{ - "type":"structure", - "required":[ - "IdentityId", - "IdentityPoolId" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "NextToken":{ - "shape":"String", - "location":"querystring", - "locationName":"nextToken", - "documentation":"A pagination token for obtaining the next page of results." - }, - "MaxResults":{ - "shape":"IntegerString", - "location":"querystring", - "locationName":"maxResults", - "documentation":"The maximum number of results to be returned." - } - }, - "documentation":"Request for a list of datasets for an identity." - }, - "ListDatasetsResponse":{ - "type":"structure", - "members":{ - "Datasets":{ - "shape":"DatasetList", - "documentation":"A set of datasets." - }, - "Count":{ - "shape":"Integer", - "documentation":"Number of datasets returned." - }, - "NextToken":{ - "shape":"String", - "documentation":"A pagination token for obtaining the next page of results." - } - }, - "documentation":"Returned for a successful ListDatasets request." - }, - "ListIdentityPoolUsageRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "location":"querystring", - "locationName":"nextToken", - "documentation":"A pagination token for obtaining the next page of results." - }, - "MaxResults":{ - "shape":"IntegerString", - "location":"querystring", - "locationName":"maxResults", - "documentation":"The maximum number of results to be returned." - } - }, - "documentation":"A request for usage information on an identity pool." - }, - "ListIdentityPoolUsageResponse":{ - "type":"structure", - "members":{ - "IdentityPoolUsages":{ - "shape":"IdentityPoolUsageList", - "documentation":"Usage information for the identity pools." - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"The maximum number of results to be returned." - }, - "Count":{ - "shape":"Integer", - "documentation":"Total number of identities for the identity pool." - }, - "NextToken":{ - "shape":"String", - "documentation":"A pagination token for obtaining the next page of results." - } - }, - "documentation":"Returned for a successful ListIdentityPoolUsage request." - }, - "ListRecordsRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"A string of up to 128 characters. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (dash), and '.' (dot)." - }, - "LastSyncCount":{ - "shape":"Long", - "location":"querystring", - "locationName":"lastSyncCount", - "documentation":"The last server sync count for this record." - }, - "NextToken":{ - "shape":"String", - "location":"querystring", - "locationName":"nextToken", - "documentation":"A pagination token for obtaining the next page of results." - }, - "MaxResults":{ - "shape":"IntegerString", - "location":"querystring", - "locationName":"maxResults", - "documentation":"The maximum number of results to be returned." - }, - "SyncSessionToken":{ - "shape":"SyncSessionToken", - "location":"querystring", - "locationName":"syncSessionToken", - "documentation":"A token containing a session ID, identity ID, and expiration." - } - }, - "documentation":"A request for a list of records." - }, - "ListRecordsResponse":{ - "type":"structure", - "members":{ - "Records":{ - "shape":"RecordList", - "documentation":"A list of all records." - }, - "NextToken":{ - "shape":"String", - "documentation":"A pagination token for obtaining the next page of results." - }, - "Count":{ - "shape":"Integer", - "documentation":"Total number of records." - }, - "DatasetSyncCount":{ - "shape":"Long", - "documentation":"Server sync count for this dataset." - }, - "LastModifiedBy":{ - "shape":"String", - "documentation":"The user/device that made the last change to this record." - }, - "MergedDatasetNames":{ - "shape":"MergedDatasetNameList", - "documentation":"Names of merged datasets." - }, - "DatasetExists":{ - "shape":"Boolean", - "documentation":"Indicates whether the dataset exists." - }, - "DatasetDeletedAfterRequestedSyncCount":{ - "shape":"Boolean", - "documentation":"A boolean value specifying whether to delete the dataset locally." - }, - "SyncSessionToken":{ - "shape":"String", - "documentation":"A token containing a session ID, identity ID, and expiration." - } - }, - "documentation":"Returned for a successful ListRecordsRequest." - }, - "Long":{"type":"long"}, - "MergedDatasetNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "NotAuthorizedException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"The message returned by a NotAuthorizedException." - } - }, - "error":{ - "code":"NotAuthorizedError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown when a user is not authorized to access the requested resource." - }, - "Operation":{ - "type":"string", - "enum":[ - "replace", - "remove" - ] - }, - "Platform":{ - "type":"string", - "enum":[ - "APNS", - "APNS_SANDBOX", - "GCM", - "ADM" - ] - }, - "PushSync":{ - "type":"structure", - "members":{ - "ApplicationArns":{ - "shape":"ApplicationArnList", - "documentation":"

List of SNS platform application ARNs that could be used by clients.

" - }, - "RoleArn":{ - "shape":"AssumeRoleArn", - "documentation":"

A role configured to allow Cognito to call SNS on behalf of the developer.

" - } - }, - "documentation":"

Configuration options to be applied to the identity pool.

" - }, - "PushToken":{"type":"string"}, - "Record":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"RecordKey", - "documentation":"The key for the record." - }, - "Value":{ - "shape":"RecordValue", - "documentation":"The value for the record." - }, - "SyncCount":{ - "shape":"Long", - "documentation":"The server sync count for this record." - }, - "LastModifiedDate":{ - "shape":"Date", - "documentation":"The date on which the record was last modified." - }, - "LastModifiedBy":{ - "shape":"String", - "documentation":"The user/device that made the last change to this record." - }, - "DeviceLastModifiedDate":{ - "shape":"Date", - "documentation":"The last modified date of the client device." - } - }, - "documentation":"The basic data structure of a dataset." - }, - "RecordKey":{ - "type":"string", - "min":1, - "max":1024 - }, - "RecordList":{ - "type":"list", - "member":{"shape":"Record"} - }, - "RecordPatch":{ - "type":"structure", - "required":[ - "Op", - "Key", - "SyncCount" - ], - "members":{ - "Op":{ - "shape":"Operation", - "documentation":"An operation, either replace or remove." - }, - "Key":{ - "shape":"RecordKey", - "documentation":"The key associated with the record patch." - }, - "Value":{ - "shape":"RecordValue", - "documentation":"The value associated with the record patch." - }, - "SyncCount":{ - "shape":"Long", - "documentation":"Last known server sync count for this record. Set to 0 if unknown." - }, - "DeviceLastModifiedDate":{ - "shape":"Date", - "documentation":"The last modified date of the client device." - } - }, - "documentation":"An update operation for a record." - }, - "RecordPatchList":{ - "type":"list", - "member":{"shape":"RecordPatch"} - }, - "RecordValue":{ - "type":"string", - "max":1048575 - }, - "RegisterDeviceRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "Platform", - "Token" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. Here, the ID of the pool that the identity belongs to.

" - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"

The unique ID for this identity.

" - }, - "Platform":{ - "shape":"Platform", - "documentation":"

The SNS platform type (e.g. GCM, SDM, APNS, APNS_SANDBOX).

" - }, - "Token":{ - "shape":"PushToken", - "documentation":"

The push token.

" - } - }, - "documentation":"

A request to RegisterDevice.

" - }, - "RegisterDeviceResponse":{ - "type":"structure", - "members":{ - "DeviceId":{ - "shape":"DeviceId", - "documentation":"

The unique ID generated for this device by Cognito.

" - } - }, - "documentation":"

Response to a RegisterDevice request.

" - }, - "ResourceConflictException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"The message returned by a ResourceConflictException." - } - }, - "error":{ - "code":"ResourceConflict", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if an update can't be applied because the resource was changed by another call and this would result in a conflict." - }, - "ResourceNotFoundException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by a ResourceNotFoundException." - } - }, - "error":{ - "code":"ResourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the resource doesn't exist." - }, - "SetCognitoEventsRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "Events" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

The Cognito Identity Pool to use when configuring Cognito Events

" - }, - "Events":{ - "shape":"Events", - "documentation":"

The events to configure

" - } - }, - "documentation":"

A request to configure Cognito Events\"

\"" - }, - "SetIdentityPoolConfigurationRequest":{ - "type":"structure", - "required":["IdentityPoolId"], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. This is the ID of the pool to modify.

" - }, - "PushSync":{ - "shape":"PushSync", - "documentation":"

Options to apply to this identity pool for push synchronization.

" - }, - "CognitoStreams":{ - "shape":"CognitoStreams", - "documentation":"Options to apply to this identity pool for Amazon Cognito streams." - } - }, - "documentation":"

The input for the SetIdentityPoolConfiguration operation.

" - }, - "SetIdentityPoolConfigurationResponse":{ - "type":"structure", - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito.

" - }, - "PushSync":{ - "shape":"PushSync", - "documentation":"

Options to apply to this identity pool for push synchronization.

" - }, - "CognitoStreams":{ - "shape":"CognitoStreams", - "documentation":"Options to apply to this identity pool for Amazon Cognito streams." - } - }, - "documentation":"

The output for the SetIdentityPoolConfiguration operation

" - }, - "StreamName":{ - "type":"string", - "min":1, - "max":128 - }, - "StreamingStatus":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "String":{"type":"string"}, - "SubscribeToDatasetRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName", - "DeviceId" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. The ID of the pool to which the identity belongs.

" - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"

Unique ID for this identity.

" - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"

The name of the dataset to subcribe to.

" - }, - "DeviceId":{ - "shape":"DeviceId", - "location":"uri", - "locationName":"DeviceId", - "documentation":"

The unique ID generated for this device by Cognito.

" - } - }, - "documentation":"

A request to SubscribeToDatasetRequest.

" - }, - "SubscribeToDatasetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response to a SubscribeToDataset request.

" - }, - "SyncSessionToken":{"type":"string"}, - "TooManyRequestsException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"Message returned by a TooManyRequestsException." - } - }, - "error":{ - "code":"TooManyRequests", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true, - "documentation":"Thrown if the request is throttled." - }, - "UnsubscribeFromDatasetRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName", - "DeviceId" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"

A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. The ID of the pool to which this identity belongs.

" - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"

Unique ID for this identity.

" - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"

The name of the dataset from which to unsubcribe.

" - }, - "DeviceId":{ - "shape":"DeviceId", - "location":"uri", - "locationName":"DeviceId", - "documentation":"

The unique ID generated for this device by Cognito.

" - } - }, - "documentation":"

A request to UnsubscribeFromDataset.

" - }, - "UnsubscribeFromDatasetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Response to an UnsubscribeFromDataset request.

" - }, - "UpdateRecordsRequest":{ - "type":"structure", - "required":[ - "IdentityPoolId", - "IdentityId", - "DatasetName", - "SyncSessionToken" - ], - "members":{ - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "location":"uri", - "locationName":"IdentityPoolId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "IdentityId":{ - "shape":"IdentityId", - "location":"uri", - "locationName":"IdentityId", - "documentation":"A name-spaced GUID (for example, us-east-1:23EC4050-6AEA-7089-A2DD-08002EXAMPLE) created by Amazon Cognito. GUID generation is unique within a region." - }, - "DatasetName":{ - "shape":"DatasetName", - "location":"uri", - "locationName":"DatasetName", - "documentation":"A string of up to 128 characters. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (dash), and '.' (dot)." - }, - "DeviceId":{ - "shape":"DeviceId", - "documentation":"

The unique ID generated for this device by Cognito.

" - }, - "RecordPatches":{ - "shape":"RecordPatchList", - "documentation":"A list of patch operations." - }, - "SyncSessionToken":{ - "shape":"SyncSessionToken", - "documentation":"The SyncSessionToken returned by a previous call to ListRecords for this dataset and identity." - }, - "ClientContext":{ - "shape":"ClientContext", - "location":"header", - "locationName":"x-amz-Client-Context", - "documentation":"Intended to supply a device ID that will populate the lastModifiedBy field referenced in other methods. The ClientContext field is not yet implemented." - } - }, - "documentation":"A request to post updates to records or add and delete records for a dataset and user." - }, - "UpdateRecordsResponse":{ - "type":"structure", - "members":{ - "Records":{ - "shape":"RecordList", - "documentation":"A list of records that have been updated." - } - }, - "documentation":"Returned for a successful UpdateRecordsRequest." - } - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/paginators-1.json deleted file mode 100644 index 2d021747..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "ListTopicsDetectionJobs": { - "result_key": "TopicsDetectionJobPropertiesList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/service-2.json deleted file mode 100644 index a31b9459..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/comprehend/2017-11-27/service-2.json +++ /dev/null @@ -1,2165 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-11-27", - "endpointPrefix":"comprehend", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Comprehend", - "serviceId":"Comprehend", - "signatureVersion":"v4", - "signingName":"comprehend", - "targetPrefix":"Comprehend_20171127", - "uid":"comprehend-2017-11-27" - }, - "operations":{ - "BatchDetectDominantLanguage":{ - "name":"BatchDetectDominantLanguage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDetectDominantLanguageRequest"}, - "output":{"shape":"BatchDetectDominantLanguageResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"BatchSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Determines the dominant language of the input text for a batch of documents. For a list of languages that Amazon Comprehend can detect, see Amazon Comprehend Supported Languages.

" - }, - "BatchDetectEntities":{ - "name":"BatchDetectEntities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDetectEntitiesRequest"}, - "output":{"shape":"BatchDetectEntitiesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"BatchSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects the text of a batch of documents for named entities and returns information about them. For more information about named entities, see how-entities

" - }, - "BatchDetectKeyPhrases":{ - "name":"BatchDetectKeyPhrases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDetectKeyPhrasesRequest"}, - "output":{"shape":"BatchDetectKeyPhrasesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"BatchSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Detects the key noun phrases found in a batch of documents.

" - }, - "BatchDetectSentiment":{ - "name":"BatchDetectSentiment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDetectSentimentRequest"}, - "output":{"shape":"BatchDetectSentimentResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"BatchSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects a batch of documents and returns an inference of the prevailing sentiment, POSITIVE, NEUTRAL, MIXED, or NEGATIVE, in each one.

" - }, - "BatchDetectSyntax":{ - "name":"BatchDetectSyntax", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDetectSyntaxRequest"}, - "output":{"shape":"BatchDetectSyntaxResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"BatchSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects the text of a batch of documents for the syntax and part of speech of the words in the document and returns information about them. For more information, see how-syntax.

" - }, - "DescribeDominantLanguageDetectionJob":{ - "name":"DescribeDominantLanguageDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDominantLanguageDetectionJobRequest"}, - "output":{"shape":"DescribeDominantLanguageDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets the properties associated with a dominant language detection job. Use this operation to get the status of a detection job.

" - }, - "DescribeEntitiesDetectionJob":{ - "name":"DescribeEntitiesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEntitiesDetectionJobRequest"}, - "output":{"shape":"DescribeEntitiesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets the properties associated with an entities detection job. Use this operation to get the status of a detection job.

" - }, - "DescribeKeyPhrasesDetectionJob":{ - "name":"DescribeKeyPhrasesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPhrasesDetectionJobRequest"}, - "output":{"shape":"DescribeKeyPhrasesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets the properties associated with a key phrases detection job. Use this operation to get the status of a detection job.

" - }, - "DescribeSentimentDetectionJob":{ - "name":"DescribeSentimentDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSentimentDetectionJobRequest"}, - "output":{"shape":"DescribeSentimentDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets the properties associated with a sentiment detection job. Use this operation to get the status of a detection job.

" - }, - "DescribeTopicsDetectionJob":{ - "name":"DescribeTopicsDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTopicsDetectionJobRequest"}, - "output":{"shape":"DescribeTopicsDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets the properties associated with a topic detection job. Use this operation to get the status of a detection job.

" - }, - "DetectDominantLanguage":{ - "name":"DetectDominantLanguage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectDominantLanguageRequest"}, - "output":{"shape":"DetectDominantLanguageResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Determines the dominant language of the input text. For a list of languages that Amazon Comprehend can detect, see Amazon Comprehend Supported Languages.

" - }, - "DetectEntities":{ - "name":"DetectEntities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectEntitiesRequest"}, - "output":{"shape":"DetectEntitiesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects text for named entities, and returns information about them. For more information, about named entities, see how-entities.

" - }, - "DetectKeyPhrases":{ - "name":"DetectKeyPhrases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectKeyPhrasesRequest"}, - "output":{"shape":"DetectKeyPhrasesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Detects the key noun phrases found in the text.

" - }, - "DetectSentiment":{ - "name":"DetectSentiment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectSentimentRequest"}, - "output":{"shape":"DetectSentimentResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects text and returns an inference of the prevailing sentiment (POSITIVE, NEUTRAL, MIXED, or NEGATIVE).

" - }, - "DetectSyntax":{ - "name":"DetectSyntax", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectSyntaxRequest"}, - "output":{"shape":"DetectSyntaxResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"UnsupportedLanguageException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Inspects text for syntax and the part of speech of words in the document. For more information, how-syntax.

" - }, - "ListDominantLanguageDetectionJobs":{ - "name":"ListDominantLanguageDetectionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDominantLanguageDetectionJobsRequest"}, - "output":{"shape":"ListDominantLanguageDetectionJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidFilterException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets a list of the dominant language detection jobs that you have submitted.

" - }, - "ListEntitiesDetectionJobs":{ - "name":"ListEntitiesDetectionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEntitiesDetectionJobsRequest"}, - "output":{"shape":"ListEntitiesDetectionJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidFilterException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets a list of the entity detection jobs that you have submitted.

" - }, - "ListKeyPhrasesDetectionJobs":{ - "name":"ListKeyPhrasesDetectionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListKeyPhrasesDetectionJobsRequest"}, - "output":{"shape":"ListKeyPhrasesDetectionJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidFilterException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Get a list of key phrase detection jobs that you have submitted.

" - }, - "ListSentimentDetectionJobs":{ - "name":"ListSentimentDetectionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSentimentDetectionJobsRequest"}, - "output":{"shape":"ListSentimentDetectionJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidFilterException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets a list of sentiment detection jobs that you have submitted.

" - }, - "ListTopicsDetectionJobs":{ - "name":"ListTopicsDetectionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTopicsDetectionJobsRequest"}, - "output":{"shape":"ListTopicsDetectionJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidFilterException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Gets a list of the topic detection jobs that you have submitted.

" - }, - "StartDominantLanguageDetectionJob":{ - "name":"StartDominantLanguageDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartDominantLanguageDetectionJobRequest"}, - "output":{"shape":"StartDominantLanguageDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Starts an asynchronous dominant language detection job for a collection of documents. Use the operation to track the status of a job.

" - }, - "StartEntitiesDetectionJob":{ - "name":"StartEntitiesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartEntitiesDetectionJobRequest"}, - "output":{"shape":"StartEntitiesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Starts an asynchronous entity detection job for a collection of documents. Use the operation to track the status of a job.

" - }, - "StartKeyPhrasesDetectionJob":{ - "name":"StartKeyPhrasesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartKeyPhrasesDetectionJobRequest"}, - "output":{"shape":"StartKeyPhrasesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Starts an asynchronous key phrase detection job for a collection of documents. Use the operation to track the status of a job.

" - }, - "StartSentimentDetectionJob":{ - "name":"StartSentimentDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartSentimentDetectionJobRequest"}, - "output":{"shape":"StartSentimentDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Starts an asynchronous sentiment detection job for a collection of documents. use the operation to track the status of a job.

" - }, - "StartTopicsDetectionJob":{ - "name":"StartTopicsDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartTopicsDetectionJobRequest"}, - "output":{"shape":"StartTopicsDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Starts an asynchronous topic detection job. Use the DescribeTopicDetectionJob operation to track the status of a job.

" - }, - "StopDominantLanguageDetectionJob":{ - "name":"StopDominantLanguageDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopDominantLanguageDetectionJobRequest"}, - "output":{"shape":"StopDominantLanguageDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Stops a dominant language detection job in progress.

If the job state is IN_PROGRESS the job is marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state; otherwise the job is stopped and put into the STOPPED state.

If the job is in the COMPLETED or FAILED state when you call the StopDominantLanguageDetectionJob operation, the operation returns a 400 Internal Request Exception.

When a job is stopped, any documents already processed are written to the output location.

" - }, - "StopEntitiesDetectionJob":{ - "name":"StopEntitiesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopEntitiesDetectionJobRequest"}, - "output":{"shape":"StopEntitiesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Stops an entities detection job in progress.

If the job state is IN_PROGRESS the job is marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state; otherwise the job is stopped and put into the STOPPED state.

If the job is in the COMPLETED or FAILED state when you call the StopDominantLanguageDetectionJob operation, the operation returns a 400 Internal Request Exception.

When a job is stopped, any documents already processed are written to the output location.

" - }, - "StopKeyPhrasesDetectionJob":{ - "name":"StopKeyPhrasesDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopKeyPhrasesDetectionJobRequest"}, - "output":{"shape":"StopKeyPhrasesDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Stops a key phrases detection job in progress.

If the job state is IN_PROGRESS the job is marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state; otherwise the job is stopped and put into the STOPPED state.

If the job is in the COMPLETED or FAILED state when you call the StopDominantLanguageDetectionJob operation, the operation returns a 400 Internal Request Exception.

When a job is stopped, any documents already processed are written to the output location.

" - }, - "StopSentimentDetectionJob":{ - "name":"StopSentimentDetectionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopSentimentDetectionJobRequest"}, - "output":{"shape":"StopSentimentDetectionJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"JobNotFoundException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Stops a sentiment detection job in progress.

If the job state is IN_PROGRESS the job is marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state; otherwise the job is be stopped and put into the STOPPED state.

If the job is in the COMPLETED or FAILED state when you call the StopDominantLanguageDetectionJob operation, the operation returns a 400 Internal Request Exception.

When a job is stopped, any documents already processed are written to the output location.

" - } - }, - "shapes":{ - "AnyLengthString":{"type":"string"}, - "BatchDetectDominantLanguageItemResult":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "Languages":{ - "shape":"ListOfDominantLanguages", - "documentation":"

One or more DominantLanguage objects describing the dominant languages in the document.

" - } - }, - "documentation":"

The result of calling the operation. The operation returns one object for each document that is successfully processed by the operation.

" - }, - "BatchDetectDominantLanguageRequest":{ - "type":"structure", - "required":["TextList"], - "members":{ - "TextList":{ - "shape":"StringList", - "documentation":"

A list containing the text of the input documents. The list can contain a maximum of 25 documents. Each document should contain at least 20 characters and must contain fewer than 5,000 bytes of UTF-8 encoded characters.

" - } - } - }, - "BatchDetectDominantLanguageResponse":{ - "type":"structure", - "required":[ - "ResultList", - "ErrorList" - ], - "members":{ - "ResultList":{ - "shape":"ListOfDetectDominantLanguageResult", - "documentation":"

A list of objects containing the results of the operation. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If all of the documents contain an error, the ResultList is empty.

" - }, - "ErrorList":{ - "shape":"BatchItemErrorList", - "documentation":"

A list containing one object for each document that contained an error. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If there are no errors in the batch, the ErrorList is empty.

" - } - } - }, - "BatchDetectEntitiesItemResult":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "Entities":{ - "shape":"ListOfEntities", - "documentation":"

One or more Entity objects, one for each entity detected in the document.

" - } - }, - "documentation":"

The result of calling the operation. The operation returns one object for each document that is successfully processed by the operation.

" - }, - "BatchDetectEntitiesRequest":{ - "type":"structure", - "required":[ - "TextList", - "LanguageCode" - ], - "members":{ - "TextList":{ - "shape":"StringList", - "documentation":"

A list containing the text of the input documents. The list can contain a maximum of 25 documents. Each document must contain fewer than 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "BatchDetectEntitiesResponse":{ - "type":"structure", - "required":[ - "ResultList", - "ErrorList" - ], - "members":{ - "ResultList":{ - "shape":"ListOfDetectEntitiesResult", - "documentation":"

A list of objects containing the results of the operation. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If all of the documents contain an error, the ResultList is empty.

" - }, - "ErrorList":{ - "shape":"BatchItemErrorList", - "documentation":"

A list containing one object for each document that contained an error. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If there are no errors in the batch, the ErrorList is empty.

" - } - } - }, - "BatchDetectKeyPhrasesItemResult":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "KeyPhrases":{ - "shape":"ListOfKeyPhrases", - "documentation":"

One or more KeyPhrase objects, one for each key phrase detected in the document.

" - } - }, - "documentation":"

The result of calling the operation. The operation returns one object for each document that is successfully processed by the operation.

" - }, - "BatchDetectKeyPhrasesRequest":{ - "type":"structure", - "required":[ - "TextList", - "LanguageCode" - ], - "members":{ - "TextList":{ - "shape":"StringList", - "documentation":"

A list containing the text of the input documents. The list can contain a maximum of 25 documents. Each document must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "BatchDetectKeyPhrasesResponse":{ - "type":"structure", - "required":[ - "ResultList", - "ErrorList" - ], - "members":{ - "ResultList":{ - "shape":"ListOfDetectKeyPhrasesResult", - "documentation":"

A list of objects containing the results of the operation. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If all of the documents contain an error, the ResultList is empty.

" - }, - "ErrorList":{ - "shape":"BatchItemErrorList", - "documentation":"

A list containing one object for each document that contained an error. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If there are no errors in the batch, the ErrorList is empty.

" - } - } - }, - "BatchDetectSentimentItemResult":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "Sentiment":{ - "shape":"SentimentType", - "documentation":"

The sentiment detected in the document.

" - }, - "SentimentScore":{ - "shape":"SentimentScore", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of its sentiment detection.

" - } - }, - "documentation":"

The result of calling the operation. The operation returns one object for each document that is successfully processed by the operation.

" - }, - "BatchDetectSentimentRequest":{ - "type":"structure", - "required":[ - "TextList", - "LanguageCode" - ], - "members":{ - "TextList":{ - "shape":"StringList", - "documentation":"

A list containing the text of the input documents. The list can contain a maximum of 25 documents. Each document must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "BatchDetectSentimentResponse":{ - "type":"structure", - "required":[ - "ResultList", - "ErrorList" - ], - "members":{ - "ResultList":{ - "shape":"ListOfDetectSentimentResult", - "documentation":"

A list of objects containing the results of the operation. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If all of the documents contain an error, the ResultList is empty.

" - }, - "ErrorList":{ - "shape":"BatchItemErrorList", - "documentation":"

A list containing one object for each document that contained an error. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If there are no errors in the batch, the ErrorList is empty.

" - } - } - }, - "BatchDetectSyntaxItemResult":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "SyntaxTokens":{ - "shape":"ListOfSyntaxTokens", - "documentation":"

The syntax tokens for the words in the document, one token for each word.

" - } - }, - "documentation":"

The result of calling the operation. The operation returns one object that is successfully processed by the operation.

" - }, - "BatchDetectSyntaxRequest":{ - "type":"structure", - "required":[ - "TextList", - "LanguageCode" - ], - "members":{ - "TextList":{ - "shape":"StringList", - "documentation":"

A list containing the text of the input documents. The list can contain a maximum of 25 documents. Each document must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"SyntaxLanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "BatchDetectSyntaxResponse":{ - "type":"structure", - "required":[ - "ResultList", - "ErrorList" - ], - "members":{ - "ResultList":{ - "shape":"ListOfDetectSyntaxResult", - "documentation":"

A list of objects containing the results of the operation. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If all of the documents contain an error, the ResultList is empty.

" - }, - "ErrorList":{ - "shape":"BatchItemErrorList", - "documentation":"

A list containing one object for each document that contained an error. The results are sorted in ascending order by the Index field and match the order of the documents in the input list. If there are no errors in the batch, the ErrorList is empty.

" - } - } - }, - "BatchItemError":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"Integer", - "documentation":"

The zero-based index of the document in the input list.

" - }, - "ErrorCode":{ - "shape":"String", - "documentation":"

The numeric error code of the error.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

A text description of the error.

" - } - }, - "documentation":"

Describes an error that occurred while processing a document in a batch. The operation returns on BatchItemError object for each document that contained an error.

" - }, - "BatchItemErrorList":{ - "type":"list", - "member":{"shape":"BatchItemError"} - }, - "BatchSizeLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The number of documents in the request exceeds the limit of 25. Try your request again with fewer documents.

", - "exception":true - }, - "ClientRequestTokenString":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9-]+$" - }, - "DescribeDominantLanguageDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier that Amazon Comprehend generated for the job. The operation returns this identifier in its response.

" - } - } - }, - "DescribeDominantLanguageDetectionJobResponse":{ - "type":"structure", - "members":{ - "DominantLanguageDetectionJobProperties":{ - "shape":"DominantLanguageDetectionJobProperties", - "documentation":"

An object that contains the properties associated with a dominant language detection job.

" - } - } - }, - "DescribeEntitiesDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier that Amazon Comprehend generated for the job. The operation returns this identifier in its response.

" - } - } - }, - "DescribeEntitiesDetectionJobResponse":{ - "type":"structure", - "members":{ - "EntitiesDetectionJobProperties":{ - "shape":"EntitiesDetectionJobProperties", - "documentation":"

An object that contains the properties associated with an entities detection job.

" - } - } - }, - "DescribeKeyPhrasesDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier that Amazon Comprehend generated for the job. The operation returns this identifier in its response.

" - } - } - }, - "DescribeKeyPhrasesDetectionJobResponse":{ - "type":"structure", - "members":{ - "KeyPhrasesDetectionJobProperties":{ - "shape":"KeyPhrasesDetectionJobProperties", - "documentation":"

An object that contains the properties associated with a key phrases detection job.

" - } - } - }, - "DescribeSentimentDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier that Amazon Comprehend generated for the job. The operation returns this identifier in its response.

" - } - } - }, - "DescribeSentimentDetectionJobResponse":{ - "type":"structure", - "members":{ - "SentimentDetectionJobProperties":{ - "shape":"SentimentDetectionJobProperties", - "documentation":"

An object that contains the properties associated with a sentiment detection job.

" - } - } - }, - "DescribeTopicsDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned by the user to the detection job.

" - } - } - }, - "DescribeTopicsDetectionJobResponse":{ - "type":"structure", - "members":{ - "TopicsDetectionJobProperties":{ - "shape":"TopicsDetectionJobProperties", - "documentation":"

The list of properties for the requested job.

" - } - } - }, - "DetectDominantLanguageRequest":{ - "type":"structure", - "required":["Text"], - "members":{ - "Text":{ - "shape":"String", - "documentation":"

A UTF-8 text string. Each string should contain at least 20 characters and must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - } - } - }, - "DetectDominantLanguageResponse":{ - "type":"structure", - "members":{ - "Languages":{ - "shape":"ListOfDominantLanguages", - "documentation":"

The languages that Amazon Comprehend detected in the input text. For each language, the response returns the RFC 5646 language code and the level of confidence that Amazon Comprehend has in the accuracy of its inference. For more information about RFC 5646, see Tags for Identifying Languages on the IETF Tools web site.

" - } - } - }, - "DetectEntitiesRequest":{ - "type":"structure", - "required":[ - "Text", - "LanguageCode" - ], - "members":{ - "Text":{ - "shape":"String", - "documentation":"

A UTF-8 text string. Each string must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "DetectEntitiesResponse":{ - "type":"structure", - "members":{ - "Entities":{ - "shape":"ListOfEntities", - "documentation":"

A collection of entities identified in the input text. For each entity, the response provides the entity text, entity type, where the entity text begins and ends, and the level of confidence that Amazon Comprehend has in the detection. For a list of entity types, see how-entities.

" - } - } - }, - "DetectKeyPhrasesRequest":{ - "type":"structure", - "required":[ - "Text", - "LanguageCode" - ], - "members":{ - "Text":{ - "shape":"String", - "documentation":"

A UTF-8 text string. Each string must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "DetectKeyPhrasesResponse":{ - "type":"structure", - "members":{ - "KeyPhrases":{ - "shape":"ListOfKeyPhrases", - "documentation":"

A collection of key phrases that Amazon Comprehend identified in the input text. For each key phrase, the response provides the text of the key phrase, where the key phrase begins and ends, and the level of confidence that Amazon Comprehend has in the accuracy of the detection.

" - } - } - }, - "DetectSentimentRequest":{ - "type":"structure", - "required":[ - "Text", - "LanguageCode" - ], - "members":{ - "Text":{ - "shape":"String", - "documentation":"

A UTF-8 text string. Each string must contain fewer that 5,000 bytes of UTF-8 encoded characters.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - } - } - }, - "DetectSentimentResponse":{ - "type":"structure", - "members":{ - "Sentiment":{ - "shape":"SentimentType", - "documentation":"

The inferred sentiment that Amazon Comprehend has the highest level of confidence in.

" - }, - "SentimentScore":{ - "shape":"SentimentScore", - "documentation":"

An object that lists the sentiments, and their corresponding confidence levels.

" - } - } - }, - "DetectSyntaxRequest":{ - "type":"structure", - "required":[ - "Text", - "LanguageCode" - ], - "members":{ - "Text":{ - "shape":"String", - "documentation":"

A UTF-8 string. Each string must contain fewer that 5,000 bytes of UTF encoded characters.

" - }, - "LanguageCode":{ - "shape":"SyntaxLanguageCode", - "documentation":"

The language code of the input documents. You can specify English (\"en\") or Spanish (\"es\").

" - } - } - }, - "DetectSyntaxResponse":{ - "type":"structure", - "members":{ - "SyntaxTokens":{ - "shape":"ListOfSyntaxTokens", - "documentation":"

A collection of syntax tokens describing the text. For each token, the response provides the text, the token type, where the text begins and ends, and the level of confidence that Amazon Comprehend has that the token is correct. For a list of token types, see how-syntax.

" - } - } - }, - "DominantLanguage":{ - "type":"structure", - "members":{ - "LanguageCode":{ - "shape":"String", - "documentation":"

The RFC 5646 language code for the dominant language. For more information about RFC 5646, see Tags for Identifying Languages on the IETF Tools web site.

" - }, - "Score":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of the detection.

" - } - }, - "documentation":"

Returns the code for the dominant language in the input text and the level of confidence that Amazon Comprehend has in the accuracy of the detection.

" - }, - "DominantLanguageDetectionJobFilter":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

Filters on the name of the job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Filters the list of jobs based on job status. Returns only jobs with the specified status.

" - }, - "SubmitTimeBefore":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted before the specified time. Jobs are returned in ascending order, oldest to newest.

" - }, - "SubmitTimeAfter":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted after the specified time. Jobs are returned in descending order, newest to oldest.

" - } - }, - "documentation":"

Provides information for filtering a list of dominant language detection jobs. For more information, see the operation.

" - }, - "DominantLanguageDetectionJobProperties":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned to the dominant language detection job.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The name that you assigned to the dominant language detection job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The current status of the dominant language detection job. If the status is FAILED, the Message field shows the reason for the failure.

" - }, - "Message":{ - "shape":"AnyLengthString", - "documentation":"

A description for the status of a job.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The time that the dominant language detection job was submitted for processing.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time that the dominant language detection job completed.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

The input data configuration that you supplied when you created the dominant language detection job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The output data configuration that you supplied when you created the dominant language detection job.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) that gives Amazon Comprehend read access to your input data.

" - } - }, - "documentation":"

Provides information about a dominant language detection job.

" - }, - "DominantLanguageDetectionJobPropertiesList":{ - "type":"list", - "member":{"shape":"DominantLanguageDetectionJobProperties"} - }, - "EntitiesDetectionJobFilter":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

Filters on the name of the job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Filters the list of jobs based on job status. Returns only jobs with the specified status.

" - }, - "SubmitTimeBefore":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted before the specified time. Jobs are returned in ascending order, oldest to newest.

" - }, - "SubmitTimeAfter":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted after the specified time. Jobs are returned in descending order, newest to oldest.

" - } - }, - "documentation":"

Provides information for filtering a list of dominant language detection jobs. For more information, see the operation.

" - }, - "EntitiesDetectionJobProperties":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned to the entities detection job.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The name that you assigned the entities detection job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The current status of the entities detection job. If the status is FAILED, the Message field shows the reason for the failure.

" - }, - "Message":{ - "shape":"AnyLengthString", - "documentation":"

A description of the status of a job.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The time that the entities detection job was submitted for processing.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time that the entities detection job completed

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

The input data configuration that you supplied when you created the entities detection job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The output data configuration that you supplied when you created the entities detection job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the input documents.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) that gives Amazon Comprehend read access to your input data.

" - } - }, - "documentation":"

Provides information about an entities detection job.

" - }, - "EntitiesDetectionJobPropertiesList":{ - "type":"list", - "member":{"shape":"EntitiesDetectionJobProperties"} - }, - "Entity":{ - "type":"structure", - "members":{ - "Score":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of the detection.

" - }, - "Type":{ - "shape":"EntityType", - "documentation":"

The entity's type.

" - }, - "Text":{ - "shape":"String", - "documentation":"

The text of the entity.

" - }, - "BeginOffset":{ - "shape":"Integer", - "documentation":"

A character offset in the input text that shows where the entity begins (the first character is at position 0). The offset returns the position of each UTF-8 code point in the string. A code point is the abstract character from a particular graphical representation. For example, a multi-byte UTF-8 character maps to a single code point.

" - }, - "EndOffset":{ - "shape":"Integer", - "documentation":"

A character offset in the input text that shows where the entity ends. The offset returns the position of each UTF-8 code point in the string. A code point is the abstract character from a particular graphical representation. For example, a multi-byte UTF-8 character maps to a single code point.

" - } - }, - "documentation":"

Provides information about an entity.

" - }, - "EntityType":{ - "type":"string", - "enum":[ - "PERSON", - "LOCATION", - "ORGANIZATION", - "COMMERCIAL_ITEM", - "EVENT", - "DATE", - "QUANTITY", - "TITLE", - "OTHER" - ] - }, - "Float":{"type":"float"}, - "IamRoleArn":{ - "type":"string", - "pattern":"arn:aws(-[^:]+)?:iam::[0-9]{12}:role/.+" - }, - "InputDataConfig":{ - "type":"structure", - "required":["S3Uri"], - "members":{ - "S3Uri":{ - "shape":"S3Uri", - "documentation":"

The Amazon S3 URI for the input data. The URI must be in same region as the API endpoint that you are calling. The URI can point to a single input file or it can provide the prefix for a collection of data files.

For example, if you use the URI S3://bucketName/prefix, if the prefix is a single file, Amazon Comprehend uses that file as input. If more than one file begins with the prefix, Amazon Comprehend uses all of them as input.

" - }, - "InputFormat":{ - "shape":"InputFormat", - "documentation":"

Specifies how the text in an input file should be processed:

  • ONE_DOC_PER_FILE - Each file is considered a separate document. Use this option when you are processing large documents, such as newspaper articles or scientific papers.

  • ONE_DOC_PER_LINE - Each line in a file is considered a separate document. Use this option when you are processing many short documents, such as text messages.

" - } - }, - "documentation":"

The input properties for a topic detection job.

" - }, - "InputFormat":{ - "type":"string", - "enum":[ - "ONE_DOC_PER_FILE", - "ONE_DOC_PER_LINE" - ] - }, - "Integer":{"type":"integer"}, - "InternalServerException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An internal server error occurred. Retry your request.

", - "exception":true, - "fault":true - }, - "InvalidFilterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The filter specified for the ListTopicDetectionJobs operation is invalid. Specify a different filter.

", - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The request is invalid.

", - "exception":true - }, - "JobId":{ - "type":"string", - "max":32, - "min":1 - }, - "JobName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-%@]*)$" - }, - "JobNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified job was not found. Check the job ID and try again.

", - "exception":true - }, - "JobStatus":{ - "type":"string", - "enum":[ - "SUBMITTED", - "IN_PROGRESS", - "COMPLETED", - "FAILED", - "STOP_REQUESTED", - "STOPPED" - ] - }, - "KeyPhrase":{ - "type":"structure", - "members":{ - "Score":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of the detection.

" - }, - "Text":{ - "shape":"String", - "documentation":"

The text of a key noun phrase.

" - }, - "BeginOffset":{ - "shape":"Integer", - "documentation":"

A character offset in the input text that shows where the key phrase begins (the first character is at position 0). The offset returns the position of each UTF-8 code point in the string. A code point is the abstract character from a particular graphical representation. For example, a multi-byte UTF-8 character maps to a single code point.

" - }, - "EndOffset":{ - "shape":"Integer", - "documentation":"

A character offset in the input text where the key phrase ends. The offset returns the position of each UTF-8 code point in the string. A code point is the abstract character from a particular graphical representation. For example, a multi-byte UTF-8 character maps to a single code point.

" - } - }, - "documentation":"

Describes a key noun phrase.

" - }, - "KeyPhrasesDetectionJobFilter":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

Filters on the name of the job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Filters the list of jobs based on job status. Returns only jobs with the specified status.

" - }, - "SubmitTimeBefore":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted before the specified time. Jobs are returned in ascending order, oldest to newest.

" - }, - "SubmitTimeAfter":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted after the specified time. Jobs are returned in descending order, newest to oldest.

" - } - }, - "documentation":"

Provides information for filtering a list of dominant language detection jobs. For more information, see the operation.

" - }, - "KeyPhrasesDetectionJobProperties":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned to the key phrases detection job.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The name that you assigned the key phrases detection job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The current status of the key phrases detection job. If the status is FAILED, the Message field shows the reason for the failure.

" - }, - "Message":{ - "shape":"AnyLengthString", - "documentation":"

A description of the status of a job.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The time that the key phrases detection job was submitted for processing.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time that the key phrases detection job completed.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

The input data configuration that you supplied when you created the key phrases detection job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The output data configuration that you supplied when you created the key phrases detection job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the input documents.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) that gives Amazon Comprehend read access to your input data.

" - } - }, - "documentation":"

Provides information about a key phrases detection job.

" - }, - "KeyPhrasesDetectionJobPropertiesList":{ - "type":"list", - "member":{"shape":"KeyPhrasesDetectionJobProperties"} - }, - "LanguageCode":{ - "type":"string", - "enum":[ - "en", - "es" - ] - }, - "ListDominantLanguageDetectionJobsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"DominantLanguageDetectionJobFilter", - "documentation":"

Filters that jobs that are returned. You can filter jobs on their name, status, or the date and time that they were submitted. You can only set one filter at a time.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - }, - "MaxResults":{ - "shape":"MaxResultsInteger", - "documentation":"

The maximum number of results to return in each page. The default is 100.

" - } - } - }, - "ListDominantLanguageDetectionJobsResponse":{ - "type":"structure", - "members":{ - "DominantLanguageDetectionJobPropertiesList":{ - "shape":"DominantLanguageDetectionJobPropertiesList", - "documentation":"

A list containing the properties of each job that is returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - } - } - }, - "ListEntitiesDetectionJobsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"EntitiesDetectionJobFilter", - "documentation":"

Filters the jobs that are returned. You can filter jobs on their name, status, or the date and time that they were submitted. You can only set one filter at a time.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - }, - "MaxResults":{ - "shape":"MaxResultsInteger", - "documentation":"

The maximum number of results to return in each page. The default is 100.

" - } - } - }, - "ListEntitiesDetectionJobsResponse":{ - "type":"structure", - "members":{ - "EntitiesDetectionJobPropertiesList":{ - "shape":"EntitiesDetectionJobPropertiesList", - "documentation":"

A list containing the properties of each job that is returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - } - } - }, - "ListKeyPhrasesDetectionJobsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"KeyPhrasesDetectionJobFilter", - "documentation":"

Filters the jobs that are returned. You can filter jobs on their name, status, or the date and time that they were submitted. You can only set one filter at a time.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - }, - "MaxResults":{ - "shape":"MaxResultsInteger", - "documentation":"

The maximum number of results to return in each page. The default is 100.

" - } - } - }, - "ListKeyPhrasesDetectionJobsResponse":{ - "type":"structure", - "members":{ - "KeyPhrasesDetectionJobPropertiesList":{ - "shape":"KeyPhrasesDetectionJobPropertiesList", - "documentation":"

A list containing the properties of each job that is returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - } - } - }, - "ListOfDetectDominantLanguageResult":{ - "type":"list", - "member":{"shape":"BatchDetectDominantLanguageItemResult"} - }, - "ListOfDetectEntitiesResult":{ - "type":"list", - "member":{"shape":"BatchDetectEntitiesItemResult"} - }, - "ListOfDetectKeyPhrasesResult":{ - "type":"list", - "member":{"shape":"BatchDetectKeyPhrasesItemResult"} - }, - "ListOfDetectSentimentResult":{ - "type":"list", - "member":{"shape":"BatchDetectSentimentItemResult"} - }, - "ListOfDetectSyntaxResult":{ - "type":"list", - "member":{"shape":"BatchDetectSyntaxItemResult"} - }, - "ListOfDominantLanguages":{ - "type":"list", - "member":{"shape":"DominantLanguage"} - }, - "ListOfEntities":{ - "type":"list", - "member":{"shape":"Entity"} - }, - "ListOfKeyPhrases":{ - "type":"list", - "member":{"shape":"KeyPhrase"} - }, - "ListOfSyntaxTokens":{ - "type":"list", - "member":{"shape":"SyntaxToken"} - }, - "ListSentimentDetectionJobsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"SentimentDetectionJobFilter", - "documentation":"

Filters the jobs that are returned. You can filter jobs on their name, status, or the date and time that they were submitted. You can only set one filter at a time.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - }, - "MaxResults":{ - "shape":"MaxResultsInteger", - "documentation":"

The maximum number of results to return in each page. The default is 100.

" - } - } - }, - "ListSentimentDetectionJobsResponse":{ - "type":"structure", - "members":{ - "SentimentDetectionJobPropertiesList":{ - "shape":"SentimentDetectionJobPropertiesList", - "documentation":"

A list containing the properties of each job that is returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - } - } - }, - "ListTopicsDetectionJobsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"TopicsDetectionJobFilter", - "documentation":"

Filters the jobs that are returned. Jobs can be filtered on their name, status, or the date and time that they were submitted. You can set only one filter at a time.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - }, - "MaxResults":{ - "shape":"MaxResultsInteger", - "documentation":"

The maximum number of results to return in each page. The default is 100.

" - } - } - }, - "ListTopicsDetectionJobsResponse":{ - "type":"structure", - "members":{ - "TopicsDetectionJobPropertiesList":{ - "shape":"TopicsDetectionJobPropertiesList", - "documentation":"

A list containing the properties of each job that is returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Identifies the next page of results to return.

" - } - } - }, - "MaxResultsInteger":{ - "type":"integer", - "max":500, - "min":1 - }, - "NumberOfTopicsInteger":{ - "type":"integer", - "max":100, - "min":1 - }, - "OutputDataConfig":{ - "type":"structure", - "required":["S3Uri"], - "members":{ - "S3Uri":{ - "shape":"S3Uri", - "documentation":"

When you use the OutputDataConfig object with asynchronous operations, you specify the Amazon S3 location where you want to write the output data. The URI must be in the same region as the API endpoint that you are calling. The location is used as the prefix for the actual location of the output file.

When the topic detection job is finished, the service creates an output file in a directory specific to the job. The S3Uri field contains the location of the output file, called output.tar.gz. It is a compressed archive that contains the ouput of the operation.

" - } - }, - "documentation":"

Provides configuration parameters for the output of topic detection jobs.

" - }, - "PartOfSpeechTag":{ - "type":"structure", - "members":{ - "Tag":{ - "shape":"PartOfSpeechTagType", - "documentation":"

Identifies the part of speech that the token represents.

" - }, - "Score":{ - "shape":"Float", - "documentation":"

The confidence that Amazon Comprehend has that the part of speech was correctly identified.

" - } - }, - "documentation":"

Identifies the part of speech represented by the token and gives the confidence that Amazon Comprehend has that the part of speech was correctly identified. For more information about the parts of speech that Amazon Comprehend can identify, see how-syntax.

" - }, - "PartOfSpeechTagType":{ - "type":"string", - "enum":[ - "ADJ", - "ADP", - "ADV", - "AUX", - "CONJ", - "DET", - "INTJ", - "NOUN", - "NUM", - "O", - "PART", - "PRON", - "PROPN", - "PUNCT", - "SCONJ", - "SYM", - "VERB" - ] - }, - "S3Uri":{ - "type":"string", - "max":1024, - "pattern":"s3://[a-z0-9][\\.\\-a-z0-9]{1,61}[a-z0-9](/.*)?" - }, - "SentimentDetectionJobFilter":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

Filters on the name of the job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Filters the list of jobs based on job status. Returns only jobs with the specified status.

" - }, - "SubmitTimeBefore":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted before the specified time. Jobs are returned in ascending order, oldest to newest.

" - }, - "SubmitTimeAfter":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Returns only jobs submitted after the specified time. Jobs are returned in descending order, newest to oldest.

" - } - }, - "documentation":"

Provides information for filtering a list of dominant language detection jobs. For more information, see the operation.

" - }, - "SentimentDetectionJobProperties":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned to the sentiment detection job.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The name that you assigned to the sentiment detection job

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The current status of the sentiment detection job. If the status is FAILED, the Messages field shows the reason for the failure.

" - }, - "Message":{ - "shape":"AnyLengthString", - "documentation":"

A description of the status of a job.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The time that the sentiment detection job was submitted for processing.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time that the sentiment detection job ended.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

The input data configuration that you supplied when you created the sentiment detection job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The output data configuration that you supplied when you created the sentiment detection job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the input documents.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) that gives Amazon Comprehend read access to your input data.

" - } - }, - "documentation":"

Provides information about a sentiment detection job.

" - }, - "SentimentDetectionJobPropertiesList":{ - "type":"list", - "member":{"shape":"SentimentDetectionJobProperties"} - }, - "SentimentScore":{ - "type":"structure", - "members":{ - "Positive":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of its detection of the POSITIVE sentiment.

" - }, - "Negative":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of its detection of the NEGATIVE sentiment.

" - }, - "Neutral":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of its detection of the NEUTRAL sentiment.

" - }, - "Mixed":{ - "shape":"Float", - "documentation":"

The level of confidence that Amazon Comprehend has in the accuracy of its detection of the MIXED sentiment.

" - } - }, - "documentation":"

Describes the level of confidence that Amazon Comprehend has in the accuracy of its detection of sentiments.

" - }, - "SentimentType":{ - "type":"string", - "enum":[ - "POSITIVE", - "NEGATIVE", - "NEUTRAL", - "MIXED" - ] - }, - "StartDominantLanguageDetectionJobRequest":{ - "type":"structure", - "required":[ - "InputDataConfig", - "OutputDataConfig", - "DataAccessRoleArn" - ], - "members":{ - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

Specifies the format and location of the input data for the job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies where to send the output files.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

An identifier for the job.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenString", - "documentation":"

A unique identifier for the request. If you do not set the client request token, Amazon Comprehend generates one.

", - "idempotencyToken":true - } - } - }, - "StartDominantLanguageDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier generated for the job. To get the status of a job, use this identifier with the operation.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The status of the job.

  • SUBMITTED - The job has been received and is queued for processing.

  • IN_PROGRESS - Amazon Comprehend is processing the job.

  • COMPLETED - The job was successfully completed and the output is available.

  • FAILED - The job did not complete. To get details, use the operation.

" - } - } - }, - "StartEntitiesDetectionJobRequest":{ - "type":"structure", - "required":[ - "InputDataConfig", - "OutputDataConfig", - "DataAccessRoleArn", - "LanguageCode" - ], - "members":{ - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

Specifies the format and location of the input data for the job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies where to send the output files.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The identifier of the job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenString", - "documentation":"

A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one.

", - "idempotencyToken":true - } - } - }, - "StartEntitiesDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier generated for the job. To get the status of job, use this identifier with the operation.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The status of the job.

  • SUBMITTED - The job has been received and is queued for processing.

  • IN_PROGRESS - Amazon Comprehend is processing the job.

  • COMPLETED - The job was successfully completed and the output is available.

  • FAILED - The job did not complete. To get details, use the operation.

" - } - } - }, - "StartKeyPhrasesDetectionJobRequest":{ - "type":"structure", - "required":[ - "InputDataConfig", - "OutputDataConfig", - "DataAccessRoleArn", - "LanguageCode" - ], - "members":{ - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

Specifies the format and location of the input data for the job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies where to send the output files.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The identifier of the job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenString", - "documentation":"

A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one.

", - "idempotencyToken":true - } - } - }, - "StartKeyPhrasesDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier generated for the job. To get the status of a job, use this identifier with the operation.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The status of the job.

  • SUBMITTED - The job has been received and is queued for processing.

  • IN_PROGRESS - Amazon Comprehend is processing the job.

  • COMPLETED - The job was successfully completed and the output is available.

  • FAILED - The job did not complete. To get details, use the operation.

" - } - } - }, - "StartSentimentDetectionJobRequest":{ - "type":"structure", - "required":[ - "InputDataConfig", - "OutputDataConfig", - "DataAccessRoleArn", - "LanguageCode" - ], - "members":{ - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

Specifies the format and location of the input data for the job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies where to send the output files.

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The identifier of the job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language of the input documents. You can specify English (\"en\") or Spanish (\"es\"). All documents must be in the same language.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenString", - "documentation":"

A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one.

", - "idempotencyToken":true - } - } - }, - "StartSentimentDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier generated for the job. To get the status of a job, use this identifier with the operation.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The status of the job.

  • SUBMITTED - The job has been received and is queued for processing.

  • IN_PROGRESS - Amazon Comprehend is processing the job.

  • COMPLETED - The job was successfully completed and the output is available.

  • FAILED - The job did not complete. To get details, use the operation.

" - } - } - }, - "StartTopicsDetectionJobRequest":{ - "type":"structure", - "required":[ - "InputDataConfig", - "OutputDataConfig", - "DataAccessRoleArn" - ], - "members":{ - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

Specifies the format and location of the input data for the job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies where to send the output files. The output is a compressed archive with two files, topic-terms.csv that lists the terms associated with each topic, and doc-topics.csv that lists the documents associated with each topic

" - }, - "DataAccessRoleArn":{ - "shape":"IamRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The identifier of the job.

" - }, - "NumberOfTopics":{ - "shape":"NumberOfTopicsInteger", - "documentation":"

The number of topics to detect.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenString", - "documentation":"

A unique identifier for the request. If you do not set the client request token, Amazon Comprehend generates one.

", - "idempotencyToken":true - } - } - }, - "StartTopicsDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier generated for the job. To get the status of the job, use this identifier with the DescribeTopicDetectionJob operation.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The status of the job:

  • SUBMITTED - The job has been received and is queued for processing.

  • IN_PROGRESS - Amazon Comprehend is processing the job.

  • COMPLETED - The job was successfully completed and the output is available.

  • FAILED - The job did not complete. To get details, use the DescribeTopicDetectionJob operation.

" - } - } - }, - "StopDominantLanguageDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the dominant language detection job to stop.

" - } - } - }, - "StopDominantLanguageDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the dominant language detection job to stop.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Either STOP_REQUESTED if the job is currently running, or STOPPED if the job was previously stopped with the StopDominantLanguageDetectionJob operation.

" - } - } - }, - "StopEntitiesDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the entities detection job to stop.

" - } - } - }, - "StopEntitiesDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the entities detection job to stop.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Either STOP_REQUESTED if the job is currently running, or STOPPED if the job was previously stopped with the StopEntitiesDetectionJob operation.

" - } - } - }, - "StopKeyPhrasesDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the key phrases detection job to stop.

" - } - } - }, - "StopKeyPhrasesDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the key phrases detection job to stop.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Either STOP_REQUESTED if the job is currently running, or STOPPED if the job was previously stopped with the StopKeyPhrasesDetectionJob operation.

" - } - } - }, - "StopSentimentDetectionJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the sentiment detection job to stop.

" - } - } - }, - "StopSentimentDetectionJobResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier of the sentiment detection job to stop.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Either STOP_REQUESTED if the job is currently running, or STOPPED if the job was previously stopped with the StopSentimentDetectionJob operation.

" - } - } - }, - "String":{ - "type":"string", - "min":1 - }, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SyntaxLanguageCode":{ - "type":"string", - "enum":["en"] - }, - "SyntaxToken":{ - "type":"structure", - "members":{ - "TokenId":{ - "shape":"Integer", - "documentation":"

A unique identifier for a token.

" - }, - "Text":{ - "shape":"String", - "documentation":"

The word that was recognized in the source text.

" - }, - "BeginOffset":{ - "shape":"Integer", - "documentation":"

The zero-based offset from the beginning of the source text to the first character in the word.

" - }, - "EndOffset":{ - "shape":"Integer", - "documentation":"

The zero-based offset from the beginning of the source text to the last character in the word.

" - }, - "PartOfSpeech":{ - "shape":"PartOfSpeechTag", - "documentation":"

Provides the part of speech label and the confidence level that Amazon Comprehend has that the part of speech was correctly identified. For more information, see how-syntax.

" - } - }, - "documentation":"

Represents a work in the input text that was recognized and assigned a part of speech. There is one syntax token record for each word in the source text.

" - }, - "TextSizeLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The size of the input text exceeds the limit. Use a smaller document.

", - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The number of requests exceeds the limit. Resubmit your request later.

", - "exception":true - }, - "TopicsDetectionJobFilter":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

Filters the list of topic detection jobs based on job status. Returns only jobs with the specified status.

" - }, - "SubmitTimeBefore":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Only returns jobs submitted before the specified time. Jobs are returned in descending order, newest to oldest.

" - }, - "SubmitTimeAfter":{ - "shape":"Timestamp", - "documentation":"

Filters the list of jobs based on the time that the job was submitted for processing. Only returns jobs submitted after the specified time. Jobs are returned in ascending order, oldest to newest.

" - } - }, - "documentation":"

Provides information for filtering topic detection jobs. For more information, see .

" - }, - "TopicsDetectionJobProperties":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier assigned to the topic detection job.

" - }, - "JobName":{ - "shape":"JobName", - "documentation":"

The name of the topic detection job.

" - }, - "JobStatus":{ - "shape":"JobStatus", - "documentation":"

The current status of the topic detection job. If the status is Failed, the reason for the failure is shown in the Message field.

" - }, - "Message":{ - "shape":"AnyLengthString", - "documentation":"

A description for the status of a job.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The time that the topic detection job was submitted for processing.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The time that the topic detection job was completed.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

The input data configuration supplied when you created the topic detection job.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The output data configuration supplied when you created the topic detection job.

" - }, - "NumberOfTopics":{ - "shape":"Integer", - "documentation":"

The number of topics to detect supplied when you created the topic detection job. The default is 10.

" - } - }, - "documentation":"

Provides information about a topic detection job.

" - }, - "TopicsDetectionJobPropertiesList":{ - "type":"list", - "member":{"shape":"TopicsDetectionJobProperties"} - }, - "UnsupportedLanguageException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Amazon Comprehend can't process the language of the input text. For all APIs except DetectDominantLanguage, Amazon Comprehend accepts only English or Spanish text. For the DetectDominantLanguage API, Amazon Comprehend detects 100 languages. For a list of languages, see how-languages

", - "exception":true - } - }, - "documentation":"

Amazon Comprehend is an AWS service for gaining insight into the content of documents. Use these actions to determine the topics contained in your documents, the topics they discuss, the predominant sentiment expressed in them, the predominant language used, and more.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/paginators-1.json deleted file mode 100644 index 7b1f79b1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "DescribeComplianceByConfigRule": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ComplianceByConfigRules" - }, - "DescribeComplianceByResource": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ComplianceByResources" - }, - "DescribeConfigRules": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ConfigRules" - }, - "GetComplianceDetailsByConfigRule": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "EvaluationResults" - }, - "GetComplianceDetailsByResource": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "EvaluationResults" - }, - "GetResourceConfigHistory": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "configurationItems", - "limit_key": "limit" - }, - "ListDiscoveredResources": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "resourceIdentifiers" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/service-2.json deleted file mode 100644 index c8e4a5b4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/config/2014-11-12/service-2.json +++ /dev/null @@ -1,3413 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-11-12", - "endpointPrefix":"config", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Config Service", - "serviceFullName":"AWS Config", - "serviceId":"Config Service", - "signatureVersion":"v4", - "targetPrefix":"StarlingDoveService", - "uid":"config-2014-11-12" - }, - "operations":{ - "BatchGetResourceConfig":{ - "name":"BatchGetResourceConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetResourceConfigRequest"}, - "output":{"shape":"BatchGetResourceConfigResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"NoAvailableConfigurationRecorderException"} - ], - "documentation":"

Returns the current configuration for one or more requested resources. The operation also returns a list of resources that are not processed in the current request. If there are no unprocessed resources, the operation returns an empty unprocessedResourceKeys list.

  • The API does not return results for deleted resources.

  • The API does not return any tags for the requested resources. This information is filtered out of the supplementaryConfiguration section of the API response.

" - }, - "DeleteAggregationAuthorization":{ - "name":"DeleteAggregationAuthorization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAggregationAuthorizationRequest"}, - "errors":[ - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Deletes the authorization granted to the specified configuration aggregator account in a specified region.

" - }, - "DeleteConfigRule":{ - "name":"DeleteConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigRuleRequest"}, - "errors":[ - {"shape":"NoSuchConfigRuleException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes the specified AWS Config rule and all of its evaluation results.

AWS Config sets the state of a rule to DELETING until the deletion is complete. You cannot update a rule while it is in this state. If you make a PutConfigRule or DeleteConfigRule request for the rule, you will receive a ResourceInUseException.

You can check the state of a rule by using the DescribeConfigRules request.

" - }, - "DeleteConfigurationAggregator":{ - "name":"DeleteConfigurationAggregator", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationAggregatorRequest"}, - "errors":[ - {"shape":"NoSuchConfigurationAggregatorException"} - ], - "documentation":"

Deletes the specified configuration aggregator and the aggregated data associated with the aggregator.

" - }, - "DeleteConfigurationRecorder":{ - "name":"DeleteConfigurationRecorder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationRecorderRequest"}, - "errors":[ - {"shape":"NoSuchConfigurationRecorderException"} - ], - "documentation":"

Deletes the configuration recorder.

After the configuration recorder is deleted, AWS Config will not record resource configuration changes until you create a new configuration recorder.

This action does not delete the configuration information that was previously recorded. You will be able to access the previously recorded information by using the GetResourceConfigHistory action, but you will not be able to access this information in the AWS Config console until you create a new configuration recorder.

" - }, - "DeleteDeliveryChannel":{ - "name":"DeleteDeliveryChannel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDeliveryChannelRequest"}, - "errors":[ - {"shape":"NoSuchDeliveryChannelException"}, - {"shape":"LastDeliveryChannelDeleteFailedException"} - ], - "documentation":"

Deletes the delivery channel.

Before you can delete the delivery channel, you must stop the configuration recorder by using the StopConfigurationRecorder action.

" - }, - "DeleteEvaluationResults":{ - "name":"DeleteEvaluationResults", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEvaluationResultsRequest"}, - "output":{"shape":"DeleteEvaluationResultsResponse"}, - "errors":[ - {"shape":"NoSuchConfigRuleException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes the evaluation results for the specified AWS Config rule. You can specify one AWS Config rule per request. After you delete the evaluation results, you can call the StartConfigRulesEvaluation API to start evaluating your AWS resources against the rule.

" - }, - "DeletePendingAggregationRequest":{ - "name":"DeletePendingAggregationRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePendingAggregationRequestRequest"}, - "errors":[ - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Deletes pending authorization requests for a specified aggregator account in a specified region.

" - }, - "DeleteRetentionConfiguration":{ - "name":"DeleteRetentionConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRetentionConfigurationRequest"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"NoSuchRetentionConfigurationException"} - ], - "documentation":"

Deletes the retention configuration.

" - }, - "DeliverConfigSnapshot":{ - "name":"DeliverConfigSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeliverConfigSnapshotRequest"}, - "output":{"shape":"DeliverConfigSnapshotResponse"}, - "errors":[ - {"shape":"NoSuchDeliveryChannelException"}, - {"shape":"NoAvailableConfigurationRecorderException"}, - {"shape":"NoRunningConfigurationRecorderException"} - ], - "documentation":"

Schedules delivery of a configuration snapshot to the Amazon S3 bucket in the specified delivery channel. After the delivery has started, AWS Config sends the following notifications using an Amazon SNS topic that you have specified.

  • Notification of the start of the delivery.

  • Notification of the completion of the delivery, if the delivery was successfully completed.

  • Notification of delivery failure, if the delivery failed.

" - }, - "DescribeAggregateComplianceByConfigRules":{ - "name":"DescribeAggregateComplianceByConfigRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAggregateComplianceByConfigRulesRequest"}, - "output":{"shape":"DescribeAggregateComplianceByConfigRulesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoSuchConfigurationAggregatorException"} - ], - "documentation":"

Returns a list of compliant and noncompliant rules with the number of resources for compliant and noncompliant rules.

The results can return an empty result page, but if you have a nextToken, the results are displayed on the next page.

" - }, - "DescribeAggregationAuthorizations":{ - "name":"DescribeAggregationAuthorizations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAggregationAuthorizationsRequest"}, - "output":{"shape":"DescribeAggregationAuthorizationsResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidLimitException"} - ], - "documentation":"

Returns a list of authorizations granted to various aggregator accounts and regions.

" - }, - "DescribeComplianceByConfigRule":{ - "name":"DescribeComplianceByConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeComplianceByConfigRuleRequest"}, - "output":{"shape":"DescribeComplianceByConfigRuleResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"NoSuchConfigRuleException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Indicates whether the specified AWS Config rules are compliant. If a rule is noncompliant, this action returns the number of AWS resources that do not comply with the rule.

A rule is compliant if all of the evaluated resources comply with it. It is noncompliant if any of these resources do not comply.

If AWS Config has no current evaluation results for the rule, it returns INSUFFICIENT_DATA. This result might indicate one of the following conditions:

  • AWS Config has never invoked an evaluation for the rule. To check whether it has, use the DescribeConfigRuleEvaluationStatus action to get the LastSuccessfulInvocationTime and LastFailedInvocationTime.

  • The rule's AWS Lambda function is failing to send evaluation results to AWS Config. Verify that the role you assigned to your configuration recorder includes the config:PutEvaluations permission. If the rule is a custom rule, verify that the AWS Lambda execution role includes the config:PutEvaluations permission.

  • The rule's AWS Lambda function has returned NOT_APPLICABLE for all evaluation results. This can occur if the resources were deleted or removed from the rule's scope.

" - }, - "DescribeComplianceByResource":{ - "name":"DescribeComplianceByResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeComplianceByResourceRequest"}, - "output":{"shape":"DescribeComplianceByResourceResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Indicates whether the specified AWS resources are compliant. If a resource is noncompliant, this action returns the number of AWS Config rules that the resource does not comply with.

A resource is compliant if it complies with all the AWS Config rules that evaluate it. It is noncompliant if it does not comply with one or more of these rules.

If AWS Config has no current evaluation results for the resource, it returns INSUFFICIENT_DATA. This result might indicate one of the following conditions about the rules that evaluate the resource:

  • AWS Config has never invoked an evaluation for the rule. To check whether it has, use the DescribeConfigRuleEvaluationStatus action to get the LastSuccessfulInvocationTime and LastFailedInvocationTime.

  • The rule's AWS Lambda function is failing to send evaluation results to AWS Config. Verify that the role that you assigned to your configuration recorder includes the config:PutEvaluations permission. If the rule is a custom rule, verify that the AWS Lambda execution role includes the config:PutEvaluations permission.

  • The rule's AWS Lambda function has returned NOT_APPLICABLE for all evaluation results. This can occur if the resources were deleted or removed from the rule's scope.

" - }, - "DescribeConfigRuleEvaluationStatus":{ - "name":"DescribeConfigRuleEvaluationStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigRuleEvaluationStatusRequest"}, - "output":{"shape":"DescribeConfigRuleEvaluationStatusResponse"}, - "errors":[ - {"shape":"NoSuchConfigRuleException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns status information for each of your AWS managed Config rules. The status includes information such as the last time AWS Config invoked the rule, the last time AWS Config failed to invoke the rule, and the related error for the last failure.

" - }, - "DescribeConfigRules":{ - "name":"DescribeConfigRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigRulesRequest"}, - "output":{"shape":"DescribeConfigRulesResponse"}, - "errors":[ - {"shape":"NoSuchConfigRuleException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns details about your AWS Config rules.

" - }, - "DescribeConfigurationAggregatorSourcesStatus":{ - "name":"DescribeConfigurationAggregatorSourcesStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationAggregatorSourcesStatusRequest"}, - "output":{"shape":"DescribeConfigurationAggregatorSourcesStatusResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"NoSuchConfigurationAggregatorException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidLimitException"} - ], - "documentation":"

Returns status information for sources within an aggregator. The status includes information about the last time AWS Config aggregated data from source accounts or AWS Config failed to aggregate data from source accounts with the related error code or message.

" - }, - "DescribeConfigurationAggregators":{ - "name":"DescribeConfigurationAggregators", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationAggregatorsRequest"}, - "output":{"shape":"DescribeConfigurationAggregatorsResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"NoSuchConfigurationAggregatorException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidLimitException"} - ], - "documentation":"

Returns the details of one or more configuration aggregators. If the configuration aggregator is not specified, this action returns the details for all the configuration aggregators associated with the account.

" - }, - "DescribeConfigurationRecorderStatus":{ - "name":"DescribeConfigurationRecorderStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationRecorderStatusRequest"}, - "output":{"shape":"DescribeConfigurationRecorderStatusResponse"}, - "errors":[ - {"shape":"NoSuchConfigurationRecorderException"} - ], - "documentation":"

Returns the current status of the specified configuration recorder. If a configuration recorder is not specified, this action returns the status of all configuration recorders associated with the account.

Currently, you can specify only one configuration recorder per region in your account.

" - }, - "DescribeConfigurationRecorders":{ - "name":"DescribeConfigurationRecorders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationRecordersRequest"}, - "output":{"shape":"DescribeConfigurationRecordersResponse"}, - "errors":[ - {"shape":"NoSuchConfigurationRecorderException"} - ], - "documentation":"

Returns the details for the specified configuration recorders. If the configuration recorder is not specified, this action returns the details for all configuration recorders associated with the account.

Currently, you can specify only one configuration recorder per region in your account.

" - }, - "DescribeDeliveryChannelStatus":{ - "name":"DescribeDeliveryChannelStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDeliveryChannelStatusRequest"}, - "output":{"shape":"DescribeDeliveryChannelStatusResponse"}, - "errors":[ - {"shape":"NoSuchDeliveryChannelException"} - ], - "documentation":"

Returns the current status of the specified delivery channel. If a delivery channel is not specified, this action returns the current status of all delivery channels associated with the account.

Currently, you can specify only one delivery channel per region in your account.

" - }, - "DescribeDeliveryChannels":{ - "name":"DescribeDeliveryChannels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDeliveryChannelsRequest"}, - "output":{"shape":"DescribeDeliveryChannelsResponse"}, - "errors":[ - {"shape":"NoSuchDeliveryChannelException"} - ], - "documentation":"

Returns details about the specified delivery channel. If a delivery channel is not specified, this action returns the details of all delivery channels associated with the account.

Currently, you can specify only one delivery channel per region in your account.

" - }, - "DescribePendingAggregationRequests":{ - "name":"DescribePendingAggregationRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePendingAggregationRequestsRequest"}, - "output":{"shape":"DescribePendingAggregationRequestsResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidLimitException"} - ], - "documentation":"

Returns a list of all pending aggregation requests.

" - }, - "DescribeRetentionConfigurations":{ - "name":"DescribeRetentionConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRetentionConfigurationsRequest"}, - "output":{"shape":"DescribeRetentionConfigurationsResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"NoSuchRetentionConfigurationException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns the details of one or more retention configurations. If the retention configuration name is not specified, this action returns the details for all the retention configurations for that account.

Currently, AWS Config supports only one retention configuration per region in your account.

" - }, - "GetAggregateComplianceDetailsByConfigRule":{ - "name":"GetAggregateComplianceDetailsByConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAggregateComplianceDetailsByConfigRuleRequest"}, - "output":{"shape":"GetAggregateComplianceDetailsByConfigRuleResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoSuchConfigurationAggregatorException"} - ], - "documentation":"

Returns the evaluation results for the specified AWS Config rule for a specific resource in a rule. The results indicate which AWS resources were evaluated by the rule, when each resource was last evaluated, and whether each resource complies with the rule.

The results can return an empty result page. But if you have a nextToken, the results are displayed on the next page.

" - }, - "GetAggregateConfigRuleComplianceSummary":{ - "name":"GetAggregateConfigRuleComplianceSummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAggregateConfigRuleComplianceSummaryRequest"}, - "output":{"shape":"GetAggregateConfigRuleComplianceSummaryResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoSuchConfigurationAggregatorException"} - ], - "documentation":"

Returns the number of compliant and noncompliant rules for one or more accounts and regions in an aggregator.

The results can return an empty result page, but if you have a nextToken, the results are displayed on the next page.

" - }, - "GetComplianceDetailsByConfigRule":{ - "name":"GetComplianceDetailsByConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetComplianceDetailsByConfigRuleRequest"}, - "output":{"shape":"GetComplianceDetailsByConfigRuleResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoSuchConfigRuleException"} - ], - "documentation":"

Returns the evaluation results for the specified AWS Config rule. The results indicate which AWS resources were evaluated by the rule, when each resource was last evaluated, and whether each resource complies with the rule.

" - }, - "GetComplianceDetailsByResource":{ - "name":"GetComplianceDetailsByResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetComplianceDetailsByResourceRequest"}, - "output":{"shape":"GetComplianceDetailsByResourceResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns the evaluation results for the specified AWS resource. The results indicate which AWS Config rules were used to evaluate the resource, when each rule was last used, and whether the resource complies with each rule.

" - }, - "GetComplianceSummaryByConfigRule":{ - "name":"GetComplianceSummaryByConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"GetComplianceSummaryByConfigRuleResponse"}, - "documentation":"

Returns the number of AWS Config rules that are compliant and noncompliant, up to a maximum of 25 for each.

" - }, - "GetComplianceSummaryByResourceType":{ - "name":"GetComplianceSummaryByResourceType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetComplianceSummaryByResourceTypeRequest"}, - "output":{"shape":"GetComplianceSummaryByResourceTypeResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns the number of resources that are compliant and the number that are noncompliant. You can specify one or more resource types to get these numbers for each resource type. The maximum number returned is 100.

" - }, - "GetDiscoveredResourceCounts":{ - "name":"GetDiscoveredResourceCounts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDiscoveredResourceCountsRequest"}, - "output":{"shape":"GetDiscoveredResourceCountsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns the resource types, the number of each resource type, and the total number of resources that AWS Config is recording in this region for your AWS account.

Example

  1. AWS Config is recording three resource types in the US East (Ohio) Region for your account: 25 EC2 instances, 20 IAM users, and 15 S3 buckets.

  2. You make a call to the GetDiscoveredResourceCounts action and specify that you want all resource types.

  3. AWS Config returns the following:

    • The resource types (EC2 instances, IAM users, and S3 buckets).

    • The number of each resource type (25, 20, and 15).

    • The total number of all resources (60).

The response is paginated. By default, AWS Config lists 100 ResourceCount objects on each page. You can customize this number with the limit parameter. The response includes a nextToken string. To get the next page of results, run the request again and specify the string for the nextToken parameter.

If you make a call to the GetDiscoveredResourceCounts action, you might not immediately receive resource counts in the following situations:

  • You are a new AWS Config customer.

  • You just enabled resource recording.

It might take a few minutes for AWS Config to record and count your resources. Wait a few minutes and then retry the GetDiscoveredResourceCounts action.

" - }, - "GetResourceConfigHistory":{ - "name":"GetResourceConfigHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetResourceConfigHistoryRequest"}, - "output":{"shape":"GetResourceConfigHistoryResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidTimeRangeException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoAvailableConfigurationRecorderException"}, - {"shape":"ResourceNotDiscoveredException"} - ], - "documentation":"

Returns a list of configuration items for the specified resource. The list contains details about each state of the resource during the specified time interval. If you specified a retention period to retain your ConfigurationItems between a minimum of 30 days and a maximum of 7 years (2557 days), AWS Config returns the ConfigurationItems for the specified retention period.

The response is paginated. By default, AWS Config returns a limit of 10 configuration items per page. You can customize this number with the limit parameter. The response includes a nextToken string. To get the next page of results, run the request again and specify the string for the nextToken parameter.

Each call to the API is limited to span a duration of seven days. It is likely that the number of records returned is smaller than the specified limit. In such cases, you can make another call, using the nextToken.

" - }, - "ListDiscoveredResources":{ - "name":"ListDiscoveredResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDiscoveredResourcesRequest"}, - "output":{"shape":"ListDiscoveredResourcesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidLimitException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"NoAvailableConfigurationRecorderException"} - ], - "documentation":"

Accepts a resource type and returns a list of resource identifiers for the resources of that type. A resource identifier includes the resource type, ID, and (if available) the custom resource name. The results consist of resources that AWS Config has discovered, including those that AWS Config is not currently recording. You can narrow the results to include only resources that have specific resource IDs or a resource name.

You can specify either resource IDs or a resource name, but not both, in the same request.

The response is paginated. By default, AWS Config lists 100 resource identifiers on each page. You can customize this number with the limit parameter. The response includes a nextToken string. To get the next page of results, run the request again and specify the string for the nextToken parameter.

" - }, - "PutAggregationAuthorization":{ - "name":"PutAggregationAuthorization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutAggregationAuthorizationRequest"}, - "output":{"shape":"PutAggregationAuthorizationResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Authorizes the aggregator account and region to collect data from the source account and region.

" - }, - "PutConfigRule":{ - "name":"PutConfigRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutConfigRuleRequest"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MaxNumberOfConfigRulesExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InsufficientPermissionsException"}, - {"shape":"NoAvailableConfigurationRecorderException"} - ], - "documentation":"

Adds or updates an AWS Config rule for evaluating whether your AWS resources comply with your desired configurations.

You can use this action for custom AWS Config rules and AWS managed Config rules. A custom AWS Config rule is a rule that you develop and maintain. An AWS managed Config rule is a customizable, predefined rule that AWS Config provides.

If you are adding a new custom AWS Config rule, you must first create the AWS Lambda function that the rule invokes to evaluate your resources. When you use the PutConfigRule action to add the rule to AWS Config, you must specify the Amazon Resource Name (ARN) that AWS Lambda assigns to the function. Specify the ARN for the SourceIdentifier key. This key is part of the Source object, which is part of the ConfigRule object.

If you are adding an AWS managed Config rule, specify the rule's identifier for the SourceIdentifier key. To reference AWS managed Config rule identifiers, see About AWS Managed Config Rules.

For any new rule that you add, specify the ConfigRuleName in the ConfigRule object. Do not specify the ConfigRuleArn or the ConfigRuleId. These values are generated by AWS Config for new rules.

If you are updating a rule that you added previously, you can specify the rule by ConfigRuleName, ConfigRuleId, or ConfigRuleArn in the ConfigRule data type that you use in this request.

The maximum number of rules that AWS Config supports is 50.

For information about requesting a rule limit increase, see AWS Config Limits in the AWS General Reference Guide.

For more information about developing and using AWS Config rules, see Evaluating AWS Resource Configurations with AWS Config in the AWS Config Developer Guide.

" - }, - "PutConfigurationAggregator":{ - "name":"PutConfigurationAggregator", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutConfigurationAggregatorRequest"}, - "output":{"shape":"PutConfigurationAggregatorResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidRoleException"}, - {"shape":"OrganizationAccessDeniedException"}, - {"shape":"NoAvailableOrganizationException"}, - {"shape":"OrganizationAllFeaturesNotEnabledException"} - ], - "documentation":"

Creates and updates the configuration aggregator with the selected source accounts and regions. The source account can be individual account(s) or an organization.

AWS Config should be enabled in source accounts and regions you want to aggregate.

If your source type is an organization, you must be signed in to the master account and all features must be enabled in your organization. AWS Config calls EnableAwsServiceAccess API to enable integration between AWS Config and AWS Organizations.

" - }, - "PutConfigurationRecorder":{ - "name":"PutConfigurationRecorder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutConfigurationRecorderRequest"}, - "errors":[ - {"shape":"MaxNumberOfConfigurationRecordersExceededException"}, - {"shape":"InvalidConfigurationRecorderNameException"}, - {"shape":"InvalidRoleException"}, - {"shape":"InvalidRecordingGroupException"} - ], - "documentation":"

Creates a new configuration recorder to record the selected resource configurations.

You can use this action to change the role roleARN or the recordingGroup of an existing recorder. To change the role, call the action on the existing configuration recorder and specify a role.

Currently, you can specify only one configuration recorder per region in your account.

If ConfigurationRecorder does not have the recordingGroup parameter specified, the default is to record all supported resource types.

" - }, - "PutDeliveryChannel":{ - "name":"PutDeliveryChannel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutDeliveryChannelRequest"}, - "errors":[ - {"shape":"MaxNumberOfDeliveryChannelsExceededException"}, - {"shape":"NoAvailableConfigurationRecorderException"}, - {"shape":"InvalidDeliveryChannelNameException"}, - {"shape":"NoSuchBucketException"}, - {"shape":"InvalidS3KeyPrefixException"}, - {"shape":"InvalidSNSTopicARNException"}, - {"shape":"InsufficientDeliveryPolicyException"} - ], - "documentation":"

Creates a delivery channel object to deliver configuration information to an Amazon S3 bucket and Amazon SNS topic.

Before you can create a delivery channel, you must create a configuration recorder.

You can use this action to change the Amazon S3 bucket or an Amazon SNS topic of the existing delivery channel. To change the Amazon S3 bucket or an Amazon SNS topic, call this action and specify the changed values for the S3 bucket and the SNS topic. If you specify a different value for either the S3 bucket or the SNS topic, this action will keep the existing value for the parameter that is not changed.

You can have only one delivery channel per region in your account.

" - }, - "PutEvaluations":{ - "name":"PutEvaluations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutEvaluationsRequest"}, - "output":{"shape":"PutEvaluationsResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidResultTokenException"}, - {"shape":"NoSuchConfigRuleException"} - ], - "documentation":"

Used by an AWS Lambda function to deliver evaluation results to AWS Config. This action is required in every AWS Lambda function that is invoked by an AWS Config rule.

" - }, - "PutRetentionConfiguration":{ - "name":"PutRetentionConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRetentionConfigurationRequest"}, - "output":{"shape":"PutRetentionConfigurationResponse"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MaxNumberOfRetentionConfigurationsExceededException"} - ], - "documentation":"

Creates and updates the retention configuration with details about retention period (number of days) that AWS Config stores your historical information. The API creates the RetentionConfiguration object and names the object as default. When you have a RetentionConfiguration object named default, calling the API modifies the default object.

Currently, AWS Config supports only one retention configuration per region in your account.

" - }, - "StartConfigRulesEvaluation":{ - "name":"StartConfigRulesEvaluation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartConfigRulesEvaluationRequest"}, - "output":{"shape":"StartConfigRulesEvaluationResponse"}, - "errors":[ - {"shape":"NoSuchConfigRuleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Runs an on-demand evaluation for the specified AWS Config rules against the last known configuration state of the resources. Use StartConfigRulesEvaluation when you want to test that a rule you updated is working as expected. StartConfigRulesEvaluation does not re-record the latest configuration state for your resources. It re-runs an evaluation against the last known state of your resources.

You can specify up to 25 AWS Config rules per request.

An existing StartConfigRulesEvaluation call for the specified rules must complete before you can call the API again. If you chose to have AWS Config stream to an Amazon SNS topic, you will receive a ConfigRuleEvaluationStarted notification when the evaluation starts.

You don't need to call the StartConfigRulesEvaluation API to run an evaluation for a new rule. When you create a rule, AWS Config evaluates your resources against the rule automatically.

The StartConfigRulesEvaluation API is useful if you want to run on-demand evaluations, such as the following example:

  1. You have a custom rule that evaluates your IAM resources every 24 hours.

  2. You update your Lambda function to add additional conditions to your rule.

  3. Instead of waiting for the next periodic evaluation, you call the StartConfigRulesEvaluation API.

  4. AWS Config invokes your Lambda function and evaluates your IAM resources.

  5. Your custom rule will still run periodic evaluations every 24 hours.

" - }, - "StartConfigurationRecorder":{ - "name":"StartConfigurationRecorder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartConfigurationRecorderRequest"}, - "errors":[ - {"shape":"NoSuchConfigurationRecorderException"}, - {"shape":"NoAvailableDeliveryChannelException"} - ], - "documentation":"

Starts recording configurations of the AWS resources you have selected to record in your AWS account.

You must have created at least one delivery channel to successfully start the configuration recorder.

" - }, - "StopConfigurationRecorder":{ - "name":"StopConfigurationRecorder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopConfigurationRecorderRequest"}, - "errors":[ - {"shape":"NoSuchConfigurationRecorderException"} - ], - "documentation":"

Stops recording configurations of the AWS resources you have selected to record in your AWS account.

" - } - }, - "shapes":{ - "ARN":{"type":"string"}, - "AccountAggregationSource":{ - "type":"structure", - "required":["AccountIds"], - "members":{ - "AccountIds":{ - "shape":"AccountAggregationSourceAccountList", - "documentation":"

The 12-digit account ID of the account being aggregated.

" - }, - "AllAwsRegions":{ - "shape":"Boolean", - "documentation":"

If true, aggregate existing AWS Config regions and future regions.

" - }, - "AwsRegions":{ - "shape":"AggregatorRegionList", - "documentation":"

The source regions being aggregated.

" - } - }, - "documentation":"

A collection of accounts and regions.

" - }, - "AccountAggregationSourceAccountList":{ - "type":"list", - "member":{"shape":"AccountId"}, - "min":1 - }, - "AccountAggregationSourceList":{ - "type":"list", - "member":{"shape":"AccountAggregationSource"}, - "max":1, - "min":0 - }, - "AccountId":{ - "type":"string", - "pattern":"\\d{12}" - }, - "AggregateComplianceByConfigRule":{ - "type":"structure", - "members":{ - "ConfigRuleName":{ - "shape":"ConfigRuleName", - "documentation":"

The name of the AWS Config rule.

" - }, - "Compliance":{ - "shape":"Compliance", - "documentation":"

Indicates whether an AWS resource or AWS Config rule is compliant and provides the number of contributors that affect the compliance.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the source account.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The source region from where the data is aggregated.

" - } - }, - "documentation":"

Indicates whether an AWS Config rule is compliant based on account ID, region, compliance, and rule name.

A rule is compliant if all of the resources that the rule evaluated comply with it. It is noncompliant if any of these resources do not comply.

" - }, - "AggregateComplianceByConfigRuleList":{ - "type":"list", - "member":{"shape":"AggregateComplianceByConfigRule"} - }, - "AggregateComplianceCount":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"StringWithCharLimit256", - "documentation":"

The 12-digit account ID or region based on the GroupByKey value.

" - }, - "ComplianceSummary":{ - "shape":"ComplianceSummary", - "documentation":"

The number of compliant and noncompliant AWS Config rules.

" - } - }, - "documentation":"

Returns the number of compliant and noncompliant rules for one or more accounts and regions in an aggregator.

" - }, - "AggregateComplianceCountList":{ - "type":"list", - "member":{"shape":"AggregateComplianceCount"} - }, - "AggregateEvaluationResult":{ - "type":"structure", - "members":{ - "EvaluationResultIdentifier":{ - "shape":"EvaluationResultIdentifier", - "documentation":"

Uniquely identifies the evaluation result.

" - }, - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

The resource compliance status.

For the AggregationEvaluationResult data type, AWS Config supports only the COMPLIANT and NON_COMPLIANT. AWS Config does not support the NOT_APPLICABLE and INSUFFICIENT_DATA value.

" - }, - "ResultRecordedTime":{ - "shape":"Date", - "documentation":"

The time when AWS Config recorded the aggregate evaluation result.

" - }, - "ConfigRuleInvokedTime":{ - "shape":"Date", - "documentation":"

The time when the AWS Config rule evaluated the AWS resource.

" - }, - "Annotation":{ - "shape":"StringWithCharLimit256", - "documentation":"

Supplementary information about how the agrregate evaluation determined the compliance.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the source account.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The source region from where the data is aggregated.

" - } - }, - "documentation":"

The details of an AWS Config evaluation for an account ID and region in an aggregator. Provides the AWS resource that was evaluated, the compliance of the resource, related time stamps, and supplementary information.

" - }, - "AggregateEvaluationResultList":{ - "type":"list", - "member":{"shape":"AggregateEvaluationResult"} - }, - "AggregatedSourceStatus":{ - "type":"structure", - "members":{ - "SourceId":{ - "shape":"String", - "documentation":"

The source account ID or an organization.

" - }, - "SourceType":{ - "shape":"AggregatedSourceType", - "documentation":"

The source account or an organization.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region authorized to collect aggregated data.

" - }, - "LastUpdateStatus":{ - "shape":"AggregatedSourceStatusType", - "documentation":"

Filters the last updated status type.

  • Valid value FAILED indicates errors while moving data.

  • Valid value SUCCEEDED indicates the data was successfully moved.

  • Valid value OUTDATED indicates the data is not the most recent.

" - }, - "LastUpdateTime":{ - "shape":"Date", - "documentation":"

The time of the last update.

" - }, - "LastErrorCode":{ - "shape":"String", - "documentation":"

The error code that AWS Config returned when the source account aggregation last failed.

" - }, - "LastErrorMessage":{ - "shape":"String", - "documentation":"

The message indicating that the source account aggregation failed due to an error.

" - } - }, - "documentation":"

The current sync status between the source and the aggregator account.

" - }, - "AggregatedSourceStatusList":{ - "type":"list", - "member":{"shape":"AggregatedSourceStatus"} - }, - "AggregatedSourceStatusType":{ - "type":"string", - "enum":[ - "FAILED", - "SUCCEEDED", - "OUTDATED" - ] - }, - "AggregatedSourceStatusTypeList":{ - "type":"list", - "member":{"shape":"AggregatedSourceStatusType"}, - "min":1 - }, - "AggregatedSourceType":{ - "type":"string", - "enum":[ - "ACCOUNT", - "ORGANIZATION" - ] - }, - "AggregationAuthorization":{ - "type":"structure", - "members":{ - "AggregationAuthorizationArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the aggregation object.

" - }, - "AuthorizedAccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the account authorized to aggregate data.

" - }, - "AuthorizedAwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region authorized to collect aggregated data.

" - }, - "CreationTime":{ - "shape":"Date", - "documentation":"

The time stamp when the aggregation authorization was created.

" - } - }, - "documentation":"

An object that represents the authorizations granted to aggregator accounts and regions.

" - }, - "AggregationAuthorizationList":{ - "type":"list", - "member":{"shape":"AggregationAuthorization"} - }, - "AggregatorRegionList":{ - "type":"list", - "member":{"shape":"String"}, - "min":1 - }, - "AllSupported":{"type":"boolean"}, - "AvailabilityZone":{"type":"string"}, - "AwsRegion":{ - "type":"string", - "max":64, - "min":1 - }, - "BaseConfigurationItem":{ - "type":"structure", - "members":{ - "version":{ - "shape":"Version", - "documentation":"

The version number of the resource configuration.

" - }, - "accountId":{ - "shape":"AccountId", - "documentation":"

The 12 digit AWS account ID associated with the resource.

" - }, - "configurationItemCaptureTime":{ - "shape":"ConfigurationItemCaptureTime", - "documentation":"

The time when the configuration recording was initiated.

" - }, - "configurationItemStatus":{ - "shape":"ConfigurationItemStatus", - "documentation":"

The configuration item status.

" - }, - "configurationStateId":{ - "shape":"ConfigurationStateId", - "documentation":"

An identifier that indicates the ordering of the configuration items of a resource.

" - }, - "arn":{ - "shape":"ARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of AWS resource.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the resource (for example., sg-xxxxxx).

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The custom name of the resource, if available.

" - }, - "awsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region where the resource resides.

" - }, - "availabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone associated with the resource.

" - }, - "resourceCreationTime":{ - "shape":"ResourceCreationTime", - "documentation":"

The time stamp when the resource was created.

" - }, - "configuration":{ - "shape":"Configuration", - "documentation":"

The description of the resource configuration.

" - }, - "supplementaryConfiguration":{ - "shape":"SupplementaryConfiguration", - "documentation":"

Configuration attributes that AWS Config returns for certain resource types to supplement the information returned for the configuration parameter.

" - } - }, - "documentation":"

The detailed configuration of a specified resource.

" - }, - "BaseConfigurationItems":{ - "type":"list", - "member":{"shape":"BaseConfigurationItem"} - }, - "BaseResourceId":{ - "type":"string", - "max":768, - "min":1 - }, - "BatchGetResourceConfigRequest":{ - "type":"structure", - "required":["resourceKeys"], - "members":{ - "resourceKeys":{ - "shape":"ResourceKeys", - "documentation":"

A list of resource keys to be processed with the current request. Each element in the list consists of the resource type and resource ID.

" - } - } - }, - "BatchGetResourceConfigResponse":{ - "type":"structure", - "members":{ - "baseConfigurationItems":{ - "shape":"BaseConfigurationItems", - "documentation":"

A list that contains the current configuration of one or more resources.

" - }, - "unprocessedResourceKeys":{ - "shape":"ResourceKeys", - "documentation":"

A list of resource keys that were not processed with the current response. The unprocessesResourceKeys value is in the same form as ResourceKeys, so the value can be directly provided to a subsequent BatchGetResourceConfig operation. If there are no unprocessed resource keys, the response contains an empty unprocessedResourceKeys list.

" - } - } - }, - "Boolean":{"type":"boolean"}, - "ChannelName":{ - "type":"string", - "max":256, - "min":1 - }, - "ChronologicalOrder":{ - "type":"string", - "enum":[ - "Reverse", - "Forward" - ] - }, - "Compliance":{ - "type":"structure", - "members":{ - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

Indicates whether an AWS resource or AWS Config rule is compliant.

A resource is compliant if it complies with all of the AWS Config rules that evaluate it. A resource is noncompliant if it does not comply with one or more of these rules.

A rule is compliant if all of the resources that the rule evaluates comply with it. A rule is noncompliant if any of these resources do not comply.

AWS Config returns the INSUFFICIENT_DATA value when no evaluation results are available for the AWS resource or AWS Config rule.

For the Compliance data type, AWS Config supports only COMPLIANT, NON_COMPLIANT, and INSUFFICIENT_DATA values. AWS Config does not support the NOT_APPLICABLE value for the Compliance data type.

" - }, - "ComplianceContributorCount":{ - "shape":"ComplianceContributorCount", - "documentation":"

The number of AWS resources or AWS Config rules that cause a result of NON_COMPLIANT, up to a maximum number.

" - } - }, - "documentation":"

Indicates whether an AWS resource or AWS Config rule is compliant and provides the number of contributors that affect the compliance.

" - }, - "ComplianceByConfigRule":{ - "type":"structure", - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule.

" - }, - "Compliance":{ - "shape":"Compliance", - "documentation":"

Indicates whether the AWS Config rule is compliant.

" - } - }, - "documentation":"

Indicates whether an AWS Config rule is compliant. A rule is compliant if all of the resources that the rule evaluated comply with it. A rule is noncompliant if any of these resources do not comply.

" - }, - "ComplianceByConfigRules":{ - "type":"list", - "member":{"shape":"ComplianceByConfigRule"} - }, - "ComplianceByResource":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The type of the AWS resource that was evaluated.

" - }, - "ResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the AWS resource that was evaluated.

" - }, - "Compliance":{ - "shape":"Compliance", - "documentation":"

Indicates whether the AWS resource complies with all of the AWS Config rules that evaluated it.

" - } - }, - "documentation":"

Indicates whether an AWS resource that is evaluated according to one or more AWS Config rules is compliant. A resource is compliant if it complies with all of the rules that evaluate it. A resource is noncompliant if it does not comply with one or more of these rules.

" - }, - "ComplianceByResources":{ - "type":"list", - "member":{"shape":"ComplianceByResource"} - }, - "ComplianceContributorCount":{ - "type":"structure", - "members":{ - "CappedCount":{ - "shape":"Integer", - "documentation":"

The number of AWS resources or AWS Config rules responsible for the current compliance of the item.

" - }, - "CapExceeded":{ - "shape":"Boolean", - "documentation":"

Indicates whether the maximum count is reached.

" - } - }, - "documentation":"

The number of AWS resources or AWS Config rules responsible for the current compliance of the item, up to a maximum number.

" - }, - "ComplianceResourceTypes":{ - "type":"list", - "member":{"shape":"StringWithCharLimit256"}, - "max":100, - "min":0 - }, - "ComplianceSummariesByResourceType":{ - "type":"list", - "member":{"shape":"ComplianceSummaryByResourceType"} - }, - "ComplianceSummary":{ - "type":"structure", - "members":{ - "CompliantResourceCount":{ - "shape":"ComplianceContributorCount", - "documentation":"

The number of AWS Config rules or AWS resources that are compliant, up to a maximum of 25 for rules and 100 for resources.

" - }, - "NonCompliantResourceCount":{ - "shape":"ComplianceContributorCount", - "documentation":"

The number of AWS Config rules or AWS resources that are noncompliant, up to a maximum of 25 for rules and 100 for resources.

" - }, - "ComplianceSummaryTimestamp":{ - "shape":"Date", - "documentation":"

The time that AWS Config created the compliance summary.

" - } - }, - "documentation":"

The number of AWS Config rules or AWS resources that are compliant and noncompliant.

" - }, - "ComplianceSummaryByResourceType":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The type of AWS resource.

" - }, - "ComplianceSummary":{ - "shape":"ComplianceSummary", - "documentation":"

The number of AWS resources that are compliant or noncompliant, up to a maximum of 100 for each.

" - } - }, - "documentation":"

The number of AWS resources of a specific type that are compliant or noncompliant, up to a maximum of 100 for each.

" - }, - "ComplianceType":{ - "type":"string", - "enum":[ - "COMPLIANT", - "NON_COMPLIANT", - "NOT_APPLICABLE", - "INSUFFICIENT_DATA" - ] - }, - "ComplianceTypes":{ - "type":"list", - "member":{"shape":"ComplianceType"}, - "max":3, - "min":0 - }, - "ConfigExportDeliveryInfo":{ - "type":"structure", - "members":{ - "lastStatus":{ - "shape":"DeliveryStatus", - "documentation":"

Status of the last attempted delivery.

" - }, - "lastErrorCode":{ - "shape":"String", - "documentation":"

The error code from the last attempted delivery.

" - }, - "lastErrorMessage":{ - "shape":"String", - "documentation":"

The error message from the last attempted delivery.

" - }, - "lastAttemptTime":{ - "shape":"Date", - "documentation":"

The time of the last attempted delivery.

" - }, - "lastSuccessfulTime":{ - "shape":"Date", - "documentation":"

The time of the last successful delivery.

" - }, - "nextDeliveryTime":{ - "shape":"Date", - "documentation":"

The time that the next delivery occurs.

" - } - }, - "documentation":"

Provides status of the delivery of the snapshot or the configuration history to the specified Amazon S3 bucket. Also provides the status of notifications about the Amazon S3 delivery to the specified Amazon SNS topic.

" - }, - "ConfigRule":{ - "type":"structure", - "required":["Source"], - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name that you assign to the AWS Config rule. The name is required if you are adding a new rule.

" - }, - "ConfigRuleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Config rule.

" - }, - "ConfigRuleId":{ - "shape":"String", - "documentation":"

The ID of the AWS Config rule.

" - }, - "Description":{ - "shape":"EmptiableStringWithCharLimit256", - "documentation":"

The description that you provide for the AWS Config rule.

" - }, - "Scope":{ - "shape":"Scope", - "documentation":"

Defines which resources can trigger an evaluation for the rule. The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes.

" - }, - "Source":{ - "shape":"Source", - "documentation":"

Provides the rule owner (AWS or customer), the rule identifier, and the notifications that cause the function to evaluate your AWS resources.

" - }, - "InputParameters":{ - "shape":"StringWithCharLimit1024", - "documentation":"

A string, in JSON format, that is passed to the AWS Config rule Lambda function.

" - }, - "MaximumExecutionFrequency":{ - "shape":"MaximumExecutionFrequency", - "documentation":"

The maximum frequency with which AWS Config runs evaluations for a rule. You can specify a value for MaximumExecutionFrequency when:

  • You are using an AWS managed rule that is triggered at a periodic frequency.

  • Your custom rule is triggered when AWS Config delivers the configuration snapshot. For more information, see ConfigSnapshotDeliveryProperties.

By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the MaximumExecutionFrequency parameter.

" - }, - "ConfigRuleState":{ - "shape":"ConfigRuleState", - "documentation":"

Indicates whether the AWS Config rule is active or is currently being deleted by AWS Config. It can also indicate the evaluation status for the AWS Config rule.

AWS Config sets the state of the rule to EVALUATING temporarily after you use the StartConfigRulesEvaluation request to evaluate your resources against the AWS Config rule.

AWS Config sets the state of the rule to DELETING_RESULTS temporarily after you use the DeleteEvaluationResults request to delete the current evaluation results for the AWS Config rule.

AWS Config temporarily sets the state of a rule to DELETING after you use the DeleteConfigRule request to delete the rule. After AWS Config deletes the rule, the rule and all of its evaluations are erased and are no longer available.

" - } - }, - "documentation":"

An AWS Config rule represents an AWS Lambda function that you create for a custom rule or a predefined function for an AWS managed rule. The function evaluates configuration items to assess whether your AWS resources comply with your desired configurations. This function can run when AWS Config detects a configuration change to an AWS resource and at a periodic frequency that you choose (for example, every 24 hours).

You can use the AWS CLI and AWS SDKs if you want to create a rule that triggers evaluations for your resources when AWS Config delivers the configuration snapshot. For more information, see ConfigSnapshotDeliveryProperties.

For more information about developing and using AWS Config rules, see Evaluating AWS Resource Configurations with AWS Config in the AWS Config Developer Guide.

" - }, - "ConfigRuleComplianceFilters":{ - "type":"structure", - "members":{ - "ConfigRuleName":{ - "shape":"ConfigRuleName", - "documentation":"

The name of the AWS Config rule.

" - }, - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

The rule compliance status.

For the ConfigRuleComplianceFilters data type, AWS Config supports only COMPLIANT and NON_COMPLIANT. AWS Config does not support the NOT_APPLICABLE and the INSUFFICIENT_DATA values.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the source account.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The source region where the data is aggregated.

" - } - }, - "documentation":"

Filters the compliance results based on account ID, region, compliance type, and rule name.

" - }, - "ConfigRuleComplianceSummaryFilters":{ - "type":"structure", - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the source account.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The source region where the data is aggregated.

" - } - }, - "documentation":"

Filters the results based on the account IDs and regions.

" - }, - "ConfigRuleComplianceSummaryGroupKey":{ - "type":"string", - "enum":[ - "ACCOUNT_ID", - "AWS_REGION" - ] - }, - "ConfigRuleEvaluationStatus":{ - "type":"structure", - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule.

" - }, - "ConfigRuleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Config rule.

" - }, - "ConfigRuleId":{ - "shape":"String", - "documentation":"

The ID of the AWS Config rule.

" - }, - "LastSuccessfulInvocationTime":{ - "shape":"Date", - "documentation":"

The time that AWS Config last successfully invoked the AWS Config rule to evaluate your AWS resources.

" - }, - "LastFailedInvocationTime":{ - "shape":"Date", - "documentation":"

The time that AWS Config last failed to invoke the AWS Config rule to evaluate your AWS resources.

" - }, - "LastSuccessfulEvaluationTime":{ - "shape":"Date", - "documentation":"

The time that AWS Config last successfully evaluated your AWS resources against the rule.

" - }, - "LastFailedEvaluationTime":{ - "shape":"Date", - "documentation":"

The time that AWS Config last failed to evaluate your AWS resources against the rule.

" - }, - "FirstActivatedTime":{ - "shape":"Date", - "documentation":"

The time that you first activated the AWS Config rule.

" - }, - "LastErrorCode":{ - "shape":"String", - "documentation":"

The error code that AWS Config returned when the rule last failed.

" - }, - "LastErrorMessage":{ - "shape":"String", - "documentation":"

The error message that AWS Config returned when the rule last failed.

" - }, - "FirstEvaluationStarted":{ - "shape":"Boolean", - "documentation":"

Indicates whether AWS Config has evaluated your resources against the rule at least once.

  • true - AWS Config has evaluated your AWS resources against the rule at least once.

  • false - AWS Config has not once finished evaluating your AWS resources against the rule.

" - } - }, - "documentation":"

Status information for your AWS managed Config rules. The status includes information such as the last time the rule ran, the last time it failed, and the related error for the last failure.

This action does not return status information about custom AWS Config rules.

" - }, - "ConfigRuleEvaluationStatusList":{ - "type":"list", - "member":{"shape":"ConfigRuleEvaluationStatus"} - }, - "ConfigRuleName":{ - "type":"string", - "max":64, - "min":1 - }, - "ConfigRuleNames":{ - "type":"list", - "member":{"shape":"StringWithCharLimit64"}, - "max":25, - "min":0 - }, - "ConfigRuleState":{ - "type":"string", - "enum":[ - "ACTIVE", - "DELETING", - "DELETING_RESULTS", - "EVALUATING" - ] - }, - "ConfigRules":{ - "type":"list", - "member":{"shape":"ConfigRule"} - }, - "ConfigSnapshotDeliveryProperties":{ - "type":"structure", - "members":{ - "deliveryFrequency":{ - "shape":"MaximumExecutionFrequency", - "documentation":"

The frequency with which AWS Config delivers configuration snapshots.

" - } - }, - "documentation":"

Provides options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket in your delivery channel.

If you want to create a rule that triggers evaluations for your resources when AWS Config delivers the configuration snapshot, see the following:

The frequency for a rule that triggers evaluations for your resources when AWS Config delivers the configuration snapshot is set by one of two values, depending on which is less frequent:

  • The value for the deliveryFrequency parameter within the delivery channel configuration, which sets how often AWS Config delivers configuration snapshots. This value also sets how often AWS Config invokes evaluations for AWS Config rules.

  • The value for the MaximumExecutionFrequency parameter, which sets the maximum frequency with which AWS Config invokes evaluations for the rule. For more information, see ConfigRule.

If the deliveryFrequency value is less frequent than the MaximumExecutionFrequency value for a rule, AWS Config invokes the rule only as often as the deliveryFrequency value.

  1. For example, you want your rule to run evaluations when AWS Config delivers the configuration snapshot.

  2. You specify the MaximumExecutionFrequency value for Six_Hours.

  3. You then specify the delivery channel deliveryFrequency value for TwentyFour_Hours.

  4. Because the value for deliveryFrequency is less frequent than MaximumExecutionFrequency, AWS Config invokes evaluations for the rule every 24 hours.

You should set the MaximumExecutionFrequency value to be at least as frequent as the deliveryFrequency value. You can view the deliveryFrequency value by using the DescribeDeliveryChannnels action.

To update the deliveryFrequency with which AWS Config delivers your configuration snapshots, use the PutDeliveryChannel action.

" - }, - "ConfigStreamDeliveryInfo":{ - "type":"structure", - "members":{ - "lastStatus":{ - "shape":"DeliveryStatus", - "documentation":"

Status of the last attempted delivery.

Note Providing an SNS topic on a DeliveryChannel for AWS Config is optional. If the SNS delivery is turned off, the last status will be Not_Applicable.

" - }, - "lastErrorCode":{ - "shape":"String", - "documentation":"

The error code from the last attempted delivery.

" - }, - "lastErrorMessage":{ - "shape":"String", - "documentation":"

The error message from the last attempted delivery.

" - }, - "lastStatusChangeTime":{ - "shape":"Date", - "documentation":"

The time from the last status change.

" - } - }, - "documentation":"

A list that contains the status of the delivery of the configuration stream notification to the Amazon SNS topic.

" - }, - "Configuration":{"type":"string"}, - "ConfigurationAggregator":{ - "type":"structure", - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the aggregator.

" - }, - "ConfigurationAggregatorArn":{ - "shape":"ConfigurationAggregatorArn", - "documentation":"

The Amazon Resource Name (ARN) of the aggregator.

" - }, - "AccountAggregationSources":{ - "shape":"AccountAggregationSourceList", - "documentation":"

Provides a list of source accounts and regions to be aggregated.

" - }, - "OrganizationAggregationSource":{ - "shape":"OrganizationAggregationSource", - "documentation":"

Provides an organization and list of regions to be aggregated.

" - }, - "CreationTime":{ - "shape":"Date", - "documentation":"

The time stamp when the configuration aggregator was created.

" - }, - "LastUpdatedTime":{ - "shape":"Date", - "documentation":"

The time of the last update.

" - } - }, - "documentation":"

The details about the configuration aggregator, including information about source accounts, regions, and metadata of the aggregator.

" - }, - "ConfigurationAggregatorArn":{ - "type":"string", - "pattern":"arn:aws[a-z\\-]*:config:[a-z\\-\\d]+:\\d+:config-aggregator/config-aggregator-[a-z\\d]+" - }, - "ConfigurationAggregatorList":{ - "type":"list", - "member":{"shape":"ConfigurationAggregator"} - }, - "ConfigurationAggregatorName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w\\-]+" - }, - "ConfigurationAggregatorNameList":{ - "type":"list", - "member":{"shape":"ConfigurationAggregatorName"}, - "max":10, - "min":0 - }, - "ConfigurationItem":{ - "type":"structure", - "members":{ - "version":{ - "shape":"Version", - "documentation":"

The version number of the resource configuration.

" - }, - "accountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit AWS account ID associated with the resource.

" - }, - "configurationItemCaptureTime":{ - "shape":"ConfigurationItemCaptureTime", - "documentation":"

The time when the configuration recording was initiated.

" - }, - "configurationItemStatus":{ - "shape":"ConfigurationItemStatus", - "documentation":"

The configuration item status.

" - }, - "configurationStateId":{ - "shape":"ConfigurationStateId", - "documentation":"

An identifier that indicates the ordering of the configuration items of a resource.

" - }, - "configurationItemMD5Hash":{ - "shape":"ConfigurationItemMD5Hash", - "documentation":"

Unique MD5 hash that represents the configuration item's state.

You can use MD5 hash to compare the states of two or more configuration items that are associated with the same resource.

" - }, - "arn":{ - "shape":"ARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of AWS resource.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the resource (for example, sg-xxxxxx).

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The custom name of the resource, if available.

" - }, - "awsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region where the resource resides.

" - }, - "availabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone associated with the resource.

" - }, - "resourceCreationTime":{ - "shape":"ResourceCreationTime", - "documentation":"

The time stamp when the resource was created.

" - }, - "tags":{ - "shape":"Tags", - "documentation":"

A mapping of key value tags associated with the resource.

" - }, - "relatedEvents":{ - "shape":"RelatedEventList", - "documentation":"

A list of CloudTrail event IDs.

A populated field indicates that the current configuration was initiated by the events recorded in the CloudTrail log. For more information about CloudTrail, see What Is AWS CloudTrail.

An empty field indicates that the current configuration was not initiated by any event.

" - }, - "relationships":{ - "shape":"RelationshipList", - "documentation":"

A list of related AWS resources.

" - }, - "configuration":{ - "shape":"Configuration", - "documentation":"

The description of the resource configuration.

" - }, - "supplementaryConfiguration":{ - "shape":"SupplementaryConfiguration", - "documentation":"

Configuration attributes that AWS Config returns for certain resource types to supplement the information returned for the configuration parameter.

" - } - }, - "documentation":"

A list that contains detailed configurations of a specified resource.

" - }, - "ConfigurationItemCaptureTime":{"type":"timestamp"}, - "ConfigurationItemList":{ - "type":"list", - "member":{"shape":"ConfigurationItem"} - }, - "ConfigurationItemMD5Hash":{"type":"string"}, - "ConfigurationItemStatus":{ - "type":"string", - "enum":[ - "OK", - "ResourceDiscovered", - "ResourceNotRecorded", - "ResourceDeleted", - "ResourceDeletedNotRecorded" - ] - }, - "ConfigurationRecorder":{ - "type":"structure", - "members":{ - "name":{ - "shape":"RecorderName", - "documentation":"

The name of the recorder. By default, AWS Config automatically assigns the name \"default\" when creating the configuration recorder. You cannot change the assigned name.

" - }, - "roleARN":{ - "shape":"String", - "documentation":"

Amazon Resource Name (ARN) of the IAM role used to describe the AWS resources associated with the account.

" - }, - "recordingGroup":{ - "shape":"RecordingGroup", - "documentation":"

Specifies the types of AWS resources for which AWS Config records configuration changes.

" - } - }, - "documentation":"

An object that represents the recording of configuration changes of an AWS resource.

" - }, - "ConfigurationRecorderList":{ - "type":"list", - "member":{"shape":"ConfigurationRecorder"} - }, - "ConfigurationRecorderNameList":{ - "type":"list", - "member":{"shape":"RecorderName"} - }, - "ConfigurationRecorderStatus":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the configuration recorder.

" - }, - "lastStartTime":{ - "shape":"Date", - "documentation":"

The time the recorder was last started.

" - }, - "lastStopTime":{ - "shape":"Date", - "documentation":"

The time the recorder was last stopped.

" - }, - "recording":{ - "shape":"Boolean", - "documentation":"

Specifies whether or not the recorder is currently recording.

" - }, - "lastStatus":{ - "shape":"RecorderStatus", - "documentation":"

The last (previous) status of the recorder.

" - }, - "lastErrorCode":{ - "shape":"String", - "documentation":"

The error code indicating that the recording failed.

" - }, - "lastErrorMessage":{ - "shape":"String", - "documentation":"

The message indicating that the recording failed due to an error.

" - }, - "lastStatusChangeTime":{ - "shape":"Date", - "documentation":"

The time when the status was last changed.

" - } - }, - "documentation":"

The current status of the configuration recorder.

" - }, - "ConfigurationRecorderStatusList":{ - "type":"list", - "member":{"shape":"ConfigurationRecorderStatus"} - }, - "ConfigurationStateId":{"type":"string"}, - "Date":{"type":"timestamp"}, - "DeleteAggregationAuthorizationRequest":{ - "type":"structure", - "required":[ - "AuthorizedAccountId", - "AuthorizedAwsRegion" - ], - "members":{ - "AuthorizedAccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the account authorized to aggregate data.

" - }, - "AuthorizedAwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region authorized to collect aggregated data.

" - } - } - }, - "DeleteConfigRuleRequest":{ - "type":"structure", - "required":["ConfigRuleName"], - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule that you want to delete.

" - } - }, - "documentation":"

" - }, - "DeleteConfigurationAggregatorRequest":{ - "type":"structure", - "required":["ConfigurationAggregatorName"], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - } - } - }, - "DeleteConfigurationRecorderRequest":{ - "type":"structure", - "required":["ConfigurationRecorderName"], - "members":{ - "ConfigurationRecorderName":{ - "shape":"RecorderName", - "documentation":"

The name of the configuration recorder to be deleted. You can retrieve the name of your configuration recorder by using the DescribeConfigurationRecorders action.

" - } - }, - "documentation":"

The request object for the DeleteConfigurationRecorder action.

" - }, - "DeleteDeliveryChannelRequest":{ - "type":"structure", - "required":["DeliveryChannelName"], - "members":{ - "DeliveryChannelName":{ - "shape":"ChannelName", - "documentation":"

The name of the delivery channel to delete.

" - } - }, - "documentation":"

The input for the DeleteDeliveryChannel action. The action accepts the following data, in JSON format.

" - }, - "DeleteEvaluationResultsRequest":{ - "type":"structure", - "required":["ConfigRuleName"], - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule for which you want to delete the evaluation results.

" - } - }, - "documentation":"

" - }, - "DeleteEvaluationResultsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output when you delete the evaluation results for the specified AWS Config rule.

" - }, - "DeletePendingAggregationRequestRequest":{ - "type":"structure", - "required":[ - "RequesterAccountId", - "RequesterAwsRegion" - ], - "members":{ - "RequesterAccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the account requesting to aggregate data.

" - }, - "RequesterAwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region requesting to aggregate data.

" - } - } - }, - "DeleteRetentionConfigurationRequest":{ - "type":"structure", - "required":["RetentionConfigurationName"], - "members":{ - "RetentionConfigurationName":{ - "shape":"RetentionConfigurationName", - "documentation":"

The name of the retention configuration to delete.

" - } - } - }, - "DeliverConfigSnapshotRequest":{ - "type":"structure", - "required":["deliveryChannelName"], - "members":{ - "deliveryChannelName":{ - "shape":"ChannelName", - "documentation":"

The name of the delivery channel through which the snapshot is delivered.

" - } - }, - "documentation":"

The input for the DeliverConfigSnapshot action.

" - }, - "DeliverConfigSnapshotResponse":{ - "type":"structure", - "members":{ - "configSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot that is being created.

" - } - }, - "documentation":"

The output for the DeliverConfigSnapshot action, in JSON format.

" - }, - "DeliveryChannel":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ChannelName", - "documentation":"

The name of the delivery channel. By default, AWS Config assigns the name \"default\" when creating the delivery channel. To change the delivery channel name, you must use the DeleteDeliveryChannel action to delete your current delivery channel, and then you must use the PutDeliveryChannel command to create a delivery channel that has the desired name.

" - }, - "s3BucketName":{ - "shape":"String", - "documentation":"

The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

If you specify a bucket that belongs to another AWS account, that bucket must have policies that grant access permissions to AWS Config. For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide.

" - }, - "s3KeyPrefix":{ - "shape":"String", - "documentation":"

The prefix for the specified Amazon S3 bucket.

" - }, - "snsTopicARN":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config. For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide.

" - }, - "configSnapshotDeliveryProperties":{ - "shape":"ConfigSnapshotDeliveryProperties", - "documentation":"

The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.

" - } - }, - "documentation":"

The channel through which AWS Config delivers notifications and updated configuration states.

" - }, - "DeliveryChannelList":{ - "type":"list", - "member":{"shape":"DeliveryChannel"} - }, - "DeliveryChannelNameList":{ - "type":"list", - "member":{"shape":"ChannelName"} - }, - "DeliveryChannelStatus":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the delivery channel.

" - }, - "configSnapshotDeliveryInfo":{ - "shape":"ConfigExportDeliveryInfo", - "documentation":"

A list containing the status of the delivery of the snapshot to the specified Amazon S3 bucket.

" - }, - "configHistoryDeliveryInfo":{ - "shape":"ConfigExportDeliveryInfo", - "documentation":"

A list that contains the status of the delivery of the configuration history to the specified Amazon S3 bucket.

" - }, - "configStreamDeliveryInfo":{ - "shape":"ConfigStreamDeliveryInfo", - "documentation":"

A list containing the status of the delivery of the configuration stream notification to the specified Amazon SNS topic.

" - } - }, - "documentation":"

The status of a specified delivery channel.

Valid values: Success | Failure

" - }, - "DeliveryChannelStatusList":{ - "type":"list", - "member":{"shape":"DeliveryChannelStatus"} - }, - "DeliveryStatus":{ - "type":"string", - "enum":[ - "Success", - "Failure", - "Not_Applicable" - ] - }, - "DescribeAggregateComplianceByConfigRulesRequest":{ - "type":"structure", - "required":["ConfigurationAggregatorName"], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - }, - "Filters":{ - "shape":"ConfigRuleComplianceFilters", - "documentation":"

Filters the results by ConfigRuleComplianceFilters object.

" - }, - "Limit":{ - "shape":"GroupByAPILimit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is maximum. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeAggregateComplianceByConfigRulesResponse":{ - "type":"structure", - "members":{ - "AggregateComplianceByConfigRules":{ - "shape":"AggregateComplianceByConfigRuleList", - "documentation":"

Returns a list of AggregateComplianceByConfigRule object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeAggregationAuthorizationsRequest":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of AggregationAuthorizations returned on each page. The default is maximum. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeAggregationAuthorizationsResponse":{ - "type":"structure", - "members":{ - "AggregationAuthorizations":{ - "shape":"AggregationAuthorizationList", - "documentation":"

Returns a list of authorizations granted to various aggregator accounts and regions.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeComplianceByConfigRuleRequest":{ - "type":"structure", - "members":{ - "ConfigRuleNames":{ - "shape":"ConfigRuleNames", - "documentation":"

Specify one or more AWS Config rule names to filter the results by rule.

" - }, - "ComplianceTypes":{ - "shape":"ComplianceTypes", - "documentation":"

Filters the results by compliance.

The allowed values are COMPLIANT, NON_COMPLIANT, and INSUFFICIENT_DATA.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeComplianceByConfigRuleResponse":{ - "type":"structure", - "members":{ - "ComplianceByConfigRules":{ - "shape":"ComplianceByConfigRules", - "documentation":"

Indicates whether each of the specified AWS Config rules is compliant.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeComplianceByResourceRequest":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The types of AWS resources for which you want compliance information (for example, AWS::EC2::Instance). For this action, you can specify that the resource type is an AWS account by specifying AWS::::Account.

" - }, - "ResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the AWS resource for which you want compliance information. You can specify only one resource ID. If you specify a resource ID, you must also specify a type for ResourceType.

" - }, - "ComplianceTypes":{ - "shape":"ComplianceTypes", - "documentation":"

Filters the results by compliance.

The allowed values are COMPLIANT and NON_COMPLIANT.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is 10. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeComplianceByResourceResponse":{ - "type":"structure", - "members":{ - "ComplianceByResources":{ - "shape":"ComplianceByResources", - "documentation":"

Indicates whether the specified AWS resource complies with all of the AWS Config rules that evaluate it.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeConfigRuleEvaluationStatusRequest":{ - "type":"structure", - "members":{ - "ConfigRuleNames":{ - "shape":"ConfigRuleNames", - "documentation":"

The name of the AWS managed Config rules for which you want status information. If you do not specify any names, AWS Config returns status information for all AWS managed Config rules that you use.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - }, - "Limit":{ - "shape":"RuleLimit", - "documentation":"

The number of rule evaluation results that you want returned.

This parameter is required if the rule limit for your account is more than the default of 50 rules.

For information about requesting a rule limit increase, see AWS Config Limits in the AWS General Reference Guide.

" - } - }, - "documentation":"

" - }, - "DescribeConfigRuleEvaluationStatusResponse":{ - "type":"structure", - "members":{ - "ConfigRulesEvaluationStatus":{ - "shape":"ConfigRuleEvaluationStatusList", - "documentation":"

Status information about your AWS managed Config rules.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeConfigRulesRequest":{ - "type":"structure", - "members":{ - "ConfigRuleNames":{ - "shape":"ConfigRuleNames", - "documentation":"

The names of the AWS Config rules for which you want details. If you do not specify any names, AWS Config returns details for all your rules.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeConfigRulesResponse":{ - "type":"structure", - "members":{ - "ConfigRules":{ - "shape":"ConfigRules", - "documentation":"

The details about your AWS Config rules.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "DescribeConfigurationAggregatorSourcesStatusRequest":{ - "type":"structure", - "required":["ConfigurationAggregatorName"], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - }, - "UpdateStatus":{ - "shape":"AggregatedSourceStatusTypeList", - "documentation":"

Filters the status type.

  • Valid value FAILED indicates errors while moving data.

  • Valid value SUCCEEDED indicates the data was successfully moved.

  • Valid value OUTDATED indicates the data is not the most recent.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of AggregatorSourceStatus returned on each page. The default is maximum. If you specify 0, AWS Config uses the default.

" - } - } - }, - "DescribeConfigurationAggregatorSourcesStatusResponse":{ - "type":"structure", - "members":{ - "AggregatedSourceStatusList":{ - "shape":"AggregatedSourceStatusList", - "documentation":"

Returns an AggregatedSourceStatus object.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeConfigurationAggregatorsRequest":{ - "type":"structure", - "members":{ - "ConfigurationAggregatorNames":{ - "shape":"ConfigurationAggregatorNameList", - "documentation":"

The name of the configuration aggregators.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of configuration aggregators returned on each page. The default is maximum. If you specify 0, AWS Config uses the default.

" - } - } - }, - "DescribeConfigurationAggregatorsResponse":{ - "type":"structure", - "members":{ - "ConfigurationAggregators":{ - "shape":"ConfigurationAggregatorList", - "documentation":"

Returns a ConfigurationAggregators object.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeConfigurationRecorderStatusRequest":{ - "type":"structure", - "members":{ - "ConfigurationRecorderNames":{ - "shape":"ConfigurationRecorderNameList", - "documentation":"

The name(s) of the configuration recorder. If the name is not specified, the action returns the current status of all the configuration recorders associated with the account.

" - } - }, - "documentation":"

The input for the DescribeConfigurationRecorderStatus action.

" - }, - "DescribeConfigurationRecorderStatusResponse":{ - "type":"structure", - "members":{ - "ConfigurationRecordersStatus":{ - "shape":"ConfigurationRecorderStatusList", - "documentation":"

A list that contains status of the specified recorders.

" - } - }, - "documentation":"

The output for the DescribeConfigurationRecorderStatus action, in JSON format.

" - }, - "DescribeConfigurationRecordersRequest":{ - "type":"structure", - "members":{ - "ConfigurationRecorderNames":{ - "shape":"ConfigurationRecorderNameList", - "documentation":"

A list of configuration recorder names.

" - } - }, - "documentation":"

The input for the DescribeConfigurationRecorders action.

" - }, - "DescribeConfigurationRecordersResponse":{ - "type":"structure", - "members":{ - "ConfigurationRecorders":{ - "shape":"ConfigurationRecorderList", - "documentation":"

A list that contains the descriptions of the specified configuration recorders.

" - } - }, - "documentation":"

The output for the DescribeConfigurationRecorders action.

" - }, - "DescribeDeliveryChannelStatusRequest":{ - "type":"structure", - "members":{ - "DeliveryChannelNames":{ - "shape":"DeliveryChannelNameList", - "documentation":"

A list of delivery channel names.

" - } - }, - "documentation":"

The input for the DeliveryChannelStatus action.

" - }, - "DescribeDeliveryChannelStatusResponse":{ - "type":"structure", - "members":{ - "DeliveryChannelsStatus":{ - "shape":"DeliveryChannelStatusList", - "documentation":"

A list that contains the status of a specified delivery channel.

" - } - }, - "documentation":"

The output for the DescribeDeliveryChannelStatus action.

" - }, - "DescribeDeliveryChannelsRequest":{ - "type":"structure", - "members":{ - "DeliveryChannelNames":{ - "shape":"DeliveryChannelNameList", - "documentation":"

A list of delivery channel names.

" - } - }, - "documentation":"

The input for the DescribeDeliveryChannels action.

" - }, - "DescribeDeliveryChannelsResponse":{ - "type":"structure", - "members":{ - "DeliveryChannels":{ - "shape":"DeliveryChannelList", - "documentation":"

A list that contains the descriptions of the specified delivery channel.

" - } - }, - "documentation":"

The output for the DescribeDeliveryChannels action.

" - }, - "DescribePendingAggregationRequestsLimit":{ - "type":"integer", - "max":20, - "min":0 - }, - "DescribePendingAggregationRequestsRequest":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"DescribePendingAggregationRequestsLimit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is maximum. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribePendingAggregationRequestsResponse":{ - "type":"structure", - "members":{ - "PendingAggregationRequests":{ - "shape":"PendingAggregationRequestList", - "documentation":"

Returns a PendingAggregationRequests object.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeRetentionConfigurationsRequest":{ - "type":"structure", - "members":{ - "RetentionConfigurationNames":{ - "shape":"RetentionConfigurationNameList", - "documentation":"

A list of names of retention configurations for which you want details. If you do not specify a name, AWS Config returns details for all the retention configurations for that account.

Currently, AWS Config supports only one retention configuration per region in your account.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "DescribeRetentionConfigurationsResponse":{ - "type":"structure", - "members":{ - "RetentionConfigurations":{ - "shape":"RetentionConfigurationList", - "documentation":"

Returns a retention configuration object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "EarlierTime":{"type":"timestamp"}, - "EmptiableStringWithCharLimit256":{ - "type":"string", - "max":256, - "min":0 - }, - "Evaluation":{ - "type":"structure", - "required":[ - "ComplianceResourceType", - "ComplianceResourceId", - "ComplianceType", - "OrderingTimestamp" - ], - "members":{ - "ComplianceResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The type of AWS resource that was evaluated.

" - }, - "ComplianceResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the AWS resource that was evaluated.

" - }, - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

Indicates whether the AWS resource complies with the AWS Config rule that it was evaluated against.

For the Evaluation data type, AWS Config supports only the COMPLIANT, NON_COMPLIANT, and NOT_APPLICABLE values. AWS Config does not support the INSUFFICIENT_DATA value for this data type.

Similarly, AWS Config does not accept INSUFFICIENT_DATA as the value for ComplianceType from a PutEvaluations request. For example, an AWS Lambda function for a custom AWS Config rule cannot pass an INSUFFICIENT_DATA value to AWS Config.

" - }, - "Annotation":{ - "shape":"StringWithCharLimit256", - "documentation":"

Supplementary information about how the evaluation determined the compliance.

" - }, - "OrderingTimestamp":{ - "shape":"OrderingTimestamp", - "documentation":"

The time of the event in AWS Config that triggered the evaluation. For event-based evaluations, the time indicates when AWS Config created the configuration item that triggered the evaluation. For periodic evaluations, the time indicates when AWS Config triggered the evaluation at the frequency that you specified (for example, every 24 hours).

" - } - }, - "documentation":"

Identifies an AWS resource and indicates whether it complies with the AWS Config rule that it was evaluated against.

" - }, - "EvaluationResult":{ - "type":"structure", - "members":{ - "EvaluationResultIdentifier":{ - "shape":"EvaluationResultIdentifier", - "documentation":"

Uniquely identifies the evaluation result.

" - }, - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

Indicates whether the AWS resource complies with the AWS Config rule that evaluated it.

For the EvaluationResult data type, AWS Config supports only the COMPLIANT, NON_COMPLIANT, and NOT_APPLICABLE values. AWS Config does not support the INSUFFICIENT_DATA value for the EvaluationResult data type.

" - }, - "ResultRecordedTime":{ - "shape":"Date", - "documentation":"

The time when AWS Config recorded the evaluation result.

" - }, - "ConfigRuleInvokedTime":{ - "shape":"Date", - "documentation":"

The time when the AWS Config rule evaluated the AWS resource.

" - }, - "Annotation":{ - "shape":"StringWithCharLimit256", - "documentation":"

Supplementary information about how the evaluation determined the compliance.

" - }, - "ResultToken":{ - "shape":"String", - "documentation":"

An encrypted token that associates an evaluation with an AWS Config rule. The token identifies the rule, the AWS resource being evaluated, and the event that triggered the evaluation.

" - } - }, - "documentation":"

The details of an AWS Config evaluation. Provides the AWS resource that was evaluated, the compliance of the resource, related time stamps, and supplementary information.

" - }, - "EvaluationResultIdentifier":{ - "type":"structure", - "members":{ - "EvaluationResultQualifier":{ - "shape":"EvaluationResultQualifier", - "documentation":"

Identifies an AWS Config rule used to evaluate an AWS resource, and provides the type and ID of the evaluated resource.

" - }, - "OrderingTimestamp":{ - "shape":"Date", - "documentation":"

The time of the event that triggered the evaluation of your AWS resources. The time can indicate when AWS Config delivered a configuration item change notification, or it can indicate when AWS Config delivered the configuration snapshot, depending on which event triggered the evaluation.

" - } - }, - "documentation":"

Uniquely identifies an evaluation result.

" - }, - "EvaluationResultQualifier":{ - "type":"structure", - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule that was used in the evaluation.

" - }, - "ResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The type of AWS resource that was evaluated.

" - }, - "ResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the evaluated AWS resource.

" - } - }, - "documentation":"

Identifies an AWS Config rule that evaluated an AWS resource, and provides the type and ID of the resource that the rule evaluated.

" - }, - "EvaluationResults":{ - "type":"list", - "member":{"shape":"EvaluationResult"} - }, - "Evaluations":{ - "type":"list", - "member":{"shape":"Evaluation"}, - "max":100, - "min":0 - }, - "EventSource":{ - "type":"string", - "enum":["aws.config"] - }, - "GetAggregateComplianceDetailsByConfigRuleRequest":{ - "type":"structure", - "required":[ - "ConfigurationAggregatorName", - "ConfigRuleName", - "AccountId", - "AwsRegion" - ], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - }, - "ConfigRuleName":{ - "shape":"ConfigRuleName", - "documentation":"

The name of the AWS Config rule for which you want compliance information.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the source account.

" - }, - "AwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The source region from where the data is aggregated.

" - }, - "ComplianceType":{ - "shape":"ComplianceType", - "documentation":"

The resource compliance status.

For the GetAggregateComplianceDetailsByConfigRuleRequest data type, AWS Config supports only the COMPLIANT and NON_COMPLIANT. AWS Config does not support the NOT_APPLICABLE and INSUFFICIENT_DATA values.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is 50. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "GetAggregateComplianceDetailsByConfigRuleResponse":{ - "type":"structure", - "members":{ - "AggregateEvaluationResults":{ - "shape":"AggregateEvaluationResultList", - "documentation":"

Returns an AggregateEvaluationResults object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "GetAggregateConfigRuleComplianceSummaryRequest":{ - "type":"structure", - "required":["ConfigurationAggregatorName"], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - }, - "Filters":{ - "shape":"ConfigRuleComplianceSummaryFilters", - "documentation":"

Filters the results based on the ConfigRuleComplianceSummaryFilters object.

" - }, - "GroupByKey":{ - "shape":"ConfigRuleComplianceSummaryGroupKey", - "documentation":"

Groups the result based on ACCOUNT_ID or AWS_REGION.

" - }, - "Limit":{ - "shape":"GroupByAPILimit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is 1000. You cannot specify a number greater than 1000. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "GetAggregateConfigRuleComplianceSummaryResponse":{ - "type":"structure", - "members":{ - "GroupByKey":{ - "shape":"StringWithCharLimit256", - "documentation":"

Groups the result based on ACCOUNT_ID or AWS_REGION.

" - }, - "AggregateComplianceCounts":{ - "shape":"AggregateComplianceCountList", - "documentation":"

Returns a list of AggregateComplianceCounts object.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "GetComplianceDetailsByConfigRuleRequest":{ - "type":"structure", - "required":["ConfigRuleName"], - "members":{ - "ConfigRuleName":{ - "shape":"StringWithCharLimit64", - "documentation":"

The name of the AWS Config rule for which you want compliance information.

" - }, - "ComplianceTypes":{ - "shape":"ComplianceTypes", - "documentation":"

Filters the results by compliance.

The allowed values are COMPLIANT, NON_COMPLIANT, and NOT_APPLICABLE.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of evaluation results returned on each page. The default is 10. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "GetComplianceDetailsByConfigRuleResponse":{ - "type":"structure", - "members":{ - "EvaluationResults":{ - "shape":"EvaluationResults", - "documentation":"

Indicates whether the AWS resource complies with the specified AWS Config rule.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "GetComplianceDetailsByResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId" - ], - "members":{ - "ResourceType":{ - "shape":"StringWithCharLimit256", - "documentation":"

The type of the AWS resource for which you want compliance information.

" - }, - "ResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the AWS resource for which you want compliance information.

" - }, - "ComplianceTypes":{ - "shape":"ComplianceTypes", - "documentation":"

Filters the results by compliance.

The allowed values are COMPLIANT, NON_COMPLIANT, and NOT_APPLICABLE.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "GetComplianceDetailsByResourceResponse":{ - "type":"structure", - "members":{ - "EvaluationResults":{ - "shape":"EvaluationResults", - "documentation":"

Indicates whether the specified AWS resource complies each AWS Config rule.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "GetComplianceSummaryByConfigRuleResponse":{ - "type":"structure", - "members":{ - "ComplianceSummary":{ - "shape":"ComplianceSummary", - "documentation":"

The number of AWS Config rules that are compliant and the number that are noncompliant, up to a maximum of 25 for each.

" - } - }, - "documentation":"

" - }, - "GetComplianceSummaryByResourceTypeRequest":{ - "type":"structure", - "members":{ - "ResourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

Specify one or more resource types to get the number of resources that are compliant and the number that are noncompliant for each resource type.

For this request, you can specify an AWS resource type such as AWS::EC2::Instance. You can specify that the resource type is an AWS account by specifying AWS::::Account.

" - } - }, - "documentation":"

" - }, - "GetComplianceSummaryByResourceTypeResponse":{ - "type":"structure", - "members":{ - "ComplianceSummariesByResourceType":{ - "shape":"ComplianceSummariesByResourceType", - "documentation":"

The number of resources that are compliant and the number that are noncompliant. If one or more resource types were provided with the request, the numbers are returned for each resource type. The maximum number returned is 100.

" - } - }, - "documentation":"

" - }, - "GetDiscoveredResourceCountsRequest":{ - "type":"structure", - "members":{ - "resourceTypes":{ - "shape":"ResourceTypes", - "documentation":"

The comma-separated list that specifies the resource types that you want AWS Config to return (for example, \"AWS::EC2::Instance\", \"AWS::IAM::User\").

If a value for resourceTypes is not specified, AWS Config returns all resource types that AWS Config is recording in the region for your account.

If the configuration recorder is turned off, AWS Config returns an empty list of ResourceCount objects. If the configuration recorder is not recording a specific resource type (for example, S3 buckets), that resource type is not returned in the list of ResourceCount objects.

" - }, - "limit":{ - "shape":"Limit", - "documentation":"

The maximum number of ResourceCount objects returned on each page. The default is 100. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - } - }, - "GetDiscoveredResourceCountsResponse":{ - "type":"structure", - "members":{ - "totalDiscoveredResources":{ - "shape":"Long", - "documentation":"

The total number of resources that AWS Config is recording in the region for your account. If you specify resource types in the request, AWS Config returns only the total number of resources for those resource types.

Example

  1. AWS Config is recording three resource types in the US East (Ohio) Region for your account: 25 EC2 instances, 20 IAM users, and 15 S3 buckets, for a total of 60 resources.

  2. You make a call to the GetDiscoveredResourceCounts action and specify the resource type, \"AWS::EC2::Instances\", in the request.

  3. AWS Config returns 25 for totalDiscoveredResources.

" - }, - "resourceCounts":{ - "shape":"ResourceCounts", - "documentation":"

The list of ResourceCount objects. Each object is listed in descending order by the number of resources.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - } - }, - "GetResourceConfigHistoryRequest":{ - "type":"structure", - "required":[ - "resourceType", - "resourceId" - ], - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the resource (for example., sg-xxxxxx).

" - }, - "laterTime":{ - "shape":"LaterTime", - "documentation":"

The time stamp that indicates a later time. If not specified, current time is taken.

" - }, - "earlierTime":{ - "shape":"EarlierTime", - "documentation":"

The time stamp that indicates an earlier time. If not specified, the action returns paginated results that contain configuration items that start when the first configuration item was recorded.

" - }, - "chronologicalOrder":{ - "shape":"ChronologicalOrder", - "documentation":"

The chronological order for configuration items listed. By default, the results are listed in reverse chronological order.

" - }, - "limit":{ - "shape":"Limit", - "documentation":"

The maximum number of configuration items returned on each page. The default is 10. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

The input for the GetResourceConfigHistory action.

" - }, - "GetResourceConfigHistoryResponse":{ - "type":"structure", - "members":{ - "configurationItems":{ - "shape":"ConfigurationItemList", - "documentation":"

A list that contains the configuration history of one or more resources.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

The output for the GetResourceConfigHistory action.

" - }, - "GroupByAPILimit":{ - "type":"integer", - "max":1000, - "min":0 - }, - "IncludeGlobalResourceTypes":{"type":"boolean"}, - "InsufficientDeliveryPolicyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Your Amazon S3 bucket policy does not permit AWS Config to write to it.

", - "exception":true - }, - "InsufficientPermissionsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates one of the following errors:

  • The rule cannot be created because the IAM role assigned to AWS Config lacks permissions to perform the config:Put* action.

  • The AWS Lambda function cannot be invoked. Check the function ARN, and check the function's permissions.

", - "exception":true - }, - "Integer":{"type":"integer"}, - "InvalidConfigurationRecorderNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have provided a configuration recorder name that is not valid.

", - "exception":true - }, - "InvalidDeliveryChannelNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified delivery channel name is not valid.

", - "exception":true - }, - "InvalidLimitException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified limit is outside the allowable range.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified next token is invalid. Specify the nextToken string that was returned in the previous response to get the next page of results.

", - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more of the specified parameters are invalid. Verify that your parameters are valid and try again.

", - "exception":true - }, - "InvalidRecordingGroupException":{ - "type":"structure", - "members":{ - }, - "documentation":"

AWS Config throws an exception if the recording group does not contain a valid list of resource types. Invalid values might also be incorrectly formatted.

", - "exception":true - }, - "InvalidResultTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified ResultToken is invalid.

", - "exception":true - }, - "InvalidRoleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have provided a null or empty role ARN.

", - "exception":true - }, - "InvalidS3KeyPrefixException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon S3 key prefix is not valid.

", - "exception":true - }, - "InvalidSNSTopicARNException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon SNS topic does not exist.

", - "exception":true - }, - "InvalidTimeRangeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified time range is not valid. The earlier time is not chronologically before the later time.

", - "exception":true - }, - "LastDeliveryChannelDeleteFailedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot delete the delivery channel you specified because the configuration recorder is running.

", - "exception":true - }, - "LaterTime":{"type":"timestamp"}, - "Limit":{ - "type":"integer", - "max":100, - "min":0 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception is thrown if an evaluation is in progress or if you call the StartConfigRulesEvaluation API more than once per minute.

", - "exception":true - }, - "ListDiscoveredResourcesRequest":{ - "type":"structure", - "required":["resourceType"], - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resources that you want AWS Config to list in the response.

" - }, - "resourceIds":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The custom name of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

" - }, - "limit":{ - "shape":"Limit", - "documentation":"

The maximum number of resource identifiers returned on each page. The default is 100. You cannot specify a number greater than 100. If you specify 0, AWS Config uses the default.

" - }, - "includeDeletedResources":{ - "shape":"Boolean", - "documentation":"

Specifies whether AWS Config includes deleted resources in the results. By default, deleted resources are not included.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "ListDiscoveredResourcesResponse":{ - "type":"structure", - "members":{ - "resourceIdentifiers":{ - "shape":"ResourceIdentifierList", - "documentation":"

The details that identify a resource that is discovered by AWS Config, including the resource type, ID, and (if available) the custom resource name.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The string that you use in a subsequent request to get the next page of results in a paginated response.

" - } - }, - "documentation":"

" - }, - "Long":{"type":"long"}, - "MaxNumberOfConfigRulesExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Failed to add the AWS Config rule because the account already contains the maximum number of 50 rules. Consider deleting any deactivated rules before you add new rules.

", - "exception":true - }, - "MaxNumberOfConfigurationRecordersExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have reached the limit of the number of recorders you can create.

", - "exception":true - }, - "MaxNumberOfDeliveryChannelsExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have reached the limit of the number of delivery channels you can create.

", - "exception":true - }, - "MaxNumberOfRetentionConfigurationsExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Failed to add the retention configuration because a retention configuration with that name already exists.

", - "exception":true - }, - "MaximumExecutionFrequency":{ - "type":"string", - "enum":[ - "One_Hour", - "Three_Hours", - "Six_Hours", - "Twelve_Hours", - "TwentyFour_Hours" - ] - }, - "MessageType":{ - "type":"string", - "enum":[ - "ConfigurationItemChangeNotification", - "ConfigurationSnapshotDeliveryCompleted", - "ScheduledNotification", - "OversizedConfigurationItemChangeNotification" - ] - }, - "Name":{"type":"string"}, - "NextToken":{"type":"string"}, - "NoAvailableConfigurationRecorderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There are no configuration recorders available to provide the role needed to describe your resources. Create a configuration recorder.

", - "exception":true - }, - "NoAvailableDeliveryChannelException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is no delivery channel available to record configurations.

", - "exception":true - }, - "NoAvailableOrganizationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Organization does is no longer available.

", - "exception":true - }, - "NoRunningConfigurationRecorderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is no configuration recorder running.

", - "exception":true - }, - "NoSuchBucketException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon S3 bucket does not exist.

", - "exception":true - }, - "NoSuchConfigRuleException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more AWS Config rules in the request are invalid. Verify that the rule names are correct and try again.

", - "exception":true - }, - "NoSuchConfigurationAggregatorException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have specified a configuration aggregator that does not exist.

", - "exception":true - }, - "NoSuchConfigurationRecorderException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have specified a configuration recorder that does not exist.

", - "exception":true - }, - "NoSuchDeliveryChannelException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have specified a delivery channel that does not exist.

", - "exception":true - }, - "NoSuchRetentionConfigurationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have specified a retention configuration that does not exist.

", - "exception":true - }, - "OrderingTimestamp":{"type":"timestamp"}, - "OrganizationAccessDeniedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

No permission to call the EnableAWSServiceAccess API.

", - "exception":true - }, - "OrganizationAggregationSource":{ - "type":"structure", - "required":["RoleArn"], - "members":{ - "RoleArn":{ - "shape":"String", - "documentation":"

ARN of the IAM role used to retreive AWS Organization details associated with the aggregator account.

" - }, - "AwsRegions":{ - "shape":"AggregatorRegionList", - "documentation":"

The source regions being aggregated.

" - }, - "AllAwsRegions":{ - "shape":"Boolean", - "documentation":"

If true, aggregate existing AWS Config regions and future regions.

" - } - }, - "documentation":"

This object contains regions to setup the aggregator and an IAM role to retrieve organization details.

" - }, - "OrganizationAllFeaturesNotEnabledException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The configuration aggregator cannot be created because organization does not have all features enabled.

", - "exception":true - }, - "Owner":{ - "type":"string", - "enum":[ - "CUSTOM_LAMBDA", - "AWS" - ] - }, - "PendingAggregationRequest":{ - "type":"structure", - "members":{ - "RequesterAccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the account requesting to aggregate data.

" - }, - "RequesterAwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region requesting to aggregate data.

" - } - }, - "documentation":"

An object that represents the account ID and region of an aggregator account that is requesting authorization but is not yet authorized.

" - }, - "PendingAggregationRequestList":{ - "type":"list", - "member":{"shape":"PendingAggregationRequest"} - }, - "PutAggregationAuthorizationRequest":{ - "type":"structure", - "required":[ - "AuthorizedAccountId", - "AuthorizedAwsRegion" - ], - "members":{ - "AuthorizedAccountId":{ - "shape":"AccountId", - "documentation":"

The 12-digit account ID of the account authorized to aggregate data.

" - }, - "AuthorizedAwsRegion":{ - "shape":"AwsRegion", - "documentation":"

The region authorized to collect aggregated data.

" - } - } - }, - "PutAggregationAuthorizationResponse":{ - "type":"structure", - "members":{ - "AggregationAuthorization":{ - "shape":"AggregationAuthorization", - "documentation":"

Returns an AggregationAuthorization object.

" - } - } - }, - "PutConfigRuleRequest":{ - "type":"structure", - "required":["ConfigRule"], - "members":{ - "ConfigRule":{ - "shape":"ConfigRule", - "documentation":"

The rule that you want to add to your account.

" - } - } - }, - "PutConfigurationAggregatorRequest":{ - "type":"structure", - "required":["ConfigurationAggregatorName"], - "members":{ - "ConfigurationAggregatorName":{ - "shape":"ConfigurationAggregatorName", - "documentation":"

The name of the configuration aggregator.

" - }, - "AccountAggregationSources":{ - "shape":"AccountAggregationSourceList", - "documentation":"

A list of AccountAggregationSource object.

" - }, - "OrganizationAggregationSource":{ - "shape":"OrganizationAggregationSource", - "documentation":"

An OrganizationAggregationSource object.

" - } - } - }, - "PutConfigurationAggregatorResponse":{ - "type":"structure", - "members":{ - "ConfigurationAggregator":{ - "shape":"ConfigurationAggregator", - "documentation":"

Returns a ConfigurationAggregator object.

" - } - } - }, - "PutConfigurationRecorderRequest":{ - "type":"structure", - "required":["ConfigurationRecorder"], - "members":{ - "ConfigurationRecorder":{ - "shape":"ConfigurationRecorder", - "documentation":"

The configuration recorder object that records each configuration change made to the resources.

" - } - }, - "documentation":"

The input for the PutConfigurationRecorder action.

" - }, - "PutDeliveryChannelRequest":{ - "type":"structure", - "required":["DeliveryChannel"], - "members":{ - "DeliveryChannel":{ - "shape":"DeliveryChannel", - "documentation":"

The configuration delivery channel object that delivers the configuration information to an Amazon S3 bucket and to an Amazon SNS topic.

" - } - }, - "documentation":"

The input for the PutDeliveryChannel action.

" - }, - "PutEvaluationsRequest":{ - "type":"structure", - "required":["ResultToken"], - "members":{ - "Evaluations":{ - "shape":"Evaluations", - "documentation":"

The assessments that the AWS Lambda function performs. Each evaluation identifies an AWS resource and indicates whether it complies with the AWS Config rule that invokes the AWS Lambda function.

" - }, - "ResultToken":{ - "shape":"String", - "documentation":"

An encrypted token that associates an evaluation with an AWS Config rule. Identifies the rule and the event that triggered the evaluation.

" - }, - "TestMode":{ - "shape":"Boolean", - "documentation":"

Use this parameter to specify a test run for PutEvaluations. You can verify whether your AWS Lambda function will deliver evaluation results to AWS Config. No updates occur to your existing evaluations, and evaluation results are not sent to AWS Config.

When TestMode is true, PutEvaluations doesn't require a valid value for the ResultToken parameter, but the value cannot be null.

" - } - }, - "documentation":"

" - }, - "PutEvaluationsResponse":{ - "type":"structure", - "members":{ - "FailedEvaluations":{ - "shape":"Evaluations", - "documentation":"

Requests that failed because of a client or server error.

" - } - }, - "documentation":"

" - }, - "PutRetentionConfigurationRequest":{ - "type":"structure", - "required":["RetentionPeriodInDays"], - "members":{ - "RetentionPeriodInDays":{ - "shape":"RetentionPeriodInDays", - "documentation":"

Number of days AWS Config stores your historical information.

Currently, only applicable to the configuration item history.

" - } - } - }, - "PutRetentionConfigurationResponse":{ - "type":"structure", - "members":{ - "RetentionConfiguration":{ - "shape":"RetentionConfiguration", - "documentation":"

Returns a retention configuration object.

" - } - } - }, - "RecorderName":{ - "type":"string", - "max":256, - "min":1 - }, - "RecorderStatus":{ - "type":"string", - "enum":[ - "Pending", - "Success", - "Failure" - ] - }, - "RecordingGroup":{ - "type":"structure", - "members":{ - "allSupported":{ - "shape":"AllSupported", - "documentation":"

Specifies whether AWS Config records configuration changes for every supported type of regional resource.

If you set this option to true, when AWS Config adds support for a new type of regional resource, it starts recording resources of that type automatically.

If you set this option to true, you cannot enumerate a list of resourceTypes.

" - }, - "includeGlobalResourceTypes":{ - "shape":"IncludeGlobalResourceTypes", - "documentation":"

Specifies whether AWS Config includes all supported types of global resources (for example, IAM resources) with the resources that it records.

Before you can set this option to true, you must set the allSupported option to true.

If you set this option to true, when AWS Config adds support for a new type of global resource, it starts recording resources of that type automatically.

The configuration details for any global resource are the same in all regions. To prevent duplicate configuration items, you should consider customizing AWS Config in only one region to record global resources.

" - }, - "resourceTypes":{ - "shape":"ResourceTypeList", - "documentation":"

A comma-separated list that specifies the types of AWS resources for which AWS Config records configuration changes (for example, AWS::EC2::Instance or AWS::CloudTrail::Trail).

Before you can set this option to true, you must set the allSupported option to false.

If you set this option to true, when AWS Config adds support for a new type of resource, it will not record resources of that type unless you manually add that type to your recording group.

For a list of valid resourceTypes values, see the resourceType Value column in Supported AWS Resource Types.

" - } - }, - "documentation":"

Specifies the types of AWS resource for which AWS Config records configuration changes.

In the recording group, you specify whether all supported types or specific types of resources are recorded.

By default, AWS Config records configuration changes for all supported types of regional resources that AWS Config discovers in the region in which it is running. Regional resources are tied to a region and can be used only in that region. Examples of regional resources are EC2 instances and EBS volumes.

You can also have AWS Config record configuration changes for supported types of global resources (for example, IAM resources). Global resources are not tied to an individual region and can be used in all regions.

The configuration details for any global resource are the same in all regions. If you customize AWS Config in multiple regions to record global resources, it will create multiple configuration items each time a global resource changes: one configuration item for each region. These configuration items will contain identical data. To prevent duplicate configuration items, you should consider customizing AWS Config in only one region to record global resources, unless you want the configuration items to be available in multiple regions.

If you don't want AWS Config to record all resources, you can specify which types of resources it will record with the resourceTypes parameter.

For a list of supported resource types, see Supported Resource Types.

For more information, see Selecting Which Resources AWS Config Records.

" - }, - "ReevaluateConfigRuleNames":{ - "type":"list", - "member":{"shape":"StringWithCharLimit64"}, - "max":25, - "min":1 - }, - "RelatedEvent":{"type":"string"}, - "RelatedEventList":{ - "type":"list", - "member":{"shape":"RelatedEvent"} - }, - "Relationship":{ - "type":"structure", - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type of the related resource.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the related resource (for example, sg-xxxxxx).

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The custom name of the related resource, if available.

" - }, - "relationshipName":{ - "shape":"RelationshipName", - "documentation":"

The type of relationship with the related resource.

" - } - }, - "documentation":"

The relationship of the related resource to the main resource.

" - }, - "RelationshipList":{ - "type":"list", - "member":{"shape":"Relationship"} - }, - "RelationshipName":{"type":"string"}, - "ResourceCount":{ - "type":"structure", - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type (for example, \"AWS::EC2::Instance\").

" - }, - "count":{ - "shape":"Long", - "documentation":"

The number of resources.

" - } - }, - "documentation":"

An object that contains the resource type and the number of resources.

" - }, - "ResourceCounts":{ - "type":"list", - "member":{"shape":"ResourceCount"} - }, - "ResourceCreationTime":{"type":"timestamp"}, - "ResourceDeletionTime":{"type":"timestamp"}, - "ResourceId":{ - "type":"string", - "max":768, - "min":1 - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"ResourceId"} - }, - "ResourceIdentifier":{ - "type":"structure", - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the resource (for example, sg-xxxxxx).

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The custom name of the resource (if available).

" - }, - "resourceDeletionTime":{ - "shape":"ResourceDeletionTime", - "documentation":"

The time that the resource was deleted.

" - } - }, - "documentation":"

The details that identify a resource that is discovered by AWS Config, including the resource type, ID, and (if available) the custom resource name.

" - }, - "ResourceIdentifierList":{ - "type":"list", - "member":{"shape":"ResourceIdentifier"} - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The rule is currently being deleted or the rule is deleting your evaluation results. Try your request again later.

", - "exception":true - }, - "ResourceKey":{ - "type":"structure", - "required":[ - "resourceType", - "resourceId" - ], - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

" - }, - "resourceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the resource (for example., sg-xxxxxx).

" - } - }, - "documentation":"

The details that identify a resource within AWS Config, including the resource type and resource ID.

" - }, - "ResourceKeys":{ - "type":"list", - "member":{"shape":"ResourceKey"}, - "max":100, - "min":1 - }, - "ResourceName":{"type":"string"}, - "ResourceNotDiscoveredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have specified a resource that is either unknown or has not been discovered.

", - "exception":true - }, - "ResourceType":{ - "type":"string", - "enum":[ - "AWS::EC2::CustomerGateway", - "AWS::EC2::EIP", - "AWS::EC2::Host", - "AWS::EC2::Instance", - "AWS::EC2::InternetGateway", - "AWS::EC2::NetworkAcl", - "AWS::EC2::NetworkInterface", - "AWS::EC2::RouteTable", - "AWS::EC2::SecurityGroup", - "AWS::EC2::Subnet", - "AWS::CloudTrail::Trail", - "AWS::EC2::Volume", - "AWS::EC2::VPC", - "AWS::EC2::VPNConnection", - "AWS::EC2::VPNGateway", - "AWS::IAM::Group", - "AWS::IAM::Policy", - "AWS::IAM::Role", - "AWS::IAM::User", - "AWS::ACM::Certificate", - "AWS::RDS::DBInstance", - "AWS::RDS::DBSubnetGroup", - "AWS::RDS::DBSecurityGroup", - "AWS::RDS::DBSnapshot", - "AWS::RDS::EventSubscription", - "AWS::ElasticLoadBalancingV2::LoadBalancer", - "AWS::S3::Bucket", - "AWS::SSM::ManagedInstanceInventory", - "AWS::Redshift::Cluster", - "AWS::Redshift::ClusterSnapshot", - "AWS::Redshift::ClusterParameterGroup", - "AWS::Redshift::ClusterSecurityGroup", - "AWS::Redshift::ClusterSubnetGroup", - "AWS::Redshift::EventSubscription", - "AWS::CloudWatch::Alarm", - "AWS::CloudFormation::Stack", - "AWS::DynamoDB::Table", - "AWS::AutoScaling::AutoScalingGroup", - "AWS::AutoScaling::LaunchConfiguration", - "AWS::AutoScaling::ScalingPolicy", - "AWS::AutoScaling::ScheduledAction", - "AWS::CodeBuild::Project", - "AWS::WAF::RateBasedRule", - "AWS::WAF::Rule", - "AWS::WAF::WebACL", - "AWS::WAFRegional::RateBasedRule", - "AWS::WAFRegional::Rule", - "AWS::WAFRegional::WebACL", - "AWS::CloudFront::Distribution", - "AWS::CloudFront::StreamingDistribution", - "AWS::WAF::RuleGroup", - "AWS::WAFRegional::RuleGroup", - "AWS::Lambda::Function", - "AWS::ElasticBeanstalk::Application", - "AWS::ElasticBeanstalk::ApplicationVersion", - "AWS::ElasticBeanstalk::Environment", - "AWS::ElasticLoadBalancing::LoadBalancer", - "AWS::XRay::EncryptionConfig" - ] - }, - "ResourceTypeList":{ - "type":"list", - "member":{"shape":"ResourceType"} - }, - "ResourceTypes":{ - "type":"list", - "member":{"shape":"StringWithCharLimit256"}, - "max":20, - "min":0 - }, - "RetentionConfiguration":{ - "type":"structure", - "required":[ - "Name", - "RetentionPeriodInDays" - ], - "members":{ - "Name":{ - "shape":"RetentionConfigurationName", - "documentation":"

The name of the retention configuration object.

" - }, - "RetentionPeriodInDays":{ - "shape":"RetentionPeriodInDays", - "documentation":"

Number of days AWS Config stores your historical information.

Currently, only applicable to the configuration item history.

" - } - }, - "documentation":"

An object with the name of the retention configuration and the retention period in days. The object stores the configuration for data retention in AWS Config.

" - }, - "RetentionConfigurationList":{ - "type":"list", - "member":{"shape":"RetentionConfiguration"} - }, - "RetentionConfigurationName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w\\-]+" - }, - "RetentionConfigurationNameList":{ - "type":"list", - "member":{"shape":"RetentionConfigurationName"}, - "max":1, - "min":0 - }, - "RetentionPeriodInDays":{ - "type":"integer", - "max":2557, - "min":30 - }, - "RuleLimit":{ - "type":"integer", - "max":50, - "min":0 - }, - "Scope":{ - "type":"structure", - "members":{ - "ComplianceResourceTypes":{ - "shape":"ComplianceResourceTypes", - "documentation":"

The resource types of only those AWS resources that you want to trigger an evaluation for the rule. You can only specify one type if you also specify a resource ID for ComplianceResourceId.

" - }, - "TagKey":{ - "shape":"StringWithCharLimit128", - "documentation":"

The tag key that is applied to only those AWS resources that you want to trigger an evaluation for the rule.

" - }, - "TagValue":{ - "shape":"StringWithCharLimit256", - "documentation":"

The tag value applied to only those AWS resources that you want to trigger an evaluation for the rule. If you specify a value for TagValue, you must also specify a value for TagKey.

" - }, - "ComplianceResourceId":{ - "shape":"BaseResourceId", - "documentation":"

The ID of the only AWS resource that you want to trigger an evaluation for the rule. If you specify a resource ID, you must specify one resource type for ComplianceResourceTypes.

" - } - }, - "documentation":"

Defines which resources trigger an evaluation for an AWS Config rule. The scope can include one or more resource types, a combination of a tag key and value, or a combination of one resource type and one resource ID. Specify a scope to constrain which resources trigger an evaluation for a rule. Otherwise, evaluations for the rule are triggered when any resource in your recording group changes in configuration.

" - }, - "Source":{ - "type":"structure", - "required":[ - "Owner", - "SourceIdentifier" - ], - "members":{ - "Owner":{ - "shape":"Owner", - "documentation":"

Indicates whether AWS or the customer owns and manages the AWS Config rule.

" - }, - "SourceIdentifier":{ - "shape":"StringWithCharLimit256", - "documentation":"

For AWS Config managed rules, a predefined identifier from a list. For example, IAM_PASSWORD_POLICY is a managed rule. To reference a managed rule, see Using AWS Managed Config Rules.

For custom rules, the identifier is the Amazon Resource Name (ARN) of the rule's AWS Lambda function, such as arn:aws:lambda:us-east-2:123456789012:function:custom_rule_name.

" - }, - "SourceDetails":{ - "shape":"SourceDetails", - "documentation":"

Provides the source and type of the event that causes AWS Config to evaluate your AWS resources.

" - } - }, - "documentation":"

Provides the AWS Config rule owner (AWS or customer), the rule identifier, and the events that trigger the evaluation of your AWS resources.

" - }, - "SourceDetail":{ - "type":"structure", - "members":{ - "EventSource":{ - "shape":"EventSource", - "documentation":"

The source of the event, such as an AWS service, that triggers AWS Config to evaluate your AWS resources.

" - }, - "MessageType":{ - "shape":"MessageType", - "documentation":"

The type of notification that triggers AWS Config to run an evaluation for a rule. You can specify the following notification types:

  • ConfigurationItemChangeNotification - Triggers an evaluation when AWS Config delivers a configuration item as a result of a resource change.

  • OversizedConfigurationItemChangeNotification - Triggers an evaluation when AWS Config delivers an oversized configuration item. AWS Config may generate this notification type when a resource changes and the notification exceeds the maximum size allowed by Amazon SNS.

  • ScheduledNotification - Triggers a periodic evaluation at the frequency specified for MaximumExecutionFrequency.

  • ConfigurationSnapshotDeliveryCompleted - Triggers a periodic evaluation when AWS Config delivers a configuration snapshot.

If you want your custom rule to be triggered by configuration changes, specify two SourceDetail objects, one for ConfigurationItemChangeNotification and one for OversizedConfigurationItemChangeNotification.

" - }, - "MaximumExecutionFrequency":{ - "shape":"MaximumExecutionFrequency", - "documentation":"

The frequency at which you want AWS Config to run evaluations for a custom rule with a periodic trigger. If you specify a value for MaximumExecutionFrequency, then MessageType must use the ScheduledNotification value.

By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the MaximumExecutionFrequency parameter.

Based on the valid value you choose, AWS Config runs evaluations once for each valid value. For example, if you choose Three_Hours, AWS Config runs evaluations once every three hours. In this case, Three_Hours is the frequency of this rule.

" - } - }, - "documentation":"

Provides the source and the message types that trigger AWS Config to evaluate your AWS resources against a rule. It also provides the frequency with which you want AWS Config to run evaluations for the rule if the trigger type is periodic. You can specify the parameter values for SourceDetail only for custom rules.

" - }, - "SourceDetails":{ - "type":"list", - "member":{"shape":"SourceDetail"}, - "max":25, - "min":0 - }, - "StartConfigRulesEvaluationRequest":{ - "type":"structure", - "members":{ - "ConfigRuleNames":{ - "shape":"ReevaluateConfigRuleNames", - "documentation":"

The list of names of AWS Config rules that you want to run evaluations for.

" - } - }, - "documentation":"

" - }, - "StartConfigRulesEvaluationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output when you start the evaluation for the specified AWS Config rule.

" - }, - "StartConfigurationRecorderRequest":{ - "type":"structure", - "required":["ConfigurationRecorderName"], - "members":{ - "ConfigurationRecorderName":{ - "shape":"RecorderName", - "documentation":"

The name of the recorder object that records each configuration change made to the resources.

" - } - }, - "documentation":"

The input for the StartConfigurationRecorder action.

" - }, - "StopConfigurationRecorderRequest":{ - "type":"structure", - "required":["ConfigurationRecorderName"], - "members":{ - "ConfigurationRecorderName":{ - "shape":"RecorderName", - "documentation":"

The name of the recorder object that records each configuration change made to the resources.

" - } - }, - "documentation":"

The input for the StopConfigurationRecorder action.

" - }, - "String":{"type":"string"}, - "StringWithCharLimit1024":{ - "type":"string", - "max":1024, - "min":1 - }, - "StringWithCharLimit128":{ - "type":"string", - "max":128, - "min":1 - }, - "StringWithCharLimit256":{ - "type":"string", - "max":256, - "min":1 - }, - "StringWithCharLimit64":{ - "type":"string", - "max":64, - "min":1 - }, - "SupplementaryConfiguration":{ - "type":"map", - "key":{"shape":"SupplementaryConfigurationName"}, - "value":{"shape":"SupplementaryConfigurationValue"} - }, - "SupplementaryConfigurationName":{"type":"string"}, - "SupplementaryConfigurationValue":{"type":"string"}, - "Tags":{ - "type":"map", - "key":{"shape":"Name"}, - "value":{"shape":"Value"} - }, - "ValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested action is not valid.

", - "exception":true - }, - "Value":{"type":"string"}, - "Version":{"type":"string"} - }, - "documentation":"AWS Config

AWS Config provides a way to keep track of the configurations of all the AWS resources associated with your AWS account. You can use AWS Config to get the current and historical configurations of each AWS resource and also to get information about the relationship between the resources. An AWS resource can be an Amazon Compute Cloud (Amazon EC2) instance, an Elastic Block Store (EBS) volume, an elastic network Interface (ENI), or a security group. For a complete list of resources currently supported by AWS Config, see Supported AWS Resources.

You can access and manage AWS Config through the AWS Management Console, the AWS Command Line Interface (AWS CLI), the AWS Config API, or the AWS SDKs for AWS Config. This reference guide contains documentation for the AWS Config API and the AWS CLI commands that you can use to manage AWS Config. The AWS Config API uses the Signature Version 4 protocol for signing requests. For more information about how to sign a request with this protocol, see Signature Version 4 Signing Process. For detailed information about AWS Config features and their associated actions or commands, as well as how to work with AWS Management Console, see What Is AWS Config in the AWS Config Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/service-2.json deleted file mode 100644 index 3834d251..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/connect/2017-08-08/service-2.json +++ /dev/null @@ -1,1371 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-08-08", - "endpointPrefix":"connect", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"Amazon Connect", - "serviceFullName":"Amazon Connect Service", - "serviceId":"Connect", - "signatureVersion":"v4", - "signingName":"connect", - "uid":"connect-2017-08-08" - }, - "operations":{ - "CreateUser":{ - "name":"CreateUser", - "http":{ - "method":"PUT", - "requestUri":"/users/{InstanceId}" - }, - "input":{"shape":"CreateUserRequest"}, - "output":{"shape":"CreateUserResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"LimitExceededException"}, - {"shape":"DuplicateResourceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Creates a new user account in your Amazon Connect instance.

" - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"DELETE", - "requestUri":"/users/{InstanceId}/{UserId}" - }, - "input":{"shape":"DeleteUserRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deletes a user account from Amazon Connect.

" - }, - "DescribeUser":{ - "name":"DescribeUser", - "http":{ - "method":"GET", - "requestUri":"/users/{InstanceId}/{UserId}" - }, - "input":{"shape":"DescribeUserRequest"}, - "output":{"shape":"DescribeUserResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns a User object that contains information about the user account specified by the UserId.

" - }, - "DescribeUserHierarchyGroup":{ - "name":"DescribeUserHierarchyGroup", - "http":{ - "method":"GET", - "requestUri":"/user-hierarchy-groups/{InstanceId}/{HierarchyGroupId}" - }, - "input":{"shape":"DescribeUserHierarchyGroupRequest"}, - "output":{"shape":"DescribeUserHierarchyGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns a HierarchyGroup object that includes information about a hierarchy group in your instance.

" - }, - "DescribeUserHierarchyStructure":{ - "name":"DescribeUserHierarchyStructure", - "http":{ - "method":"GET", - "requestUri":"/user-hierarchy-structure/{InstanceId}" - }, - "input":{"shape":"DescribeUserHierarchyStructureRequest"}, - "output":{"shape":"DescribeUserHierarchyStructureResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns a HiearchyGroupStructure object, which contains data about the levels in the agent hierarchy.

" - }, - "GetFederationToken":{ - "name":"GetFederationToken", - "http":{ - "method":"GET", - "requestUri":"/user/federate/{InstanceId}" - }, - "input":{"shape":"GetFederationTokenRequest"}, - "output":{"shape":"GetFederationTokenResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"UserNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"DuplicateResourceException"} - ], - "documentation":"

Retrieves a token for federation.

" - }, - "ListRoutingProfiles":{ - "name":"ListRoutingProfiles", - "http":{ - "method":"GET", - "requestUri":"/routing-profiles-summary/{InstanceId}" - }, - "input":{"shape":"ListRoutingProfilesRequest"}, - "output":{"shape":"ListRoutingProfilesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns an array of RoutingProfileSummary objects that includes information about the routing profiles in your instance.

" - }, - "ListSecurityProfiles":{ - "name":"ListSecurityProfiles", - "http":{ - "method":"GET", - "requestUri":"/security-profiles-summary/{InstanceId}" - }, - "input":{"shape":"ListSecurityProfilesRequest"}, - "output":{"shape":"ListSecurityProfilesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns an array of SecurityProfileSummary objects that contain information about the security profiles in your instance, including the ARN, Id, and Name of the security profile.

" - }, - "ListUserHierarchyGroups":{ - "name":"ListUserHierarchyGroups", - "http":{ - "method":"GET", - "requestUri":"/user-hierarchy-groups-summary/{InstanceId}" - }, - "input":{"shape":"ListUserHierarchyGroupsRequest"}, - "output":{"shape":"ListUserHierarchyGroupsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns a UserHierarchyGroupSummaryList, which is an array of HierarchyGroupSummary objects that contain information about the hierarchy groups in your instance.

" - }, - "ListUsers":{ - "name":"ListUsers", - "http":{ - "method":"GET", - "requestUri":"/users-summary/{InstanceId}" - }, - "input":{"shape":"ListUsersRequest"}, - "output":{"shape":"ListUsersResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Returns a UserSummaryList, which is an array of UserSummary objects.

" - }, - "StartOutboundVoiceContact":{ - "name":"StartOutboundVoiceContact", - "http":{ - "method":"PUT", - "requestUri":"/contact/outbound-voice" - }, - "input":{"shape":"StartOutboundVoiceContactRequest"}, - "output":{"shape":"StartOutboundVoiceContactResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"LimitExceededException"}, - {"shape":"DestinationNotAllowedException"}, - {"shape":"OutboundContactNotPermittedException"} - ], - "documentation":"

The StartOutboundVoiceContact operation initiates a contact flow to place an outbound call to a customer.

There is a throttling limit placed on usage of the API that includes a RateLimit of 2 per second, and a BurstLimit of 5 per second.

If you are using an IAM account, it must have permission to the connect:StartOutboundVoiceContact action.

" - }, - "StopContact":{ - "name":"StopContact", - "http":{ - "method":"POST", - "requestUri":"/contact/stop" - }, - "input":{"shape":"StopContactRequest"}, - "output":{"shape":"StopContactResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ContactNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Ends the contact initiated by the StartOutboundVoiceContact operation.

If you are using an IAM account, it must have permission to the connect:StopContact action.

" - }, - "UpdateUserHierarchy":{ - "name":"UpdateUserHierarchy", - "http":{ - "method":"POST", - "requestUri":"/users/{InstanceId}/{UserId}/hierarchy" - }, - "input":{"shape":"UpdateUserHierarchyRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Assigns the specified hierarchy group to the user.

" - }, - "UpdateUserIdentityInfo":{ - "name":"UpdateUserIdentityInfo", - "http":{ - "method":"POST", - "requestUri":"/users/{InstanceId}/{UserId}/identity-info" - }, - "input":{"shape":"UpdateUserIdentityInfoRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Updates the identity information for the specified user in a UserIdentityInfo object, including email, first name, and last name.

" - }, - "UpdateUserPhoneConfig":{ - "name":"UpdateUserPhoneConfig", - "http":{ - "method":"POST", - "requestUri":"/users/{InstanceId}/{UserId}/phone-config" - }, - "input":{"shape":"UpdateUserPhoneConfigRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Updates the phone configuration settings in the UserPhoneConfig object for the specified user.

" - }, - "UpdateUserRoutingProfile":{ - "name":"UpdateUserRoutingProfile", - "http":{ - "method":"POST", - "requestUri":"/users/{InstanceId}/{UserId}/routing-profile" - }, - "input":{"shape":"UpdateUserRoutingProfileRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Assigns the specified routing profile to a user.

" - }, - "UpdateUserSecurityProfiles":{ - "name":"UpdateUserSecurityProfiles", - "http":{ - "method":"POST", - "requestUri":"/users/{InstanceId}/{UserId}/security-profiles" - }, - "input":{"shape":"UpdateUserSecurityProfilesRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Update the security profiles assigned to the user.

" - } - }, - "shapes":{ - "ARN":{"type":"string"}, - "AfterContactWorkTimeLimit":{ - "type":"integer", - "min":0 - }, - "AgentFirstName":{ - "type":"string", - "max":100, - "min":1 - }, - "AgentLastName":{ - "type":"string", - "max":100, - "min":1 - }, - "AgentUsername":{ - "type":"string", - "max":20, - "min":1, - "pattern":"[a-zA-Z0-9\\_\\-\\.]+" - }, - "AttributeName":{ - "type":"string", - "documentation":"Key for the key value pair to be used for additional attributes.", - "max":32767, - "min":1 - }, - "AttributeValue":{ - "type":"string", - "documentation":"Value for the key value pair to be used for additional attributes.", - "max":32767, - "min":0 - }, - "Attributes":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"}, - "documentation":"Additional attributes can be provided in the request using this field. This will be passed to the contact flow execution. Client can make use of this additional info in their contact flow." - }, - "AutoAccept":{"type":"boolean"}, - "ClientToken":{ - "type":"string", - "documentation":"Dedupe token to be provided by the client. This token is used to avoid duplicate calls to the customer.", - "max":500 - }, - "ContactFlowId":{ - "type":"string", - "documentation":"Amazon resource name for the contact flow to be executed to handle the current call.", - "max":500 - }, - "ContactId":{ - "type":"string", - "documentation":"Amazon Connect contact identifier. An unique ContactId will be generated for each contact request.", - "max":256, - "min":1 - }, - "ContactNotFoundException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

The contact with the specified ID is not active or does not exist.

", - "error":{"httpStatusCode":410}, - "exception":true - }, - "CreateUserRequest":{ - "type":"structure", - "required":[ - "Username", - "PhoneConfig", - "SecurityProfileIds", - "RoutingProfileId", - "InstanceId" - ], - "members":{ - "Username":{ - "shape":"AgentUsername", - "documentation":"

The user name in Amazon Connect for the user to create.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The password for the user account to create. This is required if you are using Amazon Connect for identity management. If you are using SAML for identity management and include this parameter, an InvalidRequestException is returned.

" - }, - "IdentityInfo":{ - "shape":"UserIdentityInfo", - "documentation":"

Information about the user, including email address, first name, and last name.

" - }, - "PhoneConfig":{ - "shape":"UserPhoneConfig", - "documentation":"

Specifies the phone settings for the user, including AfterContactWorkTimeLimit, AutoAccept, DeskPhoneNumber, and PhoneType.

" - }, - "DirectoryUserId":{ - "shape":"DirectoryUserId", - "documentation":"

The unique identifier for the user account in the directory service directory used for identity management. If Amazon Connect is unable to access the existing directory, you can use the DirectoryUserId to authenticate users. If you include the parameter, it is assumed that Amazon Connect cannot access the directory. If the parameter is not included, the UserIdentityInfo is used to authenticate users from your existing directory.

This parameter is required if you are using an existing directory for identity management in Amazon Connect when Amazon Connect cannot access your directory to authenticate users. If you are using SAML for identity management and include this parameter, an InvalidRequestException is returned.

" - }, - "SecurityProfileIds":{ - "shape":"SecurityProfileIds", - "documentation":"

The unique identifier of the security profile to assign to the user created.

" - }, - "RoutingProfileId":{ - "shape":"RoutingProfileId", - "documentation":"

The unique identifier for the routing profile to assign to the user created.

" - }, - "HierarchyGroupId":{ - "shape":"HierarchyGroupId", - "documentation":"

The unique identifier for the hierarchy group to assign to the user created.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "CreateUserResponse":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"UserId", - "documentation":"

The unique identifier for the user account in Amazon Connect

" - }, - "UserArn":{ - "shape":"ARN", - "documentation":"

The Amazon Resource Name (ARN) of the user account created.

" - } - } - }, - "Credentials":{ - "type":"structure", - "members":{ - "AccessToken":{ - "shape":"SecurityToken", - "documentation":"

An access token generated for a federated user to access Amazon Connect

" - }, - "AccessTokenExpiration":{ - "shape":"timestamp", - "documentation":"

A token generated with an expiration time for the session a user is logged in to Amazon Connect

" - }, - "RefreshToken":{ - "shape":"SecurityToken", - "documentation":"

Renews a token generated for a user to access the Amazon Connect instance.

" - }, - "RefreshTokenExpiration":{ - "shape":"timestamp", - "documentation":"

Renews the expiration timer for a generated token.

" - } - }, - "documentation":"

The credentials to use for federation.

" - }, - "DeleteUserRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "UserId" - ], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The unique identifier of the user to delete.

", - "location":"uri", - "locationName":"UserId" - } - } - }, - "DescribeUserHierarchyGroupRequest":{ - "type":"structure", - "required":[ - "HierarchyGroupId", - "InstanceId" - ], - "members":{ - "HierarchyGroupId":{ - "shape":"HierarchyGroupId", - "documentation":"

The identifier for the hierarchy group to return.

", - "location":"uri", - "locationName":"HierarchyGroupId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "DescribeUserHierarchyGroupResponse":{ - "type":"structure", - "members":{ - "HierarchyGroup":{ - "shape":"HierarchyGroup", - "documentation":"

Returns a HierarchyGroup object.

" - } - } - }, - "DescribeUserHierarchyStructureRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "DescribeUserHierarchyStructureResponse":{ - "type":"structure", - "members":{ - "HierarchyStructure":{ - "shape":"HierarchyStructure", - "documentation":"

A HierarchyStructure object.

" - } - } - }, - "DescribeUserRequest":{ - "type":"structure", - "required":[ - "UserId", - "InstanceId" - ], - "members":{ - "UserId":{ - "shape":"UserId", - "documentation":"

Unique identifier for the user account to return.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "DescribeUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

A User object that contains information about the user account and configuration settings.

" - } - } - }, - "DestinationNotAllowedException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

Outbound calls to the destination number are not allowed.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "DirectoryUserId":{"type":"string"}, - "DuplicateResourceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

A resource with that name already exisits.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "Email":{"type":"string"}, - "GetFederationTokenRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "GetFederationTokenResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The credentials to use for federation.

" - } - } - }, - "HierarchyGroup":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"HierarchyGroupId", - "documentation":"

The identifier for the hierarchy group.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The Amazon Resource Name (ARN) for the hierarchy group.

" - }, - "Name":{ - "shape":"HierarchyGroupName", - "documentation":"

The name of the hierarchy group in your instance.

" - }, - "LevelId":{ - "shape":"HierarchyLevelId", - "documentation":"

The identifier for the level in the hierarchy group.

" - }, - "HierarchyPath":{ - "shape":"HierarchyPath", - "documentation":"

A HierarchyPath object that contains information about the levels in the hierarchy group.

" - } - }, - "documentation":"

A HierarchyGroup object that contains information about a hierarchy group in your Amazon Connect instance.

" - }, - "HierarchyGroupId":{"type":"string"}, - "HierarchyGroupName":{"type":"string"}, - "HierarchyGroupSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"HierarchyGroupId", - "documentation":"

The identifier of the hierarchy group.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN for the hierarchy group.

" - }, - "Name":{ - "shape":"HierarchyGroupName", - "documentation":"

The name of the hierarchy group.

" - } - }, - "documentation":"

A HierarchyGroupSummary object that contains information about the hierarchy group, including ARN, Id, and Name.

" - }, - "HierarchyGroupSummaryList":{ - "type":"list", - "member":{"shape":"HierarchyGroupSummary"} - }, - "HierarchyLevel":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"HierarchyLevelId", - "documentation":"

The identifier for the hierarchy group level.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN for the hierarchy group level.

" - }, - "Name":{ - "shape":"HierarchyLevelName", - "documentation":"

The name of the hierarchy group level.

" - } - }, - "documentation":"

A HierarchyLevel object that contains information about the levels in a hierarchy group, including ARN, Id, and Name.

" - }, - "HierarchyLevelId":{"type":"string"}, - "HierarchyLevelName":{"type":"string"}, - "HierarchyPath":{ - "type":"structure", - "members":{ - "LevelOne":{ - "shape":"HierarchyGroupSummary", - "documentation":"

A HierarchyGroupSummary object that contains information about the level of the hierarchy group, including ARN, Id, and Name.

" - }, - "LevelTwo":{ - "shape":"HierarchyGroupSummary", - "documentation":"

A HierarchyGroupSummary object that contains information about the level of the hierarchy group, including ARN, Id, and Name.

" - }, - "LevelThree":{ - "shape":"HierarchyGroupSummary", - "documentation":"

A HierarchyGroupSummary object that contains information about the level of the hierarchy group, including ARN, Id, and Name.

" - }, - "LevelFour":{ - "shape":"HierarchyGroupSummary", - "documentation":"

A HierarchyGroupSummary object that contains information about the level of the hierarchy group, including ARN, Id, and Name.

" - }, - "LevelFive":{ - "shape":"HierarchyGroupSummary", - "documentation":"

A HierarchyGroupSummary object that contains information about the level of the hierarchy group, including ARN, Id, and Name.

" - } - }, - "documentation":"

A HierarchyPath object that contains information about the levels of the hierarchy group.

" - }, - "HierarchyStructure":{ - "type":"structure", - "members":{ - "LevelOne":{ - "shape":"HierarchyLevel", - "documentation":"

A HierarchyLevel object that contains information about the hierarchy group level.

" - }, - "LevelTwo":{ - "shape":"HierarchyLevel", - "documentation":"

A HierarchyLevel object that contains information about the hierarchy group level.

" - }, - "LevelThree":{ - "shape":"HierarchyLevel", - "documentation":"

A HierarchyLevel object that contains information about the hierarchy group level.

" - }, - "LevelFour":{ - "shape":"HierarchyLevel", - "documentation":"

A HierarchyLevel object that contains information about the hierarchy group level.

" - }, - "LevelFive":{ - "shape":"HierarchyLevel", - "documentation":"

A HierarchyLevel object that contains information about the hierarchy group level.

" - } - }, - "documentation":"

A HierarchyStructure object that contains information about the hierarchy group structure.

" - }, - "InstanceId":{ - "type":"string", - "documentation":"Amazon Connect Organization ARN. A client must provide its organization ARN in order to place a call. This defines the call from organization.", - "max":100, - "min":1 - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

Request processing failed due to an error or failure with the service.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

One or more of the parameters provided to the operation are not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

The request is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

The limit exceeded the maximum allowed active calls in a queue.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListRoutingProfilesRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"MaxResult1000", - "documentation":"

The maximum number of routing profiles to return in the response.

", - "box":true, - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListRoutingProfilesResponse":{ - "type":"structure", - "members":{ - "RoutingProfileSummaryList":{ - "shape":"RoutingProfileSummaryList", - "documentation":"

An array of RoutingProfileSummary objects that include the ARN, Id, and Name of the routing profile.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string returned in the response. Use the value returned in the response as the value of the NextToken in a subsequent request to retrieve the next set of results.

" - } - } - }, - "ListSecurityProfilesRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"MaxResult1000", - "documentation":"

The maximum number of security profiles to return.

", - "box":true, - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListSecurityProfilesResponse":{ - "type":"structure", - "members":{ - "SecurityProfileSummaryList":{ - "shape":"SecurityProfileSummaryList", - "documentation":"

An array of SecurityProfileSummary objects.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string returned in the response. Use the value returned in the response as the value of the NextToken in a subsequent request to retrieve the next set of results.

" - } - } - }, - "ListUserHierarchyGroupsRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"MaxResult1000", - "documentation":"

The maximum number of hierarchy groups to return.

", - "box":true, - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListUserHierarchyGroupsResponse":{ - "type":"structure", - "members":{ - "UserHierarchyGroupSummaryList":{ - "shape":"HierarchyGroupSummaryList", - "documentation":"

An array of HierarchyGroupSummary objects.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string returned in the response. Use the value returned in the response as the value of the NextToken in a subsequent request to retrieve the next set of results.

" - } - } - }, - "ListUsersRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"MaxResult1000", - "documentation":"

The maximum number of results to return in the response.

", - "box":true, - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListUsersResponse":{ - "type":"structure", - "members":{ - "UserSummaryList":{ - "shape":"UserSummaryList", - "documentation":"

An array of UserSummary objects that contain information about the users in your instance.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A string returned in the response. Use the value returned in the response as the value of the NextToken in a subsequent request to retrieve the next set of results.

" - } - } - }, - "MaxResult1000":{ - "type":"integer", - "max":1000, - "min":1 - }, - "Message":{"type":"string"}, - "NextToken":{"type":"string"}, - "OutboundContactNotPermittedException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

The contact is not permitted.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "Password":{ - "type":"string", - "pattern":"/^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)[a-zA-Z\\d\\S]{8,}$/" - }, - "PhoneNumber":{ - "type":"string", - "documentation":"End customer's phone number to call." - }, - "PhoneType":{ - "type":"string", - "enum":[ - "SOFT_PHONE", - "DESK_PHONE" - ] - }, - "QueueId":{ - "type":"string", - "documentation":"Identifier of the queue to be used for the contact routing." - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"Message", - "documentation":"

The message.

" - } - }, - "documentation":"

The specified resource was not found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "RoutingProfileId":{"type":"string"}, - "RoutingProfileName":{ - "type":"string", - "max":100, - "min":1 - }, - "RoutingProfileSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"RoutingProfileId", - "documentation":"

The identifier of the routing profile.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN of the routing profile.

" - }, - "Name":{ - "shape":"RoutingProfileName", - "documentation":"

The name of the routing profile.

" - } - }, - "documentation":"

A RoutingProfileSummary object that contains information about a routing profile, including ARN, Id, and Name.

" - }, - "RoutingProfileSummaryList":{ - "type":"list", - "member":{"shape":"RoutingProfileSummary"} - }, - "SecurityProfileId":{"type":"string"}, - "SecurityProfileIds":{ - "type":"list", - "member":{"shape":"SecurityProfileId"}, - "max":10, - "min":1 - }, - "SecurityProfileName":{"type":"string"}, - "SecurityProfileSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"SecurityProfileId", - "documentation":"

The identifier of the security profile.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN of the security profile.

" - }, - "Name":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile.

" - } - }, - "documentation":"

A SecurityProfileSummary object that contains information about a security profile, including ARN, Id, Name.

" - }, - "SecurityProfileSummaryList":{ - "type":"list", - "member":{"shape":"SecurityProfileSummary"} - }, - "SecurityToken":{ - "type":"string", - "sensitive":true - }, - "StartOutboundVoiceContactRequest":{ - "type":"structure", - "required":[ - "DestinationPhoneNumber", - "ContactFlowId", - "InstanceId" - ], - "members":{ - "DestinationPhoneNumber":{ - "shape":"PhoneNumber", - "documentation":"

The phone number of the customer in E.164 format.

" - }, - "ContactFlowId":{ - "shape":"ContactFlowId", - "documentation":"

The identifier for the contact flow to connect the outbound call to.

To find the ContactFlowId, open the contact flow you want to use in the Amazon Connect contact flow editor. The ID for the contact flow is displayed in the address bar as part of the URL. For example, the contact flow ID is the set of characters at the end of the URL, after 'contact-flow/' such as 78ea8fd5-2659-4f2b-b528-699760ccfc1b.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. The token is valid for 7 days after creation. If a contact is already started, the contact ID is returned. If the contact is disconnected, a new contact is started.

", - "idempotencyToken":true - }, - "SourcePhoneNumber":{ - "shape":"PhoneNumber", - "documentation":"

The phone number, in E.164 format, associated with your Amazon Connect instance to use for the outbound call.

" - }, - "QueueId":{ - "shape":"QueueId", - "documentation":"

The queue to add the call to. If you specify a queue, the phone displayed for caller ID is the phone number specified in the queue. If you do not specify a queue, the queue used will be the queue defined in the contact flow.

To find the QueueId, open the queue you want to use in the Amazon Connect Queue editor. The ID for the queue is displayed in the address bar as part of the URL. For example, the queue ID is the set of characters at the end of the URL, after 'queue/' such as queue/aeg40574-2d01-51c3-73d6-bf8624d2168c.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

Specify a custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in contact flows just like any other contact attributes.

There can be up to 32,768 UTF-8 bytes across all key-value pairs. Attribute keys can include only alphanumeric, dash, and underscore characters.

For example, if you want play a greeting when the customer answers the call, you can pass the customer name in attributes similar to the following:

" - } - } - }, - "StartOutboundVoiceContactResponse":{ - "type":"structure", - "members":{ - "ContactId":{ - "shape":"ContactId", - "documentation":"

The unique identifier of this contact within your Amazon Connect instance.

" - } - } - }, - "StopContactRequest":{ - "type":"structure", - "required":[ - "ContactId", - "InstanceId" - ], - "members":{ - "ContactId":{ - "shape":"ContactId", - "documentation":"

The unique identifier of the contact to end.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

" - } - } - }, - "StopContactResponse":{ - "type":"structure", - "members":{ - } - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

The throttling limit has been exceeded.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UpdateUserHierarchyRequest":{ - "type":"structure", - "required":[ - "UserId", - "InstanceId" - ], - "members":{ - "HierarchyGroupId":{ - "shape":"HierarchyGroupId", - "documentation":"

The identifier for the hierarchy group to assign to the user.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier of the user account to assign the hierarchy group to.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "UpdateUserIdentityInfoRequest":{ - "type":"structure", - "required":[ - "IdentityInfo", - "UserId", - "InstanceId" - ], - "members":{ - "IdentityInfo":{ - "shape":"UserIdentityInfo", - "documentation":"

A UserIdentityInfo object.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier for the user account to update identity information for.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "UpdateUserPhoneConfigRequest":{ - "type":"structure", - "required":[ - "PhoneConfig", - "UserId", - "InstanceId" - ], - "members":{ - "PhoneConfig":{ - "shape":"UserPhoneConfig", - "documentation":"

A UserPhoneConfig object that contains settings for AfterContactWorkTimeLimit, AutoAccept, DeskPhoneNumber, and PhoneType to assign to the user.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier for the user account to change phone settings for.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "UpdateUserRoutingProfileRequest":{ - "type":"structure", - "required":[ - "RoutingProfileId", - "UserId", - "InstanceId" - ], - "members":{ - "RoutingProfileId":{ - "shape":"RoutingProfileId", - "documentation":"

The identifier of the routing profile to assign to the user.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier for the user account to assign the routing profile to.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "UpdateUserSecurityProfilesRequest":{ - "type":"structure", - "required":[ - "SecurityProfileIds", - "UserId", - "InstanceId" - ], - "members":{ - "SecurityProfileIds":{ - "shape":"SecurityProfileIds", - "documentation":"

The identifiers for the security profiles to assign to the user.

" - }, - "UserId":{ - "shape":"UserId", - "documentation":"

The identifier of the user account to assign the security profiles.

", - "location":"uri", - "locationName":"UserId" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The identifier for your Amazon Connect instance. To find the ID of your instance, open the AWS console and select Amazon Connect. Select the alias of the instance in the Instance alias column. The instance ID is displayed in the Overview section of your instance settings. For example, the instance ID is the set of characters at the end of the instance ARN, after instance/, such as 10a4c4eb-f57e-4d4c-b602-bf39176ced07.

", - "location":"uri", - "locationName":"InstanceId" - } - } - }, - "User":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"UserId", - "documentation":"

The identifier of the user account.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN of the user account.

" - }, - "Username":{ - "shape":"AgentUsername", - "documentation":"

The user name assigned to the user account.

" - }, - "IdentityInfo":{ - "shape":"UserIdentityInfo", - "documentation":"

A UserIdentityInfo object.

" - }, - "PhoneConfig":{ - "shape":"UserPhoneConfig", - "documentation":"

A UserPhoneConfig object.

" - }, - "DirectoryUserId":{ - "shape":"DirectoryUserId", - "documentation":"

The directory Id for the user account in the existing directory used for identity management.

" - }, - "SecurityProfileIds":{ - "shape":"SecurityProfileIds", - "documentation":"

The identifier(s) for the security profile assigned to the user.

" - }, - "RoutingProfileId":{ - "shape":"RoutingProfileId", - "documentation":"

The identifier of the routing profile assigned to the user.

" - }, - "HierarchyGroupId":{ - "shape":"HierarchyGroupId", - "documentation":"

The identifier for the hierarchy group assigned to the user.

" - } - }, - "documentation":"

A User object that contains information about a user account in your Amazon Connect instance, including configuration settings.

" - }, - "UserId":{"type":"string"}, - "UserIdentityInfo":{ - "type":"structure", - "members":{ - "FirstName":{ - "shape":"AgentFirstName", - "documentation":"

The first name used in the user account. This is required if you are using Amazon Connect or SAML for identity management.

" - }, - "LastName":{ - "shape":"AgentLastName", - "documentation":"

The last name used in the user account. This is required if you are using Amazon Connect or SAML for identity management.

" - }, - "Email":{ - "shape":"Email", - "documentation":"

The email address added to the user account. If you are using SAML for identity management and include this parameter, an InvalidRequestException is returned.

" - } - }, - "documentation":"

A UserIdentityInfo object that contains information about the user's identity, including email address, first name, and last name.

" - }, - "UserNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

No user with the specified credentials was found in the Amazon Connect instance.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "UserPhoneConfig":{ - "type":"structure", - "required":["PhoneType"], - "members":{ - "PhoneType":{ - "shape":"PhoneType", - "documentation":"

The phone type selected for the user, either Soft phone or Desk phone.

" - }, - "AutoAccept":{ - "shape":"AutoAccept", - "documentation":"

The Auto accept setting for the user, Yes or No.

" - }, - "AfterContactWorkTimeLimit":{ - "shape":"AfterContactWorkTimeLimit", - "documentation":"

The After Call Work (ACW) timeout setting, in seconds, for the user.

" - }, - "DeskPhoneNumber":{ - "shape":"PhoneNumber", - "documentation":"

The phone number for the user's desk phone.

" - } - }, - "documentation":"

A UserPhoneConfig object that contains information about the user phone configuration settings.

" - }, - "UserSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"UserId", - "documentation":"

The identifier for the user account.

" - }, - "Arn":{ - "shape":"ARN", - "documentation":"

The ARN for the user account.

" - }, - "Username":{ - "shape":"AgentUsername", - "documentation":"

The Amazon Connect user name for the user account.

" - } - }, - "documentation":"

A UserSummary object that contains Information about a user, including ARN, Id, and user name.

" - }, - "UserSummaryList":{ - "type":"list", - "member":{"shape":"UserSummary"} - }, - "timestamp":{"type":"timestamp"} - }, - "documentation":"

The Amazon Connect API Reference provides descriptions, syntax, and usage examples for each of the Amazon Connect actions, data types, parameters, and errors. Amazon Connect is a cloud-based contact center solution that makes it easy to set up and manage a customer contact center and provide reliable customer engagement at any scale.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/paginators-1.json deleted file mode 100644 index 7db4dfe1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "DescribeReportDefinitions": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReportDefinitions" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/service-2.json deleted file mode 100644 index 4ed705a8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/cur/2017-01-06/service-2.json +++ /dev/null @@ -1,264 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-01-06", - "endpointPrefix":"cur", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Cost and Usage Report Service", - "serviceId":"Cost and Usage Report Service", - "signatureVersion":"v4", - "signingName":"cur", - "targetPrefix":"AWSOrigamiServiceGatewayService", - "uid":"cur-2017-01-06" - }, - "operations":{ - "DeleteReportDefinition":{ - "name":"DeleteReportDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReportDefinitionRequest"}, - "output":{"shape":"DeleteReportDefinitionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ValidationException"} - ], - "documentation":"Delete a specified report definition" - }, - "DescribeReportDefinitions":{ - "name":"DescribeReportDefinitions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReportDefinitionsRequest"}, - "output":{"shape":"DescribeReportDefinitionsResponse"}, - "errors":[ - {"shape":"InternalErrorException"} - ], - "documentation":"Describe a list of report definitions owned by the account" - }, - "PutReportDefinition":{ - "name":"PutReportDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutReportDefinitionRequest"}, - "output":{"shape":"PutReportDefinitionResponse"}, - "errors":[ - {"shape":"DuplicateReportNameException"}, - {"shape":"ReportLimitReachedException"}, - {"shape":"InternalErrorException"}, - {"shape":"ValidationException"} - ], - "documentation":"Create a new report definition" - } - }, - "shapes":{ - "AWSRegion":{ - "type":"string", - "documentation":"Region of customer S3 bucket.", - "enum":[ - "us-east-1", - "us-west-1", - "us-west-2", - "eu-central-1", - "eu-west-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1" - ] - }, - "AdditionalArtifact":{ - "type":"string", - "documentation":"Enable support for Redshift and/or QuickSight.", - "enum":[ - "REDSHIFT", - "QUICKSIGHT" - ] - }, - "AdditionalArtifactList":{ - "type":"list", - "member":{"shape":"AdditionalArtifact"}, - "documentation":"A list of additional artifacts." - }, - "CompressionFormat":{ - "type":"string", - "documentation":"Preferred compression format for report.", - "enum":[ - "ZIP", - "GZIP" - ] - }, - "DeleteReportDefinitionRequest":{ - "type":"structure", - "members":{ - "ReportName":{"shape":"ReportName"} - }, - "documentation":"Request of DeleteReportDefinition" - }, - "DeleteReportDefinitionResponse":{ - "type":"structure", - "members":{ - "ResponseMessage":{"shape":"DeleteResponseMessage"} - }, - "documentation":"Response of DeleteReportDefinition" - }, - "DeleteResponseMessage":{ - "type":"string", - "documentation":"A message indicates if the deletion is successful." - }, - "DescribeReportDefinitionsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{"shape":"MaxResults"}, - "NextToken":{"shape":"GenericString"} - }, - "documentation":"Request of DescribeReportDefinitions" - }, - "DescribeReportDefinitionsResponse":{ - "type":"structure", - "members":{ - "ReportDefinitions":{"shape":"ReportDefinitionList"}, - "NextToken":{"shape":"GenericString"} - }, - "documentation":"Response of DescribeReportDefinitions" - }, - "DuplicateReportNameException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"This exception is thrown when putting a report preference with a name that already exists.", - "exception":true - }, - "ErrorMessage":{ - "type":"string", - "documentation":"A message to show the detail of the exception." - }, - "GenericString":{ - "type":"string", - "documentation":"A generic string." - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"This exception is thrown on a known dependency failure.", - "exception":true, - "fault":true - }, - "MaxResults":{ - "type":"integer", - "documentation":"The max number of results returned by the operation.", - "box":true, - "max":5, - "min":5 - }, - "PutReportDefinitionRequest":{ - "type":"structure", - "required":["ReportDefinition"], - "members":{ - "ReportDefinition":{"shape":"ReportDefinition"} - }, - "documentation":"Request of PutReportDefinition" - }, - "PutReportDefinitionResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"Response of PutReportDefinition" - }, - "ReportDefinition":{ - "type":"structure", - "required":[ - "ReportName", - "TimeUnit", - "Format", - "Compression", - "AdditionalSchemaElements", - "S3Bucket", - "S3Prefix", - "S3Region" - ], - "members":{ - "ReportName":{"shape":"ReportName"}, - "TimeUnit":{"shape":"TimeUnit"}, - "Format":{"shape":"ReportFormat"}, - "Compression":{"shape":"CompressionFormat"}, - "AdditionalSchemaElements":{"shape":"SchemaElementList"}, - "S3Bucket":{"shape":"S3Bucket"}, - "S3Prefix":{"shape":"S3Prefix"}, - "S3Region":{"shape":"AWSRegion"}, - "AdditionalArtifacts":{"shape":"AdditionalArtifactList"} - }, - "documentation":"The definition of AWS Cost and Usage Report. Customer can specify the report name, time unit, report format, compression format, S3 bucket and additional artifacts and schema elements in the definition." - }, - "ReportDefinitionList":{ - "type":"list", - "member":{"shape":"ReportDefinition"}, - "documentation":"A list of report definitions." - }, - "ReportFormat":{ - "type":"string", - "documentation":"Preferred format for report.", - "enum":["textORcsv"] - }, - "ReportLimitReachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"This exception is thrown when the number of report preference reaches max limit. The max number is 5.", - "exception":true - }, - "ReportName":{ - "type":"string", - "documentation":"Preferred name for a report, it has to be unique. Must starts with a number/letter, case sensitive. Limited to 256 characters.", - "max":256, - "pattern":"[0-9A-Za-z!\\-_.*\\'()]+" - }, - "S3Bucket":{ - "type":"string", - "documentation":"Name of customer S3 bucket.", - "max":256 - }, - "S3Prefix":{ - "type":"string", - "documentation":"Preferred report path prefix. Limited to 256 characters.", - "max":256, - "pattern":"[0-9A-Za-z!\\-_.*\\'()/]*" - }, - "SchemaElement":{ - "type":"string", - "documentation":"Preference of including Resource IDs. You can include additional details about individual resource IDs in your report.", - "enum":["RESOURCES"] - }, - "SchemaElementList":{ - "type":"list", - "member":{"shape":"SchemaElement"}, - "documentation":"A list of schema elements." - }, - "TimeUnit":{ - "type":"string", - "documentation":"The frequency on which report data are measured and displayed.", - "enum":[ - "HOURLY", - "DAILY" - ] - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"This exception is thrown when providing an invalid input. eg. Put a report preference with an invalid report name, or Delete a report preference with an empty report name.", - "exception":true - } - }, - "documentation":"All public APIs for AWS Cost and Usage Report service" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/paginators-1.json deleted file mode 100644 index c859c9fb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/paginators-1.json +++ /dev/null @@ -1,23 +0,0 @@ -{ - "pagination": { - "ListPipelines": { - "input_token": "marker", - "output_token": "marker", - "more_results": "hasMoreResults", - "result_key": "pipelineIdList" - }, - "DescribeObjects": { - "input_token": "marker", - "output_token": "marker", - "more_results": "hasMoreResults", - "result_key": "pipelineObjects" - }, - "QueryObjects": { - "input_token": "marker", - "output_token": "marker", - "more_results": "hasMoreResults", - "limit_key": "limit", - "result_key": "ids" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/service-2.json deleted file mode 100644 index 55298952..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/datapipeline/2012-10-29/service-2.json +++ /dev/null @@ -1,1779 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-10-29", - "endpointPrefix":"datapipeline", - "jsonVersion":"1.1", - "serviceFullName":"AWS Data Pipeline", - "serviceId":"Data Pipeline", - "signatureVersion":"v4", - "targetPrefix":"DataPipeline", - "protocol":"json", - "uid":"datapipeline-2012-10-29" - }, - "documentation":"

AWS Data Pipeline configures and manages a data-driven workflow called a pipeline. AWS Data Pipeline handles the details of scheduling and ensuring that data dependencies are met so that your application can focus on processing the data.

AWS Data Pipeline provides a JAR implementation of a task runner called AWS Data Pipeline Task Runner. AWS Data Pipeline Task Runner provides logic for common data management scenarios, such as performing database queries and running data analysis using Amazon Elastic MapReduce (Amazon EMR). You can use AWS Data Pipeline Task Runner as your task runner, or you can write your own task runner to provide custom data management.

AWS Data Pipeline implements two main sets of functionality. Use the first set to create a pipeline and define data sources, schedules, dependencies, and the transforms to be performed on the data. Use the second set in your task runner application to receive the next task ready for processing. The logic for performing the task, such as querying the data, running data analysis, or converting the data from one format to another, is contained within the task runner. The task runner performs the task assigned to it by the web service, reporting progress to the web service as it does so. When the task is done, the task runner reports the final success or failure of the task to the web service.

", - "operations":{ - "ActivatePipeline":{ - "name":"ActivatePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ActivatePipelineInput", - "documentation":"

Contains the parameters for ActivatePipeline.

" - }, - "output":{ - "shape":"ActivatePipelineOutput", - "documentation":"

Contains the output of ActivatePipeline.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Validates the specified pipeline and starts processing pipeline tasks. If the pipeline does not pass validation, activation fails.

If you need to pause the pipeline to investigate an issue with a component, such as a data source or script, call DeactivatePipeline.

To activate a finished pipeline, modify the end date for the pipeline and then activate it.

" - }, - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"AddTagsInput", - "documentation":"

Contains the parameters for AddTags.

" - }, - "output":{ - "shape":"AddTagsOutput", - "documentation":"

Contains the output of AddTags.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Adds or modifies tags for the specified pipeline.

" - }, - "CreatePipeline":{ - "name":"CreatePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreatePipelineInput", - "documentation":"

Contains the parameters for CreatePipeline.

" - }, - "output":{ - "shape":"CreatePipelineOutput", - "documentation":"

Contains the output of CreatePipeline.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Creates a new, empty pipeline. Use PutPipelineDefinition to populate the pipeline.

" - }, - "DeactivatePipeline":{ - "name":"DeactivatePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeactivatePipelineInput", - "documentation":"

Contains the parameters for DeactivatePipeline.

" - }, - "output":{ - "shape":"DeactivatePipelineOutput", - "documentation":"

Contains the output of DeactivatePipeline.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Deactivates the specified running pipeline. The pipeline is set to the DEACTIVATING state until the deactivation process completes.

To resume a deactivated pipeline, use ActivatePipeline. By default, the pipeline resumes from the last completed execution. Optionally, you can specify the date and time to resume the pipeline.

" - }, - "DeletePipeline":{ - "name":"DeletePipeline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeletePipelineInput", - "documentation":"

Contains the parameters for DeletePipeline.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Deletes a pipeline, its pipeline definition, and its run history. AWS Data Pipeline attempts to cancel instances associated with the pipeline that are currently being processed by task runners.

Deleting a pipeline cannot be undone. You cannot query or restore a deleted pipeline. To temporarily pause a pipeline instead of deleting it, call SetStatus with the status set to PAUSE on individual components. Components that are paused by SetStatus can be resumed.

" - }, - "DescribeObjects":{ - "name":"DescribeObjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeObjectsInput", - "documentation":"

Contains the parameters for DescribeObjects.

" - }, - "output":{ - "shape":"DescribeObjectsOutput", - "documentation":"

Contains the output of DescribeObjects.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Gets the object definitions for a set of objects associated with the pipeline. Object definitions are composed of a set of fields that define the properties of the object.

" - }, - "DescribePipelines":{ - "name":"DescribePipelines", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribePipelinesInput", - "documentation":"

Contains the parameters for DescribePipelines.

" - }, - "output":{ - "shape":"DescribePipelinesOutput", - "documentation":"

Contains the output of DescribePipelines.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Retrieves metadata about one or more pipelines. The information retrieved includes the name of the pipeline, the pipeline identifier, its current state, and the user account that owns the pipeline. Using account credentials, you can retrieve metadata about pipelines that you or your IAM users have created. If you are using an IAM user account, you can retrieve metadata about only those pipelines for which you have read permissions.

To retrieve the full pipeline definition instead of metadata about the pipeline, call GetPipelineDefinition.

" - }, - "EvaluateExpression":{ - "name":"EvaluateExpression", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"EvaluateExpressionInput", - "documentation":"

Contains the parameters for EvaluateExpression.

" - }, - "output":{ - "shape":"EvaluateExpressionOutput", - "documentation":"

Contains the output of EvaluateExpression.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"TaskNotFoundException", - "exception":true, - "documentation":"

The specified task was not found.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Task runners call EvaluateExpression to evaluate a string in the context of the specified object. For example, a task runner can evaluate SQL queries stored in Amazon S3.

" - }, - "GetPipelineDefinition":{ - "name":"GetPipelineDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"GetPipelineDefinitionInput", - "documentation":"

Contains the parameters for GetPipelineDefinition.

" - }, - "output":{ - "shape":"GetPipelineDefinitionOutput", - "documentation":"

Contains the output of GetPipelineDefinition.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Gets the definition of the specified pipeline. You can call GetPipelineDefinition to retrieve the pipeline definition that you provided using PutPipelineDefinition.

" - }, - "ListPipelines":{ - "name":"ListPipelines", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ListPipelinesInput", - "documentation":"

Contains the parameters for ListPipelines.

" - }, - "output":{ - "shape":"ListPipelinesOutput", - "documentation":"

Contains the output of ListPipelines.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Lists the pipeline identifiers for all active pipelines that you have permission to access.

" - }, - "PollForTask":{ - "name":"PollForTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PollForTaskInput", - "documentation":"

Contains the parameters for PollForTask.

" - }, - "output":{ - "shape":"PollForTaskOutput", - "documentation":"

Contains the output of PollForTask.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"TaskNotFoundException", - "exception":true, - "documentation":"

The specified task was not found.

" - } - ], - "documentation":"

Task runners call PollForTask to receive a task to perform from AWS Data Pipeline. The task runner specifies which tasks it can perform by setting a value for the workerGroup parameter. The task returned can come from any of the pipelines that match the workerGroup value passed in by the task runner and that was launched using the IAM user credentials specified by the task runner.

If tasks are ready in the work queue, PollForTask returns a response immediately. If no tasks are available in the queue, PollForTask uses long-polling and holds on to a poll connection for up to a 90 seconds, during which time the first newly scheduled task is handed to the task runner. To accomodate this, set the socket timeout in your task runner to 90 seconds. The task runner should not call PollForTask again on the same workerGroup until it receives a response, and this can take up to 90 seconds.

" - }, - "PutPipelineDefinition":{ - "name":"PutPipelineDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PutPipelineDefinitionInput", - "documentation":"

Contains the parameters for PutPipelineDefinition.

" - }, - "output":{ - "shape":"PutPipelineDefinitionOutput", - "documentation":"

Contains the output of PutPipelineDefinition.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Adds tasks, schedules, and preconditions to the specified pipeline. You can use PutPipelineDefinition to populate a new pipeline.

PutPipelineDefinition also validates the configuration as it adds it to the pipeline. Changes to the pipeline are saved unless one of the following three validation errors exists in the pipeline.

  1. An object is missing a name or identifier field.
  2. A string or reference field is empty.
  3. The number of objects in the pipeline exceeds the maximum allowed objects.
  4. The pipeline is in a FINISHED state.

Pipeline object definitions are passed to the PutPipelineDefinition action and returned by the GetPipelineDefinition action.

" - }, - "QueryObjects":{ - "name":"QueryObjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"QueryObjectsInput", - "documentation":"

Contains the parameters for QueryObjects.

" - }, - "output":{ - "shape":"QueryObjectsOutput", - "documentation":"

Contains the output of QueryObjects.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Queries the specified pipeline for the names of objects that match the specified set of conditions.

" - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RemoveTagsInput", - "documentation":"

Contains the parameters for RemoveTags.

" - }, - "output":{ - "shape":"RemoveTagsOutput", - "documentation":"

Contains the output of RemoveTags.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Removes existing tags from the specified pipeline.

" - }, - "ReportTaskProgress":{ - "name":"ReportTaskProgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ReportTaskProgressInput", - "documentation":"

Contains the parameters for ReportTaskProgress.

" - }, - "output":{ - "shape":"ReportTaskProgressOutput", - "documentation":"

Contains the output of ReportTaskProgress.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"TaskNotFoundException", - "exception":true, - "documentation":"

The specified task was not found.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Task runners call ReportTaskProgress when assigned a task to acknowledge that it has the task. If the web service does not receive this acknowledgement within 2 minutes, it assigns the task in a subsequent PollForTask call. After this initial acknowledgement, the task runner only needs to report progress every 15 minutes to maintain its ownership of the task. You can change this reporting time from 15 minutes by specifying a reportProgressTimeout field in your pipeline.

If a task runner does not report its status after 5 minutes, AWS Data Pipeline assumes that the task runner is unable to process the task and reassigns the task in a subsequent response to PollForTask. Task runners should call ReportTaskProgress every 60 seconds.

" - }, - "ReportTaskRunnerHeartbeat":{ - "name":"ReportTaskRunnerHeartbeat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ReportTaskRunnerHeartbeatInput", - "documentation":"

Contains the parameters for ReportTaskRunnerHeartbeat.

" - }, - "output":{ - "shape":"ReportTaskRunnerHeartbeatOutput", - "documentation":"

Contains the output of ReportTaskRunnerHeartbeat.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Task runners call ReportTaskRunnerHeartbeat every 15 minutes to indicate that they are operational. If the AWS Data Pipeline Task Runner is launched on a resource managed by AWS Data Pipeline, the web service can use this call to detect when the task runner application has failed and restart a new instance.

" - }, - "SetStatus":{ - "name":"SetStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"SetStatusInput", - "documentation":"

Contains the parameters for SetStatus.

" - }, - "errors":[ - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - } - ], - "documentation":"

Requests that the status of the specified physical or logical pipeline objects be updated in the specified pipeline. This update might not occur immediately, but is eventually consistent. The status that can be set depends on the type of object (for example, DataNode or Activity). You cannot perform this operation on FINISHED pipelines and attempting to do so returns InvalidRequestException.

" - }, - "SetTaskStatus":{ - "name":"SetTaskStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"SetTaskStatusInput", - "documentation":"

Contains the parameters for SetTaskStatus.

" - }, - "output":{ - "shape":"SetTaskStatusOutput", - "documentation":"

Contains the output of SetTaskStatus.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"TaskNotFoundException", - "exception":true, - "documentation":"

The specified task was not found.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Task runners call SetTaskStatus to notify AWS Data Pipeline that a task is completed and provide information about the final status. A task runner makes this call regardless of whether the task was sucessful. A task runner does not need to call SetTaskStatus for tasks that are canceled by the web service during a call to ReportTaskProgress.

" - }, - "ValidatePipelineDefinition":{ - "name":"ValidatePipelineDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ValidatePipelineDefinitionInput", - "documentation":"

Contains the parameters for ValidatePipelineDefinition.

" - }, - "output":{ - "shape":"ValidatePipelineDefinitionOutput", - "documentation":"

Contains the output of ValidatePipelineDefinition.

" - }, - "errors":[ - { - "shape":"InternalServiceError", - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - { - "shape":"InvalidRequestException", - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - { - "shape":"PipelineNotFoundException", - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - { - "shape":"PipelineDeletedException", - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - } - ], - "documentation":"

Validates the specified pipeline definition to ensure that it is well formed and can be run without error.

" - } - }, - "shapes":{ - "ActivatePipelineInput":{ - "type":"structure", - "required":["pipelineId"], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "parameterValues":{ - "shape":"ParameterValueList", - "documentation":"

A list of parameter values to pass to the pipeline at activation.

" - }, - "startTimestamp":{ - "shape":"timestamp", - "documentation":"

The date and time to resume the pipeline. By default, the pipeline resumes from the last completed execution.

" - } - }, - "documentation":"

Contains the parameters for ActivatePipeline.

" - }, - "ActivatePipelineOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of ActivatePipeline.

" - }, - "AddTagsInput":{ - "type":"structure", - "required":[ - "pipelineId", - "tags" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "tags":{ - "shape":"tagList", - "documentation":"

The tags to add, as key/value pairs.

" - } - }, - "documentation":"

Contains the parameters for AddTags.

" - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of AddTags.

" - }, - "CreatePipelineInput":{ - "type":"structure", - "required":[ - "name", - "uniqueId" - ], - "members":{ - "name":{ - "shape":"id", - "documentation":"

The name for the pipeline. You can use the same name for multiple pipelines associated with your AWS account, because AWS Data Pipeline assigns each pipeline a unique pipeline identifier.

" - }, - "uniqueId":{ - "shape":"id", - "documentation":"

A unique identifier. This identifier is not the same as the pipeline identifier assigned by AWS Data Pipeline. You are responsible for defining the format and ensuring the uniqueness of this identifier. You use this parameter to ensure idempotency during repeated calls to CreatePipeline. For example, if the first call to CreatePipeline does not succeed, you can pass in the same unique identifier and pipeline name combination on a subsequent call to CreatePipeline. CreatePipeline ensures that if a pipeline already exists with the same name and unique identifier, a new pipeline is not created. Instead, you'll receive the pipeline identifier from the previous attempt. The uniqueness of the name and unique identifier combination is scoped to the AWS account or IAM user credentials.

" - }, - "description":{ - "shape":"string", - "documentation":"

The description for the pipeline.

" - }, - "tags":{ - "shape":"tagList", - "documentation":"

A list of tags to associate with the pipeline at creation. Tags let you control access to pipelines. For more information, see Controlling User Access to Pipelines in the AWS Data Pipeline Developer Guide.

" - } - }, - "documentation":"

Contains the parameters for CreatePipeline.

" - }, - "CreatePipelineOutput":{ - "type":"structure", - "required":["pipelineId"], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID that AWS Data Pipeline assigns the newly created pipeline. For example, df-06372391ZG65EXAMPLE.

" - } - }, - "documentation":"

Contains the output of CreatePipeline.

" - }, - "DeactivatePipelineInput":{ - "type":"structure", - "required":["pipelineId"], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "cancelActive":{ - "shape":"cancelActive", - "documentation":"

Indicates whether to cancel any running objects. The default is true, which sets the state of any running objects to CANCELED. If this value is false, the pipeline is deactivated after all running objects finish.

" - } - }, - "documentation":"

Contains the parameters for DeactivatePipeline.

" - }, - "DeactivatePipelineOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of DeactivatePipeline.

" - }, - "DeletePipelineInput":{ - "type":"structure", - "required":["pipelineId"], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - } - }, - "documentation":"

Contains the parameters for DeletePipeline.

" - }, - "DescribeObjectsInput":{ - "type":"structure", - "required":[ - "pipelineId", - "objectIds" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline that contains the object definitions.

" - }, - "objectIds":{ - "shape":"idList", - "documentation":"

The IDs of the pipeline objects that contain the definitions to be described. You can pass as many as 25 identifiers in a single call to DescribeObjects.

" - }, - "evaluateExpressions":{ - "shape":"boolean", - "documentation":"

Indicates whether any expressions in the object should be evaluated when the object descriptions are returned.

" - }, - "marker":{ - "shape":"string", - "documentation":"

The starting point for the results to be returned. For the first call, this value should be empty. As long as there are more results, continue to call DescribeObjects with the marker value from the previous call to retrieve the next set of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeObjects.

" - }, - "DescribeObjectsOutput":{ - "type":"structure", - "required":["pipelineObjects"], - "members":{ - "pipelineObjects":{ - "shape":"PipelineObjectList", - "documentation":"

An array of object definitions.

" - }, - "marker":{ - "shape":"string", - "documentation":"

The starting point for the next page of results. To view the next page of results, call DescribeObjects again with this marker value. If the value is null, there are no more results.

" - }, - "hasMoreResults":{ - "shape":"boolean", - "documentation":"

Indicates whether there are more results to return.

" - } - }, - "documentation":"

Contains the output of DescribeObjects.

" - }, - "DescribePipelinesInput":{ - "type":"structure", - "required":["pipelineIds"], - "members":{ - "pipelineIds":{ - "shape":"idList", - "documentation":"

The IDs of the pipelines to describe. You can pass as many as 25 identifiers in a single call. To obtain pipeline IDs, call ListPipelines.

" - } - }, - "documentation":"

Contains the parameters for DescribePipelines.

" - }, - "DescribePipelinesOutput":{ - "type":"structure", - "required":["pipelineDescriptionList"], - "members":{ - "pipelineDescriptionList":{ - "shape":"PipelineDescriptionList", - "documentation":"

An array of descriptions for the specified pipelines.

" - } - }, - "documentation":"

Contains the output of DescribePipelines.

" - }, - "EvaluateExpressionInput":{ - "type":"structure", - "required":[ - "pipelineId", - "objectId", - "expression" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "objectId":{ - "shape":"id", - "documentation":"

The ID of the object.

" - }, - "expression":{ - "shape":"longString", - "documentation":"

The expression to evaluate.

" - } - }, - "documentation":"

Contains the parameters for EvaluateExpression.

" - }, - "EvaluateExpressionOutput":{ - "type":"structure", - "required":["evaluatedExpression"], - "members":{ - "evaluatedExpression":{ - "shape":"longString", - "documentation":"

The evaluated expression.

" - } - }, - "documentation":"

Contains the output of EvaluateExpression.

" - }, - "Field":{ - "type":"structure", - "required":["key"], - "members":{ - "key":{ - "shape":"fieldNameString", - "documentation":"

The field identifier.

" - }, - "stringValue":{ - "shape":"fieldStringValue", - "documentation":"

The field value, expressed as a String.

" - }, - "refValue":{ - "shape":"fieldNameString", - "documentation":"

The field value, expressed as the identifier of another object.

" - } - }, - "documentation":"

A key-value pair that describes a property of a pipeline object. The value is specified as either a string value (StringValue) or a reference to another object (RefValue) but not as both.

" - }, - "GetPipelineDefinitionInput":{ - "type":"structure", - "required":["pipelineId"], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "version":{ - "shape":"string", - "documentation":"

The version of the pipeline definition to retrieve. Set this parameter to latest (default) to use the last definition saved to the pipeline or active to use the last definition that was activated.

" - } - }, - "documentation":"

Contains the parameters for GetPipelineDefinition.

" - }, - "GetPipelineDefinitionOutput":{ - "type":"structure", - "members":{ - "pipelineObjects":{ - "shape":"PipelineObjectList", - "documentation":"

The objects defined in the pipeline.

" - }, - "parameterObjects":{ - "shape":"ParameterObjectList", - "documentation":"

The parameter objects used in the pipeline definition.

" - }, - "parameterValues":{ - "shape":"ParameterValueList", - "documentation":"

The parameter values used in the pipeline definition.

" - } - }, - "documentation":"

Contains the output of GetPipelineDefinition.

" - }, - "InstanceIdentity":{ - "type":"structure", - "members":{ - "document":{ - "shape":"string", - "documentation":"

A description of an EC2 instance that is generated when the instance is launched and exposed to the instance via the instance metadata service in the form of a JSON representation of an object.

" - }, - "signature":{ - "shape":"string", - "documentation":"

A signature which can be used to verify the accuracy and authenticity of the information provided in the instance identity document.

" - } - }, - "documentation":"

Identity information for the EC2 instance that is hosting the task runner. You can get this value by calling a metadata URI from the EC2 instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide. Passing in this value proves that your task runner is running on an EC2 instance, and ensures the proper AWS Data Pipeline service charges are applied to your pipeline.

" - }, - "InternalServiceError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Description of the error message.

" - } - }, - "exception":true, - "fault":true, - "documentation":"

An internal service error occurred.

" - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Description of the error message.

" - } - }, - "exception":true, - "documentation":"

The request was not valid. Verify that your request was properly formatted, that the signature was generated with the correct credentials, and that you haven't exceeded any of the service limits for your account.

" - }, - "ListPipelinesInput":{ - "type":"structure", - "members":{ - "marker":{ - "shape":"string", - "documentation":"

The starting point for the results to be returned. For the first call, this value should be empty. As long as there are more results, continue to call ListPipelines with the marker value from the previous call to retrieve the next set of results.

" - } - }, - "documentation":"

Contains the parameters for ListPipelines.

" - }, - "ListPipelinesOutput":{ - "type":"structure", - "required":["pipelineIdList"], - "members":{ - "pipelineIdList":{ - "shape":"pipelineList", - "documentation":"

The pipeline identifiers. If you require additional information about the pipelines, you can use these identifiers to call DescribePipelines and GetPipelineDefinition.

" - }, - "marker":{ - "shape":"string", - "documentation":"

The starting point for the next page of results. To view the next page of results, call ListPipelinesOutput again with this marker value. If the value is null, there are no more results.

" - }, - "hasMoreResults":{ - "shape":"boolean", - "documentation":"

Indicates whether there are more results that can be obtained by a subsequent call.

" - } - }, - "documentation":"

Contains the output of ListPipelines.

" - }, - "Operator":{ - "type":"structure", - "members":{ - "type":{ - "shape":"OperatorType", - "documentation":"

The logical operation to be performed: equal (EQ), equal reference (REF_EQ), less than or equal (LE), greater than or equal (GE), or between (BETWEEN). Equal reference (REF_EQ) can be used only with reference fields. The other comparison types can be used only with String fields. The comparison types you can use apply only to certain object fields, as detailed below.

The comparison operators EQ and REF_EQ act on the following fields:

  • name
  • @sphere
  • parent
  • @componentParent
  • @instanceParent
  • @status
  • @scheduledStartTime
  • @scheduledEndTime
  • @actualStartTime
  • @actualEndTime

The comparison operators GE, LE, and BETWEEN act on the following fields:

  • @scheduledStartTime
  • @scheduledEndTime
  • @actualStartTime
  • @actualEndTime

Note that fields beginning with the at sign (@) are read-only and set by the web service. When you name fields, you should choose names containing only alpha-numeric values, as symbols may be reserved by AWS Data Pipeline. User-defined fields that you add to a pipeline should prefix their name with the string \"my\".

" - }, - "values":{ - "shape":"stringList", - "documentation":"

The value that the actual field value will be compared with.

" - } - }, - "documentation":"

Contains a logical operation for comparing the value of a field with a specified value.

" - }, - "OperatorType":{ - "type":"string", - "enum":[ - "EQ", - "REF_EQ", - "LE", - "GE", - "BETWEEN" - ] - }, - "ParameterAttribute":{ - "type":"structure", - "required":[ - "key", - "stringValue" - ], - "members":{ - "key":{ - "shape":"attributeNameString", - "documentation":"

The field identifier.

" - }, - "stringValue":{ - "shape":"attributeValueString", - "documentation":"

The field value, expressed as a String.

" - } - }, - "documentation":"

The attributes allowed or specified with a parameter object.

" - }, - "ParameterAttributeList":{ - "type":"list", - "member":{"shape":"ParameterAttribute"} - }, - "ParameterObject":{ - "type":"structure", - "required":[ - "id", - "attributes" - ], - "members":{ - "id":{ - "shape":"fieldNameString", - "documentation":"

The ID of the parameter object.

" - }, - "attributes":{ - "shape":"ParameterAttributeList", - "documentation":"

The attributes of the parameter object.

" - } - }, - "documentation":"

Contains information about a parameter object.

" - }, - "ParameterObjectList":{ - "type":"list", - "member":{"shape":"ParameterObject"} - }, - "ParameterValue":{ - "type":"structure", - "required":[ - "id", - "stringValue" - ], - "members":{ - "id":{ - "shape":"fieldNameString", - "documentation":"

The ID of the parameter value.

" - }, - "stringValue":{ - "shape":"fieldStringValue", - "documentation":"

The field value, expressed as a String.

" - } - }, - "documentation":"

A value or list of parameter values.

" - }, - "ParameterValueList":{ - "type":"list", - "member":{"shape":"ParameterValue"} - }, - "PipelineDeletedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Description of the error message.

" - } - }, - "exception":true, - "documentation":"

The specified pipeline has been deleted.

" - }, - "PipelineDescription":{ - "type":"structure", - "required":[ - "pipelineId", - "name", - "fields" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The pipeline identifier that was assigned by AWS Data Pipeline. This is a string of the form df-297EG78HU43EEXAMPLE.

" - }, - "name":{ - "shape":"id", - "documentation":"

The name of the pipeline.

" - }, - "fields":{ - "shape":"fieldList", - "documentation":"

A list of read-only fields that contain metadata about the pipeline: @userId, @accountId, and @pipelineState.

" - }, - "description":{ - "shape":"string", - "documentation":"

Description of the pipeline.

" - }, - "tags":{ - "shape":"tagList", - "documentation":"

A list of tags to associated with a pipeline. Tags let you control access to pipelines. For more information, see Controlling User Access to Pipelines in the AWS Data Pipeline Developer Guide.

" - } - }, - "documentation":"

Contains pipeline metadata.

" - }, - "PipelineDescriptionList":{ - "type":"list", - "member":{"shape":"PipelineDescription"} - }, - "PipelineIdName":{ - "type":"structure", - "members":{ - "id":{ - "shape":"id", - "documentation":"

The ID of the pipeline that was assigned by AWS Data Pipeline. This is a string of the form df-297EG78HU43EEXAMPLE.

" - }, - "name":{ - "shape":"id", - "documentation":"

The name of the pipeline.

" - } - }, - "documentation":"

Contains the name and identifier of a pipeline.

" - }, - "PipelineNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Description of the error message.

" - } - }, - "exception":true, - "documentation":"

The specified pipeline was not found. Verify that you used the correct user and account identifiers.

" - }, - "PipelineObject":{ - "type":"structure", - "required":[ - "id", - "name", - "fields" - ], - "members":{ - "id":{ - "shape":"id", - "documentation":"

The ID of the object.

" - }, - "name":{ - "shape":"id", - "documentation":"

The name of the object.

" - }, - "fields":{ - "shape":"fieldList", - "documentation":"

Key-value pairs that define the properties of the object.

" - } - }, - "documentation":"

Contains information about a pipeline object. This can be a logical, physical, or physical attempt pipeline object. The complete set of components of a pipeline defines the pipeline.

" - }, - "PipelineObjectList":{ - "type":"list", - "member":{"shape":"PipelineObject"} - }, - "PipelineObjectMap":{ - "type":"map", - "key":{"shape":"id"}, - "value":{"shape":"PipelineObject"} - }, - "PollForTaskInput":{ - "type":"structure", - "required":["workerGroup"], - "members":{ - "workerGroup":{ - "shape":"string", - "documentation":"

The type of task the task runner is configured to accept and process. The worker group is set as a field on objects in the pipeline when they are created. You can only specify a single value for workerGroup in the call to PollForTask. There are no wildcard values permitted in workerGroup; the string must be an exact, case-sensitive, match.

" - }, - "hostname":{ - "shape":"id", - "documentation":"

The public DNS name of the calling task runner.

" - }, - "instanceIdentity":{ - "shape":"InstanceIdentity", - "documentation":"

Identity information for the EC2 instance that is hosting the task runner. You can get this value from the instance using http://169.254.169.254/latest/meta-data/instance-id. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide. Passing in this value proves that your task runner is running on an EC2 instance, and ensures the proper AWS Data Pipeline service charges are applied to your pipeline.

" - } - }, - "documentation":"

Contains the parameters for PollForTask.

" - }, - "PollForTaskOutput":{ - "type":"structure", - "members":{ - "taskObject":{ - "shape":"TaskObject", - "documentation":"

The information needed to complete the task that is being assigned to the task runner. One of the fields returned in this object is taskId, which contains an identifier for the task being assigned. The calling task runner uses taskId in subsequent calls to ReportTaskProgress and SetTaskStatus.

" - } - }, - "documentation":"

Contains the output of PollForTask.

" - }, - "PutPipelineDefinitionInput":{ - "type":"structure", - "required":[ - "pipelineId", - "pipelineObjects" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "pipelineObjects":{ - "shape":"PipelineObjectList", - "documentation":"

The objects that define the pipeline. These objects overwrite the existing pipeline definition.

" - }, - "parameterObjects":{ - "shape":"ParameterObjectList", - "documentation":"

The parameter objects used with the pipeline.

" - }, - "parameterValues":{ - "shape":"ParameterValueList", - "documentation":"

The parameter values used with the pipeline.

" - } - }, - "documentation":"

Contains the parameters for PutPipelineDefinition.

" - }, - "PutPipelineDefinitionOutput":{ - "type":"structure", - "required":["errored"], - "members":{ - "validationErrors":{ - "shape":"ValidationErrors", - "documentation":"

The validation errors that are associated with the objects defined in pipelineObjects.

" - }, - "validationWarnings":{ - "shape":"ValidationWarnings", - "documentation":"

The validation warnings that are associated with the objects defined in pipelineObjects.

" - }, - "errored":{ - "shape":"boolean", - "documentation":"

Indicates whether there were validation errors, and the pipeline definition is stored but cannot be activated until you correct the pipeline and call PutPipelineDefinition to commit the corrected pipeline.

" - } - }, - "documentation":"

Contains the output of PutPipelineDefinition.

" - }, - "Query":{ - "type":"structure", - "members":{ - "selectors":{ - "shape":"SelectorList", - "documentation":"

List of selectors that define the query. An object must satisfy all of the selectors to match the query.

" - } - }, - "documentation":"

Defines the query to run against an object.

" - }, - "QueryObjectsInput":{ - "type":"structure", - "required":[ - "pipelineId", - "sphere" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "query":{ - "shape":"Query", - "documentation":"

The query that defines the objects to be returned. The Query object can contain a maximum of ten selectors. The conditions in the query are limited to top-level String fields in the object. These filters can be applied to components, instances, and attempts.

" - }, - "sphere":{ - "shape":"string", - "documentation":"

Indicates whether the query applies to components or instances. The possible values are: COMPONENT, INSTANCE, and ATTEMPT.

" - }, - "marker":{ - "shape":"string", - "documentation":"

The starting point for the results to be returned. For the first call, this value should be empty. As long as there are more results, continue to call QueryObjects with the marker value from the previous call to retrieve the next set of results.

" - }, - "limit":{ - "shape":"int", - "documentation":"

The maximum number of object names that QueryObjects will return in a single call. The default value is 100.

" - } - }, - "documentation":"

Contains the parameters for QueryObjects.

" - }, - "QueryObjectsOutput":{ - "type":"structure", - "members":{ - "ids":{ - "shape":"idList", - "documentation":"

The identifiers that match the query selectors.

" - }, - "marker":{ - "shape":"string", - "documentation":"

The starting point for the next page of results. To view the next page of results, call QueryObjects again with this marker value. If the value is null, there are no more results.

" - }, - "hasMoreResults":{ - "shape":"boolean", - "documentation":"

Indicates whether there are more results that can be obtained by a subsequent call.

" - } - }, - "documentation":"

Contains the output of QueryObjects.

" - }, - "RemoveTagsInput":{ - "type":"structure", - "required":[ - "pipelineId", - "tagKeys" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "tagKeys":{ - "shape":"stringList", - "documentation":"

The keys of the tags to remove.

" - } - }, - "documentation":"

Contains the parameters for RemoveTags.

" - }, - "RemoveTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of RemoveTags.

" - }, - "ReportTaskProgressInput":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"taskId", - "documentation":"

The ID of the task assigned to the task runner. This value is provided in the response for PollForTask.

" - }, - "fields":{ - "shape":"fieldList", - "documentation":"

Key-value pairs that define the properties of the ReportTaskProgressInput object.

" - } - }, - "documentation":"

Contains the parameters for ReportTaskProgress.

" - }, - "ReportTaskProgressOutput":{ - "type":"structure", - "required":["canceled"], - "members":{ - "canceled":{ - "shape":"boolean", - "documentation":"

If true, the calling task runner should cancel processing of the task. The task runner does not need to call SetTaskStatus for canceled tasks.

" - } - }, - "documentation":"

Contains the output of ReportTaskProgress.

" - }, - "ReportTaskRunnerHeartbeatInput":{ - "type":"structure", - "required":["taskrunnerId"], - "members":{ - "taskrunnerId":{ - "shape":"id", - "documentation":"

The ID of the task runner. This value should be unique across your AWS account. In the case of AWS Data Pipeline Task Runner launched on a resource managed by AWS Data Pipeline, the web service provides a unique identifier when it launches the application. If you have written a custom task runner, you should assign a unique identifier for the task runner.

" - }, - "workerGroup":{ - "shape":"string", - "documentation":"

The type of task the task runner is configured to accept and process. The worker group is set as a field on objects in the pipeline when they are created. You can only specify a single value for workerGroup. There are no wildcard values permitted in workerGroup; the string must be an exact, case-sensitive, match.

" - }, - "hostname":{ - "shape":"id", - "documentation":"

The public DNS name of the task runner.

" - } - }, - "documentation":"

Contains the parameters for ReportTaskRunnerHeartbeat.

" - }, - "ReportTaskRunnerHeartbeatOutput":{ - "type":"structure", - "required":["terminate"], - "members":{ - "terminate":{ - "shape":"boolean", - "documentation":"

Indicates whether the calling task runner should terminate.

" - } - }, - "documentation":"

Contains the output of ReportTaskRunnerHeartbeat.

" - }, - "Selector":{ - "type":"structure", - "members":{ - "fieldName":{ - "shape":"string", - "documentation":"

The name of the field that the operator will be applied to. The field name is the \"key\" portion of the field definition in the pipeline definition syntax that is used by the AWS Data Pipeline API. If the field is not set on the object, the condition fails.

" - }, - "operator":{"shape":"Operator"} - }, - "documentation":"

A comparision that is used to determine whether a query should return this object.

" - }, - "SelectorList":{ - "type":"list", - "member":{"shape":"Selector"}, - "documentation":"

The list of Selectors that define queries on individual fields.

" - }, - "SetStatusInput":{ - "type":"structure", - "required":[ - "pipelineId", - "objectIds", - "status" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline that contains the objects.

" - }, - "objectIds":{ - "shape":"idList", - "documentation":"

The IDs of the objects. The corresponding objects can be either physical or components, but not a mix of both types.

" - }, - "status":{ - "shape":"string", - "documentation":"

The status to be set on all the objects specified in objectIds. For components, use PAUSE or RESUME. For instances, use TRY_CANCEL, RERUN, or MARK_FINISHED.

" - } - }, - "documentation":"

Contains the parameters for SetStatus.

" - }, - "SetTaskStatusInput":{ - "type":"structure", - "required":[ - "taskId", - "taskStatus" - ], - "members":{ - "taskId":{ - "shape":"taskId", - "documentation":"

The ID of the task assigned to the task runner. This value is provided in the response for PollForTask.

" - }, - "taskStatus":{ - "shape":"TaskStatus", - "documentation":"

If FINISHED, the task successfully completed. If FAILED, the task ended unsuccessfully. Preconditions use false.

" - }, - "errorId":{ - "shape":"string", - "documentation":"

If an error occurred during the task, this value specifies the error code. This value is set on the physical attempt object. It is used to display error information to the user. It should not start with string \"Service_\" which is reserved by the system.

" - }, - "errorMessage":{ - "shape":"errorMessage", - "documentation":"

If an error occurred during the task, this value specifies a text description of the error. This value is set on the physical attempt object. It is used to display error information to the user. The web service does not parse this value.

" - }, - "errorStackTrace":{ - "shape":"string", - "documentation":"

If an error occurred during the task, this value specifies the stack trace associated with the error. This value is set on the physical attempt object. It is used to display error information to the user. The web service does not parse this value.

" - } - }, - "documentation":"

Contains the parameters for SetTaskStatus.

" - }, - "SetTaskStatusOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of SetTaskStatus.

" - }, - "Tag":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"tagKey", - "documentation":"

The key name of a tag defined by a user. For more information, see Controlling User Access to Pipelines in the AWS Data Pipeline Developer Guide.

" - }, - "value":{ - "shape":"tagValue", - "documentation":"

The optional value portion of a tag defined by a user. For more information, see Controlling User Access to Pipelines in the AWS Data Pipeline Developer Guide.

" - } - }, - "documentation":"

Tags are key/value pairs defined by a user and associated with a pipeline to control access. AWS Data Pipeline allows you to associate ten tags per pipeline. For more information, see Controlling User Access to Pipelines in the AWS Data Pipeline Developer Guide.

" - }, - "TaskNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Description of the error message.

" - } - }, - "exception":true, - "documentation":"

The specified task was not found.

" - }, - "TaskObject":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"taskId", - "documentation":"

An internal identifier for the task. This ID is passed to the SetTaskStatus and ReportTaskProgress actions.

" - }, - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline that provided the task.

" - }, - "attemptId":{ - "shape":"id", - "documentation":"

The ID of the pipeline task attempt object. AWS Data Pipeline uses this value to track how many times a task is attempted.

" - }, - "objects":{ - "shape":"PipelineObjectMap", - "documentation":"

Connection information for the location where the task runner will publish the output of the task.

" - } - }, - "documentation":"

Contains information about a pipeline task that is assigned to a task runner.

" - }, - "TaskStatus":{ - "type":"string", - "enum":[ - "FINISHED", - "FAILED", - "FALSE" - ] - }, - "ValidatePipelineDefinitionInput":{ - "type":"structure", - "required":[ - "pipelineId", - "pipelineObjects" - ], - "members":{ - "pipelineId":{ - "shape":"id", - "documentation":"

The ID of the pipeline.

" - }, - "pipelineObjects":{ - "shape":"PipelineObjectList", - "documentation":"

The objects that define the pipeline changes to validate against the pipeline.

" - }, - "parameterObjects":{ - "shape":"ParameterObjectList", - "documentation":"

The parameter objects used with the pipeline.

" - }, - "parameterValues":{ - "shape":"ParameterValueList", - "documentation":"

The parameter values used with the pipeline.

" - } - }, - "documentation":"

Contains the parameters for ValidatePipelineDefinition.

" - }, - "ValidatePipelineDefinitionOutput":{ - "type":"structure", - "required":["errored"], - "members":{ - "validationErrors":{ - "shape":"ValidationErrors", - "documentation":"

Any validation errors that were found.

" - }, - "validationWarnings":{ - "shape":"ValidationWarnings", - "documentation":"

Any validation warnings that were found.

" - }, - "errored":{ - "shape":"boolean", - "documentation":"

Indicates whether there were validation errors.

" - } - }, - "documentation":"

Contains the output of ValidatePipelineDefinition.

" - }, - "ValidationError":{ - "type":"structure", - "members":{ - "id":{ - "shape":"id", - "documentation":"

The identifier of the object that contains the validation error.

" - }, - "errors":{ - "shape":"validationMessages", - "documentation":"

A description of the validation error.

" - } - }, - "documentation":"

Defines a validation error. Validation errors prevent pipeline activation. The set of validation errors that can be returned are defined by AWS Data Pipeline.

" - }, - "ValidationErrors":{ - "type":"list", - "member":{"shape":"ValidationError"} - }, - "ValidationWarning":{ - "type":"structure", - "members":{ - "id":{ - "shape":"id", - "documentation":"

The identifier of the object that contains the validation warning.

" - }, - "warnings":{ - "shape":"validationMessages", - "documentation":"

A description of the validation warning.

" - } - }, - "documentation":"

Defines a validation warning. Validation warnings do not prevent pipeline activation. The set of validation warnings that can be returned are defined by AWS Data Pipeline.

" - }, - "ValidationWarnings":{ - "type":"list", - "member":{"shape":"ValidationWarning"} - }, - "attributeNameString":{ - "type":"string", - "min":1, - "max":256, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "attributeValueString":{ - "type":"string", - "min":0, - "max":10240, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "boolean":{"type":"boolean"}, - "cancelActive":{"type":"boolean"}, - "errorMessage":{"type":"string"}, - "fieldList":{ - "type":"list", - "member":{"shape":"Field"} - }, - "fieldNameString":{ - "type":"string", - "min":1, - "max":256, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "fieldStringValue":{ - "type":"string", - "min":0, - "max":10240, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "id":{ - "type":"string", - "min":1, - "max":1024, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "idList":{ - "type":"list", - "member":{"shape":"id"} - }, - "int":{"type":"integer"}, - "longString":{ - "type":"string", - "min":0, - "max":20971520, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "pipelineList":{ - "type":"list", - "member":{"shape":"PipelineIdName"} - }, - "string":{ - "type":"string", - "min":0, - "max":1024, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "stringList":{ - "type":"list", - "member":{"shape":"string"} - }, - "tagKey":{ - "type":"string", - "min":1, - "max":128 - }, - "tagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "min":0, - "max":10 - }, - "tagValue":{ - "type":"string", - "min":0, - "max":256 - }, - "taskId":{ - "type":"string", - "min":1, - "max":2048, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "timestamp":{"type":"timestamp"}, - "validationMessage":{ - "type":"string", - "min":0, - "max":10000, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "validationMessages":{ - "type":"list", - "member":{"shape":"validationMessage"} - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/service-2.json deleted file mode 100644 index b24a4576..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dax/2017-04-19/service-2.json +++ /dev/null @@ -1,1682 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-04-19", - "endpointPrefix":"dax", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon DAX", - "serviceFullName":"Amazon DynamoDB Accelerator (DAX)", - "serviceId":"DAX", - "signatureVersion":"v4", - "targetPrefix":"AmazonDAXV3", - "uid":"dax-2017-04-19" - }, - "operations":{ - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterRequest"}, - "output":{"shape":"CreateClusterResponse"}, - "errors":[ - {"shape":"ClusterAlreadyExistsFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"InsufficientClusterCapacityFault"}, - {"shape":"SubnetGroupNotFoundFault"}, - {"shape":"InvalidParameterGroupStateFault"}, - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ClusterQuotaForCustomerExceededFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"TagQuotaPerResourceExceeded"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a DAX cluster. All nodes in the cluster run the same DAX caching software.

" - }, - "CreateParameterGroup":{ - "name":"CreateParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateParameterGroupRequest"}, - "output":{"shape":"CreateParameterGroupResponse"}, - "errors":[ - {"shape":"ParameterGroupQuotaExceededFault"}, - {"shape":"ParameterGroupAlreadyExistsFault"}, - {"shape":"InvalidParameterGroupStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a new parameter group. A parameter group is a collection of parameters that you apply to all of the nodes in a DAX cluster.

" - }, - "CreateSubnetGroup":{ - "name":"CreateSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetGroupRequest"}, - "output":{"shape":"CreateSubnetGroupResponse"}, - "errors":[ - {"shape":"SubnetGroupAlreadyExistsFault"}, - {"shape":"SubnetGroupQuotaExceededFault"}, - {"shape":"SubnetQuotaExceededFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"ServiceLinkedRoleNotFoundFault"} - ], - "documentation":"

Creates a new subnet group.

" - }, - "DecreaseReplicationFactor":{ - "name":"DecreaseReplicationFactor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DecreaseReplicationFactorRequest"}, - "output":{"shape":"DecreaseReplicationFactorResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"NodeNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Removes one or more nodes from a DAX cluster.

You cannot use DecreaseReplicationFactor to remove the last node in a DAX cluster. If you need to do this, use DeleteCluster instead.

" - }, - "DeleteCluster":{ - "name":"DeleteCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterRequest"}, - "output":{"shape":"DeleteClusterResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes a previously provisioned DAX cluster. DeleteCluster deletes all associated nodes, node endpoints and the DAX cluster itself. When you receive a successful response from this action, DAX immediately begins deleting the cluster; you cannot cancel or revert this action.

" - }, - "DeleteParameterGroup":{ - "name":"DeleteParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteParameterGroupRequest"}, - "output":{"shape":"DeleteParameterGroupResponse"}, - "errors":[ - {"shape":"InvalidParameterGroupStateFault"}, - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes the specified parameter group. You cannot delete a parameter group if it is associated with any DAX clusters.

" - }, - "DeleteSubnetGroup":{ - "name":"DeleteSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetGroupRequest"}, - "output":{"shape":"DeleteSubnetGroupResponse"}, - "errors":[ - {"shape":"SubnetGroupInUseFault"}, - {"shape":"SubnetGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"} - ], - "documentation":"

Deletes a subnet group.

You cannot delete a subnet group if it is associated with any DAX clusters.

" - }, - "DescribeClusters":{ - "name":"DescribeClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClustersRequest"}, - "output":{"shape":"DescribeClustersResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns information about all provisioned DAX clusters if no cluster identifier is specified, or about a specific DAX cluster if a cluster identifier is supplied.

If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned.

If the cluster is in the DELETING state, only cluster level information will be displayed.

If nodes are currently being added to the DAX cluster, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. When the DAX cluster state is available, the cluster is ready for use.

If nodes are currently being removed from the DAX cluster, no endpoint information for the removed nodes is displayed.

" - }, - "DescribeDefaultParameters":{ - "name":"DescribeDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDefaultParametersRequest"}, - "output":{"shape":"DescribeDefaultParametersResponse"}, - "errors":[ - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns the default system parameter information for the DAX caching software.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsRequest"}, - "output":{"shape":"DescribeEventsResponse"}, - "errors":[ - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns events related to DAX clusters and parameter groups. You can obtain events specific to a particular DAX cluster or parameter group by providing the name as a parameter.

By default, only the events occurring within the last hour are returned; however, you can retrieve up to 14 days' worth of events if necessary.

" - }, - "DescribeParameterGroups":{ - "name":"DescribeParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeParameterGroupsRequest"}, - "output":{"shape":"DescribeParameterGroupsResponse"}, - "errors":[ - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns a list of parameter group descriptions. If a parameter group name is specified, the list will contain only the descriptions for that group.

" - }, - "DescribeParameters":{ - "name":"DescribeParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeParametersRequest"}, - "output":{"shape":"DescribeParametersResponse"}, - "errors":[ - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns the detailed parameter list for a particular parameter group.

" - }, - "DescribeSubnetGroups":{ - "name":"DescribeSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetGroupsRequest"}, - "output":{"shape":"DescribeSubnetGroupsResponse"}, - "errors":[ - {"shape":"SubnetGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"} - ], - "documentation":"

Returns a list of subnet group descriptions. If a subnet group name is specified, the list will contain only the description of that group.

" - }, - "IncreaseReplicationFactor":{ - "name":"IncreaseReplicationFactor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IncreaseReplicationFactorRequest"}, - "output":{"shape":"IncreaseReplicationFactorResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"InsufficientClusterCapacityFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Adds one or more nodes to a DAX cluster.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidARNFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

List all of the tags for a DAX cluster. You can call ListTags up to 10 times per second, per account.

" - }, - "RebootNode":{ - "name":"RebootNode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootNodeRequest"}, - "output":{"shape":"RebootNodeResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"NodeNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Reboots a single node of a DAX cluster. The reboot action takes place as soon as possible. During the reboot, the node status is set to REBOOTING.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"TagQuotaPerResourceExceeded"}, - {"shape":"InvalidARNFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Associates a set of tags with a DAX resource. You can call TagResource up to 5 times per second, per account.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidARNFault"}, - {"shape":"TagNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Removes the association of tags from a DAX resource. You can call UntagResource up to 5 times per second, per account.

" - }, - "UpdateCluster":{ - "name":"UpdateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateClusterRequest"}, - "output":{"shape":"UpdateClusterResponse"}, - "errors":[ - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidParameterGroupStateFault"}, - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the settings for a DAX cluster. You can use this action to change one or more cluster configuration parameters by specifying the parameters and the new values.

" - }, - "UpdateParameterGroup":{ - "name":"UpdateParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateParameterGroupRequest"}, - "output":{"shape":"UpdateParameterGroupResponse"}, - "errors":[ - {"shape":"InvalidParameterGroupStateFault"}, - {"shape":"ParameterGroupNotFoundFault"}, - {"shape":"ServiceLinkedRoleNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the parameters of a parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.

" - }, - "UpdateSubnetGroup":{ - "name":"UpdateSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSubnetGroupRequest"}, - "output":{"shape":"UpdateSubnetGroupResponse"}, - "errors":[ - {"shape":"SubnetGroupNotFoundFault"}, - {"shape":"SubnetQuotaExceededFault"}, - {"shape":"SubnetInUse"}, - {"shape":"InvalidSubnet"}, - {"shape":"ServiceLinkedRoleNotFoundFault"} - ], - "documentation":"

Modifies an existing subnet group.

" - } - }, - "shapes":{ - "AvailabilityZoneList":{ - "type":"list", - "member":{"shape":"String"} - }, - "AwsQueryErrorMessage":{"type":"string"}, - "ChangeType":{ - "type":"string", - "enum":[ - "IMMEDIATE", - "REQUIRES_REBOOT" - ] - }, - "Cluster":{ - "type":"structure", - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the DAX cluster.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the cluster.

" - }, - "ClusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that uniquely identifies the cluster.

" - }, - "TotalNodes":{ - "shape":"IntegerOptional", - "documentation":"

The total number of nodes in the cluster.

" - }, - "ActiveNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of nodes in the cluster that are active (i.e., capable of serving requests).

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type for the nodes in the cluster. (All nodes in a DAX cluster are of the same type.)

" - }, - "Status":{ - "shape":"String", - "documentation":"

The current status of the cluster.

" - }, - "ClusterDiscoveryEndpoint":{ - "shape":"Endpoint", - "documentation":"

The configuration endpoint for this DAX cluster, consisting of a DNS name and a port number. Client applications can specify this endpoint, rather than an individual node endpoint, and allow the DAX client software to intelligently route requests and responses to nodes in the DAX cluster.

" - }, - "NodeIdsToRemove":{ - "shape":"NodeIdentifierList", - "documentation":"

A list of nodes to be removed from the cluster.

" - }, - "Nodes":{ - "shape":"NodeList", - "documentation":"

A list of nodes that are currently in the cluster.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

A range of time when maintenance of DAX cluster software will be performed. For example: sun:01:00-sun:09:00. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.

" - }, - "NotificationConfiguration":{ - "shape":"NotificationConfiguration", - "documentation":"

Describes a notification topic and its status. Notification topics are used for publishing DAX events to subscribers using Amazon Simple Notification Service (SNS).

" - }, - "SubnetGroup":{ - "shape":"String", - "documentation":"

The subnet group where the DAX cluster is running.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupMembershipList", - "documentation":"

A list of security groups, and the status of each, for the nodes in the cluster.

" - }, - "IamRoleArn":{ - "shape":"String", - "documentation":"

A valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role's permissions to access DynamoDB on your behalf.

" - }, - "ParameterGroup":{ - "shape":"ParameterGroupStatus", - "documentation":"

The parameter group being used by nodes in the cluster.

" - }, - "SSEDescription":{ - "shape":"SSEDescription", - "documentation":"

The description of the server-side encryption status on the specified DAX cluster.

" - } - }, - "documentation":"

Contains all of the attributes of a specific DAX cluster.

" - }, - "ClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You already have a DAX cluster with the given identifier.

", - "exception":true - }, - "ClusterList":{ - "type":"list", - "member":{"shape":"Cluster"} - }, - "ClusterNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cluster ID does not refer to an existing DAX cluster.

", - "exception":true - }, - "ClusterQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have attempted to exceed the maximum number of DAX clusters for your AWS account.

", - "exception":true - }, - "CreateClusterRequest":{ - "type":"structure", - "required":[ - "ClusterName", - "NodeType", - "ReplicationFactor" - ], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The cluster identifier. This parameter is stored as a lowercase string.

Constraints:

  • A name must contain from 1 to 20 alphanumeric characters or hyphens.

  • The first character must be a letter.

  • A name cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the nodes in the cluster.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the cluster.

" - }, - "ReplicationFactor":{ - "shape":"Integer", - "documentation":"

The number of nodes in the DAX cluster. A replication factor of 1 will create a single-node cluster, without any read replicas. For additional fault tolerance, you can create a multiple node cluster with one or more read replicas. To do this, set ReplicationFactor to 2 or more.

AWS recommends that you have at least two read replicas per cluster.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.

" - }, - "SubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group to be used for the replication group.

DAX clusters can only run in an Amazon VPC environment. All of the subnets that you specify in a subnet group must exist in the same VPC.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdentifierList", - "documentation":"

A list of security group IDs to be assigned to each node in the DAX cluster. (Each of the security group ID is system-generated.)

If this parameter is not specified, DAX assigns the default VPC security group to each node.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the DAX cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period. Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:05:00-sun:09:00

If you don't specify a preferred maintenance window when you create or modify a cache cluster, DAX assigns a 60-minute maintenance window on a randomly selected day of the week.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent.

The Amazon SNS topic owner must be same as the DAX cluster owner.

" - }, - "IamRoleArn":{ - "shape":"String", - "documentation":"

A valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role's permissions to access DynamoDB on your behalf.

" - }, - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The parameter group to be associated with the DAX cluster.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A set of tags to associate with the DAX cluster.

" - }, - "SSESpecification":{ - "shape":"SSESpecification", - "documentation":"

Represents the settings used to enable server-side encryption on the cluster.

" - } - } - }, - "CreateClusterResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster that you have created.

" - } - } - }, - "CreateParameterGroupRequest":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to apply to all of the clusters in this replication group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter group.

" - } - } - }, - "CreateParameterGroupResponse":{ - "type":"structure", - "members":{ - "ParameterGroup":{ - "shape":"ParameterGroup", - "documentation":"

Represents the output of a CreateParameterGroup action.

" - } - } - }, - "CreateSubnetGroupRequest":{ - "type":"structure", - "required":[ - "SubnetGroupName", - "SubnetIds" - ], - "members":{ - "SubnetGroupName":{ - "shape":"String", - "documentation":"

A name for the subnet group. This value is stored as a lowercase string.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the subnet group

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

A list of VPC subnet IDs for the subnet group.

" - } - } - }, - "CreateSubnetGroupResponse":{ - "type":"structure", - "members":{ - "SubnetGroup":{ - "shape":"SubnetGroup", - "documentation":"

Represents the output of a CreateSubnetGroup operation.

" - } - } - }, - "DecreaseReplicationFactorRequest":{ - "type":"structure", - "required":[ - "ClusterName", - "NewReplicationFactor" - ], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the DAX cluster from which you want to remove nodes.

" - }, - "NewReplicationFactor":{ - "shape":"Integer", - "documentation":"

The new number of nodes for the DAX cluster.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

The Availability Zone(s) from which to remove nodes.

" - }, - "NodeIdsToRemove":{ - "shape":"NodeIdentifierList", - "documentation":"

The unique identifiers of the nodes to be removed from the cluster.

" - } - } - }, - "DecreaseReplicationFactorResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster, after you have decreased its replication factor.

" - } - } - }, - "DeleteClusterRequest":{ - "type":"structure", - "required":["ClusterName"], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the cluster to be deleted.

" - } - } - }, - "DeleteClusterResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster that is being deleted.

" - } - } - }, - "DeleteParameterGroupRequest":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to delete.

" - } - } - }, - "DeleteParameterGroupResponse":{ - "type":"structure", - "members":{ - "DeletionMessage":{ - "shape":"String", - "documentation":"

A user-specified message for this action (i.e., a reason for deleting the parameter group).

" - } - } - }, - "DeleteSubnetGroupRequest":{ - "type":"structure", - "required":["SubnetGroupName"], - "members":{ - "SubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group to delete.

" - } - } - }, - "DeleteSubnetGroupResponse":{ - "type":"structure", - "members":{ - "DeletionMessage":{ - "shape":"String", - "documentation":"

A user-specified message for this action (i.e., a reason for deleting the subnet group).

" - } - } - }, - "DescribeClustersRequest":{ - "type":"structure", - "members":{ - "ClusterNames":{ - "shape":"ClusterNameList", - "documentation":"

The names of the DAX clusters being described.

" - }, - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeClustersResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Clusters":{ - "shape":"ClusterList", - "documentation":"

The descriptions of your DAX clusters, in response to a DescribeClusters request.

" - } - } - }, - "DescribeDefaultParametersRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeDefaultParametersResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParameterList", - "documentation":"

A list of parameters. Each element in the list represents one parameter.

" - } - } - }, - "DescribeEventsRequest":{ - "type":"structure", - "members":{ - "SourceName":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format.

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format.

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes' worth of events to retrieve.

" - }, - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeEventsResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

An array of events. Each element in the array represents one event.

" - } - } - }, - "DescribeParameterGroupsRequest":{ - "type":"structure", - "members":{ - "ParameterGroupNames":{ - "shape":"ParameterGroupNameList", - "documentation":"

The names of the parameter groups.

" - }, - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeParameterGroupsResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ParameterGroups":{ - "shape":"ParameterGroupList", - "documentation":"

An array of parameter groups. Each element in the array represents one parameter group.

" - } - } - }, - "DescribeParametersRequest":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group.

" - }, - "Source":{ - "shape":"String", - "documentation":"

How the parameter is defined. For example, system denotes a system-defined parameter.

" - }, - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeParametersResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParameterList", - "documentation":"

A list of parameters within a parameter group. Each element in the list represents one parameter.

" - } - } - }, - "DescribeSubnetGroupsRequest":{ - "type":"structure", - "members":{ - "SubnetGroupNames":{ - "shape":"SubnetGroupNameList", - "documentation":"

The name of the subnet group.

" - }, - "MaxResults":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

The value for MaxResults must be between 20 and 100.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.

" - } - } - }, - "DescribeSubnetGroupsResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "SubnetGroups":{ - "shape":"SubnetGroupList", - "documentation":"

An array of subnet groups. Each element in the array represents a single subnet group.

" - } - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

The DNS hostname of the endpoint.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port number that applications should use to connect to the endpoint.

" - } - }, - "documentation":"

Represents the information required for client programs to connect to the configuration endpoint for a DAX cluster, or to an individual node within the cluster.

" - }, - "Event":{ - "type":"structure", - "members":{ - "SourceName":{ - "shape":"String", - "documentation":"

The source of the event. For example, if the event occurred at the node level, the source would be the node ID.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the origin of this event - a cluster, a parameter group, a node ID, etc.

" - }, - "Message":{ - "shape":"String", - "documentation":"

A user-defined message associated with the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

The date and time when the event occurred.

" - } - }, - "documentation":"

Represents a single occurrence of something interesting within the system. Some examples of events are creating a DAX cluster, adding or removing a node, or rebooting a node.

" - }, - "EventList":{ - "type":"list", - "member":{"shape":"Event"} - }, - "IncreaseReplicationFactorRequest":{ - "type":"structure", - "required":[ - "ClusterName", - "NewReplicationFactor" - ], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the DAX cluster that will receive additional nodes.

" - }, - "NewReplicationFactor":{ - "shape":"Integer", - "documentation":"

The new number of nodes for the DAX cluster.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.

" - } - } - }, - "IncreaseReplicationFactorResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster. with its new replication factor.

" - } - } - }, - "InsufficientClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There are not enough system resources to create the cluster you requested (or to resize an already-existing cluster).

", - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidARNFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Amazon Resource Name (ARN) supplied in the request is not valid.

", - "exception":true - }, - "InvalidClusterStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested DAX cluster is not in the available state.

", - "exception":true - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - "message":{"shape":"AwsQueryErrorMessage"} - }, - "documentation":"

Two or more incompatible parameters were specified.

", - "exception":true, - "synthetic":true - }, - "InvalidParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more parameters in a parameter group are in an invalid state.

", - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{"shape":"AwsQueryErrorMessage"} - }, - "documentation":"

The value for a parameter is invalid.

", - "exception":true, - "synthetic":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid subnet identifier was specified.

", - "exception":true - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The VPC network is in an invalid state.

", - "exception":true - }, - "IsModifiable":{ - "type":"string", - "enum":[ - "TRUE", - "FALSE", - "CONDITIONAL" - ] - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListTagsRequest":{ - "type":"structure", - "required":["ResourceName"], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The name of the DAX resource to which the tags belong.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token.

" - } - } - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags currently associated with the DAX cluster.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If this value is present, there are additional results to be displayed. To retrieve them, call ListTags again, with NextToken set to this value.

" - } - } - }, - "Node":{ - "type":"structure", - "members":{ - "NodeId":{ - "shape":"String", - "documentation":"

A system-generated identifier for the node.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The endpoint for the node, consisting of a DNS name and a port number. Client applications can connect directly to a node endpoint, if desired (as an alternative to allowing DAX client software to intelligently route requests and responses to nodes in the DAX cluster.

" - }, - "NodeCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time (in UNIX epoch format) when the node was launched.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone (AZ) in which the node has been deployed.

" - }, - "NodeStatus":{ - "shape":"String", - "documentation":"

The current status of the node. For example: available.

" - }, - "ParameterGroupStatus":{ - "shape":"String", - "documentation":"

The status of the parameter group associated with this node. For example, in-sync.

" - } - }, - "documentation":"

Represents an individual node within a DAX cluster.

" - }, - "NodeIdentifierList":{ - "type":"list", - "member":{"shape":"String"} - }, - "NodeList":{ - "type":"list", - "member":{"shape":"Node"} - }, - "NodeNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

None of the nodes in the cluster have the given node ID.

", - "exception":true - }, - "NodeQuotaForClusterExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have attempted to exceed the maximum number of nodes for a DAX cluster.

", - "exception":true - }, - "NodeQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have attempted to exceed the maximum number of nodes for your AWS account.

", - "exception":true - }, - "NodeTypeSpecificValue":{ - "type":"structure", - "members":{ - "NodeType":{ - "shape":"String", - "documentation":"

A node type to which the parameter value applies.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The parameter value for this node type.

" - } - }, - "documentation":"

Represents a parameter value that is applicable to a particular node type.

" - }, - "NodeTypeSpecificValueList":{ - "type":"list", - "member":{"shape":"NodeTypeSpecificValue"} - }, - "NotificationConfiguration":{ - "type":"structure", - "members":{ - "TopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that identifies the topic.

" - }, - "TopicStatus":{ - "shape":"String", - "documentation":"

The current state of the topic.

" - } - }, - "documentation":"

Describes a notification topic and its status. Notification topics are used for publishing DAX events to subscribers using Amazon Simple Notification Service (SNS).

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterType":{ - "shape":"ParameterType", - "documentation":"

Determines whether the parameter can be applied to any nodes, or only nodes of a particular type.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value for the parameter.

" - }, - "NodeTypeSpecificValues":{ - "shape":"NodeTypeSpecificValueList", - "documentation":"

A list of node types, and specific parameter values for each node.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter

" - }, - "Source":{ - "shape":"String", - "documentation":"

How the parameter is defined. For example, system denotes a system-defined parameter.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The data type of the parameter. For example, integer:

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

A range of values within which the parameter can be set.

" - }, - "IsModifiable":{ - "shape":"IsModifiable", - "documentation":"

Whether the customer is allowed to modify the parameter.

" - }, - "ChangeType":{ - "shape":"ChangeType", - "documentation":"

The conditions under which changes to this parameter can be applied. For example, requires-reboot indicates that a new value for this parameter will only take effect if a node is rebooted.

" - } - }, - "documentation":"

Describes an individual setting that controls some aspect of DAX behavior.

" - }, - "ParameterGroup":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter group.

" - } - }, - "documentation":"

A named set of parameters that are applied to all of the nodes in a DAX cluster.

" - }, - "ParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified parameter group already exists.

", - "exception":true - }, - "ParameterGroupList":{ - "type":"list", - "member":{"shape":"ParameterGroup"} - }, - "ParameterGroupNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified parameter group does not exist.

", - "exception":true - }, - "ParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have attempted to exceed the maximum number of parameter groups.

", - "exception":true - }, - "ParameterGroupStatus":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - }, - "NodeIdsToReboot":{ - "shape":"NodeIdentifierList", - "documentation":"

The node IDs of one or more nodes to be rebooted.

" - } - }, - "documentation":"

The status of a parameter group.

" - }, - "ParameterList":{ - "type":"list", - "member":{"shape":"Parameter"} - }, - "ParameterNameValue":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - } - }, - "documentation":"

An individual DAX parameter.

" - }, - "ParameterNameValueList":{ - "type":"list", - "member":{"shape":"ParameterNameValue"} - }, - "ParameterType":{ - "type":"string", - "enum":[ - "DEFAULT", - "NODE_TYPE_SPECIFIC" - ] - }, - "RebootNodeRequest":{ - "type":"structure", - "required":[ - "ClusterName", - "NodeId" - ], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the DAX cluster containing the node to be rebooted.

" - }, - "NodeId":{ - "shape":"String", - "documentation":"

The system-assigned ID of the node to be rebooted.

" - } - } - }, - "RebootNodeResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster after a node has been rebooted.

" - } - } - }, - "SSEDescription":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SSEStatus", - "documentation":"

The current state of server-side encryption:

  • ENABLING - Server-side encryption is being enabled.

  • ENABLED - Server-side encryption is enabled.

  • DISABLING - Server-side encryption is being disabled.

  • DISABLED - Server-side encryption is disabled.

" - } - }, - "documentation":"

The description of the server-side encryption status on the specified DAX cluster.

" - }, - "SSEEnabled":{"type":"boolean"}, - "SSESpecification":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"SSEEnabled", - "documentation":"

Indicates whether server-side encryption is enabled (true) or disabled (false) on the cluster.

" - } - }, - "documentation":"

Represents the settings used to enable server-side encryption.

" - }, - "SSEStatus":{ - "type":"string", - "enum":[ - "ENABLING", - "ENABLED", - "DISABLING", - "DISABLED" - ] - }, - "SecurityGroupIdentifierList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SecurityGroupMembership":{ - "type":"structure", - "members":{ - "SecurityGroupIdentifier":{ - "shape":"String", - "documentation":"

The unique ID for this security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of this security group.

" - } - }, - "documentation":"

An individual VPC security group and its status.

" - }, - "SecurityGroupMembershipList":{ - "type":"list", - "member":{"shape":"SecurityGroupMembership"} - }, - "ServiceLinkedRoleNotFoundFault":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "SourceType":{ - "type":"string", - "enum":[ - "CLUSTER", - "PARAMETER_GROUP", - "SUBNET_GROUP" - ] - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

The system-assigned identifier for the subnet.

" - }, - "SubnetAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone (AZ) for subnet subnet.

" - } - }, - "documentation":"

Represents the subnet associated with a DAX cluster. This parameter refers to subnets defined in Amazon Virtual Private Cloud (Amazon VPC) and used with DAX.

" - }, - "SubnetGroup":{ - "type":"structure", - "members":{ - "SubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The Amazon Virtual Private Cloud identifier (VPC ID) of the subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

A list of subnets associated with the subnet group.

" - } - }, - "documentation":"

Represents the output of one of the following actions:

  • CreateSubnetGroup

  • ModifySubnetGroup

" - }, - "SubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified subnet group already exists.

", - "exception":true - }, - "SubnetGroupInUseFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified subnet group is currently in use.

", - "exception":true - }, - "SubnetGroupList":{ - "type":"list", - "member":{"shape":"SubnetGroup"} - }, - "SubnetGroupNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet group name does not refer to an existing subnet group.

", - "exception":true - }, - "SubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a subnet group.

", - "exception":true - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubnetInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet is being used by another subnet group.

", - "exception":true - }, - "SubnetList":{ - "type":"list", - "member":{"shape":"Subnet"} - }, - "SubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a subnet group.

", - "exception":true - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key for the tag. Tag keys are case sensitive. Every DAX cluster can only have one tag with the same key. If you try to add an existing tag (same key), the existing tag value will be updated to the new value.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag. Tag values are case-sensitive and can be null.

" - } - }, - "documentation":"

A description of a tag. Every tag is a key-value pair. You can add up to 50 tags to a single DAX cluster.

AWS-assigned tag names and values are automatically assigned the aws: prefix, which the user cannot assign. AWS-assigned tag names do not count towards the tag limit of 50. User-assigned tag names have the prefix user:.

You cannot backdate the application of a tag.

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The tag does not exist.

", - "exception":true - }, - "TagQuotaPerResourceExceeded":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of tags for this DAX cluster.

", - "exception":true - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The name of the DAX resource to which tags should be added.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the DAX resource.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags that are associated with the DAX resource.

" - } - } - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The name of the DAX resource from which the tags should be removed.

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

A list of tag keys. If the DAX cluster has any tags with these keys, then the tags are removed from the cluster.

" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The tag keys that have been removed from the cluster.

" - } - } - }, - "UpdateClusterRequest":{ - "type":"structure", - "required":["ClusterName"], - "members":{ - "ClusterName":{ - "shape":"String", - "documentation":"

The name of the DAX cluster to be modified.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the changes being made to the cluster.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

A range of time when maintenance of DAX cluster software will be performed. For example: sun:01:00-sun:09:00. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that identifies the topic.

" - }, - "NotificationTopicStatus":{ - "shape":"String", - "documentation":"

The current state of the topic.

" - }, - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a parameter group for this cluster.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdentifierList", - "documentation":"

A list of user-specified security group IDs to be assigned to each node in the DAX cluster. If this parameter is not specified, DAX assigns the default VPC security group to each node.

" - } - } - }, - "UpdateClusterResponse":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

A description of the DAX cluster, after it has been modified.

" - } - } - }, - "UpdateParameterGroupRequest":{ - "type":"structure", - "required":[ - "ParameterGroupName", - "ParameterNameValues" - ], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group.

" - }, - "ParameterNameValues":{ - "shape":"ParameterNameValueList", - "documentation":"

An array of name-value pairs for the parameters in the group. Each element in the array represents a single parameter.

" - } - } - }, - "UpdateParameterGroupResponse":{ - "type":"structure", - "members":{ - "ParameterGroup":{ - "shape":"ParameterGroup", - "documentation":"

The parameter group that has been modified.

" - } - } - }, - "UpdateSubnetGroupRequest":{ - "type":"structure", - "required":["SubnetGroupName"], - "members":{ - "SubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

A list of subnet IDs in the subnet group.

" - } - } - }, - "UpdateSubnetGroupResponse":{ - "type":"structure", - "members":{ - "SubnetGroup":{ - "shape":"SubnetGroup", - "documentation":"

The subnet group that has been modified.

" - } - } - } - }, - "documentation":"

DAX is a managed caching service engineered for Amazon DynamoDB. DAX dramatically speeds up database reads by caching frequently-accessed data from DynamoDB, so applications can access that data with sub-millisecond latency. You can create a DAX cluster easily, using the AWS Management Console. With a few simple modifications to your code, your application can begin taking advantage of the DAX cluster and realize significant improvements in read performance.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/examples-1.json deleted file mode 100644 index 3b9063f8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/examples-1.json +++ /dev/null @@ -1,1242 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateDevicePool": [ - { - "input": { - "name": "MyDevicePool", - "description": "My Android devices", - "projectArn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "rules": [ - - ] - }, - "output": { - "devicePool": { - } - }, - "comments": { - "input": { - "name": "A device pool contains related devices, such as devices that run only on Android or that run only on iOS.", - "projectArn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example creates a new device pool named MyDevicePool inside an existing project.", - "id": "createdevicepool-example-1470862210860", - "title": "To create a new device pool" - } - ], - "CreateProject": [ - { - "input": { - "name": "MyProject" - }, - "output": { - "project": { - "name": "MyProject", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE", - "created": "1472660939.152" - } - }, - "comments": { - "input": { - "name": "A project in Device Farm is a workspace that contains test runs. A run is a test of a single app against one or more devices." - }, - "output": { - } - }, - "description": "The following example creates a new project named MyProject.", - "id": "createproject-example-1470862210860", - "title": "To create a new project" - } - ], - "CreateRemoteAccessSession": [ - { - "input": { - "name": "MySession", - "configuration": { - "billingMethod": "METERED" - }, - "deviceArn": "arn:aws:devicefarm:us-west-2::device:123EXAMPLE", - "projectArn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - "remoteAccessSession": { - } - }, - "comments": { - "input": { - "deviceArn": "You can get the device ARN by using the list-devices CLI command.", - "projectArn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example creates a remote access session named MySession.", - "id": "to-create-a-remote-access-session-1470970668274", - "title": "To create a remote access session" - } - ], - "CreateUpload": [ - { - "input": { - "name": "MyAppiumPythonUpload", - "type": "APPIUM_PYTHON_TEST_PACKAGE", - "projectArn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - "upload": { - "name": "MyAppiumPythonUpload", - "type": "APPIUM_PYTHON_TEST_PACKAGE", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:upload:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE", - "created": "1472661404.186", - "status": "INITIALIZED", - "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A183774035805%3Aproject%3A5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A183774035805%3Aupload%3A5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE/MyAppiumPythonUpload?AWSAccessKeyId=1234567891011EXAMPLE&Expires=1472747804&Signature=1234567891011EXAMPLE" - } - }, - "comments": { - "input": { - "projectArn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example creates a new Appium Python test package upload inside an existing project.", - "id": "createupload-example-1470864711775", - "title": "To create a new test package upload" - } - ], - "DeleteDevicePool": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the device pool ARN by using the list-device-pools CLI command." - }, - "output": { - } - }, - "description": "The following example deletes a specific device pool.", - "id": "deletedevicepool-example-1470866975494", - "title": "To delete a device pool" - } - ], - "DeleteProject": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example deletes a specific project.", - "id": "deleteproject-example-1470867374212", - "title": "To delete a project" - } - ], - "DeleteRemoteAccessSession": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the remote access session ARN by using the list-remote-access-sessions CLI command." - }, - "output": { - } - }, - "description": "The following example deletes a specific remote access session.", - "id": "to-delete-a-specific-remote-access-session-1470971431677", - "title": "To delete a specific remote access session" - } - ], - "DeleteRun": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the run ARN by using the list-runs CLI command." - }, - "output": { - } - }, - "description": "The following example deletes a specific test run.", - "id": "deleterun-example-1470867905129", - "title": "To delete a run" - } - ], - "DeleteUpload": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the upload ARN by using the list-uploads CLI command." - }, - "output": { - } - }, - "description": "The following example deletes a specific upload.", - "id": "deleteupload-example-1470868363942", - "title": "To delete a specific upload" - } - ], - "GetAccountSettings": [ - { - "input": { - }, - "output": { - "accountSettings": { - "awsAccountNumber": "123456789101", - "unmeteredDevices": { - "ANDROID": 1, - "IOS": 2 - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns information about your Device Farm account settings.", - "id": "to-get-information-about-account-settings-1472567568189", - "title": "To get information about account settings" - } - ], - "GetDevice": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2::device:123EXAMPLE" - }, - "output": { - "device": { - "name": "LG G2 (Sprint)", - "arn": "arn:aws:devicefarm:us-west-2::device:A0E6E6E1059E45918208DF75B2B7EF6C", - "cpu": { - "architecture": "armeabi-v7a", - "clock": 2265.6, - "frequency": "MHz" - }, - "formFactor": "PHONE", - "heapSize": 256000000, - "image": "75B2B7EF6C12345EXAMPLE", - "manufacturer": "LG", - "memory": 16000000000, - "model": "G2 (Sprint)", - "os": "4.2.2", - "platform": "ANDROID", - "resolution": { - "height": 1920, - "width": 1080 - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns information about a specific device.", - "id": "getdevice-example-1470870602173", - "title": "To get information about a device" - } - ], - "GetDevicePool": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - "devicePool": { - } - }, - "comments": { - "input": { - "arn": "You can obtain the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about a specific device pool, given a project ARN.", - "id": "getdevicepool-example-1470870873136", - "title": "To get information about a device pool" - } - ], - "GetDevicePoolCompatibility": [ - { - "input": { - "appArn": "arn:aws:devicefarm:us-west-2::app:123-456-EXAMPLE-GUID", - "devicePoolArn": "arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID", - "testType": "APPIUM_PYTHON" - }, - "output": { - "compatibleDevices": [ - - ], - "incompatibleDevices": [ - - ] - }, - "comments": { - "input": { - "devicePoolArn": "You can get the device pool ARN by using the list-device-pools CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about the compatibility of a specific device pool, given its ARN.", - "id": "getdevicepoolcompatibility-example-1470925003466", - "title": "To get information about the compatibility of a device pool" - } - ], - "GetJob": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2::job:123-456-EXAMPLE-GUID" - }, - "output": { - "job": { - } - }, - "comments": { - "input": { - "arn": "You can get the job ARN by using the list-jobs CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about a specific job.", - "id": "getjob-example-1470928294268", - "title": "To get information about a job" - } - ], - "GetOfferingStatus": [ - { - "input": { - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=" - }, - "output": { - "current": { - "D68B3C05-1BA6-4360-BC69-12345EXAMPLE": { - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - } - }, - "nextPeriod": { - "D68B3C05-1BA6-4360-BC69-12345EXAMPLE": { - "effectiveOn": "1472688000", - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - } - } - }, - "comments": { - "input": { - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about Device Farm offerings available to your account.", - "id": "to-get-status-information-about-device-offerings-1472568124402", - "title": "To get status information about device offerings" - } - ], - "GetProject": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE" - }, - "output": { - "project": { - "name": "My Project", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE", - "created": "1472660939.152" - } - }, - "comments": { - "input": { - "arn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example gets information about a specific project.", - "id": "to-get-a-project-1470975038449", - "title": "To get information about a project" - } - ], - "GetRemoteAccessSession": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456" - }, - "output": { - "remoteAccessSession": { - } - }, - "comments": { - "input": { - "arn": "You can get the remote access session ARN by using the list-remote-access-sessions CLI command." - }, - "output": { - } - }, - "description": "The following example gets a specific remote access session.", - "id": "to-get-a-remote-access-session-1471014119414", - "title": "To get a remote access session" - } - ], - "GetRun": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE" - }, - "output": { - "run": { - "name": "My Test Run", - "type": "BUILTIN_EXPLORER", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE", - "billingMethod": "METERED", - "completedJobs": 0, - "counters": { - "errored": 0, - "failed": 0, - "passed": 0, - "skipped": 0, - "stopped": 0, - "total": 0, - "warned": 0 - }, - "created": "1472667509.852", - "deviceMinutes": { - "metered": 0.0, - "total": 0.0, - "unmetered": 0.0 - }, - "platform": "ANDROID", - "result": "PENDING", - "status": "RUNNING", - "totalJobs": 3 - } - }, - "comments": { - "input": { - "arn": "You can get the run ARN by using the list-runs CLI command." - }, - "output": { - } - }, - "description": "The following example gets information about a specific test run.", - "id": "to-get-a-test-run-1471015895657", - "title": "To get information about a test run" - } - ], - "GetSuite": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:suite:EXAMPLE-GUID-123-456" - }, - "output": { - "suite": { - } - }, - "comments": { - "input": { - "arn": "You can get the suite ARN by using the list-suites CLI command." - }, - "output": { - } - }, - "description": "The following example gets information about a specific test suite.", - "id": "to-get-information-about-a-test-suite-1471016525008", - "title": "To get information about a test suite" - } - ], - "GetTest": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456" - }, - "output": { - "test": { - } - }, - "comments": { - "input": { - "arn": "You can get the test ARN by using the list-tests CLI command." - }, - "output": { - } - }, - "description": "The following example gets information about a specific test.", - "id": "to-get-information-about-a-specific-test-1471025744238", - "title": "To get information about a specific test" - } - ], - "GetUpload": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456" - }, - "output": { - "upload": { - } - }, - "comments": { - "input": { - "arn": "You can get the test ARN by using the list-uploads CLI command." - }, - "output": { - } - }, - "description": "The following example gets information about a specific upload.", - "id": "to-get-information-about-a-specific-upload-1471025996221", - "title": "To get information about a specific upload" - } - ], - "InstallToRemoteAccessSession": [ - { - "input": { - "appArn": "arn:aws:devicefarm:us-west-2:123456789101:app:EXAMPLE-GUID-123-456", - "remoteAccessSessionArn": "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456" - }, - "output": { - "appUpload": { - } - }, - "comments": { - "input": { - "remoteAccessSessionArn": "You can get the remote access session ARN by using the list-remote-access-sessions CLI command." - }, - "output": { - } - }, - "description": "The following example installs a specific app to a device in a specific remote access session.", - "id": "to-install-to-a-remote-access-session-1471634453818", - "title": "To install to a remote access session" - } - ], - "ListArtifacts": [ - { - "input": { - "type": "SCREENSHOT", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456" - }, - "comments": { - "input": { - "arn": "Can also be used to list artifacts for a Job, Suite, or Test ARN." - }, - "output": { - } - }, - "description": "The following example lists screenshot artifacts for a specific run.", - "id": "to-list-artifacts-for-a-resource-1471635409527", - "title": "To list artifacts for a resource" - } - ], - "ListDevicePools": [ - { - "input": { - "type": "PRIVATE", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - "devicePools": [ - { - "name": "Top Devices", - "arn": "arn:aws:devicefarm:us-west-2::devicepool:082d10e5-d7d7-48a5-ba5c-12345EXAMPLE", - "description": "Top devices", - "rules": [ - { - "value": "[\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\"]", - "attribute": "ARN", - "operator": "IN" - } - ] - }, - { - "name": "My Android Device Pool", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/bf96e75a-28f6-4e61-b6a7-12345EXAMPLE", - "description": "Samsung Galaxy Android devices", - "rules": [ - { - "value": "[\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\",\"arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE\"]", - "attribute": "ARN", - "operator": "IN" - } - ] - } - ] - }, - "comments": { - "input": { - "arn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about the private device pools in a specific project.", - "id": "to-get-information-about-device-pools-1471635745170", - "title": "To get information about device pools" - } - ], - "ListDevices": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "output": { - }, - "comments": { - "input": { - "arn": "You can get the project ARN by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about the available devices in a specific project.", - "id": "to-get-information-about-devices-1471641699344", - "title": "To get information about devices" - } - ], - "ListJobs": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456" - }, - "comments": { - "input": { - "arn": "You can get the project ARN by using the list-jobs CLI command." - }, - "output": { - } - }, - "description": "The following example returns information about jobs in a specific project.", - "id": "to-get-information-about-jobs-1471642228071", - "title": "To get information about jobs" - } - ], - "ListOfferingTransactions": [ - { - "input": { - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=" - }, - "output": { - "offeringTransactions": [ - { - "cost": { - "amount": 0, - "currencyCode": "USD" - }, - "createdOn": "1470021420", - "offeringStatus": { - "type": "RENEW", - "effectiveOn": "1472688000", - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 0 - }, - "transactionId": "03728003-d1ea-4851-abd6-12345EXAMPLE" - }, - { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "createdOn": "1470021420", - "offeringStatus": { - "type": "PURCHASE", - "effectiveOn": "1470021420", - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - }, - "transactionId": "56820b6e-06bd-473a-8ff8-12345EXAMPLE" - }, - { - "cost": { - "amount": 175, - "currencyCode": "USD" - }, - "createdOn": "1465538520", - "offeringStatus": { - "type": "PURCHASE", - "effectiveOn": "1465538520", - "offering": { - "type": "RECURRING", - "description": "Android Unmetered Device Slot", - "id": "8980F81C-00D7-469D-8EC6-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - }, - "transactionId": "953ae2c6-d760-4a04-9597-12345EXAMPLE" - }, - { - "cost": { - "amount": 8.07, - "currencyCode": "USD" - }, - "createdOn": "1459344300", - "offeringStatus": { - "type": "PURCHASE", - "effectiveOn": "1459344300", - "offering": { - "type": "RECURRING", - "description": "iOS Unmetered Device Slot", - "id": "A53D4D73-A6F6-4B82-A0B0-12345EXAMPLE", - "platform": "IOS" - }, - "quantity": 1 - }, - "transactionId": "2baf9021-ae3e-47f5-ab52-12345EXAMPLE" - } - ] - }, - "comments": { - "input": { - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about Device Farm offering transactions.", - "id": "to-get-information-about-device-offering-transactions-1472561712315", - "title": "To get information about device offering transactions" - } - ], - "ListOfferings": [ - { - "input": { - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=" - }, - "output": { - "offerings": [ - { - "type": "RECURRING", - "description": "iOS Unmetered Device Slot", - "id": "A53D4D73-A6F6-4B82-A0B0-12345EXAMPLE", - "platform": "IOS", - "recurringCharges": [ - { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "frequency": "MONTHLY" - } - ] - }, - { - "type": "RECURRING", - "description": "Android Unmetered Device Slot", - "id": "8980F81C-00D7-469D-8EC6-12345EXAMPLE", - "platform": "ANDROID", - "recurringCharges": [ - { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "frequency": "MONTHLY" - } - ] - }, - { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID", - "recurringCharges": [ - { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "frequency": "MONTHLY" - } - ] - }, - { - "type": "RECURRING", - "description": "iOS Remote Access Unmetered Device Slot", - "id": "552B4DAD-A6C9-45C4-94FB-12345EXAMPLE", - "platform": "IOS", - "recurringCharges": [ - { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "frequency": "MONTHLY" - } - ] - } - ] - }, - "comments": { - "input": { - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about available device offerings.", - "id": "to-get-information-about-device-offerings-1472562810999", - "title": "To get information about device offerings" - } - ], - "ListProjects": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "projects": [ - { - "name": "My Test Project", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE", - "created": "1453163262.105" - }, - { - "name": "Hello World", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:project:d6b087d9-56db-4e44-b9ec-12345EXAMPLE", - "created": "1470350112.439" - } - ] - }, - "comments": { - "input": { - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about the specified project in Device Farm.", - "id": "to-get-information-about-a-device-farm-project-1472564014388", - "title": "To get information about a Device Farm project" - } - ], - "ListRemoteAccessSessions": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=" - }, - "output": { - "remoteAccessSessions": [ - - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the session by using the list-sessions CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about a specific Device Farm remote access session.", - "id": "to-get-information-about-a-remote-access-session-1472581144803", - "title": "To get information about a remote access session" - } - ], - "ListRuns": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "runs": [ - { - "name": "My Test Run", - "type": "BUILTIN_EXPLORER", - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE", - "billingMethod": "METERED", - "completedJobs": 0, - "counters": { - "errored": 0, - "failed": 0, - "passed": 0, - "skipped": 0, - "stopped": 0, - "total": 0, - "warned": 0 - }, - "created": "1472667509.852", - "deviceMinutes": { - "metered": 0.0, - "total": 0.0, - "unmetered": 0.0 - }, - "platform": "ANDROID", - "result": "PENDING", - "status": "RUNNING", - "totalJobs": 3 - } - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the run by using the list-runs CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about a specific test run.", - "id": "to-get-information-about-test-runs-1472582711069", - "title": "To get information about a test run" - } - ], - "ListSamples": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "samples": [ - - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about samples, given a specific Device Farm project.", - "id": "to-get-information-about-samples-1472582847534", - "title": "To get information about samples" - } - ], - "ListSuites": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "suites": [ - - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about suites, given a specific Device Farm project.", - "id": "to-get-information-about-suites-1472583038218", - "title": "To get information about suites" - } - ], - "ListTests": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "tests": [ - - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about tests, given a specific Device Farm project.", - "id": "to-get-information-about-tests-1472617372212", - "title": "To get information about tests" - } - ], - "ListUniqueProblems": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "uniqueProblems": { - } - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about unique problems, given a specific Device Farm project.", - "id": "to-get-information-about-unique-problems-1472617781008", - "title": "To get information about unique problems" - } - ], - "ListUploads": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "nextToken": "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE" - }, - "output": { - "uploads": [ - - ] - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "nextToken": "A dynamically generated value, used for paginating results." - }, - "output": { - } - }, - "description": "The following example returns information about uploads, given a specific Device Farm project.", - "id": "to-get-information-about-uploads-1472617943090", - "title": "To get information about uploads" - } - ], - "PurchaseOffering": [ - { - "input": { - "offeringId": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "quantity": 1 - }, - "output": { - "offeringTransaction": { - "cost": { - "amount": 8.07, - "currencyCode": "USD" - }, - "createdOn": "1472648340", - "offeringStatus": { - "type": "PURCHASE", - "effectiveOn": "1472648340", - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - }, - "transactionId": "d30614ed-1b03-404c-9893-12345EXAMPLE" - } - }, - "comments": { - "input": { - "offeringId": "You can get the offering ID by using the list-offerings CLI command." - }, - "output": { - } - }, - "description": "The following example purchases a specific device slot offering.", - "id": "to-purchase-a-device-slot-offering-1472648146343", - "title": "To purchase a device slot offering" - } - ], - "RenewOffering": [ - { - "input": { - "offeringId": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "quantity": 1 - }, - "output": { - "offeringTransaction": { - "cost": { - "amount": 250, - "currencyCode": "USD" - }, - "createdOn": "1472648880", - "offeringStatus": { - "type": "RENEW", - "effectiveOn": "1472688000", - "offering": { - "type": "RECURRING", - "description": "Android Remote Access Unmetered Device Slot", - "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", - "platform": "ANDROID" - }, - "quantity": 1 - }, - "transactionId": "e90f1405-8c35-4561-be43-12345EXAMPLE" - } - }, - "comments": { - "input": { - "offeringId": "You can get the offering ID by using the list-offerings CLI command." - }, - "output": { - } - }, - "description": "The following example renews a specific device slot offering.", - "id": "to-renew-a-device-slot-offering-1472648899785", - "title": "To renew a device slot offering" - } - ], - "ScheduleRun": [ - { - "input": { - "name": "MyRun", - "devicePoolArn": "arn:aws:devicefarm:us-west-2:123456789101:pool:EXAMPLE-GUID-123-456", - "projectArn": "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", - "test": { - "type": "APPIUM_JAVA_JUNIT", - "testPackageArn": "arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456" - } - }, - "output": { - "run": { - } - }, - "comments": { - "input": { - "devicePoolArn": "You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command.", - "projectArn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.", - "testPackageArn": "You can get the Amazon Resource Name (ARN) of the test package by using the list-tests CLI command." - }, - "output": { - } - }, - "description": "The following example schedules a test run named MyRun.", - "id": "to-schedule-a-test-run-1472652429636", - "title": "To schedule a test run" - } - ], - "StopRun": [ - { - "input": { - "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456" - }, - "output": { - "run": { - } - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the test run by using the list-runs CLI command." - }, - "output": { - } - }, - "description": "The following example stops a specific test run.", - "id": "to-stop-a-test-run-1472653770340", - "title": "To stop a test run" - } - ], - "UpdateDevicePool": [ - { - "input": { - "name": "NewName", - "arn": "arn:aws:devicefarm:us-west-2::devicepool:082d10e5-d7d7-48a5-ba5c-12345EXAMPLE", - "description": "NewDescription", - "rules": [ - { - "value": "True", - "attribute": "REMOTE_ACCESS_ENABLED", - "operator": "EQUALS" - } - ] - }, - "output": { - "devicePool": { - } - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command." - }, - "output": { - "devicePool": "Note: you cannot update curated device pools." - } - }, - "description": "The following example updates the specified device pool with a new name and description. It also enables remote access of devices in the device pool.", - "id": "to-update-a-device-pool-1472653887677", - "title": "To update a device pool" - } - ], - "UpdateProject": [ - { - "input": { - "name": "NewName", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:project:8f75187d-101e-4625-accc-12345EXAMPLE" - }, - "output": { - "project": { - "name": "NewName", - "arn": "arn:aws:devicefarm:us-west-2:183774035805:project:8f75187d-101e-4625-accc-12345EXAMPLE", - "created": "1448400709.927" - } - }, - "comments": { - "input": { - "arn": "You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command." - }, - "output": { - } - }, - "description": "The following example updates the specified project with a new name.", - "id": "to-update-a-device-pool-1472653887677", - "title": "To update a device pool" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/paginators-1.json deleted file mode 100644 index 55ee7871..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/paginators-1.json +++ /dev/null @@ -1,77 +0,0 @@ -{ - "pagination": { - "ListArtifacts": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "artifacts" - }, - "ListDevicePools": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "devicePools" - }, - "ListDevices": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "devices" - }, - "ListJobs": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "jobs" - }, - "ListProjects": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "projects" - }, - "ListRuns": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "runs" - }, - "ListSamples": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "samples" - }, - "ListSuites": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "suites" - }, - "ListTests": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "tests" - }, - "ListUniqueProblems": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "uniqueProblems" - }, - "ListUploads": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "uploads" - }, - "GetOfferingStatus": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": [ - "current", - "nextPeriod" - ] - }, - "ListOfferingTransactions": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "offeringTransactions" - }, - "ListOfferings": { - "input_token": "nextToken", - "output_token": "nextToken", - "result_key": "offerings" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/service-2.json deleted file mode 100644 index b81bc1dc..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/devicefarm/2015-06-23/service-2.json +++ /dev/null @@ -1,4554 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-06-23", - "endpointPrefix":"devicefarm", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Device Farm", - "serviceId":"Device Farm", - "signatureVersion":"v4", - "targetPrefix":"DeviceFarm_20150623", - "uid":"devicefarm-2015-06-23" - }, - "operations":{ - "CreateDevicePool":{ - "name":"CreateDevicePool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDevicePoolRequest"}, - "output":{"shape":"CreateDevicePoolResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Creates a device pool.

" - }, - "CreateInstanceProfile":{ - "name":"CreateInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceProfileRequest"}, - "output":{"shape":"CreateInstanceProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Creates a profile that can be applied to one or more private fleet device instances.

" - }, - "CreateNetworkProfile":{ - "name":"CreateNetworkProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkProfileRequest"}, - "output":{"shape":"CreateNetworkProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Creates a network profile.

" - }, - "CreateProject":{ - "name":"CreateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProjectRequest"}, - "output":{"shape":"CreateProjectResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Creates a new project.

" - }, - "CreateRemoteAccessSession":{ - "name":"CreateRemoteAccessSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRemoteAccessSessionRequest"}, - "output":{"shape":"CreateRemoteAccessSessionResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Specifies and starts a remote access session.

" - }, - "CreateUpload":{ - "name":"CreateUpload", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUploadRequest"}, - "output":{"shape":"CreateUploadResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Uploads an app or test scripts.

" - }, - "CreateVPCEConfiguration":{ - "name":"CreateVPCEConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVPCEConfigurationRequest"}, - "output":{"shape":"CreateVPCEConfigurationResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Creates a configuration record in Device Farm for your Amazon Virtual Private Cloud (VPC) endpoint.

" - }, - "DeleteDevicePool":{ - "name":"DeleteDevicePool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDevicePoolRequest"}, - "output":{"shape":"DeleteDevicePoolResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes a device pool given the pool ARN. Does not allow deletion of curated pools owned by the system.

" - }, - "DeleteInstanceProfile":{ - "name":"DeleteInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInstanceProfileRequest"}, - "output":{"shape":"DeleteInstanceProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes a profile that can be applied to one or more private device instances.

" - }, - "DeleteNetworkProfile":{ - "name":"DeleteNetworkProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkProfileRequest"}, - "output":{"shape":"DeleteNetworkProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes a network profile.

" - }, - "DeleteProject":{ - "name":"DeleteProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProjectRequest"}, - "output":{"shape":"DeleteProjectResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes an AWS Device Farm project, given the project ARN.

Note Deleting this resource does not stop an in-progress run.

" - }, - "DeleteRemoteAccessSession":{ - "name":"DeleteRemoteAccessSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRemoteAccessSessionRequest"}, - "output":{"shape":"DeleteRemoteAccessSessionResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes a completed remote access session and its results.

" - }, - "DeleteRun":{ - "name":"DeleteRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRunRequest"}, - "output":{"shape":"DeleteRunResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes the run, given the run ARN.

Note Deleting this resource does not stop an in-progress run.

" - }, - "DeleteUpload":{ - "name":"DeleteUpload", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUploadRequest"}, - "output":{"shape":"DeleteUploadResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Deletes an upload given the upload ARN.

" - }, - "DeleteVPCEConfiguration":{ - "name":"DeleteVPCEConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVPCEConfigurationRequest"}, - "output":{"shape":"DeleteVPCEConfigurationResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"ServiceAccountException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Deletes a configuration for your Amazon Virtual Private Cloud (VPC) endpoint.

" - }, - "GetAccountSettings":{ - "name":"GetAccountSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAccountSettingsRequest"}, - "output":{"shape":"GetAccountSettingsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns the number of unmetered iOS and/or unmetered Android devices that have been purchased by the account.

" - }, - "GetDevice":{ - "name":"GetDevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeviceRequest"}, - "output":{"shape":"GetDeviceResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a unique device type.

" - }, - "GetDeviceInstance":{ - "name":"GetDeviceInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeviceInstanceRequest"}, - "output":{"shape":"GetDeviceInstanceResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about a device instance belonging to a private device fleet.

" - }, - "GetDevicePool":{ - "name":"GetDevicePool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDevicePoolRequest"}, - "output":{"shape":"GetDevicePoolResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a device pool.

" - }, - "GetDevicePoolCompatibility":{ - "name":"GetDevicePoolCompatibility", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDevicePoolCompatibilityRequest"}, - "output":{"shape":"GetDevicePoolCompatibilityResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about compatibility with a device pool.

" - }, - "GetInstanceProfile":{ - "name":"GetInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceProfileRequest"}, - "output":{"shape":"GetInstanceProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about the specified instance profile.

" - }, - "GetJob":{ - "name":"GetJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobRequest"}, - "output":{"shape":"GetJobResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a job.

" - }, - "GetNetworkProfile":{ - "name":"GetNetworkProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetNetworkProfileRequest"}, - "output":{"shape":"GetNetworkProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about a network profile.

" - }, - "GetOfferingStatus":{ - "name":"GetOfferingStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOfferingStatusRequest"}, - "output":{"shape":"GetOfferingStatusResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets the current status and future status of all offerings purchased by an AWS account. The response indicates how many offerings are currently available and the offerings that will be available in the next period. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "GetProject":{ - "name":"GetProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetProjectRequest"}, - "output":{"shape":"GetProjectResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a project.

" - }, - "GetRemoteAccessSession":{ - "name":"GetRemoteAccessSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRemoteAccessSessionRequest"}, - "output":{"shape":"GetRemoteAccessSessionResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns a link to a currently running remote access session.

" - }, - "GetRun":{ - "name":"GetRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRunRequest"}, - "output":{"shape":"GetRunResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a run.

" - }, - "GetSuite":{ - "name":"GetSuite", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSuiteRequest"}, - "output":{"shape":"GetSuiteResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a suite.

" - }, - "GetTest":{ - "name":"GetTest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTestRequest"}, - "output":{"shape":"GetTestResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about a test.

" - }, - "GetUpload":{ - "name":"GetUpload", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUploadRequest"}, - "output":{"shape":"GetUploadResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about an upload.

" - }, - "GetVPCEConfiguration":{ - "name":"GetVPCEConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetVPCEConfigurationRequest"}, - "output":{"shape":"GetVPCEConfigurationResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about the configuration settings for your Amazon Virtual Private Cloud (VPC) endpoint.

" - }, - "InstallToRemoteAccessSession":{ - "name":"InstallToRemoteAccessSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InstallToRemoteAccessSessionRequest"}, - "output":{"shape":"InstallToRemoteAccessSessionResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Installs an application to the device in a remote access session. For Android applications, the file must be in .apk format. For iOS applications, the file must be in .ipa format.

" - }, - "ListArtifacts":{ - "name":"ListArtifacts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListArtifactsRequest"}, - "output":{"shape":"ListArtifactsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about artifacts.

" - }, - "ListDeviceInstances":{ - "name":"ListDeviceInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeviceInstancesRequest"}, - "output":{"shape":"ListDeviceInstancesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about the private device instances associated with one or more AWS accounts.

" - }, - "ListDevicePools":{ - "name":"ListDevicePools", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDevicePoolsRequest"}, - "output":{"shape":"ListDevicePoolsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about device pools.

" - }, - "ListDevices":{ - "name":"ListDevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDevicesRequest"}, - "output":{"shape":"ListDevicesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about unique device types.

" - }, - "ListInstanceProfiles":{ - "name":"ListInstanceProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstanceProfilesRequest"}, - "output":{"shape":"ListInstanceProfilesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about all the instance profiles in an AWS account.

" - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListJobsRequest"}, - "output":{"shape":"ListJobsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about jobs for a given test run.

" - }, - "ListNetworkProfiles":{ - "name":"ListNetworkProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListNetworkProfilesRequest"}, - "output":{"shape":"ListNetworkProfilesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns the list of available network profiles.

" - }, - "ListOfferingPromotions":{ - "name":"ListOfferingPromotions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOfferingPromotionsRequest"}, - "output":{"shape":"ListOfferingPromotionsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns a list of offering promotions. Each offering promotion record contains the ID and description of the promotion. The API returns a NotEligible error if the caller is not permitted to invoke the operation. Contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "ListOfferingTransactions":{ - "name":"ListOfferingTransactions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOfferingTransactionsRequest"}, - "output":{"shape":"ListOfferingTransactionsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns a list of all historical purchases, renewals, and system renewal transactions for an AWS account. The list is paginated and ordered by a descending timestamp (most recent transactions are first). The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "ListOfferings":{ - "name":"ListOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOfferingsRequest"}, - "output":{"shape":"ListOfferingsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns a list of products or offerings that the user can manage through the API. Each offering record indicates the recurring price per unit and the frequency for that offering. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "ListProjects":{ - "name":"ListProjects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProjectsRequest"}, - "output":{"shape":"ListProjectsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about projects.

" - }, - "ListRemoteAccessSessions":{ - "name":"ListRemoteAccessSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRemoteAccessSessionsRequest"}, - "output":{"shape":"ListRemoteAccessSessionsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns a list of all currently running remote access sessions.

" - }, - "ListRuns":{ - "name":"ListRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRunsRequest"}, - "output":{"shape":"ListRunsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about runs, given an AWS Device Farm project ARN.

" - }, - "ListSamples":{ - "name":"ListSamples", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSamplesRequest"}, - "output":{"shape":"ListSamplesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about samples, given an AWS Device Farm project ARN

" - }, - "ListSuites":{ - "name":"ListSuites", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSuitesRequest"}, - "output":{"shape":"ListSuitesResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about test suites for a given job.

" - }, - "ListTests":{ - "name":"ListTests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTestsRequest"}, - "output":{"shape":"ListTestsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about tests in a given test suite.

" - }, - "ListUniqueProblems":{ - "name":"ListUniqueProblems", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUniqueProblemsRequest"}, - "output":{"shape":"ListUniqueProblemsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about unique problems.

" - }, - "ListUploads":{ - "name":"ListUploads", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUploadsRequest"}, - "output":{"shape":"ListUploadsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Gets information about uploads, given an AWS Device Farm project ARN.

" - }, - "ListVPCEConfigurations":{ - "name":"ListVPCEConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVPCEConfigurationsRequest"}, - "output":{"shape":"ListVPCEConfigurationsResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Returns information about all Amazon Virtual Private Cloud (VPC) endpoint configurations in the AWS account.

" - }, - "PurchaseOffering":{ - "name":"PurchaseOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseOfferingRequest"}, - "output":{"shape":"PurchaseOfferingResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Immediately purchases offerings for an AWS account. Offerings renew with the latest total purchased quantity for an offering, unless the renewal was overridden. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "RenewOffering":{ - "name":"RenewOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RenewOfferingRequest"}, - "output":{"shape":"RenewOfferingResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"NotEligibleException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Explicitly sets the quantity of devices to renew for an offering, starting from the effectiveDate of the next period. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.

" - }, - "ScheduleRun":{ - "name":"ScheduleRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScheduleRunRequest"}, - "output":{"shape":"ScheduleRunResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"IdempotencyException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Schedules a run.

" - }, - "StopRemoteAccessSession":{ - "name":"StopRemoteAccessSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopRemoteAccessSessionRequest"}, - "output":{"shape":"StopRemoteAccessSessionResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Ends a specified remote access session.

" - }, - "StopRun":{ - "name":"StopRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopRunRequest"}, - "output":{"shape":"StopRunResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Initiates a stop request for the current test run. AWS Device Farm will immediately stop the run on devices where tests have not started executing, and you will not be billed for these devices. On devices where tests have started executing, Setup Suite and Teardown Suite tests will run to completion before stopping execution on those devices. You will be billed for Setup, Teardown, and any tests that were in progress or already completed.

" - }, - "UpdateDeviceInstance":{ - "name":"UpdateDeviceInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDeviceInstanceRequest"}, - "output":{"shape":"UpdateDeviceInstanceResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Updates information about an existing private device instance.

" - }, - "UpdateDevicePool":{ - "name":"UpdateDevicePool", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDevicePoolRequest"}, - "output":{"shape":"UpdateDevicePoolResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Modifies the name, description, and rules in a device pool given the attributes and the pool ARN. Rule updates are all-or-nothing, meaning they can only be updated as a whole (or not at all).

" - }, - "UpdateInstanceProfile":{ - "name":"UpdateInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateInstanceProfileRequest"}, - "output":{"shape":"UpdateInstanceProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Updates information about an existing private device instance profile.

" - }, - "UpdateNetworkProfile":{ - "name":"UpdateNetworkProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNetworkProfileRequest"}, - "output":{"shape":"UpdateNetworkProfileResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Updates the network profile with specific settings.

" - }, - "UpdateProject":{ - "name":"UpdateProject", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProjectRequest"}, - "output":{"shape":"UpdateProjectResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceAccountException"} - ], - "documentation":"

Modifies the specified project name, given the project ARN and a new name.

" - }, - "UpdateVPCEConfiguration":{ - "name":"UpdateVPCEConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateVPCEConfigurationRequest"}, - "output":{"shape":"UpdateVPCEConfigurationResult"}, - "errors":[ - {"shape":"ArgumentException"}, - {"shape":"NotFoundException"}, - {"shape":"ServiceAccountException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Updates information about an existing Amazon Virtual Private Cloud (VPC) endpoint configuration.

" - } - }, - "shapes":{ - "AWSAccountNumber":{ - "type":"string", - "max":16, - "min":2 - }, - "AccountSettings":{ - "type":"structure", - "members":{ - "awsAccountNumber":{ - "shape":"AWSAccountNumber", - "documentation":"

The AWS account number specified in the AccountSettings container.

" - }, - "unmeteredDevices":{ - "shape":"PurchasedDevicesMap", - "documentation":"

Returns the unmetered devices you have purchased or want to purchase.

" - }, - "unmeteredRemoteAccessDevices":{ - "shape":"PurchasedDevicesMap", - "documentation":"

Returns the unmetered remote access devices you have purchased or want to purchase.

" - }, - "maxJobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The maximum number of minutes a test run will execute before it times out.

" - }, - "trialMinutes":{ - "shape":"TrialMinutes", - "documentation":"

Information about an AWS account's usage of free trial device minutes.

" - }, - "maxSlots":{ - "shape":"MaxSlotMap", - "documentation":"

The maximum number of device slots that the AWS account can purchase. Each maximum is expressed as an offering-id:number pair, where the offering-id represents one of the IDs returned by the ListOfferings command.

" - }, - "defaultJobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The default number of minutes (at the account level) a test run will execute before it times out. Default value is 60 minutes.

" - }, - "skipAppResign":{ - "shape":"SkipAppResign", - "documentation":"

When set to true, for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs.

" - } - }, - "documentation":"

A container for account-level settings within AWS Device Farm.

" - }, - "AccountsCleanup":{"type":"boolean"}, - "AmazonResourceName":{ - "type":"string", - "min":32 - }, - "AmazonResourceNames":{ - "type":"list", - "member":{"shape":"AmazonResourceName"} - }, - "AndroidPaths":{ - "type":"list", - "member":{"shape":"String"} - }, - "AppPackagesCleanup":{"type":"boolean"}, - "ArgumentException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Any additional information about the exception.

" - } - }, - "documentation":"

An invalid argument was specified.

", - "exception":true - }, - "Artifact":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The artifact's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The artifact's name.

" - }, - "type":{ - "shape":"ArtifactType", - "documentation":"

The artifact's type.

Allowed values include the following:

  • UNKNOWN: An unknown type.

  • SCREENSHOT: The screenshot type.

  • DEVICE_LOG: The device log type.

  • MESSAGE_LOG: The message log type.

  • RESULT_LOG: The result log type.

  • SERVICE_LOG: The service log type.

  • WEBKIT_LOG: The web kit log type.

  • INSTRUMENTATION_OUTPUT: The instrumentation type.

  • EXERCISER_MONKEY_OUTPUT: For Android, the artifact (log) generated by an Android fuzz test.

  • CALABASH_JSON_OUTPUT: The Calabash JSON output type.

  • CALABASH_PRETTY_OUTPUT: The Calabash pretty output type.

  • CALABASH_STANDARD_OUTPUT: The Calabash standard output type.

  • CALABASH_JAVA_XML_OUTPUT: The Calabash Java XML output type.

  • AUTOMATION_OUTPUT: The automation output type.

  • APPIUM_SERVER_OUTPUT: The Appium server output type.

  • APPIUM_JAVA_OUTPUT: The Appium Java output type.

  • APPIUM_JAVA_XML_OUTPUT: The Appium Java XML output type.

  • APPIUM_PYTHON_OUTPUT: The Appium Python output type.

  • APPIUM_PYTHON_XML_OUTPUT: The Appium Python XML output type.

  • EXPLORER_EVENT_LOG: The Explorer event log output type.

  • EXPLORER_SUMMARY_LOG: The Explorer summary log output type.

  • APPLICATION_CRASH_REPORT: The application crash report output type.

  • XCTEST_LOG: The XCode test output type.

" - }, - "extension":{ - "shape":"String", - "documentation":"

The artifact's file extension.

" - }, - "url":{ - "shape":"URL", - "documentation":"

The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the artifact's file.

" - } - }, - "documentation":"

Represents the output of a test. Examples of artifacts include logs and screenshots.

" - }, - "ArtifactCategory":{ - "type":"string", - "enum":[ - "SCREENSHOT", - "FILE", - "LOG" - ] - }, - "ArtifactType":{ - "type":"string", - "enum":[ - "UNKNOWN", - "SCREENSHOT", - "DEVICE_LOG", - "MESSAGE_LOG", - "VIDEO_LOG", - "RESULT_LOG", - "SERVICE_LOG", - "WEBKIT_LOG", - "INSTRUMENTATION_OUTPUT", - "EXERCISER_MONKEY_OUTPUT", - "CALABASH_JSON_OUTPUT", - "CALABASH_PRETTY_OUTPUT", - "CALABASH_STANDARD_OUTPUT", - "CALABASH_JAVA_XML_OUTPUT", - "AUTOMATION_OUTPUT", - "APPIUM_SERVER_OUTPUT", - "APPIUM_JAVA_OUTPUT", - "APPIUM_JAVA_XML_OUTPUT", - "APPIUM_PYTHON_OUTPUT", - "APPIUM_PYTHON_XML_OUTPUT", - "EXPLORER_EVENT_LOG", - "EXPLORER_SUMMARY_LOG", - "APPLICATION_CRASH_REPORT", - "XCTEST_LOG", - "VIDEO", - "CUSTOMER_ARTIFACT", - "CUSTOMER_ARTIFACT_LOG" - ] - }, - "Artifacts":{ - "type":"list", - "member":{"shape":"Artifact"} - }, - "BillingMethod":{ - "type":"string", - "enum":[ - "METERED", - "UNMETERED" - ] - }, - "Boolean":{"type":"boolean"}, - "CPU":{ - "type":"structure", - "members":{ - "frequency":{ - "shape":"String", - "documentation":"

The CPU's frequency.

" - }, - "architecture":{ - "shape":"String", - "documentation":"

The CPU's architecture, for example x86 or ARM.

" - }, - "clock":{ - "shape":"Double", - "documentation":"

The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.

" - } - }, - "documentation":"

Represents the amount of CPU that an app is using on a physical device.

Note that this does not represent system-wide CPU usage.

" - }, - "ClientId":{ - "type":"string", - "max":64, - "min":0 - }, - "ContentType":{ - "type":"string", - "max":64, - "min":0 - }, - "Counters":{ - "type":"structure", - "members":{ - "total":{ - "shape":"Integer", - "documentation":"

The total number of entities.

" - }, - "passed":{ - "shape":"Integer", - "documentation":"

The number of passed entities.

" - }, - "failed":{ - "shape":"Integer", - "documentation":"

The number of failed entities.

" - }, - "warned":{ - "shape":"Integer", - "documentation":"

The number of warned entities.

" - }, - "errored":{ - "shape":"Integer", - "documentation":"

The number of errored entities.

" - }, - "stopped":{ - "shape":"Integer", - "documentation":"

The number of stopped entities.

" - }, - "skipped":{ - "shape":"Integer", - "documentation":"

The number of skipped entities.

" - } - }, - "documentation":"

Represents entity counters.

" - }, - "CreateDevicePoolRequest":{ - "type":"structure", - "required":[ - "projectArn", - "name", - "rules" - ], - "members":{ - "projectArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the project for the device pool.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The device pool's name.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The device pool's description.

" - }, - "rules":{ - "shape":"Rules", - "documentation":"

The device pool's rules.

" - } - }, - "documentation":"

Represents a request to the create device pool operation.

" - }, - "CreateDevicePoolResult":{ - "type":"structure", - "members":{ - "devicePool":{ - "shape":"DevicePool", - "documentation":"

The newly created device pool.

" - } - }, - "documentation":"

Represents the result of a create device pool request.

" - }, - "CreateInstanceProfileRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of your instance profile.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The description of your instance profile.

" - }, - "packageCleanup":{ - "shape":"Boolean", - "documentation":"

When set to true, Device Farm will remove app packages after a test run. The default value is false for private devices.

" - }, - "excludeAppPackagesFromCleanup":{ - "shape":"PackageIds", - "documentation":"

An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.

The list of packages is only considered if you set packageCleanup to true.

" - }, - "rebootAfterUse":{ - "shape":"Boolean", - "documentation":"

When set to true, Device Farm will reboot the instance after a test run. The default value is true.

" - } - } - }, - "CreateInstanceProfileResult":{ - "type":"structure", - "members":{ - "instanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

An object containing information about your instance profile.

" - } - } - }, - "CreateNetworkProfileRequest":{ - "type":"structure", - "required":[ - "projectArn", - "name" - ], - "members":{ - "projectArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to create a network profile.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name you wish to specify for the new network profile.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The description of the network profile.

" - }, - "type":{ - "shape":"NetworkProfileType", - "documentation":"

The type of network profile you wish to create. Valid values are listed below.

" - }, - "uplinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "downlinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "uplinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

" - }, - "downlinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of received packets that fail to arrive from 0 to 100 percent.

" - } - } - }, - "CreateNetworkProfileResult":{ - "type":"structure", - "members":{ - "networkProfile":{ - "shape":"NetworkProfile", - "documentation":"

The network profile that is returned by the create network profile request.

" - } - } - }, - "CreateProjectRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The project's name.

" - }, - "defaultJobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

Sets the execution timeout value (in minutes) for a project. All test runs in this project will use the specified execution timeout value unless overridden when scheduling a run.

" - } - }, - "documentation":"

Represents a request to the create project operation.

" - }, - "CreateProjectResult":{ - "type":"structure", - "members":{ - "project":{ - "shape":"Project", - "documentation":"

The newly created project.

" - } - }, - "documentation":"

Represents the result of a create project request.

" - }, - "CreateRemoteAccessSessionConfiguration":{ - "type":"structure", - "members":{ - "billingMethod":{ - "shape":"BillingMethod", - "documentation":"

The billing method for the remote access session.

" - }, - "vpceConfigurationArns":{ - "shape":"AmazonResourceNames", - "documentation":"

An array of Amazon Resource Names (ARNs) included in the VPC endpoint configuration.

" - } - }, - "documentation":"

Configuration settings for a remote access session, including billing method.

" - }, - "CreateRemoteAccessSessionRequest":{ - "type":"structure", - "required":[ - "projectArn", - "deviceArn" - ], - "members":{ - "projectArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to create a remote access session.

" - }, - "deviceArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the device for which you want to create a remote access session.

" - }, - "instanceArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the device instance for which you want to create a remote access session.

" - }, - "sshPublicKey":{ - "shape":"SshPublicKey", - "documentation":"

The public key of the ssh key pair you want to use for connecting to remote devices in your remote debugging session. This is only required if remoteDebugEnabled is set to true.

" - }, - "remoteDebugEnabled":{ - "shape":"Boolean", - "documentation":"

Set to true if you want to access devices remotely for debugging in your remote access session.

" - }, - "remoteRecordEnabled":{ - "shape":"Boolean", - "documentation":"

Set to true to enable remote recording for the remote access session.

" - }, - "remoteRecordAppArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the remote access session that you wish to create.

" - }, - "clientId":{ - "shape":"ClientId", - "documentation":"

Unique identifier for the client. If you want access to multiple devices on the same client, you should pass the same clientId value in each call to CreateRemoteAccessSession. This is required only if remoteDebugEnabled is set to true.

" - }, - "configuration":{ - "shape":"CreateRemoteAccessSessionConfiguration", - "documentation":"

The configuration information for the remote access session request.

" - }, - "interactionMode":{ - "shape":"InteractionMode", - "documentation":"

The interaction mode of the remote access session. Valid values are:

  • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

  • NO_VIDEO: You are connected to the device but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

  • VIDEO_ONLY: You can view the screen but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

" - }, - "skipAppResign":{ - "shape":"Boolean", - "documentation":"

When set to true, for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs.

" - } - }, - "documentation":"

Creates and submits a request to start a remote access session.

" - }, - "CreateRemoteAccessSessionResult":{ - "type":"structure", - "members":{ - "remoteAccessSession":{ - "shape":"RemoteAccessSession", - "documentation":"

A container that describes the remote access session when the request to create a remote access session is sent.

" - } - }, - "documentation":"

Represents the server response from a request to create a remote access session.

" - }, - "CreateUploadRequest":{ - "type":"structure", - "required":[ - "projectArn", - "name", - "type" - ], - "members":{ - "projectArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the project for the upload.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The upload's file name. The name should not contain the '/' character. If uploading an iOS app, the file name needs to end with the .ipa extension. If uploading an Android app, the file name needs to end with the .apk extension. For all others, the file name must end with the .zip file extension.

" - }, - "type":{ - "shape":"UploadType", - "documentation":"

The upload's upload type.

Must be one of the following values:

  • ANDROID_APP: An Android upload.

  • IOS_APP: An iOS upload.

  • WEB_APP: A web appliction upload.

  • EXTERNAL_DATA: An external data upload.

  • APPIUM_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.

  • APPIUM_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.

  • APPIUM_PYTHON_TEST_PACKAGE: An Appium Python test package upload.

  • APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.

  • APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.

  • APPIUM_WEB_PYTHON_TEST_PACKAGE: An Appium Python test package upload.

  • CALABASH_TEST_PACKAGE: A Calabash test package upload.

  • INSTRUMENTATION_TEST_PACKAGE: An instrumentation upload.

  • UIAUTOMATION_TEST_PACKAGE: A uiautomation test package upload.

  • UIAUTOMATOR_TEST_PACKAGE: A uiautomator test package upload.

  • XCTEST_TEST_PACKAGE: An XCode test package upload.

  • XCTEST_UI_TEST_PACKAGE: An XCode UI test package upload.

Note If you call CreateUpload with WEB_APP specified, AWS Device Farm throws an ArgumentException error.

" - }, - "contentType":{ - "shape":"ContentType", - "documentation":"

The upload's content type (for example, \"application/octet-stream\").

" - } - }, - "documentation":"

Represents a request to the create upload operation.

" - }, - "CreateUploadResult":{ - "type":"structure", - "members":{ - "upload":{ - "shape":"Upload", - "documentation":"

The newly created upload.

" - } - }, - "documentation":"

Represents the result of a create upload request.

" - }, - "CreateVPCEConfigurationRequest":{ - "type":"structure", - "required":[ - "vpceConfigurationName", - "vpceServiceName", - "serviceDnsName" - ], - "members":{ - "vpceConfigurationName":{ - "shape":"VPCEConfigurationName", - "documentation":"

The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.

" - }, - "vpceServiceName":{ - "shape":"VPCEServiceName", - "documentation":"

The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.

" - }, - "serviceDnsName":{ - "shape":"ServiceDnsName", - "documentation":"

The DNS name of the service running in your VPC that you want Device Farm to test.

" - }, - "vpceConfigurationDescription":{ - "shape":"VPCEConfigurationDescription", - "documentation":"

An optional description, providing more details about your VPC endpoint configuration.

" - } - } - }, - "CreateVPCEConfigurationResult":{ - "type":"structure", - "members":{ - "vpceConfiguration":{ - "shape":"VPCEConfiguration", - "documentation":"

An object containing information about your VPC endpoint configuration.

" - } - } - }, - "CurrencyCode":{ - "type":"string", - "enum":["USD"] - }, - "CustomerArtifactPaths":{ - "type":"structure", - "members":{ - "iosPaths":{ - "shape":"IosPaths", - "documentation":"

Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.

" - }, - "androidPaths":{ - "shape":"AndroidPaths", - "documentation":"

Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.

" - }, - "deviceHostPaths":{ - "shape":"DeviceHostPaths", - "documentation":"

Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.

" - } - }, - "documentation":"

A JSON object specifying the paths where the artifacts generated by the customer's tests, on the device or in the test environment, will be pulled from.

Specify deviceHostPaths and optionally specify either iosPaths or androidPaths.

For web app tests, you can specify both iosPaths and androidPaths.

" - }, - "DateTime":{"type":"timestamp"}, - "DeleteDevicePoolRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

Represents the Amazon Resource Name (ARN) of the Device Farm device pool you wish to delete.

" - } - }, - "documentation":"

Represents a request to the delete device pool operation.

" - }, - "DeleteDevicePoolResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the result of a delete device pool request.

" - }, - "DeleteInstanceProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile you are requesting to delete.

" - } - } - }, - "DeleteInstanceProfileResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteNetworkProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the network profile you want to delete.

" - } - } - }, - "DeleteNetworkProfileResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteProjectRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

Represents the Amazon Resource Name (ARN) of the Device Farm project you wish to delete.

" - } - }, - "documentation":"

Represents a request to the delete project operation.

" - }, - "DeleteProjectResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the result of a delete project request.

" - }, - "DeleteRemoteAccessSessionRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the sesssion for which you want to delete remote access.

" - } - }, - "documentation":"

Represents the request to delete the specified remote access session.

" - }, - "DeleteRemoteAccessSessionResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response from the server when a request is made to delete the remote access session.

" - }, - "DeleteRunRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) for the run you wish to delete.

" - } - }, - "documentation":"

Represents a request to the delete run operation.

" - }, - "DeleteRunResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the result of a delete run request.

" - }, - "DeleteUploadRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

Represents the Amazon Resource Name (ARN) of the Device Farm upload you wish to delete.

" - } - }, - "documentation":"

Represents a request to the delete upload operation.

" - }, - "DeleteUploadResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the result of a delete upload request.

" - }, - "DeleteVPCEConfigurationRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to delete.

" - } - } - }, - "DeleteVPCEConfigurationResult":{ - "type":"structure", - "members":{ - } - }, - "Device":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The device's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The device's display name.

" - }, - "manufacturer":{ - "shape":"String", - "documentation":"

The device's manufacturer name.

" - }, - "model":{ - "shape":"String", - "documentation":"

The device's model name.

" - }, - "modelId":{ - "shape":"String", - "documentation":"

The device's model ID.

" - }, - "formFactor":{ - "shape":"DeviceFormFactor", - "documentation":"

The device's form factor.

Allowed values include:

  • PHONE: The phone form factor.

  • TABLET: The tablet form factor.

" - }, - "platform":{ - "shape":"DevicePlatform", - "documentation":"

The device's platform.

Allowed values include:

  • ANDROID: The Android platform.

  • IOS: The iOS platform.

" - }, - "os":{ - "shape":"String", - "documentation":"

The device's operating system type.

" - }, - "cpu":{ - "shape":"CPU", - "documentation":"

Information about the device's CPU.

" - }, - "resolution":{ - "shape":"Resolution", - "documentation":"

The resolution of the device.

" - }, - "heapSize":{ - "shape":"Long", - "documentation":"

The device's heap size, expressed in bytes.

" - }, - "memory":{ - "shape":"Long", - "documentation":"

The device's total memory size, expressed in bytes.

" - }, - "image":{ - "shape":"String", - "documentation":"

The device's image name.

" - }, - "carrier":{ - "shape":"String", - "documentation":"

The device's carrier.

" - }, - "radio":{ - "shape":"String", - "documentation":"

The device's radio.

" - }, - "remoteAccessEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether remote access has been enabled for the specified device.

" - }, - "remoteDebugEnabled":{ - "shape":"Boolean", - "documentation":"

This flag is set to true if remote debugging is enabled for the device.

" - }, - "fleetType":{ - "shape":"String", - "documentation":"

The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.

" - }, - "fleetName":{ - "shape":"String", - "documentation":"

The name of the fleet to which this device belongs.

" - }, - "instances":{ - "shape":"DeviceInstances", - "documentation":"

The instances belonging to this device.

" - } - }, - "documentation":"

Represents a device type that an app is tested against.

" - }, - "DeviceAttribute":{ - "type":"string", - "enum":[ - "ARN", - "PLATFORM", - "FORM_FACTOR", - "MANUFACTURER", - "REMOTE_ACCESS_ENABLED", - "REMOTE_DEBUG_ENABLED", - "APPIUM_VERSION", - "INSTANCE_ARN", - "INSTANCE_LABELS", - "FLEET_TYPE" - ] - }, - "DeviceFormFactor":{ - "type":"string", - "enum":[ - "PHONE", - "TABLET" - ] - }, - "DeviceHostPaths":{ - "type":"list", - "member":{"shape":"String"} - }, - "DeviceInstance":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the device instance.

" - }, - "deviceArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the device.

" - }, - "labels":{ - "shape":"InstanceLabels", - "documentation":"

An array of strings describing the device instance.

" - }, - "status":{ - "shape":"InstanceStatus", - "documentation":"

The status of the device instance. Valid values are listed below.

" - }, - "udid":{ - "shape":"String", - "documentation":"

Unique device identifier for the device instance.

" - }, - "instanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

A object containing information about the instance profile.

" - } - }, - "documentation":"

Represents the device instance.

" - }, - "DeviceInstances":{ - "type":"list", - "member":{"shape":"DeviceInstance"} - }, - "DeviceMinutes":{ - "type":"structure", - "members":{ - "total":{ - "shape":"Double", - "documentation":"

When specified, represents the total minutes used by the resource to run tests.

" - }, - "metered":{ - "shape":"Double", - "documentation":"

When specified, represents only the sum of metered minutes used by the resource to run tests.

" - }, - "unmetered":{ - "shape":"Double", - "documentation":"

When specified, represents only the sum of unmetered minutes used by the resource to run tests.

" - } - }, - "documentation":"

Represents the total (metered or unmetered) minutes used by the resource to run tests. Contains the sum of minutes consumed by all children.

" - }, - "DevicePlatform":{ - "type":"string", - "enum":[ - "ANDROID", - "IOS" - ] - }, - "DevicePool":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The device pool's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The device pool's name.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The device pool's description.

" - }, - "type":{ - "shape":"DevicePoolType", - "documentation":"

The device pool's type.

Allowed values include:

  • CURATED: A device pool that is created and managed by AWS Device Farm.

  • PRIVATE: A device pool that is created and managed by the device pool developer.

" - }, - "rules":{ - "shape":"Rules", - "documentation":"

Information about the device pool's rules.

" - } - }, - "documentation":"

Represents a collection of device types.

" - }, - "DevicePoolCompatibilityResult":{ - "type":"structure", - "members":{ - "device":{ - "shape":"Device", - "documentation":"

The device (phone or tablet) that you wish to return information about.

" - }, - "compatible":{ - "shape":"Boolean", - "documentation":"

Whether the result was compatible with the device pool.

" - }, - "incompatibilityMessages":{ - "shape":"IncompatibilityMessages", - "documentation":"

Information about the compatibility.

" - } - }, - "documentation":"

Represents a device pool compatibility result.

" - }, - "DevicePoolCompatibilityResults":{ - "type":"list", - "member":{"shape":"DevicePoolCompatibilityResult"} - }, - "DevicePoolType":{ - "type":"string", - "enum":[ - "CURATED", - "PRIVATE" - ] - }, - "DevicePools":{ - "type":"list", - "member":{"shape":"DevicePool"} - }, - "Devices":{ - "type":"list", - "member":{"shape":"Device"} - }, - "Double":{"type":"double"}, - "ExecutionConfiguration":{ - "type":"structure", - "members":{ - "jobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The number of minutes a test run will execute before it times out.

" - }, - "accountsCleanup":{ - "shape":"AccountsCleanup", - "documentation":"

True if account cleanup is enabled at the beginning of the test; otherwise, false.

" - }, - "appPackagesCleanup":{ - "shape":"AppPackagesCleanup", - "documentation":"

True if app package cleanup is enabled at the beginning of the test; otherwise, false.

" - }, - "skipAppResign":{ - "shape":"SkipAppResign", - "documentation":"

When set to true, for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs.

" - } - }, - "documentation":"

Represents configuration information about a test run, such as the execution timeout (in minutes).

" - }, - "ExecutionResult":{ - "type":"string", - "enum":[ - "PENDING", - "PASSED", - "WARNED", - "FAILED", - "SKIPPED", - "ERRORED", - "STOPPED" - ] - }, - "ExecutionResultCode":{ - "type":"string", - "enum":[ - "PARSING_FAILED", - "VPC_ENDPOINT_SETUP_FAILED" - ] - }, - "ExecutionStatus":{ - "type":"string", - "enum":[ - "PENDING", - "PENDING_CONCURRENCY", - "PENDING_DEVICE", - "PROCESSING", - "SCHEDULING", - "PREPARING", - "RUNNING", - "COMPLETED", - "STOPPING" - ] - }, - "Filter":{ - "type":"string", - "max":8192, - "min":0 - }, - "GetAccountSettingsRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the request sent to retrieve the account settings.

" - }, - "GetAccountSettingsResult":{ - "type":"structure", - "members":{ - "accountSettings":{ - "shape":"AccountSettings", - "documentation":"

The account settings.

" - } - }, - "documentation":"

Represents the account settings return values from the GetAccountSettings request.

" - }, - "GetDeviceInstanceRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance you're requesting information about.

" - } - } - }, - "GetDeviceInstanceResult":{ - "type":"structure", - "members":{ - "deviceInstance":{ - "shape":"DeviceInstance", - "documentation":"

An object containing information about your device instance.

" - } - } - }, - "GetDevicePoolCompatibilityRequest":{ - "type":"structure", - "required":["devicePoolArn"], - "members":{ - "devicePoolArn":{ - "shape":"AmazonResourceName", - "documentation":"

The device pool's ARN.

" - }, - "appArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the app that is associated with the specified device pool.

" - }, - "testType":{ - "shape":"TestType", - "documentation":"

The test type for the specified device pool.

Allowed values include the following:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "test":{ - "shape":"ScheduleRunTest", - "documentation":"

Information about the uploaded test to be run against the device pool.

" - }, - "configuration":{ - "shape":"ScheduleRunConfiguration", - "documentation":"

An object containing information about the settings for a run.

" - } - }, - "documentation":"

Represents a request to the get device pool compatibility operation.

" - }, - "GetDevicePoolCompatibilityResult":{ - "type":"structure", - "members":{ - "compatibleDevices":{ - "shape":"DevicePoolCompatibilityResults", - "documentation":"

Information about compatible devices.

" - }, - "incompatibleDevices":{ - "shape":"DevicePoolCompatibilityResults", - "documentation":"

Information about incompatible devices.

" - } - }, - "documentation":"

Represents the result of describe device pool compatibility request.

" - }, - "GetDevicePoolRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The device pool's ARN.

" - } - }, - "documentation":"

Represents a request to the get device pool operation.

" - }, - "GetDevicePoolResult":{ - "type":"structure", - "members":{ - "devicePool":{ - "shape":"DevicePool", - "documentation":"

An object containing information about the requested device pool.

" - } - }, - "documentation":"

Represents the result of a get device pool request.

" - }, - "GetDeviceRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The device type's ARN.

" - } - }, - "documentation":"

Represents a request to the get device request.

" - }, - "GetDeviceResult":{ - "type":"structure", - "members":{ - "device":{ - "shape":"Device", - "documentation":"

An object containing information about the requested device.

" - } - }, - "documentation":"

Represents the result of a get device request.

" - }, - "GetInstanceProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of your instance profile.

" - } - } - }, - "GetInstanceProfileResult":{ - "type":"structure", - "members":{ - "instanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

An object containing information about your instance profile.

" - } - } - }, - "GetJobRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The job's ARN.

" - } - }, - "documentation":"

Represents a request to the get job operation.

" - }, - "GetJobResult":{ - "type":"structure", - "members":{ - "job":{ - "shape":"Job", - "documentation":"

An object containing information about the requested job.

" - } - }, - "documentation":"

Represents the result of a get job request.

" - }, - "GetNetworkProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the network profile you want to return information about.

" - } - } - }, - "GetNetworkProfileResult":{ - "type":"structure", - "members":{ - "networkProfile":{ - "shape":"NetworkProfile", - "documentation":"

The network profile.

" - } - } - }, - "GetOfferingStatusRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the request to retrieve the offering status for the specified customer or account.

" - }, - "GetOfferingStatusResult":{ - "type":"structure", - "members":{ - "current":{ - "shape":"OfferingStatusMap", - "documentation":"

When specified, gets the offering status for the current period.

" - }, - "nextPeriod":{ - "shape":"OfferingStatusMap", - "documentation":"

When specified, gets the offering status for the next period.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Returns the status result for a device offering.

" - }, - "GetProjectRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The project's ARN.

" - } - }, - "documentation":"

Represents a request to the get project operation.

" - }, - "GetProjectResult":{ - "type":"structure", - "members":{ - "project":{ - "shape":"Project", - "documentation":"

The project you wish to get information about.

" - } - }, - "documentation":"

Represents the result of a get project request.

" - }, - "GetRemoteAccessSessionRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the remote access session about which you want to get session information.

" - } - }, - "documentation":"

Represents the request to get information about the specified remote access session.

" - }, - "GetRemoteAccessSessionResult":{ - "type":"structure", - "members":{ - "remoteAccessSession":{ - "shape":"RemoteAccessSession", - "documentation":"

A container that lists detailed information about the remote access session.

" - } - }, - "documentation":"

Represents the response from the server that lists detailed information about the remote access session.

" - }, - "GetRunRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The run's ARN.

" - } - }, - "documentation":"

Represents a request to the get run operation.

" - }, - "GetRunResult":{ - "type":"structure", - "members":{ - "run":{ - "shape":"Run", - "documentation":"

The run you wish to get results from.

" - } - }, - "documentation":"

Represents the result of a get run request.

" - }, - "GetSuiteRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The suite's ARN.

" - } - }, - "documentation":"

Represents a request to the get suite operation.

" - }, - "GetSuiteResult":{ - "type":"structure", - "members":{ - "suite":{ - "shape":"Suite", - "documentation":"

A collection of one or more tests.

" - } - }, - "documentation":"

Represents the result of a get suite request.

" - }, - "GetTestRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The test's ARN.

" - } - }, - "documentation":"

Represents a request to the get test operation.

" - }, - "GetTestResult":{ - "type":"structure", - "members":{ - "test":{ - "shape":"Test", - "documentation":"

A test condition that is evaluated.

" - } - }, - "documentation":"

Represents the result of a get test request.

" - }, - "GetUploadRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The upload's ARN.

" - } - }, - "documentation":"

Represents a request to the get upload operation.

" - }, - "GetUploadResult":{ - "type":"structure", - "members":{ - "upload":{ - "shape":"Upload", - "documentation":"

An app or a set of one or more tests to upload or that have been uploaded.

" - } - }, - "documentation":"

Represents the result of a get upload request.

" - }, - "GetVPCEConfigurationRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to describe.

" - } - } - }, - "GetVPCEConfigurationResult":{ - "type":"structure", - "members":{ - "vpceConfiguration":{ - "shape":"VPCEConfiguration", - "documentation":"

An object containing information about your VPC endpoint configuration.

" - } - } - }, - "HostAddress":{ - "type":"string", - "max":1024 - }, - "IdempotencyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Any additional information about the exception.

" - } - }, - "documentation":"

An entity with the same name already exists.

", - "exception":true - }, - "IncompatibilityMessage":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

A message about the incompatibility.

" - }, - "type":{ - "shape":"DeviceAttribute", - "documentation":"

The type of incompatibility.

Allowed values include:

  • ARN: The ARN.

  • FORM_FACTOR: The form factor (for example, phone or tablet).

  • MANUFACTURER: The manufacturer.

  • PLATFORM: The platform (for example, Android or iOS).

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access.

  • APPIUM_VERSION: The Appium version for the test.

" - } - }, - "documentation":"

Represents information about incompatibility.

" - }, - "IncompatibilityMessages":{ - "type":"list", - "member":{"shape":"IncompatibilityMessage"} - }, - "InstallToRemoteAccessSessionRequest":{ - "type":"structure", - "required":[ - "remoteAccessSessionArn", - "appArn" - ], - "members":{ - "remoteAccessSessionArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.

" - }, - "appArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the app about which you are requesting information.

" - } - }, - "documentation":"

Represents the request to install an Android application (in .apk format) or an iOS application (in .ipa format) as part of a remote access session.

" - }, - "InstallToRemoteAccessSessionResult":{ - "type":"structure", - "members":{ - "appUpload":{ - "shape":"Upload", - "documentation":"

An app to upload or that has been uploaded.

" - } - }, - "documentation":"

Represents the response from the server after AWS Device Farm makes a request to install to a remote access session.

" - }, - "InstanceLabels":{ - "type":"list", - "member":{"shape":"String"} - }, - "InstanceProfile":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

" - }, - "packageCleanup":{ - "shape":"Boolean", - "documentation":"

When set to true, Device Farm will remove app packages after a test run. The default value is false for private devices.

" - }, - "excludeAppPackagesFromCleanup":{ - "shape":"PackageIds", - "documentation":"

An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.

The list of packages is only considered if you set packageCleanup to true.

" - }, - "rebootAfterUse":{ - "shape":"Boolean", - "documentation":"

When set to true, Device Farm will reboot the instance after a test run. The default value is true.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the instance profile.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The description of the instance profile.

" - } - }, - "documentation":"

Represents the instance profile.

" - }, - "InstanceProfiles":{ - "type":"list", - "member":{"shape":"InstanceProfile"} - }, - "InstanceStatus":{ - "type":"string", - "enum":[ - "IN_USE", - "PREPARING", - "AVAILABLE", - "NOT_AVAILABLE" - ] - }, - "Integer":{"type":"integer"}, - "InteractionMode":{ - "type":"string", - "enum":[ - "INTERACTIVE", - "NO_VIDEO", - "VIDEO_ONLY" - ], - "max":64, - "min":0 - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

There was an error with the update request, or you do not have sufficient permissions to update this VPC endpoint configuration.

", - "exception":true - }, - "IosPaths":{ - "type":"list", - "member":{"shape":"String"} - }, - "Job":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The job's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The job's name.

" - }, - "type":{ - "shape":"TestType", - "documentation":"

The job's type.

Allowed values include the following:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the job was created.

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The job's status.

Allowed values include:

  • PENDING: A pending status.

  • PENDING_CONCURRENCY: A pending concurrency status.

  • PENDING_DEVICE: A pending device status.

  • PROCESSING: A processing status.

  • SCHEDULING: A scheduling status.

  • PREPARING: A preparing status.

  • RUNNING: A running status.

  • COMPLETED: A completed status.

  • STOPPING: A stopping status.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The job's result.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "started":{ - "shape":"DateTime", - "documentation":"

The job's start time.

" - }, - "stopped":{ - "shape":"DateTime", - "documentation":"

The job's stop time.

" - }, - "counters":{ - "shape":"Counters", - "documentation":"

The job's result counters.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the job's result.

" - }, - "device":{ - "shape":"Device", - "documentation":"

The device (phone or tablet).

" - }, - "instanceArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance.

" - }, - "deviceMinutes":{ - "shape":"DeviceMinutes", - "documentation":"

Represents the total (metered or unmetered) minutes used by the job.

" - } - }, - "documentation":"

Represents a device.

" - }, - "JobTimeoutMinutes":{"type":"integer"}, - "Jobs":{ - "type":"list", - "member":{"shape":"Job"} - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Any additional information about the exception.

" - } - }, - "documentation":"

A limit was exceeded.

", - "exception":true - }, - "ListArtifactsRequest":{ - "type":"structure", - "required":[ - "arn", - "type" - ], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Run, Job, Suite, or Test ARN.

" - }, - "type":{ - "shape":"ArtifactCategory", - "documentation":"

The artifacts' type.

Allowed values include:

  • FILE: The artifacts are files.

  • LOG: The artifacts are logs.

  • SCREENSHOT: The artifacts are screenshots.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list artifacts operation.

" - }, - "ListArtifactsResult":{ - "type":"structure", - "members":{ - "artifacts":{ - "shape":"Artifacts", - "documentation":"

Information about the artifacts.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list artifacts operation.

" - }, - "ListDeviceInstancesRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"Integer", - "documentation":"

An integer specifying the maximum number of items you want to return in the API response.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListDeviceInstancesResult":{ - "type":"structure", - "members":{ - "deviceInstances":{ - "shape":"DeviceInstances", - "documentation":"

An object containing information about your device instances.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that can be used in the next call to this operation to return the next set of items in the list.

" - } - } - }, - "ListDevicePoolsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The project ARN.

" - }, - "type":{ - "shape":"DevicePoolType", - "documentation":"

The device pools' type.

Allowed values include:

  • CURATED: A device pool that is created and managed by AWS Device Farm.

  • PRIVATE: A device pool that is created and managed by the device pool developer.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list device pools request.

" - }, - "ListDevicePoolsResult":{ - "type":"structure", - "members":{ - "devicePools":{ - "shape":"DevicePools", - "documentation":"

Information about the device pools.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list device pools request.

" - }, - "ListDevicesRequest":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list devices request.

" - }, - "ListDevicesResult":{ - "type":"structure", - "members":{ - "devices":{ - "shape":"Devices", - "documentation":"

Information about the devices.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list devices operation.

" - }, - "ListInstanceProfilesRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"Integer", - "documentation":"

An integer specifying the maximum number of items you want to return in the API response.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListInstanceProfilesResult":{ - "type":"structure", - "members":{ - "instanceProfiles":{ - "shape":"InstanceProfiles", - "documentation":"

An object containing information about your instance profiles.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that can be used in the next call to this operation to return the next set of items in the list.

" - } - } - }, - "ListJobsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The run's Amazon Resource Name (ARN).

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list jobs operation.

" - }, - "ListJobsResult":{ - "type":"structure", - "members":{ - "jobs":{ - "shape":"Jobs", - "documentation":"

Information about the jobs.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list jobs request.

" - }, - "ListNetworkProfilesRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to list network profiles.

" - }, - "type":{ - "shape":"NetworkProfileType", - "documentation":"

The type of network profile you wish to return information about. Valid values are listed below.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListNetworkProfilesResult":{ - "type":"structure", - "members":{ - "networkProfiles":{ - "shape":"NetworkProfiles", - "documentation":"

A list of the available network profiles.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListOfferingPromotionsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListOfferingPromotionsResult":{ - "type":"structure", - "members":{ - "offeringPromotions":{ - "shape":"OfferingPromotions", - "documentation":"

Information about the offering promotions.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier to be used in the next call to this operation, to return the next set of items in the list.

" - } - } - }, - "ListOfferingTransactionsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the request to list the offering transaction history.

" - }, - "ListOfferingTransactionsResult":{ - "type":"structure", - "members":{ - "offeringTransactions":{ - "shape":"OfferingTransactions", - "documentation":"

The audit log of subscriptions you have purchased and modified through AWS Device Farm.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Returns the transaction log of the specified offerings.

" - }, - "ListOfferingsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the request to list all offerings.

" - }, - "ListOfferingsResult":{ - "type":"structure", - "members":{ - "offerings":{ - "shape":"Offerings", - "documentation":"

A value representing the list offering results.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the return values of the list of offerings.

" - }, - "ListProjectsRequest":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

Optional. If no Amazon Resource Name (ARN) is specified, then AWS Device Farm returns a list of all projects for the AWS account. You can also specify a project ARN.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list projects operation.

" - }, - "ListProjectsResult":{ - "type":"structure", - "members":{ - "projects":{ - "shape":"Projects", - "documentation":"

Information about the projects.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list projects request.

" - }, - "ListRemoteAccessSessionsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the request to return information about the remote access session.

" - }, - "ListRemoteAccessSessionsResult":{ - "type":"structure", - "members":{ - "remoteAccessSessions":{ - "shape":"RemoteAccessSessions", - "documentation":"

A container representing the metadata from the service about each remote access session you are requesting.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the response from the server after AWS Device Farm makes a request to return information about the remote access session.

" - }, - "ListRunsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to list runs.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list runs operation.

" - }, - "ListRunsResult":{ - "type":"structure", - "members":{ - "runs":{ - "shape":"Runs", - "documentation":"

Information about the runs.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list runs request.

" - }, - "ListSamplesRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to list samples.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list samples operation.

" - }, - "ListSamplesResult":{ - "type":"structure", - "members":{ - "samples":{ - "shape":"Samples", - "documentation":"

Information about the samples.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list samples request.

" - }, - "ListSuitesRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The job's Amazon Resource Name (ARN).

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list suites operation.

" - }, - "ListSuitesResult":{ - "type":"structure", - "members":{ - "suites":{ - "shape":"Suites", - "documentation":"

Information about the suites.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list suites request.

" - }, - "ListTestsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The test suite's Amazon Resource Name (ARN).

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list tests operation.

" - }, - "ListTestsResult":{ - "type":"structure", - "members":{ - "tests":{ - "shape":"Tests", - "documentation":"

Information about the tests.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list tests request.

" - }, - "ListUniqueProblemsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The unique problems' ARNs.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list unique problems operation.

" - }, - "ListUniqueProblemsResult":{ - "type":"structure", - "members":{ - "uniqueProblems":{ - "shape":"UniqueProblemsByExecutionResultMap", - "documentation":"

Information about the unique problems.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list unique problems request.

" - }, - "ListUploadsRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to list uploads.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - }, - "documentation":"

Represents a request to the list uploads operation.

" - }, - "ListUploadsResult":{ - "type":"structure", - "members":{ - "uploads":{ - "shape":"Uploads", - "documentation":"

Information about the uploads.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.

" - } - }, - "documentation":"

Represents the result of a list uploads request.

" - }, - "ListVPCEConfigurationsRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"Integer", - "documentation":"

An integer specifying the maximum number of items you want to return in the API response.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "ListVPCEConfigurationsResult":{ - "type":"structure", - "members":{ - "vpceConfigurations":{ - "shape":"VPCEConfigurations", - "documentation":"

An array of VPCEConfiguration objects containing information about your VPC endpoint configuration.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "Location":{ - "type":"structure", - "required":[ - "latitude", - "longitude" - ], - "members":{ - "latitude":{ - "shape":"Double", - "documentation":"

The latitude.

" - }, - "longitude":{ - "shape":"Double", - "documentation":"

The longitude.

" - } - }, - "documentation":"

Represents a latitude and longitude pair, expressed in geographic coordinate system degrees (for example 47.6204, -122.3491).

Elevation is currently not supported.

" - }, - "Long":{"type":"long"}, - "MaxSlotMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"Integer"} - }, - "Message":{ - "type":"string", - "max":16384, - "min":0 - }, - "Metadata":{ - "type":"string", - "max":8192, - "min":0 - }, - "MonetaryAmount":{ - "type":"structure", - "members":{ - "amount":{ - "shape":"Double", - "documentation":"

The numerical amount of an offering or transaction.

" - }, - "currencyCode":{ - "shape":"CurrencyCode", - "documentation":"

The currency code of a monetary amount. For example, USD means \"U.S. dollars.\"

" - } - }, - "documentation":"

A number representing the monetary amount for an offering or transaction.

" - }, - "Name":{ - "type":"string", - "max":256, - "min":0 - }, - "NetworkProfile":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the network profile.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the network profile.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The description of the network profile.

" - }, - "type":{ - "shape":"NetworkProfileType", - "documentation":"

The type of network profile. Valid values are listed below.

" - }, - "uplinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "downlinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "uplinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

" - }, - "downlinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of received packets that fail to arrive from 0 to 100 percent.

" - } - }, - "documentation":"

An array of settings that describes characteristics of a network profile.

" - }, - "NetworkProfileType":{ - "type":"string", - "enum":[ - "CURATED", - "PRIVATE" - ] - }, - "NetworkProfiles":{ - "type":"list", - "member":{"shape":"NetworkProfile"} - }, - "NotEligibleException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

The HTTP response code of a Not Eligible exception.

" - } - }, - "documentation":"

Exception gets thrown when a user is not eligible to perform the specified transaction.

", - "exception":true - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Any additional information about the exception.

" - } - }, - "documentation":"

The specified entity was not found.

", - "exception":true - }, - "Offering":{ - "type":"structure", - "members":{ - "id":{ - "shape":"OfferingIdentifier", - "documentation":"

The ID that corresponds to a device offering.

" - }, - "description":{ - "shape":"Message", - "documentation":"

A string describing the offering.

" - }, - "type":{ - "shape":"OfferingType", - "documentation":"

The type of offering (e.g., \"RECURRING\") for a device.

" - }, - "platform":{ - "shape":"DevicePlatform", - "documentation":"

The platform of the device (e.g., ANDROID or IOS).

" - }, - "recurringCharges":{ - "shape":"RecurringCharges", - "documentation":"

Specifies whether there are recurring charges for the offering.

" - } - }, - "documentation":"

Represents the metadata of a device offering.

" - }, - "OfferingIdentifier":{ - "type":"string", - "min":32 - }, - "OfferingPromotion":{ - "type":"structure", - "members":{ - "id":{ - "shape":"OfferingPromotionIdentifier", - "documentation":"

The ID of the offering promotion.

" - }, - "description":{ - "shape":"Message", - "documentation":"

A string describing the offering promotion.

" - } - }, - "documentation":"

Represents information about an offering promotion.

" - }, - "OfferingPromotionIdentifier":{ - "type":"string", - "min":4 - }, - "OfferingPromotions":{ - "type":"list", - "member":{"shape":"OfferingPromotion"} - }, - "OfferingStatus":{ - "type":"structure", - "members":{ - "type":{ - "shape":"OfferingTransactionType", - "documentation":"

The type specified for the offering status.

" - }, - "offering":{ - "shape":"Offering", - "documentation":"

Represents the metadata of an offering status.

" - }, - "quantity":{ - "shape":"Integer", - "documentation":"

The number of available devices in the offering.

" - }, - "effectiveOn":{ - "shape":"DateTime", - "documentation":"

The date on which the offering is effective.

" - } - }, - "documentation":"

The status of the offering.

" - }, - "OfferingStatusMap":{ - "type":"map", - "key":{"shape":"OfferingIdentifier"}, - "value":{"shape":"OfferingStatus"} - }, - "OfferingTransaction":{ - "type":"structure", - "members":{ - "offeringStatus":{ - "shape":"OfferingStatus", - "documentation":"

The status of an offering transaction.

" - }, - "transactionId":{ - "shape":"TransactionIdentifier", - "documentation":"

The transaction ID of the offering transaction.

" - }, - "offeringPromotionId":{ - "shape":"OfferingPromotionIdentifier", - "documentation":"

The ID that corresponds to a device offering promotion.

" - }, - "createdOn":{ - "shape":"DateTime", - "documentation":"

The date on which an offering transaction was created.

" - }, - "cost":{ - "shape":"MonetaryAmount", - "documentation":"

The cost of an offering transaction.

" - } - }, - "documentation":"

Represents the metadata of an offering transaction.

" - }, - "OfferingTransactionType":{ - "type":"string", - "enum":[ - "PURCHASE", - "RENEW", - "SYSTEM" - ] - }, - "OfferingTransactions":{ - "type":"list", - "member":{"shape":"OfferingTransaction"} - }, - "OfferingType":{ - "type":"string", - "enum":["RECURRING"] - }, - "Offerings":{ - "type":"list", - "member":{"shape":"Offering"} - }, - "PackageIds":{ - "type":"list", - "member":{"shape":"String"} - }, - "PaginationToken":{ - "type":"string", - "max":1024, - "min":4 - }, - "PercentInteger":{ - "type":"integer", - "max":100, - "min":0 - }, - "Problem":{ - "type":"structure", - "members":{ - "run":{ - "shape":"ProblemDetail", - "documentation":"

Information about the associated run.

" - }, - "job":{ - "shape":"ProblemDetail", - "documentation":"

Information about the associated job.

" - }, - "suite":{ - "shape":"ProblemDetail", - "documentation":"

Information about the associated suite.

" - }, - "test":{ - "shape":"ProblemDetail", - "documentation":"

Information about the associated test.

" - }, - "device":{ - "shape":"Device", - "documentation":"

Information about the associated device.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The problem's result.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the problem's result.

" - } - }, - "documentation":"

Represents a specific warning or failure.

" - }, - "ProblemDetail":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The problem detail's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The problem detail's name.

" - } - }, - "documentation":"

Information about a problem detail.

" - }, - "Problems":{ - "type":"list", - "member":{"shape":"Problem"} - }, - "Project":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The project's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The project's name.

" - }, - "defaultJobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the project was created.

" - } - }, - "documentation":"

Represents an operating-system neutral workspace for running and managing tests.

" - }, - "Projects":{ - "type":"list", - "member":{"shape":"Project"} - }, - "PurchaseOfferingRequest":{ - "type":"structure", - "members":{ - "offeringId":{ - "shape":"OfferingIdentifier", - "documentation":"

The ID of the offering.

" - }, - "quantity":{ - "shape":"Integer", - "documentation":"

The number of device slots you wish to purchase in an offering request.

" - }, - "offeringPromotionId":{ - "shape":"OfferingPromotionIdentifier", - "documentation":"

The ID of the offering promotion to be applied to the purchase.

" - } - }, - "documentation":"

Represents a request for a purchase offering.

" - }, - "PurchaseOfferingResult":{ - "type":"structure", - "members":{ - "offeringTransaction":{ - "shape":"OfferingTransaction", - "documentation":"

Represents the offering transaction for the purchase result.

" - } - }, - "documentation":"

The result of the purchase offering (e.g., success or failure).

" - }, - "PurchasedDevicesMap":{ - "type":"map", - "key":{"shape":"DevicePlatform"}, - "value":{"shape":"Integer"} - }, - "Radios":{ - "type":"structure", - "members":{ - "wifi":{ - "shape":"Boolean", - "documentation":"

True if Wi-Fi is enabled at the beginning of the test; otherwise, false.

" - }, - "bluetooth":{ - "shape":"Boolean", - "documentation":"

True if Bluetooth is enabled at the beginning of the test; otherwise, false.

" - }, - "nfc":{ - "shape":"Boolean", - "documentation":"

True if NFC is enabled at the beginning of the test; otherwise, false.

" - }, - "gps":{ - "shape":"Boolean", - "documentation":"

True if GPS is enabled at the beginning of the test; otherwise, false.

" - } - }, - "documentation":"

Represents the set of radios and their states on a device. Examples of radios include Wi-Fi, GPS, Bluetooth, and NFC.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "cost":{ - "shape":"MonetaryAmount", - "documentation":"

The cost of the recurring charge.

" - }, - "frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency in which charges will recur.

" - } - }, - "documentation":"

Specifies whether charges for devices will be recurring.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["MONTHLY"] - }, - "RecurringCharges":{ - "type":"list", - "member":{"shape":"RecurringCharge"} - }, - "RemoteAccessSession":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the remote access session.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the remote access session.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

The date and time the remote access session was created.

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The status of the remote access session. Can be any of the following:

  • PENDING: A pending status.

  • PENDING_CONCURRENCY: A pending concurrency status.

  • PENDING_DEVICE: A pending device status.

  • PROCESSING: A processing status.

  • SCHEDULING: A scheduling status.

  • PREPARING: A preparing status.

  • RUNNING: A running status.

  • COMPLETED: A completed status.

  • STOPPING: A stopping status.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The result of the remote access session. Can be any of the following:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the remote access session.

" - }, - "started":{ - "shape":"DateTime", - "documentation":"

The date and time the remote access session was started.

" - }, - "stopped":{ - "shape":"DateTime", - "documentation":"

The date and time the remote access session was stopped.

" - }, - "device":{ - "shape":"Device", - "documentation":"

The device (phone or tablet) used in the remote access session.

" - }, - "instanceArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance.

" - }, - "remoteDebugEnabled":{ - "shape":"Boolean", - "documentation":"

This flag is set to true if remote debugging is enabled for the remote access session.

" - }, - "remoteRecordEnabled":{ - "shape":"Boolean", - "documentation":"

This flag is set to true if remote recording is enabled for the remote access session.

" - }, - "remoteRecordAppArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.

" - }, - "hostAddress":{ - "shape":"HostAddress", - "documentation":"

IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.

" - }, - "clientId":{ - "shape":"ClientId", - "documentation":"

Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.

" - }, - "billingMethod":{ - "shape":"BillingMethod", - "documentation":"

The billing method of the remote access session. Possible values include METERED or UNMETERED. For more information about metered devices, see AWS Device Farm terminology.\"

" - }, - "deviceMinutes":{ - "shape":"DeviceMinutes", - "documentation":"

The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).

" - }, - "endpoint":{ - "shape":"String", - "documentation":"

The endpoint for the remote access sesssion.

" - }, - "deviceUdid":{ - "shape":"String", - "documentation":"

Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.

" - }, - "interactionMode":{ - "shape":"InteractionMode", - "documentation":"

The interaction mode of the remote access session. Valid values are:

  • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

  • NO_VIDEO: You are connected to the device but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

  • VIDEO_ONLY: You can view the screen but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

" - }, - "skipAppResign":{ - "shape":"SkipAppResign", - "documentation":"

When set to true, for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs.

" - } - }, - "documentation":"

Represents information about the remote access session.

" - }, - "RemoteAccessSessions":{ - "type":"list", - "member":{"shape":"RemoteAccessSession"} - }, - "RenewOfferingRequest":{ - "type":"structure", - "members":{ - "offeringId":{ - "shape":"OfferingIdentifier", - "documentation":"

The ID of a request to renew an offering.

" - }, - "quantity":{ - "shape":"Integer", - "documentation":"

The quantity requested in an offering renewal.

" - } - }, - "documentation":"

A request representing an offering renewal.

" - }, - "RenewOfferingResult":{ - "type":"structure", - "members":{ - "offeringTransaction":{ - "shape":"OfferingTransaction", - "documentation":"

Represents the status of the offering transaction for the renewal.

" - } - }, - "documentation":"

The result of a renewal offering.

" - }, - "Resolution":{ - "type":"structure", - "members":{ - "width":{ - "shape":"Integer", - "documentation":"

The screen resolution's width, expressed in pixels.

" - }, - "height":{ - "shape":"Integer", - "documentation":"

The screen resolution's height, expressed in pixels.

" - } - }, - "documentation":"

Represents the screen resolution of a device in height and width, expressed in pixels.

" - }, - "Rule":{ - "type":"structure", - "members":{ - "attribute":{ - "shape":"DeviceAttribute", - "documentation":"

The rule's stringified attribute. For example, specify the value as \"\\\"abc\\\"\".

Allowed values include:

  • ARN: The ARN.

  • FORM_FACTOR: The form factor (for example, phone or tablet).

  • MANUFACTURER: The manufacturer.

  • PLATFORM: The platform (for example, Android or iOS).

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access.

  • APPIUM_VERSION: The Appium version for the test.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

" - }, - "operator":{ - "shape":"RuleOperator", - "documentation":"

The rule's operator.

  • EQUALS: The equals operator.

  • GREATER_THAN: The greater-than operator.

  • IN: The in operator.

  • LESS_THAN: The less-than operator.

  • NOT_IN: The not-in operator.

  • CONTAINS: The contains operator.

" - }, - "value":{ - "shape":"String", - "documentation":"

The rule's value.

" - } - }, - "documentation":"

Represents a condition for a device pool.

" - }, - "RuleOperator":{ - "type":"string", - "enum":[ - "EQUALS", - "LESS_THAN", - "GREATER_THAN", - "IN", - "NOT_IN", - "CONTAINS" - ] - }, - "Rules":{ - "type":"list", - "member":{"shape":"Rule"} - }, - "Run":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The run's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The run's name.

" - }, - "type":{ - "shape":"TestType", - "documentation":"

The run's type.

Must be one of the following values:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "platform":{ - "shape":"DevicePlatform", - "documentation":"

The run's platform.

Allowed values include:

  • ANDROID: The Android platform.

  • IOS: The iOS platform.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the run was created.

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The run's status.

Allowed values include:

  • PENDING: A pending status.

  • PENDING_CONCURRENCY: A pending concurrency status.

  • PENDING_DEVICE: A pending device status.

  • PROCESSING: A processing status.

  • SCHEDULING: A scheduling status.

  • PREPARING: A preparing status.

  • RUNNING: A running status.

  • COMPLETED: A completed status.

  • STOPPING: A stopping status.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The run's result.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "started":{ - "shape":"DateTime", - "documentation":"

The run's start time.

" - }, - "stopped":{ - "shape":"DateTime", - "documentation":"

The run's stop time.

" - }, - "counters":{ - "shape":"Counters", - "documentation":"

The run's result counters.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the run's result.

" - }, - "totalJobs":{ - "shape":"Integer", - "documentation":"

The total number of jobs for the run.

" - }, - "completedJobs":{ - "shape":"Integer", - "documentation":"

The total number of completed jobs.

" - }, - "billingMethod":{ - "shape":"BillingMethod", - "documentation":"

Specifies the billing method for a test run: metered or unmetered. If the parameter is not specified, the default value is metered.

" - }, - "deviceMinutes":{ - "shape":"DeviceMinutes", - "documentation":"

Represents the total (metered or unmetered) minutes used by the test run.

" - }, - "networkProfile":{ - "shape":"NetworkProfile", - "documentation":"

The network profile being used for a test run.

" - }, - "parsingResultUrl":{ - "shape":"String", - "documentation":"

Read-only URL for an object in S3 bucket where you can get the parsing results of the test package. If the test package doesn't parse, the reason why it doesn't parse appears in the file that this URL points to.

" - }, - "resultCode":{ - "shape":"ExecutionResultCode", - "documentation":"

Supporting field for the result field. Set only if result is SKIPPED. PARSING_FAILED if the result is skipped because of test package parsing failure.

" - }, - "seed":{ - "shape":"Integer", - "documentation":"

For fuzz tests, this is a seed to use for randomizing the UI fuzz test. Using the same seed value between tests ensures identical event sequences.

" - }, - "appUpload":{ - "shape":"AmazonResourceName", - "documentation":"

An app to upload or that has been uploaded.

" - }, - "eventCount":{ - "shape":"Integer", - "documentation":"

For fuzz tests, this is the number of events, between 1 and 10000, that the UI fuzz test should perform.

" - }, - "jobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The number of minutes the job will execute before it times out.

" - }, - "devicePoolArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the device pool for the run.

" - }, - "locale":{ - "shape":"String", - "documentation":"

Information about the locale that is used for the run.

" - }, - "radios":{ - "shape":"Radios", - "documentation":"

Information about the radio states for the run.

" - }, - "location":{ - "shape":"Location", - "documentation":"

Information about the location that is used for the run.

" - }, - "customerArtifactPaths":{ - "shape":"CustomerArtifactPaths", - "documentation":"

Output CustomerArtifactPaths object for the test run.

" - }, - "webUrl":{ - "shape":"String", - "documentation":"

The Device Farm console URL for the recording of the run.

" - }, - "skipAppResign":{ - "shape":"SkipAppResign", - "documentation":"

When set to true, for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs.

" - } - }, - "documentation":"

Represents a test run on a set of devices with a given app package, test parameters, etc.

" - }, - "Runs":{ - "type":"list", - "member":{"shape":"Run"} - }, - "Sample":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The sample's ARN.

" - }, - "type":{ - "shape":"SampleType", - "documentation":"

The sample's type.

Must be one of the following values:

  • CPU: A CPU sample type. This is expressed as the app processing CPU time (including child processes) as reported by process, as a percentage.

  • MEMORY: A memory usage sample type. This is expressed as the total proportional set size of an app process, in kilobytes.

  • NATIVE_AVG_DRAWTIME

  • NATIVE_FPS

  • NATIVE_FRAMES

  • NATIVE_MAX_DRAWTIME

  • NATIVE_MIN_DRAWTIME

  • OPENGL_AVG_DRAWTIME

  • OPENGL_FPS

  • OPENGL_FRAMES

  • OPENGL_MAX_DRAWTIME

  • OPENGL_MIN_DRAWTIME

  • RX

  • RX_RATE: The total number of bytes per second (TCP and UDP) that are sent, by app process.

  • THREADS: A threads sample type. This is expressed as the total number of threads per app process.

  • TX

  • TX_RATE: The total number of bytes per second (TCP and UDP) that are received, by app process.

" - }, - "url":{ - "shape":"URL", - "documentation":"

The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the sample's file.

" - } - }, - "documentation":"

Represents a sample of performance data.

" - }, - "SampleType":{ - "type":"string", - "enum":[ - "CPU", - "MEMORY", - "THREADS", - "RX_RATE", - "TX_RATE", - "RX", - "TX", - "NATIVE_FRAMES", - "NATIVE_FPS", - "NATIVE_MIN_DRAWTIME", - "NATIVE_AVG_DRAWTIME", - "NATIVE_MAX_DRAWTIME", - "OPENGL_FRAMES", - "OPENGL_FPS", - "OPENGL_MIN_DRAWTIME", - "OPENGL_AVG_DRAWTIME", - "OPENGL_MAX_DRAWTIME" - ] - }, - "Samples":{ - "type":"list", - "member":{"shape":"Sample"} - }, - "ScheduleRunConfiguration":{ - "type":"structure", - "members":{ - "extraDataPackageArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the extra data for the run. The extra data is a .zip file that AWS Device Farm will extract to external data for Android or the app's sandbox for iOS.

" - }, - "networkProfileArn":{ - "shape":"AmazonResourceName", - "documentation":"

Reserved for internal use.

" - }, - "locale":{ - "shape":"String", - "documentation":"

Information about the locale that is used for the run.

" - }, - "location":{ - "shape":"Location", - "documentation":"

Information about the location that is used for the run.

" - }, - "vpceConfigurationArns":{ - "shape":"AmazonResourceNames", - "documentation":"

An array of Amazon Resource Names (ARNs) for your VPC endpoint configurations.

" - }, - "customerArtifactPaths":{ - "shape":"CustomerArtifactPaths", - "documentation":"

Input CustomerArtifactPaths object for the scheduled run configuration.

" - }, - "radios":{ - "shape":"Radios", - "documentation":"

Information about the radio states for the run.

" - }, - "auxiliaryApps":{ - "shape":"AmazonResourceNames", - "documentation":"

A list of auxiliary apps for the run.

" - }, - "billingMethod":{ - "shape":"BillingMethod", - "documentation":"

Specifies the billing method for a test run: metered or unmetered. If the parameter is not specified, the default value is metered.

" - } - }, - "documentation":"

Represents the settings for a run. Includes things like location, radio states, auxiliary apps, and network profiles.

" - }, - "ScheduleRunRequest":{ - "type":"structure", - "required":[ - "projectArn", - "devicePoolArn", - "test" - ], - "members":{ - "projectArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the project for the run to be scheduled.

" - }, - "appArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the app to schedule a run.

" - }, - "devicePoolArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the device pool for the run to be scheduled.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name for the run to be scheduled.

" - }, - "test":{ - "shape":"ScheduleRunTest", - "documentation":"

Information about the test for the run to be scheduled.

" - }, - "configuration":{ - "shape":"ScheduleRunConfiguration", - "documentation":"

Information about the settings for the run to be scheduled.

" - }, - "executionConfiguration":{ - "shape":"ExecutionConfiguration", - "documentation":"

Specifies configuration information about a test run, such as the execution timeout (in minutes).

" - } - }, - "documentation":"

Represents a request to the schedule run operation.

" - }, - "ScheduleRunResult":{ - "type":"structure", - "members":{ - "run":{ - "shape":"Run", - "documentation":"

Information about the scheduled run.

" - } - }, - "documentation":"

Represents the result of a schedule run request.

" - }, - "ScheduleRunTest":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"TestType", - "documentation":"

The test's type.

Must be one of the following values:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "testPackageArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the uploaded test that will be run.

" - }, - "filter":{ - "shape":"Filter", - "documentation":"

The test's filter.

" - }, - "parameters":{ - "shape":"TestParameters", - "documentation":"

The test's parameters, such as the following test framework parameters and fixture settings:

For Calabash tests:

  • profile: A cucumber profile, for example, \"my_profile_name\".

  • tags: You can limit execution to features or scenarios that have (or don't have) certain tags, for example, \"@smoke\" or \"@smoke,~@wip\".

For Appium tests (all types):

  • appium_version: The Appium version. Currently supported values are \"1.4.16\", \"1.6.3\", \"latest\", and \"default\".

    • “latest” will run the latest Appium version supported by Device Farm (1.6.3).

    • For “default”, Device Farm will choose a compatible version of Appium for the device. The current behavior is to run 1.4.16 on Android devices and iOS 9 and earlier, 1.6.3 for iOS 10 and later.

    • This behavior is subject to change.

For Fuzz tests (Android only):

  • event_count: The number of events, between 1 and 10000, that the UI fuzz test should perform.

  • throttle: The time, in ms, between 0 and 1000, that the UI fuzz test should wait between events.

  • seed: A seed to use for randomizing the UI fuzz test. Using the same seed value between tests ensures identical event sequences.

For Explorer tests:

  • username: A username to use if the Explorer encounters a login form. If not supplied, no username will be inserted.

  • password: A password to use if the Explorer encounters a login form. If not supplied, no password will be inserted.

For Instrumentation:

  • filter: A test filter string. Examples:

    • Running a single test case: \"com.android.abc.Test1\"

    • Running a single test: \"com.android.abc.Test1#smoke\"

    • Running multiple tests: \"com.android.abc.Test1,com.android.abc.Test2\"

For XCTest and XCTestUI:

  • filter: A test filter string. Examples:

    • Running a single test class: \"LoginTests\"

    • Running a multiple test classes: \"LoginTests,SmokeTests\"

    • Running a single test: \"LoginTests/testValid\"

    • Running multiple tests: \"LoginTests/testValid,LoginTests/testInvalid\"

For UIAutomator:

  • filter: A test filter string. Examples:

    • Running a single test case: \"com.android.abc.Test1\"

    • Running a single test: \"com.android.abc.Test1#smoke\"

    • Running multiple tests: \"com.android.abc.Test1,com.android.abc.Test2\"

" - } - }, - "documentation":"

Represents additional test settings.

" - }, - "ServiceAccountException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Any additional information about the exception.

" - } - }, - "documentation":"

There was a problem with the service account.

", - "exception":true - }, - "ServiceDnsName":{ - "type":"string", - "max":2048, - "min":0 - }, - "SkipAppResign":{"type":"boolean"}, - "SshPublicKey":{ - "type":"string", - "max":8192, - "min":0 - }, - "StopRemoteAccessSessionRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the remote access session you wish to stop.

" - } - }, - "documentation":"

Represents the request to stop the remote access session.

" - }, - "StopRemoteAccessSessionResult":{ - "type":"structure", - "members":{ - "remoteAccessSession":{ - "shape":"RemoteAccessSession", - "documentation":"

A container representing the metadata from the service about the remote access session you are stopping.

" - } - }, - "documentation":"

Represents the response from the server that describes the remote access session when AWS Device Farm stops the session.

" - }, - "StopRunRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

Represents the Amazon Resource Name (ARN) of the Device Farm run you wish to stop.

" - } - }, - "documentation":"

Represents the request to stop a specific run.

" - }, - "StopRunResult":{ - "type":"structure", - "members":{ - "run":{ - "shape":"Run", - "documentation":"

The run that was stopped.

" - } - }, - "documentation":"

Represents the results of your stop run attempt.

" - }, - "String":{"type":"string"}, - "Suite":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The suite's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The suite's name.

" - }, - "type":{ - "shape":"TestType", - "documentation":"

The suite's type.

Must be one of the following values:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the suite was created.

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The suite's status.

Allowed values include:

  • PENDING: A pending status.

  • PENDING_CONCURRENCY: A pending concurrency status.

  • PENDING_DEVICE: A pending device status.

  • PROCESSING: A processing status.

  • SCHEDULING: A scheduling status.

  • PREPARING: A preparing status.

  • RUNNING: A running status.

  • COMPLETED: A completed status.

  • STOPPING: A stopping status.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The suite's result.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "started":{ - "shape":"DateTime", - "documentation":"

The suite's start time.

" - }, - "stopped":{ - "shape":"DateTime", - "documentation":"

The suite's stop time.

" - }, - "counters":{ - "shape":"Counters", - "documentation":"

The suite's result counters.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the suite's result.

" - }, - "deviceMinutes":{ - "shape":"DeviceMinutes", - "documentation":"

Represents the total (metered or unmetered) minutes used by the test suite.

" - } - }, - "documentation":"

Represents a collection of one or more tests.

" - }, - "Suites":{ - "type":"list", - "member":{"shape":"Suite"} - }, - "Test":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The test's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The test's name.

" - }, - "type":{ - "shape":"TestType", - "documentation":"

The test's type.

Must be one of the following values:

  • BUILTIN_FUZZ: The built-in fuzz type.

  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

  • APPIUM_PYTHON: The Appium Python type.

  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

  • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

  • CALABASH: The Calabash type.

  • INSTRUMENTATION: The Instrumentation type.

  • UIAUTOMATION: The uiautomation type.

  • UIAUTOMATOR: The uiautomator type.

  • XCTEST: The XCode test type.

  • XCTEST_UI: The XCode UI test type.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the test was created.

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The test's status.

Allowed values include:

  • PENDING: A pending status.

  • PENDING_CONCURRENCY: A pending concurrency status.

  • PENDING_DEVICE: A pending device status.

  • PROCESSING: A processing status.

  • SCHEDULING: A scheduling status.

  • PREPARING: A preparing status.

  • RUNNING: A running status.

  • COMPLETED: A completed status.

  • STOPPING: A stopping status.

" - }, - "result":{ - "shape":"ExecutionResult", - "documentation":"

The test's result.

Allowed values include:

  • PENDING: A pending condition.

  • PASSED: A passing condition.

  • WARNED: A warning condition.

  • FAILED: A failed condition.

  • SKIPPED: A skipped condition.

  • ERRORED: An error condition.

  • STOPPED: A stopped condition.

" - }, - "started":{ - "shape":"DateTime", - "documentation":"

The test's start time.

" - }, - "stopped":{ - "shape":"DateTime", - "documentation":"

The test's stop time.

" - }, - "counters":{ - "shape":"Counters", - "documentation":"

The test's result counters.

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the test's result.

" - }, - "deviceMinutes":{ - "shape":"DeviceMinutes", - "documentation":"

Represents the total (metered or unmetered) minutes used by the test.

" - } - }, - "documentation":"

Represents a condition that is evaluated.

" - }, - "TestParameters":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "TestType":{ - "type":"string", - "enum":[ - "BUILTIN_FUZZ", - "BUILTIN_EXPLORER", - "WEB_PERFORMANCE_PROFILE", - "APPIUM_JAVA_JUNIT", - "APPIUM_JAVA_TESTNG", - "APPIUM_PYTHON", - "APPIUM_WEB_JAVA_JUNIT", - "APPIUM_WEB_JAVA_TESTNG", - "APPIUM_WEB_PYTHON", - "CALABASH", - "INSTRUMENTATION", - "UIAUTOMATION", - "UIAUTOMATOR", - "XCTEST", - "XCTEST_UI", - "REMOTE_ACCESS_RECORD", - "REMOTE_ACCESS_REPLAY" - ] - }, - "Tests":{ - "type":"list", - "member":{"shape":"Test"} - }, - "TransactionIdentifier":{ - "type":"string", - "min":32 - }, - "TrialMinutes":{ - "type":"structure", - "members":{ - "total":{ - "shape":"Double", - "documentation":"

The total number of free trial minutes that the account started with.

" - }, - "remaining":{ - "shape":"Double", - "documentation":"

The number of free trial minutes remaining in the account.

" - } - }, - "documentation":"

Represents information about free trial device minutes for an AWS account.

" - }, - "URL":{ - "type":"string", - "max":2048, - "min":0 - }, - "UniqueProblem":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

A message about the unique problems' result.

" - }, - "problems":{ - "shape":"Problems", - "documentation":"

Information about the problems.

" - } - }, - "documentation":"

A collection of one or more problems, grouped by their result.

" - }, - "UniqueProblems":{ - "type":"list", - "member":{"shape":"UniqueProblem"} - }, - "UniqueProblemsByExecutionResultMap":{ - "type":"map", - "key":{"shape":"ExecutionResult"}, - "value":{"shape":"UniqueProblems"} - }, - "UpdateDeviceInstanceRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the device instance.

" - }, - "profileArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the profile that you want to associate with the device instance.

" - }, - "labels":{ - "shape":"InstanceLabels", - "documentation":"

An array of strings that you want to associate with the device instance.

" - } - } - }, - "UpdateDeviceInstanceResult":{ - "type":"structure", - "members":{ - "deviceInstance":{ - "shape":"DeviceInstance", - "documentation":"

An object containing information about your device instance.

" - } - } - }, - "UpdateDevicePoolRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resourc Name (ARN) of the Device Farm device pool you wish to update.

" - }, - "name":{ - "shape":"Name", - "documentation":"

A string representing the name of the device pool you wish to update.

" - }, - "description":{ - "shape":"Message", - "documentation":"

A description of the device pool you wish to update.

" - }, - "rules":{ - "shape":"Rules", - "documentation":"

Represents the rules you wish to modify for the device pool. Updating rules is optional; however, if you choose to update rules for your request, the update will replace the existing rules.

" - } - }, - "documentation":"

Represents a request to the update device pool operation.

" - }, - "UpdateDevicePoolResult":{ - "type":"structure", - "members":{ - "devicePool":{ - "shape":"DevicePool", - "documentation":"

The device pool you just updated.

" - } - }, - "documentation":"

Represents the result of an update device pool request.

" - }, - "UpdateInstanceProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The updated name for your instance profile.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The updated description for your instance profile.

" - }, - "packageCleanup":{ - "shape":"Boolean", - "documentation":"

The updated choice for whether you want to specify package cleanup. The default value is false for private devices.

" - }, - "excludeAppPackagesFromCleanup":{ - "shape":"PackageIds", - "documentation":"

An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.

The list of packages is only considered if you set packageCleanup to true.

" - }, - "rebootAfterUse":{ - "shape":"Boolean", - "documentation":"

The updated choice for whether you want to reboot the device after use. The default value is true.

" - } - } - }, - "UpdateInstanceProfileResult":{ - "type":"structure", - "members":{ - "instanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

An object containing information about your instance profile.

" - } - } - }, - "UpdateNetworkProfileRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project for which you want to update network profile settings.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the network profile about which you are returning information.

" - }, - "description":{ - "shape":"Message", - "documentation":"

The descriptoin of the network profile about which you are returning information.

" - }, - "type":{ - "shape":"NetworkProfileType", - "documentation":"

The type of network profile you wish to return information about. Valid values are listed below.

" - }, - "uplinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "downlinkBandwidthBits":{ - "shape":"Long", - "documentation":"

The data throughput rate in bits per second, as an integer from 0 to 104857600.

" - }, - "uplinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkDelayMs":{ - "shape":"Long", - "documentation":"

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "downlinkJitterMs":{ - "shape":"Long", - "documentation":"

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

" - }, - "uplinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

" - }, - "downlinkLossPercent":{ - "shape":"PercentInteger", - "documentation":"

Proportion of received packets that fail to arrive from 0 to 100 percent.

" - } - } - }, - "UpdateNetworkProfileResult":{ - "type":"structure", - "members":{ - "networkProfile":{ - "shape":"NetworkProfile", - "documentation":"

A list of the available network profiles.

" - } - } - }, - "UpdateProjectRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the project whose name you wish to update.

" - }, - "name":{ - "shape":"Name", - "documentation":"

A string representing the new name of the project that you are updating.

" - }, - "defaultJobTimeoutMinutes":{ - "shape":"JobTimeoutMinutes", - "documentation":"

The number of minutes a test run in the project will execute before it times out.

" - } - }, - "documentation":"

Represents a request to the update project operation.

" - }, - "UpdateProjectResult":{ - "type":"structure", - "members":{ - "project":{ - "shape":"Project", - "documentation":"

The project you wish to update.

" - } - }, - "documentation":"

Represents the result of an update project request.

" - }, - "UpdateVPCEConfigurationRequest":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to update.

" - }, - "vpceConfigurationName":{ - "shape":"VPCEConfigurationName", - "documentation":"

The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.

" - }, - "vpceServiceName":{ - "shape":"VPCEServiceName", - "documentation":"

The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.

" - }, - "serviceDnsName":{ - "shape":"ServiceDnsName", - "documentation":"

The DNS (domain) name used to connect to your private service in your Amazon VPC. The DNS name must not already be in use on the Internet.

" - }, - "vpceConfigurationDescription":{ - "shape":"VPCEConfigurationDescription", - "documentation":"

An optional description, providing more details about your VPC endpoint configuration.

" - } - } - }, - "UpdateVPCEConfigurationResult":{ - "type":"structure", - "members":{ - "vpceConfiguration":{ - "shape":"VPCEConfiguration", - "documentation":"

An object containing information about your VPC endpoint configuration.

" - } - } - }, - "Upload":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The upload's ARN.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The upload's file name.

" - }, - "created":{ - "shape":"DateTime", - "documentation":"

When the upload was created.

" - }, - "type":{ - "shape":"UploadType", - "documentation":"

The upload's type.

Must be one of the following values:

  • ANDROID_APP: An Android upload.

  • IOS_APP: An iOS upload.

  • WEB_APP: A web appliction upload.

  • EXTERNAL_DATA: An external data upload.

  • APPIUM_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.

  • APPIUM_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.

  • APPIUM_PYTHON_TEST_PACKAGE: An Appium Python test package upload.

  • APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.

  • APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.

  • APPIUM_WEB_PYTHON_TEST_PACKAGE: An Appium Python test package upload.

  • CALABASH_TEST_PACKAGE: A Calabash test package upload.

  • INSTRUMENTATION_TEST_PACKAGE: An instrumentation upload.

  • UIAUTOMATION_TEST_PACKAGE: A uiautomation test package upload.

  • UIAUTOMATOR_TEST_PACKAGE: A uiautomator test package upload.

  • XCTEST_TEST_PACKAGE: An XCode test package upload.

  • XCTEST_UI_TEST_PACKAGE: An XCode UI test package upload.

" - }, - "status":{ - "shape":"UploadStatus", - "documentation":"

The upload's status.

Must be one of the following values:

  • FAILED: A failed status.

  • INITIALIZED: An initialized status.

  • PROCESSING: A processing status.

  • SUCCEEDED: A succeeded status.

" - }, - "url":{ - "shape":"URL", - "documentation":"

The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.

" - }, - "metadata":{ - "shape":"Metadata", - "documentation":"

The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.

" - }, - "contentType":{ - "shape":"ContentType", - "documentation":"

The upload's content type (for example, \"application/octet-stream\").

" - }, - "message":{ - "shape":"Message", - "documentation":"

A message about the upload's result.

" - } - }, - "documentation":"

An app or a set of one or more tests to upload or that have been uploaded.

" - }, - "UploadStatus":{ - "type":"string", - "enum":[ - "INITIALIZED", - "PROCESSING", - "SUCCEEDED", - "FAILED" - ] - }, - "UploadType":{ - "type":"string", - "enum":[ - "ANDROID_APP", - "IOS_APP", - "WEB_APP", - "EXTERNAL_DATA", - "APPIUM_JAVA_JUNIT_TEST_PACKAGE", - "APPIUM_JAVA_TESTNG_TEST_PACKAGE", - "APPIUM_PYTHON_TEST_PACKAGE", - "APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE", - "APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE", - "APPIUM_WEB_PYTHON_TEST_PACKAGE", - "CALABASH_TEST_PACKAGE", - "INSTRUMENTATION_TEST_PACKAGE", - "UIAUTOMATION_TEST_PACKAGE", - "UIAUTOMATOR_TEST_PACKAGE", - "XCTEST_TEST_PACKAGE", - "XCTEST_UI_TEST_PACKAGE" - ] - }, - "Uploads":{ - "type":"list", - "member":{"shape":"Upload"} - }, - "VPCEConfiguration":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the VPC endpoint configuration.

" - }, - "vpceConfigurationName":{ - "shape":"VPCEConfigurationName", - "documentation":"

The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.

" - }, - "vpceServiceName":{ - "shape":"VPCEServiceName", - "documentation":"

The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.

" - }, - "serviceDnsName":{ - "shape":"ServiceDnsName", - "documentation":"

The DNS name that maps to the private IP address of the service you want to access.

" - }, - "vpceConfigurationDescription":{ - "shape":"VPCEConfigurationDescription", - "documentation":"

An optional description, providing more details about your VPC endpoint configuration.

" - } - }, - "documentation":"

Represents an Amazon Virtual Private Cloud (VPC) endpoint configuration.

" - }, - "VPCEConfigurationDescription":{ - "type":"string", - "max":2048, - "min":0 - }, - "VPCEConfigurationName":{ - "type":"string", - "max":1024, - "min":0 - }, - "VPCEConfigurations":{ - "type":"list", - "member":{"shape":"VPCEConfiguration"} - }, - "VPCEServiceName":{ - "type":"string", - "max":2048, - "min":0 - } - }, - "documentation":"

AWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in the cloud.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/service-2.json deleted file mode 100644 index 39979feb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/directconnect/2012-10-25/service-2.json +++ /dev/null @@ -1,2256 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-10-25", - "endpointPrefix":"directconnect", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Direct Connect", - "serviceId":"Direct Connect", - "signatureVersion":"v4", - "targetPrefix":"OvertureService", - "uid":"directconnect-2012-10-25" - }, - "operations":{ - "AllocateConnectionOnInterconnect":{ - "name":"AllocateConnectionOnInterconnect", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateConnectionOnInterconnectRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deprecated in favor of AllocateHostedConnection.

Creates a hosted connection on an interconnect.

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect.

This is intended for use by AWS Direct Connect partners only.

", - "deprecated":true - }, - "AllocateHostedConnection":{ - "name":"AllocateHostedConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateHostedConnectionRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a hosted connection on an interconnect or a link aggregation group (LAG).

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect or LAG.

This is intended for use by AWS Direct Connect partners only.

" - }, - "AllocatePrivateVirtualInterface":{ - "name":"AllocatePrivateVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocatePrivateVirtualInterfaceRequest"}, - "output":{"shape":"VirtualInterface"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Provisions a private virtual interface to be owned by another AWS customer.

Virtual interfaces created using this action must be confirmed by the virtual interface owner by using the ConfirmPrivateVirtualInterface action. Until then, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

" - }, - "AllocatePublicVirtualInterface":{ - "name":"AllocatePublicVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocatePublicVirtualInterfaceRequest"}, - "output":{"shape":"VirtualInterface"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Provisions a public virtual interface to be owned by a different customer.

The owner of a connection calls this function to provision a public virtual interface which will be owned by another AWS customer.

Virtual interfaces created using this function must be confirmed by the virtual interface owner by calling ConfirmPublicVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.

" - }, - "AssociateConnectionWithLag":{ - "name":"AssociateConnectionWithLag", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateConnectionWithLagRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity to AWS will be interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth for the LAG. You can reassociate a connection that's currently associated with a different LAG; however, if removing the connection will cause the original LAG to fall below its setting for minimum number of operational connections, the request fails.

Any virtual interfaces that are directly associated with the connection are automatically re-associated with the LAG. If the connection was originally associated with a different LAG, the virtual interfaces remain associated with the original LAG.

For interconnects, any hosted connections are automatically re-associated with the LAG. If the interconnect was originally associated with a different LAG, the hosted connections remain associated with the original LAG.

" - }, - "AssociateHostedConnection":{ - "name":"AssociateHostedConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateHostedConnectionRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect. If the target interconnect or LAG has an existing hosted connection with a conflicting VLAN number or IP address, the operation fails. This action temporarily interrupts the hosted connection's connectivity to AWS as it is being migrated.

This is intended for use by AWS Direct Connect partners only.

" - }, - "AssociateVirtualInterface":{ - "name":"AssociateVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateVirtualInterfaceRequest"}, - "output":{"shape":"VirtualInterface"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to AWS is temporarily interrupted as the virtual interface is being migrated. If the target connection or LAG has an associated virtual interface with a conflicting VLAN number or a conflicting IP address, the operation fails.

Virtual interfaces associated with a hosted connection cannot be associated with a LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.

In order to reassociate a virtual interface to a new connection or LAG, the requester must own either the virtual interface itself or the connection to which the virtual interface is currently associated. Additionally, the requester must own the connection or LAG to which the virtual interface will be newly associated.

" - }, - "ConfirmConnection":{ - "name":"ConfirmConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmConnectionRequest"}, - "output":{"shape":"ConfirmConnectionResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Confirm the creation of a hosted connection on an interconnect.

Upon creation, the hosted connection is initially in the 'Ordering' state, and will remain in this state until the owner calls ConfirmConnection to confirm creation of the hosted connection.

" - }, - "ConfirmPrivateVirtualInterface":{ - "name":"ConfirmPrivateVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmPrivateVirtualInterfaceRequest"}, - "output":{"shape":"ConfirmPrivateVirtualInterfaceResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Accept ownership of a private virtual interface created by another customer.

After the virtual interface owner calls this function, the virtual interface will be created and attached to the given virtual private gateway or direct connect gateway, and will be available for handling traffic.

" - }, - "ConfirmPublicVirtualInterface":{ - "name":"ConfirmPublicVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmPublicVirtualInterfaceRequest"}, - "output":{"shape":"ConfirmPublicVirtualInterfaceResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Accept ownership of a public virtual interface created by another customer.

After the virtual interface owner calls this function, the specified virtual interface will be created and made available for handling traffic.

" - }, - "CreateBGPPeer":{ - "name":"CreateBGPPeer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBGPPeerRequest"}, - "output":{"shape":"CreateBGPPeerResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new BGP peer on a specified virtual interface. The BGP peer cannot be in the same address family (IPv4/IPv6) of an existing BGP peer on the virtual interface.

You must create a BGP peer for the corresponding address family in order to access AWS resources that also use that address family.

When creating a IPv6 BGP peer, the Amazon address and customer address fields must be left blank. IPv6 addresses are automatically assigned from Amazon's pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

For a public virtual interface, the Autonomous System Number (ASN) must be private or already whitelisted for the virtual interface.

" - }, - "CreateConnection":{ - "name":"CreateConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConnectionRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new connection between the customer network and a specific AWS Direct Connect location.

A connection links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. An AWS Direct Connect location provides access to Amazon Web Services in the region it is associated with. You can establish connections with AWS Direct Connect locations in multiple regions, but a connection in one region does not provide connectivity to other regions.

To find the locations for your region, use DescribeLocations.

You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection will be created.

" - }, - "CreateDirectConnectGateway":{ - "name":"CreateDirectConnectGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDirectConnectGatewayRequest"}, - "output":{"shape":"CreateDirectConnectGatewayResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new direct connect gateway. A direct connect gateway is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways. direct connect gateways are global and visible in any AWS region after they are created. The virtual interfaces and virtual private gateways that are connected through a direct connect gateway can be in different regions. This enables you to connect to a VPC in any region, regardless of the region in which the virtual interfaces are located, and pass traffic between them.

" - }, - "CreateDirectConnectGatewayAssociation":{ - "name":"CreateDirectConnectGatewayAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDirectConnectGatewayAssociationRequest"}, - "output":{"shape":"CreateDirectConnectGatewayAssociationResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates an association between a direct connect gateway and a virtual private gateway (VGW). The VGW must be attached to a VPC and must not be associated with another direct connect gateway.

" - }, - "CreateInterconnect":{ - "name":"CreateInterconnect", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInterconnectRequest"}, - "output":{"shape":"Interconnect"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect location.

An interconnect is a connection which is capable of hosting other connections. The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the AWS Direct Connect partner's network to an AWS Direct Connect location over a standard 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.

You can automatically add the new interconnect to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no interconnect will be created.

For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect partner.

This is intended for use by AWS Direct Connect partners only.

" - }, - "CreateLag":{ - "name":"CreateLag", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLagRequest"}, - "output":{"shape":"Lag"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new link aggregation group (LAG) with the specified number of bundled physical connections between the customer network and a specific AWS Direct Connect location. A LAG is a logical interface that uses the Link Aggregation Control Protocol (LACP) to aggregate multiple 1 gigabit or 10 gigabit interfaces, allowing you to treat them as a single interface.

All connections in a LAG must use the same bandwidth (for example, 10 Gbps), and must terminate at the same AWS Direct Connect endpoint.

You can have up to 10 connections per LAG. Regardless of this limit, if you request more connections for the LAG than AWS Direct Connect can allocate on a single endpoint, no LAG is created.

You can specify an existing physical connection or interconnect to include in the LAG (which counts towards the total number of connections). Doing so interrupts the current physical connection or hosted connections, and re-establishes them as a member of the LAG. The LAG will be created on the same AWS Direct Connect endpoint to which the connection terminates. Any virtual interfaces associated with the connection are automatically disassociated and re-associated with the LAG. The connection ID does not change.

If the AWS account used to create a LAG is a registered AWS Direct Connect partner, the LAG is automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual interfaces cannot be directly configured.

" - }, - "CreatePrivateVirtualInterface":{ - "name":"CreatePrivateVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePrivateVirtualInterfaceRequest"}, - "output":{"shape":"VirtualInterface"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A private virtual interface supports sending traffic to a single virtual private cloud (VPC).

" - }, - "CreatePublicVirtualInterface":{ - "name":"CreatePublicVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePublicVirtualInterfaceRequest"}, - "output":{"shape":"VirtualInterface"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Creates a new public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A public virtual interface supports sending traffic to public services of AWS such as Amazon Simple Storage Service (Amazon S3).

When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.

" - }, - "DeleteBGPPeer":{ - "name":"DeleteBGPPeer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBGPPeerRequest"}, - "output":{"shape":"DeleteBGPPeerResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes a BGP peer on the specified virtual interface that matches the specified customer address and ASN. You cannot delete the last BGP peer from a virtual interface.

" - }, - "DeleteConnection":{ - "name":"DeleteConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConnectionRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes the connection.

Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. You need to cancel separately with the providers any services or charges for cross-connects or network circuits that connect you to the AWS Direct Connect location.

" - }, - "DeleteDirectConnectGateway":{ - "name":"DeleteDirectConnectGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDirectConnectGatewayRequest"}, - "output":{"shape":"DeleteDirectConnectGatewayResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes a direct connect gateway. You must first delete all virtual interfaces that are attached to the direct connect gateway and disassociate all virtual private gateways that are associated with the direct connect gateway.

" - }, - "DeleteDirectConnectGatewayAssociation":{ - "name":"DeleteDirectConnectGatewayAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDirectConnectGatewayAssociationRequest"}, - "output":{"shape":"DeleteDirectConnectGatewayAssociationResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes the association between a direct connect gateway and a virtual private gateway.

" - }, - "DeleteInterconnect":{ - "name":"DeleteInterconnect", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInterconnectRequest"}, - "output":{"shape":"DeleteInterconnectResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes the specified interconnect.

This is intended for use by AWS Direct Connect partners only.

" - }, - "DeleteLag":{ - "name":"DeleteLag", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLagRequest"}, - "output":{"shape":"Lag"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes a link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections.

" - }, - "DeleteVirtualInterface":{ - "name":"DeleteVirtualInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVirtualInterfaceRequest"}, - "output":{"shape":"DeleteVirtualInterfaceResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deletes a virtual interface.

" - }, - "DescribeConnectionLoa":{ - "name":"DescribeConnectionLoa", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConnectionLoaRequest"}, - "output":{"shape":"DescribeConnectionLoaResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deprecated in favor of DescribeLoa.

Returns the LOA-CFA for a Connection.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or service provider uses when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

", - "deprecated":true - }, - "DescribeConnections":{ - "name":"DescribeConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConnectionsRequest"}, - "output":{"shape":"Connections"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Displays all connections in this region.

If a connection ID is provided, the call returns only that particular connection.

" - }, - "DescribeConnectionsOnInterconnect":{ - "name":"DescribeConnectionsOnInterconnect", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConnectionsOnInterconnectRequest"}, - "output":{"shape":"Connections"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deprecated in favor of DescribeHostedConnections.

Returns a list of connections that have been provisioned on the given interconnect.

This is intended for use by AWS Direct Connect partners only.

", - "deprecated":true - }, - "DescribeDirectConnectGatewayAssociations":{ - "name":"DescribeDirectConnectGatewayAssociations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDirectConnectGatewayAssociationsRequest"}, - "output":{"shape":"DescribeDirectConnectGatewayAssociationsResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of all direct connect gateway and virtual private gateway (VGW) associations. Either a direct connect gateway ID or a VGW ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VGWs associated with the direct connect gateway. If a VGW ID is provided, the response returns all direct connect gateways associated with the VGW. If both are provided, the response only returns the association that matches both the direct connect gateway and the VGW.

" - }, - "DescribeDirectConnectGatewayAttachments":{ - "name":"DescribeDirectConnectGatewayAttachments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDirectConnectGatewayAttachmentsRequest"}, - "output":{"shape":"DescribeDirectConnectGatewayAttachmentsResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of all direct connect gateway and virtual interface (VIF) attachments. Either a direct connect gateway ID or a VIF ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VIFs attached to the direct connect gateway. If a VIF ID is provided, the response returns all direct connect gateways attached to the VIF. If both are provided, the response only returns the attachment that matches both the direct connect gateway and the VIF.

" - }, - "DescribeDirectConnectGateways":{ - "name":"DescribeDirectConnectGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDirectConnectGatewaysRequest"}, - "output":{"shape":"DescribeDirectConnectGatewaysResult"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of direct connect gateways in your account. Deleted direct connect gateways are not returned. You can provide a direct connect gateway ID in the request to return information about the specific direct connect gateway only. Otherwise, if a direct connect gateway ID is not provided, information about all of your direct connect gateways is returned.

" - }, - "DescribeHostedConnections":{ - "name":"DescribeHostedConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostedConnectionsRequest"}, - "output":{"shape":"Connections"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of hosted connections that have been provisioned on the given interconnect or link aggregation group (LAG).

This is intended for use by AWS Direct Connect partners only.

" - }, - "DescribeInterconnectLoa":{ - "name":"DescribeInterconnectLoa", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInterconnectLoaRequest"}, - "output":{"shape":"DescribeInterconnectLoaResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Deprecated in favor of DescribeLoa.

Returns the LOA-CFA for an Interconnect.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

", - "deprecated":true - }, - "DescribeInterconnects":{ - "name":"DescribeInterconnects", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInterconnectsRequest"}, - "output":{"shape":"Interconnects"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of interconnects owned by the AWS account.

If an interconnect ID is provided, it will only return this particular interconnect.

" - }, - "DescribeLags":{ - "name":"DescribeLags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLagsRequest"}, - "output":{"shape":"Lags"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Describes the link aggregation groups (LAGs) in your account.

If a LAG ID is provided, only information about the specified LAG is returned.

" - }, - "DescribeLoa":{ - "name":"DescribeLoa", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoaRequest"}, - "output":{"shape":"Loa"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

" - }, - "DescribeLocations":{ - "name":"DescribeLocations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"Locations"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns the list of AWS Direct Connect locations in the current AWS region. These are the locations that may be selected when calling CreateConnection or CreateInterconnect.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Describes the tags associated with the specified Direct Connect resources.

" - }, - "DescribeVirtualGateways":{ - "name":"DescribeVirtualGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"VirtualGateways"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Returns a list of virtual private gateways owned by the AWS account.

You can create one or more AWS Direct Connect private virtual interfaces linking to a virtual private gateway. A virtual private gateway can be managed via Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway action.

" - }, - "DescribeVirtualInterfaces":{ - "name":"DescribeVirtualInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVirtualInterfacesRequest"}, - "output":{"shape":"VirtualInterfaces"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before you make the request are also returned. If you specify a connection ID, only the virtual interfaces associated with the connection are returned. If you specify a virtual interface ID, then only a single virtual interface is returned.

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

" - }, - "DisassociateConnectionFromLag":{ - "name":"DisassociateConnectionFromLag", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateConnectionFromLagRequest"}, - "output":{"shape":"Connection"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is not deleted; to delete the connection, use the DeleteConnection request). If the LAG has associated virtual interfaces or hosted connections, they remain associated with the LAG. A disassociated connection owned by an AWS Direct Connect partner is automatically converted to an interconnect.

If disassociating the connection will cause the LAG to fall below its setting for minimum number of operational connections, the request fails, except when it's the last member of the LAG. If all connections are disassociated, the LAG continues to exist as an empty LAG with no physical connections.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"DuplicateTagKeysException"}, - {"shape":"TooManyTagsException"}, - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Adds the specified tags to the specified Direct Connect resource. Each Direct Connect resource can have a maximum of 50 tags.

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the Direct Connect resource, this action updates its value.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Removes one or more tags from the specified Direct Connect resource.

" - }, - "UpdateLag":{ - "name":"UpdateLag", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateLagRequest"}, - "output":{"shape":"Lag"}, - "errors":[ - {"shape":"DirectConnectServerException"}, - {"shape":"DirectConnectClientException"} - ], - "documentation":"

Updates the attributes of a link aggregation group (LAG).

You can update the following attributes:

  • The name of the LAG.

  • The value for the minimum number of connections that must be operational for the LAG itself to be operational.

When you create a LAG, the default value for the minimum number of operational connections is zero (0). If you update this value, and the number of operational connections falls below the specified value, the LAG will automatically go down to avoid overutilization of the remaining connections. Adjusting this value should be done with care as it could force the LAG down if the value is set higher than the current number of operational connections.

" - } - }, - "shapes":{ - "ASN":{ - "type":"integer", - "documentation":"

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

Example: 65000

" - }, - "AddressFamily":{ - "type":"string", - "documentation":"

Indicates the address family for the BGP peer.

  • ipv4: IPv4 address family

  • ipv6: IPv6 address family

", - "enum":[ - "ipv4", - "ipv6" - ] - }, - "AllocateConnectionOnInterconnectRequest":{ - "type":"structure", - "required":[ - "bandwidth", - "connectionName", - "ownerAccount", - "interconnectId", - "vlan" - ], - "members":{ - "bandwidth":{ - "shape":"Bandwidth", - "documentation":"

Bandwidth of the connection.

Example: \"500Mbps\"

Default: None

Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps

" - }, - "connectionName":{ - "shape":"ConnectionName", - "documentation":"

Name of the provisioned connection.

Example: \"500M Connection to AWS\"

Default: None

" - }, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

Numeric account Id of the customer for whom the connection will be provisioned.

Example: 123443215678

Default: None

" - }, - "interconnectId":{ - "shape":"InterconnectId", - "documentation":"

ID of the interconnect on which the connection will be provisioned.

Example: dxcon-456abc78

Default: None

" - }, - "vlan":{ - "shape":"VLAN", - "documentation":"

The dedicated VLAN provisioned to the connection.

Example: 101

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AllocateConnectionOnInterconnect operation.

" - }, - "AllocateHostedConnectionRequest":{ - "type":"structure", - "required":[ - "connectionId", - "ownerAccount", - "bandwidth", - "connectionName", - "vlan" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the interconnect or LAG on which the connection will be provisioned.

Example: dxcon-456abc78 or dxlag-abc123

Default: None

" - }, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The numeric account ID of the customer for whom the connection will be provisioned.

Example: 123443215678

Default: None

" - }, - "bandwidth":{ - "shape":"Bandwidth", - "documentation":"

The bandwidth of the connection.

Example: 500Mbps

Default: None

Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps

" - }, - "connectionName":{ - "shape":"ConnectionName", - "documentation":"

The name of the provisioned connection.

Example: \"500M Connection to AWS\"

Default: None

" - }, - "vlan":{ - "shape":"VLAN", - "documentation":"

The dedicated VLAN provisioned to the hosted connection.

Example: 101

Default: None

" - } - }, - "documentation":"

Container for the parameters to theHostedConnection operation.

" - }, - "AllocatePrivateVirtualInterfaceRequest":{ - "type":"structure", - "required":[ - "connectionId", - "ownerAccount", - "newPrivateVirtualInterfaceAllocation" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The connection ID on which the private virtual interface is provisioned.

Default: None

" - }, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account that will own the new private virtual interface.

Default: None

" - }, - "newPrivateVirtualInterfaceAllocation":{ - "shape":"NewPrivateVirtualInterfaceAllocation", - "documentation":"

Detailed information for the private virtual interface to be provisioned.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AllocatePrivateVirtualInterface operation.

" - }, - "AllocatePublicVirtualInterfaceRequest":{ - "type":"structure", - "required":[ - "connectionId", - "ownerAccount", - "newPublicVirtualInterfaceAllocation" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The connection ID on which the public virtual interface is provisioned.

Default: None

" - }, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account that will own the new public virtual interface.

Default: None

" - }, - "newPublicVirtualInterfaceAllocation":{ - "shape":"NewPublicVirtualInterfaceAllocation", - "documentation":"

Detailed information for the public virtual interface to be provisioned.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AllocatePublicVirtualInterface operation.

" - }, - "AmazonAddress":{ - "type":"string", - "documentation":"

IP address assigned to the Amazon interface.

Example: 192.168.1.1/30 or 2001:db8::1/125

" - }, - "AssociateConnectionWithLagRequest":{ - "type":"structure", - "required":[ - "connectionId", - "lagId" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the connection.

Example: dxcon-abc123

Default: None

" - }, - "lagId":{ - "shape":"LagId", - "documentation":"

The ID of the LAG with which to associate the connection.

Example: dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AssociateConnectionWithLag operation.

" - }, - "AssociateHostedConnectionRequest":{ - "type":"structure", - "required":[ - "connectionId", - "parentConnectionId" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the hosted connection.

Example: dxcon-abc123

Default: None

" - }, - "parentConnectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the interconnect or the LAG.

Example: dxcon-abc123 or dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AssociateHostedConnection operation.

" - }, - "AssociateVirtualInterfaceRequest":{ - "type":"structure", - "required":[ - "virtualInterfaceId", - "connectionId" - ], - "members":{ - "virtualInterfaceId":{ - "shape":"VirtualInterfaceId", - "documentation":"

The ID of the virtual interface.

Example: dxvif-123dfg56

Default: None

" - }, - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the LAG or connection with which to associate the virtual interface.

Example: dxlag-abc123 or dxcon-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the AssociateVirtualInterface operation.

" - }, - "AwsDevice":{ - "type":"string", - "documentation":"

An abstract ID for the physical Direct Connect endpoint.

Example: EQC50-abcdef123456

", - "deprecated":true - }, - "AwsDeviceV2":{"type":"string"}, - "BGPAuthKey":{ - "type":"string", - "documentation":"

The authentication key for BGP configuration.

Example: asdf34example

" - }, - "BGPPeer":{ - "type":"structure", - "members":{ - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "addressFamily":{"shape":"AddressFamily"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"}, - "bgpPeerState":{"shape":"BGPPeerState"}, - "bgpStatus":{"shape":"BGPStatus"}, - "awsDeviceV2":{ - "shape":"AwsDeviceV2", - "documentation":"

The Direct Connection endpoint which the BGP peer terminates on.

" - } - }, - "documentation":"

A structure containing information about a BGP peer.

" - }, - "BGPPeerList":{ - "type":"list", - "member":{"shape":"BGPPeer"}, - "documentation":"

A list of the BGP peers configured on this virtual interface.

" - }, - "BGPPeerState":{ - "type":"string", - "documentation":"

The state of the BGP peer.

  • Verifying: The BGP peering addresses or ASN require validation before the BGP peer can be created. This state only applies to BGP peers on a public virtual interface.

  • Pending: The BGP peer has been created, and is in this state until it is ready to be established.

  • Available: The BGP peer can be established.

  • Deleting: The BGP peer is in the process of being deleted.

  • Deleted: The BGP peer has been deleted and cannot be established.

", - "enum":[ - "verifying", - "pending", - "available", - "deleting", - "deleted" - ] - }, - "BGPStatus":{ - "type":"string", - "documentation":"

The Up/Down state of the BGP peer.

  • Up: The BGP peer is established.

    A state of up does not indicate the state of the routing function. Ensure that you are receiving routes over the BGP session.

  • Down: The BGP peer is down.

", - "enum":[ - "up", - "down" - ] - }, - "Bandwidth":{ - "type":"string", - "documentation":"

Bandwidth of the connection.

Example: 1Gbps

Default: None

" - }, - "BooleanFlag":{"type":"boolean"}, - "CIDR":{"type":"string"}, - "ConfirmConnectionRequest":{ - "type":"structure", - "required":["connectionId"], - "members":{ - "connectionId":{"shape":"ConnectionId"} - }, - "documentation":"

Container for the parameters to the ConfirmConnection operation.

" - }, - "ConfirmConnectionResponse":{ - "type":"structure", - "members":{ - "connectionState":{"shape":"ConnectionState"} - }, - "documentation":"

The response received when ConfirmConnection is called.

" - }, - "ConfirmPrivateVirtualInterfaceRequest":{ - "type":"structure", - "required":["virtualInterfaceId"], - "members":{ - "virtualInterfaceId":{"shape":"VirtualInterfaceId"}, - "virtualGatewayId":{ - "shape":"VirtualGatewayId", - "documentation":"

ID of the virtual private gateway that will be attached to the virtual interface.

A virtual private gateway can be managed via the Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway action.

Default: None

" - }, - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

ID of the direct connect gateway that will be attached to the virtual interface.

A direct connect gateway can be managed via the AWS Direct Connect console or the CreateDirectConnectGateway action.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the ConfirmPrivateVirtualInterface operation.

" - }, - "ConfirmPrivateVirtualInterfaceResponse":{ - "type":"structure", - "members":{ - "virtualInterfaceState":{"shape":"VirtualInterfaceState"} - }, - "documentation":"

The response received when ConfirmPrivateVirtualInterface is called.

" - }, - "ConfirmPublicVirtualInterfaceRequest":{ - "type":"structure", - "required":["virtualInterfaceId"], - "members":{ - "virtualInterfaceId":{"shape":"VirtualInterfaceId"} - }, - "documentation":"

Container for the parameters to the ConfirmPublicVirtualInterface operation.

" - }, - "ConfirmPublicVirtualInterfaceResponse":{ - "type":"structure", - "members":{ - "virtualInterfaceState":{"shape":"VirtualInterfaceState"} - }, - "documentation":"

The response received when ConfirmPublicVirtualInterface is called.

" - }, - "Connection":{ - "type":"structure", - "members":{ - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account that will own the new connection.

" - }, - "connectionId":{"shape":"ConnectionId"}, - "connectionName":{"shape":"ConnectionName"}, - "connectionState":{"shape":"ConnectionState"}, - "region":{"shape":"Region"}, - "location":{"shape":"LocationCode"}, - "bandwidth":{ - "shape":"Bandwidth", - "documentation":"

Bandwidth of the connection.

Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections)

Default: None

" - }, - "vlan":{"shape":"VLAN"}, - "partnerName":{ - "shape":"PartnerName", - "documentation":"

The name of the AWS Direct Connect service provider associated with the connection.

" - }, - "loaIssueTime":{ - "shape":"LoaIssueTime", - "documentation":"

The time of the most recent call to DescribeLoa for this connection.

" - }, - "lagId":{"shape":"LagId"}, - "awsDevice":{ - "shape":"AwsDevice", - "documentation":"

Deprecated in favor of awsDeviceV2.

The Direct Connection endpoint which the physical connection terminates on.

" - }, - "awsDeviceV2":{ - "shape":"AwsDeviceV2", - "documentation":"

The Direct Connection endpoint which the physical connection terminates on.

" - } - }, - "documentation":"

A connection represents the physical network connection between the AWS Direct Connect location and the customer.

" - }, - "ConnectionId":{ - "type":"string", - "documentation":"

The ID of the connection. This field is also used as the ID type for operations that use multiple connection types (LAG, interconnect, and/or connection).

Example: dxcon-fg5678gh

Default: None

" - }, - "ConnectionList":{ - "type":"list", - "member":{"shape":"Connection"}, - "documentation":"

A list of connections.

" - }, - "ConnectionName":{ - "type":"string", - "documentation":"

The name of the connection.

Example: \"My Connection to AWS\"

Default: None

" - }, - "ConnectionState":{ - "type":"string", - "documentation":"

State of the connection.

  • Ordering: The initial state of a hosted connection provisioned on an interconnect. The connection stays in the ordering state until the owner of the hosted connection confirms or declines the connection order.

  • Requested: The initial state of a standard connection. The connection stays in the requested state until the Letter of Authorization (LOA) is sent to the customer.

  • Pending: The connection has been approved, and is being initialized.

  • Available: The network link is up, and the connection is ready for use.

  • Down: The network link is down.

  • Deleting: The connection is in the process of being deleted.

  • Deleted: The connection has been deleted.

  • Rejected: A hosted connection in the 'Ordering' state will enter the 'Rejected' state if it is deleted by the end customer.

", - "enum":[ - "ordering", - "requested", - "pending", - "available", - "down", - "deleting", - "deleted", - "rejected" - ] - }, - "Connections":{ - "type":"structure", - "members":{ - "connections":{ - "shape":"ConnectionList", - "documentation":"

A list of connections.

" - } - }, - "documentation":"

A structure containing a list of connections.

" - }, - "Count":{"type":"integer"}, - "CreateBGPPeerRequest":{ - "type":"structure", - "members":{ - "virtualInterfaceId":{ - "shape":"VirtualInterfaceId", - "documentation":"

The ID of the virtual interface on which the BGP peer will be provisioned.

Example: dxvif-456abc78

Default: None

" - }, - "newBGPPeer":{ - "shape":"NewBGPPeer", - "documentation":"

Detailed information for the BGP peer to be created.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the CreateBGPPeer operation.

" - }, - "CreateBGPPeerResponse":{ - "type":"structure", - "members":{ - "virtualInterface":{"shape":"VirtualInterface"} - }, - "documentation":"

The response received when CreateBGPPeer is called.

" - }, - "CreateConnectionRequest":{ - "type":"structure", - "required":[ - "location", - "bandwidth", - "connectionName" - ], - "members":{ - "location":{"shape":"LocationCode"}, - "bandwidth":{"shape":"Bandwidth"}, - "connectionName":{"shape":"ConnectionName"}, - "lagId":{"shape":"LagId"} - }, - "documentation":"

Container for the parameters to the CreateConnection operation.

" - }, - "CreateDirectConnectGatewayAssociationRequest":{ - "type":"structure", - "required":[ - "directConnectGatewayId", - "virtualGatewayId" - ], - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - }, - "virtualGatewayId":{ - "shape":"VirtualGatewayId", - "documentation":"

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

" - } - }, - "documentation":"

Container for the parameters to the CreateDirectConnectGatewayAssociation operation.

" - }, - "CreateDirectConnectGatewayAssociationResult":{ - "type":"structure", - "members":{ - "directConnectGatewayAssociation":{ - "shape":"DirectConnectGatewayAssociation", - "documentation":"

The direct connect gateway association to be created.

" - } - }, - "documentation":"

Container for the response from the CreateDirectConnectGatewayAssociation API call

" - }, - "CreateDirectConnectGatewayRequest":{ - "type":"structure", - "required":["directConnectGatewayName"], - "members":{ - "directConnectGatewayName":{ - "shape":"DirectConnectGatewayName", - "documentation":"

The name of the direct connect gateway.

Example: \"My direct connect gateway\"

Default: None

" - }, - "amazonSideAsn":{ - "shape":"LongAsn", - "documentation":"

The autonomous system number (ASN) for Border Gateway Protocol (BGP) to be configured on the Amazon side of the connection. The ASN must be in the private range of 64,512 to 65,534 or 4,200,000,000 to 4,294,967,294

Example: 65200

Default: 64512

" - } - }, - "documentation":"

Container for the parameters to the CreateDirectConnectGateway operation.

" - }, - "CreateDirectConnectGatewayResult":{ - "type":"structure", - "members":{ - "directConnectGateway":{ - "shape":"DirectConnectGateway", - "documentation":"

The direct connect gateway to be created.

" - } - }, - "documentation":"

Container for the response from the CreateDirectConnectGateway API call

" - }, - "CreateInterconnectRequest":{ - "type":"structure", - "required":[ - "interconnectName", - "bandwidth", - "location" - ], - "members":{ - "interconnectName":{ - "shape":"InterconnectName", - "documentation":"

The name of the interconnect.

Example: \"1G Interconnect to AWS\"

Default: None

" - }, - "bandwidth":{ - "shape":"Bandwidth", - "documentation":"

The port bandwidth

Example: 1Gbps

Default: None

Available values: 1Gbps,10Gbps

" - }, - "location":{ - "shape":"LocationCode", - "documentation":"

Where the interconnect is located

Example: EqSV5

Default: None

" - }, - "lagId":{"shape":"LagId"} - }, - "documentation":"

Container for the parameters to the CreateInterconnect operation.

" - }, - "CreateLagRequest":{ - "type":"structure", - "required":[ - "numberOfConnections", - "location", - "connectionsBandwidth", - "lagName" - ], - "members":{ - "numberOfConnections":{ - "shape":"Count", - "documentation":"

The number of physical connections initially provisioned and bundled by the LAG.

Default: None

" - }, - "location":{ - "shape":"LocationCode", - "documentation":"

The AWS Direct Connect location in which the LAG should be allocated.

Example: EqSV5

Default: None

" - }, - "connectionsBandwidth":{ - "shape":"Bandwidth", - "documentation":"

The bandwidth of the individual physical connections bundled by the LAG.

Default: None

Available values: 1Gbps, 10Gbps

" - }, - "lagName":{ - "shape":"LagName", - "documentation":"

The name of the LAG.

Example: \"3x10G LAG to AWS\"

Default: None

" - }, - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of an existing connection to migrate to the LAG.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the CreateLag operation.

" - }, - "CreatePrivateVirtualInterfaceRequest":{ - "type":"structure", - "required":[ - "connectionId", - "newPrivateVirtualInterface" - ], - "members":{ - "connectionId":{"shape":"ConnectionId"}, - "newPrivateVirtualInterface":{ - "shape":"NewPrivateVirtualInterface", - "documentation":"

Detailed information for the private virtual interface to be created.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the CreatePrivateVirtualInterface operation.

" - }, - "CreatePublicVirtualInterfaceRequest":{ - "type":"structure", - "required":[ - "connectionId", - "newPublicVirtualInterface" - ], - "members":{ - "connectionId":{"shape":"ConnectionId"}, - "newPublicVirtualInterface":{ - "shape":"NewPublicVirtualInterface", - "documentation":"

Detailed information for the public virtual interface to be created.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the CreatePublicVirtualInterface operation.

" - }, - "CustomerAddress":{ - "type":"string", - "documentation":"

IP address assigned to the customer interface.

Example: 192.168.1.2/30 or 2001:db8::2/125

" - }, - "DeleteBGPPeerRequest":{ - "type":"structure", - "members":{ - "virtualInterfaceId":{ - "shape":"VirtualInterfaceId", - "documentation":"

The ID of the virtual interface from which the BGP peer will be deleted.

Example: dxvif-456abc78

Default: None

" - }, - "asn":{"shape":"ASN"}, - "customerAddress":{"shape":"CustomerAddress"} - }, - "documentation":"

Container for the parameters to the DeleteBGPPeer operation.

" - }, - "DeleteBGPPeerResponse":{ - "type":"structure", - "members":{ - "virtualInterface":{"shape":"VirtualInterface"} - }, - "documentation":"

The response received when DeleteBGPPeer is called.

" - }, - "DeleteConnectionRequest":{ - "type":"structure", - "required":["connectionId"], - "members":{ - "connectionId":{"shape":"ConnectionId"} - }, - "documentation":"

Container for the parameters to the DeleteConnection operation.

" - }, - "DeleteDirectConnectGatewayAssociationRequest":{ - "type":"structure", - "required":[ - "directConnectGatewayId", - "virtualGatewayId" - ], - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - }, - "virtualGatewayId":{ - "shape":"VirtualGatewayId", - "documentation":"

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DeleteDirectConnectGatewayAssociation operation.

" - }, - "DeleteDirectConnectGatewayAssociationResult":{ - "type":"structure", - "members":{ - "directConnectGatewayAssociation":{ - "shape":"DirectConnectGatewayAssociation", - "documentation":"

The direct connect gateway association to be deleted.

" - } - }, - "documentation":"

Container for the response from the DeleteDirectConnectGatewayAssociation API call

" - }, - "DeleteDirectConnectGatewayRequest":{ - "type":"structure", - "required":["directConnectGatewayId"], - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DeleteDirectConnectGateway operation.

" - }, - "DeleteDirectConnectGatewayResult":{ - "type":"structure", - "members":{ - "directConnectGateway":{ - "shape":"DirectConnectGateway", - "documentation":"

The direct connect gateway to be deleted.

" - } - }, - "documentation":"

Container for the response from the DeleteDirectConnectGateway API call

" - }, - "DeleteInterconnectRequest":{ - "type":"structure", - "required":["interconnectId"], - "members":{ - "interconnectId":{"shape":"InterconnectId"} - }, - "documentation":"

Container for the parameters to the DeleteInterconnect operation.

" - }, - "DeleteInterconnectResponse":{ - "type":"structure", - "members":{ - "interconnectState":{"shape":"InterconnectState"} - }, - "documentation":"

The response received when DeleteInterconnect is called.

" - }, - "DeleteLagRequest":{ - "type":"structure", - "required":["lagId"], - "members":{ - "lagId":{ - "shape":"LagId", - "documentation":"

The ID of the LAG to delete.

Example: dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DeleteLag operation.

" - }, - "DeleteVirtualInterfaceRequest":{ - "type":"structure", - "required":["virtualInterfaceId"], - "members":{ - "virtualInterfaceId":{"shape":"VirtualInterfaceId"} - }, - "documentation":"

Container for the parameters to the DeleteVirtualInterface operation.

" - }, - "DeleteVirtualInterfaceResponse":{ - "type":"structure", - "members":{ - "virtualInterfaceState":{"shape":"VirtualInterfaceState"} - }, - "documentation":"

The response received when DeleteVirtualInterface is called.

" - }, - "DescribeConnectionLoaRequest":{ - "type":"structure", - "required":["connectionId"], - "members":{ - "connectionId":{"shape":"ConnectionId"}, - "providerName":{ - "shape":"ProviderName", - "documentation":"

The name of the APN partner or service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

" - }, - "loaContentType":{"shape":"LoaContentType"} - }, - "documentation":"

Container for the parameters to the DescribeConnectionLoa operation.

" - }, - "DescribeConnectionLoaResponse":{ - "type":"structure", - "members":{ - "loa":{"shape":"Loa"} - }, - "documentation":"

The response received when DescribeConnectionLoa is called.

" - }, - "DescribeConnectionsOnInterconnectRequest":{ - "type":"structure", - "required":["interconnectId"], - "members":{ - "interconnectId":{ - "shape":"InterconnectId", - "documentation":"

ID of the interconnect on which a list of connection is provisioned.

Example: dxcon-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeConnectionsOnInterconnect operation.

" - }, - "DescribeConnectionsRequest":{ - "type":"structure", - "members":{ - "connectionId":{"shape":"ConnectionId"} - }, - "documentation":"

Container for the parameters to the DescribeConnections operation.

" - }, - "DescribeDirectConnectGatewayAssociationsRequest":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - }, - "virtualGatewayId":{ - "shape":"VirtualGatewayId", - "documentation":"

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

" - }, - "maxResults":{ - "shape":"MaxResultSetSize", - "documentation":"

The maximum number of direct connect gateway associations to return per page.

Example: 15

Default: None

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeDirectConnectGatewayAssociations operation.

" - }, - "DescribeDirectConnectGatewayAssociationsResult":{ - "type":"structure", - "members":{ - "directConnectGatewayAssociations":{ - "shape":"DirectConnectGatewayAssociationList", - "documentation":"

Information about the direct connect gateway associations.

" - }, - "nextToken":{"shape":"PaginationToken"} - }, - "documentation":"

Container for the response from the DescribeDirectConnectGatewayAssociations API call

" - }, - "DescribeDirectConnectGatewayAttachmentsRequest":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - }, - "virtualInterfaceId":{ - "shape":"VirtualInterfaceId", - "documentation":"

The ID of the virtual interface.

Example: \"dxvif-abc123ef\"

Default: None

" - }, - "maxResults":{ - "shape":"MaxResultSetSize", - "documentation":"

The maximum number of direct connect gateway attachments to return per page.

Example: 15

Default: None

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeDirectConnectGatewayAttachments operation.

" - }, - "DescribeDirectConnectGatewayAttachmentsResult":{ - "type":"structure", - "members":{ - "directConnectGatewayAttachments":{ - "shape":"DirectConnectGatewayAttachmentList", - "documentation":"

Information about the direct connect gateway attachments.

" - }, - "nextToken":{"shape":"PaginationToken"} - }, - "documentation":"

Container for the response from the DescribeDirectConnectGatewayAttachments API call

" - }, - "DescribeDirectConnectGatewaysRequest":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{ - "shape":"DirectConnectGatewayId", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

" - }, - "maxResults":{ - "shape":"MaxResultSetSize", - "documentation":"

The maximum number of direct connect gateways to return per page.

Example: 15

Default: None

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeDirectConnectGateways operation.

" - }, - "DescribeDirectConnectGatewaysResult":{ - "type":"structure", - "members":{ - "directConnectGateways":{ - "shape":"DirectConnectGatewayList", - "documentation":"

Information about the direct connect gateways.

" - }, - "nextToken":{"shape":"PaginationToken"} - }, - "documentation":"

Container for the response from the DescribeDirectConnectGateways API call

" - }, - "DescribeHostedConnectionsRequest":{ - "type":"structure", - "required":["connectionId"], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the interconnect or LAG on which the hosted connections are provisioned.

Example: dxcon-abc123 or dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeHostedConnections operation.

" - }, - "DescribeInterconnectLoaRequest":{ - "type":"structure", - "required":["interconnectId"], - "members":{ - "interconnectId":{"shape":"InterconnectId"}, - "providerName":{ - "shape":"ProviderName", - "documentation":"

The name of the service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

" - }, - "loaContentType":{"shape":"LoaContentType"} - }, - "documentation":"

Container for the parameters to the DescribeInterconnectLoa operation.

" - }, - "DescribeInterconnectLoaResponse":{ - "type":"structure", - "members":{ - "loa":{"shape":"Loa"} - }, - "documentation":"

The response received when DescribeInterconnectLoa is called.

" - }, - "DescribeInterconnectsRequest":{ - "type":"structure", - "members":{ - "interconnectId":{"shape":"InterconnectId"} - }, - "documentation":"

Container for the parameters to the DescribeInterconnects operation.

" - }, - "DescribeLagsRequest":{ - "type":"structure", - "members":{ - "lagId":{ - "shape":"LagId", - "documentation":"

The ID of the LAG.

Example: dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DescribeLags operation.

" - }, - "DescribeLoaRequest":{ - "type":"structure", - "required":["connectionId"], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of a connection, LAG, or interconnect for which to get the LOA-CFA information.

Example: dxcon-abc123 or dxlag-abc123

Default: None

" - }, - "providerName":{ - "shape":"ProviderName", - "documentation":"

The name of the service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

" - }, - "loaContentType":{ - "shape":"LoaContentType", - "documentation":"

A standard media type indicating the content type of the LOA-CFA document. Currently, the only supported value is \"application/pdf\".

Default: application/pdf

" - } - }, - "documentation":"

Container for the parameters to the DescribeLoa operation.

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "required":["resourceArns"], - "members":{ - "resourceArns":{ - "shape":"ResourceArnList", - "documentation":"

The Amazon Resource Names (ARNs) of the Direct Connect resources.

" - } - }, - "documentation":"

Container for the parameters to the DescribeTags operation.

" - }, - "DescribeTagsResponse":{ - "type":"structure", - "members":{ - "resourceTags":{ - "shape":"ResourceTagList", - "documentation":"

Information about the tags.

" - } - }, - "documentation":"

The response received when DescribeTags is called.

" - }, - "DescribeVirtualInterfacesRequest":{ - "type":"structure", - "members":{ - "connectionId":{"shape":"ConnectionId"}, - "virtualInterfaceId":{"shape":"VirtualInterfaceId"} - }, - "documentation":"

Container for the parameters to the DescribeVirtualInterfaces operation.

" - }, - "DirectConnectClientException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

This is an exception thrown when there is an issue with the input provided by the API call. For example, the name provided for a connection contains a pound sign (#). This can also occur when a valid value is provided, but is otherwise constrained. For example, the valid VLAN tag range is 1-4096 but each can only be used once per connection.

" - } - }, - "documentation":"

The API was called with invalid parameters. The error message will contain additional details about the cause.

", - "exception":true - }, - "DirectConnectGateway":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{"shape":"DirectConnectGatewayId"}, - "directConnectGatewayName":{"shape":"DirectConnectGatewayName"}, - "amazonSideAsn":{ - "shape":"LongAsn", - "documentation":"

The autonomous system number (ASN) for the Amazon side of the connection.

" - }, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account ID of the owner of the direct connect gateway.

" - }, - "directConnectGatewayState":{"shape":"DirectConnectGatewayState"}, - "stateChangeError":{"shape":"StateChangeError"} - }, - "documentation":"

A direct connect gateway is an intermediate object that enables you to connect virtual interfaces and virtual private gateways.

" - }, - "DirectConnectGatewayAssociation":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{"shape":"DirectConnectGatewayId"}, - "virtualGatewayId":{"shape":"VirtualGatewayId"}, - "virtualGatewayRegion":{"shape":"VirtualGatewayRegion"}, - "virtualGatewayOwnerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account ID of the owner of the virtual private gateway.

" - }, - "associationState":{"shape":"DirectConnectGatewayAssociationState"}, - "stateChangeError":{"shape":"StateChangeError"} - }, - "documentation":"

The association between a direct connect gateway and virtual private gateway.

" - }, - "DirectConnectGatewayAssociationList":{ - "type":"list", - "member":{"shape":"DirectConnectGatewayAssociation"}, - "documentation":"

A list of direct connect gateway associations.

" - }, - "DirectConnectGatewayAssociationState":{ - "type":"string", - "documentation":"

State of the direct connect gateway association.

  • Associating: The initial state after calling CreateDirectConnectGatewayAssociation.

  • Associated: The direct connect gateway and virtual private gateway are successfully associated and ready to pass traffic.

  • Disassociating: The initial state after calling DeleteDirectConnectGatewayAssociation.

  • Disassociated: The virtual private gateway is successfully disassociated from the direct connect gateway. Traffic flow between the direct connect gateway and virtual private gateway stops.

", - "enum":[ - "associating", - "associated", - "disassociating", - "disassociated" - ] - }, - "DirectConnectGatewayAttachment":{ - "type":"structure", - "members":{ - "directConnectGatewayId":{"shape":"DirectConnectGatewayId"}, - "virtualInterfaceId":{"shape":"VirtualInterfaceId"}, - "virtualInterfaceRegion":{"shape":"VirtualInterfaceRegion"}, - "virtualInterfaceOwnerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account ID of the owner of the virtual interface.

" - }, - "attachmentState":{"shape":"DirectConnectGatewayAttachmentState"}, - "stateChangeError":{"shape":"StateChangeError"} - }, - "documentation":"

The association between a direct connect gateway and virtual interface.

" - }, - "DirectConnectGatewayAttachmentList":{ - "type":"list", - "member":{"shape":"DirectConnectGatewayAttachment"}, - "documentation":"

A list of direct connect gateway attachments.

" - }, - "DirectConnectGatewayAttachmentState":{ - "type":"string", - "documentation":"

State of the direct connect gateway attachment.

  • Attaching: The initial state after a virtual interface is created using the direct connect gateway.

  • Attached: The direct connect gateway and virtual interface are successfully attached and ready to pass traffic.

  • Detaching: The initial state after calling DeleteVirtualInterface on a virtual interface that is attached to a direct connect gateway.

  • Detached: The virtual interface is successfully detached from the direct connect gateway. Traffic flow between the direct connect gateway and virtual interface stops.

", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "DirectConnectGatewayId":{ - "type":"string", - "documentation":"

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

" - }, - "DirectConnectGatewayList":{ - "type":"list", - "member":{"shape":"DirectConnectGateway"}, - "documentation":"

A list of direct connect gateways.

" - }, - "DirectConnectGatewayName":{ - "type":"string", - "documentation":"

The name of the direct connect gateway.

Example: \"My direct connect gateway\"

Default: None

" - }, - "DirectConnectGatewayState":{ - "type":"string", - "documentation":"

State of the direct connect gateway.

  • Pending: The initial state after calling CreateDirectConnectGateway.

  • Available: The direct connect gateway is ready for use.

  • Deleting: The initial state after calling DeleteDirectConnectGateway.

  • Deleted: The direct connect gateway is deleted and cannot pass traffic.

", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "DirectConnectServerException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

This is an exception thrown when there is a backend issue on the server side.

" - } - }, - "documentation":"

A server-side error occurred during the API call. The error message will contain additional details about the cause.

", - "exception":true - }, - "DisassociateConnectionFromLagRequest":{ - "type":"structure", - "required":[ - "connectionId", - "lagId" - ], - "members":{ - "connectionId":{ - "shape":"ConnectionId", - "documentation":"

The ID of the connection to disassociate from the LAG.

Example: dxcon-abc123

Default: None

" - }, - "lagId":{ - "shape":"LagId", - "documentation":"

The ID of the LAG.

Example: dxlag-abc123

Default: None

" - } - }, - "documentation":"

Container for the parameters to the DisassociateConnectionFromLag operation.

" - }, - "DuplicateTagKeysException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A tag key was specified more than once.

", - "exception":true - }, - "ErrorMessage":{"type":"string"}, - "Interconnect":{ - "type":"structure", - "members":{ - "interconnectId":{"shape":"InterconnectId"}, - "interconnectName":{"shape":"InterconnectName"}, - "interconnectState":{"shape":"InterconnectState"}, - "region":{"shape":"Region"}, - "location":{"shape":"LocationCode"}, - "bandwidth":{"shape":"Bandwidth"}, - "loaIssueTime":{ - "shape":"LoaIssueTime", - "documentation":"

The time of the most recent call to DescribeInterconnectLoa for this Interconnect.

" - }, - "lagId":{"shape":"LagId"}, - "awsDevice":{ - "shape":"AwsDevice", - "documentation":"

Deprecated in favor of awsDeviceV2.

The Direct Connection endpoint which the physical connection terminates on.

" - }, - "awsDeviceV2":{ - "shape":"AwsDeviceV2", - "documentation":"

The Direct Connection endpoint which the physical connection terminates on.

" - } - }, - "documentation":"

An interconnect is a connection that can host other connections.

Like a standard AWS Direct Connect connection, an interconnect represents the physical connection between an AWS Direct Connect partner's network and a specific Direct Connect location. An AWS Direct Connect partner who owns an interconnect can provision hosted connections on the interconnect for their end customers, thereby providing the end customers with connectivity to AWS services.

The resources of the interconnect, including bandwidth and VLAN numbers, are shared by all of the hosted connections on the interconnect, and the owner of the interconnect determines how these resources are assigned.

" - }, - "InterconnectId":{ - "type":"string", - "documentation":"

The ID of the interconnect.

Example: dxcon-abc123

" - }, - "InterconnectList":{ - "type":"list", - "member":{"shape":"Interconnect"}, - "documentation":"

A list of interconnects.

" - }, - "InterconnectName":{ - "type":"string", - "documentation":"

The name of the interconnect.

Example: \"1G Interconnect to AWS\"

" - }, - "InterconnectState":{ - "type":"string", - "documentation":"

State of the interconnect.

  • Requested: The initial state of an interconnect. The interconnect stays in the requested state until the Letter of Authorization (LOA) is sent to the customer.

  • Pending: The interconnect has been approved, and is being initialized.

  • Available: The network link is up, and the interconnect is ready for use.

  • Down: The network link is down.

  • Deleting: The interconnect is in the process of being deleted.

  • Deleted: The interconnect has been deleted.

", - "enum":[ - "requested", - "pending", - "available", - "down", - "deleting", - "deleted" - ] - }, - "Interconnects":{ - "type":"structure", - "members":{ - "interconnects":{ - "shape":"InterconnectList", - "documentation":"

A list of interconnects.

" - } - }, - "documentation":"

A structure containing a list of interconnects.

" - }, - "Lag":{ - "type":"structure", - "members":{ - "connectionsBandwidth":{ - "shape":"Bandwidth", - "documentation":"

The individual bandwidth of the physical connections bundled by the LAG.

Available values: 1Gbps, 10Gbps

" - }, - "numberOfConnections":{ - "shape":"Count", - "documentation":"

The number of physical connections bundled by the LAG, up to a maximum of 10.

" - }, - "lagId":{"shape":"LagId"}, - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The owner of the LAG.

" - }, - "lagName":{ - "shape":"LagName", - "documentation":"

The name of the LAG.

" - }, - "lagState":{"shape":"LagState"}, - "location":{"shape":"LocationCode"}, - "region":{"shape":"Region"}, - "minimumLinks":{ - "shape":"Count", - "documentation":"

The minimum number of physical connections that must be operational for the LAG itself to be operational. If the number of operational connections drops below this setting, the LAG state changes to down. This value can help to ensure that a LAG is not overutilized if a significant number of its bundled connections go down.

" - }, - "awsDevice":{ - "shape":"AwsDevice", - "documentation":"

Deprecated in favor of awsDeviceV2.

The AWS Direct Connection endpoint that hosts the LAG.

" - }, - "awsDeviceV2":{ - "shape":"AwsDeviceV2", - "documentation":"

The AWS Direct Connection endpoint that hosts the LAG.

" - }, - "connections":{ - "shape":"ConnectionList", - "documentation":"

A list of connections bundled by this LAG.

" - }, - "allowsHostedConnections":{ - "shape":"BooleanFlag", - "documentation":"

Indicates whether the LAG can host other connections.

This is intended for use by AWS Direct Connect partners only.

" - } - }, - "documentation":"

Describes a link aggregation group (LAG). A LAG is a connection that uses the Link Aggregation Control Protocol (LACP) to logically aggregate a bundle of physical connections. Like an interconnect, it can host other connections. All connections in a LAG must terminate on the same physical AWS Direct Connect endpoint, and must be the same bandwidth.

" - }, - "LagId":{ - "type":"string", - "documentation":"

The ID of the LAG.

Example: dxlag-fg5678gh

" - }, - "LagList":{ - "type":"list", - "member":{"shape":"Lag"}, - "documentation":"

A list of LAGs.

" - }, - "LagName":{"type":"string"}, - "LagState":{ - "type":"string", - "documentation":"

The state of the LAG.

  • Requested: The initial state of a LAG. The LAG stays in the requested state until the Letter of Authorization (LOA) is available.

  • Pending: The LAG has been approved, and is being initialized.

  • Available: The network link is established, and the LAG is ready for use.

  • Down: The network link is down.

  • Deleting: The LAG is in the process of being deleted.

  • Deleted: The LAG has been deleted.

", - "enum":[ - "requested", - "pending", - "available", - "down", - "deleting", - "deleted" - ] - }, - "Lags":{ - "type":"structure", - "members":{ - "lags":{ - "shape":"LagList", - "documentation":"

A list of LAGs.

" - } - }, - "documentation":"

A structure containing a list of LAGs.

" - }, - "Loa":{ - "type":"structure", - "members":{ - "loaContent":{"shape":"LoaContent"}, - "loaContentType":{"shape":"LoaContentType"} - }, - "documentation":"

A structure containing the Letter of Authorization - Connecting Facility Assignment (LOA-CFA) for a connection.

" - }, - "LoaContent":{ - "type":"blob", - "documentation":"

The binary contents of the LOA-CFA document.

" - }, - "LoaContentType":{ - "type":"string", - "documentation":"

A standard media type indicating the content type of the LOA-CFA document. Currently, the only supported value is \"application/pdf\".

Default: application/pdf

", - "enum":["application/pdf"] - }, - "LoaIssueTime":{"type":"timestamp"}, - "Location":{ - "type":"structure", - "members":{ - "locationCode":{ - "shape":"LocationCode", - "documentation":"

The code used to indicate the AWS Direct Connect location.

" - }, - "locationName":{ - "shape":"LocationName", - "documentation":"

The name of the AWS Direct Connect location. The name includes the colocation partner name and the physical site of the lit building.

" - }, - "region":{ - "shape":"Region", - "documentation":"

The AWS region where the AWS Direct connect location is located.

Example: us-east-1

Default: None

" - } - }, - "documentation":"

An AWS Direct Connect location where connections and interconnects can be requested.

" - }, - "LocationCode":{ - "type":"string", - "documentation":"

Where the connection is located.

Example: EqSV5

Default: None

" - }, - "LocationList":{ - "type":"list", - "member":{"shape":"Location"} - }, - "LocationName":{"type":"string"}, - "Locations":{ - "type":"structure", - "members":{ - "locations":{ - "shape":"LocationList", - "documentation":"

A list of colocation hubs where network providers have equipment. Most regions have multiple locations available.

" - } - }, - "documentation":"

A location is a network facility where AWS Direct Connect routers are available to be connected. Generally, these are colocation hubs where many network providers have equipment, and where cross connects can be delivered. Locations include a name and facility code, and must be provided when creating a connection.

" - }, - "LongAsn":{"type":"long"}, - "MaxResultSetSize":{ - "type":"integer", - "documentation":"

Maximum number of objects to return per page.

", - "box":true - }, - "NewBGPPeer":{ - "type":"structure", - "members":{ - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "addressFamily":{"shape":"AddressFamily"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"} - }, - "documentation":"

A structure containing information about a new BGP peer.

" - }, - "NewPrivateVirtualInterface":{ - "type":"structure", - "required":[ - "virtualInterfaceName", - "vlan", - "asn" - ], - "members":{ - "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, - "vlan":{"shape":"VLAN"}, - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"}, - "addressFamily":{"shape":"AddressFamily"}, - "virtualGatewayId":{"shape":"VirtualGatewayId"}, - "directConnectGatewayId":{"shape":"DirectConnectGatewayId"} - }, - "documentation":"

A structure containing information about a new private virtual interface.

" - }, - "NewPrivateVirtualInterfaceAllocation":{ - "type":"structure", - "required":[ - "virtualInterfaceName", - "vlan", - "asn" - ], - "members":{ - "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, - "vlan":{"shape":"VLAN"}, - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "addressFamily":{"shape":"AddressFamily"}, - "customerAddress":{"shape":"CustomerAddress"} - }, - "documentation":"

A structure containing information about a private virtual interface that will be provisioned on a connection.

" - }, - "NewPublicVirtualInterface":{ - "type":"structure", - "required":[ - "virtualInterfaceName", - "vlan", - "asn" - ], - "members":{ - "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, - "vlan":{"shape":"VLAN"}, - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"}, - "addressFamily":{"shape":"AddressFamily"}, - "routeFilterPrefixes":{"shape":"RouteFilterPrefixList"} - }, - "documentation":"

A structure containing information about a new public virtual interface.

" - }, - "NewPublicVirtualInterfaceAllocation":{ - "type":"structure", - "required":[ - "virtualInterfaceName", - "vlan", - "asn" - ], - "members":{ - "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, - "vlan":{"shape":"VLAN"}, - "asn":{"shape":"ASN"}, - "authKey":{"shape":"BGPAuthKey"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"}, - "addressFamily":{"shape":"AddressFamily"}, - "routeFilterPrefixes":{"shape":"RouteFilterPrefixList"} - }, - "documentation":"

A structure containing information about a public virtual interface that will be provisioned on a connection.

" - }, - "OwnerAccount":{"type":"string"}, - "PaginationToken":{ - "type":"string", - "documentation":"

Token to retrieve the next page of the result.

" - }, - "PartnerName":{"type":"string"}, - "ProviderName":{"type":"string"}, - "Region":{ - "type":"string", - "documentation":"

The AWS region where the connection is located.

Example: us-east-1

Default: None

" - }, - "ResourceArn":{"type":"string"}, - "ResourceArnList":{ - "type":"list", - "member":{"shape":"ResourceArn"} - }, - "ResourceTag":{ - "type":"structure", - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the Direct Connect resource.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The tags.

" - } - }, - "documentation":"

The tags associated with a Direct Connect resource.

" - }, - "ResourceTagList":{ - "type":"list", - "member":{"shape":"ResourceTag"} - }, - "RouteFilterPrefix":{ - "type":"structure", - "members":{ - "cidr":{ - "shape":"CIDR", - "documentation":"

CIDR notation for the advertised route. Multiple routes are separated by commas.

IPv6 CIDRs must be at least a /64 or shorter

Example: 10.10.10.0/24,10.10.11.0/24,2001:db8::/64

" - } - }, - "documentation":"

A route filter prefix that the customer can advertise through Border Gateway Protocol (BGP) over a public virtual interface.

" - }, - "RouteFilterPrefixList":{ - "type":"list", - "member":{"shape":"RouteFilterPrefix"}, - "documentation":"

A list of routes to be advertised to the AWS network in this region (public virtual interface).

" - }, - "RouterConfig":{"type":"string"}, - "StateChangeError":{ - "type":"string", - "documentation":"

Error message when the state of an object fails to advance.

" - }, - "Tag":{ - "type":"structure", - "required":["key"], - "members":{ - "key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Information about a tag.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "min":1 - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tags" - ], - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the Direct Connect resource.

Example: arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-fg5678gh

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The list of tags to add.

" - } - }, - "documentation":"

Container for the parameters to the TagResource operation.

" - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response received when TagResource is called.

" - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have reached the limit on the number of tags that can be assigned to a Direct Connect resource.

", - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tagKeys" - ], - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the Direct Connect resource.

" - }, - "tagKeys":{ - "shape":"TagKeyList", - "documentation":"

The list of tag keys to remove.

" - } - }, - "documentation":"

Container for the parameters to the UntagResource operation.

" - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response received when UntagResource is called.

" - }, - "UpdateLagRequest":{ - "type":"structure", - "required":["lagId"], - "members":{ - "lagId":{ - "shape":"LagId", - "documentation":"

The ID of the LAG to update.

Example: dxlag-abc123

Default: None

" - }, - "lagName":{ - "shape":"LagName", - "documentation":"

The name for the LAG.

Example: \"3x10G LAG to AWS\"

Default: None

" - }, - "minimumLinks":{ - "shape":"Count", - "documentation":"

The minimum number of physical connections that must be operational for the LAG itself to be operational.

Default: None

" - } - }, - "documentation":"

Container for the parameters to the UpdateLag operation.

" - }, - "VLAN":{ - "type":"integer", - "documentation":"

The VLAN ID.

Example: 101

" - }, - "VirtualGateway":{ - "type":"structure", - "members":{ - "virtualGatewayId":{"shape":"VirtualGatewayId"}, - "virtualGatewayState":{"shape":"VirtualGatewayState"} - }, - "documentation":"

You can create one or more AWS Direct Connect private virtual interfaces linking to your virtual private gateway.

Virtual private gateways can be managed using the Amazon Virtual Private Cloud (Amazon VPC) console or the Amazon EC2 CreateVpnGateway action.

" - }, - "VirtualGatewayId":{ - "type":"string", - "documentation":"

The ID of the virtual private gateway to a VPC. This only applies to private virtual interfaces.

Example: vgw-123er56

" - }, - "VirtualGatewayList":{ - "type":"list", - "member":{"shape":"VirtualGateway"}, - "documentation":"

A list of virtual private gateways.

" - }, - "VirtualGatewayRegion":{ - "type":"string", - "documentation":"

The region in which the virtual private gateway is located.

Example: us-east-1

" - }, - "VirtualGatewayState":{ - "type":"string", - "documentation":"

State of the virtual private gateway.

  • Pending: This is the initial state after calling CreateVpnGateway.

  • Available: Ready for use by a private virtual interface.

  • Deleting: This is the initial state after calling DeleteVpnGateway.

  • Deleted: In this state, a private virtual interface is unable to send traffic over this gateway.

" - }, - "VirtualGateways":{ - "type":"structure", - "members":{ - "virtualGateways":{ - "shape":"VirtualGatewayList", - "documentation":"

A list of virtual private gateways.

" - } - }, - "documentation":"

A structure containing a list of virtual private gateways.

" - }, - "VirtualInterface":{ - "type":"structure", - "members":{ - "ownerAccount":{ - "shape":"OwnerAccount", - "documentation":"

The AWS account that will own the new virtual interface.

" - }, - "virtualInterfaceId":{"shape":"VirtualInterfaceId"}, - "location":{"shape":"LocationCode"}, - "connectionId":{"shape":"ConnectionId"}, - "virtualInterfaceType":{"shape":"VirtualInterfaceType"}, - "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, - "vlan":{"shape":"VLAN"}, - "asn":{"shape":"ASN"}, - "amazonSideAsn":{ - "shape":"LongAsn", - "documentation":"

The autonomous system number (ASN) for the Amazon side of the connection.

" - }, - "authKey":{"shape":"BGPAuthKey"}, - "amazonAddress":{"shape":"AmazonAddress"}, - "customerAddress":{"shape":"CustomerAddress"}, - "addressFamily":{"shape":"AddressFamily"}, - "virtualInterfaceState":{"shape":"VirtualInterfaceState"}, - "customerRouterConfig":{ - "shape":"RouterConfig", - "documentation":"

Information for generating the customer router configuration.

" - }, - "virtualGatewayId":{"shape":"VirtualGatewayId"}, - "directConnectGatewayId":{"shape":"DirectConnectGatewayId"}, - "routeFilterPrefixes":{"shape":"RouteFilterPrefixList"}, - "bgpPeers":{"shape":"BGPPeerList"}, - "region":{ - "shape":"Region", - "documentation":"

The AWS region where the virtual interface is located.

Example: us-east-1

Default: None

" - }, - "awsDeviceV2":{ - "shape":"AwsDeviceV2", - "documentation":"

The Direct Connection endpoint which the virtual interface terminates on.

" - } - }, - "documentation":"

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

" - }, - "VirtualInterfaceId":{ - "type":"string", - "documentation":"

The ID of the virtual interface.

Example: dxvif-123dfg56

Default: None

" - }, - "VirtualInterfaceList":{ - "type":"list", - "member":{"shape":"VirtualInterface"}, - "documentation":"

A list of virtual interfaces.

" - }, - "VirtualInterfaceName":{ - "type":"string", - "documentation":"

The name of the virtual interface assigned by the customer.

Example: \"My VPC\"

" - }, - "VirtualInterfaceRegion":{ - "type":"string", - "documentation":"

The region in which the virtual interface is located.

Example: us-east-1

" - }, - "VirtualInterfaceState":{ - "type":"string", - "documentation":"

State of the virtual interface.

  • Confirming: The creation of the virtual interface is pending confirmation from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner.

  • Verifying: This state only applies to public virtual interfaces. Each public virtual interface needs validation before the virtual interface can be created.

  • Pending: A virtual interface is in this state from the time that it is created until the virtual interface is ready to forward traffic.

  • Available: A virtual interface that is able to forward traffic.

  • Down: A virtual interface that is BGP down.

  • Deleting: A virtual interface is in this state immediately after calling DeleteVirtualInterface until it can no longer forward traffic.

  • Deleted: A virtual interface that cannot forward traffic.

  • Rejected: The virtual interface owner has declined creation of the virtual interface. If a virtual interface in the 'Confirming' state is deleted by the virtual interface owner, the virtual interface will enter the 'Rejected' state.

", - "enum":[ - "confirming", - "verifying", - "pending", - "available", - "down", - "deleting", - "deleted", - "rejected" - ] - }, - "VirtualInterfaceType":{ - "type":"string", - "documentation":"

The type of virtual interface.

Example: private (Amazon VPC) or public (Amazon S3, Amazon DynamoDB, and so on.)

" - }, - "VirtualInterfaces":{ - "type":"structure", - "members":{ - "virtualInterfaces":{ - "shape":"VirtualInterfaceList", - "documentation":"

A list of virtual interfaces.

" - } - }, - "documentation":"

A structure containing a list of virtual interfaces.

" - } - }, - "documentation":"

AWS Direct Connect links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. With this connection in place, you can create virtual interfaces directly to the AWS cloud (for example, to Amazon Elastic Compute Cloud (Amazon EC2) and Amazon Simple Storage Service (Amazon S3)) and to Amazon Virtual Private Cloud (Amazon VPC), bypassing Internet service providers in your network path. An AWS Direct Connect location provides access to AWS in the region it is associated with, as well as access to other US regions. For example, you can provision a single connection to any AWS Direct Connect location in the US and use it to access public AWS services in all US Regions and AWS GovCloud (US).

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/service-2.json deleted file mode 100644 index 326ddf19..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/discovery/2015-11-01/service-2.json +++ /dev/null @@ -1,1380 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-11-01", - "endpointPrefix":"discovery", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Application Discovery Service", - "serviceId":"Application Discovery Service", - "signatureVersion":"v4", - "targetPrefix":"AWSPoseidonService_V2015_11_01", - "uid":"discovery-2015-11-01" - }, - "operations":{ - "AssociateConfigurationItemsToApplication":{ - "name":"AssociateConfigurationItemsToApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateConfigurationItemsToApplicationRequest"}, - "output":{"shape":"AssociateConfigurationItemsToApplicationResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Associates one or more configuration items with an application.

" - }, - "CreateApplication":{ - "name":"CreateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationRequest"}, - "output":{"shape":"CreateApplicationResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Creates an application with the given name and description.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "output":{"shape":"CreateTagsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Creates one or more tags for configuration items. Tags are metadata that help you categorize IT assets. This API accepts a list of multiple configuration items.

" - }, - "DeleteApplications":{ - "name":"DeleteApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationsRequest"}, - "output":{"shape":"DeleteApplicationsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Deletes a list of applications and their associations with configuration items.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "output":{"shape":"DeleteTagsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Deletes the association between configuration items and one or more tags. This API accepts a list of multiple configuration items.

" - }, - "DescribeAgents":{ - "name":"DescribeAgents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAgentsRequest"}, - "output":{"shape":"DescribeAgentsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Lists agents or the Connector by ID or lists all agents/Connectors associated with your user account if you did not specify an ID.

" - }, - "DescribeConfigurations":{ - "name":"DescribeConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationsRequest"}, - "output":{"shape":"DescribeConfigurationsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieves attributes for a list of configuration item IDs. All of the supplied IDs must be for the same asset type (server, application, process, or connection). Output fields are specific to the asset type selected. For example, the output for a server configuration item includes a list of attributes about the server, such as host name, operating system, and number of network cards.

For a complete list of outputs for each asset type, see Using the DescribeConfigurations Action.

" - }, - "DescribeExportConfigurations":{ - "name":"DescribeExportConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportConfigurationsRequest"}, - "output":{"shape":"DescribeExportConfigurationsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Deprecated. Use DescribeExportTasks instead.

Retrieves the status of a given export process. You can retrieve status from a maximum of 100 processes.

", - "deprecated":true - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieve status of one or more export tasks. You can retrieve the status of up to 100 export tasks.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieves a list of configuration items that are tagged with a specific tag. Or retrieves a list of all tags assigned to a specific configuration item.

" - }, - "DisassociateConfigurationItemsFromApplication":{ - "name":"DisassociateConfigurationItemsFromApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateConfigurationItemsFromApplicationRequest"}, - "output":{"shape":"DisassociateConfigurationItemsFromApplicationResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Disassociates one or more configuration items from an application.

" - }, - "ExportConfigurations":{ - "name":"ExportConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"ExportConfigurationsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Deprecated. Use StartExportTask instead.

Exports all discovered configuration data to an Amazon S3 bucket or an application that enables you to view and evaluate the data. Data includes tags and tag associations, processes, connections, servers, and system performance. This API returns an export ID that you can query using the DescribeExportConfigurations API. The system imposes a limit of two configuration exports in six hours.

", - "deprecated":true - }, - "GetDiscoverySummary":{ - "name":"GetDiscoverySummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDiscoverySummaryRequest"}, - "output":{"shape":"GetDiscoverySummaryResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieves a short summary of discovered assets.

" - }, - "ListConfigurations":{ - "name":"ListConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListConfigurationsRequest"}, - "output":{"shape":"ListConfigurationsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieves a list of configuration items according to criteria that you specify in a filter. The filter criteria identifies the relationship requirements.

" - }, - "ListServerNeighbors":{ - "name":"ListServerNeighbors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListServerNeighborsRequest"}, - "output":{"shape":"ListServerNeighborsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Retrieves a list of servers that are one network hop away from a specified server.

" - }, - "StartDataCollectionByAgentIds":{ - "name":"StartDataCollectionByAgentIds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartDataCollectionByAgentIdsRequest"}, - "output":{"shape":"StartDataCollectionByAgentIdsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Instructs the specified agents or connectors to start collecting data.

" - }, - "StartExportTask":{ - "name":"StartExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartExportTaskRequest"}, - "output":{"shape":"StartExportTaskResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Begins the export of discovered data to an S3 bucket.

If you specify agentIds in a filter, the task exports up to 72 hours of detailed data collected by the identified Application Discovery Agent, including network, process, and performance details. A time range for exported agent data may be set by using startTime and endTime. Export of detailed agent data is limited to five concurrently running exports.

If you do not include an agentIds filter, summary data is exported that includes both AWS Agentless Discovery Connector data and summary data from AWS Discovery Agents. Export of summary data is limited to two exports per day.

" - }, - "StopDataCollectionByAgentIds":{ - "name":"StopDataCollectionByAgentIds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopDataCollectionByAgentIdsRequest"}, - "output":{"shape":"StopDataCollectionByAgentIdsResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Instructs the specified agents or connectors to stop collecting data.

" - }, - "UpdateApplication":{ - "name":"UpdateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationRequest"}, - "output":{"shape":"UpdateApplicationResponse"}, - "errors":[ - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ServerInternalErrorException"} - ], - "documentation":"

Updates metadata about an application.

" - } - }, - "shapes":{ - "AgentConfigurationStatus":{ - "type":"structure", - "members":{ - "agentId":{ - "shape":"String", - "documentation":"

The agent/connector ID.

" - }, - "operationSucceeded":{ - "shape":"Boolean", - "documentation":"

Information about the status of the StartDataCollection and StopDataCollection operations. The system has recorded the data collection operation. The agent/connector receives this command the next time it polls for a new command.

" - }, - "description":{ - "shape":"String", - "documentation":"

A description of the operation performed.

" - } - }, - "documentation":"

Information about agents or connectors that were instructed to start collecting data. Information includes the agent/connector ID, a description of the operation, and whether the agent/connector configuration was updated.

" - }, - "AgentConfigurationStatusList":{ - "type":"list", - "member":{"shape":"AgentConfigurationStatus"} - }, - "AgentId":{"type":"string"}, - "AgentIds":{ - "type":"list", - "member":{"shape":"AgentId"} - }, - "AgentInfo":{ - "type":"structure", - "members":{ - "agentId":{ - "shape":"AgentId", - "documentation":"

The agent or connector ID.

" - }, - "hostName":{ - "shape":"String", - "documentation":"

The name of the host where the agent or connector resides. The host can be a server or virtual machine.

" - }, - "agentNetworkInfoList":{ - "shape":"AgentNetworkInfoList", - "documentation":"

Network details about the host where the agent or connector resides.

" - }, - "connectorId":{ - "shape":"String", - "documentation":"

The ID of the connector.

" - }, - "version":{ - "shape":"String", - "documentation":"

The agent or connector version.

" - }, - "health":{ - "shape":"AgentStatus", - "documentation":"

The health of the agent or connector.

" - }, - "lastHealthPingTime":{ - "shape":"String", - "documentation":"

Time since agent or connector health was reported.

" - }, - "collectionStatus":{ - "shape":"String", - "documentation":"

Status of the collection process for an agent or connector.

" - }, - "agentType":{ - "shape":"String", - "documentation":"

Type of agent.

" - }, - "registeredTime":{ - "shape":"String", - "documentation":"

Agent's first registration timestamp in UTC.

" - } - }, - "documentation":"

Information about agents or connectors associated with the user’s AWS account. Information includes agent or connector IDs, IP addresses, media access control (MAC) addresses, agent or connector health, hostname where the agent or connector resides, and agent version for each agent.

" - }, - "AgentNetworkInfo":{ - "type":"structure", - "members":{ - "ipAddress":{ - "shape":"String", - "documentation":"

The IP address for the host where the agent/connector resides.

" - }, - "macAddress":{ - "shape":"String", - "documentation":"

The MAC address for the host where the agent/connector resides.

" - } - }, - "documentation":"

Network details about the host where the agent/connector resides.

" - }, - "AgentNetworkInfoList":{ - "type":"list", - "member":{"shape":"AgentNetworkInfo"} - }, - "AgentStatus":{ - "type":"string", - "enum":[ - "HEALTHY", - "UNHEALTHY", - "RUNNING", - "UNKNOWN", - "BLACKLISTED", - "SHUTDOWN" - ] - }, - "AgentsInfo":{ - "type":"list", - "member":{"shape":"AgentInfo"} - }, - "ApplicationId":{"type":"string"}, - "ApplicationIdsList":{ - "type":"list", - "member":{"shape":"ApplicationId"} - }, - "AssociateConfigurationItemsToApplicationRequest":{ - "type":"structure", - "required":[ - "applicationConfigurationId", - "configurationIds" - ], - "members":{ - "applicationConfigurationId":{ - "shape":"ApplicationId", - "documentation":"

The configuration ID of an application with which items are to be associated.

" - }, - "configurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

The ID of each configuration item to be associated with an application.

" - } - } - }, - "AssociateConfigurationItemsToApplicationResponse":{ - "type":"structure", - "members":{ - } - }, - "AuthorizationErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

The AWS user account does not have permission to perform the action. Check the IAM policy associated with this account.

", - "exception":true - }, - "Boolean":{"type":"boolean"}, - "BoxedInteger":{ - "type":"integer", - "box":true - }, - "Condition":{"type":"string"}, - "Configuration":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "ConfigurationId":{"type":"string"}, - "ConfigurationIdList":{ - "type":"list", - "member":{"shape":"ConfigurationId"} - }, - "ConfigurationItemType":{ - "type":"string", - "enum":[ - "SERVER", - "PROCESS", - "CONNECTION", - "APPLICATION" - ] - }, - "ConfigurationTag":{ - "type":"structure", - "members":{ - "configurationType":{ - "shape":"ConfigurationItemType", - "documentation":"

A type of IT asset to tag.

" - }, - "configurationId":{ - "shape":"ConfigurationId", - "documentation":"

The configuration ID for the item to tag. You can specify a list of keys and values.

" - }, - "key":{ - "shape":"TagKey", - "documentation":"

A type of tag on which to filter. For example, serverType.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

A value on which to filter. For example key = serverType and value = web server.

" - }, - "timeOfCreation":{ - "shape":"TimeStamp", - "documentation":"

The time the configuration tag was created in Coordinated Universal Time (UTC).

" - } - }, - "documentation":"

Tags for a configuration item. Tags are metadata that help you categorize IT assets.

" - }, - "ConfigurationTagSet":{ - "type":"list", - "member":{"shape":"ConfigurationTag"} - }, - "Configurations":{ - "type":"list", - "member":{"shape":"Configuration"} - }, - "ConfigurationsDownloadUrl":{"type":"string"}, - "ConfigurationsExportId":{"type":"string"}, - "CreateApplicationRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

Name of the application to be created.

" - }, - "description":{ - "shape":"String", - "documentation":"

Description of the application to be created.

" - } - } - }, - "CreateApplicationResponse":{ - "type":"structure", - "members":{ - "configurationId":{ - "shape":"String", - "documentation":"

Configuration ID of an application to be created.

" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "configurationIds", - "tags" - ], - "members":{ - "configurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

A list of configuration items that you want to tag.

" - }, - "tags":{ - "shape":"TagSet", - "documentation":"

Tags that you want to associate with one or more configuration items. Specify the tags that you want to create in a key-value format. For example:

{\"key\": \"serverType\", \"value\": \"webServer\"}

" - } - } - }, - "CreateTagsResponse":{ - "type":"structure", - "members":{ - } - }, - "CustomerAgentInfo":{ - "type":"structure", - "required":[ - "activeAgents", - "healthyAgents", - "blackListedAgents", - "shutdownAgents", - "unhealthyAgents", - "totalAgents", - "unknownAgents" - ], - "members":{ - "activeAgents":{ - "shape":"Integer", - "documentation":"

Number of active discovery agents.

" - }, - "healthyAgents":{ - "shape":"Integer", - "documentation":"

Number of healthy discovery agents

" - }, - "blackListedAgents":{ - "shape":"Integer", - "documentation":"

Number of blacklisted discovery agents.

" - }, - "shutdownAgents":{ - "shape":"Integer", - "documentation":"

Number of discovery agents with status SHUTDOWN.

" - }, - "unhealthyAgents":{ - "shape":"Integer", - "documentation":"

Number of unhealthy discovery agents.

" - }, - "totalAgents":{ - "shape":"Integer", - "documentation":"

Total number of discovery agents.

" - }, - "unknownAgents":{ - "shape":"Integer", - "documentation":"

Number of unknown discovery agents.

" - } - }, - "documentation":"

Inventory data for installed discovery agents.

" - }, - "CustomerConnectorInfo":{ - "type":"structure", - "required":[ - "activeConnectors", - "healthyConnectors", - "blackListedConnectors", - "shutdownConnectors", - "unhealthyConnectors", - "totalConnectors", - "unknownConnectors" - ], - "members":{ - "activeConnectors":{ - "shape":"Integer", - "documentation":"

Number of active discovery connectors.

" - }, - "healthyConnectors":{ - "shape":"Integer", - "documentation":"

Number of healthy discovery connectors.

" - }, - "blackListedConnectors":{ - "shape":"Integer", - "documentation":"

Number of blacklisted discovery connectors.

" - }, - "shutdownConnectors":{ - "shape":"Integer", - "documentation":"

Number of discovery connectors with status SHUTDOWN,

" - }, - "unhealthyConnectors":{ - "shape":"Integer", - "documentation":"

Number of unhealthy discovery connectors.

" - }, - "totalConnectors":{ - "shape":"Integer", - "documentation":"

Total number of discovery connectors.

" - }, - "unknownConnectors":{ - "shape":"Integer", - "documentation":"

Number of unknown discovery connectors.

" - } - }, - "documentation":"

Inventory data for installed discovery connectors.

" - }, - "DeleteApplicationsRequest":{ - "type":"structure", - "required":["configurationIds"], - "members":{ - "configurationIds":{ - "shape":"ApplicationIdsList", - "documentation":"

Configuration ID of an application to be deleted.

" - } - } - }, - "DeleteApplicationsResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["configurationIds"], - "members":{ - "configurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

A list of configuration items with tags that you want to delete.

" - }, - "tags":{ - "shape":"TagSet", - "documentation":"

Tags that you want to delete from one or more configuration items. Specify the tags that you want to delete in a key-value format. For example:

{\"key\": \"serverType\", \"value\": \"webServer\"}

" - } - } - }, - "DeleteTagsResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeAgentsRequest":{ - "type":"structure", - "members":{ - "agentIds":{ - "shape":"AgentIds", - "documentation":"

The agent or the Connector IDs for which you want information. If you specify no IDs, the system returns information about all agents/Connectors associated with your AWS user account.

" - }, - "filters":{ - "shape":"Filters", - "documentation":"

You can filter the request using various logical operators and a key-value format. For example:

{\"key\": \"collectionStatus\", \"value\": \"STARTED\"}

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The total number of agents/Connectors to return in a single page of output. The maximum value is 100.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Token to retrieve the next set of results. For example, if you previously specified 100 IDs for DescribeAgentsRequest$agentIds but set DescribeAgentsRequest$maxResults to 10, you received a set of 10 results along with a token. Use that token in this query to get the next set of 10.

" - } - } - }, - "DescribeAgentsResponse":{ - "type":"structure", - "members":{ - "agentsInfo":{ - "shape":"AgentsInfo", - "documentation":"

Lists agents or the Connector by ID or lists all agents/Connectors associated with your user account if you did not specify an agent/Connector ID. The output includes agent/Connector IDs, IP addresses, media access control (MAC) addresses, agent/Connector health, host name where the agent/Connector resides, and the version number of each agent/Connector.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Token to retrieve the next set of results. For example, if you specified 100 IDs for DescribeAgentsRequest$agentIds but set DescribeAgentsRequest$maxResults to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.

" - } - } - }, - "DescribeConfigurationsAttribute":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "DescribeConfigurationsAttributes":{ - "type":"list", - "member":{"shape":"DescribeConfigurationsAttribute"} - }, - "DescribeConfigurationsRequest":{ - "type":"structure", - "required":["configurationIds"], - "members":{ - "configurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

One or more configuration IDs.

" - } - } - }, - "DescribeConfigurationsResponse":{ - "type":"structure", - "members":{ - "configurations":{ - "shape":"DescribeConfigurationsAttributes", - "documentation":"

A key in the response map. The value is an array of data.

" - } - } - }, - "DescribeExportConfigurationsRequest":{ - "type":"structure", - "members":{ - "exportIds":{ - "shape":"ExportIds", - "documentation":"

A unique identifier that you can use to query the export status.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results that you want to display as a part of the query.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token to get the next set of results. For example, if you specify 100 IDs for DescribeExportConfigurationsRequest$exportIds but set DescribeExportConfigurationsRequest$maxResults to 10, you get results in a set of 10. Use the token in the query to get the next set of 10.

" - } - } - }, - "DescribeExportConfigurationsResponse":{ - "type":"structure", - "members":{ - "exportsInfo":{ - "shape":"ExportsInfo", - "documentation":"

Returns export details. When the status is complete, the response includes a URL for an Amazon S3 bucket where you can view the data in a CSV file.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token to get the next set of results. For example, if you specify 100 IDs for DescribeExportConfigurationsRequest$exportIds but set DescribeExportConfigurationsRequest$maxResults to 10, you get results in a set of 10. Use the token in the query to get the next set of 10.

" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "exportIds":{ - "shape":"ExportIds", - "documentation":"

One or more unique identifiers used to query the status of an export request.

" - }, - "filters":{ - "shape":"ExportFilters", - "documentation":"

One or more filters.

  • AgentId - ID of the agent whose collected data will be exported

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeExportTasks in paginated output. When this parameter is used, DescribeExportTasks only returns maxResults results in a single page along with a nextToken response element.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value returned from a previous paginated DescribeExportTasks request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

" - } - } - }, - "DescribeExportTasksResponse":{ - "type":"structure", - "members":{ - "exportsInfo":{ - "shape":"ExportsInfo", - "documentation":"

Contains one or more sets of export request details. When the status of a request is SUCCEEDED, the response includes a URL for an Amazon S3 bucket where you can view the data in a CSV file.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value to include in a future DescribeExportTasks request. When the results of a DescribeExportTasks request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "filters":{ - "shape":"TagFilters", - "documentation":"

You can filter the list using a key-value format. You can separate these items by using logical operators. Allowed filters include tagKey, tagValue, and configurationId.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The total number of items to return in a single page of output. The maximum value is 100.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "DescribeTagsResponse":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"ConfigurationTagSet", - "documentation":"

Depending on the input, this is a list of configuration items tagged with a specific tag, or a list of tags for a specific configuration item.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The call returns a token. Use this token to get the next set of results.

" - } - } - }, - "DisassociateConfigurationItemsFromApplicationRequest":{ - "type":"structure", - "required":[ - "applicationConfigurationId", - "configurationIds" - ], - "members":{ - "applicationConfigurationId":{ - "shape":"ApplicationId", - "documentation":"

Configuration ID of an application from which each item is disassociated.

" - }, - "configurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

Configuration ID of each item to be disassociated from an application.

" - } - } - }, - "DisassociateConfigurationItemsFromApplicationResponse":{ - "type":"structure", - "members":{ - } - }, - "ExportConfigurationsResponse":{ - "type":"structure", - "members":{ - "exportId":{ - "shape":"ConfigurationsExportId", - "documentation":"

A unique identifier that you can use to query the export status.

" - } - } - }, - "ExportDataFormat":{ - "type":"string", - "enum":[ - "CSV", - "GRAPHML" - ] - }, - "ExportDataFormats":{ - "type":"list", - "member":{"shape":"ExportDataFormat"} - }, - "ExportFilter":{ - "type":"structure", - "required":[ - "name", - "values", - "condition" - ], - "members":{ - "name":{ - "shape":"FilterName", - "documentation":"

A single ExportFilter name. Supported filters: agentId.

" - }, - "values":{ - "shape":"FilterValues", - "documentation":"

A single agentId for a Discovery Agent. An agentId can be found using the DescribeAgents action. Typically an ADS agentId is in the form o-0123456789abcdef0.

" - }, - "condition":{ - "shape":"Condition", - "documentation":"

Supported condition: EQUALS

" - } - }, - "documentation":"

Used to select which agent's data is to be exported. A single agent ID may be selected for export using the StartExportTask action.

" - }, - "ExportFilters":{ - "type":"list", - "member":{"shape":"ExportFilter"} - }, - "ExportIds":{ - "type":"list", - "member":{"shape":"ConfigurationsExportId"} - }, - "ExportInfo":{ - "type":"structure", - "required":[ - "exportId", - "exportStatus", - "statusMessage", - "exportRequestTime" - ], - "members":{ - "exportId":{ - "shape":"ConfigurationsExportId", - "documentation":"

A unique identifier used to query an export.

" - }, - "exportStatus":{ - "shape":"ExportStatus", - "documentation":"

The status of the data export job.

" - }, - "statusMessage":{ - "shape":"ExportStatusMessage", - "documentation":"

A status message provided for API callers.

" - }, - "configurationsDownloadUrl":{ - "shape":"ConfigurationsDownloadUrl", - "documentation":"

A URL for an Amazon S3 bucket where you can review the exported data. The URL is displayed only if the export succeeded.

" - }, - "exportRequestTime":{ - "shape":"ExportRequestTime", - "documentation":"

The time that the data export was initiated.

" - }, - "isTruncated":{ - "shape":"Boolean", - "documentation":"

If true, the export of agent information exceeded the size limit for a single export and the exported data is incomplete for the requested time range. To address this, select a smaller time range for the export by using startDate and endDate.

" - }, - "requestedStartTime":{ - "shape":"TimeStamp", - "documentation":"

The value of startTime parameter in the StartExportTask request. If no startTime was requested, this result does not appear in ExportInfo.

" - }, - "requestedEndTime":{ - "shape":"TimeStamp", - "documentation":"

The endTime used in the StartExportTask request. If no endTime was requested, this result does not appear in ExportInfo.

" - } - }, - "documentation":"

Information regarding the export status of discovered data. The value is an array of objects.

" - }, - "ExportRequestTime":{"type":"timestamp"}, - "ExportStatus":{ - "type":"string", - "enum":[ - "FAILED", - "SUCCEEDED", - "IN_PROGRESS" - ] - }, - "ExportStatusMessage":{"type":"string"}, - "ExportsInfo":{ - "type":"list", - "member":{"shape":"ExportInfo"} - }, - "Filter":{ - "type":"structure", - "required":[ - "name", - "values", - "condition" - ], - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the filter.

" - }, - "values":{ - "shape":"FilterValues", - "documentation":"

A string value on which to filter. For example, if you choose the destinationServer.osVersion filter name, you could specify Ubuntu for the value.

" - }, - "condition":{ - "shape":"Condition", - "documentation":"

A conditional operator. The following operators are valid: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS. If you specify multiple filters, the system utilizes all filters as though concatenated by AND. If you specify multiple values for a particular filter, the system differentiates the values using OR. Calling either DescribeConfigurations or ListConfigurations returns attributes of matching configuration items.

" - } - }, - "documentation":"

A filter that can use conditional operators.

For more information about filters, see Querying Discovered Configuration Items.

" - }, - "FilterName":{"type":"string"}, - "FilterValue":{"type":"string"}, - "FilterValues":{ - "type":"list", - "member":{"shape":"FilterValue"} - }, - "Filters":{ - "type":"list", - "member":{"shape":"Filter"} - }, - "GetDiscoverySummaryRequest":{ - "type":"structure", - "members":{ - } - }, - "GetDiscoverySummaryResponse":{ - "type":"structure", - "members":{ - "servers":{ - "shape":"Long", - "documentation":"

The number of servers discovered.

" - }, - "applications":{ - "shape":"Long", - "documentation":"

The number of applications discovered.

" - }, - "serversMappedToApplications":{ - "shape":"Long", - "documentation":"

The number of servers mapped to applications.

" - }, - "serversMappedtoTags":{ - "shape":"Long", - "documentation":"

The number of servers mapped to tags.

" - }, - "agentSummary":{ - "shape":"CustomerAgentInfo", - "documentation":"

Details about discovered agents, including agent status and health.

" - }, - "connectorSummary":{ - "shape":"CustomerConnectorInfo", - "documentation":"

Details about discovered connectors, including connector status and health.

" - } - } - }, - "Integer":{"type":"integer"}, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

One or more parameters are not valid. Verify the parameters and try again.

", - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

The value of one or more parameters are either invalid or out of range. Verify the parameter values and try again.

", - "exception":true - }, - "ListConfigurationsRequest":{ - "type":"structure", - "required":["configurationType"], - "members":{ - "configurationType":{ - "shape":"ConfigurationItemType", - "documentation":"

A valid configuration identified by Application Discovery Service.

" - }, - "filters":{ - "shape":"Filters", - "documentation":"

You can filter the request using various logical operators and a key-value format. For example:

{\"key\": \"serverType\", \"value\": \"webServer\"}

For a complete list of filter options and guidance about using them with this action, see Querying Discovered Configuration Items.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

The total number of items to return. The maximum value is 100.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Token to retrieve the next set of results. For example, if a previous call to ListConfigurations returned 100 items, but you set ListConfigurationsRequest$maxResults to 10, you received a set of 10 results along with a token. Use that token in this query to get the next set of 10.

" - }, - "orderBy":{ - "shape":"OrderByList", - "documentation":"

Certain filter criteria return output that can be sorted in ascending or descending order. For a list of output characteristics for each filter, see Using the ListConfigurations Action.

" - } - } - }, - "ListConfigurationsResponse":{ - "type":"structure", - "members":{ - "configurations":{ - "shape":"Configurations", - "documentation":"

Returns configuration details, including the configuration ID, attribute names, and attribute values.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Token to retrieve the next set of results. For example, if your call to ListConfigurations returned 100 items, but you set ListConfigurationsRequest$maxResults to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.

" - } - } - }, - "ListServerNeighborsRequest":{ - "type":"structure", - "required":["configurationId"], - "members":{ - "configurationId":{ - "shape":"ConfigurationId", - "documentation":"

Configuration ID of the server for which neighbors are being listed.

" - }, - "portInformationNeeded":{ - "shape":"Boolean", - "documentation":"

Flag to indicate if port and protocol information is needed as part of the response.

" - }, - "neighborConfigurationIds":{ - "shape":"ConfigurationIdList", - "documentation":"

List of configuration IDs to test for one-hop-away.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

Maximum number of results to return in a single page of output.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

Token to retrieve the next set of results. For example, if you previously specified 100 IDs for ListServerNeighborsRequest$neighborConfigurationIds but set ListServerNeighborsRequest$maxResults to 10, you received a set of 10 results along with a token. Use that token in this query to get the next set of 10.

" - } - } - }, - "ListServerNeighborsResponse":{ - "type":"structure", - "required":["neighbors"], - "members":{ - "neighbors":{ - "shape":"NeighborDetailsList", - "documentation":"

List of distinct servers that are one hop away from the given server.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

Token to retrieve the next set of results. For example, if you specified 100 IDs for ListServerNeighborsRequest$neighborConfigurationIds but set ListServerNeighborsRequest$maxResults to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.

" - }, - "knownDependencyCount":{ - "shape":"Long", - "documentation":"

Count of distinct servers that are one hop away from the given server.

" - } - } - }, - "Long":{"type":"long"}, - "Message":{"type":"string"}, - "NeighborConnectionDetail":{ - "type":"structure", - "required":[ - "sourceServerId", - "destinationServerId", - "connectionsCount" - ], - "members":{ - "sourceServerId":{ - "shape":"ConfigurationId", - "documentation":"

The ID of the server that opened the network connection.

" - }, - "destinationServerId":{ - "shape":"ConfigurationId", - "documentation":"

The ID of the server that accepted the network connection.

" - }, - "destinationPort":{ - "shape":"BoxedInteger", - "documentation":"

The destination network port for the connection.

" - }, - "transportProtocol":{ - "shape":"String", - "documentation":"

The network protocol used for the connection.

" - }, - "connectionsCount":{ - "shape":"Long", - "documentation":"

The number of open network connections with the neighboring server.

" - } - }, - "documentation":"

Details about neighboring servers.

" - }, - "NeighborDetailsList":{ - "type":"list", - "member":{"shape":"NeighborConnectionDetail"} - }, - "NextToken":{"type":"string"}, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

This operation is not permitted.

", - "exception":true - }, - "OrderByElement":{ - "type":"structure", - "required":["fieldName"], - "members":{ - "fieldName":{ - "shape":"String", - "documentation":"

The field on which to order.

" - }, - "sortOrder":{ - "shape":"orderString", - "documentation":"

Ordering direction.

" - } - }, - "documentation":"

A field and direction for ordered output.

" - }, - "OrderByList":{ - "type":"list", - "member":{"shape":"OrderByElement"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

The specified configuration ID was not located. Verify the configuration ID and try again.

", - "exception":true - }, - "ServerInternalErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"Message"} - }, - "documentation":"

The server experienced an internal error. Try again.

", - "exception":true, - "fault":true - }, - "StartDataCollectionByAgentIdsRequest":{ - "type":"structure", - "required":["agentIds"], - "members":{ - "agentIds":{ - "shape":"AgentIds", - "documentation":"

The IDs of the agents or connectors from which to start collecting data. If you send a request to an agent/connector ID that you do not have permission to contact, according to your AWS account, the service does not throw an exception. Instead, it returns the error in the Description field. If you send a request to multiple agents/connectors and you do not have permission to contact some of those agents/connectors, the system does not throw an exception. Instead, the system shows Failed in the Description field.

" - } - } - }, - "StartDataCollectionByAgentIdsResponse":{ - "type":"structure", - "members":{ - "agentsConfigurationStatus":{ - "shape":"AgentConfigurationStatusList", - "documentation":"

Information about agents or the connector that were instructed to start collecting data. Information includes the agent/connector ID, a description of the operation performed, and whether the agent/connector configuration was updated.

" - } - } - }, - "StartExportTaskRequest":{ - "type":"structure", - "members":{ - "exportDataFormat":{ - "shape":"ExportDataFormats", - "documentation":"

The file format for the returned export data. Default value is CSV. Note: The GRAPHML option has been deprecated.

" - }, - "filters":{ - "shape":"ExportFilters", - "documentation":"

If a filter is present, it selects the single agentId of the Application Discovery Agent for which data is exported. The agentId can be found in the results of the DescribeAgents API or CLI. If no filter is present, startTime and endTime are ignored and exported data includes both Agentless Discovery Connector data and summary data from Application Discovery agents.

" - }, - "startTime":{ - "shape":"TimeStamp", - "documentation":"

The start timestamp for exported data from the single Application Discovery Agent selected in the filters. If no value is specified, data is exported starting from the first data collected by the agent.

" - }, - "endTime":{ - "shape":"TimeStamp", - "documentation":"

The end timestamp for exported data from the single Application Discovery Agent selected in the filters. If no value is specified, exported data includes the most recent data collected by the agent.

" - } - } - }, - "StartExportTaskResponse":{ - "type":"structure", - "members":{ - "exportId":{ - "shape":"ConfigurationsExportId", - "documentation":"

A unique identifier used to query the status of an export request.

" - } - } - }, - "StopDataCollectionByAgentIdsRequest":{ - "type":"structure", - "required":["agentIds"], - "members":{ - "agentIds":{ - "shape":"AgentIds", - "documentation":"

The IDs of the agents or connectors from which to stop collecting data.

" - } - } - }, - "StopDataCollectionByAgentIdsResponse":{ - "type":"structure", - "members":{ - "agentsConfigurationStatus":{ - "shape":"AgentConfigurationStatusList", - "documentation":"

Information about the agents or connector that were instructed to stop collecting data. Information includes the agent/connector ID, a description of the operation performed, and whether the agent/connector configuration was updated.

" - } - } - }, - "String":{"type":"string"}, - "Tag":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"TagKey", - "documentation":"

The type of tag on which to filter.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

A value for a tag key on which to filter.

" - } - }, - "documentation":"

Metadata that help you categorize IT assets.

" - }, - "TagFilter":{ - "type":"structure", - "required":[ - "name", - "values" - ], - "members":{ - "name":{ - "shape":"FilterName", - "documentation":"

A name of the tag filter.

" - }, - "values":{ - "shape":"FilterValues", - "documentation":"

Values for the tag filter.

" - } - }, - "documentation":"

The tag filter. Valid names are: tagKey, tagValue, configurationId.

" - }, - "TagFilters":{ - "type":"list", - "member":{"shape":"TagFilter"} - }, - "TagKey":{"type":"string"}, - "TagSet":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{"type":"string"}, - "TimeStamp":{"type":"timestamp"}, - "UpdateApplicationRequest":{ - "type":"structure", - "required":["configurationId"], - "members":{ - "configurationId":{ - "shape":"ApplicationId", - "documentation":"

Configuration ID of the application to be updated.

" - }, - "name":{ - "shape":"String", - "documentation":"

New name of the application to be updated.

" - }, - "description":{ - "shape":"String", - "documentation":"

New description of the application to be updated.

" - } - } - }, - "UpdateApplicationResponse":{ - "type":"structure", - "members":{ - } - }, - "orderString":{ - "type":"string", - "enum":[ - "ASC", - "DESC" - ] - } - }, - "documentation":"AWS Application Discovery Service

AWS Application Discovery Service helps you plan application migration projects by automatically identifying servers, virtual machines (VMs), software, and software dependencies running in your on-premises data centers. Application Discovery Service also collects application performance data, which can help you assess the outcome of your migration. The data collected by Application Discovery Service is securely retained in an AWS-hosted and managed database in the cloud. You can export the data as a CSV or XML file into your preferred visualization tool or cloud-migration solution to plan your migration. For more information, see AWS Application Discovery Service FAQ.

Application Discovery Service offers two modes of operation:

  • Agentless discovery mode is recommended for environments that use VMware vCenter Server. This mode doesn't require you to install an agent on each host. Agentless discovery gathers server information regardless of the operating systems, which minimizes the time required for initial on-premises infrastructure assessment. Agentless discovery doesn't collect information about software and software dependencies. It also doesn't work in non-VMware environments.

  • Agent-based discovery mode collects a richer set of data than agentless discovery by using the AWS Application Discovery Agent, which you install on one or more hosts in your data center. The agent captures infrastructure and application information, including an inventory of installed software applications, system and process performance, resource utilization, and network dependencies between workloads. The information collected by agents is secured at rest and in transit to the Application Discovery Service database in the cloud.

We recommend that you use agent-based discovery for non-VMware environments and to collect information about software and software dependencies. You can also run agent-based and agentless discovery simultaneously. Use agentless discovery to quickly complete the initial infrastructure assessment and then install agents on select hosts.

Application Discovery Service integrates with application discovery solutions from AWS Partner Network (APN) partners. Third-party application discovery tools can query Application Discovery Service and write to the Application Discovery Service database using a public API. You can then import the data into either a visualization tool or cloud-migration solution.

Application Discovery Service doesn't gather sensitive information. All data is handled according to the AWS Privacy Policy. You can operate Application Discovery Service offline to inspect collected data before it is shared with the service.

Your AWS account must be granted access to Application Discovery Service, a process called whitelisting. This is true for AWS partners and customers alike. To request access, sign up for Application Discovery Service.

This API reference provides descriptions, syntax, and usage examples for each of the actions and data types for Application Discovery Service. The topic for each action shows the API request parameters and the response. Alternatively, you can use one of the AWS SDKs to access an API that is tailored to the programming language or platform that you're using. For more information, see AWS SDKs.

This guide is intended for use with the AWS Application Discovery Service User Guide .

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/service-2.json deleted file mode 100644 index 658e5448..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dlm/2018-01-12/service-2.json +++ /dev/null @@ -1,558 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2018-01-12", - "endpointPrefix":"dlm", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"Amazon DLM", - "serviceFullName":"Amazon Data Lifecycle Manager", - "serviceId":"DLM", - "signatureVersion":"v4", - "signingName":"dlm", - "uid":"dlm-2018-01-12" - }, - "operations":{ - "CreateLifecyclePolicy":{ - "name":"CreateLifecyclePolicy", - "http":{ - "method":"POST", - "requestUri":"/policies" - }, - "input":{"shape":"CreateLifecyclePolicyRequest"}, - "output":{"shape":"CreateLifecyclePolicyResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerException"} - ], - "documentation":"

Creates a policy to manage the lifecycle of the specified AWS resources. You can create up to 100 lifecycle policies.

" - }, - "DeleteLifecyclePolicy":{ - "name":"DeleteLifecyclePolicy", - "http":{ - "method":"DELETE", - "requestUri":"/policies/{policyId}/" - }, - "input":{"shape":"DeleteLifecyclePolicyRequest"}, - "output":{"shape":"DeleteLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Deletes the specified lifecycle policy and halts the automated operations that the policy specified.

" - }, - "GetLifecyclePolicies":{ - "name":"GetLifecyclePolicies", - "http":{ - "method":"GET", - "requestUri":"/policies" - }, - "input":{"shape":"GetLifecyclePoliciesRequest"}, - "output":{"shape":"GetLifecyclePoliciesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServerException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Gets summary information about all or the specified data lifecycle policies.

To get complete information about a policy, use GetLifecyclePolicy.

" - }, - "GetLifecyclePolicy":{ - "name":"GetLifecyclePolicy", - "http":{ - "method":"GET", - "requestUri":"/policies/{policyId}/" - }, - "input":{"shape":"GetLifecyclePolicyRequest"}, - "output":{"shape":"GetLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Gets detailed information about the specified lifecycle policy.

" - }, - "UpdateLifecyclePolicy":{ - "name":"UpdateLifecyclePolicy", - "http":{ - "method":"PATCH", - "requestUri":"/policies/{policyId}" - }, - "input":{"shape":"UpdateLifecyclePolicyRequest"}, - "output":{"shape":"UpdateLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServerException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Updates the specified lifecycle policy.

" - } - }, - "shapes":{ - "Count":{ - "type":"integer", - "max":1000, - "min":1 - }, - "CreateLifecyclePolicyRequest":{ - "type":"structure", - "required":[ - "ExecutionRoleArn", - "Description", - "State", - "PolicyDetails" - ], - "members":{ - "ExecutionRoleArn":{ - "shape":"ExecutionRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

A description of the lifecycle policy. The characters ^[0-9A-Za-z _-]+$ are supported.

" - }, - "State":{ - "shape":"SettablePolicyStateValues", - "documentation":"

The desired activation state of the lifecycle policy after creation.

" - }, - "PolicyDetails":{ - "shape":"PolicyDetails", - "documentation":"

The configuration of the lifecycle policy.

Target tags cannot be re-used across lifecycle policies.

" - } - } - }, - "CreateLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

" - } - } - }, - "CreateRule":{ - "type":"structure", - "required":[ - "Interval", - "IntervalUnit" - ], - "members":{ - "Interval":{ - "shape":"Interval", - "documentation":"

The interval. The supported values are 12 and 24.

" - }, - "IntervalUnit":{ - "shape":"IntervalUnitValues", - "documentation":"

The interval unit.

" - }, - "Times":{ - "shape":"TimesList", - "documentation":"

The time, in UTC, to start the operation.

The operation occurs within a one-hour window following the specified time.

" - } - }, - "documentation":"

Specifies when to create snapshots of EBS volumes.

" - }, - "DeleteLifecyclePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

", - "location":"uri", - "locationName":"policyId" - } - } - }, - "DeleteLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "ExecutionRoleArn":{"type":"string"}, - "GetLifecyclePoliciesRequest":{ - "type":"structure", - "members":{ - "PolicyIds":{ - "shape":"PolicyIdList", - "documentation":"

The identifiers of the data lifecycle policies.

", - "location":"querystring", - "locationName":"policyIds" - }, - "State":{ - "shape":"GettablePolicyStateValues", - "documentation":"

The activation state.

", - "location":"querystring", - "locationName":"state" - }, - "ResourceTypes":{ - "shape":"ResourceTypeValuesList", - "documentation":"

The resource type.

", - "location":"querystring", - "locationName":"resourceTypes" - }, - "TargetTags":{ - "shape":"TargetTagsFilterList", - "documentation":"

The target tags.

Tags are strings in the format key:value.

", - "location":"querystring", - "locationName":"targetTags" - }, - "TagsToAdd":{ - "shape":"TagsToAddFilterList", - "documentation":"

The tags to add to the resources.

Tags are strings in the format key:value.

These tags are added in addition to the AWS-added lifecycle tags.

", - "location":"querystring", - "locationName":"tagsToAdd" - } - } - }, - "GetLifecyclePoliciesResponse":{ - "type":"structure", - "members":{ - "Policies":{ - "shape":"LifecyclePolicySummaryList", - "documentation":"

Summary information about the lifecycle policies.

" - } - } - }, - "GetLifecyclePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

", - "location":"uri", - "locationName":"policyId" - } - } - }, - "GetLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"LifecyclePolicy", - "documentation":"

Detailed information about the lifecycle policy.

" - } - } - }, - "GettablePolicyStateValues":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED", - "ERROR" - ] - }, - "InternalServerException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "Code":{"shape":"ErrorCode"} - }, - "documentation":"

The service failed in an unexpected way.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "Interval":{ - "type":"integer", - "min":1 - }, - "IntervalUnitValues":{ - "type":"string", - "enum":["HOURS"] - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "Code":{"shape":"ErrorCode"}, - "RequiredParameters":{ - "shape":"ParameterList", - "documentation":"

The request omitted one or more required parameters.

" - }, - "MutuallyExclusiveParameters":{ - "shape":"ParameterList", - "documentation":"

The request included parameters that cannot be provided together.

" - } - }, - "documentation":"

Bad request. The request is missing required parameters or has invalid parameters.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LifecyclePolicy":{ - "type":"structure", - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

The description of the lifecycle policy.

" - }, - "State":{ - "shape":"GettablePolicyStateValues", - "documentation":"

The activation state of the lifecycle policy.

" - }, - "ExecutionRoleArn":{ - "shape":"ExecutionRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.

" - }, - "DateCreated":{ - "shape":"Timestamp", - "documentation":"

The local date and time when the lifecycle policy was created.

" - }, - "DateModified":{ - "shape":"Timestamp", - "documentation":"

The local date and time when the lifecycle policy was last modified.

" - }, - "PolicyDetails":{ - "shape":"PolicyDetails", - "documentation":"

The configuration of the lifecycle policy

" - } - }, - "documentation":"

Detailed information about a lifecycle policy.

" - }, - "LifecyclePolicySummary":{ - "type":"structure", - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

The description of the lifecycle policy.

" - }, - "State":{ - "shape":"GettablePolicyStateValues", - "documentation":"

The activation state of the lifecycle policy.

" - } - }, - "documentation":"

Summary information about a lifecycle policy.

" - }, - "LifecyclePolicySummaryList":{ - "type":"list", - "member":{"shape":"LifecyclePolicySummary"} - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "Code":{"shape":"ErrorCode"}, - "ResourceType":{ - "shape":"String", - "documentation":"

Value is the type of resource for which a limit was exceeded.

" - } - }, - "documentation":"

The request failed because a limit was exceeded.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "Parameter":{"type":"string"}, - "ParameterList":{ - "type":"list", - "member":{"shape":"Parameter"} - }, - "PolicyDescription":{ - "type":"string", - "max":500, - "min":0 - }, - "PolicyDetails":{ - "type":"structure", - "members":{ - "ResourceTypes":{ - "shape":"ResourceTypeValuesList", - "documentation":"

The resource type.

" - }, - "TargetTags":{ - "shape":"TargetTagList", - "documentation":"

The target tags.

" - }, - "Schedules":{ - "shape":"ScheduleList", - "documentation":"

The schedule.

" - } - }, - "documentation":"

Specifies the configuration of a lifecycle policy.

" - }, - "PolicyId":{"type":"string"}, - "PolicyIdList":{ - "type":"list", - "member":{"shape":"PolicyId"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "Code":{"shape":"ErrorCode"}, - "ResourceType":{ - "shape":"String", - "documentation":"

Value is the type of resource that was not found.

" - }, - "ResourceIds":{ - "shape":"PolicyIdList", - "documentation":"

Value is a list of resource IDs that were not found.

" - } - }, - "documentation":"

A requested resource was not found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ResourceTypeValues":{ - "type":"string", - "enum":["VOLUME"] - }, - "ResourceTypeValuesList":{ - "type":"list", - "member":{"shape":"ResourceTypeValues"}, - "max":1, - "min":1 - }, - "RetainRule":{ - "type":"structure", - "required":["Count"], - "members":{ - "Count":{ - "shape":"Count", - "documentation":"

The number of snapshots to keep for each volume, up to a maximum of 1000.

" - } - }, - "documentation":"

Specifies the number of snapshots to keep for each EBS volume.

" - }, - "Schedule":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ScheduleName", - "documentation":"

The name of the schedule.

" - }, - "TagsToAdd":{ - "shape":"TagsToAddList", - "documentation":"

The tags to add to policy-created resources. These tags are added in addition to the default lifecycle tags.

" - }, - "CreateRule":{ - "shape":"CreateRule", - "documentation":"

The create rule.

" - }, - "RetainRule":{ - "shape":"RetainRule", - "documentation":"

The retain rule.

" - } - }, - "documentation":"

Specifies a schedule.

" - }, - "ScheduleList":{ - "type":"list", - "member":{"shape":"Schedule"}, - "max":1, - "min":1 - }, - "ScheduleName":{ - "type":"string", - "max":500, - "min":0 - }, - "SettablePolicyStateValues":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "String":{"type":"string"}, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

" - } - }, - "documentation":"

Specifies a tag for a resource.

" - }, - "TagFilter":{"type":"string"}, - "TagsToAddFilterList":{ - "type":"list", - "member":{"shape":"TagFilter"}, - "max":50, - "min":0 - }, - "TagsToAddList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":0 - }, - "TargetTagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TargetTagsFilterList":{ - "type":"list", - "member":{"shape":"TagFilter"}, - "max":50, - "min":1 - }, - "Time":{ - "type":"string", - "pattern":"^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$" - }, - "TimesList":{ - "type":"list", - "member":{"shape":"Time"}, - "max":1 - }, - "Timestamp":{"type":"timestamp"}, - "UpdateLifecyclePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The identifier of the lifecycle policy.

", - "location":"uri", - "locationName":"policyId" - }, - "ExecutionRoleArn":{ - "shape":"ExecutionRoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role used to run the operations specified by the lifecycle policy.

" - }, - "State":{ - "shape":"SettablePolicyStateValues", - "documentation":"

The desired activation state of the lifecycle policy after creation.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

A description of the lifecycle policy.

" - }, - "PolicyDetails":{ - "shape":"PolicyDetails", - "documentation":"

The configuration of the lifecycle policy.

Target tags cannot be re-used across policies.

" - } - } - }, - "UpdateLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - } - } - }, - "documentation":"Amazon Data Lifecycle Manager

With Amazon Data Lifecycle Manager, you can manage the lifecycle of your AWS resources. You create lifecycle policies, which are used to automate operations on the specified resources.

Amazon DLM supports Amazon EBS volumes and snapshots. For information about using Amazon DLM with Amazon EBS, see Automating the Amazon EBS Snapshot Lifecycle in the Amazon EC2 User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/paginators-1.json deleted file mode 100644 index be68c9ea..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/paginators-1.json +++ /dev/null @@ -1,82 +0,0 @@ -{ - "pagination": { - "DescribeSchemas": { - "result_key": "Schemas", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeCertificates": { - "result_key": "Certificates", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeEndpoints": { - "result_key": "Endpoints", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeEventSubscriptions": { - "result_key": "EventSubscriptionsList", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeEndpointTypes": { - "result_key": "SupportedEndpointTypes", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeReplicationInstances": { - "result_key": "ReplicationInstances", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeTableStatistics": { - "result_key": "TableStatistics", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeConnections": { - "result_key": "Connections", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeReplicationTaskAssessmentResults": { - "result_key": "ReplicationTaskAssessmentResults", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeEvents": { - "result_key": "Events", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeOrderableReplicationInstances": { - "result_key": "OrderableReplicationInstances", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeReplicationSubnetGroups": { - "result_key": "ReplicationSubnetGroups", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - }, - "DescribeReplicationTasks": { - "result_key": "ReplicationTasks", - "output_token": "Marker", - "input_token": "Marker", - "limit_key": "MaxRecords" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/service-2.json deleted file mode 100644 index f64e545c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dms/2016-01-01/service-2.json +++ /dev/null @@ -1,3487 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-01-01", - "endpointPrefix":"dms", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Database Migration Service", - "serviceId":"Database Migration Service", - "signatureVersion":"v4", - "targetPrefix":"AmazonDMSv20160101", - "uid":"dms-2016-01-01" - }, - "operations":{ - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceMessage"}, - "output":{"shape":"AddTagsToResourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Adds metadata tags to an AWS DMS resource, including replication instance, endpoint, security group, and migration task. These tags can also be used with cost allocation reporting to track cost associated with DMS resources, or used in a Condition statement in an IAM policy for DMS.

" - }, - "CreateEndpoint":{ - "name":"CreateEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEndpointMessage"}, - "output":{"shape":"CreateEndpointResponse"}, - "errors":[ - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"AccessDeniedFault"} - ], - "documentation":"

Creates an endpoint using the provided settings.

" - }, - "CreateEventSubscription":{ - "name":"CreateEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEventSubscriptionMessage"}, - "output":{"shape":"CreateEventSubscriptionResponse"}, - "errors":[ - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Creates an AWS DMS event notification subscription.

You can specify the type of source (SourceType) you want to be notified of, provide a list of AWS DMS source IDs (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. If you specify both the SourceType and SourceIds, such as SourceType = replication-instance and SourceIdentifier = my-replinstance, you will be notified of all the replication instance events for the specified source. If you specify a SourceType but don't specify a SourceIdentifier, you receive notice of the events for that source type for all your AWS DMS sources. If you don't specify either SourceType nor SourceIdentifier, you will be notified of events generated from all AWS DMS sources belonging to your customer account.

For more information about AWS DMS events, see Working with Events and Notifications in the AWS Database MIgration Service User Guide.

" - }, - "CreateReplicationInstance":{ - "name":"CreateReplicationInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReplicationInstanceMessage"}, - "output":{"shape":"CreateReplicationInstanceResponse"}, - "errors":[ - {"shape":"AccessDeniedFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"InsufficientResourceCapacityFault"}, - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"ReplicationSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidResourceStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Creates the replication instance using the specified parameters.

" - }, - "CreateReplicationSubnetGroup":{ - "name":"CreateReplicationSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReplicationSubnetGroupMessage"}, - "output":{"shape":"CreateReplicationSubnetGroupResponse"}, - "errors":[ - {"shape":"AccessDeniedFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"ReplicationSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Creates a replication subnet group given a list of the subnet IDs in a VPC.

" - }, - "CreateReplicationTask":{ - "name":"CreateReplicationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReplicationTaskMessage"}, - "output":{"shape":"CreateReplicationTaskResponse"}, - "errors":[ - {"shape":"AccessDeniedFault"}, - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"ResourceQuotaExceededFault"} - ], - "documentation":"

Creates a replication task using the specified parameters.

" - }, - "DeleteCertificate":{ - "name":"DeleteCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCertificateMessage"}, - "output":{"shape":"DeleteCertificateResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Deletes the specified certificate.

" - }, - "DeleteEndpoint":{ - "name":"DeleteEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEndpointMessage"}, - "output":{"shape":"DeleteEndpointResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Deletes the specified endpoint.

All tasks associated with the endpoint must be deleted before you can delete the endpoint.

" - }, - "DeleteEventSubscription":{ - "name":"DeleteEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEventSubscriptionMessage"}, - "output":{"shape":"DeleteEventSubscriptionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Deletes an AWS DMS event subscription.

" - }, - "DeleteReplicationInstance":{ - "name":"DeleteReplicationInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReplicationInstanceMessage"}, - "output":{"shape":"DeleteReplicationInstanceResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Deletes the specified replication instance.

You must delete any migration tasks that are associated with the replication instance before you can delete it.

" - }, - "DeleteReplicationSubnetGroup":{ - "name":"DeleteReplicationSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReplicationSubnetGroupMessage"}, - "output":{"shape":"DeleteReplicationSubnetGroupResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Deletes a subnet group.

" - }, - "DeleteReplicationTask":{ - "name":"DeleteReplicationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReplicationTaskMessage"}, - "output":{"shape":"DeleteReplicationTaskResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Deletes the specified replication task.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesMessage"}, - "output":{"shape":"DescribeAccountAttributesResponse"}, - "documentation":"

Lists all of the AWS DMS attributes for a customer account. The attributes include AWS DMS quotas for the account, such as the number of replication instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

This command does not take any parameters.

" - }, - "DescribeCertificates":{ - "name":"DescribeCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCertificatesMessage"}, - "output":{"shape":"DescribeCertificatesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Provides a description of the certificate.

" - }, - "DescribeConnections":{ - "name":"DescribeConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConnectionsMessage"}, - "output":{"shape":"DescribeConnectionsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Describes the status of the connections that have been made between the replication instance and an endpoint. Connections are created when you test an endpoint.

" - }, - "DescribeEndpointTypes":{ - "name":"DescribeEndpointTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEndpointTypesMessage"}, - "output":{"shape":"DescribeEndpointTypesResponse"}, - "documentation":"

Returns information about the type of endpoints available.

" - }, - "DescribeEndpoints":{ - "name":"DescribeEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEndpointsMessage"}, - "output":{"shape":"DescribeEndpointsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns information about the endpoints for your account in the current region.

" - }, - "DescribeEventCategories":{ - "name":"DescribeEventCategories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventCategoriesMessage"}, - "output":{"shape":"DescribeEventCategoriesResponse"}, - "documentation":"

Lists categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in Working with Events and Notifications in the AWS Database Migration Service User Guide.

" - }, - "DescribeEventSubscriptions":{ - "name":"DescribeEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventSubscriptionsMessage"}, - "output":{"shape":"DescribeEventSubscriptionsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Lists all the event subscriptions for a customer account. The description of a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

If you specify SubscriptionName, this action lists the description for that subscription.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{"shape":"DescribeEventsResponse"}, - "documentation":"

Lists events for a given source identifier and source type. You can also specify a start and end time. For more information on AWS DMS events, see Working with Events and Notifications .

" - }, - "DescribeOrderableReplicationInstances":{ - "name":"DescribeOrderableReplicationInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrderableReplicationInstancesMessage"}, - "output":{"shape":"DescribeOrderableReplicationInstancesResponse"}, - "documentation":"

Returns information about the replication instance types that can be created in the specified region.

" - }, - "DescribeRefreshSchemasStatus":{ - "name":"DescribeRefreshSchemasStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRefreshSchemasStatusMessage"}, - "output":{"shape":"DescribeRefreshSchemasStatusResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns the status of the RefreshSchemas operation.

" - }, - "DescribeReplicationInstanceTaskLogs":{ - "name":"DescribeReplicationInstanceTaskLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationInstanceTaskLogsMessage"}, - "output":{"shape":"DescribeReplicationInstanceTaskLogsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Returns information about the task logs for the specified task.

" - }, - "DescribeReplicationInstances":{ - "name":"DescribeReplicationInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationInstancesMessage"}, - "output":{"shape":"DescribeReplicationInstancesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns information about replication instances for your account in the current region.

" - }, - "DescribeReplicationSubnetGroups":{ - "name":"DescribeReplicationSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationSubnetGroupsMessage"}, - "output":{"shape":"DescribeReplicationSubnetGroupsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns information about the replication subnet groups.

" - }, - "DescribeReplicationTaskAssessmentResults":{ - "name":"DescribeReplicationTaskAssessmentResults", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationTaskAssessmentResultsMessage"}, - "output":{"shape":"DescribeReplicationTaskAssessmentResultsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns the task assessment results from Amazon S3. This action always returns the latest results.

" - }, - "DescribeReplicationTasks":{ - "name":"DescribeReplicationTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationTasksMessage"}, - "output":{"shape":"DescribeReplicationTasksResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns information about replication tasks for your account in the current region.

" - }, - "DescribeSchemas":{ - "name":"DescribeSchemas", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSchemasMessage"}, - "output":{"shape":"DescribeSchemasResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns information about the schema for the specified endpoint.

" - }, - "DescribeTableStatistics":{ - "name":"DescribeTableStatistics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTableStatisticsMessage"}, - "output":{"shape":"DescribeTableStatisticsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Returns table statistics on the database migration task, including table name, rows inserted, rows updated, and rows deleted.

Note that the \"last updated\" column the DMS console only indicates the time that AWS DMS last updated the table statistics record for a table. It does not indicate the time of the last update to the table.

" - }, - "ImportCertificate":{ - "name":"ImportCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportCertificateMessage"}, - "output":{"shape":"ImportCertificateResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"InvalidCertificateFault"}, - {"shape":"ResourceQuotaExceededFault"} - ], - "documentation":"

Uploads the specified certificate.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceMessage"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Lists all tags for an AWS DMS resource.

" - }, - "ModifyEndpoint":{ - "name":"ModifyEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyEndpointMessage"}, - "output":{"shape":"ModifyEndpointResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"AccessDeniedFault"} - ], - "documentation":"

Modifies the specified endpoint.

" - }, - "ModifyEventSubscription":{ - "name":"ModifyEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyEventSubscriptionMessage"}, - "output":{"shape":"ModifyEventSubscriptionResponse"}, - "errors":[ - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"} - ], - "documentation":"

Modifies an existing AWS DMS event notification subscription.

" - }, - "ModifyReplicationInstance":{ - "name":"ModifyReplicationInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReplicationInstanceMessage"}, - "output":{"shape":"ModifyReplicationInstanceResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"InsufficientResourceCapacityFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"UpgradeDependencyFailureFault"} - ], - "documentation":"

Modifies the replication instance to apply new settings. You can change one or more parameters by specifying these parameters and the new values in the request.

Some settings are applied during the maintenance window.

" - }, - "ModifyReplicationSubnetGroup":{ - "name":"ModifyReplicationSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReplicationSubnetGroupMessage"}, - "output":{"shape":"ModifyReplicationSubnetGroupResponse"}, - "errors":[ - {"shape":"AccessDeniedFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"ResourceQuotaExceededFault"}, - {"shape":"SubnetAlreadyInUse"}, - {"shape":"ReplicationSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Modifies the settings for the specified replication subnet group.

" - }, - "ModifyReplicationTask":{ - "name":"ModifyReplicationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReplicationTaskMessage"}, - "output":{"shape":"ModifyReplicationTaskResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"ResourceAlreadyExistsFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Modifies the specified replication task.

You can't modify the task endpoints. The task must be stopped before you can modify it.

For more information about AWS DMS tasks, see the AWS DMS user guide at Working with Migration Tasks

" - }, - "RebootReplicationInstance":{ - "name":"RebootReplicationInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootReplicationInstanceMessage"}, - "output":{"shape":"RebootReplicationInstanceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Reboots a replication instance. Rebooting results in a momentary outage, until the replication instance becomes available again.

" - }, - "RefreshSchemas":{ - "name":"RefreshSchemas", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RefreshSchemasMessage"}, - "output":{"shape":"RefreshSchemasResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"ResourceQuotaExceededFault"} - ], - "documentation":"

Populates the schema for the specified endpoint. This is an asynchronous operation and can take several minutes. You can check the status of this operation by calling the DescribeRefreshSchemasStatus operation.

" - }, - "ReloadTables":{ - "name":"ReloadTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReloadTablesMessage"}, - "output":{"shape":"ReloadTablesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Reloads the target database table with the source data.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceMessage"}, - "output":{"shape":"RemoveTagsFromResourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Removes metadata tags from a DMS resource.

" - }, - "StartReplicationTask":{ - "name":"StartReplicationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartReplicationTaskMessage"}, - "output":{"shape":"StartReplicationTaskResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"}, - {"shape":"AccessDeniedFault"} - ], - "documentation":"

Starts the replication task.

For more information about AWS DMS tasks, see the AWS DMS user guide at Working with Migration Tasks

" - }, - "StartReplicationTaskAssessment":{ - "name":"StartReplicationTaskAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartReplicationTaskAssessmentMessage"}, - "output":{"shape":"StartReplicationTaskAssessmentResponse"}, - "errors":[ - {"shape":"InvalidResourceStateFault"}, - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Starts the replication task assessment for unsupported data types in the source database.

" - }, - "StopReplicationTask":{ - "name":"StopReplicationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopReplicationTaskMessage"}, - "output":{"shape":"StopReplicationTaskResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"} - ], - "documentation":"

Stops the replication task.

" - }, - "TestConnection":{ - "name":"TestConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestConnectionMessage"}, - "output":{"shape":"TestConnectionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidResourceStateFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"ResourceQuotaExceededFault"} - ], - "documentation":"

Tests the connection between the replication instance and the endpoint.

" - } - }, - "shapes":{ - "AccessDeniedFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

AWS DMS was denied access to the endpoint.

", - "exception":true - }, - "AccountQuota":{ - "type":"structure", - "members":{ - "AccountQuotaName":{ - "shape":"String", - "documentation":"

The name of the AWS DMS quota for this AWS account.

" - }, - "Used":{ - "shape":"Long", - "documentation":"

The amount currently used toward the quota maximum.

" - }, - "Max":{ - "shape":"Long", - "documentation":"

The maximum allowed value for the quota.

" - } - }, - "documentation":"

Describes a quota for an AWS account, for example, the number of replication instances allowed.

" - }, - "AccountQuotaList":{ - "type":"list", - "member":{"shape":"AccountQuota"} - }, - "AddTagsToResourceMessage":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS DMS resource the tag is to be added to. AWS DMS resources include a replication instance, endpoint, and a replication task.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tag to be assigned to the DMS resource.

" - } - }, - "documentation":"

" - }, - "AddTagsToResourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "AuthMechanismValue":{ - "type":"string", - "enum":[ - "default", - "mongodb_cr", - "scram_sha_1" - ] - }, - "AuthTypeValue":{ - "type":"string", - "enum":[ - "no", - "password" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the availability zone.

" - } - }, - "documentation":"

" - }, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "Certificate":{ - "type":"structure", - "members":{ - "CertificateIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the certificate. Valid characters are A-z and 0-9.

" - }, - "CertificateCreationDate":{ - "shape":"TStamp", - "documentation":"

The date that the certificate was created.

" - }, - "CertificatePem":{ - "shape":"String", - "documentation":"

The contents of the .pem X.509 certificate file for the certificate.

" - }, - "CertificateWallet":{ - "shape":"CertificateWallet", - "documentation":"

The location of the imported Oracle Wallet certificate for use with SSL.

" - }, - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the certificate.

" - }, - "CertificateOwner":{ - "shape":"String", - "documentation":"

The owner of the certificate.

" - }, - "ValidFromDate":{ - "shape":"TStamp", - "documentation":"

The beginning date that the certificate is valid.

" - }, - "ValidToDate":{ - "shape":"TStamp", - "documentation":"

The final date that the certificate is valid.

" - }, - "SigningAlgorithm":{ - "shape":"String", - "documentation":"

The signing algorithm for the certificate.

" - }, - "KeyLength":{ - "shape":"IntegerOptional", - "documentation":"

The key length of the cryptographic algorithm being used.

" - } - }, - "documentation":"

The SSL certificate that can be used to encrypt connections between the endpoints and the replication instance.

" - }, - "CertificateList":{ - "type":"list", - "member":{"shape":"Certificate"} - }, - "CertificateWallet":{"type":"blob"}, - "CompressionTypeValue":{ - "type":"string", - "enum":[ - "none", - "gzip" - ] - }, - "Connection":{ - "type":"structure", - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The connection status.

" - }, - "LastFailureMessage":{ - "shape":"String", - "documentation":"

The error message when the connection last failed.

" - }, - "EndpointIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the endpoint. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

" - }, - "ReplicationInstanceIdentifier":{ - "shape":"String", - "documentation":"

The replication instance identifier. This parameter is stored as a lowercase string.

" - } - }, - "documentation":"

" - }, - "ConnectionList":{ - "type":"list", - "member":{"shape":"Connection"} - }, - "CreateEndpointMessage":{ - "type":"structure", - "required":[ - "EndpointIdentifier", - "EndpointType", - "EngineName" - ], - "members":{ - "EndpointIdentifier":{ - "shape":"String", - "documentation":"

The database endpoint identifier. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

" - }, - "EndpointType":{ - "shape":"ReplicationEndpointTypeValue", - "documentation":"

The type of endpoint.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

The type of engine for the endpoint. Valid values, depending on the EndPointType, include mysql, oracle, postgres, mariadb, aurora, aurora-postgresql, redshift, s3, db2, azuredb, sybase, dynamodb, mongodb, and sqlserver.

" - }, - "Username":{ - "shape":"String", - "documentation":"

The user name to be used to login to the endpoint database.

" - }, - "Password":{ - "shape":"SecretString", - "documentation":"

The password to be used to login to the endpoint database.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server where the endpoint database resides.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port used by the endpoint database.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The name of the endpoint database.

" - }, - "ExtraConnectionAttributes":{ - "shape":"String", - "documentation":"

Additional attributes associated with the connection.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The KMS key identifier that will be used to encrypt the connection parameters. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Tags to be added to the endpoint.

" - }, - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the certificate.

" - }, - "SslMode":{ - "shape":"DmsSslModeValue", - "documentation":"

The SSL mode to use for the SSL connection.

SSL mode can be one of four values: none, require, verify-ca, verify-full.

The default value is none.

" - }, - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the service access role you want to use to create the endpoint.

" - }, - "ExternalTableDefinition":{ - "shape":"String", - "documentation":"

The external table definition.

" - }, - "DynamoDbSettings":{ - "shape":"DynamoDbSettings", - "documentation":"

Settings in JSON format for the target Amazon DynamoDB endpoint. For more information about the available settings, see the Using Object Mapping to Migrate Data to DynamoDB section at Using an Amazon DynamoDB Database as a Target for AWS Database Migration Service.

" - }, - "S3Settings":{ - "shape":"S3Settings", - "documentation":"

Settings in JSON format for the target Amazon S3 endpoint. For more information about the available settings, see the Extra Connection Attributes section at Using Amazon S3 as a Target for AWS Database Migration Service.

" - }, - "DmsTransferSettings":{ - "shape":"DmsTransferSettings", - "documentation":"

The settings in JSON format for the DMS Transfer type source endpoint.

Attributes include:

  • serviceAccessRoleArn - The IAM role that has permission to access the Amazon S3 bucket.

  • bucketName - The name of the S3 bucket to use.

  • compressionType - An optional parameter to use GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed.

Shorthand syntax: ServiceAccessRoleArn=string ,BucketName=string,CompressionType=string

JSON syntax:

{ \"ServiceAccessRoleArn\": \"string\", \"BucketName\": \"string\", \"CompressionType\": \"none\"|\"gzip\" }

" - }, - "MongoDbSettings":{ - "shape":"MongoDbSettings", - "documentation":"

Settings in JSON format for the source MongoDB endpoint. For more information about the available settings, see the Configuration Properties When Using MongoDB as a Source for AWS Database Migration Service section at Using MongoDB as a Target for AWS Database Migration Service.

" - } - }, - "documentation":"

" - }, - "CreateEndpointResponse":{ - "type":"structure", - "members":{ - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The endpoint that was created.

" - } - }, - "documentation":"

" - }, - "CreateEventSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SnsTopicArn" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the AWS DMS event notification subscription.

Constraints: The name must be less than 255 characters.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value is not specified, all events are returned.

Valid values: replication-instance | migration-task

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a source type that you want to subscribe to. You can see a list of the categories for a given source type by calling the DescribeEventCategories action or in the topic Working with Events and Notifications in the AWS Database Migration Service User Guide.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

The list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription, or set to false to create the subscription but not activate it.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A tag to be attached to the event subscription.

" - } - }, - "documentation":"

" - }, - "CreateEventSubscriptionResponse":{ - "type":"structure", - "members":{ - "EventSubscription":{ - "shape":"EventSubscription", - "documentation":"

The event subscription that was created.

" - } - }, - "documentation":"

" - }, - "CreateReplicationInstanceMessage":{ - "type":"structure", - "required":[ - "ReplicationInstanceIdentifier", - "ReplicationInstanceClass" - ], - "members":{ - "ReplicationInstanceIdentifier":{ - "shape":"String", - "documentation":"

The replication instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: myrepinstance

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gigabytes) to be initially allocated for the replication instance.

" - }, - "ReplicationInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the replication instance as specified by the replication instance class.

Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

Specifies the VPC security group to be used with the replication instance. The VPC security group must work with the VPC containing the replication instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the replication instance will be created in.

Default: A random, system-chosen Availability Zone in the endpoint's region.

Example: us-east-1d

" - }, - "ReplicationSubnetGroupIdentifier":{ - "shape":"String", - "documentation":"

A subnet group to associate with the replication instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

Default: A 30-minute window selected at random from an 8-hour block of time per region, occurring on a random day of the week.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version number of the replication instance.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades will be applied automatically to the replication instance during the maintenance window.

Default: true

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Tags to be associated with the replication instance.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The KMS key identifier that will be used to encrypt the content on the replication instance. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the replication instance. A value of true represents an instance with a public IP address. A value of false represents an instance with a private IP address. The default value is true.

" - } - }, - "documentation":"

" - }, - "CreateReplicationInstanceResponse":{ - "type":"structure", - "members":{ - "ReplicationInstance":{ - "shape":"ReplicationInstance", - "documentation":"

The replication instance that was created.

" - } - }, - "documentation":"

" - }, - "CreateReplicationSubnetGroupMessage":{ - "type":"structure", - "required":[ - "ReplicationSubnetGroupIdentifier", - "ReplicationSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "ReplicationSubnetGroupIdentifier":{ - "shape":"String", - "documentation":"

The name for the replication subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters, periods, spaces, underscores, or hyphens. Must not be \"default\".

Example: mySubnetgroup

" - }, - "ReplicationSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the subnet group.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tag to be assigned to the subnet group.

" - } - }, - "documentation":"

" - }, - "CreateReplicationSubnetGroupResponse":{ - "type":"structure", - "members":{ - "ReplicationSubnetGroup":{ - "shape":"ReplicationSubnetGroup", - "documentation":"

The replication subnet group that was created.

" - } - }, - "documentation":"

" - }, - "CreateReplicationTaskMessage":{ - "type":"structure", - "required":[ - "ReplicationTaskIdentifier", - "SourceEndpointArn", - "TargetEndpointArn", - "ReplicationInstanceArn", - "MigrationType", - "TableMappings" - ], - "members":{ - "ReplicationTaskIdentifier":{ - "shape":"String", - "documentation":"

The replication task identifier.

Constraints:

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SourceEndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "TargetEndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "MigrationType":{ - "shape":"MigrationTypeValue", - "documentation":"

The migration type.

" - }, - "TableMappings":{ - "shape":"String", - "documentation":"

When using the AWS CLI or boto3, provide the path of the JSON file that contains the table mappings. Precede the path with \"file://\". When working with the DMS API, provide the JSON as the parameter value.

For example, --table-mappings file://mappingfile.json

" - }, - "ReplicationTaskSettings":{ - "shape":"String", - "documentation":"

Settings for the task, such as target metadata settings. For a complete list of task settings, see Task Settings for AWS Database Migration Service Tasks.

" - }, - "CdcStartTime":{ - "shape":"TStamp", - "documentation":"

Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.

Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”

" - }, - "CdcStartPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.

The value can be in date, checkpoint, or LSN/SCN format.

Date Example: --cdc-start-position “2018-03-08T12:12:12”

Checkpoint Example: --cdc-start-position \"checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93\"

LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”

" - }, - "CdcStopPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.

Server time example: --cdc-stop-position “server_time:3018-02-09T12:12:12”

Commit time example: --cdc-stop-position “commit_time: 3018-02-09T12:12:12 “

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Tags to be added to the replication instance.

" - } - }, - "documentation":"

" - }, - "CreateReplicationTaskResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The replication task that was created.

" - } - }, - "documentation":"

" - }, - "DeleteCertificateMessage":{ - "type":"structure", - "required":["CertificateArn"], - "members":{ - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the deleted certificate.

" - } - } - }, - "DeleteCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"Certificate", - "documentation":"

The Secure Sockets Layer (SSL) certificate.

" - } - } - }, - "DeleteEndpointMessage":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - } - }, - "documentation":"

" - }, - "DeleteEndpointResponse":{ - "type":"structure", - "members":{ - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The endpoint that was deleted.

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the DMS event notification subscription to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionResponse":{ - "type":"structure", - "members":{ - "EventSubscription":{ - "shape":"EventSubscription", - "documentation":"

The event subscription that was deleted.

" - } - }, - "documentation":"

" - }, - "DeleteReplicationInstanceMessage":{ - "type":"structure", - "required":["ReplicationInstanceArn"], - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteReplicationInstanceResponse":{ - "type":"structure", - "members":{ - "ReplicationInstance":{ - "shape":"ReplicationInstance", - "documentation":"

The replication instance that was deleted.

" - } - }, - "documentation":"

" - }, - "DeleteReplicationSubnetGroupMessage":{ - "type":"structure", - "required":["ReplicationSubnetGroupIdentifier"], - "members":{ - "ReplicationSubnetGroupIdentifier":{ - "shape":"String", - "documentation":"

The subnet group name of the replication instance.

" - } - }, - "documentation":"

" - }, - "DeleteReplicationSubnetGroupResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "DeleteReplicationTaskMessage":{ - "type":"structure", - "required":["ReplicationTaskArn"], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteReplicationTaskResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The deleted replication task.

" - } - }, - "documentation":"

" - }, - "DescribeAccountAttributesMessage":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "DescribeAccountAttributesResponse":{ - "type":"structure", - "members":{ - "AccountQuotas":{ - "shape":"AccountQuotaList", - "documentation":"

Account quota information.

" - } - }, - "documentation":"

" - }, - "DescribeCertificatesMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the certificate described in the form of key-value pairs.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 10

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeCertificatesResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

The pagination token.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

The Secure Sockets Layer (SSL) certificates associated with the replication instance.

" - } - } - }, - "DescribeConnectionsMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters applied to the connection.

Valid filter names: endpoint-arn | replication-instance-arn

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeConnectionsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Connections":{ - "shape":"ConnectionList", - "documentation":"

A description of the connections.

" - } - }, - "documentation":"

" - }, - "DescribeEndpointTypesMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe action.

Valid filter names: engine-name | endpoint-type

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEndpointTypesResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "SupportedEndpointTypes":{ - "shape":"SupportedEndpointTypeList", - "documentation":"

The type of endpoints that are supported.

" - } - }, - "documentation":"

" - }, - "DescribeEndpointsMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe action.

Valid filter names: endpoint-arn | endpoint-type | endpoint-id | engine-name

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEndpointsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Endpoints":{ - "shape":"EndpointList", - "documentation":"

Endpoint description.

" - } - }, - "documentation":"

" - }, - "DescribeEventCategoriesMessage":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The type of AWS DMS resource that generates events.

Valid values: replication-instance | migration-task

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the action.

" - } - }, - "documentation":"

" - }, - "DescribeEventCategoriesResponse":{ - "type":"structure", - "members":{ - "EventCategoryGroupList":{ - "shape":"EventCategoryGroupList", - "documentation":"

A list of event categories.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the AWS DMS event subscription to be described.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the action.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "EventSubscriptionsList":{ - "shape":"EventSubscriptionsList", - "documentation":"

A list of event subscriptions.

" - } - }, - "documentation":"

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens. It cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The type of AWS DMS resource that generates events.

Valid values: replication-instance | migration-task

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The start time for the events to be listed.

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end time for the events to be listed.

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The duration of the events to be listed.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a source type that you want to subscribe to.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the action.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEventsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

The events described.

" - } - }, - "documentation":"

" - }, - "DescribeOrderableReplicationInstancesMessage":{ - "type":"structure", - "members":{ - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOrderableReplicationInstancesResponse":{ - "type":"structure", - "members":{ - "OrderableReplicationInstances":{ - "shape":"OrderableReplicationInstanceList", - "documentation":"

The order-able replication instances available.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeRefreshSchemasStatusMessage":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - } - }, - "documentation":"

" - }, - "DescribeRefreshSchemasStatusResponse":{ - "type":"structure", - "members":{ - "RefreshSchemasStatus":{ - "shape":"RefreshSchemasStatus", - "documentation":"

The status of the schema.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationInstanceTaskLogsMessage":{ - "type":"structure", - "required":["ReplicationInstanceArn"], - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeReplicationInstanceTaskLogsResponse":{ - "type":"structure", - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "ReplicationInstanceTaskLogs":{ - "shape":"ReplicationInstanceTaskLogsList", - "documentation":"

An array of replication task log metadata. Each member of the array contains the replication task name, ARN, and task log size (in bytes).

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeReplicationInstancesMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe action.

Valid filter names: replication-instance-arn | replication-instance-id | replication-instance-class | engine-version

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationInstancesResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReplicationInstances":{ - "shape":"ReplicationInstanceList", - "documentation":"

The replication instances described.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe action.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationSubnetGroupsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReplicationSubnetGroups":{ - "shape":"ReplicationSubnetGroups", - "documentation":"

A description of the replication subnet groups.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationTaskAssessmentResultsMessage":{ - "type":"structure", - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

- The Amazon Resource Name (ARN) string that uniquely identifies the task. When this input parameter is specified the API will return only one result and ignore the values of the max-records and marker parameters.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationTaskAssessmentResultsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "BucketName":{ - "shape":"String", - "documentation":"

- The Amazon S3 bucket where the task assessment report is located.

" - }, - "ReplicationTaskAssessmentResults":{ - "shape":"ReplicationTaskAssessmentResultList", - "documentation":"

The task assessment report.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationTasksMessage":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe action.

Valid filter names: replication-task-arn | replication-task-id | migration-type | endpoint-arn | replication-instance-arn

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReplicationTasksResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReplicationTasks":{ - "shape":"ReplicationTaskList", - "documentation":"

A description of the replication tasks.

" - } - }, - "documentation":"

" - }, - "DescribeSchemasMessage":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeSchemasResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Schemas":{ - "shape":"SchemaList", - "documentation":"

The described schema.

" - } - }, - "documentation":"

" - }, - "DescribeTableStatisticsMessage":{ - "type":"structure", - "required":["ReplicationTaskArn"], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 500.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters applied to the describe table statistics action.

Valid filter names: schema-name | table-name | table-state

A combination of filters creates an AND condition where each record matches all specified filters.

" - } - }, - "documentation":"

" - }, - "DescribeTableStatisticsResponse":{ - "type":"structure", - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "TableStatistics":{ - "shape":"TableStatisticsList", - "documentation":"

The table statistics.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DmsSslModeValue":{ - "type":"string", - "enum":[ - "none", - "require", - "verify-ca", - "verify-full" - ] - }, - "DmsTransferSettings":{ - "type":"structure", - "members":{ - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The IAM role that has permission to access the Amazon S3 bucket.

" - }, - "BucketName":{ - "shape":"String", - "documentation":"

The name of the S3 bucket to use.

" - } - }, - "documentation":"

The settings in JSON format for the DMS Transfer type source endpoint.

" - }, - "DynamoDbSettings":{ - "type":"structure", - "required":["ServiceAccessRoleArn"], - "members":{ - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) used by the service access IAM role.

" - } - }, - "documentation":"

" - }, - "Endpoint":{ - "type":"structure", - "members":{ - "EndpointIdentifier":{ - "shape":"String", - "documentation":"

The database endpoint identifier. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

" - }, - "EndpointType":{ - "shape":"ReplicationEndpointTypeValue", - "documentation":"

The type of endpoint.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

The database engine name. Valid values, depending on the EndPointType, include mysql, oracle, postgres, mariadb, aurora, aurora-postgresql, redshift, s3, db2, azuredb, sybase, sybase, dynamodb, mongodb, and sqlserver.

" - }, - "EngineDisplayName":{ - "shape":"String", - "documentation":"

The expanded name for the engine name. For example, if the EngineName parameter is \"aurora,\" this value would be \"Amazon Aurora MySQL.\"

" - }, - "Username":{ - "shape":"String", - "documentation":"

The user name used to connect to the endpoint.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server at the endpoint.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port value used to access the endpoint.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The name of the database at the endpoint.

" - }, - "ExtraConnectionAttributes":{ - "shape":"String", - "documentation":"

Additional connection attributes used to connect to the endpoint.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the endpoint.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The KMS key identifier that will be used to encrypt the connection parameters. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.

" - }, - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) used for SSL connection to the endpoint.

" - }, - "SslMode":{ - "shape":"DmsSslModeValue", - "documentation":"

The SSL mode used to connect to the endpoint.

SSL mode can be one of four values: none, require, verify-ca, verify-full.

The default value is none.

" - }, - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) used by the service access IAM role.

" - }, - "ExternalTableDefinition":{ - "shape":"String", - "documentation":"

The external table definition.

" - }, - "ExternalId":{ - "shape":"String", - "documentation":"

Value returned by a call to CreateEndpoint that can be used for cross-account validation. Use it on a subsequent call to CreateEndpoint to create the endpoint with a cross-account.

" - }, - "DynamoDbSettings":{ - "shape":"DynamoDbSettings", - "documentation":"

The settings for the target DynamoDB database. For more information, see the DynamoDBSettings structure.

" - }, - "S3Settings":{ - "shape":"S3Settings", - "documentation":"

The settings for the S3 target endpoint. For more information, see the S3Settings structure.

" - }, - "DmsTransferSettings":{ - "shape":"DmsTransferSettings", - "documentation":"

The settings in JSON format for the DMS Transfer type source endpoint.

Attributes include:

  • serviceAccessRoleArn - The IAM role that has permission to access the Amazon S3 bucket.

  • bucketName - The name of the S3 bucket to use.

  • compressionType - An optional parameter to use GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed.

Shorthand syntax: ServiceAccessRoleArn=string ,BucketName=string,CompressionType=string

JSON syntax:

{ \"ServiceAccessRoleArn\": \"string\", \"BucketName\": \"string\", \"CompressionType\": \"none\"|\"gzip\" }

" - }, - "MongoDbSettings":{ - "shape":"MongoDbSettings", - "documentation":"

The settings for the MongoDB source endpoint. For more information, see the MongoDbSettings structure.

" - } - }, - "documentation":"

" - }, - "EndpointList":{ - "type":"list", - "member":{"shape":"Endpoint"} - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.

Constraints:replication instance, endpoint, migration task

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The type of AWS DMS resource that generates events.

Valid values: replication-instance | endpoint | migration-task

" - }, - "Message":{ - "shape":"String", - "documentation":"

The event message.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

The event categories available for the specified source type.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

The date of the event.

" - } - }, - "documentation":"

" - }, - "EventCategoriesList":{ - "type":"list", - "member":{"shape":"String"} - }, - "EventCategoryGroup":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The type of AWS DMS resource that generates events.

Valid values: replication-instance | replication-server | security-group | migration-task

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to.

" - } - }, - "documentation":"

" - }, - "EventCategoryGroupList":{ - "type":"list", - "member":{"shape":"EventCategoryGroup"} - }, - "EventList":{ - "type":"list", - "member":{"shape":"Event"} - }, - "EventSubscription":{ - "type":"structure", - "members":{ - "CustomerAwsId":{ - "shape":"String", - "documentation":"

The AWS customer account associated with the AWS DMS event notification subscription.

" - }, - "CustSubscriptionId":{ - "shape":"String", - "documentation":"

The AWS DMS event notification subscription Id.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The topic ARN of the AWS DMS event notification subscription.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the AWS DMS event notification subscription.

Constraints:

Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist

The status \"no-permission\" indicates that AWS DMS no longer has permission to post to the SNS topic. The status \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.

" - }, - "SubscriptionCreationTime":{ - "shape":"String", - "documentation":"

The time the RDS event notification subscription was created.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of AWS DMS resource that generates events.

Valid values: replication-instance | replication-server | security-group | migration-task

" - }, - "SourceIdsList":{ - "shape":"SourceIdsList", - "documentation":"

A list of source Ids for the event subscription.

" - }, - "EventCategoriesList":{ - "shape":"EventCategoriesList", - "documentation":"

A lists of event categories.

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates if the event subscription is enabled.

" - } - }, - "documentation":"

" - }, - "EventSubscriptionsList":{ - "type":"list", - "member":{"shape":"EventSubscription"} - }, - "ExceptionMessage":{"type":"string"}, - "Filter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter.

" - }, - "Values":{ - "shape":"FilterValueList", - "documentation":"

The filter value.

" - } - }, - "documentation":"

" - }, - "FilterList":{ - "type":"list", - "member":{"shape":"Filter"} - }, - "FilterValueList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ImportCertificateMessage":{ - "type":"structure", - "required":["CertificateIdentifier"], - "members":{ - "CertificateIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the certificate. Valid characters are A-z and 0-9.

" - }, - "CertificatePem":{ - "shape":"String", - "documentation":"

The contents of the .pem X.509 certificate file for the certificate.

" - }, - "CertificateWallet":{ - "shape":"CertificateWallet", - "documentation":"

The location of the imported Oracle Wallet certificate for use with SSL.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags associated with the certificate.

" - } - } - }, - "ImportCertificateResponse":{ - "type":"structure", - "members":{ - "Certificate":{ - "shape":"Certificate", - "documentation":"

The certificate to be uploaded.

" - } - } - }, - "InsufficientResourceCapacityFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

There are not enough resources allocated to the database migration.

", - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidCertificateFault":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The certificate was not valid.

", - "exception":true - }, - "InvalidResourceStateFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The resource is in a state that prevents it from being used for database migration.

", - "exception":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The subnet provided is invalid.

", - "exception":true - }, - "KMSKeyNotAccessibleFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

AWS DMS cannot access the KMS key.

", - "exception":true - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the AWS DMS resource.

" - } - }, - "documentation":"

" - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

A list of tags for the resource.

" - } - }, - "documentation":"

" - }, - "Long":{"type":"long"}, - "MigrationTypeValue":{ - "type":"string", - "enum":[ - "full-load", - "cdc", - "full-load-and-cdc" - ] - }, - "ModifyEndpointMessage":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "EndpointIdentifier":{ - "shape":"String", - "documentation":"

The database endpoint identifier. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

" - }, - "EndpointType":{ - "shape":"ReplicationEndpointTypeValue", - "documentation":"

The type of endpoint.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

The type of engine for the endpoint. Valid values, depending on the EndPointType, include mysql, oracle, postgres, mariadb, aurora, aurora-postgresql, redshift, s3, db2, azuredb, sybase, sybase, dynamodb, mongodb, and sqlserver.

" - }, - "Username":{ - "shape":"String", - "documentation":"

The user name to be used to login to the endpoint database.

" - }, - "Password":{ - "shape":"SecretString", - "documentation":"

The password to be used to login to the endpoint database.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server where the endpoint database resides.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port used by the endpoint database.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The name of the endpoint database.

" - }, - "ExtraConnectionAttributes":{ - "shape":"String", - "documentation":"

Additional attributes associated with the connection. To reset this parameter, pass the empty string (\"\") as an argument.

" - }, - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the certificate used for SSL connection.

" - }, - "SslMode":{ - "shape":"DmsSslModeValue", - "documentation":"

The SSL mode to be used.

SSL mode can be one of four values: none, require, verify-ca, verify-full.

The default value is none.

" - }, - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the service access role you want to use to modify the endpoint.

" - }, - "ExternalTableDefinition":{ - "shape":"String", - "documentation":"

The external table definition.

" - }, - "DynamoDbSettings":{ - "shape":"DynamoDbSettings", - "documentation":"

Settings in JSON format for the target Amazon DynamoDB endpoint. For more information about the available settings, see the Using Object Mapping to Migrate Data to DynamoDB section at Using an Amazon DynamoDB Database as a Target for AWS Database Migration Service.

" - }, - "S3Settings":{ - "shape":"S3Settings", - "documentation":"

Settings in JSON format for the target S3 endpoint. For more information about the available settings, see the Extra Connection Attributes section at Using Amazon S3 as a Target for AWS Database Migration Service.

" - }, - "DmsTransferSettings":{ - "shape":"DmsTransferSettings", - "documentation":"

The settings in JSON format for the DMS Transfer type source endpoint.

Attributes include:

  • serviceAccessRoleArn - The IAM role that has permission to access the Amazon S3 bucket.

  • BucketName - The name of the S3 bucket to use.

  • compressionType - An optional parameter to use GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed.

Shorthand syntax: ServiceAccessRoleArn=string ,BucketName=string,CompressionType=string

JSON syntax:

{ \"ServiceAccessRoleArn\": \"string\", \"BucketName\": \"string\", \"CompressionType\": \"none\"|\"gzip\" }

" - }, - "MongoDbSettings":{ - "shape":"MongoDbSettings", - "documentation":"

Settings in JSON format for the source MongoDB endpoint. For more information about the available settings, see the Configuration Properties When Using MongoDB as a Source for AWS Database Migration Service section at Using Amazon S3 as a Target for AWS Database Migration Service.

" - } - }, - "documentation":"

" - }, - "ModifyEndpointResponse":{ - "type":"structure", - "members":{ - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The modified endpoint.

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the AWS DMS event notification subscription to be modified.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of AWS DMS resource that generates the events you want to subscribe to.

Valid values: replication-instance | migration-task

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a source type that you want to subscribe to. Use the DescribeEventCategories action to see a list of event categories.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription.

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionResponse":{ - "type":"structure", - "members":{ - "EventSubscription":{ - "shape":"EventSubscription", - "documentation":"

The modified event subscription.

" - } - }, - "documentation":"

" - }, - "ModifyReplicationInstanceMessage":{ - "type":"structure", - "required":["ReplicationInstanceArn"], - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gigabytes) to be allocated for the replication instance.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Indicates whether the changes should be applied immediately or during the next maintenance window.

" - }, - "ReplicationInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the replication instance.

Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

Specifies the VPC security group to be used with the replication instance. The VPC security group must work with the VPC containing the replication instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur, which might result in an outage. Changing this parameter does not result in an outage, except in the following situation, and the change is asynchronously applied as soon as possible. If moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure pending changes are applied.

Default: Uses existing setting

Format: ddd:hh24:mi-ddd:hh24:mi

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Must be at least 30 minutes

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version number of the replication instance.

" - }, - "AllowMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

Constraints: This parameter must be set to true when specifying a value for the EngineVersion parameter that is a different major version than the replication instance's current version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades will be applied automatically to the replication instance during the maintenance window. Changing this parameter does not result in an outage except in the following case and the change is asynchronously applied as soon as possible. An outage will result if this parameter is set to true during the maintenance window, and a newer minor version is available, and AWS DMS has enabled auto patching for that engine version.

" - }, - "ReplicationInstanceIdentifier":{ - "shape":"String", - "documentation":"

The replication instance identifier. This parameter is stored as a lowercase string.

" - } - }, - "documentation":"

" - }, - "ModifyReplicationInstanceResponse":{ - "type":"structure", - "members":{ - "ReplicationInstance":{ - "shape":"ReplicationInstance", - "documentation":"

The modified replication instance.

" - } - }, - "documentation":"

" - }, - "ModifyReplicationSubnetGroupMessage":{ - "type":"structure", - "required":[ - "ReplicationSubnetGroupIdentifier", - "SubnetIds" - ], - "members":{ - "ReplicationSubnetGroupIdentifier":{ - "shape":"String", - "documentation":"

The name of the replication instance subnet group.

" - }, - "ReplicationSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description of the replication instance subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

A list of subnet IDs.

" - } - }, - "documentation":"

" - }, - "ModifyReplicationSubnetGroupResponse":{ - "type":"structure", - "members":{ - "ReplicationSubnetGroup":{ - "shape":"ReplicationSubnetGroup", - "documentation":"

The modified replication subnet group.

" - } - }, - "documentation":"

" - }, - "ModifyReplicationTaskMessage":{ - "type":"structure", - "required":["ReplicationTaskArn"], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "ReplicationTaskIdentifier":{ - "shape":"String", - "documentation":"

The replication task identifier.

Constraints:

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "MigrationType":{ - "shape":"MigrationTypeValue", - "documentation":"

The migration type.

Valid values: full-load | cdc | full-load-and-cdc

" - }, - "TableMappings":{ - "shape":"String", - "documentation":"

When using the AWS CLI or boto3, provide the path of the JSON file that contains the table mappings. Precede the path with \"file://\". When working with the DMS API, provide the JSON as the parameter value.

For example, --table-mappings file://mappingfile.json

" - }, - "ReplicationTaskSettings":{ - "shape":"String", - "documentation":"

JSON file that contains settings for the task, such as target metadata settings.

" - }, - "CdcStartTime":{ - "shape":"TStamp", - "documentation":"

Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.

Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”

" - }, - "CdcStartPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.

The value can be in date, checkpoint, or LSN/SCN format.

Date Example: --cdc-start-position “2018-03-08T12:12:12”

Checkpoint Example: --cdc-start-position \"checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93\"

LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”

" - }, - "CdcStopPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.

Server time example: --cdc-stop-position “server_time:3018-02-09T12:12:12”

Commit time example: --cdc-stop-position “commit_time: 3018-02-09T12:12:12 “

" - } - }, - "documentation":"

" - }, - "ModifyReplicationTaskResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The replication task that was modified.

" - } - }, - "documentation":"

" - }, - "MongoDbSettings":{ - "type":"structure", - "members":{ - "Username":{ - "shape":"String", - "documentation":"

The user name you use to access the MongoDB source endpoint.

" - }, - "Password":{ - "shape":"SecretString", - "documentation":"

The password for the user account you use to access the MongoDB source endpoint.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server on the MongoDB source endpoint.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port value for the MongoDB source endpoint.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The database name on the MongoDB source endpoint.

" - }, - "AuthType":{ - "shape":"AuthTypeValue", - "documentation":"

The authentication type you use to access the MongoDB source endpoint.

Valid values: NO, PASSWORD

When NO is selected, user name and password parameters are not used and can be empty.

" - }, - "AuthMechanism":{ - "shape":"AuthMechanismValue", - "documentation":"

The authentication mechanism you use to access the MongoDB source endpoint.

Valid values: DEFAULT, MONGODB_CR, SCRAM_SHA_1

DEFAULT – For MongoDB version 2.x, use MONGODB_CR. For MongoDB version 3.x, use SCRAM_SHA_1. This attribute is not used when authType=No.

" - }, - "NestingLevel":{ - "shape":"NestingLevelValue", - "documentation":"

Specifies either document or table mode.

Valid values: NONE, ONE

Default value is NONE. Specify NONE to use document mode. Specify ONE to use table mode.

" - }, - "ExtractDocId":{ - "shape":"String", - "documentation":"

Specifies the document ID. Use this attribute when NestingLevel is set to NONE.

Default value is false.

" - }, - "DocsToInvestigate":{ - "shape":"String", - "documentation":"

Indicates the number of documents to preview to determine the document organization. Use this attribute when NestingLevel is set to ONE.

Must be a positive value greater than 0. Default value is 1000.

" - }, - "AuthSource":{ - "shape":"String", - "documentation":"

The MongoDB database name. This attribute is not used when authType=NO.

The default is admin.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The KMS key identifier that will be used to encrypt the connection parameters. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.

" - } - }, - "documentation":"

" - }, - "NestingLevelValue":{ - "type":"string", - "enum":[ - "none", - "one" - ] - }, - "OrderableReplicationInstance":{ - "type":"structure", - "members":{ - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the replication engine.

" - }, - "ReplicationInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the replication instance.

Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

The type of storage used by the replication instance.

" - }, - "MinAllocatedStorage":{ - "shape":"Integer", - "documentation":"

The minimum amount of storage (in gigabytes) that can be allocated for the replication instance.

" - }, - "MaxAllocatedStorage":{ - "shape":"Integer", - "documentation":"

The minimum amount of storage (in gigabytes) that can be allocated for the replication instance.

" - }, - "DefaultAllocatedStorage":{ - "shape":"Integer", - "documentation":"

The default amount of storage (in gigabytes) that is allocated for the replication instance.

" - }, - "IncludedAllocatedStorage":{ - "shape":"Integer", - "documentation":"

The amount of storage (in gigabytes) that is allocated for the replication instance.

" - } - }, - "documentation":"

" - }, - "OrderableReplicationInstanceList":{ - "type":"list", - "member":{"shape":"OrderableReplicationInstance"} - }, - "RebootReplicationInstanceMessage":{ - "type":"structure", - "required":["ReplicationInstanceArn"], - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "ForceFailover":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is true, the reboot is conducted through a Multi-AZ failover. (If the instance isn't configured for Multi-AZ, then you can't specify true.)

" - } - } - }, - "RebootReplicationInstanceResponse":{ - "type":"structure", - "members":{ - "ReplicationInstance":{ - "shape":"ReplicationInstance", - "documentation":"

The replication instance that is being rebooted.

" - } - } - }, - "RefreshSchemasMessage":{ - "type":"structure", - "required":[ - "EndpointArn", - "ReplicationInstanceArn" - ], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - } - }, - "documentation":"

" - }, - "RefreshSchemasResponse":{ - "type":"structure", - "members":{ - "RefreshSchemasStatus":{ - "shape":"RefreshSchemasStatus", - "documentation":"

The status of the refreshed schema.

" - } - }, - "documentation":"

" - }, - "RefreshSchemasStatus":{ - "type":"structure", - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "Status":{ - "shape":"RefreshSchemasStatusTypeValue", - "documentation":"

The status of the schema.

" - }, - "LastRefreshDate":{ - "shape":"TStamp", - "documentation":"

The date the schema was last refreshed.

" - }, - "LastFailureMessage":{ - "shape":"String", - "documentation":"

The last failure message for the schema.

" - } - }, - "documentation":"

" - }, - "RefreshSchemasStatusTypeValue":{ - "type":"string", - "enum":[ - "successful", - "failed", - "refreshing" - ] - }, - "ReloadOptionValue":{ - "type":"string", - "enum":[ - "data-reload", - "validate-only" - ] - }, - "ReloadTablesMessage":{ - "type":"structure", - "required":[ - "ReplicationTaskArn", - "TablesToReload" - ], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "TablesToReload":{ - "shape":"TableListToReload", - "documentation":"

The name and schema of the table to be reloaded.

" - }, - "ReloadOption":{ - "shape":"ReloadOptionValue", - "documentation":"

Options for reload. Specify data-reload to reload the data and re-validate it if validation is enabled. Specify validate-only to re-validate the table. This option applies only when validation is enabled for the task.

Valid values: data-reload, validate-only

Default value is data-reload.

" - } - } - }, - "ReloadTablesResponse":{ - "type":"structure", - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - } - } - }, - "RemoveTagsFromResourceMessage":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"String", - "documentation":"

>The Amazon Resource Name (ARN) of the AWS DMS resource the tag is to be removed from.

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

The tag key (name) of the tag to be removed.

" - } - }, - "documentation":"

" - }, - "RemoveTagsFromResourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "ReplicationEndpointTypeValue":{ - "type":"string", - "enum":[ - "source", - "target" - ] - }, - "ReplicationInstance":{ - "type":"structure", - "members":{ - "ReplicationInstanceIdentifier":{ - "shape":"String", - "documentation":"

The replication instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: myrepinstance

" - }, - "ReplicationInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the replication instance.

Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge

" - }, - "ReplicationInstanceStatus":{ - "shape":"String", - "documentation":"

The status of the replication instance.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

The amount of storage (in gigabytes) that is allocated for the replication instance.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

The time the replication instance was created.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

The VPC security group for the instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the instance.

" - }, - "ReplicationSubnetGroup":{ - "shape":"ReplicationSubnetGroup", - "documentation":"

The subnet group for the replication instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The maintenance window times for the replication instance.

" - }, - "PendingModifiedValues":{ - "shape":"ReplicationPendingModifiedValues", - "documentation":"

The pending modification values.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version number of the replication instance.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Boolean value indicating if minor version upgrades will be automatically applied to the instance.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The KMS key identifier that is used to encrypt the content on the replication instance. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.

" - }, - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "ReplicationInstancePublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address of the replication instance.

", - "deprecated":true - }, - "ReplicationInstancePrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the replication instance.

", - "deprecated":true - }, - "ReplicationInstancePublicIpAddresses":{ - "shape":"ReplicationInstancePublicIpAddressList", - "documentation":"

The public IP address of the replication instance.

" - }, - "ReplicationInstancePrivateIpAddresses":{ - "shape":"ReplicationInstancePrivateIpAddressList", - "documentation":"

The private IP address of the replication instance.

" - }, - "PubliclyAccessible":{ - "shape":"Boolean", - "documentation":"

Specifies the accessibility options for the replication instance. A value of true represents an instance with a public IP address. A value of false represents an instance with a private IP address. The default value is true.

" - }, - "SecondaryAvailabilityZone":{ - "shape":"String", - "documentation":"

The availability zone of the standby replication instance in a Multi-AZ deployment.

" - }, - "FreeUntil":{ - "shape":"TStamp", - "documentation":"

The expiration date of the free replication instance that is part of the Free DMS program.

" - } - }, - "documentation":"

" - }, - "ReplicationInstanceList":{ - "type":"list", - "member":{"shape":"ReplicationInstance"} - }, - "ReplicationInstancePrivateIpAddressList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReplicationInstancePublicIpAddressList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReplicationInstanceTaskLog":{ - "type":"structure", - "members":{ - "ReplicationTaskName":{ - "shape":"String", - "documentation":"

The name of the replication task.

" - }, - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "ReplicationInstanceTaskLogSize":{ - "shape":"Long", - "documentation":"

The size, in bytes, of the replication task log.

" - } - }, - "documentation":"

Contains metadata for a replication instance task log.

" - }, - "ReplicationInstanceTaskLogsList":{ - "type":"list", - "member":{"shape":"ReplicationInstanceTaskLog"} - }, - "ReplicationPendingModifiedValues":{ - "type":"structure", - "members":{ - "ReplicationInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the replication instance.

Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gigabytes) that is allocated for the replication instance.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version number of the replication instance.

" - } - }, - "documentation":"

" - }, - "ReplicationSubnetGroup":{ - "type":"structure", - "members":{ - "ReplicationSubnetGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the replication instance subnet group.

" - }, - "ReplicationSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description of the replication subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "SubnetGroupStatus":{ - "shape":"String", - "documentation":"

The status of the subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

The subnets that are in the subnet group.

" - } - }, - "documentation":"

" - }, - "ReplicationSubnetGroupDoesNotCoverEnoughAZs":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet group and add more AZs.

", - "exception":true - }, - "ReplicationSubnetGroups":{ - "type":"list", - "member":{"shape":"ReplicationSubnetGroup"} - }, - "ReplicationTask":{ - "type":"structure", - "members":{ - "ReplicationTaskIdentifier":{ - "shape":"String", - "documentation":"

The user-assigned replication task identifier or name.

Constraints:

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SourceEndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "TargetEndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - }, - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "MigrationType":{ - "shape":"MigrationTypeValue", - "documentation":"

The type of migration.

" - }, - "TableMappings":{ - "shape":"String", - "documentation":"

Table mappings specified in the task.

" - }, - "ReplicationTaskSettings":{ - "shape":"String", - "documentation":"

The settings for the replication task.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the replication task.

" - }, - "LastFailureMessage":{ - "shape":"String", - "documentation":"

The last error (failure) message generated for the replication instance.

" - }, - "StopReason":{ - "shape":"String", - "documentation":"

The reason the replication task was stopped.

" - }, - "ReplicationTaskCreationDate":{ - "shape":"TStamp", - "documentation":"

The date the replication task was created.

" - }, - "ReplicationTaskStartDate":{ - "shape":"TStamp", - "documentation":"

The date the replication task is scheduled to start.

" - }, - "CdcStartPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.

The value can be in date, checkpoint, or LSN/SCN format.

Date Example: --cdc-start-position “2018-03-08T12:12:12”

Checkpoint Example: --cdc-start-position \"checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93\"

LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”

" - }, - "CdcStopPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.

Server time example: --cdc-stop-position “server_time:3018-02-09T12:12:12”

Commit time example: --cdc-stop-position “commit_time: 3018-02-09T12:12:12 “

" - }, - "RecoveryCheckpoint":{ - "shape":"String", - "documentation":"

Indicates the last checkpoint that occurred during a change data capture (CDC) operation. You can provide this value to the CdcStartPosition parameter to start a CDC operation that begins at that checkpoint.

" - }, - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "ReplicationTaskStats":{ - "shape":"ReplicationTaskStats", - "documentation":"

The statistics for the task, including elapsed time, tables loaded, and table errors.

" - } - }, - "documentation":"

" - }, - "ReplicationTaskAssessmentResult":{ - "type":"structure", - "members":{ - "ReplicationTaskIdentifier":{ - "shape":"String", - "documentation":"

The replication task identifier of the task on which the task assessment was run.

" - }, - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - }, - "ReplicationTaskLastAssessmentDate":{ - "shape":"TStamp", - "documentation":"

The date the task assessment was completed.

" - }, - "AssessmentStatus":{ - "shape":"String", - "documentation":"

The status of the task assessment.

" - }, - "AssessmentResultsFile":{ - "shape":"String", - "documentation":"

The file containing the results of the task assessment.

" - }, - "AssessmentResults":{ - "shape":"String", - "documentation":"

The task assessment results in JSON format.

" - }, - "S3ObjectUrl":{ - "shape":"String", - "documentation":"

The URL of the S3 object containing the task assessment results.

" - } - }, - "documentation":"

The task assessment report in JSON format.

" - }, - "ReplicationTaskAssessmentResultList":{ - "type":"list", - "member":{"shape":"ReplicationTaskAssessmentResult"} - }, - "ReplicationTaskList":{ - "type":"list", - "member":{"shape":"ReplicationTask"} - }, - "ReplicationTaskStats":{ - "type":"structure", - "members":{ - "FullLoadProgressPercent":{ - "shape":"Integer", - "documentation":"

The percent complete for the full load migration task.

" - }, - "ElapsedTimeMillis":{ - "shape":"Long", - "documentation":"

The elapsed time of the task, in milliseconds.

" - }, - "TablesLoaded":{ - "shape":"Integer", - "documentation":"

The number of tables loaded for this task.

" - }, - "TablesLoading":{ - "shape":"Integer", - "documentation":"

The number of tables currently loading for this task.

" - }, - "TablesQueued":{ - "shape":"Integer", - "documentation":"

The number of tables queued for this task.

" - }, - "TablesErrored":{ - "shape":"Integer", - "documentation":"

The number of errors that have occurred during this task.

" - } - }, - "documentation":"

" - }, - "ResourceAlreadyExistsFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The resource you are attempting to create already exists.

", - "exception":true - }, - "ResourceNotFoundFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The resource could not be found.

", - "exception":true - }, - "ResourceQuotaExceededFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The quota for this resource quota has been exceeded.

", - "exception":true - }, - "S3Settings":{ - "type":"structure", - "members":{ - "ServiceAccessRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) used by the service access IAM role.

" - }, - "ExternalTableDefinition":{ - "shape":"String", - "documentation":"

The external table definition.

" - }, - "CsvRowDelimiter":{ - "shape":"String", - "documentation":"

The delimiter used to separate rows in the source files. The default is a carriage return (\\n).

" - }, - "CsvDelimiter":{ - "shape":"String", - "documentation":"

The delimiter used to separate columns in the source files. The default is a comma.

" - }, - "BucketFolder":{ - "shape":"String", - "documentation":"

An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path <bucketFolder>/<schema_name>/<table_name>/. If this parameter is not specified, then the path used is <schema_name>/<table_name>/.

" - }, - "BucketName":{ - "shape":"String", - "documentation":"

The name of the S3 bucket.

" - }, - "CompressionType":{ - "shape":"CompressionTypeValue", - "documentation":"

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed.

" - } - }, - "documentation":"

" - }, - "SNSInvalidTopicFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The SNS topic is invalid.

", - "exception":true - }, - "SNSNoAuthorizationFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

You are not authorized for the SNS subscription.

", - "exception":true - }, - "SchemaList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SecretString":{ - "type":"string", - "sensitive":true - }, - "SourceIdsList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SourceType":{ - "type":"string", - "enum":["replication-instance"] - }, - "StartReplicationTaskAssessmentMessage":{ - "type":"structure", - "required":["ReplicationTaskArn"], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task.

" - } - }, - "documentation":"

" - }, - "StartReplicationTaskAssessmentResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The assessed replication task.

" - } - }, - "documentation":"

" - }, - "StartReplicationTaskMessage":{ - "type":"structure", - "required":[ - "ReplicationTaskArn", - "StartReplicationTaskType" - ], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication task to be started.

" - }, - "StartReplicationTaskType":{ - "shape":"StartReplicationTaskTypeValue", - "documentation":"

The type of replication task.

" - }, - "CdcStartTime":{ - "shape":"TStamp", - "documentation":"

Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.

Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”

" - }, - "CdcStartPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.

The value can be in date, checkpoint, or LSN/SCN format.

Date Example: --cdc-start-position “2018-03-08T12:12:12”

Checkpoint Example: --cdc-start-position \"checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93\"

LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”

" - }, - "CdcStopPosition":{ - "shape":"String", - "documentation":"

Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.

Server time example: --cdc-stop-position “server_time:3018-02-09T12:12:12”

Commit time example: --cdc-stop-position “commit_time: 3018-02-09T12:12:12 “

" - } - }, - "documentation":"

" - }, - "StartReplicationTaskResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The replication task started.

" - } - }, - "documentation":"

" - }, - "StartReplicationTaskTypeValue":{ - "type":"string", - "enum":[ - "start-replication", - "resume-processing", - "reload-target" - ] - }, - "StopReplicationTaskMessage":{ - "type":"structure", - "required":["ReplicationTaskArn"], - "members":{ - "ReplicationTaskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name(ARN) of the replication task to be stopped.

" - } - }, - "documentation":"

" - }, - "StopReplicationTaskResponse":{ - "type":"structure", - "members":{ - "ReplicationTask":{ - "shape":"ReplicationTask", - "documentation":"

The replication task stopped.

" - } - }, - "documentation":"

" - }, - "StorageQuotaExceededFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The storage quota has been exceeded.

", - "exception":true - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

The subnet identifier.

" - }, - "SubnetAvailabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone of the subnet.

" - }, - "SubnetStatus":{ - "shape":"String", - "documentation":"

The status of the subnet.

" - } - }, - "documentation":"

" - }, - "SubnetAlreadyInUse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

The specified subnet is already in use.

", - "exception":true - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubnetList":{ - "type":"list", - "member":{"shape":"Subnet"} - }, - "SupportedEndpointType":{ - "type":"structure", - "members":{ - "EngineName":{ - "shape":"String", - "documentation":"

The database engine name. Valid values, depending on the EndPointType, include mysql, oracle, postgres, mariadb, aurora, aurora-postgresql, redshift, s3, db2, azuredb, sybase, sybase, dynamodb, mongodb, and sqlserver.

" - }, - "SupportsCDC":{ - "shape":"Boolean", - "documentation":"

Indicates if Change Data Capture (CDC) is supported.

" - }, - "EndpointType":{ - "shape":"ReplicationEndpointTypeValue", - "documentation":"

The type of endpoint.

" - }, - "EngineDisplayName":{ - "shape":"String", - "documentation":"

The expanded name for the engine name. For example, if the EngineName parameter is \"aurora,\" this value would be \"Amazon Aurora MySQL.\"

" - } - }, - "documentation":"

" - }, - "SupportedEndpointTypeList":{ - "type":"list", - "member":{"shape":"SupportedEndpointType"} - }, - "TStamp":{"type":"timestamp"}, - "TableListToReload":{ - "type":"list", - "member":{"shape":"TableToReload"} - }, - "TableStatistics":{ - "type":"structure", - "members":{ - "SchemaName":{ - "shape":"String", - "documentation":"

The schema name.

" - }, - "TableName":{ - "shape":"String", - "documentation":"

The name of the table.

" - }, - "Inserts":{ - "shape":"Long", - "documentation":"

The number of insert actions performed on a table.

" - }, - "Deletes":{ - "shape":"Long", - "documentation":"

The number of delete actions performed on a table.

" - }, - "Updates":{ - "shape":"Long", - "documentation":"

The number of update actions performed on a table.

" - }, - "Ddls":{ - "shape":"Long", - "documentation":"

The Data Definition Language (DDL) used to build and modify the structure of your tables.

" - }, - "FullLoadRows":{ - "shape":"Long", - "documentation":"

The number of rows added during the Full Load operation.

" - }, - "FullLoadCondtnlChkFailedRows":{ - "shape":"Long", - "documentation":"

The number of rows that failed conditional checks during the Full Load operation (valid only for DynamoDB as a target migrations).

" - }, - "FullLoadErrorRows":{ - "shape":"Long", - "documentation":"

The number of rows that failed to load during the Full Load operation (valid only for DynamoDB as a target migrations).

" - }, - "LastUpdateTime":{ - "shape":"TStamp", - "documentation":"

The last time the table was updated.

" - }, - "TableState":{ - "shape":"String", - "documentation":"

The state of the tables described.

Valid states: Table does not exist | Before load | Full load | Table completed | Table cancelled | Table error | Table all | Table updates | Table is being reloaded

" - }, - "ValidationPendingRecords":{ - "shape":"Long", - "documentation":"

The number of records that have yet to be validated.

" - }, - "ValidationFailedRecords":{ - "shape":"Long", - "documentation":"

The number of records that failed validation.

" - }, - "ValidationSuspendedRecords":{ - "shape":"Long", - "documentation":"

The number of records that could not be validated.

" - }, - "ValidationState":{ - "shape":"String", - "documentation":"

The validation state of the table.

The parameter can have the following values

  • Not enabled—Validation is not enabled for the table in the migration task.

  • Pending records—Some records in the table are waiting for validation.

  • Mismatched records—Some records in the table do not match between the source and target.

  • Suspended records—Some records in the table could not be validated.

  • No primary key—The table could not be validated because it had no primary key.

  • Table error—The table was not validated because it was in an error state and some data was not migrated.

  • Validated—All rows in the table were validated. If the table is updated, the status can change from Validated.

  • Error—The table could not be validated because of an unexpected error.

" - }, - "ValidationStateDetails":{ - "shape":"String", - "documentation":"

Additional details about the state of validation.

" - } - }, - "documentation":"

" - }, - "TableStatisticsList":{ - "type":"list", - "member":{"shape":"TableStatistics"} - }, - "TableToReload":{ - "type":"structure", - "members":{ - "SchemaName":{ - "shape":"String", - "documentation":"

The schema name of the table to be reloaded.

" - }, - "TableName":{ - "shape":"String", - "documentation":"

The table name of the table to be reloaded.

" - } - }, - "documentation":"

" - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with \"aws:\" or \"dms:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - }, - "Value":{ - "shape":"String", - "documentation":"

A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with \"aws:\" or \"dms:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - } - }, - "documentation":"

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TestConnectionMessage":{ - "type":"structure", - "required":[ - "ReplicationInstanceArn", - "EndpointArn" - ], - "members":{ - "ReplicationInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the replication instance.

" - }, - "EndpointArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

" - } - }, - "documentation":"

" - }, - "TestConnectionResponse":{ - "type":"structure", - "members":{ - "Connection":{ - "shape":"Connection", - "documentation":"

The connection tested.

" - } - }, - "documentation":"

" - }, - "UpgradeDependencyFailureFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

" - } - }, - "documentation":"

An upgrade dependency is preventing the database migration.

", - "exception":true - }, - "VpcSecurityGroupIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "VpcSecurityGroupMembership":{ - "type":"structure", - "members":{ - "VpcSecurityGroupId":{ - "shape":"String", - "documentation":"

The VPC security group Id.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the VPC security group.

" - } - }, - "documentation":"

" - }, - "VpcSecurityGroupMembershipList":{ - "type":"list", - "member":{"shape":"VpcSecurityGroupMembership"} - } - }, - "documentation":"AWS Database Migration Service

AWS Database Migration Service (AWS DMS) can migrate your data to and from the most widely used commercial and open-source databases such as Oracle, PostgreSQL, Microsoft SQL Server, Amazon Redshift, MariaDB, Amazon Aurora, MySQL, and SAP Adaptive Server Enterprise (ASE). The service supports homogeneous migrations such as Oracle to Oracle, as well as heterogeneous migrations between different database platforms, such as Oracle to MySQL or SQL Server to PostgreSQL.

For more information about AWS DMS, see the AWS DMS user guide at What Is AWS Database Migration Service?

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/paginators-1.json deleted file mode 100644 index 409e2250..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "DescribeDomainControllers": { - "result_key": "DomainControllers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "Limit" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/service-2.json deleted file mode 100644 index dd153440..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ds/2015-04-16/service-2.json +++ /dev/null @@ -1,3079 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-04-16", - "endpointPrefix":"ds", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Directory Service", - "serviceFullName":"AWS Directory Service", - "serviceId":"Directory Service", - "signatureVersion":"v4", - "targetPrefix":"DirectoryService_20150416", - "uid":"ds-2015-04-16" - }, - "operations":{ - "AddIpRoutes":{ - "name":"AddIpRoutes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddIpRoutesRequest"}, - "output":{"shape":"AddIpRoutesResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"InvalidParameterException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"IpRouteLimitExceededException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

If the DNS server for your on-premises domain uses a publicly addressable IP address, you must add a CIDR address block to correctly route traffic to and from your Microsoft AD on Amazon Web Services. AddIpRoutes adds this address block. You can also use AddIpRoutes to facilitate routing traffic that uses public IP ranges from your Microsoft AD on AWS to a peer VPC.

Before you call AddIpRoutes, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the AddIpRoutes operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

" - }, - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceRequest"}, - "output":{"shape":"AddTagsToResourceResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"TagLimitExceededException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Adds or overwrites one or more tags for the specified directory. Each directory can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique to each resource.

" - }, - "CancelSchemaExtension":{ - "name":"CancelSchemaExtension", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSchemaExtensionRequest"}, - "output":{"shape":"CancelSchemaExtensionResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Cancels an in-progress schema extension to a Microsoft AD directory. Once a schema extension has started replicating to all domain controllers, the task can no longer be canceled. A schema extension can be canceled during any of the following states; Initializing, CreatingSnapshot, and UpdatingSchema.

" - }, - "ConnectDirectory":{ - "name":"ConnectDirectory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConnectDirectoryRequest"}, - "output":{"shape":"ConnectDirectoryResult"}, - "errors":[ - {"shape":"DirectoryLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates an AD Connector to connect to an on-premises directory.

Before you call ConnectDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the ConnectDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

" - }, - "CreateAlias":{ - "name":"CreateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAliasRequest"}, - "output":{"shape":"CreateAliasResult"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates an alias for a directory and assigns the alias to the directory. The alias is used to construct the access URL for the directory, such as http://<alias>.awsapps.com.

After an alias has been created, it cannot be deleted or reused, so this operation should only be used when absolutely necessary.

" - }, - "CreateComputer":{ - "name":"CreateComputer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateComputerRequest"}, - "output":{"shape":"CreateComputerResult"}, - "errors":[ - {"shape":"AuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates a computer account in the specified directory, and joins the computer to the directory.

" - }, - "CreateConditionalForwarder":{ - "name":"CreateConditionalForwarder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConditionalForwarderRequest"}, - "output":{"shape":"CreateConditionalForwarderResult"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates a conditional forwarder associated with your AWS directory. Conditional forwarders are required in order to set up a trust relationship with another domain. The conditional forwarder points to the trusted domain.

" - }, - "CreateDirectory":{ - "name":"CreateDirectory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDirectoryRequest"}, - "output":{"shape":"CreateDirectoryResult"}, - "errors":[ - {"shape":"DirectoryLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates a Simple AD directory.

Before you call CreateDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

" - }, - "CreateMicrosoftAD":{ - "name":"CreateMicrosoftAD", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateMicrosoftADRequest"}, - "output":{"shape":"CreateMicrosoftADResult"}, - "errors":[ - {"shape":"DirectoryLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Creates a Microsoft AD in the AWS cloud.

Before you call CreateMicrosoftAD, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateMicrosoftAD operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{"shape":"CreateSnapshotResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"SnapshotLimitExceededException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Creates a snapshot of a Simple AD or Microsoft AD directory in the AWS cloud.

You cannot take snapshots of AD Connector directories.

" - }, - "CreateTrust":{ - "name":"CreateTrust", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTrustRequest"}, - "output":{"shape":"CreateTrustResult"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships. For example, you can establish a trust between your Microsoft AD in the AWS cloud, and your existing on-premises Microsoft Active Directory. This would allow you to provide users and groups access to resources in either domain, with a single set of credentials.

This action initiates the creation of the AWS side of a trust relationship between a Microsoft AD in the AWS cloud and an external domain.

" - }, - "DeleteConditionalForwarder":{ - "name":"DeleteConditionalForwarder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConditionalForwarderRequest"}, - "output":{"shape":"DeleteConditionalForwarderResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Deletes a conditional forwarder that has been set up for your AWS directory.

" - }, - "DeleteDirectory":{ - "name":"DeleteDirectory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDirectoryRequest"}, - "output":{"shape":"DeleteDirectoryResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Deletes an AWS Directory Service directory.

Before you call DeleteDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the DeleteDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "output":{"shape":"DeleteSnapshotResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Deletes a directory snapshot.

" - }, - "DeleteTrust":{ - "name":"DeleteTrust", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTrustRequest"}, - "output":{"shape":"DeleteTrustResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Deletes an existing trust relationship between your Microsoft AD in the AWS cloud and an external domain.

" - }, - "DeregisterEventTopic":{ - "name":"DeregisterEventTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterEventTopicRequest"}, - "output":{"shape":"DeregisterEventTopicResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Removes the specified directory as a publisher to the specified SNS topic.

" - }, - "DescribeConditionalForwarders":{ - "name":"DescribeConditionalForwarders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConditionalForwardersRequest"}, - "output":{"shape":"DescribeConditionalForwardersResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains information about the conditional forwarders for this account.

If no input parameters are provided for RemoteDomainNames, this request describes all conditional forwarders for the specified directory ID.

" - }, - "DescribeDirectories":{ - "name":"DescribeDirectories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDirectoriesRequest"}, - "output":{"shape":"DescribeDirectoriesResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains information about the directories that belong to this account.

You can retrieve information about specific directories by passing the directory identifiers in the DirectoryIds parameter. Otherwise, all directories that belong to the current account are returned.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the DescribeDirectoriesResult.NextToken member contains a token that you pass in the next call to DescribeDirectories to retrieve the next set of items.

You can also specify a maximum number of return results with the Limit parameter.

" - }, - "DescribeDomainControllers":{ - "name":"DescribeDomainControllers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDomainControllersRequest"}, - "output":{"shape":"DescribeDomainControllersResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Provides information about any domain controllers in your directory.

" - }, - "DescribeEventTopics":{ - "name":"DescribeEventTopics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventTopicsRequest"}, - "output":{"shape":"DescribeEventTopicsResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains information about which SNS topics receive status messages from the specified directory.

If no input parameters are provided, such as DirectoryId or TopicName, this request describes all of the associations in the account.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains information about the directory snapshots that belong to this account.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the DescribeSnapshots.NextToken member contains a token that you pass in the next call to DescribeSnapshots to retrieve the next set of items.

You can also specify a maximum number of return results with the Limit parameter.

" - }, - "DescribeTrusts":{ - "name":"DescribeTrusts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrustsRequest"}, - "output":{"shape":"DescribeTrustsResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Obtains information about the trust relationships for this account.

If no input parameters are provided, such as DirectoryId or TrustIds, this request describes all the trust relationships belonging to the account.

" - }, - "DisableRadius":{ - "name":"DisableRadius", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableRadiusRequest"}, - "output":{"shape":"DisableRadiusResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Disables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector directory.

" - }, - "DisableSso":{ - "name":"DisableSso", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableSsoRequest"}, - "output":{"shape":"DisableSsoResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InsufficientPermissionsException"}, - {"shape":"AuthenticationFailedException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Disables single-sign on for a directory.

" - }, - "EnableRadius":{ - "name":"EnableRadius", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableRadiusRequest"}, - "output":{"shape":"EnableRadiusResult"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Enables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector directory.

" - }, - "EnableSso":{ - "name":"EnableSso", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableSsoRequest"}, - "output":{"shape":"EnableSsoResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InsufficientPermissionsException"}, - {"shape":"AuthenticationFailedException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Enables single sign-on for a directory.

" - }, - "GetDirectoryLimits":{ - "name":"GetDirectoryLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDirectoryLimitsRequest"}, - "output":{"shape":"GetDirectoryLimitsResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains directory limit information for the current region.

" - }, - "GetSnapshotLimits":{ - "name":"GetSnapshotLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSnapshotLimitsRequest"}, - "output":{"shape":"GetSnapshotLimitsResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Obtains the manual snapshot limits for a directory.

" - }, - "ListIpRoutes":{ - "name":"ListIpRoutes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIpRoutesRequest"}, - "output":{"shape":"ListIpRoutesResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Lists the address blocks that you have added to a directory.

" - }, - "ListSchemaExtensions":{ - "name":"ListSchemaExtensions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSchemaExtensionsRequest"}, - "output":{"shape":"ListSchemaExtensionsResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Lists all schema extensions applied to a Microsoft AD Directory.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Lists all tags on a directory.

" - }, - "RegisterEventTopic":{ - "name":"RegisterEventTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterEventTopicRequest"}, - "output":{"shape":"RegisterEventTopicResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Associates a directory with an SNS topic. This establishes the directory as a publisher to the specified SNS topic. You can then receive email or text (SMS) messages when the status of your directory changes. You get notified if your directory goes from an Active status to an Impaired or Inoperable status. You also receive a notification when the directory returns to an Active status.

" - }, - "RemoveIpRoutes":{ - "name":"RemoveIpRoutes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveIpRoutesRequest"}, - "output":{"shape":"RemoveIpRoutesResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Removes IP address blocks from a directory.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceRequest"}, - "output":{"shape":"RemoveTagsFromResourceResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Removes tags from a directory.

" - }, - "ResetUserPassword":{ - "name":"ResetUserPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetUserPasswordRequest"}, - "output":{"shape":"ResetUserPasswordResult"}, - "errors":[ - {"shape":"DirectoryUnavailableException"}, - {"shape":"UserDoesNotExistException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Resets the password for any user in your AWS Managed Microsoft AD or Simple AD directory.

" - }, - "RestoreFromSnapshot":{ - "name":"RestoreFromSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreFromSnapshotRequest"}, - "output":{"shape":"RestoreFromSnapshotResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Restores a directory using an existing directory snapshot.

When you restore a directory from a snapshot, any changes made to the directory after the snapshot date are overwritten.

This action returns as soon as the restore operation is initiated. You can monitor the progress of the restore operation by calling the DescribeDirectories operation with the directory identifier. When the DirectoryDescription.Stage value changes to Active, the restore operation is complete.

" - }, - "StartSchemaExtension":{ - "name":"StartSchemaExtension", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartSchemaExtensionRequest"}, - "output":{"shape":"StartSchemaExtensionResult"}, - "errors":[ - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"SnapshotLimitExceededException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Applies a schema extension to a Microsoft AD directory.

" - }, - "UpdateConditionalForwarder":{ - "name":"UpdateConditionalForwarder", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConditionalForwarderRequest"}, - "output":{"shape":"UpdateConditionalForwarderResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Updates a conditional forwarder that has been set up for your AWS directory.

" - }, - "UpdateNumberOfDomainControllers":{ - "name":"UpdateNumberOfDomainControllers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNumberOfDomainControllersRequest"}, - "output":{"shape":"UpdateNumberOfDomainControllersResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"DomainControllerLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Adds or removes domain controllers to or from the directory. Based on the difference between current value and new value (provided through this API call), domain controllers will be added or removed. It may take up to 45 minutes for any new domain controllers to become fully active once the requested number of domain controllers is updated. During this time, you cannot make another update request.

" - }, - "UpdateRadius":{ - "name":"UpdateRadius", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRadiusRequest"}, - "output":{"shape":"UpdateRadiusResult"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"EntityDoesNotExistException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Updates the Remote Authentication Dial In User Service (RADIUS) server information for an AD Connector directory.

" - }, - "VerifyTrust":{ - "name":"VerifyTrust", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyTrustRequest"}, - "output":{"shape":"VerifyTrustResult"}, - "errors":[ - {"shape":"EntityDoesNotExistException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServiceException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

AWS Directory Service for Microsoft Active Directory allows you to configure and verify trust relationships.

This action verifies a trust relationship between your Microsoft AD in the AWS cloud and an external domain.

" - } - }, - "shapes":{ - "AccessUrl":{ - "type":"string", - "max":128, - "min":1 - }, - "AddIpRoutesRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "IpRoutes" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier (ID) of the directory to which to add the address block.

" - }, - "IpRoutes":{ - "shape":"IpRoutes", - "documentation":"

IP address blocks, using CIDR format, of the traffic to route. This is often the IP address block of the DNS server used for your on-premises domain.

" - }, - "UpdateSecurityGroupForDirectoryControllers":{ - "shape":"UpdateSecurityGroupForDirectoryControllers", - "documentation":"

If set to true, updates the inbound and outbound rules of the security group that has the description: \"AWS created security group for directory ID directory controllers.\" Following are the new rules:

Inbound:

  • Type: Custom UDP Rule, Protocol: UDP, Range: 88, Source: 0.0.0.0/0

  • Type: Custom UDP Rule, Protocol: UDP, Range: 123, Source: 0.0.0.0/0

  • Type: Custom UDP Rule, Protocol: UDP, Range: 138, Source: 0.0.0.0/0

  • Type: Custom UDP Rule, Protocol: UDP, Range: 389, Source: 0.0.0.0/0

  • Type: Custom UDP Rule, Protocol: UDP, Range: 464, Source: 0.0.0.0/0

  • Type: Custom UDP Rule, Protocol: UDP, Range: 445, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 88, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 135, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 445, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 464, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 636, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 1024-65535, Source: 0.0.0.0/0

  • Type: Custom TCP Rule, Protocol: TCP, Range: 3268-33269, Source: 0.0.0.0/0

  • Type: DNS (UDP), Protocol: UDP, Range: 53, Source: 0.0.0.0/0

  • Type: DNS (TCP), Protocol: TCP, Range: 53, Source: 0.0.0.0/0

  • Type: LDAP, Protocol: TCP, Range: 389, Source: 0.0.0.0/0

  • Type: All ICMP, Protocol: All, Range: N/A, Source: 0.0.0.0/0

Outbound:

  • Type: All traffic, Protocol: All, Range: All, Destination: 0.0.0.0/0

These security rules impact an internal network interface that is not exposed publicly.

" - } - } - }, - "AddIpRoutesResult":{ - "type":"structure", - "members":{ - } - }, - "AddTagsToResourceRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "Tags" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

Identifier (ID) for the directory to which to add the tag.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags to be assigned to the directory.

" - } - } - }, - "AddTagsToResourceResult":{ - "type":"structure", - "members":{ - } - }, - "AddedDateTime":{"type":"timestamp"}, - "AliasName":{ - "type":"string", - "max":62, - "min":1, - "pattern":"^(?!d-)([\\da-zA-Z]+)([-]*[\\da-zA-Z])*" - }, - "Attribute":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - }, - "Value":{ - "shape":"AttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Represents a named directory attribute.

" - }, - "AttributeName":{ - "type":"string", - "min":1 - }, - "AttributeValue":{"type":"string"}, - "Attributes":{ - "type":"list", - "member":{"shape":"Attribute"} - }, - "AuthenticationFailedException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"ExceptionMessage", - "documentation":"

The textual message for the exception.

" - }, - "RequestId":{ - "shape":"RequestId", - "documentation":"

The identifier of the request that caused the exception.

" - } - }, - "documentation":"

An authentication error occurred.

", - "exception":true - }, - "AvailabilityZone":{"type":"string"}, - "AvailabilityZones":{ - "type":"list", - "member":{"shape":"AvailabilityZone"} - }, - "CancelSchemaExtensionRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "SchemaExtensionId" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory whose schema extension will be canceled.

" - }, - "SchemaExtensionId":{ - "shape":"SchemaExtensionId", - "documentation":"

The identifier of the schema extension that will be canceled.

" - } - } - }, - "CancelSchemaExtensionResult":{ - "type":"structure", - "members":{ - } - }, - "CidrIp":{ - "type":"string", - "pattern":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([1-9]|[1-2][0-9]|3[0-2]))$" - }, - "CidrIps":{ - "type":"list", - "member":{"shape":"CidrIp"} - }, - "ClientException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

A client exception has occurred.

", - "exception":true - }, - "CloudOnlyDirectoriesLimitReached":{"type":"boolean"}, - "Computer":{ - "type":"structure", - "members":{ - "ComputerId":{ - "shape":"SID", - "documentation":"

The identifier of the computer.

" - }, - "ComputerName":{ - "shape":"ComputerName", - "documentation":"

The computer name.

" - }, - "ComputerAttributes":{ - "shape":"Attributes", - "documentation":"

An array of Attribute objects containing the LDAP attributes that belong to the computer account.

" - } - }, - "documentation":"

Contains information about a computer account in a directory.

" - }, - "ComputerName":{ - "type":"string", - "max":15, - "min":1 - }, - "ComputerPassword":{ - "type":"string", - "max":64, - "min":8, - "pattern":"[\\u0020-\\u00FF]+", - "sensitive":true - }, - "ConditionalForwarder":{ - "type":"structure", - "members":{ - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The fully qualified domain name (FQDN) of the remote domains pointed to by the conditional forwarder.

" - }, - "DnsIpAddrs":{ - "shape":"DnsIpAddrs", - "documentation":"

The IP addresses of the remote DNS server associated with RemoteDomainName. This is the IP address of the DNS server that your conditional forwarder points to.

" - }, - "ReplicationScope":{ - "shape":"ReplicationScope", - "documentation":"

The replication scope of the conditional forwarder. The only allowed value is Domain, which will replicate the conditional forwarder to all of the domain controllers for your AWS directory.

" - } - }, - "documentation":"

Points to a remote domain with which you are setting up a trust relationship. Conditional forwarders are required in order to set up a trust relationship with another domain.

" - }, - "ConditionalForwarders":{ - "type":"list", - "member":{"shape":"ConditionalForwarder"} - }, - "ConnectDirectoryRequest":{ - "type":"structure", - "required":[ - "Name", - "Password", - "Size", - "ConnectSettings" - ], - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The fully-qualified name of the on-premises directory, such as corp.example.com.

" - }, - "ShortName":{ - "shape":"DirectoryShortName", - "documentation":"

The NetBIOS name of the on-premises directory, such as CORP.

" - }, - "Password":{ - "shape":"ConnectPassword", - "documentation":"

The password for the on-premises user account.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A textual description for the directory.

" - }, - "Size":{ - "shape":"DirectorySize", - "documentation":"

The size of the directory.

" - }, - "ConnectSettings":{ - "shape":"DirectoryConnectSettings", - "documentation":"

A DirectoryConnectSettings object that contains additional information for the operation.

" - } - }, - "documentation":"

Contains the inputs for the ConnectDirectory operation.

" - }, - "ConnectDirectoryResult":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the new directory.

" - } - }, - "documentation":"

Contains the results of the ConnectDirectory operation.

" - }, - "ConnectPassword":{ - "type":"string", - "max":128, - "min":1, - "sensitive":true - }, - "ConnectedDirectoriesLimitReached":{"type":"boolean"}, - "CreateAliasRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "Alias" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to create the alias.

" - }, - "Alias":{ - "shape":"AliasName", - "documentation":"

The requested alias.

The alias must be unique amongst all aliases in AWS. This operation throws an EntityAlreadyExistsException error if the alias already exists.

" - } - }, - "documentation":"

Contains the inputs for the CreateAlias operation.

" - }, - "CreateAliasResult":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory.

" - }, - "Alias":{ - "shape":"AliasName", - "documentation":"

The alias for the directory.

" - } - }, - "documentation":"

Contains the results of the CreateAlias operation.

" - }, - "CreateComputerRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "ComputerName", - "Password" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory in which to create the computer account.

" - }, - "ComputerName":{ - "shape":"ComputerName", - "documentation":"

The name of the computer account.

" - }, - "Password":{ - "shape":"ComputerPassword", - "documentation":"

A one-time password that is used to join the computer to the directory. You should generate a random, strong password to use for this parameter.

" - }, - "OrganizationalUnitDistinguishedName":{ - "shape":"OrganizationalUnitDN", - "documentation":"

The fully-qualified distinguished name of the organizational unit to place the computer account in.

" - }, - "ComputerAttributes":{ - "shape":"Attributes", - "documentation":"

An array of Attribute objects that contain any LDAP attributes to apply to the computer account.

" - } - }, - "documentation":"

Contains the inputs for the CreateComputer operation.

" - }, - "CreateComputerResult":{ - "type":"structure", - "members":{ - "Computer":{ - "shape":"Computer", - "documentation":"

A Computer object that represents the computer account.

" - } - }, - "documentation":"

Contains the results for the CreateComputer operation.

" - }, - "CreateConditionalForwarderRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RemoteDomainName", - "DnsIpAddrs" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory ID of the AWS directory for which you are creating the conditional forwarder.

" - }, - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The fully qualified domain name (FQDN) of the remote domain with which you will set up a trust relationship.

" - }, - "DnsIpAddrs":{ - "shape":"DnsIpAddrs", - "documentation":"

The IP addresses of the remote DNS server associated with RemoteDomainName.

" - } - }, - "documentation":"

Initiates the creation of a conditional forwarder for your AWS Directory Service for Microsoft Active Directory. Conditional forwarders are required in order to set up a trust relationship with another domain.

" - }, - "CreateConditionalForwarderResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a CreateConditinalForwarder request.

" - }, - "CreateDirectoryRequest":{ - "type":"structure", - "required":[ - "Name", - "Password", - "Size" - ], - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The fully qualified name for the directory, such as corp.example.com.

" - }, - "ShortName":{ - "shape":"DirectoryShortName", - "documentation":"

The short name of the directory, such as CORP.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The password for the directory administrator. The directory creation process creates a directory administrator account with the username Administrator and this password.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A textual description for the directory.

" - }, - "Size":{ - "shape":"DirectorySize", - "documentation":"

The size of the directory.

" - }, - "VpcSettings":{ - "shape":"DirectoryVpcSettings", - "documentation":"

A DirectoryVpcSettings object that contains additional information for the operation.

" - } - }, - "documentation":"

Contains the inputs for the CreateDirectory operation.

" - }, - "CreateDirectoryResult":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory that was created.

" - } - }, - "documentation":"

Contains the results of the CreateDirectory operation.

" - }, - "CreateMicrosoftADRequest":{ - "type":"structure", - "required":[ - "Name", - "Password", - "VpcSettings" - ], - "members":{ - "Name":{ - "shape":"DirectoryName", - "documentation":"

The fully qualified domain name for the directory, such as corp.example.com. This name will resolve inside your VPC only. It does not need to be publicly resolvable.

" - }, - "ShortName":{ - "shape":"DirectoryShortName", - "documentation":"

The NetBIOS name for your domain. A short identifier for your domain, such as CORP. If you don't specify a NetBIOS name, it will default to the first part of your directory DNS. For example, CORP for the directory DNS corp.example.com.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The password for the default administrative user named Admin.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A textual description for the directory. This label will appear on the AWS console Directory Details page after the directory is created.

" - }, - "VpcSettings":{ - "shape":"DirectoryVpcSettings", - "documentation":"

Contains VPC information for the CreateDirectory or CreateMicrosoftAD operation.

" - }, - "Edition":{ - "shape":"DirectoryEdition", - "documentation":"

AWS Microsoft AD is available in two editions: Standard and Enterprise. Enterprise is the default.

" - } - }, - "documentation":"

Creates a Microsoft AD in the AWS cloud.

" - }, - "CreateMicrosoftADResult":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory that was created.

" - } - }, - "documentation":"

Result of a CreateMicrosoftAD request.

" - }, - "CreateSnapshotBeforeSchemaExtension":{"type":"boolean"}, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory of which to take a snapshot.

" - }, - "Name":{ - "shape":"SnapshotName", - "documentation":"

The descriptive name to apply to the snapshot.

" - } - }, - "documentation":"

Contains the inputs for the CreateSnapshot operation.

" - }, - "CreateSnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The identifier of the snapshot that was created.

" - } - }, - "documentation":"

Contains the results of the CreateSnapshot operation.

" - }, - "CreateTrustRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RemoteDomainName", - "TrustPassword", - "TrustDirection" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID of the Microsoft AD in the AWS cloud for which to establish the trust relationship.

" - }, - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The Fully Qualified Domain Name (FQDN) of the external domain for which to create the trust relationship.

" - }, - "TrustPassword":{ - "shape":"TrustPassword", - "documentation":"

The trust password. The must be the same password that was used when creating the trust relationship on the external domain.

" - }, - "TrustDirection":{ - "shape":"TrustDirection", - "documentation":"

The direction of the trust relationship.

" - }, - "TrustType":{ - "shape":"TrustType", - "documentation":"

The trust relationship type.

" - }, - "ConditionalForwarderIpAddrs":{ - "shape":"DnsIpAddrs", - "documentation":"

The IP addresses of the remote DNS server associated with RemoteDomainName.

" - } - }, - "documentation":"

AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships. For example, you can establish a trust between your Microsoft AD in the AWS cloud, and your existing on-premises Microsoft Active Directory. This would allow you to provide users and groups access to resources in either domain, with a single set of credentials.

This action initiates the creation of the AWS side of a trust relationship between a Microsoft AD in the AWS cloud and an external domain.

" - }, - "CreateTrustResult":{ - "type":"structure", - "members":{ - "TrustId":{ - "shape":"TrustId", - "documentation":"

A unique identifier for the trust relationship that was created.

" - } - }, - "documentation":"

The result of a CreateTrust request.

" - }, - "CreatedDateTime":{"type":"timestamp"}, - "CustomerUserName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^(?!.*\\\\|.*\"|.*\\/|.*\\[|.*\\]|.*:|.*;|.*\\||.*=|.*,|.*\\+|.*\\*|.*\\?|.*<|.*>|.*@).*$" - }, - "DeleteAssociatedConditionalForwarder":{"type":"boolean"}, - "DeleteConditionalForwarderRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RemoteDomainName" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory ID for which you are deleting the conditional forwarder.

" - }, - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The fully qualified domain name (FQDN) of the remote domain with which you are deleting the conditional forwarder.

" - } - }, - "documentation":"

Deletes a conditional forwarder.

" - }, - "DeleteConditionalForwarderResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a DeleteConditionalForwarder request.

" - }, - "DeleteDirectoryRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory to delete.

" - } - }, - "documentation":"

Contains the inputs for the DeleteDirectory operation.

" - }, - "DeleteDirectoryResult":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory identifier.

" - } - }, - "documentation":"

Contains the results of the DeleteDirectory operation.

" - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The identifier of the directory snapshot to be deleted.

" - } - }, - "documentation":"

Contains the inputs for the DeleteSnapshot operation.

" - }, - "DeleteSnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The identifier of the directory snapshot that was deleted.

" - } - }, - "documentation":"

Contains the results of the DeleteSnapshot operation.

" - }, - "DeleteTrustRequest":{ - "type":"structure", - "required":["TrustId"], - "members":{ - "TrustId":{ - "shape":"TrustId", - "documentation":"

The Trust ID of the trust relationship to be deleted.

" - }, - "DeleteAssociatedConditionalForwarder":{ - "shape":"DeleteAssociatedConditionalForwarder", - "documentation":"

Delete a conditional forwarder as part of a DeleteTrustRequest.

" - } - }, - "documentation":"

Deletes the local side of an existing trust relationship between the Microsoft AD in the AWS cloud and the external domain.

" - }, - "DeleteTrustResult":{ - "type":"structure", - "members":{ - "TrustId":{ - "shape":"TrustId", - "documentation":"

The Trust ID of the trust relationship that was deleted.

" - } - }, - "documentation":"

The result of a DeleteTrust request.

" - }, - "DeregisterEventTopicRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "TopicName" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID to remove as a publisher. This directory will no longer send messages to the specified SNS topic.

" - }, - "TopicName":{ - "shape":"TopicName", - "documentation":"

The name of the SNS topic from which to remove the directory as a publisher.

" - } - }, - "documentation":"

Removes the specified directory as a publisher to the specified SNS topic.

" - }, - "DeregisterEventTopicResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a DeregisterEventTopic request.

" - }, - "DescribeConditionalForwardersRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory ID for which to get the list of associated conditional forwarders.

" - }, - "RemoteDomainNames":{ - "shape":"RemoteDomainNames", - "documentation":"

The fully qualified domain names (FQDN) of the remote domains for which to get the list of associated conditional forwarders. If this member is null, all conditional forwarders are returned.

" - } - }, - "documentation":"

Describes a conditional forwarder.

" - }, - "DescribeConditionalForwardersResult":{ - "type":"structure", - "members":{ - "ConditionalForwarders":{ - "shape":"ConditionalForwarders", - "documentation":"

The list of conditional forwarders that have been created.

" - } - }, - "documentation":"

The result of a DescribeConditionalForwarder request.

" - }, - "DescribeDirectoriesRequest":{ - "type":"structure", - "members":{ - "DirectoryIds":{ - "shape":"DirectoryIds", - "documentation":"

A list of identifiers of the directories for which to obtain the information. If this member is null, all directories that belong to the current account are returned.

An empty list results in an InvalidParameterException being thrown.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The DescribeDirectoriesResult.NextToken value from a previous call to DescribeDirectories. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.

" - } - }, - "documentation":"

Contains the inputs for the DescribeDirectories operation.

" - }, - "DescribeDirectoriesResult":{ - "type":"structure", - "members":{ - "DirectoryDescriptions":{ - "shape":"DirectoryDescriptions", - "documentation":"

The list of DirectoryDescription objects that were retrieved.

It is possible that this list contains less than the number of items specified in the Limit member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to DescribeDirectories to retrieve the next set of items.

" - } - }, - "documentation":"

Contains the results of the DescribeDirectories operation.

" - }, - "DescribeDomainControllersRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier of the directory for which to retrieve the domain controller information.

" - }, - "DomainControllerIds":{ - "shape":"DomainControllerIds", - "documentation":"

A list of identifiers for the domain controllers whose information will be provided.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The DescribeDomainControllers.NextToken value from a previous call to DescribeDomainControllers. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of items to return.

" - } - } - }, - "DescribeDomainControllersResult":{ - "type":"structure", - "members":{ - "DomainControllers":{ - "shape":"DomainControllers", - "documentation":"

List of the DomainController objects that were retrieved.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to DescribeDomainControllers retrieve the next set of items.

" - } - } - }, - "DescribeEventTopicsRequest":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID for which to get the list of associated SNS topics. If this member is null, associations for all Directory IDs are returned.

" - }, - "TopicNames":{ - "shape":"TopicNames", - "documentation":"

A list of SNS topic names for which to obtain the information. If this member is null, all associations for the specified Directory ID are returned.

An empty list results in an InvalidParameterException being thrown.

" - } - }, - "documentation":"

Describes event topics.

" - }, - "DescribeEventTopicsResult":{ - "type":"structure", - "members":{ - "EventTopics":{ - "shape":"EventTopics", - "documentation":"

A list of SNS topic names that receive status messages from the specified Directory ID.

" - } - }, - "documentation":"

The result of a DescribeEventTopic request.

" - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to retrieve snapshot information.

" - }, - "SnapshotIds":{ - "shape":"SnapshotIds", - "documentation":"

A list of identifiers of the snapshots to obtain the information for. If this member is null or empty, all snapshots are returned using the Limit and NextToken members.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The DescribeSnapshotsResult.NextToken value from a previous call to DescribeSnapshots. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of objects to return.

" - } - }, - "documentation":"

Contains the inputs for the DescribeSnapshots operation.

" - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"Snapshots", - "documentation":"

The list of Snapshot objects that were retrieved.

It is possible that this list contains less than the number of items specified in the Limit member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value in the NextToken member of a subsequent call to DescribeSnapshots.

" - } - }, - "documentation":"

Contains the results of the DescribeSnapshots operation.

" - }, - "DescribeTrustsRequest":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID of the AWS directory that is a part of the requested trust relationship.

" - }, - "TrustIds":{ - "shape":"TrustIds", - "documentation":"

A list of identifiers of the trust relationships for which to obtain the information. If this member is null, all trust relationships that belong to the current account are returned.

An empty list results in an InvalidParameterException being thrown.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The DescribeTrustsResult.NextToken value from a previous call to DescribeTrusts. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of objects to return.

" - } - }, - "documentation":"

Describes the trust relationships for a particular Microsoft AD in the AWS cloud. If no input parameters are are provided, such as directory ID or trust ID, this request describes all the trust relationships.

" - }, - "DescribeTrustsResult":{ - "type":"structure", - "members":{ - "Trusts":{ - "shape":"Trusts", - "documentation":"

The list of Trust objects that were retrieved.

It is possible that this list contains less than the number of items specified in the Limit member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to DescribeTrusts to retrieve the next set of items.

" - } - }, - "documentation":"

The result of a DescribeTrust request.

" - }, - "Description":{ - "type":"string", - "max":128, - "min":0, - "pattern":"^([a-zA-Z0-9_])[\\\\a-zA-Z0-9_@#%*+=:?./!\\s-]*$" - }, - "DesiredNumberOfDomainControllers":{ - "type":"integer", - "min":2 - }, - "DirectoryConnectSettings":{ - "type":"structure", - "required":[ - "VpcId", - "SubnetIds", - "CustomerDnsIps", - "CustomerUserName" - ], - "members":{ - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC in which the AD Connector is created.

" - }, - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

A list of subnet identifiers in the VPC in which the AD Connector is created.

" - }, - "CustomerDnsIps":{ - "shape":"DnsIpAddrs", - "documentation":"

A list of one or more IP addresses of DNS servers or domain controllers in the on-premises directory.

" - }, - "CustomerUserName":{ - "shape":"UserName", - "documentation":"

The username of an account in the on-premises directory that is used to connect to the directory. This account must have the following privileges:

  • Read users and groups

  • Create computer objects

  • Join computers to the domain

" - } - }, - "documentation":"

Contains information for the ConnectDirectory operation when an AD Connector directory is being created.

" - }, - "DirectoryConnectSettingsDescription":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC that the AD Connector is in.

" - }, - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

A list of subnet identifiers in the VPC that the AD connector is in.

" - }, - "CustomerUserName":{ - "shape":"UserName", - "documentation":"

The username of the service account in the on-premises directory.

" - }, - "SecurityGroupId":{ - "shape":"SecurityGroupId", - "documentation":"

The security group identifier for the AD Connector directory.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

A list of the Availability Zones that the directory is in.

" - }, - "ConnectIps":{ - "shape":"IpAddrs", - "documentation":"

The IP addresses of the AD Connector servers.

" - } - }, - "documentation":"

Contains information about an AD Connector directory.

" - }, - "DirectoryDescription":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory identifier.

" - }, - "Name":{ - "shape":"DirectoryName", - "documentation":"

The fully-qualified name of the directory.

" - }, - "ShortName":{ - "shape":"DirectoryShortName", - "documentation":"

The short name of the directory.

" - }, - "Size":{ - "shape":"DirectorySize", - "documentation":"

The directory size.

" - }, - "Edition":{ - "shape":"DirectoryEdition", - "documentation":"

The edition associated with this directory.

" - }, - "Alias":{ - "shape":"AliasName", - "documentation":"

The alias for the directory. If no alias has been created for the directory, the alias is the directory identifier, such as d-XXXXXXXXXX.

" - }, - "AccessUrl":{ - "shape":"AccessUrl", - "documentation":"

The access URL for the directory, such as http://<alias>.awsapps.com. If no alias has been created for the directory, <alias> is the directory identifier, such as d-XXXXXXXXXX.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The textual description for the directory.

" - }, - "DnsIpAddrs":{ - "shape":"DnsIpAddrs", - "documentation":"

The IP addresses of the DNS servers for the directory. For a Simple AD or Microsoft AD directory, these are the IP addresses of the Simple AD or Microsoft AD directory servers. For an AD Connector directory, these are the IP addresses of the DNS servers or domain controllers in the on-premises directory to which the AD Connector is connected.

" - }, - "Stage":{ - "shape":"DirectoryStage", - "documentation":"

The current stage of the directory.

" - }, - "LaunchTime":{ - "shape":"LaunchTime", - "documentation":"

Specifies when the directory was created.

" - }, - "StageLastUpdatedDateTime":{ - "shape":"LastUpdatedDateTime", - "documentation":"

The date and time that the stage was last updated.

" - }, - "Type":{ - "shape":"DirectoryType", - "documentation":"

The directory size.

" - }, - "VpcSettings":{ - "shape":"DirectoryVpcSettingsDescription", - "documentation":"

A DirectoryVpcSettingsDescription object that contains additional information about a directory. This member is only present if the directory is a Simple AD or Managed AD directory.

" - }, - "ConnectSettings":{ - "shape":"DirectoryConnectSettingsDescription", - "documentation":"

A DirectoryConnectSettingsDescription object that contains additional information about an AD Connector directory. This member is only present if the directory is an AD Connector directory.

" - }, - "RadiusSettings":{ - "shape":"RadiusSettings", - "documentation":"

A RadiusSettings object that contains information about the RADIUS server configured for this directory.

" - }, - "RadiusStatus":{ - "shape":"RadiusStatus", - "documentation":"

The status of the RADIUS MFA server connection.

" - }, - "StageReason":{ - "shape":"StageReason", - "documentation":"

Additional information about the directory stage.

" - }, - "SsoEnabled":{ - "shape":"SsoEnabled", - "documentation":"

Indicates if single-sign on is enabled for the directory. For more information, see EnableSso and DisableSso.

" - }, - "DesiredNumberOfDomainControllers":{ - "shape":"DesiredNumberOfDomainControllers", - "documentation":"

The desired number of domain controllers in the directory if the directory is Microsoft AD.

" - } - }, - "documentation":"

Contains information about an AWS Directory Service directory.

" - }, - "DirectoryDescriptions":{ - "type":"list", - "member":{"shape":"DirectoryDescription"}, - "documentation":"

A list of directory descriptions.

" - }, - "DirectoryEdition":{ - "type":"string", - "enum":[ - "Enterprise", - "Standard" - ] - }, - "DirectoryId":{ - "type":"string", - "pattern":"^d-[0-9a-f]{10}$" - }, - "DirectoryIds":{ - "type":"list", - "member":{"shape":"DirectoryId"}, - "documentation":"

A list of directory identifiers.

" - }, - "DirectoryLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The maximum number of directories in the region has been reached. You can use the GetDirectoryLimits operation to determine your directory limits in the region.

", - "exception":true - }, - "DirectoryLimits":{ - "type":"structure", - "members":{ - "CloudOnlyDirectoriesLimit":{ - "shape":"Limit", - "documentation":"

The maximum number of cloud directories allowed in the region.

" - }, - "CloudOnlyDirectoriesCurrentCount":{ - "shape":"Limit", - "documentation":"

The current number of cloud directories in the region.

" - }, - "CloudOnlyDirectoriesLimitReached":{ - "shape":"CloudOnlyDirectoriesLimitReached", - "documentation":"

Indicates if the cloud directory limit has been reached.

" - }, - "CloudOnlyMicrosoftADLimit":{ - "shape":"Limit", - "documentation":"

The maximum number of Microsoft AD directories allowed in the region.

" - }, - "CloudOnlyMicrosoftADCurrentCount":{ - "shape":"Limit", - "documentation":"

The current number of Microsoft AD directories in the region.

" - }, - "CloudOnlyMicrosoftADLimitReached":{ - "shape":"CloudOnlyDirectoriesLimitReached", - "documentation":"

Indicates if the Microsoft AD directory limit has been reached.

" - }, - "ConnectedDirectoriesLimit":{ - "shape":"Limit", - "documentation":"

The maximum number of connected directories allowed in the region.

" - }, - "ConnectedDirectoriesCurrentCount":{ - "shape":"Limit", - "documentation":"

The current number of connected directories in the region.

" - }, - "ConnectedDirectoriesLimitReached":{ - "shape":"ConnectedDirectoriesLimitReached", - "documentation":"

Indicates if the connected directory limit has been reached.

" - } - }, - "documentation":"

Contains directory limit information for a region.

" - }, - "DirectoryName":{ - "type":"string", - "pattern":"^([a-zA-Z0-9]+[\\\\.-])+([a-zA-Z0-9])+$" - }, - "DirectoryShortName":{ - "type":"string", - "pattern":"^[^\\\\/:*?\\\"\\<\\>|.]+[^\\\\/:*?\\\"<>|]*$" - }, - "DirectorySize":{ - "type":"string", - "enum":[ - "Small", - "Large" - ] - }, - "DirectoryStage":{ - "type":"string", - "enum":[ - "Requested", - "Creating", - "Created", - "Active", - "Inoperable", - "Impaired", - "Restoring", - "RestoreFailed", - "Deleting", - "Deleted", - "Failed" - ] - }, - "DirectoryType":{ - "type":"string", - "enum":[ - "SimpleAD", - "ADConnector", - "MicrosoftAD" - ] - }, - "DirectoryUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The specified directory is unavailable or could not be found.

", - "exception":true - }, - "DirectoryVpcSettings":{ - "type":"structure", - "required":[ - "VpcId", - "SubnetIds" - ], - "members":{ - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC in which to create the directory.

" - }, - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

The identifiers of the subnets for the directory servers. The two subnets must be in different Availability Zones. AWS Directory Service creates a directory server and a DNS server in each of these subnets.

" - } - }, - "documentation":"

Contains VPC information for the CreateDirectory or CreateMicrosoftAD operation.

" - }, - "DirectoryVpcSettingsDescription":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC that the directory is in.

" - }, - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

The identifiers of the subnets for the directory servers.

" - }, - "SecurityGroupId":{ - "shape":"SecurityGroupId", - "documentation":"

The domain controller security group identifier for the directory.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The list of Availability Zones that the directory is in.

" - } - }, - "documentation":"

Contains information about the directory.

" - }, - "DisableRadiusRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to disable MFA.

" - } - }, - "documentation":"

Contains the inputs for the DisableRadius operation.

" - }, - "DisableRadiusResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the DisableRadius operation.

" - }, - "DisableSsoRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to disable single-sign on.

" - }, - "UserName":{ - "shape":"UserName", - "documentation":"

The username of an alternate account to use to disable single-sign on. This is only used for AD Connector directories. This account must have privileges to remove a service principal name.

If the AD Connector service account does not have privileges to remove a service principal name, you can specify an alternate account with the UserName and Password parameters. These credentials are only used to disable single sign-on and are not stored by the service. The AD Connector service account is not changed.

" - }, - "Password":{ - "shape":"ConnectPassword", - "documentation":"

The password of an alternate account to use to disable single-sign on. This is only used for AD Connector directories. For more information, see the UserName parameter.

" - } - }, - "documentation":"

Contains the inputs for the DisableSso operation.

" - }, - "DisableSsoResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the DisableSso operation.

" - }, - "DnsIpAddrs":{ - "type":"list", - "member":{"shape":"IpAddr"} - }, - "DomainController":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier of the directory where the domain controller resides.

" - }, - "DomainControllerId":{ - "shape":"DomainControllerId", - "documentation":"

Identifies a specific domain controller in the directory.

" - }, - "DnsIpAddr":{ - "shape":"IpAddr", - "documentation":"

The IP address of the domain controller.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the VPC that contains the domain controller.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

Identifier of the subnet in the VPC that contains the domain controller.

" - }, - "AvailabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone where the domain controller is located.

" - }, - "Status":{ - "shape":"DomainControllerStatus", - "documentation":"

The status of the domain controller.

" - }, - "StatusReason":{ - "shape":"DomainControllerStatusReason", - "documentation":"

A description of the domain controller state.

" - }, - "LaunchTime":{ - "shape":"LaunchTime", - "documentation":"

Specifies when the domain controller was created.

" - }, - "StatusLastUpdatedDateTime":{ - "shape":"LastUpdatedDateTime", - "documentation":"

The date and time that the status was last updated.

" - } - }, - "documentation":"

Contains information about the domain controllers for a specified directory.

" - }, - "DomainControllerId":{ - "type":"string", - "pattern":"^dc-[0-9a-f]{10}$" - }, - "DomainControllerIds":{ - "type":"list", - "member":{"shape":"DomainControllerId"} - }, - "DomainControllerLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The maximum allowed number of domain controllers per directory was exceeded. The default limit per directory is 20 domain controllers.

", - "exception":true - }, - "DomainControllerStatus":{ - "type":"string", - "enum":[ - "Creating", - "Active", - "Impaired", - "Restoring", - "Deleting", - "Deleted", - "Failed" - ] - }, - "DomainControllerStatusReason":{"type":"string"}, - "DomainControllers":{ - "type":"list", - "member":{"shape":"DomainController"} - }, - "EnableRadiusRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RadiusSettings" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to enable MFA.

" - }, - "RadiusSettings":{ - "shape":"RadiusSettings", - "documentation":"

A RadiusSettings object that contains information about the RADIUS server.

" - } - }, - "documentation":"

Contains the inputs for the EnableRadius operation.

" - }, - "EnableRadiusResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the EnableRadius operation.

" - }, - "EnableSsoRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to enable single-sign on.

" - }, - "UserName":{ - "shape":"UserName", - "documentation":"

The username of an alternate account to use to enable single-sign on. This is only used for AD Connector directories. This account must have privileges to add a service principal name.

If the AD Connector service account does not have privileges to add a service principal name, you can specify an alternate account with the UserName and Password parameters. These credentials are only used to enable single sign-on and are not stored by the service. The AD Connector service account is not changed.

" - }, - "Password":{ - "shape":"ConnectPassword", - "documentation":"

The password of an alternate account to use to enable single-sign on. This is only used for AD Connector directories. For more information, see the UserName parameter.

" - } - }, - "documentation":"

Contains the inputs for the EnableSso operation.

" - }, - "EnableSsoResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the EnableSso operation.

" - }, - "EndDateTime":{"type":"timestamp"}, - "EntityAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The specified entity already exists.

", - "exception":true - }, - "EntityDoesNotExistException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The specified entity could not be found.

", - "exception":true - }, - "EventTopic":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID of an AWS Directory Service directory that will publish status messages to an SNS topic.

" - }, - "TopicName":{ - "shape":"TopicName", - "documentation":"

The name of an AWS SNS topic the receives status messages from the directory.

" - }, - "TopicArn":{ - "shape":"TopicArn", - "documentation":"

The SNS topic ARN (Amazon Resource Name).

" - }, - "CreatedDateTime":{ - "shape":"CreatedDateTime", - "documentation":"

The date and time of when you associated your directory with the SNS topic.

" - }, - "Status":{ - "shape":"TopicStatus", - "documentation":"

The topic registration status.

" - } - }, - "documentation":"

Information about SNS topic and AWS Directory Service directory associations.

" - }, - "EventTopics":{ - "type":"list", - "member":{"shape":"EventTopic"} - }, - "ExceptionMessage":{ - "type":"string", - "documentation":"

The descriptive message for the exception.

" - }, - "GetDirectoryLimitsRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the inputs for the GetDirectoryLimits operation.

" - }, - "GetDirectoryLimitsResult":{ - "type":"structure", - "members":{ - "DirectoryLimits":{ - "shape":"DirectoryLimits", - "documentation":"

A DirectoryLimits object that contains the directory limits for the current region.

" - } - }, - "documentation":"

Contains the results of the GetDirectoryLimits operation.

" - }, - "GetSnapshotLimitsRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Contains the identifier of the directory to obtain the limits for.

" - } - }, - "documentation":"

Contains the inputs for the GetSnapshotLimits operation.

" - }, - "GetSnapshotLimitsResult":{ - "type":"structure", - "members":{ - "SnapshotLimits":{ - "shape":"SnapshotLimits", - "documentation":"

A SnapshotLimits object that contains the manual snapshot limits for the specified directory.

" - } - }, - "documentation":"

Contains the results of the GetSnapshotLimits operation.

" - }, - "InsufficientPermissionsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The account does not have sufficient permission to perform the operation.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The NextToken value is not valid.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

One or more parameters are not valid.

", - "exception":true - }, - "InvalidPasswordException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The new password provided by the user does not meet the password complexity requirements defined in your directory.

", - "exception":true - }, - "IpAddr":{ - "type":"string", - "pattern":"^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$" - }, - "IpAddrs":{ - "type":"list", - "member":{"shape":"IpAddr"} - }, - "IpRoute":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"CidrIp", - "documentation":"

IP address block using CIDR format, for example 10.0.0.0/24. This is often the address block of the DNS server used for your on-premises domain. For a single IP address use a CIDR address block with /32. For example 10.0.0.0/32.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Description of the address block.

" - } - }, - "documentation":"

IP address block. This is often the address block of the DNS server used for your on-premises domain.

" - }, - "IpRouteInfo":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier (ID) of the directory associated with the IP addresses.

" - }, - "CidrIp":{ - "shape":"CidrIp", - "documentation":"

IP address block in the IpRoute.

" - }, - "IpRouteStatusMsg":{ - "shape":"IpRouteStatusMsg", - "documentation":"

The status of the IP address block.

" - }, - "AddedDateTime":{ - "shape":"AddedDateTime", - "documentation":"

The date and time the address block was added to the directory.

" - }, - "IpRouteStatusReason":{ - "shape":"IpRouteStatusReason", - "documentation":"

The reason for the IpRouteStatusMsg.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Description of the IpRouteInfo.

" - } - }, - "documentation":"

Information about one or more IP address blocks.

" - }, - "IpRouteLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The maximum allowed number of IP addresses was exceeded. The default limit is 100 IP address blocks.

", - "exception":true - }, - "IpRouteStatusMsg":{ - "type":"string", - "enum":[ - "Adding", - "Added", - "Removing", - "Removed", - "AddFailed", - "RemoveFailed" - ] - }, - "IpRouteStatusReason":{"type":"string"}, - "IpRoutes":{ - "type":"list", - "member":{"shape":"IpRoute"} - }, - "IpRoutesInfo":{ - "type":"list", - "member":{"shape":"IpRouteInfo"} - }, - "LastUpdatedDateTime":{"type":"timestamp"}, - "LaunchTime":{"type":"timestamp"}, - "LdifContent":{ - "type":"string", - "max":500000, - "min":1 - }, - "Limit":{ - "type":"integer", - "min":0 - }, - "ListIpRoutesRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier (ID) of the directory for which you want to retrieve the IP addresses.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The ListIpRoutes.NextToken value from a previous call to ListIpRoutes. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

Maximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.

" - } - } - }, - "ListIpRoutesResult":{ - "type":"structure", - "members":{ - "IpRoutesInfo":{ - "shape":"IpRoutesInfo", - "documentation":"

A list of IpRoutes.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to ListIpRoutes to retrieve the next set of items.

" - } - } - }, - "ListSchemaExtensionsRequest":{ - "type":"structure", - "required":["DirectoryId"], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory from which to retrieve the schema extension information.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The ListSchemaExtensions.NextToken value from a previous call to ListSchemaExtensions. Pass null if this is the first call.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of items to return.

" - } - } - }, - "ListSchemaExtensionsResult":{ - "type":"structure", - "members":{ - "SchemaExtensionsInfo":{ - "shape":"SchemaExtensionsInfo", - "documentation":"

Information about the schema extensions applied to the directory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to ListSchemaExtensions to retrieve the next set of items.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

Identifier (ID) of the directory for which you want to retrieve tags.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Reserved for future use.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

Reserved for future use.

" - } - } - }, - "ListTagsForResourceResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

List of tags returned by the ListTagsForResource operation.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Reserved for future use.

" - } - } - }, - "ManualSnapshotsLimitReached":{"type":"boolean"}, - "NextToken":{"type":"string"}, - "OrganizationalUnitDN":{ - "type":"string", - "max":2000, - "min":1 - }, - "Password":{ - "type":"string", - "pattern":"(?=^.{8,64}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9\\s])(?=.*[a-z])|(?=.*[^A-Za-z0-9\\s])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9\\s]))^.*", - "sensitive":true - }, - "PortNumber":{ - "type":"integer", - "max":65535, - "min":1025 - }, - "RadiusAuthenticationProtocol":{ - "type":"string", - "enum":[ - "PAP", - "CHAP", - "MS-CHAPv1", - "MS-CHAPv2" - ] - }, - "RadiusDisplayLabel":{ - "type":"string", - "max":64, - "min":1 - }, - "RadiusRetries":{ - "type":"integer", - "max":10, - "min":0 - }, - "RadiusSettings":{ - "type":"structure", - "members":{ - "RadiusServers":{ - "shape":"Servers", - "documentation":"

An array of strings that contains the IP addresses of the RADIUS server endpoints, or the IP addresses of your RADIUS server load balancer.

" - }, - "RadiusPort":{ - "shape":"PortNumber", - "documentation":"

The port that your RADIUS server is using for communications. Your on-premises network must allow inbound traffic over this port from the AWS Directory Service servers.

" - }, - "RadiusTimeout":{ - "shape":"RadiusTimeout", - "documentation":"

The amount of time, in seconds, to wait for the RADIUS server to respond.

" - }, - "RadiusRetries":{ - "shape":"RadiusRetries", - "documentation":"

The maximum number of times that communication with the RADIUS server is attempted.

" - }, - "SharedSecret":{ - "shape":"RadiusSharedSecret", - "documentation":"

Not currently used.

" - }, - "AuthenticationProtocol":{ - "shape":"RadiusAuthenticationProtocol", - "documentation":"

The protocol specified for your RADIUS endpoints.

" - }, - "DisplayLabel":{ - "shape":"RadiusDisplayLabel", - "documentation":"

Not currently used.

" - }, - "UseSameUsername":{ - "shape":"UseSameUsername", - "documentation":"

Not currently used.

" - } - }, - "documentation":"

Contains information about a Remote Authentication Dial In User Service (RADIUS) server.

" - }, - "RadiusSharedSecret":{ - "type":"string", - "max":512, - "min":8, - "sensitive":true - }, - "RadiusStatus":{ - "type":"string", - "enum":[ - "Creating", - "Completed", - "Failed" - ] - }, - "RadiusTimeout":{ - "type":"integer", - "max":20, - "min":1 - }, - "RegisterEventTopicRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "TopicName" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID that will publish status messages to the SNS topic.

" - }, - "TopicName":{ - "shape":"TopicName", - "documentation":"

The SNS topic name to which the directory will publish status messages. This SNS topic must be in the same region as the specified Directory ID.

" - } - }, - "documentation":"

Registers a new event topic.

" - }, - "RegisterEventTopicResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of a RegisterEventTopic request.

" - }, - "RemoteDomainName":{ - "type":"string", - "pattern":"^([a-zA-Z0-9]+[\\\\.-])+([a-zA-Z0-9])+[.]?$" - }, - "RemoteDomainNames":{ - "type":"list", - "member":{"shape":"RemoteDomainName"} - }, - "RemoveIpRoutesRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "CidrIps" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier (ID) of the directory from which you want to remove the IP addresses.

" - }, - "CidrIps":{ - "shape":"CidrIps", - "documentation":"

IP address blocks that you want to remove.

" - } - } - }, - "RemoveIpRoutesResult":{ - "type":"structure", - "members":{ - } - }, - "RemoveTagsFromResourceRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "TagKeys" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

Identifier (ID) of the directory from which to remove the tag.

" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

The tag key (name) of the tag to be removed.

" - } - } - }, - "RemoveTagsFromResourceResult":{ - "type":"structure", - "members":{ - } - }, - "ReplicationScope":{ - "type":"string", - "enum":["Domain"] - }, - "RequestId":{ - "type":"string", - "documentation":"

The AWS request identifier.

", - "pattern":"^([A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12})$" - }, - "ResetUserPasswordRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "UserName", - "NewPassword" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier of the AWS Managed Microsoft AD or Simple AD directory in which the user resides.

" - }, - "UserName":{ - "shape":"CustomerUserName", - "documentation":"

The username of the user whose password will be reset.

" - }, - "NewPassword":{ - "shape":"UserPassword", - "documentation":"

The new password that will be reset.

" - } - } - }, - "ResetUserPasswordResult":{ - "type":"structure", - "members":{ - } - }, - "ResourceId":{ - "type":"string", - "pattern":"^[d]-[0-9a-f]{10}$" - }, - "RestoreFromSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The identifier of the snapshot to restore from.

" - } - }, - "documentation":"

An object representing the inputs for the RestoreFromSnapshot operation.

" - }, - "RestoreFromSnapshotResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the RestoreFromSnapshot operation.

" - }, - "SID":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[&\\w+-.@]+" - }, - "SchemaExtensionId":{ - "type":"string", - "pattern":"^e-[0-9a-f]{10}$" - }, - "SchemaExtensionInfo":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory to which the schema extension is applied.

" - }, - "SchemaExtensionId":{ - "shape":"SchemaExtensionId", - "documentation":"

The identifier of the schema extension.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the schema extension.

" - }, - "SchemaExtensionStatus":{ - "shape":"SchemaExtensionStatus", - "documentation":"

The current status of the schema extension.

" - }, - "SchemaExtensionStatusReason":{ - "shape":"SchemaExtensionStatusReason", - "documentation":"

The reason for the SchemaExtensionStatus.

" - }, - "StartDateTime":{ - "shape":"StartDateTime", - "documentation":"

The date and time that the schema extension started being applied to the directory.

" - }, - "EndDateTime":{ - "shape":"EndDateTime", - "documentation":"

The date and time that the schema extension was completed.

" - } - }, - "documentation":"

Information about a schema extension.

" - }, - "SchemaExtensionStatus":{ - "type":"string", - "enum":[ - "Initializing", - "CreatingSnapshot", - "UpdatingSchema", - "Replicating", - "CancelInProgress", - "RollbackInProgress", - "Cancelled", - "Failed", - "Completed" - ] - }, - "SchemaExtensionStatusReason":{"type":"string"}, - "SchemaExtensionsInfo":{ - "type":"list", - "member":{"shape":"SchemaExtensionInfo"} - }, - "SecurityGroupId":{ - "type":"string", - "pattern":"^(sg-[0-9a-f]{8}|sg-[0-9a-f]{17})$" - }, - "Server":{ - "type":"string", - "max":256, - "min":1 - }, - "Servers":{ - "type":"list", - "member":{"shape":"Server"} - }, - "ServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

An exception has occurred in AWS Directory Service.

", - "exception":true, - "fault":true - }, - "Snapshot":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory identifier.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The snapshot identifier.

" - }, - "Type":{ - "shape":"SnapshotType", - "documentation":"

The snapshot type.

" - }, - "Name":{ - "shape":"SnapshotName", - "documentation":"

The descriptive name of the snapshot.

" - }, - "Status":{ - "shape":"SnapshotStatus", - "documentation":"

The snapshot status.

" - }, - "StartTime":{ - "shape":"StartTime", - "documentation":"

The date and time that the snapshot was taken.

" - } - }, - "documentation":"

Describes a directory snapshot.

" - }, - "SnapshotId":{ - "type":"string", - "pattern":"^s-[0-9a-f]{10}$" - }, - "SnapshotIds":{ - "type":"list", - "member":{"shape":"SnapshotId"}, - "documentation":"

A list of directory snapshot identifiers.

" - }, - "SnapshotLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The maximum number of manual snapshots for the directory has been reached. You can use the GetSnapshotLimits operation to determine the snapshot limits for a directory.

", - "exception":true - }, - "SnapshotLimits":{ - "type":"structure", - "members":{ - "ManualSnapshotsLimit":{ - "shape":"Limit", - "documentation":"

The maximum number of manual snapshots allowed.

" - }, - "ManualSnapshotsCurrentCount":{ - "shape":"Limit", - "documentation":"

The current number of manual snapshots of the directory.

" - }, - "ManualSnapshotsLimitReached":{ - "shape":"ManualSnapshotsLimitReached", - "documentation":"

Indicates if the manual snapshot limit has been reached.

" - } - }, - "documentation":"

Contains manual snapshot limit information for a directory.

" - }, - "SnapshotName":{ - "type":"string", - "max":128, - "min":0, - "pattern":"^([a-zA-Z0-9_])[\\\\a-zA-Z0-9_@#%*+=:?./!\\s-]*$" - }, - "SnapshotStatus":{ - "type":"string", - "enum":[ - "Creating", - "Completed", - "Failed" - ] - }, - "SnapshotType":{ - "type":"string", - "enum":[ - "Auto", - "Manual" - ] - }, - "Snapshots":{ - "type":"list", - "member":{"shape":"Snapshot"}, - "documentation":"

A list of descriptions of directory snapshots.

" - }, - "SsoEnabled":{"type":"boolean"}, - "StageReason":{"type":"string"}, - "StartDateTime":{"type":"timestamp"}, - "StartSchemaExtensionRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "CreateSnapshotBeforeSchemaExtension", - "LdifContent", - "Description" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which the schema extension will be applied to.

" - }, - "CreateSnapshotBeforeSchemaExtension":{ - "shape":"CreateSnapshotBeforeSchemaExtension", - "documentation":"

If true, creates a snapshot of the directory before applying the schema extension.

" - }, - "LdifContent":{ - "shape":"LdifContent", - "documentation":"

The LDIF file represented as a string. To construct the LdifContent string, precede each line as it would be formatted in an ldif file with \\n. See the example request below for more details. The file size can be no larger than 1MB.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the schema extension.

" - } - } - }, - "StartSchemaExtensionResult":{ - "type":"structure", - "members":{ - "SchemaExtensionId":{ - "shape":"SchemaExtensionId", - "documentation":"

The identifier of the schema extension that will be applied.

" - } - } - }, - "StartTime":{"type":"timestamp"}, - "StateLastUpdatedDateTime":{"type":"timestamp"}, - "SubnetId":{ - "type":"string", - "pattern":"^(subnet-[0-9a-f]{8}|subnet-[0-9a-f]{17})$" - }, - "SubnetIds":{ - "type":"list", - "member":{"shape":"SubnetId"} - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

Required name of the tag. The string value can be Unicode characters and cannot be prefixed with \"aws:\". The string can contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The optional value of the tag. The string value can be Unicode characters. The string can contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - } - }, - "documentation":"

Metadata assigned to a directory consisting of a key-value pair.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The maximum allowed number of tags was exceeded.

", - "exception":true - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TopicArn":{"type":"string"}, - "TopicName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "TopicNames":{ - "type":"list", - "member":{"shape":"TopicName"} - }, - "TopicStatus":{ - "type":"string", - "enum":[ - "Registered", - "Topic not found", - "Failed", - "Deleted" - ] - }, - "Trust":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The Directory ID of the AWS directory involved in the trust relationship.

" - }, - "TrustId":{ - "shape":"TrustId", - "documentation":"

The unique ID of the trust relationship.

" - }, - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The Fully Qualified Domain Name (FQDN) of the external domain involved in the trust relationship.

" - }, - "TrustType":{ - "shape":"TrustType", - "documentation":"

The trust relationship type.

" - }, - "TrustDirection":{ - "shape":"TrustDirection", - "documentation":"

The trust relationship direction.

" - }, - "TrustState":{ - "shape":"TrustState", - "documentation":"

The trust relationship state.

" - }, - "CreatedDateTime":{ - "shape":"CreatedDateTime", - "documentation":"

The date and time that the trust relationship was created.

" - }, - "LastUpdatedDateTime":{ - "shape":"LastUpdatedDateTime", - "documentation":"

The date and time that the trust relationship was last updated.

" - }, - "StateLastUpdatedDateTime":{ - "shape":"StateLastUpdatedDateTime", - "documentation":"

The date and time that the TrustState was last updated.

" - }, - "TrustStateReason":{ - "shape":"TrustStateReason", - "documentation":"

The reason for the TrustState.

" - } - }, - "documentation":"

Describes a trust relationship between an Microsoft AD in the AWS cloud and an external domain.

" - }, - "TrustDirection":{ - "type":"string", - "enum":[ - "One-Way: Outgoing", - "One-Way: Incoming", - "Two-Way" - ] - }, - "TrustId":{ - "type":"string", - "pattern":"^t-[0-9a-f]{10}$" - }, - "TrustIds":{ - "type":"list", - "member":{"shape":"TrustId"} - }, - "TrustPassword":{ - "type":"string", - "max":128, - "min":1, - "sensitive":true - }, - "TrustState":{ - "type":"string", - "enum":[ - "Creating", - "Created", - "Verifying", - "VerifyFailed", - "Verified", - "Deleting", - "Deleted", - "Failed" - ] - }, - "TrustStateReason":{"type":"string"}, - "TrustType":{ - "type":"string", - "enum":["Forest"] - }, - "Trusts":{ - "type":"list", - "member":{"shape":"Trust"} - }, - "UnsupportedOperationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The operation is not supported.

", - "exception":true - }, - "UpdateConditionalForwarderRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RemoteDomainName", - "DnsIpAddrs" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory ID of the AWS directory for which to update the conditional forwarder.

" - }, - "RemoteDomainName":{ - "shape":"RemoteDomainName", - "documentation":"

The fully qualified domain name (FQDN) of the remote domain with which you will set up a trust relationship.

" - }, - "DnsIpAddrs":{ - "shape":"DnsIpAddrs", - "documentation":"

The updated IP addresses of the remote DNS server associated with the conditional forwarder.

" - } - }, - "documentation":"

Updates a conditional forwarder.

" - }, - "UpdateConditionalForwarderResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

The result of an UpdateConditionalForwarder request.

" - }, - "UpdateNumberOfDomainControllersRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "DesiredNumber" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

Identifier of the directory to which the domain controllers will be added or removed.

" - }, - "DesiredNumber":{ - "shape":"DesiredNumberOfDomainControllers", - "documentation":"

The number of domain controllers desired in the directory.

" - } - } - }, - "UpdateNumberOfDomainControllersResult":{ - "type":"structure", - "members":{ - } - }, - "UpdateRadiusRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "RadiusSettings" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the directory for which to update the RADIUS server information.

" - }, - "RadiusSettings":{ - "shape":"RadiusSettings", - "documentation":"

A RadiusSettings object that contains information about the RADIUS server.

" - } - }, - "documentation":"

Contains the inputs for the UpdateRadius operation.

" - }, - "UpdateRadiusResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the results of the UpdateRadius operation.

" - }, - "UpdateSecurityGroupForDirectoryControllers":{"type":"boolean"}, - "UseSameUsername":{"type":"boolean"}, - "UserDoesNotExistException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "RequestId":{"shape":"RequestId"} - }, - "documentation":"

The user provided a username that does not exist in your directory.

", - "exception":true - }, - "UserName":{ - "type":"string", - "min":1, - "pattern":"[a-zA-Z0-9._-]+" - }, - "UserPassword":{ - "type":"string", - "max":127, - "min":1, - "sensitive":true - }, - "VerifyTrustRequest":{ - "type":"structure", - "required":["TrustId"], - "members":{ - "TrustId":{ - "shape":"TrustId", - "documentation":"

The unique Trust ID of the trust relationship to verify.

" - } - }, - "documentation":"

Initiates the verification of an existing trust relationship between a Microsoft AD in the AWS cloud and an external domain.

" - }, - "VerifyTrustResult":{ - "type":"structure", - "members":{ - "TrustId":{ - "shape":"TrustId", - "documentation":"

The unique Trust ID of the trust relationship that was verified.

" - } - }, - "documentation":"

Result of a VerifyTrust request.

" - }, - "VpcId":{ - "type":"string", - "pattern":"^(vpc-[0-9a-f]{8}|vpc-[0-9a-f]{17})$" - } - }, - "documentation":"AWS Directory Service

AWS Directory Service is a web service that makes it easy for you to setup and run directories in the AWS cloud, or connect your AWS resources with an existing on-premises Microsoft Active Directory. This guide provides detailed information about AWS Directory Service operations, data types, parameters, and errors. For information about AWS Directory Services features, see AWS Directory Service and the AWS Directory Service Administration Guide.

AWS provides SDKs that consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .Net, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to AWS Directory Service and other AWS services. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/examples-1.json deleted file mode 100644 index e66e704b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/examples-1.json +++ /dev/null @@ -1,628 +0,0 @@ -{ - "version": "1.0", - "examples": { - "BatchGetItem": [ - { - "input": { - "RequestItems": { - "Music": { - "Keys": [ - { - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Call Me Today" - } - }, - { - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - }, - { - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Scared of My Shadow" - } - } - ], - "ProjectionExpression": "AlbumTitle" - } - } - }, - "output": { - "Responses": { - "Music": [ - { - "AlbumTitle": { - "S": "Somewhat Famous" - } - }, - { - "AlbumTitle": { - "S": "Blue Sky Blues" - } - }, - { - "AlbumTitle": { - "S": "Louder Than Ever" - } - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example reads multiple items from the Music table using a batch of three GetItem requests. Only the AlbumTitle attribute is returned.", - "id": "to-retrieve-multiple-items-from-a-table-1476118438992", - "title": "To retrieve multiple items from a table" - } - ], - "BatchWriteItem": [ - { - "input": { - "RequestItems": { - "Music": [ - { - "PutRequest": { - "Item": { - "AlbumTitle": { - "S": "Somewhat Famous" - }, - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Call Me Today" - } - } - } - }, - { - "PutRequest": { - "Item": { - "AlbumTitle": { - "S": "Songs About Life" - }, - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - } - } - }, - { - "PutRequest": { - "Item": { - "AlbumTitle": { - "S": "Blue Sky Blues" - }, - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Scared of My Shadow" - } - } - } - } - ] - } - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds three new items to the Music table using a batch of three PutItem requests.", - "id": "to-add-multiple-items-to-a-table-1476118519747", - "title": "To add multiple items to a table" - } - ], - "CreateTable": [ - { - "input": { - "AttributeDefinitions": [ - { - "AttributeName": "Artist", - "AttributeType": "S" - }, - { - "AttributeName": "SongTitle", - "AttributeType": "S" - } - ], - "KeySchema": [ - { - "AttributeName": "Artist", - "KeyType": "HASH" - }, - { - "AttributeName": "SongTitle", - "KeyType": "RANGE" - } - ], - "ProvisionedThroughput": { - "ReadCapacityUnits": 5, - "WriteCapacityUnits": 5 - }, - "TableName": "Music" - }, - "output": { - "TableDescription": { - "AttributeDefinitions": [ - { - "AttributeName": "Artist", - "AttributeType": "S" - }, - { - "AttributeName": "SongTitle", - "AttributeType": "S" - } - ], - "CreationDateTime": "1421866952.062", - "ItemCount": 0, - "KeySchema": [ - { - "AttributeName": "Artist", - "KeyType": "HASH" - }, - { - "AttributeName": "SongTitle", - "KeyType": "RANGE" - } - ], - "ProvisionedThroughput": { - "ReadCapacityUnits": 5, - "WriteCapacityUnits": 5 - }, - "TableName": "Music", - "TableSizeBytes": 0, - "TableStatus": "CREATING" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a table named Music.", - "id": "to-create-a-table-1476116291743", - "title": "To create a table" - } - ], - "DeleteItem": [ - { - "input": { - "Key": { - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Scared of My Shadow" - } - }, - "TableName": "Music" - }, - "output": { - "ConsumedCapacity": { - "CapacityUnits": 1, - "TableName": "Music" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes an item from the Music table.", - "id": "to-delete-an-item-1475884573758", - "title": "To delete an item" - } - ], - "DeleteTable": [ - { - "input": { - "TableName": "Music" - }, - "output": { - "TableDescription": { - "ItemCount": 0, - "ProvisionedThroughput": { - "NumberOfDecreasesToday": 1, - "ReadCapacityUnits": 5, - "WriteCapacityUnits": 5 - }, - "TableName": "Music", - "TableSizeBytes": 0, - "TableStatus": "DELETING" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the Music table.", - "id": "to-delete-a-table-1475884368755", - "title": "To delete a table" - } - ], - "DescribeLimits": [ - { - "input": { - }, - "output": { - "AccountMaxReadCapacityUnits": 20000, - "AccountMaxWriteCapacityUnits": 20000, - "TableMaxReadCapacityUnits": 10000, - "TableMaxWriteCapacityUnits": 10000 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the maximum read and write capacity units per table, and for the AWS account, in the current AWS region.", - "id": "to-determine-capacity-limits-per-table-and-account-in-the-current-aws-region-1475884162064", - "title": "To determine capacity limits per table and account, in the current AWS region" - } - ], - "DescribeTable": [ - { - "input": { - "TableName": "Music" - }, - "output": { - "Table": { - "AttributeDefinitions": [ - { - "AttributeName": "Artist", - "AttributeType": "S" - }, - { - "AttributeName": "SongTitle", - "AttributeType": "S" - } - ], - "CreationDateTime": "1421866952.062", - "ItemCount": 0, - "KeySchema": [ - { - "AttributeName": "Artist", - "KeyType": "HASH" - }, - { - "AttributeName": "SongTitle", - "KeyType": "RANGE" - } - ], - "ProvisionedThroughput": { - "NumberOfDecreasesToday": 1, - "ReadCapacityUnits": 5, - "WriteCapacityUnits": 5 - }, - "TableName": "Music", - "TableSizeBytes": 0, - "TableStatus": "ACTIVE" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Music table.", - "id": "to-describe-a-table-1475884440502", - "title": "To describe a table" - } - ], - "GetItem": [ - { - "input": { - "Key": { - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - }, - "TableName": "Music" - }, - "output": { - "Item": { - "AlbumTitle": { - "S": "Songs About Life" - }, - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example retrieves an item from the Music table. The table has a partition key and a sort key (Artist and SongTitle), so you must specify both of these attributes.", - "id": "to-read-an-item-from-a-table-1475884258350", - "title": "To read an item from a table" - } - ], - "ListTables": [ - { - "input": { - }, - "output": { - "TableNames": [ - "Forum", - "ProductCatalog", - "Reply", - "Thread" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of the tables associated with the current AWS account and endpoint.", - "id": "to-list-tables-1475884741238", - "title": "To list tables" - } - ], - "PutItem": [ - { - "input": { - "Item": { - "AlbumTitle": { - "S": "Somewhat Famous" - }, - "Artist": { - "S": "No One You Know" - }, - "SongTitle": { - "S": "Call Me Today" - } - }, - "ReturnConsumedCapacity": "TOTAL", - "TableName": "Music" - }, - "output": { - "ConsumedCapacity": { - "CapacityUnits": 1, - "TableName": "Music" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds a new item to the Music table.", - "id": "to-add-an-item-to-a-table-1476116191110", - "title": "To add an item to a table" - } - ], - "Query": [ - { - "input": { - "ExpressionAttributeValues": { - ":v1": { - "S": "No One You Know" - } - }, - "KeyConditionExpression": "Artist = :v1", - "ProjectionExpression": "SongTitle", - "TableName": "Music" - }, - "output": { - "ConsumedCapacity": { - }, - "Count": 2, - "Items": [ - { - "SongTitle": { - "S": "Call Me Today" - } - } - ], - "ScannedCount": 2 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example queries items in the Music table. The table has a partition key and sort key (Artist and SongTitle), but this query only specifies the partition key value. It returns song titles by the artist named \"No One You Know\".", - "id": "to-query-an-item-1475883874631", - "title": "To query an item" - } - ], - "Scan": [ - { - "input": { - "ExpressionAttributeNames": { - "AT": "AlbumTitle", - "ST": "SongTitle" - }, - "ExpressionAttributeValues": { - ":a": { - "S": "No One You Know" - } - }, - "FilterExpression": "Artist = :a", - "ProjectionExpression": "#ST, #AT", - "TableName": "Music" - }, - "output": { - "ConsumedCapacity": { - }, - "Count": 2, - "Items": [ - { - "AlbumTitle": { - "S": "Somewhat Famous" - }, - "SongTitle": { - "S": "Call Me Today" - } - }, - { - "AlbumTitle": { - "S": "Blue Sky Blues" - }, - "SongTitle": { - "S": "Scared of My Shadow" - } - } - ], - "ScannedCount": 3 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example scans the entire Music table, and then narrows the results to songs by the artist \"No One You Know\". For each item, only the album title and song title are returned.", - "id": "to-scan-a-table-1475883652470", - "title": "To scan a table" - } - ], - "UpdateItem": [ - { - "input": { - "ExpressionAttributeNames": { - "#AT": "AlbumTitle", - "#Y": "Year" - }, - "ExpressionAttributeValues": { - ":t": { - "S": "Louder Than Ever" - }, - ":y": { - "N": "2015" - } - }, - "Key": { - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - }, - "ReturnValues": "ALL_NEW", - "TableName": "Music", - "UpdateExpression": "SET #Y = :y, #AT = :t" - }, - "output": { - "Attributes": { - "AlbumTitle": { - "S": "Songs About Life" - }, - "Artist": { - "S": "Acme Band" - }, - "SongTitle": { - "S": "Happy Day" - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates an item in the Music table. It adds a new attribute (Year) and modifies the AlbumTitle attribute. All of the attributes in the item, as they appear after the update, are returned in the response.", - "id": "to-update-an-item-in-a-table-1476118250055", - "title": "To update an item in a table" - } - ], - "UpdateTable": [ - { - "input": { - "ProvisionedThroughput": { - "ReadCapacityUnits": 10, - "WriteCapacityUnits": 10 - }, - "TableName": "MusicCollection" - }, - "output": { - "TableDescription": { - "AttributeDefinitions": [ - { - "AttributeName": "Artist", - "AttributeType": "S" - }, - { - "AttributeName": "SongTitle", - "AttributeType": "S" - } - ], - "CreationDateTime": "1421866952.062", - "ItemCount": 0, - "KeySchema": [ - { - "AttributeName": "Artist", - "KeyType": "HASH" - }, - { - "AttributeName": "SongTitle", - "KeyType": "RANGE" - } - ], - "ProvisionedThroughput": { - "LastIncreaseDateTime": "1421874759.194", - "NumberOfDecreasesToday": 1, - "ReadCapacityUnits": 1, - "WriteCapacityUnits": 1 - }, - "TableName": "MusicCollection", - "TableSizeBytes": 0, - "TableStatus": "UPDATING" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example increases the provisioned read and write capacity on the Music table.", - "id": "to-modify-a-tables-provisioned-throughput-1476118076147", - "title": "To modify a table's provisioned throughput" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/paginators-1.json deleted file mode 100644 index b22762c9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/paginators-1.json +++ /dev/null @@ -1,42 +0,0 @@ -{ - "pagination": { - "ListBackups": { - "input_token": "ExclusiveStartBackupArn", - "output_token": "LastEvaluatedBackupArn", - "limit_key": "Limit", - "result_key": "BackupSummaries" - }, - "ListTables": { - "input_token": "ExclusiveStartTableName", - "output_token": "LastEvaluatedTableName", - "limit_key": "Limit", - "result_key": "TableNames" - }, - "Query": { - "input_token": "ExclusiveStartKey", - "output_token": "LastEvaluatedKey", - "limit_key": "Limit", - "result_key": [ - "Items", - "Count", - "ScannedCount" - ], - "non_aggregate_keys": [ - "ConsumedCapacity" - ] - }, - "Scan": { - "input_token": "ExclusiveStartKey", - "output_token": "LastEvaluatedKey", - "limit_key": "Limit", - "result_key": [ - "Items", - "Count", - "ScannedCount" - ], - "non_aggregate_keys": [ - "ConsumedCapacity" - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/service-2.json deleted file mode 100644 index 575000b1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/service-2.json +++ /dev/null @@ -1,3783 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-08-10", - "endpointPrefix":"dynamodb", - "jsonVersion":"1.0", - "protocol":"json", - "serviceAbbreviation":"DynamoDB", - "serviceFullName":"Amazon DynamoDB", - "serviceId":"DynamoDB", - "signatureVersion":"v4", - "targetPrefix":"DynamoDB_20120810", - "uid":"dynamodb-2012-08-10" - }, - "operations":{ - "BatchGetItem":{ - "name":"BatchGetItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetItemInput"}, - "output":{"shape":"BatchGetItemOutput"}, - "errors":[ - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key.

A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem will return a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys. You can use this value to retry the operation starting with the next item to get.

If you request more than 100 items BatchGetItem will return a ValidationException with the message \"Too many items requested for the BatchGetItem call\".

For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one data set.

If none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchGetItem will return a ProvisionedThroughputExceededException. If at least one of the items is successfully processed, then BatchGetItem completes successfully, while returning the keys of the unread items in UnprocessedKeys.

If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed.

For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide.

By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables.

In order to minimize response latency, BatchGetItem retrieves items in parallel.

When designing your application, keep in mind that DynamoDB does not return items in any particular order. To help parse the response by item, include the primary key values for the items in your request in the ProjectionExpression parameter.

If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Capacity Units Calculations in the Amazon DynamoDB Developer Guide.

" - }, - "BatchWriteItem":{ - "name":"BatchWriteItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchWriteItemInput"}, - "output":{"shape":"BatchWriteItemOutput"}, - "errors":[ - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ItemCollectionSizeLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 16 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 400 KB.

BatchWriteItem cannot update items. To update items, use the UpdateItem action.

The individual PutItem and DeleteItem operations specified in BatchWriteItem are atomic; however BatchWriteItem as a whole is not. If any requested operations fail because the table's provisioned throughput is exceeded or an internal processing failure occurs, the failed operations are returned in the UnprocessedItems response parameter. You can investigate and optionally resend the requests. Typically, you would call BatchWriteItem in a loop. Each iteration would check for unprocessed items and submit a new BatchWriteItem request with those unprocessed items until all items have been processed.

Note that if none of the items can be processed due to insufficient provisioned throughput on all of the tables in the request, then BatchWriteItem will return a ProvisionedThroughputExceededException.

If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If you delay the batch operation using exponential backoff, the individual requests in the batch are much more likely to succeed.

For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide.

With BatchWriteItem, you can efficiently write or delete large amounts of data, such as from Amazon Elastic MapReduce (EMR), or copy data from another database into DynamoDB. In order to improve performance with these large-scale operations, BatchWriteItem does not behave in the same way as individual PutItem and DeleteItem calls would. For example, you cannot specify conditions on individual put and delete requests, and BatchWriteItem does not return deleted items in the response.

If you use a programming language that supports concurrency, you can use threads to write items in parallel. Your application must include the necessary logic to manage the threads. With languages that don't support threading, you must update or delete the specified items one at a time. In both situations, BatchWriteItem performs the specified put and delete operations in parallel, giving you the power of the thread pool approach without having to introduce complexity into your application.

Parallel processing reduces latency, but each specified put and delete request consumes the same number of write capacity units whether it is processed in parallel or not. Delete operations on nonexistent items consume one write capacity unit.

If one or more of the following is true, DynamoDB rejects the entire batch write operation:

  • One or more tables specified in the BatchWriteItem request does not exist.

  • Primary key attributes specified on an item in the request do not match those in the corresponding table's primary key schema.

  • You try to perform multiple operations on the same item in the same BatchWriteItem request. For example, you cannot put and delete the same item in the same BatchWriteItem request.

  • Your request contains at least two items with identical hash and range keys (which essentially is two put operations).

  • There are more than 25 requests in the batch.

  • Any individual item in a batch exceeds 400 KB.

  • The total request size exceeds 16 MB.

" - }, - "CreateBackup":{ - "name":"CreateBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBackupInput"}, - "output":{"shape":"CreateBackupOutput"}, - "errors":[ - {"shape":"TableNotFoundException"}, - {"shape":"TableInUseException"}, - {"shape":"ContinuousBackupsUnavailableException"}, - {"shape":"BackupInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a backup for an existing table.

Each time you create an On-Demand Backup, the entire table data is backed up. There is no limit to the number of on-demand backups that can be taken.

When you create an On-Demand Backup, a time marker of the request is cataloged, and the backup is created asynchronously, by applying all changes until the time of the request to the last full table snapshot. Backup requests are processed instantaneously and become available for restore within minutes.

You can call CreateBackup at a maximum rate of 50 times per second.

All backups in DynamoDB work without consuming any provisioned throughput on the table.

If you submit a backup request on 2018-12-14 at 14:25:00, the backup is guaranteed to contain all data committed to the table up to 14:24:00, and data committed after 14:26:00 will not be. The backup may or may not contain data modifications made between 14:24:00 and 14:26:00. On-Demand Backup does not support causal consistency.

Along with data, the following are also included on the backups:

  • Global secondary indexes (GSIs)

  • Local secondary indexes (LSIs)

  • Streams

  • Provisioned read and write capacity

" - }, - "CreateGlobalTable":{ - "name":"CreateGlobalTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGlobalTableInput"}, - "output":{"shape":"CreateGlobalTableOutput"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"}, - {"shape":"GlobalTableAlreadyExistsException"}, - {"shape":"TableNotFoundException"} - ], - "documentation":"

Creates a global table from an existing table. A global table creates a replication relationship between two or more DynamoDB tables with the same table name in the provided regions.

If you want to add a new replica table to a global table, each of the following conditions must be true:

  • The table must have the same primary key as all of the other replicas.

  • The table must have the same name as all of the other replicas.

  • The table must have DynamoDB Streams enabled, with the stream containing both the new and the old images of the item.

  • None of the replica tables in the global table can contain any data.

If global secondary indexes are specified, then the following conditions must also be met:

  • The global secondary indexes must have the same name.

  • The global secondary indexes must have the same hash key and sort key (if present).

Write capacity settings should be set consistently across your replica tables and secondary indexes. DynamoDB strongly recommends enabling auto scaling to manage the write capacity settings for all of your global tables replicas and indexes.

If you prefer to manage write capacity settings manually, you should provision equal replicated write capacity units to your replica tables. You should also provision equal replicated write capacity units to matching secondary indexes across your global table.

" - }, - "CreateTable":{ - "name":"CreateTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTableInput"}, - "output":{"shape":"CreateTableOutput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The CreateTable operation adds a new table to your account. In an AWS account, table names must be unique within each region. That is, you can have two tables with same name if you create the tables in different regions.

CreateTable is an asynchronous operation. Upon receiving a CreateTable request, DynamoDB immediately returns a response with a TableStatus of CREATING. After the table is created, DynamoDB sets the TableStatus to ACTIVE. You can perform read and write operations only on an ACTIVE table.

You can optionally define secondary indexes on the new table, as part of the CreateTable operation. If you want to create multiple tables with secondary indexes on them, you must create the tables sequentially. Only one table with secondary indexes can be in the CREATING state at any given time.

You can use the DescribeTable action to check the table status.

" - }, - "DeleteBackup":{ - "name":"DeleteBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBackupInput"}, - "output":{"shape":"DeleteBackupOutput"}, - "errors":[ - {"shape":"BackupNotFoundException"}, - {"shape":"BackupInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes an existing backup of a table.

You can call DeleteBackup at a maximum rate of 10 times per second.

" - }, - "DeleteItem":{ - "name":"DeleteItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteItemInput"}, - "output":{"shape":"DeleteItemOutput"}, - "errors":[ - {"shape":"ConditionalCheckFailedException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ItemCollectionSizeLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

In addition to deleting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times on the same item or attribute does not result in an error response.

Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are met, DynamoDB performs the delete. Otherwise, the item is not deleted.

" - }, - "DeleteTable":{ - "name":"DeleteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTableInput"}, - "output":{"shape":"DeleteTableOutput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The DeleteTable operation deletes a table and all of its items. After a DeleteTable request, the specified table is in the DELETING state until DynamoDB completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is in CREATING or UPDATING states, then DynamoDB returns a ResourceInUseException. If the specified table does not exist, DynamoDB returns a ResourceNotFoundException. If table is already in the DELETING state, no error is returned.

DynamoDB might continue to accept data read and write operations, such as GetItem and PutItem, on a table in the DELETING state until the table deletion is complete.

When you delete a table, any indexes on that table are also deleted.

If you have DynamoDB Streams enabled on the table, then the corresponding stream on that table goes into the DISABLED state, and the stream is automatically deleted after 24 hours.

Use the DescribeTable action to check the status of the table.

" - }, - "DescribeBackup":{ - "name":"DescribeBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBackupInput"}, - "output":{"shape":"DescribeBackupOutput"}, - "errors":[ - {"shape":"BackupNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Describes an existing backup of a table.

You can call DescribeBackup at a maximum rate of 10 times per second.

" - }, - "DescribeContinuousBackups":{ - "name":"DescribeContinuousBackups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeContinuousBackupsInput"}, - "output":{"shape":"DescribeContinuousBackupsOutput"}, - "errors":[ - {"shape":"TableNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Checks the status of continuous backups and point in time recovery on the specified table. Continuous backups are ENABLED on all tables at table creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.

Once continuous backups and point in time recovery are enabled, you can restore to any point in time within EarliestRestorableDateTime and LatestRestorableDateTime.

LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table to any point in time during the last 35 days.

You can call DescribeContinuousBackups at a maximum rate of 10 times per second.

" - }, - "DescribeGlobalTable":{ - "name":"DescribeGlobalTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGlobalTableInput"}, - "output":{"shape":"DescribeGlobalTableOutput"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"GlobalTableNotFoundException"} - ], - "documentation":"

Returns information about the specified global table.

" - }, - "DescribeGlobalTableSettings":{ - "name":"DescribeGlobalTableSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGlobalTableSettingsInput"}, - "output":{"shape":"DescribeGlobalTableSettingsOutput"}, - "errors":[ - {"shape":"GlobalTableNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Describes region specific settings for a global table.

" - }, - "DescribeLimits":{ - "name":"DescribeLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLimitsInput"}, - "output":{"shape":"DescribeLimitsOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the current provisioned-capacity limits for your AWS account in a region, both for the region as a whole and for any one DynamoDB table that you create there.

When you establish an AWS account, the account has initial limits on the maximum read capacity units and write capacity units that you can provision across all of your DynamoDB tables in a given region. Also, there are per-table limits that apply when you create a table there. For more information, see Limits page in the Amazon DynamoDB Developer Guide.

Although you can increase these limits by filing a case at AWS Support Center, obtaining the increase is not instantaneous. The DescribeLimits action lets you write code to compare the capacity you are currently using to those limits imposed by your account so that you have enough time to apply for an increase before you hit a limit.

For example, you could use one of the AWS SDKs to do the following:

  1. Call DescribeLimits for a particular region to obtain your current account limits on provisioned capacity there.

  2. Create a variable to hold the aggregate read capacity units provisioned for all your tables in that region, and one to hold the aggregate write capacity units. Zero them both.

  3. Call ListTables to obtain a list of all your DynamoDB tables.

  4. For each table name listed by ListTables, do the following:

    • Call DescribeTable with the table name.

    • Use the data returned by DescribeTable to add the read capacity units and write capacity units provisioned for the table itself to your variables.

    • If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned capacity values to your variables as well.

  5. Report the account limits for that region returned by DescribeLimits, along with the total current provisioned capacity levels you have calculated.

This will let you see whether you are getting close to your account-level limits.

The per-table limits apply only when you are creating a new table. They restrict the sum of the provisioned capacity of the new table itself and all its global secondary indexes.

For existing tables and their GSIs, DynamoDB will not let you increase provisioned capacity extremely rapidly, but the only upper limit that applies is that the aggregate provisioned capacity over all your tables and GSIs cannot exceed either of the per-account limits.

DescribeLimits should only be called periodically. You can expect throttling errors if you call it more than once in a minute.

The DescribeLimits Request element has no content.

" - }, - "DescribeTable":{ - "name":"DescribeTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTableInput"}, - "output":{"shape":"DescribeTableOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about the table, including the current status of the table, when it was created, the primary key schema, and any indexes on the table.

If you issue a DescribeTable request immediately after a CreateTable request, DynamoDB might return a ResourceNotFoundException. This is because DescribeTable uses an eventually consistent query, and the metadata for your table might not be available at that moment. Wait for a few seconds, and then try the DescribeTable request again.

" - }, - "DescribeTimeToLive":{ - "name":"DescribeTimeToLive", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTimeToLiveInput"}, - "output":{"shape":"DescribeTimeToLiveOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gives a description of the Time to Live (TTL) status on the specified table.

" - }, - "GetItem":{ - "name":"GetItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetItemInput"}, - "output":{"shape":"GetItemOutput"}, - "errors":[ - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The GetItem operation returns a set of attributes for the item with the given primary key. If there is no matching item, GetItem does not return any data and there will be no Item element in the response.

GetItem provides an eventually consistent read by default. If your application requires a strongly consistent read, set ConsistentRead to true. Although a strongly consistent read might take more time than an eventually consistent read, it always returns the last updated value.

" - }, - "ListBackups":{ - "name":"ListBackups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBackupsInput"}, - "output":{"shape":"ListBackupsOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

List backups associated with an AWS account. To list backups for a given table, specify TableName. ListBackups returns a paginated list of results with at most 1MB worth of items in a page. You can also specify a limit for the maximum number of entries to be returned in a page.

In the request, start time is inclusive but end time is exclusive. Note that these limits are for the time at which the original backup was requested.

You can call ListBackups a maximum of 5 times per second.

" - }, - "ListGlobalTables":{ - "name":"ListGlobalTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGlobalTablesInput"}, - "output":{"shape":"ListGlobalTablesOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists all global tables that have a replica in the specified region.

" - }, - "ListTables":{ - "name":"ListTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTablesInput"}, - "output":{"shape":"ListTablesOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns an array of table names associated with the current account and endpoint. The output from ListTables is paginated, with each page returning a maximum of 100 table names.

" - }, - "ListTagsOfResource":{ - "name":"ListTagsOfResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsOfResourceInput"}, - "output":{"shape":"ListTagsOfResourceOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

List all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource up to 10 times per second, per account.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

" - }, - "PutItem":{ - "name":"PutItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutItemInput"}, - "output":{"shape":"PutItemOutput"}, - "errors":[ - {"shape":"ConditionalCheckFailedException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ItemCollectionSizeLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new item already exists in the specified table, the new item completely replaces the existing item. You can perform a conditional put operation (add a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values. You can return the item's attribute values in the same operation, using the ReturnValues parameter.

This topic provides general information about the PutItem API.

For information on how to call the PutItem API using the AWS SDK in specific languages, see the following:

When you add an item, the primary key attribute(s) are the only required attributes. Attribute values cannot be null. String and Binary type attributes must have lengths greater than zero. Set type attributes cannot be empty. Requests with empty values will be rejected with a ValidationException exception.

To prevent a new item from replacing an existing item, use a conditional expression that contains the attribute_not_exists function with the name of the attribute being used as the partition key for the table. Since every record must contain that attribute, the attribute_not_exists function will only succeed if no matching item exists.

For more information about PutItem, see Working with Items in the Amazon DynamoDB Developer Guide.

" - }, - "Query":{ - "name":"Query", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"QueryInput"}, - "output":{"shape":"QueryOutput"}, - "errors":[ - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The Query operation finds items based on primary key values. You can query any table or secondary index that has a composite primary key (a partition key and a sort key).

Use the KeyConditionExpression parameter to provide a specific value for the partition key. The Query operation will return all of the items from the table or index with that partition key value. You can optionally narrow the scope of the Query operation by specifying a sort key value and a comparison operator in KeyConditionExpression. To further refine the Query results, you can optionally provide a FilterExpression. A FilterExpression determines which items within the results should be returned to you. All of the other results are discarded.

A Query operation always returns a result set. If no matching items are found, the result set will be empty. Queries that do not return results consume the minimum number of read capacity units for that type of read operation.

DynamoDB calculates the number of read capacity units consumed based on item size, not on the amount of data that is returned to an application. The number of capacity units consumed will be the same whether you request all of the attributes (the default behavior) or just some of them (using a projection expression). The number will also be the same whether or not you use a FilterExpression.

Query results are always sorted by the sort key value. If the data type of the sort key is Number, the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. By default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter to false.

A single Query operation will read up to the maximum number of items set (if using the Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using FilterExpression. If LastEvaluatedKey is present in the response, you will need to paginate the result set. For more information, see Paginating the Results in the Amazon DynamoDB Developer Guide.

FilterExpression is applied after a Query finishes, but before the results are returned. A FilterExpression cannot contain partition key or sort key attributes. You need to specify those attributes in the KeyConditionExpression.

A Query operation can return an empty result set and a LastEvaluatedKey if all the items read for the page of results are filtered out.

You can query a table, a local secondary index, or a global secondary index. For a query on a table or on a local secondary index, you can set the ConsistentRead parameter to true and obtain a strongly consistent result. Global secondary indexes support eventually consistent reads only, so do not specify ConsistentRead when querying a global secondary index.

" - }, - "RestoreTableFromBackup":{ - "name":"RestoreTableFromBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreTableFromBackupInput"}, - "output":{"shape":"RestoreTableFromBackupOutput"}, - "errors":[ - {"shape":"TableAlreadyExistsException"}, - {"shape":"TableInUseException"}, - {"shape":"BackupNotFoundException"}, - {"shape":"BackupInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a new table from an existing backup. Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

You can call RestoreTableFromBackup at a maximum rate of 10 times per second.

You must manually set up the following on the restored table:

  • Auto scaling policies

  • IAM policies

  • Cloudwatch metrics and alarms

  • Tags

  • Stream settings

  • Time to Live (TTL) settings

" - }, - "RestoreTableToPointInTime":{ - "name":"RestoreTableToPointInTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreTableToPointInTimeInput"}, - "output":{"shape":"RestoreTableToPointInTimeOutput"}, - "errors":[ - {"shape":"TableAlreadyExistsException"}, - {"shape":"TableNotFoundException"}, - {"shape":"TableInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidRestoreTimeException"}, - {"shape":"PointInTimeRecoveryUnavailableException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Restores the specified table to the specified point in time within EarliestRestorableDateTime and LatestRestorableDateTime. You can restore your table to any point in time during the last 35 days. Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

When you restore using point in time recovery, DynamoDB restores your table data to the state based on the selected date and time (day:hour:minute:second) to a new table.

Along with data, the following are also included on the new restored table using point in time recovery:

  • Global secondary indexes (GSIs)

  • Local secondary indexes (LSIs)

  • Provisioned read and write capacity

  • Encryption settings

    All these settings come from the current settings of the source table at the time of restore.

You must manually set up the following on the restored table:

  • Auto scaling policies

  • IAM policies

  • Cloudwatch metrics and alarms

  • Tags

  • Stream settings

  • Time to Live (TTL) settings

  • Point in time recovery settings

" - }, - "Scan":{ - "name":"Scan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScanInput"}, - "output":{"shape":"ScanOutput"}, - "errors":[ - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The Scan operation returns one or more items and item attributes by accessing every item in a table or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression operation.

If the total number of scanned items exceeds the maximum data set size limit of 1 MB, the scan stops and results are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation. The results also include the number of items exceeding the limit. A scan can result in no table data meeting the filter criteria.

A single Scan operation will read up to the maximum number of items set (if using the Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using FilterExpression. If LastEvaluatedKey is present in the response, you will need to paginate the result set. For more information, see Paginating the Results in the Amazon DynamoDB Developer Guide.

Scan operations proceed sequentially; however, for faster performance on a large table or secondary index, applications can request a parallel Scan operation by providing the Segment and TotalSegments parameters. For more information, see Parallel Scan in the Amazon DynamoDB Developer Guide.

Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set might not include the changes to data in the table immediately before the operation began. If you need a consistent copy of the data, as of the time that the Scan begins, you can set the ConsistentRead parameter to true.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceInput"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up to 5 times per second, per account.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceInput"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to 5 times per second, per account.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

" - }, - "UpdateContinuousBackups":{ - "name":"UpdateContinuousBackups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateContinuousBackupsInput"}, - "output":{"shape":"UpdateContinuousBackupsOutput"}, - "errors":[ - {"shape":"TableNotFoundException"}, - {"shape":"ContinuousBackupsUnavailableException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

UpdateContinuousBackups enables or disables point in time recovery for the specified table. A successful UpdateContinuousBackups call returns the current ContinuousBackupsDescription. Continuous backups are ENABLED on all tables at table creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.

Once continuous backups and point in time recovery are enabled, you can restore to any point in time within EarliestRestorableDateTime and LatestRestorableDateTime.

LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table to any point in time during the last 35 days..

" - }, - "UpdateGlobalTable":{ - "name":"UpdateGlobalTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGlobalTableInput"}, - "output":{"shape":"UpdateGlobalTableOutput"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"GlobalTableNotFoundException"}, - {"shape":"ReplicaAlreadyExistsException"}, - {"shape":"ReplicaNotFoundException"}, - {"shape":"TableNotFoundException"} - ], - "documentation":"

Adds or removes replicas in the specified global table. The global table must already exist to be able to use this operation. Any replica to be added must be empty, must have the same name as the global table, must have the same key schema, and must have DynamoDB Streams enabled and must have same provisioned and maximum write capacity units.

Although you can use UpdateGlobalTable to add replicas and remove replicas in a single request, for simplicity we recommend that you issue separate requests for adding or removing replicas.

If global secondary indexes are specified, then the following conditions must also be met:

  • The global secondary indexes must have the same name.

  • The global secondary indexes must have the same hash key and sort key (if present).

  • The global secondary indexes must have the same provisioned and maximum write capacity units.

" - }, - "UpdateGlobalTableSettings":{ - "name":"UpdateGlobalTableSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGlobalTableSettingsInput"}, - "output":{"shape":"UpdateGlobalTableSettingsOutput"}, - "errors":[ - {"shape":"GlobalTableNotFoundException"}, - {"shape":"ReplicaNotFoundException"}, - {"shape":"IndexNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates settings for a global table.

" - }, - "UpdateItem":{ - "name":"UpdateItem", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateItemInput"}, - "output":{"shape":"UpdateItemOutput"}, - "errors":[ - {"shape":"ConditionalCheckFailedException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ItemCollectionSizeLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).

You can also return the item's attribute values in the same UpdateItem operation using the ReturnValues parameter.

" - }, - "UpdateTable":{ - "name":"UpdateTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTableInput"}, - "output":{"shape":"UpdateTableOutput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given table.

You can only perform one of the following operations at once:

  • Modify the provisioned throughput settings of the table.

  • Enable or disable Streams on the table.

  • Remove a global secondary index from the table.

  • Create a new global secondary index on the table. Once the index begins backfilling, you can use UpdateTable to perform other operations.

UpdateTable is an asynchronous operation; while it is executing, the table status changes from ACTIVE to UPDATING. While it is UPDATING, you cannot issue another UpdateTable request. When the table returns to the ACTIVE state, the UpdateTable operation is complete.

" - }, - "UpdateTimeToLive":{ - "name":"UpdateTimeToLive", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTimeToLiveInput"}, - "output":{"shape":"UpdateTimeToLiveOutput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

The UpdateTimeToLive method will enable or disable TTL for the specified table. A successful UpdateTimeToLive call returns the current TimeToLiveSpecification; it may take up to one hour for the change to fully process. Any additional UpdateTimeToLive calls for the same table during this one hour duration result in a ValidationException.

TTL compares the current time in epoch time format to the time stored in the TTL attribute of an item. If the epoch time value stored in the attribute is less than the current time, the item is marked as expired and subsequently deleted.

The epoch time format is the number of seconds elapsed since 12:00:00 AM January 1st, 1970 UTC.

DynamoDB deletes expired items on a best-effort basis to ensure availability of throughput for other data operations.

DynamoDB typically deletes expired items within two days of expiration. The exact duration within which an item gets deleted after expiration is specific to the nature of the workload. Items that have expired and not been deleted will still show up in reads, queries, and scans.

As items are deleted, they are removed from any Local Secondary Index and Global Secondary Index immediately in the same eventually consistent way as a standard delete operation.

For more information, see Time To Live in the Amazon DynamoDB Developer Guide.

" - } - }, - "shapes":{ - "AttributeAction":{ - "type":"string", - "enum":[ - "ADD", - "PUT", - "DELETE" - ] - }, - "AttributeDefinition":{ - "type":"structure", - "required":[ - "AttributeName", - "AttributeType" - ], - "members":{ - "AttributeName":{ - "shape":"KeySchemaAttributeName", - "documentation":"

A name for the attribute.

" - }, - "AttributeType":{ - "shape":"ScalarAttributeType", - "documentation":"

The data type for the attribute, where:

  • S - the attribute is of type String

  • N - the attribute is of type Number

  • B - the attribute is of type Binary

" - } - }, - "documentation":"

Represents an attribute for describing the key schema for the table and indexes.

" - }, - "AttributeDefinitions":{ - "type":"list", - "member":{"shape":"AttributeDefinition"} - }, - "AttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "AttributeName":{ - "type":"string", - "max":65535 - }, - "AttributeNameList":{ - "type":"list", - "member":{"shape":"AttributeName"}, - "min":1 - }, - "AttributeUpdates":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValueUpdate"} - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "S":{ - "shape":"StringAttributeValue", - "documentation":"

An attribute of type String. For example:

\"S\": \"Hello\"

" - }, - "N":{ - "shape":"NumberAttributeValue", - "documentation":"

An attribute of type Number. For example:

\"N\": \"123.45\"

Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

" - }, - "B":{ - "shape":"BinaryAttributeValue", - "documentation":"

An attribute of type Binary. For example:

\"B\": \"dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk\"

" - }, - "SS":{ - "shape":"StringSetAttributeValue", - "documentation":"

An attribute of type String Set. For example:

\"SS\": [\"Giraffe\", \"Hippo\" ,\"Zebra\"]

" - }, - "NS":{ - "shape":"NumberSetAttributeValue", - "documentation":"

An attribute of type Number Set. For example:

\"NS\": [\"42.2\", \"-19\", \"7.5\", \"3.14\"]

Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

" - }, - "BS":{ - "shape":"BinarySetAttributeValue", - "documentation":"

An attribute of type Binary Set. For example:

\"BS\": [\"U3Vubnk=\", \"UmFpbnk=\", \"U25vd3k=\"]

" - }, - "M":{ - "shape":"MapAttributeValue", - "documentation":"

An attribute of type Map. For example:

\"M\": {\"Name\": {\"S\": \"Joe\"}, \"Age\": {\"N\": \"35\"}}

" - }, - "L":{ - "shape":"ListAttributeValue", - "documentation":"

An attribute of type List. For example:

\"L\": [\"Cookies\", \"Coffee\", 3.14159]

" - }, - "NULL":{ - "shape":"NullAttributeValue", - "documentation":"

An attribute of type Null. For example:

\"NULL\": true

" - }, - "BOOL":{ - "shape":"BooleanAttributeValue", - "documentation":"

An attribute of type Boolean. For example:

\"BOOL\": true

" - } - }, - "documentation":"

Represents the data for an attribute.

Each attribute value is described as a name-value pair. The name is the data type, and the value is the data itself.

For more information, see Data Types in the Amazon DynamoDB Developer Guide.

" - }, - "AttributeValueList":{ - "type":"list", - "member":{"shape":"AttributeValue"} - }, - "AttributeValueUpdate":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"AttributeValue", - "documentation":"

Represents the data for an attribute.

Each attribute value is described as a name-value pair. The name is the data type, and the value is the data itself.

For more information, see Data Types in the Amazon DynamoDB Developer Guide.

" - }, - "Action":{ - "shape":"AttributeAction", - "documentation":"

Specifies how to perform the update. Valid values are PUT (default), DELETE, and ADD. The behavior depends on whether the specified primary key already exists in the table.

If an item with the specified Key is found in the table:

  • PUT - Adds the specified attribute to the item. If the attribute already exists, it is replaced by the new value.

  • DELETE - If no value is specified, the attribute and its value are removed from the item. The data type of the specified value must match the existing value's data type.

    If a set of values is specified, then those values are subtracted from the old set. For example, if the attribute value was the set [a,b,c] and the DELETE action specified [a,c], then the final attribute value would be [b]. Specifying an empty set is an error.

  • ADD - If the attribute does not already exist, then the attribute and its values are added to the item. If the attribute does exist, then the behavior of ADD depends on the data type of the attribute:

    • If the existing attribute is a number, and if Value is also a number, then the Value is mathematically added to the existing attribute. If Value is a negative number, then it is subtracted from the existing attribute.

      If you use ADD to increment or decrement a number value for an item that doesn't exist before the update, DynamoDB uses 0 as the initial value.

      In addition, if you use ADD to update an existing item, and intend to increment or decrement an attribute value which does not yet exist, DynamoDB uses 0 as the initial value. For example, suppose that the item you want to update does not yet have an attribute named itemcount, but you decide to ADD the number 3 to this attribute anyway, even though it currently does not exist. DynamoDB will create the itemcount attribute, set its initial value to 0, and finally add 3 to it. The result will be a new itemcount attribute in the item, with a value of 3.

    • If the existing data type is a set, and if the Value is also a set, then the Value is added to the existing set. (This is a set operation, not mathematical addition.) For example, if the attribute value was the set [1,2], and the ADD action specified [3], then the final attribute value would be [1,2,3]. An error occurs if an Add action is specified for a set attribute and the attribute type specified does not match the existing set type.

      Both sets must have the same primitive data type. For example, if the existing data type is a set of strings, the Value must also be a set of strings. The same holds true for number sets and binary sets.

    This action is only valid for an existing attribute whose data type is number or is a set. Do not use ADD for any other data types.

If no item with the specified Key is found:

  • PUT - DynamoDB creates a new item with the specified primary key, and then adds the attribute.

  • DELETE - Nothing happens; there is no attribute to delete.

  • ADD - DynamoDB creates an item with the supplied primary key and number (or set of numbers) for the attribute value. The only data types allowed are number and number set; no other data types can be specified.

" - } - }, - "documentation":"

For the UpdateItem operation, represents the attributes to be modified, the action to perform on each, and the new value for each.

You cannot use UpdateItem to update any primary key attributes. Instead, you will need to delete the item, and then use PutItem to create a new item with new attributes.

Attribute values cannot be null; string and binary type attributes must have lengths greater than zero; and set type attributes must not be empty. Requests with empty values will be rejected with a ValidationException exception.

" - }, - "AutoScalingPolicyDescription":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"AutoScalingPolicyName", - "documentation":"

The name of the scaling policy.

" - }, - "TargetTrackingScalingPolicyConfiguration":{ - "shape":"AutoScalingTargetTrackingScalingPolicyConfigurationDescription", - "documentation":"

Represents a target tracking scaling policy configuration.

" - } - }, - "documentation":"

Represents the properties of the scaling policy.

" - }, - "AutoScalingPolicyDescriptionList":{ - "type":"list", - "member":{"shape":"AutoScalingPolicyDescription"} - }, - "AutoScalingPolicyName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"\\p{Print}+" - }, - "AutoScalingPolicyUpdate":{ - "type":"structure", - "required":["TargetTrackingScalingPolicyConfiguration"], - "members":{ - "PolicyName":{ - "shape":"AutoScalingPolicyName", - "documentation":"

The name of the scaling policy.

" - }, - "TargetTrackingScalingPolicyConfiguration":{ - "shape":"AutoScalingTargetTrackingScalingPolicyConfigurationUpdate", - "documentation":"

Represents a target tracking scaling policy configuration.

" - } - }, - "documentation":"

Represents the autoscaling policy to be modified.

" - }, - "AutoScalingRoleArn":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "AutoScalingSettingsDescription":{ - "type":"structure", - "members":{ - "MinimumUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The minimum capacity units that a global table or global secondary index should be scaled down to.

" - }, - "MaximumUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum capacity units that a global table or global secondary index should be scaled up to.

" - }, - "AutoScalingDisabled":{ - "shape":"BooleanObject", - "documentation":"

Disabled autoscaling for this global table or global secondary index.

" - }, - "AutoScalingRoleArn":{ - "shape":"String", - "documentation":"

Role ARN used for configuring autoScaling policy.

" - }, - "ScalingPolicies":{ - "shape":"AutoScalingPolicyDescriptionList", - "documentation":"

Information about the scaling policies.

" - } - }, - "documentation":"

Represents the autoscaling settings for a global table or global secondary index.

" - }, - "AutoScalingSettingsUpdate":{ - "type":"structure", - "members":{ - "MinimumUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The minimum capacity units that a global table or global secondary index should be scaled down to.

" - }, - "MaximumUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum capacity units that a global table or global secondary index should be scaled up to.

" - }, - "AutoScalingDisabled":{ - "shape":"BooleanObject", - "documentation":"

Disabled autoscaling for this global table or global secondary index.

" - }, - "AutoScalingRoleArn":{ - "shape":"AutoScalingRoleArn", - "documentation":"

Role ARN used for configuring autoscaling policy.

" - }, - "ScalingPolicyUpdate":{ - "shape":"AutoScalingPolicyUpdate", - "documentation":"

The scaling policy to apply for scaling target global table or global secondary index capacity units.

" - } - }, - "documentation":"

Represents the autoscaling settings to be modified for a global table or global secondary index.

" - }, - "AutoScalingTargetTrackingScalingPolicyConfigurationDescription":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "DisableScaleIn":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether scale in by the target tracking policy is disabled. If the value is true, scale in is disabled and the target tracking policy won't remove capacity from the scalable resource. Otherwise, scale in is enabled and the target tracking policy can remove capacity from the scalable resource. The default value is false.

" - }, - "ScaleInCooldown":{ - "shape":"IntegerObject", - "documentation":"

The amount of time, in seconds, after a scale in activity completes before another scale in activity can start. The cooldown period is used to block subsequent scale in requests until it has expired. You should scale in conservatively to protect your application's availability. However, if another alarm triggers a scale out policy during the cooldown period after a scale-in, application autoscaling scales out your scalable target immediately.

" - }, - "ScaleOutCooldown":{ - "shape":"IntegerObject", - "documentation":"

The amount of time, in seconds, after a scale out activity completes before another scale out activity can start. While the cooldown period is in effect, the capacity that has been added by the previous scale out event that initiated the cooldown is calculated as part of the desired capacity for the next scale out. You should continuously (but not excessively) scale out.

" - }, - "TargetValue":{ - "shape":"Double", - "documentation":"

The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2).

" - } - }, - "documentation":"

Represents the properties of a target tracking scaling policy.

" - }, - "AutoScalingTargetTrackingScalingPolicyConfigurationUpdate":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "DisableScaleIn":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether scale in by the target tracking policy is disabled. If the value is true, scale in is disabled and the target tracking policy won't remove capacity from the scalable resource. Otherwise, scale in is enabled and the target tracking policy can remove capacity from the scalable resource. The default value is false.

" - }, - "ScaleInCooldown":{ - "shape":"IntegerObject", - "documentation":"

The amount of time, in seconds, after a scale in activity completes before another scale in activity can start. The cooldown period is used to block subsequent scale in requests until it has expired. You should scale in conservatively to protect your application's availability. However, if another alarm triggers a scale out policy during the cooldown period after a scale-in, application autoscaling scales out your scalable target immediately.

" - }, - "ScaleOutCooldown":{ - "shape":"IntegerObject", - "documentation":"

The amount of time, in seconds, after a scale out activity completes before another scale out activity can start. While the cooldown period is in effect, the capacity that has been added by the previous scale out event that initiated the cooldown is calculated as part of the desired capacity for the next scale out. You should continuously (but not excessively) scale out.

" - }, - "TargetValue":{ - "shape":"Double", - "documentation":"

The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2).

" - } - }, - "documentation":"

Represents the settings of a target tracking scaling policy that will be modified.

" - }, - "Backfilling":{"type":"boolean"}, - "BackupArn":{ - "type":"string", - "max":1024, - "min":37 - }, - "BackupCreationDateTime":{"type":"timestamp"}, - "BackupDescription":{ - "type":"structure", - "members":{ - "BackupDetails":{ - "shape":"BackupDetails", - "documentation":"

Contains the details of the backup created for the table.

" - }, - "SourceTableDetails":{ - "shape":"SourceTableDetails", - "documentation":"

Contains the details of the table when the backup was created.

" - }, - "SourceTableFeatureDetails":{ - "shape":"SourceTableFeatureDetails", - "documentation":"

Contains the details of the features enabled on the table when the backup was created. For example, LSIs, GSIs, streams, TTL.

" - } - }, - "documentation":"

Contains the description of the backup created for the table.

" - }, - "BackupDetails":{ - "type":"structure", - "required":[ - "BackupArn", - "BackupName", - "BackupStatus", - "BackupType", - "BackupCreationDateTime" - ], - "members":{ - "BackupArn":{ - "shape":"BackupArn", - "documentation":"

ARN associated with the backup.

" - }, - "BackupName":{ - "shape":"BackupName", - "documentation":"

Name of the requested backup.

" - }, - "BackupSizeBytes":{ - "shape":"BackupSizeBytes", - "documentation":"

Size of the backup in bytes.

" - }, - "BackupStatus":{ - "shape":"BackupStatus", - "documentation":"

Backup can be in one of the following states: CREATING, ACTIVE, DELETED.

" - }, - "BackupType":{ - "shape":"BackupType", - "documentation":"

BackupType:

  • USER - On demand backup created by you.

  • SYSTEM - On demand backup automatically created by DynamoDB.

" - }, - "BackupCreationDateTime":{ - "shape":"BackupCreationDateTime", - "documentation":"

Time at which the backup was created. This is the request time of the backup.

" - }, - "BackupExpiryDateTime":{ - "shape":"Date", - "documentation":"

Time at which the automatic on demand backup created by DynamoDB will expire. This SYSTEM on demand backup expires automatically 35 days after its creation.

" - } - }, - "documentation":"

Contains the details of the backup created for the table.

" - }, - "BackupInUseException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

There is another ongoing conflicting backup control plane operation on the table. The backups is either being created, deleted or restored to a table.

", - "exception":true - }, - "BackupName":{ - "type":"string", - "max":255, - "min":3, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "BackupNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Backup not found for the given BackupARN.

", - "exception":true - }, - "BackupSizeBytes":{ - "type":"long", - "min":0 - }, - "BackupStatus":{ - "type":"string", - "enum":[ - "CREATING", - "DELETED", - "AVAILABLE" - ] - }, - "BackupSummaries":{ - "type":"list", - "member":{"shape":"BackupSummary"} - }, - "BackupSummary":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

Name of the table.

" - }, - "TableId":{ - "shape":"TableId", - "documentation":"

Unique identifier for the table.

" - }, - "TableArn":{ - "shape":"TableArn", - "documentation":"

ARN associated with the table.

" - }, - "BackupArn":{ - "shape":"BackupArn", - "documentation":"

ARN associated with the backup.

" - }, - "BackupName":{ - "shape":"BackupName", - "documentation":"

Name of the specified backup.

" - }, - "BackupCreationDateTime":{ - "shape":"BackupCreationDateTime", - "documentation":"

Time at which the backup was created.

" - }, - "BackupExpiryDateTime":{ - "shape":"Date", - "documentation":"

Time at which the automatic on demand backup created by DynamoDB will expire. This SYSTEM on demand backup expires automatically 35 days after its creation.

" - }, - "BackupStatus":{ - "shape":"BackupStatus", - "documentation":"

Backup can be in one of the following states: CREATING, ACTIVE, DELETED.

" - }, - "BackupType":{ - "shape":"BackupType", - "documentation":"

BackupType:

  • USER - On demand backup created by you.

  • SYSTEM - On demand backup automatically created by DynamoDB.

" - }, - "BackupSizeBytes":{ - "shape":"BackupSizeBytes", - "documentation":"

Size of the backup in bytes.

" - } - }, - "documentation":"

Contains details for the backup.

" - }, - "BackupType":{ - "type":"string", - "enum":[ - "USER", - "SYSTEM" - ] - }, - "BackupTypeFilter":{ - "type":"string", - "enum":[ - "USER", - "SYSTEM", - "ALL" - ] - }, - "BackupsInputLimit":{ - "type":"integer", - "max":100, - "min":1 - }, - "BatchGetItemInput":{ - "type":"structure", - "required":["RequestItems"], - "members":{ - "RequestItems":{ - "shape":"BatchGetRequestMap", - "documentation":"

A map of one or more table names and, for each table, a map that describes one or more items to retrieve from that table. Each table name can be used only once per BatchGetItem request.

Each element in the map of items to retrieve consists of the following:

  • ConsistentRead - If true, a strongly consistent read is used; if false (the default), an eventually consistent read is used.

  • ExpressionAttributeNames - One or more substitution tokens for attribute names in the ProjectionExpression parameter. The following are some use cases for using ExpressionAttributeNames:

    • To access an attribute whose name conflicts with a DynamoDB reserved word.

    • To create a placeholder for repeating occurrences of an attribute name in an expression.

    • To prevent special characters in an attribute name from being misinterpreted in an expression.

    Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

    • Percentile

    The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

    • {\"#P\":\"Percentile\"}

    You could then use this substitution in an expression, as in this example:

    • #P = :val

    Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

    For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

  • Keys - An array of primary key attribute values that define specific items in the table. For each primary key, you must provide all of the key attributes. For example, with a simple primary key, you only need to provide the partition key value. For a composite key, you must provide both the partition key value and the sort key value.

  • ProjectionExpression - A string that identifies one or more attributes to retrieve from the table. These attributes can include scalars, sets, or elements of a JSON document. The attributes in the expression must be separated by commas.

    If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

    For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

  • AttributesToGet - This is a legacy parameter. Use ProjectionExpression instead. For more information, see AttributesToGet in the Amazon DynamoDB Developer Guide.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"} - }, - "documentation":"

Represents the input of a BatchGetItem operation.

" - }, - "BatchGetItemOutput":{ - "type":"structure", - "members":{ - "Responses":{ - "shape":"BatchGetResponseMap", - "documentation":"

A map of table name to a list of items. Each object in Responses consists of a table name, along with a map of attribute data consisting of the data type and attribute value.

" - }, - "UnprocessedKeys":{ - "shape":"BatchGetRequestMap", - "documentation":"

A map of tables and their respective keys that were not processed with the current response. The UnprocessedKeys value is in the same form as RequestItems, so the value can be provided directly to a subsequent BatchGetItem operation. For more information, see RequestItems in the Request Parameters section.

Each element consists of:

  • Keys - An array of primary key attribute values that define specific items in the table.

  • ProjectionExpression - One or more attributes to be retrieved from the table or index. By default, all attributes are returned. If a requested attribute is not found, it does not appear in the result.

  • ConsistentRead - The consistency of a read operation. If set to true, then a strongly consistent read is used; otherwise, an eventually consistent read is used.

If there are no unprocessed keys remaining, the response contains an empty UnprocessedKeys map.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacityMultiple", - "documentation":"

The read capacity units consumed by the entire BatchGetItem operation.

Each element consists of:

  • TableName - The table that consumed the provisioned throughput.

  • CapacityUnits - The total number of capacity units consumed.

" - } - }, - "documentation":"

Represents the output of a BatchGetItem operation.

" - }, - "BatchGetRequestMap":{ - "type":"map", - "key":{"shape":"TableName"}, - "value":{"shape":"KeysAndAttributes"}, - "max":100, - "min":1 - }, - "BatchGetResponseMap":{ - "type":"map", - "key":{"shape":"TableName"}, - "value":{"shape":"ItemList"} - }, - "BatchWriteItemInput":{ - "type":"structure", - "required":["RequestItems"], - "members":{ - "RequestItems":{ - "shape":"BatchWriteItemRequestMap", - "documentation":"

A map of one or more table names and, for each table, a list of operations to be performed (DeleteRequest or PutRequest). Each element in the map consists of the following:

  • DeleteRequest - Perform a DeleteItem operation on the specified item. The item to be deleted is identified by a Key subelement:

    • Key - A map of primary key attribute values that uniquely identify the item. Each entry in this map consists of an attribute name and an attribute value. For each primary key, you must provide all of the key attributes. For example, with a simple primary key, you only need to provide a value for the partition key. For a composite primary key, you must provide values for both the partition key and the sort key.

  • PutRequest - Perform a PutItem operation on the specified item. The item to be put is identified by an Item subelement:

    • Item - A map of attributes and their values. Each entry in this map consists of an attribute name and an attribute value. Attribute values must not be null; string and binary type attributes must have lengths greater than zero; and set type attributes must not be empty. Requests that contain empty values will be rejected with a ValidationException exception.

      If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ReturnItemCollectionMetrics":{ - "shape":"ReturnItemCollectionMetrics", - "documentation":"

Determines whether item collection metrics are returned. If set to SIZE, the response includes statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned.

" - } - }, - "documentation":"

Represents the input of a BatchWriteItem operation.

" - }, - "BatchWriteItemOutput":{ - "type":"structure", - "members":{ - "UnprocessedItems":{ - "shape":"BatchWriteItemRequestMap", - "documentation":"

A map of tables and requests against those tables that were not processed. The UnprocessedItems value is in the same form as RequestItems, so you can provide this value directly to a subsequent BatchGetItem operation. For more information, see RequestItems in the Request Parameters section.

Each UnprocessedItems entry consists of a table name and, for that table, a list of operations to perform (DeleteRequest or PutRequest).

  • DeleteRequest - Perform a DeleteItem operation on the specified item. The item to be deleted is identified by a Key subelement:

    • Key - A map of primary key attribute values that uniquely identify the item. Each entry in this map consists of an attribute name and an attribute value.

  • PutRequest - Perform a PutItem operation on the specified item. The item to be put is identified by an Item subelement:

    • Item - A map of attributes and their values. Each entry in this map consists of an attribute name and an attribute value. Attribute values must not be null; string and binary type attributes must have lengths greater than zero; and set type attributes must not be empty. Requests that contain empty values will be rejected with a ValidationException exception.

      If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition.

If there are no unprocessed items remaining, the response contains an empty UnprocessedItems map.

" - }, - "ItemCollectionMetrics":{ - "shape":"ItemCollectionMetricsPerTable", - "documentation":"

A list of tables that were processed by BatchWriteItem and, for each table, information about any item collections that were affected by individual DeleteItem or PutItem operations.

Each entry consists of the following subelements:

  • ItemCollectionKey - The partition key value of the item collection. This is the same as the partition key value of the item.

  • SizeEstimateRangeGB - An estimate of item collection size, expressed in GB. This is a two-element array containing a lower bound and an upper bound for the estimate. The estimate includes the size of all the items in the table, plus the size of all attributes projected into all of the local secondary indexes on the table. Use this estimate to measure whether a local secondary index is approaching its size limit.

    The estimate is subject to change over time; therefore, do not rely on the precision or accuracy of the estimate.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacityMultiple", - "documentation":"

The capacity units consumed by the entire BatchWriteItem operation.

Each element consists of:

  • TableName - The table that consumed the provisioned throughput.

  • CapacityUnits - The total number of capacity units consumed.

" - } - }, - "documentation":"

Represents the output of a BatchWriteItem operation.

" - }, - "BatchWriteItemRequestMap":{ - "type":"map", - "key":{"shape":"TableName"}, - "value":{"shape":"WriteRequests"}, - "max":25, - "min":1 - }, - "BinaryAttributeValue":{"type":"blob"}, - "BinarySetAttributeValue":{ - "type":"list", - "member":{"shape":"BinaryAttributeValue"} - }, - "BooleanAttributeValue":{"type":"boolean"}, - "BooleanObject":{"type":"boolean"}, - "Capacity":{ - "type":"structure", - "members":{ - "CapacityUnits":{ - "shape":"ConsumedCapacityUnits", - "documentation":"

The total number of capacity units consumed on a table or an index.

" - } - }, - "documentation":"

Represents the amount of provisioned throughput capacity consumed on a table or an index.

" - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "EQ", - "NE", - "IN", - "LE", - "LT", - "GE", - "GT", - "BETWEEN", - "NOT_NULL", - "NULL", - "CONTAINS", - "NOT_CONTAINS", - "BEGINS_WITH" - ] - }, - "Condition":{ - "type":"structure", - "required":["ComparisonOperator"], - "members":{ - "AttributeValueList":{ - "shape":"AttributeValueList", - "documentation":"

One or more values to evaluate against the supplied attribute. The number of values in the list depends on the ComparisonOperator being used.

For type Number, value comparisons are numeric.

String value comparisons for greater than, equals, or less than are based on ASCII character code values. For example, a is greater than A, and a is greater than B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

For Binary, DynamoDB treats each byte of the binary data as unsigned when it compares binary values.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

A comparator for evaluating attributes. For example, equals, greater than, less than, etc.

The following comparison operators are available:

EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN

The following are descriptions of each comparison operator.

  • EQ : Equal. EQ is supported for all data types, including lists and maps.

    AttributeValueList can contain only one AttributeValue element of type String, Number, Binary, String Set, Number Set, or Binary Set. If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not equal {\"NS\":[\"6\", \"2\", \"1\"]}.

  • NE : Not equal. NE is supported for all data types, including lists and maps.

    AttributeValueList can contain only one AttributeValue of type String, Number, Binary, String Set, Number Set, or Binary Set. If an item contains an AttributeValue of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not equal {\"NS\":[\"6\", \"2\", \"1\"]}.

  • LE : Less than or equal.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • LT : Less than.

    AttributeValueList can contain only one AttributeValue of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • GE : Greater than or equal.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • GT : Greater than.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • NOT_NULL : The attribute exists. NOT_NULL is supported for all data types, including lists and maps.

    This operator tests for the existence of an attribute, not its data type. If the data type of attribute \"a\" is null, and you evaluate it using NOT_NULL, the result is a Boolean true. This result is because the attribute \"a\" exists; its data type is not relevant to the NOT_NULL comparison operator.

  • NULL : The attribute does not exist. NULL is supported for all data types, including lists and maps.

    This operator tests for the nonexistence of an attribute, not its data type. If the data type of attribute \"a\" is null, and you evaluate it using NULL, the result is a Boolean false. This is because the attribute \"a\" exists; its data type is not relevant to the NULL comparison operator.

  • CONTAINS : Checks for a subsequence, or value in a set.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If the target attribute of the comparison is of type String, then the operator checks for a substring match. If the target attribute of the comparison is of type Binary, then the operator looks for a subsequence of the target that matches the input. If the target attribute of the comparison is a set (\"SS\", \"NS\", or \"BS\"), then the operator evaluates to true if it finds an exact match with any member of the set.

    CONTAINS is supported for lists: When evaluating \"a CONTAINS b\", \"a\" can be a list; however, \"b\" cannot be a set, a map, or a list.

  • NOT_CONTAINS : Checks for absence of a subsequence, or absence of a value in a set.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If the target attribute of the comparison is a String, then the operator checks for the absence of a substring match. If the target attribute of the comparison is Binary, then the operator checks for the absence of a subsequence of the target that matches the input. If the target attribute of the comparison is a set (\"SS\", \"NS\", or \"BS\"), then the operator evaluates to true if it does not find an exact match with any member of the set.

    NOT_CONTAINS is supported for lists: When evaluating \"a NOT CONTAINS b\", \"a\" can be a list; however, \"b\" cannot be a set, a map, or a list.

  • BEGINS_WITH : Checks for a prefix.

    AttributeValueList can contain only one AttributeValue of type String or Binary (not a Number or a set type). The target attribute of the comparison must be of type String or Binary (not a Number or a set type).

  • IN : Checks for matching elements in a list.

    AttributeValueList can contain one or more AttributeValue elements of type String, Number, or Binary. These attributes are compared against an existing attribute of an item. If any elements of the input are equal to the item attribute, the expression evaluates to true.

  • BETWEEN : Greater than or equal to the first value, and less than or equal to the second value.

    AttributeValueList must contain two AttributeValue elements of the same type, either String, Number, or Binary (not a set type). A target attribute matches if the target value is greater than, or equal to, the first element and less than, or equal to, the second element. If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not compare to {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}

For usage examples of AttributeValueList and ComparisonOperator, see Legacy Conditional Parameters in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the selection criteria for a Query or Scan operation:

  • For a Query operation, Condition is used for specifying the KeyConditions to use when querying a table or an index. For KeyConditions, only the following comparison operators are supported:

    EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN

    Condition is also used in a QueryFilter, which evaluates the query results and returns only the desired values.

  • For a Scan operation, Condition is used in a ScanFilter, which evaluates the scan results and returns only the desired values.

" - }, - "ConditionExpression":{"type":"string"}, - "ConditionalCheckFailedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The conditional request failed.

" - } - }, - "documentation":"

A condition specified in the operation could not be evaluated.

", - "exception":true - }, - "ConditionalOperator":{ - "type":"string", - "enum":[ - "AND", - "OR" - ] - }, - "ConsistentRead":{"type":"boolean"}, - "ConsumedCapacity":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table that was affected by the operation.

" - }, - "CapacityUnits":{ - "shape":"ConsumedCapacityUnits", - "documentation":"

The total number of capacity units consumed by the operation.

" - }, - "Table":{ - "shape":"Capacity", - "documentation":"

The amount of throughput consumed on the table affected by the operation.

" - }, - "LocalSecondaryIndexes":{ - "shape":"SecondaryIndexesCapacityMap", - "documentation":"

The amount of throughput consumed on each local index affected by the operation.

" - }, - "GlobalSecondaryIndexes":{ - "shape":"SecondaryIndexesCapacityMap", - "documentation":"

The amount of throughput consumed on each global index affected by the operation.

" - } - }, - "documentation":"

The capacity units consumed by an operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the request asked for it. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - }, - "ConsumedCapacityMultiple":{ - "type":"list", - "member":{"shape":"ConsumedCapacity"} - }, - "ConsumedCapacityUnits":{"type":"double"}, - "ContinuousBackupsDescription":{ - "type":"structure", - "required":["ContinuousBackupsStatus"], - "members":{ - "ContinuousBackupsStatus":{ - "shape":"ContinuousBackupsStatus", - "documentation":"

ContinuousBackupsStatus can be one of the following states : ENABLED, DISABLED

" - }, - "PointInTimeRecoveryDescription":{ - "shape":"PointInTimeRecoveryDescription", - "documentation":"

The description of the point in time recovery settings applied to the table.

" - } - }, - "documentation":"

Represents the continuous backups and point in time recovery settings on the table.

" - }, - "ContinuousBackupsStatus":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "ContinuousBackupsUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Backups have not yet been enabled for this table.

", - "exception":true - }, - "CreateBackupInput":{ - "type":"structure", - "required":[ - "TableName", - "BackupName" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table.

" - }, - "BackupName":{ - "shape":"BackupName", - "documentation":"

Specified name for the backup.

" - } - } - }, - "CreateBackupOutput":{ - "type":"structure", - "members":{ - "BackupDetails":{ - "shape":"BackupDetails", - "documentation":"

Contains the details of the backup created for the table.

" - } - } - }, - "CreateGlobalSecondaryIndexAction":{ - "type":"structure", - "required":[ - "IndexName", - "KeySchema", - "Projection", - "ProvisionedThroughput" - ], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index to be created.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The key schema for the global secondary index.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into an index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Represents the provisioned throughput settings for the specified global secondary index.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents a new global secondary index to be added to an existing table.

" - }, - "CreateGlobalTableInput":{ - "type":"structure", - "required":[ - "GlobalTableName", - "ReplicationGroup" - ], - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The global table name.

" - }, - "ReplicationGroup":{ - "shape":"ReplicaList", - "documentation":"

The regions where the global table needs to be created.

" - } - } - }, - "CreateGlobalTableOutput":{ - "type":"structure", - "members":{ - "GlobalTableDescription":{ - "shape":"GlobalTableDescription", - "documentation":"

Contains the details of the global table.

" - } - } - }, - "CreateReplicaAction":{ - "type":"structure", - "required":["RegionName"], - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The region of the replica to be added.

" - } - }, - "documentation":"

Represents a replica to be added.

" - }, - "CreateTableInput":{ - "type":"structure", - "required":[ - "AttributeDefinitions", - "TableName", - "KeySchema", - "ProvisionedThroughput" - ], - "members":{ - "AttributeDefinitions":{ - "shape":"AttributeDefinitions", - "documentation":"

An array of attributes that describe the key schema for the table and indexes.

" - }, - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to create.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

Specifies the attributes that make up the primary key for a table or an index. The attributes in KeySchema must also be defined in the AttributeDefinitions array. For more information, see Data Model in the Amazon DynamoDB Developer Guide.

Each KeySchemaElement in the array is composed of:

  • AttributeName - The name of this key attribute.

  • KeyType - The role that the key attribute will assume:

    • HASH - partition key

    • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

For a simple primary key (partition key), you must provide exactly one element with a KeyType of HASH.

For a composite primary key (partition key and sort key), you must provide exactly two elements, in this order: The first element must have a KeyType of HASH, and the second element must have a KeyType of RANGE.

For more information, see Specifying the Primary Key in the Amazon DynamoDB Developer Guide.

" - }, - "LocalSecondaryIndexes":{ - "shape":"LocalSecondaryIndexList", - "documentation":"

One or more local secondary indexes (the maximum is five) to be created on the table. Each index is scoped to a given partition key value. There is a 10 GB size limit per partition key value; otherwise, the size of a local secondary index is unconstrained.

Each local secondary index in the array includes the following:

  • IndexName - The name of the local secondary index. Must be unique only for this table.

  • KeySchema - Specifies the key schema for the local secondary index. The key schema must begin with the same partition key as the table.

  • Projection - Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:

    • ProjectionType - One of the following:

      • KEYS_ONLY - Only the index and primary keys are projected into the index.

      • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.

      • ALL - All of the table attributes are projected into the index.

    • NonKeyAttributes - A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided in NonKeyAttributes, summed across all of the secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

" - }, - "GlobalSecondaryIndexes":{ - "shape":"GlobalSecondaryIndexList", - "documentation":"

One or more global secondary indexes (the maximum is five) to be created on the table. Each global secondary index in the array includes the following:

  • IndexName - The name of the global secondary index. Must be unique only for this table.

  • KeySchema - Specifies the key schema for the global secondary index.

  • Projection - Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:

    • ProjectionType - One of the following:

      • KEYS_ONLY - Only the index and primary keys are projected into the index.

      • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.

      • ALL - All of the table attributes are projected into the index.

    • NonKeyAttributes - A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided in NonKeyAttributes, summed across all of the secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

  • ProvisionedThroughput - The provisioned throughput settings for the global secondary index, consisting of read and write capacity units.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Represents the provisioned throughput settings for a specified table or index. The settings can be modified using the UpdateTable operation.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - }, - "StreamSpecification":{ - "shape":"StreamSpecification", - "documentation":"

The settings for DynamoDB Streams on the table. These settings consist of:

  • StreamEnabled - Indicates whether Streams is to be enabled (true) or disabled (false).

  • StreamViewType - When an item in the table is modified, StreamViewType determines what information is written to the table's stream. Valid values for StreamViewType are:

    • KEYS_ONLY - Only the key attributes of the modified item are written to the stream.

    • NEW_IMAGE - The entire item, as it appears after it was modified, is written to the stream.

    • OLD_IMAGE - The entire item, as it appeared before it was modified, is written to the stream.

    • NEW_AND_OLD_IMAGES - Both the new and the old item images of the item are written to the stream.

" - }, - "SSESpecification":{ - "shape":"SSESpecification", - "documentation":"

Represents the settings used to enable server-side encryption.

" - } - }, - "documentation":"

Represents the input of a CreateTable operation.

" - }, - "CreateTableOutput":{ - "type":"structure", - "members":{ - "TableDescription":{ - "shape":"TableDescription", - "documentation":"

Represents the properties of the table.

" - } - }, - "documentation":"

Represents the output of a CreateTable operation.

" - }, - "Date":{"type":"timestamp"}, - "DeleteBackupInput":{ - "type":"structure", - "required":["BackupArn"], - "members":{ - "BackupArn":{ - "shape":"BackupArn", - "documentation":"

The ARN associated with the backup.

" - } - } - }, - "DeleteBackupOutput":{ - "type":"structure", - "members":{ - "BackupDescription":{ - "shape":"BackupDescription", - "documentation":"

Contains the description of the backup created for the table.

" - } - } - }, - "DeleteGlobalSecondaryIndexAction":{ - "type":"structure", - "required":["IndexName"], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index to be deleted.

" - } - }, - "documentation":"

Represents a global secondary index to be deleted from an existing table.

" - }, - "DeleteItemInput":{ - "type":"structure", - "required":[ - "TableName", - "Key" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table from which to delete the item.

" - }, - "Key":{ - "shape":"Key", - "documentation":"

A map of attribute names to AttributeValue objects, representing the primary key of the item to delete.

For the primary key, you must provide all of the attributes. For example, with a simple primary key, you only need to provide a value for the partition key. For a composite primary key, you must provide values for both the partition key and the sort key.

" - }, - "Expected":{ - "shape":"ExpectedAttributeMap", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see Expected in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionalOperator":{ - "shape":"ConditionalOperator", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.

" - }, - "ReturnValues":{ - "shape":"ReturnValue", - "documentation":"

Use ReturnValues if you want to get the item attributes as they appeared before they were deleted. For DeleteItem, the valid values are:

  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This setting is the default for ReturnValues.)

  • ALL_OLD - The content of the old item is returned.

The ReturnValues parameter is used by several DynamoDB operations; however, DeleteItem does not recognize any values other than NONE or ALL_OLD.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ReturnItemCollectionMetrics":{ - "shape":"ReturnItemCollectionMetrics", - "documentation":"

Determines whether item collection metrics are returned. If set to SIZE, the response includes statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned.

" - }, - "ConditionExpression":{ - "shape":"ConditionExpression", - "documentation":"

A condition that must be satisfied in order for a conditional DeleteItem to succeed.

An expression can contain any of the following:

  • Functions: attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size

    These function names are case-sensitive.

  • Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN

  • Logical operators: AND | OR | NOT

For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeValues":{ - "shape":"ExpressionAttributeValueMap", - "documentation":"

One or more values that can be substituted in an expression.

Use the : (colon) character in an expression to dereference an attribute value. For example, suppose that you wanted to check whether the value of the ProductStatus attribute was one of the following:

Available | Backordered | Discontinued

You would first need to specify ExpressionAttributeValues as follows:

{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }

You could then use these values in an expression, such as this:

ProductStatus IN (:avail, :back, :disc)

For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the input of a DeleteItem operation.

" - }, - "DeleteItemOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeMap", - "documentation":"

A map of attribute names to AttributeValue objects, representing the item as it appeared before the DeleteItem operation. This map appears in the response only if ReturnValues was specified as ALL_OLD in the request.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the DeleteItem operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - }, - "ItemCollectionMetrics":{ - "shape":"ItemCollectionMetrics", - "documentation":"

Information about item collections, if any, that were affected by the DeleteItem operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics parameter was specified. If the table does not have any local secondary indexes, this information is not returned in the response.

Each ItemCollectionMetrics element consists of:

  • ItemCollectionKey - The partition key value of the item collection. This is the same as the partition key value of the item itself.

  • SizeEstimateRangeGB - An estimate of item collection size, in gigabytes. This value is a two-element array containing a lower bound and an upper bound for the estimate. The estimate includes the size of all the items in the table, plus the size of all attributes projected into all of the local secondary indexes on that table. Use this estimate to measure whether a local secondary index is approaching its size limit.

    The estimate is subject to change over time; therefore, do not rely on the precision or accuracy of the estimate.

" - } - }, - "documentation":"

Represents the output of a DeleteItem operation.

" - }, - "DeleteReplicaAction":{ - "type":"structure", - "required":["RegionName"], - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The region of the replica to be removed.

" - } - }, - "documentation":"

Represents a replica to be removed.

" - }, - "DeleteRequest":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"Key", - "documentation":"

A map of attribute name to attribute values, representing the primary key of the item to delete. All of the table's primary key attributes must be specified, and their data types must match those of the table's key schema.

" - } - }, - "documentation":"

Represents a request to perform a DeleteItem operation on an item.

" - }, - "DeleteTableInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to delete.

" - } - }, - "documentation":"

Represents the input of a DeleteTable operation.

" - }, - "DeleteTableOutput":{ - "type":"structure", - "members":{ - "TableDescription":{ - "shape":"TableDescription", - "documentation":"

Represents the properties of a table.

" - } - }, - "documentation":"

Represents the output of a DeleteTable operation.

" - }, - "DescribeBackupInput":{ - "type":"structure", - "required":["BackupArn"], - "members":{ - "BackupArn":{ - "shape":"BackupArn", - "documentation":"

The ARN associated with the backup.

" - } - } - }, - "DescribeBackupOutput":{ - "type":"structure", - "members":{ - "BackupDescription":{ - "shape":"BackupDescription", - "documentation":"

Contains the description of the backup created for the table.

" - } - } - }, - "DescribeContinuousBackupsInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

Name of the table for which the customer wants to check the continuous backups and point in time recovery settings.

" - } - } - }, - "DescribeContinuousBackupsOutput":{ - "type":"structure", - "members":{ - "ContinuousBackupsDescription":{ - "shape":"ContinuousBackupsDescription", - "documentation":"

Represents the continuous backups and point in time recovery settings on the table.

" - } - } - }, - "DescribeGlobalTableInput":{ - "type":"structure", - "required":["GlobalTableName"], - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The name of the global table.

" - } - } - }, - "DescribeGlobalTableOutput":{ - "type":"structure", - "members":{ - "GlobalTableDescription":{ - "shape":"GlobalTableDescription", - "documentation":"

Contains the details of the global table.

" - } - } - }, - "DescribeGlobalTableSettingsInput":{ - "type":"structure", - "required":["GlobalTableName"], - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The name of the global table to describe.

" - } - } - }, - "DescribeGlobalTableSettingsOutput":{ - "type":"structure", - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The name of the global table.

" - }, - "ReplicaSettings":{ - "shape":"ReplicaSettingsDescriptionList", - "documentation":"

The region specific settings for the global table.

" - } - } - }, - "DescribeLimitsInput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents the input of a DescribeLimits operation. Has no content.

" - }, - "DescribeLimitsOutput":{ - "type":"structure", - "members":{ - "AccountMaxReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum total read capacity units that your account allows you to provision across all of your tables in this region.

" - }, - "AccountMaxWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum total write capacity units that your account allows you to provision across all of your tables in this region.

" - }, - "TableMaxReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum read capacity units that your account allows you to provision for a new table that you are creating in this region, including the read capacity units provisioned for its global secondary indexes (GSIs).

" - }, - "TableMaxWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum write capacity units that your account allows you to provision for a new table that you are creating in this region, including the write capacity units provisioned for its global secondary indexes (GSIs).

" - } - }, - "documentation":"

Represents the output of a DescribeLimits operation.

" - }, - "DescribeTableInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to describe.

" - } - }, - "documentation":"

Represents the input of a DescribeTable operation.

" - }, - "DescribeTableOutput":{ - "type":"structure", - "members":{ - "Table":{ - "shape":"TableDescription", - "documentation":"

The properties of the table.

" - } - }, - "documentation":"

Represents the output of a DescribeTable operation.

" - }, - "DescribeTimeToLiveInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to be described.

" - } - } - }, - "DescribeTimeToLiveOutput":{ - "type":"structure", - "members":{ - "TimeToLiveDescription":{ - "shape":"TimeToLiveDescription", - "documentation":"

" - } - } - }, - "Double":{"type":"double"}, - "ErrorMessage":{"type":"string"}, - "ExpectedAttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"ExpectedAttributeValue"} - }, - "ExpectedAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"AttributeValue", - "documentation":"

Represents the data for the expected attribute.

Each attribute value is described as a name-value pair. The name is the data type, and the value is the data itself.

For more information, see Data Types in the Amazon DynamoDB Developer Guide.

" - }, - "Exists":{ - "shape":"BooleanObject", - "documentation":"

Causes DynamoDB to evaluate the value before attempting a conditional operation:

  • If Exists is true, DynamoDB will check to see if that attribute value already exists in the table. If it is found, then the operation succeeds. If it is not found, the operation fails with a ConditionalCheckFailedException.

  • If Exists is false, DynamoDB assumes that the attribute value does not exist in the table. If in fact the value does not exist, then the assumption is valid and the operation succeeds. If the value is found, despite the assumption that it does not exist, the operation fails with a ConditionalCheckFailedException.

The default setting for Exists is true. If you supply a Value all by itself, DynamoDB assumes the attribute exists: You don't have to set Exists to true, because it is implied.

DynamoDB returns a ValidationException if:

  • Exists is true but there is no Value to check. (You expect a value to exist, but don't specify what that value is.)

  • Exists is false but you also provide a Value. (You cannot expect an attribute to have a value, while also expecting it not to exist.)

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

A comparator for evaluating attributes in the AttributeValueList. For example, equals, greater than, less than, etc.

The following comparison operators are available:

EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN

The following are descriptions of each comparison operator.

  • EQ : Equal. EQ is supported for all data types, including lists and maps.

    AttributeValueList can contain only one AttributeValue element of type String, Number, Binary, String Set, Number Set, or Binary Set. If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not equal {\"NS\":[\"6\", \"2\", \"1\"]}.

  • NE : Not equal. NE is supported for all data types, including lists and maps.

    AttributeValueList can contain only one AttributeValue of type String, Number, Binary, String Set, Number Set, or Binary Set. If an item contains an AttributeValue of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not equal {\"NS\":[\"6\", \"2\", \"1\"]}.

  • LE : Less than or equal.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • LT : Less than.

    AttributeValueList can contain only one AttributeValue of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • GE : Greater than or equal.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • GT : Greater than.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not equal {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}.

  • NOT_NULL : The attribute exists. NOT_NULL is supported for all data types, including lists and maps.

    This operator tests for the existence of an attribute, not its data type. If the data type of attribute \"a\" is null, and you evaluate it using NOT_NULL, the result is a Boolean true. This result is because the attribute \"a\" exists; its data type is not relevant to the NOT_NULL comparison operator.

  • NULL : The attribute does not exist. NULL is supported for all data types, including lists and maps.

    This operator tests for the nonexistence of an attribute, not its data type. If the data type of attribute \"a\" is null, and you evaluate it using NULL, the result is a Boolean false. This is because the attribute \"a\" exists; its data type is not relevant to the NULL comparison operator.

  • CONTAINS : Checks for a subsequence, or value in a set.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If the target attribute of the comparison is of type String, then the operator checks for a substring match. If the target attribute of the comparison is of type Binary, then the operator looks for a subsequence of the target that matches the input. If the target attribute of the comparison is a set (\"SS\", \"NS\", or \"BS\"), then the operator evaluates to true if it finds an exact match with any member of the set.

    CONTAINS is supported for lists: When evaluating \"a CONTAINS b\", \"a\" can be a list; however, \"b\" cannot be a set, a map, or a list.

  • NOT_CONTAINS : Checks for absence of a subsequence, or absence of a value in a set.

    AttributeValueList can contain only one AttributeValue element of type String, Number, or Binary (not a set type). If the target attribute of the comparison is a String, then the operator checks for the absence of a substring match. If the target attribute of the comparison is Binary, then the operator checks for the absence of a subsequence of the target that matches the input. If the target attribute of the comparison is a set (\"SS\", \"NS\", or \"BS\"), then the operator evaluates to true if it does not find an exact match with any member of the set.

    NOT_CONTAINS is supported for lists: When evaluating \"a NOT CONTAINS b\", \"a\" can be a list; however, \"b\" cannot be a set, a map, or a list.

  • BEGINS_WITH : Checks for a prefix.

    AttributeValueList can contain only one AttributeValue of type String or Binary (not a Number or a set type). The target attribute of the comparison must be of type String or Binary (not a Number or a set type).

  • IN : Checks for matching elements in a list.

    AttributeValueList can contain one or more AttributeValue elements of type String, Number, or Binary. These attributes are compared against an existing attribute of an item. If any elements of the input are equal to the item attribute, the expression evaluates to true.

  • BETWEEN : Greater than or equal to the first value, and less than or equal to the second value.

    AttributeValueList must contain two AttributeValue elements of the same type, either String, Number, or Binary (not a set type). A target attribute matches if the target value is greater than, or equal to, the first element and less than, or equal to, the second element. If an item contains an AttributeValue element of a different type than the one provided in the request, the value does not match. For example, {\"S\":\"6\"} does not compare to {\"N\":\"6\"}. Also, {\"N\":\"6\"} does not compare to {\"NS\":[\"6\", \"2\", \"1\"]}

" - }, - "AttributeValueList":{ - "shape":"AttributeValueList", - "documentation":"

One or more values to evaluate against the supplied attribute. The number of values in the list depends on the ComparisonOperator being used.

For type Number, value comparisons are numeric.

String value comparisons for greater than, equals, or less than are based on ASCII character code values. For example, a is greater than A, and a is greater than B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

For Binary, DynamoDB treats each byte of the binary data as unsigned when it compares binary values.

For information on specifying data types in JSON, see JSON Data Format in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents a condition to be compared with an attribute value. This condition can be used with DeleteItem, PutItem or UpdateItem operations; if the comparison evaluates to true, the operation succeeds; if not, the operation fails. You can use ExpectedAttributeValue in one of two different ways:

  • Use AttributeValueList to specify one or more values to compare against an attribute. Use ComparisonOperator to specify how you want to perform the comparison. If the comparison evaluates to true, then the conditional operation succeeds.

  • Use Value to specify a value that DynamoDB will compare against an attribute. If the values match, then ExpectedAttributeValue evaluates to true and the conditional operation succeeds. Optionally, you can also set Exists to false, indicating that you do not expect to find the attribute value in the table. In this case, the conditional operation succeeds only if the comparison evaluates to false.

Value and Exists are incompatible with AttributeValueList and ComparisonOperator. Note that if you use both sets of parameters at once, DynamoDB will return a ValidationException exception.

" - }, - "ExpressionAttributeNameMap":{ - "type":"map", - "key":{"shape":"ExpressionAttributeNameVariable"}, - "value":{"shape":"AttributeName"} - }, - "ExpressionAttributeNameVariable":{"type":"string"}, - "ExpressionAttributeValueMap":{ - "type":"map", - "key":{"shape":"ExpressionAttributeValueVariable"}, - "value":{"shape":"AttributeValue"} - }, - "ExpressionAttributeValueVariable":{"type":"string"}, - "FilterConditionMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"Condition"} - }, - "GetItemInput":{ - "type":"structure", - "required":[ - "TableName", - "Key" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table containing the requested item.

" - }, - "Key":{ - "shape":"Key", - "documentation":"

A map of attribute names to AttributeValue objects, representing the primary key of the item to retrieve.

For the primary key, you must provide all of the attributes. For example, with a simple primary key, you only need to provide a value for the partition key. For a composite primary key, you must provide values for both the partition key and the sort key.

" - }, - "AttributesToGet":{ - "shape":"AttributeNameList", - "documentation":"

This is a legacy parameter. Use ProjectionExpression instead. For more information, see AttributesToGet in the Amazon DynamoDB Developer Guide.

" - }, - "ConsistentRead":{ - "shape":"ConsistentRead", - "documentation":"

Determines the read consistency model: If set to true, then the operation uses strongly consistent reads; otherwise, the operation uses eventually consistent reads.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ProjectionExpression":{ - "shape":"ProjectionExpression", - "documentation":"

A string that identifies one or more attributes to retrieve from the table. These attributes can include scalars, sets, or elements of a JSON document. The attributes in the expression must be separated by commas.

If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the input of a GetItem operation.

" - }, - "GetItemOutput":{ - "type":"structure", - "members":{ - "Item":{ - "shape":"AttributeMap", - "documentation":"

A map of attribute names to AttributeValue objects, as specified by ProjectionExpression.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the GetItem operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the output of a GetItem operation.

" - }, - "GlobalSecondaryIndex":{ - "type":"structure", - "required":[ - "IndexName", - "KeySchema", - "Projection", - "ProvisionedThroughput" - ], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index. The name must be unique among all other indexes on this table.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Represents the provisioned throughput settings for the specified global secondary index.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the properties of a global secondary index.

" - }, - "GlobalSecondaryIndexDescription":{ - "type":"structure", - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "IndexStatus":{ - "shape":"IndexStatus", - "documentation":"

The current state of the global secondary index:

  • CREATING - The index is being created.

  • UPDATING - The index is being updated.

  • DELETING - The index is being deleted.

  • ACTIVE - The index is ready for use.

" - }, - "Backfilling":{ - "shape":"Backfilling", - "documentation":"

Indicates whether the index is currently backfilling. Backfilling is the process of reading items from the table and determining whether they can be added to the index. (Not all items will qualify: For example, a partition key cannot have any duplicate values.) If an item can be added to the index, DynamoDB will do so. After all items have been processed, the backfilling operation is complete and Backfilling is false.

For indexes that were created during a CreateTable operation, the Backfilling attribute does not appear in the DescribeTable output.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughputDescription", - "documentation":"

Represents the provisioned throughput settings for the specified global secondary index.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - }, - "IndexSizeBytes":{ - "shape":"Long", - "documentation":"

The total size of the specified index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "ItemCount":{ - "shape":"Long", - "documentation":"

The number of items in the specified index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "IndexArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that uniquely identifies the index.

" - } - }, - "documentation":"

Represents the properties of a global secondary index.

" - }, - "GlobalSecondaryIndexDescriptionList":{ - "type":"list", - "member":{"shape":"GlobalSecondaryIndexDescription"} - }, - "GlobalSecondaryIndexInfo":{ - "type":"structure", - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Represents the provisioned throughput settings for the specified global secondary index.

" - } - }, - "documentation":"

Represents the properties of a global secondary index for the table when the backup was created.

" - }, - "GlobalSecondaryIndexList":{ - "type":"list", - "member":{"shape":"GlobalSecondaryIndex"} - }, - "GlobalSecondaryIndexUpdate":{ - "type":"structure", - "members":{ - "Update":{ - "shape":"UpdateGlobalSecondaryIndexAction", - "documentation":"

The name of an existing global secondary index, along with new provisioned throughput settings to be applied to that index.

" - }, - "Create":{ - "shape":"CreateGlobalSecondaryIndexAction", - "documentation":"

The parameters required for creating a global secondary index on an existing table:

  • IndexName

  • KeySchema

  • AttributeDefinitions

  • Projection

  • ProvisionedThroughput

" - }, - "Delete":{ - "shape":"DeleteGlobalSecondaryIndexAction", - "documentation":"

The name of an existing global secondary index to be removed.

" - } - }, - "documentation":"

Represents one of the following:

  • A new global secondary index to be added to an existing table.

  • New provisioned throughput parameters for an existing global secondary index.

  • An existing global secondary index to be removed from an existing table.

" - }, - "GlobalSecondaryIndexUpdateList":{ - "type":"list", - "member":{"shape":"GlobalSecondaryIndexUpdate"} - }, - "GlobalSecondaryIndexes":{ - "type":"list", - "member":{"shape":"GlobalSecondaryIndexInfo"} - }, - "GlobalTable":{ - "type":"structure", - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The global table name.

" - }, - "ReplicationGroup":{ - "shape":"ReplicaList", - "documentation":"

The regions where the global table has replicas.

" - } - }, - "documentation":"

Represents the properties of a global table.

" - }, - "GlobalTableAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified global table already exists.

", - "exception":true - }, - "GlobalTableArnString":{"type":"string"}, - "GlobalTableDescription":{ - "type":"structure", - "members":{ - "ReplicationGroup":{ - "shape":"ReplicaDescriptionList", - "documentation":"

The regions where the global table has replicas.

" - }, - "GlobalTableArn":{ - "shape":"GlobalTableArnString", - "documentation":"

The unique identifier of the global table.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation time of the global table.

" - }, - "GlobalTableStatus":{ - "shape":"GlobalTableStatus", - "documentation":"

The current state of the global table:

  • CREATING - The global table is being created.

  • UPDATING - The global table is being updated.

  • DELETING - The global table is being deleted.

  • ACTIVE - The global table is ready for use.

" - }, - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The global table name.

" - } - }, - "documentation":"

Contains details about the global table.

" - }, - "GlobalTableGlobalSecondaryIndexSettingsUpdate":{ - "type":"structure", - "required":["IndexName"], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index. The name must be unique among all other indexes on this table.

" - }, - "ProvisionedWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException.

" - }, - "ProvisionedWriteCapacityAutoScalingSettingsUpdate":{ - "shape":"AutoScalingSettingsUpdate", - "documentation":"

AutoScaling settings for managing a global secondary index's write capacity units.

" - } - }, - "documentation":"

Represents the settings of a global secondary index for a global table that will be modified.

" - }, - "GlobalTableGlobalSecondaryIndexSettingsUpdateList":{ - "type":"list", - "member":{"shape":"GlobalTableGlobalSecondaryIndexSettingsUpdate"}, - "max":20, - "min":1 - }, - "GlobalTableList":{ - "type":"list", - "member":{"shape":"GlobalTable"} - }, - "GlobalTableNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified global table does not exist.

", - "exception":true - }, - "GlobalTableStatus":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "DELETING", - "UPDATING" - ] - }, - "IndexName":{ - "type":"string", - "max":255, - "min":3, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "IndexNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The operation tried to access a nonexistent index.

", - "exception":true - }, - "IndexStatus":{ - "type":"string", - "enum":[ - "CREATING", - "UPDATING", - "DELETING", - "ACTIVE" - ] - }, - "Integer":{"type":"integer"}, - "IntegerObject":{"type":"integer"}, - "InternalServerError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The server encountered an internal error trying to fulfill the request.

" - } - }, - "documentation":"

An error occurred on the server side.

", - "exception":true, - "fault":true - }, - "InvalidRestoreTimeException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

An invalid restore time was specified. RestoreDateTime must be between EarliestRestorableDateTime and LatestRestorableDateTime.

", - "exception":true - }, - "ItemCollectionKeyAttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "ItemCollectionMetrics":{ - "type":"structure", - "members":{ - "ItemCollectionKey":{ - "shape":"ItemCollectionKeyAttributeMap", - "documentation":"

The partition key value of the item collection. This value is the same as the partition key value of the item.

" - }, - "SizeEstimateRangeGB":{ - "shape":"ItemCollectionSizeEstimateRange", - "documentation":"

An estimate of item collection size, in gigabytes. This value is a two-element array containing a lower bound and an upper bound for the estimate. The estimate includes the size of all the items in the table, plus the size of all attributes projected into all of the local secondary indexes on that table. Use this estimate to measure whether a local secondary index is approaching its size limit.

The estimate is subject to change over time; therefore, do not rely on the precision or accuracy of the estimate.

" - } - }, - "documentation":"

Information about item collections, if any, that were affected by the operation. ItemCollectionMetrics is only returned if the request asked for it. If the table does not have any local secondary indexes, this information is not returned in the response.

" - }, - "ItemCollectionMetricsMultiple":{ - "type":"list", - "member":{"shape":"ItemCollectionMetrics"} - }, - "ItemCollectionMetricsPerTable":{ - "type":"map", - "key":{"shape":"TableName"}, - "value":{"shape":"ItemCollectionMetricsMultiple"} - }, - "ItemCollectionSizeEstimateBound":{"type":"double"}, - "ItemCollectionSizeEstimateRange":{ - "type":"list", - "member":{"shape":"ItemCollectionSizeEstimateBound"} - }, - "ItemCollectionSizeLimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The total size of an item collection has exceeded the maximum limit of 10 gigabytes.

" - } - }, - "documentation":"

An item collection is too large. This exception is only returned for tables that have one or more local secondary indexes.

", - "exception":true - }, - "ItemCount":{ - "type":"long", - "min":0 - }, - "ItemList":{ - "type":"list", - "member":{"shape":"AttributeMap"} - }, - "KMSMasterKeyArn":{"type":"string"}, - "Key":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "KeyConditions":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"Condition"} - }, - "KeyExpression":{"type":"string"}, - "KeyList":{ - "type":"list", - "member":{"shape":"Key"}, - "max":100, - "min":1 - }, - "KeySchema":{ - "type":"list", - "member":{"shape":"KeySchemaElement"}, - "max":2, - "min":1 - }, - "KeySchemaAttributeName":{ - "type":"string", - "max":255, - "min":1 - }, - "KeySchemaElement":{ - "type":"structure", - "required":[ - "AttributeName", - "KeyType" - ], - "members":{ - "AttributeName":{ - "shape":"KeySchemaAttributeName", - "documentation":"

The name of a key attribute.

" - }, - "KeyType":{ - "shape":"KeyType", - "documentation":"

The role that this key attribute will assume:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - } - }, - "documentation":"

Represents a single element of a key schema. A key schema specifies the attributes that make up the primary key of a table, or the key attributes of an index.

A KeySchemaElement represents exactly one attribute of the primary key. For example, a simple primary key would be represented by one KeySchemaElement (for the partition key). A composite primary key would require one KeySchemaElement for the partition key, and another KeySchemaElement for the sort key.

A KeySchemaElement must be a scalar, top-level attribute (not a nested attribute). The data type must be one of String, Number, or Binary. The attribute cannot be nested within a List or a Map.

" - }, - "KeyType":{ - "type":"string", - "enum":[ - "HASH", - "RANGE" - ] - }, - "KeysAndAttributes":{ - "type":"structure", - "required":["Keys"], - "members":{ - "Keys":{ - "shape":"KeyList", - "documentation":"

The primary key attribute values that define the items and the attributes associated with the items.

" - }, - "AttributesToGet":{ - "shape":"AttributeNameList", - "documentation":"

This is a legacy parameter. Use ProjectionExpression instead. For more information, see Legacy Conditional Parameters in the Amazon DynamoDB Developer Guide.

" - }, - "ConsistentRead":{ - "shape":"ConsistentRead", - "documentation":"

The consistency of a read operation. If set to true, then a strongly consistent read is used; otherwise, an eventually consistent read is used.

" - }, - "ProjectionExpression":{ - "shape":"ProjectionExpression", - "documentation":"

A string that identifies one or more attributes to retrieve from the table. These attributes can include scalars, sets, or elements of a JSON document. The attributes in the ProjectionExpression must be separated by commas.

If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents a set of primary keys and, for each key, the attributes to retrieve from the table.

For each primary key, you must provide all of the key attributes. For example, with a simple primary key, you only need to provide the partition key. For a composite primary key, you must provide both the partition key and the sort key.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Too many operations for a given subscriber.

" - } - }, - "documentation":"

There is no limit to the number of daily on-demand backups that can be taken.

Up to 10 simultaneous table operations are allowed per account. These operations include CreateTable, UpdateTable, DeleteTable,UpdateTimeToLive, RestoreTableFromBackup, and RestoreTableToPointInTime.

For tables with secondary indexes, only one of those tables can be in the CREATING state at any point in time. Do not attempt to create more than one such table simultaneously.

The total limit of tables in the ACTIVE state is 250.

", - "exception":true - }, - "ListAttributeValue":{ - "type":"list", - "member":{"shape":"AttributeValue"} - }, - "ListBackupsInput":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The backups from the table specified by TableName are listed.

" - }, - "Limit":{ - "shape":"BackupsInputLimit", - "documentation":"

Maximum number of backups to return at once.

" - }, - "TimeRangeLowerBound":{ - "shape":"TimeRangeLowerBound", - "documentation":"

Only backups created after this time are listed. TimeRangeLowerBound is inclusive.

" - }, - "TimeRangeUpperBound":{ - "shape":"TimeRangeUpperBound", - "documentation":"

Only backups created before this time are listed. TimeRangeUpperBound is exclusive.

" - }, - "ExclusiveStartBackupArn":{ - "shape":"BackupArn", - "documentation":"

LastEvaluatedBackupArn is the ARN of the backup last evaluated when the current page of results was returned, inclusive of the current page of results. This value may be specified as the ExclusiveStartBackupArn of a new ListBackups operation in order to fetch the next page of results.

" - }, - "BackupType":{ - "shape":"BackupTypeFilter", - "documentation":"

The backups from the table specified by BackupType are listed.

Where BackupType can be:

  • USER - On demand backup created by you.

  • SYSTEM - On demand backup automatically created by DynamoDB.

  • ALL - All types of on demand backups (USER and SYSTEM).

" - } - } - }, - "ListBackupsOutput":{ - "type":"structure", - "members":{ - "BackupSummaries":{ - "shape":"BackupSummaries", - "documentation":"

List of BackupSummary objects.

" - }, - "LastEvaluatedBackupArn":{ - "shape":"BackupArn", - "documentation":"

The ARN of the backup last evaluated when the current page of results was returned, inclusive of the current page of results. This value may be specified as the ExclusiveStartBackupArn of a new ListBackups operation in order to fetch the next page of results.

If LastEvaluatedBackupArn is empty, then the last page of results has been processed and there are no more results to be retrieved.

If LastEvaluatedBackupArn is not empty, this may or may not indicate there is more data to be returned. All results are guaranteed to have been returned if and only if no value for LastEvaluatedBackupArn is returned.

" - } - } - }, - "ListGlobalTablesInput":{ - "type":"structure", - "members":{ - "ExclusiveStartGlobalTableName":{ - "shape":"TableName", - "documentation":"

The first global table name that this operation will evaluate.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of table names to return.

" - }, - "RegionName":{ - "shape":"RegionName", - "documentation":"

Lists the global tables in a specific region.

" - } - } - }, - "ListGlobalTablesOutput":{ - "type":"structure", - "members":{ - "GlobalTables":{ - "shape":"GlobalTableList", - "documentation":"

List of global table names.

" - }, - "LastEvaluatedGlobalTableName":{ - "shape":"TableName", - "documentation":"

Last evaluated global table name.

" - } - } - }, - "ListTablesInput":{ - "type":"structure", - "members":{ - "ExclusiveStartTableName":{ - "shape":"TableName", - "documentation":"

The first table name that this operation will evaluate. Use the value that was returned for LastEvaluatedTableName in a previous operation, so that you can obtain the next page of results.

" - }, - "Limit":{ - "shape":"ListTablesInputLimit", - "documentation":"

A maximum number of table names to return. If this parameter is not specified, the limit is 100.

" - } - }, - "documentation":"

Represents the input of a ListTables operation.

" - }, - "ListTablesInputLimit":{ - "type":"integer", - "max":100, - "min":1 - }, - "ListTablesOutput":{ - "type":"structure", - "members":{ - "TableNames":{ - "shape":"TableNameList", - "documentation":"

The names of the tables associated with the current account at the current endpoint. The maximum size of this array is 100.

If LastEvaluatedTableName also appears in the output, you can use this value as the ExclusiveStartTableName parameter in a subsequent ListTables request and obtain the next page of results.

" - }, - "LastEvaluatedTableName":{ - "shape":"TableName", - "documentation":"

The name of the last table in the current page of results. Use this value as the ExclusiveStartTableName in a new request to obtain the next page of results, until all the table names are returned.

If you do not receive a LastEvaluatedTableName value in the response, this means that there are no more table names to be retrieved.

" - } - }, - "documentation":"

Represents the output of a ListTables operation.

" - }, - "ListTagsOfResourceInput":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArnString", - "documentation":"

The Amazon DynamoDB resource with tags to be listed. This value is an Amazon Resource Name (ARN).

" - }, - "NextToken":{ - "shape":"NextTokenString", - "documentation":"

An optional string that, if supplied, must be copied from the output of a previous call to ListTagOfResource. When provided in this manner, this API fetches the next page of results.

" - } - } - }, - "ListTagsOfResourceOutput":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The tags currently associated with the Amazon DynamoDB resource.

" - }, - "NextToken":{ - "shape":"NextTokenString", - "documentation":"

If this value is returned, there are additional results to be displayed. To retrieve them, call ListTagsOfResource again, with NextToken set to this value.

" - } - } - }, - "LocalSecondaryIndex":{ - "type":"structure", - "required":[ - "IndexName", - "KeySchema", - "Projection" - ], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the local secondary index. The name must be unique among all other indexes on this table.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - } - }, - "documentation":"

Represents the properties of a local secondary index.

" - }, - "LocalSecondaryIndexDescription":{ - "type":"structure", - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

Represents the name of the local secondary index.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "IndexSizeBytes":{ - "shape":"Long", - "documentation":"

The total size of the specified index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "ItemCount":{ - "shape":"Long", - "documentation":"

The number of items in the specified index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "IndexArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that uniquely identifies the index.

" - } - }, - "documentation":"

Represents the properties of a local secondary index.

" - }, - "LocalSecondaryIndexDescriptionList":{ - "type":"list", - "member":{"shape":"LocalSecondaryIndexDescription"} - }, - "LocalSecondaryIndexInfo":{ - "type":"structure", - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

Represents the name of the local secondary index.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The complete key schema for a local secondary index, which consists of one or more pairs of attribute names and key types:

  • HASH - partition key

  • RANGE - sort key

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "Projection":{ - "shape":"Projection", - "documentation":"

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - } - }, - "documentation":"

Represents the properties of a local secondary index for the table when the backup was created.

" - }, - "LocalSecondaryIndexList":{ - "type":"list", - "member":{"shape":"LocalSecondaryIndex"} - }, - "LocalSecondaryIndexes":{ - "type":"list", - "member":{"shape":"LocalSecondaryIndexInfo"} - }, - "Long":{"type":"long"}, - "MapAttributeValue":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "NextTokenString":{"type":"string"}, - "NonKeyAttributeName":{ - "type":"string", - "max":255, - "min":1 - }, - "NonKeyAttributeNameList":{ - "type":"list", - "member":{"shape":"NonKeyAttributeName"}, - "max":20, - "min":1 - }, - "NullAttributeValue":{"type":"boolean"}, - "NumberAttributeValue":{"type":"string"}, - "NumberSetAttributeValue":{ - "type":"list", - "member":{"shape":"NumberAttributeValue"} - }, - "PointInTimeRecoveryDescription":{ - "type":"structure", - "members":{ - "PointInTimeRecoveryStatus":{ - "shape":"PointInTimeRecoveryStatus", - "documentation":"

The current state of point in time recovery:

  • ENABLING - Point in time recovery is being enabled.

  • ENABLED - Point in time recovery is enabled.

  • DISABLED - Point in time recovery is disabled.

" - }, - "EarliestRestorableDateTime":{ - "shape":"Date", - "documentation":"

Specifies the earliest point in time you can restore your table to. It You can restore your table to any point in time during the last 35 days.

" - }, - "LatestRestorableDateTime":{ - "shape":"Date", - "documentation":"

LatestRestorableDateTime is typically 5 minutes before the current time.

" - } - }, - "documentation":"

The description of the point in time settings applied to the table.

" - }, - "PointInTimeRecoverySpecification":{ - "type":"structure", - "required":["PointInTimeRecoveryEnabled"], - "members":{ - "PointInTimeRecoveryEnabled":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

" - } - }, - "documentation":"

Represents the settings used to enable point in time recovery.

" - }, - "PointInTimeRecoveryStatus":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "PointInTimeRecoveryUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Point in time recovery has not yet been enabled for this source table.

", - "exception":true - }, - "PositiveIntegerObject":{ - "type":"integer", - "min":1 - }, - "PositiveLongObject":{ - "type":"long", - "min":1 - }, - "Projection":{ - "type":"structure", - "members":{ - "ProjectionType":{ - "shape":"ProjectionType", - "documentation":"

The set of attributes that are projected into the index:

  • KEYS_ONLY - Only the index and primary keys are projected into the index.

  • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.

  • ALL - All of the table attributes are projected into the index.

" - }, - "NonKeyAttributes":{ - "shape":"NonKeyAttributeNameList", - "documentation":"

Represents the non-key attribute names which will be projected into the index.

For local secondary indexes, the total count of NonKeyAttributes summed across all of the local secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

" - } - }, - "documentation":"

Represents attributes that are copied (projected) from the table into an index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

" - }, - "ProjectionExpression":{"type":"string"}, - "ProjectionType":{ - "type":"string", - "enum":[ - "ALL", - "KEYS_ONLY", - "INCLUDE" - ] - }, - "ProvisionedThroughput":{ - "type":"structure", - "required":[ - "ReadCapacityUnits", - "WriteCapacityUnits" - ], - "members":{ - "ReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.

" - }, - "WriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the provisioned throughput settings for a specified table or index. The settings can be modified using the UpdateTable operation.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - }, - "ProvisionedThroughputDescription":{ - "type":"structure", - "members":{ - "LastIncreaseDateTime":{ - "shape":"Date", - "documentation":"

The date and time of the last provisioned throughput increase for this table.

" - }, - "LastDecreaseDateTime":{ - "shape":"Date", - "documentation":"

The date and time of the last provisioned throughput decrease for this table.

" - }, - "NumberOfDecreasesToday":{ - "shape":"PositiveLongObject", - "documentation":"

The number of provisioned throughput decreases for this table during this UTC calendar day. For current maximums on provisioned throughput decreases, see Limits in the Amazon DynamoDB Developer Guide.

" - }, - "ReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException. Eventually consistent reads require less effort than strongly consistent reads, so a setting of 50 ReadCapacityUnits per second provides 100 eventually consistent ReadCapacityUnits per second.

" - }, - "WriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException.

" - } - }, - "documentation":"

Represents the provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.

" - }, - "ProvisionedThroughputExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

You exceeded your maximum allowed provisioned throughput.

" - } - }, - "documentation":"

Your request rate is too high. The AWS SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.

", - "exception":true - }, - "PutItemInput":{ - "type":"structure", - "required":[ - "TableName", - "Item" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to contain the item.

" - }, - "Item":{ - "shape":"PutItemInputAttributeMap", - "documentation":"

A map of attribute name/value pairs, one for each attribute. Only the primary key attributes are required; you can optionally provide other attribute name-value pairs for the item.

You must provide all of the attributes for the primary key. For example, with a simple primary key, you only need to provide a value for the partition key. For a composite primary key, you must provide both values for both the partition key and the sort key.

If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition.

For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide.

Each element in the Item map is an AttributeValue object.

" - }, - "Expected":{ - "shape":"ExpectedAttributeMap", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see Expected in the Amazon DynamoDB Developer Guide.

" - }, - "ReturnValues":{ - "shape":"ReturnValue", - "documentation":"

Use ReturnValues if you want to get the item attributes as they appeared before they were updated with the PutItem request. For PutItem, the valid values are:

  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This setting is the default for ReturnValues.)

  • ALL_OLD - If PutItem overwrote an attribute name-value pair, then the content of the old item is returned.

The ReturnValues parameter is used by several DynamoDB operations; however, PutItem does not recognize any values other than NONE or ALL_OLD.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ReturnItemCollectionMetrics":{ - "shape":"ReturnItemCollectionMetrics", - "documentation":"

Determines whether item collection metrics are returned. If set to SIZE, the response includes statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned.

" - }, - "ConditionalOperator":{ - "shape":"ConditionalOperator", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionExpression":{ - "shape":"ConditionExpression", - "documentation":"

A condition that must be satisfied in order for a conditional PutItem operation to succeed.

An expression can contain any of the following:

  • Functions: attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size

    These function names are case-sensitive.

  • Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN

  • Logical operators: AND | OR | NOT

For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeValues":{ - "shape":"ExpressionAttributeValueMap", - "documentation":"

One or more values that can be substituted in an expression.

Use the : (colon) character in an expression to dereference an attribute value. For example, suppose that you wanted to check whether the value of the ProductStatus attribute was one of the following:

Available | Backordered | Discontinued

You would first need to specify ExpressionAttributeValues as follows:

{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }

You could then use these values in an expression, such as this:

ProductStatus IN (:avail, :back, :disc)

For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the input of a PutItem operation.

" - }, - "PutItemInputAttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "PutItemOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeMap", - "documentation":"

The attribute values as they appeared before the PutItem operation, but only if ReturnValues is specified as ALL_OLD in the request. Each element consists of an attribute name and an attribute value.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the PutItem operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - }, - "ItemCollectionMetrics":{ - "shape":"ItemCollectionMetrics", - "documentation":"

Information about item collections, if any, that were affected by the PutItem operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics parameter was specified. If the table does not have any local secondary indexes, this information is not returned in the response.

Each ItemCollectionMetrics element consists of:

  • ItemCollectionKey - The partition key value of the item collection. This is the same as the partition key value of the item itself.

  • SizeEstimateRangeGB - An estimate of item collection size, in gigabytes. This value is a two-element array containing a lower bound and an upper bound for the estimate. The estimate includes the size of all the items in the table, plus the size of all attributes projected into all of the local secondary indexes on that table. Use this estimate to measure whether a local secondary index is approaching its size limit.

    The estimate is subject to change over time; therefore, do not rely on the precision or accuracy of the estimate.

" - } - }, - "documentation":"

Represents the output of a PutItem operation.

" - }, - "PutRequest":{ - "type":"structure", - "required":["Item"], - "members":{ - "Item":{ - "shape":"PutItemInputAttributeMap", - "documentation":"

A map of attribute name to attribute values, representing the primary key of an item to be processed by PutItem. All of the table's primary key attributes must be specified, and their data types must match those of the table's key schema. If any attributes are present in the item which are part of an index key schema for the table, their types must match the index key schema.

" - } - }, - "documentation":"

Represents a request to perform a PutItem operation on an item.

" - }, - "QueryInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table containing the requested items.

" - }, - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of an index to query. This index can be any local secondary index or global secondary index on the table. Note that if you use the IndexName parameter, you must also provide TableName.

" - }, - "Select":{ - "shape":"Select", - "documentation":"

The attributes to be returned in the result. You can retrieve all item attributes, specific item attributes, the count of matching items, or in the case of an index, some or all of the attributes projected into the index.

  • ALL_ATTRIBUTES - Returns all of the item attributes from the specified table or index. If you query a local secondary index, then for each matching item in the index DynamoDB will fetch the entire item from the parent table. If the index is configured to project all item attributes, then all of the data can be obtained from the local secondary index, and no fetching is required.

  • ALL_PROJECTED_ATTRIBUTES - Allowed only when querying an index. Retrieves all attributes that have been projected into the index. If the index is configured to project all attributes, this return value is equivalent to specifying ALL_ATTRIBUTES.

  • COUNT - Returns the number of matching items, rather than the matching items themselves.

  • SPECIFIC_ATTRIBUTES - Returns only the attributes listed in AttributesToGet. This return value is equivalent to specifying AttributesToGet without specifying any value for Select.

    If you query or scan a local secondary index and request only attributes that are projected into that index, the operation will read only the index and not the table. If any of the requested attributes are not projected into the local secondary index, DynamoDB will fetch each of these attributes from the parent table. This extra fetching incurs additional throughput cost and latency.

    If you query or scan a global secondary index, you can only request attributes that are projected into the index. Global secondary index queries cannot fetch attributes from the parent table.

If neither Select nor AttributesToGet are specified, DynamoDB defaults to ALL_ATTRIBUTES when accessing a table, and ALL_PROJECTED_ATTRIBUTES when accessing an index. You cannot use both Select and AttributesToGet together in a single request, unless the value for Select is SPECIFIC_ATTRIBUTES. (This usage is equivalent to specifying AttributesToGet without any value for Select.)

If you use the ProjectionExpression parameter, then the value for Select can only be SPECIFIC_ATTRIBUTES. Any other value for Select will return an error.

" - }, - "AttributesToGet":{ - "shape":"AttributeNameList", - "documentation":"

This is a legacy parameter. Use ProjectionExpression instead. For more information, see AttributesToGet in the Amazon DynamoDB Developer Guide.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of items to evaluate (not necessarily the number of matching items). If DynamoDB processes the number of items up to the limit while processing the results, it stops the operation and returns the matching values up to that point, and a key in LastEvaluatedKey to apply in a subsequent operation, so that you can pick up where you left off. Also, if the processed data set size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation and returns the matching values up to the limit, and a key in LastEvaluatedKey to apply in a subsequent operation to continue the operation. For more information, see Query and Scan in the Amazon DynamoDB Developer Guide.

" - }, - "ConsistentRead":{ - "shape":"ConsistentRead", - "documentation":"

Determines the read consistency model: If set to true, then the operation uses strongly consistent reads; otherwise, the operation uses eventually consistent reads.

Strongly consistent reads are not supported on global secondary indexes. If you query a global secondary index with ConsistentRead set to true, you will receive a ValidationException.

" - }, - "KeyConditions":{ - "shape":"KeyConditions", - "documentation":"

This is a legacy parameter. Use KeyConditionExpression instead. For more information, see KeyConditions in the Amazon DynamoDB Developer Guide.

" - }, - "QueryFilter":{ - "shape":"FilterConditionMap", - "documentation":"

This is a legacy parameter. Use FilterExpression instead. For more information, see QueryFilter in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionalOperator":{ - "shape":"ConditionalOperator", - "documentation":"

This is a legacy parameter. Use FilterExpression instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.

" - }, - "ScanIndexForward":{ - "shape":"BooleanObject", - "documentation":"

Specifies the order for index traversal: If true (default), the traversal is performed in ascending order; if false, the traversal is performed in descending order.

Items with the same partition key value are stored in sorted order by sort key. If the sort key data type is Number, the results are stored in numeric order. For type String, the results are stored in order of UTF-8 bytes. For type Binary, DynamoDB treats each byte of the binary data as unsigned.

If ScanIndexForward is true, DynamoDB returns the results in the order in which they are stored (by sort key value). This is the default behavior. If ScanIndexForward is false, DynamoDB reads the results in reverse order by sort key value, and then returns the results to the client.

" - }, - "ExclusiveStartKey":{ - "shape":"Key", - "documentation":"

The primary key of the first item that this operation will evaluate. Use the value that was returned for LastEvaluatedKey in the previous operation.

The data type for ExclusiveStartKey must be String, Number or Binary. No set data types are allowed.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ProjectionExpression":{ - "shape":"ProjectionExpression", - "documentation":"

A string that identifies one or more attributes to retrieve from the table. These attributes can include scalars, sets, or elements of a JSON document. The attributes in the expression must be separated by commas.

If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "FilterExpression":{ - "shape":"ConditionExpression", - "documentation":"

A string that contains conditions that DynamoDB applies after the Query operation, but before the data is returned to you. Items that do not satisfy the FilterExpression criteria are not returned.

A FilterExpression does not allow key attributes. You cannot define a filter expression based on a partition key or a sort key.

A FilterExpression is applied after the items have already been read; the process of filtering does not consume any additional read capacity units.

For more information, see Filter Expressions in the Amazon DynamoDB Developer Guide.

" - }, - "KeyConditionExpression":{ - "shape":"KeyExpression", - "documentation":"

The condition that specifies the key value(s) for items to be retrieved by the Query action.

The condition must perform an equality test on a single partition key value.

The condition can optionally perform one of several comparison tests on a single sort key value. This allows Query to retrieve one item with a given partition key value and sort key value, or several items that have the same partition key value but different sort key values.

The partition key equality test is required, and must be specified in the following format:

partitionKeyName = :partitionkeyval

If you also want to provide a condition for the sort key, it must be combined using AND with the condition for the sort key. Following is an example, using the = comparison operator for the sort key:

partitionKeyName = :partitionkeyval AND sortKeyName = :sortkeyval

Valid comparisons for the sort key condition are as follows:

  • sortKeyName = :sortkeyval - true if the sort key value is equal to :sortkeyval.

  • sortKeyName < :sortkeyval - true if the sort key value is less than :sortkeyval.

  • sortKeyName <= :sortkeyval - true if the sort key value is less than or equal to :sortkeyval.

  • sortKeyName > :sortkeyval - true if the sort key value is greater than :sortkeyval.

  • sortKeyName >= :sortkeyval - true if the sort key value is greater than or equal to :sortkeyval.

  • sortKeyName BETWEEN :sortkeyval1 AND :sortkeyval2 - true if the sort key value is greater than or equal to :sortkeyval1, and less than or equal to :sortkeyval2.

  • begins_with ( sortKeyName, :sortkeyval ) - true if the sort key value begins with a particular operand. (You cannot use this function with a sort key that is of type Number.) Note that the function name begins_with is case-sensitive.

Use the ExpressionAttributeValues parameter to replace tokens such as :partitionval and :sortval with actual values at runtime.

You can optionally use the ExpressionAttributeNames parameter to replace the names of the partition key and sort key with placeholder tokens. This option might be necessary if an attribute name conflicts with a DynamoDB reserved word. For example, the following KeyConditionExpression parameter causes an error because Size is a reserved word:

  • Size = :myval

To work around this, define a placeholder (such a #S) to represent the attribute name Size. KeyConditionExpression then is as follows:

  • #S = :myval

For a list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide.

For more information on ExpressionAttributeNames and ExpressionAttributeValues, see Using Placeholders for Attribute Names and Values in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeValues":{ - "shape":"ExpressionAttributeValueMap", - "documentation":"

One or more values that can be substituted in an expression.

Use the : (colon) character in an expression to dereference an attribute value. For example, suppose that you wanted to check whether the value of the ProductStatus attribute was one of the following:

Available | Backordered | Discontinued

You would first need to specify ExpressionAttributeValues as follows:

{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }

You could then use these values in an expression, such as this:

ProductStatus IN (:avail, :back, :disc)

For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the input of a Query operation.

" - }, - "QueryOutput":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"ItemList", - "documentation":"

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

" - }, - "ScannedCount":{ - "shape":"Integer", - "documentation":"

The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

" - }, - "LastEvaluatedKey":{ - "shape":"Key", - "documentation":"

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the \"last page\" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the output of a Query operation.

" - }, - "RegionName":{"type":"string"}, - "Replica":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The region where the replica needs to be created.

" - } - }, - "documentation":"

Represents the properties of a replica.

" - }, - "ReplicaAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified replica is already part of the global table.

", - "exception":true - }, - "ReplicaDescription":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The name of the region.

" - } - }, - "documentation":"

Contains the details of the replica.

" - }, - "ReplicaDescriptionList":{ - "type":"list", - "member":{"shape":"ReplicaDescription"} - }, - "ReplicaGlobalSecondaryIndexSettingsDescription":{ - "type":"structure", - "required":["IndexName"], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index. The name must be unique among all other indexes on this table.

" - }, - "IndexStatus":{ - "shape":"IndexStatus", - "documentation":"

The current status of the global secondary index:

  • CREATING - The global secondary index is being created.

  • UPDATING - The global secondary index is being updated.

  • DELETING - The global secondary index is being deleted.

  • ACTIVE - The global secondary index is ready for use.

" - }, - "ProvisionedReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException.

" - }, - "ProvisionedReadCapacityAutoScalingSettings":{ - "shape":"AutoScalingSettingsDescription", - "documentation":"

Autoscaling settings for a global secondary index replica's read capacity units.

" - }, - "ProvisionedWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException.

" - }, - "ProvisionedWriteCapacityAutoScalingSettings":{ - "shape":"AutoScalingSettingsDescription", - "documentation":"

AutoScaling settings for a global secondary index replica's write capacity units.

" - } - }, - "documentation":"

Represents the properties of a global secondary index.

" - }, - "ReplicaGlobalSecondaryIndexSettingsDescriptionList":{ - "type":"list", - "member":{"shape":"ReplicaGlobalSecondaryIndexSettingsDescription"} - }, - "ReplicaGlobalSecondaryIndexSettingsUpdate":{ - "type":"structure", - "required":["IndexName"], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index. The name must be unique among all other indexes on this table.

" - }, - "ProvisionedReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException.

" - }, - "ProvisionedReadCapacityAutoScalingSettingsUpdate":{ - "shape":"AutoScalingSettingsUpdate", - "documentation":"

Autoscaling settings for managing a global secondary index replica's read capacity units.

" - } - }, - "documentation":"

Represents the settings of a global secondary index for a global table that will be modified.

" - }, - "ReplicaGlobalSecondaryIndexSettingsUpdateList":{ - "type":"list", - "member":{"shape":"ReplicaGlobalSecondaryIndexSettingsUpdate"}, - "max":20, - "min":1 - }, - "ReplicaList":{ - "type":"list", - "member":{"shape":"Replica"} - }, - "ReplicaNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified replica is no longer part of the global table.

", - "exception":true - }, - "ReplicaSettingsDescription":{ - "type":"structure", - "required":["RegionName"], - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The region name of the replica.

" - }, - "ReplicaStatus":{ - "shape":"ReplicaStatus", - "documentation":"

The current state of the region:

  • CREATING - The region is being created.

  • UPDATING - The region is being updated.

  • DELETING - The region is being deleted.

  • ACTIVE - The region is ready for use.

" - }, - "ReplicaProvisionedReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.

" - }, - "ReplicaProvisionedReadCapacityAutoScalingSettings":{ - "shape":"AutoScalingSettingsDescription", - "documentation":"

Autoscaling settings for a global table replica's read capacity units.

" - }, - "ReplicaProvisionedWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.

" - }, - "ReplicaProvisionedWriteCapacityAutoScalingSettings":{ - "shape":"AutoScalingSettingsDescription", - "documentation":"

AutoScaling settings for a global table replica's write capacity units.

" - }, - "ReplicaGlobalSecondaryIndexSettings":{ - "shape":"ReplicaGlobalSecondaryIndexSettingsDescriptionList", - "documentation":"

Replica global secondary index settings for the global table.

" - } - }, - "documentation":"

Represents the properties of a replica.

" - }, - "ReplicaSettingsDescriptionList":{ - "type":"list", - "member":{"shape":"ReplicaSettingsDescription"} - }, - "ReplicaSettingsUpdate":{ - "type":"structure", - "required":["RegionName"], - "members":{ - "RegionName":{ - "shape":"RegionName", - "documentation":"

The region of the replica to be added.

" - }, - "ReplicaProvisionedReadCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of strongly consistent reads consumed per second before DynamoDB returns a ThrottlingException. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.

" - }, - "ReplicaProvisionedReadCapacityAutoScalingSettingsUpdate":{ - "shape":"AutoScalingSettingsUpdate", - "documentation":"

Autoscaling settings for managing a global table replica's read capacity units.

" - }, - "ReplicaGlobalSecondaryIndexSettingsUpdate":{ - "shape":"ReplicaGlobalSecondaryIndexSettingsUpdateList", - "documentation":"

Represents the settings of a global secondary index for a global table that will be modified.

" - } - }, - "documentation":"

Represents the settings for a global table in a region that will be modified.

" - }, - "ReplicaSettingsUpdateList":{ - "type":"list", - "member":{"shape":"ReplicaSettingsUpdate"}, - "max":50, - "min":1 - }, - "ReplicaStatus":{ - "type":"string", - "enum":[ - "CREATING", - "UPDATING", - "DELETING", - "ACTIVE" - ] - }, - "ReplicaUpdate":{ - "type":"structure", - "members":{ - "Create":{ - "shape":"CreateReplicaAction", - "documentation":"

The parameters required for creating a replica on an existing global table.

" - }, - "Delete":{ - "shape":"DeleteReplicaAction", - "documentation":"

The name of the existing replica to be removed.

" - } - }, - "documentation":"

Represents one of the following:

  • A new replica to be added to an existing global table.

  • New parameters for an existing replica.

  • An existing replica to be removed from an existing global table.

" - }, - "ReplicaUpdateList":{ - "type":"list", - "member":{"shape":"ReplicaUpdate"} - }, - "ResourceArnString":{ - "type":"string", - "max":1283, - "min":1 - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The resource which is being attempted to be changed is in use.

" - } - }, - "documentation":"

The operation conflicts with the resource's availability. For example, you attempted to recreate an existing table, or tried to delete a table currently in the CREATING state.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The resource which is being requested does not exist.

" - } - }, - "documentation":"

The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE.

", - "exception":true - }, - "RestoreInProgress":{"type":"boolean"}, - "RestoreSummary":{ - "type":"structure", - "required":[ - "RestoreDateTime", - "RestoreInProgress" - ], - "members":{ - "SourceBackupArn":{ - "shape":"BackupArn", - "documentation":"

ARN of the backup from which the table was restored.

" - }, - "SourceTableArn":{ - "shape":"TableArn", - "documentation":"

ARN of the source table of the backup that is being restored.

" - }, - "RestoreDateTime":{ - "shape":"Date", - "documentation":"

Point in time or source backup time.

" - }, - "RestoreInProgress":{ - "shape":"RestoreInProgress", - "documentation":"

Indicates if a restore is in progress or not.

" - } - }, - "documentation":"

Contains details for the restore.

" - }, - "RestoreTableFromBackupInput":{ - "type":"structure", - "required":[ - "TargetTableName", - "BackupArn" - ], - "members":{ - "TargetTableName":{ - "shape":"TableName", - "documentation":"

The name of the new table to which the backup must be restored.

" - }, - "BackupArn":{ - "shape":"BackupArn", - "documentation":"

The ARN associated with the backup.

" - } - } - }, - "RestoreTableFromBackupOutput":{ - "type":"structure", - "members":{ - "TableDescription":{ - "shape":"TableDescription", - "documentation":"

The description of the table created from an existing backup.

" - } - } - }, - "RestoreTableToPointInTimeInput":{ - "type":"structure", - "required":[ - "SourceTableName", - "TargetTableName" - ], - "members":{ - "SourceTableName":{ - "shape":"TableName", - "documentation":"

Name of the source table that is being restored.

" - }, - "TargetTableName":{ - "shape":"TableName", - "documentation":"

The name of the new table to which it must be restored to.

" - }, - "UseLatestRestorableTime":{ - "shape":"BooleanObject", - "documentation":"

Restore the table to the latest possible time. LatestRestorableDateTime is typically 5 minutes before the current time.

" - }, - "RestoreDateTime":{ - "shape":"Date", - "documentation":"

Time in the past to restore the table to.

" - } - } - }, - "RestoreTableToPointInTimeOutput":{ - "type":"structure", - "members":{ - "TableDescription":{ - "shape":"TableDescription", - "documentation":"

Represents the properties of a table.

" - } - } - }, - "ReturnConsumedCapacity":{ - "type":"string", - "documentation":"

Determines the level of detail about provisioned throughput consumption that is returned in the response:

  • INDEXES - The response includes the aggregate ConsumedCapacity for the operation, together with ConsumedCapacity for each table and secondary index that was accessed.

    Note that some operations, such as GetItem and BatchGetItem, do not access any indexes at all. In these cases, specifying INDEXES will only return ConsumedCapacity information for table(s).

  • TOTAL - The response includes only the aggregate ConsumedCapacity for the operation.

  • NONE - No ConsumedCapacity details are included in the response.

", - "enum":[ - "INDEXES", - "TOTAL", - "NONE" - ] - }, - "ReturnItemCollectionMetrics":{ - "type":"string", - "enum":[ - "SIZE", - "NONE" - ] - }, - "ReturnValue":{ - "type":"string", - "enum":[ - "NONE", - "ALL_OLD", - "UPDATED_OLD", - "ALL_NEW", - "UPDATED_NEW" - ] - }, - "SSEDescription":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SSEStatus", - "documentation":"

The current state of server-side encryption:

  • ENABLING - Server-side encryption is being enabled.

  • ENABLED - Server-side encryption is enabled.

  • DISABLING - Server-side encryption is being disabled.

  • DISABLED - Server-side encryption is disabled.

" - }, - "SSEType":{ - "shape":"SSEType", - "documentation":"

Server-side encryption type:

  • AES256 - Server-side encryption which uses the AES256 algorithm.

  • KMS - Server-side encryption which uses AWS Key Management Service.

" - }, - "KMSMasterKeyArn":{ - "shape":"KMSMasterKeyArn", - "documentation":"

The KMS master key ARN used for the KMS encryption.

" - } - }, - "documentation":"

The description of the server-side encryption status on the specified table.

" - }, - "SSEEnabled":{"type":"boolean"}, - "SSESpecification":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"SSEEnabled", - "documentation":"

Indicates whether server-side encryption is enabled (true) or disabled (false) on the table.

" - } - }, - "documentation":"

Represents the settings used to enable server-side encryption.

" - }, - "SSEStatus":{ - "type":"string", - "enum":[ - "ENABLING", - "ENABLED", - "DISABLING", - "DISABLED" - ] - }, - "SSEType":{ - "type":"string", - "enum":[ - "AES256", - "KMS" - ] - }, - "ScalarAttributeType":{ - "type":"string", - "enum":[ - "S", - "N", - "B" - ] - }, - "ScanInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table containing the requested items; or, if you provide IndexName, the name of the table to which that index belongs.

" - }, - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of a secondary index to scan. This index can be any local secondary index or global secondary index. Note that if you use the IndexName parameter, you must also provide TableName.

" - }, - "AttributesToGet":{ - "shape":"AttributeNameList", - "documentation":"

This is a legacy parameter. Use ProjectionExpression instead. For more information, see AttributesToGet in the Amazon DynamoDB Developer Guide.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of items to evaluate (not necessarily the number of matching items). If DynamoDB processes the number of items up to the limit while processing the results, it stops the operation and returns the matching values up to that point, and a key in LastEvaluatedKey to apply in a subsequent operation, so that you can pick up where you left off. Also, if the processed data set size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation and returns the matching values up to the limit, and a key in LastEvaluatedKey to apply in a subsequent operation to continue the operation. For more information, see Query and Scan in the Amazon DynamoDB Developer Guide.

" - }, - "Select":{ - "shape":"Select", - "documentation":"

The attributes to be returned in the result. You can retrieve all item attributes, specific item attributes, the count of matching items, or in the case of an index, some or all of the attributes projected into the index.

  • ALL_ATTRIBUTES - Returns all of the item attributes from the specified table or index. If you query a local secondary index, then for each matching item in the index DynamoDB will fetch the entire item from the parent table. If the index is configured to project all item attributes, then all of the data can be obtained from the local secondary index, and no fetching is required.

  • ALL_PROJECTED_ATTRIBUTES - Allowed only when querying an index. Retrieves all attributes that have been projected into the index. If the index is configured to project all attributes, this return value is equivalent to specifying ALL_ATTRIBUTES.

  • COUNT - Returns the number of matching items, rather than the matching items themselves.

  • SPECIFIC_ATTRIBUTES - Returns only the attributes listed in AttributesToGet. This return value is equivalent to specifying AttributesToGet without specifying any value for Select.

    If you query or scan a local secondary index and request only attributes that are projected into that index, the operation will read only the index and not the table. If any of the requested attributes are not projected into the local secondary index, DynamoDB will fetch each of these attributes from the parent table. This extra fetching incurs additional throughput cost and latency.

    If you query or scan a global secondary index, you can only request attributes that are projected into the index. Global secondary index queries cannot fetch attributes from the parent table.

If neither Select nor AttributesToGet are specified, DynamoDB defaults to ALL_ATTRIBUTES when accessing a table, and ALL_PROJECTED_ATTRIBUTES when accessing an index. You cannot use both Select and AttributesToGet together in a single request, unless the value for Select is SPECIFIC_ATTRIBUTES. (This usage is equivalent to specifying AttributesToGet without any value for Select.)

If you use the ProjectionExpression parameter, then the value for Select can only be SPECIFIC_ATTRIBUTES. Any other value for Select will return an error.

" - }, - "ScanFilter":{ - "shape":"FilterConditionMap", - "documentation":"

This is a legacy parameter. Use FilterExpression instead. For more information, see ScanFilter in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionalOperator":{ - "shape":"ConditionalOperator", - "documentation":"

This is a legacy parameter. Use FilterExpression instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.

" - }, - "ExclusiveStartKey":{ - "shape":"Key", - "documentation":"

The primary key of the first item that this operation will evaluate. Use the value that was returned for LastEvaluatedKey in the previous operation.

The data type for ExclusiveStartKey must be String, Number or Binary. No set data types are allowed.

In a parallel scan, a Scan request that includes ExclusiveStartKey must specify the same segment whose previous Scan returned the corresponding value of LastEvaluatedKey.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "TotalSegments":{ - "shape":"ScanTotalSegments", - "documentation":"

For a parallel Scan request, TotalSegments represents the total number of segments into which the Scan operation will be divided. The value of TotalSegments corresponds to the number of application workers that will perform the parallel scan. For example, if you want to use four application threads to scan a table or an index, specify a TotalSegments value of 4.

The value for TotalSegments must be greater than or equal to 1, and less than or equal to 1000000. If you specify a TotalSegments value of 1, the Scan operation will be sequential rather than parallel.

If you specify TotalSegments, you must also specify Segment.

" - }, - "Segment":{ - "shape":"ScanSegment", - "documentation":"

For a parallel Scan request, Segment identifies an individual segment to be scanned by an application worker.

Segment IDs are zero-based, so the first segment is always 0. For example, if you want to use four application threads to scan a table or an index, then the first thread specifies a Segment value of 0, the second thread specifies 1, and so on.

The value of LastEvaluatedKey returned from a parallel Scan request must be used as ExclusiveStartKey with the same segment ID in a subsequent Scan operation.

The value for Segment must be greater than or equal to 0, and less than the value provided for TotalSegments.

If you provide Segment, you must also provide TotalSegments.

" - }, - "ProjectionExpression":{ - "shape":"ProjectionExpression", - "documentation":"

A string that identifies one or more attributes to retrieve from the specified table or index. These attributes can include scalars, sets, or elements of a JSON document. The attributes in the expression must be separated by commas.

If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "FilterExpression":{ - "shape":"ConditionExpression", - "documentation":"

A string that contains conditions that DynamoDB applies after the Scan operation, but before the data is returned to you. Items that do not satisfy the FilterExpression criteria are not returned.

A FilterExpression is applied after the items have already been read; the process of filtering does not consume any additional read capacity units.

For more information, see Filter Expressions in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeValues":{ - "shape":"ExpressionAttributeValueMap", - "documentation":"

One or more values that can be substituted in an expression.

Use the : (colon) character in an expression to dereference an attribute value. For example, suppose that you wanted to check whether the value of the ProductStatus attribute was one of the following:

Available | Backordered | Discontinued

You would first need to specify ExpressionAttributeValues as follows:

{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }

You could then use these values in an expression, such as this:

ProductStatus IN (:avail, :back, :disc)

For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - }, - "ConsistentRead":{ - "shape":"ConsistentRead", - "documentation":"

A Boolean value that determines the read consistency model during the scan:

  • If ConsistentRead is false, then the data returned from Scan might not contain the results from other recently completed write operations (PutItem, UpdateItem or DeleteItem).

  • If ConsistentRead is true, then all of the write operations that completed before the Scan began are guaranteed to be contained in the Scan response.

The default setting for ConsistentRead is false.

The ConsistentRead parameter is not supported on global secondary indexes. If you scan a global secondary index with ConsistentRead set to true, you will receive a ValidationException.

" - } - }, - "documentation":"

Represents the input of a Scan operation.

" - }, - "ScanOutput":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"ItemList", - "documentation":"

An array of item attributes that match the scan criteria. Each element in this array consists of an attribute name and the value for that attribute.

" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of items in the response.

If you set ScanFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count is the same as ScannedCount.

" - }, - "ScannedCount":{ - "shape":"Integer", - "documentation":"

The number of items evaluated, before any ScanFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Scan operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

" - }, - "LastEvaluatedKey":{ - "shape":"Key", - "documentation":"

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the \"last page\" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the Scan operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the output of a Scan operation.

" - }, - "ScanSegment":{ - "type":"integer", - "max":999999, - "min":0 - }, - "ScanTotalSegments":{ - "type":"integer", - "max":1000000, - "min":1 - }, - "SecondaryIndexesCapacityMap":{ - "type":"map", - "key":{"shape":"IndexName"}, - "value":{"shape":"Capacity"} - }, - "Select":{ - "type":"string", - "enum":[ - "ALL_ATTRIBUTES", - "ALL_PROJECTED_ATTRIBUTES", - "SPECIFIC_ATTRIBUTES", - "COUNT" - ] - }, - "SourceTableDetails":{ - "type":"structure", - "required":[ - "TableName", - "TableId", - "KeySchema", - "TableCreationDateTime", - "ProvisionedThroughput" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table for which the backup was created.

" - }, - "TableId":{ - "shape":"TableId", - "documentation":"

Unique identifier for the table for which the backup was created.

" - }, - "TableArn":{ - "shape":"TableArn", - "documentation":"

ARN of the table for which backup was created.

" - }, - "TableSizeBytes":{ - "shape":"Long", - "documentation":"

Size of the table in bytes. Please note this is an approximate value.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

Schema of the table.

" - }, - "TableCreationDateTime":{ - "shape":"TableCreationDateTime", - "documentation":"

Time when the source table was created.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Read IOPs and Write IOPS on the table when the backup was created.

" - }, - "ItemCount":{ - "shape":"ItemCount", - "documentation":"

Number of items in the table. Please note this is an approximate value.

" - } - }, - "documentation":"

Contains the details of the table when the backup was created.

" - }, - "SourceTableFeatureDetails":{ - "type":"structure", - "members":{ - "LocalSecondaryIndexes":{ - "shape":"LocalSecondaryIndexes", - "documentation":"

Represents the LSI properties for the table when the backup was created. It includes the IndexName, KeySchema and Projection for the LSIs on the table at the time of backup.

" - }, - "GlobalSecondaryIndexes":{ - "shape":"GlobalSecondaryIndexes", - "documentation":"

Represents the GSI properties for the table when the backup was created. It includes the IndexName, KeySchema, Projection and ProvisionedThroughput for the GSIs on the table at the time of backup.

" - }, - "StreamDescription":{ - "shape":"StreamSpecification", - "documentation":"

Stream settings on the table when the backup was created.

" - }, - "TimeToLiveDescription":{ - "shape":"TimeToLiveDescription", - "documentation":"

Time to Live settings on the table when the backup was created.

" - }, - "SSEDescription":{ - "shape":"SSEDescription", - "documentation":"

The description of the server-side encryption status on the table when the backup was created.

" - } - }, - "documentation":"

Contains the details of the features enabled on the table when the backup was created. For example, LSIs, GSIs, streams, TTL.

" - }, - "StreamArn":{ - "type":"string", - "max":1024, - "min":37 - }, - "StreamEnabled":{"type":"boolean"}, - "StreamSpecification":{ - "type":"structure", - "members":{ - "StreamEnabled":{ - "shape":"StreamEnabled", - "documentation":"

Indicates whether DynamoDB Streams is enabled (true) or disabled (false) on the table.

" - }, - "StreamViewType":{ - "shape":"StreamViewType", - "documentation":"

When an item in the table is modified, StreamViewType determines what information is written to the stream for this table. Valid values for StreamViewType are:

  • KEYS_ONLY - Only the key attributes of the modified item are written to the stream.

  • NEW_IMAGE - The entire item, as it appears after it was modified, is written to the stream.

  • OLD_IMAGE - The entire item, as it appeared before it was modified, is written to the stream.

  • NEW_AND_OLD_IMAGES - Both the new and the old item images of the item are written to the stream.

" - } - }, - "documentation":"

Represents the DynamoDB Streams configuration for a table in DynamoDB.

" - }, - "StreamViewType":{ - "type":"string", - "enum":[ - "NEW_IMAGE", - "OLD_IMAGE", - "NEW_AND_OLD_IMAGES", - "KEYS_ONLY" - ] - }, - "String":{"type":"string"}, - "StringAttributeValue":{"type":"string"}, - "StringSetAttributeValue":{ - "type":"list", - "member":{"shape":"StringAttributeValue"} - }, - "TableAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

A target table with the specified name already exists.

", - "exception":true - }, - "TableArn":{"type":"string"}, - "TableCreationDateTime":{"type":"timestamp"}, - "TableDescription":{ - "type":"structure", - "members":{ - "AttributeDefinitions":{ - "shape":"AttributeDefinitions", - "documentation":"

An array of AttributeDefinition objects. Each of these objects describes one attribute in the table and index key schema.

Each AttributeDefinition object in this array is composed of:

  • AttributeName - The name of the attribute.

  • AttributeType - The data type for the attribute.

" - }, - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The primary key structure for the table. Each KeySchemaElement consists of:

  • AttributeName - The name of the attribute.

  • KeyType - The role of the attribute:

    • HASH - partition key

    • RANGE - sort key

    The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB' usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

    The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide.

" - }, - "TableStatus":{ - "shape":"TableStatus", - "documentation":"

The current state of the table:

  • CREATING - The table is being created.

  • UPDATING - The table is being updated.

  • DELETING - The table is being deleted.

  • ACTIVE - The table is ready for use.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the table was created, in UNIX epoch time format.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughputDescription", - "documentation":"

The provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.

" - }, - "TableSizeBytes":{ - "shape":"Long", - "documentation":"

The total size of the specified table, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "ItemCount":{ - "shape":"Long", - "documentation":"

The number of items in the specified table. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

" - }, - "TableArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that uniquely identifies the table.

" - }, - "TableId":{ - "shape":"TableId", - "documentation":"

Unique identifier for the table for which the backup was created.

" - }, - "LocalSecondaryIndexes":{ - "shape":"LocalSecondaryIndexDescriptionList", - "documentation":"

Represents one or more local secondary indexes on the table. Each index is scoped to a given partition key value. Tables with one or more local secondary indexes are subject to an item collection size limit, where the amount of data within a given item collection cannot exceed 10 GB. Each element is composed of:

  • IndexName - The name of the local secondary index.

  • KeySchema - Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table.

  • Projection - Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:

    • ProjectionType - One of the following:

      • KEYS_ONLY - Only the index and primary keys are projected into the index.

      • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.

      • ALL - All of the table attributes are projected into the index.

    • NonKeyAttributes - A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided in NonKeyAttributes, summed across all of the secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

  • IndexSizeBytes - Represents the total size of the index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

  • ItemCount - Represents the number of items in the index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

If the table is in the DELETING state, no information about indexes will be returned.

" - }, - "GlobalSecondaryIndexes":{ - "shape":"GlobalSecondaryIndexDescriptionList", - "documentation":"

The global secondary indexes, if any, on the table. Each index is scoped to a given partition key value. Each element is composed of:

  • Backfilling - If true, then the index is currently in the backfilling phase. Backfilling occurs only when a new global secondary index is added to the table; it is the process by which DynamoDB populates the new index with data from the table. (This attribute does not appear for indexes that were created during a CreateTable operation.)

  • IndexName - The name of the global secondary index.

  • IndexSizeBytes - The total size of the global secondary index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

  • IndexStatus - The current status of the global secondary index:

    • CREATING - The index is being created.

    • UPDATING - The index is being updated.

    • DELETING - The index is being deleted.

    • ACTIVE - The index is ready for use.

  • ItemCount - The number of items in the global secondary index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.

  • KeySchema - Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table.

  • Projection - Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:

    • ProjectionType - One of the following:

      • KEYS_ONLY - Only the index and primary keys are projected into the index.

      • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.

      • ALL - All of the table attributes are projected into the index.

    • NonKeyAttributes - A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided in NonKeyAttributes, summed across all of the secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

  • ProvisionedThroughput - The provisioned throughput settings for the global secondary index, consisting of read and write capacity units, along with data about increases and decreases.

If the table is in the DELETING state, no information about indexes will be returned.

" - }, - "StreamSpecification":{ - "shape":"StreamSpecification", - "documentation":"

The current DynamoDB Streams configuration for the table.

" - }, - "LatestStreamLabel":{ - "shape":"String", - "documentation":"

A timestamp, in ISO 8601 format, for this stream.

Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique:

  • the AWS customer ID.

  • the table name.

  • the StreamLabel.

" - }, - "LatestStreamArn":{ - "shape":"StreamArn", - "documentation":"

The Amazon Resource Name (ARN) that uniquely identifies the latest stream for this table.

" - }, - "RestoreSummary":{ - "shape":"RestoreSummary", - "documentation":"

Contains details for the restore.

" - }, - "SSEDescription":{ - "shape":"SSEDescription", - "documentation":"

The description of the server-side encryption status on the specified table.

" - } - }, - "documentation":"

Represents the properties of a table.

" - }, - "TableId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "TableInUseException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

A target table with the specified name is either being created or deleted.

", - "exception":true - }, - "TableName":{ - "type":"string", - "max":255, - "min":3, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "TableNameList":{ - "type":"list", - "member":{"shape":"TableName"} - }, - "TableNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

A source table with the name TableName does not currently exist within the subscriber's account.

", - "exception":true - }, - "TableStatus":{ - "type":"string", - "enum":[ - "CREATING", - "UPDATING", - "DELETING", - "ACTIVE" - ] - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKeyString", - "documentation":"

The key of the tag.Tag keys are case sensitive. Each DynamoDB table can only have up to one tag with the same key. If you try to add an existing tag (same key), the existing tag value will be updated to the new value.

" - }, - "Value":{ - "shape":"TagValueString", - "documentation":"

The value of the tag. Tag values are case-sensitive and can be null.

" - } - }, - "documentation":"

Describes a tag. A tag is a key-value pair. You can add up to 50 tags to a single DynamoDB table.

AWS-assigned tag names and values are automatically assigned the aws: prefix, which the user cannot assign. AWS-assigned tag names do not count towards the tag limit of 50. User-assigned tag names have the prefix user: in the Cost Allocation Report. You cannot backdate the application of a tag.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKeyString"} - }, - "TagKeyString":{ - "type":"string", - "max":128, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceInput":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArnString", - "documentation":"

Identifies the Amazon DynamoDB resource to which tags should be added. This value is an Amazon Resource Name (ARN).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the Amazon DynamoDB resource.

" - } - } - }, - "TagValueString":{ - "type":"string", - "max":256, - "min":0 - }, - "TimeRangeLowerBound":{"type":"timestamp"}, - "TimeRangeUpperBound":{"type":"timestamp"}, - "TimeToLiveAttributeName":{ - "type":"string", - "max":255, - "min":1 - }, - "TimeToLiveDescription":{ - "type":"structure", - "members":{ - "TimeToLiveStatus":{ - "shape":"TimeToLiveStatus", - "documentation":"

The Time to Live status for the table.

" - }, - "AttributeName":{ - "shape":"TimeToLiveAttributeName", - "documentation":"

The name of the Time to Live attribute for items in the table.

" - } - }, - "documentation":"

The description of the Time to Live (TTL) status on the specified table.

" - }, - "TimeToLiveEnabled":{"type":"boolean"}, - "TimeToLiveSpecification":{ - "type":"structure", - "required":[ - "Enabled", - "AttributeName" - ], - "members":{ - "Enabled":{ - "shape":"TimeToLiveEnabled", - "documentation":"

Indicates whether Time To Live is to be enabled (true) or disabled (false) on the table.

" - }, - "AttributeName":{ - "shape":"TimeToLiveAttributeName", - "documentation":"

The name of the Time to Live attribute used to store the expiration time for items in the table.

" - } - }, - "documentation":"

Represents the settings used to enable or disable Time to Live for the specified table.

" - }, - "TimeToLiveStatus":{ - "type":"string", - "enum":[ - "ENABLING", - "DISABLING", - "ENABLED", - "DISABLED" - ] - }, - "UntagResourceInput":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArnString", - "documentation":"

The Amazon DyanamoDB resource the tags will be removed from. This value is an Amazon Resource Name (ARN).

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys. Existing tags of the resource whose keys are members of this list will be removed from the Amazon DynamoDB resource.

" - } - } - }, - "UpdateContinuousBackupsInput":{ - "type":"structure", - "required":[ - "TableName", - "PointInTimeRecoverySpecification" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table.

" - }, - "PointInTimeRecoverySpecification":{ - "shape":"PointInTimeRecoverySpecification", - "documentation":"

Represents the settings used to enable point in time recovery.

" - } - } - }, - "UpdateContinuousBackupsOutput":{ - "type":"structure", - "members":{ - "ContinuousBackupsDescription":{ - "shape":"ContinuousBackupsDescription", - "documentation":"

Represents the continuous backups and point in time recovery settings on the table.

" - } - } - }, - "UpdateExpression":{"type":"string"}, - "UpdateGlobalSecondaryIndexAction":{ - "type":"structure", - "required":[ - "IndexName", - "ProvisionedThroughput" - ], - "members":{ - "IndexName":{ - "shape":"IndexName", - "documentation":"

The name of the global secondary index to be updated.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

Represents the provisioned throughput settings for the specified global secondary index.

For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the new provisioned throughput settings to be applied to a global secondary index.

" - }, - "UpdateGlobalTableInput":{ - "type":"structure", - "required":[ - "GlobalTableName", - "ReplicaUpdates" - ], - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The global table name.

" - }, - "ReplicaUpdates":{ - "shape":"ReplicaUpdateList", - "documentation":"

A list of regions that should be added or removed from the global table.

" - } - } - }, - "UpdateGlobalTableOutput":{ - "type":"structure", - "members":{ - "GlobalTableDescription":{ - "shape":"GlobalTableDescription", - "documentation":"

Contains the details of the global table.

" - } - } - }, - "UpdateGlobalTableSettingsInput":{ - "type":"structure", - "required":["GlobalTableName"], - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The name of the global table

" - }, - "GlobalTableProvisionedWriteCapacityUnits":{ - "shape":"PositiveLongObject", - "documentation":"

The maximum number of writes consumed per second before DynamoDB returns a ThrottlingException.

" - }, - "GlobalTableProvisionedWriteCapacityAutoScalingSettingsUpdate":{ - "shape":"AutoScalingSettingsUpdate", - "documentation":"

AutoScaling settings for managing provisioned write capacity for the global table.

" - }, - "GlobalTableGlobalSecondaryIndexSettingsUpdate":{ - "shape":"GlobalTableGlobalSecondaryIndexSettingsUpdateList", - "documentation":"

Represents the settings of a global secondary index for a global table that will be modified.

" - }, - "ReplicaSettingsUpdate":{ - "shape":"ReplicaSettingsUpdateList", - "documentation":"

Represents the settings for a global table in a region that will be modified.

" - } - } - }, - "UpdateGlobalTableSettingsOutput":{ - "type":"structure", - "members":{ - "GlobalTableName":{ - "shape":"TableName", - "documentation":"

The name of the global table.

" - }, - "ReplicaSettings":{ - "shape":"ReplicaSettingsDescriptionList", - "documentation":"

The region specific settings for the global table.

" - } - } - }, - "UpdateItemInput":{ - "type":"structure", - "required":[ - "TableName", - "Key" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table containing the item to update.

" - }, - "Key":{ - "shape":"Key", - "documentation":"

The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.

For the primary key, you must provide all of the attributes. For example, with a simple primary key, you only need to provide a value for the partition key. For a composite primary key, you must provide values for both the partition key and the sort key.

" - }, - "AttributeUpdates":{ - "shape":"AttributeUpdates", - "documentation":"

This is a legacy parameter. Use UpdateExpression instead. For more information, see AttributeUpdates in the Amazon DynamoDB Developer Guide.

" - }, - "Expected":{ - "shape":"ExpectedAttributeMap", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see Expected in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionalOperator":{ - "shape":"ConditionalOperator", - "documentation":"

This is a legacy parameter. Use ConditionExpression instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.

" - }, - "ReturnValues":{ - "shape":"ReturnValue", - "documentation":"

Use ReturnValues if you want to get the item attributes as they appear before or after they are updated. For UpdateItem, the valid values are:

  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This setting is the default for ReturnValues.)

  • ALL_OLD - Returns all of the attributes of the item, as they appeared before the UpdateItem operation.

  • UPDATED_OLD - Returns only the updated attributes, as they appeared before the UpdateItem operation.

  • ALL_NEW - Returns all of the attributes of the item, as they appear after the UpdateItem operation.

  • UPDATED_NEW - Returns only the updated attributes, as they appear after the UpdateItem operation.

There is no additional cost associated with requesting a return value aside from the small network and processing overhead of receiving a larger response. No read capacity units are consumed.

The values returned are strongly consistent.

" - }, - "ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}, - "ReturnItemCollectionMetrics":{ - "shape":"ReturnItemCollectionMetrics", - "documentation":"

Determines whether item collection metrics are returned. If set to SIZE, the response includes statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned.

" - }, - "UpdateExpression":{ - "shape":"UpdateExpression", - "documentation":"

An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.

The following action values are available for UpdateExpression.

  • SET - Adds one or more attributes and values to an item. If any of these attribute already exist, they are replaced by the new values. You can also use SET to add or subtract from an attribute that is of type Number. For example: SET myNum = myNum + :val

    SET supports the following functions:

    • if_not_exists (path, operand) - if the item does not contain an attribute at the specified path, then if_not_exists evaluates to operand; otherwise, it evaluates to path. You can use this function to avoid overwriting an attribute that may already be present in the item.

    • list_append (operand, operand) - evaluates to a list with a new element added to it. You can append the new element to the start or the end of the list by reversing the order of the operands.

    These function names are case-sensitive.

  • REMOVE - Removes one or more attributes from an item.

  • ADD - Adds the specified value to the item, if the attribute does not already exist. If the attribute does exist, then the behavior of ADD depends on the data type of the attribute:

    • If the existing attribute is a number, and if Value is also a number, then Value is mathematically added to the existing attribute. If Value is a negative number, then it is subtracted from the existing attribute.

      If you use ADD to increment or decrement a number value for an item that doesn't exist before the update, DynamoDB uses 0 as the initial value.

      Similarly, if you use ADD for an existing item to increment or decrement an attribute value that doesn't exist before the update, DynamoDB uses 0 as the initial value. For example, suppose that the item you want to update doesn't have an attribute named itemcount, but you decide to ADD the number 3 to this attribute anyway. DynamoDB will create the itemcount attribute, set its initial value to 0, and finally add 3 to it. The result will be a new itemcount attribute in the item, with a value of 3.

    • If the existing data type is a set and if Value is also a set, then Value is added to the existing set. For example, if the attribute value is the set [1,2], and the ADD action specified [3], then the final attribute value is [1,2,3]. An error occurs if an ADD action is specified for a set attribute and the attribute type specified does not match the existing set type.

      Both sets must have the same primitive data type. For example, if the existing data type is a set of strings, the Value must also be a set of strings.

    The ADD action only supports Number and set data types. In addition, ADD can only be used on top-level attributes, not nested attributes.

  • DELETE - Deletes an element from a set.

    If a set of values is specified, then those values are subtracted from the old set. For example, if the attribute value was the set [a,b,c] and the DELETE action specifies [a,c], then the final attribute value is [b]. Specifying an empty set is an error.

    The DELETE action only supports set data types. In addition, DELETE can only be used on top-level attributes, not nested attributes.

You can have many actions in a single expression, such as the following: SET a=:value1, b=:value2 DELETE :value3, :value4, :value5

For more information on update expressions, see Modifying Items and Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ConditionExpression":{ - "shape":"ConditionExpression", - "documentation":"

A condition that must be satisfied in order for a conditional update to succeed.

An expression can contain any of the following:

  • Functions: attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size

    These function names are case-sensitive.

  • Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN

  • Logical operators: AND | OR | NOT

For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeNames":{ - "shape":"ExpressionAttributeNameMap", - "documentation":"

One or more substitution tokens for attribute names in an expression. The following are some use cases for using ExpressionAttributeNames:

  • To access an attribute whose name conflicts with a DynamoDB reserved word.

  • To create a placeholder for repeating occurrences of an attribute name in an expression.

  • To prevent special characters in an attribute name from being misinterpreted in an expression.

Use the # character in an expression to dereference an attribute name. For example, consider the following attribute name:

  • Percentile

The name of this attribute conflicts with a reserved word, so it cannot be used directly in an expression. (For the complete list of reserved words, see Reserved Words in the Amazon DynamoDB Developer Guide). To work around this, you could specify the following for ExpressionAttributeNames:

  • {\"#P\":\"Percentile\"}

You could then use this substitution in an expression, as in this example:

  • #P = :val

Tokens that begin with the : character are expression attribute values, which are placeholders for the actual value at runtime.

For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.

" - }, - "ExpressionAttributeValues":{ - "shape":"ExpressionAttributeValueMap", - "documentation":"

One or more values that can be substituted in an expression.

Use the : (colon) character in an expression to dereference an attribute value. For example, suppose that you wanted to check whether the value of the ProductStatus attribute was one of the following:

Available | Backordered | Discontinued

You would first need to specify ExpressionAttributeValues as follows:

{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }

You could then use these values in an expression, such as this:

ProductStatus IN (:avail, :back, :disc)

For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.

" - } - }, - "documentation":"

Represents the input of an UpdateItem operation.

" - }, - "UpdateItemOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeMap", - "documentation":"

A map of attribute values as they appear before or after the UpdateItem operation, as determined by the ReturnValues parameter.

The Attributes map is only present if ReturnValues was specified as something other than NONE in the request. Each element represents one attribute.

" - }, - "ConsumedCapacity":{ - "shape":"ConsumedCapacity", - "documentation":"

The capacity units consumed by the UpdateItem operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

" - }, - "ItemCollectionMetrics":{ - "shape":"ItemCollectionMetrics", - "documentation":"

Information about item collections, if any, that were affected by the UpdateItem operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics parameter was specified. If the table does not have any local secondary indexes, this information is not returned in the response.

Each ItemCollectionMetrics element consists of:

  • ItemCollectionKey - The partition key value of the item collection. This is the same as the partition key value of the item itself.

  • SizeEstimateRangeGB - An estimate of item collection size, in gigabytes. This value is a two-element array containing a lower bound and an upper bound for the estimate. The estimate includes the size of all the items in the table, plus the size of all attributes projected into all of the local secondary indexes on that table. Use this estimate to measure whether a local secondary index is approaching its size limit.

    The estimate is subject to change over time; therefore, do not rely on the precision or accuracy of the estimate.

" - } - }, - "documentation":"

Represents the output of an UpdateItem operation.

" - }, - "UpdateTableInput":{ - "type":"structure", - "required":["TableName"], - "members":{ - "AttributeDefinitions":{ - "shape":"AttributeDefinitions", - "documentation":"

An array of attributes that describe the key schema for the table and indexes. If you are adding a new global secondary index to the table, AttributeDefinitions must include the key element(s) of the new index.

" - }, - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to be updated.

" - }, - "ProvisionedThroughput":{ - "shape":"ProvisionedThroughput", - "documentation":"

The new provisioned throughput settings for the specified table or index.

" - }, - "GlobalSecondaryIndexUpdates":{ - "shape":"GlobalSecondaryIndexUpdateList", - "documentation":"

An array of one or more global secondary indexes for the table. For each index in the array, you can request one action:

  • Create - add a new global secondary index to the table.

  • Update - modify the provisioned throughput settings of an existing global secondary index.

  • Delete - remove a global secondary index from the table.

For more information, see Managing Global Secondary Indexes in the Amazon DynamoDB Developer Guide.

" - }, - "StreamSpecification":{ - "shape":"StreamSpecification", - "documentation":"

Represents the DynamoDB Streams configuration for the table.

You will receive a ResourceInUseException if you attempt to enable a stream on a table that already has a stream, or if you attempt to disable a stream on a table which does not have a stream.

" - } - }, - "documentation":"

Represents the input of an UpdateTable operation.

" - }, - "UpdateTableOutput":{ - "type":"structure", - "members":{ - "TableDescription":{ - "shape":"TableDescription", - "documentation":"

Represents the properties of the table.

" - } - }, - "documentation":"

Represents the output of an UpdateTable operation.

" - }, - "UpdateTimeToLiveInput":{ - "type":"structure", - "required":[ - "TableName", - "TimeToLiveSpecification" - ], - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

The name of the table to be configured.

" - }, - "TimeToLiveSpecification":{ - "shape":"TimeToLiveSpecification", - "documentation":"

Represents the settings used to enable or disable Time to Live for the specified table.

" - } - }, - "documentation":"

Represents the input of an UpdateTimeToLive operation.

" - }, - "UpdateTimeToLiveOutput":{ - "type":"structure", - "members":{ - "TimeToLiveSpecification":{ - "shape":"TimeToLiveSpecification", - "documentation":"

Represents the output of an UpdateTimeToLive operation.

" - } - } - }, - "WriteRequest":{ - "type":"structure", - "members":{ - "PutRequest":{ - "shape":"PutRequest", - "documentation":"

A request to perform a PutItem operation.

" - }, - "DeleteRequest":{ - "shape":"DeleteRequest", - "documentation":"

A request to perform a DeleteItem operation.

" - } - }, - "documentation":"

Represents an operation to perform - either DeleteItem or PutItem. You can only request one of these operations, not both, in a single WriteRequest. If you do need to perform both of these operations, you will need to provide two separate WriteRequest objects.

" - }, - "WriteRequests":{ - "type":"list", - "member":{"shape":"WriteRequest"}, - "max":25, - "min":1 - } - }, - "documentation":"Amazon DynamoDB

Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling.

With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance degradation, and use the AWS Management Console to monitor resource utilization and performance metrics.

DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an AWS region, providing built-in high availability and data durability.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/waiters-2.json deleted file mode 100644 index 43a55ca7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodb/2012-08-10/waiters-2.json +++ /dev/null @@ -1,35 +0,0 @@ -{ - "version": 2, - "waiters": { - "TableExists": { - "delay": 20, - "operation": "DescribeTable", - "maxAttempts": 25, - "acceptors": [ - { - "expected": "ACTIVE", - "matcher": "path", - "state": "success", - "argument": "Table.TableStatus" - }, - { - "expected": "ResourceNotFoundException", - "matcher": "error", - "state": "retry" - } - ] - }, - "TableNotExists": { - "delay": 20, - "operation": "DescribeTable", - "maxAttempts": 25, - "acceptors": [ - { - "expected": "ResourceNotFoundException", - "matcher": "error", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/examples-1.json deleted file mode 100644 index 8287e2c4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/examples-1.json +++ /dev/null @@ -1,212 +0,0 @@ -{ - "version": "1.0", - "examples": { - "DescribeStream": [ - { - "input": { - "StreamArn": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252" - }, - "output": { - "StreamDescription": { - "CreationRequestDateTime": "Wed May 20 13:51:10 PDT 2015", - "KeySchema": [ - { - "AttributeName": "ForumName", - "KeyType": "HASH" - }, - { - "AttributeName": "Subject", - "KeyType": "RANGE" - } - ], - "Shards": [ - { - "SequenceNumberRange": { - "EndingSequenceNumber": "20500000000000000910398", - "StartingSequenceNumber": "20500000000000000910398" - }, - "ShardId": "shardId-00000001414562045508-2bac9cd2" - }, - { - "ParentShardId": "shardId-00000001414562045508-2bac9cd2", - "SequenceNumberRange": { - "EndingSequenceNumber": "820400000000000001192334", - "StartingSequenceNumber": "820400000000000001192334" - }, - "ShardId": "shardId-00000001414576573621-f55eea83" - }, - { - "ParentShardId": "shardId-00000001414576573621-f55eea83", - "SequenceNumberRange": { - "EndingSequenceNumber": "1683700000000000001135967", - "StartingSequenceNumber": "1683700000000000001135967" - }, - "ShardId": "shardId-00000001414592258131-674fd923" - }, - { - "ParentShardId": "shardId-00000001414592258131-674fd923", - "SequenceNumberRange": { - "StartingSequenceNumber": "2574600000000000000935255" - }, - "ShardId": "shardId-00000001414608446368-3a1afbaf" - } - ], - "StreamArn": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252", - "StreamLabel": "2015-05-20T20:51:10.252", - "StreamStatus": "ENABLED", - "StreamViewType": "NEW_AND_OLD_IMAGES", - "TableName": "Forum" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example describes a stream with a given stream ARN.", - "id": "to-describe-a-stream-with-a-given-stream-arn-1473457835200", - "title": "To describe a stream with a given stream ARN" - } - ], - "GetRecords": [ - { - "input": { - "ShardIterator": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252|1|AAAAAAAAAAEvJp6D+zaQ... ..." - }, - "output": { - "NextShardIterator": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252|1|AAAAAAAAAAGQBYshYDEe ... ...", - "Records": [ - { - "awsRegion": "us-west-2", - "dynamodb": { - "ApproximateCreationDateTime": "1.46480646E9", - "Keys": { - "ForumName": { - "S": "DynamoDB" - }, - "Subject": { - "S": "DynamoDB Thread 3" - } - }, - "SequenceNumber": "300000000000000499659", - "SizeBytes": 41, - "StreamViewType": "KEYS_ONLY" - }, - "eventID": "e2fd9c34eff2d779b297b26f5fef4206", - "eventName": "INSERT", - "eventSource": "aws:dynamodb", - "eventVersion": "1.0" - }, - { - "awsRegion": "us-west-2", - "dynamodb": { - "ApproximateCreationDateTime": "1.46480527E9", - "Keys": { - "ForumName": { - "S": "DynamoDB" - }, - "Subject": { - "S": "DynamoDB Thread 1" - } - }, - "SequenceNumber": "400000000000000499660", - "SizeBytes": 41, - "StreamViewType": "KEYS_ONLY" - }, - "eventID": "4b25bd0da9a181a155114127e4837252", - "eventName": "MODIFY", - "eventSource": "aws:dynamodb", - "eventVersion": "1.0" - }, - { - "awsRegion": "us-west-2", - "dynamodb": { - "ApproximateCreationDateTime": "1.46480646E9", - "Keys": { - "ForumName": { - "S": "DynamoDB" - }, - "Subject": { - "S": "DynamoDB Thread 2" - } - }, - "SequenceNumber": "500000000000000499661", - "SizeBytes": 41, - "StreamViewType": "KEYS_ONLY" - }, - "eventID": "740280c73a3df7842edab3548a1b08ad", - "eventName": "REMOVE", - "eventSource": "aws:dynamodb", - "eventVersion": "1.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example retrieves all the stream records from a shard.", - "id": "to-retrieve-all-the-stream-records-from-a-shard-1473707781419", - "title": "To retrieve all the stream records from a shard" - } - ], - "GetShardIterator": [ - { - "input": { - "ShardId": "00000001414576573621-f55eea83", - "ShardIteratorType": "TRIM_HORIZON", - "StreamArn": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252" - }, - "output": { - "ShardIterator": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252|1|AAAAAAAAAAEvJp6D+zaQ... ..." - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns a shard iterator for the provided stream ARN and shard ID.", - "id": "to-obtain-a-shard-iterator-for-the-provided-stream-arn-and-shard-id-1473459941476", - "title": "To obtain a shard iterator for the provided stream ARN and shard ID" - } - ], - "ListStreams": [ - { - "input": { - }, - "output": { - "Streams": [ - { - "StreamArn": "arn:aws:dynamodb:us-wesst-2:111122223333:table/Forum/stream/2015-05-20T20:51:10.252", - "StreamLabel": "2015-05-20T20:51:10.252", - "TableName": "Forum" - }, - { - "StreamArn": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-20T20:50:02.714", - "StreamLabel": "2015-05-20T20:50:02.714", - "TableName": "Forum" - }, - { - "StreamArn": "arn:aws:dynamodb:us-west-2:111122223333:table/Forum/stream/2015-05-19T23:03:50.641", - "StreamLabel": "2015-05-19T23:03:50.641", - "TableName": "Forum" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example lists all of the stream ARNs.", - "id": "to-list-all-of-the-stream-arns--1473459534285", - "title": "To list all of the stream ARNs " - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/service-2.json deleted file mode 100644 index c8112d65..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/dynamodbstreams/2012-08-10/service-2.json +++ /dev/null @@ -1,638 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-08-10", - "endpointPrefix":"streams.dynamodb", - "jsonVersion":"1.0", - "protocol":"json", - "serviceFullName":"Amazon DynamoDB Streams", - "serviceId":"DynamoDB Streams", - "signatureVersion":"v4", - "signingName":"dynamodb", - "targetPrefix":"DynamoDBStreams_20120810", - "uid":"streams-dynamodb-2012-08-10" - }, - "operations":{ - "DescribeStream":{ - "name":"DescribeStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStreamInput"}, - "output":{"shape":"DescribeStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about a stream, including the current status of the stream, its Amazon Resource Name (ARN), the composition of its shards, and its corresponding DynamoDB table.

You can call DescribeStream at a maximum rate of 10 times per second.

Each shard in the stream has a SequenceNumberRange associated with it. If the SequenceNumberRange has a StartingSequenceNumber but no EndingSequenceNumber, then the shard is still open (able to receive more stream records). If both StartingSequenceNumber and EndingSequenceNumber are present, then that shard is closed and can no longer receive more data.

" - }, - "GetRecords":{ - "name":"GetRecords", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRecordsInput"}, - "output":{"shape":"GetRecordsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"}, - {"shape":"ExpiredIteratorException"}, - {"shape":"TrimmedDataAccessException"} - ], - "documentation":"

Retrieves the stream records from a given shard.

Specify a shard iterator using the ShardIterator parameter. The shard iterator specifies the position in the shard from which you want to start reading stream records sequentially. If there are no stream records available in the portion of the shard that the iterator points to, GetRecords returns an empty list. Note that it might take multiple calls to get to a portion of the shard that contains stream records.

GetRecords can retrieve a maximum of 1 MB of data or 1000 stream records, whichever comes first.

" - }, - "GetShardIterator":{ - "name":"GetShardIterator", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetShardIteratorInput"}, - "output":{"shape":"GetShardIteratorOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"}, - {"shape":"TrimmedDataAccessException"} - ], - "documentation":"

Returns a shard iterator. A shard iterator provides information about how to retrieve the stream records from within a shard. Use the shard iterator in a subsequent GetRecords request to read the stream records from the shard.

A shard iterator expires 15 minutes after it is returned to the requester.

" - }, - "ListStreams":{ - "name":"ListStreams", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStreamsInput"}, - "output":{"shape":"ListStreamsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns an array of stream ARNs associated with the current account and endpoint. If the TableName parameter is present, then ListStreams will return only the streams ARNs for that table.

You can call ListStreams at a maximum rate of 5 times per second.

" - } - }, - "shapes":{ - "AttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "AttributeName":{ - "type":"string", - "max":65535 - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "S":{ - "shape":"StringAttributeValue", - "documentation":"

A String data type.

" - }, - "N":{ - "shape":"NumberAttributeValue", - "documentation":"

A Number data type.

" - }, - "B":{ - "shape":"BinaryAttributeValue", - "documentation":"

A Binary data type.

" - }, - "SS":{ - "shape":"StringSetAttributeValue", - "documentation":"

A String Set data type.

" - }, - "NS":{ - "shape":"NumberSetAttributeValue", - "documentation":"

A Number Set data type.

" - }, - "BS":{ - "shape":"BinarySetAttributeValue", - "documentation":"

A Binary Set data type.

" - }, - "M":{ - "shape":"MapAttributeValue", - "documentation":"

A Map data type.

" - }, - "L":{ - "shape":"ListAttributeValue", - "documentation":"

A List data type.

" - }, - "NULL":{ - "shape":"NullAttributeValue", - "documentation":"

A Null data type.

" - }, - "BOOL":{ - "shape":"BooleanAttributeValue", - "documentation":"

A Boolean data type.

" - } - }, - "documentation":"

Represents the data for an attribute. You can set one, and only one, of the elements.

Each attribute in an item is a name-value pair. An attribute can be single-valued or multi-valued set. For example, a book item can have title and authors attributes. Each book has one title but can have many authors. The multi-valued attribute is a set; duplicate values are not allowed.

" - }, - "BinaryAttributeValue":{"type":"blob"}, - "BinarySetAttributeValue":{ - "type":"list", - "member":{"shape":"BinaryAttributeValue"} - }, - "BooleanAttributeValue":{"type":"boolean"}, - "Date":{"type":"timestamp"}, - "DescribeStreamInput":{ - "type":"structure", - "required":["StreamArn"], - "members":{ - "StreamArn":{ - "shape":"StreamArn", - "documentation":"

The Amazon Resource Name (ARN) for the stream.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of shard objects to return. The upper limit is 100.

" - }, - "ExclusiveStartShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the first item that this operation will evaluate. Use the value that was returned for LastEvaluatedShardId in the previous operation.

" - } - }, - "documentation":"

Represents the input of a DescribeStream operation.

" - }, - "DescribeStreamOutput":{ - "type":"structure", - "members":{ - "StreamDescription":{ - "shape":"StreamDescription", - "documentation":"

A complete description of the stream, including its creation date and time, the DynamoDB table associated with the stream, the shard IDs within the stream, and the beginning and ending sequence numbers of stream records within the shards.

" - } - }, - "documentation":"

Represents the output of a DescribeStream operation.

" - }, - "ErrorMessage":{"type":"string"}, - "ExpiredIteratorException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The provided iterator exceeds the maximum age allowed.

" - } - }, - "documentation":"

The shard iterator has expired and can no longer be used to retrieve stream records. A shard iterator expires 15 minutes after it is retrieved using the GetShardIterator action.

", - "exception":true - }, - "GetRecordsInput":{ - "type":"structure", - "required":["ShardIterator"], - "members":{ - "ShardIterator":{ - "shape":"ShardIterator", - "documentation":"

A shard iterator that was retrieved from a previous GetShardIterator operation. This iterator can be used to access the stream records in this shard.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of records to return from the shard. The upper limit is 1000.

" - } - }, - "documentation":"

Represents the input of a GetRecords operation.

" - }, - "GetRecordsOutput":{ - "type":"structure", - "members":{ - "Records":{ - "shape":"RecordList", - "documentation":"

The stream records from the shard, which were retrieved using the shard iterator.

" - }, - "NextShardIterator":{ - "shape":"ShardIterator", - "documentation":"

The next position in the shard from which to start sequentially reading stream records. If set to null, the shard has been closed and the requested iterator will not return any more data.

" - } - }, - "documentation":"

Represents the output of a GetRecords operation.

" - }, - "GetShardIteratorInput":{ - "type":"structure", - "required":[ - "StreamArn", - "ShardId", - "ShardIteratorType" - ], - "members":{ - "StreamArn":{ - "shape":"StreamArn", - "documentation":"

The Amazon Resource Name (ARN) for the stream.

" - }, - "ShardId":{ - "shape":"ShardId", - "documentation":"

The identifier of the shard. The iterator will be returned for this shard ID.

" - }, - "ShardIteratorType":{ - "shape":"ShardIteratorType", - "documentation":"

Determines how the shard iterator is used to start reading stream records from the shard:

  • AT_SEQUENCE_NUMBER - Start reading exactly from the position denoted by a specific sequence number.

  • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number.

  • TRIM_HORIZON - Start reading at the last (untrimmed) stream record, which is the oldest record in the shard. In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream.

  • LATEST - Start reading just after the most recent stream record in the shard, so that you always read the most recent data in the shard.

" - }, - "SequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The sequence number of a stream record in the shard from which to start reading.

" - } - }, - "documentation":"

Represents the input of a GetShardIterator operation.

" - }, - "GetShardIteratorOutput":{ - "type":"structure", - "members":{ - "ShardIterator":{ - "shape":"ShardIterator", - "documentation":"

The position in the shard from which to start reading stream records sequentially. A shard iterator specifies this position using the sequence number of a stream record in a shard.

" - } - }, - "documentation":"

Represents the output of a GetShardIterator operation.

" - }, - "Identity":{ - "type":"structure", - "members":{ - "PrincipalId":{ - "shape":"String", - "documentation":"

A unique identifier for the entity that made the call. For Time To Live, the principalId is \"dynamodb.amazonaws.com\".

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of the identity. For Time To Live, the type is \"Service\".

" - } - }, - "documentation":"

Contains details about the type of identity that made the request.

" - }, - "InternalServerError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The server encountered an internal error trying to fulfill the request.

" - } - }, - "documentation":"

An error occurred on the server side.

", - "exception":true, - "fault":true - }, - "KeySchema":{ - "type":"list", - "member":{"shape":"KeySchemaElement"}, - "max":2, - "min":1 - }, - "KeySchemaAttributeName":{ - "type":"string", - "max":255, - "min":1 - }, - "KeySchemaElement":{ - "type":"structure", - "required":[ - "AttributeName", - "KeyType" - ], - "members":{ - "AttributeName":{ - "shape":"KeySchemaAttributeName", - "documentation":"

The name of a key attribute.

" - }, - "KeyType":{ - "shape":"KeyType", - "documentation":"

The attribute data, consisting of the data type and the attribute value itself.

" - } - }, - "documentation":"

Represents a single element of a key schema. A key schema specifies the attributes that make up the primary key of a table, or the key attributes of an index.

A KeySchemaElement represents exactly one attribute of the primary key. For example, a simple primary key (partition key) would be represented by one KeySchemaElement. A composite primary key (partition key and sort key) would require one KeySchemaElement for the partition key, and another KeySchemaElement for the sort key.

The partition key of an item is also known as its hash attribute. The term \"hash attribute\" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.

The sort key of an item is also known as its range attribute. The term \"range attribute\" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

" - }, - "KeyType":{ - "type":"string", - "enum":[ - "HASH", - "RANGE" - ] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Too many operations for a given subscriber.

" - } - }, - "documentation":"

Your request rate is too high. The AWS SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.

", - "exception":true - }, - "ListAttributeValue":{ - "type":"list", - "member":{"shape":"AttributeValue"} - }, - "ListStreamsInput":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"TableName", - "documentation":"

If this parameter is provided, then only the streams associated with this table name are returned.

" - }, - "Limit":{ - "shape":"PositiveIntegerObject", - "documentation":"

The maximum number of streams to return. The upper limit is 100.

" - }, - "ExclusiveStartStreamArn":{ - "shape":"StreamArn", - "documentation":"

The ARN (Amazon Resource Name) of the first item that this operation will evaluate. Use the value that was returned for LastEvaluatedStreamArn in the previous operation.

" - } - }, - "documentation":"

Represents the input of a ListStreams operation.

" - }, - "ListStreamsOutput":{ - "type":"structure", - "members":{ - "Streams":{ - "shape":"StreamList", - "documentation":"

A list of stream descriptors associated with the current account and endpoint.

" - }, - "LastEvaluatedStreamArn":{ - "shape":"StreamArn", - "documentation":"

The stream ARN of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedStreamArn is empty, then the \"last page\" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedStreamArn is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedStreamArn is empty.

" - } - }, - "documentation":"

Represents the output of a ListStreams operation.

" - }, - "MapAttributeValue":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "NullAttributeValue":{"type":"boolean"}, - "NumberAttributeValue":{"type":"string"}, - "NumberSetAttributeValue":{ - "type":"list", - "member":{"shape":"NumberAttributeValue"} - }, - "OperationType":{ - "type":"string", - "enum":[ - "INSERT", - "MODIFY", - "REMOVE" - ] - }, - "PositiveIntegerObject":{ - "type":"integer", - "min":1 - }, - "PositiveLongObject":{ - "type":"long", - "min":1 - }, - "Record":{ - "type":"structure", - "members":{ - "eventID":{ - "shape":"String", - "documentation":"

A globally unique identifier for the event that was recorded in this stream record.

" - }, - "eventName":{ - "shape":"OperationType", - "documentation":"

The type of data modification that was performed on the DynamoDB table:

  • INSERT - a new item was added to the table.

  • MODIFY - one or more of an existing item's attributes were modified.

  • REMOVE - the item was deleted from the table

" - }, - "eventVersion":{ - "shape":"String", - "documentation":"

The version number of the stream record format. This number is updated whenever the structure of Record is modified.

Client applications must not assume that eventVersion will remain at a particular value, as this number is subject to change at any time. In general, eventVersion will only increase as the low-level DynamoDB Streams API evolves.

" - }, - "eventSource":{ - "shape":"String", - "documentation":"

The AWS service from which the stream record originated. For DynamoDB Streams, this is aws:dynamodb.

" - }, - "awsRegion":{ - "shape":"String", - "documentation":"

The region in which the GetRecords request was received.

" - }, - "dynamodb":{ - "shape":"StreamRecord", - "documentation":"

The main body of the stream record, containing all of the DynamoDB-specific fields.

" - }, - "userIdentity":{ - "shape":"Identity", - "documentation":"

Items that are deleted by the Time to Live process after expiration have the following fields:

  • Records[].userIdentity.type

    \"Service\"

  • Records[].userIdentity.principalId

    \"dynamodb.amazonaws.com\"

" - } - }, - "documentation":"

A description of a unique event within a stream.

" - }, - "RecordList":{ - "type":"list", - "member":{"shape":"Record"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The resource which is being requested does not exist.

" - } - }, - "documentation":"

The operation tried to access a nonexistent stream.

", - "exception":true - }, - "SequenceNumber":{ - "type":"string", - "max":40, - "min":21 - }, - "SequenceNumberRange":{ - "type":"structure", - "members":{ - "StartingSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The first sequence number.

" - }, - "EndingSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The last sequence number.

" - } - }, - "documentation":"

The beginning and ending sequence numbers for the stream records contained within a shard.

" - }, - "Shard":{ - "type":"structure", - "members":{ - "ShardId":{ - "shape":"ShardId", - "documentation":"

The system-generated identifier for this shard.

" - }, - "SequenceNumberRange":{ - "shape":"SequenceNumberRange", - "documentation":"

The range of possible sequence numbers for the shard.

" - }, - "ParentShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the current shard's parent.

" - } - }, - "documentation":"

A uniquely identified group of stream records within a stream.

" - }, - "ShardDescriptionList":{ - "type":"list", - "member":{"shape":"Shard"} - }, - "ShardId":{ - "type":"string", - "max":65, - "min":28 - }, - "ShardIterator":{ - "type":"string", - "max":2048, - "min":1 - }, - "ShardIteratorType":{ - "type":"string", - "enum":[ - "TRIM_HORIZON", - "LATEST", - "AT_SEQUENCE_NUMBER", - "AFTER_SEQUENCE_NUMBER" - ] - }, - "Stream":{ - "type":"structure", - "members":{ - "StreamArn":{ - "shape":"StreamArn", - "documentation":"

The Amazon Resource Name (ARN) for the stream.

" - }, - "TableName":{ - "shape":"TableName", - "documentation":"

The DynamoDB table with which the stream is associated.

" - }, - "StreamLabel":{ - "shape":"String", - "documentation":"

A timestamp, in ISO 8601 format, for this stream.

Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique:

  • the AWS customer ID.

  • the table name

  • the StreamLabel

" - } - }, - "documentation":"

Represents all of the data describing a particular stream.

" - }, - "StreamArn":{ - "type":"string", - "max":1024, - "min":37 - }, - "StreamDescription":{ - "type":"structure", - "members":{ - "StreamArn":{ - "shape":"StreamArn", - "documentation":"

The Amazon Resource Name (ARN) for the stream.

" - }, - "StreamLabel":{ - "shape":"String", - "documentation":"

A timestamp, in ISO 8601 format, for this stream.

Note that LatestStreamLabel is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique:

  • the AWS customer ID.

  • the table name

  • the StreamLabel

" - }, - "StreamStatus":{ - "shape":"StreamStatus", - "documentation":"

Indicates the current status of the stream:

  • ENABLING - Streams is currently being enabled on the DynamoDB table.

  • ENABLED - the stream is enabled.

  • DISABLING - Streams is currently being disabled on the DynamoDB table.

  • DISABLED - the stream is disabled.

" - }, - "StreamViewType":{ - "shape":"StreamViewType", - "documentation":"

Indicates the format of the records within this stream:

  • KEYS_ONLY - only the key attributes of items that were modified in the DynamoDB table.

  • NEW_IMAGE - entire items from the table, as they appeared after they were modified.

  • OLD_IMAGE - entire items from the table, as they appeared before they were modified.

  • NEW_AND_OLD_IMAGES - both the new and the old images of the items from the table.

" - }, - "CreationRequestDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the request to create this stream was issued.

" - }, - "TableName":{ - "shape":"TableName", - "documentation":"

The DynamoDB table with which the stream is associated.

" - }, - "KeySchema":{ - "shape":"KeySchema", - "documentation":"

The key attribute(s) of the stream's DynamoDB table.

" - }, - "Shards":{ - "shape":"ShardDescriptionList", - "documentation":"

The shards that comprise the stream.

" - }, - "LastEvaluatedShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedShardId is empty, then the \"last page\" of results has been processed and there is currently no more data to be retrieved.

If LastEvaluatedShardId is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedShardId is empty.

" - } - }, - "documentation":"

Represents all of the data describing a particular stream.

" - }, - "StreamList":{ - "type":"list", - "member":{"shape":"Stream"} - }, - "StreamRecord":{ - "type":"structure", - "members":{ - "ApproximateCreationDateTime":{ - "shape":"Date", - "documentation":"

The approximate date and time when the stream record was created, in UNIX epoch time format.

" - }, - "Keys":{ - "shape":"AttributeMap", - "documentation":"

The primary key attribute(s) for the DynamoDB item that was modified.

" - }, - "NewImage":{ - "shape":"AttributeMap", - "documentation":"

The item in the DynamoDB table as it appeared after it was modified.

" - }, - "OldImage":{ - "shape":"AttributeMap", - "documentation":"

The item in the DynamoDB table as it appeared before it was modified.

" - }, - "SequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The sequence number of the stream record.

" - }, - "SizeBytes":{ - "shape":"PositiveLongObject", - "documentation":"

The size of the stream record, in bytes.

" - }, - "StreamViewType":{ - "shape":"StreamViewType", - "documentation":"

The type of data from the modified DynamoDB item that was captured in this stream record:

  • KEYS_ONLY - only the key attributes of the modified item.

  • NEW_IMAGE - the entire item, as it appeared after it was modified.

  • OLD_IMAGE - the entire item, as it appeared before it was modified.

  • NEW_AND_OLD_IMAGES - both the new and the old item images of the item.

" - } - }, - "documentation":"

A description of a single data modification that was performed on an item in a DynamoDB table.

" - }, - "StreamStatus":{ - "type":"string", - "enum":[ - "ENABLING", - "ENABLED", - "DISABLING", - "DISABLED" - ] - }, - "StreamViewType":{ - "type":"string", - "enum":[ - "NEW_IMAGE", - "OLD_IMAGE", - "NEW_AND_OLD_IMAGES", - "KEYS_ONLY" - ] - }, - "String":{"type":"string"}, - "StringAttributeValue":{"type":"string"}, - "StringSetAttributeValue":{ - "type":"list", - "member":{"shape":"StringAttributeValue"} - }, - "TableName":{ - "type":"string", - "max":255, - "min":3, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "TrimmedDataAccessException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

\"The data you are trying to access has been trimmed.

" - } - }, - "documentation":"

The operation attempted to read past the oldest stream record in a shard.

In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream. You might receive a TrimmedDataAccessException if:

  • You request a shard iterator with a sequence number older than the trim point (24 hours).

  • You obtain a shard iterator, but before you use the iterator in a GetRecords request, a stream record in the shard exceeds the 24 hour period and is trimmed. This causes the iterator to access a record that no longer exists.

", - "exception":true - } - }, - "documentation":"Amazon DynamoDB

Amazon DynamoDB Streams provides API actions for accessing streams and processing stream records. To learn more about application development with Streams, see Capturing Table Activity with DynamoDB Streams in the Amazon DynamoDB Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/paginators-1.json deleted file mode 100644 index b643e696..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/paginators-1.json +++ /dev/null @@ -1,45 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/service-2.json deleted file mode 100644 index 7c92d3a6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/service-2.json +++ /dev/null @@ -1,11699 +0,0 @@ -{ - "metadata":{ - "apiVersion":"2014-09-01", - "endpointPrefix":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2014-09-01", - "protocol":"ec2" - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

", - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Attaches an Amazon EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an Amazon EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for Amazon EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can only be attached as the root device of a stopped instance.
  • You must be subscribed to the AWS Marketplace code that is on the volume.
  • The configuration (instance type, operating system) of the instance must support that specific AWS Marketplace code. For example, you cannot take a volume from a Windows instance and attach it to a Linux instance.
  • AWS Marketplace product codes are copied from the volume to the instance.

For an overview of the AWS Marketplace, see https://aws.amazon.com/marketplace/help/200900000. For more information about how to use the AWS Marketplace, see AWS Marketplace.

For more information about Amazon EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC.

You can have up to 50 rules per security group (covering both ingress and egress rules).

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the region in which the request was made. You specify the destination region by using its endpoint when making the request. AMIs that use encrypted Amazon EBS snapshots cannot be copied with this method.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an Amazon EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create Amazon EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted Amazon EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can't be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.
  • domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). If specifying more than one domain name, separate them with spaces.
  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an Amazon S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting EC2 Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{ - "shape":"KeyPair", - "documentation":"

Information about the key pair.

", - "locationName":"keyPair" - }, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a Seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 100 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{ - "shape":"Snapshot", - "locationName":"snapshot" - }, - "documentation":"

Creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of Amazon EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a datafeed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified EC2 resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{ - "shape":"Volume", - "locationName":"volume" - }, - "documentation":"

Creates an Amazon EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the specified region.

You can create a new empty volume or restore a volume from an Amazon EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an Amazon EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the datafeed for Spot Instances. For more information, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified Amazon EBS volume. The volume must be in the available state (not attached to an instance).

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes the specified attribute of your AWS account.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{ - "shape":"ImageAttribute", - "documentation":"

Information about the image attribute.

", - "locationName":"imageAttribute" - }, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances, including any scheduled events.

Instance status has two main components:

  • System Status reports impaired functionality that stems from issues related to the systems that support an instance, such as such as hardware failures and network connectivity problems. This call reports such problems as impaired reachability.

  • Instance Status reports impaired functionality that arises from problems internal to the instance. This call reports such problems as impaired reachability.

Instance status provides information about four types of scheduled events for an instance that may require your attention:

  • Scheduled Reboot: When Amazon EC2 determines that an instance must be rebooted, the instances status returns one of two event codes: system-reboot or instance-reboot. System reboot commonly occurs if certain maintenance or upgrade operations require a reboot of the underlying host that supports an instance. Instance reboot commonly occurs if the instance must be rebooted, rather than the underlying host. Rebooting events include a scheduled start and end time.

  • System Maintenance: When Amazon EC2 determines that an instance requires maintenance that requires power or network impact, the instance status is the event code system-maintenance. System maintenance is either power maintenance or network maintenance. For power maintenance, your instance will be unavailable for a brief period of time and then rebooted. For network maintenance, your instance will experience a brief loss of network connectivity. System maintenance events include a scheduled start and end time. You will also be notified by email if one of your instances is set for system maintenance. The email message indicates when your instance is scheduled for maintenance.

  • Scheduled Retirement: When Amazon EC2 determines that an instance must be shut down, the instance status is the event code instance-retirement. Retirement commonly occurs when the underlying host is degraded and must be replaced. Retirement events include a scheduled start and end time. You will also be notified by email if one of your instances is set to retiring. The email message indicates when your instance will be permanently retired.

  • Scheduled Stop: When Amazon EC2 determines that an instance must be shut down, the instances status returns an event code called instance-stop. Stop events include a scheduled start and end time. You will also be notified by email if one of your instances is set to stop. The email message indicates when your instance will be stopped.

When your instance is retired, it will either be terminated (if its root device type is the instance-store) or stopped (if its root device type is an EBS volume). Instances stopped due to retirement will not be restarted, but you can do so manually. You can also avoid retirement of EBS-backed instances by manually restarting your instance when its event code is instance-retirement. This ensures that your instance is started on a different underlying host.

For more information about failed status checks, see Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide. For more information about working with scheduled events, see Working with an Instance That Has a Scheduled Event in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the Amazon EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.
  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.
  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the datafeed for Spot Instances. For more information, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot Instance requests that belong to your account. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot Price history. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

When you specify an Availability Zone, this operation describes the price history for the specified Availability Zone with the most recent set of prices listed first. If you don't specify an Availability Zone, you get the prices across all Availability Zones, starting with the most recent set. However, if you're using an API version earlier than 2011-05-15, you get the lowest price across the region for the specified time period. The prices returned are listed in chronological order, from the oldest to the most recent.

When you specify the start and end time options, this operation returns two pieces of data: the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified Amazon EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Detaches an Amazon EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so results in the volume being stuck in a busy state while detaching.

If an Amazon EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

If the root volume is detached from an instance with an AWS Marketplace product code, then the AWS Marketplace product codes from that volume are no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux/Unix instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a machine. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output displays the last three system event log errors.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the EC2 command line tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the Amazon EC2 command-line interface (CLI) tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time. You pay a lower usage rate than with On-Demand instances for the time that you actually use the capacity reservation.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If a Linux/Unix instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

You can also use RegisterImage to create an Amazon EBS-backed AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot Instance request. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide.

Users must be subscribed to the required product to run an instance with AWS Marketplace product codes.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the SourceDestCheck, the instance can be either running or stopped.

The SourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

Removes one or more egress rules from a security group for EC2-VPC. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{ - "shape":"Reservation", - "documentation":"

One or more reservations.

", - "locationName":"reservation" - }, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

T2 instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot Instances.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all Amazon EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - } - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - } - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - } - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] Allows an Elastic IP address that is already associated with an instance or network interface to be re-associated with the specified instance or network interface. Otherwise, the operation fails.

Default: false

", - "locationName":"allowReassociation" - } - } - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - } - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - } - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - } - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - } - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - } - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - } - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "locationName":"value" - } - } - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "locationName":"value" - } - } - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone (available | impaired | unavailable).

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":["available"] - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeral[0..3]). The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - } - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID for this bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - } - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

The bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "locationName":"reasonMessage" - } - } - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - } - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - } - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - } - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot Instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot Instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - } - } - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - } - } - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new Amazon EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region of the snapshot copy operation. This parameter is required in the PresignedUrl.

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because Amazon EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - } - } - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - } - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - } - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - } - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - } - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - } - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - } - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "locationName":"exportToS3" - } - } - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "locationName":"exportTask" - } - } - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - } - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - } - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - } - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - } - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - } - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - } - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - } - } - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instances listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - } - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - } - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - } - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - } - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot Instance datafeed.

Constraints: Must be a valid bucket associated with your AWS account.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the datafeed file names.

", - "locationName":"prefix" - } - } - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance datafeed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

" - } - } - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - } - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - } - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - } - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: If the volume type is io1, the minimum size of the volume is 10 GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS (SSD) volumes. The number of I/O operations per second (IOPS) to provision for the volume.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted.

", - "locationName":"encrypted" - } - } - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - } - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The supported tenancy options for instances launched into the VPC. A value of default means that instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC are launched as dedicated tenancy instances regardless of the tenancy assigned to the instance at launch. Dedicated tenancy instances run on single-tenant hardware.

Default: default

", - "locationName":"instanceTenancy" - } - } - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - } - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - } - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - } - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - } - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - } - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - } - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - } - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - } - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - } - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - } - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - } - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - } - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - } - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - } - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - } - } - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - } - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - } - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - } - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - } - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - } - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - } - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - } - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - } - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - } - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - } - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - } - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - } - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - } - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "locationName":"conversionTasks" - } - } - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - } - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - } - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "locationName":"exportTaskSet" - } - } - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

" - } - } - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, amazon (owner is Amazon), aws-marketplace (owner is AWS Marketplace), self (owner is the sender of the request), or all (all owners).

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • block-device-mapping.volume-size - The volume size of the Amazon EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the Amazon EBS volume (gp2 | standard | io1).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - The AWS account alias (for example, amazon).

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - } - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - } - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

", - "locationName":"attribute" - } - } - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code identifying the type of event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • event.not-before - The earliest start time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • instance-state-code - A code representing the state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next paginated set of results to return. (You received this token from a prior call.)

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of paginated instance items per response. The call also returns a token that you can specify in a subsequent call to get the next set of results. If the value is greater than 1000, we return only 1000 items.

Default: 1000

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - } - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next paginated set of results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an Amazon EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • block-device-mapping.status - The status for the Amazon EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the Amazon EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. If the instance is in EC2-Classic or a default VPC, you can use group-name instead.

  • group-name - The name of the security group for the instance. If the instance is in a nondefault VPC, you must use group-id instead.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance (spot).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, m1.small).

  • instance.group-id - The ID of the security group for the instance. If the instance is in EC2-Classic or a default VPC, you can use instance.group-name instead.

  • instance.group-name - The name of the security group for the instance. If the instance is in a nondefault VPC, you must use instance.group-id instead.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot Instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface.id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface-private-dns-name - The private DNS name of the network interface.

  • network-interface.source-destination-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - } - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

One or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - } - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - } - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - } - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - } - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - } - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - } - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - } - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform Network Address Translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - } - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - } - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - } - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - } - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - } - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - } - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance Listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - } - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next page of data.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - } - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next page of data.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from AWS and Reserved Instance Marketplace are listed.

  • product-description - The description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the Reserved Instance offering. A Reserved Instance with dedicated tenancy runs on single-tenant hardware and can only be launched within a VPC.

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next paginated set of offerings.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of offerings to return. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - } - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next paginated set of results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2014-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • product-description - The product description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (pending-payment | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - } - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - } - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC.

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - } - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. You can specify either the security group name or the security group ID.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for nondefault VPCs.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - The description of the security group.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - } - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - } - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - } - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - The AWS account alias (for example, amazon) that owns the snapshot.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - } - } - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "locationName":"snapshotSet" - } - } - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance datafeed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot Instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot Instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume (gp2 | standard | io1).

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m1.small).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot Instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot Instance request ID.

  • spot-price - The maximum hourly price for any Spot Instance launched to fulfill the request.

  • state - The state of the Spot Instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot Instance requests. For information, see Tracking Spot Requests with Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.

  • status-code - The short code describing the most recent evaluation of your Spot Instance request.

  • status-message - The message explaining the status of the Spot Instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot Instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - } - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The start date and time of the Spot Price history data.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The end date and time of the Spot Price history data.

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

One or more instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

One or more basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot Price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot Price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot Price history (for example, 2010-08-16T05:06:11.000Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The number of rows to return.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next set of rows to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot Prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The string marking the next set of results. This is empty if there are no more results.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - } - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results. If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - } - } - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - } - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next paginated set of results to return using the pagination token returned by a previous call.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of paginated volume items per response.

" - } - } - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The next paginated set of results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results.

", - "locationName":"maxResults" - } - } - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - } - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - } - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - } - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - } - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway.

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - } - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - } - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - } - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - } - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - } - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{"shape":"DiskImageDetail"}, - "Description":{"shape":"String"}, - "Volume":{"shape":"VolumeDetail"} - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - } - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - } - } - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - } - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: If the volume type is io1, the minimum size of the volume is 10 GiB; otherwise, the minimum size is 1 GiB. The maximum volume size is 1024 GiB. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, and standard for Magnetic volumes.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100 to 4000 for Provisioned IOPS (SSD) volumes and 3 to 3072 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes an Amazon EBS block device.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an Amazon EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - } - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - } - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

The instance being exported.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACL permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "locationName":"s3Key" - } - } - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the Amazon S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - } - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values.

", - "locationName":"Value" - } - } - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "Float":{"type":"float"}, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64 encoded.

", - "locationName":"output" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - } - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - } - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping" - ] - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "available", - "deregistered" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"String", - "documentation":"

User data to be made available to the instance.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] Optionally, you can use this parameter to assign the instance a specific available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - } - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - } - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - } - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. You must base64 encode the public key material before sending it to AWS.

", - "locationName":"publicKeyMaterial" - } - } - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting Amazon EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

An optional description for the volume being imported.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "locationName":"volume" - } - } - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The Base64-encoded MIME user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

he number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":["spot"] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If luanching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Extra information regarding events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The associated code of the event.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes an instance event.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "t2.micro", - "t2.small", - "t2.medium", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "cg1.4xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The protocol.

When you call DescribeSecurityGroups, the protocol value returned is the number. Exception: For TCP, UDP, and ICMP, the value returned is the name (for example, tcp, udp, or icmp). For a list of protocol numbers, see Protocol Numbers.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. If requesting a Spot Instance in a nondefault VPC, you must specify the security group ID. If requesting a Spot Instance in EC2-Classic or a default VPC, you can specify either the security group name or ID.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

Default: m1.small

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the Spot Instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification of a Spot Instance.

" - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - } - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or intanceInitiateShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

For example, if you want the instance to be in sg-1a1a1a1a and sg-9b9b9b9b, specify GroupId.1=sg-1a1a1a1a and GroupId.2=sg-9b9b9b9b.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking for the instance.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - } - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - } - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - } - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - } - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{"shape":"AttributeBooleanValue"} - } - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - } - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You can only enable DNS hostnames if you also enable DNS support.

" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "enabled", - "pending" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

", - "locationName":"tenancy" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of instances available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - } - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - } - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - } - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - } - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - } - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - } - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - } - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot Instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot Instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot Instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot Instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot Instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - } - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

Information about the Spot Instance request.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you created the listing.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the modification request is idempotent.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - } - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - } - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

", - "locationName":"attribute" - } - } - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - } - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset (currently only the attribute for permission to create volumes can be reset).

" - } - } - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - } - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable indicates that route was automatically created when the route table was created.
  • CreateRoute indicates that the route was manually added to the route table.
  • EnableVgwRoutePropagation indicates that the route was propagated by route propagation.
", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you launch an instance without specifying a key pair, you can't connect to the instance.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instances.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - } - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the Base64 encoded JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the S3 bucket for an instance store-backed AMI.

" - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the Amazon EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or AWS account ID that owns the snapshot.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot Instance datafeed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to datafeed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot Instance datafeed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the datafeed for a Spot Instance.

" - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot Instance request. Spot bid status information can help you track your Spot Instance requests. For information, see Tracking Spot Requests with Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot Instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the Spot Instance request was created.

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot Instance.

", - "locationName":"productDescription" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describe a Spot Instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot Instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot Instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code of the request.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent status update.

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code for the Spot request.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot Instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price you will pay to launch one or more Spot Instances.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created.

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the Spot Price.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - } - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot Instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The volume limit was exceeded.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - } - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - } - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - } - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - } - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The ID of the security group owned by the specified AWS account.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The name of the security group in the specified AWS account.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group and AWS account ID pair for EC2-Classic.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100 to 4000 for Provisioned IOPS (SSD) volumes and 3 to 3072 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is encrypted.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an Amazon EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the peer VPC.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

Default: m1.small

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the Spot Instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification of a Spot Instance.

" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/waiters-2.json deleted file mode 100644 index fb8c16bd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-09-01/waiters-2.json +++ /dev/null @@ -1,341 +0,0 @@ -{ - "version": 2, - "waiters": { - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/paginators-1.json deleted file mode 100644 index ca7a8767..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/paginators-1.json +++ /dev/null @@ -1,51 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/service-2.json deleted file mode 100644 index 3bf12bd9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/service-2.json +++ /dev/null @@ -1,12085 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-10-01", - "endpointPrefix":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2014-10-01", - "protocol":"ec2" - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

", - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Attaches an Amazon EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

For a list of supported device names, see Attaching an Amazon EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for Amazon EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide for Linux.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.
  • AWS Marketplace product codes are copied from the volume to the instance.
  • You must be subscribed to the product.
  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about Amazon EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC.

You can have up to 50 rules per security group (covering both ingress and egress rules).

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request. AMIs that use encrypted Amazon EBS snapshots cannot be copied with this method.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an Amazon EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create Amazon EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted Amazon EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted.

Copying snapshots that were encrypted with non-default AWS Key Management Service (KMS) master keys is not supported at this time.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can't be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.
  • domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an Amazon S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting EC2 Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{ - "shape":"KeyPair", - "documentation":"

Information about the key pair.

", - "locationName":"keyPair" - }, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a Seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 100 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{ - "shape":"Snapshot", - "locationName":"snapshot" - }, - "documentation":"

Creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of Amazon EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{ - "shape":"Volume", - "locationName":"volume" - }, - "documentation":"

Creates an Amazon EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an Amazon EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an Amazon EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot Instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified Amazon EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{ - "shape":"ImageAttribute", - "documentation":"

Information about the image attribute.

", - "locationName":"imageAttribute" - }, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances, including any scheduled events.

Instance status has two main components:

  • System Status reports impaired functionality that stems from issues related to the systems that support an instance, such as such as hardware failures and network connectivity problems. This call reports such problems as impaired reachability.

  • Instance Status reports impaired functionality that arises from problems internal to the instance. This call reports such problems as impaired reachability.

Instance status provides information about four types of scheduled events for an instance that may require your attention:

  • Scheduled Reboot: When Amazon EC2 determines that an instance must be rebooted, the instances status returns one of two event codes: system-reboot or instance-reboot. System reboot commonly occurs if certain maintenance or upgrade operations require a reboot of the underlying host that supports an instance. Instance reboot commonly occurs if the instance must be rebooted, rather than the underlying host. Rebooting events include a scheduled start and end time.

  • System Maintenance: When Amazon EC2 determines that an instance requires maintenance that requires power or network impact, the instance status is the event code system-maintenance. System maintenance is either power maintenance or network maintenance. For power maintenance, your instance will be unavailable for a brief period of time and then rebooted. For network maintenance, your instance will experience a brief loss of network connectivity. System maintenance events include a scheduled start and end time. You will also be notified by email if one of your instances is set for system maintenance. The email message indicates when your instance is scheduled for maintenance.

  • Scheduled Retirement: When Amazon EC2 determines that an instance must be shut down, the instance status is the event code instance-retirement. Retirement commonly occurs when the underlying host is degraded and must be replaced. Retirement events include a scheduled start and end time. You will also be notified by email if one of your instances is set to retiring. The email message indicates when your instance will be permanently retired.

  • Scheduled Stop: When Amazon EC2 determines that an instance must be shut down, the instances status returns an event code called instance-stop. Stop events include a scheduled start and end time. You will also be notified by email if one of your instances is set to stop. The email message indicates when your instance will be stopped.

When your instance is retired, it will either be terminated (if its root device type is the instance-store) or stopped (if its root device type is an EBS volume). Instances stopped due to retirement will not be restarted, but you can do so manually. You can also avoid retirement of EBS-backed instances by manually restarting your instance when its event code is instance-retirement. This ensures that your instance is started on a different underlying host.

For more information about failed status checks, see Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about working with scheduled events, see Working with an Instance That Has a Scheduled Event in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the Amazon EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.
  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.
  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot Instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot Instance requests that belong to your account. Spot Instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot Price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide for Linux.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified Amazon EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Detaches an Amazon EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so results in the volume being stuck in a busy state while detaching.

If an Amazon EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the EC2 command line tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the Amazon EC2 command-line interface (CLI) tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

Snapshots with AWS Marketplace product codes cannot be made public.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time. You pay a lower usage rate than with On-Demand instances for the time that you actually use the capacity reservation.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If a Linux/Unix instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot Instance request. Spot Instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the SourceDestCheck, the instance can be either running or stopped.

The SourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

Removes one or more egress rules from a security group for EC2-VPC. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{ - "shape":"Reservation", - "documentation":"

One or more reservations.

", - "locationName":"reservation" - }, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide for Linux.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

T2 instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot Instances.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information about troubleshooting, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all Amazon EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - } - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - } - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - } - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] Allows an Elastic IP address that is already associated with an instance or network interface to be re-associated with the specified instance or network interface. Otherwise, the operation fails.

Default: false

", - "locationName":"allowReassociation" - } - } - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - } - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - } - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - } - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - } - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - } - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - } - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - } - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

The value to use when a resource attribute accepts a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

Valid values are case-sensitive and vary by action.

", - "locationName":"value" - } - }, - "documentation":"

The value to use for a resource attribute.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone (available | impaired | unavailable).

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":["available"] - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - } - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - } - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

The bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "locationName":"reasonMessage" - } - } - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - } - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - } - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - } - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot Instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot Instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - } - } - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide for Linux.

" - } - } - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new Amazon EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because Amazon EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - } - } - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - } - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - } - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - } - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - } - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - } - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - } - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "locationName":"exportToS3" - } - } - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "locationName":"exportTask" - } - } - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - } - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - } - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - } - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - } - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - } - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - } - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - } - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instances listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - } - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - } - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - } - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - } - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot Instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - } - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

" - } - } - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - } - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - } - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - } - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS (SSD) volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key to use when creating the encrypted volume. This parameter is only required if you want to use a non-default master key; if this parameter is not specified, the default master key is used. The ARN contains the arn:aws:kms namespace, followed by the region of the master key, the AWS account ID of the master key owner, the key namespace, and then the master key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

" - } - } - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - } - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The supported tenancy options for instances launched into the VPC. A value of default means that instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC are launched as dedicated tenancy instances regardless of the tenancy assigned to the instance at launch. Dedicated tenancy instances run on single-tenant hardware.

Default: default

", - "locationName":"instanceTenancy" - } - } - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - } - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - } - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - } - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - } - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - } - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - } - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - } - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - } - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - } - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - } - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - } - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - } - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - } - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - } - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - } - } - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - } - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - } - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - } - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - } - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - } - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - } - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - } - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - } - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - } - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - } - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - } - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - } - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - } - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - } - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "locationName":"conversionTasks" - } - } - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - } - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - } - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "locationName":"exportTaskSet" - } - } - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - } - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, amazon (owner is Amazon), aws-marketplace (owner is AWS Marketplace), self (owner is the sender of the request). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • block-device-mapping.volume-size - The volume size of the Amazon EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the Amazon EBS volume (gp2 | standard | io1).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - The AWS account alias (for example, amazon).

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - } - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - } - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

", - "locationName":"attribute" - } - } - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code identifying the type of event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • event.not-before - The earliest start time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • instance-state-code - A code representing the state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - } - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an Amazon EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the Amazon EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the Amazon EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance (spot).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot Instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface.id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface-private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

One or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - } - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - } - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - } - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - } - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - } - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - } - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - } - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform Network Address Translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - } - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - } - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - } - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - } - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - } - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - } - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance Listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - } - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - } - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from AWS and Reserved Instance Marketplace are listed.

  • product-description - The description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the Reserved Instance offering. A Reserved Instance with dedicated tenancy runs on single-tenant hardware and can only be launched within a VPC.

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - } - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2014-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • product-description - The product description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (pending-payment | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - } - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - } - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC.

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - } - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - The description of the security group.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - } - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - } - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - } - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - The AWS account alias (for example, amazon) that owns the snapshot.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - } - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot Instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot Instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume (gp2 | standard | io1).

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m1.small).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot Instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot Instance request ID.

  • spot-price - The maximum hourly price for any Spot Instance launched to fulfill the request.

  • state - The state of the Spot Instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot Instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide for Linux.

  • status-code - The short code describing the most recent evaluation of your Spot Instance request.

  • status-message - The message explaining the status of the Spot Instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot Instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - } - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data.

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot Price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot Price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot Price history (for example, 2010-08-16T05:06:11.000Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot Prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - } - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - } - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - } - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - } - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - } - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - } - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - } - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway.

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - } - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - } - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - } - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - } - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - } - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - } - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{"shape":"DiskImageDetail"}, - "Description":{"shape":"String"}, - "Volume":{"shape":"VolumeDetail"} - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - } - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - } - } - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - } - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, and standard for Magnetic volumes.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes an Amazon EBS block device.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an Amazon EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - } - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - } - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

The instance being exported.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "locationName":"s3Key" - } - } - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the Amazon S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - } - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "Float":{"type":"float"}, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64 encoded.

", - "locationName":"output" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - } - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - } - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping" - ] - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "available", - "deregistered" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

User data to be made available to the instance.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. This is not supported for VMs imported into a VPC, which are assigned the default security group. After a VM is imported into a VPC, you can specify another security group using the AWS Management Console. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about the Linux instance types you can import, see Before You Get Started in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] Optionally, you can use this parameter to assign the instance a specific available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - } - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - } - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - } - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. You must base64 encode the public key material before sending it to AWS.

", - "locationName":"publicKeyMaterial" - } - } - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting Amazon EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

An optional description for the volume being imported.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "locationName":"volume" - } - } - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The Base64-encoded MIME user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

he number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":["spot"] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Extra information regarding events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The associated code of the event.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes an instance event.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "t2.micro", - "t2.small", - "t2.medium", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "cg1.4xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The protocol.

When you call DescribeSecurityGroups, the protocol value returned is the number. Exception: For TCP, UDP, and ICMP, the value returned is the name (for example, tcp, udp, or icmp). For a list of protocol numbers, see Protocol Numbers. (VPC only) When you call AuthorizeSecurityGroupIngress, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. To request an instance in a nondefault VPC, you must specify the ID of the security group. To request an instance in EC2-Classic or a default VPC, you can specify the name or the ID of the security group.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - } - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or intanceInitiateShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking for the instance.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - } - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - } - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - } - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - } - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - } - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - } - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You can only enable DNS hostnames if you also enable DNS support.

" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "enabled", - "pending" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

", - "locationName":"tenancy" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of instances available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - } - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - } - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - } - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - } - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - } - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - } - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - } - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot Instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot Instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot Instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot Instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot Instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - } - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - } - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - } - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

", - "locationName":"attribute" - } - } - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - } - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset (currently only the attribute for permission to create volumes can be reset).

" - } - } - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - } - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable indicates that route was automatically created when the route table was created.
  • CreateRoute indicates that the route was manually added to the route table.
  • EnableVgwRoutePropagation indicates that the route was propagated by route propagation.
", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you launch an instance without specifying a key pair, you can't connect to the instance.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instances.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - } - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the Base64 encoded JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the Amazon EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or AWS account ID that owns the snapshot.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot Instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot Instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot Instance.

" - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot Instance request. Spot bid status information can help you track your Spot Instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot Instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the Spot Instance request was created.

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot Instance.

", - "locationName":"productDescription" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describe a Spot Instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot Instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot Instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent status update.

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot Instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot Instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot Instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created.

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - } - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot Instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The volume limit was exceeded.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - } - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - } - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - } - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - } - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "locationName":"data" - } - } - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. EC2-Classic only.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use GroupId.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an Amazon EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the peer VPC.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/waiters-2.json deleted file mode 100644 index 17f08705..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2014-10-01/waiters-2.json +++ /dev/null @@ -1,436 +0,0 @@ -{ - "version": 2, - "waiters": { - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/paginators-1.json deleted file mode 100644 index ca7a8767..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/paginators-1.json +++ /dev/null @@ -1,51 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/service-2.json deleted file mode 100644 index 88cf1402..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/service-2.json +++ /dev/null @@ -1,12707 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-03-01", - "endpointPrefix":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2015-03-01", - "protocol":"ec2" - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

", - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Attaches an Amazon EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

For a list of supported device names, see Attaching an Amazon EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for Amazon EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide for Linux.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.
  • AWS Marketplace product codes are copied from the volume to the instance.
  • You must be subscribed to the product.
  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about Amazon EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC.

You can have up to 50 rules per security group (covering both ingress and egress rules).

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request. AMIs that use encrypted Amazon EBS snapshots cannot be copied with this method.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an Amazon EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create Amazon EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted Amazon EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted.

Copying snapshots that were encrypted with non-default AWS Key Management Service (KMS) master keys is not supported at this time.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can't be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.
  • domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an Amazon S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting EC2 Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{ - "shape":"KeyPair", - "documentation":"

Information about the key pair.

", - "locationName":"keyPair" - }, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a Seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 100 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{ - "shape":"Snapshot", - "locationName":"snapshot" - }, - "documentation":"

Creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of Amazon EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{ - "shape":"Volume", - "locationName":"volume" - }, - "documentation":"

Creates an Amazon EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an Amazon EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an Amazon EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot Instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified Amazon EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{ - "shape":"ImageAttribute", - "documentation":"

Information about the image attribute.

", - "locationName":"imageAttribute" - }, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Displays details about an import snapshot tasks that is already created.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances, including any scheduled events.

Instance status has two main components:

  • System Status reports impaired functionality that stems from issues related to the systems that support an instance, such as such as hardware failures and network connectivity problems. This call reports such problems as impaired reachability.

  • Instance Status reports impaired functionality that arises from problems internal to the instance. This call reports such problems as impaired reachability.

Instance status provides information about four types of scheduled events for an instance that may require your attention:

  • Scheduled Reboot: When Amazon EC2 determines that an instance must be rebooted, the instances status returns one of two event codes: system-reboot or instance-reboot. System reboot commonly occurs if certain maintenance or upgrade operations require a reboot of the underlying host that supports an instance. Instance reboot commonly occurs if the instance must be rebooted, rather than the underlying host. Rebooting events include a scheduled start and end time.

  • System Maintenance: When Amazon EC2 determines that an instance requires maintenance that requires power or network impact, the instance status is the event code system-maintenance. System maintenance is either power maintenance or network maintenance. For power maintenance, your instance will be unavailable for a brief period of time and then rebooted. For network maintenance, your instance will experience a brief loss of network connectivity. System maintenance events include a scheduled start and end time. You will also be notified by email if one of your instances is set for system maintenance. The email message indicates when your instance is scheduled for maintenance.

  • Scheduled Retirement: When Amazon EC2 determines that an instance must be shut down, the instance status is the event code instance-retirement. Retirement commonly occurs when the underlying host is degraded and must be replaced. Retirement events include a scheduled start and end time. You will also be notified by email if one of your instances is set to retiring. The email message indicates when your instance will be permanently retired.

  • Scheduled Stop: When Amazon EC2 determines that an instance must be shut down, the instances status returns an event code called instance-stop. Stop events include a scheduled start and end time. You will also be notified by email if one of your instances is set to stop. The email message indicates when your instance will be stopped.

When your instance is retired, it will either be terminated (if its root device type is the instance-store) or stopped (if its root device type is an EBS volume). Instances stopped due to retirement will not be restarted, but you can do so manually. You can also avoid retirement of EBS-backed instances by manually restarting your instance when its event code is instance-retirement. This ensures that your instance is started on a different underlying host.

For more information about failed status checks, see Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about working with scheduled events, see Working with an Instance That Has a Scheduled Event in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the Amazon EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.
  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.
  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about Amazon EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot Instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot Instance requests that belong to your account. Spot Instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot Price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide for Linux.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified Amazon EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about Amazon EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "locationName":"attachment" - }, - "documentation":"

Detaches an Amazon EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so results in the volume being stuck in a busy state while detaching.

If an Amazon EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide for Linux.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or Amazon EBS snapshots into an Amazon Machine Image (AMI).

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. After importing the image, you then upload it using the ec2-import-volume command in the EC2 command line tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Import a disk into an Amazon Elastic Block Store (Amazon EBS) snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the Amazon EC2 command-line interface (CLI) tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

Snapshots with AWS Marketplace product codes cannot be made public.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time. You pay a lower usage rate than with On-Demand instances for the time that you actually use the capacity reservation.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If a Linux/Unix instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide for Linux.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide for Linux.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot Instance request. Spot Instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the SourceDestCheck, the instance can be either running or stopped.

The SourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

Removes one or more egress rules from a security group for EC2-VPC. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{ - "shape":"Reservation", - "documentation":"

One or more reservations.

", - "locationName":"reservation" - }, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide for Linux.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide for Linux.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide for Linux.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

T2 instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot Instances.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information about troubleshooting, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all Amazon EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide for Linux.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide for Linux.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - } - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - } - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - } - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] Allows an Elastic IP address that is already associated with an instance or network interface to be re-associated with the specified instance or network interface. Otherwise, the operation fails.

Default: false

", - "locationName":"allowReassociation" - } - } - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - } - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - } - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - } - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - } - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - } - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - } - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - } - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

The value to use when a resource attribute accepts a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

Valid values are case-sensitive and vary by action.

", - "locationName":"value" - } - }, - "documentation":"

The value to use for a resource attribute.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone (available | impaired | unavailable).

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":["available"] - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - } - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - } - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

The bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "locationName":"reasonMessage" - } - } - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - } - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "DryRun":{"shape":"Boolean"}, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the ImportImage or ImportSnapshot task to be cancelled.

" - }, - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - } - } - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the ImportImage or ImportSnapshot task being canceled.

", - "locationName":"importTaskId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the ImportImage or ImportSnapshot task being canceled.

", - "locationName":"state" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the ImportImage or ImportSnapshot task being canceled.

", - "locationName":"previousState" - } - } - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - } - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - } - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot Instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot Instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClientData":{ - "type":"structure", - "members":{ - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

User-defined comment about the upload.

" - } - }, - "documentation":"

Client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - } - } - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide for Linux.

" - } - } - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new Amazon EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because Amazon EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - } - } - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - } - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - } - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - } - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - } - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - } - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - } - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "locationName":"exportToS3" - } - } - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "locationName":"exportTask" - } - } - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - } - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - } - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - } - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - } - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - } - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - } - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - } - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instances listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - } - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - } - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - } - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - } - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot Instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - } - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

" - } - } - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - } - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - } - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - } - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS (SSD) volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key to use when creating the encrypted volume. This parameter is only required if you want to use a non-default master key; if this parameter is not specified, the default master key is used. The ARN contains the arn:aws:kms namespace, followed by the region of the master key, the AWS account ID of the master key owner, the key namespace, and then the master key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

" - } - } - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - } - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The supported tenancy options for instances launched into the VPC. A value of default means that instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC are launched as dedicated tenancy instances regardless of the tenancy assigned to the instance at launch. Dedicated tenancy instances run on single-tenant hardware.

Default: default

", - "locationName":"instanceTenancy" - } - } - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - } - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - } - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - } - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - } - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - } - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - } - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - } - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - } - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - } - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - } - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - } - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - } - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - } - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - } - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - } - } - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - } - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - } - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - } - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - } - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - } - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - } - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - } - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - } - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - } - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - } - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - } - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - } - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - } - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - } - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "locationName":"conversionTasks" - } - } - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - } - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - } - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "locationName":"exportTaskSet" - } - } - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - } - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, amazon (owner is Amazon), aws-marketplace (owner is AWS Marketplace), self (owner is the sender of the request). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • block-device-mapping.volume-size - The volume size of the Amazon EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the Amazon EBS volume (gp2 | standard | io1).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - The AWS account alias (for example, amazon).

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - } - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - } - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{"shape":"Boolean"}, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of ImportImage task IDs to describe.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to get the next page of paginated describe requests.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results in a page.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filters to be applied on a describe request.

" - } - } - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more ImportImage tasks that are currently active or completed/cancelled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to get the next page of paginated describe requests.

", - "locationName":"nextToken" - } - } - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{"shape":"Boolean"}, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of IDs of the ImportSnapshot tasks to describe.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to get to the next page of paginated describe requests.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results in a page.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

The filters to be applied on a describe request.

" - } - } - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more ImportSnapshot tasks that are currently active or completed/cancelled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to get to the next page of paginated describe requests.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

", - "locationName":"attribute" - } - } - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code identifying the type of event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • event.not-before - The earliest start time for the scheduled event, for example: 2010-09-15T17:15:20.000Z.

  • instance-state-code - A code representing the state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - } - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an Amazon EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the Amazon EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the Amazon EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance (spot).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot Instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface.id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface-private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

One or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - } - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - } - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - } - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - } - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - } - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - } - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - } - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform Network Address Translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - } - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - } - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - } - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - } - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - } - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - } - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance Listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - } - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - } - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from AWS and Reserved Instance Marketplace are listed.

  • product-description - The description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the Reserved Instance offering. A Reserved Instance with dedicated tenancy runs on single-tenant hardware and can only be launched within a VPC.

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - } - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2014-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • product-description - The product description of the Reserved Instance (Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (pending-payment | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - } - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - } - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC.

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - } - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - The description of the security group.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - } - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - } - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - } - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - The AWS account alias (for example, amazon) that owns the snapshot.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - } - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - } - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot Instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot Instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume (gp2 | standard | io1).

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m1.small).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot Instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot Instance request ID.

  • spot-price - The maximum hourly price for any Spot Instance launched to fulfill the request.

  • state - The state of the Spot Instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot Instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide for Linux.

  • status-code - The short code describing the most recent evaluation of your Spot Instance request.

  • status-message - The message explaining the status of the Spot Instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot Instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - } - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data.

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot Price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot Price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot Price history (for example, 2010-08-16T05:06:11.000Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot Prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - } - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - } - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - } - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - } - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - } - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - } - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - } - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway.

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - } - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - } - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - } - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - } - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - } - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - } - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{"shape":"DiskImageDetail"}, - "Description":{"shape":"String"}, - "Volume":{"shape":"VolumeDetail"} - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - } - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - } - } - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - } - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, and standard for Magnetic volumes.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes an Amazon EBS block device.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an Amazon EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the Amazon EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - } - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - } - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

The instance being exported.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "locationName":"s3Key" - } - } - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the Amazon S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - } - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "Float":{"type":"float"}, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64 encoded.

", - "locationName":"output" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - } - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - } - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image (optional).

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported (optional).

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{"shape":"UserBucket"}, - "DeviceName":{ - "shape":"String", - "documentation":"

The Amazon EBS block device mapping for the disk (optional).

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The Amazon EBS snapshot ID to be used for importing the snapshot.

" - } - }, - "documentation":"

The disk container object for an ImportImage task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "DryRun":{"shape":"Boolean"}, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task (optional).

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "locationName":"DiskContainer" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing (optional).

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see VM Import/Export Prerequisites in the Amazon Elastic Compute Cloud User Guide for Linux.

Valid Values: AWS | BYOL

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform to use (optional).

" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine being imported (optional).

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine being imported (optional).

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

Client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests (optional).

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role name 'vmimport' (optional).

" - } - } - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task id of the ImportImage task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

Architecture of the virtual machine being imported.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

License type of the virtual machine being imported.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

Operating system of the VM being imported.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

Target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The Amazon Machine Image (AMI) ID created by the import task.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The task's progress.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - } - } - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

Architecture of the VM being imported.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

License type of the VM being imported.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

Target hypervisor for the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

Description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The Amazon Machine Image (AMI) ID of the imported virtual machine.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the ImportImage task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the ImportImage task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the ImportImage task.

", - "locationName":"status" - } - } - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

User data to be made available to the instance.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. This is not supported for VMs imported into a VPC, which are assigned the default security group. After a VM is imported into a VPC, you can specify another security group using the AWS Management Console. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux. For more information about the Linux instance types you can import, see Before You Get Started in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] Optionally, you can use this parameter to assign the instance a specific available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - } - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - } - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - } - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. You must base64 encode the public key material before sending it to AWS.

", - "locationName":"publicKeyMaterial" - } - } - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - } - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "DryRun":{"shape":"Boolean"}, - "Description":{ - "shape":"String", - "documentation":"

The description string for the ImportSnapshot task.

" - }, - "DiskContainer":{"shape":"SnapshotDiskContainer"}, - "ClientData":{"shape":"ClientData"}, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests (optional).

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role name 'vmimport' (optional).

" - } - } - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

Task ID of the ImportSnapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

Description of the import snapshot task.

", - "locationName":"description" - } - } - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the ImportSnapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

Description for the import snapshot task.

", - "locationName":"description" - } - } - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting Amazon EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

An optional description for the volume being imported.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "locationName":"volume" - } - } - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "locationName":"conversionTask" - } - } - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The Base64-encoded MIME user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up Amazon EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

he number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":["spot"] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Extra information regarding events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The associated code of the event.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes an instance event.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "t2.micro", - "t2.small", - "t2.medium", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "cg1.4xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The protocol.

When you call DescribeSecurityGroups, the protocol value returned is the number. Exception: For TCP, UDP, and ICMP, the value returned is the name (for example, tcp, udp, or icmp). For a list of protocol numbers, see Protocol Numbers. (VPC only) When you call AuthorizeSecurityGroupIngress, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. To request an instance in a nondefault VPC, you must specify the ID of the security group. To request an instance in EC2-Classic or a default VPC, you can specify the name or the ID of the security group.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - } - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or intanceInitiateShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking for the instance.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - } - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - } - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - } - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

" - }, - "OperationType":{ - "shape":"String", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - } - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - } - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - } - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You can only enable DNS hostnames if you also enable DNS support.

" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

", - "locationName":"tenancy" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of instances available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - } - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - } - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - } - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - } - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - } - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - } - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - } - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot Instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot Instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot Instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot Instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot Instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - } - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - } - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - } - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - } - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

", - "locationName":"attribute" - } - } - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - } - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset (currently only the attribute for permission to create volumes can be reset).

" - } - } - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the destination security group. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The ID of the source security group. You can't specify a source security group and a CIDR IP address range.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - } - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable indicates that route was automatically created when the route table was created.
  • CreateRoute indicates that the route was manually added to the route table.
  • EnableVgwRoutePropagation indicates that the route was propagated by route propagation.
", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you launch an instance without specifying a key pair, you can't connect to the instance.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instances.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide for Linux.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - } - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the Base64 encoded JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the Amazon EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or AWS account ID that owns the snapshot.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

Description for the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "locationName":"userBucket" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The Amazon EBS block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - } - }, - "documentation":"

The details of the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{"shape":"UserBucket"} - }, - "documentation":"

The disk container object for the ImportSnapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "locationName":"userBucket" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the ImportSnapshot task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the ImportSnapshot task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the ImportSnapshot task.

", - "locationName":"status" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot Instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot Instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot Instance.

" - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot Instance request. Spot bid status information can help you track your Spot Instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide for Linux.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot Instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the Spot Instance request was created.

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot Instance.

", - "locationName":"productDescription" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describe a Spot Instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot Instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot Instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent status update.

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot Instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot Instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot Instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created.

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot Instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - } - } - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - } - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot Instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The volume limit was exceeded.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - } - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - } - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - } - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - } - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket name where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The Amazon S3 Key for the disk image.

" - } - }, - "documentation":"

User's Amazon S3 bucket details used to access the image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The Amazon S3 key from which the disk image was created.

", - "locationName":"s3Key" - } - }, - "documentation":"

User's Amazon S3 bucket details used to access the image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "locationName":"data" - } - } - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. EC2-Classic only.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use GroupId.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide for Linux.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (KMS) master key that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Amazon EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an Amazon EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the peer VPC.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/waiters-2.json deleted file mode 100644 index 17f08705..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-03-01/waiters-2.json +++ /dev/null @@ -1,436 +0,0 @@ -{ - "version": 2, - "waiters": { - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/paginators-1.json deleted file mode 100644 index ca7a8767..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/paginators-1.json +++ /dev/null @@ -1,51 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/service-2.json deleted file mode 100644 index 426927ae..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/service-2.json +++ /dev/null @@ -1,14625 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-04-15", - "endpointPrefix":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2015-04-15", - "protocol":"ec2" - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

", - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "documentation":"

Information about the volume attachment.

", - "locationName":"attachment" - }, - "documentation":"

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.
  • AWS Marketplace product codes are copied from the volume to the instance.
  • You must be subscribed to the product.
  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC.

You can have up to 50 rules per security group (covering both ingress and egress rules).

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotFleetRequests":{ - "name":"CancelSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CancelSpotFleetRequestsRequest", - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "output":{ - "shape":"CancelSpotFleetRequestsResponse", - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "documentation":"

Cancels the specified Spot fleet requests.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CancelSpotInstanceRequestsRequest", - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "output":{ - "shape":"CancelSpotInstanceRequestsResult", - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "documentation":"

Cancels one or more Spot instance requests. Spot instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

Canceling a Spot instance request does not terminate running Spot instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request. AMIs that use encrypted EBS snapshots cannot be copied with this method.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless the Encrypted flag is specified during the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a non-default CMK with the KmsKeyId parameter.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can't be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.
  • domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateFlowLogs":{ - "name":"CreateFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFlowLogsRequest"}, - "output":{"shape":"CreateFlowLogsResult"}, - "documentation":"

Creates one or more flow logs to capture IP traffic for a specific network interface, subnet, or VPC. Flow logs are delivered to a specified log group in Amazon CloudWatch Logs. If you specify a VPC or subnet in the request, a log stream is created in CloudWatch Logs for each network interface in the subnet or VPC. Log streams can include information about accepted and rejected traffic to a network interface. You can view the data in your log streams using Amazon CloudWatch Logs.

In your request, you must also specify an IAM role that has permission to publish logs to CloudWatch Logs.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting EC2 Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{ - "shape":"KeyPair", - "documentation":"

Information about the key pair.

", - "locationName":"keyPair" - }, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "output":{"shape":"CreateRouteResult"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 100 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{ - "shape":"Snapshot", - "documentation":"

Information about the snapshot.

", - "locationName":"snapshot" - }, - "documentation":"

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateSpotDatafeedSubscriptionRequest", - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "output":{ - "shape":"CreateSpotDatafeedSubscriptionResult", - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "documentation":"

Creates a data feed for Spot instances, enabling you to view Spot instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{ - "shape":"Volume", - "documentation":"

Information about the volume.

", - "locationName":"volume" - }, - "documentation":"

Creates an EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcEndpoint":{ - "name":"CreateVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointRequest"}, - "output":{"shape":"CreateVpcEndpointResult"}, - "documentation":"

Creates a VPC endpoint for a specified AWS service. An endpoint enables you to create a private connection between your VPC and another AWS service in your account. You can specify an endpoint policy to attach to the endpoint that will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.

Currently, only endpoints to Amazon S3 are supported.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteFlowLogs":{ - "name":"DeleteFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFlowLogsRequest"}, - "output":{"shape":"DeleteFlowLogsResult"}, - "documentation":"

Deletes one or more flow logs.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteSpotDatafeedSubscriptionRequest", - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "documentation":"

Deletes the data feed for Spot instances.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcEndpoints":{ - "name":"DeleteVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointsRequest"}, - "output":{"shape":"DeleteVpcEndpointsResult"}, - "documentation":"

Deletes one or more specified VPC endpoints. Deleting the endpoint also deletes the endpoint routes in the route tables that were associated with the endpoint.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeFlowLogs":{ - "name":"DescribeFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFlowLogsRequest"}, - "output":{"shape":"DescribeFlowLogsResult"}, - "documentation":"

Describes one or more flow logs. To view the information in your flow logs (the log streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs API.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{ - "shape":"ImageAttribute", - "documentation":"

Information about the image attribute.

", - "locationName":"imageAttribute" - }, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Describes your import snapshot tasks.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{ - "shape":"InstanceAttribute", - "documentation":"

Information about the instance attribute.

" - }, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances.

Instance status includes the following components:

  • Status checks - Amazon EC2 performs status checks on running EC2 instances to identify hardware and software issues. For more information, see Status Checks for Your Instances and Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide.

  • Scheduled events - Amazon EC2 can schedule events (such as reboot, stop, or terminate) for your instances related to hardware issues, software updates, or system maintenance. For more information, see Scheduled Events for Your Instances in the Amazon Elastic Compute Cloud User Guide.

  • Instance state - You can manage your instances from the moment you launch them through their termination. For more information, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeMovingAddresses":{ - "name":"DescribeMovingAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMovingAddressesRequest"}, - "output":{"shape":"DescribeMovingAddressesResult"}, - "documentation":"

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribePrefixLists":{ - "name":"DescribePrefixLists", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrefixListsRequest"}, - "output":{"shape":"DescribePrefixListsResult"}, - "documentation":"

Describes available AWS services in a prefix list format, which includes the prefix list name and prefix list ID of the service and the IP address range for the service. A prefix list ID is required for creating an outbound security group rule that allows traffic from a VPC to access an AWS service through a VPC endpoint.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.
  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.
  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotDatafeedSubscriptionRequest", - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "output":{ - "shape":"DescribeSpotDatafeedSubscriptionResult", - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "documentation":"

Describes the data feed for Spot instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotFleetInstances":{ - "name":"DescribeSpotFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotFleetInstancesRequest", - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "output":{ - "shape":"DescribeSpotFleetInstancesResponse", - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "documentation":"

Describes the running instances for the specified Spot fleet.

" - }, - "DescribeSpotFleetRequestHistory":{ - "name":"DescribeSpotFleetRequestHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotFleetRequestHistoryRequest", - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "output":{ - "shape":"DescribeSpotFleetRequestHistoryResponse", - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "documentation":"

Describes the events for the specified Spot fleet request during the specified time.

Spot fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event.

" - }, - "DescribeSpotFleetRequests":{ - "name":"DescribeSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotFleetRequestsRequest", - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "output":{ - "shape":"DescribeSpotFleetRequestsResponse", - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "documentation":"

Describes your Spot fleet requests.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotInstanceRequestsRequest", - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "output":{ - "shape":"DescribeSpotInstanceRequestsResult", - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "documentation":"

Describes the Spot instance requests that belong to your account. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

You can use DescribeSpotInstanceRequests to find a running Spot instance by examining the response. If the status of the Spot instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSpotPriceHistoryRequest", - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "output":{ - "shape":"DescribeSpotPriceHistoryResult", - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "documentation":"

Describes the Spot price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcEndpointServices":{ - "name":"DescribeVpcEndpointServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicesRequest"}, - "output":{"shape":"DescribeVpcEndpointServicesResult"}, - "documentation":"

Describes all supported AWS services that can be specified when creating a VPC endpoint.

" - }, - "DescribeVpcEndpoints":{ - "name":"DescribeVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointsRequest"}, - "output":{"shape":"DescribeVpcEndpointsResult"}, - "documentation":"

Describes one or more of your VPC endpoints.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{ - "shape":"VolumeAttachment", - "documentation":"

Information about the volume attachment.

", - "locationName":"attachment" - }, - "documentation":"

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so results in the volume being stuck in a busy state while detaching.

If an Amazon EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI).

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. After importing the image, you then upload it using the ec2-import-volume command in the EC2 command line tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Imports a disk into an EBS snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the Amazon EC2 command-line interface (CLI) tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

Snapshots with AWS Marketplace product codes cannot be made public.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "ModifyVpcEndpoint":{ - "name":"ModifyVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointRequest"}, - "output":{"shape":"ModifyVpcEndpointResult"}, - "documentation":"

Modifies attributes of a specified VPC endpoint. You can modify the policy associated with the endpoint, and you can add and remove route tables associated with the endpoint.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MoveAddressToVpc":{ - "name":"MoveAddressToVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAddressToVpcRequest"}, - "output":{"shape":"MoveAddressToVpcResult"}, - "documentation":"

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The Elastic IP address must be allocated to your account, and it must not be associated with an instance. After the Elastic IP address is moved, it is no longer available for use in the EC2-Classic platform, unless you move it back using the RestoreAddressToClassic request. You cannot move an Elastic IP address that's allocated for use in the EC2-VPC platform to the EC2-Classic platform.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time and pay a lower hourly rate compared to on-Demand Instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If a Linux/Unix instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.

Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), use the EC2 billingProduct code associated with an AMI to verify subscription status for package updates. Creating an AMI from an EBS snapshot does not maintain this billing code, and subsequent instances launched from such an AMI will not be able to connect to package update infrastructure.

Similarly, although you can create a Windows AMI from a snapshot, you can't successfully launch an instance from the AMI.

To create Windows AMIs or to create AMIs for Linux operating systems that must retain AMI billing codes to work properly, see CreateImage.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotFleet":{ - "name":"RequestSpotFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RequestSpotFleetRequest", - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "output":{ - "shape":"RequestSpotFleetResponse", - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "documentation":"

Creates a Spot fleet request.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot fleet requests Spot instances in the Spot pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot instances in your Spot fleet are in different Spot pools, you can improve the availability of your fleet.

For more information, see Spot Fleet Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RequestSpotInstancesRequest", - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "output":{ - "shape":"RequestSpotInstancesResult", - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "documentation":"

Creates a Spot instance request. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot Instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the SourceDestCheck, the instance can be either running or stopped.

The SourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RestoreAddressToClassic":{ - "name":"RestoreAddressToClassic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreAddressToClassicRequest"}, - "output":{"shape":"RestoreAddressToClassicResult"}, - "documentation":"

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

Removes one or more egress rules from a security group for EC2-VPC. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{ - "shape":"Reservation", - "documentation":"

One or more reservations.

", - "locationName":"reservation" - }, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC only accounts] If you don't specify a subnet in the request, we choose a default subnet from your default VPC for you.

[EC2-Classic accounts] If you're launching into EC2-Classic and you don't specify an Availability Zone, we choose one for you.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

T2 instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot Instances.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the DeleteOnTermination block device mapping parameter set to true are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "ActiveInstance":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - } - }, - "documentation":"

Describes a running instance in a Spot fleet.

" - }, - "ActiveInstanceSet":{ - "type":"list", - "member":{ - "shape":"ActiveInstance", - "locationName":"item" - } - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - } - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - } - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "AllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "diversified" - ] - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - } - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] Allows an Elastic IP address that is already associated with an instance or network interface to be re-associated with the specified instance or network interface. Otherwise, the operation fails.

Default: false

", - "locationName":"allowReassociation" - } - } - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - } - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - } - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - } - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - } - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - } - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - } - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - } - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

The value to use when a resource attribute accepts a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

Valid values are case-sensitive and vary by action.

", - "locationName":"value" - } - }, - "documentation":"

The value to use for a resource attribute.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The AWS account number for the source security group. For EC2-VPC, the source security group must be in the same VPC. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone (available | impaired | unavailable).

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":["available"] - }, - "BatchState":{ - "type":"string", - "enum":[ - "submitted", - "active", - "cancelled", - "failed", - "cancelled_running", - "cancelled_terminating" - ] - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - } - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBatchErrorCode":{ - "type":"string", - "enum":[ - "fleetRequestIdDoesNotExist", - "fleetRequestIdMalformed", - "fleetRequestNotInCancellableState", - "unexpectedError" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - } - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - } - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "documentation":"

The reason for canceling the conversion task.

", - "locationName":"reasonMessage" - } - } - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - } - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image or import snapshot task to be canceled.

" - }, - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - } - } - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the task being canceled.

", - "locationName":"importTaskId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"state" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"previousState" - } - } - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - } - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CancelSpotFleetRequestsError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"CancelBatchErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot fleet error.

" - }, - "CancelSpotFleetRequestsErrorItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "Error" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "Error":{ - "shape":"CancelSpotFleetRequestsError", - "documentation":"

The error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a Spot fleet request that was not successfully canceled.

" - }, - "CancelSpotFleetRequestsErrorSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsErrorItem", - "locationName":"item" - } - }, - "CancelSpotFleetRequestsRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for a Spot fleet request if it is canceled successfully.

", - "locationName":"terminateInstances" - } - }, - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsResponse":{ - "type":"structure", - "members":{ - "UnsuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsErrorSet", - "documentation":"

Information about the Spot fleet requests that are not successfully canceled.

", - "locationName":"unsuccessfulFleetRequestSet" - }, - "SuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsSuccessSet", - "documentation":"

Information about the Spot fleet requests that are successfully canceled.

", - "locationName":"successfulFleetRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsSuccessItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "CurrentSpotFleetRequestState", - "PreviousSpotFleetRequestState" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "CurrentSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The current state of the Spot fleet request.

", - "locationName":"currentSpotFleetRequestState" - }, - "PreviousSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The previous state of the Spot fleet request.

", - "locationName":"previousSpotFleetRequestState" - } - }, - "documentation":"

Describes a Spot fleet request that was successfully canceled.

" - }, - "CancelSpotFleetRequestsSuccessSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsSuccessItem", - "locationName":"item" - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClientData":{ - "type":"structure", - "members":{ - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image, in GiB.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment about the disk upload.

" - } - }, - "documentation":"

Describes the client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - }, - "Return":{ - "shape":"Boolean", - "documentation":"

The return value of the request. Returns true if the specified product code is owned by the requester and associated with the specified instance.

", - "locationName":"return" - } - } - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the task.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - } - } - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshot should be encrypted. There is no way to create an unencrypted snapshot copy from an encrypted snapshot; however, you can encrypt a copy of an unencrypted snapshot with this flag. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when creating the snapshot copy. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - } - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - } - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - } - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - } - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - } - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - } - }, - "CreateFlowLogsRequest":{ - "type":"structure", - "required":[ - "ResourceIds", - "ResourceType", - "TrafficType", - "LogGroupName", - "DeliverLogsPermissionArn" - ], - "members":{ - "ResourceIds":{ - "shape":"ValueStringList", - "documentation":"

One or more subnet, network interface, or VPC IDs.

", - "locationName":"ResourceId" - }, - "ResourceType":{ - "shape":"FlowLogsResourceType", - "documentation":"

The type of resource on which to create the flow log.

" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic to log.

" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch log group.

" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that's used to post flow logs to a CloudWatch Logs log group.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - } - }, - "CreateFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the flow logs.

", - "locationName":"flowLogIdSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be created successfully.

", - "locationName":"unsuccessful" - } - } - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, this parameter is set to false, which means Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. When the parameter is set to true, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - } - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - } - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "documentation":"

The format and location for an instance export task.

", - "locationName":"exportToS3" - } - } - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "documentation":"

Information about the instance export task.

", - "locationName":"exportTask" - } - } - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - } - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - } - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - } - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - } - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - } - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - } - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - } - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - } - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - } - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instances listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "CreateRouteResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - } - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - } - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - } - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - } - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - }, - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: Amazon EC2 selects one for you (recommended).

" - } - } - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - } - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - }, - "documentation":"

Describes the user or group to be added or removed from the permissions for a volume.

" - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - }, - "documentation":"

Describes modifications to the permissions for a volume.

" - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS (SSD) volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. If a KmsKeyId is specified, the Encrypted flag must also be set.

" - } - } - }, - "CreateVpcEndpointRequest":{ - "type":"structure", - "required":[ - "VpcId", - "ServiceName" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the endpoint will be used.

" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The AWS service name, in the form com.amazonaws.region.service. To get a list of available services, use the DescribeVpcEndpointServices request.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy to attach to the endpoint that controls access to the service. The policy must be in valid JSON format. If this parameter is not specified, we attach a default policy that allows full access to the service.

" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

", - "locationName":"RouteTableId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - } - }, - "CreateVpcEndpointResult":{ - "type":"structure", - "members":{ - "VpcEndpoint":{ - "shape":"VpcEndpoint", - "documentation":"

Information about the endpoint.

", - "locationName":"vpcEndpoint" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - } - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - } - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - } - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The supported tenancy options for instances launched into the VPC. A value of default means that instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC are launched as dedicated tenancy instances regardless of the tenancy assigned to the instance at launch. Dedicated tenancy instances run on single-tenant hardware.

Default: default

", - "locationName":"instanceTenancy" - } - } - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - } - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - } - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - } - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - } - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - } - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - } - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - } - }, - "DeleteFlowLogsRequest":{ - "type":"structure", - "required":["FlowLogIds"], - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - } - } - }, - "DeleteFlowLogsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - } - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - } - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - } - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - } - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - } - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - } - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - } - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - } - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - } - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - } - } - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - } - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - } - }, - "DeleteVpcEndpointsRequest":{ - "type":"structure", - "required":["VpcEndpointIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - } - } - }, - "DeleteVpcEndpointsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the endpoints that were not successfully deleted.

", - "locationName":"unsuccessful" - } - } - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - } - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - } - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - } - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - } - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - } - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - } - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - } - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - } - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - } - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - } - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - } - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - } - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - } - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "documentation":"

Information about the conversion tasks.

", - "locationName":"conversionTasks" - } - } - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - } - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - } - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "documentation":"

Information about the export tasks.

", - "locationName":"exportTaskSet" - } - } - }, - "DescribeFlowLogsRequest":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • deliver-log-status - The status of the logs delivery (SUCCESS | FAILED).

  • flow-log-id - The ID of the flow log.

  • log-group-name - The name of the log group.

  • resource-id - The ID of the VPC, subnet, or network interface.

  • traffic-type - The type of traffic (ACCEPT | REJECT | ALL)

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the flow log IDs parameter in the same request.

" - } - } - }, - "DescribeFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogs":{ - "shape":"FlowLogSet", - "documentation":"

Information about the flow logs.

", - "locationName":"flowLogSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - } - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, amazon (owner is Amazon), aws-marketplace (owner is AWS Marketplace), self (owner is the sender of the request). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the EBS volume.

  • block-device-mapping.volume-size - The volume size of the EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the EBS volume (gp2 | standard | io1).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - The AWS account alias (for example, amazon).

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - } - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - } - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import image task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single request.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - } - } - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import snapshot task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single request.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - } - } - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

", - "locationName":"attribute" - } - } - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code for the scheduled event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • event.not-before - The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • instance-state-code - The code for the instance state, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - } - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance (spot).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot Instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface.id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface-private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

One or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - } - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - } - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - } - }, - "DescribeMovingAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"ValueStringList", - "documentation":"

One or more Elastic IP addresses.

", - "locationName":"publicIp" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • moving-status - The status of the Elastic IP address (MovingToVpc | RestoringToClassic).

", - "locationName":"filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value outside of this range, an error is returned.

Default: If no value is provided, the default is 1000.

", - "locationName":"maxResults" - } - } - }, - "DescribeMovingAddressesResult":{ - "type":"structure", - "members":{ - "MovingAddressStatuses":{ - "shape":"MovingAddressStatusSet", - "documentation":"

The status for each Elastic IP address.

", - "locationName":"movingAddressStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - } - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - } - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - } - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - } - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform Network Address Translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - } - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - } - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - } - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - } - }, - "DescribePrefixListsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "PrefixListIds":{ - "shape":"ValueStringList", - "documentation":"

One or more prefix list IDs.

", - "locationName":"PrefixListId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribePrefixListsResult":{ - "type":"structure", - "members":{ - "PrefixLists":{ - "shape":"PrefixListSet", - "documentation":"

All available prefix lists.

", - "locationName":"prefixListSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - } - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - } - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance Listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - } - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - } - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - } - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from AWS and Reserved Instance Marketplace are listed.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC))

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the Reserved Instance offering. A Reserved Instance with dedicated tenancy runs on single-tenant hardware and can only be launched within a VPC.

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - } - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type on which the Reserved Instance can be used.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - } - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - } - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC.

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.destination-prefix-list-id - The ID (prefix) of the AWS service specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - } - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.

  • description - The description of the security group.

  • egress.ip-permission.prefix-list-id - The ID (prefix) of the AWS service to which the security group allows access.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - } - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - } - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - } - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - The AWS account alias (for example, amazon) that owns the snapshot.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - } - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotFleetInstancesRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetInstancesResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "ActiveInstances" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. Note that this list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetRequestHistoryRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The type of events to describe. By default, all events are described.

", - "locationName":"eventType" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestHistoryResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime", - "LastEvaluatedTime", - "HistoryRecords" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "HistoryRecords":{ - "shape":"HistoryRecords", - "documentation":"

Information about the events in the history of the Spot fleet request.

", - "locationName":"historyRecordSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "DescribeSpotFleetRequestsResponse":{ - "type":"structure", - "required":["SpotFleetRequestConfigs"], - "members":{ - "SpotFleetRequestConfigs":{ - "shape":"SpotFleetRequestConfigSet", - "documentation":"

Information about the configuration of your Spot fleet.

", - "locationName":"spotFleetRequestConfigSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume (gp2 | standard | io1).

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m1.small).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot instance request ID.

  • spot-price - The maximum hourly price for any Spot instance launched to fulfill the request.

  • state - The state of the Spot instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

  • status-code - The short code describing the most recent evaluation of your Spot instance request.

  • status-message - The message explaining the status of the Spot instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - } - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - } - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - } - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - } - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - } - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "documentation":"

Information about the volumes.

", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - } - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - } - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpcEndpointServicesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribeVpcEndpointServicesResult":{ - "type":"structure", - "members":{ - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

A list of supported AWS services.

", - "locationName":"serviceNameSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcEndpointsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the AWS service.

  • vpc-id: The ID of the VPC in which the endpoint resides.

  • vpc-endpoint-id: The ID of the endpoint.

  • vpc-endpoint-state: The state of the endpoint. (pending | available | deleting | deleted)

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribeVpcEndpointsResult":{ - "type":"structure", - "members":{ - "VpcEndpoints":{ - "shape":"VpcEndpointSet", - "documentation":"

Information about the endpoints.

", - "locationName":"vpcEndpointSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - } - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - } - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - } - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - } - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway.

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - } - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - } - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - } - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - } - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - } - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - } - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - } - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

Information about the disk image.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the disk image.

" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

Information about the volume.

" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

", - "locationName":"importManifestUrl" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - }, - "documentation":"

Describes a disk image volume.

" - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-1024 for standard volumes, 1-16384 for gp2 volumes, and 4-16384 for io1 volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, and standard for Magnetic volumes.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - } - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - } - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - } - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "EventInformation":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This information is available only for instanceChange events.

", - "locationName":"instanceId" - }, - "EventSubType":{ - "shape":"String", - "documentation":"

The event.

The following are the error events.

  • iamFleetRoleInvalid - Spot fleet did not have the required permissions either to launch or terminate an instance.

  • spotFleetRequestConfigurationInvalid - The configuration is not valid. For more information, see the description.

  • spotInstanceCountLimitExceeded - You've reached the limit on the number of Spot instances that you can launch.

The following are the fleetRequestChange events.

  • active - The Spot fleet has been validated and Amazon EC2 is attempting to maintain the target number of running Spot instances.

  • cancelled - The Spot fleet is canceled and has no running Spot instances. The Spot fleet will be deleted two days after its instances were terminated.

  • cancelled_running - The Spot fleet is canceled and will not launch additional Spot instances, but its existing Spot instances continue to run until they are interrupted or terminated.

  • cancelled_terminating - The Spot fleet is canceled and its Spot instances are terminating.

  • expired - The Spot fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration set.

  • price_update - The bid price for a launch configuration was adjusted because it was too high. This change is permanent.

  • submitted - The Spot fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot instances.

The following are the instanceChange events.

  • launched - A bid was fulfilled and a new instance was launched.

  • terminated - An instance was terminated by the user.

", - "locationName":"eventSubType" - }, - "EventDescription":{ - "shape":"String", - "documentation":"

The description of the event.

", - "locationName":"eventDescription" - } - }, - "documentation":"

Describes a Spot fleet event.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "instanceChange", - "fleetRequestChange", - "error" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the export task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

Information about the instance to export.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "documentation":"

Information about the export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The encryption key for your S3 bucket.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the format and location for an instance export task.

" - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "Float":{"type":"float"}, - "FlowLog":{ - "type":"structure", - "members":{ - "CreationTime":{ - "shape":"DateTime", - "documentation":"

The date and time the flow log was created.

", - "locationName":"creationTime" - }, - "FlowLogId":{ - "shape":"String", - "documentation":"

The flow log ID.

", - "locationName":"flowLogId" - }, - "FlowLogStatus":{ - "shape":"String", - "documentation":"

The status of the flow log (ACTIVE).

", - "locationName":"flowLogStatus" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource on which the flow log was created.

", - "locationName":"resourceId" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic captured for the flow log.

", - "locationName":"trafficType" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the flow log group.

", - "locationName":"logGroupName" - }, - "DeliverLogsStatus":{ - "shape":"String", - "documentation":"

The status of the logs delivery (SUCCESS | FAILED).

", - "locationName":"deliverLogsStatus" - }, - "DeliverLogsErrorMessage":{ - "shape":"String", - "documentation":"

Information about the error that occurred. Rate limited indicates that CloudWatch logs throttling has been applied for one or more network interfaces. Access error indicates that the IAM role associated with the flow log does not have sufficient permissions to publish to CloudWatch Logs. Unknown error indicates an internal error.

", - "locationName":"deliverLogsErrorMessage" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that posts logs to CloudWatch Logs.

", - "locationName":"deliverLogsPermissionArn" - } - }, - "documentation":"

Describes a flow log.

" - }, - "FlowLogSet":{ - "type":"list", - "member":{ - "shape":"FlowLog", - "locationName":"item" - } - }, - "FlowLogsResourceType":{ - "type":"string", - "enum":[ - "VPC", - "Subnet", - "NetworkInterface" - ] - }, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64 encoded.

", - "locationName":"output" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - } - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - } - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HistoryRecord":{ - "type":"structure", - "required":[ - "Timestamp", - "EventType", - "EventInformation" - ], - "members":{ - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

  • error - Indicates an error with the Spot fleet request.

  • fleetRequestChange - Indicates a change in the status or configuration of the Spot fleet request.

  • instanceChange - Indicates that an instance was launched or terminated.

", - "locationName":"eventType" - }, - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - } - }, - "documentation":"

Describes an event in the history of the Spot fleet request.

" - }, - "HistoryRecords":{ - "type":"list", - "member":{ - "shape":"HistoryRecord", - "locationName":"item" - } - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the disk.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to be used for importing the snapshot.

" - } - }, - "documentation":"

Describes the disk container object for an import image task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task.

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "documentation":"

Information about the disk containers.

", - "locationName":"DiskContainer" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing.

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see VM Import/Export Prerequisites in the Amazon Elastic Compute Cloud User Guide.

Valid values: AWS | BYOL

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform.

Valid values: xen

" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

Valid values: Windows | Linux

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - } - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) created by the import task.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - } - } - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor for the import task.

Valid values: xen

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the import image task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the import image task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import image task.

", - "locationName":"status" - } - }, - "documentation":"

Describes an import image task.

" - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

The Base64-encoded MIME user data to be made available to the instance.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information about the instance types that you can import, see Before You Get Started in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] An available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes the launch specification for VM import.

" - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

The launch specification.

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "documentation":"

The disk image.

", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - } - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - } - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "documentation":"

One or more volumes.

", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import instance task.

" - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. You must base64 encode the public key material before sending it to AWS.

", - "locationName":"publicKeyMaterial" - } - } - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - } - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description string for the import snapshot task.

" - }, - "DiskContainer":{ - "shape":"SnapshotDiskContainer", - "documentation":"

Information about the disk container.

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - } - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Information about the import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - } - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Describes an import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import snapshot task.

" - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

The disk image.

", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the volume.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

The volume size.

", - "locationName":"volume" - } - } - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - } - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The Base64-encoded MIME user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance to export.

" - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":["spot"] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Any scheduled events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The event code.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes a scheduled event for an instance.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "cg1.4xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The protocol.

When you call DescribeSecurityGroups, the protocol value returned is the number. Exception: For TCP, UDP, and ICMP, the value returned is the name (for example, tcp, udp, or icmp). For a list of protocol numbers, see Protocol Numbers. (VPC only) When you call AuthorizeSecurityGroupIngress, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdList", - "documentation":"

(Valid for AuthorizeSecurityGroupEgress, RevokeSecurityGroupEgress and DescribeSecurityGroups only) One or more prefix list IDs for an AWS service. In an AuthorizeSecurityGroupEgress request, this is the AWS service that you want to access through a VPC endpoint from instances associated with the security group.

", - "locationName":"prefixListIds" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. To request an instance in a nondefault VPC, you must specify the ID of the security group. To request an instance in EC2-Classic or a default VPC, you can specify the name or the ID of the security group.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "LaunchSpecsList":{ - "type":"list", - "member":{ - "shape":"SpotFleetLaunchSpecification", - "locationName":"item" - }, - "min":1 - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - } - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or instanceInitiatedShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. You cannot use this paramater for Spot Instances.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking for the instance.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - } - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - } - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - } - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

Only volume creation permissions may be modified at the customer level.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - } - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - } - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - } - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You can only enable DNS hostnames if you also enable DNS support.

" - } - } - }, - "ModifyVpcEndpointRequest":{ - "type":"structure", - "required":["VpcEndpointId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ResetPolicy":{ - "shape":"Boolean", - "documentation":"

Specify true to reset the policy document to the default policy. The default policy allows access to the service.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy document to attach to the endpoint. The policy must be in valid JSON format.

" - }, - "AddRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables IDs to associate with the endpoint.

", - "locationName":"AddRouteTableId" - }, - "RemoveRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs to disassociate from the endpoint.

", - "locationName":"RemoveRouteTableId" - } - } - }, - "ModifyVpcEndpointResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "MoveAddressToVpcRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - } - }, - "MoveAddressToVpcResult":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID for the Elastic IP address.

", - "locationName":"allocationId" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the move of the IP address.

", - "locationName":"status" - } - } - }, - "MoveStatus":{ - "type":"string", - "enum":[ - "movingToVpc", - "restoringToClassic" - ] - }, - "MovingAddressStatus":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "MoveStatus":{ - "shape":"MoveStatus", - "documentation":"

The status of the Elastic IP address that's being moved to the EC2-VPC platform, or restored to the EC2-Classic platform.

", - "locationName":"moveStatus" - } - }, - "documentation":"

Describes the status of a moving Elastic IP address.

" - }, - "MovingAddressStatusSet":{ - "type":"list", - "member":{ - "shape":"MovingAddressStatus", - "locationName":"item" - } - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OperationType":{ - "type":"string", - "enum":[ - "add", - "remove" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

", - "locationName":"tenancy" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PrefixList":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - }, - "PrefixListName":{ - "shape":"String", - "documentation":"

The name of the prefix.

", - "locationName":"prefixListName" - }, - "Cidrs":{ - "shape":"ValueStringList", - "documentation":"

The IP address range of the AWS service.

", - "locationName":"cidrSet" - } - }, - "documentation":"

Describes prefixes for AWS services.

" - }, - "PrefixListId":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - } - }, - "documentation":"

The ID of the prefix.

" - }, - "PrefixListIdList":{ - "type":"list", - "member":{ - "shape":"PrefixListId", - "locationName":"item" - } - }, - "PrefixListSet":{ - "type":"list", - "member":{ - "shape":"PrefixList", - "locationName":"item" - } - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of instances available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - } - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - } - } - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - } - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - } - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - } - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - } - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - } - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - } - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - } - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - } - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestSpotFleetRequest":{ - "type":"structure", - "required":["SpotFleetRequestConfig"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration for the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "RequestSpotFleetResponse":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - }, - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - } - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the reserved instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - } - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

", - "locationName":"attribute" - } - } - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - } - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.

" - } - } - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RestoreAddressToClassicRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - } - }, - "RestoreAddressToClassicResult":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

The move status for the IP address.

", - "locationName":"status" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - } - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - } - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a security group in a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The AWS account ID of the source security group. For EC2-VPC, the source security group must be in the same VPC. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - } - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationPrefixListId":{ - "shape":"String", - "documentation":"

The prefix of the AWS service.

", - "locationName":"destinationPrefixListId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable indicates that route was automatically created when the route table was created.
  • CreateRoute indicates that the route was manually added to the route table.
  • EnableVgwRoutePropagation indicates that the route was propagated by route propagation.
", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet. A subnet ID is not returned for an implicit association.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instances.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - } - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the Base64 encoded JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume that was used to create the snapshot.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"statusMessage" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or AWS account ID that owns the snapshot.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - }, - "DataEncryptionKeyId":{ - "shape":"String", - "documentation":"

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"dataEncryptionKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "locationName":"userBucket" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - } - }, - "documentation":"

Describes the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{"shape":"UserBucket"} - }, - "documentation":"

The disk container object for the import snapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the import snapshot task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the import snapshot task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import snapshot task.

", - "locationName":"status" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot instance.

" - }, - "SpotFleetLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. To request an instance in a nondefault VPC, you must specify the ID of the security group. To request an instance in EC2-Classic or a default VPC, you can specify the name or the ID of the security group.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "Monitoring":{ - "shape":"SpotFleetMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

", - "locationName":"weightedCapacity" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour for the specified instance type. If this value is not specified, the default is the Spot bid price specified for the fleet. To determine the bid price per unit hour, divide the Spot bid price by the value of WeightedCapacity.

", - "locationName":"spotPrice" - } - }, - "documentation":"

Describes the launch specification for one or more Spot instances.

" - }, - "SpotFleetMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Enables monitoring for the instance.

Default: false

", - "locationName":"enabled" - } - }, - "documentation":"

Describes whether monitoring is enabled.

" - }, - "SpotFleetRequestConfig":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "SpotFleetRequestState", - "SpotFleetRequestConfig" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "SpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The state of the Spot fleet request.

", - "locationName":"spotFleetRequestState" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

Information about the configuration of the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Describes a Spot fleet request.

" - }, - "SpotFleetRequestConfigData":{ - "type":"structure", - "required":[ - "SpotPrice", - "TargetCapacity", - "IamFleetRole", - "LaunchSpecifications" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour.

", - "locationName":"spotPrice" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O.

", - "locationName":"targetCapacity" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot instance requests are placed or enabled to fulfill the request.

", - "locationName":"validUntil" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running Spot instances should be terminated when the Spot fleet request expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "IamFleetRole":{ - "shape":"String", - "documentation":"

Grants the Spot fleet permission to terminate Spot instances on your behalf when you cancel its Spot fleet request using CancelSpotFleetRequests or when the Spot fleet request expires, if you set terminateInstancesWithExpiration.

", - "locationName":"iamFleetRole" - }, - "LaunchSpecifications":{ - "shape":"LaunchSpecsList", - "documentation":"

Information about the launch specifications for the Spot fleet request.

", - "locationName":"launchSpecifications" - }, - "AllocationStrategy":{ - "shape":"AllocationStrategy", - "documentation":"

Determines how to allocate the target capacity across the Spot pools specified by the Spot fleet request. The default is lowestPrice.

", - "locationName":"allocationStrategy" - } - }, - "documentation":"

Describes the configuration of a Spot fleet request.

" - }, - "SpotFleetRequestConfigSet":{ - "type":"list", - "member":{ - "shape":"SpotFleetRequestConfig", - "locationName":"item" - } - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot instance request. Spot bid status information can help you track your Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot instance requests, all Spot instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when the Spot instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot instance.

", - "locationName":"productDescription" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describe a Spot instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The date and time of the most recent status update, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - } - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - } - }, - "State":{ - "type":"string", - "enum":[ - "Pending", - "Available", - "Deleting", - "Deleted" - ] - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot Instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The volume limit was exceeded.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "Status":{ - "type":"string", - "enum":[ - "MoveInProgress", - "InVpc", - "InClassic" - ] - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data", - "initializing" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - } - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - } - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable", - "initializing" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - } - }, - "TrafficType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT", - "ALL" - ] - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - } - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - } - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - } - }, - "UnsuccessfulItem":{ - "type":"structure", - "required":["Error"], - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource.

", - "locationName":"resourceId" - }, - "Error":{ - "shape":"UnsuccessfulItemError", - "documentation":"

Information about the error.

", - "locationName":"error" - } - }, - "documentation":"

Information about items that were not successfully processed in a batch call.

" - }, - "UnsuccessfulItemError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message accompanying the error code.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error that occurred. For more information about errors, see Error Codes.

" - }, - "UnsuccessfulItemSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The key for the disk image.

" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The key from which the disk image was created.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instance.

", - "locationName":"data" - } - }, - "documentation":"

Describes the user data to be made available to an instance.

" - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. EC2-Classic only.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use GroupId.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "documentation":"

Information about the volume attachments.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100 to 20000 for Provisioned IOPS (SSD) volumes and 3 to 10000 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcEndpoint":{ - "type":"structure", - "members":{ - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the endpoint is associated.

", - "locationName":"vpcId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the AWS service to which the endpoint is associated.

", - "locationName":"serviceName" - }, - "State":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"state" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

The policy document associated with the endpoint.

", - "locationName":"policyDocument" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables associated with the endpoint.

", - "locationName":"routeTableIdSet" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint.

" - }, - "VpcEndpointSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpoint", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the peer VPC.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

The information of the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"VpcPeeringConnectionStateReasonCode", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionStateReasonCode":{ - "type":"string", - "enum":[ - "initiating-request", - "pending-acceptance", - "active", - "deleted", - "rejected", - "failed", - "expired", - "provisioning", - "deleting" - ] - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - } - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/waiters-2.json deleted file mode 100644 index 5a6dbbc9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-04-15/waiters-2.json +++ /dev/null @@ -1,458 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeInstances", - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidInstanceIDNotFound", - "state": "retry" - } - ] - }, - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "matcher": "error", - "expected": "InvalidVolumeNotFound", - "state": "success" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/paginators-1.json deleted file mode 100644 index 2bd01ad5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/paginators-1.json +++ /dev/null @@ -1,63 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - }, - "DescribeSpotFleetRequests": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotFleetRequestConfigs" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeVolumes": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Volumes" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/service-2.json deleted file mode 100644 index 7a086d3b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/service-2.json +++ /dev/null @@ -1,17075 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-10-01", - "endpointPrefix":"ec2", - "protocol":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2015-10-01" - }, - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AllocateHosts":{ - "name":"AllocateHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateHostsRequest"}, - "output":{"shape":"AllocateHostsResult"}, - "documentation":"

Allocates a Dedicated host to your account. At minimum you need to specify the instance size type, Availability Zone, and quantity of hosts you want to allocate.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.

  • AWS Marketplace product codes are copied from the volume to the instance.

  • You must be subscribed to the product.

  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

You can have up to 50 rules per security group (covering both ingress and egress rules).

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotFleetRequests":{ - "name":"CancelSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotFleetRequestsRequest"}, - "output":{"shape":"CancelSpotFleetRequestsResponse"}, - "documentation":"

Cancels the specified Spot fleet requests.

After you cancel a Spot fleet request, the Spot fleet launches no new Spot instances. You must specify whether the Spot fleet should also terminate its Spot instances. If you terminate the instances, the Spot fleet request enters the cancelled_terminating state. Otherwise, the Spot fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot instance requests. Spot instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

Canceling a Spot instance request does not terminate running Spot instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless the Encrypted flag is specified during the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a non-default CMK with the KmsKeyId parameter.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and may be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.

  • domain-name - If you're using AmazonProvidedDNS in \"us-east-1\", specify \"ec2.internal\". If you're using AmazonProvidedDNS in another region, specify \"region.compute.internal\" (for example, \"ap-northeast-1.compute.internal\"). Otherwise, specify a domain name (for example, \"MyCompany.com\"). Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateFlowLogs":{ - "name":"CreateFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFlowLogsRequest"}, - "output":{"shape":"CreateFlowLogsResult"}, - "documentation":"

Creates one or more flow logs to capture IP traffic for a specific network interface, subnet, or VPC. Flow logs are delivered to a specified log group in Amazon CloudWatch Logs. If you specify a VPC or subnet in the request, a log stream is created in CloudWatch Logs for each network interface in the subnet or VPC. Log streams can include information about accepted and rejected traffic to a network interface. You can view the data in your log streams using Amazon CloudWatch Logs.

In your request, you must also specify an IAM role that has permission to publish logs to CloudWatch Logs.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting EC2 Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{"shape":"KeyPair"}, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateNatGateway":{ - "name":"CreateNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNatGatewayRequest"}, - "output":{"shape":"CreateNatGatewayResult"}, - "documentation":"

Creates a NAT gateway in the specified subnet. A NAT gateway can be used to enable instances in a private subnet to connect to the Internet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "output":{"shape":"CreateRouteResult"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 500 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{"shape":"Snapshot"}, - "documentation":"

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot instances, enabling you to view Spot instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported Resource-Level Permissions for Amazon EC2 API Actions in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{"shape":"Volume"}, - "documentation":"

Creates an EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

You can specify the instance tenancy value for the VPC when you create it. You can't change this value for the VPC after you create it. For more information, see Dedicated Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcEndpoint":{ - "name":"CreateVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointRequest"}, - "output":{"shape":"CreateVpcEndpointResult"}, - "documentation":"

Creates a VPC endpoint for a specified AWS service. An endpoint enables you to create a private connection between your VPC and another AWS service in your account. You can specify an endpoint policy to attach to the endpoint that will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.

Currently, only endpoints to Amazon S3 are supported.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteFlowLogs":{ - "name":"DeleteFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFlowLogsRequest"}, - "output":{"shape":"DeleteFlowLogsResult"}, - "documentation":"

Deletes one or more flow logs.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNatGateway":{ - "name":"DeleteNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNatGatewayRequest"}, - "output":{"shape":"DeleteNatGatewayResult"}, - "documentation":"

Deletes the specified NAT gateway. Deleting a NAT gateway disassociates its Elastic IP address, but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway routes in your route tables.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot instances.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcEndpoints":{ - "name":"DeleteVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointsRequest"}, - "output":{"shape":"DeleteVpcEndpointsResult"}, - "documentation":"

Deletes one or more specified VPC endpoints. Deleting the endpoint also deletes the endpoint routes in the route tables that were associated with the endpoint.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeFlowLogs":{ - "name":"DescribeFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFlowLogsRequest"}, - "output":{"shape":"DescribeFlowLogsResult"}, - "documentation":"

Describes one or more flow logs. To view the information in your flow logs (the log streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs API.

" - }, - "DescribeHosts":{ - "name":"DescribeHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostsRequest"}, - "output":{"shape":"DescribeHostsResult"}, - "documentation":"

Describes one or more of your Dedicated hosts.

The results describe only the Dedicated hosts in the region you're currently using. All listed instances consume capacity on your Dedicated host. Dedicated hosts that have recently been released will be listed with the state released.

" - }, - "DescribeIdFormat":{ - "name":"DescribeIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdFormatRequest"}, - "output":{"shape":"DescribeIdFormatResult"}, - "documentation":"

Describes the ID format settings for your resources on a per-region basis, for example, to view which resource types are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types.

The following resource types support longer IDs: instance | reservation | snapshot | volume.

These settings apply to the IAM user who makes the request; they do not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user, unless they explicitly override the settings by running the ModifyIdFormat command. Resources created with longer IDs are visible to all IAM users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{"shape":"ImageAttribute"}, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Describes your import snapshot tasks.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances. By default, only running instances are described, unless specified otherwise.

Instance status includes the following components:

  • Status checks - Amazon EC2 performs status checks on running EC2 instances to identify hardware and software issues. For more information, see Status Checks for Your Instances and Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide.

  • Scheduled events - Amazon EC2 can schedule events (such as reboot, stop, or terminate) for your instances related to hardware issues, software updates, or system maintenance. For more information, see Scheduled Events for Your Instances in the Amazon Elastic Compute Cloud User Guide.

  • Instance state - You can manage your instances from the moment you launch them through their termination. For more information, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeMovingAddresses":{ - "name":"DescribeMovingAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMovingAddressesRequest"}, - "output":{"shape":"DescribeMovingAddressesResult"}, - "documentation":"

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

" - }, - "DescribeNatGateways":{ - "name":"DescribeNatGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNatGatewaysRequest"}, - "output":{"shape":"DescribeNatGatewaysResult"}, - "documentation":"

Describes one or more of the your NAT gateways.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribePrefixLists":{ - "name":"DescribePrefixLists", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrefixListsRequest"}, - "output":{"shape":"DescribePrefixListsResult"}, - "documentation":"

Describes available AWS services in a prefix list format, which includes the prefix list name and prefix list ID of the service and the IP address range for the service. A prefix list ID is required for creating an outbound security group rule that allows traffic from a VPC to access an AWS service through a VPC endpoint.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

If you have listed your own Reserved Instances for sale in the Reserved Instance Marketplace, they will be excluded from these results. This is to ensure that you do not purchase your own Reserved Instances.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeScheduledInstanceAvailability":{ - "name":"DescribeScheduledInstanceAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstanceAvailabilityRequest"}, - "output":{"shape":"DescribeScheduledInstanceAvailabilityResult"}, - "documentation":"

Finds available schedules that meet the specified criteria.

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

After you find a schedule that meets your needs, call PurchaseScheduledInstances to purchase Scheduled Instances with that schedule.

" - }, - "DescribeScheduledInstances":{ - "name":"DescribeScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstancesRequest"}, - "output":{"shape":"DescribeScheduledInstancesResult"}, - "documentation":"

Describes one or more of your Scheduled Instances.

" - }, - "DescribeSecurityGroupReferences":{ - "name":"DescribeSecurityGroupReferences", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupReferencesRequest"}, - "output":{"shape":"DescribeSecurityGroupReferencesResult"}, - "documentation":"

[EC2-VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.

  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.

  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotFleetInstances":{ - "name":"DescribeSpotFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetInstancesRequest"}, - "output":{"shape":"DescribeSpotFleetInstancesResponse"}, - "documentation":"

Describes the running instances for the specified Spot fleet.

" - }, - "DescribeSpotFleetRequestHistory":{ - "name":"DescribeSpotFleetRequestHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestHistoryRequest"}, - "output":{"shape":"DescribeSpotFleetRequestHistoryResponse"}, - "documentation":"

Describes the events for the specified Spot fleet request during the specified time.

Spot fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event.

" - }, - "DescribeSpotFleetRequests":{ - "name":"DescribeSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestsRequest"}, - "output":{"shape":"DescribeSpotFleetRequestsResponse"}, - "documentation":"

Describes your Spot fleet requests.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot instance requests that belong to your account. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

You can use DescribeSpotInstanceRequests to find a running Spot instance by examining the response. If the status of the Spot instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeStaleSecurityGroups":{ - "name":"DescribeStaleSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStaleSecurityGroupsRequest"}, - "output":{"shape":"DescribeStaleSecurityGroupsResult"}, - "documentation":"

[EC2-VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcClassicLinkDnsSupport":{ - "name":"DescribeVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DescribeVpcClassicLinkDnsSupportResult"}, - "documentation":"

Describes the ClassicLink DNS support status of one or more VPCs. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcEndpointServices":{ - "name":"DescribeVpcEndpointServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicesRequest"}, - "output":{"shape":"DescribeVpcEndpointServicesResult"}, - "documentation":"

Describes all supported AWS services that can be specified when creating a VPC endpoint.

" - }, - "DescribeVpcEndpoints":{ - "name":"DescribeVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointsRequest"}, - "output":{"shape":"DescribeVpcEndpointsResult"}, - "documentation":"

Describes one or more of your VPC endpoints.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so results in the volume being stuck in a busy state while detaching.

If an Amazon EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisableVpcClassicLinkDnsSupport":{ - "name":"DisableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DisableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Disables ClassicLink DNS support for a VPC. If disabled, DNS hostnames resolve to public IP addresses when addressed between a linked EC2-Classic instance and instances in the VPC to which it's linked. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "EnableVpcClassicLinkDnsSupport":{ - "name":"EnableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"EnableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Enables a VPC to support DNS hostname resolution for ClassicLink. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetConsoleScreenshot":{ - "name":"GetConsoleScreenshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleScreenshotRequest"}, - "output":{"shape":"GetConsoleScreenshotResult"}, - "documentation":"

Retrieve a JPG-format screenshot of a running instance to help with troubleshooting.

The returned content is base64-encoded.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI).

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. After importing the image, you then upload it using the ec2-import-volume command in the EC2 command line tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Imports a disk into an EBS snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-import-volume command in the Amazon EC2 command-line interface (CLI) tools. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ModifyHosts":{ - "name":"ModifyHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHostsRequest"}, - "output":{"shape":"ModifyHostsResult"}, - "documentation":"

Modify the auto-placement setting of a Dedicated host. When auto-placement is enabled, AWS will place instances that you launch with a tenancy of host, but without targeting a specific host ID, onto any available Dedicated host in your account which has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID if you want the instance to launch onto a specific host. If no host ID is provided, the instance will be launched onto a suitable host which has auto-placement enabled.

" - }, - "ModifyIdFormat":{ - "name":"ModifyIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdFormatRequest"}, - "documentation":"

Modifies the ID format for the specified resource on a per-region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created. The following resource types support longer IDs: instance | reservation | snapshot | volume.

This setting applies to the IAM user who makes the request; it does not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user or as an IAM role that has permission to use this action, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Controlling Access to Longer ID Settings in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyInstancePlacement":{ - "name":"ModifyInstancePlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstancePlacementRequest"}, - "output":{"shape":"ModifyInstancePlacementResult"}, - "documentation":"

Set the instance affinity value for a specific stopped instance and modify the instance tenancy setting.

Instance affinity is disabled by default. When instance affinity is host and it is not associated with a specific Dedicated host, the next time it is launched it will automatically be associated with the host it lands on. This relationship will persist if the instance is stopped/started, or rebooted.

You can modify the host ID associated with a stopped instance. If a stopped instance has a new host ID association, the instance will target that host when restarted.

You can modify the tenancy of a stopped instance with a tenancy of host or dedicated.

Affinity, hostID, and tenancy are not required parameters, but at least one of them must be specified in the request. Affinity and tenancy can be modified in the same request, but tenancy can only be modified on instances that are stopped.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

Snapshots with AWS Marketplace product codes cannot be made public.

" - }, - "ModifySpotFleetRequest":{ - "name":"ModifySpotFleetRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySpotFleetRequestRequest"}, - "output":{"shape":"ModifySpotFleetRequestResponse"}, - "documentation":"

Modifies the specified Spot fleet request.

While the Spot fleet request is being modified, it is in the modifying state.

To scale up your Spot fleet, increase its target capacity. The Spot fleet launches the additional Spot instances according to the allocation strategy for the Spot fleet request. If the allocation strategy is lowestPrice, the Spot fleet launches instances using the Spot pool with the lowest price. If the allocation strategy is diversified, the Spot fleet distributes the instances across the Spot pools.

To scale down your Spot fleet, decrease its target capacity. First, the Spot fleet cancels any open bids that exceed the new target capacity. You can request that the Spot fleet terminate Spot instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot fleet terminates the instances with the highest price per unit. If the allocation strategy is diversified, the Spot fleet terminates instances across the Spot pools. Alternatively, you can request that the Spot fleet keep the fleet at its current size, but not replace any Spot instances that are interrupted or that you terminate manually.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "ModifyVpcEndpoint":{ - "name":"ModifyVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointRequest"}, - "output":{"shape":"ModifyVpcEndpointResult"}, - "documentation":"

Modifies attributes of a specified VPC endpoint. You can modify the policy associated with the endpoint, and you can add and remove route tables associated with the endpoint.

" - }, - "ModifyVpcPeeringConnectionOptions":{ - "name":"ModifyVpcPeeringConnectionOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcPeeringConnectionOptionsRequest"}, - "output":{"shape":"ModifyVpcPeeringConnectionOptionsResult"}, - "documentation":"

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

  • Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.

  • Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.

If the peered VPCs are in different accounts, each owner must initiate a separate request to enable or disable communication in either direction, depending on whether their VPC was the requester or accepter for the VPC peering connection. If the peered VPCs are in the same account, you can modify the requester and accepter options in the same request. To confirm which VPC is the accepter and requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MoveAddressToVpc":{ - "name":"MoveAddressToVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAddressToVpcRequest"}, - "output":{"shape":"MoveAddressToVpcResult"}, - "documentation":"

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The Elastic IP address must be allocated to your account for more than 24 hours, and it must not be associated with an instance. After the Elastic IP address is moved, it is no longer available for use in the EC2-Classic platform, unless you move it back using the RestoreAddressToClassic request. You cannot move an Elastic IP address that was originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time and pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "PurchaseScheduledInstances":{ - "name":"PurchaseScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseScheduledInstancesRequest"}, - "output":{"shape":"PurchaseScheduledInstancesResult"}, - "documentation":"

Purchases one or more Scheduled Instances with the specified schedule.

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, you must call RunScheduledInstances during each scheduled time period.

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If an instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.

Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), use the EC2 billingProduct code associated with an AMI to verify subscription status for package updates. Creating an AMI from an EBS snapshot does not maintain this billing code, and subsequent instances launched from such an AMI will not be able to connect to package update infrastructure.

Similarly, although you can create a Windows AMI from a snapshot, you can't successfully launch an instance from the AMI.

To create Windows AMIs or to create AMIs for Linux operating systems that must retain AMI billing codes to work properly, see CreateImage.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReleaseHosts":{ - "name":"ReleaseHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseHostsRequest"}, - "output":{"shape":"ReleaseHostsResult"}, - "documentation":"

When you no longer want to use a Dedicated host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated hosts that have been released can no longer be specified in another request, e.g., ModifyHosts. You must stop or terminate all instances on a host before it can be released.

When Dedicated hosts are released, it make take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated hosts. Try waiting a few minutes, and then try again.

Released hosts will still appear in a DescribeHosts response.

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotFleet":{ - "name":"RequestSpotFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotFleetRequest"}, - "output":{"shape":"RequestSpotFleetResponse"}, - "documentation":"

Creates a Spot fleet request.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot fleet requests Spot instances in the Spot pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot instances in your Spot fleet are in different Spot pools, you can improve the availability of your fleet.

For more information, see Spot Fleet Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot instance request. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot Instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the sourceDestCheck, the instance can be either running or stopped.

The sourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RestoreAddressToClassic":{ - "name":"RestoreAddressToClassic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreAddressToClassicRequest"}, - "output":{"shape":"RestoreAddressToClassicResult"}, - "documentation":"

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Removes one or more egress rules from a security group for EC2-VPC. This action doesn't apply to security groups for use in EC2-Classic. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{"shape":"Reservation"}, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

To ensure faster instance launches, break up large requests into smaller batches. For example, create five separate launch requests for 100 instances each instead of one launch request for 500 instances.

To tag your instance, ensure that it is running as CreateTags requires a resource ID. For more information about tagging, see Tagging Your Amazon EC2 Resources.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC only accounts] If you don't specify a subnet in the request, we choose a default subnet from your default VPC for you.

[EC2-Classic accounts] If you're launching into EC2-Classic and you don't specify an Availability Zone, we choose one for you.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

Some instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails. For more information, see Instance Types Available Only in a VPC.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RunScheduledInstances":{ - "name":"RunScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunScheduledInstancesRequest"}, - "output":{"shape":"RunScheduledInstancesResult"}, - "documentation":"

Launches the specified Scheduled Instances.

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, you can launch it again after a few minutes. For more information, see Scheduled Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance.

We don't charge hourly usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot instances, and you can't stop instance store-backed instances.

When you stop an instance, we shut it down. You can restart your instance at any time. Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Stopping an instance is different to rebooting or terminating it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the DeleteOnTermination block device mapping parameter set to true are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for AcceptVpcPeeringConnection.

" - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of AcceptVpcPeeringConnection.

" - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "ActiveInstance":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - } - }, - "documentation":"

Describes a running instance in a Spot fleet.

" - }, - "ActiveInstanceSet":{ - "type":"list", - "member":{ - "shape":"ActiveInstance", - "locationName":"item" - } - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "Affinity":{ - "type":"string", - "enum":[ - "default", - "host" - ] - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - }, - "documentation":"

Contains the parameters for AllocateAddress.

" - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - }, - "documentation":"

Contains the output of AllocateAddress.

" - }, - "AllocateHostsRequest":{ - "type":"structure", - "required":[ - "InstanceType", - "Quantity", - "AvailabilityZone" - ], - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated hosts, when you are launching instances without specifying a host ID.

Default: Enabled

", - "locationName":"autoPlacement" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

Specify the instance type that you want your Dedicated hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.

", - "locationName":"instanceType" - }, - "Quantity":{ - "shape":"Integer", - "documentation":"

The number of Dedicated hosts you want to allocate to your account with these parameters.

", - "locationName":"quantity" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the Dedicated hosts.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Contains the parameters for AllocateHosts.

" - }, - "AllocateHostsResult":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"ResponseHostIdList", - "documentation":"

The ID of the allocated Dedicated host. This is used when you want to launch an instance onto a specific host.

", - "locationName":"hostIdSet" - } - }, - "documentation":"

Contains the output of AllocateHosts.

" - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "AllocationState":{ - "type":"string", - "enum":[ - "available", - "under-assessment", - "permanent-failure", - "released", - "released-permanent-failure" - ] - }, - "AllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "diversified" - ] - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - }, - "documentation":"

Contains the parameters for AssignPrivateIpAddresses.

" - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] For a VPC in an EC2-Classic account, specify true to allow an Elastic IP address that is already associated with an instance or network interface to be reassociated with the specified instance or network interface. Otherwise, the operation fails. In a VPC in an EC2-VPC-only account, reassociation is automatic, therefore you can specify false to ensure the operation fails if the Elastic IP address is already associated with another resource.

", - "locationName":"allowReassociation" - } - }, - "documentation":"

Contains the parameters for AssociateAddress.

" - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateAddress.

" - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AssociateDhcpOptions.

" - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for AssociateRouteTable.

" - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateRouteTable.

" - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Contains the parameters for AttachClassicLinkVpc.

" - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of AttachClassicLinkVpc.

" - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for AttachInternetGateway.

" - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - }, - "documentation":"

Contains the parameters for AttachNetworkInterface.

" - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - }, - "documentation":"

Contains the output of AttachNetworkInterface.

" - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - }, - "documentation":"

Contains the parameters for AttachVolume.

" - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AttachVpnGateway.

" - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of AttachVpnGateway.

" - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

The value to use when a resource attribute accepts a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

Valid values are case-sensitive and vary by action.

", - "locationName":"value" - } - }, - "documentation":"

The value to use for a resource attribute.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupEgress.

" - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account number for the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupIngress.

" - }, - "AutoPlacement":{ - "type":"string", - "enum":[ - "on", - "off" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone.

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":[ - "available", - "information", - "impaired", - "unavailable" - ] - }, - "AvailableCapacity":{ - "type":"structure", - "members":{ - "AvailableInstanceCapacity":{ - "shape":"AvailableInstanceCapacityList", - "documentation":"

The total number of instances that the Dedicated host supports.

", - "locationName":"availableInstanceCapacity" - }, - "AvailableVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs available on the Dedicated host.

", - "locationName":"availableVCpus" - } - }, - "documentation":"

The capacity information for instances launched onto the Dedicated host.

" - }, - "AvailableInstanceCapacityList":{ - "type":"list", - "member":{ - "shape":"InstanceCapacity", - "locationName":"item" - } - }, - "BatchState":{ - "type":"string", - "enum":[ - "submitted", - "active", - "cancelled", - "failed", - "cancelled_running", - "cancelled_terminating", - "modifying" - ] - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - }, - "documentation":"

Contains the parameters for BundleInstance.

" - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of BundleInstance.

" - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBatchErrorCode":{ - "type":"string", - "enum":[ - "fleetRequestIdDoesNotExist", - "fleetRequestIdMalformed", - "fleetRequestNotInCancellableState", - "unexpectedError" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - }, - "documentation":"

Contains the parameters for CancelBundleTask.

" - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of CancelBundleTask.

" - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "documentation":"

The reason for canceling the conversion task.

", - "locationName":"reasonMessage" - } - }, - "documentation":"

Contains the parameters for CancelConversionTask.

" - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for CancelExportTask.

" - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image or import snapshot task to be canceled.

" - }, - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - } - }, - "documentation":"

Contains the parameters for CancelImportTask.

" - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the task being canceled.

", - "locationName":"importTaskId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"state" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"previousState" - } - }, - "documentation":"

Contains the output for CancelImportTask.

" - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - }, - "documentation":"

Contains the parameters for CancelReservedInstancesListing.

" - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CancelReservedInstancesListing.

" - }, - "CancelSpotFleetRequestsError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"CancelBatchErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot fleet error.

" - }, - "CancelSpotFleetRequestsErrorItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "Error" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "Error":{ - "shape":"CancelSpotFleetRequestsError", - "documentation":"

The error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a Spot fleet request that was not successfully canceled.

" - }, - "CancelSpotFleetRequestsErrorSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsErrorItem", - "locationName":"item" - } - }, - "CancelSpotFleetRequestsRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for a Spot fleet request if it is canceled successfully.

", - "locationName":"terminateInstances" - } - }, - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsResponse":{ - "type":"structure", - "members":{ - "UnsuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsErrorSet", - "documentation":"

Information about the Spot fleet requests that are not successfully canceled.

", - "locationName":"unsuccessfulFleetRequestSet" - }, - "SuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsSuccessSet", - "documentation":"

Information about the Spot fleet requests that are successfully canceled.

", - "locationName":"successfulFleetRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsSuccessItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "CurrentSpotFleetRequestState", - "PreviousSpotFleetRequestState" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "CurrentSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The current state of the Spot fleet request.

", - "locationName":"currentSpotFleetRequestState" - }, - "PreviousSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The previous state of the Spot fleet request.

", - "locationName":"previousSpotFleetRequestState" - } - }, - "documentation":"

Describes a Spot fleet request that was successfully canceled.

" - }, - "CancelSpotFleetRequestsSuccessSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsSuccessItem", - "locationName":"item" - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkDnsSupport":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkDnsSupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether ClassicLink DNS support is enabled for the VPC.

", - "locationName":"classicLinkDnsSupported" - } - }, - "documentation":"

Describes the ClassicLink DNS support status of a VPC.

" - }, - "ClassicLinkDnsSupportList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkDnsSupport", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClientData":{ - "type":"structure", - "members":{ - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image, in GiB.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment about the disk upload.

" - } - }, - "documentation":"

Describes the client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for ConfirmProductInstance.

" - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - }, - "Return":{ - "shape":"Boolean", - "documentation":"

The return value of the request. Returns true if the specified product code is owned by the requester and associated with the specified instance.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ConfirmProductInstance.

" - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the task.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshots of the copied image should be encrypted. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when encrypting the snapshots of an image during a copy operation. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopyImage.

" - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CopyImage.

" - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshot should be encrypted. There is no way to create an unencrypted snapshot copy from an encrypted snapshot; however, you can encrypt a copy of an unencrypted snapshot with this flag. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when creating the snapshot copy. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopySnapshot.

" - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - }, - "documentation":"

Contains the output of CopySnapshot.

" - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - }, - "documentation":"

Contains the parameters for CreateCustomerGateway.

" - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - }, - "documentation":"

Contains the output of CreateCustomerGateway.

" - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - }, - "documentation":"

Contains the parameters for CreateDhcpOptions.

" - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - }, - "documentation":"

Contains the output of CreateDhcpOptions.

" - }, - "CreateFlowLogsRequest":{ - "type":"structure", - "required":[ - "ResourceIds", - "ResourceType", - "TrafficType", - "LogGroupName", - "DeliverLogsPermissionArn" - ], - "members":{ - "ResourceIds":{ - "shape":"ValueStringList", - "documentation":"

One or more subnet, network interface, or VPC IDs.

Constraints: Maximum of 1000 resources

", - "locationName":"ResourceId" - }, - "ResourceType":{ - "shape":"FlowLogsResourceType", - "documentation":"

The type of resource on which to create the flow log.

" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic to log.

" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch log group.

" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that's used to post flow logs to a CloudWatch Logs log group.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateFlowLogs.

" - }, - "CreateFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the flow logs.

", - "locationName":"flowLogIdSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be created successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of CreateFlowLogs.

" - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, Amazon EC2 attempts to shut down and reboot the instance before creating the image. If the 'No Reboot' option is set, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Contains the parameters for CreateImage.

" - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CreateImage.

" - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "documentation":"

The format and location for an instance export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Contains the parameters for CreateInstanceExportTask.

" - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "documentation":"

Information about the instance export task.

", - "locationName":"exportTask" - } - }, - "documentation":"

Contains the output for CreateInstanceExportTask.

" - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateInternetGateway.

" - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - }, - "documentation":"

Contains the output of CreateInternetGateway.

" - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - }, - "documentation":"

Contains the parameters for CreateKeyPair.

" - }, - "CreateNatGatewayRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "AllocationId" - ], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The subnet in which to create the NAT gateway.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of an Elastic IP address to associate with the NAT gateway. If the Elastic IP address is associated with another resource, you must first disassociate it.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

Constraint: Maximum 64 ASCII characters.

" - } - }, - "documentation":"

Contains the parameters for CreateNatGateway.

" - }, - "CreateNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGateway":{ - "shape":"NatGateway", - "documentation":"

Information about the NAT gateway.

", - "locationName":"natGateway" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateNatGateway.

" - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766. The range 32767 to 65535 is reserved for internal use.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAclEntry.

" - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAcl.

" - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - }, - "documentation":"

Contains the output of CreateNetworkAcl.

" - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateNetworkInterface.

" - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - }, - "documentation":"

Contains the output of CreateNetworkInterface.

" - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - }, - "documentation":"

Contains the parameters for CreatePlacementGroup.

" - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the parameters for CreateReservedInstancesListing.

" - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CreateReservedInstancesListing.

" - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for CreateRoute.

" - }, - "CreateRouteResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of CreateRoute.

" - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateRouteTable.

" - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - }, - "documentation":"

Contains the output of CreateRouteTable.

" - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for CreateSecurityGroup.

" - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Contains the output of CreateSecurityGroup.

" - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - }, - "documentation":"

Contains the parameters for CreateSnapshot.

" - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - }, - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: AWS selects one for you. If you create more than one subnet in your VPC, we may not necessarily select a different zone for each subnet.

" - } - }, - "documentation":"

Contains the parameters for CreateSubnet.

" - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - }, - "documentation":"

Contains the output of CreateSubnet.

" - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - }, - "documentation":"

Contains the parameters for CreateTags.

" - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - }, - "documentation":"

Describes the user or group to be added or removed from the permissions for a volume.

" - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - }, - "documentation":"

Describes modifications to the permissions for a volume.

" - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-16384 for gp2, 4-16384 for io1, 500-16384 for st1, 500-16384 for sc1, and 1-1024 for standard. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS SSD volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS SSD volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. If a KmsKeyId is specified, the Encrypted flag must also be set.

" - } - }, - "documentation":"

Contains the parameters for CreateVolume.

" - }, - "CreateVpcEndpointRequest":{ - "type":"structure", - "required":[ - "VpcId", - "ServiceName" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the endpoint will be used.

" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The AWS service name, in the form com.amazonaws.region.service. To get a list of available services, use the DescribeVpcEndpointServices request.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy to attach to the endpoint that controls access to the service. The policy must be in valid JSON format. If this parameter is not specified, we attach a default policy that allows full access to the service.

" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

", - "locationName":"RouteTableId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateVpcEndpoint.

" - }, - "CreateVpcEndpointResult":{ - "type":"structure", - "members":{ - "VpcEndpoint":{ - "shape":"VpcEndpoint", - "documentation":"

Information about the endpoint.

", - "locationName":"vpcEndpoint" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateVpcEndpoint.

" - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - }, - "documentation":"

Contains the parameters for CreateVpcPeeringConnection.

" - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of CreateVpcPeeringConnection.

" - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy options for instances launched into the VPC. For default, instances are launched with shared tenancy by default. You can launch instances with any tenancy into a shared tenancy VPC. For dedicated, instances are launched as dedicated tenancy instances by default. You can only launch instances with a tenancy of dedicated or host into a dedicated tenancy VPC.

Important: The host value cannot be used with this parameter. Use the default or dedicated values only.

Default: default

", - "locationName":"instanceTenancy" - } - }, - "documentation":"

Contains the parameters for CreateVpc.

" - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - }, - "documentation":"

Contains the output of CreateVpc.

" - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnection.

" - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - }, - "documentation":"

Contains the output of CreateVpnConnection.

" - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnectionRoute.

" - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnGateway.

" - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - }, - "documentation":"

Contains the output of CreateVpnGateway.

" - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteCustomerGateway.

" - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - }, - "documentation":"

Contains the parameters for DeleteDhcpOptions.

" - }, - "DeleteFlowLogsRequest":{ - "type":"structure", - "required":["FlowLogIds"], - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - } - }, - "documentation":"

Contains the parameters for DeleteFlowLogs.

" - }, - "DeleteFlowLogsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteFlowLogs.

" - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - }, - "documentation":"

Contains the parameters for DeleteInternetGateway.

" - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - }, - "documentation":"

Contains the parameters for DeleteKeyPair.

" - }, - "DeleteNatGatewayRequest":{ - "type":"structure", - "required":["NatGatewayId"], - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteNatGateway.

" - }, - "DeleteNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the output of DeleteNatGateway.

" - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAclEntry.

" - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAcl.

" - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkInterface.

" - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - }, - "documentation":"

Contains the parameters for DeletePlacementGroup.

" - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - }, - "documentation":"

Contains the parameters for DeleteRoute.

" - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for DeleteRouteTable.

" - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteSecurityGroup.

" - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - } - }, - "documentation":"

Contains the parameters for DeleteSnapshot.

" - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - }, - "documentation":"

Contains the parameters for DeleteSubnet.

" - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - }, - "documentation":"

Contains the parameters for DeleteTags.

" - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - }, - "documentation":"

Contains the parameters for DeleteVolume.

" - }, - "DeleteVpcEndpointsRequest":{ - "type":"structure", - "required":["VpcEndpointIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcEndpoints.

" - }, - "DeleteVpcEndpointsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the endpoints that were not successfully deleted.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteVpcEndpoints.

" - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcPeeringConnection.

" - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DeleteVpcPeeringConnection.

" - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpc.

" - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnection.

" - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnectionRoute.

" - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnGateway.

" - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - }, - "documentation":"

Contains the parameters for DeregisterImage.

" - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - }, - "documentation":"

Contains the parameters for DescribeAccountAttributes.

" - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - }, - "documentation":"

Contains the output of DescribeAccountAttributes.

" - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - }, - "documentation":"

Contains the parameters for DescribeAddresses.

" - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - }, - "documentation":"

Contains the output of DescribeAddresses.

" - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | information | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeAvailabilityZones.

" - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - }, - "documentation":"

Contains the output of DescribeAvailabiltyZones.

" - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeBundleTasks.

" - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - }, - "documentation":"

Contains the output of DescribeBundleTasks.

" - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeClassicLinkInstances.

" - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeClassicLinkInstances.

" - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeConversionTasks.

" - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "documentation":"

Information about the conversion tasks.

", - "locationName":"conversionTasks" - } - }, - "documentation":"

Contains the output for DescribeConversionTasks.

" - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeCustomerGateways.

" - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeCustomerGateways.

" - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeDhcpOptions.

" - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - }, - "documentation":"

Contains the output of DescribeDhcpOptions.

" - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeExportTasks.

" - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "documentation":"

Information about the export tasks.

", - "locationName":"exportTaskSet" - } - }, - "documentation":"

Contains the output for DescribeExportTasks.

" - }, - "DescribeFlowLogsRequest":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • deliver-log-status - The status of the logs delivery (SUCCESS | FAILED).

  • flow-log-id - The ID of the flow log.

  • log-group-name - The name of the log group.

  • resource-id - The ID of the VPC, subnet, or network interface.

  • traffic-type - The type of traffic (ACCEPT | REJECT | ALL)

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the flow log IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeFlowLogs.

" - }, - "DescribeFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogs":{ - "shape":"FlowLogSet", - "documentation":"

Information about the flow logs.

", - "locationName":"flowLogSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeFlowLogs.

" - }, - "DescribeHostsRequest":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated hosts. The IDs are used for targeted instance launches.

", - "locationName":"hostId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error. You cannot specify this parameter and the host IDs parameter in the same request.

", - "locationName":"maxResults" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-type - The instance type size that the Dedicated host is configured to support.

  • auto-placement - Whether auto-placement is enabled or disabled (on | off).

  • host-reservation-id - The ID of the reservation associated with this host.

  • client-token - The idempotency token you provided when you launched the instance

  • state- The allocation state of the Dedicated host (available | under-assessment | permanent-failure | released | released-permanent-failure).

  • availability-zone - The Availability Zone of the host.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeHosts.

" - }, - "DescribeHostsResult":{ - "type":"structure", - "members":{ - "Hosts":{ - "shape":"HostList", - "documentation":"

Information about the Dedicated hosts.

", - "locationName":"hostSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeHosts.

" - }, - "DescribeIdFormatRequest":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

" - } - }, - "documentation":"

Contains the parameters for DescribeIdFormat.

" - }, - "DescribeIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resource.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdFormat.

" - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - }, - "documentation":"

Contains the parameters for DescribeImageAttribute.

" - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, amazon (owner is Amazon), aws-marketplace (owner is AWS Marketplace), self (owner is the sender of the request). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the EBS volume.

  • block-device-mapping.volume-size - The volume size of the EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the EBS volume (gp2 | io1 | st1 | sc1 | standard).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - The AWS account alias (for example, amazon).

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeImages.

" - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - }, - "documentation":"

Contains the output of DescribeImages.

" - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import image task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportImageTasks.

" - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportImageTasks.

" - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import snapshot task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportSnapshotTasks.

" - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportSnapshotTasks.

" - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceAttribute.

" - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code for the scheduled event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • event.not-before - The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • instance-state-code - The code for the instance state, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceStatus.

" - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstanceStatus.

" - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • affinity - The affinity setting for an instance running on a Dedicated host (default | host).

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • host-Id - The ID of the Dedicated host on which the instance is running, if applicable.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance or a Scheduled Instance (spot | scheduled).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default | host).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface.private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter or tag filters in the same call.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeInstances.

" - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

Zero or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstances.

" - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeInternetGateways.

" - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeInternetGateways.

" - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeKeyPairs.

" - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - }, - "documentation":"

Contains the output of DescribeKeyPairs.

" - }, - "DescribeMovingAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"ValueStringList", - "documentation":"

One or more Elastic IP addresses.

", - "locationName":"publicIp" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • moving-status - The status of the Elastic IP address (MovingToVpc | RestoringToClassic).

", - "locationName":"filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value outside of this range, an error is returned.

Default: If no value is provided, the default is 1000.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeMovingAddresses.

" - }, - "DescribeMovingAddressesResult":{ - "type":"structure", - "members":{ - "MovingAddressStatuses":{ - "shape":"MovingAddressStatusSet", - "documentation":"

The status for each Elastic IP address.

", - "locationName":"movingAddressStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeMovingAddresses.

" - }, - "DescribeNatGatewaysRequest":{ - "type":"structure", - "members":{ - "NatGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more NAT gateway IDs.

", - "locationName":"NatGatewayId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • nat-gateway-id - The ID of the NAT gateway.

  • state - The state of the NAT gateway (pending | failed | available | deleting | deleted).

  • subnet-id - The ID of the subnet in which the NAT gateway resides.

  • vpc-id - The ID of the VPC in which the NAT gateway resides.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeNatGateways.

" - }, - "DescribeNatGatewaysResult":{ - "type":"structure", - "members":{ - "NatGateways":{ - "shape":"NatGatewayList", - "documentation":"

Information about the NAT gateways.

", - "locationName":"natGatewaySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeNatGateways.

" - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkAcls.

" - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkAcls.

" - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.nat-gateway-id - The ID of the NAT gateway to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaces.

" - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaces.

" - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribePlacementGroups.

" - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - }, - "documentation":"

Contains the output of DescribePlacementGroups.

" - }, - "DescribePrefixListsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "PrefixListIds":{ - "shape":"ValueStringList", - "documentation":"

One or more prefix list IDs.

", - "locationName":"PrefixListId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribePrefixLists.

" - }, - "DescribePrefixListsResult":{ - "type":"structure", - "members":{ - "PrefixLists":{ - "shape":"PrefixListSet", - "documentation":"

All available prefix lists.

", - "locationName":"prefixListSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribePrefixLists.

" - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRegions.

" - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - }, - "documentation":"

Contains the output of DescribeRegions.

" - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type that the reservation will cover (for example, m1.small). For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from both AWS and the Reserved Instance Marketplace are listed.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC))

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated Instances).

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Reserved Instance Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstances.

" - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - }, - "documentation":"

Contains the output for DescribeReservedInstances.

" - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC (true | false).

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.destination-prefix-list-id - The ID (prefix) of the AWS service specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.nat-gateway-id - The ID of a NAT gateway.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRouteTables.

" - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - }, - "documentation":"

Contains the output of DescribeRouteTables.

" - }, - "DescribeScheduledInstanceAvailabilityRequest":{ - "type":"structure", - "required":[ - "Recurrence", - "FirstSlotStartTimeRange" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrenceRequest", - "documentation":"

The schedule recurrence.

" - }, - "FirstSlotStartTimeRange":{ - "shape":"SlotDateTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "MinSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

" - }, - "MaxSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstanceAvailabilityResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceAvailabilitySet":{ - "shape":"ScheduledInstanceAvailabilitySet", - "documentation":"

Information about the available Scheduled Instances.

", - "locationName":"scheduledInstanceAvailabilitySet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ScheduledInstanceIds":{ - "shape":"ScheduledInstanceIdRequestSet", - "documentation":"

One or more Scheduled Instance IDs.

", - "locationName":"ScheduledInstanceId" - }, - "SlotStartTimeRange":{ - "shape":"SlotStartTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 100. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstances.

" - }, - "DescribeScheduledInstancesResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceSet":{ - "shape":"ScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstances.

" - }, - "DescribeSecurityGroupReferencesRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"GroupIds", - "documentation":"

One or more security group IDs in your account.

" - } - } - }, - "DescribeSecurityGroupReferencesResult":{ - "type":"structure", - "members":{ - "SecurityGroupReferenceSet":{ - "shape":"SecurityGroupReferences", - "documentation":"

Information about the VPCs with the referencing security groups.

", - "locationName":"securityGroupReferenceSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.

  • description - The description of the security group.

  • egress.ip-permission.prefix-list-id - The ID (prefix) of the AWS service to which the security group allows access.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSecurityGroups.

" - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - }, - "documentation":"

Contains the output of DescribeSecurityGroups.

" - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - The AWS account alias (for example, amazon) that owns the snapshot.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshots.

" - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSnapshots.

" - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotFleetInstancesRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetInstancesResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "ActiveInstances" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. Note that this list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetRequestHistoryRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The type of events to describe. By default, all events are described.

", - "locationName":"eventType" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestHistoryResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime", - "LastEvaluatedTime", - "HistoryRecords" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "HistoryRecords":{ - "shape":"HistoryRecords", - "documentation":"

Information about the events in the history of the Spot fleet request.

", - "locationName":"historyRecordSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "DescribeSpotFleetRequestsResponse":{ - "type":"structure", - "required":["SpotFleetRequestConfigs"], - "members":{ - "SpotFleetRequestConfigs":{ - "shape":"SpotFleetRequestConfigSet", - "documentation":"

Information about the configuration of your Spot fleet.

", - "locationName":"spotFleetRequestConfigSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume: gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1for Cold HDD, or standard for Magnetic.

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m3.medium).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot instance request ID.

  • spot-price - The maximum hourly price for any Spot instance launched to fulfill the request.

  • state - The state of the Spot instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

  • status-code - The short code describing the most recent evaluation of your Spot instance request.

  • status-message - The message explaining the status of the Spot instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m3.medium).

  • product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "DescribeStaleSecurityGroupsRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribeStaleSecurityGroupsResult":{ - "type":"structure", - "members":{ - "StaleSecurityGroupSet":{ - "shape":"StaleSecurityGroupSet", - "documentation":"

Information about the stale security groups.

", - "locationName":"staleSecurityGroupSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSubnets.

" - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - }, - "documentation":"

Contains the output of DescribeSubnets.

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeTags.

" - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeTags.

" - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeAttribute.

" - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeVolumeAttribute.

" - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeStatus.

" - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumeStatus.

" - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeVolumes.

" - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "documentation":"

Information about the volumes.

", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumes.

" - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":[ - "VpcId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcAttribute.

" - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - }, - "documentation":"

Contains the output of DescribeVpcAttribute.

" - }, - "DescribeVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPC IDs.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"ClassicLinkDnsSupportList", - "documentation":"

Information about the ClassicLink DNS support status of the VPCs.

", - "locationName":"vpcs" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLink.

" - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLink.

" - }, - "DescribeVpcEndpointServicesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointServicesResult":{ - "type":"structure", - "members":{ - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

A list of supported AWS services.

", - "locationName":"serviceNameSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the AWS service.

  • vpc-id: The ID of the VPC in which the endpoint resides.

  • vpc-endpoint-id: The ID of the endpoint.

  • vpc-endpoint-state: The state of the endpoint. (pending | available | deleting | deleted)

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpoints.

" - }, - "DescribeVpcEndpointsResult":{ - "type":"structure", - "members":{ - "VpcEndpoints":{ - "shape":"VpcEndpointSet", - "documentation":"

Information about the endpoints.

", - "locationName":"vpcEndpointSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpoints.

" - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcPeeringConnections.

" - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpcPeeringConnections.

" - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcs.

" - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcs.

" - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnConnections.

" - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpnConnections.

" - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway (if applicable).

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnGateways.

" - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeVpnGateways.

" - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachClassicLinkVpc.

" - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DetachClassicLinkVpc.

" - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachInternetGateway.

" - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for DetachNetworkInterface.

" - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - }, - "documentation":"

Contains the parameters for DetachVolume.

" - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DetachVpnGateway.

" - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DisableVgwRoutePropagation.

" - }, - "DisableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLink.

" - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLink.

" - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for DisassociateAddress.

" - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the parameters for DisassociateRouteTable.

" - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

Information about the disk image.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the disk image.

" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

Information about the volume.

" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - }, - "documentation":"

Describes a disk image volume.

" - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type: gp2, io1, st1, sc1, or standard.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes information used to set up an EBS volume specified in a block device mapping.

" - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for EnableVgwRoutePropagation.

" - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Contains the parameters for EnableVolumeIO.

" - }, - "EnableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLink.

" - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLink.

" - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "EventInformation":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This information is available only for instanceChange events.

", - "locationName":"instanceId" - }, - "EventSubType":{ - "shape":"String", - "documentation":"

The event.

The following are the error events.

  • iamFleetRoleInvalid - The Spot fleet did not have the required permissions either to launch or terminate an instance.

  • launchSpecTemporarilyBlacklisted - The configuration is not valid and several attempts to launch instances have failed. For more information, see the description of the event.

  • spotFleetRequestConfigurationInvalid - The configuration is not valid. For more information, see the description of the event.

  • spotInstanceCountLimitExceeded - You've reached the limit on the number of Spot instances that you can launch.

The following are the fleetRequestChange events.

  • active - The Spot fleet has been validated and Amazon EC2 is attempting to maintain the target number of running Spot instances.

  • cancelled - The Spot fleet is canceled and has no running Spot instances. The Spot fleet will be deleted two days after its instances were terminated.

  • cancelled_running - The Spot fleet is canceled and will not launch additional Spot instances, but its existing Spot instances continue to run until they are interrupted or terminated.

  • cancelled_terminating - The Spot fleet is canceled and its Spot instances are terminating.

  • expired - The Spot fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration set.

  • modify_in_progress - A request to modify the Spot fleet request was accepted and is in progress.

  • modify_successful - The Spot fleet request was modified.

  • price_update - The bid price for a launch configuration was adjusted because it was too high. This change is permanent.

  • submitted - The Spot fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot instances.

The following are the instanceChange events.

  • launched - A bid was fulfilled and a new instance was launched.

  • terminated - An instance was terminated by the user.

", - "locationName":"eventSubType" - }, - "EventDescription":{ - "shape":"String", - "documentation":"

The description of the event.

", - "locationName":"eventDescription" - } - }, - "documentation":"

Describes a Spot fleet event.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "instanceChange", - "fleetRequestChange", - "error" - ] - }, - "ExcessCapacityTerminationPolicy":{ - "type":"string", - "enum":[ - "noTermination", - "default" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the export task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

Information about the instance to export.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "documentation":"

Information about the export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The encryption key for your S3 bucket.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the format and location for an instance export task.

" - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FleetType":{ - "type":"string", - "enum":[ - "request", - "maintain" - ] - }, - "Float":{"type":"float"}, - "FlowLog":{ - "type":"structure", - "members":{ - "CreationTime":{ - "shape":"DateTime", - "documentation":"

The date and time the flow log was created.

", - "locationName":"creationTime" - }, - "FlowLogId":{ - "shape":"String", - "documentation":"

The flow log ID.

", - "locationName":"flowLogId" - }, - "FlowLogStatus":{ - "shape":"String", - "documentation":"

The status of the flow log (ACTIVE).

", - "locationName":"flowLogStatus" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource on which the flow log was created.

", - "locationName":"resourceId" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic captured for the flow log.

", - "locationName":"trafficType" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the flow log group.

", - "locationName":"logGroupName" - }, - "DeliverLogsStatus":{ - "shape":"String", - "documentation":"

The status of the logs delivery (SUCCESS | FAILED).

", - "locationName":"deliverLogsStatus" - }, - "DeliverLogsErrorMessage":{ - "shape":"String", - "documentation":"

Information about the error that occurred. Rate limited indicates that CloudWatch logs throttling has been applied for one or more network interfaces, or that you've reached the limit on the number of CloudWatch Logs log groups that you can create. Access error indicates that the IAM role associated with the flow log does not have sufficient permissions to publish to CloudWatch Logs. Unknown error indicates an internal error.

", - "locationName":"deliverLogsErrorMessage" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that posts logs to CloudWatch Logs.

", - "locationName":"deliverLogsPermissionArn" - } - }, - "documentation":"

Describes a flow log.

" - }, - "FlowLogSet":{ - "type":"list", - "member":{ - "shape":"FlowLog", - "locationName":"item" - } - }, - "FlowLogsResourceType":{ - "type":"string", - "enum":[ - "VPC", - "Subnet", - "NetworkInterface" - ] - }, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for GetConsoleOutput.

" - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, base64-encoded. If using a command line tool, the tools decode the output for you.

", - "locationName":"output" - } - }, - "documentation":"

Contains the output of GetConsoleOutput.

" - }, - "GetConsoleScreenshotRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "WakeUp":{ - "shape":"Boolean", - "documentation":"

When set to true, acts as keystroke input and wakes up an instance that's in standby or \"sleep\" mode.

" - } - }, - "documentation":"

Contains the parameters for the request.

" - }, - "GetConsoleScreenshotResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageData":{ - "shape":"String", - "documentation":"

The data that comprises the image.

", - "locationName":"imageData" - } - }, - "documentation":"

Contains the output of the request.

" - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - }, - "documentation":"

Contains the parameters for GetPasswordData.

" - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - }, - "documentation":"

Contains the output of GetPasswordData.

" - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupIds":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HistoryRecord":{ - "type":"structure", - "required":[ - "Timestamp", - "EventType", - "EventInformation" - ], - "members":{ - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

  • error - Indicates an error with the Spot fleet request.

  • fleetRequestChange - Indicates a change in the status or configuration of the Spot fleet request.

  • instanceChange - Indicates that an instance was launched or terminated.

", - "locationName":"eventType" - }, - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - } - }, - "documentation":"

Describes an event in the history of the Spot fleet request.

" - }, - "HistoryRecords":{ - "type":"list", - "member":{ - "shape":"HistoryRecord", - "locationName":"item" - } - }, - "Host":{ - "type":"structure", - "members":{ - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated host.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Whether auto-placement is on or off.

", - "locationName":"autoPlacement" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The reservation ID of the Dedicated host. This returns a null response if the Dedicated host doesn't have an associated reservation.

", - "locationName":"hostReservationId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "HostProperties":{ - "shape":"HostProperties", - "documentation":"

The hardware specifications of the Dedicated host.

", - "locationName":"hostProperties" - }, - "State":{ - "shape":"AllocationState", - "documentation":"

The Dedicated host's state.

", - "locationName":"state" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the Dedicated host.

", - "locationName":"availabilityZone" - }, - "Instances":{ - "shape":"HostInstanceList", - "documentation":"

The IDs and instance type that are currently running on the Dedicated host.

", - "locationName":"instances" - }, - "AvailableCapacity":{ - "shape":"AvailableCapacity", - "documentation":"

The number of new instances that can be launched onto the Dedicated host.

", - "locationName":"availableCapacity" - } - }, - "documentation":"

Describes the properties of the Dedicated host.

" - }, - "HostInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

the IDs of instances that are running on the Dedicated host.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size (for example, m3.medium) of the running instance.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes an instance running on a Dedicated host.

" - }, - "HostInstanceList":{ - "type":"list", - "member":{ - "shape":"HostInstance", - "locationName":"item" - } - }, - "HostList":{ - "type":"list", - "member":{ - "shape":"Host", - "locationName":"item" - } - }, - "HostProperties":{ - "type":"structure", - "members":{ - "Sockets":{ - "shape":"Integer", - "documentation":"

The number of sockets on the Dedicated host.

", - "locationName":"sockets" - }, - "Cores":{ - "shape":"Integer", - "documentation":"

The number of cores on the Dedicated host.

", - "locationName":"cores" - }, - "TotalVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs on the Dedicated host.

", - "locationName":"totalVCpus" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size that the Dedicated host supports (for example, m3.medium).

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes properties of a Dedicated host.

" - }, - "HostTenancy":{ - "type":"string", - "enum":[ - "dedicated", - "host" - ] - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "IdFormat":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether longer IDs (17-character IDs) are enabled for the resource.

", - "locationName":"useLongIds" - }, - "Deadline":{ - "shape":"DateTime", - "documentation":"

The date in UTC at which you are permanently switched over to using longer IDs. If a deadline is not yet available for this resource type, this field is not returned.

", - "locationName":"deadline" - } - }, - "documentation":"

Describes the ID format for a resource.

" - }, - "IdFormatList":{ - "type":"list", - "member":{ - "shape":"IdFormat", - "locationName":"item" - } - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the disk.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to be used for importing the snapshot.

" - } - }, - "documentation":"

Describes the disk container object for an import image task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task.

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "documentation":"

Information about the disk containers.

", - "locationName":"DiskContainer" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing.

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see VM Import/Export Prerequisites in the Amazon Elastic Compute Cloud User Guide.

Valid values: AWS | BYOL

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform.

Valid values: xen

" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

Valid values: Windows | Linux

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportImage.

" - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) created by the import task.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output for ImportImage.

" - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor for the import task.

Valid values: xen

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the import image task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the import image task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import image task.

", - "locationName":"status" - } - }, - "documentation":"

Describes an import image task.

" - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

The Base64-encoded MIME user data to be made available to the instance.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information about the instance types that you can import, see Before You Get Started in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] An available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes the launch specification for VM import.

" - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

The launch specification.

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "documentation":"

The disk image.

", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - }, - "documentation":"

Contains the parameters for ImportInstance.

" - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportInstance.

" - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "documentation":"

One or more volumes.

", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import instance task.

" - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. For API calls, the text must be base64-encoded. For command line tools, base64 encoding is performed for you.

", - "locationName":"publicKeyMaterial" - } - }, - "documentation":"

Contains the parameters for ImportKeyPair.

" - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Contains the output of ImportKeyPair.

" - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description string for the import snapshot task.

" - }, - "DiskContainer":{ - "shape":"SnapshotDiskContainer", - "documentation":"

Information about the disk container.

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportSnapshot.

" - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Information about the import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Contains the output for ImportSnapshot.

" - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Describes an import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import snapshot task.

" - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

The disk image.

", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the volume.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

The volume size.

", - "locationName":"volume" - } - }, - "documentation":"

Contains the parameters for ImportVolume.

" - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportVolume.

" - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance, if applicable.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched, if applicable.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance, if applicable.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance, if applicable.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance, if applicable.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot instance or a Scheduled Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

If the request is a Spot instance request, the ID of the request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance, if applicable.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance, if applicable.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The Base64-encoded MIME user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "locationName":"sriovNetSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCapacity":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size supported by the Dedicated host.

", - "locationName":"instanceType" - }, - "AvailableCapacity":{ - "shape":"Integer", - "documentation":"

The number of instances that can still be launched onto the Dedicated host.

", - "locationName":"availableCapacity" - }, - "TotalCapacity":{ - "shape":"Integer", - "documentation":"

The total number of instances that can be launched onto the Dedicated host.

", - "locationName":"totalCapacity" - } - }, - "documentation":"

Information about the instance type that the Dedicated host supports.

" - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance to export.

" - }, - "InstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":[ - "spot", - "scheduled" - ] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Any scheduled events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The event code.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes a scheduled event for an instance.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "t2.nano", - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "x1.4xlarge", - "x1.8xlarge", - "x1.16xlarge", - "x1.32xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "g2.8xlarge", - "cg1.4xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

[EC2-VPC only] When you authorize or revoke security group rules, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdList", - "documentation":"

(Valid for AuthorizeSecurityGroupEgress, RevokeSecurityGroupEgress and DescribeSecurityGroups only) One or more prefix list IDs for an AWS service. In an AuthorizeSecurityGroupEgress request, this is the AWS service that you want to access through a VPC endpoint from instances associated with the security group.

", - "locationName":"prefixListIds" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "IpRanges":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "LaunchSpecsList":{ - "type":"list", - "member":{ - "shape":"SpotFleetLaunchSpecification", - "locationName":"item" - }, - "min":1 - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "max":255, - "min":5 - }, - "ModifyHostsRequest":{ - "type":"structure", - "required":[ - "HostIds", - "AutoPlacement" - ], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The host IDs of the Dedicated hosts you want to modify.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Specify whether to enable or disable auto-placement.

", - "locationName":"autoPlacement" - } - }, - "documentation":"

Contains the parameters for ModifyHosts.

" - }, - "ModifyHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated hosts that were successfully modified.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated hosts that could not be modified. Check whether the setting you requested can be used.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ModifyHosts.

" - }, - "ModifyIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicate whether the resource should use longer IDs (17-character IDs).

" - } - }, - "documentation":"

Contains the parameters of ModifyIdFormat.

" - }, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - }, - "documentation":"

Contains the parameters for ModifyImageAttribute.

" - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or instanceInitiatedShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. You cannot use this paramater for Spot Instances.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified base64-encoded value. For command line tools, base64 encoding is performed for you.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking for the instance.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Contains the parameters for ModifyInstanceAttribute.

" - }, - "ModifyInstancePlacementRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that you are modifying.

", - "locationName":"instanceId" - }, - "Tenancy":{ - "shape":"HostTenancy", - "documentation":"

The tenancy of the instance that you are modifying.

", - "locationName":"tenancy" - }, - "Affinity":{ - "shape":"Affinity", - "documentation":"

The new affinity setting for the instance.

", - "locationName":"affinity" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated host that the instance will have affinity with.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ModifyInstancePlacement.

" - }, - "ModifyInstancePlacementResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyInstancePlacement.

" - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the parameters for ModifyNetworkInterfaceAttribute.

" - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - }, - "documentation":"

Contains the parameters for ModifyReservedInstances.

" - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - }, - "documentation":"

Contains the output of ModifyReservedInstances.

" - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

Only volume creation permissions may be modified at the customer level.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - }, - "documentation":"

Contains the parameters for ModifySnapshotAttribute.

" - }, - "ModifySpotFleetRequestRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The size of the fleet.

", - "locationName":"targetCapacity" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - } - }, - "documentation":"

Contains the parameters for ModifySpotFleetRequest.

" - }, - "ModifySpotFleetRequestResponse":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifySpotFleetRequest.

" - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - }, - "documentation":"

Contains the parameters for ModifySubnetAttribute.

" - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - }, - "documentation":"

Contains the parameters for ModifyVolumeAttribute.

" - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute. You can only enable DNS hostnames if you've enabled DNS support.

" - } - }, - "documentation":"

Contains the parameters for ModifyVpcAttribute.

" - }, - "ModifyVpcEndpointRequest":{ - "type":"structure", - "required":["VpcEndpointId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ResetPolicy":{ - "shape":"Boolean", - "documentation":"

Specify true to reset the policy document to the default policy. The default policy allows access to the service.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy document to attach to the endpoint. The policy must be in valid JSON format.

" - }, - "AddRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables IDs to associate with the endpoint.

", - "locationName":"AddRouteTableId" - }, - "RemoveRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs to disassociate from the endpoint.

", - "locationName":"RemoveRouteTableId" - } - }, - "documentation":"

Contains the parameters for ModifyVpcEndpoint.

" - }, - "ModifyVpcEndpointResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyVpcEndpoint.

" - }, - "ModifyVpcPeeringConnectionOptionsRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

" - }, - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the requester VPC.

" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the accepter VPC.

" - } - } - }, - "ModifyVpcPeeringConnectionOptionsResult":{ - "type":"structure", - "members":{ - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the requester VPC.

", - "locationName":"requesterPeeringConnectionOptions" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the accepter VPC.

", - "locationName":"accepterPeeringConnectionOptions" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for MonitorInstances.

" - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of MonitorInstances.

" - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "MoveAddressToVpcRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for MoveAddressToVpc.

" - }, - "MoveAddressToVpcResult":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID for the Elastic IP address.

", - "locationName":"allocationId" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the move of the IP address.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output of MoveAddressToVpc.

" - }, - "MoveStatus":{ - "type":"string", - "enum":[ - "movingToVpc", - "restoringToClassic" - ] - }, - "MovingAddressStatus":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "MoveStatus":{ - "shape":"MoveStatus", - "documentation":"

The status of the Elastic IP address that's being moved to the EC2-VPC platform, or restored to the EC2-Classic platform.

", - "locationName":"moveStatus" - } - }, - "documentation":"

Describes the status of a moving Elastic IP address.

" - }, - "MovingAddressStatusSet":{ - "type":"list", - "member":{ - "shape":"MovingAddressStatus", - "locationName":"item" - } - }, - "NatGateway":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the NAT gateway is located.

", - "locationName":"vpcId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the NAT gateway is located.

", - "locationName":"subnetId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was created.

", - "locationName":"createTime" - }, - "DeleteTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was deleted, if applicable.

", - "locationName":"deleteTime" - }, - "NatGatewayAddresses":{ - "shape":"NatGatewayAddressList", - "documentation":"

Information about the IP addresses and network interface associated with the NAT gateway.

", - "locationName":"natGatewayAddressSet" - }, - "State":{ - "shape":"NatGatewayState", - "documentation":"

The state of the NAT gateway.

  • pending: The NAT gateway is being created and is not ready to process traffic.

  • failed: The NAT gateway could not be created. Check the failureCode and failureMessage fields for the reason.

  • available: The NAT gateway is able to process traffic. This status remains until you delete the NAT gateway, and does not indicate the health of the NAT gateway.

  • deleting: The NAT gateway is in the process of being terminated and may still be processing traffic.

  • deleted: The NAT gateway has been terminated and is no longer processing traffic.

", - "locationName":"state" - }, - "FailureCode":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error code for the failure. (InsufficientFreeAddressesInSubnet | Gateway.NotAttached | InvalidAllocationID.NotFound | Resource.AlreadyAssociated | InternalError | InvalidSubnetID.NotFound)

", - "locationName":"failureCode" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error message for the failure, that corresponds to the error code.

  • For InsufficientFreeAddressesInSubnet: \"Subnet has insufficient free addresses to create this NAT gateway\"

  • For Gateway.NotAttached: \"Network vpc-xxxxxxxx has no Internet gateway attached\"

  • For InvalidAllocationID.NotFound: \"Elastic IP address eipalloc-xxxxxxxx could not be associated with this NAT gateway\"

  • For Resource.AlreadyAssociated: \"Elastic IP address eipalloc-xxxxxxxx is already associated\"

  • For InternalError: \"Network interface eni-xxxxxxxx, created and used internally by this NAT gateway is in an invalid state. Please try again.\"

  • For InvalidSubnetID.NotFound: \"The specified subnet subnet-xxxxxxxx does not exist or could not be found.\"

", - "locationName":"failureMessage" - }, - "ProvisionedBandwidth":{ - "shape":"ProvisionedBandwidth", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionedBandwidth" - } - }, - "documentation":"

Describes a NAT gateway.

" - }, - "NatGatewayAddress":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address associated with the NAT gateway.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of the Elastic IP address that's associated with the NAT gateway.

", - "locationName":"allocationId" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIp" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface associated with the NAT gateway.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Describes the IP addresses and network interface associated with a NAT gateway.

" - }, - "NatGatewayAddressList":{ - "type":"list", - "member":{ - "shape":"NatGatewayAddress", - "locationName":"item" - } - }, - "NatGatewayList":{ - "type":"list", - "member":{ - "shape":"NatGateway", - "locationName":"item" - } - }, - "NatGatewayState":{ - "type":"string", - "enum":[ - "pending", - "failed", - "available", - "deleting", - "deleted" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - }, - "InterfaceType":{ - "shape":"NetworkInterfaceType", - "documentation":"

The type of interface.

", - "locationName":"interfaceType" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "NetworkInterfaceType":{ - "type":"string", - "enum":[ - "interface", - "natGateway" - ] - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "OccurrenceDayRequestSet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"OccurenceDay" - } - }, - "OccurrenceDaySet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"item" - } - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OperationType":{ - "type":"string", - "enum":[ - "add", - "remove" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PeeringConnectionOptions":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "PeeringConnectionOptionsRequest":{ - "type":"structure", - "required":[ - "AllowEgressFromLocalClassicLinkToRemoteVpc", - "AllowEgressFromLocalVpcToRemoteClassicLink" - ], - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

" - } - }, - "documentation":"

The VPC peering connection options.

" - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. The host tenancy is not supported for the ImportInstance command.

", - "locationName":"tenancy" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicted host on which the instance resides. This parameter is not support for the ImportInstance command.

", - "locationName":"hostId" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for the instance on the Dedicated host. This parameter is not supported for the ImportInstance command.

", - "locationName":"affinity" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PrefixList":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - }, - "PrefixListName":{ - "shape":"String", - "documentation":"

The name of the prefix.

", - "locationName":"prefixListName" - }, - "Cidrs":{ - "shape":"ValueStringList", - "documentation":"

The IP address range of the AWS service.

", - "locationName":"cidrSet" - } - }, - "documentation":"

Describes prefixes for AWS services.

" - }, - "PrefixListId":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - } - }, - "documentation":"

The ID of the prefix.

" - }, - "PrefixListIdList":{ - "type":"list", - "member":{ - "shape":"PrefixListId", - "locationName":"item" - } - }, - "PrefixListIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "PrefixListSet":{ - "type":"list", - "member":{ - "shape":"PrefixList", - "locationName":"item" - } - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of reservations available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressConfigSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesPrivateIpAddressConfig", - "locationName":"PrivateIpAddressConfigSet" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "ProvisionedBandwidth":{ - "type":"structure", - "members":{ - "Provisioned":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisioned" - }, - "Requested":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requested" - }, - "RequestTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requestTime" - }, - "ProvisionTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionTime" - }, - "Status":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"status" - } - }, - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

" - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "PurchaseRequest":{ - "type":"structure", - "required":[ - "PurchaseToken", - "InstanceCount" - ], - "members":{ - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

" - } - }, - "documentation":"

Describes a request to purchase Scheduled Instances.

" - }, - "PurchaseRequestSet":{ - "type":"list", - "member":{ - "shape":"PurchaseRequest", - "locationName":"PurchaseRequest" - }, - "min":1 - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - }, - "documentation":"

Contains the parameters for PurchaseReservedInstancesOffering.

" - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Contains the output of PurchaseReservedInstancesOffering.

" - }, - "PurchaseScheduledInstancesRequest":{ - "type":"structure", - "required":["PurchaseRequests"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "PurchaseRequests":{ - "shape":"PurchaseRequestSet", - "documentation":"

One or more purchase requests.

", - "locationName":"PurchaseRequest" - } - }, - "documentation":"

Contains the parameters for PurchaseScheduledInstances.

" - }, - "PurchaseScheduledInstancesResult":{ - "type":"structure", - "members":{ - "ScheduledInstanceSet":{ - "shape":"PurchasedScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of PurchaseScheduledInstances.

" - }, - "PurchasedScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for RebootInstances.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

There is no way to disable enhanced networking at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Contains the parameters for RegisterImage.

" - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of RegisterImage.

" - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for RejectVpcPeeringConnection.

" - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of RejectVpcPeeringConnection.

" - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for ReleaseAddress.

" - }, - "ReleaseHostsRequest":{ - "type":"structure", - "required":["HostIds"], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated hosts you want to release.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ReleaseHosts.

" - }, - "ReleaseHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated hosts that were successfully released.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated hosts that could not be released, including an error message.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ReleaseHosts.

" - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclEntry.

" - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for ReplaceRoute.

" - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for ReplaceRouteTableAssociation.

" - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceRouteTableAssociation.

" - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - }, - "documentation":"

Contains the parameters for ReportInstanceStatus.

" - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestSpotFleetRequest":{ - "type":"structure", - "required":["SpotFleetRequestConfig"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration for the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "RequestSpotFleetResponse":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

The duration period starts as soon as your Spot instance receives its instance ID. At the end of the duration period, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates.

Note that you can't specify an Availability Zone group or a launch group if you specify a duration.

", - "locationName":"blockDurationMinutes" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - }, - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

[EC2-Classic only] One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reservations purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - }, - "documentation":"

Describes the modification request/s.

" - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - }, - "documentation":"

Contains the parameters for ResetImageAttribute.

" - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

You can only reset the following attributes: kernel | ramdisk | sourceDestCheck. To change an instance attribute, use ModifyInstanceAttribute.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for ResetInstanceAttribute.

" - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the parameters for ResetNetworkInterfaceAttribute.

" - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.

" - } - }, - "documentation":"

Contains the parameters for ResetSnapshotAttribute.

" - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "ResponseHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RestoreAddressToClassicRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for RestoreAddressToClassic.

" - }, - "RestoreAddressToClassicResult":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

The move status for the IP address.

", - "locationName":"status" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the output of RestoreAddressToClassic.

" - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupEgress.

" - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a security group in a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account ID of the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupIngress.

" - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationPrefixListId":{ - "shape":"String", - "documentation":"

The prefix of the AWS service.

", - "locationName":"destinationPrefixListId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable - The route was automatically created when the route table was created.

  • CreateRoute - The route was manually added to the route table.

  • EnableVgwRoutePropagation - The route was propagated by route propagation.

", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet. A subnet ID is not returned for an implicit association.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

Data to configure the instance, or a script to run during instance launch. For more information, see Running Commands on Your Linux Instance at Launch (Linux) and Adding User Data (Windows). For API calls, the text must be base64-encoded. For command line tools, the encoding is performed for you, and you can load the text from a file.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - }, - "documentation":"

Contains the parameters for RunInstances.

" - }, - "RunScheduledInstancesRequest":{ - "type":"structure", - "required":[ - "ScheduledInstanceId", - "LaunchSpecification" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

Default: 1

" - }, - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

" - }, - "LaunchSpecification":{ - "shape":"ScheduledInstancesLaunchSpecification", - "documentation":"

The launch specification.

" - } - }, - "documentation":"

Contains the parameters for RunScheduledInstances.

" - }, - "RunScheduledInstancesResult":{ - "type":"structure", - "members":{ - "InstanceIdSet":{ - "shape":"InstanceIdSet", - "documentation":"

The IDs of the newly launched instances.

", - "locationName":"instanceIdSet" - } - }, - "documentation":"

Contains the output of RunScheduledInstances.

" - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

A base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf. For command line tools, base64 encoding is performed for you.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the Base64 encoded JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "ScheduledInstance":{ - "type":"structure", - "members":{ - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

", - "locationName":"scheduledInstanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "PreviousSlotEndTime":{ - "shape":"DateTime", - "documentation":"

The time that the previous schedule ended or will end.

", - "locationName":"previousSlotEndTime" - }, - "NextSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time for the next schedule to start.

", - "locationName":"nextSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

", - "locationName":"instanceCount" - }, - "TermStartDate":{ - "shape":"DateTime", - "documentation":"

The start date for the Scheduled Instance.

", - "locationName":"termStartDate" - }, - "TermEndDate":{ - "shape":"DateTime", - "documentation":"

The end date for the Scheduled Instance.

", - "locationName":"termEndDate" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The date when the Scheduled Instance was purchased.

", - "locationName":"createDate" - } - }, - "documentation":"

Describes a Scheduled Instance.

" - }, - "ScheduledInstanceAvailability":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type. You can specify one of the C3, C4, M4, or R3 instance types.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token. This token expires in two hours.

", - "locationName":"purchaseToken" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "FirstSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time period for the first schedule to start.

", - "locationName":"firstSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "AvailableInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of available instances.

", - "locationName":"availableInstanceCount" - }, - "MinTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The minimum term. The only possible value is 365 days.

", - "locationName":"minTermDurationInDays" - }, - "MaxTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The maximum term. The only possible value is 365 days.

", - "locationName":"maxTermDurationInDays" - } - }, - "documentation":"

Describes a schedule that is available for your Scheduled Instances.

" - }, - "ScheduledInstanceAvailabilitySet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstanceAvailability", - "locationName":"item" - } - }, - "ScheduledInstanceIdRequestSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ScheduledInstanceId" - } - }, - "ScheduledInstanceRecurrence":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

", - "locationName":"frequency" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of frequency. For example, every 2 weeks or every 2 months.

", - "locationName":"interval" - }, - "OccurrenceDaySet":{ - "shape":"OccurrenceDaySet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday).

", - "locationName":"occurrenceDaySet" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month.

", - "locationName":"occurrenceRelativeToEnd" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for occurrenceDaySet (DayOfWeek or DayOfMonth).

", - "locationName":"occurrenceUnit" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceRecurrenceRequest":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of Frequency. For example, every 2 weeks or every 2 months.

" - }, - "OccurrenceDays":{ - "shape":"OccurrenceDayRequestSet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday). You can't specify this value with a daily schedule. If the occurrence is relative to the end of the month, you can specify only a single day.

", - "locationName":"OccurrenceDay" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month. You can't specify this value with a daily schedule.

" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for OccurrenceDays (DayOfWeek or DayOfMonth). This value is required for a monthly schedule. You can't specify DayOfWeek with a weekly schedule. You can't specify this value with a daily schedule.

" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "ScheduledInstancesBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with two available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

" - }, - "Ebs":{ - "shape":"ScheduledInstancesEbs", - "documentation":"

Parameters used to set up EBS volumes automatically when the instance is launched.

" - } - }, - "documentation":"

Describes a block device mapping for a Scheduled Instance.

" - }, - "ScheduledInstancesBlockDeviceMappingSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesBlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "ScheduledInstancesEbs":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, Throughput Optimized HDD for st1, Cold HDD for sc1, or standard for Magnetic.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about gp2 baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is encrypted. You can attached encrypted volumes only to instances that support them.

" - } - }, - "documentation":"

Describes an EBS volume for a Scheduled Instance.

" - }, - "ScheduledInstancesIamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN).

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name.

" - } - }, - "documentation":"

Describes an IAM instance profile for a Scheduled Instance.

" - }, - "ScheduledInstancesLaunchSpecification":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI).

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - }, - "SecurityGroupIds":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The base64-encoded MIME user data.

" - }, - "Placement":{ - "shape":"ScheduledInstancesPlacement", - "documentation":"

The placement information.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

" - }, - "BlockDeviceMappings":{ - "shape":"ScheduledInstancesBlockDeviceMappingSet", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"ScheduledInstancesMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

" - }, - "NetworkInterfaces":{ - "shape":"ScheduledInstancesNetworkInterfaceSet", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"ScheduledInstancesIamInstanceProfile", - "documentation":"

The IAM instance profile.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

" - } - }, - "documentation":"

Describes the launch specification for a Scheduled Instance.

If you are launching the Scheduled Instance in EC2-VPC, you must specify the ID of the subnet. You can specify the subnet using either SubnetId or NetworkInterface.

" - }, - "ScheduledInstancesMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

" - } - }, - "documentation":"

Describes whether monitoring is enabled for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

" - }, - "PrivateIpAddressConfigs":{ - "shape":"PrivateIpAddressConfigSet", - "documentation":"

The private IP addresses.

", - "locationName":"PrivateIpAddressConfig" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses.

" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to instances launched in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

" - }, - "Groups":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"Group" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether to delete the interface when the instance is terminated.

" - } - }, - "documentation":"

Describes a network interface for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterfaceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesNetworkInterface", - "locationName":"NetworkInterface" - } - }, - "ScheduledInstancesPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

" - } - }, - "documentation":"

Describes the placement for a Scheduled Instance.

" - }, - "ScheduledInstancesPrivateIpAddressConfig":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address.

" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is a primary IP address. Otherwise, this is a secondary IP address.

" - } - }, - "documentation":"

Describes a private IP address for a Scheduled Instance.

" - }, - "ScheduledInstancesSecurityGroupIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupReference":{ - "type":"structure", - "required":[ - "GroupId", - "ReferencingVpcId" - ], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of your security group.

", - "locationName":"groupId" - }, - "ReferencingVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with the referencing security group.

", - "locationName":"referencingVpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC with a security group that references your security group.

" - }, - "SecurityGroupReferences":{ - "type":"list", - "member":{ - "shape":"SecurityGroupReference", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "SlotDateTimeRangeRequest":{ - "type":"structure", - "required":[ - "EarliestTime", - "LatestTime" - ], - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start. This value must be later than or equal to the earliest date and at most three months in the future.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule. The time period must span less than one day.

" - }, - "SlotStartTimeRangeRequest":{ - "type":"structure", - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule.

" - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume that was used to create the snapshot.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"statusMessage" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or AWS account ID that owns the snapshot.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - }, - "DataEncryptionKeyId":{ - "shape":"String", - "documentation":"

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"dataEncryptionKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - } - }, - "documentation":"

Describes the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - } - }, - "documentation":"

The disk container object for the import snapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the import snapshot task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the import snapshot task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import snapshot task.

", - "locationName":"status" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot instance.

" - }, - "SpotFleetLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data to make available to the instances.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "Monitoring":{ - "shape":"SpotFleetMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances. To specify multiple subnets, separate them using commas; for example, \"subnet-a61dafcf, subnet-65ea5f08\".

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

", - "locationName":"weightedCapacity" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour for the specified instance type. If this value is not specified, the default is the Spot bid price specified for the fleet. To determine the bid price per unit hour, divide the Spot bid price by the value of WeightedCapacity.

", - "locationName":"spotPrice" - } - }, - "documentation":"

Describes the launch specification for one or more Spot instances.

" - }, - "SpotFleetMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Enables monitoring for the instance.

Default: false

", - "locationName":"enabled" - } - }, - "documentation":"

Describes whether monitoring is enabled.

" - }, - "SpotFleetRequestConfig":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "SpotFleetRequestState", - "SpotFleetRequestConfig", - "CreateTime" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "SpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The state of the Spot fleet request.

", - "locationName":"spotFleetRequestState" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

Information about the configuration of the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The creation date and time of the request.

", - "locationName":"createTime" - } - }, - "documentation":"

Describes a Spot fleet request.

" - }, - "SpotFleetRequestConfigData":{ - "type":"structure", - "required":[ - "SpotPrice", - "TargetCapacity", - "IamFleetRole", - "LaunchSpecifications" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour.

", - "locationName":"spotPrice" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O.

", - "locationName":"targetCapacity" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot instance requests are placed or enabled to fulfill the request.

", - "locationName":"validUntil" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running Spot instances should be terminated when the Spot fleet request expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "IamFleetRole":{ - "shape":"String", - "documentation":"

Grants the Spot fleet permission to terminate Spot instances on your behalf when you cancel its Spot fleet request using CancelSpotFleetRequests or when the Spot fleet request expires, if you set terminateInstancesWithExpiration.

", - "locationName":"iamFleetRole" - }, - "LaunchSpecifications":{ - "shape":"LaunchSpecsList", - "documentation":"

Information about the launch specifications for the Spot fleet request.

", - "locationName":"launchSpecifications" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "AllocationStrategy":{ - "shape":"AllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot fleet request. The default is lowestPrice.

", - "locationName":"allocationStrategy" - }, - "FulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target capacity.

", - "locationName":"fulfilledCapacity" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the fleet will only request the target capacity or also attempt to maintain it. When you request a certain target capacity, the fleet will only place the required bids. It will not attempt to replenish Spot instances if capacity is diminished, nor will it submit bids in alternative Spot pools if capacity is not available. When you want to maintain a certain target capacity, fleet will place the required bids to meet this target capacity. It will also automatically replenish any interrupted instances. Default: maintain.

", - "locationName":"type" - } - }, - "documentation":"

Describes the configuration of a Spot fleet request.

" - }, - "SpotFleetRequestConfigSet":{ - "type":"list", - "member":{ - "shape":"SpotFleetRequestConfig", - "locationName":"item" - } - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for the Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot instance request. Spot bid status information can help you track your Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, it remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot instance requests, all Spot instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when the Spot instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot instance.

", - "locationName":"productDescription" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The duration for the Spot instance, in minutes.

", - "locationName":"blockDurationMinutes" - }, - "ActualBlockHourlyPrice":{ - "shape":"String", - "documentation":"

If you specified a duration and your Spot instance request was fulfilled, this is the fixed hourly price in effect for the Spot instance while it runs.

", - "locationName":"actualBlockHourlyPrice" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describes a Spot instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code. For a list of status codes, see Spot Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The date and time of the most recent status update, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

[Spot fleet only] To specify multiple Availability Zones, separate them using commas; for example, \"us-west-2a, us-west-2b\".

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StaleIpPermission":{ - "type":"structure", - "members":{ - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

", - "locationName":"ipProtocol" - }, - "IpRanges":{ - "shape":"IpRanges", - "documentation":"

One or more IP ranges. Not applicable for stale security group rules.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdSet", - "documentation":"

One or more prefix list IDs for an AWS service. Not applicable for stale security group rules.

", - "locationName":"prefixListIds" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairSet", - "documentation":"

One or more security group pairs. Returns the ID of the referenced security group and VPC, and the ID and status of the VPC peering connection.

", - "locationName":"groups" - } - }, - "documentation":"

Describes a stale rule in a security group.

" - }, - "StaleIpPermissionSet":{ - "type":"list", - "member":{ - "shape":"StaleIpPermission", - "locationName":"item" - } - }, - "StaleSecurityGroup":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the security group.

", - "locationName":"description" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "StaleIpPermissions":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale inbound rules in the security group.

", - "locationName":"staleIpPermissions" - }, - "StaleIpPermissionsEgress":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale outbound rules in the security group.

", - "locationName":"staleIpPermissionsEgress" - } - }, - "documentation":"

Describes a stale security group (a security group that contains stale rules).

" - }, - "StaleSecurityGroupSet":{ - "type":"list", - "member":{ - "shape":"StaleSecurityGroup", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for StartInstances.

" - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StartInstances.

" - }, - "State":{ - "type":"string", - "enum":[ - "Pending", - "Available", - "Deleting", - "Deleted" - ] - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your limits.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "Status":{ - "type":"string", - "enum":[ - "MoveInProgress", - "InVpc", - "InClassic" - ] - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data", - "initializing" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for StopInstances.

" - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StopInstances.

" - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable", - "initializing" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated", - "host" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for TerminateInstances.

" - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of TerminateInstances.

" - }, - "TrafficType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT", - "ALL" - ] - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Contains the parameters for UnassignPrivateIpAddresses.

" - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for UnmonitorInstances.

" - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of UnmonitorInstances.

" - }, - "UnsuccessfulItem":{ - "type":"structure", - "required":["Error"], - "members":{ - "Error":{ - "shape":"UnsuccessfulItemError", - "documentation":"

Information about the error.

", - "locationName":"error" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource.

", - "locationName":"resourceId" - } - }, - "documentation":"

Information about items that were not successfully processed in a batch call.

" - }, - "UnsuccessfulItemError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message accompanying the error code.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error that occurred. For more information about errors, see Error Codes.

" - }, - "UnsuccessfulItemList":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UnsuccessfulItemSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "documentation":"

The Base64-encoded MIME user data for the instance.

", - "locationName":"data" - } - }, - "documentation":"

Describes the user data to be made available to an instance.

" - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. For a referenced security group in another VPC, the account ID of the referenced security group is returned.

[EC2-Classic] Required when adding or removing rules that reference a security group in another AWS account.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use the security group ID.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the referenced security group, if applicable.

", - "locationName":"vpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection, if applicable.

", - "locationName":"vpcPeeringConnectionId" - }, - "PeeringStatus":{ - "shape":"String", - "documentation":"

The status of a VPC peering connection, if applicable.

", - "locationName":"peeringStatus" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdGroupPairSet":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "documentation":"

Information about the volume attachments.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS SSD volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose SSD volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2", - "sc1", - "st1" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcEndpoint":{ - "type":"structure", - "members":{ - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the endpoint is associated.

", - "locationName":"vpcId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the AWS service to which the endpoint is associated.

", - "locationName":"serviceName" - }, - "State":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"state" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

The policy document associated with the endpoint.

", - "locationName":"policyDocument" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables associated with the endpoint.

", - "locationName":"routeTableIdSet" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint.

" - }, - "VpcEndpointSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpoint", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the accepter VPC. CIDR block information is not returned when creating a VPC peering connection, or when describing a VPC peering connection that's in the initiating-request or pending-acceptance state.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionOptionsDescription":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local ClassicLink connection can communicate with the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can communicate with a ClassicLink connection in the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"VpcPeeringConnectionStateReasonCode", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionStateReasonCode":{ - "type":"string", - "enum":[ - "initiating-request", - "pending-acceptance", - "active", - "deleted", - "rejected", - "failed", - "expired", - "provisioning", - "deleting" - ] - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "PeeringOptions":{ - "shape":"VpcPeeringConnectionOptionsDescription", - "documentation":"

Information about the VPC peering connection options for the accepter or requester VPC.

", - "locationName":"peeringOptions" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created, if applicable. This field may be empty or not returned.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - } - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/waiters-2.json deleted file mode 100644 index 652a8cad..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2015-10-01/waiters-2.json +++ /dev/null @@ -1,589 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeInstances", - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Reservations[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConsoleOutputAvailable": { - "operation": "GetConsoleOutput", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(Output || '') > `0`", - "expected": true - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageExists": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Images[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidAMIID.NotFound", - "state": "retry" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "KeyPairExists": { - "operation": "DescribeKeyPairs", - "delay": 5, - "maxAttempts": 6, - "acceptors": [ - { - "expected": true, - "matcher": "pathAll", - "state": "success", - "argument": "length(KeyPairs[].KeyName) > `0`" - }, - { - "expected": "InvalidKeyPair.NotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "NatGatewayAvailable": { - "operation": "DescribeNatGateways", - "delay": 15, - "maxAttempts": 40, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "NatGateways[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "failed" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleting" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleted" - }, - { - "state": "retry", - "matcher": "error", - "expected": "NatGatewayNotFound" - } - ] - }, - "NetworkInterfaceAvailable": { - "operation": "DescribeNetworkInterfaces", - "delay": 20, - "maxAttempts": 10, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "NetworkInterfaces[].Status" - }, - { - "expected": "InvalidNetworkInterfaceID.NotFound", - "matcher": "error", - "state": "failure" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "matcher": "error", - "expected": "InvalidVolume.NotFound", - "state": "success" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 60, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpcPeeringConnectionExists": { - "delay": 15, - "operation": "DescribeVpcPeeringConnections", - "maxAttempts": 40, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcPeeringConnectionID.NotFound", - "state": "retry" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/paginators-1.json deleted file mode 100644 index 2bd01ad5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/paginators-1.json +++ /dev/null @@ -1,63 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - }, - "DescribeSpotFleetRequests": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotFleetRequestConfigs" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeVolumes": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Volumes" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/service-2.json deleted file mode 100644 index 7ebbf187..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/service-2.json +++ /dev/null @@ -1,17629 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-04-01", - "endpointPrefix":"ec2", - "protocol":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2016-04-01" - }, - "operations":{ - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AllocateHosts":{ - "name":"AllocateHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateHostsRequest"}, - "output":{"shape":"AllocateHostsResult"}, - "documentation":"

Allocates a Dedicated Host to your account. At minimum you need to specify the instance size type, Availability Zone, and quantity of hosts you want to allocate.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.

  • AWS Marketplace product codes are copied from the volume to the instance.

  • You must be subscribed to the product.

  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

You can have up to 50 rules per security group (covering both ingress and egress rules).

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotFleetRequests":{ - "name":"CancelSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotFleetRequestsRequest"}, - "output":{"shape":"CancelSpotFleetRequestsResponse"}, - "documentation":"

Cancels the specified Spot fleet requests.

After you cancel a Spot fleet request, the Spot fleet launches no new Spot instances. You must specify whether the Spot fleet should also terminate its Spot instances. If you terminate the instances, the Spot fleet request enters the cancelled_terminating state. Otherwise, the Spot fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot instance requests. Spot instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

Canceling a Spot instance request does not terminate running Spot instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless the Encrypted flag is specified during the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a non-default CMK with the KmsKeyId parameter.

To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and may be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. If you want your instance to receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.

  • domain-name - If you're using AmazonProvidedDNS in \"us-east-1\", specify \"ec2.internal\". If you're using AmazonProvidedDNS in another region, specify \"region.compute.internal\" (for example, \"ap-northeast-1.compute.internal\"). Otherwise, specify a domain name (for example, \"MyCompany.com\"). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateFlowLogs":{ - "name":"CreateFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFlowLogsRequest"}, - "output":{"shape":"CreateFlowLogsResult"}, - "documentation":"

Creates one or more flow logs to capture IP traffic for a specific network interface, subnet, or VPC. Flow logs are delivered to a specified log group in Amazon CloudWatch Logs. If you specify a VPC or subnet in the request, a log stream is created in CloudWatch Logs for each network interface in the subnet or VPC. Log streams can include information about accepted and rejected traffic to a network interface. You can view the data in your log streams using Amazon CloudWatch Logs.

In your request, you must also specify an IAM role that has permission to publish logs to CloudWatch Logs.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{"shape":"KeyPair"}, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateNatGateway":{ - "name":"CreateNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNatGatewayRequest"}, - "output":{"shape":"CreateNatGatewayResult"}, - "documentation":"

Creates a NAT gateway in the specified subnet. A NAT gateway can be used to enable instances in a private subnet to connect to the Internet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. To get a list of your Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price to receive for them. Your Reserved Instance listings then become available for purchase. To view the details of your Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "output":{"shape":"CreateRouteResult"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 500 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{"shape":"Snapshot"}, - "documentation":"

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot instances, enabling you to view Spot instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported Resource-Level Permissions for Amazon EC2 API Actions in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{"shape":"Volume"}, - "documentation":"

Creates an EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

You can specify the instance tenancy value for the VPC when you create it. You can't change this value for the VPC after you create it. For more information, see Dedicated Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcEndpoint":{ - "name":"CreateVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointRequest"}, - "output":{"shape":"CreateVpcEndpointResult"}, - "documentation":"

Creates a VPC endpoint for a specified AWS service. An endpoint enables you to create a private connection between your VPC and another AWS service in your account. You can specify an endpoint policy to attach to the endpoint that will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.

Currently, only endpoints to Amazon S3 are supported.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteFlowLogs":{ - "name":"DeleteFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFlowLogsRequest"}, - "output":{"shape":"DeleteFlowLogsResult"}, - "documentation":"

Deletes one or more flow logs.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNatGateway":{ - "name":"DeleteNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNatGatewayRequest"}, - "output":{"shape":"DeleteNatGatewayResult"}, - "documentation":"

Deletes the specified NAT gateway. Deleting a NAT gateway disassociates its Elastic IP address, but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway routes in your route tables.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot instances.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcEndpoints":{ - "name":"DeleteVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointsRequest"}, - "output":{"shape":"DeleteVpcEndpointsResult"}, - "documentation":"

Deletes one or more specified VPC endpoints. Deleting the endpoint also deletes the endpoint routes in the route tables that were associated with the endpoint.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see the VM Import/Export User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeFlowLogs":{ - "name":"DescribeFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFlowLogsRequest"}, - "output":{"shape":"DescribeFlowLogsResult"}, - "documentation":"

Describes one or more flow logs. To view the information in your flow logs (the log streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs API.

" - }, - "DescribeHostReservationOfferings":{ - "name":"DescribeHostReservationOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationOfferingsRequest"}, - "output":{"shape":"DescribeHostReservationOfferingsResult"}, - "documentation":"

Describes the Dedicated Host Reservations that are available to purchase.

The results describe all the Dedicated Host Reservation offerings, including offerings that may not match the instance family and region of your Dedicated Hosts. When purchasing an offering, ensure that the the instance family and region of the offering matches that of the Dedicated Host/s it will be associated with. For an overview of supported instance types, see Dedicated Hosts Overview in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeHostReservations":{ - "name":"DescribeHostReservations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationsRequest"}, - "output":{"shape":"DescribeHostReservationsResult"}, - "documentation":"

Describes Dedicated Host Reservations which are associated with Dedicated Hosts in your account.

" - }, - "DescribeHosts":{ - "name":"DescribeHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostsRequest"}, - "output":{"shape":"DescribeHostsResult"}, - "documentation":"

Describes one or more of your Dedicated Hosts.

The results describe only the Dedicated Hosts in the region you're currently using. All listed instances consume capacity on your Dedicated Host. Dedicated Hosts that have recently been released will be listed with the state released.

" - }, - "DescribeIdFormat":{ - "name":"DescribeIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdFormatRequest"}, - "output":{"shape":"DescribeIdFormatResult"}, - "documentation":"

Describes the ID format settings for your resources on a per-region basis, for example, to view which resource types are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types.

The following resource types support longer IDs: instance | reservation | snapshot | volume.

These settings apply to the IAM user who makes the request; they do not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user, unless they explicitly override the settings by running the ModifyIdFormat command. Resources created with longer IDs are visible to all IAM users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "DescribeIdentityIdFormat":{ - "name":"DescribeIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityIdFormatRequest"}, - "output":{"shape":"DescribeIdentityIdFormatResult"}, - "documentation":"

Describes the ID format settings for resources for the specified IAM user, IAM role, or root user. For example, you can view the resource types that are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

The following resource types support longer IDs: instance | reservation | snapshot | volume.

These settings apply to the principal specified in the request. They do not apply to the principal that makes the request.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{"shape":"ImageAttribute"}, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Describes your import snapshot tasks.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances. By default, only running instances are described, unless specified otherwise.

Instance status includes the following components:

  • Status checks - Amazon EC2 performs status checks on running EC2 instances to identify hardware and software issues. For more information, see Status Checks for Your Instances and Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide.

  • Scheduled events - Amazon EC2 can schedule events (such as reboot, stop, or terminate) for your instances related to hardware issues, software updates, or system maintenance. For more information, see Scheduled Events for Your Instances in the Amazon Elastic Compute Cloud User Guide.

  • Instance state - You can manage your instances from the moment you launch them through their termination. For more information, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If you describe instances in the rare case where an Availability Zone is experiencing a service disruption and you specify instance IDs that are in the affected zone, or do not specify any instance IDs at all, the call fails. If you describe instances and specify only instance IDs that are in an unaffected zone, the call works normally.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeMovingAddresses":{ - "name":"DescribeMovingAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMovingAddressesRequest"}, - "output":{"shape":"DescribeMovingAddressesResult"}, - "documentation":"

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

" - }, - "DescribeNatGateways":{ - "name":"DescribeNatGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNatGatewaysRequest"}, - "output":{"shape":"DescribeNatGatewaysResult"}, - "documentation":"

Describes one or more of the your NAT gateways.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribePrefixLists":{ - "name":"DescribePrefixLists", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrefixListsRequest"}, - "output":{"shape":"DescribePrefixListsResult"}, - "documentation":"

Describes available AWS services in a prefix list format, which includes the prefix list name and prefix list ID of the service and the IP address range for the service. A prefix list ID is required for creating an outbound security group rule that allows traffic from a VPC to access an AWS service through a VPC endpoint.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

If you have listed your own Reserved Instances for sale in the Reserved Instance Marketplace, they will be excluded from these results. This is to ensure that you do not purchase your own Reserved Instances.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeScheduledInstanceAvailability":{ - "name":"DescribeScheduledInstanceAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstanceAvailabilityRequest"}, - "output":{"shape":"DescribeScheduledInstanceAvailabilityResult"}, - "documentation":"

Finds available schedules that meet the specified criteria.

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

After you find a schedule that meets your needs, call PurchaseScheduledInstances to purchase Scheduled Instances with that schedule.

" - }, - "DescribeScheduledInstances":{ - "name":"DescribeScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstancesRequest"}, - "output":{"shape":"DescribeScheduledInstancesResult"}, - "documentation":"

Describes one or more of your Scheduled Instances.

" - }, - "DescribeSecurityGroupReferences":{ - "name":"DescribeSecurityGroupReferences", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupReferencesRequest"}, - "output":{"shape":"DescribeSecurityGroupReferencesResult"}, - "documentation":"

[EC2-VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.

  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.

  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners using the OwnerIds option, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotFleetInstances":{ - "name":"DescribeSpotFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetInstancesRequest"}, - "output":{"shape":"DescribeSpotFleetInstancesResponse"}, - "documentation":"

Describes the running instances for the specified Spot fleet.

" - }, - "DescribeSpotFleetRequestHistory":{ - "name":"DescribeSpotFleetRequestHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestHistoryRequest"}, - "output":{"shape":"DescribeSpotFleetRequestHistoryResponse"}, - "documentation":"

Describes the events for the specified Spot fleet request during the specified time.

Spot fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event.

" - }, - "DescribeSpotFleetRequests":{ - "name":"DescribeSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestsRequest"}, - "output":{"shape":"DescribeSpotFleetRequestsResponse"}, - "documentation":"

Describes your Spot fleet requests.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot instance requests that belong to your account. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

You can use DescribeSpotInstanceRequests to find a running Spot instance by examining the response. If the status of the Spot instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeStaleSecurityGroups":{ - "name":"DescribeStaleSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStaleSecurityGroupsRequest"}, - "output":{"shape":"DescribeStaleSecurityGroupsResult"}, - "documentation":"

[EC2-VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcClassicLinkDnsSupport":{ - "name":"DescribeVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DescribeVpcClassicLinkDnsSupportResult"}, - "documentation":"

Describes the ClassicLink DNS support status of one or more VPCs. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcEndpointServices":{ - "name":"DescribeVpcEndpointServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicesRequest"}, - "output":{"shape":"DescribeVpcEndpointServicesResult"}, - "documentation":"

Describes all supported AWS services that can be specified when creating a VPC endpoint.

" - }, - "DescribeVpcEndpoints":{ - "name":"DescribeVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointsRequest"}, - "output":{"shape":"DescribeVpcEndpointsResult"}, - "documentation":"

Describes one or more of your VPC endpoints.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisableVpcClassicLinkDnsSupport":{ - "name":"DisableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DisableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Disables ClassicLink DNS support for a VPC. If disabled, DNS hostnames resolve to public IP addresses when addressed between a linked EC2-Classic instance and instances in the VPC to which it's linked. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "EnableVpcClassicLinkDnsSupport":{ - "name":"EnableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"EnableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Enables a VPC to support DNS hostname resolution for ClassicLink. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetConsoleScreenshot":{ - "name":"GetConsoleScreenshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleScreenshotRequest"}, - "output":{"shape":"GetConsoleScreenshotResult"}, - "documentation":"

Retrieve a JPG-format screenshot of a running instance to help with troubleshooting.

The returned content is Base64-encoded.

" - }, - "GetHostReservationPurchasePreview":{ - "name":"GetHostReservationPurchasePreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetHostReservationPurchasePreviewRequest"}, - "output":{"shape":"GetHostReservationPurchasePreviewResult"}, - "documentation":"

Preview a reservation purchase with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation.

This is a preview of the PurchaseHostReservation action and does not result in the offering being purchased.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI). For more information, see Importing a VM as an Image Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Imports a disk into an EBS snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image.For more information, see Importing Disks to Amazon EBS.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ModifyHosts":{ - "name":"ModifyHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHostsRequest"}, - "output":{"shape":"ModifyHostsResult"}, - "documentation":"

Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, AWS will place instances that you launch with a tenancy of host, but without targeting a specific host ID, onto any available Dedicated Host in your account which has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID if you want the instance to launch onto a specific host. If no host ID is provided, the instance will be launched onto a suitable host which has auto-placement enabled.

" - }, - "ModifyIdFormat":{ - "name":"ModifyIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdFormatRequest"}, - "documentation":"

Modifies the ID format for the specified resource on a per-region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created. The following resource types support longer IDs: instance | reservation | snapshot | volume.

This setting applies to the IAM user who makes the request; it does not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyIdentityIdFormat":{ - "name":"ModifyIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdentityIdFormatRequest"}, - "documentation":"

Modifies the ID format of a resource for a specified IAM user, IAM role, or the root user for an account; or all IAM users, IAM roles, and the root user for an account. You can specify that resources should receive longer IDs (17-character IDs) when they are created.

The following resource types support longer IDs: instance | reservation | snapshot | volume. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

This setting applies to the principal specified in the request; it does not apply to the principal that makes the request.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

The SriovNetSupport enhanced networking attribute cannot be changed using this command. Instead, enable SriovNetSupport on an instance and create an AMI from the instance. This will result in an image with SriovNetSupport enabled.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyInstancePlacement":{ - "name":"ModifyInstancePlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstancePlacementRequest"}, - "output":{"shape":"ModifyInstancePlacementResult"}, - "documentation":"

Set the instance affinity value for a specific stopped instance and modify the instance tenancy setting.

Instance affinity is disabled by default. When instance affinity is host and it is not associated with a specific Dedicated Host, the next time it is launched it will automatically be associated with the host it lands on. This relationship will persist if the instance is stopped/started, or rebooted.

You can modify the host ID associated with a stopped instance. If a stopped instance has a new host ID association, the instance will target that host when restarted.

You can modify the tenancy of a stopped instance with a tenancy of host or dedicated.

Affinity, hostID, and tenancy are not required parameters, but at least one of them must be specified in the request. Affinity and tenancy can be modified in the same request, but tenancy can only be modified on instances that are stopped.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

Encrypted snapshots and snapshots with AWS Marketplace product codes cannot be made public. Snapshots encrypted with your default CMK cannot be shared with other accounts.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySpotFleetRequest":{ - "name":"ModifySpotFleetRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySpotFleetRequestRequest"}, - "output":{"shape":"ModifySpotFleetRequestResponse"}, - "documentation":"

Modifies the specified Spot fleet request.

While the Spot fleet request is being modified, it is in the modifying state.

To scale up your Spot fleet, increase its target capacity. The Spot fleet launches the additional Spot instances according to the allocation strategy for the Spot fleet request. If the allocation strategy is lowestPrice, the Spot fleet launches instances using the Spot pool with the lowest price. If the allocation strategy is diversified, the Spot fleet distributes the instances across the Spot pools.

To scale down your Spot fleet, decrease its target capacity. First, the Spot fleet cancels any open bids that exceed the new target capacity. You can request that the Spot fleet terminate Spot instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot fleet terminates the instances with the highest price per unit. If the allocation strategy is diversified, the Spot fleet terminates instances across the Spot pools. Alternatively, you can request that the Spot fleet keep the fleet at its current size, but not replace any Spot instances that are interrupted or that you terminate manually.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "ModifyVpcEndpoint":{ - "name":"ModifyVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointRequest"}, - "output":{"shape":"ModifyVpcEndpointResult"}, - "documentation":"

Modifies attributes of a specified VPC endpoint. You can modify the policy associated with the endpoint, and you can add and remove route tables associated with the endpoint.

" - }, - "ModifyVpcPeeringConnectionOptions":{ - "name":"ModifyVpcPeeringConnectionOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcPeeringConnectionOptionsRequest"}, - "output":{"shape":"ModifyVpcPeeringConnectionOptionsResult"}, - "documentation":"

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

  • Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.

  • Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.

  • Enable/disable a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

If the peered VPCs are in different accounts, each owner must initiate a separate request to modify the peering connection options, depending on whether their VPC was the requester or accepter for the VPC peering connection. If the peered VPCs are in the same account, you can modify the requester and accepter options in the same request. To confirm which VPC is the accepter and requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MoveAddressToVpc":{ - "name":"MoveAddressToVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAddressToVpcRequest"}, - "output":{"shape":"MoveAddressToVpcResult"}, - "documentation":"

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The Elastic IP address must be allocated to your account for more than 24 hours, and it must not be associated with an instance. After the Elastic IP address is moved, it is no longer available for use in the EC2-Classic platform, unless you move it back using the RestoreAddressToClassic request. You cannot move an Elastic IP address that was originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.

" - }, - "PurchaseHostReservation":{ - "name":"PurchaseHostReservation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseHostReservationRequest"}, - "output":{"shape":"PurchaseHostReservationResult"}, - "documentation":"

Purchase a reservation with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation. This action results in the specified reservation being purchased and charged to your account.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time and pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "PurchaseScheduledInstances":{ - "name":"PurchaseScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseScheduledInstancesRequest"}, - "output":{"shape":"PurchaseScheduledInstancesResult"}, - "documentation":"

Purchases one or more Scheduled Instances with the specified schedule.

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, you must call RunScheduledInstances during each scheduled time period.

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If an instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.

Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), use the EC2 billingProduct code associated with an AMI to verify subscription status for package updates. Creating an AMI from an EBS snapshot does not maintain this billing code, and subsequent instances launched from such an AMI will not be able to connect to package update infrastructure.

Similarly, although you can create a Windows AMI from a snapshot, you can't successfully launch an instance from the AMI.

To create Windows AMIs or to create AMIs for Linux operating systems that must retain AMI billing codes to work properly, see CreateImage.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReleaseHosts":{ - "name":"ReleaseHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseHostsRequest"}, - "output":{"shape":"ReleaseHostsResult"}, - "documentation":"

When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, e.g., ModifyHosts. You must stop or terminate all instances on a host before it can be released.

When Dedicated Hosts are released, it make take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated hosts. Try waiting a few minutes, and then try again.

Released hosts will still appear in a DescribeHosts response.

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotFleet":{ - "name":"RequestSpotFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotFleetRequest"}, - "output":{"shape":"RequestSpotFleetResponse"}, - "documentation":"

Creates a Spot fleet request.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot fleet requests Spot instances in the Spot pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot instances in your Spot fleet are in different Spot pools, you can improve the availability of your fleet.

For more information, see Spot Fleet Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot instance request. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot Instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the sourceDestCheck, the instance can be either running or stopped.

The sourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RestoreAddressToClassic":{ - "name":"RestoreAddressToClassic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreAddressToClassicRequest"}, - "output":{"shape":"RestoreAddressToClassicResult"}, - "documentation":"

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Removes one or more egress rules from a security group for EC2-VPC. This action doesn't apply to security groups for use in EC2-Classic. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{"shape":"Reservation"}, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

To ensure faster instance launches, break up large requests into smaller batches. For example, create five separate launch requests for 100 instances each instead of one launch request for 500 instances.

To tag your instance, ensure that it is running as CreateTags requires a resource ID. For more information about tagging, see Tagging Your Amazon EC2 Resources.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC only accounts] If you don't specify a subnet in the request, we choose a default subnet from your default VPC for you.

[EC2-Classic accounts] If you're launching into EC2-Classic and you don't specify an Availability Zone, we choose one for you.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

Some instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails. For more information, see Instance Types Available Only in a VPC.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RunScheduledInstances":{ - "name":"RunScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunScheduledInstancesRequest"}, - "output":{"shape":"RunScheduledInstancesResult"}, - "documentation":"

Launches the specified Scheduled Instances.

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, you can launch it again after a few minutes. For more information, see Scheduled Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance.

We don't charge hourly usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot instances, and you can't stop instance store-backed instances.

When you stop an instance, we shut it down. You can restart your instance at any time. Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Stopping an instance is different to rebooting or terminating it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the DeleteOnTermination block device mapping parameter set to true are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "shapes":{ - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for AcceptVpcPeeringConnection.

" - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of AcceptVpcPeeringConnection.

" - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "ActiveInstance":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - } - }, - "documentation":"

Describes a running instance in a Spot fleet.

" - }, - "ActiveInstanceSet":{ - "type":"list", - "member":{ - "shape":"ActiveInstance", - "locationName":"item" - } - }, - "ActivityStatus":{ - "type":"string", - "enum":[ - "error", - "pending_fulfillment", - "pending_termination", - "fulfilled" - ] - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "Affinity":{ - "type":"string", - "enum":[ - "default", - "host" - ] - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - }, - "documentation":"

Contains the parameters for AllocateAddress.

" - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - }, - "documentation":"

Contains the output of AllocateAddress.

" - }, - "AllocateHostsRequest":{ - "type":"structure", - "required":[ - "InstanceType", - "Quantity", - "AvailabilityZone" - ], - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID.

Default: Enabled

", - "locationName":"autoPlacement" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

Specify the instance type that you want your Dedicated Hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.

", - "locationName":"instanceType" - }, - "Quantity":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts you want to allocate to your account with these parameters.

", - "locationName":"quantity" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the Dedicated Hosts.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Contains the parameters for AllocateHosts.

" - }, - "AllocateHostsResult":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"ResponseHostIdList", - "documentation":"

The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.

", - "locationName":"hostIdSet" - } - }, - "documentation":"

Contains the output of AllocateHosts.

" - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "AllocationState":{ - "type":"string", - "enum":[ - "available", - "under-assessment", - "permanent-failure", - "released", - "released-permanent-failure" - ] - }, - "AllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "diversified" - ] - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - }, - "documentation":"

Contains the parameters for AssignPrivateIpAddresses.

" - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] For a VPC in an EC2-Classic account, specify true to allow an Elastic IP address that is already associated with an instance or network interface to be reassociated with the specified instance or network interface. Otherwise, the operation fails. In a VPC in an EC2-VPC-only account, reassociation is automatic, therefore you can specify false to ensure the operation fails if the Elastic IP address is already associated with another resource.

", - "locationName":"allowReassociation" - } - }, - "documentation":"

Contains the parameters for AssociateAddress.

" - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateAddress.

" - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AssociateDhcpOptions.

" - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for AssociateRouteTable.

" - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateRouteTable.

" - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Contains the parameters for AttachClassicLinkVpc.

" - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of AttachClassicLinkVpc.

" - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for AttachInternetGateway.

" - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - }, - "documentation":"

Contains the parameters for AttachNetworkInterface.

" - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - }, - "documentation":"

Contains the output of AttachNetworkInterface.

" - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - }, - "documentation":"

Contains the parameters for AttachVolume.

" - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AttachVpnGateway.

" - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of AttachVpnGateway.

" - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

The attribute value. The valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

The attribute value. Note that the value is case-sensitive.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a String.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupEgress.

" - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account number for the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all traffic. If you specify -1, traffic on all ports is allowed, regardless of any ports you specify.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupIngress.

" - }, - "AutoPlacement":{ - "type":"string", - "enum":[ - "on", - "off" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone.

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":[ - "available", - "information", - "impaired", - "unavailable" - ] - }, - "AvailableCapacity":{ - "type":"structure", - "members":{ - "AvailableInstanceCapacity":{ - "shape":"AvailableInstanceCapacityList", - "documentation":"

The total number of instances that the Dedicated Host supports.

", - "locationName":"availableInstanceCapacity" - }, - "AvailableVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs available on the Dedicated Host.

", - "locationName":"availableVCpus" - } - }, - "documentation":"

The capacity information for instances launched onto the Dedicated Host.

" - }, - "AvailableInstanceCapacityList":{ - "type":"list", - "member":{ - "shape":"InstanceCapacity", - "locationName":"item" - } - }, - "BatchState":{ - "type":"string", - "enum":[ - "submitted", - "active", - "cancelled", - "failed", - "cancelled_running", - "cancelled_terminating", - "modifying" - ] - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - }, - "documentation":"

Contains the parameters for BundleInstance.

" - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of BundleInstance.

" - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBatchErrorCode":{ - "type":"string", - "enum":[ - "fleetRequestIdDoesNotExist", - "fleetRequestIdMalformed", - "fleetRequestNotInCancellableState", - "unexpectedError" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - }, - "documentation":"

Contains the parameters for CancelBundleTask.

" - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of CancelBundleTask.

" - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "documentation":"

The reason for canceling the conversion task.

", - "locationName":"reasonMessage" - } - }, - "documentation":"

Contains the parameters for CancelConversionTask.

" - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for CancelExportTask.

" - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image or import snapshot task to be canceled.

" - }, - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - } - }, - "documentation":"

Contains the parameters for CancelImportTask.

" - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the task being canceled.

", - "locationName":"importTaskId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"state" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"previousState" - } - }, - "documentation":"

Contains the output for CancelImportTask.

" - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - }, - "documentation":"

Contains the parameters for CancelReservedInstancesListing.

" - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CancelReservedInstancesListing.

" - }, - "CancelSpotFleetRequestsError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"CancelBatchErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot fleet error.

" - }, - "CancelSpotFleetRequestsErrorItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "Error" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "Error":{ - "shape":"CancelSpotFleetRequestsError", - "documentation":"

The error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a Spot fleet request that was not successfully canceled.

" - }, - "CancelSpotFleetRequestsErrorSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsErrorItem", - "locationName":"item" - } - }, - "CancelSpotFleetRequestsRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for a Spot fleet request if it is canceled successfully.

", - "locationName":"terminateInstances" - } - }, - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsResponse":{ - "type":"structure", - "members":{ - "UnsuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsErrorSet", - "documentation":"

Information about the Spot fleet requests that are not successfully canceled.

", - "locationName":"unsuccessfulFleetRequestSet" - }, - "SuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsSuccessSet", - "documentation":"

Information about the Spot fleet requests that are successfully canceled.

", - "locationName":"successfulFleetRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsSuccessItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "CurrentSpotFleetRequestState", - "PreviousSpotFleetRequestState" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "CurrentSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The current state of the Spot fleet request.

", - "locationName":"currentSpotFleetRequestState" - }, - "PreviousSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The previous state of the Spot fleet request.

", - "locationName":"previousSpotFleetRequestState" - } - }, - "documentation":"

Describes a Spot fleet request that was successfully canceled.

" - }, - "CancelSpotFleetRequestsSuccessSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsSuccessItem", - "locationName":"item" - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkDnsSupport":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkDnsSupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether ClassicLink DNS support is enabled for the VPC.

", - "locationName":"classicLinkDnsSupported" - } - }, - "documentation":"

Describes the ClassicLink DNS support status of a VPC.

" - }, - "ClassicLinkDnsSupportList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkDnsSupport", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClientData":{ - "type":"structure", - "members":{ - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image, in GiB.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment about the disk upload.

" - } - }, - "documentation":"

Describes the client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for ConfirmProductInstance.

" - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - }, - "Return":{ - "shape":"Boolean", - "documentation":"

The return value of the request. Returns true if the specified product code is owned by the requester and associated with the specified instance.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ConfirmProductInstance.

" - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the task.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshots of the copied image should be encrypted. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when encrypting the snapshots of an image during a copy operation. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopyImage.

" - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CopyImage.

" - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshot should be encrypted. You can encrypt a copy of an unencrypted snapshot using this flag, but you cannot use it to create an unencrypted copy from an encrypted snapshot. Your default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when creating the snapshot copy. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopySnapshot.

" - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - }, - "documentation":"

Contains the output of CopySnapshot.

" - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - }, - "documentation":"

Contains the parameters for CreateCustomerGateway.

" - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - }, - "documentation":"

Contains the output of CreateCustomerGateway.

" - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - }, - "documentation":"

Contains the parameters for CreateDhcpOptions.

" - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - }, - "documentation":"

Contains the output of CreateDhcpOptions.

" - }, - "CreateFlowLogsRequest":{ - "type":"structure", - "required":[ - "ResourceIds", - "ResourceType", - "TrafficType", - "LogGroupName", - "DeliverLogsPermissionArn" - ], - "members":{ - "ResourceIds":{ - "shape":"ValueStringList", - "documentation":"

One or more subnet, network interface, or VPC IDs.

Constraints: Maximum of 1000 resources

", - "locationName":"ResourceId" - }, - "ResourceType":{ - "shape":"FlowLogsResourceType", - "documentation":"

The type of resource on which to create the flow log.

" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic to log.

" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch log group.

" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that's used to post flow logs to a CloudWatch Logs log group.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateFlowLogs.

" - }, - "CreateFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the flow logs.

", - "locationName":"flowLogIdSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be created successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of CreateFlowLogs.

" - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, Amazon EC2 attempts to shut down and reboot the instance before creating the image. If the 'No Reboot' option is set, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Contains the parameters for CreateImage.

" - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CreateImage.

" - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "documentation":"

The format and location for an instance export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Contains the parameters for CreateInstanceExportTask.

" - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "documentation":"

Information about the instance export task.

", - "locationName":"exportTask" - } - }, - "documentation":"

Contains the output for CreateInstanceExportTask.

" - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateInternetGateway.

" - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - }, - "documentation":"

Contains the output of CreateInternetGateway.

" - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - }, - "documentation":"

Contains the parameters for CreateKeyPair.

" - }, - "CreateNatGatewayRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "AllocationId" - ], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The subnet in which to create the NAT gateway.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of an Elastic IP address to associate with the NAT gateway. If the Elastic IP address is associated with another resource, you must first disassociate it.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

Constraint: Maximum 64 ASCII characters.

" - } - }, - "documentation":"

Contains the parameters for CreateNatGateway.

" - }, - "CreateNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGateway":{ - "shape":"NatGateway", - "documentation":"

Information about the NAT gateway.

", - "locationName":"natGateway" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateNatGateway.

" - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766. The range 32767 to 65535 is reserved for internal use.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAclEntry.

" - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAcl.

" - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - }, - "documentation":"

Contains the output of CreateNetworkAcl.

" - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateNetworkInterface.

" - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - }, - "documentation":"

Contains the output of CreateNetworkInterface.

" - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - }, - "documentation":"

Contains the parameters for CreatePlacementGroup.

" - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the parameters for CreateReservedInstancesListing.

" - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CreateReservedInstancesListing.

" - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for CreateRoute.

" - }, - "CreateRouteResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of CreateRoute.

" - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateRouteTable.

" - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - }, - "documentation":"

Contains the output of CreateRouteTable.

" - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for CreateSecurityGroup.

" - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Contains the output of CreateSecurityGroup.

" - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - }, - "documentation":"

Contains the parameters for CreateSnapshot.

" - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - }, - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: AWS selects one for you. If you create more than one subnet in your VPC, we may not necessarily select a different zone for each subnet.

" - } - }, - "documentation":"

Contains the parameters for CreateSubnet.

" - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - }, - "documentation":"

Contains the output of CreateSubnet.

" - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - }, - "documentation":"

Contains the parameters for CreateTags.

" - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - }, - "documentation":"

Describes the user or group to be added or removed from the permissions for a volume.

" - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - }, - "documentation":"

Describes modifications to the permissions for a volume.

" - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-16384 for gp2, 4-16384 for io1, 500-16384 for st1, 500-16384 for sc1, and 1-1024 for standard. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS SSD volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS SSD volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. If a KmsKeyId is specified, the Encrypted flag must also be set.

" - } - }, - "documentation":"

Contains the parameters for CreateVolume.

" - }, - "CreateVpcEndpointRequest":{ - "type":"structure", - "required":[ - "VpcId", - "ServiceName" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the endpoint will be used.

" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The AWS service name, in the form com.amazonaws.region.service . To get a list of available services, use the DescribeVpcEndpointServices request.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy to attach to the endpoint that controls access to the service. The policy must be in valid JSON format. If this parameter is not specified, we attach a default policy that allows full access to the service.

" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

", - "locationName":"RouteTableId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateVpcEndpoint.

" - }, - "CreateVpcEndpointResult":{ - "type":"structure", - "members":{ - "VpcEndpoint":{ - "shape":"VpcEndpoint", - "documentation":"

Information about the endpoint.

", - "locationName":"vpcEndpoint" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateVpcEndpoint.

" - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - }, - "documentation":"

Contains the parameters for CreateVpcPeeringConnection.

" - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of CreateVpcPeeringConnection.

" - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy options for instances launched into the VPC. For default, instances are launched with shared tenancy by default. You can launch instances with any tenancy into a shared tenancy VPC. For dedicated, instances are launched as dedicated tenancy instances by default. You can only launch instances with a tenancy of dedicated or host into a dedicated tenancy VPC.

Important: The host value cannot be used with this parameter. Use the default or dedicated values only.

Default: default

", - "locationName":"instanceTenancy" - } - }, - "documentation":"

Contains the parameters for CreateVpc.

" - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - }, - "documentation":"

Contains the output of CreateVpc.

" - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnection.

" - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - }, - "documentation":"

Contains the output of CreateVpnConnection.

" - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnectionRoute.

" - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnGateway.

" - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - }, - "documentation":"

Contains the output of CreateVpnGateway.

" - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteCustomerGateway.

" - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - }, - "documentation":"

Contains the parameters for DeleteDhcpOptions.

" - }, - "DeleteFlowLogsRequest":{ - "type":"structure", - "required":["FlowLogIds"], - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - } - }, - "documentation":"

Contains the parameters for DeleteFlowLogs.

" - }, - "DeleteFlowLogsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteFlowLogs.

" - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - }, - "documentation":"

Contains the parameters for DeleteInternetGateway.

" - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - }, - "documentation":"

Contains the parameters for DeleteKeyPair.

" - }, - "DeleteNatGatewayRequest":{ - "type":"structure", - "required":["NatGatewayId"], - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteNatGateway.

" - }, - "DeleteNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the output of DeleteNatGateway.

" - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAclEntry.

" - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAcl.

" - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkInterface.

" - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - }, - "documentation":"

Contains the parameters for DeletePlacementGroup.

" - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - }, - "documentation":"

Contains the parameters for DeleteRoute.

" - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for DeleteRouteTable.

" - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteSecurityGroup.

" - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - } - }, - "documentation":"

Contains the parameters for DeleteSnapshot.

" - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - }, - "documentation":"

Contains the parameters for DeleteSubnet.

" - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - }, - "documentation":"

Contains the parameters for DeleteTags.

" - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - }, - "documentation":"

Contains the parameters for DeleteVolume.

" - }, - "DeleteVpcEndpointsRequest":{ - "type":"structure", - "required":["VpcEndpointIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcEndpoints.

" - }, - "DeleteVpcEndpointsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the endpoints that were not successfully deleted.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteVpcEndpoints.

" - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcPeeringConnection.

" - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DeleteVpcPeeringConnection.

" - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpc.

" - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnection.

" - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnectionRoute.

" - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnGateway.

" - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - }, - "documentation":"

Contains the parameters for DeregisterImage.

" - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - }, - "documentation":"

Contains the parameters for DescribeAccountAttributes.

" - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - }, - "documentation":"

Contains the output of DescribeAccountAttributes.

" - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - }, - "documentation":"

Contains the parameters for DescribeAddresses.

" - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - }, - "documentation":"

Contains the output of DescribeAddresses.

" - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | information | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeAvailabilityZones.

" - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - }, - "documentation":"

Contains the output of DescribeAvailabiltyZones.

" - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeBundleTasks.

" - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - }, - "documentation":"

Contains the output of DescribeBundleTasks.

" - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeClassicLinkInstances.

" - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeClassicLinkInstances.

" - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

", - "locationName":"filter" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeConversionTasks.

" - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "documentation":"

Information about the conversion tasks.

", - "locationName":"conversionTasks" - } - }, - "documentation":"

Contains the output for DescribeConversionTasks.

" - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeCustomerGateways.

" - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeCustomerGateways.

" - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeDhcpOptions.

" - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - }, - "documentation":"

Contains the output of DescribeDhcpOptions.

" - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeExportTasks.

" - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "documentation":"

Information about the export tasks.

", - "locationName":"exportTaskSet" - } - }, - "documentation":"

Contains the output for DescribeExportTasks.

" - }, - "DescribeFlowLogsRequest":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • deliver-log-status - The status of the logs delivery (SUCCESS | FAILED).

  • flow-log-id - The ID of the flow log.

  • log-group-name - The name of the log group.

  • resource-id - The ID of the VPC, subnet, or network interface.

  • traffic-type - The type of traffic (ACCEPT | REJECT | ALL)

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the flow log IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeFlowLogs.

" - }, - "DescribeFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogs":{ - "shape":"FlowLogSet", - "documentation":"

Information about the flow logs.

", - "locationName":"flowLogSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeFlowLogs.

" - }, - "DescribeHostReservationOfferingsRequest":{ - "type":"structure", - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation offering.

" - }, - "MinDuration":{ - "shape":"Integer", - "documentation":"

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

" - }, - "MaxDuration":{ - "shape":"Integer", - "documentation":"

This is the maximum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family of the offering (e.g., m4).

  • payment-option - The payment option (No Upfront | Partial Upfront | All Upfront).

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - } - } - }, - "DescribeHostReservationOfferingsResult":{ - "type":"structure", - "members":{ - "OfferingSet":{ - "shape":"HostOfferingSet", - "documentation":"

Information about the offerings.

", - "locationName":"offeringSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostReservationsRequest":{ - "type":"structure", - "members":{ - "HostReservationIdSet":{ - "shape":"HostReservationIdSet", - "documentation":"

One or more host reservation IDs.

" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family (e.g., m4).

  • payment-option - The payment option (No Upfront | Partial Upfront | All Upfront).

  • state - The state of the reservation (payment-pending | payment-failed | active | retired).

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - } - } - }, - "DescribeHostReservationsResult":{ - "type":"structure", - "members":{ - "HostReservationSet":{ - "shape":"HostReservationSet", - "documentation":"

Details about the reservation's configuration.

", - "locationName":"hostReservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostsRequest":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts. The IDs are used for targeted instance launches.

", - "locationName":"hostId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error. You cannot specify this parameter and the host IDs parameter in the same request.

", - "locationName":"maxResults" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-type - The instance type size that the Dedicated Host is configured to support.

  • auto-placement - Whether auto-placement is enabled or disabled (on | off).

  • host-reservation-id - The ID of the reservation assigned to this host.

  • client-token - The idempotency token you provided when you launched the instance

  • state- The allocation state of the Dedicated Host (available | under-assessment | permanent-failure | released | released-permanent-failure).

  • availability-zone - The Availability Zone of the host.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeHosts.

" - }, - "DescribeHostsResult":{ - "type":"structure", - "members":{ - "Hosts":{ - "shape":"HostList", - "documentation":"

Information about the Dedicated Hosts.

", - "locationName":"hostSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeHosts.

" - }, - "DescribeIdFormatRequest":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

" - } - }, - "documentation":"

Contains the parameters for DescribeIdFormat.

" - }, - "DescribeIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resource.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdFormat.

" - }, - "DescribeIdentityIdFormatRequest":{ - "type":"structure", - "required":["PrincipalArn"], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

", - "locationName":"resource" - }, - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM role, IAM user, or the root user.

", - "locationName":"principalArn" - } - }, - "documentation":"

Contains the parameters for DescribeIdentityIdFormat.

" - }, - "DescribeIdentityIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resources.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdentityIdFormat.

" - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - }, - "documentation":"

Contains the parameters for DescribeImageAttribute.

" - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, self (owner is the sender of the request), or an AWS owner alias (valid values are amazon | aws-marketplace | microsoft). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the EBS volume.

  • block-device-mapping.volume-size - The volume size of the EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the EBS volume (gp2 | io1 | st1 | sc1 | standard).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - String value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeImages.

" - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - }, - "documentation":"

Contains the output of DescribeImages.

" - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import image task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportImageTasks.

" - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportImageTasks.

" - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import snapshot task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportSnapshotTasks.

" - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportSnapshotTasks.

" - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

Note: The enaSupport attribute is not supported at this time.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceAttribute.

" - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code for the scheduled event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • event.not-before - The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • instance-state-code - The code for the instance state, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceStatus.

" - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstanceStatus.

" - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • affinity - The affinity setting for an instance running on a Dedicated Host (default | host).

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • host-id - The ID of the Dedicated Host on which the instance is running, if applicable.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance or a Scheduled Instance (spot | scheduled).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default | host).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface.private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter or tag filters in the same call.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeInstances.

" - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

Zero or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstances.

" - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeInternetGateways.

" - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeInternetGateways.

" - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeKeyPairs.

" - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - }, - "documentation":"

Contains the output of DescribeKeyPairs.

" - }, - "DescribeMovingAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"ValueStringList", - "documentation":"

One or more Elastic IP addresses.

", - "locationName":"publicIp" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • moving-status - The status of the Elastic IP address (MovingToVpc | RestoringToClassic).

", - "locationName":"filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value outside of this range, an error is returned.

Default: If no value is provided, the default is 1000.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeMovingAddresses.

" - }, - "DescribeMovingAddressesResult":{ - "type":"structure", - "members":{ - "MovingAddressStatuses":{ - "shape":"MovingAddressStatusSet", - "documentation":"

The status for each Elastic IP address.

", - "locationName":"movingAddressStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeMovingAddresses.

" - }, - "DescribeNatGatewaysRequest":{ - "type":"structure", - "members":{ - "NatGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more NAT gateway IDs.

", - "locationName":"NatGatewayId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • nat-gateway-id - The ID of the NAT gateway.

  • state - The state of the NAT gateway (pending | failed | available | deleting | deleted).

  • subnet-id - The ID of the subnet in which the NAT gateway resides.

  • vpc-id - The ID of the VPC in which the NAT gateway resides.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeNatGateways.

" - }, - "DescribeNatGatewaysResult":{ - "type":"structure", - "members":{ - "NatGateways":{ - "shape":"NatGatewayList", - "documentation":"

Information about the NAT gateways.

", - "locationName":"natGatewaySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeNatGateways.

" - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkAcls.

" - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkAcls.

" - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.nat-gateway-id - The ID of the NAT gateway to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaces.

" - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaces.

" - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribePlacementGroups.

" - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - }, - "documentation":"

Contains the output of DescribePlacementGroups.

" - }, - "DescribePrefixListsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "PrefixListIds":{ - "shape":"ValueStringList", - "documentation":"

One or more prefix list IDs.

", - "locationName":"PrefixListId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribePrefixLists.

" - }, - "DescribePrefixListsResult":{ - "type":"structure", - "members":{ - "PrefixLists":{ - "shape":"PrefixListSet", - "documentation":"

All available prefix lists.

", - "locationName":"prefixListSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribePrefixLists.

" - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRegions.

" - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - }, - "documentation":"

Contains the output of DescribeRegions.

" - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"filters" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type that the reservation will cover (for example, m1.small). For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from both AWS and the Reserved Instance Marketplace are listed.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC))

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated Instances).

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Reserved Instance Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstances.

" - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - }, - "documentation":"

Contains the output for DescribeReservedInstances.

" - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC (true | false).

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.destination-prefix-list-id - The ID (prefix) of the AWS service specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.nat-gateway-id - The ID of a NAT gateway.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRouteTables.

" - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - }, - "documentation":"

Contains the output of DescribeRouteTables.

" - }, - "DescribeScheduledInstanceAvailabilityRequest":{ - "type":"structure", - "required":[ - "Recurrence", - "FirstSlotStartTimeRange" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrenceRequest", - "documentation":"

The schedule recurrence.

" - }, - "FirstSlotStartTimeRange":{ - "shape":"SlotDateTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "MinSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

" - }, - "MaxSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstanceAvailabilityResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceAvailabilitySet":{ - "shape":"ScheduledInstanceAvailabilitySet", - "documentation":"

Information about the available Scheduled Instances.

", - "locationName":"scheduledInstanceAvailabilitySet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ScheduledInstanceIds":{ - "shape":"ScheduledInstanceIdRequestSet", - "documentation":"

One or more Scheduled Instance IDs.

", - "locationName":"ScheduledInstanceId" - }, - "SlotStartTimeRange":{ - "shape":"SlotStartTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 100. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstances.

" - }, - "DescribeScheduledInstancesResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceSet":{ - "shape":"ScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstances.

" - }, - "DescribeSecurityGroupReferencesRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"GroupIds", - "documentation":"

One or more security group IDs in your account.

" - } - } - }, - "DescribeSecurityGroupReferencesResult":{ - "type":"structure", - "members":{ - "SecurityGroupReferenceSet":{ - "shape":"SecurityGroupReferences", - "documentation":"

Information about the VPCs with the referencing security groups.

", - "locationName":"securityGroupReferenceSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.

  • description - The description of the security group.

  • egress.ip-permission.prefix-list-id - The ID (prefix) of the AWS service to which the security group allows access.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSecurityGroups.

" - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - }, - "documentation":"

Contains the output of DescribeSecurityGroups.

" - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM consolew.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshots.

" - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSnapshots.

" - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotFleetInstancesRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetInstancesResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "ActiveInstances" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. Note that this list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetRequestHistoryRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The type of events to describe. By default, all events are described.

", - "locationName":"eventType" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestHistoryResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime", - "LastEvaluatedTime", - "HistoryRecords" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "HistoryRecords":{ - "shape":"HistoryRecords", - "documentation":"

Information about the events in the history of the Spot fleet request.

", - "locationName":"historyRecordSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "DescribeSpotFleetRequestsResponse":{ - "type":"structure", - "required":["SpotFleetRequestConfigs"], - "members":{ - "SpotFleetRequestConfigs":{ - "shape":"SpotFleetRequestConfigSet", - "documentation":"

Information about the configuration of your Spot fleet.

", - "locationName":"spotFleetRequestConfigSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume: gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1for Cold HDD, or standard for Magnetic.

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m3.medium).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot instance request ID.

  • spot-price - The maximum hourly price for any Spot instance launched to fulfill the request.

  • state - The state of the Spot instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

  • status-code - The short code describing the most recent evaluation of your Spot instance request.

  • status-message - The message explaining the status of the Spot instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m3.medium).

  • product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "DescribeStaleSecurityGroupsRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribeStaleSecurityGroupsResult":{ - "type":"structure", - "members":{ - "StaleSecurityGroupSet":{ - "shape":"StaleSecurityGroupSet", - "documentation":"

Information about the stale security groups.

", - "locationName":"staleSecurityGroupSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSubnets.

" - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - }, - "documentation":"

Contains the output of DescribeSubnets.

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeTags.

" - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeTags.

" - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeAttribute.

" - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeVolumeAttribute.

" - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeStatus.

" - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumeStatus.

" - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeVolumes.

" - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "documentation":"

Information about the volumes.

", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumes.

" - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":[ - "VpcId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcAttribute.

" - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - }, - "documentation":"

Contains the output of DescribeVpcAttribute.

" - }, - "DescribeVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPC IDs.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"ClassicLinkDnsSupportList", - "documentation":"

Information about the ClassicLink DNS support status of the VPCs.

", - "locationName":"vpcs" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLink.

" - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLink.

" - }, - "DescribeVpcEndpointServicesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointServicesResult":{ - "type":"structure", - "members":{ - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

A list of supported AWS services.

", - "locationName":"serviceNameSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the AWS service.

  • vpc-id: The ID of the VPC in which the endpoint resides.

  • vpc-endpoint-id: The ID of the endpoint.

  • vpc-endpoint-state: The state of the endpoint. (pending | available | deleting | deleted)

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpoints.

" - }, - "DescribeVpcEndpointsResult":{ - "type":"structure", - "members":{ - "VpcEndpoints":{ - "shape":"VpcEndpointSet", - "documentation":"

Information about the endpoints.

", - "locationName":"vpcEndpointSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpoints.

" - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcPeeringConnections.

" - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpcPeeringConnections.

" - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcs.

" - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcs.

" - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnConnections.

" - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpnConnections.

" - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway (if applicable).

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnGateways.

" - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeVpnGateways.

" - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachClassicLinkVpc.

" - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DetachClassicLinkVpc.

" - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachInternetGateway.

" - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for DetachNetworkInterface.

" - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - }, - "documentation":"

Contains the parameters for DetachVolume.

" - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DetachVpnGateway.

" - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DisableVgwRoutePropagation.

" - }, - "DisableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLink.

" - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLink.

" - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for DisassociateAddress.

" - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the parameters for DisassociateRouteTable.

" - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

Information about the disk image.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the disk image.

" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

Information about the volume.

" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - }, - "documentation":"

Describes a disk image volume.

" - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type: gp2, io1, st1, sc1, or standard.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes information used to set up an EBS volume specified in a block device mapping.

" - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for EnableVgwRoutePropagation.

" - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Contains the parameters for EnableVolumeIO.

" - }, - "EnableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLink.

" - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLink.

" - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "EventInformation":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This information is available only for instanceChange events.

", - "locationName":"instanceId" - }, - "EventSubType":{ - "shape":"String", - "documentation":"

The event.

The following are the error events.

  • iamFleetRoleInvalid - The Spot fleet did not have the required permissions either to launch or terminate an instance.

  • launchSpecTemporarilyBlacklisted - The configuration is not valid and several attempts to launch instances have failed. For more information, see the description of the event.

  • spotFleetRequestConfigurationInvalid - The configuration is not valid. For more information, see the description of the event.

  • spotInstanceCountLimitExceeded - You've reached the limit on the number of Spot instances that you can launch.

The following are the fleetRequestChange events.

  • active - The Spot fleet has been validated and Amazon EC2 is attempting to maintain the target number of running Spot instances.

  • cancelled - The Spot fleet is canceled and has no running Spot instances. The Spot fleet will be deleted two days after its instances were terminated.

  • cancelled_running - The Spot fleet is canceled and will not launch additional Spot instances, but its existing Spot instances continue to run until they are interrupted or terminated.

  • cancelled_terminating - The Spot fleet is canceled and its Spot instances are terminating.

  • expired - The Spot fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration set.

  • modify_in_progress - A request to modify the Spot fleet request was accepted and is in progress.

  • modify_successful - The Spot fleet request was modified.

  • price_update - The bid price for a launch configuration was adjusted because it was too high. This change is permanent.

  • submitted - The Spot fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot instances.

The following are the instanceChange events.

  • launched - A bid was fulfilled and a new instance was launched.

  • terminated - An instance was terminated by the user.

", - "locationName":"eventSubType" - }, - "EventDescription":{ - "shape":"String", - "documentation":"

The description of the event.

", - "locationName":"eventDescription" - } - }, - "documentation":"

Describes a Spot fleet event.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "instanceChange", - "fleetRequestChange", - "error" - ] - }, - "ExcessCapacityTerminationPolicy":{ - "type":"string", - "enum":[ - "noTermination", - "default" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the export task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

Information about the instance to export.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "documentation":"

Information about the export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The encryption key for your S3 bucket.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the format and location for an instance export task.

" - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FleetType":{ - "type":"string", - "enum":[ - "request", - "maintain" - ] - }, - "Float":{"type":"float"}, - "FlowLog":{ - "type":"structure", - "members":{ - "CreationTime":{ - "shape":"DateTime", - "documentation":"

The date and time the flow log was created.

", - "locationName":"creationTime" - }, - "FlowLogId":{ - "shape":"String", - "documentation":"

The flow log ID.

", - "locationName":"flowLogId" - }, - "FlowLogStatus":{ - "shape":"String", - "documentation":"

The status of the flow log (ACTIVE).

", - "locationName":"flowLogStatus" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource on which the flow log was created.

", - "locationName":"resourceId" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic captured for the flow log.

", - "locationName":"trafficType" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the flow log group.

", - "locationName":"logGroupName" - }, - "DeliverLogsStatus":{ - "shape":"String", - "documentation":"

The status of the logs delivery (SUCCESS | FAILED).

", - "locationName":"deliverLogsStatus" - }, - "DeliverLogsErrorMessage":{ - "shape":"String", - "documentation":"

Information about the error that occurred. Rate limited indicates that CloudWatch logs throttling has been applied for one or more network interfaces, or that you've reached the limit on the number of CloudWatch Logs log groups that you can create. Access error indicates that the IAM role associated with the flow log does not have sufficient permissions to publish to CloudWatch Logs. Unknown error indicates an internal error.

", - "locationName":"deliverLogsErrorMessage" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that posts logs to CloudWatch Logs.

", - "locationName":"deliverLogsPermissionArn" - } - }, - "documentation":"

Describes a flow log.

" - }, - "FlowLogSet":{ - "type":"list", - "member":{ - "shape":"FlowLog", - "locationName":"item" - } - }, - "FlowLogsResourceType":{ - "type":"string", - "enum":[ - "VPC", - "Subnet", - "NetworkInterface" - ] - }, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for GetConsoleOutput.

" - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64-encoded. If using a command line tool, the tool decodes the output for you.

", - "locationName":"output" - } - }, - "documentation":"

Contains the output of GetConsoleOutput.

" - }, - "GetConsoleScreenshotRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "WakeUp":{ - "shape":"Boolean", - "documentation":"

When set to true, acts as keystroke input and wakes up an instance that's in standby or \"sleep\" mode.

" - } - }, - "documentation":"

Contains the parameters for the request.

" - }, - "GetConsoleScreenshotResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageData":{ - "shape":"String", - "documentation":"

The data that comprises the image.

", - "locationName":"imageData" - } - }, - "documentation":"

Contains the output of the request.

" - }, - "GetHostReservationPurchasePreviewRequest":{ - "type":"structure", - "required":[ - "OfferingId", - "HostIdSet" - ], - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The offering ID of the reservation.

" - }, - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The ID/s of the Dedicated Host/s that the reservation will be associated with.

" - } - } - }, - "GetHostReservationPurchasePreviewResult":{ - "type":"structure", - "members":{ - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

The purchase information of the Dedicated Host Reservation and the Dedicated Hosts associated with it.

", - "locationName":"purchase" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The potential total upfront price. This is billed immediately.

", - "locationName":"totalUpfrontPrice" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The potential total hourly price of the reservation per hour.

", - "locationName":"totalHourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - }, - "documentation":"

Contains the parameters for GetPasswordData.

" - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - }, - "documentation":"

Contains the output of GetPasswordData.

" - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupIds":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HistoryRecord":{ - "type":"structure", - "required":[ - "Timestamp", - "EventType", - "EventInformation" - ], - "members":{ - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

  • error - Indicates an error with the Spot fleet request.

  • fleetRequestChange - Indicates a change in the status or configuration of the Spot fleet request.

  • instanceChange - Indicates that an instance was launched or terminated.

", - "locationName":"eventType" - }, - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - } - }, - "documentation":"

Describes an event in the history of the Spot fleet request.

" - }, - "HistoryRecords":{ - "type":"list", - "member":{ - "shape":"HistoryRecord", - "locationName":"item" - } - }, - "Host":{ - "type":"structure", - "members":{ - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Whether auto-placement is on or off.

", - "locationName":"autoPlacement" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The reservation ID of the Dedicated Host. This returns a null response if the Dedicated Host doesn't have an associated reservation.

", - "locationName":"hostReservationId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "HostProperties":{ - "shape":"HostProperties", - "documentation":"

The hardware specifications of the Dedicated Host.

", - "locationName":"hostProperties" - }, - "State":{ - "shape":"AllocationState", - "documentation":"

The Dedicated Host's state.

", - "locationName":"state" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the Dedicated Host.

", - "locationName":"availabilityZone" - }, - "Instances":{ - "shape":"HostInstanceList", - "documentation":"

The IDs and instance type that are currently running on the Dedicated Host.

", - "locationName":"instances" - }, - "AvailableCapacity":{ - "shape":"AvailableCapacity", - "documentation":"

The number of new instances that can be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - } - }, - "documentation":"

Describes the properties of the Dedicated Host.

" - }, - "HostInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

the IDs of instances that are running on the Dedicated Host.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size (for example, m3.medium) of the running instance.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes an instance running on a Dedicated Host.

" - }, - "HostInstanceList":{ - "type":"list", - "member":{ - "shape":"HostInstance", - "locationName":"item" - } - }, - "HostList":{ - "type":"list", - "member":{ - "shape":"Host", - "locationName":"item" - } - }, - "HostOffering":{ - "type":"structure", - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

", - "locationName":"offeringId" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the offering.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The available payment option.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the offering. Does not apply to No Upfront offerings.

", - "locationName":"upfrontPrice" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the offering.

", - "locationName":"hourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the offering.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering (in seconds).

", - "locationName":"duration" - } - }, - "documentation":"

Details about the Dedicated Host Reservation offering.

" - }, - "HostOfferingSet":{ - "type":"list", - "member":{"shape":"HostOffering"} - }, - "HostProperties":{ - "type":"structure", - "members":{ - "Sockets":{ - "shape":"Integer", - "documentation":"

The number of sockets on the Dedicated Host.

", - "locationName":"sockets" - }, - "Cores":{ - "shape":"Integer", - "documentation":"

The number of cores on the Dedicated Host.

", - "locationName":"cores" - }, - "TotalVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs on the Dedicated Host.

", - "locationName":"totalVCpus" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size that the Dedicated Host supports (for example, m3.medium).

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes properties of a Dedicated Host.

" - }, - "HostReservation":{ - "type":"structure", - "members":{ - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation that specifies the associated Dedicated Hosts.

", - "locationName":"hostReservationId" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation. This remains the same regardless of which Dedicated Hosts are associated with it.

", - "locationName":"offeringId" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the Dedicated Host Reservation. The instance family on the Dedicated Host must be the same in order for it to benefit from the reservation.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option selected for this reservation.

", - "locationName":"paymentOption" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation.

", - "locationName":"hourlyPrice" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the upfrontPrice and hourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts the reservation is associated with.

", - "locationName":"count" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The length of the reservation's term, specified in seconds. Can be 31536000 (1 year) | 94608000 (3 years).

", - "locationName":"duration" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation ends.

", - "locationName":"end" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation started.

", - "locationName":"start" - }, - "State":{ - "shape":"ReservationState", - "documentation":"

The state of the reservation.

", - "locationName":"state" - } - }, - "documentation":"

Details about the Dedicated Host Reservation and associated Dedicated Hosts.

" - }, - "HostReservationIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "HostReservationSet":{ - "type":"list", - "member":{"shape":"HostReservation"} - }, - "HostTenancy":{ - "type":"string", - "enum":[ - "dedicated", - "host" - ] - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "IdFormat":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether longer IDs (17-character IDs) are enabled for the resource.

", - "locationName":"useLongIds" - }, - "Deadline":{ - "shape":"DateTime", - "documentation":"

The date in UTC at which you are permanently switched over to using longer IDs. If a deadline is not yet available for this resource type, this field is not returned.

", - "locationName":"deadline" - } - }, - "documentation":"

Describes the ID format for a resource.

" - }, - "IdFormatList":{ - "type":"list", - "member":{ - "shape":"IdFormat", - "locationName":"item" - } - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the disk.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to be used for importing the snapshot.

" - } - }, - "documentation":"

Describes the disk container object for an import image task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task.

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "documentation":"

Information about the disk containers.

", - "locationName":"DiskContainer" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing.

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.

Valid values: AWS | BYOL

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform.

Valid values: xen

" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

Valid values: Windows | Linux

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportImage.

" - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) created by the import task.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output for ImportImage.

" - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor for the import task.

Valid values: xen

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the import image task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the import image task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import image task.

", - "locationName":"status" - } - }, - "documentation":"

Describes an import image task.

" - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

The user data to make available to the instance. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information about the instance types that you can import, see Instance Types in the VM Import/Export User Guide.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] An available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes the launch specification for VM import.

" - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

The launch specification.

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "documentation":"

The disk image.

", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - }, - "documentation":"

Contains the parameters for ImportInstance.

" - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportInstance.

" - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "documentation":"

One or more volumes.

", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import instance task.

" - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. For API calls, the text must be base64-encoded. For command line tools, base64 encoding is performed for you.

", - "locationName":"publicKeyMaterial" - } - }, - "documentation":"

Contains the parameters for ImportKeyPair.

" - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Contains the output of ImportKeyPair.

" - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description string for the import snapshot task.

" - }, - "DiskContainer":{ - "shape":"SnapshotDiskContainer", - "documentation":"

Information about the disk container.

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportSnapshot.

" - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Information about the import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Contains the output for ImportSnapshot.

" - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Describes an import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import snapshot task.

" - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

The disk image.

", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the volume.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

The volume size.

", - "locationName":"volume" - } - }, - "documentation":"

Contains the parameters for ImportVolume.

" - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportVolume.

" - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance, if applicable.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched, if applicable.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance, if applicable.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance, if applicable.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance, if applicable.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot instance or a Scheduled Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

If the request is a Spot instance request, the ID of the request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance, if applicable.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance, if applicable.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport", - "enaSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCapacity":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size supported by the Dedicated Host.

", - "locationName":"instanceType" - }, - "AvailableCapacity":{ - "shape":"Integer", - "documentation":"

The number of instances that can still be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - }, - "TotalCapacity":{ - "shape":"Integer", - "documentation":"

The total number of instances that can be launched onto the Dedicated Host.

", - "locationName":"totalCapacity" - } - }, - "documentation":"

Information about the instance type that the Dedicated Host supports.

" - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance to export.

" - }, - "InstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":[ - "spot", - "scheduled" - ] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Any scheduled events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The event code.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes a scheduled event for an instance.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "t2.nano", - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "x1.4xlarge", - "x1.8xlarge", - "x1.16xlarge", - "x1.32xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "g2.8xlarge", - "cg1.4xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

[EC2-VPC only] When you authorize or revoke security group rules, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdList", - "documentation":"

(Valid for AuthorizeSecurityGroupEgress, RevokeSecurityGroupEgress and DescribeSecurityGroups only) One or more prefix list IDs for an AWS service. In an AuthorizeSecurityGroupEgress request, this is the AWS service that you want to access through a VPC endpoint from instances associated with the security group.

", - "locationName":"prefixListIds" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "IpRanges":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "LaunchSpecsList":{ - "type":"list", - "member":{ - "shape":"SpotFleetLaunchSpecification", - "locationName":"item" - }, - "min":1 - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "max":255, - "min":5 - }, - "ModifyHostsRequest":{ - "type":"structure", - "required":[ - "HostIds", - "AutoPlacement" - ], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The host IDs of the Dedicated Hosts you want to modify.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Specify whether to enable or disable auto-placement.

", - "locationName":"autoPlacement" - } - }, - "documentation":"

Contains the parameters for ModifyHosts.

" - }, - "ModifyHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully modified.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ModifyHosts.

" - }, - "ModifyIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicate whether the resource should use longer IDs (17-character IDs).

" - } - }, - "documentation":"

Contains the parameters of ModifyIdFormat.

" - }, - "ModifyIdentityIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds", - "PrincipalArn" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether the resource should use longer IDs (17-character IDs)

", - "locationName":"useLongIds" - }, - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

", - "locationName":"principalArn" - } - }, - "documentation":"

Contains the parameters of ModifyIdentityIdFormat.

" - }, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - }, - "documentation":"

Contains the parameters for ModifyImageAttribute.

" - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or instanceInitiatedShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. You cannot use this paramater for Spot Instances.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the instance.

There is no way to disable enhanced networking with the Intel 82599 Virtual Function interface at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Set to true to enable enhanced networking with ENA for the instance.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Contains the parameters for ModifyInstanceAttribute.

" - }, - "ModifyInstancePlacementRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that you are modifying.

", - "locationName":"instanceId" - }, - "Tenancy":{ - "shape":"HostTenancy", - "documentation":"

The tenancy of the instance that you are modifying.

", - "locationName":"tenancy" - }, - "Affinity":{ - "shape":"Affinity", - "documentation":"

The new affinity setting for the instance.

", - "locationName":"affinity" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host that the instance will have affinity with.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ModifyInstancePlacement.

" - }, - "ModifyInstancePlacementResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyInstancePlacement.

" - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the parameters for ModifyNetworkInterfaceAttribute.

" - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - }, - "documentation":"

Contains the parameters for ModifyReservedInstances.

" - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - }, - "documentation":"

Contains the output of ModifyReservedInstances.

" - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

Only volume creation permissions may be modified at the customer level.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - }, - "documentation":"

Contains the parameters for ModifySnapshotAttribute.

" - }, - "ModifySpotFleetRequestRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The size of the fleet.

", - "locationName":"targetCapacity" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - } - }, - "documentation":"

Contains the parameters for ModifySpotFleetRequest.

" - }, - "ModifySpotFleetRequestResponse":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifySpotFleetRequest.

" - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - }, - "documentation":"

Contains the parameters for ModifySubnetAttribute.

" - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - }, - "documentation":"

Contains the parameters for ModifyVolumeAttribute.

" - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute. You can only enable DNS hostnames if you've enabled DNS support.

" - } - }, - "documentation":"

Contains the parameters for ModifyVpcAttribute.

" - }, - "ModifyVpcEndpointRequest":{ - "type":"structure", - "required":["VpcEndpointId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ResetPolicy":{ - "shape":"Boolean", - "documentation":"

Specify true to reset the policy document to the default policy. The default policy allows access to the service.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy document to attach to the endpoint. The policy must be in valid JSON format.

" - }, - "AddRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables IDs to associate with the endpoint.

", - "locationName":"AddRouteTableId" - }, - "RemoveRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs to disassociate from the endpoint.

", - "locationName":"RemoveRouteTableId" - } - }, - "documentation":"

Contains the parameters for ModifyVpcEndpoint.

" - }, - "ModifyVpcEndpointResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyVpcEndpoint.

" - }, - "ModifyVpcPeeringConnectionOptionsRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

" - }, - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the requester VPC.

" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the accepter VPC.

" - } - } - }, - "ModifyVpcPeeringConnectionOptionsResult":{ - "type":"structure", - "members":{ - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the requester VPC.

", - "locationName":"requesterPeeringConnectionOptions" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the accepter VPC.

", - "locationName":"accepterPeeringConnectionOptions" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for MonitorInstances.

" - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of MonitorInstances.

" - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "MoveAddressToVpcRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for MoveAddressToVpc.

" - }, - "MoveAddressToVpcResult":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID for the Elastic IP address.

", - "locationName":"allocationId" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the move of the IP address.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output of MoveAddressToVpc.

" - }, - "MoveStatus":{ - "type":"string", - "enum":[ - "movingToVpc", - "restoringToClassic" - ] - }, - "MovingAddressStatus":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "MoveStatus":{ - "shape":"MoveStatus", - "documentation":"

The status of the Elastic IP address that's being moved to the EC2-VPC platform, or restored to the EC2-Classic platform.

", - "locationName":"moveStatus" - } - }, - "documentation":"

Describes the status of a moving Elastic IP address.

" - }, - "MovingAddressStatusSet":{ - "type":"list", - "member":{ - "shape":"MovingAddressStatus", - "locationName":"item" - } - }, - "NatGateway":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the NAT gateway is located.

", - "locationName":"vpcId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the NAT gateway is located.

", - "locationName":"subnetId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was created.

", - "locationName":"createTime" - }, - "DeleteTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was deleted, if applicable.

", - "locationName":"deleteTime" - }, - "NatGatewayAddresses":{ - "shape":"NatGatewayAddressList", - "documentation":"

Information about the IP addresses and network interface associated with the NAT gateway.

", - "locationName":"natGatewayAddressSet" - }, - "State":{ - "shape":"NatGatewayState", - "documentation":"

The state of the NAT gateway.

  • pending: The NAT gateway is being created and is not ready to process traffic.

  • failed: The NAT gateway could not be created. Check the failureCode and failureMessage fields for the reason.

  • available: The NAT gateway is able to process traffic. This status remains until you delete the NAT gateway, and does not indicate the health of the NAT gateway.

  • deleting: The NAT gateway is in the process of being terminated and may still be processing traffic.

  • deleted: The NAT gateway has been terminated and is no longer processing traffic.

", - "locationName":"state" - }, - "FailureCode":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error code for the failure. (InsufficientFreeAddressesInSubnet | Gateway.NotAttached | InvalidAllocationID.NotFound | Resource.AlreadyAssociated | InternalError | InvalidSubnetID.NotFound)

", - "locationName":"failureCode" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error message for the failure, that corresponds to the error code.

  • For InsufficientFreeAddressesInSubnet: \"Subnet has insufficient free addresses to create this NAT gateway\"

  • For Gateway.NotAttached: \"Network vpc-xxxxxxxx has no Internet gateway attached\"

  • For InvalidAllocationID.NotFound: \"Elastic IP address eipalloc-xxxxxxxx could not be associated with this NAT gateway\"

  • For Resource.AlreadyAssociated: \"Elastic IP address eipalloc-xxxxxxxx is already associated\"

  • For InternalError: \"Network interface eni-xxxxxxxx, created and used internally by this NAT gateway is in an invalid state. Please try again.\"

  • For InvalidSubnetID.NotFound: \"The specified subnet subnet-xxxxxxxx does not exist or could not be found.\"

", - "locationName":"failureMessage" - }, - "ProvisionedBandwidth":{ - "shape":"ProvisionedBandwidth", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionedBandwidth" - } - }, - "documentation":"

Describes a NAT gateway.

" - }, - "NatGatewayAddress":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address associated with the NAT gateway.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of the Elastic IP address that's associated with the NAT gateway.

", - "locationName":"allocationId" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIp" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface associated with the NAT gateway.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Describes the IP addresses and network interface associated with a NAT gateway.

" - }, - "NatGatewayAddressList":{ - "type":"list", - "member":{ - "shape":"NatGatewayAddress", - "locationName":"item" - } - }, - "NatGatewayList":{ - "type":"list", - "member":{ - "shape":"NatGateway", - "locationName":"item" - } - }, - "NatGatewayState":{ - "type":"string", - "enum":[ - "pending", - "failed", - "available", - "deleting", - "deleted" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - }, - "InterfaceType":{ - "shape":"NetworkInterfaceType", - "documentation":"

The type of interface.

", - "locationName":"interfaceType" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "NetworkInterfaceType":{ - "type":"string", - "enum":[ - "interface", - "natGateway" - ] - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "OccurrenceDayRequestSet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"OccurenceDay" - } - }, - "OccurrenceDaySet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"item" - } - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OperationType":{ - "type":"string", - "enum":[ - "add", - "remove" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PaymentOption":{ - "type":"string", - "enum":[ - "AllUpfront", - "PartialUpfront", - "NoUpfront" - ] - }, - "PeeringConnectionOptions":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "PeeringConnectionOptionsRequest":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

" - } - }, - "documentation":"

The VPC peering connection options.

" - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. The host tenancy is not supported for the ImportInstance command.

", - "locationName":"tenancy" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicted host on which the instance resides. This parameter is not support for the ImportInstance command.

", - "locationName":"hostId" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for the instance on the Dedicated Host. This parameter is not supported for the ImportInstance command.

", - "locationName":"affinity" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PrefixList":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - }, - "PrefixListName":{ - "shape":"String", - "documentation":"

The name of the prefix.

", - "locationName":"prefixListName" - }, - "Cidrs":{ - "shape":"ValueStringList", - "documentation":"

The IP address range of the AWS service.

", - "locationName":"cidrSet" - } - }, - "documentation":"

Describes prefixes for AWS services.

" - }, - "PrefixListId":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - } - }, - "documentation":"

The ID of the prefix.

" - }, - "PrefixListIdList":{ - "type":"list", - "member":{ - "shape":"PrefixListId", - "locationName":"item" - } - }, - "PrefixListIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "PrefixListSet":{ - "type":"list", - "member":{ - "shape":"PrefixList", - "locationName":"item" - } - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of reservations available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressConfigSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesPrivateIpAddressConfig", - "locationName":"PrivateIpAddressConfigSet" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "ProvisionedBandwidth":{ - "type":"structure", - "members":{ - "Provisioned":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisioned" - }, - "Requested":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requested" - }, - "RequestTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requestTime" - }, - "ProvisionTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionTime" - }, - "Status":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"status" - } - }, - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

" - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "Purchase":{ - "type":"structure", - "members":{ - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"hostReservationId" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family on the Dedicated Host that the reservation can be associated with.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option for the reservation.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation per hour.

", - "locationName":"hourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the UpfrontPrice and HourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation's term in seconds.

", - "locationName":"duration" - } - }, - "documentation":"

Describes the result of the purchase.

" - }, - "PurchaseHostReservationRequest":{ - "type":"structure", - "required":[ - "OfferingId", - "HostIdSet" - ], - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

" - }, - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The ID/s of the Dedicated Host/s that the reservation will be associated with.

" - }, - "LimitPrice":{ - "shape":"String", - "documentation":"

The specified limit is checked against the total upfront cost of the reservation (calculated as the offering's upfront cost multiplied by the host count). If the total upfront cost is greater than the specified price limit, the request will fail. This is used to ensure that the purchase does not exceed the expected upfront cost of the purchase. At this time, the only supported currency is USD. For example, to indicate a limit price of USD 100, specify 100.00.

" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice, LimitPrice, and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - } - } - }, - "PurchaseHostReservationResult":{ - "type":"structure", - "members":{ - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

Describes the details of the purchase.

", - "locationName":"purchase" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The total amount that will be charged to your account when you purchase the reservation.

", - "locationName":"totalUpfrontPrice" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The total hourly price of the reservation calculated per hour.

", - "locationName":"totalHourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide

", - "locationName":"clientToken" - } - } - }, - "PurchaseRequest":{ - "type":"structure", - "required":[ - "PurchaseToken", - "InstanceCount" - ], - "members":{ - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

" - } - }, - "documentation":"

Describes a request to purchase Scheduled Instances.

" - }, - "PurchaseRequestSet":{ - "type":"list", - "member":{ - "shape":"PurchaseRequest", - "locationName":"PurchaseRequest" - }, - "min":1 - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - }, - "documentation":"

Contains the parameters for PurchaseReservedInstancesOffering.

" - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Contains the output of PurchaseReservedInstancesOffering.

" - }, - "PurchaseScheduledInstancesRequest":{ - "type":"structure", - "required":["PurchaseRequests"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "PurchaseRequests":{ - "shape":"PurchaseRequestSet", - "documentation":"

One or more purchase requests.

", - "locationName":"PurchaseRequest" - } - }, - "documentation":"

Contains the parameters for PurchaseScheduledInstances.

" - }, - "PurchaseScheduledInstancesResult":{ - "type":"structure", - "members":{ - "ScheduledInstanceSet":{ - "shape":"PurchasedScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of PurchaseScheduledInstances.

" - }, - "PurchaseSet":{ - "type":"list", - "member":{"shape":"Purchase"} - }, - "PurchasedScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for RebootInstances.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the AMI and any instances that you launch from the AMI.

There is no way to disable sriovNetSupport at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Set to true to enable enhanced networking with ENA for the AMI and any instances that you launch from the AMI.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Contains the parameters for RegisterImage.

" - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of RegisterImage.

" - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for RejectVpcPeeringConnection.

" - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of RejectVpcPeeringConnection.

" - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for ReleaseAddress.

" - }, - "ReleaseHostsRequest":{ - "type":"structure", - "required":["HostIds"], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts you want to release.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ReleaseHosts.

" - }, - "ReleaseHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully released.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be released, including an error message.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ReleaseHosts.

" - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclEntry.

" - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for ReplaceRoute.

" - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for ReplaceRouteTableAssociation.

" - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceRouteTableAssociation.

" - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - }, - "documentation":"

Contains the parameters for ReportInstanceStatus.

" - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestSpotFleetRequest":{ - "type":"structure", - "required":["SpotFleetRequestConfig"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration for the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "RequestSpotFleetResponse":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

The duration period starts as soon as your Spot instance receives its instance ID. At the end of the duration period, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates.

Note that you can't specify an Availability Zone group or a launch group if you specify a duration.

", - "locationName":"blockDurationMinutes" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - }, - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

[EC2-Classic only] One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservationState":{ - "type":"string", - "enum":[ - "payment-pending", - "payment-failed", - "active", - "retired" - ] - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reservations purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - }, - "documentation":"

Describes the modification request/s.

" - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - }, - "documentation":"

Contains the parameters for ResetImageAttribute.

" - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

You can only reset the following attributes: kernel | ramdisk | sourceDestCheck. To change an instance attribute, use ModifyInstanceAttribute.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for ResetInstanceAttribute.

" - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the parameters for ResetNetworkInterfaceAttribute.

" - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.

" - } - }, - "documentation":"

Contains the parameters for ResetSnapshotAttribute.

" - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "ResponseHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ResponseHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RestoreAddressToClassicRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for RestoreAddressToClassic.

" - }, - "RestoreAddressToClassicResult":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

The move status for the IP address.

", - "locationName":"status" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the output of RestoreAddressToClassic.

" - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupEgress.

" - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a security group in a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account ID of the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupIngress.

" - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationPrefixListId":{ - "shape":"String", - "documentation":"

The prefix of the AWS service.

", - "locationName":"destinationPrefixListId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable - The route was automatically created when the route table was created.

  • CreateRoute - The route was manually added to the route table.

  • EnableVgwRoutePropagation - The route was propagated by route propagation.

", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet. A subnet ID is not returned for an implicit association.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instance. For more information, see Running Commands on Your Linux Instance at Launch (Linux) and Adding User Data (Windows). If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

Supplying both a snapshot ID and an encryption value as arguments for block-device mapping results in an error. This is because only blank volumes can be encrypted on start, and these are not created from a snapshot. If a snapshot is the basis for the volume, it contains data by definition and its encryption status cannot be changed using this action.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - }, - "documentation":"

Contains the parameters for RunInstances.

" - }, - "RunScheduledInstancesRequest":{ - "type":"structure", - "required":[ - "ScheduledInstanceId", - "LaunchSpecification" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

Default: 1

" - }, - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

" - }, - "LaunchSpecification":{ - "shape":"ScheduledInstancesLaunchSpecification", - "documentation":"

The launch specification. You must match the instance type, Availability Zone, network, and platform of the schedule that you purchased.

" - } - }, - "documentation":"

Contains the parameters for RunScheduledInstances.

" - }, - "RunScheduledInstancesResult":{ - "type":"structure", - "members":{ - "InstanceIdSet":{ - "shape":"InstanceIdSet", - "documentation":"

The IDs of the newly launched instances.

", - "locationName":"instanceIdSet" - } - }, - "documentation":"

Contains the output of RunScheduledInstances.

" - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "ScheduledInstance":{ - "type":"structure", - "members":{ - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

", - "locationName":"scheduledInstanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "PreviousSlotEndTime":{ - "shape":"DateTime", - "documentation":"

The time that the previous schedule ended or will end.

", - "locationName":"previousSlotEndTime" - }, - "NextSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time for the next schedule to start.

", - "locationName":"nextSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

", - "locationName":"instanceCount" - }, - "TermStartDate":{ - "shape":"DateTime", - "documentation":"

The start date for the Scheduled Instance.

", - "locationName":"termStartDate" - }, - "TermEndDate":{ - "shape":"DateTime", - "documentation":"

The end date for the Scheduled Instance.

", - "locationName":"termEndDate" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The date when the Scheduled Instance was purchased.

", - "locationName":"createDate" - } - }, - "documentation":"

Describes a Scheduled Instance.

" - }, - "ScheduledInstanceAvailability":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type. You can specify one of the C3, C4, M4, or R3 instance types.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token. This token expires in two hours.

", - "locationName":"purchaseToken" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "FirstSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time period for the first schedule to start.

", - "locationName":"firstSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "AvailableInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of available instances.

", - "locationName":"availableInstanceCount" - }, - "MinTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The minimum term. The only possible value is 365 days.

", - "locationName":"minTermDurationInDays" - }, - "MaxTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The maximum term. The only possible value is 365 days.

", - "locationName":"maxTermDurationInDays" - } - }, - "documentation":"

Describes a schedule that is available for your Scheduled Instances.

" - }, - "ScheduledInstanceAvailabilitySet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstanceAvailability", - "locationName":"item" - } - }, - "ScheduledInstanceIdRequestSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ScheduledInstanceId" - } - }, - "ScheduledInstanceRecurrence":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

", - "locationName":"frequency" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of frequency. For example, every 2 weeks or every 2 months.

", - "locationName":"interval" - }, - "OccurrenceDaySet":{ - "shape":"OccurrenceDaySet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday).

", - "locationName":"occurrenceDaySet" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month.

", - "locationName":"occurrenceRelativeToEnd" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for occurrenceDaySet (DayOfWeek or DayOfMonth).

", - "locationName":"occurrenceUnit" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceRecurrenceRequest":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of Frequency. For example, every 2 weeks or every 2 months.

" - }, - "OccurrenceDays":{ - "shape":"OccurrenceDayRequestSet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday). You can't specify this value with a daily schedule. If the occurrence is relative to the end of the month, you can specify only a single day.

", - "locationName":"OccurrenceDay" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month. You can't specify this value with a daily schedule.

" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for OccurrenceDays (DayOfWeek or DayOfMonth). This value is required for a monthly schedule. You can't specify DayOfWeek with a weekly schedule. You can't specify this value with a daily schedule.

" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "ScheduledInstancesBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with two available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

" - }, - "Ebs":{ - "shape":"ScheduledInstancesEbs", - "documentation":"

Parameters used to set up EBS volumes automatically when the instance is launched.

" - } - }, - "documentation":"

Describes a block device mapping for a Scheduled Instance.

" - }, - "ScheduledInstancesBlockDeviceMappingSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesBlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "ScheduledInstancesEbs":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, Throughput Optimized HDD for st1, Cold HDD for sc1, or standard for Magnetic.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about gp2 baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is encrypted. You can attached encrypted volumes only to instances that support them.

" - } - }, - "documentation":"

Describes an EBS volume for a Scheduled Instance.

" - }, - "ScheduledInstancesIamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN).

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name.

" - } - }, - "documentation":"

Describes an IAM instance profile for a Scheduled Instance.

" - }, - "ScheduledInstancesLaunchSpecification":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI).

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - }, - "SecurityGroupIds":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The base64-encoded MIME user data.

" - }, - "Placement":{ - "shape":"ScheduledInstancesPlacement", - "documentation":"

The placement information.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

" - }, - "BlockDeviceMappings":{ - "shape":"ScheduledInstancesBlockDeviceMappingSet", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"ScheduledInstancesMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

" - }, - "NetworkInterfaces":{ - "shape":"ScheduledInstancesNetworkInterfaceSet", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"ScheduledInstancesIamInstanceProfile", - "documentation":"

The IAM instance profile.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

" - } - }, - "documentation":"

Describes the launch specification for a Scheduled Instance.

If you are launching the Scheduled Instance in EC2-VPC, you must specify the ID of the subnet. You can specify the subnet using either SubnetId or NetworkInterface.

" - }, - "ScheduledInstancesMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

" - } - }, - "documentation":"

Describes whether monitoring is enabled for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

" - }, - "PrivateIpAddressConfigs":{ - "shape":"PrivateIpAddressConfigSet", - "documentation":"

The private IP addresses.

", - "locationName":"PrivateIpAddressConfig" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses.

" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to instances launched in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

" - }, - "Groups":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"Group" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether to delete the interface when the instance is terminated.

" - } - }, - "documentation":"

Describes a network interface for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterfaceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesNetworkInterface", - "locationName":"NetworkInterface" - } - }, - "ScheduledInstancesPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

" - } - }, - "documentation":"

Describes the placement for a Scheduled Instance.

" - }, - "ScheduledInstancesPrivateIpAddressConfig":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address.

" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is a primary IP address. Otherwise, this is a secondary IP address.

" - } - }, - "documentation":"

Describes a private IP address for a Scheduled Instance.

" - }, - "ScheduledInstancesSecurityGroupIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupReference":{ - "type":"structure", - "required":[ - "GroupId", - "ReferencingVpcId" - ], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of your security group.

", - "locationName":"groupId" - }, - "ReferencingVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with the referencing security group.

", - "locationName":"referencingVpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC with a security group that references your security group.

" - }, - "SecurityGroupReferences":{ - "type":"list", - "member":{ - "shape":"SecurityGroupReference", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "SlotDateTimeRangeRequest":{ - "type":"structure", - "required":[ - "EarliestTime", - "LatestTime" - ], - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start. This value must be later than or equal to the earliest date and at most three months in the future.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule. The time period must span less than one day.

" - }, - "SlotStartTimeRangeRequest":{ - "type":"structure", - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule.

" - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume that was used to create the snapshot. Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"statusMessage" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - }, - "DataEncryptionKeyId":{ - "shape":"String", - "documentation":"

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"dataEncryptionKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - } - }, - "documentation":"

Describes the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - } - }, - "documentation":"

The disk container object for the import snapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the import snapshot task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the import snapshot task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import snapshot task.

", - "locationName":"status" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot instance.

" - }, - "SpotFleetLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "Monitoring":{ - "shape":"SpotFleetMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances. To specify multiple subnets, separate them using commas; for example, \"subnet-a61dafcf, subnet-65ea5f08\".

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

", - "locationName":"weightedCapacity" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour for the specified instance type. If this value is not specified, the default is the Spot bid price specified for the fleet. To determine the bid price per unit hour, divide the Spot bid price by the value of WeightedCapacity.

", - "locationName":"spotPrice" - } - }, - "documentation":"

Describes the launch specification for one or more Spot instances.

" - }, - "SpotFleetMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Enables monitoring for the instance.

Default: false

", - "locationName":"enabled" - } - }, - "documentation":"

Describes whether monitoring is enabled.

" - }, - "SpotFleetRequestConfig":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "SpotFleetRequestState", - "SpotFleetRequestConfig", - "CreateTime" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "SpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The state of the Spot fleet request.

", - "locationName":"spotFleetRequestState" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

Information about the configuration of the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The creation date and time of the request.

", - "locationName":"createTime" - }, - "ActivityStatus":{ - "shape":"ActivityStatus", - "documentation":"

The progress of the Spot fleet request. If there is an error, the status is error. After all bids are placed, the status is pending_fulfillment. If the size of the fleet is equal to or greater than its target capacity, the status is fulfilled. If the size of the fleet is decreased, the status is pending_termination while Spot instances are terminating.

", - "locationName":"activityStatus" - } - }, - "documentation":"

Describes a Spot fleet request.

" - }, - "SpotFleetRequestConfigData":{ - "type":"structure", - "required":[ - "SpotPrice", - "TargetCapacity", - "IamFleetRole", - "LaunchSpecifications" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour.

", - "locationName":"spotPrice" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O.

", - "locationName":"targetCapacity" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot instance requests are placed or enabled to fulfill the request.

", - "locationName":"validUntil" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running Spot instances should be terminated when the Spot fleet request expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "IamFleetRole":{ - "shape":"String", - "documentation":"

Grants the Spot fleet permission to terminate Spot instances on your behalf when you cancel its Spot fleet request using CancelSpotFleetRequests or when the Spot fleet request expires, if you set terminateInstancesWithExpiration.

", - "locationName":"iamFleetRole" - }, - "LaunchSpecifications":{ - "shape":"LaunchSpecsList", - "documentation":"

Information about the launch specifications for the Spot fleet request.

", - "locationName":"launchSpecifications" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "AllocationStrategy":{ - "shape":"AllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot fleet request. The default is lowestPrice.

", - "locationName":"allocationStrategy" - }, - "FulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target capacity.

", - "locationName":"fulfilledCapacity" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the fleet will only request the target capacity or also attempt to maintain it. When you request a certain target capacity, the fleet will only place the required bids. It will not attempt to replenish Spot instances if capacity is diminished, nor will it submit bids in alternative Spot pools if capacity is not available. When you want to maintain a certain target capacity, fleet will place the required bids to meet this target capacity. It will also automatically replenish any interrupted instances. Default: maintain.

", - "locationName":"type" - } - }, - "documentation":"

Describes the configuration of a Spot fleet request.

" - }, - "SpotFleetRequestConfigSet":{ - "type":"list", - "member":{ - "shape":"SpotFleetRequestConfig", - "locationName":"item" - } - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for the Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot instance request. Spot bid status information can help you track your Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, it remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot instance requests, all Spot instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when the Spot instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot instance.

", - "locationName":"productDescription" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The duration for the Spot instance, in minutes.

", - "locationName":"blockDurationMinutes" - }, - "ActualBlockHourlyPrice":{ - "shape":"String", - "documentation":"

If you specified a duration and your Spot instance request was fulfilled, this is the fixed hourly price in effect for the Spot instance while it runs.

", - "locationName":"actualBlockHourlyPrice" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describes a Spot instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code. For a list of status codes, see Spot Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The date and time of the most recent status update, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

[Spot fleet only] To specify multiple Availability Zones, separate them using commas; for example, \"us-west-2a, us-west-2b\".

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StaleIpPermission":{ - "type":"structure", - "members":{ - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

", - "locationName":"ipProtocol" - }, - "IpRanges":{ - "shape":"IpRanges", - "documentation":"

One or more IP ranges. Not applicable for stale security group rules.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdSet", - "documentation":"

One or more prefix list IDs for an AWS service. Not applicable for stale security group rules.

", - "locationName":"prefixListIds" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairSet", - "documentation":"

One or more security group pairs. Returns the ID of the referenced security group and VPC, and the ID and status of the VPC peering connection.

", - "locationName":"groups" - } - }, - "documentation":"

Describes a stale rule in a security group.

" - }, - "StaleIpPermissionSet":{ - "type":"list", - "member":{ - "shape":"StaleIpPermission", - "locationName":"item" - } - }, - "StaleSecurityGroup":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the security group.

", - "locationName":"description" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "StaleIpPermissions":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale inbound rules in the security group.

", - "locationName":"staleIpPermissions" - }, - "StaleIpPermissionsEgress":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale outbound rules in the security group.

", - "locationName":"staleIpPermissionsEgress" - } - }, - "documentation":"

Describes a stale security group (a security group that contains stale rules).

" - }, - "StaleSecurityGroupSet":{ - "type":"list", - "member":{ - "shape":"StaleSecurityGroup", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for StartInstances.

" - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StartInstances.

" - }, - "State":{ - "type":"string", - "enum":[ - "Pending", - "Available", - "Deleting", - "Deleted" - ] - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your limits.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "Status":{ - "type":"string", - "enum":[ - "MoveInProgress", - "InVpc", - "InClassic" - ] - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data", - "initializing" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for StopInstances.

" - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StopInstances.

" - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable", - "initializing" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated", - "host" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for TerminateInstances.

" - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of TerminateInstances.

" - }, - "TrafficType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT", - "ALL" - ] - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Contains the parameters for UnassignPrivateIpAddresses.

" - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for UnmonitorInstances.

" - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of UnmonitorInstances.

" - }, - "UnsuccessfulItem":{ - "type":"structure", - "required":["Error"], - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource.

", - "locationName":"resourceId" - }, - "Error":{ - "shape":"UnsuccessfulItemError", - "documentation":"

Information about the error.

", - "locationName":"error" - } - }, - "documentation":"

Information about items that were not successfully processed in a batch call.

" - }, - "UnsuccessfulItemError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message accompanying the error code.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error that occurred. For more information about errors, see Error Codes.

" - }, - "UnsuccessfulItemList":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UnsuccessfulItemSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "documentation":"

The user data. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"data" - } - }, - "documentation":"

Describes the user data for an instance.

" - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. For a referenced security group in another VPC, the account ID of the referenced security group is returned.

[EC2-Classic] Required when adding or removing rules that reference a security group in another AWS account.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use the security group ID.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the referenced security group, if applicable.

", - "locationName":"vpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection, if applicable.

", - "locationName":"vpcPeeringConnectionId" - }, - "PeeringStatus":{ - "shape":"String", - "documentation":"

The status of a VPC peering connection, if applicable.

", - "locationName":"peeringStatus" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdGroupPairSet":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "documentation":"

Information about the volume attachments.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS SSD volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose SSD volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2", - "sc1", - "st1" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcEndpoint":{ - "type":"structure", - "members":{ - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the endpoint is associated.

", - "locationName":"vpcId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the AWS service to which the endpoint is associated.

", - "locationName":"serviceName" - }, - "State":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"state" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

The policy document associated with the endpoint.

", - "locationName":"policyDocument" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables associated with the endpoint.

", - "locationName":"routeTableIdSet" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint.

" - }, - "VpcEndpointSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpoint", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the accepter VPC. CIDR block information is not returned when creating a VPC peering connection, or when describing a VPC peering connection that's in the initiating-request or pending-acceptance state.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionOptionsDescription":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local ClassicLink connection can communicate with the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can communicate with a ClassicLink connection in the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can resolve public DNS hostnames to private IP addresses when queried from instances in a peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"VpcPeeringConnectionStateReasonCode", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionStateReasonCode":{ - "type":"string", - "enum":[ - "initiating-request", - "pending-acceptance", - "active", - "deleted", - "rejected", - "failed", - "expired", - "provisioning", - "deleting" - ] - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "PeeringOptions":{ - "shape":"VpcPeeringConnectionOptionsDescription", - "documentation":"

Information about the VPC peering connection options for the accepter or requester VPC.

", - "locationName":"peeringOptions" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created, if applicable. This field may be empty or not returned.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - } - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/waiters-2.json deleted file mode 100644 index aa36a044..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-04-01/waiters-2.json +++ /dev/null @@ -1,607 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeInstances", - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Reservations[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConsoleOutputAvailable": { - "operation": "GetConsoleOutput", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(Output || '') > `0`", - "expected": true - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageExists": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Images[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidAMIID.NotFound", - "state": "retry" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "KeyPairExists": { - "operation": "DescribeKeyPairs", - "delay": 5, - "maxAttempts": 6, - "acceptors": [ - { - "expected": true, - "matcher": "path", - "state": "success", - "argument": "length(KeyPairs[].KeyName) > `0`" - }, - { - "expected": "InvalidKeyPair.NotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "NatGatewayAvailable": { - "operation": "DescribeNatGateways", - "delay": 15, - "maxAttempts": 40, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "NatGateways[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "failed" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleting" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleted" - }, - { - "state": "retry", - "matcher": "error", - "expected": "NatGatewayNotFound" - } - ] - }, - "NetworkAclExists": { - "operation": "DescribeNetworkAcls", - "delay": 20, - "maxAttempts": 10, - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(NetworkAcls[]) > `0`", - "state": "success" - }, - { - "expected": "InvalidNetworkAclID.NotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "NetworkInterfaceAvailable": { - "operation": "DescribeNetworkInterfaces", - "delay": 20, - "maxAttempts": 10, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "NetworkInterfaces[].Status" - }, - { - "expected": "InvalidNetworkInterfaceID.NotFound", - "matcher": "error", - "state": "failure" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "matcher": "error", - "expected": "InvalidVolume.NotFound", - "state": "success" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 60, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpcPeeringConnectionExists": { - "delay": 15, - "operation": "DescribeVpcPeeringConnections", - "maxAttempts": 40, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcPeeringConnectionID.NotFound", - "state": "retry" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/examples-1.json deleted file mode 100644 index f6a8719f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/examples-1.json +++ /dev/null @@ -1,3740 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AllocateAddress": [ - { - "input": { - "Domain": "vpc" - }, - "output": { - "AllocationId": "eipalloc-64d5890a", - "Domain": "vpc", - "PublicIp": "203.0.113.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example allocates an Elastic IP address to use with an instance in a VPC.", - "id": "ec2-allocate-address-1", - "title": "To allocate an Elastic IP address for EC2-VPC" - }, - { - "output": { - "Domain": "standard", - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example allocates an Elastic IP address to use with an instance in EC2-Classic.", - "id": "ec2-allocate-address-2", - "title": "To allocate an Elastic IP address for EC2-Classic" - } - ], - "AssignPrivateIpAddresses": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "PrivateIpAddresses": [ - "10.0.0.82" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns the specified secondary private IP address to the specified network interface.", - "id": "ec2-assign-private-ip-addresses-1", - "title": "To assign a specific secondary private IP address to an interface" - }, - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "SecondaryPrivateIpAddressCount": 2 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns two secondary private IP addresses to the specified network interface. Amazon EC2 automatically assigns these IP addresses from the available IP addresses in the CIDR block range of the subnet the network interface is associated with.", - "id": "ec2-assign-private-ip-addresses-2", - "title": "To assign secondary private IP addresses that Amazon EC2 selects to an interface" - } - ], - "AssociateAddress": [ - { - "input": { - "AllocationId": "eipalloc-64d5890a", - "InstanceId": "i-0b263919b6498b123" - }, - "output": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified Elastic IP address with the specified instance in a VPC.", - "id": "ec2-associate-address-1", - "title": "To associate an Elastic IP address in EC2-VPC" - }, - { - "input": { - "AllocationId": "eipalloc-64d5890a", - "NetworkInterfaceId": "eni-1a2b3c4d" - }, - "output": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified Elastic IP address with the specified network interface.", - "id": "ec2-associate-address-2", - "title": "To associate an Elastic IP address with a network interface" - }, - { - "input": { - "InstanceId": "i-07ffe74c7330ebf53", - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates an Elastic IP address with an instance in EC2-Classic.", - "id": "ec2-associate-address-3", - "title": "To associate an Elastic IP address in EC2-Classic" - } - ], - "AssociateDhcpOptions": [ - { - "input": { - "DhcpOptionsId": "dopt-d9070ebb", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified DHCP options set with the specified VPC.", - "id": "ec2-associate-dhcp-options-1", - "title": "To associate a DHCP options set with a VPC" - }, - { - "input": { - "DhcpOptionsId": "default", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the default DHCP options set with the specified VPC.", - "id": "ec2-associate-dhcp-options-2", - "title": "To associate the default DHCP options set with a VPC" - } - ], - "AssociateRouteTable": [ - { - "input": { - "RouteTableId": "rtb-22574640", - "SubnetId": "subnet-9d4a7b6" - }, - "output": { - "AssociationId": "rtbassoc-781d0d1a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified route table with the specified subnet.", - "id": "ec2-associate-route-table-1", - "title": "To associate a route table with a subnet" - } - ], - "AttachInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified Internet gateway to the specified VPC.", - "id": "ec2-attach-internet-gateway-1", - "title": "To attach an Internet gateway to a VPC" - } - ], - "AttachNetworkInterface": [ - { - "input": { - "DeviceIndex": 1, - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-e5aa89a3" - }, - "output": { - "AttachmentId": "eni-attach-66c4350a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified network interface to the specified instance.", - "id": "ec2-attach-network-interface-1", - "title": "To attach a network interface to an instance" - } - ], - "AttachVolume": [ - { - "input": { - "Device": "/dev/sdf", - "InstanceId": "i-01474ef662b89480", - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "AttachTime": "2016-08-29T18:52:32.724Z", - "Device": "/dev/sdf", - "InstanceId": "i-01474ef662b89480", - "State": "attaching", - "VolumeId": "vol-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches a volume (``vol-1234567890abcdef0``) to an instance (``i-01474ef662b89480``) as ``/dev/sdf``.", - "id": "to-attach-a-volume-to-an-instance-1472499213109", - "title": "To attach a volume to an instance" - } - ], - "CancelSpotFleetRequests": [ - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ], - "TerminateInstances": true - }, - "output": { - "SuccessfulFleetRequests": [ - { - "CurrentSpotFleetRequestState": "cancelled_running", - "PreviousSpotFleetRequestState": "active", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels the specified Spot fleet request and terminates its associated Spot Instances.", - "id": "ec2-cancel-spot-fleet-requests-1", - "title": "To cancel a Spot fleet request" - }, - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ], - "TerminateInstances": false - }, - "output": { - "SuccessfulFleetRequests": [ - { - "CurrentSpotFleetRequestState": "cancelled_terminating", - "PreviousSpotFleetRequestState": "active", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels the specified Spot fleet request without terminating its associated Spot Instances.", - "id": "ec2-cancel-spot-fleet-requests-2", - "title": "To cancel a Spot fleet request without terminating its Spot Instances" - } - ], - "CancelSpotInstanceRequests": [ - { - "input": { - "SpotInstanceRequestIds": [ - "sir-08b93456" - ] - }, - "output": { - "CancelledSpotInstanceRequests": [ - { - "SpotInstanceRequestId": "sir-08b93456", - "State": "cancelled" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels a Spot Instance request.", - "id": "ec2-cancel-spot-instance-requests-1", - "title": "To cancel Spot Instance requests" - } - ], - "ConfirmProductInstance": [ - { - "input": { - "InstanceId": "i-1234567890abcdef0", - "ProductCode": "774F4FF8" - }, - "output": { - "OwnerId": "123456789012" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example determines whether the specified product code is associated with the specified instance.", - "id": "to-confirm-the-product-instance-1472712108494", - "title": "To confirm the product instance" - } - ], - "CopySnapshot": [ - { - "input": { - "Description": "This is my copied snapshot.", - "DestinationRegion": "us-east-1", - "SourceRegion": "us-west-2", - "SourceSnapshotId": "snap-066877671789bd71b" - }, - "output": { - "SnapshotId": "snap-066877671789bd71b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies a snapshot with the snapshot ID of ``snap-066877671789bd71b`` from the ``us-west-2`` region to the ``us-east-1`` region and adds a short description to identify the snapshot.", - "id": "to-copy-a-snapshot-1472502259774", - "title": "To copy a snapshot" - } - ], - "CreateCustomerGateway": [ - { - "input": { - "BgpAsn": 65534, - "PublicIp": "12.1.2.3", - "Type": "ipsec.1" - }, - "output": { - "CustomerGateway": { - "BgpAsn": "65534", - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a customer gateway with the specified IP address for its outside interface.", - "id": "ec2-create-customer-gateway-1", - "title": "To create a customer gateway" - } - ], - "CreateDhcpOptions": [ - { - "input": { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - "10.2.5.1", - "10.2.5.2" - ] - } - ] - }, - "output": { - "DhcpOptions": { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ] - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DHCP options set.", - "id": "ec2-create-dhcp-options-1", - "title": "To create a DHCP options set" - } - ], - "CreateInternetGateway": [ - { - "output": { - "InternetGateway": { - "Attachments": [ - - ], - "InternetGatewayId": "igw-c0a643a9", - "Tags": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Internet gateway.", - "id": "ec2-create-internet-gateway-1", - "title": "To create an Internet gateway" - } - ], - "CreateKeyPair": [ - { - "input": { - "KeyName": "my-key-pair" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a key pair named my-key-pair.", - "id": "ec2-create-key-pair-1", - "title": "To create a key pair" - } - ], - "CreateNatGateway": [ - { - "input": { - "AllocationId": "eipalloc-37fc1a52", - "SubnetId": "subnet-1a2b3c4d" - }, - "output": { - "NatGateway": { - "CreateTime": "2015-12-17T12:45:26.732Z", - "NatGatewayAddresses": [ - { - "AllocationId": "eipalloc-37fc1a52" - } - ], - "NatGatewayId": "nat-08d48af2a8e83edfd", - "State": "pending", - "SubnetId": "subnet-1a2b3c4d", - "VpcId": "vpc-1122aabb" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a NAT gateway in subnet subnet-1a2b3c4d and associates an Elastic IP address with the allocation ID eipalloc-37fc1a52 with the NAT gateway.", - "id": "ec2-create-nat-gateway-1", - "title": "To create a NAT gateway" - } - ], - "CreateNetworkAcl": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "output": { - "NetworkAcl": { - "Associations": [ - - ], - "Entries": [ - { - "CidrBlock": "0.0.0.0/0", - "Egress": true, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - }, - { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - } - ], - "IsDefault": false, - "NetworkAclId": "acl-5fb85d36", - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a network ACL for the specified VPC.", - "id": "ec2-create-network-acl-1", - "title": "To create a network ACL" - } - ], - "CreateNetworkAclEntry": [ - { - "input": { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "NetworkAclId": "acl-5fb85d36", - "PortRange": { - "From": 53, - "To": 53 - }, - "Protocol": "udp", - "RuleAction": "allow", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an entry for the specified network ACL. The rule allows ingress traffic from anywhere (0.0.0.0/0) on UDP port 53 (DNS) into any associated subnet.", - "id": "ec2-create-network-acl-entry-1", - "title": "To create a network ACL entry" - } - ], - "CreateNetworkInterface": [ - { - "input": { - "Description": "my network interface", - "Groups": [ - "sg-903004f8" - ], - "PrivateIpAddress": "10.0.2.17", - "SubnetId": "subnet-9d4a7b6c" - }, - "output": { - "NetworkInterface": { - "AvailabilityZone": "us-east-1d", - "Description": "my network interface", - "Groups": [ - { - "GroupId": "sg-903004f8", - "GroupName": "default" - } - ], - "MacAddress": "02:1a:80:41:52:9c", - "NetworkInterfaceId": "eni-e5aa89a3", - "OwnerId": "123456789012", - "PrivateIpAddress": "10.0.2.17", - "PrivateIpAddresses": [ - { - "Primary": true, - "PrivateIpAddress": "10.0.2.17" - } - ], - "RequesterManaged": false, - "SourceDestCheck": true, - "Status": "pending", - "SubnetId": "subnet-9d4a7b6c", - "TagSet": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a network interface for the specified subnet.", - "id": "ec2-create-network-interface-1", - "title": "To create a network interface" - } - ], - "CreatePlacementGroup": [ - { - "input": { - "GroupName": "my-cluster", - "Strategy": "cluster" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a placement group with the specified name.", - "id": "to-create-a-placement-group-1472712245768", - "title": "To create a placement group" - } - ], - "CreateRoute": [ - { - "input": { - "DestinationCidrBlock": "0.0.0.0/0", - "GatewayId": "igw-c0a643a9", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a route for the specified route table. The route matches all traffic (0.0.0.0/0) and routes it to the specified Internet gateway.", - "id": "ec2-create-route-1", - "title": "To create a route" - } - ], - "CreateRouteTable": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "output": { - "RouteTable": { - "Associations": [ - - ], - "PropagatingVgws": [ - - ], - "RouteTableId": "rtb-22574640", - "Routes": [ - { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "local", - "State": "active" - } - ], - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a route table for the specified VPC.", - "id": "ec2-create-route-table-1", - "title": "To create a route table" - } - ], - "CreateSnapshot": [ - { - "input": { - "Description": "This is my root volume snapshot.", - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "Description": "This is my root volume snapshot.", - "OwnerId": "012345678910", - "SnapshotId": "snap-066877671789bd71b", - "StartTime": "2014-02-28T21:06:01.000Z", - "State": "pending", - "Tags": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeSize": 8 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a snapshot of the volume with a volume ID of ``vol-1234567890abcdef0`` and a short description to identify the snapshot.", - "id": "to-create-a-snapshot-1472502529790", - "title": "To create a snapshot" - } - ], - "CreateSpotDatafeedSubscription": [ - { - "input": { - "Bucket": "my-s3-bucket", - "Prefix": "spotdata" - }, - "output": { - "SpotDatafeedSubscription": { - "Bucket": "my-s3-bucket", - "OwnerId": "123456789012", - "Prefix": "spotdata", - "State": "Active" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot Instance data feed for your AWS account.", - "id": "ec2-create-spot-datafeed-subscription-1", - "title": "To create a Spot Instance datafeed" - } - ], - "CreateSubnet": [ - { - "input": { - "CidrBlock": "10.0.1.0/24", - "VpcId": "vpc-a01106c2" - }, - "output": { - "Subnet": { - "AvailabilityZone": "us-west-2c", - "AvailableIpAddressCount": 251, - "CidrBlock": "10.0.1.0/24", - "State": "pending", - "SubnetId": "subnet-9d4a7b6c", - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a subnet in the specified VPC with the specified CIDR block. We recommend that you let us select an Availability Zone for you.", - "id": "ec2-create-subnet-1", - "title": "To create a subnet" - } - ], - "CreateTags": [ - { - "input": { - "Resources": [ - "ami-78a54011" - ], - "Tags": [ - { - "Key": "Stack", - "Value": "production" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the tag Stack=production to the specified image, or overwrites an existing tag for the AMI where the tag key is Stack.", - "id": "ec2-create-tags-1", - "title": "To add a tag to a resource" - } - ], - "CreateVolume": [ - { - "input": { - "AvailabilityZone": "us-east-1a", - "Size": 80, - "VolumeType": "gp2" - }, - "output": { - "AvailabilityZone": "us-east-1a", - "CreateTime": "2016-08-29T18:52:32.724Z", - "Encrypted": false, - "Iops": 240, - "Size": 80, - "SnapshotId": "", - "State": "creating", - "VolumeId": "vol-6b60b7c7", - "VolumeType": "gp2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an 80 GiB General Purpose (SSD) volume in the Availability Zone ``us-east-1a``.", - "id": "to-create-a-new-volume-1472496724296", - "title": "To create a new volume" - }, - { - "input": { - "AvailabilityZone": "us-east-1a", - "Iops": 1000, - "SnapshotId": "snap-066877671789bd71b", - "VolumeType": "io1" - }, - "output": { - "Attachments": [ - - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2016-08-29T18:52:32.724Z", - "Iops": 1000, - "Size": 500, - "SnapshotId": "snap-066877671789bd71b", - "State": "creating", - "Tags": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeType": "io1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a new Provisioned IOPS (SSD) volume with 1000 provisioned IOPS from a snapshot in the Availability Zone ``us-east-1a``.", - "id": "to-create-a-new-provisioned-iops-ssd-volume-from-a-snapshot-1472498975176", - "title": "To create a new Provisioned IOPS (SSD) volume from a snapshot" - } - ], - "CreateVpc": [ - { - "input": { - "CidrBlock": "10.0.0.0/16" - }, - "output": { - "Vpc": { - "CidrBlock": "10.0.0.0/16", - "DhcpOptionsId": "dopt-7a8b9c2d", - "InstanceTenancy": "default", - "State": "pending", - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a VPC with the specified CIDR block.", - "id": "ec2-create-vpc-1", - "title": "To create a VPC" - } - ], - "DeleteCustomerGateway": [ - { - "input": { - "CustomerGatewayId": "cgw-0e11f167" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified customer gateway.", - "id": "ec2-delete-customer-gateway-1", - "title": "To delete a customer gateway" - } - ], - "DeleteDhcpOptions": [ - { - "input": { - "DhcpOptionsId": "dopt-d9070ebb" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DHCP options set.", - "id": "ec2-delete-dhcp-options-1", - "title": "To delete a DHCP options set" - } - ], - "DeleteInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified Internet gateway.", - "id": "ec2-delete-internet-gateway-1", - "title": "To delete an Internet gateway" - } - ], - "DeleteKeyPair": [ - { - "input": { - "KeyName": "my-key-pair" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified key pair.", - "id": "ec2-delete-key-pair-1", - "title": "To delete a key pair" - } - ], - "DeleteNatGateway": [ - { - "input": { - "NatGatewayId": "nat-04ae55e711cec5680" - }, - "output": { - "NatGatewayId": "nat-04ae55e711cec5680" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified NAT gateway.", - "id": "ec2-delete-nat-gateway-1", - "title": "To delete a NAT gateway" - } - ], - "DeleteNetworkAcl": [ - { - "input": { - "NetworkAclId": "acl-5fb85d36" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified network ACL.", - "id": "ec2-delete-network-acl-1", - "title": "To delete a network ACL" - } - ], - "DeleteNetworkAclEntry": [ - { - "input": { - "Egress": true, - "NetworkAclId": "acl-5fb85d36", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes ingress rule number 100 from the specified network ACL.", - "id": "ec2-delete-network-acl-entry-1", - "title": "To delete a network ACL entry" - } - ], - "DeleteNetworkInterface": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified network interface.", - "id": "ec2-delete-network-interface-1", - "title": "To delete a network interface" - } - ], - "DeletePlacementGroup": [ - { - "input": { - "GroupName": "my-cluster" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified placement group.\n", - "id": "to-delete-a-placement-group-1472712349959", - "title": "To delete a placement group" - } - ], - "DeleteRoute": [ - { - "input": { - "DestinationCidrBlock": "0.0.0.0/0", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified route from the specified route table.", - "id": "ec2-delete-route-1", - "title": "To delete a route" - } - ], - "DeleteRouteTable": [ - { - "input": { - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified route table.", - "id": "ec2-delete-route-table-1", - "title": "To delete a route table" - } - ], - "DeleteSnapshot": [ - { - "input": { - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "id": "to-delete-a-snapshot-1472503042567", - "title": "To delete a snapshot" - } - ], - "DeleteSpotDatafeedSubscription": [ - { - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes a Spot data feed subscription for the account.", - "id": "ec2-delete-spot-datafeed-subscription-1", - "title": "To cancel a Spot Instance data feed subscription" - } - ], - "DeleteSubnet": [ - { - "input": { - "SubnetId": "subnet-9d4a7b6c" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified subnet.", - "id": "ec2-delete-subnet-1", - "title": "To delete a subnet" - } - ], - "DeleteTags": [ - { - "input": { - "Resources": [ - "ami-78a54011" - ], - "Tags": [ - { - "Key": "Stack", - "Value": "test" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the tag Stack=test from the specified image.", - "id": "ec2-delete-tags-1", - "title": "To delete a tag from a resource" - } - ], - "DeleteVolume": [ - { - "input": { - "VolumeId": "vol-049df61146c4d7901" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes an available volume with the volume ID of ``vol-049df61146c4d7901``. If the command succeeds, no output is returned.", - "id": "to-delete-a-volume-1472503111160", - "title": "To delete a volume" - } - ], - "DeleteVpc": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified VPC.", - "id": "ec2-delete-vpc-1", - "title": "To delete a VPC" - } - ], - "DescribeAccountAttributes": [ - { - "input": { - "AttributeNames": [ - "supported-platforms" - ] - }, - "output": { - "AccountAttributes": [ - { - "AttributeName": "supported-platforms", - "AttributeValues": [ - { - "AttributeValue": "EC2" - }, - { - "AttributeValue": "VPC" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the supported-platforms attribute for your AWS account.", - "id": "ec2-describe-account-attributes-1", - "title": "To describe a single attribute for your AWS account" - }, - { - "output": { - "AccountAttributes": [ - { - "AttributeName": "supported-platforms", - "AttributeValues": [ - { - "AttributeValue": "EC2" - }, - { - "AttributeValue": "VPC" - } - ] - }, - { - "AttributeName": "vpc-max-security-groups-per-interface", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "max-elastic-ips", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "max-instances", - "AttributeValues": [ - { - "AttributeValue": "20" - } - ] - }, - { - "AttributeName": "vpc-max-elastic-ips", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "default-vpc", - "AttributeValues": [ - { - "AttributeValue": "none" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attributes for your AWS account.", - "id": "ec2-describe-account-attributes-2", - "title": "To describe all attributes for your AWS account" - } - ], - "DescribeAddresses": [ - { - "output": { - "Addresses": [ - { - "Domain": "standard", - "InstanceId": "i-1234567890abcdef0", - "PublicIp": "198.51.100.0" - }, - { - "AllocationId": "eipalloc-12345678", - "AssociationId": "eipassoc-12345678", - "Domain": "vpc", - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-12345678", - "NetworkInterfaceOwnerId": "123456789012", - "PrivateIpAddress": "10.0.1.241", - "PublicIp": "203.0.113.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses.", - "id": "ec2-describe-addresses-1", - "title": "To describe your Elastic IP addresses" - }, - { - "input": { - "Filters": [ - { - "Name": "domain", - "Values": [ - "vpc" - ] - } - ] - }, - "output": { - "Addresses": [ - { - "AllocationId": "eipalloc-12345678", - "AssociationId": "eipassoc-12345678", - "Domain": "vpc", - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-12345678", - "NetworkInterfaceOwnerId": "123456789012", - "PrivateIpAddress": "10.0.1.241", - "PublicIp": "203.0.113.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses for use with instances in a VPC.", - "id": "ec2-describe-addresses-2", - "title": "To describe your Elastic IP addresses for EC2-VPC" - }, - { - "input": { - "Filters": [ - { - "Name": "domain", - "Values": [ - "standard" - ] - } - ] - }, - "output": { - "Addresses": [ - { - "Domain": "standard", - "InstanceId": "i-1234567890abcdef0", - "PublicIp": "198.51.100.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses for use with instances in EC2-Classic.", - "id": "ec2-describe-addresses-3", - "title": "To describe your Elastic IP addresses for EC2-Classic" - } - ], - "DescribeAvailabilityZones": [ - { - "output": { - "AvailabilityZones": [ - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1b" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1c" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1d" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1e" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Availability Zones that are available to you. The response includes Availability Zones only for the current region.", - "id": "ec2-describe-availability-zones-1", - "title": "To describe your Availability Zones" - } - ], - "DescribeCustomerGateways": [ - { - "input": { - "CustomerGatewayIds": [ - "cgw-0e11f167" - ] - }, - "output": { - "CustomerGateways": [ - { - "BgpAsn": "65534", - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified customer gateway.", - "id": "ec2-describe-customer-gateways-1", - "title": "To describe a customer gateway" - } - ], - "DescribeDhcpOptions": [ - { - "input": { - "DhcpOptionsIds": [ - "dopt-d9070ebb" - ] - }, - "output": { - "DhcpOptions": [ - { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ] - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified DHCP options set.", - "id": "ec2-describe-dhcp-options-1", - "title": "To describe a DHCP options set" - } - ], - "DescribeInstanceAttribute": [ - { - "input": { - "Attribute": "instanceType", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "InstanceId": "i-1234567890abcdef0", - "InstanceType": { - "Value": "t1.micro" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the instance type of the specified instance.\n", - "id": "to-describe-the-instance-type-1472712432132", - "title": "To describe the instance type" - }, - { - "input": { - "Attribute": "disableApiTermination", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "DisableApiTermination": { - "Value": "false" - }, - "InstanceId": "i-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``disableApiTermination`` attribute of the specified instance.\n", - "id": "to-describe-the-disableapitermination-attribute-1472712533466", - "title": "To describe the disableApiTermination attribute" - }, - { - "input": { - "Attribute": "blockDeviceMapping", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "AttachTime": "2013-05-17T22:42:34.000Z", - "DeleteOnTermination": true, - "Status": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - }, - { - "DeviceName": "/dev/sdf", - "Ebs": { - "AttachTime": "2013-09-10T23:07:00.000Z", - "DeleteOnTermination": false, - "Status": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - } - ], - "InstanceId": "i-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``blockDeviceMapping`` attribute of the specified instance.\n", - "id": "to-describe-the-block-device-mapping-for-an-instance-1472712645423", - "title": "To describe the block device mapping for an instance" - } - ], - "DescribeInternetGateways": [ - { - "input": { - "Filters": [ - { - "Name": "attachment.vpc-id", - "Values": [ - "vpc-a01106c2" - ] - } - ] - }, - "output": { - "InternetGateways": [ - { - "Attachments": [ - { - "State": "available", - "VpcId": "vpc-a01106c2" - } - ], - "InternetGatewayId": "igw-c0a643a9", - "Tags": [ - - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Internet gateway for the specified VPC.", - "id": "ec2-describe-internet-gateways-1", - "title": "To describe the Internet gateway for a VPC" - } - ], - "DescribeKeyPairs": [ - { - "input": { - "KeyNames": [ - "my-key-pair" - ] - }, - "output": { - "KeyPairs": [ - { - "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f", - "KeyName": "my-key-pair" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example displays the fingerprint for the specified key.", - "id": "ec2-describe-key-pairs-1", - "title": "To display a key pair" - } - ], - "DescribeMovingAddresses": [ - { - "output": { - "MovingAddressStatuses": [ - { - "MoveStatus": "MovingToVpc", - "PublicIp": "198.51.100.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all of your moving Elastic IP addresses.", - "id": "ec2-describe-moving-addresses-1", - "title": "To describe your moving addresses" - } - ], - "DescribeNatGateways": [ - { - "input": { - "Filter": [ - { - "Name": "vpc-id", - "Values": [ - "vpc-1a2b3c4d" - ] - } - ] - }, - "output": { - "NatGateways": [ - { - "CreateTime": "2015-12-01T12:26:55.983Z", - "NatGatewayAddresses": [ - { - "AllocationId": "eipalloc-89c620ec", - "NetworkInterfaceId": "eni-9dec76cd", - "PrivateIp": "10.0.0.149", - "PublicIp": "198.11.222.333" - } - ], - "NatGatewayId": "nat-05dba92075d71c408", - "State": "available", - "SubnetId": "subnet-847e4dc2", - "VpcId": "vpc-1a2b3c4d" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the NAT gateway for the specified VPC.", - "id": "ec2-describe-nat-gateways-1", - "title": "To describe a NAT gateway" - } - ], - "DescribeNetworkAcls": [ - { - "input": { - "NetworkAclIds": [ - "acl-5fb85d36" - ] - }, - "output": { - "NetworkAcls": [ - { - "Associations": [ - { - "NetworkAclAssociationId": "aclassoc-66ea5f0b", - "NetworkAclId": "acl-9aeb5ef7", - "SubnetId": "subnet-65ea5f08" - } - ], - "Entries": [ - { - "CidrBlock": "0.0.0.0/0", - "Egress": true, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - }, - { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - } - ], - "IsDefault": false, - "NetworkAclId": "acl-5fb85d36", - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified network ACL.", - "id": "ec2-", - "title": "To describe a network ACL" - } - ], - "DescribeNetworkInterfaceAttribute": [ - { - "input": { - "Attribute": "attachment", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Attachment": { - "AttachTime": "2015-05-21T20:02:20.000Z", - "AttachmentId": "eni-attach-43348162", - "DeleteOnTermination": true, - "DeviceIndex": 0, - "InstanceId": "i-1234567890abcdef0", - "InstanceOwnerId": "123456789012", - "Status": "attached" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attachment attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-1", - "title": "To describe the attachment attribute of a network interface" - }, - { - "input": { - "Attribute": "description", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Description": { - "Value": "My description" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the description attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-2", - "title": "To describe the description attribute of a network interface" - }, - { - "input": { - "Attribute": "groupSet", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Groups": [ - { - "GroupId": "sg-903004f8", - "GroupName": "my-security-group" - } - ], - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the groupSet attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-3", - "title": "To describe the groupSet attribute of a network interface" - }, - { - "input": { - "Attribute": "sourceDestCheck", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "NetworkInterfaceId": "eni-686ea200", - "SourceDestCheck": { - "Value": true - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the sourceDestCheck attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-4", - "title": "To describe the sourceDestCheck attribute of a network interface" - } - ], - "DescribeNetworkInterfaces": [ - { - "input": { - "NetworkInterfaceIds": [ - "eni-e5aa89a3" - ] - }, - "output": { - "NetworkInterfaces": [ - { - "Association": { - "AssociationId": "eipassoc-0fbb766a", - "IpOwnerId": "123456789012", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "PublicIp": "203.0.113.12" - }, - "Attachment": { - "AttachTime": "2013-11-30T23:36:42.000Z", - "AttachmentId": "eni-attach-66c4350a", - "DeleteOnTermination": false, - "DeviceIndex": 1, - "InstanceId": "i-1234567890abcdef0", - "InstanceOwnerId": "123456789012", - "Status": "attached" - }, - "AvailabilityZone": "us-east-1d", - "Description": "my network interface", - "Groups": [ - { - "GroupId": "sg-8637d3e3", - "GroupName": "default" - } - ], - "MacAddress": "02:2f:8f:b0:cf:75", - "NetworkInterfaceId": "eni-e5aa89a3", - "OwnerId": "123456789012", - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "PrivateIpAddress": "10.0.1.17", - "PrivateIpAddresses": [ - { - "Association": { - "AssociationId": "eipassoc-0fbb766a", - "IpOwnerId": "123456789012", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "PublicIp": "203.0.113.12" - }, - "Primary": true, - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "PrivateIpAddress": "10.0.1.17" - } - ], - "RequesterManaged": false, - "SourceDestCheck": true, - "Status": "in-use", - "SubnetId": "subnet-b61f49f0", - "TagSet": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "ec2-describe-network-interfaces-1", - "title": "To describe a network interface" - } - ], - "DescribeRegions": [ - { - "output": { - "Regions": [ - { - "Endpoint": "ec2.ap-south-1.amazonaws.com", - "RegionName": "ap-south-1" - }, - { - "Endpoint": "ec2.eu-west-1.amazonaws.com", - "RegionName": "eu-west-1" - }, - { - "Endpoint": "ec2.ap-southeast-1.amazonaws.com", - "RegionName": "ap-southeast-1" - }, - { - "Endpoint": "ec2.ap-southeast-2.amazonaws.com", - "RegionName": "ap-southeast-2" - }, - { - "Endpoint": "ec2.eu-central-1.amazonaws.com", - "RegionName": "eu-central-1" - }, - { - "Endpoint": "ec2.ap-northeast-2.amazonaws.com", - "RegionName": "ap-northeast-2" - }, - { - "Endpoint": "ec2.ap-northeast-1.amazonaws.com", - "RegionName": "ap-northeast-1" - }, - { - "Endpoint": "ec2.us-east-1.amazonaws.com", - "RegionName": "us-east-1" - }, - { - "Endpoint": "ec2.sa-east-1.amazonaws.com", - "RegionName": "sa-east-1" - }, - { - "Endpoint": "ec2.us-west-1.amazonaws.com", - "RegionName": "us-west-1" - }, - { - "Endpoint": "ec2.us-west-2.amazonaws.com", - "RegionName": "us-west-2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all the regions that are available to you.", - "id": "ec2-describe-regions-1", - "title": "To describe your regions" - } - ], - "DescribeRouteTables": [ - { - "input": { - "RouteTableIds": [ - "rtb-1f382e7d" - ] - }, - "output": { - "RouteTables": [ - { - "Associations": [ - { - "Main": true, - "RouteTableAssociationId": "rtbassoc-d8ccddba", - "RouteTableId": "rtb-1f382e7d" - } - ], - "PropagatingVgws": [ - - ], - "RouteTableId": "rtb-1f382e7d", - "Routes": [ - { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "local", - "State": "active" - } - ], - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified route table.", - "id": "ec2-describe-route-tables-1", - "title": "To describe a route table" - } - ], - "DescribeScheduledInstanceAvailability": [ - { - "input": { - "FirstSlotStartTimeRange": { - "EarliestTime": "2016-01-31T00:00:00Z", - "LatestTime": "2016-01-31T04:00:00Z" - }, - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDays": [ - 1 - ] - } - }, - "output": { - "ScheduledInstanceAvailabilitySet": [ - { - "AvailabilityZone": "us-west-2b", - "AvailableInstanceCount": 20, - "FirstSlotStartTime": "2016-01-31T00:00:00Z", - "HourlyPrice": "0.095", - "InstanceType": "c4.large", - "MaxTermDurationInDays": 366, - "MinTermDurationInDays": 366, - "NetworkPlatform": "EC2-VPC", - "Platform": "Linux/UNIX", - "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false - }, - "SlotDurationInHours": 23, - "TotalScheduledInstanceHours": 1219 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes a schedule that occurs every week on Sunday, starting on the specified date. Note that the output contains a single schedule as an example.", - "id": "ec2-describe-scheduled-instance-availability-1", - "title": "To describe an available schedule" - } - ], - "DescribeScheduledInstances": [ - { - "input": { - "ScheduledInstanceIds": [ - "sci-1234-1234-1234-1234-123456789012" - ] - }, - "output": { - "ScheduledInstanceSet": [ - { - "AvailabilityZone": "us-west-2b", - "CreateDate": "2016-01-25T21:43:38.612Z", - "HourlyPrice": "0.095", - "InstanceCount": 1, - "InstanceType": "c4.large", - "NetworkPlatform": "EC2-VPC", - "NextSlotStartTime": "2016-01-31T09:00:00Z", - "Platform": "Linux/UNIX", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false, - "OccurrenceUnit": "" - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - "SlotDurationInHours": 32, - "TermEndDate": "2017-01-31T09:00:00Z", - "TermStartDate": "2016-01-31T09:00:00Z", - "TotalScheduledInstanceHours": 1696 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Scheduled Instance.", - "id": "ec2-describe-scheduled-instances-1", - "title": "To describe your Scheduled Instances" - } - ], - "DescribeSnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "SnapshotId": "snap-066877671789bd71b" - }, - "output": { - "CreateVolumePermissions": [ - - ], - "SnapshotId": "snap-066877671789bd71b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``createVolumePermission`` attribute on a snapshot with the snapshot ID of ``snap-066877671789bd71b``.", - "id": "to-describe-snapshot-attributes-1472503199736", - "title": "To describe snapshot attributes" - } - ], - "DescribeSnapshots": [ - { - "input": { - "SnapshotIds": [ - "snap-1234567890abcdef0" - ] - }, - "output": { - "NextToken": "", - "Snapshots": [ - { - "Description": "This is my snapshot.", - "OwnerId": "012345678910", - "Progress": "100%", - "SnapshotId": "snap-1234567890abcdef0", - "StartTime": "2014-02-28T21:28:32.000Z", - "State": "completed", - "VolumeId": "vol-049df61146c4d7901", - "VolumeSize": 8 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``.", - "id": "to-describe-a-snapshot-1472503807850", - "title": "To describe a snapshot" - }, - { - "input": { - "Filters": [ - { - "Name": "status", - "Values": [ - "pending" - ] - } - ], - "OwnerIds": [ - "012345678910" - ] - }, - "output": { - "NextToken": "", - "Snapshots": [ - { - "Description": "This is my copied snapshot.", - "OwnerId": "012345678910", - "Progress": "87%", - "SnapshotId": "snap-066877671789bd71b", - "StartTime": "2014-02-28T21:37:27.000Z", - "State": "pending", - "VolumeId": "vol-1234567890abcdef0", - "VolumeSize": 8 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all snapshots owned by the ID 012345678910 that are in the ``pending`` status.", - "id": "to-describe-snapshots-using-filters-1472503929793", - "title": "To describe snapshots using filters" - } - ], - "DescribeSpotDatafeedSubscription": [ - { - "output": { - "SpotDatafeedSubscription": { - "Bucket": "my-s3-bucket", - "OwnerId": "123456789012", - "Prefix": "spotdata", - "State": "Active" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Spot Instance datafeed subscription for your AWS account.", - "id": "ec2-describe-spot-datafeed-subscription-1", - "title": "To describe the datafeed for your AWS account" - } - ], - "DescribeSpotFleetInstances": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "output": { - "ActiveInstances": [ - { - "InstanceId": "i-1234567890abcdef0", - "InstanceType": "m3.medium", - "SpotInstanceRequestId": "sir-08b93456" - } - ], - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the Spot Instances associated with the specified Spot fleet.", - "id": "ec2-describe-spot-fleet-instances-1", - "title": "To describe the Spot Instances associated with a Spot fleet" - } - ], - "DescribeSpotFleetRequestHistory": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "StartTime": "2015-05-26T00:00:00Z" - }, - "output": { - "HistoryRecords": [ - { - "EventInformation": { - "EventSubType": "submitted" - }, - "EventType": "fleetRequestChange", - "Timestamp": "2015-05-26T23:17:20.697Z" - }, - { - "EventInformation": { - "EventSubType": "active" - }, - "EventType": "fleetRequestChange", - "Timestamp": "2015-05-26T23:17:20.873Z" - }, - { - "EventInformation": { - "EventSubType": "launched", - "InstanceId": "i-1234567890abcdef0" - }, - "EventType": "instanceChange", - "Timestamp": "2015-05-26T23:21:21.712Z" - }, - { - "EventInformation": { - "EventSubType": "launched", - "InstanceId": "i-1234567890abcdef1" - }, - "EventType": "instanceChange", - "Timestamp": "2015-05-26T23:21:21.816Z" - } - ], - "NextToken": "CpHNsscimcV5oH7bSbub03CI2Qms5+ypNpNm+53MNlR0YcXAkp0xFlfKf91yVxSExmbtma3awYxMFzNA663ZskT0AHtJ6TCb2Z8bQC2EnZgyELbymtWPfpZ1ZbauVg+P+TfGlWxWWB/Vr5dk5d4LfdgA/DRAHUrYgxzrEXAMPLE=", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "StartTime": "2015-05-26T00:00:00Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example returns the history for the specified Spot fleet starting at the specified time.", - "id": "ec2-describe-spot-fleet-request-history-1", - "title": "To describe Spot fleet history" - } - ], - "DescribeSpotFleetRequests": [ - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ] - }, - "output": { - "SpotFleetRequestConfigs": [ - { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "EbsOptimized": false, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "cc2.8xlarge", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeleteOnTermination": false, - "DeviceIndex": 0, - "SecondaryPrivateIpAddressCount": 0, - "SubnetId": "subnet-a61dafcf" - } - ] - }, - { - "EbsOptimized": false, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "r3.8xlarge", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeleteOnTermination": false, - "DeviceIndex": 0, - "SecondaryPrivateIpAddressCount": 0, - "SubnetId": "subnet-a61dafcf" - } - ] - } - ], - "SpotPrice": "0.05", - "TargetCapacity": 20 - }, - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "SpotFleetRequestState": "active" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Spot fleet request.", - "id": "ec2-describe-spot-fleet-requests-1", - "title": "To describe a Spot fleet request" - } - ], - "DescribeSpotInstanceRequests": [ - { - "input": { - "SpotInstanceRequestIds": [ - "sir-08b93456" - ] - }, - "output": { - "SpotInstanceRequests": [ - { - "CreateTime": "2014-04-30T18:14:55.000Z", - "InstanceId": "i-1234567890abcdef0", - "LaunchSpecification": { - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "DeleteOnTermination": true, - "VolumeSize": 8, - "VolumeType": "standard" - } - } - ], - "EbsOptimized": false, - "ImageId": "ami-7aba833f", - "InstanceType": "m1.small", - "KeyName": "my-key-pair", - "SecurityGroups": [ - { - "GroupId": "sg-e38f24a7", - "GroupName": "my-security-group" - } - ] - }, - "LaunchedAvailabilityZone": "us-west-1b", - "ProductDescription": "Linux/UNIX", - "SpotInstanceRequestId": "sir-08b93456", - "SpotPrice": "0.010000", - "State": "active", - "Status": { - "Code": "fulfilled", - "Message": "Your Spot request is fulfilled.", - "UpdateTime": "2014-04-30T18:16:21.000Z" - }, - "Type": "one-time" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Spot Instance request.", - "id": "ec2-describe-spot-instance-requests-1", - "title": "To describe a Spot Instance request" - } - ], - "DescribeSpotPriceHistory": [ - { - "input": { - "EndTime": "2014-01-06T08:09:10", - "InstanceTypes": [ - "m1.xlarge" - ], - "ProductDescriptions": [ - "Linux/UNIX (Amazon VPC)" - ], - "StartTime": "2014-01-06T07:08:09" - }, - "output": { - "SpotPriceHistory": [ - { - "AvailabilityZone": "us-west-1a", - "InstanceType": "m1.xlarge", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "SpotPrice": "0.080000", - "Timestamp": "2014-01-06T04:32:53.000Z" - }, - { - "AvailabilityZone": "us-west-1c", - "InstanceType": "m1.xlarge", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "SpotPrice": "0.080000", - "Timestamp": "2014-01-05T11:28:26.000Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example returns the Spot Price history for m1.xlarge, Linux/UNIX (Amazon VPC) instances for a particular day in January.", - "id": "ec2-describe-spot-price-history-1", - "title": "To describe Spot price history for Linux/UNIX (Amazon VPC)" - } - ], - "DescribeSubnets": [ - { - "input": { - "Filters": [ - { - "Name": "vpc-id", - "Values": [ - "vpc-a01106c2" - ] - } - ] - }, - "output": { - "Subnets": [ - { - "AvailabilityZone": "us-east-1c", - "AvailableIpAddressCount": 251, - "CidrBlock": "10.0.1.0/24", - "DefaultForAz": false, - "MapPublicIpOnLaunch": false, - "State": "available", - "SubnetId": "subnet-9d4a7b6c", - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the subnets for the specified VPC.", - "id": "ec2-describe-subnets-1", - "title": "To describe the subnets for a VPC" - } - ], - "DescribeTags": [ - { - "input": { - "Filters": [ - { - "Name": "resource-id", - "Values": [ - "i-1234567890abcdef8" - ] - } - ] - }, - "output": { - "Tags": [ - { - "Key": "Stack", - "ResourceId": "i-1234567890abcdef8", - "ResourceType": "instance", - "Value": "test" - }, - { - "Key": "Name", - "ResourceId": "i-1234567890abcdef8", - "ResourceType": "instance", - "Value": "Beta Server" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the tags for the specified instance.", - "id": "ec2-describe-tags-1", - "title": "To describe the tags for a single resource" - } - ], - "DescribeVolumeAttribute": [ - { - "input": { - "Attribute": "autoEnableIO", - "VolumeId": "vol-049df61146c4d7901" - }, - "output": { - "AutoEnableIO": { - "Value": false - }, - "VolumeId": "vol-049df61146c4d7901" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``autoEnableIo`` attribute of the volume with the ID ``vol-049df61146c4d7901``.", - "id": "to-describe-a-volume-attribute-1472505773492", - "title": "To describe a volume attribute" - } - ], - "DescribeVolumeStatus": [ - { - "input": { - "VolumeIds": [ - "vol-1234567890abcdef0" - ] - }, - "output": { - "VolumeStatuses": [ - { - "Actions": [ - - ], - "AvailabilityZone": "us-east-1a", - "Events": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeStatus": { - "Details": [ - { - "Name": "io-enabled", - "Status": "passed" - }, - { - "Name": "io-performance", - "Status": "not-applicable" - } - ], - "Status": "ok" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the status for the volume ``vol-1234567890abcdef0``.", - "id": "to-describe-the-status-of-a-single-volume-1472507016193", - "title": "To describe the status of a single volume" - }, - { - "input": { - "Filters": [ - { - "Name": "volume-status.status", - "Values": [ - "impaired" - ] - } - ] - }, - "output": { - "VolumeStatuses": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the status for all volumes that are impaired. In this example output, there are no impaired volumes.", - "id": "to-describe-the-status-of-impaired-volumes-1472507239821", - "title": "To describe the status of impaired volumes" - } - ], - "DescribeVolumes": [ - { - "input": { - }, - "output": { - "NextToken": "", - "Volumes": [ - { - "Attachments": [ - { - "AttachTime": "2013-12-18T22:35:00.000Z", - "DeleteOnTermination": true, - "Device": "/dev/sda1", - "InstanceId": "i-1234567890abcdef0", - "State": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2013-12-18T22:35:00.084Z", - "Size": 8, - "SnapshotId": "snap-1234567890abcdef0", - "State": "in-use", - "VolumeId": "vol-049df61146c4d7901", - "VolumeType": "standard" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all of your volumes in the default region.", - "id": "to-describe-all-volumes-1472506358883", - "title": "To describe all volumes" - }, - { - "input": { - "Filters": [ - { - "Name": "attachment.instance-id", - "Values": [ - "i-1234567890abcdef0" - ] - }, - { - "Name": "attachment.delete-on-termination", - "Values": [ - "true" - ] - } - ] - }, - "output": { - "Volumes": [ - { - "Attachments": [ - { - "AttachTime": "2013-12-18T22:35:00.000Z", - "DeleteOnTermination": true, - "Device": "/dev/sda1", - "InstanceId": "i-1234567890abcdef0", - "State": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2013-12-18T22:35:00.084Z", - "Size": 8, - "SnapshotId": "snap-1234567890abcdef0", - "State": "in-use", - "VolumeId": "vol-049df61146c4d7901", - "VolumeType": "standard" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all volumes that are both attached to the instance with the ID i-1234567890abcdef0 and set to delete when the instance terminates.", - "id": "to-describe-volumes-that-are-attached-to-a-specific-instance-1472506613578", - "title": "To describe volumes that are attached to a specific instance" - } - ], - "DescribeVpcAttribute": [ - { - "input": { - "Attribute": "enableDnsSupport", - "VpcId": "vpc-a01106c2" - }, - "output": { - "EnableDnsSupport": { - "Value": true - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.", - "id": "ec2-describe-vpc-attribute-1", - "title": "To describe the enableDnsSupport attribute" - }, - { - "input": { - "Attribute": "enableDnsHostnames", - "VpcId": "vpc-a01106c2" - }, - "output": { - "EnableDnsHostnames": { - "Value": true - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the enableDnsHostnames attribute. This attribute indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.", - "id": "ec2-describe-vpc-attribute-2", - "title": "To describe the enableDnsHostnames attribute" - } - ], - "DescribeVpcs": [ - { - "input": { - "VpcIds": [ - "vpc-a01106c2" - ] - }, - "output": { - "Vpcs": [ - { - "CidrBlock": "10.0.0.0/16", - "DhcpOptionsId": "dopt-7a8b9c2d", - "InstanceTenancy": "default", - "IsDefault": false, - "State": "available", - "Tags": [ - { - "Key": "Name", - "Value": "MyVPC" - } - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified VPC.", - "id": "ec2-describe-vpcs-1", - "title": "To describe a VPC" - } - ], - "DetachInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified Internet gateway from the specified VPC.", - "id": "ec2-detach-internet-gateway-1", - "title": "To detach an Internet gateway from a VPC" - } - ], - "DetachNetworkInterface": [ - { - "input": { - "AttachmentId": "eni-attach-66c4350a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified network interface from its attached instance.", - "id": "ec2-detach-network-interface-1", - "title": "To detach a network interface from an instance" - } - ], - "DetachVolume": [ - { - "input": { - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "AttachTime": "2014-02-27T19:23:06.000Z", - "Device": "/dev/sdb", - "InstanceId": "i-1234567890abcdef0", - "State": "detaching", - "VolumeId": "vol-049df61146c4d7901" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the volume (``vol-049df61146c4d7901``) from the instance it is attached to.", - "id": "to-detach-a-volume-from-an-instance-1472507977694", - "title": "To detach a volume from an instance" - } - ], - "DisableVgwRoutePropagation": [ - { - "input": { - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables the specified virtual private gateway from propagating static routes to the specified route table.", - "id": "ec2-disable-vgw-route-propagation-1", - "title": "To disable route propagation" - } - ], - "DisassociateAddress": [ - { - "input": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates an Elastic IP address from an instance in a VPC.", - "id": "ec2-disassociate-address-1", - "title": "To disassociate an Elastic IP address in EC2-VPC" - }, - { - "input": { - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates an Elastic IP address from an instance in EC2-Classic.", - "id": "ec2-disassociate-address-2", - "title": "To disassociate an Elastic IP addresses in EC2-Classic" - } - ], - "DisassociateRouteTable": [ - { - "input": { - "AssociationId": "rtbassoc-781d0d1a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates the specified route table from its associated subnet.", - "id": "ec2-disassociate-route-table-1", - "title": "To disassociate a route table" - } - ], - "EnableVgwRoutePropagation": [ - { - "input": { - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables the specified virtual private gateway to propagate static routes to the specified route table.", - "id": "ec2-enable-vgw-route-propagation-1", - "title": "To enable route propagation" - } - ], - "EnableVolumeIO": [ - { - "input": { - "VolumeId": "vol-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables I/O on volume ``vol-1234567890abcdef0``.", - "id": "to-enable-io-for-a-volume-1472508114867", - "title": "To enable I/O for a volume" - } - ], - "ModifyNetworkInterfaceAttribute": [ - { - "input": { - "Attachment": { - "AttachmentId": "eni-attach-43348162", - "DeleteOnTermination": false - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the attachment attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-1", - "title": "To modify the attachment attribute of a network interface" - }, - { - "input": { - "Description": { - "Value": "My description" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the description attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-2", - "title": "To modify the description attribute of a network interface" - }, - { - "input": { - "Groups": [ - "sg-903004f8", - "sg-1a2b3c4d" - ], - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command modifies the groupSet attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-3", - "title": "To modify the groupSet attribute of a network interface" - }, - { - "input": { - "NetworkInterfaceId": "eni-686ea200", - "SourceDestCheck": { - "Value": false - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command modifies the sourceDestCheck attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-4", - "title": "To modify the sourceDestCheck attribute of a network interface" - } - ], - "ModifySnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "OperationType": "remove", - "SnapshotId": "snap-1234567890abcdef0", - "UserIds": [ - "123456789012" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies snapshot ``snap-1234567890abcdef0`` to remove the create volume permission for a user with the account ID ``123456789012``. If the command succeeds, no output is returned.", - "id": "to-modify-a-snapshot-attribute-1472508385907", - "title": "To modify a snapshot attribute" - }, - { - "input": { - "Attribute": "createVolumePermission", - "GroupNames": [ - "all" - ], - "OperationType": "add", - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example makes the snapshot ``snap-1234567890abcdef0`` public.", - "id": "to-make-a-snapshot-public-1472508470529", - "title": "To make a snapshot public" - } - ], - "ModifySpotFleetRequest": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "TargetCapacity": 20 - }, - "output": { - "Return": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example increases the target capacity of the specified Spot fleet request.", - "id": "ec2-modify-spot-fleet-request-1", - "title": "To increase the target capacity of a Spot fleet request" - }, - { - "input": { - "ExcessCapacityTerminationPolicy": "NoTermination ", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "TargetCapacity": 10 - }, - "output": { - "Return": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example decreases the target capacity of the specified Spot fleet request without terminating any Spot Instances as a result.", - "id": "ec2-modify-spot-fleet-request-2", - "title": "To decrease the target capacity of a Spot fleet request" - } - ], - "ModifySubnetAttribute": [ - { - "input": { - "MapPublicIpOnLaunch": { - "Value": true - }, - "SubnetId": "subnet-1a2b3c4d" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the specified subnet so that all instances launched into this subnet are assigned a public IP address.", - "id": "ec2-modify-subnet-attribute-1", - "title": "To change a subnet's public IP addressing behavior" - } - ], - "ModifyVolumeAttribute": [ - { - "input": { - "AutoEnableIO": { - "Value": true - }, - "DryRun": true, - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the ``autoEnableIo`` attribute of the volume with the ID ``vol-1234567890abcdef0`` to ``true``. If the command succeeds, no output is returned.", - "id": "to-modify-a-volume-attribute-1472508596749", - "title": "To modify a volume attribute" - } - ], - "ModifyVpcAttribute": [ - { - "input": { - "EnableDnsSupport": { - "Value": false - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for instances in the VPC to their corresponding IP addresses; otherwise, it does not.", - "id": "ec2-modify-vpc-attribute-1", - "title": "To modify the enableDnsSupport attribute" - }, - { - "input": { - "EnableDnsHostnames": { - "Value": false - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the enableDnsHostnames attribute. This attribute indicates whether instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.", - "id": "ec2-modify-vpc-attribute-2", - "title": "To modify the enableDnsHostnames attribute" - } - ], - "MoveAddressToVpc": [ - { - "input": { - "PublicIp": "54.123.4.56" - }, - "output": { - "Status": "MoveInProgress" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example moves the specified Elastic IP address to the EC2-VPC platform.", - "id": "ec2-move-address-to-vpc-1", - "title": "To move an address to EC2-VPC" - } - ], - "PurchaseScheduledInstances": [ - { - "input": { - "PurchaseRequests": [ - { - "InstanceCount": 1, - "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi..." - } - ] - }, - "output": { - "ScheduledInstanceSet": [ - { - "AvailabilityZone": "us-west-2b", - "CreateDate": "2016-01-25T21:43:38.612Z", - "HourlyPrice": "0.095", - "InstanceCount": 1, - "InstanceType": "c4.large", - "NetworkPlatform": "EC2-VPC", - "NextSlotStartTime": "2016-01-31T09:00:00Z", - "Platform": "Linux/UNIX", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false, - "OccurrenceUnit": "" - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - "SlotDurationInHours": 32, - "TermEndDate": "2017-01-31T09:00:00Z", - "TermStartDate": "2016-01-31T09:00:00Z", - "TotalScheduledInstanceHours": 1696 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example purchases a Scheduled Instance.", - "id": "ec2-purchase-scheduled-instances-1", - "title": "To purchase a Scheduled Instance" - } - ], - "ReleaseAddress": [ - { - "input": { - "AllocationId": "eipalloc-64d5890a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example releases an Elastic IP address for use with instances in a VPC.", - "id": "ec2-release-address-1", - "title": "To release an Elastic IP address for EC2-VPC" - }, - { - "input": { - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example releases an Elastic IP address for use with instances in EC2-Classic.", - "id": "ec2-release-address-2", - "title": "To release an Elastic IP addresses for EC2-Classic" - } - ], - "ReplaceNetworkAclAssociation": [ - { - "input": { - "AssociationId": "aclassoc-e5b95c8c", - "NetworkAclId": "acl-5fb85d36" - }, - "output": { - "NewAssociationId": "aclassoc-3999875b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified network ACL with the subnet for the specified network ACL association.", - "id": "ec2-replace-network-acl-association-1", - "title": "To replace the network ACL associated with a subnet" - } - ], - "ReplaceNetworkAclEntry": [ - { - "input": { - "CidrBlock": "203.0.113.12/24", - "Egress": false, - "NetworkAclId": "acl-5fb85d36", - "PortRange": { - "From": 53, - "To": 53 - }, - "Protocol": "udp", - "RuleAction": "allow", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces an entry for the specified network ACL. The new rule 100 allows ingress traffic from 203.0.113.12/24 on UDP port 53 (DNS) into any associated subnet.", - "id": "ec2-replace-network-acl-entry-1", - "title": "To replace a network ACL entry" - } - ], - "ReplaceRoute": [ - { - "input": { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces the specified route in the specified table table. The new route matches the specified CIDR and sends the traffic to the specified virtual private gateway.", - "id": "ec2-replace-route-1", - "title": "To replace a route" - } - ], - "ReplaceRouteTableAssociation": [ - { - "input": { - "AssociationId": "rtbassoc-781d0d1a", - "RouteTableId": "rtb-22574640" - }, - "output": { - "NewAssociationId": "rtbassoc-3a1f0f58" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified route table with the subnet for the specified route table association.", - "id": "ec2-replace-route-table-association-1", - "title": "To replace the route table associated with a subnet" - } - ], - "RequestSpotFleet": [ - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "SecurityGroups": [ - { - "GroupId": "sg-1a2b3c4d" - } - ], - "SubnetId": "subnet-1a2b3c4d, subnet-3c4d5e6f" - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request with two launch specifications that differ only by subnet. The Spot fleet launches the instances in the specified subnet with the lowest price. If the instances are launched in a default VPC, they receive a public IP address by default. If the instances are launched in a nondefault VPC, they do not receive a public IP address by default. Note that you can't specify different subnets from the same Availability Zone in a Spot fleet request.", - "id": "ec2-request-spot-fleet-1", - "title": "To request a Spot fleet in the subnet with the lowest price" - }, - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2a, us-west-2b" - }, - "SecurityGroups": [ - { - "GroupId": "sg-1a2b3c4d" - } - ] - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request with two launch specifications that differ only by Availability Zone. The Spot fleet launches the instances in the specified Availability Zone with the lowest price. If your account supports EC2-VPC only, Amazon EC2 launches the Spot instances in the default subnet of the Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the Availability Zone.", - "id": "ec2-request-spot-fleet-2", - "title": "To request a Spot fleet in the Availability Zone with the lowest price" - }, - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::880185128111:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeviceIndex": 0, - "Groups": [ - "sg-1a2b3c4d" - ], - "SubnetId": "subnet-1a2b3c4d" - } - ] - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns public addresses to instances launched in a nondefault VPC. Note that when you specify a network interface, you must include the subnet ID and security group ID using the network interface.", - "id": "ec2-request-spot-fleet-3", - "title": "To launch Spot instances in a subnet and assign them public IP addresses" - }, - { - "input": { - "SpotFleetRequestConfig": { - "AllocationStrategy": "diversified", - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "c4.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - }, - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - }, - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "r3.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - } - ], - "SpotPrice": "0.70", - "TargetCapacity": 30 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request that launches 30 instances using the diversified allocation strategy. The launch specifications differ by instance type. The Spot fleet distributes the instances across the launch specifications such that there are 10 instances of each type.", - "id": "ec2-request-spot-fleet-4", - "title": "To request a Spot fleet using the diversified allocation strategy" - } - ], - "RequestSpotInstances": [ - { - "input": { - "InstanceCount": 5, - "LaunchSpecification": { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2a" - }, - "SecurityGroupIds": [ - "sg-1a2b3c4d" - ] - }, - "SpotPrice": "0.03", - "Type": "one-time" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the specified Availability Zone.", - "id": "ec2-request-spot-instances-1", - "title": "To create a one-time Spot Instance request" - }, - { - "input": { - "InstanceCount": 5, - "LaunchSpecification": { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "SecurityGroupIds": [ - "sg-1a2b3c4d" - ], - "SubnetId": "subnet-1a2b3c4d" - }, - "SpotPrice": "0.050", - "Type": "one-time" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command creates a one-time Spot Instance request for five instances in the specified subnet. Amazon EC2 launches the instances in the specified subnet. If the VPC is a nondefault VPC, the instances do not receive a public IP address by default.", - "id": "ec2-request-spot-instances-2", - "title": "To create a one-time Spot Instance request" - } - ], - "ResetSnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example resets the create volume permissions for snapshot ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "id": "to-reset-a-snapshot-attribute-1472508825735", - "title": "To reset a snapshot attribute" - } - ], - "RestoreAddressToClassic": [ - { - "input": { - "PublicIp": "198.51.100.0" - }, - "output": { - "PublicIp": "198.51.100.0", - "Status": "MoveInProgress" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example restores the specified Elastic IP address to the EC2-Classic platform.", - "id": "ec2-restore-address-to-classic-1", - "title": "To restore an address to EC2-Classic" - } - ], - "RunScheduledInstances": [ - { - "input": { - "InstanceCount": 1, - "LaunchSpecification": { - "IamInstanceProfile": { - "Name": "my-iam-role" - }, - "ImageId": "ami-12345678", - "InstanceType": "c4.large", - "KeyName": "my-key-pair", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeviceIndex": 0, - "Groups": [ - "sg-12345678" - ], - "SubnetId": "subnet-12345678" - } - ] - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - }, - "output": { - "InstanceIdSet": [ - "i-1234567890abcdef0" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example launches the specified Scheduled Instance in a VPC.", - "id": "ec2-run-scheduled-instances-1", - "title": "To launch a Scheduled Instance in a VPC" - }, - { - "input": { - "InstanceCount": 1, - "LaunchSpecification": { - "IamInstanceProfile": { - "Name": "my-iam-role" - }, - "ImageId": "ami-12345678", - "InstanceType": "c4.large", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2b" - }, - "SecurityGroupIds": [ - "sg-12345678" - ] - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - }, - "output": { - "InstanceIdSet": [ - "i-1234567890abcdef0" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example launches the specified Scheduled Instance in EC2-Classic.", - "id": "ec2-run-scheduled-instances-2", - "title": "To launch a Scheduled Instance in EC2-Classic" - } - ], - "UnassignPrivateIpAddresses": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "PrivateIpAddresses": [ - "10.0.0.82" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example unassigns the specified private IP address from the specified network interface.", - "id": "ec2-unassign-private-ip-addresses-1", - "title": "To unassign a secondary private IP address from a network interface" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/paginators-1.json deleted file mode 100644 index 2bd01ad5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/paginators-1.json +++ /dev/null @@ -1,63 +0,0 @@ -{ - "pagination": { - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - }, - "DescribeSpotFleetRequests": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotFleetRequestConfigs" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeVolumes": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Volumes" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/service-2.json deleted file mode 100644 index 700f84ac..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/service-2.json +++ /dev/null @@ -1,17907 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-09-15", - "endpointPrefix":"ec2", - "protocol":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "signatureVersion":"v4", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2016-09-15" - }, - "operations":{ - "AcceptReservedInstancesExchangeQuote":{ - "name":"AcceptReservedInstancesExchangeQuote", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptReservedInstancesExchangeQuoteRequest"}, - "output":{"shape":"AcceptReservedInstancesExchangeQuoteResult"}, - "documentation":"

Purchases Convertible Reserved Instance offerings described in the GetReservedInstancesExchangeQuote call.

" - }, - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Acquires an Elastic IP address.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AllocateHosts":{ - "name":"AllocateHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateHostsRequest"}, - "output":{"shape":"AllocateHostsResult"}, - "documentation":"

Allocates a Dedicated Host to your account. At minimum you need to specify the instance size type, Availability Zone, and quantity of hosts you want to allocate.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.

  • AWS Marketplace product codes are copied from the volume to the instance.

  • You must be subscribed to the product.

  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For an overview of the AWS Marketplace, see Introducing AWS Marketplace.

For more information about EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. For more information, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups for the same VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

You can have up to 50 rules per security group (covering both ingress and egress rules).

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

EC2-Classic: You can have up to 100 rules per group.

EC2-VPC: You can have up to 50 rules per group (covering both ingress and egress rules).

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more CIDR IP address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another.

[EC2-VPC] This action gives one or more CIDR IP address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

For more information, see Creating an Instance Store-Backed Windows AMI.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotFleetRequests":{ - "name":"CancelSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotFleetRequestsRequest"}, - "output":{"shape":"CancelSpotFleetRequestsResponse"}, - "documentation":"

Cancels the specified Spot fleet requests.

After you cancel a Spot fleet request, the Spot fleet launches no new Spot instances. You must specify whether the Spot fleet should also terminate its Spot instances. If you terminate the instances, the Spot fleet request enters the cancelled_terminating state. Otherwise, the Spot fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot instance requests. Spot instances are instances that Amazon EC2 starts on your behalf when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

Canceling a Spot instance request does not terminate running Spot instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner needs to verify whether another user's instance is eligible for support.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless the Encrypted flag is specified during the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a non-default CMK with the KmsKeyId parameter.

To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and may be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. If you want your instance to receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.

  • domain-name - If you're using AmazonProvidedDNS in \"us-east-1\", specify \"ec2.internal\". If you're using AmazonProvidedDNS in another region, specify \"region.compute.internal\" (for example, \"ap-northeast-1.compute.internal\"). Otherwise, specify a domain name (for example, \"MyCompany.com\"). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateFlowLogs":{ - "name":"CreateFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFlowLogsRequest"}, - "output":{"shape":"CreateFlowLogsResult"}, - "documentation":"

Creates one or more flow logs to capture IP traffic for a specific network interface, subnet, or VPC. Flow logs are delivered to a specified log group in Amazon CloudWatch Logs. If you specify a VPC or subnet in the request, a log stream is created in CloudWatch Logs for each network interface in the subnet or VPC. Log streams can include information about accepted and rejected traffic to a network interface. You can view the data in your log streams using Amazon CloudWatch Logs.

In your request, you must also specify an IAM role that has permission to publish logs to CloudWatch Logs.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an Internet gateway for use with a VPC. After creating the Internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and Internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{"shape":"KeyPair"}, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. To create a key pair that is available in all regions, use ImportKeyPair.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateNatGateway":{ - "name":"CreateNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNatGatewayRequest"}, - "output":{"shape":"CreateNatGatewayResult"}, - "documentation":"

Creates a NAT gateway in the specified subnet. A NAT gateway can be used to enable instances in a private subnet to connect to the Internet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group that you launch cluster instances into. You must give the group a name that's unique within the scope of your account.

For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.

The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "output":{"shape":"CreateRouteResult"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for 192.0.2.3, and the route table includes the following two routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 500 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{"shape":"Snapshot"}, - "documentation":"

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot instances, enabling you to view Spot instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and the CIDR block you want for the subnet. After you create a subnet, you can't change its CIDR block. The subnet's CIDR block can be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest subnet (and VPC) you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses).

AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported Resource-Level Permissions for Amazon EC2 API Actions in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{"shape":"Volume"}, - "documentation":"

Creates an EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified CIDR block.

The smallest VPC you can create uses a /28 netmask (16 IP addresses), and the largest uses a /16 netmask (65,536 IP addresses). To help you decide how big to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

By default, each instance you launch in the VPC has the default DHCP options, which includes only a default DNS server that we provide (AmazonProvidedDNS). For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

You can specify the instance tenancy value for the VPC when you create it. You can't change this value for the VPC after you create it. For more information, see Dedicated Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcEndpoint":{ - "name":"CreateVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointRequest"}, - "output":{"shape":"CreateVpcEndpointResult"}, - "documentation":"

Creates a VPC endpoint for a specified AWS service. An endpoint enables you to create a private connection between your VPC and another AWS service in your account. You can specify an endpoint policy to attach to the endpoint that will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.

Currently, only endpoints to Amazon S3 are supported.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and a peer VPC with which to create the connection. The peer VPC can belong to another AWS account. The requester VPC and peer VPC cannot have overlapping CIDR blocks.

The owner of the peer VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

A CreateVpcPeeringConnection request between VPCs with overlapping CIDR blocks results in the VPC peering connection having a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteFlowLogs":{ - "name":"DeleteFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFlowLogsRequest"}, - "output":{"shape":"DeleteFlowLogsResult"}, - "documentation":"

Deletes one or more flow logs.

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified Internet gateway. You must detach the Internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteNatGateway":{ - "name":"DeleteNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNatGatewayRequest"}, - "output":{"shape":"DeleteNatGatewayResult"}, - "documentation":"

Deletes the specified NAT gateway. Deleting a NAT gateway disassociates its Elastic IP address, but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway routes in your route tables.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot instances.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources. This call is designed to follow a DescribeTags request.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified EBS volume. The volume must be in the available state (not attached to an instance).

The volume may remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcEndpoints":{ - "name":"DeleteVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointsRequest"}, - "output":{"shape":"DeleteVpcEndpointsResult"}, - "documentation":"

Deletes one or more specified VPC endpoints. Deleting the endpoint also deletes the endpoint routes in the route tables that were associated with the endpoint.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the peer VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.

This command does not delete the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink; you cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see the VM Import/Export User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information about DHCP options sets, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeFlowLogs":{ - "name":"DescribeFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFlowLogsRequest"}, - "output":{"shape":"DescribeFlowLogsResult"}, - "documentation":"

Describes one or more flow logs. To view the information in your flow logs (the log streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs API.

" - }, - "DescribeHostReservationOfferings":{ - "name":"DescribeHostReservationOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationOfferingsRequest"}, - "output":{"shape":"DescribeHostReservationOfferingsResult"}, - "documentation":"

Describes the Dedicated Host Reservations that are available to purchase.

The results describe all the Dedicated Host Reservation offerings, including offerings that may not match the instance family and region of your Dedicated Hosts. When purchasing an offering, ensure that the the instance family and region of the offering matches that of the Dedicated Host/s it will be associated with. For an overview of supported instance types, see Dedicated Hosts Overview in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeHostReservations":{ - "name":"DescribeHostReservations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationsRequest"}, - "output":{"shape":"DescribeHostReservationsResult"}, - "documentation":"

Describes Dedicated Host Reservations which are associated with Dedicated Hosts in your account.

" - }, - "DescribeHosts":{ - "name":"DescribeHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostsRequest"}, - "output":{"shape":"DescribeHostsResult"}, - "documentation":"

Describes one or more of your Dedicated Hosts.

The results describe only the Dedicated Hosts in the region you're currently using. All listed instances consume capacity on your Dedicated Host. Dedicated Hosts that have recently been released will be listed with the state released.

" - }, - "DescribeIdFormat":{ - "name":"DescribeIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdFormatRequest"}, - "output":{"shape":"DescribeIdFormatResult"}, - "documentation":"

Describes the ID format settings for your resources on a per-region basis, for example, to view which resource types are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types.

The following resource types support longer IDs: instance | reservation | snapshot | volume.

These settings apply to the IAM user who makes the request; they do not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user, unless they explicitly override the settings by running the ModifyIdFormat command. Resources created with longer IDs are visible to all IAM users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "DescribeIdentityIdFormat":{ - "name":"DescribeIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityIdFormatRequest"}, - "output":{"shape":"DescribeIdentityIdFormatResult"}, - "documentation":"

Describes the ID format settings for resources for the specified IAM user, IAM role, or root user. For example, you can view the resource types that are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

The following resource types support longer IDs: instance | reservation | snapshot | volume.

These settings apply to the principal specified in the request. They do not apply to the principal that makes the request.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{"shape":"ImageAttribute"}, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Describes your import snapshot tasks.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances. By default, only running instances are described, unless specified otherwise.

Instance status includes the following components:

  • Status checks - Amazon EC2 performs status checks on running EC2 instances to identify hardware and software issues. For more information, see Status Checks for Your Instances and Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide.

  • Scheduled events - Amazon EC2 can schedule events (such as reboot, stop, or terminate) for your instances related to hardware issues, software updates, or system maintenance. For more information, see Scheduled Events for Your Instances in the Amazon Elastic Compute Cloud User Guide.

  • Instance state - You can manage your instances from the moment you launch them through their termination. For more information, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If you describe instances in the rare case where an Availability Zone is experiencing a service disruption and you specify instance IDs that are in the affected zone, or do not specify any instance IDs at all, the call fails. If you describe instances and specify only instance IDs that are in an unaffected zone, the call works normally.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your Internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeMovingAddresses":{ - "name":"DescribeMovingAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMovingAddressesRequest"}, - "output":{"shape":"DescribeMovingAddressesResult"}, - "documentation":"

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

" - }, - "DescribeNatGateways":{ - "name":"DescribeNatGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNatGatewaysRequest"}, - "output":{"shape":"DescribeNatGatewaysResult"}, - "documentation":"

Describes one or more of the your NAT gateways.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information about placement groups and cluster instances, see Cluster Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribePrefixLists":{ - "name":"DescribePrefixLists", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrefixListsRequest"}, - "output":{"shape":"DescribePrefixListsResult"}, - "documentation":"

Describes available AWS services in a prefix list format, which includes the prefix list name and prefix list ID of the service and the IP address range for the service. A prefix list ID is required for creating an outbound security group rule that allows traffic from a VPC to access an AWS service through a VPC endpoint.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

If you have listed your own Reserved Instances for sale in the Reserved Instance Marketplace, they will be excluded from these results. This is to ensure that you do not purchase your own Reserved Instances.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeScheduledInstanceAvailability":{ - "name":"DescribeScheduledInstanceAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstanceAvailabilityRequest"}, - "output":{"shape":"DescribeScheduledInstanceAvailabilityResult"}, - "documentation":"

Finds available schedules that meet the specified criteria.

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

After you find a schedule that meets your needs, call PurchaseScheduledInstances to purchase Scheduled Instances with that schedule.

" - }, - "DescribeScheduledInstances":{ - "name":"DescribeScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstancesRequest"}, - "output":{"shape":"DescribeScheduledInstancesResult"}, - "documentation":"

Describes one or more of your Scheduled Instances.

" - }, - "DescribeSecurityGroupReferences":{ - "name":"DescribeSecurityGroupReferences", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupReferencesRequest"}, - "output":{"shape":"DescribeSecurityGroupReferencesResult"}, - "documentation":"

[EC2-VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.

  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.

  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners using the OwnerIds option, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot instances. For more information, see Spot Instance Data Feed in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotFleetInstances":{ - "name":"DescribeSpotFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetInstancesRequest"}, - "output":{"shape":"DescribeSpotFleetInstancesResponse"}, - "documentation":"

Describes the running instances for the specified Spot fleet.

" - }, - "DescribeSpotFleetRequestHistory":{ - "name":"DescribeSpotFleetRequestHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestHistoryRequest"}, - "output":{"shape":"DescribeSpotFleetRequestHistoryResponse"}, - "documentation":"

Describes the events for the specified Spot fleet request during the specified time.

Spot fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event.

" - }, - "DescribeSpotFleetRequests":{ - "name":"DescribeSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestsRequest"}, - "output":{"shape":"DescribeSpotFleetRequestsResponse"}, - "documentation":"

Describes your Spot fleet requests.

Spot fleet requests are deleted 48 hours after they are canceled and their instances are terminated.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the Spot instance requests that belong to your account. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

You can use DescribeSpotInstanceRequests to find a running Spot instance by examining the response. If the status of the Spot instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

Spot instance requests are deleted 4 hours after they are canceled and their instances are terminated.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot price history. The prices returned are listed in chronological order, from the oldest to the most recent, for up to the past 90 days. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeStaleSecurityGroups":{ - "name":"DescribeStaleSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStaleSecurityGroupsRequest"}, - "output":{"shape":"DescribeStaleSecurityGroupsResult"}, - "documentation":"

[EC2-VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information on volume status, see Monitoring the Status of Your Volumes.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcClassicLinkDnsSupport":{ - "name":"DescribeVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DescribeVpcClassicLinkDnsSupportResult"}, - "documentation":"

Describes the ClassicLink DNS support status of one or more VPCs. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcEndpointServices":{ - "name":"DescribeVpcEndpointServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicesRequest"}, - "output":{"shape":"DescribeVpcEndpointServicesResult"}, - "documentation":"

Describes all supported AWS services that can be specified when creating a VPC endpoint.

" - }, - "DescribeVpcEndpoints":{ - "name":"DescribeVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointsRequest"}, - "output":{"shape":"DescribeVpcEndpointsResult"}, - "documentation":"

Describes one or more of your VPC endpoints.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see Adding a Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see Adding an IPsec Hardware VPN to Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisableVpcClassicLinkDnsSupport":{ - "name":"DisableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DisableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Disables ClassicLink DNS support for a VPC. If disabled, DNS hostnames resolve to public IP addresses when addressed between a linked EC2-Classic instance and instances in the VPC to which it's linked. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC's route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "EnableVpcClassicLinkDnsSupport":{ - "name":"EnableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"EnableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Enables a VPC to support DNS hostname resolution for ClassicLink. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information about ClassicLink, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output includes output from the EC2Config service.

" - }, - "GetConsoleScreenshot":{ - "name":"GetConsoleScreenshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleScreenshotRequest"}, - "output":{"shape":"GetConsoleScreenshotResult"}, - "documentation":"

Retrieve a JPG-format screenshot of a running instance to help with troubleshooting.

The returned content is Base64-encoded.

" - }, - "GetHostReservationPurchasePreview":{ - "name":"GetHostReservationPurchasePreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetHostReservationPurchasePreviewRequest"}, - "output":{"shape":"GetHostReservationPurchasePreviewResult"}, - "documentation":"

Preview a reservation purchase with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation.

This is a preview of the PurchaseHostReservation action and does not result in the offering being purchased.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for an instance running Windows.

The Windows password is generated at boot if the EC2Config service plugin, Ec2SetPassword, is enabled. This usually only happens the first time an AMI is launched, and then Ec2SetPassword is automatically disabled. The password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

Password generation and encryption takes a few moments. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "GetReservedInstancesExchangeQuote":{ - "name":"GetReservedInstancesExchangeQuote", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservedInstancesExchangeQuoteRequest"}, - "output":{"shape":"GetReservedInstancesExchangeQuoteResult"}, - "documentation":"

Returns details about the values and term of your specified Convertible Reserved Instances. When an offering ID is specified it returns information about whether the exchange is valid and can be performed.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI). For more information, see Importing a VM as an Image Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Imports a disk into an EBS snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image.For more information, see Importing Disks to Amazon EBS.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ModifyHosts":{ - "name":"ModifyHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHostsRequest"}, - "output":{"shape":"ModifyHostsResult"}, - "documentation":"

Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, AWS will place instances that you launch with a tenancy of host, but without targeting a specific host ID, onto any available Dedicated Host in your account which has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID if you want the instance to launch onto a specific host. If no host ID is provided, the instance will be launched onto a suitable host which has auto-placement enabled.

" - }, - "ModifyIdFormat":{ - "name":"ModifyIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdFormatRequest"}, - "documentation":"

Modifies the ID format for the specified resource on a per-region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created. The following resource types support longer IDs: instance | reservation | snapshot | volume.

This setting applies to the IAM user who makes the request; it does not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyIdentityIdFormat":{ - "name":"ModifyIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdentityIdFormatRequest"}, - "documentation":"

Modifies the ID format of a resource for a specified IAM user, IAM role, or the root user for an account; or all IAM users, IAM roles, and the root user for an account. You can specify that resources should receive longer IDs (17-character IDs) when they are created.

The following resource types support longer IDs: instance | reservation | snapshot | volume. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

This setting applies to the principal specified in the request; it does not apply to the principal that makes the request.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

The SriovNetSupport enhanced networking attribute cannot be changed using this command. Instead, enable SriovNetSupport on an instance and create an AMI from the instance. This will result in an image with SriovNetSupport enabled.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyInstancePlacement":{ - "name":"ModifyInstancePlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstancePlacementRequest"}, - "output":{"shape":"ModifyInstancePlacementResult"}, - "documentation":"

Set the instance affinity value for a specific stopped instance and modify the instance tenancy setting.

Instance affinity is disabled by default. When instance affinity is host and it is not associated with a specific Dedicated Host, the next time it is launched it will automatically be associated with the host it lands on. This relationship will persist if the instance is stopped/started, or rebooted.

You can modify the host ID associated with a stopped instance. If a stopped instance has a new host ID association, the instance will target that host when restarted.

You can modify the tenancy of a stopped instance with a tenancy of host or dedicated.

Affinity, hostID, and tenancy are not required parameters, but at least one of them must be specified in the request. Affinity and tenancy can be modified in the same request, but tenancy can only be modified on instances that are stopped.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Standard Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

Encrypted snapshots and snapshots with AWS Marketplace product codes cannot be made public. Snapshots encrypted with your default CMK cannot be shared with other accounts.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySpotFleetRequest":{ - "name":"ModifySpotFleetRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySpotFleetRequestRequest"}, - "output":{"shape":"ModifySpotFleetRequestResponse"}, - "documentation":"

Modifies the specified Spot fleet request.

While the Spot fleet request is being modified, it is in the modifying state.

To scale up your Spot fleet, increase its target capacity. The Spot fleet launches the additional Spot instances according to the allocation strategy for the Spot fleet request. If the allocation strategy is lowestPrice, the Spot fleet launches instances using the Spot pool with the lowest price. If the allocation strategy is diversified, the Spot fleet distributes the instances across the Spot pools.

To scale down your Spot fleet, decrease its target capacity. First, the Spot fleet cancels any open bids that exceed the new target capacity. You can request that the Spot fleet terminate Spot instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot fleet terminates the instances with the highest price per unit. If the allocation strategy is diversified, the Spot fleet terminates instances across the Spot pools. Alternatively, you can request that the Spot fleet keep the fleet at its current size, but not replace any Spot instances that are interrupted or that you terminate manually.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "ModifyVpcEndpoint":{ - "name":"ModifyVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointRequest"}, - "output":{"shape":"ModifyVpcEndpointResult"}, - "documentation":"

Modifies attributes of a specified VPC endpoint. You can modify the policy associated with the endpoint, and you can add and remove route tables associated with the endpoint.

" - }, - "ModifyVpcPeeringConnectionOptions":{ - "name":"ModifyVpcPeeringConnectionOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcPeeringConnectionOptionsRequest"}, - "output":{"shape":"ModifyVpcPeeringConnectionOptionsResult"}, - "documentation":"

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

  • Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.

  • Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.

  • Enable/disable a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

If the peered VPCs are in different accounts, each owner must initiate a separate request to modify the peering connection options, depending on whether their VPC was the requester or accepter for the VPC peering connection. If the peered VPCs are in the same account, you can modify the requester and accepter options in the same request. To confirm which VPC is the accepter and requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MoveAddressToVpc":{ - "name":"MoveAddressToVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAddressToVpcRequest"}, - "output":{"shape":"MoveAddressToVpcResult"}, - "documentation":"

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The Elastic IP address must be allocated to your account for more than 24 hours, and it must not be associated with an instance. After the Elastic IP address is moved, it is no longer available for use in the EC2-Classic platform, unless you move it back using the RestoreAddressToClassic request. You cannot move an Elastic IP address that was originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.

" - }, - "PurchaseHostReservation":{ - "name":"PurchaseHostReservation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseHostReservationRequest"}, - "output":{"shape":"PurchaseHostReservationResult"}, - "documentation":"

Purchase a reservation with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation. This action results in the specified reservation being purchased and charged to your account.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "PurchaseScheduledInstances":{ - "name":"PurchaseScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseScheduledInstancesRequest"}, - "output":{"shape":"PurchaseScheduledInstancesResult"}, - "documentation":"

Purchases one or more Scheduled Instances with the specified schedule.

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, you must call RunScheduledInstances during each scheduled time period.

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If an instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from a snapshot of a root device volume. For more information, see Launching an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.

Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), use the EC2 billingProduct code associated with an AMI to verify subscription status for package updates. Creating an AMI from an EBS snapshot does not maintain this billing code, and subsequent instances launched from such an AMI will not be able to connect to package update infrastructure.

Similarly, although you can create a Windows AMI from a snapshot, you can't successfully launch an instance from the AMI.

To create Windows AMIs or to create AMIs for Linux operating systems that must retain AMI billing codes to work properly, see CreateImage.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to you. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you try to release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

" - }, - "ReleaseHosts":{ - "name":"ReleaseHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseHostsRequest"}, - "output":{"shape":"ReleaseHostsResult"}, - "documentation":"

When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, e.g., ModifyHosts. You must stop or terminate all instances on a host before it can be released.

When Dedicated Hosts are released, it make take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated hosts. Try waiting a few minutes, and then try again.

Released hosts will still appear in a DescribeHosts response.

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, or network interface.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotFleet":{ - "name":"RequestSpotFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotFleetRequest"}, - "output":{"shape":"RequestSpotFleetResponse"}, - "documentation":"

Creates a Spot fleet request.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot fleet requests Spot instances in the Spot pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot instances in your Spot fleet are in different Spot pools, you can improve the availability of your fleet.

For more information, see Spot Fleet Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot instance request. Spot instances are instances that Amazon EC2 launches when the bid price that you specify exceeds the current Spot price. Amazon EC2 periodically sets the Spot price based on available Spot Instance capacity and current Spot instance requests. For more information, see Spot Instance Requests in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the sourceDestCheck, the instance can be either running or stopped.

The sourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information on modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RestoreAddressToClassic":{ - "name":"RestoreAddressToClassic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreAddressToClassicRequest"}, - "output":{"shape":"RestoreAddressToClassicResult"}, - "documentation":"

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Removes one or more egress rules from a security group for EC2-VPC. This action doesn't apply to security groups for use in EC2-Classic. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be revoked.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. The values that you specify in the revoke request (for example, ports) must match the existing rule's values for the rule to be removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{"shape":"Reservation"}, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

When you launch an instance, it enters the pending state. After the instance is ready for you, it enters the running state. To check the state of your instance, call DescribeInstances.

To ensure faster instance launches, break up large requests into smaller batches. For example, create five separate launch requests for 100 instances each instead of one launch request for 500 instances.

To tag your instance, ensure that it is running as CreateTags requires a resource ID. For more information about tagging, see Tagging Your Amazon EC2 Resources.

If you don't specify a security group when launching an instance, Amazon EC2 uses the default security group. For more information, see Security Groups in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC only accounts] If you don't specify a subnet in the request, we choose a default subnet from your default VPC for you.

[EC2-Classic accounts] If you're launching into EC2-Classic and you don't specify an Availability Zone, we choose one for you.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

You can provide optional user data when launching an instance. For more information, see Instance Metadata in the Amazon Elastic Compute Cloud User Guide.

If any of the AMIs have a product code attached for which the user has not subscribed, RunInstances fails.

Some instance types can only be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID in the request, RunInstances fails. For more information, see Instance Types Available Only in a VPC.

For more information about troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RunScheduledInstances":{ - "name":"RunScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunScheduledInstancesRequest"}, - "output":{"shape":"RunScheduledInstancesResult"}, - "documentation":"

Launches the specified Scheduled Instances.

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, you can launch it again after a few minutes. For more information, see Scheduled Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed AMI that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance.

We don't charge hourly usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains, continues to persist your data, and you are charged for Amazon EBS volume usage. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple times within a single hour.

You can't start or stop Spot instances, and you can't stop instance store-backed instances.

When you stop an instance, we shut it down. You can restart your instance at any time. Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Stopping an instance is different to rebooting or terminating it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

If you specify multiple instances and the request fails (for example, because of a single incorrect instance ID), none of the instances are terminated.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the DeleteOnTermination block device mapping parameter set to true are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables monitoring for a running instance. For more information about monitoring instances, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "shapes":{ - "AcceptReservedInstancesExchangeQuoteRequest":{ - "type":"structure", - "required":["ReservedInstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ReservedInstanceIds":{ - "shape":"ReservedInstanceIdSet", - "documentation":"

The IDs of the Convertible Reserved Instances that you want to exchange for other Convertible Reserved Instances of the same or higher value.

", - "locationName":"ReservedInstanceId" - }, - "TargetConfigurations":{ - "shape":"TargetConfigurationRequestSet", - "documentation":"

The configurations of the Convertible Reserved Instance offerings you are purchasing in this exchange.

", - "locationName":"TargetConfiguration" - } - }, - "documentation":"

Contains the parameters for accepting the quote.

" - }, - "AcceptReservedInstancesExchangeQuoteResult":{ - "type":"structure", - "members":{ - "ExchangeId":{ - "shape":"String", - "documentation":"

The ID of the successful exchange.

", - "locationName":"exchangeId" - } - }, - "documentation":"

The result of the exchange and whether it was successful.

" - }, - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for AcceptVpcPeeringConnection.

" - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of AcceptVpcPeeringConnection.

" - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "ActiveInstance":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - } - }, - "documentation":"

Describes a running instance in a Spot fleet.

" - }, - "ActiveInstanceSet":{ - "type":"list", - "member":{ - "shape":"ActiveInstance", - "locationName":"item" - } - }, - "ActivityStatus":{ - "type":"string", - "enum":[ - "error", - "pending_fulfillment", - "pending_termination", - "fulfilled" - ] - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "Affinity":{ - "type":"string", - "enum":[ - "default", - "host" - ] - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - } - }, - "documentation":"

Contains the parameters for AllocateAddress.

" - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - } - }, - "documentation":"

Contains the output of AllocateAddress.

" - }, - "AllocateHostsRequest":{ - "type":"structure", - "required":[ - "InstanceType", - "Quantity", - "AvailabilityZone" - ], - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID.

Default: Enabled

", - "locationName":"autoPlacement" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

Specify the instance type that you want your Dedicated Hosts to be configured for. When you specify the instance type, that is the only instance type that you can launch onto that host.

", - "locationName":"instanceType" - }, - "Quantity":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts you want to allocate to your account with these parameters.

", - "locationName":"quantity" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the Dedicated Hosts.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Contains the parameters for AllocateHosts.

" - }, - "AllocateHostsResult":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"ResponseHostIdList", - "documentation":"

The ID of the allocated Dedicated Host. This is used when you want to launch an instance onto a specific host.

", - "locationName":"hostIdSet" - } - }, - "documentation":"

Contains the output of AllocateHosts.

" - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "AllocationState":{ - "type":"string", - "enum":[ - "available", - "under-assessment", - "permanent-failure", - "released", - "released-permanent-failure" - ] - }, - "AllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "diversified" - ] - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - } - }, - "documentation":"

Contains the parameters for AssignPrivateIpAddresses.

" - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] For a VPC in an EC2-Classic account, specify true to allow an Elastic IP address that is already associated with an instance or network interface to be reassociated with the specified instance or network interface. Otherwise, the operation fails. In a VPC in an EC2-VPC-only account, reassociation is automatic, therefore you can specify false to ensure the operation fails if the Elastic IP address is already associated with another resource.

", - "locationName":"allowReassociation" - } - }, - "documentation":"

Contains the parameters for AssociateAddress.

" - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateAddress.

" - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AssociateDhcpOptions.

" - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for AssociateRouteTable.

" - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID (needed to disassociate the route table).

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateRouteTable.

" - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId", - "Groups" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Contains the parameters for AttachClassicLinkVpc.

" - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of AttachClassicLinkVpc.

" - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for AttachInternetGateway.

" - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "InstanceId", - "DeviceIndex" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - } - }, - "documentation":"

Contains the parameters for AttachNetworkInterface.

" - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - }, - "documentation":"

Contains the output of AttachNetworkInterface.

" - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "VolumeId", - "InstanceId", - "Device" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name to expose to the instance (for example, /dev/sdh or xvdh).

" - } - }, - "documentation":"

Contains the parameters for AttachVolume.

" - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for AttachVpnGateway.

" - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of AttachVpnGateway.

" - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

The attribute value. The valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

The attribute value. Note that the value is case-sensitive.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a String.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To authorize outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupEgress.

" - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account number for the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all traffic. If you specify -1, traffic on all ports is allowed, regardless of any ports you specify.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. Can be used to specify multiple rules in a single command.

" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupIngress.

" - }, - "AutoPlacement":{ - "type":"string", - "enum":[ - "on", - "off" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - }, - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone.

", - "locationName":"zoneState" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":[ - "available", - "information", - "impaired", - "unavailable" - ] - }, - "AvailableCapacity":{ - "type":"structure", - "members":{ - "AvailableInstanceCapacity":{ - "shape":"AvailableInstanceCapacityList", - "documentation":"

The total number of instances that the Dedicated Host supports.

", - "locationName":"availableInstanceCapacity" - }, - "AvailableVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs available on the Dedicated Host.

", - "locationName":"availableVCpus" - } - }, - "documentation":"

The capacity information for instances launched onto the Dedicated Host.

" - }, - "AvailableInstanceCapacityList":{ - "type":"list", - "member":{ - "shape":"InstanceCapacity", - "locationName":"item" - } - }, - "BatchState":{ - "type":"string", - "enum":[ - "submitted", - "active", - "cancelled", - "failed", - "cancelled_running", - "cancelled_terminating", - "modifying" - ] - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - } - }, - "documentation":"

Contains the parameters for BundleInstance.

" - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of BundleInstance.

" - }, - "BundleTask":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBatchErrorCode":{ - "type":"string", - "enum":[ - "fleetRequestIdDoesNotExist", - "fleetRequestIdMalformed", - "fleetRequestNotInCancellableState", - "unexpectedError" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - } - }, - "documentation":"

Contains the parameters for CancelBundleTask.

" - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of CancelBundleTask.

" - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ReasonMessage":{ - "shape":"String", - "documentation":"

The reason for canceling the conversion task.

", - "locationName":"reasonMessage" - } - }, - "documentation":"

Contains the parameters for CancelConversionTask.

" - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for CancelExportTask.

" - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image or import snapshot task to be canceled.

" - }, - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - } - }, - "documentation":"

Contains the parameters for CancelImportTask.

" - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the task being canceled.

", - "locationName":"importTaskId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"state" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"previousState" - } - }, - "documentation":"

Contains the output for CancelImportTask.

" - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - }, - "documentation":"

Contains the parameters for CancelReservedInstancesListing.

" - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CancelReservedInstancesListing.

" - }, - "CancelSpotFleetRequestsError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"CancelBatchErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot fleet error.

" - }, - "CancelSpotFleetRequestsErrorItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "Error" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "Error":{ - "shape":"CancelSpotFleetRequestsError", - "documentation":"

The error.

", - "locationName":"error" - } - }, - "documentation":"

Describes a Spot fleet request that was not successfully canceled.

" - }, - "CancelSpotFleetRequestsErrorSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsErrorItem", - "locationName":"item" - } - }, - "CancelSpotFleetRequestsRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for a Spot fleet request if it is canceled successfully.

", - "locationName":"terminateInstances" - } - }, - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsResponse":{ - "type":"structure", - "members":{ - "UnsuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsErrorSet", - "documentation":"

Information about the Spot fleet requests that are not successfully canceled.

", - "locationName":"unsuccessfulFleetRequestSet" - }, - "SuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsSuccessSet", - "documentation":"

Information about the Spot fleet requests that are successfully canceled.

", - "locationName":"successfulFleetRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsSuccessItem":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "CurrentSpotFleetRequestState", - "PreviousSpotFleetRequestState" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "CurrentSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The current state of the Spot fleet request.

", - "locationName":"currentSpotFleetRequestState" - }, - "PreviousSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The previous state of the Spot fleet request.

", - "locationName":"previousSpotFleetRequestState" - } - }, - "documentation":"

Describes a Spot fleet request that was successfully canceled.

" - }, - "CancelSpotFleetRequestsSuccessSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsSuccessItem", - "locationName":"item" - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "ClassicLinkDnsSupport":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkDnsSupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether ClassicLink DNS support is enabled for the VPC.

", - "locationName":"classicLinkDnsSupported" - } - }, - "documentation":"

Describes the ClassicLink DNS support status of a VPC.

" - }, - "ClassicLinkDnsSupportList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkDnsSupport", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClientData":{ - "type":"structure", - "members":{ - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image, in GiB.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment about the disk upload.

" - } - }, - "documentation":"

Describes the client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "InstanceId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for ConfirmProductInstance.

" - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - }, - "Return":{ - "shape":"Boolean", - "documentation":"

The return value of the request. Returns true if the specified product code is owned by the requester and associated with the specified instance.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ConfirmProductInstance.

" - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "required":[ - "ConversionTaskId", - "State" - ], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the task.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceImageId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshots of the copied image should be encrypted. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when encrypting the snapshots of an image during a copy operation. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopyImage.

" - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CopyImage.

" - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to copy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

CopySnapshot sends the snapshot copy to the regional endpoint that you send the HTTP request to, such as ec2.us-east-1.amazonaws.com (in the AWS CLI, this is specified with the --region parameter or the default region in your AWS configuration file).

", - "locationName":"destinationRegion" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

The pre-signed URL that facilitates copying an encrypted snapshot. This parameter is only required when copying an encrypted snapshot with the Amazon EC2 Query API; it is available as an optional parameter in all other cases. The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshot should be encrypted. You can encrypt a copy of an unencrypted snapshot using this flag, but you cannot use it to create an unencrypted copy from an encrypted snapshot. Your default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when creating the snapshot copy. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. The specified CMK must exist in the region that the snapshot is being copied to. If a KmsKeyId is specified, the Encrypted flag must also be set.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Contains the parameters for CopySnapshot.

" - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - }, - "documentation":"

Contains the output of CopySnapshot.

" - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "Type", - "PublicIp", - "BgpAsn" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - } - }, - "documentation":"

Contains the parameters for CreateCustomerGateway.

" - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - }, - "documentation":"

Contains the output of CreateCustomerGateway.

" - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - } - }, - "documentation":"

Contains the parameters for CreateDhcpOptions.

" - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - }, - "documentation":"

Contains the output of CreateDhcpOptions.

" - }, - "CreateFlowLogsRequest":{ - "type":"structure", - "required":[ - "ResourceIds", - "ResourceType", - "TrafficType", - "LogGroupName", - "DeliverLogsPermissionArn" - ], - "members":{ - "ResourceIds":{ - "shape":"ValueStringList", - "documentation":"

One or more subnet, network interface, or VPC IDs.

Constraints: Maximum of 1000 resources

", - "locationName":"ResourceId" - }, - "ResourceType":{ - "shape":"FlowLogsResourceType", - "documentation":"

The type of resource on which to create the flow log.

" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic to log.

" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch log group.

" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that's used to post flow logs to a CloudWatch Logs log group.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateFlowLogs.

" - }, - "CreateFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the flow logs.

", - "locationName":"flowLogIdSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be created successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of CreateFlowLogs.

" - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, Amazon EC2 attempts to shut down and reboot the instance before creating the image. If the 'No Reboot' option is set, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Contains the parameters for CreateImage.

" - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CreateImage.

" - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "documentation":"

The format and location for an instance export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Contains the parameters for CreateInstanceExportTask.

" - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "documentation":"

Information about the instance export task.

", - "locationName":"exportTask" - } - }, - "documentation":"

Contains the output for CreateInstanceExportTask.

" - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateInternetGateway.

" - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the Internet gateway.

", - "locationName":"internetGateway" - } - }, - "documentation":"

Contains the output of CreateInternetGateway.

" - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - } - }, - "documentation":"

Contains the parameters for CreateKeyPair.

" - }, - "CreateNatGatewayRequest":{ - "type":"structure", - "required":[ - "SubnetId", - "AllocationId" - ], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The subnet in which to create the NAT gateway.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of an Elastic IP address to associate with the NAT gateway. If the Elastic IP address is associated with another resource, you must first disassociate it.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

Constraint: Maximum 64 ASCII characters.

" - } - }, - "documentation":"

Contains the parameters for CreateNatGateway.

" - }, - "CreateNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGateway":{ - "shape":"NatGateway", - "documentation":"

Information about the NAT gateway.

", - "locationName":"natGateway" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateNatGateway.

" - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766. The range 32767 to 65535 is reserved for internal use.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying ICMP for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAclEntry.

" - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAcl.

" - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - }, - "documentation":"

Contains the output of CreateNetworkAcl.

" - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IP address of the network interface. If you don't specify an IP address, Amazon EC2 selects one for you from the subnet range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses to assign to a network interface. When you specify a number of secondary IP addresses, Amazon EC2 selects these IP addresses within the subnet range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see Private IP Addresses Per ENI Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateNetworkInterface.

" - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - }, - "documentation":"

Contains the output of CreateNetworkInterface.

" - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - }, - "documentation":"

Contains the parameters for CreatePlacementGroup.

" - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesId", - "InstanceCount", - "PriceSchedules", - "ClientToken" - ], - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Standard Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Standard Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the parameters for CreateReservedInstancesListing.

" - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Standard Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CreateReservedInstancesListing.

" - }, - "CreateRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for CreateRoute.

" - }, - "CreateRouteResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of CreateRoute.

" - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateRouteTable.

" - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - }, - "documentation":"

Contains the output of CreateRouteTable.

" - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Description" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for CreateSecurityGroup.

" - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Contains the output of CreateSecurityGroup.

" - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - } - }, - "documentation":"

Contains the parameters for CreateSnapshot.

" - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot instance data feed.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - }, - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "VpcId", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: AWS selects one for you. If you create more than one subnet in your VPC, we may not necessarily select a different zone for each subnet.

" - } - }, - "documentation":"

Contains the parameters for CreateSubnet.

" - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - }, - "documentation":"

Contains the output of CreateSubnet.

" - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - }, - "documentation":"

Contains the parameters for CreateTags.

" - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - } - }, - "documentation":"

Describes the user or group to be added or removed from the permissions for a volume.

" - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - }, - "documentation":"

Describes modifications to the permissions for a volume.

" - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-16384 for gp2, 4-16384 for io1, 500-16384 for st1, 500-16384 for sc1, and 1-1024 for standard. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

Only valid for Provisioned IOPS SSD volumes. The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 30 IOPS/GiB.

Constraint: Range is 100 to 20000 for Provisioned IOPS SSD volumes

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. The ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. If a KmsKeyId is specified, the Encrypted flag must also be set.

" - } - }, - "documentation":"

Contains the parameters for CreateVolume.

" - }, - "CreateVpcEndpointRequest":{ - "type":"structure", - "required":[ - "VpcId", - "ServiceName" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the endpoint will be used.

" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The AWS service name, in the form com.amazonaws.region.service . To get a list of available services, use the DescribeVpcEndpointServices request.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy to attach to the endpoint that controls access to the service. The policy must be in valid JSON format. If this parameter is not specified, we attach a default policy that allows full access to the service.

" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

", - "locationName":"RouteTableId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - }, - "documentation":"

Contains the parameters for CreateVpcEndpoint.

" - }, - "CreateVpcEndpointResult":{ - "type":"structure", - "members":{ - "VpcEndpoint":{ - "shape":"VpcEndpoint", - "documentation":"

Information about the endpoint.

", - "locationName":"vpcEndpoint" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateVpcEndpoint.

" - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC.

", - "locationName":"vpcId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection.

", - "locationName":"peerVpcId" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the peer VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - } - }, - "documentation":"

Contains the parameters for CreateVpcPeeringConnection.

" - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of CreateVpcPeeringConnection.

" - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy options for instances launched into the VPC. For default, instances are launched with shared tenancy by default. You can launch instances with any tenancy into a shared tenancy VPC. For dedicated, instances are launched as dedicated tenancy instances by default. You can only launch instances with a tenancy of dedicated or host into a dedicated tenancy VPC.

Important: The host value cannot be used with this parameter. Use the default or dedicated values only.

Default: default

", - "locationName":"instanceTenancy" - } - }, - "documentation":"

Contains the parameters for CreateVpc.

" - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - }, - "documentation":"

Contains the output of CreateVpc.

" - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "Type", - "CustomerGatewayId", - "VpnGatewayId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

Indicates whether the VPN connection requires static routes. If you are creating a VPN connection for a device that does not support BGP, you must specify true.

Default: false

", - "locationName":"options" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnection.

" - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - }, - "documentation":"

Contains the output of CreateVpnConnection.

" - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnectionRoute.

" - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnGateway.

" - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - }, - "documentation":"

Contains the output of CreateVpnGateway.

" - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteCustomerGateway.

" - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - } - }, - "documentation":"

Contains the parameters for DeleteDhcpOptions.

" - }, - "DeleteFlowLogsRequest":{ - "type":"structure", - "required":["FlowLogIds"], - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - } - }, - "documentation":"

Contains the parameters for DeleteFlowLogs.

" - }, - "DeleteFlowLogsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteFlowLogs.

" - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - } - }, - "documentation":"

Contains the parameters for DeleteInternetGateway.

" - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - } - }, - "documentation":"

Contains the parameters for DeleteKeyPair.

" - }, - "DeleteNatGatewayRequest":{ - "type":"structure", - "required":["NatGatewayId"], - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteNatGateway.

" - }, - "DeleteNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the output of DeleteNatGateway.

" - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Egress" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAclEntry.

" - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAcl.

" - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkInterface.

" - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - }, - "documentation":"

Contains the parameters for DeletePlacementGroup.

" - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - } - }, - "documentation":"

Contains the parameters for DeleteRoute.

" - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for DeleteRouteTable.

" - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteSecurityGroup.

" - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - } - }, - "documentation":"

Contains the parameters for DeleteSnapshot.

" - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - }, - "documentation":"

Contains the parameters for DeleteSubnet.

" - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d. You can specify more than one resource ID.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. If you omit the value parameter, we delete the tag regardless of its value. If you specify this parameter with an empty string as the value, we delete the key only if its value is an empty string.

", - "locationName":"tag" - } - }, - "documentation":"

Contains the parameters for DeleteTags.

" - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - } - }, - "documentation":"

Contains the parameters for DeleteVolume.

" - }, - "DeleteVpcEndpointsRequest":{ - "type":"structure", - "required":["VpcEndpointIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcEndpoints.

" - }, - "DeleteVpcEndpointsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the endpoints that were not successfully deleted.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteVpcEndpoints.

" - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcPeeringConnection.

" - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DeleteVpcPeeringConnection.

" - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpc.

" - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnection.

" - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "VpnConnectionId", - "DestinationCidrBlock" - ], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnectionRoute.

" - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnGateway.

" - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - } - }, - "documentation":"

Contains the parameters for DeregisterImage.

" - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - } - }, - "documentation":"

Contains the parameters for DescribeAccountAttributes.

" - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - }, - "documentation":"

Contains the output of DescribeAccountAttributes.

" - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

", - "locationName":"Filter" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - } - }, - "documentation":"

Contains the parameters for DescribeAddresses.

" - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - }, - "documentation":"

Contains the output of DescribeAddresses.

" - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | information | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeAvailabilityZones.

" - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - }, - "documentation":"

Contains the output of DescribeAvailabiltyZones.

" - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeBundleTasks.

" - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - }, - "documentation":"

Contains the output of DescribeBundleTasks.

" - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeClassicLinkInstances.

" - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeClassicLinkInstances.

" - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeConversionTasks.

" - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "documentation":"

Information about the conversion tasks.

", - "locationName":"conversionTasks" - } - }, - "documentation":"

Contains the output for DescribeConversionTasks.

" - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeCustomerGateways.

" - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeCustomerGateways.

" - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeDhcpOptions.

" - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - }, - "documentation":"

Contains the output of DescribeDhcpOptions.

" - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeExportTasks.

" - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "documentation":"

Information about the export tasks.

", - "locationName":"exportTaskSet" - } - }, - "documentation":"

Contains the output for DescribeExportTasks.

" - }, - "DescribeFlowLogsRequest":{ - "type":"structure", - "members":{ - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • deliver-log-status - The status of the logs delivery (SUCCESS | FAILED).

  • flow-log-id - The ID of the flow log.

  • log-group-name - The name of the log group.

  • resource-id - The ID of the VPC, subnet, or network interface.

  • traffic-type - The type of traffic (ACCEPT | REJECT | ALL)

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the flow log IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeFlowLogs.

" - }, - "DescribeFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogs":{ - "shape":"FlowLogSet", - "documentation":"

Information about the flow logs.

", - "locationName":"flowLogSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeFlowLogs.

" - }, - "DescribeHostReservationOfferingsRequest":{ - "type":"structure", - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation offering.

" - }, - "MinDuration":{ - "shape":"Integer", - "documentation":"

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

" - }, - "MaxDuration":{ - "shape":"Integer", - "documentation":"

This is the maximum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family of the offering (e.g., m4).

  • payment-option - The payment option (No Upfront | Partial Upfront | All Upfront).

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - } - } - }, - "DescribeHostReservationOfferingsResult":{ - "type":"structure", - "members":{ - "OfferingSet":{ - "shape":"HostOfferingSet", - "documentation":"

Information about the offerings.

", - "locationName":"offeringSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostReservationsRequest":{ - "type":"structure", - "members":{ - "HostReservationIdSet":{ - "shape":"HostReservationIdSet", - "documentation":"

One or more host reservation IDs.

" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family (e.g., m4).

  • payment-option - The payment option (No Upfront | Partial Upfront | All Upfront).

  • state - The state of the reservation (payment-pending | payment-failed | active | retired).

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - } - } - }, - "DescribeHostReservationsResult":{ - "type":"structure", - "members":{ - "HostReservationSet":{ - "shape":"HostReservationSet", - "documentation":"

Details about the reservation's configuration.

", - "locationName":"hostReservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostsRequest":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts. The IDs are used for targeted instance launches.

", - "locationName":"hostId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500; if maxResults is given a larger value than 500, you will receive an error. You cannot specify this parameter and the host IDs parameter in the same request.

", - "locationName":"maxResults" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-type - The instance type size that the Dedicated Host is configured to support.

  • auto-placement - Whether auto-placement is enabled or disabled (on | off).

  • host-reservation-id - The ID of the reservation assigned to this host.

  • client-token - The idempotency token you provided when you launched the instance

  • state- The allocation state of the Dedicated Host (available | under-assessment | permanent-failure | released | released-permanent-failure).

  • availability-zone - The Availability Zone of the host.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeHosts.

" - }, - "DescribeHostsResult":{ - "type":"structure", - "members":{ - "Hosts":{ - "shape":"HostList", - "documentation":"

Information about the Dedicated Hosts.

", - "locationName":"hostSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeHosts.

" - }, - "DescribeIdFormatRequest":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

" - } - }, - "documentation":"

Contains the parameters for DescribeIdFormat.

" - }, - "DescribeIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resource.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdFormat.

" - }, - "DescribeIdentityIdFormatRequest":{ - "type":"structure", - "required":["PrincipalArn"], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

", - "locationName":"resource" - }, - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM role, IAM user, or the root user.

", - "locationName":"principalArn" - } - }, - "documentation":"

Contains the parameters for DescribeIdentityIdFormat.

" - }, - "DescribeIdentityIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resources.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdentityIdFormat.

" - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - } - }, - "documentation":"

Contains the parameters for DescribeImageAttribute.

" - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, self (owner is the sender of the request), or an AWS owner alias (valid values are amazon | aws-marketplace | microsoft). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the EBS volume.

  • block-device-mapping.volume-size - The volume size of the EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the EBS volume (gp2 | io1 | st1 | sc1 | standard).

  • description - The description of the image (provided during image creation).

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - String value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeImages.

" - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - }, - "documentation":"

Contains the output of DescribeImages.

" - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import image task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportImageTasks.

" - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportImageTasks.

" - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import snapshot task IDs.

", - "locationName":"ImportTaskId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportSnapshotTasks.

" - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportSnapshotTasks.

" - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

Note: The enaSupport attribute is not supported at this time.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceAttribute.

" - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code for the scheduled event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • event.not-before - The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • instance-state-code - The code for the instance state, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceStatus.

" - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstanceStatus.

" - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • affinity - The affinity setting for an instance running on a Dedicated Host (default | host).

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name for the EBS volume (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • host-id - The ID of the Dedicated Host on which the instance is running, if applicable.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance or a Scheduled Instance (spot | scheduled).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IP address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether monitoring is enabled for the instance (disabled | enabled).

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private DNS name of the instance.

  • private-ip-address - The private IP address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you'll get one reservation ID. If you launch ten instances using the same launch request, you'll also get one reservation ID.

  • root-device-name - The name of the root device for the instance (for example, /dev/sda1 or /dev/xvda).

  • root-device-type - The type of root device that the instance uses (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:key=value - The key/value combination of a tag assigned to the resource, where tag:key is the tag's key.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • tenancy - The tenancy of an instance (dedicated | default | host).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

  • network-interface.description - The description of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface.private-dns-name - The private DNS name of the network interface.

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.addresses.private-ip-address - The private IP address associated with the network interface.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.addresses.primary - Specifies whether the IP address of the network interface is the primary private IP address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter or tag filters in the same call.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeInstances.

" - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

Zero or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstances.

" - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more Internet gateway IDs.

Default: Describes all your Internet gateways.

", - "locationName":"internetGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeInternetGateways.

" - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more Internet gateways.

", - "locationName":"internetGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeInternetGateways.

" - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeKeyPairs.

" - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - }, - "documentation":"

Contains the output of DescribeKeyPairs.

" - }, - "DescribeMovingAddressesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIps":{ - "shape":"ValueStringList", - "documentation":"

One or more Elastic IP addresses.

", - "locationName":"publicIp" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • moving-status - The status of the Elastic IP address (MovingToVpc | RestoringToClassic).

", - "locationName":"filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value outside of this range, an error is returned.

Default: If no value is provided, the default is 1000.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeMovingAddresses.

" - }, - "DescribeMovingAddressesResult":{ - "type":"structure", - "members":{ - "MovingAddressStatuses":{ - "shape":"MovingAddressStatusSet", - "documentation":"

The status for each Elastic IP address.

", - "locationName":"movingAddressStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeMovingAddresses.

" - }, - "DescribeNatGatewaysRequest":{ - "type":"structure", - "members":{ - "NatGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more NAT gateway IDs.

", - "locationName":"NatGatewayId" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • nat-gateway-id - The ID of the NAT gateway.

  • state - The state of the NAT gateway (pending | failed | available | deleting | deleted).

  • subnet-id - The ID of the subnet in which the NAT gateway resides.

  • vpc-id - The ID of the VPC in which the NAT gateway resides.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeNatGateways.

" - }, - "DescribeNatGatewaysResult":{ - "type":"structure", - "members":{ - "NatGateways":{ - "shape":"NatGatewayList", - "documentation":"

Information about the NAT gateways.

", - "locationName":"natGatewaySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeNatGateways.

" - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkAcls.

" - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkAcls.

" - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IP addresses associated with the network interface.

  • addresses.primary - Whether the private IP address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address.

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IP address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address associated with the network interface.

  • association.public-ip - The address of the Elastic IP address bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface.

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.nat-gateway-id - The ID of the NAT gateway to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IP address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaces.

" - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaces.

" - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribePlacementGroups.

" - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - }, - "documentation":"

Contains the output of DescribePlacementGroups.

" - }, - "DescribePrefixListsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "PrefixListIds":{ - "shape":"ValueStringList", - "documentation":"

One or more prefix list IDs.

", - "locationName":"PrefixListId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribePrefixLists.

" - }, - "DescribePrefixListsResult":{ - "type":"structure", - "members":{ - "PrefixLists":{ - "shape":"PrefixListSet", - "documentation":"

All available prefix lists.

", - "locationName":"prefixListSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribePrefixLists.

" - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRegions.

" - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - }, - "documentation":"

Contains the output of DescribeRegions.

" - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance listing IDs.

", - "locationName":"reservedInstancesListingId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type that the reservation will cover (for example, m1.small). For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from both AWS and the Reserved Instance Marketplace are listed.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC))

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • scope - The scope of the Reserved Instance (Availability Zone or Region).

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated Instances).

Default: default

", - "locationName":"instanceTenancy" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Reserved Instance Marketplace offerings in the response.

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

The offering class of the Reserved Instance. Can be standard or convertible.

" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • scope - The scope of the Reserved Instance (Region or Availability Zone).

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

Describes whether the Reserved Instance is Standard or Convertible.

" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstances.

" - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - }, - "documentation":"

Contains the output for DescribeReservedInstances.

" - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC (true | false).

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The CIDR range specified in a route in the table.

  • route.destination-prefix-list-id - The ID (prefix) of the AWS service specified in a route in the table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.nat-gateway-id - The ID of a NAT gateway.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeRouteTables.

" - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - }, - "documentation":"

Contains the output of DescribeRouteTables.

" - }, - "DescribeScheduledInstanceAvailabilityRequest":{ - "type":"structure", - "required":[ - "Recurrence", - "FirstSlotStartTimeRange" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrenceRequest", - "documentation":"

The schedule recurrence.

" - }, - "FirstSlotStartTimeRange":{ - "shape":"SlotDateTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "MinSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

" - }, - "MaxSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstanceAvailabilityResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceAvailabilitySet":{ - "shape":"ScheduledInstanceAvailabilitySet", - "documentation":"

Information about the available Scheduled Instances.

", - "locationName":"scheduledInstanceAvailabilitySet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ScheduledInstanceIds":{ - "shape":"ScheduledInstanceIdRequestSet", - "documentation":"

One or more Scheduled Instance IDs.

", - "locationName":"ScheduledInstanceId" - }, - "SlotStartTimeRange":{ - "shape":"SlotStartTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 100. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstances.

" - }, - "DescribeScheduledInstancesResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceSet":{ - "shape":"ScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstances.

" - }, - "DescribeSecurityGroupReferencesRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"GroupIds", - "documentation":"

One or more security group IDs in your account.

" - } - } - }, - "DescribeSecurityGroupReferencesResult":{ - "type":"structure", - "members":{ - "SecurityGroupReferenceSet":{ - "shape":"SecurityGroupReferences", - "documentation":"

Information about the VPCs with the referencing security groups.

", - "locationName":"securityGroupReferenceSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.

  • description - The description of the security group.

  • egress.ip-permission.prefix-list-id - The ID (prefix) of the AWS service to which the security group allows access.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - A CIDR range that has been granted permission.

  • ip-permission.from-port - The start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been granted permission.

  • ip-permission.group-name - The name of a security group that has been granted permission.

  • ip-permission.protocol - The IP protocol for the permission (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - The end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been granted permission.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag-key - The key of a tag assigned to the security group.

  • tag-value - The value of a tag assigned to the security group.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSecurityGroups.

" - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - } - }, - "documentation":"

Contains the output of DescribeSecurityGroups.

" - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

", - "locationName":"snapshotId" - }, - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM consolew.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshots.

" - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSnapshots.

" - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotFleetInstancesRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetInstancesResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "ActiveInstances" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. Note that this list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetRequestHistoryRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The type of events to describe. By default, all events are described.

", - "locationName":"eventType" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestHistoryResponse":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime", - "LastEvaluatedTime", - "HistoryRecords" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "HistoryRecords":{ - "shape":"HistoryRecords", - "documentation":"

Information about the events in the history of the Spot fleet request.

", - "locationName":"historyRecordSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "DescribeSpotFleetRequestsResponse":{ - "type":"structure", - "required":["SpotFleetRequestConfigs"], - "members":{ - "SpotFleetRequestConfigs":{ - "shape":"SpotFleetRequestConfigSet", - "documentation":"

Information about the configuration of your Spot fleet.

", - "locationName":"spotFleetRequestConfigSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot instance request IDs.

", - "locationName":"SpotInstanceRequestId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the Amazon EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the Amazon EBS volume (for example, /dev/sdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot used for the Amazon EBS volume.

  • launch.block-device-mapping.volume-size - The size of the Amazon EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of the Amazon EBS volume: gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1for Cold HDD, or standard for Magnetic.

  • launch.group-id - The security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m3.medium).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether monitoring is enabled for the Spot instance.

  • launch.ramdisk-id - The RAM disk ID.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • network-interface.description - A description of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.group-name - The name of the security group associated with the network interface.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot instance request ID.

  • spot-price - The maximum hourly price for any Spot instance launched to fulfill the request.

  • state - The state of the Spot instance request (open | active | closed | cancelled | failed). Spot bid status information can help you track your Amazon EC2 Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

  • status-code - The short code describing the most recent evaluation of your Spot instance request.

  • status-message - The message explaining the status of the Spot instance request.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of Spot instance request (one-time | persistent).

  • launched-availability-zone - The Availability Zone in which the bid is launched.

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m3.medium).

  • product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot prices.

", - "locationName":"spotPriceHistorySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "DescribeStaleSecurityGroupsRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - } - }, - "DescribeStaleSecurityGroupsResult":{ - "type":"structure", - "members":{ - "StaleSecurityGroupSet":{ - "shape":"StaleSecurityGroupSet", - "documentation":"

Information about the stale security groups.

", - "locationName":"staleSecurityGroupSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IP addresses in the subnet that are available.

  • cidrBlock - The CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeSubnets.

" - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - }, - "documentation":"

Contains the output of DescribeSubnets.

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | image | instance | internet-gateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeTags.

" - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return..

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeTags.

" - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The instance attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeAttribute.

" - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Contains the output of DescribeVolumeAttribute.

" - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeStatus.

" - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumeStatus.

" - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name that is exposed to the instance (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - } - }, - "documentation":"

Contains the parameters for DescribeVolumes.

" - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "documentation":"

Information about the volumes.

", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumes.

" - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":[ - "VpcId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcAttribute.

" - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - } - }, - "documentation":"

Contains the output of DescribeVpcAttribute.

" - }, - "DescribeVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPC IDs.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"ClassicLinkDnsSupportList", - "documentation":"

Information about the ClassicLink DNS support status of the VPCs.

", - "locationName":"vpcs" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLink.

" - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLink.

" - }, - "DescribeVpcEndpointServicesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointServicesResult":{ - "type":"structure", - "members":{ - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

A list of supported AWS services.

", - "locationName":"serviceNameSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the AWS service.

  • vpc-id: The ID of the VPC in which the endpoint resides.

  • vpc-endpoint-id: The ID of the endpoint.

  • vpc-endpoint-state: The state of the endpoint. (pending | available | deleting | deleted)

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpoints.

" - }, - "DescribeVpcEndpointsResult":{ - "type":"structure", - "members":{ - "VpcEndpoints":{ - "shape":"VpcEndpointSet", - "documentation":"

Information about the endpoints.

", - "locationName":"vpcEndpointSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpoints.

" - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id - The ID of the peer VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcPeeringConnections.

" - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpcPeeringConnections.

" - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • dhcp-options-id - The ID of a set of DHCP options.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpcs.

" - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcs.

" - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnConnections.

" - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpnConnections.

" - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway (if applicable).

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:key=value - The key/value combination of a tag assigned to the resource.

  • tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter \"tag-key=Purpose\" and the filter \"tag-value=X\", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag:key=value filter.

  • tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - } - }, - "documentation":"

Contains the parameters for DescribeVpnGateways.

" - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeVpnGateways.

" - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachClassicLinkVpc.

" - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DetachClassicLinkVpc.

" - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachInternetGateway.

" - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for DetachNetworkInterface.

" - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - } - }, - "documentation":"

Contains the parameters for DetachVolume.

" - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpnGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DetachVpnGateway.

" - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for DisableVgwRoutePropagation.

" - }, - "DisableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLink.

" - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLink.

" - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for DisassociateAddress.

" - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the parameters for DisassociateRouteTable.

" - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

Information about the disk image.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the disk image.

" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

Information about the volume.

" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "required":[ - "Format", - "Size", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"size" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - }, - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Format", - "Bytes", - "ImportManifestUrl" - ], - "members":{ - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "Bytes":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"bytes" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - }, - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - } - }, - "documentation":"

Describes a disk image volume.

" - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type: gp2, io1, st1, sc1, or standard.

Default: standard

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption.

", - "locationName":"encrypted" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a parameter used to set up an EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes information used to set up an EBS volume specified in a block device mapping.

" - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "GatewayId" - ], - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - } - }, - "documentation":"

Contains the parameters for EnableVgwRoutePropagation.

" - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Contains the parameters for EnableVolumeIO.

" - }, - "EnableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLink.

" - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLink.

" - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "EventInformation":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This information is available only for instanceChange events.

", - "locationName":"instanceId" - }, - "EventSubType":{ - "shape":"String", - "documentation":"

The event.

The following are the error events.

  • iamFleetRoleInvalid - The Spot fleet did not have the required permissions either to launch or terminate an instance.

  • launchSpecTemporarilyBlacklisted - The configuration is not valid and several attempts to launch instances have failed. For more information, see the description of the event.

  • spotFleetRequestConfigurationInvalid - The configuration is not valid. For more information, see the description of the event.

  • spotInstanceCountLimitExceeded - You've reached the limit on the number of Spot instances that you can launch.

The following are the fleetRequestChange events.

  • active - The Spot fleet has been validated and Amazon EC2 is attempting to maintain the target number of running Spot instances.

  • cancelled - The Spot fleet is canceled and has no running Spot instances. The Spot fleet will be deleted two days after its instances were terminated.

  • cancelled_running - The Spot fleet is canceled and will not launch additional Spot instances, but its existing Spot instances continue to run until they are interrupted or terminated.

  • cancelled_terminating - The Spot fleet is canceled and its Spot instances are terminating.

  • expired - The Spot fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration set.

  • modify_in_progress - A request to modify the Spot fleet request was accepted and is in progress.

  • modify_successful - The Spot fleet request was modified.

  • price_update - The bid price for a launch configuration was adjusted because it was too high. This change is permanent.

  • submitted - The Spot fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot instances.

The following are the instanceChange events.

  • launched - A bid was fulfilled and a new instance was launched.

  • terminated - An instance was terminated by the user.

", - "locationName":"eventSubType" - }, - "EventDescription":{ - "shape":"String", - "documentation":"

The description of the event.

", - "locationName":"eventDescription" - } - }, - "documentation":"

Describes a Spot fleet event.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "instanceChange", - "fleetRequestChange", - "error" - ] - }, - "ExcessCapacityTerminationPolicy":{ - "type":"string", - "enum":[ - "noTermination", - "default" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the export task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

Information about the instance to export.

", - "locationName":"instanceExport" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "documentation":"

Information about the export task.

", - "locationName":"exportToS3" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The encryption key for your S3 bucket.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the format and location for an instance export task.

" - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FleetType":{ - "type":"string", - "enum":[ - "request", - "maintain" - ] - }, - "Float":{"type":"float"}, - "FlowLog":{ - "type":"structure", - "members":{ - "CreationTime":{ - "shape":"DateTime", - "documentation":"

The date and time the flow log was created.

", - "locationName":"creationTime" - }, - "FlowLogId":{ - "shape":"String", - "documentation":"

The flow log ID.

", - "locationName":"flowLogId" - }, - "FlowLogStatus":{ - "shape":"String", - "documentation":"

The status of the flow log (ACTIVE).

", - "locationName":"flowLogStatus" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource on which the flow log was created.

", - "locationName":"resourceId" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic captured for the flow log.

", - "locationName":"trafficType" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the flow log group.

", - "locationName":"logGroupName" - }, - "DeliverLogsStatus":{ - "shape":"String", - "documentation":"

The status of the logs delivery (SUCCESS | FAILED).

", - "locationName":"deliverLogsStatus" - }, - "DeliverLogsErrorMessage":{ - "shape":"String", - "documentation":"

Information about the error that occurred. Rate limited indicates that CloudWatch logs throttling has been applied for one or more network interfaces, or that you've reached the limit on the number of CloudWatch Logs log groups that you can create. Access error indicates that the IAM role associated with the flow log does not have sufficient permissions to publish to CloudWatch Logs. Unknown error indicates an internal error.

", - "locationName":"deliverLogsErrorMessage" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that posts logs to CloudWatch Logs.

", - "locationName":"deliverLogsPermissionArn" - } - }, - "documentation":"

Describes a flow log.

" - }, - "FlowLogSet":{ - "type":"list", - "member":{ - "shape":"FlowLog", - "locationName":"item" - } - }, - "FlowLogsResourceType":{ - "type":"string", - "enum":[ - "VPC", - "Subnet", - "NetworkInterface" - ] - }, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - }, - "documentation":"

Contains the parameters for GetConsoleOutput.

" - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the output was last updated.

", - "locationName":"timestamp" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, Base64-encoded. If using a command line tool, the tool decodes the output for you.

", - "locationName":"output" - } - }, - "documentation":"

Contains the output of GetConsoleOutput.

" - }, - "GetConsoleScreenshotRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "WakeUp":{ - "shape":"Boolean", - "documentation":"

When set to true, acts as keystroke input and wakes up an instance that's in standby or \"sleep\" mode.

" - } - }, - "documentation":"

Contains the parameters for the request.

" - }, - "GetConsoleScreenshotResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageData":{ - "shape":"String", - "documentation":"

The data that comprises the image.

", - "locationName":"imageData" - } - }, - "documentation":"

Contains the output of the request.

" - }, - "GetHostReservationPurchasePreviewRequest":{ - "type":"structure", - "required":[ - "OfferingId", - "HostIdSet" - ], - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The offering ID of the reservation.

" - }, - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The ID/s of the Dedicated Host/s that the reservation will be associated with.

" - } - } - }, - "GetHostReservationPurchasePreviewResult":{ - "type":"structure", - "members":{ - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

The purchase information of the Dedicated Host Reservation and the Dedicated Hosts associated with it.

", - "locationName":"purchase" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The potential total upfront price. This is billed immediately.

", - "locationName":"totalUpfrontPrice" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The potential total hourly price of the reservation per hour.

", - "locationName":"totalHourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - } - }, - "documentation":"

Contains the parameters for GetPasswordData.

" - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance.

", - "locationName":"passwordData" - } - }, - "documentation":"

Contains the output of GetPasswordData.

" - }, - "GetReservedInstancesExchangeQuoteRequest":{ - "type":"structure", - "required":["ReservedInstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ReservedInstanceIds":{ - "shape":"ReservedInstanceIdSet", - "documentation":"

The ID/s of the Convertible Reserved Instances you want to exchange.

", - "locationName":"ReservedInstanceId" - }, - "TargetConfigurations":{ - "shape":"TargetConfigurationRequestSet", - "documentation":"

The configuration requirements of the Convertible Reserved Instances you want in exchange for your current Convertible Reserved Instances.

", - "locationName":"TargetConfiguration" - } - }, - "documentation":"

Contains the parameters for GetReservedInstanceExchangeQuote.

" - }, - "GetReservedInstancesExchangeQuoteResult":{ - "type":"structure", - "members":{ - "ReservedInstanceValueSet":{ - "shape":"ReservedInstanceReservationValueSet", - "documentation":"

The configuration of your Convertible Reserved Instances.

", - "locationName":"reservedInstanceValueSet" - }, - "ReservedInstanceValueRollup":{ - "shape":"ReservationValue", - "locationName":"reservedInstanceValueRollup" - }, - "TargetConfigurationValueSet":{ - "shape":"TargetReservationValueSet", - "documentation":"

The values of the target Convertible Reserved Instances.

", - "locationName":"targetConfigurationValueSet" - }, - "TargetConfigurationValueRollup":{ - "shape":"ReservationValue", - "locationName":"targetConfigurationValueRollup" - }, - "PaymentDue":{ - "shape":"String", - "documentation":"

The total true upfront charge for the exchange.

", - "locationName":"paymentDue" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency of the transaction.

", - "locationName":"currencyCode" - }, - "OutputReservedInstancesWillExpireAt":{ - "shape":"DateTime", - "documentation":"

The new end date of the reservation term.

", - "locationName":"outputReservedInstancesWillExpireAt" - }, - "IsValidExchange":{ - "shape":"Boolean", - "documentation":"

If true, the exchange is valid. If false, the exchange cannot be performed.

", - "locationName":"isValidExchange" - }, - "ValidationFailureReason":{ - "shape":"String", - "documentation":"

Describes the reason why the exchange can not be completed.

", - "locationName":"validationFailureReason" - } - }, - "documentation":"

Contains the output of GetReservedInstancesExchangeQuote.

" - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupIds":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HistoryRecord":{ - "type":"structure", - "required":[ - "Timestamp", - "EventType", - "EventInformation" - ], - "members":{ - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

  • error - Indicates an error with the Spot fleet request.

  • fleetRequestChange - Indicates a change in the status or configuration of the Spot fleet request.

  • instanceChange - Indicates that an instance was launched or terminated.

", - "locationName":"eventType" - }, - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - } - }, - "documentation":"

Describes an event in the history of the Spot fleet request.

" - }, - "HistoryRecords":{ - "type":"list", - "member":{ - "shape":"HistoryRecord", - "locationName":"item" - } - }, - "Host":{ - "type":"structure", - "members":{ - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Whether auto-placement is on or off.

", - "locationName":"autoPlacement" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The reservation ID of the Dedicated Host. This returns a null response if the Dedicated Host doesn't have an associated reservation.

", - "locationName":"hostReservationId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "HostProperties":{ - "shape":"HostProperties", - "documentation":"

The hardware specifications of the Dedicated Host.

", - "locationName":"hostProperties" - }, - "State":{ - "shape":"AllocationState", - "documentation":"

The Dedicated Host's state.

", - "locationName":"state" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the Dedicated Host.

", - "locationName":"availabilityZone" - }, - "Instances":{ - "shape":"HostInstanceList", - "documentation":"

The IDs and instance type that are currently running on the Dedicated Host.

", - "locationName":"instances" - }, - "AvailableCapacity":{ - "shape":"AvailableCapacity", - "documentation":"

The number of new instances that can be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - } - }, - "documentation":"

Describes the properties of the Dedicated Host.

" - }, - "HostInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

the IDs of instances that are running on the Dedicated Host.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size (for example, m3.medium) of the running instance.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes an instance running on a Dedicated Host.

" - }, - "HostInstanceList":{ - "type":"list", - "member":{ - "shape":"HostInstance", - "locationName":"item" - } - }, - "HostList":{ - "type":"list", - "member":{ - "shape":"Host", - "locationName":"item" - } - }, - "HostOffering":{ - "type":"structure", - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

", - "locationName":"offeringId" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the offering.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The available payment option.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the offering. Does not apply to No Upfront offerings.

", - "locationName":"upfrontPrice" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the offering.

", - "locationName":"hourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the offering.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering (in seconds).

", - "locationName":"duration" - } - }, - "documentation":"

Details about the Dedicated Host Reservation offering.

" - }, - "HostOfferingSet":{ - "type":"list", - "member":{"shape":"HostOffering"} - }, - "HostProperties":{ - "type":"structure", - "members":{ - "Sockets":{ - "shape":"Integer", - "documentation":"

The number of sockets on the Dedicated Host.

", - "locationName":"sockets" - }, - "Cores":{ - "shape":"Integer", - "documentation":"

The number of cores on the Dedicated Host.

", - "locationName":"cores" - }, - "TotalVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs on the Dedicated Host.

", - "locationName":"totalVCpus" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size that the Dedicated Host supports (for example, m3.medium).

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes properties of a Dedicated Host.

" - }, - "HostReservation":{ - "type":"structure", - "members":{ - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation that specifies the associated Dedicated Hosts.

", - "locationName":"hostReservationId" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation. This remains the same regardless of which Dedicated Hosts are associated with it.

", - "locationName":"offeringId" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the Dedicated Host Reservation. The instance family on the Dedicated Host must be the same in order for it to benefit from the reservation.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option selected for this reservation.

", - "locationName":"paymentOption" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation.

", - "locationName":"hourlyPrice" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the upfrontPrice and hourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts the reservation is associated with.

", - "locationName":"count" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The length of the reservation's term, specified in seconds. Can be 31536000 (1 year) | 94608000 (3 years).

", - "locationName":"duration" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation ends.

", - "locationName":"end" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation started.

", - "locationName":"start" - }, - "State":{ - "shape":"ReservationState", - "documentation":"

The state of the reservation.

", - "locationName":"state" - } - }, - "documentation":"

Details about the Dedicated Host Reservation and associated Dedicated Hosts.

" - }, - "HostReservationIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "HostReservationSet":{ - "type":"list", - "member":{"shape":"HostReservation"} - }, - "HostTenancy":{ - "type":"string", - "enum":[ - "dedicated", - "host" - ] - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"type" - }, - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"code" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "IdFormat":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether longer IDs (17-character IDs) are enabled for the resource.

", - "locationName":"useLongIds" - }, - "Deadline":{ - "shape":"DateTime", - "documentation":"

The date in UTC at which you are permanently switched over to using longer IDs. If a deadline is not yet available for this resource type, this field is not returned.

", - "locationName":"deadline" - } - }, - "documentation":"

Describes the ID format for a resource.

" - }, - "IdFormatList":{ - "type":"list", - "member":{ - "shape":"IdFormat", - "locationName":"item" - } - }, - "Image":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the disk.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to be used for importing the snapshot.

" - } - }, - "documentation":"

Describes the disk container object for an import image task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task.

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "documentation":"

Information about the disk containers.

", - "locationName":"DiskContainer" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing.

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.

Valid values: AWS | BYOL

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform.

Valid values: xen

" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

Valid values: Windows | Linux

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportImage.

" - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) created by the import task.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output for ImportImage.

" - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image task.

", - "locationName":"importTaskId" - }, - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

", - "locationName":"architecture" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor for the import task.

Valid values: xen

", - "locationName":"hypervisor" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

", - "locationName":"imageId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the import image task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the import image task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import image task.

", - "locationName":"status" - } - }, - "documentation":"

Describes an import image task.

" - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

The user data to make available to the instance. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information about the instance types that you can import, see Instance Types in the VM Import/Export User Guide.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "Monitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] An available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes the launch specification for VM import.

" - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

The launch specification.

", - "locationName":"launchSpecification" - }, - "DiskImages":{ - "shape":"DiskImageList", - "documentation":"

The disk image.

", - "locationName":"diskImage" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - }, - "documentation":"

Contains the parameters for ImportInstance.

" - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportInstance.

" - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "required":["Volumes"], - "members":{ - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "documentation":"

One or more volumes.

", - "locationName":"volumes" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import instance task.

" - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume", - "Status" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. For API calls, the text must be base64-encoded. For command line tools, base64 encoding is performed for you.

", - "locationName":"publicKeyMaterial" - } - }, - "documentation":"

Contains the parameters for ImportKeyPair.

" - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Contains the output of ImportKeyPair.

" - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description string for the import snapshot task.

" - }, - "DiskContainer":{ - "shape":"SnapshotDiskContainer", - "documentation":"

Information about the disk container.

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportSnapshot.

" - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Information about the import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Contains the output for ImportSnapshot.

" - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Describes an import snapshot task.

", - "locationName":"snapshotTaskDetail" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - } - }, - "documentation":"

Describes an import snapshot task.

" - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting EBS volume.

", - "locationName":"availabilityZone" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

The disk image.

", - "locationName":"image" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the volume.

", - "locationName":"description" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

The volume size.

", - "locationName":"volume" - } - }, - "documentation":"

Contains the parameters for ImportVolume.

" - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportVolume.

" - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "required":[ - "BytesConverted", - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"privateDnsName" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name assigned to the instance. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"dnsName" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance, if applicable.

", - "locationName":"productCodes" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched, if applicable.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance, if applicable.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance, if applicable.

", - "locationName":"ramdiskId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information for the instance.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address assigned to the instance, if applicable.

", - "locationName":"ipAddress" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The root device name (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot instance or a Scheduled Instance.

", - "locationName":"instanceLifecycle" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

If the request is a Spot instance request, the ID of the request.

", - "locationName":"spotInstanceRequestId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance, if applicable.

", - "locationName":"clientToken" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance, if applicable.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The user data.

", - "locationName":"userData" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The name of the root device (for example, /dev/sda1 or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for EBS I/O.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport", - "enaSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCapacity":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size supported by the Dedicated Host.

", - "locationName":"instanceType" - }, - "AvailableCapacity":{ - "shape":"Integer", - "documentation":"

The number of instances that can still be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - }, - "TotalCapacity":{ - "shape":"Integer", - "documentation":"

The total number of instances that can be launched onto the Dedicated Host.

", - "locationName":"totalCapacity" - } - }, - "documentation":"

Information about the instance type that the Dedicated Host supports.

" - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance to export.

" - }, - "InstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":[ - "spot", - "scheduled" - ] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring information.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring information of the instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface. Applies only if creating a network interface when launching an instance. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"privateIpAddress" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IP addresses to assign to the network interface. Only one private IP address can be designated as primary. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes a private IP address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is an opaque internal value and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of the instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Any scheduled events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - }, - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The event code.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - } - }, - "documentation":"

Describes a scheduled event for an instance.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - }, - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "t2.nano", - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "m4.16xlarge", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "x1.16xlarge", - "x1.32xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "g2.8xlarge", - "cg1.4xlarge", - "p2.xlarge", - "p2.8xlarge", - "p2.16xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InternetGateway":{ - "type":"structure", - "members":{ - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the Internet gateway.

", - "locationName":"internetGatewayId" - }, - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the Internet gateway.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes the attachment of a VPC to an Internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

[EC2-VPC only] When you authorize or revoke security group rules, you can use -1 to specify all.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code. A value of -1 indicates all ICMP codes for the specified ICMP type.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IP ranges.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdList", - "documentation":"

(Valid for AuthorizeSecurityGroupEgress, RevokeSecurityGroupEgress and DescribeSecurityGroups only) One or more prefix list IDs for an AWS service. In an AuthorizeSecurityGroupEgress request, this is the AWS service that you want to access through a VPC endpoint from instances associated with the security group.

", - "locationName":"prefixListIds" - } - }, - "documentation":"

Describes a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR range. You can either specify a CIDR range or a source security group, not both.

", - "locationName":"cidrIp" - } - }, - "documentation":"

Describes an IP range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "IpRanges":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "LaunchSpecsList":{ - "type":"list", - "member":{ - "shape":"SpotFleetLaunchSpecification", - "locationName":"item" - }, - "min":1 - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "max":255, - "min":5 - }, - "ModifyHostsRequest":{ - "type":"structure", - "required":[ - "HostIds", - "AutoPlacement" - ], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The host IDs of the Dedicated Hosts you want to modify.

", - "locationName":"hostId" - }, - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Specify whether to enable or disable auto-placement.

", - "locationName":"autoPlacement" - } - }, - "documentation":"

Contains the parameters for ModifyHosts.

" - }, - "ModifyHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully modified.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ModifyHosts.

" - }, - "ModifyIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicate whether the resource should use longer IDs (17-character IDs).

" - } - }, - "documentation":"

Contains the parameters of ModifyIdFormat.

" - }, - "ModifyIdentityIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds", - "PrincipalArn" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: instance | reservation | snapshot | volume

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether the resource should use longer IDs (17-character IDs)

", - "locationName":"useLongIds" - }, - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

", - "locationName":"principalArn" - } - }, - "documentation":"

Contains the parameters of ModifyIdentityIdFormat.

" - }, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This is only valid when modifying the launchPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AMI, it can't be removed. This is only valid when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This is only valid when modifying the description attribute.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A launch permission modification.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

" - } - }, - "documentation":"

Contains the parameters for ModifyImageAttribute.

" - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or instanceInitiatedShutdownBehavior attribute.

", - "locationName":"value" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. You cannot use this paramater for Spot Instances.

", - "locationName":"disableApiTermination" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the instance.

There is no way to disable enhanced networking with the Intel 82599 Virtual Function interface at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Set to true to enable enhanced networking with ENA for the instance.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Contains the parameters for ModifyInstanceAttribute.

" - }, - "ModifyInstancePlacementRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that you are modifying.

", - "locationName":"instanceId" - }, - "Tenancy":{ - "shape":"HostTenancy", - "documentation":"

The tenancy of the instance that you are modifying.

", - "locationName":"tenancy" - }, - "Affinity":{ - "shape":"Affinity", - "documentation":"

The new affinity setting for the instance.

", - "locationName":"affinity" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host that the instance will have affinity with.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ModifyInstancePlacement.

" - }, - "ModifyInstancePlacementResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyInstancePlacement.

" - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the parameters for ModifyNetworkInterfaceAttribute.

" - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - }, - "documentation":"

Contains the parameters for ModifyReservedInstances.

" - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - }, - "documentation":"

Contains the output of ModifyReservedInstances.

" - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify.

Only volume creation permissions may be modified at the customer level.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - } - }, - "documentation":"

Contains the parameters for ModifySnapshotAttribute.

" - }, - "ModifySpotFleetRequestRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The size of the fleet.

", - "locationName":"targetCapacity" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - } - }, - "documentation":"

Contains the parameters for ModifySpotFleetRequest.

" - }, - "ModifySpotFleetRequestResponse":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifySpotFleetRequest.

" - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that instances launched into the specified subnet should be assigned public IP address.

" - } - }, - "documentation":"

Contains the parameters for ModifySubnetAttribute.

" - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - } - }, - "documentation":"

Contains the parameters for ModifyVolumeAttribute.

" - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" will succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute.

" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute. You can only enable DNS hostnames if you've enabled DNS support.

" - } - }, - "documentation":"

Contains the parameters for ModifyVpcAttribute.

" - }, - "ModifyVpcEndpointRequest":{ - "type":"structure", - "required":["VpcEndpointId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ResetPolicy":{ - "shape":"Boolean", - "documentation":"

Specify true to reset the policy document to the default policy. The default policy allows access to the service.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

A policy document to attach to the endpoint. The policy must be in valid JSON format.

" - }, - "AddRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables IDs to associate with the endpoint.

", - "locationName":"AddRouteTableId" - }, - "RemoveRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs to disassociate from the endpoint.

", - "locationName":"RemoveRouteTableId" - } - }, - "documentation":"

Contains the parameters for ModifyVpcEndpoint.

" - }, - "ModifyVpcEndpointResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyVpcEndpoint.

" - }, - "ModifyVpcPeeringConnectionOptionsRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

" - }, - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the requester VPC.

" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the accepter VPC.

" - } - } - }, - "ModifyVpcPeeringConnectionOptionsResult":{ - "type":"structure", - "members":{ - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the requester VPC.

", - "locationName":"requesterPeeringConnectionOptions" - }, - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the accepter VPC.

", - "locationName":"accepterPeeringConnectionOptions" - } - } - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for MonitorInstances.

" - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of MonitorInstances.

" - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "MoveAddressToVpcRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for MoveAddressToVpc.

" - }, - "MoveAddressToVpcResult":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID for the Elastic IP address.

", - "locationName":"allocationId" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the move of the IP address.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output of MoveAddressToVpc.

" - }, - "MoveStatus":{ - "type":"string", - "enum":[ - "movingToVpc", - "restoringToClassic" - ] - }, - "MovingAddressStatus":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "MoveStatus":{ - "shape":"MoveStatus", - "documentation":"

The status of the Elastic IP address that's being moved to the EC2-VPC platform, or restored to the EC2-Classic platform.

", - "locationName":"moveStatus" - } - }, - "documentation":"

Describes the status of a moving Elastic IP address.

" - }, - "MovingAddressStatusSet":{ - "type":"list", - "member":{ - "shape":"MovingAddressStatus", - "locationName":"item" - } - }, - "NatGateway":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the NAT gateway is located.

", - "locationName":"vpcId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the NAT gateway is located.

", - "locationName":"subnetId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was created.

", - "locationName":"createTime" - }, - "DeleteTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was deleted, if applicable.

", - "locationName":"deleteTime" - }, - "NatGatewayAddresses":{ - "shape":"NatGatewayAddressList", - "documentation":"

Information about the IP addresses and network interface associated with the NAT gateway.

", - "locationName":"natGatewayAddressSet" - }, - "State":{ - "shape":"NatGatewayState", - "documentation":"

The state of the NAT gateway.

  • pending: The NAT gateway is being created and is not ready to process traffic.

  • failed: The NAT gateway could not be created. Check the failureCode and failureMessage fields for the reason.

  • available: The NAT gateway is able to process traffic. This status remains until you delete the NAT gateway, and does not indicate the health of the NAT gateway.

  • deleting: The NAT gateway is in the process of being terminated and may still be processing traffic.

  • deleted: The NAT gateway has been terminated and is no longer processing traffic.

", - "locationName":"state" - }, - "FailureCode":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error code for the failure. (InsufficientFreeAddressesInSubnet | Gateway.NotAttached | InvalidAllocationID.NotFound | Resource.AlreadyAssociated | InternalError | InvalidSubnetID.NotFound)

", - "locationName":"failureCode" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error message for the failure, that corresponds to the error code.

  • For InsufficientFreeAddressesInSubnet: \"Subnet has insufficient free addresses to create this NAT gateway\"

  • For Gateway.NotAttached: \"Network vpc-xxxxxxxx has no Internet gateway attached\"

  • For InvalidAllocationID.NotFound: \"Elastic IP address eipalloc-xxxxxxxx could not be associated with this NAT gateway\"

  • For Resource.AlreadyAssociated: \"Elastic IP address eipalloc-xxxxxxxx is already associated\"

  • For InternalError: \"Network interface eni-xxxxxxxx, created and used internally by this NAT gateway is in an invalid state. Please try again.\"

  • For InvalidSubnetID.NotFound: \"The specified subnet subnet-xxxxxxxx does not exist or could not be found.\"

", - "locationName":"failureMessage" - }, - "ProvisionedBandwidth":{ - "shape":"ProvisionedBandwidth", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionedBandwidth" - } - }, - "documentation":"

Describes a NAT gateway.

" - }, - "NatGatewayAddress":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address associated with the NAT gateway.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of the Elastic IP address that's associated with the NAT gateway.

", - "locationName":"allocationId" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIp" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface associated with the NAT gateway.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Describes the IP addresses and network interface associated with a NAT gateway.

" - }, - "NatGatewayAddressList":{ - "type":"list", - "member":{ - "shape":"NatGatewayAddress", - "locationName":"item" - } - }, - "NatGatewayList":{ - "type":"list", - "member":{ - "shape":"NatGateway", - "locationName":"item" - } - }, - "NatGatewayState":{ - "type":"string", - "enum":[ - "pending", - "failed", - "available", - "deleting", - "deleted" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP associated with the network interface.

", - "locationName":"association" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IP addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - }, - "InterfaceType":{ - "shape":"NetworkInterfaceType", - "documentation":"

The type of interface.

", - "locationName":"interfaceType" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - } - }, - "documentation":"

Describes association information for an Elastic IP address.

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address.

", - "locationName":"privateIpAddress" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IP address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address associated with the network interface.

", - "locationName":"association" - } - }, - "documentation":"

Describes the private IP address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "attaching", - "in-use", - "detaching" - ] - }, - "NetworkInterfaceType":{ - "type":"string", - "enum":[ - "interface", - "natGateway" - ] - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "OccurrenceDayRequestSet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"OccurenceDay" - } - }, - "OccurrenceDaySet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"item" - } - }, - "OfferingClassType":{ - "type":"string", - "enum":[ - "standard", - "convertible" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OperationType":{ - "type":"string", - "enum":[ - "add", - "remove" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PaymentOption":{ - "type":"string", - "enum":[ - "AllUpfront", - "PartialUpfront", - "NoUpfront" - ] - }, - "PeeringConnectionOptions":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "PeeringConnectionOptionsRequest":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

" - } - }, - "documentation":"

The VPC peering connection options.

" - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in (for cluster compute instances).

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. The host tenancy is not supported for the ImportInstance command.

", - "locationName":"tenancy" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicted host on which the instance resides. This parameter is not support for the ImportInstance command.

", - "locationName":"hostId" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for the instance on the Dedicated Host. This parameter is not supported for the ImportInstance command.

", - "locationName":"affinity" - } - }, - "documentation":"

Describes the placement for the instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":["cluster"] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PrefixList":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - }, - "PrefixListName":{ - "shape":"String", - "documentation":"

The name of the prefix.

", - "locationName":"prefixListName" - }, - "Cidrs":{ - "shape":"ValueStringList", - "documentation":"

The IP address range of the AWS service.

", - "locationName":"cidrSet" - } - }, - "documentation":"

Describes prefixes for AWS services.

" - }, - "PrefixListId":{ - "type":"structure", - "members":{ - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - } - }, - "documentation":"

The ID of the prefix.

" - }, - "PrefixListIdList":{ - "type":"list", - "member":{ - "shape":"PrefixListId", - "locationName":"item" - } - }, - "PrefixListIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "PrefixListSet":{ - "type":"list", - "member":{ - "shape":"PrefixList", - "locationName":"item" - } - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The number of reservations available for the price.

", - "locationName":"count" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrivateIpAddressConfigSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesPrivateIpAddressConfig", - "locationName":"PrivateIpAddressConfigSet" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "required":["PrivateIpAddress"], - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP addresses.

", - "locationName":"privateIpAddress" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IP address is the primary private IP address. Only one IP address can be designated as primary.

", - "locationName":"primary" - } - }, - "documentation":"

Describes a secondary private IP address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway (VGW).

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "ProvisionedBandwidth":{ - "type":"structure", - "members":{ - "Provisioned":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisioned" - }, - "Requested":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requested" - }, - "RequestTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requestTime" - }, - "ProvisionTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionTime" - }, - "Status":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"status" - } - }, - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

" - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "Purchase":{ - "type":"structure", - "members":{ - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"hostReservationId" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family on the Dedicated Host that the reservation can be associated with.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option for the reservation.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation per hour.

", - "locationName":"hourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the UpfrontPrice and HourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation's term in seconds.

", - "locationName":"duration" - } - }, - "documentation":"

Describes the result of the purchase.

" - }, - "PurchaseHostReservationRequest":{ - "type":"structure", - "required":[ - "OfferingId", - "HostIdSet" - ], - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

" - }, - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The ID/s of the Dedicated Host/s that the reservation will be associated with.

" - }, - "LimitPrice":{ - "shape":"String", - "documentation":"

The specified limit is checked against the total upfront cost of the reservation (calculated as the offering's upfront cost multiplied by the host count). If the total upfront cost is greater than the specified price limit, the request will fail. This is used to ensure that the purchase does not exceed the expected upfront cost of the purchase. At this time, the only supported currency is USD. For example, to indicate a limit price of USD 100, specify 100.00.

" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice, LimitPrice, and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - } - } - }, - "PurchaseHostReservationResult":{ - "type":"structure", - "members":{ - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

Describes the details of the purchase.

", - "locationName":"purchase" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The total amount that will be charged to your account when you purchase the reservation.

", - "locationName":"totalUpfrontPrice" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The total hourly price of the reservation calculated per hour.

", - "locationName":"totalHourlyPrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide

", - "locationName":"clientToken" - } - } - }, - "PurchaseRequest":{ - "type":"structure", - "required":[ - "PurchaseToken", - "InstanceCount" - ], - "members":{ - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

" - } - }, - "documentation":"

Describes a request to purchase Scheduled Instances.

" - }, - "PurchaseRequestSet":{ - "type":"list", - "member":{ - "shape":"PurchaseRequest", - "locationName":"PurchaseRequest" - }, - "min":1 - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesOfferingId", - "InstanceCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - }, - "documentation":"

Contains the parameters for PurchaseReservedInstancesOffering.

" - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Contains the output of PurchaseReservedInstancesOffering.

" - }, - "PurchaseScheduledInstancesRequest":{ - "type":"structure", - "required":["PurchaseRequests"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "PurchaseRequests":{ - "shape":"PurchaseRequestSet", - "documentation":"

One or more purchase requests.

", - "locationName":"PurchaseRequest" - } - }, - "documentation":"

Contains the parameters for PurchaseScheduledInstances.

" - }, - "PurchaseScheduledInstancesResult":{ - "type":"structure", - "members":{ - "ScheduledInstanceSet":{ - "shape":"PurchasedScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of PurchaseScheduledInstances.

" - }, - "PurchaseSet":{ - "type":"list", - "member":{"shape":"Purchase"} - }, - "PurchasedScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for RebootInstances.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - }, - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The name of the root device (for example, /dev/sda1, or /dev/xvda).

", - "locationName":"rootDeviceName" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization.

Default: paravirtual

", - "locationName":"virtualizationType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the AMI and any instances that you launch from the AMI.

There is no way to disable sriovNetSupport at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Set to true to enable enhanced networking with ENA for the AMI and any instances that you launch from the AMI.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"enaSupport" - } - }, - "documentation":"

Contains the parameters for RegisterImage.

" - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of RegisterImage.

" - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for RejectVpcPeeringConnection.

" - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of RejectVpcPeeringConnection.

" - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - } - }, - "documentation":"

Contains the parameters for ReleaseAddress.

" - }, - "ReleaseHostsRequest":{ - "type":"structure", - "required":["HostIds"], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts you want to release.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ReleaseHosts.

" - }, - "ReleaseHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully released.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be released, including an error message.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ReleaseHosts.

" - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "NetworkAclId", - "RuleNumber", - "Protocol", - "RuleAction", - "Egress", - "CidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code. Required if specifying 1 (ICMP) for the protocol.

", - "locationName":"Icmp" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying 6 (TCP) or 17 (UDP) for the protocol.

", - "locationName":"portRange" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclEntry.

" - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "DestinationCidrBlock" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR address block used for the destination match. The value you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an Internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the parameters for ReplaceRoute.

" - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for ReplaceRouteTableAssociation.

" - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceRouteTableAssociation.

" - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "Status", - "ReasonCodes" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describes the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems which I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - } - }, - "documentation":"

Contains the parameters for ReportInstanceStatus.

" - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestSpotFleetRequest":{ - "type":"structure", - "required":["SpotFleetRequestConfig"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration for the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "RequestSpotFleetResponse":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "required":["SpotPrice"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for any Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

Default: The request is effective indefinitely.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

Default: The request is effective indefinitely.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of bids.

When you specify an Availability Zone group in a Spot Instance request, all Spot instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to bids for Spot Instances of the same instance type. Any additional Spot instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot instance request (all instances are terminated, the bid is expired, or the bid falls below current market), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

The duration period starts as soon as your Spot instance receives its instance ID. At the end of the duration period, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates.

Note that you can't specify an Availability Zone group or a launch group if you specify a duration.

", - "locationName":"blockDurationMinutes" - }, - "LaunchSpecification":{"shape":"RequestSpotLaunchSpecification"} - }, - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "locationName":"SecurityGroup" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

", - "locationName":"blockDeviceMapping" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "locationName":"SecurityGroupId" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "Reservation":{ - "type":"structure", - "members":{ - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

[EC2-Classic only] One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservationState":{ - "type":"string", - "enum":[ - "payment-pending", - "payment-failed", - "active", - "retired" - ] - }, - "ReservationValue":{ - "type":"structure", - "members":{ - "RemainingTotalValue":{ - "shape":"String", - "documentation":"

The balance of the total value (the sum of remainingUpfrontValue + hourlyPrice * number of hours remaining).

", - "locationName":"remainingTotalValue" - }, - "RemainingUpfrontValue":{ - "shape":"String", - "documentation":"

The remaining upfront cost of the reservation.

", - "locationName":"remainingUpfrontValue" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly rate of the reservation.

", - "locationName":"hourlyPrice" - } - }, - "documentation":"

The cost associated with the Reserved Instance.

" - }, - "ReservedInstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstanceId" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceReservationValue":{ - "type":"structure", - "members":{ - "ReservedInstanceId":{ - "shape":"String", - "documentation":"

The ID of the Convertible Reserved Instance that you are exchanging.

", - "locationName":"reservedInstanceId" - }, - "ReservationValue":{ - "shape":"ReservationValue", - "documentation":"

The total value of the Convertible Reserved Instance that you are exchanging.

", - "locationName":"reservationValue" - } - }, - "documentation":"

The total value of the Convertible Reserved Instance.

" - }, - "ReservedInstanceReservationValueSet":{ - "type":"list", - "member":{ - "shape":"ReservedInstanceReservationValue", - "locationName":"item" - } - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reservations purchased.

", - "locationName":"instanceCount" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

The offering class of the Reserved Instance.

", - "locationName":"offeringClass" - }, - "Scope":{ - "shape":"scope", - "documentation":"

The scope of the Reserved Instance.

", - "locationName":"scope" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - }, - "Scope":{ - "shape":"scope", - "documentation":"

Whether the Reserved Instance is standard or convertible.

", - "locationName":"scope" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - }, - "documentation":"

Describes the modification request/s.

" - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering. This is the offering ID used in GetReservedInstancesExchangeQuote to confirm that an exchange can be made.

", - "locationName":"reservedInstancesOfferingId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

If convertible it can be exchanged for Reserved Instances of the same or higher monetary value, with different configurations. If standard, it is not possible to perform an exchange.

", - "locationName":"offeringClass" - }, - "Scope":{ - "shape":"scope", - "documentation":"

Whether the Reserved Instance is applied to instances in a region or an Availability Zone.

", - "locationName":"scope" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "ImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - } - }, - "documentation":"

Contains the parameters for ResetImageAttribute.

" - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

You can only reset the following attributes: kernel | ramdisk | sourceDestCheck. To change an instance attribute, use ModifyInstanceAttribute.

", - "locationName":"attribute" - } - }, - "documentation":"

Contains the parameters for ResetInstanceAttribute.

" - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the parameters for ResetNetworkInterfaceAttribute.

" - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "SnapshotId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.

" - } - }, - "documentation":"

Contains the parameters for ResetSnapshotAttribute.

" - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "ResponseHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ResponseHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RestoreAddressToClassicRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for RestoreAddressToClassic.

" - }, - "RestoreAddressToClassicResult":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

The move status for the IP address.

", - "locationName":"status" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the output of RestoreAddressToClassic.

" - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number for a destination security group. To revoke outbound access to a destination security group, we recommend that you use a set of IP permissions instead.

", - "locationName":"sourceSecurityGroupOwnerId" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name or number. We recommend that you specify the protocol in a set of IP permissions instead.

", - "locationName":"ipProtocol" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"fromPort" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP type number. We recommend that you specify the port range in a set of IP permissions instead.

", - "locationName":"toPort" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. We recommend that you specify the CIDR range in a set of IP permissions instead.

", - "locationName":"cidrIp" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a destination security group and a CIDR IP address range.

", - "locationName":"ipPermissions" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupEgress.

" - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a security group in a nondefault VPC.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account ID of the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

A set of IP permissions. You can't specify a source security group and a CIDR IP address range.

" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupIngress.

" - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationPrefixListId":{ - "shape":"String", - "documentation":"

The prefix of the AWS service.

", - "locationName":"destinationPrefixListId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable - The route was automatically created when the route table was created.

  • CreateRoute - The route was manually added to the route table.

  • EnableVgwRoutePropagation - The route was propagated by route propagation.

", - "locationName":"origin" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet. A subnet ID is not returned for an implicit association.

", - "locationName":"subnetId" - }, - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled for the instance.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "ImageId", - "MinCount", - "MaxCount" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 FAQ.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instance. For more information, see Running Commands on Your Linux Instance at Launch (Linux) and Adding User Data (Windows). If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

Supplying both a snapshot ID and an encryption value as arguments for block-device mapping results in an error. This is because only blank volumes can be encrypted on start, and these are not created from a snapshot. If a snapshot is the basis for the volume, it contains data by definition and its encryption status cannot be changed using this action.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. If you set this parameter to true and then later want to be able to terminate the instance, you must first change the value of the disableApiTermination attribute to false using ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IP address. You must specify a value from the IP address range of the subnet.

Only one private IP address can be designated as primary. Therefore, you can't specify this parameter if PrivateIpAddresses.n.Primary is set to true and PrivateIpAddresses.n.PrivateIpAddress is set to an IP address.

You cannot specify this option if you're launching more than one instance in the request.

Default: We select an IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - } - }, - "documentation":"

Contains the parameters for RunInstances.

" - }, - "RunScheduledInstancesRequest":{ - "type":"structure", - "required":[ - "ScheduledInstanceId", - "LaunchSpecification" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

Default: 1

" - }, - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

" - }, - "LaunchSpecification":{ - "shape":"ScheduledInstancesLaunchSpecification", - "documentation":"

The launch specification. You must match the instance type, Availability Zone, network, and platform of the schedule that you purchased.

" - } - }, - "documentation":"

Contains the parameters for RunScheduledInstances.

" - }, - "RunScheduledInstancesResult":{ - "type":"structure", - "members":{ - "InstanceIdSet":{ - "shape":"InstanceIdSet", - "documentation":"

The IDs of the newly launched instances.

", - "locationName":"instanceIdSet" - } - }, - "documentation":"

Contains the output of RunScheduledInstances.

" - }, - "S3Storage":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "ScheduledInstance":{ - "type":"structure", - "members":{ - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

", - "locationName":"scheduledInstanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "PreviousSlotEndTime":{ - "shape":"DateTime", - "documentation":"

The time that the previous schedule ended or will end.

", - "locationName":"previousSlotEndTime" - }, - "NextSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time for the next schedule to start.

", - "locationName":"nextSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

", - "locationName":"instanceCount" - }, - "TermStartDate":{ - "shape":"DateTime", - "documentation":"

The start date for the Scheduled Instance.

", - "locationName":"termStartDate" - }, - "TermEndDate":{ - "shape":"DateTime", - "documentation":"

The end date for the Scheduled Instance.

", - "locationName":"termEndDate" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The date when the Scheduled Instance was purchased.

", - "locationName":"createDate" - } - }, - "documentation":"

Describes a Scheduled Instance.

" - }, - "ScheduledInstanceAvailability":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type. You can specify one of the C3, C4, M4, or R3 instance types.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token. This token expires in two hours.

", - "locationName":"purchaseToken" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "FirstSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time period for the first schedule to start.

", - "locationName":"firstSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - }, - "AvailableInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of available instances.

", - "locationName":"availableInstanceCount" - }, - "MinTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The minimum term. The only possible value is 365 days.

", - "locationName":"minTermDurationInDays" - }, - "MaxTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The maximum term. The only possible value is 365 days.

", - "locationName":"maxTermDurationInDays" - } - }, - "documentation":"

Describes a schedule that is available for your Scheduled Instances.

" - }, - "ScheduledInstanceAvailabilitySet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstanceAvailability", - "locationName":"item" - } - }, - "ScheduledInstanceIdRequestSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ScheduledInstanceId" - } - }, - "ScheduledInstanceRecurrence":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

", - "locationName":"frequency" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of frequency. For example, every 2 weeks or every 2 months.

", - "locationName":"interval" - }, - "OccurrenceDaySet":{ - "shape":"OccurrenceDaySet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday).

", - "locationName":"occurrenceDaySet" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month.

", - "locationName":"occurrenceRelativeToEnd" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for occurrenceDaySet (DayOfWeek or DayOfMonth).

", - "locationName":"occurrenceUnit" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceRecurrenceRequest":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of Frequency. For example, every 2 weeks or every 2 months.

" - }, - "OccurrenceDays":{ - "shape":"OccurrenceDayRequestSet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday). You can't specify this value with a daily schedule. If the occurrence is relative to the end of the month, you can specify only a single day.

", - "locationName":"OccurrenceDay" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month. You can't specify this value with a daily schedule.

" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for OccurrenceDays (DayOfWeek or DayOfMonth). This value is required for a monthly schedule. You can't specify DayOfWeek with a weekly schedule. You can't specify this value with a daily schedule.

" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "ScheduledInstancesBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name exposed to the instance (for example, /dev/sdh or xvdh).

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with two available instance store volumes can specify mappings for ephemeral0 and ephemeral1.The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

" - }, - "Ebs":{ - "shape":"ScheduledInstancesEbs", - "documentation":"

Parameters used to set up EBS volumes automatically when the instance is launched.

" - } - }, - "documentation":"

Describes a block device mapping for a Scheduled Instance.

" - }, - "ScheduledInstancesBlockDeviceMappingSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesBlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "ScheduledInstancesEbs":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, Throughput Optimized HDD for st1, Cold HDD for sc1, or standard for Magnetic.

Default: standard

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about gp2 baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is encrypted. You can attached encrypted volumes only to instances that support them.

" - } - }, - "documentation":"

Describes an EBS volume for a Scheduled Instance.

" - }, - "ScheduledInstancesIamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN).

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name.

" - } - }, - "documentation":"

Describes an IAM instance profile for a Scheduled Instance.

" - }, - "ScheduledInstancesLaunchSpecification":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI).

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - }, - "SecurityGroupIds":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The base64-encoded MIME user data.

" - }, - "Placement":{ - "shape":"ScheduledInstancesPlacement", - "documentation":"

The placement information.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

" - }, - "BlockDeviceMappings":{ - "shape":"ScheduledInstancesBlockDeviceMappingSet", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "Monitoring":{ - "shape":"ScheduledInstancesMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

" - }, - "NetworkInterfaces":{ - "shape":"ScheduledInstancesNetworkInterfaceSet", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "IamInstanceProfile":{ - "shape":"ScheduledInstancesIamInstanceProfile", - "documentation":"

The IAM instance profile.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

" - } - }, - "documentation":"

Describes the launch specification for a Scheduled Instance.

If you are launching the Scheduled Instance in EC2-VPC, you must specify the ID of the subnet. You can specify the subnet using either SubnetId or NetworkInterface.

" - }, - "ScheduledInstancesMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

" - } - }, - "documentation":"

Describes whether monitoring is enabled for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterface":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address of the network interface within the subnet.

" - }, - "PrivateIpAddressConfigs":{ - "shape":"PrivateIpAddressConfigSet", - "documentation":"

The private IP addresses.

", - "locationName":"PrivateIpAddressConfig" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IP addresses.

" - }, - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IP address to instances launched in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

" - }, - "Groups":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"Group" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether to delete the interface when the instance is terminated.

" - } - }, - "documentation":"

Describes a network interface for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterfaceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesNetworkInterface", - "locationName":"NetworkInterface" - } - }, - "ScheduledInstancesPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

" - } - }, - "documentation":"

Describes the placement for a Scheduled Instance.

" - }, - "ScheduledInstancesPrivateIpAddressConfig":{ - "type":"structure", - "members":{ - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IP address.

" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is a primary IP address. Otherwise, this is a secondary IP address.

" - } - }, - "documentation":"

Describes a private IP address for a Scheduled Instance.

" - }, - "ScheduledInstancesSecurityGroupIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupReference":{ - "type":"structure", - "required":[ - "GroupId", - "ReferencingVpcId" - ], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of your security group.

", - "locationName":"groupId" - }, - "ReferencingVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with the referencing security group.

", - "locationName":"referencingVpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC with a security group that references your security group.

" - }, - "SecurityGroupReferences":{ - "type":"list", - "member":{ - "shape":"SecurityGroupReference", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "SlotDateTimeRangeRequest":{ - "type":"structure", - "required":[ - "EarliestTime", - "LatestTime" - ], - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start. This value must be later than or equal to the earliest date and at most three months in the future.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule. The time period must span less than one day.

" - }, - "SlotStartTimeRangeRequest":{ - "type":"structure", - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule.

" - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

", - "locationName":"snapshotId" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume that was used to create the snapshot. Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.

", - "locationName":"volumeId" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"statusMessage" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - }, - "DataEncryptionKeyId":{ - "shape":"String", - "documentation":"

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"dataEncryptionKeyId" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - } - }, - "documentation":"

Describes the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: RAW | VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - } - }, - "documentation":"

The disk container object for the import snapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the import snapshot task.

", - "locationName":"progress" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the import snapshot task.

", - "locationName":"statusMessage" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import snapshot task.

", - "locationName":"status" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot instance data feed is located.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot instance data feed subscription.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - } - }, - "documentation":"

Describes the data feed for a Spot instance.

" - }, - "SpotFleetLaunchSpecification":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"userData" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information.

", - "locationName":"placement" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "Monitoring":{ - "shape":"SpotFleetMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

", - "locationName":"monitoring" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances. To specify multiple subnets, separate them using commas; for example, \"subnet-a61dafcf, subnet-65ea5f08\".

", - "locationName":"subnetId" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

", - "locationName":"weightedCapacity" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour for the specified instance type. If this value is not specified, the default is the Spot bid price specified for the fleet. To determine the bid price per unit hour, divide the Spot bid price by the value of WeightedCapacity.

", - "locationName":"spotPrice" - } - }, - "documentation":"

Describes the launch specification for one or more Spot instances.

" - }, - "SpotFleetMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Enables monitoring for the instance.

Default: false

", - "locationName":"enabled" - } - }, - "documentation":"

Describes whether monitoring is enabled.

" - }, - "SpotFleetRequestConfig":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "SpotFleetRequestState", - "SpotFleetRequestConfig", - "CreateTime" - ], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot fleet request.

", - "locationName":"spotFleetRequestId" - }, - "SpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The state of the Spot fleet request.

", - "locationName":"spotFleetRequestState" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

Information about the configuration of the Spot fleet request.

", - "locationName":"spotFleetRequestConfig" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The creation date and time of the request.

", - "locationName":"createTime" - }, - "ActivityStatus":{ - "shape":"ActivityStatus", - "documentation":"

The progress of the Spot fleet request. If there is an error, the status is error. After all bids are placed, the status is pending_fulfillment. If the size of the fleet is equal to or greater than its target capacity, the status is fulfilled. If the size of the fleet is decreased, the status is pending_termination while Spot instances are terminating.

", - "locationName":"activityStatus" - } - }, - "documentation":"

Describes a Spot fleet request.

" - }, - "SpotFleetRequestConfigData":{ - "type":"structure", - "required":[ - "SpotPrice", - "TargetCapacity", - "IamFleetRole", - "LaunchSpecifications" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The bid price per unit hour.

", - "locationName":"spotPrice" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O.

", - "locationName":"targetCapacity" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot instance requests are placed or enabled to fulfill the request.

", - "locationName":"validUntil" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running Spot instances should be terminated when the Spot fleet request expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "IamFleetRole":{ - "shape":"String", - "documentation":"

Grants the Spot fleet permission to terminate Spot instances on your behalf when you cancel its Spot fleet request using CancelSpotFleetRequests or when the Spot fleet request expires, if you set terminateInstancesWithExpiration.

", - "locationName":"iamFleetRole" - }, - "LaunchSpecifications":{ - "shape":"LaunchSpecsList", - "documentation":"

Information about the launch specifications for the Spot fleet request.

", - "locationName":"launchSpecifications" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "AllocationStrategy":{ - "shape":"AllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot fleet request. The default is lowestPrice.

", - "locationName":"allocationStrategy" - }, - "FulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target capacity.

", - "locationName":"fulfilledCapacity" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the fleet will only request the target capacity or also attempt to maintain it. When you request a certain target capacity, the fleet will only place the required bids. It will not attempt to replenish Spot instances if capacity is diminished, nor will it submit bids in alternative Spot pools if capacity is not available. When you want to maintain a certain target capacity, fleet will place the required bids to meet this target capacity. It will also automatically replenish any interrupted instances. Default: maintain.

", - "locationName":"type" - } - }, - "documentation":"

Describes the configuration of a Spot fleet request.

" - }, - "SpotFleetRequestConfigSet":{ - "type":"list", - "member":{ - "shape":"SpotFleetRequestConfig", - "locationName":"item" - } - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price (bid) for the Spot instance launched to fulfill the request.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot instance request type.

", - "locationName":"type" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot instance request. Spot bid status information can help you track your Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"state" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot instance request, if any.

", - "locationName":"fault" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot instance request.

", - "locationName":"status" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, it remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached.

", - "locationName":"validUntil" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot instance requests, all Spot instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot instance request.

", - "locationName":"instanceId" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when the Spot instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"createTime" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot instance.

", - "locationName":"productDescription" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The duration for the Spot instance, in minutes.

", - "locationName":"blockDurationMinutes" - }, - "ActualBlockHourlyPrice":{ - "shape":"String", - "documentation":"

If you specified a duration and your Spot instance request was fulfilled, this is the fixed hourly price in effect for the Spot instance while it runs.

", - "locationName":"actualBlockHourlyPrice" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the bid is launched.

", - "locationName":"launchedAvailabilityZone" - } - }, - "documentation":"

Describes a Spot instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code. For a list of status codes, see Spot Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"code" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The date and time of the most recent status update, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"updateTime" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a Spot instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

[Spot fleet only] To specify multiple Availability Zones, separate them using commas; for example, \"us-west-2a, us-west-2b\".

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group (for cluster instances).

", - "locationName":"groupName" - } - }, - "documentation":"

Describes Spot instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price (bid) that you are willing to pay for a Spot instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - } - }, - "documentation":"

Describes the maximum hourly price (bid) for any Spot instance launched to fulfill the request.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StaleIpPermission":{ - "type":"structure", - "members":{ - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

", - "locationName":"ipProtocol" - }, - "IpRanges":{ - "shape":"IpRanges", - "documentation":"

One or more IP ranges. Not applicable for stale security group rules.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdSet", - "documentation":"

One or more prefix list IDs for an AWS service. Not applicable for stale security group rules.

", - "locationName":"prefixListIds" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairSet", - "documentation":"

One or more security group pairs. Returns the ID of the referenced security group and VPC, and the ID and status of the VPC peering connection.

", - "locationName":"groups" - } - }, - "documentation":"

Describes a stale rule in a security group.

" - }, - "StaleIpPermissionSet":{ - "type":"list", - "member":{ - "shape":"StaleIpPermission", - "locationName":"item" - } - }, - "StaleSecurityGroup":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the security group.

", - "locationName":"description" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the security group.

", - "locationName":"vpcId" - }, - "StaleIpPermissions":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale inbound rules in the security group.

", - "locationName":"staleIpPermissions" - }, - "StaleIpPermissionsEgress":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale outbound rules in the security group.

", - "locationName":"staleIpPermissionsEgress" - } - }, - "documentation":"

Describes a stale security group (a security group that contains stale rules).

" - }, - "StaleSecurityGroupSet":{ - "type":"list", - "member":{ - "shape":"StaleSecurityGroup", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for StartInstances.

" - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StartInstances.

" - }, - "State":{ - "type":"string", - "enum":[ - "Pending", - "Available", - "Deleting", - "Deleted" - ] - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.SpotInstanceTermination: A Spot instance was terminated due to an increase in the market price.

  • Server.InternalError: An internal error occurred during instance launch, resulting in termination.

  • Server.InsufficientInstanceCapacity: There was insufficient instance capacity to satisfy the launch request.

  • Client.InternalError: A client error caused the instance to terminate on launch.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your limits.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "Status":{ - "type":"string", - "enum":[ - "MoveInProgress", - "InVpc", - "InClassic" - ] - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data", - "initializing" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for StopInstances.

" - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StopInstances.

" - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused IP addresses in the subnet. Note that the IP addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IP address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable", - "initializing" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TargetConfiguration":{ - "type":"structure", - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the Convertible Reserved Instance offering.

", - "locationName":"offeringId" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances the Convertible Reserved Instance offering can be applied to. This parameter is reserved and cannot be specified in a request

", - "locationName":"instanceCount" - } - }, - "documentation":"

Information about the Convertible Reserved Instance offering.

" - }, - "TargetConfigurationRequest":{ - "type":"structure", - "required":["OfferingId"], - "members":{ - "OfferingId":{ - "shape":"String", - "documentation":"

The Convertible Reserved Instance offering ID. If this isn't included in the request, the response lists your current Convertible Reserved Instance/s and their value/s.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances the Covertible Reserved Instance offering can be applied to. This parameter is reserved and cannot be specified in a request

" - } - }, - "documentation":"

Details about the target configuration.

" - }, - "TargetConfigurationRequestSet":{ - "type":"list", - "member":{ - "shape":"TargetConfigurationRequest", - "locationName":"TargetConfigurationRequest" - } - }, - "TargetReservationValue":{ - "type":"structure", - "members":{ - "TargetConfiguration":{ - "shape":"TargetConfiguration", - "documentation":"

The configuration of the Convertible Reserved Instances that make up the exchange.

", - "locationName":"targetConfiguration" - }, - "ReservationValue":{ - "shape":"ReservationValue", - "documentation":"

The total value of the Convertible Reserved Instances that make up the exchange. This is the sum of the list value, remaining upfront price, and additional upfront cost of the exchange.

", - "locationName":"reservationValue" - } - }, - "documentation":"

The total value of the new Convertible Reserved Instances.

" - }, - "TargetReservationValueSet":{ - "type":"list", - "member":{ - "shape":"TargetReservationValue", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated", - "host" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Constraints: Up to 1000 instance IDs. We recommend breaking up this request into smaller batches.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for TerminateInstances.

" - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of TerminateInstances.

" - }, - "TrafficType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT", - "ALL" - ] - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Contains the parameters for UnassignPrivateIpAddresses.

" - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - } - }, - "documentation":"

Contains the parameters for UnmonitorInstances.

" - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

Monitoring information for one or more instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of UnmonitorInstances.

" - }, - "UnsuccessfulItem":{ - "type":"structure", - "required":["Error"], - "members":{ - "Error":{ - "shape":"UnsuccessfulItemError", - "documentation":"

Information about the error.

", - "locationName":"error" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource.

", - "locationName":"resourceId" - } - }, - "documentation":"

Information about items that were not successfully processed in a batch call.

" - }, - "UnsuccessfulItemError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message accompanying the error code.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error that occurred. For more information about errors, see Error Codes.

" - }, - "UnsuccessfulItemList":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UnsuccessfulItemSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "documentation":"

The user data. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"data" - } - }, - "documentation":"

Describes the user data for an instance.

" - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account. For a referenced security group in another VPC, the account ID of the referenced security group is returned.

[EC2-Classic] Required when adding or removing rules that reference a security group in another AWS account.

", - "locationName":"userId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use the security group ID.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the referenced security group, if applicable.

", - "locationName":"vpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection, if applicable.

", - "locationName":"vpcPeeringConnectionId" - }, - "PeeringStatus":{ - "shape":"String", - "documentation":"

The status of a VPC peering connection, if applicable.

", - "locationName":"peeringStatus" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdGroupPairSet":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - }, - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Attachments":{ - "shape":"VolumeAttachmentList", - "documentation":"

Information about the volume attachments.

", - "locationName":"attachmentSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"volumeType" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS SSD volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose SSD volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - }, - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2", - "sc1", - "st1" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcEndpoint":{ - "type":"structure", - "members":{ - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the endpoint is associated.

", - "locationName":"vpcId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the AWS service to which the endpoint is associated.

", - "locationName":"serviceName" - }, - "State":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"state" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

The policy document associated with the endpoint.

", - "locationName":"policyDocument" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route tables associated with the endpoint.

", - "locationName":"routeTableIdSet" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint.

" - }, - "VpcEndpointSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpoint", - "locationName":"item" - } - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the accepter VPC. CIDR block information is not returned when creating a VPC peering connection, or when describing a VPC peering connection that's in the initiating-request or pending-acceptance state.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the requester VPC.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionOptionsDescription":{ - "type":"structure", - "members":{ - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local ClassicLink connection can communicate with the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can communicate with a ClassicLink connection in the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - }, - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can resolve public DNS hostnames to private IP addresses when queried from instances in a peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"VpcPeeringConnectionStateReasonCode", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionStateReasonCode":{ - "type":"string", - "enum":[ - "initiating-request", - "pending-acceptance", - "active", - "deleted", - "rejected", - "failed", - "expired", - "provisioning", - "deleting" - ] - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "PeeringOptions":{ - "shape":"VpcPeeringConnectionOptionsDescription", - "documentation":"

Information about the VPC peering connection options for the accepter or requester VPC.

", - "locationName":"peeringOptions" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created, if applicable. This field may be empty or not returned.

", - "locationName":"availabilityZone" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "scope":{ - "type":"string", - "enum":[ - "Availability Zone", - "Region" - ] - } - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your need to invest in hardware up front, so you can develop and deploy applications faster.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/waiters-2.json deleted file mode 100644 index 71051948..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-09-15/waiters-2.json +++ /dev/null @@ -1,593 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeInstances", - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Reservations[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageExists": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Images[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidAMIID.NotFound", - "state": "retry" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "KeyPairExists": { - "operation": "DescribeKeyPairs", - "delay": 5, - "maxAttempts": 6, - "acceptors": [ - { - "expected": true, - "matcher": "path", - "state": "success", - "argument": "length(KeyPairs[].KeyName) > `0`" - }, - { - "expected": "InvalidKeyPair.NotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "NatGatewayAvailable": { - "operation": "DescribeNatGateways", - "delay": 15, - "maxAttempts": 40, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "NatGateways[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "failed" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleting" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleted" - }, - { - "state": "retry", - "matcher": "error", - "expected": "NatGatewayNotFound" - } - ] - }, - "NetworkInterfaceAvailable": { - "operation": "DescribeNetworkInterfaces", - "delay": 20, - "maxAttempts": 10, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "NetworkInterfaces[].Status" - }, - { - "expected": "InvalidNetworkInterfaceID.NotFound", - "matcher": "error", - "state": "failure" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "matcher": "error", - "expected": "InvalidVolume.NotFound", - "state": "success" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpcExists": { - "operation": "DescribeVpcs", - "delay": 1, - "maxAttempts": 5, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcID.NotFound", - "state": "retry" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpcPeeringConnectionExists": { - "delay": 15, - "operation": "DescribeVpcPeeringConnections", - "maxAttempts": 40, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcPeeringConnectionID.NotFound", - "state": "retry" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/examples-1.json deleted file mode 100644 index f6a8719f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/examples-1.json +++ /dev/null @@ -1,3740 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AllocateAddress": [ - { - "input": { - "Domain": "vpc" - }, - "output": { - "AllocationId": "eipalloc-64d5890a", - "Domain": "vpc", - "PublicIp": "203.0.113.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example allocates an Elastic IP address to use with an instance in a VPC.", - "id": "ec2-allocate-address-1", - "title": "To allocate an Elastic IP address for EC2-VPC" - }, - { - "output": { - "Domain": "standard", - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example allocates an Elastic IP address to use with an instance in EC2-Classic.", - "id": "ec2-allocate-address-2", - "title": "To allocate an Elastic IP address for EC2-Classic" - } - ], - "AssignPrivateIpAddresses": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "PrivateIpAddresses": [ - "10.0.0.82" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns the specified secondary private IP address to the specified network interface.", - "id": "ec2-assign-private-ip-addresses-1", - "title": "To assign a specific secondary private IP address to an interface" - }, - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "SecondaryPrivateIpAddressCount": 2 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns two secondary private IP addresses to the specified network interface. Amazon EC2 automatically assigns these IP addresses from the available IP addresses in the CIDR block range of the subnet the network interface is associated with.", - "id": "ec2-assign-private-ip-addresses-2", - "title": "To assign secondary private IP addresses that Amazon EC2 selects to an interface" - } - ], - "AssociateAddress": [ - { - "input": { - "AllocationId": "eipalloc-64d5890a", - "InstanceId": "i-0b263919b6498b123" - }, - "output": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified Elastic IP address with the specified instance in a VPC.", - "id": "ec2-associate-address-1", - "title": "To associate an Elastic IP address in EC2-VPC" - }, - { - "input": { - "AllocationId": "eipalloc-64d5890a", - "NetworkInterfaceId": "eni-1a2b3c4d" - }, - "output": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified Elastic IP address with the specified network interface.", - "id": "ec2-associate-address-2", - "title": "To associate an Elastic IP address with a network interface" - }, - { - "input": { - "InstanceId": "i-07ffe74c7330ebf53", - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates an Elastic IP address with an instance in EC2-Classic.", - "id": "ec2-associate-address-3", - "title": "To associate an Elastic IP address in EC2-Classic" - } - ], - "AssociateDhcpOptions": [ - { - "input": { - "DhcpOptionsId": "dopt-d9070ebb", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified DHCP options set with the specified VPC.", - "id": "ec2-associate-dhcp-options-1", - "title": "To associate a DHCP options set with a VPC" - }, - { - "input": { - "DhcpOptionsId": "default", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the default DHCP options set with the specified VPC.", - "id": "ec2-associate-dhcp-options-2", - "title": "To associate the default DHCP options set with a VPC" - } - ], - "AssociateRouteTable": [ - { - "input": { - "RouteTableId": "rtb-22574640", - "SubnetId": "subnet-9d4a7b6" - }, - "output": { - "AssociationId": "rtbassoc-781d0d1a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified route table with the specified subnet.", - "id": "ec2-associate-route-table-1", - "title": "To associate a route table with a subnet" - } - ], - "AttachInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified Internet gateway to the specified VPC.", - "id": "ec2-attach-internet-gateway-1", - "title": "To attach an Internet gateway to a VPC" - } - ], - "AttachNetworkInterface": [ - { - "input": { - "DeviceIndex": 1, - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-e5aa89a3" - }, - "output": { - "AttachmentId": "eni-attach-66c4350a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches the specified network interface to the specified instance.", - "id": "ec2-attach-network-interface-1", - "title": "To attach a network interface to an instance" - } - ], - "AttachVolume": [ - { - "input": { - "Device": "/dev/sdf", - "InstanceId": "i-01474ef662b89480", - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "AttachTime": "2016-08-29T18:52:32.724Z", - "Device": "/dev/sdf", - "InstanceId": "i-01474ef662b89480", - "State": "attaching", - "VolumeId": "vol-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example attaches a volume (``vol-1234567890abcdef0``) to an instance (``i-01474ef662b89480``) as ``/dev/sdf``.", - "id": "to-attach-a-volume-to-an-instance-1472499213109", - "title": "To attach a volume to an instance" - } - ], - "CancelSpotFleetRequests": [ - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ], - "TerminateInstances": true - }, - "output": { - "SuccessfulFleetRequests": [ - { - "CurrentSpotFleetRequestState": "cancelled_running", - "PreviousSpotFleetRequestState": "active", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels the specified Spot fleet request and terminates its associated Spot Instances.", - "id": "ec2-cancel-spot-fleet-requests-1", - "title": "To cancel a Spot fleet request" - }, - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ], - "TerminateInstances": false - }, - "output": { - "SuccessfulFleetRequests": [ - { - "CurrentSpotFleetRequestState": "cancelled_terminating", - "PreviousSpotFleetRequestState": "active", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels the specified Spot fleet request without terminating its associated Spot Instances.", - "id": "ec2-cancel-spot-fleet-requests-2", - "title": "To cancel a Spot fleet request without terminating its Spot Instances" - } - ], - "CancelSpotInstanceRequests": [ - { - "input": { - "SpotInstanceRequestIds": [ - "sir-08b93456" - ] - }, - "output": { - "CancelledSpotInstanceRequests": [ - { - "SpotInstanceRequestId": "sir-08b93456", - "State": "cancelled" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels a Spot Instance request.", - "id": "ec2-cancel-spot-instance-requests-1", - "title": "To cancel Spot Instance requests" - } - ], - "ConfirmProductInstance": [ - { - "input": { - "InstanceId": "i-1234567890abcdef0", - "ProductCode": "774F4FF8" - }, - "output": { - "OwnerId": "123456789012" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example determines whether the specified product code is associated with the specified instance.", - "id": "to-confirm-the-product-instance-1472712108494", - "title": "To confirm the product instance" - } - ], - "CopySnapshot": [ - { - "input": { - "Description": "This is my copied snapshot.", - "DestinationRegion": "us-east-1", - "SourceRegion": "us-west-2", - "SourceSnapshotId": "snap-066877671789bd71b" - }, - "output": { - "SnapshotId": "snap-066877671789bd71b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies a snapshot with the snapshot ID of ``snap-066877671789bd71b`` from the ``us-west-2`` region to the ``us-east-1`` region and adds a short description to identify the snapshot.", - "id": "to-copy-a-snapshot-1472502259774", - "title": "To copy a snapshot" - } - ], - "CreateCustomerGateway": [ - { - "input": { - "BgpAsn": 65534, - "PublicIp": "12.1.2.3", - "Type": "ipsec.1" - }, - "output": { - "CustomerGateway": { - "BgpAsn": "65534", - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a customer gateway with the specified IP address for its outside interface.", - "id": "ec2-create-customer-gateway-1", - "title": "To create a customer gateway" - } - ], - "CreateDhcpOptions": [ - { - "input": { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - "10.2.5.1", - "10.2.5.2" - ] - } - ] - }, - "output": { - "DhcpOptions": { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ] - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DHCP options set.", - "id": "ec2-create-dhcp-options-1", - "title": "To create a DHCP options set" - } - ], - "CreateInternetGateway": [ - { - "output": { - "InternetGateway": { - "Attachments": [ - - ], - "InternetGatewayId": "igw-c0a643a9", - "Tags": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Internet gateway.", - "id": "ec2-create-internet-gateway-1", - "title": "To create an Internet gateway" - } - ], - "CreateKeyPair": [ - { - "input": { - "KeyName": "my-key-pair" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a key pair named my-key-pair.", - "id": "ec2-create-key-pair-1", - "title": "To create a key pair" - } - ], - "CreateNatGateway": [ - { - "input": { - "AllocationId": "eipalloc-37fc1a52", - "SubnetId": "subnet-1a2b3c4d" - }, - "output": { - "NatGateway": { - "CreateTime": "2015-12-17T12:45:26.732Z", - "NatGatewayAddresses": [ - { - "AllocationId": "eipalloc-37fc1a52" - } - ], - "NatGatewayId": "nat-08d48af2a8e83edfd", - "State": "pending", - "SubnetId": "subnet-1a2b3c4d", - "VpcId": "vpc-1122aabb" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a NAT gateway in subnet subnet-1a2b3c4d and associates an Elastic IP address with the allocation ID eipalloc-37fc1a52 with the NAT gateway.", - "id": "ec2-create-nat-gateway-1", - "title": "To create a NAT gateway" - } - ], - "CreateNetworkAcl": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "output": { - "NetworkAcl": { - "Associations": [ - - ], - "Entries": [ - { - "CidrBlock": "0.0.0.0/0", - "Egress": true, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - }, - { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - } - ], - "IsDefault": false, - "NetworkAclId": "acl-5fb85d36", - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a network ACL for the specified VPC.", - "id": "ec2-create-network-acl-1", - "title": "To create a network ACL" - } - ], - "CreateNetworkAclEntry": [ - { - "input": { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "NetworkAclId": "acl-5fb85d36", - "PortRange": { - "From": 53, - "To": 53 - }, - "Protocol": "udp", - "RuleAction": "allow", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an entry for the specified network ACL. The rule allows ingress traffic from anywhere (0.0.0.0/0) on UDP port 53 (DNS) into any associated subnet.", - "id": "ec2-create-network-acl-entry-1", - "title": "To create a network ACL entry" - } - ], - "CreateNetworkInterface": [ - { - "input": { - "Description": "my network interface", - "Groups": [ - "sg-903004f8" - ], - "PrivateIpAddress": "10.0.2.17", - "SubnetId": "subnet-9d4a7b6c" - }, - "output": { - "NetworkInterface": { - "AvailabilityZone": "us-east-1d", - "Description": "my network interface", - "Groups": [ - { - "GroupId": "sg-903004f8", - "GroupName": "default" - } - ], - "MacAddress": "02:1a:80:41:52:9c", - "NetworkInterfaceId": "eni-e5aa89a3", - "OwnerId": "123456789012", - "PrivateIpAddress": "10.0.2.17", - "PrivateIpAddresses": [ - { - "Primary": true, - "PrivateIpAddress": "10.0.2.17" - } - ], - "RequesterManaged": false, - "SourceDestCheck": true, - "Status": "pending", - "SubnetId": "subnet-9d4a7b6c", - "TagSet": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a network interface for the specified subnet.", - "id": "ec2-create-network-interface-1", - "title": "To create a network interface" - } - ], - "CreatePlacementGroup": [ - { - "input": { - "GroupName": "my-cluster", - "Strategy": "cluster" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a placement group with the specified name.", - "id": "to-create-a-placement-group-1472712245768", - "title": "To create a placement group" - } - ], - "CreateRoute": [ - { - "input": { - "DestinationCidrBlock": "0.0.0.0/0", - "GatewayId": "igw-c0a643a9", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a route for the specified route table. The route matches all traffic (0.0.0.0/0) and routes it to the specified Internet gateway.", - "id": "ec2-create-route-1", - "title": "To create a route" - } - ], - "CreateRouteTable": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "output": { - "RouteTable": { - "Associations": [ - - ], - "PropagatingVgws": [ - - ], - "RouteTableId": "rtb-22574640", - "Routes": [ - { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "local", - "State": "active" - } - ], - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a route table for the specified VPC.", - "id": "ec2-create-route-table-1", - "title": "To create a route table" - } - ], - "CreateSnapshot": [ - { - "input": { - "Description": "This is my root volume snapshot.", - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "Description": "This is my root volume snapshot.", - "OwnerId": "012345678910", - "SnapshotId": "snap-066877671789bd71b", - "StartTime": "2014-02-28T21:06:01.000Z", - "State": "pending", - "Tags": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeSize": 8 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a snapshot of the volume with a volume ID of ``vol-1234567890abcdef0`` and a short description to identify the snapshot.", - "id": "to-create-a-snapshot-1472502529790", - "title": "To create a snapshot" - } - ], - "CreateSpotDatafeedSubscription": [ - { - "input": { - "Bucket": "my-s3-bucket", - "Prefix": "spotdata" - }, - "output": { - "SpotDatafeedSubscription": { - "Bucket": "my-s3-bucket", - "OwnerId": "123456789012", - "Prefix": "spotdata", - "State": "Active" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot Instance data feed for your AWS account.", - "id": "ec2-create-spot-datafeed-subscription-1", - "title": "To create a Spot Instance datafeed" - } - ], - "CreateSubnet": [ - { - "input": { - "CidrBlock": "10.0.1.0/24", - "VpcId": "vpc-a01106c2" - }, - "output": { - "Subnet": { - "AvailabilityZone": "us-west-2c", - "AvailableIpAddressCount": 251, - "CidrBlock": "10.0.1.0/24", - "State": "pending", - "SubnetId": "subnet-9d4a7b6c", - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a subnet in the specified VPC with the specified CIDR block. We recommend that you let us select an Availability Zone for you.", - "id": "ec2-create-subnet-1", - "title": "To create a subnet" - } - ], - "CreateTags": [ - { - "input": { - "Resources": [ - "ami-78a54011" - ], - "Tags": [ - { - "Key": "Stack", - "Value": "production" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the tag Stack=production to the specified image, or overwrites an existing tag for the AMI where the tag key is Stack.", - "id": "ec2-create-tags-1", - "title": "To add a tag to a resource" - } - ], - "CreateVolume": [ - { - "input": { - "AvailabilityZone": "us-east-1a", - "Size": 80, - "VolumeType": "gp2" - }, - "output": { - "AvailabilityZone": "us-east-1a", - "CreateTime": "2016-08-29T18:52:32.724Z", - "Encrypted": false, - "Iops": 240, - "Size": 80, - "SnapshotId": "", - "State": "creating", - "VolumeId": "vol-6b60b7c7", - "VolumeType": "gp2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an 80 GiB General Purpose (SSD) volume in the Availability Zone ``us-east-1a``.", - "id": "to-create-a-new-volume-1472496724296", - "title": "To create a new volume" - }, - { - "input": { - "AvailabilityZone": "us-east-1a", - "Iops": 1000, - "SnapshotId": "snap-066877671789bd71b", - "VolumeType": "io1" - }, - "output": { - "Attachments": [ - - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2016-08-29T18:52:32.724Z", - "Iops": 1000, - "Size": 500, - "SnapshotId": "snap-066877671789bd71b", - "State": "creating", - "Tags": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeType": "io1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a new Provisioned IOPS (SSD) volume with 1000 provisioned IOPS from a snapshot in the Availability Zone ``us-east-1a``.", - "id": "to-create-a-new-provisioned-iops-ssd-volume-from-a-snapshot-1472498975176", - "title": "To create a new Provisioned IOPS (SSD) volume from a snapshot" - } - ], - "CreateVpc": [ - { - "input": { - "CidrBlock": "10.0.0.0/16" - }, - "output": { - "Vpc": { - "CidrBlock": "10.0.0.0/16", - "DhcpOptionsId": "dopt-7a8b9c2d", - "InstanceTenancy": "default", - "State": "pending", - "VpcId": "vpc-a01106c2" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a VPC with the specified CIDR block.", - "id": "ec2-create-vpc-1", - "title": "To create a VPC" - } - ], - "DeleteCustomerGateway": [ - { - "input": { - "CustomerGatewayId": "cgw-0e11f167" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified customer gateway.", - "id": "ec2-delete-customer-gateway-1", - "title": "To delete a customer gateway" - } - ], - "DeleteDhcpOptions": [ - { - "input": { - "DhcpOptionsId": "dopt-d9070ebb" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DHCP options set.", - "id": "ec2-delete-dhcp-options-1", - "title": "To delete a DHCP options set" - } - ], - "DeleteInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified Internet gateway.", - "id": "ec2-delete-internet-gateway-1", - "title": "To delete an Internet gateway" - } - ], - "DeleteKeyPair": [ - { - "input": { - "KeyName": "my-key-pair" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified key pair.", - "id": "ec2-delete-key-pair-1", - "title": "To delete a key pair" - } - ], - "DeleteNatGateway": [ - { - "input": { - "NatGatewayId": "nat-04ae55e711cec5680" - }, - "output": { - "NatGatewayId": "nat-04ae55e711cec5680" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified NAT gateway.", - "id": "ec2-delete-nat-gateway-1", - "title": "To delete a NAT gateway" - } - ], - "DeleteNetworkAcl": [ - { - "input": { - "NetworkAclId": "acl-5fb85d36" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified network ACL.", - "id": "ec2-delete-network-acl-1", - "title": "To delete a network ACL" - } - ], - "DeleteNetworkAclEntry": [ - { - "input": { - "Egress": true, - "NetworkAclId": "acl-5fb85d36", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes ingress rule number 100 from the specified network ACL.", - "id": "ec2-delete-network-acl-entry-1", - "title": "To delete a network ACL entry" - } - ], - "DeleteNetworkInterface": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified network interface.", - "id": "ec2-delete-network-interface-1", - "title": "To delete a network interface" - } - ], - "DeletePlacementGroup": [ - { - "input": { - "GroupName": "my-cluster" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified placement group.\n", - "id": "to-delete-a-placement-group-1472712349959", - "title": "To delete a placement group" - } - ], - "DeleteRoute": [ - { - "input": { - "DestinationCidrBlock": "0.0.0.0/0", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified route from the specified route table.", - "id": "ec2-delete-route-1", - "title": "To delete a route" - } - ], - "DeleteRouteTable": [ - { - "input": { - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified route table.", - "id": "ec2-delete-route-table-1", - "title": "To delete a route table" - } - ], - "DeleteSnapshot": [ - { - "input": { - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "id": "to-delete-a-snapshot-1472503042567", - "title": "To delete a snapshot" - } - ], - "DeleteSpotDatafeedSubscription": [ - { - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes a Spot data feed subscription for the account.", - "id": "ec2-delete-spot-datafeed-subscription-1", - "title": "To cancel a Spot Instance data feed subscription" - } - ], - "DeleteSubnet": [ - { - "input": { - "SubnetId": "subnet-9d4a7b6c" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified subnet.", - "id": "ec2-delete-subnet-1", - "title": "To delete a subnet" - } - ], - "DeleteTags": [ - { - "input": { - "Resources": [ - "ami-78a54011" - ], - "Tags": [ - { - "Key": "Stack", - "Value": "test" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the tag Stack=test from the specified image.", - "id": "ec2-delete-tags-1", - "title": "To delete a tag from a resource" - } - ], - "DeleteVolume": [ - { - "input": { - "VolumeId": "vol-049df61146c4d7901" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes an available volume with the volume ID of ``vol-049df61146c4d7901``. If the command succeeds, no output is returned.", - "id": "to-delete-a-volume-1472503111160", - "title": "To delete a volume" - } - ], - "DeleteVpc": [ - { - "input": { - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified VPC.", - "id": "ec2-delete-vpc-1", - "title": "To delete a VPC" - } - ], - "DescribeAccountAttributes": [ - { - "input": { - "AttributeNames": [ - "supported-platforms" - ] - }, - "output": { - "AccountAttributes": [ - { - "AttributeName": "supported-platforms", - "AttributeValues": [ - { - "AttributeValue": "EC2" - }, - { - "AttributeValue": "VPC" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the supported-platforms attribute for your AWS account.", - "id": "ec2-describe-account-attributes-1", - "title": "To describe a single attribute for your AWS account" - }, - { - "output": { - "AccountAttributes": [ - { - "AttributeName": "supported-platforms", - "AttributeValues": [ - { - "AttributeValue": "EC2" - }, - { - "AttributeValue": "VPC" - } - ] - }, - { - "AttributeName": "vpc-max-security-groups-per-interface", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "max-elastic-ips", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "max-instances", - "AttributeValues": [ - { - "AttributeValue": "20" - } - ] - }, - { - "AttributeName": "vpc-max-elastic-ips", - "AttributeValues": [ - { - "AttributeValue": "5" - } - ] - }, - { - "AttributeName": "default-vpc", - "AttributeValues": [ - { - "AttributeValue": "none" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attributes for your AWS account.", - "id": "ec2-describe-account-attributes-2", - "title": "To describe all attributes for your AWS account" - } - ], - "DescribeAddresses": [ - { - "output": { - "Addresses": [ - { - "Domain": "standard", - "InstanceId": "i-1234567890abcdef0", - "PublicIp": "198.51.100.0" - }, - { - "AllocationId": "eipalloc-12345678", - "AssociationId": "eipassoc-12345678", - "Domain": "vpc", - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-12345678", - "NetworkInterfaceOwnerId": "123456789012", - "PrivateIpAddress": "10.0.1.241", - "PublicIp": "203.0.113.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses.", - "id": "ec2-describe-addresses-1", - "title": "To describe your Elastic IP addresses" - }, - { - "input": { - "Filters": [ - { - "Name": "domain", - "Values": [ - "vpc" - ] - } - ] - }, - "output": { - "Addresses": [ - { - "AllocationId": "eipalloc-12345678", - "AssociationId": "eipassoc-12345678", - "Domain": "vpc", - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-12345678", - "NetworkInterfaceOwnerId": "123456789012", - "PrivateIpAddress": "10.0.1.241", - "PublicIp": "203.0.113.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses for use with instances in a VPC.", - "id": "ec2-describe-addresses-2", - "title": "To describe your Elastic IP addresses for EC2-VPC" - }, - { - "input": { - "Filters": [ - { - "Name": "domain", - "Values": [ - "standard" - ] - } - ] - }, - "output": { - "Addresses": [ - { - "Domain": "standard", - "InstanceId": "i-1234567890abcdef0", - "PublicIp": "198.51.100.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes your Elastic IP addresses for use with instances in EC2-Classic.", - "id": "ec2-describe-addresses-3", - "title": "To describe your Elastic IP addresses for EC2-Classic" - } - ], - "DescribeAvailabilityZones": [ - { - "output": { - "AvailabilityZones": [ - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1b" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1c" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1d" - }, - { - "Messages": [ - - ], - "RegionName": "us-east-1", - "State": "available", - "ZoneName": "us-east-1e" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Availability Zones that are available to you. The response includes Availability Zones only for the current region.", - "id": "ec2-describe-availability-zones-1", - "title": "To describe your Availability Zones" - } - ], - "DescribeCustomerGateways": [ - { - "input": { - "CustomerGatewayIds": [ - "cgw-0e11f167" - ] - }, - "output": { - "CustomerGateways": [ - { - "BgpAsn": "65534", - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified customer gateway.", - "id": "ec2-describe-customer-gateways-1", - "title": "To describe a customer gateway" - } - ], - "DescribeDhcpOptions": [ - { - "input": { - "DhcpOptionsIds": [ - "dopt-d9070ebb" - ] - }, - "output": { - "DhcpOptions": [ - { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ] - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified DHCP options set.", - "id": "ec2-describe-dhcp-options-1", - "title": "To describe a DHCP options set" - } - ], - "DescribeInstanceAttribute": [ - { - "input": { - "Attribute": "instanceType", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "InstanceId": "i-1234567890abcdef0", - "InstanceType": { - "Value": "t1.micro" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the instance type of the specified instance.\n", - "id": "to-describe-the-instance-type-1472712432132", - "title": "To describe the instance type" - }, - { - "input": { - "Attribute": "disableApiTermination", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "DisableApiTermination": { - "Value": "false" - }, - "InstanceId": "i-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``disableApiTermination`` attribute of the specified instance.\n", - "id": "to-describe-the-disableapitermination-attribute-1472712533466", - "title": "To describe the disableApiTermination attribute" - }, - { - "input": { - "Attribute": "blockDeviceMapping", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "AttachTime": "2013-05-17T22:42:34.000Z", - "DeleteOnTermination": true, - "Status": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - }, - { - "DeviceName": "/dev/sdf", - "Ebs": { - "AttachTime": "2013-09-10T23:07:00.000Z", - "DeleteOnTermination": false, - "Status": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - } - ], - "InstanceId": "i-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``blockDeviceMapping`` attribute of the specified instance.\n", - "id": "to-describe-the-block-device-mapping-for-an-instance-1472712645423", - "title": "To describe the block device mapping for an instance" - } - ], - "DescribeInternetGateways": [ - { - "input": { - "Filters": [ - { - "Name": "attachment.vpc-id", - "Values": [ - "vpc-a01106c2" - ] - } - ] - }, - "output": { - "InternetGateways": [ - { - "Attachments": [ - { - "State": "available", - "VpcId": "vpc-a01106c2" - } - ], - "InternetGatewayId": "igw-c0a643a9", - "Tags": [ - - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Internet gateway for the specified VPC.", - "id": "ec2-describe-internet-gateways-1", - "title": "To describe the Internet gateway for a VPC" - } - ], - "DescribeKeyPairs": [ - { - "input": { - "KeyNames": [ - "my-key-pair" - ] - }, - "output": { - "KeyPairs": [ - { - "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f", - "KeyName": "my-key-pair" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example displays the fingerprint for the specified key.", - "id": "ec2-describe-key-pairs-1", - "title": "To display a key pair" - } - ], - "DescribeMovingAddresses": [ - { - "output": { - "MovingAddressStatuses": [ - { - "MoveStatus": "MovingToVpc", - "PublicIp": "198.51.100.0" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all of your moving Elastic IP addresses.", - "id": "ec2-describe-moving-addresses-1", - "title": "To describe your moving addresses" - } - ], - "DescribeNatGateways": [ - { - "input": { - "Filter": [ - { - "Name": "vpc-id", - "Values": [ - "vpc-1a2b3c4d" - ] - } - ] - }, - "output": { - "NatGateways": [ - { - "CreateTime": "2015-12-01T12:26:55.983Z", - "NatGatewayAddresses": [ - { - "AllocationId": "eipalloc-89c620ec", - "NetworkInterfaceId": "eni-9dec76cd", - "PrivateIp": "10.0.0.149", - "PublicIp": "198.11.222.333" - } - ], - "NatGatewayId": "nat-05dba92075d71c408", - "State": "available", - "SubnetId": "subnet-847e4dc2", - "VpcId": "vpc-1a2b3c4d" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the NAT gateway for the specified VPC.", - "id": "ec2-describe-nat-gateways-1", - "title": "To describe a NAT gateway" - } - ], - "DescribeNetworkAcls": [ - { - "input": { - "NetworkAclIds": [ - "acl-5fb85d36" - ] - }, - "output": { - "NetworkAcls": [ - { - "Associations": [ - { - "NetworkAclAssociationId": "aclassoc-66ea5f0b", - "NetworkAclId": "acl-9aeb5ef7", - "SubnetId": "subnet-65ea5f08" - } - ], - "Entries": [ - { - "CidrBlock": "0.0.0.0/0", - "Egress": true, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - }, - { - "CidrBlock": "0.0.0.0/0", - "Egress": false, - "Protocol": "-1", - "RuleAction": "deny", - "RuleNumber": 32767 - } - ], - "IsDefault": false, - "NetworkAclId": "acl-5fb85d36", - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified network ACL.", - "id": "ec2-", - "title": "To describe a network ACL" - } - ], - "DescribeNetworkInterfaceAttribute": [ - { - "input": { - "Attribute": "attachment", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Attachment": { - "AttachTime": "2015-05-21T20:02:20.000Z", - "AttachmentId": "eni-attach-43348162", - "DeleteOnTermination": true, - "DeviceIndex": 0, - "InstanceId": "i-1234567890abcdef0", - "InstanceOwnerId": "123456789012", - "Status": "attached" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attachment attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-1", - "title": "To describe the attachment attribute of a network interface" - }, - { - "input": { - "Attribute": "description", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Description": { - "Value": "My description" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the description attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-2", - "title": "To describe the description attribute of a network interface" - }, - { - "input": { - "Attribute": "groupSet", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "Groups": [ - { - "GroupId": "sg-903004f8", - "GroupName": "my-security-group" - } - ], - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the groupSet attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-3", - "title": "To describe the groupSet attribute of a network interface" - }, - { - "input": { - "Attribute": "sourceDestCheck", - "NetworkInterfaceId": "eni-686ea200" - }, - "output": { - "NetworkInterfaceId": "eni-686ea200", - "SourceDestCheck": { - "Value": true - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the sourceDestCheck attribute of the specified network interface.", - "id": "ec2-describe-network-interface-attribute-4", - "title": "To describe the sourceDestCheck attribute of a network interface" - } - ], - "DescribeNetworkInterfaces": [ - { - "input": { - "NetworkInterfaceIds": [ - "eni-e5aa89a3" - ] - }, - "output": { - "NetworkInterfaces": [ - { - "Association": { - "AssociationId": "eipassoc-0fbb766a", - "IpOwnerId": "123456789012", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "PublicIp": "203.0.113.12" - }, - "Attachment": { - "AttachTime": "2013-11-30T23:36:42.000Z", - "AttachmentId": "eni-attach-66c4350a", - "DeleteOnTermination": false, - "DeviceIndex": 1, - "InstanceId": "i-1234567890abcdef0", - "InstanceOwnerId": "123456789012", - "Status": "attached" - }, - "AvailabilityZone": "us-east-1d", - "Description": "my network interface", - "Groups": [ - { - "GroupId": "sg-8637d3e3", - "GroupName": "default" - } - ], - "MacAddress": "02:2f:8f:b0:cf:75", - "NetworkInterfaceId": "eni-e5aa89a3", - "OwnerId": "123456789012", - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "PrivateIpAddress": "10.0.1.17", - "PrivateIpAddresses": [ - { - "Association": { - "AssociationId": "eipassoc-0fbb766a", - "IpOwnerId": "123456789012", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "PublicIp": "203.0.113.12" - }, - "Primary": true, - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "PrivateIpAddress": "10.0.1.17" - } - ], - "RequesterManaged": false, - "SourceDestCheck": true, - "Status": "in-use", - "SubnetId": "subnet-b61f49f0", - "TagSet": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "ec2-describe-network-interfaces-1", - "title": "To describe a network interface" - } - ], - "DescribeRegions": [ - { - "output": { - "Regions": [ - { - "Endpoint": "ec2.ap-south-1.amazonaws.com", - "RegionName": "ap-south-1" - }, - { - "Endpoint": "ec2.eu-west-1.amazonaws.com", - "RegionName": "eu-west-1" - }, - { - "Endpoint": "ec2.ap-southeast-1.amazonaws.com", - "RegionName": "ap-southeast-1" - }, - { - "Endpoint": "ec2.ap-southeast-2.amazonaws.com", - "RegionName": "ap-southeast-2" - }, - { - "Endpoint": "ec2.eu-central-1.amazonaws.com", - "RegionName": "eu-central-1" - }, - { - "Endpoint": "ec2.ap-northeast-2.amazonaws.com", - "RegionName": "ap-northeast-2" - }, - { - "Endpoint": "ec2.ap-northeast-1.amazonaws.com", - "RegionName": "ap-northeast-1" - }, - { - "Endpoint": "ec2.us-east-1.amazonaws.com", - "RegionName": "us-east-1" - }, - { - "Endpoint": "ec2.sa-east-1.amazonaws.com", - "RegionName": "sa-east-1" - }, - { - "Endpoint": "ec2.us-west-1.amazonaws.com", - "RegionName": "us-west-1" - }, - { - "Endpoint": "ec2.us-west-2.amazonaws.com", - "RegionName": "us-west-2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all the regions that are available to you.", - "id": "ec2-describe-regions-1", - "title": "To describe your regions" - } - ], - "DescribeRouteTables": [ - { - "input": { - "RouteTableIds": [ - "rtb-1f382e7d" - ] - }, - "output": { - "RouteTables": [ - { - "Associations": [ - { - "Main": true, - "RouteTableAssociationId": "rtbassoc-d8ccddba", - "RouteTableId": "rtb-1f382e7d" - } - ], - "PropagatingVgws": [ - - ], - "RouteTableId": "rtb-1f382e7d", - "Routes": [ - { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "local", - "State": "active" - } - ], - "Tags": [ - - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified route table.", - "id": "ec2-describe-route-tables-1", - "title": "To describe a route table" - } - ], - "DescribeScheduledInstanceAvailability": [ - { - "input": { - "FirstSlotStartTimeRange": { - "EarliestTime": "2016-01-31T00:00:00Z", - "LatestTime": "2016-01-31T04:00:00Z" - }, - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDays": [ - 1 - ] - } - }, - "output": { - "ScheduledInstanceAvailabilitySet": [ - { - "AvailabilityZone": "us-west-2b", - "AvailableInstanceCount": 20, - "FirstSlotStartTime": "2016-01-31T00:00:00Z", - "HourlyPrice": "0.095", - "InstanceType": "c4.large", - "MaxTermDurationInDays": 366, - "MinTermDurationInDays": 366, - "NetworkPlatform": "EC2-VPC", - "Platform": "Linux/UNIX", - "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false - }, - "SlotDurationInHours": 23, - "TotalScheduledInstanceHours": 1219 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes a schedule that occurs every week on Sunday, starting on the specified date. Note that the output contains a single schedule as an example.", - "id": "ec2-describe-scheduled-instance-availability-1", - "title": "To describe an available schedule" - } - ], - "DescribeScheduledInstances": [ - { - "input": { - "ScheduledInstanceIds": [ - "sci-1234-1234-1234-1234-123456789012" - ] - }, - "output": { - "ScheduledInstanceSet": [ - { - "AvailabilityZone": "us-west-2b", - "CreateDate": "2016-01-25T21:43:38.612Z", - "HourlyPrice": "0.095", - "InstanceCount": 1, - "InstanceType": "c4.large", - "NetworkPlatform": "EC2-VPC", - "NextSlotStartTime": "2016-01-31T09:00:00Z", - "Platform": "Linux/UNIX", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false, - "OccurrenceUnit": "" - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - "SlotDurationInHours": 32, - "TermEndDate": "2017-01-31T09:00:00Z", - "TermStartDate": "2016-01-31T09:00:00Z", - "TotalScheduledInstanceHours": 1696 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Scheduled Instance.", - "id": "ec2-describe-scheduled-instances-1", - "title": "To describe your Scheduled Instances" - } - ], - "DescribeSnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "SnapshotId": "snap-066877671789bd71b" - }, - "output": { - "CreateVolumePermissions": [ - - ], - "SnapshotId": "snap-066877671789bd71b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``createVolumePermission`` attribute on a snapshot with the snapshot ID of ``snap-066877671789bd71b``.", - "id": "to-describe-snapshot-attributes-1472503199736", - "title": "To describe snapshot attributes" - } - ], - "DescribeSnapshots": [ - { - "input": { - "SnapshotIds": [ - "snap-1234567890abcdef0" - ] - }, - "output": { - "NextToken": "", - "Snapshots": [ - { - "Description": "This is my snapshot.", - "OwnerId": "012345678910", - "Progress": "100%", - "SnapshotId": "snap-1234567890abcdef0", - "StartTime": "2014-02-28T21:28:32.000Z", - "State": "completed", - "VolumeId": "vol-049df61146c4d7901", - "VolumeSize": 8 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``.", - "id": "to-describe-a-snapshot-1472503807850", - "title": "To describe a snapshot" - }, - { - "input": { - "Filters": [ - { - "Name": "status", - "Values": [ - "pending" - ] - } - ], - "OwnerIds": [ - "012345678910" - ] - }, - "output": { - "NextToken": "", - "Snapshots": [ - { - "Description": "This is my copied snapshot.", - "OwnerId": "012345678910", - "Progress": "87%", - "SnapshotId": "snap-066877671789bd71b", - "StartTime": "2014-02-28T21:37:27.000Z", - "State": "pending", - "VolumeId": "vol-1234567890abcdef0", - "VolumeSize": 8 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all snapshots owned by the ID 012345678910 that are in the ``pending`` status.", - "id": "to-describe-snapshots-using-filters-1472503929793", - "title": "To describe snapshots using filters" - } - ], - "DescribeSpotDatafeedSubscription": [ - { - "output": { - "SpotDatafeedSubscription": { - "Bucket": "my-s3-bucket", - "OwnerId": "123456789012", - "Prefix": "spotdata", - "State": "Active" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the Spot Instance datafeed subscription for your AWS account.", - "id": "ec2-describe-spot-datafeed-subscription-1", - "title": "To describe the datafeed for your AWS account" - } - ], - "DescribeSpotFleetInstances": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "output": { - "ActiveInstances": [ - { - "InstanceId": "i-1234567890abcdef0", - "InstanceType": "m3.medium", - "SpotInstanceRequestId": "sir-08b93456" - } - ], - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the Spot Instances associated with the specified Spot fleet.", - "id": "ec2-describe-spot-fleet-instances-1", - "title": "To describe the Spot Instances associated with a Spot fleet" - } - ], - "DescribeSpotFleetRequestHistory": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "StartTime": "2015-05-26T00:00:00Z" - }, - "output": { - "HistoryRecords": [ - { - "EventInformation": { - "EventSubType": "submitted" - }, - "EventType": "fleetRequestChange", - "Timestamp": "2015-05-26T23:17:20.697Z" - }, - { - "EventInformation": { - "EventSubType": "active" - }, - "EventType": "fleetRequestChange", - "Timestamp": "2015-05-26T23:17:20.873Z" - }, - { - "EventInformation": { - "EventSubType": "launched", - "InstanceId": "i-1234567890abcdef0" - }, - "EventType": "instanceChange", - "Timestamp": "2015-05-26T23:21:21.712Z" - }, - { - "EventInformation": { - "EventSubType": "launched", - "InstanceId": "i-1234567890abcdef1" - }, - "EventType": "instanceChange", - "Timestamp": "2015-05-26T23:21:21.816Z" - } - ], - "NextToken": "CpHNsscimcV5oH7bSbub03CI2Qms5+ypNpNm+53MNlR0YcXAkp0xFlfKf91yVxSExmbtma3awYxMFzNA663ZskT0AHtJ6TCb2Z8bQC2EnZgyELbymtWPfpZ1ZbauVg+P+TfGlWxWWB/Vr5dk5d4LfdgA/DRAHUrYgxzrEXAMPLE=", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "StartTime": "2015-05-26T00:00:00Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example returns the history for the specified Spot fleet starting at the specified time.", - "id": "ec2-describe-spot-fleet-request-history-1", - "title": "To describe Spot fleet history" - } - ], - "DescribeSpotFleetRequests": [ - { - "input": { - "SpotFleetRequestIds": [ - "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - ] - }, - "output": { - "SpotFleetRequestConfigs": [ - { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "EbsOptimized": false, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "cc2.8xlarge", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeleteOnTermination": false, - "DeviceIndex": 0, - "SecondaryPrivateIpAddressCount": 0, - "SubnetId": "subnet-a61dafcf" - } - ] - }, - { - "EbsOptimized": false, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "r3.8xlarge", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeleteOnTermination": false, - "DeviceIndex": 0, - "SecondaryPrivateIpAddressCount": 0, - "SubnetId": "subnet-a61dafcf" - } - ] - } - ], - "SpotPrice": "0.05", - "TargetCapacity": 20 - }, - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "SpotFleetRequestState": "active" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Spot fleet request.", - "id": "ec2-describe-spot-fleet-requests-1", - "title": "To describe a Spot fleet request" - } - ], - "DescribeSpotInstanceRequests": [ - { - "input": { - "SpotInstanceRequestIds": [ - "sir-08b93456" - ] - }, - "output": { - "SpotInstanceRequests": [ - { - "CreateTime": "2014-04-30T18:14:55.000Z", - "InstanceId": "i-1234567890abcdef0", - "LaunchSpecification": { - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "DeleteOnTermination": true, - "VolumeSize": 8, - "VolumeType": "standard" - } - } - ], - "EbsOptimized": false, - "ImageId": "ami-7aba833f", - "InstanceType": "m1.small", - "KeyName": "my-key-pair", - "SecurityGroups": [ - { - "GroupId": "sg-e38f24a7", - "GroupName": "my-security-group" - } - ] - }, - "LaunchedAvailabilityZone": "us-west-1b", - "ProductDescription": "Linux/UNIX", - "SpotInstanceRequestId": "sir-08b93456", - "SpotPrice": "0.010000", - "State": "active", - "Status": { - "Code": "fulfilled", - "Message": "Your Spot request is fulfilled.", - "UpdateTime": "2014-04-30T18:16:21.000Z" - }, - "Type": "one-time" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified Spot Instance request.", - "id": "ec2-describe-spot-instance-requests-1", - "title": "To describe a Spot Instance request" - } - ], - "DescribeSpotPriceHistory": [ - { - "input": { - "EndTime": "2014-01-06T08:09:10", - "InstanceTypes": [ - "m1.xlarge" - ], - "ProductDescriptions": [ - "Linux/UNIX (Amazon VPC)" - ], - "StartTime": "2014-01-06T07:08:09" - }, - "output": { - "SpotPriceHistory": [ - { - "AvailabilityZone": "us-west-1a", - "InstanceType": "m1.xlarge", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "SpotPrice": "0.080000", - "Timestamp": "2014-01-06T04:32:53.000Z" - }, - { - "AvailabilityZone": "us-west-1c", - "InstanceType": "m1.xlarge", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "SpotPrice": "0.080000", - "Timestamp": "2014-01-05T11:28:26.000Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example returns the Spot Price history for m1.xlarge, Linux/UNIX (Amazon VPC) instances for a particular day in January.", - "id": "ec2-describe-spot-price-history-1", - "title": "To describe Spot price history for Linux/UNIX (Amazon VPC)" - } - ], - "DescribeSubnets": [ - { - "input": { - "Filters": [ - { - "Name": "vpc-id", - "Values": [ - "vpc-a01106c2" - ] - } - ] - }, - "output": { - "Subnets": [ - { - "AvailabilityZone": "us-east-1c", - "AvailableIpAddressCount": 251, - "CidrBlock": "10.0.1.0/24", - "DefaultForAz": false, - "MapPublicIpOnLaunch": false, - "State": "available", - "SubnetId": "subnet-9d4a7b6c", - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the subnets for the specified VPC.", - "id": "ec2-describe-subnets-1", - "title": "To describe the subnets for a VPC" - } - ], - "DescribeTags": [ - { - "input": { - "Filters": [ - { - "Name": "resource-id", - "Values": [ - "i-1234567890abcdef8" - ] - } - ] - }, - "output": { - "Tags": [ - { - "Key": "Stack", - "ResourceId": "i-1234567890abcdef8", - "ResourceType": "instance", - "Value": "test" - }, - { - "Key": "Name", - "ResourceId": "i-1234567890abcdef8", - "ResourceType": "instance", - "Value": "Beta Server" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the tags for the specified instance.", - "id": "ec2-describe-tags-1", - "title": "To describe the tags for a single resource" - } - ], - "DescribeVolumeAttribute": [ - { - "input": { - "Attribute": "autoEnableIO", - "VolumeId": "vol-049df61146c4d7901" - }, - "output": { - "AutoEnableIO": { - "Value": false - }, - "VolumeId": "vol-049df61146c4d7901" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the ``autoEnableIo`` attribute of the volume with the ID ``vol-049df61146c4d7901``.", - "id": "to-describe-a-volume-attribute-1472505773492", - "title": "To describe a volume attribute" - } - ], - "DescribeVolumeStatus": [ - { - "input": { - "VolumeIds": [ - "vol-1234567890abcdef0" - ] - }, - "output": { - "VolumeStatuses": [ - { - "Actions": [ - - ], - "AvailabilityZone": "us-east-1a", - "Events": [ - - ], - "VolumeId": "vol-1234567890abcdef0", - "VolumeStatus": { - "Details": [ - { - "Name": "io-enabled", - "Status": "passed" - }, - { - "Name": "io-performance", - "Status": "not-applicable" - } - ], - "Status": "ok" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the status for the volume ``vol-1234567890abcdef0``.", - "id": "to-describe-the-status-of-a-single-volume-1472507016193", - "title": "To describe the status of a single volume" - }, - { - "input": { - "Filters": [ - { - "Name": "volume-status.status", - "Values": [ - "impaired" - ] - } - ] - }, - "output": { - "VolumeStatuses": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the status for all volumes that are impaired. In this example output, there are no impaired volumes.", - "id": "to-describe-the-status-of-impaired-volumes-1472507239821", - "title": "To describe the status of impaired volumes" - } - ], - "DescribeVolumes": [ - { - "input": { - }, - "output": { - "NextToken": "", - "Volumes": [ - { - "Attachments": [ - { - "AttachTime": "2013-12-18T22:35:00.000Z", - "DeleteOnTermination": true, - "Device": "/dev/sda1", - "InstanceId": "i-1234567890abcdef0", - "State": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2013-12-18T22:35:00.084Z", - "Size": 8, - "SnapshotId": "snap-1234567890abcdef0", - "State": "in-use", - "VolumeId": "vol-049df61146c4d7901", - "VolumeType": "standard" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all of your volumes in the default region.", - "id": "to-describe-all-volumes-1472506358883", - "title": "To describe all volumes" - }, - { - "input": { - "Filters": [ - { - "Name": "attachment.instance-id", - "Values": [ - "i-1234567890abcdef0" - ] - }, - { - "Name": "attachment.delete-on-termination", - "Values": [ - "true" - ] - } - ] - }, - "output": { - "Volumes": [ - { - "Attachments": [ - { - "AttachTime": "2013-12-18T22:35:00.000Z", - "DeleteOnTermination": true, - "Device": "/dev/sda1", - "InstanceId": "i-1234567890abcdef0", - "State": "attached", - "VolumeId": "vol-049df61146c4d7901" - } - ], - "AvailabilityZone": "us-east-1a", - "CreateTime": "2013-12-18T22:35:00.084Z", - "Size": 8, - "SnapshotId": "snap-1234567890abcdef0", - "State": "in-use", - "VolumeId": "vol-049df61146c4d7901", - "VolumeType": "standard" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes all volumes that are both attached to the instance with the ID i-1234567890abcdef0 and set to delete when the instance terminates.", - "id": "to-describe-volumes-that-are-attached-to-a-specific-instance-1472506613578", - "title": "To describe volumes that are attached to a specific instance" - } - ], - "DescribeVpcAttribute": [ - { - "input": { - "Attribute": "enableDnsSupport", - "VpcId": "vpc-a01106c2" - }, - "output": { - "EnableDnsSupport": { - "Value": true - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.", - "id": "ec2-describe-vpc-attribute-1", - "title": "To describe the enableDnsSupport attribute" - }, - { - "input": { - "Attribute": "enableDnsHostnames", - "VpcId": "vpc-a01106c2" - }, - "output": { - "EnableDnsHostnames": { - "Value": true - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the enableDnsHostnames attribute. This attribute indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.", - "id": "ec2-describe-vpc-attribute-2", - "title": "To describe the enableDnsHostnames attribute" - } - ], - "DescribeVpcs": [ - { - "input": { - "VpcIds": [ - "vpc-a01106c2" - ] - }, - "output": { - "Vpcs": [ - { - "CidrBlock": "10.0.0.0/16", - "DhcpOptionsId": "dopt-7a8b9c2d", - "InstanceTenancy": "default", - "IsDefault": false, - "State": "available", - "Tags": [ - { - "Key": "Name", - "Value": "MyVPC" - } - ], - "VpcId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified VPC.", - "id": "ec2-describe-vpcs-1", - "title": "To describe a VPC" - } - ], - "DetachInternetGateway": [ - { - "input": { - "InternetGatewayId": "igw-c0a643a9", - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified Internet gateway from the specified VPC.", - "id": "ec2-detach-internet-gateway-1", - "title": "To detach an Internet gateway from a VPC" - } - ], - "DetachNetworkInterface": [ - { - "input": { - "AttachmentId": "eni-attach-66c4350a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified network interface from its attached instance.", - "id": "ec2-detach-network-interface-1", - "title": "To detach a network interface from an instance" - } - ], - "DetachVolume": [ - { - "input": { - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "AttachTime": "2014-02-27T19:23:06.000Z", - "Device": "/dev/sdb", - "InstanceId": "i-1234567890abcdef0", - "State": "detaching", - "VolumeId": "vol-049df61146c4d7901" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the volume (``vol-049df61146c4d7901``) from the instance it is attached to.", - "id": "to-detach-a-volume-from-an-instance-1472507977694", - "title": "To detach a volume from an instance" - } - ], - "DisableVgwRoutePropagation": [ - { - "input": { - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disables the specified virtual private gateway from propagating static routes to the specified route table.", - "id": "ec2-disable-vgw-route-propagation-1", - "title": "To disable route propagation" - } - ], - "DisassociateAddress": [ - { - "input": { - "AssociationId": "eipassoc-2bebb745" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates an Elastic IP address from an instance in a VPC.", - "id": "ec2-disassociate-address-1", - "title": "To disassociate an Elastic IP address in EC2-VPC" - }, - { - "input": { - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates an Elastic IP address from an instance in EC2-Classic.", - "id": "ec2-disassociate-address-2", - "title": "To disassociate an Elastic IP addresses in EC2-Classic" - } - ], - "DisassociateRouteTable": [ - { - "input": { - "AssociationId": "rtbassoc-781d0d1a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example disassociates the specified route table from its associated subnet.", - "id": "ec2-disassociate-route-table-1", - "title": "To disassociate a route table" - } - ], - "EnableVgwRoutePropagation": [ - { - "input": { - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables the specified virtual private gateway to propagate static routes to the specified route table.", - "id": "ec2-enable-vgw-route-propagation-1", - "title": "To enable route propagation" - } - ], - "EnableVolumeIO": [ - { - "input": { - "VolumeId": "vol-1234567890abcdef0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables I/O on volume ``vol-1234567890abcdef0``.", - "id": "to-enable-io-for-a-volume-1472508114867", - "title": "To enable I/O for a volume" - } - ], - "ModifyNetworkInterfaceAttribute": [ - { - "input": { - "Attachment": { - "AttachmentId": "eni-attach-43348162", - "DeleteOnTermination": false - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the attachment attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-1", - "title": "To modify the attachment attribute of a network interface" - }, - { - "input": { - "Description": { - "Value": "My description" - }, - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the description attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-2", - "title": "To modify the description attribute of a network interface" - }, - { - "input": { - "Groups": [ - "sg-903004f8", - "sg-1a2b3c4d" - ], - "NetworkInterfaceId": "eni-686ea200" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command modifies the groupSet attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-3", - "title": "To modify the groupSet attribute of a network interface" - }, - { - "input": { - "NetworkInterfaceId": "eni-686ea200", - "SourceDestCheck": { - "Value": false - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command modifies the sourceDestCheck attribute of the specified network interface.", - "id": "ec2-modify-network-interface-attribute-4", - "title": "To modify the sourceDestCheck attribute of a network interface" - } - ], - "ModifySnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "OperationType": "remove", - "SnapshotId": "snap-1234567890abcdef0", - "UserIds": [ - "123456789012" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies snapshot ``snap-1234567890abcdef0`` to remove the create volume permission for a user with the account ID ``123456789012``. If the command succeeds, no output is returned.", - "id": "to-modify-a-snapshot-attribute-1472508385907", - "title": "To modify a snapshot attribute" - }, - { - "input": { - "Attribute": "createVolumePermission", - "GroupNames": [ - "all" - ], - "OperationType": "add", - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example makes the snapshot ``snap-1234567890abcdef0`` public.", - "id": "to-make-a-snapshot-public-1472508470529", - "title": "To make a snapshot public" - } - ], - "ModifySpotFleetRequest": [ - { - "input": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "TargetCapacity": 20 - }, - "output": { - "Return": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example increases the target capacity of the specified Spot fleet request.", - "id": "ec2-modify-spot-fleet-request-1", - "title": "To increase the target capacity of a Spot fleet request" - }, - { - "input": { - "ExcessCapacityTerminationPolicy": "NoTermination ", - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "TargetCapacity": 10 - }, - "output": { - "Return": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example decreases the target capacity of the specified Spot fleet request without terminating any Spot Instances as a result.", - "id": "ec2-modify-spot-fleet-request-2", - "title": "To decrease the target capacity of a Spot fleet request" - } - ], - "ModifySubnetAttribute": [ - { - "input": { - "MapPublicIpOnLaunch": { - "Value": true - }, - "SubnetId": "subnet-1a2b3c4d" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the specified subnet so that all instances launched into this subnet are assigned a public IP address.", - "id": "ec2-modify-subnet-attribute-1", - "title": "To change a subnet's public IP addressing behavior" - } - ], - "ModifyVolumeAttribute": [ - { - "input": { - "AutoEnableIO": { - "Value": true - }, - "DryRun": true, - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the ``autoEnableIo`` attribute of the volume with the ID ``vol-1234567890abcdef0`` to ``true``. If the command succeeds, no output is returned.", - "id": "to-modify-a-volume-attribute-1472508596749", - "title": "To modify a volume attribute" - } - ], - "ModifyVpcAttribute": [ - { - "input": { - "EnableDnsSupport": { - "Value": false - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for instances in the VPC to their corresponding IP addresses; otherwise, it does not.", - "id": "ec2-modify-vpc-attribute-1", - "title": "To modify the enableDnsSupport attribute" - }, - { - "input": { - "EnableDnsHostnames": { - "Value": false - }, - "VpcId": "vpc-a01106c2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the enableDnsHostnames attribute. This attribute indicates whether instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.", - "id": "ec2-modify-vpc-attribute-2", - "title": "To modify the enableDnsHostnames attribute" - } - ], - "MoveAddressToVpc": [ - { - "input": { - "PublicIp": "54.123.4.56" - }, - "output": { - "Status": "MoveInProgress" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example moves the specified Elastic IP address to the EC2-VPC platform.", - "id": "ec2-move-address-to-vpc-1", - "title": "To move an address to EC2-VPC" - } - ], - "PurchaseScheduledInstances": [ - { - "input": { - "PurchaseRequests": [ - { - "InstanceCount": 1, - "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi..." - } - ] - }, - "output": { - "ScheduledInstanceSet": [ - { - "AvailabilityZone": "us-west-2b", - "CreateDate": "2016-01-25T21:43:38.612Z", - "HourlyPrice": "0.095", - "InstanceCount": 1, - "InstanceType": "c4.large", - "NetworkPlatform": "EC2-VPC", - "NextSlotStartTime": "2016-01-31T09:00:00Z", - "Platform": "Linux/UNIX", - "Recurrence": { - "Frequency": "Weekly", - "Interval": 1, - "OccurrenceDaySet": [ - 1 - ], - "OccurrenceRelativeToEnd": false, - "OccurrenceUnit": "" - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - "SlotDurationInHours": 32, - "TermEndDate": "2017-01-31T09:00:00Z", - "TermStartDate": "2016-01-31T09:00:00Z", - "TotalScheduledInstanceHours": 1696 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example purchases a Scheduled Instance.", - "id": "ec2-purchase-scheduled-instances-1", - "title": "To purchase a Scheduled Instance" - } - ], - "ReleaseAddress": [ - { - "input": { - "AllocationId": "eipalloc-64d5890a" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example releases an Elastic IP address for use with instances in a VPC.", - "id": "ec2-release-address-1", - "title": "To release an Elastic IP address for EC2-VPC" - }, - { - "input": { - "PublicIp": "198.51.100.0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example releases an Elastic IP address for use with instances in EC2-Classic.", - "id": "ec2-release-address-2", - "title": "To release an Elastic IP addresses for EC2-Classic" - } - ], - "ReplaceNetworkAclAssociation": [ - { - "input": { - "AssociationId": "aclassoc-e5b95c8c", - "NetworkAclId": "acl-5fb85d36" - }, - "output": { - "NewAssociationId": "aclassoc-3999875b" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified network ACL with the subnet for the specified network ACL association.", - "id": "ec2-replace-network-acl-association-1", - "title": "To replace the network ACL associated with a subnet" - } - ], - "ReplaceNetworkAclEntry": [ - { - "input": { - "CidrBlock": "203.0.113.12/24", - "Egress": false, - "NetworkAclId": "acl-5fb85d36", - "PortRange": { - "From": 53, - "To": 53 - }, - "Protocol": "udp", - "RuleAction": "allow", - "RuleNumber": 100 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces an entry for the specified network ACL. The new rule 100 allows ingress traffic from 203.0.113.12/24 on UDP port 53 (DNS) into any associated subnet.", - "id": "ec2-replace-network-acl-entry-1", - "title": "To replace a network ACL entry" - } - ], - "ReplaceRoute": [ - { - "input": { - "DestinationCidrBlock": "10.0.0.0/16", - "GatewayId": "vgw-9a4cacf3", - "RouteTableId": "rtb-22574640" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces the specified route in the specified table table. The new route matches the specified CIDR and sends the traffic to the specified virtual private gateway.", - "id": "ec2-replace-route-1", - "title": "To replace a route" - } - ], - "ReplaceRouteTableAssociation": [ - { - "input": { - "AssociationId": "rtbassoc-781d0d1a", - "RouteTableId": "rtb-22574640" - }, - "output": { - "NewAssociationId": "rtbassoc-3a1f0f58" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified route table with the subnet for the specified route table association.", - "id": "ec2-replace-route-table-association-1", - "title": "To replace the route table associated with a subnet" - } - ], - "RequestSpotFleet": [ - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "SecurityGroups": [ - { - "GroupId": "sg-1a2b3c4d" - } - ], - "SubnetId": "subnet-1a2b3c4d, subnet-3c4d5e6f" - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request with two launch specifications that differ only by subnet. The Spot fleet launches the instances in the specified subnet with the lowest price. If the instances are launched in a default VPC, they receive a public IP address by default. If the instances are launched in a nondefault VPC, they do not receive a public IP address by default. Note that you can't specify different subnets from the same Availability Zone in a Spot fleet request.", - "id": "ec2-request-spot-fleet-1", - "title": "To request a Spot fleet in the subnet with the lowest price" - }, - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2a, us-west-2b" - }, - "SecurityGroups": [ - { - "GroupId": "sg-1a2b3c4d" - } - ] - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request with two launch specifications that differ only by Availability Zone. The Spot fleet launches the instances in the specified Availability Zone with the lowest price. If your account supports EC2-VPC only, Amazon EC2 launches the Spot instances in the default subnet of the Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the Availability Zone.", - "id": "ec2-request-spot-fleet-2", - "title": "To request a Spot fleet in the Availability Zone with the lowest price" - }, - { - "input": { - "SpotFleetRequestConfig": { - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::880185128111:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeviceIndex": 0, - "Groups": [ - "sg-1a2b3c4d" - ], - "SubnetId": "subnet-1a2b3c4d" - } - ] - } - ], - "SpotPrice": "0.04", - "TargetCapacity": 2 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example assigns public addresses to instances launched in a nondefault VPC. Note that when you specify a network interface, you must include the subnet ID and security group ID using the network interface.", - "id": "ec2-request-spot-fleet-3", - "title": "To launch Spot instances in a subnet and assign them public IP addresses" - }, - { - "input": { - "SpotFleetRequestConfig": { - "AllocationStrategy": "diversified", - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", - "LaunchSpecifications": [ - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "c4.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - }, - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - }, - { - "ImageId": "ami-1a2b3c4d", - "InstanceType": "r3.2xlarge", - "SubnetId": "subnet-1a2b3c4d" - } - ], - "SpotPrice": "0.70", - "TargetCapacity": 30 - } - }, - "output": { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a Spot fleet request that launches 30 instances using the diversified allocation strategy. The launch specifications differ by instance type. The Spot fleet distributes the instances across the launch specifications such that there are 10 instances of each type.", - "id": "ec2-request-spot-fleet-4", - "title": "To request a Spot fleet using the diversified allocation strategy" - } - ], - "RequestSpotInstances": [ - { - "input": { - "InstanceCount": 5, - "LaunchSpecification": { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2a" - }, - "SecurityGroupIds": [ - "sg-1a2b3c4d" - ] - }, - "SpotPrice": "0.03", - "Type": "one-time" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the specified Availability Zone.", - "id": "ec2-request-spot-instances-1", - "title": "To create a one-time Spot Instance request" - }, - { - "input": { - "InstanceCount": 5, - "LaunchSpecification": { - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - }, - "ImageId": "ami-1a2b3c4d", - "InstanceType": "m3.medium", - "SecurityGroupIds": [ - "sg-1a2b3c4d" - ], - "SubnetId": "subnet-1a2b3c4d" - }, - "SpotPrice": "0.050", - "Type": "one-time" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example command creates a one-time Spot Instance request for five instances in the specified subnet. Amazon EC2 launches the instances in the specified subnet. If the VPC is a nondefault VPC, the instances do not receive a public IP address by default.", - "id": "ec2-request-spot-instances-2", - "title": "To create a one-time Spot Instance request" - } - ], - "ResetSnapshotAttribute": [ - { - "input": { - "Attribute": "createVolumePermission", - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example resets the create volume permissions for snapshot ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "id": "to-reset-a-snapshot-attribute-1472508825735", - "title": "To reset a snapshot attribute" - } - ], - "RestoreAddressToClassic": [ - { - "input": { - "PublicIp": "198.51.100.0" - }, - "output": { - "PublicIp": "198.51.100.0", - "Status": "MoveInProgress" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example restores the specified Elastic IP address to the EC2-Classic platform.", - "id": "ec2-restore-address-to-classic-1", - "title": "To restore an address to EC2-Classic" - } - ], - "RunScheduledInstances": [ - { - "input": { - "InstanceCount": 1, - "LaunchSpecification": { - "IamInstanceProfile": { - "Name": "my-iam-role" - }, - "ImageId": "ami-12345678", - "InstanceType": "c4.large", - "KeyName": "my-key-pair", - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeviceIndex": 0, - "Groups": [ - "sg-12345678" - ], - "SubnetId": "subnet-12345678" - } - ] - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - }, - "output": { - "InstanceIdSet": [ - "i-1234567890abcdef0" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example launches the specified Scheduled Instance in a VPC.", - "id": "ec2-run-scheduled-instances-1", - "title": "To launch a Scheduled Instance in a VPC" - }, - { - "input": { - "InstanceCount": 1, - "LaunchSpecification": { - "IamInstanceProfile": { - "Name": "my-iam-role" - }, - "ImageId": "ami-12345678", - "InstanceType": "c4.large", - "KeyName": "my-key-pair", - "Placement": { - "AvailabilityZone": "us-west-2b" - }, - "SecurityGroupIds": [ - "sg-12345678" - ] - }, - "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - }, - "output": { - "InstanceIdSet": [ - "i-1234567890abcdef0" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example launches the specified Scheduled Instance in EC2-Classic.", - "id": "ec2-run-scheduled-instances-2", - "title": "To launch a Scheduled Instance in EC2-Classic" - } - ], - "UnassignPrivateIpAddresses": [ - { - "input": { - "NetworkInterfaceId": "eni-e5aa89a3", - "PrivateIpAddresses": [ - "10.0.0.82" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example unassigns the specified private IP address from the specified network interface.", - "id": "ec2-unassign-private-ip-addresses-1", - "title": "To unassign a secondary private IP address from a network interface" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/paginators-1.json deleted file mode 100644 index 3d086aac..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/paginators-1.json +++ /dev/null @@ -1,87 +0,0 @@ -{ - "pagination": { - "DescribeIamInstanceProfileAssociations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "IamInstanceProfileAssociations" - }, - "DescribeInstanceStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceStatuses" - }, - "DescribeInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - }, - "DescribeReservedInstancesOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ReservedInstancesOfferings" - }, - "DescribeReservedInstancesModifications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "ReservedInstancesModifications" - }, - "DescribeSecurityGroups": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SecurityGroups" - }, - "DescribeSnapshots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Snapshots" - }, - "DescribeSpotFleetInstances": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ActiveInstances" - }, - "DescribeSpotFleetRequests": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotFleetRequestConfigs" - }, - "DescribeSpotPriceHistory": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "SpotPriceHistory" - }, - "DescribeTags": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Tags" - }, - "DescribeVolumeStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "VolumeStatuses" - }, - "DescribeVolumes": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Volumes" - }, - "DescribeNatGateways": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "NatGateways" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/service-2.json deleted file mode 100644 index df945c9d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/service-2.json +++ /dev/null @@ -1,24637 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-15", - "endpointPrefix":"ec2", - "protocol":"ec2", - "serviceAbbreviation":"Amazon EC2", - "serviceFullName":"Amazon Elastic Compute Cloud", - "serviceId":"EC2", - "signatureVersion":"v4", - "uid":"ec2-2016-11-15", - "xmlNamespace":"http://ec2.amazonaws.com/doc/2016-11-15" - }, - "operations":{ - "AcceptReservedInstancesExchangeQuote":{ - "name":"AcceptReservedInstancesExchangeQuote", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptReservedInstancesExchangeQuoteRequest"}, - "output":{"shape":"AcceptReservedInstancesExchangeQuoteResult"}, - "documentation":"

Accepts the Convertible Reserved Instance exchange quote described in the GetReservedInstancesExchangeQuote call.

" - }, - "AcceptVpcEndpointConnections":{ - "name":"AcceptVpcEndpointConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcEndpointConnectionsRequest"}, - "output":{"shape":"AcceptVpcEndpointConnectionsResult"}, - "documentation":"

Accepts one or more interface VPC endpoint connection requests to your VPC endpoint service.

" - }, - "AcceptVpcPeeringConnection":{ - "name":"AcceptVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptVpcPeeringConnectionRequest"}, - "output":{"shape":"AcceptVpcPeeringConnectionResult"}, - "documentation":"

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use DescribeVpcPeeringConnections to view your outstanding VPC peering connection requests.

For an inter-region VPC peering connection request, you must accept the VPC peering connection in the region of the accepter VPC.

" - }, - "AllocateAddress":{ - "name":"AllocateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateAddressRequest"}, - "output":{"shape":"AllocateAddressResult"}, - "documentation":"

Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different AWS account.

[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per region and 5 Elastic IP addresses for EC2-VPC per region.

For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AllocateHosts":{ - "name":"AllocateHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateHostsRequest"}, - "output":{"shape":"AllocateHostsResult"}, - "documentation":"

Allocates a Dedicated Host to your account. At a minimum, specify the instance size type, Availability Zone, and quantity of hosts to allocate.

" - }, - "AssignIpv6Addresses":{ - "name":"AssignIpv6Addresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignIpv6AddressesRequest"}, - "output":{"shape":"AssignIpv6AddressesResult"}, - "documentation":"

Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within the subnet's IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AssignPrivateIpAddresses":{ - "name":"AssignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignPrivateIpAddressesRequest"}, - "documentation":"

Assigns one or more secondary private IP addresses to the specified network interface. You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

AssignPrivateIpAddresses is available only in EC2-VPC.

" - }, - "AssociateAddress":{ - "name":"AssociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAddressRequest"}, - "output":{"shape":"AssociateAddressResult"}, - "documentation":"

Associates an Elastic IP address with an instance or a network interface. Before you can use an Elastic IP address, you must allocate it to your account.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance. If you associate an Elastic IP address with an instance that has an existing Elastic IP address, the existing address is disassociated from the instance, but remains allocated to your account.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation. You cannot associate an Elastic IP address with an instance or network interface that has an existing Elastic IP address.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

" - }, - "AssociateDhcpOptions":{ - "name":"AssociateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDhcpOptionsRequest"}, - "documentation":"

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateIamInstanceProfile":{ - "name":"AssociateIamInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateIamInstanceProfileRequest"}, - "output":{"shape":"AssociateIamInstanceProfileResult"}, - "documentation":"

Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.

" - }, - "AssociateRouteTable":{ - "name":"AssociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateRouteTableRequest"}, - "output":{"shape":"AssociateRouteTableResult"}, - "documentation":"

Associates a subnet with a route table. The subnet and route table must be in the same VPC. This association causes traffic originating from the subnet to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table from the subnet later. A route table can be associated with multiple subnets.

For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "AssociateSubnetCidrBlock":{ - "name":"AssociateSubnetCidrBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateSubnetCidrBlockRequest"}, - "output":{"shape":"AssociateSubnetCidrBlockResult"}, - "documentation":"

Associates a CIDR block with your subnet. You can only associate a single IPv6 CIDR block with your subnet. An IPv6 CIDR block must have a prefix length of /64.

" - }, - "AssociateVpcCidrBlock":{ - "name":"AssociateVpcCidrBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateVpcCidrBlockRequest"}, - "output":{"shape":"AssociateVpcCidrBlockResult"}, - "documentation":"

Associates a CIDR block with your VPC. You can associate a secondary IPv4 CIDR block, or you can associate an Amazon-provided IPv6 CIDR block. The IPv6 CIDR block size is fixed at /56.

For more information about associating CIDR blocks with your VPC and applicable restrictions, see VPC and Subnet Sizing in the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachClassicLinkVpc":{ - "name":"AttachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachClassicLinkVpcRequest"}, - "output":{"shape":"AttachClassicLinkVpcResult"}, - "documentation":"

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

Linking your instance to a VPC is sometimes referred to as attaching your instance.

" - }, - "AttachInternetGateway":{ - "name":"AttachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInternetGatewayRequest"}, - "documentation":"

Attaches an internet gateway to a VPC, enabling connectivity between the internet and the VPC. For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "AttachNetworkInterface":{ - "name":"AttachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachNetworkInterfaceRequest"}, - "output":{"shape":"AttachNetworkInterfaceResult"}, - "documentation":"

Attaches a network interface to an instance.

" - }, - "AttachVolume":{ - "name":"AttachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an EBS Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

  • The volume can be attached only to a stopped instance.

  • AWS Marketplace product codes are copied from the volume to the instance.

  • You must be subscribed to the product.

  • The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.

For more information about EBS volumes, see Attaching Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "AttachVpnGateway":{ - "name":"AttachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachVpnGatewayRequest"}, - "output":{"shape":"AttachVpnGatewayResult"}, - "documentation":"

Attaches a virtual private gateway to a VPC. You can attach one virtual private gateway to one VPC at a time.

For more information, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "AuthorizeSecurityGroupEgress":{ - "name":"AuthorizeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Adds one or more egress rules to a security group for use with a VPC. Specifically, this action permits instances to send traffic to one or more destination IPv4 or IPv6 CIDR address ranges, or to one or more destination security groups for the same VPC. This action doesn't apply to security groups for use in EC2-Classic. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide. For more information about security group limits, see Amazon VPC Limits.

Each rule consists of the protocol (for example, TCP), plus either a CIDR range or a source group. For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes. You can optionally specify a description for the rule.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

" - }, - "AuthorizeSecurityGroupIngress":{ - "name":"AuthorizeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSecurityGroupIngressRequest"}, - "documentation":"

Adds one or more ingress rules to a security group.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

[EC2-Classic] This action gives one or more IPv4 CIDR address ranges permission to access a security group in your account, or gives one or more security groups (called the source groups) permission to access a security group for your account. A source group can be for your own AWS account, or another. You can have up to 100 rules per group.

[EC2-VPC] This action gives one or more IPv4 or IPv6 CIDR address ranges permission to access a security group in your VPC, or gives one or more other security groups (called the source groups) permission to access a security group for your VPC. The security groups must all be for the same VPC or a peer VPC in a VPC peering connection. For more information about VPC security group limits, see Amazon VPC Limits.

You can optionally specify a description for the security group rule.

" - }, - "BundleInstance":{ - "name":"BundleInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BundleInstanceRequest"}, - "output":{"shape":"BundleInstanceResult"}, - "documentation":"

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:\\) is bundled. Data on other instance store volumes is not preserved.

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

" - }, - "CancelBundleTask":{ - "name":"CancelBundleTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelBundleTaskRequest"}, - "output":{"shape":"CancelBundleTaskResult"}, - "documentation":"

Cancels a bundling operation for an instance store-backed Windows instance.

" - }, - "CancelConversionTask":{ - "name":"CancelConversionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelConversionRequest"}, - "documentation":"

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "documentation":"

Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

" - }, - "CancelImportTask":{ - "name":"CancelImportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelImportTaskRequest"}, - "output":{"shape":"CancelImportTaskResult"}, - "documentation":"

Cancels an in-process import virtual machine or import snapshot task.

" - }, - "CancelReservedInstancesListing":{ - "name":"CancelReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelReservedInstancesListingRequest"}, - "output":{"shape":"CancelReservedInstancesListingResult"}, - "documentation":"

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CancelSpotFleetRequests":{ - "name":"CancelSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotFleetRequestsRequest"}, - "output":{"shape":"CancelSpotFleetRequestsResponse"}, - "documentation":"

Cancels the specified Spot Fleet requests.

After you cancel a Spot Fleet request, the Spot Fleet launches no new Spot Instances. You must specify whether the Spot Fleet should also terminate its Spot Instances. If you terminate the instances, the Spot Fleet request enters the cancelled_terminating state. Otherwise, the Spot Fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

" - }, - "CancelSpotInstanceRequests":{ - "name":"CancelSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelSpotInstanceRequestsRequest"}, - "output":{"shape":"CancelSpotInstanceRequestsResult"}, - "documentation":"

Cancels one or more Spot Instance requests.

Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

" - }, - "ConfirmProductInstance":{ - "name":"ConfirmProductInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmProductInstanceRequest"}, - "output":{"shape":"ConfirmProductInstanceResult"}, - "documentation":"

Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner must verify whether another user's instance is eligible for support.

" - }, - "CopyFpgaImage":{ - "name":"CopyFpgaImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyFpgaImageRequest"}, - "output":{"shape":"CopyFpgaImageResult"}, - "documentation":"

Copies the specified Amazon FPGA Image (AFI) to the current region.

" - }, - "CopyImage":{ - "name":"CopyImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyImageRequest"}, - "output":{"shape":"CopyImageResult"}, - "documentation":"

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request.

For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotRequest"}, - "output":{"shape":"CopySnapshotResult"}, - "documentation":"

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless the Encrypted flag is specified during the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a non-default CMK with the KmsKeyId parameter.

To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

Snapshots created by copying another snapshot have an arbitrary volume ID that should not be used for any purpose.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateCustomerGateway":{ - "name":"CreateCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomerGatewayRequest"}, - "output":{"shape":"CreateCustomerGatewayResult"}, - "documentation":"

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and may be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 region, and 9059, which is reserved in the eu-west-1 region.

For more information about VPN customer gateways, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

" - }, - "CreateDefaultSubnet":{ - "name":"CreateDefaultSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDefaultSubnetRequest"}, - "output":{"shape":"CreateDefaultSubnetResult"}, - "documentation":"

Creates a default subnet with a size /20 IPv4 CIDR block in the specified Availability Zone in your default VPC. You can have only one default subnet per Availability Zone. For more information, see Creating a Default Subnet in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateDefaultVpc":{ - "name":"CreateDefaultVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDefaultVpcRequest"}, - "output":{"shape":"CreateDefaultVpcResult"}, - "documentation":"

Creates a default VPC with a size /16 IPv4 CIDR block and a default subnet in each Availability Zone. For more information about the components of a default VPC, see Default VPC and Default Subnets in the Amazon Virtual Private Cloud User Guide. You cannot specify the components of the default VPC yourself.

iIf you deleted your previous default VPC, you can create a default VPC. You cannot have more than one default VPC per Region.

If your account supports EC2-Classic, you cannot use this action to create a default VPC in a Region that supports EC2-Classic. If you want a default VPC in a Region that supports EC2-Classic, see \"I really want a default VPC for my existing EC2 account. Is that possible?\" in the Default VPCs FAQ.

" - }, - "CreateDhcpOptions":{ - "name":"CreateDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDhcpOptionsRequest"}, - "output":{"shape":"CreateDhcpOptionsResult"}, - "documentation":"

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

  • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. ITo have your instance to receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.

  • domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

  • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

  • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

  • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateEgressOnlyInternetGateway":{ - "name":"CreateEgressOnlyInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEgressOnlyInternetGatewayRequest"}, - "output":{"shape":"CreateEgressOnlyInternetGatewayResult"}, - "documentation":"

[IPv6 only] Creates an egress-only internet gateway for your VPC. An egress-only internet gateway is used to enable outbound communication over IPv6 from instances in your VPC to the internet, and prevents hosts outside of your VPC from initiating an IPv6 connection with your instance.

" - }, - "CreateFleet":{ - "name":"CreateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFleetRequest"}, - "output":{"shape":"CreateFleetResult"}, - "documentation":"

Launches an EC2 Fleet.

You can create a single EC2 Fleet that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateFlowLogs":{ - "name":"CreateFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFlowLogsRequest"}, - "output":{"shape":"CreateFlowLogsResult"}, - "documentation":"

Creates one or more flow logs to capture information about IP traffic for a specific network interface, subnet, or VPC.

Flow log data for a monitored network interface is recorded as flow log records, which are log events consisting of fields that describe the traffic flow. For more information, see Flow Log Records in the Amazon Virtual Private Cloud User Guide.

When publishing to CloudWatch Logs, flow log records are published to a log group, and each network interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all of the monitored network interfaces are published to a single log file object that is stored in the specified bucket.

For more information, see VPC Flow Logs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateFpgaImage":{ - "name":"CreateFpgaImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFpgaImageRequest"}, - "output":{"shape":"CreateFpgaImageResult"}, - "documentation":"

Creates an Amazon FPGA Image (AFI) from the specified design checkpoint (DCP).

The create operation is asynchronous. To verify that the AFI is ready for use, check the output logs.

An AFI contains the FPGA bitstream that is ready to download to an FPGA. You can securely deploy an AFI on one or more FPGA-accelerated instances. For more information, see the AWS FPGA Hardware Development Kit.

" - }, - "CreateImage":{ - "name":"CreateImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateImageRequest"}, - "output":{"shape":"CreateImageResult"}, - "documentation":"

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateInstanceExportTask":{ - "name":"CreateInstanceExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceExportTaskRequest"}, - "output":{"shape":"CreateInstanceExportTaskResult"}, - "documentation":"

Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "CreateInternetGateway":{ - "name":"CreateInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInternetGatewayRequest"}, - "output":{"shape":"CreateInternetGatewayResult"}, - "documentation":"

Creates an internet gateway for use with a VPC. After creating the internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{"shape":"KeyPair"}, - "documentation":"

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per region.

The key pair returned to you is available only in the region in which you create it. If you prefer, you can create your own key pair using a third-party tool and upload it to any region using ImportKeyPair.

For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateLaunchTemplate":{ - "name":"CreateLaunchTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLaunchTemplateRequest"}, - "output":{"shape":"CreateLaunchTemplateResult"}, - "documentation":"

Creates a launch template. A launch template contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify a launch template instead of providing the launch parameters in the request.

" - }, - "CreateLaunchTemplateVersion":{ - "name":"CreateLaunchTemplateVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLaunchTemplateVersionRequest"}, - "output":{"shape":"CreateLaunchTemplateVersionResult"}, - "documentation":"

Creates a new version for a launch template. You can specify an existing version of launch template from which to base the new version.

Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.

" - }, - "CreateNatGateway":{ - "name":"CreateNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNatGatewayRequest"}, - "output":{"shape":"CreateNatGatewayResult"}, - "documentation":"

Creates a NAT gateway in the specified public subnet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. Internet-bound traffic from a private subnet can be routed to the NAT gateway, therefore enabling instances in the private subnet to connect to the internet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAcl":{ - "name":"CreateNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclRequest"}, - "output":{"shape":"CreateNetworkAclResult"}, - "documentation":"

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkAclEntry":{ - "name":"CreateNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkAclEntryRequest"}, - "documentation":"

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterface":{ - "name":"CreateNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfaceRequest"}, - "output":{"shape":"CreateNetworkInterfaceResult"}, - "documentation":"

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateNetworkInterfacePermission":{ - "name":"CreateNetworkInterfacePermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNetworkInterfacePermissionRequest"}, - "output":{"shape":"CreateNetworkInterfacePermissionResult"}, - "documentation":"

Grants an AWS-authorized account permission to attach the specified network interface to an instance in their account.

You can grant permission to a single AWS account only, and only one account at a time.

" - }, - "CreatePlacementGroup":{ - "name":"CreatePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlacementGroupRequest"}, - "documentation":"

Creates a placement group in which to launch instances. The strategy of the placement group determines how the instances are organized within the group.

A cluster placement group is a logical grouping of instances within a single Availability Zone that benefit from low network latency, high network throughput. A spread placement group places instances on distinct hardware.

For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateReservedInstancesListing":{ - "name":"CreateReservedInstancesListing", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReservedInstancesListingRequest"}, - "output":{"shape":"CreateReservedInstancesListingResult"}, - "documentation":"

Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.

Only Standard Reserved Instances with a capacity reservation can be sold in the Reserved Instance Marketplace. Convertible Reserved Instances and Standard Reserved Instances with a regional benefit cannot be sold.

The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateRoute":{ - "name":"CreateRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteRequest"}, - "output":{"shape":"CreateRouteResult"}, - "documentation":"

Creates a route in a route table within a VPC.

You must specify one of the following targets: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, or egress-only internet gateway.

When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3, and the route table includes the following two IPv4 routes:

  • 192.0.2.0/24 (goes to some target A)

  • 192.0.2.0/28 (goes to some target B)

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateRouteTable":{ - "name":"CreateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRouteTableRequest"}, - "output":{"shape":"CreateRouteTableResult"}, - "documentation":"

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateSecurityGroup":{ - "name":"CreateSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityGroupRequest"}, - "output":{"shape":"CreateSecurityGroupResult"}, - "documentation":"

Creates a security group.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

EC2-Classic: You can have up to 500 security groups.

EC2-VPC: You can create up to 500 security groups per VPC.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotRequest"}, - "output":{"shape":"Snapshot"}, - "documentation":"

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

You can tag your snapshots during creation. For more information, see Tagging Your Amazon EC2 Resources in the Amazon Elastic Compute Cloud User Guide.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateSpotDatafeedSubscription":{ - "name":"CreateSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"CreateSpotDatafeedSubscriptionResult"}, - "documentation":"

Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance Data Feed in the Amazon EC2 User Guide for Linux Instances.

" - }, - "CreateSubnet":{ - "name":"CreateSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubnetRequest"}, - "output":{"shape":"CreateSubnetResult"}, - "documentation":"

Creates a subnet in an existing VPC.

When you create each subnet, you provide the VPC ID and IPv4 CIDR block for the subnet. After you create a subnet, you can't change its CIDR block. The size of the subnet's IPv4 CIDR block can be the same as a VPC's IPv4 CIDR block, or a subset of a VPC's IPv4 CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR blocks must not overlap. The smallest IPv4 subnet (and VPC) you can create uses a /28 netmask (16 IPv4 addresses), and the largest uses a /16 netmask (65,536 IPv4 addresses).

If you've associated an IPv6 CIDR block with your VPC, you can create a subnet with an IPv6 CIDR block that uses a /64 prefix length.

AWS reserves both the first four and the last IPv4 address in each subnet's CIDR block. They're not available for use.

If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.

If you launch an instance in a VPC using an Amazon EBS-backed AMI, the IP address doesn't change if you stop and restart the instance (unlike a similar instance launched outside a VPC, which gets a new IP address when restarted). It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.

For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon EC2 resource or resources. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported Resource-Level Permissions for Amazon EC2 API Actions in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVolume":{ - "name":"CreateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVolumeRequest"}, - "output":{"shape":"Volume"}, - "documentation":"

Creates an EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

You can tag your volumes during creation. For more information, see Tagging Your Amazon EC2 Resources in the Amazon Elastic Compute Cloud User Guide.

For more information, see Creating an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpc":{ - "name":"CreateVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcRequest"}, - "output":{"shape":"CreateVpcResult"}, - "documentation":"

Creates a VPC with the specified IPv4 CIDR block. The smallest VPC you can create uses a /28 netmask (16 IPv4 addresses), and the largest uses a /16 netmask (65,536 IPv4 addresses). For more information about how large to make your VPC, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

You can optionally request an Amazon-provided IPv6 CIDR block for the VPC. The IPv6 CIDR block uses a /56 prefix length, and is allocated from Amazon's pool of IPv6 addresses. You cannot choose the IPv6 range for your VPC.

By default, each instance you launch in the VPC has the default DHCP options, which include only a default DNS server that we provide (AmazonProvidedDNS). For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

You can specify the instance tenancy value for the VPC when you create it. You can't change this value for the VPC after you create it. For more information, see Dedicated Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CreateVpcEndpoint":{ - "name":"CreateVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointRequest"}, - "output":{"shape":"CreateVpcEndpointResult"}, - "documentation":"

Creates a VPC endpoint for a specified service. An endpoint enables you to create a private connection between your VPC and the service. The service may be provided by AWS, an AWS Marketplace partner, or another AWS account. For more information, see VPC Endpoints in the Amazon Virtual Private Cloud User Guide.

A gateway endpoint serves as a target for a route in your route table for traffic destined for the AWS service. You can specify an endpoint policy to attach to the endpoint that will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.

An interface endpoint is a network interface in your subnet that serves as an endpoint for communicating with the specified service. You can specify the subnets in which to create an endpoint, and the security groups to associate with the endpoint network interface.

Use DescribeVpcEndpointServices to get a list of supported services.

" - }, - "CreateVpcEndpointConnectionNotification":{ - "name":"CreateVpcEndpointConnectionNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointConnectionNotificationRequest"}, - "output":{"shape":"CreateVpcEndpointConnectionNotificationResult"}, - "documentation":"

Creates a connection notification for a specified VPC endpoint or VPC endpoint service. A connection notification notifies you of specific endpoint events. You must create an SNS topic to receive notifications. For more information, see Create a Topic in the Amazon Simple Notification Service Developer Guide.

You can create a connection notification for interface endpoints only.

" - }, - "CreateVpcEndpointServiceConfiguration":{ - "name":"CreateVpcEndpointServiceConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcEndpointServiceConfigurationRequest"}, - "output":{"shape":"CreateVpcEndpointServiceConfigurationResult"}, - "documentation":"

Creates a VPC endpoint service configuration to which service consumers (AWS accounts, IAM users, and IAM roles) can connect. Service consumers can create an interface VPC endpoint to connect to your service.

To create an endpoint service configuration, you must first create a Network Load Balancer for your service. For more information, see VPC Endpoint Services in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionRequest"}, - "output":{"shape":"CreateVpcPeeringConnectionResult"}, - "documentation":"

Requests a VPC peering connection between two VPCs: a requester VPC that you own and an accepter VPC with which to create the connection. The accepter VPC can belong to another AWS account and can be in a different Region to the requester VPC. The requester VPC and accepter VPC cannot have overlapping CIDR blocks.

Limitations and rules apply to a VPC peering connection. For more information, see the limitations section in the VPC Peering Guide.

The owner of the accepter VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.

If you create a VPC peering connection request between VPCs with overlapping CIDR blocks, the VPC peering connection has a status of failed.

" - }, - "CreateVpnConnection":{ - "name":"CreateVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRequest"}, - "output":{"shape":"CreateVpnConnectionResult"}, - "documentation":"

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The only supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnConnectionRoute":{ - "name":"CreateVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnConnectionRouteRequest"}, - "documentation":"

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information about VPN connections, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "CreateVpnGateway":{ - "name":"CreateVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpnGatewayRequest"}, - "output":{"shape":"CreateVpnGatewayResult"}, - "documentation":"

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information about virtual private gateways, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "DeleteCustomerGateway":{ - "name":"DeleteCustomerGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomerGatewayRequest"}, - "documentation":"

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

" - }, - "DeleteDhcpOptions":{ - "name":"DeleteDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDhcpOptionsRequest"}, - "documentation":"

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

" - }, - "DeleteEgressOnlyInternetGateway":{ - "name":"DeleteEgressOnlyInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEgressOnlyInternetGatewayRequest"}, - "output":{"shape":"DeleteEgressOnlyInternetGatewayResult"}, - "documentation":"

Deletes an egress-only internet gateway.

" - }, - "DeleteFleets":{ - "name":"DeleteFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFleetsRequest"}, - "output":{"shape":"DeleteFleetsResult"}, - "documentation":"

Deletes the specified EC2 Fleet.

After you delete an EC2 Fleet, it launches no new instances. You must specify whether an EC2 Fleet should also terminate its instances. If you terminate the instances, the EC2 Fleet enters the deleted_terminating state. Otherwise, the EC2 Fleet enters the deleted_running state, and the instances continue to run until they are interrupted or you terminate them manually.

" - }, - "DeleteFlowLogs":{ - "name":"DeleteFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFlowLogsRequest"}, - "output":{"shape":"DeleteFlowLogsResult"}, - "documentation":"

Deletes one or more flow logs.

" - }, - "DeleteFpgaImage":{ - "name":"DeleteFpgaImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFpgaImageRequest"}, - "output":{"shape":"DeleteFpgaImageResult"}, - "documentation":"

Deletes the specified Amazon FPGA Image (AFI).

" - }, - "DeleteInternetGateway":{ - "name":"DeleteInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInternetGatewayRequest"}, - "documentation":"

Deletes the specified internet gateway. You must detach the internet gateway from the VPC before you can delete it.

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "documentation":"

Deletes the specified key pair, by removing the public key from Amazon EC2.

" - }, - "DeleteLaunchTemplate":{ - "name":"DeleteLaunchTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLaunchTemplateRequest"}, - "output":{"shape":"DeleteLaunchTemplateResult"}, - "documentation":"

Deletes a launch template. Deleting a launch template deletes all of its versions.

" - }, - "DeleteLaunchTemplateVersions":{ - "name":"DeleteLaunchTemplateVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLaunchTemplateVersionsRequest"}, - "output":{"shape":"DeleteLaunchTemplateVersionsResult"}, - "documentation":"

Deletes one or more versions of a launch template. You cannot delete the default version of a launch template; you must first assign a different version as the default. If the default version is the only version for the launch template, you must delete the entire launch template using DeleteLaunchTemplate.

" - }, - "DeleteNatGateway":{ - "name":"DeleteNatGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNatGatewayRequest"}, - "output":{"shape":"DeleteNatGatewayResult"}, - "documentation":"

Deletes the specified NAT gateway. Deleting a NAT gateway disassociates its Elastic IP address, but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway routes in your route tables.

" - }, - "DeleteNetworkAcl":{ - "name":"DeleteNetworkAcl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclRequest"}, - "documentation":"

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

" - }, - "DeleteNetworkAclEntry":{ - "name":"DeleteNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkAclEntryRequest"}, - "documentation":"

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

" - }, - "DeleteNetworkInterface":{ - "name":"DeleteNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfaceRequest"}, - "documentation":"

Deletes the specified network interface. You must detach the network interface before you can delete it.

" - }, - "DeleteNetworkInterfacePermission":{ - "name":"DeleteNetworkInterfacePermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNetworkInterfacePermissionRequest"}, - "output":{"shape":"DeleteNetworkInterfacePermissionResult"}, - "documentation":"

Deletes a permission for a network interface. By default, you cannot delete the permission if the account for which you're removing the permission has attached the network interface to an instance. However, you can force delete the permission, regardless of any attachment.

" - }, - "DeletePlacementGroup":{ - "name":"DeletePlacementGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlacementGroupRequest"}, - "documentation":"

Deletes the specified placement group. You must terminate all instances in the placement group before you can delete the placement group. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteRoute":{ - "name":"DeleteRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteRequest"}, - "documentation":"

Deletes the specified route from the specified route table.

" - }, - "DeleteRouteTable":{ - "name":"DeleteRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRouteTableRequest"}, - "documentation":"

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

" - }, - "DeleteSecurityGroup":{ - "name":"DeleteSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"

Deletes a security group.

If you attempt to delete a security group that is associated with an instance, or is referenced by another security group, the operation fails with InvalidGroup.InUse in EC2-Classic or DependencyViolation in EC2-VPC.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotRequest"}, - "documentation":"

Deletes the specified snapshot.

When you make periodic snapshots of a volume, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the volume.

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. You must first de-register the AMI before you can delete the snapshot.

For more information, see Deleting an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteSpotDatafeedSubscription":{ - "name":"DeleteSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSpotDatafeedSubscriptionRequest"}, - "documentation":"

Deletes the data feed for Spot Instances.

" - }, - "DeleteSubnet":{ - "name":"DeleteSubnet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubnetRequest"}, - "documentation":"

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "documentation":"

Deletes the specified set of tags from the specified set of resources.

To list the current tags, use DescribeTags. For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeRequest"}, - "documentation":"

Deletes the specified EBS volume. The volume must be in the available state (not attached to an instance).

The volume can remain in the deleting state for several minutes.

For more information, see Deleting an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DeleteVpc":{ - "name":"DeleteVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcRequest"}, - "documentation":"

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

" - }, - "DeleteVpcEndpointConnectionNotifications":{ - "name":"DeleteVpcEndpointConnectionNotifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointConnectionNotificationsRequest"}, - "output":{"shape":"DeleteVpcEndpointConnectionNotificationsResult"}, - "documentation":"

Deletes one or more VPC endpoint connection notifications.

" - }, - "DeleteVpcEndpointServiceConfigurations":{ - "name":"DeleteVpcEndpointServiceConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointServiceConfigurationsRequest"}, - "output":{"shape":"DeleteVpcEndpointServiceConfigurationsResult"}, - "documentation":"

Deletes one or more VPC endpoint service configurations in your account. Before you delete the endpoint service configuration, you must reject any Available or PendingAcceptance interface endpoint connections that are attached to the service.

" - }, - "DeleteVpcEndpoints":{ - "name":"DeleteVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcEndpointsRequest"}, - "output":{"shape":"DeleteVpcEndpointsResult"}, - "documentation":"

Deletes one or more specified VPC endpoints. Deleting a gateway endpoint also deletes the endpoint routes in the route tables that were associated with the endpoint. Deleting an interface endpoint deletes the endpoint network interfaces.

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionRequest"}, - "output":{"shape":"DeleteVpcPeeringConnectionResult"}, - "documentation":"

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner of the accepter VPC can delete the VPC peering connection if it's in the active state. The owner of the requester VPC can delete a VPC peering connection in the pending-acceptance state. You cannot delete a VPC peering connection that's in the failed state.

" - }, - "DeleteVpnConnection":{ - "name":"DeleteVpnConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRequest"}, - "documentation":"

Deletes the specified VPN connection.

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway using the new configuration information returned with the new VPN connection ID.

" - }, - "DeleteVpnConnectionRoute":{ - "name":"DeleteVpnConnectionRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnConnectionRouteRequest"}, - "documentation":"

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

" - }, - "DeleteVpnGateway":{ - "name":"DeleteVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpnGatewayRequest"}, - "documentation":"

Deletes the specified virtual private gateway. We recommend that before you delete a virtual private gateway, you detach it from the VPC and delete the VPN connection. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

" - }, - "DeregisterImage":{ - "name":"DeregisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterImageRequest"}, - "documentation":"

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances; however, it doesn't affect any instances that you've already launched from the AMI. You'll continue to incur usage costs for those instances until you terminate them.

When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was created for the root volume of the instance during the AMI creation process. When you deregister an instance store-backed AMI, it doesn't affect the files that you uploaded to Amazon S3 when you created the AMI.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResult"}, - "documentation":"

Describes attributes of your AWS account. The following are the supported account attributes:

  • supported-platforms: Indicates whether your account can launch instances into EC2-Classic and EC2-VPC, or only into EC2-VPC.

  • default-vpc: The ID of the default VPC for your account, or none.

  • max-instances: The maximum number of On-Demand Instances that you can run.

  • vpc-max-security-groups-per-interface: The maximum number of security groups that you can assign to a network interface.

  • max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-Classic.

  • vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can allocate for use with EC2-VPC.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "documentation":"

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeAggregateIdFormat":{ - "name":"DescribeAggregateIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAggregateIdFormatRequest"}, - "output":{"shape":"DescribeAggregateIdFormatResult"}, - "documentation":"

Describes the longer ID format settings for all resource types in a specific region. This request is useful for performing a quick audit to determine whether a specific region is fully opted in for longer IDs (17-character IDs).

This request only returns information about resource types that support longer IDs.

The following resource types support longer IDs: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

" - }, - "DescribeAvailabilityZones":{ - "name":"DescribeAvailabilityZones", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailabilityZonesRequest"}, - "output":{"shape":"DescribeAvailabilityZonesResult"}, - "documentation":"

Describes one or more of the Availability Zones that are available to you. The results include zones only for the region you're currently using. If there is an event impacting an Availability Zone, you can use this request to view the state and any provided message for that Availability Zone.

For more information, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeBundleTasks":{ - "name":"DescribeBundleTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBundleTasksRequest"}, - "output":{"shape":"DescribeBundleTasksResult"}, - "documentation":"

Describes one or more of your bundling tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

" - }, - "DescribeClassicLinkInstances":{ - "name":"DescribeClassicLinkInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClassicLinkInstancesRequest"}, - "output":{"shape":"DescribeClassicLinkInstancesResult"}, - "documentation":"

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink. You cannot use this request to return information about other instances.

" - }, - "DescribeConversionTasks":{ - "name":"DescribeConversionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConversionTasksRequest"}, - "output":{"shape":"DescribeConversionTasksResult"}, - "documentation":"

Describes one or more of your conversion tasks. For more information, see the VM Import/Export User Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "DescribeCustomerGateways":{ - "name":"DescribeCustomerGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCustomerGatewaysRequest"}, - "output":{"shape":"DescribeCustomerGatewaysResult"}, - "documentation":"

Describes one or more of your VPN customer gateways.

For more information about VPN customer gateways, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeDhcpOptions":{ - "name":"DescribeDhcpOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDhcpOptionsRequest"}, - "output":{"shape":"DescribeDhcpOptionsResult"}, - "documentation":"

Describes one or more of your DHCP options sets.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeEgressOnlyInternetGateways":{ - "name":"DescribeEgressOnlyInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEgressOnlyInternetGatewaysRequest"}, - "output":{"shape":"DescribeEgressOnlyInternetGatewaysResult"}, - "documentation":"

Describes one or more of your egress-only internet gateways.

" - }, - "DescribeElasticGpus":{ - "name":"DescribeElasticGpus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeElasticGpusRequest"}, - "output":{"shape":"DescribeElasticGpusResult"}, - "documentation":"

Describes the Elastic GPUs associated with your instances. For more information about Elastic GPUs, see Amazon EC2 Elastic GPUs.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResult"}, - "documentation":"

Describes one or more of your export tasks.

" - }, - "DescribeFleetHistory":{ - "name":"DescribeFleetHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetHistoryRequest"}, - "output":{"shape":"DescribeFleetHistoryResult"}, - "documentation":"

Describes the events for the specified EC2 Fleet during the specified time.

" - }, - "DescribeFleetInstances":{ - "name":"DescribeFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetInstancesRequest"}, - "output":{"shape":"DescribeFleetInstancesResult"}, - "documentation":"

Describes the running instances for the specified EC2 Fleet.

" - }, - "DescribeFleets":{ - "name":"DescribeFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetsRequest"}, - "output":{"shape":"DescribeFleetsResult"}, - "documentation":"

Describes one or more of your EC2 Fleet.

" - }, - "DescribeFlowLogs":{ - "name":"DescribeFlowLogs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFlowLogsRequest"}, - "output":{"shape":"DescribeFlowLogsResult"}, - "documentation":"

Describes one or more flow logs. To view the information in your flow logs (the log streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs API.

" - }, - "DescribeFpgaImageAttribute":{ - "name":"DescribeFpgaImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFpgaImageAttributeRequest"}, - "output":{"shape":"DescribeFpgaImageAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified Amazon FPGA Image (AFI).

" - }, - "DescribeFpgaImages":{ - "name":"DescribeFpgaImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFpgaImagesRequest"}, - "output":{"shape":"DescribeFpgaImagesResult"}, - "documentation":"

Describes one or more available Amazon FPGA Images (AFIs). These include public AFIs, private AFIs that you own, and AFIs owned by other AWS accounts for which you have load permissions.

" - }, - "DescribeHostReservationOfferings":{ - "name":"DescribeHostReservationOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationOfferingsRequest"}, - "output":{"shape":"DescribeHostReservationOfferingsResult"}, - "documentation":"

Describes the Dedicated Host reservations that are available to purchase.

The results describe all the Dedicated Host reservation offerings, including offerings that may not match the instance family and region of your Dedicated Hosts. When purchasing an offering, ensure that the instance family and Region of the offering matches that of the Dedicated Hosts with which it is to be associated . For more information about supported instance types, see Dedicated Hosts Overview in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeHostReservations":{ - "name":"DescribeHostReservations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostReservationsRequest"}, - "output":{"shape":"DescribeHostReservationsResult"}, - "documentation":"

Describes reservations that are associated with Dedicated Hosts in your account.

" - }, - "DescribeHosts":{ - "name":"DescribeHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHostsRequest"}, - "output":{"shape":"DescribeHostsResult"}, - "documentation":"

Describes one or more of your Dedicated Hosts.

The results describe only the Dedicated Hosts in the region you're currently using. All listed instances consume capacity on your Dedicated Host. Dedicated Hosts that have recently been released are listed with the state released.

" - }, - "DescribeIamInstanceProfileAssociations":{ - "name":"DescribeIamInstanceProfileAssociations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIamInstanceProfileAssociationsRequest"}, - "output":{"shape":"DescribeIamInstanceProfileAssociationsResult"}, - "documentation":"

Describes your IAM instance profile associations.

" - }, - "DescribeIdFormat":{ - "name":"DescribeIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdFormatRequest"}, - "output":{"shape":"DescribeIdFormatResult"}, - "documentation":"

Describes the ID format settings for your resources on a per-region basis, for example, to view which resource types are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types.

The following resource types support longer IDs: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

These settings apply to the IAM user who makes the request; they do not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user, unless they explicitly override the settings by running the ModifyIdFormat command. Resources created with longer IDs are visible to all IAM users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "DescribeIdentityIdFormat":{ - "name":"DescribeIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIdentityIdFormatRequest"}, - "output":{"shape":"DescribeIdentityIdFormatResult"}, - "documentation":"

Describes the ID format settings for resources for the specified IAM user, IAM role, or root user. For example, you can view the resource types that are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

The following resource types support longer IDs: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

These settings apply to the principal specified in the request. They do not apply to the principal that makes the request.

" - }, - "DescribeImageAttribute":{ - "name":"DescribeImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImageAttributeRequest"}, - "output":{"shape":"ImageAttribute"}, - "documentation":"

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResult"}, - "documentation":"

Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.

Deregistered images are included in the returned results for an unspecified interval after deregistration.

" - }, - "DescribeImportImageTasks":{ - "name":"DescribeImportImageTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportImageTasksRequest"}, - "output":{"shape":"DescribeImportImageTasksResult"}, - "documentation":"

Displays details about an import virtual machine or import snapshot tasks that are already created.

" - }, - "DescribeImportSnapshotTasks":{ - "name":"DescribeImportSnapshotTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImportSnapshotTasksRequest"}, - "output":{"shape":"DescribeImportSnapshotTasksResult"}, - "documentation":"

Describes your import snapshot tasks.

" - }, - "DescribeInstanceAttribute":{ - "name":"DescribeInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAttributeRequest"}, - "output":{"shape":"InstanceAttribute"}, - "documentation":"

Describes the specified attribute of the specified instance. You can specify only one attribute at a time. Valid attribute values are: instanceType | kernel | ramdisk | userData | disableApiTermination | instanceInitiatedShutdownBehavior | rootDeviceName | blockDeviceMapping | productCodes | sourceDestCheck | groupSet | ebsOptimized | sriovNetSupport

" - }, - "DescribeInstanceCreditSpecifications":{ - "name":"DescribeInstanceCreditSpecifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceCreditSpecificationsRequest"}, - "output":{"shape":"DescribeInstanceCreditSpecificationsResult"}, - "documentation":"

Describes the credit option for CPU usage of one or more of your T2 instances. The credit options are standard and unlimited.

If you do not specify an instance ID, Amazon EC2 returns only the T2 instances with the unlimited credit option. If you specify one or more instance IDs, Amazon EC2 returns the credit option (standard or unlimited) of those instances. If you specify an instance ID that is not valid, such as an instance that is not a T2 instance, an error is returned.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If an Availability Zone is experiencing a service disruption and you specify instance IDs in the affected zone, or do not specify any instance IDs at all, the call fails. If you specify only instance IDs in an unaffected zone, the call works normally.

For more information, see T2 Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstanceStatus":{ - "name":"DescribeInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceStatusRequest"}, - "output":{"shape":"DescribeInstanceStatusResult"}, - "documentation":"

Describes the status of one or more instances. By default, only running instances are described, unless you specifically indicate to return the status of all instances.

Instance status includes the following components:

  • Status checks - Amazon EC2 performs status checks on running EC2 instances to identify hardware and software issues. For more information, see Status Checks for Your Instances and Troubleshooting Instances with Failed Status Checks in the Amazon Elastic Compute Cloud User Guide.

  • Scheduled events - Amazon EC2 can schedule events (such as reboot, stop, or terminate) for your instances related to hardware issues, software updates, or system maintenance. For more information, see Scheduled Events for Your Instances in the Amazon Elastic Compute Cloud User Guide.

  • Instance state - You can manage your instances from the moment you launch them through their termination. For more information, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "documentation":"

Describes one or more of your instances.

If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If you describe instances in the rare case where an Availability Zone is experiencing a service disruption and you specify instance IDs that are in the affected zone, or do not specify any instance IDs at all, the call fails. If you describe instances and specify only instance IDs that are in an unaffected zone, the call works normally.

" - }, - "DescribeInternetGateways":{ - "name":"DescribeInternetGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInternetGatewaysRequest"}, - "output":{"shape":"DescribeInternetGatewaysResult"}, - "documentation":"

Describes one or more of your internet gateways.

" - }, - "DescribeKeyPairs":{ - "name":"DescribeKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyPairsRequest"}, - "output":{"shape":"DescribeKeyPairsResult"}, - "documentation":"

Describes one or more of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeLaunchTemplateVersions":{ - "name":"DescribeLaunchTemplateVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLaunchTemplateVersionsRequest"}, - "output":{"shape":"DescribeLaunchTemplateVersionsResult"}, - "documentation":"

Describes one or more versions of a specified launch template. You can describe all versions, individual versions, or a range of versions.

" - }, - "DescribeLaunchTemplates":{ - "name":"DescribeLaunchTemplates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLaunchTemplatesRequest"}, - "output":{"shape":"DescribeLaunchTemplatesResult"}, - "documentation":"

Describes one or more launch templates.

" - }, - "DescribeMovingAddresses":{ - "name":"DescribeMovingAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMovingAddressesRequest"}, - "output":{"shape":"DescribeMovingAddressesResult"}, - "documentation":"

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

" - }, - "DescribeNatGateways":{ - "name":"DescribeNatGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNatGatewaysRequest"}, - "output":{"shape":"DescribeNatGatewaysResult"}, - "documentation":"

Describes one or more of your NAT gateways.

" - }, - "DescribeNetworkAcls":{ - "name":"DescribeNetworkAcls", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkAclsRequest"}, - "output":{"shape":"DescribeNetworkAclsResult"}, - "documentation":"

Describes one or more of your network ACLs.

For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeNetworkInterfaceAttribute":{ - "name":"DescribeNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfaceAttributeRequest"}, - "output":{"shape":"DescribeNetworkInterfaceAttributeResult"}, - "documentation":"

Describes a network interface attribute. You can specify only one attribute at a time.

" - }, - "DescribeNetworkInterfacePermissions":{ - "name":"DescribeNetworkInterfacePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacePermissionsRequest"}, - "output":{"shape":"DescribeNetworkInterfacePermissionsResult"}, - "documentation":"

Describes the permissions for your network interfaces.

" - }, - "DescribeNetworkInterfaces":{ - "name":"DescribeNetworkInterfaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNetworkInterfacesRequest"}, - "output":{"shape":"DescribeNetworkInterfacesResult"}, - "documentation":"

Describes one or more of your network interfaces.

" - }, - "DescribePlacementGroups":{ - "name":"DescribePlacementGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlacementGroupsRequest"}, - "output":{"shape":"DescribePlacementGroupsResult"}, - "documentation":"

Describes one or more of your placement groups. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribePrefixLists":{ - "name":"DescribePrefixLists", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrefixListsRequest"}, - "output":{"shape":"DescribePrefixListsResult"}, - "documentation":"

Describes available AWS services in a prefix list format, which includes the prefix list name and prefix list ID of the service and the IP address range for the service. A prefix list ID is required for creating an outbound security group rule that allows traffic from a VPC to access an AWS service through a gateway VPC endpoint. Currently, the services that support this action are Amazon S3 and Amazon DynamoDB.

" - }, - "DescribePrincipalIdFormat":{ - "name":"DescribePrincipalIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePrincipalIdFormatRequest"}, - "output":{"shape":"DescribePrincipalIdFormatResult"}, - "documentation":"

Describes the ID format settings for the root user and all IAM roles and IAM users that have explicitly specified a longer ID (17-character ID) preference.

By default, all IAM roles and IAM users default to the same ID settings as the root user, unless they explicitly override the settings. This request is useful for identifying those IAM users and IAM roles that have overridden the default ID settings.

The following resource types support longer IDs: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

" - }, - "DescribeRegions":{ - "name":"DescribeRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRegionsRequest"}, - "output":{"shape":"DescribeRegionsResult"}, - "documentation":"

Describes one or more regions that are currently available to you.

For a list of the regions supported by Amazon EC2, see Regions and Endpoints.

" - }, - "DescribeReservedInstances":{ - "name":"DescribeReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesRequest"}, - "output":{"shape":"DescribeReservedInstancesResult"}, - "documentation":"

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesListings":{ - "name":"DescribeReservedInstancesListings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesListingsRequest"}, - "output":{"shape":"DescribeReservedInstancesListingsResult"}, - "documentation":"

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesModifications":{ - "name":"DescribeReservedInstancesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesModificationsRequest"}, - "output":{"shape":"DescribeReservedInstancesModificationsResult"}, - "documentation":"

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeReservedInstancesOfferings":{ - "name":"DescribeReservedInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedInstancesOfferingsRequest"}, - "output":{"shape":"DescribeReservedInstancesOfferingsResult"}, - "documentation":"

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

If you have listed your own Reserved Instances for sale in the Reserved Instance Marketplace, they will be excluded from these results. This is to ensure that you do not purchase your own Reserved Instances.

For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeRouteTables":{ - "name":"DescribeRouteTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRouteTablesRequest"}, - "output":{"shape":"DescribeRouteTablesResult"}, - "documentation":"

Describes one or more of your route tables.

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeScheduledInstanceAvailability":{ - "name":"DescribeScheduledInstanceAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstanceAvailabilityRequest"}, - "output":{"shape":"DescribeScheduledInstanceAvailabilityResult"}, - "documentation":"

Finds available schedules that meet the specified criteria.

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

After you find a schedule that meets your needs, call PurchaseScheduledInstances to purchase Scheduled Instances with that schedule.

" - }, - "DescribeScheduledInstances":{ - "name":"DescribeScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScheduledInstancesRequest"}, - "output":{"shape":"DescribeScheduledInstancesResult"}, - "documentation":"

Describes one or more of your Scheduled Instances.

" - }, - "DescribeSecurityGroupReferences":{ - "name":"DescribeSecurityGroupReferences", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupReferencesRequest"}, - "output":{"shape":"DescribeSecurityGroupReferencesResult"}, - "documentation":"

[EC2-VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

" - }, - "DescribeSecurityGroups":{ - "name":"DescribeSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityGroupsRequest"}, - "output":{"shape":"DescribeSecurityGroupsResult"}, - "documentation":"

Describes one or more of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeSnapshotAttribute":{ - "name":"DescribeSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotAttributeRequest"}, - "output":{"shape":"DescribeSnapshotAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsRequest"}, - "output":{"shape":"DescribeSnapshotsResult"}, - "documentation":"

Describes one or more of the EBS snapshots available to you. Available snapshots include public snapshots available for any AWS account to launch, private snapshots that you own, and private snapshots owned by another AWS account but for which you've been given explicit create volume permissions.

The create volume permissions fall into the following categories:

  • public: The owner of the snapshot granted create volume permissions for the snapshot to the all group. All AWS accounts have create volume permissions for these snapshots.

  • explicit: The owner of the snapshot granted create volume permissions to a specific AWS account.

  • implicit: An AWS account has implicit create volume permissions for all snapshots it owns.

The list of snapshots returned can be modified by specifying snapshot IDs, snapshot owners, or AWS accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners using the OwnerIds option, only snapshots from the specified owners and for which you have access are returned. The results can include the AWS account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify AWS account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeSpotDatafeedSubscription":{ - "name":"DescribeSpotDatafeedSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotDatafeedSubscriptionRequest"}, - "output":{"shape":"DescribeSpotDatafeedSubscriptionResult"}, - "documentation":"

Describes the data feed for Spot Instances. For more information, see Spot Instance Data Feed in the Amazon EC2 User Guide for Linux Instances.

" - }, - "DescribeSpotFleetInstances":{ - "name":"DescribeSpotFleetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetInstancesRequest"}, - "output":{"shape":"DescribeSpotFleetInstancesResponse"}, - "documentation":"

Describes the running instances for the specified Spot Fleet.

" - }, - "DescribeSpotFleetRequestHistory":{ - "name":"DescribeSpotFleetRequestHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestHistoryRequest"}, - "output":{"shape":"DescribeSpotFleetRequestHistoryResponse"}, - "documentation":"

Describes the events for the specified Spot Fleet request during the specified time.

Spot Fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event.

" - }, - "DescribeSpotFleetRequests":{ - "name":"DescribeSpotFleetRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotFleetRequestsRequest"}, - "output":{"shape":"DescribeSpotFleetRequestsResponse"}, - "documentation":"

Describes your Spot Fleet requests.

Spot Fleet requests are deleted 48 hours after they are canceled and their instances are terminated.

" - }, - "DescribeSpotInstanceRequests":{ - "name":"DescribeSpotInstanceRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotInstanceRequestsRequest"}, - "output":{"shape":"DescribeSpotInstanceRequestsResult"}, - "documentation":"

Describes the specified Spot Instance requests.

You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

Spot Instance requests are deleted four hours after they are canceled and their instances are terminated.

" - }, - "DescribeSpotPriceHistory":{ - "name":"DescribeSpotPriceHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSpotPriceHistoryRequest"}, - "output":{"shape":"DescribeSpotPriceHistoryResult"}, - "documentation":"

Describes the Spot price history. For more information, see Spot Instance Pricing History in the Amazon EC2 User Guide for Linux Instances.

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

" - }, - "DescribeStaleSecurityGroups":{ - "name":"DescribeStaleSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStaleSecurityGroupsRequest"}, - "output":{"shape":"DescribeStaleSecurityGroupsResult"}, - "documentation":"

[EC2-VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.

" - }, - "DescribeSubnets":{ - "name":"DescribeSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubnetsRequest"}, - "output":{"shape":"DescribeSubnetsResult"}, - "documentation":"

Describes one or more of your subnets.

For more information, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "documentation":"

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeAttribute":{ - "name":"DescribeVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeAttributeRequest"}, - "output":{"shape":"DescribeVolumeAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified volume. You can specify only one attribute at a time.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumeStatus":{ - "name":"DescribeVolumeStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumeStatusRequest"}, - "output":{"shape":"DescribeVolumeStatusResult"}, - "documentation":"

Describes the status of the specified volumes. Volume status provides the result of the checks performed on your volumes to determine events that can impair the performance of your volumes. The performance of a volume can be affected if an issue occurs on the volume's underlying host. If the volume's underlying host experiences a power outage or system issue, after the system is restored, there could be data inconsistencies on the volume. Volume events notify you if this occurs. Volume actions notify you if any action needs to be taken in response to the event.

The DescribeVolumeStatus operation provides the following information about the specified volumes:

Status: Reflects the current status of the volume. The possible values are ok, impaired , warning, or insufficient-data. If all checks pass, the overall status of the volume is ok. If the check fails, the overall status is impaired. If the status is insufficient-data, then the checks may still be taking place on your volume at the time. We recommend that you retry the request. For more information about volume status, see Monitoring the Status of Your Volumes in the Amazon Elastic Compute Cloud User Guide.

Events: Reflect the cause of a volume status and may require you to take action. For example, if your volume returns an impaired status, then the volume event might be potential-data-inconsistency. This means that your volume has been affected by an issue with the underlying host, has all I/O operations disabled, and may have inconsistent data.

Actions: Reflect the actions you may have to take in response to an event. For example, if the status of the volume is impaired and the volume event shows potential-data-inconsistency, then the action shows enable-volume-io. This means that you may want to enable the I/O operations for the volume by calling the EnableVolumeIO action and then check the volume for data consistency.

Volume status is based on the volume status checks, and does not reflect the volume state. Therefore, volume status does not indicate volumes in the error state (for example, when a volume is incapable of accepting I/O.)

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "documentation":"

Describes the specified EBS volumes.

If you are describing a long list of volumes, you can paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeVolumes request to retrieve the remaining results.

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVolumesModifications":{ - "name":"DescribeVolumesModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesModificationsRequest"}, - "output":{"shape":"DescribeVolumesModificationsResult"}, - "documentation":"

Reports the current modification status of EBS volumes.

Current-generation EBS volumes support modification of attributes including type, size, and (for io1 volumes) IOPS provisioning while either attached to or detached from an instance. Following an action from the API or the console to modify a volume, the status of the modification may be modifying, optimizing, completed, or failed. If a volume has never been modified, then certain elements of the returned VolumeModification objects are null.

You can also use CloudWatch Events to check the status of a modification to an EBS volume. For information about CloudWatch Events, see the Amazon CloudWatch Events User Guide. For more information, see Monitoring Volume Modifications\" in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcAttribute":{ - "name":"DescribeVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcAttributeRequest"}, - "output":{"shape":"DescribeVpcAttributeResult"}, - "documentation":"

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

" - }, - "DescribeVpcClassicLink":{ - "name":"DescribeVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkRequest"}, - "output":{"shape":"DescribeVpcClassicLinkResult"}, - "documentation":"

Describes the ClassicLink status of one or more VPCs.

" - }, - "DescribeVpcClassicLinkDnsSupport":{ - "name":"DescribeVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DescribeVpcClassicLinkDnsSupportResult"}, - "documentation":"

Describes the ClassicLink DNS support status of one or more VPCs. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DescribeVpcEndpointConnectionNotifications":{ - "name":"DescribeVpcEndpointConnectionNotifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointConnectionNotificationsRequest"}, - "output":{"shape":"DescribeVpcEndpointConnectionNotificationsResult"}, - "documentation":"

Describes the connection notifications for VPC endpoints and VPC endpoint services.

" - }, - "DescribeVpcEndpointConnections":{ - "name":"DescribeVpcEndpointConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointConnectionsRequest"}, - "output":{"shape":"DescribeVpcEndpointConnectionsResult"}, - "documentation":"

Describes the VPC endpoint connections to your VPC endpoint services, including any endpoints that are pending your acceptance.

" - }, - "DescribeVpcEndpointServiceConfigurations":{ - "name":"DescribeVpcEndpointServiceConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServiceConfigurationsRequest"}, - "output":{"shape":"DescribeVpcEndpointServiceConfigurationsResult"}, - "documentation":"

Describes the VPC endpoint service configurations in your account (your services).

" - }, - "DescribeVpcEndpointServicePermissions":{ - "name":"DescribeVpcEndpointServicePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicePermissionsRequest"}, - "output":{"shape":"DescribeVpcEndpointServicePermissionsResult"}, - "documentation":"

Describes the principals (service consumers) that are permitted to discover your VPC endpoint service.

" - }, - "DescribeVpcEndpointServices":{ - "name":"DescribeVpcEndpointServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointServicesRequest"}, - "output":{"shape":"DescribeVpcEndpointServicesResult"}, - "documentation":"

Describes available services to which you can create a VPC endpoint.

" - }, - "DescribeVpcEndpoints":{ - "name":"DescribeVpcEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcEndpointsRequest"}, - "output":{"shape":"DescribeVpcEndpointsResult"}, - "documentation":"

Describes one or more of your VPC endpoints.

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsRequest"}, - "output":{"shape":"DescribeVpcPeeringConnectionsResult"}, - "documentation":"

Describes one or more of your VPC peering connections.

" - }, - "DescribeVpcs":{ - "name":"DescribeVpcs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcsRequest"}, - "output":{"shape":"DescribeVpcsResult"}, - "documentation":"

Describes one or more of your VPCs.

" - }, - "DescribeVpnConnections":{ - "name":"DescribeVpnConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnConnectionsRequest"}, - "output":{"shape":"DescribeVpnConnectionsResult"}, - "documentation":"

Describes one or more of your VPN connections.

For more information about VPN connections, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "DescribeVpnGateways":{ - "name":"DescribeVpnGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpnGatewaysRequest"}, - "output":{"shape":"DescribeVpnGatewaysResult"}, - "documentation":"

Describes one or more of your virtual private gateways.

For more information about virtual private gateways, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide.

" - }, - "DetachClassicLinkVpc":{ - "name":"DetachClassicLinkVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachClassicLinkVpcRequest"}, - "output":{"shape":"DetachClassicLinkVpcResult"}, - "documentation":"

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

" - }, - "DetachInternetGateway":{ - "name":"DetachInternetGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInternetGatewayRequest"}, - "documentation":"

Detaches an internet gateway from a VPC, disabling connectivity between the internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses or public IPv4 addresses.

" - }, - "DetachNetworkInterface":{ - "name":"DetachNetworkInterface", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachNetworkInterfaceRequest"}, - "documentation":"

Detaches a network interface from an instance.

" - }, - "DetachVolume":{ - "name":"DetachVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVolumeRequest"}, - "output":{"shape":"VolumeAttachment"}, - "documentation":"

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DetachVpnGateway":{ - "name":"DetachVpnGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachVpnGatewayRequest"}, - "documentation":"

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

You must wait for the attachment's state to switch to detached before you can delete the VPC or attach a different VPC to the virtual private gateway.

" - }, - "DisableVgwRoutePropagation":{ - "name":"DisableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVgwRoutePropagationRequest"}, - "documentation":"

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

" - }, - "DisableVpcClassicLink":{ - "name":"DisableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkRequest"}, - "output":{"shape":"DisableVpcClassicLinkResult"}, - "documentation":"

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

" - }, - "DisableVpcClassicLinkDnsSupport":{ - "name":"DisableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"DisableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Disables ClassicLink DNS support for a VPC. If disabled, DNS hostnames resolve to public IP addresses when addressed between a linked EC2-Classic instance and instances in the VPC to which it's linked. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DisassociateAddress":{ - "name":"DisassociateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAddressRequest"}, - "documentation":"

Disassociates an Elastic IP address from the instance or network interface it's associated with.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

" - }, - "DisassociateIamInstanceProfile":{ - "name":"DisassociateIamInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateIamInstanceProfileRequest"}, - "output":{"shape":"DisassociateIamInstanceProfileResult"}, - "documentation":"

Disassociates an IAM instance profile from a running or stopped instance.

Use DescribeIamInstanceProfileAssociations to get the association ID.

" - }, - "DisassociateRouteTable":{ - "name":"DisassociateRouteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateRouteTableRequest"}, - "documentation":"

Disassociates a subnet from a route table.

After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "DisassociateSubnetCidrBlock":{ - "name":"DisassociateSubnetCidrBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateSubnetCidrBlockRequest"}, - "output":{"shape":"DisassociateSubnetCidrBlockResult"}, - "documentation":"

Disassociates a CIDR block from a subnet. Currently, you can disassociate an IPv6 CIDR block only. You must detach or delete all gateways and resources that are associated with the CIDR block before you can disassociate it.

" - }, - "DisassociateVpcCidrBlock":{ - "name":"DisassociateVpcCidrBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateVpcCidrBlockRequest"}, - "output":{"shape":"DisassociateVpcCidrBlockResult"}, - "documentation":"

Disassociates a CIDR block from a VPC. To disassociate the CIDR block, you must specify its association ID. You can get the association ID by using DescribeVpcs. You must detach or delete all gateways and resources that are associated with the CIDR block before you can disassociate it.

You cannot disassociate the CIDR block with which you originally created the VPC (the primary CIDR block).

" - }, - "EnableVgwRoutePropagation":{ - "name":"EnableVgwRoutePropagation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVgwRoutePropagationRequest"}, - "documentation":"

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

" - }, - "EnableVolumeIO":{ - "name":"EnableVolumeIO", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVolumeIORequest"}, - "documentation":"

Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent.

" - }, - "EnableVpcClassicLink":{ - "name":"EnableVpcClassicLink", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkRequest"}, - "output":{"shape":"EnableVpcClassicLinkResult"}, - "documentation":"

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot enable your VPC for ClassicLink if any of your VPC route tables have existing routes for address ranges within the 10.0.0.0/8 IP address range, excluding local routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address ranges. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "EnableVpcClassicLinkDnsSupport":{ - "name":"EnableVpcClassicLinkDnsSupport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableVpcClassicLinkDnsSupportRequest"}, - "output":{"shape":"EnableVpcClassicLinkDnsSupportResult"}, - "documentation":"

Enables a VPC to support DNS hostname resolution for ClassicLink. If enabled, the DNS hostname of a linked EC2-Classic instance resolves to its private IP address when addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname of an instance in a VPC resolves to its private IP address when addressed from a linked EC2-Classic instance. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleOutput":{ - "name":"GetConsoleOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleOutputRequest"}, - "output":{"shape":"GetConsoleOutputResult"}, - "documentation":"

Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes the last three system event log errors.

By default, the console output returns buffered information that was posted shortly after an instance transition state (start, stop, reboot, or terminate). This information is available for at least one hour after the most recent post. Only the most recent 64 KB of console output is available.

You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is supported on instance types that use the Nitro hypervisor.

For more information, see Instance Console Output in the Amazon Elastic Compute Cloud User Guide.

" - }, - "GetConsoleScreenshot":{ - "name":"GetConsoleScreenshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConsoleScreenshotRequest"}, - "output":{"shape":"GetConsoleScreenshotResult"}, - "documentation":"

Retrieve a JPG-format screenshot of a running instance to help with troubleshooting.

The returned content is Base64-encoded.

" - }, - "GetHostReservationPurchasePreview":{ - "name":"GetHostReservationPurchasePreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetHostReservationPurchasePreviewRequest"}, - "output":{"shape":"GetHostReservationPurchasePreviewResult"}, - "documentation":"

Preview a reservation purchase with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation.

This is a preview of the PurchaseHostReservation action and does not result in the offering being purchased.

" - }, - "GetLaunchTemplateData":{ - "name":"GetLaunchTemplateData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLaunchTemplateDataRequest"}, - "output":{"shape":"GetLaunchTemplateDataResult"}, - "documentation":"

Retrieves the configuration data of the specified instance. You can use this data to create a launch template.

" - }, - "GetPasswordData":{ - "name":"GetPasswordData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPasswordDataRequest"}, - "output":{"shape":"GetPasswordDataResult"}, - "documentation":"

Retrieves the encrypted administrator password for a running Windows instance.

The Windows password is generated at boot by the EC2Config service or EC2Launch scripts (Windows Server 2016 and later). This usually only happens the first time an instance is launched. For more information, see EC2Config and EC2Launch in the Amazon Elastic Compute Cloud User Guide.

For the EC2Config service, the password is not generated for rebundled AMIs unless Ec2SetPassword is enabled before bundling.

The password is encrypted using the key pair that you specified when you launched the instance. You must provide the corresponding key pair file.

When you launch an instance, password generation and encryption may take a few minutes. If you try to retrieve the password before it's available, the output returns an empty string. We recommend that you wait up to 15 minutes after launching an instance before trying to retrieve the generated password.

" - }, - "GetReservedInstancesExchangeQuote":{ - "name":"GetReservedInstancesExchangeQuote", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservedInstancesExchangeQuoteRequest"}, - "output":{"shape":"GetReservedInstancesExchangeQuoteResult"}, - "documentation":"

Returns a quote and exchange information for exchanging one or more specified Convertible Reserved Instances for a new Convertible Reserved Instance. If the exchange cannot be performed, the reason is returned in the response. Use AcceptReservedInstancesExchangeQuote to perform the exchange.

" - }, - "ImportImage":{ - "name":"ImportImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportImageRequest"}, - "output":{"shape":"ImportImageResult"}, - "documentation":"

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI). For more information, see Importing a VM as an Image Using VM Import/Export in the VM Import/Export User Guide.

" - }, - "ImportInstance":{ - "name":"ImportInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportInstanceRequest"}, - "output":{"shape":"ImportInstanceResult"}, - "documentation":"

Creates an import instance task using metadata from the specified disk image. ImportInstance only supports single-volume VMs. To import multi-volume VMs, use ImportImage. For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "documentation":"

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ImportSnapshot":{ - "name":"ImportSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportSnapshotRequest"}, - "output":{"shape":"ImportSnapshotResult"}, - "documentation":"

Imports a disk into an EBS snapshot.

" - }, - "ImportVolume":{ - "name":"ImportVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportVolumeRequest"}, - "output":{"shape":"ImportVolumeResult"}, - "documentation":"

Creates an import volume task using metadata from the specified disk image.For more information, see Importing Disks to Amazon EBS.

For information about the import manifest referenced by this API action, see VM Import Manifest.

" - }, - "ModifyFleet":{ - "name":"ModifyFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyFleetRequest"}, - "output":{"shape":"ModifyFleetResult"}, - "documentation":"

Modifies the specified EC2 Fleet.

While the EC2 Fleet is being modified, it is in the modifying state.

" - }, - "ModifyFpgaImageAttribute":{ - "name":"ModifyFpgaImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyFpgaImageAttributeRequest"}, - "output":{"shape":"ModifyFpgaImageAttributeResult"}, - "documentation":"

Modifies the specified attribute of the specified Amazon FPGA Image (AFI).

" - }, - "ModifyHosts":{ - "name":"ModifyHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyHostsRequest"}, - "output":{"shape":"ModifyHostsResult"}, - "documentation":"

Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, any instances that you launch with a tenancy of host but without a specific host ID are placed onto any available Dedicated Host in your account that has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID ito have the instance launch onto a specific host. If no host ID is provided, the instance is launched onto a suitable host with auto-placement enabled.

" - }, - "ModifyIdFormat":{ - "name":"ModifyIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdFormatRequest"}, - "documentation":"

Modifies the ID format for the specified resource on a per-region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created.

This request can only be used to modify longer ID settings for resource types that are within the opt-in period. Resources currently in their opt-in period include: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

This setting applies to the IAM user who makes the request; it does not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyIdentityIdFormat":{ - "name":"ModifyIdentityIdFormat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyIdentityIdFormatRequest"}, - "documentation":"

Modifies the ID format of a resource for a specified IAM user, IAM role, or the root user for an account; or all IAM users, IAM roles, and the root user for an account. You can specify that resources should receive longer IDs (17-character IDs) when they are created.

This request can only be used to modify longer ID settings for resource types that are within the opt-in period. Resources currently in their opt-in period include: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

This setting applies to the principal specified in the request; it does not apply to the principal that makes the request.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

" - }, - "ModifyImageAttribute":{ - "name":"ModifyImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyImageAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time. You can use the Attribute parameter to specify the attribute or one of the following parameters: Description, LaunchPermission, or ProductCode.

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

To enable the SriovNetSupport enhanced networking attribute of an image, enable SriovNetSupport on an instance and create an AMI from the instance.

" - }, - "ModifyInstanceAttribute":{ - "name":"ModifyInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified instance. You can specify only one attribute at a time.

Note: Using this action to change the security groups associated with an elastic network interface (ENI) attached to an instance in a VPC can result in an error if the instance has more than one ENI. To change the security groups associated with an ENI attached to an instance that has multiple ENIs, we recommend that you use the ModifyNetworkInterfaceAttribute action.

To modify some attributes, the instance must be stopped. For more information, see Modifying Attributes of a Stopped Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyInstanceCreditSpecification":{ - "name":"ModifyInstanceCreditSpecification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceCreditSpecificationRequest"}, - "output":{"shape":"ModifyInstanceCreditSpecificationResult"}, - "documentation":"

Modifies the credit option for CPU usage on a running or stopped T2 instance. The credit options are standard and unlimited.

For more information, see T2 Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifyInstancePlacement":{ - "name":"ModifyInstancePlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstancePlacementRequest"}, - "output":{"shape":"ModifyInstancePlacementResult"}, - "documentation":"

Modifies the placement attributes for a specified instance. You can do the following:

  • Modify the affinity between an instance and a Dedicated Host. When affinity is set to host and the instance is not associated with a specific Dedicated Host, the next time the instance is launched, it is automatically associated with the host on which it lands. If the instance is restarted or rebooted, this relationship persists.

  • Change the Dedicated Host with which an instance is associated.

  • Change the instance tenancy of an instance from host to dedicated, or from dedicated to host.

  • Move an instance to or from a placement group.

At least one attribute for affinity, host ID, tenancy, or placement group name must be specified in the request. Affinity and tenancy can be modified in the same request.

To modify the host ID, tenancy, or placement group for an instance, the instance must be in the stopped state.

" - }, - "ModifyLaunchTemplate":{ - "name":"ModifyLaunchTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyLaunchTemplateRequest"}, - "output":{"shape":"ModifyLaunchTemplateResult"}, - "documentation":"

Modifies a launch template. You can specify which version of the launch template to set as the default version. When launching an instance, the default version applies when a launch template version is not specified.

" - }, - "ModifyNetworkInterfaceAttribute":{ - "name":"ModifyNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyNetworkInterfaceAttributeRequest"}, - "documentation":"

Modifies the specified network interface attribute. You can specify only one attribute at a time.

" - }, - "ModifyReservedInstances":{ - "name":"ModifyReservedInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReservedInstancesRequest"}, - "output":{"shape":"ModifyReservedInstancesResult"}, - "documentation":"

Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySnapshotAttribute":{ - "name":"ModifySnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotAttributeRequest"}, - "documentation":"

Adds or removes permission settings for the specified snapshot. You may add or remove specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single API call. If you need to both add and remove account IDs for a snapshot, you must use multiple API calls.

Encrypted snapshots and snapshots with AWS Marketplace product codes cannot be made public. Snapshots encrypted with your default CMK cannot be shared with other accounts.

For more information about modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "ModifySpotFleetRequest":{ - "name":"ModifySpotFleetRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySpotFleetRequestRequest"}, - "output":{"shape":"ModifySpotFleetRequestResponse"}, - "documentation":"

Modifies the specified Spot Fleet request.

While the Spot Fleet request is being modified, it is in the modifying state.

To scale up your Spot Fleet, increase its target capacity. The Spot Fleet launches the additional Spot Instances according to the allocation strategy for the Spot Fleet request. If the allocation strategy is lowestPrice, the Spot Fleet launches instances using the Spot pool with the lowest price. If the allocation strategy is diversified, the Spot Fleet distributes the instances across the Spot pools.

To scale down your Spot Fleet, decrease its target capacity. First, the Spot Fleet cancels any open requests that exceed the new target capacity. You can request that the Spot Fleet terminate Spot Instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot Fleet terminates the instances with the highest price per unit. If the allocation strategy is diversified, the Spot Fleet terminates instances across the Spot pools. Alternatively, you can request that the Spot Fleet keep the fleet at its current size, but not replace any Spot Instances that are interrupted or that you terminate manually.

If you are finished with your Spot Fleet for now, but will use it again later, you can set the target capacity to 0.

" - }, - "ModifySubnetAttribute":{ - "name":"ModifySubnetAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySubnetAttributeRequest"}, - "documentation":"

Modifies a subnet attribute. You can only modify one attribute at a time.

" - }, - "ModifyVolume":{ - "name":"ModifyVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeRequest"}, - "output":{"shape":"ModifyVolumeResult"}, - "documentation":"

You can modify several parameters of an existing EBS volume, including volume size, volume type, and IOPS capacity. If your EBS volume is attached to a current-generation EC2 instance type, you may be able to apply these changes without stopping the instance or detaching the volume from it. For more information about modifying an EBS volume running Linux, see Modifying the Size, IOPS, or Type of an EBS Volume on Linux. For more information about modifying an EBS volume running Windows, see Modifying the Size, IOPS, or Type of an EBS Volume on Windows.

When you complete a resize operation on your volume, you need to extend the volume's file-system size to take advantage of the new storage capacity. For information about extending a Linux file system, see Extending a Linux File System. For information about extending a Windows file system, see Extending a Windows File System.

You can use CloudWatch Events to check the status of a modification to an EBS volume. For information about CloudWatch Events, see the Amazon CloudWatch Events User Guide. You can also track the status of a modification using the DescribeVolumesModifications API. For information about tracking status changes using either method, see Monitoring Volume Modifications.

With previous-generation instance types, resizing an EBS volume may require detaching and reattaching the volume or stopping and restarting the instance. For more information, see Modifying the Size, IOPS, or Type of an EBS Volume on Linux and Modifying the Size, IOPS, or Type of an EBS Volume on Windows.

If you reach the maximum volume modification rate per volume limit, you will need to wait at least six hours before applying further modifications to the affected EBS volume.

" - }, - "ModifyVolumeAttribute":{ - "name":"ModifyVolumeAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVolumeAttributeRequest"}, - "documentation":"

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first enabling I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations. We recommend that you change this only for boot volumes or for volumes that are stateless or disposable.

" - }, - "ModifyVpcAttribute":{ - "name":"ModifyVpcAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcAttributeRequest"}, - "documentation":"

Modifies the specified attribute of the specified VPC.

" - }, - "ModifyVpcEndpoint":{ - "name":"ModifyVpcEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointRequest"}, - "output":{"shape":"ModifyVpcEndpointResult"}, - "documentation":"

Modifies attributes of a specified VPC endpoint. The attributes that you can modify depend on the type of VPC endpoint (interface or gateway). For more information, see VPC Endpoints in the Amazon Virtual Private Cloud User Guide.

" - }, - "ModifyVpcEndpointConnectionNotification":{ - "name":"ModifyVpcEndpointConnectionNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointConnectionNotificationRequest"}, - "output":{"shape":"ModifyVpcEndpointConnectionNotificationResult"}, - "documentation":"

Modifies a connection notification for VPC endpoint or VPC endpoint service. You can change the SNS topic for the notification, or the events for which to be notified.

" - }, - "ModifyVpcEndpointServiceConfiguration":{ - "name":"ModifyVpcEndpointServiceConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointServiceConfigurationRequest"}, - "output":{"shape":"ModifyVpcEndpointServiceConfigurationResult"}, - "documentation":"

Modifies the attributes of your VPC endpoint service configuration. You can change the Network Load Balancers for your service, and you can specify whether acceptance is required for requests to connect to your endpoint service through an interface VPC endpoint.

" - }, - "ModifyVpcEndpointServicePermissions":{ - "name":"ModifyVpcEndpointServicePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcEndpointServicePermissionsRequest"}, - "output":{"shape":"ModifyVpcEndpointServicePermissionsResult"}, - "documentation":"

Modifies the permissions for your VPC endpoint service. You can add or remove permissions for service consumers (IAM users, IAM roles, and AWS accounts) to connect to your endpoint service.

If you grant permissions to all principals, the service is public. Any users who know the name of a public service can send a request to attach an endpoint. If the service does not require manual approval, attachments are automatically approved.

" - }, - "ModifyVpcPeeringConnectionOptions":{ - "name":"ModifyVpcPeeringConnectionOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcPeeringConnectionOptionsRequest"}, - "output":{"shape":"ModifyVpcPeeringConnectionOptionsResult"}, - "documentation":"

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

  • Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.

  • Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.

  • Enable/disable the ability to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

If the peered VPCs are in different accounts, each owner must initiate a separate request to modify the peering connection options, depending on whether their VPC was the requester or accepter for the VPC peering connection. If the peered VPCs are in the same account, you can modify the requester and accepter options in the same request. To confirm which VPC is the accepter and requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

" - }, - "ModifyVpcTenancy":{ - "name":"ModifyVpcTenancy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyVpcTenancyRequest"}, - "output":{"shape":"ModifyVpcTenancyResult"}, - "documentation":"

Modifies the instance tenancy attribute of the specified VPC. You can change the instance tenancy attribute of a VPC to default only. You cannot change the instance tenancy attribute to dedicated.

After you modify the tenancy of the VPC, any new instances that you launch into the VPC have a tenancy of default, unless you specify otherwise during launch. The tenancy of any existing instances in the VPC is not affected.

For more information, see Dedicated Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MonitorInstances":{ - "name":"MonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MonitorInstancesRequest"}, - "output":{"shape":"MonitorInstancesResult"}, - "documentation":"

Enables detailed monitoring for a running instance. Otherwise, basic monitoring is enabled. For more information, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

To disable detailed monitoring, see .

" - }, - "MoveAddressToVpc":{ - "name":"MoveAddressToVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAddressToVpcRequest"}, - "output":{"shape":"MoveAddressToVpcResult"}, - "documentation":"

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The Elastic IP address must be allocated to your account for more than 24 hours, and it must not be associated with an instance. After the Elastic IP address is moved, it is no longer available for use in the EC2-Classic platform, unless you move it back using the RestoreAddressToClassic request. You cannot move an Elastic IP address that was originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.

" - }, - "PurchaseHostReservation":{ - "name":"PurchaseHostReservation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseHostReservationRequest"}, - "output":{"shape":"PurchaseHostReservationResult"}, - "documentation":"

Purchase a reservation with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation. This action results in the specified reservation being purchased and charged to your account.

" - }, - "PurchaseReservedInstancesOffering":{ - "name":"PurchaseReservedInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedInstancesOfferingRequest"}, - "output":{"shape":"PurchaseReservedInstancesOfferingResult"}, - "documentation":"

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

" - }, - "PurchaseScheduledInstances":{ - "name":"PurchaseScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseScheduledInstancesRequest"}, - "output":{"shape":"PurchaseScheduledInstancesResult"}, - "documentation":"

Purchases one or more Scheduled Instances with the specified schedule.

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, you must call RunScheduledInstances during each scheduled time period.

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

" - }, - "RebootInstances":{ - "name":"RebootInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstancesRequest"}, - "documentation":"

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If an instance does not cleanly shut down within four minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Getting Console Output and Rebooting Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RegisterImage":{ - "name":"RegisterImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterImageRequest"}, - "output":{"shape":"RegisterImageResult"}, - "documentation":"

Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from a snapshot of a root device volume. You specify the snapshot using the block device mapping. For more information, see Launching a Linux Instance from a Backup in the Amazon Elastic Compute Cloud User Guide.

You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.

Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES), use the EC2 billing product code associated with an AMI to verify the subscription status for package updates. Creating an AMI from an EBS snapshot does not maintain this billing code, and instances launched from such an AMI are not able to connect to package update infrastructure. If you purchase a Reserved Instance offering for one of these Linux distributions and launch instances using an AMI that does not contain the required billing code, your Reserved Instance is not applied to these instances.

To create an AMI for operating systems that require a billing code, see CreateImage.

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.

" - }, - "RejectVpcEndpointConnections":{ - "name":"RejectVpcEndpointConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcEndpointConnectionsRequest"}, - "output":{"shape":"RejectVpcEndpointConnectionsResult"}, - "documentation":"

Rejects one or more VPC endpoint connection requests to your VPC endpoint service.

" - }, - "RejectVpcPeeringConnection":{ - "name":"RejectVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectVpcPeeringConnectionRequest"}, - "output":{"shape":"RejectVpcPeeringConnectionResult"}, - "documentation":"

Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

" - }, - "ReleaseAddress":{ - "name":"ReleaseAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseAddressRequest"}, - "documentation":"

Releases the specified Elastic IP address.

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

After releasing an Elastic IP address, it is released to the IP address pool. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure error if the address is already allocated to another AWS account.

[EC2-VPC] After you release an Elastic IP address for use in a VPC, you might be able to recover it. For more information, see AllocateAddress.

" - }, - "ReleaseHosts":{ - "name":"ReleaseHosts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseHostsRequest"}, - "output":{"shape":"ReleaseHostsResult"}, - "documentation":"

When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into released state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, for example, ModifyHosts. You must stop or terminate all instances on a host before it can be released.

When Dedicated Hosts are released, it may take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated Hosts. Wait a few minutes and then try again.

Released hosts still appear in a DescribeHosts response.

" - }, - "ReplaceIamInstanceProfileAssociation":{ - "name":"ReplaceIamInstanceProfileAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceIamInstanceProfileAssociationRequest"}, - "output":{"shape":"ReplaceIamInstanceProfileAssociationResult"}, - "documentation":"

Replaces an IAM instance profile for the specified running instance. You can use this action to change the IAM instance profile that's associated with an instance without having to disassociate the existing IAM instance profile first.

Use DescribeIamInstanceProfileAssociations to get the association ID.

" - }, - "ReplaceNetworkAclAssociation":{ - "name":"ReplaceNetworkAclAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclAssociationRequest"}, - "output":{"shape":"ReplaceNetworkAclAssociationResult"}, - "documentation":"

Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

This is an idempotent operation.

" - }, - "ReplaceNetworkAclEntry":{ - "name":"ReplaceNetworkAclEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceNetworkAclEntryRequest"}, - "documentation":"

Replaces an entry (rule) in a network ACL. For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRoute":{ - "name":"ReplaceRoute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteRequest"}, - "documentation":"

Replaces an existing route within a route table in a VPC. You must provide only one of the following: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, or egress-only internet gateway.

For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

" - }, - "ReplaceRouteTableAssociation":{ - "name":"ReplaceRouteTableAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReplaceRouteTableAssociationRequest"}, - "output":{"shape":"ReplaceRouteTableAssociationResult"}, - "documentation":"

Changes the route table associated with a given subnet in a VPC. After the operation completes, the subnet uses the routes in the new route table it's associated with. For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

You can also use ReplaceRouteTableAssociation to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table to be the new main route table.

" - }, - "ReportInstanceStatus":{ - "name":"ReportInstanceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReportInstanceStatusRequest"}, - "documentation":"

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Use of this action does not change the value returned by DescribeInstanceStatus.

" - }, - "RequestSpotFleet":{ - "name":"RequestSpotFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotFleetRequest"}, - "output":{"shape":"RequestSpotFleetResponse"}, - "documentation":"

Creates a Spot Fleet request.

The Spot Fleet request specifies the total target capacity and the On-Demand target capacity. Amazon EC2 calculates the difference between the total capacity and On-Demand capacity, and launches the difference as Spot capacity.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot Fleet requests Spot Instances in the Spot pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot Fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot Instances in your Spot Fleet are in different Spot pools, you can improve the availability of your fleet.

You can specify tags for the Spot Instances. You cannot tag other resource types in a Spot Fleet request because only the instance resource type is supported.

For more information, see Spot Fleet Requests in the Amazon EC2 User Guide for Linux Instances.

" - }, - "RequestSpotInstances":{ - "name":"RequestSpotInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestSpotInstancesRequest"}, - "output":{"shape":"RequestSpotInstancesResult"}, - "documentation":"

Creates a Spot Instance request.

For more information, see Spot Instance Requests in the Amazon EC2 User Guide for Linux Instances.

" - }, - "ResetFpgaImageAttribute":{ - "name":"ResetFpgaImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetFpgaImageAttributeRequest"}, - "output":{"shape":"ResetFpgaImageAttributeResult"}, - "documentation":"

Resets the specified attribute of the specified Amazon FPGA Image (AFI) to its default value. You can only reset the load permission attribute.

" - }, - "ResetImageAttribute":{ - "name":"ResetImageAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetImageAttributeRequest"}, - "documentation":"

Resets an attribute of an AMI to its default value.

The productCodes attribute can't be reset.

" - }, - "ResetInstanceAttribute":{ - "name":"ResetInstanceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetInstanceAttributeRequest"}, - "documentation":"

Resets an attribute of an instance to its default value. To reset the kernel or ramdisk, the instance must be in a stopped state. To reset the sourceDestCheck, the instance can be either running or stopped.

The sourceDestCheck attribute controls whether source/destination checking is enabled. The default value is true, which means checking is enabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

" - }, - "ResetNetworkInterfaceAttribute":{ - "name":"ResetNetworkInterfaceAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetNetworkInterfaceAttributeRequest"}, - "documentation":"

Resets a network interface attribute. You can specify only one attribute at a time.

" - }, - "ResetSnapshotAttribute":{ - "name":"ResetSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetSnapshotAttributeRequest"}, - "documentation":"

Resets permission settings for the specified snapshot.

For more information about modifying snapshot permissions, see Sharing Snapshots in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RestoreAddressToClassic":{ - "name":"RestoreAddressToClassic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreAddressToClassicRequest"}, - "output":{"shape":"RestoreAddressToClassicResult"}, - "documentation":"

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

" - }, - "RevokeSecurityGroupEgress":{ - "name":"RevokeSecurityGroupEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupEgressRequest"}, - "documentation":"

[EC2-VPC only] Removes one or more egress rules from a security group for EC2-VPC. This action doesn't apply to security groups for use in EC2-Classic. To remove a rule, the values that you specify (for example, ports) must match the existing rule's values exactly.

Each rule consists of the protocol and the IPv4 or IPv6 CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code. If the security group rule has a description, you do not have to specify the description to revoke the rule.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RevokeSecurityGroupIngress":{ - "name":"RevokeSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSecurityGroupIngressRequest"}, - "documentation":"

Removes one or more ingress rules from a security group. To remove a rule, the values that you specify (for example, ports) must match the existing rule's values exactly.

[EC2-Classic security groups only] If the values you specify do not match the existing rule's values, no error is returned. Use DescribeSecurityGroups to verify that the rule has been removed.

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code. If the security group rule has a description, you do not have to specify the description to revoke the rule.

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

" - }, - "RunInstances":{ - "name":"RunInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunInstancesRequest"}, - "output":{"shape":"Reservation"}, - "documentation":"

Launches the specified number of instances using an AMI for which you have permissions.

You can specify a number of options, or leave the default options. The following rules apply:

  • [EC2-VPC] If you don't specify a subnet ID, we choose a default subnet from your default VPC for you. If you don't have a default VPC, you must specify a subnet ID in the request.

  • [EC2-Classic] If don't specify an Availability Zone, we choose one for you.

  • Some instance types must be launched into a VPC. If you do not have a default VPC, or if you do not specify a subnet ID, the request fails. For more information, see Instance Types Available Only in a VPC.

  • [EC2-VPC] All instances have a network interface with a primary private IPv4 address. If you don't specify this address, we choose one from the IPv4 range of your subnet.

  • Not all instance types support IPv6 addresses. For more information, see Instance Types.

  • If you don't specify a security group ID, we use the default security group. For more information, see Security Groups.

  • If any of the AMIs have a product code attached for which the user has not subscribed, the request fails.

You can create a launch template, which is a resource that contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify the launch template instead of specifying the launch parameters.

To ensure faster instance launches, break up large requests into smaller batches. For example, create five separate launch requests for 100 instances each instead of one launch request for 500 instances.

An instance is ready for you to use when it's in the running state. You can check the state of your instance using DescribeInstances. You can tag instances and EBS volumes during launch, after launch, or both. For more information, see CreateTags and Tagging Your Amazon EC2 Resources.

Linux instances have access to the public key of the key pair at boot. You can use this key to provide secure access to the instance. Amazon EC2 public images use this feature to provide secure access without passwords. For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

For troubleshooting, see What To Do If An Instance Immediately Terminates, and Troubleshooting Connecting to Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "RunScheduledInstances":{ - "name":"RunScheduledInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunScheduledInstancesRequest"}, - "output":{"shape":"RunScheduledInstancesResult"}, - "documentation":"

Launches the specified Scheduled Instances.

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, you can launch it again after a few minutes. For more information, see Scheduled Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StartInstances":{ - "name":"StartInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstancesRequest"}, - "output":{"shape":"StartInstancesResult"}, - "documentation":"

Starts an Amazon EBS-backed instance that you've previously stopped.

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for instance usage. However, your root partition Amazon EBS volume remains and continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Every time you start your Windows instance, Amazon EC2 charges you for a full instance hour. If you stop and restart your Windows instance, a new instance hour begins and Amazon EC2 charges you for another full instance hour even if you are still within the same 60-minute period when it was stopped. Every time you start your Linux instance, Amazon EC2 charges a one-minute minimum for instance usage, and thereafter charges per second for instance usage.

Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Performing this operation on an instance that uses an instance store as its root device returns an error.

For more information, see Stopping Instances in the Amazon Elastic Compute Cloud User Guide.

" - }, - "StopInstances":{ - "name":"StopInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstancesRequest"}, - "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance.

We don't charge usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains and continues to persist your data, and you are charged for Amazon EBS volume usage. Every time you start your Windows instance, Amazon EC2 charges you for a full instance hour. If you stop and restart your Windows instance, a new instance hour begins and Amazon EC2 charges you for another full instance hour even if you are still within the same 60-minute period when it was stopped. Every time you start your Linux instance, Amazon EC2 charges a one-minute minimum for instance usage, and thereafter charges per second for instance usage.

You can't start or stop Spot Instances, and you can't stop instance store-backed instances.

When you stop an instance, we shut it down. You can restart your instance at any time. Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM.

Stopping an instance is different to rebooting or terminating it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshooting Stopping Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "TerminateInstances":{ - "name":"TerminateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateInstancesRequest"}, - "output":{"shape":"TerminateInstancesResult"}, - "documentation":"

Shuts down one or more instances. This operation is idempotent; if you terminate an instance more than once, each call succeeds.

If you specify multiple instances and the request fails (for example, because of a single incorrect instance ID), none of the instances are terminated.

Terminated instances remain visible after termination (for approximately one hour).

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance launched. Volumes attached after instance launch continue running.

You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the DeleteOnTermination block device mapping parameter set to true are automatically deleted. For more information about the differences between stopping and terminating instances, see Instance Lifecycle in the Amazon Elastic Compute Cloud User Guide.

For more information about troubleshooting, see Troubleshooting Terminating Your Instance in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UnassignIpv6Addresses":{ - "name":"UnassignIpv6Addresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignIpv6AddressesRequest"}, - "output":{"shape":"UnassignIpv6AddressesResult"}, - "documentation":"

Unassigns one or more IPv6 addresses from a network interface.

" - }, - "UnassignPrivateIpAddresses":{ - "name":"UnassignPrivateIpAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignPrivateIpAddressesRequest"}, - "documentation":"

Unassigns one or more secondary private IP addresses from a network interface.

" - }, - "UnmonitorInstances":{ - "name":"UnmonitorInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnmonitorInstancesRequest"}, - "output":{"shape":"UnmonitorInstancesResult"}, - "documentation":"

Disables detailed monitoring for a running instance. For more information, see Monitoring Your Instances and Volumes in the Amazon Elastic Compute Cloud User Guide.

" - }, - "UpdateSecurityGroupRuleDescriptionsEgress":{ - "name":"UpdateSecurityGroupRuleDescriptionsEgress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSecurityGroupRuleDescriptionsEgressRequest"}, - "output":{"shape":"UpdateSecurityGroupRuleDescriptionsEgressResult"}, - "documentation":"

[EC2-VPC only] Updates the description of an egress (outbound) security group rule. You can replace an existing description, or add a description to a rule that did not have one previously.

You specify the description as part of the IP permissions structure. You can remove a description for a security group rule by omitting the description parameter in the request.

" - }, - "UpdateSecurityGroupRuleDescriptionsIngress":{ - "name":"UpdateSecurityGroupRuleDescriptionsIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSecurityGroupRuleDescriptionsIngressRequest"}, - "output":{"shape":"UpdateSecurityGroupRuleDescriptionsIngressResult"}, - "documentation":"

Updates the description of an ingress (inbound) security group rule. You can replace an existing description, or add a description to a rule that did not have one previously.

You specify the description as part of the IP permissions structure. You can remove a description for a security group rule by omitting the description parameter in the request.

" - } - }, - "shapes":{ - "AcceptReservedInstancesExchangeQuoteRequest":{ - "type":"structure", - "required":["ReservedInstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ReservedInstanceIds":{ - "shape":"ReservedInstanceIdSet", - "documentation":"

The IDs of the Convertible Reserved Instances to exchange for another Convertible Reserved Instance of the same or higher value.

", - "locationName":"ReservedInstanceId" - }, - "TargetConfigurations":{ - "shape":"TargetConfigurationRequestSet", - "documentation":"

The configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.

", - "locationName":"TargetConfiguration" - } - }, - "documentation":"

Contains the parameters for accepting the quote.

" - }, - "AcceptReservedInstancesExchangeQuoteResult":{ - "type":"structure", - "members":{ - "ExchangeId":{ - "shape":"String", - "documentation":"

The ID of the successful exchange.

", - "locationName":"exchangeId" - } - }, - "documentation":"

The result of the exchange and whether it was successful.

" - }, - "AcceptVpcEndpointConnectionsRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "VpcEndpointIds" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the endpoint service.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of one or more interface VPC endpoints.

", - "locationName":"VpcEndpointId" - } - } - }, - "AcceptVpcEndpointConnectionsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the interface endpoints that were not accepted, if applicable.

", - "locationName":"unsuccessful" - } - } - }, - "AcceptVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection. You must specify this parameter in the request.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for AcceptVpcPeeringConnection.

" - }, - "AcceptVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of AcceptVpcPeeringConnection.

" - }, - "AccountAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the account attribute.

", - "locationName":"attributeName" - }, - "AttributeValues":{ - "shape":"AccountAttributeValueList", - "documentation":"

One or more values for the account attribute.

", - "locationName":"attributeValueSet" - } - }, - "documentation":"

Describes an account attribute.

" - }, - "AccountAttributeList":{ - "type":"list", - "member":{ - "shape":"AccountAttribute", - "locationName":"item" - } - }, - "AccountAttributeName":{ - "type":"string", - "enum":[ - "supported-platforms", - "default-vpc" - ] - }, - "AccountAttributeNameStringList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeName", - "locationName":"attributeName" - } - }, - "AccountAttributeValue":{ - "type":"structure", - "members":{ - "AttributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute.

", - "locationName":"attributeValue" - } - }, - "documentation":"

Describes a value of an account attribute.

" - }, - "AccountAttributeValueList":{ - "type":"list", - "member":{ - "shape":"AccountAttributeValue", - "locationName":"item" - } - }, - "ActiveInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "InstanceHealth":{ - "shape":"InstanceHealthStatus", - "documentation":"

The health status of the instance. If the status of either the instance status check or the system status check is impaired, the health status of the instance is unhealthy. Otherwise, the health status is healthy.

", - "locationName":"instanceHealth" - } - }, - "documentation":"

Describes a running instance in a Spot Fleet.

" - }, - "ActiveInstanceSet":{ - "type":"list", - "member":{ - "shape":"ActiveInstance", - "locationName":"item" - } - }, - "ActivityStatus":{ - "type":"string", - "enum":[ - "error", - "pending_fulfillment", - "pending_termination", - "fulfilled" - ] - }, - "Address":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is associated with (if any).

", - "locationName":"instanceId" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

The ID representing the allocation of the address for use with EC2-VPC.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID representing the association of the address with an instance in a VPC.

", - "locationName":"associationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "NetworkInterfaceOwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the network interface.

", - "locationName":"networkInterfaceOwnerId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIpAddress" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Elastic IP address.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "AddressList":{ - "type":"list", - "member":{ - "shape":"Address", - "locationName":"item" - } - }, - "Affinity":{ - "type":"string", - "enum":[ - "default", - "host" - ] - }, - "AllocateAddressRequest":{ - "type":"structure", - "members":{ - "Domain":{ - "shape":"DomainType", - "documentation":"

Set to vpc to allocate the address for use with instances in a VPC.

Default: The address is for use with instances in EC2-Classic.

" - }, - "Address":{ - "shape":"String", - "documentation":"

[EC2-VPC] The Elastic IP address to recover.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for AllocateAddress.

" - }, - "AllocateAddressResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", - "locationName":"allocationId" - }, - "Domain":{ - "shape":"DomainType", - "documentation":"

Indicates whether this Elastic IP address is for use with instances in EC2-Classic (standard) or instances in a VPC (vpc).

", - "locationName":"domain" - } - }, - "documentation":"

Contains the output of AllocateAddress.

" - }, - "AllocateHostsRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "InstanceType", - "Quantity" - ], - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID.

Default: Enabled

", - "locationName":"autoPlacement" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the Dedicated Hosts.

", - "locationName":"availabilityZone" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

Specify the instance type for which to configure your Dedicated Hosts. When you specify the instance type, that is the only instance type that you can launch onto that host.

", - "locationName":"instanceType" - }, - "Quantity":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts to allocate to your account with these parameters.

", - "locationName":"quantity" - } - }, - "documentation":"

Contains the parameters for AllocateHosts.

" - }, - "AllocateHostsResult":{ - "type":"structure", - "members":{ - "HostIds":{ - "shape":"ResponseHostIdList", - "documentation":"

The ID of the allocated Dedicated Host. This is used to launch an instance onto a specific host.

", - "locationName":"hostIdSet" - } - }, - "documentation":"

Contains the output of AllocateHosts.

" - }, - "AllocationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AllocationId" - } - }, - "AllocationState":{ - "type":"string", - "enum":[ - "available", - "under-assessment", - "permanent-failure", - "released", - "released-permanent-failure" - ] - }, - "AllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "diversified" - ] - }, - "AllowedPrincipal":{ - "type":"structure", - "members":{ - "PrincipalType":{ - "shape":"PrincipalType", - "documentation":"

The type of principal.

", - "locationName":"principalType" - }, - "Principal":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the principal.

", - "locationName":"principal" - } - }, - "documentation":"

Describes a principal.

" - }, - "AllowedPrincipalSet":{ - "type":"list", - "member":{ - "shape":"AllowedPrincipal", - "locationName":"item" - } - }, - "ArchitectureValues":{ - "type":"string", - "enum":[ - "i386", - "x86_64" - ] - }, - "AssignIpv6AddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

The number of IPv6 addresses to assign to the network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses.

", - "locationName":"ipv6AddressCount" - }, - "Ipv6Addresses":{ - "shape":"Ipv6AddressList", - "documentation":"

One or more specific IPv6 addresses to be assigned to the network interface. You can't use this option if you're specifying a number of IPv6 addresses.

", - "locationName":"ipv6Addresses" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "AssignIpv6AddressesResult":{ - "type":"structure", - "members":{ - "AssignedIpv6Addresses":{ - "shape":"Ipv6AddressList", - "documentation":"

The IPv6 addresses assigned to the network interface.

", - "locationName":"assignedIpv6Addresses" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "AssignPrivateIpAddressesRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "AllowReassignment":{ - "shape":"Boolean", - "documentation":"

Indicates whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface.

", - "locationName":"allowReassignment" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

One or more IP addresses to be assigned as a secondary private IP address to the network interface. You can't specify this parameter when also specifying a number of secondary IP addresses.

If you don't specify an IP address, Amazon EC2 automatically selects an IP address within the subnet range.

", - "locationName":"privateIpAddress" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary IP addresses to assign to the network interface. You can't specify this parameter when also specifying private IP addresses.

", - "locationName":"secondaryPrivateIpAddressCount" - } - }, - "documentation":"

Contains the parameters for AssignPrivateIpAddresses.

" - }, - "AssociateAddressRequest":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. This is required for EC2-VPC.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This is required for EC2-Classic. For EC2-VPC, you can specify either the instance ID or the network interface ID, but not both. The operation fails if you specify an instance ID unless exactly one network interface is attached.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address. This is required for EC2-Classic.

" - }, - "AllowReassociation":{ - "shape":"Boolean", - "documentation":"

[EC2-VPC] For a VPC in an EC2-Classic account, specify true to allow an Elastic IP address that is already associated with an instance or network interface to be reassociated with the specified instance or network interface. Otherwise, the operation fails. In a VPC in an EC2-VPC-only account, reassociation is automatic, therefore you can specify false to ensure the operation fails if the Elastic IP address is already associated with another resource.

", - "locationName":"allowReassociation" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Contains the parameters for AssociateAddress.

" - }, - "AssociateAddressResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID that represents the association of the Elastic IP address with an instance.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateAddress.

" - }, - "AssociateDhcpOptionsRequest":{ - "type":"structure", - "required":[ - "DhcpOptionsId", - "VpcId" - ], - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for AssociateDhcpOptions.

" - }, - "AssociateIamInstanceProfileRequest":{ - "type":"structure", - "required":[ - "IamInstanceProfile", - "InstanceId" - ], - "members":{ - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "AssociateIamInstanceProfileResult":{ - "type":"structure", - "members":{ - "IamInstanceProfileAssociation":{ - "shape":"IamInstanceProfileAssociation", - "documentation":"

Information about the IAM instance profile association.

", - "locationName":"iamInstanceProfileAssociation" - } - } - }, - "AssociateRouteTableRequest":{ - "type":"structure", - "required":[ - "RouteTableId", - "SubnetId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Contains the parameters for AssociateRouteTable.

" - }, - "AssociateRouteTableResult":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The route table association ID. This ID is required for disassociating the route table.

", - "locationName":"associationId" - } - }, - "documentation":"

Contains the output of AssociateRouteTable.

" - }, - "AssociateSubnetCidrBlockRequest":{ - "type":"structure", - "required":[ - "Ipv6CidrBlock", - "SubnetId" - ], - "members":{ - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block for your subnet. The subnet must have a /64 prefix length.

", - "locationName":"ipv6CidrBlock" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of your subnet.

", - "locationName":"subnetId" - } - } - }, - "AssociateSubnetCidrBlockResult":{ - "type":"structure", - "members":{ - "Ipv6CidrBlockAssociation":{ - "shape":"SubnetIpv6CidrBlockAssociation", - "documentation":"

Information about the IPv6 CIDR block association.

", - "locationName":"ipv6CidrBlockAssociation" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - } - }, - "AssociateVpcCidrBlockRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "AmazonProvidedIpv6CidrBlock":{ - "shape":"Boolean", - "documentation":"

Requests an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC. You cannot specify the range of IPv6 addresses, or the size of the CIDR block.

", - "locationName":"amazonProvidedIpv6CidrBlock" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

An IPv4 CIDR block to associate with the VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AssociateVpcCidrBlockResult":{ - "type":"structure", - "members":{ - "Ipv6CidrBlockAssociation":{ - "shape":"VpcIpv6CidrBlockAssociation", - "documentation":"

Information about the IPv6 CIDR block association.

", - "locationName":"ipv6CidrBlockAssociation" - }, - "CidrBlockAssociation":{ - "shape":"VpcCidrBlockAssociation", - "documentation":"

Information about the IPv4 CIDR block association.

", - "locationName":"cidrBlockAssociation" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "AssociationIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AssociationId" - } - }, - "AttachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "Groups", - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The ID of one or more of the VPC's security groups. You cannot specify security groups from a different VPC.

", - "locationName":"SecurityGroupId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of an EC2-Classic instance to link to the ClassicLink-enabled VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of a ClassicLink-enabled VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for AttachClassicLinkVpc.

" - }, - "AttachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of AttachClassicLinkVpc.

" - }, - "AttachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for AttachInternetGateway.

" - }, - "AttachNetworkInterfaceRequest":{ - "type":"structure", - "required":[ - "DeviceIndex", - "InstanceId", - "NetworkInterfaceId" - ], - "members":{ - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for AttachNetworkInterface.

" - }, - "AttachNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - } - }, - "documentation":"

Contains the output of AttachNetworkInterface.

" - }, - "AttachVolumeRequest":{ - "type":"structure", - "required":[ - "Device", - "InstanceId", - "VolumeId" - ], - "members":{ - "Device":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for AttachVolume.

" - }, - "AttachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpcId", - "VpnGatewayId" - ], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for AttachVpnGateway.

" - }, - "AttachVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpcAttachment":{ - "shape":"VpcAttachment", - "documentation":"

Information about the attachment.

", - "locationName":"attachment" - } - }, - "documentation":"

Contains the output of AttachVpnGateway.

" - }, - "AttachmentStatus":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached" - ] - }, - "AttributeBooleanValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

The attribute value. The valid values are true or false.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a Boolean value.

" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

The attribute value. The value is case-sensitive.

", - "locationName":"value" - } - }, - "documentation":"

Describes a value for a resource attribute that is a String.

" - }, - "AuthorizeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more sets of IP permissions. You can't specify a destination security group and a CIDR IP address range in the same set of permissions.

", - "locationName":"ipPermissions" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify the CIDR.

", - "locationName":"cidrIp" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

Not supported. Use a set of IP permissions to specify the port.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify the protocol name or number.

", - "locationName":"ipProtocol" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

Not supported. Use a set of IP permissions to specify the port.

", - "locationName":"toPort" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify a destination security group.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify a destination security group.

", - "locationName":"sourceSecurityGroupOwnerId" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupEgress.

" - }, - "AuthorizeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IPv4 address range. You can't specify this parameter when specifying a source security group.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type number. For the ICMP/ICMPv6 type number, use -1 to specify all types. If you specify all ICMP/ICMPv6 types, you must specify all codes.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. You must specify either the security group ID or the security group name in the request. For security groups in a nondefault VPC, you must specify the security group ID.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You must specify either the security group ID or the security group name in the request.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more sets of IP permissions. Can be used to specify multiple rules in a single command.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). (VPC only) Use -1 to specify all protocols. If you specify -1, or a protocol number other than tcp, udp, icmp, or 58 (ICMPv6), traffic on all ports is allowed, regardless of any ports you specify. For tcp, udp, and icmp, you must specify a port range. For protocol 58 (ICMPv6), you can optionally specify a port range; if you don't, traffic for all types and codes is allowed.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead. For EC2-VPC, the source security group must be in the same VPC.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account ID for the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code number. For the ICMP/ICMPv6 code number, use -1 to specify all codes. If you specify all ICMP/ICMPv6 types, you must specify all codes.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for AuthorizeSecurityGroupIngress.

" - }, - "AutoPlacement":{ - "type":"string", - "enum":[ - "on", - "off" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "State":{ - "shape":"AvailabilityZoneState", - "documentation":"

The state of the Availability Zone.

", - "locationName":"zoneState" - }, - "Messages":{ - "shape":"AvailabilityZoneMessageList", - "documentation":"

Any messages about the Availability Zone.

", - "locationName":"messageSet" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - }, - "ZoneName":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

", - "locationName":"zoneName" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"item" - } - }, - "AvailabilityZoneMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The message about the Availability Zone.

", - "locationName":"message" - } - }, - "documentation":"

Describes a message about an Availability Zone.

" - }, - "AvailabilityZoneMessageList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZoneMessage", - "locationName":"item" - } - }, - "AvailabilityZoneState":{ - "type":"string", - "enum":[ - "available", - "information", - "impaired", - "unavailable" - ] - }, - "AvailableCapacity":{ - "type":"structure", - "members":{ - "AvailableInstanceCapacity":{ - "shape":"AvailableInstanceCapacityList", - "documentation":"

The total number of instances supported by the Dedicated Host.

", - "locationName":"availableInstanceCapacity" - }, - "AvailableVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs available on the Dedicated Host.

", - "locationName":"availableVCpus" - } - }, - "documentation":"

The capacity information for instances launched onto the Dedicated Host.

" - }, - "AvailableInstanceCapacityList":{ - "type":"list", - "member":{ - "shape":"InstanceCapacity", - "locationName":"item" - } - }, - "BatchState":{ - "type":"string", - "enum":[ - "submitted", - "active", - "cancelled", - "failed", - "cancelled_running", - "cancelled_terminating", - "modifying" - ] - }, - "BillingProductList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "Blob":{"type":"blob"}, - "BlobAttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Blob", - "locationName":"value" - } - } - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

", - "locationName":"virtualName" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "BlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"item" - } - }, - "BlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"BlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "Boolean":{"type":"boolean"}, - "BundleIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"BundleId" - } - }, - "BundleInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Storage" - ], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to bundle.

Type: String

Default: None

Required: Yes

" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for BundleInstance.

" - }, - "BundleInstanceResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of BundleInstance.

" - }, - "BundleTask":{ - "type":"structure", - "members":{ - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

", - "locationName":"bundleId" - }, - "BundleTaskError":{ - "shape":"BundleTaskError", - "documentation":"

If the task fails, a description of the error.

", - "locationName":"error" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance associated with this bundle task.

", - "locationName":"instanceId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The level of task completion, as a percent (for example, 20%).

", - "locationName":"progress" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time this task started.

", - "locationName":"startTime" - }, - "State":{ - "shape":"BundleTaskState", - "documentation":"

The state of the task.

", - "locationName":"state" - }, - "Storage":{ - "shape":"Storage", - "documentation":"

The Amazon S3 storage locations.

", - "locationName":"storage" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update for the task.

", - "locationName":"updateTime" - } - }, - "documentation":"

Describes a bundle task.

" - }, - "BundleTaskError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes an error for BundleInstance.

" - }, - "BundleTaskList":{ - "type":"list", - "member":{ - "shape":"BundleTask", - "locationName":"item" - } - }, - "BundleTaskState":{ - "type":"string", - "enum":[ - "pending", - "waiting-for-shutdown", - "bundling", - "storing", - "cancelling", - "complete", - "failed" - ] - }, - "CancelBatchErrorCode":{ - "type":"string", - "enum":[ - "fleetRequestIdDoesNotExist", - "fleetRequestIdMalformed", - "fleetRequestNotInCancellableState", - "unexpectedError" - ] - }, - "CancelBundleTaskRequest":{ - "type":"structure", - "required":["BundleId"], - "members":{ - "BundleId":{ - "shape":"String", - "documentation":"

The ID of the bundle task.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CancelBundleTask.

" - }, - "CancelBundleTaskResult":{ - "type":"structure", - "members":{ - "BundleTask":{ - "shape":"BundleTask", - "documentation":"

Information about the bundle task.

", - "locationName":"bundleInstanceTask" - } - }, - "documentation":"

Contains the output of CancelBundleTask.

" - }, - "CancelConversionRequest":{ - "type":"structure", - "required":["ConversionTaskId"], - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "ReasonMessage":{ - "shape":"String", - "documentation":"

The reason for canceling the conversion task.

", - "locationName":"reasonMessage" - } - }, - "documentation":"

Contains the parameters for CancelConversionTask.

" - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["ExportTaskId"], - "members":{ - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task. This is the ID returned by CreateInstanceExportTask.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for CancelExportTask.

" - }, - "CancelImportTaskRequest":{ - "type":"structure", - "members":{ - "CancelReason":{ - "shape":"String", - "documentation":"

The reason for canceling the task.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image or import snapshot task to be canceled.

" - } - }, - "documentation":"

Contains the parameters for CancelImportTask.

" - }, - "CancelImportTaskResult":{ - "type":"structure", - "members":{ - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the task being canceled.

", - "locationName":"importTaskId" - }, - "PreviousState":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"previousState" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the task being canceled.

", - "locationName":"state" - } - }, - "documentation":"

Contains the output for CancelImportTask.

" - }, - "CancelReservedInstancesListingRequest":{ - "type":"structure", - "required":["ReservedInstancesListingId"], - "members":{ - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - } - }, - "documentation":"

Contains the parameters for CancelReservedInstancesListing.

" - }, - "CancelReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

The Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CancelReservedInstancesListing.

" - }, - "CancelSpotFleetRequestsError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"CancelBatchErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Fleet error.

" - }, - "CancelSpotFleetRequestsErrorItem":{ - "type":"structure", - "required":[ - "Error", - "SpotFleetRequestId" - ], - "members":{ - "Error":{ - "shape":"CancelSpotFleetRequestsError", - "documentation":"

The error.

", - "locationName":"error" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Describes a Spot Fleet request that was not successfully canceled.

" - }, - "CancelSpotFleetRequestsErrorSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsErrorItem", - "locationName":"item" - } - }, - "CancelSpotFleetRequestsRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot Fleet requests.

", - "locationName":"spotFleetRequestId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for a Spot Fleet request if it is canceled successfully.

", - "locationName":"terminateInstances" - } - }, - "documentation":"

Contains the parameters for CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsResponse":{ - "type":"structure", - "members":{ - "SuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsSuccessSet", - "documentation":"

Information about the Spot Fleet requests that are successfully canceled.

", - "locationName":"successfulFleetRequestSet" - }, - "UnsuccessfulFleetRequests":{ - "shape":"CancelSpotFleetRequestsErrorSet", - "documentation":"

Information about the Spot Fleet requests that are not successfully canceled.

", - "locationName":"unsuccessfulFleetRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotFleetRequests.

" - }, - "CancelSpotFleetRequestsSuccessItem":{ - "type":"structure", - "required":[ - "CurrentSpotFleetRequestState", - "PreviousSpotFleetRequestState", - "SpotFleetRequestId" - ], - "members":{ - "CurrentSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The current state of the Spot Fleet request.

", - "locationName":"currentSpotFleetRequestState" - }, - "PreviousSpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The previous state of the Spot Fleet request.

", - "locationName":"previousSpotFleetRequestState" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Describes a Spot Fleet request that was successfully canceled.

" - }, - "CancelSpotFleetRequestsSuccessSet":{ - "type":"list", - "member":{ - "shape":"CancelSpotFleetRequestsSuccessItem", - "locationName":"item" - } - }, - "CancelSpotInstanceRequestState":{ - "type":"string", - "enum":[ - "active", - "open", - "closed", - "cancelled", - "completed" - ] - }, - "CancelSpotInstanceRequestsRequest":{ - "type":"structure", - "required":["SpotInstanceRequestIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for CancelSpotInstanceRequests.

" - }, - "CancelSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "CancelledSpotInstanceRequests":{ - "shape":"CancelledSpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of CancelSpotInstanceRequests.

" - }, - "CancelledSpotInstanceRequest":{ - "type":"structure", - "members":{ - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "State":{ - "shape":"CancelSpotInstanceRequestState", - "documentation":"

The state of the Spot Instance request.

", - "locationName":"state" - } - }, - "documentation":"

Describes a request to cancel a Spot Instance.

" - }, - "CancelledSpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"CancelledSpotInstanceRequest", - "locationName":"item" - } - }, - "CidrBlock":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR block.

", - "locationName":"cidrBlock" - } - }, - "documentation":"

Describes an IPv4 CIDR block.

" - }, - "CidrBlockSet":{ - "type":"list", - "member":{ - "shape":"CidrBlock", - "locationName":"item" - } - }, - "ClassicLinkDnsSupport":{ - "type":"structure", - "members":{ - "ClassicLinkDnsSupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether ClassicLink DNS support is enabled for the VPC.

", - "locationName":"classicLinkDnsSupported" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes the ClassicLink DNS support status of a VPC.

" - }, - "ClassicLinkDnsSupportList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkDnsSupport", - "locationName":"item" - } - }, - "ClassicLinkInstance":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

A list of security groups.

", - "locationName":"groupSet" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a linked EC2-Classic instance.

" - }, - "ClassicLinkInstanceList":{ - "type":"list", - "member":{ - "shape":"ClassicLinkInstance", - "locationName":"item" - } - }, - "ClassicLoadBalancer":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the load balancer.

", - "locationName":"name" - } - }, - "documentation":"

Describes a Classic Load Balancer.

" - }, - "ClassicLoadBalancers":{ - "type":"list", - "member":{ - "shape":"ClassicLoadBalancer", - "locationName":"item" - }, - "max":5, - "min":1 - }, - "ClassicLoadBalancersConfig":{ - "type":"structure", - "required":["ClassicLoadBalancers"], - "members":{ - "ClassicLoadBalancers":{ - "shape":"ClassicLoadBalancers", - "documentation":"

One or more Classic Load Balancers.

", - "locationName":"classicLoadBalancers" - } - }, - "documentation":"

Describes the Classic Load Balancers to attach to a Spot Fleet. Spot Fleet registers the running Spot Instances with these Classic Load Balancers.

" - }, - "ClientData":{ - "type":"structure", - "members":{ - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment about the disk upload.

" - }, - "UploadEnd":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload ends.

" - }, - "UploadSize":{ - "shape":"Double", - "documentation":"

The size of the uploaded disk image, in GiB.

" - }, - "UploadStart":{ - "shape":"DateTime", - "documentation":"

The time that the disk upload starts.

" - } - }, - "documentation":"

Describes the client-specific data.

" - }, - "ConfirmProductInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "ProductCode" - ], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "ProductCode":{ - "shape":"String", - "documentation":"

The product code. This must be a product code that you own.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ConfirmProductInstance.

" - }, - "ConfirmProductInstanceResult":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.

", - "locationName":"ownerId" - }, - "Return":{ - "shape":"Boolean", - "documentation":"

The return value of the request. Returns true if the specified product code is owned by the requester and associated with the specified instance.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ConfirmProductInstance.

" - }, - "ConnectionNotification":{ - "type":"structure", - "members":{ - "ConnectionNotificationId":{ - "shape":"String", - "documentation":"

The ID of the notification.

", - "locationName":"connectionNotificationId" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the endpoint service.

", - "locationName":"serviceId" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "ConnectionNotificationType":{ - "shape":"ConnectionNotificationType", - "documentation":"

The type of notification.

", - "locationName":"connectionNotificationType" - }, - "ConnectionNotificationArn":{ - "shape":"String", - "documentation":"

The ARN of the SNS topic for the notification.

", - "locationName":"connectionNotificationArn" - }, - "ConnectionEvents":{ - "shape":"ValueStringList", - "documentation":"

The events for the notification. Valid values are Accept, Connect, Delete, and Reject.

", - "locationName":"connectionEvents" - }, - "ConnectionNotificationState":{ - "shape":"ConnectionNotificationState", - "documentation":"

The state of the notification.

", - "locationName":"connectionNotificationState" - } - }, - "documentation":"

Describes a connection notification for a VPC endpoint or VPC endpoint service.

" - }, - "ConnectionNotificationSet":{ - "type":"list", - "member":{ - "shape":"ConnectionNotification", - "locationName":"item" - } - }, - "ConnectionNotificationState":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "ConnectionNotificationType":{ - "type":"string", - "enum":["Topic"] - }, - "ContainerFormat":{ - "type":"string", - "enum":["ova"] - }, - "ConversionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ConversionTask":{ - "type":"structure", - "members":{ - "ConversionTaskId":{ - "shape":"String", - "documentation":"

The ID of the conversion task.

", - "locationName":"conversionTaskId" - }, - "ExpirationTime":{ - "shape":"String", - "documentation":"

The time when the task expires. If the upload isn't complete before the expiration time, we automatically cancel the task.

", - "locationName":"expirationTime" - }, - "ImportInstance":{ - "shape":"ImportInstanceTaskDetails", - "documentation":"

If the task is for importing an instance, this contains information about the import instance task.

", - "locationName":"importInstance" - }, - "ImportVolume":{ - "shape":"ImportVolumeTaskDetails", - "documentation":"

If the task is for importing a volume, this contains information about the import volume task.

", - "locationName":"importVolume" - }, - "State":{ - "shape":"ConversionTaskState", - "documentation":"

The state of the conversion task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the conversion task.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the task.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a conversion task.

" - }, - "ConversionTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "CopyFpgaImageRequest":{ - "type":"structure", - "required":[ - "SourceFpgaImageId", - "SourceRegion" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "SourceFpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the source AFI.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the new AFI.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name for the new AFI. The default is the name of the source AFI.

" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The region that contains the source AFI.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - } - } - }, - "CopyFpgaImageResult":{ - "type":"structure", - "members":{ - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the new AFI.

", - "locationName":"fpgaImageId" - } - } - }, - "CopyImageRequest":{ - "type":"structure", - "required":[ - "Name", - "SourceImageId", - "SourceRegion" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new AMI in the destination region.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshots of the copied image should be encrypted. The default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. If a KmsKeyId is specified, the Encrypted flag must also be set.

The CMK identifier may be provided in any of the following formats:

  • Key ID

  • Key alias, in the form alias/ExampleAlias

  • ARN using key ID. The ID ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

  • ARN using key alias. The alias ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the alias namespace, and then the CMK alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.

AWS parses KmsKeyId asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.

The specified CMK must exist in the region that the snapshot is being copied to.

", - "locationName":"kmsKeyId" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the new AMI in the destination region.

" - }, - "SourceImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI to copy.

" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The name of the region that contains the AMI to copy.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CopyImage.

" - }, - "CopyImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CopyImage.

" - }, - "CopySnapshotRequest":{ - "type":"structure", - "required":[ - "SourceRegion", - "SourceSnapshotId" - ], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the EBS snapshot.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region to use in the PresignedUrl parameter of a snapshot copy operation. This parameter is only valid for specifying the destination region in a PresignedUrl parameter, where it is required.

The snapshot copy is sent to the regional endpoint that you sent the HTTP request to (for example, ec2.us-east-1.amazonaws.com). With the AWS CLI, this is specified using the --region parameter or the default region in your AWS configuration file.

", - "locationName":"destinationRegion" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the destination snapshot should be encrypted. You can encrypt a copy of an unencrypted snapshot using this flag, but you cannot use it to create an unencrypted copy from an encrypted snapshot. Your default CMK for EBS is used unless a non-default AWS Key Management Service (AWS KMS) CMK is specified with KmsKeyId. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. If a KmsKeyId is specified, the Encrypted flag must also be set.

The CMK identifier may be provided in any of the following formats:

  • Key ID

  • Key alias

  • ARN using key ID. The ID ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

  • ARN using key alias. The alias ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the alias namespace, and then the CMK alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.

AWS parses KmsKeyId asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. The action will eventually fail.

", - "locationName":"kmsKeyId" - }, - "PresignedUrl":{ - "shape":"String", - "documentation":"

When you copy an encrypted source snapshot using the Amazon EC2 Query API, you must supply a pre-signed URL. This parameter is optional for unencrypted snapshots. For more information, see Query Requests.

The PresignedUrl should use the snapshot source endpoint, the CopySnapshot action, and include the SourceRegion, SourceSnapshotId, and DestinationRegion parameters. The PresignedUrl must be signed using AWS Signature Version 4. Because EBS snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic that is described in Authenticating Requests by Using Query Parameters (AWS Signature Version 4) in the Amazon Simple Storage Service API Reference. An invalid or improperly signed PresignedUrl will cause the copy operation to fail asynchronously, and the snapshot will move to an error state.

", - "locationName":"presignedUrl" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The ID of the region that contains the snapshot to be copied.

" - }, - "SourceSnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to copy.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CopySnapshot.

" - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the new snapshot.

", - "locationName":"snapshotId" - } - }, - "documentation":"

Contains the output of CopySnapshot.

" - }, - "CpuOptions":{ - "type":"structure", - "members":{ - "CoreCount":{ - "shape":"Integer", - "documentation":"

The number of CPU cores for the instance.

", - "locationName":"coreCount" - }, - "ThreadsPerCore":{ - "shape":"Integer", - "documentation":"

The number of threads per CPU core.

", - "locationName":"threadsPerCore" - } - }, - "documentation":"

The CPU options for the instance.

" - }, - "CpuOptionsRequest":{ - "type":"structure", - "members":{ - "CoreCount":{ - "shape":"Integer", - "documentation":"

The number of CPU cores for the instance.

" - }, - "ThreadsPerCore":{ - "shape":"Integer", - "documentation":"

The number of threads per CPU core. To disable Intel Hyper-Threading Technology for the instance, specify a value of 1. Otherwise, specify the default value of 2.

" - } - }, - "documentation":"

The CPU options for the instance. Both the core count and threads per core must be specified in the request.

" - }, - "CreateCustomerGatewayRequest":{ - "type":"structure", - "required":[ - "BgpAsn", - "PublicIp", - "Type" - ], - "members":{ - "BgpAsn":{ - "shape":"Integer", - "documentation":"

For devices that support BGP, the customer gateway's BGP ASN.

Default: 65000

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

", - "locationName":"IpAddress" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection that this customer gateway supports (ipsec.1).

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateCustomerGateway.

" - }, - "CreateCustomerGatewayResult":{ - "type":"structure", - "members":{ - "CustomerGateway":{ - "shape":"CustomerGateway", - "documentation":"

Information about the customer gateway.

", - "locationName":"customerGateway" - } - }, - "documentation":"

Contains the output of CreateCustomerGateway.

" - }, - "CreateDefaultSubnetRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the default subnet.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - } - }, - "CreateDefaultSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - } - }, - "CreateDefaultVpcRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - }, - "documentation":"

Contains the parameters for CreateDefaultVpc.

" - }, - "CreateDefaultVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - }, - "documentation":"

Contains the output of CreateDefaultVpc.

" - }, - "CreateDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpConfigurations"], - "members":{ - "DhcpConfigurations":{ - "shape":"NewDhcpConfigurationList", - "documentation":"

A DHCP configuration option.

", - "locationName":"dhcpConfiguration" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateDhcpOptions.

" - }, - "CreateDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptions", - "documentation":"

A set of DHCP options.

", - "locationName":"dhcpOptions" - } - }, - "documentation":"

Contains the output of CreateDhcpOptions.

" - }, - "CreateEgressOnlyInternetGatewayRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for which to create the egress-only internet gateway.

" - } - } - }, - "CreateEgressOnlyInternetGatewayResult":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "EgressOnlyInternetGateway":{ - "shape":"EgressOnlyInternetGateway", - "documentation":"

Information about the egress-only internet gateway.

", - "locationName":"egressOnlyInternetGateway" - } - } - }, - "CreateFleetRequest":{ - "type":"structure", - "required":[ - "LaunchTemplateConfigs", - "TargetCapacitySpecification" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - }, - "SpotOptions":{ - "shape":"SpotOptionsRequest", - "documentation":"

Describes the configuration of Spot Instances in an EC2 Fleet.

" - }, - "OnDemandOptions":{ - "shape":"OnDemandOptionsRequest", - "documentation":"

The allocation strategy of On-Demand Instances in an EC2 Fleet.

" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"FleetExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.

" - }, - "LaunchTemplateConfigs":{ - "shape":"FleetLaunchTemplateConfigListRequest", - "documentation":"

The configuration for the EC2 Fleet.

" - }, - "TargetCapacitySpecification":{ - "shape":"TargetCapacitySpecificationRequest", - "documentation":"

The TotalTargetCapacity, OnDemandTargetCapacity, SpotTargetCapacity, and DefaultCapacityType structure.

" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running instances should be terminated when the EC2 Fleet expires.

" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the EC2 Fleet only requests the target capacity, or also attempts to maintain it. If you request a certain target capacity, EC2 Fleet only places the required requests. It does not attempt to replenish instances if capacity is diminished, and does not submit requests in alternative capacity pools if capacity is unavailable. To maintain a certain target capacity, EC2 Fleet places the required requests to meet this target capacity. It also automatically replenishes any interrupted Spot Instances. Default: maintain.

" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new EC2 Fleet requests are placed or able to fulfill the request. The default end date is 7 days from the current date.

" - }, - "ReplaceUnhealthyInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether EC2 Fleet should replace unhealthy instances.

" - }, - "TagSpecifications":{ - "shape":"TagSpecificationList", - "documentation":"

The key-value pair for tagging the EC2 Fleet request on creation. The value for ResourceType must be fleet, otherwise the fleet request fails. To tag instances at launch, specify the tags in the launch template. For information about tagging after launch, see Tagging Your Resources.

", - "locationName":"TagSpecification" - } - } - }, - "CreateFleetResult":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

", - "locationName":"fleetId" - } - } - }, - "CreateFlowLogsRequest":{ - "type":"structure", - "required":[ - "ResourceIds", - "ResourceType", - "TrafficType" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that's used to post flow logs to a log group.

" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the log group.

" - }, - "ResourceIds":{ - "shape":"ValueStringList", - "documentation":"

One or more subnet, network interface, or VPC IDs.

Constraints: Maximum of 1000 resources

", - "locationName":"ResourceId" - }, - "ResourceType":{ - "shape":"FlowLogsResourceType", - "documentation":"

The type of resource on which to create the flow log.

" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic to log.

" - }, - "LogDestinationType":{ - "shape":"LogDestinationType", - "documentation":"

Specifies the type of destination to which the flow log data is to be published. Flow log data can be published to CloudWatch Logs or Amazon S3. To publish flow log data to CloudWatch Logs, specify cloud-watch-logs. To publish flow log data to Amazon S3, specify s3.

Default: cloud-watch-logs

" - }, - "LogDestination":{ - "shape":"String", - "documentation":"

Specifies the destination to which the flow log data is to be published. Flow log data can be published to an CloudWatch Logs log group or an Amazon S3 bucket. The value specified for this parameter depends on the value specified for LogDestinationType.

If LogDestinationType is not specified or cloud-watch-logs, specify the Amazon Resource Name (ARN) of the CloudWatch Logs log group.

If LogDestinationType is s3, specify the ARN of the Amazon S3 bucket. You can also specify a subfolder in the bucket. To specify a subfolder in the bucket, use the following ARN format: bucket_ARN/subfolder_name/. For example, to specify a subfolder named my-logs in a bucket named my-bucket, use the following ARN: arn:aws:s3:::my-bucket/my-logs/.

" - } - }, - "documentation":"

Contains the parameters for CreateFlowLogs.

" - }, - "CreateFlowLogsResult":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - }, - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the flow logs.

", - "locationName":"flowLogIdSet" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be created successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of CreateFlowLogs.

" - }, - "CreateFpgaImageRequest":{ - "type":"structure", - "required":["InputStorageLocation"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InputStorageLocation":{ - "shape":"StorageLocation", - "documentation":"

The location of the encrypted design checkpoint in Amazon S3. The input must be a tarball.

" - }, - "LogsStorageLocation":{ - "shape":"StorageLocation", - "documentation":"

The location in Amazon S3 for the output logs.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the AFI.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the AFI.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - } - } - }, - "CreateFpgaImageResult":{ - "type":"structure", - "members":{ - "FpgaImageId":{ - "shape":"String", - "documentation":"

The FPGA image identifier (AFI ID).

", - "locationName":"fpgaImageId" - }, - "FpgaImageGlobalId":{ - "shape":"String", - "documentation":"

The global FPGA image identifier (AGFI ID).

", - "locationName":"fpgaImageGlobalId" - } - } - }, - "CreateImageRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Name" - ], - "members":{ - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

Information about one or more block device mappings.

", - "locationName":"blockDeviceMapping" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the new image.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the new image.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "NoReboot":{ - "shape":"Boolean", - "documentation":"

By default, Amazon EC2 attempts to shut down and reboot the instance before creating the image. If the 'No Reboot' option is set, Amazon EC2 doesn't shut down the instance before creating the image. When this option is used, file system integrity on the created image can't be guaranteed.

", - "locationName":"noReboot" - } - }, - "documentation":"

Contains the parameters for CreateImage.

" - }, - "CreateImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the new AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of CreateImage.

" - }, - "CreateInstanceExportTaskRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

", - "locationName":"description" - }, - "ExportToS3Task":{ - "shape":"ExportToS3TaskSpecification", - "documentation":"

The format and location for an instance export task.

", - "locationName":"exportToS3" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Contains the parameters for CreateInstanceExportTask.

" - }, - "CreateInstanceExportTaskResult":{ - "type":"structure", - "members":{ - "ExportTask":{ - "shape":"ExportTask", - "documentation":"

Information about the instance export task.

", - "locationName":"exportTask" - } - }, - "documentation":"

Contains the output for CreateInstanceExportTask.

" - }, - "CreateInternetGatewayRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateInternetGateway.

" - }, - "CreateInternetGatewayResult":{ - "type":"structure", - "members":{ - "InternetGateway":{ - "shape":"InternetGateway", - "documentation":"

Information about the internet gateway.

", - "locationName":"internetGateway" - } - }, - "documentation":"

Contains the output of CreateInternetGateway.

" - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

Constraints: Up to 255 ASCII characters

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateKeyPair.

" - }, - "CreateLaunchTemplateRequest":{ - "type":"structure", - "required":[ - "LaunchTemplateName", - "LaunchTemplateData" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

A name for the launch template.

" - }, - "VersionDescription":{ - "shape":"VersionDescription", - "documentation":"

A description for the first version of the launch template.

" - }, - "LaunchTemplateData":{ - "shape":"RequestLaunchTemplateData", - "documentation":"

The information for the launch template.

" - } - } - }, - "CreateLaunchTemplateResult":{ - "type":"structure", - "members":{ - "LaunchTemplate":{ - "shape":"LaunchTemplate", - "documentation":"

Information about the launch template.

", - "locationName":"launchTemplate" - } - } - }, - "CreateLaunchTemplateVersionRequest":{ - "type":"structure", - "required":["LaunchTemplateData"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - }, - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "SourceVersion":{ - "shape":"String", - "documentation":"

The version number of the launch template version on which to base the new version. The new version inherits the same launch parameters as the source version, except for parameters that you specify in LaunchTemplateData.

" - }, - "VersionDescription":{ - "shape":"VersionDescription", - "documentation":"

A description for the version of the launch template.

" - }, - "LaunchTemplateData":{ - "shape":"RequestLaunchTemplateData", - "documentation":"

The information for the launch template.

" - } - } - }, - "CreateLaunchTemplateVersionResult":{ - "type":"structure", - "members":{ - "LaunchTemplateVersion":{ - "shape":"LaunchTemplateVersion", - "documentation":"

Information about the launch template version.

", - "locationName":"launchTemplateVersion" - } - } - }, - "CreateNatGatewayRequest":{ - "type":"structure", - "required":[ - "AllocationId", - "SubnetId" - ], - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of an Elastic IP address to associate with the NAT gateway. If the Elastic IP address is associated with another resource, you must first disassociate it.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

Constraint: Maximum 64 ASCII characters.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The subnet in which to create the NAT gateway.

" - } - }, - "documentation":"

Contains the parameters for CreateNatGateway.

" - }, - "CreateNatGatewayResult":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", - "locationName":"clientToken" - }, - "NatGateway":{ - "shape":"NatGateway", - "documentation":"

Information about the NAT gateway.

", - "locationName":"natGateway" - } - }, - "documentation":"

Contains the output of CreateNatGateway.

" - }, - "CreateNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "Egress", - "NetworkAclId", - "Protocol", - "RuleAction", - "RuleNumber" - ], - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is an egress rule (rule is applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP or ICMPv6 type and code. Required if specifying the ICMP protocol, or protocol 58 (ICMPv6) with an IPv6 CIDR block.

", - "locationName":"Icmp" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 network range to allow or deny, in CIDR notation (for example 2001:db8:1234:1a00::/64).

", - "locationName":"ipv6CidrBlock" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 or all means all protocols. If you specify all, -1, or a protocol number other than 6 (tcp), 17 (udp), or 1 (icmp), traffic on all ports is allowed, regardless of any ports or ICMP types or codes that you specify. If you specify protocol 58 (ICMPv6) and specify an IPv4 CIDR block, traffic for all ICMP types and codes allowed, regardless of any that you specify. If you specify protocol 58 (ICMPv6) and specify an IPv6 CIDR block, you must specify an ICMP type and code.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry (for example, 100). ACL entries are processed in ascending order by rule number.

Constraints: Positive integer from 1 to 32766. The range 32767 to 65535 is reserved for internal use.

", - "locationName":"ruleNumber" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAclEntry.

" - }, - "CreateNetworkAclRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateNetworkAcl.

" - }, - "CreateNetworkAclResult":{ - "type":"structure", - "members":{ - "NetworkAcl":{ - "shape":"NetworkAcl", - "documentation":"

Information about the network ACL.

", - "locationName":"networkAcl" - } - }, - "documentation":"

Contains the output of CreateNetworkAcl.

" - }, - "CreateNetworkInterfacePermissionRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "Permission" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "AwsAccountId":{ - "shape":"String", - "documentation":"

The AWS account ID.

" - }, - "AwsService":{ - "shape":"String", - "documentation":"

The AWS service. Currently not supported.

" - }, - "Permission":{ - "shape":"InterfacePermissionType", - "documentation":"

The type of permission to grant.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - }, - "documentation":"

Contains the parameters for CreateNetworkInterfacePermission.

" - }, - "CreateNetworkInterfacePermissionResult":{ - "type":"structure", - "members":{ - "InterfacePermission":{ - "shape":"NetworkInterfacePermission", - "documentation":"

Information about the permission for the network interface.

", - "locationName":"interfacePermission" - } - }, - "documentation":"

Contains the output of CreateNetworkInterfacePermission.

" - }, - "CreateNetworkInterfaceRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

", - "locationName":"ipv6AddressCount" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressList", - "documentation":"

One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. You can't use this option if you're specifying a number of IPv6 addresses.

", - "locationName":"ipv6Addresses" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IPv4 address of the network interface. If you don't specify an IPv4 address, Amazon EC2 selects one for you from the subnet's IPv4 CIDR range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

", - "locationName":"privateIpAddress" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IPv4 addresses.

", - "locationName":"privateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses.

The number of IP addresses you can assign to a network interface varies by instance type. For more information, see IP Addresses Per ENI Per Instance Type in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet to associate with the network interface.

", - "locationName":"subnetId" - } - }, - "documentation":"

Contains the parameters for CreateNetworkInterface.

" - }, - "CreateNetworkInterfaceResult":{ - "type":"structure", - "members":{ - "NetworkInterface":{ - "shape":"NetworkInterface", - "documentation":"

Information about the network interface.

", - "locationName":"networkInterface" - } - }, - "documentation":"

Contains the output of CreateNetworkInterface.

" - }, - "CreatePlacementGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "Strategy" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

A name for the placement group. Must be unique within the scope of your account for the region.

Constraints: Up to 255 ASCII characters

", - "locationName":"groupName" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - }, - "documentation":"

Contains the parameters for CreatePlacementGroup.

" - }, - "CreateReservedInstancesListingRequest":{ - "type":"structure", - "required":[ - "ClientToken", - "InstanceCount", - "PriceSchedules", - "ReservedInstancesId" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.

", - "locationName":"instanceCount" - }, - "PriceSchedules":{ - "shape":"PriceScheduleSpecificationList", - "documentation":"

A list specifying the price of the Standard Reserved Instance for each month remaining in the Reserved Instance term.

", - "locationName":"priceSchedules" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the active Standard Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Contains the parameters for CreateReservedInstancesListing.

" - }, - "CreateReservedInstancesListingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Standard Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of CreateReservedInstancesListing.

" - }, - "CreateRouteRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR address block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationIpv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block used for the destination match. Routing decisions are based on the most specific match.

", - "locationName":"destinationIpv6CidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EgressOnlyInternetGatewayId":{ - "shape":"String", - "documentation":"

[IPv6 traffic only] The ID of an egress-only internet gateway.

", - "locationName":"egressOnlyInternetGatewayId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an internet gateway or virtual private gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

", - "locationName":"instanceId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

[IPv4 traffic only] The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table for the route.

", - "locationName":"routeTableId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for CreateRoute.

" - }, - "CreateRouteResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of CreateRoute.

" - }, - "CreateRouteTableRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for CreateRouteTable.

" - }, - "CreateRouteTableResult":{ - "type":"structure", - "members":{ - "RouteTable":{ - "shape":"RouteTable", - "documentation":"

Information about the route table.

", - "locationName":"routeTable" - } - }, - "documentation":"

Contains the output of CreateRouteTable.

" - }, - "CreateSecurityGroupRequest":{ - "type":"structure", - "required":[ - "Description", - "GroupName" - ], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the security group. This is informational only.

Constraints: Up to 255 characters in length

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

", - "locationName":"GroupDescription" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

Constraints: Up to 255 characters in length. Cannot start with sg-.

Constraints for EC2-Classic: ASCII characters

Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC. Required for EC2-VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateSecurityGroup.

" - }, - "CreateSecurityGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Contains the output of CreateSecurityGroup.

" - }, - "CreateSnapshotRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

" - }, - "TagSpecifications":{ - "shape":"TagSpecificationList", - "documentation":"

The tags to apply to the snapshot during creation.

", - "locationName":"TagSpecification" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateSnapshot.

" - }, - "CreateSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket in which to store the Spot Instance data feed.

", - "locationName":"bucket" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Prefix":{ - "shape":"String", - "documentation":"

A prefix for the data feed file names.

", - "locationName":"prefix" - } - }, - "documentation":"

Contains the parameters for CreateSpotDatafeedSubscription.

" - }, - "CreateSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of CreateSpotDatafeedSubscription.

" - }, - "CreateSubnetRequest":{ - "type":"structure", - "required":[ - "CidrBlock", - "VpcId" - ], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the subnet.

Default: AWS selects one for you. If you create more than one subnet in your VPC, we may not necessarily select a different zone for each subnet.

" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 network range for the subnet, in CIDR notation. For example, 10.0.0.0/24.

" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 network range for the subnet, in CIDR notation. The subnet size must use a /64 prefix length.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateSubnet.

" - }, - "CreateSubnetResult":{ - "type":"structure", - "members":{ - "Subnet":{ - "shape":"Subnet", - "documentation":"

Information about the subnet.

", - "locationName":"subnet" - } - }, - "documentation":"

Contains the output of CreateSubnet.

" - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "Resources", - "Tags" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources to tag. For example, ami-1a2b3c4d.

", - "locationName":"ResourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

", - "locationName":"Tag" - } - }, - "documentation":"

Contains the parameters for CreateTags.

" - }, - "CreateVolumePermission":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The specific group that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"group" - }, - "UserId":{ - "shape":"String", - "documentation":"

The specific AWS account ID that is to be added or removed from a volume's list of create volume permissions.

", - "locationName":"userId" - } - }, - "documentation":"

Describes the user or group to be added or removed from the permissions for a volume.

" - }, - "CreateVolumePermissionList":{ - "type":"list", - "member":{ - "shape":"CreateVolumePermission", - "locationName":"item" - } - }, - "CreateVolumePermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Adds a specific AWS account ID or group to a volume's list of create volume permissions.

" - }, - "Remove":{ - "shape":"CreateVolumePermissionList", - "documentation":"

Removes a specific AWS account ID or group from a volume's list of create volume permissions.

" - } - }, - "documentation":"

Describes modifications to the permissions for a volume.

" - }, - "CreateVolumeRequest":{ - "type":"structure", - "required":["AvailabilityZone"], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"encrypted" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) to provision for the volume, with a maximum ratio of 50 IOPS/GiB. Range is 100 to 32000 IOPS for volumes in most regions. For exceptions, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

This parameter is valid only for Provisioned IOPS SSD (io1) volumes.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. If a KmsKeyId is specified, the Encrypted flag must also be set.

The CMK identifier may be provided in any of the following formats:

  • Key ID

  • Key alias

  • ARN using key ID. The ID ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

  • ARN using key alias. The alias ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the alias namespace, and then the CMK alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.

AWS parses KmsKeyId asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. The action will eventually fail.

" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

Constraints: 1-16384 for gp2, 4-16384 for io1, 500-16384 for st1, 500-16384 for sc1, and 1-1024 for standard. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which to create the volume.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

Defaults: If no volume type is specified, the default is standard in us-east-1, eu-west-1, eu-central-1, us-west-2, us-west-1, sa-east-1, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, us-gov-west-1, and cn-north-1. In all other regions, EBS defaults to gp2.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "TagSpecifications":{ - "shape":"TagSpecificationList", - "documentation":"

The tags to apply to the volume during creation.

", - "locationName":"TagSpecification" - } - }, - "documentation":"

Contains the parameters for CreateVolume.

" - }, - "CreateVpcEndpointConnectionNotificationRequest":{ - "type":"structure", - "required":[ - "ConnectionNotificationArn", - "ConnectionEvents" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the endpoint service.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ConnectionNotificationArn":{ - "shape":"String", - "documentation":"

The ARN of the SNS topic for the notifications.

" - }, - "ConnectionEvents":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint events for which to receive notifications. Valid values are Accept, Connect, Delete, and Reject.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - } - }, - "CreateVpcEndpointConnectionNotificationResult":{ - "type":"structure", - "members":{ - "ConnectionNotification":{ - "shape":"ConnectionNotification", - "documentation":"

Information about the notification.

", - "locationName":"connectionNotification" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - } - }, - "CreateVpcEndpointRequest":{ - "type":"structure", - "required":[ - "VpcId", - "ServiceName" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointType":{ - "shape":"VpcEndpointType", - "documentation":"

The type of endpoint.

Default: Gateway

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the endpoint will be used.

" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The service name. To get a list of available services, use the DescribeVpcEndpointServices request, or get the name from the service provider.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

(Gateway endpoint) A policy to attach to the endpoint that controls access to the service. The policy must be in valid JSON format. If this parameter is not specified, we attach a default policy that allows full access to the service.

" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

(Gateway endpoint) One or more route table IDs.

", - "locationName":"RouteTableId" - }, - "SubnetIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) The ID of one or more subnets in which to create an endpoint network interface.

", - "locationName":"SubnetId" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) The ID of one or more security groups to associate with the endpoint network interface.

", - "locationName":"SecurityGroupId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - }, - "PrivateDnsEnabled":{ - "shape":"Boolean", - "documentation":"

(Interface endpoint) Indicate whether to associate a private hosted zone with the specified VPC. The private hosted zone contains a record set for the default public DNS name for the service for the region (for example, kinesis.us-east-1.amazonaws.com) which resolves to the private IP addresses of the endpoint network interfaces in the VPC. This enables you to make requests to the default public DNS name for the service instead of the public DNS names that are automatically generated by the VPC endpoint service.

To use a private hosted zone, you must set the following VPC attributes to true: enableDnsHostnames and enableDnsSupport. Use ModifyVpcAttribute to set the VPC attributes.

Default: true

" - } - }, - "documentation":"

Contains the parameters for CreateVpcEndpoint.

" - }, - "CreateVpcEndpointResult":{ - "type":"structure", - "members":{ - "VpcEndpoint":{ - "shape":"VpcEndpoint", - "documentation":"

Information about the endpoint.

", - "locationName":"vpcEndpoint" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - }, - "documentation":"

Contains the output of CreateVpcEndpoint.

" - }, - "CreateVpcEndpointServiceConfigurationRequest":{ - "type":"structure", - "required":["NetworkLoadBalancerArns"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "AcceptanceRequired":{ - "shape":"Boolean", - "documentation":"

Indicate whether requests from service consumers to create an endpoint to your service must be accepted. To accept a request, use AcceptVpcEndpointConnections.

" - }, - "NetworkLoadBalancerArns":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARNs) of one or more Network Load Balancers for your service.

", - "locationName":"NetworkLoadBalancerArn" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

" - } - } - }, - "CreateVpcEndpointServiceConfigurationResult":{ - "type":"structure", - "members":{ - "ServiceConfiguration":{ - "shape":"ServiceConfiguration", - "documentation":"

Information about the service configuration.

", - "locationName":"serviceConfiguration" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "locationName":"clientToken" - } - } - }, - "CreateVpcPeeringConnectionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PeerOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the accepter VPC.

Default: Your AWS account ID

", - "locationName":"peerOwnerId" - }, - "PeerVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with which you are creating the VPC peering connection. You must specify this parameter in the request.

", - "locationName":"peerVpcId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the requester VPC. You must specify this parameter in the request.

", - "locationName":"vpcId" - }, - "PeerRegion":{ - "shape":"String", - "documentation":"

The region code for the accepter VPC, if the accepter VPC is located in a region other than the region in which you make the request.

Default: The region in which you make the request.

" - } - }, - "documentation":"

Contains the parameters for CreateVpcPeeringConnection.

" - }, - "CreateVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnection":{ - "shape":"VpcPeeringConnection", - "documentation":"

Information about the VPC peering connection.

", - "locationName":"vpcPeeringConnection" - } - }, - "documentation":"

Contains the output of CreateVpcPeeringConnection.

" - }, - "CreateVpcRequest":{ - "type":"structure", - "required":["CidrBlock"], - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 network range for the VPC, in CIDR notation. For example, 10.0.0.0/16.

" - }, - "AmazonProvidedIpv6CidrBlock":{ - "shape":"Boolean", - "documentation":"

Requests an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC. You cannot specify the range of IP addresses, or the size of the CIDR block.

", - "locationName":"amazonProvidedIpv6CidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy options for instances launched into the VPC. For default, instances are launched with shared tenancy by default. You can launch instances with any tenancy into a shared tenancy VPC. For dedicated, instances are launched as dedicated tenancy instances by default. You can only launch instances with a tenancy of dedicated or host into a dedicated tenancy VPC.

Important: The host value cannot be used with this parameter. Use the default or dedicated values only.

Default: default

", - "locationName":"instanceTenancy" - } - }, - "documentation":"

Contains the parameters for CreateVpc.

" - }, - "CreateVpcResult":{ - "type":"structure", - "members":{ - "Vpc":{ - "shape":"Vpc", - "documentation":"

Information about the VPC.

", - "locationName":"vpc" - } - }, - "documentation":"

Contains the output of CreateVpc.

" - }, - "CreateVpnConnectionRequest":{ - "type":"structure", - "required":[ - "CustomerGatewayId", - "Type", - "VpnGatewayId" - ], - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection (ipsec.1).

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Options":{ - "shape":"VpnConnectionOptionsSpecification", - "documentation":"

The options for the VPN connection.

", - "locationName":"options" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnection.

" - }, - "CreateVpnConnectionResult":{ - "type":"structure", - "members":{ - "VpnConnection":{ - "shape":"VpnConnection", - "documentation":"

Information about the VPN connection.

", - "locationName":"vpnConnection" - } - }, - "documentation":"

Contains the output of CreateVpnConnection.

" - }, - "CreateVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "DestinationCidrBlock", - "VpnConnectionId" - ], - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - }, - "documentation":"

Contains the parameters for CreateVpnConnectionRoute.

" - }, - "CreateVpnGatewayRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the virtual private gateway.

" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection this virtual private gateway supports.

" - }, - "AmazonSideAsn":{ - "shape":"Long", - "documentation":"

A private Autonomous System Number (ASN) for the Amazon side of a BGP session. If you're using a 16-bit ASN, it must be in the 64512 to 65534 range. If you're using a 32-bit ASN, it must be in the 4200000000 to 4294967294 range.

Default: 64512

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for CreateVpnGateway.

" - }, - "CreateVpnGatewayResult":{ - "type":"structure", - "members":{ - "VpnGateway":{ - "shape":"VpnGateway", - "documentation":"

Information about the virtual private gateway.

", - "locationName":"vpnGateway" - } - }, - "documentation":"

Contains the output of CreateVpnGateway.

" - }, - "CreditSpecification":{ - "type":"structure", - "members":{ - "CpuCredits":{ - "shape":"String", - "documentation":"

The credit option for CPU usage of a T2 instance. Valid values are standard and unlimited.

", - "locationName":"cpuCredits" - } - }, - "documentation":"

Describes the credit option for CPU usage of a T2 instance.

" - }, - "CreditSpecificationRequest":{ - "type":"structure", - "required":["CpuCredits"], - "members":{ - "CpuCredits":{ - "shape":"String", - "documentation":"

The credit option for CPU usage of a T2 instance. Valid values are standard and unlimited.

" - } - }, - "documentation":"

The credit option for CPU usage of a T2 instance.

" - }, - "CurrencyCodeValues":{ - "type":"string", - "enum":["USD"] - }, - "CustomerGateway":{ - "type":"structure", - "members":{ - "BgpAsn":{ - "shape":"String", - "documentation":"

The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

", - "locationName":"bgpAsn" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

", - "locationName":"customerGatewayId" - }, - "IpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the customer gateway's outside interface.

", - "locationName":"ipAddress" - }, - "State":{ - "shape":"String", - "documentation":"

The current state of the customer gateway (pending | available | deleting | deleted).

", - "locationName":"state" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of VPN connection the customer gateway supports (ipsec.1).

", - "locationName":"type" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the customer gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a customer gateway.

" - }, - "CustomerGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CustomerGatewayId" - } - }, - "CustomerGatewayList":{ - "type":"list", - "member":{ - "shape":"CustomerGateway", - "locationName":"item" - } - }, - "DatafeedSubscriptionState":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "DateTime":{"type":"timestamp"}, - "DefaultTargetCapacityType":{ - "type":"string", - "enum":[ - "spot", - "on-demand" - ] - }, - "DeleteCustomerGatewayRequest":{ - "type":"structure", - "required":["CustomerGatewayId"], - "members":{ - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteCustomerGateway.

" - }, - "DeleteDhcpOptionsRequest":{ - "type":"structure", - "required":["DhcpOptionsId"], - "members":{ - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the DHCP options set.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteDhcpOptions.

" - }, - "DeleteEgressOnlyInternetGatewayRequest":{ - "type":"structure", - "required":["EgressOnlyInternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "EgressOnlyInternetGatewayId":{ - "shape":"EgressOnlyInternetGatewayId", - "documentation":"

The ID of the egress-only internet gateway.

" - } - } - }, - "DeleteEgressOnlyInternetGatewayResult":{ - "type":"structure", - "members":{ - "ReturnCode":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"returnCode" - } - } - }, - "DeleteFleetError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"DeleteFleetErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the error code.

", - "locationName":"message" - } - }, - "documentation":"

Describes an EC2 Fleet error.

" - }, - "DeleteFleetErrorCode":{ - "type":"string", - "enum":[ - "fleetIdDoesNotExist", - "fleetIdMalformed", - "fleetNotInDeletableState", - "unexpectedError" - ] - }, - "DeleteFleetErrorItem":{ - "type":"structure", - "members":{ - "Error":{ - "shape":"DeleteFleetError", - "documentation":"

The error.

", - "locationName":"error" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

", - "locationName":"fleetId" - } - }, - "documentation":"

Describes an EC2 Fleet that was not successfully deleted.

" - }, - "DeleteFleetErrorSet":{ - "type":"list", - "member":{ - "shape":"DeleteFleetErrorItem", - "locationName":"item" - } - }, - "DeleteFleetSuccessItem":{ - "type":"structure", - "members":{ - "CurrentFleetState":{ - "shape":"FleetStateCode", - "documentation":"

The current state of the EC2 Fleet.

", - "locationName":"currentFleetState" - }, - "PreviousFleetState":{ - "shape":"FleetStateCode", - "documentation":"

The previous state of the EC2 Fleet.

", - "locationName":"previousFleetState" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

", - "locationName":"fleetId" - } - }, - "documentation":"

Describes an EC2 Fleet that was successfully deleted.

" - }, - "DeleteFleetSuccessSet":{ - "type":"list", - "member":{ - "shape":"DeleteFleetSuccessItem", - "locationName":"item" - } - }, - "DeleteFleetsRequest":{ - "type":"structure", - "required":[ - "FleetIds", - "TerminateInstances" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FleetIds":{ - "shape":"FleetIdSet", - "documentation":"

The IDs of the EC2 Fleets.

", - "locationName":"FleetId" - }, - "TerminateInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether to terminate instances for an EC2 Fleet if it is deleted successfully.

" - } - } - }, - "DeleteFleetsResult":{ - "type":"structure", - "members":{ - "SuccessfulFleetDeletions":{ - "shape":"DeleteFleetSuccessSet", - "documentation":"

Information about the EC2 Fleets that are successfully deleted.

", - "locationName":"successfulFleetDeletionSet" - }, - "UnsuccessfulFleetDeletions":{ - "shape":"DeleteFleetErrorSet", - "documentation":"

Information about the EC2 Fleets that are not successfully deleted.

", - "locationName":"unsuccessfulFleetDeletionSet" - } - } - }, - "DeleteFlowLogsRequest":{ - "type":"structure", - "required":["FlowLogIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - } - }, - "documentation":"

Contains the parameters for DeleteFlowLogs.

" - }, - "DeleteFlowLogsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the flow logs that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteFlowLogs.

" - }, - "DeleteFpgaImageRequest":{ - "type":"structure", - "required":["FpgaImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the AFI.

" - } - } - }, - "DeleteFpgaImageResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - } - }, - "DeleteInternetGatewayRequest":{ - "type":"structure", - "required":["InternetGatewayId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the internet gateway.

", - "locationName":"internetGatewayId" - } - }, - "documentation":"

Contains the parameters for DeleteInternetGateway.

" - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["KeyName"], - "members":{ - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteKeyPair.

" - }, - "DeleteLaunchTemplateRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either the launch template ID or launch template name in the request.

" - } - } - }, - "DeleteLaunchTemplateResult":{ - "type":"structure", - "members":{ - "LaunchTemplate":{ - "shape":"LaunchTemplate", - "documentation":"

Information about the launch template.

", - "locationName":"launchTemplate" - } - } - }, - "DeleteLaunchTemplateVersionsRequest":{ - "type":"structure", - "required":["Versions"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "Versions":{ - "shape":"VersionStringList", - "documentation":"

The version numbers of one or more launch template versions to delete.

", - "locationName":"LaunchTemplateVersion" - } - } - }, - "DeleteLaunchTemplateVersionsResponseErrorItem":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

", - "locationName":"launchTemplateId" - }, - "LaunchTemplateName":{ - "shape":"String", - "documentation":"

The name of the launch template.

", - "locationName":"launchTemplateName" - }, - "VersionNumber":{ - "shape":"Long", - "documentation":"

The version number of the launch template.

", - "locationName":"versionNumber" - }, - "ResponseError":{ - "shape":"ResponseError", - "documentation":"

Information about the error.

", - "locationName":"responseError" - } - }, - "documentation":"

Describes a launch template version that could not be deleted.

" - }, - "DeleteLaunchTemplateVersionsResponseErrorSet":{ - "type":"list", - "member":{ - "shape":"DeleteLaunchTemplateVersionsResponseErrorItem", - "locationName":"item" - } - }, - "DeleteLaunchTemplateVersionsResponseSuccessItem":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

", - "locationName":"launchTemplateId" - }, - "LaunchTemplateName":{ - "shape":"String", - "documentation":"

The name of the launch template.

", - "locationName":"launchTemplateName" - }, - "VersionNumber":{ - "shape":"Long", - "documentation":"

The version number of the launch template.

", - "locationName":"versionNumber" - } - }, - "documentation":"

Describes a launch template version that was successfully deleted.

" - }, - "DeleteLaunchTemplateVersionsResponseSuccessSet":{ - "type":"list", - "member":{ - "shape":"DeleteLaunchTemplateVersionsResponseSuccessItem", - "locationName":"item" - } - }, - "DeleteLaunchTemplateVersionsResult":{ - "type":"structure", - "members":{ - "SuccessfullyDeletedLaunchTemplateVersions":{ - "shape":"DeleteLaunchTemplateVersionsResponseSuccessSet", - "documentation":"

Information about the launch template versions that were successfully deleted.

", - "locationName":"successfullyDeletedLaunchTemplateVersionSet" - }, - "UnsuccessfullyDeletedLaunchTemplateVersions":{ - "shape":"DeleteLaunchTemplateVersionsResponseErrorSet", - "documentation":"

Information about the launch template versions that could not be deleted.

", - "locationName":"unsuccessfullyDeletedLaunchTemplateVersionSet" - } - } - }, - "DeleteNatGatewayRequest":{ - "type":"structure", - "required":["NatGatewayId"], - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

" - } - }, - "documentation":"

Contains the parameters for DeleteNatGateway.

" - }, - "DeleteNatGatewayResult":{ - "type":"structure", - "members":{ - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - } - }, - "documentation":"

Contains the output of DeleteNatGateway.

" - }, - "DeleteNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "Egress", - "NetworkAclId", - "RuleNumber" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule.

", - "locationName":"egress" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to delete.

", - "locationName":"ruleNumber" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAclEntry.

" - }, - "DeleteNetworkAclRequest":{ - "type":"structure", - "required":["NetworkAclId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkAcl.

" - }, - "DeleteNetworkInterfacePermissionRequest":{ - "type":"structure", - "required":["NetworkInterfacePermissionId"], - "members":{ - "NetworkInterfacePermissionId":{ - "shape":"String", - "documentation":"

The ID of the network interface permission.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specify true to remove the permission even if the network interface is attached to an instance.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkInterfacePermission.

" - }, - "DeleteNetworkInterfacePermissionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds, otherwise returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output for DeleteNetworkInterfacePermission.

" - }, - "DeleteNetworkInterfaceRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DeleteNetworkInterface.

" - }, - "DeletePlacementGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - } - }, - "documentation":"

Contains the parameters for DeletePlacementGroup.

" - }, - "DeleteRouteRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationCidrBlock" - }, - "DestinationIpv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR range for the route. The value you specify must match the CIDR for the route exactly.

", - "locationName":"destinationIpv6CidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for DeleteRoute.

" - }, - "DeleteRouteTableRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for DeleteRouteTable.

" - }, - "DeleteSecurityGroupRequest":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. Required for a nondefault VPC.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You can specify either the security group name or the security group ID.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSecurityGroup.

" - }, - "DeleteSnapshotRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSnapshot.

" - }, - "DeleteSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSpotDatafeedSubscription.

" - }, - "DeleteSubnetRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteSubnet.

" - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":["Resources"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Resources":{ - "shape":"ResourceIdList", - "documentation":"

The IDs of one or more resources.

", - "locationName":"resourceId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to delete. Specify a tag key and an optional tag value to delete specific tags. If you specify a tag key without a tag value, we delete any tag with this key regardless of its value. If you specify a tag key with an empty string as the tag value, we delete the tag only if its value is an empty string.

If you omit this parameter, we delete all user-defined tags for the specified resources. We do not delete AWS-generated tags (tags that have the aws: prefix).

", - "locationName":"tag" - } - }, - "documentation":"

Contains the parameters for DeleteTags.

" - }, - "DeleteVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteVolume.

" - }, - "DeleteVpcEndpointConnectionNotificationsRequest":{ - "type":"structure", - "required":["ConnectionNotificationIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ConnectionNotificationIds":{ - "shape":"ValueStringList", - "documentation":"

One or more notification IDs.

", - "locationName":"ConnectionNotificationId" - } - } - }, - "DeleteVpcEndpointConnectionNotificationsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the notifications that could not be deleted successfully.

", - "locationName":"unsuccessful" - } - } - }, - "DeleteVpcEndpointServiceConfigurationsRequest":{ - "type":"structure", - "required":["ServiceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of one or more services.

", - "locationName":"ServiceId" - } - } - }, - "DeleteVpcEndpointServiceConfigurationsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the service configurations that were not deleted, if applicable.

", - "locationName":"unsuccessful" - } - } - }, - "DeleteVpcEndpointsRequest":{ - "type":"structure", - "required":["VpcEndpointIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC endpoint IDs.

", - "locationName":"VpcEndpointId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcEndpoints.

" - }, - "DeleteVpcEndpointsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the VPC endpoints that were not successfully deleted.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of DeleteVpcEndpoints.

" - }, - "DeleteVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for DeleteVpcPeeringConnection.

" - }, - "DeleteVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DeleteVpcPeeringConnection.

" - }, - "DeleteVpcRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteVpc.

" - }, - "DeleteVpnConnectionRequest":{ - "type":"structure", - "required":["VpnConnectionId"], - "members":{ - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnection.

" - }, - "DeleteVpnConnectionRouteRequest":{ - "type":"structure", - "required":[ - "DestinationCidrBlock", - "VpnConnectionId" - ], - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer network.

" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

" - } - }, - "documentation":"

Contains the parameters for DeleteVpnConnectionRoute.

" - }, - "DeleteVpnGatewayRequest":{ - "type":"structure", - "required":["VpnGatewayId"], - "members":{ - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeleteVpnGateway.

" - }, - "DeregisterImageRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DeregisterImage.

" - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - "AttributeNames":{ - "shape":"AccountAttributeNameStringList", - "documentation":"

One or more account attribute names.

", - "locationName":"attributeName" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeAccountAttributes.

" - }, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "AccountAttributes":{ - "shape":"AccountAttributeList", - "documentation":"

Information about one or more account attributes.

", - "locationName":"accountAttributeSet" - } - }, - "documentation":"

Contains the output of DescribeAccountAttributes.

" - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Filter names and values are case-sensitive.

  • allocation-id - [EC2-VPC] The allocation ID for the address.

  • association-id - [EC2-VPC] The association ID for the address.

  • domain - Indicates whether the address is for use in EC2-Classic (standard) or in a VPC (vpc).

  • instance-id - The ID of the instance the address is associated with, if any.

  • network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any.

  • network-interface-owner-id - The AWS account ID of the owner.

  • private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address.

  • public-ip - The Elastic IP address.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "PublicIps":{ - "shape":"PublicIpStringList", - "documentation":"

[EC2-Classic] One or more Elastic IP addresses.

Default: Describes all your Elastic IP addresses.

", - "locationName":"PublicIp" - }, - "AllocationIds":{ - "shape":"AllocationIdList", - "documentation":"

[EC2-VPC] One or more allocation IDs.

Default: Describes all your Elastic IP addresses.

", - "locationName":"AllocationId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeAddresses.

" - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

Information about one or more Elastic IP addresses.

", - "locationName":"addressesSet" - } - }, - "documentation":"

Contains the output of DescribeAddresses.

" - }, - "DescribeAggregateIdFormatRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - } - }, - "DescribeAggregateIdFormatResult":{ - "type":"structure", - "members":{ - "UseLongIdsAggregated":{ - "shape":"Boolean", - "documentation":"

Indicates whether all resource types in the region are configured to use longer IDs. This value is only true if all users are configured to use longer IDs for all resources types in the region.

", - "locationName":"useLongIdsAggregated" - }, - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about each resource's ID format.

", - "locationName":"statusSet" - } - } - }, - "DescribeAvailabilityZonesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • message - Information about the Availability Zone.

  • region-name - The name of the region for the Availability Zone (for example, us-east-1).

  • state - The state of the Availability Zone (available | information | impaired | unavailable).

  • zone-name - The name of the Availability Zone (for example, us-east-1a).

", - "locationName":"Filter" - }, - "ZoneNames":{ - "shape":"ZoneNameStringList", - "documentation":"

The names of one or more Availability Zones.

", - "locationName":"ZoneName" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeAvailabilityZones.

" - }, - "DescribeAvailabilityZonesResult":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

Information about one or more Availability Zones.

", - "locationName":"availabilityZoneInfo" - } - }, - "documentation":"

Contains the output of DescribeAvailabiltyZones.

" - }, - "DescribeBundleTasksRequest":{ - "type":"structure", - "members":{ - "BundleIds":{ - "shape":"BundleIdStringList", - "documentation":"

One or more bundle task IDs.

Default: Describes all your bundle tasks.

", - "locationName":"BundleId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeBundleTasks.

" - }, - "DescribeBundleTasksResult":{ - "type":"structure", - "members":{ - "BundleTasks":{ - "shape":"BundleTaskList", - "documentation":"

Information about one or more bundle tasks.

", - "locationName":"bundleInstanceTasksSet" - } - }, - "documentation":"

Contains the output of DescribeBundleTasks.

" - }, - "DescribeClassicLinkInstancesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-id - The ID of a VPC security group that's associated with the instance.

  • instance-id - The ID of the instance.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC to which the instance is linked.

    vpc-id - The ID of the VPC that the instance is linked to.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs. Must be instances linked to a VPC through ClassicLink.

", - "locationName":"InstanceId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000. If MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the instance IDs parameter in the same request.

Constraint: If the value is greater than 1000, we return only 1000 items.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeClassicLinkInstances.

" - }, - "DescribeClassicLinkInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"ClassicLinkInstanceList", - "documentation":"

Information about one or more linked EC2-Classic instances.

", - "locationName":"instancesSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeClassicLinkInstances.

" - }, - "DescribeConversionTaskList":{ - "type":"list", - "member":{ - "shape":"ConversionTask", - "locationName":"item" - } - }, - "DescribeConversionTasksRequest":{ - "type":"structure", - "members":{ - "ConversionTaskIds":{ - "shape":"ConversionIdStringList", - "documentation":"

One or more conversion task IDs.

", - "locationName":"conversionTaskId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeConversionTasks.

" - }, - "DescribeConversionTasksResult":{ - "type":"structure", - "members":{ - "ConversionTasks":{ - "shape":"DescribeConversionTaskList", - "documentation":"

Information about the conversion tasks.

", - "locationName":"conversionTasks" - } - }, - "documentation":"

Contains the output for DescribeConversionTasks.

" - }, - "DescribeCustomerGatewaysRequest":{ - "type":"structure", - "members":{ - "CustomerGatewayIds":{ - "shape":"CustomerGatewayIdStringList", - "documentation":"

One or more customer gateway IDs.

Default: Describes all your customer gateways.

", - "locationName":"CustomerGatewayId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • bgp-asn - The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

  • customer-gateway-id - The ID of the customer gateway.

  • ip-address - The IP address of the customer gateway's Internet-routable external interface.

  • state - The state of the customer gateway (pending | available | deleting | deleted).

  • type - The type of customer gateway. Currently, the only supported type is ipsec.1.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeCustomerGateways.

" - }, - "DescribeCustomerGatewaysResult":{ - "type":"structure", - "members":{ - "CustomerGateways":{ - "shape":"CustomerGatewayList", - "documentation":"

Information about one or more customer gateways.

", - "locationName":"customerGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeCustomerGateways.

" - }, - "DescribeDhcpOptionsRequest":{ - "type":"structure", - "members":{ - "DhcpOptionsIds":{ - "shape":"DhcpOptionsIdStringList", - "documentation":"

The IDs of one or more DHCP options sets.

Default: Describes all your DHCP options sets.

", - "locationName":"DhcpOptionsId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • dhcp-options-id - The ID of a set of DHCP options.

  • key - The key for one of the options (for example, domain-name).

  • value - The value for one of the options.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeDhcpOptions.

" - }, - "DescribeDhcpOptionsResult":{ - "type":"structure", - "members":{ - "DhcpOptions":{ - "shape":"DhcpOptionsList", - "documentation":"

Information about one or more DHCP options sets.

", - "locationName":"dhcpOptionsSet" - } - }, - "documentation":"

Contains the output of DescribeDhcpOptions.

" - }, - "DescribeEgressOnlyInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "EgressOnlyInternetGatewayIds":{ - "shape":"EgressOnlyInternetGatewayIdList", - "documentation":"

One or more egress-only internet gateway IDs.

", - "locationName":"EgressOnlyInternetGatewayId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000. If MaxResults is given a value larger than 1000, only 1000 results are returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - } - }, - "DescribeEgressOnlyInternetGatewaysResult":{ - "type":"structure", - "members":{ - "EgressOnlyInternetGateways":{ - "shape":"EgressOnlyInternetGatewayList", - "documentation":"

Information about the egress-only internet gateways.

", - "locationName":"egressOnlyInternetGatewaySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - } - } - }, - "DescribeElasticGpusRequest":{ - "type":"structure", - "members":{ - "ElasticGpuIds":{ - "shape":"ElasticGpuIdSet", - "documentation":"

One or more Elastic GPU IDs.

", - "locationName":"ElasticGpuId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone in which the Elastic GPU resides.

  • elastic-gpu-health - The status of the Elastic GPU (OK | IMPAIRED).

  • elastic-gpu-state - The state of the Elastic GPU (ATTACHED).

  • elastic-gpu-type - The type of Elastic GPU; for example, eg1.medium.

  • instance-id - The ID of the instance to which the Elastic GPU is associated.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - } - } - }, - "DescribeElasticGpusResult":{ - "type":"structure", - "members":{ - "ElasticGpuSet":{ - "shape":"ElasticGpuSet", - "documentation":"

Information about the Elastic GPUs.

", - "locationName":"elasticGpuSet" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The total number of items to return. If the total number of items available is more than the value specified in max-items then a Next-Token will be provided in the output that you can use to resume pagination.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "ExportTaskIds":{ - "shape":"ExportTaskIdStringList", - "documentation":"

One or more export task IDs.

", - "locationName":"exportTaskId" - } - }, - "documentation":"

Contains the parameters for DescribeExportTasks.

" - }, - "DescribeExportTasksResult":{ - "type":"structure", - "members":{ - "ExportTasks":{ - "shape":"ExportTaskList", - "documentation":"

Information about the export tasks.

", - "locationName":"exportTaskSet" - } - }, - "documentation":"

Contains the output for DescribeExportTasks.

" - }, - "DescribeFleetHistoryRequest":{ - "type":"structure", - "required":[ - "FleetId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "EventType":{ - "shape":"FleetEventType", - "documentation":"

The type of events to describe. By default, all events are described.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The start date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

" - } - } - }, - "DescribeFleetHistoryResult":{ - "type":"structure", - "members":{ - "HistoryRecords":{ - "shape":"HistoryRecordSet", - "documentation":"

Information about the events in the history of the EC2 Fleet.

", - "locationName":"historyRecordSet" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC Fleet.

", - "locationName":"fleetId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The start date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - } - } - }, - "DescribeFleetInstancesRequest":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-type - The instance type.

", - "locationName":"Filter" - } - } - }, - "DescribeFleetInstancesResult":{ - "type":"structure", - "members":{ - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. This list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

", - "locationName":"fleetId" - } - } - }, - "DescribeFleetsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "FleetIds":{ - "shape":"FleetIdSet", - "documentation":"

The ID of the EC2 Fleets.

", - "locationName":"FleetId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • activity-status - The progress of the EC2 Fleet ( error | pending-fulfillment | pending-termination | fulfilled).

  • excess-capacity-termination-policy - Indicates whether to terminate running instances if the target capacity is decreased below the current EC2 Fleet size (true | false).

  • fleet-state - The state of the EC2 Fleet (submitted | active | deleted | failed | deleted-running | deleted-terminating | modifying).

  • replace-unhealthy-instances - Indicates whether EC2 Fleet should replace unhealthy instances (true | false).

  • type - The type of request (request | maintain).

", - "locationName":"Filter" - } - } - }, - "DescribeFleetsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "Fleets":{ - "shape":"FleetSet", - "documentation":"

Information about the EC2 Fleets.

", - "locationName":"fleetSet" - } - } - }, - "DescribeFlowLogsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • deliver-log-status - The status of the logs delivery (SUCCESS | FAILED).

  • log-destination-type - The type of destination to which the flow log publishes data. Possible destination types include cloud-watch-logs and S3.

  • flow-log-id - The ID of the flow log.

  • log-group-name - The name of the log group.

  • resource-id - The ID of the VPC, subnet, or network interface.

  • traffic-type - The type of traffic (ACCEPT | REJECT | ALL).

" - }, - "FlowLogIds":{ - "shape":"ValueStringList", - "documentation":"

One or more flow log IDs.

", - "locationName":"FlowLogId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000. If MaxResults is given a value larger than 1000, only 1000 results are returned. You cannot specify this parameter and the flow log IDs parameter in the same request.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeFlowLogs.

" - }, - "DescribeFlowLogsResult":{ - "type":"structure", - "members":{ - "FlowLogs":{ - "shape":"FlowLogSet", - "documentation":"

Information about the flow logs.

", - "locationName":"flowLogSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeFlowLogs.

" - }, - "DescribeFpgaImageAttributeRequest":{ - "type":"structure", - "required":[ - "FpgaImageId", - "Attribute" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the AFI.

" - }, - "Attribute":{ - "shape":"FpgaImageAttributeName", - "documentation":"

The AFI attribute.

" - } - } - }, - "DescribeFpgaImageAttributeResult":{ - "type":"structure", - "members":{ - "FpgaImageAttribute":{ - "shape":"FpgaImageAttribute", - "documentation":"

Information about the attribute.

", - "locationName":"fpgaImageAttribute" - } - } - }, - "DescribeFpgaImagesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FpgaImageIds":{ - "shape":"FpgaImageIdList", - "documentation":"

One or more AFI IDs.

", - "locationName":"FpgaImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the AFI by owner. Specify an AWS account ID, self (owner is the sender of the request), or an AWS owner alias (valid values are amazon | aws-marketplace).

", - "locationName":"Owner" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • create-time - The creation time of the AFI.

  • fpga-image-id - The FPGA image identifier (AFI ID).

  • fpga-image-global-id - The global FPGA image identifier (AGFI ID).

  • name - The name of the AFI.

  • owner-id - The AWS account ID of the AFI owner.

  • product-code - The product code.

  • shell-version - The version of the AWS Shell that was used to create the bitstream.

  • state - The state of the AFI (pending | failed | available | unavailable).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • update-time - The time of the most recent update.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next page of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "DescribeFpgaImagesResult":{ - "type":"structure", - "members":{ - "FpgaImages":{ - "shape":"FpgaImageList", - "documentation":"

Information about one or more FPGA images.

", - "locationName":"fpgaImageSet" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostReservationOfferingsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family of the offering (for example, m4).

  • payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).

" - }, - "MaxDuration":{ - "shape":"Integer", - "documentation":"

This is the maximum duration of the reservation to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error.

" - }, - "MinDuration":{ - "shape":"Integer", - "documentation":"

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation offering.

" - } - } - }, - "DescribeHostReservationOfferingsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "OfferingSet":{ - "shape":"HostOfferingSet", - "documentation":"

Information about the offerings.

", - "locationName":"offeringSet" - } - } - }, - "DescribeHostReservationsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-family - The instance family (for example, m4).

  • payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).

  • state - The state of the reservation (payment-pending | payment-failed | active | retired).

" - }, - "HostReservationIdSet":{ - "shape":"HostReservationIdSet", - "documentation":"

One or more host reservation IDs.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500.If maxResults is given a larger value than 500, you receive an error.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

" - } - } - }, - "DescribeHostReservationsResult":{ - "type":"structure", - "members":{ - "HostReservationSet":{ - "shape":"HostReservationSet", - "documentation":"

Details about the reservation's configuration.

", - "locationName":"hostReservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeHostsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • auto-placement - Whether auto-placement is enabled or disabled (on | off).

  • availability-zone - The Availability Zone of the host.

  • client-token - The idempotency token that you provided when you allocated the host.

  • host-reservation-id - The ID of the reservation assigned to this host.

  • instance-type - The instance type size that the Dedicated Host is configured to support.

  • state - The allocation state of the Dedicated Host (available | under-assessment | permanent-failure | released | released-permanent-failure).

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"filter" - }, - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts. The IDs are used for targeted instance launches.

", - "locationName":"hostId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error. You cannot specify this parameter and the host IDs parameter in the same request.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeHosts.

" - }, - "DescribeHostsResult":{ - "type":"structure", - "members":{ - "Hosts":{ - "shape":"HostList", - "documentation":"

Information about the Dedicated Hosts.

", - "locationName":"hostSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeHosts.

" - }, - "DescribeIamInstanceProfileAssociationsRequest":{ - "type":"structure", - "members":{ - "AssociationIds":{ - "shape":"AssociationIdList", - "documentation":"

One or more IAM instance profile associations.

", - "locationName":"AssociationId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-id - The ID of the instance.

  • state - The state of the association (associating | associated | disassociating | disassociated).

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to request the next page of results.

" - } - } - }, - "DescribeIamInstanceProfileAssociationsResult":{ - "type":"structure", - "members":{ - "IamInstanceProfileAssociations":{ - "shape":"IamInstanceProfileAssociationSet", - "documentation":"

Information about one or more IAM instance profile associations.

", - "locationName":"iamInstanceProfileAssociationSet" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeIdFormatRequest":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway

" - } - }, - "documentation":"

Contains the parameters for DescribeIdFormat.

" - }, - "DescribeIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resource.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdFormat.

" - }, - "DescribeIdentityIdFormatRequest":{ - "type":"structure", - "required":["PrincipalArn"], - "members":{ - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM role, IAM user, or the root user.

", - "locationName":"principalArn" - }, - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway

", - "locationName":"resource" - } - }, - "documentation":"

Contains the parameters for DescribeIdentityIdFormat.

" - }, - "DescribeIdentityIdFormatResult":{ - "type":"structure", - "members":{ - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

Information about the ID format for the resources.

", - "locationName":"statusSet" - } - }, - "documentation":"

Contains the output of DescribeIdentityIdFormat.

" - }, - "DescribeImageAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "ImageId" - ], - "members":{ - "Attribute":{ - "shape":"ImageAttributeName", - "documentation":"

The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use DescribeImages to get information about the block device mapping for the AMI.

" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeImageAttribute.

" - }, - "DescribeImagesRequest":{ - "type":"structure", - "members":{ - "ExecutableUsers":{ - "shape":"ExecutableByStringList", - "documentation":"

Scopes the images by users with explicit launch permissions. Specify an AWS account ID, self (the sender of the request), or all (public AMIs).

", - "locationName":"ExecutableBy" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • architecture - The image architecture (i386 | x86_64).

  • block-device-mapping.delete-on-termination - A Boolean value that indicates whether the Amazon EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name specified in the block device mapping (for example, /dev/sdh or xvdh).

  • block-device-mapping.snapshot-id - The ID of the snapshot used for the EBS volume.

  • block-device-mapping.volume-size - The volume size of the EBS volume, in GiB.

  • block-device-mapping.volume-type - The volume type of the EBS volume (gp2 | io1 | st1 | sc1 | standard).

  • description - The description of the image (provided during image creation).

  • ena-support - A Boolean that indicates whether enhanced networking with ENA is enabled.

  • hypervisor - The hypervisor type (ovm | xen).

  • image-id - The ID of the image.

  • image-type - The image type (machine | kernel | ramdisk).

  • is-public - A Boolean that indicates whether the image is public.

  • kernel-id - The kernel ID.

  • manifest-location - The location of the image manifest.

  • name - The name of the AMI (provided during image creation).

  • owner-alias - String value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

  • owner-id - The AWS account ID of the image owner.

  • platform - The platform. To only list Windows-based AMIs, use windows.

  • product-code - The product code.

  • product-code.type - The type of the product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • root-device-name - The device name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • state - The state of the image (available | pending | failed).

  • state-reason-code - The reason code for the state change.

  • state-reason-message - The message for the state change.

  • sriov-net-support - A value of simple indicates that enhanced networking with the Intel 82599 VF interface is enabled.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • virtualization-type - The virtualization type (paravirtual | hvm).

", - "locationName":"Filter" - }, - "ImageIds":{ - "shape":"ImageIdStringList", - "documentation":"

One or more image IDs.

Default: Describes all images available to you.

", - "locationName":"ImageId" - }, - "Owners":{ - "shape":"OwnerStringList", - "documentation":"

Filters the images by the owner. Specify an AWS account ID, self (owner is the sender of the request), or an AWS owner alias (valid values are amazon | aws-marketplace | microsoft). Omitting this option returns all images for which you have launch permissions, regardless of ownership.

", - "locationName":"Owner" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeImages.

" - }, - "DescribeImagesResult":{ - "type":"structure", - "members":{ - "Images":{ - "shape":"ImageList", - "documentation":"

Information about one or more images.

", - "locationName":"imagesSet" - } - }, - "documentation":"

Contains the output of DescribeImages.

" - }, - "DescribeImportImageTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import image task IDs.

", - "locationName":"ImportTaskId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportImageTasks.

" - }, - "DescribeImportImageTasksResult":{ - "type":"structure", - "members":{ - "ImportImageTasks":{ - "shape":"ImportImageTaskList", - "documentation":"

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importImageTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportImageTasks.

" - }, - "DescribeImportSnapshotTasksRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

" - }, - "ImportTaskIds":{ - "shape":"ImportTaskIdList", - "documentation":"

A list of import snapshot task IDs.

", - "locationName":"ImportTaskId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token that indicates the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeImportSnapshotTasks.

" - }, - "DescribeImportSnapshotTasksResult":{ - "type":"structure", - "members":{ - "ImportSnapshotTasks":{ - "shape":"ImportSnapshotTaskList", - "documentation":"

A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.

", - "locationName":"importSnapshotTaskSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to get the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeImportSnapshotTasks.

" - }, - "DescribeInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "InstanceId" - ], - "members":{ - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The instance attribute.

Note: The enaSupport attribute is not supported at this time.

", - "locationName":"attribute" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceAttribute.

" - }, - "DescribeInstanceCreditSpecificationsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • instance-id - The ID of the instance.

", - "locationName":"Filter" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 1000 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - } - }, - "DescribeInstanceCreditSpecificationsResult":{ - "type":"structure", - "members":{ - "InstanceCreditSpecifications":{ - "shape":"InstanceCreditSpecificationList", - "documentation":"

Information about the credit option for CPU usage of an instance.

", - "locationName":"instanceCreditSpecificationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeInstanceStatusRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone of the instance.

  • event.code - The code for the scheduled event (instance-reboot | system-reboot | system-maintenance | instance-retirement | instance-stop).

  • event.description - A description of the event.

  • event.not-after - The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • event.not-before - The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z).

  • instance-state-code - The code for the instance state, as a 16-bit unsigned integer. The high byte is used for internal purposes and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-status.reachability - Filters on instance status where the name is reachability (passed | failed | initializing | insufficient-data).

  • instance-status.status - The status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

  • system-status.reachability - Filters on system status where the name is reachability (passed | failed | initializing | insufficient-data).

  • system-status.status - The system status of the instance (ok | impaired | initializing | insufficient-data | not-applicable).

", - "locationName":"Filter" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

Constraints: Maximum 100 explicitly specified instance IDs.

", - "locationName":"InstanceId" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "IncludeAllInstances":{ - "shape":"Boolean", - "documentation":"

When true, includes the health status for all instances. When false, includes the health status for running instances only.

Default: false

", - "locationName":"includeAllInstances" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceStatus.

" - }, - "DescribeInstanceStatusResult":{ - "type":"structure", - "members":{ - "InstanceStatuses":{ - "shape":"InstanceStatusList", - "documentation":"

One or more instance status descriptions.

", - "locationName":"instanceStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstanceStatus.

" - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • affinity - The affinity setting for an instance running on a Dedicated Host (default | host).

  • architecture - The instance architecture (i386 | x86_64).

  • availability-zone - The Availability Zone of the instance.

  • block-device-mapping.attach-time - The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z.

  • block-device-mapping.delete-on-termination - A Boolean that indicates whether the EBS volume is deleted on instance termination.

  • block-device-mapping.device-name - The device name specified in the block device mapping (for example, /dev/sdh or xvdh).

  • block-device-mapping.status - The status for the EBS volume (attaching | attached | detaching | detached).

  • block-device-mapping.volume-id - The volume ID of the EBS volume.

  • client-token - The idempotency token you provided when you launched the instance.

  • dns-name - The public DNS name of the instance.

  • group-id - The ID of the security group for the instance. EC2-Classic only.

  • group-name - The name of the security group for the instance. EC2-Classic only.

  • host-id - The ID of the Dedicated Host on which the instance is running, if applicable.

  • hypervisor - The hypervisor type of the instance (ovm | xen).

  • iam-instance-profile.arn - The instance profile associated with the instance. Specified as an ARN.

  • image-id - The ID of the image used to launch the instance.

  • instance-id - The ID of the instance.

  • instance-lifecycle - Indicates whether this is a Spot Instance or a Scheduled Instance (spot | scheduled).

  • instance-state-code - The state of the instance, as a 16-bit unsigned integer. The high byte is used for internal purposes and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).

  • instance-state-name - The state of the instance (pending | running | shutting-down | terminated | stopping | stopped).

  • instance-type - The type of instance (for example, t2.micro).

  • instance.group-id - The ID of the security group for the instance.

  • instance.group-name - The name of the security group for the instance.

  • ip-address - The public IPv4 address of the instance.

  • kernel-id - The kernel ID.

  • key-name - The name of the key pair used when the instance was launched.

  • launch-index - When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).

  • launch-time - The time when the instance was launched.

  • monitoring-state - Indicates whether detailed monitoring is enabled (disabled | enabled).

  • network-interface.addresses.private-ip-address - The private IPv4 address associated with the network interface.

  • network-interface.addresses.primary - Specifies whether the IPv4 address of the network interface is the primary private IPv4 address.

  • network-interface.addresses.association.public-ip - The ID of the association of an Elastic IP address (IPv4) with a network interface.

  • network-interface.addresses.association.ip-owner-id - The owner ID of the private IPv4 address associated with the network interface.

  • network-interface.association.public-ip - The address of the Elastic IP address (IPv4) bound to the network interface.

  • network-interface.association.ip-owner-id - The owner of the Elastic IP address (IPv4) associated with the network interface.

  • network-interface.association.allocation-id - The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.

  • network-interface.association.association-id - The association ID returned when the network interface was associated with an IPv4 address.

  • network-interface.attachment.attachment-id - The ID of the interface attachment.

  • network-interface.attachment.instance-id - The ID of the instance to which the network interface is attached.

  • network-interface.attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • network-interface.attachment.device-index - The device index to which the network interface is attached.

  • network-interface.attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • network-interface.attachment.attach-time - The time that the network interface was attached to an instance.

  • network-interface.attachment.delete-on-termination - Specifies whether the attachment is deleted when an instance is terminated.

  • network-interface.availability-zone - The Availability Zone for the network interface.

  • network-interface.description - The description of the network interface.

  • network-interface.group-id - The ID of a security group associated with the network interface.

  • network-interface.group-name - The name of a security group associated with the network interface.

  • network-interface.ipv6-addresses.ipv6-address - The IPv6 address associated with the network interface.

  • network-interface.mac-address - The MAC address of the network interface.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.owner-id - The ID of the owner of the network interface.

  • network-interface.private-dns-name - The private DNS name of the network interface.

  • network-interface.requester-id - The requester ID for the network interface.

  • network-interface.requester-managed - Indicates whether the network interface is being managed by AWS.

  • network-interface.status - The status of the network interface (available) | in-use).

  • network-interface.source-dest-check - Whether the network interface performs source/destination checking. A value of true means that checking is enabled, and false means that checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • network-interface.subnet-id - The ID of the subnet for the network interface.

  • network-interface.vpc-id - The ID of the VPC for the network interface.

  • owner-id - The AWS account ID of the instance owner.

  • placement-group-name - The name of the placement group for the instance.

  • platform - The platform. Use windows if you have Windows instances; otherwise, leave blank.

  • private-dns-name - The private IPv4 DNS name of the instance.

  • private-ip-address - The private IPv4 address of the instance.

  • product-code - The product code associated with the AMI used to launch the instance.

  • product-code.type - The type of product code (devpay | marketplace).

  • ramdisk-id - The RAM disk ID.

  • reason - The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • reservation-id - The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you get one reservation ID. If you launch ten instances using the same launch request, you also get one reservation ID.

  • root-device-name - The device name of the root device volume (for example, /dev/sda1).

  • root-device-type - The type of the root device volume (ebs | instance-store).

  • source-dest-check - Indicates whether the instance performs source/destination checking. A value of true means that checking is enabled, and false means that checking is disabled. The value must be false for the instance to perform network address translation (NAT) in your VPC.

  • spot-instance-request-id - The ID of the Spot Instance request.

  • state-reason-code - The reason code for the state change.

  • state-reason-message - A message that describes the state change.

  • subnet-id - The ID of the subnet for the instance.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources that have a tag with a specific key, regardless of the tag value.

  • tenancy - The tenancy of an instance (dedicated | default | host).

  • virtualization-type - The virtualization type of the instance (paravirtual | hvm).

  • vpc-id - The ID of the VPC that the instance is running in.

", - "locationName":"Filter" - }, - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Default: Describes all your instances.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeInstances.

" - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Reservations":{ - "shape":"ReservationList", - "documentation":"

Zero or more reservations.

", - "locationName":"reservationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeInstances.

" - }, - "DescribeInternetGatewaysRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.state - The current state of the attachment between the gateway and the VPC (available). Present only if a VPC is attached.

  • attachment.vpc-id - The ID of an attached VPC.

  • internet-gateway-id - The ID of the Internet gateway.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more internet gateway IDs.

Default: Describes all your internet gateways.

", - "locationName":"internetGatewayId" - } - }, - "documentation":"

Contains the parameters for DescribeInternetGateways.

" - }, - "DescribeInternetGatewaysResult":{ - "type":"structure", - "members":{ - "InternetGateways":{ - "shape":"InternetGatewayList", - "documentation":"

Information about one or more internet gateways.

", - "locationName":"internetGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeInternetGateways.

" - }, - "DescribeKeyPairsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • fingerprint - The fingerprint of the key pair.

  • key-name - The name of the key pair.

", - "locationName":"Filter" - }, - "KeyNames":{ - "shape":"KeyNameStringList", - "documentation":"

One or more key pair names.

Default: Describes all your key pairs.

", - "locationName":"KeyName" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeKeyPairs.

" - }, - "DescribeKeyPairsResult":{ - "type":"structure", - "members":{ - "KeyPairs":{ - "shape":"KeyPairList", - "documentation":"

Information about one or more key pairs.

", - "locationName":"keySet" - } - }, - "documentation":"

Contains the output of DescribeKeyPairs.

" - }, - "DescribeLaunchTemplateVersionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "Versions":{ - "shape":"VersionStringList", - "documentation":"

One or more versions of the launch template.

", - "locationName":"LaunchTemplateVersion" - }, - "MinVersion":{ - "shape":"String", - "documentation":"

The version number after which to describe launch template versions.

" - }, - "MaxVersion":{ - "shape":"String", - "documentation":"

The version number up to which to describe launch template versions.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 1 and 200.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • create-time - The time the launch template version was created.

  • ebs-optimized - A boolean that indicates whether the instance is optimized for Amazon EBS I/O.

  • iam-instance-profile - The ARN of the IAM instance profile.

  • image-id - The ID of the AMI.

  • instance-type - The instance type.

  • is-default-version - A boolean that indicates whether the launch template version is the default version.

  • kernel-id - The kernel ID.

  • ram-disk-id - The RAM disk ID.

", - "locationName":"Filter" - } - } - }, - "DescribeLaunchTemplateVersionsResult":{ - "type":"structure", - "members":{ - "LaunchTemplateVersions":{ - "shape":"LaunchTemplateVersionSet", - "documentation":"

Information about the launch template versions.

", - "locationName":"launchTemplateVersionSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeLaunchTemplatesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "LaunchTemplateIds":{ - "shape":"ValueStringList", - "documentation":"

One or more launch template IDs.

", - "locationName":"LaunchTemplateId" - }, - "LaunchTemplateNames":{ - "shape":"LaunchTemplateNameStringList", - "documentation":"

One or more launch template names.

", - "locationName":"LaunchTemplateName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • create-time - The time the launch template was created.

  • launch-template-name - The name of the launch template.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000.

" - } - } - }, - "DescribeLaunchTemplatesResult":{ - "type":"structure", - "members":{ - "LaunchTemplates":{ - "shape":"LaunchTemplateSet", - "documentation":"

Information about the launch templates.

", - "locationName":"launchTemplates" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeMovingAddressesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • moving-status - The status of the Elastic IP address (MovingToVpc | RestoringToClassic).

", - "locationName":"filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value outside of this range, an error is returned.

Default: If no value is provided, the default is 1000.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "PublicIps":{ - "shape":"ValueStringList", - "documentation":"

One or more Elastic IP addresses.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for DescribeMovingAddresses.

" - }, - "DescribeMovingAddressesResult":{ - "type":"structure", - "members":{ - "MovingAddressStatuses":{ - "shape":"MovingAddressStatusSet", - "documentation":"

The status for each Elastic IP address.

", - "locationName":"movingAddressStatusSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeMovingAddresses.

" - }, - "DescribeNatGatewaysRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • nat-gateway-id - The ID of the NAT gateway.

  • state - The state of the NAT gateway (pending | failed | available | deleting | deleted).

  • subnet-id - The ID of the subnet in which the NAT gateway resides.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC in which the NAT gateway resides.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NatGatewayIds":{ - "shape":"ValueStringList", - "documentation":"

One or more NAT gateway IDs.

", - "locationName":"NatGatewayId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - }, - "documentation":"

Contains the parameters for DescribeNatGateways.

" - }, - "DescribeNatGatewaysResult":{ - "type":"structure", - "members":{ - "NatGateways":{ - "shape":"NatGatewayList", - "documentation":"

Information about the NAT gateways.

", - "locationName":"natGatewaySet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeNatGateways.

" - }, - "DescribeNetworkAclsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.association-id - The ID of an association ID for the ACL.

  • association.network-acl-id - The ID of the network ACL involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • default - Indicates whether the ACL is the default network ACL for the VPC.

  • entry.cidr - The IPv4 CIDR range specified in the entry.

  • entry.egress - Indicates whether the entry applies to egress traffic.

  • entry.icmp.code - The ICMP code specified in the entry, if any.

  • entry.icmp.type - The ICMP type specified in the entry, if any.

  • entry.ipv6-cidr - The IPv6 CIDR range specified in the entry.

  • entry.port-range.from - The start of the port range specified in the entry.

  • entry.port-range.to - The end of the port range specified in the entry.

  • entry.protocol - The protocol specified in the entry (tcp | udp | icmp or a protocol number).

  • entry.rule-action - Allows or denies the matching traffic (allow | deny).

  • entry.rule-number - The number of an entry (in other words, rule) in the ACL's set of entries.

  • network-acl-id - The ID of the network ACL.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC for the network ACL.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclIds":{ - "shape":"ValueStringList", - "documentation":"

One or more network ACL IDs.

Default: Describes all your network ACLs.

", - "locationName":"NetworkAclId" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkAcls.

" - }, - "DescribeNetworkAclsResult":{ - "type":"structure", - "members":{ - "NetworkAcls":{ - "shape":"NetworkAclList", - "documentation":"

Information about one or more network ACLs.

", - "locationName":"networkAclSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkAcls.

" - }, - "DescribeNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "Attribute":{ - "shape":"NetworkInterfaceAttribute", - "documentation":"

The attribute of the network interface. This parameter is required.

", - "locationName":"attribute" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfaceAttributeResult":{ - "type":"structure", - "members":{ - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The attachment (if any) of the network interface.

", - "locationName":"attachment" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

The description of the network interface.

", - "locationName":"description" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaceAttribute.

" - }, - "DescribeNetworkInterfacePermissionsRequest":{ - "type":"structure", - "members":{ - "NetworkInterfacePermissionIds":{ - "shape":"NetworkInterfacePermissionIdList", - "documentation":"

One or more network interface permission IDs.

", - "locationName":"NetworkInterfacePermissionId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • network-interface-permission.network-interface-permission-id - The ID of the permission.

  • network-interface-permission.network-interface-id - The ID of the network interface.

  • network-interface-permission.aws-account-id - The AWS account ID.

  • network-interface-permission.aws-service - The AWS service.

  • network-interface-permission.permission - The type of permission (INSTANCE-ATTACH | EIP-ASSOCIATE).

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. If this parameter is not specified, up to 50 results are returned by default.

" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfacePermissions.

" - }, - "DescribeNetworkInterfacePermissionsResult":{ - "type":"structure", - "members":{ - "NetworkInterfacePermissions":{ - "shape":"NetworkInterfacePermissionList", - "documentation":"

The network interface permissions.

", - "locationName":"networkInterfacePermissions" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output for DescribeNetworkInterfacePermissions.

" - }, - "DescribeNetworkInterfacesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • addresses.private-ip-address - The private IPv4 addresses associated with the network interface.

  • addresses.primary - Whether the private IPv4 address is the primary IP address associated with the network interface.

  • addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address (IPv4).

  • addresses.association.owner-id - The owner ID of the addresses associated with the network interface.

  • association.association-id - The association ID returned when the network interface was associated with an IPv4 address.

  • association.allocation-id - The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.

  • association.ip-owner-id - The owner of the Elastic IP address (IPv4) associated with the network interface.

  • association.public-ip - The address of the Elastic IP address (IPv4) bound to the network interface.

  • association.public-dns-name - The public DNS name for the network interface (IPv4).

  • attachment.attachment-id - The ID of the interface attachment.

  • attachment.attach.time - The time that the network interface was attached to an instance.

  • attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.

  • attachment.device-index - The device index to which the network interface is attached.

  • attachment.instance-id - The ID of the instance to which the network interface is attached.

  • attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.

  • attachment.nat-gateway-id - The ID of the NAT gateway to which the network interface is attached.

  • attachment.status - The status of the attachment (attaching | attached | detaching | detached).

  • availability-zone - The Availability Zone of the network interface.

  • description - The description of the network interface.

  • group-id - The ID of a security group associated with the network interface.

  • group-name - The name of a security group associated with the network interface.

  • ipv6-addresses.ipv6-address - An IPv6 address associated with the network interface.

  • mac-address - The MAC address of the network interface.

  • network-interface-id - The ID of the network interface.

  • owner-id - The AWS account ID of the network interface owner.

  • private-ip-address - The private IPv4 address or addresses of the network interface.

  • private-dns-name - The private DNS name of the network interface (IPv4).

  • requester-id - The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).

  • requester-managed - Indicates whether the network interface is being managed by an AWS service (for example, AWS Management Console, Auto Scaling, and so on).

  • source-desk-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.

  • status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.

  • subnet-id - The ID of the subnet for the network interface.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC for the network interface.

", - "locationName":"filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceIds":{ - "shape":"NetworkInterfaceIdList", - "documentation":"

One or more network interface IDs.

Default: Describes all your network interfaces.

", - "locationName":"NetworkInterfaceId" - } - }, - "documentation":"

Contains the parameters for DescribeNetworkInterfaces.

" - }, - "DescribeNetworkInterfacesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaces":{ - "shape":"NetworkInterfaceList", - "documentation":"

Information about one or more network interfaces.

", - "locationName":"networkInterfaceSet" - } - }, - "documentation":"

Contains the output of DescribeNetworkInterfaces.

" - }, - "DescribePlacementGroupsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • group-name - The name of the placement group.

  • state - The state of the placement group (pending | available | deleting | deleted).

  • strategy - The strategy of the placement group (cluster | spread).

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupNames":{ - "shape":"PlacementGroupStringList", - "documentation":"

One or more placement group names.

Default: Describes all your placement groups, or only those otherwise specified.

", - "locationName":"groupName" - } - }, - "documentation":"

Contains the parameters for DescribePlacementGroups.

" - }, - "DescribePlacementGroupsResult":{ - "type":"structure", - "members":{ - "PlacementGroups":{ - "shape":"PlacementGroupList", - "documentation":"

One or more placement groups.

", - "locationName":"placementGroupSet" - } - }, - "documentation":"

Contains the output of DescribePlacementGroups.

" - }, - "DescribePrefixListsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value specified is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - }, - "PrefixListIds":{ - "shape":"ValueStringList", - "documentation":"

One or more prefix list IDs.

", - "locationName":"PrefixListId" - } - }, - "documentation":"

Contains the parameters for DescribePrefixLists.

" - }, - "DescribePrefixListsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - }, - "PrefixLists":{ - "shape":"PrefixListSet", - "documentation":"

All available prefix lists.

", - "locationName":"prefixListSet" - } - }, - "documentation":"

Contains the output of DescribePrefixLists.

" - }, - "DescribePrincipalIdFormatRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Resources":{ - "shape":"ResourceList", - "documentation":"

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway

", - "locationName":"Resource" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - } - } - }, - "DescribePrincipalIdFormatResult":{ - "type":"structure", - "members":{ - "Principals":{ - "shape":"PrincipalIdFormatList", - "documentation":"

Information about the ID format settings for the ARN.

", - "locationName":"principalSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeRegionsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • endpoint - The endpoint of the region (for example, ec2.us-east-1.amazonaws.com).

  • region-name - The name of the region (for example, us-east-1).

", - "locationName":"Filter" - }, - "RegionNames":{ - "shape":"RegionNameStringList", - "documentation":"

The names of one or more regions.

", - "locationName":"RegionName" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeRegions.

" - }, - "DescribeRegionsResult":{ - "type":"structure", - "members":{ - "Regions":{ - "shape":"RegionList", - "documentation":"

Information about one or more regions.

", - "locationName":"regionInfo" - } - }, - "documentation":"

Contains the output of DescribeRegions.

" - }, - "DescribeReservedInstancesListingsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • reserved-instances-id - The ID of the Reserved Instances.

  • reserved-instances-listing-id - The ID of the Reserved Instances listing.

  • status - The status of the Reserved Instance listing (pending | active | cancelled | closed).

  • status-message - The reason for the status.

", - "locationName":"Filter" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance IDs.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

One or more Reserved Instance listing IDs.

", - "locationName":"reservedInstancesListingId" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesListingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesListings":{ - "shape":"ReservedInstancesListingList", - "documentation":"

Information about the Reserved Instance listing.

", - "locationName":"reservedInstancesListingsSet" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesListings.

" - }, - "DescribeReservedInstancesModificationsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • client-token - The idempotency token for the modification request.

  • create-date - The time when the modification request was created.

  • effective-date - The time when the modification becomes effective.

  • modification-result.reserved-instances-id - The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled.

  • modification-result.target-configuration.availability-zone - The Availability Zone for the new Reserved Instances.

  • modification-result.target-configuration.instance-count - The number of new Reserved Instances.

  • modification-result.target-configuration.instance-type - The instance type of the new Reserved Instances.

  • modification-result.target-configuration.platform - The network platform of the new Reserved Instances (EC2-Classic | EC2-VPC).

  • reserved-instances-id - The ID of the Reserved Instances modified.

  • reserved-instances-modification-id - The ID of the modification request.

  • status - The status of the Reserved Instances modification request (processing | fulfilled | failed).

  • status-message - The reason for the status.

  • update-date - The time when the modification request was last updated.

", - "locationName":"Filter" - }, - "ReservedInstancesModificationIds":{ - "shape":"ReservedInstancesModificationIdStringList", - "documentation":"

IDs for the submitted modification request.

", - "locationName":"ReservedInstancesModificationId" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesModificationsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ReservedInstancesModifications":{ - "shape":"ReservedInstancesModificationList", - "documentation":"

The Reserved Instance modification information.

", - "locationName":"reservedInstancesModificationsSet" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesModifications.

" - }, - "DescribeReservedInstancesOfferingsRequest":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000 | 94608000).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • marketplace - Set to true to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from both AWS and the Reserved Instance Marketplace are listed.

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC))

  • reserved-instances-offering-id - The Reserved Instances offering ID.

  • scope - The scope of the Reserved Instance (Availability Zone or Region).

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "IncludeMarketplace":{ - "shape":"Boolean", - "documentation":"

Include Reserved Instance Marketplace offerings in the response.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type that the reservation will cover (for example, m1.small). For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "MaxDuration":{ - "shape":"Long", - "documentation":"

The maximum duration (in seconds) to filter when searching for offerings.

Default: 94608000 (3 years)

" - }, - "MaxInstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to filter when searching for offerings.

Default: 20

" - }, - "MinDuration":{ - "shape":"Long", - "documentation":"

The minimum duration (in seconds) to filter when searching for offerings.

Default: 2592000 (1 month)

" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

The offering class of the Reserved Instance. Can be standard or convertible.

" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description. Instances that include (Amazon VPC) in the description are for use with Amazon VPC.

" - }, - "ReservedInstancesOfferingIds":{ - "shape":"ReservedInstancesOfferingIdStringList", - "documentation":"

One or more Reserved Instances offering IDs.

", - "locationName":"ReservedInstancesOfferingId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated Instances).

Important: The host value cannot be used with this parameter. Use the default or dedicated values only.

Default: default

", - "locationName":"instanceTenancy" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. The maximum is 100.

Default: 100

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesOfferingsResult":{ - "type":"structure", - "members":{ - "ReservedInstancesOfferings":{ - "shape":"ReservedInstancesOfferingList", - "documentation":"

A list of Reserved Instances offerings.

", - "locationName":"reservedInstancesOfferingsSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeReservedInstancesOfferings.

" - }, - "DescribeReservedInstancesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone where the Reserved Instance can be used.

  • duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000).

  • end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).

  • fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).

  • instance-type - The instance type that is covered by the reservation.

  • scope - The scope of the Reserved Instance (Region or Availability Zone).

  • product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC)).

  • reserved-instances-id - The ID of the Reserved Instance.

  • start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).

  • state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

", - "locationName":"Filter" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

Describes whether the Reserved Instance is Standard or Convertible.

" - }, - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

One or more Reserved Instance IDs.

Default: Describes all your Reserved Instances, or only those otherwise specified.

", - "locationName":"ReservedInstancesId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

", - "locationName":"offeringType" - } - }, - "documentation":"

Contains the parameters for DescribeReservedInstances.

" - }, - "DescribeReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstances":{ - "shape":"ReservedInstancesList", - "documentation":"

A list of Reserved Instances.

", - "locationName":"reservedInstancesSet" - } - }, - "documentation":"

Contains the output for DescribeReservedInstances.

" - }, - "DescribeRouteTablesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • association.route-table-association-id - The ID of an association ID for the route table.

  • association.route-table-id - The ID of the route table involved in the association.

  • association.subnet-id - The ID of the subnet involved in the association.

  • association.main - Indicates whether the route table is the main route table for the VPC (true | false). Route tables that do not have an association ID are not returned in the response.

  • route-table-id - The ID of the route table.

  • route.destination-cidr-block - The IPv4 CIDR range specified in a route in the table.

  • route.destination-ipv6-cidr-block - The IPv6 CIDR range specified in a route in the route table.

  • route.destination-prefix-list-id - The ID (prefix) of the AWS service specified in a route in the table.

  • route.egress-only-internet-gateway-id - The ID of an egress-only Internet gateway specified in a route in the route table.

  • route.gateway-id - The ID of a gateway specified in a route in the table.

  • route.instance-id - The ID of an instance specified in a route in the table.

  • route.nat-gateway-id - The ID of a NAT gateway.

  • route.origin - Describes how the route was created. CreateRouteTable indicates that the route was automatically created when the route table was created; CreateRoute indicates that the route was manually added to the route table; EnableVgwRoutePropagation indicates that the route was propagated by route propagation.

  • route.state - The state of a route in the route table (active | blackhole). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).

  • route.vpc-peering-connection-id - The ID of a VPC peering connection specified in a route in the table.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC for the route table.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

One or more route table IDs.

Default: Describes all your route tables.

", - "locationName":"RouteTableId" - } - }, - "documentation":"

Contains the parameters for DescribeRouteTables.

" - }, - "DescribeRouteTablesResult":{ - "type":"structure", - "members":{ - "RouteTables":{ - "shape":"RouteTableList", - "documentation":"

Information about one or more route tables.

", - "locationName":"routeTableSet" - } - }, - "documentation":"

Contains the output of DescribeRouteTables.

" - }, - "DescribeScheduledInstanceAvailabilityRequest":{ - "type":"structure", - "required":[ - "FirstSlotStartTimeRange", - "Recurrence" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - }, - "FirstSlotStartTimeRange":{ - "shape":"SlotDateTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "MaxSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.

" - }, - "MinSlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrenceRequest", - "documentation":"

The schedule recurrence.

" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstanceAvailabilityResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceAvailabilitySet":{ - "shape":"ScheduledInstanceAvailabilitySet", - "documentation":"

Information about the available Scheduled Instances.

", - "locationName":"scheduledInstanceAvailabilitySet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstanceAvailability.

" - }, - "DescribeScheduledInstancesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone (for example, us-west-2a).

  • instance-type - The instance type (for example, c4.large).

  • network-platform - The network platform (EC2-Classic or EC2-VPC).

  • platform - The platform (Linux/UNIX or Windows).

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 100. To retrieve the remaining results, make another call with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

" - }, - "ScheduledInstanceIds":{ - "shape":"ScheduledInstanceIdRequestSet", - "documentation":"

One or more Scheduled Instance IDs.

", - "locationName":"ScheduledInstanceId" - }, - "SlotStartTimeRange":{ - "shape":"SlotStartTimeRangeRequest", - "documentation":"

The time period for the first schedule to start.

" - } - }, - "documentation":"

Contains the parameters for DescribeScheduledInstances.

" - }, - "DescribeScheduledInstancesResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "ScheduledInstanceSet":{ - "shape":"ScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of DescribeScheduledInstances.

" - }, - "DescribeSecurityGroupReferencesRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"GroupIds", - "documentation":"

One or more security group IDs in your account.

" - } - } - }, - "DescribeSecurityGroupReferencesResult":{ - "type":"structure", - "members":{ - "SecurityGroupReferenceSet":{ - "shape":"SecurityGroupReferences", - "documentation":"

Information about the VPCs with the referencing security groups.

", - "locationName":"securityGroupReferenceSet" - } - } - }, - "DescribeSecurityGroupsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.

  • description - The description of the security group.

  • egress.ip-permission.cidr - An IPv4 CIDR block for an outbound security group rule.

  • egress.ip-permission.from-port - For an outbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.

  • egress.ip-permission.group-id - The ID of a security group that has been referenced in an outbound security group rule.

  • egress.ip-permission.group-name - The name of a security group that has been referenced in an outbound security group rule.

  • egress.ip-permission.ipv6-cidr - An IPv6 CIDR block for an outbound security group rule.

  • egress.ip-permission.prefix-list-id - The ID (prefix) of the AWS service to which a security group rule allows outbound access.

  • egress.ip-permission.protocol - The IP protocol for an outbound security group rule (tcp | udp | icmp or a protocol number).

  • egress.ip-permission.to-port - For an outbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.

  • egress.ip-permission.user-id - The ID of an AWS account that has been referenced in an outbound security group rule.

  • group-id - The ID of the security group.

  • group-name - The name of the security group.

  • ip-permission.cidr - An IPv4 CIDR block for an inbound security group rule.

  • ip-permission.from-port - For an inbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.

  • ip-permission.group-id - The ID of a security group that has been referenced in an inbound security group rule.

  • ip-permission.group-name - The name of a security group that has been referenced in an inbound security group rule.

  • ip-permission.ipv6-cidr - An IPv6 CIDR block for an inbound security group rule.

  • ip-permission.prefix-list-id - The ID (prefix) of the AWS service from which a security group rule allows inbound access.

  • ip-permission.protocol - The IP protocol for an inbound security group rule (tcp | udp | icmp or a protocol number).

  • ip-permission.to-port - For an inbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.

  • ip-permission.user-id - The ID of an AWS account that has been referenced in an inbound security group rule.

  • owner-id - The AWS account ID of the owner of the security group.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC specified when the security group was created.

", - "locationName":"Filter" - }, - "GroupIds":{ - "shape":"GroupIdStringList", - "documentation":"

One or more security group IDs. Required for security groups in a nondefault VPC.

Default: Describes all your security groups.

", - "locationName":"GroupId" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

[EC2-Classic and default VPC only] One or more security group names. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the group-name filter to describe security groups by name.

Default: Describes all your security groups.

", - "locationName":"GroupName" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another request with the returned NextToken value. This value can be between 5 and 1000. If this parameter is not specified, then all results are returned.

" - } - }, - "documentation":"

Contains the parameters for DescribeSecurityGroups.

" - }, - "DescribeSecurityGroupsResult":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroupList", - "documentation":"

Information about one or more security groups.

", - "locationName":"securityGroupInfo" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSecurityGroups.

" - }, - "DescribeSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "SnapshotId" - ], - "members":{ - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute you would like to view.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "CreateVolumePermissions":{ - "shape":"CreateVolumePermissionList", - "documentation":"

A list of permissions for creating volumes from the snapshot.

", - "locationName":"createVolumePermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot.

", - "locationName":"snapshotId" - } - }, - "documentation":"

Contains the output of DescribeSnapshotAttribute.

" - }, - "DescribeSnapshotsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • description - A description of the snapshot.

  • owner-alias - Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

  • owner-id - The ID of the AWS account that owns the snapshot.

  • progress - The progress of the snapshot, as a percentage (for example, 80%).

  • snapshot-id - The snapshot ID.

  • start-time - The time stamp when the snapshot was initiated.

  • status - The status of the snapshot (pending | completed | error).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • volume-id - The ID of the volume the snapshot is for.

  • volume-size - The size of the volume, in GiB.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of snapshot results returned by DescribeSnapshots in paginated output. When this parameter is used, DescribeSnapshots only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeSnapshots request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeSnapshots returns all results. You cannot specify this parameter and the snapshot IDs parameter in the same request.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeSnapshots request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

" - }, - "OwnerIds":{ - "shape":"OwnerStringList", - "documentation":"

Returns the snapshots owned by the specified owner. Multiple owners can be specified.

", - "locationName":"Owner" - }, - "RestorableByUserIds":{ - "shape":"RestorableByStringList", - "documentation":"

One or more AWS accounts IDs that can create volumes from the snapshot.

", - "locationName":"RestorableBy" - }, - "SnapshotIds":{ - "shape":"SnapshotIdStringList", - "documentation":"

One or more snapshot IDs.

Default: Describes snapshots for which you have launch permissions.

", - "locationName":"SnapshotId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSnapshots.

" - }, - "DescribeSnapshotsResult":{ - "type":"structure", - "members":{ - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeSnapshots request. When the results of a DescribeSnapshots request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeSnapshots.

" - }, - "DescribeSpotDatafeedSubscriptionRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotDatafeedSubscriptionResult":{ - "type":"structure", - "members":{ - "SpotDatafeedSubscription":{ - "shape":"SpotDatafeedSubscription", - "documentation":"

The Spot Instance data feed subscription.

", - "locationName":"spotDatafeedSubscription" - } - }, - "documentation":"

Contains the output of DescribeSpotDatafeedSubscription.

" - }, - "DescribeSpotFleetInstancesRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetInstancesResponse":{ - "type":"structure", - "required":[ - "ActiveInstances", - "SpotFleetRequestId" - ], - "members":{ - "ActiveInstances":{ - "shape":"ActiveInstanceSet", - "documentation":"

The running instances. This list is refreshed periodically and might be out of date.

", - "locationName":"activeInstanceSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetInstances.

" - }, - "DescribeSpotFleetRequestHistoryRequest":{ - "type":"structure", - "required":[ - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The type of events to describe. By default, all events are described.

", - "locationName":"eventType" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestHistoryResponse":{ - "type":"structure", - "required":[ - "HistoryRecords", - "LastEvaluatedTime", - "SpotFleetRequestId", - "StartTime" - ], - "members":{ - "HistoryRecords":{ - "shape":"HistoryRecords", - "documentation":"

Information about the events in the history of the Spot Fleet request.

", - "locationName":"historyRecordSet" - }, - "LastEvaluatedTime":{ - "shape":"DateTime", - "documentation":"

The last date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). All records up to this time were retrieved.

If nextToken indicates that there are more results, this value is not present.

", - "locationName":"lastEvaluatedTime" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequestHistory.

" - }, - "DescribeSpotFleetRequestsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "SpotFleetRequestIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of the Spot Fleet requests.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the parameters for DescribeSpotFleetRequests.

" - }, - "DescribeSpotFleetRequestsResponse":{ - "type":"structure", - "required":["SpotFleetRequestConfigs"], - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "SpotFleetRequestConfigs":{ - "shape":"SpotFleetRequestConfigSet", - "documentation":"

Information about the configuration of your Spot Fleet.

", - "locationName":"spotFleetRequestConfigSet" - } - }, - "documentation":"

Contains the output of DescribeSpotFleetRequests.

" - }, - "DescribeSpotInstanceRequestsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone-group - The Availability Zone group.

  • create-time - The time stamp when the Spot Instance request was created.

  • fault-code - The fault code related to the request.

  • fault-message - The fault message related to the request.

  • instance-id - The ID of the instance that fulfilled the request.

  • launch-group - The Spot Instance launch group.

  • launch.block-device-mapping.delete-on-termination - Indicates whether the EBS volume is deleted on instance termination.

  • launch.block-device-mapping.device-name - The device name for the volume in the block device mapping (for example, /dev/sdh or xvdh).

  • launch.block-device-mapping.snapshot-id - The ID of the snapshot for the EBS volume.

  • launch.block-device-mapping.volume-size - The size of the EBS volume, in GiB.

  • launch.block-device-mapping.volume-type - The type of EBS volume: gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1for Cold HDD, or standard for Magnetic.

  • launch.group-id - The ID of the security group for the instance.

  • launch.group-name - The name of the security group for the instance.

  • launch.image-id - The ID of the AMI.

  • launch.instance-type - The type of instance (for example, m3.medium).

  • launch.kernel-id - The kernel ID.

  • launch.key-name - The name of the key pair the instance launched with.

  • launch.monitoring-enabled - Whether detailed monitoring is enabled for the Spot Instance.

  • launch.ramdisk-id - The RAM disk ID.

  • launched-availability-zone - The Availability Zone in which the request is launched.

  • network-interface.addresses.primary - Indicates whether the IP address is the primary private IP address.

  • network-interface.delete-on-termination - Indicates whether the network interface is deleted when the instance is terminated.

  • network-interface.description - A description of the network interface.

  • network-interface.device-index - The index of the device for the network interface attachment on the instance.

  • network-interface.group-id - The ID of the security group associated with the network interface.

  • network-interface.network-interface-id - The ID of the network interface.

  • network-interface.private-ip-address - The primary private IP address of the network interface.

  • network-interface.subnet-id - The ID of the subnet for the instance.

  • product-description - The product description associated with the instance (Linux/UNIX | Windows).

  • spot-instance-request-id - The Spot Instance request ID.

  • spot-price - The maximum hourly price for any Spot Instance launched to fulfill the request.

  • state - The state of the Spot Instance request (open | active | closed | cancelled | failed). Spot request status information can help you track your Amazon EC2 Spot Instance requests. For more information, see Spot Request Status in the Amazon EC2 User Guide for Linux Instances.

  • status-code - The short code describing the most recent evaluation of your Spot Instance request.

  • status-message - The message explaining the status of the Spot Instance request.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • type - The type of Spot Instance request (one-time | persistent).

  • valid-from - The start date of the request.

  • valid-until - The end date of the request.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotInstanceRequestIds":{ - "shape":"SpotInstanceRequestIdList", - "documentation":"

One or more Spot Instance request IDs.

", - "locationName":"SpotInstanceRequestId" - } - }, - "documentation":"

Contains the parameters for DescribeSpotInstanceRequests.

" - }, - "DescribeSpotInstanceRequestsResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of DescribeSpotInstanceRequests.

" - }, - "DescribeSpotPriceHistoryRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m3.medium).

  • product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The time stamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

", - "locationName":"Filter" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Filters the results by the specified Availability Zone.

", - "locationName":"availabilityZone" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"endTime" - }, - "InstanceTypes":{ - "shape":"InstanceTypeList", - "documentation":"

Filters the results by the specified instance types.

", - "locationName":"InstanceType" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of results.

", - "locationName":"nextToken" - }, - "ProductDescriptions":{ - "shape":"ProductDescriptionList", - "documentation":"

Filters the results by the specified basic product descriptions.

", - "locationName":"ProductDescription" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"startTime" - } - }, - "documentation":"

Contains the parameters for DescribeSpotPriceHistory.

" - }, - "DescribeSpotPriceHistoryResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token required to retrieve the next set of results. This value is null or an empty string when there are no more results to return.

", - "locationName":"nextToken" - }, - "SpotPriceHistory":{ - "shape":"SpotPriceHistoryList", - "documentation":"

The historical Spot prices.

", - "locationName":"spotPriceHistorySet" - } - }, - "documentation":"

Contains the output of DescribeSpotPriceHistory.

" - }, - "DescribeStaleSecurityGroupsRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - } - }, - "DescribeStaleSecurityGroupsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - }, - "StaleSecurityGroupSet":{ - "shape":"StaleSecurityGroupSet", - "documentation":"

Information about the stale security groups.

", - "locationName":"staleSecurityGroupSet" - } - } - }, - "DescribeSubnetsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • availabilityZone - The Availability Zone for the subnet. You can also use availability-zone as the filter name.

  • available-ip-address-count - The number of IPv4 addresses in the subnet that are available.

  • cidrBlock - The IPv4 CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr or cidr-block as the filter names.

  • defaultForAz - Indicates whether this is the default subnet for the Availability Zone. You can also use default-for-az as the filter name.

  • ipv6-cidr-block-association.ipv6-cidr-block - An IPv6 CIDR block associated with the subnet.

  • ipv6-cidr-block-association.association-id - An association ID for an IPv6 CIDR block associated with the subnet.

  • ipv6-cidr-block-association.state - The state of an IPv6 CIDR block associated with the subnet.

  • state - The state of the subnet (pending | available).

  • subnet-id - The ID of the subnet.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC for the subnet.

", - "locationName":"Filter" - }, - "SubnetIds":{ - "shape":"SubnetIdStringList", - "documentation":"

One or more subnet IDs.

Default: Describes all your subnets.

", - "locationName":"SubnetId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeSubnets.

" - }, - "DescribeSubnetsResult":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Information about one or more subnets.

", - "locationName":"subnetSet" - } - }, - "documentation":"

Contains the output of DescribeSubnets.

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • key - The tag key.

  • resource-id - The resource ID.

  • resource-type - The resource type (customer-gateway | dhcp-options | elastic-ip | fleet | fpga-image | image | instance | internet-gateway | launch-template | natgateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpc-peering-connection | vpn-connection | vpn-gateway).

  • value - The tag value.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeTags.

" - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "Tags":{ - "shape":"TagDescriptionList", - "documentation":"

A list of tags.

", - "locationName":"tagSet" - } - }, - "documentation":"

Contains the output of DescribeTags.

" - }, - "DescribeVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "Attribute":{ - "shape":"VolumeAttributeName", - "documentation":"

The attribute of the volume. This parameter is required.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeAttribute.

" - }, - "DescribeVolumeAttributeResult":{ - "type":"structure", - "members":{ - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

The state of autoEnableIO attribute.

", - "locationName":"autoEnableIO" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Contains the output of DescribeVolumeAttribute.

" - }, - "DescribeVolumeStatusRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • action.code - The action code for the event (for example, enable-volume-io).

  • action.description - A description of the action.

  • action.event-id - The event ID associated with the action.

  • availability-zone - The Availability Zone of the instance.

  • event.description - A description of the event.

  • event.event-id - The event ID.

  • event.event-type - The event type (for io-enabled: passed | failed; for io-performance: io-performance:degraded | io-performance:severely-degraded | io-performance:stalled).

  • event.not-after - The latest end time for the event.

  • event.not-before - The earliest start time for the event.

  • volume-status.details-name - The cause for volume-status.status (io-enabled | io-performance).

  • volume-status.details-status - The status of volume-status.details-name (for io-enabled: passed | failed; for io-performance: normal | degraded | severely-degraded | stalled).

  • volume-status.status - The status of the volume (ok | impaired | warning | insufficient-data).

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumeStatus in paginated output. When this parameter is used, the request only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned. If this parameter is not used, then DescribeVolumeStatus returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumeStatus request. When the results of the request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

Default: Describes all your volumes.

", - "locationName":"VolumeId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVolumeStatus.

" - }, - "DescribeVolumeStatusResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - }, - "VolumeStatuses":{ - "shape":"VolumeStatusList", - "documentation":"

A list of volumes.

", - "locationName":"volumeStatusSet" - } - }, - "documentation":"

Contains the output of DescribeVolumeStatus.

" - }, - "DescribeVolumesModificationsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs for which in-progress modifications will be described.

", - "locationName":"VolumeId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters. Supported filters: volume-id, modification-state, target-size, target-iops, target-volume-type, original-size, original-iops, original-volume-type, start-time.

", - "locationName":"Filter" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned by a previous paginated request.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results (up to a limit of 500) to be returned in a paginated request.

" - } - } - }, - "DescribeVolumesModificationsResult":{ - "type":"structure", - "members":{ - "VolumesModifications":{ - "shape":"VolumeModificationList", - "documentation":"

A list of returned VolumeModification objects.

", - "locationName":"volumeModificationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Token for pagination, null if there are no more results

", - "locationName":"nextToken" - } - } - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • attachment.attach-time - The time stamp when the attachment initiated.

  • attachment.delete-on-termination - Whether the volume is deleted on instance termination.

  • attachment.device - The device name specified in the block device mapping (for example, /dev/sda1).

  • attachment.instance-id - The ID of the instance the volume is attached to.

  • attachment.status - The attachment state (attaching | attached | detaching).

  • availability-zone - The Availability Zone in which the volume was created.

  • create-time - The time stamp when the volume was created.

  • encrypted - The encryption status of the volume.

  • size - The size of the volume, in GiB.

  • snapshot-id - The snapshot from which the volume was created.

  • status - The status of the volume (creating | available | in-use | deleting | deleted | error).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • volume-id - The volume ID.

  • volume-type - The Amazon EBS volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"Filter" - }, - "VolumeIds":{ - "shape":"VolumeIdStringList", - "documentation":"

One or more volume IDs.

", - "locationName":"VolumeId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of volume results returned by DescribeVolumes in paginated output. When this parameter is used, DescribeVolumes only returns MaxResults results in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another DescribeVolumes request with the returned NextToken value. This value can be between 5 and 500; if MaxResults is given a value larger than 500, only 500 results are returned. If this parameter is not used, then DescribeVolumes returns all results. You cannot specify this parameter and the volume IDs parameter in the same request.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value returned from a previous paginated DescribeVolumes request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the parameters for DescribeVolumes.

" - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"VolumeList", - "documentation":"

Information about the volumes.

", - "locationName":"volumeSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The NextToken value to include in a future DescribeVolumes request. When the results of a DescribeVolumes request exceed MaxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVolumes.

" - }, - "DescribeVpcAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "VpcId" - ], - "members":{ - "Attribute":{ - "shape":"VpcAttributeName", - "documentation":"

The VPC attribute.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVpcAttribute.

" - }, - "DescribeVpcAttributeResult":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

", - "locationName":"enableDnsHostnames" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

", - "locationName":"enableDnsSupport" - } - }, - "documentation":"

Contains the output of DescribeVpcAttribute.

" - }, - "DescribeVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

", - "locationName":"nextToken" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPC IDs.

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items.

", - "locationName":"nextToken" - }, - "Vpcs":{ - "shape":"ClassicLinkDnsSupportList", - "documentation":"

Information about the ClassicLink DNS support status of the VPCs.

", - "locationName":"vpcs" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLinkDnsSupport.

" - }, - "DescribeVpcClassicLinkRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • is-classic-link-enabled - Whether the VPC is enabled for ClassicLink (true | false).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcIds":{ - "shape":"VpcClassicLinkIdList", - "documentation":"

One or more VPCs for which you want to describe the ClassicLink status.

", - "locationName":"VpcId" - } - }, - "documentation":"

Contains the parameters for DescribeVpcClassicLink.

" - }, - "DescribeVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcClassicLinkList", - "documentation":"

The ClassicLink status of one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcClassicLink.

" - }, - "DescribeVpcEndpointConnectionNotificationsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ConnectionNotificationId":{ - "shape":"String", - "documentation":"

The ID of the notification.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • connection-notification-arn - The ARN of SNS topic for the notification.

  • connection-notification-id - The ID of the notification.

  • connection-notification-state - The state of the notification (Enabled | Disabled).

  • connection-notification-type - The type of notification (Topic).

  • service-id - The ID of the endpoint service.

  • vpc-endpoint-id - The ID of the VPC endpoint.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return in a single call. To retrieve the remaining results, make another request with the returned NextToken value.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to request the next page of results.

" - } - } - }, - "DescribeVpcEndpointConnectionNotificationsResult":{ - "type":"structure", - "members":{ - "ConnectionNotificationSet":{ - "shape":"ConnectionNotificationSet", - "documentation":"

One or more notifications.

", - "locationName":"connectionNotificationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcEndpointConnectionsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-id - The ID of the service.

  • vpc-endpoint-owner - The AWS account number of the owner of the endpoint.

  • vpc-endpoint-state - The state of the endpoint (pendingAcceptance | pending | available | deleting | deleted | rejected | failed).

  • vpc-endpoint-id - The ID of the endpoint.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - } - }, - "DescribeVpcEndpointConnectionsResult":{ - "type":"structure", - "members":{ - "VpcEndpointConnections":{ - "shape":"VpcEndpointConnectionSet", - "documentation":"

Information about one or more VPC endpoint connections.

", - "locationName":"vpcEndpointConnectionSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcEndpointServiceConfigurationsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of one or more services.

", - "locationName":"ServiceId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name - The name of the service.

  • service-id - The ID of the service.

  • service-state - The state of the service (Pending | Available | Deleting | Deleted | Failed).

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - } - }, - "DescribeVpcEndpointServiceConfigurationsResult":{ - "type":"structure", - "members":{ - "ServiceConfigurations":{ - "shape":"ServiceConfigurationSet", - "documentation":"

Information about one or more services.

", - "locationName":"serviceConfigurationSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcEndpointServicePermissionsRequest":{ - "type":"structure", - "required":["ServiceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • principal - The ARN of the principal.

  • principal-type - The principal type (All | Service | OrganizationUnit | Account | User | Role).

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to retrieve the next page of results.

" - } - } - }, - "DescribeVpcEndpointServicePermissionsResult":{ - "type":"structure", - "members":{ - "AllowedPrincipals":{ - "shape":"AllowedPrincipalSet", - "documentation":"

Information about one or more allowed principals.

", - "locationName":"allowedPrincipals" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", - "locationName":"nextToken" - } - } - }, - "DescribeVpcEndpointServicesRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

One or more service names.

", - "locationName":"ServiceName" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the service.

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointServicesResult":{ - "type":"structure", - "members":{ - "ServiceNames":{ - "shape":"ValueStringList", - "documentation":"

A list of supported services.

", - "locationName":"serviceNameSet" - }, - "ServiceDetails":{ - "shape":"ServiceDetailSet", - "documentation":"

Information about the service.

", - "locationName":"serviceDetailSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpointServices.

" - }, - "DescribeVpcEndpointsRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

One or more endpoint IDs.

", - "locationName":"VpcEndpointId" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • service-name: The name of the service.

  • vpc-id: The ID of the VPC in which the endpoint resides.

  • vpc-endpoint-id: The ID of the endpoint.

  • vpc-endpoint-state: The state of the endpoint. (pending | available | deleting | deleted)

", - "locationName":"Filter" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1000, we return only 1000 items.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token for the next set of items to return. (You received this token from a prior call.)

" - } - }, - "documentation":"

Contains the parameters for DescribeVpcEndpoints.

" - }, - "DescribeVpcEndpointsResult":{ - "type":"structure", - "members":{ - "VpcEndpoints":{ - "shape":"VpcEndpointSet", - "documentation":"

Information about the endpoints.

", - "locationName":"vpcEndpointSet" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

", - "locationName":"nextToken" - } - }, - "documentation":"

Contains the output of DescribeVpcEndpoints.

" - }, - "DescribeVpcPeeringConnectionsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • accepter-vpc-info.cidr-block - The IPv4 CIDR block of the accepter VPC.

  • accepter-vpc-info.owner-id - The AWS account ID of the owner of the accepter VPC.

  • accepter-vpc-info.vpc-id - The ID of the accepter VPC.

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The IPv4 CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The AWS account ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id - The ID of the requester VPC.

  • status-code - The status of the VPC peering connection (pending-acceptance | failed | expired | provisioning | active | deleting | deleted | rejected).

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-peering-connection-id - The ID of the VPC peering connection.

", - "locationName":"Filter" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionIds":{ - "shape":"ValueStringList", - "documentation":"

One or more VPC peering connection IDs.

Default: Describes all your VPC peering connections.

", - "locationName":"VpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for DescribeVpcPeeringConnections.

" - }, - "DescribeVpcPeeringConnectionsResult":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Information about the VPC peering connections.

", - "locationName":"vpcPeeringConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpcPeeringConnections.

" - }, - "DescribeVpcsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • cidr - The primary IPv4 CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28).

  • cidr-block-association.cidr-block - An IPv4 CIDR block associated with the VPC.

  • cidr-block-association.association-id - The association ID for an IPv4 CIDR block associated with the VPC.

  • cidr-block-association.state - The state of an IPv4 CIDR block associated with the VPC.

  • dhcp-options-id - The ID of a set of DHCP options.

  • ipv6-cidr-block-association.ipv6-cidr-block - An IPv6 CIDR block associated with the VPC.

  • ipv6-cidr-block-association.association-id - The association ID for an IPv6 CIDR block associated with the VPC.

  • ipv6-cidr-block-association.state - The state of an IPv6 CIDR block associated with the VPC.

  • isDefault - Indicates whether the VPC is the default VPC.

  • state - The state of the VPC (pending | available).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • vpc-id - The ID of the VPC.

", - "locationName":"Filter" - }, - "VpcIds":{ - "shape":"VpcIdStringList", - "documentation":"

One or more VPC IDs.

Default: Describes all your VPCs.

", - "locationName":"VpcId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVpcs.

" - }, - "DescribeVpcsResult":{ - "type":"structure", - "members":{ - "Vpcs":{ - "shape":"VpcList", - "documentation":"

Information about one or more VPCs.

", - "locationName":"vpcSet" - } - }, - "documentation":"

Contains the output of DescribeVpcs.

" - }, - "DescribeVpnConnectionsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • customer-gateway-configuration - The configuration information for the customer gateway.

  • customer-gateway-id - The ID of a customer gateway associated with the VPN connection.

  • state - The state of the VPN connection (pending | available | deleting | deleted).

  • option.static-routes-only - Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).

  • route.destination-cidr-block - The destination CIDR block. This corresponds to the subnet used in a customer data center.

  • bgp-asn - The BGP Autonomous System Number (ASN) associated with a BGP device.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • type - The type of VPN connection. Currently the only supported type is ipsec.1.

  • vpn-connection-id - The ID of the VPN connection.

  • vpn-gateway-id - The ID of a virtual private gateway associated with the VPN connection.

", - "locationName":"Filter" - }, - "VpnConnectionIds":{ - "shape":"VpnConnectionIdStringList", - "documentation":"

One or more VPN connection IDs.

Default: Describes your VPN connections.

", - "locationName":"VpnConnectionId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVpnConnections.

" - }, - "DescribeVpnConnectionsResult":{ - "type":"structure", - "members":{ - "VpnConnections":{ - "shape":"VpnConnectionList", - "documentation":"

Information about one or more VPN connections.

", - "locationName":"vpnConnectionSet" - } - }, - "documentation":"

Contains the output of DescribeVpnConnections.

" - }, - "DescribeVpnGatewaysRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"FilterList", - "documentation":"

One or more filters.

  • amazon-side-asn - The Autonomous System Number (ASN) for the Amazon side of the gateway.

  • attachment.state - The current state of the attachment between the gateway and the VPC (attaching | attached | detaching | detached).

  • attachment.vpc-id - The ID of an attached VPC.

  • availability-zone - The Availability Zone for the virtual private gateway (if applicable).

  • state - The state of the virtual private gateway (pending | available | deleting | deleted).

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

  • type - The type of virtual private gateway. Currently the only supported type is ipsec.1.

  • vpn-gateway-id - The ID of the virtual private gateway.

", - "locationName":"Filter" - }, - "VpnGatewayIds":{ - "shape":"VpnGatewayIdStringList", - "documentation":"

One or more virtual private gateway IDs.

Default: Describes all your virtual private gateways.

", - "locationName":"VpnGatewayId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DescribeVpnGateways.

" - }, - "DescribeVpnGatewaysResult":{ - "type":"structure", - "members":{ - "VpnGateways":{ - "shape":"VpnGatewayList", - "documentation":"

Information about one or more virtual private gateways.

", - "locationName":"vpnGatewaySet" - } - }, - "documentation":"

Contains the output of DescribeVpnGateways.

" - }, - "DetachClassicLinkVpcRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to unlink from the VPC.

", - "locationName":"instanceId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the instance is linked.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachClassicLinkVpc.

" - }, - "DetachClassicLinkVpcResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DetachClassicLinkVpc.

" - }, - "DetachInternetGatewayRequest":{ - "type":"structure", - "required":[ - "InternetGatewayId", - "VpcId" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the internet gateway.

", - "locationName":"internetGatewayId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DetachInternetGateway.

" - }, - "DetachNetworkInterfaceRequest":{ - "type":"structure", - "required":["AttachmentId"], - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the attachment.

", - "locationName":"attachmentId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force a detachment.

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for DetachNetworkInterface.

" - }, - "DetachVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DetachVolume.

" - }, - "DetachVpnGatewayRequest":{ - "type":"structure", - "required":[ - "VpcId", - "VpnGatewayId" - ], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DetachVpnGateway.

" - }, - "DeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "DhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The name of a DHCP option.

", - "locationName":"key" - }, - "Values":{ - "shape":"DhcpConfigurationValueList", - "documentation":"

One or more values for the DHCP option.

", - "locationName":"valueSet" - } - }, - "documentation":"

Describes a DHCP configuration option.

" - }, - "DhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"DhcpConfiguration", - "locationName":"item" - } - }, - "DhcpConfigurationValueList":{ - "type":"list", - "member":{ - "shape":"AttributeValue", - "locationName":"item" - } - }, - "DhcpOptions":{ - "type":"structure", - "members":{ - "DhcpConfigurations":{ - "shape":"DhcpConfigurationList", - "documentation":"

One or more DHCP options in the set.

", - "locationName":"dhcpConfigurationSet" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options.

", - "locationName":"dhcpOptionsId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the DHCP options set.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a set of DHCP options.

" - }, - "DhcpOptionsIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DhcpOptionsId" - } - }, - "DhcpOptionsList":{ - "type":"list", - "member":{ - "shape":"DhcpOptions", - "locationName":"item" - } - }, - "DisableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "GatewayId", - "RouteTableId" - ], - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - } - }, - "documentation":"

Contains the parameters for DisableVgwRoutePropagation.

" - }, - "DisableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLinkDnsSupport.

" - }, - "DisableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for DisableVpcClassicLink.

" - }, - "DisableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of DisableVpcClassicLink.

" - }, - "DisassociateAddressRequest":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The association ID. Required for EC2-VPC.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DisassociateAddress.

" - }, - "DisassociateIamInstanceProfileRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the IAM instance profile association.

" - } - } - }, - "DisassociateIamInstanceProfileResult":{ - "type":"structure", - "members":{ - "IamInstanceProfileAssociation":{ - "shape":"IamInstanceProfileAssociation", - "documentation":"

Information about the IAM instance profile association.

", - "locationName":"iamInstanceProfileAssociation" - } - } - }, - "DisassociateRouteTableRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID representing the current association between the route table and subnet.

", - "locationName":"associationId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for DisassociateRouteTable.

" - }, - "DisassociateSubnetCidrBlockRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID for the CIDR block.

", - "locationName":"associationId" - } - } - }, - "DisassociateSubnetCidrBlockResult":{ - "type":"structure", - "members":{ - "Ipv6CidrBlockAssociation":{ - "shape":"SubnetIpv6CidrBlockAssociation", - "documentation":"

Information about the IPv6 CIDR block association.

", - "locationName":"ipv6CidrBlockAssociation" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - } - }, - "DisassociateVpcCidrBlockRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID for the CIDR block.

", - "locationName":"associationId" - } - } - }, - "DisassociateVpcCidrBlockResult":{ - "type":"structure", - "members":{ - "Ipv6CidrBlockAssociation":{ - "shape":"VpcIpv6CidrBlockAssociation", - "documentation":"

Information about the IPv6 CIDR block association.

", - "locationName":"ipv6CidrBlockAssociation" - }, - "CidrBlockAssociation":{ - "shape":"VpcCidrBlockAssociation", - "documentation":"

Information about the IPv4 CIDR block association.

", - "locationName":"cidrBlockAssociation" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - } - }, - "DiskImage":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the disk image.

" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

Information about the disk image.

" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

Information about the volume.

" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDescription":{ - "type":"structure", - "members":{ - "Checksum":{ - "shape":"String", - "documentation":"

The checksum computed for the disk image.

", - "locationName":"checksum" - }, - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageDetail":{ - "type":"structure", - "required":[ - "Bytes", - "Format", - "ImportManifestUrl" - ], - "members":{ - "Bytes":{ - "shape":"Long", - "documentation":"

The size of the disk image, in GiB.

", - "locationName":"bytes" - }, - "Format":{ - "shape":"DiskImageFormat", - "documentation":"

The disk image format.

", - "locationName":"format" - }, - "ImportManifestUrl":{ - "shape":"String", - "documentation":"

A presigned URL for the import manifest stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the \"Query String Request Authentication Alternative\" section of the Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "locationName":"importManifestUrl" - } - }, - "documentation":"

Describes a disk image.

" - }, - "DiskImageFormat":{ - "type":"string", - "enum":[ - "VMDK", - "RAW", - "VHD" - ] - }, - "DiskImageList":{ - "type":"list", - "member":{"shape":"DiskImage"} - }, - "DiskImageVolumeDescription":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The volume identifier.

", - "locationName":"id" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes a disk image volume.

" - }, - "DnsEntry":{ - "type":"structure", - "members":{ - "DnsName":{ - "shape":"String", - "documentation":"

The DNS name.

", - "locationName":"dnsName" - }, - "HostedZoneId":{ - "shape":"String", - "documentation":"

The ID of the private hosted zone.

", - "locationName":"hostedZoneId" - } - }, - "documentation":"

Describes a DNS entry.

" - }, - "DnsEntrySet":{ - "type":"list", - "member":{ - "shape":"DnsEntry", - "locationName":"item" - } - }, - "DomainType":{ - "type":"string", - "enum":[ - "vpc", - "standard" - ] - }, - "Double":{"type":"double"}, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted volumes can only be attached to instances that support Amazon EBS encryption. If you are creating a volume from a snapshot, you can't specify an encryption value. This is because only blank volumes can be encrypted on creation.

", - "locationName":"encrypted" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

Identifier (key ID, key alias, ID ARN, or alias ARN) for a user-managed CMK under which the EBS volume is encrypted.

This parameter is only supported on BlockDeviceMapping objects called by RunInstances, RequestSpotFleet, and RequestSpotInstances.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

", - "locationName":"volumeSize" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type: gp2, io1, st1, sc1, or standard.

Default: standard

", - "locationName":"volumeType" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "EbsInstanceBlockDevice":{ - "type":"structure", - "members":{ - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Describes a parameter used to set up an EBS volume in a block device mapping.

" - }, - "EbsInstanceBlockDeviceSpecification":{ - "type":"structure", - "members":{ - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the EBS volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Describes information used to set up an EBS volume specified in a block device mapping.

" - }, - "EgressOnlyInternetGateway":{ - "type":"structure", - "members":{ - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Information about the attachment of the egress-only internet gateway.

", - "locationName":"attachmentSet" - }, - "EgressOnlyInternetGatewayId":{ - "shape":"EgressOnlyInternetGatewayId", - "documentation":"

The ID of the egress-only internet gateway.

", - "locationName":"egressOnlyInternetGatewayId" - } - }, - "documentation":"

Describes an egress-only internet gateway.

" - }, - "EgressOnlyInternetGatewayId":{"type":"string"}, - "EgressOnlyInternetGatewayIdList":{ - "type":"list", - "member":{ - "shape":"EgressOnlyInternetGatewayId", - "locationName":"item" - } - }, - "EgressOnlyInternetGatewayList":{ - "type":"list", - "member":{ - "shape":"EgressOnlyInternetGateway", - "locationName":"item" - } - }, - "ElasticGpuAssociation":{ - "type":"structure", - "members":{ - "ElasticGpuId":{ - "shape":"String", - "documentation":"

The ID of the Elastic GPU.

", - "locationName":"elasticGpuId" - }, - "ElasticGpuAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association.

", - "locationName":"elasticGpuAssociationId" - }, - "ElasticGpuAssociationState":{ - "shape":"String", - "documentation":"

The state of the association between the instance and the Elastic GPU.

", - "locationName":"elasticGpuAssociationState" - }, - "ElasticGpuAssociationTime":{ - "shape":"String", - "documentation":"

The time the Elastic GPU was associated with the instance.

", - "locationName":"elasticGpuAssociationTime" - } - }, - "documentation":"

Describes the association between an instance and an Elastic GPU.

" - }, - "ElasticGpuAssociationList":{ - "type":"list", - "member":{ - "shape":"ElasticGpuAssociation", - "locationName":"item" - } - }, - "ElasticGpuHealth":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"ElasticGpuStatus", - "documentation":"

The health status.

", - "locationName":"status" - } - }, - "documentation":"

Describes the status of an Elastic GPU.

" - }, - "ElasticGpuIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ElasticGpuSet":{ - "type":"list", - "member":{ - "shape":"ElasticGpus", - "locationName":"item" - } - }, - "ElasticGpuSpecification":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"String", - "documentation":"

The type of Elastic GPU.

" - } - }, - "documentation":"

A specification for an Elastic GPU.

" - }, - "ElasticGpuSpecificationList":{ - "type":"list", - "member":{ - "shape":"ElasticGpuSpecification", - "locationName":"ElasticGpuSpecification" - } - }, - "ElasticGpuSpecificationResponse":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

The elastic GPU type.

", - "locationName":"type" - } - }, - "documentation":"

Describes an elastic GPU.

" - }, - "ElasticGpuSpecificationResponseList":{ - "type":"list", - "member":{ - "shape":"ElasticGpuSpecificationResponse", - "locationName":"item" - } - }, - "ElasticGpuSpecifications":{ - "type":"list", - "member":{ - "shape":"ElasticGpuSpecification", - "locationName":"item" - } - }, - "ElasticGpuState":{ - "type":"string", - "enum":["ATTACHED"] - }, - "ElasticGpuStatus":{ - "type":"string", - "enum":[ - "OK", - "IMPAIRED" - ] - }, - "ElasticGpus":{ - "type":"structure", - "members":{ - "ElasticGpuId":{ - "shape":"String", - "documentation":"

The ID of the Elastic GPU.

", - "locationName":"elasticGpuId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in the which the Elastic GPU resides.

", - "locationName":"availabilityZone" - }, - "ElasticGpuType":{ - "shape":"String", - "documentation":"

The type of Elastic GPU.

", - "locationName":"elasticGpuType" - }, - "ElasticGpuHealth":{ - "shape":"ElasticGpuHealth", - "documentation":"

The status of the Elastic GPU.

", - "locationName":"elasticGpuHealth" - }, - "ElasticGpuState":{ - "shape":"ElasticGpuState", - "documentation":"

The state of the Elastic GPU.

", - "locationName":"elasticGpuState" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance to which the Elastic GPU is attached.

", - "locationName":"instanceId" - } - }, - "documentation":"

Describes an Elastic GPU.

" - }, - "EnableVgwRoutePropagationRequest":{ - "type":"structure", - "required":[ - "GatewayId", - "RouteTableId" - ], - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

" - } - }, - "documentation":"

Contains the parameters for EnableVgwRoutePropagation.

" - }, - "EnableVolumeIORequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - } - }, - "documentation":"

Contains the parameters for EnableVolumeIO.

" - }, - "EnableVpcClassicLinkDnsSupportRequest":{ - "type":"structure", - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkDnsSupportResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLinkDnsSupport.

" - }, - "EnableVpcClassicLinkRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for EnableVpcClassicLink.

" - }, - "EnableVpcClassicLinkResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of EnableVpcClassicLink.

" - }, - "EventCode":{ - "type":"string", - "enum":[ - "instance-reboot", - "system-reboot", - "system-maintenance", - "instance-retirement", - "instance-stop" - ] - }, - "EventInformation":{ - "type":"structure", - "members":{ - "EventDescription":{ - "shape":"String", - "documentation":"

The description of the event.

", - "locationName":"eventDescription" - }, - "EventSubType":{ - "shape":"String", - "documentation":"

The event.

The following are the error events:

  • iamFleetRoleInvalid - The Spot Fleet did not have the required permissions either to launch or terminate an instance.

  • launchSpecTemporarilyBlacklisted - The configuration is not valid and several attempts to launch instances have failed. For more information, see the description of the event.

  • spotFleetRequestConfigurationInvalid - The configuration is not valid. For more information, see the description of the event.

  • spotInstanceCountLimitExceeded - You've reached the limit on the number of Spot Instances that you can launch.

The following are the fleetRequestChange events:

  • active - The Spot Fleet has been validated and Amazon EC2 is attempting to maintain the target number of running Spot Instances.

  • cancelled - The Spot Fleet is canceled and has no running Spot Instances. The Spot Fleet will be deleted two days after its instances were terminated.

  • cancelled_running - The Spot Fleet is canceled and does not launch additional Spot Instances. Existing Spot Instances continue to run until they are interrupted or terminated.

  • cancelled_terminating - The Spot Fleet is canceled and its Spot Instances are terminating.

  • expired - The Spot Fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration set.

  • modify_in_progress - A request to modify the Spot Fleet request was accepted and is in progress.

  • modify_successful - The Spot Fleet request was modified.

  • price_update - The price for a launch configuration was adjusted because it was too high. This change is permanent.

  • submitted - The Spot Fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot Instances.

The following are the instanceChange events:

  • launched - A request was fulfilled and a new instance was launched.

  • terminated - An instance was terminated by the user.

The following are the Information events:

  • launchSpecUnusable - The price in a launch specification is not valid because it is below the Spot price or the Spot price is above the On-Demand price.

  • fleetProgressHalted - The price in every launch specification is not valid. A launch specification might become valid if the Spot price changes.

", - "locationName":"eventSubType" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance. This information is available only for instanceChange events.

", - "locationName":"instanceId" - } - }, - "documentation":"

Describes a Spot Fleet event.

" - }, - "EventType":{ - "type":"string", - "enum":[ - "instanceChange", - "fleetRequestChange", - "error" - ] - }, - "ExcessCapacityTerminationPolicy":{ - "type":"string", - "enum":[ - "noTermination", - "default" - ] - }, - "ExecutableByStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExecutableBy" - } - }, - "ExportEnvironment":{ - "type":"string", - "enum":[ - "citrix", - "vmware", - "microsoft" - ] - }, - "ExportTask":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the resource being exported.

", - "locationName":"description" - }, - "ExportTaskId":{ - "shape":"String", - "documentation":"

The ID of the export task.

", - "locationName":"exportTaskId" - }, - "ExportToS3Task":{ - "shape":"ExportToS3Task", - "documentation":"

Information about the export task.

", - "locationName":"exportToS3" - }, - "InstanceExportDetails":{ - "shape":"InstanceExportDetails", - "documentation":"

Information about the instance to export.

", - "locationName":"instanceExport" - }, - "State":{ - "shape":"ExportTaskState", - "documentation":"

The state of the export task.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status message related to the export task.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "ExportTaskIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ExportTaskId" - } - }, - "ExportTaskList":{ - "type":"list", - "member":{ - "shape":"ExportTask", - "locationName":"item" - } - }, - "ExportTaskState":{ - "type":"string", - "enum":[ - "active", - "cancelling", - "cancelled", - "completed" - ] - }, - "ExportToS3Task":{ - "type":"structure", - "members":{ - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The encryption key for your S3 bucket.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the format and location for an instance export task.

" - }, - "ExportToS3TaskSpecification":{ - "type":"structure", - "members":{ - "ContainerFormat":{ - "shape":"ContainerFormat", - "documentation":"

The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

", - "locationName":"containerFormat" - }, - "DiskImageFormat":{ - "shape":"DiskImageFormat", - "documentation":"

The format for the exported image.

", - "locationName":"diskImageFormat" - }, - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket for the destination image. The destination bucket must exist and grant WRITE and READ_ACP permissions to the AWS account vm-import-export@amazon.com.

", - "locationName":"s3Bucket" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The image is written to a single object in the S3 bucket at the S3 key s3prefix + exportTaskId + '.' + diskImageFormat.

", - "locationName":"s3Prefix" - } - }, - "documentation":"

Describes an instance export task.

" - }, - "Filter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ValueStringList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

", - "locationName":"Value" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs. The filters supported by a describe operation are documented with the describe operation. For example:

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FleetActivityStatus":{ - "type":"string", - "enum":[ - "error", - "pending-fulfillment", - "pending-termination", - "fulfilled" - ] - }, - "FleetData":{ - "type":"structure", - "members":{ - "ActivityStatus":{ - "shape":"FleetActivityStatus", - "documentation":"

The progress of the EC2 Fleet. If there is an error, the status is error. After all requests are placed, the status is pending_fulfillment. If the size of the EC2 Fleet is equal to or greater than its target capacity, the status is fulfilled. If the size of the EC2 Fleet is decreased, the status is pending_termination while instances are terminating.

", - "locationName":"activityStatus" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The creation date and time of the EC2 Fleet.

", - "locationName":"createTime" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

", - "locationName":"fleetId" - }, - "FleetState":{ - "shape":"FleetStateCode", - "documentation":"

The state of the EC2 Fleet.

", - "locationName":"fleetState" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"FleetExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running instances should be terminated if the target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "FulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target capacity.

", - "locationName":"fulfilledCapacity" - }, - "FulfilledOnDemandCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target On-Demand capacity.

", - "locationName":"fulfilledOnDemandCapacity" - }, - "LaunchTemplateConfigs":{ - "shape":"FleetLaunchTemplateConfigList", - "documentation":"

The launch template and overrides.

", - "locationName":"launchTemplateConfigs" - }, - "TargetCapacitySpecification":{ - "shape":"TargetCapacitySpecification", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

", - "locationName":"targetCapacitySpecification" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running instances should be terminated when the EC2 Fleet expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the EC2 Fleet only requests the target capacity, or also attempts to maintain it. If you request a certain target capacity, EC2 Fleet only places the required requests; it does not attempt to replenish instances if capacity is diminished, and does not submit requests in alternative capacity pools if capacity is unavailable. To maintain a certain target capacity, EC2 Fleet places the required requests to meet this target capacity. It also automatically replenishes any interrupted Spot Instances. Default: maintain.

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new instance requests are placed or able to fulfill the request. The default end date is 7 days from the current date.

", - "locationName":"validUntil" - }, - "ReplaceUnhealthyInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether EC2 Fleet should replace unhealthy instances.

", - "locationName":"replaceUnhealthyInstances" - }, - "SpotOptions":{ - "shape":"SpotOptions", - "documentation":"

The configuration of Spot Instances in an EC2 Fleet.

", - "locationName":"spotOptions" - }, - "OnDemandOptions":{ - "shape":"OnDemandOptions", - "documentation":"

The allocation strategy of On-Demand Instances in an EC2 Fleet.

", - "locationName":"onDemandOptions" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for an EC2 Fleet resource.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an EC2 Fleet.

" - }, - "FleetEventType":{ - "type":"string", - "enum":[ - "instance-change", - "fleet-change", - "service-error" - ] - }, - "FleetExcessCapacityTerminationPolicy":{ - "type":"string", - "enum":[ - "no-termination", - "termination" - ] - }, - "FleetIdSet":{ - "type":"list", - "member":{"shape":"FleetIdentifier"} - }, - "FleetIdentifier":{"type":"string"}, - "FleetLaunchTemplateConfig":{ - "type":"structure", - "members":{ - "LaunchTemplateSpecification":{ - "shape":"FleetLaunchTemplateSpecification", - "documentation":"

The launch template.

", - "locationName":"launchTemplateSpecification" - }, - "Overrides":{ - "shape":"FleetLaunchTemplateOverridesList", - "documentation":"

Any parameters that you specify override the same parameters in the launch template.

", - "locationName":"overrides" - } - }, - "documentation":"

Describes a launch template and overrides.

" - }, - "FleetLaunchTemplateConfigList":{ - "type":"list", - "member":{ - "shape":"FleetLaunchTemplateConfig", - "locationName":"item" - } - }, - "FleetLaunchTemplateConfigListRequest":{ - "type":"list", - "member":{ - "shape":"FleetLaunchTemplateConfigRequest", - "locationName":"item" - }, - "max":50 - }, - "FleetLaunchTemplateConfigRequest":{ - "type":"structure", - "members":{ - "LaunchTemplateSpecification":{ - "shape":"FleetLaunchTemplateSpecificationRequest", - "documentation":"

The launch template to use. You must specify either the launch template ID or launch template name in the request.

" - }, - "Overrides":{ - "shape":"FleetLaunchTemplateOverridesListRequest", - "documentation":"

Any parameters that you specify override the same parameters in the launch template.

" - } - }, - "documentation":"

Describes a launch template and overrides.

" - }, - "FleetLaunchTemplateOverrides":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "MaxPrice":{ - "shape":"String", - "documentation":"

The maximum price per unit hour that you are willing to pay for a Spot Instance.

", - "locationName":"maxPrice" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

", - "locationName":"subnetId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to launch the instances.

", - "locationName":"availabilityZone" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

", - "locationName":"weightedCapacity" - }, - "Priority":{ - "shape":"Double", - "documentation":"

The priority for the launch template override. If AllocationStrategy is set to prioritized, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. The highest priority is launched first. Valid values are whole numbers starting at 0. The lower the number, the higher the priority. If no number is set, the override has the lowest priority.

", - "locationName":"priority" - } - }, - "documentation":"

Describes overrides for a launch template.

" - }, - "FleetLaunchTemplateOverridesList":{ - "type":"list", - "member":{ - "shape":"FleetLaunchTemplateOverrides", - "locationName":"item" - } - }, - "FleetLaunchTemplateOverridesListRequest":{ - "type":"list", - "member":{ - "shape":"FleetLaunchTemplateOverridesRequest", - "locationName":"item" - }, - "max":50 - }, - "FleetLaunchTemplateOverridesRequest":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

" - }, - "MaxPrice":{ - "shape":"String", - "documentation":"

The maximum price per unit hour that you are willing to pay for a Spot Instance.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to launch the instances.

" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

" - }, - "Priority":{ - "shape":"Double", - "documentation":"

The priority for the launch template override. If AllocationStrategy is set to prioritized, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. The highest priority is launched first. Valid values are whole numbers starting at 0. The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority.

" - } - }, - "documentation":"

Describes overrides for a launch template.

" - }, - "FleetLaunchTemplateSpecification":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either a template ID or a template name.

", - "locationName":"launchTemplateId" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either a template name or a template ID.

", - "locationName":"launchTemplateName" - }, - "Version":{ - "shape":"String", - "documentation":"

The version number. By default, the default version of the launch template is used.

", - "locationName":"version" - } - }, - "documentation":"

Describes a launch template.

" - }, - "FleetLaunchTemplateSpecificationRequest":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version number of the launch template.

" - } - }, - "documentation":"

The launch template to use. You must specify either the launch template ID or launch template name in the request.

" - }, - "FleetOnDemandAllocationStrategy":{ - "type":"string", - "enum":[ - "lowest-price", - "prioritized" - ] - }, - "FleetSet":{ - "type":"list", - "member":{ - "shape":"FleetData", - "locationName":"item" - } - }, - "FleetStateCode":{ - "type":"string", - "enum":[ - "submitted", - "active", - "deleted", - "failed", - "deleted-running", - "deleted-terminating", - "modifying" - ] - }, - "FleetType":{ - "type":"string", - "enum":[ - "request", - "maintain" - ] - }, - "Float":{"type":"float"}, - "FlowLog":{ - "type":"structure", - "members":{ - "CreationTime":{ - "shape":"DateTime", - "documentation":"

The date and time the flow log was created.

", - "locationName":"creationTime" - }, - "DeliverLogsErrorMessage":{ - "shape":"String", - "documentation":"

Information about the error that occurred. Rate limited indicates that CloudWatch Logs throttling has been applied for one or more network interfaces, or that you've reached the limit on the number of log groups that you can create. Access error indicates that the IAM role associated with the flow log does not have sufficient permissions to publish to CloudWatch Logs. Unknown error indicates an internal error.

", - "locationName":"deliverLogsErrorMessage" - }, - "DeliverLogsPermissionArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that posts logs to CloudWatch Logs.

", - "locationName":"deliverLogsPermissionArn" - }, - "DeliverLogsStatus":{ - "shape":"String", - "documentation":"

The status of the logs delivery (SUCCESS | FAILED).

", - "locationName":"deliverLogsStatus" - }, - "FlowLogId":{ - "shape":"String", - "documentation":"

The flow log ID.

", - "locationName":"flowLogId" - }, - "FlowLogStatus":{ - "shape":"String", - "documentation":"

The status of the flow log (ACTIVE).

", - "locationName":"flowLogStatus" - }, - "LogGroupName":{ - "shape":"String", - "documentation":"

The name of the flow log group.

", - "locationName":"logGroupName" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource on which the flow log was created.

", - "locationName":"resourceId" - }, - "TrafficType":{ - "shape":"TrafficType", - "documentation":"

The type of traffic captured for the flow log.

", - "locationName":"trafficType" - }, - "LogDestinationType":{ - "shape":"LogDestinationType", - "documentation":"

Specifies the type of destination to which the flow log data is published. Flow log data can be published to CloudWatch Logs or Amazon S3.

", - "locationName":"logDestinationType" - }, - "LogDestination":{ - "shape":"String", - "documentation":"

Specifies the destination to which the flow log data is published. Flow log data can be published to an CloudWatch Logs log group or an Amazon S3 bucket. If the flow log publishes to CloudWatch Logs, this element indicates the Amazon Resource Name (ARN) of the CloudWatch Logs log group to which the data is published. If the flow log publishes to Amazon S3, this element indicates the ARN of the Amazon S3 bucket to which the data is published.

", - "locationName":"logDestination" - } - }, - "documentation":"

Describes a flow log.

" - }, - "FlowLogSet":{ - "type":"list", - "member":{ - "shape":"FlowLog", - "locationName":"item" - } - }, - "FlowLogsResourceType":{ - "type":"string", - "enum":[ - "VPC", - "Subnet", - "NetworkInterface" - ] - }, - "FpgaImage":{ - "type":"structure", - "members":{ - "FpgaImageId":{ - "shape":"String", - "documentation":"

The FPGA image identifier (AFI ID).

", - "locationName":"fpgaImageId" - }, - "FpgaImageGlobalId":{ - "shape":"String", - "documentation":"

The global FPGA image identifier (AGFI ID).

", - "locationName":"fpgaImageGlobalId" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AFI.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AFI.

", - "locationName":"description" - }, - "ShellVersion":{ - "shape":"String", - "documentation":"

The version of the AWS Shell that was used to create the bitstream.

", - "locationName":"shellVersion" - }, - "PciId":{ - "shape":"PciId", - "documentation":"

Information about the PCI bus.

", - "locationName":"pciId" - }, - "State":{ - "shape":"FpgaImageState", - "documentation":"

Information about the state of the AFI.

", - "locationName":"state" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the AFI was created.

", - "locationName":"createTime" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The time of the most recent update to the AFI.

", - "locationName":"updateTime" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the AFI owner.

", - "locationName":"ownerId" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

The alias of the AFI owner. Possible values include self, amazon, and aws-marketplace.

", - "locationName":"ownerAlias" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes for the AFI.

", - "locationName":"productCodes" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the AFI.

", - "locationName":"tags" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the AFI is public.

", - "locationName":"public" - } - }, - "documentation":"

Describes an Amazon FPGA image (AFI).

" - }, - "FpgaImageAttribute":{ - "type":"structure", - "members":{ - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the AFI.

", - "locationName":"fpgaImageId" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AFI.

", - "locationName":"name" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AFI.

", - "locationName":"description" - }, - "LoadPermissions":{ - "shape":"LoadPermissionList", - "documentation":"

One or more load permissions.

", - "locationName":"loadPermissions" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - } - }, - "documentation":"

Describes an Amazon FPGA image (AFI) attribute.

" - }, - "FpgaImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "name", - "loadPermission", - "productCodes" - ] - }, - "FpgaImageIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "FpgaImageList":{ - "type":"list", - "member":{ - "shape":"FpgaImage", - "locationName":"item" - } - }, - "FpgaImageState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"FpgaImageStateCode", - "documentation":"

The state. The following are the possible values:

  • pending - AFI bitstream generation is in progress.

  • available - The AFI is available for use.

  • failed - AFI bitstream generation failed.

  • unavailable - The AFI is no longer available for use.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

If the state is failed, this is the error message.

", - "locationName":"message" - } - }, - "documentation":"

Describes the state of the bitstream generation process for an Amazon FPGA image (AFI).

" - }, - "FpgaImageStateCode":{ - "type":"string", - "enum":[ - "pending", - "failed", - "available", - "unavailable" - ] - }, - "GatewayType":{ - "type":"string", - "enum":["ipsec.1"] - }, - "GetConsoleOutputRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Latest":{ - "shape":"Boolean", - "documentation":"

When enabled, retrieves the latest console output for the instance.

Default: disabled (false)

" - } - }, - "documentation":"

Contains the parameters for GetConsoleOutput.

" - }, - "GetConsoleOutputResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Output":{ - "shape":"String", - "documentation":"

The console output, base64-encoded. If you are using a command line tool, the tool decodes the output for you.

", - "locationName":"output" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time at which the output was last updated.

", - "locationName":"timestamp" - } - }, - "documentation":"

Contains the output of GetConsoleOutput.

" - }, - "GetConsoleScreenshotRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "WakeUp":{ - "shape":"Boolean", - "documentation":"

When set to true, acts as keystroke input and wakes up an instance that's in standby or \"sleep\" mode.

" - } - }, - "documentation":"

Contains the parameters for the request.

" - }, - "GetConsoleScreenshotResult":{ - "type":"structure", - "members":{ - "ImageData":{ - "shape":"String", - "documentation":"

The data that comprises the image.

", - "locationName":"imageData" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - } - }, - "documentation":"

Contains the output of the request.

" - }, - "GetHostReservationPurchasePreviewRequest":{ - "type":"structure", - "required":[ - "HostIdSet", - "OfferingId" - ], - "members":{ - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts with which the reservation is associated.

" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The offering ID of the reservation.

" - } - } - }, - "GetHostReservationPurchasePreviewResult":{ - "type":"structure", - "members":{ - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

The purchase information of the Dedicated Host reservation and the Dedicated Hosts associated with it.

", - "locationName":"purchase" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The potential total hourly price of the reservation per hour.

", - "locationName":"totalHourlyPrice" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The potential total upfront price. This is billed immediately.

", - "locationName":"totalUpfrontPrice" - } - } - }, - "GetLaunchTemplateDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - } - } - }, - "GetLaunchTemplateDataResult":{ - "type":"structure", - "members":{ - "LaunchTemplateData":{ - "shape":"ResponseLaunchTemplateData", - "documentation":"

The instance data.

", - "locationName":"launchTemplateData" - } - } - }, - "GetPasswordDataRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for GetPasswordData.

" - }, - "GetPasswordDataResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the Windows instance.

", - "locationName":"instanceId" - }, - "PasswordData":{ - "shape":"String", - "documentation":"

The password of the instance. Returns an empty string if the password is not available.

", - "locationName":"passwordData" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the data was last updated.

", - "locationName":"timestamp" - } - }, - "documentation":"

Contains the output of GetPasswordData.

" - }, - "GetReservedInstancesExchangeQuoteRequest":{ - "type":"structure", - "required":["ReservedInstanceIds"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ReservedInstanceIds":{ - "shape":"ReservedInstanceIdSet", - "documentation":"

The IDs of the Convertible Reserved Instances to exchange.

", - "locationName":"ReservedInstanceId" - }, - "TargetConfigurations":{ - "shape":"TargetConfigurationRequestSet", - "documentation":"

The configuration of the target Convertible Reserved Instance to exchange for your current Convertible Reserved Instances.

", - "locationName":"TargetConfiguration" - } - }, - "documentation":"

Contains the parameters for GetReservedInstanceExchangeQuote.

" - }, - "GetReservedInstancesExchangeQuoteResult":{ - "type":"structure", - "members":{ - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency of the transaction.

", - "locationName":"currencyCode" - }, - "IsValidExchange":{ - "shape":"Boolean", - "documentation":"

If true, the exchange is valid. If false, the exchange cannot be completed.

", - "locationName":"isValidExchange" - }, - "OutputReservedInstancesWillExpireAt":{ - "shape":"DateTime", - "documentation":"

The new end date of the reservation term.

", - "locationName":"outputReservedInstancesWillExpireAt" - }, - "PaymentDue":{ - "shape":"String", - "documentation":"

The total true upfront charge for the exchange.

", - "locationName":"paymentDue" - }, - "ReservedInstanceValueRollup":{ - "shape":"ReservationValue", - "documentation":"

The cost associated with the Reserved Instance.

", - "locationName":"reservedInstanceValueRollup" - }, - "ReservedInstanceValueSet":{ - "shape":"ReservedInstanceReservationValueSet", - "documentation":"

The configuration of your Convertible Reserved Instances.

", - "locationName":"reservedInstanceValueSet" - }, - "TargetConfigurationValueRollup":{ - "shape":"ReservationValue", - "documentation":"

The cost associated with the Reserved Instance.

", - "locationName":"targetConfigurationValueRollup" - }, - "TargetConfigurationValueSet":{ - "shape":"TargetReservationValueSet", - "documentation":"

The values of the target Convertible Reserved Instances.

", - "locationName":"targetConfigurationValueSet" - }, - "ValidationFailureReason":{ - "shape":"String", - "documentation":"

Describes the reason why the exchange cannot be completed.

", - "locationName":"validationFailureReason" - } - }, - "documentation":"

Contains the output of GetReservedInstancesExchangeQuote.

" - }, - "GroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"groupId" - } - }, - "GroupIdentifier":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - } - }, - "documentation":"

Describes a security group.

" - }, - "GroupIdentifierList":{ - "type":"list", - "member":{ - "shape":"GroupIdentifier", - "locationName":"item" - } - }, - "GroupIdentifierSet":{ - "type":"list", - "member":{ - "shape":"SecurityGroupIdentifier", - "locationName":"item" - } - }, - "GroupIds":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "GroupNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"GroupName" - } - }, - "HistoryRecord":{ - "type":"structure", - "required":[ - "EventInformation", - "EventType", - "Timestamp" - ], - "members":{ - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - }, - "EventType":{ - "shape":"EventType", - "documentation":"

The event type.

  • error - An error with the Spot Fleet request.

  • fleetRequestChange - A change in the status or configuration of the Spot Fleet request.

  • instanceChange - An instance was launched or terminated.

  • Information - An informational event.

", - "locationName":"eventType" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - } - }, - "documentation":"

Describes an event in the history of the Spot Fleet request.

" - }, - "HistoryRecordEntry":{ - "type":"structure", - "members":{ - "EventInformation":{ - "shape":"EventInformation", - "documentation":"

Information about the event.

", - "locationName":"eventInformation" - }, - "EventType":{ - "shape":"FleetEventType", - "documentation":"

The event type.

", - "locationName":"eventType" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time of the event, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - } - }, - "documentation":"

Describes an event in the history of an EC2 Fleet.

" - }, - "HistoryRecordSet":{ - "type":"list", - "member":{ - "shape":"HistoryRecordEntry", - "locationName":"item" - } - }, - "HistoryRecords":{ - "type":"list", - "member":{ - "shape":"HistoryRecord", - "locationName":"item" - } - }, - "Host":{ - "type":"structure", - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Whether auto-placement is on or off.

", - "locationName":"autoPlacement" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the Dedicated Host.

", - "locationName":"availabilityZone" - }, - "AvailableCapacity":{ - "shape":"AvailableCapacity", - "documentation":"

The number of new instances that can be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host.

", - "locationName":"hostId" - }, - "HostProperties":{ - "shape":"HostProperties", - "documentation":"

The hardware specifications of the Dedicated Host.

", - "locationName":"hostProperties" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The reservation ID of the Dedicated Host. This returns a null response if the Dedicated Host doesn't have an associated reservation.

", - "locationName":"hostReservationId" - }, - "Instances":{ - "shape":"HostInstanceList", - "documentation":"

The IDs and instance type that are currently running on the Dedicated Host.

", - "locationName":"instances" - }, - "State":{ - "shape":"AllocationState", - "documentation":"

The Dedicated Host's state.

", - "locationName":"state" - }, - "AllocationTime":{ - "shape":"DateTime", - "documentation":"

The time that the Dedicated Host was allocated.

", - "locationName":"allocationTime" - }, - "ReleaseTime":{ - "shape":"DateTime", - "documentation":"

The time that the Dedicated Host was released.

", - "locationName":"releaseTime" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the Dedicated Host.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes the properties of the Dedicated Host.

" - }, - "HostInstance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

the IDs of instances that are running on the Dedicated Host.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size (for example, m3.medium) of the running instance.

", - "locationName":"instanceType" - } - }, - "documentation":"

Describes an instance running on a Dedicated Host.

" - }, - "HostInstanceList":{ - "type":"list", - "member":{ - "shape":"HostInstance", - "locationName":"item" - } - }, - "HostList":{ - "type":"list", - "member":{ - "shape":"Host", - "locationName":"item" - } - }, - "HostOffering":{ - "type":"structure", - "members":{ - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the offering.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering (in seconds).

", - "locationName":"duration" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the offering.

", - "locationName":"hourlyPrice" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the offering.

", - "locationName":"instanceFamily" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

", - "locationName":"offeringId" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The available payment option.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the offering. Does not apply to No Upfront offerings.

", - "locationName":"upfrontPrice" - } - }, - "documentation":"

Details about the Dedicated Host Reservation offering.

" - }, - "HostOfferingSet":{ - "type":"list", - "member":{ - "shape":"HostOffering", - "locationName":"item" - } - }, - "HostProperties":{ - "type":"structure", - "members":{ - "Cores":{ - "shape":"Integer", - "documentation":"

The number of cores on the Dedicated Host.

", - "locationName":"cores" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size that the Dedicated Host supports (for example, m3.medium).

", - "locationName":"instanceType" - }, - "Sockets":{ - "shape":"Integer", - "documentation":"

The number of sockets on the Dedicated Host.

", - "locationName":"sockets" - }, - "TotalVCpus":{ - "shape":"Integer", - "documentation":"

The number of vCPUs on the Dedicated Host.

", - "locationName":"totalVCpus" - } - }, - "documentation":"

Describes properties of a Dedicated Host.

" - }, - "HostReservation":{ - "type":"structure", - "members":{ - "Count":{ - "shape":"Integer", - "documentation":"

The number of Dedicated Hosts the reservation is associated with.

", - "locationName":"count" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the upfrontPrice and hourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The length of the reservation's term, specified in seconds. Can be 31536000 (1 year) | 94608000 (3 years).

", - "locationName":"duration" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation ends.

", - "locationName":"end" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation that specifies the associated Dedicated Hosts.

", - "locationName":"hostReservationId" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation.

", - "locationName":"hourlyPrice" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family of the Dedicated Host Reservation. The instance family on the Dedicated Host must be the same in order for it to benefit from the reservation.

", - "locationName":"instanceFamily" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the reservation. This remains the same regardless of which Dedicated Hosts are associated with it.

", - "locationName":"offeringId" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option selected for this reservation.

", - "locationName":"paymentOption" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time that the reservation started.

", - "locationName":"start" - }, - "State":{ - "shape":"ReservationState", - "documentation":"

The state of the reservation.

", - "locationName":"state" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - } - }, - "documentation":"

Details about the Dedicated Host Reservation and associated Dedicated Hosts.

" - }, - "HostReservationIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "HostReservationSet":{ - "type":"list", - "member":{ - "shape":"HostReservation", - "locationName":"item" - } - }, - "HostTenancy":{ - "type":"string", - "enum":[ - "dedicated", - "host" - ] - }, - "HypervisorType":{ - "type":"string", - "enum":[ - "ovm", - "xen" - ] - }, - "IamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of the instance profile.

", - "locationName":"id" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IamInstanceProfileAssociation":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the association.

", - "locationName":"associationId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "State":{ - "shape":"IamInstanceProfileAssociationState", - "documentation":"

The state of the association.

", - "locationName":"state" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The time the IAM instance profile was associated with the instance.

", - "locationName":"timestamp" - } - }, - "documentation":"

Describes an association between an IAM instance profile and an instance.

" - }, - "IamInstanceProfileAssociationSet":{ - "type":"list", - "member":{ - "shape":"IamInstanceProfileAssociation", - "locationName":"item" - } - }, - "IamInstanceProfileAssociationState":{ - "type":"string", - "enum":[ - "associating", - "associated", - "disassociating", - "disassociated" - ] - }, - "IamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "IcmpTypeCode":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The ICMP code. A value of -1 means all codes for the specified ICMP type.

", - "locationName":"code" - }, - "Type":{ - "shape":"Integer", - "documentation":"

The ICMP type. A value of -1 means all types.

", - "locationName":"type" - } - }, - "documentation":"

Describes the ICMP type and code.

" - }, - "IdFormat":{ - "type":"structure", - "members":{ - "Deadline":{ - "shape":"DateTime", - "documentation":"

The date in UTC at which you are permanently switched over to using longer IDs. If a deadline is not yet available for this resource type, this field is not returned.

", - "locationName":"deadline" - }, - "Resource":{ - "shape":"String", - "documentation":"

The type of resource.

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether longer IDs (17-character IDs) are enabled for the resource.

", - "locationName":"useLongIds" - } - }, - "documentation":"

Describes the ID format for a resource.

" - }, - "IdFormatList":{ - "type":"list", - "member":{ - "shape":"IdFormat", - "locationName":"item" - } - }, - "Image":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "CreationDate":{ - "shape":"String", - "documentation":"

The date and time the image was created.

", - "locationName":"creationDate" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "ImageLocation":{ - "shape":"String", - "documentation":"

The location of the AMI.

", - "locationName":"imageLocation" - }, - "ImageType":{ - "shape":"ImageTypeValues", - "documentation":"

The type of image.

", - "locationName":"imageType" - }, - "Public":{ - "shape":"Boolean", - "documentation":"

Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.

", - "locationName":"isPublic" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with the image, if any. Only applicable for machine images.

", - "locationName":"kernelId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the image owner.

", - "locationName":"imageOwnerId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows AMIs; otherwise blank.

", - "locationName":"platform" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

Any product codes associated with the AMI.

", - "locationName":"productCodes" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with the image, if any. Only applicable for machine images.

", - "locationName":"ramdiskId" - }, - "State":{ - "shape":"ImageState", - "documentation":"

The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.

", - "locationName":"imageState" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

Any block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the AMI that was provided during image creation.

", - "locationName":"description" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the image.

", - "locationName":"hypervisor" - }, - "ImageOwnerAlias":{ - "shape":"String", - "documentation":"

The AWS account alias (for example, amazon, self) or the AWS account ID of the AMI owner.

", - "locationName":"imageOwnerAlias" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the AMI that was provided during image creation.

", - "locationName":"name" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device volume (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of root device used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the state change.

", - "locationName":"stateReason" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the image.

", - "locationName":"tagSet" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization of the AMI.

", - "locationName":"virtualizationType" - } - }, - "documentation":"

Describes an image.

" - }, - "ImageAttribute":{ - "type":"structure", - "members":{ - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "LaunchPermissions":{ - "shape":"LaunchPermissionList", - "documentation":"

One or more launch permissions.

", - "locationName":"launchPermission" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

One or more product codes.

", - "locationName":"productCodes" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the AMI.

", - "locationName":"description" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - } - }, - "documentation":"

Describes an image attribute.

" - }, - "ImageAttributeName":{ - "type":"string", - "enum":[ - "description", - "kernel", - "ramdisk", - "launchPermission", - "productCodes", - "blockDeviceMapping", - "sriovNetSupport" - ] - }, - "ImageDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image.

" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the disk.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: VHD | VMDK | OVA

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the EBS snapshot to be used for importing the snapshot.

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - } - }, - "documentation":"

Describes the disk container object for an import image task.

" - }, - "ImageDiskContainerList":{ - "type":"list", - "member":{ - "shape":"ImageDiskContainer", - "locationName":"item" - } - }, - "ImageIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImageId" - } - }, - "ImageList":{ - "type":"list", - "member":{ - "shape":"Image", - "locationName":"item" - } - }, - "ImageState":{ - "type":"string", - "enum":[ - "pending", - "available", - "invalid", - "deregistered", - "transient", - "failed", - "error" - ] - }, - "ImageTypeValues":{ - "type":"string", - "enum":[ - "machine", - "kernel", - "ramdisk" - ] - }, - "ImportImageRequest":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

" - }, - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The token to enable idempotency for VM import requests.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description string for the import image task.

" - }, - "DiskContainers":{ - "shape":"ImageDiskContainerList", - "documentation":"

Information about the disk containers.

", - "locationName":"DiskContainer" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor platform.

Valid values: xen

" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type to be used for the Amazon Machine Image (AMI) after importing.

Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.

Valid values: AWS | BYOL

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

Valid values: Windows | Linux

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportImage.

" - }, - "ImportImageResult":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

", - "locationName":"architecture" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor of the import task.

", - "locationName":"hypervisor" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) created by the import task.

", - "locationName":"imageId" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The task ID of the import image task.

", - "locationName":"importTaskId" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The operating system of the virtual machine.

", - "locationName":"platform" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the task.

", - "locationName":"progress" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the task.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message of the import task.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Contains the output for ImportImage.

" - }, - "ImportImageTask":{ - "type":"structure", - "members":{ - "Architecture":{ - "shape":"String", - "documentation":"

The architecture of the virtual machine.

Valid values: i386 | x86_64

", - "locationName":"architecture" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the import task.

", - "locationName":"description" - }, - "Hypervisor":{ - "shape":"String", - "documentation":"

The target hypervisor for the import task.

Valid values: xen

", - "locationName":"hypervisor" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

", - "locationName":"imageId" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import image task.

", - "locationName":"importTaskId" - }, - "LicenseType":{ - "shape":"String", - "documentation":"

The license type of the virtual machine.

", - "locationName":"licenseType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The description string for the import image task.

", - "locationName":"platform" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress of the import image task.

", - "locationName":"progress" - }, - "SnapshotDetails":{ - "shape":"SnapshotDetailList", - "documentation":"

Information about the snapshots.

", - "locationName":"snapshotDetailSet" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import image task.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A descriptive status message for the import image task.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes an import image task.

" - }, - "ImportImageTaskList":{ - "type":"list", - "member":{ - "shape":"ImportImageTask", - "locationName":"item" - } - }, - "ImportInstanceLaunchSpecification":{ - "type":"structure", - "members":{ - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the instance.

", - "locationName":"architecture" - }, - "GroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"GroupId" - }, - "GroupNames":{ - "shape":"SecurityGroupStringList", - "documentation":"

One or more security group names.

", - "locationName":"GroupName" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information about the instance types that you can import, see Instance Types in the VM Import/Export User Guide.

", - "locationName":"instanceType" - }, - "Monitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

", - "locationName":"monitoring" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] An available IP address from the IP address range of the subnet.

", - "locationName":"privateIpAddress" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "UserData":{ - "shape":"UserData", - "documentation":"

The Base64-encoded user data to make available to the instance.

", - "locationName":"userData" - } - }, - "documentation":"

Describes the launch specification for VM import.

" - }, - "ImportInstanceRequest":{ - "type":"structure", - "required":["Platform"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the instance being imported.

", - "locationName":"description" - }, - "DiskImages":{ - "shape":"DiskImageList", - "documentation":"

The disk image.

", - "locationName":"diskImage" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "LaunchSpecification":{ - "shape":"ImportInstanceLaunchSpecification", - "documentation":"

The launch specification.

", - "locationName":"launchSpecification" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - } - }, - "documentation":"

Contains the parameters for ImportInstance.

" - }, - "ImportInstanceResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportInstance.

" - }, - "ImportInstanceTaskDetails":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The instance operating system.

", - "locationName":"platform" - }, - "Volumes":{ - "shape":"ImportInstanceVolumeDetailSet", - "documentation":"

One or more volumes.

", - "locationName":"volumes" - } - }, - "documentation":"

Describes an import instance task.

" - }, - "ImportInstanceVolumeDetailItem":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "BytesConverted", - "Image", - "Status", - "Volume" - ], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting instance will reside.

", - "locationName":"availabilityZone" - }, - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the import of this particular disk image.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The status information or errors related to the disk image.

", - "locationName":"statusMessage" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "ImportInstanceVolumeDetailSet":{ - "type":"list", - "member":{ - "shape":"ImportInstanceVolumeDetailItem", - "locationName":"item" - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "KeyName", - "PublicKeyMaterial" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "KeyName":{ - "shape":"String", - "documentation":"

A unique name for the key pair.

", - "locationName":"keyName" - }, - "PublicKeyMaterial":{ - "shape":"Blob", - "documentation":"

The public key. For API calls, the text must be base64-encoded. For command line tools, base64 encoding is performed for you.

", - "locationName":"publicKeyMaterial" - } - }, - "documentation":"

Contains the parameters for ImportKeyPair.

" - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The MD5 public key fingerprint as specified in section 4 of RFC 4716.

", - "locationName":"keyFingerprint" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The key pair name you provided.

", - "locationName":"keyName" - } - }, - "documentation":"

Contains the output of ImportKeyPair.

" - }, - "ImportSnapshotRequest":{ - "type":"structure", - "members":{ - "ClientData":{ - "shape":"ClientData", - "documentation":"

The client-specific data.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Token to enable idempotency for VM import requests.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description string for the import snapshot task.

" - }, - "DiskContainer":{ - "shape":"SnapshotDiskContainer", - "documentation":"

Information about the disk container.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "RoleName":{ - "shape":"String", - "documentation":"

The name of the role to use when not using the default role, 'vmimport'.

" - } - }, - "documentation":"

Contains the parameters for ImportSnapshot.

" - }, - "ImportSnapshotResult":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Information about the import snapshot task.

", - "locationName":"snapshotTaskDetail" - } - }, - "documentation":"

Contains the output for ImportSnapshot.

" - }, - "ImportSnapshotTask":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the import snapshot task.

", - "locationName":"description" - }, - "ImportTaskId":{ - "shape":"String", - "documentation":"

The ID of the import snapshot task.

", - "locationName":"importTaskId" - }, - "SnapshotTaskDetail":{ - "shape":"SnapshotTaskDetail", - "documentation":"

Describes an import snapshot task.

", - "locationName":"snapshotTaskDetail" - } - }, - "documentation":"

Describes an import snapshot task.

" - }, - "ImportSnapshotTaskList":{ - "type":"list", - "member":{ - "shape":"ImportSnapshotTask", - "locationName":"item" - } - }, - "ImportTaskIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ImportTaskId" - } - }, - "ImportVolumeRequest":{ - "type":"structure", - "required":[ - "AvailabilityZone", - "Image", - "Volume" - ], - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the resulting EBS volume.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the volume.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Image":{ - "shape":"DiskImageDetail", - "documentation":"

The disk image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"VolumeDetail", - "documentation":"

The volume size.

", - "locationName":"volume" - } - }, - "documentation":"

Contains the parameters for ImportVolume.

" - }, - "ImportVolumeResult":{ - "type":"structure", - "members":{ - "ConversionTask":{ - "shape":"ConversionTask", - "documentation":"

Information about the conversion task.

", - "locationName":"conversionTask" - } - }, - "documentation":"

Contains the output for ImportVolume.

" - }, - "ImportVolumeTaskDetails":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the resulting volume will reside.

", - "locationName":"availabilityZone" - }, - "BytesConverted":{ - "shape":"Long", - "documentation":"

The number of bytes converted so far.

", - "locationName":"bytesConverted" - }, - "Description":{ - "shape":"String", - "documentation":"

The description you provided when starting the import volume task.

", - "locationName":"description" - }, - "Image":{ - "shape":"DiskImageDescription", - "documentation":"

The image.

", - "locationName":"image" - }, - "Volume":{ - "shape":"DiskImageVolumeDescription", - "documentation":"

The volume.

", - "locationName":"volume" - } - }, - "documentation":"

Describes an import volume task.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "AmiLaunchIndex":{ - "shape":"Integer", - "documentation":"

The AMI launch index, which can be used to find this instance in the launch group.

", - "locationName":"amiLaunchIndex" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI used to launch the instance.

", - "locationName":"imageId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The kernel associated with this instance, if applicable.

", - "locationName":"kernelId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair, if this instance was launched with an associated key pair.

", - "locationName":"keyName" - }, - "LaunchTime":{ - "shape":"DateTime", - "documentation":"

The time the instance was launched.

", - "locationName":"launchTime" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring for the instance.

", - "locationName":"monitoring" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The location where the instance launched, if applicable.

", - "locationName":"placement" - }, - "Platform":{ - "shape":"PlatformValues", - "documentation":"

The value is Windows for Windows instances; otherwise blank.

", - "locationName":"platform" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

(IPv4 only) The private DNS hostname name assigned to the instance. This DNS hostname can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

[EC2-VPC] The Amazon-provided DNS server resolves Amazon-provided private DNS hostnames if you've enabled DNS resolution and DNS hostnames in your VPC. If you are not using the Amazon-provided DNS server in your VPC, your custom domain name servers must resolve the hostname as appropriate.

", - "locationName":"privateDnsName" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IPv4 address assigned to the instance.

", - "locationName":"privateIpAddress" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

The product codes attached to this instance, if applicable.

", - "locationName":"productCodes" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

(IPv4 only) The public DNS name assigned to the instance. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "locationName":"dnsName" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IPv4 address assigned to the instance, if applicable.

", - "locationName":"ipAddress" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The RAM disk associated with this instance, if applicable.

", - "locationName":"ramdiskId" - }, - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"instanceState" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason for the most recent state transition. This might be an empty string.

", - "locationName":"reason" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet in which the instance is running.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC in which the instance is running.

", - "locationName":"vpcId" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the image.

", - "locationName":"architecture" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

Any block device mapping entries for the instance.

", - "locationName":"blockDeviceMapping" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

The idempotency token you provided when you launched the instance, if applicable.

", - "locationName":"clientToken" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Specifies whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "Hypervisor":{ - "shape":"HypervisorType", - "documentation":"

The hypervisor type of the instance.

", - "locationName":"hypervisor" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfile", - "documentation":"

The IAM instance profile associated with the instance, if applicable.

", - "locationName":"iamInstanceProfile" - }, - "InstanceLifecycle":{ - "shape":"InstanceLifecycleType", - "documentation":"

Indicates whether this is a Spot Instance or a Scheduled Instance.

", - "locationName":"instanceLifecycle" - }, - "ElasticGpuAssociations":{ - "shape":"ElasticGpuAssociationList", - "documentation":"

The Elastic GPU associated with the instance.

", - "locationName":"elasticGpuAssociationSet" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceList", - "documentation":"

[EC2-VPC] One or more network interfaces for the instance.

", - "locationName":"networkInterfaceSet" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device volume (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "RootDeviceType":{ - "shape":"DeviceType", - "documentation":"

The root device type used by the AMI. The AMI can use an EBS volume or an instance store volume.

", - "locationName":"rootDeviceType" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups for the instance.

", - "locationName":"groupSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Specifies whether to enable an instance launched in a VPC to perform NAT. This controls whether source/destination checking is enabled on the instance. A value of true means that checking is enabled, and false means that checking is disabled. The value must be false for the instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

If the request is a Spot Instance request, the ID of the request.

", - "locationName":"spotInstanceRequestId" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "StateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the most recent state transition.

", - "locationName":"stateReason" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the instance.

", - "locationName":"tagSet" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The virtualization type of the instance.

", - "locationName":"virtualizationType" - }, - "CpuOptions":{ - "shape":"CpuOptions", - "documentation":"

The CPU options for the instance.

", - "locationName":"cpuOptions" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceAttribute":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

The security groups associated with the instance.

", - "locationName":"groupSet" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingList", - "documentation":"

The block device mapping of the instance.

", - "locationName":"blockDeviceMapping" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance through the Amazon EC2 console, CLI, or API; otherwise, you can.

", - "locationName":"disableApiTermination" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether enhanced networking with ENA is enabled.

", - "locationName":"enaSupport" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O.

", - "locationName":"ebsOptimized" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"AttributeValue", - "documentation":"

The kernel ID.

", - "locationName":"kernel" - }, - "ProductCodes":{ - "shape":"ProductCodeList", - "documentation":"

A list of product codes.

", - "locationName":"productCodes" - }, - "RamdiskId":{ - "shape":"AttributeValue", - "documentation":"

The RAM disk ID.

", - "locationName":"ramdisk" - }, - "RootDeviceName":{ - "shape":"AttributeValue", - "documentation":"

The device name of the root device volume (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means that checking is enabled, and false means that checking is disabled. This value must be false for a NAT instance to perform NAT.

", - "locationName":"sourceDestCheck" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

", - "locationName":"sriovNetSupport" - }, - "UserData":{ - "shape":"AttributeValue", - "documentation":"

The user data.

", - "locationName":"userData" - } - }, - "documentation":"

Describes an instance attribute.

" - }, - "InstanceAttributeName":{ - "type":"string", - "enum":[ - "instanceType", - "kernel", - "ramdisk", - "userData", - "disableApiTermination", - "instanceInitiatedShutdownBehavior", - "rootDeviceName", - "blockDeviceMapping", - "productCodes", - "sourceDestCheck", - "groupSet", - "ebsOptimized", - "sriovNetSupport", - "enaSupport" - ] - }, - "InstanceBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDevice", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "InstanceBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMapping", - "locationName":"item" - } - }, - "InstanceBlockDeviceMappingSpecification":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

", - "locationName":"deviceName" - }, - "Ebs":{ - "shape":"EbsInstanceBlockDeviceSpecification", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

suppress the specified device included in the block device mapping.

", - "locationName":"noDevice" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name.

", - "locationName":"virtualName" - } - }, - "documentation":"

Describes a block device mapping entry.

" - }, - "InstanceBlockDeviceMappingSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceBlockDeviceMappingSpecification", - "locationName":"item" - } - }, - "InstanceCapacity":{ - "type":"structure", - "members":{ - "AvailableCapacity":{ - "shape":"Integer", - "documentation":"

The number of instances that can still be launched onto the Dedicated Host.

", - "locationName":"availableCapacity" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type size supported by the Dedicated Host.

", - "locationName":"instanceType" - }, - "TotalCapacity":{ - "shape":"Integer", - "documentation":"

The total number of instances that can be launched onto the Dedicated Host.

", - "locationName":"totalCapacity" - } - }, - "documentation":"

Information about the instance type that the Dedicated Host supports.

" - }, - "InstanceCount":{ - "type":"structure", - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of listed Reserved Instances in the state specified by the state.

", - "locationName":"instanceCount" - }, - "State":{ - "shape":"ListingState", - "documentation":"

The states of the listed Reserved Instances.

", - "locationName":"state" - } - }, - "documentation":"

Describes a Reserved Instance listing state.

" - }, - "InstanceCountList":{ - "type":"list", - "member":{ - "shape":"InstanceCount", - "locationName":"item" - } - }, - "InstanceCreditSpecification":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "CpuCredits":{ - "shape":"String", - "documentation":"

The credit option for CPU usage of the instance. Valid values are standard and unlimited.

", - "locationName":"cpuCredits" - } - }, - "documentation":"

Describes the credit option for CPU usage of a T2 instance.

" - }, - "InstanceCreditSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceCreditSpecification", - "locationName":"item" - } - }, - "InstanceCreditSpecificationListRequest":{ - "type":"list", - "member":{ - "shape":"InstanceCreditSpecificationRequest", - "locationName":"item" - } - }, - "InstanceCreditSpecificationRequest":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

" - }, - "CpuCredits":{ - "shape":"String", - "documentation":"

The credit option for CPU usage of the instance. Valid values are standard and unlimited.

" - } - }, - "documentation":"

Describes the credit option for CPU usage of a T2 instance.

" - }, - "InstanceExportDetails":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the resource being exported.

", - "locationName":"instanceId" - }, - "TargetEnvironment":{ - "shape":"ExportEnvironment", - "documentation":"

The target virtualization environment.

", - "locationName":"targetEnvironment" - } - }, - "documentation":"

Describes an instance to export.

" - }, - "InstanceHealthStatus":{ - "type":"string", - "enum":[ - "healthy", - "unhealthy" - ] - }, - "InstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "InstanceIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"InstanceId" - } - }, - "InstanceInterruptionBehavior":{ - "type":"string", - "enum":[ - "hibernate", - "stop", - "terminate" - ] - }, - "InstanceIpv6Address":{ - "type":"structure", - "members":{ - "Ipv6Address":{ - "shape":"String", - "documentation":"

The IPv6 address.

", - "locationName":"ipv6Address" - } - }, - "documentation":"

Describes an IPv6 address.

" - }, - "InstanceIpv6AddressList":{ - "type":"list", - "member":{ - "shape":"InstanceIpv6Address", - "locationName":"item" - } - }, - "InstanceIpv6AddressListRequest":{ - "type":"list", - "member":{ - "shape":"InstanceIpv6AddressRequest", - "locationName":"InstanceIpv6Address" - } - }, - "InstanceIpv6AddressRequest":{ - "type":"structure", - "members":{ - "Ipv6Address":{ - "shape":"String", - "documentation":"

The IPv6 address.

" - } - }, - "documentation":"

Describes an IPv6 address.

" - }, - "InstanceLifecycleType":{ - "type":"string", - "enum":[ - "spot", - "scheduled" - ] - }, - "InstanceList":{ - "type":"list", - "member":{ - "shape":"Instance", - "locationName":"item" - } - }, - "InstanceMarketOptionsRequest":{ - "type":"structure", - "members":{ - "MarketType":{ - "shape":"MarketType", - "documentation":"

The market type.

" - }, - "SpotOptions":{ - "shape":"SpotMarketOptions", - "documentation":"

The options for Spot Instances.

" - } - }, - "documentation":"

Describes the market (purchasing) option for the instances.

" - }, - "InstanceMonitoring":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Monitoring":{ - "shape":"Monitoring", - "documentation":"

The monitoring for the instance.

", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the monitoring of an instance.

" - }, - "InstanceMonitoringList":{ - "type":"list", - "member":{ - "shape":"InstanceMonitoring", - "locationName":"item" - } - }, - "InstanceNetworkInterface":{ - "type":"structure", - "members":{ - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IPv4 associated with the network interface.

", - "locationName":"association" - }, - "Attachment":{ - "shape":"InstanceNetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

", - "locationName":"description" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups.

", - "locationName":"groupSet" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressList", - "documentation":"

One or more IPv6 addresses associated with the network interface.

", - "locationName":"ipv6AddressesSet" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that created the network interface.

", - "locationName":"ownerId" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IPv4 address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateIpAddresses":{ - "shape":"InstancePrivateIpAddressList", - "documentation":"

One or more private IPv4 addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether to validate network traffic to or from this network interface.

", - "locationName":"sourceDestCheck" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the owner of the Elastic IP address.

", - "locationName":"ipOwnerId" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The public IP address or Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - } - }, - "documentation":"

Describes association information for an Elastic IP address (IPv4).

" - }, - "InstanceNetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "InstanceNetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterface", - "locationName":"item" - } - }, - "InstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IPv4 address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", - "locationName":"associatePublicIpAddress" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", - "locationName":"deleteOnTermination" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"description" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device on the instance for the network interface attachment. If you are specifying a network interface in a RunInstances request, you must provide the device index.

", - "locationName":"deviceIndex" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of the security groups for the network interface. Applies only if creating a network interface when launching an instance.

", - "locationName":"SecurityGroupId" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

A number of IPv6 addresses to assign to the network interface. Amazon EC2 chooses the IPv6 addresses from the range of the subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch.

", - "locationName":"ipv6AddressCount" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressList", - "documentation":"

One or more IPv6 addresses to assign to the network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch.

", - "locationName":"ipv6AddressesSet", - "queryName":"Ipv6Addresses" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IPv4 address of the network interface. Applies only if creating a network interface when launching an instance. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"privateIpAddress" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IPv4 addresses to assign to the network interface. Only one private IPv4 address can be designated as primary. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"privateIpAddressesSet", - "queryName":"PrivateIpAddresses" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IPv4 addresses. You can't specify this option and specify more than one private IP address using the private IP addresses option. You cannot specify this option if you're launching more than one instance in a RunInstances request.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet associated with the network string. Applies only if creating a network interface when launching an instance.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes a network interface.

" - }, - "InstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"InstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "InstancePrivateIpAddress":{ - "type":"structure", - "members":{ - "Association":{ - "shape":"InstanceNetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address for the network interface.

", - "locationName":"association" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IPv4 address is the primary private IP address of the network interface.

", - "locationName":"primary" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private IPv4 DNS name.

", - "locationName":"privateDnsName" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IPv4 address of the network interface.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes a private IPv4 address.

" - }, - "InstancePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"InstancePrivateIpAddress", - "locationName":"item" - } - }, - "InstanceState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"Integer", - "documentation":"

The low byte represents the state. The high byte is used for internal purposes and should be ignored.

  • 0 : pending

  • 16 : running

  • 32 : shutting-down

  • 48 : terminated

  • 64 : stopping

  • 80 : stopped

", - "locationName":"code" - }, - "Name":{ - "shape":"InstanceStateName", - "documentation":"

The current state of the instance.

", - "locationName":"name" - } - }, - "documentation":"

Describes the current state of an instance.

" - }, - "InstanceStateChange":{ - "type":"structure", - "members":{ - "CurrentState":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

", - "locationName":"currentState" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "PreviousState":{ - "shape":"InstanceState", - "documentation":"

The previous state of the instance.

", - "locationName":"previousState" - } - }, - "documentation":"

Describes an instance state change.

" - }, - "InstanceStateChangeList":{ - "type":"list", - "member":{ - "shape":"InstanceStateChange", - "locationName":"item" - } - }, - "InstanceStateName":{ - "type":"string", - "enum":[ - "pending", - "running", - "shutting-down", - "terminated", - "stopping", - "stopped" - ] - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"InstanceStatusEventList", - "documentation":"

Any scheduled events associated with the instance.

", - "locationName":"eventsSet" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceState":{ - "shape":"InstanceState", - "documentation":"

The intended state of the instance. DescribeInstanceStatus requires that an instance be in the running state.

", - "locationName":"instanceState" - }, - "InstanceStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues internal to the instance, such as impaired reachability.

", - "locationName":"instanceStatus" - }, - "SystemStatus":{ - "shape":"InstanceStatusSummary", - "documentation":"

Reports impaired functionality that stems from issues related to the systems that support an instance, such as hardware failures and network connectivity problems.

", - "locationName":"systemStatus" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceStatusDetails":{ - "type":"structure", - "members":{ - "ImpairedSince":{ - "shape":"DateTime", - "documentation":"

The time when a status check failed. For an instance that was launched and impaired, this is the time when the instance was launched.

", - "locationName":"impairedSince" - }, - "Name":{ - "shape":"StatusName", - "documentation":"

The type of instance status.

", - "locationName":"name" - }, - "Status":{ - "shape":"StatusType", - "documentation":"

The status.

", - "locationName":"status" - } - }, - "documentation":"

Describes the instance status.

" - }, - "InstanceStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusDetails", - "locationName":"item" - } - }, - "InstanceStatusEvent":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"EventCode", - "documentation":"

The event code.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].

", - "locationName":"description" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest scheduled end time for the event.

", - "locationName":"notAfter" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest scheduled start time for the event.

", - "locationName":"notBefore" - } - }, - "documentation":"

Describes a scheduled event for an instance.

" - }, - "InstanceStatusEventList":{ - "type":"list", - "member":{ - "shape":"InstanceStatusEvent", - "locationName":"item" - } - }, - "InstanceStatusList":{ - "type":"list", - "member":{ - "shape":"InstanceStatus", - "locationName":"item" - } - }, - "InstanceStatusSummary":{ - "type":"structure", - "members":{ - "Details":{ - "shape":"InstanceStatusDetailsList", - "documentation":"

The system instance health or application instance health.

", - "locationName":"details" - }, - "Status":{ - "shape":"SummaryStatus", - "documentation":"

The status.

", - "locationName":"status" - } - }, - "documentation":"

Describes the status of an instance.

" - }, - "InstanceType":{ - "type":"string", - "enum":[ - "t1.micro", - "t2.nano", - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "t2.xlarge", - "t2.2xlarge", - "m1.small", - "m1.medium", - "m1.large", - "m1.xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "m4.16xlarge", - "m2.xlarge", - "m2.2xlarge", - "m2.4xlarge", - "cr1.8xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "r4.large", - "r4.xlarge", - "r4.2xlarge", - "r4.4xlarge", - "r4.8xlarge", - "r4.16xlarge", - "r5.large", - "r5.xlarge", - "r5.2xlarge", - "r5.4xlarge", - "r5.8xlarge", - "r5.12xlarge", - "r5.16xlarge", - "r5.24xlarge", - "r5.metal", - "r5d.large", - "r5d.xlarge", - "r5d.2xlarge", - "r5d.4xlarge", - "r5d.8xlarge", - "r5d.12xlarge", - "r5d.16xlarge", - "r5d.24xlarge", - "r5d.metal", - "x1.16xlarge", - "x1.32xlarge", - "x1e.xlarge", - "x1e.2xlarge", - "x1e.4xlarge", - "x1e.8xlarge", - "x1e.16xlarge", - "x1e.32xlarge", - "i2.xlarge", - "i2.2xlarge", - "i2.4xlarge", - "i2.8xlarge", - "i3.large", - "i3.xlarge", - "i3.2xlarge", - "i3.4xlarge", - "i3.8xlarge", - "i3.16xlarge", - "i3.metal", - "hi1.4xlarge", - "hs1.8xlarge", - "c1.medium", - "c1.xlarge", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "c5.large", - "c5.xlarge", - "c5.2xlarge", - "c5.4xlarge", - "c5.9xlarge", - "c5.18xlarge", - "c5d.large", - "c5d.xlarge", - "c5d.2xlarge", - "c5d.4xlarge", - "c5d.9xlarge", - "c5d.18xlarge", - "cc1.4xlarge", - "cc2.8xlarge", - "g2.2xlarge", - "g2.8xlarge", - "g3.4xlarge", - "g3.8xlarge", - "g3.16xlarge", - "cg1.4xlarge", - "p2.xlarge", - "p2.8xlarge", - "p2.16xlarge", - "p3.2xlarge", - "p3.8xlarge", - "p3.16xlarge", - "d2.xlarge", - "d2.2xlarge", - "d2.4xlarge", - "d2.8xlarge", - "f1.2xlarge", - "f1.16xlarge", - "m5.large", - "m5.xlarge", - "m5.2xlarge", - "m5.4xlarge", - "m5.12xlarge", - "m5.24xlarge", - "m5d.large", - "m5d.xlarge", - "m5d.2xlarge", - "m5d.4xlarge", - "m5d.12xlarge", - "m5d.24xlarge", - "h1.2xlarge", - "h1.4xlarge", - "h1.8xlarge", - "h1.16xlarge", - "z1d.large", - "z1d.xlarge", - "z1d.2xlarge", - "z1d.3xlarge", - "z1d.6xlarge", - "z1d.12xlarge" - ] - }, - "InstanceTypeList":{ - "type":"list", - "member":{"shape":"InstanceType"} - }, - "Integer":{"type":"integer"}, - "InterfacePermissionType":{ - "type":"string", - "enum":[ - "INSTANCE-ATTACH", - "EIP-ASSOCIATE" - ] - }, - "InternetGateway":{ - "type":"structure", - "members":{ - "Attachments":{ - "shape":"InternetGatewayAttachmentList", - "documentation":"

Any VPCs attached to the internet gateway.

", - "locationName":"attachmentSet" - }, - "InternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the internet gateway.

", - "locationName":"internetGatewayId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the internet gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes an internet gateway.

" - }, - "InternetGatewayAttachment":{ - "type":"structure", - "members":{ - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment. For an internet gateway, the state is available when attached to a VPC; otherwise, this value is not returned.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes the attachment of a VPC to an internet gateway or an egress-only internet gateway.

" - }, - "InternetGatewayAttachmentList":{ - "type":"list", - "member":{ - "shape":"InternetGatewayAttachment", - "locationName":"item" - } - }, - "InternetGatewayList":{ - "type":"list", - "member":{ - "shape":"InternetGateway", - "locationName":"item" - } - }, - "IpPermission":{ - "type":"structure", - "members":{ - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type number. A value of -1 indicates all ICMP/ICMPv6 types. If you specify all ICMP/ICMPv6 types, you must specify all codes.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers).

[EC2-VPC only] Use -1 to specify all protocols. When authorizing security group rules, specifying -1 or a protocol number other than tcp, udp, icmp, or 58 (ICMPv6) allows traffic on all ports, regardless of any port range you specify. For tcp, udp, and icmp, you must specify a port range. For 58 (ICMPv6), you can optionally specify a port range; if you don't, traffic for all types and codes is allowed when authorizing rules.

", - "locationName":"ipProtocol" - }, - "IpRanges":{ - "shape":"IpRangeList", - "documentation":"

One or more IPv4 ranges.

", - "locationName":"ipRanges" - }, - "Ipv6Ranges":{ - "shape":"Ipv6RangeList", - "documentation":"

[EC2-VPC only] One or more IPv6 ranges.

", - "locationName":"ipv6Ranges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdList", - "documentation":"

(EC2-VPC only; valid for AuthorizeSecurityGroupEgress, RevokeSecurityGroupEgress and DescribeSecurityGroups only) One or more prefix list IDs for an AWS service. In an AuthorizeSecurityGroupEgress request, this is the AWS service that you want to access through a VPC endpoint from instances associated with the security group.

", - "locationName":"prefixListIds" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code. A value of -1 indicates all ICMP/ICMPv6 codes for the specified ICMP type. If you specify all ICMP/ICMPv6 types, you must specify all codes.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairList", - "documentation":"

One or more security group and AWS account ID pairs.

", - "locationName":"groups" - } - }, - "documentation":"

Describes a set of permissions for a security group rule.

" - }, - "IpPermissionList":{ - "type":"list", - "member":{ - "shape":"IpPermission", - "locationName":"item" - } - }, - "IpRange":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The IPv4 CIDR range. You can either specify a CIDR range or a source security group, not both. To specify a single IPv4 address, use the /32 prefix length.

", - "locationName":"cidrIp" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group rule that references this IPv4 address range.

Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

", - "locationName":"description" - } - }, - "documentation":"

Describes an IPv4 range.

" - }, - "IpRangeList":{ - "type":"list", - "member":{ - "shape":"IpRange", - "locationName":"item" - } - }, - "IpRanges":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "Ipv6Address":{"type":"string"}, - "Ipv6AddressList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "Ipv6CidrBlock":{ - "type":"structure", - "members":{ - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block.

", - "locationName":"ipv6CidrBlock" - } - }, - "documentation":"

Describes an IPv6 CIDR block.

" - }, - "Ipv6CidrBlockSet":{ - "type":"list", - "member":{ - "shape":"Ipv6CidrBlock", - "locationName":"item" - } - }, - "Ipv6Range":{ - "type":"structure", - "members":{ - "CidrIpv6":{ - "shape":"String", - "documentation":"

The IPv6 CIDR range. You can either specify a CIDR range or a source security group, not both. To specify a single IPv6 address, use the /128 prefix length.

", - "locationName":"cidrIpv6" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group rule that references this IPv6 address range.

Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

", - "locationName":"description" - } - }, - "documentation":"

[EC2-VPC only] Describes an IPv6 range.

" - }, - "Ipv6RangeList":{ - "type":"list", - "member":{ - "shape":"Ipv6Range", - "locationName":"item" - } - }, - "KeyNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"KeyName" - } - }, - "KeyPair":{ - "type":"structure", - "members":{ - "KeyFingerprint":{ - "shape":"String", - "documentation":"

The SHA-1 digest of the DER encoded private key.

", - "locationName":"keyFingerprint" - }, - "KeyMaterial":{ - "shape":"String", - "documentation":"

An unencrypted PEM encoded RSA private key.

", - "locationName":"keyMaterial" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairInfo":{ - "type":"structure", - "members":{ - "KeyFingerprint":{ - "shape":"String", - "documentation":"

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide AWS the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", - "locationName":"keyFingerprint" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{ - "shape":"KeyPairInfo", - "locationName":"item" - } - }, - "LaunchPermission":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - }, - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - } - }, - "documentation":"

Describes a launch permission.

" - }, - "LaunchPermissionList":{ - "type":"list", - "member":{ - "shape":"LaunchPermission", - "locationName":"item" - } - }, - "LaunchPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to add to the list of launch permissions for the AMI.

" - }, - "Remove":{ - "shape":"LaunchPermissionList", - "documentation":"

The AWS account ID to remove from the list of launch permissions for the AMI.

" - } - }, - "documentation":"

Describes a launch permission modification.

" - }, - "LaunchSpecification":{ - "type":"structure", - "members":{ - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded user data for the instance.

", - "locationName":"userData" - }, - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"blockDeviceMapping" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

", - "locationName":"networkInterfaceSet" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "locationName":"monitoring" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "LaunchSpecsList":{ - "type":"list", - "member":{ - "shape":"SpotFleetLaunchSpecification", - "locationName":"item" - } - }, - "LaunchTemplate":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

", - "locationName":"launchTemplateId" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template.

", - "locationName":"launchTemplateName" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time launch template was created.

", - "locationName":"createTime" - }, - "CreatedBy":{ - "shape":"String", - "documentation":"

The principal that created the launch template.

", - "locationName":"createdBy" - }, - "DefaultVersionNumber":{ - "shape":"Long", - "documentation":"

The version number of the default version of the launch template.

", - "locationName":"defaultVersionNumber" - }, - "LatestVersionNumber":{ - "shape":"Long", - "documentation":"

The version number of the latest version of the launch template.

", - "locationName":"latestVersionNumber" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the launch template.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a launch template.

" - }, - "LaunchTemplateBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"deviceName" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN).

", - "locationName":"virtualName" - }, - "Ebs":{ - "shape":"LaunchTemplateEbsBlockDevice", - "documentation":"

Information about the block device for an EBS volume.

", - "locationName":"ebs" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

", - "locationName":"noDevice" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "LaunchTemplateBlockDeviceMappingList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateBlockDeviceMapping", - "locationName":"item" - } - }, - "LaunchTemplateBlockDeviceMappingRequest":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with 2 available instance store volumes can specify mappings for ephemeral0 and ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

" - }, - "Ebs":{ - "shape":"LaunchTemplateEbsBlockDeviceRequest", - "documentation":"

Parameters used to automatically set up EBS volumes when the instance is launched.

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

" - } - }, - "documentation":"

Describes a block device mapping.

" - }, - "LaunchTemplateBlockDeviceMappingRequestList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateBlockDeviceMappingRequest", - "locationName":"BlockDeviceMapping" - } - }, - "LaunchTemplateConfig":{ - "type":"structure", - "members":{ - "LaunchTemplateSpecification":{ - "shape":"FleetLaunchTemplateSpecification", - "documentation":"

The launch template.

", - "locationName":"launchTemplateSpecification" - }, - "Overrides":{ - "shape":"LaunchTemplateOverridesList", - "documentation":"

Any parameters that you specify override the same parameters in the launch template.

", - "locationName":"overrides" - } - }, - "documentation":"

Describes a launch template and overrides.

" - }, - "LaunchTemplateConfigList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateConfig", - "locationName":"item" - } - }, - "LaunchTemplateCpuOptions":{ - "type":"structure", - "members":{ - "CoreCount":{ - "shape":"Integer", - "documentation":"

The number of CPU cores for the instance.

", - "locationName":"coreCount" - }, - "ThreadsPerCore":{ - "shape":"Integer", - "documentation":"

The number of threads per CPU core.

", - "locationName":"threadsPerCore" - } - }, - "documentation":"

The CPU options for the instance.

" - }, - "LaunchTemplateCpuOptionsRequest":{ - "type":"structure", - "members":{ - "CoreCount":{ - "shape":"Integer", - "documentation":"

The number of CPU cores for the instance.

" - }, - "ThreadsPerCore":{ - "shape":"Integer", - "documentation":"

The number of threads per CPU core. To disable Intel Hyper-Threading Technology for the instance, specify a value of 1. Otherwise, specify the default value of 2.

" - } - }, - "documentation":"

The CPU options for the instance. Both the core count and threads per core must be specified in the request.

" - }, - "LaunchTemplateEbsBlockDevice":{ - "type":"structure", - "members":{ - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted.

", - "locationName":"encrypted" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports.

", - "locationName":"iops" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) CMK used for encryption.

", - "locationName":"kmsKeyId" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

", - "locationName":"snapshotId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type.

", - "locationName":"volumeType" - } - }, - "documentation":"

Describes a block device for an EBS volume.

" - }, - "LaunchTemplateEbsBlockDeviceRequest":{ - "type":"structure", - "members":{ - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is encrypted. Encrypted volumes can only be attached to instances that support Amazon EBS encryption. If you are creating a volume from a snapshot, you can't specify an encryption value.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1, this represents the number of IOPS that are provisioned for the volume. For gp2, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) CMK used for encryption.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type.

" - } - }, - "documentation":"

The parameters for a block device for an EBS volume.

" - }, - "LaunchTemplateErrorCode":{ - "type":"string", - "enum":[ - "launchTemplateIdDoesNotExist", - "launchTemplateIdMalformed", - "launchTemplateNameDoesNotExist", - "launchTemplateNameMalformed", - "launchTemplateVersionDoesNotExist", - "unexpectedError" - ] - }, - "LaunchTemplateIamInstanceProfileSpecification":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

", - "locationName":"arn" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

", - "locationName":"name" - } - }, - "documentation":"

Describes an IAM instance profile.

" - }, - "LaunchTemplateIamInstanceProfileSpecificationRequest":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the instance profile.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance profile.

" - } - }, - "documentation":"

An IAM instance profile.

" - }, - "LaunchTemplateInstanceMarketOptions":{ - "type":"structure", - "members":{ - "MarketType":{ - "shape":"MarketType", - "documentation":"

The market type.

", - "locationName":"marketType" - }, - "SpotOptions":{ - "shape":"LaunchTemplateSpotMarketOptions", - "documentation":"

The options for Spot Instances.

", - "locationName":"spotOptions" - } - }, - "documentation":"

The market (purchasing) option for the instances.

" - }, - "LaunchTemplateInstanceMarketOptionsRequest":{ - "type":"structure", - "members":{ - "MarketType":{ - "shape":"MarketType", - "documentation":"

The market type.

" - }, - "SpotOptions":{ - "shape":"LaunchTemplateSpotMarketOptionsRequest", - "documentation":"

The options for Spot Instances.

" - } - }, - "documentation":"

The market (purchasing) option for the instances.

" - }, - "LaunchTemplateInstanceNetworkInterfaceSpecification":{ - "type":"structure", - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to associate a public IPv4 address with eth0 for a new network interface.

", - "locationName":"associatePublicIpAddress" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index for the network interface attachment.

", - "locationName":"deviceIndex" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"groupSet" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

The number of IPv6 addresses for the network interface.

", - "locationName":"ipv6AddressCount" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressList", - "documentation":"

The IPv6 addresses for the network interface.

", - "locationName":"ipv6AddressesSet" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IPv4 address of the network interface.

", - "locationName":"privateIpAddress" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IPv4 addresses.

", - "locationName":"privateIpAddressesSet" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IPv4 addresses for the network interface.

", - "locationName":"secondaryPrivateIpAddressCount" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet for the network interface.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes a network interface.

" - }, - "LaunchTemplateInstanceNetworkInterfaceSpecificationList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateInstanceNetworkInterfaceSpecification", - "locationName":"item" - } - }, - "LaunchTemplateInstanceNetworkInterfaceSpecificationRequest":{ - "type":"structure", - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Associates a public IPv4 address with eth0 for a new network interface.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the network interface.

" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index for the network interface attachment.

" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses.

" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressListRequest", - "documentation":"

One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. You can't use this option if you're specifying a number of IPv6 addresses.

" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The primary private IPv4 address of the network interface.

" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressSpecificationList", - "documentation":"

One or more private IPv4 addresses.

" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IPv4 addresses to assign to a network interface.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet for the network interface.

" - } - }, - "documentation":"

The parameters for a network interface.

" - }, - "LaunchTemplateInstanceNetworkInterfaceSpecificationRequestList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateInstanceNetworkInterfaceSpecificationRequest", - "locationName":"InstanceNetworkInterfaceSpecification" - } - }, - "LaunchTemplateName":{ - "type":"string", - "max":128, - "min":3, - "pattern":"[a-zA-Z0-9\\(\\)\\.-/_]+" - }, - "LaunchTemplateNameStringList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateName", - "locationName":"item" - } - }, - "LaunchTemplateOverrides":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per unit hour that you are willing to pay for a Spot Instance.

", - "locationName":"spotPrice" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

", - "locationName":"subnetId" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which to launch the instances.

", - "locationName":"availabilityZone" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type.

", - "locationName":"weightedCapacity" - }, - "Priority":{ - "shape":"Double", - "documentation":"

The priority for the launch template override. If OnDemandAllocationStrategy is set to prioritized, Spot Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity. The highest priority is launched first. Valid values are whole numbers starting at 0. The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority.

", - "locationName":"priority" - } - }, - "documentation":"

Describes overrides for a launch template.

" - }, - "LaunchTemplateOverridesList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateOverrides", - "locationName":"item" - } - }, - "LaunchTemplatePlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for the instance on the Dedicated Host.

", - "locationName":"affinity" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group for the instance.

", - "locationName":"groupName" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host for the instance.

", - "locationName":"hostId" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

", - "locationName":"tenancy" - }, - "SpreadDomain":{ - "shape":"String", - "documentation":"

Reserved for future use.

", - "locationName":"spreadDomain" - } - }, - "documentation":"

Describes the placement of an instance.

" - }, - "LaunchTemplatePlacementRequest":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the instance.

" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for an instance on a Dedicated Host.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group for the instance.

" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host for the instance.

" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.

" - }, - "SpreadDomain":{ - "shape":"String", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

The placement for the instance.

" - }, - "LaunchTemplateSet":{ - "type":"list", - "member":{ - "shape":"LaunchTemplate", - "locationName":"item" - } - }, - "LaunchTemplateSpecification":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

" - }, - "LaunchTemplateName":{ - "shape":"String", - "documentation":"

The name of the launch template.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version number of the launch template.

Default: The default version for the launch template.

" - } - }, - "documentation":"

The launch template to use. You must specify either the launch template ID or launch template name in the request, but not both.

" - }, - "LaunchTemplateSpotMarketOptions":{ - "type":"structure", - "members":{ - "MaxPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price you're willing to pay for the Spot Instances.

", - "locationName":"maxPrice" - }, - "SpotInstanceType":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

", - "locationName":"spotInstanceType" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot Instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

", - "locationName":"blockDurationMinutes" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. For a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

", - "locationName":"validUntil" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted.

", - "locationName":"instanceInterruptionBehavior" - } - }, - "documentation":"

The options for Spot Instances.

" - }, - "LaunchTemplateSpotMarketOptionsRequest":{ - "type":"structure", - "members":{ - "MaxPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price you're willing to pay for the Spot Instances.

" - }, - "SpotInstanceType":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot Instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. For a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached. The default end date is 7 days from the current date.

" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

" - } - }, - "documentation":"

The options for Spot Instances.

" - }, - "LaunchTemplateTagSpecification":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource.

", - "locationName":"resourceType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the resource.

", - "locationName":"tagSet" - } - }, - "documentation":"

The tag specification for the launch template.

" - }, - "LaunchTemplateTagSpecificationList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateTagSpecification", - "locationName":"item" - } - }, - "LaunchTemplateTagSpecificationRequest":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to tag. Currently, the resource types that support tagging on creation are instance and volume. To tag a resource after it has been created, see CreateTags.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to apply to the resource.

", - "locationName":"Tag" - } - }, - "documentation":"

The tags specification for the launch template.

" - }, - "LaunchTemplateTagSpecificationRequestList":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateTagSpecificationRequest", - "locationName":"LaunchTemplateTagSpecificationRequest" - } - }, - "LaunchTemplateVersion":{ - "type":"structure", - "members":{ - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template.

", - "locationName":"launchTemplateId" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template.

", - "locationName":"launchTemplateName" - }, - "VersionNumber":{ - "shape":"Long", - "documentation":"

The version number.

", - "locationName":"versionNumber" - }, - "VersionDescription":{ - "shape":"VersionDescription", - "documentation":"

The description for the version.

", - "locationName":"versionDescription" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time the version was created.

", - "locationName":"createTime" - }, - "CreatedBy":{ - "shape":"String", - "documentation":"

The principal that created the version.

", - "locationName":"createdBy" - }, - "DefaultVersion":{ - "shape":"Boolean", - "documentation":"

Indicates whether the version is the default version.

", - "locationName":"defaultVersion" - }, - "LaunchTemplateData":{ - "shape":"ResponseLaunchTemplateData", - "documentation":"

Information about the launch template.

", - "locationName":"launchTemplateData" - } - }, - "documentation":"

Describes a launch template version.

" - }, - "LaunchTemplateVersionSet":{ - "type":"list", - "member":{ - "shape":"LaunchTemplateVersion", - "locationName":"item" - } - }, - "LaunchTemplatesMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether detailed monitoring is enabled. Otherwise, basic monitoring is enabled.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "LaunchTemplatesMonitoringRequest":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Specify true to enable detailed monitoring. Otherwise, basic monitoring is enabled.

" - } - }, - "documentation":"

Describes the monitoring for the instance.

" - }, - "ListingState":{ - "type":"string", - "enum":[ - "available", - "sold", - "cancelled", - "pending" - ] - }, - "ListingStatus":{ - "type":"string", - "enum":[ - "active", - "pending", - "cancelled", - "closed" - ] - }, - "LoadBalancersConfig":{ - "type":"structure", - "members":{ - "ClassicLoadBalancersConfig":{ - "shape":"ClassicLoadBalancersConfig", - "documentation":"

The Classic Load Balancers.

", - "locationName":"classicLoadBalancersConfig" - }, - "TargetGroupsConfig":{ - "shape":"TargetGroupsConfig", - "documentation":"

The target groups.

", - "locationName":"targetGroupsConfig" - } - }, - "documentation":"

Describes the Classic Load Balancers and target groups to attach to a Spot Fleet request.

" - }, - "LoadPermission":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"userId" - }, - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

", - "locationName":"group" - } - }, - "documentation":"

Describes a load permission.

" - }, - "LoadPermissionList":{ - "type":"list", - "member":{ - "shape":"LoadPermission", - "locationName":"item" - } - }, - "LoadPermissionListRequest":{ - "type":"list", - "member":{ - "shape":"LoadPermissionRequest", - "locationName":"item" - } - }, - "LoadPermissionModifications":{ - "type":"structure", - "members":{ - "Add":{ - "shape":"LoadPermissionListRequest", - "documentation":"

The load permissions to add.

" - }, - "Remove":{ - "shape":"LoadPermissionListRequest", - "documentation":"

The load permissions to remove.

" - } - }, - "documentation":"

Describes modifications to the load permissions of an Amazon FPGA image (AFI).

" - }, - "LoadPermissionRequest":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"PermissionGroup", - "documentation":"

The name of the group.

" - }, - "UserId":{ - "shape":"String", - "documentation":"

The AWS account ID.

" - } - }, - "documentation":"

Describes a load permission.

" - }, - "LogDestinationType":{ - "type":"string", - "enum":[ - "cloud-watch-logs", - "s3" - ] - }, - "Long":{"type":"long"}, - "MarketType":{ - "type":"string", - "enum":["spot"] - }, - "MaxResults":{ - "type":"integer", - "max":255, - "min":5 - }, - "ModifyFleetRequest":{ - "type":"structure", - "required":[ - "FleetId", - "TargetCapacitySpecification" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"FleetExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.

" - }, - "FleetId":{ - "shape":"FleetIdentifier", - "documentation":"

The ID of the EC2 Fleet.

" - }, - "TargetCapacitySpecification":{ - "shape":"TargetCapacitySpecificationRequest", - "documentation":"

The size of the EC2 Fleet.

" - } - } - }, - "ModifyFleetResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - } - }, - "ModifyFpgaImageAttributeRequest":{ - "type":"structure", - "required":["FpgaImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the AFI.

" - }, - "Attribute":{ - "shape":"FpgaImageAttributeName", - "documentation":"

The name of the attribute.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This parameter is valid only when modifying the loadPermission attribute.

", - "locationName":"UserId" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This parameter is valid only when modifying the loadPermission attribute.

", - "locationName":"UserGroup" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more product codes. After you add a product code to an AFI, it can't be removed. This parameter is valid only when modifying the productCodes attribute.

", - "locationName":"ProductCode" - }, - "LoadPermission":{ - "shape":"LoadPermissionModifications", - "documentation":"

The load permission for the AFI.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the AFI.

" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for the AFI.

" - } - } - }, - "ModifyFpgaImageAttributeResult":{ - "type":"structure", - "members":{ - "FpgaImageAttribute":{ - "shape":"FpgaImageAttribute", - "documentation":"

Information about the attribute.

", - "locationName":"fpgaImageAttribute" - } - } - }, - "ModifyHostsRequest":{ - "type":"structure", - "required":[ - "AutoPlacement", - "HostIds" - ], - "members":{ - "AutoPlacement":{ - "shape":"AutoPlacement", - "documentation":"

Specify whether to enable or disable auto-placement.

", - "locationName":"autoPlacement" - }, - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts to modify.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ModifyHosts.

" - }, - "ModifyHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully modified.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ModifyHosts.

" - }, - "ModifyIdFormatRequest":{ - "type":"structure", - "required":[ - "Resource", - "UseLongIds" - ], - "members":{ - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

Alternatively, use the all-current option to include all resource types that are currently within their opt-in period for longer IDs.

" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicate whether the resource should use longer IDs (17-character IDs).

" - } - }, - "documentation":"

Contains the parameters of ModifyIdFormat.

" - }, - "ModifyIdentityIdFormatRequest":{ - "type":"structure", - "required":[ - "PrincipalArn", - "Resource", - "UseLongIds" - ], - "members":{ - "PrincipalArn":{ - "shape":"String", - "documentation":"

The ARN of the principal, which can be an IAM user, IAM role, or the root user. Specify all to modify the ID format for all IAM users, IAM roles, and the root user of the account.

", - "locationName":"principalArn" - }, - "Resource":{ - "shape":"String", - "documentation":"

The type of resource: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | route-table | route-table-association | security-group | subnet | subnet-cidr-block-association | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

Alternatively, use the all-current option to include all resource types that are currently within their opt-in period for longer IDs.

", - "locationName":"resource" - }, - "UseLongIds":{ - "shape":"Boolean", - "documentation":"

Indicates whether the resource should use longer IDs (17-character IDs)

", - "locationName":"useLongIds" - } - }, - "documentation":"

Contains the parameters of ModifyIdentityIdFormat.

" - }, - "ModifyImageAttributeRequest":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "Attribute":{ - "shape":"String", - "documentation":"

The name of the attribute to modify. The valid values are description, launchPermission, and productCodes.

" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A new description for the AMI.

" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "LaunchPermission":{ - "shape":"LaunchPermissionModifications", - "documentation":"

A new launch permission for the AMI.

" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The operation type. This parameter can be used only when the Attribute parameter is launchPermission.

" - }, - "ProductCodes":{ - "shape":"ProductCodeStringList", - "documentation":"

One or more DevPay product codes. After you add a product code to an AMI, it can't be removed.

", - "locationName":"ProductCode" - }, - "UserGroups":{ - "shape":"UserGroupStringList", - "documentation":"

One or more user groups. This parameter can be used only when the Attribute parameter is launchPermission.

", - "locationName":"UserGroup" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

One or more AWS account IDs. This parameter can be used only when the Attribute parameter is launchPermission.

", - "locationName":"UserId" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the attribute being modified. This parameter can be used only when the Attribute parameter is description or productCodes.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ModifyImageAttribute.

" - }, - "ModifyInstanceAttributeRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether source/destination checking is enabled. A value of true means that checking is enabled, and false means that checking is disabled. This value must be false for a NAT instance to perform NAT.

" - }, - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The name of the attribute.

", - "locationName":"attribute" - }, - "BlockDeviceMappings":{ - "shape":"InstanceBlockDeviceMappingSpecificationList", - "documentation":"

Modifies the DeleteOnTermination attribute for volumes that are currently attached. The volume must be owned by the caller. If no value is specified for DeleteOnTermination, the default is true and the volume is deleted when the instance is terminated.

To add instance store volumes to an Amazon EBS-backed instance, you must add them when you launch the instance. For more information, see Updating the Block Device Mapping when Launching an Instance in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"blockDeviceMapping" - }, - "DisableApiTermination":{ - "shape":"AttributeBooleanValue", - "documentation":"

If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. You cannot use this parameter for Spot Instances.

", - "locationName":"disableApiTermination" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EbsOptimized":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specifies whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

", - "locationName":"ebsOptimized" - }, - "EnaSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Set to true to enable enhanced networking with ENA for the instance.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"enaSupport" - }, - "Groups":{ - "shape":"GroupIdStringList", - "documentation":"

[EC2-VPC] Changes the security groups of the instance. You must specify at least one security group, even if it's just the default security group for the VPC. You must specify the security group ID, not the security group name.

", - "locationName":"GroupId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"AttributeValue", - "documentation":"

Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "InstanceType":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance type to the specified value. For more information, see Instance Types. If the instance type is not valid, the error returned is InvalidInstanceAttributeValue.

", - "locationName":"instanceType" - }, - "Kernel":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's kernel to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"kernel" - }, - "Ramdisk":{ - "shape":"AttributeValue", - "documentation":"

Changes the instance's RAM disk to the specified value. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB.

", - "locationName":"ramdisk" - }, - "SriovNetSupport":{ - "shape":"AttributeValue", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the instance.

There is no way to disable enhanced networking with the Intel 82599 Virtual Function interface at this time.

This option is supported only for HVM instances. Specifying this option with a PV instance can make it unreachable.

", - "locationName":"sriovNetSupport" - }, - "UserData":{ - "shape":"BlobAttributeValue", - "documentation":"

Changes the instance's user data to the specified value. If you are using an AWS SDK or command line tool, base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text.

", - "locationName":"userData" - }, - "Value":{ - "shape":"String", - "documentation":"

A new value for the attribute. Use only with the kernel, ramdisk, userData, disableApiTermination, or instanceInitiatedShutdownBehavior attribute.

", - "locationName":"value" - } - }, - "documentation":"

Contains the parameters for ModifyInstanceAttribute.

" - }, - "ModifyInstanceCreditSpecificationRequest":{ - "type":"structure", - "required":["InstanceCreditSpecifications"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token that you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

" - }, - "InstanceCreditSpecifications":{ - "shape":"InstanceCreditSpecificationListRequest", - "documentation":"

Information about the credit option for CPU usage.

", - "locationName":"InstanceCreditSpecification" - } - } - }, - "ModifyInstanceCreditSpecificationResult":{ - "type":"structure", - "members":{ - "SuccessfulInstanceCreditSpecifications":{ - "shape":"SuccessfulInstanceCreditSpecificationSet", - "documentation":"

Information about the instances whose credit option for CPU usage was successfully modified.

", - "locationName":"successfulInstanceCreditSpecificationSet" - }, - "UnsuccessfulInstanceCreditSpecifications":{ - "shape":"UnsuccessfulInstanceCreditSpecificationSet", - "documentation":"

Information about the instances whose credit option for CPU usage was not modified.

", - "locationName":"unsuccessfulInstanceCreditSpecificationSet" - } - } - }, - "ModifyInstancePlacementRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "Affinity":{ - "shape":"Affinity", - "documentation":"

The affinity setting for the instance.

", - "locationName":"affinity" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy of default. For cluster placement groups, the instance must have a tenancy of default or dedicated.

To remove an instance from a placement group, specify an empty string (\"\").

" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host with which to associate the instance.

", - "locationName":"hostId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that you are modifying.

", - "locationName":"instanceId" - }, - "Tenancy":{ - "shape":"HostTenancy", - "documentation":"

The tenancy for the instance.

", - "locationName":"tenancy" - } - }, - "documentation":"

Contains the parameters for ModifyInstancePlacement.

" - }, - "ModifyInstancePlacementResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyInstancePlacement.

" - }, - "ModifyLaunchTemplateRequest":{ - "type":"structure", - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

" - }, - "LaunchTemplateId":{ - "shape":"String", - "documentation":"

The ID of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "LaunchTemplateName":{ - "shape":"LaunchTemplateName", - "documentation":"

The name of the launch template. You must specify either the launch template ID or launch template name in the request.

" - }, - "DefaultVersion":{ - "shape":"String", - "documentation":"

The version number of the launch template to set as the default version.

", - "locationName":"SetDefaultVersion" - } - } - }, - "ModifyLaunchTemplateResult":{ - "type":"structure", - "members":{ - "LaunchTemplate":{ - "shape":"LaunchTemplate", - "documentation":"

Information about the launch template.

", - "locationName":"launchTemplate" - } - } - }, - "ModifyNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "Attachment":{ - "shape":"NetworkInterfaceAttachmentChanges", - "documentation":"

Information about the interface attachment. If modifying the 'delete on termination' attribute, you must specify the ID of the interface attachment.

", - "locationName":"attachment" - }, - "Description":{ - "shape":"AttributeValue", - "documentation":"

A description for the network interface.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Groups":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

Changes the security groups for the network interface. The new set of groups you specify replaces the current set. You must specify at least one group, even if it's just the default security group in the VPC. You must specify the ID of the security group, not the name.

", - "locationName":"SecurityGroupId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether source/destination checking is enabled. A value of true means checking is enabled, and false means checking is disabled. This value must be false for a NAT instance to perform NAT. For more information, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the parameters for ModifyNetworkInterfaceAttribute.

" - }, - "ModifyReservedInstancesRequest":{ - "type":"structure", - "required":[ - "ReservedInstancesIds", - "TargetConfigurations" - ], - "members":{ - "ReservedInstancesIds":{ - "shape":"ReservedInstancesIdStringList", - "documentation":"

The IDs of the Reserved Instances to modify.

", - "locationName":"ReservedInstancesId" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "TargetConfigurations":{ - "shape":"ReservedInstancesConfigurationList", - "documentation":"

The configuration settings for the Reserved Instances to modify.

", - "locationName":"ReservedInstancesConfigurationSetItemType" - } - }, - "documentation":"

Contains the parameters for ModifyReservedInstances.

" - }, - "ModifyReservedInstancesResult":{ - "type":"structure", - "members":{ - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

The ID for the modification.

", - "locationName":"reservedInstancesModificationId" - } - }, - "documentation":"

Contains the output of ModifyReservedInstances.

" - }, - "ModifySnapshotAttributeRequest":{ - "type":"structure", - "required":["SnapshotId"], - "members":{ - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The snapshot attribute to modify. Only volume creation permissions can be modified.

" - }, - "CreateVolumePermission":{ - "shape":"CreateVolumePermissionModifications", - "documentation":"

A JSON representation of the snapshot attribute modification.

" - }, - "GroupNames":{ - "shape":"GroupNameStringList", - "documentation":"

The group to modify for the snapshot.

", - "locationName":"UserGroup" - }, - "OperationType":{ - "shape":"OperationType", - "documentation":"

The type of operation to perform to the attribute.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "UserIds":{ - "shape":"UserIdStringList", - "documentation":"

The account ID to modify for the snapshot.

", - "locationName":"UserId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ModifySnapshotAttribute.

" - }, - "ModifySpotFleetRequestRequest":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot Instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The size of the fleet.

", - "locationName":"targetCapacity" - } - }, - "documentation":"

Contains the parameters for ModifySpotFleetRequest.

" - }, - "ModifySpotFleetRequestResponse":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifySpotFleetRequest.

" - }, - "ModifySubnetAttributeRequest":{ - "type":"structure", - "required":["SubnetId"], - "members":{ - "AssignIpv6AddressOnCreation":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that network interfaces created in the specified subnet should be assigned an IPv6 address. This includes a network interface that's created when launching an instance into the subnet (the instance therefore receives an IPv6 address).

If you enable the IPv6 addressing feature for your subnet, your network interface or instance only receives an IPv6 address if it's created using version 2016-11-15 or later of the Amazon EC2 API.

" - }, - "MapPublicIpOnLaunch":{ - "shape":"AttributeBooleanValue", - "documentation":"

Specify true to indicate that network interfaces created in the specified subnet should be assigned a public IPv4 address. This includes a network interface that's created when launching an instance into the subnet (the instance therefore receives a public IPv4 address).

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Contains the parameters for ModifySubnetAttribute.

" - }, - "ModifyVolumeAttributeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "AutoEnableIO":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the volume should be auto-enabled for I/O operations.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ModifyVolumeAttribute.

" - }, - "ModifyVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The target size of the volume, in GiB. The target volume size must be greater than or equal to than the existing size of the volume. For information about available EBS volume sizes, see Amazon EBS Volume Types.

Default: If no size is specified, the existing size is retained.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The target EBS volume type of the volume.

Default: If no type is specified, the existing type is retained.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The target IOPS rate of the volume.

This is only valid for Provisioned IOPS SSD (io1) volumes. For more information, see Provisioned IOPS SSD (io1) Volumes.

Default: If no IOPS value is specified, the existing value is retained.

" - } - } - }, - "ModifyVolumeResult":{ - "type":"structure", - "members":{ - "VolumeModification":{ - "shape":"VolumeModification", - "documentation":"

Information about the volume modification.

", - "locationName":"volumeModification" - } - } - }, - "ModifyVpcAttributeRequest":{ - "type":"structure", - "required":["VpcId"], - "members":{ - "EnableDnsHostnames":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the instances launched in the VPC get DNS hostnames. If enabled, instances in the VPC get DNS hostnames; otherwise, they do not.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute. You can only enable DNS hostnames if you've enabled DNS support.

" - }, - "EnableDnsSupport":{ - "shape":"AttributeBooleanValue", - "documentation":"

Indicates whether the DNS resolution is supported for the VPC. If enabled, queries to the Amazon provided DNS server at the 169.254.169.253 IP address, or the reserved IP address at the base of the VPC network range \"plus two\" succeed. If disabled, the Amazon provided DNS service in the VPC that resolves public DNS hostnames to IP addresses is not enabled.

You cannot modify the DNS resolution and DNS hostnames attributes in the same request. Use separate requests for each attribute.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Contains the parameters for ModifyVpcAttribute.

" - }, - "ModifyVpcEndpointConnectionNotificationRequest":{ - "type":"structure", - "required":["ConnectionNotificationId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ConnectionNotificationId":{ - "shape":"String", - "documentation":"

The ID of the notification.

" - }, - "ConnectionNotificationArn":{ - "shape":"String", - "documentation":"

The ARN for the SNS topic for the notification.

" - }, - "ConnectionEvents":{ - "shape":"ValueStringList", - "documentation":"

One or more events for the endpoint. Valid values are Accept, Connect, Delete, and Reject.

" - } - } - }, - "ModifyVpcEndpointConnectionNotificationResult":{ - "type":"structure", - "members":{ - "ReturnValue":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ModifyVpcEndpointRequest":{ - "type":"structure", - "required":["VpcEndpointId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the endpoint.

" - }, - "ResetPolicy":{ - "shape":"Boolean", - "documentation":"

(Gateway endpoint) Specify true to reset the policy document to the default policy. The default policy allows full access to the service.

" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

(Gateway endpoint) A policy document to attach to the endpoint. The policy must be in valid JSON format.

" - }, - "AddRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

(Gateway endpoint) One or more route tables IDs to associate with the endpoint.

", - "locationName":"AddRouteTableId" - }, - "RemoveRouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

(Gateway endpoint) One or more route table IDs to disassociate from the endpoint.

", - "locationName":"RemoveRouteTableId" - }, - "AddSubnetIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more subnet IDs in which to serve the endpoint.

", - "locationName":"AddSubnetId" - }, - "RemoveSubnetIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more subnets IDs in which to remove the endpoint.

", - "locationName":"RemoveSubnetId" - }, - "AddSecurityGroupIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more security group IDs to associate with the network interface.

", - "locationName":"AddSecurityGroupId" - }, - "RemoveSecurityGroupIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more security group IDs to disassociate from the network interface.

", - "locationName":"RemoveSecurityGroupId" - }, - "PrivateDnsEnabled":{ - "shape":"Boolean", - "documentation":"

(Interface endpoint) Indicate whether a private hosted zone is associated with the VPC.

" - } - }, - "documentation":"

Contains the parameters for ModifyVpcEndpoint.

" - }, - "ModifyVpcEndpointResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ModifyVpcEndpointServiceConfigurationRequest":{ - "type":"structure", - "required":["ServiceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service.

" - }, - "AcceptanceRequired":{ - "shape":"Boolean", - "documentation":"

Indicate whether requests to create an endpoint to your service must be accepted.

" - }, - "AddNetworkLoadBalancerArns":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARNs) of Network Load Balancers to add to your service configuration.

", - "locationName":"AddNetworkLoadBalancerArn" - }, - "RemoveNetworkLoadBalancerArns":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARNs) of Network Load Balancers to remove from your service configuration.

", - "locationName":"RemoveNetworkLoadBalancerArn" - } - } - }, - "ModifyVpcEndpointServiceConfigurationResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ModifyVpcEndpointServicePermissionsRequest":{ - "type":"structure", - "required":["ServiceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service.

" - }, - "AddAllowedPrincipals":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARN) of one or more principals. Permissions are granted to the principals in this list. To grant permissions to all principals, specify an asterisk (*).

" - }, - "RemoveAllowedPrincipals":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARN) of one or more principals. Permissions are revoked for principals in this list.

" - } - } - }, - "ModifyVpcEndpointServicePermissionsResult":{ - "type":"structure", - "members":{ - "ReturnValue":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - } - }, - "ModifyVpcPeeringConnectionOptionsRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the accepter VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptionsRequest", - "documentation":"

The VPC peering connection options for the requester VPC.

" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

" - } - } - }, - "ModifyVpcPeeringConnectionOptionsResult":{ - "type":"structure", - "members":{ - "AccepterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the accepter VPC.

", - "locationName":"accepterPeeringConnectionOptions" - }, - "RequesterPeeringConnectionOptions":{ - "shape":"PeeringConnectionOptions", - "documentation":"

Information about the VPC peering connection options for the requester VPC.

", - "locationName":"requesterPeeringConnectionOptions" - } - } - }, - "ModifyVpcTenancyRequest":{ - "type":"structure", - "required":[ - "VpcId", - "InstanceTenancy" - ], - "members":{ - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

" - }, - "InstanceTenancy":{ - "shape":"VpcTenancy", - "documentation":"

The instance tenancy attribute for the VPC.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - } - }, - "documentation":"

Contains the parameters for ModifyVpcTenancy.

" - }, - "ModifyVpcTenancyResult":{ - "type":"structure", - "members":{ - "ReturnValue":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of ModifyVpcTenancy.

" - }, - "MonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for MonitorInstances.

" - }, - "MonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

The monitoring information.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of MonitorInstances.

" - }, - "Monitoring":{ - "type":"structure", - "members":{ - "State":{ - "shape":"MonitoringState", - "documentation":"

Indicates whether detailed monitoring is enabled. Otherwise, basic monitoring is enabled.

", - "locationName":"state" - } - }, - "documentation":"

Describes the monitoring of an instance.

" - }, - "MonitoringState":{ - "type":"string", - "enum":[ - "disabled", - "disabling", - "enabled", - "pending" - ] - }, - "MoveAddressToVpcRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for MoveAddressToVpc.

" - }, - "MoveAddressToVpcResult":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID for the Elastic IP address.

", - "locationName":"allocationId" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the move of the IP address.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output of MoveAddressToVpc.

" - }, - "MoveStatus":{ - "type":"string", - "enum":[ - "movingToVpc", - "restoringToClassic" - ] - }, - "MovingAddressStatus":{ - "type":"structure", - "members":{ - "MoveStatus":{ - "shape":"MoveStatus", - "documentation":"

The status of the Elastic IP address that's being moved to the EC2-VPC platform, or restored to the EC2-Classic platform.

", - "locationName":"moveStatus" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Describes the status of a moving Elastic IP address.

" - }, - "MovingAddressStatusSet":{ - "type":"list", - "member":{ - "shape":"MovingAddressStatus", - "locationName":"item" - } - }, - "NatGateway":{ - "type":"structure", - "members":{ - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was created.

", - "locationName":"createTime" - }, - "DeleteTime":{ - "shape":"DateTime", - "documentation":"

The date and time the NAT gateway was deleted, if applicable.

", - "locationName":"deleteTime" - }, - "FailureCode":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error code for the failure. (InsufficientFreeAddressesInSubnet | Gateway.NotAttached | InvalidAllocationID.NotFound | Resource.AlreadyAssociated | InternalError | InvalidSubnetID.NotFound)

", - "locationName":"failureCode" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

If the NAT gateway could not be created, specifies the error message for the failure, that corresponds to the error code.

  • For InsufficientFreeAddressesInSubnet: \"Subnet has insufficient free addresses to create this NAT gateway\"

  • For Gateway.NotAttached: \"Network vpc-xxxxxxxx has no Internet gateway attached\"

  • For InvalidAllocationID.NotFound: \"Elastic IP address eipalloc-xxxxxxxx could not be associated with this NAT gateway\"

  • For Resource.AlreadyAssociated: \"Elastic IP address eipalloc-xxxxxxxx is already associated\"

  • For InternalError: \"Network interface eni-xxxxxxxx, created and used internally by this NAT gateway is in an invalid state. Please try again.\"

  • For InvalidSubnetID.NotFound: \"The specified subnet subnet-xxxxxxxx does not exist or could not be found.\"

", - "locationName":"failureMessage" - }, - "NatGatewayAddresses":{ - "shape":"NatGatewayAddressList", - "documentation":"

Information about the IP addresses and network interface associated with the NAT gateway.

", - "locationName":"natGatewayAddressSet" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of the NAT gateway.

", - "locationName":"natGatewayId" - }, - "ProvisionedBandwidth":{ - "shape":"ProvisionedBandwidth", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionedBandwidth" - }, - "State":{ - "shape":"NatGatewayState", - "documentation":"

The state of the NAT gateway.

  • pending: The NAT gateway is being created and is not ready to process traffic.

  • failed: The NAT gateway could not be created. Check the failureCode and failureMessage fields for the reason.

  • available: The NAT gateway is able to process traffic. This status remains until you delete the NAT gateway, and does not indicate the health of the NAT gateway.

  • deleting: The NAT gateway is in the process of being terminated and may still be processing traffic.

  • deleted: The NAT gateway has been terminated and is no longer processing traffic.

", - "locationName":"state" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which the NAT gateway is located.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC in which the NAT gateway is located.

", - "locationName":"vpcId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the NAT gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a NAT gateway.

" - }, - "NatGatewayAddress":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID of the Elastic IP address that's associated with the NAT gateway.

", - "locationName":"allocationId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface associated with the NAT gateway.

", - "locationName":"networkInterfaceId" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The private IP address associated with the Elastic IP address.

", - "locationName":"privateIp" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address associated with the NAT gateway.

", - "locationName":"publicIp" - } - }, - "documentation":"

Describes the IP addresses and network interface associated with a NAT gateway.

" - }, - "NatGatewayAddressList":{ - "type":"list", - "member":{ - "shape":"NatGatewayAddress", - "locationName":"item" - } - }, - "NatGatewayList":{ - "type":"list", - "member":{ - "shape":"NatGateway", - "locationName":"item" - } - }, - "NatGatewayState":{ - "type":"string", - "enum":[ - "pending", - "failed", - "available", - "deleting", - "deleted" - ] - }, - "NetworkAcl":{ - "type":"structure", - "members":{ - "Associations":{ - "shape":"NetworkAclAssociationList", - "documentation":"

Any associations between the network ACL and one or more subnets

", - "locationName":"associationSet" - }, - "Entries":{ - "shape":"NetworkAclEntryList", - "documentation":"

One or more entries (rules) in the network ACL.

", - "locationName":"entrySet" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default network ACL for the VPC.

", - "locationName":"default" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network ACL.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the network ACL.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a network ACL.

" - }, - "NetworkAclAssociation":{ - "type":"structure", - "members":{ - "NetworkAclAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a network ACL and a subnet.

", - "locationName":"networkAclAssociationId" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the network ACL.

", - "locationName":"networkAclId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a network ACL and a subnet.

" - }, - "NetworkAclAssociationList":{ - "type":"list", - "member":{ - "shape":"NetworkAclAssociation", - "locationName":"item" - } - }, - "NetworkAclEntry":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 network range to allow or deny, in CIDR notation.

", - "locationName":"cidrBlock" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether the rule is an egress rule (applied to traffic leaving the subnet).

", - "locationName":"egress" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP type and code.

", - "locationName":"icmpTypeCode" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 network range to allow or deny, in CIDR notation.

", - "locationName":"ipv6CidrBlock" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to.

", - "locationName":"portRange" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The protocol. A value of -1 means all protocols.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number for the entry. ACL entries are processed in ascending order by rule number.

", - "locationName":"ruleNumber" - } - }, - "documentation":"

Describes an entry in a network ACL.

" - }, - "NetworkAclEntryList":{ - "type":"list", - "member":{ - "shape":"NetworkAclEntry", - "locationName":"item" - } - }, - "NetworkAclList":{ - "type":"list", - "member":{ - "shape":"NetworkAcl", - "locationName":"item" - } - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address (IPv4) associated with the network interface.

", - "locationName":"association" - }, - "Attachment":{ - "shape":"NetworkInterfaceAttachment", - "documentation":"

The network interface attachment.

", - "locationName":"attachment" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "Description":{ - "shape":"String", - "documentation":"

A description.

", - "locationName":"description" - }, - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

Any security groups for the network interface.

", - "locationName":"groupSet" - }, - "InterfaceType":{ - "shape":"NetworkInterfaceType", - "documentation":"

The type of interface.

", - "locationName":"interfaceType" - }, - "Ipv6Addresses":{ - "shape":"NetworkInterfaceIpv6AddressesList", - "documentation":"

The IPv6 addresses associated with the network interface.

", - "locationName":"ipv6AddressesSet" - }, - "MacAddress":{ - "shape":"String", - "documentation":"

The MAC address.

", - "locationName":"macAddress" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the network interface.

", - "locationName":"ownerId" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IPv4 address of the network interface within the subnet.

", - "locationName":"privateIpAddress" - }, - "PrivateIpAddresses":{ - "shape":"NetworkInterfacePrivateIpAddressList", - "documentation":"

The private IPv4 addresses associated with the network interface.

", - "locationName":"privateIpAddressesSet" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the entity that launched the instance on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "RequesterManaged":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is being managed by AWS.

", - "locationName":"requesterManaged" - }, - "SourceDestCheck":{ - "shape":"Boolean", - "documentation":"

Indicates whether traffic to or from the instance is validated.

", - "locationName":"sourceDestCheck" - }, - "Status":{ - "shape":"NetworkInterfaceStatus", - "documentation":"

The status of the network interface.

", - "locationName":"status" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "TagSet":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the network interface.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a network interface.

" - }, - "NetworkInterfaceAssociation":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

The allocation ID.

", - "locationName":"allocationId" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "IpOwnerId":{ - "shape":"String", - "documentation":"

The ID of the Elastic IP address owner.

", - "locationName":"ipOwnerId" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name.

", - "locationName":"publicDnsName" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The address of the Elastic IP address bound to the network interface.

", - "locationName":"publicIp" - } - }, - "documentation":"

Describes association information for an Elastic IP address (IPv4 only).

" - }, - "NetworkInterfaceAttachment":{ - "type":"structure", - "members":{ - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The timestamp indicating when the attachment initiated.

", - "locationName":"attachTime" - }, - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The device index of the network interface attachment on the instance.

", - "locationName":"deviceIndex" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "Status":{ - "shape":"AttachmentStatus", - "documentation":"

The attachment state.

", - "locationName":"status" - } - }, - "documentation":"

Describes a network interface attachment.

" - }, - "NetworkInterfaceAttachmentChanges":{ - "type":"structure", - "members":{ - "AttachmentId":{ - "shape":"String", - "documentation":"

The ID of the network interface attachment.

", - "locationName":"attachmentId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the network interface is deleted when the instance is terminated.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes an attachment change.

" - }, - "NetworkInterfaceAttribute":{ - "type":"string", - "enum":[ - "description", - "groupSet", - "sourceDestCheck", - "attachment" - ] - }, - "NetworkInterfaceIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "NetworkInterfaceIpv6Address":{ - "type":"structure", - "members":{ - "Ipv6Address":{ - "shape":"String", - "documentation":"

The IPv6 address.

", - "locationName":"ipv6Address" - } - }, - "documentation":"

Describes an IPv6 address associated with a network interface.

" - }, - "NetworkInterfaceIpv6AddressesList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfaceIpv6Address", - "locationName":"item" - } - }, - "NetworkInterfaceList":{ - "type":"list", - "member":{ - "shape":"NetworkInterface", - "locationName":"item" - } - }, - "NetworkInterfacePermission":{ - "type":"structure", - "members":{ - "NetworkInterfacePermissionId":{ - "shape":"String", - "documentation":"

The ID of the network interface permission.

", - "locationName":"networkInterfacePermissionId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "AwsAccountId":{ - "shape":"String", - "documentation":"

The AWS account ID.

", - "locationName":"awsAccountId" - }, - "AwsService":{ - "shape":"String", - "documentation":"

The AWS service.

", - "locationName":"awsService" - }, - "Permission":{ - "shape":"InterfacePermissionType", - "documentation":"

The type of permission.

", - "locationName":"permission" - }, - "PermissionState":{ - "shape":"NetworkInterfacePermissionState", - "documentation":"

Information about the state of the permission.

", - "locationName":"permissionState" - } - }, - "documentation":"

Describes a permission for a network interface.

" - }, - "NetworkInterfacePermissionIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "NetworkInterfacePermissionList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePermission", - "locationName":"item" - } - }, - "NetworkInterfacePermissionState":{ - "type":"structure", - "members":{ - "State":{ - "shape":"NetworkInterfacePermissionStateCode", - "documentation":"

The state of the permission.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A status message, if applicable.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes the state of a network interface permission.

" - }, - "NetworkInterfacePermissionStateCode":{ - "type":"string", - "enum":[ - "pending", - "granted", - "revoking", - "revoked" - ] - }, - "NetworkInterfacePrivateIpAddress":{ - "type":"structure", - "members":{ - "Association":{ - "shape":"NetworkInterfaceAssociation", - "documentation":"

The association information for an Elastic IP address (IPv4) associated with the network interface.

", - "locationName":"association" - }, - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this IPv4 address is the primary private IPv4 address of the network interface.

", - "locationName":"primary" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name.

", - "locationName":"privateDnsName" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IPv4 address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes the private IPv4 address of a network interface.

" - }, - "NetworkInterfacePrivateIpAddressList":{ - "type":"list", - "member":{ - "shape":"NetworkInterfacePrivateIpAddress", - "locationName":"item" - } - }, - "NetworkInterfaceStatus":{ - "type":"string", - "enum":[ - "available", - "associated", - "attaching", - "in-use", - "detaching" - ] - }, - "NetworkInterfaceType":{ - "type":"string", - "enum":[ - "interface", - "natGateway" - ] - }, - "NewDhcpConfiguration":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "locationName":"key" - }, - "Values":{ - "shape":"ValueStringList", - "locationName":"Value" - } - } - }, - "NewDhcpConfigurationList":{ - "type":"list", - "member":{ - "shape":"NewDhcpConfiguration", - "locationName":"item" - } - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "OccurrenceDayRequestSet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"OccurenceDay" - } - }, - "OccurrenceDaySet":{ - "type":"list", - "member":{ - "shape":"Integer", - "locationName":"item" - } - }, - "OfferingClassType":{ - "type":"string", - "enum":[ - "standard", - "convertible" - ] - }, - "OfferingTypeValues":{ - "type":"string", - "enum":[ - "Heavy Utilization", - "Medium Utilization", - "Light Utilization", - "No Upfront", - "Partial Upfront", - "All Upfront" - ] - }, - "OnDemandAllocationStrategy":{ - "type":"string", - "enum":[ - "lowestPrice", - "prioritized" - ] - }, - "OnDemandOptions":{ - "type":"structure", - "members":{ - "AllocationStrategy":{ - "shape":"FleetOnDemandAllocationStrategy", - "documentation":"

The order of the launch template overrides to use in fulfilling On-Demand capacity. If you specify lowest-price, EC2 Fleet uses price to determine the order, launching the lowest price first. If you specify prioritized, EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first. If you do not specify a value, EC2 Fleet defaults to lowest-price.

", - "locationName":"allocationStrategy" - } - }, - "documentation":"

The allocation strategy of On-Demand Instances in an EC2 Fleet.

" - }, - "OnDemandOptionsRequest":{ - "type":"structure", - "members":{ - "AllocationStrategy":{ - "shape":"FleetOnDemandAllocationStrategy", - "documentation":"

The order of the launch template overrides to use in fulfilling On-Demand capacity. If you specify lowest-price, EC2 Fleet uses price to determine the order, launching the lowest price first. If you specify prioritized, EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first. If you do not specify a value, EC2 Fleet defaults to lowest-price.

" - } - }, - "documentation":"

The allocation strategy of On-Demand Instances in an EC2 Fleet.

" - }, - "OperationType":{ - "type":"string", - "enum":[ - "add", - "remove" - ] - }, - "OwnerStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Owner" - } - }, - "PaymentOption":{ - "type":"string", - "enum":[ - "AllUpfront", - "PartialUpfront", - "NoUpfront" - ] - }, - "PciId":{ - "type":"structure", - "members":{ - "DeviceId":{ - "shape":"String", - "documentation":"

The ID of the device.

" - }, - "VendorId":{ - "shape":"String", - "documentation":"

The ID of the vendor.

" - }, - "SubsystemId":{ - "shape":"String", - "documentation":"

The ID of the subsystem.

" - }, - "SubsystemVendorId":{ - "shape":"String", - "documentation":"

The ID of the vendor for the subsystem.

" - } - }, - "documentation":"

Describes the data that identifies an Amazon FPGA image (AFI) on the PCI bus.

" - }, - "PeeringConnectionOptions":{ - "type":"structure", - "members":{ - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, the public DNS hostnames of instances in the specified VPC resolve to private IP addresses when queried from instances in the peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - }, - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "PeeringConnectionOptionsRequest":{ - "type":"structure", - "members":{ - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

" - }, - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC via ClassicLink to instances in a peer VPC.

" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC via ClassicLink.

" - } - }, - "documentation":"

The VPC peering connection options.

" - }, - "PermissionGroup":{ - "type":"string", - "enum":["all"] - }, - "Placement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the instance.

", - "locationName":"availabilityZone" - }, - "Affinity":{ - "shape":"String", - "documentation":"

The affinity setting for the instance on the Dedicated Host. This parameter is not supported for the ImportInstance command.

", - "locationName":"affinity" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group the instance is in.

", - "locationName":"groupName" - }, - "HostId":{ - "shape":"String", - "documentation":"

The ID of the Dedicated Host on which the instance resides. This parameter is not supported for the ImportInstance command.

", - "locationName":"hostId" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. The host tenancy is not supported for the ImportInstance command.

", - "locationName":"tenancy" - }, - "SpreadDomain":{ - "shape":"String", - "documentation":"

Reserved for future use.

", - "locationName":"spreadDomain" - } - }, - "documentation":"

Describes the placement of an instance.

" - }, - "PlacementGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "State":{ - "shape":"PlacementGroupState", - "documentation":"

The state of the placement group.

", - "locationName":"state" - }, - "Strategy":{ - "shape":"PlacementStrategy", - "documentation":"

The placement strategy.

", - "locationName":"strategy" - } - }, - "documentation":"

Describes a placement group.

" - }, - "PlacementGroupList":{ - "type":"list", - "member":{ - "shape":"PlacementGroup", - "locationName":"item" - } - }, - "PlacementGroupState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "PlacementGroupStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PlacementStrategy":{ - "type":"string", - "enum":[ - "cluster", - "spread" - ] - }, - "PlatformValues":{ - "type":"string", - "enum":["Windows"] - }, - "PortRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The first port in the range.

", - "locationName":"from" - }, - "To":{ - "shape":"Integer", - "documentation":"

The last port in the range.

", - "locationName":"to" - } - }, - "documentation":"

Describes a range of ports.

" - }, - "PrefixList":{ - "type":"structure", - "members":{ - "Cidrs":{ - "shape":"ValueStringList", - "documentation":"

The IP address range of the AWS service.

", - "locationName":"cidrSet" - }, - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - }, - "PrefixListName":{ - "shape":"String", - "documentation":"

The name of the prefix.

", - "locationName":"prefixListName" - } - }, - "documentation":"

Describes prefixes for AWS services.

" - }, - "PrefixListId":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the security group rule that references this prefix list ID.

Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

", - "locationName":"description" - }, - "PrefixListId":{ - "shape":"String", - "documentation":"

The ID of the prefix.

", - "locationName":"prefixListId" - } - }, - "documentation":"

[EC2-VPC only] The ID of the prefix.

" - }, - "PrefixListIdList":{ - "type":"list", - "member":{ - "shape":"PrefixListId", - "locationName":"item" - } - }, - "PrefixListIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "PrefixListSet":{ - "type":"list", - "member":{ - "shape":"PrefixList", - "locationName":"item" - } - }, - "PriceSchedule":{ - "type":"structure", - "members":{ - "Active":{ - "shape":"Boolean", - "documentation":"

The current price schedule, as determined by the term remaining for the Reserved Instance in the listing.

A specific price schedule is always in effect, but only one price schedule can be active at any time. Take, for example, a Reserved Instance listing that has five months remaining in its term. When you specify price schedules for five months and two months, this means that schedule 1, covering the first three months of the remaining term, will be active during months 5, 4, and 3. Then schedule 2, covering the last two months of the term, will be active for months 2 and 1.

", - "locationName":"active" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleList":{ - "type":"list", - "member":{ - "shape":"PriceSchedule", - "locationName":"item" - } - }, - "PriceScheduleSpecification":{ - "type":"structure", - "members":{ - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency for transacting the Reserved Instance resale. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Price":{ - "shape":"Double", - "documentation":"

The fixed price for the term.

", - "locationName":"price" - }, - "Term":{ - "shape":"Long", - "documentation":"

The number of months remaining in the reservation. For example, 2 is the second to the last month before the capacity reservation expires.

", - "locationName":"term" - } - }, - "documentation":"

Describes the price for a Reserved Instance.

" - }, - "PriceScheduleSpecificationList":{ - "type":"list", - "member":{ - "shape":"PriceScheduleSpecification", - "locationName":"item" - } - }, - "PricingDetail":{ - "type":"structure", - "members":{ - "Count":{ - "shape":"Integer", - "documentation":"

The number of reservations available for the price.

", - "locationName":"count" - }, - "Price":{ - "shape":"Double", - "documentation":"

The price per instance.

", - "locationName":"price" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "PricingDetailsList":{ - "type":"list", - "member":{ - "shape":"PricingDetail", - "locationName":"item" - } - }, - "PrincipalIdFormat":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

PrincipalIdFormatARN description

", - "locationName":"arn" - }, - "Statuses":{ - "shape":"IdFormatList", - "documentation":"

PrincipalIdFormatStatuses description

", - "locationName":"statusSet" - } - }, - "documentation":"

PrincipalIdFormat description

" - }, - "PrincipalIdFormatList":{ - "type":"list", - "member":{ - "shape":"PrincipalIdFormat", - "locationName":"item" - } - }, - "PrincipalType":{ - "type":"string", - "enum":[ - "All", - "Service", - "OrganizationUnit", - "Account", - "User", - "Role" - ] - }, - "PrivateIpAddressConfigSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesPrivateIpAddressConfig", - "locationName":"PrivateIpAddressConfigSet" - } - }, - "PrivateIpAddressSpecification":{ - "type":"structure", - "members":{ - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.

", - "locationName":"primary" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IPv4 addresses.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Describes a secondary private IPv4 address for a network interface.

" - }, - "PrivateIpAddressSpecificationList":{ - "type":"list", - "member":{ - "shape":"PrivateIpAddressSpecification", - "locationName":"item" - } - }, - "PrivateIpAddressStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PrivateIpAddress" - } - }, - "ProductCode":{ - "type":"structure", - "members":{ - "ProductCodeId":{ - "shape":"String", - "documentation":"

The product code.

", - "locationName":"productCode" - }, - "ProductCodeType":{ - "shape":"ProductCodeValues", - "documentation":"

The type of product code.

", - "locationName":"type" - } - }, - "documentation":"

Describes a product code.

" - }, - "ProductCodeList":{ - "type":"list", - "member":{ - "shape":"ProductCode", - "locationName":"item" - } - }, - "ProductCodeStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ProductCode" - } - }, - "ProductCodeValues":{ - "type":"string", - "enum":[ - "devpay", - "marketplace" - ] - }, - "ProductDescriptionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PropagatingVgw":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"gatewayId" - } - }, - "documentation":"

Describes a virtual private gateway propagating route.

" - }, - "PropagatingVgwList":{ - "type":"list", - "member":{ - "shape":"PropagatingVgw", - "locationName":"item" - } - }, - "ProvisionedBandwidth":{ - "type":"structure", - "members":{ - "ProvisionTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisionTime" - }, - "Provisioned":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"provisioned" - }, - "RequestTime":{ - "shape":"DateTime", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requestTime" - }, - "Requested":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"requested" - }, - "Status":{ - "shape":"String", - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

", - "locationName":"status" - } - }, - "documentation":"

Reserved. If you need to sustain traffic greater than the documented limits, contact us through the Support Center.

" - }, - "PublicIpStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PublicIp" - } - }, - "Purchase":{ - "type":"structure", - "members":{ - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the UpfrontPrice and HourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation's term in seconds.

", - "locationName":"duration" - }, - "HostIdSet":{ - "shape":"ResponseHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts associated with the reservation.

", - "locationName":"hostIdSet" - }, - "HostReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"hostReservationId" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price of the reservation per hour.

", - "locationName":"hourlyPrice" - }, - "InstanceFamily":{ - "shape":"String", - "documentation":"

The instance family on the Dedicated Host that the reservation can be associated with.

", - "locationName":"instanceFamily" - }, - "PaymentOption":{ - "shape":"PaymentOption", - "documentation":"

The payment option for the reservation.

", - "locationName":"paymentOption" - }, - "UpfrontPrice":{ - "shape":"String", - "documentation":"

The upfront price of the reservation.

", - "locationName":"upfrontPrice" - } - }, - "documentation":"

Describes the result of the purchase.

" - }, - "PurchaseHostReservationRequest":{ - "type":"structure", - "required":[ - "HostIdSet", - "OfferingId" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice, LimitPrice, and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

" - }, - "HostIdSet":{ - "shape":"RequestHostIdSet", - "documentation":"

The IDs of the Dedicated Hosts with which the reservation will be associated.

" - }, - "LimitPrice":{ - "shape":"String", - "documentation":"

The specified limit is checked against the total upfront cost of the reservation (calculated as the offering's upfront cost multiplied by the host count). If the total upfront cost is greater than the specified price limit, the request fails. This is used to ensure that the purchase does not exceed the expected upfront cost of the purchase. At this time, the only supported currency is USD. For example, to indicate a limit price of USD 100, specify 100.00.

" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the offering.

" - } - } - }, - "PurchaseHostReservationResult":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"clientToken" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the totalUpfrontPrice and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "Purchase":{ - "shape":"PurchaseSet", - "documentation":"

Describes the details of the purchase.

", - "locationName":"purchase" - }, - "TotalHourlyPrice":{ - "shape":"String", - "documentation":"

The total hourly price of the reservation calculated per hour.

", - "locationName":"totalHourlyPrice" - }, - "TotalUpfrontPrice":{ - "shape":"String", - "documentation":"

The total amount charged to your account when you purchase the reservation.

", - "locationName":"totalUpfrontPrice" - } - } - }, - "PurchaseRequest":{ - "type":"structure", - "required":[ - "InstanceCount", - "PurchaseToken" - ], - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

" - }, - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token.

" - } - }, - "documentation":"

Describes a request to purchase Scheduled Instances.

" - }, - "PurchaseRequestSet":{ - "type":"list", - "member":{ - "shape":"PurchaseRequest", - "locationName":"PurchaseRequest" - }, - "min":1 - }, - "PurchaseReservedInstancesOfferingRequest":{ - "type":"structure", - "required":[ - "InstanceCount", - "ReservedInstancesOfferingId" - ], - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Reserved Instances to purchase.

" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering to purchase.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "LimitPrice":{ - "shape":"ReservedInstanceLimitPrice", - "documentation":"

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

", - "locationName":"limitPrice" - } - }, - "documentation":"

Contains the parameters for PurchaseReservedInstancesOffering.

" - }, - "PurchaseReservedInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The IDs of the purchased Reserved Instances.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Contains the output of PurchaseReservedInstancesOffering.

" - }, - "PurchaseScheduledInstancesRequest":{ - "type":"structure", - "required":["PurchaseRequests"], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "PurchaseRequests":{ - "shape":"PurchaseRequestSet", - "documentation":"

One or more purchase requests.

", - "locationName":"PurchaseRequest" - } - }, - "documentation":"

Contains the parameters for PurchaseScheduledInstances.

" - }, - "PurchaseScheduledInstancesResult":{ - "type":"structure", - "members":{ - "ScheduledInstanceSet":{ - "shape":"PurchasedScheduledInstanceSet", - "documentation":"

Information about the Scheduled Instances.

", - "locationName":"scheduledInstanceSet" - } - }, - "documentation":"

Contains the output of PurchaseScheduledInstances.

" - }, - "PurchaseSet":{ - "type":"list", - "member":{ - "shape":"Purchase", - "locationName":"item" - } - }, - "PurchasedScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "RIProductDescription":{ - "type":"string", - "enum":[ - "Linux/UNIX", - "Linux/UNIX (Amazon VPC)", - "Windows", - "Windows (Amazon VPC)" - ] - }, - "ReasonCodesList":{ - "type":"list", - "member":{ - "shape":"ReportInstanceReasonCodes", - "locationName":"item" - } - }, - "RebootInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for RebootInstances.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

", - "locationName":"amount" - }, - "Frequency":{ - "shape":"RecurringChargeFrequency", - "documentation":"

The frequency of the recurring charge.

", - "locationName":"frequency" - } - }, - "documentation":"

Describes a recurring charge.

" - }, - "RecurringChargeFrequency":{ - "type":"string", - "enum":["Hourly"] - }, - "RecurringChargesList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"item" - } - }, - "Region":{ - "type":"structure", - "members":{ - "Endpoint":{ - "shape":"String", - "documentation":"

The region service endpoint.

", - "locationName":"regionEndpoint" - }, - "RegionName":{ - "shape":"String", - "documentation":"

The name of the region.

", - "locationName":"regionName" - } - }, - "documentation":"

Describes a region.

" - }, - "RegionList":{ - "type":"list", - "member":{ - "shape":"Region", - "locationName":"item" - } - }, - "RegionNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"RegionName" - } - }, - "RegisterImageRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "ImageLocation":{ - "shape":"String", - "documentation":"

The full path to your AMI manifest in Amazon S3 storage.

" - }, - "Architecture":{ - "shape":"ArchitectureValues", - "documentation":"

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

", - "locationName":"architecture" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for your AMI.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EnaSupport":{ - "shape":"Boolean", - "documentation":"

Set to true to enable enhanced networking with ENA for the AMI and any instances that you launch from the AMI.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"enaSupport" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "Name":{ - "shape":"String", - "documentation":"

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

", - "locationName":"name" - }, - "BillingProducts":{ - "shape":"BillingProductList", - "documentation":"

The billing product codes. Your account must be authorized to specify billing product codes. Otherwise, you can use the AWS Marketplace to bill for the use of an AMI.

", - "locationName":"BillingProduct" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "RootDeviceName":{ - "shape":"String", - "documentation":"

The device name of the root device volume (for example, /dev/sda1).

", - "locationName":"rootDeviceName" - }, - "SriovNetSupport":{ - "shape":"String", - "documentation":"

Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the AMI and any instances that you launch from the AMI.

There is no way to disable sriovNetSupport at this time.

This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable.

", - "locationName":"sriovNetSupport" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The type of virtualization (hvm | paravirtual).

Default: paravirtual

", - "locationName":"virtualizationType" - } - }, - "documentation":"

Contains the parameters for RegisterImage.

" - }, - "RegisterImageResult":{ - "type":"structure", - "members":{ - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the newly registered AMI.

", - "locationName":"imageId" - } - }, - "documentation":"

Contains the output of RegisterImage.

" - }, - "RejectVpcEndpointConnectionsRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "VpcEndpointIds" - ], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service.

" - }, - "VpcEndpointIds":{ - "shape":"ValueStringList", - "documentation":"

The IDs of one or more VPC endpoints.

", - "locationName":"VpcEndpointId" - } - } - }, - "RejectVpcEndpointConnectionsResult":{ - "type":"structure", - "members":{ - "Unsuccessful":{ - "shape":"UnsuccessfulItemSet", - "documentation":"

Information about the endpoints that were not rejected, if applicable.

", - "locationName":"unsuccessful" - } - } - }, - "RejectVpcPeeringConnectionRequest":{ - "type":"structure", - "required":["VpcPeeringConnectionId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for RejectVpcPeeringConnection.

" - }, - "RejectVpcPeeringConnectionResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, it returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of RejectVpcPeeringConnection.

" - }, - "ReleaseAddressRequest":{ - "type":"structure", - "members":{ - "AllocationId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The allocation ID. Required for EC2-VPC.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ReleaseAddress.

" - }, - "ReleaseHostsRequest":{ - "type":"structure", - "required":["HostIds"], - "members":{ - "HostIds":{ - "shape":"RequestHostIdList", - "documentation":"

The IDs of the Dedicated Hosts to release.

", - "locationName":"hostId" - } - }, - "documentation":"

Contains the parameters for ReleaseHosts.

" - }, - "ReleaseHostsResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"ResponseHostIdList", - "documentation":"

The IDs of the Dedicated Hosts that were successfully released.

", - "locationName":"successful" - }, - "Unsuccessful":{ - "shape":"UnsuccessfulItemList", - "documentation":"

The IDs of the Dedicated Hosts that could not be released, including an error message.

", - "locationName":"unsuccessful" - } - }, - "documentation":"

Contains the output of ReleaseHosts.

" - }, - "ReplaceIamInstanceProfileAssociationRequest":{ - "type":"structure", - "required":[ - "IamInstanceProfile", - "AssociationId" - ], - "members":{ - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

" - }, - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the existing IAM instance profile association.

" - } - } - }, - "ReplaceIamInstanceProfileAssociationResult":{ - "type":"structure", - "members":{ - "IamInstanceProfileAssociation":{ - "shape":"IamInstanceProfileAssociation", - "documentation":"

Information about the IAM instance profile association.

", - "locationName":"iamInstanceProfileAssociation" - } - } - }, - "ReplaceNetworkAclAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "NetworkAclId" - ], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The ID of the current association between the original network ACL and the subnet.

", - "locationName":"associationId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the new network ACL to associate with the subnet.

", - "locationName":"networkAclId" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceNetworkAclAssociation.

" - }, - "ReplaceNetworkAclEntryRequest":{ - "type":"structure", - "required":[ - "Egress", - "NetworkAclId", - "Protocol", - "RuleAction", - "RuleNumber" - ], - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", - "locationName":"cidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Egress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to replace the egress rule.

Default: If no value is specified, we replace the ingress rule.

", - "locationName":"egress" - }, - "IcmpTypeCode":{ - "shape":"IcmpTypeCode", - "documentation":"

ICMP protocol: The ICMP or ICMPv6 type and code. Required if specifying the ICMP (1) protocol, or protocol 58 (ICMPv6) with an IPv6 CIDR block.

", - "locationName":"Icmp" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 network range to allow or deny, in CIDR notation (for example 2001:bd8:1234:1a00::/64).

", - "locationName":"ipv6CidrBlock" - }, - "NetworkAclId":{ - "shape":"String", - "documentation":"

The ID of the ACL.

", - "locationName":"networkAclId" - }, - "PortRange":{ - "shape":"PortRange", - "documentation":"

TCP or UDP protocols: The range of ports the rule applies to. Required if specifying TCP (6) or UDP (17) for the protocol.

", - "locationName":"portRange" - }, - "Protocol":{ - "shape":"String", - "documentation":"

The IP protocol. You can specify all or -1 to mean all protocols. If you specify all, -1, or a protocol number other than tcp, udp, or icmp, traffic on all ports is allowed, regardless of any ports or ICMP types or codes you that specify. If you specify protocol 58 (ICMPv6) and specify an IPv4 CIDR block, traffic for all ICMP types and codes allowed, regardless of any that you specify. If you specify protocol 58 (ICMPv6) and specify an IPv6 CIDR block, you must specify an ICMP type and code.

", - "locationName":"protocol" - }, - "RuleAction":{ - "shape":"RuleAction", - "documentation":"

Indicates whether to allow or deny the traffic that matches the rule.

", - "locationName":"ruleAction" - }, - "RuleNumber":{ - "shape":"Integer", - "documentation":"

The rule number of the entry to replace.

", - "locationName":"ruleNumber" - } - }, - "documentation":"

Contains the parameters for ReplaceNetworkAclEntry.

" - }, - "ReplaceRouteRequest":{ - "type":"structure", - "required":["RouteTableId"], - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR address block used for the destination match. The value that you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationCidrBlock" - }, - "DestinationIpv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR address block used for the destination match. The value that you provide must match the CIDR of an existing route in the table.

", - "locationName":"destinationIpv6CidrBlock" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EgressOnlyInternetGatewayId":{ - "shape":"String", - "documentation":"

[IPv6 traffic only] The ID of an egress-only internet gateway.

", - "locationName":"egressOnlyInternetGatewayId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of an internet gateway or virtual private gateway.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

[IPv4 traffic only] The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of a network interface.

", - "locationName":"networkInterfaceId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of a VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Contains the parameters for ReplaceRoute.

" - }, - "ReplaceRouteTableAssociationRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "RouteTableId" - ], - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID.

", - "locationName":"associationId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the new route table to associate with the subnet.

", - "locationName":"routeTableId" - } - }, - "documentation":"

Contains the parameters for ReplaceRouteTableAssociation.

" - }, - "ReplaceRouteTableAssociationResult":{ - "type":"structure", - "members":{ - "NewAssociationId":{ - "shape":"String", - "documentation":"

The ID of the new association.

", - "locationName":"newAssociationId" - } - }, - "documentation":"

Contains the output of ReplaceRouteTableAssociation.

" - }, - "ReportInstanceReasonCodes":{ - "type":"string", - "enum":[ - "instance-stuck-in-state", - "unresponsive", - "not-accepting-credentials", - "password-not-available", - "performance-network", - "performance-instance-store", - "performance-ebs-volume", - "performance-other", - "other" - ] - }, - "ReportInstanceStatusRequest":{ - "type":"structure", - "required":[ - "Instances", - "ReasonCodes", - "Status" - ], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

Descriptive text about the health state of your instance.

", - "locationName":"description" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state ended.

", - "locationName":"endTime" - }, - "Instances":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instances.

", - "locationName":"instanceId" - }, - "ReasonCodes":{ - "shape":"ReasonCodesList", - "documentation":"

One or more reason codes that describe the health state of your instance.

  • instance-stuck-in-state: My instance is stuck in a state.

  • unresponsive: My instance is unresponsive.

  • not-accepting-credentials: My instance is not accepting my credentials.

  • password-not-available: A password is not available for my instance.

  • performance-network: My instance is experiencing performance problems that I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems that I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems that I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

", - "locationName":"reasonCode" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time at which the reported instance health state began.

", - "locationName":"startTime" - }, - "Status":{ - "shape":"ReportStatusType", - "documentation":"

The status of all instances listed.

", - "locationName":"status" - } - }, - "documentation":"

Contains the parameters for ReportInstanceStatus.

" - }, - "ReportStatusType":{ - "type":"string", - "enum":[ - "ok", - "impaired" - ] - }, - "RequestHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "RequestLaunchTemplateData":{ - "type":"structure", - "members":{ - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see User Provided Kernels in the Amazon Elastic Compute Cloud User Guide.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

" - }, - "IamInstanceProfile":{ - "shape":"LaunchTemplateIamInstanceProfileSpecificationRequest", - "documentation":"

The IAM instance profile.

" - }, - "BlockDeviceMappings":{ - "shape":"LaunchTemplateBlockDeviceMappingRequestList", - "documentation":"

The block device mapping.

Supplying both a snapshot ID and an encryption value as arguments for block-device mapping results in an error. This is because only blank volumes can be encrypted on start, and these are not created from a snapshot. If a snapshot is the basis for the volume, it contains data by definition and its encryption status cannot be changed using this action.

", - "locationName":"BlockDeviceMapping" - }, - "NetworkInterfaces":{ - "shape":"LaunchTemplateInstanceNetworkInterfaceSpecificationRequestList", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by using DescribeImages.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "Monitoring":{ - "shape":"LaunchTemplatesMonitoringRequest", - "documentation":"

The monitoring for the instance.

" - }, - "Placement":{ - "shape":"LaunchTemplatePlacementRequest", - "documentation":"

The placement for the instance.

" - }, - "RamDiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see User Provided Kernels in the Amazon Elastic Compute Cloud User Guide.

" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API. To change this attribute to false after launch, use ModifyInstanceAttribute.

" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded user data to make available to the instance. For more information, see Running Commands on Your Linux Instance at Launch (Linux) and Adding User Data (Windows).

" - }, - "TagSpecifications":{ - "shape":"LaunchTemplateTagSpecificationRequestList", - "documentation":"

The tags to apply to the resources during launch. You can only tag instances and volumes on launch. The specified tags are applied to all instances or volumes that are created during launch. To tag a resource after it has been created, see CreateTags.

", - "locationName":"TagSpecification" - }, - "ElasticGpuSpecifications":{ - "shape":"ElasticGpuSpecificationList", - "documentation":"

An elastic GPU to associate with the instance.

", - "locationName":"ElasticGpuSpecification" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup. You cannot specify both a security group ID and security name in the same request.

", - "locationName":"SecurityGroupId" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead. You cannot specify both a security group ID and security name in the same request.

", - "locationName":"SecurityGroup" - }, - "InstanceMarketOptions":{ - "shape":"LaunchTemplateInstanceMarketOptionsRequest", - "documentation":"

The market (purchasing) option for the instances.

" - }, - "CreditSpecification":{ - "shape":"CreditSpecificationRequest", - "documentation":"

The credit option for CPU usage of the instance. Valid for T2 instances only.

" - }, - "CpuOptions":{ - "shape":"LaunchTemplateCpuOptionsRequest", - "documentation":"

The CPU options for the instance. For more information, see Optimizing CPU Options in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "documentation":"

The information to include in the launch template.

" - }, - "RequestSpotFleetRequest":{ - "type":"structure", - "required":["SpotFleetRequestConfig"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration for the Spot Fleet request.

", - "locationName":"spotFleetRequestConfig" - } - }, - "documentation":"

Contains the parameters for RequestSpotFleet.

" - }, - "RequestSpotFleetResponse":{ - "type":"structure", - "required":["SpotFleetRequestId"], - "members":{ - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - } - }, - "documentation":"

Contains the output of RequestSpotFleet.

" - }, - "RequestSpotInstancesRequest":{ - "type":"structure", - "members":{ - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The user-specified name for a logical grouping of requests.

When you specify an Availability Zone group in a Spot Instance request, all Spot Instances in the request are launched in the same Availability Zone. Instance proximity is maintained with this parameter, but the choice of Availability Zone is not. The group applies only to requests for Spot Instances of the same instance type. Any additional Spot Instance requests that are specified with the same Availability Zone group name are launched in that same Availability Zone, as long as at least one instance from the group is still active.

If there is no active instance running in the Availability Zone group that you specify for a new Spot Instance request (all instances are terminated, the request is expired, or the maximum price you specified falls below current Spot price), then Amazon EC2 launches the instance in any Availability Zone where the constraint can be met. Consequently, the subsequent set of Spot Instances could be placed in a different zone from the original request, even if you specified the same Availability Zone group.

Default: Instances are launched in any available Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot Instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

The duration period starts as soon as your Spot Instance receives its instance ID. At the end of the duration period, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates.

You can't specify an Availability Zone group or a launch group if you specify a duration.

", - "locationName":"blockDurationMinutes" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon EC2 User Guide for Linux Instances.

", - "locationName":"clientToken" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot Instances to launch.

Default: 1

", - "locationName":"instanceCount" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Default: Instances are launched and terminated individually

", - "locationName":"launchGroup" - }, - "LaunchSpecification":{ - "shape":"RequestSpotLaunchSpecification", - "documentation":"

The launch specification.

" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per hour that you are willing to pay for a Spot Instance. The default is the On-Demand price.

", - "locationName":"spotPrice" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

Default: one-time

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached. The default end date is 7 days from the current date.

", - "locationName":"validUntil" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

" - } - }, - "documentation":"

Contains the parameters for RequestSpotInstances.

" - }, - "RequestSpotInstancesResult":{ - "type":"structure", - "members":{ - "SpotInstanceRequests":{ - "shape":"SpotInstanceRequestList", - "documentation":"

One or more Spot Instance requests.

", - "locationName":"spotInstanceRequestSet" - } - }, - "documentation":"

Contains the output of RequestSpotInstances.

" - }, - "RequestSpotLaunchSpecification":{ - "type":"structure", - "members":{ - "SecurityGroupIds":{ - "shape":"ValueStringList", - "documentation":"

One or more security group IDs.

", - "locationName":"SecurityGroupId" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"SecurityGroup" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries. You can't specify both a snapshot ID and an encryption value. This is because only blank volumes can be encrypted on creation. If a snapshot is the basis for a volume, it is not blank and its encryption status is used for the volume encryption status.

", - "locationName":"blockDeviceMapping" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

Indicates whether basic or detailed monitoring is enabled for the instance.

Default: Disabled

", - "locationName":"monitoring" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

", - "locationName":"NetworkInterface" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information for the instance.

", - "locationName":"placement" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instance.

", - "locationName":"subnetId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded user data for the instance.

", - "locationName":"userData" - } - }, - "documentation":"

Describes the launch specification for an instance.

" - }, - "Reservation":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupIdentifierList", - "documentation":"

[EC2-Classic only] One or more security groups.

", - "locationName":"groupSet" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

One or more instances.

", - "locationName":"instancesSet" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The ID of the AWS account that owns the reservation.

", - "locationName":"ownerId" - }, - "RequesterId":{ - "shape":"String", - "documentation":"

The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling).

", - "locationName":"requesterId" - }, - "ReservationId":{ - "shape":"String", - "documentation":"

The ID of the reservation.

", - "locationName":"reservationId" - } - }, - "documentation":"

Describes a reservation.

" - }, - "ReservationList":{ - "type":"list", - "member":{ - "shape":"Reservation", - "locationName":"item" - } - }, - "ReservationState":{ - "type":"string", - "enum":[ - "payment-pending", - "payment-failed", - "active", - "retired" - ] - }, - "ReservationValue":{ - "type":"structure", - "members":{ - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly rate of the reservation.

", - "locationName":"hourlyPrice" - }, - "RemainingTotalValue":{ - "shape":"String", - "documentation":"

The balance of the total value (the sum of remainingUpfrontValue + hourlyPrice * number of hours remaining).

", - "locationName":"remainingTotalValue" - }, - "RemainingUpfrontValue":{ - "shape":"String", - "documentation":"

The remaining upfront cost of the reservation.

", - "locationName":"remainingUpfrontValue" - } - }, - "documentation":"

The cost associated with the Reserved Instance.

" - }, - "ReservedInstanceIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstanceId" - } - }, - "ReservedInstanceLimitPrice":{ - "type":"structure", - "members":{ - "Amount":{ - "shape":"Double", - "documentation":"

Used for Reserved Instance Marketplace offerings. Specifies the limit price on the total order (instanceCount * price).

", - "locationName":"amount" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency in which the limitPrice amount is specified. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - } - }, - "documentation":"

Describes the limit price of a Reserved Instance offering.

" - }, - "ReservedInstanceReservationValue":{ - "type":"structure", - "members":{ - "ReservationValue":{ - "shape":"ReservationValue", - "documentation":"

The total value of the Convertible Reserved Instance that you are exchanging.

", - "locationName":"reservationValue" - }, - "ReservedInstanceId":{ - "shape":"String", - "documentation":"

The ID of the Convertible Reserved Instance that you are exchanging.

", - "locationName":"reservedInstanceId" - } - }, - "documentation":"

The total value of the Convertible Reserved Instance.

" - }, - "ReservedInstanceReservationValueSet":{ - "type":"list", - "member":{ - "shape":"ReservedInstanceReservationValue", - "locationName":"item" - } - }, - "ReservedInstanceState":{ - "type":"string", - "enum":[ - "payment-pending", - "active", - "payment-failed", - "retired" - ] - }, - "ReservedInstances":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "End":{ - "shape":"DateTime", - "documentation":"

The time when the Reserved Instance expires.

", - "locationName":"end" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reservations purchased.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "Start":{ - "shape":"DateTime", - "documentation":"

The date and time the Reserved Instance started.

", - "locationName":"start" - }, - "State":{ - "shape":"ReservedInstanceState", - "documentation":"

The state of the Reserved Instance purchase.

", - "locationName":"state" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

The offering class of the Reserved Instance.

", - "locationName":"offeringClass" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Scope":{ - "shape":"scope", - "documentation":"

The scope of the Reserved Instance.

", - "locationName":"scope" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a Reserved Instance.

" - }, - "ReservedInstancesConfiguration":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the modified Reserved Instances.

", - "locationName":"availabilityZone" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of modified Reserved Instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type for the modified Reserved Instances.

", - "locationName":"instanceType" - }, - "Platform":{ - "shape":"String", - "documentation":"

The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.

", - "locationName":"platform" - }, - "Scope":{ - "shape":"scope", - "documentation":"

Whether the Reserved Instance is applied to instances in a region or instances in a specific Availability Zone.

", - "locationName":"scope" - } - }, - "documentation":"

Describes the configuration settings for the modified Reserved Instances.

" - }, - "ReservedInstancesConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesConfiguration", - "locationName":"item" - } - }, - "ReservedInstancesId":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - } - }, - "documentation":"

Describes the ID of a Reserved Instance.

" - }, - "ReservedInstancesIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesId" - } - }, - "ReservedInstancesList":{ - "type":"list", - "member":{ - "shape":"ReservedInstances", - "locationName":"item" - } - }, - "ReservedInstancesListing":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time the listing was created.

", - "locationName":"createDate" - }, - "InstanceCounts":{ - "shape":"InstanceCountList", - "documentation":"

The number of instances in this state.

", - "locationName":"instanceCounts" - }, - "PriceSchedules":{ - "shape":"PriceScheduleList", - "documentation":"

The price of the Reserved Instance listing.

", - "locationName":"priceSchedules" - }, - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance.

", - "locationName":"reservedInstancesId" - }, - "ReservedInstancesListingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance listing.

", - "locationName":"reservedInstancesListingId" - }, - "Status":{ - "shape":"ListingStatus", - "documentation":"

The status of the Reserved Instance listing.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the current status of the Reserved Instance listing. The response can be blank.

", - "locationName":"statusMessage" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The last modified timestamp of the listing.

", - "locationName":"updateDate" - } - }, - "documentation":"

Describes a Reserved Instance listing.

" - }, - "ReservedInstancesListingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesListing", - "locationName":"item" - } - }, - "ReservedInstancesModification":{ - "type":"structure", - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive key supplied by the client to ensure that the request is idempotent. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was created.

", - "locationName":"createDate" - }, - "EffectiveDate":{ - "shape":"DateTime", - "documentation":"

The time for the modification to become effective.

", - "locationName":"effectiveDate" - }, - "ModificationResults":{ - "shape":"ReservedInstancesModificationResultList", - "documentation":"

Contains target configurations along with their corresponding new Reserved Instance IDs.

", - "locationName":"modificationResultSet" - }, - "ReservedInstancesIds":{ - "shape":"ReservedIntancesIds", - "documentation":"

The IDs of one or more Reserved Instances.

", - "locationName":"reservedInstancesSet" - }, - "ReservedInstancesModificationId":{ - "shape":"String", - "documentation":"

A unique ID for the Reserved Instance modification.

", - "locationName":"reservedInstancesModificationId" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Reserved Instances modification request.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

The reason for the status.

", - "locationName":"statusMessage" - }, - "UpdateDate":{ - "shape":"DateTime", - "documentation":"

The time when the modification request was last updated.

", - "locationName":"updateDate" - } - }, - "documentation":"

Describes a Reserved Instance modification.

" - }, - "ReservedInstancesModificationIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReservedInstancesModificationId" - } - }, - "ReservedInstancesModificationList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModification", - "locationName":"item" - } - }, - "ReservedInstancesModificationResult":{ - "type":"structure", - "members":{ - "ReservedInstancesId":{ - "shape":"String", - "documentation":"

The ID for the Reserved Instances that were created as part of the modification request. This field is only available when the modification is fulfilled.

", - "locationName":"reservedInstancesId" - }, - "TargetConfiguration":{ - "shape":"ReservedInstancesConfiguration", - "documentation":"

The target Reserved Instances configurations supplied as part of the modification request.

", - "locationName":"targetConfiguration" - } - }, - "documentation":"

Describes the modification request/s.

" - }, - "ReservedInstancesModificationResultList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesModificationResult", - "locationName":"item" - } - }, - "ReservedInstancesOffering":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the Reserved Instance can be used.

", - "locationName":"availabilityZone" - }, - "Duration":{ - "shape":"Long", - "documentation":"

The duration of the Reserved Instance, in seconds.

", - "locationName":"duration" - }, - "FixedPrice":{ - "shape":"Float", - "documentation":"

The purchase price of the Reserved Instance.

", - "locationName":"fixedPrice" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type on which the Reserved Instance can be used.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The Reserved Instance product platform description.

", - "locationName":"productDescription" - }, - "ReservedInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved Instance offering. This is the offering ID used in GetReservedInstancesExchangeQuote to confirm that an exchange can be made.

", - "locationName":"reservedInstancesOfferingId" - }, - "UsagePrice":{ - "shape":"Float", - "documentation":"

The usage price of the Reserved Instance, per hour.

", - "locationName":"usagePrice" - }, - "CurrencyCode":{ - "shape":"CurrencyCodeValues", - "documentation":"

The currency of the Reserved Instance offering you are purchasing. It's specified using ISO 4217 standard currency codes. At this time, the only supported currency is USD.

", - "locationName":"currencyCode" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance.

", - "locationName":"instanceTenancy" - }, - "Marketplace":{ - "shape":"Boolean", - "documentation":"

Indicates whether the offering is available through the Reserved Instance Marketplace (resale) or AWS. If it's a Reserved Instance Marketplace offering, this is true.

", - "locationName":"marketplace" - }, - "OfferingClass":{ - "shape":"OfferingClassType", - "documentation":"

If convertible it can be exchanged for Reserved Instances of the same or higher monetary value, with different configurations. If standard, it is not possible to perform an exchange.

", - "locationName":"offeringClass" - }, - "OfferingType":{ - "shape":"OfferingTypeValues", - "documentation":"

The Reserved Instance offering type.

", - "locationName":"offeringType" - }, - "PricingDetails":{ - "shape":"PricingDetailsList", - "documentation":"

The pricing details of the Reserved Instance offering.

", - "locationName":"pricingDetailsSet" - }, - "RecurringCharges":{ - "shape":"RecurringChargesList", - "documentation":"

The recurring charge tag assigned to the resource.

", - "locationName":"recurringCharges" - }, - "Scope":{ - "shape":"scope", - "documentation":"

Whether the Reserved Instance is applied to instances in a region or an Availability Zone.

", - "locationName":"scope" - } - }, - "documentation":"

Describes a Reserved Instance offering.

" - }, - "ReservedInstancesOfferingIdStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ReservedInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesOffering", - "locationName":"item" - } - }, - "ReservedIntancesIds":{ - "type":"list", - "member":{ - "shape":"ReservedInstancesId", - "locationName":"item" - } - }, - "ResetFpgaImageAttributeName":{ - "type":"string", - "enum":["loadPermission"] - }, - "ResetFpgaImageAttributeRequest":{ - "type":"structure", - "required":["FpgaImageId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "FpgaImageId":{ - "shape":"String", - "documentation":"

The ID of the AFI.

" - }, - "Attribute":{ - "shape":"ResetFpgaImageAttributeName", - "documentation":"

The attribute.

" - } - } - }, - "ResetFpgaImageAttributeResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Is true if the request succeeds, and an error otherwise.

", - "locationName":"return" - } - } - }, - "ResetImageAttributeName":{ - "type":"string", - "enum":["launchPermission"] - }, - "ResetImageAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "ImageId" - ], - "members":{ - "Attribute":{ - "shape":"ResetImageAttributeName", - "documentation":"

The attribute to reset (currently you can only reset the launch permission attribute).

" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ResetImageAttribute.

" - }, - "ResetInstanceAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "InstanceId" - ], - "members":{ - "Attribute":{ - "shape":"InstanceAttributeName", - "documentation":"

The attribute to reset.

You can only reset the following attributes: kernel | ramdisk | sourceDestCheck. To change an instance attribute, use ModifyInstanceAttribute.

", - "locationName":"attribute" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - } - }, - "documentation":"

Contains the parameters for ResetInstanceAttribute.

" - }, - "ResetNetworkInterfaceAttributeRequest":{ - "type":"structure", - "required":["NetworkInterfaceId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "SourceDestCheck":{ - "shape":"String", - "documentation":"

The source/destination checking attribute. Resets the value to true.

", - "locationName":"sourceDestCheck" - } - }, - "documentation":"

Contains the parameters for ResetNetworkInterfaceAttribute.

" - }, - "ResetSnapshotAttributeRequest":{ - "type":"structure", - "required":[ - "Attribute", - "SnapshotId" - ], - "members":{ - "Attribute":{ - "shape":"SnapshotAttributeName", - "documentation":"

The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for ResetSnapshotAttribute.

" - }, - "ResourceIdList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ResourceList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ResourceType":{ - "type":"string", - "enum":[ - "customer-gateway", - "dhcp-options", - "image", - "instance", - "internet-gateway", - "network-acl", - "network-interface", - "reserved-instances", - "route-table", - "snapshot", - "spot-instances-request", - "subnet", - "security-group", - "volume", - "vpc", - "vpn-connection", - "vpn-gateway" - ] - }, - "ResponseError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"LaunchTemplateErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the error that's returned when you cannot delete a launch template version.

" - }, - "ResponseHostIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ResponseHostIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "ResponseLaunchTemplateData":{ - "type":"structure", - "members":{ - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel, if applicable.

", - "locationName":"kernelId" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O.

", - "locationName":"ebsOptimized" - }, - "IamInstanceProfile":{ - "shape":"LaunchTemplateIamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "BlockDeviceMappings":{ - "shape":"LaunchTemplateBlockDeviceMappingList", - "documentation":"

The block device mappings.

", - "locationName":"blockDeviceMappingSet" - }, - "NetworkInterfaces":{ - "shape":"LaunchTemplateInstanceNetworkInterfaceSpecificationList", - "documentation":"

The network interfaces.

", - "locationName":"networkInterfaceSet" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI that was used to launch the instance.

", - "locationName":"imageId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "Monitoring":{ - "shape":"LaunchTemplatesMonitoring", - "documentation":"

The monitoring for the instance.

", - "locationName":"monitoring" - }, - "Placement":{ - "shape":"LaunchTemplatePlacement", - "documentation":"

The placement of the instance.

", - "locationName":"placement" - }, - "RamDiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk, if applicable.

", - "locationName":"ramDiskId" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If set to true, indicates that the instance cannot be terminated using the Amazon EC2 console, command line tool, or API.

", - "locationName":"disableApiTermination" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data for the instance.

", - "locationName":"userData" - }, - "TagSpecifications":{ - "shape":"LaunchTemplateTagSpecificationList", - "documentation":"

The tags.

", - "locationName":"tagSpecificationSet" - }, - "ElasticGpuSpecifications":{ - "shape":"ElasticGpuSpecificationResponseList", - "documentation":"

The elastic GPU specification.

", - "locationName":"elasticGpuSpecificationSet" - }, - "SecurityGroupIds":{ - "shape":"ValueStringList", - "documentation":"

The security group IDs.

", - "locationName":"securityGroupIdSet" - }, - "SecurityGroups":{ - "shape":"ValueStringList", - "documentation":"

The security group names.

", - "locationName":"securityGroupSet" - }, - "InstanceMarketOptions":{ - "shape":"LaunchTemplateInstanceMarketOptions", - "documentation":"

The market (purchasing) option for the instances.

", - "locationName":"instanceMarketOptions" - }, - "CreditSpecification":{ - "shape":"CreditSpecification", - "documentation":"

The credit option for CPU usage of the instance.

", - "locationName":"creditSpecification" - }, - "CpuOptions":{ - "shape":"LaunchTemplateCpuOptions", - "documentation":"

The CPU options for the instance. For more information, see Optimizing CPU Options in the Amazon Elastic Compute Cloud User Guide.

", - "locationName":"cpuOptions" - } - }, - "documentation":"

The information for a launch template.

" - }, - "RestorableByStringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "RestoreAddressToClassicRequest":{ - "type":"structure", - "required":["PublicIp"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - } - }, - "documentation":"

Contains the parameters for RestoreAddressToClassic.

" - }, - "RestoreAddressToClassicResult":{ - "type":"structure", - "members":{ - "PublicIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

", - "locationName":"publicIp" - }, - "Status":{ - "shape":"Status", - "documentation":"

The move status for the IP address.

", - "locationName":"status" - } - }, - "documentation":"

Contains the output of RestoreAddressToClassic.

" - }, - "RevokeSecurityGroupEgressRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more sets of IP permissions. You can't specify a destination security group and a CIDR IP address range in the same set of permissions.

", - "locationName":"ipPermissions" - }, - "CidrIp":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify the CIDR.

", - "locationName":"cidrIp" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

Not supported. Use a set of IP permissions to specify the port.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify the protocol name or number.

", - "locationName":"ipProtocol" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

Not supported. Use a set of IP permissions to specify the port.

", - "locationName":"toPort" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify a destination security group.

", - "locationName":"sourceSecurityGroupName" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

Not supported. Use a set of IP permissions to specify a destination security group.

", - "locationName":"sourceSecurityGroupOwnerId" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupEgress.

" - }, - "RevokeSecurityGroupIngressRequest":{ - "type":"structure", - "members":{ - "CidrIp":{ - "shape":"String", - "documentation":"

The CIDR IP address range. You can't specify this parameter when specifying a source security group.

" - }, - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of port range for the TCP and UDP protocols, or an ICMP type number. For the ICMP type number, use -1 to specify all ICMP types.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. You must specify either the security group ID or the security group name in the request. For security groups in a nondefault VPC, you must specify the security group ID.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You must specify either the security group ID or the security group name in the request.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more sets of IP permissions. You can't specify a source security group and a CIDR IP address range in the same set of permissions.

" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers). Use -1 to specify all.

" - }, - "SourceSecurityGroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. For EC2-VPC, the source security group must be in the same VPC. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "SourceSecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

[EC2-Classic] The AWS account ID of the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. To revoke a specific rule for an IP protocol and port range, use a set of IP permissions instead.

" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of port range for the TCP and UDP protocols, or an ICMP code number. For the ICMP code number, use -1 to specify all ICMP codes for the ICMP type.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for RevokeSecurityGroupIngress.

" - }, - "Route":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR block used for the destination match.

", - "locationName":"destinationCidrBlock" - }, - "DestinationIpv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block used for the destination match.

", - "locationName":"destinationIpv6CidrBlock" - }, - "DestinationPrefixListId":{ - "shape":"String", - "documentation":"

The prefix of the AWS service.

", - "locationName":"destinationPrefixListId" - }, - "EgressOnlyInternetGatewayId":{ - "shape":"String", - "documentation":"

The ID of the egress-only internet gateway.

", - "locationName":"egressOnlyInternetGatewayId" - }, - "GatewayId":{ - "shape":"String", - "documentation":"

The ID of a gateway attached to your VPC.

", - "locationName":"gatewayId" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of a NAT instance in your VPC.

", - "locationName":"instanceId" - }, - "InstanceOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the instance.

", - "locationName":"instanceOwnerId" - }, - "NatGatewayId":{ - "shape":"String", - "documentation":"

The ID of a NAT gateway.

", - "locationName":"natGatewayId" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "Origin":{ - "shape":"RouteOrigin", - "documentation":"

Describes how the route was created.

  • CreateRouteTable - The route was automatically created when the route table was created.

  • CreateRoute - The route was manually added to the route table.

  • EnableVgwRoutePropagation - The route was propagated by route propagation.

", - "locationName":"origin" - }, - "State":{ - "shape":"RouteState", - "documentation":"

The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).

", - "locationName":"state" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a route in a route table.

" - }, - "RouteList":{ - "type":"list", - "member":{ - "shape":"Route", - "locationName":"item" - } - }, - "RouteOrigin":{ - "type":"string", - "enum":[ - "CreateRouteTable", - "CreateRoute", - "EnableVgwRoutePropagation" - ] - }, - "RouteState":{ - "type":"string", - "enum":[ - "active", - "blackhole" - ] - }, - "RouteTable":{ - "type":"structure", - "members":{ - "Associations":{ - "shape":"RouteTableAssociationList", - "documentation":"

The associations between the route table and one or more subnets.

", - "locationName":"associationSet" - }, - "PropagatingVgws":{ - "shape":"PropagatingVgwList", - "documentation":"

Any virtual private gateway (VGW) propagating routes.

", - "locationName":"propagatingVgwSet" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "Routes":{ - "shape":"RouteList", - "documentation":"

The routes in the route table.

", - "locationName":"routeSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the route table.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a route table.

" - }, - "RouteTableAssociation":{ - "type":"structure", - "members":{ - "Main":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the main route table.

", - "locationName":"main" - }, - "RouteTableAssociationId":{ - "shape":"String", - "documentation":"

The ID of the association between a route table and a subnet.

", - "locationName":"routeTableAssociationId" - }, - "RouteTableId":{ - "shape":"String", - "documentation":"

The ID of the route table.

", - "locationName":"routeTableId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet. A subnet ID is not returned for an implicit association.

", - "locationName":"subnetId" - } - }, - "documentation":"

Describes an association between a route table and a subnet.

" - }, - "RouteTableAssociationList":{ - "type":"list", - "member":{ - "shape":"RouteTableAssociation", - "locationName":"item" - } - }, - "RouteTableList":{ - "type":"list", - "member":{ - "shape":"RouteTable", - "locationName":"item" - } - }, - "RuleAction":{ - "type":"string", - "enum":[ - "allow", - "deny" - ] - }, - "RunInstancesMonitoringEnabled":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether detailed monitoring is enabled. Otherwise, basic monitoring is enabled.

", - "locationName":"enabled" - } - }, - "documentation":"

Describes the monitoring of an instance.

" - }, - "RunInstancesRequest":{ - "type":"structure", - "required":[ - "MaxCount", - "MinCount" - ], - "members":{ - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingRequestList", - "documentation":"

One or more block device mapping entries. You can't specify both a snapshot ID and an encryption value. This is because only blank volumes can be encrypted on creation. If a snapshot is the basis for a volume, it is not blank and its encryption status is used for the volume encryption status.

", - "locationName":"BlockDeviceMapping" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI, which you can get by calling DescribeImages. An AMI is required to launch an instance and must be specified here or in a launch template.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

Default: m1.small

" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

[EC2-VPC] A number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of instances to launch.

" - }, - "Ipv6Addresses":{ - "shape":"InstanceIpv6AddressList", - "documentation":"

[EC2-VPC] Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify this option if you've specified a minimum number of instances to launch.

", - "locationName":"Ipv6Address" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.

If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.

" - }, - "MaxCount":{ - "shape":"Integer", - "documentation":"

The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 FAQ.

" - }, - "MinCount":{ - "shape":"Integer", - "documentation":"

The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances.

Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more information about the default limits, and how to request an increase, see How many instances can I run in Amazon EC2 in the Amazon EC2 General FAQ.

" - }, - "Monitoring":{ - "shape":"RunInstancesMonitoringEnabled", - "documentation":"

The monitoring for the instance.

" - }, - "Placement":{ - "shape":"Placement", - "documentation":"

The placement for the instance.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon Elastic Compute Cloud User Guide.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdStringList", - "documentation":"

One or more security group IDs. You can create a security group using CreateSecurityGroup.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroupId" - }, - "SecurityGroups":{ - "shape":"SecurityGroupStringList", - "documentation":"

[EC2-Classic, default VPC] One or more security group names. For a nondefault VPC, you must use security group IDs instead.

Default: Amazon EC2 uses the default security group.

", - "locationName":"SecurityGroup" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the subnet to launch the instance into.

" - }, - "UserData":{ - "shape":"String", - "documentation":"

The user data to make available to the instance. For more information, see Running Commands on Your Linux Instance at Launch (Linux) and Adding User Data (Windows). If you are using a command line tool, base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text.

" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

Constraints: Maximum 64 ASCII characters

", - "locationName":"clientToken" - }, - "DisableApiTermination":{ - "shape":"Boolean", - "documentation":"

If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. To change this attribute to false after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior to terminate, you can terminate the instance by running the shutdown command from the instance.

Default: false

", - "locationName":"disableApiTermination" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "InstanceInitiatedShutdownBehavior":{ - "shape":"ShutdownBehavior", - "documentation":"

Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).

Default: stop

", - "locationName":"instanceInitiatedShutdownBehavior" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces.

", - "locationName":"networkInterface" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

[EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.

Only one private IP address can be designated as primary. You can't specify this option if you've specified the option to designate a private IP address as the primary IP address in a network interface specification. You cannot specify this option if you're launching more than one instance in the request.

", - "locationName":"privateIpAddress" - }, - "ElasticGpuSpecification":{ - "shape":"ElasticGpuSpecifications", - "documentation":"

An elastic GPU to associate with the instance.

" - }, - "TagSpecifications":{ - "shape":"TagSpecificationList", - "documentation":"

The tags to apply to the resources during launch. You can only tag instances and volumes on launch. The specified tags are applied to all instances or volumes that are created during launch. To tag a resource after it has been created, see CreateTags.

", - "locationName":"TagSpecification" - }, - "LaunchTemplate":{ - "shape":"LaunchTemplateSpecification", - "documentation":"

The launch template to use to launch the instances. Any parameters that you specify in RunInstances override the same parameters in the launch template. You can specify either the name or ID of a launch template, but not both.

" - }, - "InstanceMarketOptions":{ - "shape":"InstanceMarketOptionsRequest", - "documentation":"

The market (purchasing) option for the instances.

For RunInstances, persistent Spot Instance requests are only supported when InstanceInterruptionBehavior is set to either hibernate or stop.

" - }, - "CreditSpecification":{ - "shape":"CreditSpecificationRequest", - "documentation":"

The credit option for CPU usage of the instance. Valid values are standard and unlimited. To change this attribute after launch, use ModifyInstanceCreditSpecification. For more information, see T2 Instances in the Amazon Elastic Compute Cloud User Guide.

Default: standard

" - }, - "CpuOptions":{ - "shape":"CpuOptionsRequest", - "documentation":"

The CPU options for the instance. For more information, see Optimizing CPU Options in the Amazon Elastic Compute Cloud User Guide.

" - } - }, - "documentation":"

Contains the parameters for RunInstances.

" - }, - "RunScheduledInstancesRequest":{ - "type":"structure", - "required":[ - "LaunchSpecification", - "ScheduledInstanceId" - ], - "members":{ - "ClientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

", - "idempotencyToken":true - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

Default: 1

" - }, - "LaunchSpecification":{ - "shape":"ScheduledInstancesLaunchSpecification", - "documentation":"

The launch specification. You must match the instance type, Availability Zone, network, and platform of the schedule that you purchased.

" - }, - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

" - } - }, - "documentation":"

Contains the parameters for RunScheduledInstances.

" - }, - "RunScheduledInstancesResult":{ - "type":"structure", - "members":{ - "InstanceIdSet":{ - "shape":"InstanceIdSet", - "documentation":"

The IDs of the newly launched instances.

", - "locationName":"instanceIdSet" - } - }, - "documentation":"

Contains the output of RunScheduledInstances.

" - }, - "S3Storage":{ - "type":"structure", - "members":{ - "AWSAccessKeyId":{ - "shape":"String", - "documentation":"

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.

" - }, - "Bucket":{ - "shape":"String", - "documentation":"

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

", - "locationName":"bucket" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The beginning of the file name of the AMI.

", - "locationName":"prefix" - }, - "UploadPolicy":{ - "shape":"Blob", - "documentation":"

An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

", - "locationName":"uploadPolicy" - }, - "UploadPolicySignature":{ - "shape":"String", - "documentation":"

The signature of the JSON document.

", - "locationName":"uploadPolicySignature" - } - }, - "documentation":"

Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.

" - }, - "ScheduledInstance":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "CreateDate":{ - "shape":"DateTime", - "documentation":"

The date when the Scheduled Instance was purchased.

", - "locationName":"createDate" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances.

", - "locationName":"instanceCount" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "NextSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time for the next schedule to start.

", - "locationName":"nextSlotStartTime" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "PreviousSlotEndTime":{ - "shape":"DateTime", - "documentation":"

The time that the previous schedule ended or will end.

", - "locationName":"previousSlotEndTime" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "ScheduledInstanceId":{ - "shape":"String", - "documentation":"

The Scheduled Instance ID.

", - "locationName":"scheduledInstanceId" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "TermEndDate":{ - "shape":"DateTime", - "documentation":"

The end date for the Scheduled Instance.

", - "locationName":"termEndDate" - }, - "TermStartDate":{ - "shape":"DateTime", - "documentation":"

The start date for the Scheduled Instance.

", - "locationName":"termStartDate" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - } - }, - "documentation":"

Describes a Scheduled Instance.

" - }, - "ScheduledInstanceAvailability":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "AvailableInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of available instances.

", - "locationName":"availableInstanceCount" - }, - "FirstSlotStartTime":{ - "shape":"DateTime", - "documentation":"

The time period for the first schedule to start.

", - "locationName":"firstSlotStartTime" - }, - "HourlyPrice":{ - "shape":"String", - "documentation":"

The hourly price for a single instance.

", - "locationName":"hourlyPrice" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type. You can specify one of the C3, C4, M4, or R3 instance types.

", - "locationName":"instanceType" - }, - "MaxTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The maximum term. The only possible value is 365 days.

", - "locationName":"maxTermDurationInDays" - }, - "MinTermDurationInDays":{ - "shape":"Integer", - "documentation":"

The minimum term. The only possible value is 365 days.

", - "locationName":"minTermDurationInDays" - }, - "NetworkPlatform":{ - "shape":"String", - "documentation":"

The network platform (EC2-Classic or EC2-VPC).

", - "locationName":"networkPlatform" - }, - "Platform":{ - "shape":"String", - "documentation":"

The platform (Linux/UNIX or Windows).

", - "locationName":"platform" - }, - "PurchaseToken":{ - "shape":"String", - "documentation":"

The purchase token. This token expires in two hours.

", - "locationName":"purchaseToken" - }, - "Recurrence":{ - "shape":"ScheduledInstanceRecurrence", - "documentation":"

The schedule recurrence.

", - "locationName":"recurrence" - }, - "SlotDurationInHours":{ - "shape":"Integer", - "documentation":"

The number of hours in the schedule.

", - "locationName":"slotDurationInHours" - }, - "TotalScheduledInstanceHours":{ - "shape":"Integer", - "documentation":"

The total number of hours for a single instance for the entire term.

", - "locationName":"totalScheduledInstanceHours" - } - }, - "documentation":"

Describes a schedule that is available for your Scheduled Instances.

" - }, - "ScheduledInstanceAvailabilitySet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstanceAvailability", - "locationName":"item" - } - }, - "ScheduledInstanceIdRequestSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ScheduledInstanceId" - } - }, - "ScheduledInstanceRecurrence":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

", - "locationName":"frequency" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of frequency. For example, every 2 weeks or every 2 months.

", - "locationName":"interval" - }, - "OccurrenceDaySet":{ - "shape":"OccurrenceDaySet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday).

", - "locationName":"occurrenceDaySet" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month.

", - "locationName":"occurrenceRelativeToEnd" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for occurrenceDaySet (DayOfWeek or DayOfMonth).

", - "locationName":"occurrenceUnit" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceRecurrenceRequest":{ - "type":"structure", - "members":{ - "Frequency":{ - "shape":"String", - "documentation":"

The frequency (Daily, Weekly, or Monthly).

" - }, - "Interval":{ - "shape":"Integer", - "documentation":"

The interval quantity. The interval unit depends on the value of Frequency. For example, every 2 weeks or every 2 months.

" - }, - "OccurrenceDays":{ - "shape":"OccurrenceDayRequestSet", - "documentation":"

The days. For a monthly schedule, this is one or more days of the month (1-31). For a weekly schedule, this is one or more days of the week (1-7, where 1 is Sunday). You can't specify this value with a daily schedule. If the occurrence is relative to the end of the month, you can specify only a single day.

", - "locationName":"OccurrenceDay" - }, - "OccurrenceRelativeToEnd":{ - "shape":"Boolean", - "documentation":"

Indicates whether the occurrence is relative to the end of the specified week or month. You can't specify this value with a daily schedule.

" - }, - "OccurrenceUnit":{ - "shape":"String", - "documentation":"

The unit for OccurrenceDays (DayOfWeek or DayOfMonth). This value is required for a monthly schedule. You can't specify DayOfWeek with a weekly schedule. You can't specify this value with a daily schedule.

" - } - }, - "documentation":"

Describes the recurring schedule for a Scheduled Instance.

" - }, - "ScheduledInstanceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstance", - "locationName":"item" - } - }, - "ScheduledInstancesBlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name (for example, /dev/sdh or xvdh).

" - }, - "Ebs":{ - "shape":"ScheduledInstancesEbs", - "documentation":"

Parameters used to set up EBS volumes automatically when the instance is launched.

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the block device mapping of the AMI.

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name (ephemeralN). Instance store volumes are numbered starting from 0. An instance type with two available instance store volumes can specify mappings for ephemeral0 and ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.

Constraints: For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI.

" - } - }, - "documentation":"

Describes a block device mapping for a Scheduled Instance.

" - }, - "ScheduledInstancesBlockDeviceMappingSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesBlockDeviceMapping", - "locationName":"BlockDeviceMapping" - } - }, - "ScheduledInstancesEbs":{ - "type":"structure", - "members":{ - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is deleted on instance termination.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume is encrypted. You can attached encrypted volumes only to instances that support them.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about gp2 baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-20000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, Throughput Optimized HDD for st1, Cold HDD for sc1, or standard for Magnetic.

Default: standard

" - } - }, - "documentation":"

Describes an EBS volume for a Scheduled Instance.

" - }, - "ScheduledInstancesIamInstanceProfile":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN).

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name.

" - } - }, - "documentation":"

Describes an IAM instance profile for a Scheduled Instance.

" - }, - "ScheduledInstancesIpv6Address":{ - "type":"structure", - "members":{ - "Ipv6Address":{ - "shape":"Ipv6Address", - "documentation":"

The IPv6 address.

" - } - }, - "documentation":"

Describes an IPv6 address.

" - }, - "ScheduledInstancesIpv6AddressList":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesIpv6Address", - "locationName":"Ipv6Address" - } - }, - "ScheduledInstancesLaunchSpecification":{ - "type":"structure", - "required":["ImageId"], - "members":{ - "BlockDeviceMappings":{ - "shape":"ScheduledInstancesBlockDeviceMappingSet", - "documentation":"

One or more block device mapping entries.

", - "locationName":"BlockDeviceMapping" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.

Default: false

" - }, - "IamInstanceProfile":{ - "shape":"ScheduledInstancesIamInstanceProfile", - "documentation":"

The IAM instance profile.

" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the Amazon Machine Image (AMI).

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type.

" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

" - }, - "Monitoring":{ - "shape":"ScheduledInstancesMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

" - }, - "NetworkInterfaces":{ - "shape":"ScheduledInstancesNetworkInterfaceSet", - "documentation":"

One or more network interfaces.

", - "locationName":"NetworkInterface" - }, - "Placement":{ - "shape":"ScheduledInstancesPlacement", - "documentation":"

The placement information.

" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

" - }, - "SecurityGroupIds":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"SecurityGroupId" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances.

" - }, - "UserData":{ - "shape":"String", - "documentation":"

The base64-encoded MIME user data.

" - } - }, - "documentation":"

Describes the launch specification for a Scheduled Instance.

If you are launching the Scheduled Instance in EC2-VPC, you must specify the ID of the subnet. You can specify the subnet using either SubnetId or NetworkInterface.

" - }, - "ScheduledInstancesMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether monitoring is enabled.

" - } - }, - "documentation":"

Describes whether monitoring is enabled for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterface":{ - "type":"structure", - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Indicates whether to assign a public IPv4 address to instances launched in a VPC. The public IPv4 address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether to delete the interface when the instance is terminated.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description.

" - }, - "DeviceIndex":{ - "shape":"Integer", - "documentation":"

The index of the device for the network interface attachment.

" - }, - "Groups":{ - "shape":"ScheduledInstancesSecurityGroupIdSet", - "documentation":"

The IDs of one or more security groups.

", - "locationName":"Group" - }, - "Ipv6AddressCount":{ - "shape":"Integer", - "documentation":"

The number of IPv6 addresses to assign to the network interface. The IPv6 addresses are automatically selected from the subnet range.

" - }, - "Ipv6Addresses":{ - "shape":"ScheduledInstancesIpv6AddressList", - "documentation":"

One or more specific IPv6 addresses from the subnet range.

", - "locationName":"Ipv6Address" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IPv4 address of the network interface within the subnet.

" - }, - "PrivateIpAddressConfigs":{ - "shape":"PrivateIpAddressConfigSet", - "documentation":"

The private IPv4 addresses.

", - "locationName":"PrivateIpAddressConfig" - }, - "SecondaryPrivateIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of secondary private IPv4 addresses.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

" - } - }, - "documentation":"

Describes a network interface for a Scheduled Instance.

" - }, - "ScheduledInstancesNetworkInterfaceSet":{ - "type":"list", - "member":{ - "shape":"ScheduledInstancesNetworkInterface", - "locationName":"NetworkInterface" - } - }, - "ScheduledInstancesPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

" - } - }, - "documentation":"

Describes the placement for a Scheduled Instance.

" - }, - "ScheduledInstancesPrivateIpAddressConfig":{ - "type":"structure", - "members":{ - "Primary":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is a primary IPv4 address. Otherwise, this is a secondary IPv4 address.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The IPv4 address.

" - } - }, - "documentation":"

Describes a private IPv4 address for a Scheduled Instance.

" - }, - "ScheduledInstancesSecurityGroupIdSet":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroup":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

", - "locationName":"groupDescription" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

One or more inbound rules associated with the security group.

", - "locationName":"ipPermissions" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the security group.

", - "locationName":"ownerId" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "IpPermissionsEgress":{ - "shape":"IpPermissionList", - "documentation":"

[EC2-VPC] One or more outbound rules associated with the security group.

", - "locationName":"ipPermissionsEgress" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the security group.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

[EC2-VPC] The ID of the VPC for the security group.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a security group

" - }, - "SecurityGroupIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupIdentifier":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - } - }, - "documentation":"

Describes a security group.

" - }, - "SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"SecurityGroup", - "locationName":"item" - } - }, - "SecurityGroupReference":{ - "type":"structure", - "required":[ - "GroupId", - "ReferencingVpcId" - ], - "members":{ - "GroupId":{ - "shape":"String", - "documentation":"

The ID of your security group.

", - "locationName":"groupId" - }, - "ReferencingVpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC with the referencing security group.

", - "locationName":"referencingVpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC with a security group that references your security group.

" - }, - "SecurityGroupReferences":{ - "type":"list", - "member":{ - "shape":"SecurityGroupReference", - "locationName":"item" - } - }, - "SecurityGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroup" - } - }, - "ServiceConfiguration":{ - "type":"structure", - "members":{ - "ServiceType":{ - "shape":"ServiceTypeDetailSet", - "documentation":"

The type of service.

", - "locationName":"serviceType" - }, - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service.

", - "locationName":"serviceId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the service.

", - "locationName":"serviceName" - }, - "ServiceState":{ - "shape":"ServiceState", - "documentation":"

The service state.

", - "locationName":"serviceState" - }, - "AvailabilityZones":{ - "shape":"ValueStringList", - "documentation":"

In the Availability Zones in which the service is available.

", - "locationName":"availabilityZoneSet" - }, - "AcceptanceRequired":{ - "shape":"Boolean", - "documentation":"

Indicates whether requests from other AWS accounts to create an endpoint to the service must first be accepted.

", - "locationName":"acceptanceRequired" - }, - "NetworkLoadBalancerArns":{ - "shape":"ValueStringList", - "documentation":"

The Amazon Resource Names (ARNs) of the Network Load Balancers for the service.

", - "locationName":"networkLoadBalancerArnSet" - }, - "BaseEndpointDnsNames":{ - "shape":"ValueStringList", - "documentation":"

The DNS names for the service.

", - "locationName":"baseEndpointDnsNameSet" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name for the service.

", - "locationName":"privateDnsName" - } - }, - "documentation":"

Describes a service configuration for a VPC endpoint service.

" - }, - "ServiceConfigurationSet":{ - "type":"list", - "member":{ - "shape":"ServiceConfiguration", - "locationName":"item" - } - }, - "ServiceDetail":{ - "type":"structure", - "members":{ - "ServiceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the service.

", - "locationName":"serviceName" - }, - "ServiceType":{ - "shape":"ServiceTypeDetailSet", - "documentation":"

The type of service.

", - "locationName":"serviceType" - }, - "AvailabilityZones":{ - "shape":"ValueStringList", - "documentation":"

The Availability Zones in which the service is available.

", - "locationName":"availabilityZoneSet" - }, - "Owner":{ - "shape":"String", - "documentation":"

The AWS account ID of the service owner.

", - "locationName":"owner" - }, - "BaseEndpointDnsNames":{ - "shape":"ValueStringList", - "documentation":"

The DNS names for the service.

", - "locationName":"baseEndpointDnsNameSet" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name for the service.

", - "locationName":"privateDnsName" - }, - "VpcEndpointPolicySupported":{ - "shape":"Boolean", - "documentation":"

Indicates whether the service supports endpoint policies.

", - "locationName":"vpcEndpointPolicySupported" - }, - "AcceptanceRequired":{ - "shape":"Boolean", - "documentation":"

Indicates whether VPC endpoint connection requests to the service must be accepted by the service owner.

", - "locationName":"acceptanceRequired" - } - }, - "documentation":"

Describes a VPC endpoint service.

" - }, - "ServiceDetailSet":{ - "type":"list", - "member":{ - "shape":"ServiceDetail", - "locationName":"item" - } - }, - "ServiceState":{ - "type":"string", - "enum":[ - "Pending", - "Available", - "Deleting", - "Deleted", - "Failed" - ] - }, - "ServiceType":{ - "type":"string", - "enum":[ - "Interface", - "Gateway" - ] - }, - "ServiceTypeDetail":{ - "type":"structure", - "members":{ - "ServiceType":{ - "shape":"ServiceType", - "documentation":"

The type of service.

", - "locationName":"serviceType" - } - }, - "documentation":"

Describes the type of service for a VPC endpoint.

" - }, - "ServiceTypeDetailSet":{ - "type":"list", - "member":{ - "shape":"ServiceTypeDetail", - "locationName":"item" - } - }, - "ShutdownBehavior":{ - "type":"string", - "enum":[ - "stop", - "terminate" - ] - }, - "SlotDateTimeRangeRequest":{ - "type":"structure", - "required":[ - "EarliestTime", - "LatestTime" - ], - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start. This value must be later than or equal to the earliest date and at most three months in the future.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule. The time period must span less than one day.

" - }, - "SlotStartTimeRangeRequest":{ - "type":"structure", - "members":{ - "EarliestTime":{ - "shape":"DateTime", - "documentation":"

The earliest date and time, in UTC, for the Scheduled Instance to start.

" - }, - "LatestTime":{ - "shape":"DateTime", - "documentation":"

The latest date and time, in UTC, for the Scheduled Instance to start.

" - } - }, - "documentation":"

Describes the time period for a Scheduled Instance to start its first schedule.

" - }, - "Snapshot":{ - "type":"structure", - "members":{ - "DataEncryptionKeyId":{ - "shape":"String", - "documentation":"

The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"dataEncryptionKeyId" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the snapshot.

", - "locationName":"description" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the snapshot is encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.

", - "locationName":"kmsKeyId" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the EBS snapshot owner.

", - "locationName":"ownerId" - }, - "Progress":{ - "shape":"String", - "documentation":"

The progress of the snapshot, as a percentage.

", - "locationName":"progress" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The ID of the snapshot. Each snapshot receives a unique identifier when it is created.

", - "locationName":"snapshotId" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the snapshot was initiated.

", - "locationName":"startTime" - }, - "State":{ - "shape":"SnapshotState", - "documentation":"

The snapshot state.

", - "locationName":"status" - }, - "StateMessage":{ - "shape":"String", - "documentation":"

Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.

", - "locationName":"statusMessage" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume that was used to create the snapshot. Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.

", - "locationName":"volumeId" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"volumeSize" - }, - "OwnerAlias":{ - "shape":"String", - "documentation":"

Value from an Amazon-maintained list (amazon | aws-marketplace | microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.

", - "locationName":"ownerAlias" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the snapshot.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a snapshot.

" - }, - "SnapshotAttributeName":{ - "type":"string", - "enum":[ - "productCodes", - "createVolumePermission" - ] - }, - "SnapshotDetail":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the snapshot.

", - "locationName":"description" - }, - "DeviceName":{ - "shape":"String", - "documentation":"

The block device mapping for the snapshot.

", - "locationName":"deviceName" - }, - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of progress for the task.

", - "locationName":"progress" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status of the snapshot creation.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the snapshot creation.

", - "locationName":"statusMessage" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL used to access the disk image.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - } - }, - "documentation":"

Describes the snapshot created from the imported disk.

" - }, - "SnapshotDetailList":{ - "type":"list", - "member":{ - "shape":"SnapshotDetail", - "locationName":"item" - } - }, - "SnapshotDiskContainer":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the disk image being imported.

" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image being imported.

Valid values: VHD | VMDK | OVA

" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).

" - }, - "UserBucket":{ - "shape":"UserBucket", - "documentation":"

The S3 bucket for the disk image.

" - } - }, - "documentation":"

The disk container object for the import snapshot request.

" - }, - "SnapshotIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotId" - } - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"item" - } - }, - "SnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error" - ] - }, - "SnapshotTaskDetail":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the snapshot.

", - "locationName":"description" - }, - "DiskImageSize":{ - "shape":"Double", - "documentation":"

The size of the disk in the snapshot, in GiB.

", - "locationName":"diskImageSize" - }, - "Format":{ - "shape":"String", - "documentation":"

The format of the disk image from which the snapshot is created.

", - "locationName":"format" - }, - "Progress":{ - "shape":"String", - "documentation":"

The percentage of completion for the import snapshot task.

", - "locationName":"progress" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID of the disk being imported.

", - "locationName":"snapshotId" - }, - "Status":{ - "shape":"String", - "documentation":"

A brief status for the import snapshot task.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A detailed status message for the import snapshot task.

", - "locationName":"statusMessage" - }, - "Url":{ - "shape":"String", - "documentation":"

The URL of the disk image from which the snapshot is created.

", - "locationName":"url" - }, - "UserBucket":{ - "shape":"UserBucketDetails", - "documentation":"

The S3 bucket for the disk image.

", - "locationName":"userBucket" - } - }, - "documentation":"

Details about the import snapshot task.

" - }, - "SpotAllocationStrategy":{ - "type":"string", - "enum":[ - "lowest-price", - "diversified" - ] - }, - "SpotDatafeedSubscription":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket where the Spot Instance data feed is located.

", - "locationName":"bucket" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account.

", - "locationName":"ownerId" - }, - "Prefix":{ - "shape":"String", - "documentation":"

The prefix that is prepended to data feed files.

", - "locationName":"prefix" - }, - "State":{ - "shape":"DatafeedSubscriptionState", - "documentation":"

The state of the Spot Instance data feed subscription.

", - "locationName":"state" - } - }, - "documentation":"

Describes the data feed for a Spot Instance.

" - }, - "SpotFleetLaunchSpecification":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"GroupIdentifierList", - "documentation":"

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

", - "locationName":"groupSet" - }, - "AddressingType":{ - "shape":"String", - "documentation":"

Deprecated.

", - "locationName":"addressingType" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappingList", - "documentation":"

One or more block device mapping entries. You can't specify both a snapshot ID and an encryption value. This is because only blank volumes can be encrypted on creation. If a snapshot is the basis for a volume, it is not blank and its encryption status is used for the volume encryption status.

", - "locationName":"blockDeviceMapping" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

", - "locationName":"ebsOptimized" - }, - "IamInstanceProfile":{ - "shape":"IamInstanceProfileSpecification", - "documentation":"

The IAM instance profile.

", - "locationName":"iamInstanceProfile" - }, - "ImageId":{ - "shape":"String", - "documentation":"

The ID of the AMI.

", - "locationName":"imageId" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "KernelId":{ - "shape":"String", - "documentation":"

The ID of the kernel.

", - "locationName":"kernelId" - }, - "KeyName":{ - "shape":"String", - "documentation":"

The name of the key pair.

", - "locationName":"keyName" - }, - "Monitoring":{ - "shape":"SpotFleetMonitoring", - "documentation":"

Enable or disable monitoring for the instances.

", - "locationName":"monitoring" - }, - "NetworkInterfaces":{ - "shape":"InstanceNetworkInterfaceSpecificationList", - "documentation":"

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

", - "locationName":"networkInterfaceSet" - }, - "Placement":{ - "shape":"SpotPlacement", - "documentation":"

The placement information.

", - "locationName":"placement" - }, - "RamdiskId":{ - "shape":"String", - "documentation":"

The ID of the RAM disk.

", - "locationName":"ramdiskId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per unit hour that you are willing to pay for a Spot Instance. If this value is not specified, the default is the Spot price specified for the fleet. To determine the Spot price per unit hour, divide the Spot price by the value of WeightedCapacity.

", - "locationName":"spotPrice" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet in which to launch the instances. To specify multiple subnets, separate them using commas; for example, \"subnet-a61dafcf, subnet-65ea5f08\".

", - "locationName":"subnetId" - }, - "UserData":{ - "shape":"String", - "documentation":"

The Base64-encoded user data to make available to the instances.

", - "locationName":"userData" - }, - "WeightedCapacity":{ - "shape":"Double", - "documentation":"

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

", - "locationName":"weightedCapacity" - }, - "TagSpecifications":{ - "shape":"SpotFleetTagSpecificationList", - "documentation":"

The tags to apply during creation.

", - "locationName":"tagSpecificationSet" - } - }, - "documentation":"

Describes the launch specification for one or more Spot Instances.

" - }, - "SpotFleetMonitoring":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Enables monitoring for the instance.

Default: false

", - "locationName":"enabled" - } - }, - "documentation":"

Describes whether monitoring is enabled.

" - }, - "SpotFleetRequestConfig":{ - "type":"structure", - "required":[ - "CreateTime", - "SpotFleetRequestConfig", - "SpotFleetRequestId", - "SpotFleetRequestState" - ], - "members":{ - "ActivityStatus":{ - "shape":"ActivityStatus", - "documentation":"

The progress of the Spot Fleet request. If there is an error, the status is error. After all requests are placed, the status is pending_fulfillment. If the size of the fleet is equal to or greater than its target capacity, the status is fulfilled. If the size of the fleet is decreased, the status is pending_termination while Spot Instances are terminating.

", - "locationName":"activityStatus" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The creation date and time of the request.

", - "locationName":"createTime" - }, - "SpotFleetRequestConfig":{ - "shape":"SpotFleetRequestConfigData", - "documentation":"

The configuration of the Spot Fleet request.

", - "locationName":"spotFleetRequestConfig" - }, - "SpotFleetRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Fleet request.

", - "locationName":"spotFleetRequestId" - }, - "SpotFleetRequestState":{ - "shape":"BatchState", - "documentation":"

The state of the Spot Fleet request.

", - "locationName":"spotFleetRequestState" - } - }, - "documentation":"

Describes a Spot Fleet request.

" - }, - "SpotFleetRequestConfigData":{ - "type":"structure", - "required":[ - "IamFleetRole", - "TargetCapacity" - ], - "members":{ - "AllocationStrategy":{ - "shape":"AllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot Fleet request. The default is lowestPrice.

", - "locationName":"allocationStrategy" - }, - "OnDemandAllocationStrategy":{ - "shape":"OnDemandAllocationStrategy", - "documentation":"

The order of the launch template overrides to use in fulfilling On-Demand capacity. If you specify lowestPrice, Spot Fleet uses price to determine the order, launching the lowest price first. If you specify prioritized, Spot Fleet uses the priority that you assign to each Spot Fleet launch template override, launching the highest priority first. If you do not specify a value, Spot Fleet defaults to lowestPrice.

", - "locationName":"onDemandAllocationStrategy" - }, - "ClientToken":{ - "shape":"String", - "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of your listings. This helps to avoid duplicate listings. For more information, see Ensuring Idempotency.

", - "locationName":"clientToken" - }, - "ExcessCapacityTerminationPolicy":{ - "shape":"ExcessCapacityTerminationPolicy", - "documentation":"

Indicates whether running Spot Instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.

", - "locationName":"excessCapacityTerminationPolicy" - }, - "FulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of units fulfilled by this request compared to the set target capacity.

", - "locationName":"fulfilledCapacity" - }, - "OnDemandFulfilledCapacity":{ - "shape":"Double", - "documentation":"

The number of On-Demand units fulfilled by this request compared to the set target On-Demand capacity.

", - "locationName":"onDemandFulfilledCapacity" - }, - "IamFleetRole":{ - "shape":"String", - "documentation":"

Grants the Spot Fleet permission to terminate Spot Instances on your behalf when you cancel its Spot Fleet request using CancelSpotFleetRequests or when the Spot Fleet request expires, if you set terminateInstancesWithExpiration.

", - "locationName":"iamFleetRole" - }, - "LaunchSpecifications":{ - "shape":"LaunchSpecsList", - "documentation":"

The launch specifications for the Spot Fleet request.

", - "locationName":"launchSpecifications" - }, - "LaunchTemplateConfigs":{ - "shape":"LaunchTemplateConfigList", - "documentation":"

The launch template and overrides.

", - "locationName":"launchTemplateConfigs" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per unit hour that you are willing to pay for a Spot Instance. The default is the On-Demand price.

", - "locationName":"spotPrice" - }, - "TargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

", - "locationName":"targetCapacity" - }, - "OnDemandTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of On-Demand units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

", - "locationName":"onDemandTargetCapacity" - }, - "TerminateInstancesWithExpiration":{ - "shape":"Boolean", - "documentation":"

Indicates whether running Spot Instances should be terminated when the Spot Fleet request expires.

", - "locationName":"terminateInstancesWithExpiration" - }, - "Type":{ - "shape":"FleetType", - "documentation":"

The type of request. Indicates whether the Spot Fleet only requests the target capacity or also attempts to maintain it. When this value is request, the Spot Fleet only places the required requests. It does not attempt to replenish Spot Instances if capacity is diminished, nor does it submit requests in alternative Spot pools if capacity is not available. To maintain a certain target capacity, the Spot Fleet places the required requests to meet capacity and automatically replenishes any interrupted instances. Default: maintain.

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot Instance requests are placed or able to fulfill the request. The default end date is 7 days from the current date.

", - "locationName":"validUntil" - }, - "ReplaceUnhealthyInstances":{ - "shape":"Boolean", - "documentation":"

Indicates whether Spot Fleet should replace unhealthy instances.

", - "locationName":"replaceUnhealthyInstances" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

", - "locationName":"instanceInterruptionBehavior" - }, - "LoadBalancersConfig":{ - "shape":"LoadBalancersConfig", - "documentation":"

One or more Classic Load Balancers and target groups to attach to the Spot Fleet request. Spot Fleet registers the running Spot Instances with the specified Classic Load Balancers and target groups.

With Network Load Balancers, Spot Fleet cannot register instances that have the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, and T1.

", - "locationName":"loadBalancersConfig" - }, - "InstancePoolsToUseCount":{ - "shape":"Integer", - "documentation":"

The number of Spot pools across which to allocate your target Spot capacity. Valid only when Spot AllocationStrategy is set to lowest-price. Spot Fleet selects the cheapest Spot pools and evenly allocates your target Spot capacity across the number of Spot pools that you specify.

", - "locationName":"instancePoolsToUseCount" - } - }, - "documentation":"

Describes the configuration of a Spot Fleet request.

" - }, - "SpotFleetRequestConfigSet":{ - "type":"list", - "member":{ - "shape":"SpotFleetRequestConfig", - "locationName":"item" - } - }, - "SpotFleetTagSpecification":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource. Currently, the only resource type that is supported is instance.

", - "locationName":"resourceType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags.

", - "locationName":"tag" - } - }, - "documentation":"

The tags for a Spot Fleet resource.

" - }, - "SpotFleetTagSpecificationList":{ - "type":"list", - "member":{ - "shape":"SpotFleetTagSpecification", - "locationName":"item" - } - }, - "SpotInstanceInterruptionBehavior":{ - "type":"string", - "enum":[ - "hibernate", - "stop", - "terminate" - ] - }, - "SpotInstanceRequest":{ - "type":"structure", - "members":{ - "ActualBlockHourlyPrice":{ - "shape":"String", - "documentation":"

If you specified a duration and your Spot Instance request was fulfilled, this is the fixed hourly price in effect for the Spot Instance while it runs.

", - "locationName":"actualBlockHourlyPrice" - }, - "AvailabilityZoneGroup":{ - "shape":"String", - "documentation":"

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

", - "locationName":"availabilityZoneGroup" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The duration for the Spot Instance, in minutes.

", - "locationName":"blockDurationMinutes" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"createTime" - }, - "Fault":{ - "shape":"SpotInstanceStateFault", - "documentation":"

The fault codes for the Spot Instance request, if any.

", - "locationName":"fault" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

", - "locationName":"instanceId" - }, - "LaunchGroup":{ - "shape":"String", - "documentation":"

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

", - "locationName":"launchGroup" - }, - "LaunchSpecification":{ - "shape":"LaunchSpecification", - "documentation":"

Additional information for launching instances.

", - "locationName":"launchSpecification" - }, - "LaunchedAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the request is launched.

", - "locationName":"launchedAvailabilityZone" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

The product description associated with the Spot Instance.

", - "locationName":"productDescription" - }, - "SpotInstanceRequestId":{ - "shape":"String", - "documentation":"

The ID of the Spot Instance request.

", - "locationName":"spotInstanceRequestId" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per hour that you are willing to pay for a Spot Instance.

", - "locationName":"spotPrice" - }, - "State":{ - "shape":"SpotInstanceState", - "documentation":"

The state of the Spot Instance request. Spot status information helps track your Spot Instance requests. For more information, see Spot Status in the Amazon EC2 User Guide for Linux Instances.

", - "locationName":"state" - }, - "Status":{ - "shape":"SpotInstanceStatus", - "documentation":"

The status code and status message describing the Spot Instance request.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "Type":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type.

", - "locationName":"type" - }, - "ValidFrom":{ - "shape":"DateTime", - "documentation":"

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

", - "locationName":"validFrom" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, it remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached. The default end date is 7 days from the current date.

", - "locationName":"validUntil" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted.

", - "locationName":"instanceInterruptionBehavior" - } - }, - "documentation":"

Describes a Spot Instance request.

" - }, - "SpotInstanceRequestIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SpotInstanceRequestId" - } - }, - "SpotInstanceRequestList":{ - "type":"list", - "member":{ - "shape":"SpotInstanceRequest", - "locationName":"item" - } - }, - "SpotInstanceState":{ - "type":"string", - "enum":[ - "open", - "active", - "closed", - "cancelled", - "failed" - ] - }, - "SpotInstanceStateFault":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the Spot Instance state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the Spot Instance state change.

", - "locationName":"message" - } - }, - "documentation":"

Describes a Spot Instance state change.

" - }, - "SpotInstanceStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The status code. For a list of status codes, see Spot Status Codes in the Amazon EC2 User Guide for Linux Instances.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The description for the status code.

", - "locationName":"message" - }, - "UpdateTime":{ - "shape":"DateTime", - "documentation":"

The date and time of the most recent status update, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"updateTime" - } - }, - "documentation":"

Describes the status of a Spot Instance request.

" - }, - "SpotInstanceType":{ - "type":"string", - "enum":[ - "one-time", - "persistent" - ] - }, - "SpotMarketOptions":{ - "type":"structure", - "members":{ - "MaxPrice":{ - "shape":"String", - "documentation":"

The maximum hourly price you're willing to pay for the Spot Instances. The default is the On-Demand price.

" - }, - "SpotInstanceType":{ - "shape":"SpotInstanceType", - "documentation":"

The Spot Instance request type. For RunInstances, persistent Spot Instance requests are only supported when InstanceInterruptionBehavior is set to either hibernate or stop.

" - }, - "BlockDurationMinutes":{ - "shape":"Integer", - "documentation":"

The required duration for the Spot Instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

" - }, - "ValidUntil":{ - "shape":"DateTime", - "documentation":"

The end date of the request. For a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached. The default end date is 7 days from the current date.

" - }, - "InstanceInterruptionBehavior":{ - "shape":"InstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

" - } - }, - "documentation":"

The options for Spot Instances.

" - }, - "SpotOptions":{ - "type":"structure", - "members":{ - "AllocationStrategy":{ - "shape":"SpotAllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot Fleet request. The default is lowest-price.

", - "locationName":"allocationStrategy" - }, - "InstanceInterruptionBehavior":{ - "shape":"SpotInstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

", - "locationName":"instanceInterruptionBehavior" - }, - "InstancePoolsToUseCount":{ - "shape":"Integer", - "documentation":"

The number of Spot pools across which to allocate your target Spot capacity. Valid only when AllocationStrategy is set to lowestPrice. EC2 Fleet selects the cheapest Spot pools and evenly allocates your target Spot capacity across the number of Spot pools that you specify.

", - "locationName":"instancePoolsToUseCount" - } - }, - "documentation":"

Describes the configuration of Spot Instances in an EC2 Fleet.

" - }, - "SpotOptionsRequest":{ - "type":"structure", - "members":{ - "AllocationStrategy":{ - "shape":"SpotAllocationStrategy", - "documentation":"

Indicates how to allocate the target capacity across the Spot pools specified by the Spot Fleet request. The default is lowestPrice.

" - }, - "InstanceInterruptionBehavior":{ - "shape":"SpotInstanceInterruptionBehavior", - "documentation":"

The behavior when a Spot Instance is interrupted. The default is terminate.

" - }, - "InstancePoolsToUseCount":{ - "shape":"Integer", - "documentation":"

The number of Spot pools across which to allocate your target Spot capacity. Valid only when Spot AllocationStrategy is set to lowest-price. EC2 Fleet selects the cheapest Spot pools and evenly allocates your target Spot capacity across the number of Spot pools that you specify.

" - } - }, - "documentation":"

Describes the configuration of Spot Instances in an EC2 Fleet request.

" - }, - "SpotPlacement":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

[Spot Fleet only] To specify multiple Availability Zones, separate them using commas; for example, \"us-west-2a, us-west-2b\".

", - "locationName":"availabilityZone" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the placement group.

", - "locationName":"groupName" - }, - "Tenancy":{ - "shape":"Tenancy", - "documentation":"

The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. The host tenancy is not supported for Spot Instances.

", - "locationName":"tenancy" - } - }, - "documentation":"

Describes Spot Instance placement.

" - }, - "SpotPrice":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone.

", - "locationName":"availabilityZone" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The instance type.

", - "locationName":"instanceType" - }, - "ProductDescription":{ - "shape":"RIProductDescription", - "documentation":"

A general description of the AMI.

", - "locationName":"productDescription" - }, - "SpotPrice":{ - "shape":"String", - "documentation":"

The maximum price per hour that you are willing to pay for a Spot Instance.

", - "locationName":"spotPrice" - }, - "Timestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

", - "locationName":"timestamp" - } - }, - "documentation":"

Describes the maximum price per hour that you are willing to pay for a Spot Instance.

" - }, - "SpotPriceHistoryList":{ - "type":"list", - "member":{ - "shape":"SpotPrice", - "locationName":"item" - } - }, - "StaleIpPermission":{ - "type":"structure", - "members":{ - "FromPort":{ - "shape":"Integer", - "documentation":"

The start of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"fromPort" - }, - "IpProtocol":{ - "shape":"String", - "documentation":"

The IP protocol name (for tcp, udp, and icmp) or number (see Protocol Numbers).

", - "locationName":"ipProtocol" - }, - "IpRanges":{ - "shape":"IpRanges", - "documentation":"

One or more IP ranges. Not applicable for stale security group rules.

", - "locationName":"ipRanges" - }, - "PrefixListIds":{ - "shape":"PrefixListIdSet", - "documentation":"

One or more prefix list IDs for an AWS service. Not applicable for stale security group rules.

", - "locationName":"prefixListIds" - }, - "ToPort":{ - "shape":"Integer", - "documentation":"

The end of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.

", - "locationName":"toPort" - }, - "UserIdGroupPairs":{ - "shape":"UserIdGroupPairSet", - "documentation":"

One or more security group pairs. Returns the ID of the referenced security group and VPC, and the ID and status of the VPC peering connection.

", - "locationName":"groups" - } - }, - "documentation":"

Describes a stale rule in a security group.

" - }, - "StaleIpPermissionSet":{ - "type":"list", - "member":{ - "shape":"StaleIpPermission", - "locationName":"item" - } - }, - "StaleSecurityGroup":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "Description":{ - "shape":"String", - "documentation":"

The description of the security group.

", - "locationName":"description" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group.

", - "locationName":"groupName" - }, - "StaleIpPermissions":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale inbound rules in the security group.

", - "locationName":"staleIpPermissions" - }, - "StaleIpPermissionsEgress":{ - "shape":"StaleIpPermissionSet", - "documentation":"

Information about the stale outbound rules in the security group.

", - "locationName":"staleIpPermissionsEgress" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the security group.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes a stale security group (a security group that contains stale rules).

" - }, - "StaleSecurityGroupSet":{ - "type":"list", - "member":{ - "shape":"StaleSecurityGroup", - "locationName":"item" - } - }, - "StartInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

", - "locationName":"additionalInfo" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for StartInstances.

" - }, - "StartInstancesResult":{ - "type":"structure", - "members":{ - "StartingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more started instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StartInstances.

" - }, - "State":{ - "type":"string", - "enum":[ - "PendingAcceptance", - "Pending", - "Available", - "Deleting", - "Deleted", - "Rejected", - "Failed", - "Expired" - ] - }, - "StateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The reason code for the state change.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The message for the state change.

  • Server.InsufficientInstanceCapacity: There was insufficient capacity available to satisfy the launch request.

  • Server.InternalError: An internal error caused the instance to terminate during launch.

  • Server.ScheduledStop: The instance was stopped due to a scheduled retirement.

  • Server.SpotInstanceShutdown: The instance was stopped because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.

  • Server.SpotInstanceTermination: The instance was terminated because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.

  • Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.

  • Client.InstanceTerminated: The instance was terminated or rebooted during AMI creation.

  • Client.InternalError: A client error caused the instance to terminate during launch.

  • Client.InvalidSnapshot.NotFound: The specified snapshot was not found.

  • Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.

  • Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your account limits.

", - "locationName":"message" - } - }, - "documentation":"

Describes a state change.

" - }, - "Status":{ - "type":"string", - "enum":[ - "MoveInProgress", - "InVpc", - "InClassic" - ] - }, - "StatusName":{ - "type":"string", - "enum":["reachability"] - }, - "StatusType":{ - "type":"string", - "enum":[ - "passed", - "failed", - "insufficient-data", - "initializing" - ] - }, - "StopInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Default: false

", - "locationName":"force" - } - }, - "documentation":"

Contains the parameters for StopInstances.

" - }, - "StopInstancesResult":{ - "type":"structure", - "members":{ - "StoppingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more stopped instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of StopInstances.

" - }, - "Storage":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Storage", - "documentation":"

An Amazon S3 storage location.

" - } - }, - "documentation":"

Describes the storage location for an instance store-backed AMI.

" - }, - "StorageLocation":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket.

" - }, - "Key":{ - "shape":"String", - "documentation":"

The key.

" - } - }, - "documentation":"

Describes a storage location in Amazon S3.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the subnet.

", - "locationName":"availabilityZone" - }, - "AvailableIpAddressCount":{ - "shape":"Integer", - "documentation":"

The number of unused private IPv4 addresses in the subnet. The IPv4 addresses for any stopped instances are considered unavailable.

", - "locationName":"availableIpAddressCount" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR block assigned to the subnet.

", - "locationName":"cidrBlock" - }, - "DefaultForAz":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is the default subnet for the Availability Zone.

", - "locationName":"defaultForAz" - }, - "MapPublicIpOnLaunch":{ - "shape":"Boolean", - "documentation":"

Indicates whether instances launched in this subnet receive a public IPv4 address.

", - "locationName":"mapPublicIpOnLaunch" - }, - "State":{ - "shape":"SubnetState", - "documentation":"

The current state of the subnet.

", - "locationName":"state" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the subnet.

", - "locationName":"subnetId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC the subnet is in.

", - "locationName":"vpcId" - }, - "AssignIpv6AddressOnCreation":{ - "shape":"Boolean", - "documentation":"

Indicates whether a network interface created in this subnet (including a network interface created by RunInstances) receives an IPv6 address.

", - "locationName":"assignIpv6AddressOnCreation" - }, - "Ipv6CidrBlockAssociationSet":{ - "shape":"SubnetIpv6CidrBlockAssociationSet", - "documentation":"

Information about the IPv6 CIDR blocks associated with the subnet.

", - "locationName":"ipv6CidrBlockAssociationSet" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the subnet.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetCidrBlockState":{ - "type":"structure", - "members":{ - "State":{ - "shape":"SubnetCidrBlockStateCode", - "documentation":"

The state of a CIDR block.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A message about the status of the CIDR block, if applicable.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes the state of a CIDR block.

" - }, - "SubnetCidrBlockStateCode":{ - "type":"string", - "enum":[ - "associating", - "associated", - "disassociating", - "disassociated", - "failing", - "failed" - ] - }, - "SubnetIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetId" - } - }, - "SubnetIpv6CidrBlockAssociation":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID for the CIDR block.

", - "locationName":"associationId" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block.

", - "locationName":"ipv6CidrBlock" - }, - "Ipv6CidrBlockState":{ - "shape":"SubnetCidrBlockState", - "documentation":"

Information about the state of the CIDR block.

", - "locationName":"ipv6CidrBlockState" - } - }, - "documentation":"

Describes an IPv6 CIDR block associated with a subnet.

" - }, - "SubnetIpv6CidrBlockAssociationSet":{ - "type":"list", - "member":{ - "shape":"SubnetIpv6CidrBlockAssociation", - "locationName":"item" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"item" - } - }, - "SubnetState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "SuccessfulInstanceCreditSpecificationItem":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - } - }, - "documentation":"

Describes the T2 instance whose credit option for CPU usage was successfully modified.

" - }, - "SuccessfulInstanceCreditSpecificationSet":{ - "type":"list", - "member":{ - "shape":"SuccessfulInstanceCreditSpecificationItem", - "locationName":"item" - } - }, - "SummaryStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data", - "not-applicable", - "initializing" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:

", - "locationName":"key" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 255 Unicode characters.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The tag key.

", - "locationName":"key" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource. For example, ami-1a2b3c4d.

", - "locationName":"resourceId" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

", - "locationName":"resourceType" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag value.

", - "locationName":"value" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagDescriptionList":{ - "type":"list", - "member":{ - "shape":"TagDescription", - "locationName":"item" - } - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"item" - } - }, - "TagSpecification":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to tag. Currently, the resource types that support tagging on creation are fleet, instance, snapshot, and volume. To tag a resource after it has been created, see CreateTags.

", - "locationName":"resourceType" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to apply to the resource.

", - "locationName":"Tag" - } - }, - "documentation":"

The tags to apply to a resource when the resource is being created.

" - }, - "TagSpecificationList":{ - "type":"list", - "member":{ - "shape":"TagSpecification", - "locationName":"item" - } - }, - "TargetCapacitySpecification":{ - "type":"structure", - "members":{ - "TotalTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request, filled using DefaultTargetCapacityType.

", - "locationName":"totalTargetCapacity" - }, - "OnDemandTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of On-Demand units to request.

", - "locationName":"onDemandTargetCapacity" - }, - "SpotTargetCapacity":{ - "shape":"Integer", - "documentation":"

The maximum number of Spot units to launch.

", - "locationName":"spotTargetCapacity" - }, - "DefaultTargetCapacityType":{ - "shape":"DefaultTargetCapacityType", - "documentation":"

The default TotalTargetCapacity, which is either Spot or On-Demand.

", - "locationName":"defaultTargetCapacityType" - } - }, - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

" - }, - "TargetCapacitySpecificationRequest":{ - "type":"structure", - "required":["TotalTargetCapacity"], - "members":{ - "TotalTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of units to request, filled using DefaultTargetCapacityType.

" - }, - "OnDemandTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of On-Demand units to request.

" - }, - "SpotTargetCapacity":{ - "shape":"Integer", - "documentation":"

The number of Spot units to request.

" - }, - "DefaultTargetCapacityType":{ - "shape":"DefaultTargetCapacityType", - "documentation":"

The default TotalTargetCapacity, which is either Spot or On-Demand.

" - } - }, - "documentation":"

The number of units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

" - }, - "TargetConfiguration":{ - "type":"structure", - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances the Convertible Reserved Instance offering can be applied to. This parameter is reserved and cannot be specified in a request

", - "locationName":"instanceCount" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The ID of the Convertible Reserved Instance offering.

", - "locationName":"offeringId" - } - }, - "documentation":"

Information about the Convertible Reserved Instance offering.

" - }, - "TargetConfigurationRequest":{ - "type":"structure", - "required":["OfferingId"], - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances the Covertible Reserved Instance offering can be applied to. This parameter is reserved and cannot be specified in a request

" - }, - "OfferingId":{ - "shape":"String", - "documentation":"

The Convertible Reserved Instance offering ID.

" - } - }, - "documentation":"

Details about the target configuration.

" - }, - "TargetConfigurationRequestSet":{ - "type":"list", - "member":{ - "shape":"TargetConfigurationRequest", - "locationName":"TargetConfigurationRequest" - } - }, - "TargetGroup":{ - "type":"structure", - "required":["Arn"], - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

", - "locationName":"arn" - } - }, - "documentation":"

Describes a load balancer target group.

" - }, - "TargetGroups":{ - "type":"list", - "member":{ - "shape":"TargetGroup", - "locationName":"item" - }, - "max":5, - "min":1 - }, - "TargetGroupsConfig":{ - "type":"structure", - "required":["TargetGroups"], - "members":{ - "TargetGroups":{ - "shape":"TargetGroups", - "documentation":"

One or more target groups.

", - "locationName":"targetGroups" - } - }, - "documentation":"

Describes the target groups to attach to a Spot Fleet. Spot Fleet registers the running Spot Instances with these target groups.

" - }, - "TargetReservationValue":{ - "type":"structure", - "members":{ - "ReservationValue":{ - "shape":"ReservationValue", - "documentation":"

The total value of the Convertible Reserved Instances that make up the exchange. This is the sum of the list value, remaining upfront price, and additional upfront cost of the exchange.

", - "locationName":"reservationValue" - }, - "TargetConfiguration":{ - "shape":"TargetConfiguration", - "documentation":"

The configuration of the Convertible Reserved Instances that make up the exchange.

", - "locationName":"targetConfiguration" - } - }, - "documentation":"

The total value of the new Convertible Reserved Instances.

" - }, - "TargetReservationValueSet":{ - "type":"list", - "member":{ - "shape":"TargetReservationValue", - "locationName":"item" - } - }, - "TelemetryStatus":{ - "type":"string", - "enum":[ - "UP", - "DOWN" - ] - }, - "Tenancy":{ - "type":"string", - "enum":[ - "default", - "dedicated", - "host" - ] - }, - "TerminateInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

Constraints: Up to 1000 instance IDs. We recommend breaking up this request into smaller batches.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for TerminateInstances.

" - }, - "TerminateInstancesResult":{ - "type":"structure", - "members":{ - "TerminatingInstances":{ - "shape":"InstanceStateChangeList", - "documentation":"

Information about one or more terminated instances.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of TerminateInstances.

" - }, - "TrafficType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT", - "ALL" - ] - }, - "TunnelOptionsList":{ - "type":"list", - "member":{ - "shape":"VpnTunnelOptionsSpecification", - "locationName":"item" - } - }, - "UnassignIpv6AddressesRequest":{ - "type":"structure", - "required":[ - "Ipv6Addresses", - "NetworkInterfaceId" - ], - "members":{ - "Ipv6Addresses":{ - "shape":"Ipv6AddressList", - "documentation":"

The IPv6 addresses to unassign from the network interface.

", - "locationName":"ipv6Addresses" - }, - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - } - } - }, - "UnassignIpv6AddressesResult":{ - "type":"structure", - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "UnassignedIpv6Addresses":{ - "shape":"Ipv6AddressList", - "documentation":"

The IPv6 addresses that have been unassigned from the network interface.

", - "locationName":"unassignedIpv6Addresses" - } - } - }, - "UnassignPrivateIpAddressesRequest":{ - "type":"structure", - "required":[ - "NetworkInterfaceId", - "PrivateIpAddresses" - ], - "members":{ - "NetworkInterfaceId":{ - "shape":"String", - "documentation":"

The ID of the network interface.

", - "locationName":"networkInterfaceId" - }, - "PrivateIpAddresses":{ - "shape":"PrivateIpAddressStringList", - "documentation":"

The secondary private IP addresses to unassign from the network interface. You can specify this option multiple times to unassign more than one IP address.

", - "locationName":"privateIpAddress" - } - }, - "documentation":"

Contains the parameters for UnassignPrivateIpAddresses.

" - }, - "UnmonitorInstancesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdStringList", - "documentation":"

One or more instance IDs.

", - "locationName":"InstanceId" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", - "locationName":"dryRun" - } - }, - "documentation":"

Contains the parameters for UnmonitorInstances.

" - }, - "UnmonitorInstancesResult":{ - "type":"structure", - "members":{ - "InstanceMonitorings":{ - "shape":"InstanceMonitoringList", - "documentation":"

The monitoring information.

", - "locationName":"instancesSet" - } - }, - "documentation":"

Contains the output of UnmonitorInstances.

" - }, - "UnsuccessfulInstanceCreditSpecificationErrorCode":{ - "type":"string", - "enum":[ - "InvalidInstanceID.Malformed", - "InvalidInstanceID.NotFound", - "IncorrectInstanceState", - "InstanceCreditSpecification.NotSupported" - ] - }, - "UnsuccessfulInstanceCreditSpecificationItem":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "Error":{ - "shape":"UnsuccessfulInstanceCreditSpecificationItemError", - "documentation":"

The applicable error for the T2 instance whose credit option for CPU usage was not modified.

", - "locationName":"error" - } - }, - "documentation":"

Describes the T2 instance whose credit option for CPU usage was not modified.

" - }, - "UnsuccessfulInstanceCreditSpecificationItemError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"UnsuccessfulInstanceCreditSpecificationErrorCode", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The applicable error message.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error for the T2 instance whose credit option for CPU usage was not modified.

" - }, - "UnsuccessfulInstanceCreditSpecificationSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulInstanceCreditSpecificationItem", - "locationName":"item" - } - }, - "UnsuccessfulItem":{ - "type":"structure", - "required":["Error"], - "members":{ - "Error":{ - "shape":"UnsuccessfulItemError", - "documentation":"

Information about the error.

", - "locationName":"error" - }, - "ResourceId":{ - "shape":"String", - "documentation":"

The ID of the resource.

", - "locationName":"resourceId" - } - }, - "documentation":"

Information about items that were not successfully processed in a batch call.

" - }, - "UnsuccessfulItemError":{ - "type":"structure", - "required":[ - "Code", - "Message" - ], - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The error code.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message accompanying the error code.

", - "locationName":"message" - } - }, - "documentation":"

Information about the error that occurred. For more information about errors, see Error Codes.

" - }, - "UnsuccessfulItemList":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UnsuccessfulItemSet":{ - "type":"list", - "member":{ - "shape":"UnsuccessfulItem", - "locationName":"item" - } - }, - "UpdateSecurityGroupRuleDescriptionsEgressRequest":{ - "type":"structure", - "required":["IpPermissions"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. You must specify either the security group ID or the security group name in the request. For security groups in a nondefault VPC, you must specify the security group ID.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[Default VPC] The name of the security group. You must specify either the security group ID or the security group name in the request.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

The IP permissions for the security group rule.

" - } - }, - "documentation":"

Contains the parameters for UpdateSecurityGroupRuleDescriptionsEgress.

" - }, - "UpdateSecurityGroupRuleDescriptionsEgressResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of UpdateSecurityGroupRuleDescriptionsEgress.

" - }, - "UpdateSecurityGroupRuleDescriptionsIngressRequest":{ - "type":"structure", - "required":["IpPermissions"], - "members":{ - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group. You must specify either the security group ID or the security group name in the request. For security groups in a nondefault VPC, you must specify the security group ID.

" - }, - "GroupName":{ - "shape":"String", - "documentation":"

[EC2-Classic, default VPC] The name of the security group. You must specify either the security group ID or the security group name in the request.

" - }, - "IpPermissions":{ - "shape":"IpPermissionList", - "documentation":"

The IP permissions for the security group rule.

" - } - }, - "documentation":"

Contains the parameters for UpdateSecurityGroupRuleDescriptionsIngress.

" - }, - "UpdateSecurityGroupRuleDescriptionsIngressResult":{ - "type":"structure", - "members":{ - "Return":{ - "shape":"Boolean", - "documentation":"

Returns true if the request succeeds; otherwise, returns an error.

", - "locationName":"return" - } - }, - "documentation":"

Contains the output of UpdateSecurityGroupRuleDescriptionsIngress.

" - }, - "UserBucket":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the disk image is located.

" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserBucketDetails":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"String", - "documentation":"

The S3 bucket from which the disk image was created.

", - "locationName":"s3Bucket" - }, - "S3Key":{ - "shape":"String", - "documentation":"

The file name of the disk image.

", - "locationName":"s3Key" - } - }, - "documentation":"

Describes the S3 bucket for the disk image.

" - }, - "UserData":{ - "type":"structure", - "members":{ - "Data":{ - "shape":"String", - "documentation":"

The user data. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

", - "locationName":"data" - } - }, - "documentation":"

Describes the user data for an instance.

" - }, - "UserGroupStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserGroup" - } - }, - "UserIdGroupPair":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description for the security group rule that references this user ID group pair.

Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*

", - "locationName":"description" - }, - "GroupId":{ - "shape":"String", - "documentation":"

The ID of the security group.

", - "locationName":"groupId" - }, - "GroupName":{ - "shape":"String", - "documentation":"

The name of the security group. In a request, use this parameter for a security group in EC2-Classic or a default VPC only. For a security group in a nondefault VPC, use the security group ID.

For a referenced security group in another VPC, this value is not returned if the referenced security group is deleted.

", - "locationName":"groupName" - }, - "PeeringStatus":{ - "shape":"String", - "documentation":"

The status of a VPC peering connection, if applicable.

", - "locationName":"peeringStatus" - }, - "UserId":{ - "shape":"String", - "documentation":"

The ID of an AWS account.

For a referenced security group in another VPC, the account ID of the referenced security group is returned in the response. If the referenced security group is deleted, this value is not returned.

[EC2-Classic] Required when adding or removing rules that reference a security group in another AWS account.

", - "locationName":"userId" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC for the referenced security group, if applicable.

", - "locationName":"vpcId" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection, if applicable.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a security group and AWS account ID pair.

" - }, - "UserIdGroupPairList":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdGroupPairSet":{ - "type":"list", - "member":{ - "shape":"UserIdGroupPair", - "locationName":"item" - } - }, - "UserIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"UserId" - } - }, - "ValueStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VersionDescription":{ - "type":"string", - "max":255 - }, - "VersionStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"item" - } - }, - "VgwTelemetry":{ - "type":"structure", - "members":{ - "AcceptedRouteCount":{ - "shape":"Integer", - "documentation":"

The number of accepted routes.

", - "locationName":"acceptedRouteCount" - }, - "LastStatusChange":{ - "shape":"DateTime", - "documentation":"

The date and time of the last change in status.

", - "locationName":"lastStatusChange" - }, - "OutsideIpAddress":{ - "shape":"String", - "documentation":"

The Internet-routable IP address of the virtual private gateway's outside interface.

", - "locationName":"outsideIpAddress" - }, - "Status":{ - "shape":"TelemetryStatus", - "documentation":"

The status of the VPN tunnel.

", - "locationName":"status" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

If an error occurs, a description of the error.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes telemetry for a VPN tunnel.

" - }, - "VgwTelemetryList":{ - "type":"list", - "member":{ - "shape":"VgwTelemetry", - "locationName":"item" - } - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "hvm", - "paravirtual" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "Attachments":{ - "shape":"VolumeAttachmentList", - "documentation":"

Information about the volume attachments.

", - "locationName":"attachmentSet" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone for the volume.

", - "locationName":"availabilityZone" - }, - "CreateTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when volume creation was initiated.

", - "locationName":"createTime" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Indicates whether the volume will be encrypted.

", - "locationName":"encrypted" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the volume.

", - "locationName":"kmsKeyId" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The size of the volume, in GiBs.

", - "locationName":"size" - }, - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot from which the volume was created, if applicable.

", - "locationName":"snapshotId" - }, - "State":{ - "shape":"VolumeState", - "documentation":"

The volume state.

", - "locationName":"status" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS SSD volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose SSD volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information about General Purpose SSD baseline performance, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Constraint: Range is 100-32000 IOPS for io1 volumes and 100-10000 IOPS for gp2 volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", - "locationName":"iops" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the volume.

", - "locationName":"tagSet" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. This can be gp2 for General Purpose SSD, io1 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

", - "locationName":"volumeType" - } - }, - "documentation":"

Describes a volume.

" - }, - "VolumeAttachment":{ - "type":"structure", - "members":{ - "AttachTime":{ - "shape":"DateTime", - "documentation":"

The time stamp when the attachment initiated.

", - "locationName":"attachTime" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

", - "locationName":"device" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance.

", - "locationName":"instanceId" - }, - "State":{ - "shape":"VolumeAttachmentState", - "documentation":"

The attachment state of the volume.

", - "locationName":"status" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Indicates whether the EBS volume is deleted on instance termination.

", - "locationName":"deleteOnTermination" - } - }, - "documentation":"

Describes volume attachment details.

" - }, - "VolumeAttachmentList":{ - "type":"list", - "member":{ - "shape":"VolumeAttachment", - "locationName":"item" - } - }, - "VolumeAttachmentState":{ - "type":"string", - "enum":[ - "attaching", - "attached", - "detaching", - "detached", - "busy" - ] - }, - "VolumeAttributeName":{ - "type":"string", - "enum":[ - "autoEnableIO", - "productCodes" - ] - }, - "VolumeDetail":{ - "type":"structure", - "required":["Size"], - "members":{ - "Size":{ - "shape":"Long", - "documentation":"

The size of the volume, in GiB.

", - "locationName":"size" - } - }, - "documentation":"

Describes an EBS volume.

" - }, - "VolumeIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VolumeId" - } - }, - "VolumeList":{ - "type":"list", - "member":{ - "shape":"Volume", - "locationName":"item" - } - }, - "VolumeModification":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The ID of the volume.

", - "locationName":"volumeId" - }, - "ModificationState":{ - "shape":"VolumeModificationState", - "documentation":"

The current modification state. The modification state is null for unmodified volumes.

", - "locationName":"modificationState" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A status message about the modification progress or failure.

", - "locationName":"statusMessage" - }, - "TargetSize":{ - "shape":"Integer", - "documentation":"

The target size of the volume, in GiB.

", - "locationName":"targetSize" - }, - "TargetIops":{ - "shape":"Integer", - "documentation":"

The target IOPS rate of the volume.

", - "locationName":"targetIops" - }, - "TargetVolumeType":{ - "shape":"VolumeType", - "documentation":"

The target EBS volume type of the volume.

", - "locationName":"targetVolumeType" - }, - "OriginalSize":{ - "shape":"Integer", - "documentation":"

The original size of the volume.

", - "locationName":"originalSize" - }, - "OriginalIops":{ - "shape":"Integer", - "documentation":"

The original IOPS rate of the volume.

", - "locationName":"originalIops" - }, - "OriginalVolumeType":{ - "shape":"VolumeType", - "documentation":"

The original EBS volume type of the volume.

", - "locationName":"originalVolumeType" - }, - "Progress":{ - "shape":"Long", - "documentation":"

The modification progress, from 0 to 100 percent complete.

", - "locationName":"progress" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The modification start time.

", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The modification completion or failure time.

", - "locationName":"endTime" - } - }, - "documentation":"

Describes the modification status of an EBS volume.

If the volume has never been modified, some element values will be null.

" - }, - "VolumeModificationList":{ - "type":"list", - "member":{ - "shape":"VolumeModification", - "locationName":"item" - } - }, - "VolumeModificationState":{ - "type":"string", - "enum":[ - "modifying", - "optimizing", - "completed", - "failed" - ] - }, - "VolumeState":{ - "type":"string", - "enum":[ - "creating", - "available", - "in-use", - "deleting", - "deleted", - "error" - ] - }, - "VolumeStatusAction":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code identifying the operation, for example, enable-volume-io.

", - "locationName":"code" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the operation.

", - "locationName":"description" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of the event associated with this operation.

", - "locationName":"eventId" - }, - "EventType":{ - "shape":"String", - "documentation":"

The event type associated with this operation.

", - "locationName":"eventType" - } - }, - "documentation":"

Describes a volume status operation code.

" - }, - "VolumeStatusActionsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusAction", - "locationName":"item" - } - }, - "VolumeStatusDetails":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"VolumeStatusName", - "documentation":"

The name of the volume status.

", - "locationName":"name" - }, - "Status":{ - "shape":"String", - "documentation":"

The intended status of the volume status.

", - "locationName":"status" - } - }, - "documentation":"

Describes a volume status.

" - }, - "VolumeStatusDetailsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusDetails", - "locationName":"item" - } - }, - "VolumeStatusEvent":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"String", - "documentation":"

A description of the event.

", - "locationName":"description" - }, - "EventId":{ - "shape":"String", - "documentation":"

The ID of this event.

", - "locationName":"eventId" - }, - "EventType":{ - "shape":"String", - "documentation":"

The type of this event.

", - "locationName":"eventType" - }, - "NotAfter":{ - "shape":"DateTime", - "documentation":"

The latest end time of the event.

", - "locationName":"notAfter" - }, - "NotBefore":{ - "shape":"DateTime", - "documentation":"

The earliest start time of the event.

", - "locationName":"notBefore" - } - }, - "documentation":"

Describes a volume status event.

" - }, - "VolumeStatusEventsList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusEvent", - "locationName":"item" - } - }, - "VolumeStatusInfo":{ - "type":"structure", - "members":{ - "Details":{ - "shape":"VolumeStatusDetailsList", - "documentation":"

The details of the volume status.

", - "locationName":"details" - }, - "Status":{ - "shape":"VolumeStatusInfoStatus", - "documentation":"

The status of the volume.

", - "locationName":"status" - } - }, - "documentation":"

Describes the status of a volume.

" - }, - "VolumeStatusInfoStatus":{ - "type":"string", - "enum":[ - "ok", - "impaired", - "insufficient-data" - ] - }, - "VolumeStatusItem":{ - "type":"structure", - "members":{ - "Actions":{ - "shape":"VolumeStatusActionsList", - "documentation":"

The details of the operation.

", - "locationName":"actionsSet" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone of the volume.

", - "locationName":"availabilityZone" - }, - "Events":{ - "shape":"VolumeStatusEventsList", - "documentation":"

A list of events associated with the volume.

", - "locationName":"eventsSet" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

", - "locationName":"volumeId" - }, - "VolumeStatus":{ - "shape":"VolumeStatusInfo", - "documentation":"

The volume status.

", - "locationName":"volumeStatus" - } - }, - "documentation":"

Describes the volume status.

" - }, - "VolumeStatusList":{ - "type":"list", - "member":{ - "shape":"VolumeStatusItem", - "locationName":"item" - } - }, - "VolumeStatusName":{ - "type":"string", - "enum":[ - "io-enabled", - "io-performance" - ] - }, - "VolumeType":{ - "type":"string", - "enum":[ - "standard", - "io1", - "gp2", - "sc1", - "st1" - ] - }, - "Vpc":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The primary IPv4 CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "DhcpOptionsId":{ - "shape":"String", - "documentation":"

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", - "locationName":"dhcpOptionsId" - }, - "State":{ - "shape":"VpcState", - "documentation":"

The current state of the VPC.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "InstanceTenancy":{ - "shape":"Tenancy", - "documentation":"

The allowed tenancy of instances launched into the VPC.

", - "locationName":"instanceTenancy" - }, - "Ipv6CidrBlockAssociationSet":{ - "shape":"VpcIpv6CidrBlockAssociationSet", - "documentation":"

Information about the IPv6 CIDR blocks associated with the VPC.

", - "locationName":"ipv6CidrBlockAssociationSet" - }, - "CidrBlockAssociationSet":{ - "shape":"VpcCidrBlockAssociationSet", - "documentation":"

Information about the IPv4 CIDR blocks associated with the VPC.

", - "locationName":"cidrBlockAssociationSet" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is the default VPC.

", - "locationName":"isDefault" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a VPC.

" - }, - "VpcAttachment":{ - "type":"structure", - "members":{ - "State":{ - "shape":"AttachmentStatus", - "documentation":"

The current state of the attachment.

", - "locationName":"state" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes an attachment between a virtual private gateway and a VPC.

" - }, - "VpcAttachmentList":{ - "type":"list", - "member":{ - "shape":"VpcAttachment", - "locationName":"item" - } - }, - "VpcAttributeName":{ - "type":"string", - "enum":[ - "enableDnsSupport", - "enableDnsHostnames" - ] - }, - "VpcCidrBlockAssociation":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID for the IPv4 CIDR block.

", - "locationName":"associationId" - }, - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR block.

", - "locationName":"cidrBlock" - }, - "CidrBlockState":{ - "shape":"VpcCidrBlockState", - "documentation":"

Information about the state of the CIDR block.

", - "locationName":"cidrBlockState" - } - }, - "documentation":"

Describes an IPv4 CIDR block associated with a VPC.

" - }, - "VpcCidrBlockAssociationSet":{ - "type":"list", - "member":{ - "shape":"VpcCidrBlockAssociation", - "locationName":"item" - } - }, - "VpcCidrBlockState":{ - "type":"structure", - "members":{ - "State":{ - "shape":"VpcCidrBlockStateCode", - "documentation":"

The state of the CIDR block.

", - "locationName":"state" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

A message about the status of the CIDR block, if applicable.

", - "locationName":"statusMessage" - } - }, - "documentation":"

Describes the state of a CIDR block.

" - }, - "VpcCidrBlockStateCode":{ - "type":"string", - "enum":[ - "associating", - "associated", - "disassociating", - "disassociated", - "failing", - "failed" - ] - }, - "VpcClassicLink":{ - "type":"structure", - "members":{ - "ClassicLinkEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPC is enabled for ClassicLink.

", - "locationName":"classicLinkEnabled" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPC.

", - "locationName":"tagSet" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - } - }, - "documentation":"

Describes whether a VPC is enabled for ClassicLink.

" - }, - "VpcClassicLinkIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcClassicLinkList":{ - "type":"list", - "member":{ - "shape":"VpcClassicLink", - "locationName":"item" - } - }, - "VpcEndpoint":{ - "type":"structure", - "members":{ - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcEndpointType":{ - "shape":"VpcEndpointType", - "documentation":"

The type of endpoint.

", - "locationName":"vpcEndpointType" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC to which the endpoint is associated.

", - "locationName":"vpcId" - }, - "ServiceName":{ - "shape":"String", - "documentation":"

The name of the service to which the endpoint is associated.

", - "locationName":"serviceName" - }, - "State":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"state" - }, - "PolicyDocument":{ - "shape":"String", - "documentation":"

The policy document associated with the endpoint, if applicable.

", - "locationName":"policyDocument" - }, - "RouteTableIds":{ - "shape":"ValueStringList", - "documentation":"

(Gateway endpoint) One or more route tables associated with the endpoint.

", - "locationName":"routeTableIdSet" - }, - "SubnetIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more subnets in which the endpoint is located.

", - "locationName":"subnetIdSet" - }, - "Groups":{ - "shape":"GroupIdentifierSet", - "documentation":"

(Interface endpoint) Information about the security groups associated with the network interface.

", - "locationName":"groupSet" - }, - "PrivateDnsEnabled":{ - "shape":"Boolean", - "documentation":"

(Interface endpoint) Indicates whether the VPC is associated with a private hosted zone.

", - "locationName":"privateDnsEnabled" - }, - "NetworkInterfaceIds":{ - "shape":"ValueStringList", - "documentation":"

(Interface endpoint) One or more network interfaces for the endpoint.

", - "locationName":"networkInterfaceIdSet" - }, - "DnsEntries":{ - "shape":"DnsEntrySet", - "documentation":"

(Interface endpoint) The DNS entries for the endpoint.

", - "locationName":"dnsEntrySet" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint.

" - }, - "VpcEndpointConnection":{ - "type":"structure", - "members":{ - "ServiceId":{ - "shape":"String", - "documentation":"

The ID of the service to which the endpoint is connected.

", - "locationName":"serviceId" - }, - "VpcEndpointId":{ - "shape":"String", - "documentation":"

The ID of the VPC endpoint.

", - "locationName":"vpcEndpointId" - }, - "VpcEndpointOwner":{ - "shape":"String", - "documentation":"

The AWS account ID of the owner of the VPC endpoint.

", - "locationName":"vpcEndpointOwner" - }, - "VpcEndpointState":{ - "shape":"State", - "documentation":"

The state of the VPC endpoint.

", - "locationName":"vpcEndpointState" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

The date and time the VPC endpoint was created.

", - "locationName":"creationTimestamp" - } - }, - "documentation":"

Describes a VPC endpoint connection to a service.

" - }, - "VpcEndpointConnectionSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpointConnection", - "locationName":"item" - } - }, - "VpcEndpointSet":{ - "type":"list", - "member":{ - "shape":"VpcEndpoint", - "locationName":"item" - } - }, - "VpcEndpointType":{ - "type":"string", - "enum":[ - "Interface", - "Gateway" - ] - }, - "VpcIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcId" - } - }, - "VpcIpv6CidrBlockAssociation":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"String", - "documentation":"

The association ID for the IPv6 CIDR block.

", - "locationName":"associationId" - }, - "Ipv6CidrBlock":{ - "shape":"String", - "documentation":"

The IPv6 CIDR block.

", - "locationName":"ipv6CidrBlock" - }, - "Ipv6CidrBlockState":{ - "shape":"VpcCidrBlockState", - "documentation":"

Information about the state of the CIDR block.

", - "locationName":"ipv6CidrBlockState" - } - }, - "documentation":"

Describes an IPv6 CIDR block associated with a VPC.

" - }, - "VpcIpv6CidrBlockAssociationSet":{ - "type":"list", - "member":{ - "shape":"VpcIpv6CidrBlockAssociation", - "locationName":"item" - } - }, - "VpcList":{ - "type":"list", - "member":{ - "shape":"Vpc", - "locationName":"item" - } - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "AccepterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the accepter VPC. CIDR block information is only returned when describing an active VPC peering connection.

", - "locationName":"accepterVpcInfo" - }, - "ExpirationTime":{ - "shape":"DateTime", - "documentation":"

The time that an unaccepted VPC peering connection will expire.

", - "locationName":"expirationTime" - }, - "RequesterVpcInfo":{ - "shape":"VpcPeeringConnectionVpcInfo", - "documentation":"

Information about the requester VPC. CIDR block information is only returned when describing an active VPC peering connection.

", - "locationName":"requesterVpcInfo" - }, - "Status":{ - "shape":"VpcPeeringConnectionStateReason", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"status" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the resource.

", - "locationName":"tagSet" - }, - "VpcPeeringConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPC peering connection.

", - "locationName":"vpcPeeringConnectionId" - } - }, - "documentation":"

Describes a VPC peering connection.

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{ - "shape":"VpcPeeringConnection", - "locationName":"item" - } - }, - "VpcPeeringConnectionOptionsDescription":{ - "type":"structure", - "members":{ - "AllowDnsResolutionFromRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can resolve public DNS hostnames to private IP addresses when queried from instances in a peer VPC.

", - "locationName":"allowDnsResolutionFromRemoteVpc" - }, - "AllowEgressFromLocalClassicLinkToRemoteVpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local ClassicLink connection can communicate with the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalClassicLinkToRemoteVpc" - }, - "AllowEgressFromLocalVpcToRemoteClassicLink":{ - "shape":"Boolean", - "documentation":"

Indicates whether a local VPC can communicate with a ClassicLink connection in the peer VPC over the VPC peering connection.

", - "locationName":"allowEgressFromLocalVpcToRemoteClassicLink" - } - }, - "documentation":"

Describes the VPC peering connection options.

" - }, - "VpcPeeringConnectionStateReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"VpcPeeringConnectionStateReasonCode", - "documentation":"

The status of the VPC peering connection.

", - "locationName":"code" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that provides more information about the status, if applicable.

", - "locationName":"message" - } - }, - "documentation":"

Describes the status of a VPC peering connection.

" - }, - "VpcPeeringConnectionStateReasonCode":{ - "type":"string", - "enum":[ - "initiating-request", - "pending-acceptance", - "active", - "deleted", - "rejected", - "failed", - "expired", - "provisioning", - "deleting" - ] - }, - "VpcPeeringConnectionVpcInfo":{ - "type":"structure", - "members":{ - "CidrBlock":{ - "shape":"String", - "documentation":"

The IPv4 CIDR block for the VPC.

", - "locationName":"cidrBlock" - }, - "Ipv6CidrBlockSet":{ - "shape":"Ipv6CidrBlockSet", - "documentation":"

The IPv6 CIDR block for the VPC.

", - "locationName":"ipv6CidrBlockSet" - }, - "CidrBlockSet":{ - "shape":"CidrBlockSet", - "documentation":"

Information about the IPv4 CIDR blocks for the VPC.

", - "locationName":"cidrBlockSet" - }, - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the VPC owner.

", - "locationName":"ownerId" - }, - "PeeringOptions":{ - "shape":"VpcPeeringConnectionOptionsDescription", - "documentation":"

Information about the VPC peering connection options for the accepter or requester VPC.

", - "locationName":"peeringOptions" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC.

", - "locationName":"vpcId" - }, - "Region":{ - "shape":"String", - "documentation":"

The region in which the VPC is located.

", - "locationName":"region" - } - }, - "documentation":"

Describes a VPC in a VPC peering connection.

" - }, - "VpcState":{ - "type":"string", - "enum":[ - "pending", - "available" - ] - }, - "VpcTenancy":{ - "type":"string", - "enum":["default"] - }, - "VpnConnection":{ - "type":"structure", - "members":{ - "CustomerGatewayConfiguration":{ - "shape":"String", - "documentation":"

The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending or available state.

", - "locationName":"customerGatewayConfiguration" - }, - "CustomerGatewayId":{ - "shape":"String", - "documentation":"

The ID of the customer gateway at your end of the VPN connection.

", - "locationName":"customerGatewayId" - }, - "Category":{ - "shape":"String", - "documentation":"

The category of the VPN connection. A value of VPN indicates an AWS VPN connection. A value of VPN-Classic indicates an AWS Classic VPN connection. For more information, see AWS Managed VPN Categories in the Amazon Virtual Private Cloud User Guide.

", - "locationName":"category" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the VPN connection.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection.

", - "locationName":"type" - }, - "VpnConnectionId":{ - "shape":"String", - "documentation":"

The ID of the VPN connection.

", - "locationName":"vpnConnectionId" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway at the AWS side of the VPN connection.

", - "locationName":"vpnGatewayId" - }, - "Options":{ - "shape":"VpnConnectionOptions", - "documentation":"

The VPN connection options.

", - "locationName":"options" - }, - "Routes":{ - "shape":"VpnStaticRouteList", - "documentation":"

The static routes associated with the VPN connection.

", - "locationName":"routes" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the VPN connection.

", - "locationName":"tagSet" - }, - "VgwTelemetry":{ - "shape":"VgwTelemetryList", - "documentation":"

Information about the VPN tunnel.

", - "locationName":"vgwTelemetry" - } - }, - "documentation":"

Describes a VPN connection.

" - }, - "VpnConnectionIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnConnectionId" - } - }, - "VpnConnectionList":{ - "type":"list", - "member":{ - "shape":"VpnConnection", - "locationName":"item" - } - }, - "VpnConnectionOptions":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicates whether the VPN connection uses static routes only. Static routes must be used for devices that don't support BGP.

", - "locationName":"staticRoutesOnly" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnConnectionOptionsSpecification":{ - "type":"structure", - "members":{ - "StaticRoutesOnly":{ - "shape":"Boolean", - "documentation":"

Indicate whether the VPN connection uses static routes only. If you are creating a VPN connection for a device that does not support BGP, you must specify true. Use CreateVpnConnectionRoute to create a static route.

Default: false

", - "locationName":"staticRoutesOnly" - }, - "TunnelOptions":{ - "shape":"TunnelOptionsList", - "documentation":"

The tunnel options for the VPN connection.

" - } - }, - "documentation":"

Describes VPN connection options.

" - }, - "VpnGateway":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the virtual private gateway was created, if applicable. This field may be empty or not returned.

", - "locationName":"availabilityZone" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the virtual private gateway.

", - "locationName":"state" - }, - "Type":{ - "shape":"GatewayType", - "documentation":"

The type of VPN connection the virtual private gateway supports.

", - "locationName":"type" - }, - "VpcAttachments":{ - "shape":"VpcAttachmentList", - "documentation":"

Any VPCs attached to the virtual private gateway.

", - "locationName":"attachments" - }, - "VpnGatewayId":{ - "shape":"String", - "documentation":"

The ID of the virtual private gateway.

", - "locationName":"vpnGatewayId" - }, - "AmazonSideAsn":{ - "shape":"Long", - "documentation":"

The private Autonomous System Number (ASN) for the Amazon side of a BGP session.

", - "locationName":"amazonSideAsn" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Any tags assigned to the virtual private gateway.

", - "locationName":"tagSet" - } - }, - "documentation":"

Describes a virtual private gateway.

" - }, - "VpnGatewayIdStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpnGatewayId" - } - }, - "VpnGatewayList":{ - "type":"list", - "member":{ - "shape":"VpnGateway", - "locationName":"item" - } - }, - "VpnState":{ - "type":"string", - "enum":[ - "pending", - "available", - "deleting", - "deleted" - ] - }, - "VpnStaticRoute":{ - "type":"structure", - "members":{ - "DestinationCidrBlock":{ - "shape":"String", - "documentation":"

The CIDR block associated with the local subnet of the customer data center.

", - "locationName":"destinationCidrBlock" - }, - "Source":{ - "shape":"VpnStaticRouteSource", - "documentation":"

Indicates how the routes were provided.

", - "locationName":"source" - }, - "State":{ - "shape":"VpnState", - "documentation":"

The current state of the static route.

", - "locationName":"state" - } - }, - "documentation":"

Describes a static route for a VPN connection.

" - }, - "VpnStaticRouteList":{ - "type":"list", - "member":{ - "shape":"VpnStaticRoute", - "locationName":"item" - } - }, - "VpnStaticRouteSource":{ - "type":"string", - "enum":["Static"] - }, - "VpnTunnelOptionsSpecification":{ - "type":"structure", - "members":{ - "TunnelInsideCidr":{ - "shape":"String", - "documentation":"

The range of inside IP addresses for the tunnel. Any specified CIDR blocks must be unique across all VPN connections that use the same virtual private gateway.

Constraints: A size /30 CIDR block from the 169.254.0.0/16 range. The following CIDR blocks are reserved and cannot be used:

  • 169.254.0.0/30

  • 169.254.1.0/30

  • 169.254.2.0/30

  • 169.254.3.0/30

  • 169.254.4.0/30

  • 169.254.5.0/30

  • 169.254.169.252/30

" - }, - "PreSharedKey":{ - "shape":"String", - "documentation":"

The pre-shared key (PSK) to establish initial authentication between the virtual private gateway and customer gateway.

Constraints: Allowed characters are alphanumeric characters and ._. Must be between 8 and 64 characters in length and cannot start with zero (0).

" - } - }, - "documentation":"

The tunnel options for a VPN connection.

" - }, - "ZoneNameStringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ZoneName" - } - }, - "scope":{ - "type":"string", - "enum":[ - "Availability Zone", - "Region" - ] - } - }, - "documentation":"Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides secure and resizable computing capacity in the AWS cloud. Using Amazon EC2 eliminates the need to invest in hardware up front, so you can develop and deploy applications faster.

To learn more about Amazon EC2, Amazon EBS, and Amazon VPC, see the following resources:

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/waiters-2.json deleted file mode 100644 index 33ea7b04..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ec2/2016-11-15/waiters-2.json +++ /dev/null @@ -1,622 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceExists": { - "delay": 5, - "maxAttempts": 40, - "operation": "DescribeInstances", - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Reservations[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "BundleTaskComplete": { - "delay": 15, - "operation": "DescribeBundleTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "complete", - "matcher": "pathAll", - "state": "success", - "argument": "BundleTasks[].State" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "BundleTasks[].State" - } - ] - }, - "ConversionTaskCancelled": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskCompleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelled", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - }, - { - "expected": "cancelling", - "matcher": "pathAny", - "state": "failure", - "argument": "ConversionTasks[].State" - } - ] - }, - "ConversionTaskDeleted": { - "delay": 15, - "operation": "DescribeConversionTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "ConversionTasks[].State" - } - ] - }, - "CustomerGatewayAvailable": { - "delay": 15, - "operation": "DescribeCustomerGateways", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CustomerGateways[].State" - } - ] - }, - "ExportTaskCancelled": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "cancelled", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ExportTaskCompleted": { - "delay": 15, - "operation": "DescribeExportTasks", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "ExportTasks[].State" - } - ] - }, - "ImageExists": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "matcher": "path", - "expected": true, - "argument": "length(Images[]) > `0`", - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidAMIID.NotFound", - "state": "retry" - } - ] - }, - "ImageAvailable": { - "operation": "DescribeImages", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Images[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Images[].State", - "expected": "failed" - } - ] - }, - "InstanceRunning": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "running", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "shutting-down", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].InstanceStatus.Status", - "expected": "ok" - }, - { - "matcher": "error", - "expected": "InvalidInstanceID.NotFound", - "state": "retry" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Reservations[].Instances[].State.Name" - } - ] - }, - "KeyPairExists": { - "operation": "DescribeKeyPairs", - "delay": 5, - "maxAttempts": 6, - "acceptors": [ - { - "expected": true, - "matcher": "path", - "state": "success", - "argument": "length(KeyPairs[].KeyName) > `0`" - }, - { - "expected": "InvalidKeyPair.NotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "NatGatewayAvailable": { - "operation": "DescribeNatGateways", - "delay": 15, - "maxAttempts": 40, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "NatGateways[].State", - "expected": "available" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "failed" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleting" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "NatGateways[].State", - "expected": "deleted" - }, - { - "state": "retry", - "matcher": "error", - "expected": "NatGatewayNotFound" - } - ] - }, - "NetworkInterfaceAvailable": { - "operation": "DescribeNetworkInterfaces", - "delay": 20, - "maxAttempts": 10, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "NetworkInterfaces[].Status" - }, - { - "expected": "InvalidNetworkInterfaceID.NotFound", - "matcher": "error", - "state": "failure" - } - ] - }, - "PasswordDataAvailable": { - "operation": "GetPasswordData", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "length(PasswordData) > `0`", - "expected": true - } - ] - }, - "SnapshotCompleted": { - "delay": 15, - "operation": "DescribeSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "completed", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].State" - } - ] - }, - "SpotInstanceRequestFulfilled": { - "operation": "DescribeSpotInstanceRequests", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "fulfilled" - }, - { - "state": "success", - "matcher": "pathAll", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "request-canceled-and-instance-running" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "schedule-expired" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "canceled-before-fulfillment" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "bad-parameters" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "SpotInstanceRequests[].Status.Code", - "expected": "system-error" - }, - { - "state": "retry", - "matcher": "error", - "expected": "InvalidSpotInstanceRequestID.NotFound" - } - ] - }, - "SubnetAvailable": { - "delay": 15, - "operation": "DescribeSubnets", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Subnets[].State" - } - ] - }, - "SystemStatusOk": { - "operation": "DescribeInstanceStatus", - "maxAttempts": 40, - "delay": 15, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "InstanceStatuses[].SystemStatus.Status", - "expected": "ok" - } - ] - }, - "VolumeAvailable": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VolumeDeleted": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "matcher": "error", - "expected": "InvalidVolume.NotFound", - "state": "success" - } - ] - }, - "VolumeInUse": { - "delay": 15, - "operation": "DescribeVolumes", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "in-use", - "matcher": "pathAll", - "state": "success", - "argument": "Volumes[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Volumes[].State" - } - ] - }, - "VpcAvailable": { - "delay": 15, - "operation": "DescribeVpcs", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Vpcs[].State" - } - ] - }, - "VpcExists": { - "operation": "DescribeVpcs", - "delay": 1, - "maxAttempts": 5, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcID.NotFound", - "state": "retry" - } - ] - }, - "VpnConnectionAvailable": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpnConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpnConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpnConnections[].State" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "VpnConnections[].State" - } - ] - }, - "VpcPeeringConnectionExists": { - "delay": 15, - "operation": "DescribeVpcPeeringConnections", - "maxAttempts": 40, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "InvalidVpcPeeringConnectionID.NotFound", - "state": "retry" - } - ] - }, - "VpcPeeringConnectionDeleted": { - "delay": 15, - "operation": "DescribeVpcPeeringConnections", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "VpcPeeringConnections[].Status.Code" - }, - { - "matcher": "error", - "expected": "InvalidVpcPeeringConnectionID.NotFound", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/examples-1.json deleted file mode 100644 index 626e4310..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/examples-1.json +++ /dev/null @@ -1,215 +0,0 @@ -{ - "version": "1.0", - "examples": { - "BatchDeleteImage": [ - { - "input": { - "imageIds": [ - { - "imageTag": "precise" - } - ], - "repositoryName": "ubuntu" - }, - "output": { - "failures": [ - - ], - "imageIds": [ - { - "imageDigest": "sha256:examplee6d1e504117a17000003d3753086354a38375961f2e665416ef4b1b2f", - "imageTag": "precise" - } - ] - }, - "comments": { - }, - "description": "This example deletes images with the tags precise and trusty in a repository called ubuntu in the default registry for an account.", - "id": "batchdeleteimages-example-1470860541707", - "title": "To delete multiple images" - } - ], - "BatchGetImage": [ - { - "input": { - "imageIds": [ - { - "imageTag": "precise" - } - ], - "repositoryName": "ubuntu" - }, - "output": { - "failures": [ - - ], - "images": [ - { - "imageId": { - "imageDigest": "sha256:example76bdff6d83a09ba2a818f0d00000063724a9ac3ba5019c56f74ebf42a", - "imageTag": "precise" - }, - "imageManifest": "{\n \"schemaVersion\": 1,\n \"name\": \"ubuntu\",\n \"tag\": \"precise\",\n...", - "registryId": "244698725403", - "repositoryName": "ubuntu" - } - ] - }, - "comments": { - "output": { - "imageManifest": "In this example, the imageManifest in the output JSON has been truncated." - } - }, - "description": "This example obtains information for an image with a specified image digest ID from the repository named ubuntu in the current account.", - "id": "batchgetimage-example-1470862771437", - "title": "To obtain multiple images in a single request" - } - ], - "CreateRepository": [ - { - "input": { - "repositoryName": "project-a/nginx-web-app" - }, - "output": { - "repository": { - "registryId": "012345678901", - "repositoryArn": "arn:aws:ecr:us-west-2:012345678901:repository/project-a/nginx-web-app", - "repositoryName": "project-a/nginx-web-app" - } - }, - "comments": { - "output": { - "imageManifest": "In this example, the imageManifest in the output JSON has been truncated." - } - }, - "description": "This example creates a repository called nginx-web-app inside the project-a namespace in the default registry for an account.", - "id": "createrepository-example-1470863688724", - "title": "To create a new repository" - } - ], - "DeleteRepository": [ - { - "input": { - "force": true, - "repositoryName": "ubuntu" - }, - "output": { - "repository": { - "registryId": "012345678901", - "repositoryArn": "arn:aws:ecr:us-west-2:012345678901:repository/ubuntu", - "repositoryName": "ubuntu" - } - }, - "comments": { - "output": { - "imageManifest": "In this example, the imageManifest in the output JSON has been truncated." - } - }, - "description": "This example force deletes a repository named ubuntu in the default registry for an account. The force parameter is required if the repository contains images.", - "id": "deleterepository-example-1470863805703", - "title": "To force delete a repository" - } - ], - "DeleteRepositoryPolicy": [ - { - "input": { - "repositoryName": "ubuntu" - }, - "output": { - "policyText": "{ ... }", - "registryId": "012345678901", - "repositoryName": "ubuntu" - }, - "comments": { - }, - "description": "This example deletes the policy associated with the repository named ubuntu in the current account.", - "id": "deleterepositorypolicy-example-1470866943748", - "title": "To delete the policy associated with a repository" - } - ], - "DescribeRepositories": [ - { - "input": { - }, - "output": { - "repositories": [ - { - "registryId": "012345678910", - "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/ubuntu", - "repositoryName": "ubuntu" - }, - { - "registryId": "012345678910", - "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/test", - "repositoryName": "test" - } - ] - }, - "comments": { - "output": { - } - }, - "description": "The following example obtains a list and description of all repositories in the default registry to which the current user has access.", - "id": "describe-repositories-1470856017467", - "title": "To describe all repositories in the current account" - } - ], - "GetAuthorizationToken": [ - { - "input": { - }, - "output": { - "authorizationData": [ - { - "authorizationToken": "QVdTOkN...", - "expiresAt": "1470951892.432", - "proxyEndpoint": "https://012345678901.dkr.ecr.us-west-2.amazonaws.com" - } - ] - }, - "comments": { - }, - "description": "This example gets an authorization token for your default registry.", - "id": "getauthorizationtoken-example-1470867047084", - "title": "To obtain an authorization token" - } - ], - "GetRepositoryPolicy": [ - { - "input": { - "repositoryName": "ubuntu" - }, - "output": { - "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"new statement\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : \"arn:aws:iam::012345678901:role/CodeDeployDemo\"\n },\n\"Action\" : [ \"ecr:GetDownloadUrlForLayer\", \"ecr:BatchGetImage\", \"ecr:BatchCheckLayerAvailability\" ]\n } ]\n}", - "registryId": "012345678901", - "repositoryName": "ubuntu" - }, - "comments": { - }, - "description": "This example obtains the repository policy for the repository named ubuntu.", - "id": "getrepositorypolicy-example-1470867669211", - "title": "To get the current policy for a repository" - } - ], - "ListImages": [ - { - "input": { - "repositoryName": "ubuntu" - }, - "output": { - "imageIds": [ - { - "imageDigest": "sha256:764f63476bdff6d83a09ba2a818f0d35757063724a9ac3ba5019c56f74ebf42a", - "imageTag": "precise" - } - ] - }, - "comments": { - }, - "description": "This example lists all of the images in the repository named ubuntu in the default registry in the current account. ", - "id": "listimages-example-1470868161594", - "title": "To list all images in a repository" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/paginators-1.json deleted file mode 100644 index dad0647f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "ListImages": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "imageIds" - }, - "DescribeImages": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "imageDetails" - }, - "DescribeRepositories": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "repositories" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/service-2.json deleted file mode 100644 index 333936b2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecr/2015-09-21/service-2.json +++ /dev/null @@ -1,1830 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-09-21", - "endpointPrefix":"ecr", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon ECR", - "serviceFullName":"Amazon EC2 Container Registry", - "serviceId":"ECR", - "signatureVersion":"v4", - "targetPrefix":"AmazonEC2ContainerRegistry_V20150921", - "uid":"ecr-2015-09-21" - }, - "operations":{ - "BatchCheckLayerAvailability":{ - "name":"BatchCheckLayerAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchCheckLayerAvailabilityRequest"}, - "output":{"shape":"BatchCheckLayerAvailabilityResponse"}, - "errors":[ - {"shape":"RepositoryNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ServerException"} - ], - "documentation":"

Check the availability of multiple image layers in a specified registry and repository.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - }, - "BatchDeleteImage":{ - "name":"BatchDeleteImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteImageRequest"}, - "output":{"shape":"BatchDeleteImageResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Deletes a list of specified images within a specified repository. Images are specified with either imageTag or imageDigest.

You can remove a tag from an image by specifying the image's tag in your request. When you remove the last tag from an image, the image is deleted from your repository.

You can completely delete an image (and all of its tags) by specifying the image's digest in your request.

" - }, - "BatchGetImage":{ - "name":"BatchGetImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetImageRequest"}, - "output":{"shape":"BatchGetImageResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Gets detailed information for specified images within a specified repository. Images are specified with either imageTag or imageDigest.

" - }, - "CompleteLayerUpload":{ - "name":"CompleteLayerUpload", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CompleteLayerUploadRequest"}, - "output":{"shape":"CompleteLayerUploadResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"UploadNotFoundException"}, - {"shape":"InvalidLayerException"}, - {"shape":"LayerPartTooSmallException"}, - {"shape":"LayerAlreadyExistsException"}, - {"shape":"EmptyUploadException"} - ], - "documentation":"

Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and upload ID. You can optionally provide a sha256 digest of the image layer for data validation purposes.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - }, - "CreateRepository":{ - "name":"CreateRepository", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRepositoryRequest"}, - "output":{"shape":"CreateRepositoryResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryAlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an image repository.

" - }, - "DeleteLifecyclePolicy":{ - "name":"DeleteLifecyclePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLifecyclePolicyRequest"}, - "output":{"shape":"DeleteLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"LifecyclePolicyNotFoundException"} - ], - "documentation":"

Deletes the specified lifecycle policy.

" - }, - "DeleteRepository":{ - "name":"DeleteRepository", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRepositoryRequest"}, - "output":{"shape":"DeleteRepositoryResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"RepositoryNotEmptyException"} - ], - "documentation":"

Deletes an existing image repository. If a repository contains images, you must use the force option to delete it.

" - }, - "DeleteRepositoryPolicy":{ - "name":"DeleteRepositoryPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRepositoryPolicyRequest"}, - "output":{"shape":"DeleteRepositoryPolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"RepositoryPolicyNotFoundException"} - ], - "documentation":"

Deletes the repository policy from a specified repository.

" - }, - "DescribeImages":{ - "name":"DescribeImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeImagesRequest"}, - "output":{"shape":"DescribeImagesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"ImageNotFoundException"} - ], - "documentation":"

Returns metadata about the images in a repository, including image size, image tags, and creation date.

Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker registry. The output of the docker images command shows the uncompressed image size, so it may return a larger image size than the image sizes returned by DescribeImages.

" - }, - "DescribeRepositories":{ - "name":"DescribeRepositories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRepositoriesRequest"}, - "output":{"shape":"DescribeRepositoriesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Describes image repositories in a registry.

" - }, - "GetAuthorizationToken":{ - "name":"GetAuthorizationToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAuthorizationTokenRequest"}, - "output":{"shape":"GetAuthorizationTokenResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Retrieves a token that is valid for a specified registry for 12 hours. This command allows you to use the docker CLI to push and pull images with Amazon ECR. If you do not specify a registry, the default registry is assumed.

The authorizationToken returned for each registry specified is a base64 encoded string that can be decoded and used in a docker login command to authenticate to a registry. The AWS CLI offers an aws ecr get-login command that simplifies the login process.

" - }, - "GetDownloadUrlForLayer":{ - "name":"GetDownloadUrlForLayer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDownloadUrlForLayerRequest"}, - "output":{"shape":"GetDownloadUrlForLayerResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"LayersNotFoundException"}, - {"shape":"LayerInaccessibleException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image layers that are referenced in an image.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - }, - "GetLifecyclePolicy":{ - "name":"GetLifecyclePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLifecyclePolicyRequest"}, - "output":{"shape":"GetLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"LifecyclePolicyNotFoundException"} - ], - "documentation":"

Retrieves the specified lifecycle policy.

" - }, - "GetLifecyclePolicyPreview":{ - "name":"GetLifecyclePolicyPreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLifecyclePolicyPreviewRequest"}, - "output":{"shape":"GetLifecyclePolicyPreviewResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"LifecyclePolicyPreviewNotFoundException"} - ], - "documentation":"

Retrieves the results of the specified lifecycle policy preview request.

" - }, - "GetRepositoryPolicy":{ - "name":"GetRepositoryPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRepositoryPolicyRequest"}, - "output":{"shape":"GetRepositoryPolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"RepositoryPolicyNotFoundException"} - ], - "documentation":"

Retrieves the repository policy for a specified repository.

" - }, - "InitiateLayerUpload":{ - "name":"InitiateLayerUpload", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InitiateLayerUploadRequest"}, - "output":{"shape":"InitiateLayerUploadResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Notify Amazon ECR that you intend to upload an image layer.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - }, - "ListImages":{ - "name":"ListImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListImagesRequest"}, - "output":{"shape":"ListImagesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Lists all the image IDs for a given repository.

You can filter images based on whether or not they are tagged by setting the tagStatus parameter to TAGGED or UNTAGGED. For example, you can filter your results to return only UNTAGGED images and then pipe that result to a BatchDeleteImage operation to delete them. Or, you can filter your results to return only TAGGED images to list all of the tags in your repository.

" - }, - "PutImage":{ - "name":"PutImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutImageRequest"}, - "output":{"shape":"PutImageResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"ImageAlreadyExistsException"}, - {"shape":"LayersNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates or updates the image manifest and tags associated with an image.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - }, - "PutLifecyclePolicy":{ - "name":"PutLifecyclePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutLifecyclePolicyRequest"}, - "output":{"shape":"PutLifecyclePolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Creates or updates a lifecycle policy. For information about lifecycle policy syntax, see Lifecycle Policy Template.

" - }, - "SetRepositoryPolicy":{ - "name":"SetRepositoryPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetRepositoryPolicyRequest"}, - "output":{"shape":"SetRepositoryPolicyResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"} - ], - "documentation":"

Applies a repository policy on a specified repository to control access permissions.

" - }, - "StartLifecyclePolicyPreview":{ - "name":"StartLifecyclePolicyPreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartLifecyclePolicyPreviewRequest"}, - "output":{"shape":"StartLifecyclePolicyPreviewResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"LifecyclePolicyNotFoundException"}, - {"shape":"LifecyclePolicyPreviewInProgressException"} - ], - "documentation":"

Starts a preview of the specified lifecycle policy. This allows you to see the results before creating the lifecycle policy.

" - }, - "UploadLayerPart":{ - "name":"UploadLayerPart", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UploadLayerPartRequest"}, - "output":{"shape":"UploadLayerPartResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidLayerPartException"}, - {"shape":"RepositoryNotFoundException"}, - {"shape":"UploadNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Uploads an image layer part to Amazon ECR.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

" - } - }, - "shapes":{ - "Arn":{"type":"string"}, - "AuthorizationData":{ - "type":"structure", - "members":{ - "authorizationToken":{ - "shape":"Base64", - "documentation":"

A base64-encoded string that contains authorization data for the specified Amazon ECR registry. When the string is decoded, it is presented in the format user:password for private registry authentication using docker login.

" - }, - "expiresAt":{ - "shape":"ExpirationTimestamp", - "documentation":"

The Unix time in seconds and milliseconds when the authorization token expires. Authorization tokens are valid for 12 hours.

" - }, - "proxyEndpoint":{ - "shape":"ProxyEndpoint", - "documentation":"

The registry URL to use for this authorization token in a docker login command. The Amazon ECR registry URL format is https://aws_account_id.dkr.ecr.region.amazonaws.com. For example, https://012345678910.dkr.ecr.us-east-1.amazonaws.com..

" - } - }, - "documentation":"

An object representing authorization data for an Amazon ECR registry.

" - }, - "AuthorizationDataList":{ - "type":"list", - "member":{"shape":"AuthorizationData"} - }, - "Base64":{ - "type":"string", - "pattern":"^\\S+$" - }, - "BatchCheckLayerAvailabilityRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "layerDigests" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the image layers to check. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that is associated with the image layers to check.

" - }, - "layerDigests":{ - "shape":"BatchedOperationLayerDigestList", - "documentation":"

The digests of the image layers to check.

" - } - } - }, - "BatchCheckLayerAvailabilityResponse":{ - "type":"structure", - "members":{ - "layers":{ - "shape":"LayerList", - "documentation":"

A list of image layer objects corresponding to the image layer references in the request.

" - }, - "failures":{ - "shape":"LayerFailureList", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "BatchDeleteImageRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "imageIds" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the image to delete. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository that contains the image to delete.

" - }, - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

A list of image ID references that correspond to images to delete. The format of the imageIds reference is imageTag=tag or imageDigest=digest.

" - } - }, - "documentation":"

Deletes specified images within a specified repository. Images are specified with either the imageTag or imageDigest.

" - }, - "BatchDeleteImageResponse":{ - "type":"structure", - "members":{ - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

The image IDs of the deleted images.

" - }, - "failures":{ - "shape":"ImageFailureList", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "BatchGetImageRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "imageIds" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the images to describe. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository that contains the images to describe.

" - }, - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

A list of image ID references that correspond to images to describe. The format of the imageIds reference is imageTag=tag or imageDigest=digest.

" - }, - "acceptedMediaTypes":{ - "shape":"MediaTypeList", - "documentation":"

The accepted media types for the request.

Valid values: application/vnd.docker.distribution.manifest.v1+json | application/vnd.docker.distribution.manifest.v2+json | application/vnd.oci.image.manifest.v1+json

" - } - } - }, - "BatchGetImageResponse":{ - "type":"structure", - "members":{ - "images":{ - "shape":"ImageList", - "documentation":"

A list of image objects corresponding to the image references in the request.

" - }, - "failures":{ - "shape":"ImageFailureList", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "BatchedOperationLayerDigest":{ - "type":"string", - "max":1000, - "min":0 - }, - "BatchedOperationLayerDigestList":{ - "type":"list", - "member":{"shape":"BatchedOperationLayerDigest"}, - "max":100, - "min":1 - }, - "CompleteLayerUploadRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "uploadId", - "layerDigests" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry to which to upload layers. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to associate with the image layer.

" - }, - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID from a previous InitiateLayerUpload operation to associate with the image layer.

" - }, - "layerDigests":{ - "shape":"LayerDigestList", - "documentation":"

The sha256 digest of the image layer.

" - } - } - }, - "CompleteLayerUploadResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID associated with the layer.

" - }, - "layerDigest":{ - "shape":"LayerDigest", - "documentation":"

The sha256 digest of the image layer.

" - } - } - }, - "CreateRepositoryRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name to use for the repository. The repository name may be specified on its own (such as nginx-web-app) or it can be prepended with a namespace to group the repository into a category (such as project-a/nginx-web-app).

" - } - } - }, - "CreateRepositoryResponse":{ - "type":"structure", - "members":{ - "repository":{ - "shape":"Repository", - "documentation":"

The repository that was created.

" - } - } - }, - "CreationTimestamp":{"type":"timestamp"}, - "DeleteLifecyclePolicyRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository.

" - } - } - }, - "DeleteLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON lifecycle policy text.

" - }, - "lastEvaluatedAt":{ - "shape":"EvaluationTimestamp", - "documentation":"

The time stamp of the last time that the lifecycle policy was run.

" - } - } - }, - "DeleteRepositoryPolicyRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository policy to delete. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that is associated with the repository policy to delete.

" - } - } - }, - "DeleteRepositoryPolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "policyText":{ - "shape":"RepositoryPolicyText", - "documentation":"

The JSON repository policy that was deleted from the repository.

" - } - } - }, - "DeleteRepositoryRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository to delete. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to delete.

" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

If a repository contains images, forces the deletion.

" - } - } - }, - "DeleteRepositoryResponse":{ - "type":"structure", - "members":{ - "repository":{ - "shape":"Repository", - "documentation":"

The repository that was deleted.

" - } - } - }, - "DescribeImagesFilter":{ - "type":"structure", - "members":{ - "tagStatus":{ - "shape":"TagStatus", - "documentation":"

The tag status with which to filter your DescribeImages results. You can filter results based on whether they are TAGGED or UNTAGGED.

" - } - }, - "documentation":"

An object representing a filter on a DescribeImages operation.

" - }, - "DescribeImagesRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository in which to describe images. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

A list of repositories to describe. If this parameter is omitted, then all repositories in a registry are described.

" - }, - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

The list of image IDs for the requested repository.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value returned from a previous paginated DescribeImages request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return. This option cannot be used when you specify images with imageIds.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of repository results returned by DescribeImages in paginated output. When this parameter is used, DescribeImages only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeImages request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeImages returns up to 100 results and a nextToken value, if applicable. This option cannot be used when you specify images with imageIds.

" - }, - "filter":{ - "shape":"DescribeImagesFilter", - "documentation":"

The filter key and value with which to filter your DescribeImages results.

" - } - } - }, - "DescribeImagesResponse":{ - "type":"structure", - "members":{ - "imageDetails":{ - "shape":"ImageDetailList", - "documentation":"

A list of ImageDetail objects that contain data about the image.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value to include in a future DescribeImages request. When the results of a DescribeImages request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "DescribeRepositoriesRequest":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repositories to be described. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryNames":{ - "shape":"RepositoryNameList", - "documentation":"

A list of repositories to describe. If this parameter is omitted, then all repositories in a registry are described.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value returned from a previous paginated DescribeRepositories request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return. This option cannot be used when you specify repositories with repositoryNames.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of repository results returned by DescribeRepositories in paginated output. When this parameter is used, DescribeRepositories only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeRepositories request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then DescribeRepositories returns up to 100 results and a nextToken value, if applicable. This option cannot be used when you specify repositories with repositoryNames.

" - } - } - }, - "DescribeRepositoriesResponse":{ - "type":"structure", - "members":{ - "repositories":{ - "shape":"RepositoryList", - "documentation":"

A list of repository objects corresponding to valid repositories.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value to include in a future DescribeRepositories request. When the results of a DescribeRepositories request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "EmptyUploadException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified layer upload does not contain any layer parts.

", - "exception":true - }, - "EvaluationTimestamp":{"type":"timestamp"}, - "ExceptionMessage":{"type":"string"}, - "ExpirationTimestamp":{"type":"timestamp"}, - "ForceFlag":{"type":"boolean"}, - "GetAuthorizationTokenRegistryIdList":{ - "type":"list", - "member":{"shape":"RegistryId"}, - "max":10, - "min":1 - }, - "GetAuthorizationTokenRequest":{ - "type":"structure", - "members":{ - "registryIds":{ - "shape":"GetAuthorizationTokenRegistryIdList", - "documentation":"

A list of AWS account IDs that are associated with the registries for which to get authorization tokens. If you do not specify a registry, the default registry is assumed.

" - } - } - }, - "GetAuthorizationTokenResponse":{ - "type":"structure", - "members":{ - "authorizationData":{ - "shape":"AuthorizationDataList", - "documentation":"

A list of authorization token data objects that correspond to the registryIds values in the request.

" - } - } - }, - "GetDownloadUrlForLayerRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "layerDigest" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the image layer to download. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository that is associated with the image layer to download.

" - }, - "layerDigest":{ - "shape":"LayerDigest", - "documentation":"

The digest of the image layer to download.

" - } - } - }, - "GetDownloadUrlForLayerResponse":{ - "type":"structure", - "members":{ - "downloadUrl":{ - "shape":"Url", - "documentation":"

The pre-signed Amazon S3 download URL for the requested layer.

" - }, - "layerDigest":{ - "shape":"LayerDigest", - "documentation":"

The digest of the image layer to download.

" - } - } - }, - "GetLifecyclePolicyPreviewRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository.

" - }, - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

The list of imageIDs to be included.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value returned from a previous paginated
 GetLifecyclePolicyPreviewRequest request where maxResults was used and the
 results exceeded the value of that parameter. Pagination continues from the end of the
 previous results that returned the nextToken value. This value is
 null when there are no more results to return. This option cannot be used when you specify images with imageIds.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of repository results returned by GetLifecyclePolicyPreviewRequest in
 paginated output. When this parameter is used, GetLifecyclePolicyPreviewRequest only returns
 maxResults results in a single page along with a nextToken
 response element. The remaining results of the initial request can be seen by sending
 another GetLifecyclePolicyPreviewRequest request with the returned nextToken
 value. This value can be between 1 and 100. If this
 parameter is not used, then GetLifecyclePolicyPreviewRequest returns up to
 100 results and a nextToken value, if
 applicable. This option cannot be used when you specify images with imageIds.

" - }, - "filter":{ - "shape":"LifecyclePolicyPreviewFilter", - "documentation":"

An optional parameter that filters results based on image tag status and all tags, if tagged.

" - } - } - }, - "GetLifecyclePolicyPreviewResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON lifecycle policy text.

" - }, - "status":{ - "shape":"LifecyclePolicyPreviewStatus", - "documentation":"

The status of the lifecycle policy preview request.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value to include in a future GetLifecyclePolicyPreview request. When the results of a GetLifecyclePolicyPreview request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - }, - "previewResults":{ - "shape":"LifecyclePolicyPreviewResultList", - "documentation":"

The results of the lifecycle policy preview request.

" - }, - "summary":{ - "shape":"LifecyclePolicyPreviewSummary", - "documentation":"

The list of images that is returned as a result of the action.

" - } - } - }, - "GetLifecyclePolicyRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository.

" - } - } - }, - "GetLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON lifecycle policy text.

" - }, - "lastEvaluatedAt":{ - "shape":"EvaluationTimestamp", - "documentation":"

The time stamp of the last time that the lifecycle policy was run.

" - } - } - }, - "GetRepositoryPolicyRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository with the policy to retrieve.

" - } - } - }, - "GetRepositoryPolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "policyText":{ - "shape":"RepositoryPolicyText", - "documentation":"

The JSON repository policy text associated with the repository.

" - } - } - }, - "Image":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry containing the image.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository associated with the image.

" - }, - "imageId":{ - "shape":"ImageIdentifier", - "documentation":"

An object containing the image tag and image digest associated with an image.

" - }, - "imageManifest":{ - "shape":"ImageManifest", - "documentation":"

The image manifest associated with the image.

" - } - }, - "documentation":"

An object representing an Amazon ECR image.

" - }, - "ImageActionType":{ - "type":"string", - "enum":["EXPIRE"] - }, - "ImageAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified image has already been pushed, and there were no changes to the manifest or image tag after the last push.

", - "exception":true - }, - "ImageCount":{ - "type":"integer", - "min":0 - }, - "ImageDetail":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry to which this image belongs.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to which this image belongs.

" - }, - "imageDigest":{ - "shape":"ImageDigest", - "documentation":"

The sha256 digest of the image manifest.

" - }, - "imageTags":{ - "shape":"ImageTagList", - "documentation":"

The list of tags associated with this image.

" - }, - "imageSizeInBytes":{ - "shape":"ImageSizeInBytes", - "documentation":"

The size, in bytes, of the image in the repository.

Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker registry. The output of the docker images command shows the uncompressed image size, so it may return a larger image size than the image sizes returned by DescribeImages.

" - }, - "imagePushedAt":{ - "shape":"PushTimestamp", - "documentation":"

The date and time, expressed in standard JavaScript date format, at which the current image was pushed to the repository.

" - } - }, - "documentation":"

An object that describes an image returned by a DescribeImages operation.

" - }, - "ImageDetailList":{ - "type":"list", - "member":{"shape":"ImageDetail"} - }, - "ImageDigest":{"type":"string"}, - "ImageFailure":{ - "type":"structure", - "members":{ - "imageId":{ - "shape":"ImageIdentifier", - "documentation":"

The image ID associated with the failure.

" - }, - "failureCode":{ - "shape":"ImageFailureCode", - "documentation":"

The code associated with the failure.

" - }, - "failureReason":{ - "shape":"ImageFailureReason", - "documentation":"

The reason for the failure.

" - } - }, - "documentation":"

An object representing an Amazon ECR image failure.

" - }, - "ImageFailureCode":{ - "type":"string", - "enum":[ - "InvalidImageDigest", - "InvalidImageTag", - "ImageTagDoesNotMatchDigest", - "ImageNotFound", - "MissingDigestAndTag" - ] - }, - "ImageFailureList":{ - "type":"list", - "member":{"shape":"ImageFailure"} - }, - "ImageFailureReason":{"type":"string"}, - "ImageIdentifier":{ - "type":"structure", - "members":{ - "imageDigest":{ - "shape":"ImageDigest", - "documentation":"

The sha256 digest of the image manifest.

" - }, - "imageTag":{ - "shape":"ImageTag", - "documentation":"

The tag used for the image.

" - } - }, - "documentation":"

An object with identifying information for an Amazon ECR image.

" - }, - "ImageIdentifierList":{ - "type":"list", - "member":{"shape":"ImageIdentifier"}, - "max":100, - "min":1 - }, - "ImageList":{ - "type":"list", - "member":{"shape":"Image"} - }, - "ImageManifest":{"type":"string"}, - "ImageNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The image requested does not exist in the specified repository.

", - "exception":true - }, - "ImageSizeInBytes":{"type":"long"}, - "ImageTag":{"type":"string"}, - "ImageTagList":{ - "type":"list", - "member":{"shape":"ImageTag"} - }, - "InitiateLayerUploadRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry to which you intend to upload layers. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to which you intend to upload layers.

" - } - } - }, - "InitiateLayerUploadResponse":{ - "type":"structure", - "members":{ - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID for the layer upload. This parameter is passed to further UploadLayerPart and CompleteLayerUpload operations.

" - }, - "partSize":{ - "shape":"PartSize", - "documentation":"

The size, in bytes, that Amazon ECR expects future layer part uploads to be.

" - } - } - }, - "InvalidLayerException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The layer digest calculation performed by Amazon ECR upon receipt of the image layer does not match the digest specified.

", - "exception":true - }, - "InvalidLayerPartException":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the exception.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the exception.

" - }, - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID associated with the exception.

" - }, - "lastValidByteReceived":{ - "shape":"PartSize", - "documentation":"

The last valid byte received from the layer part upload that is associated with the exception.

" - }, - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The layer part size is not valid, or the first byte specified is not consecutive to the last byte of a previous layer part upload.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified parameter is invalid. Review the available parameters for the API request.

", - "exception":true - }, - "Layer":{ - "type":"structure", - "members":{ - "layerDigest":{ - "shape":"LayerDigest", - "documentation":"

The sha256 digest of the image layer.

" - }, - "layerAvailability":{ - "shape":"LayerAvailability", - "documentation":"

The availability status of the image layer.

" - }, - "layerSize":{ - "shape":"LayerSizeInBytes", - "documentation":"

The size, in bytes, of the image layer.

" - }, - "mediaType":{ - "shape":"MediaType", - "documentation":"

The media type of the layer, such as application/vnd.docker.image.rootfs.diff.tar.gzip or application/vnd.oci.image.layer.v1.tar+gzip.

" - } - }, - "documentation":"

An object representing an Amazon ECR image layer.

" - }, - "LayerAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The image layer already exists in the associated repository.

", - "exception":true - }, - "LayerAvailability":{ - "type":"string", - "enum":[ - "AVAILABLE", - "UNAVAILABLE" - ] - }, - "LayerDigest":{ - "type":"string", - "pattern":"[a-zA-Z0-9-_+.]+:[a-fA-F0-9]+" - }, - "LayerDigestList":{ - "type":"list", - "member":{"shape":"LayerDigest"}, - "max":100, - "min":1 - }, - "LayerFailure":{ - "type":"structure", - "members":{ - "layerDigest":{ - "shape":"BatchedOperationLayerDigest", - "documentation":"

The layer digest associated with the failure.

" - }, - "failureCode":{ - "shape":"LayerFailureCode", - "documentation":"

The failure code associated with the failure.

" - }, - "failureReason":{ - "shape":"LayerFailureReason", - "documentation":"

The reason for the failure.

" - } - }, - "documentation":"

An object representing an Amazon ECR image layer failure.

" - }, - "LayerFailureCode":{ - "type":"string", - "enum":[ - "InvalidLayerDigest", - "MissingLayerDigest" - ] - }, - "LayerFailureList":{ - "type":"list", - "member":{"shape":"LayerFailure"} - }, - "LayerFailureReason":{"type":"string"}, - "LayerInaccessibleException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified layer is not available because it is not associated with an image. Unassociated image layers may be cleaned up at any time.

", - "exception":true - }, - "LayerList":{ - "type":"list", - "member":{"shape":"Layer"} - }, - "LayerPartBlob":{"type":"blob"}, - "LayerPartTooSmallException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

Layer parts must be at least 5 MiB in size.

", - "exception":true - }, - "LayerSizeInBytes":{"type":"long"}, - "LayersNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified layers could not be found, or the specified layer is not valid for this repository.

", - "exception":true - }, - "LifecyclePolicyNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The lifecycle policy could not be found, and no policy is set to the repository.

", - "exception":true - }, - "LifecyclePolicyPreviewFilter":{ - "type":"structure", - "members":{ - "tagStatus":{ - "shape":"TagStatus", - "documentation":"

The tag status of the image.

" - } - }, - "documentation":"

The filter for the lifecycle policy preview.

" - }, - "LifecyclePolicyPreviewInProgressException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The previous lifecycle policy preview request has not completed. Please try again later.

", - "exception":true - }, - "LifecyclePolicyPreviewNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

There is no dry run for this repository.

", - "exception":true - }, - "LifecyclePolicyPreviewResult":{ - "type":"structure", - "members":{ - "imageTags":{ - "shape":"ImageTagList", - "documentation":"

The list of tags associated with this image.

" - }, - "imageDigest":{ - "shape":"ImageDigest", - "documentation":"

The sha256 digest of the image manifest.

" - }, - "imagePushedAt":{ - "shape":"PushTimestamp", - "documentation":"

The date and time, expressed in standard JavaScript date format, at which the current image was pushed to the repository.

" - }, - "action":{ - "shape":"LifecyclePolicyRuleAction", - "documentation":"

The type of action to be taken.

" - }, - "appliedRulePriority":{ - "shape":"LifecyclePolicyRulePriority", - "documentation":"

The priority of the applied rule.

" - } - }, - "documentation":"

The result of the lifecycle policy preview.

" - }, - "LifecyclePolicyPreviewResultList":{ - "type":"list", - "member":{"shape":"LifecyclePolicyPreviewResult"} - }, - "LifecyclePolicyPreviewStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "COMPLETE", - "EXPIRED", - "FAILED" - ] - }, - "LifecyclePolicyPreviewSummary":{ - "type":"structure", - "members":{ - "expiringImageTotalCount":{ - "shape":"ImageCount", - "documentation":"

The number of expiring images.

" - } - }, - "documentation":"

The summary of the lifecycle policy preview request.

" - }, - "LifecyclePolicyRuleAction":{ - "type":"structure", - "members":{ - "type":{ - "shape":"ImageActionType", - "documentation":"

The type of action to be taken.

" - } - }, - "documentation":"

The type of action to be taken.

" - }, - "LifecyclePolicyRulePriority":{ - "type":"integer", - "min":1 - }, - "LifecyclePolicyText":{ - "type":"string", - "max":10240, - "min":100 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR Default Service Limits in the Amazon Elastic Container Registry User Guide.

", - "exception":true - }, - "ListImagesFilter":{ - "type":"structure", - "members":{ - "tagStatus":{ - "shape":"TagStatus", - "documentation":"

The tag status with which to filter your ListImages results. You can filter results based on whether they are TAGGED or UNTAGGED.

" - } - }, - "documentation":"

An object representing a filter on a ListImages operation.

" - }, - "ListImagesRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository in which to list images. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository with image IDs to be listed.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value returned from a previous paginated ListImages request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of image results returned by ListImages in paginated output. When this parameter is used, ListImages only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListImages request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListImages returns up to 100 results and a nextToken value, if applicable.

" - }, - "filter":{ - "shape":"ListImagesFilter", - "documentation":"

The filter key and value with which to filter your ListImages results.

" - } - } - }, - "ListImagesResponse":{ - "type":"structure", - "members":{ - "imageIds":{ - "shape":"ImageIdentifierList", - "documentation":"

The list of image IDs for the requested repository.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The nextToken value to include in a future ListImages request. When the results of a ListImages request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "MediaType":{"type":"string"}, - "MediaTypeList":{ - "type":"list", - "member":{"shape":"MediaType"}, - "max":100, - "min":1 - }, - "NextToken":{"type":"string"}, - "PartSize":{ - "type":"long", - "min":0 - }, - "ProxyEndpoint":{"type":"string"}, - "PushTimestamp":{"type":"timestamp"}, - "PutImageRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "imageManifest" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository in which to put the image. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository in which to put the image.

" - }, - "imageManifest":{ - "shape":"ImageManifest", - "documentation":"

The image manifest corresponding to the image to be uploaded.

" - }, - "imageTag":{ - "shape":"ImageTag", - "documentation":"

The tag to associate with the image. This parameter is required for images that use the Docker Image Manifest V2 Schema 2 or OCI formats.

" - } - } - }, - "PutImageResponse":{ - "type":"structure", - "members":{ - "image":{ - "shape":"Image", - "documentation":"

Details of the image uploaded.

" - } - } - }, - "PutLifecyclePolicyRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "lifecyclePolicyText" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do
 not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to receive the policy.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON repository policy text to apply to the repository.

" - } - } - }, - "PutLifecyclePolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON repository policy text.

" - } - } - }, - "RegistryId":{ - "type":"string", - "pattern":"[0-9]{12}" - }, - "Repository":{ - "type":"structure", - "members":{ - "repositoryArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the repository. The ARN contains the arn:aws:ecr namespace, followed by the region of the repository, AWS account ID of the repository owner, repository namespace, and repository name. For example, arn:aws:ecr:region:012345678910:repository/test.

" - }, - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository.

" - }, - "repositoryUri":{ - "shape":"Url", - "documentation":"

The URI for the repository. You can use this URI for Docker push or pull operations.

" - }, - "createdAt":{ - "shape":"CreationTimestamp", - "documentation":"

The date and time, in JavaScript date format, when the repository was created.

" - } - }, - "documentation":"

An object representing a repository.

" - }, - "RepositoryAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified repository already exists in the specified registry.

", - "exception":true - }, - "RepositoryList":{ - "type":"list", - "member":{"shape":"Repository"} - }, - "RepositoryName":{ - "type":"string", - "max":256, - "min":2, - "pattern":"(?:[a-z0-9]+(?:[._-][a-z0-9]+)*/)*[a-z0-9]+(?:[._-][a-z0-9]+)*" - }, - "RepositoryNameList":{ - "type":"list", - "member":{"shape":"RepositoryName"}, - "max":100, - "min":1 - }, - "RepositoryNotEmptyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified repository contains images. To delete a repository that contains images, you must force the deletion with the force parameter.

", - "exception":true - }, - "RepositoryNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

", - "exception":true - }, - "RepositoryPolicyNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The specified repository and registry combination does not have an associated repository policy.

", - "exception":true - }, - "RepositoryPolicyText":{ - "type":"string", - "max":10240, - "min":0 - }, - "ServerException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

These errors are usually caused by a server-side issue.

", - "exception":true, - "fault":true - }, - "SetRepositoryPolicyRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "policyText" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to receive the policy.

" - }, - "policyText":{ - "shape":"RepositoryPolicyText", - "documentation":"

The JSON repository policy text to apply to the repository.

" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

If the policy you are attempting to set on a repository policy would prevent you from setting another policy in the future, you must force the SetRepositoryPolicy operation. This is intended to prevent accidental repository lock outs.

" - } - } - }, - "SetRepositoryPolicyResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "policyText":{ - "shape":"RepositoryPolicyText", - "documentation":"

The JSON repository policy text applied to the repository.

" - } - } - }, - "StartLifecyclePolicyPreviewRequest":{ - "type":"structure", - "required":["repositoryName"], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to be evaluated.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The policy to be evaluated against. If you do not specify a policy, the current policy for the repository is used.

" - } - } - }, - "StartLifecyclePolicyPreviewResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "lifecyclePolicyText":{ - "shape":"LifecyclePolicyText", - "documentation":"

The JSON repository policy text.

" - }, - "status":{ - "shape":"LifecyclePolicyPreviewStatus", - "documentation":"

The status of the lifecycle policy preview request.

" - } - } - }, - "TagStatus":{ - "type":"string", - "enum":[ - "TAGGED", - "UNTAGGED" - ] - }, - "UploadId":{ - "type":"string", - "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" - }, - "UploadLayerPartRequest":{ - "type":"structure", - "required":[ - "repositoryName", - "uploadId", - "partFirstByte", - "partLastByte", - "layerPartBlob" - ], - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The AWS account ID associated with the registry to which you are uploading layer parts. If you do not specify a registry, the default registry is assumed.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The name of the repository to which you are uploading layer parts.

" - }, - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID from a previous InitiateLayerUpload operation to associate with the layer part upload.

" - }, - "partFirstByte":{ - "shape":"PartSize", - "documentation":"

The integer value of the first byte of the layer part.

" - }, - "partLastByte":{ - "shape":"PartSize", - "documentation":"

The integer value of the last byte of the layer part.

" - }, - "layerPartBlob":{ - "shape":"LayerPartBlob", - "documentation":"

The base64-encoded layer part payload.

" - } - } - }, - "UploadLayerPartResponse":{ - "type":"structure", - "members":{ - "registryId":{ - "shape":"RegistryId", - "documentation":"

The registry ID associated with the request.

" - }, - "repositoryName":{ - "shape":"RepositoryName", - "documentation":"

The repository name associated with the request.

" - }, - "uploadId":{ - "shape":"UploadId", - "documentation":"

The upload ID associated with the request.

" - }, - "lastByteReceived":{ - "shape":"PartSize", - "documentation":"

The integer value of the last byte received in the request.

" - } - } - }, - "UploadNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The error message associated with the exception.

" - } - }, - "documentation":"

The upload could not be found, or the specified upload id is not valid for this repository.

", - "exception":true - }, - "Url":{"type":"string"} - }, - "documentation":"

Amazon Elastic Container Registry (Amazon ECR) is a managed Docker registry service. Customers can use the familiar Docker CLI to push, pull, and manage images. Amazon ECR provides a secure, scalable, and reliable registry. Amazon ECR supports private Docker repositories with resource-based permissions using IAM so that specific users or Amazon EC2 instances can access repositories and images. Developers can use the Docker CLI to author and manage images.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/examples-1.json deleted file mode 100644 index c14ba44a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/examples-1.json +++ /dev/null @@ -1,883 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateCluster": [ - { - "input": { - "clusterName": "my_cluster" - }, - "output": { - "cluster": { - "activeServicesCount": 0, - "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster", - "clusterName": "my_cluster", - "pendingTasksCount": 0, - "registeredContainerInstancesCount": 0, - "runningTasksCount": 0, - "status": "ACTIVE" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a cluster in your default region.", - "id": "to-create-a-new-cluster-1472514079365", - "title": "To create a new cluster" - } - ], - "CreateService": [ - { - "input": { - "desiredCount": 10, - "serviceName": "ecs-simple-service", - "taskDefinition": "hello_world" - }, - "output": { - "service": { - "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", - "createdAt": "2016-08-29T16:13:47.298Z", - "deploymentConfiguration": { - "maximumPercent": 200, - "minimumHealthyPercent": 100 - }, - "deployments": [ - { - "createdAt": "2016-08-29T16:13:47.298Z", - "desiredCount": 10, - "id": "ecs-svc/9223370564342348388", - "pendingCount": 0, - "runningCount": 0, - "status": "PRIMARY", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", - "updatedAt": "2016-08-29T16:13:47.298Z" - }, - { - "createdAt": "2016-08-29T15:52:44.481Z", - "desiredCount": 0, - "id": "ecs-svc/9223370564343611322", - "pendingCount": 0, - "runningCount": 0, - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", - "updatedAt": "2016-08-29T16:11:38.941Z" - } - ], - "desiredCount": 10, - "events": [ - - ], - "loadBalancers": [ - - ], - "pendingCount": 0, - "runningCount": 0, - "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service", - "serviceName": "ecs-simple-service", - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a service in your default region called ``ecs-simple-service``. The service uses the ``hello_world`` task definition and it maintains 10 copies of that task.", - "id": "to-create-a-new-service-1472512584282", - "title": "To create a new service" - }, - { - "input": { - "desiredCount": 10, - "loadBalancers": [ - { - "containerName": "simple-app", - "containerPort": 80, - "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2" - } - ], - "role": "ecsServiceRole", - "serviceName": "ecs-simple-service-elb", - "taskDefinition": "console-sample-app-static" - }, - "output": { - "service": { - "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", - "createdAt": "2016-08-29T16:02:54.884Z", - "deploymentConfiguration": { - "maximumPercent": 200, - "minimumHealthyPercent": 100 - }, - "deployments": [ - { - "createdAt": "2016-08-29T16:02:54.884Z", - "desiredCount": 10, - "id": "ecs-svc/9223370564343000923", - "pendingCount": 0, - "runningCount": 0, - "status": "PRIMARY", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6", - "updatedAt": "2016-08-29T16:02:54.884Z" - } - ], - "desiredCount": 10, - "events": [ - - ], - "loadBalancers": [ - { - "containerName": "simple-app", - "containerPort": 80, - "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2" - } - ], - "pendingCount": 0, - "roleArn": "arn:aws:iam::012345678910:role/ecsServiceRole", - "runningCount": 0, - "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service-elb", - "serviceName": "ecs-simple-service-elb", - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a service in your default region called ``ecs-simple-service-elb``. The service uses the ``ecs-demo`` task definition and it maintains 10 copies of that task. You must reference an existing load balancer in the same region by its name.", - "id": "to-create-a-new-service-behind-a-load-balancer-1472512484823", - "title": "To create a new service behind a load balancer" - } - ], - "DeleteCluster": [ - { - "input": { - "cluster": "my_cluster" - }, - "output": { - "cluster": { - "activeServicesCount": 0, - "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster", - "clusterName": "my_cluster", - "pendingTasksCount": 0, - "registeredContainerInstancesCount": 0, - "runningTasksCount": 0, - "status": "INACTIVE" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes an empty cluster in your default region.", - "id": "to-delete-an-empty-cluster-1472512705352", - "title": "To delete an empty cluster" - } - ], - "DeleteService": [ - { - "input": { - "service": "my-http-service" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the my-http-service service. The service must have a desired count and running count of 0 before you can delete it.", - "id": "e8183e38-f86e-4390-b811-f74f30a6007d", - "title": "To delete a service" - } - ], - "DeregisterContainerInstance": [ - { - "input": { - "cluster": "default", - "containerInstance": "container_instance_UUID", - "force": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deregisters a container instance from the specified cluster in your default region. If there are still tasks running on the container instance, you must either stop those tasks before deregistering, or use the force option.", - "id": "bf624927-cf64-4f4b-8b7e-c024a4e682f6", - "title": "To deregister a container instance from a cluster" - } - ], - "DescribeClusters": [ - { - "input": { - "clusters": [ - "default" - ] - }, - "output": { - "clusters": [ - { - "clusterArn": "arn:aws:ecs:us-east-1:aws_account_id:cluster/default", - "clusterName": "default", - "status": "ACTIVE" - } - ], - "failures": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example provides a description of the specified cluster in your default region.", - "id": "ba88d100-9672-4231-80da-a4bd210bf728", - "title": "To describe a cluster" - } - ], - "DescribeContainerInstances": [ - { - "input": { - "cluster": "default", - "containerInstances": [ - "f2756532-8f13-4d53-87c9-aed50dc94cd7" - ] - }, - "output": { - "containerInstances": [ - { - "agentConnected": true, - "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/f2756532-8f13-4d53-87c9-aed50dc94cd7", - "ec2InstanceId": "i-807f3249", - "pendingTasksCount": 0, - "registeredResources": [ - { - "name": "CPU", - "type": "INTEGER", - "doubleValue": 0.0, - "integerValue": 2048, - "longValue": 0 - }, - { - "name": "MEMORY", - "type": "INTEGER", - "doubleValue": 0.0, - "integerValue": 3768, - "longValue": 0 - }, - { - "name": "PORTS", - "type": "STRINGSET", - "doubleValue": 0.0, - "integerValue": 0, - "longValue": 0, - "stringSetValue": [ - "2376", - "22", - "51678", - "2375" - ] - } - ], - "remainingResources": [ - { - "name": "CPU", - "type": "INTEGER", - "doubleValue": 0.0, - "integerValue": 1948, - "longValue": 0 - }, - { - "name": "MEMORY", - "type": "INTEGER", - "doubleValue": 0.0, - "integerValue": 3668, - "longValue": 0 - }, - { - "name": "PORTS", - "type": "STRINGSET", - "doubleValue": 0.0, - "integerValue": 0, - "longValue": 0, - "stringSetValue": [ - "2376", - "22", - "80", - "51678", - "2375" - ] - } - ], - "runningTasksCount": 1, - "status": "ACTIVE" - } - ], - "failures": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example provides a description of the specified container instance in your default region, using the container instance UUID as an identifier.", - "id": "c8f439de-eb27-4269-8ca7-2c0a7ba75ab0", - "title": "To describe container instance" - } - ], - "DescribeServices": [ - { - "input": { - "services": [ - "ecs-simple-service" - ] - }, - "output": { - "failures": [ - - ], - "services": [ - { - "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", - "createdAt": "2016-08-29T16:25:52.130Z", - "deploymentConfiguration": { - "maximumPercent": 200, - "minimumHealthyPercent": 100 - }, - "deployments": [ - { - "createdAt": "2016-08-29T16:25:52.130Z", - "desiredCount": 1, - "id": "ecs-svc/9223370564341623665", - "pendingCount": 0, - "runningCount": 0, - "status": "PRIMARY", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", - "updatedAt": "2016-08-29T16:25:52.130Z" - } - ], - "desiredCount": 1, - "events": [ - { - "createdAt": "2016-08-29T16:25:58.520Z", - "id": "38c285e5-d335-4b68-8b15-e46dedc8e88d", - "message": "(service ecs-simple-service) was unable to place a task because no container instance met all of its requirements. The closest matching (container-instance 3f4de1c5-ffdd-4954-af7e-75b4be0c8841) is already using a port required by your task. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide." - } - ], - "loadBalancers": [ - - ], - "pendingCount": 0, - "runningCount": 0, - "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service", - "serviceName": "ecs-simple-service", - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6" - } - ] - }, - "comments": { - "input": { - }, - "output": { - "services[0].events[0].message": "In this example, there is a service event that shows unavailable cluster resources." - } - }, - "description": "This example provides descriptive information about the service named ``ecs-simple-service``.", - "id": "to-describe-a-service-1472513256350", - "title": "To describe a service" - } - ], - "DescribeTaskDefinition": [ - { - "input": { - "taskDefinition": "hello_world:8" - }, - "output": { - "taskDefinition": { - "containerDefinitions": [ - { - "name": "wordpress", - "cpu": 10, - "environment": [ - - ], - "essential": true, - "image": "wordpress", - "links": [ - "mysql" - ], - "memory": 500, - "mountPoints": [ - - ], - "portMappings": [ - { - "containerPort": 80, - "hostPort": 80 - } - ], - "volumesFrom": [ - - ] - }, - { - "name": "mysql", - "cpu": 10, - "environment": [ - { - "name": "MYSQL_ROOT_PASSWORD", - "value": "password" - } - ], - "essential": true, - "image": "mysql", - "memory": 500, - "mountPoints": [ - - ], - "portMappings": [ - - ], - "volumesFrom": [ - - ] - } - ], - "family": "hello_world", - "revision": 8, - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/hello_world:8", - "volumes": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example provides a description of the specified task definition.", - "id": "4c21eeb1-f1da-4a08-8c44-297fc8d0ea88", - "title": "To describe a task definition" - } - ], - "DescribeTasks": [ - { - "input": { - "tasks": [ - "c5cba4eb-5dad-405e-96db-71ef8eefe6a8" - ] - }, - "output": { - "failures": [ - - ], - "tasks": [ - { - "clusterArn": "arn:aws:ecs:::cluster/default", - "containerInstanceArn": "arn:aws:ecs:::container-instance/18f9eda5-27d7-4c19-b133-45adc516e8fb", - "containers": [ - { - "name": "ecs-demo", - "containerArn": "arn:aws:ecs:::container/7c01765b-c588-45b3-8290-4ba38bd6c5a6", - "lastStatus": "RUNNING", - "networkBindings": [ - { - "bindIP": "0.0.0.0", - "containerPort": 80, - "hostPort": 80 - } - ], - "taskArn": "arn:aws:ecs:::task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8" - } - ], - "desiredStatus": "RUNNING", - "lastStatus": "RUNNING", - "overrides": { - "containerOverrides": [ - { - "name": "ecs-demo" - } - ] - }, - "startedBy": "ecs-svc/9223370608528463088", - "taskArn": "arn:aws:ecs:::task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8", - "taskDefinitionArn": "arn:aws:ecs:::task-definition/amazon-ecs-sample:1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example provides a description of the specified task, using the task UUID as an identifier.", - "id": "a90b0cde-f965-4946-b55e-cfd8cc54e827", - "title": "To describe a task" - } - ], - "ListClusters": [ - { - "input": { - }, - "output": { - "clusterArns": [ - "arn:aws:ecs:us-east-1::cluster/test", - "arn:aws:ecs:us-east-1::cluster/default" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of your available clusters in your default region.", - "id": "e337d059-134f-4125-ba8e-4f499139facf", - "title": "To list your available clusters" - } - ], - "ListContainerInstances": [ - { - "input": { - "cluster": "default" - }, - "output": { - "containerInstanceArns": [ - "arn:aws:ecs:us-east-1::container-instance/f6bbb147-5370-4ace-8c73-c7181ded911f", - "arn:aws:ecs:us-east-1::container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of your available container instances in the specified cluster in your default region.", - "id": "62a82a94-713c-4e18-8420-1d2b2ba9d484", - "title": "To list your available container instances in a cluster" - } - ], - "ListServices": [ - { - "input": { - }, - "output": { - "serviceArns": [ - "arn:aws:ecs:us-east-1:012345678910:service/my-http-service" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the services running in the default cluster for an account.", - "id": "1d9a8037-4e0e-4234-a528-609656809a3a", - "title": "To list the services in a cluster" - } - ], - "ListTaskDefinitionFamilies": [ - { - "input": { - }, - "output": { - "families": [ - "node-js-app", - "web-timer", - "hpcc", - "hpcc-c4-8xlarge" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of your registered task definition families.", - "id": "b5c89769-1d94-4ca2-a79e-8069103c7f75", - "title": "To list your registered task definition families" - }, - { - "input": { - "familyPrefix": "hpcc" - }, - "output": { - "families": [ - "hpcc", - "hpcc-c4-8xlarge" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the task definition revisions that start with \"hpcc\".", - "id": "8a4cf9a6-42c1-4fe3-852d-99ac8968e11b", - "title": "To filter your registered task definition families" - } - ], - "ListTaskDefinitions": [ - { - "input": { - }, - "output": { - "taskDefinitionArns": [ - "arn:aws:ecs:us-east-1::task-definition/sleep300:2", - "arn:aws:ecs:us-east-1::task-definition/sleep360:1", - "arn:aws:ecs:us-east-1::task-definition/wordpress:3", - "arn:aws:ecs:us-east-1::task-definition/wordpress:4", - "arn:aws:ecs:us-east-1::task-definition/wordpress:5", - "arn:aws:ecs:us-east-1::task-definition/wordpress:6" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of your registered task definitions.", - "id": "b381ebaf-7eba-4d60-b99b-7f6ae49d3d60", - "title": "To list your registered task definitions" - }, - { - "input": { - "familyPrefix": "wordpress" - }, - "output": { - "taskDefinitionArns": [ - "arn:aws:ecs:us-east-1::task-definition/wordpress:3", - "arn:aws:ecs:us-east-1::task-definition/wordpress:4", - "arn:aws:ecs:us-east-1::task-definition/wordpress:5", - "arn:aws:ecs:us-east-1::task-definition/wordpress:6" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the task definition revisions of a specified family.", - "id": "734e7afd-753a-4bc2-85d0-badddce10910", - "title": "To list the registered task definitions in a family" - } - ], - "ListTasks": [ - { - "input": { - "cluster": "default" - }, - "output": { - "taskArns": [ - "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84", - "arn:aws:ecs:us-east-1:012345678910:task/6b809ef6-c67e-4467-921f-ee261c15a0a1" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all of the tasks in a cluster.", - "id": "9a6ec707-1a77-45d0-b2eb-516b5dd9e924", - "title": "To list the tasks in a cluster" - }, - { - "input": { - "cluster": "default", - "containerInstance": "f6bbb147-5370-4ace-8c73-c7181ded911f" - }, - "output": { - "taskArns": [ - "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists the tasks of a specified container instance. Specifying a ``containerInstance`` value limits the results to tasks that belong to that container instance.", - "id": "024bf3b7-9cbb-44e3-848f-9d074e1fecce", - "title": "To list the tasks on a particular container instance" - } - ], - "RegisterTaskDefinition": [ - { - "input": { - "containerDefinitions": [ - { - "name": "sleep", - "command": [ - "sleep", - "360" - ], - "cpu": 10, - "essential": true, - "image": "busybox", - "memory": 10 - } - ], - "family": "sleep360", - "taskRoleArn": "", - "volumes": [ - - ] - }, - "output": { - "taskDefinition": { - "containerDefinitions": [ - { - "name": "sleep", - "command": [ - "sleep", - "360" - ], - "cpu": 10, - "environment": [ - - ], - "essential": true, - "image": "busybox", - "memory": 10, - "mountPoints": [ - - ], - "portMappings": [ - - ], - "volumesFrom": [ - - ] - } - ], - "family": "sleep360", - "revision": 1, - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:19", - "volumes": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers a task definition to the specified family.", - "id": "to-register-a-task-definition-1470764550877", - "title": "To register a task definition" - } - ], - "RunTask": [ - { - "input": { - "cluster": "default", - "taskDefinition": "sleep360:1" - }, - "output": { - "tasks": [ - { - "containerInstanceArn": "arn:aws:ecs:us-east-1::container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb", - "containers": [ - { - "name": "sleep", - "containerArn": "arn:aws:ecs:us-east-1::container/58591c8e-be29-4ddf-95aa-ee459d4c59fd", - "lastStatus": "PENDING", - "taskArn": "arn:aws:ecs:us-east-1::task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0" - } - ], - "desiredStatus": "RUNNING", - "lastStatus": "PENDING", - "overrides": { - "containerOverrides": [ - { - "name": "sleep" - } - ] - }, - "taskArn": "arn:aws:ecs:us-east-1::task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0", - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example runs the specified task definition on your default cluster.", - "id": "6f238c83-a133-42cd-ab3d-abeca0560445", - "title": "To run a task on your default cluster" - } - ], - "UpdateService": [ - { - "input": { - "service": "my-http-service", - "taskDefinition": "amazon-ecs-sample" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the my-http-service service to use the amazon-ecs-sample task definition.", - "id": "cc9e8900-0cc2-44d2-8491-64d1d3d37887", - "title": "To change the task definition used in a service" - }, - { - "input": { - "desiredCount": 10, - "service": "my-http-service" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the desired count of the my-http-service service to 10.", - "id": "9581d6c5-02e3-4140-8cc1-5a4301586633", - "title": "To change the number of tasks in a service" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/paginators-1.json deleted file mode 100644 index 43ae3dec..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "ListClusters": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "clusterArns" - }, - "ListContainerInstances": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "containerInstanceArns" - }, - "ListTaskDefinitions": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskDefinitionArns" - }, - "ListTaskDefinitionFamilies": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "families" - }, - "ListTasks": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskArns" - }, - "ListServices": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "serviceArns" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/service-2.json deleted file mode 100644 index 40cbc137..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/service-2.json +++ /dev/null @@ -1,3388 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-11-13", - "endpointPrefix":"ecs", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon ECS", - "serviceFullName":"Amazon EC2 Container Service", - "serviceId":"ECS", - "signatureVersion":"v4", - "targetPrefix":"AmazonEC2ContainerServiceV20141113", - "uid":"ecs-2014-11-13" - }, - "operations":{ - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterRequest"}, - "output":{"shape":"CreateClusterResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the CreateCluster action.

When you call the CreateCluster API operation, Amazon ECS attempts to create the service-linked role for your account so that required resources in other AWS services can be managed on your behalf. However, if the IAM user that makes the call does not have permissions to create the service-linked role, it is not created. For more information, see Using Service-Linked Roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

" - }, - "CreateService":{ - "name":"CreateService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateServiceRequest"}, - "output":{"shape":"CreateServiceResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"UnsupportedFeatureException"}, - {"shape":"PlatformUnknownException"}, - {"shape":"PlatformTaskDefinitionIncompatibilityException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Runs and maintains a desired number of tasks from a specified task definition. If the number of tasks running in a service drops below desiredCount, Amazon ECS spawns another copy of the task in the specified cluster. To update an existing service, see UpdateService.

In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind a load balancer. The load balancer distributes traffic across the tasks that are associated with the service. For more information, see Service Load Balancing in the Amazon Elastic Container Service Developer Guide.

You can optionally specify a deployment configuration for your service. During a deployment, the service scheduler uses the minimumHealthyPercent and maximumPercent parameters to determine the deployment strategy. The deployment is triggered by changing the task definition or the desired count of a service with an UpdateService operation.

The minimumHealthyPercent represents a lower limit on the number of your service's tasks that must remain in the RUNNING state during a deployment, as a percentage of the desiredCount (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a desiredCount of four tasks and a minimumHealthyPercent of 50%, the scheduler can stop two existing tasks to free up cluster capacity before starting two new tasks. Tasks for services that do not use a load balancer are considered healthy if they are in the RUNNING state. Tasks for services that do use a load balancer are considered healthy if they are in the RUNNING state and the container instance they are hosted on is reported as healthy by the load balancer. The default value for a replica service for minimumHealthyPercent is 50% in the console and 100% for the AWS CLI, the AWS SDKs, and the APIs. The default value for a daemon service for minimumHealthyPercent is 0% for the AWS CLI, the AWS SDKs, and the APIs and 50% for the console.

The maximumPercent parameter represents an upper limit on the number of your service's tasks that are allowed in the RUNNING or PENDING state during a deployment, as a percentage of the desiredCount (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if your replica service has a desiredCount of four tasks and a maximumPercent value of 200%, the scheduler can start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for a replica service for maximumPercent is 200%. If you are using a daemon service type, the maximumPercent should remain at 100%, which is the default value.

When the service scheduler launches new tasks, it determines task placement in your cluster using the following logic:

  • Determine which of the container instances in your cluster can support your service's task definition (for example, they have the required CPU, memory, ports, and container instance attributes).

  • By default, the service scheduler attempts to balance tasks across Availability Zones in this manner (although you can choose a different placement strategy) with the placementStrategy parameter):

    • Sort the valid container instances, giving priority to instances that have the fewest number of running tasks for this service in their respective Availability Zone. For example, if zone A has one running service task and zones B and C each have zero, valid container instances in either zone B or C are considered optimal for placement.

    • Place the new service task on a valid container instance in an optimal Availability Zone (based on the previous steps), favoring container instances with the fewest number of running tasks for this service.

" - }, - "DeleteAttributes":{ - "name":"DeleteAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAttributesRequest"}, - "output":{"shape":"DeleteAttributesResponse"}, - "errors":[ - {"shape":"ClusterNotFoundException"}, - {"shape":"TargetNotFoundException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Deletes one or more custom attributes from an Amazon ECS resource.

" - }, - "DeleteCluster":{ - "name":"DeleteCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterRequest"}, - "output":{"shape":"DeleteClusterResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"ClusterContainsContainerInstancesException"}, - {"shape":"ClusterContainsServicesException"}, - {"shape":"ClusterContainsTasksException"} - ], - "documentation":"

Deletes the specified cluster. You must deregister all container instances from this cluster before you may delete it. You can list the container instances in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.

" - }, - "DeleteService":{ - "name":"DeleteService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServiceRequest"}, - "output":{"shape":"DeleteServiceResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"ServiceNotFoundException"} - ], - "documentation":"

Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the desired task count is zero. If the service is actively maintaining tasks, you cannot delete it, and you must update the service to a desired task count of zero. For more information, see UpdateService.

When you delete a service, if there are still running tasks that require cleanup, the service status moves from ACTIVE to DRAINING, and the service is no longer visible in the console or in ListServices API operations. After the tasks have stopped, then the service status moves from DRAINING to INACTIVE. Services in the DRAINING or INACTIVE status can still be viewed with DescribeServices API operations. However, in the future, INACTIVE services may be cleaned up and purged from Amazon ECS record keeping, and DescribeServices API operations on those services return a ServiceNotFoundException error.

If you attempt to create a new service with the same name as an existing service in either ACTIVE or DRAINING status, you will receive an error.

" - }, - "DeregisterContainerInstance":{ - "name":"DeregisterContainerInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterContainerInstanceRequest"}, - "output":{"shape":"DeregisterContainerInstanceResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Deregisters an Amazon ECS container instance from the specified cluster. This instance is no longer available to run tasks.

If you intend to use the container instance for some other purpose after deregistration, you should stop all of the tasks running on the container instance before deregistration. That prevents any orphaned tasks from consuming resources.

Deregistering a container instance removes the instance from a cluster, but it does not terminate the EC2 instance; if you are finished using the instance, be sure to terminate it in the Amazon EC2 console to stop billing.

If you terminate a running container instance, Amazon ECS automatically deregisters the instance from your cluster (stopped container instances or instances with disconnected agents are not automatically deregistered when terminated).

" - }, - "DeregisterTaskDefinition":{ - "name":"DeregisterTaskDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterTaskDefinitionRequest"}, - "output":{"shape":"DeregisterTaskDefinitionResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked as INACTIVE. Existing tasks and services that reference an INACTIVE task definition continue to run without disruption. Existing services that reference an INACTIVE task definition can still scale up or down by modifying the service's desired count.

You cannot use an INACTIVE task definition to run new tasks or create new services, and you cannot update an existing service to reference an INACTIVE task definition (although there may be up to a 10-minute window following deregistration where these restrictions have not yet taken effect).

At this time, INACTIVE task definitions remain discoverable in your account indefinitely; however, this behavior is subject to change in the future, so you should not rely on INACTIVE task definitions persisting beyond the lifecycle of any associated tasks and services.

" - }, - "DescribeClusters":{ - "name":"DescribeClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClustersRequest"}, - "output":{"shape":"DescribeClustersResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Describes one or more of your clusters.

" - }, - "DescribeContainerInstances":{ - "name":"DescribeContainerInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeContainerInstancesRequest"}, - "output":{"shape":"DescribeContainerInstancesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Describes Amazon Elastic Container Service container instances. Returns metadata about registered and remaining resources on each container instance requested.

" - }, - "DescribeServices":{ - "name":"DescribeServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServicesRequest"}, - "output":{"shape":"DescribeServicesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Describes the specified services running in your cluster.

" - }, - "DescribeTaskDefinition":{ - "name":"DescribeTaskDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTaskDefinitionRequest"}, - "output":{"shape":"DescribeTaskDefinitionResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Describes a task definition. You can specify a family and revision to find information about a specific task definition, or you can simply specify the family to find the latest ACTIVE revision in that family.

You can only describe INACTIVE task definitions while an active task or service references them.

" - }, - "DescribeTasks":{ - "name":"DescribeTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTasksRequest"}, - "output":{"shape":"DescribeTasksResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Describes a specified task or tasks.

" - }, - "DiscoverPollEndpoint":{ - "name":"DiscoverPollEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DiscoverPollEndpointRequest"}, - "output":{"shape":"DiscoverPollEndpointResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"} - ], - "documentation":"

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Returns an endpoint for the Amazon ECS agent to poll for updates.

" - }, - "ListAttributes":{ - "name":"ListAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttributesRequest"}, - "output":{"shape":"ListAttributesResponse"}, - "errors":[ - {"shape":"ClusterNotFoundException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Lists the attributes for Amazon ECS resources within a specified target type and cluster. When you specify a target type and cluster, ListAttributes returns a list of attribute objects, one for each attribute on each resource. You can filter the list of results to a single attribute name to only return results that have that name. You can also filter the results by attribute name and value, for example, to see which container instances in a cluster are running a Linux AMI (ecs.os-type=linux).

" - }, - "ListClusters":{ - "name":"ListClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListClustersRequest"}, - "output":{"shape":"ListClustersResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns a list of existing clusters.

" - }, - "ListContainerInstances":{ - "name":"ListContainerInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListContainerInstancesRequest"}, - "output":{"shape":"ListContainerInstancesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Returns a list of container instances in a specified cluster. You can filter the results of a ListContainerInstances operation with cluster query language statements inside the filter parameter. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

" - }, - "ListServices":{ - "name":"ListServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListServicesRequest"}, - "output":{"shape":"ListServicesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Lists the services that are running in a specified cluster.

" - }, - "ListTaskDefinitionFamilies":{ - "name":"ListTaskDefinitionFamilies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTaskDefinitionFamiliesRequest"}, - "output":{"shape":"ListTaskDefinitionFamiliesResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns a list of task definition families that are registered to your account (which may include task definition families that no longer have any ACTIVE task definition revisions).

You can filter out task definition families that do not contain any ACTIVE task definition revisions by setting the status parameter to ACTIVE. You can also filter the results with the familyPrefix parameter.

" - }, - "ListTaskDefinitions":{ - "name":"ListTaskDefinitions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTaskDefinitionsRequest"}, - "output":{"shape":"ListTaskDefinitionsResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns a list of task definitions that are registered to your account. You can filter the results by family name with the familyPrefix parameter or by status with the status parameter.

" - }, - "ListTasks":{ - "name":"ListTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTasksRequest"}, - "output":{"shape":"ListTasksResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"ServiceNotFoundException"} - ], - "documentation":"

Returns a list of tasks for a specified cluster. You can filter the results by family name, by a particular container instance, or by the desired status of the task with the family, containerInstance, and desiredStatus parameters.

Recently stopped tasks might appear in the returned results. Currently, stopped tasks appear in the returned results for at least one hour.

" - }, - "PutAttributes":{ - "name":"PutAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutAttributesRequest"}, - "output":{"shape":"PutAttributesResponse"}, - "errors":[ - {"shape":"ClusterNotFoundException"}, - {"shape":"TargetNotFoundException"}, - {"shape":"AttributeLimitExceededException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Create or update an attribute on an Amazon ECS resource. If the attribute does not exist, it is created. If the attribute exists, its value is replaced with the specified value. To delete an attribute, use DeleteAttributes. For more information, see Attributes in the Amazon Elastic Container Service Developer Guide.

" - }, - "RegisterContainerInstance":{ - "name":"RegisterContainerInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterContainerInstanceRequest"}, - "output":{"shape":"RegisterContainerInstanceResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Registers an EC2 instance into the specified cluster. This instance becomes available to place containers on.

" - }, - "RegisterTaskDefinition":{ - "name":"RegisterTaskDefinition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterTaskDefinitionRequest"}, - "output":{"shape":"RegisterTaskDefinitionResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Registers a new task definition from the supplied family and containerDefinitions. Optionally, you can add data volumes to your containers with the volumes parameter. For more information about task definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon Elastic Container Service Developer Guide.

You can specify an IAM role for your task with the taskRoleArn parameter. When you specify an IAM role for a task, its containers can then use the latest versions of the AWS CLI or SDKs to make API requests to the AWS services that are specified in the IAM policy associated with the role. For more information, see IAM Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

You can specify a Docker networking mode for the containers in your task definition with the networkMode parameter. The available network modes correspond to those described in Network settings in the Docker run reference. If you specify the awsvpc network mode, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

" - }, - "RunTask":{ - "name":"RunTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunTaskRequest"}, - "output":{"shape":"RunTaskResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"UnsupportedFeatureException"}, - {"shape":"PlatformUnknownException"}, - {"shape":"PlatformTaskDefinitionIncompatibilityException"}, - {"shape":"AccessDeniedException"}, - {"shape":"BlockedException"} - ], - "documentation":"

Starts a new task using the specified task definition.

You can allow Amazon ECS to place tasks for you, or you can customize how Amazon ECS places tasks using placement constraints and placement strategies. For more information, see Scheduling Tasks in the Amazon Elastic Container Service Developer Guide.

Alternatively, you can use StartTask to use your own scheduler or place tasks manually on specific container instances.

The Amazon ECS API follows an eventual consistency model, due to the distributed nature of the system supporting the API. This means that the result of an API command you run that affects your Amazon ECS resources might not be immediately visible to all subsequent commands you run. You should keep this in mind when you carry out an API command that immediately follows a previous API command.

To manage eventual consistency, you can do the following:

  • Confirm the state of the resource before you run a command to modify it. Run the DescribeTasks command using an exponential backoff algorithm to ensure that you allow enough time for the previous command to propagate through the system. To do this, run the DescribeTasks command repeatedly, starting with a couple of seconds of wait time and increasing gradually up to five minutes of wait time.

  • Add wait time between subsequent commands, even if the DescribeTasks command returns an accurate response. Apply an exponential backoff algorithm starting with a couple of seconds of wait time, and increase gradually up to about five minutes of wait time.

" - }, - "StartTask":{ - "name":"StartTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartTaskRequest"}, - "output":{"shape":"StartTaskResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Starts a new task from the specified task definition on the specified container instance or instances.

Alternatively, you can use RunTask to place tasks for you. For more information, see Scheduling Tasks in the Amazon Elastic Container Service Developer Guide.

" - }, - "StopTask":{ - "name":"StopTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopTaskRequest"}, - "output":{"shape":"StopTaskResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Stops a running task.

When StopTask is called on a task, the equivalent of docker stop is issued to the containers running in the task. This results in a SIGTERM and a default 30-second timeout, after which SIGKILL is sent and the containers are forcibly stopped. If the container handles the SIGTERM gracefully and exits within 30 seconds from receiving it, no SIGKILL is sent.

The default 30-second timeout can be configured on the Amazon ECS container agent with the ECS_CONTAINER_STOP_TIMEOUT variable. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

" - }, - "SubmitContainerStateChange":{ - "name":"SubmitContainerStateChange", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SubmitContainerStateChangeRequest"}, - "output":{"shape":"SubmitContainerStateChangeResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a container changed states.

" - }, - "SubmitTaskStateChange":{ - "name":"SubmitTaskStateChange", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SubmitTaskStateChangeRequest"}, - "output":{"shape":"SubmitTaskStateChangeResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a task changed states.

" - }, - "UpdateContainerAgent":{ - "name":"UpdateContainerAgent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateContainerAgentRequest"}, - "output":{"shape":"UpdateContainerAgentResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"UpdateInProgressException"}, - {"shape":"NoUpdateAvailableException"}, - {"shape":"MissingVersionException"} - ], - "documentation":"

Updates the Amazon ECS container agent on a specified container instance. Updating the Amazon ECS container agent does not interrupt running tasks or services on the container instance. The process for updating the agent differs depending on whether your container instance was launched with the Amazon ECS-optimized AMI or another operating system.

UpdateContainerAgent requires the Amazon ECS-optimized AMI or Amazon Linux with the ecs-init service installed and running. For help updating the Amazon ECS container agent on other operating systems, see Manually Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide.

" - }, - "UpdateContainerInstancesState":{ - "name":"UpdateContainerInstancesState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateContainerInstancesStateRequest"}, - "output":{"shape":"UpdateContainerInstancesStateResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"} - ], - "documentation":"

Modifies the status of an Amazon ECS container instance.

You can change the status of a container instance to DRAINING to manually remove an instance from a cluster, for example to perform system updates, update the Docker daemon, or scale down the cluster size.

When you set a container instance to DRAINING, Amazon ECS prevents new tasks from being scheduled for placement on the container instance and replacement service tasks are started on other container instances in the cluster if the resources are available. Service tasks on the container instance that are in the PENDING state are stopped immediately.

Service tasks on the container instance that are in the RUNNING state are stopped and replaced according to the service's deployment configuration parameters, minimumHealthyPercent and maximumPercent. You can change the deployment configuration of your service using UpdateService.

  • If minimumHealthyPercent is below 100%, the scheduler can ignore desiredCount temporarily during task replacement. For example, desiredCount is four tasks, a minimum of 50% allows the scheduler to stop two existing tasks before starting two new tasks. If the minimum is 100%, the service scheduler can't remove existing tasks until the replacement tasks are considered healthy. Tasks for services that do not use a load balancer are considered healthy if they are in the RUNNING state. Tasks for services that use a load balancer are considered healthy if they are in the RUNNING state and the container instance they are hosted on is reported as healthy by the load balancer.

  • The maximumPercent parameter represents an upper limit on the number of running tasks during task replacement, which enables you to define the replacement batch size. For example, if desiredCount of four tasks, a maximum of 200% starts four new tasks before stopping the four tasks to be drained (provided that the cluster resources required to do this are available). If the maximum is 100%, then replacement tasks can't start until the draining tasks have stopped.

Any PENDING or RUNNING tasks that do not belong to a service are not affected; you must wait for them to finish or stop them manually.

A container instance has completed draining when it has no more RUNNING tasks. You can verify this using ListTasks.

When you set a container instance to ACTIVE, the Amazon ECS scheduler can begin scheduling tasks on the instance again.

" - }, - "UpdateService":{ - "name":"UpdateService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServiceRequest"}, - "output":{"shape":"UpdateServiceResponse"}, - "errors":[ - {"shape":"ServerException"}, - {"shape":"ClientException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClusterNotFoundException"}, - {"shape":"ServiceNotFoundException"}, - {"shape":"ServiceNotActiveException"}, - {"shape":"PlatformUnknownException"}, - {"shape":"PlatformTaskDefinitionIncompatibilityException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Modifies the desired count, deployment configuration, network configuration, or task definition used in a service.

You can add to or subtract from the number of instantiations of a task definition in a service by specifying the cluster that the service is running in and a new desiredCount parameter.

If you have updated the Docker image of your application, you can create a new task definition with that image and deploy it to your service. The service scheduler uses the minimum healthy percent and maximum percent parameters (in the service's deployment configuration) to determine the deployment strategy.

If your updated Docker image uses the same tag as what is in the existing task definition for your service (for example, my_image:latest), you do not need to create a new revision of your task definition. You can update the service using the forceNewDeployment option. The new tasks launched by the deployment pull the current image/tag combination from your repository when they start.

You can also update the deployment configuration of a service. When a deployment is triggered by updating the task definition of a service, the service scheduler uses the deployment configuration parameters, minimumHealthyPercent and maximumPercent, to determine the deployment strategy.

  • If minimumHealthyPercent is below 100%, the scheduler can ignore desiredCount temporarily during a deployment. For example, if desiredCount is four tasks, a minimum of 50% allows the scheduler to stop two existing tasks before starting two new tasks. Tasks for services that do not use a load balancer are considered healthy if they are in the RUNNING state. Tasks for services that use a load balancer are considered healthy if they are in the RUNNING state and the container instance they are hosted on is reported as healthy by the load balancer.

  • The maximumPercent parameter represents an upper limit on the number of running tasks during a deployment, which enables you to define the deployment batch size. For example, if desiredCount is four tasks, a maximum of 200% starts four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available).

When UpdateService stops a task during a deployment, the equivalent of docker stop is issued to the containers running in the task. This results in a SIGTERM and a 30-second timeout, after which SIGKILL is sent and the containers are forcibly stopped. If the container handles the SIGTERM gracefully and exits within 30 seconds from receiving it, no SIGKILL is sent.

When the service scheduler launches new tasks, it determines task placement in your cluster with the following logic:

  • Determine which of the container instances in your cluster can support your service's task definition (for example, they have the required CPU, memory, ports, and container instance attributes).

  • By default, the service scheduler attempts to balance tasks across Availability Zones in this manner (although you can choose a different placement strategy):

    • Sort the valid container instances by the fewest number of running tasks for this service in the same Availability Zone as the instance. For example, if zone A has one running service task and zones B and C each have zero, valid container instances in either zone B or C are considered optimal for placement.

    • Place the new service task on a valid container instance in an optimal Availability Zone (based on the previous steps), favoring container instances with the fewest number of running tasks for this service.

When the service scheduler stops running tasks, it attempts to maintain balance across the Availability Zones in your cluster using the following logic:

  • Sort the container instances by the largest number of running tasks for this service in the same Availability Zone as the instance. For example, if zone A has one running service task and zones B and C each have two, container instances in either zone B or C are considered optimal for termination.

  • Stop the task on a container instance in an optimal Availability Zone (based on the previous steps), favoring container instances with the largest number of running tasks for this service.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You do not have authorization to perform the requested action.

", - "exception":true - }, - "AgentUpdateStatus":{ - "type":"string", - "enum":[ - "PENDING", - "STAGING", - "STAGED", - "UPDATING", - "UPDATED", - "FAILED" - ] - }, - "AssignPublicIp":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "Attachment":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The unique identifier for the attachment.

" - }, - "type":{ - "shape":"String", - "documentation":"

The type of the attachment, such as ElasticNetworkInterface.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the attachment. Valid values are PRECREATED, CREATED, ATTACHING, ATTACHED, DETACHING, DETACHED, and DELETED.

" - }, - "details":{ - "shape":"AttachmentDetails", - "documentation":"

Details of the attachment. For elastic network interfaces, this includes the network interface ID, the MAC address, the subnet ID, and the private IPv4 address.

" - } - }, - "documentation":"

An object representing a container instance or task attachment.

" - }, - "AttachmentDetails":{ - "type":"list", - "member":{"shape":"KeyValuePair"} - }, - "AttachmentStateChange":{ - "type":"structure", - "required":[ - "attachmentArn", - "status" - ], - "members":{ - "attachmentArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the attachment.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the attachment.

" - } - }, - "documentation":"

An object representing a change in state for a task attachment.

" - }, - "AttachmentStateChanges":{ - "type":"list", - "member":{"shape":"AttachmentStateChange"} - }, - "Attachments":{ - "type":"list", - "member":{"shape":"Attachment"} - }, - "Attribute":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the attribute. Up to 128 letters (uppercase and lowercase), numbers, hyphens, underscores, and periods are allowed.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of the attribute. Up to 128 letters (uppercase and lowercase), numbers, hyphens, underscores, periods, at signs (@), forward slashes, colons, and spaces are allowed.

" - }, - "targetType":{ - "shape":"TargetType", - "documentation":"

The type of the target with which to attach the attribute. This parameter is required if you use the short form ID for a resource instead of the full ARN.

" - }, - "targetId":{ - "shape":"String", - "documentation":"

The ID of the target. You can specify the short form ID for a resource or the full Amazon Resource Name (ARN).

" - } - }, - "documentation":"

An attribute is a name-value pair associated with an Amazon ECS object. Attributes enable you to extend the Amazon ECS data model by adding custom metadata to your resources. For more information, see Attributes in the Amazon Elastic Container Service Developer Guide.

" - }, - "AttributeLimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You can apply up to 10 custom attributes per resource. You can view the attributes of a resource with ListAttributes. You can remove existing attributes on a resource with DeleteAttributes.

", - "exception":true - }, - "Attributes":{ - "type":"list", - "member":{"shape":"Attribute"} - }, - "AwsVpcConfiguration":{ - "type":"structure", - "required":["subnets"], - "members":{ - "subnets":{ - "shape":"StringList", - "documentation":"

The subnets associated with the task or service. There is a limit of 10 subnets able to be specified per AwsVpcConfiguration.

All specified subnets must be from the same VPC.

" - }, - "securityGroups":{ - "shape":"StringList", - "documentation":"

The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. There is a limit of 5 security groups able to be specified per AwsVpcConfiguration.

All specified security groups must be from the same VPC.

" - }, - "assignPublicIp":{ - "shape":"AssignPublicIp", - "documentation":"

Whether the task's elastic network interface receives a public IP address. The default value is DISABLED.

" - } - }, - "documentation":"

An object representing the networking details for a task or service.

" - }, - "BlockedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Your AWS account has been blocked. Contact AWS Support for more information.

", - "exception":true - }, - "Boolean":{"type":"boolean"}, - "BoxedBoolean":{ - "type":"boolean", - "box":true - }, - "BoxedInteger":{ - "type":"integer", - "box":true - }, - "ClientException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a client action, such as using an action or resource on behalf of a user that doesn't have permissions to use the action or resource, or specifying an identifier that is not valid.

", - "exception":true - }, - "Cluster":{ - "type":"structure", - "members":{ - "clusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that identifies the cluster. The ARN contains the arn:aws:ecs namespace, followed by the Region of the cluster, the AWS account ID of the cluster owner, the cluster namespace, and then the cluster name. For example, arn:aws:ecs:region:012345678910:cluster/test ..

" - }, - "clusterName":{ - "shape":"String", - "documentation":"

A user-generated string that you use to identify your cluster.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the cluster. The valid values are ACTIVE or INACTIVE. ACTIVE indicates that you can register container instances with the cluster and the associated instances can accept tasks.

" - }, - "registeredContainerInstancesCount":{ - "shape":"Integer", - "documentation":"

The number of container instances registered into the cluster. This includes container instances in both ACTIVE and DRAINING status.

" - }, - "runningTasksCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the cluster that are in the RUNNING state.

" - }, - "pendingTasksCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the cluster that are in the PENDING state.

" - }, - "activeServicesCount":{ - "shape":"Integer", - "documentation":"

The number of services that are running on the cluster in an ACTIVE state. You can view these services with ListServices.

" - }, - "statistics":{ - "shape":"Statistics", - "documentation":"

Additional information about your clusters that are separated by launch type, including:

  • runningEC2TasksCount

  • RunningFargateTasksCount

  • pendingEC2TasksCount

  • pendingFargateTasksCount

  • activeEC2ServiceCount

  • activeFargateServiceCount

  • drainingEC2ServiceCount

  • drainingFargateServiceCount

" - } - }, - "documentation":"

A regional grouping of one or more container instances on which you can run task requests. Each account receives a default cluster the first time you use the Amazon ECS service, but you may also create other clusters. Clusters may contain more than one instance type simultaneously.

" - }, - "ClusterContainsContainerInstancesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot delete a cluster that has registered container instances. You must first deregister the container instances before you can delete the cluster. For more information, see DeregisterContainerInstance.

", - "exception":true - }, - "ClusterContainsServicesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot delete a cluster that contains services. You must first update the service to reduce its desired task count to 0 and then delete the service. For more information, see UpdateService and DeleteService.

", - "exception":true - }, - "ClusterContainsTasksException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot delete a cluster that has active tasks.

", - "exception":true - }, - "ClusterField":{ - "type":"string", - "enum":["STATISTICS"] - }, - "ClusterFieldList":{ - "type":"list", - "member":{"shape":"ClusterField"} - }, - "ClusterNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified cluster could not be found. You can view your available clusters with ListClusters. Amazon ECS clusters are region-specific.

", - "exception":true - }, - "Clusters":{ - "type":"list", - "member":{"shape":"Cluster"} - }, - "Compatibility":{ - "type":"string", - "enum":[ - "EC2", - "FARGATE" - ] - }, - "CompatibilityList":{ - "type":"list", - "member":{"shape":"Compatibility"} - }, - "Connectivity":{ - "type":"string", - "enum":[ - "CONNECTED", - "DISCONNECTED" - ] - }, - "Container":{ - "type":"structure", - "members":{ - "containerArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the container.

" - }, - "taskArn":{ - "shape":"String", - "documentation":"

The ARN of the task.

" - }, - "name":{ - "shape":"String", - "documentation":"

The name of the container.

" - }, - "lastStatus":{ - "shape":"String", - "documentation":"

The last known status of the container.

" - }, - "exitCode":{ - "shape":"BoxedInteger", - "documentation":"

The exit code returned from the container.

" - }, - "reason":{ - "shape":"String", - "documentation":"

A short (255 max characters) human-readable string to provide additional details about a running or stopped container.

" - }, - "networkBindings":{ - "shape":"NetworkBindings", - "documentation":"

The network bindings associated with the container.

" - }, - "networkInterfaces":{ - "shape":"NetworkInterfaces", - "documentation":"

The network interfaces associated with the container.

" - }, - "healthStatus":{ - "shape":"HealthStatus", - "documentation":"

The health status of the container. If health checks are not configured for this container in its task definition, then it reports health status as UNKNOWN.

" - } - }, - "documentation":"

A Docker container that is part of a task.

" - }, - "ContainerDefinition":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of a container. If you are linking multiple containers together in a task definition, the name of one container can be entered in the links of another container to connect the containers. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. This parameter maps to name in the Create a container section of the Docker Remote API and the --name option to docker run.

" - }, - "image":{ - "shape":"String", - "documentation":"

The image used to start a container. This string is passed directly to the Docker daemon. Images in the Docker Hub registry are available by default. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest . Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed. This parameter maps to Image in the Create a container section of the Docker Remote API and the IMAGE parameter of docker run.

  • When a new task starts, the Amazon ECS container agent pulls the latest version of the specified image and tag for the container to use. However, subsequent updates to a repository image are not propagated to already running tasks.

  • Images in Amazon ECR repositories can be specified by either using the full registry/repository:tag or registry/repository@digest. For example, 012345678910.dkr.ecr.<region-name>.amazonaws.com/<repository-name>:latest or 012345678910.dkr.ecr.<region-name>.amazonaws.com/<repository-name>@sha256:94afd1f2e64d908bc90dbca0035a5b567EXAMPLE.

  • Images in official repositories on Docker Hub use a single name (for example, ubuntu or mongo).

  • Images in other repositories on Docker Hub are qualified with an organization name (for example, amazon/amazon-ecs-agent).

  • Images in other online repositories are qualified further by a domain name (for example, quay.io/assemblyline/ubuntu).

" - }, - "repositoryCredentials":{ - "shape":"RepositoryCredentials", - "documentation":"

The private repository authentication credentials to use.

" - }, - "cpu":{ - "shape":"Integer", - "documentation":"

The number of cpu units reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run.

This field is optional for tasks using the Fargate launch type, and the only requirement is that the total amount of CPU reserved for all containers within a task be lower than the task-level cpu value.

You can determine the number of CPU units that are available per EC2 instance type by multiplying the vCPUs listed for that instance type on the Amazon EC2 Instances detail page by 1,024.

For example, if you run a single-container task on a single-core instance type with 512 CPU units specified for that container, and that is the only task running on the container instance, that container could use the full 1,024 CPU unit share at any given time. However, if you launched another copy of the same task on that container instance, each task would be guaranteed a minimum of 512 CPU units when needed, and each container could float to higher CPU usage if the other container was not using it, but if both tasks were 100% active all of the time, they would be limited to 512 CPU units.

Linux containers share unallocated CPU units with other containers on the container instance with the same ratio as their allocated amount. For example, if you run a single-container task on a single-core instance type with 512 CPU units specified for that container, and that is the only task running on the container instance, that container could use the full 1,024 CPU unit share at any given time. However, if you launched another copy of the same task on that container instance, each task would be guaranteed a minimum of 512 CPU units when needed, and each container could float to higher CPU usage if the other container was not using it, but if both tasks were 100% active all of the time, they would be limited to 512 CPU units.

On Linux container instances, the Docker daemon on the container instance uses the CPU value to calculate the relative CPU share ratios for running containers. For more information, see CPU share constraint in the Docker documentation. The minimum valid CPU share value that the Linux kernel allows is 2; however, the CPU parameter is not required, and you can use CPU values below 2 in your container definitions. For CPU values below 2 (including null), the behavior varies based on your Amazon ECS container agent version:

  • Agent versions less than or equal to 1.1.0: Null and zero CPU values are passed to Docker as 0, which Docker then converts to 1,024 CPU shares. CPU values of 1 are passed to Docker as 1, which the Linux kernel converts to 2 CPU shares.

  • Agent versions greater than or equal to 1.2.0: Null, zero, and CPU values of 1 are passed to Docker as 2.

On Windows container instances, the CPU limit is enforced as an absolute limit, or a quota. Windows containers only have access to the specified amount of CPU that is described in the task definition.

" - }, - "memory":{ - "shape":"BoxedInteger", - "documentation":"

The hard limit (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

If your containers are part of a task using the Fargate launch type, this field is optional and the only requirement is that the total amount of memory reserved for all containers within a task be lower than the task memory value.

For containers that are part of a task using the EC2 launch type, you must specify a non-zero integer for one or both of memory or memoryReservation in container definitions. If you specify both, memory must be greater than memoryReservation. If you specify memoryReservation, then that value is subtracted from the available memory resources for the container instance on which the container is placed; otherwise, the value of memory is used.

The Docker daemon reserves a minimum of 4 MiB of memory for a container, so you should not specify fewer than 4 MiB of memory for your containers.

" - }, - "memoryReservation":{ - "shape":"BoxedInteger", - "documentation":"

The soft limit (in MiB) of memory to reserve for the container. When system memory is under heavy contention, Docker attempts to keep the container memory to this soft limit; however, your container can consume more memory when it needs to, up to either the hard limit specified with the memory parameter (if applicable), or all of the available memory on the container instance, whichever comes first. This parameter maps to MemoryReservation in the Create a container section of the Docker Remote API and the --memory-reservation option to docker run.

You must specify a non-zero integer for one or both of memory or memoryReservation in container definitions. If you specify both, memory must be greater than memoryReservation. If you specify memoryReservation, then that value is subtracted from the available memory resources for the container instance on which the container is placed; otherwise, the value of memory is used.

For example, if your container normally uses 128 MiB of memory, but occasionally bursts to 256 MiB of memory for short periods of time, you can set a memoryReservation of 128 MiB, and a memory hard limit of 300 MiB. This configuration would allow the container to only reserve 128 MiB of memory from the remaining resources on the container instance, but also allow the container to consume more memory resources when needed.

The Docker daemon reserves a minimum of 4 MiB of memory for a container, so you should not specify fewer than 4 MiB of memory for your containers.

" - }, - "links":{ - "shape":"StringList", - "documentation":"

The link parameter allows containers to communicate with each other without the need for port mappings. Only supported if the network mode of a task definition is set to bridge. The name:internalName construct is analogous to name:alias in Docker links. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. For more information about linking Docker containers, go to https://docs.docker.com/engine/userguide/networking/default_network/dockerlinks/. This parameter maps to Links in the Create a container section of the Docker Remote API and the --link option to docker run .

This parameter is not supported for Windows containers.

Containers that are collocated on a single container instance may be able to communicate with each other without requiring links or host port mappings. Network isolation is achieved on the container instance using security groups and VPC settings.

" - }, - "portMappings":{ - "shape":"PortMappingList", - "documentation":"

The list of port mappings for the container. Port mappings allow containers to access ports on the host container instance to send or receive traffic.

For task definitions that use the awsvpc network mode, you should only specify the containerPort. The hostPort can be left blank or it must be the same value as the containerPort.

Port mappings on Windows use the NetNAT gateway address rather than localhost. There is no loopback for port mappings on Windows, so you cannot access a container's mapped port from the host itself.

This parameter maps to PortBindings in the Create a container section of the Docker Remote API and the --publish option to docker run. If the network mode of a task definition is set to none, then you can't specify port mappings. If the network mode of a task definition is set to host, then host ports must either be undefined or they must match the container port in the port mapping.

After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the Network Bindings section of a container description for a selected task in the Amazon ECS console. The assignments are also visible in the networkBindings section DescribeTasks responses.

" - }, - "essential":{ - "shape":"BoxedBoolean", - "documentation":"

If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, then its failure does not affect the rest of the containers in a task. If this parameter is omitted, a container is assumed to be essential.

All tasks must have at least one essential container. If you have an application that is composed of multiple containers, you should group containers that are used for a common purpose into components, and separate the different components into multiple task definitions. For more information, see Application Architecture in the Amazon Elastic Container Service Developer Guide.

" - }, - "entryPoint":{ - "shape":"StringList", - "documentation":"

Early versions of the Amazon ECS container agent do not properly handle entryPoint parameters. If you have problems using entryPoint, update your container agent or enter your commands and arguments as command array items instead.

The entry point that is passed to the container. This parameter maps to Entrypoint in the Create a container section of the Docker Remote API and the --entrypoint option to docker run. For more information, see https://docs.docker.com/engine/reference/builder/#entrypoint.

" - }, - "command":{ - "shape":"StringList", - "documentation":"

The command that is passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see https://docs.docker.com/engine/reference/builder/#cmd.

" - }, - "environment":{ - "shape":"EnvironmentVariables", - "documentation":"

The environment variables to pass to a container. This parameter maps to Env in the Create a container section of the Docker Remote API and the --env option to docker run.

We do not recommend using plaintext environment variables for sensitive information, such as credential data.

" - }, - "mountPoints":{ - "shape":"MountPointList", - "documentation":"

The mount points for data volumes in your container.

This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers cannot mount directories on a different drive, and mount point cannot be across drives.

" - }, - "volumesFrom":{ - "shape":"VolumeFromList", - "documentation":"

Data volumes to mount from another container. This parameter maps to VolumesFrom in the Create a container section of the Docker Remote API and the --volumes-from option to docker run.

" - }, - "linuxParameters":{ - "shape":"LinuxParameters", - "documentation":"

Linux-specific modifications that are applied to the container, such as Linux KernelCapabilities.

This parameter is not supported for Windows containers.

" - }, - "hostname":{ - "shape":"String", - "documentation":"

The hostname to use for your container. This parameter maps to Hostname in the Create a container section of the Docker Remote API and the --hostname option to docker run.

The hostname parameter is not supported if using the awsvpc networkMode.

" - }, - "user":{ - "shape":"String", - "documentation":"

The user name to use inside the container. This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

This parameter is not supported for Windows containers.

" - }, - "workingDirectory":{ - "shape":"String", - "documentation":"

The working directory in which to run commands inside the container. This parameter maps to WorkingDir in the Create a container section of the Docker Remote API and the --workdir option to docker run.

" - }, - "disableNetworking":{ - "shape":"BoxedBoolean", - "documentation":"

When this parameter is true, networking is disabled within the container. This parameter maps to NetworkDisabled in the Create a container section of the Docker Remote API.

This parameter is not supported for Windows containers.

" - }, - "privileged":{ - "shape":"BoxedBoolean", - "documentation":"

When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user). This parameter maps to Privileged in the Create a container section of the Docker Remote API and the --privileged option to docker run.

This parameter is not supported for Windows containers or tasks using the Fargate launch type.

" - }, - "readonlyRootFilesystem":{ - "shape":"BoxedBoolean", - "documentation":"

When this parameter is true, the container is given read-only access to its root file system. This parameter maps to ReadonlyRootfs in the Create a container section of the Docker Remote API and the --read-only option to docker run.

This parameter is not supported for Windows containers.

" - }, - "dnsServers":{ - "shape":"StringList", - "documentation":"

A list of DNS servers that are presented to the container. This parameter maps to Dns in the Create a container section of the Docker Remote API and the --dns option to docker run.

This parameter is not supported for Windows containers.

" - }, - "dnsSearchDomains":{ - "shape":"StringList", - "documentation":"

A list of DNS search domains that are presented to the container. This parameter maps to DnsSearch in the Create a container section of the Docker Remote API and the --dns-search option to docker run.

This parameter is not supported for Windows containers.

" - }, - "extraHosts":{ - "shape":"HostEntryList", - "documentation":"

A list of hostnames and IP address mappings to append to the /etc/hosts file on the container. If using the Fargate launch type, this may be used to list non-Fargate hosts to which the container can talk. This parameter maps to ExtraHosts in the Create a container section of the Docker Remote API and the --add-host option to docker run.

This parameter is not supported for Windows containers.

" - }, - "dockerSecurityOptions":{ - "shape":"StringList", - "documentation":"

A list of strings to provide custom labels for SELinux and AppArmor multi-level security systems. This field is not valid for containers in tasks using the Fargate launch type.

This parameter maps to SecurityOpt in the Create a container section of the Docker Remote API and the --security-opt option to docker run.

The Amazon ECS container agent running on a container instance must register with the ECS_SELINUX_CAPABLE=true or ECS_APPARMOR_CAPABLE=true environment variables before containers placed on that instance can use these security options. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

This parameter is not supported for Windows containers.

" - }, - "dockerLabels":{ - "shape":"DockerLabelsMap", - "documentation":"

A key/value map of labels to add to the container. This parameter maps to Labels in the Create a container section of the Docker Remote API and the --label option to docker run. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

" - }, - "ulimits":{ - "shape":"UlimitList", - "documentation":"

A list of ulimits to set in the container. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run. Valid naming values are displayed in the Ulimit data type. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

This parameter is not supported for Windows containers.

" - }, - "logConfiguration":{ - "shape":"LogConfiguration", - "documentation":"

The log configuration specification for the container.

If using the Fargate launch type, the only supported value is awslogs.

This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run. By default, containers use the same logging driver that the Docker daemon uses; however the container may use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information on the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the LogConfiguration data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS environment variable before containers placed on that instance can use these log configuration options. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

" - }, - "healthCheck":{ - "shape":"HealthCheck", - "documentation":"

The health check command and associated configuration parameters for the container. This parameter maps to HealthCheck in the Create a container section of the Docker Remote API and the HEALTHCHECK parameter of docker run.

" - } - }, - "documentation":"

Container definitions are used in task definitions to describe the different containers that are launched as part of a task.

" - }, - "ContainerDefinitions":{ - "type":"list", - "member":{"shape":"ContainerDefinition"} - }, - "ContainerInstance":{ - "type":"structure", - "members":{ - "containerInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the container instance. The ARN contains the arn:aws:ecs namespace, followed by the Region of the container instance, the AWS account ID of the container instance owner, the container-instance namespace, and then the container instance ID. For example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID .

" - }, - "ec2InstanceId":{ - "shape":"String", - "documentation":"

The EC2 instance ID of the container instance.

" - }, - "version":{ - "shape":"Long", - "documentation":"

The version counter for the container instance. Every time a container instance experiences a change that triggers a CloudWatch event, the version counter is incremented. If you are replicating your Amazon ECS container instance state with CloudWatch Events, you can compare the version of a container instance reported by the Amazon ECS APIs with the version reported in CloudWatch Events for the container instance (inside the detail object) to verify that the version in your event stream is current.

" - }, - "versionInfo":{ - "shape":"VersionInfo", - "documentation":"

The version information for the Amazon ECS container agent and Docker daemon running on the container instance.

" - }, - "remainingResources":{ - "shape":"Resources", - "documentation":"

For CPU and memory resource types, this parameter describes the remaining CPU and memory that has not already been allocated to tasks and is therefore available for new tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent (at instance registration time) and any task containers that have reserved port mappings on the host (with the host or bridge network mode). Any port that is not specified here is available for new tasks.

" - }, - "registeredResources":{ - "shape":"Resources", - "documentation":"

For CPU and memory resource types, this parameter describes the amount of each resource that was available on the container instance when the container agent registered it with Amazon ECS; this value represents the total amount of CPU and memory that can be allocated on this container instance to tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent when it registered the container instance with Amazon ECS.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the container instance. The valid values are ACTIVE, INACTIVE, or DRAINING. ACTIVE indicates that the container instance can accept tasks. DRAINING indicates that new tasks are not placed on the container instance and any service tasks running on the container instance are removed if possible. For more information, see Container Instance Draining in the Amazon Elastic Container Service Developer Guide.

" - }, - "agentConnected":{ - "shape":"Boolean", - "documentation":"

This parameter returns true if the agent is connected to Amazon ECS. Registered instances with an agent that may be unhealthy or stopped return false. Only instances connected to an agent can accept placement requests.

" - }, - "runningTasksCount":{ - "shape":"Integer", - "documentation":"

The number of tasks on the container instance that are in the RUNNING status.

" - }, - "pendingTasksCount":{ - "shape":"Integer", - "documentation":"

The number of tasks on the container instance that are in the PENDING status.

" - }, - "agentUpdateStatus":{ - "shape":"AgentUpdateStatus", - "documentation":"

The status of the most recent agent update. If an update has never been requested, this value is NULL.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The attributes set for the container instance, either by the Amazon ECS container agent at instance registration or manually with the PutAttributes operation.

" - }, - "registeredAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the container instance was registered.

" - }, - "attachments":{ - "shape":"Attachments", - "documentation":"

The elastic network interfaces associated with the container instance.

" - } - }, - "documentation":"

An EC2 instance that is running the Amazon ECS agent and has been registered with a cluster.

" - }, - "ContainerInstanceStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "DRAINING" - ] - }, - "ContainerInstances":{ - "type":"list", - "member":{"shape":"ContainerInstance"} - }, - "ContainerOverride":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the container that receives the override. This parameter is required if any override is specified.

" - }, - "command":{ - "shape":"StringList", - "documentation":"

The command to send to the container that overrides the default command from the Docker image or the task definition. You must also specify a container name.

" - }, - "environment":{ - "shape":"EnvironmentVariables", - "documentation":"

The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the task definition. You must also specify a container name.

" - }, - "cpu":{ - "shape":"BoxedInteger", - "documentation":"

The number of cpu units reserved for the container, instead of the default value from the task definition. You must also specify a container name.

" - }, - "memory":{ - "shape":"BoxedInteger", - "documentation":"

The hard limit (in MiB) of memory to present to the container, instead of the default value from the task definition. If your container attempts to exceed the memory specified here, the container is killed. You must also specify a container name.

" - }, - "memoryReservation":{ - "shape":"BoxedInteger", - "documentation":"

The soft limit (in MiB) of memory to reserve for the container, instead of the default value from the task definition. You must also specify a container name.

" - } - }, - "documentation":"

The overrides that should be sent to a container.

" - }, - "ContainerOverrides":{ - "type":"list", - "member":{"shape":"ContainerOverride"} - }, - "ContainerStateChange":{ - "type":"structure", - "members":{ - "containerName":{ - "shape":"String", - "documentation":"

The name of the container.

" - }, - "exitCode":{ - "shape":"BoxedInteger", - "documentation":"

The exit code for the container, if the state change is a result of the container exiting.

" - }, - "networkBindings":{ - "shape":"NetworkBindings", - "documentation":"

Any network bindings associated with the container.

" - }, - "reason":{ - "shape":"String", - "documentation":"

The reason for the state change.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the container.

" - } - }, - "documentation":"

An object representing a change in state for a container.

" - }, - "ContainerStateChanges":{ - "type":"list", - "member":{"shape":"ContainerStateChange"} - }, - "Containers":{ - "type":"list", - "member":{"shape":"Container"} - }, - "CreateClusterRequest":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The name of your cluster. If you do not specify a name for your cluster, you create a cluster named default. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

" - } - } - }, - "CreateClusterResponse":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"Cluster", - "documentation":"

The full description of your new cluster.

" - } - } - }, - "CreateServiceRequest":{ - "type":"structure", - "required":[ - "serviceName", - "taskDefinition" - ], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster on which to run your service. If you do not specify a cluster, the default cluster is assumed.

" - }, - "serviceName":{ - "shape":"String", - "documentation":"

The name of your service. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a Region or across multiple Regions.

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The family and revision (family:revision) or full ARN of the task definition to run in your service. If a revision is not specified, the latest ACTIVE revision is used.

" - }, - "loadBalancers":{ - "shape":"LoadBalancers", - "documentation":"

A load balancer object representing the load balancer to use with your service. Currently, you are limited to one load balancer or target group per service. After you create a service, the load balancer name or target group ARN, container name, and container port specified in the service definition are immutable.

For Classic Load Balancers, this object must contain the load balancer name, the container name (as it appears in a container definition), and the container port to access from the load balancer. When a task from this service is placed on a container instance, the container instance is registered with the load balancer specified here.

For Application Load Balancers and Network Load Balancers, this object must contain the load balancer target group ARN, the container name (as it appears in a container definition), and the container port to access from the load balancer. When a task from this service is placed on a container instance, the container instance and port combination is registered as a target in the target group specified here.

Services with tasks that use the awsvpc network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers; Classic Load Balancers are not supported. Also, when you create any target groups for these services, you must choose ip as the target type, not instance, because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

" - }, - "serviceRegistries":{ - "shape":"ServiceRegistries", - "documentation":"

The details of the service discovery registries to assign to this service. For more information, see Service Discovery.

Service discovery is supported for Fargate tasks if using platform version v1.1.0 or later. For more information, see AWS Fargate Platform Versions.

" - }, - "desiredCount":{ - "shape":"BoxedInteger", - "documentation":"

The number of instantiations of the specified task definition to place and keep running on your cluster.

" - }, - "clientToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Up to 32 ASCII characters are allowed.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type on which to run your service.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version on which to run your service. If one is not specified, the latest version is used by default.

" - }, - "role":{ - "shape":"String", - "documentation":"

The name or full Amazon Resource Name (ARN) of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is only permitted if you are using a load balancer with your service and your task definition does not use the awsvpc network mode. If you specify the role parameter, you must also specify a load balancer object with the loadBalancers parameter.

If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. The service-linked role is required if your task definition uses the awsvpc network mode, in which case you should not specify a role here. For more information, see Using Service-Linked Roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

If your specified role has a path other than /, then you must either specify the full role ARN (this is recommended) or prefix the role name with the path. For example, if a role with the name bar has a path of /foo/ then you would specify /foo/bar as the role name. For more information, see Friendly Names and Paths in the IAM User Guide.

" - }, - "deploymentConfiguration":{ - "shape":"DeploymentConfiguration", - "documentation":"

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" - }, - "placementConstraints":{ - "shape":"PlacementConstraints", - "documentation":"

An array of placement constraint objects to use for tasks in your service. You can specify a maximum of 10 constraints per task (this limit includes constraints in the task definition and those specified at run time).

" - }, - "placementStrategy":{ - "shape":"PlacementStrategies", - "documentation":"

The placement strategy objects to use for tasks in your service. You can specify a maximum of five strategy rules per service.

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

" - }, - "healthCheckGracePeriodSeconds":{ - "shape":"BoxedInteger", - "documentation":"

The period of time, in seconds, that the Amazon ECS service scheduler should ignore unhealthy Elastic Load Balancing target health checks after a task has first started. This is only valid if your service is configured to use a load balancer. If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 7,200 seconds during which the ECS service scheduler ignores health check status. This grace period can prevent the ECS service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.

" - }, - "schedulingStrategy":{ - "shape":"SchedulingStrategy", - "documentation":"

The scheduling strategy to use for the service. For more information, see Services.

There are two service scheduler strategies available:

  • REPLICA-The replica scheduling strategy places and maintains the desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions.

  • DAEMON-The daemon scheduling strategy deploys exactly one task on each active container instance that meets all of the task placement constraints that you specify in your cluster. When using this strategy, there is no need to specify a desired number of tasks, a task placement strategy, or use Service Auto Scaling policies.

    Fargate tasks do not support the DAEMON scheduling strategy.

" - } - } - }, - "CreateServiceResponse":{ - "type":"structure", - "members":{ - "service":{ - "shape":"Service", - "documentation":"

The full description of your service following the create call.

" - } - } - }, - "DeleteAttributesRequest":{ - "type":"structure", - "required":["attributes"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that contains the resource to delete attributes. If you do not specify a cluster, the default cluster is assumed.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The attributes to delete from your resource. You can specify up to 10 attributes per request. For custom attributes, specify the attribute name and target ID, but do not specify the value. If you specify the target ID using the short form, you must also specify the target type.

" - } - } - }, - "DeleteAttributesResponse":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"Attributes", - "documentation":"

A list of attribute objects that were successfully deleted from your resource.

" - } - } - }, - "DeleteClusterRequest":{ - "type":"structure", - "required":["cluster"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster to delete.

" - } - } - }, - "DeleteClusterResponse":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"Cluster", - "documentation":"

The full description of the deleted cluster.

" - } - } - }, - "DeleteServiceRequest":{ - "type":"structure", - "required":["service"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to delete. If you do not specify a cluster, the default cluster is assumed.

" - }, - "service":{ - "shape":"String", - "documentation":"

The name of the service to delete.

" - }, - "force":{ - "shape":"BoxedBoolean", - "documentation":"

If true, allows you to delete a service even if it has not been scaled down to zero tasks. It is only necessary to use this if the service is using the REPLICA scheduling strategy.

" - } - } - }, - "DeleteServiceResponse":{ - "type":"structure", - "members":{ - "service":{ - "shape":"Service", - "documentation":"

The full description of the deleted service.

" - } - } - }, - "Deployment":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The ID of the deployment.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the deployment. Valid values are PRIMARY (for the most recent deployment), ACTIVE (for previous deployments that still have tasks running, but are being replaced with the PRIMARY deployment), and INACTIVE (for deployments that have been completely replaced).

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The most recent task definition that was specified for the service to use.

" - }, - "desiredCount":{ - "shape":"Integer", - "documentation":"

The most recent desired count of tasks that was specified for the service to deploy or maintain.

" - }, - "pendingCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the deployment that are in the PENDING status.

" - }, - "runningCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the deployment that are in the RUNNING status.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the service was created.

" - }, - "updatedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the service was last updated.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type on which your service is running.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version on which your service is running.

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

" - } - }, - "documentation":"

The details of an Amazon ECS service deployment.

" - }, - "DeploymentConfiguration":{ - "type":"structure", - "members":{ - "maximumPercent":{ - "shape":"BoxedInteger", - "documentation":"

The upper limit (as a percentage of the service's desiredCount) of the number of tasks that are allowed in the RUNNING or PENDING state in a service during a deployment. The maximum number of tasks during a deployment is the desiredCount multiplied by maximumPercent/100, rounded down to the nearest integer value.

" - }, - "minimumHealthyPercent":{ - "shape":"BoxedInteger", - "documentation":"

The lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain in the RUNNING state in a service during a deployment. The minimum number of healthy tasks during a deployment is the desiredCount multiplied by minimumHealthyPercent/100, rounded up to the nearest integer value.

" - } - }, - "documentation":"

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" - }, - "Deployments":{ - "type":"list", - "member":{"shape":"Deployment"} - }, - "DeregisterContainerInstanceRequest":{ - "type":"structure", - "required":["containerInstance"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instance to deregister. If you do not specify a cluster, the default cluster is assumed.

" - }, - "containerInstance":{ - "shape":"String", - "documentation":"

The container instance ID or full ARN of the container instance to deregister. The ARN contains the arn:aws:ecs namespace, followed by the Region of the container instance, the AWS account ID of the container instance owner, the container-instance namespace, and then the container instance ID. For example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID .

" - }, - "force":{ - "shape":"BoxedBoolean", - "documentation":"

Forces the deregistration of the container instance. If you have tasks running on the container instance when you deregister it with the force option, these tasks remain running until you terminate the instance or the tasks stop through some other means, but they are orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.

Any containers in orphaned service tasks that are registered with a Classic Load Balancer or an Application Load Balancer target group are deregistered. They begin connection draining according to the settings on the load balancer or target group.

" - } - } - }, - "DeregisterContainerInstanceResponse":{ - "type":"structure", - "members":{ - "containerInstance":{ - "shape":"ContainerInstance", - "documentation":"

The container instance that was deregistered.

" - } - } - }, - "DeregisterTaskDefinitionRequest":{ - "type":"structure", - "required":["taskDefinition"], - "members":{ - "taskDefinition":{ - "shape":"String", - "documentation":"

The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a revision.

" - } - } - }, - "DeregisterTaskDefinitionResponse":{ - "type":"structure", - "members":{ - "taskDefinition":{ - "shape":"TaskDefinition", - "documentation":"

The full description of the deregistered task.

" - } - } - }, - "DescribeClustersRequest":{ - "type":"structure", - "members":{ - "clusters":{ - "shape":"StringList", - "documentation":"

A list of up to 100 cluster names or full cluster Amazon Resource Name (ARN) entries. If you do not specify a cluster, the default cluster is assumed.

" - }, - "include":{ - "shape":"ClusterFieldList", - "documentation":"

Additional information about your clusters to be separated by launch type, including:

  • runningEC2TasksCount

  • runningFargateTasksCount

  • pendingEC2TasksCount

  • pendingFargateTasksCount

  • activeEC2ServiceCount

  • activeFargateServiceCount

  • drainingEC2ServiceCount

  • drainingFargateServiceCount

" - } - } - }, - "DescribeClustersResponse":{ - "type":"structure", - "members":{ - "clusters":{ - "shape":"Clusters", - "documentation":"

The list of clusters.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "DescribeContainerInstancesRequest":{ - "type":"structure", - "required":["containerInstances"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to describe. If you do not specify a cluster, the default cluster is assumed.

" - }, - "containerInstances":{ - "shape":"StringList", - "documentation":"

A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) entries.

" - } - } - }, - "DescribeContainerInstancesResponse":{ - "type":"structure", - "members":{ - "containerInstances":{ - "shape":"ContainerInstances", - "documentation":"

The list of container instances.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "DescribeServicesRequest":{ - "type":"structure", - "required":["services"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN)the cluster that hosts the service to describe. If you do not specify a cluster, the default cluster is assumed.

" - }, - "services":{ - "shape":"StringList", - "documentation":"

A list of services to describe. You may specify up to 10 services to describe in a single operation.

" - } - } - }, - "DescribeServicesResponse":{ - "type":"structure", - "members":{ - "services":{ - "shape":"Services", - "documentation":"

The list of services described.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "DescribeTaskDefinitionRequest":{ - "type":"structure", - "required":["taskDefinition"], - "members":{ - "taskDefinition":{ - "shape":"String", - "documentation":"

The family for the latest ACTIVE revision, family and revision (family:revision) for a specific revision in the family, or full Amazon Resource Name (ARN) of the task definition to describe.

" - } - } - }, - "DescribeTaskDefinitionResponse":{ - "type":"structure", - "members":{ - "taskDefinition":{ - "shape":"TaskDefinition", - "documentation":"

The full task definition description.

" - } - } - }, - "DescribeTasksRequest":{ - "type":"structure", - "required":["tasks"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task to describe. If you do not specify a cluster, the default cluster is assumed.

" - }, - "tasks":{ - "shape":"StringList", - "documentation":"

A list of up to 100 task IDs or full ARN entries.

" - } - } - }, - "DescribeTasksResponse":{ - "type":"structure", - "members":{ - "tasks":{ - "shape":"Tasks", - "documentation":"

The list of tasks.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "DesiredStatus":{ - "type":"string", - "enum":[ - "RUNNING", - "PENDING", - "STOPPED" - ] - }, - "Device":{ - "type":"structure", - "required":["hostPath"], - "members":{ - "hostPath":{ - "shape":"String", - "documentation":"

The path for the device on the host container instance.

" - }, - "containerPath":{ - "shape":"String", - "documentation":"

The path inside the container at which to expose the host device.

" - }, - "permissions":{ - "shape":"DeviceCgroupPermissions", - "documentation":"

The explicit permissions to provide to the container for the device. By default, the container has permissions for read, write, and mknod for the device.

" - } - }, - "documentation":"

An object representing a container instance host device.

" - }, - "DeviceCgroupPermission":{ - "type":"string", - "enum":[ - "read", - "write", - "mknod" - ] - }, - "DeviceCgroupPermissions":{ - "type":"list", - "member":{"shape":"DeviceCgroupPermission"} - }, - "DevicesList":{ - "type":"list", - "member":{"shape":"Device"} - }, - "DiscoverPollEndpointRequest":{ - "type":"structure", - "members":{ - "containerInstance":{ - "shape":"String", - "documentation":"

The container instance ID or full ARN of the container instance. The ARN contains the arn:aws:ecs namespace, followed by the Region of the container instance, the AWS account ID of the container instance owner, the container-instance namespace, and then the container instance ID. For example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID .

" - }, - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that the container instance belongs to.

" - } - } - }, - "DiscoverPollEndpointResponse":{ - "type":"structure", - "members":{ - "endpoint":{ - "shape":"String", - "documentation":"

The endpoint for the Amazon ECS agent to poll.

" - }, - "telemetryEndpoint":{ - "shape":"String", - "documentation":"

The telemetry endpoint for the Amazon ECS agent.

" - } - } - }, - "DockerLabelsMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "DockerVolumeConfiguration":{ - "type":"structure", - "members":{ - "scope":{ - "shape":"Scope", - "documentation":"

The scope for the Docker volume which determines it's lifecycle. Docker volumes that are scoped to a task are automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped as shared persist after the task stops.

" - }, - "autoprovision":{ - "shape":"BoxedBoolean", - "documentation":"

If this value is true, the Docker volume is created if it does not already exist.

This field is only used if the scope is shared.

" - }, - "driver":{ - "shape":"String", - "documentation":"

The Docker volume driver to use. The driver value must match the driver name provided by Docker because it is used for task placement. If the driver was installed using the Docker plugin CLI, use docker plugin ls to retrieve the driver name from your container instance. If the driver was installed using another method, use Docker plugin discovery to retrieve the driver name. For more information, see Docker plugin discovery. This parameter maps to Driver in the Create a volume section of the Docker Remote API and the xxdriver option to docker volume create .

" - }, - "driverOpts":{ - "shape":"StringMap", - "documentation":"

A map of Docker driver specific options passed through. This parameter maps to DriverOpts in the Create a volume section of the Docker Remote API and the xxopt option to docker volume create .

" - }, - "labels":{ - "shape":"StringMap", - "documentation":"

Custom metadata to add to your Docker volume. This parameter maps to Labels in the Create a volume section of the Docker Remote API and the xxlabel option to docker volume create .

" - } - }, - "documentation":"

The configuration for the Docker volume. This parameter is specified when using Docker volumes.

" - }, - "Double":{"type":"double"}, - "EnvironmentVariables":{ - "type":"list", - "member":{"shape":"KeyValuePair"} - }, - "Failure":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the failed resource.

" - }, - "reason":{ - "shape":"String", - "documentation":"

The reason for the failure.

" - } - }, - "documentation":"

A failed resource.

" - }, - "Failures":{ - "type":"list", - "member":{"shape":"Failure"} - }, - "HealthCheck":{ - "type":"structure", - "required":["command"], - "members":{ - "command":{ - "shape":"StringList", - "documentation":"

A string array representing the command that the container runs to determine if it is healthy. The string array must start with CMD to execute the command arguments directly, or CMD-SHELL to run the command with the container's default shell. For example:

[ \"CMD-SHELL\", \"curl -f http://localhost/ || exit 1\" ]

An exit code of 0 indicates success, and non-zero exit code indicates failure. For more information, see HealthCheck in the Create a container section of the Docker Remote API.

" - }, - "interval":{ - "shape":"BoxedInteger", - "documentation":"

The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.

" - }, - "timeout":{ - "shape":"BoxedInteger", - "documentation":"

The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5.

" - }, - "retries":{ - "shape":"BoxedInteger", - "documentation":"

The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is 3.

" - }, - "startPeriod":{ - "shape":"BoxedInteger", - "documentation":"

The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.

If a health check succeeds within the startPeriod, then the container is considered healthy and any subsequent failures count toward the maximum number of retries.

" - } - }, - "documentation":"

An object representing a container health check. Health check parameters that are specified in a container definition override any Docker health checks that exist in the container image (such as those specified in a parent image or from the image's Dockerfile).

" - }, - "HealthStatus":{ - "type":"string", - "enum":[ - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - }, - "HostEntry":{ - "type":"structure", - "required":[ - "hostname", - "ipAddress" - ], - "members":{ - "hostname":{ - "shape":"String", - "documentation":"

The hostname to use in the /etc/hosts entry.

" - }, - "ipAddress":{ - "shape":"String", - "documentation":"

The IP address to use in the /etc/hosts entry.

" - } - }, - "documentation":"

Hostnames and IP address entries that are added to the /etc/hosts file of a container via the extraHosts parameter of its ContainerDefinition.

" - }, - "HostEntryList":{ - "type":"list", - "member":{"shape":"HostEntry"} - }, - "HostVolumeProperties":{ - "type":"structure", - "members":{ - "sourcePath":{ - "shape":"String", - "documentation":"

When the host parameter is used, specify a sourcePath to declare the path on the host container instance that is presented to the container. If this parameter is empty, then the Docker daemon has assigned a host path for you. If the host parameter contains a sourcePath file location, then the data volume persists at the specified location on the host container instance until you delete it manually. If the sourcePath value does not exist on the host container instance, the Docker daemon creates it. If the location does exist, the contents of the source path folder are exported.

If you are using the Fargate launch type, the sourcePath parameter is not supported.

" - } - }, - "documentation":"

Details on a container instance bind mount host volume.

" - }, - "Integer":{"type":"integer"}, - "InvalidParameterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified parameter is invalid. Review the available parameters for the API request.

", - "exception":true - }, - "KernelCapabilities":{ - "type":"structure", - "members":{ - "add":{ - "shape":"StringList", - "documentation":"

The Linux capabilities for the container that have been added to the default configuration provided by Docker. This parameter maps to CapAdd in the Create a container section of the Docker Remote API and the --cap-add option to docker run.

If you are using tasks that use the Fargate launch type, the add parameter is not supported.

Valid values: \"ALL\" | \"AUDIT_CONTROL\" | \"AUDIT_WRITE\" | \"BLOCK_SUSPEND\" | \"CHOWN\" | \"DAC_OVERRIDE\" | \"DAC_READ_SEARCH\" | \"FOWNER\" | \"FSETID\" | \"IPC_LOCK\" | \"IPC_OWNER\" | \"KILL\" | \"LEASE\" | \"LINUX_IMMUTABLE\" | \"MAC_ADMIN\" | \"MAC_OVERRIDE\" | \"MKNOD\" | \"NET_ADMIN\" | \"NET_BIND_SERVICE\" | \"NET_BROADCAST\" | \"NET_RAW\" | \"SETFCAP\" | \"SETGID\" | \"SETPCAP\" | \"SETUID\" | \"SYS_ADMIN\" | \"SYS_BOOT\" | \"SYS_CHROOT\" | \"SYS_MODULE\" | \"SYS_NICE\" | \"SYS_PACCT\" | \"SYS_PTRACE\" | \"SYS_RAWIO\" | \"SYS_RESOURCE\" | \"SYS_TIME\" | \"SYS_TTY_CONFIG\" | \"SYSLOG\" | \"WAKE_ALARM\"

" - }, - "drop":{ - "shape":"StringList", - "documentation":"

The Linux capabilities for the container that have been removed from the default configuration provided by Docker. This parameter maps to CapDrop in the Create a container section of the Docker Remote API and the --cap-drop option to docker run.

Valid values: \"ALL\" | \"AUDIT_CONTROL\" | \"AUDIT_WRITE\" | \"BLOCK_SUSPEND\" | \"CHOWN\" | \"DAC_OVERRIDE\" | \"DAC_READ_SEARCH\" | \"FOWNER\" | \"FSETID\" | \"IPC_LOCK\" | \"IPC_OWNER\" | \"KILL\" | \"LEASE\" | \"LINUX_IMMUTABLE\" | \"MAC_ADMIN\" | \"MAC_OVERRIDE\" | \"MKNOD\" | \"NET_ADMIN\" | \"NET_BIND_SERVICE\" | \"NET_BROADCAST\" | \"NET_RAW\" | \"SETFCAP\" | \"SETGID\" | \"SETPCAP\" | \"SETUID\" | \"SYS_ADMIN\" | \"SYS_BOOT\" | \"SYS_CHROOT\" | \"SYS_MODULE\" | \"SYS_NICE\" | \"SYS_PACCT\" | \"SYS_PTRACE\" | \"SYS_RAWIO\" | \"SYS_RESOURCE\" | \"SYS_TIME\" | \"SYS_TTY_CONFIG\" | \"SYSLOG\" | \"WAKE_ALARM\"

" - } - }, - "documentation":"

The Linux capabilities for the container that are added to or dropped from the default configuration provided by Docker. For more information on the default capabilities and the non-default available capabilities, see Runtime privilege and Linux capabilities in the Docker run reference. For more detailed information on these Linux capabilities, see the capabilities(7) Linux manual page.

" - }, - "KeyValuePair":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the key value pair. For environment variables, this is the name of the environment variable.

" - }, - "value":{ - "shape":"String", - "documentation":"

The value of the key value pair. For environment variables, this is the value of the environment variable.

" - } - }, - "documentation":"

A key and value pair object.

" - }, - "LaunchType":{ - "type":"string", - "enum":[ - "EC2", - "FARGATE" - ] - }, - "LinuxParameters":{ - "type":"structure", - "members":{ - "capabilities":{ - "shape":"KernelCapabilities", - "documentation":"

The Linux capabilities for the container that are added to or dropped from the default configuration provided by Docker.

If you are using tasks that use the Fargate launch type, capabilities is supported but the add parameter is not supported.

" - }, - "devices":{ - "shape":"DevicesList", - "documentation":"

Any host devices to expose to the container. This parameter maps to Devices in the Create a container section of the Docker Remote API and the --device option to docker run.

If you are using tasks that use the Fargate launch type, the devices parameter is not supported.

" - }, - "initProcessEnabled":{ - "shape":"BoxedBoolean", - "documentation":"

Run an init process inside the container that forwards signals and reaps processes. This parameter maps to the --init option to docker run. This parameter requires version 1.25 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

" - }, - "sharedMemorySize":{ - "shape":"BoxedInteger", - "documentation":"

The value for the size (in MiB) of the /dev/shm volume. This parameter maps to the --shm-size option to docker run.

If you are using tasks that use the Fargate launch type, the sharedMemorySize parameter is not supported.

" - }, - "tmpfs":{ - "shape":"TmpfsList", - "documentation":"

The container path, mount options, and size (in MiB) of the tmpfs mount. This parameter maps to the --tmpfs option to docker run.

If you are using tasks that use the Fargate launch type, the tmpfs parameter is not supported.

" - } - }, - "documentation":"

Linux-specific options that are applied to the container, such as Linux KernelCapabilities.

" - }, - "ListAttributesRequest":{ - "type":"structure", - "required":["targetType"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster to list attributes. If you do not specify a cluster, the default cluster is assumed.

" - }, - "targetType":{ - "shape":"TargetType", - "documentation":"

The type of the target with which to list attributes.

" - }, - "attributeName":{ - "shape":"String", - "documentation":"

The name of the attribute with which to filter the results.

" - }, - "attributeValue":{ - "shape":"String", - "documentation":"

The value of the attribute with which to filter results. You must also specify an attribute name to use this parameter.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListAttributes request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of cluster results returned by ListAttributes in paginated output. When this parameter is used, ListAttributes only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAttributes request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListAttributes returns up to 100 results and a nextToken value if applicable.

" - } - } - }, - "ListAttributesResponse":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"Attributes", - "documentation":"

A list of attribute objects that meet the criteria of the request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListAttributes request. When the results of a ListAttributes request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListClustersRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListClusters request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of cluster results returned by ListClusters in paginated output. When this parameter is used, ListClusters only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListClusters request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListClusters returns up to 100 results and a nextToken value if applicable.

" - } - } - }, - "ListClustersResponse":{ - "type":"structure", - "members":{ - "clusterArns":{ - "shape":"StringList", - "documentation":"

The list of full Amazon Resource Name (ARN) entries for each cluster associated with your account.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListClusters request. When the results of a ListClusters request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListContainerInstancesRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed.

" - }, - "filter":{ - "shape":"String", - "documentation":"

You can filter the results of a ListContainerInstances operation with cluster query language statements. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListContainerInstances request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of container instance results returned by ListContainerInstances in paginated output. When this parameter is used, ListContainerInstances only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListContainerInstances request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListContainerInstances returns up to 100 results and a nextToken value if applicable.

" - }, - "status":{ - "shape":"ContainerInstanceStatus", - "documentation":"

Filters the container instances by status. For example, if you specify the DRAINING status, the results include only container instances that have been set to DRAINING using UpdateContainerInstancesState. If you do not specify this parameter, the default is to include container instances set to ACTIVE and DRAINING.

" - } - } - }, - "ListContainerInstancesResponse":{ - "type":"structure", - "members":{ - "containerInstanceArns":{ - "shape":"StringList", - "documentation":"

The list of container instances with full ARN entries for each container instance associated with the specified cluster.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListContainerInstances request. When the results of a ListContainerInstances request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListServicesRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the services to list. If you do not specify a cluster, the default cluster is assumed.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListServices request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of service results returned by ListServices in paginated output. When this parameter is used, ListServices only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServices request with the returned nextToken value. This value can be between 1 and 10. If this parameter is not used, then ListServices returns up to 10 results and a nextToken value if applicable.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type for the services to list.

" - }, - "schedulingStrategy":{ - "shape":"SchedulingStrategy", - "documentation":"

The scheduling strategy for services to list.

" - } - } - }, - "ListServicesResponse":{ - "type":"structure", - "members":{ - "serviceArns":{ - "shape":"StringList", - "documentation":"

The list of full ARN entries for each service associated with the specified cluster.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListServices request. When the results of a ListServices request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListTaskDefinitionFamiliesRequest":{ - "type":"structure", - "members":{ - "familyPrefix":{ - "shape":"String", - "documentation":"

The familyPrefix is a string that is used to filter the results of ListTaskDefinitionFamilies. If you specify a familyPrefix, only task definition family names that begin with the familyPrefix string are returned.

" - }, - "status":{ - "shape":"TaskDefinitionFamilyStatus", - "documentation":"

The task definition family status with which to filter the ListTaskDefinitionFamilies results. By default, both ACTIVE and INACTIVE task definition families are listed. If this parameter is set to ACTIVE, only task definition families that have an ACTIVE task definition revision are returned. If this parameter is set to INACTIVE, only task definition families that do not have any ACTIVE task definition revisions are returned. If you paginate the resulting output, be sure to keep the status value constant in each subsequent request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListTaskDefinitionFamilies request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of task definition family results returned by ListTaskDefinitionFamilies in paginated output. When this parameter is used, ListTaskDefinitions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTaskDefinitionFamilies request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListTaskDefinitionFamilies returns up to 100 results and a nextToken value if applicable.

" - } - } - }, - "ListTaskDefinitionFamiliesResponse":{ - "type":"structure", - "members":{ - "families":{ - "shape":"StringList", - "documentation":"

The list of task definition family names that match the ListTaskDefinitionFamilies request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListTaskDefinitionFamilies request. When the results of a ListTaskDefinitionFamilies request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListTaskDefinitionsRequest":{ - "type":"structure", - "members":{ - "familyPrefix":{ - "shape":"String", - "documentation":"

The full family name with which to filter the ListTaskDefinitions results. Specifying a familyPrefix limits the listed task definitions to task definition revisions that belong to that family.

" - }, - "status":{ - "shape":"TaskDefinitionStatus", - "documentation":"

The task definition status with which to filter the ListTaskDefinitions results. By default, only ACTIVE task definitions are listed. By setting this parameter to INACTIVE, you can view task definitions that are INACTIVE as long as an active task or service still references them. If you paginate the resulting output, be sure to keep the status value constant in each subsequent request.

" - }, - "sort":{ - "shape":"SortOrder", - "documentation":"

The order in which to sort the results. Valid values are ASC and DESC. By default (ASC), task definitions are listed lexicographically by family name and in ascending numerical order by revision so that the newest task definitions in a family are listed last. Setting this parameter to DESC reverses the sort order on family name and revision so that the newest task definitions in a family are listed first.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListTaskDefinitions request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of task definition results returned by ListTaskDefinitions in paginated output. When this parameter is used, ListTaskDefinitions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTaskDefinitions request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListTaskDefinitions returns up to 100 results and a nextToken value if applicable.

" - } - } - }, - "ListTaskDefinitionsResponse":{ - "type":"structure", - "members":{ - "taskDefinitionArns":{ - "shape":"StringList", - "documentation":"

The list of task definition Amazon Resource Name (ARN) entries for the ListTaskDefinitions request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListTaskDefinitions request. When the results of a ListTaskDefinitions request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ListTasksRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the tasks to list. If you do not specify a cluster, the default cluster is assumed.

" - }, - "containerInstance":{ - "shape":"String", - "documentation":"

The container instance ID or full ARN of the container instance with which to filter the ListTasks results. Specifying a containerInstance limits the results to tasks that belong to that container instance.

" - }, - "family":{ - "shape":"String", - "documentation":"

The name of the family with which to filter the ListTasks results. Specifying a family limits the results to tasks that belong to that family.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListTasks request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

" - }, - "maxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of task results returned by ListTasks in paginated output. When this parameter is used, ListTasks only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTasks request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListTasks returns up to 100 results and a nextToken value if applicable.

" - }, - "startedBy":{ - "shape":"String", - "documentation":"

The startedBy value with which to filter the task results. Specifying a startedBy value limits the results to tasks that were started with that value.

" - }, - "serviceName":{ - "shape":"String", - "documentation":"

The name of the service with which to filter the ListTasks results. Specifying a serviceName limits the results to tasks that belong to that service.

" - }, - "desiredStatus":{ - "shape":"DesiredStatus", - "documentation":"

The task desired status with which to filter the ListTasks results. Specifying a desiredStatus of STOPPED limits the results to tasks that Amazon ECS has set the desired status to STOPPED, which can be useful for debugging tasks that are not starting properly or have died or finished. The default status filter is RUNNING, which shows tasks that Amazon ECS has set the desired status to RUNNING.

Although you can filter results based on a desired status of PENDING, this does not return any results because Amazon ECS never sets the desired status of a task to that value (only a task's lastStatus may have a value of PENDING).

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type for services to list.

" - } - } - }, - "ListTasksResponse":{ - "type":"structure", - "members":{ - "taskArns":{ - "shape":"StringList", - "documentation":"

The list of task ARN entries for the ListTasks request.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListTasks request. When the results of a ListTasks request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "LoadBalancer":{ - "type":"structure", - "members":{ - "targetGroupArn":{ - "shape":"String", - "documentation":"

The full Amazon Resource Name (ARN) of the Elastic Load Balancing target group associated with a service.

If your service's task definition uses the awsvpc network mode (which is required for the Fargate launch type), you must choose ip as the target type, not instance, because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

" - }, - "loadBalancerName":{ - "shape":"String", - "documentation":"

The name of a load balancer.

" - }, - "containerName":{ - "shape":"String", - "documentation":"

The name of the container (as it appears in a container definition) to associate with the load balancer.

" - }, - "containerPort":{ - "shape":"BoxedInteger", - "documentation":"

The port on the container to associate with the load balancer. This port must correspond to a containerPort in the service's task definition. Your container instances must allow ingress traffic on the hostPort of the port mapping.

" - } - }, - "documentation":"

Details on a load balancer that is used with a service.

Services with tasks that use the awsvpc network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers; Classic Load Balancers are not supported. Also, when you create any target groups for these services, you must choose ip as the target type, not instance, because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

" - }, - "LoadBalancers":{ - "type":"list", - "member":{"shape":"LoadBalancer"} - }, - "LogConfiguration":{ - "type":"structure", - "required":["logDriver"], - "members":{ - "logDriver":{ - "shape":"LogDriver", - "documentation":"

The log driver to use for the container. The valid values listed for this parameter are log drivers that the Amazon ECS container agent can communicate with by default. If using the Fargate launch type, the only supported value is awslogs. For more information about using the awslogs driver, see Using the awslogs Log Driver in the Amazon Elastic Container Service Developer Guide.

If you have a custom driver that is not listed above that you would like to work with the Amazon ECS container agent, you can fork the Amazon ECS container agent project that is available on GitHub and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, Amazon Web Services does not currently support running modified copies of this software.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

" - }, - "options":{ - "shape":"LogConfigurationOptionsMap", - "documentation":"

The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version | grep \"Server API version\"

" - } - }, - "documentation":"

Log configuration options to send to a custom log driver for the container.

" - }, - "LogConfigurationOptionsMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "LogDriver":{ - "type":"string", - "enum":[ - "json-file", - "syslog", - "journald", - "gelf", - "fluentd", - "awslogs", - "splunk" - ] - }, - "Long":{"type":"long"}, - "MissingVersionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Amazon ECS is unable to determine the current version of the Amazon ECS container agent on the container instance and does not have enough information to proceed with an update. This could be because the agent running on the container instance is an older or custom version that does not use our version information.

", - "exception":true - }, - "MountPoint":{ - "type":"structure", - "members":{ - "sourceVolume":{ - "shape":"String", - "documentation":"

The name of the volume to mount. Must be a volume name referenced in the name parameter of task definition volume.

" - }, - "containerPath":{ - "shape":"String", - "documentation":"

The path on the container to mount the host volume at.

" - }, - "readOnly":{ - "shape":"BoxedBoolean", - "documentation":"

If this value is true, the container has read-only access to the volume. If this value is false, then the container can write to the volume. The default value is false.

" - } - }, - "documentation":"

Details on a volume mount point that is used in a container definition.

" - }, - "MountPointList":{ - "type":"list", - "member":{"shape":"MountPoint"} - }, - "NetworkBinding":{ - "type":"structure", - "members":{ - "bindIP":{ - "shape":"String", - "documentation":"

The IP address that the container is bound to on the container instance.

" - }, - "containerPort":{ - "shape":"BoxedInteger", - "documentation":"

The port number on the container that is used with the network binding.

" - }, - "hostPort":{ - "shape":"BoxedInteger", - "documentation":"

The port number on the host that is used with the network binding.

" - }, - "protocol":{ - "shape":"TransportProtocol", - "documentation":"

The protocol used for the network binding.

" - } - }, - "documentation":"

Details on the network bindings between a container and its host container instance. After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.

" - }, - "NetworkBindings":{ - "type":"list", - "member":{"shape":"NetworkBinding"} - }, - "NetworkConfiguration":{ - "type":"structure", - "members":{ - "awsvpcConfiguration":{ - "shape":"AwsVpcConfiguration", - "documentation":"

The VPC subnets and security groups associated with a task.

All specified subnets and security groups must be from the same VPC.

" - } - }, - "documentation":"

An object representing the network configuration for a task or service.

" - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "attachmentId":{ - "shape":"String", - "documentation":"

The attachment ID for the network interface.

" - }, - "privateIpv4Address":{ - "shape":"String", - "documentation":"

The private IPv4 address for the network interface.

" - }, - "ipv6Address":{ - "shape":"String", - "documentation":"

The private IPv6 address for the network interface.

" - } - }, - "documentation":"

An object representing the elastic network interface for tasks that use the awsvpc network mode.

" - }, - "NetworkInterfaces":{ - "type":"list", - "member":{"shape":"NetworkInterface"} - }, - "NetworkMode":{ - "type":"string", - "enum":[ - "bridge", - "host", - "awsvpc", - "none" - ] - }, - "NoUpdateAvailableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is no update available for this Amazon ECS container agent. This could be because the agent is already running the latest version, or it is so old that there is no update path to the current version.

", - "exception":true - }, - "PlacementConstraint":{ - "type":"structure", - "members":{ - "type":{ - "shape":"PlacementConstraintType", - "documentation":"

The type of constraint. Use distinctInstance to ensure that each task in a particular group is running on a different container instance. Use memberOf to restrict the selection to a group of valid candidates. The value distinctInstance is not supported in task definitions.

" - }, - "expression":{ - "shape":"String", - "documentation":"

A cluster query language expression to apply to the constraint. You cannot specify an expression if the constraint type is distinctInstance. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "documentation":"

An object representing a constraint on task placement. For more information, see Task Placement Constraints in the Amazon Elastic Container Service Developer Guide.

" - }, - "PlacementConstraintType":{ - "type":"string", - "enum":[ - "distinctInstance", - "memberOf" - ] - }, - "PlacementConstraints":{ - "type":"list", - "member":{"shape":"PlacementConstraint"} - }, - "PlacementStrategies":{ - "type":"list", - "member":{"shape":"PlacementStrategy"} - }, - "PlacementStrategy":{ - "type":"structure", - "members":{ - "type":{ - "shape":"PlacementStrategyType", - "documentation":"

The type of placement strategy. The random placement strategy randomly places tasks on available candidates. The spread placement strategy spreads placement across available candidates evenly based on the field parameter. The binpack strategy places tasks on available candidates that have the least available amount of the resource that is specified with the field parameter. For example, if you binpack on memory, a task is placed on the instance with the least amount of remaining memory (but still enough to run the task).

" - }, - "field":{ - "shape":"String", - "documentation":"

The field to apply the placement strategy against. For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance, such as attribute:ecs.availability-zone. For the binpack placement strategy, valid values are cpu and memory. For the random placement strategy, this field is not used.

" - } - }, - "documentation":"

The task placement strategy for a task or service. For more information, see Task Placement Strategies in the Amazon Elastic Container Service Developer Guide.

" - }, - "PlacementStrategyType":{ - "type":"string", - "enum":[ - "random", - "spread", - "binpack" - ] - }, - "PlatformTaskDefinitionIncompatibilityException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified platform version does not satisfy the task definition's required capabilities.

", - "exception":true - }, - "PlatformUnknownException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified platform version does not exist.

", - "exception":true - }, - "PortMapping":{ - "type":"structure", - "members":{ - "containerPort":{ - "shape":"BoxedInteger", - "documentation":"

The port number on the container that is bound to the user-specified or automatically assigned host port.

If using containers in a task with the awsvpc or host network mode, exposed ports should be specified using containerPort.

If using containers in a task with the bridge network mode and you specify a container port and not a host port, your container automatically receives a host port in the ephemeral port range (for more information, see hostPort). Port mappings that are automatically assigned in this way do not count toward the 100 reserved ports limit of a container instance.

" - }, - "hostPort":{ - "shape":"BoxedInteger", - "documentation":"

The port number on the container instance to reserve for your container.

If using containers in a task with the awsvpc or host network mode, the hostPort can either be left blank or set to the same value as the containerPort.

If using containers in a task with the bridge network mode, you can specify a non-reserved host port for your container port mapping, or you can omit the hostPort (or set it to 0) while specifying a containerPort and your container automatically receives a port in the ephemeral port range for your container instance operating system and Docker version.

The default ephemeral port range for Docker version 1.6.0 and later is listed on the instance under /proc/sys/net/ipv4/ip_local_port_range; if this kernel parameter is unavailable, the default ephemeral port range from 49153 through 65535 is used. You should not attempt to specify a host port in the ephemeral port range as these are reserved for automatic assignment. In general, ports below 32768 are outside of the ephemeral port range.

The default ephemeral port range from 49153 through 65535 is always used for Docker versions before 1.6.0.

The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, and the Amazon ECS container agent ports 51678 and 51679. Any host port that was previously specified in a running task is also reserved while the task is running (after a task stops, the host port is released). The current reserved ports are displayed in the remainingResources of DescribeContainerInstances output, and a container instance may have up to 100 reserved ports at a time, including the default reserved ports (automatically assigned ports do not count toward the 100 reserved ports limit).

" - }, - "protocol":{ - "shape":"TransportProtocol", - "documentation":"

The protocol used for the port mapping. Valid values are tcp and udp. The default is tcp.

" - } - }, - "documentation":"

Port mappings allow containers to access ports on the host container instance to send or receive traffic. Port mappings are specified as part of the container definition.

If using containers in a task with the awsvpc or host network mode, exposed ports should be specified using containerPort. The hostPort can be left blank or it must be the same value as the containerPort.

After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.

" - }, - "PortMappingList":{ - "type":"list", - "member":{"shape":"PortMapping"} - }, - "PutAttributesRequest":{ - "type":"structure", - "required":["attributes"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that contains the resource to apply attributes. If you do not specify a cluster, the default cluster is assumed.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The attributes to apply to your resource. You can specify up to 10 custom attributes per resource. You can specify up to 10 attributes in a single call.

" - } - } - }, - "PutAttributesResponse":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"Attributes", - "documentation":"

The attributes applied to your resource.

" - } - } - }, - "RegisterContainerInstanceRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster with which to register your container instance. If you do not specify a cluster, the default cluster is assumed.

" - }, - "instanceIdentityDocument":{ - "shape":"String", - "documentation":"

The instance identity document for the EC2 instance to register. This document can be found by running the following command from the instance: curl http://169.254.169.254/latest/dynamic/instance-identity/document/

" - }, - "instanceIdentityDocumentSignature":{ - "shape":"String", - "documentation":"

The instance identity document signature for the EC2 instance to register. This signature can be found by running the following command from the instance: curl http://169.254.169.254/latest/dynamic/instance-identity/signature/

" - }, - "totalResources":{ - "shape":"Resources", - "documentation":"

The resources available on the instance.

" - }, - "versionInfo":{ - "shape":"VersionInfo", - "documentation":"

The version information for the Amazon ECS container agent and Docker daemon running on the container instance.

" - }, - "containerInstanceArn":{ - "shape":"String", - "documentation":"

The ARN of the container instance (if it was previously registered).

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The container instance attributes that this container instance supports.

" - } - } - }, - "RegisterContainerInstanceResponse":{ - "type":"structure", - "members":{ - "containerInstance":{ - "shape":"ContainerInstance", - "documentation":"

The container instance that was registered.

" - } - } - }, - "RegisterTaskDefinitionRequest":{ - "type":"structure", - "required":[ - "family", - "containerDefinitions" - ], - "members":{ - "family":{ - "shape":"String", - "documentation":"

You must specify a family for a task definition, which allows you to track multiple versions of the same task definition. The family is used as a name for your task definition. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

" - }, - "taskRoleArn":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role. For more information, see IAM Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

" - }, - "executionRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the task execution role that the Amazon ECS container agent and the Docker daemon can assume.

" - }, - "networkMode":{ - "shape":"NetworkMode", - "documentation":"

The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. The default Docker network mode is bridge. If using the Fargate launch type, the awsvpc network mode is required. If using the EC2 launch type, any network mode can be used. If the network mode is set to none, you can't specify port mappings in your container definitions, and the task's containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.

With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.

If the network mode is awsvpc, the task is allocated an Elastic Network Interface, and you must specify a NetworkConfiguration when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

If the network mode is host, you can't run multiple instantiations of the same task on a single container instance when port mappings are used.

Docker for Windows uses different network modes than Docker for Linux. When you register a task definition with Windows containers, you must not specify a network mode.

For more information, see Network settings in the Docker run reference.

" - }, - "containerDefinitions":{ - "shape":"ContainerDefinitions", - "documentation":"

A list of container definitions in JSON format that describe the different containers that make up your task.

" - }, - "volumes":{ - "shape":"VolumeList", - "documentation":"

A list of volume definitions in JSON format that containers in your task may use.

" - }, - "placementConstraints":{ - "shape":"TaskDefinitionPlacementConstraints", - "documentation":"

An array of placement constraint objects to use for the task. You can specify a maximum of 10 constraints per task (this limit includes constraints in the task definition and those specified at run time).

" - }, - "requiresCompatibilities":{ - "shape":"CompatibilityList", - "documentation":"

The launch type required by the task. If no value is specified, it defaults to EC2.

" - }, - "cpu":{ - "shape":"String", - "documentation":"

The number of CPU units used by the task. It can be expressed as an integer using CPU units, for example 1024, or as a string using vCPUs, for example 1 vCPU or 1 vcpu, in a task definition. String values are converted to an integer indicating the CPU units when the task definition is registered.

Task-level CPU and memory parameters are ignored for Windows containers. We recommend specifying container-level resources for Windows containers.

If using the EC2 launch type, this field is optional. Supported values are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs).

If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of supported values for the memory parameter:

  • 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)

  • 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB)

  • 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB)

  • 2048 (2 vCPU) - Available memory values: Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB)

  • 4096 (4 vCPU) - Available memory values: Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB)

" - }, - "memory":{ - "shape":"String", - "documentation":"

The amount of memory (in MiB) used by the task. It can be expressed as an integer using MiB, for example 1024, or as a string using GB, for example 1GB or 1 GB, in a task definition. String values are converted to an integer indicating the MiB when the task definition is registered.

Task-level CPU and memory parameters are ignored for Windows containers. We recommend specifying container-level resources for Windows containers.

If using the EC2 launch type, this field is optional.

If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of supported values for the cpu parameter:

  • 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)

  • 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)

  • 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU)

  • Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU)

  • Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU)

" - } - } - }, - "RegisterTaskDefinitionResponse":{ - "type":"structure", - "members":{ - "taskDefinition":{ - "shape":"TaskDefinition", - "documentation":"

The full description of the registered task definition.

" - } - } - }, - "RepositoryCredentials":{ - "type":"structure", - "required":["credentialsParameter"], - "members":{ - "credentialsParameter":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) or name of the secret containing the private repository credentials.

" - } - }, - "documentation":"

The repository credentials for private registry authentication.

" - }, - "RequiresAttributes":{ - "type":"list", - "member":{"shape":"Attribute"} - }, - "Resource":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the resource, such as CPU, MEMORY, PORTS, PORTS_UDP, or a user-defined resource.

" - }, - "type":{ - "shape":"String", - "documentation":"

The type of the resource, such as INTEGER, DOUBLE, LONG, or STRINGSET.

" - }, - "doubleValue":{ - "shape":"Double", - "documentation":"

When the doubleValue type is set, the value of the resource must be a double precision floating-point type.

" - }, - "longValue":{ - "shape":"Long", - "documentation":"

When the longValue type is set, the value of the resource must be an extended precision floating-point type.

" - }, - "integerValue":{ - "shape":"Integer", - "documentation":"

When the integerValue type is set, the value of the resource must be an integer.

" - }, - "stringSetValue":{ - "shape":"StringList", - "documentation":"

When the stringSetValue type is set, the value of the resource must be a string type.

" - } - }, - "documentation":"

Describes the resources available for a container instance.

" - }, - "Resources":{ - "type":"list", - "member":{"shape":"Resource"} - }, - "RunTaskRequest":{ - "type":"structure", - "required":["taskDefinition"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster on which to run your task. If you do not specify a cluster, the default cluster is assumed.

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The family and revision (family:revision) or full ARN of the task definition to run. If a revision is not specified, the latest ACTIVE revision is used.

" - }, - "overrides":{ - "shape":"TaskOverride", - "documentation":"

A list of container overrides in JSON format that specify the name of a container in the specified task definition and the overrides it should receive. You can override the default command for a container (that is specified in the task definition or Docker image) with a command override. You can also override existing environment variables (that are specified in the task definition or Docker image) on a container or add new environment variables to it with an environment override.

A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.

" - }, - "count":{ - "shape":"BoxedInteger", - "documentation":"

The number of instantiations of the specified task to place on your cluster. You can specify up to 10 tasks per call.

" - }, - "startedBy":{ - "shape":"String", - "documentation":"

An optional tag specified when a task is started. For example if you automatically trigger a task to run a batch process job, you could apply a unique identifier for that job to your task with the startedBy parameter. You can then identify which tasks belong to that job by filtering the results of a ListTasks call with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

If a task is started by an Amazon ECS service, then the startedBy parameter contains the deployment ID of the service that starts it.

" - }, - "group":{ - "shape":"String", - "documentation":"

The name of the task group to associate with the task. The default value is the family name of the task definition (for example, family:my-family-name).

" - }, - "placementConstraints":{ - "shape":"PlacementConstraints", - "documentation":"

An array of placement constraint objects to use for the task. You can specify up to 10 constraints per task (including constraints in the task definition and those specified at run time).

" - }, - "placementStrategy":{ - "shape":"PlacementStrategies", - "documentation":"

The placement strategy objects to use for the task. You can specify a maximum of five strategy rules per task.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type on which to run your task.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version on which to run your task. If one is not specified, the latest version is used by default.

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The network configuration for the task. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

" - } - } - }, - "RunTaskResponse":{ - "type":"structure", - "members":{ - "tasks":{ - "shape":"Tasks", - "documentation":"

A full description of the tasks that were run. The tasks that were successfully placed on your cluster are described here.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "SchedulingStrategy":{ - "type":"string", - "enum":[ - "REPLICA", - "DAEMON" - ] - }, - "Scope":{ - "type":"string", - "enum":[ - "task", - "shared" - ] - }, - "ServerException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a server issue.

", - "exception":true, - "fault":true - }, - "Service":{ - "type":"structure", - "members":{ - "serviceArn":{ - "shape":"String", - "documentation":"

The ARN that identifies the service. The ARN contains the arn:aws:ecs namespace, followed by the Region of the service, the AWS account ID of the service owner, the service namespace, and then the service name. For example, arn:aws:ecs:region:012345678910:service/my-service .

" - }, - "serviceName":{ - "shape":"String", - "documentation":"

The name of your service. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a Region or across multiple Regions.

" - }, - "clusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the cluster that hosts the service.

" - }, - "loadBalancers":{ - "shape":"LoadBalancers", - "documentation":"

A list of Elastic Load Balancing load balancer objects, containing the load balancer name, the container name (as it appears in a container definition), and the container port to access from the load balancer.

Services with tasks that use the awsvpc network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers; Classic Load Balancers are not supported. Also, when you create any target groups for these services, you must choose ip as the target type, not instance, because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

" - }, - "serviceRegistries":{ - "shape":"ServiceRegistries", - "documentation":"

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the service. The valid values are ACTIVE, DRAINING, or INACTIVE.

" - }, - "desiredCount":{ - "shape":"Integer", - "documentation":"

The desired number of instantiations of the task definition to keep running on the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService.

" - }, - "runningCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the cluster that are in the RUNNING state.

" - }, - "pendingCount":{ - "shape":"Integer", - "documentation":"

The number of tasks in the cluster that are in the PENDING state.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type on which your service is running.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version on which your task is running. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The task definition to use for tasks in the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService.

" - }, - "deploymentConfiguration":{ - "shape":"DeploymentConfiguration", - "documentation":"

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" - }, - "deployments":{ - "shape":"Deployments", - "documentation":"

The current state of deployments for the service.

" - }, - "roleArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role associated with the service that allows the Amazon ECS container agent to register container instances with an Elastic Load Balancing load balancer.

" - }, - "events":{ - "shape":"ServiceEvents", - "documentation":"

The event stream for your service. A maximum of 100 of the latest events are displayed.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the service was created.

" - }, - "placementConstraints":{ - "shape":"PlacementConstraints", - "documentation":"

The placement constraints for the tasks in the service.

" - }, - "placementStrategy":{ - "shape":"PlacementStrategies", - "documentation":"

The placement strategy that determines how tasks for the service are placed.

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

" - }, - "healthCheckGracePeriodSeconds":{ - "shape":"BoxedInteger", - "documentation":"

The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started.

" - }, - "schedulingStrategy":{ - "shape":"SchedulingStrategy", - "documentation":"

The scheduling strategy to use for the service. For more information, see Services.

There are two service scheduler strategies available:

  • REPLICA-The replica scheduling strategy places and maintains the desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions.

  • DAEMON-The daemon scheduling strategy deploys exactly one task on each container instance in your cluster. When using this strategy, do not specify a desired number of tasks or any task placement strategies.

    Fargate tasks do not support the DAEMON scheduling strategy.

" - } - }, - "documentation":"

Details on a service within a cluster

" - }, - "ServiceEvent":{ - "type":"structure", - "members":{ - "id":{ - "shape":"String", - "documentation":"

The ID string of the event.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the event was triggered.

" - }, - "message":{ - "shape":"String", - "documentation":"

The event message.

" - } - }, - "documentation":"

Details on an event associated with a service.

" - }, - "ServiceEvents":{ - "type":"list", - "member":{"shape":"ServiceEvent"} - }, - "ServiceNotActiveException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified service is not active. You can't update a service that is inactive. If you have previously deleted a service, you can re-create it with CreateService.

", - "exception":true - }, - "ServiceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified service could not be found. You can view your available services with ListServices. Amazon ECS services are cluster-specific and region-specific.

", - "exception":true - }, - "ServiceRegistries":{ - "type":"list", - "member":{"shape":"ServiceRegistry"} - }, - "ServiceRegistry":{ - "type":"structure", - "members":{ - "registryArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the service registry. The currently supported service registry is Amazon Route 53 Auto Naming. For more information, see Service.

" - }, - "port":{ - "shape":"BoxedInteger", - "documentation":"

The port value used if your service discovery service specified an SRV record. This field is required if both the awsvpc network mode and SRV records are used.

" - }, - "containerName":{ - "shape":"String", - "documentation":"

The container name value, already specified in the task definition, to be used for your service discovery service. If the task definition that your service task specifies uses the bridge or host network mode, you must specify a containerName and containerPort combination from the task definition. If the task definition that your service task specifies uses the awsvpc network mode and a type SRV DNS record is used, you must specify either a containerName and containerPort combination or a port value, but not both.

" - }, - "containerPort":{ - "shape":"BoxedInteger", - "documentation":"

The port value, already specified in the task definition, to be used for your service discovery service. If the task definition your service task specifies uses the bridge or host network mode, you must specify a containerName and containerPort combination from the task definition. If the task definition your service task specifies uses the awsvpc network mode and a type SRV DNS record is used, you must specify either a containerName and containerPort combination or a port value, but not both.

" - } - }, - "documentation":"

Details of the service registry.

" - }, - "Services":{ - "type":"list", - "member":{"shape":"Service"} - }, - "SortOrder":{ - "type":"string", - "enum":[ - "ASC", - "DESC" - ] - }, - "StartTaskRequest":{ - "type":"structure", - "required":[ - "taskDefinition", - "containerInstances" - ], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster on which to start your task. If you do not specify a cluster, the default cluster is assumed.

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The family and revision (family:revision) or full ARN of the task definition to start. If a revision is not specified, the latest ACTIVE revision is used.

" - }, - "overrides":{ - "shape":"TaskOverride", - "documentation":"

A list of container overrides in JSON format that specify the name of a container in the specified task definition and the overrides it should receive. You can override the default command for a container (that is specified in the task definition or Docker image) with a command override. You can also override existing environment variables (that are specified in the task definition or Docker image) on a container or add new environment variables to it with an environment override.

A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.

" - }, - "containerInstances":{ - "shape":"StringList", - "documentation":"

The container instance IDs or full ARN entries for the container instances on which you would like to place your task. You can specify up to 10 container instances.

" - }, - "startedBy":{ - "shape":"String", - "documentation":"

An optional tag specified when a task is started. For example if you automatically trigger a task to run a batch process job, you could apply a unique identifier for that job to your task with the startedBy parameter. You can then identify which tasks belong to that job by filtering the results of a ListTasks call with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

If a task is started by an Amazon ECS service, then the startedBy parameter contains the deployment ID of the service that starts it.

" - }, - "group":{ - "shape":"String", - "documentation":"

The name of the task group to associate with the task. The default value is the family name of the task definition (for example, family:my-family-name).

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

" - } - } - }, - "StartTaskResponse":{ - "type":"structure", - "members":{ - "tasks":{ - "shape":"Tasks", - "documentation":"

A full description of the tasks that were started. Each task that was successfully placed on your container instances is described.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "Statistics":{ - "type":"list", - "member":{"shape":"KeyValuePair"} - }, - "StopTaskRequest":{ - "type":"structure", - "required":["task"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task to stop. If you do not specify a cluster, the default cluster is assumed.

" - }, - "task":{ - "shape":"String", - "documentation":"

The task ID or full ARN entry of the task to stop.

" - }, - "reason":{ - "shape":"String", - "documentation":"

An optional message specified when a task is stopped. For example, if you are using a custom scheduler, you can use this parameter to specify the reason for stopping the task here, and the message appears in subsequent DescribeTasks API operations on this task. Up to 255 characters are allowed in this message.

" - } - } - }, - "StopTaskResponse":{ - "type":"structure", - "members":{ - "task":{ - "shape":"Task", - "documentation":"

The task that was stopped.

" - } - } - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "StringMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "SubmitContainerStateChangeRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full ARN of the cluster that hosts the container.

" - }, - "task":{ - "shape":"String", - "documentation":"

The task ID or full Amazon Resource Name (ARN) of the task that hosts the container.

" - }, - "containerName":{ - "shape":"String", - "documentation":"

The name of the container.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the state change request.

" - }, - "exitCode":{ - "shape":"BoxedInteger", - "documentation":"

The exit code returned for the state change request.

" - }, - "reason":{ - "shape":"String", - "documentation":"

The reason for the state change request.

" - }, - "networkBindings":{ - "shape":"NetworkBindings", - "documentation":"

The network bindings of the container.

" - } - } - }, - "SubmitContainerStateChangeResponse":{ - "type":"structure", - "members":{ - "acknowledgment":{ - "shape":"String", - "documentation":"

Acknowledgement of the state change.

" - } - } - }, - "SubmitTaskStateChangeRequest":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task.

" - }, - "task":{ - "shape":"String", - "documentation":"

The task ID or full ARN of the task in the state change request.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the state change request.

" - }, - "reason":{ - "shape":"String", - "documentation":"

The reason for the state change request.

" - }, - "containers":{ - "shape":"ContainerStateChanges", - "documentation":"

Any containers associated with the state change request.

" - }, - "attachments":{ - "shape":"AttachmentStateChanges", - "documentation":"

Any attachments associated with the state change request.

" - }, - "pullStartedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the container image pull began.

" - }, - "pullStoppedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the container image pull completed.

" - }, - "executionStoppedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task execution stopped.

" - } - } - }, - "SubmitTaskStateChangeResponse":{ - "type":"structure", - "members":{ - "acknowledgment":{ - "shape":"String", - "documentation":"

Acknowledgement of the state change.

" - } - } - }, - "TargetNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified target could not be found. You can view your available container instances with ListContainerInstances. Amazon ECS container instances are cluster-specific and region-specific.

", - "exception":true - }, - "TargetType":{ - "type":"string", - "enum":["container-instance"] - }, - "Task":{ - "type":"structure", - "members":{ - "taskArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the task.

" - }, - "clusterArn":{ - "shape":"String", - "documentation":"

The ARN of the cluster that hosts the task.

" - }, - "taskDefinitionArn":{ - "shape":"String", - "documentation":"

The ARN of the task definition that creates the task.

" - }, - "containerInstanceArn":{ - "shape":"String", - "documentation":"

The ARN of the container instances that host the task.

" - }, - "overrides":{ - "shape":"TaskOverride", - "documentation":"

One or more container overrides.

" - }, - "lastStatus":{ - "shape":"String", - "documentation":"

The last known status of the task. For more information, see Task Lifecycle.

" - }, - "desiredStatus":{ - "shape":"String", - "documentation":"

The desired status of the task. For more information, see Task Lifecycle.

" - }, - "cpu":{ - "shape":"String", - "documentation":"

The number of CPU units used by the task. It can be expressed as an integer using CPU units, for example 1024, or as a string using vCPUs, for example 1 vCPU or 1 vcpu, in a task definition. String values are converted to an integer indicating the CPU units when the task definition is registered.

If using the EC2 launch type, this field is optional. Supported values are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs).

If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of supported values for the memory parameter:

  • 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)

  • 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB)

  • 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB)

  • 2048 (2 vCPU) - Available memory values: Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB)

  • 4096 (4 vCPU) - Available memory values: Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB)

" - }, - "memory":{ - "shape":"String", - "documentation":"

The amount of memory (in MiB) used by the task. It can be expressed as an integer using MiB, for example 1024, or as a string using GB, for example 1GB or 1 GB, in a task definition. String values are converted to an integer indicating the MiB when the task definition is registered.

If using the EC2 launch type, this field is optional.

If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of supported values for the cpu parameter:

  • 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)

  • 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)

  • 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU)

  • Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU)

  • Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU)

" - }, - "containers":{ - "shape":"Containers", - "documentation":"

The containers associated with the task.

" - }, - "startedBy":{ - "shape":"String", - "documentation":"

The tag specified when a task is started. If the task is started by an Amazon ECS service, then the startedBy parameter contains the deployment ID of the service that starts it.

" - }, - "version":{ - "shape":"Long", - "documentation":"

The version counter for the task. Every time a task experiences a change that triggers a CloudWatch event, the version counter is incremented. If you are replicating your Amazon ECS task state with CloudWatch Events, you can compare the version of a task reported by the Amazon ECS APIs with the version reported in CloudWatch Events for the task (inside the detail object) to verify that the version in your event stream is current.

" - }, - "stoppedReason":{ - "shape":"String", - "documentation":"

The reason the task was stopped.

" - }, - "connectivity":{ - "shape":"Connectivity", - "documentation":"

The connectivity status of a task.

" - }, - "connectivityAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task last went into CONNECTED status.

" - }, - "pullStartedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the container image pull began.

" - }, - "pullStoppedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the container image pull completed.

" - }, - "executionStoppedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task execution stopped.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task was created (the task entered the PENDING state).

" - }, - "startedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task started (the task transitioned from the PENDING state to the RUNNING state).

" - }, - "stoppingAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task stops (transitions from the RUNNING state to STOPPED).

" - }, - "stoppedAt":{ - "shape":"Timestamp", - "documentation":"

The Unix time stamp for when the task was stopped (the task transitioned from the RUNNING state to the STOPPED state).

" - }, - "group":{ - "shape":"String", - "documentation":"

The name of the task group associated with the task.

" - }, - "launchType":{ - "shape":"LaunchType", - "documentation":"

The launch type on which your task is running.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version on which your task is running. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

" - }, - "attachments":{ - "shape":"Attachments", - "documentation":"

The elastic network adapter associated with the task if the task uses the awsvpc network mode.

" - }, - "healthStatus":{ - "shape":"HealthStatus", - "documentation":"

The health status for the task, which is determined by the health of the essential containers in the task. If all essential containers in the task are reporting as HEALTHY, then the task status also reports as HEALTHY. If any essential containers in the task are reporting as UNHEALTHY or UNKNOWN, then the task status also reports as UNHEALTHY or UNKNOWN, accordingly.

The Amazon ECS container agent does not monitor or report on Docker health checks that are embedded in a container image (such as those specified in a parent image or from the image's Dockerfile) and not specified in the container definition. Health check parameters that are specified in a container definition override any Docker health checks that exist in the container image.

" - } - }, - "documentation":"

Details on a task in a cluster.

" - }, - "TaskDefinition":{ - "type":"structure", - "members":{ - "taskDefinitionArn":{ - "shape":"String", - "documentation":"

The full Amazon Resource Name (ARN) of the task definition.

" - }, - "containerDefinitions":{ - "shape":"ContainerDefinitions", - "documentation":"

A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon Elastic Container Service Developer Guide.

" - }, - "family":{ - "shape":"String", - "documentation":"

The family of your task definition, used as the definition name.

" - }, - "taskRoleArn":{ - "shape":"String", - "documentation":"

The ARN of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role.

IAM roles for tasks on Windows require that the -EnableTaskIAMRole option is set when you launch the Amazon ECS-optimized Windows AMI. Your containers must also run some configuration code in order to take advantage of the feature. For more information, see Windows IAM Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

" - }, - "executionRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the task execution role that the Amazon ECS container agent and the Docker daemon can assume.

" - }, - "networkMode":{ - "shape":"NetworkMode", - "documentation":"

The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. The default Docker network mode is bridge. If using the Fargate launch type, the awsvpc network mode is required. If using the EC2 launch type, any network mode can be used. If the network mode is set to none, you can't specify port mappings in your container definitions, and the task's containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.

With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.

If the network mode is awsvpc, the task is allocated an Elastic Network Interface, and you must specify a NetworkConfiguration when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

Currently, only the Amazon ECS-optimized AMI, other Amazon Linux variants with the ecs-init package, or AWS Fargate infrastructure support the awsvpc network mode.

If the network mode is host, you can't run multiple instantiations of the same task on a single container instance when port mappings are used.

Docker for Windows uses different network modes than Docker for Linux. When you register a task definition with Windows containers, you must not specify a network mode. If you use the console to register a task definition with Windows containers, you must choose the <default> network mode object.

For more information, see Network settings in the Docker run reference.

" - }, - "revision":{ - "shape":"Integer", - "documentation":"

The revision of the task in a particular family. The revision is a version number of a task definition in a family. When you register a task definition for the first time, the revision is 1; each time you register a new revision of a task definition in the same family, the revision value always increases by one (even if you have deregistered previous revisions in this family).

" - }, - "volumes":{ - "shape":"VolumeList", - "documentation":"

The list of volumes in a task.

If you are using the Fargate launch type, the host and sourcePath parameters are not supported.

For more information about volume definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon Elastic Container Service Developer Guide.

" - }, - "status":{ - "shape":"TaskDefinitionStatus", - "documentation":"

The status of the task definition.

" - }, - "requiresAttributes":{ - "shape":"RequiresAttributes", - "documentation":"

The container instance attributes required by your task. This field is not valid if using the Fargate launch type for your task.

" - }, - "placementConstraints":{ - "shape":"TaskDefinitionPlacementConstraints", - "documentation":"

An array of placement constraint objects to use for tasks. This field is not valid if using the Fargate launch type for your task.

" - }, - "compatibilities":{ - "shape":"CompatibilityList", - "documentation":"

The launch type to use with your task. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

" - }, - "requiresCompatibilities":{ - "shape":"CompatibilityList", - "documentation":"

The launch type the task is using.

" - }, - "cpu":{ - "shape":"String", - "documentation":"

The number of cpu units used by the task. If using the EC2 launch type, this field is optional and any value can be used. If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the memory parameter:

  • 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)

  • 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB)

  • 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB)

  • 2048 (2 vCPU) - Available memory values: Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB)

  • 4096 (4 vCPU) - Available memory values: Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB)

" - }, - "memory":{ - "shape":"String", - "documentation":"

The amount (in MiB) of memory used by the task. If using the EC2 launch type, this field is optional and any value can be used. If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter:

  • 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)

  • 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)

  • 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU)

  • Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU)

  • Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU)

" - } - }, - "documentation":"

Details of a task definition.

" - }, - "TaskDefinitionFamilyStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE", - "ALL" - ] - }, - "TaskDefinitionPlacementConstraint":{ - "type":"structure", - "members":{ - "type":{ - "shape":"TaskDefinitionPlacementConstraintType", - "documentation":"

The type of constraint. The DistinctInstance constraint ensures that each task in a particular group is running on a different container instance. The MemberOf constraint restricts selection to be from a group of valid candidates.

" - }, - "expression":{ - "shape":"String", - "documentation":"

A cluster query language expression to apply to the constraint. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "documentation":"

An object representing a constraint on task placement in the task definition.

If you are using the Fargate launch type, task placement constraints are not supported.

For more information, see Task Placement Constraints in the Amazon Elastic Container Service Developer Guide.

" - }, - "TaskDefinitionPlacementConstraintType":{ - "type":"string", - "enum":["memberOf"] - }, - "TaskDefinitionPlacementConstraints":{ - "type":"list", - "member":{"shape":"TaskDefinitionPlacementConstraint"} - }, - "TaskDefinitionStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE" - ] - }, - "TaskOverride":{ - "type":"structure", - "members":{ - "containerOverrides":{ - "shape":"ContainerOverrides", - "documentation":"

One or more container overrides sent to a task.

" - }, - "taskRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role.

" - }, - "executionRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the task execution role that the Amazon ECS container agent and the Docker daemon can assume.

" - } - }, - "documentation":"

The overrides associated with a task.

" - }, - "Tasks":{ - "type":"list", - "member":{"shape":"Task"} - }, - "Timestamp":{"type":"timestamp"}, - "Tmpfs":{ - "type":"structure", - "required":[ - "containerPath", - "size" - ], - "members":{ - "containerPath":{ - "shape":"String", - "documentation":"

The absolute file path where the tmpfs volume is to be mounted.

" - }, - "size":{ - "shape":"Integer", - "documentation":"

The size (in MiB) of the tmpfs volume.

" - }, - "mountOptions":{ - "shape":"StringList", - "documentation":"

The list of tmpfs volume mount options.

Valid values: \"defaults\" | \"ro\" | \"rw\" | \"suid\" | \"nosuid\" | \"dev\" | \"nodev\" | \"exec\" | \"noexec\" | \"sync\" | \"async\" | \"dirsync\" | \"remount\" | \"mand\" | \"nomand\" | \"atime\" | \"noatime\" | \"diratime\" | \"nodiratime\" | \"bind\" | \"rbind\" | \"unbindable\" | \"runbindable\" | \"private\" | \"rprivate\" | \"shared\" | \"rshared\" | \"slave\" | \"rslave\" | \"relatime\" | \"norelatime\" | \"strictatime\" | \"nostrictatime\" | \"mode\" | \"uid\" | \"gid\" | \"nr_inodes\" | \"nr_blocks\" | \"mpol\"

" - } - }, - "documentation":"

The container path, mount options, and size of the tmpfs mount.

" - }, - "TmpfsList":{ - "type":"list", - "member":{"shape":"Tmpfs"} - }, - "TransportProtocol":{ - "type":"string", - "enum":[ - "tcp", - "udp" - ] - }, - "Ulimit":{ - "type":"structure", - "required":[ - "name", - "softLimit", - "hardLimit" - ], - "members":{ - "name":{ - "shape":"UlimitName", - "documentation":"

The type of the ulimit.

" - }, - "softLimit":{ - "shape":"Integer", - "documentation":"

The soft limit for the ulimit type.

" - }, - "hardLimit":{ - "shape":"Integer", - "documentation":"

The hard limit for the ulimit type.

" - } - }, - "documentation":"

The ulimit settings to pass to the container.

" - }, - "UlimitList":{ - "type":"list", - "member":{"shape":"Ulimit"} - }, - "UlimitName":{ - "type":"string", - "enum":[ - "core", - "cpu", - "data", - "fsize", - "locks", - "memlock", - "msgqueue", - "nice", - "nofile", - "nproc", - "rss", - "rtprio", - "rttime", - "sigpending", - "stack" - ] - }, - "UnsupportedFeatureException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified task is not supported in this region.

", - "exception":true - }, - "UpdateContainerAgentRequest":{ - "type":"structure", - "required":["containerInstance"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that your container instance is running on. If you do not specify a cluster, the default cluster is assumed.

" - }, - "containerInstance":{ - "shape":"String", - "documentation":"

The container instance ID or full ARN entries for the container instance on which you would like to update the Amazon ECS container agent.

" - } - } - }, - "UpdateContainerAgentResponse":{ - "type":"structure", - "members":{ - "containerInstance":{ - "shape":"ContainerInstance", - "documentation":"

The container instance for which the container agent was updated.

" - } - } - }, - "UpdateContainerInstancesStateRequest":{ - "type":"structure", - "required":[ - "containerInstances", - "status" - ], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instance to update. If you do not specify a cluster, the default cluster is assumed.

" - }, - "containerInstances":{ - "shape":"StringList", - "documentation":"

A list of container instance IDs or full ARN entries.

" - }, - "status":{ - "shape":"ContainerInstanceStatus", - "documentation":"

The container instance state with which to update the container instance.

" - } - } - }, - "UpdateContainerInstancesStateResponse":{ - "type":"structure", - "members":{ - "containerInstances":{ - "shape":"ContainerInstances", - "documentation":"

The list of container instances.

" - }, - "failures":{ - "shape":"Failures", - "documentation":"

Any failures associated with the call.

" - } - } - }, - "UpdateInProgressException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is already a current Amazon ECS container agent update in progress on the specified container instance. If the container agent becomes disconnected while it is in a transitional stage, such as PENDING or STAGING, the update process can get stuck in that state. However, when the agent reconnects, it resumes where it stopped previously.

", - "exception":true - }, - "UpdateServiceRequest":{ - "type":"structure", - "required":["service"], - "members":{ - "cluster":{ - "shape":"String", - "documentation":"

The short name or full Amazon Resource Name (ARN) of the cluster that your service is running on. If you do not specify a cluster, the default cluster is assumed.

" - }, - "service":{ - "shape":"String", - "documentation":"

The name of the service to update.

" - }, - "desiredCount":{ - "shape":"BoxedInteger", - "documentation":"

The number of instantiations of the task to place and keep running in your service.

" - }, - "taskDefinition":{ - "shape":"String", - "documentation":"

The family and revision (family:revision) or full ARN of the task definition to run in your service. If a revision is not specified, the latest ACTIVE revision is used. If you modify the task definition with UpdateService, Amazon ECS spawns a task with the new version of the task definition and then stops an old task after the new version is running.

" - }, - "deploymentConfiguration":{ - "shape":"DeploymentConfiguration", - "documentation":"

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" - }, - "networkConfiguration":{ - "shape":"NetworkConfiguration", - "documentation":"

The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own elastic network interface, and it is not supported for other network modes. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

Updating a service to add a subnet to a list of existing subnets does not trigger a service deployment. For example, if your network configuration change is to keep the existing subnets and simply add another subnet to the network configuration, this does not trigger a new service deployment.

" - }, - "platformVersion":{ - "shape":"String", - "documentation":"

The platform version that your service should run.

" - }, - "forceNewDeployment":{ - "shape":"Boolean", - "documentation":"

Whether to force a new deployment of the service. Deployments are not forced by default. You can use this option to trigger a new deployment with no service definition changes. For example, you can update a service's tasks to use a newer Docker image with the same image/tag combination (my_image:latest) or to roll Fargate tasks onto a newer platform version.

" - }, - "healthCheckGracePeriodSeconds":{ - "shape":"BoxedInteger", - "documentation":"

The period of time, in seconds, that the Amazon ECS service scheduler should ignore unhealthy Elastic Load Balancing target health checks after a task has first started. This is only valid if your service is configured to use a load balancer. If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 1,800 seconds during which the ECS service scheduler ignores the Elastic Load Balancing health check status. This grace period can prevent the ECS service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.

" - } - } - }, - "UpdateServiceResponse":{ - "type":"structure", - "members":{ - "service":{ - "shape":"Service", - "documentation":"

The full description of your service following the update call.

" - } - } - }, - "VersionInfo":{ - "type":"structure", - "members":{ - "agentVersion":{ - "shape":"String", - "documentation":"

The version number of the Amazon ECS container agent.

" - }, - "agentHash":{ - "shape":"String", - "documentation":"

The Git commit hash for the Amazon ECS container agent build on the amazon-ecs-agent GitHub repository.

" - }, - "dockerVersion":{ - "shape":"String", - "documentation":"

The Docker version running on the container instance.

" - } - }, - "documentation":"

The Docker and Amazon ECS container agent version information about a container instance.

" - }, - "Volume":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. This name is referenced in the sourceVolume parameter of container definition mountPoints.

" - }, - "host":{ - "shape":"HostVolumeProperties", - "documentation":"

This parameter is specified when using bind mount host volumes. Bind mount host volumes are supported when using either the EC2 or Fargate launch types. The contents of the host parameter determine whether your bind mount host volume persists on the host container instance and where it is stored. If the host parameter is empty, then the Docker daemon assigns a host path for your data volume, but the data is not guaranteed to persist after the containers associated with it stop running.

Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers cannot mount directories on a different drive, and mount point cannot be across drives. For example, you can mount C:\\my\\path:C:\\my\\path and D:\\:D:\\, but not D:\\my\\path:C:\\my\\path or D:\\:C:\\my\\path.

" - }, - "dockerVolumeConfiguration":{ - "shape":"DockerVolumeConfiguration", - "documentation":"

The configuration for the Docker volume. This parameter is specified when using Docker volumes.

" - } - }, - "documentation":"

A data volume used in a task definition. For tasks that use a Docker volume, specify a DockerVolumeConfiguration. For tasks that use a bind mount host volume, specify a host and optional sourcePath. For more information, see Using Data Volumes in Tasks.

" - }, - "VolumeFrom":{ - "type":"structure", - "members":{ - "sourceContainer":{ - "shape":"String", - "documentation":"

The name of another container within the same task definition to mount volumes from.

" - }, - "readOnly":{ - "shape":"BoxedBoolean", - "documentation":"

If this value is true, the container has read-only access to the volume. If this value is false, then the container can write to the volume. The default value is false.

" - } - }, - "documentation":"

Details on a data volume from another container in the same task definition.

" - }, - "VolumeFromList":{ - "type":"list", - "member":{"shape":"VolumeFrom"} - }, - "VolumeList":{ - "type":"list", - "member":{"shape":"Volume"} - } - }, - "documentation":"

Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service that makes it easy to run, stop, and manage Docker containers on a cluster. You can host your cluster on a serverless infrastructure that is managed by Amazon ECS by launching your services or tasks using the Fargate launch type. For more control, you can host your tasks on a cluster of Amazon Elastic Compute Cloud (Amazon EC2) instances that you manage by using the EC2 launch type. For more information about launch types, see Amazon ECS Launch Types.

Amazon ECS lets you launch and stop container-based applications with simple API calls, allows you to get the state of your cluster from a centralized service, and gives you access to many familiar Amazon EC2 features.

You can use Amazon ECS to schedule the placement of containers across your cluster based on your resource needs, isolation policies, and availability requirements. Amazon ECS eliminates the need for you to operate your own cluster management and configuration management systems or worry about scaling your management infrastructure.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/waiters-2.json deleted file mode 100644 index 8a0b19d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ecs/2014-11-13/waiters-2.json +++ /dev/null @@ -1,93 +0,0 @@ -{ - "version": 2, - "waiters": { - "TasksRunning": { - "delay": 6, - "operation": "DescribeTasks", - "maxAttempts": 100, - "acceptors": [ - { - "expected": "STOPPED", - "matcher": "pathAny", - "state": "failure", - "argument": "tasks[].lastStatus" - }, - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "RUNNING", - "matcher": "pathAll", - "state": "success", - "argument": "tasks[].lastStatus" - } - ] - }, - "TasksStopped": { - "delay": 6, - "operation": "DescribeTasks", - "maxAttempts": 100, - "acceptors": [ - { - "expected": "STOPPED", - "matcher": "pathAll", - "state": "success", - "argument": "tasks[].lastStatus" - } - ] - }, - "ServicesStable": { - "delay": 15, - "operation": "DescribeServices", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "DRAINING", - "matcher": "pathAny", - "state": "failure", - "argument": "services[].status" - }, - { - "expected": "INACTIVE", - "matcher": "pathAny", - "state": "failure", - "argument": "services[].status" - }, - { - "expected": true, - "matcher": "path", - "state": "success", - "argument": "length(services[?!(length(deployments) == `1` && runningCount == desiredCount)]) == `0`" - } - ] - }, - "ServicesInactive": { - "delay": 15, - "operation": "DescribeServices", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "INACTIVE", - "matcher": "pathAny", - "state": "success", - "argument": "services[].status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/examples-1.json deleted file mode 100644 index 4a4b982d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/examples-1.json +++ /dev/null @@ -1,222 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateFileSystem": [ - { - "input": { - "CreationToken": "tokenstring", - "PerformanceMode": "generalPurpose" - }, - "output": { - "CreationTime": "1481841524.0", - "CreationToken": "tokenstring", - "FileSystemId": "fs-01234567", - "LifeCycleState": "creating", - "NumberOfMountTargets": 0, - "OwnerId": "012345678912", - "PerformanceMode": "generalPurpose", - "SizeInBytes": { - "Value": 0 - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation creates a new file system with the default generalpurpose performance mode.", - "id": "to-create-a-new-file-system-1481840798547", - "title": "To create a new file system" - } - ], - "CreateMountTarget": [ - { - "input": { - "FileSystemId": "fs-01234567", - "SubnetId": "subnet-1234abcd" - }, - "output": { - "FileSystemId": "fs-01234567", - "IpAddress": "192.0.0.2", - "LifeCycleState": "creating", - "MountTargetId": "fsmt-12340abc", - "NetworkInterfaceId": "eni-cedf6789", - "OwnerId": "012345678912", - "SubnetId": "subnet-1234abcd" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation creates a new mount target for an EFS file system.", - "id": "to-create-a-new-mount-target-1481842289329", - "title": "To create a new mount target" - } - ], - "CreateTags": [ - { - "input": { - "FileSystemId": "fs-01234567", - "Tags": [ - { - "Key": "Name", - "Value": "MyFileSystem" - } - ] - }, - "comments": { - }, - "description": "This operation creates a new tag for an EFS file system.", - "id": "to-create-a-new-tag-1481843409357", - "title": "To create a new tag" - } - ], - "DeleteFileSystem": [ - { - "input": { - "FileSystemId": "fs-01234567" - }, - "comments": { - }, - "description": "This operation deletes an EFS file system.", - "id": "to-delete-a-file-system-1481847318348", - "title": "To delete a file system" - } - ], - "DeleteMountTarget": [ - { - "input": { - "MountTargetId": "fsmt-12340abc" - }, - "comments": { - }, - "description": "This operation deletes a mount target.", - "id": "to-delete-a-mount-target-1481847635607", - "title": "To delete a mount target" - } - ], - "DeleteTags": [ - { - "input": { - "FileSystemId": "fs-01234567", - "TagKeys": [ - "Name" - ] - }, - "comments": { - }, - "description": "This operation deletes tags for an EFS file system.", - "id": "to-delete-tags-for-an-efs-file-system-1481848189061", - "title": "To delete tags for an EFS file system" - } - ], - "DescribeFileSystems": [ - { - "input": { - }, - "output": { - "FileSystems": [ - { - "CreationTime": "1481841524.0", - "CreationToken": "tokenstring", - "FileSystemId": "fs-01234567", - "LifeCycleState": "available", - "Name": "MyFileSystem", - "NumberOfMountTargets": 1, - "OwnerId": "012345678912", - "PerformanceMode": "generalPurpose", - "SizeInBytes": { - "Value": 6144 - } - } - ] - }, - "comments": { - }, - "description": "This operation describes all of the EFS file systems in an account.", - "id": "to-describe-an-efs-file-system-1481848448460", - "title": "To describe an EFS file system" - } - ], - "DescribeMountTargetSecurityGroups": [ - { - "input": { - "MountTargetId": "fsmt-12340abc" - }, - "output": { - "SecurityGroups": [ - "sg-fghi4567" - ] - }, - "comments": { - }, - "description": "This operation describes all of the security groups for a file system's mount target.", - "id": "to-describe-the-security-groups-for-a-mount-target-1481849317823", - "title": "To describe the security groups for a mount target" - } - ], - "DescribeMountTargets": [ - { - "input": { - "FileSystemId": "fs-01234567" - }, - "output": { - "MountTargets": [ - { - "FileSystemId": "fs-01234567", - "IpAddress": "192.0.0.2", - "LifeCycleState": "available", - "MountTargetId": "fsmt-12340abc", - "NetworkInterfaceId": "eni-cedf6789", - "OwnerId": "012345678912", - "SubnetId": "subnet-1234abcd" - } - ] - }, - "comments": { - }, - "description": "This operation describes all of a file system's mount targets.", - "id": "to-describe-the-mount-targets-for-a-file-system-1481849958584", - "title": "To describe the mount targets for a file system" - } - ], - "DescribeTags": [ - { - "input": { - "FileSystemId": "fs-01234567" - }, - "output": { - "Tags": [ - { - "Key": "Name", - "Value": "MyFileSystem" - } - ] - }, - "comments": { - }, - "description": "This operation describes all of a file system's tags.", - "id": "to-describe-the-tags-for-a-file-system-1481850497090", - "title": "To describe the tags for a file system" - } - ], - "ModifyMountTargetSecurityGroups": [ - { - "input": { - "MountTargetId": "fsmt-12340abc", - "SecurityGroups": [ - "sg-abcd1234" - ] - }, - "comments": { - }, - "description": "This operation modifies the security groups associated with a mount target for a file system.", - "id": "to-modify-the-security-groups-associated-with-a-mount-target-for-a-file-system-1481850772562", - "title": "To modify the security groups associated with a mount target for a file system" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/paginators-1.json deleted file mode 100644 index e8ed53f7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "DescribeFileSystems": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "FileSystems" - }, - "DescribeMountTargets": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "MountTargets" - }, - "DescribeTags": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "Tags" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/service-2.json deleted file mode 100644 index 3166d333..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/efs/2015-02-01/service-2.json +++ /dev/null @@ -1,1020 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-02-01", - "endpointPrefix":"elasticfilesystem", - "protocol":"rest-json", - "serviceAbbreviation":"EFS", - "serviceFullName":"Amazon Elastic File System", - "serviceId":"EFS", - "signatureVersion":"v4", - "uid":"elasticfilesystem-2015-02-01" - }, - "operations":{ - "CreateFileSystem":{ - "name":"CreateFileSystem", - "http":{ - "method":"POST", - "requestUri":"/2015-02-01/file-systems", - "responseCode":201 - }, - "input":{"shape":"CreateFileSystemRequest"}, - "output":{"shape":"FileSystemDescription"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemAlreadyExists"}, - {"shape":"FileSystemLimitExceeded"}, - {"shape":"InsufficientThroughputCapacity"}, - {"shape":"ThroughputLimitExceeded"} - ], - "documentation":"

Creates a new, empty file system. The operation requires a creation token in the request that Amazon EFS uses to ensure idempotent creation (calling the operation with same creation token has no effect). If a file system does not currently exist that is owned by the caller's AWS account with the specified creation token, this operation does the following:

  • Creates a new, empty file system. The file system will have an Amazon EFS assigned ID, and an initial lifecycle state creating.

  • Returns with the description of the created file system.

Otherwise, this operation returns a FileSystemAlreadyExists error with the ID of the existing file system.

For basic use cases, you can use a randomly generated UUID for the creation token.

The idempotent operation allows you to retry a CreateFileSystem call without risk of creating an extra file system. This can happen when an initial call fails in a way that leaves it uncertain whether or not a file system was actually created. An example might be that a transport level timeout occurred or your connection was reset. As long as you use the same creation token, if the initial call had succeeded in creating a file system, the client can learn of its existence from the FileSystemAlreadyExists error.

The CreateFileSystem call returns while the file system's lifecycle state is still creating. You can check the file system creation status by calling the DescribeFileSystems operation, which among other things returns the file system state.

This operation also takes an optional PerformanceMode parameter that you choose for your file system. We recommend generalPurpose performance mode for most file systems. File systems using the maxIO performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. For more information, see Amazon EFS: Performance Modes.

After the file system is fully created, Amazon EFS sets its lifecycle state to available, at which point you can create one or more mount targets for the file system in your VPC. For more information, see CreateMountTarget. You mount your Amazon EFS file system on an EC2 instances in your VPC via the mount target. For more information, see Amazon EFS: How it Works.

This operation requires permissions for the elasticfilesystem:CreateFileSystem action.

" - }, - "CreateMountTarget":{ - "name":"CreateMountTarget", - "http":{ - "method":"POST", - "requestUri":"/2015-02-01/mount-targets", - "responseCode":200 - }, - "input":{"shape":"CreateMountTargetRequest"}, - "output":{"shape":"MountTargetDescription"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"}, - {"shape":"IncorrectFileSystemLifeCycleState"}, - {"shape":"MountTargetConflict"}, - {"shape":"SubnetNotFound"}, - {"shape":"NoFreeAddressesInSubnet"}, - {"shape":"IpAddressInUse"}, - {"shape":"NetworkInterfaceLimitExceeded"}, - {"shape":"SecurityGroupLimitExceeded"}, - {"shape":"SecurityGroupNotFound"}, - {"shape":"UnsupportedAvailabilityZone"} - ], - "documentation":"

Creates a mount target for a file system. You can then mount the file system on EC2 instances via the mount target.

You can create one mount target in each Availability Zone in your VPC. All EC2 instances in a VPC within a given Availability Zone share a single mount target for a given file system. If you have multiple subnets in an Availability Zone, you create a mount target in one of the subnets. EC2 instances do not need to be in the same subnet as the mount target in order to access their file system. For more information, see Amazon EFS: How it Works.

In the request, you also specify a file system ID for which you are creating the mount target and the file system's lifecycle state must be available. For more information, see DescribeFileSystems.

In the request, you also provide a subnet ID, which determines the following:

  • VPC in which Amazon EFS creates the mount target

  • Availability Zone in which Amazon EFS creates the mount target

  • IP address range from which Amazon EFS selects the IP address of the mount target (if you don't specify an IP address in the request)

After creating the mount target, Amazon EFS returns a response that includes, a MountTargetId and an IpAddress. You use this IP address when mounting the file system in an EC2 instance. You can also use the mount target's DNS name when mounting the file system. The EC2 instance on which you mount the file system via the mount target can resolve the mount target's DNS name to its IP address. For more information, see How it Works: Implementation Overview.

Note that you can create mount targets for a file system in only one VPC, and there can be only one mount target per Availability Zone. That is, if the file system already has one or more mount targets created for it, the subnet specified in the request to add another mount target must meet the following requirements:

  • Must belong to the same VPC as the subnets of the existing mount targets

  • Must not be in the same Availability Zone as any of the subnets of the existing mount targets

If the request satisfies the requirements, Amazon EFS does the following:

  • Creates a new mount target in the specified subnet.

  • Also creates a new network interface in the subnet as follows:

    • If the request provides an IpAddress, Amazon EFS assigns that IP address to the network interface. Otherwise, Amazon EFS assigns a free address in the subnet (in the same way that the Amazon EC2 CreateNetworkInterface call does when a request does not specify a primary private IP address).

    • If the request provides SecurityGroups, this network interface is associated with those security groups. Otherwise, it belongs to the default security group for the subnet's VPC.

    • Assigns the description Mount target fsmt-id for file system fs-id where fsmt-id is the mount target ID, and fs-id is the FileSystemId.

    • Sets the requesterManaged property of the network interface to true, and the requesterId value to EFS.

    Each Amazon EFS mount target has one corresponding requester-managed EC2 network interface. After the network interface is created, Amazon EFS sets the NetworkInterfaceId field in the mount target's description to the network interface ID, and the IpAddress field to its address. If network interface creation fails, the entire CreateMountTarget operation fails.

The CreateMountTarget call returns only after creating the network interface, but while the mount target state is still creating, you can check the mount target creation status by calling the DescribeMountTargets operation, which among other things returns the mount target state.

We recommend you create a mount target in each of the Availability Zones. There are cost considerations for using a file system in an Availability Zone through a mount target created in another Availability Zone. For more information, see Amazon EFS. In addition, by always using a mount target local to the instance's Availability Zone, you eliminate a partial failure scenario. If the Availability Zone in which your mount target is created goes down, then you won't be able to access your file system through that mount target.

This operation requires permissions for the following action on the file system:

  • elasticfilesystem:CreateMountTarget

This operation also requires permissions for the following Amazon EC2 actions:

  • ec2:DescribeSubnets

  • ec2:DescribeNetworkInterfaces

  • ec2:CreateNetworkInterface

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/2015-02-01/create-tags/{FileSystemId}", - "responseCode":204 - }, - "input":{"shape":"CreateTagsRequest"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"} - ], - "documentation":"

Creates or overwrites tags associated with a file system. Each tag is a key-value pair. If a tag key specified in the request already exists on the file system, this operation overwrites its value with the value provided in the request. If you add the Name tag to your file system, Amazon EFS returns it in the response to the DescribeFileSystems operation.

This operation requires permission for the elasticfilesystem:CreateTags action.

" - }, - "DeleteFileSystem":{ - "name":"DeleteFileSystem", - "http":{ - "method":"DELETE", - "requestUri":"/2015-02-01/file-systems/{FileSystemId}", - "responseCode":204 - }, - "input":{"shape":"DeleteFileSystemRequest"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"}, - {"shape":"FileSystemInUse"} - ], - "documentation":"

Deletes a file system, permanently severing access to its contents. Upon return, the file system no longer exists and you can't access any contents of the deleted file system.

You can't delete a file system that is in use. That is, if the file system has any mount targets, you must first delete them. For more information, see DescribeMountTargets and DeleteMountTarget.

The DeleteFileSystem call returns while the file system state is still deleting. You can check the file system deletion status by calling the DescribeFileSystems operation, which returns a list of file systems in your account. If you pass file system ID or creation token for the deleted file system, the DescribeFileSystems returns a 404 FileSystemNotFound error.

This operation requires permissions for the elasticfilesystem:DeleteFileSystem action.

" - }, - "DeleteMountTarget":{ - "name":"DeleteMountTarget", - "http":{ - "method":"DELETE", - "requestUri":"/2015-02-01/mount-targets/{MountTargetId}", - "responseCode":204 - }, - "input":{"shape":"DeleteMountTargetRequest"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"DependencyTimeout"}, - {"shape":"MountTargetNotFound"} - ], - "documentation":"

Deletes the specified mount target.

This operation forcibly breaks any mounts of the file system via the mount target that is being deleted, which might disrupt instances or applications using those mounts. To avoid applications getting cut off abruptly, you might consider unmounting any mounts of the mount target, if feasible. The operation also deletes the associated network interface. Uncommitted writes may be lost, but breaking a mount target using this operation does not corrupt the file system itself. The file system you created remains. You can mount an EC2 instance in your VPC via another mount target.

This operation requires permissions for the following action on the file system:

  • elasticfilesystem:DeleteMountTarget

The DeleteMountTarget call returns while the mount target state is still deleting. You can check the mount target deletion by calling the DescribeMountTargets operation, which returns a list of mount target descriptions for the given file system.

The operation also requires permissions for the following Amazon EC2 action on the mount target's network interface:

  • ec2:DeleteNetworkInterface

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/2015-02-01/delete-tags/{FileSystemId}", - "responseCode":204 - }, - "input":{"shape":"DeleteTagsRequest"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"} - ], - "documentation":"

Deletes the specified tags from a file system. If the DeleteTags request includes a tag key that does not exist, Amazon EFS ignores it and doesn't cause an error. For more information about tags and related restrictions, see Tag Restrictions in the AWS Billing and Cost Management User Guide.

This operation requires permissions for the elasticfilesystem:DeleteTags action.

" - }, - "DescribeFileSystems":{ - "name":"DescribeFileSystems", - "http":{ - "method":"GET", - "requestUri":"/2015-02-01/file-systems", - "responseCode":200 - }, - "input":{"shape":"DescribeFileSystemsRequest"}, - "output":{"shape":"DescribeFileSystemsResponse"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"} - ], - "documentation":"

Returns the description of a specific Amazon EFS file system if either the file system CreationToken or the FileSystemId is provided. Otherwise, it returns descriptions of all file systems owned by the caller's AWS account in the AWS Region of the endpoint that you're calling.

When retrieving all file system descriptions, you can optionally specify the MaxItems parameter to limit the number of descriptions in a response. If more file system descriptions remain, Amazon EFS returns a NextMarker, an opaque token, in the response. In this case, you should send a subsequent request with the Marker request parameter set to the value of NextMarker.

To retrieve a list of your file system descriptions, this operation is used in an iterative process, where DescribeFileSystems is called first without the Marker and then the operation continues to call it with the Marker parameter set to the value of the NextMarker from the previous response until the response has no NextMarker.

The implementation may return fewer than MaxItems file system descriptions while still including a NextMarker value.

The order of file systems returned in the response of one DescribeFileSystems call and the order of file systems returned across the responses of a multi-call iteration is unspecified.

This operation requires permissions for the elasticfilesystem:DescribeFileSystems action.

" - }, - "DescribeMountTargetSecurityGroups":{ - "name":"DescribeMountTargetSecurityGroups", - "http":{ - "method":"GET", - "requestUri":"/2015-02-01/mount-targets/{MountTargetId}/security-groups", - "responseCode":200 - }, - "input":{"shape":"DescribeMountTargetSecurityGroupsRequest"}, - "output":{"shape":"DescribeMountTargetSecurityGroupsResponse"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"MountTargetNotFound"}, - {"shape":"IncorrectMountTargetState"} - ], - "documentation":"

Returns the security groups currently in effect for a mount target. This operation requires that the network interface of the mount target has been created and the lifecycle state of the mount target is not deleted.

This operation requires permissions for the following actions:

  • elasticfilesystem:DescribeMountTargetSecurityGroups action on the mount target's file system.

  • ec2:DescribeNetworkInterfaceAttribute action on the mount target's network interface.

" - }, - "DescribeMountTargets":{ - "name":"DescribeMountTargets", - "http":{ - "method":"GET", - "requestUri":"/2015-02-01/mount-targets", - "responseCode":200 - }, - "input":{"shape":"DescribeMountTargetsRequest"}, - "output":{"shape":"DescribeMountTargetsResponse"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"}, - {"shape":"MountTargetNotFound"} - ], - "documentation":"

Returns the descriptions of all the current mount targets, or a specific mount target, for a file system. When requesting all of the current mount targets, the order of mount targets returned in the response is unspecified.

This operation requires permissions for the elasticfilesystem:DescribeMountTargets action, on either the file system ID that you specify in FileSystemId, or on the file system of the mount target that you specify in MountTargetId.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"GET", - "requestUri":"/2015-02-01/tags/{FileSystemId}/", - "responseCode":200 - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResponse"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"FileSystemNotFound"} - ], - "documentation":"

Returns the tags associated with a file system. The order of tags returned in the response of one DescribeTags call and the order of tags returned across the responses of a multi-call iteration (when using pagination) is unspecified.

This operation requires permissions for the elasticfilesystem:DescribeTags action.

" - }, - "ModifyMountTargetSecurityGroups":{ - "name":"ModifyMountTargetSecurityGroups", - "http":{ - "method":"PUT", - "requestUri":"/2015-02-01/mount-targets/{MountTargetId}/security-groups", - "responseCode":204 - }, - "input":{"shape":"ModifyMountTargetSecurityGroupsRequest"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"InternalServerError"}, - {"shape":"MountTargetNotFound"}, - {"shape":"IncorrectMountTargetState"}, - {"shape":"SecurityGroupLimitExceeded"}, - {"shape":"SecurityGroupNotFound"} - ], - "documentation":"

Modifies the set of security groups in effect for a mount target.

When you create a mount target, Amazon EFS also creates a new network interface. For more information, see CreateMountTarget. This operation replaces the security groups in effect for the network interface associated with a mount target, with the SecurityGroups provided in the request. This operation requires that the network interface of the mount target has been created and the lifecycle state of the mount target is not deleted.

The operation requires permissions for the following actions:

  • elasticfilesystem:ModifyMountTargetSecurityGroups action on the mount target's file system.

  • ec2:ModifyNetworkInterfaceAttribute action on the mount target's network interface.

" - }, - "UpdateFileSystem":{ - "name":"UpdateFileSystem", - "http":{ - "method":"PUT", - "requestUri":"/2015-02-01/file-systems/{FileSystemId}", - "responseCode":202 - }, - "input":{"shape":"UpdateFileSystemRequest"}, - "output":{"shape":"FileSystemDescription"}, - "errors":[ - {"shape":"BadRequest"}, - {"shape":"FileSystemNotFound"}, - {"shape":"IncorrectFileSystemLifeCycleState"}, - {"shape":"InsufficientThroughputCapacity"}, - {"shape":"InternalServerError"}, - {"shape":"ThroughputLimitExceeded"}, - {"shape":"TooManyRequests"} - ], - "documentation":"

Updates the throughput mode or the amount of provisioned throughput of an existing file system.

" - } - }, - "shapes":{ - "AwsAccountId":{"type":"string"}, - "BadRequest":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "CreateFileSystemRequest":{ - "type":"structure", - "required":["CreationToken"], - "members":{ - "CreationToken":{ - "shape":"CreationToken", - "documentation":"

String of up to 64 ASCII characters. Amazon EFS uses this to ensure idempotent creation.

" - }, - "PerformanceMode":{ - "shape":"PerformanceMode", - "documentation":"

The PerformanceMode of the file system. We recommend generalPurpose performance mode for most file systems. File systems using the maxIO performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. This can't be changed after the file system has been created.

" - }, - "Encrypted":{ - "shape":"Encrypted", - "documentation":"

A Boolean value that, if true, creates an encrypted file system. When creating an encrypted file system, you have the option of specifying a CreateFileSystemRequest$KmsKeyId for an existing AWS Key Management Service (AWS KMS) customer master key (CMK). If you don't specify a CMK, then the default CMK for Amazon EFS, /aws/elasticfilesystem, is used to protect the encrypted file system.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The ID of the AWS KMS CMK to be used to protect the encrypted file system. This parameter is only required if you want to use a non-default CMK. If this parameter is not specified, the default CMK for Amazon EFS is used. This ID can be in one of the following formats:

  • Key ID - A unique identifier of the key, for example, 1234abcd-12ab-34cd-56ef-1234567890ab.

  • ARN - An Amazon Resource Name (ARN) for the key, for example, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

  • Key alias - A previously created display name for a key. For example, alias/projectKey1.

  • Key alias ARN - An ARN for a key alias, for example, arn:aws:kms:us-west-2:444455556666:alias/projectKey1.

If KmsKeyId is specified, the CreateFileSystemRequest$Encrypted parameter must be set to true.

" - }, - "ThroughputMode":{ - "shape":"ThroughputMode", - "documentation":"

The throughput mode for the file system to be created. There are two throughput modes to choose from for your file system: bursting and provisioned. You can decrease your file system's throughput in Provisioned Throughput mode or change between the throughput modes as long as it’s been more than 24 hours since the last decrease or throughput mode change.

" - }, - "ProvisionedThroughputInMibps":{ - "shape":"ProvisionedThroughputInMibps", - "documentation":"

The throughput, measured in MiB/s, that you want to provision for a file system that you're creating. The limit on throughput is 1024 MiB/s. You can get these limits increased by contacting AWS Support. For more information, see Amazon EFS Limits That You Can Increase in the Amazon EFS User Guide.

" - } - } - }, - "CreateMountTargetRequest":{ - "type":"structure", - "required":[ - "FileSystemId", - "SubnetId" - ], - "members":{ - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system for which to create the mount target.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

ID of the subnet to add the mount target in.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

Valid IPv4 address within the address range of the specified subnet.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

Up to five VPC security group IDs, of the form sg-xxxxxxxx. These must be for the same VPC as subnet specified.

" - } - }, - "documentation":"

" - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "FileSystemId", - "Tags" - ], - "members":{ - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system whose tags you want to modify (String). This operation modifies the tags only, not the file system.

", - "location":"uri", - "locationName":"FileSystemId" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Array of Tag objects to add. Each Tag object is a key-value pair.

" - } - }, - "documentation":"

" - }, - "CreationToken":{ - "type":"string", - "max":64, - "min":1 - }, - "DeleteFileSystemRequest":{ - "type":"structure", - "required":["FileSystemId"], - "members":{ - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system you want to delete.

", - "location":"uri", - "locationName":"FileSystemId" - } - }, - "documentation":"

" - }, - "DeleteMountTargetRequest":{ - "type":"structure", - "required":["MountTargetId"], - "members":{ - "MountTargetId":{ - "shape":"MountTargetId", - "documentation":"

ID of the mount target to delete (String).

", - "location":"uri", - "locationName":"MountTargetId" - } - }, - "documentation":"

" - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":[ - "FileSystemId", - "TagKeys" - ], - "members":{ - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system whose tags you want to delete (String).

", - "location":"uri", - "locationName":"FileSystemId" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

List of tag keys to delete.

" - } - }, - "documentation":"

" - }, - "DependencyTimeout":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service timed out trying to fulfill the request, and the client should try the call again.

", - "error":{"httpStatusCode":504}, - "exception":true - }, - "DescribeFileSystemsRequest":{ - "type":"structure", - "members":{ - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

(Optional) Specifies the maximum number of file systems to return in the response (integer). This parameter value must be greater than 0. The number of items that Amazon EFS returns is the minimum of the MaxItems parameter specified in the request and the service's internal maximum number of items per page.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

(Optional) Opaque pagination token returned from a previous DescribeFileSystems operation (String). If present, specifies to continue the list from where the returning call had left off.

", - "location":"querystring", - "locationName":"Marker" - }, - "CreationToken":{ - "shape":"CreationToken", - "documentation":"

(Optional) Restricts the list to the file system with this creation token (String). You specify a creation token when you create an Amazon EFS file system.

", - "location":"querystring", - "locationName":"CreationToken" - }, - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

(Optional) ID of the file system whose description you want to retrieve (String).

", - "location":"querystring", - "locationName":"FileSystemId" - } - }, - "documentation":"

" - }, - "DescribeFileSystemsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

Present if provided by caller in the request (String).

" - }, - "FileSystems":{ - "shape":"FileSystemDescriptions", - "documentation":"

Array of file system descriptions.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

Present if there are more file systems than returned in the response (String). You can use the NextMarker in the subsequent request to fetch the descriptions.

" - } - } - }, - "DescribeMountTargetSecurityGroupsRequest":{ - "type":"structure", - "required":["MountTargetId"], - "members":{ - "MountTargetId":{ - "shape":"MountTargetId", - "documentation":"

ID of the mount target whose security groups you want to retrieve.

", - "location":"uri", - "locationName":"MountTargetId" - } - }, - "documentation":"

" - }, - "DescribeMountTargetSecurityGroupsResponse":{ - "type":"structure", - "required":["SecurityGroups"], - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

Array of security groups.

" - } - } - }, - "DescribeMountTargetsRequest":{ - "type":"structure", - "members":{ - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

(Optional) Maximum number of mount targets to return in the response. It must be an integer with a value greater than zero.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

(Optional) Opaque pagination token returned from a previous DescribeMountTargets operation (String). If present, it specifies to continue the list from where the previous returning call left off.

", - "location":"querystring", - "locationName":"Marker" - }, - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

(Optional) ID of the file system whose mount targets you want to list (String). It must be included in your request if MountTargetId is not included.

", - "location":"querystring", - "locationName":"FileSystemId" - }, - "MountTargetId":{ - "shape":"MountTargetId", - "documentation":"

(Optional) ID of the mount target that you want to have described (String). It must be included in your request if FileSystemId is not included.

", - "location":"querystring", - "locationName":"MountTargetId" - } - }, - "documentation":"

" - }, - "DescribeMountTargetsResponse":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

If the request included the Marker, the response returns that value in this field.

" - }, - "MountTargets":{ - "shape":"MountTargetDescriptions", - "documentation":"

Returns the file system's mount targets as an array of MountTargetDescription objects.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

If a value is present, there are more mount targets to return. In a subsequent request, you can provide Marker in your request with this value to retrieve the next set of mount targets.

" - } - }, - "documentation":"

" - }, - "DescribeTagsRequest":{ - "type":"structure", - "required":["FileSystemId"], - "members":{ - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

(Optional) Maximum number of file system tags to return in the response. It must be an integer with a value greater than zero.

", - "location":"querystring", - "locationName":"MaxItems" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

(Optional) Opaque pagination token returned from a previous DescribeTags operation (String). If present, it specifies to continue the list from where the previous call left off.

", - "location":"querystring", - "locationName":"Marker" - }, - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system whose tag set you want to retrieve.

", - "location":"uri", - "locationName":"FileSystemId" - } - }, - "documentation":"

" - }, - "DescribeTagsResponse":{ - "type":"structure", - "required":["Tags"], - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

If the request included a Marker, the response returns that value in this field.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Returns tags associated with the file system as an array of Tag objects.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

If a value is present, there are more tags to return. In a subsequent request, you can provide the value of NextMarker as the value of the Marker parameter in your next request to retrieve the next set of tags.

" - } - }, - "documentation":"

" - }, - "Encrypted":{"type":"boolean"}, - "ErrorCode":{ - "type":"string", - "min":1 - }, - "ErrorMessage":{"type":"string"}, - "FileSystemAlreadyExists":{ - "type":"structure", - "required":[ - "ErrorCode", - "FileSystemId" - ], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"}, - "FileSystemId":{"shape":"FileSystemId"} - }, - "documentation":"

Returned if the file system you are trying to create already exists, with the creation token you provided.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FileSystemDescription":{ - "type":"structure", - "required":[ - "OwnerId", - "CreationToken", - "FileSystemId", - "CreationTime", - "LifeCycleState", - "NumberOfMountTargets", - "SizeInBytes", - "PerformanceMode" - ], - "members":{ - "OwnerId":{ - "shape":"AwsAccountId", - "documentation":"

AWS account that created the file system. If the file system was created by an IAM user, the parent account to which the user belongs is the owner.

" - }, - "CreationToken":{ - "shape":"CreationToken", - "documentation":"

Opaque string specified in the request.

" - }, - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system, assigned by Amazon EFS.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time that the file system was created, in seconds (since 1970-01-01T00:00:00Z).

" - }, - "LifeCycleState":{ - "shape":"LifeCycleState", - "documentation":"

Lifecycle phase of the file system.

" - }, - "Name":{ - "shape":"TagValue", - "documentation":"

You can add tags to a file system, including a Name tag. For more information, see CreateTags. If the file system has a Name tag, Amazon EFS returns the value in this field.

" - }, - "NumberOfMountTargets":{ - "shape":"MountTargetCount", - "documentation":"

Current number of mount targets that the file system has. For more information, see CreateMountTarget.

" - }, - "SizeInBytes":{ - "shape":"FileSystemSize", - "documentation":"

Latest known metered size (in bytes) of data stored in the file system, in its Value field, and the time at which that size was determined in its Timestamp field. The Timestamp value is the integer number of seconds since 1970-01-01T00:00:00Z. The SizeInBytes value doesn't represent the size of a consistent snapshot of the file system, but it is eventually consistent when there are no writes to the file system. That is, SizeInBytes represents actual size only if the file system is not modified for a period longer than a couple of hours. Otherwise, the value is not the exact size that the file system was at any point in time.

" - }, - "PerformanceMode":{ - "shape":"PerformanceMode", - "documentation":"

The PerformanceMode of the file system.

" - }, - "Encrypted":{ - "shape":"Encrypted", - "documentation":"

A Boolean value that, if true, indicates that the file system is encrypted.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The ID of an AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the encrypted file system.

" - }, - "ThroughputMode":{ - "shape":"ThroughputMode", - "documentation":"

The throughput mode for a file system. There are two throughput modes to choose from for your file system: bursting and provisioned. You can decrease your file system's throughput in Provisioned Throughput mode or change between the throughput modes as long as it’s been more than 24 hours since the last decrease or throughput mode change.

" - }, - "ProvisionedThroughputInMibps":{ - "shape":"ProvisionedThroughputInMibps", - "documentation":"

The throughput, measured in MiB/s, that you want to provision for a file system. The limit on throughput is 1024 MiB/s. You can get these limits increased by contacting AWS Support. For more information, see Amazon EFS Limits That You Can Increase in the Amazon EFS User Guide.

" - } - }, - "documentation":"

Description of the file system.

" - }, - "FileSystemDescriptions":{ - "type":"list", - "member":{"shape":"FileSystemDescription"} - }, - "FileSystemId":{"type":"string"}, - "FileSystemInUse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if a file system has mount targets.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "FileSystemLimitExceeded":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the AWS account has already created the maximum number of file systems allowed per account.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "FileSystemNotFound":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the specified FileSystemId value doesn't exist in the requester's AWS account.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "FileSystemSize":{ - "type":"structure", - "required":["Value"], - "members":{ - "Value":{ - "shape":"FileSystemSizeValue", - "documentation":"

Latest known metered size (in bytes) of data stored in the file system.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time at which the size of data, returned in the Value field, was determined. The value is the integer number of seconds since 1970-01-01T00:00:00Z.

" - } - }, - "documentation":"

Latest known metered size (in bytes) of data stored in the file system, in its Value field, and the time at which that size was determined in its Timestamp field. Note that the value does not represent the size of a consistent snapshot of the file system, but it is eventually consistent when there are no writes to the file system. That is, the value will represent the actual size only if the file system is not modified for a period longer than a couple of hours. Otherwise, the value is not necessarily the exact size the file system was at any instant in time.

" - }, - "FileSystemSizeValue":{ - "type":"long", - "min":0 - }, - "IncorrectFileSystemLifeCycleState":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the file system's lifecycle state is not \"available\".

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "IncorrectMountTargetState":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the mount target is not in the correct state for the operation.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "InsufficientThroughputCapacity":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if there's not enough capacity to provision additional throughput. This value might be returned when you try to create a file system in provisioned throughput mode, when you attempt to increase the provisioned throughput of an existing file system, or when you attempt to change an existing file system from bursting to provisioned throughput mode.

", - "error":{"httpStatusCode":503}, - "exception":true - }, - "InternalServerError":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if an error occurred on the server side.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "IpAddress":{"type":"string"}, - "IpAddressInUse":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the request specified an IpAddress that is already in use in the subnet.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "KmsKeyId":{ - "type":"string", - "max":2048, - "min":1 - }, - "LifeCycleState":{ - "type":"string", - "enum":[ - "creating", - "available", - "updating", - "deleting", - "deleted" - ] - }, - "Marker":{"type":"string"}, - "MaxItems":{ - "type":"integer", - "min":1 - }, - "ModifyMountTargetSecurityGroupsRequest":{ - "type":"structure", - "required":["MountTargetId"], - "members":{ - "MountTargetId":{ - "shape":"MountTargetId", - "documentation":"

ID of the mount target whose security groups you want to modify.

", - "location":"uri", - "locationName":"MountTargetId" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

Array of up to five VPC security group IDs.

" - } - }, - "documentation":"

" - }, - "MountTargetConflict":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the mount target would violate one of the specified restrictions based on the file system's existing mount targets.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "MountTargetCount":{ - "type":"integer", - "min":0 - }, - "MountTargetDescription":{ - "type":"structure", - "required":[ - "MountTargetId", - "FileSystemId", - "SubnetId", - "LifeCycleState" - ], - "members":{ - "OwnerId":{ - "shape":"AwsAccountId", - "documentation":"

AWS account ID that owns the resource.

" - }, - "MountTargetId":{ - "shape":"MountTargetId", - "documentation":"

System-assigned mount target ID.

" - }, - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

ID of the file system for which the mount target is intended.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

ID of the mount target's subnet.

" - }, - "LifeCycleState":{ - "shape":"LifeCycleState", - "documentation":"

Lifecycle state of the mount target.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

Address at which the file system may be mounted via the mount target.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

ID of the network interface that Amazon EFS created when it created the mount target.

" - } - }, - "documentation":"

Provides a description of a mount target.

" - }, - "MountTargetDescriptions":{ - "type":"list", - "member":{"shape":"MountTargetDescription"} - }, - "MountTargetId":{"type":"string"}, - "MountTargetNotFound":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if there is no mount target with the specified ID found in the caller's account.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NetworkInterfaceId":{"type":"string"}, - "NetworkInterfaceLimitExceeded":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The calling account has reached the limit for elastic network interfaces for the specific AWS Region. The client should try to delete some elastic network interfaces or get the account limit raised. For more information, see Amazon VPC Limits in the Amazon VPC User Guide (see the Network interfaces per VPC entry in the table).

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "NoFreeAddressesInSubnet":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if IpAddress was not specified in the request and there are no free IP addresses in the subnet.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "PerformanceMode":{ - "type":"string", - "enum":[ - "generalPurpose", - "maxIO" - ] - }, - "ProvisionedThroughputInMibps":{ - "type":"double", - "min":0.0 - }, - "SecurityGroup":{"type":"string"}, - "SecurityGroupLimitExceeded":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the size of SecurityGroups specified in the request is greater than five.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SecurityGroupNotFound":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if one of the specified security groups doesn't exist in the subnet's VPC.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SecurityGroups":{ - "type":"list", - "member":{"shape":"SecurityGroup"}, - "max":5 - }, - "SubnetId":{"type":"string"}, - "SubnetNotFound":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if there is no subnet with ID SubnetId provided in the request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

Tag key (String). The key can't start with aws:.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

Value of the tag key.

" - } - }, - "documentation":"

A tag is a key-value pair. Allowed characters: letters, whitespace, and numbers, representable in UTF-8, and the following characters: + - = . _ : /

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagValue":{ - "type":"string", - "max":256 - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "ThroughputLimitExceeded":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if the throughput mode or amount of provisioned throughput can't be changed because the throughput limit of 1024 MiB/s has been reached.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ThroughputMode":{ - "type":"string", - "enum":[ - "bursting", - "provisioned" - ] - }, - "Timestamp":{"type":"timestamp"}, - "TooManyRequests":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Returned if you don’t wait at least 24 hours before changing the throughput mode, or decreasing the Provisioned Throughput value.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UnsupportedAvailabilityZone":{ - "type":"structure", - "required":["ErrorCode"], - "members":{ - "ErrorCode":{"shape":"ErrorCode"}, - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "UpdateFileSystemRequest":{ - "type":"structure", - "required":["FileSystemId"], - "members":{ - "FileSystemId":{ - "shape":"FileSystemId", - "documentation":"

The ID of the file system that you want to update.

", - "location":"uri", - "locationName":"FileSystemId" - }, - "ThroughputMode":{ - "shape":"ThroughputMode", - "documentation":"

(Optional) The throughput mode that you want your file system to use. If you're not updating your throughput mode, you don't need to provide this value in your request.

" - }, - "ProvisionedThroughputInMibps":{ - "shape":"ProvisionedThroughputInMibps", - "documentation":"

(Optional) The amount of throughput, in MiB/s, that you want to provision for your file system. If you're not updating the amount of provisioned throughput for your file system, you don't need to provide this value in your request.

" - } - } - } - }, - "documentation":"Amazon Elastic File System

Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage for use with Amazon EC2 instances in the AWS Cloud. With Amazon EFS, storage capacity is elastic, growing and shrinking automatically as you add and remove files, so your applications have the storage they need, when they need it. For more information, see the User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/service-2.json deleted file mode 100644 index 1f3813db..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/eks/2017-11-01/service-2.json +++ /dev/null @@ -1,422 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-11-01", - "endpointPrefix":"eks", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"Amazon EKS", - "serviceFullName":"Amazon Elastic Container Service for Kubernetes", - "serviceId":"EKS", - "signatureVersion":"v4", - "signingName":"eks", - "uid":"eks-2017-11-01" - }, - "operations":{ - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/clusters" - }, - "input":{"shape":"CreateClusterRequest"}, - "output":{"shape":"CreateClusterResponse"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServerException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnsupportedAvailabilityZoneException"} - ], - "documentation":"

Creates an Amazon EKS control plane.

The Amazon EKS control plane consists of control plane instances that run the Kubernetes software, like etcd and the API server. The control plane runs in an account managed by AWS, and the Kubernetes API is exposed via the Amazon EKS API server endpoint.

Amazon EKS worker nodes run in your AWS account and connect to your cluster's control plane via the Kubernetes API server endpoint and a certificate file that is created for your cluster.

The cluster control plane is provisioned across multiple Availability Zones and fronted by an Elastic Load Balancing Network Load Balancer. Amazon EKS also provisions elastic network interfaces in your VPC subnets to provide connectivity from the control plane instances to the worker nodes (for example, to support kubectl exec, logs, and proxy data flows).

After you create an Amazon EKS cluster, you must configure your Kubernetes tooling to communicate with the API server and launch worker nodes into your cluster. For more information, see Managing Cluster Authentication and Launching Amazon EKS Worker Nodesin the Amazon EKS User Guide.

" - }, - "DeleteCluster":{ - "name":"DeleteCluster", - "http":{ - "method":"DELETE", - "requestUri":"/clusters/{name}" - }, - "input":{"shape":"DeleteClusterRequest"}, - "output":{"shape":"DeleteClusterResponse"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ClientException"}, - {"shape":"ServerException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the Amazon EKS cluster control plane.

If you have active services in your cluster that are associated with a load balancer, you must delete those services before deleting the cluster so that the load balancers are deleted properly. Otherwise, you can have orphaned resources in your VPC that prevent you from being able to delete the VPC. For more information, see Deleting a Cluster in the Amazon EKS User Guide.

" - }, - "DescribeCluster":{ - "name":"DescribeCluster", - "http":{ - "method":"GET", - "requestUri":"/clusters/{name}" - }, - "input":{"shape":"DescribeClusterRequest"}, - "output":{"shape":"DescribeClusterResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ClientException"}, - {"shape":"ServerException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Returns descriptive information about an Amazon EKS cluster.

The API server endpoint and certificate authority data returned by this operation are required for kubelet and kubectl to communicate with your Kubernetes API server. For more information, see Create a kubeconfig for Amazon EKS.

The API server endpoint and certificate authority data are not available until the cluster reaches the ACTIVE state.

" - }, - "ListClusters":{ - "name":"ListClusters", - "http":{ - "method":"GET", - "requestUri":"/clusters" - }, - "input":{"shape":"ListClustersRequest"}, - "output":{"shape":"ListClustersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ClientException"}, - {"shape":"ServerException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the Amazon EKS clusters in your AWS account in the specified region.

" - } - }, - "shapes":{ - "Certificate":{ - "type":"structure", - "members":{ - "data":{ - "shape":"String", - "documentation":"

The base64 encoded certificate data required to communicate with your cluster. Add this to the certificate-authority-data section of the kubeconfig file for your cluster.

" - } - }, - "documentation":"

An object representing the certificate-authority-data for your cluster.

" - }, - "ClientException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a client action, such as using an action or resource on behalf of a user that doesn't have permissions to use the action or resource, or specifying an identifier that is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Cluster":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the cluster.

" - }, - "arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the cluster.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The Unix epoch time stamp in seconds for when the cluster was created.

" - }, - "version":{ - "shape":"String", - "documentation":"

The Kubernetes server version for the cluster.

" - }, - "endpoint":{ - "shape":"String", - "documentation":"

The endpoint for your Kubernetes API server.

" - }, - "roleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf.

" - }, - "resourcesVpcConfig":{ - "shape":"VpcConfigResponse", - "documentation":"

The VPC subnets and security groups used by the cluster control plane. Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide.

" - }, - "status":{ - "shape":"ClusterStatus", - "documentation":"

The current status of the cluster.

" - }, - "certificateAuthority":{ - "shape":"Certificate", - "documentation":"

The certificate-authority-data for your cluster.

" - }, - "clientRequestToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

" - } - }, - "documentation":"

An object representing an Amazon EKS cluster.

" - }, - "ClusterName":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[A-Za-z0-9\\-_]*" - }, - "ClusterStatus":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "DELETING", - "FAILED" - ] - }, - "CreateClusterRequest":{ - "type":"structure", - "required":[ - "name", - "roleArn", - "resourcesVpcConfig" - ], - "members":{ - "name":{ - "shape":"ClusterName", - "documentation":"

The unique name to give to your cluster.

" - }, - "version":{ - "shape":"String", - "documentation":"

The desired Kubernetes version for your cluster. If you do not specify a value here, the latest version available in Amazon EKS is used.

" - }, - "roleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that provides permissions for Amazon EKS to make calls to other AWS API operations on your behalf. For more information, see Amazon EKS Service IAM Role in the Amazon EKS User Guide

" - }, - "resourcesVpcConfig":{ - "shape":"VpcConfigRequest", - "documentation":"

The VPC subnets and security groups used by the cluster control plane. Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide.

" - }, - "clientRequestToken":{ - "shape":"String", - "documentation":"

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

", - "idempotencyToken":true - } - } - }, - "CreateClusterResponse":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"Cluster", - "documentation":"

The full description of your new cluster.

" - } - } - }, - "DeleteClusterRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the cluster to delete.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DeleteClusterResponse":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"Cluster", - "documentation":"

The full description of the cluster to delete.

" - } - } - }, - "DescribeClusterRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"String", - "documentation":"

The name of the cluster to describe.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DescribeClusterResponse":{ - "type":"structure", - "members":{ - "cluster":{ - "shape":"Cluster", - "documentation":"

The full description of your specified cluster.

" - } - } - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

The specified parameter is invalid. Review the available parameters for the API request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ListClustersRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"ListClustersRequestMaxResults", - "documentation":"

The maximum number of cluster results returned by ListClusters in paginated output. When this parameter is used, ListClusters only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListClusters request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, then ListClusters returns up to 100 results and a nextToken value if applicable.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value returned from a previous paginated ListClusters request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "location":"querystring", - "locationName":"nextToken" - } - } - }, - "ListClustersRequestMaxResults":{ - "type":"integer", - "box":true, - "max":100, - "min":1 - }, - "ListClustersResponse":{ - "type":"structure", - "members":{ - "clusters":{ - "shape":"StringList", - "documentation":"

A list of all of the clusters for your account in the specified region.

" - }, - "nextToken":{ - "shape":"String", - "documentation":"

The nextToken value to include in a future ListClusters request. When the results of a ListClusters request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

The specified resource is in use.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceLimitExceededException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

You have encountered a service limit on the specified resource.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

The specified resource could not be found. You can view your available clusters with ListClusters. Amazon EKS clusters are region-specific.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ServerException":{ - "type":"structure", - "members":{ - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "message":{"shape":"String"} - }, - "documentation":"

These errors are usually caused by a server-side issue.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The service is unavailable, back off and retry the operation.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Timestamp":{"type":"timestamp"}, - "UnsupportedAvailabilityZoneException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"}, - "clusterName":{ - "shape":"String", - "documentation":"

The Amazon EKS cluster associated with the exception.

" - }, - "validZones":{ - "shape":"StringList", - "documentation":"

The supported Availability Zones for your account. Choose subnets in these Availability Zones for your cluster.

" - } - }, - "documentation":"

At least one of your specified cluster subnets is in an Availability Zone that does not support Amazon EKS. The exception output will specify the supported Availability Zones for your account, from which you can choose subnets for your cluster.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "VpcConfigRequest":{ - "type":"structure", - "required":["subnetIds"], - "members":{ - "subnetIds":{ - "shape":"StringList", - "documentation":"

Specify subnets for your Amazon EKS worker nodes. Amazon EKS creates cross-account elastic network interfaces in these subnets to allow communication between your worker nodes and the Kubernetes control plane.

" - }, - "securityGroupIds":{ - "shape":"StringList", - "documentation":"

Specify one or more security groups for the cross-account elastic network interfaces that Amazon EKS creates to use to allow communication between your worker nodes and the Kubernetes control plane.

" - } - }, - "documentation":"

An object representing an Amazon EKS cluster VPC configuration request.

" - }, - "VpcConfigResponse":{ - "type":"structure", - "members":{ - "subnetIds":{ - "shape":"StringList", - "documentation":"

The subnets associated with your cluster.

" - }, - "securityGroupIds":{ - "shape":"StringList", - "documentation":"

The security groups associated with the cross-account elastic network interfaces that are used to allow communication between your worker nodes and the Kubernetes control plane.

" - }, - "vpcId":{ - "shape":"String", - "documentation":"

The VPC associated with your cluster.

" - } - }, - "documentation":"

An object representing an Amazon EKS cluster VPC configuration response.

" - } - }, - "documentation":"

Amazon Elastic Container Service for Kubernetes (Amazon EKS) is a managed service that makes it easy for you to run Kubernetes on AWS without needing to stand up or maintain your own Kubernetes control plane. Kubernetes is an open-source system for automating the deployment, scaling, and management of containerized applications.

Amazon EKS runs three Kubernetes control plane instances across three Availability Zones to ensure high availability. Amazon EKS automatically detects and replaces unhealthy control plane instances, and it provides automated version upgrades and patching for them.

Amazon EKS is also integrated with many AWS services to provide scalability and security for your applications, including the following:

  • Elastic Load Balancing for load distribution

  • IAM for authentication

  • Amazon VPC for isolation

Amazon EKS runs up to date versions of the open-source Kubernetes software, so you can use all the existing plugins and tooling from the Kubernetes community. Applications running on Amazon EKS are fully compatible with applications running on any standard Kubernetes environment, whether running in on-premises data centers or public clouds. This means that you can easily migrate any standard Kubernetes application to Amazon EKS without any code modification required.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/paginators-1.json deleted file mode 100644 index 8724740d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/paginators-1.json +++ /dev/null @@ -1,76 +0,0 @@ -{ - "pagination": { - "DescribeCacheClusters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheClusters" - }, - "DescribeCacheEngineVersions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheEngineVersions" - }, - "DescribeCacheParameterGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheParameterGroups" - }, - "DescribeCacheParameters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Parameters" - }, - "DescribeCacheSecurityGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheSecurityGroups" - }, - "DescribeCacheSubnetGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheSubnetGroups" - }, - "DescribeEngineDefaultParameters": { - "input_token": "Marker", - "output_token": "EngineDefaults.Marker", - "limit_key": "MaxRecords", - "result_key": "EngineDefaults.Parameters" - }, - "DescribeEvents": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Events" - }, - "DescribeReservedCacheNodes": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedCacheNodes" - }, - "DescribeReservedCacheNodesOfferings": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedCacheNodesOfferings" - }, - "DescribeReplicationGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReplicationGroups" - }, - "DescribeSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Snapshots" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/service-2.json deleted file mode 100644 index ca9a3351..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/service-2.json +++ /dev/null @@ -1,5049 +0,0 @@ -{ - "metadata":{ - "apiVersion":"2014-09-30", - "endpointPrefix":"elasticache", - "serviceFullName":"Amazon ElastiCache", - "signatureVersion":"v4", - "xmlNamespace":"http://elasticache.amazonaws.com/doc/2014-09-30/", - "protocol":"query" - }, - "documentation":"Amazon ElastiCache

Amazon ElastiCache is a web service that makes it easier to set up, operate, and scale a distributed cache in the cloud.

With ElastiCache, customers gain all of the benefits of a high-performance, in-memory cache with far less of the administrative burden of launching and managing a distributed cache. The service makes setup, scaling, and cluster failure handling much simpler than in a self-managed cache deployment.

In addition, through integration with Amazon CloudWatch, customers get enhanced visibility into the key performance statistics associated with their cache and can receive alarms if a part of their cache runs hot.

", - "operations":{ - "AuthorizeCacheSecurityGroupIngress":{ - "name":"AuthorizeCacheSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"AuthorizeCacheSecurityGroupIngressMessage", - "documentation":"

Represents the input of an AuthorizeCacheSecurityGroupIngress operation.

" - }, - "output":{ - "shape":"AuthorizeCacheSecurityGroupIngressResult", - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress
  • CreateCacheSecurityGroup
  • RevokeCacheSecurityGroupIngress
", - "resultWrapper":"AuthorizeCacheSecurityGroupIngressResult" - }, - "errors":[ - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"InvalidCacheSecurityGroupStateFault", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - { - "shape":"AuthorizationAlreadyExistsFault", - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified Amazon EC2 security group is already authorized for the specified cache security group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The AuthorizeCacheSecurityGroupIngress operation allows network ingress to a cache security group. Applications using ElastiCache must be running on Amazon EC2, and Amazon EC2 security groups are used as the authorization mechanism.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CopySnapshotMessage", - "documentation":"

Represents the input of a CopySnapshotMessage operation.

" - }, - "output":{ - "shape":"CopySnapshotResult", - "wrapper":true, - "documentation":"

Represents a copy of an entire cache cluster as of the time when the snapshot was taken.

", - "resultWrapper":"CopySnapshotResult" - }, - "errors":[ - { - "shape":"SnapshotAlreadyExistsFault", - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a snapshot with the given name.

" - }, - { - "shape":"SnapshotNotFoundFault", - "error":{ - "code":"SnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested snapshot name does not refer to an existing snapshot.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

" - }, - { - "shape":"InvalidSnapshotStateFault", - "error":{ - "code":"InvalidSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the snapshot does not allow the requested action to occur.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The CopySnapshot operation makes a copy of an existing snapshot.

" - }, - "CreateCacheCluster":{ - "name":"CreateCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateCacheClusterMessage", - "documentation":"

Represents the input of a CreateCacheCluster operation.

" - }, - "output":{ - "shape":"CreateCacheClusterResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific cache cluster.

", - "resultWrapper":"CreateCacheClusterResult" - }, - "errors":[ - { - "shape":"ReplicationGroupNotFoundFault", - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group does not exist.

" - }, - { - "shape":"InvalidReplicationGroupStateFault", - "error":{ - "code":"InvalidReplicationGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested replication group is not in the available state.

" - }, - { - "shape":"CacheClusterAlreadyExistsFault", - "error":{ - "code":"CacheClusterAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a cache cluster with the given identifier.

" - }, - { - "shape":"InsufficientCacheClusterCapacityFault", - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

" - }, - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"CacheSubnetGroupNotFoundFault", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - }, - { - "shape":"ClusterQuotaForCustomerExceededFault", - "error":{ - "code":"ClusterQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache clusters per customer.

" - }, - { - "shape":"NodeQuotaForClusterExceededFault", - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cache cluster.

" - }, - { - "shape":"NodeQuotaForCustomerExceededFault", - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The VPC network is in an invalid state.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The CreateCacheCluster operation creates a cache cluster. All nodes in the cache cluster run the same protocol-compliant cache engine software, either Memcached or Redis.

" - }, - "CreateCacheParameterGroup":{ - "name":"CreateCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateCacheParameterGroupMessage", - "documentation":"

Represents the input of a CreateCacheParameterGroup operation.

" - }, - "output":{ - "shape":"CreateCacheParameterGroupResult", - "wrapper":true, - "documentation":"

Represents the output of a CreateCacheParameterGroup operation.

", - "resultWrapper":"CreateCacheParameterGroupResult" - }, - "errors":[ - { - "shape":"CacheParameterGroupQuotaExceededFault", - "error":{ - "code":"CacheParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of cache security groups.

" - }, - { - "shape":"CacheParameterGroupAlreadyExistsFault", - "error":{ - "code":"CacheParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A cache parameter group with the requested name already exists.

" - }, - { - "shape":"InvalidCacheParameterGroupStateFault", - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache parameter group does not allow the requested action to occur.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The CreateCacheParameterGroup operation creates a new cache parameter group. A cache parameter group is a collection of parameters that you apply to all of the nodes in a cache cluster.

" - }, - "CreateCacheSecurityGroup":{ - "name":"CreateCacheSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateCacheSecurityGroupMessage", - "documentation":"

Represents the input of a CreateCacheSecurityGroup operation.

" - }, - "output":{ - "shape":"CreateCacheSecurityGroupResult", - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress
  • CreateCacheSecurityGroup
  • RevokeCacheSecurityGroupIngress
", - "resultWrapper":"CreateCacheSecurityGroupResult" - }, - "errors":[ - { - "shape":"CacheSecurityGroupAlreadyExistsFault", - "error":{ - "code":"CacheSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A cache security group with the specified name already exists.

" - }, - { - "shape":"CacheSecurityGroupQuotaExceededFault", - "error":{ - "code":"QuotaExceeded.CacheSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache security groups.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The CreateCacheSecurityGroup operation creates a new cache security group. Use a cache security group to control access to one or more cache clusters.

Cache security groups are only used when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC). If you are creating a cache cluster inside of a VPC, use a cache subnet group instead. For more information, see CreateCacheSubnetGroup.

" - }, - "CreateCacheSubnetGroup":{ - "name":"CreateCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateCacheSubnetGroupMessage", - "documentation":"

Represents the input of a CreateCacheSubnetGroup operation.

" - }, - "output":{ - "shape":"CreateCacheSubnetGroupResult", - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • CreateCacheSubnetGroup
  • ModifyCacheSubnetGroup
", - "resultWrapper":"CreateCacheSubnetGroupResult" - }, - "errors":[ - { - "shape":"CacheSubnetGroupAlreadyExistsFault", - "error":{ - "code":"CacheSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name is already in use by an existing cache subnet group.

" - }, - { - "shape":"CacheSubnetGroupQuotaExceededFault", - "error":{ - "code":"CacheSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache subnet groups.

" - }, - { - "shape":"CacheSubnetQuotaExceededFault", - "error":{ - "code":"CacheSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a cache subnet group.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

An invalid subnet identifier was specified.

" - } - ], - "documentation":"

The CreateCacheSubnetGroup operation creates a new cache subnet group.

Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (VPC).

" - }, - "CreateReplicationGroup":{ - "name":"CreateReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateReplicationGroupMessage", - "documentation":"

Represents the input of a CreateReplicationGroup operation.

" - }, - "output":{ - "shape":"CreateReplicationGroupResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific replication group.

", - "resultWrapper":"CreateReplicationGroupResult" - }, - "errors":[ - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"ReplicationGroupAlreadyExistsFault", - "error":{ - "code":"ReplicationGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group already exists.

" - }, - { - "shape":"InsufficientCacheClusterCapacityFault", - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

" - }, - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"CacheSubnetGroupNotFoundFault", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - }, - { - "shape":"ClusterQuotaForCustomerExceededFault", - "error":{ - "code":"ClusterQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache clusters per customer.

" - }, - { - "shape":"NodeQuotaForClusterExceededFault", - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cache cluster.

" - }, - { - "shape":"NodeQuotaForCustomerExceededFault", - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The VPC network is in an invalid state.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The CreateReplicationGroup operation creates a replication group. A replication group is a collection of cache clusters, where one of the cache clusters is a read/write primary and the others are read-only replicas. Writes to the primary are automatically propagated to the replicas.

When you create a replication group, you must specify an existing cache cluster that is in the primary role. When the replication group has been successfully created, you can add one or more read replica replicas to it, up to a total of five read replicas.

Note: This action is valid only for Redis.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateSnapshotMessage", - "documentation":"

Represents the input of a CreateSnapshot operation.

" - }, - "output":{ - "shape":"CreateSnapshotResult", - "wrapper":true, - "documentation":"

Represents a copy of an entire cache cluster as of the time when the snapshot was taken.

", - "resultWrapper":"CreateSnapshotResult" - }, - "errors":[ - { - "shape":"SnapshotAlreadyExistsFault", - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a snapshot with the given name.

" - }, - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

" - }, - { - "shape":"SnapshotFeatureNotSupportedFault", - "error":{ - "code":"SnapshotFeatureNotSupportedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You attempted one of the following actions:

  • Creating a snapshot of a Redis cache cluster running on a t1.micro cache node.

  • Creating a snapshot of a cache cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - } - ], - "documentation":"

The CreateSnapshot operation creates a copy of an entire cache cluster at a specific moment in time.

" - }, - "DeleteCacheCluster":{ - "name":"DeleteCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteCacheClusterMessage", - "documentation":"

Represents the input of a DeleteCacheCluster operation.

" - }, - "output":{ - "shape":"DeleteCacheClusterResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific cache cluster.

", - "resultWrapper":"DeleteCacheClusterResult" - }, - "errors":[ - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"SnapshotAlreadyExistsFault", - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a snapshot with the given name.

" - }, - { - "shape":"SnapshotFeatureNotSupportedFault", - "error":{ - "code":"SnapshotFeatureNotSupportedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You attempted one of the following actions:

  • Creating a snapshot of a Redis cache cluster running on a t1.micro cache node.

  • Creating a snapshot of a cache cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DeleteCacheCluster operation deletes a previously provisioned cache cluster. DeleteCacheCluster deletes all associated cache nodes, node endpoints and the cache cluster itself. When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the cache cluster; you cannot cancel or revert this operation.

This API cannot be used to delete a cache cluster that is the last read replica of a replication group that has automatic failover mode enabled.

" - }, - "DeleteCacheParameterGroup":{ - "name":"DeleteCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteCacheParameterGroupMessage", - "documentation":"

Represents the input of a DeleteCacheParameterGroup operation.

" - }, - "errors":[ - { - "shape":"InvalidCacheParameterGroupStateFault", - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache parameter group does not allow the requested action to occur.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DeleteCacheParameterGroup operation deletes the specified cache parameter group. You cannot delete a cache parameter group if it is associated with any cache clusters.

" - }, - "DeleteCacheSecurityGroup":{ - "name":"DeleteCacheSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteCacheSecurityGroupMessage", - "documentation":"

Represents the input of a DeleteCacheSecurityGroup operation.

" - }, - "errors":[ - { - "shape":"InvalidCacheSecurityGroupStateFault", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DeleteCacheSecurityGroup operation deletes a cache security group.

" - }, - "DeleteCacheSubnetGroup":{ - "name":"DeleteCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteCacheSubnetGroupMessage", - "documentation":"

Represents the input of a DeleteCacheSubnetGroup operation.

" - }, - "errors":[ - { - "shape":"CacheSubnetGroupInUse", - "error":{ - "code":"CacheSubnetGroupInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group is currently in use.

" - }, - { - "shape":"CacheSubnetGroupNotFoundFault", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - } - ], - "documentation":"

The DeleteCacheSubnetGroup operation deletes a cache subnet group.

" - }, - "DeleteReplicationGroup":{ - "name":"DeleteReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteReplicationGroupMessage", - "documentation":"

Represents the input of a DeleteReplicationGroup operation.

" - }, - "output":{ - "shape":"DeleteReplicationGroupResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific replication group.

", - "resultWrapper":"DeleteReplicationGroupResult" - }, - "errors":[ - { - "shape":"ReplicationGroupNotFoundFault", - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group does not exist.

" - }, - { - "shape":"InvalidReplicationGroupStateFault", - "error":{ - "code":"InvalidReplicationGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested replication group is not in the available state.

" - }, - { - "shape":"SnapshotAlreadyExistsFault", - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a snapshot with the given name.

" - }, - { - "shape":"SnapshotFeatureNotSupportedFault", - "error":{ - "code":"SnapshotFeatureNotSupportedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You attempted one of the following actions:

  • Creating a snapshot of a Redis cache cluster running on a t1.micro cache node.

  • Creating a snapshot of a cache cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DeleteReplicationGroup operation deletes an existing cluster. By default, this operation deletes the entire cluster, including the primary node group and all of the read replicas. You can optionally delete only the read replicas, while retaining the primary node group.

When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the selected resources; you cannot cancel or revert this operation.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteSnapshotMessage", - "documentation":"

Represents the input of a DeleteSnapshot operation.

" - }, - "output":{ - "shape":"DeleteSnapshotResult", - "wrapper":true, - "documentation":"

Represents a copy of an entire cache cluster as of the time when the snapshot was taken.

", - "resultWrapper":"DeleteSnapshotResult" - }, - "errors":[ - { - "shape":"SnapshotNotFoundFault", - "error":{ - "code":"SnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested snapshot name does not refer to an existing snapshot.

" - }, - { - "shape":"InvalidSnapshotStateFault", - "error":{ - "code":"InvalidSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the snapshot does not allow the requested action to occur.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DeleteSnapshot operation deletes an existing snapshot. When you receive a successful response from this operation, ElastiCache immediately begins deleting the snapshot; you cannot cancel or revert this operation.

" - }, - "DescribeCacheClusters":{ - "name":"DescribeCacheClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheClustersMessage", - "documentation":"

Represents the input of a DescribeCacheClusters operation.

" - }, - "output":{ - "shape":"CacheClusterMessage", - "documentation":"

Represents the output of a DescribeCacheClusters operation.

", - "resultWrapper":"DescribeCacheClustersResult" - }, - "errors":[ - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeCacheClusters operation returns information about all provisioned cache clusters if no cache cluster identifier is specified, or about a specific cache cluster if a cache cluster identifier is supplied.

By default, abbreviated information about the cache clusters(s) will be returned. You can use the optional ShowDetails flag to retrieve detailed information about the cache nodes associated with the cache clusters. These details include the DNS address and port for the cache node endpoint.

If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned.

If the cluster is in the DELETING state, only cluster level information will be displayed.

If cache nodes are currently being added to the cache cluster, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. When the cache cluster state is available, the cluster is ready for use.

If cache nodes are currently being removed from the cache cluster, no endpoint information for the removed nodes is displayed.

" - }, - "DescribeCacheEngineVersions":{ - "name":"DescribeCacheEngineVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheEngineVersionsMessage", - "documentation":"

Represents the input of a DescribeCacheEngineVersions operation.

" - }, - "output":{ - "shape":"CacheEngineVersionMessage", - "documentation":"

Represents the output of a DescribeCacheEngineVersions operation.

", - "resultWrapper":"DescribeCacheEngineVersionsResult" - }, - "documentation":"

The DescribeCacheEngineVersions operation returns a list of the available cache engines and their versions.

" - }, - "DescribeCacheParameterGroups":{ - "name":"DescribeCacheParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheParameterGroupsMessage", - "documentation":"

Represents the input of a DescribeCacheParameterGroups operation.

" - }, - "output":{ - "shape":"CacheParameterGroupsMessage", - "documentation":"

Represents the output of a DescribeCacheParameterGroups operation.

", - "resultWrapper":"DescribeCacheParameterGroupsResult" - }, - "errors":[ - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeCacheParameterGroups operation returns a list of cache parameter group descriptions. If a cache parameter group name is specified, the list will contain only the descriptions for that group.

" - }, - "DescribeCacheParameters":{ - "name":"DescribeCacheParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheParametersMessage", - "documentation":"

Represents the input of a DescribeCacheParameters operation.

" - }, - "output":{ - "shape":"CacheParameterGroupDetails", - "documentation":"

Represents the output of a DescribeCacheParameters operation.

", - "resultWrapper":"DescribeCacheParametersResult" - }, - "errors":[ - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeCacheParameters operation returns the detailed parameter list for a particular cache parameter group.

" - }, - "DescribeCacheSecurityGroups":{ - "name":"DescribeCacheSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheSecurityGroupsMessage", - "documentation":"

Represents the input of a DescribeCacheSecurityGroups operation.

" - }, - "output":{ - "shape":"CacheSecurityGroupMessage", - "documentation":"

Represents the output of a DescribeCacheSecurityGroups operation.

", - "resultWrapper":"DescribeCacheSecurityGroupsResult" - }, - "errors":[ - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeCacheSecurityGroups operation returns a list of cache security group descriptions. If a cache security group name is specified, the list will contain only the description of that group.

" - }, - "DescribeCacheSubnetGroups":{ - "name":"DescribeCacheSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeCacheSubnetGroupsMessage", - "documentation":"

Represents the input of a DescribeCacheSubnetGroups operation.

" - }, - "output":{ - "shape":"CacheSubnetGroupMessage", - "documentation":"

Represents the output of a DescribeCacheSubnetGroups operation.

", - "resultWrapper":"DescribeCacheSubnetGroupsResult" - }, - "errors":[ - { - "shape":"CacheSubnetGroupNotFoundFault", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - } - ], - "documentation":"

The DescribeCacheSubnetGroups operation returns a list of cache subnet group descriptions. If a subnet group name is specified, the list will contain only the description of that group.

" - }, - "DescribeEngineDefaultParameters":{ - "name":"DescribeEngineDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEngineDefaultParametersMessage", - "documentation":"

Represents the input of a DescribeEngineDefaultParameters operation.

" - }, - "output":{ - "shape":"DescribeEngineDefaultParametersResult", - "wrapper":true, - "documentation":"

Represents the output of a DescribeEngineDefaultParameters operation.

", - "resultWrapper":"DescribeEngineDefaultParametersResult" - }, - "errors":[ - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeEngineDefaultParameters operation returns the default engine and system parameter information for the specified cache engine.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEventsMessage", - "documentation":"

Represents the input of a DescribeEvents operation.

" - }, - "output":{ - "shape":"EventsMessage", - "documentation":"

Represents the output of a DescribeEvents operation.

", - "resultWrapper":"DescribeEventsResult" - }, - "errors":[ - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeEvents operation returns events related to cache clusters, cache security groups, and cache parameter groups. You can obtain events specific to a particular cache cluster, cache security group, or cache parameter group by providing the name as a parameter.

By default, only the events occurring within the last hour are returned; however, you can retrieve up to 14 days' worth of events if necessary.

" - }, - "DescribeReplicationGroups":{ - "name":"DescribeReplicationGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeReplicationGroupsMessage", - "documentation":"

Represents the input of a DescribeReplicationGroups operation.

" - }, - "output":{ - "shape":"ReplicationGroupMessage", - "documentation":"

Represents the output of a DescribeReplicationGroups operation.

", - "resultWrapper":"DescribeReplicationGroupsResult" - }, - "errors":[ - { - "shape":"ReplicationGroupNotFoundFault", - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeReplicationGroups operation returns information about a particular replication group. If no identifier is specified, DescribeReplicationGroups returns information about all replication groups.

" - }, - "DescribeReservedCacheNodes":{ - "name":"DescribeReservedCacheNodes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeReservedCacheNodesMessage", - "documentation":"

Represents the input of a DescribeReservedCacheNodes operation.

" - }, - "output":{ - "shape":"ReservedCacheNodeMessage", - "documentation":"

Represents the output of a DescribeReservedCacheNodes operation.

", - "resultWrapper":"DescribeReservedCacheNodesResult" - }, - "errors":[ - { - "shape":"ReservedCacheNodeNotFoundFault", - "error":{ - "code":"ReservedCacheNodeNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested reserved cache node was not found.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeReservedCacheNodes operation returns information about reserved cache nodes for this account, or about a specified reserved cache node.

" - }, - "DescribeReservedCacheNodesOfferings":{ - "name":"DescribeReservedCacheNodesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeReservedCacheNodesOfferingsMessage", - "documentation":"

Represents the input of a DescribeReservedCacheNodesOfferings operation.

" - }, - "output":{ - "shape":"ReservedCacheNodesOfferingMessage", - "documentation":"

Represents the output of a DescribeReservedCacheNodesOfferings operation.

", - "resultWrapper":"DescribeReservedCacheNodesOfferingsResult" - }, - "errors":[ - { - "shape":"ReservedCacheNodesOfferingNotFoundFault", - "error":{ - "code":"ReservedCacheNodesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node offering does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeReservedCacheNodesOfferings operation lists available reserved cache node offerings.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeSnapshotsMessage", - "documentation":"

Represents the input of a DescribeSnapshotsMessage operation.

" - }, - "output":{ - "shape":"DescribeSnapshotsListMessage", - "documentation":"

Represents the output of a DescribeSnapshots operation.

", - "resultWrapper":"DescribeSnapshotsResult" - }, - "errors":[ - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"SnapshotNotFoundFault", - "error":{ - "code":"SnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested snapshot name does not refer to an existing snapshot.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The DescribeSnapshots operation returns information about cache cluster snapshots. By default, DescribeSnapshots lists all of your snapshots; it can optionally describe a single snapshot, or just the snapshots associated with a particular cache cluster.

" - }, - "ModifyCacheCluster":{ - "name":"ModifyCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyCacheClusterMessage", - "documentation":"

Represents the input of a ModifyCacheCluster operation.

" - }, - "output":{ - "shape":"ModifyCacheClusterResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific cache cluster.

", - "resultWrapper":"ModifyCacheClusterResult" - }, - "errors":[ - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"InvalidCacheSecurityGroupStateFault", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - { - "shape":"InsufficientCacheClusterCapacityFault", - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

" - }, - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"NodeQuotaForClusterExceededFault", - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cache cluster.

" - }, - { - "shape":"NodeQuotaForCustomerExceededFault", - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

" - }, - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The VPC network is in an invalid state.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The ModifyCacheCluster operation modifies the settings for a cache cluster. You can use this operation to change one or more cluster configuration parameters by specifying the parameters and the new values.

" - }, - "ModifyCacheParameterGroup":{ - "name":"ModifyCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyCacheParameterGroupMessage", - "documentation":"

Represents the input of a ModifyCacheParameterGroup operation.

" - }, - "output":{ - "shape":"CacheParameterGroupNameMessage", - "documentation":"

Represents the output of one of the following operations:

  • ModifyCacheParameterGroup
  • ResetCacheParameterGroup
", - "resultWrapper":"ModifyCacheParameterGroupResult" - }, - "errors":[ - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidCacheParameterGroupStateFault", - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache parameter group does not allow the requested action to occur.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The ModifyCacheParameterGroup operation modifies the parameters of a cache parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.

" - }, - "ModifyCacheSubnetGroup":{ - "name":"ModifyCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyCacheSubnetGroupMessage", - "documentation":"

Represents the input of a ModifyCacheSubnetGroup operation.

" - }, - "output":{ - "shape":"ModifyCacheSubnetGroupResult", - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • CreateCacheSubnetGroup
  • ModifyCacheSubnetGroup
", - "resultWrapper":"ModifyCacheSubnetGroupResult" - }, - "errors":[ - { - "shape":"CacheSubnetGroupNotFoundFault", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - }, - { - "shape":"CacheSubnetQuotaExceededFault", - "error":{ - "code":"CacheSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a cache subnet group.

" - }, - { - "shape":"SubnetInUse", - "error":{ - "code":"SubnetInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is being used by another cache subnet group.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

An invalid subnet identifier was specified.

" - } - ], - "documentation":"

The ModifyCacheSubnetGroup operation modifies an existing cache subnet group.

" - }, - "ModifyReplicationGroup":{ - "name":"ModifyReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyReplicationGroupMessage", - "documentation":"

Represents the input of a ModifyReplicationGroups operation.

" - }, - "output":{ - "shape":"ModifyReplicationGroupResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific replication group.

", - "resultWrapper":"ModifyReplicationGroupResult" - }, - "errors":[ - { - "shape":"ReplicationGroupNotFoundFault", - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group does not exist.

" - }, - { - "shape":"InvalidReplicationGroupStateFault", - "error":{ - "code":"InvalidReplicationGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested replication group is not in the available state.

" - }, - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"InvalidCacheSecurityGroupStateFault", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - { - "shape":"InsufficientCacheClusterCapacityFault", - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

" - }, - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - { - "shape":"NodeQuotaForClusterExceededFault", - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cache cluster.

" - }, - { - "shape":"NodeQuotaForCustomerExceededFault", - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

" - }, - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The VPC network is in an invalid state.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The ModifyReplicationGroup operation modifies the settings for a replication group.

" - }, - "PurchaseReservedCacheNodesOffering":{ - "name":"PurchaseReservedCacheNodesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PurchaseReservedCacheNodesOfferingMessage", - "documentation":"

Represents the input of a PurchaseReservedCacheNodesOffering operation.

" - }, - "output":{ - "shape":"PurchaseReservedCacheNodesOfferingResult", - "wrapper":true, - "documentation":"

Represents the output of a PurchaseReservedCacheNodesOffering operation.

", - "resultWrapper":"PurchaseReservedCacheNodesOfferingResult" - }, - "errors":[ - { - "shape":"ReservedCacheNodesOfferingNotFoundFault", - "error":{ - "code":"ReservedCacheNodesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node offering does not exist.

" - }, - { - "shape":"ReservedCacheNodeAlreadyExistsFault", - "error":{ - "code":"ReservedCacheNodeAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a reservation with the given identifier.

" - }, - { - "shape":"ReservedCacheNodeQuotaExceededFault", - "error":{ - "code":"ReservedCacheNodeQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the user's cache node quota.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The PurchaseReservedCacheNodesOffering operation allows you to purchase a reserved cache node offering.

" - }, - "RebootCacheCluster":{ - "name":"RebootCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RebootCacheClusterMessage", - "documentation":"

Represents the input of a RebootCacheCluster operation.

" - }, - "output":{ - "shape":"RebootCacheClusterResult", - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific cache cluster.

", - "resultWrapper":"RebootCacheClusterResult" - }, - "errors":[ - { - "shape":"InvalidCacheClusterStateFault", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - { - "shape":"CacheClusterNotFoundFault", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - } - ], - "documentation":"

The RebootCacheCluster operation reboots some, or all, of the cache nodes within a provisioned cache cluster. This API will apply any modified cache parameter groups to the cache cluster. The reboot action takes place as soon as possible, and results in a momentary outage to the cache cluster. During the reboot, the cache cluster status is set to REBOOTING.

The reboot causes the contents of the cache (for each cache node being rebooted) to be lost.

When the reboot is complete, a cache cluster event is created.

" - }, - "ResetCacheParameterGroup":{ - "name":"ResetCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ResetCacheParameterGroupMessage", - "documentation":"

Represents the input of a ResetCacheParameterGroup operation.

" - }, - "output":{ - "shape":"CacheParameterGroupNameMessage", - "documentation":"

Represents the output of one of the following operations:

  • ModifyCacheParameterGroup
  • ResetCacheParameterGroup
", - "resultWrapper":"ResetCacheParameterGroupResult" - }, - "errors":[ - { - "shape":"InvalidCacheParameterGroupStateFault", - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache parameter group does not allow the requested action to occur.

" - }, - { - "shape":"CacheParameterGroupNotFoundFault", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The ResetCacheParameterGroup operation modifies the parameters of a cache parameter group to the engine or system default value. You can reset specific parameters by submitting a list of parameter names. To reset the entire cache parameter group, specify the ResetAllParameters and CacheParameterGroupName parameters.

" - }, - "RevokeCacheSecurityGroupIngress":{ - "name":"RevokeCacheSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RevokeCacheSecurityGroupIngressMessage", - "documentation":"

Represents the input of a RevokeCacheSecurityGroupIngress operation.

" - }, - "output":{ - "shape":"RevokeCacheSecurityGroupIngressResult", - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress
  • CreateCacheSecurityGroup
  • RevokeCacheSecurityGroupIngress
", - "resultWrapper":"RevokeCacheSecurityGroupIngressResult" - }, - "errors":[ - { - "shape":"CacheSecurityGroupNotFoundFault", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified Amazon EC2 security group is not authorized for the specified cache security group.

" - }, - { - "shape":"InvalidCacheSecurityGroupStateFault", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidParameterCombinationException", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - } - ], - "documentation":"

The RevokeCacheSecurityGroupIngress operation revokes ingress from a cache security group. Use this operation to disallow access from an Amazon EC2 security group that had been previously authorized.

" - } - }, - "shapes":{ - "AZMode":{ - "type":"string", - "enum":[ - "single-az", - "cross-az" - ] - }, - "AuthorizationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified Amazon EC2 security group is already authorized for the specified cache security group.

" - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified Amazon EC2 security group is not authorized for the specified cache security group.

" - }, - "AuthorizeCacheSecurityGroupIngressMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "EC2SecurityGroupName", - "EC2SecurityGroupOwnerId" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The cache security group which will allow network ingress.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The Amazon EC2 security group to be authorized for ingress to the cache security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the Amazon EC2 security group owner. Note that this is not the same thing as an AWS access key ID - you must provide a valid AWS account number for this parameter.

" - } - }, - "documentation":"

Represents the input of an AuthorizeCacheSecurityGroupIngress operation.

" - }, - "AutomaticFailoverStatus":{ - "type":"string", - "enum":[ - "enabled", - "disabled", - "enabling", - "disabling" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

" - } - }, - "wrapper":true, - "documentation":"

Describes an Availability Zone in which the cache cluster is launched.

" - }, - "AvailabilityZonesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AvailabilityZone" - } - }, - "AwsQueryErrorMessage":{"type":"string"}, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "CacheCluster":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied identifier of the cache cluster. This identifier is a unique key that identifies a cache cluster.

" - }, - "ConfigurationEndpoint":{"shape":"Endpoint"}, - "ClientDownloadLandingPage":{ - "shape":"String", - "documentation":"

The URL of the web page where you can download the latest ElastiCache client library.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The name of the compute and memory capacity node type for the cache cluster.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine (memcached or redis) to be used for this cache cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the cache engine version that is used in this cache cluster.

" - }, - "CacheClusterStatus":{ - "shape":"String", - "documentation":"

The current state of this cache cluster, one of the following values: available, creating, deleted, deleting, incompatible-network, modifying, rebooting cache cluster nodes, restore-failed, or snapshotting.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes in the cache cluster.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the cache cluster is located or \"Multiple\" if the cache nodes are located in different Availability Zones.

" - }, - "CacheClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cache cluster was created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The time range (in UTC) during which weekly system maintenance can occur.

" - }, - "PendingModifiedValues":{"shape":"PendingModifiedValues"}, - "NotificationConfiguration":{"shape":"NotificationConfiguration"}, - "CacheSecurityGroups":{ - "shape":"CacheSecurityGroupMembershipList", - "documentation":"

A list of cache security group elements, composed of name and status sub-elements.

" - }, - "CacheParameterGroup":{"shape":"CacheParameterGroupStatus"}, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group associated with the cache cluster.

" - }, - "CacheNodes":{ - "shape":"CacheNodeList", - "documentation":"

A list of cache nodes that are members of the cache cluster.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

If true, then minor version patches are applied automatically; if false, then automatic minor version patches are disabled.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupMembershipList", - "documentation":"

A list of VPC Security Groups associated with the cache cluster.

" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The replication group to which this cache cluster belongs. If this field is empty, the cache cluster is not associated with any replication group.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache will retain automatic cache cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, then a snapshot that was taken today will be retained for 5 days before being deleted.

Important
If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your cache cluster.

Example: 05:00-09:00

" - } - }, - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific cache cluster.

" - }, - "CacheClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheClusterAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a cache cluster with the given identifier.

" - }, - "CacheClusterList":{ - "type":"list", - "member":{ - "shape":"CacheCluster", - "locationName":"CacheCluster" - } - }, - "CacheClusterMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheClusters":{ - "shape":"CacheClusterList", - "documentation":"

A list of cache clusters. Each item in the list contains detailed information about one cache cluster.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheClusters operation.

" - }, - "CacheClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster ID does not refer to an existing cache cluster.

" - }, - "CacheEngineVersion":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cache engine.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family associated with this cache engine.

" - }, - "CacheEngineDescription":{ - "shape":"String", - "documentation":"

The description of the cache engine.

" - }, - "CacheEngineVersionDescription":{ - "shape":"String", - "documentation":"

The description of the cache engine version.

" - } - }, - "documentation":"

Provides all of the details about a particular cache engine version.

" - }, - "CacheEngineVersionList":{ - "type":"list", - "member":{ - "shape":"CacheEngineVersion", - "locationName":"CacheEngineVersion" - } - }, - "CacheEngineVersionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheEngineVersions":{ - "shape":"CacheEngineVersionList", - "documentation":"

A list of cache engine version details. Each element in the list contains detailed information about one cache engine version.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheEngineVersions operation.

" - }, - "CacheNode":{ - "type":"structure", - "members":{ - "CacheNodeId":{ - "shape":"String", - "documentation":"

The cache node identifier. A node ID is a numeric identifier (0001, 0002, etc.). The combination of cluster ID and node ID uniquely identifies every cache node used in a customer's AWS account.

" - }, - "CacheNodeStatus":{ - "shape":"String", - "documentation":"

The current state of this cache node.

" - }, - "CacheNodeCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cache node was created.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The hostname and IP address for connecting to this cache node.

" - }, - "ParameterGroupStatus":{ - "shape":"String", - "documentation":"

The status of the parameter group applied to this cache node.

" - }, - "SourceCacheNodeId":{ - "shape":"String", - "documentation":"

The ID of the primary node to which this read replica node is synchronized. If this field is empty, then this node is not associated with a primary cache cluster.

" - }, - "CustomerAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where this node was created and now resides.

" - } - }, - "documentation":"

Represents an individual cache node within a cache cluster. Each cache node runs its own instance of the cluster's protocol-compliant caching software - either Memcached or Redis.

" - }, - "CacheNodeIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CacheNodeId" - } - }, - "CacheNodeList":{ - "type":"list", - "member":{ - "shape":"CacheNode", - "locationName":"CacheNode" - } - }, - "CacheNodeTypeSpecificParameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the parameter value.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest cache engine version to which the parameter can apply.

" - }, - "CacheNodeTypeSpecificValues":{ - "shape":"CacheNodeTypeSpecificValueList", - "documentation":"

A list of cache node types and their corresponding values for this parameter.

" - } - }, - "documentation":"

A parameter that has a different value for each cache node type it is applied to. For example, in a Redis cache cluster, a cache.m1.large cache node type would have a larger maxmemory value than a cache.m1.small type.

" - }, - "CacheNodeTypeSpecificParametersList":{ - "type":"list", - "member":{ - "shape":"CacheNodeTypeSpecificParameter", - "locationName":"CacheNodeTypeSpecificParameter" - } - }, - "CacheNodeTypeSpecificValue":{ - "type":"structure", - "members":{ - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for which this value applies.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value for the cache node type.

" - } - }, - "documentation":"

A value that applies only to a certain cache node type.

" - }, - "CacheNodeTypeSpecificValueList":{ - "type":"list", - "member":{ - "shape":"CacheNodeTypeSpecificValue", - "locationName":"CacheNodeTypeSpecificValue" - } - }, - "CacheParameterGroup":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family that this cache parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for this cache parameter group.

" - } - }, - "wrapper":true, - "documentation":"

Represents the output of a CreateCacheParameterGroup operation.

" - }, - "CacheParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A cache parameter group with the requested name already exists.

" - }, - "CacheParameterGroupDetails":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter instances.

" - }, - "CacheNodeTypeSpecificParameters":{ - "shape":"CacheNodeTypeSpecificParametersList", - "documentation":"

A list of parameters specific to a particular cache node type. Each element in the list contains detailed information about one parameter.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheParameters operation.

" - }, - "CacheParameterGroupList":{ - "type":"list", - "member":{ - "shape":"CacheParameterGroup", - "locationName":"CacheParameterGroup" - } - }, - "CacheParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - } - }, - "documentation":"

Represents the output of one of the following operations:

  • ModifyCacheParameterGroup
  • ResetCacheParameterGroup
" - }, - "CacheParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

" - }, - "CacheParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of cache security groups.

" - }, - "CacheParameterGroupStatus":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - }, - "CacheNodeIdsToReboot":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of the cache node IDs which need to be rebooted for parameter changes to be applied. A node ID is a numeric identifier (0001, 0002, etc.).

" - } - }, - "documentation":"

The status of the cache parameter group.

" - }, - "CacheParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheParameterGroups":{ - "shape":"CacheParameterGroupList", - "documentation":"

A list of cache parameter groups. Each element in the list contains detailed information about one cache parameter group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheParameterGroups operation.

" - }, - "CacheSecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the cache security group owner.

" - }, - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the cache security group.

" - }, - "EC2SecurityGroups":{ - "shape":"EC2SecurityGroupList", - "documentation":"

A list of Amazon EC2 security groups that are associated with this cache security group.

" - } - }, - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress
  • CreateCacheSecurityGroup
  • RevokeCacheSecurityGroupIngress
" - }, - "CacheSecurityGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A cache security group with the specified name already exists.

" - }, - "CacheSecurityGroupMembership":{ - "type":"structure", - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The membership status in the cache security group. The status changes when a cache security group is modified, or when the cache security groups assigned to a cache cluster are modified.

" - } - }, - "documentation":"

Represents a cache cluster's status within a particular cache security group.

" - }, - "CacheSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"CacheSecurityGroupMembership", - "locationName":"CacheSecurityGroup" - } - }, - "CacheSecurityGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheSecurityGroups":{ - "shape":"CacheSecurityGroups", - "documentation":"

A list of cache security groups. Each element in the list contains detailed information about one group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheSecurityGroups operation.

" - }, - "CacheSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CacheSecurityGroupName" - } - }, - "CacheSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

" - }, - "CacheSecurityGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"QuotaExceeded.CacheSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache security groups.

" - }, - "CacheSecurityGroups":{ - "type":"list", - "member":{ - "shape":"CacheSecurityGroup", - "locationName":"CacheSecurityGroup" - } - }, - "CacheSubnetGroup":{ - "type":"structure", - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group.

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description of the cache subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

A list of subnets associated with the cache subnet group.

" - } - }, - "wrapper":true, - "documentation":"

Represents the output of one of the following operations:

  • CreateCacheSubnetGroup
  • ModifyCacheSubnetGroup
" - }, - "CacheSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name is already in use by an existing cache subnet group.

" - }, - "CacheSubnetGroupInUse":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSubnetGroupInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group is currently in use.

" - }, - "CacheSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheSubnetGroups":{ - "shape":"CacheSubnetGroups", - "documentation":"

A list of cache subnet groups. Each element in the list contains detailed information about one group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheSubnetGroups operation.

" - }, - "CacheSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

" - }, - "CacheSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache subnet groups.

" - }, - "CacheSubnetGroups":{ - "type":"list", - "member":{ - "shape":"CacheSubnetGroup", - "locationName":"CacheSubnetGroup" - } - }, - "CacheSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"CacheSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a cache subnet group.

" - }, - "ClusterIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ClusterId" - } - }, - "ClusterQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ClusterQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache clusters per customer.

" - }, - "CopySnapshotMessage":{ - "type":"structure", - "required":[ - "SourceSnapshotName", - "TargetSnapshotName" - ], - "members":{ - "SourceSnapshotName":{ - "shape":"String", - "documentation":"

The name of an existing snapshot from which to copy.

" - }, - "TargetSnapshotName":{ - "shape":"String", - "documentation":"

A name for the copied snapshot.

" - } - }, - "documentation":"

Represents the input of a CopySnapshotMessage operation.

" - }, - "CreateCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The node group identifier. This parameter is stored as a lowercase string.

Constraints:

  • A name must contain from 1 to 20 alphanumeric characters or hyphens.
  • The first character must be a letter.
  • A name cannot end with a hyphen or contain two consecutive hyphens.
" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.

If the specified replication group is Automatic Failover enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.

Note: This parameter is only valid if the Engine parameter is redis.

" - }, - "AZMode":{ - "shape":"AZMode", - "documentation":"

Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.

This parameter is only supported for Memcached cache clusters.

If the AZMode and PreferredAvailabilityZones are not specified, ElastiCache assumes single-az mode.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone in which the cache cluster will be created.

All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use PreferredAvailabilityZones.

Default: System chosen Availability Zone.

" - }, - "PreferredAvailabilityZones":{ - "shape":"PreferredAvailabilityZoneList", - "documentation":"

A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.

This option is only supported on Memcached.

If you want all the nodes in the same Availability Zone, use PreferredAvailabilityZone instead, or repeat the Availability Zone multiple times in the list.

Default: System chosen Availability Zones.

Example: One Memcached node in each of three different Availability Zones: PreferredAvailabilityZones.member.1=us-east-1a&PreferredAvailabilityZones.member.2=us-east-1b&PreferredAvailabilityZones.member.3=us-east-1d

Example: All three Memcached nodes in one Availability Zone: PreferredAvailabilityZones.member.1=us-east-1a&PreferredAvailabilityZones.member.2=us-east-1a&PreferredAvailabilityZones.member.3=us-east-1a

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The initial number of cache nodes that the cache cluster will have.

For Memcached, valid values are between 1 and 20. If you need to exceed this limit, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/.

For Redis, only single-node cache cluster are supported at this time, so the value for this parameter must be 1.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the nodes in the node group.

Valid node types are as follows:

  • General purpose:
    • Current generation: cache.t2.micro, cache.t2.small, cache.t2.medium, cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge
    • Previous generation: cache.t1.micro, cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge
  • Compute optimized: cache.c1.xlarge
  • Memory optimized
    • Current generation: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge
    • Previous generation: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
  • Redis backup/restore is not supported for t2 instances.
  • Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.

For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine to be used for this cache cluster.

Valid values for this parameter are:

memcached | redis

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions operation.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group to be used for the cache cluster.

Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of security group names to associate with this cache cluster.

Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

One or more VPC security groups associated with the cache cluster.

Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).

" - }, - "SnapshotArns":{ - "shape":"SnapshotArnsList", - "documentation":"

A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.

Note: This parameter is only valid if the Engine parameter is redis.

Example of an Amazon S3 ARN: arn:aws:s3:::my_bucket/snapshot1.rdb

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a snapshot from which to restore data into the new node group. The snapshot status changes to restoring while the new node group is being created.

Note: This parameter is only valid if the Engine parameter is redis.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur.

Example: sun:05:00-sun:09:00

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which each of the cache nodes will accept connections.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Determines whether minor engine upgrades will be applied automatically to the node group during the maintenance window. A value of true allows these upgrades to occur; false disables automatic upgrades.

Default: true

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, then a snapshot that was taken today will be retained for 5 days before being deleted.

Note: This parameter is only valid if the Engine parameter is redis.

Default: 0 (i.e., automatic backups are disabled for this cache cluster).

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.

Example: 05:00-09:00

If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.

Note: This parameter is only valid if the Engine parameter is redis.

" - } - }, - "documentation":"

Represents the input of a CreateCacheCluster operation.

" - }, - "CreateCacheParameterGroupMessage":{ - "type":"structure", - "required":[ - "CacheParameterGroupName", - "CacheParameterGroupFamily", - "Description" - ], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

A user-specified name for the cache parameter group.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family the cache parameter group can be used with.

Valid values are: memcached1.4 | redis2.6 | redis2.8

" - }, - "Description":{ - "shape":"String", - "documentation":"

A user-specified description for the cache parameter group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheParameterGroup operation.

" - }, - "CreateCacheSecurityGroupMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "Description" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

A name for the cache security group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters. Cannot be the word \"Default\".

Example: mysecuritygroup

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the cache security group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheSecurityGroup operation.

" - }, - "CreateCacheSubnetGroupMessage":{ - "type":"structure", - "required":[ - "CacheSubnetGroupName", - "CacheSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

A name for the cache subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

Example: mysubnetgroup

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

A description for the cache subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

A list of VPC subnet IDs for the cache subnet group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheSubnetGroup operation.

" - }, - "CreateReplicationGroupMessage":{ - "type":"structure", - "required":[ - "ReplicationGroupId", - "ReplicationGroupDescription" - ], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The replication group identifier. This parameter is stored as a lowercase string.

Constraints:

  • A name must contain from 1 to 20 alphanumeric characters or hyphens.
  • The first character must be a letter.
  • A name cannot end with a hyphen or contain two consecutive hyphens.
" - }, - "ReplicationGroupDescription":{ - "shape":"String", - "documentation":"

A user-created description for the replication group.

" - }, - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

The identifier of the cache cluster that will serve as the primary for this replication group. This cache cluster must already exist and have a status of available.

This parameter is not required if NumCacheClusters is specified.

" - }, - "AutomaticFailoverEnabled":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether a read-only replica will be automatically promoted to read/write primary if the existing primary fails.

If true, automatic failover is enabled for this replication group. If false, automatic failover is disabled for this replication group.

Default: false

" - }, - "NumCacheClusters":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache clusters this replication group will initially have.

If AutomaticFailover is enabled, the value of this parameter must be at least 2.

The maximum permitted value for NumCacheClusters is 6 (primary plus 5 replicas). If you need to exceed this limit, please fill out the ElastiCache Limit Increase Request forrm at http://aws.amazon.com/contact-us/elasticache-node-limit-request.

" - }, - "PreferredCacheClusterAZs":{ - "shape":"AvailabilityZonesList", - "documentation":"

A list of EC2 availability zones in which the replication group's cache clusters will be created. The order of the availability zones in the list is not important.

Default: system chosen availability zones.

Example: One Redis cache cluster in each of three availability zones. PreferredAvailabilityZones.member.1=us-east-1a PreferredAvailabilityZones.member.2=us-east-1c PreferredAvailabilityZones.member.3=us-east-1d

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the nodes in the node group.

Valid node types are as follows:

  • General purpose:
    • Current generation: cache.t2.micro, cache.t2.small, cache.t2.medium, cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge
    • Previous generation: cache.t1.micro, cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge
  • Compute optimized: cache.c1.xlarge
  • Memory optimized
    • Current generation: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge
    • Previous generation: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
  • Redis backup/restore is not supported for t2 instances.
  • Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.

For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine to be used for the cache clusters in this replication group.

Default: redis

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cach engine to be used for the cache clusters in this replication group. To view the supported cache engine versions, use the DescribeCacheEngineVersions operation.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to associate with this replication group. If this argument is omitted, the default cache parameter group for the specified engine is used.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to be used for the replication group.

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to associate with this replication group.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

One or more Amazon VPC security groups associated with this replication group.

Use this parameter only when you are creating a replication group in an Amazon Virtual Private Cloud (VPC).

" - }, - "SnapshotArns":{ - "shape":"SnapshotArnsList", - "documentation":"

A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.

Note: This parameter is only valid if the Engine parameter is redis.

Example of an Amazon S3 ARN: arn:aws:s3:::my_bucket/snapshot1.rdb

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a snapshot from which to restore data into the new node group. The snapshot status changes to restoring while the new node group is being created.

Note: This parameter is only valid if the Engine parameter is redis.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur.

Example: sun:05:00-sun:09:00

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which each member of the replication group will accept connections.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Determines whether minor engine upgrades will be applied automatically to the node group during the maintenance window. A value of true allows these upgrades to occur; false disables automatic upgrades.

Default: true

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, then a snapshot that was taken today will be retained for 5 days before being deleted.

Note: This parameter is only valid if the Engine parameter is redis.

Default: 0 (i.e., automatic backups are disabled for this cache cluster).

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.

Example: 05:00-09:00

If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.

Note: This parameter is only valid if the Engine parameter is redis.

" - } - }, - "documentation":"

Represents the input of a CreateReplicationGroup operation.

" - }, - "CreateSnapshotMessage":{ - "type":"structure", - "required":[ - "CacheClusterId", - "SnapshotName" - ], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The identifier of an existing cache cluster. The snapshot will be created from this cache cluster.

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

A name for the snapshot being created.

" - } - }, - "documentation":"

Represents the input of a CreateSnapshot operation.

" - }, - "DeleteCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cache cluster identifier for the cluster to be deleted. This parameter is not case sensitive.

" - }, - "FinalSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied name of a final cache cluster snapshot. This is the unique name that identifies the snapshot. ElastiCache creates the snapshot, and then deletes the cache cluster immediately afterward.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheCluster operation.

" - }, - "DeleteCacheParameterGroupMessage":{ - "type":"structure", - "required":["CacheParameterGroupName"], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to delete.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheParameterGroup operation.

" - }, - "DeleteCacheSecurityGroupMessage":{ - "type":"structure", - "required":["CacheSecurityGroupName"], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to delete.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheSecurityGroup operation.

" - }, - "DeleteCacheSubnetGroupMessage":{ - "type":"structure", - "required":["CacheSubnetGroupName"], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to delete.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheSubnetGroup operation.

" - }, - "DeleteReplicationGroupMessage":{ - "type":"structure", - "required":["ReplicationGroupId"], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the cluster to be deleted. This parameter is not case sensitive.

" - }, - "RetainPrimaryCluster":{ - "shape":"BooleanOptional", - "documentation":"

If set to true, all of the read replicas will be deleted, but the primary node will be retained.

" - }, - "FinalSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The name of a final node group snapshot. ElastiCache creates the snapshot from the primary node in the cluster, rather than one of the replicas; this is to ensure that it captures the freshest data. After the final snapshot is taken, the cluster is immediately deleted.

" - } - }, - "documentation":"

Represents the input of a DeleteReplicationGroup operation.

" - }, - "DeleteSnapshotMessage":{ - "type":"structure", - "required":["SnapshotName"], - "members":{ - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of the snapshot to be deleted.

" - } - }, - "documentation":"

Represents the input of a DeleteSnapshot operation.

" - }, - "DescribeCacheClustersMessage":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied cluster identifier. If this parameter is specified, only information about that specific cache cluster is returned. This parameter isn't case sensitive.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ShowCacheNodeInfo":{ - "shape":"BooleanOptional", - "documentation":"

An optional flag that can be included in the DescribeCacheCluster request to retrieve information about the individual cache nodes.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheClusters operation.

" - }, - "DescribeCacheEngineVersionsMessage":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The cache engine to return. Valid values: memcached | redis

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The cache engine version to return.

Example: 1.4.14

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group family to return details for.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DefaultOnly":{ - "shape":"Boolean", - "documentation":"

If true, specifies that only the default version of the specified engine or engine and major version combination is to be returned.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheEngineVersions operation.

" - }, - "DescribeCacheParameterGroupsMessage":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheParameterGroups operation.

" - }, - "DescribeCacheParametersMessage":{ - "type":"structure", - "required":["CacheParameterGroupName"], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group to return details for.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return.

Valid values: user | system | engine-default

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheParameters operation.

" - }, - "DescribeCacheSecurityGroupsMessage":{ - "type":"structure", - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheSecurityGroups operation.

" - }, - "DescribeCacheSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheSubnetGroups operation.

" - }, - "DescribeEngineDefaultParametersMessage":{ - "type":"structure", - "required":["CacheParameterGroupFamily"], - "members":{ - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family. Valid values are: memcached1.4 | redis2.6 | redis2.8

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeEngineDefaultParameters operation.

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

Valid values are: cache-cluster | cache-parameter-group | cache-security-group | cache-subnet-group

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format.

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format.

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes' worth of events to retrieve.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeEvents operation.

" - }, - "DescribeReplicationGroupsMessage":{ - "type":"structure", - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the replication group to be described. This parameter is not case sensitive.

If you do not specify this parameter, information about all replication groups is returned.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReplicationGroups operation.

" - }, - "DescribeReservedCacheNodesMessage":{ - "type":"structure", - "members":{ - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

The reserved cache node identifier filter value. Use this parameter to show only the reservation that matches the specified reservation ID.

" - }, - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Use this parameter to show only purchased reservations matching the specified offering identifier.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type filter value. Use this parameter to show only those reservations matching the specified cache node type.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

The duration filter value, specified in years or seconds. Use this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Use this parameter to show only those reservations matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type.

Valid values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReservedCacheNodes operation.

" - }, - "DescribeReservedCacheNodesOfferingsMessage":{ - "type":"structure", - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type filter value. Use this parameter to show only the available offerings matching the specified cache node type.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

Duration filter value, specified in years or seconds. Use this parameter to show only reservations for a given duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Use this parameter to show only the available offerings matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReservedCacheNodesOfferings operation.

" - }, - "DescribeSnapshotsListMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

A list of snapshots. Each item in the list contains detailed information about one snapshot.

" - } - }, - "documentation":"

Represents the output of a DescribeSnapshots operation.

" - }, - "DescribeSnapshotsMessage":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

A user-supplied cluster identifier. If this parameter is specified, only snapshots associated with that specific cache cluster will be described.

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

A user-supplied name of the snapshot. If this parameter is specified, only this snapshot will be described.

" - }, - "SnapshotSource":{ - "shape":"String", - "documentation":"

If set to system, the output shows snapshots that were automatically created by ElastiCache. If set to user the output shows snapshots that were manually created. If omitted, the output shows both automatically and manually created snapshots.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 50

Constraints: minimum 20; maximum 50.

" - } - }, - "documentation":"

Represents the input of a DescribeSnapshotsMessage operation.

" - }, - "Double":{"type":"double"}, - "EC2SecurityGroup":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the Amazon EC2 security group.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the Amazon EC2 security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the Amazon EC2 security group owner.

" - } - }, - "documentation":"

Provides ownership and status information for an Amazon EC2 security group.

" - }, - "EC2SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"EC2SecurityGroup", - "locationName":"EC2SecurityGroup" - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

The DNS hostname of the cache node.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port number that the cache engine is listening on.

" - } - }, - "documentation":"

Represents the information required for client programs to connect to a cache node.

" - }, - "EngineDefaults":{ - "type":"structure", - "members":{ - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

Specifies the name of the cache parameter group family to which the engine default parameters apply.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Contains a list of engine default parameters.

" - }, - "CacheNodeTypeSpecificParameters":{ - "shape":"CacheNodeTypeSpecificParametersList", - "documentation":"

A list of parameters specific to a particular cache node type. Each element in the list contains detailed information about one parameter.

" - } - }, - "wrapper":true, - "documentation":"

Represents the output of a DescribeEngineDefaultParameters operation.

" - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source of the event. For example, if the event occurred at the cache cluster level, the identifier would be the name of the cache cluster.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the origin of this event - a cache cluster, a parameter group, a security group, etc.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The text of the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

The date and time when the event occurred.

" - } - }, - "documentation":"

Represents a single occurrence of something interesting within the system. Some examples of events are creating a cache cluster, adding or removing a cache node, or rebooting a node.

" - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of events. Each element in the list contains detailed information about one event.

" - } - }, - "documentation":"

Represents the output of a DescribeEvents operation.

" - }, - "InsufficientCacheClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

" - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidCacheClusterStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache cluster is not in the available state.

" - }, - "InvalidCacheParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache parameter group does not allow the requested action to occur.

" - }, - "InvalidCacheSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the cache security group does not allow deletion.

" - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

Two or more parameters that must not be used together were used together.

" - } - }, - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Two or more incompatible parameters were specified.

" - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

A parameter value is invalid.

" - } - }, - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - "InvalidReplicationGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidReplicationGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested replication group is not in the available state.

" - }, - "InvalidSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The current state of the snapshot does not allow the requested action to occur.

" - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

An invalid subnet identifier was specified.

" - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The VPC network is in an invalid state.

" - }, - "ModifyCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cache cluster identifier. This value is stored as a lowercase string.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes that the cache cluster should have. If the value for NumCacheNodes is greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which may be zero), then more nodes will be added. If the value is less than the number of existing cache nodes, then nodes will be removed. If the value is equal to the number of current cache nodes, then any pending add or remove requests are canceled.

If you are removing cache nodes, you must use the CacheNodeIdsToRemove parameter to provide the IDs of the specific cache nodes to remove.

For cache clusters running Redis, the value of NumCacheNodesmust be 1.

Note:
Adding or removing Memcached cache nodes can be applied immediately or as a pending action. See ApplyImmediately.
A pending action to modify the number of cache nodes in a cluster during its maintenance window, whether by adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest request to add or remove nodes to the cluster overrides any previous pending actions to modify the number of cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending action to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending action to remove 3 nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with flexible cache node placement, a request to add nodes does not automatically override a previous pending action to add nodes. The customer can modify the previous pending action to add more nodes or explicitly cancel the pending request and retry the new request. To cancel pending actions to modify the number of cache nodes in a cluster, use the ModifyCacheCluster request and set NumCacheNodes equal to the number of cache nodes currently in the cache cluster.

" - }, - "CacheNodeIdsToRemove":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is only valid when NumCacheNodes is less than the existing number of cache nodes. The number of cache node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of NumCacheNodes in the request.

For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this ModifyCacheCluser call is 5, you must list 2 (7 - 5) cache node IDs to remove.

" - }, - "AZMode":{ - "shape":"AZMode", - "documentation":"

Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or created across multiple Availability Zones.

Valid values: single-az | cross-az.

This option is only supported for Memcached cache clusters.

" - }, - "NewAvailabilityZones":{ - "shape":"PreferredAvailabilityZoneList", - "documentation":"

The list of Availability Zones where the new Memcached cache nodes will be created.

This parameter is only valid when NumCacheNodes in the request is greater than the sum of the number of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of Availability Zones supplied in this list must match the cache nodes being added in this request.

This option is only supported on Memcached clusters.

Scenarios:

  • Scenario 1: You have 3 active nodes and wish to add 2 nodes.
    Specify NumCacheNodes=5 (3 + 2) and optionally specify two Availability Zones for the two new nodes.
  • Scenario 2: You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to add 1 more node.
    Specify NumCacheNodes=6 ((3 + 2) + 1)
  • and optionally specify an Availability Zone for the new node.
  • Scenario 3: You want to cancel all pending actions.
    Specify NumCacheNodes=3 to cancel all pending actions.

The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes pending creation, add 0 nodes by setting NumCacheNodes to the number of current nodes.

If cross-az is specified, existing Memcached nodes remain in their current Availability Zone. Only newly created nodes can be located in different Availability Zones. For guidance on how to move existing Memcached nodes to different Availability Zones, see the Availability Zone Considerations section of Cache Node Considerations for Memcached.

Impact of new add/remove requests upon pending requests

Scenarios Pending Operation New Request Results
Scenario-1 Delete Delete The new delete, pending or immediate, replaces the pending delete.
Scenario-2 Delete Create The new create, pending or immediate, replaces the pending delete.
Scenario-3 Create Delete The new delete, pending or immediate, replaces the pending create.
Scenario-4 Create Create The new create is added to the pending create.
Important:
If the new create request is Apply Immediately - Yes, all creates are performed immediately. If the new create request is Apply Immediately - No, all creates are pending.

Example: NewAvailabilityZones.member.1=us-east-1a&NewAvailabilityZones.member.2=us-east-1b&NewAvailabilityZones.member.3=us-east-1d

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as soon as possible.

This parameter can be used only with clusters that are created outside of an Amazon Virtual Private Cloud (VPC).

Constraints: Must contain no more than 255 alphanumeric characters. Must not be \"Default\".

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

Specifies the VPC Security Groups associated with the cache cluster.

This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (VPC).

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur. Note that system maintenance may result in an outage. This change is made immediately. If you are moving this window to the current time, there must be at least 120 minutes between the current time and end of the window to ensure that pending changes are applied.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to apply to this cache cluster. This change is asynchronously applied as soon as possible for parameters when the ApplyImmediately parameter is specified as true for this request.

" - }, - "NotificationTopicStatus":{ - "shape":"String", - "documentation":"

The status of the Amazon SNS notification topic. Notifications are sent only if the status is active.

Valid values: active | inactive

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

If true, this parameter causes the modifications in this request and any pending modifications to be applied, asynchronously and as soon as possible, regardless of the PreferredMaintenanceWindow setting for the cache cluster.

If false, then changes to the cache cluster are applied on the next maintenance reboot, or the next failure reboot, whichever occurs first.

If you perform a ModifyCacheCluster before a pending modification is applied, the pending modification is replaced by the newer modification.

Valid values: true | false

Default: false

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The upgraded version of the cache engine to be run on the cache nodes.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

If true, then minor engine upgrades will be applied automatically to the cache cluster during the maintenance window.

Valid values: true | false

Default: true

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache will retain automatic cache cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, then a snapshot that was taken today will be retained for 5 days before being deleted.

Important
If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your cache cluster.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheCluster operation.

" - }, - "ModifyCacheParameterGroupMessage":{ - "type":"structure", - "required":[ - "CacheParameterGroupName", - "ParameterNameValues" - ], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to modify.

" - }, - "ParameterNameValues":{ - "shape":"ParameterNameValueList", - "documentation":"

An array of parameter names and values for the parameter update. You must supply at least one parameter name and value; subsequent arguments are optional. A maximum of 20 parameters may be modified per request.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheParameterGroup operation.

" - }, - "ModifyCacheSubnetGroupMessage":{ - "type":"structure", - "required":["CacheSubnetGroupName"], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the cache subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

Example: mysubnetgroup

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

A description for the cache subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the cache subnet group.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheSubnetGroup operation.

" - }, - "ModifyReplicationGroupMessage":{ - "type":"structure", - "required":["ReplicationGroupId"], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier of the replication group to modify.

" - }, - "ReplicationGroupDescription":{ - "shape":"String", - "documentation":"

A description for the replication group. Maximum length is 255 characters.

" - }, - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

If this parameter is specified, ElastiCache will promote each of the cache clusters in the specified replication group to the primary role. The nodes of all other cache clusters in the replication group will be read replicas.

" - }, - "SnapshottingClusterId":{ - "shape":"String", - "documentation":"

The cache cluster ID that will be used as the daily snapshot source for the replication group.

" - }, - "AutomaticFailoverEnabled":{ - "shape":"BooleanOptional", - "documentation":"

Whether a read replica will be automatically promoted to read/write primary if the existing primary encounters a failure.

Valid values: true | false

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to authorize for the clusters in this replication group. This change is asynchronously applied as soon as possible.

This parameter can be used only with replication group containing cache clusters running outside of an Amazon Virtual Private Cloud (VPC).

Constraints: Must contain no more than 255 alphanumeric characters. Must not be \"Default\".

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

Specifies the VPC Security Groups associated with the cache clusters in the replication group.

This parameter can be used only with replication group containing cache clusters running in an Amazon Virtual Private Cloud (VPC).

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which replication group system maintenance can occur. Note that system maintenance may result in an outage. This change is made immediately. If you are moving this window to the current time, there must be at least 120 minutes between the current time and end of the window to ensure that pending changes are applied.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to apply to all of the clusters in this replication group. This change is asynchronously applied as soon as possible for parameters when the ApplyImmediately parameter is specified as true for this request.

" - }, - "NotificationTopicStatus":{ - "shape":"String", - "documentation":"

The status of the Amazon SNS notification topic for the replication group. Notifications are sent only if the status is active.

Valid values: active | inactive

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

If true, this parameter causes the modifications in this request and any pending modifications to be applied, asynchronously and as soon as possible, regardless of the PreferredMaintenanceWindow setting for the replication group.

If false, then changes to the nodes in the replication group are applied on the next maintenance reboot, or the next failure reboot, whichever occurs first.

Valid values: true | false

Default: false

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The upgraded version of the cache engine to be run on the cache clusters in the replication group.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Determines whether minor engine upgrades will be applied automatically to all of the clusters in the replication group during the maintenance window. A value of true allows these upgrades to occur; false disables automatic upgrades.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache will retain automatic node group snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, then a snapshot that was taken today will be retained for 5 days before being deleted.

Important
If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of the node group specified by SnapshottingClusterId.

Example: 05:00-09:00

If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.

" - } - }, - "documentation":"

Represents the input of a ModifyReplicationGroups operation.

" - }, - "NodeGroup":{ - "type":"structure", - "members":{ - "NodeGroupId":{ - "shape":"String", - "documentation":"

The identifier for the node group. A replication group contains only one node group; therefore, the node group ID is 0001.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The current state of this replication group - creating, available, etc.

" - }, - "PrimaryEndpoint":{"shape":"Endpoint"}, - "NodeGroupMembers":{ - "shape":"NodeGroupMemberList", - "documentation":"

A list containing information about individual nodes within the node group.

" - } - }, - "documentation":"

Represents a collection of cache nodes in a replication group.

" - }, - "NodeGroupList":{ - "type":"list", - "member":{ - "shape":"NodeGroup", - "locationName":"NodeGroup" - } - }, - "NodeGroupMember":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The ID of the cache cluster to which the node belongs.

" - }, - "CacheNodeId":{ - "shape":"String", - "documentation":"

The ID of the node within its cache cluster. A node ID is a numeric identifier (0001, 0002, etc.).

" - }, - "ReadEndpoint":{"shape":"Endpoint"}, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the node is located.

" - }, - "CurrentRole":{ - "shape":"String", - "documentation":"

The role that is currently assigned to the node - primary or replica.

" - } - }, - "documentation":"

Represents a single node within a node group.

" - }, - "NodeGroupMemberList":{ - "type":"list", - "member":{ - "shape":"NodeGroupMember", - "locationName":"NodeGroupMember" - } - }, - "NodeQuotaForClusterExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cache cluster.

" - }, - "NodeQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

" - }, - "NodeSnapshot":{ - "type":"structure", - "members":{ - "CacheNodeId":{ - "shape":"String", - "documentation":"

The cache node identifier for the node in the source cache cluster.

" - }, - "CacheSize":{ - "shape":"String", - "documentation":"

The size of the cache on the source cache node.

" - }, - "CacheNodeCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cache node was created in the source cache cluster.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the source node's metadata and cache data set was obtained for the snapshot.

" - } - }, - "wrapper":true, - "documentation":"

Represents an individual cache node in a snapshot of a cache cluster.

" - }, - "NodeSnapshotList":{ - "type":"list", - "member":{ - "shape":"NodeSnapshot", - "locationName":"NodeSnapshot" - } - }, - "NotificationConfiguration":{ - "type":"structure", - "members":{ - "TopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that identifies the topic.

" - }, - "TopicStatus":{ - "shape":"String", - "documentation":"

The current state of the topic.

" - } - }, - "documentation":"

Describes a notification topic and its status. Notification topics are used for publishing ElastiCache events to subscribers using Amazon Simple Notification Service (SNS).

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the parameter.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest cache engine version to which the parameter can apply.

" - } - }, - "documentation":"

Describes an individual setting that controls some aspect of ElastiCache behavior.

" - }, - "ParameterNameValue":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - } - }, - "documentation":"

Describes a name-value pair that is used to update the value of a parameter.

" - }, - "ParameterNameValueList":{ - "type":"list", - "member":{ - "shape":"ParameterNameValue", - "locationName":"ParameterNameValue" - } - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingAutomaticFailoverStatus":{ - "type":"string", - "enum":[ - "enabled", - "disabled" - ] - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The new number of cache nodes for the cache cluster.

" - }, - "CacheNodeIdsToRemove":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs that are being removed (or will be removed) from the cache cluster. A node ID is a numeric identifier (0001, 0002, etc.).

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The new cache engine version that the cache cluster will run.

" - } - }, - "documentation":"

A group of settings that will be applied to the cache cluster in the future, or that are currently being applied.

" - }, - "PreferredAvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PreferredAvailabilityZone" - } - }, - "PurchaseReservedCacheNodesOfferingMessage":{ - "type":"structure", - "required":["ReservedCacheNodesOfferingId"], - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the reserved cache node offering to purchase.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

A customer-specified identifier to track this reservation.

Example: myreservationID

" - }, - "CacheNodeCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache node instances to reserve.

Default: 1

" - } - }, - "documentation":"

Represents the input of a PurchaseReservedCacheNodesOffering operation.

" - }, - "RebootCacheClusterMessage":{ - "type":"structure", - "required":[ - "CacheClusterId", - "CacheNodeIdsToReboot" - ], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cache cluster identifier. This parameter is stored as a lowercase string.

" - }, - "CacheNodeIdsToReboot":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs to reboot. A node ID is a numeric identifier (0001, 0002, etc.). To reboot an entire cache cluster, specify all of the cache node IDs.

" - } - }, - "documentation":"

Represents the input of a RebootCacheCluster operation.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The monetary amount of the recurring charge.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency of the recurring charge.

" - } - }, - "wrapper":true, - "documentation":"

Contains the specific price and frequency of a recurring charges for a reserved cache node, or for a reserved cache node offering.

" - }, - "RecurringChargeList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"RecurringCharge" - } - }, - "ReplicationGroup":{ - "type":"structure", - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the replication group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the replication group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The current state of this replication group - creating, available, etc.

" - }, - "PendingModifiedValues":{ - "shape":"ReplicationGroupPendingModifiedValues", - "documentation":"

A group of settings to be applied to the replication group, either immediately or during the next maintenance window.

" - }, - "MemberClusters":{ - "shape":"ClusterIdList", - "documentation":"

The names of all the cache clusters that are part of this replication group.

" - }, - "NodeGroups":{ - "shape":"NodeGroupList", - "documentation":"

A single element list with information about the nodes in the replication group.

" - }, - "SnapshottingClusterId":{ - "shape":"String", - "documentation":"

The cache cluster ID that is used as the daily snapshot source for the replication group.

" - }, - "AutomaticFailover":{ - "shape":"AutomaticFailoverStatus", - "documentation":"

Indicates the status of automatic failover for this replication group.

" - } - }, - "wrapper":true, - "documentation":"

Contains all of the attributes of a specific replication group.

" - }, - "ReplicationGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReplicationGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group already exists.

" - }, - "ReplicationGroupList":{ - "type":"list", - "member":{ - "shape":"ReplicationGroup", - "locationName":"ReplicationGroup" - } - }, - "ReplicationGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReplicationGroups":{ - "shape":"ReplicationGroupList", - "documentation":"

A list of replication groups. Each item in the list contains detailed information about one replication group.

" - } - }, - "documentation":"

Represents the output of a DescribeReplicationGroups operation.

" - }, - "ReplicationGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified replication group does not exist.

" - }, - "ReplicationGroupPendingModifiedValues":{ - "type":"structure", - "members":{ - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

The primary cluster ID which will be applied immediately (if --apply-immediately was specified), or during the next maintenance window.

" - }, - "AutomaticFailoverStatus":{ - "shape":"PendingAutomaticFailoverStatus", - "documentation":"

Indicates the status of automatic failover for this replication group.

" - } - }, - "documentation":"

The settings to be applied to the replication group, either immediately or during the next maintenance window.

" - }, - "ReservedCacheNode":{ - "type":"structure", - "members":{ - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for the reserved cache nodes.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The time the reservation started.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this reserved cache node.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this reserved cache node.

" - }, - "CacheNodeCount":{ - "shape":"Integer", - "documentation":"

The number of cache nodes that have been reserved.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The description of the reserved cache node.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type of this reserved cache node.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved cache node.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved cache node.

" - } - }, - "wrapper":true, - "documentation":"

Represents the output of a PurchaseReservedCacheNodesOffering operation.

" - }, - "ReservedCacheNodeAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedCacheNodeAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a reservation with the given identifier.

" - }, - "ReservedCacheNodeList":{ - "type":"list", - "member":{ - "shape":"ReservedCacheNode", - "locationName":"ReservedCacheNode" - } - }, - "ReservedCacheNodeMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedCacheNodes":{ - "shape":"ReservedCacheNodeList", - "documentation":"

A list of reserved cache nodes. Each element in the list contains detailed information about one node.

" - } - }, - "documentation":"

Represents the output of a DescribeReservedCacheNodes operation.

" - }, - "ReservedCacheNodeNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedCacheNodeNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested reserved cache node was not found.

" - }, - "ReservedCacheNodeQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedCacheNodeQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the user's cache node quota.

" - }, - "ReservedCacheNodesOffering":{ - "type":"structure", - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

A unique identifier for the reserved cache node offering.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for the reserved cache node.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering. in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this offering.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The cache engine used by the offering.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved cache node.

" - } - }, - "wrapper":true, - "documentation":"

Describes all of the attributes of a reserved cache node offering.

" - }, - "ReservedCacheNodesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedCacheNodesOffering", - "locationName":"ReservedCacheNodesOffering" - } - }, - "ReservedCacheNodesOfferingMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedCacheNodesOfferings":{ - "shape":"ReservedCacheNodesOfferingList", - "documentation":"

A list of reserved cache node offerings. Each element in the list contains detailed information about one offering.

" - } - }, - "documentation":"

Represents the output of a DescribeReservedCacheNodesOfferings operation.

" - }, - "ReservedCacheNodesOfferingNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedCacheNodesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested cache node offering does not exist.

" - }, - "ResetCacheParameterGroupMessage":{ - "type":"structure", - "required":[ - "CacheParameterGroupName", - "ParameterNameValues" - ], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to reset.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

If true, all parameters in the cache parameter group will be reset to default values. If false, no such action occurs.

Valid values: true | false

" - }, - "ParameterNameValues":{ - "shape":"ParameterNameValueList", - "documentation":"

An array of parameter names to be reset. If you are not resetting the entire cache parameter group, you must specify at least one parameter name.

" - } - }, - "documentation":"

Represents the input of a ResetCacheParameterGroup operation.

" - }, - "RevokeCacheSecurityGroupIngressMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "EC2SecurityGroupName", - "EC2SecurityGroupOwnerId" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to revoke ingress from.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the Amazon EC2 security group to revoke access from.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the Amazon EC2 security group owner. Note that this is not the same thing as an AWS access key ID - you must provide a valid AWS account number for this parameter.

" - } - }, - "documentation":"

Represents the input of a RevokeCacheSecurityGroupIngress operation.

" - }, - "SecurityGroupIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupMembership":{ - "type":"structure", - "members":{ - "SecurityGroupId":{ - "shape":"String", - "documentation":"

The identifier of the cache security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the cache security group membership. The status changes whenever a cache security group is modified, or when the cache security groups assigned to a cache cluster are modified.

" - } - }, - "documentation":"

Represents a single cache security group and its status..

" - }, - "SecurityGroupMembershipList":{ - "type":"list", - "member":{"shape":"SecurityGroupMembership"} - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a snapshot. For an automatic snapshot, the name is system-generated; for a manual snapshot, this is the user-provided name.

" - }, - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied identifier of the source cache cluster.

" - }, - "SnapshotStatus":{ - "shape":"String", - "documentation":"

The status of the snapshot. Valid values: creating | available | restoring | copying | deleting.

" - }, - "SnapshotSource":{ - "shape":"String", - "documentation":"

Indicates whether the snapshot is from an automatic backup (automated) or was created manually (manual).

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The name of the compute and memory capacity node type for the source cache cluster.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine (memcached or redis) used by the source cache cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the cache engine version that is used by the source cache cluster.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes in the source cache cluster.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the source cache cluster is located.

" - }, - "CacheClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the source cache cluster was created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The time range (in UTC) during which weekly system maintenance can occur on the source cache cluster.

" - }, - "TopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the topic used by the source cache cluster for publishing notifications.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number used by each cache nodes in the source cache cluster.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The cache parameter group that is associated with the source cache cluster.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group associated with the source cache cluster.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group for the source cache cluster.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

For the source cache cluster, indicates whether minor version patches are applied automatically (true) or not (false).

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

For an automatic snapshot, the number of days for which ElastiCache will retain the snapshot before deleting it.

For manual snapshots, this field reflects the SnapshotRetentionLimit for the source cache cluster when the snapshot was created. This field is otherwise ignored: Manual snapshots do not expire, and can only be deleted using the DeleteSnapshot action.

Important
If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range during which ElastiCache takes daily snapshots of the source cache cluster.

" - }, - "NodeSnapshots":{ - "shape":"NodeSnapshotList", - "documentation":"

A list of the cache nodes in the source cache cluster.

" - } - }, - "wrapper":true, - "documentation":"

Represents a copy of an entire cache cluster as of the time when the snapshot was taken.

" - }, - "SnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You already have a snapshot with the given name.

" - }, - "SnapshotArnsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotArn" - } - }, - "SnapshotFeatureNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SnapshotFeatureNotSupportedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You attempted one of the following actions:

  • Creating a snapshot of a Redis cache cluster running on a t1.micro cache node.

  • Creating a snapshot of a cache cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

" - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"Snapshot" - } - }, - "SnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested snapshot name does not refer to an existing snapshot.

" - }, - "SnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

" - }, - "SourceType":{ - "type":"string", - "enum":[ - "cache-cluster", - "cache-parameter-group", - "cache-security-group", - "cache-subnet-group" - ] - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier for the subnet

" - }, - "SubnetAvailabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone associated with the subnet

" - } - }, - "documentation":"

Represents the subnet associated with a cache cluster. This parameter refers to subnets defined in Amazon Virtual Private Cloud (Amazon VPC) and used with ElastiCache.

" - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetInUse":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubnetInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is being used by another cache subnet group.

" - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "TStamp":{"type":"timestamp"}, - "AuthorizeCacheSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "CreateCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "CreateCacheParameterGroupResult":{ - "type":"structure", - "members":{ - "CacheParameterGroup":{"shape":"CacheParameterGroup"} - } - }, - "CreateCacheSecurityGroupResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - }, - "CreateCacheSubnetGroupResult":{ - "type":"structure", - "members":{ - "CacheSubnetGroup":{"shape":"CacheSubnetGroup"} - } - }, - "CreateReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "CreateSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "DeleteCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "DeleteReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "DeleteSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "DescribeEngineDefaultParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "ModifyCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "ModifyCacheSubnetGroupResult":{ - "type":"structure", - "members":{ - "CacheSubnetGroup":{"shape":"CacheSubnetGroup"} - } - }, - "ModifyReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "PurchaseReservedCacheNodesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedCacheNode":{"shape":"ReservedCacheNode"} - } - }, - "RebootCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "RevokeCacheSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/waiters-2.json deleted file mode 100644 index ccb904aa..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2014-09-30/waiters-2.json +++ /dev/null @@ -1,139 +0,0 @@ -{ - "version": 2, - "waiters": { - "CacheClusterAvailable": { - "delay": 30, - "operation": "DescribeCacheClusters", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "incompatible-network", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "restore-failed", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - } - ] - }, - "CacheClusterDeleted": { - "delay": 30, - "operation": "DescribeCacheClusters", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "CacheClusterNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "CacheClusters[].CacheClusterStatus" - } - ] - }, - "ReplicationGroupAvailable": { - "delay": 30, - "operation": "DescribeReplicationGroups", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "incompatible-network", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "restore-failed", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - } - ] - }, - "ReplicationGroupDeleted": { - "delay": 30, - "operation": "DescribeReplicationGroups", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "ReplicationGroupNotFoundFault", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "ReplicationGroups[].Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/paginators-1.json deleted file mode 100644 index 8724740d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/paginators-1.json +++ /dev/null @@ -1,76 +0,0 @@ -{ - "pagination": { - "DescribeCacheClusters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheClusters" - }, - "DescribeCacheEngineVersions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheEngineVersions" - }, - "DescribeCacheParameterGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheParameterGroups" - }, - "DescribeCacheParameters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Parameters" - }, - "DescribeCacheSecurityGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheSecurityGroups" - }, - "DescribeCacheSubnetGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "CacheSubnetGroups" - }, - "DescribeEngineDefaultParameters": { - "input_token": "Marker", - "output_token": "EngineDefaults.Marker", - "limit_key": "MaxRecords", - "result_key": "EngineDefaults.Parameters" - }, - "DescribeEvents": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Events" - }, - "DescribeReservedCacheNodes": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedCacheNodes" - }, - "DescribeReservedCacheNodesOfferings": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedCacheNodesOfferings" - }, - "DescribeReplicationGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReplicationGroups" - }, - "DescribeSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Snapshots" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/service-2.json deleted file mode 100644 index 95f4b937..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/service-2.json +++ /dev/null @@ -1,4061 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-02-02", - "endpointPrefix":"elasticache", - "protocol":"query", - "serviceFullName":"Amazon ElastiCache", - "serviceId":"ElastiCache", - "signatureVersion":"v4", - "uid":"elasticache-2015-02-02", - "xmlNamespace":"http://elasticache.amazonaws.com/doc/2015-02-02/" - }, - "operations":{ - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceMessage"}, - "output":{ - "shape":"TagListMessage", - "resultWrapper":"AddTagsToResourceResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"SnapshotNotFoundFault"}, - {"shape":"TagQuotaPerResourceExceeded"}, - {"shape":"InvalidARNFault"} - ], - "documentation":"

Adds up to 50 cost allocation tags to the named resource. A cost allocation tag is a key-value pair where the key and value are case-sensitive. You can use cost allocation tags to categorize and track your AWS costs.

When you apply tags to your ElastiCache resources, AWS generates a cost allocation report as a comma-separated value (CSV) file with your usage and costs aggregated by your tags. You can apply tags that represent business categories (such as cost centers, application names, or owners) to organize your costs across multiple services. For more information, see Using Cost Allocation Tags in Amazon ElastiCache in the ElastiCache User Guide.

" - }, - "AuthorizeCacheSecurityGroupIngress":{ - "name":"AuthorizeCacheSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeCacheSecurityGroupIngressMessage"}, - "output":{ - "shape":"AuthorizeCacheSecurityGroupIngressResult", - "resultWrapper":"AuthorizeCacheSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"InvalidCacheSecurityGroupStateFault"}, - {"shape":"AuthorizationAlreadyExistsFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Allows network ingress to a cache security group. Applications using ElastiCache must be running on Amazon EC2, and Amazon EC2 security groups are used as the authorization mechanism.

You cannot authorize ingress from an Amazon EC2 security group in one region to an ElastiCache cluster in another region.

" - }, - "CopySnapshot":{ - "name":"CopySnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopySnapshotMessage"}, - "output":{ - "shape":"CopySnapshotResult", - "resultWrapper":"CopySnapshotResult" - }, - "errors":[ - {"shape":"SnapshotAlreadyExistsFault"}, - {"shape":"SnapshotNotFoundFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidSnapshotStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Makes a copy of an existing snapshot.

This operation is valid for Redis only.

Users or groups that have permissions to use the CopySnapshot operation can create their own Amazon S3 buckets and copy snapshots to it. To control access to your snapshots, use an IAM policy to control who has the ability to use the CopySnapshot operation. For more information about using IAM to control the use of ElastiCache operations, see Exporting Snapshots and Authentication & Access Control.

You could receive the following error messages.

Error Messages

  • Error Message: The S3 bucket %s is outside of the region.

    Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

  • Error Message: The S3 bucket %s does not exist.

    Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

  • Error Message: The S3 bucket %s is not owned by the authenticated user.

    Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

  • Error Message: The authenticated user does not have sufficient permissions to perform the desired activity.

    Solution: Contact your system administrator to get the needed permissions.

  • Error Message: The S3 bucket %s already contains an object with key %s.

    Solution: Give the TargetSnapshotName a new and unique value. If exporting a snapshot, you could alternatively create a new Amazon S3 bucket and use this same value for TargetSnapshotName.

  • Error Message: ElastiCache has not been granted READ permissions %s on the S3 Bucket.

    Solution: Add List and Read permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

  • Error Message: ElastiCache has not been granted WRITE permissions %s on the S3 Bucket.

    Solution: Add Upload/Delete permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

  • Error Message: ElastiCache has not been granted READ_ACP permissions %s on the S3 Bucket.

    Solution: Add View Permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

" - }, - "CreateCacheCluster":{ - "name":"CreateCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCacheClusterMessage"}, - "output":{ - "shape":"CreateCacheClusterResult", - "resultWrapper":"CreateCacheClusterResult" - }, - "errors":[ - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"CacheClusterAlreadyExistsFault"}, - {"shape":"InsufficientCacheClusterCapacityFault"}, - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"CacheSubnetGroupNotFoundFault"}, - {"shape":"ClusterQuotaForCustomerExceededFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"TagQuotaPerResourceExceeded"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a cluster. All nodes in the cluster run the same protocol-compliant cache engine software, either Memcached or Redis.

Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

" - }, - "CreateCacheParameterGroup":{ - "name":"CreateCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCacheParameterGroupMessage"}, - "output":{ - "shape":"CreateCacheParameterGroupResult", - "resultWrapper":"CreateCacheParameterGroupResult" - }, - "errors":[ - {"shape":"CacheParameterGroupQuotaExceededFault"}, - {"shape":"CacheParameterGroupAlreadyExistsFault"}, - {"shape":"InvalidCacheParameterGroupStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a new Amazon ElastiCache cache parameter group. An ElastiCache cache parameter group is a collection of parameters and their values that are applied to all of the nodes in any cluster or replication group using the CacheParameterGroup.

A newly created CacheParameterGroup is an exact duplicate of the default parameter group for the CacheParameterGroupFamily. To customize the newly created CacheParameterGroup you can change the values of specific parameters. For more information, see:

" - }, - "CreateCacheSecurityGroup":{ - "name":"CreateCacheSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCacheSecurityGroupMessage"}, - "output":{ - "shape":"CreateCacheSecurityGroupResult", - "resultWrapper":"CreateCacheSecurityGroupResult" - }, - "errors":[ - {"shape":"CacheSecurityGroupAlreadyExistsFault"}, - {"shape":"CacheSecurityGroupQuotaExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a new cache security group. Use a cache security group to control access to one or more clusters.

Cache security groups are only used when you are creating a cluster outside of an Amazon Virtual Private Cloud (Amazon VPC). If you are creating a cluster inside of a VPC, use a cache subnet group instead. For more information, see CreateCacheSubnetGroup.

" - }, - "CreateCacheSubnetGroup":{ - "name":"CreateCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCacheSubnetGroupMessage"}, - "output":{ - "shape":"CreateCacheSubnetGroupResult", - "resultWrapper":"CreateCacheSubnetGroupResult" - }, - "errors":[ - {"shape":"CacheSubnetGroupAlreadyExistsFault"}, - {"shape":"CacheSubnetGroupQuotaExceededFault"}, - {"shape":"CacheSubnetQuotaExceededFault"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Creates a new cache subnet group.

Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "CreateReplicationGroup":{ - "name":"CreateReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReplicationGroupMessage"}, - "output":{ - "shape":"CreateReplicationGroupResult", - "resultWrapper":"CreateReplicationGroupResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"ReplicationGroupAlreadyExistsFault"}, - {"shape":"InsufficientCacheClusterCapacityFault"}, - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"CacheSubnetGroupNotFoundFault"}, - {"shape":"ClusterQuotaForCustomerExceededFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"TagQuotaPerResourceExceeded"}, - {"shape":"NodeGroupsPerReplicationGroupQuotaExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Creates a Redis (cluster mode disabled) or a Redis (cluster mode enabled) replication group.

A Redis (cluster mode disabled) replication group is a collection of clusters, where one of the clusters is a read/write primary and the others are read-only replicas. Writes to the primary are asynchronously propagated to the replicas.

A Redis (cluster mode enabled) replication group is a collection of 1 to 15 node groups (shards). Each node group (shard) has one read/write primary node and up to 5 read-only replica nodes. Writes to the primary are asynchronously propagated to the replicas. Redis (cluster mode enabled) replication groups partition the data across node groups (shards).

When a Redis (cluster mode disabled) replication group has been successfully created, you can add one or more read replicas to it, up to a total of 5 read replicas. You cannot alter a Redis (cluster mode enabled) replication group after it has been created. However, if you need to increase or decrease the number of node groups (console: shards), you can avail yourself of ElastiCache for Redis' enhanced backup and restore. For more information, see Restoring From a Backup with Cluster Resizing in the ElastiCache User Guide.

This operation is valid for Redis only.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotMessage"}, - "output":{ - "shape":"CreateSnapshotResult", - "resultWrapper":"CreateSnapshotResult" - }, - "errors":[ - {"shape":"SnapshotAlreadyExistsFault"}, - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"SnapshotFeatureNotSupportedFault"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Creates a copy of an entire cluster or replication group at a specific moment in time.

This operation is valid for Redis only.

" - }, - "DeleteCacheCluster":{ - "name":"DeleteCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCacheClusterMessage"}, - "output":{ - "shape":"DeleteCacheClusterResult", - "resultWrapper":"DeleteCacheClusterResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"SnapshotAlreadyExistsFault"}, - {"shape":"SnapshotFeatureNotSupportedFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes a previously provisioned cluster. DeleteCacheCluster deletes all associated cache nodes, node endpoints and the cluster itself. When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the cluster; you cannot cancel or revert this operation.

This operation cannot be used to delete a cluster that is the last read replica of a replication group or node group (shard) that has Multi-AZ mode enabled or a cluster from a Redis (cluster mode enabled) replication group.

Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

" - }, - "DeleteCacheParameterGroup":{ - "name":"DeleteCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCacheParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidCacheParameterGroupStateFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes the specified cache parameter group. You cannot delete a cache parameter group if it is associated with any cache clusters.

" - }, - "DeleteCacheSecurityGroup":{ - "name":"DeleteCacheSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCacheSecurityGroupMessage"}, - "errors":[ - {"shape":"InvalidCacheSecurityGroupStateFault"}, - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes a cache security group.

You cannot delete a cache security group if it is associated with any clusters.

" - }, - "DeleteCacheSubnetGroup":{ - "name":"DeleteCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCacheSubnetGroupMessage"}, - "errors":[ - {"shape":"CacheSubnetGroupInUse"}, - {"shape":"CacheSubnetGroupNotFoundFault"} - ], - "documentation":"

Deletes a cache subnet group.

You cannot delete a cache subnet group if it is associated with any clusters.

" - }, - "DeleteReplicationGroup":{ - "name":"DeleteReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReplicationGroupMessage"}, - "output":{ - "shape":"DeleteReplicationGroupResult", - "resultWrapper":"DeleteReplicationGroupResult" - }, - "errors":[ - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"SnapshotAlreadyExistsFault"}, - {"shape":"SnapshotFeatureNotSupportedFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes an existing replication group. By default, this operation deletes the entire replication group, including the primary/primaries and all of the read replicas. If the replication group has only one primary, you can optionally delete only the read replicas, while retaining the primary by setting RetainPrimaryCluster=true.

When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the selected resources; you cannot cancel or revert this operation.

This operation is valid for Redis only.

" - }, - "DeleteSnapshot":{ - "name":"DeleteSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotMessage"}, - "output":{ - "shape":"DeleteSnapshotResult", - "resultWrapper":"DeleteSnapshotResult" - }, - "errors":[ - {"shape":"SnapshotNotFoundFault"}, - {"shape":"InvalidSnapshotStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Deletes an existing snapshot. When you receive a successful response from this operation, ElastiCache immediately begins deleting the snapshot; you cannot cancel or revert this operation.

This operation is valid for Redis only.

" - }, - "DescribeCacheClusters":{ - "name":"DescribeCacheClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheClustersMessage"}, - "output":{ - "shape":"CacheClusterMessage", - "resultWrapper":"DescribeCacheClustersResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns information about all provisioned clusters if no cluster identifier is specified, or about a specific cache cluster if a cluster identifier is supplied.

By default, abbreviated information about the clusters is returned. You can use the optional ShowCacheNodeInfo flag to retrieve detailed information about the cache nodes associated with the clusters. These details include the DNS address and port for the cache node endpoint.

If the cluster is in the creating state, only cluster-level information is displayed until all of the nodes are successfully provisioned.

If the cluster is in the deleting state, only cluster-level information is displayed.

If cache nodes are currently being added to the cluster, node endpoint information and creation time for the additional nodes are not displayed until they are completely provisioned. When the cluster state is available, the cluster is ready for use.

If cache nodes are currently being removed from the cluster, no endpoint information for the removed nodes is displayed.

" - }, - "DescribeCacheEngineVersions":{ - "name":"DescribeCacheEngineVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheEngineVersionsMessage"}, - "output":{ - "shape":"CacheEngineVersionMessage", - "resultWrapper":"DescribeCacheEngineVersionsResult" - }, - "documentation":"

Returns a list of the available cache engines and their versions.

" - }, - "DescribeCacheParameterGroups":{ - "name":"DescribeCacheParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheParameterGroupsMessage"}, - "output":{ - "shape":"CacheParameterGroupsMessage", - "resultWrapper":"DescribeCacheParameterGroupsResult" - }, - "errors":[ - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns a list of cache parameter group descriptions. If a cache parameter group name is specified, the list contains only the descriptions for that group.

" - }, - "DescribeCacheParameters":{ - "name":"DescribeCacheParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheParametersMessage"}, - "output":{ - "shape":"CacheParameterGroupDetails", - "resultWrapper":"DescribeCacheParametersResult" - }, - "errors":[ - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns the detailed parameter list for a particular cache parameter group.

" - }, - "DescribeCacheSecurityGroups":{ - "name":"DescribeCacheSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheSecurityGroupsMessage"}, - "output":{ - "shape":"CacheSecurityGroupMessage", - "resultWrapper":"DescribeCacheSecurityGroupsResult" - }, - "errors":[ - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns a list of cache security group descriptions. If a cache security group name is specified, the list contains only the description of that group.

" - }, - "DescribeCacheSubnetGroups":{ - "name":"DescribeCacheSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheSubnetGroupsMessage"}, - "output":{ - "shape":"CacheSubnetGroupMessage", - "resultWrapper":"DescribeCacheSubnetGroupsResult" - }, - "errors":[ - {"shape":"CacheSubnetGroupNotFoundFault"} - ], - "documentation":"

Returns a list of cache subnet group descriptions. If a subnet group name is specified, the list contains only the description of that group.

" - }, - "DescribeEngineDefaultParameters":{ - "name":"DescribeEngineDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEngineDefaultParametersMessage"}, - "output":{ - "shape":"DescribeEngineDefaultParametersResult", - "resultWrapper":"DescribeEngineDefaultParametersResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns the default engine and system parameter information for the specified cache engine.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{ - "shape":"EventsMessage", - "resultWrapper":"DescribeEventsResult" - }, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns events related to clusters, cache security groups, and cache parameter groups. You can obtain events specific to a particular cluster, cache security group, or cache parameter group by providing the name as a parameter.

By default, only the events occurring within the last hour are returned; however, you can retrieve up to 14 days' worth of events if necessary.

" - }, - "DescribeReplicationGroups":{ - "name":"DescribeReplicationGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReplicationGroupsMessage"}, - "output":{ - "shape":"ReplicationGroupMessage", - "resultWrapper":"DescribeReplicationGroupsResult" - }, - "errors":[ - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns information about a particular replication group. If no identifier is specified, DescribeReplicationGroups returns information about all replication groups.

This operation is valid for Redis only.

" - }, - "DescribeReservedCacheNodes":{ - "name":"DescribeReservedCacheNodes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedCacheNodesMessage"}, - "output":{ - "shape":"ReservedCacheNodeMessage", - "resultWrapper":"DescribeReservedCacheNodesResult" - }, - "errors":[ - {"shape":"ReservedCacheNodeNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns information about reserved cache nodes for this account, or about a specified reserved cache node.

" - }, - "DescribeReservedCacheNodesOfferings":{ - "name":"DescribeReservedCacheNodesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedCacheNodesOfferingsMessage"}, - "output":{ - "shape":"ReservedCacheNodesOfferingMessage", - "resultWrapper":"DescribeReservedCacheNodesOfferingsResult" - }, - "errors":[ - {"shape":"ReservedCacheNodesOfferingNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Lists available reserved cache node offerings.

" - }, - "DescribeSnapshots":{ - "name":"DescribeSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotsMessage"}, - "output":{ - "shape":"DescribeSnapshotsListMessage", - "resultWrapper":"DescribeSnapshotsResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"SnapshotNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Returns information about cluster or replication group snapshots. By default, DescribeSnapshots lists all of your snapshots; it can optionally describe a single snapshot, or just the snapshots associated with a particular cache cluster.

This operation is valid for Redis only.

" - }, - "ListAllowedNodeTypeModifications":{ - "name":"ListAllowedNodeTypeModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAllowedNodeTypeModificationsMessage"}, - "output":{ - "shape":"AllowedNodeTypeModificationsMessage", - "resultWrapper":"ListAllowedNodeTypeModificationsResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidParameterCombinationException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Lists all available node types that you can scale your Redis cluster's or replication group's current node type up to.

When you use the ModifyCacheCluster or ModifyReplicationGroup operations to scale up your cluster or replication group, the value of the CacheNodeType parameter must be one of the node types returned by this operation.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceMessage"}, - "output":{ - "shape":"TagListMessage", - "resultWrapper":"ListTagsForResourceResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"SnapshotNotFoundFault"}, - {"shape":"InvalidARNFault"} - ], - "documentation":"

Lists all cost allocation tags currently on the named resource. A cost allocation tag is a key-value pair where the key is case-sensitive and the value is optional. You can use cost allocation tags to categorize and track your AWS costs.

You can have a maximum of 50 cost allocation tags on an ElastiCache resource. For more information, see Using Cost Allocation Tags in Amazon ElastiCache.

" - }, - "ModifyCacheCluster":{ - "name":"ModifyCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyCacheClusterMessage"}, - "output":{ - "shape":"ModifyCacheClusterResult", - "resultWrapper":"ModifyCacheClusterResult" - }, - "errors":[ - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"InvalidCacheSecurityGroupStateFault"}, - {"shape":"InsufficientCacheClusterCapacityFault"}, - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the settings for a cluster. You can use this operation to change one or more cluster configuration parameters by specifying the parameters and the new values.

" - }, - "ModifyCacheParameterGroup":{ - "name":"ModifyCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyCacheParameterGroupMessage"}, - "output":{ - "shape":"CacheParameterGroupNameMessage", - "resultWrapper":"ModifyCacheParameterGroupResult" - }, - "errors":[ - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidCacheParameterGroupStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the parameters of a cache parameter group. You can modify up to 20 parameters in a single request by submitting a list parameter name and value pairs.

" - }, - "ModifyCacheSubnetGroup":{ - "name":"ModifyCacheSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyCacheSubnetGroupMessage"}, - "output":{ - "shape":"ModifyCacheSubnetGroupResult", - "resultWrapper":"ModifyCacheSubnetGroupResult" - }, - "errors":[ - {"shape":"CacheSubnetGroupNotFoundFault"}, - {"shape":"CacheSubnetQuotaExceededFault"}, - {"shape":"SubnetInUse"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Modifies an existing cache subnet group.

" - }, - "ModifyReplicationGroup":{ - "name":"ModifyReplicationGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReplicationGroupMessage"}, - "output":{ - "shape":"ModifyReplicationGroupResult", - "resultWrapper":"ModifyReplicationGroupResult" - }, - "errors":[ - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"InvalidCacheSecurityGroupStateFault"}, - {"shape":"InsufficientCacheClusterCapacityFault"}, - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"NodeQuotaForClusterExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the settings for a replication group.

Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

This operation is valid for Redis only.

" - }, - "ModifyReplicationGroupShardConfiguration":{ - "name":"ModifyReplicationGroupShardConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyReplicationGroupShardConfigurationMessage"}, - "output":{ - "shape":"ModifyReplicationGroupShardConfigurationResult", - "resultWrapper":"ModifyReplicationGroupShardConfigurationResult" - }, - "errors":[ - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InsufficientCacheClusterCapacityFault"}, - {"shape":"NodeGroupsPerReplicationGroupQuotaExceededFault"}, - {"shape":"NodeQuotaForCustomerExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Performs horizontal scaling on a Redis (cluster mode enabled) cluster with no downtime. Requires Redis engine version 3.2.10 or newer. For information on upgrading your engine to a newer version, see Upgrading Engine Versions in the Amazon ElastiCache User Guide.

For more information on ElastiCache for Redis online horizontal scaling, see ElastiCache for Redis Horizontal Scaling

" - }, - "PurchaseReservedCacheNodesOffering":{ - "name":"PurchaseReservedCacheNodesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedCacheNodesOfferingMessage"}, - "output":{ - "shape":"PurchaseReservedCacheNodesOfferingResult", - "resultWrapper":"PurchaseReservedCacheNodesOfferingResult" - }, - "errors":[ - {"shape":"ReservedCacheNodesOfferingNotFoundFault"}, - {"shape":"ReservedCacheNodeAlreadyExistsFault"}, - {"shape":"ReservedCacheNodeQuotaExceededFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Allows you to purchase a reserved cache node offering.

" - }, - "RebootCacheCluster":{ - "name":"RebootCacheCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootCacheClusterMessage"}, - "output":{ - "shape":"RebootCacheClusterResult", - "resultWrapper":"RebootCacheClusterResult" - }, - "errors":[ - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"CacheClusterNotFoundFault"} - ], - "documentation":"

Reboots some, or all, of the cache nodes within a provisioned cluster. This operation applies any modified cache parameter groups to the cluster. The reboot operation takes place as soon as possible, and results in a momentary outage to the cluster. During the reboot, the cluster status is set to REBOOTING.

The reboot causes the contents of the cache (for each cache node being rebooted) to be lost.

When the reboot is complete, a cluster event is created.

Rebooting a cluster is currently supported on Memcached and Redis (cluster mode disabled) clusters. Rebooting is not supported on Redis (cluster mode enabled) clusters.

If you make changes to parameters that require a Redis (cluster mode enabled) cluster reboot for the changes to be applied, see Rebooting a Cluster for an alternate process.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceMessage"}, - "output":{ - "shape":"TagListMessage", - "resultWrapper":"RemoveTagsFromResourceResult" - }, - "errors":[ - {"shape":"CacheClusterNotFoundFault"}, - {"shape":"SnapshotNotFoundFault"}, - {"shape":"InvalidARNFault"}, - {"shape":"TagNotFoundFault"} - ], - "documentation":"

Removes the tags identified by the TagKeys list from the named resource.

" - }, - "ResetCacheParameterGroup":{ - "name":"ResetCacheParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetCacheParameterGroupMessage"}, - "output":{ - "shape":"CacheParameterGroupNameMessage", - "resultWrapper":"ResetCacheParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidCacheParameterGroupStateFault"}, - {"shape":"CacheParameterGroupNotFoundFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Modifies the parameters of a cache parameter group to the engine or system default value. You can reset specific parameters by submitting a list of parameter names. To reset the entire cache parameter group, specify the ResetAllParameters and CacheParameterGroupName parameters.

" - }, - "RevokeCacheSecurityGroupIngress":{ - "name":"RevokeCacheSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeCacheSecurityGroupIngressMessage"}, - "output":{ - "shape":"RevokeCacheSecurityGroupIngressResult", - "resultWrapper":"RevokeCacheSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"CacheSecurityGroupNotFoundFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"InvalidCacheSecurityGroupStateFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Revokes ingress from a cache security group. Use this operation to disallow access from an Amazon EC2 security group that had been previously authorized.

" - }, - "TestFailover":{ - "name":"TestFailover", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestFailoverMessage"}, - "output":{ - "shape":"TestFailoverResult", - "resultWrapper":"TestFailoverResult" - }, - "errors":[ - {"shape":"APICallRateForCustomerExceededFault"}, - {"shape":"InvalidCacheClusterStateFault"}, - {"shape":"InvalidReplicationGroupStateFault"}, - {"shape":"NodeGroupNotFoundFault"}, - {"shape":"ReplicationGroupNotFoundFault"}, - {"shape":"TestFailoverNotAvailableFault"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InvalidParameterCombinationException"} - ], - "documentation":"

Represents the input of a TestFailover operation which test automatic failover on a specified node group (called shard in the console) in a replication group (called cluster in the console).

Note the following

  • A customer can use this operation to test automatic failover on up to 5 shards (called node groups in the ElastiCache API and AWS CLI) in any rolling 24-hour period.

  • If calling this operation on shards in different clusters (called replication groups in the API and CLI), the calls can be made concurrently.

  • If calling this operation multiple times on different shards in the same Redis (cluster mode enabled) replication group, the first node replacement must complete before a subsequent call can be made.

  • To determine whether the node replacement is complete you can check Events using the Amazon ElastiCache console, the AWS CLI, or the ElastiCache API. Look for the following automatic failover related events, listed here in order of occurrance:

    1. Replication group message: Test Failover API called for node group <node-group-id>

    2. Cache cluster message: Failover from master node <primary-node-id> to replica node <node-id> completed

    3. Replication group message: Failover from master node <primary-node-id> to replica node <node-id> completed

    4. Cache cluster message: Recovering cache nodes <node-id>

    5. Cache cluster message: Finished recovery for cache nodes <node-id>

    For more information see:

Also see, Testing Multi-AZ with Automatic Failover in the ElastiCache User Guide.

" - } - }, - "shapes":{ - "APICallRateForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The customer has exceeded the allowed rate of API calls.

", - "error":{ - "code":"APICallRateForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AZMode":{ - "type":"string", - "enum":[ - "single-az", - "cross-az" - ] - }, - "AddTagsToResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the resource to which the tags are to be added, for example arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster or arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot. ElastiCache resources are cluster and snapshot.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.

" - } - }, - "documentation":"

Represents the input of an AddTagsToResource operation.

" - }, - "AllowedNodeTypeModificationsMessage":{ - "type":"structure", - "members":{ - "ScaleUpModifications":{ - "shape":"NodeTypeList", - "documentation":"

A string list, each element of which specifies a cache node type which you can use to scale your cluster or replication group.

When scaling up a Redis cluster or replication group using ModifyCacheCluster or ModifyReplicationGroup, use a value from this list for the CacheNodeType parameter.

" - } - }, - "documentation":"

Represents the allowed node types you can use to modify your cluster or replication group.

" - }, - "AuthorizationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon EC2 security group is already authorized for the specified cache security group.

", - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon EC2 security group is not authorized for the specified cache security group.

", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "AuthorizeCacheSecurityGroupIngressMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "EC2SecurityGroupName", - "EC2SecurityGroupOwnerId" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The cache security group that allows network ingress.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The Amazon EC2 security group to be authorized for ingress to the cache security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the Amazon EC2 security group owner. Note that this is not the same thing as an AWS access key ID - you must provide a valid AWS account number for this parameter.

" - } - }, - "documentation":"

Represents the input of an AuthorizeCacheSecurityGroupIngress operation.

" - }, - "AuthorizeCacheSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - }, - "AutomaticFailoverStatus":{ - "type":"string", - "enum":[ - "enabled", - "disabled", - "enabling", - "disabling" - ] - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

" - } - }, - "documentation":"

Describes an Availability Zone in which the cluster is launched.

", - "wrapper":true - }, - "AvailabilityZonesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AvailabilityZone" - } - }, - "AwsQueryErrorMessage":{"type":"string"}, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "CacheCluster":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied identifier of the cluster. This identifier is a unique key that identifies a cluster.

" - }, - "ConfigurationEndpoint":{ - "shape":"Endpoint", - "documentation":"

Represents a Memcached cluster endpoint which, if Automatic Discovery is enabled on the cluster, can be used by an application to connect to any node in the cluster. The configuration endpoint will always have .cfg in it.

Example: mem-3.9dvc4r.cfg.usw2.cache.amazonaws.com:11211

" - }, - "ClientDownloadLandingPage":{ - "shape":"String", - "documentation":"

The URL of the web page where you can download the latest ElastiCache client library.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The name of the compute and memory capacity node type for the cluster.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine (memcached or redis) to be used for this cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the cache engine that is used in this cluster.

" - }, - "CacheClusterStatus":{ - "shape":"String", - "documentation":"

The current state of this cluster, one of the following values: available, creating, deleted, deleting, incompatible-network, modifying, rebooting cluster nodes, restore-failed, or snapshotting.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes in the cluster.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the cluster is located or \"Multiple\" if the cache nodes are located in different Availability Zones.

" - }, - "CacheClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cluster was created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "PendingModifiedValues":{"shape":"PendingModifiedValues"}, - "NotificationConfiguration":{ - "shape":"NotificationConfiguration", - "documentation":"

Describes a notification topic and its status. Notification topics are used for publishing ElastiCache events to subscribers using Amazon Simple Notification Service (SNS).

" - }, - "CacheSecurityGroups":{ - "shape":"CacheSecurityGroupMembershipList", - "documentation":"

A list of cache security group elements, composed of name and status sub-elements.

" - }, - "CacheParameterGroup":{ - "shape":"CacheParameterGroupStatus", - "documentation":"

Status of the cache parameter group.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group associated with the cluster.

" - }, - "CacheNodes":{ - "shape":"CacheNodeList", - "documentation":"

A list of cache nodes that are members of the cluster.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

This parameter is currently disabled.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupMembershipList", - "documentation":"

A list of VPC Security Groups associated with the cluster.

" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The replication group to which this cluster belongs. If this field is empty, the cluster is not associated with any replication group.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cluster.

Example: 05:00-09:00

" - }, - "AuthTokenEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables using an AuthToken (password) when issuing Redis commands.

Default: false

" - }, - "TransitEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables in-transit encryption when set to true.

You cannot modify the value of TransitEncryptionEnabled after the cluster is created. To enable in-transit encryption on a cluster you must set TransitEncryptionEnabled to true when you create a cluster.

Default: false

" - }, - "AtRestEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables encryption at-rest when set to true.

You cannot modify the value of AtRestEncryptionEnabled after the cluster is created. To enable at-rest encryption on a cluster you must set AtRestEncryptionEnabled to true when you create a cluster.

Default: false

" - } - }, - "documentation":"

Contains all of the attributes of a specific cluster.

", - "wrapper":true - }, - "CacheClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You already have a cluster with the given identifier.

", - "error":{ - "code":"CacheClusterAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheClusterList":{ - "type":"list", - "member":{ - "shape":"CacheCluster", - "locationName":"CacheCluster" - } - }, - "CacheClusterMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheClusters":{ - "shape":"CacheClusterList", - "documentation":"

A list of clusters. Each item in the list contains detailed information about one cluster.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheClusters operation.

" - }, - "CacheClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cluster ID does not refer to an existing cluster.

", - "error":{ - "code":"CacheClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "CacheEngineVersion":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cache engine.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family associated with this cache engine.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

" - }, - "CacheEngineDescription":{ - "shape":"String", - "documentation":"

The description of the cache engine.

" - }, - "CacheEngineVersionDescription":{ - "shape":"String", - "documentation":"

The description of the cache engine version.

" - } - }, - "documentation":"

Provides all of the details about a particular cache engine version.

" - }, - "CacheEngineVersionList":{ - "type":"list", - "member":{ - "shape":"CacheEngineVersion", - "locationName":"CacheEngineVersion" - } - }, - "CacheEngineVersionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheEngineVersions":{ - "shape":"CacheEngineVersionList", - "documentation":"

A list of cache engine version details. Each element in the list contains detailed information about one cache engine version.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheEngineVersions operation.

" - }, - "CacheNode":{ - "type":"structure", - "members":{ - "CacheNodeId":{ - "shape":"String", - "documentation":"

The cache node identifier. A node ID is a numeric identifier (0001, 0002, etc.). The combination of cluster ID and node ID uniquely identifies every cache node used in a customer's AWS account.

" - }, - "CacheNodeStatus":{ - "shape":"String", - "documentation":"

The current state of this cache node.

" - }, - "CacheNodeCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cache node was created.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The hostname for connecting to this cache node.

" - }, - "ParameterGroupStatus":{ - "shape":"String", - "documentation":"

The status of the parameter group applied to this cache node.

" - }, - "SourceCacheNodeId":{ - "shape":"String", - "documentation":"

The ID of the primary node to which this read replica node is synchronized. If this field is empty, this node is not associated with a primary cluster.

" - }, - "CustomerAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where this node was created and now resides.

" - } - }, - "documentation":"

Represents an individual cache node within a cluster. Each cache node runs its own instance of the cluster's protocol-compliant caching software - either Memcached or Redis.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "CacheNodeIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CacheNodeId" - } - }, - "CacheNodeList":{ - "type":"list", - "member":{ - "shape":"CacheNode", - "locationName":"CacheNode" - } - }, - "CacheNodeTypeSpecificParameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the parameter value.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest cache engine version to which the parameter can apply.

" - }, - "CacheNodeTypeSpecificValues":{ - "shape":"CacheNodeTypeSpecificValueList", - "documentation":"

A list of cache node types and their corresponding values for this parameter.

" - }, - "ChangeType":{ - "shape":"ChangeType", - "documentation":"

Indicates whether a change to the parameter is applied immediately or requires a reboot for the change to be applied. You can force a reboot or wait until the next maintenance window's reboot. For more information, see Rebooting a Cluster.

" - } - }, - "documentation":"

A parameter that has a different value for each cache node type it is applied to. For example, in a Redis cluster, a cache.m1.large cache node type would have a larger maxmemory value than a cache.m1.small type.

" - }, - "CacheNodeTypeSpecificParametersList":{ - "type":"list", - "member":{ - "shape":"CacheNodeTypeSpecificParameter", - "locationName":"CacheNodeTypeSpecificParameter" - } - }, - "CacheNodeTypeSpecificValue":{ - "type":"structure", - "members":{ - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for which this value applies.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value for the cache node type.

" - } - }, - "documentation":"

A value that applies only to a certain cache node type.

" - }, - "CacheNodeTypeSpecificValueList":{ - "type":"list", - "member":{ - "shape":"CacheNodeTypeSpecificValue", - "locationName":"CacheNodeTypeSpecificValue" - } - }, - "CacheParameterGroup":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family that this cache parameter group is compatible with.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for this cache parameter group.

" - } - }, - "documentation":"

Represents the output of a CreateCacheParameterGroup operation.

", - "wrapper":true - }, - "CacheParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A cache parameter group with the requested name already exists.

", - "error":{ - "code":"CacheParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheParameterGroupDetails":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter instances.

" - }, - "CacheNodeTypeSpecificParameters":{ - "shape":"CacheNodeTypeSpecificParametersList", - "documentation":"

A list of parameters specific to a particular cache node type. Each element in the list contains detailed information about one parameter.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheParameters operation.

" - }, - "CacheParameterGroupList":{ - "type":"list", - "member":{ - "shape":"CacheParameterGroup", - "locationName":"CacheParameterGroup" - } - }, - "CacheParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - } - }, - "documentation":"

Represents the output of one of the following operations:

  • ModifyCacheParameterGroup

  • ResetCacheParameterGroup

" - }, - "CacheParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache parameter group name does not refer to an existing cache parameter group.

", - "error":{ - "code":"CacheParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "CacheParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the maximum number of cache security groups.

", - "error":{ - "code":"CacheParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheParameterGroupStatus":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - }, - "CacheNodeIdsToReboot":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of the cache node IDs which need to be rebooted for parameter changes to be applied. A node ID is a numeric identifier (0001, 0002, etc.).

" - } - }, - "documentation":"

Status of the cache parameter group.

" - }, - "CacheParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheParameterGroups":{ - "shape":"CacheParameterGroupList", - "documentation":"

A list of cache parameter groups. Each element in the list contains detailed information about one cache parameter group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheParameterGroups operation.

" - }, - "CacheSecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the cache security group owner.

" - }, - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the cache security group.

" - }, - "EC2SecurityGroups":{ - "shape":"EC2SecurityGroupList", - "documentation":"

A list of Amazon EC2 security groups that are associated with this cache security group.

" - } - }, - "documentation":"

Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress

  • CreateCacheSecurityGroup

  • RevokeCacheSecurityGroupIngress

", - "wrapper":true - }, - "CacheSecurityGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A cache security group with the specified name already exists.

", - "error":{ - "code":"CacheSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSecurityGroupMembership":{ - "type":"structure", - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The membership status in the cache security group. The status changes when a cache security group is modified, or when the cache security groups assigned to a cluster are modified.

" - } - }, - "documentation":"

Represents a cluster's status within a particular cache security group.

" - }, - "CacheSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"CacheSecurityGroupMembership", - "locationName":"CacheSecurityGroup" - } - }, - "CacheSecurityGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheSecurityGroups":{ - "shape":"CacheSecurityGroups", - "documentation":"

A list of cache security groups. Each element in the list contains detailed information about one group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheSecurityGroups operation.

" - }, - "CacheSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"CacheSecurityGroupName" - } - }, - "CacheSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache security group name does not refer to an existing cache security group.

", - "error":{ - "code":"CacheSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "CacheSecurityGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache security groups.

", - "error":{ - "code":"QuotaExceeded.CacheSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSecurityGroups":{ - "type":"list", - "member":{ - "shape":"CacheSecurityGroup", - "locationName":"CacheSecurityGroup" - } - }, - "CacheSubnetGroup":{ - "type":"structure", - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group.

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description of the cache subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

A list of subnets associated with the cache subnet group.

" - } - }, - "documentation":"

Represents the output of one of the following operations:

  • CreateCacheSubnetGroup

  • ModifyCacheSubnetGroup

", - "wrapper":true - }, - "CacheSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache subnet group name is already in use by an existing cache subnet group.

", - "error":{ - "code":"CacheSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSubnetGroupInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache subnet group is currently in use.

", - "error":{ - "code":"CacheSubnetGroupInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "CacheSubnetGroups":{ - "shape":"CacheSubnetGroups", - "documentation":"

A list of cache subnet groups. Each element in the list contains detailed information about one group.

" - } - }, - "documentation":"

Represents the output of a DescribeCacheSubnetGroups operation.

" - }, - "CacheSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache subnet group name does not refer to an existing cache subnet group.

", - "error":{ - "code":"CacheSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache subnet groups.

", - "error":{ - "code":"CacheSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CacheSubnetGroups":{ - "type":"list", - "member":{ - "shape":"CacheSubnetGroup", - "locationName":"CacheSubnetGroup" - } - }, - "CacheSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of subnets in a cache subnet group.

", - "error":{ - "code":"CacheSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ChangeType":{ - "type":"string", - "enum":[ - "immediate", - "requires-reboot" - ] - }, - "ClusterIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ClusterId" - } - }, - "ClusterQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of clusters per customer.

", - "error":{ - "code":"ClusterQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CopySnapshotMessage":{ - "type":"structure", - "required":[ - "SourceSnapshotName", - "TargetSnapshotName" - ], - "members":{ - "SourceSnapshotName":{ - "shape":"String", - "documentation":"

The name of an existing snapshot from which to make a copy.

" - }, - "TargetSnapshotName":{ - "shape":"String", - "documentation":"

A name for the snapshot copy. ElastiCache does not permit overwriting a snapshot, therefore this name must be unique within its context - ElastiCache or an Amazon S3 bucket if exporting.

" - }, - "TargetBucket":{ - "shape":"String", - "documentation":"

The Amazon S3 bucket to which the snapshot is exported. This parameter is used only when exporting a snapshot for external access.

When using this parameter to export a snapshot, be sure Amazon ElastiCache has the needed permissions to this S3 bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the Amazon ElastiCache User Guide.

For more information, see Exporting a Snapshot in the Amazon ElastiCache User Guide.

" - } - }, - "documentation":"

Represents the input of a CopySnapshotMessage operation.

" - }, - "CopySnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "CreateCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The node group (shard) identifier. This parameter is stored as a lowercase string.

Constraints:

  • A name must contain from 1 to 20 alphanumeric characters or hyphens.

  • The first character must be a letter.

  • A name cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

The ID of the replication group to which this cluster should belong. If this parameter is specified, the cluster is added to the specified replication group as a read replica; otherwise, the cluster is a standalone primary that is not part of any replication group.

If the specified replication group is Multi-AZ enabled and the Availability Zone is not specified, the cluster is created in Availability Zones that provide the best spread of read replicas across Availability Zones.

This parameter is only valid if the Engine parameter is redis.

" - }, - "AZMode":{ - "shape":"AZMode", - "documentation":"

Specifies whether the nodes in this Memcached cluster are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.

This parameter is only supported for Memcached clusters.

If the AZMode and PreferredAvailabilityZones are not specified, ElastiCache assumes single-az mode.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone in which the cluster is created.

All nodes belonging to this Memcached cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use PreferredAvailabilityZones.

Default: System chosen Availability Zone.

" - }, - "PreferredAvailabilityZones":{ - "shape":"PreferredAvailabilityZoneList", - "documentation":"

A list of the Availability Zones in which cache nodes are created. The order of the zones in the list is not important.

This option is only supported on Memcached.

If you are creating your cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.

The number of Availability Zones listed must equal the value of NumCacheNodes.

If you want all the nodes in the same Availability Zone, use PreferredAvailabilityZone instead, or repeat the Availability Zone multiple times in the list.

Default: System chosen Availability Zones.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The initial number of cache nodes that the cluster has.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.

If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the nodes in the node group (shard).

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine to be used for this cluster.

Valid values for this parameter are: memcached | redis

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cache engine to be used for this cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions operation.

Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cluster or replication group and create it anew with the earlier engine version.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to associate with this cluster. If this argument is omitted, the default parameter group for the specified engine is used. You cannot use any parameter group which has cluster-enabled='yes' when creating a cluster.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group to be used for the cluster.

Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (Amazon VPC).

If you're going to launch your cluster in an Amazon VPC, you need to create a subnet group before you start creating a cluster. For more information, see Subnets and Subnet Groups.

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of security group names to associate with this cluster.

Use this parameter only when you are creating a cluster outside of an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

One or more VPC security groups associated with the cluster.

Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of cost allocation tags to be added to this resource.

" - }, - "SnapshotArns":{ - "shape":"SnapshotArnsList", - "documentation":"

A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file is used to populate the node group (shard). The Amazon S3 object name in the ARN cannot contain any commas.

This parameter is only valid if the Engine parameter is redis.

Example of an Amazon S3 ARN: arn:aws:s3:::my_bucket/snapshot1.rdb

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a Redis snapshot from which to restore data into the new node group (shard). The snapshot status changes to restoring while the new node group (shard) is being created.

This parameter is only valid if the Engine parameter is redis.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period. Valid values for ddd are:

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which each of the cache nodes accepts connections.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

The Amazon SNS topic owner must be the same as the cluster owner.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is currently disabled.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot taken today is retained for 5 days before being deleted.

This parameter is only valid if the Engine parameter is redis.

Default: 0 (i.e., automatic backups are disabled for this cluster).

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).

Example: 05:00-09:00

If you do not specify this parameter, ElastiCache automatically chooses an appropriate time range.

This parameter is only valid if the Engine parameter is redis.

" - }, - "AuthToken":{ - "shape":"String", - "documentation":"

Reserved parameter. The password used to access a password protected server.

This parameter is valid only if:

  • The parameter TransitEncryptionEnabled was set to true when the cluster was created.

  • The line requirepass was added to the database configuration file.

Password constraints:

  • Must be only printable ASCII characters.

  • Must be at least 16 characters and no more than 128 characters in length.

  • Cannot contain any of the following characters: '/', '\"', or '@'.

For more information, see AUTH password at http://redis.io/commands/AUTH.

" - } - }, - "documentation":"

Represents the input of a CreateCacheCluster operation.

" - }, - "CreateCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "CreateCacheParameterGroupMessage":{ - "type":"structure", - "required":[ - "CacheParameterGroupName", - "CacheParameterGroupFamily", - "Description" - ], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

A user-specified name for the cache parameter group.

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family that the cache parameter group can be used with.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

" - }, - "Description":{ - "shape":"String", - "documentation":"

A user-specified description for the cache parameter group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheParameterGroup operation.

" - }, - "CreateCacheParameterGroupResult":{ - "type":"structure", - "members":{ - "CacheParameterGroup":{"shape":"CacheParameterGroup"} - } - }, - "CreateCacheSecurityGroupMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "Description" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

A name for the cache security group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters. Cannot be the word \"Default\".

Example: mysecuritygroup

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the cache security group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheSecurityGroup operation.

" - }, - "CreateCacheSecurityGroupResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - }, - "CreateCacheSubnetGroupMessage":{ - "type":"structure", - "required":[ - "CacheSubnetGroupName", - "CacheSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

A name for the cache subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

Example: mysubnetgroup

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

A description for the cache subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

A list of VPC subnet IDs for the cache subnet group.

" - } - }, - "documentation":"

Represents the input of a CreateCacheSubnetGroup operation.

" - }, - "CreateCacheSubnetGroupResult":{ - "type":"structure", - "members":{ - "CacheSubnetGroup":{"shape":"CacheSubnetGroup"} - } - }, - "CreateReplicationGroupMessage":{ - "type":"structure", - "required":[ - "ReplicationGroupId", - "ReplicationGroupDescription" - ], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The replication group identifier. This parameter is stored as a lowercase string.

Constraints:

  • A name must contain from 1 to 20 alphanumeric characters or hyphens.

  • The first character must be a letter.

  • A name cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "ReplicationGroupDescription":{ - "shape":"String", - "documentation":"

A user-created description for the replication group.

" - }, - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

The identifier of the cluster that serves as the primary for this replication group. This cluster must already exist and have a status of available.

This parameter is not required if NumCacheClusters, NumNodeGroups, or ReplicasPerNodeGroup is specified.

" - }, - "AutomaticFailoverEnabled":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether a read-only replica is automatically promoted to read/write primary if the existing primary fails.

If true, Multi-AZ is enabled for this replication group. If false, Multi-AZ is disabled for this replication group.

AutomaticFailoverEnabled must be enabled for Redis (cluster mode enabled) replication groups.

Default: false

Amazon ElastiCache for Redis does not support Multi-AZ with automatic failover on:

  • Redis versions earlier than 2.8.6.

  • Redis (cluster mode disabled): T1 and T2 cache node types.

  • Redis (cluster mode enabled): T1 node types.

" - }, - "NumCacheClusters":{ - "shape":"IntegerOptional", - "documentation":"

The number of clusters this replication group initially has.

This parameter is not used if there is more than one node group (shard). You should use ReplicasPerNodeGroup instead.

If AutomaticFailoverEnabled is true, the value of this parameter must be at least 2. If AutomaticFailoverEnabled is false you can omit this parameter (it will default to 1), or you can explicitly set it to a value between 2 and 6.

The maximum permitted value for NumCacheClusters is 6 (primary plus 5 replicas).

" - }, - "PreferredCacheClusterAZs":{ - "shape":"AvailabilityZonesList", - "documentation":"

A list of EC2 Availability Zones in which the replication group's clusters are created. The order of the Availability Zones in the list is the order in which clusters are allocated. The primary cluster is created in the first AZ in the list.

This parameter is not used if there is more than one node group (shard). You should use NodeGroupConfiguration instead.

If you are creating your replication group in an Amazon VPC (recommended), you can only locate clusters in Availability Zones associated with the subnets in the selected subnet group.

The number of Availability Zones listed must equal the value of NumCacheClusters.

Default: system chosen Availability Zones.

" - }, - "NumNodeGroups":{ - "shape":"IntegerOptional", - "documentation":"

An optional parameter that specifies the number of node groups (shards) for this Redis (cluster mode enabled) replication group. For Redis (cluster mode disabled) either omit this parameter or set it to 1.

Default: 1

" - }, - "ReplicasPerNodeGroup":{ - "shape":"IntegerOptional", - "documentation":"

An optional parameter that specifies the number of replica nodes in each node group (shard). Valid values are 0 to 5.

" - }, - "NodeGroupConfiguration":{ - "shape":"NodeGroupConfigurationList", - "documentation":"

A list of node group (shard) configuration options. Each node group (shard) configuration has the following: Slots, PrimaryAvailabilityZone, ReplicaAvailabilityZones, ReplicaCount.

If you're creating a Redis (cluster mode disabled) or a Redis (cluster mode enabled) replication group, you can use this parameter to individually configure each node group (shard), or you can omit this parameter.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the nodes in the node group (shard).

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine to be used for the clusters in this replication group.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the cache engine to be used for the clusters in this replication group. To view the supported cache engine versions, use the DescribeCacheEngineVersions operation.

Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version) in the ElastiCache User Guide, but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cluster or replication group and create it anew with the earlier engine version.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to associate with this replication group. If this argument is omitted, the default cache parameter group for the specified engine is used.

If you are running Redis version 3.2.4 or later, only one node group (shard), and want to use a default parameter group, we recommend that you specify the parameter group by name.

  • To create a Redis (cluster mode disabled) replication group, use CacheParameterGroupName=default.redis3.2.

  • To create a Redis (cluster mode enabled) replication group, use CacheParameterGroupName=default.redis3.2.cluster.on.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to be used for the replication group.

If you're going to launch your cluster in an Amazon VPC, you need to create a subnet group before you start creating a cluster. For more information, see Subnets and Subnet Groups.

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to associate with this replication group.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

One or more Amazon VPC security groups associated with this replication group.

Use this parameter only when you are creating a replication group in an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key does not have to be accompanied by a tag value.

" - }, - "SnapshotArns":{ - "shape":"SnapshotArnsList", - "documentation":"

A list of Amazon Resource Names (ARN) that uniquely identify the Redis RDB snapshot files stored in Amazon S3. The snapshot files are used to populate the new replication group. The Amazon S3 object name in the ARN cannot contain any commas. The new replication group will have the number of node groups (console: shards) specified by the parameter NumNodeGroups or the number of node groups configured by NodeGroupConfiguration regardless of the number of ARNs specified here.

Example of an Amazon S3 ARN: arn:aws:s3:::my_bucket/snapshot1.rdb

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a snapshot from which to restore data into the new replication group. The snapshot status changes to restoring while the new replication group is being created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period. Valid values for ddd are:

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which each member of the replication group accepts connections.

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

The Amazon SNS topic owner must be the same as the cluster owner.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is currently disabled.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

Default: 0 (i.e., automatic backups are disabled for this cluster).

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).

Example: 05:00-09:00

If you do not specify this parameter, ElastiCache automatically chooses an appropriate time range.

" - }, - "AuthToken":{ - "shape":"String", - "documentation":"

Reserved parameter. The password used to access a password protected server.

This parameter is valid only if:

  • The parameter TransitEncryptionEnabled was set to true when the cluster was created.

  • The line requirepass was added to the database configuration file.

Password constraints:

  • Must be only printable ASCII characters.

  • Must be at least 16 characters and no more than 128 characters in length.

  • Cannot contain any of the following characters: '/', '\"', or '@'.

For more information, see AUTH password at http://redis.io/commands/AUTH.

" - }, - "TransitEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables in-transit encryption when set to true.

You cannot modify the value of TransitEncryptionEnabled after the cluster is created. To enable in-transit encryption on a cluster you must set TransitEncryptionEnabled to true when you create a cluster.

This parameter is valid only if the Engine parameter is redis, the EngineVersion parameter is 3.2.4 or later, and the cluster is being created in an Amazon VPC.

If you enable in-transit encryption, you must also specify a value for CacheSubnetGroup.

Default: false

" - }, - "AtRestEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables encryption at rest when set to true.

You cannot modify the value of AtRestEncryptionEnabled after the replication group is created. To enable encryption at rest on a replication group you must set AtRestEncryptionEnabled to true when you create the replication group.

This parameter is valid only if the Engine parameter is redis and the cluster is being created in an Amazon VPC.

Default: false

" - } - }, - "documentation":"

Represents the input of a CreateReplicationGroup operation.

" - }, - "CreateReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "CreateSnapshotMessage":{ - "type":"structure", - "required":["SnapshotName"], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier of an existing replication group. The snapshot is created from this replication group.

" - }, - "CacheClusterId":{ - "shape":"String", - "documentation":"

The identifier of an existing cluster. The snapshot is created from this cluster.

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

A name for the snapshot being created.

" - } - }, - "documentation":"

Represents the input of a CreateSnapshot operation.

" - }, - "CreateSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "DeleteCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cluster identifier for the cluster to be deleted. This parameter is not case sensitive.

" - }, - "FinalSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. ElastiCache creates the snapshot, and then deletes the cluster immediately afterward.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheCluster operation.

" - }, - "DeleteCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "DeleteCacheParameterGroupMessage":{ - "type":"structure", - "required":["CacheParameterGroupName"], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to delete.

The specified cache security group must not be associated with any clusters.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheParameterGroup operation.

" - }, - "DeleteCacheSecurityGroupMessage":{ - "type":"structure", - "required":["CacheSecurityGroupName"], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to delete.

You cannot delete the default security group.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheSecurityGroup operation.

" - }, - "DeleteCacheSubnetGroupMessage":{ - "type":"structure", - "required":["CacheSubnetGroupName"], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to delete.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

" - } - }, - "documentation":"

Represents the input of a DeleteCacheSubnetGroup operation.

" - }, - "DeleteReplicationGroupMessage":{ - "type":"structure", - "required":["ReplicationGroupId"], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the cluster to be deleted. This parameter is not case sensitive.

" - }, - "RetainPrimaryCluster":{ - "shape":"BooleanOptional", - "documentation":"

If set to true, all of the read replicas are deleted, but the primary node is retained.

" - }, - "FinalSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The name of a final node group (shard) snapshot. ElastiCache creates the snapshot from the primary node in the cluster, rather than one of the replicas; this is to ensure that it captures the freshest data. After the final snapshot is taken, the replication group is immediately deleted.

" - } - }, - "documentation":"

Represents the input of a DeleteReplicationGroup operation.

" - }, - "DeleteReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "DeleteSnapshotMessage":{ - "type":"structure", - "required":["SnapshotName"], - "members":{ - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of the snapshot to be deleted.

" - } - }, - "documentation":"

Represents the input of a DeleteSnapshot operation.

" - }, - "DeleteSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "DescribeCacheClustersMessage":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied cluster identifier. If this parameter is specified, only information about that specific cluster is returned. This parameter isn't case sensitive.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ShowCacheNodeInfo":{ - "shape":"BooleanOptional", - "documentation":"

An optional flag that can be included in the DescribeCacheCluster request to retrieve information about the individual cache nodes.

" - }, - "ShowCacheClustersNotInReplicationGroups":{ - "shape":"BooleanOptional", - "documentation":"

An optional flag that can be included in the DescribeCacheCluster request to show only nodes (API/CLI: clusters) that are not members of a replication group. In practice, this mean Memcached and single node Redis clusters.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheClusters operation.

" - }, - "DescribeCacheEngineVersionsMessage":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The cache engine to return. Valid values: memcached | redis

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The cache engine version to return.

Example: 1.4.14

" - }, - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group family to return details for.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

Constraints:

  • Must be 1 to 255 alphanumeric characters

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DefaultOnly":{ - "shape":"Boolean", - "documentation":"

If true, specifies that only the default version of the specified engine or engine and major version combination is to be returned.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheEngineVersions operation.

" - }, - "DescribeCacheParameterGroupsMessage":{ - "type":"structure", - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheParameterGroups operation.

" - }, - "DescribeCacheParametersMessage":{ - "type":"structure", - "required":["CacheParameterGroupName"], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific cache parameter group to return details for.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return.

Valid values: user | system | engine-default

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheParameters operation.

" - }, - "DescribeCacheSecurityGroupsMessage":{ - "type":"structure", - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheSecurityGroups operation.

" - }, - "DescribeCacheSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group to return details for.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeCacheSubnetGroups operation.

" - }, - "DescribeEngineDefaultParametersMessage":{ - "type":"structure", - "required":["CacheParameterGroupFamily"], - "members":{ - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cache parameter group family.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeEngineDefaultParameters operation.

" - }, - "DescribeEngineDefaultParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events are returned. If not specified, all sources are included in the response.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format.

Example: 2017-03-30T07:03:49.555Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format.

Example: 2017-03-30T07:03:49.555Z

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes worth of events to retrieve.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeEvents operation.

" - }, - "DescribeReplicationGroupsMessage":{ - "type":"structure", - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the replication group to be described. This parameter is not case sensitive.

If you do not specify this parameter, information about all replication groups is returned.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReplicationGroups operation.

" - }, - "DescribeReservedCacheNodesMessage":{ - "type":"structure", - "members":{ - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

The reserved cache node identifier filter value. Use this parameter to show only the reservation that matches the specified reservation ID.

" - }, - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Use this parameter to show only purchased reservations matching the specified offering identifier.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type filter value. Use this parameter to show only those reservations matching the specified cache node type.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

The duration filter value, specified in years or seconds. Use this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Use this parameter to show only those reservations matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type.

Valid values: \"Light Utilization\"|\"Medium Utilization\"|\"Heavy Utilization\"

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReservedCacheNodes operation.

" - }, - "DescribeReservedCacheNodesOfferingsMessage":{ - "type":"structure", - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type filter value. Use this parameter to show only the available offerings matching the specified cache node type.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

Duration filter value, specified in years or seconds. Use this parameter to show only reservations for a given duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Use this parameter to show only the available offerings matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Light Utilization\"|\"Medium Utilization\"|\"Heavy Utilization\"

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20; maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Represents the input of a DescribeReservedCacheNodesOfferings operation.

" - }, - "DescribeSnapshotsListMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

A list of snapshots. Each item in the list contains detailed information about one snapshot.

" - } - }, - "documentation":"

Represents the output of a DescribeSnapshots operation.

" - }, - "DescribeSnapshotsMessage":{ - "type":"structure", - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

A user-supplied replication group identifier. If this parameter is specified, only snapshots associated with that specific replication group are described.

" - }, - "CacheClusterId":{ - "shape":"String", - "documentation":"

A user-supplied cluster identifier. If this parameter is specified, only snapshots associated with that specific cluster are described.

" - }, - "SnapshotName":{ - "shape":"String", - "documentation":"

A user-supplied name of the snapshot. If this parameter is specified, only this snapshot are described.

" - }, - "SnapshotSource":{ - "shape":"String", - "documentation":"

If set to system, the output shows snapshots that were automatically created by ElastiCache. If set to user the output shows snapshots that were manually created. If omitted, the output shows both automatically and manually created snapshots.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Default: 50

Constraints: minimum 20; maximum 50.

" - }, - "ShowNodeGroupConfig":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value which if true, the node group (shard) configuration is included in the snapshot description.

" - } - }, - "documentation":"

Represents the input of a DescribeSnapshotsMessage operation.

" - }, - "Double":{"type":"double"}, - "EC2SecurityGroup":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the Amazon EC2 security group.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the Amazon EC2 security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account ID of the Amazon EC2 security group owner.

" - } - }, - "documentation":"

Provides ownership and status information for an Amazon EC2 security group.

" - }, - "EC2SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"EC2SecurityGroup", - "locationName":"EC2SecurityGroup" - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

The DNS hostname of the cache node.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port number that the cache engine is listening on.

" - } - }, - "documentation":"

Represents the information required for client programs to connect to a cache node.

" - }, - "EngineDefaults":{ - "type":"structure", - "members":{ - "CacheParameterGroupFamily":{ - "shape":"String", - "documentation":"

Specifies the name of the cache parameter group family to which the engine default parameters apply.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

" - }, - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Contains a list of engine default parameters.

" - }, - "CacheNodeTypeSpecificParameters":{ - "shape":"CacheNodeTypeSpecificParametersList", - "documentation":"

A list of parameters specific to a particular cache node type. Each element in the list contains detailed information about one parameter.

" - } - }, - "documentation":"

Represents the output of a DescribeEngineDefaultParameters operation.

", - "wrapper":true - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source of the event. For example, if the event occurred at the cluster level, the identifier would be the name of the cluster.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the origin of this event - a cluster, a parameter group, a security group, etc.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The text of the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

The date and time when the event occurred.

" - } - }, - "documentation":"

Represents a single occurrence of something interesting within the system. Some examples of events are creating a cluster, adding or removing a cache node, or rebooting a node.

" - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of events. Each element in the list contains detailed information about one event.

" - } - }, - "documentation":"

Represents the output of a DescribeEvents operation.

" - }, - "InsufficientCacheClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache node type is not available in the specified Availability Zone.

", - "error":{ - "code":"InsufficientCacheClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidARNFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested Amazon Resource Name (ARN) does not refer to an existing resource.

", - "error":{ - "code":"InvalidARN", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidCacheClusterStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cluster is not in the available state.

", - "error":{ - "code":"InvalidCacheClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidCacheParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The current state of the cache parameter group does not allow the requested operation to occur.

", - "error":{ - "code":"InvalidCacheParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidCacheSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The current state of the cache security group does not allow deletion.

", - "error":{ - "code":"InvalidCacheSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidParameterCombinationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

Two or more parameters that must not be used together were used together.

" - } - }, - "documentation":"

Two or more incompatible parameters were specified.

", - "error":{ - "code":"InvalidParameterCombination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"AwsQueryErrorMessage", - "documentation":"

A parameter value is invalid.

" - } - }, - "documentation":"

The value for a parameter is invalid.

", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidReplicationGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested replication group is not in the available state.

", - "error":{ - "code":"InvalidReplicationGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The current state of the snapshot does not allow the requested operation to occur.

", - "error":{ - "code":"InvalidSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "documentation":"

An invalid subnet identifier was specified.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The VPC network is in an invalid state.

", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListAllowedNodeTypeModificationsMessage":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The name of the cluster you want to scale up to a larger node instanced type. ElastiCache uses the cluster id to identify the current node type of this cluster and from that to create a list of node types you can scale up to.

You must provide a value for either the CacheClusterId or the ReplicationGroupId.

" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The name of the replication group want to scale up to a larger node type. ElastiCache uses the replication group id to identify the current node type being used by this replication group, and from that to create a list of node types you can scale up to.

You must provide a value for either the CacheClusterId or the ReplicationGroupId.

" - } - }, - "documentation":"

The input parameters for the ListAllowedNodeTypeModifications operation.

" - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceName"], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the resource for which you want the list of tags, for example arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster or arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - }, - "documentation":"

The input parameters for the ListTagsForResource operation.

" - }, - "ModifyCacheClusterMessage":{ - "type":"structure", - "required":["CacheClusterId"], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cluster identifier. This value is stored as a lowercase string.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes that the cluster should have. If the value for NumCacheNodes is greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which may be zero), more nodes are added. If the value is less than the number of existing cache nodes, nodes are removed. If the value is equal to the number of current cache nodes, any pending add or remove requests are canceled.

If you are removing cache nodes, you must use the CacheNodeIdsToRemove parameter to provide the IDs of the specific cache nodes to remove.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.

Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see ApplyImmediately).

A pending operation to modify the number of cache nodes in a cluster during its maintenance window, whether by adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest request to add or remove nodes to the cluster overrides any previous pending operations to modify the number of cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending operation to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending operation to remove 3 nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with flexible cache node placement, a request to add nodes does not automatically override a previous pending operation to add nodes. The customer can modify the previous pending operation to add more nodes or explicitly cancel the pending request and retry the new request. To cancel pending operations to modify the number of cache nodes in a cluster, use the ModifyCacheCluster request and set NumCacheNodes equal to the number of cache nodes currently in the cluster.

" - }, - "CacheNodeIdsToRemove":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is only valid when NumCacheNodes is less than the existing number of cache nodes. The number of cache node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of NumCacheNodes in the request.

For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this ModifyCacheCluster call is 5, you must list 2 (7 - 5) cache node IDs to remove.

" - }, - "AZMode":{ - "shape":"AZMode", - "documentation":"

Specifies whether the new nodes in this Memcached cluster are all created in a single Availability Zone or created across multiple Availability Zones.

Valid values: single-az | cross-az.

This option is only supported for Memcached clusters.

You cannot specify single-az if the Memcached cluster already has cache nodes in different Availability Zones. If cross-az is specified, existing Memcached nodes remain in their current Availability Zone.

Only newly created nodes are located in different Availability Zones. For instructions on how to move existing Memcached nodes to different Availability Zones, see the Availability Zone Considerations section of Cache Node Considerations for Memcached.

" - }, - "NewAvailabilityZones":{ - "shape":"PreferredAvailabilityZoneList", - "documentation":"

The list of Availability Zones where the new Memcached cache nodes are created.

This parameter is only valid when NumCacheNodes in the request is greater than the sum of the number of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of Availability Zones supplied in this list must match the cache nodes being added in this request.

This option is only supported on Memcached clusters.

Scenarios:

  • Scenario 1: You have 3 active nodes and wish to add 2 nodes. Specify NumCacheNodes=5 (3 + 2) and optionally specify two Availability Zones for the two new nodes.

  • Scenario 2: You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to add 1 more node. Specify NumCacheNodes=6 ((3 + 2) + 1) and optionally specify an Availability Zone for the new node.

  • Scenario 3: You want to cancel all pending operations. Specify NumCacheNodes=3 to cancel all pending operations.

The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes pending creation, add 0 nodes by setting NumCacheNodes to the number of current nodes.

If cross-az is specified, existing Memcached nodes remain in their current Availability Zone. Only newly created nodes can be located in different Availability Zones. For guidance on how to move existing Memcached nodes to different Availability Zones, see the Availability Zone Considerations section of Cache Node Considerations for Memcached.

Impact of new add/remove requests upon pending requests

  • Scenario-1

    • Pending Action: Delete

    • New Request: Delete

    • Result: The new delete, pending or immediate, replaces the pending delete.

  • Scenario-2

    • Pending Action: Delete

    • New Request: Create

    • Result: The new create, pending or immediate, replaces the pending delete.

  • Scenario-3

    • Pending Action: Create

    • New Request: Delete

    • Result: The new delete, pending or immediate, replaces the pending create.

  • Scenario-4

    • Pending Action: Create

    • New Request: Create

    • Result: The new create is added to the pending create.

      Important: If the new create request is Apply Immediately - Yes, all creates are performed immediately. If the new create request is Apply Immediately - No, all creates are pending.

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to authorize on this cluster. This change is asynchronously applied as soon as possible.

You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon VPC).

Constraints: Must contain no more than 255 alphanumeric characters. Must not be \"Default\".

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

Specifies the VPC Security Groups associated with the cluster.

This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.

The Amazon SNS topic owner must be same as the cluster owner.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to apply to this cluster. This change is asynchronously applied as soon as possible for parameters when the ApplyImmediately parameter is specified as true for this request.

" - }, - "NotificationTopicStatus":{ - "shape":"String", - "documentation":"

The status of the Amazon SNS notification topic. Notifications are sent only if the status is active.

Valid values: active | inactive

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

If true, this parameter causes the modifications in this request and any pending modifications to be applied, asynchronously and as soon as possible, regardless of the PreferredMaintenanceWindow setting for the cluster.

If false, changes to the cluster are applied on the next maintenance reboot, or the next failure reboot, whichever occurs first.

If you perform a ModifyCacheCluster before a pending modification is applied, the pending modification is replaced by the newer modification.

Valid values: true | false

Default: false

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The upgraded version of the cache engine to be run on the cache nodes.

Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cluster and create it anew with the earlier engine version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is currently disabled.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cluster.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

A valid cache node type that you want to scale this cluster up to.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheCluster operation.

" - }, - "ModifyCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "ModifyCacheParameterGroupMessage":{ - "type":"structure", - "required":[ - "CacheParameterGroupName", - "ParameterNameValues" - ], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to modify.

" - }, - "ParameterNameValues":{ - "shape":"ParameterNameValueList", - "documentation":"

An array of parameter names and values for the parameter update. You must supply at least one parameter name and value; subsequent arguments are optional. A maximum of 20 parameters may be modified per request.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheParameterGroup operation.

" - }, - "ModifyCacheSubnetGroupMessage":{ - "type":"structure", - "required":["CacheSubnetGroupName"], - "members":{ - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the cache subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

Example: mysubnetgroup

" - }, - "CacheSubnetGroupDescription":{ - "shape":"String", - "documentation":"

A description of the cache subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the cache subnet group.

" - } - }, - "documentation":"

Represents the input of a ModifyCacheSubnetGroup operation.

" - }, - "ModifyCacheSubnetGroupResult":{ - "type":"structure", - "members":{ - "CacheSubnetGroup":{"shape":"CacheSubnetGroup"} - } - }, - "ModifyReplicationGroupMessage":{ - "type":"structure", - "required":["ReplicationGroupId"], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier of the replication group to modify.

" - }, - "ReplicationGroupDescription":{ - "shape":"String", - "documentation":"

A description for the replication group. Maximum length is 255 characters.

" - }, - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

For replication groups with a single primary, if this parameter is specified, ElastiCache promotes the specified cluster in the specified replication group to the primary role. The nodes of all other clusters in the replication group are read replicas.

" - }, - "SnapshottingClusterId":{ - "shape":"String", - "documentation":"

The cluster ID that is used as the daily snapshot source for the replication group. This parameter cannot be set for Redis (cluster mode enabled) replication groups.

" - }, - "AutomaticFailoverEnabled":{ - "shape":"BooleanOptional", - "documentation":"

Determines whether a read replica is automatically promoted to read/write primary if the existing primary encounters a failure.

Valid values: true | false

Amazon ElastiCache for Redis does not support Multi-AZ with automatic failover on:

  • Redis versions earlier than 2.8.6.

  • Redis (cluster mode disabled): T1 and T2 cache node types.

  • Redis (cluster mode enabled): T1 node types.

" - }, - "CacheSecurityGroupNames":{ - "shape":"CacheSecurityGroupNameList", - "documentation":"

A list of cache security group names to authorize for the clusters in this replication group. This change is asynchronously applied as soon as possible.

This parameter can be used only with replication group containing clusters running outside of an Amazon Virtual Private Cloud (Amazon VPC).

Constraints: Must contain no more than 255 alphanumeric characters. Must not be Default.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIdsList", - "documentation":"

Specifies the VPC Security Groups associated with the clusters in the replication group.

This parameter can be used only with replication group containing clusters running in an Amazon Virtual Private Cloud (Amazon VPC).

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "NotificationTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.

The Amazon SNS topic owner must be same as the replication group owner.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to apply to all of the clusters in this replication group. This change is asynchronously applied as soon as possible for parameters when the ApplyImmediately parameter is specified as true for this request.

" - }, - "NotificationTopicStatus":{ - "shape":"String", - "documentation":"

The status of the Amazon SNS notification topic for the replication group. Notifications are sent only if the status is active.

Valid values: active | inactive

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

If true, this parameter causes the modifications in this request and any pending modifications to be applied, asynchronously and as soon as possible, regardless of the PreferredMaintenanceWindow setting for the replication group.

If false, changes to the nodes in the replication group are applied on the next maintenance reboot, or the next failure reboot, whichever occurs first.

Valid values: true | false

Default: false

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The upgraded version of the cache engine to be run on the clusters in the replication group.

Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing replication group and create it anew with the earlier engine version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is currently disabled.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic node group (shard) snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

Important If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of the node group (shard) specified by SnapshottingClusterId.

Example: 05:00-09:00

If you do not specify this parameter, ElastiCache automatically chooses an appropriate time range.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

A valid cache node type that you want to scale this replication group to.

" - }, - "NodeGroupId":{ - "shape":"String", - "documentation":"

The name of the Node Group (called shard in the console).

" - } - }, - "documentation":"

Represents the input of a ModifyReplicationGroups operation.

" - }, - "ModifyReplicationGroupResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "ModifyReplicationGroupShardConfigurationMessage":{ - "type":"structure", - "required":[ - "ReplicationGroupId", - "NodeGroupCount", - "ApplyImmediately" - ], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The name of the Redis (cluster mode enabled) cluster (replication group) on which the shards are to be configured.

" - }, - "NodeGroupCount":{ - "shape":"Integer", - "documentation":"

The number of node groups (shards) that results from the modification of the shard configuration.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Indicates that the shard reconfiguration process begins immediately. At present, the only permitted value for this parameter is true.

Value: true

" - }, - "ReshardingConfiguration":{ - "shape":"ReshardingConfigurationList", - "documentation":"

Specifies the preferred availability zones for each node group in the cluster. If the value of NodeGroupCount is greater than the current number of node groups (shards), you can use this parameter to specify the preferred availability zones of the cluster's shards. If you omit this parameter ElastiCache selects availability zones for you.

You can specify this parameter only if the value of NodeGroupCount is greater than the current number of node groups (shards).

" - }, - "NodeGroupsToRemove":{ - "shape":"NodeGroupsToRemoveList", - "documentation":"

If the value of NodeGroupCount is less than the current number of node groups (shards), NodeGroupsToRemove is a required list of node group ids to remove from the cluster.

" - } - }, - "documentation":"

Represents the input for a ModifyReplicationGroupShardConfiguration operation.

" - }, - "ModifyReplicationGroupShardConfigurationResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - }, - "NodeGroup":{ - "type":"structure", - "members":{ - "NodeGroupId":{ - "shape":"String", - "documentation":"

The identifier for the node group (shard). A Redis (cluster mode disabled) replication group contains only 1 node group; therefore, the node group ID is 0001. A Redis (cluster mode enabled) replication group contains 1 to 15 node groups numbered 0001 to 0015.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The current state of this replication group - creating, available, etc.

" - }, - "PrimaryEndpoint":{ - "shape":"Endpoint", - "documentation":"

The endpoint of the primary node in this node group (shard).

" - }, - "Slots":{ - "shape":"String", - "documentation":"

The keyspace for this node group (shard).

" - }, - "NodeGroupMembers":{ - "shape":"NodeGroupMemberList", - "documentation":"

A list containing information about individual nodes within the node group (shard).

" - } - }, - "documentation":"

Represents a collection of cache nodes in a replication group. One node in the node group is the read/write primary node. All the other nodes are read-only Replica nodes.

" - }, - "NodeGroupConfiguration":{ - "type":"structure", - "members":{ - "Slots":{ - "shape":"String", - "documentation":"

A string that specifies the keyspace for a particular node group. Keyspaces range from 0 to 16,383. The string is in the format startkey-endkey.

Example: \"0-3999\"

" - }, - "ReplicaCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of read replica nodes in this node group (shard).

" - }, - "PrimaryAvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone where the primary node of this node group (shard) is launched.

" - }, - "ReplicaAvailabilityZones":{ - "shape":"AvailabilityZonesList", - "documentation":"

A list of Availability Zones to be used for the read replicas. The number of Availability Zones in this list must match the value of ReplicaCount or ReplicasPerNodeGroup if not specified.

" - } - }, - "documentation":"

Node group (shard) configuration options. Each node group (shard) configuration has the following: Slots, PrimaryAvailabilityZone, ReplicaAvailabilityZones, ReplicaCount.

" - }, - "NodeGroupConfigurationList":{ - "type":"list", - "member":{ - "shape":"NodeGroupConfiguration", - "locationName":"NodeGroupConfiguration" - } - }, - "NodeGroupList":{ - "type":"list", - "member":{ - "shape":"NodeGroup", - "locationName":"NodeGroup" - } - }, - "NodeGroupMember":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The ID of the cluster to which the node belongs.

" - }, - "CacheNodeId":{ - "shape":"String", - "documentation":"

The ID of the node within its cluster. A node ID is a numeric identifier (0001, 0002, etc.).

" - }, - "ReadEndpoint":{"shape":"Endpoint"}, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the node is located.

" - }, - "CurrentRole":{ - "shape":"String", - "documentation":"

The role that is currently assigned to the node - primary or replica.

" - } - }, - "documentation":"

Represents a single node within a node group (shard).

" - }, - "NodeGroupMemberList":{ - "type":"list", - "member":{ - "shape":"NodeGroupMember", - "locationName":"NodeGroupMember" - } - }, - "NodeGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The node group specified by the NodeGroupId parameter could not be found. Please verify that the node group exists and that you spelled the NodeGroupId value correctly.

", - "error":{ - "code":"NodeGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "NodeGroupsPerReplicationGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the maximum allowed number of node groups (shards) in a single replication group. The default maximum is 15

", - "error":{ - "code":"NodeGroupsPerReplicationGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NodeGroupsToRemoveList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"NodeGroupToRemove" - } - }, - "NodeQuotaForClusterExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes in a single cluster.

", - "error":{ - "code":"NodeQuotaForClusterExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NodeQuotaForCustomerExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the allowed number of cache nodes per customer.

", - "error":{ - "code":"NodeQuotaForCustomerExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NodeSnapshot":{ - "type":"structure", - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

A unique identifier for the source cluster.

" - }, - "NodeGroupId":{ - "shape":"String", - "documentation":"

A unique identifier for the source node group (shard).

" - }, - "CacheNodeId":{ - "shape":"String", - "documentation":"

The cache node identifier for the node in the source cluster.

" - }, - "NodeGroupConfiguration":{ - "shape":"NodeGroupConfiguration", - "documentation":"

The configuration for the source node group (shard).

" - }, - "CacheSize":{ - "shape":"String", - "documentation":"

The size of the cache on the source cache node.

" - }, - "CacheNodeCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the cache node was created in the source cluster.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the source node's metadata and cache data set was obtained for the snapshot.

" - } - }, - "documentation":"

Represents an individual cache node in a snapshot of a cluster.

", - "wrapper":true - }, - "NodeSnapshotList":{ - "type":"list", - "member":{ - "shape":"NodeSnapshot", - "locationName":"NodeSnapshot" - } - }, - "NodeTypeList":{ - "type":"list", - "member":{"shape":"String"} - }, - "NotificationConfiguration":{ - "type":"structure", - "members":{ - "TopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) that identifies the topic.

" - }, - "TopicStatus":{ - "shape":"String", - "documentation":"

The current state of the topic.

" - } - }, - "documentation":"

Describes a notification topic and its status. Notification topics are used for publishing ElastiCache events to subscribers using Amazon Simple Notification Service (SNS).

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the parameter.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest cache engine version to which the parameter can apply.

" - }, - "ChangeType":{ - "shape":"ChangeType", - "documentation":"

Indicates whether a change to the parameter is applied immediately or requires a reboot for the change to be applied. You can force a reboot or wait until the next maintenance window's reboot. For more information, see Rebooting a Cluster.

" - } - }, - "documentation":"

Describes an individual setting that controls some aspect of ElastiCache behavior.

" - }, - "ParameterNameValue":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - } - }, - "documentation":"

Describes a name-value pair that is used to update the value of a parameter.

" - }, - "ParameterNameValueList":{ - "type":"list", - "member":{ - "shape":"ParameterNameValue", - "locationName":"ParameterNameValue" - } - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingAutomaticFailoverStatus":{ - "type":"string", - "enum":[ - "enabled", - "disabled" - ] - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The new number of cache nodes for the cluster.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.

" - }, - "CacheNodeIdsToRemove":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs that are being removed (or will be removed) from the cluster. A node ID is a numeric identifier (0001, 0002, etc.).

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The new cache engine version that the cluster runs.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type that this cluster or replication group is scaled to.

" - } - }, - "documentation":"

A group of settings that are applied to the cluster in the future, or that are currently being applied.

" - }, - "PreferredAvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"PreferredAvailabilityZone" - } - }, - "PurchaseReservedCacheNodesOfferingMessage":{ - "type":"structure", - "required":["ReservedCacheNodesOfferingId"], - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the reserved cache node offering to purchase.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

A customer-specified identifier to track this reservation.

The Reserved Cache Node ID is an unique customer-specified identifier to track this reservation. If this parameter is not specified, ElastiCache automatically generates an identifier for the reservation.

Example: myreservationID

" - }, - "CacheNodeCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache node instances to reserve.

Default: 1

" - } - }, - "documentation":"

Represents the input of a PurchaseReservedCacheNodesOffering operation.

" - }, - "PurchaseReservedCacheNodesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedCacheNode":{"shape":"ReservedCacheNode"} - } - }, - "RebootCacheClusterMessage":{ - "type":"structure", - "required":[ - "CacheClusterId", - "CacheNodeIdsToReboot" - ], - "members":{ - "CacheClusterId":{ - "shape":"String", - "documentation":"

The cluster identifier. This parameter is stored as a lowercase string.

" - }, - "CacheNodeIdsToReboot":{ - "shape":"CacheNodeIdsList", - "documentation":"

A list of cache node IDs to reboot. A node ID is a numeric identifier (0001, 0002, etc.). To reboot an entire cluster, specify all of the cache node IDs.

" - } - }, - "documentation":"

Represents the input of a RebootCacheCluster operation.

" - }, - "RebootCacheClusterResult":{ - "type":"structure", - "members":{ - "CacheCluster":{"shape":"CacheCluster"} - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The monetary amount of the recurring charge.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency of the recurring charge.

" - } - }, - "documentation":"

Contains the specific price and frequency of a recurring charges for a reserved cache node, or for a reserved cache node offering.

", - "wrapper":true - }, - "RecurringChargeList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"RecurringCharge" - } - }, - "RemoveTagsFromResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the resource from which you want the tags removed, for example arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster or arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

A list of TagKeys identifying the tags you want removed from the named resource.

" - } - }, - "documentation":"

Represents the input of a RemoveTagsFromResource operation.

" - }, - "ReplicationGroup":{ - "type":"structure", - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The identifier for the replication group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The user supplied description of the replication group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The current state of this replication group - creating, available, modifying, deleting, create-failed, snapshotting.

" - }, - "PendingModifiedValues":{ - "shape":"ReplicationGroupPendingModifiedValues", - "documentation":"

A group of settings to be applied to the replication group, either immediately or during the next maintenance window.

" - }, - "MemberClusters":{ - "shape":"ClusterIdList", - "documentation":"

The identifiers of all the nodes that are part of this replication group.

" - }, - "NodeGroups":{ - "shape":"NodeGroupList", - "documentation":"

A list of node groups in this replication group. For Redis (cluster mode disabled) replication groups, this is a single-element list. For Redis (cluster mode enabled) replication groups, the list contains an entry for each node group (shard).

" - }, - "SnapshottingClusterId":{ - "shape":"String", - "documentation":"

The cluster ID that is used as the daily snapshot source for the replication group.

" - }, - "AutomaticFailover":{ - "shape":"AutomaticFailoverStatus", - "documentation":"

Indicates the status of Multi-AZ with automatic failover for this Redis replication group.

Amazon ElastiCache for Redis does not support Multi-AZ with automatic failover on:

  • Redis versions earlier than 2.8.6.

  • Redis (cluster mode disabled): T1 and T2 cache node types.

  • Redis (cluster mode enabled): T1 node types.

" - }, - "ConfigurationEndpoint":{ - "shape":"Endpoint", - "documentation":"

The configuration endpoint for this replication group. Use the configuration endpoint to connect to this replication group.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which ElastiCache retains automatic cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.

If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).

Example: 05:00-09:00

If you do not specify this parameter, ElastiCache automatically chooses an appropriate time range.

This parameter is only valid if the Engine parameter is redis.

" - }, - "ClusterEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag indicating whether or not this replication group is cluster enabled; i.e., whether its data can be partitioned across multiple shards (API/CLI: node groups).

Valid values: true | false

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The name of the compute and memory capacity node type for each node in the replication group.

" - }, - "AuthTokenEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables using an AuthToken (password) when issuing Redis commands.

Default: false

" - }, - "TransitEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables in-transit encryption when set to true.

You cannot modify the value of TransitEncryptionEnabled after the cluster is created. To enable in-transit encryption on a cluster you must set TransitEncryptionEnabled to true when you create a cluster.

Default: false

" - }, - "AtRestEncryptionEnabled":{ - "shape":"BooleanOptional", - "documentation":"

A flag that enables encryption at-rest when set to true.

You cannot modify the value of AtRestEncryptionEnabled after the cluster is created. To enable encryption at-rest on a cluster you must set AtRestEncryptionEnabled to true when you create a cluster.

Default: false

" - } - }, - "documentation":"

Contains all of the attributes of a specific Redis replication group.

", - "wrapper":true - }, - "ReplicationGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified replication group already exists.

", - "error":{ - "code":"ReplicationGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ReplicationGroupList":{ - "type":"list", - "member":{ - "shape":"ReplicationGroup", - "locationName":"ReplicationGroup" - } - }, - "ReplicationGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReplicationGroups":{ - "shape":"ReplicationGroupList", - "documentation":"

A list of replication groups. Each item in the list contains detailed information about one replication group.

" - } - }, - "documentation":"

Represents the output of a DescribeReplicationGroups operation.

" - }, - "ReplicationGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified replication group does not exist.

", - "error":{ - "code":"ReplicationGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReplicationGroupPendingModifiedValues":{ - "type":"structure", - "members":{ - "PrimaryClusterId":{ - "shape":"String", - "documentation":"

The primary cluster ID that is applied immediately (if --apply-immediately was specified), or during the next maintenance window.

" - }, - "AutomaticFailoverStatus":{ - "shape":"PendingAutomaticFailoverStatus", - "documentation":"

Indicates the status of Multi-AZ with automatic failover for this Redis replication group.

Amazon ElastiCache for Redis does not support Multi-AZ with automatic failover on:

  • Redis versions earlier than 2.8.6.

  • Redis (cluster mode disabled): T1 and T2 cache node types.

  • Redis (cluster mode enabled): T1 node types.

" - }, - "Resharding":{ - "shape":"ReshardingStatus", - "documentation":"

The status of an online resharding operation.

" - } - }, - "documentation":"

The settings to be applied to the Redis replication group, either immediately or during the next maintenance window.

" - }, - "ReservedCacheNode":{ - "type":"structure", - "members":{ - "ReservedCacheNodeId":{ - "shape":"String", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for the reserved cache nodes.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The time the reservation started.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this reserved cache node.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this reserved cache node.

" - }, - "CacheNodeCount":{ - "shape":"Integer", - "documentation":"

The number of cache nodes that have been reserved.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The description of the reserved cache node.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type of this reserved cache node.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved cache node.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved cache node.

" - } - }, - "documentation":"

Represents the output of a PurchaseReservedCacheNodesOffering operation.

", - "wrapper":true - }, - "ReservedCacheNodeAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You already have a reservation with the given identifier.

", - "error":{ - "code":"ReservedCacheNodeAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedCacheNodeList":{ - "type":"list", - "member":{ - "shape":"ReservedCacheNode", - "locationName":"ReservedCacheNode" - } - }, - "ReservedCacheNodeMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedCacheNodes":{ - "shape":"ReservedCacheNodeList", - "documentation":"

A list of reserved cache nodes. Each element in the list contains detailed information about one node.

" - } - }, - "documentation":"

Represents the output of a DescribeReservedCacheNodes operation.

" - }, - "ReservedCacheNodeNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested reserved cache node was not found.

", - "error":{ - "code":"ReservedCacheNodeNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedCacheNodeQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the user's cache node quota.

", - "error":{ - "code":"ReservedCacheNodeQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ReservedCacheNodesOffering":{ - "type":"structure", - "members":{ - "ReservedCacheNodesOfferingId":{ - "shape":"String", - "documentation":"

A unique identifier for the reserved cache node offering.

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The cache node type for the reserved cache node.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering. in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this offering.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The cache engine used by the offering.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved cache node.

" - } - }, - "documentation":"

Describes all of the attributes of a reserved cache node offering.

", - "wrapper":true - }, - "ReservedCacheNodesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedCacheNodesOffering", - "locationName":"ReservedCacheNodesOffering" - } - }, - "ReservedCacheNodesOfferingMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedCacheNodesOfferings":{ - "shape":"ReservedCacheNodesOfferingList", - "documentation":"

A list of reserved cache node offerings. Each element in the list contains detailed information about one offering.

" - } - }, - "documentation":"

Represents the output of a DescribeReservedCacheNodesOfferings operation.

" - }, - "ReservedCacheNodesOfferingNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested cache node offering does not exist.

", - "error":{ - "code":"ReservedCacheNodesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ResetCacheParameterGroupMessage":{ - "type":"structure", - "required":["CacheParameterGroupName"], - "members":{ - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cache parameter group to reset.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

If true, all parameters in the cache parameter group are reset to their default values. If false, only the parameters listed by ParameterNameValues are reset to their default values.

Valid values: true | false

" - }, - "ParameterNameValues":{ - "shape":"ParameterNameValueList", - "documentation":"

An array of parameter names to reset to their default values. If ResetAllParameters is true, do not use ParameterNameValues. If ResetAllParameters is false, you must specify the name of at least one parameter to reset.

" - } - }, - "documentation":"

Represents the input of a ResetCacheParameterGroup operation.

" - }, - "ReshardingConfiguration":{ - "type":"structure", - "members":{ - "PreferredAvailabilityZones":{ - "shape":"AvailabilityZonesList", - "documentation":"

A list of preferred availability zones for the nodes in this cluster.

" - } - }, - "documentation":"

A list of PreferredAvailabilityZones objects that specifies the configuration of a node group in the resharded cluster.

" - }, - "ReshardingConfigurationList":{ - "type":"list", - "member":{ - "shape":"ReshardingConfiguration", - "locationName":"ReshardingConfiguration" - } - }, - "ReshardingStatus":{ - "type":"structure", - "members":{ - "SlotMigration":{ - "shape":"SlotMigration", - "documentation":"

Represents the progress of an online resharding operation.

" - } - }, - "documentation":"

The status of an online resharding operation.

" - }, - "RevokeCacheSecurityGroupIngressMessage":{ - "type":"structure", - "required":[ - "CacheSecurityGroupName", - "EC2SecurityGroupName", - "EC2SecurityGroupOwnerId" - ], - "members":{ - "CacheSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cache security group to revoke ingress from.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the Amazon EC2 security group to revoke access from.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the Amazon EC2 security group owner. Note that this is not the same thing as an AWS access key ID - you must provide a valid AWS account number for this parameter.

" - } - }, - "documentation":"

Represents the input of a RevokeCacheSecurityGroupIngress operation.

" - }, - "RevokeCacheSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "CacheSecurityGroup":{"shape":"CacheSecurityGroup"} - } - }, - "SecurityGroupIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SecurityGroupId" - } - }, - "SecurityGroupMembership":{ - "type":"structure", - "members":{ - "SecurityGroupId":{ - "shape":"String", - "documentation":"

The identifier of the cache security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the cache security group membership. The status changes whenever a cache security group is modified, or when the cache security groups assigned to a cluster are modified.

" - } - }, - "documentation":"

Represents a single cache security group and its status.

" - }, - "SecurityGroupMembershipList":{ - "type":"list", - "member":{"shape":"SecurityGroupMembership"} - }, - "SlotMigration":{ - "type":"structure", - "members":{ - "ProgressPercentage":{ - "shape":"Double", - "documentation":"

The percentage of the slot migration that is complete.

" - } - }, - "documentation":"

Represents the progress of an online resharding operation.

" - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotName":{ - "shape":"String", - "documentation":"

The name of a snapshot. For an automatic snapshot, the name is system-generated. For a manual snapshot, this is the user-provided name.

" - }, - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The unique identifier of the source replication group.

" - }, - "ReplicationGroupDescription":{ - "shape":"String", - "documentation":"

A description of the source replication group.

" - }, - "CacheClusterId":{ - "shape":"String", - "documentation":"

The user-supplied identifier of the source cluster.

" - }, - "SnapshotStatus":{ - "shape":"String", - "documentation":"

The status of the snapshot. Valid values: creating | available | restoring | copying | deleting.

" - }, - "SnapshotSource":{ - "shape":"String", - "documentation":"

Indicates whether the snapshot is from an automatic backup (automated) or was created manually (manual).

" - }, - "CacheNodeType":{ - "shape":"String", - "documentation":"

The name of the compute and memory capacity node type for the source cluster.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      T2 node types: cache.t2.micro, cache.t2.small, cache.t2.medium

      M3 node types: cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

      M4 node types: cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

    • Previous generation: (not recommended)

      T1 node types: cache.t1.micro

      M1 node types: cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

  • Compute optimized:

    • Previous generation: (not recommended)

      C1 node types: cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R3 node types: cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

    • Previous generation: (not recommended)

      M2 node types: cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

Notes:

  • All T2 instances are created in an Amazon Virtual Private Cloud (Amazon VPC).

  • Redis (cluster mode disabled): Redis backup/restore is not supported on T1 and T2 instances.

  • Redis (cluster mode enabled): Backup/restore is not supported on T1 instances.

  • Redis Append-only files (AOF) functionality is not supported for T1 or T2 instances.

For a complete listing of node types and specifications, see Amazon ElastiCache Product Features and Details and either Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the cache engine (memcached or redis) used by the source cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the cache engine version that is used by the source cluster.

" - }, - "NumCacheNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of cache nodes in the source cluster.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.

" - }, - "PreferredAvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the source cluster is located.

" - }, - "CacheClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time when the source cluster was created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

" - }, - "TopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the topic used by the source cluster for publishing notifications.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number used by each cache nodes in the source cluster.

" - }, - "CacheParameterGroupName":{ - "shape":"String", - "documentation":"

The cache parameter group that is associated with the source cluster.

" - }, - "CacheSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cache subnet group associated with the source cluster.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group for the source cluster.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

This parameter is currently disabled.

" - }, - "SnapshotRetentionLimit":{ - "shape":"IntegerOptional", - "documentation":"

For an automatic snapshot, the number of days for which ElastiCache retains the snapshot before deleting it.

For manual snapshots, this field reflects the SnapshotRetentionLimit for the source cluster when the snapshot was created. This field is otherwise ignored: Manual snapshots do not expire, and can only be deleted using the DeleteSnapshot operation.

Important If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

" - }, - "SnapshotWindow":{ - "shape":"String", - "documentation":"

The daily time range during which ElastiCache takes daily snapshots of the source cluster.

" - }, - "NumNodeGroups":{ - "shape":"IntegerOptional", - "documentation":"

The number of node groups (shards) in this snapshot. When restoring from a snapshot, the number of node groups (shards) in the snapshot and in the restored replication group must be the same.

" - }, - "AutomaticFailover":{ - "shape":"AutomaticFailoverStatus", - "documentation":"

Indicates the status of Multi-AZ with automatic failover for the source Redis replication group.

Amazon ElastiCache for Redis does not support Multi-AZ with automatic failover on:

  • Redis versions earlier than 2.8.6.

  • Redis (cluster mode disabled): T1 and T2 cache node types.

  • Redis (cluster mode enabled): T1 node types.

" - }, - "NodeSnapshots":{ - "shape":"NodeSnapshotList", - "documentation":"

A list of the cache nodes in the source cluster.

" - } - }, - "documentation":"

Represents a copy of an entire Redis cluster as of the time when the snapshot was taken.

", - "wrapper":true - }, - "SnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You already have a snapshot with the given name.

", - "error":{ - "code":"SnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotArnsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SnapshotArn" - } - }, - "SnapshotFeatureNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You attempted one of the following operations:

  • Creating a snapshot of a Redis cluster running on a cache.t1.micro cache node.

  • Creating a snapshot of a cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

", - "error":{ - "code":"SnapshotFeatureNotSupportedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"Snapshot" - } - }, - "SnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested snapshot name does not refer to an existing snapshot.

", - "error":{ - "code":"SnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would exceed the maximum number of snapshots.

", - "error":{ - "code":"SnapshotQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SourceType":{ - "type":"string", - "enum":[ - "cache-cluster", - "cache-parameter-group", - "cache-security-group", - "cache-subnet-group", - "replication-group" - ] - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier for the subnet.

" - }, - "SubnetAvailabilityZone":{ - "shape":"AvailabilityZone", - "documentation":"

The Availability Zone associated with the subnet.

" - } - }, - "documentation":"

Represents the subnet associated with a cluster. This parameter refers to subnets defined in Amazon Virtual Private Cloud (Amazon VPC) and used with ElastiCache.

" - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet is being used by another cache subnet group.

", - "error":{ - "code":"SubnetInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key for the tag. May not be null.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The tag's value. May be null.

" - } - }, - "documentation":"

A cost allocation Tag that can be added to an ElastiCache cluster or replication group. Tags are composed of a Key/Value pair. A tag with a null Value is permitted.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagListMessage":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

A list of cost allocation tags as key-value pairs.

" - } - }, - "documentation":"

Represents the output from the AddTagsToResource, ListTagsForResource, and RemoveTagsFromResource operations.

" - }, - "TagNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested tag was not found on this resource.

", - "error":{ - "code":"TagNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "TagQuotaPerResourceExceeded":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be processed because it would cause the resource to have more than the allowed number of tags. The maximum number of tags permitted on a resource is 50.

", - "error":{ - "code":"TagQuotaPerResourceExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TestFailoverMessage":{ - "type":"structure", - "required":[ - "ReplicationGroupId", - "NodeGroupId" - ], - "members":{ - "ReplicationGroupId":{ - "shape":"String", - "documentation":"

The name of the replication group (console: cluster) whose automatic failover is being tested by this operation.

" - }, - "NodeGroupId":{ - "shape":"String", - "documentation":"

The name of the node group (called shard in the console) in this replication group on which automatic failover is to be tested. You may test automatic failover on up to 5 node groups in any rolling 24-hour period.

" - } - } - }, - "TestFailoverNotAvailableFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"TestFailoverNotAvailableFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TestFailoverResult":{ - "type":"structure", - "members":{ - "ReplicationGroup":{"shape":"ReplicationGroup"} - } - } - }, - "documentation":"Amazon ElastiCache

Amazon ElastiCache is a web service that makes it easier to set up, operate, and scale a distributed cache in the cloud.

With ElastiCache, customers get all of the benefits of a high-performance, in-memory cache with less of the administrative burden involved in launching and managing a distributed cache. The service makes setup, scaling, and cluster failure handling much simpler than in a self-managed cache deployment.

In addition, through integration with Amazon CloudWatch, customers get enhanced visibility into the key performance statistics associated with their cache and can receive alarms if a part of their cache runs hot.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/waiters-2.json deleted file mode 100644 index c177d7b9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticache/2015-02-02/waiters-2.json +++ /dev/null @@ -1,143 +0,0 @@ -{ - "version":2, - "waiters":{ - "CacheClusterAvailable":{ - "acceptors":[ - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"available", - "matcher":"pathAll", - "state":"success" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"deleted", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"deleting", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"incompatible-network", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"restore-failed", - "matcher":"pathAny", - "state":"failure" - } - ], - "delay":15, - "description":"Wait until ElastiCache cluster is available.", - "maxAttempts":40, - "operation":"DescribeCacheClusters" - }, - "CacheClusterDeleted":{ - "acceptors":[ - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"deleted", - "matcher":"pathAll", - "state":"success" - }, - { - "expected":"CacheClusterNotFound", - "matcher":"error", - "state":"success" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"available", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"creating", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"incompatible-network", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"modifying", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"restore-failed", - "matcher":"pathAny", - "state":"failure" - }, - { - "argument":"CacheClusters[].CacheClusterStatus", - "expected":"snapshotting", - "matcher":"pathAny", - "state":"failure" - } - ], - "delay":15, - "description":"Wait until ElastiCache cluster is deleted.", - "maxAttempts":40, - "operation":"DescribeCacheClusters" - }, - "ReplicationGroupAvailable":{ - "acceptors":[ - { - "argument":"ReplicationGroups[].Status", - "expected":"available", - "matcher":"pathAll", - "state":"success" - }, - { - "argument":"ReplicationGroups[].Status", - "expected":"deleted", - "matcher":"pathAny", - "state":"failure" - } - ], - "delay":15, - "description":"Wait until ElastiCache replication group is available.", - "maxAttempts":40, - "operation":"DescribeReplicationGroups" - }, - "ReplicationGroupDeleted":{ - "acceptors":[ - { - "argument":"ReplicationGroups[].Status", - "expected":"deleted", - "matcher":"pathAll", - "state":"success" - }, - { - "argument":"ReplicationGroups[].Status", - "expected":"available", - "matcher":"pathAny", - "state":"failure" - }, - { - "expected":"ReplicationGroupNotFoundFault", - "matcher":"error", - "state":"success" - } - ], - "delay":15, - "description":"Wait until ElastiCache replication group is deleted.", - "maxAttempts":40, - "operation":"DescribeReplicationGroups" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/examples-1.json deleted file mode 100644 index 0fded628..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/examples-1.json +++ /dev/null @@ -1,1109 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AbortEnvironmentUpdate": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following code aborts a running application version deployment for an environment named my-env:", - "id": "to-abort-a-deployment-1456267848227", - "title": "To abort a deployment" - } - ], - "CheckDNSAvailability": [ - { - "input": { - "CNAMEPrefix": "my-cname" - }, - "output": { - "Available": true, - "FullyQualifiedCNAME": "my-cname.us-west-2.elasticbeanstalk.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation checks the availability of the subdomain my-cname:", - "id": "to-check-the-availability-of-a-cname-1456268589537", - "title": "To check the availability of a CNAME" - } - ], - "CreateApplication": [ - { - "input": { - "ApplicationName": "my-app", - "Description": "my application" - }, - "output": { - "Application": { - "ApplicationName": "my-app", - "ConfigurationTemplates": [ - - ], - "DateCreated": "2015-02-12T18:32:21.181Z", - "DateUpdated": "2015-02-12T18:32:21.181Z", - "Description": "my application" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates a new application named my-app:", - "id": "to-create-a-new-application-1456268895683", - "title": "To create a new application" - } - ], - "CreateApplicationVersion": [ - { - "input": { - "ApplicationName": "my-app", - "AutoCreateApplication": true, - "Description": "my-app-v1", - "Process": true, - "SourceBundle": { - "S3Bucket": "my-bucket", - "S3Key": "sample.war" - }, - "VersionLabel": "v1" - }, - "output": { - "ApplicationVersion": { - "ApplicationName": "my-app", - "DateCreated": "2015-02-03T23:01:25.412Z", - "DateUpdated": "2015-02-03T23:01:25.412Z", - "Description": "my-app-v1", - "SourceBundle": { - "S3Bucket": "my-bucket", - "S3Key": "sample.war" - }, - "VersionLabel": "v1" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates a new version (v1) of an application named my-app:", - "id": "to-create-a-new-application-1456268895683", - "title": "To create a new application" - } - ], - "CreateConfigurationTemplate": [ - { - "input": { - "ApplicationName": "my-app", - "EnvironmentId": "e-rpqsewtp2j", - "TemplateName": "my-app-v1" - }, - "output": { - "ApplicationName": "my-app", - "DateCreated": "2015-08-12T18:40:39Z", - "DateUpdated": "2015-08-12T18:40:39Z", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "TemplateName": "my-app-v1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates a configuration template named my-app-v1 from the settings applied to an environment with the id e-rpqsewtp2j:", - "id": "to-create-a-configuration-template-1456269283586", - "title": "To create a configuration template" - } - ], - "CreateEnvironment": [ - { - "input": { - "ApplicationName": "my-app", - "CNAMEPrefix": "my-app", - "EnvironmentName": "my-env", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "VersionLabel": "v1" - }, - "output": { - "ApplicationName": "my-app", - "CNAME": "my-app.elasticbeanstalk.com", - "DateCreated": "2015-02-03T23:04:54.479Z", - "DateUpdated": "2015-02-03T23:04:54.479Z", - "EnvironmentId": "e-izqpassy4h", - "EnvironmentName": "my-env", - "Health": "Grey", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "Status": "Launching", - "Tier": { - "Name": "WebServer", - "Type": "Standard", - "Version": " " - }, - "VersionLabel": "v1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates a new environment for version v1 of a java application named my-app:", - "id": "to-create-a-new-environment-for-an-application-1456269380396", - "title": "To create a new environment for an application" - } - ], - "CreateStorageLocation": [ - { - "output": { - "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates a new environment for version v1 of a java application named my-app:", - "id": "to-create-a-new-environment-for-an-application-1456269380396", - "title": "To create a new environment for an application" - } - ], - "DeleteApplication": [ - { - "input": { - "ApplicationName": "my-app" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation deletes an application named my-app:", - "id": "to-delete-an-application-1456269699366", - "title": "To delete an application" - } - ], - "DeleteApplicationVersion": [ - { - "input": { - "ApplicationName": "my-app", - "DeleteSourceBundle": true, - "VersionLabel": "22a0-stage-150819_182129" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation deletes an application version named 22a0-stage-150819_182129 for an application named my-app:", - "id": "to-delete-an-application-version-1456269792956", - "title": "To delete an application version" - } - ], - "DeleteConfigurationTemplate": [ - { - "input": { - "ApplicationName": "my-app", - "TemplateName": "my-template" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation deletes a configuration template named my-template for an application named my-app:", - "id": "to-delete-a-configuration-template-1456269836701", - "title": "To delete a configuration template" - } - ], - "DeleteEnvironmentConfiguration": [ - { - "input": { - "ApplicationName": "my-app", - "EnvironmentName": "my-env" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation deletes a draft configuration for an environment named my-env:", - "id": "to-delete-a-draft-configuration-1456269886654", - "title": "To delete a draft configuration" - } - ], - "DescribeApplicationVersions": [ - { - "input": { - "ApplicationName": "my-app", - "VersionLabels": [ - "v2" - ] - }, - "output": { - "ApplicationVersions": [ - { - "ApplicationName": "my-app", - "DateCreated": "2015-07-23T01:32:26.079Z", - "DateUpdated": "2015-07-23T01:32:26.079Z", - "Description": "update cover page", - "SourceBundle": { - "S3Bucket": "elasticbeanstalk-us-west-2-015321684451", - "S3Key": "my-app/5026-stage-150723_224258.war" - }, - "VersionLabel": "v2" - }, - { - "ApplicationName": "my-app", - "DateCreated": "2015-07-23T22:26:10.816Z", - "DateUpdated": "2015-07-23T22:26:10.816Z", - "Description": "initial version", - "SourceBundle": { - "S3Bucket": "elasticbeanstalk-us-west-2-015321684451", - "S3Key": "my-app/5026-stage-150723_222618.war" - }, - "VersionLabel": "v1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves information about an application version labeled v2:", - "id": "to-view-information-about-an-application-version-1456269947428", - "title": "To view information about an application version" - } - ], - "DescribeApplications": [ - { - "input": { - }, - "output": { - "Applications": [ - { - "ApplicationName": "ruby", - "ConfigurationTemplates": [ - - ], - "DateCreated": "2015-08-13T21:05:44.376Z", - "DateUpdated": "2015-08-13T21:05:44.376Z", - "Versions": [ - "Sample Application" - ] - }, - { - "ApplicationName": "pythonsample", - "ConfigurationTemplates": [ - - ], - "DateCreated": "2015-08-13T19:05:43.637Z", - "DateUpdated": "2015-08-13T19:05:43.637Z", - "Description": "Application created from the EB CLI using \"eb init\"", - "Versions": [ - "Sample Application" - ] - }, - { - "ApplicationName": "nodejs-example", - "ConfigurationTemplates": [ - - ], - "DateCreated": "2015-08-06T17:50:02.486Z", - "DateUpdated": "2015-08-06T17:50:02.486Z", - "Versions": [ - "add elasticache", - "First Release" - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves information about applications in the current region:", - "id": "to-view-a-list-of-applications-1456270027373", - "title": "To view a list of applications" - } - ], - "DescribeConfigurationOptions": [ - { - "input": { - "ApplicationName": "my-app", - "EnvironmentName": "my-env" - }, - "output": { - "Options": [ - { - "ChangeSeverity": "NoInterruption", - "DefaultValue": "30", - "MaxValue": 300, - "MinValue": 5, - "Name": "Interval", - "Namespace": "aws:elb:healthcheck", - "UserDefined": false, - "ValueType": "Scalar" - }, - { - "ChangeSeverity": "NoInterruption", - "DefaultValue": "2000000", - "MinValue": 0, - "Name": "LowerThreshold", - "Namespace": "aws:autoscaling:trigger", - "UserDefined": false, - "ValueType": "Scalar" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves descriptions of all available configuration options for an environment named my-env:", - "id": "to-view-configuration-options-for-an-environment-1456276763917", - "title": "To view configuration options for an environment" - } - ], - "DescribeConfigurationSettings": [ - { - "input": { - "ApplicationName": "my-app", - "EnvironmentName": "my-env" - }, - "output": { - "ConfigurationSettings": [ - { - "ApplicationName": "my-app", - "DateCreated": "2015-08-13T19:16:25Z", - "DateUpdated": "2015-08-13T23:30:07Z", - "DeploymentStatus": "deployed", - "Description": "Environment created from the EB CLI using \"eb create\"", - "EnvironmentName": "my-env", - "OptionSettings": [ - { - "Namespace": "aws:autoscaling:asg", - "OptionName": "Availability Zones", - "ResourceName": "AWSEBAutoScalingGroup", - "Value": "Any" - }, - { - "Namespace": "aws:autoscaling:asg", - "OptionName": "Cooldown", - "ResourceName": "AWSEBAutoScalingGroup", - "Value": "360" - }, - { - "Namespace": "aws:elb:policies", - "OptionName": "ConnectionDrainingTimeout", - "ResourceName": "AWSEBLoadBalancer", - "Value": "20" - }, - { - "Namespace": "aws:elb:policies", - "OptionName": "ConnectionSettingIdleTimeout", - "ResourceName": "AWSEBLoadBalancer", - "Value": "60" - } - ], - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8" - } - ] - }, - "comments": { - "input": { - }, - "output": { - "abbreviated": "Output is abbreviated" - } - }, - "description": "The following operation retrieves configuration settings for an environment named my-env:", - "id": "to-view-configurations-settings-for-an-environment-1456276924537", - "title": "To view configurations settings for an environment" - } - ], - "DescribeEnvironmentHealth": [ - { - "input": { - "AttributeNames": [ - "All" - ], - "EnvironmentName": "my-env" - }, - "output": { - "ApplicationMetrics": { - "Duration": 10, - "Latency": { - "P10": 0.001, - "P50": 0.001, - "P75": 0.002, - "P85": 0.003, - "P90": 0.003, - "P95": 0.004, - "P99": 0.004, - "P999": 0.004 - }, - "RequestCount": 45, - "StatusCodes": { - "Status2xx": 45, - "Status3xx": 0, - "Status4xx": 0, - "Status5xx": 0 - } - }, - "Causes": [ - - ], - "Color": "Green", - "EnvironmentName": "my-env", - "HealthStatus": "Ok", - "InstancesHealth": { - "Degraded": 0, - "Info": 0, - "NoData": 0, - "Ok": 1, - "Pending": 0, - "Severe": 0, - "Unknown": 0, - "Warning": 0 - }, - "RefreshedAt": "2015-08-20T21:09:18Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves overall health information for an environment named my-env:", - "id": "to-view-environment-health-1456277109510", - "title": "To view environment health" - } - ], - "DescribeEnvironmentResources": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "output": { - "EnvironmentResources": { - "AutoScalingGroups": [ - { - "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingGroup-QSB2ZO88SXZT" - } - ], - "EnvironmentName": "my-env", - "Instances": [ - { - "Id": "i-0c91c786" - } - ], - "LaunchConfigurations": [ - { - "Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingLaunchConfiguration-1UUVQIBC96TQ2" - } - ], - "LoadBalancers": [ - { - "Name": "awseb-e-q-AWSEBLoa-1EEPZ0K98BIF0" - } - ], - "Queues": [ - - ], - "Triggers": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves information about resources in an environment named my-env:", - "id": "to-view-information-about-the-aws-resources-in-your-environment-1456277206232", - "title": "To view information about the AWS resources in your environment" - } - ], - "DescribeEnvironments": [ - { - "input": { - "EnvironmentNames": [ - "my-env" - ] - }, - "output": { - "Environments": [ - { - "AbortableOperationInProgress": false, - "ApplicationName": "my-app", - "CNAME": "my-env.elasticbeanstalk.com", - "DateCreated": "2015-08-07T20:48:49.599Z", - "DateUpdated": "2015-08-12T18:16:55.019Z", - "EndpointURL": "awseb-e-w-AWSEBLoa-1483140XB0Q4L-109QXY8121.us-west-2.elb.amazonaws.com", - "EnvironmentId": "e-rpqsewtp2j", - "EnvironmentName": "my-env", - "Health": "Green", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "Status": "Ready", - "Tier": { - "Name": "WebServer", - "Type": "Standard", - "Version": " " - }, - "VersionLabel": "7f58-stage-150812_025409" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves information about an environment named my-env:", - "id": "to-view-information-about-an-environment-1456277288662", - "title": "To view information about an environment" - } - ], - "DescribeEvents": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "output": { - "Events": [ - { - "ApplicationName": "my-app", - "EnvironmentName": "my-env", - "EventDate": "2015-08-20T07:06:53.535Z", - "Message": "Environment health has transitioned from Info to Ok.", - "Severity": "INFO" - }, - { - "ApplicationName": "my-app", - "EnvironmentName": "my-env", - "EventDate": "2015-08-20T07:06:02.049Z", - "Message": "Environment update completed successfully.", - "RequestId": "b7f3960b-4709-11e5-ba1e-07e16200da41", - "Severity": "INFO" - }, - { - "ApplicationName": "my-app", - "EnvironmentName": "my-env", - "EventDate": "2015-08-13T19:16:27.561Z", - "Message": "Using elasticbeanstalk-us-west-2-012445113685 as Amazon S3 storage bucket for environment data.", - "RequestId": "ca8dfbf6-41ef-11e5-988b-651aa638f46b", - "Severity": "INFO" - }, - { - "ApplicationName": "my-app", - "EnvironmentName": "my-env", - "EventDate": "2015-08-13T19:16:26.581Z", - "Message": "createEnvironment is starting.", - "RequestId": "cdfba8f6-41ef-11e5-988b-65638f41aa6b", - "Severity": "INFO" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves events for an environment named my-env:", - "id": "to-view-events-for-an-environment-1456277367589", - "title": "To view events for an environment" - } - ], - "DescribeInstancesHealth": [ - { - "input": { - "AttributeNames": [ - "All" - ], - "EnvironmentName": "my-env" - }, - "output": { - "InstanceHealthList": [ - { - "ApplicationMetrics": { - "Duration": 10, - "Latency": { - "P10": 0, - "P50": 0.001, - "P75": 0.002, - "P85": 0.003, - "P90": 0.004, - "P95": 0.005, - "P99": 0.006, - "P999": 0.006 - }, - "RequestCount": 48, - "StatusCodes": { - "Status2xx": 47, - "Status3xx": 0, - "Status4xx": 1, - "Status5xx": 0 - } - }, - "Causes": [ - - ], - "Color": "Green", - "HealthStatus": "Ok", - "InstanceId": "i-08691cc7", - "LaunchedAt": "2015-08-13T19:17:09Z", - "System": { - "CPUUtilization": { - "IOWait": 0.2, - "IRQ": 0, - "Idle": 97.8, - "Nice": 0.1, - "SoftIRQ": 0.1, - "System": 0.3, - "User": 1.5 - }, - "LoadAverage": [ - 0, - 0.02, - 0.05 - ] - } - } - ], - "RefreshedAt": "2015-08-20T21:09:08Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves health information for instances in an environment named my-env:", - "id": "to-view-environment-health-1456277424757", - "title": "To view environment health" - } - ], - "ListAvailableSolutionStacks": [ - { - "output": { - "SolutionStackDetails": [ - { - "PermittedFileTypes": [ - "zip" - ], - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Node.js" - } - ], - "SolutionStacks": [ - "64bit Amazon Linux 2015.03 v2.0.0 running Node.js", - "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.6", - "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.5", - "64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.4", - "64bit Amazon Linux 2015.03 v2.0.0 running Python 3.4", - "64bit Amazon Linux 2015.03 v2.0.0 running Python 2.7", - "64bit Amazon Linux 2015.03 v2.0.0 running Python", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Puma)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Puma)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Passenger Standalone)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Puma)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Passenger Standalone)", - "64bit Amazon Linux 2015.03 v2.0.0 running Ruby 1.9.3", - "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 7", - "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 6", - "64bit Windows Server Core 2012 R2 running IIS 8.5", - "64bit Windows Server 2012 R2 running IIS 8.5", - "64bit Windows Server 2012 running IIS 8", - "64bit Windows Server 2008 R2 running IIS 7.5", - "64bit Amazon Linux 2015.03 v2.0.0 running Docker 1.6.2", - "64bit Amazon Linux 2015.03 v2.0.0 running Multi-container Docker 1.6.2 (Generic)", - "64bit Debian jessie v2.0.0 running GlassFish 4.1 Java 8 (Preconfigured - Docker)", - "64bit Debian jessie v2.0.0 running GlassFish 4.0 Java 7 (Preconfigured - Docker)", - "64bit Debian jessie v2.0.0 running Go 1.4 (Preconfigured - Docker)", - "64bit Debian jessie v2.0.0 running Go 1.3 (Preconfigured - Docker)", - "64bit Debian jessie v2.0.0 running Python 3.4 (Preconfigured - Docker)" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation lists solution stacks for all currently available platform configurations and any that you have used in the past:", - "id": "to-view-solution-stacks-1456277504811", - "title": "To view solution stacks" - } - ], - "RebuildEnvironment": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation terminates and recreates the resources in an environment named my-env:", - "id": "to-rebuild-an-environment-1456277600918", - "title": "To rebuild an environment" - } - ], - "RequestEnvironmentInfo": [ - { - "input": { - "EnvironmentName": "my-env", - "InfoType": "tail" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation requests logs from an environment named my-env:", - "id": "to-request-tailed-logs-1456277657045", - "title": "To request tailed logs" - } - ], - "RestartAppServer": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation restarts application servers on all instances in an environment named my-env:", - "id": "to-restart-application-servers-1456277739302", - "title": "To restart application servers" - } - ], - "RetrieveEnvironmentInfo": [ - { - "input": { - "EnvironmentName": "my-env", - "InfoType": "tail" - }, - "output": { - "EnvironmentInfo": [ - { - "Ec2InstanceId": "i-09c1c867", - "InfoType": "tail", - "Message": "https://elasticbeanstalk-us-west-2-0123456789012.s3.amazonaws.com/resources/environments/logs/tail/e-fyqyju3yjs/i-09c1c867/TailLogs-1440109397703.out?AWSAccessKeyId=AKGPT4J56IAJ2EUBL5CQ&Expires=1440195891&Signature=n%2BEalOV6A2HIOx4Rcfb7LT16bBM%3D", - "SampleTimestamp": "2015-08-20T22:23:17.703Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation retrieves a link to logs from an environment named my-env:", - "id": "to-retrieve-tailed-logs-1456277792734", - "title": "To retrieve tailed logs" - } - ], - "SwapEnvironmentCNAMEs": [ - { - "input": { - "DestinationEnvironmentName": "my-env-green", - "SourceEnvironmentName": "my-env-blue" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation swaps the assigned subdomains of two environments:", - "id": "to-swap-environment-cnames-1456277839438", - "title": "To swap environment CNAMES" - } - ], - "TerminateEnvironment": [ - { - "input": { - "EnvironmentName": "my-env" - }, - "output": { - "AbortableOperationInProgress": false, - "ApplicationName": "my-app", - "CNAME": "my-env.elasticbeanstalk.com", - "DateCreated": "2015-08-12T18:52:53.622Z", - "DateUpdated": "2015-08-12T19:05:54.744Z", - "EndpointURL": "awseb-e-f-AWSEBLoa-1I9XUMP4-8492WNUP202574.us-west-2.elb.amazonaws.com", - "EnvironmentId": "e-fh2eravpns", - "EnvironmentName": "my-env", - "Health": "Grey", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "Status": "Terminating", - "Tier": { - "Name": "WebServer", - "Type": "Standard", - "Version": " " - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation terminates an Elastic Beanstalk environment named my-env:", - "id": "to-terminate-an-environment-1456277888556", - "title": "To terminate an environment" - } - ], - "UpdateApplication": [ - { - "input": { - "ApplicationName": "my-app", - "Description": "my Elastic Beanstalk application" - }, - "output": { - "Application": { - "ApplicationName": "my-app", - "ConfigurationTemplates": [ - - ], - "DateCreated": "2015-08-13T19:15:50.449Z", - "DateUpdated": "2015-08-20T22:34:56.195Z", - "Description": "my Elastic Beanstalk application", - "Versions": [ - "2fba-stage-150819_234450", - "bf07-stage-150820_214945", - "93f8", - "fd7c-stage-150820_000431", - "22a0-stage-150819_185942" - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation updates the description of an application named my-app:", - "id": "to-change-an-applications-description-1456277957075", - "title": "To change an application's description" - } - ], - "UpdateApplicationVersion": [ - { - "input": { - "ApplicationName": "my-app", - "Description": "new description", - "VersionLabel": "22a0-stage-150819_185942" - }, - "output": { - "ApplicationVersion": { - "ApplicationName": "my-app", - "DateCreated": "2015-08-19T18:59:17.646Z", - "DateUpdated": "2015-08-20T22:53:28.871Z", - "Description": "new description", - "SourceBundle": { - "S3Bucket": "elasticbeanstalk-us-west-2-0123456789012", - "S3Key": "my-app/22a0-stage-150819_185942.war" - }, - "VersionLabel": "22a0-stage-150819_185942" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation updates the description of an application version named 22a0-stage-150819_185942:", - "id": "to-change-an-application-versions-description-1456278019237", - "title": "To change an application version's description" - } - ], - "UpdateConfigurationTemplate": [ - { - "input": { - "ApplicationName": "my-app", - "OptionsToRemove": [ - { - "Namespace": "aws:elasticbeanstalk:healthreporting:system", - "OptionName": "ConfigDocument" - } - ], - "TemplateName": "my-template" - }, - "output": { - "ApplicationName": "my-app", - "DateCreated": "2015-08-20T22:39:31Z", - "DateUpdated": "2015-08-20T22:43:11Z", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "TemplateName": "my-template" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation removes the configured CloudWatch custom health metrics configuration ConfigDocument from a saved configuration template named my-template:", - "id": "to-update-a-configuration-template-1456278075300", - "title": "To update a configuration template" - } - ], - "UpdateEnvironment": [ - { - "input": { - "EnvironmentName": "my-env", - "VersionLabel": "v2" - }, - "output": { - "ApplicationName": "my-app", - "CNAME": "my-env.elasticbeanstalk.com", - "DateCreated": "2015-02-03T23:04:54.453Z", - "DateUpdated": "2015-02-03T23:12:29.119Z", - "EndpointURL": "awseb-e-i-AWSEBLoa-1RDLX6TC9VUAO-0123456789.us-west-2.elb.amazonaws.com", - "EnvironmentId": "e-szqipays4h", - "EnvironmentName": "my-env", - "Health": "Grey", - "SolutionStackName": "64bit Amazon Linux running Tomcat 7", - "Status": "Updating", - "Tier": { - "Name": "WebServer", - "Type": "Standard", - "Version": " " - }, - "VersionLabel": "v2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation updates an environment named \"my-env\" to version \"v2\" of the application to which it belongs:", - "id": "to-update-an-environment-to-a-new-version-1456278210718", - "title": "To update an environment to a new version" - }, - { - "input": { - "EnvironmentName": "my-env", - "OptionSettings": [ - { - "Namespace": "aws:elb:healthcheck", - "OptionName": "Interval", - "Value": "15" - }, - { - "Namespace": "aws:elb:healthcheck", - "OptionName": "Timeout", - "Value": "8" - }, - { - "Namespace": "aws:elb:healthcheck", - "OptionName": "HealthyThreshold", - "Value": "2" - }, - { - "Namespace": "aws:elb:healthcheck", - "OptionName": "UnhealthyThreshold", - "Value": "3" - } - ] - }, - "output": { - "AbortableOperationInProgress": true, - "ApplicationName": "my-app", - "CNAME": "my-env.elasticbeanstalk.com", - "DateCreated": "2015-08-07T20:48:49.599Z", - "DateUpdated": "2015-08-12T18:15:23.804Z", - "EndpointURL": "awseb-e-w-AWSEBLoa-14XB83101Q4L-104QXY80921.sa-east-1.elb.amazonaws.com", - "EnvironmentId": "e-wtp2rpqsej", - "EnvironmentName": "my-env", - "Health": "Grey", - "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8", - "Status": "Updating", - "Tier": { - "Name": "WebServer", - "Type": "Standard", - "Version": " " - }, - "VersionLabel": "7f58-stage-150812_025409" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation configures several options in the aws:elb:loadbalancer namespace:", - "id": "to-configure-option-settings-1456278286349", - "title": "To configure option settings" - } - ], - "ValidateConfigurationSettings": [ - { - "input": { - "ApplicationName": "my-app", - "EnvironmentName": "my-env", - "OptionSettings": [ - { - "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}" - } - ] - }, - "output": { - "Messages": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation validates a CloudWatch custom metrics config document:", - "id": "to-validate-configuration-settings-1456278393654", - "title": "To validate configuration settings" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/paginators-1.json deleted file mode 100644 index 350cce4d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "DescribeEvents": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxRecords", - "result_key": "Events" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/service-2.json deleted file mode 100644 index c542f0e3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elasticbeanstalk/2010-12-01/service-2.json +++ /dev/null @@ -1,3993 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-12-01", - "endpointPrefix":"elasticbeanstalk", - "protocol":"query", - "serviceAbbreviation":"Elastic Beanstalk", - "serviceFullName":"AWS Elastic Beanstalk", - "serviceId":"Elastic Beanstalk", - "signatureVersion":"v4", - "uid":"elasticbeanstalk-2010-12-01", - "xmlNamespace":"http://elasticbeanstalk.amazonaws.com/docs/2010-12-01/" - }, - "operations":{ - "AbortEnvironmentUpdate":{ - "name":"AbortEnvironmentUpdate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AbortEnvironmentUpdateMessage"}, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Cancels in-progress environment configuration update or application version deployment.

" - }, - "ApplyEnvironmentManagedAction":{ - "name":"ApplyEnvironmentManagedAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ApplyEnvironmentManagedActionRequest"}, - "output":{ - "shape":"ApplyEnvironmentManagedActionResult", - "resultWrapper":"ApplyEnvironmentManagedActionResult" - }, - "errors":[ - {"shape":"ElasticBeanstalkServiceException"}, - {"shape":"ManagedActionInvalidStateException"} - ], - "documentation":"

Applies a scheduled managed action immediately. A managed action can be applied only if its status is Scheduled. Get the status and action ID of a managed action with DescribeEnvironmentManagedActions.

" - }, - "CheckDNSAvailability":{ - "name":"CheckDNSAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CheckDNSAvailabilityMessage"}, - "output":{ - "shape":"CheckDNSAvailabilityResultMessage", - "resultWrapper":"CheckDNSAvailabilityResult" - }, - "documentation":"

Checks if the specified CNAME is available.

" - }, - "ComposeEnvironments":{ - "name":"ComposeEnvironments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ComposeEnvironmentsMessage"}, - "output":{ - "shape":"EnvironmentDescriptionsMessage", - "resultWrapper":"ComposeEnvironmentsResult" - }, - "errors":[ - {"shape":"TooManyEnvironmentsException"}, - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Create or update a group of environments that each run a separate component of a single application. Takes a list of version labels that specify application source bundles for each of the environments to create or update. The name of each environment and other required information must be included in the source bundles in an environment manifest named env.yaml. See Compose Environments for details.

" - }, - "CreateApplication":{ - "name":"CreateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationMessage"}, - "output":{ - "shape":"ApplicationDescriptionMessage", - "resultWrapper":"CreateApplicationResult" - }, - "errors":[ - {"shape":"TooManyApplicationsException"} - ], - "documentation":"

Creates an application that has one configuration template named default and no application versions.

" - }, - "CreateApplicationVersion":{ - "name":"CreateApplicationVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationVersionMessage"}, - "output":{ - "shape":"ApplicationVersionDescriptionMessage", - "resultWrapper":"CreateApplicationVersionResult" - }, - "errors":[ - {"shape":"TooManyApplicationsException"}, - {"shape":"TooManyApplicationVersionsException"}, - {"shape":"InsufficientPrivilegesException"}, - {"shape":"S3LocationNotInServiceRegionException"}, - {"shape":"CodeBuildNotInServiceRegionException"} - ], - "documentation":"

Creates an application version for the specified application. You can create an application version from a source bundle in Amazon S3, a commit in AWS CodeCommit, or the output of an AWS CodeBuild build as follows:

Specify a commit in an AWS CodeCommit repository with SourceBuildInformation.

Specify a build in an AWS CodeBuild with SourceBuildInformation and BuildConfiguration.

Specify a source bundle in S3 with SourceBundle

Omit both SourceBuildInformation and SourceBundle to use the default sample application.

Once you create an application version with a specified Amazon S3 bucket and key location, you cannot change that Amazon S3 location. If you change the Amazon S3 location, you receive an exception when you attempt to launch an environment from the application version.

" - }, - "CreateConfigurationTemplate":{ - "name":"CreateConfigurationTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConfigurationTemplateMessage"}, - "output":{ - "shape":"ConfigurationSettingsDescription", - "resultWrapper":"CreateConfigurationTemplateResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"TooManyBucketsException"}, - {"shape":"TooManyConfigurationTemplatesException"} - ], - "documentation":"

Creates a configuration template. Templates are associated with a specific application and are used to deploy different versions of the application with the same configuration settings.

Related Topics

" - }, - "CreateEnvironment":{ - "name":"CreateEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEnvironmentMessage"}, - "output":{ - "shape":"EnvironmentDescription", - "resultWrapper":"CreateEnvironmentResult" - }, - "errors":[ - {"shape":"TooManyEnvironmentsException"}, - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Launches an environment for the specified application using the specified configuration.

" - }, - "CreatePlatformVersion":{ - "name":"CreatePlatformVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlatformVersionRequest"}, - "output":{ - "shape":"CreatePlatformVersionResult", - "resultWrapper":"CreatePlatformVersionResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"ElasticBeanstalkServiceException"}, - {"shape":"TooManyPlatformsException"} - ], - "documentation":"

Create a new version of your custom platform.

" - }, - "CreateStorageLocation":{ - "name":"CreateStorageLocation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"CreateStorageLocationResultMessage", - "resultWrapper":"CreateStorageLocationResult" - }, - "errors":[ - {"shape":"TooManyBucketsException"}, - {"shape":"S3SubscriptionRequiredException"}, - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Creates a bucket in Amazon S3 to store application versions, logs, and other files used by Elastic Beanstalk environments. The Elastic Beanstalk console and EB CLI call this API the first time you create an environment in a region. If the storage location already exists, CreateStorageLocation still returns the bucket name but does not create a new bucket.

" - }, - "DeleteApplication":{ - "name":"DeleteApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationMessage"}, - "errors":[ - {"shape":"OperationInProgressException"} - ], - "documentation":"

Deletes the specified application along with all associated versions and configurations. The application versions will not be deleted from your Amazon S3 bucket.

You cannot delete an application that has a running environment.

" - }, - "DeleteApplicationVersion":{ - "name":"DeleteApplicationVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationVersionMessage"}, - "errors":[ - {"shape":"SourceBundleDeletionException"}, - {"shape":"InsufficientPrivilegesException"}, - {"shape":"OperationInProgressException"}, - {"shape":"S3LocationNotInServiceRegionException"} - ], - "documentation":"

Deletes the specified version from the specified application.

You cannot delete an application version that is associated with a running environment.

" - }, - "DeleteConfigurationTemplate":{ - "name":"DeleteConfigurationTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationTemplateMessage"}, - "errors":[ - {"shape":"OperationInProgressException"} - ], - "documentation":"

Deletes the specified configuration template.

When you launch an environment using a configuration template, the environment gets a copy of the template. You can delete or modify the environment's copy of the template without affecting the running environment.

" - }, - "DeleteEnvironmentConfiguration":{ - "name":"DeleteEnvironmentConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEnvironmentConfigurationMessage"}, - "documentation":"

Deletes the draft configuration associated with the running environment.

Updating a running environment with any configuration changes creates a draft configuration set. You can get the draft configuration using DescribeConfigurationSettings while the update is in progress or if the update fails. The DeploymentStatus for the draft configuration indicates whether the deployment is in process or has failed. The draft configuration remains in existence until it is deleted with this action.

" - }, - "DeletePlatformVersion":{ - "name":"DeletePlatformVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlatformVersionRequest"}, - "output":{ - "shape":"DeletePlatformVersionResult", - "resultWrapper":"DeletePlatformVersionResult" - }, - "errors":[ - {"shape":"OperationInProgressException"}, - {"shape":"InsufficientPrivilegesException"}, - {"shape":"ElasticBeanstalkServiceException"}, - {"shape":"PlatformVersionStillReferencedException"} - ], - "documentation":"

Deletes the specified version of a custom platform.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"DescribeAccountAttributesResult", - "resultWrapper":"DescribeAccountAttributesResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Returns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS account.

The result currently has one set of attributes—resource quotas.

" - }, - "DescribeApplicationVersions":{ - "name":"DescribeApplicationVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeApplicationVersionsMessage"}, - "output":{ - "shape":"ApplicationVersionDescriptionsMessage", - "resultWrapper":"DescribeApplicationVersionsResult" - }, - "documentation":"

Retrieve a list of application versions.

" - }, - "DescribeApplications":{ - "name":"DescribeApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeApplicationsMessage"}, - "output":{ - "shape":"ApplicationDescriptionsMessage", - "resultWrapper":"DescribeApplicationsResult" - }, - "documentation":"

Returns the descriptions of existing applications.

" - }, - "DescribeConfigurationOptions":{ - "name":"DescribeConfigurationOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationOptionsMessage"}, - "output":{ - "shape":"ConfigurationOptionsDescription", - "resultWrapper":"DescribeConfigurationOptionsResult" - }, - "errors":[ - {"shape":"TooManyBucketsException"} - ], - "documentation":"

Describes the configuration options that are used in a particular configuration template or environment, or that a specified solution stack defines. The description includes the values the options, their default values, and an indication of the required action on a running environment if an option value is changed.

" - }, - "DescribeConfigurationSettings":{ - "name":"DescribeConfigurationSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationSettingsMessage"}, - "output":{ - "shape":"ConfigurationSettingsDescriptions", - "resultWrapper":"DescribeConfigurationSettingsResult" - }, - "errors":[ - {"shape":"TooManyBucketsException"} - ], - "documentation":"

Returns a description of the settings for the specified configuration set, that is, either a configuration template or the configuration set associated with a running environment.

When describing the settings for the configuration set associated with a running environment, it is possible to receive two sets of setting descriptions. One is the deployed configuration set, and the other is a draft configuration of an environment that is either in the process of deployment or that failed to deploy.

Related Topics

" - }, - "DescribeEnvironmentHealth":{ - "name":"DescribeEnvironmentHealth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentHealthRequest"}, - "output":{ - "shape":"DescribeEnvironmentHealthResult", - "resultWrapper":"DescribeEnvironmentHealthResult" - }, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Returns information about the overall health of the specified environment. The DescribeEnvironmentHealth operation is only available with AWS Elastic Beanstalk Enhanced Health.

" - }, - "DescribeEnvironmentManagedActionHistory":{ - "name":"DescribeEnvironmentManagedActionHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentManagedActionHistoryRequest"}, - "output":{ - "shape":"DescribeEnvironmentManagedActionHistoryResult", - "resultWrapper":"DescribeEnvironmentManagedActionHistoryResult" - }, - "errors":[ - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Lists an environment's completed and failed managed actions.

" - }, - "DescribeEnvironmentManagedActions":{ - "name":"DescribeEnvironmentManagedActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentManagedActionsRequest"}, - "output":{ - "shape":"DescribeEnvironmentManagedActionsResult", - "resultWrapper":"DescribeEnvironmentManagedActionsResult" - }, - "errors":[ - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Lists an environment's upcoming and in-progress managed actions.

" - }, - "DescribeEnvironmentResources":{ - "name":"DescribeEnvironmentResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentResourcesMessage"}, - "output":{ - "shape":"EnvironmentResourceDescriptionsMessage", - "resultWrapper":"DescribeEnvironmentResourcesResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Returns AWS resources for this environment.

" - }, - "DescribeEnvironments":{ - "name":"DescribeEnvironments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEnvironmentsMessage"}, - "output":{ - "shape":"EnvironmentDescriptionsMessage", - "resultWrapper":"DescribeEnvironmentsResult" - }, - "documentation":"

Returns descriptions for existing environments.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{ - "shape":"EventDescriptionsMessage", - "resultWrapper":"DescribeEventsResult" - }, - "documentation":"

Returns list of event descriptions matching criteria up to the last 6 weeks.

This action returns the most recent 1,000 events from the specified NextToken.

" - }, - "DescribeInstancesHealth":{ - "name":"DescribeInstancesHealth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesHealthRequest"}, - "output":{ - "shape":"DescribeInstancesHealthResult", - "resultWrapper":"DescribeInstancesHealthResult" - }, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Retrieves detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires enhanced health reporting.

" - }, - "DescribePlatformVersion":{ - "name":"DescribePlatformVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlatformVersionRequest"}, - "output":{ - "shape":"DescribePlatformVersionResult", - "resultWrapper":"DescribePlatformVersionResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Describes the version of the platform.

" - }, - "ListAvailableSolutionStacks":{ - "name":"ListAvailableSolutionStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"ListAvailableSolutionStacksResultMessage", - "resultWrapper":"ListAvailableSolutionStacksResult" - }, - "documentation":"

Returns a list of the available solution stack names, with the public version first and then in reverse chronological order.

" - }, - "ListPlatformVersions":{ - "name":"ListPlatformVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPlatformVersionsRequest"}, - "output":{ - "shape":"ListPlatformVersionsResult", - "resultWrapper":"ListPlatformVersionsResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"ElasticBeanstalkServiceException"} - ], - "documentation":"

Lists the available platforms.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceMessage"}, - "output":{ - "shape":"ResourceTagsDescriptionMessage", - "resultWrapper":"ListTagsForResourceResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceTypeNotSupportedException"} - ], - "documentation":"

Returns the tags applied to an AWS Elastic Beanstalk resource. The response contains a list of tag key-value pairs.

Currently, Elastic Beanstalk only supports tagging of Elastic Beanstalk environments. For details about environment tagging, see Tagging Resources in Your Elastic Beanstalk Environment.

" - }, - "RebuildEnvironment":{ - "name":"RebuildEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebuildEnvironmentMessage"}, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Deletes and recreates all of the AWS resources (for example: the Auto Scaling group, load balancer, etc.) for a specified environment and forces a restart.

" - }, - "RequestEnvironmentInfo":{ - "name":"RequestEnvironmentInfo", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestEnvironmentInfoMessage"}, - "documentation":"

Initiates a request to compile the specified type of information of the deployed environment.

Setting the InfoType to tail compiles the last lines from the application server log files of every Amazon EC2 instance in your environment.

Setting the InfoType to bundle compresses the application server log files for every Amazon EC2 instance into a .zip file. Legacy and .NET containers do not support bundle logs.

Use RetrieveEnvironmentInfo to obtain the set of logs.

Related Topics

" - }, - "RestartAppServer":{ - "name":"RestartAppServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestartAppServerMessage"}, - "documentation":"

Causes the environment to restart the application container server running on each Amazon EC2 instance.

" - }, - "RetrieveEnvironmentInfo":{ - "name":"RetrieveEnvironmentInfo", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetrieveEnvironmentInfoMessage"}, - "output":{ - "shape":"RetrieveEnvironmentInfoResultMessage", - "resultWrapper":"RetrieveEnvironmentInfoResult" - }, - "documentation":"

Retrieves the compiled information from a RequestEnvironmentInfo request.

Related Topics

" - }, - "SwapEnvironmentCNAMEs":{ - "name":"SwapEnvironmentCNAMEs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SwapEnvironmentCNAMEsMessage"}, - "documentation":"

Swaps the CNAMEs of two environments.

" - }, - "TerminateEnvironment":{ - "name":"TerminateEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateEnvironmentMessage"}, - "output":{ - "shape":"EnvironmentDescription", - "resultWrapper":"TerminateEnvironmentResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Terminates the specified environment.

" - }, - "UpdateApplication":{ - "name":"UpdateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationMessage"}, - "output":{ - "shape":"ApplicationDescriptionMessage", - "resultWrapper":"UpdateApplicationResult" - }, - "documentation":"

Updates the specified application to have the specified properties.

If a property (for example, description) is not provided, the value remains unchanged. To clear these properties, specify an empty string.

" - }, - "UpdateApplicationResourceLifecycle":{ - "name":"UpdateApplicationResourceLifecycle", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationResourceLifecycleMessage"}, - "output":{ - "shape":"ApplicationResourceLifecycleDescriptionMessage", - "resultWrapper":"UpdateApplicationResourceLifecycleResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"} - ], - "documentation":"

Modifies lifecycle settings for an application.

" - }, - "UpdateApplicationVersion":{ - "name":"UpdateApplicationVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationVersionMessage"}, - "output":{ - "shape":"ApplicationVersionDescriptionMessage", - "resultWrapper":"UpdateApplicationVersionResult" - }, - "documentation":"

Updates the specified application version to have the specified properties.

If a property (for example, description) is not provided, the value remains unchanged. To clear properties, specify an empty string.

" - }, - "UpdateConfigurationTemplate":{ - "name":"UpdateConfigurationTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConfigurationTemplateMessage"}, - "output":{ - "shape":"ConfigurationSettingsDescription", - "resultWrapper":"UpdateConfigurationTemplateResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"TooManyBucketsException"} - ], - "documentation":"

Updates the specified configuration template to have the specified properties or configuration option values.

If a property (for example, ApplicationName) is not provided, its value remains unchanged. To clear such properties, specify an empty string.

Related Topics

" - }, - "UpdateEnvironment":{ - "name":"UpdateEnvironment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEnvironmentMessage"}, - "output":{ - "shape":"EnvironmentDescription", - "resultWrapper":"UpdateEnvironmentResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"TooManyBucketsException"} - ], - "documentation":"

Updates the environment description, deploys a new application version, updates the configuration settings to an entirely new configuration template, or updates select configuration option values in the running environment.

Attempting to update both the release and configuration is not allowed and AWS Elastic Beanstalk returns an InvalidParameterCombination error.

When updating the configuration settings to a new template or individual settings, a draft configuration is created and DescribeConfigurationSettings for this environment returns two setting descriptions with different DeploymentStatus values.

" - }, - "UpdateTagsForResource":{ - "name":"UpdateTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTagsForResourceMessage"}, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"OperationInProgressException"}, - {"shape":"TooManyTagsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceTypeNotSupportedException"} - ], - "documentation":"

Update the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed: TagsToAdd for tags to add or update, and TagsToRemove.

Currently, Elastic Beanstalk only supports tagging of Elastic Beanstalk environments. For details about environment tagging, see Tagging Resources in Your Elastic Beanstalk Environment.

If you create a custom IAM user policy to control permission to this operation, specify one of the following two virtual actions (or both) instead of the API operation name:

elasticbeanstalk:AddTags

Controls permission to call UpdateTagsForResource and pass a list of tags to add in the TagsToAdd parameter.

elasticbeanstalk:RemoveTags

Controls permission to call UpdateTagsForResource and pass a list of tag keys to remove in the TagsToRemove parameter.

For details about creating a custom user policy, see Creating a Custom User Policy.

" - }, - "ValidateConfigurationSettings":{ - "name":"ValidateConfigurationSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ValidateConfigurationSettingsMessage"}, - "output":{ - "shape":"ConfigurationSettingsValidationMessages", - "resultWrapper":"ValidateConfigurationSettingsResult" - }, - "errors":[ - {"shape":"InsufficientPrivilegesException"}, - {"shape":"TooManyBucketsException"} - ], - "documentation":"

Takes a set of configuration settings and either a configuration template or environment, and determines whether those values are valid.

This action returns a list of messages indicating any errors or warnings associated with the selection of option values.

" - } - }, - "shapes":{ - "ARN":{"type":"string"}, - "AbortEnvironmentUpdateMessage":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

This specifies the ID of the environment with the in-progress update that you want to cancel.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

This specifies the name of the environment with the in-progress update that you want to cancel.

" - } - }, - "documentation":"

" - }, - "AbortableOperationInProgress":{"type":"boolean"}, - "ActionHistoryStatus":{ - "type":"string", - "enum":[ - "Completed", - "Failed", - "Unknown" - ] - }, - "ActionStatus":{ - "type":"string", - "enum":[ - "Scheduled", - "Pending", - "Running", - "Unknown" - ] - }, - "ActionType":{ - "type":"string", - "enum":[ - "InstanceRefresh", - "PlatformUpdate", - "Unknown" - ] - }, - "ApplicationArn":{"type":"string"}, - "ApplicationDescription":{ - "type":"structure", - "members":{ - "ApplicationArn":{ - "shape":"ApplicationArn", - "documentation":"

The Amazon Resource Name (ARN) of the application.

" - }, - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

User-defined description of the application.

" - }, - "DateCreated":{ - "shape":"CreationDate", - "documentation":"

The date when the application was created.

" - }, - "DateUpdated":{ - "shape":"UpdateDate", - "documentation":"

The date when the application was last modified.

" - }, - "Versions":{ - "shape":"VersionLabelsList", - "documentation":"

The names of the versions for this application.

" - }, - "ConfigurationTemplates":{ - "shape":"ConfigurationTemplateNamesList", - "documentation":"

The names of the configuration templates associated with this application.

" - }, - "ResourceLifecycleConfig":{ - "shape":"ApplicationResourceLifecycleConfig", - "documentation":"

The lifecycle settings for the application.

" - } - }, - "documentation":"

Describes the properties of an application.

" - }, - "ApplicationDescriptionList":{ - "type":"list", - "member":{"shape":"ApplicationDescription"} - }, - "ApplicationDescriptionMessage":{ - "type":"structure", - "members":{ - "Application":{ - "shape":"ApplicationDescription", - "documentation":"

The ApplicationDescription of the application.

" - } - }, - "documentation":"

Result message containing a single description of an application.

" - }, - "ApplicationDescriptionsMessage":{ - "type":"structure", - "members":{ - "Applications":{ - "shape":"ApplicationDescriptionList", - "documentation":"

This parameter contains a list of ApplicationDescription.

" - } - }, - "documentation":"

Result message containing a list of application descriptions.

" - }, - "ApplicationMetrics":{ - "type":"structure", - "members":{ - "Duration":{ - "shape":"NullableInteger", - "documentation":"

The amount of time that the metrics cover (usually 10 seconds). For example, you might have 5 requests (request_count) within the most recent time slice of 10 seconds (duration).

" - }, - "RequestCount":{ - "shape":"RequestCount", - "documentation":"

Average number of requests handled by the web server per second over the last 10 seconds.

" - }, - "StatusCodes":{ - "shape":"StatusCodes", - "documentation":"

Represents the percentage of requests over the last 10 seconds that resulted in each type of status code response.

" - }, - "Latency":{ - "shape":"Latency", - "documentation":"

Represents the average latency for the slowest X percent of requests over the last 10 seconds. Latencies are in seconds with one millisecond resolution.

" - } - }, - "documentation":"

Application request metrics for an AWS Elastic Beanstalk environment.

" - }, - "ApplicationName":{ - "type":"string", - "max":100, - "min":1 - }, - "ApplicationNamesList":{ - "type":"list", - "member":{"shape":"ApplicationName"} - }, - "ApplicationResourceLifecycleConfig":{ - "type":"structure", - "members":{ - "ServiceRole":{ - "shape":"String", - "documentation":"

The ARN of an IAM service role that Elastic Beanstalk has permission to assume.

The ServiceRole property is required the first time that you provide a VersionLifecycleConfig for the application in one of the supporting calls (CreateApplication or UpdateApplicationResourceLifecycle). After you provide it once, in either one of the calls, Elastic Beanstalk persists the Service Role with the application, and you don't need to specify it again in subsequent UpdateApplicationResourceLifecycle calls. You can, however, specify it in subsequent calls to change the Service Role to another value.

" - }, - "VersionLifecycleConfig":{ - "shape":"ApplicationVersionLifecycleConfig", - "documentation":"

The application version lifecycle configuration.

" - } - }, - "documentation":"

The resource lifecycle configuration for an application. Defines lifecycle settings for resources that belong to the application, and the service role that Elastic Beanstalk assumes in order to apply lifecycle settings. The version lifecycle configuration defines lifecycle settings for application versions.

" - }, - "ApplicationResourceLifecycleDescriptionMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application.

" - }, - "ResourceLifecycleConfig":{ - "shape":"ApplicationResourceLifecycleConfig", - "documentation":"

The lifecycle configuration.

" - } - } - }, - "ApplicationVersionArn":{"type":"string"}, - "ApplicationVersionDescription":{ - "type":"structure", - "members":{ - "ApplicationVersionArn":{ - "shape":"ApplicationVersionArn", - "documentation":"

The Amazon Resource Name (ARN) of the application version.

" - }, - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to which the application version belongs.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description of the application version.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

A unique identifier for the application version.

" - }, - "SourceBuildInformation":{ - "shape":"SourceBuildInformation", - "documentation":"

If the version's source code was retrieved from AWS CodeCommit, the location of the source code for the application version.

" - }, - "BuildArn":{ - "shape":"String", - "documentation":"

Reference to the artifact from the AWS CodeBuild build.

" - }, - "SourceBundle":{ - "shape":"S3Location", - "documentation":"

The storage location of the application version's source bundle in Amazon S3.

" - }, - "DateCreated":{ - "shape":"CreationDate", - "documentation":"

The creation date of the application version.

" - }, - "DateUpdated":{ - "shape":"UpdateDate", - "documentation":"

The last modified date of the application version.

" - }, - "Status":{ - "shape":"ApplicationVersionStatus", - "documentation":"

The processing status of the application version. Reflects the state of the application version during its creation. Many of the values are only applicable if you specified True for the Process parameter of the CreateApplicationVersion action. The following list describes the possible values.

  • Unprocessed – Application version wasn't pre-processed or validated. Elastic Beanstalk will validate configuration files during deployment of the application version to an environment.

  • Processing – Elastic Beanstalk is currently processing the application version.

  • Building – Application version is currently undergoing an AWS CodeBuild build.

  • Processed – Elastic Beanstalk was successfully pre-processed and validated.

  • Failed – Either the AWS CodeBuild build failed or configuration files didn't pass validation. This application version isn't usable.

" - } - }, - "documentation":"

Describes the properties of an application version.

" - }, - "ApplicationVersionDescriptionList":{ - "type":"list", - "member":{"shape":"ApplicationVersionDescription"} - }, - "ApplicationVersionDescriptionMessage":{ - "type":"structure", - "members":{ - "ApplicationVersion":{ - "shape":"ApplicationVersionDescription", - "documentation":"

The ApplicationVersionDescription of the application version.

" - } - }, - "documentation":"

Result message wrapping a single description of an application version.

" - }, - "ApplicationVersionDescriptionsMessage":{ - "type":"structure", - "members":{ - "ApplicationVersions":{ - "shape":"ApplicationVersionDescriptionList", - "documentation":"

List of ApplicationVersionDescription objects sorted in order of creation.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

In a paginated request, the token that you can pass in a subsequent request to get the next response page.

" - } - }, - "documentation":"

Result message wrapping a list of application version descriptions.

" - }, - "ApplicationVersionLifecycleConfig":{ - "type":"structure", - "members":{ - "MaxCountRule":{ - "shape":"MaxCountRule", - "documentation":"

Specify a max count rule to restrict the number of application versions that are retained for an application.

" - }, - "MaxAgeRule":{ - "shape":"MaxAgeRule", - "documentation":"

Specify a max age rule to restrict the length of time that application versions are retained for an application.

" - } - }, - "documentation":"

The application version lifecycle settings for an application. Defines the rules that Elastic Beanstalk applies to an application's versions in order to avoid hitting the per-region limit for application versions.

When Elastic Beanstalk deletes an application version from its database, you can no longer deploy that version to an environment. The source bundle remains in S3 unless you configure the rule to delete it.

" - }, - "ApplicationVersionProccess":{"type":"boolean"}, - "ApplicationVersionStatus":{ - "type":"string", - "enum":[ - "Processed", - "Unprocessed", - "Failed", - "Processing", - "Building" - ] - }, - "ApplyEnvironmentManagedActionRequest":{ - "type":"structure", - "required":["ActionId"], - "members":{ - "EnvironmentName":{ - "shape":"String", - "documentation":"

The name of the target environment.

" - }, - "EnvironmentId":{ - "shape":"String", - "documentation":"

The environment ID of the target environment.

" - }, - "ActionId":{ - "shape":"String", - "documentation":"

The action ID of the scheduled managed action to execute.

" - } - }, - "documentation":"

Request to execute a scheduled managed action immediately.

" - }, - "ApplyEnvironmentManagedActionResult":{ - "type":"structure", - "members":{ - "ActionId":{ - "shape":"String", - "documentation":"

The action ID of the managed action.

" - }, - "ActionDescription":{ - "shape":"String", - "documentation":"

A description of the managed action.

" - }, - "ActionType":{ - "shape":"ActionType", - "documentation":"

The type of managed action.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the managed action.

" - } - }, - "documentation":"

The result message containing information about the managed action.

" - }, - "AutoCreateApplication":{"type":"boolean"}, - "AutoScalingGroup":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ResourceId", - "documentation":"

The name of the AutoScalingGroup .

" - } - }, - "documentation":"

Describes an Auto Scaling launch configuration.

" - }, - "AutoScalingGroupList":{ - "type":"list", - "member":{"shape":"AutoScalingGroup"} - }, - "AvailableSolutionStackDetailsList":{ - "type":"list", - "member":{"shape":"SolutionStackDescription"} - }, - "AvailableSolutionStackNamesList":{ - "type":"list", - "member":{"shape":"SolutionStackName"} - }, - "BoxedBoolean":{"type":"boolean"}, - "BoxedInt":{"type":"integer"}, - "BuildConfiguration":{ - "type":"structure", - "required":[ - "CodeBuildServiceRole", - "Image" - ], - "members":{ - "ArtifactName":{ - "shape":"String", - "documentation":"

The name of the artifact of the CodeBuild build. If provided, Elastic Beanstalk stores the build artifact in the S3 location S3-bucket/resources/application-name/codebuild/codebuild-version-label-artifact-name.zip. If not provided, Elastic Beanstalk stores the build artifact in the S3 location S3-bucket/resources/application-name/codebuild/codebuild-version-label.zip.

" - }, - "CodeBuildServiceRole":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.

" - }, - "ComputeType":{ - "shape":"ComputeType", - "documentation":"

Information about the compute resources the build project will use.

  • BUILD_GENERAL1_SMALL: Use up to 3 GB memory and 2 vCPUs for builds

  • BUILD_GENERAL1_MEDIUM: Use up to 7 GB memory and 4 vCPUs for builds

  • BUILD_GENERAL1_LARGE: Use up to 15 GB memory and 8 vCPUs for builds

" - }, - "Image":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the Docker image to use for this build project.

" - }, - "TimeoutInMinutes":{ - "shape":"BoxedInt", - "documentation":"

How long in minutes, from 5 to 480 (8 hours), for AWS CodeBuild to wait until timing out any related build that does not get marked as completed. The default is 60 minutes.

" - } - }, - "documentation":"

Settings for an AWS CodeBuild build.

" - }, - "Builder":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"ARN", - "documentation":"

The ARN of the builder.

" - } - }, - "documentation":"

The builder used to build the custom platform.

" - }, - "CPUUtilization":{ - "type":"structure", - "members":{ - "User":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the User state over the last 10 seconds.

" - }, - "Nice":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the Nice state over the last 10 seconds.

" - }, - "System":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the System state over the last 10 seconds.

" - }, - "Idle":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the Idle state over the last 10 seconds.

" - }, - "IOWait":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the I/O Wait state over the last 10 seconds.

" - }, - "IRQ":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the IRQ state over the last 10 seconds.

" - }, - "SoftIRQ":{ - "shape":"NullableDouble", - "documentation":"

Percentage of time that the CPU has spent in the SoftIRQ state over the last 10 seconds.

" - } - }, - "documentation":"

CPU utilization metrics for an instance.

" - }, - "Cause":{ - "type":"string", - "max":255, - "min":1 - }, - "Causes":{ - "type":"list", - "member":{"shape":"Cause"} - }, - "CheckDNSAvailabilityMessage":{ - "type":"structure", - "required":["CNAMEPrefix"], - "members":{ - "CNAMEPrefix":{ - "shape":"DNSCnamePrefix", - "documentation":"

The prefix used when this CNAME is reserved.

" - } - }, - "documentation":"

Results message indicating whether a CNAME is available.

" - }, - "CheckDNSAvailabilityResultMessage":{ - "type":"structure", - "members":{ - "Available":{ - "shape":"CnameAvailability", - "documentation":"

Indicates if the specified CNAME is available:

  • true : The CNAME is available.

  • false : The CNAME is not available.

" - }, - "FullyQualifiedCNAME":{ - "shape":"DNSCname", - "documentation":"

The fully qualified CNAME to reserve when CreateEnvironment is called with the provided prefix.

" - } - }, - "documentation":"

Indicates if the specified CNAME is available.

" - }, - "CnameAvailability":{"type":"boolean"}, - "CodeBuildNotInServiceRegionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

AWS CodeBuild is not available in the specified region.

", - "error":{ - "code":"CodeBuildNotInServiceRegionException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ComposeEnvironmentsMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to which the specified source bundles belong.

" - }, - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the group to which the target environments belong. Specify a group name only if the environment name defined in each target environment's manifest ends with a + (plus) character. See Environment Manifest (env.yaml) for details.

" - }, - "VersionLabels":{ - "shape":"VersionLabels", - "documentation":"

A list of version labels, specifying one or more application source bundles that belong to the target application. Each source bundle must include an environment manifest that specifies the name of the environment and the name of the solution stack to use, and optionally can specify environment links to create.

" - } - }, - "documentation":"

Request to create or update a group of environments.

" - }, - "ComputeType":{ - "type":"string", - "enum":[ - "BUILD_GENERAL1_SMALL", - "BUILD_GENERAL1_MEDIUM", - "BUILD_GENERAL1_LARGE" - ] - }, - "ConfigurationDeploymentStatus":{ - "type":"string", - "enum":[ - "deployed", - "pending", - "failed" - ] - }, - "ConfigurationOptionDefaultValue":{"type":"string"}, - "ConfigurationOptionDescription":{ - "type":"structure", - "members":{ - "Namespace":{ - "shape":"OptionNamespace", - "documentation":"

A unique namespace identifying the option's associated AWS resource.

" - }, - "Name":{ - "shape":"ConfigurationOptionName", - "documentation":"

The name of the configuration option.

" - }, - "DefaultValue":{ - "shape":"ConfigurationOptionDefaultValue", - "documentation":"

The default value for this configuration option.

" - }, - "ChangeSeverity":{ - "shape":"ConfigurationOptionSeverity", - "documentation":"

An indication of which action is required if the value for this configuration option changes:

  • NoInterruption : There is no interruption to the environment or application availability.

  • RestartEnvironment : The environment is entirely restarted, all AWS resources are deleted and recreated, and the environment is unavailable during the process.

  • RestartApplicationServer : The environment is available the entire time. However, a short application outage occurs when the application servers on the running Amazon EC2 instances are restarted.

" - }, - "UserDefined":{ - "shape":"UserDefinedOption", - "documentation":"

An indication of whether the user defined this configuration option:

  • true : This configuration option was defined by the user. It is a valid choice for specifying if this as an Option to Remove when updating configuration settings.

  • false : This configuration was not defined by the user.

Constraint: You can remove only UserDefined options from a configuration.

Valid Values: true | false

" - }, - "ValueType":{ - "shape":"ConfigurationOptionValueType", - "documentation":"

An indication of which type of values this option has and whether it is allowable to select one or more than one of the possible values:

  • Scalar : Values for this option are a single selection from the possible values, or an unformatted string, or numeric value governed by the MIN/MAX/Regex constraints.

  • List : Values for this option are multiple selections from the possible values.

  • Boolean : Values for this option are either true or false .

  • Json : Values for this option are a JSON representation of a ConfigDocument.

" - }, - "ValueOptions":{ - "shape":"ConfigurationOptionPossibleValues", - "documentation":"

If specified, values for the configuration option are selected from this list.

" - }, - "MinValue":{ - "shape":"OptionRestrictionMinValue", - "documentation":"

If specified, the configuration option must be a numeric value greater than this value.

" - }, - "MaxValue":{ - "shape":"OptionRestrictionMaxValue", - "documentation":"

If specified, the configuration option must be a numeric value less than this value.

" - }, - "MaxLength":{ - "shape":"OptionRestrictionMaxLength", - "documentation":"

If specified, the configuration option must be a string value no longer than this value.

" - }, - "Regex":{ - "shape":"OptionRestrictionRegex", - "documentation":"

If specified, the configuration option must be a string value that satisfies this regular expression.

" - } - }, - "documentation":"

Describes the possible values for a configuration option.

" - }, - "ConfigurationOptionDescriptionsList":{ - "type":"list", - "member":{"shape":"ConfigurationOptionDescription"} - }, - "ConfigurationOptionName":{"type":"string"}, - "ConfigurationOptionPossibleValue":{"type":"string"}, - "ConfigurationOptionPossibleValues":{ - "type":"list", - "member":{"shape":"ConfigurationOptionPossibleValue"} - }, - "ConfigurationOptionSetting":{ - "type":"structure", - "members":{ - "ResourceName":{ - "shape":"ResourceName", - "documentation":"

A unique resource name for a time-based scaling configuration option.

" - }, - "Namespace":{ - "shape":"OptionNamespace", - "documentation":"

A unique namespace identifying the option's associated AWS resource.

" - }, - "OptionName":{ - "shape":"ConfigurationOptionName", - "documentation":"

The name of the configuration option.

" - }, - "Value":{ - "shape":"ConfigurationOptionValue", - "documentation":"

The current value for the configuration option.

" - } - }, - "documentation":"

A specification identifying an individual configuration option along with its current value. For a list of possible option values, go to Option Values in the AWS Elastic Beanstalk Developer Guide.

" - }, - "ConfigurationOptionSettingsList":{ - "type":"list", - "member":{"shape":"ConfigurationOptionSetting"} - }, - "ConfigurationOptionSeverity":{"type":"string"}, - "ConfigurationOptionValue":{"type":"string"}, - "ConfigurationOptionValueType":{ - "type":"string", - "enum":[ - "Scalar", - "List" - ] - }, - "ConfigurationOptionsDescription":{ - "type":"structure", - "members":{ - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack these configuration options belong to.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "Options":{ - "shape":"ConfigurationOptionDescriptionsList", - "documentation":"

A list of ConfigurationOptionDescription.

" - } - }, - "documentation":"

Describes the settings for a specified configuration set.

" - }, - "ConfigurationSettingsDescription":{ - "type":"structure", - "members":{ - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack this configuration set uses.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with this configuration set.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

If not null, the name of the configuration template for this configuration set.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes this configuration set.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

If not null, the name of the environment for this configuration set.

" - }, - "DeploymentStatus":{ - "shape":"ConfigurationDeploymentStatus", - "documentation":"

If this configuration set is associated with an environment, the DeploymentStatus parameter indicates the deployment status of this configuration set:

  • null: This configuration is not associated with a running environment.

  • pending: This is a draft configuration that is not deployed to the associated environment but is in the process of deploying.

  • deployed: This is the configuration that is currently deployed to the associated running environment.

  • failed: This is a draft configuration that failed to successfully deploy.

" - }, - "DateCreated":{ - "shape":"CreationDate", - "documentation":"

The date (in UTC time) when this configuration set was created.

" - }, - "DateUpdated":{ - "shape":"UpdateDate", - "documentation":"

The date (in UTC time) when this configuration set was last modified.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

A list of the configuration options and their values in this configuration set.

" - } - }, - "documentation":"

Describes the settings for a configuration set.

" - }, - "ConfigurationSettingsDescriptionList":{ - "type":"list", - "member":{"shape":"ConfigurationSettingsDescription"} - }, - "ConfigurationSettingsDescriptions":{ - "type":"structure", - "members":{ - "ConfigurationSettings":{ - "shape":"ConfigurationSettingsDescriptionList", - "documentation":"

A list of ConfigurationSettingsDescription.

" - } - }, - "documentation":"

The results from a request to change the configuration settings of an environment.

" - }, - "ConfigurationSettingsValidationMessages":{ - "type":"structure", - "members":{ - "Messages":{ - "shape":"ValidationMessagesList", - "documentation":"

A list of ValidationMessage.

" - } - }, - "documentation":"

Provides a list of validation messages.

" - }, - "ConfigurationTemplateName":{ - "type":"string", - "max":100, - "min":1 - }, - "ConfigurationTemplateNamesList":{ - "type":"list", - "member":{"shape":"ConfigurationTemplateName"} - }, - "CreateApplicationMessage":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application.

Constraint: This name must be unique within your account. If the specified name already exists, the action returns an InvalidParameterValue error.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes the application.

" - }, - "ResourceLifecycleConfig":{ - "shape":"ApplicationResourceLifecycleConfig", - "documentation":"

Specify an application resource lifecycle configuration to prevent your application from accumulating too many versions.

" - } - }, - "documentation":"

Request to create an application.

" - }, - "CreateApplicationVersionMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "VersionLabel" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application. If no application is found with this name, and AutoCreateApplication is false, returns an InvalidParameterValue error.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

A label identifying this version.

Constraint: Must be unique per application. If an application version already exists with this label for the specified application, AWS Elastic Beanstalk returns an InvalidParameterValue error.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes this version.

" - }, - "SourceBuildInformation":{ - "shape":"SourceBuildInformation", - "documentation":"

Specify a commit in an AWS CodeCommit Git repository to use as the source code for the application version.

" - }, - "SourceBundle":{ - "shape":"S3Location", - "documentation":"

The Amazon S3 bucket and key that identify the location of the source bundle for this version.

The Amazon S3 bucket must be in the same region as the environment.

Specify a source bundle in S3 or a commit in an AWS CodeCommit repository (with SourceBuildInformation), but not both. If neither SourceBundle nor SourceBuildInformation are provided, Elastic Beanstalk uses a sample application.

" - }, - "BuildConfiguration":{ - "shape":"BuildConfiguration", - "documentation":"

Settings for an AWS CodeBuild build.

" - }, - "AutoCreateApplication":{ - "shape":"AutoCreateApplication", - "documentation":"

Set to true to create an application with the specified name if it doesn't already exist.

" - }, - "Process":{ - "shape":"ApplicationVersionProccess", - "documentation":"

Pre-processes and validates the environment manifest (env.yaml) and configuration files (*.config files in the .ebextensions folder) in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.

You must turn processing on for application versions that you create using AWS CodeBuild or AWS CodeCommit. For application versions built from a source bundle in Amazon S3, processing is optional.

The Process option validates Elastic Beanstalk configuration files. It doesn't validate your application's configuration files, like proxy server or Docker configuration.

" - } - }, - "documentation":"

" - }, - "CreateConfigurationTemplateMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "TemplateName" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to associate with this configuration template. If no application is found with this name, AWS Elastic Beanstalk returns an InvalidParameterValue error.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template.

Constraint: This name must be unique per application.

Default: If a configuration template already exists with this name, AWS Elastic Beanstalk returns an InvalidParameterValue error.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack used by this configuration. The solution stack specifies the operating system, architecture, and application server for a configuration template. It determines the set of configuration options as well as the possible and default values.

Use ListAvailableSolutionStacks to obtain a list of available solution stacks.

A solution stack name or a source configuration parameter must be specified, otherwise AWS Elastic Beanstalk returns an InvalidParameterValue error.

If a solution stack name is not specified and the source configuration parameter is specified, AWS Elastic Beanstalk uses the same solution stack as the source configuration template.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the custom platform.

" - }, - "SourceConfiguration":{ - "shape":"SourceConfiguration", - "documentation":"

If specified, AWS Elastic Beanstalk uses the configuration values from the specified configuration template to create a new configuration.

Values specified in the OptionSettings parameter of this call overrides any values obtained from the SourceConfiguration.

If no configuration template is found, returns an InvalidParameterValue error.

Constraint: If both the solution stack name parameter and the source configuration parameters are specified, the solution stack of the source configuration template must match the specified solution stack name or else AWS Elastic Beanstalk returns an InvalidParameterCombination error.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment used with this configuration template.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes this configuration.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

If specified, AWS Elastic Beanstalk sets the specified configuration option to the requested value. The new value overrides the value obtained from the solution stack or the source configuration template.

" - } - }, - "documentation":"

Request to create a configuration template.

" - }, - "CreateEnvironmentMessage":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application that contains the version to be deployed.

If no application is found with this name, CreateEnvironment returns an InvalidParameterValue error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

A unique name for the deployment environment. Used in the application URL.

Constraint: Must be from 4 to 40 characters in length. The name can contain only letters, numbers, and hyphens. It cannot start or end with a hyphen. This name must be unique within a region in your account. If the specified name already exists in the region, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Default: If the CNAME parameter is not specified, the environment name becomes part of the CNAME, and therefore part of the visible URL for your application.

" - }, - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the group to which the target environment belongs. Specify a group name only if the environment's name is specified in an environment manifest and not with the environment name parameter. See Environment Manifest (env.yaml) for details.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes this environment.

" - }, - "CNAMEPrefix":{ - "shape":"DNSCnamePrefix", - "documentation":"

If specified, the environment attempts to use this value as the prefix for the CNAME. If not specified, the CNAME is generated automatically by appending a random alphanumeric string to the environment name.

" - }, - "Tier":{ - "shape":"EnvironmentTier", - "documentation":"

This specifies the tier to use for creating this environment.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

This specifies the tags applied to resources in the environment.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

The name of the application version to deploy.

If the specified application has no associated application versions, AWS Elastic Beanstalk UpdateEnvironment returns an InvalidParameterValue error.

Default: If not specified, AWS Elastic Beanstalk attempts to launch the sample application in the container.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template to use in deployment. If no configuration template is found with this name, AWS Elastic Beanstalk returns an InvalidParameterValue error.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

This is an alternative to specifying a template name. If specified, AWS Elastic Beanstalk sets the configuration values to the default values associated with the specified solution stack.

For a list of current solution stacks, see Elastic Beanstalk Supported Platforms.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

If specified, AWS Elastic Beanstalk sets the specified configuration options to the requested value in the configuration set for the new environment. These override the values obtained from the solution stack or the configuration template.

" - }, - "OptionsToRemove":{ - "shape":"OptionsSpecifierList", - "documentation":"

A list of custom user-defined configuration options to remove from the configuration set for this new environment.

" - } - }, - "documentation":"

" - }, - "CreatePlatformVersionRequest":{ - "type":"structure", - "required":[ - "PlatformName", - "PlatformVersion", - "PlatformDefinitionBundle" - ], - "members":{ - "PlatformName":{ - "shape":"PlatformName", - "documentation":"

The name of your custom platform.

" - }, - "PlatformVersion":{ - "shape":"PlatformVersion", - "documentation":"

The number, such as 1.0.2, for the new platform version.

" - }, - "PlatformDefinitionBundle":{ - "shape":"S3Location", - "documentation":"

The location of the platform definition archive in Amazon S3.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the builder environment.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

The configuration option settings to apply to the builder environment.

" - } - }, - "documentation":"

Request to create a new platform version.

" - }, - "CreatePlatformVersionResult":{ - "type":"structure", - "members":{ - "PlatformSummary":{ - "shape":"PlatformSummary", - "documentation":"

Detailed information about the new version of the custom platform.

" - }, - "Builder":{ - "shape":"Builder", - "documentation":"

The builder used to create the custom platform.

" - } - } - }, - "CreateStorageLocationResultMessage":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"S3Bucket", - "documentation":"

The name of the Amazon S3 bucket created.

" - } - }, - "documentation":"

Results of a CreateStorageLocationResult call.

" - }, - "CreationDate":{"type":"timestamp"}, - "CustomAmi":{ - "type":"structure", - "members":{ - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The type of virtualization used to create the custom AMI.

" - }, - "ImageId":{ - "shape":"ImageId", - "documentation":"

THe ID of the image used to create the custom AMI.

" - } - }, - "documentation":"

A custom AMI available to platforms.

" - }, - "CustomAmiList":{ - "type":"list", - "member":{"shape":"CustomAmi"} - }, - "DNSCname":{ - "type":"string", - "max":255, - "min":1 - }, - "DNSCnamePrefix":{ - "type":"string", - "max":63, - "min":4 - }, - "DeleteApplicationMessage":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to delete.

" - }, - "TerminateEnvByForce":{ - "shape":"TerminateEnvForce", - "documentation":"

When set to true, running environments will be terminated before deleting the application.

" - } - }, - "documentation":"

Request to delete an application.

" - }, - "DeleteApplicationVersionMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "VersionLabel" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to which the version belongs.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

The label of the version to delete.

" - }, - "DeleteSourceBundle":{ - "shape":"DeleteSourceBundle", - "documentation":"

Set to true to delete the source bundle from your storage bucket. Otherwise, the application version is deleted only from Elastic Beanstalk and the source bundle remains in Amazon S3.

" - } - }, - "documentation":"

Request to delete an application version.

" - }, - "DeleteConfigurationTemplateMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "TemplateName" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to delete the configuration template from.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template to delete.

" - } - }, - "documentation":"

Request to delete a configuration template.

" - }, - "DeleteEnvironmentConfigurationMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "EnvironmentName" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application the environment is associated with.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to delete the draft configuration from.

" - } - }, - "documentation":"

Request to delete a draft environment configuration.

" - }, - "DeletePlatformVersionRequest":{ - "type":"structure", - "members":{ - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the version of the custom platform.

" - } - } - }, - "DeletePlatformVersionResult":{ - "type":"structure", - "members":{ - "PlatformSummary":{ - "shape":"PlatformSummary", - "documentation":"

Detailed information about the version of the custom platform.

" - } - } - }, - "DeleteSourceBundle":{"type":"boolean"}, - "Deployment":{ - "type":"structure", - "members":{ - "VersionLabel":{ - "shape":"String", - "documentation":"

The version label of the application version in the deployment.

" - }, - "DeploymentId":{ - "shape":"NullableLong", - "documentation":"

The ID of the deployment. This number increases by one each time that you deploy source code or change instance configuration settings.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the deployment:

  • In Progress : The deployment is in progress.

  • Deployed : The deployment succeeded.

  • Failed : The deployment failed.

" - }, - "DeploymentTime":{ - "shape":"DeploymentTimestamp", - "documentation":"

For in-progress deployments, the time that the deployment started.

For completed deployments, the time that the deployment ended.

" - } - }, - "documentation":"

Information about an application version deployment.

" - }, - "DeploymentTimestamp":{"type":"timestamp"}, - "DescribeAccountAttributesResult":{ - "type":"structure", - "members":{ - "ResourceQuotas":{ - "shape":"ResourceQuotas", - "documentation":"

The Elastic Beanstalk resource quotas associated with the calling AWS account.

" - } - } - }, - "DescribeApplicationVersionsMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Specify an application name to show only application versions for that application.

" - }, - "VersionLabels":{ - "shape":"VersionLabelsList", - "documentation":"

Specify a version label to show a specific application version.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

For a paginated request. Specify a maximum number of application versions to include in each response.

If no MaxRecords is specified, all available application versions are retrieved in a single response.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request.

If no NextToken is specified, the first page is retrieved.

" - } - }, - "documentation":"

Request to describe application versions.

" - }, - "DescribeApplicationsMessage":{ - "type":"structure", - "members":{ - "ApplicationNames":{ - "shape":"ApplicationNamesList", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to only include those with the specified names.

" - } - }, - "documentation":"

Request to describe one or more applications.

" - }, - "DescribeConfigurationOptionsMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with the configuration template or environment. Only needed if you want to describe the configuration options associated with either the configuration template or environment.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template whose configuration options you want to describe.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment whose configuration options you want to describe.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack whose configuration options you want to describe.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the custom platform.

" - }, - "Options":{ - "shape":"OptionsSpecifierList", - "documentation":"

If specified, restricts the descriptions to only the specified options.

" - } - }, - "documentation":"

Result message containing a list of application version descriptions.

" - }, - "DescribeConfigurationSettingsMessage":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The application for the environment or configuration template.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template to describe.

Conditional: You must specify either this parameter or an EnvironmentName, but not both. If you specify both, AWS Elastic Beanstalk returns an InvalidParameterCombination error. If you do not specify either, AWS Elastic Beanstalk returns a MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to describe.

Condition: You must specify either this or a TemplateName, but not both. If you specify both, AWS Elastic Beanstalk returns an InvalidParameterCombination error. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - } - }, - "documentation":"

Result message containing all of the configuration settings for a specified solution stack or configuration template.

" - }, - "DescribeEnvironmentHealthRequest":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

Specify the environment by name.

You must specify either this or an EnvironmentName, or both.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

Specify the environment by ID.

You must specify either this or an EnvironmentName, or both.

" - }, - "AttributeNames":{ - "shape":"EnvironmentHealthAttributes", - "documentation":"

Specify the response elements to return. To retrieve all attributes, set to All. If no attribute names are specified, returns the name of the environment.

" - } - }, - "documentation":"

See the example below to learn how to create a request body.

" - }, - "DescribeEnvironmentHealthResult":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The environment's name.

" - }, - "HealthStatus":{ - "shape":"String", - "documentation":"

The health status of the environment. For example, Ok.

" - }, - "Status":{ - "shape":"EnvironmentHealth", - "documentation":"

The environment's operational status. Ready, Launching, Updating, Terminating, or Terminated.

" - }, - "Color":{ - "shape":"String", - "documentation":"

The health color of the environment.

" - }, - "Causes":{ - "shape":"Causes", - "documentation":"

Descriptions of the data that contributed to the environment's current health status.

" - }, - "ApplicationMetrics":{ - "shape":"ApplicationMetrics", - "documentation":"

Application request metrics for the environment.

" - }, - "InstancesHealth":{ - "shape":"InstanceHealthSummary", - "documentation":"

Summary health information for the instances in the environment.

" - }, - "RefreshedAt":{ - "shape":"RefreshedAt", - "documentation":"

The date and time that the health information was retrieved.

" - } - }, - "documentation":"

Health details for an AWS Elastic Beanstalk environment.

" - }, - "DescribeEnvironmentManagedActionHistoryRequest":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The environment ID of the target environment.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the target environment.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token returned by a previous request.

" - }, - "MaxItems":{ - "shape":"Integer", - "documentation":"

The maximum number of items to return for a single request.

" - } - }, - "documentation":"

Request to list completed and failed managed actions.

" - }, - "DescribeEnvironmentManagedActionHistoryResult":{ - "type":"structure", - "members":{ - "ManagedActionHistoryItems":{ - "shape":"ManagedActionHistoryItems", - "documentation":"

A list of completed and failed managed actions.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A pagination token that you pass to DescribeEnvironmentManagedActionHistory to get the next page of results.

" - } - }, - "documentation":"

A result message containing a list of completed and failed managed actions.

" - }, - "DescribeEnvironmentManagedActionsRequest":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"String", - "documentation":"

The name of the target environment.

" - }, - "EnvironmentId":{ - "shape":"String", - "documentation":"

The environment ID of the target environment.

" - }, - "Status":{ - "shape":"ActionStatus", - "documentation":"

To show only actions with a particular status, specify a status.

" - } - }, - "documentation":"

Request to list an environment's upcoming and in-progress managed actions.

" - }, - "DescribeEnvironmentManagedActionsResult":{ - "type":"structure", - "members":{ - "ManagedActions":{ - "shape":"ManagedActions", - "documentation":"

A list of upcoming and in-progress managed actions.

" - } - }, - "documentation":"

The result message containing a list of managed actions.

" - }, - "DescribeEnvironmentResourcesMessage":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to retrieve AWS resource usage data.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to retrieve AWS resource usage data.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - } - }, - "documentation":"

Request to describe the resources in an environment.

" - }, - "DescribeEnvironmentsMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that are associated with this application.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that are associated with this application version.

" - }, - "EnvironmentIds":{ - "shape":"EnvironmentIdList", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that have the specified IDs.

" - }, - "EnvironmentNames":{ - "shape":"EnvironmentNamesList", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that have the specified names.

" - }, - "IncludeDeleted":{ - "shape":"IncludeDeleted", - "documentation":"

Indicates whether to include deleted environments:

true: Environments that have been deleted after IncludedDeletedBackTo are displayed.

false: Do not include deleted environments.

" - }, - "IncludedDeletedBackTo":{ - "shape":"IncludeDeletedBackTo", - "documentation":"

If specified when IncludeDeleted is set to true, then environments deleted after this date are displayed.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

For a paginated request. Specify a maximum number of environments to include in each response.

If no MaxRecords is specified, all available environments are retrieved in a single response.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request.

If no NextToken is specified, the first page is retrieved.

" - } - }, - "documentation":"

Request to describe one or more environments.

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those associated with this application.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this application version.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that are associated with this environment configuration.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the version of the custom platform.

" - }, - "RequestId":{ - "shape":"RequestId", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the described events to include only those associated with this request ID.

" - }, - "Severity":{ - "shape":"EventSeverity", - "documentation":"

If specified, limits the events returned from this call to include only those with the specified severity or higher.

" - }, - "StartTime":{ - "shape":"TimeFilterStart", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur on or after this time.

" - }, - "EndTime":{ - "shape":"TimeFilterEnd", - "documentation":"

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur up to, but not including, the EndTime.

" - }, - "MaxRecords":{ - "shape":"MaxRecords", - "documentation":"

Specifies the maximum number of events that can be returned, beginning with the most recent event.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

Pagination token. If specified, the events return the next batch of results.

" - } - }, - "documentation":"

Request to retrieve a list of events for an environment.

" - }, - "DescribeInstancesHealthRequest":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

Specify the AWS Elastic Beanstalk environment by name.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

Specify the AWS Elastic Beanstalk environment by ID.

" - }, - "AttributeNames":{ - "shape":"InstancesHealthAttributes", - "documentation":"

Specifies the response elements you wish to receive. To retrieve all attributes, set to All. If no attribute names are specified, returns a list of instances.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Specify the pagination token returned by a previous call.

" - } - }, - "documentation":"

Parameters for a call to DescribeInstancesHealth.

" - }, - "DescribeInstancesHealthResult":{ - "type":"structure", - "members":{ - "InstanceHealthList":{ - "shape":"InstanceHealthList", - "documentation":"

Detailed health information about each instance.

" - }, - "RefreshedAt":{ - "shape":"RefreshedAt", - "documentation":"

The date and time that the health information was retrieved.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Pagination token for the next page of results, if available.

" - } - }, - "documentation":"

Detailed health information about the Amazon EC2 instances in an AWS Elastic Beanstalk environment.

" - }, - "DescribePlatformVersionRequest":{ - "type":"structure", - "members":{ - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the version of the platform.

" - } - } - }, - "DescribePlatformVersionResult":{ - "type":"structure", - "members":{ - "PlatformDescription":{ - "shape":"PlatformDescription", - "documentation":"

Detailed information about the version of the platform.

" - } - } - }, - "Description":{ - "type":"string", - "max":200 - }, - "Ec2InstanceId":{"type":"string"}, - "ElasticBeanstalkServiceException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The exception error message.

" - } - }, - "documentation":"

A generic service exception has occurred.

", - "exception":true - }, - "EndpointURL":{"type":"string"}, - "EnvironmentArn":{"type":"string"}, - "EnvironmentDescription":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of this environment.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of this environment.

" - }, - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with this environment.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

The application version deployed in this environment.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the SolutionStack deployed with this environment.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template used to originally launch this environment.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Describes this environment.

" - }, - "EndpointURL":{ - "shape":"EndpointURL", - "documentation":"

For load-balanced, autoscaling environments, the URL to the LoadBalancer. For single-instance environments, the IP address of the instance.

" - }, - "CNAME":{ - "shape":"DNSCname", - "documentation":"

The URL to the CNAME for this environment.

" - }, - "DateCreated":{ - "shape":"CreationDate", - "documentation":"

The creation date for this environment.

" - }, - "DateUpdated":{ - "shape":"UpdateDate", - "documentation":"

The last modified date for this environment.

" - }, - "Status":{ - "shape":"EnvironmentStatus", - "documentation":"

The current operational status of the environment:

  • Launching: Environment is in the process of initial deployment.

  • Updating: Environment is in the process of updating its configuration settings or application version.

  • Ready: Environment is available to have an action performed on it, such as update or terminate.

  • Terminating: Environment is in the shut-down process.

  • Terminated: Environment is not running.

" - }, - "AbortableOperationInProgress":{ - "shape":"AbortableOperationInProgress", - "documentation":"

Indicates if there is an in-progress environment configuration update or application version deployment that you can cancel.

true: There is an update in progress.

false: There are no updates currently in progress.

" - }, - "Health":{ - "shape":"EnvironmentHealth", - "documentation":"

Describes the health status of the environment. AWS Elastic Beanstalk indicates the failure levels for a running environment:

  • Red: Indicates the environment is not responsive. Occurs when three or more consecutive failures occur for an environment.

  • Yellow: Indicates that something is wrong. Occurs when two consecutive failures occur for an environment.

  • Green: Indicates the environment is healthy and fully functional.

  • Grey: Default health for a new environment. The environment is not fully launched and health checks have not started or health checks are suspended during an UpdateEnvironment or RestartEnvironement request.

Default: Grey

" - }, - "HealthStatus":{ - "shape":"EnvironmentHealthStatus", - "documentation":"

Returns the health status of the application running in your environment. For more information, see Health Colors and Statuses.

" - }, - "Resources":{ - "shape":"EnvironmentResourcesDescription", - "documentation":"

The description of the AWS resources used by this environment.

" - }, - "Tier":{ - "shape":"EnvironmentTier", - "documentation":"

Describes the current tier of this environment.

" - }, - "EnvironmentLinks":{ - "shape":"EnvironmentLinks", - "documentation":"

A list of links to other environments in the same group.

" - }, - "EnvironmentArn":{ - "shape":"EnvironmentArn", - "documentation":"

The environment's Amazon Resource Name (ARN), which can be used in other API requests that require an ARN.

" - } - }, - "documentation":"

Describes the properties of an environment.

" - }, - "EnvironmentDescriptionsList":{ - "type":"list", - "member":{"shape":"EnvironmentDescription"} - }, - "EnvironmentDescriptionsMessage":{ - "type":"structure", - "members":{ - "Environments":{ - "shape":"EnvironmentDescriptionsList", - "documentation":"

Returns an EnvironmentDescription list.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

In a paginated request, the token that you can pass in a subsequent request to get the next response page.

" - } - }, - "documentation":"

Result message containing a list of environment descriptions.

" - }, - "EnvironmentHealth":{ - "type":"string", - "enum":[ - "Green", - "Yellow", - "Red", - "Grey" - ] - }, - "EnvironmentHealthAttribute":{ - "type":"string", - "enum":[ - "Status", - "Color", - "Causes", - "ApplicationMetrics", - "InstancesHealth", - "All", - "HealthStatus", - "RefreshedAt" - ] - }, - "EnvironmentHealthAttributes":{ - "type":"list", - "member":{"shape":"EnvironmentHealthAttribute"} - }, - "EnvironmentHealthStatus":{ - "type":"string", - "enum":[ - "NoData", - "Unknown", - "Pending", - "Ok", - "Info", - "Warning", - "Degraded", - "Severe", - "Suspended" - ] - }, - "EnvironmentId":{"type":"string"}, - "EnvironmentIdList":{ - "type":"list", - "member":{"shape":"EnvironmentId"} - }, - "EnvironmentInfoDescription":{ - "type":"structure", - "members":{ - "InfoType":{ - "shape":"EnvironmentInfoType", - "documentation":"

The type of information retrieved.

" - }, - "Ec2InstanceId":{ - "shape":"Ec2InstanceId", - "documentation":"

The Amazon EC2 Instance ID for this information.

" - }, - "SampleTimestamp":{ - "shape":"SampleTimestamp", - "documentation":"

The time stamp when this information was retrieved.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

The retrieved information.

" - } - }, - "documentation":"

The information retrieved from the Amazon EC2 instances.

" - }, - "EnvironmentInfoDescriptionList":{ - "type":"list", - "member":{"shape":"EnvironmentInfoDescription"} - }, - "EnvironmentInfoType":{ - "type":"string", - "enum":[ - "tail", - "bundle" - ] - }, - "EnvironmentLink":{ - "type":"structure", - "members":{ - "LinkName":{ - "shape":"String", - "documentation":"

The name of the link.

" - }, - "EnvironmentName":{ - "shape":"String", - "documentation":"

The name of the linked environment (the dependency).

" - } - }, - "documentation":"

A link to another environment, defined in the environment's manifest. Links provide connection information in system properties that can be used to connect to another environment in the same group. See Environment Manifest (env.yaml) for details.

" - }, - "EnvironmentLinks":{ - "type":"list", - "member":{"shape":"EnvironmentLink"} - }, - "EnvironmentName":{ - "type":"string", - "max":40, - "min":4 - }, - "EnvironmentNamesList":{ - "type":"list", - "member":{"shape":"EnvironmentName"} - }, - "EnvironmentResourceDescription":{ - "type":"structure", - "members":{ - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment.

" - }, - "AutoScalingGroups":{ - "shape":"AutoScalingGroupList", - "documentation":"

The AutoScalingGroups used by this environment.

" - }, - "Instances":{ - "shape":"InstanceList", - "documentation":"

The Amazon EC2 instances used by this environment.

" - }, - "LaunchConfigurations":{ - "shape":"LaunchConfigurationList", - "documentation":"

The Auto Scaling launch configurations in use by this environment.

" - }, - "LoadBalancers":{ - "shape":"LoadBalancerList", - "documentation":"

The LoadBalancers in use by this environment.

" - }, - "Triggers":{ - "shape":"TriggerList", - "documentation":"

The AutoScaling triggers in use by this environment.

" - }, - "Queues":{ - "shape":"QueueList", - "documentation":"

The queues used by this environment.

" - } - }, - "documentation":"

Describes the AWS resources in use by this environment. This data is live.

" - }, - "EnvironmentResourceDescriptionsMessage":{ - "type":"structure", - "members":{ - "EnvironmentResources":{ - "shape":"EnvironmentResourceDescription", - "documentation":"

A list of EnvironmentResourceDescription.

" - } - }, - "documentation":"

Result message containing a list of environment resource descriptions.

" - }, - "EnvironmentResourcesDescription":{ - "type":"structure", - "members":{ - "LoadBalancer":{ - "shape":"LoadBalancerDescription", - "documentation":"

Describes the LoadBalancer.

" - } - }, - "documentation":"

Describes the AWS resources in use by this environment. This data is not live data.

" - }, - "EnvironmentStatus":{ - "type":"string", - "enum":[ - "Launching", - "Updating", - "Ready", - "Terminating", - "Terminated" - ] - }, - "EnvironmentTier":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of this environment tier.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of this environment tier.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version of this environment tier. When you don't set a value to it, Elastic Beanstalk uses the latest compatible worker tier version.

This member is deprecated. Any specific version that you set may become out of date. We recommend leaving it unspecified.

" - } - }, - "documentation":"

Describes the properties of an environment tier

" - }, - "EventDate":{"type":"timestamp"}, - "EventDescription":{ - "type":"structure", - "members":{ - "EventDate":{ - "shape":"EventDate", - "documentation":"

The date when the event occurred.

" - }, - "Message":{ - "shape":"EventMessage", - "documentation":"

The event message.

" - }, - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The application associated with the event.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

The release label for the application version associated with this event.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration associated with this event.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment associated with this event.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "RequestId":{ - "shape":"RequestId", - "documentation":"

The web service request ID for the activity of this event.

" - }, - "Severity":{ - "shape":"EventSeverity", - "documentation":"

The severity level of this event.

" - } - }, - "documentation":"

Describes an event.

" - }, - "EventDescriptionList":{ - "type":"list", - "member":{"shape":"EventDescription"} - }, - "EventDescriptionsMessage":{ - "type":"structure", - "members":{ - "Events":{ - "shape":"EventDescriptionList", - "documentation":"

A list of EventDescription.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

If returned, this indicates that there are more results to obtain. Use this token in the next DescribeEvents call to get the next batch of events.

" - } - }, - "documentation":"

Result message wrapping a list of event descriptions.

" - }, - "EventMessage":{"type":"string"}, - "EventSeverity":{ - "type":"string", - "enum":[ - "TRACE", - "DEBUG", - "INFO", - "WARN", - "ERROR", - "FATAL" - ] - }, - "ExceptionMessage":{"type":"string"}, - "FailureType":{ - "type":"string", - "enum":[ - "UpdateCancelled", - "CancellationFailed", - "RollbackFailed", - "RollbackSuccessful", - "InternalFailure", - "InvalidEnvironmentState", - "PermissionsError" - ] - }, - "FileTypeExtension":{ - "type":"string", - "max":100, - "min":1 - }, - "ForceTerminate":{"type":"boolean"}, - "GroupName":{ - "type":"string", - "max":19, - "min":1 - }, - "ImageId":{"type":"string"}, - "IncludeDeleted":{"type":"boolean"}, - "IncludeDeletedBackTo":{"type":"timestamp"}, - "Instance":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the Amazon EC2 instance.

" - } - }, - "documentation":"

The description of an Amazon EC2 instance.

" - }, - "InstanceHealthList":{ - "type":"list", - "member":{"shape":"SingleInstanceHealth"} - }, - "InstanceHealthSummary":{ - "type":"structure", - "members":{ - "NoData":{ - "shape":"NullableInteger", - "documentation":"

Grey. AWS Elastic Beanstalk and the health agent are reporting no data on an instance.

" - }, - "Unknown":{ - "shape":"NullableInteger", - "documentation":"

Grey. AWS Elastic Beanstalk and the health agent are reporting an insufficient amount of data on an instance.

" - }, - "Pending":{ - "shape":"NullableInteger", - "documentation":"

Grey. An operation is in progress on an instance within the command timeout.

" - }, - "Ok":{ - "shape":"NullableInteger", - "documentation":"

Green. An instance is passing health checks and the health agent is not reporting any problems.

" - }, - "Info":{ - "shape":"NullableInteger", - "documentation":"

Green. An operation is in progress on an instance.

" - }, - "Warning":{ - "shape":"NullableInteger", - "documentation":"

Yellow. The health agent is reporting a moderate number of request failures or other issues for an instance or environment.

" - }, - "Degraded":{ - "shape":"NullableInteger", - "documentation":"

Red. The health agent is reporting a high number of request failures or other issues for an instance or environment.

" - }, - "Severe":{ - "shape":"NullableInteger", - "documentation":"

Red. The health agent is reporting a very high number of request failures or other issues for an instance or environment.

" - } - }, - "documentation":"

Represents summary information about the health of an instance. For more information, see Health Colors and Statuses.

" - }, - "InstanceId":{ - "type":"string", - "max":255, - "min":1 - }, - "InstanceList":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InstancesHealthAttribute":{ - "type":"string", - "enum":[ - "HealthStatus", - "Color", - "Causes", - "ApplicationMetrics", - "RefreshedAt", - "LaunchedAt", - "System", - "Deployment", - "AvailabilityZone", - "InstanceType", - "All" - ] - }, - "InstancesHealthAttributes":{ - "type":"list", - "member":{"shape":"InstancesHealthAttribute"} - }, - "InsufficientPrivilegesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account does not have sufficient privileges for one or more AWS services.

", - "error":{ - "code":"InsufficientPrivilegesException", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "Integer":{"type":"integer"}, - "InvalidRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more input parameters is not valid. Please correct the input parameters and try the operation again.

", - "error":{ - "code":"InvalidRequestException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Latency":{ - "type":"structure", - "members":{ - "P999":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 0.1 percent of requests over the last 10 seconds.

" - }, - "P99":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 1 percent of requests over the last 10 seconds.

" - }, - "P95":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 5 percent of requests over the last 10 seconds.

" - }, - "P90":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 10 percent of requests over the last 10 seconds.

" - }, - "P85":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 15 percent of requests over the last 10 seconds.

" - }, - "P75":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 25 percent of requests over the last 10 seconds.

" - }, - "P50":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 50 percent of requests over the last 10 seconds.

" - }, - "P10":{ - "shape":"NullableDouble", - "documentation":"

The average latency for the slowest 90 percent of requests over the last 10 seconds.

" - } - }, - "documentation":"

Represents the average latency for the slowest X percent of requests over the last 10 seconds.

" - }, - "LaunchConfiguration":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ResourceId", - "documentation":"

The name of the launch configuration.

" - } - }, - "documentation":"

Describes an Auto Scaling launch configuration.

" - }, - "LaunchConfigurationList":{ - "type":"list", - "member":{"shape":"LaunchConfiguration"} - }, - "LaunchedAt":{"type":"timestamp"}, - "ListAvailableSolutionStacksResultMessage":{ - "type":"structure", - "members":{ - "SolutionStacks":{ - "shape":"AvailableSolutionStackNamesList", - "documentation":"

A list of available solution stacks.

" - }, - "SolutionStackDetails":{ - "shape":"AvailableSolutionStackDetailsList", - "documentation":"

A list of available solution stacks and their SolutionStackDescription.

" - } - }, - "documentation":"

A list of available AWS Elastic Beanstalk solution stacks.

" - }, - "ListPlatformVersionsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"PlatformFilters", - "documentation":"

List only the platforms where the platform member value relates to one of the supplied values.

" - }, - "MaxRecords":{ - "shape":"PlatformMaxRecords", - "documentation":"

The maximum number of platform values returned in one call.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

The starting index into the remaining list of platforms. Use the NextToken value from a previous ListPlatformVersion call.

" - } - } - }, - "ListPlatformVersionsResult":{ - "type":"structure", - "members":{ - "PlatformSummaryList":{ - "shape":"PlatformSummaryList", - "documentation":"

Detailed information about the platforms.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

The starting index into the remaining list of platforms. if this value is not null, you can use it in a subsequent ListPlatformVersion call.

" - } - } - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resouce for which a tag list is requested.

Must be the ARN of an Elastic Beanstalk environment.

" - } - } - }, - "Listener":{ - "type":"structure", - "members":{ - "Protocol":{ - "shape":"String", - "documentation":"

The protocol that is used by the Listener.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port that is used by the Listener.

" - } - }, - "documentation":"

Describes the properties of a Listener for the LoadBalancer.

" - }, - "LoadAverage":{ - "type":"list", - "member":{"shape":"LoadAverageValue"} - }, - "LoadAverageValue":{"type":"double"}, - "LoadBalancer":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ResourceId", - "documentation":"

The name of the LoadBalancer.

" - } - }, - "documentation":"

Describes a LoadBalancer.

" - }, - "LoadBalancerDescription":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"String", - "documentation":"

The name of the LoadBalancer.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

The domain name of the LoadBalancer.

" - }, - "Listeners":{ - "shape":"LoadBalancerListenersDescription", - "documentation":"

A list of Listeners used by the LoadBalancer.

" - } - }, - "documentation":"

Describes the details of a LoadBalancer.

" - }, - "LoadBalancerList":{ - "type":"list", - "member":{"shape":"LoadBalancer"} - }, - "LoadBalancerListenersDescription":{ - "type":"list", - "member":{"shape":"Listener"} - }, - "Maintainer":{"type":"string"}, - "ManagedAction":{ - "type":"structure", - "members":{ - "ActionId":{ - "shape":"String", - "documentation":"

A unique identifier for the managed action.

" - }, - "ActionDescription":{ - "shape":"String", - "documentation":"

A description of the managed action.

" - }, - "ActionType":{ - "shape":"ActionType", - "documentation":"

The type of managed action.

" - }, - "Status":{ - "shape":"ActionStatus", - "documentation":"

The status of the managed action. If the action is Scheduled, you can apply it immediately with ApplyEnvironmentManagedAction.

" - }, - "WindowStartTime":{ - "shape":"Timestamp", - "documentation":"

The start time of the maintenance window in which the managed action will execute.

" - } - }, - "documentation":"

The record of an upcoming or in-progress managed action.

" - }, - "ManagedActionHistoryItem":{ - "type":"structure", - "members":{ - "ActionId":{ - "shape":"String", - "documentation":"

A unique identifier for the managed action.

" - }, - "ActionType":{ - "shape":"ActionType", - "documentation":"

The type of the managed action.

" - }, - "ActionDescription":{ - "shape":"String", - "documentation":"

A description of the managed action.

" - }, - "FailureType":{ - "shape":"FailureType", - "documentation":"

If the action failed, the type of failure.

" - }, - "Status":{ - "shape":"ActionHistoryStatus", - "documentation":"

The status of the action.

" - }, - "FailureDescription":{ - "shape":"String", - "documentation":"

If the action failed, a description of the failure.

" - }, - "ExecutedTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the action started executing.

" - }, - "FinishedTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the action finished executing.

" - } - }, - "documentation":"

The record of a completed or failed managed action.

" - }, - "ManagedActionHistoryItems":{ - "type":"list", - "member":{"shape":"ManagedActionHistoryItem"}, - "max":100, - "min":1 - }, - "ManagedActionInvalidStateException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cannot modify the managed action in its current state.

", - "error":{ - "code":"ManagedActionInvalidStateException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ManagedActions":{ - "type":"list", - "member":{"shape":"ManagedAction"}, - "max":100, - "min":1 - }, - "MaxAgeRule":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"BoxedBoolean", - "documentation":"

Specify true to apply the rule, or false to disable it.

" - }, - "MaxAgeInDays":{ - "shape":"BoxedInt", - "documentation":"

Specify the number of days to retain an application versions.

" - }, - "DeleteSourceFromS3":{ - "shape":"BoxedBoolean", - "documentation":"

Set to true to delete a version's source bundle from Amazon S3 when Elastic Beanstalk deletes the application version.

" - } - }, - "documentation":"

A lifecycle rule that deletes application versions after the specified number of days.

" - }, - "MaxCountRule":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"BoxedBoolean", - "documentation":"

Specify true to apply the rule, or false to disable it.

" - }, - "MaxCount":{ - "shape":"BoxedInt", - "documentation":"

Specify the maximum number of application versions to retain.

" - }, - "DeleteSourceFromS3":{ - "shape":"BoxedBoolean", - "documentation":"

Set to true to delete a version's source bundle from Amazon S3 when Elastic Beanstalk deletes the application version.

" - } - }, - "documentation":"

A lifecycle rule that deletes the oldest application version when the maximum count is exceeded.

" - }, - "MaxRecords":{ - "type":"integer", - "max":1000, - "min":1 - }, - "Message":{"type":"string"}, - "NextToken":{ - "type":"string", - "max":100, - "min":1 - }, - "NonEmptyString":{ - "type":"string", - "pattern":".*\\S.*" - }, - "NullableDouble":{"type":"double"}, - "NullableInteger":{"type":"integer"}, - "NullableLong":{"type":"long"}, - "OperatingSystemName":{"type":"string"}, - "OperatingSystemVersion":{"type":"string"}, - "OperationInProgressException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Unable to perform the specified operation because another operation that effects an element in this activity is already in progress.

", - "error":{ - "code":"OperationInProgressFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "OptionNamespace":{"type":"string"}, - "OptionRestrictionMaxLength":{"type":"integer"}, - "OptionRestrictionMaxValue":{"type":"integer"}, - "OptionRestrictionMinValue":{"type":"integer"}, - "OptionRestrictionRegex":{ - "type":"structure", - "members":{ - "Pattern":{ - "shape":"RegexPattern", - "documentation":"

The regular expression pattern that a string configuration option value with this restriction must match.

" - }, - "Label":{ - "shape":"RegexLabel", - "documentation":"

A unique name representing this regular expression.

" - } - }, - "documentation":"

A regular expression representing a restriction on a string configuration option value.

" - }, - "OptionSpecification":{ - "type":"structure", - "members":{ - "ResourceName":{ - "shape":"ResourceName", - "documentation":"

A unique resource name for a time-based scaling configuration option.

" - }, - "Namespace":{ - "shape":"OptionNamespace", - "documentation":"

A unique namespace identifying the option's associated AWS resource.

" - }, - "OptionName":{ - "shape":"ConfigurationOptionName", - "documentation":"

The name of the configuration option.

" - } - }, - "documentation":"

A specification identifying an individual configuration option.

" - }, - "OptionsSpecifierList":{ - "type":"list", - "member":{"shape":"OptionSpecification"} - }, - "PlatformArn":{"type":"string"}, - "PlatformCategory":{"type":"string"}, - "PlatformDescription":{ - "type":"structure", - "members":{ - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "PlatformOwner":{ - "shape":"PlatformOwner", - "documentation":"

The AWS account ID of the person who created the platform.

" - }, - "PlatformName":{ - "shape":"PlatformName", - "documentation":"

The name of the platform.

" - }, - "PlatformVersion":{ - "shape":"PlatformVersion", - "documentation":"

The version of the platform.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack used by the platform.

" - }, - "PlatformStatus":{ - "shape":"PlatformStatus", - "documentation":"

The status of the platform.

" - }, - "DateCreated":{ - "shape":"CreationDate", - "documentation":"

The date when the platform was created.

" - }, - "DateUpdated":{ - "shape":"UpdateDate", - "documentation":"

The date when the platform was last updated.

" - }, - "PlatformCategory":{ - "shape":"PlatformCategory", - "documentation":"

The category of the platform.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description of the platform.

" - }, - "Maintainer":{ - "shape":"Maintainer", - "documentation":"

Information about the maintainer of the platform.

" - }, - "OperatingSystemName":{ - "shape":"OperatingSystemName", - "documentation":"

The operating system used by the platform.

" - }, - "OperatingSystemVersion":{ - "shape":"OperatingSystemVersion", - "documentation":"

The version of the operating system used by the platform.

" - }, - "ProgrammingLanguages":{ - "shape":"PlatformProgrammingLanguages", - "documentation":"

The programming languages supported by the platform.

" - }, - "Frameworks":{ - "shape":"PlatformFrameworks", - "documentation":"

The frameworks supported by the platform.

" - }, - "CustomAmiList":{ - "shape":"CustomAmiList", - "documentation":"

The custom AMIs supported by the platform.

" - }, - "SupportedTierList":{ - "shape":"SupportedTierList", - "documentation":"

The tiers supported by the platform.

" - }, - "SupportedAddonList":{ - "shape":"SupportedAddonList", - "documentation":"

The additions supported by the platform.

" - } - }, - "documentation":"

Detailed information about a platform.

" - }, - "PlatformFilter":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"PlatformFilterType", - "documentation":"

The custom platform attribute to which the filter values are applied.

Valid Values: PlatformName | PlatformVersion | PlatformStatus | PlatformOwner

" - }, - "Operator":{ - "shape":"PlatformFilterOperator", - "documentation":"

The operator to apply to the Type with each of the Values.

Valid Values: = (equal to) | != (not equal to) | < (less than) | <= (less than or equal to) | > (greater than) | >= (greater than or equal to) | contains | begins_with | ends_with

" - }, - "Values":{ - "shape":"PlatformFilterValueList", - "documentation":"

The list of values applied to the custom platform attribute.

" - } - }, - "documentation":"

Specify criteria to restrict the results when listing custom platforms.

The filter is evaluated as the expression:

Type Operator Values[i]

" - }, - "PlatformFilterOperator":{"type":"string"}, - "PlatformFilterType":{"type":"string"}, - "PlatformFilterValue":{"type":"string"}, - "PlatformFilterValueList":{ - "type":"list", - "member":{"shape":"PlatformFilterValue"} - }, - "PlatformFilters":{ - "type":"list", - "member":{"shape":"PlatformFilter"} - }, - "PlatformFramework":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the framework.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version of the framework.

" - } - }, - "documentation":"

A framework supported by the custom platform.

" - }, - "PlatformFrameworks":{ - "type":"list", - "member":{"shape":"PlatformFramework"} - }, - "PlatformMaxRecords":{ - "type":"integer", - "min":1 - }, - "PlatformName":{"type":"string"}, - "PlatformOwner":{"type":"string"}, - "PlatformProgrammingLanguage":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the programming language.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version of the programming language.

" - } - }, - "documentation":"

A programming language supported by the platform.

" - }, - "PlatformProgrammingLanguages":{ - "type":"list", - "member":{"shape":"PlatformProgrammingLanguage"} - }, - "PlatformStatus":{ - "type":"string", - "enum":[ - "Creating", - "Failed", - "Ready", - "Deleting", - "Deleted" - ] - }, - "PlatformSummary":{ - "type":"structure", - "members":{ - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform.

" - }, - "PlatformOwner":{ - "shape":"PlatformOwner", - "documentation":"

The AWS account ID of the person who created the platform.

" - }, - "PlatformStatus":{ - "shape":"PlatformStatus", - "documentation":"

The status of the platform. You can create an environment from the platform once it is ready.

" - }, - "PlatformCategory":{ - "shape":"PlatformCategory", - "documentation":"

The category of platform.

" - }, - "OperatingSystemName":{ - "shape":"OperatingSystemName", - "documentation":"

The operating system used by the platform.

" - }, - "OperatingSystemVersion":{ - "shape":"OperatingSystemVersion", - "documentation":"

The version of the operating system used by the platform.

" - }, - "SupportedTierList":{ - "shape":"SupportedTierList", - "documentation":"

The tiers in which the platform runs.

" - }, - "SupportedAddonList":{ - "shape":"SupportedAddonList", - "documentation":"

The additions associated with the platform.

" - } - }, - "documentation":"

Detailed information about a platform.

" - }, - "PlatformSummaryList":{ - "type":"list", - "member":{"shape":"PlatformSummary"} - }, - "PlatformVersion":{"type":"string"}, - "PlatformVersionStillReferencedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot delete the platform version because there are still environments running on it.

", - "error":{ - "code":"PlatformVersionStillReferencedException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Queue":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the queue.

" - }, - "URL":{ - "shape":"String", - "documentation":"

The URL of the queue.

" - } - }, - "documentation":"

Describes a queue.

" - }, - "QueueList":{ - "type":"list", - "member":{"shape":"Queue"} - }, - "RebuildEnvironmentMessage":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to rebuild.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to rebuild.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - } - }, - "documentation":"

" - }, - "RefreshedAt":{"type":"timestamp"}, - "RegexLabel":{"type":"string"}, - "RegexPattern":{"type":"string"}, - "RequestCount":{"type":"integer"}, - "RequestEnvironmentInfoMessage":{ - "type":"structure", - "required":["InfoType"], - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment of the requested data.

If no such environment is found, RequestEnvironmentInfo returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment of the requested data.

If no such environment is found, RequestEnvironmentInfo returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "InfoType":{ - "shape":"EnvironmentInfoType", - "documentation":"

The type of information to request.

" - } - }, - "documentation":"

Request to retrieve logs from an environment and store them in your Elastic Beanstalk storage bucket.

" - }, - "RequestId":{"type":"string"}, - "ResourceArn":{"type":"string"}, - "ResourceId":{"type":"string"}, - "ResourceName":{ - "type":"string", - "max":256, - "min":1 - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A resource doesn't exist for the specified Amazon Resource Name (ARN).

", - "error":{ - "code":"ResourceNotFoundException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ResourceQuota":{ - "type":"structure", - "members":{ - "Maximum":{ - "shape":"BoxedInt", - "documentation":"

The maximum number of instances of this Elastic Beanstalk resource type that an AWS account can use.

" - } - }, - "documentation":"

The AWS Elastic Beanstalk quota information for a single resource type in an AWS account. It reflects the resource's limits for this account.

" - }, - "ResourceQuotas":{ - "type":"structure", - "members":{ - "ApplicationQuota":{ - "shape":"ResourceQuota", - "documentation":"

The quota for applications in the AWS account.

" - }, - "ApplicationVersionQuota":{ - "shape":"ResourceQuota", - "documentation":"

The quota for application versions in the AWS account.

" - }, - "EnvironmentQuota":{ - "shape":"ResourceQuota", - "documentation":"

The quota for environments in the AWS account.

" - }, - "ConfigurationTemplateQuota":{ - "shape":"ResourceQuota", - "documentation":"

The quota for configuration templates in the AWS account.

" - }, - "CustomPlatformQuota":{ - "shape":"ResourceQuota", - "documentation":"

The quota for custom platforms in the AWS account.

" - } - }, - "documentation":"

A set of per-resource AWS Elastic Beanstalk quotas associated with an AWS account. They reflect Elastic Beanstalk resource limits for this account.

" - }, - "ResourceTagsDescriptionMessage":{ - "type":"structure", - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resouce for which a tag list was requested.

" - }, - "ResourceTags":{ - "shape":"TagList", - "documentation":"

A list of tag key-value pairs.

" - } - } - }, - "ResourceTypeNotSupportedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The type of the specified Amazon Resource Name (ARN) isn't supported for this operation.

", - "error":{ - "code":"ResourceTypeNotSupportedException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "RestartAppServerMessage":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to restart the server for.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to restart the server for.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - } - }, - "documentation":"

" - }, - "RetrieveEnvironmentInfoMessage":{ - "type":"structure", - "required":["InfoType"], - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the data's environment.

If no such environment is found, returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the data's environment.

If no such environment is found, returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "InfoType":{ - "shape":"EnvironmentInfoType", - "documentation":"

The type of information to retrieve.

" - } - }, - "documentation":"

Request to download logs retrieved with RequestEnvironmentInfo.

" - }, - "RetrieveEnvironmentInfoResultMessage":{ - "type":"structure", - "members":{ - "EnvironmentInfo":{ - "shape":"EnvironmentInfoDescriptionList", - "documentation":"

The EnvironmentInfoDescription of the environment.

" - } - }, - "documentation":"

Result message containing a description of the requested environment info.

" - }, - "S3Bucket":{ - "type":"string", - "max":255 - }, - "S3Key":{ - "type":"string", - "max":1024 - }, - "S3Location":{ - "type":"structure", - "members":{ - "S3Bucket":{ - "shape":"S3Bucket", - "documentation":"

The Amazon S3 bucket where the data is located.

" - }, - "S3Key":{ - "shape":"S3Key", - "documentation":"

The Amazon S3 key where the data is located.

" - } - }, - "documentation":"

The bucket and key of an item stored in Amazon S3.

" - }, - "S3LocationNotInServiceRegionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified S3 bucket does not belong to the S3 region in which the service is running. The following regions are supported:

  • IAD/us-east-1

  • PDX/us-west-2

  • DUB/eu-west-1

", - "error":{ - "code":"S3LocationNotInServiceRegionException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "S3SubscriptionRequiredException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account does not have a subscription to Amazon S3.

", - "error":{ - "code":"S3SubscriptionRequiredException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SampleTimestamp":{"type":"timestamp"}, - "SingleInstanceHealth":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the Amazon EC2 instance.

" - }, - "HealthStatus":{ - "shape":"String", - "documentation":"

Returns the health status of the specified instance. For more information, see Health Colors and Statuses.

" - }, - "Color":{ - "shape":"String", - "documentation":"

Represents the color indicator that gives you information about the health of the EC2 instance. For more information, see Health Colors and Statuses.

" - }, - "Causes":{ - "shape":"Causes", - "documentation":"

Represents the causes, which provide more information about the current health status.

" - }, - "LaunchedAt":{ - "shape":"LaunchedAt", - "documentation":"

The time at which the EC2 instance was launched.

" - }, - "ApplicationMetrics":{ - "shape":"ApplicationMetrics", - "documentation":"

Request metrics from your application.

" - }, - "System":{ - "shape":"SystemStatus", - "documentation":"

Operating system metrics from the instance.

" - }, - "Deployment":{ - "shape":"Deployment", - "documentation":"

Information about the most recent deployment to an instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The availability zone in which the instance runs.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance's type.

" - } - }, - "documentation":"

Detailed health information about an Amazon EC2 instance in your Elastic Beanstalk environment.

" - }, - "SolutionStackDescription":{ - "type":"structure", - "members":{ - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

The name of the solution stack.

" - }, - "PermittedFileTypes":{ - "shape":"SolutionStackFileTypeList", - "documentation":"

The permitted file types allowed for a solution stack.

" - } - }, - "documentation":"

Describes the solution stack.

" - }, - "SolutionStackFileTypeList":{ - "type":"list", - "member":{"shape":"FileTypeExtension"} - }, - "SolutionStackName":{"type":"string"}, - "SourceBuildInformation":{ - "type":"structure", - "required":[ - "SourceType", - "SourceRepository", - "SourceLocation" - ], - "members":{ - "SourceType":{ - "shape":"SourceType", - "documentation":"

The type of repository.

  • Git

  • Zip

" - }, - "SourceRepository":{ - "shape":"SourceRepository", - "documentation":"

Location where the repository is stored.

  • CodeCommit

  • S3

" - }, - "SourceLocation":{ - "shape":"SourceLocation", - "documentation":"

The location of the source code, as a formatted string, depending on the value of SourceRepository

  • For CodeCommit, the format is the repository name and commit ID, separated by a forward slash. For example, my-git-repo/265cfa0cf6af46153527f55d6503ec030551f57a.

  • For S3, the format is the S3 bucket name and object key, separated by a forward slash. For example, my-s3-bucket/Folders/my-source-file.

" - } - }, - "documentation":"

Location of the source code for an application version.

" - }, - "SourceBundleDeletionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Unable to delete the Amazon S3 source bundle associated with the application version. The application version was deleted successfully.

", - "error":{ - "code":"SourceBundleDeletionFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SourceConfiguration":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with the configuration.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template.

" - } - }, - "documentation":"

A specification for an environment configuration

" - }, - "SourceLocation":{ - "type":"string", - "max":255, - "min":3, - "pattern":".+/.+" - }, - "SourceRepository":{ - "type":"string", - "enum":[ - "CodeCommit", - "S3" - ] - }, - "SourceType":{ - "type":"string", - "enum":[ - "Git", - "Zip" - ] - }, - "StatusCodes":{ - "type":"structure", - "members":{ - "Status2xx":{ - "shape":"NullableInteger", - "documentation":"

The percentage of requests over the last 10 seconds that resulted in a 2xx (200, 201, etc.) status code.

" - }, - "Status3xx":{ - "shape":"NullableInteger", - "documentation":"

The percentage of requests over the last 10 seconds that resulted in a 3xx (300, 301, etc.) status code.

" - }, - "Status4xx":{ - "shape":"NullableInteger", - "documentation":"

The percentage of requests over the last 10 seconds that resulted in a 4xx (400, 401, etc.) status code.

" - }, - "Status5xx":{ - "shape":"NullableInteger", - "documentation":"

The percentage of requests over the last 10 seconds that resulted in a 5xx (500, 501, etc.) status code.

" - } - }, - "documentation":"

Represents the percentage of requests over the last 10 seconds that resulted in each type of status code response. For more information, see Status Code Definitions.

" - }, - "String":{"type":"string"}, - "SupportedAddon":{"type":"string"}, - "SupportedAddonList":{ - "type":"list", - "member":{"shape":"SupportedAddon"} - }, - "SupportedTier":{"type":"string"}, - "SupportedTierList":{ - "type":"list", - "member":{"shape":"SupportedTier"} - }, - "SwapEnvironmentCNAMEsMessage":{ - "type":"structure", - "members":{ - "SourceEnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the source environment.

Condition: You must specify at least the SourceEnvironmentID or the SourceEnvironmentName. You may also specify both. If you specify the SourceEnvironmentId, you must specify the DestinationEnvironmentId.

" - }, - "SourceEnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the source environment.

Condition: You must specify at least the SourceEnvironmentID or the SourceEnvironmentName. You may also specify both. If you specify the SourceEnvironmentName, you must specify the DestinationEnvironmentName.

" - }, - "DestinationEnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the destination environment.

Condition: You must specify at least the DestinationEnvironmentID or the DestinationEnvironmentName. You may also specify both. You must specify the SourceEnvironmentId with the DestinationEnvironmentId.

" - }, - "DestinationEnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the destination environment.

Condition: You must specify at least the DestinationEnvironmentID or the DestinationEnvironmentName. You may also specify both. You must specify the SourceEnvironmentName with the DestinationEnvironmentName.

" - } - }, - "documentation":"

Swaps the CNAMEs of two environments.

" - }, - "SystemStatus":{ - "type":"structure", - "members":{ - "CPUUtilization":{ - "shape":"CPUUtilization", - "documentation":"

CPU utilization metrics for the instance.

" - }, - "LoadAverage":{ - "shape":"LoadAverage", - "documentation":"

Load average in the last 1-minute, 5-minute, and 15-minute periods. For more information, see Operating System Metrics.

" - } - }, - "documentation":"

CPU utilization and load average metrics for an Amazon EC2 instance.

" - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Describes a tag applied to a resource in an environment.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1 - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TerminateEnvForce":{"type":"boolean"}, - "TerminateEnvironmentMessage":{ - "type":"structure", - "members":{ - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to terminate.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to terminate.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "TerminateResources":{ - "shape":"TerminateEnvironmentResources", - "documentation":"

Indicates whether the associated AWS resources should shut down when the environment is terminated:

  • true: The specified environment as well as the associated AWS resources, such as Auto Scaling group and LoadBalancer, are terminated.

  • false: AWS Elastic Beanstalk resource management is removed from the environment, but the AWS resources continue to operate.

For more information, see the AWS Elastic Beanstalk User Guide.

Default: true

Valid Values: true | false

" - }, - "ForceTerminate":{ - "shape":"ForceTerminate", - "documentation":"

Terminates the target environment even if another environment in the same group is dependent on it.

" - } - }, - "documentation":"

Request to terminate an environment.

" - }, - "TerminateEnvironmentResources":{"type":"boolean"}, - "TimeFilterEnd":{"type":"timestamp"}, - "TimeFilterStart":{"type":"timestamp"}, - "Timestamp":{"type":"timestamp"}, - "Token":{"type":"string"}, - "TooManyApplicationVersionsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account has reached its limit of application versions.

", - "exception":true - }, - "TooManyApplicationsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account has reached its limit of applications.

", - "error":{ - "code":"TooManyApplicationsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyBucketsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account has reached its limit of Amazon S3 buckets.

", - "error":{ - "code":"TooManyBucketsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyConfigurationTemplatesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account has reached its limit of configuration templates.

", - "error":{ - "code":"TooManyConfigurationTemplatesException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyEnvironmentsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified account has reached its limit of environments.

", - "error":{ - "code":"TooManyEnvironmentsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyPlatformsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of allowed platforms associated with the account.

", - "error":{ - "code":"TooManyPlatformsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of tags in the resource would exceed the number of tags that each resource can have.

To calculate this, the operation considers both the number of tags the resource already has and the tags this operation would add if it succeeded.

", - "error":{ - "code":"TooManyTagsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Trigger":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ResourceId", - "documentation":"

The name of the trigger.

" - } - }, - "documentation":"

Describes a trigger.

" - }, - "TriggerList":{ - "type":"list", - "member":{"shape":"Trigger"} - }, - "UpdateApplicationMessage":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application to update. If no such application is found, UpdateApplication returns an InvalidParameterValue error.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A new description for the application.

Default: If not specified, AWS Elastic Beanstalk does not update the description.

" - } - }, - "documentation":"

Request to update an application.

" - }, - "UpdateApplicationResourceLifecycleMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "ResourceLifecycleConfig" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application.

" - }, - "ResourceLifecycleConfig":{ - "shape":"ApplicationResourceLifecycleConfig", - "documentation":"

The lifecycle configuration.

" - } - } - }, - "UpdateApplicationVersionMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "VersionLabel" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with this version.

If no application is found with this name, UpdateApplication returns an InvalidParameterValue error.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

The name of the version to update.

If no application version is found with this label, UpdateApplication returns an InvalidParameterValue error.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A new description for this version.

" - } - }, - "documentation":"

" - }, - "UpdateConfigurationTemplateMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "TemplateName" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application associated with the configuration template to update.

If no application is found with this name, UpdateConfigurationTemplate returns an InvalidParameterValue error.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template to update.

If no configuration template is found with this name, UpdateConfigurationTemplate returns an InvalidParameterValue error.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A new description for the configuration.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

A list of configuration option settings to update with the new specified option value.

" - }, - "OptionsToRemove":{ - "shape":"OptionsSpecifierList", - "documentation":"

A list of configuration options to remove from the configuration set.

Constraint: You can remove only UserDefined configuration options.

" - } - }, - "documentation":"

The result message containing the options for the specified solution stack.

" - }, - "UpdateDate":{"type":"timestamp"}, - "UpdateEnvironmentMessage":{ - "type":"structure", - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application with which the environment is associated.

" - }, - "EnvironmentId":{ - "shape":"EnvironmentId", - "documentation":"

The ID of the environment to update.

If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error.

Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.

" - }, - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the group to which the target environment belongs. Specify a group name only if the environment's name is specified in an environment manifest and not with the environment name or environment ID parameters. See Environment Manifest (env.yaml) for details.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment.

" - }, - "Tier":{ - "shape":"EnvironmentTier", - "documentation":"

This specifies the tier to use to update the environment.

Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error.

" - }, - "VersionLabel":{ - "shape":"VersionLabel", - "documentation":"

If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error.

" - }, - "SolutionStackName":{ - "shape":"SolutionStackName", - "documentation":"

This specifies the platform version that the environment will run after the environment is updated.

" - }, - "PlatformArn":{ - "shape":"PlatformArn", - "documentation":"

The ARN of the platform, if used.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value.

" - }, - "OptionsToRemove":{ - "shape":"OptionsSpecifierList", - "documentation":"

A list of custom user-defined configuration options to remove from the configuration set for this environment.

" - } - }, - "documentation":"

Request to update an environment.

" - }, - "UpdateTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resouce to be updated.

Must be the ARN of an Elastic Beanstalk environment.

" - }, - "TagsToAdd":{ - "shape":"TagList", - "documentation":"

A list of tags to add or update.

If a key of an existing tag is added, the tag's value is updated.

" - }, - "TagsToRemove":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys to remove.

If a tag key doesn't exist, it is silently ignored.

" - } - } - }, - "UserDefinedOption":{"type":"boolean"}, - "ValidateConfigurationSettingsMessage":{ - "type":"structure", - "required":[ - "ApplicationName", - "OptionSettings" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The name of the application that the configuration template or environment belongs to.

" - }, - "TemplateName":{ - "shape":"ConfigurationTemplateName", - "documentation":"

The name of the configuration template to validate the settings against.

Condition: You cannot specify both this and an environment name.

" - }, - "EnvironmentName":{ - "shape":"EnvironmentName", - "documentation":"

The name of the environment to validate the settings against.

Condition: You cannot specify both this and a configuration template name.

" - }, - "OptionSettings":{ - "shape":"ConfigurationOptionSettingsList", - "documentation":"

A list of the options and desired values to evaluate.

" - } - }, - "documentation":"

A list of validation messages for a specified configuration template.

" - }, - "ValidationMessage":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"ValidationMessageString", - "documentation":"

A message describing the error or warning.

" - }, - "Severity":{ - "shape":"ValidationSeverity", - "documentation":"

An indication of the severity of this message:

  • error: This message indicates that this is not a valid setting for an option.

  • warning: This message is providing information you should take into account.

" - }, - "Namespace":{ - "shape":"OptionNamespace", - "documentation":"

The namespace to which the option belongs.

" - }, - "OptionName":{ - "shape":"ConfigurationOptionName", - "documentation":"

The name of the option.

" - } - }, - "documentation":"

An error or warning for a desired configuration option value.

" - }, - "ValidationMessageString":{"type":"string"}, - "ValidationMessagesList":{ - "type":"list", - "member":{"shape":"ValidationMessage"} - }, - "ValidationSeverity":{ - "type":"string", - "enum":[ - "error", - "warning" - ] - }, - "VersionLabel":{ - "type":"string", - "max":100, - "min":1 - }, - "VersionLabels":{ - "type":"list", - "member":{"shape":"VersionLabel"} - }, - "VersionLabelsList":{ - "type":"list", - "member":{"shape":"VersionLabel"} - }, - "VirtualizationType":{"type":"string"} - }, - "documentation":"AWS Elastic Beanstalk

AWS Elastic Beanstalk makes it easy for you to create, deploy, and manage scalable, fault-tolerant applications running on the Amazon Web Services cloud.

For more information about this product, go to the AWS Elastic Beanstalk details page. The location of the latest AWS Elastic Beanstalk WSDL is http://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl. To install the Software Development Kits (SDKs), Integrated Development Environment (IDE) Toolkits, and command line tools that enable you to access the API, go to Tools for Amazon Web Services.

Endpoints

For a list of region-specific endpoints that AWS Elastic Beanstalk supports, go to Regions and Endpoints in the Amazon Web Services Glossary.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/paginators-1.json deleted file mode 100644 index 5a145d36..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/paginators-1.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "pagination": { - "ListJobsByPipeline": { - "input_token": "PageToken", - "output_token": "NextPageToken", - "result_key": "Jobs" - }, - "ListJobsByStatus": { - "input_token": "PageToken", - "output_token": "NextPageToken", - "result_key": "Jobs" - }, - "ListPipelines": { - "input_token": "PageToken", - "output_token": "NextPageToken", - "result_key": "Pipelines" - }, - "ListPresets": { - "input_token": "PageToken", - "output_token": "NextPageToken", - "result_key": "Presets" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/service-2.json deleted file mode 100644 index a213f9aa..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/service-2.json +++ /dev/null @@ -1,2337 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"elastictranscoder-2012-09-25", - "apiVersion":"2012-09-25", - "endpointPrefix":"elastictranscoder", - "protocol":"rest-json", - "serviceFullName":"Amazon Elastic Transcoder", - "serviceId":"Elastic Transcoder", - "signatureVersion":"v4" - }, - "operations":{ - "CancelJob":{ - "name":"CancelJob", - "http":{ - "method":"DELETE", - "requestUri":"/2012-09-25/jobs/{Id}", - "responseCode":202 - }, - "input":{"shape":"CancelJobRequest"}, - "output":{"shape":"CancelJobResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The CancelJob operation cancels an unfinished job.

You can only cancel a job that has a status of Submitted. To prevent a pipeline from starting to process a job while you're getting the job identifier, use UpdatePipelineStatus to temporarily pause the pipeline.

" - }, - "CreateJob":{ - "name":"CreateJob", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/jobs", - "responseCode":201 - }, - "input":{"shape":"CreateJobRequest"}, - "output":{"shape":"CreateJobResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

When you create a job, Elastic Transcoder returns JSON data that includes the values that you specified plus information about the job that is created.

If you have specified more than one output for your jobs (for example, one output for the Kindle Fire and another output for the Apple iPhone 4s), you currently must use the Elastic Transcoder API to list the jobs (as opposed to the AWS Console).

" - }, - "CreatePipeline":{ - "name":"CreatePipeline", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/pipelines", - "responseCode":201 - }, - "input":{"shape":"CreatePipelineRequest"}, - "output":{"shape":"CreatePipelineResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The CreatePipeline operation creates a pipeline with settings that you specify.

" - }, - "CreatePreset":{ - "name":"CreatePreset", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/presets", - "responseCode":201 - }, - "input":{"shape":"CreatePresetRequest"}, - "output":{"shape":"CreatePresetResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"AccessDeniedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The CreatePreset operation creates a preset with settings that you specify.

Elastic Transcoder checks the CreatePreset settings to ensure that they meet Elastic Transcoder requirements and to determine whether they comply with H.264 standards. If your settings are not valid for Elastic Transcoder, Elastic Transcoder returns an HTTP 400 response (ValidationException) and does not create the preset. If the settings are valid for Elastic Transcoder but aren't strictly compliant with the H.264 standard, Elastic Transcoder creates the preset and returns a warning message in the response. This helps you determine whether your settings comply with the H.264 standard while giving you greater flexibility with respect to the video that Elastic Transcoder produces.

Elastic Transcoder uses the H.264 video-compression format. For more information, see the International Telecommunication Union publication Recommendation ITU-T H.264: Advanced video coding for generic audiovisual services.

" - }, - "DeletePipeline":{ - "name":"DeletePipeline", - "http":{ - "method":"DELETE", - "requestUri":"/2012-09-25/pipelines/{Id}", - "responseCode":202 - }, - "input":{"shape":"DeletePipelineRequest"}, - "output":{"shape":"DeletePipelineResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The DeletePipeline operation removes a pipeline.

You can only delete a pipeline that has never been used or that is not currently in use (doesn't contain any active jobs). If the pipeline is currently in use, DeletePipeline returns an error.

" - }, - "DeletePreset":{ - "name":"DeletePreset", - "http":{ - "method":"DELETE", - "requestUri":"/2012-09-25/presets/{Id}", - "responseCode":202 - }, - "input":{"shape":"DeletePresetRequest"}, - "output":{"shape":"DeletePresetResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The DeletePreset operation removes a preset that you've added in an AWS region.

You can't delete the default presets that are included with Elastic Transcoder.

" - }, - "ListJobsByPipeline":{ - "name":"ListJobsByPipeline", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/jobsByPipeline/{PipelineId}" - }, - "input":{"shape":"ListJobsByPipelineRequest"}, - "output":{"shape":"ListJobsByPipelineResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ListJobsByPipeline operation gets a list of the jobs currently in a pipeline.

Elastic Transcoder returns all of the jobs currently in the specified pipeline. The response body contains one element for each job that satisfies the search criteria.

" - }, - "ListJobsByStatus":{ - "name":"ListJobsByStatus", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/jobsByStatus/{Status}" - }, - "input":{"shape":"ListJobsByStatusRequest"}, - "output":{"shape":"ListJobsByStatusResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ListJobsByStatus operation gets a list of jobs that have a specified status. The response body contains one element for each job that satisfies the search criteria.

" - }, - "ListPipelines":{ - "name":"ListPipelines", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/pipelines" - }, - "input":{"shape":"ListPipelinesRequest"}, - "output":{"shape":"ListPipelinesResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ListPipelines operation gets a list of the pipelines associated with the current AWS account.

" - }, - "ListPresets":{ - "name":"ListPresets", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/presets" - }, - "input":{"shape":"ListPresetsRequest"}, - "output":{"shape":"ListPresetsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ListPresets operation gets a list of the default presets included with Elastic Transcoder and the presets that you've added in an AWS region.

" - }, - "ReadJob":{ - "name":"ReadJob", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/jobs/{Id}" - }, - "input":{"shape":"ReadJobRequest"}, - "output":{"shape":"ReadJobResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ReadJob operation returns detailed information about a job.

" - }, - "ReadPipeline":{ - "name":"ReadPipeline", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/pipelines/{Id}" - }, - "input":{"shape":"ReadPipelineRequest"}, - "output":{"shape":"ReadPipelineResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ReadPipeline operation gets detailed information about a pipeline.

" - }, - "ReadPreset":{ - "name":"ReadPreset", - "http":{ - "method":"GET", - "requestUri":"/2012-09-25/presets/{Id}" - }, - "input":{"shape":"ReadPresetRequest"}, - "output":{"shape":"ReadPresetResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The ReadPreset operation gets detailed information about a preset.

" - }, - "TestRole":{ - "name":"TestRole", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/roleTests", - "responseCode":200 - }, - "input":{"shape":"TestRoleRequest"}, - "output":{"shape":"TestRoleResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The TestRole operation tests the IAM role used to create the pipeline.

The TestRole action lets you determine whether the IAM role you are using has sufficient permissions to let Elastic Transcoder perform tasks associated with the transcoding process. The action attempts to assume the specified IAM role, checks read access to the input and output buckets, and tries to send a test notification to Amazon SNS topics that you specify.

", - "deprecated":true - }, - "UpdatePipeline":{ - "name":"UpdatePipeline", - "http":{ - "method":"PUT", - "requestUri":"/2012-09-25/pipelines/{Id}", - "responseCode":200 - }, - "input":{"shape":"UpdatePipelineRequest"}, - "output":{"shape":"UpdatePipelineResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Use the UpdatePipeline operation to update settings for a pipeline.

When you change pipeline settings, your changes take effect immediately. Jobs that you have already submitted and that Elastic Transcoder has not started to process are affected in addition to jobs that you submit after you change settings.

" - }, - "UpdatePipelineNotifications":{ - "name":"UpdatePipelineNotifications", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/pipelines/{Id}/notifications" - }, - "input":{"shape":"UpdatePipelineNotificationsRequest"}, - "output":{"shape":"UpdatePipelineNotificationsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

With the UpdatePipelineNotifications operation, you can update Amazon Simple Notification Service (Amazon SNS) notifications for a pipeline.

When you update notifications for a pipeline, Elastic Transcoder returns the values that you specified in the request.

" - }, - "UpdatePipelineStatus":{ - "name":"UpdatePipelineStatus", - "http":{ - "method":"POST", - "requestUri":"/2012-09-25/pipelines/{Id}/status" - }, - "input":{"shape":"UpdatePipelineStatusRequest"}, - "output":{"shape":"UpdatePipelineStatusResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"IncompatibleVersionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

The UpdatePipelineStatus operation pauses or reactivates a pipeline, so that the pipeline stops or restarts the processing of jobs.

Changing the pipeline status is useful if you want to cancel one or more jobs. You can't cancel jobs after Elastic Transcoder has started processing them; if you pause the pipeline to which you submitted the jobs, you have more time to get the job IDs for the jobs that you want to cancel, and to send a CancelJob request.

" - } - }, - "shapes":{ - "AccessControl":{ - "type":"string", - "pattern":"(^FullControl$)|(^Read$)|(^ReadAcp$)|(^WriteAcp$)" - }, - "AccessControls":{ - "type":"list", - "member":{"shape":"AccessControl"}, - "max":30 - }, - "AccessDeniedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

General authentication failure. The request was not signed correctly.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "Artwork":{ - "type":"structure", - "members":{ - "InputKey":{ - "shape":"WatermarkKey", - "documentation":"

The name of the file to be used as album art. To determine which Amazon S3 bucket contains the specified file, Elastic Transcoder checks the pipeline specified by PipelineId; the InputBucket object in that pipeline identifies the bucket.

If the file name includes a prefix, for example, cooking/pie.jpg, include the prefix in the key. If the file isn't in the specified bucket, Elastic Transcoder returns an error.

" - }, - "MaxWidth":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum width of the output album art in pixels. If you specify auto, Elastic Transcoder uses 600 as the default value. If you specify a numeric value, enter an even integer between 32 and 4096, inclusive.

" - }, - "MaxHeight":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum height of the output album art in pixels. If you specify auto, Elastic Transcoder uses 600 as the default value. If you specify a numeric value, enter an even integer between 32 and 3072, inclusive.

" - }, - "SizingPolicy":{ - "shape":"SizingPolicy", - "documentation":"

Specify one of the following values to control scaling of the output album art:

  • Fit: Elastic Transcoder scales the output art so it matches the value that you specified in either MaxWidth or MaxHeight without exceeding the other value.

  • Fill: Elastic Transcoder scales the output art so it matches the value that you specified in either MaxWidth or MaxHeight and matches or exceeds the other value. Elastic Transcoder centers the output art and then crops it in the dimension (if any) that exceeds the maximum value.

  • Stretch: Elastic Transcoder stretches the output art to match the values that you specified for MaxWidth and MaxHeight. If the relative proportions of the input art and the output art are different, the output art will be distorted.

  • Keep: Elastic Transcoder does not scale the output art. If either dimension of the input art exceeds the values that you specified for MaxWidth and MaxHeight, Elastic Transcoder crops the output art.

  • ShrinkToFit: Elastic Transcoder scales the output art down so that its dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale the art up.

  • ShrinkToFill Elastic Transcoder scales the output art down so that its dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without dropping below either value. If you specify this option, Elastic Transcoder does not scale the art up.

" - }, - "PaddingPolicy":{ - "shape":"PaddingPolicy", - "documentation":"

When you set PaddingPolicy to Pad, Elastic Transcoder may add white bars to the top and bottom and/or left and right sides of the output album art to make the total size of the output art match the values that you specified for MaxWidth and MaxHeight.

" - }, - "AlbumArtFormat":{ - "shape":"JpgOrPng", - "documentation":"

The format of album art, if any. Valid formats are .jpg and .png.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your artwork.

" - } - }, - "documentation":"

The file to be used as album art. There can be multiple artworks associated with an audio file, to a maximum of 20.

To remove artwork or leave the artwork empty, you can either set Artwork to null, or set the Merge Policy to \"Replace\" and use an empty Artwork array.

To pass through existing artwork unchanged, set the Merge Policy to \"Prepend\", \"Append\", or \"Fallback\", and use an empty Artwork array.

" - }, - "Artworks":{ - "type":"list", - "member":{"shape":"Artwork"} - }, - "Ascending":{ - "type":"string", - "pattern":"(^true$)|(^false$)" - }, - "AspectRatio":{ - "type":"string", - "pattern":"(^auto$)|(^1:1$)|(^4:3$)|(^3:2$)|(^16:9$)" - }, - "AudioBitDepth":{ - "type":"string", - "pattern":"(^8$)|(^16$)|(^24$)|(^32$)" - }, - "AudioBitOrder":{ - "type":"string", - "pattern":"(^LittleEndian$)" - }, - "AudioBitRate":{ - "type":"string", - "pattern":"^\\d{1,3}$" - }, - "AudioChannels":{ - "type":"string", - "pattern":"(^auto$)|(^0$)|(^1$)|(^2$)" - }, - "AudioCodec":{ - "type":"string", - "pattern":"(^AAC$)|(^vorbis$)|(^mp3$)|(^mp2$)|(^pcm$)|(^flac$)" - }, - "AudioCodecOptions":{ - "type":"structure", - "members":{ - "Profile":{ - "shape":"AudioCodecProfile", - "documentation":"

You can only choose an audio profile when you specify AAC for the value of Audio:Codec.

Specify the AAC profile for the output file. Elastic Transcoder supports the following profiles:

  • auto: If you specify auto, Elastic Transcoder selects the profile based on the bit rate selected for the output file.

  • AAC-LC: The most common AAC profile. Use for bit rates larger than 64 kbps.

  • HE-AAC: Not supported on some older players and devices. Use for bit rates between 40 and 80 kbps.

  • HE-AACv2: Not supported on some players and devices. Use for bit rates less than 48 kbps.

All outputs in a Smooth playlist must have the same value for Profile.

If you created any presets before AAC profiles were added, Elastic Transcoder automatically updated your presets to use AAC-LC. You can change the value as required.

" - }, - "BitDepth":{ - "shape":"AudioBitDepth", - "documentation":"

You can only choose an audio bit depth when you specify flac or pcm for the value of Audio:Codec.

The bit depth of a sample is how many bits of information are included in the audio samples. The higher the bit depth, the better the audio, but the larger the file.

Valid values are 16 and 24.

The most common bit depth is 24.

" - }, - "BitOrder":{ - "shape":"AudioBitOrder", - "documentation":"

You can only choose an audio bit order when you specify pcm for the value of Audio:Codec.

The order the bits of a PCM sample are stored in.

The supported value is LittleEndian.

" - }, - "Signed":{ - "shape":"AudioSigned", - "documentation":"

You can only choose whether an audio sample is signed when you specify pcm for the value of Audio:Codec.

Whether audio samples are represented with negative and positive numbers (signed) or only positive numbers (unsigned).

The supported value is Signed.

" - } - }, - "documentation":"

Options associated with your audio codec.

" - }, - "AudioCodecProfile":{ - "type":"string", - "pattern":"(^auto$)|(^AAC-LC$)|(^HE-AAC$)|(^HE-AACv2$)" - }, - "AudioPackingMode":{ - "type":"string", - "pattern":"(^SingleTrack$)|(^OneChannelPerTrack$)|(^OneChannelPerTrackWithMosTo8Tracks$)" - }, - "AudioParameters":{ - "type":"structure", - "members":{ - "Codec":{ - "shape":"AudioCodec", - "documentation":"

The audio codec for the output file. Valid values include aac, flac, mp2, mp3, pcm, and vorbis.

" - }, - "SampleRate":{ - "shape":"AudioSampleRate", - "documentation":"

The sample rate of the audio stream in the output file, in Hertz. Valid values include:

auto, 22050, 32000, 44100, 48000, 96000

If you specify auto, Elastic Transcoder automatically detects the sample rate.

" - }, - "BitRate":{ - "shape":"AudioBitRate", - "documentation":"

The bit rate of the audio stream in the output file, in kilobits/second. Enter an integer between 64 and 320, inclusive.

" - }, - "Channels":{ - "shape":"AudioChannels", - "documentation":"

The number of audio channels in the output file. The following values are valid:

auto, 0, 1, 2

One channel carries the information played by a single speaker. For example, a stereo track with two channels sends one channel to the left speaker, and the other channel to the right speaker. The output channels are organized into tracks. If you want Elastic Transcoder to automatically detect the number of audio channels in the input file and use that value for the output file, select auto.

The output of a specific channel value and inputs are as follows:

  • auto channel specified, with any input: Pass through up to eight input channels.

  • 0 channels specified, with any input: Audio omitted from the output.

  • 1 channel specified, with at least one input channel: Mono sound.

  • 2 channels specified, with any input: Two identical mono channels or stereo. For more information about tracks, see Audio:AudioPackingMode.

For more information about how Elastic Transcoder organizes channels and tracks, see Audio:AudioPackingMode.

" - }, - "AudioPackingMode":{ - "shape":"AudioPackingMode", - "documentation":"

The method of organizing audio channels and tracks. Use Audio:Channels to specify the number of channels in your output, and Audio:AudioPackingMode to specify the number of tracks and their relation to the channels. If you do not specify an Audio:AudioPackingMode, Elastic Transcoder uses SingleTrack.

The following values are valid:

SingleTrack, OneChannelPerTrack, and OneChannelPerTrackWithMosTo8Tracks

When you specify SingleTrack, Elastic Transcoder creates a single track for your output. The track can have up to eight channels. Use SingleTrack for all non-mxf containers.

The outputs of SingleTrack for a specific channel value and inputs are as follows:

  • 0 channels with any input: Audio omitted from the output

  • 1, 2, or auto channels with no audio input: Audio omitted from the output

  • 1 channel with any input with audio: One track with one channel, downmixed if necessary

  • 2 channels with one track with one channel: One track with two identical channels

  • 2 or auto channels with two tracks with one channel each: One track with two channels

  • 2 or auto channels with one track with two channels: One track with two channels

  • 2 channels with one track with multiple channels: One track with two channels

  • auto channels with one track with one channel: One track with one channel

  • auto channels with one track with multiple channels: One track with multiple channels

When you specify OneChannelPerTrack, Elastic Transcoder creates a new track for every channel in your output. Your output can have up to eight single-channel tracks.

The outputs of OneChannelPerTrack for a specific channel value and inputs are as follows:

  • 0 channels with any input: Audio omitted from the output

  • 1, 2, or auto channels with no audio input: Audio omitted from the output

  • 1 channel with any input with audio: One track with one channel, downmixed if necessary

  • 2 channels with one track with one channel: Two tracks with one identical channel each

  • 2 or auto channels with two tracks with one channel each: Two tracks with one channel each

  • 2 or auto channels with one track with two channels: Two tracks with one channel each

  • 2 channels with one track with multiple channels: Two tracks with one channel each

  • auto channels with one track with one channel: One track with one channel

  • auto channels with one track with multiple channels: Up to eight tracks with one channel each

When you specify OneChannelPerTrackWithMosTo8Tracks, Elastic Transcoder creates eight single-channel tracks for your output. All tracks that do not contain audio data from an input channel are MOS, or Mit Out Sound, tracks.

The outputs of OneChannelPerTrackWithMosTo8Tracks for a specific channel value and inputs are as follows:

  • 0 channels with any input: Audio omitted from the output

  • 1, 2, or auto channels with no audio input: Audio omitted from the output

  • 1 channel with any input with audio: One track with one channel, downmixed if necessary, plus six MOS tracks

  • 2 channels with one track with one channel: Two tracks with one identical channel each, plus six MOS tracks

  • 2 or auto channels with two tracks with one channel each: Two tracks with one channel each, plus six MOS tracks

  • 2 or auto channels with one track with two channels: Two tracks with one channel each, plus six MOS tracks

  • 2 channels with one track with multiple channels: Two tracks with one channel each, plus six MOS tracks

  • auto channels with one track with one channel: One track with one channel, plus seven MOS tracks

  • auto channels with one track with multiple channels: Up to eight tracks with one channel each, plus MOS tracks until there are eight tracks in all

" - }, - "CodecOptions":{ - "shape":"AudioCodecOptions", - "documentation":"

If you specified AAC for Audio:Codec, this is the AAC compression profile to use. Valid values include:

auto, AAC-LC, HE-AAC, HE-AACv2

If you specify auto, Elastic Transcoder chooses a profile based on the bit rate of the output file.

" - } - }, - "documentation":"

Parameters required for transcoding audio.

" - }, - "AudioSampleRate":{ - "type":"string", - "pattern":"(^auto$)|(^22050$)|(^32000$)|(^44100$)|(^48000$)|(^96000$)|(^192000$)" - }, - "AudioSigned":{ - "type":"string", - "pattern":"(^Unsigned$)|(^Signed$)" - }, - "Base64EncodedString":{ - "type":"string", - "pattern":"^$|(^(?:[A-Za-z0-9\\+/]{4})*(?:[A-Za-z0-9\\+/]{2}==|[A-Za-z0-9\\+/]{3}=)?$)" - }, - "BucketName":{ - "type":"string", - "pattern":"^(\\w|\\.|-){1,255}$" - }, - "CancelJobRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the job that you want to cancel.

To get a list of the jobs (including their jobId) that have a status of Submitted, use the ListJobsByStatus API action.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The CancelJobRequest structure.

" - }, - "CancelJobResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response body contains a JSON object. If the job is successfully canceled, the value of Success is true.

" - }, - "CaptionFormat":{ - "type":"structure", - "members":{ - "Format":{ - "shape":"CaptionFormatFormat", - "documentation":"

The format you specify determines whether Elastic Transcoder generates an embedded or sidecar caption for this output.

  • Valid Embedded Caption Formats:

    • for FLAC: None

    • For MP3: None

    • For MP4: mov-text

    • For MPEG-TS: None

    • For ogg: None

    • For webm: None

  • Valid Sidecar Caption Formats: Elastic Transcoder supports dfxp (first div element only), scc, srt, and webvtt. If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.

    • For FMP4: dfxp

    • Non-FMP4 outputs: All sidecar types

    fmp4 captions have an extension of .ismt

" - }, - "Pattern":{ - "shape":"CaptionFormatPattern", - "documentation":"

The prefix for caption filenames, in the form description-{language}, where:

  • description is a description of the video.

  • {language} is a literal value that Elastic Transcoder replaces with the two- or three-letter code for the language of the caption in the output file names.

If you don't include {language} in the file name pattern, Elastic Transcoder automatically appends \"{language}\" to the value that you specify for the description. In addition, Elastic Transcoder automatically appends the count to the end of the segment files.

For example, suppose you're transcoding into srt format. When you enter \"Sydney-{language}-sunrise\", and the language of the captions is English (en), the name of the first caption file is be Sydney-en-sunrise00000.srt.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your caption formats.

" - } - }, - "documentation":"

The file format of the output captions. If you leave this value blank, Elastic Transcoder returns an error.

" - }, - "CaptionFormatFormat":{ - "type":"string", - "pattern":"(^mov-text$)|(^srt$)|(^scc$)|(^webvtt$)|(^dfxp$)|(^cea-708$)" - }, - "CaptionFormatPattern":{ - "type":"string", - "pattern":"(^$)|(^.*\\{language\\}.*$)" - }, - "CaptionFormats":{ - "type":"list", - "member":{"shape":"CaptionFormat"}, - "max":4 - }, - "CaptionMergePolicy":{ - "type":"string", - "pattern":"(^MergeOverride$)|(^MergeRetain$)|(^Override$)" - }, - "CaptionSource":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"LongKey", - "documentation":"

The name of the sidecar caption file that you want Elastic Transcoder to include in the output file.

" - }, - "Language":{ - "shape":"Key", - "documentation":"

A string that specifies the language of the caption. If you specified multiple inputs with captions, the caption language must match in order to be included in the output. Specify this as one of:

  • 2-character ISO 639-1 code

  • 3-character ISO 639-2 code

For more information on ISO language codes and language names, see the List of ISO 639-1 codes.

" - }, - "TimeOffset":{ - "shape":"TimeOffset", - "documentation":"

For clip generation or captions that do not start at the same time as the associated video file, the TimeOffset tells Elastic Transcoder how much of the video to encode before including captions.

Specify the TimeOffset in the form [+-]SS.sss or [+-]HH:mm:SS.ss.

" - }, - "Label":{ - "shape":"Name", - "documentation":"

The label of the caption shown in the player when choosing a language. We recommend that you put the caption language name here, in the language of the captions.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that Elastic Transcoder needs to decyrpt your caption sources, or that you want Elastic Transcoder to apply to your caption sources.

" - } - }, - "documentation":"

A source file for the input sidecar captions used during the transcoding process.

" - }, - "CaptionSources":{ - "type":"list", - "member":{"shape":"CaptionSource"}, - "max":20 - }, - "Captions":{ - "type":"structure", - "members":{ - "MergePolicy":{ - "shape":"CaptionMergePolicy", - "documentation":"

A policy that determines how Elastic Transcoder handles the existence of multiple captions.

  • MergeOverride: Elastic Transcoder transcodes both embedded and sidecar captions into outputs. If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the sidecar captions and ignores the embedded captions for that language.

  • MergeRetain: Elastic Transcoder transcodes both embedded and sidecar captions into outputs. If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the embedded captions and ignores the sidecar captions for that language. If CaptionSources is empty, Elastic Transcoder omits all sidecar captions from the output files.

  • Override: Elastic Transcoder transcodes only the sidecar captions that you specify in CaptionSources.

MergePolicy cannot be null.

", - "deprecated":true - }, - "CaptionSources":{ - "shape":"CaptionSources", - "documentation":"

Source files for the input sidecar captions used during the transcoding process. To omit all sidecar captions, leave CaptionSources blank.

", - "deprecated":true - }, - "CaptionFormats":{ - "shape":"CaptionFormats", - "documentation":"

The array of file formats for the output captions. If you leave this value blank, Elastic Transcoder returns an error.

" - } - }, - "documentation":"

The captions to be created, if any.

" - }, - "Clip":{ - "type":"structure", - "members":{ - "TimeSpan":{ - "shape":"TimeSpan", - "documentation":"

Settings that determine when a clip begins and how long it lasts.

" - } - }, - "documentation":"

Settings for one clip in a composition. All jobs in a playlist must have the same clip settings.

", - "deprecated":true - }, - "CodecOption":{ - "type":"string", - "max":255, - "min":1 - }, - "CodecOptions":{ - "type":"map", - "key":{"shape":"CodecOption"}, - "value":{"shape":"CodecOption"}, - "max":30 - }, - "Composition":{ - "type":"list", - "member":{"shape":"Clip"}, - "deprecated":true - }, - "CreateJobOutput":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"Key", - "documentation":"

The name to assign to the transcoded file. Elastic Transcoder saves the file in the Amazon S3 bucket specified by the OutputBucket object in the pipeline that is specified by the pipeline ID. If a file with the specified name already exists in the output bucket, the job fails.

" - }, - "ThumbnailPattern":{ - "shape":"ThumbnailPattern", - "documentation":"

Whether you want Elastic Transcoder to create thumbnails for your videos and, if so, how you want Elastic Transcoder to name the files.

If you don't want Elastic Transcoder to create thumbnails, specify \"\".

If you do want Elastic Transcoder to create thumbnails, specify the information that you want to include in the file name for each thumbnail. You can specify the following values in any sequence:

  • {count} (Required): If you want to create thumbnails, you must include {count} in the ThumbnailPattern object. Wherever you specify {count}, Elastic Transcoder adds a five-digit sequence number (beginning with 00001) to thumbnail file names. The number indicates where a given thumbnail appears in the sequence of thumbnails for a transcoded file.

    If you specify a literal value and/or {resolution} but you omit {count}, Elastic Transcoder returns a validation error and does not create the job.

  • Literal values (Optional): You can specify literal values anywhere in the ThumbnailPattern object. For example, you can include them as a file name prefix or as a delimiter between {resolution} and {count}.

  • {resolution} (Optional): If you want Elastic Transcoder to include the resolution in the file name, include {resolution} in the ThumbnailPattern object.

When creating thumbnails, Elastic Transcoder automatically saves the files in the format (.jpg or .png) that appears in the preset that you specified in the PresetID value of CreateJobOutput. Elastic Transcoder also appends the applicable file name extension.

" - }, - "ThumbnailEncryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your thumbnail.

" - }, - "Rotate":{ - "shape":"Rotate", - "documentation":"

The number of degrees clockwise by which you want Elastic Transcoder to rotate the output relative to the input. Enter one of the following values: auto, 0, 90, 180, 270. The value auto generally works only if the file that you're transcoding contains rotation metadata.

" - }, - "PresetId":{ - "shape":"Id", - "documentation":"

The Id of the preset to use for this job. The preset determines the audio, video, and thumbnail settings that Elastic Transcoder uses for transcoding.

" - }, - "SegmentDuration":{ - "shape":"FloatString", - "documentation":"

(Outputs in Fragmented MP4 or MPEG-TS format only.

If you specify a preset in PresetId for which the value of Container is fmp4 (Fragmented MP4) or ts (MPEG-TS), SegmentDuration is the target maximum duration of each segment in seconds. For HLSv3 format playlists, each media segment is stored in a separate .ts file. For HLSv4 and Smooth playlists, all media segments for an output are stored in a single file. Each segment is approximately the length of the SegmentDuration, though individual segments might be shorter or longer.

The range of valid values is 1 to 60 seconds. If the duration of the video is not evenly divisible by SegmentDuration, the duration of the last segment is the remainder of total length/SegmentDuration.

Elastic Transcoder creates an output-specific playlist for each output HLS output that you specify in OutputKeys. To add an output to the master playlist for this job, include it in the OutputKeys of the associated playlist.

" - }, - "Watermarks":{ - "shape":"JobWatermarks", - "documentation":"

Information about the watermarks that you want Elastic Transcoder to add to the video during transcoding. You can specify up to four watermarks for each output. Settings for each watermark must be defined in the preset for the current output.

" - }, - "AlbumArt":{ - "shape":"JobAlbumArt", - "documentation":"

Information about the album art that you want Elastic Transcoder to add to the file during transcoding. You can specify up to twenty album artworks for each output. Settings for each artwork must be defined in the job for the current output.

" - }, - "Composition":{ - "shape":"Composition", - "documentation":"

You can create an output file that contains an excerpt from the input file. This excerpt, called a clip, can come from the beginning, middle, or end of the file. The Composition object contains settings for the clips that make up an output file. For the current release, you can only specify settings for a single clip per output file. The Composition object cannot be null.

", - "deprecated":true - }, - "Captions":{ - "shape":"Captions", - "documentation":"

You can configure Elastic Transcoder to transcode captions, or subtitles, from one format to another. All captions must be in UTF-8. Elastic Transcoder supports two types of captions:

  • Embedded: Embedded captions are included in the same file as the audio and video. Elastic Transcoder supports only one embedded caption per language, to a maximum of 300 embedded captions per file.

    Valid input values include: CEA-608 (EIA-608, first non-empty channel only), CEA-708 (EIA-708, first non-empty channel only), and mov-text

    Valid outputs include: mov-text

    Elastic Transcoder supports a maximum of one embedded format per output.

  • Sidecar: Sidecar captions are kept in a separate metadata file from the audio and video data. Sidecar captions require a player that is capable of understanding the relationship between the video file and the sidecar file. Elastic Transcoder supports only one sidecar caption per language, to a maximum of 20 sidecar captions per file.

    Valid input values include: dfxp (first div element only), ebu-tt, scc, smpt, srt, ttml (first div element only), and webvtt

    Valid outputs include: dfxp (first div element only), scc, srt, and webvtt.

If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.

Elastic Transcoder does not support OCR (Optical Character Recognition), does not accept pictures as a valid input for captions, and is not available for audio-only transcoding. Elastic Transcoder does not preserve text formatting (for example, italics) during the transcoding process.

To remove captions or leave the captions empty, set Captions to null. To pass through existing captions unchanged, set the MergePolicy to MergeRetain, and pass in a null CaptionSources array.

For more information on embedded files, see the Subtitles Wikipedia page.

For more information on sidecar files, see the Extensible Metadata Platform and Sidecar file Wikipedia pages.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

You can specify encryption settings for any output files that you want to use for a transcoding job. This includes the output file and any watermarks, thumbnails, album art, or captions that you want to use. You must specify encryption settings for each file individually.

" - } - }, - "documentation":"

The CreateJobOutput structure.

" - }, - "CreateJobOutputs":{ - "type":"list", - "member":{"shape":"CreateJobOutput"}, - "max":30 - }, - "CreateJobPlaylist":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Filename", - "documentation":"

The name that you want Elastic Transcoder to assign to the master playlist, for example, nyc-vacation.m3u8. If the name includes a / character, the section of the name before the last / must be identical for all Name objects. If you create more than one master playlist, the values of all Name objects must be unique.

Elastic Transcoder automatically appends the relevant file extension to the file name (.m3u8 for HLSv3 and HLSv4 playlists, and .ism and .ismc for Smooth playlists). If you include a file extension in Name, the file name will have two extensions.

" - }, - "Format":{ - "shape":"PlaylistFormat", - "documentation":"

The format of the output playlist. Valid formats include HLSv3, HLSv4, and Smooth.

" - }, - "OutputKeys":{ - "shape":"OutputKeys", - "documentation":"

For each output in this job that you want to include in a master playlist, the value of the Outputs:Key object.

  • If your output is not HLS or does not have a segment duration set, the name of the output file is a concatenation of OutputKeyPrefix and Outputs:Key:

    OutputKeyPrefixOutputs:Key

  • If your output is HLSv3 and has a segment duration set, or is not included in a playlist, Elastic Transcoder creates an output playlist file with a file extension of .m3u8, and a series of .ts files that include a five-digit sequential counter beginning with 00000:

    OutputKeyPrefixOutputs:Key.m3u8

    OutputKeyPrefixOutputs:Key00000.ts

  • If your output is HLSv4, has a segment duration set, and is included in an HLSv4 playlist, Elastic Transcoder creates an output playlist file with a file extension of _v4.m3u8. If the output is video, Elastic Transcoder also creates an output file with an extension of _iframe.m3u8:

    OutputKeyPrefixOutputs:Key_v4.m3u8

    OutputKeyPrefixOutputs:Key_iframe.m3u8

    OutputKeyPrefixOutputs:Key.ts

Elastic Transcoder automatically appends the relevant file extension to the file name. If you include a file extension in Output Key, the file name will have two extensions.

If you include more than one output in a playlist, any segment duration settings, clip settings, or caption settings must be the same for all outputs in the playlist. For Smooth playlists, the Audio:Profile, Video:Profile, and Video:FrameRate to Video:KeyframesMaxDist ratio must be the same for all outputs.

" - }, - "HlsContentProtection":{ - "shape":"HlsContentProtection", - "documentation":"

The HLS content protection settings, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

" - }, - "PlayReadyDrm":{ - "shape":"PlayReadyDrm", - "documentation":"

The DRM settings, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

" - } - }, - "documentation":"

Information about the master playlist.

" - }, - "CreateJobPlaylists":{ - "type":"list", - "member":{"shape":"CreateJobPlaylist"}, - "max":30 - }, - "CreateJobRequest":{ - "type":"structure", - "required":["PipelineId"], - "members":{ - "PipelineId":{ - "shape":"Id", - "documentation":"

The Id of the pipeline that you want Elastic Transcoder to use for transcoding. The pipeline determines several settings, including the Amazon S3 bucket from which Elastic Transcoder gets the files to transcode and the bucket into which Elastic Transcoder puts the transcoded files.

" - }, - "Input":{ - "shape":"JobInput", - "documentation":"

A section of the request body that provides information about the file that is being transcoded.

" - }, - "Inputs":{ - "shape":"JobInputs", - "documentation":"

A section of the request body that provides information about the files that are being transcoded.

" - }, - "Output":{ - "shape":"CreateJobOutput", - "documentation":"

A section of the request body that provides information about the transcoded (target) file. We strongly recommend that you use the Outputs syntax instead of the Output syntax.

" - }, - "Outputs":{ - "shape":"CreateJobOutputs", - "documentation":"

A section of the request body that provides information about the transcoded (target) files. We recommend that you use the Outputs syntax instead of the Output syntax.

" - }, - "OutputKeyPrefix":{ - "shape":"Key", - "documentation":"

The value, if any, that you want Elastic Transcoder to prepend to the names of all files that this job creates, including output files, thumbnails, and playlists.

" - }, - "Playlists":{ - "shape":"CreateJobPlaylists", - "documentation":"

If you specify a preset in PresetId for which the value of Container is fmp4 (Fragmented MP4) or ts (MPEG-TS), Playlists contains information about the master playlists that you want Elastic Transcoder to create.

The maximum number of master playlists in a job is 30.

" - }, - "UserMetadata":{ - "shape":"UserMetadata", - "documentation":"

User-defined metadata that you want to associate with an Elastic Transcoder job. You specify metadata in key/value pairs, and you can add up to 10 key/value pairs per job. Elastic Transcoder does not guarantee that key/value pairs are returned in the same order in which you specify them.

" - } - }, - "documentation":"

The CreateJobRequest structure.

" - }, - "CreateJobResponse":{ - "type":"structure", - "members":{ - "Job":{ - "shape":"Job", - "documentation":"

A section of the response body that provides information about the job that is created.

" - } - }, - "documentation":"

The CreateJobResponse structure.

" - }, - "CreatePipelineRequest":{ - "type":"structure", - "required":[ - "Name", - "InputBucket", - "Role" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the pipeline. We recommend that the name be unique within the AWS account, but uniqueness is not enforced.

Constraints: Maximum 40 characters.

" - }, - "InputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket in which you saved the media files that you want to transcode.

" - }, - "OutputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files. (Use this, or use ContentConfig:Bucket plus ThumbnailConfig:Bucket.)

Specify this value when all of the following are true:

  • You want to save transcoded files, thumbnails (if any), and playlists (if any) together in one bucket.

  • You do not want to specify the users or groups who have access to the transcoded files, thumbnails, and playlists.

  • You do not want to specify the permissions that Elastic Transcoder grants to the files.

    When Elastic Transcoder saves files in OutputBucket, it grants full control over the files only to the AWS account that owns the role that is specified by Role.

  • You want to associate the transcoded files and thumbnails with the Amazon S3 Standard storage class.

If you want to save transcoded files and playlists in one bucket and thumbnails in another bucket, specify which users can access the transcoded files or the permissions the users have, or change the Amazon S3 storage class, omit OutputBucket and specify values for ContentConfig and ThumbnailConfig instead.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to create the pipeline.

" - }, - "AwsKmsKeyArn":{ - "shape":"KeyArn", - "documentation":"

The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

If you use either S3 or S3-AWS-KMS as your Encryption:Mode, you don't need to provide a key with your job because a default key, known as an AWS-KMS key, is created for you automatically. You need to provide an AWS-KMS key only if you want to use a non-default AWS-KMS key, or if you are using an Encryption:Mode of AES-PKCS7, AES-CTR, or AES-GCM.

" - }, - "Notifications":{ - "shape":"Notifications", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status.

To receive notifications, you must also subscribe to the new topic in the Amazon SNS console.

  • Progressing: The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process a job in this pipeline. This is the ARN that Amazon SNS returned when you created the topic. For more information, see Create a Topic in the Amazon Simple Notification Service Developer Guide.

  • Completed: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing a job in this pipeline. This is the ARN that Amazon SNS returned when you created the topic.

  • Warning: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition while processing a job in this pipeline. This is the ARN that Amazon SNS returned when you created the topic.

  • Error: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition while processing a job in this pipeline. This is the ARN that Amazon SNS returned when you created the topic.

" - }, - "ContentConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

The optional ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists: which bucket to use, which users you want to have access to the files, the type of access you want users to have, and the storage class that you want to assign to the files.

If you specify values for ContentConfig, you must also specify values for ThumbnailConfig.

If you specify values for ContentConfig and ThumbnailConfig, omit the OutputBucket object.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists.

  • Permissions (Optional): The Permissions object specifies which users you want to have access to transcoded files and the type of access you want them to have. You can grant permissions to a maximum of 30 users and/or predefined Amazon S3 groups.

  • Grantee Type: Specify the type of value that appears in the Grantee object:

    • Canonical: The value in the Grantee object is either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution. For more information about canonical user IDs, see Access Control List (ACL) Overview in the Amazon Simple Storage Service Developer Guide. For more information about using CloudFront origin access identities to require that users use CloudFront URLs instead of Amazon S3 URLs, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content.

      A canonical user ID is not the same as an AWS account number.

    • Email: The value in the Grantee object is the registered email address of an AWS account.

    • Group: The value in the Grantee object is one of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

  • Grantee: The AWS user or group that you want to have access to transcoded files and playlists. To identify the user or group, you can specify the canonical user ID for an AWS account, an origin access identity for a CloudFront distribution, the registered email address of an AWS account, or a predefined Amazon S3 group

  • Access: The permission that you want to give to the AWS user that you specified in Grantee. Permissions are granted on the files that Elastic Transcoder adds to the bucket, including playlists and video files. Valid values include:

    • READ: The grantee can read the objects and metadata for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • READ_ACP: The grantee can read the object ACL for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • WRITE_ACP: The grantee can write the ACL for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the video files and playlists that it stores in your Amazon S3 bucket.

" - }, - "ThumbnailConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

The ThumbnailConfig object specifies several values, including the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files, which users you want to have access to the files, the type of access you want users to have, and the storage class that you want to assign to the files.

If you specify values for ContentConfig, you must also specify values for ThumbnailConfig even if you don't want to create thumbnails.

If you specify values for ContentConfig and ThumbnailConfig, omit the OutputBucket object.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • Permissions (Optional): The Permissions object specifies which users and/or predefined Amazon S3 groups you want to have access to thumbnail files, and the type of access you want them to have. You can grant permissions to a maximum of 30 users and/or predefined Amazon S3 groups.

  • GranteeType: Specify the type of value that appears in the Grantee object:

    • Canonical: The value in the Grantee object is either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution.

      A canonical user ID is not the same as an AWS account number.

    • Email: The value in the Grantee object is the registered email address of an AWS account.

    • Group: The value in the Grantee object is one of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

  • Grantee: The AWS user or group that you want to have access to thumbnail files. To identify the user or group, you can specify the canonical user ID for an AWS account, an origin access identity for a CloudFront distribution, the registered email address of an AWS account, or a predefined Amazon S3 group.

  • Access: The permission that you want to give to the AWS user that you specified in Grantee. Permissions are granted on the thumbnail files that Elastic Transcoder adds to the bucket. Valid values include:

    • READ: The grantee can read the thumbnails and metadata for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • READ_ACP: The grantee can read the object ACL for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

    • WRITE_ACP: The grantee can write the ACL for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

    • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the thumbnails that it stores in your Amazon S3 bucket.

" - } - }, - "documentation":"

The CreatePipelineRequest structure.

" - }, - "CreatePipelineResponse":{ - "type":"structure", - "members":{ - "Pipeline":{ - "shape":"Pipeline", - "documentation":"

A section of the response body that provides information about the pipeline that is created.

" - }, - "Warnings":{ - "shape":"Warnings", - "documentation":"

Elastic Transcoder returns a warning if the resources used by your pipeline are not in the same region as the pipeline.

Using resources in the same region, such as your Amazon S3 buckets, Amazon SNS notification topics, and AWS KMS key, reduces processing time and prevents cross-regional charges.

" - } - }, - "documentation":"

When you create a pipeline, Elastic Transcoder returns the values that you specified in the request.

" - }, - "CreatePresetRequest":{ - "type":"structure", - "required":[ - "Name", - "Container" - ], - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the preset. We recommend that the name be unique within the AWS account, but uniqueness is not enforced.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the preset.

" - }, - "Container":{ - "shape":"PresetContainer", - "documentation":"

The container type for the output file. Valid values include flac, flv, fmp4, gif, mp3, mp4, mpg, mxf, oga, ogg, ts, and webm.

" - }, - "Video":{ - "shape":"VideoParameters", - "documentation":"

A section of the request body that specifies the video parameters.

" - }, - "Audio":{ - "shape":"AudioParameters", - "documentation":"

A section of the request body that specifies the audio parameters.

" - }, - "Thumbnails":{ - "shape":"Thumbnails", - "documentation":"

A section of the request body that specifies the thumbnail parameters, if any.

" - } - }, - "documentation":"

The CreatePresetRequest structure.

" - }, - "CreatePresetResponse":{ - "type":"structure", - "members":{ - "Preset":{ - "shape":"Preset", - "documentation":"

A section of the response body that provides information about the preset that is created.

" - }, - "Warning":{ - "shape":"String", - "documentation":"

If the preset settings don't comply with the standards for the video codec but Elastic Transcoder created the preset, this message explains the reason the preset settings don't meet the standard. Elastic Transcoder created the preset because the settings might produce acceptable output.

" - } - }, - "documentation":"

The CreatePresetResponse structure.

" - }, - "DeletePipelineRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the pipeline that you want to delete.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The DeletePipelineRequest structure.

" - }, - "DeletePipelineResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DeletePipelineResponse structure.

" - }, - "DeletePresetRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the preset for which you want to get detailed information.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The DeletePresetRequest structure.

" - }, - "DeletePresetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DeletePresetResponse structure.

" - }, - "Description":{ - "type":"string", - "max":255, - "min":0 - }, - "DetectedProperties":{ - "type":"structure", - "members":{ - "Width":{ - "shape":"NullableInteger", - "documentation":"

The detected width of the input file, in pixels.

" - }, - "Height":{ - "shape":"NullableInteger", - "documentation":"

The detected height of the input file, in pixels.

" - }, - "FrameRate":{ - "shape":"FloatString", - "documentation":"

The detected frame rate of the input file, in frames per second.

" - }, - "FileSize":{ - "shape":"NullableLong", - "documentation":"

The detected file size of the input file, in bytes.

" - }, - "DurationMillis":{ - "shape":"NullableLong", - "documentation":"

The detected duration of the input file, in milliseconds.

" - } - }, - "documentation":"

The detected properties of the input file. Elastic Transcoder identifies these values from the input file.

" - }, - "Digits":{ - "type":"string", - "pattern":"^\\d{1,5}$" - }, - "DigitsOrAuto":{ - "type":"string", - "pattern":"(^auto$)|(^\\d{2,4}$)" - }, - "Encryption":{ - "type":"structure", - "members":{ - "Mode":{ - "shape":"EncryptionMode", - "documentation":"

The specific server-side encryption mode that you want Elastic Transcoder to use when decrypting your input files or encrypting your output files. Elastic Transcoder supports the following options:

  • S3: Amazon S3 creates and manages the keys used for encrypting your files.

  • S3-AWS-KMS: Amazon S3 calls the Amazon Key Management Service, which creates and manages the keys that are used for encrypting your files. If you specify S3-AWS-KMS and you don't want to use the default key, you must add the AWS-KMS key that you want to use to your pipeline.

  • AES-CBC-PKCS7: A padded cipher-block mode of operation originally used for HLS files.

  • AES-CTR: AES Counter Mode.

  • AES-GCM: AES Galois Counter Mode, a mode of operation that is an authenticated encryption format, meaning that a file, key, or initialization vector that has been tampered with fails the decryption process.

For all three AES options, you must provide the following settings, which must be base64-encoded:

  • Key

  • Key MD5

  • Initialization Vector

For the AES modes, your private encryption keys and your unencrypted data are never stored by AWS; therefore, it is important that you safely manage your encryption keys. If you lose them, you won't be able to unencrypt your data.

" - }, - "Key":{ - "shape":"Base64EncodedString", - "documentation":"

The data encryption key that you want Elastic Transcoder to use to encrypt your output file, or that was used to encrypt your input file. The key must be base64-encoded and it must be one of the following bit lengths before being base64-encoded:

128, 192, or 256.

The key must also be encrypted by using the Amazon Key Management Service.

" - }, - "KeyMd5":{ - "shape":"Base64EncodedString", - "documentation":"

The MD5 digest of the key that you used to encrypt your input file, or that you want Elastic Transcoder to use to encrypt your output file. Elastic Transcoder uses the key digest as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes long before being base64-encoded.

" - }, - "InitializationVector":{ - "shape":"ZeroTo255String", - "documentation":"

The series of random bits created by a random bit generator, unique for every encryption operation, that you used to encrypt your input files or that you want Elastic Transcoder to use to encrypt your output files. The initialization vector must be base64-encoded, and it must be exactly 16 bytes long before being base64-encoded.

" - } - }, - "documentation":"

The encryption settings, if any, that are used for decrypting your input files or encrypting your output files. If your input file is encrypted, you must specify the mode that Elastic Transcoder uses to decrypt your file, otherwise you must specify the mode you want Elastic Transcoder to use to encrypt your output files.

" - }, - "EncryptionMode":{ - "type":"string", - "pattern":"(^s3$)|(^s3-aws-kms$)|(^aes-cbc-pkcs7$)|(^aes-ctr$)|(^aes-gcm$)" - }, - "ExceptionMessages":{ - "type":"list", - "member":{"shape":"String"} - }, - "Filename":{ - "type":"string", - "max":255, - "min":1 - }, - "FixedGOP":{ - "type":"string", - "pattern":"(^true$)|(^false$)" - }, - "FloatString":{ - "type":"string", - "pattern":"^\\d{1,5}(\\.\\d{0,5})?$" - }, - "FrameRate":{ - "type":"string", - "pattern":"(^auto$)|(^10$)|(^15$)|(^23.97$)|(^24$)|(^25$)|(^29.97$)|(^30$)|(^50$)|(^60$)" - }, - "Grantee":{ - "type":"string", - "max":255, - "min":1 - }, - "GranteeType":{ - "type":"string", - "pattern":"(^Canonical$)|(^Email$)|(^Group$)" - }, - "HlsContentProtection":{ - "type":"structure", - "members":{ - "Method":{ - "shape":"HlsContentProtectionMethod", - "documentation":"

The content protection method for your output. The only valid value is: aes-128.

This value is written into the method attribute of the EXT-X-KEY metadata tag in the output playlist.

" - }, - "Key":{ - "shape":"Base64EncodedString", - "documentation":"

If you want Elastic Transcoder to generate a key for you, leave this field blank.

If you choose to supply your own key, you must encrypt the key by using AWS KMS. The key must be base64-encoded, and it must be one of the following bit lengths before being base64-encoded:

128, 192, or 256.

" - }, - "KeyMd5":{ - "shape":"Base64EncodedString", - "documentation":"

If Elastic Transcoder is generating your key for you, you must leave this field blank.

The MD5 digest of the key that you want Elastic Transcoder to use to encrypt your output file, and that you want Elastic Transcoder to use as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes before being base64- encoded.

" - }, - "InitializationVector":{ - "shape":"ZeroTo255String", - "documentation":"

If Elastic Transcoder is generating your key for you, you must leave this field blank.

The series of random bits created by a random bit generator, unique for every encryption operation, that you want Elastic Transcoder to use to encrypt your output files. The initialization vector must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.

" - }, - "LicenseAcquisitionUrl":{ - "shape":"ZeroTo512String", - "documentation":"

The location of the license key required to decrypt your HLS playlist. The URL must be an absolute path, and is referenced in the URI attribute of the EXT-X-KEY metadata tag in the playlist file.

" - }, - "KeyStoragePolicy":{ - "shape":"KeyStoragePolicy", - "documentation":"

Specify whether you want Elastic Transcoder to write your HLS license key to an Amazon S3 bucket. If you choose WithVariantPlaylists, LicenseAcquisitionUrl must be left blank and Elastic Transcoder writes your data key into the same bucket as the associated playlist.

" - } - }, - "documentation":"

The HLS content protection settings, if any, that you want Elastic Transcoder to apply to your output files.

" - }, - "HlsContentProtectionMethod":{ - "type":"string", - "pattern":"(^aes-128$)" - }, - "HorizontalAlign":{ - "type":"string", - "pattern":"(^Left$)|(^Right$)|(^Center$)" - }, - "Id":{ - "type":"string", - "pattern":"^\\d{13}-\\w{6}$" - }, - "IncompatibleVersionException":{ - "type":"structure", - "members":{ - }, - "error":{"httpStatusCode":400}, - "exception":true - }, - "InputCaptions":{ - "type":"structure", - "members":{ - "MergePolicy":{ - "shape":"CaptionMergePolicy", - "documentation":"

A policy that determines how Elastic Transcoder handles the existence of multiple captions.

  • MergeOverride: Elastic Transcoder transcodes both embedded and sidecar captions into outputs. If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the sidecar captions and ignores the embedded captions for that language.

  • MergeRetain: Elastic Transcoder transcodes both embedded and sidecar captions into outputs. If captions for a language are embedded in the input file and also appear in a sidecar file, Elastic Transcoder uses the embedded captions and ignores the sidecar captions for that language. If CaptionSources is empty, Elastic Transcoder omits all sidecar captions from the output files.

  • Override: Elastic Transcoder transcodes only the sidecar captions that you specify in CaptionSources.

MergePolicy cannot be null.

" - }, - "CaptionSources":{ - "shape":"CaptionSources", - "documentation":"

Source files for the input sidecar captions used during the transcoding process. To omit all sidecar captions, leave CaptionSources blank.

" - } - }, - "documentation":"

The captions to be created, if any.

" - }, - "Interlaced":{ - "type":"string", - "pattern":"(^auto$)|(^true$)|(^false$)" - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Elastic Transcoder encountered an unexpected exception while trying to fulfill the request.

", - "exception":true, - "fault":true - }, - "Job":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier that Elastic Transcoder assigned to the job. You use this value to get settings for the job or to delete the job.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the job.

" - }, - "PipelineId":{ - "shape":"Id", - "documentation":"

The Id of the pipeline that you want Elastic Transcoder to use for transcoding. The pipeline determines several settings, including the Amazon S3 bucket from which Elastic Transcoder gets the files to transcode and the bucket into which Elastic Transcoder puts the transcoded files.

" - }, - "Input":{ - "shape":"JobInput", - "documentation":"

A section of the request or response body that provides information about the file that is being transcoded.

" - }, - "Inputs":{ - "shape":"JobInputs", - "documentation":"

Information about the files that you're transcoding. If you specified multiple files for this job, Elastic Transcoder stitches the files together to make one output.

" - }, - "Output":{ - "shape":"JobOutput", - "documentation":"

If you specified one output for a job, information about that output. If you specified multiple outputs for a job, the Output object lists information about the first output. This duplicates the information that is listed for the first output in the Outputs object.

Outputs recommended instead.

A section of the request or response body that provides information about the transcoded (target) file.

" - }, - "Outputs":{ - "shape":"JobOutputs", - "documentation":"

Information about the output files. We recommend that you use the Outputs syntax for all jobs, even when you want Elastic Transcoder to transcode a file into only one format. Do not use both the Outputs and Output syntaxes in the same request. You can create a maximum of 30 outputs per job.

If you specify more than one output for a job, Elastic Transcoder creates the files for each output in the order in which you specify them in the job.

" - }, - "OutputKeyPrefix":{ - "shape":"Key", - "documentation":"

The value, if any, that you want Elastic Transcoder to prepend to the names of all files that this job creates, including output files, thumbnails, and playlists. We recommend that you add a / or some other delimiter to the end of the OutputKeyPrefix.

" - }, - "Playlists":{ - "shape":"Playlists", - "documentation":"

Outputs in Fragmented MP4 or MPEG-TS format only.

If you specify a preset in PresetId for which the value of Container is fmp4 (Fragmented MP4) or ts (MPEG-TS), Playlists contains information about the master playlists that you want Elastic Transcoder to create.

The maximum number of master playlists in a job is 30.

" - }, - "Status":{ - "shape":"JobStatus", - "documentation":"

The status of the job: Submitted, Progressing, Complete, Canceled, or Error.

" - }, - "UserMetadata":{ - "shape":"UserMetadata", - "documentation":"

User-defined metadata that you want to associate with an Elastic Transcoder job. You specify metadata in key/value pairs, and you can add up to 10 key/value pairs per job. Elastic Transcoder does not guarantee that key/value pairs are returned in the same order in which you specify them.

Metadata keys and values must use characters from the following list:

  • 0-9

  • A-Z and a-z

  • Space

  • The following symbols: _.:/=+-%@

" - }, - "Timing":{ - "shape":"Timing", - "documentation":"

Details about the timing of a job.

" - } - }, - "documentation":"

A section of the response body that provides information about the job that is created.

" - }, - "JobAlbumArt":{ - "type":"structure", - "members":{ - "MergePolicy":{ - "shape":"MergePolicy", - "documentation":"

A policy that determines how Elastic Transcoder handles the existence of multiple album artwork files.

  • Replace: The specified album art replaces any existing album art.

  • Prepend: The specified album art is placed in front of any existing album art.

  • Append: The specified album art is placed after any existing album art.

  • Fallback: If the original input file contains artwork, Elastic Transcoder uses that artwork for the output. If the original input does not contain artwork, Elastic Transcoder uses the specified album art file.

" - }, - "Artwork":{ - "shape":"Artworks", - "documentation":"

The file to be used as album art. There can be multiple artworks associated with an audio file, to a maximum of 20. Valid formats are .jpg and .png

" - } - }, - "documentation":"

The .jpg or .png file associated with an audio file.

" - }, - "JobContainer":{ - "type":"string", - "pattern":"(^auto$)|(^3gp$)|(^asf$)|(^avi$)|(^divx$)|(^flv$)|(^mkv$)|(^mov$)|(^mp4$)|(^mpeg$)|(^mpeg-ps$)|(^mpeg-ts$)|(^mxf$)|(^ogg$)|(^ts$)|(^vob$)|(^wav$)|(^webm$)|(^mp3$)|(^m4a$)|(^aac$)" - }, - "JobInput":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"LongKey", - "documentation":"

The name of the file to transcode. Elsewhere in the body of the JSON block is the the ID of the pipeline to use for processing the job. The InputBucket object in that pipeline tells Elastic Transcoder which Amazon S3 bucket to get the file from.

If the file name includes a prefix, such as cooking/lasagna.mpg, include the prefix in the key. If the file isn't in the specified bucket, Elastic Transcoder returns an error.

" - }, - "FrameRate":{ - "shape":"FrameRate", - "documentation":"

The frame rate of the input file. If you want Elastic Transcoder to automatically detect the frame rate of the input file, specify auto. If you want to specify the frame rate for the input file, enter one of the following values:

10, 15, 23.97, 24, 25, 29.97, 30, 60

If you specify a value other than auto, Elastic Transcoder disables automatic detection of the frame rate.

" - }, - "Resolution":{ - "shape":"Resolution", - "documentation":"

This value must be auto, which causes Elastic Transcoder to automatically detect the resolution of the input file.

" - }, - "AspectRatio":{ - "shape":"AspectRatio", - "documentation":"

The aspect ratio of the input file. If you want Elastic Transcoder to automatically detect the aspect ratio of the input file, specify auto. If you want to specify the aspect ratio for the output file, enter one of the following values:

1:1, 4:3, 3:2, 16:9

If you specify a value other than auto, Elastic Transcoder disables automatic detection of the aspect ratio.

" - }, - "Interlaced":{ - "shape":"Interlaced", - "documentation":"

Whether the input file is interlaced. If you want Elastic Transcoder to automatically detect whether the input file is interlaced, specify auto. If you want to specify whether the input file is interlaced, enter one of the following values:

true, false

If you specify a value other than auto, Elastic Transcoder disables automatic detection of interlacing.

" - }, - "Container":{ - "shape":"JobContainer", - "documentation":"

The container type for the input file. If you want Elastic Transcoder to automatically detect the container type of the input file, specify auto. If you want to specify the container type for the input file, enter one of the following values:

3gp, aac, asf, avi, divx, flv, m4a, mkv, mov, mp3, mp4, mpeg, mpeg-ps, mpeg-ts, mxf, ogg, vob, wav, webm

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that are used for decrypting your input files. If your input file is encrypted, you must specify the mode that Elastic Transcoder uses to decrypt your file.

" - }, - "TimeSpan":{ - "shape":"TimeSpan", - "documentation":"

Settings for clipping an input. Each input can have different clip settings.

" - }, - "InputCaptions":{ - "shape":"InputCaptions", - "documentation":"

You can configure Elastic Transcoder to transcode captions, or subtitles, from one format to another. All captions must be in UTF-8. Elastic Transcoder supports two types of captions:

  • Embedded: Embedded captions are included in the same file as the audio and video. Elastic Transcoder supports only one embedded caption per language, to a maximum of 300 embedded captions per file.

    Valid input values include: CEA-608 (EIA-608, first non-empty channel only), CEA-708 (EIA-708, first non-empty channel only), and mov-text

    Valid outputs include: mov-text

    Elastic Transcoder supports a maximum of one embedded format per output.

  • Sidecar: Sidecar captions are kept in a separate metadata file from the audio and video data. Sidecar captions require a player that is capable of understanding the relationship between the video file and the sidecar file. Elastic Transcoder supports only one sidecar caption per language, to a maximum of 20 sidecar captions per file.

    Valid input values include: dfxp (first div element only), ebu-tt, scc, smpt, srt, ttml (first div element only), and webvtt

    Valid outputs include: dfxp (first div element only), scc, srt, and webvtt.

If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.

Elastic Transcoder does not support OCR (Optical Character Recognition), does not accept pictures as a valid input for captions, and is not available for audio-only transcoding. Elastic Transcoder does not preserve text formatting (for example, italics) during the transcoding process.

To remove captions or leave the captions empty, set Captions to null. To pass through existing captions unchanged, set the MergePolicy to MergeRetain, and pass in a null CaptionSources array.

For more information on embedded files, see the Subtitles Wikipedia page.

For more information on sidecar files, see the Extensible Metadata Platform and Sidecar file Wikipedia pages.

" - }, - "DetectedProperties":{ - "shape":"DetectedProperties", - "documentation":"

The detected properties of the input file.

" - } - }, - "documentation":"

Information about the file that you're transcoding.

" - }, - "JobInputs":{ - "type":"list", - "member":{"shape":"JobInput"}, - "max":10000 - }, - "JobOutput":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"String", - "documentation":"

A sequential counter, starting with 1, that identifies an output among the outputs from the current job. In the Output syntax, this value is always 1.

" - }, - "Key":{ - "shape":"Key", - "documentation":"

The name to assign to the transcoded file. Elastic Transcoder saves the file in the Amazon S3 bucket specified by the OutputBucket object in the pipeline that is specified by the pipeline ID.

" - }, - "ThumbnailPattern":{ - "shape":"ThumbnailPattern", - "documentation":"

Whether you want Elastic Transcoder to create thumbnails for your videos and, if so, how you want Elastic Transcoder to name the files.

If you don't want Elastic Transcoder to create thumbnails, specify \"\".

If you do want Elastic Transcoder to create thumbnails, specify the information that you want to include in the file name for each thumbnail. You can specify the following values in any sequence:

  • {count} (Required): If you want to create thumbnails, you must include {count} in the ThumbnailPattern object. Wherever you specify {count}, Elastic Transcoder adds a five-digit sequence number (beginning with 00001) to thumbnail file names. The number indicates where a given thumbnail appears in the sequence of thumbnails for a transcoded file.

    If you specify a literal value and/or {resolution} but you omit {count}, Elastic Transcoder returns a validation error and does not create the job.

  • Literal values (Optional): You can specify literal values anywhere in the ThumbnailPattern object. For example, you can include them as a file name prefix or as a delimiter between {resolution} and {count}.

  • {resolution} (Optional): If you want Elastic Transcoder to include the resolution in the file name, include {resolution} in the ThumbnailPattern object.

When creating thumbnails, Elastic Transcoder automatically saves the files in the format (.jpg or .png) that appears in the preset that you specified in the PresetID value of CreateJobOutput. Elastic Transcoder also appends the applicable file name extension.

" - }, - "ThumbnailEncryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your thumbnail.

" - }, - "Rotate":{ - "shape":"Rotate", - "documentation":"

The number of degrees clockwise by which you want Elastic Transcoder to rotate the output relative to the input. Enter one of the following values:

auto, 0, 90, 180, 270

The value auto generally works only if the file that you're transcoding contains rotation metadata.

" - }, - "PresetId":{ - "shape":"Id", - "documentation":"

The value of the Id object for the preset that you want to use for this job. The preset determines the audio, video, and thumbnail settings that Elastic Transcoder uses for transcoding. To use a preset that you created, specify the preset ID that Elastic Transcoder returned in the response when you created the preset. You can also use the Elastic Transcoder system presets, which you can get with ListPresets.

" - }, - "SegmentDuration":{ - "shape":"FloatString", - "documentation":"

(Outputs in Fragmented MP4 or MPEG-TS format only.

If you specify a preset in PresetId for which the value of Container is fmp4 (Fragmented MP4) or ts (MPEG-TS), SegmentDuration is the target maximum duration of each segment in seconds. For HLSv3 format playlists, each media segment is stored in a separate .ts file. For HLSv4, MPEG-DASH, and Smooth playlists, all media segments for an output are stored in a single file. Each segment is approximately the length of the SegmentDuration, though individual segments might be shorter or longer.

The range of valid values is 1 to 60 seconds. If the duration of the video is not evenly divisible by SegmentDuration, the duration of the last segment is the remainder of total length/SegmentDuration.

Elastic Transcoder creates an output-specific playlist for each output HLS output that you specify in OutputKeys. To add an output to the master playlist for this job, include it in the OutputKeys of the associated playlist.

" - }, - "Status":{ - "shape":"JobStatus", - "documentation":"

The status of one output in a job. If you specified only one output for the job, Outputs:Status is always the same as Job:Status. If you specified more than one output:

  • Job:Status and Outputs:Status for all of the outputs is Submitted until Elastic Transcoder starts to process the first output.

  • When Elastic Transcoder starts to process the first output, Outputs:Status for that output and Job:Status both change to Progressing. For each output, the value of Outputs:Status remains Submitted until Elastic Transcoder starts to process the output.

  • Job:Status remains Progressing until all of the outputs reach a terminal status, either Complete or Error.

  • When all of the outputs reach a terminal status, Job:Status changes to Complete only if Outputs:Status for all of the outputs is Complete. If Outputs:Status for one or more outputs is Error, the terminal status for Job:Status is also Error.

The value of Status is one of the following: Submitted, Progressing, Complete, Canceled, or Error.

" - }, - "StatusDetail":{ - "shape":"Description", - "documentation":"

Information that further explains Status.

" - }, - "Duration":{ - "shape":"NullableLong", - "documentation":"

Duration of the output file, in seconds.

" - }, - "Width":{ - "shape":"NullableInteger", - "documentation":"

Specifies the width of the output file in pixels.

" - }, - "Height":{ - "shape":"NullableInteger", - "documentation":"

Height of the output file, in pixels.

" - }, - "FrameRate":{ - "shape":"FloatString", - "documentation":"

Frame rate of the output file, in frames per second.

" - }, - "FileSize":{ - "shape":"NullableLong", - "documentation":"

File size of the output file, in bytes.

" - }, - "DurationMillis":{ - "shape":"NullableLong", - "documentation":"

Duration of the output file, in milliseconds.

" - }, - "Watermarks":{ - "shape":"JobWatermarks", - "documentation":"

Information about the watermarks that you want Elastic Transcoder to add to the video during transcoding. You can specify up to four watermarks for each output. Settings for each watermark must be defined in the preset that you specify in Preset for the current output.

Watermarks are added to the output video in the sequence in which you list them in the job output—the first watermark in the list is added to the output video first, the second watermark in the list is added next, and so on. As a result, if the settings in a preset cause Elastic Transcoder to place all watermarks in the same location, the second watermark that you add covers the first one, the third one covers the second, and the fourth one covers the third.

" - }, - "AlbumArt":{ - "shape":"JobAlbumArt", - "documentation":"

The album art to be associated with the output file, if any.

" - }, - "Composition":{ - "shape":"Composition", - "documentation":"

You can create an output file that contains an excerpt from the input file. This excerpt, called a clip, can come from the beginning, middle, or end of the file. The Composition object contains settings for the clips that make up an output file. For the current release, you can only specify settings for a single clip per output file. The Composition object cannot be null.

", - "deprecated":true - }, - "Captions":{ - "shape":"Captions", - "documentation":"

You can configure Elastic Transcoder to transcode captions, or subtitles, from one format to another. All captions must be in UTF-8. Elastic Transcoder supports two types of captions:

  • Embedded: Embedded captions are included in the same file as the audio and video. Elastic Transcoder supports only one embedded caption per language, to a maximum of 300 embedded captions per file.

    Valid input values include: CEA-608 (EIA-608, first non-empty channel only), CEA-708 (EIA-708, first non-empty channel only), and mov-text

    Valid outputs include: mov-text

    Elastic Transcoder supports a maximum of one embedded format per output.

  • Sidecar: Sidecar captions are kept in a separate metadata file from the audio and video data. Sidecar captions require a player that is capable of understanding the relationship between the video file and the sidecar file. Elastic Transcoder supports only one sidecar caption per language, to a maximum of 20 sidecar captions per file.

    Valid input values include: dfxp (first div element only), ebu-tt, scc, smpt, srt, ttml (first div element only), and webvtt

    Valid outputs include: dfxp (first div element only), scc, srt, and webvtt.

If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.

Elastic Transcoder does not support OCR (Optical Character Recognition), does not accept pictures as a valid input for captions, and is not available for audio-only transcoding. Elastic Transcoder does not preserve text formatting (for example, italics) during the transcoding process.

To remove captions or leave the captions empty, set Captions to null. To pass through existing captions unchanged, set the MergePolicy to MergeRetain, and pass in a null CaptionSources array.

For more information on embedded files, see the Subtitles Wikipedia page.

For more information on sidecar files, see the Extensible Metadata Platform and Sidecar file Wikipedia pages.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your output files. If you choose to use encryption, you must specify a mode to use. If you choose not to use encryption, Elastic Transcoder writes an unencrypted file to your Amazon S3 bucket.

" - }, - "AppliedColorSpaceConversion":{ - "shape":"String", - "documentation":"

If Elastic Transcoder used a preset with a ColorSpaceConversionMode to transcode the output file, the AppliedColorSpaceConversion parameter shows the conversion used. If no ColorSpaceConversionMode was defined in the preset, this parameter is not be included in the job response.

" - } - }, - "documentation":"

Outputs recommended instead.

If you specified one output for a job, information about that output. If you specified multiple outputs for a job, the Output object lists information about the first output. This duplicates the information that is listed for the first output in the Outputs object.

" - }, - "JobOutputs":{ - "type":"list", - "member":{"shape":"JobOutput"} - }, - "JobStatus":{ - "type":"string", - "pattern":"(^Submitted$)|(^Progressing$)|(^Complete$)|(^Canceled$)|(^Error$)" - }, - "JobWatermark":{ - "type":"structure", - "members":{ - "PresetWatermarkId":{ - "shape":"PresetWatermarkId", - "documentation":"

The ID of the watermark settings that Elastic Transcoder uses to add watermarks to the video during transcoding. The settings are in the preset specified by Preset for the current output. In that preset, the value of Watermarks Id tells Elastic Transcoder which settings to use.

" - }, - "InputKey":{ - "shape":"WatermarkKey", - "documentation":"

The name of the .png or .jpg file that you want to use for the watermark. To determine which Amazon S3 bucket contains the specified file, Elastic Transcoder checks the pipeline specified by Pipeline; the Input Bucket object in that pipeline identifies the bucket.

If the file name includes a prefix, for example, logos/128x64.png, include the prefix in the key. If the file isn't in the specified bucket, Elastic Transcoder returns an error.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

The encryption settings, if any, that you want Elastic Transcoder to apply to your watermarks.

" - } - }, - "documentation":"

Watermarks can be in .png or .jpg format. If you want to display a watermark that is not rectangular, use the .png format, which supports transparency.

" - }, - "JobWatermarks":{ - "type":"list", - "member":{"shape":"JobWatermark"} - }, - "Jobs":{ - "type":"list", - "member":{"shape":"Job"} - }, - "JpgOrPng":{ - "type":"string", - "pattern":"(^jpg$)|(^png$)" - }, - "Key":{ - "type":"string", - "max":255, - "min":1 - }, - "KeyArn":{ - "type":"string", - "max":255, - "min":0 - }, - "KeyIdGuid":{ - "type":"string", - "pattern":"(^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$)|(^[0-9A-Fa-f]{32}$)" - }, - "KeyStoragePolicy":{ - "type":"string", - "pattern":"(^NoStore$)|(^WithVariantPlaylists$)" - }, - "KeyframesMaxDist":{ - "type":"string", - "pattern":"^\\d{1,6}$" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Too many operations for a given AWS account. For example, the number of pipelines exceeds the maximum allowed.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListJobsByPipelineRequest":{ - "type":"structure", - "required":["PipelineId"], - "members":{ - "PipelineId":{ - "shape":"Id", - "documentation":"

The ID of the pipeline for which you want to get job information.

", - "location":"uri", - "locationName":"PipelineId" - }, - "Ascending":{ - "shape":"Ascending", - "documentation":"

To list jobs in chronological order by the date and time that they were submitted, enter true. To list jobs in reverse chronological order, enter false.

", - "location":"querystring", - "locationName":"Ascending" - }, - "PageToken":{ - "shape":"Id", - "documentation":"

When Elastic Transcoder returns more than one page of results, use pageToken in subsequent GET requests to get each successive page of results.

", - "location":"querystring", - "locationName":"PageToken" - } - }, - "documentation":"

The ListJobsByPipelineRequest structure.

" - }, - "ListJobsByPipelineResponse":{ - "type":"structure", - "members":{ - "Jobs":{ - "shape":"Jobs", - "documentation":"

An array of Job objects that are in the specified pipeline.

" - }, - "NextPageToken":{ - "shape":"Id", - "documentation":"

A value that you use to access the second and subsequent pages of results, if any. When the jobs in the specified pipeline fit on one page or when you've reached the last page of results, the value of NextPageToken is null.

" - } - }, - "documentation":"

The ListJobsByPipelineResponse structure.

" - }, - "ListJobsByStatusRequest":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"JobStatus", - "documentation":"

To get information about all of the jobs associated with the current AWS account that have a given status, specify the following status: Submitted, Progressing, Complete, Canceled, or Error.

", - "location":"uri", - "locationName":"Status" - }, - "Ascending":{ - "shape":"Ascending", - "documentation":"

To list jobs in chronological order by the date and time that they were submitted, enter true. To list jobs in reverse chronological order, enter false.

", - "location":"querystring", - "locationName":"Ascending" - }, - "PageToken":{ - "shape":"Id", - "documentation":"

When Elastic Transcoder returns more than one page of results, use pageToken in subsequent GET requests to get each successive page of results.

", - "location":"querystring", - "locationName":"PageToken" - } - }, - "documentation":"

The ListJobsByStatusRequest structure.

" - }, - "ListJobsByStatusResponse":{ - "type":"structure", - "members":{ - "Jobs":{ - "shape":"Jobs", - "documentation":"

An array of Job objects that have the specified status.

" - }, - "NextPageToken":{ - "shape":"Id", - "documentation":"

A value that you use to access the second and subsequent pages of results, if any. When the jobs in the specified pipeline fit on one page or when you've reached the last page of results, the value of NextPageToken is null.

" - } - }, - "documentation":"

The ListJobsByStatusResponse structure.

" - }, - "ListPipelinesRequest":{ - "type":"structure", - "members":{ - "Ascending":{ - "shape":"Ascending", - "documentation":"

To list pipelines in chronological order by the date and time that they were created, enter true. To list pipelines in reverse chronological order, enter false.

", - "location":"querystring", - "locationName":"Ascending" - }, - "PageToken":{ - "shape":"Id", - "documentation":"

When Elastic Transcoder returns more than one page of results, use pageToken in subsequent GET requests to get each successive page of results.

", - "location":"querystring", - "locationName":"PageToken" - } - }, - "documentation":"

The ListPipelineRequest structure.

" - }, - "ListPipelinesResponse":{ - "type":"structure", - "members":{ - "Pipelines":{ - "shape":"Pipelines", - "documentation":"

An array of Pipeline objects.

" - }, - "NextPageToken":{ - "shape":"Id", - "documentation":"

A value that you use to access the second and subsequent pages of results, if any. When the pipelines fit on one page or when you've reached the last page of results, the value of NextPageToken is null.

" - } - }, - "documentation":"

A list of the pipelines associated with the current AWS account.

" - }, - "ListPresetsRequest":{ - "type":"structure", - "members":{ - "Ascending":{ - "shape":"Ascending", - "documentation":"

To list presets in chronological order by the date and time that they were created, enter true. To list presets in reverse chronological order, enter false.

", - "location":"querystring", - "locationName":"Ascending" - }, - "PageToken":{ - "shape":"Id", - "documentation":"

When Elastic Transcoder returns more than one page of results, use pageToken in subsequent GET requests to get each successive page of results.

", - "location":"querystring", - "locationName":"PageToken" - } - }, - "documentation":"

The ListPresetsRequest structure.

" - }, - "ListPresetsResponse":{ - "type":"structure", - "members":{ - "Presets":{ - "shape":"Presets", - "documentation":"

An array of Preset objects.

" - }, - "NextPageToken":{ - "shape":"Id", - "documentation":"

A value that you use to access the second and subsequent pages of results, if any. When the presets fit on one page or when you've reached the last page of results, the value of NextPageToken is null.

" - } - }, - "documentation":"

The ListPresetsResponse structure.

" - }, - "LongKey":{ - "type":"string", - "max":1024, - "min":1 - }, - "MaxFrameRate":{ - "type":"string", - "pattern":"(^10$)|(^15$)|(^23.97$)|(^24$)|(^25$)|(^29.97$)|(^30$)|(^50$)|(^60$)" - }, - "MergePolicy":{ - "type":"string", - "pattern":"(^Replace$)|(^Prepend$)|(^Append$)|(^Fallback$)" - }, - "Name":{ - "type":"string", - "max":40, - "min":1 - }, - "NonEmptyBase64EncodedString":{ - "type":"string", - "pattern":"(^(?:[A-Za-z0-9\\+/]{4})*(?:[A-Za-z0-9\\+/]{2}==|[A-Za-z0-9\\+/]{3}=)?$)" - }, - "Notifications":{ - "type":"structure", - "members":{ - "Progressing":{ - "shape":"SnsTopic", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process the job.

" - }, - "Completed":{ - "shape":"SnsTopic", - "documentation":"

The Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing the job.

" - }, - "Warning":{ - "shape":"SnsTopic", - "documentation":"

The Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition.

" - }, - "Error":{ - "shape":"SnsTopic", - "documentation":"

The Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition.

" - } - }, - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) topic or topics to notify in order to report job status.

To receive notifications, you must also subscribe to the new topic in the Amazon SNS console.

" - }, - "NullableInteger":{"type":"integer"}, - "NullableLong":{"type":"long"}, - "OneTo512String":{ - "type":"string", - "max":512, - "min":1 - }, - "Opacity":{ - "type":"string", - "pattern":"^\\d{1,3}(\\.\\d{0,20})?$" - }, - "OutputKeys":{ - "type":"list", - "member":{"shape":"Key"}, - "max":30 - }, - "PaddingPolicy":{ - "type":"string", - "pattern":"(^Pad$)|(^NoPad$)" - }, - "Permission":{ - "type":"structure", - "members":{ - "GranteeType":{ - "shape":"GranteeType", - "documentation":"

The type of value that appears in the Grantee object:

  • Canonical: Either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution.

    A canonical user ID is not the same as an AWS account number.

  • Email: The registered email address of an AWS account.

  • Group: One of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

" - }, - "Grantee":{ - "shape":"Grantee", - "documentation":"

The AWS user or group that you want to have access to transcoded files and playlists. To identify the user or group, you can specify the canonical user ID for an AWS account, an origin access identity for a CloudFront distribution, the registered email address of an AWS account, or a predefined Amazon S3 group.

" - }, - "Access":{ - "shape":"AccessControls", - "documentation":"

The permission that you want to give to the AWS user that is listed in Grantee. Valid values include:

  • READ: The grantee can read the thumbnails and metadata for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • READ_ACP: The grantee can read the object ACL for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • WRITE_ACP: The grantee can write the ACL for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

" - } - }, - "documentation":"

The Permission structure.

" - }, - "Permissions":{ - "type":"list", - "member":{"shape":"Permission"}, - "max":30 - }, - "Pipeline":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier for the pipeline. You use this value to identify the pipeline in which you want to perform a variety of operations, such as creating a job or a preset.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the pipeline.

" - }, - "Name":{ - "shape":"Name", - "documentation":"

The name of the pipeline. We recommend that the name be unique within the AWS account, but uniqueness is not enforced.

Constraints: Maximum 40 characters

" - }, - "Status":{ - "shape":"PipelineStatus", - "documentation":"

The current status of the pipeline:

  • Active: The pipeline is processing jobs.

  • Paused: The pipeline is not currently processing jobs.

" - }, - "InputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket from which Elastic Transcoder gets media files for transcoding and the graphics files, if any, that you want to use for watermarks.

" - }, - "OutputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files, thumbnails, and playlists. Either you specify this value, or you specify both ContentConfig and ThumbnailConfig.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM Amazon Resource Name (ARN) for the role that Elastic Transcoder uses to transcode jobs for this pipeline.

" - }, - "AwsKmsKeyArn":{ - "shape":"KeyArn", - "documentation":"

The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

If you use either S3 or S3-AWS-KMS as your Encryption:Mode, you don't need to provide a key with your job because a default key, known as an AWS-KMS key, is created for you automatically. You need to provide an AWS-KMS key only if you want to use a non-default AWS-KMS key, or if you are using an Encryption:Mode of AES-PKCS7, AES-CTR, or AES-GCM.

" - }, - "Notifications":{ - "shape":"Notifications", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status.

To receive notifications, you must also subscribe to the new topic in the Amazon SNS console.

  • Progressing (optional): The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process the job.

  • Completed (optional): The Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing the job.

  • Warning (optional): The Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition.

  • Error (optional): The Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition.

" - }, - "ContentConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

Information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists. Either you specify both ContentConfig and ThumbnailConfig, or you specify OutputBucket.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists.

  • Permissions: A list of the users and/or predefined Amazon S3 groups you want to have access to transcoded files and playlists, and the type of access that you want them to have.

    • GranteeType: The type of value that appears in the Grantee object:

      • Canonical: Either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution.

      • Email: The registered email address of an AWS account.

      • Group: One of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

    • Grantee: The AWS user or group that you want to have access to transcoded files and playlists.

    • Access: The permission that you want to give to the AWS user that is listed in Grantee. Valid values include:

      • READ: The grantee can read the objects and metadata for objects that Elastic Transcoder adds to the Amazon S3 bucket.

      • READ_ACP: The grantee can read the object ACL for objects that Elastic Transcoder adds to the Amazon S3 bucket.

      • WRITE_ACP: The grantee can write the ACL for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

      • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the video files and playlists that it stores in your Amazon S3 bucket.

" - }, - "ThumbnailConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

Information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. Either you specify both ContentConfig and ThumbnailConfig, or you specify OutputBucket.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • Permissions: A list of the users and/or predefined Amazon S3 groups you want to have access to thumbnail files, and the type of access that you want them to have.

    • GranteeType: The type of value that appears in the Grantee object:

      • Canonical: Either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution.

        A canonical user ID is not the same as an AWS account number.

      • Email: The registered email address of an AWS account.

      • Group: One of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

    • Grantee: The AWS user or group that you want to have access to thumbnail files.

    • Access: The permission that you want to give to the AWS user that is listed in Grantee. Valid values include:

      • READ: The grantee can read the thumbnails and metadata for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

      • READ_ACP: The grantee can read the object ACL for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

      • WRITE_ACP: The grantee can write the ACL for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

      • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the thumbnails that it stores in your Amazon S3 bucket.

" - } - }, - "documentation":"

The pipeline (queue) that is used to manage jobs.

" - }, - "PipelineOutputConfig":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files. Specify this value when all of the following are true:

  • You want to save transcoded files, thumbnails (if any), and playlists (if any) together in one bucket.

  • You do not want to specify the users or groups who have access to the transcoded files, thumbnails, and playlists.

  • You do not want to specify the permissions that Elastic Transcoder grants to the files.

  • You want to associate the transcoded files and thumbnails with the Amazon S3 Standard storage class.

If you want to save transcoded files and playlists in one bucket and thumbnails in another bucket, specify which users can access the transcoded files or the permissions the users have, or change the Amazon S3 storage class, omit OutputBucket and specify values for ContentConfig and ThumbnailConfig instead.

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the video files and playlists that it stores in your Amazon S3 bucket.

" - }, - "Permissions":{ - "shape":"Permissions", - "documentation":"

Optional. The Permissions object specifies which users and/or predefined Amazon S3 groups you want to have access to transcoded files and playlists, and the type of access you want them to have. You can grant permissions to a maximum of 30 users and/or predefined Amazon S3 groups.

If you include Permissions, Elastic Transcoder grants only the permissions that you specify. It does not grant full permissions to the owner of the role specified by Role. If you want that user to have full control, you must explicitly grant full control to the user.

If you omit Permissions, Elastic Transcoder grants full control over the transcoded files and playlists to the owner of the role specified by Role, and grants no other permissions to any other user or group.

" - } - }, - "documentation":"

The PipelineOutputConfig structure.

" - }, - "PipelineStatus":{ - "type":"string", - "pattern":"(^Active$)|(^Paused$)" - }, - "Pipelines":{ - "type":"list", - "member":{"shape":"Pipeline"} - }, - "PixelsOrPercent":{ - "type":"string", - "pattern":"(^\\d{1,3}(\\.\\d{0,5})?%$)|(^\\d{1,4}?px$)" - }, - "PlayReadyDrm":{ - "type":"structure", - "members":{ - "Format":{ - "shape":"PlayReadyDrmFormatString", - "documentation":"

The type of DRM, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

" - }, - "Key":{ - "shape":"NonEmptyBase64EncodedString", - "documentation":"

The DRM key for your file, provided by your DRM license provider. The key must be base64-encoded, and it must be one of the following bit lengths before being base64-encoded:

128, 192, or 256.

The key must also be encrypted by using AWS KMS.

" - }, - "KeyMd5":{ - "shape":"NonEmptyBase64EncodedString", - "documentation":"

The MD5 digest of the key used for DRM on your file, and that you want Elastic Transcoder to use as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.

" - }, - "KeyId":{ - "shape":"KeyIdGuid", - "documentation":"

The ID for your DRM key, so that your DRM license provider knows which key to provide.

The key ID must be provided in big endian, and Elastic Transcoder converts it to little endian before inserting it into the PlayReady DRM headers. If you are unsure whether your license server provides your key ID in big or little endian, check with your DRM provider.

" - }, - "InitializationVector":{ - "shape":"ZeroTo255String", - "documentation":"

The series of random bits created by a random bit generator, unique for every encryption operation, that you want Elastic Transcoder to use to encrypt your files. The initialization vector must be base64-encoded, and it must be exactly 8 bytes long before being base64-encoded. If no initialization vector is provided, Elastic Transcoder generates one for you.

" - }, - "LicenseAcquisitionUrl":{ - "shape":"OneTo512String", - "documentation":"

The location of the license key required to play DRM content. The URL must be an absolute path, and is referenced by the PlayReady header. The PlayReady header is referenced in the protection header of the client manifest for Smooth Streaming outputs, and in the EXT-X-DXDRM and EXT-XDXDRMINFO metadata tags for HLS playlist outputs. An example URL looks like this: https://www.example.com/exampleKey/

" - } - }, - "documentation":"

The PlayReady DRM settings, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

PlayReady DRM encrypts your media files using AES-CTR encryption.

If you use DRM for an HLSv3 playlist, your outputs must have a master playlist.

" - }, - "PlayReadyDrmFormatString":{ - "type":"string", - "pattern":"(^microsoft$)|(^discretix-3.0$)" - }, - "Playlist":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Filename", - "documentation":"

The name that you want Elastic Transcoder to assign to the master playlist, for example, nyc-vacation.m3u8. If the name includes a / character, the section of the name before the last / must be identical for all Name objects. If you create more than one master playlist, the values of all Name objects must be unique.

Elastic Transcoder automatically appends the relevant file extension to the file name (.m3u8 for HLSv3 and HLSv4 playlists, and .ism and .ismc for Smooth playlists). If you include a file extension in Name, the file name will have two extensions.

" - }, - "Format":{ - "shape":"PlaylistFormat", - "documentation":"

The format of the output playlist. Valid formats include HLSv3, HLSv4, and Smooth.

" - }, - "OutputKeys":{ - "shape":"OutputKeys", - "documentation":"

For each output in this job that you want to include in a master playlist, the value of the Outputs:Key object.

  • If your output is not HLS or does not have a segment duration set, the name of the output file is a concatenation of OutputKeyPrefix and Outputs:Key:

    OutputKeyPrefixOutputs:Key

  • If your output is HLSv3 and has a segment duration set, or is not included in a playlist, Elastic Transcoder creates an output playlist file with a file extension of .m3u8, and a series of .ts files that include a five-digit sequential counter beginning with 00000:

    OutputKeyPrefixOutputs:Key.m3u8

    OutputKeyPrefixOutputs:Key00000.ts

  • If your output is HLSv4, has a segment duration set, and is included in an HLSv4 playlist, Elastic Transcoder creates an output playlist file with a file extension of _v4.m3u8. If the output is video, Elastic Transcoder also creates an output file with an extension of _iframe.m3u8:

    OutputKeyPrefixOutputs:Key_v4.m3u8

    OutputKeyPrefixOutputs:Key_iframe.m3u8

    OutputKeyPrefixOutputs:Key.ts

Elastic Transcoder automatically appends the relevant file extension to the file name. If you include a file extension in Output Key, the file name will have two extensions.

If you include more than one output in a playlist, any segment duration settings, clip settings, or caption settings must be the same for all outputs in the playlist. For Smooth playlists, the Audio:Profile, Video:Profile, and Video:FrameRate to Video:KeyframesMaxDist ratio must be the same for all outputs.

" - }, - "HlsContentProtection":{ - "shape":"HlsContentProtection", - "documentation":"

The HLS content protection settings, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

" - }, - "PlayReadyDrm":{ - "shape":"PlayReadyDrm", - "documentation":"

The DRM settings, if any, that you want Elastic Transcoder to apply to the output files associated with this playlist.

" - }, - "Status":{ - "shape":"JobStatus", - "documentation":"

The status of the job with which the playlist is associated.

" - }, - "StatusDetail":{ - "shape":"Description", - "documentation":"

Information that further explains the status.

" - } - }, - "documentation":"

Use Only for Fragmented MP4 or MPEG-TS Outputs. If you specify a preset for which the value of Container is fmp4 (Fragmented MP4) or ts (MPEG-TS), Playlists contains information about the master playlists that you want Elastic Transcoder to create. We recommend that you create only one master playlist per output format. The maximum number of master playlists in a job is 30.

" - }, - "PlaylistFormat":{ - "type":"string", - "pattern":"(^HLSv3$)|(^HLSv4$)|(^Smooth$)|(^MPEG-DASH$)" - }, - "Playlists":{ - "type":"list", - "member":{"shape":"Playlist"} - }, - "Preset":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

Identifier for the new preset. You use this value to get settings for the preset or to delete it.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the preset.

" - }, - "Name":{ - "shape":"Name", - "documentation":"

The name of the preset.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the preset.

" - }, - "Container":{ - "shape":"PresetContainer", - "documentation":"

The container type for the output file. Valid values include flac, flv, fmp4, gif, mp3, mp4, mpg, mxf, oga, ogg, ts, and webm.

" - }, - "Audio":{ - "shape":"AudioParameters", - "documentation":"

A section of the response body that provides information about the audio preset values.

" - }, - "Video":{ - "shape":"VideoParameters", - "documentation":"

A section of the response body that provides information about the video preset values.

" - }, - "Thumbnails":{ - "shape":"Thumbnails", - "documentation":"

A section of the response body that provides information about the thumbnail preset values, if any.

" - }, - "Type":{ - "shape":"PresetType", - "documentation":"

Whether the preset is a default preset provided by Elastic Transcoder (System) or a preset that you have defined (Custom).

" - } - }, - "documentation":"

Presets are templates that contain most of the settings for transcoding media files from one format to another. Elastic Transcoder includes some default presets for common formats, for example, several iPod and iPhone versions. You can also create your own presets for formats that aren't included among the default presets. You specify which preset you want to use when you create a job.

" - }, - "PresetContainer":{ - "type":"string", - "pattern":"(^mp4$)|(^ts$)|(^webm$)|(^mp3$)|(^flac$)|(^oga$)|(^ogg$)|(^fmp4$)|(^mpg$)|(^flv$)|(^gif$)|(^mxf$)|(^wav$)" - }, - "PresetType":{ - "type":"string", - "pattern":"(^System$)|(^Custom$)" - }, - "PresetWatermark":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"PresetWatermarkId", - "documentation":"

A unique identifier for the settings for one watermark. The value of Id can be up to 40 characters long.

" - }, - "MaxWidth":{ - "shape":"PixelsOrPercent", - "documentation":"

The maximum width of the watermark in one of the following formats:

  • number of pixels (px): The minimum value is 16 pixels, and the maximum value is the value of MaxWidth.

  • integer percentage (%): The range of valid values is 0 to 100. Use the value of Target to specify whether you want Elastic Transcoder to include the black bars that are added by Elastic Transcoder, if any, in the calculation.

    If you specify the value in pixels, it must be less than or equal to the value of MaxWidth.

" - }, - "MaxHeight":{ - "shape":"PixelsOrPercent", - "documentation":"

The maximum height of the watermark in one of the following formats:

  • number of pixels (px): The minimum value is 16 pixels, and the maximum value is the value of MaxHeight.

  • integer percentage (%): The range of valid values is 0 to 100. Use the value of Target to specify whether you want Elastic Transcoder to include the black bars that are added by Elastic Transcoder, if any, in the calculation.

If you specify the value in pixels, it must be less than or equal to the value of MaxHeight.

" - }, - "SizingPolicy":{ - "shape":"WatermarkSizingPolicy", - "documentation":"

A value that controls scaling of the watermark:

  • Fit: Elastic Transcoder scales the watermark so it matches the value that you specified in either MaxWidth or MaxHeight without exceeding the other value.

  • Stretch: Elastic Transcoder stretches the watermark to match the values that you specified for MaxWidth and MaxHeight. If the relative proportions of the watermark and the values of MaxWidth and MaxHeight are different, the watermark will be distorted.

  • ShrinkToFit: Elastic Transcoder scales the watermark down so that its dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale the watermark up.

" - }, - "HorizontalAlign":{ - "shape":"HorizontalAlign", - "documentation":"

The horizontal position of the watermark unless you specify a non-zero value for HorizontalOffset:

  • Left: The left edge of the watermark is aligned with the left border of the video.

  • Right: The right edge of the watermark is aligned with the right border of the video.

  • Center: The watermark is centered between the left and right borders.

" - }, - "HorizontalOffset":{ - "shape":"PixelsOrPercent", - "documentation":"

The amount by which you want the horizontal position of the watermark to be offset from the position specified by HorizontalAlign:

  • number of pixels (px): The minimum value is 0 pixels, and the maximum value is the value of MaxWidth.

  • integer percentage (%): The range of valid values is 0 to 100.

For example, if you specify Left for HorizontalAlign and 5px for HorizontalOffset, the left side of the watermark appears 5 pixels from the left border of the output video.

HorizontalOffset is only valid when the value of HorizontalAlign is Left or Right. If you specify an offset that causes the watermark to extend beyond the left or right border and Elastic Transcoder has not added black bars, the watermark is cropped. If Elastic Transcoder has added black bars, the watermark extends into the black bars. If the watermark extends beyond the black bars, it is cropped.

Use the value of Target to specify whether you want to include the black bars that are added by Elastic Transcoder, if any, in the offset calculation.

" - }, - "VerticalAlign":{ - "shape":"VerticalAlign", - "documentation":"

The vertical position of the watermark unless you specify a non-zero value for VerticalOffset:

  • Top: The top edge of the watermark is aligned with the top border of the video.

  • Bottom: The bottom edge of the watermark is aligned with the bottom border of the video.

  • Center: The watermark is centered between the top and bottom borders.

" - }, - "VerticalOffset":{ - "shape":"PixelsOrPercent", - "documentation":"

VerticalOffset

The amount by which you want the vertical position of the watermark to be offset from the position specified by VerticalAlign:

  • number of pixels (px): The minimum value is 0 pixels, and the maximum value is the value of MaxHeight.

  • integer percentage (%): The range of valid values is 0 to 100.

For example, if you specify Top for VerticalAlign and 5px for VerticalOffset, the top of the watermark appears 5 pixels from the top border of the output video.

VerticalOffset is only valid when the value of VerticalAlign is Top or Bottom.

If you specify an offset that causes the watermark to extend beyond the top or bottom border and Elastic Transcoder has not added black bars, the watermark is cropped. If Elastic Transcoder has added black bars, the watermark extends into the black bars. If the watermark extends beyond the black bars, it is cropped.

Use the value of Target to specify whether you want Elastic Transcoder to include the black bars that are added by Elastic Transcoder, if any, in the offset calculation.

" - }, - "Opacity":{ - "shape":"Opacity", - "documentation":"

A percentage that indicates how much you want a watermark to obscure the video in the location where it appears. Valid values are 0 (the watermark is invisible) to 100 (the watermark completely obscures the video in the specified location). The datatype of Opacity is float.

Elastic Transcoder supports transparent .png graphics. If you use a transparent .png, the transparent portion of the video appears as if you had specified a value of 0 for Opacity. The .jpg file format doesn't support transparency.

" - }, - "Target":{ - "shape":"Target", - "documentation":"

A value that determines how Elastic Transcoder interprets values that you specified for HorizontalOffset, VerticalOffset, MaxWidth, and MaxHeight:

  • Content: HorizontalOffset and VerticalOffset values are calculated based on the borders of the video excluding black bars added by Elastic Transcoder, if any. In addition, MaxWidth and MaxHeight, if specified as a percentage, are calculated based on the borders of the video excluding black bars added by Elastic Transcoder, if any.

  • Frame: HorizontalOffset and VerticalOffset values are calculated based on the borders of the video including black bars added by Elastic Transcoder, if any. In addition, MaxWidth and MaxHeight, if specified as a percentage, are calculated based on the borders of the video including black bars added by Elastic Transcoder, if any.

" - } - }, - "documentation":"

Settings for the size, location, and opacity of graphics that you want Elastic Transcoder to overlay over videos that are transcoded using this preset. You can specify settings for up to four watermarks. Watermarks appear in the specified size and location, and with the specified opacity for the duration of the transcoded video.

Watermarks can be in .png or .jpg format. If you want to display a watermark that is not rectangular, use the .png format, which supports transparency.

When you create a job that uses this preset, you specify the .png or .jpg graphics that you want Elastic Transcoder to include in the transcoded videos. You can specify fewer graphics in the job than you specify watermark settings in the preset, which allows you to use the same preset for up to four watermarks that have different dimensions.

" - }, - "PresetWatermarkId":{ - "type":"string", - "max":40, - "min":1 - }, - "PresetWatermarks":{ - "type":"list", - "member":{"shape":"PresetWatermark"} - }, - "Presets":{ - "type":"list", - "member":{"shape":"Preset"} - }, - "ReadJobRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the job for which you want to get detailed information.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The ReadJobRequest structure.

" - }, - "ReadJobResponse":{ - "type":"structure", - "members":{ - "Job":{ - "shape":"Job", - "documentation":"

A section of the response body that provides information about the job.

" - } - }, - "documentation":"

The ReadJobResponse structure.

" - }, - "ReadPipelineRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the pipeline to read.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The ReadPipelineRequest structure.

" - }, - "ReadPipelineResponse":{ - "type":"structure", - "members":{ - "Pipeline":{ - "shape":"Pipeline", - "documentation":"

A section of the response body that provides information about the pipeline.

" - }, - "Warnings":{ - "shape":"Warnings", - "documentation":"

Elastic Transcoder returns a warning if the resources used by your pipeline are not in the same region as the pipeline.

Using resources in the same region, such as your Amazon S3 buckets, Amazon SNS notification topics, and AWS KMS key, reduces processing time and prevents cross-regional charges.

" - } - }, - "documentation":"

The ReadPipelineResponse structure.

" - }, - "ReadPresetRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the preset for which you want to get detailed information.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The ReadPresetRequest structure.

" - }, - "ReadPresetResponse":{ - "type":"structure", - "members":{ - "Preset":{ - "shape":"Preset", - "documentation":"

A section of the response body that provides information about the preset.

" - } - }, - "documentation":"

The ReadPresetResponse structure.

" - }, - "Resolution":{ - "type":"string", - "pattern":"(^auto$)|(^\\d{1,5}x\\d{1,5}$)" - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The resource you are attempting to change is in use. For example, you are attempting to delete a pipeline that is currently in use.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested resource does not exist or is not available. For example, the pipeline to which you're trying to add a job doesn't exist or is still being created.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Role":{ - "type":"string", - "pattern":"^arn:aws:iam::\\w{12}:role/.+$" - }, - "Rotate":{ - "type":"string", - "pattern":"(^auto$)|(^0$)|(^90$)|(^180$)|(^270$)" - }, - "SizingPolicy":{ - "type":"string", - "pattern":"(^Fit$)|(^Fill$)|(^Stretch$)|(^Keep$)|(^ShrinkToFit$)|(^ShrinkToFill$)" - }, - "SnsTopic":{ - "type":"string", - "pattern":"(^$)|(^arn:aws:sns:.*:\\w{12}:.+$)" - }, - "SnsTopics":{ - "type":"list", - "member":{"shape":"SnsTopic"}, - "max":30 - }, - "StorageClass":{ - "type":"string", - "pattern":"(^ReducedRedundancy$)|(^Standard$)" - }, - "String":{"type":"string"}, - "Success":{ - "type":"string", - "pattern":"(^true$)|(^false$)" - }, - "Target":{ - "type":"string", - "pattern":"(^Content$)|(^Frame$)" - }, - "TestRoleRequest":{ - "type":"structure", - "required":[ - "Role", - "InputBucket", - "OutputBucket", - "Topics" - ], - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to test.

" - }, - "InputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket that contains media files to be transcoded. The action attempts to read from this bucket.

" - }, - "OutputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket that Elastic Transcoder writes transcoded media files to. The action attempts to read from this bucket.

" - }, - "Topics":{ - "shape":"SnsTopics", - "documentation":"

The ARNs of one or more Amazon Simple Notification Service (Amazon SNS) topics that you want the action to send a test notification to.

" - } - }, - "documentation":"

The TestRoleRequest structure.

", - "deprecated":true - }, - "TestRoleResponse":{ - "type":"structure", - "members":{ - "Success":{ - "shape":"Success", - "documentation":"

If the operation is successful, this value is true; otherwise, the value is false.

" - }, - "Messages":{ - "shape":"ExceptionMessages", - "documentation":"

If the Success element contains false, this value is an array of one or more error messages that were generated during the test process.

" - } - }, - "documentation":"

The TestRoleResponse structure.

", - "deprecated":true - }, - "ThumbnailPattern":{ - "type":"string", - "pattern":"(^$)|(^.*\\{count\\}.*$)" - }, - "ThumbnailResolution":{ - "type":"string", - "pattern":"^\\d{1,5}x\\d{1,5}$" - }, - "Thumbnails":{ - "type":"structure", - "members":{ - "Format":{ - "shape":"JpgOrPng", - "documentation":"

The format of thumbnails, if any. Valid values are jpg and png.

You specify whether you want Elastic Transcoder to create thumbnails when you create a job.

" - }, - "Interval":{ - "shape":"Digits", - "documentation":"

The approximate number of seconds between thumbnails. Specify an integer value.

" - }, - "Resolution":{ - "shape":"ThumbnailResolution", - "documentation":"

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The width and height of thumbnail files in pixels. Specify a value in the format width x height where both values are even integers. The values cannot exceed the width and height that you specified in the Video:Resolution object.

" - }, - "AspectRatio":{ - "shape":"AspectRatio", - "documentation":"

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The aspect ratio of thumbnails. Valid values include:

auto, 1:1, 4:3, 3:2, 16:9

If you specify auto, Elastic Transcoder tries to preserve the aspect ratio of the video in the output file.

" - }, - "MaxWidth":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum width of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1920 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 4096.

" - }, - "MaxHeight":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum height of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 3072.

" - }, - "SizingPolicy":{ - "shape":"SizingPolicy", - "documentation":"

Specify one of the following values to control scaling of thumbnails:

  • Fit: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings without exceeding the other value.

  • Fill: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings and matches or exceeds the other value. Elastic Transcoder centers the image in thumbnails and then crops in the dimension (if any) that exceeds the maximum value.

  • Stretch: Elastic Transcoder stretches thumbnails to match the values that you specified for thumbnail MaxWidth and MaxHeight settings. If the relative proportions of the input video and thumbnails are different, the thumbnails will be distorted.

  • Keep: Elastic Transcoder does not scale thumbnails. If either dimension of the input video exceeds the values that you specified for thumbnail MaxWidth and MaxHeight settings, Elastic Transcoder crops the thumbnails.

  • ShrinkToFit: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of thumbnail MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

  • ShrinkToFill: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without dropping below either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

" - }, - "PaddingPolicy":{ - "shape":"PaddingPolicy", - "documentation":"

When you set PaddingPolicy to Pad, Elastic Transcoder may add black bars to the top and bottom and/or left and right sides of thumbnails to make the total size of the thumbnails match the values that you specified for thumbnail MaxWidth and MaxHeight settings.

" - } - }, - "documentation":"

Thumbnails for videos.

" - }, - "Time":{ - "type":"string", - "pattern":"(^\\d{1,5}(\\.\\d{0,3})?$)|(^([0-1]?[0-9]:|2[0-3]:)?([0-5]?[0-9]:)?[0-5]?[0-9](\\.\\d{0,3})?$)" - }, - "TimeOffset":{ - "type":"string", - "pattern":"(^[+-]?\\d{1,5}(\\.\\d{0,3})?$)|(^[+-]?([0-1]?[0-9]:|2[0-3]:)?([0-5]?[0-9]:)?[0-5]?[0-9](\\.\\d{0,3})?$)" - }, - "TimeSpan":{ - "type":"structure", - "members":{ - "StartTime":{ - "shape":"Time", - "documentation":"

The place in the input file where you want a clip to start. The format can be either HH:mm:ss.SSS (maximum value: 23:59:59.999; SSS is thousandths of a second) or sssss.SSS (maximum value: 86399.999). If you don't specify a value, Elastic Transcoder starts at the beginning of the input file.

" - }, - "Duration":{ - "shape":"Time", - "documentation":"

The duration of the clip. The format can be either HH:mm:ss.SSS (maximum value: 23:59:59.999; SSS is thousandths of a second) or sssss.SSS (maximum value: 86399.999). If you don't specify a value, Elastic Transcoder creates an output file from StartTime to the end of the file.

If you specify a value longer than the duration of the input file, Elastic Transcoder transcodes the file and returns a warning message.

" - } - }, - "documentation":"

Settings that determine when a clip begins and how long it lasts.

" - }, - "Timing":{ - "type":"structure", - "members":{ - "SubmitTimeMillis":{ - "shape":"NullableLong", - "documentation":"

The time the job was submitted to Elastic Transcoder, in epoch milliseconds.

" - }, - "StartTimeMillis":{ - "shape":"NullableLong", - "documentation":"

The time the job began transcoding, in epoch milliseconds.

" - }, - "FinishTimeMillis":{ - "shape":"NullableLong", - "documentation":"

The time the job finished transcoding, in epoch milliseconds.

" - } - }, - "documentation":"

Details about the timing of a job.

" - }, - "UpdatePipelineNotificationsRequest":{ - "type":"structure", - "required":[ - "Id", - "Notifications" - ], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the pipeline for which you want to change notification settings.

", - "location":"uri", - "locationName":"Id" - }, - "Notifications":{ - "shape":"Notifications", - "documentation":"

The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status.

To receive notifications, you must also subscribe to the new topic in the Amazon SNS console.

  • Progressing: The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process jobs that are added to this pipeline. This is the ARN that Amazon SNS returned when you created the topic.

  • Completed: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing a job. This is the ARN that Amazon SNS returned when you created the topic.

  • Warning: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition. This is the ARN that Amazon SNS returned when you created the topic.

  • Error: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition. This is the ARN that Amazon SNS returned when you created the topic.

" - } - }, - "documentation":"

The UpdatePipelineNotificationsRequest structure.

" - }, - "UpdatePipelineNotificationsResponse":{ - "type":"structure", - "members":{ - "Pipeline":{ - "shape":"Pipeline", - "documentation":"

A section of the response body that provides information about the pipeline associated with this notification.

" - } - }, - "documentation":"

The UpdatePipelineNotificationsResponse structure.

" - }, - "UpdatePipelineRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The ID of the pipeline that you want to update.

", - "location":"uri", - "locationName":"Id" - }, - "Name":{ - "shape":"Name", - "documentation":"

The name of the pipeline. We recommend that the name be unique within the AWS account, but uniqueness is not enforced.

Constraints: Maximum 40 characters

" - }, - "InputBucket":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket in which you saved the media files that you want to transcode and the graphics that you want to use as watermarks.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.

" - }, - "AwsKmsKeyArn":{ - "shape":"KeyArn", - "documentation":"

The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

If you use either S3 or S3-AWS-KMS as your Encryption:Mode, you don't need to provide a key with your job because a default key, known as an AWS-KMS key, is created for you automatically. You need to provide an AWS-KMS key only if you want to use a non-default AWS-KMS key, or if you are using an Encryption:Mode of AES-PKCS7, AES-CTR, or AES-GCM.

" - }, - "Notifications":{ - "shape":"Notifications", - "documentation":"

The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status.

To receive notifications, you must also subscribe to the new topic in the Amazon SNS console.

  • Progressing: The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process jobs that are added to this pipeline. This is the ARN that Amazon SNS returned when you created the topic.

  • Completed: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing a job. This is the ARN that Amazon SNS returned when you created the topic.

  • Warning: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition. This is the ARN that Amazon SNS returned when you created the topic.

  • Error: The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition. This is the ARN that Amazon SNS returned when you created the topic.

" - }, - "ContentConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

The optional ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists: which bucket to use, which users you want to have access to the files, the type of access you want users to have, and the storage class that you want to assign to the files.

If you specify values for ContentConfig, you must also specify values for ThumbnailConfig.

If you specify values for ContentConfig and ThumbnailConfig, omit the OutputBucket object.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists.

  • Permissions (Optional): The Permissions object specifies which users you want to have access to transcoded files and the type of access you want them to have. You can grant permissions to a maximum of 30 users and/or predefined Amazon S3 groups.

  • Grantee Type: Specify the type of value that appears in the Grantee object:

    • Canonical: The value in the Grantee object is either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution. For more information about canonical user IDs, see Access Control List (ACL) Overview in the Amazon Simple Storage Service Developer Guide. For more information about using CloudFront origin access identities to require that users use CloudFront URLs instead of Amazon S3 URLs, see Using an Origin Access Identity to Restrict Access to Your Amazon S3 Content.

      A canonical user ID is not the same as an AWS account number.

    • Email: The value in the Grantee object is the registered email address of an AWS account.

    • Group: The value in the Grantee object is one of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

  • Grantee: The AWS user or group that you want to have access to transcoded files and playlists. To identify the user or group, you can specify the canonical user ID for an AWS account, an origin access identity for a CloudFront distribution, the registered email address of an AWS account, or a predefined Amazon S3 group

  • Access: The permission that you want to give to the AWS user that you specified in Grantee. Permissions are granted on the files that Elastic Transcoder adds to the bucket, including playlists and video files. Valid values include:

    • READ: The grantee can read the objects and metadata for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • READ_ACP: The grantee can read the object ACL for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • WRITE_ACP: The grantee can write the ACL for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the objects that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the video files and playlists that it stores in your Amazon S3 bucket.

" - }, - "ThumbnailConfig":{ - "shape":"PipelineOutputConfig", - "documentation":"

The ThumbnailConfig object specifies several values, including the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files, which users you want to have access to the files, the type of access you want users to have, and the storage class that you want to assign to the files.

If you specify values for ContentConfig, you must also specify values for ThumbnailConfig even if you don't want to create thumbnails.

If you specify values for ContentConfig and ThumbnailConfig, omit the OutputBucket object.

  • Bucket: The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • Permissions (Optional): The Permissions object specifies which users and/or predefined Amazon S3 groups you want to have access to thumbnail files, and the type of access you want them to have. You can grant permissions to a maximum of 30 users and/or predefined Amazon S3 groups.

  • GranteeType: Specify the type of value that appears in the Grantee object:

    • Canonical: The value in the Grantee object is either the canonical user ID for an AWS account or an origin access identity for an Amazon CloudFront distribution.

      A canonical user ID is not the same as an AWS account number.

    • Email: The value in the Grantee object is the registered email address of an AWS account.

    • Group: The value in the Grantee object is one of the following predefined Amazon S3 groups: AllUsers, AuthenticatedUsers, or LogDelivery.

  • Grantee: The AWS user or group that you want to have access to thumbnail files. To identify the user or group, you can specify the canonical user ID for an AWS account, an origin access identity for a CloudFront distribution, the registered email address of an AWS account, or a predefined Amazon S3 group.

  • Access: The permission that you want to give to the AWS user that you specified in Grantee. Permissions are granted on the thumbnail files that Elastic Transcoder adds to the bucket. Valid values include:

    • READ: The grantee can read the thumbnails and metadata for objects that Elastic Transcoder adds to the Amazon S3 bucket.

    • READ_ACP: The grantee can read the object ACL for thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

    • WRITE_ACP: The grantee can write the ACL for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

    • FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP permissions for the thumbnails that Elastic Transcoder adds to the Amazon S3 bucket.

  • StorageClass: The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the thumbnails that it stores in your Amazon S3 bucket.

" - } - }, - "documentation":"

The UpdatePipelineRequest structure.

" - }, - "UpdatePipelineResponse":{ - "type":"structure", - "members":{ - "Pipeline":{ - "shape":"Pipeline", - "documentation":"

The pipeline updated by this UpdatePipelineResponse call.

" - }, - "Warnings":{ - "shape":"Warnings", - "documentation":"

Elastic Transcoder returns a warning if the resources used by your pipeline are not in the same region as the pipeline.

Using resources in the same region, such as your Amazon S3 buckets, Amazon SNS notification topics, and AWS KMS key, reduces processing time and prevents cross-regional charges.

" - } - }, - "documentation":"

When you update a pipeline, Elastic Transcoder returns the values that you specified in the request.

" - }, - "UpdatePipelineStatusRequest":{ - "type":"structure", - "required":[ - "Id", - "Status" - ], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the pipeline to update.

", - "location":"uri", - "locationName":"Id" - }, - "Status":{ - "shape":"PipelineStatus", - "documentation":"

The desired status of the pipeline:

  • Active: The pipeline is processing jobs.

  • Paused: The pipeline is not currently processing jobs.

" - } - }, - "documentation":"

The UpdatePipelineStatusRequest structure.

" - }, - "UpdatePipelineStatusResponse":{ - "type":"structure", - "members":{ - "Pipeline":{ - "shape":"Pipeline", - "documentation":"

A section of the response body that provides information about the pipeline.

" - } - }, - "documentation":"

When you update status for a pipeline, Elastic Transcoder returns the values that you specified in the request.

" - }, - "UserMetadata":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "ValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more required parameter values were not provided in the request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "VerticalAlign":{ - "type":"string", - "pattern":"(^Top$)|(^Bottom$)|(^Center$)" - }, - "VideoBitRate":{ - "type":"string", - "pattern":"(^\\d{2,5}$)|(^auto$)" - }, - "VideoCodec":{ - "type":"string", - "pattern":"(^H\\.264$)|(^vp8$)|(^vp9$)|(^mpeg2$)|(^gif$)" - }, - "VideoParameters":{ - "type":"structure", - "members":{ - "Codec":{ - "shape":"VideoCodec", - "documentation":"

The video codec for the output file. Valid values include gif, H.264, mpeg2, vp8, and vp9. You can only specify vp8 and vp9 when the container type is webm, gif when the container type is gif, and mpeg2 when the container type is mpg.

" - }, - "CodecOptions":{ - "shape":"CodecOptions", - "documentation":"

Profile (H.264/VP8/VP9 Only)

The H.264 profile that you want to use for the output file. Elastic Transcoder supports the following profiles:

  • baseline: The profile most commonly used for videoconferencing and for mobile applications.

  • main: The profile used for standard-definition digital TV broadcasts.

  • high: The profile used for high-definition digital TV broadcasts and for Blu-ray discs.

Level (H.264 Only)

The H.264 level that you want to use for the output file. Elastic Transcoder supports the following levels:

1, 1b, 1.1, 1.2, 1.3, 2, 2.1, 2.2, 3, 3.1, 3.2, 4, 4.1

MaxReferenceFrames (H.264 Only)

Applicable only when the value of Video:Codec is H.264. The maximum number of previously decoded frames to use as a reference for decoding future frames. Valid values are integers 0 through 16, but we recommend that you not use a value greater than the following:

Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)

where Width in pixels and Height in pixels represent either MaxWidth and MaxHeight, or Resolution. Maximum decoded picture buffer in macroblocks depends on the value of the Level object. See the list below. (A macroblock is a block of pixels measuring 16x16.)

  • 1 - 396

  • 1b - 396

  • 1.1 - 900

  • 1.2 - 2376

  • 1.3 - 2376

  • 2 - 2376

  • 2.1 - 4752

  • 2.2 - 8100

  • 3 - 8100

  • 3.1 - 18000

  • 3.2 - 20480

  • 4 - 32768

  • 4.1 - 32768

MaxBitRate (Optional, H.264/MPEG2/VP8/VP9 only)

The maximum number of bits per second in a video buffer; the size of the buffer is specified by BufferSize. Specify a value between 16 and 62,500. You can reduce the bandwidth required to stream a video by reducing the maximum bit rate, but this also reduces the quality of the video.

BufferSize (Optional, H.264/MPEG2/VP8/VP9 only)

The maximum number of bits in any x seconds of the output video. This window is commonly 10 seconds, the standard segment duration when you're using FMP4 or MPEG-TS for the container type of the output video. Specify an integer greater than 0. If you specify MaxBitRate and omit BufferSize, Elastic Transcoder sets BufferSize to 10 times the value of MaxBitRate.

InterlacedMode (Optional, H.264/MPEG2 Only)

The interlace mode for the output video.

Interlaced video is used to double the perceived frame rate for a video by interlacing two fields (one field on every other line, the other field on the other lines) so that the human eye registers multiple pictures per frame. Interlacing reduces the bandwidth required for transmitting a video, but can result in blurred images and flickering.

Valid values include Progressive (no interlacing, top to bottom), TopFirst (top field first), BottomFirst (bottom field first), and Auto.

If InterlaceMode is not specified, Elastic Transcoder uses Progressive for the output. If Auto is specified, Elastic Transcoder interlaces the output.

ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)

The color space conversion Elastic Transcoder applies to the output video. Color spaces are the algorithms used by the computer to store information about how to render color. Bt.601 is the standard for standard definition video, while Bt.709 is the standard for high definition video.

Valid values include None, Bt709toBt601, Bt601toBt709, and Auto.

If you chose Auto for ColorSpaceConversionMode and your output is interlaced, your frame rate is one of 23.97, 24, 25, 29.97, 50, or 60, your SegmentDuration is null, and you are using one of the resolution changes from the list below, Elastic Transcoder applies the following color space conversions:

  • Standard to HD, 720x480 to 1920x1080 - Elastic Transcoder applies Bt601ToBt709

  • Standard to HD, 720x576 to 1920x1080 - Elastic Transcoder applies Bt601ToBt709

  • HD to Standard, 1920x1080 to 720x480 - Elastic Transcoder applies Bt709ToBt601

  • HD to Standard, 1920x1080 to 720x576 - Elastic Transcoder applies Bt709ToBt601

Elastic Transcoder may change the behavior of the ColorspaceConversionMode Auto mode in the future. All outputs in a playlist must use the same ColorSpaceConversionMode.

If you do not specify a ColorSpaceConversionMode, Elastic Transcoder does not change the color space of a file. If you are unsure what ColorSpaceConversionMode was applied to your output file, you can check the AppliedColorSpaceConversion parameter included in your job response. If your job does not have an AppliedColorSpaceConversion in its response, no ColorSpaceConversionMode was applied.

ChromaSubsampling

The sampling pattern for the chroma (color) channels of the output video. Valid values include yuv420p and yuv422p.

yuv420p samples the chroma information of every other horizontal and every other vertical line, yuv422p samples the color information of every horizontal line and every other vertical line.

LoopCount (Gif Only)

The number of times you want the output gif to loop. Valid values include Infinite and integers between 0 and 100, inclusive.

" - }, - "KeyframesMaxDist":{ - "shape":"KeyframesMaxDist", - "documentation":"

Applicable only when the value of Video:Codec is one of H.264, MPEG2, or VP8.

The maximum number of frames between key frames. Key frames are fully encoded frames; the frames between key frames are encoded based, in part, on the content of the key frames. The value is an integer formatted as a string; valid values are between 1 (every frame is a key frame) and 100000, inclusive. A higher value results in higher compression but may also discernibly decrease video quality.

For Smooth outputs, the FrameRate must have a constant ratio to the KeyframesMaxDist. This allows Smooth playlists to switch between different quality levels while the file is being played.

For example, an input file can have a FrameRate of 30 with a KeyframesMaxDist of 90. The output file then needs to have a ratio of 1:3. Valid outputs would have FrameRate of 30, 25, and 10, and KeyframesMaxDist of 90, 75, and 30, respectively.

Alternately, this can be achieved by setting FrameRate to auto and having the same values for MaxFrameRate and KeyframesMaxDist.

" - }, - "FixedGOP":{ - "shape":"FixedGOP", - "documentation":"

Applicable only when the value of Video:Codec is one of H.264, MPEG2, or VP8.

Whether to use a fixed value for FixedGOP. Valid values are true and false:

  • true: Elastic Transcoder uses the value of KeyframesMaxDist for the distance between key frames (the number of frames in a group of pictures, or GOP).

  • false: The distance between key frames can vary.

FixedGOP must be set to true for fmp4 containers.

" - }, - "BitRate":{ - "shape":"VideoBitRate", - "documentation":"

The bit rate of the video stream in the output file, in kilobits/second. Valid values depend on the values of Level and Profile. If you specify auto, Elastic Transcoder uses the detected bit rate of the input source. If you specify a value other than auto, we recommend that you specify a value less than or equal to the maximum H.264-compliant value listed for your level and profile:

Level - Maximum video bit rate in kilobits/second (baseline and main Profile) : maximum video bit rate in kilobits/second (high Profile)

  • 1 - 64 : 80

  • 1b - 128 : 160

  • 1.1 - 192 : 240

  • 1.2 - 384 : 480

  • 1.3 - 768 : 960

  • 2 - 2000 : 2500

  • 3 - 10000 : 12500

  • 3.1 - 14000 : 17500

  • 3.2 - 20000 : 25000

  • 4 - 20000 : 25000

  • 4.1 - 50000 : 62500

" - }, - "FrameRate":{ - "shape":"FrameRate", - "documentation":"

The frames per second for the video stream in the output file. Valid values include:

auto, 10, 15, 23.97, 24, 25, 29.97, 30, 60

If you specify auto, Elastic Transcoder uses the detected frame rate of the input source. If you specify a frame rate, we recommend that you perform the following calculation:

Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)

where:

  • width in pixels and height in pixels represent the Resolution of the output video.

  • maximum recommended decoding speed in Luma samples/second is less than or equal to the maximum value listed in the following table, based on the value that you specified for Level.

The maximum recommended decoding speed in Luma samples/second for each level is described in the following list (Level - Decoding speed):

  • 1 - 380160

  • 1b - 380160

  • 1.1 - 76800

  • 1.2 - 1536000

  • 1.3 - 3041280

  • 2 - 3041280

  • 2.1 - 5068800

  • 2.2 - 5184000

  • 3 - 10368000

  • 3.1 - 27648000

  • 3.2 - 55296000

  • 4 - 62914560

  • 4.1 - 62914560

" - }, - "MaxFrameRate":{ - "shape":"MaxFrameRate", - "documentation":"

If you specify auto for FrameRate, Elastic Transcoder uses the frame rate of the input video for the frame rate of the output video. Specify the maximum frame rate that you want Elastic Transcoder to use when the frame rate of the input video is greater than the desired maximum frame rate of the output video. Valid values include: 10, 15, 23.97, 24, 25, 29.97, 30, 60.

" - }, - "Resolution":{ - "shape":"Resolution", - "documentation":"

To better control resolution and aspect ratio of output videos, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, PaddingPolicy, and DisplayAspectRatio instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The width and height of the video in the output file, in pixels. Valid values are auto and width x height:

  • auto: Elastic Transcoder attempts to preserve the width and height of the input file, subject to the following rules.

  • width x height : The width and height of the output video in pixels.

Note the following about specifying the width and height:

  • The width must be an even integer between 128 and 4096, inclusive.

  • The height must be an even integer between 96 and 3072, inclusive.

  • If you specify a resolution that is less than the resolution of the input file, Elastic Transcoder rescales the output file to the lower resolution.

  • If you specify a resolution that is greater than the resolution of the input file, Elastic Transcoder rescales the output to the higher resolution.

  • We recommend that you specify a resolution for which the product of width and height is less than or equal to the applicable value in the following list (List - Max width x height value):

    • 1 - 25344

    • 1b - 25344

    • 1.1 - 101376

    • 1.2 - 101376

    • 1.3 - 101376

    • 2 - 101376

    • 2.1 - 202752

    • 2.2 - 404720

    • 3 - 404720

    • 3.1 - 921600

    • 3.2 - 1310720

    • 4 - 2097152

    • 4.1 - 2097152

" - }, - "AspectRatio":{ - "shape":"AspectRatio", - "documentation":"

To better control resolution and aspect ratio of output videos, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, PaddingPolicy, and DisplayAspectRatio instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The display aspect ratio of the video in the output file. Valid values include:

auto, 1:1, 4:3, 3:2, 16:9

If you specify auto, Elastic Transcoder tries to preserve the aspect ratio of the input file.

If you specify an aspect ratio for the output file that differs from aspect ratio of the input file, Elastic Transcoder adds pillarboxing (black bars on the sides) or letterboxing (black bars on the top and bottom) to maintain the aspect ratio of the active region of the video.

" - }, - "MaxWidth":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum width of the output video in pixels. If you specify auto, Elastic Transcoder uses 1920 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 128 and 4096.

" - }, - "MaxHeight":{ - "shape":"DigitsOrAuto", - "documentation":"

The maximum height of the output video in pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 96 and 3072.

" - }, - "DisplayAspectRatio":{ - "shape":"AspectRatio", - "documentation":"

The value that Elastic Transcoder adds to the metadata in the output file.

" - }, - "SizingPolicy":{ - "shape":"SizingPolicy", - "documentation":"

Specify one of the following values to control scaling of the output video:

  • Fit: Elastic Transcoder scales the output video so it matches the value that you specified in either MaxWidth or MaxHeight without exceeding the other value.

  • Fill: Elastic Transcoder scales the output video so it matches the value that you specified in either MaxWidth or MaxHeight and matches or exceeds the other value. Elastic Transcoder centers the output video and then crops it in the dimension (if any) that exceeds the maximum value.

  • Stretch: Elastic Transcoder stretches the output video to match the values that you specified for MaxWidth and MaxHeight. If the relative proportions of the input video and the output video are different, the output video will be distorted.

  • Keep: Elastic Transcoder does not scale the output video. If either dimension of the input video exceeds the values that you specified for MaxWidth and MaxHeight, Elastic Transcoder crops the output video.

  • ShrinkToFit: Elastic Transcoder scales the output video down so that its dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale the video up.

  • ShrinkToFill: Elastic Transcoder scales the output video down so that its dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without dropping below either value. If you specify this option, Elastic Transcoder does not scale the video up.

" - }, - "PaddingPolicy":{ - "shape":"PaddingPolicy", - "documentation":"

When you set PaddingPolicy to Pad, Elastic Transcoder may add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for MaxWidth and MaxHeight.

" - }, - "Watermarks":{ - "shape":"PresetWatermarks", - "documentation":"

Settings for the size, location, and opacity of graphics that you want Elastic Transcoder to overlay over videos that are transcoded using this preset. You can specify settings for up to four watermarks. Watermarks appear in the specified size and location, and with the specified opacity for the duration of the transcoded video.

Watermarks can be in .png or .jpg format. If you want to display a watermark that is not rectangular, use the .png format, which supports transparency.

When you create a job that uses this preset, you specify the .png or .jpg graphics that you want Elastic Transcoder to include in the transcoded videos. You can specify fewer graphics in the job than you specify watermark settings in the preset, which allows you to use the same preset for up to four watermarks that have different dimensions.

" - } - }, - "documentation":"

The VideoParameters structure.

" - }, - "Warning":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"String", - "documentation":"

The code of the cross-regional warning.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The message explaining what resources are in a different region from the pipeline.

AWS KMS keys must be in the same region as the pipeline.

" - } - }, - "documentation":"

Elastic Transcoder returns a warning if the resources used by your pipeline are not in the same region as the pipeline.

Using resources in the same region, such as your Amazon S3 buckets, Amazon SNS notification topics, and AWS KMS key, reduces processing time and prevents cross-regional charges.

" - }, - "Warnings":{ - "type":"list", - "member":{"shape":"Warning"} - }, - "WatermarkKey":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"(^.{1,1020}.jpg$)|(^.{1,1019}.jpeg$)|(^.{1,1020}.png$)" - }, - "WatermarkSizingPolicy":{ - "type":"string", - "pattern":"(^Fit$)|(^Stretch$)|(^ShrinkToFit$)" - }, - "ZeroTo255String":{ - "type":"string", - "max":255, - "min":0 - }, - "ZeroTo512String":{ - "type":"string", - "max":512, - "min":0 - } - }, - "documentation":"AWS Elastic Transcoder Service

The AWS Elastic Transcoder Service.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/waiters-2.json deleted file mode 100644 index 55c36280..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elastictranscoder/2012-09-25/waiters-2.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "version": 2, - "waiters": { - "JobComplete": { - "delay": 30, - "operation": "ReadJob", - "maxAttempts": 120, - "acceptors": [ - { - "expected": "Complete", - "matcher": "path", - "state": "success", - "argument": "Job.Status" - }, - { - "expected": "Canceled", - "matcher": "path", - "state": "failure", - "argument": "Job.Status" - }, - { - "expected": "Error", - "matcher": "path", - "state": "failure", - "argument": "Job.Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/examples-1.json deleted file mode 100644 index ce50fdd1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/examples-1.json +++ /dev/null @@ -1,1036 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddTags": [ - { - "input": { - "LoadBalancerNames": [ - "my-load-balancer" - ], - "Tags": [ - { - "Key": "project", - "Value": "lima" - }, - { - "Key": "department", - "Value": "digital-media" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds two tags to the specified load balancer.", - "id": "elb-add-tags-1", - "title": "To add tags to a load balancer" - } - ], - "ApplySecurityGroupsToLoadBalancer": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "SecurityGroups": [ - "sg-fc448899" - ] - }, - "output": { - "SecurityGroups": [ - "sg-fc448899" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates a security group with the specified load balancer in a VPC.", - "id": "elb-apply-security-groups-to-load-balancer-1", - "title": "To associate a security group with a load balancer in a VPC" - } - ], - "AttachLoadBalancerToSubnets": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "Subnets": [ - "subnet-0ecac448" - ] - }, - "output": { - "Subnets": [ - "subnet-15aaab61", - "subnet-0ecac448" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified subnet to the set of configured subnets for the specified load balancer.", - "id": "elb-attach-load-balancer-to-subnets-1", - "title": "To attach subnets to a load balancer" - } - ], - "ConfigureHealthCheck": [ - { - "input": { - "HealthCheck": { - "HealthyThreshold": 2, - "Interval": 30, - "Target": "HTTP:80/png", - "Timeout": 3, - "UnhealthyThreshold": 2 - }, - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "HealthCheck": { - "HealthyThreshold": 2, - "Interval": 30, - "Target": "HTTP:80/png", - "Timeout": 3, - "UnhealthyThreshold": 2 - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example specifies the health check settings used to evaluate the health of your backend EC2 instances.", - "id": "elb-configure-health-check-1", - "title": "To specify the health check settings for your backend EC2 instances" - } - ], - "CreateAppCookieStickinessPolicy": [ - { - "input": { - "CookieName": "my-app-cookie", - "LoadBalancerName": "my-load-balancer", - "PolicyName": "my-app-cookie-policy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example generates a stickiness policy that follows the sticky session lifetimes of the application-generated cookie.", - "id": "elb-create-app-cookie-stickiness-policy-1", - "title": "To generate a stickiness policy for your load balancer" - } - ], - "CreateLBCookieStickinessPolicy": [ - { - "input": { - "CookieExpirationPeriod": 60, - "LoadBalancerName": "my-load-balancer", - "PolicyName": "my-duration-cookie-policy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example generates a stickiness policy with sticky session lifetimes controlled by the specified expiration period.", - "id": "elb-create-lb-cookie-stickiness-policy-1", - "title": "To generate a duration-based stickiness policy for your load balancer" - } - ], - "CreateLoadBalancer": [ - { - "input": { - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - } - ], - "LoadBalancerName": "my-load-balancer", - "SecurityGroups": [ - "sg-a61988c3" - ], - "Subnets": [ - "subnet-15aaab61" - ] - }, - "output": { - "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a load balancer with an HTTP listener in a VPC.", - "id": "elb-create-load-balancer-1", - "title": "To create an HTTP load balancer in a VPC" - }, - { - "input": { - "AvailabilityZones": [ - "us-west-2a" - ], - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a load balancer with an HTTP listener in EC2-Classic.", - "id": "elb-create-load-balancer-2", - "title": "To create an HTTP load balancer in EC2-Classic" - }, - { - "input": { - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - }, - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 443, - "Protocol": "HTTPS", - "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - } - ], - "LoadBalancerName": "my-load-balancer", - "SecurityGroups": [ - "sg-a61988c3" - ], - "Subnets": [ - "subnet-15aaab61" - ] - }, - "output": { - "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a load balancer with an HTTPS listener in a VPC.", - "id": "elb-create-load-balancer-3", - "title": "To create an HTTPS load balancer in a VPC" - }, - { - "input": { - "AvailabilityZones": [ - "us-west-2a" - ], - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - }, - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 443, - "Protocol": "HTTPS", - "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a load balancer with an HTTPS listener in EC2-Classic.", - "id": "elb-create-load-balancer-4", - "title": "To create an HTTPS load balancer in EC2-Classic" - }, - { - "input": { - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - } - ], - "LoadBalancerName": "my-load-balancer", - "Scheme": "internal", - "SecurityGroups": [ - "sg-a61988c3" - ], - "Subnets": [ - "subnet-15aaab61" - ] - }, - "output": { - "DNSName": "internal-my-load-balancer-123456789.us-west-2.elb.amazonaws.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an internal load balancer with an HTTP listener in a VPC.", - "id": "elb-create-load-balancer-5", - "title": "To create an internal load balancer" - } - ], - "CreateLoadBalancerListeners": [ - { - "input": { - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a listener for your load balancer at port 80 using the HTTP protocol.", - "id": "elb-create-load-balancer-listeners-1", - "title": "To create an HTTP listener for a load balancer" - }, - { - "input": { - "Listeners": [ - { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 443, - "Protocol": "HTTPS", - "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a listener for your load balancer at port 443 using the HTTPS protocol.", - "id": "elb-create-load-balancer-listeners-2", - "title": "To create an HTTPS listener for a load balancer" - } - ], - "CreateLoadBalancerPolicy": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "PolicyAttributes": [ - { - "AttributeName": "ProxyProtocol", - "AttributeValue": "true" - } - ], - "PolicyName": "my-ProxyProtocol-policy", - "PolicyTypeName": "ProxyProtocolPolicyType" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a policy that enables Proxy Protocol on the specified load balancer.", - "id": "elb-create-load-balancer-policy-1", - "title": "To create a policy that enables Proxy Protocol on a load balancer" - }, - { - "input": { - "LoadBalancerName": "my-load-balancer", - "PolicyAttributes": [ - { - "AttributeName": "PublicKey", - "AttributeValue": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwAYUjnfyEyXr1pxjhFWBpMlggUcqoi3kl+dS74kj//c6x7ROtusUaeQCTgIUkayttRDWchuqo1pHC1u+n5xxXnBBe2ejbb2WRsKIQ5rXEeixsjFpFsojpSQKkzhVGI6mJVZBJDVKSHmswnwLBdofLhzvllpovBPTHe+o4haAWvDBALJU0pkSI1FecPHcs2hwxf14zHoXy1e2k36A64nXW43wtfx5qcVSIxtCEOjnYRg7RPvybaGfQ+v6Iaxb/+7J5kEvZhTFQId+bSiJImF1FSUT1W1xwzBZPUbcUkkXDj45vC2s3Z8E+Lk7a3uZhvsQHLZnrfuWjBWGWvZ/MhZYgEXAMPLE" - } - ], - "PolicyName": "my-PublicKey-policy", - "PolicyTypeName": "PublicKeyPolicyType" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a public key policy.", - "id": "elb-create-load-balancer-policy-2", - "title": "To create a public key policy" - }, - { - "input": { - "LoadBalancerName": "my-load-balancer", - "PolicyAttributes": [ - { - "AttributeName": "PublicKeyPolicyName", - "AttributeValue": "my-PublicKey-policy" - } - ], - "PolicyName": "my-authentication-policy", - "PolicyTypeName": "BackendServerAuthenticationPolicyType" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a backend server authentication policy that enables authentication on your backend instance using a public key policy.", - "id": "elb-create-load-balancer-policy-3", - "title": "To create a backend server authentication policy" - } - ], - "DeleteLoadBalancer": [ - { - "input": { - "LoadBalancerName": "my-load-balancer" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified load balancer.", - "id": "elb-delete-load-balancer-1", - "title": "To delete a load balancer" - } - ], - "DeleteLoadBalancerListeners": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "LoadBalancerPorts": [ - 80 - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the listener for the specified port from the specified load balancer.", - "id": "elb-delete-load-balancer-listeners-1", - "title": "To delete a listener from your load balancer" - } - ], - "DeleteLoadBalancerPolicy": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "PolicyName": "my-duration-cookie-policy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified policy from the specified load balancer. The policy must not be enabled on any listener.", - "id": "elb-delete-load-balancer-policy-1", - "title": "To delete a policy from your load balancer" - } - ], - "DeregisterInstancesFromLoadBalancer": [ - { - "input": { - "Instances": [ - { - "InstanceId": "i-d6f6fae3" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "Instances": [ - { - "InstanceId": "i-207d9717" - }, - { - "InstanceId": "i-afefb49b" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deregisters the specified instance from the specified load balancer.", - "id": "elb-deregister-instances-from-load-balancer-1", - "title": "To deregister instances from a load balancer" - } - ], - "DescribeInstanceHealth": [ - { - "input": { - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "InstanceStates": [ - { - "Description": "N/A", - "InstanceId": "i-207d9717", - "ReasonCode": "N/A", - "State": "InService" - }, - { - "Description": "N/A", - "InstanceId": "i-afefb49b", - "ReasonCode": "N/A", - "State": "InService" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the health of the instances for the specified load balancer.", - "id": "elb-describe-instance-health-1", - "title": "To describe the health of the instances for a load balancer" - } - ], - "DescribeLoadBalancerAttributes": [ - { - "input": { - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "LoadBalancerAttributes": { - "AccessLog": { - "Enabled": false - }, - "ConnectionDraining": { - "Enabled": false, - "Timeout": 300 - }, - "ConnectionSettings": { - "IdleTimeout": 60 - }, - "CrossZoneLoadBalancing": { - "Enabled": false - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attributes of the specified load balancer.", - "id": "elb-describe-load-balancer-attributes-1", - "title": "To describe the attributes of a load balancer" - } - ], - "DescribeLoadBalancerPolicies": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "PolicyNames": [ - "my-authentication-policy" - ] - }, - "output": { - "PolicyDescriptions": [ - { - "PolicyAttributeDescriptions": [ - { - "AttributeName": "PublicKeyPolicyName", - "AttributeValue": "my-PublicKey-policy" - } - ], - "PolicyName": "my-authentication-policy", - "PolicyTypeName": "BackendServerAuthenticationPolicyType" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified policy associated with the specified load balancer.", - "id": "elb-describe-load-balancer-policies-1", - "title": "To describe a policy associated with a load balancer" - } - ], - "DescribeLoadBalancerPolicyTypes": [ - { - "input": { - "PolicyTypeNames": [ - "ProxyProtocolPolicyType" - ] - }, - "output": { - "PolicyTypeDescriptions": [ - { - "Description": "Policy that controls whether to include the IP address and port of the originating request for TCP messages. This policy operates on TCP listeners only.", - "PolicyAttributeTypeDescriptions": [ - { - "AttributeName": "ProxyProtocol", - "AttributeType": "Boolean", - "Cardinality": "ONE" - } - ], - "PolicyTypeName": "ProxyProtocolPolicyType" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified load balancer policy type.", - "id": "elb-describe-load-balancer-policy-types-1", - "title": "To describe a load balancer policy type defined by Elastic Load Balancing" - } - ], - "DescribeLoadBalancers": [ - { - "input": { - "LoadBalancerNames": [ - "my-load-balancer" - ] - }, - "output": { - "LoadBalancerDescriptions": [ - { - "AvailabilityZones": [ - "us-west-2a" - ], - "BackendServerDescriptions": [ - { - "InstancePort": 80, - "PolicyNames": [ - "my-ProxyProtocol-policy" - ] - } - ], - "CanonicalHostedZoneName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com", - "CanonicalHostedZoneNameID": "Z3DZXE0EXAMPLE", - "CreatedTime": "2015-03-19T03:24:02.650Z", - "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com", - "HealthCheck": { - "HealthyThreshold": 2, - "Interval": 30, - "Target": "HTTP:80/png", - "Timeout": 3, - "UnhealthyThreshold": 2 - }, - "Instances": [ - { - "InstanceId": "i-207d9717" - }, - { - "InstanceId": "i-afefb49b" - } - ], - "ListenerDescriptions": [ - { - "Listener": { - "InstancePort": 80, - "InstanceProtocol": "HTTP", - "LoadBalancerPort": 80, - "Protocol": "HTTP" - }, - "PolicyNames": [ - - ] - }, - { - "Listener": { - "InstancePort": 443, - "InstanceProtocol": "HTTPS", - "LoadBalancerPort": 443, - "Protocol": "HTTPS", - "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - }, - "PolicyNames": [ - "ELBSecurityPolicy-2015-03" - ] - } - ], - "LoadBalancerName": "my-load-balancer", - "Policies": { - "AppCookieStickinessPolicies": [ - - ], - "LBCookieStickinessPolicies": [ - { - "CookieExpirationPeriod": 60, - "PolicyName": "my-duration-cookie-policy" - } - ], - "OtherPolicies": [ - "my-PublicKey-policy", - "my-authentication-policy", - "my-SSLNegotiation-policy", - "my-ProxyProtocol-policy", - "ELBSecurityPolicy-2015-03" - ] - }, - "Scheme": "internet-facing", - "SecurityGroups": [ - "sg-a61988c3" - ], - "SourceSecurityGroup": { - "GroupName": "my-elb-sg", - "OwnerAlias": "123456789012" - }, - "Subnets": [ - "subnet-15aaab61" - ], - "VPCId": "vpc-a01106c2" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified load balancer.", - "id": "elb-describe-load-balancers-1", - "title": "To describe one of your load balancers" - } - ], - "DescribeTags": [ - { - "input": { - "LoadBalancerNames": [ - "my-load-balancer" - ] - }, - "output": { - "TagDescriptions": [ - { - "LoadBalancerName": "my-load-balancer", - "Tags": [ - { - "Key": "project", - "Value": "lima" - }, - { - "Key": "department", - "Value": "digital-media" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the tags for the specified load balancer.", - "id": "elb-describe-tags-1", - "title": "To describe the tags for a load balancer" - } - ], - "DetachLoadBalancerFromSubnets": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "Subnets": [ - "subnet-0ecac448" - ] - }, - "output": { - "Subnets": [ - "subnet-15aaab61" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example detaches the specified load balancer from the specified subnet.", - "id": "elb-detach-load-balancer-from-subnets-1", - "title": "To detach a load balancer from a subnet" - } - ], - "DisableAvailabilityZonesForLoadBalancer": [ - { - "input": { - "AvailabilityZones": [ - "us-west-2a" - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "AvailabilityZones": [ - "us-west-2b" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example removes the specified Availability Zone from the set of Availability Zones for the specified load balancer.", - "id": "elb-disable-availability-zones-for-load-balancer-1", - "title": "To disable an Availability Zone for a load balancer" - } - ], - "EnableAvailabilityZonesForLoadBalancer": [ - { - "input": { - "AvailabilityZones": [ - "us-west-2b" - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "AvailabilityZones": [ - "us-west-2a", - "us-west-2b" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified Availability Zone to the specified load balancer.", - "id": "elb-enable-availability-zones-for-load-balancer-1", - "title": "To enable an Availability Zone for a load balancer" - } - ], - "ModifyLoadBalancerAttributes": [ - { - "input": { - "LoadBalancerAttributes": { - "CrossZoneLoadBalancing": { - "Enabled": true - } - }, - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "LoadBalancerAttributes": { - "CrossZoneLoadBalancing": { - "Enabled": true - } - }, - "LoadBalancerName": "my-load-balancer" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables cross-zone load balancing for the specified load balancer.", - "id": "elb-modify-load-balancer-attributes-1", - "title": "To enable cross-zone load balancing" - }, - { - "input": { - "LoadBalancerAttributes": { - "ConnectionDraining": { - "Enabled": true, - "Timeout": 300 - } - }, - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "LoadBalancerAttributes": { - "ConnectionDraining": { - "Enabled": true, - "Timeout": 300 - } - }, - "LoadBalancerName": "my-load-balancer" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables connection draining for the specified load balancer.", - "id": "elb-modify-load-balancer-attributes-2", - "title": "To enable connection draining" - } - ], - "RegisterInstancesWithLoadBalancer": [ - { - "input": { - "Instances": [ - { - "InstanceId": "i-d6f6fae3" - } - ], - "LoadBalancerName": "my-load-balancer" - }, - "output": { - "Instances": [ - { - "InstanceId": "i-d6f6fae3" - }, - { - "InstanceId": "i-207d9717" - }, - { - "InstanceId": "i-afefb49b" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers the specified instance with the specified load balancer.", - "id": "elb-register-instances-with-load-balancer-1", - "title": "To register instances with a load balancer" - } - ], - "RemoveTags": [ - { - "input": { - "LoadBalancerNames": [ - "my-load-balancer" - ], - "Tags": [ - { - "Key": "project" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example removes the specified tag from the specified load balancer.", - "id": "elb-remove-tags-1", - "title": "To remove tags from a load balancer" - } - ], - "SetLoadBalancerListenerSSLCertificate": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "LoadBalancerPort": 443, - "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/new-server-cert" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces the existing SSL certificate for the specified HTTPS listener.", - "id": "elb-set-load-balancer-listener-ssl-certificate-1", - "title": "To update the SSL certificate for an HTTPS listener" - } - ], - "SetLoadBalancerPoliciesForBackendServer": [ - { - "input": { - "InstancePort": 80, - "LoadBalancerName": "my-load-balancer", - "PolicyNames": [ - "my-ProxyProtocol-policy" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces the policies that are currently associated with the specified port.", - "id": "elb-set-load-balancer-policies-for-backend-server-1", - "title": "To replace the policies associated with a port for a backend instance" - } - ], - "SetLoadBalancerPoliciesOfListener": [ - { - "input": { - "LoadBalancerName": "my-load-balancer", - "LoadBalancerPort": 80, - "PolicyNames": [ - "my-SSLNegotiation-policy" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example replaces the policies that are currently associated with the specified listener.", - "id": "elb-set-load-balancer-policies-of-listener-1", - "title": "To replace the policies associated with a listener" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/paginators-1.json deleted file mode 100644 index 444a77a5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "DescribeLoadBalancers": { - "input_token": "Marker", - "output_token": "NextMarker", - "result_key": "LoadBalancerDescriptions", - "limit_key": "PageSize" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/service-2.json deleted file mode 100644 index 5ff2b5eb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/service-2.json +++ /dev/null @@ -1,2279 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-06-01", - "endpointPrefix":"elasticloadbalancing", - "protocol":"query", - "serviceFullName":"Elastic Load Balancing", - "serviceId":"Elastic Load Balancing", - "signatureVersion":"v4", - "uid":"elasticloadbalancing-2012-06-01", - "xmlNamespace":"http://elasticloadbalancing.amazonaws.com/doc/2012-06-01/" - }, - "operations":{ - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsInput"}, - "output":{ - "shape":"AddTagsOutput", - "resultWrapper":"AddTagsResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"TooManyTagsException"}, - {"shape":"DuplicateTagKeysException"} - ], - "documentation":"

Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags.

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the load balancer, AddTags updates its value.

For more information, see Tag Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "ApplySecurityGroupsToLoadBalancer":{ - "name":"ApplySecurityGroupsToLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ApplySecurityGroupsToLoadBalancerInput"}, - "output":{ - "shape":"ApplySecurityGroupsToLoadBalancerOutput", - "resultWrapper":"ApplySecurityGroupsToLoadBalancerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"InvalidSecurityGroupException"} - ], - "documentation":"

Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified security groups override the previously associated security groups.

For more information, see Security Groups for Load Balancers in a VPC in the Classic Load Balancer Guide.

" - }, - "AttachLoadBalancerToSubnets":{ - "name":"AttachLoadBalancerToSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachLoadBalancerToSubnetsInput"}, - "output":{ - "shape":"AttachLoadBalancerToSubnetsOutput", - "resultWrapper":"AttachLoadBalancerToSubnetsResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"SubnetNotFoundException"}, - {"shape":"InvalidSubnetException"} - ], - "documentation":"

Adds one or more subnets to the set of configured subnets for the specified load balancer.

The load balancer evenly distributes requests across all registered subnets. For more information, see Add or Remove Subnets for Your Load Balancer in a VPC in the Classic Load Balancer Guide.

" - }, - "ConfigureHealthCheck":{ - "name":"ConfigureHealthCheck", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfigureHealthCheckInput"}, - "output":{ - "shape":"ConfigureHealthCheckOutput", - "resultWrapper":"ConfigureHealthCheckResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"} - ], - "documentation":"

Specifies the health check settings to use when evaluating the health state of your EC2 instances.

For more information, see Configure Health Checks for Your Load Balancer in the Classic Load Balancer Guide.

" - }, - "CreateAppCookieStickinessPolicy":{ - "name":"CreateAppCookieStickinessPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAppCookieStickinessPolicyInput"}, - "output":{ - "shape":"CreateAppCookieStickinessPolicyOutput", - "resultWrapper":"CreateAppCookieStickinessPolicyResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"DuplicatePolicyNameException"}, - {"shape":"TooManyPoliciesException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners.

This policy is similar to the policy created by CreateLBCookieStickinessPolicy, except that the lifetime of the special Elastic Load Balancing cookie, AWSELB, follows the lifetime of the application-generated cookie specified in the policy configuration. The load balancer only inserts a new stickiness cookie when the application response includes a new application cookie.

If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.

For more information, see Application-Controlled Session Stickiness in the Classic Load Balancer Guide.

" - }, - "CreateLBCookieStickinessPolicy":{ - "name":"CreateLBCookieStickinessPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLBCookieStickinessPolicyInput"}, - "output":{ - "shape":"CreateLBCookieStickinessPolicyOutput", - "resultWrapper":"CreateLBCookieStickinessPolicyResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"DuplicatePolicyNameException"}, - {"shape":"TooManyPoliciesException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners.

When a load balancer implements this policy, the load balancer uses a special cookie to track the instance for each request. When the load balancer receives a request, it first checks to see if this cookie is present in the request. If so, the load balancer sends the request to the application server specified in the cookie. If not, the load balancer sends the request to a server that is chosen based on the existing load-balancing algorithm.

A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.

For more information, see Duration-Based Session Stickiness in the Classic Load Balancer Guide.

" - }, - "CreateLoadBalancer":{ - "name":"CreateLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAccessPointInput"}, - "output":{ - "shape":"CreateAccessPointOutput", - "resultWrapper":"CreateLoadBalancerResult" - }, - "errors":[ - {"shape":"DuplicateAccessPointNameException"}, - {"shape":"TooManyAccessPointsException"}, - {"shape":"CertificateNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"SubnetNotFoundException"}, - {"shape":"InvalidSubnetException"}, - {"shape":"InvalidSecurityGroupException"}, - {"shape":"InvalidSchemeException"}, - {"shape":"TooManyTagsException"}, - {"shape":"DuplicateTagKeysException"}, - {"shape":"UnsupportedProtocolException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Creates a Classic Load Balancer.

You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them later using CreateLoadBalancerListeners, ApplySecurityGroupsToLoadBalancer, AttachLoadBalancerToSubnets, and AddTags.

To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load balancer, you can delete it using DeleteLoadBalancer.

You can create up to 20 load balancers per region per account. You can request an increase for the number of load balancers for your account. For more information, see Limits for Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "CreateLoadBalancerListeners":{ - "name":"CreateLoadBalancerListeners", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoadBalancerListenerInput"}, - "output":{ - "shape":"CreateLoadBalancerListenerOutput", - "resultWrapper":"CreateLoadBalancerListenersResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"DuplicateListenerException"}, - {"shape":"CertificateNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"UnsupportedProtocolException"} - ], - "documentation":"

Creates one or more listeners for the specified load balancer. If a listener with the specified port does not already exist, it is created; otherwise, the properties of the new listener must match the properties of the existing listener.

For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "CreateLoadBalancerPolicy":{ - "name":"CreateLoadBalancerPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoadBalancerPolicyInput"}, - "output":{ - "shape":"CreateLoadBalancerPolicyOutput", - "resultWrapper":"CreateLoadBalancerPolicyResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"PolicyTypeNotFoundException"}, - {"shape":"DuplicatePolicyNameException"}, - {"shape":"TooManyPoliciesException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Creates a policy with the specified attributes for the specified load balancer.

Policies are settings that are saved for your load balancer and that can be applied to the listener or the application server, depending on the policy type.

" - }, - "DeleteLoadBalancer":{ - "name":"DeleteLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAccessPointInput"}, - "output":{ - "shape":"DeleteAccessPointOutput", - "resultWrapper":"DeleteLoadBalancerResult" - }, - "documentation":"

Deletes the specified load balancer.

If you are attempting to recreate a load balancer, you must reconfigure all settings. The DNS name associated with a deleted load balancer are no longer usable. The name and associated DNS record of the deleted load balancer no longer exist and traffic sent to any of its IP addresses is no longer delivered to your instances.

If the load balancer does not exist or has already been deleted, the call to DeleteLoadBalancer still succeeds.

" - }, - "DeleteLoadBalancerListeners":{ - "name":"DeleteLoadBalancerListeners", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoadBalancerListenerInput"}, - "output":{ - "shape":"DeleteLoadBalancerListenerOutput", - "resultWrapper":"DeleteLoadBalancerListenersResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"} - ], - "documentation":"

Deletes the specified listeners from the specified load balancer.

" - }, - "DeleteLoadBalancerPolicy":{ - "name":"DeleteLoadBalancerPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoadBalancerPolicyInput"}, - "output":{ - "shape":"DeleteLoadBalancerPolicyOutput", - "resultWrapper":"DeleteLoadBalancerPolicyResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Deletes the specified policy from the specified load balancer. This policy must not be enabled for any listeners.

" - }, - "DeregisterInstancesFromLoadBalancer":{ - "name":"DeregisterInstancesFromLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterEndPointsInput"}, - "output":{ - "shape":"DeregisterEndPointsOutput", - "resultWrapper":"DeregisterInstancesFromLoadBalancerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidEndPointException"} - ], - "documentation":"

Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no longer receives traffic from the load balancer.

You can use DescribeLoadBalancers to verify that the instance is deregistered from the load balancer.

For more information, see Register or De-Register EC2 Instances in the Classic Load Balancer Guide.

" - }, - "DescribeAccountLimits":{ - "name":"DescribeAccountLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountLimitsInput"}, - "output":{ - "shape":"DescribeAccountLimitsOutput", - "resultWrapper":"DescribeAccountLimitsResult" - }, - "documentation":"

Describes the current Elastic Load Balancing resource limits for your AWS account.

For more information, see Limits for Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "DescribeInstanceHealth":{ - "name":"DescribeInstanceHealth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEndPointStateInput"}, - "output":{ - "shape":"DescribeEndPointStateOutput", - "resultWrapper":"DescribeInstanceHealthResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidEndPointException"} - ], - "documentation":"

Describes the state of the specified instances with respect to the specified load balancer. If no instances are specified, the call describes the state of all instances that are currently registered with the load balancer. If instances are specified, their state is returned even if they are no longer registered with the load balancer. The state of terminated instances is not returned.

" - }, - "DescribeLoadBalancerAttributes":{ - "name":"DescribeLoadBalancerAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancerAttributesInput"}, - "output":{ - "shape":"DescribeLoadBalancerAttributesOutput", - "resultWrapper":"DescribeLoadBalancerAttributesResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"LoadBalancerAttributeNotFoundException"} - ], - "documentation":"

Describes the attributes for the specified load balancer.

" - }, - "DescribeLoadBalancerPolicies":{ - "name":"DescribeLoadBalancerPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancerPoliciesInput"}, - "output":{ - "shape":"DescribeLoadBalancerPoliciesOutput", - "resultWrapper":"DescribeLoadBalancerPoliciesResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"PolicyNotFoundException"} - ], - "documentation":"

Describes the specified policies.

If you specify a load balancer name, the action returns the descriptions of all policies created for the load balancer. If you specify a policy name associated with your load balancer, the action returns the description of that policy. If you don't specify a load balancer name, the action returns descriptions of the specified sample policies, or descriptions of all sample policies. The names of the sample policies have the ELBSample- prefix.

" - }, - "DescribeLoadBalancerPolicyTypes":{ - "name":"DescribeLoadBalancerPolicyTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancerPolicyTypesInput"}, - "output":{ - "shape":"DescribeLoadBalancerPolicyTypesOutput", - "resultWrapper":"DescribeLoadBalancerPolicyTypesResult" - }, - "errors":[ - {"shape":"PolicyTypeNotFoundException"} - ], - "documentation":"

Describes the specified load balancer policy types or all load balancer policy types.

The description of each type indicates how it can be used. For example, some policies can be used only with layer 7 listeners, some policies can be used only with layer 4 listeners, and some policies can be used only with your EC2 instances.

You can use CreateLoadBalancerPolicy to create a policy configuration for any of these policy types. Then, depending on the policy type, use either SetLoadBalancerPoliciesOfListener or SetLoadBalancerPoliciesForBackendServer to set the policy.

" - }, - "DescribeLoadBalancers":{ - "name":"DescribeLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccessPointsInput"}, - "output":{ - "shape":"DescribeAccessPointsOutput", - "resultWrapper":"DescribeLoadBalancersResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"DependencyThrottleException"} - ], - "documentation":"

Describes the specified the load balancers. If no load balancers are specified, the call describes all of your load balancers.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsInput"}, - "output":{ - "shape":"DescribeTagsOutput", - "resultWrapper":"DescribeTagsResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"} - ], - "documentation":"

Describes the tags associated with the specified load balancers.

" - }, - "DetachLoadBalancerFromSubnets":{ - "name":"DetachLoadBalancerFromSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachLoadBalancerFromSubnetsInput"}, - "output":{ - "shape":"DetachLoadBalancerFromSubnetsOutput", - "resultWrapper":"DetachLoadBalancerFromSubnetsResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Removes the specified subnets from the set of configured subnets for the load balancer.

After a subnet is removed, all EC2 instances registered with the load balancer in the removed subnet go into the OutOfService state. Then, the load balancer balances the traffic among the remaining routable subnets.

" - }, - "DisableAvailabilityZonesForLoadBalancer":{ - "name":"DisableAvailabilityZonesForLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveAvailabilityZonesInput"}, - "output":{ - "shape":"RemoveAvailabilityZonesOutput", - "resultWrapper":"DisableAvailabilityZonesForLoadBalancerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer.

There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the OutOfService state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.

For more information, see Add or Remove Availability Zones in the Classic Load Balancer Guide.

" - }, - "EnableAvailabilityZonesForLoadBalancer":{ - "name":"EnableAvailabilityZonesForLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddAvailabilityZonesInput"}, - "output":{ - "shape":"AddAvailabilityZonesOutput", - "resultWrapper":"EnableAvailabilityZonesForLoadBalancerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"} - ], - "documentation":"

Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer.

The load balancer evenly distributes requests across all its registered Availability Zones that contain instances.

For more information, see Add or Remove Availability Zones in the Classic Load Balancer Guide.

" - }, - "ModifyLoadBalancerAttributes":{ - "name":"ModifyLoadBalancerAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyLoadBalancerAttributesInput"}, - "output":{ - "shape":"ModifyLoadBalancerAttributesOutput", - "resultWrapper":"ModifyLoadBalancerAttributesResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"LoadBalancerAttributeNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Modifies the attributes of the specified load balancer.

You can modify the load balancer attributes, such as AccessLogs, ConnectionDraining, and CrossZoneLoadBalancing by either enabling or disabling them. Or, you can modify the load balancer attribute ConnectionSettings by specifying an idle connection timeout value for your load balancer.

For more information, see the following in the Classic Load Balancer Guide:

" - }, - "RegisterInstancesWithLoadBalancer":{ - "name":"RegisterInstancesWithLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterEndPointsInput"}, - "output":{ - "shape":"RegisterEndPointsOutput", - "resultWrapper":"RegisterInstancesWithLoadBalancerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"InvalidEndPointException"} - ], - "documentation":"

Adds the specified instances to the specified load balancer.

The instance must be a running instance in the same network as the load balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and a load balancer in a VPC with ClassicLink enabled, you can link the EC2-Classic instances to that VPC and then register the linked EC2-Classic instances with the load balancer in the VPC.

Note that RegisterInstanceWithLoadBalancer completes when the request has been registered. Instance registration takes a little time to complete. To check the state of the registered instances, use DescribeLoadBalancers or DescribeInstanceHealth.

After the instance is registered, it starts receiving traffic and requests from the load balancer. Any instance that is not in one of the Availability Zones registered for the load balancer is moved to the OutOfService state. If an Availability Zone is added to the load balancer later, any instances registered with the load balancer move to the InService state.

To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer.

For more information, see Register or De-Register EC2 Instances in the Classic Load Balancer Guide.

" - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsInput"}, - "output":{ - "shape":"RemoveTagsOutput", - "resultWrapper":"RemoveTagsResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"} - ], - "documentation":"

Removes one or more tags from the specified load balancer.

" - }, - "SetLoadBalancerListenerSSLCertificate":{ - "name":"SetLoadBalancerListenerSSLCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetLoadBalancerListenerSSLCertificateInput"}, - "output":{ - "shape":"SetLoadBalancerListenerSSLCertificateOutput", - "resultWrapper":"SetLoadBalancerListenerSSLCertificateResult" - }, - "errors":[ - {"shape":"CertificateNotFoundException"}, - {"shape":"AccessPointNotFoundException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"UnsupportedProtocolException"} - ], - "documentation":"

Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same load balancer and port.

For more information about updating your SSL certificate, see Replace the SSL Certificate for Your Load Balancer in the Classic Load Balancer Guide.

" - }, - "SetLoadBalancerPoliciesForBackendServer":{ - "name":"SetLoadBalancerPoliciesForBackendServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetLoadBalancerPoliciesForBackendServerInput"}, - "output":{ - "shape":"SetLoadBalancerPoliciesForBackendServerOutput", - "resultWrapper":"SetLoadBalancerPoliciesForBackendServerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new set of policies. At this time, only the back-end server authentication policy type can be applied to the instance ports; this policy type is composed of multiple public key policies.

Each time you use SetLoadBalancerPoliciesForBackendServer to enable the policies, use the PolicyNames parameter to list the policies that you want to enable.

You can use DescribeLoadBalancers or DescribeLoadBalancerPolicies to verify that the policy is associated with the EC2 instance.

For more information about enabling back-end instance authentication, see Configure Back-end Instance Authentication in the Classic Load Balancer Guide. For more information about Proxy Protocol, see Configure Proxy Protocol Support in the Classic Load Balancer Guide.

" - }, - "SetLoadBalancerPoliciesOfListener":{ - "name":"SetLoadBalancerPoliciesOfListener", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetLoadBalancerPoliciesOfListenerInput"}, - "output":{ - "shape":"SetLoadBalancerPoliciesOfListenerOutput", - "resultWrapper":"SetLoadBalancerPoliciesOfListenerResult" - }, - "errors":[ - {"shape":"AccessPointNotFoundException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Replaces the current set of policies for the specified load balancer port with the specified set of policies.

To enable back-end server authentication, use SetLoadBalancerPoliciesForBackendServer.

For more information about setting policies, see Update the SSL Negotiation Configuration, Duration-Based Session Stickiness, and Application-Controlled Session Stickiness in the Classic Load Balancer Guide.

" - } - }, - "shapes":{ - "AccessLog":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"AccessLogEnabled", - "documentation":"

Specifies whether access logs are enabled for the load balancer.

" - }, - "S3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the Amazon S3 bucket where the access logs are stored.

" - }, - "EmitInterval":{ - "shape":"AccessLogInterval", - "documentation":"

The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes.

Default: 60 minutes

" - }, - "S3BucketPrefix":{ - "shape":"AccessLogPrefix", - "documentation":"

The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket.

" - } - }, - "documentation":"

Information about the AccessLog attribute.

" - }, - "AccessLogEnabled":{"type":"boolean"}, - "AccessLogInterval":{"type":"integer"}, - "AccessLogPrefix":{"type":"string"}, - "AccessPointName":{"type":"string"}, - "AccessPointNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified load balancer does not exist.

", - "error":{ - "code":"LoadBalancerNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AccessPointPort":{"type":"integer"}, - "AddAvailabilityZonesInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "AvailabilityZones" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The Availability Zones. These must be in the same region as the load balancer.

" - } - }, - "documentation":"

Contains the parameters for EnableAvailabilityZonesForLoadBalancer.

" - }, - "AddAvailabilityZonesOutput":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The updated list of Availability Zones for the load balancer.

" - } - }, - "documentation":"

Contains the output of EnableAvailabilityZonesForLoadBalancer.

" - }, - "AddTagsInput":{ - "type":"structure", - "required":[ - "LoadBalancerNames", - "Tags" - ], - "members":{ - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

The name of the load balancer. You can specify one load balancer only.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags.

" - } - }, - "documentation":"

Contains the parameters for AddTags.

" - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of AddTags.

" - }, - "AdditionalAttribute":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"AdditionalAttributeKey", - "documentation":"

This parameter is reserved.

" - }, - "Value":{ - "shape":"AdditionalAttributeValue", - "documentation":"

This parameter is reserved.

" - } - }, - "documentation":"

This data type is reserved.

" - }, - "AdditionalAttributeKey":{ - "type":"string", - "max":256, - "pattern":"^[a-zA-Z0-9.]+$" - }, - "AdditionalAttributeValue":{ - "type":"string", - "max":256, - "pattern":"^[a-zA-Z0-9.]+$" - }, - "AdditionalAttributes":{ - "type":"list", - "member":{"shape":"AdditionalAttribute"}, - "max":10 - }, - "AppCookieStickinessPolicies":{ - "type":"list", - "member":{"shape":"AppCookieStickinessPolicy"} - }, - "AppCookieStickinessPolicy":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer.

" - }, - "CookieName":{ - "shape":"CookieName", - "documentation":"

The name of the application cookie used for stickiness.

" - } - }, - "documentation":"

Information about a policy for application-controlled session stickiness.

" - }, - "ApplySecurityGroupsToLoadBalancerInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "SecurityGroups" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups to associate with the load balancer. Note that you cannot specify the name of the security group.

" - } - }, - "documentation":"

Contains the parameters for ApplySecurityGroupsToLoadBalancer.

" - }, - "ApplySecurityGroupsToLoadBalancerOutput":{ - "type":"structure", - "members":{ - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups associated with the load balancer.

" - } - }, - "documentation":"

Contains the output of ApplySecurityGroupsToLoadBalancer.

" - }, - "AttachLoadBalancerToSubnetsInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Subnets" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the subnets to add. You can add only one subnet per Availability Zone.

" - } - }, - "documentation":"

Contains the parameters for AttachLoaBalancerToSubnets.

" - }, - "AttachLoadBalancerToSubnetsOutput":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the subnets attached to the load balancer.

" - } - }, - "documentation":"

Contains the output of AttachLoadBalancerToSubnets.

" - }, - "AttributeName":{"type":"string"}, - "AttributeType":{"type":"string"}, - "AttributeValue":{"type":"string"}, - "AvailabilityZone":{"type":"string"}, - "AvailabilityZones":{ - "type":"list", - "member":{"shape":"AvailabilityZone"} - }, - "BackendServerDescription":{ - "type":"structure", - "members":{ - "InstancePort":{ - "shape":"InstancePort", - "documentation":"

The port on which the EC2 instance is listening.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The names of the policies enabled for the EC2 instance.

" - } - }, - "documentation":"

Information about the configuration of an EC2 instance.

" - }, - "BackendServerDescriptions":{ - "type":"list", - "member":{"shape":"BackendServerDescription"} - }, - "Cardinality":{"type":"string"}, - "CertificateNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified ARN does not refer to a valid SSL certificate in AWS Identity and Access Management (IAM) or AWS Certificate Manager (ACM). Note that if you recently uploaded the certificate to IAM, this error might indicate that the certificate is not fully available yet.

", - "error":{ - "code":"CertificateNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ConfigureHealthCheckInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "HealthCheck" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "HealthCheck":{ - "shape":"HealthCheck", - "documentation":"

The configuration information.

" - } - }, - "documentation":"

Contains the parameters for ConfigureHealthCheck.

" - }, - "ConfigureHealthCheckOutput":{ - "type":"structure", - "members":{ - "HealthCheck":{ - "shape":"HealthCheck", - "documentation":"

The updated health check.

" - } - }, - "documentation":"

Contains the output of ConfigureHealthCheck.

" - }, - "ConnectionDraining":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"ConnectionDrainingEnabled", - "documentation":"

Specifies whether connection draining is enabled for the load balancer.

" - }, - "Timeout":{ - "shape":"ConnectionDrainingTimeout", - "documentation":"

The maximum time, in seconds, to keep the existing connections open before deregistering the instances.

" - } - }, - "documentation":"

Information about the ConnectionDraining attribute.

" - }, - "ConnectionDrainingEnabled":{"type":"boolean"}, - "ConnectionDrainingTimeout":{"type":"integer"}, - "ConnectionSettings":{ - "type":"structure", - "required":["IdleTimeout"], - "members":{ - "IdleTimeout":{ - "shape":"IdleTimeout", - "documentation":"

The time, in seconds, that the connection is allowed to be idle (no data has been sent over the connection) before it is closed by the load balancer.

" - } - }, - "documentation":"

Information about the ConnectionSettings attribute.

" - }, - "CookieExpirationPeriod":{"type":"long"}, - "CookieName":{"type":"string"}, - "CreateAccessPointInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Listeners" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

This name must be unique within your set of load balancers for the region, must have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and cannot begin or end with a hyphen.

" - }, - "Listeners":{ - "shape":"Listeners", - "documentation":"

The listeners.

For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

One or more Availability Zones from the same region as the load balancer.

You must specify at least one Availability Zone.

You can add more Availability Zones after you create the load balancer using EnableAvailabilityZonesForLoadBalancer.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the subnets in your VPC to attach to the load balancer. Specify one subnet per Availability Zone specified in AvailabilityZones.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups to assign to the load balancer.

" - }, - "Scheme":{ - "shape":"LoadBalancerScheme", - "documentation":"

The type of a load balancer. Valid only for load balancers in a VPC.

By default, Elastic Load Balancing creates an Internet-facing load balancer with a DNS name that resolves to public IP addresses. For more information about Internet-facing and Internal load balancers, see Load Balancer Scheme in the Elastic Load Balancing User Guide.

Specify internal to create a load balancer with a DNS name that resolves to private IP addresses.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags to assign to the load balancer.

For more information about tagging your load balancer, see Tag Your Classic Load Balancer in the Classic Load Balancer Guide.

" - } - }, - "documentation":"

Contains the parameters for CreateLoadBalancer.

" - }, - "CreateAccessPointOutput":{ - "type":"structure", - "members":{ - "DNSName":{ - "shape":"DNSName", - "documentation":"

The DNS name of the load balancer.

" - } - }, - "documentation":"

Contains the output for CreateLoadBalancer.

" - }, - "CreateAppCookieStickinessPolicyInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "PolicyName", - "CookieName" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy being created. Policy names must consist of alphanumeric characters and dashes (-). This name must be unique within the set of policies for this load balancer.

" - }, - "CookieName":{ - "shape":"CookieName", - "documentation":"

The name of the application cookie used for stickiness.

" - } - }, - "documentation":"

Contains the parameters for CreateAppCookieStickinessPolicy.

" - }, - "CreateAppCookieStickinessPolicyOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output for CreateAppCookieStickinessPolicy.

" - }, - "CreateLBCookieStickinessPolicyInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "PolicyName" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy being created. Policy names must consist of alphanumeric characters and dashes (-). This name must be unique within the set of policies for this load balancer.

" - }, - "CookieExpirationPeriod":{ - "shape":"CookieExpirationPeriod", - "documentation":"

The time period, in seconds, after which the cookie should be considered stale. If you do not specify this parameter, the default value is 0, which indicates that the sticky session should last for the duration of the browser session.

" - } - }, - "documentation":"

Contains the parameters for CreateLBCookieStickinessPolicy.

" - }, - "CreateLBCookieStickinessPolicyOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output for CreateLBCookieStickinessPolicy.

" - }, - "CreateLoadBalancerListenerInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Listeners" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Listeners":{ - "shape":"Listeners", - "documentation":"

The listeners.

" - } - }, - "documentation":"

Contains the parameters for CreateLoadBalancerListeners.

" - }, - "CreateLoadBalancerListenerOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the parameters for CreateLoadBalancerListener.

" - }, - "CreateLoadBalancerPolicyInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "PolicyName", - "PolicyTypeName" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the load balancer policy to be created. This name must be unique within the set of policies for this load balancer.

" - }, - "PolicyTypeName":{ - "shape":"PolicyTypeName", - "documentation":"

The name of the base policy type. To get the list of policy types, use DescribeLoadBalancerPolicyTypes.

" - }, - "PolicyAttributes":{ - "shape":"PolicyAttributes", - "documentation":"

The policy attributes.

" - } - }, - "documentation":"

Contains the parameters for CreateLoadBalancerPolicy.

" - }, - "CreateLoadBalancerPolicyOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of CreateLoadBalancerPolicy.

" - }, - "CreatedTime":{"type":"timestamp"}, - "CrossZoneLoadBalancing":{ - "type":"structure", - "required":["Enabled"], - "members":{ - "Enabled":{ - "shape":"CrossZoneLoadBalancingEnabled", - "documentation":"

Specifies whether cross-zone load balancing is enabled for the load balancer.

" - } - }, - "documentation":"

Information about the CrossZoneLoadBalancing attribute.

" - }, - "CrossZoneLoadBalancingEnabled":{"type":"boolean"}, - "DNSName":{"type":"string"}, - "DefaultValue":{"type":"string"}, - "DeleteAccessPointInput":{ - "type":"structure", - "required":["LoadBalancerName"], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - } - }, - "documentation":"

Contains the parameters for DeleteLoadBalancer.

" - }, - "DeleteAccessPointOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of DeleteLoadBalancer.

" - }, - "DeleteLoadBalancerListenerInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "LoadBalancerPorts" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "LoadBalancerPorts":{ - "shape":"Ports", - "documentation":"

The client port numbers of the listeners.

" - } - }, - "documentation":"

Contains the parameters for DeleteLoadBalancerListeners.

" - }, - "DeleteLoadBalancerListenerOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of DeleteLoadBalancerListeners.

" - }, - "DeleteLoadBalancerPolicyInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "PolicyName" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

" - } - }, - "documentation":"

Contains the parameters for DeleteLoadBalancerPolicy.

" - }, - "DeleteLoadBalancerPolicyOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of DeleteLoadBalancerPolicy.

" - }, - "DependencyThrottleException":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DependencyThrottle", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DeregisterEndPointsInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Instances" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Instances":{ - "shape":"Instances", - "documentation":"

The IDs of the instances.

" - } - }, - "documentation":"

Contains the parameters for DeregisterInstancesFromLoadBalancer.

" - }, - "DeregisterEndPointsOutput":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"Instances", - "documentation":"

The remaining instances registered with the load balancer.

" - } - }, - "documentation":"

Contains the output of DeregisterInstancesFromLoadBalancer.

" - }, - "DescribeAccessPointsInput":{ - "type":"structure", - "members":{ - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

The names of the load balancers.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call (a number from 1 to 400). The default is 400.

" - } - }, - "documentation":"

Contains the parameters for DescribeLoadBalancers.

" - }, - "DescribeAccessPointsOutput":{ - "type":"structure", - "members":{ - "LoadBalancerDescriptions":{ - "shape":"LoadBalancerDescriptions", - "documentation":"

Information about the load balancers.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - }, - "documentation":"

Contains the parameters for DescribeLoadBalancers.

" - }, - "DescribeAccountLimitsInput":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeAccountLimitsOutput":{ - "type":"structure", - "members":{ - "Limits":{ - "shape":"Limits", - "documentation":"

Information about the limits.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeEndPointStateInput":{ - "type":"structure", - "required":["LoadBalancerName"], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Instances":{ - "shape":"Instances", - "documentation":"

The IDs of the instances.

" - } - }, - "documentation":"

Contains the parameters for DescribeInstanceHealth.

" - }, - "DescribeEndPointStateOutput":{ - "type":"structure", - "members":{ - "InstanceStates":{ - "shape":"InstanceStates", - "documentation":"

Information about the health of the instances.

" - } - }, - "documentation":"

Contains the output for DescribeInstanceHealth.

" - }, - "DescribeLoadBalancerAttributesInput":{ - "type":"structure", - "required":["LoadBalancerName"], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - } - }, - "documentation":"

Contains the parameters for DescribeLoadBalancerAttributes.

" - }, - "DescribeLoadBalancerAttributesOutput":{ - "type":"structure", - "members":{ - "LoadBalancerAttributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

Information about the load balancer attributes.

" - } - }, - "documentation":"

Contains the output of DescribeLoadBalancerAttributes.

" - }, - "DescribeLoadBalancerPoliciesInput":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The names of the policies.

" - } - }, - "documentation":"

Contains the parameters for DescribeLoadBalancerPolicies.

" - }, - "DescribeLoadBalancerPoliciesOutput":{ - "type":"structure", - "members":{ - "PolicyDescriptions":{ - "shape":"PolicyDescriptions", - "documentation":"

Information about the policies.

" - } - }, - "documentation":"

Contains the output of DescribeLoadBalancerPolicies.

" - }, - "DescribeLoadBalancerPolicyTypesInput":{ - "type":"structure", - "members":{ - "PolicyTypeNames":{ - "shape":"PolicyTypeNames", - "documentation":"

The names of the policy types. If no names are specified, describes all policy types defined by Elastic Load Balancing.

" - } - }, - "documentation":"

Contains the parameters for DescribeLoadBalancerPolicyTypes.

" - }, - "DescribeLoadBalancerPolicyTypesOutput":{ - "type":"structure", - "members":{ - "PolicyTypeDescriptions":{ - "shape":"PolicyTypeDescriptions", - "documentation":"

Information about the policy types.

" - } - }, - "documentation":"

Contains the output of DescribeLoadBalancerPolicyTypes.

" - }, - "DescribeTagsInput":{ - "type":"structure", - "required":["LoadBalancerNames"], - "members":{ - "LoadBalancerNames":{ - "shape":"LoadBalancerNamesMax20", - "documentation":"

The names of the load balancers.

" - } - }, - "documentation":"

Contains the parameters for DescribeTags.

" - }, - "DescribeTagsOutput":{ - "type":"structure", - "members":{ - "TagDescriptions":{ - "shape":"TagDescriptions", - "documentation":"

Information about the tags.

" - } - }, - "documentation":"

Contains the output for DescribeTags.

" - }, - "Description":{"type":"string"}, - "DetachLoadBalancerFromSubnetsInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Subnets" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the subnets.

" - } - }, - "documentation":"

Contains the parameters for DetachLoadBalancerFromSubnets.

" - }, - "DetachLoadBalancerFromSubnetsOutput":{ - "type":"structure", - "members":{ - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the remaining subnets for the load balancer.

" - } - }, - "documentation":"

Contains the output of DetachLoadBalancerFromSubnets.

" - }, - "DuplicateAccessPointNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified load balancer name already exists for this account.

", - "error":{ - "code":"DuplicateLoadBalancerName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicateListenerException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A listener already exists for the specified load balancer name and port, but with a different instance port, protocol, or SSL certificate.

", - "error":{ - "code":"DuplicateListener", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicatePolicyNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A policy with the specified name already exists for this load balancer.

", - "error":{ - "code":"DuplicatePolicyName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicateTagKeysException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A tag key was specified more than once.

", - "error":{ - "code":"DuplicateTagKeys", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EndPointPort":{"type":"integer"}, - "HealthCheck":{ - "type":"structure", - "required":[ - "Target", - "Interval", - "Timeout", - "UnhealthyThreshold", - "HealthyThreshold" - ], - "members":{ - "Target":{ - "shape":"HealthCheckTarget", - "documentation":"

The instance being checked. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

TCP is the default, specified as a TCP: port pair, for example \"TCP:5000\". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

SSL is also specified as SSL: port pair, for example, SSL:5000.

For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example \"HTTP:80/weather/us/wa/seattle\". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than \"200 OK\" within the timeout period is considered unhealthy.

The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less.

" - }, - "Interval":{ - "shape":"HealthCheckInterval", - "documentation":"

The approximate interval, in seconds, between health checks of an individual instance.

" - }, - "Timeout":{ - "shape":"HealthCheckTimeout", - "documentation":"

The amount of time, in seconds, during which no response means a failed health check.

This value must be less than the Interval value.

" - }, - "UnhealthyThreshold":{ - "shape":"UnhealthyThreshold", - "documentation":"

The number of consecutive health check failures required before moving the instance to the Unhealthy state.

" - }, - "HealthyThreshold":{ - "shape":"HealthyThreshold", - "documentation":"

The number of consecutive health checks successes required before moving the instance to the Healthy state.

" - } - }, - "documentation":"

Information about a health check.

" - }, - "HealthCheckInterval":{ - "type":"integer", - "max":300, - "min":5 - }, - "HealthCheckTarget":{"type":"string"}, - "HealthCheckTimeout":{ - "type":"integer", - "max":60, - "min":2 - }, - "HealthyThreshold":{ - "type":"integer", - "max":10, - "min":2 - }, - "IdleTimeout":{ - "type":"integer", - "max":3600, - "min":1 - }, - "Instance":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - } - }, - "documentation":"

The ID of an EC2 instance.

" - }, - "InstanceId":{"type":"string"}, - "InstancePort":{ - "type":"integer", - "max":65535, - "min":1 - }, - "InstanceState":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "State":{ - "shape":"State", - "documentation":"

The current state of the instance.

Valid values: InService | OutOfService | Unknown

" - }, - "ReasonCode":{ - "shape":"ReasonCode", - "documentation":"

Information about the cause of OutOfService instances. Specifically, whether the cause is Elastic Load Balancing or the instance.

Valid values: ELB | Instance | N/A

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the instance state. This string can contain one or more of the following messages.

  • N/A

  • A transient error occurred. Please try again later.

  • Instance has failed at least the UnhealthyThreshold number of health checks consecutively.

  • Instance has not passed the configured HealthyThreshold number of health checks consecutively.

  • Instance registration is still in progress.

  • Instance is in the EC2 Availability Zone for which LoadBalancer is not configured to route traffic to.

  • Instance is not currently registered with the LoadBalancer.

  • Instance deregistration currently in progress.

  • Disable Availability Zone is currently in progress.

  • Instance is in pending state.

  • Instance is in stopped state.

  • Instance is in terminated state.

" - } - }, - "documentation":"

Information about the state of an EC2 instance.

" - }, - "InstanceStates":{ - "type":"list", - "member":{"shape":"InstanceState"} - }, - "Instances":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InvalidConfigurationRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested configuration change is not valid.

", - "error":{ - "code":"InvalidConfigurationRequest", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "InvalidEndPointException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified endpoint is not valid.

", - "error":{ - "code":"InvalidInstance", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSchemeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified value for the schema is not valid. You can only specify a scheme for load balancers in a VPC.

", - "error":{ - "code":"InvalidScheme", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSecurityGroupException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more of the specified security groups do not exist.

", - "error":{ - "code":"InvalidSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnetException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified VPC has no associated Internet gateway.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LBCookieStickinessPolicies":{ - "type":"list", - "member":{"shape":"LBCookieStickinessPolicy"} - }, - "LBCookieStickinessPolicy":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy. This name must be unique within the set of policies for this load balancer.

" - }, - "CookieExpirationPeriod":{ - "shape":"CookieExpirationPeriod", - "documentation":"

The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session.

" - } - }, - "documentation":"

Information about a policy for duration-based session stickiness.

" - }, - "Limit":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the limit. The possible values are:

  • classic-listeners

  • classic-load-balancers

" - }, - "Max":{ - "shape":"Max", - "documentation":"

The maximum value of the limit.

" - } - }, - "documentation":"

Information about an Elastic Load Balancing resource limit for your AWS account.

" - }, - "Limits":{ - "type":"list", - "member":{"shape":"Limit"} - }, - "Listener":{ - "type":"structure", - "required":[ - "Protocol", - "LoadBalancerPort", - "InstancePort" - ], - "members":{ - "Protocol":{ - "shape":"Protocol", - "documentation":"

The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL.

" - }, - "LoadBalancerPort":{ - "shape":"AccessPointPort", - "documentation":"

The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535.

" - }, - "InstanceProtocol":{ - "shape":"Protocol", - "documentation":"

The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL.

If the front-end protocol is HTTP, HTTPS, TCP, or SSL, InstanceProtocol must be at the same protocol.

If there is another listener with the same InstancePort whose InstanceProtocol is secure, (HTTPS or SSL), the listener's InstanceProtocol must also be secure.

If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP.

" - }, - "InstancePort":{ - "shape":"InstancePort", - "documentation":"

The port on which the instance is listening.

" - }, - "SSLCertificateId":{ - "shape":"SSLCertificateId", - "documentation":"

The Amazon Resource Name (ARN) of the server certificate.

" - } - }, - "documentation":"

Information about a listener.

For information about the protocols and the ports supported by Elastic Load Balancing, see Listeners for Your Classic Load Balancer in the Classic Load Balancer Guide.

" - }, - "ListenerDescription":{ - "type":"structure", - "members":{ - "Listener":{ - "shape":"Listener", - "documentation":"

The listener.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The policies. If there are no policies enabled, the list is empty.

" - } - }, - "documentation":"

The policies enabled for a listener.

" - }, - "ListenerDescriptions":{ - "type":"list", - "member":{"shape":"ListenerDescription"} - }, - "ListenerNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The load balancer does not have a listener configured at the specified port.

", - "error":{ - "code":"ListenerNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Listeners":{ - "type":"list", - "member":{"shape":"Listener"} - }, - "LoadBalancerAttributeNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified load balancer attribute does not exist.

", - "error":{ - "code":"LoadBalancerAttributeNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LoadBalancerAttributes":{ - "type":"structure", - "members":{ - "CrossZoneLoadBalancing":{ - "shape":"CrossZoneLoadBalancing", - "documentation":"

If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.

For more information, see Configure Cross-Zone Load Balancing in the Classic Load Balancer Guide.

" - }, - "AccessLog":{ - "shape":"AccessLog", - "documentation":"

If enabled, the load balancer captures detailed information of all requests and delivers the information to the Amazon S3 bucket that you specify.

For more information, see Enable Access Logs in the Classic Load Balancer Guide.

" - }, - "ConnectionDraining":{ - "shape":"ConnectionDraining", - "documentation":"

If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.

For more information, see Configure Connection Draining in the Classic Load Balancer Guide.

" - }, - "ConnectionSettings":{ - "shape":"ConnectionSettings", - "documentation":"

If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.

By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure Idle Connection Timeout in the Classic Load Balancer Guide.

" - }, - "AdditionalAttributes":{ - "shape":"AdditionalAttributes", - "documentation":"

This parameter is reserved.

" - } - }, - "documentation":"

The attributes for a load balancer.

" - }, - "LoadBalancerDescription":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "DNSName":{ - "shape":"DNSName", - "documentation":"

The DNS name of the load balancer.

" - }, - "CanonicalHostedZoneName":{ - "shape":"DNSName", - "documentation":"

The DNS name of the load balancer.

For more information, see Configure a Custom Domain Name in the Classic Load Balancer Guide.

" - }, - "CanonicalHostedZoneNameID":{ - "shape":"DNSName", - "documentation":"

The ID of the Amazon Route 53 hosted zone for the load balancer.

" - }, - "ListenerDescriptions":{ - "shape":"ListenerDescriptions", - "documentation":"

The listeners for the load balancer.

" - }, - "Policies":{ - "shape":"Policies", - "documentation":"

The policies defined for the load balancer.

" - }, - "BackendServerDescriptions":{ - "shape":"BackendServerDescriptions", - "documentation":"

Information about your EC2 instances.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The Availability Zones for the load balancer.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the subnets for the load balancer.

" - }, - "VPCId":{ - "shape":"VPCId", - "documentation":"

The ID of the VPC for the load balancer.

" - }, - "Instances":{ - "shape":"Instances", - "documentation":"

The IDs of the instances for the load balancer.

" - }, - "HealthCheck":{ - "shape":"HealthCheck", - "documentation":"

Information about the health checks conducted on the load balancer.

" - }, - "SourceSecurityGroup":{ - "shape":"SourceSecurityGroup", - "documentation":"

The security group for the load balancer, which you can use as part of your inbound rules for your registered instances. To only allow traffic from load balancers, add a security group rule that specifies this source security group as the inbound source.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The security groups for the load balancer. Valid only for load balancers in a VPC.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The date and time the load balancer was created.

" - }, - "Scheme":{ - "shape":"LoadBalancerScheme", - "documentation":"

The type of load balancer. Valid only for load balancers in a VPC.

If Scheme is internet-facing, the load balancer has a public DNS name that resolves to a public IP address.

If Scheme is internal, the load balancer has a public DNS name that resolves to a private IP address.

" - } - }, - "documentation":"

Information about a load balancer.

" - }, - "LoadBalancerDescriptions":{ - "type":"list", - "member":{"shape":"LoadBalancerDescription"} - }, - "LoadBalancerNames":{ - "type":"list", - "member":{"shape":"AccessPointName"} - }, - "LoadBalancerNamesMax20":{ - "type":"list", - "member":{"shape":"AccessPointName"}, - "max":20, - "min":1 - }, - "LoadBalancerScheme":{"type":"string"}, - "Marker":{"type":"string"}, - "Max":{"type":"string"}, - "ModifyLoadBalancerAttributesInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "LoadBalancerAttributes" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "LoadBalancerAttributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

The attributes for the load balancer.

" - } - }, - "documentation":"

Contains the parameters for ModifyLoadBalancerAttributes.

" - }, - "ModifyLoadBalancerAttributesOutput":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "LoadBalancerAttributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

Information about the load balancer attributes.

" - } - }, - "documentation":"

Contains the output of ModifyLoadBalancerAttributes.

" - }, - "Name":{"type":"string"}, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This operation is not allowed.

", - "error":{ - "code":"OperationNotPermitted", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PageSize":{ - "type":"integer", - "max":400, - "min":1 - }, - "Policies":{ - "type":"structure", - "members":{ - "AppCookieStickinessPolicies":{ - "shape":"AppCookieStickinessPolicies", - "documentation":"

The stickiness policies created using CreateAppCookieStickinessPolicy.

" - }, - "LBCookieStickinessPolicies":{ - "shape":"LBCookieStickinessPolicies", - "documentation":"

The stickiness policies created using CreateLBCookieStickinessPolicy.

" - }, - "OtherPolicies":{ - "shape":"PolicyNames", - "documentation":"

The policies other than the stickiness policies.

" - } - }, - "documentation":"

The policies for a load balancer.

" - }, - "PolicyAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - }, - "AttributeValue":{ - "shape":"AttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Information about a policy attribute.

" - }, - "PolicyAttributeDescription":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - }, - "AttributeValue":{ - "shape":"AttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Information about a policy attribute.

" - }, - "PolicyAttributeDescriptions":{ - "type":"list", - "member":{"shape":"PolicyAttributeDescription"} - }, - "PolicyAttributeTypeDescription":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute.

" - }, - "AttributeType":{ - "shape":"AttributeType", - "documentation":"

The type of the attribute. For example, Boolean or Integer.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the attribute.

" - }, - "DefaultValue":{ - "shape":"DefaultValue", - "documentation":"

The default value of the attribute, if applicable.

" - }, - "Cardinality":{ - "shape":"Cardinality", - "documentation":"

The cardinality of the attribute.

Valid values:

  • ONE(1) : Single value required

  • ZERO_OR_ONE(0..1) : Up to one value is allowed

  • ZERO_OR_MORE(0..*) : Optional. Multiple values are allowed

  • ONE_OR_MORE(1..*0) : Required. Multiple values are allowed

" - } - }, - "documentation":"

Information about a policy attribute type.

" - }, - "PolicyAttributeTypeDescriptions":{ - "type":"list", - "member":{"shape":"PolicyAttributeTypeDescription"} - }, - "PolicyAttributes":{ - "type":"list", - "member":{"shape":"PolicyAttribute"} - }, - "PolicyDescription":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

" - }, - "PolicyTypeName":{ - "shape":"PolicyTypeName", - "documentation":"

The name of the policy type.

" - }, - "PolicyAttributeDescriptions":{ - "shape":"PolicyAttributeDescriptions", - "documentation":"

The policy attributes.

" - } - }, - "documentation":"

Information about a policy.

" - }, - "PolicyDescriptions":{ - "type":"list", - "member":{"shape":"PolicyDescription"} - }, - "PolicyName":{"type":"string"}, - "PolicyNames":{ - "type":"list", - "member":{"shape":"PolicyName"} - }, - "PolicyNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more of the specified policies do not exist.

", - "error":{ - "code":"PolicyNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PolicyTypeDescription":{ - "type":"structure", - "members":{ - "PolicyTypeName":{ - "shape":"PolicyTypeName", - "documentation":"

The name of the policy type.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the policy type.

" - }, - "PolicyAttributeTypeDescriptions":{ - "shape":"PolicyAttributeTypeDescriptions", - "documentation":"

The description of the policy attributes associated with the policies defined by Elastic Load Balancing.

" - } - }, - "documentation":"

Information about a policy type.

" - }, - "PolicyTypeDescriptions":{ - "type":"list", - "member":{"shape":"PolicyTypeDescription"} - }, - "PolicyTypeName":{"type":"string"}, - "PolicyTypeNames":{ - "type":"list", - "member":{"shape":"PolicyTypeName"} - }, - "PolicyTypeNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more of the specified policy types do not exist.

", - "error":{ - "code":"PolicyTypeNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Ports":{ - "type":"list", - "member":{"shape":"AccessPointPort"} - }, - "Protocol":{"type":"string"}, - "ReasonCode":{"type":"string"}, - "RegisterEndPointsInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "Instances" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Instances":{ - "shape":"Instances", - "documentation":"

The IDs of the instances.

" - } - }, - "documentation":"

Contains the parameters for RegisterInstancesWithLoadBalancer.

" - }, - "RegisterEndPointsOutput":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"Instances", - "documentation":"

The updated list of instances for the load balancer.

" - } - }, - "documentation":"

Contains the output of RegisterInstancesWithLoadBalancer.

" - }, - "RemoveAvailabilityZonesInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "AvailabilityZones" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The Availability Zones.

" - } - }, - "documentation":"

Contains the parameters for DisableAvailabilityZonesForLoadBalancer.

" - }, - "RemoveAvailabilityZonesOutput":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The remaining Availability Zones for the load balancer.

" - } - }, - "documentation":"

Contains the output for DisableAvailabilityZonesForLoadBalancer.

" - }, - "RemoveTagsInput":{ - "type":"structure", - "required":[ - "LoadBalancerNames", - "Tags" - ], - "members":{ - "LoadBalancerNames":{ - "shape":"LoadBalancerNames", - "documentation":"

The name of the load balancer. You can specify a maximum of one load balancer name.

" - }, - "Tags":{ - "shape":"TagKeyList", - "documentation":"

The list of tag keys to remove.

" - } - }, - "documentation":"

Contains the parameters for RemoveTags.

" - }, - "RemoveTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of RemoveTags.

" - }, - "S3BucketName":{"type":"string"}, - "SSLCertificateId":{"type":"string"}, - "SecurityGroupId":{"type":"string"}, - "SecurityGroupName":{"type":"string"}, - "SecurityGroupOwnerAlias":{"type":"string"}, - "SecurityGroups":{ - "type":"list", - "member":{"shape":"SecurityGroupId"} - }, - "SetLoadBalancerListenerSSLCertificateInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "LoadBalancerPort", - "SSLCertificateId" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "LoadBalancerPort":{ - "shape":"AccessPointPort", - "documentation":"

The port that uses the specified SSL certificate.

" - }, - "SSLCertificateId":{ - "shape":"SSLCertificateId", - "documentation":"

The Amazon Resource Name (ARN) of the SSL certificate.

" - } - }, - "documentation":"

Contains the parameters for SetLoadBalancerListenerSSLCertificate.

" - }, - "SetLoadBalancerListenerSSLCertificateOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of SetLoadBalancerListenerSSLCertificate.

" - }, - "SetLoadBalancerPoliciesForBackendServerInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "InstancePort", - "PolicyNames" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "InstancePort":{ - "shape":"EndPointPort", - "documentation":"

The port number associated with the EC2 instance.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The names of the policies. If the list is empty, then all current polices are removed from the EC2 instance.

" - } - }, - "documentation":"

Contains the parameters for SetLoadBalancerPoliciesForBackendServer.

" - }, - "SetLoadBalancerPoliciesForBackendServerOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of SetLoadBalancerPoliciesForBackendServer.

" - }, - "SetLoadBalancerPoliciesOfListenerInput":{ - "type":"structure", - "required":[ - "LoadBalancerName", - "LoadBalancerPort", - "PolicyNames" - ], - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "LoadBalancerPort":{ - "shape":"AccessPointPort", - "documentation":"

The external port of the load balancer.

" - }, - "PolicyNames":{ - "shape":"PolicyNames", - "documentation":"

The names of the policies. This list must include all policies to be enabled. If you omit a policy that is currently enabled, it is disabled. If the list is empty, all current policies are disabled.

" - } - }, - "documentation":"

Contains the parameters for SetLoadBalancePoliciesOfListener.

" - }, - "SetLoadBalancerPoliciesOfListenerOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

Contains the output of SetLoadBalancePoliciesOfListener.

" - }, - "SourceSecurityGroup":{ - "type":"structure", - "members":{ - "OwnerAlias":{ - "shape":"SecurityGroupOwnerAlias", - "documentation":"

The owner of the security group.

" - }, - "GroupName":{ - "shape":"SecurityGroupName", - "documentation":"

The name of the security group.

" - } - }, - "documentation":"

Information about a source security group.

" - }, - "State":{"type":"string"}, - "SubnetId":{"type":"string"}, - "SubnetNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more of the specified subnets do not exist.

", - "error":{ - "code":"SubnetNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Subnets":{ - "type":"list", - "member":{"shape":"SubnetId"} - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Information about a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "LoadBalancerName":{ - "shape":"AccessPointName", - "documentation":"

The name of the load balancer.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags.

" - } - }, - "documentation":"

The tags associated with a load balancer.

" - }, - "TagDescriptions":{ - "type":"list", - "member":{"shape":"TagDescription"} - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKeyOnly"}, - "min":1 - }, - "TagKeyOnly":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The name of the key.

" - } - }, - "documentation":"

The key of a tag.

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TooManyAccessPointsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for the number of load balancers has been reached.

", - "error":{ - "code":"TooManyLoadBalancers", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyPoliciesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for the number of policies for this load balancer has been reached.

", - "error":{ - "code":"TooManyPolicies", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for the number of tags that can be assigned to a load balancer has been reached.

", - "error":{ - "code":"TooManyTags", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnhealthyThreshold":{ - "type":"integer", - "max":10, - "min":2 - }, - "UnsupportedProtocolException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified protocol or signature version is not supported.

", - "error":{ - "code":"UnsupportedProtocol", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "VPCId":{"type":"string"} - }, - "documentation":"Elastic Load Balancing

A load balancer can distribute incoming traffic across your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered instances and ensures that it routes traffic only to healthy instances. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer and a protocol and port number for connections from the load balancer to the instances.

Elastic Load Balancing supports three types of load balancers: Application Load Balancers, Network Load Balancers, and Classic Load Balancers. You can select a load balancer based on your application needs. For more information, see the Elastic Load Balancing User Guide.

This reference covers the 2012-06-01 API, which supports Classic Load Balancers. The 2015-12-01 API supports Application Load Balancers and Network Load Balancers.

To get started, create a load balancer with one or more listeners using CreateLoadBalancer. Register your instances with the load balancer using RegisterInstancesWithLoadBalancer.

All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds with a 200 OK response code.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/waiters-2.json deleted file mode 100644 index 182e070b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elb/2012-06-01/waiters-2.json +++ /dev/null @@ -1,54 +0,0 @@ -{ - "version":2, - "waiters":{ - "InstanceDeregistered": { - "delay": 15, - "operation": "DescribeInstanceHealth", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "OutOfService", - "matcher": "pathAll", - "state": "success", - "argument": "InstanceStates[].State" - }, - { - "matcher": "error", - "expected": "InvalidInstance", - "state": "success" - } - ] - }, - "AnyInstanceInService":{ - "acceptors":[ - { - "argument":"InstanceStates[].State", - "expected":"InService", - "matcher":"pathAny", - "state":"success" - } - ], - "delay":15, - "maxAttempts":40, - "operation":"DescribeInstanceHealth" - }, - "InstanceInService":{ - "acceptors":[ - { - "argument":"InstanceStates[].State", - "expected":"InService", - "matcher":"pathAll", - "state":"success" - }, - { - "matcher": "error", - "expected": "InvalidInstance", - "state": "retry" - } - ], - "delay":15, - "maxAttempts":40, - "operation":"DescribeInstanceHealth" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/examples-1.json deleted file mode 100644 index 508b0991..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/examples-1.json +++ /dev/null @@ -1,1384 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddTags": [ - { - "input": { - "ResourceArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ], - "Tags": [ - { - "Key": "project", - "Value": "lima" - }, - { - "Key": "department", - "Value": "digital-media" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified tags to the specified load balancer.", - "id": "elbv2-add-tags-1", - "title": "To add tags to a load balancer" - } - ], - "CreateListener": [ - { - "input": { - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 80, - "Protocol": "HTTP" - }, - "output": { - "Listeners": [ - { - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 80, - "Protocol": "HTTP" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an HTTP listener for the specified load balancer that forwards requests to the specified target group.", - "id": "elbv2-create-listener-1", - "title": "To create an HTTP listener" - }, - { - "input": { - "Certificates": [ - { - "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - } - ], - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 443, - "Protocol": "HTTPS", - "SslPolicy": "ELBSecurityPolicy-2015-05" - }, - "output": { - "Listeners": [ - { - "Certificates": [ - { - "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-server-cert" - } - ], - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 443, - "Protocol": "HTTPS", - "SslPolicy": "ELBSecurityPolicy-2015-05" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an HTTPS listener for the specified load balancer that forwards requests to the specified target group. Note that you must specify an SSL certificate for an HTTPS listener. You can create and manage certificates using AWS Certificate Manager (ACM). Alternatively, you can create a certificate using SSL/TLS tools, get the certificate signed by a certificate authority (CA), and upload the certificate to AWS Identity and Access Management (IAM).", - "id": "elbv2-create-listener-2", - "title": "To create an HTTPS listener" - } - ], - "CreateLoadBalancer": [ - { - "input": { - "Name": "my-load-balancer", - "Subnets": [ - "subnet-b7d581c0", - "subnet-8360a9e7" - ] - }, - "output": { - "LoadBalancers": [ - { - "AvailabilityZones": [ - { - "SubnetId": "subnet-8360a9e7", - "ZoneName": "us-west-2a" - }, - { - "SubnetId": "subnet-b7d581c0", - "ZoneName": "us-west-2b" - } - ], - "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", - "CreatedTime": "2016-03-25T21:26:12.920Z", - "DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "LoadBalancerName": "my-load-balancer", - "Scheme": "internet-facing", - "SecurityGroups": [ - "sg-5943793c" - ], - "State": { - "Code": "provisioning" - }, - "Type": "application", - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an Internet-facing load balancer and enables the Availability Zones for the specified subnets.", - "id": "elbv2-create-load-balancer-1", - "title": "To create an Internet-facing load balancer" - }, - { - "input": { - "Name": "my-internal-load-balancer", - "Scheme": "internal", - "SecurityGroups": [ - - ], - "Subnets": [ - "subnet-b7d581c0", - "subnet-8360a9e7" - ] - }, - "output": { - "LoadBalancers": [ - { - "AvailabilityZones": [ - { - "SubnetId": "subnet-8360a9e7", - "ZoneName": "us-west-2a" - }, - { - "SubnetId": "subnet-b7d581c0", - "ZoneName": "us-west-2b" - } - ], - "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", - "CreatedTime": "2016-03-25T21:29:48.850Z", - "DNSName": "internal-my-internal-load-balancer-1529930873.us-west-2.elb.amazonaws.com", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/5b49b8d4303115c2", - "LoadBalancerName": "my-internal-load-balancer", - "Scheme": "internal", - "SecurityGroups": [ - "sg-5943793c" - ], - "State": { - "Code": "provisioning" - }, - "Type": "application", - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an internal load balancer and enables the Availability Zones for the specified subnets.", - "id": "elbv2-create-load-balancer-2", - "title": "To create an internal load balancer" - } - ], - "CreateRule": [ - { - "input": { - "Actions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/img/*" - ] - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", - "Priority": 10 - }, - "output": { - "Rules": [ - { - "Actions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/img/*" - ] - } - ], - "IsDefault": false, - "Priority": "10", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/*).", - "id": "elbv2-create-rule-1", - "title": "To create a rule" - } - ], - "CreateTargetGroup": [ - { - "input": { - "Name": "my-targets", - "Port": 80, - "Protocol": "HTTP", - "VpcId": "vpc-3ac0fb5f" - }, - "output": { - "TargetGroups": [ - { - "HealthCheckIntervalSeconds": 30, - "HealthCheckPath": "/", - "HealthCheckPort": "traffic-port", - "HealthCheckProtocol": "HTTP", - "HealthCheckTimeoutSeconds": 5, - "HealthyThresholdCount": 5, - "Matcher": { - "HttpCode": "200" - }, - "Port": 80, - "Protocol": "HTTP", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "TargetGroupName": "my-targets", - "UnhealthyThresholdCount": 2, - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a target group that you can use to route traffic to targets using HTTP on port 80. This target group uses the default health check configuration.", - "id": "elbv2-create-target-group-1", - "title": "To create a target group" - } - ], - "DeleteListener": [ - { - "input": { - "ListenerArn": "arn:aws:elasticloadbalancing:ua-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified listener.", - "id": "elbv2-delete-listener-1", - "title": "To delete a listener" - } - ], - "DeleteLoadBalancer": [ - { - "input": { - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified load balancer.", - "id": "elbv2-delete-load-balancer-1", - "title": "To delete a load balancer" - } - ], - "DeleteRule": [ - { - "input": { - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified rule.", - "id": "elbv2-delete-rule-1", - "title": "To delete a rule" - } - ], - "DeleteTargetGroup": [ - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified target group.", - "id": "elbv2-delete-target-group-1", - "title": "To delete a target group" - } - ], - "DeregisterTargets": [ - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Targets": [ - { - "Id": "i-0f76fade" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deregisters the specified instance from the specified target group.", - "id": "elbv2-deregister-targets-1", - "title": "To deregister a target from a target group" - } - ], - "DescribeListeners": [ - { - "input": { - "ListenerArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2" - ] - }, - "output": { - "Listeners": [ - { - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 80, - "Protocol": "HTTP" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified listener.", - "id": "elbv2-describe-listeners-1", - "title": "To describe a listener" - } - ], - "DescribeLoadBalancerAttributes": [ - { - "input": { - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - }, - "output": { - "Attributes": [ - { - "Key": "access_logs.s3.enabled", - "Value": "false" - }, - { - "Key": "idle_timeout.timeout_seconds", - "Value": "60" - }, - { - "Key": "access_logs.s3.prefix", - "Value": "" - }, - { - "Key": "deletion_protection.enabled", - "Value": "false" - }, - { - "Key": "access_logs.s3.bucket", - "Value": "" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attributes of the specified load balancer.", - "id": "elbv2-describe-load-balancer-attributes-1", - "title": "To describe load balancer attributes" - } - ], - "DescribeLoadBalancers": [ - { - "input": { - "LoadBalancerArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ] - }, - "output": { - "LoadBalancers": [ - { - "AvailabilityZones": [ - { - "SubnetId": "subnet-8360a9e7", - "ZoneName": "us-west-2a" - }, - { - "SubnetId": "subnet-b7d581c0", - "ZoneName": "us-west-2b" - } - ], - "CanonicalHostedZoneId": "Z2P70J7EXAMPLE", - "CreatedTime": "2016-03-25T21:26:12.920Z", - "DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "LoadBalancerName": "my-load-balancer", - "Scheme": "internet-facing", - "SecurityGroups": [ - "sg-5943793c" - ], - "State": { - "Code": "active" - }, - "Type": "application", - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified load balancer.", - "id": "elbv2-describe-load-balancers-1", - "title": "To describe a load balancer" - } - ], - "DescribeRules": [ - { - "input": { - "RuleArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - ] - }, - "output": { - "Rules": [ - { - "Actions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/img/*" - ] - } - ], - "IsDefault": false, - "Priority": "10", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified rule.", - "id": "elbv2-describe-rules-1", - "title": "To describe a rule" - } - ], - "DescribeSSLPolicies": [ - { - "input": { - "Names": [ - "ELBSecurityPolicy-2015-05" - ] - }, - "output": { - "SslPolicies": [ - { - "Ciphers": [ - { - "Name": "ECDHE-ECDSA-AES128-GCM-SHA256", - "Priority": 1 - }, - { - "Name": "ECDHE-RSA-AES128-GCM-SHA256", - "Priority": 2 - }, - { - "Name": "ECDHE-ECDSA-AES128-SHA256", - "Priority": 3 - }, - { - "Name": "ECDHE-RSA-AES128-SHA256", - "Priority": 4 - }, - { - "Name": "ECDHE-ECDSA-AES128-SHA", - "Priority": 5 - }, - { - "Name": "ECDHE-RSA-AES128-SHA", - "Priority": 6 - }, - { - "Name": "DHE-RSA-AES128-SHA", - "Priority": 7 - }, - { - "Name": "ECDHE-ECDSA-AES256-GCM-SHA384", - "Priority": 8 - }, - { - "Name": "ECDHE-RSA-AES256-GCM-SHA384", - "Priority": 9 - }, - { - "Name": "ECDHE-ECDSA-AES256-SHA384", - "Priority": 10 - }, - { - "Name": "ECDHE-RSA-AES256-SHA384", - "Priority": 11 - }, - { - "Name": "ECDHE-RSA-AES256-SHA", - "Priority": 12 - }, - { - "Name": "ECDHE-ECDSA-AES256-SHA", - "Priority": 13 - }, - { - "Name": "AES128-GCM-SHA256", - "Priority": 14 - }, - { - "Name": "AES128-SHA256", - "Priority": 15 - }, - { - "Name": "AES128-SHA", - "Priority": 16 - }, - { - "Name": "AES256-GCM-SHA384", - "Priority": 17 - }, - { - "Name": "AES256-SHA256", - "Priority": 18 - }, - { - "Name": "AES256-SHA", - "Priority": 19 - } - ], - "Name": "ELBSecurityPolicy-2015-05", - "SslProtocols": [ - "TLSv1", - "TLSv1.1", - "TLSv1.2" - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified policy used for SSL negotiation.", - "id": "elbv2-describe-ssl-policies-1", - "title": "To describe a policy used for SSL negotiation" - } - ], - "DescribeTags": [ - { - "input": { - "ResourceArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ] - }, - "output": { - "TagDescriptions": [ - { - "ResourceArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Tags": [ - { - "Key": "project", - "Value": "lima" - }, - { - "Key": "department", - "Value": "digital-media" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the tags assigned to the specified load balancer.", - "id": "elbv2-describe-tags-1", - "title": "To describe the tags assigned to a load balancer" - } - ], - "DescribeTargetGroupAttributes": [ - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - }, - "output": { - "Attributes": [ - { - "Key": "stickiness.enabled", - "Value": "false" - }, - { - "Key": "deregistration_delay.timeout_seconds", - "Value": "300" - }, - { - "Key": "stickiness.type", - "Value": "lb_cookie" - }, - { - "Key": "stickiness.lb_cookie.duration_seconds", - "Value": "86400" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the attributes of the specified target group.", - "id": "elbv2-describe-target-group-attributes-1", - "title": "To describe target group attributes" - } - ], - "DescribeTargetGroups": [ - { - "input": { - "TargetGroupArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - ] - }, - "output": { - "TargetGroups": [ - { - "HealthCheckIntervalSeconds": 30, - "HealthCheckPath": "/", - "HealthCheckPort": "traffic-port", - "HealthCheckProtocol": "HTTP", - "HealthCheckTimeoutSeconds": 5, - "HealthyThresholdCount": 5, - "LoadBalancerArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ], - "Matcher": { - "HttpCode": "200" - }, - "Port": 80, - "Protocol": "HTTP", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "TargetGroupName": "my-targets", - "UnhealthyThresholdCount": 2, - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the specified target group.", - "id": "elbv2-describe-target-groups-1", - "title": "To describe a target group" - } - ], - "DescribeTargetHealth": [ - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - }, - "output": { - "TargetHealthDescriptions": [ - { - "Target": { - "Id": "i-0f76fade", - "Port": 80 - }, - "TargetHealth": { - "Description": "Given target group is not configured to receive traffic from ELB", - "Reason": "Target.NotInUse", - "State": "unused" - } - }, - { - "HealthCheckPort": "80", - "Target": { - "Id": "i-0f76fade", - "Port": 80 - }, - "TargetHealth": { - "State": "healthy" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the health of the targets for the specified target group. One target is healthy but the other is not specified in an action, so it can't receive traffic from the load balancer.", - "id": "elbv2-describe-target-health-1", - "title": "To describe the health of the targets for a target group" - }, - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Targets": [ - { - "Id": "i-0f76fade", - "Port": 80 - } - ] - }, - "output": { - "TargetHealthDescriptions": [ - { - "HealthCheckPort": "80", - "Target": { - "Id": "i-0f76fade", - "Port": 80 - }, - "TargetHealth": { - "State": "healthy" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example describes the health of the specified target. This target is healthy.", - "id": "elbv2-describe-target-health-2", - "title": "To describe the health of a target" - } - ], - "ModifyListener": [ - { - "input": { - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2" - }, - "output": { - "Listeners": [ - { - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 80, - "Protocol": "HTTP" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the default action for the specified listener.", - "id": "elbv2-modify-listener-1", - "title": "To change the default action for a listener" - }, - { - "input": { - "Certificates": [ - { - "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65" - }, - "output": { - "Listeners": [ - { - "Certificates": [ - { - "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert" - } - ], - "DefaultActions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65", - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Port": 443, - "Protocol": "HTTPS", - "SslPolicy": "ELBSecurityPolicy-2015-05" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the server certificate for the specified HTTPS listener.", - "id": "elbv2-modify-listener-2", - "title": "To change the server certificate" - } - ], - "ModifyLoadBalancerAttributes": [ - { - "input": { - "Attributes": [ - { - "Key": "deletion_protection.enabled", - "Value": "true" - } - ], - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - }, - "output": { - "Attributes": [ - { - "Key": "deletion_protection.enabled", - "Value": "true" - }, - { - "Key": "access_logs.s3.enabled", - "Value": "false" - }, - { - "Key": "idle_timeout.timeout_seconds", - "Value": "60" - }, - { - "Key": "access_logs.s3.prefix", - "Value": "" - }, - { - "Key": "access_logs.s3.bucket", - "Value": "" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables deletion protection for the specified load balancer.", - "id": "elbv2-modify-load-balancer-attributes-1", - "title": "To enable deletion protection" - }, - { - "input": { - "Attributes": [ - { - "Key": "idle_timeout.timeout_seconds", - "Value": "30" - } - ], - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - }, - "output": { - "Attributes": [ - { - "Key": "idle_timeout.timeout_seconds", - "Value": "30" - }, - { - "Key": "access_logs.s3.enabled", - "Value": "false" - }, - { - "Key": "access_logs.s3.prefix", - "Value": "" - }, - { - "Key": "deletion_protection.enabled", - "Value": "true" - }, - { - "Key": "access_logs.s3.bucket", - "Value": "" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the idle timeout value for the specified load balancer.", - "id": "elbv2-modify-load-balancer-attributes-2", - "title": "To change the idle timeout" - }, - { - "input": { - "Attributes": [ - { - "Key": "access_logs.s3.enabled", - "Value": "true" - }, - { - "Key": "access_logs.s3.bucket", - "Value": "my-loadbalancer-logs" - }, - { - "Key": "access_logs.s3.prefix", - "Value": "myapp" - } - ], - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - }, - "output": { - "Attributes": [ - { - "Key": "access_logs.s3.enabled", - "Value": "true" - }, - { - "Key": "access_logs.s3.bucket", - "Value": "my-load-balancer-logs" - }, - { - "Key": "access_logs.s3.prefix", - "Value": "myapp" - }, - { - "Key": "idle_timeout.timeout_seconds", - "Value": "60" - }, - { - "Key": "deletion_protection.enabled", - "Value": "false" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables access logs for the specified load balancer. Note that the S3 bucket must exist in the same region as the load balancer and must have a policy attached that grants access to the Elastic Load Balancing service.", - "id": "elbv2-modify-load-balancer-attributes-3", - "title": "To enable access logs" - } - ], - "ModifyRule": [ - { - "input": { - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/images/*" - ] - } - ], - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - }, - "output": { - "Rules": [ - { - "Actions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/images/*" - ] - } - ], - "IsDefault": false, - "Priority": "10", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example modifies the condition for the specified rule.", - "id": "elbv2-modify-rule-1", - "title": "To modify a rule" - } - ], - "ModifyTargetGroup": [ - { - "input": { - "HealthCheckPort": "443", - "HealthCheckProtocol": "HTTPS", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f" - }, - "output": { - "TargetGroups": [ - { - "HealthCheckIntervalSeconds": 30, - "HealthCheckPort": "443", - "HealthCheckProtocol": "HTTPS", - "HealthCheckTimeoutSeconds": 5, - "HealthyThresholdCount": 5, - "LoadBalancerArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ], - "Matcher": { - "HttpCode": "200" - }, - "Port": 443, - "Protocol": "HTTPS", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f", - "TargetGroupName": "my-https-targets", - "UnhealthyThresholdCount": 2, - "VpcId": "vpc-3ac0fb5f" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the configuration of the health checks used to evaluate the health of the targets for the specified target group.", - "id": "elbv2-modify-target-group-1", - "title": "To modify the health check configuration for a target group" - } - ], - "ModifyTargetGroupAttributes": [ - { - "input": { - "Attributes": [ - { - "Key": "deregistration_delay.timeout_seconds", - "Value": "600" - } - ], - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - }, - "output": { - "Attributes": [ - { - "Key": "stickiness.enabled", - "Value": "false" - }, - { - "Key": "deregistration_delay.timeout_seconds", - "Value": "600" - }, - { - "Key": "stickiness.type", - "Value": "lb_cookie" - }, - { - "Key": "stickiness.lb_cookie.duration_seconds", - "Value": "86400" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the deregistration delay timeout to the specified value for the specified target group.", - "id": "elbv2-modify-target-group-attributes-1", - "title": "To modify the deregistration delay timeout" - } - ], - "RegisterTargets": [ - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Targets": [ - { - "Id": "i-80c8dd94" - }, - { - "Id": "i-ceddcd4d" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers the specified instances with the specified target group.", - "id": "elbv2-register-targets-1", - "title": "To register targets with a target group" - }, - { - "input": { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/3bb63f11dfb0faf9", - "Targets": [ - { - "Id": "i-80c8dd94", - "Port": 80 - }, - { - "Id": "i-80c8dd94", - "Port": 766 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example registers the specified instance with the specified target group using multiple ports. This enables you to register ECS containers on the same instance as targets in the target group.", - "id": "elbv2-register-targets-2", - "title": "To register targets with a target group using port overrides" - } - ], - "RemoveTags": [ - { - "input": { - "ResourceArns": [ - "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188" - ], - "TagKeys": [ - "project", - "department" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example removes the specified tags from the specified load balancer.", - "id": "elbv2-remove-tags-1", - "title": "To remove tags from a load balancer" - } - ], - "SetRulePriorities": [ - { - "input": { - "RulePriorities": [ - { - "Priority": 5, - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3" - } - ] - }, - "output": { - "Rules": [ - { - "Actions": [ - { - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", - "Type": "forward" - } - ], - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/img/*" - ] - } - ], - "IsDefault": false, - "Priority": "5", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example sets the priority of the specified rule.", - "id": "elbv2-set-rule-priorities-1", - "title": "To set the rule priority" - } - ], - "SetSecurityGroups": [ - { - "input": { - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "SecurityGroups": [ - "sg-5943793c" - ] - }, - "output": { - "SecurityGroupIds": [ - "sg-5943793c" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example associates the specified security group with the specified load balancer.", - "id": "elbv2-set-security-groups-1", - "title": "To associate a security group with a load balancer" - } - ], - "SetSubnets": [ - { - "input": { - "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188", - "Subnets": [ - "subnet-8360a9e7", - "subnet-b7d581c0" - ] - }, - "output": { - "AvailabilityZones": [ - { - "SubnetId": "subnet-8360a9e7", - "ZoneName": "us-west-2a" - }, - { - "SubnetId": "subnet-b7d581c0", - "ZoneName": "us-west-2b" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example enables the Availability Zones for the specified subnets for the specified load balancer.", - "id": "elbv2-set-subnets-1", - "title": "To enable Availability Zones for a load balancer" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/paginators-1.json deleted file mode 100644 index 138d1763..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "DescribeLoadBalancers": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "PageSize", - "result_key": "LoadBalancers" - }, - "DescribeTargetGroups": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "PageSize", - "result_key": "TargetGroups" - }, - "DescribeListeners": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "PageSize", - "result_key": "Listeners" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/service-2.json deleted file mode 100644 index 18ff0a86..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/service-2.json +++ /dev/null @@ -1,3095 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-12-01", - "endpointPrefix":"elasticloadbalancing", - "protocol":"query", - "serviceAbbreviation":"Elastic Load Balancing v2", - "serviceFullName":"Elastic Load Balancing", - "serviceId":"Elastic Load Balancing v2", - "signatureVersion":"v4", - "uid":"elasticloadbalancingv2-2015-12-01", - "xmlNamespace":"http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/" - }, - "operations":{ - "AddListenerCertificates":{ - "name":"AddListenerCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddListenerCertificatesInput"}, - "output":{ - "shape":"AddListenerCertificatesOutput", - "resultWrapper":"AddListenerCertificatesResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"}, - {"shape":"TooManyCertificatesException"}, - {"shape":"CertificateNotFoundException"} - ], - "documentation":"

Adds the specified certificate to the specified secure listener.

If the certificate was already added, the call is successful but the certificate is not added again.

To list the certificates for your listener, use DescribeListenerCertificates. To remove certificates from your listener, use RemoveListenerCertificates.

" - }, - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsInput"}, - "output":{ - "shape":"AddTagsOutput", - "resultWrapper":"AddTagsResult" - }, - "errors":[ - {"shape":"DuplicateTagKeysException"}, - {"shape":"TooManyTagsException"}, - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"} - ], - "documentation":"

Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your Application Load Balancers, Network Load Balancers, and your target groups.

Each tag consists of a key and an optional value. If a resource already has a tag with the same key, AddTags updates its value.

To list the current tags for your resources, use DescribeTags. To remove tags from your resources, use RemoveTags.

" - }, - "CreateListener":{ - "name":"CreateListener", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateListenerInput"}, - "output":{ - "shape":"CreateListenerOutput", - "resultWrapper":"CreateListenerResult" - }, - "errors":[ - {"shape":"DuplicateListenerException"}, - {"shape":"TooManyListenersException"}, - {"shape":"TooManyCertificatesException"}, - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"TargetGroupAssociationLimitException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"IncompatibleProtocolsException"}, - {"shape":"SSLPolicyNotFoundException"}, - {"shape":"CertificateNotFoundException"}, - {"shape":"UnsupportedProtocolException"}, - {"shape":"TooManyRegistrationsForTargetIdException"}, - {"shape":"TooManyTargetsException"}, - {"shape":"TooManyActionsException"}, - {"shape":"InvalidLoadBalancerActionException"} - ], - "documentation":"

Creates a listener for the specified Application Load Balancer or Network Load Balancer.

To update a listener, use ModifyListener. When you are finished with a listener, you can delete it using DeleteListener. If you are finished with both the listener and the load balancer, you can delete them both using DeleteLoadBalancer.

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple listeners with the same settings, each call succeeds.

For more information, see Listeners for Your Application Load Balancers in the Application Load Balancers Guide and Listeners for Your Network Load Balancers in the Network Load Balancers Guide.

" - }, - "CreateLoadBalancer":{ - "name":"CreateLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoadBalancerInput"}, - "output":{ - "shape":"CreateLoadBalancerOutput", - "resultWrapper":"CreateLoadBalancerResult" - }, - "errors":[ - {"shape":"DuplicateLoadBalancerNameException"}, - {"shape":"TooManyLoadBalancersException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"SubnetNotFoundException"}, - {"shape":"InvalidSubnetException"}, - {"shape":"InvalidSecurityGroupException"}, - {"shape":"InvalidSchemeException"}, - {"shape":"TooManyTagsException"}, - {"shape":"DuplicateTagKeysException"}, - {"shape":"ResourceInUseException"}, - {"shape":"AllocationIdNotFoundException"}, - {"shape":"AvailabilityZoneNotSupportedException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Creates an Application Load Balancer or a Network Load Balancer.

When you create a load balancer, you can specify security groups, public subnets, IP address type, and tags. Otherwise, you could do so later using SetSecurityGroups, SetSubnets, SetIpAddressType, and AddTags.

To create listeners for your load balancer, use CreateListener. To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load balancer, you can delete it using DeleteLoadBalancer.

For limit information, see Limits for Your Application Load Balancer in the Application Load Balancers Guide and Limits for Your Network Load Balancer in the Network Load Balancers Guide.

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple load balancers with the same settings, each call succeeds.

For more information, see Application Load Balancers in the Application Load Balancers Guide and Network Load Balancers in the Network Load Balancers Guide.

" - }, - "CreateRule":{ - "name":"CreateRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRuleInput"}, - "output":{ - "shape":"CreateRuleOutput", - "resultWrapper":"CreateRuleResult" - }, - "errors":[ - {"shape":"PriorityInUseException"}, - {"shape":"TooManyTargetGroupsException"}, - {"shape":"TooManyRulesException"}, - {"shape":"TargetGroupAssociationLimitException"}, - {"shape":"IncompatibleProtocolsException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"TooManyRegistrationsForTargetIdException"}, - {"shape":"TooManyTargetsException"}, - {"shape":"UnsupportedProtocolException"}, - {"shape":"TooManyActionsException"}, - {"shape":"InvalidLoadBalancerActionException"} - ], - "documentation":"

Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.

Rules are evaluated in priority order, from the lowest value to the highest value. When the conditions for a rule are met, its actions are performed. If the conditions for no rules are met, the actions for the default rule are performed. For more information, see Listener Rules in the Application Load Balancers Guide.

To view your current rules, use DescribeRules. To update a rule, use ModifyRule. To set the priorities of your rules, use SetRulePriorities. To delete a rule, use DeleteRule.

" - }, - "CreateTargetGroup":{ - "name":"CreateTargetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTargetGroupInput"}, - "output":{ - "shape":"CreateTargetGroupOutput", - "resultWrapper":"CreateTargetGroupResult" - }, - "errors":[ - {"shape":"DuplicateTargetGroupNameException"}, - {"shape":"TooManyTargetGroupsException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Creates a target group.

To register targets with the target group, use RegisterTargets. To update the health check settings for the target group, use ModifyTargetGroup. To monitor the health of targets in the target group, use DescribeTargetHealth.

To route traffic to the targets in a target group, specify the target group in an action using CreateListener or CreateRule.

To delete a target group, use DeleteTargetGroup.

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple target groups with the same settings, each call succeeds.

For more information, see Target Groups for Your Application Load Balancers in the Application Load Balancers Guide or Target Groups for Your Network Load Balancers in the Network Load Balancers Guide.

" - }, - "DeleteListener":{ - "name":"DeleteListener", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteListenerInput"}, - "output":{ - "shape":"DeleteListenerOutput", - "resultWrapper":"DeleteListenerResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"} - ], - "documentation":"

Deletes the specified listener.

Alternatively, your listener is deleted when you delete the load balancer to which it is attached, using DeleteLoadBalancer.

" - }, - "DeleteLoadBalancer":{ - "name":"DeleteLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoadBalancerInput"}, - "output":{ - "shape":"DeleteLoadBalancerOutput", - "resultWrapper":"DeleteLoadBalancerResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes the specified Application Load Balancer or Network Load Balancer and its attached listeners.

You can't delete a load balancer if deletion protection is enabled. If the load balancer does not exist or has already been deleted, the call succeeds.

Deleting a load balancer does not affect its registered targets. For example, your EC2 instances continue to run and are still registered to their target groups. If you no longer need these EC2 instances, you can stop or terminate them.

" - }, - "DeleteRule":{ - "name":"DeleteRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleInput"}, - "output":{ - "shape":"DeleteRuleOutput", - "resultWrapper":"DeleteRuleResult" - }, - "errors":[ - {"shape":"RuleNotFoundException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Deletes the specified rule.

" - }, - "DeleteTargetGroup":{ - "name":"DeleteTargetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTargetGroupInput"}, - "output":{ - "shape":"DeleteTargetGroupOutput", - "resultWrapper":"DeleteTargetGroupResult" - }, - "errors":[ - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes the specified target group.

You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks.

" - }, - "DeregisterTargets":{ - "name":"DeregisterTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterTargetsInput"}, - "output":{ - "shape":"DeregisterTargetsOutput", - "resultWrapper":"DeregisterTargetsResult" - }, - "errors":[ - {"shape":"TargetGroupNotFoundException"}, - {"shape":"InvalidTargetException"} - ], - "documentation":"

Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.

" - }, - "DescribeAccountLimits":{ - "name":"DescribeAccountLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountLimitsInput"}, - "output":{ - "shape":"DescribeAccountLimitsOutput", - "resultWrapper":"DescribeAccountLimitsResult" - }, - "documentation":"

Describes the current Elastic Load Balancing resource limits for your AWS account.

For more information, see Limits for Your Application Load Balancers in the Application Load Balancer Guide or Limits for Your Network Load Balancers in the Network Load Balancers Guide.

" - }, - "DescribeListenerCertificates":{ - "name":"DescribeListenerCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeListenerCertificatesInput"}, - "output":{ - "shape":"DescribeListenerCertificatesOutput", - "resultWrapper":"DescribeListenerCertificatesResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"} - ], - "documentation":"

Describes the certificates for the specified secure listener.

" - }, - "DescribeListeners":{ - "name":"DescribeListeners", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeListenersInput"}, - "output":{ - "shape":"DescribeListenersOutput", - "resultWrapper":"DescribeListenersResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"}, - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"UnsupportedProtocolException"} - ], - "documentation":"

Describes the specified listeners or the listeners for the specified Application Load Balancer or Network Load Balancer. You must specify either a load balancer or one or more listeners.

" - }, - "DescribeLoadBalancerAttributes":{ - "name":"DescribeLoadBalancerAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancerAttributesInput"}, - "output":{ - "shape":"DescribeLoadBalancerAttributesOutput", - "resultWrapper":"DescribeLoadBalancerAttributesResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"} - ], - "documentation":"

Describes the attributes for the specified Application Load Balancer or Network Load Balancer.

For more information, see Load Balancer Attributes in the Application Load Balancers Guide or Load Balancer Attributes in the Network Load Balancers Guide.

" - }, - "DescribeLoadBalancers":{ - "name":"DescribeLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBalancersInput"}, - "output":{ - "shape":"DescribeLoadBalancersOutput", - "resultWrapper":"DescribeLoadBalancersResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"} - ], - "documentation":"

Describes the specified load balancers or all of your load balancers.

To describe the listeners for a load balancer, use DescribeListeners. To describe the attributes for a load balancer, use DescribeLoadBalancerAttributes.

" - }, - "DescribeRules":{ - "name":"DescribeRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRulesInput"}, - "output":{ - "shape":"DescribeRulesOutput", - "resultWrapper":"DescribeRulesResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"}, - {"shape":"RuleNotFoundException"}, - {"shape":"UnsupportedProtocolException"} - ], - "documentation":"

Describes the specified rules or the rules for the specified listener. You must specify either a listener or one or more rules.

" - }, - "DescribeSSLPolicies":{ - "name":"DescribeSSLPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSSLPoliciesInput"}, - "output":{ - "shape":"DescribeSSLPoliciesOutput", - "resultWrapper":"DescribeSSLPoliciesResult" - }, - "errors":[ - {"shape":"SSLPolicyNotFoundException"} - ], - "documentation":"

Describes the specified policies or all policies used for SSL negotiation.

For more information, see Security Policies in the Application Load Balancers Guide.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsInput"}, - "output":{ - "shape":"DescribeTagsOutput", - "resultWrapper":"DescribeTagsResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"RuleNotFoundException"} - ], - "documentation":"

Describes the tags for the specified resources. You can describe the tags for one or more Application Load Balancers, Network Load Balancers, and target groups.

" - }, - "DescribeTargetGroupAttributes":{ - "name":"DescribeTargetGroupAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTargetGroupAttributesInput"}, - "output":{ - "shape":"DescribeTargetGroupAttributesOutput", - "resultWrapper":"DescribeTargetGroupAttributesResult" - }, - "errors":[ - {"shape":"TargetGroupNotFoundException"} - ], - "documentation":"

Describes the attributes for the specified target group.

For more information, see Target Group Attributes in the Application Load Balancers Guide or Target Group Attributes in the Network Load Balancers Guide.

" - }, - "DescribeTargetGroups":{ - "name":"DescribeTargetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTargetGroupsInput"}, - "output":{ - "shape":"DescribeTargetGroupsOutput", - "resultWrapper":"DescribeTargetGroupsResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"} - ], - "documentation":"

Describes the specified target groups or all of your target groups. By default, all target groups are described. Alternatively, you can specify one of the following to filter the results: the ARN of the load balancer, the names of one or more target groups, or the ARNs of one or more target groups.

To describe the targets for a target group, use DescribeTargetHealth. To describe the attributes of a target group, use DescribeTargetGroupAttributes.

" - }, - "DescribeTargetHealth":{ - "name":"DescribeTargetHealth", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTargetHealthInput"}, - "output":{ - "shape":"DescribeTargetHealthOutput", - "resultWrapper":"DescribeTargetHealthResult" - }, - "errors":[ - {"shape":"InvalidTargetException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"HealthUnavailableException"} - ], - "documentation":"

Describes the health of the specified targets or all of your targets.

" - }, - "ModifyListener":{ - "name":"ModifyListener", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyListenerInput"}, - "output":{ - "shape":"ModifyListenerOutput", - "resultWrapper":"ModifyListenerResult" - }, - "errors":[ - {"shape":"DuplicateListenerException"}, - {"shape":"TooManyListenersException"}, - {"shape":"TooManyCertificatesException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"TargetGroupAssociationLimitException"}, - {"shape":"IncompatibleProtocolsException"}, - {"shape":"SSLPolicyNotFoundException"}, - {"shape":"CertificateNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"UnsupportedProtocolException"}, - {"shape":"TooManyRegistrationsForTargetIdException"}, - {"shape":"TooManyTargetsException"}, - {"shape":"TooManyActionsException"}, - {"shape":"InvalidLoadBalancerActionException"} - ], - "documentation":"

Modifies the specified properties of the specified listener.

Any properties that you do not specify retain their current values. However, changing the protocol from HTTPS to HTTP removes the security policy and SSL certificate properties. If you change the protocol from HTTP to HTTPS, you must add the security policy and server certificate.

" - }, - "ModifyLoadBalancerAttributes":{ - "name":"ModifyLoadBalancerAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyLoadBalancerAttributesInput"}, - "output":{ - "shape":"ModifyLoadBalancerAttributesOutput", - "resultWrapper":"ModifyLoadBalancerAttributesResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Modifies the specified attributes of the specified Application Load Balancer or Network Load Balancer.

If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.

" - }, - "ModifyRule":{ - "name":"ModifyRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyRuleInput"}, - "output":{ - "shape":"ModifyRuleOutput", - "resultWrapper":"ModifyRuleResult" - }, - "errors":[ - {"shape":"TargetGroupAssociationLimitException"}, - {"shape":"IncompatibleProtocolsException"}, - {"shape":"RuleNotFoundException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"TooManyRegistrationsForTargetIdException"}, - {"shape":"TooManyTargetsException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"UnsupportedProtocolException"}, - {"shape":"TooManyActionsException"}, - {"shape":"InvalidLoadBalancerActionException"} - ], - "documentation":"

Modifies the specified rule.

Any existing properties that you do not modify retain their current values.

To modify the actions for the default rule, use ModifyListener.

" - }, - "ModifyTargetGroup":{ - "name":"ModifyTargetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyTargetGroupInput"}, - "output":{ - "shape":"ModifyTargetGroupOutput", - "resultWrapper":"ModifyTargetGroupResult" - }, - "errors":[ - {"shape":"TargetGroupNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Modifies the health checks used when evaluating the health state of the targets in the specified target group.

To monitor the health of the targets, use DescribeTargetHealth.

" - }, - "ModifyTargetGroupAttributes":{ - "name":"ModifyTargetGroupAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyTargetGroupAttributesInput"}, - "output":{ - "shape":"ModifyTargetGroupAttributesOutput", - "resultWrapper":"ModifyTargetGroupAttributesResult" - }, - "errors":[ - {"shape":"TargetGroupNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"} - ], - "documentation":"

Modifies the specified attributes of the specified target group.

" - }, - "RegisterTargets":{ - "name":"RegisterTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterTargetsInput"}, - "output":{ - "shape":"RegisterTargetsOutput", - "resultWrapper":"RegisterTargetsResult" - }, - "errors":[ - {"shape":"TargetGroupNotFoundException"}, - {"shape":"TooManyTargetsException"}, - {"shape":"InvalidTargetException"}, - {"shape":"TooManyRegistrationsForTargetIdException"} - ], - "documentation":"

Registers the specified targets with the specified target group.

You can register targets by instance ID or by IP address. If the target is an EC2 instance, it must be in the running state when you register it.

By default, the load balancer routes requests to registered targets using the protocol and port for the target group. Alternatively, you can override the port for a target when you register it. You can register each EC2 instance or IP address with the same target group multiple times using different ports.

With a Network Load Balancer, you cannot register instances by instance ID if they have the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, and T1. You can register instances of these types by IP address.

To remove a target from a target group, use DeregisterTargets.

" - }, - "RemoveListenerCertificates":{ - "name":"RemoveListenerCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveListenerCertificatesInput"}, - "output":{ - "shape":"RemoveListenerCertificatesOutput", - "resultWrapper":"RemoveListenerCertificatesResult" - }, - "errors":[ - {"shape":"ListenerNotFoundException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Removes the specified certificate from the specified secure listener.

You can't remove the default certificate for a listener. To replace the default certificate, call ModifyListener.

To list the certificates for your listener, use DescribeListenerCertificates.

" - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsInput"}, - "output":{ - "shape":"RemoveTagsOutput", - "resultWrapper":"RemoveTagsResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"TargetGroupNotFoundException"}, - {"shape":"ListenerNotFoundException"}, - {"shape":"RuleNotFoundException"}, - {"shape":"TooManyTagsException"} - ], - "documentation":"

Removes the specified tags from the specified Elastic Load Balancing resource.

To list the current tags for your resources, use DescribeTags.

" - }, - "SetIpAddressType":{ - "name":"SetIpAddressType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIpAddressTypeInput"}, - "output":{ - "shape":"SetIpAddressTypeOutput", - "resultWrapper":"SetIpAddressTypeResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"InvalidSubnetException"} - ], - "documentation":"

Sets the type of IP addresses used by the subnets of the specified Application Load Balancer or Network Load Balancer.

Network Load Balancers must use ipv4.

" - }, - "SetRulePriorities":{ - "name":"SetRulePriorities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetRulePrioritiesInput"}, - "output":{ - "shape":"SetRulePrioritiesOutput", - "resultWrapper":"SetRulePrioritiesResult" - }, - "errors":[ - {"shape":"RuleNotFoundException"}, - {"shape":"PriorityInUseException"}, - {"shape":"OperationNotPermittedException"} - ], - "documentation":"

Sets the priorities of the specified rules.

You can reorder the rules as long as there are no priority conflicts in the new order. Any existing rules that you do not specify retain their current priority.

" - }, - "SetSecurityGroups":{ - "name":"SetSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetSecurityGroupsInput"}, - "output":{ - "shape":"SetSecurityGroupsOutput", - "resultWrapper":"SetSecurityGroupsResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"InvalidSecurityGroupException"} - ], - "documentation":"

Associates the specified security groups with the specified Application Load Balancer. The specified security groups override the previously associated security groups.

You can't specify a security group for a Network Load Balancer.

" - }, - "SetSubnets":{ - "name":"SetSubnets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetSubnetsInput"}, - "output":{ - "shape":"SetSubnetsOutput", - "resultWrapper":"SetSubnetsResult" - }, - "errors":[ - {"shape":"LoadBalancerNotFoundException"}, - {"shape":"InvalidConfigurationRequestException"}, - {"shape":"SubnetNotFoundException"}, - {"shape":"InvalidSubnetException"}, - {"shape":"AllocationIdNotFoundException"}, - {"shape":"AvailabilityZoneNotSupportedException"} - ], - "documentation":"

Enables the Availability Zone for the specified public subnets for the specified Application Load Balancer. The specified subnets replace the previously enabled subnets.

You can't change the subnets for a Network Load Balancer.

" - } - }, - "shapes":{ - "Action":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"ActionTypeEnum", - "documentation":"

The type of action. Each rule must include exactly one of the following types of actions: forward, fixed-response, or redirect.

" - }, - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group. Specify only when Type is forward.

" - }, - "AuthenticateOidcConfig":{ - "shape":"AuthenticateOidcActionConfig", - "documentation":"

[HTTPS listener] Information about an identity provider that is compliant with OpenID Connect (OIDC). Specify only when Type is authenticate-oidc.

" - }, - "AuthenticateCognitoConfig":{ - "shape":"AuthenticateCognitoActionConfig", - "documentation":"

[HTTPS listener] Information for using Amazon Cognito to authenticate users. Specify only when Type is authenticate-cognito.

" - }, - "Order":{ - "shape":"ActionOrder", - "documentation":"

The order for the action. This value is required for rules with multiple actions. The action with the lowest value for order is performed first. The final action to be performed must be a forward or a fixed-response action.

" - }, - "RedirectConfig":{ - "shape":"RedirectActionConfig", - "documentation":"

[Application Load Balancer] Information for creating a redirect action. Specify only when Type is redirect.

" - }, - "FixedResponseConfig":{ - "shape":"FixedResponseActionConfig", - "documentation":"

[Application Load Balancer] Information for creating an action that returns a custom HTTP response. Specify only when Type is fixed-response.

" - } - }, - "documentation":"

Information about an action.

" - }, - "ActionOrder":{ - "type":"integer", - "max":50000, - "min":1 - }, - "ActionTypeEnum":{ - "type":"string", - "enum":[ - "forward", - "authenticate-oidc", - "authenticate-cognito", - "redirect", - "fixed-response" - ] - }, - "Actions":{ - "type":"list", - "member":{"shape":"Action"} - }, - "AddListenerCertificatesInput":{ - "type":"structure", - "required":[ - "ListenerArn", - "Certificates" - ], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

The certificate to add. You can specify one certificate per call.

" - } - } - }, - "AddListenerCertificatesOutput":{ - "type":"structure", - "members":{ - "Certificates":{ - "shape":"CertificateList", - "documentation":"

Information about the certificates.

" - } - } - }, - "AddTagsInput":{ - "type":"structure", - "required":[ - "ResourceArns", - "Tags" - ], - "members":{ - "ResourceArns":{ - "shape":"ResourceArns", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags. Each resource can have a maximum of 10 tags.

" - } - } - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - } - }, - "AllocationId":{"type":"string"}, - "AllocationIdNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified allocation ID does not exist.

", - "error":{ - "code":"AllocationIdNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthenticateCognitoActionAuthenticationRequestExtraParams":{ - "type":"map", - "key":{"shape":"AuthenticateCognitoActionAuthenticationRequestParamName"}, - "value":{"shape":"AuthenticateCognitoActionAuthenticationRequestParamValue"} - }, - "AuthenticateCognitoActionAuthenticationRequestParamName":{"type":"string"}, - "AuthenticateCognitoActionAuthenticationRequestParamValue":{"type":"string"}, - "AuthenticateCognitoActionConditionalBehaviorEnum":{ - "type":"string", - "enum":[ - "deny", - "allow", - "authenticate" - ] - }, - "AuthenticateCognitoActionConfig":{ - "type":"structure", - "required":[ - "UserPoolArn", - "UserPoolClientId", - "UserPoolDomain" - ], - "members":{ - "UserPoolArn":{ - "shape":"AuthenticateCognitoActionUserPoolArn", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Cognito user pool.

" - }, - "UserPoolClientId":{ - "shape":"AuthenticateCognitoActionUserPoolClientId", - "documentation":"

The ID of the Amazon Cognito user pool client.

" - }, - "UserPoolDomain":{ - "shape":"AuthenticateCognitoActionUserPoolDomain", - "documentation":"

The domain prefix or fully-qualified domain name of the Amazon Cognito user pool.

" - }, - "SessionCookieName":{ - "shape":"AuthenticateCognitoActionSessionCookieName", - "documentation":"

The name of the cookie used to maintain session information. The default is AWSELBAuthSessionCookie.

" - }, - "Scope":{ - "shape":"AuthenticateCognitoActionScope", - "documentation":"

The set of user claims to be requested from the IdP. The default is openid.

To verify which scope values your IdP supports and how to separate multiple values, see the documentation for your IdP.

" - }, - "SessionTimeout":{ - "shape":"AuthenticateCognitoActionSessionTimeout", - "documentation":"

The maximum duration of the authentication session, in seconds. The default is 604800 seconds (7 days).

" - }, - "AuthenticationRequestExtraParams":{ - "shape":"AuthenticateCognitoActionAuthenticationRequestExtraParams", - "documentation":"

The query parameters (up to 10) to include in the redirect request to the authorization endpoint.

" - }, - "OnUnauthenticatedRequest":{ - "shape":"AuthenticateCognitoActionConditionalBehaviorEnum", - "documentation":"

The behavior if the user is not authenticated. The following are possible values:

  • deny - Return an HTTP 401 Unauthorized error.

  • allow - Allow the request to be forwarded to the target.

  • authenticate - Redirect the request to the IdP authorization endpoint. This is the default value.

" - } - }, - "documentation":"

Request parameters to use when integrating with Amazon Cognito to authenticate users.

" - }, - "AuthenticateCognitoActionScope":{"type":"string"}, - "AuthenticateCognitoActionSessionCookieName":{"type":"string"}, - "AuthenticateCognitoActionSessionTimeout":{"type":"long"}, - "AuthenticateCognitoActionUserPoolArn":{"type":"string"}, - "AuthenticateCognitoActionUserPoolClientId":{"type":"string"}, - "AuthenticateCognitoActionUserPoolDomain":{"type":"string"}, - "AuthenticateOidcActionAuthenticationRequestExtraParams":{ - "type":"map", - "key":{"shape":"AuthenticateOidcActionAuthenticationRequestParamName"}, - "value":{"shape":"AuthenticateOidcActionAuthenticationRequestParamValue"} - }, - "AuthenticateOidcActionAuthenticationRequestParamName":{"type":"string"}, - "AuthenticateOidcActionAuthenticationRequestParamValue":{"type":"string"}, - "AuthenticateOidcActionAuthorizationEndpoint":{"type":"string"}, - "AuthenticateOidcActionClientId":{"type":"string"}, - "AuthenticateOidcActionClientSecret":{"type":"string"}, - "AuthenticateOidcActionConditionalBehaviorEnum":{ - "type":"string", - "enum":[ - "deny", - "allow", - "authenticate" - ] - }, - "AuthenticateOidcActionConfig":{ - "type":"structure", - "required":[ - "Issuer", - "AuthorizationEndpoint", - "TokenEndpoint", - "UserInfoEndpoint", - "ClientId", - "ClientSecret" - ], - "members":{ - "Issuer":{ - "shape":"AuthenticateOidcActionIssuer", - "documentation":"

The OIDC issuer identifier of the IdP. This must be a full URL, including the HTTPS protocol, the domain, and the path.

" - }, - "AuthorizationEndpoint":{ - "shape":"AuthenticateOidcActionAuthorizationEndpoint", - "documentation":"

The authorization endpoint of the IdP. This must be a full URL, including the HTTPS protocol, the domain, and the path.

" - }, - "TokenEndpoint":{ - "shape":"AuthenticateOidcActionTokenEndpoint", - "documentation":"

The token endpoint of the IdP. This must be a full URL, including the HTTPS protocol, the domain, and the path.

" - }, - "UserInfoEndpoint":{ - "shape":"AuthenticateOidcActionUserInfoEndpoint", - "documentation":"

The user info endpoint of the IdP. This must be a full URL, including the HTTPS protocol, the domain, and the path.

" - }, - "ClientId":{ - "shape":"AuthenticateOidcActionClientId", - "documentation":"

The OAuth 2.0 client identifier.

" - }, - "ClientSecret":{ - "shape":"AuthenticateOidcActionClientSecret", - "documentation":"

The OAuth 2.0 client secret.

" - }, - "SessionCookieName":{ - "shape":"AuthenticateOidcActionSessionCookieName", - "documentation":"

The name of the cookie used to maintain session information. The default is AWSELBAuthSessionCookie.

" - }, - "Scope":{ - "shape":"AuthenticateOidcActionScope", - "documentation":"

The set of user claims to be requested from the IdP. The default is openid.

To verify which scope values your IdP supports and how to separate multiple values, see the documentation for your IdP.

" - }, - "SessionTimeout":{ - "shape":"AuthenticateOidcActionSessionTimeout", - "documentation":"

The maximum duration of the authentication session, in seconds. The default is 604800 seconds (7 days).

" - }, - "AuthenticationRequestExtraParams":{ - "shape":"AuthenticateOidcActionAuthenticationRequestExtraParams", - "documentation":"

The query parameters (up to 10) to include in the redirect request to the authorization endpoint.

" - }, - "OnUnauthenticatedRequest":{ - "shape":"AuthenticateOidcActionConditionalBehaviorEnum", - "documentation":"

The behavior if the user is not authenticated. The following are possible values:

  • deny - Return an HTTP 401 Unauthorized error.

  • allow - Allow the request to be forwarded to the target.

  • authenticate - Redirect the request to the IdP authorization endpoint. This is the default value.

" - } - }, - "documentation":"

Request parameters when using an identity provider (IdP) that is compliant with OpenID Connect (OIDC) to authenticate users.

" - }, - "AuthenticateOidcActionIssuer":{"type":"string"}, - "AuthenticateOidcActionScope":{"type":"string"}, - "AuthenticateOidcActionSessionCookieName":{"type":"string"}, - "AuthenticateOidcActionSessionTimeout":{"type":"long"}, - "AuthenticateOidcActionTokenEndpoint":{"type":"string"}, - "AuthenticateOidcActionUserInfoEndpoint":{"type":"string"}, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "ZoneName":{ - "shape":"ZoneName", - "documentation":"

The name of the Availability Zone.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The ID of the subnet.

" - }, - "LoadBalancerAddresses":{ - "shape":"LoadBalancerAddresses", - "documentation":"

[Network Load Balancers] The static IP address.

" - } - }, - "documentation":"

Information about an Availability Zone.

" - }, - "AvailabilityZoneNotSupportedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Availability Zone is not supported.

", - "error":{ - "code":"AvailabilityZoneNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AvailabilityZones":{ - "type":"list", - "member":{"shape":"AvailabilityZone"} - }, - "CanonicalHostedZoneId":{"type":"string"}, - "Certificate":{ - "type":"structure", - "members":{ - "CertificateArn":{ - "shape":"CertificateArn", - "documentation":"

The Amazon Resource Name (ARN) of the certificate.

" - }, - "IsDefault":{ - "shape":"Default", - "documentation":"

Indicates whether the certificate is the default certificate.

" - } - }, - "documentation":"

Information about an SSL server certificate.

" - }, - "CertificateArn":{"type":"string"}, - "CertificateList":{ - "type":"list", - "member":{"shape":"Certificate"} - }, - "CertificateNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified certificate does not exist.

", - "error":{ - "code":"CertificateNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Cipher":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"CipherName", - "documentation":"

The name of the cipher.

" - }, - "Priority":{ - "shape":"CipherPriority", - "documentation":"

The priority of the cipher.

" - } - }, - "documentation":"

Information about a cipher used in a policy.

" - }, - "CipherName":{"type":"string"}, - "CipherPriority":{"type":"integer"}, - "Ciphers":{ - "type":"list", - "member":{"shape":"Cipher"} - }, - "ConditionFieldName":{ - "type":"string", - "max":64 - }, - "CreateListenerInput":{ - "type":"structure", - "required":[ - "LoadBalancerArn", - "Protocol", - "Port", - "DefaultActions" - ], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "Protocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol for connections from clients to the load balancer. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocol is TCP.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on which the load balancer is listening.

" - }, - "SslPolicy":{ - "shape":"SslPolicyName", - "documentation":"

[HTTPS listeners] The security policy that defines which ciphers and protocols are supported. The default is the current predefined security policy.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

[HTTPS listeners] The default SSL server certificate. You must provide exactly one default certificate. To create a certificate list, use AddListenerCertificates.

" - }, - "DefaultActions":{ - "shape":"Actions", - "documentation":"

The actions for the default rule. The rule must include one forward action or one or more fixed-response actions.

If the action type is forward, you can specify a single target group. The protocol of the target group must be HTTP or HTTPS for an Application Load Balancer or TCP for a Network Load Balancer.

[HTTPS listener] If the action type is authenticate-oidc, you can use an identity provider that is OpenID Connect (OIDC) compliant to authenticate users as they access your application.

[HTTPS listener] If the action type is authenticate-cognito, you can use Amazon Cognito to authenticate users as they access your application.

[Application Load Balancer] If the action type is redirect, you can redirect HTTP and HTTPS requests.

[Application Load Balancer] If the action type is fixed-response, you can return a custom HTTP response.

" - } - } - }, - "CreateListenerOutput":{ - "type":"structure", - "members":{ - "Listeners":{ - "shape":"Listeners", - "documentation":"

Information about the listener.

" - } - } - }, - "CreateLoadBalancerInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"LoadBalancerName", - "documentation":"

The name of the load balancer.

This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, must not begin or end with a hyphen, and must not begin with \"internal-\".

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the public subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.

[Application Load Balancers] You must specify subnets from at least two Availability Zones.

[Network Load Balancers] You can specify subnets from one or more Availability Zones.

" - }, - "SubnetMappings":{ - "shape":"SubnetMappings", - "documentation":"

The IDs of the public subnets. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.

[Application Load Balancers] You must specify subnets from at least two Availability Zones. You cannot specify Elastic IP addresses for your subnets.

[Network Load Balancers] You can specify subnets from one or more Availability Zones. You can specify one Elastic IP address per subnet.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

[Application Load Balancers] The IDs of the security groups for the load balancer.

" - }, - "Scheme":{ - "shape":"LoadBalancerSchemeEnum", - "documentation":"

The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the internet.

The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can only route requests from clients with access to the VPC for the load balancer.

The default is an Internet-facing load balancer.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags to assign to the load balancer.

" - }, - "Type":{ - "shape":"LoadBalancerTypeEnum", - "documentation":"

The type of load balancer. The default is application.

" - }, - "IpAddressType":{ - "shape":"IpAddressType", - "documentation":"

[Application Load Balancers] The type of IP addresses used by the subnets for your load balancer. The possible values are ipv4 (for IPv4 addresses) and dualstack (for IPv4 and IPv6 addresses). Internal load balancers must use ipv4.

" - } - } - }, - "CreateLoadBalancerOutput":{ - "type":"structure", - "members":{ - "LoadBalancers":{ - "shape":"LoadBalancers", - "documentation":"

Information about the load balancer.

" - } - } - }, - "CreateRuleInput":{ - "type":"structure", - "required":[ - "ListenerArn", - "Conditions", - "Priority", - "Actions" - ], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "Conditions":{ - "shape":"RuleConditionList", - "documentation":"

The conditions. Each condition specifies a field name and a single value.

If the field name is host-header, you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • - .

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

If the field name is path-pattern, you can specify a single path pattern. A path pattern is case-sensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • _ - . $ / ~ \" ' @ : +

  • & (using &amp;)

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

" - }, - "Priority":{ - "shape":"RulePriority", - "documentation":"

The rule priority. A listener can't have multiple rules with the same priority.

" - }, - "Actions":{ - "shape":"Actions", - "documentation":"

The actions. Each rule must include exactly one of the following types of actions: forward, fixed-response, or redirect.

If the action type is forward, you can specify a single target group.

[HTTPS listener] If the action type is authenticate-oidc, you can use an identity provider that is OpenID Connect (OIDC) compliant to authenticate users as they access your application.

[HTTPS listener] If the action type is authenticate-cognito, you can use Amazon Cognito to authenticate users as they access your application.

[Application Load Balancer] If the action type is redirect, you can redirect HTTP and HTTPS requests.

[Application Load Balancer] If the action type is fixed-response, you can return a custom HTTP response.

" - } - } - }, - "CreateRuleOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"Rules", - "documentation":"

Information about the rule.

" - } - } - }, - "CreateTargetGroupInput":{ - "type":"structure", - "required":[ - "Name", - "Protocol", - "Port", - "VpcId" - ], - "members":{ - "Name":{ - "shape":"TargetGroupName", - "documentation":"

The name of the target group.

This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen.

" - }, - "Protocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol to use for routing traffic to the targets. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocol is TCP.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on which the targets receive traffic. This port is used unless you specify a port override when registering the target.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The identifier of the virtual private cloud (VPC).

" - }, - "HealthCheckProtocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol the load balancer uses when performing health checks on targets. The TCP protocol is supported only if the protocol of the target group is TCP. For Application Load Balancers, the default is HTTP. For Network Load Balancers, the default is TCP.

" - }, - "HealthCheckPort":{ - "shape":"HealthCheckPort", - "documentation":"

The port the load balancer uses when performing health checks on targets. The default is traffic-port, which is the port on which each target receives traffic from the load balancer.

" - }, - "HealthCheckPath":{ - "shape":"Path", - "documentation":"

[HTTP/HTTPS health checks] The ping path that is the destination on the targets for health checks. The default is /.

" - }, - "HealthCheckIntervalSeconds":{ - "shape":"HealthCheckIntervalSeconds", - "documentation":"

The approximate amount of time, in seconds, between health checks of an individual target. For Application Load Balancers, the range is 5–300 seconds. For Network Load Balancers, the supported values are 10 or 30 seconds. The default is 30 seconds.

" - }, - "HealthCheckTimeoutSeconds":{ - "shape":"HealthCheckTimeoutSeconds", - "documentation":"

The amount of time, in seconds, during which no response from a target means a failed health check. For Application Load Balancers, the range is 2–60 seconds and the default is 5 seconds. For Network Load Balancers, this is 10 seconds for TCP and HTTPS health checks and 6 seconds for HTTP health checks.

" - }, - "HealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health checks successes required before considering an unhealthy target healthy. For Application Load Balancers, the default is 5. For Network Load Balancers, the default is 3.

" - }, - "UnhealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health check failures required before considering a target unhealthy. For Application Load Balancers, the default is 2. For Network Load Balancers, this value must be the same as the healthy threshold count.

" - }, - "Matcher":{ - "shape":"Matcher", - "documentation":"

[HTTP/HTTPS health checks] The HTTP codes to use when checking for a successful response from a target.

" - }, - "TargetType":{ - "shape":"TargetTypeEnum", - "documentation":"

The type of target that you must specify when registering targets with this target group. The possible values are instance (targets are specified by instance ID) or ip (targets are specified by IP address). The default is instance. You can't specify targets for a target group using both instance IDs and IP addresses.

If the target type is ip, specify IP addresses from the subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range (100.64.0.0/10). You can't specify publicly routable IP addresses.

" - } - } - }, - "CreateTargetGroupOutput":{ - "type":"structure", - "members":{ - "TargetGroups":{ - "shape":"TargetGroups", - "documentation":"

Information about the target group.

" - } - } - }, - "CreatedTime":{"type":"timestamp"}, - "DNSName":{"type":"string"}, - "Default":{"type":"boolean"}, - "DeleteListenerInput":{ - "type":"structure", - "required":["ListenerArn"], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - } - } - }, - "DeleteListenerOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteLoadBalancerInput":{ - "type":"structure", - "required":["LoadBalancerArn"], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - } - } - }, - "DeleteLoadBalancerOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteRuleInput":{ - "type":"structure", - "required":["RuleArn"], - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - } - } - }, - "DeleteRuleOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteTargetGroupInput":{ - "type":"structure", - "required":["TargetGroupArn"], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - } - } - }, - "DeleteTargetGroupOutput":{ - "type":"structure", - "members":{ - } - }, - "DeregisterTargetsInput":{ - "type":"structure", - "required":[ - "TargetGroupArn", - "Targets" - ], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "Targets":{ - "shape":"TargetDescriptions", - "documentation":"

The targets. If you specified a port override when you registered a target, you must specify both the target ID and the port when you deregister it.

" - } - } - }, - "DeregisterTargetsOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeAccountLimitsInput":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeAccountLimitsOutput":{ - "type":"structure", - "members":{ - "Limits":{ - "shape":"Limits", - "documentation":"

Information about the limits.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeListenerCertificatesInput":{ - "type":"structure", - "required":["ListenerArn"], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Names (ARN) of the listener.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeListenerCertificatesOutput":{ - "type":"structure", - "members":{ - "Certificates":{ - "shape":"CertificateList", - "documentation":"

Information about the certificates.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeListenersInput":{ - "type":"structure", - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "ListenerArns":{ - "shape":"ListenerArns", - "documentation":"

The Amazon Resource Names (ARN) of the listeners.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeListenersOutput":{ - "type":"structure", - "members":{ - "Listeners":{ - "shape":"Listeners", - "documentation":"

Information about the listeners.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeLoadBalancerAttributesInput":{ - "type":"structure", - "required":["LoadBalancerArn"], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - } - } - }, - "DescribeLoadBalancerAttributesOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

Information about the load balancer attributes.

" - } - } - }, - "DescribeLoadBalancersInput":{ - "type":"structure", - "members":{ - "LoadBalancerArns":{ - "shape":"LoadBalancerArns", - "documentation":"

The Amazon Resource Names (ARN) of the load balancers. You can specify up to 20 load balancers in a single call.

" - }, - "Names":{ - "shape":"LoadBalancerNames", - "documentation":"

The names of the load balancers.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeLoadBalancersOutput":{ - "type":"structure", - "members":{ - "LoadBalancers":{ - "shape":"LoadBalancers", - "documentation":"

Information about the load balancers.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeRulesInput":{ - "type":"structure", - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "RuleArns":{ - "shape":"RuleArns", - "documentation":"

The Amazon Resource Names (ARN) of the rules.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeRulesOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"Rules", - "documentation":"

Information about the rules.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeSSLPoliciesInput":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"SslPolicyNames", - "documentation":"

The names of the policies.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeSSLPoliciesOutput":{ - "type":"structure", - "members":{ - "SslPolicies":{ - "shape":"SslPolicies", - "documentation":"

Information about the policies.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeTagsInput":{ - "type":"structure", - "required":["ResourceArns"], - "members":{ - "ResourceArns":{ - "shape":"ResourceArns", - "documentation":"

The Amazon Resource Names (ARN) of the resources.

" - } - } - }, - "DescribeTagsOutput":{ - "type":"structure", - "members":{ - "TagDescriptions":{ - "shape":"TagDescriptions", - "documentation":"

Information about the tags.

" - } - } - }, - "DescribeTargetGroupAttributesInput":{ - "type":"structure", - "required":["TargetGroupArn"], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - } - } - }, - "DescribeTargetGroupAttributesOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"TargetGroupAttributes", - "documentation":"

Information about the target group attributes

" - } - } - }, - "DescribeTargetGroupsInput":{ - "type":"structure", - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "TargetGroupArns":{ - "shape":"TargetGroupArns", - "documentation":"

The Amazon Resource Names (ARN) of the target groups.

" - }, - "Names":{ - "shape":"TargetGroupNames", - "documentation":"

The names of the target groups.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return with this call.

" - } - } - }, - "DescribeTargetGroupsOutput":{ - "type":"structure", - "members":{ - "TargetGroups":{ - "shape":"TargetGroups", - "documentation":"

Information about the target groups.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeTargetHealthInput":{ - "type":"structure", - "required":["TargetGroupArn"], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "Targets":{ - "shape":"TargetDescriptions", - "documentation":"

The targets.

" - } - } - }, - "DescribeTargetHealthOutput":{ - "type":"structure", - "members":{ - "TargetHealthDescriptions":{ - "shape":"TargetHealthDescriptions", - "documentation":"

Information about the health of the targets.

" - } - } - }, - "Description":{"type":"string"}, - "DuplicateListenerException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A listener with the specified port already exists.

", - "error":{ - "code":"DuplicateListener", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicateLoadBalancerNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A load balancer with the specified name already exists.

", - "error":{ - "code":"DuplicateLoadBalancerName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicateTagKeysException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A tag key was specified more than once.

", - "error":{ - "code":"DuplicateTagKeys", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DuplicateTargetGroupNameException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A target group with the specified name already exists.

", - "error":{ - "code":"DuplicateTargetGroupName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "FixedResponseActionConfig":{ - "type":"structure", - "required":["StatusCode"], - "members":{ - "MessageBody":{ - "shape":"FixedResponseActionMessage", - "documentation":"

The message.

" - }, - "StatusCode":{ - "shape":"FixedResponseActionStatusCode", - "documentation":"

The HTTP response code (2XX, 4XX, or 5XX).

" - }, - "ContentType":{ - "shape":"FixedResponseActionContentType", - "documentation":"

The content type.

Valid Values: text/plain | text/css | text/html | application/javascript | application/json

" - } - }, - "documentation":"

Information about an action that returns a custom HTTP response.

" - }, - "FixedResponseActionContentType":{ - "type":"string", - "max":32, - "min":0 - }, - "FixedResponseActionMessage":{ - "type":"string", - "max":1024, - "min":0 - }, - "FixedResponseActionStatusCode":{ - "type":"string", - "pattern":"^(2|4|5)\\d\\d$" - }, - "HealthCheckIntervalSeconds":{ - "type":"integer", - "max":300, - "min":5 - }, - "HealthCheckPort":{"type":"string"}, - "HealthCheckThresholdCount":{ - "type":"integer", - "max":10, - "min":2 - }, - "HealthCheckTimeoutSeconds":{ - "type":"integer", - "max":60, - "min":2 - }, - "HealthUnavailableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The health of the specified targets could not be retrieved due to an internal error.

", - "error":{ - "code":"HealthUnavailable", - "httpStatusCode":500 - }, - "exception":true - }, - "HttpCode":{"type":"string"}, - "IncompatibleProtocolsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified configuration is not valid with this protocol.

", - "error":{ - "code":"IncompatibleProtocols", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidConfigurationRequestException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested configuration is not valid.

", - "error":{ - "code":"InvalidConfigurationRequest", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidLoadBalancerActionException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested action is not valid.

", - "error":{ - "code":"InvalidLoadBalancerAction", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSchemeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested scheme is not valid.

", - "error":{ - "code":"InvalidScheme", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSecurityGroupException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified security group does not exist.

", - "error":{ - "code":"InvalidSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnetException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified subnet is out of available addresses.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidTargetException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified target does not exist, is not in the same VPC as the target group, or has an unsupported instance type.

", - "error":{ - "code":"InvalidTarget", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "IpAddress":{"type":"string"}, - "IpAddressType":{ - "type":"string", - "enum":[ - "ipv4", - "dualstack" - ] - }, - "IsDefault":{"type":"boolean"}, - "Limit":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Name", - "documentation":"

The name of the limit. The possible values are:

  • application-load-balancers

  • listeners-per-application-load-balancer

  • listeners-per-network-load-balancer

  • network-load-balancers

  • rules-per-application-load-balancer

  • target-groups

  • targets-per-application-load-balancer

  • targets-per-availability-zone-per-network-load-balancer

  • targets-per-network-load-balancer

" - }, - "Max":{ - "shape":"Max", - "documentation":"

The maximum value of the limit.

" - } - }, - "documentation":"

Information about an Elastic Load Balancing resource limit for your AWS account.

" - }, - "Limits":{ - "type":"list", - "member":{"shape":"Limit"} - }, - "ListOfString":{ - "type":"list", - "member":{"shape":"StringValue"} - }, - "Listener":{ - "type":"structure", - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on which the load balancer is listening.

" - }, - "Protocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol for connections from clients to the load balancer.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

The SSL server certificate. You must provide a certificate if the protocol is HTTPS.

" - }, - "SslPolicy":{ - "shape":"SslPolicyName", - "documentation":"

The security policy that defines which ciphers and protocols are supported. The default is the current predefined security policy.

" - }, - "DefaultActions":{ - "shape":"Actions", - "documentation":"

The default actions for the listener.

" - } - }, - "documentation":"

Information about a listener.

" - }, - "ListenerArn":{"type":"string"}, - "ListenerArns":{ - "type":"list", - "member":{"shape":"ListenerArn"} - }, - "ListenerNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified listener does not exist.

", - "error":{ - "code":"ListenerNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Listeners":{ - "type":"list", - "member":{"shape":"Listener"} - }, - "LoadBalancer":{ - "type":"structure", - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "DNSName":{ - "shape":"DNSName", - "documentation":"

The public DNS name of the load balancer.

" - }, - "CanonicalHostedZoneId":{ - "shape":"CanonicalHostedZoneId", - "documentation":"

The ID of the Amazon Route 53 hosted zone associated with the load balancer.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The date and time the load balancer was created.

" - }, - "LoadBalancerName":{ - "shape":"LoadBalancerName", - "documentation":"

The name of the load balancer.

" - }, - "Scheme":{ - "shape":"LoadBalancerSchemeEnum", - "documentation":"

The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the internet.

The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can only route requests from clients with access to the VPC for the load balancer.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The ID of the VPC for the load balancer.

" - }, - "State":{ - "shape":"LoadBalancerState", - "documentation":"

The state of the load balancer.

" - }, - "Type":{ - "shape":"LoadBalancerTypeEnum", - "documentation":"

The type of load balancer.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

The Availability Zones for the load balancer.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups for the load balancer.

" - }, - "IpAddressType":{ - "shape":"IpAddressType", - "documentation":"

The type of IP addresses used by the subnets for your load balancer. The possible values are ipv4 (for IPv4 addresses) and dualstack (for IPv4 and IPv6 addresses).

" - } - }, - "documentation":"

Information about a load balancer.

" - }, - "LoadBalancerAddress":{ - "type":"structure", - "members":{ - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

The static IP address.

" - }, - "AllocationId":{ - "shape":"AllocationId", - "documentation":"

[Network Load Balancers] The allocation ID of the Elastic IP address.

" - } - }, - "documentation":"

Information about a static IP address for a load balancer.

" - }, - "LoadBalancerAddresses":{ - "type":"list", - "member":{"shape":"LoadBalancerAddress"} - }, - "LoadBalancerArn":{"type":"string"}, - "LoadBalancerArns":{ - "type":"list", - "member":{"shape":"LoadBalancerArn"} - }, - "LoadBalancerAttribute":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"LoadBalancerAttributeKey", - "documentation":"

The name of the attribute.

The following attributes are supported by both Application Load Balancers and Network Load Balancers:

  • deletion_protection.enabled - Indicates whether deletion protection is enabled. The value is true or false. The default is false.

The following attributes are supported by only Application Load Balancers:

  • access_logs.s3.enabled - Indicates whether access logs are enabled. The value is true or false. The default is false.

  • access_logs.s3.bucket - The name of the S3 bucket for the access logs. This attribute is required if access logs are enabled. The bucket must exist in the same region as the load balancer and have a bucket policy that grants Elastic Load Balancing permissions to write to the bucket.

  • access_logs.s3.prefix - The prefix for the location in the S3 bucket for the access logs.

  • idle_timeout.timeout_seconds - The idle timeout value, in seconds. The valid range is 1-4000 seconds. The default is 60 seconds.

  • routing.http2.enabled - Indicates whether HTTP/2 is enabled. The value is true or false. The default is true.

The following attributes are supported by only Network Load Balancers:

  • load_balancing.cross_zone.enabled - Indicates whether cross-zone load balancing is enabled. The value is true or false. The default is false.

" - }, - "Value":{ - "shape":"LoadBalancerAttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Information about a load balancer attribute.

" - }, - "LoadBalancerAttributeKey":{ - "type":"string", - "max":256, - "pattern":"^[a-zA-Z0-9._]+$" - }, - "LoadBalancerAttributeValue":{ - "type":"string", - "max":1024 - }, - "LoadBalancerAttributes":{ - "type":"list", - "member":{"shape":"LoadBalancerAttribute"}, - "max":20 - }, - "LoadBalancerName":{"type":"string"}, - "LoadBalancerNames":{ - "type":"list", - "member":{"shape":"LoadBalancerName"} - }, - "LoadBalancerNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified load balancer does not exist.

", - "error":{ - "code":"LoadBalancerNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LoadBalancerSchemeEnum":{ - "type":"string", - "enum":[ - "internet-facing", - "internal" - ] - }, - "LoadBalancerState":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"LoadBalancerStateEnum", - "documentation":"

The state code. The initial state of the load balancer is provisioning. After the load balancer is fully set up and ready to route traffic, its state is active. If the load balancer could not be set up, its state is failed.

" - }, - "Reason":{ - "shape":"StateReason", - "documentation":"

A description of the state.

" - } - }, - "documentation":"

Information about the state of the load balancer.

" - }, - "LoadBalancerStateEnum":{ - "type":"string", - "enum":[ - "active", - "provisioning", - "active_impaired", - "failed" - ] - }, - "LoadBalancerTypeEnum":{ - "type":"string", - "enum":[ - "application", - "network" - ] - }, - "LoadBalancers":{ - "type":"list", - "member":{"shape":"LoadBalancer"} - }, - "Marker":{"type":"string"}, - "Matcher":{ - "type":"structure", - "required":["HttpCode"], - "members":{ - "HttpCode":{ - "shape":"HttpCode", - "documentation":"

The HTTP codes.

For Application Load Balancers, you can specify values between 200 and 499, and the default value is 200. You can specify multiple values (for example, \"200,202\") or a range of values (for example, \"200-299\").

For Network Load Balancers, this is 200–399.

" - } - }, - "documentation":"

Information to use when checking for a successful response from a target.

" - }, - "Max":{"type":"string"}, - "ModifyListenerInput":{ - "type":"structure", - "required":["ListenerArn"], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port for connections from clients to the load balancer.

" - }, - "Protocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol for connections from clients to the load balancer. Application Load Balancers support HTTP and HTTPS and Network Load Balancers support TCP.

" - }, - "SslPolicy":{ - "shape":"SslPolicyName", - "documentation":"

[HTTPS listeners] The security policy that defines which protocols and ciphers are supported. For more information, see Security Policies in the Application Load Balancers Guide.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

[HTTPS listeners] The default SSL server certificate. You must provide exactly one default certificate. To create a certificate list, use AddListenerCertificates.

" - }, - "DefaultActions":{ - "shape":"Actions", - "documentation":"

The actions for the default rule. The rule must include one forward action or one or more fixed-response actions.

If the action type is forward, you can specify a single target group. The protocol of the target group must be HTTP or HTTPS for an Application Load Balancer or TCP for a Network Load Balancer.

[HTTPS listener] If the action type is authenticate-oidc, you can use an identity provider that is OpenID Connect (OIDC) compliant to authenticate users as they access your application.

[HTTPS listener] If the action type is authenticate-cognito, you can use Amazon Cognito to authenticate users as they access your application.

[Application Load Balancer] If the action type is redirect, you can redirect HTTP and HTTPS requests.

[Application Load Balancer] If the action type is fixed-response, you can return a custom HTTP response.

" - } - } - }, - "ModifyListenerOutput":{ - "type":"structure", - "members":{ - "Listeners":{ - "shape":"Listeners", - "documentation":"

Information about the modified listener.

" - } - } - }, - "ModifyLoadBalancerAttributesInput":{ - "type":"structure", - "required":[ - "LoadBalancerArn", - "Attributes" - ], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "Attributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

The load balancer attributes.

" - } - } - }, - "ModifyLoadBalancerAttributesOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"LoadBalancerAttributes", - "documentation":"

Information about the load balancer attributes.

" - } - } - }, - "ModifyRuleInput":{ - "type":"structure", - "required":["RuleArn"], - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "Conditions":{ - "shape":"RuleConditionList", - "documentation":"

The conditions. Each condition specifies a field name and a single value.

If the field name is host-header, you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • - .

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

If the field name is path-pattern, you can specify a single path pattern. A path pattern is case-sensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • _ - . $ / ~ \" ' @ : +

  • & (using &amp;)

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

" - }, - "Actions":{ - "shape":"Actions", - "documentation":"

The actions.

If the action type is forward, you can specify a single target group.

If the action type is authenticate-oidc, you can use an identity provider that is OpenID Connect (OIDC) compliant to authenticate users as they access your application.

If the action type is authenticate-cognito, you can use Amazon Cognito to authenticate users as they access your application.

" - } - } - }, - "ModifyRuleOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"Rules", - "documentation":"

Information about the modified rule.

" - } - } - }, - "ModifyTargetGroupAttributesInput":{ - "type":"structure", - "required":[ - "TargetGroupArn", - "Attributes" - ], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "Attributes":{ - "shape":"TargetGroupAttributes", - "documentation":"

The attributes.

" - } - } - }, - "ModifyTargetGroupAttributesOutput":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"TargetGroupAttributes", - "documentation":"

Information about the attributes.

" - } - } - }, - "ModifyTargetGroupInput":{ - "type":"structure", - "required":["TargetGroupArn"], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "HealthCheckProtocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol the load balancer uses when performing health checks on targets. The TCP protocol is supported only if the protocol of the target group is TCP.

" - }, - "HealthCheckPort":{ - "shape":"HealthCheckPort", - "documentation":"

The port the load balancer uses when performing health checks on targets.

" - }, - "HealthCheckPath":{ - "shape":"Path", - "documentation":"

[HTTP/HTTPS health checks] The ping path that is the destination for the health check request.

" - }, - "HealthCheckIntervalSeconds":{ - "shape":"HealthCheckIntervalSeconds", - "documentation":"

The approximate amount of time, in seconds, between health checks of an individual target. For Application Load Balancers, the range is 5–300 seconds. For Network Load Balancers, the supported values are 10 or 30 seconds.

" - }, - "HealthCheckTimeoutSeconds":{ - "shape":"HealthCheckTimeoutSeconds", - "documentation":"

[HTTP/HTTPS health checks] The amount of time, in seconds, during which no response means a failed health check.

" - }, - "HealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health checks successes required before considering an unhealthy target healthy.

" - }, - "UnhealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health check failures required before considering the target unhealthy. For Network Load Balancers, this value must be the same as the healthy threshold count.

" - }, - "Matcher":{ - "shape":"Matcher", - "documentation":"

[HTTP/HTTPS health checks] The HTTP codes to use when checking for a successful response from a target.

" - } - } - }, - "ModifyTargetGroupOutput":{ - "type":"structure", - "members":{ - "TargetGroups":{ - "shape":"TargetGroups", - "documentation":"

Information about the modified target group.

" - } - } - }, - "Name":{"type":"string"}, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This operation is not allowed.

", - "error":{ - "code":"OperationNotPermitted", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PageSize":{ - "type":"integer", - "max":400, - "min":1 - }, - "Path":{ - "type":"string", - "max":1024, - "min":1 - }, - "Port":{ - "type":"integer", - "max":65535, - "min":1 - }, - "PriorityInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified priority is in use.

", - "error":{ - "code":"PriorityInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ProtocolEnum":{ - "type":"string", - "enum":[ - "HTTP", - "HTTPS", - "TCP" - ] - }, - "RedirectActionConfig":{ - "type":"structure", - "required":["StatusCode"], - "members":{ - "Protocol":{ - "shape":"RedirectActionProtocol", - "documentation":"

The protocol. You can specify HTTP, HTTPS, or #{protocol}. You can redirect HTTP to HTTP, HTTP to HTTPS, and HTTPS to HTTPS. You cannot redirect HTTPS to HTTP.

" - }, - "Port":{ - "shape":"RedirectActionPort", - "documentation":"

The port. You can specify a value from 1 to 65535 or #{port}.

" - }, - "Host":{ - "shape":"RedirectActionHost", - "documentation":"

The hostname. This component is not percent-encoded. The hostname can contain #{host}.

" - }, - "Path":{ - "shape":"RedirectActionPath", - "documentation":"

The absolute path, starting with the leading \"/\". This component is not percent-encoded. The path can contain #{host}, #{path}, and #{port}.

" - }, - "Query":{ - "shape":"RedirectActionQuery", - "documentation":"

The query parameters, URL-encoded when necessary, but not percent-encoded. Do not include the leading \"?\", as it is automatically added. You can specify any of the reserved keywords.

" - }, - "StatusCode":{ - "shape":"RedirectActionStatusCodeEnum", - "documentation":"

The HTTP redirect code. The redirect is either permanent (HTTP 301) or temporary (HTTP 302).

" - } - }, - "documentation":"

Information about a redirect action.

A URI consists of the following components: protocol://hostname:port/path?query. You must modify at least one of the following components to avoid a redirect loop: protocol, hostname, port, or path. Any components that you do not modify retain their original values.

You can reuse URI components using the following reserved keywords:

  • #{protocol}

  • #{host}

  • #{port}

  • #{path} (the leading \"/\" is removed)

  • #{query}

For example, you can change the path to \"/new/#{path}\", the hostname to \"example.#{host}\", or the query to \"#{query}&value=xyz\".

" - }, - "RedirectActionHost":{ - "type":"string", - "max":128, - "min":1 - }, - "RedirectActionPath":{ - "type":"string", - "max":128, - "min":1 - }, - "RedirectActionPort":{"type":"string"}, - "RedirectActionProtocol":{ - "type":"string", - "pattern":"^(HTTPS?|#\\{protocol\\})$" - }, - "RedirectActionQuery":{ - "type":"string", - "max":128, - "min":0 - }, - "RedirectActionStatusCodeEnum":{ - "type":"string", - "enum":[ - "HTTP_301", - "HTTP_302" - ] - }, - "RegisterTargetsInput":{ - "type":"structure", - "required":[ - "TargetGroupArn", - "Targets" - ], - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "Targets":{ - "shape":"TargetDescriptions", - "documentation":"

The targets.

" - } - } - }, - "RegisterTargetsOutput":{ - "type":"structure", - "members":{ - } - }, - "RemoveListenerCertificatesInput":{ - "type":"structure", - "required":[ - "ListenerArn", - "Certificates" - ], - "members":{ - "ListenerArn":{ - "shape":"ListenerArn", - "documentation":"

The Amazon Resource Name (ARN) of the listener.

" - }, - "Certificates":{ - "shape":"CertificateList", - "documentation":"

The certificate to remove. You can specify one certificate per call.

" - } - } - }, - "RemoveListenerCertificatesOutput":{ - "type":"structure", - "members":{ - } - }, - "RemoveTagsInput":{ - "type":"structure", - "required":[ - "ResourceArns", - "TagKeys" - ], - "members":{ - "ResourceArns":{ - "shape":"ResourceArns", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

The tag keys for the tags to remove.

" - } - } - }, - "RemoveTagsOutput":{ - "type":"structure", - "members":{ - } - }, - "ResourceArn":{"type":"string"}, - "ResourceArns":{ - "type":"list", - "member":{"shape":"ResourceArn"} - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A specified resource is in use.

", - "error":{ - "code":"ResourceInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Rule":{ - "type":"structure", - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "Priority":{ - "shape":"String", - "documentation":"

The priority.

" - }, - "Conditions":{ - "shape":"RuleConditionList", - "documentation":"

The conditions.

" - }, - "Actions":{ - "shape":"Actions", - "documentation":"

The actions.

" - }, - "IsDefault":{ - "shape":"IsDefault", - "documentation":"

Indicates whether this is the default rule.

" - } - }, - "documentation":"

Information about a rule.

" - }, - "RuleArn":{"type":"string"}, - "RuleArns":{ - "type":"list", - "member":{"shape":"RuleArn"} - }, - "RuleCondition":{ - "type":"structure", - "members":{ - "Field":{ - "shape":"ConditionFieldName", - "documentation":"

The name of the field. The possible values are host-header and path-pattern.

" - }, - "Values":{ - "shape":"ListOfString", - "documentation":"

The condition value.

If the field name is host-header, you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • - .

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

If the field name is path-pattern, you can specify a single path pattern (for example, /img/*). A path pattern is case-sensitive, can be up to 128 characters in length, and can contain any of the following characters. You can include up to three wildcard characters.

  • A-Z, a-z, 0-9

  • _ - . $ / ~ \" ' @ : +

  • & (using &amp;)

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

" - } - }, - "documentation":"

Information about a condition for a rule.

" - }, - "RuleConditionList":{ - "type":"list", - "member":{"shape":"RuleCondition"} - }, - "RuleNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified rule does not exist.

", - "error":{ - "code":"RuleNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "RulePriority":{ - "type":"integer", - "max":50000, - "min":1 - }, - "RulePriorityList":{ - "type":"list", - "member":{"shape":"RulePriorityPair"} - }, - "RulePriorityPair":{ - "type":"structure", - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "Priority":{ - "shape":"RulePriority", - "documentation":"

The rule priority.

" - } - }, - "documentation":"

Information about the priorities for the rules for a listener.

" - }, - "Rules":{ - "type":"list", - "member":{"shape":"Rule"} - }, - "SSLPolicyNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified SSL policy does not exist.

", - "error":{ - "code":"SSLPolicyNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SecurityGroupId":{"type":"string"}, - "SecurityGroups":{ - "type":"list", - "member":{"shape":"SecurityGroupId"} - }, - "SetIpAddressTypeInput":{ - "type":"structure", - "required":[ - "LoadBalancerArn", - "IpAddressType" - ], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "IpAddressType":{ - "shape":"IpAddressType", - "documentation":"

The IP address type. The possible values are ipv4 (for IPv4 addresses) and dualstack (for IPv4 and IPv6 addresses). Internal load balancers must use ipv4.

" - } - } - }, - "SetIpAddressTypeOutput":{ - "type":"structure", - "members":{ - "IpAddressType":{ - "shape":"IpAddressType", - "documentation":"

The IP address type.

" - } - } - }, - "SetRulePrioritiesInput":{ - "type":"structure", - "required":["RulePriorities"], - "members":{ - "RulePriorities":{ - "shape":"RulePriorityList", - "documentation":"

The rule priorities.

" - } - } - }, - "SetRulePrioritiesOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"Rules", - "documentation":"

Information about the rules.

" - } - } - }, - "SetSecurityGroupsInput":{ - "type":"structure", - "required":[ - "LoadBalancerArn", - "SecurityGroups" - ], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups.

" - } - } - }, - "SetSecurityGroupsOutput":{ - "type":"structure", - "members":{ - "SecurityGroupIds":{ - "shape":"SecurityGroups", - "documentation":"

The IDs of the security groups associated with the load balancer.

" - } - } - }, - "SetSubnetsInput":{ - "type":"structure", - "required":["LoadBalancerArn"], - "members":{ - "LoadBalancerArn":{ - "shape":"LoadBalancerArn", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The IDs of the public subnets. You must specify subnets from at least two Availability Zones. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.

" - }, - "SubnetMappings":{ - "shape":"SubnetMappings", - "documentation":"

The IDs of the public subnets. You must specify subnets from at least two Availability Zones. You can specify only one subnet per Availability Zone. You must specify either subnets or subnet mappings.

You cannot specify Elastic IP addresses for your subnets.

" - } - } - }, - "SetSubnetsOutput":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Information about the subnet and Availability Zone.

" - } - } - }, - "SslPolicies":{ - "type":"list", - "member":{"shape":"SslPolicy"} - }, - "SslPolicy":{ - "type":"structure", - "members":{ - "SslProtocols":{ - "shape":"SslProtocols", - "documentation":"

The protocols.

" - }, - "Ciphers":{ - "shape":"Ciphers", - "documentation":"

The ciphers.

" - }, - "Name":{ - "shape":"SslPolicyName", - "documentation":"

The name of the policy.

" - } - }, - "documentation":"

Information about a policy used for SSL negotiation.

" - }, - "SslPolicyName":{"type":"string"}, - "SslPolicyNames":{ - "type":"list", - "member":{"shape":"SslPolicyName"} - }, - "SslProtocol":{"type":"string"}, - "SslProtocols":{ - "type":"list", - "member":{"shape":"SslProtocol"} - }, - "StateReason":{"type":"string"}, - "String":{"type":"string"}, - "StringValue":{"type":"string"}, - "SubnetId":{"type":"string"}, - "SubnetMapping":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The ID of the subnet.

" - }, - "AllocationId":{ - "shape":"AllocationId", - "documentation":"

[Network Load Balancers] The allocation ID of the Elastic IP address.

" - } - }, - "documentation":"

Information about a subnet mapping.

" - }, - "SubnetMappings":{ - "type":"list", - "member":{"shape":"SubnetMapping"} - }, - "SubnetNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified subnet does not exist.

", - "error":{ - "code":"SubnetNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Subnets":{ - "type":"list", - "member":{"shape":"SubnetId"} - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Information about a tag.

" - }, - "TagDescription":{ - "type":"structure", - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

Information about the tags.

" - } - }, - "documentation":"

The tags associated with a resource.

" - }, - "TagDescriptions":{ - "type":"list", - "member":{"shape":"TagDescription"} - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TargetDescription":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TargetId", - "documentation":"

The ID of the target. If the target type of the target group is instance, specify an instance ID. If the target type is ip, specify an IP address.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on which the target is listening.

" - }, - "AvailabilityZone":{ - "shape":"ZoneName", - "documentation":"

An Availability Zone or all. This determines whether the target receives traffic from the load balancer nodes in the specified Availability Zone or from all enabled Availability Zones for the load balancer.

This parameter is not supported if the target type of the target group is instance. If the IP address is in a subnet of the VPC for the target group, the Availability Zone is automatically detected and this parameter is optional. If the IP address is outside the VPC, this parameter is required.

With an Application Load Balancer, if the IP address is outside the VPC for the target group, the only supported value is all.

" - } - }, - "documentation":"

Information about a target.

" - }, - "TargetDescriptions":{ - "type":"list", - "member":{"shape":"TargetDescription"} - }, - "TargetGroup":{ - "type":"structure", - "members":{ - "TargetGroupArn":{ - "shape":"TargetGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the target group.

" - }, - "TargetGroupName":{ - "shape":"TargetGroupName", - "documentation":"

The name of the target group.

" - }, - "Protocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol to use for routing traffic to the targets.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on which the targets are listening.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The ID of the VPC for the targets.

" - }, - "HealthCheckProtocol":{ - "shape":"ProtocolEnum", - "documentation":"

The protocol to use to connect with the target.

" - }, - "HealthCheckPort":{ - "shape":"HealthCheckPort", - "documentation":"

The port to use to connect with the target.

" - }, - "HealthCheckIntervalSeconds":{ - "shape":"HealthCheckIntervalSeconds", - "documentation":"

The approximate amount of time, in seconds, between health checks of an individual target.

" - }, - "HealthCheckTimeoutSeconds":{ - "shape":"HealthCheckTimeoutSeconds", - "documentation":"

The amount of time, in seconds, during which no response means a failed health check.

" - }, - "HealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health checks successes required before considering an unhealthy target healthy.

" - }, - "UnhealthyThresholdCount":{ - "shape":"HealthCheckThresholdCount", - "documentation":"

The number of consecutive health check failures required before considering the target unhealthy.

" - }, - "HealthCheckPath":{ - "shape":"Path", - "documentation":"

The destination for the health check request.

" - }, - "Matcher":{ - "shape":"Matcher", - "documentation":"

The HTTP codes to use when checking for a successful response from a target.

" - }, - "LoadBalancerArns":{ - "shape":"LoadBalancerArns", - "documentation":"

The Amazon Resource Names (ARN) of the load balancers that route traffic to this target group.

" - }, - "TargetType":{ - "shape":"TargetTypeEnum", - "documentation":"

The type of target that you must specify when registering targets with this target group. The possible values are instance (targets are specified by instance ID) or ip (targets are specified by IP address).

" - } - }, - "documentation":"

Information about a target group.

" - }, - "TargetGroupArn":{"type":"string"}, - "TargetGroupArns":{ - "type":"list", - "member":{"shape":"TargetGroupArn"} - }, - "TargetGroupAssociationLimitException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of load balancers per target group.

", - "error":{ - "code":"TargetGroupAssociationLimit", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TargetGroupAttribute":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TargetGroupAttributeKey", - "documentation":"

The name of the attribute.

The following attributes are supported by both Application Load Balancers and Network Load Balancers:

  • deregistration_delay.timeout_seconds - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from draining to unused. The range is 0-3600 seconds. The default value is 300 seconds.

The following attributes are supported by only Application Load Balancers:

  • slow_start.duration_seconds - The time period, in seconds, during which a newly registered target receives a linearly increasing share of the traffic to the target group. After this time period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). Slow start mode is disabled by default.

  • stickiness.enabled - Indicates whether sticky sessions are enabled. The value is true or false. The default is false.

  • stickiness.type - The type of sticky sessions. The possible value is lb_cookie.

  • stickiness.lb_cookie.duration_seconds - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the load balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds).

The following attributes are supported by only Network Load Balancers:

  • proxy_protocol_v2.enabled - Indicates whether Proxy Protocol version 2 is enabled. The value is true or false. The default is false.

" - }, - "Value":{ - "shape":"TargetGroupAttributeValue", - "documentation":"

The value of the attribute.

" - } - }, - "documentation":"

Information about a target group attribute.

" - }, - "TargetGroupAttributeKey":{ - "type":"string", - "max":256, - "pattern":"^[a-zA-Z0-9._]+$" - }, - "TargetGroupAttributeValue":{"type":"string"}, - "TargetGroupAttributes":{ - "type":"list", - "member":{"shape":"TargetGroupAttribute"} - }, - "TargetGroupName":{"type":"string"}, - "TargetGroupNames":{ - "type":"list", - "member":{"shape":"TargetGroupName"} - }, - "TargetGroupNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified target group does not exist.

", - "error":{ - "code":"TargetGroupNotFound", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TargetGroups":{ - "type":"list", - "member":{"shape":"TargetGroup"} - }, - "TargetHealth":{ - "type":"structure", - "members":{ - "State":{ - "shape":"TargetHealthStateEnum", - "documentation":"

The state of the target.

" - }, - "Reason":{ - "shape":"TargetHealthReasonEnum", - "documentation":"

The reason code. If the target state is healthy, a reason code is not provided.

If the target state is initial, the reason code can be one of the following values:

  • Elb.RegistrationInProgress - The target is in the process of being registered with the load balancer.

  • Elb.InitialHealthChecking - The load balancer is still sending the target the minimum number of health checks required to determine its health status.

If the target state is unhealthy, the reason code can be one of the following values:

  • Target.ResponseCodeMismatch - The health checks did not return an expected HTTP code.

  • Target.Timeout - The health check requests timed out.

  • Target.FailedHealthChecks - The health checks failed because the connection to the target timed out, the target response was malformed, or the target failed the health check for an unknown reason.

  • Elb.InternalError - The health checks failed due to an internal error.

If the target state is unused, the reason code can be one of the following values:

  • Target.NotRegistered - The target is not registered with the target group.

  • Target.NotInUse - The target group is not used by any load balancer or the target is in an Availability Zone that is not enabled for its load balancer.

  • Target.IpUnusable - The target IP address is reserved for use by a load balancer.

  • Target.InvalidState - The target is in the stopped or terminated state.

If the target state is draining, the reason code can be the following value:

  • Target.DeregistrationInProgress - The target is in the process of being deregistered and the deregistration delay period has not expired.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description of the target health that provides additional details. If the state is healthy, a description is not provided.

" - } - }, - "documentation":"

Information about the current health of a target.

" - }, - "TargetHealthDescription":{ - "type":"structure", - "members":{ - "Target":{ - "shape":"TargetDescription", - "documentation":"

The description of the target.

" - }, - "HealthCheckPort":{ - "shape":"HealthCheckPort", - "documentation":"

The port to use to connect with the target.

" - }, - "TargetHealth":{ - "shape":"TargetHealth", - "documentation":"

The health information for the target.

" - } - }, - "documentation":"

Information about the health of a target.

" - }, - "TargetHealthDescriptions":{ - "type":"list", - "member":{"shape":"TargetHealthDescription"} - }, - "TargetHealthReasonEnum":{ - "type":"string", - "enum":[ - "Elb.RegistrationInProgress", - "Elb.InitialHealthChecking", - "Target.ResponseCodeMismatch", - "Target.Timeout", - "Target.FailedHealthChecks", - "Target.NotRegistered", - "Target.NotInUse", - "Target.DeregistrationInProgress", - "Target.InvalidState", - "Target.IpUnusable", - "Elb.InternalError" - ] - }, - "TargetHealthStateEnum":{ - "type":"string", - "enum":[ - "initial", - "healthy", - "unhealthy", - "unused", - "draining", - "unavailable" - ] - }, - "TargetId":{"type":"string"}, - "TargetTypeEnum":{ - "type":"string", - "enum":[ - "instance", - "ip" - ] - }, - "TooManyActionsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of actions per rule.

", - "error":{ - "code":"TooManyActions", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyCertificatesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of certificates per load balancer.

", - "error":{ - "code":"TooManyCertificates", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyListenersException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of listeners per load balancer.

", - "error":{ - "code":"TooManyListeners", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyLoadBalancersException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of load balancers for your AWS account.

", - "error":{ - "code":"TooManyLoadBalancers", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyRegistrationsForTargetIdException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of times a target can be registered with a load balancer.

", - "error":{ - "code":"TooManyRegistrationsForTargetId", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyRulesException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of rules per load balancer.

", - "error":{ - "code":"TooManyRules", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyTagsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of tags per load balancer.

", - "error":{ - "code":"TooManyTags", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyTargetGroupsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of target groups for your AWS account.

", - "error":{ - "code":"TooManyTargetGroups", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TooManyTargetsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You've reached the limit on the number of targets.

", - "error":{ - "code":"TooManyTargets", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnsupportedProtocolException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified protocol is not supported.

", - "error":{ - "code":"UnsupportedProtocol", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "VpcId":{"type":"string"}, - "ZoneName":{"type":"string"} - }, - "documentation":"Elastic Load Balancing

A load balancer distributes incoming traffic across targets, such as your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered targets and ensures that it routes traffic only to healthy targets. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer. You configure a target group with a protocol and port number for connections from the load balancer to the targets, and with health check settings to be used when checking the health status of the targets.

Elastic Load Balancing supports the following types of load balancers: Application Load Balancers, Network Load Balancers, and Classic Load Balancers.

An Application Load Balancer makes routing and load balancing decisions at the application layer (HTTP/HTTPS). A Network Load Balancer makes routing and load balancing decisions at the transport layer (TCP). Both Application Load Balancers and Network Load Balancers can route requests to one or more ports on each EC2 instance or container instance in your virtual private cloud (VPC).

A Classic Load Balancer makes routing and load balancing decisions either at the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. For more information, see the Elastic Load Balancing User Guide.

This reference covers the 2015-12-01 API, which supports Application Load Balancers and Network Load Balancers. The 2012-06-01 API supports Classic Load Balancers.

To get started, complete the following tasks:

  1. Create a load balancer using CreateLoadBalancer.

  2. Create a target group using CreateTargetGroup.

  3. Register targets for the target group using RegisterTargets.

  4. Create one or more listeners for your load balancer using CreateListener.

To delete a load balancer and its related resources, complete the following tasks:

  1. Delete the load balancer using DeleteLoadBalancer.

  2. Delete the target group using DeleteTargetGroup.

All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/waiters-2.json deleted file mode 100644 index 9f3d77d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/elbv2/2015-12-01/waiters-2.json +++ /dev/null @@ -1,100 +0,0 @@ -{ - "version": 2, - "waiters": { - "LoadBalancerExists": { - "delay": 15, - "operation": "DescribeLoadBalancers", - "maxAttempts": 40, - "acceptors": [ - { - "matcher": "status", - "expected": 200, - "state": "success" - }, - { - "matcher": "error", - "expected": "LoadBalancerNotFound", - "state": "retry" - } - ] - }, - "LoadBalancerAvailable": { - "delay": 15, - "operation": "DescribeLoadBalancers", - "maxAttempts": 40, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "LoadBalancers[].State.Code", - "expected": "active" - }, - { - "state": "retry", - "matcher": "pathAny", - "argument": "LoadBalancers[].State.Code", - "expected": "provisioning" - }, - { - "state": "retry", - "matcher": "error", - "expected": "LoadBalancerNotFound" - } - ] - }, - "LoadBalancersDeleted": { - "delay": 15, - "operation": "DescribeLoadBalancers", - "maxAttempts": 40, - "acceptors": [ - { - "state": "retry", - "matcher": "pathAll", - "argument": "LoadBalancers[].State.Code", - "expected": "active" - }, - { - "matcher": "error", - "expected": "LoadBalancerNotFound", - "state": "success" - } - ] - }, - "TargetInService":{ - "delay":15, - "maxAttempts":40, - "operation":"DescribeTargetHealth", - "acceptors":[ - { - "argument":"TargetHealthDescriptions[].TargetHealth.State", - "expected":"healthy", - "matcher":"pathAll", - "state":"success" - }, - { - "matcher": "error", - "expected": "InvalidInstance", - "state": "retry" - } - ] - }, - "TargetDeregistered": { - "delay": 15, - "maxAttempts": 40, - "operation": "DescribeTargetHealth", - "acceptors": [ - { - "matcher": "error", - "expected": "InvalidTarget", - "state": "success" - }, - { - "argument":"TargetHealthDescriptions[].TargetHealth.State", - "expected":"unused", - "matcher":"pathAll", - "state":"success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/paginators-1.json deleted file mode 100644 index 67ccf448..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/paginators-1.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "pagination": { - "ListBootstrapActions": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "BootstrapActions" - }, - "ListClusters": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "Clusters" - }, - "ListInstanceGroups": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "InstanceGroups" - }, - "ListInstances": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "Instances" - }, - "ListSteps": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "Steps" - }, - "ListInstanceFleets": { - "input_token": "Marker", - "output_token": "Marker", - "result_key": "InstanceFleets" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/service-2.json deleted file mode 100644 index 69a49569..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/service-2.json +++ /dev/null @@ -1,3571 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2009-03-31", - "endpointPrefix":"elasticmapreduce", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon EMR", - "serviceFullName":"Amazon Elastic MapReduce", - "serviceId":"EMR", - "signatureVersion":"v4", - "targetPrefix":"ElasticMapReduce", - "timestampFormat":"unixTimestamp", - "uid":"elasticmapreduce-2009-03-31" - }, - "operations":{ - "AddInstanceFleet":{ - "name":"AddInstanceFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddInstanceFleetInput"}, - "output":{"shape":"AddInstanceFleetOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Adds an instance fleet to a running cluster.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x.

" - }, - "AddInstanceGroups":{ - "name":"AddInstanceGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddInstanceGroupsInput"}, - "output":{"shape":"AddInstanceGroupsOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Adds one or more instance groups to a running cluster.

" - }, - "AddJobFlowSteps":{ - "name":"AddJobFlowSteps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddJobFlowStepsInput"}, - "output":{"shape":"AddJobFlowStepsOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

AddJobFlowSteps adds new steps to a running cluster. A maximum of 256 steps are allowed in each job flow.

If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps to process your data. You can bypass the 256-step limitation in various ways, including using SSH to connect to the master node and submitting queries directly to the software running on the master node, such as Hive and Hadoop. For more information on how to do this, see Add More than 256 Steps to a Cluster in the Amazon EMR Management Guide.

A step specifies the location of a JAR file stored either on the master node of the cluster or in Amazon S3. Each step is performed by the main function of the main class of the JAR file. The main class can be specified either in the manifest of the JAR or by using the MainFunction parameter of the step.

Amazon EMR executes each step in the order listed. For a step to be considered complete, the main function must exit with a zero exit code and all Hadoop jobs started while the step was running must have completed and run successfully.

You can only add steps to a cluster that is in one of the following states: STARTING, BOOTSTRAPPING, RUNNING, or WAITING.

" - }, - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsInput"}, - "output":{"shape":"AddTagsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Adds tags to an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more information, see Tag Clusters.

" - }, - "CancelSteps":{ - "name":"CancelSteps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelStepsInput"}, - "output":{"shape":"CancelStepsOutput"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is idempotent but asynchronous; it does not guarantee a step will be canceled, even if the request is successfully submitted. You can only cancel steps that are in a PENDING state.

" - }, - "CreateSecurityConfiguration":{ - "name":"CreateSecurityConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecurityConfigurationInput"}, - "output":{"shape":"CreateSecurityConfigurationOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Creates a security configuration, which is stored in the service and can be specified when a cluster is created.

" - }, - "DeleteSecurityConfiguration":{ - "name":"DeleteSecurityConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecurityConfigurationInput"}, - "output":{"shape":"DeleteSecurityConfigurationOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Deletes a security configuration.

" - }, - "DescribeCluster":{ - "name":"DescribeCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterInput"}, - "output":{"shape":"DescribeClusterOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides cluster-level details including status, hardware and software configuration, VPC settings, and so on.

" - }, - "DescribeJobFlows":{ - "name":"DescribeJobFlows", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeJobFlowsInput"}, - "output":{"shape":"DescribeJobFlowsOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

This API is deprecated and will eventually be removed. We recommend you use ListClusters, DescribeCluster, ListSteps, ListInstanceGroups and ListBootstrapActions instead.

DescribeJobFlows returns a list of job flows that match all of the supplied parameters. The parameters can include a list of job flow IDs, job flow states, and restrictions on job flow creation date and time.

Regardless of supplied parameters, only job flows created within the last two months are returned.

If no parameters are supplied, then job flows matching either of the following criteria are returned:

  • Job flows created and completed in the last two weeks

  • Job flows created within the last two months that are in one of the following states: RUNNING, WAITING, SHUTTING_DOWN, STARTING

Amazon EMR can return a maximum of 512 job flow descriptions.

", - "deprecated":true - }, - "DescribeSecurityConfiguration":{ - "name":"DescribeSecurityConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecurityConfigurationInput"}, - "output":{"shape":"DescribeSecurityConfigurationOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides the details of a security configuration by returning the configuration JSON.

" - }, - "DescribeStep":{ - "name":"DescribeStep", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStepInput"}, - "output":{"shape":"DescribeStepOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides more detail about the cluster step.

" - }, - "ListBootstrapActions":{ - "name":"ListBootstrapActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBootstrapActionsInput"}, - "output":{"shape":"ListBootstrapActionsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides information about the bootstrap actions associated with a cluster.

" - }, - "ListClusters":{ - "name":"ListClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListClustersInput"}, - "output":{"shape":"ListClustersOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides the status of all clusters visible to this AWS account. Allows you to filter the list of clusters based on certain criteria; for example, filtering by cluster creation date and time or by status. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListClusters calls.

" - }, - "ListInstanceFleets":{ - "name":"ListInstanceFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstanceFleetsInput"}, - "output":{"shape":"ListInstanceFleetsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Lists all available details about the instance fleets in a cluster.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "ListInstanceGroups":{ - "name":"ListInstanceGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstanceGroupsInput"}, - "output":{"shape":"ListInstanceGroupsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides all available details about the instance groups in a cluster.

" - }, - "ListInstances":{ - "name":"ListInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstancesInput"}, - "output":{"shape":"ListInstancesOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides information for all active EC2 instances and EC2 instances terminated in the last 30 days, up to a maximum of 2,000. EC2 instances in any of the following states are considered active: AWAITING_FULFILLMENT, PROVISIONING, BOOTSTRAPPING, RUNNING.

" - }, - "ListSecurityConfigurations":{ - "name":"ListSecurityConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSecurityConfigurationsInput"}, - "output":{"shape":"ListSecurityConfigurationsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Lists all the security configurations visible to this account, providing their creation dates and times, and their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListSecurityConfigurations calls.

" - }, - "ListSteps":{ - "name":"ListSteps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStepsInput"}, - "output":{"shape":"ListStepsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Provides a list of steps for the cluster in reverse order unless you specify stepIds with the request.

" - }, - "ModifyInstanceFleet":{ - "name":"ModifyInstanceFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceFleetInput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "ModifyInstanceGroups":{ - "name":"ModifyInstanceGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyInstanceGroupsInput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

ModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input parameters include the new target instance count for the group and the instance group ID. The call will either succeed or fail atomically.

" - }, - "PutAutoScalingPolicy":{ - "name":"PutAutoScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutAutoScalingPolicyInput"}, - "output":{"shape":"PutAutoScalingPolicyOutput"}, - "documentation":"

Creates or updates an automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric.

" - }, - "RemoveAutoScalingPolicy":{ - "name":"RemoveAutoScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveAutoScalingPolicyInput"}, - "output":{"shape":"RemoveAutoScalingPolicyOutput"}, - "documentation":"

Removes an automatic scaling policy from a specified instance group within an EMR cluster.

" - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsInput"}, - "output":{"shape":"RemoveTagsOutput"}, - "errors":[ - {"shape":"InternalServerException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Removes tags from an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more information, see Tag Clusters.

The following example removes the stack tag with value Prod from a cluster:

" - }, - "RunJobFlow":{ - "name":"RunJobFlow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunJobFlowInput"}, - "output":{"shape":"RunJobFlowOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

RunJobFlow creates and starts running a new cluster (job flow). The cluster runs the steps specified. After the steps complete, the cluster stops and the HDFS partition is lost. To prevent loss of data, configure the last step of the job flow to store results in Amazon S3. If the JobFlowInstancesConfig KeepJobFlowAliveWhenNoSteps parameter is set to TRUE, the cluster transitions to the WAITING state rather than shutting down after the steps have completed.

For additional protection, you can set the JobFlowInstancesConfig TerminationProtected parameter to TRUE to lock the cluster and prevent it from being terminated by API call, user intervention, or in the event of a job flow error.

A maximum of 256 steps are allowed in each job flow.

If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps to process your data. You can bypass the 256-step limitation in various ways, including using the SSH shell to connect to the master node and submitting queries directly to the software running on the master node, such as Hive and Hadoop. For more information on how to do this, see Add More than 256 Steps to a Cluster in the Amazon EMR Management Guide.

For long running clusters, we recommend that you periodically store your results.

The instance fleets configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions. The RunJobFlow request can contain InstanceFleets parameters or InstanceGroups parameters, but not both.

" - }, - "SetTerminationProtection":{ - "name":"SetTerminationProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetTerminationProtectionInput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

SetTerminationProtection locks a cluster (job flow) so the EC2 instances in the cluster cannot be terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates upon successful completion of the job flow. Calling SetTerminationProtection on a cluster is similar to calling the Amazon EC2 DisableAPITermination API on all EC2 instances in a cluster.

SetTerminationProtection is used to prevent accidental termination of a cluster and to ensure that in the event of an error, the instances persist so that you can recover any data stored in their ephemeral instance storage.

To terminate a cluster that has been locked by setting SetTerminationProtection to true, you must first unlock the job flow by a subsequent call to SetTerminationProtection in which you set the value to false.

For more information, seeManaging Cluster Termination in the Amazon EMR Management Guide.

" - }, - "SetVisibleToAllUsers":{ - "name":"SetVisibleToAllUsers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetVisibleToAllUsersInput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Sets whether all AWS Identity and Access Management (IAM) users under your account can access the specified clusters (job flows). This action works on running clusters. You can also set the visibility of a cluster when you launch it using the VisibleToAllUsers parameter of RunJobFlow. The SetVisibleToAllUsers action can be called only by an IAM user who created the cluster or the AWS account that owns the cluster.

" - }, - "TerminateJobFlows":{ - "name":"TerminateJobFlows", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateJobFlowsInput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

TerminateJobFlows shuts a list of clusters (job flows) down. When a job flow is shut down, any step not yet completed is canceled and the EC2 instances on which the cluster is running are stopped. Any log files not already saved are uploaded to Amazon S3 if a LogUri was specified when the cluster was created.

The maximum number of clusters allowed is 10. The call to TerminateJobFlows is asynchronous. Depending on the configuration of the cluster, it may take up to 1-5 minutes for the cluster to completely terminate and release allocated resources, such as Amazon EC2 instances.

" - } - }, - "shapes":{ - "ActionOnFailure":{ - "type":"string", - "enum":[ - "TERMINATE_JOB_FLOW", - "TERMINATE_CLUSTER", - "CANCEL_AND_WAIT", - "CONTINUE" - ] - }, - "AddInstanceFleetInput":{ - "type":"structure", - "required":[ - "ClusterId", - "InstanceFleet" - ], - "members":{ - "ClusterId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The unique identifier of the cluster.

" - }, - "InstanceFleet":{ - "shape":"InstanceFleetConfig", - "documentation":"

Specifies the configuration of the instance fleet.

" - } - } - }, - "AddInstanceFleetOutput":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The unique identifier of the cluster.

" - }, - "InstanceFleetId":{ - "shape":"InstanceFleetId", - "documentation":"

The unique identifier of the instance fleet.

" - } - } - }, - "AddInstanceGroupsInput":{ - "type":"structure", - "required":[ - "InstanceGroups", - "JobFlowId" - ], - "members":{ - "InstanceGroups":{ - "shape":"InstanceGroupConfigList", - "documentation":"

Instance groups to add.

" - }, - "JobFlowId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Job flow in which to add the instance groups.

" - } - }, - "documentation":"

Input to an AddInstanceGroups call.

" - }, - "AddInstanceGroupsOutput":{ - "type":"structure", - "members":{ - "JobFlowId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The job flow ID in which the instance groups are added.

" - }, - "InstanceGroupIds":{ - "shape":"InstanceGroupIdsList", - "documentation":"

Instance group IDs of the newly created instance groups.

" - } - }, - "documentation":"

Output from an AddInstanceGroups call.

" - }, - "AddJobFlowStepsInput":{ - "type":"structure", - "required":[ - "JobFlowId", - "Steps" - ], - "members":{ - "JobFlowId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

A string that uniquely identifies the job flow. This identifier is returned by RunJobFlow and can also be obtained from ListClusters.

" - }, - "Steps":{ - "shape":"StepConfigList", - "documentation":"

A list of StepConfig to be executed by the job flow.

" - } - }, - "documentation":"

The input argument to the AddJobFlowSteps operation.

" - }, - "AddJobFlowStepsOutput":{ - "type":"structure", - "members":{ - "StepIds":{ - "shape":"StepIdsList", - "documentation":"

The identifiers of the list of steps added to the job flow.

" - } - }, - "documentation":"

The output for the AddJobFlowSteps operation.

" - }, - "AddTagsInput":{ - "type":"structure", - "required":[ - "ResourceId", - "Tags" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The Amazon EMR resource identifier to which tags will be added. This value must be a cluster identifier.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags to associate with a cluster and propagate to EC2 instances. Tags are user-defined key/value pairs that consist of a required key string with a maximum of 128 characters, and an optional value string with a maximum of 256 characters.

" - } - }, - "documentation":"

This input identifies a cluster and a list of tags to attach.

" - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

This output indicates the result of adding tags to a resource.

" - }, - "AdjustmentType":{ - "type":"string", - "enum":[ - "CHANGE_IN_CAPACITY", - "PERCENT_CHANGE_IN_CAPACITY", - "EXACT_CAPACITY" - ] - }, - "Application":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the application.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version of the application.

" - }, - "Args":{ - "shape":"StringList", - "documentation":"

Arguments for Amazon EMR to pass to the application.

" - }, - "AdditionalInfo":{ - "shape":"StringMap", - "documentation":"

This option is for advanced users only. This is meta information about third-party applications that third-party vendors use for testing purposes.

" - } - }, - "documentation":"

An application is any Amazon or third-party software that you can add to the cluster. This structure contains a list of strings that indicates the software to use with the cluster and accepts a user argument list. Amazon EMR accepts and forwards the argument list to the corresponding installation script as bootstrap action argument. For more information, see Using the MapR Distribution for Hadoop. Currently supported values are:

  • \"mapr-m3\" - launch the cluster using MapR M3 Edition.

  • \"mapr-m5\" - launch the cluster using MapR M5 Edition.

  • \"mapr\" with the user arguments specifying \"--edition,m3\" or \"--edition,m5\" - launch the cluster using MapR M3 or M5 Edition, respectively.

In Amazon EMR releases 4.x and later, the only accepted parameter is the application name. To pass arguments to applications, you supply a configuration for each application.

" - }, - "ApplicationList":{ - "type":"list", - "member":{"shape":"Application"} - }, - "AutoScalingPolicy":{ - "type":"structure", - "required":[ - "Constraints", - "Rules" - ], - "members":{ - "Constraints":{ - "shape":"ScalingConstraints", - "documentation":"

The upper and lower EC2 instance limits for an automatic scaling policy. Automatic scaling activity will not cause an instance group to grow above or below these limits.

" - }, - "Rules":{ - "shape":"ScalingRuleList", - "documentation":"

The scale-in and scale-out rules that comprise the automatic scaling policy.

" - } - }, - "documentation":"

An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. An automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. See PutAutoScalingPolicy.

" - }, - "AutoScalingPolicyDescription":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"AutoScalingPolicyStatus", - "documentation":"

The status of an automatic scaling policy.

" - }, - "Constraints":{ - "shape":"ScalingConstraints", - "documentation":"

The upper and lower EC2 instance limits for an automatic scaling policy. Automatic scaling activity will not cause an instance group to grow above or below these limits.

" - }, - "Rules":{ - "shape":"ScalingRuleList", - "documentation":"

The scale-in and scale-out rules that comprise the automatic scaling policy.

" - } - }, - "documentation":"

An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. See PutAutoScalingPolicy.

" - }, - "AutoScalingPolicyState":{ - "type":"string", - "enum":[ - "PENDING", - "ATTACHING", - "ATTACHED", - "DETACHING", - "DETACHED", - "FAILED" - ] - }, - "AutoScalingPolicyStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"AutoScalingPolicyStateChangeReasonCode", - "documentation":"

The code indicating the reason for the change in status.USER_REQUEST indicates that the scaling policy status was changed by a user. PROVISION_FAILURE indicates that the status change was because the policy failed to provision. CLEANUP_FAILURE indicates an error.

" - }, - "Message":{ - "shape":"String", - "documentation":"

A friendly, more verbose message that accompanies an automatic scaling policy state change.

" - } - }, - "documentation":"

The reason for an AutoScalingPolicyStatus change.

" - }, - "AutoScalingPolicyStateChangeReasonCode":{ - "type":"string", - "enum":[ - "USER_REQUEST", - "PROVISION_FAILURE", - "CLEANUP_FAILURE" - ] - }, - "AutoScalingPolicyStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"AutoScalingPolicyState", - "documentation":"

Indicates the status of the automatic scaling policy.

" - }, - "StateChangeReason":{ - "shape":"AutoScalingPolicyStateChangeReason", - "documentation":"

The reason for a change in status.

" - } - }, - "documentation":"

The status of an automatic scaling policy.

" - }, - "Boolean":{"type":"boolean"}, - "BooleanObject":{"type":"boolean"}, - "BootstrapActionConfig":{ - "type":"structure", - "required":[ - "Name", - "ScriptBootstrapAction" - ], - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the bootstrap action.

" - }, - "ScriptBootstrapAction":{ - "shape":"ScriptBootstrapActionConfig", - "documentation":"

The script run by the bootstrap action.

" - } - }, - "documentation":"

Configuration of a bootstrap action.

" - }, - "BootstrapActionConfigList":{ - "type":"list", - "member":{"shape":"BootstrapActionConfig"} - }, - "BootstrapActionDetail":{ - "type":"structure", - "members":{ - "BootstrapActionConfig":{ - "shape":"BootstrapActionConfig", - "documentation":"

A description of the bootstrap action.

" - } - }, - "documentation":"

Reports the configuration of a bootstrap action in a cluster (job flow).

" - }, - "BootstrapActionDetailList":{ - "type":"list", - "member":{"shape":"BootstrapActionDetail"} - }, - "CancelStepsInfo":{ - "type":"structure", - "members":{ - "StepId":{ - "shape":"StepId", - "documentation":"

The encrypted StepId of a step.

" - }, - "Status":{ - "shape":"CancelStepsRequestStatus", - "documentation":"

The status of a CancelSteps Request. The value may be SUBMITTED or FAILED.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

The reason for the failure if the CancelSteps request fails.

" - } - }, - "documentation":"

Specification of the status of a CancelSteps request. Available only in Amazon EMR version 4.8.0 and later, excluding version 5.0.0.

" - }, - "CancelStepsInfoList":{ - "type":"list", - "member":{"shape":"CancelStepsInfo"} - }, - "CancelStepsInput":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The ClusterID for which specified steps will be canceled. Use RunJobFlow and ListClusters to get ClusterIDs.

" - }, - "StepIds":{ - "shape":"StepIdsList", - "documentation":"

The list of StepIDs to cancel. Use ListSteps to get steps and their states for the specified cluster.

" - } - }, - "documentation":"

The input argument to the CancelSteps operation.

" - }, - "CancelStepsOutput":{ - "type":"structure", - "members":{ - "CancelStepsInfoList":{ - "shape":"CancelStepsInfoList", - "documentation":"

A list of CancelStepsInfo, which shows the status of specified cancel requests for each StepID specified.

" - } - }, - "documentation":"

The output for the CancelSteps operation.

" - }, - "CancelStepsRequestStatus":{ - "type":"string", - "enum":[ - "SUBMITTED", - "FAILED" - ] - }, - "CloudWatchAlarmDefinition":{ - "type":"structure", - "required":[ - "ComparisonOperator", - "MetricName", - "Period", - "Threshold" - ], - "members":{ - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

Determines how the metric specified by MetricName is compared to the value specified by Threshold.

" - }, - "EvaluationPeriods":{ - "shape":"Integer", - "documentation":"

The number of periods, expressed in seconds using Period, during which the alarm condition must exist before the alarm triggers automatic scaling activity. The default value is 1.

" - }, - "MetricName":{ - "shape":"String", - "documentation":"

The name of the CloudWatch metric that is watched to determine an alarm condition.

" - }, - "Namespace":{ - "shape":"String", - "documentation":"

The namespace for the CloudWatch metric. The default is AWS/ElasticMapReduce.

" - }, - "Period":{ - "shape":"Integer", - "documentation":"

The period, in seconds, over which the statistic is applied. EMR CloudWatch metrics are emitted every five minutes (300 seconds), so if an EMR CloudWatch metric is specified, specify 300.

" - }, - "Statistic":{ - "shape":"Statistic", - "documentation":"

The statistic to apply to the metric associated with the alarm. The default is AVERAGE.

" - }, - "Threshold":{ - "shape":"NonNegativeDouble", - "documentation":"

The value against which the specified statistic is compared.

" - }, - "Unit":{ - "shape":"Unit", - "documentation":"

The unit of measure associated with the CloudWatch metric being watched. The value specified for Unit must correspond to the units specified in the CloudWatch metric.

" - }, - "Dimensions":{ - "shape":"MetricDimensionList", - "documentation":"

A CloudWatch metric dimension.

" - } - }, - "documentation":"

The definition of a CloudWatch metric alarm, which determines when an automatic scaling activity is triggered. When the defined alarm conditions are satisfied, scaling activity begins.

" - }, - "Cluster":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ClusterId", - "documentation":"

The unique identifier for the cluster.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the cluster.

" - }, - "Status":{ - "shape":"ClusterStatus", - "documentation":"

The current status details about the cluster.

" - }, - "Ec2InstanceAttributes":{ - "shape":"Ec2InstanceAttributes", - "documentation":"

Provides information about the EC2 instances in a cluster grouped by category. For example, key name, subnet ID, IAM instance profile, and so on.

" - }, - "InstanceCollectionType":{ - "shape":"InstanceCollectionType", - "documentation":"

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

The instance group configuration of the cluster. A value of INSTANCE_GROUP indicates a uniform instance group configuration. A value of INSTANCE_FLEET indicates an instance fleets configuration.

" - }, - "LogUri":{ - "shape":"String", - "documentation":"

The path to the Amazon S3 location where logs for this cluster are stored.

" - }, - "RequestedAmiVersion":{ - "shape":"String", - "documentation":"

The AMI version requested for this cluster.

" - }, - "RunningAmiVersion":{ - "shape":"String", - "documentation":"

The AMI version running on this cluster.

" - }, - "ReleaseLabel":{ - "shape":"String", - "documentation":"

The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster. Release labels are in the form emr-x.x.x, where x.x.x is an Amazon EMR release version, for example, emr-5.14.0. For more information about Amazon EMR release versions and included application versions and features, see http://docs.aws.amazon.com/emr/latest/ReleaseGuide/. The release label applies only to Amazon EMR releases versions 4.x and later. Earlier versions use AmiVersion.

" - }, - "AutoTerminate":{ - "shape":"Boolean", - "documentation":"

Specifies whether the cluster should terminate after completing all steps.

" - }, - "TerminationProtected":{ - "shape":"Boolean", - "documentation":"

Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances from being terminated by an API call or user intervention, or in the event of a cluster error.

" - }, - "VisibleToAllUsers":{ - "shape":"Boolean", - "documentation":"

Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster. If this value is set to true, all IAM users of that AWS account can view and manage the cluster if they have the proper policy permissions set. If this value is false, only the IAM user that created the cluster can view and manage it. This value can be changed using the SetVisibleToAllUsers action.

" - }, - "Applications":{ - "shape":"ApplicationList", - "documentation":"

The applications installed on this cluster.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags associated with a cluster.

" - }, - "ServiceRole":{ - "shape":"String", - "documentation":"

The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.

" - }, - "NormalizedInstanceHours":{ - "shape":"Integer", - "documentation":"

An approximation of the cost of the cluster, represented in m1.small/hours. This value is incremented one time for every hour an m1.small instance runs. Larger instances are weighted more, so an EC2 instance that is roughly four times more expensive would result in the normalized instance hours being incremented by four. This result is only an approximation and does not reflect the actual billing rate.

" - }, - "MasterPublicDnsName":{ - "shape":"String", - "documentation":"

The DNS name of the master node. If the cluster is on a private subnet, this is the private DNS name. On a public subnet, this is the public DNS name.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.

" - }, - "SecurityConfiguration":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration applied to the cluster.

" - }, - "AutoScalingRole":{ - "shape":"XmlString", - "documentation":"

An IAM role for automatic scaling policies. The default role is EMR_AutoScaling_DefaultRole. The IAM role provides permissions that the automatic scaling feature requires to launch and terminate EC2 instances in an instance group.

" - }, - "ScaleDownBehavior":{ - "shape":"ScaleDownBehavior", - "documentation":"

The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized. TERMINATE_AT_INSTANCE_HOUR indicates that Amazon EMR terminates nodes at the instance-hour boundary, regardless of when the request to terminate the instance was submitted. This option is only available with Amazon EMR 5.1.0 and later and is the default for clusters created using that version. TERMINATE_AT_TASK_COMPLETION indicates that Amazon EMR blacklists and drains tasks from nodes before terminating the Amazon EC2 instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to HDFS corruption. TERMINATE_AT_TASK_COMPLETION is available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.

" - }, - "CustomAmiId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.

" - }, - "EbsRootVolumeSize":{ - "shape":"Integer", - "documentation":"

The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance. Available in Amazon EMR version 4.x and later.

" - }, - "RepoUpgradeOnBoot":{ - "shape":"RepoUpgradeOnBoot", - "documentation":"

Applies only when CustomAmiID is used. Specifies the type of updates that are applied from the Amazon Linux AMI package repositories when an instance boots using the AMI.

" - }, - "KerberosAttributes":{ - "shape":"KerberosAttributes", - "documentation":"

Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see Use Kerberos Authentication in the EMR Management Guide.

" - } - }, - "documentation":"

The detailed description of the cluster.

" - }, - "ClusterId":{"type":"string"}, - "ClusterState":{ - "type":"string", - "enum":[ - "STARTING", - "BOOTSTRAPPING", - "RUNNING", - "WAITING", - "TERMINATING", - "TERMINATED", - "TERMINATED_WITH_ERRORS" - ] - }, - "ClusterStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"ClusterStateChangeReasonCode", - "documentation":"

The programmatic code for the state change reason.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The descriptive message for the state change reason.

" - } - }, - "documentation":"

The reason that the cluster changed to its current state.

" - }, - "ClusterStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "VALIDATION_ERROR", - "INSTANCE_FAILURE", - "INSTANCE_FLEET_TIMEOUT", - "BOOTSTRAP_FAILURE", - "USER_REQUEST", - "STEP_FAILURE", - "ALL_STEPS_COMPLETED" - ] - }, - "ClusterStateList":{ - "type":"list", - "member":{"shape":"ClusterState"} - }, - "ClusterStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ClusterState", - "documentation":"

The current state of the cluster.

" - }, - "StateChangeReason":{ - "shape":"ClusterStateChangeReason", - "documentation":"

The reason for the cluster status change.

" - }, - "Timeline":{ - "shape":"ClusterTimeline", - "documentation":"

A timeline that represents the status of a cluster over the lifetime of the cluster.

" - } - }, - "documentation":"

The detailed status of the cluster.

" - }, - "ClusterSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ClusterId", - "documentation":"

The unique identifier for the cluster.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the cluster.

" - }, - "Status":{ - "shape":"ClusterStatus", - "documentation":"

The details about the current status of the cluster.

" - }, - "NormalizedInstanceHours":{ - "shape":"Integer", - "documentation":"

An approximation of the cost of the cluster, represented in m1.small/hours. This value is incremented one time for every hour an m1.small instance runs. Larger instances are weighted more, so an EC2 instance that is roughly four times more expensive would result in the normalized instance hours being incremented by four. This result is only an approximation and does not reflect the actual billing rate.

" - } - }, - "documentation":"

The summary description of the cluster.

" - }, - "ClusterSummaryList":{ - "type":"list", - "member":{"shape":"ClusterSummary"} - }, - "ClusterTimeline":{ - "type":"structure", - "members":{ - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation date and time of the cluster.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the cluster was ready to execute steps.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the cluster was terminated.

" - } - }, - "documentation":"

Represents the timeline of the cluster's lifecycle.

" - }, - "Command":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the command.

" - }, - "ScriptPath":{ - "shape":"String", - "documentation":"

The Amazon S3 location of the command script.

" - }, - "Args":{ - "shape":"StringList", - "documentation":"

Arguments for Amazon EMR to pass to the command for execution.

" - } - }, - "documentation":"

An entity describing an executable that runs on a cluster.

" - }, - "CommandList":{ - "type":"list", - "member":{"shape":"Command"} - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "GREATER_THAN_OR_EQUAL", - "GREATER_THAN", - "LESS_THAN", - "LESS_THAN_OR_EQUAL" - ] - }, - "Configuration":{ - "type":"structure", - "members":{ - "Classification":{ - "shape":"String", - "documentation":"

The classification within a configuration.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

A list of additional configurations to apply within a configuration object.

" - }, - "Properties":{ - "shape":"StringMap", - "documentation":"

A set of properties specified within a configuration classification.

" - } - }, - "documentation":"

Amazon EMR releases 4.x or later.

An optional configuration specification to be used when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file. For more information, see Configuring Applications.

" - }, - "ConfigurationList":{ - "type":"list", - "member":{"shape":"Configuration"} - }, - "CreateSecurityConfigurationInput":{ - "type":"structure", - "required":[ - "Name", - "SecurityConfiguration" - ], - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - }, - "SecurityConfiguration":{ - "shape":"String", - "documentation":"

The security configuration details in JSON format. For JSON parameters and examples, see Use Security Configurations to Set Up Cluster Security in the Amazon EMR Management Guide.

" - } - } - }, - "CreateSecurityConfigurationOutput":{ - "type":"structure", - "required":[ - "Name", - "CreationDateTime" - ], - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time the security configuration was created.

" - } - } - }, - "Date":{"type":"timestamp"}, - "DeleteSecurityConfigurationInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - } - } - }, - "DeleteSecurityConfigurationOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeClusterInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier of the cluster to describe.

" - } - }, - "documentation":"

This input determines which cluster to describe.

" - }, - "DescribeClusterOutput":{ - "type":"structure", - "members":{ - "Cluster":{ - "shape":"Cluster", - "documentation":"

This output contains the details for the requested cluster.

" - } - }, - "documentation":"

This output contains the description of the cluster.

" - }, - "DescribeJobFlowsInput":{ - "type":"structure", - "members":{ - "CreatedAfter":{ - "shape":"Date", - "documentation":"

Return only job flows created after this date and time.

" - }, - "CreatedBefore":{ - "shape":"Date", - "documentation":"

Return only job flows created before this date and time.

" - }, - "JobFlowIds":{ - "shape":"XmlStringList", - "documentation":"

Return only job flows whose job flow ID is contained in this list.

" - }, - "JobFlowStates":{ - "shape":"JobFlowExecutionStateList", - "documentation":"

Return only job flows whose state is contained in this list.

" - } - }, - "documentation":"

The input for the DescribeJobFlows operation.

" - }, - "DescribeJobFlowsOutput":{ - "type":"structure", - "members":{ - "JobFlows":{ - "shape":"JobFlowDetailList", - "documentation":"

A list of job flows matching the parameters supplied.

" - } - }, - "documentation":"

The output for the DescribeJobFlows operation.

" - }, - "DescribeSecurityConfigurationInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - } - } - }, - "DescribeSecurityConfigurationOutput":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - }, - "SecurityConfiguration":{ - "shape":"String", - "documentation":"

The security configuration details in JSON format.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time the security configuration was created

" - } - } - }, - "DescribeStepInput":{ - "type":"structure", - "required":[ - "ClusterId", - "StepId" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier of the cluster with steps to describe.

" - }, - "StepId":{ - "shape":"StepId", - "documentation":"

The identifier of the step to describe.

" - } - }, - "documentation":"

This input determines which step to describe.

" - }, - "DescribeStepOutput":{ - "type":"structure", - "members":{ - "Step":{ - "shape":"Step", - "documentation":"

The step details for the requested step identifier.

" - } - }, - "documentation":"

This output contains the description of the cluster step.

" - }, - "EC2InstanceIdsList":{ - "type":"list", - "member":{"shape":"InstanceId"} - }, - "EC2InstanceIdsToTerminateList":{ - "type":"list", - "member":{"shape":"InstanceId"} - }, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "VolumeSpecification":{ - "shape":"VolumeSpecification", - "documentation":"

EBS volume specifications such as volume type, IOPS, and size (GiB) that will be requested for the EBS volume attached to an EC2 instance in the cluster.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name that is exposed to the instance, such as /dev/sdh.

" - } - }, - "documentation":"

Configuration of requested EBS block device associated with the instance group.

" - }, - "EbsBlockDeviceConfig":{ - "type":"structure", - "required":["VolumeSpecification"], - "members":{ - "VolumeSpecification":{ - "shape":"VolumeSpecification", - "documentation":"

EBS volume specifications such as volume type, IOPS, and size (GiB) that will be requested for the EBS volume attached to an EC2 instance in the cluster.

" - }, - "VolumesPerInstance":{ - "shape":"Integer", - "documentation":"

Number of EBS volumes with a specific volume configuration that will be associated with every instance in the instance group

" - } - }, - "documentation":"

Configuration of requested EBS block device associated with the instance group with count of volumes that will be associated to every instance.

" - }, - "EbsBlockDeviceConfigList":{ - "type":"list", - "member":{"shape":"EbsBlockDeviceConfig"} - }, - "EbsBlockDeviceList":{ - "type":"list", - "member":{"shape":"EbsBlockDevice"} - }, - "EbsConfiguration":{ - "type":"structure", - "members":{ - "EbsBlockDeviceConfigs":{ - "shape":"EbsBlockDeviceConfigList", - "documentation":"

An array of Amazon EBS volume specifications attached to a cluster instance.

" - }, - "EbsOptimized":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether an Amazon EBS volume is EBS-optimized.

" - } - }, - "documentation":"

The Amazon EBS configuration of a cluster instance.

" - }, - "EbsVolume":{ - "type":"structure", - "members":{ - "Device":{ - "shape":"String", - "documentation":"

The device name that is exposed to the instance, such as /dev/sdh.

" - }, - "VolumeId":{ - "shape":"String", - "documentation":"

The volume identifier of the EBS volume.

" - } - }, - "documentation":"

EBS block device that's attached to an EC2 instance.

" - }, - "EbsVolumeList":{ - "type":"list", - "member":{"shape":"EbsVolume"} - }, - "Ec2InstanceAttributes":{ - "type":"structure", - "members":{ - "Ec2KeyName":{ - "shape":"String", - "documentation":"

The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named \"hadoop\".

" - }, - "Ec2SubnetId":{ - "shape":"String", - "documentation":"

To launch the cluster in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value, the cluster is launched in the normal AWS cloud, outside of a VPC.

Amazon VPC currently does not support cluster compute quadruple extra large (cc1.4xlarge) instances. Thus, you cannot specify the cc1.4xlarge instance type for nodes of a cluster launched in a VPC.

" - }, - "RequestedEc2SubnetIds":{ - "shape":"XmlStringMaxLen256List", - "documentation":"

Applies to clusters configured with the instance fleets option. Specifies the unique identifier of one or more Amazon EC2 subnets in which to launch EC2 cluster instances. Subnets must exist within the same VPC. Amazon EMR chooses the EC2 subnet with the best fit from among the list of RequestedEc2SubnetIds, and then launches all cluster instances within that Subnet. If this value is not specified, and the account and region support EC2-Classic networks, the cluster launches instances in the EC2-Classic network and uses RequestedEc2AvailabilityZones instead of this setting. If EC2-Classic is not supported, and no Subnet is specified, Amazon EMR chooses the subnet for you. RequestedEc2SubnetIDs and RequestedEc2AvailabilityZones cannot be specified together.

" - }, - "Ec2AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the cluster will run.

" - }, - "RequestedEc2AvailabilityZones":{ - "shape":"XmlStringMaxLen256List", - "documentation":"

Applies to clusters configured with the instance fleets option. Specifies one or more Availability Zones in which to launch EC2 cluster instances when the EC2-Classic network configuration is supported. Amazon EMR chooses the Availability Zone with the best fit from among the list of RequestedEc2AvailabilityZones, and then launches all cluster instances within that Availability Zone. If you do not specify this value, Amazon EMR chooses the Availability Zone for you. RequestedEc2SubnetIDs and RequestedEc2AvailabilityZones cannot be specified together.

" - }, - "IamInstanceProfile":{ - "shape":"String", - "documentation":"

The IAM role that was specified when the cluster was launched. The EC2 instances of the cluster assume this role.

" - }, - "EmrManagedMasterSecurityGroup":{ - "shape":"String", - "documentation":"

The identifier of the Amazon EC2 security group for the master node.

" - }, - "EmrManagedSlaveSecurityGroup":{ - "shape":"String", - "documentation":"

The identifier of the Amazon EC2 security group for the slave nodes.

" - }, - "ServiceAccessSecurityGroup":{ - "shape":"String", - "documentation":"

The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private subnets.

" - }, - "AdditionalMasterSecurityGroups":{ - "shape":"StringList", - "documentation":"

A list of additional Amazon EC2 security group IDs for the master node.

" - }, - "AdditionalSlaveSecurityGroups":{ - "shape":"StringList", - "documentation":"

A list of additional Amazon EC2 security group IDs for the slave nodes.

" - } - }, - "documentation":"

Provides information about the EC2 instances in a cluster grouped by category. For example, key name, subnet ID, IAM instance profile, and so on.

" - }, - "ErrorCode":{ - "type":"string", - "max":256, - "min":1 - }, - "ErrorMessage":{"type":"string"}, - "FailureDetails":{ - "type":"structure", - "members":{ - "Reason":{ - "shape":"String", - "documentation":"

The reason for the step failure. In the case where the service cannot successfully determine the root cause of the failure, it returns \"Unknown Error\" as a reason.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The descriptive message including the error the EMR service has identified as the cause of step failure. This is text from an error log that describes the root cause of the failure.

" - }, - "LogFile":{ - "shape":"String", - "documentation":"

The path to the log file where the step failure root cause was originally recorded.

" - } - }, - "documentation":"

The details of the step failure. The service attempts to detect the root cause for many common failures.

" - }, - "HadoopJarStepConfig":{ - "type":"structure", - "required":["Jar"], - "members":{ - "Properties":{ - "shape":"KeyValueList", - "documentation":"

A list of Java properties that are set when the step runs. You can use these properties to pass key value pairs to your main function.

" - }, - "Jar":{ - "shape":"XmlString", - "documentation":"

A path to a JAR file run during the step.

" - }, - "MainClass":{ - "shape":"XmlString", - "documentation":"

The name of the main class in the specified Java file. If not specified, the JAR file should specify a Main-Class in its manifest file.

" - }, - "Args":{ - "shape":"XmlStringList", - "documentation":"

A list of command line arguments passed to the JAR file's main function when executed.

" - } - }, - "documentation":"

A job flow step consisting of a JAR file whose main function will be executed. The main function submits a job for Hadoop to execute and waits for the job to finish or fail.

" - }, - "HadoopStepConfig":{ - "type":"structure", - "members":{ - "Jar":{ - "shape":"String", - "documentation":"

The path to the JAR file that runs during the step.

" - }, - "Properties":{ - "shape":"StringMap", - "documentation":"

The list of Java properties that are set when the step runs. You can use these properties to pass key value pairs to your main function.

" - }, - "MainClass":{ - "shape":"String", - "documentation":"

The name of the main class in the specified Java file. If not specified, the JAR file should specify a main class in its manifest file.

" - }, - "Args":{ - "shape":"StringList", - "documentation":"

The list of command line arguments to pass to the JAR file's main function for execution.

" - } - }, - "documentation":"

A cluster step consisting of a JAR file whose main function will be executed. The main function submits a job for Hadoop to execute and waits for the job to finish or fail.

" - }, - "Instance":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"InstanceId", - "documentation":"

The unique identifier for the instance in Amazon EMR.

" - }, - "Ec2InstanceId":{ - "shape":"InstanceId", - "documentation":"

The unique identifier of the instance in Amazon EC2.

" - }, - "PublicDnsName":{ - "shape":"String", - "documentation":"

The public DNS name of the instance.

" - }, - "PublicIpAddress":{ - "shape":"String", - "documentation":"

The public IP address of the instance.

" - }, - "PrivateDnsName":{ - "shape":"String", - "documentation":"

The private DNS name of the instance.

" - }, - "PrivateIpAddress":{ - "shape":"String", - "documentation":"

The private IP address of the instance.

" - }, - "Status":{ - "shape":"InstanceStatus", - "documentation":"

The current status of the instance.

" - }, - "InstanceGroupId":{ - "shape":"String", - "documentation":"

The identifier of the instance group to which this instance belongs.

" - }, - "InstanceFleetId":{ - "shape":"InstanceFleetId", - "documentation":"

The unique identifier of the instance fleet to which an EC2 instance belongs.

" - }, - "Market":{ - "shape":"MarketType", - "documentation":"

The instance purchasing option. Valid values are ON_DEMAND or SPOT.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type, for example m3.xlarge.

" - }, - "EbsVolumes":{ - "shape":"EbsVolumeList", - "documentation":"

The list of EBS volumes that are attached to this instance.

" - } - }, - "documentation":"

Represents an EC2 instance provisioned as part of cluster.

" - }, - "InstanceCollectionType":{ - "type":"string", - "enum":[ - "INSTANCE_FLEET", - "INSTANCE_GROUP" - ] - }, - "InstanceFleet":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"InstanceFleetId", - "documentation":"

The unique identifier of the instance fleet.

" - }, - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

A friendly name for the instance fleet.

" - }, - "Status":{ - "shape":"InstanceFleetStatus", - "documentation":"

The current status of the instance fleet.

" - }, - "InstanceFleetType":{ - "shape":"InstanceFleetType", - "documentation":"

The node type that the instance fleet hosts. Valid values are MASTER, CORE, or TASK.

" - }, - "TargetOnDemandCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When an On-Demand instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a WeightedCapacity of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. You can use InstanceFleet$ProvisionedOnDemandCapacity to determine the Spot capacity units that have been provisioned for the instance fleet.

If not specified or set to 0, only Spot instances are provisioned for the instance fleet using TargetSpotCapacity. At least one of TargetSpotCapacity and TargetOnDemandCapacity should be greater than 0. For a master instance fleet, only one of TargetSpotCapacity and TargetOnDemandCapacity can be specified, and its value must be 1.

" - }, - "TargetSpotCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When a Spot instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a WeightedCapacity of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. You can use InstanceFleet$ProvisionedSpotCapacity to determine the Spot capacity units that have been provisioned for the instance fleet.

If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of TargetSpotCapacity and TargetOnDemandCapacity should be greater than 0. For a master instance fleet, only one of TargetSpotCapacity and TargetOnDemandCapacity can be specified, and its value must be 1.

" - }, - "ProvisionedOnDemandCapacity":{ - "shape":"WholeNumber", - "documentation":"

The number of On-Demand units that have been provisioned for the instance fleet to fulfill TargetOnDemandCapacity. This provisioned capacity might be less than or greater than TargetOnDemandCapacity.

" - }, - "ProvisionedSpotCapacity":{ - "shape":"WholeNumber", - "documentation":"

The number of Spot units that have been provisioned for this instance fleet to fulfill TargetSpotCapacity. This provisioned capacity might be less than or greater than TargetSpotCapacity.

" - }, - "InstanceTypeSpecifications":{ - "shape":"InstanceTypeSpecificationList", - "documentation":"

The specification for the instance types that comprise an instance fleet. Up to five unique instance specifications may be defined for each instance fleet.

" - }, - "LaunchSpecifications":{ - "shape":"InstanceFleetProvisioningSpecifications", - "documentation":"

Describes the launch specification for an instance fleet.

" - } - }, - "documentation":"

Describes an instance fleet, which is a group of EC2 instances that host a particular node type (master, core, or task) in an Amazon EMR cluster. Instance fleets can consist of a mix of instance types and On-Demand and Spot instances, which are provisioned to meet a defined target capacity.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetConfig":{ - "type":"structure", - "required":["InstanceFleetType"], - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The friendly name of the instance fleet.

" - }, - "InstanceFleetType":{ - "shape":"InstanceFleetType", - "documentation":"

The node type that the instance fleet hosts. Valid values are MASTER,CORE,and TASK.

" - }, - "TargetOnDemandCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When an On-Demand instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a WeightedCapacity of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.

If not specified or set to 0, only Spot instances are provisioned for the instance fleet using TargetSpotCapacity. At least one of TargetSpotCapacity and TargetOnDemandCapacity should be greater than 0. For a master instance fleet, only one of TargetSpotCapacity and TargetOnDemandCapacity can be specified, and its value must be 1.

" - }, - "TargetSpotCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When a Spot instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a WeightedCapacity of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.

If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of TargetSpotCapacity and TargetOnDemandCapacity should be greater than 0. For a master instance fleet, only one of TargetSpotCapacity and TargetOnDemandCapacity can be specified, and its value must be 1.

" - }, - "InstanceTypeConfigs":{ - "shape":"InstanceTypeConfigList", - "documentation":"

The instance type configurations that define the EC2 instances in the instance fleet.

" - }, - "LaunchSpecifications":{ - "shape":"InstanceFleetProvisioningSpecifications", - "documentation":"

The launch specification for the instance fleet.

" - } - }, - "documentation":"

The configuration that defines an instance fleet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetConfigList":{ - "type":"list", - "member":{"shape":"InstanceFleetConfig"} - }, - "InstanceFleetId":{"type":"string"}, - "InstanceFleetList":{ - "type":"list", - "member":{"shape":"InstanceFleet"} - }, - "InstanceFleetModifyConfig":{ - "type":"structure", - "required":["InstanceFleetId"], - "members":{ - "InstanceFleetId":{ - "shape":"InstanceFleetId", - "documentation":"

A unique identifier for the instance fleet.

" - }, - "TargetOnDemandCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of On-Demand units for the instance fleet. For more information see InstanceFleetConfig$TargetOnDemandCapacity.

" - }, - "TargetSpotCapacity":{ - "shape":"WholeNumber", - "documentation":"

The target capacity of Spot units for the instance fleet. For more information, see InstanceFleetConfig$TargetSpotCapacity.

" - } - }, - "documentation":"

Configuration parameters for an instance fleet modification request.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetProvisioningSpecifications":{ - "type":"structure", - "required":["SpotSpecification"], - "members":{ - "SpotSpecification":{ - "shape":"SpotProvisioningSpecification", - "documentation":"

The launch specification for Spot instances in the fleet, which determines the defined duration and provisioning timeout behavior.

" - } - }, - "documentation":"

The launch specification for Spot instances in the fleet, which determines the defined duration and provisioning timeout behavior.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetState":{ - "type":"string", - "enum":[ - "PROVISIONING", - "BOOTSTRAPPING", - "RUNNING", - "RESIZING", - "SUSPENDED", - "TERMINATING", - "TERMINATED" - ] - }, - "InstanceFleetStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"InstanceFleetStateChangeReasonCode", - "documentation":"

A code corresponding to the reason the state change occurred.

" - }, - "Message":{ - "shape":"String", - "documentation":"

An explanatory message.

" - } - }, - "documentation":"

Provides status change reason details for the instance fleet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "VALIDATION_ERROR", - "INSTANCE_FAILURE", - "CLUSTER_TERMINATED" - ] - }, - "InstanceFleetStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"InstanceFleetState", - "documentation":"

A code representing the instance fleet status.

  • PROVISIONING—The instance fleet is provisioning EC2 resources and is not yet ready to run jobs.

  • BOOTSTRAPPING—EC2 instances and other resources have been provisioned and the bootstrap actions specified for the instances are underway.

  • RUNNING—EC2 instances and other resources are running. They are either executing jobs or waiting to execute jobs.

  • RESIZING—A resize operation is underway. EC2 instances are either being added or removed.

  • SUSPENDED—A resize operation could not complete. Existing EC2 instances are running, but instances can't be added or removed.

  • TERMINATING—The instance fleet is terminating EC2 instances.

  • TERMINATED—The instance fleet is no longer active, and all EC2 instances have been terminated.

" - }, - "StateChangeReason":{ - "shape":"InstanceFleetStateChangeReason", - "documentation":"

Provides status change reason details for the instance fleet.

" - }, - "Timeline":{ - "shape":"InstanceFleetTimeline", - "documentation":"

Provides historical timestamps for the instance fleet, including the time of creation, the time it became ready to run jobs, and the time of termination.

" - } - }, - "documentation":"

The status of the instance fleet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetTimeline":{ - "type":"structure", - "members":{ - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The time and date the instance fleet was created.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The time and date the instance fleet was ready to run jobs.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The time and date the instance fleet terminated.

" - } - }, - "documentation":"

Provides historical timestamps for the instance fleet, including the time of creation, the time it became ready to run jobs, and the time of termination.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceFleetType":{ - "type":"string", - "enum":[ - "MASTER", - "CORE", - "TASK" - ] - }, - "InstanceGroup":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"InstanceGroupId", - "documentation":"

The identifier of the instance group.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the instance group.

" - }, - "Market":{ - "shape":"MarketType", - "documentation":"

The marketplace to provision instances for this group. Valid values are ON_DEMAND or SPOT.

" - }, - "InstanceGroupType":{ - "shape":"InstanceGroupType", - "documentation":"

The type of the instance group. Valid values are MASTER, CORE or TASK.

" - }, - "BidPrice":{ - "shape":"String", - "documentation":"

The maximum Spot price your are willing to pay for EC2 instances.

An optional, nullable field that applies if the MarketType for the instance group is specified as SPOT. Specify the maximum spot price in USD. If the value is NULL and SPOT is specified, the maximum Spot price is set equal to the On-Demand price.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type for all instances in the instance group.

" - }, - "RequestedInstanceCount":{ - "shape":"Integer", - "documentation":"

The target number of instances for the instance group.

" - }, - "RunningInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances currently running in this instance group.

" - }, - "Status":{ - "shape":"InstanceGroupStatus", - "documentation":"

The current status of the instance group.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

Amazon EMR releases 4.x or later.

The list of configurations supplied for an EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).

" - }, - "EbsBlockDevices":{ - "shape":"EbsBlockDeviceList", - "documentation":"

The EBS block devices that are mapped to this instance group.

" - }, - "EbsOptimized":{ - "shape":"BooleanObject", - "documentation":"

If the instance group is EBS-optimized. An Amazon EBS-optimized instance uses an optimized configuration stack and provides additional, dedicated capacity for Amazon EBS I/O.

" - }, - "ShrinkPolicy":{ - "shape":"ShrinkPolicy", - "documentation":"

Policy for customizing shrink operations.

" - }, - "AutoScalingPolicy":{ - "shape":"AutoScalingPolicyDescription", - "documentation":"

An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. See PutAutoScalingPolicy.

" - } - }, - "documentation":"

This entity represents an instance group, which is a group of instances that have common purpose. For example, CORE instance group is used for HDFS.

" - }, - "InstanceGroupConfig":{ - "type":"structure", - "required":[ - "InstanceRole", - "InstanceType", - "InstanceCount" - ], - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Friendly name given to the instance group.

" - }, - "Market":{ - "shape":"MarketType", - "documentation":"

Market type of the EC2 instances used to create a cluster node.

" - }, - "InstanceRole":{ - "shape":"InstanceRoleType", - "documentation":"

The role of the instance group in the cluster.

" - }, - "BidPrice":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The maximum Spot price your are willing to pay for EC2 instances.

An optional, nullable field that applies if the MarketType for the instance group is specified as SPOT. Specify the maximum spot price in USD. If the value is NULL and SPOT is specified, the maximum Spot price is set equal to the On-Demand price.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type for all instances in the instance group.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

Target number of instances for the instance group.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

Amazon EMR releases 4.x or later.

The list of configurations supplied for an EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).

" - }, - "EbsConfiguration":{ - "shape":"EbsConfiguration", - "documentation":"

EBS configurations that will be attached to each EC2 instance in the instance group.

" - }, - "AutoScalingPolicy":{ - "shape":"AutoScalingPolicy", - "documentation":"

An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. See PutAutoScalingPolicy.

" - } - }, - "documentation":"

Configuration defining a new instance group.

" - }, - "InstanceGroupConfigList":{ - "type":"list", - "member":{"shape":"InstanceGroupConfig"} - }, - "InstanceGroupDetail":{ - "type":"structure", - "required":[ - "Market", - "InstanceRole", - "InstanceType", - "InstanceRequestCount", - "InstanceRunningCount", - "State", - "CreationDateTime" - ], - "members":{ - "InstanceGroupId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Unique identifier for the instance group.

" - }, - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Friendly name for the instance group.

" - }, - "Market":{ - "shape":"MarketType", - "documentation":"

Market type of the EC2 instances used to create a cluster node.

" - }, - "InstanceRole":{ - "shape":"InstanceRoleType", - "documentation":"

Instance group role in the cluster

" - }, - "BidPrice":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The maximum Spot price your are willing to pay for EC2 instances.

An optional, nullable field that applies if the MarketType for the instance group is specified as SPOT. Specified in USD. If the value is NULL and SPOT is specified, the maximum Spot price is set equal to the On-Demand price.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

EC2 instance type.

" - }, - "InstanceRequestCount":{ - "shape":"Integer", - "documentation":"

Target number of instances to run in the instance group.

" - }, - "InstanceRunningCount":{ - "shape":"Integer", - "documentation":"

Actual count of running instances.

" - }, - "State":{ - "shape":"InstanceGroupState", - "documentation":"

State of instance group. The following values are deprecated: STARTING, TERMINATED, and FAILED.

" - }, - "LastStateChangeReason":{ - "shape":"XmlString", - "documentation":"

Details regarding the state of the instance group.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date/time the instance group was created.

" - }, - "StartDateTime":{ - "shape":"Date", - "documentation":"

The date/time the instance group was started.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The date/time the instance group was available to the cluster.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The date/time the instance group was terminated.

" - } - }, - "documentation":"

Detailed information about an instance group.

" - }, - "InstanceGroupDetailList":{ - "type":"list", - "member":{"shape":"InstanceGroupDetail"} - }, - "InstanceGroupId":{"type":"string"}, - "InstanceGroupIdsList":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - }, - "InstanceGroupList":{ - "type":"list", - "member":{"shape":"InstanceGroup"} - }, - "InstanceGroupModifyConfig":{ - "type":"structure", - "required":["InstanceGroupId"], - "members":{ - "InstanceGroupId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Unique ID of the instance group to expand or shrink.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

Target size for the instance group.

" - }, - "EC2InstanceIdsToTerminate":{ - "shape":"EC2InstanceIdsToTerminateList", - "documentation":"

The EC2 InstanceIds to terminate. After you terminate the instances, the instance group will not return to its original requested size.

" - }, - "ShrinkPolicy":{ - "shape":"ShrinkPolicy", - "documentation":"

Policy for customizing shrink operations.

" - } - }, - "documentation":"

Modify an instance group size.

" - }, - "InstanceGroupModifyConfigList":{ - "type":"list", - "member":{"shape":"InstanceGroupModifyConfig"} - }, - "InstanceGroupState":{ - "type":"string", - "enum":[ - "PROVISIONING", - "BOOTSTRAPPING", - "RUNNING", - "RESIZING", - "SUSPENDED", - "TERMINATING", - "TERMINATED", - "ARRESTED", - "SHUTTING_DOWN", - "ENDED" - ] - }, - "InstanceGroupStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"InstanceGroupStateChangeReasonCode", - "documentation":"

The programmable code for the state change reason.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The status change reason description.

" - } - }, - "documentation":"

The status change reason details for the instance group.

" - }, - "InstanceGroupStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "VALIDATION_ERROR", - "INSTANCE_FAILURE", - "CLUSTER_TERMINATED" - ] - }, - "InstanceGroupStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"InstanceGroupState", - "documentation":"

The current state of the instance group.

" - }, - "StateChangeReason":{ - "shape":"InstanceGroupStateChangeReason", - "documentation":"

The status change reason details for the instance group.

" - }, - "Timeline":{ - "shape":"InstanceGroupTimeline", - "documentation":"

The timeline of the instance group status over time.

" - } - }, - "documentation":"

The details of the instance group status.

" - }, - "InstanceGroupTimeline":{ - "type":"structure", - "members":{ - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation date and time of the instance group.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the instance group became ready to perform tasks.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the instance group terminated.

" - } - }, - "documentation":"

The timeline of the instance group lifecycle.

" - }, - "InstanceGroupType":{ - "type":"string", - "enum":[ - "MASTER", - "CORE", - "TASK" - ] - }, - "InstanceGroupTypeList":{ - "type":"list", - "member":{"shape":"InstanceGroupType"} - }, - "InstanceId":{"type":"string"}, - "InstanceList":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InstanceResizePolicy":{ - "type":"structure", - "members":{ - "InstancesToTerminate":{ - "shape":"EC2InstanceIdsList", - "documentation":"

Specific list of instances to be terminated when shrinking an instance group.

" - }, - "InstancesToProtect":{ - "shape":"EC2InstanceIdsList", - "documentation":"

Specific list of instances to be protected when shrinking an instance group.

" - }, - "InstanceTerminationTimeout":{ - "shape":"Integer", - "documentation":"

Decommissioning timeout override for the specific list of instances to be terminated.

" - } - }, - "documentation":"

Custom policy for requesting termination protection or termination of specific instances when shrinking an instance group.

" - }, - "InstanceRoleType":{ - "type":"string", - "enum":[ - "MASTER", - "CORE", - "TASK" - ] - }, - "InstanceState":{ - "type":"string", - "enum":[ - "AWAITING_FULFILLMENT", - "PROVISIONING", - "BOOTSTRAPPING", - "RUNNING", - "TERMINATED" - ] - }, - "InstanceStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"InstanceStateChangeReasonCode", - "documentation":"

The programmable code for the state change reason.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The status change reason description.

" - } - }, - "documentation":"

The details of the status change reason for the instance.

" - }, - "InstanceStateChangeReasonCode":{ - "type":"string", - "enum":[ - "INTERNAL_ERROR", - "VALIDATION_ERROR", - "INSTANCE_FAILURE", - "BOOTSTRAP_FAILURE", - "CLUSTER_TERMINATED" - ] - }, - "InstanceStateList":{ - "type":"list", - "member":{"shape":"InstanceState"} - }, - "InstanceStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"InstanceState", - "documentation":"

The current state of the instance.

" - }, - "StateChangeReason":{ - "shape":"InstanceStateChangeReason", - "documentation":"

The details of the status change reason for the instance.

" - }, - "Timeline":{ - "shape":"InstanceTimeline", - "documentation":"

The timeline of the instance status over time.

" - } - }, - "documentation":"

The instance status details.

" - }, - "InstanceTimeline":{ - "type":"structure", - "members":{ - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation date and time of the instance.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the instance was ready to perform tasks.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the instance was terminated.

" - } - }, - "documentation":"

The timeline of the instance lifecycle.

" - }, - "InstanceType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "InstanceTypeConfig":{ - "type":"structure", - "required":["InstanceType"], - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

An EC2 instance type, such as m3.xlarge.

" - }, - "WeightedCapacity":{ - "shape":"WholeNumber", - "documentation":"

The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig. This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.

" - }, - "BidPrice":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.

" - }, - "BidPriceAsPercentageOfOnDemandPrice":{ - "shape":"NonNegativeDouble", - "documentation":"

The bid price, as a percentage of On-Demand price, for each EC2 Spot instance as defined by InstanceType. Expressed as a number (for example, 20 specifies 20%). If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.

" - }, - "EbsConfiguration":{ - "shape":"EbsConfiguration", - "documentation":"

The configuration of Amazon Elastic Block Storage (EBS) attached to each instance as defined by InstanceType.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.

" - } - }, - "documentation":"

An instance type configuration for each instance type in an instance fleet, which determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities. There can be a maximum of 5 instance type configurations in a fleet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceTypeConfigList":{ - "type":"list", - "member":{"shape":"InstanceTypeConfig"} - }, - "InstanceTypeSpecification":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type, for example m3.xlarge.

" - }, - "WeightedCapacity":{ - "shape":"WholeNumber", - "documentation":"

The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig. Capacity values represent performance characteristics such as vCPUs, memory, or I/O. If not specified, the default value is 1.

" - }, - "BidPrice":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD.

" - }, - "BidPriceAsPercentageOfOnDemandPrice":{ - "shape":"NonNegativeDouble", - "documentation":"

The bid price, as a percentage of On-Demand price, for each EC2 Spot instance as defined by InstanceType. Expressed as a number (for example, 20 specifies 20%).

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR.

" - }, - "EbsBlockDevices":{ - "shape":"EbsBlockDeviceList", - "documentation":"

The configuration of Amazon Elastic Block Storage (EBS) attached to each instance as defined by InstanceType.

" - }, - "EbsOptimized":{ - "shape":"BooleanObject", - "documentation":"

Evaluates to TRUE when the specified InstanceType is EBS-optimized.

" - } - }, - "documentation":"

The configuration specification for each instance type in an instance fleet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "InstanceTypeSpecificationList":{ - "type":"list", - "member":{"shape":"InstanceTypeSpecification"} - }, - "Integer":{"type":"integer"}, - "InternalServerError":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that an error occurred while processing the request and that the request was not completed.

", - "exception":true - }, - "InternalServerException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"ErrorMessage", - "documentation":"

The message associated with the exception.

" - } - }, - "documentation":"

This exception occurs when there is an internal failure in the EMR service.

", - "exception":true, - "fault":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code associated with the exception.

" - }, - "Message":{ - "shape":"ErrorMessage", - "documentation":"

The message associated with the exception.

" - } - }, - "documentation":"

This exception occurs when there is something wrong with user input.

", - "exception":true - }, - "JobFlowDetail":{ - "type":"structure", - "required":[ - "JobFlowId", - "Name", - "ExecutionStatusDetail", - "Instances" - ], - "members":{ - "JobFlowId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The job flow identifier.

" - }, - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the job flow.

" - }, - "LogUri":{ - "shape":"XmlString", - "documentation":"

The location in Amazon S3 where log files for the job are stored.

" - }, - "AmiVersion":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR releases 4.0 and later, ReleaseLabel is used. To specify a custom AMI, use CustomAmiID.

" - }, - "ExecutionStatusDetail":{ - "shape":"JobFlowExecutionStatusDetail", - "documentation":"

Describes the execution status of the job flow.

" - }, - "Instances":{ - "shape":"JobFlowInstancesDetail", - "documentation":"

Describes the Amazon EC2 instances of the job flow.

" - }, - "Steps":{ - "shape":"StepDetailList", - "documentation":"

A list of steps run by the job flow.

" - }, - "BootstrapActions":{ - "shape":"BootstrapActionDetailList", - "documentation":"

A list of the bootstrap actions run by the job flow.

" - }, - "SupportedProducts":{ - "shape":"SupportedProductsList", - "documentation":"

A list of strings set by third party software when the job flow is launched. If you are not using third party software to manage the job flow this value is empty.

" - }, - "VisibleToAllUsers":{ - "shape":"Boolean", - "documentation":"

Specifies whether the cluster is visible to all IAM users of the AWS account associated with the cluster. If this value is set to true, all IAM users of that AWS account can view and (if they have the proper policy permissions set) manage the cluster. If it is set to false, only the IAM user that created the cluster can view and manage it. This value can be changed using the SetVisibleToAllUsers action.

" - }, - "JobFlowRole":{ - "shape":"XmlString", - "documentation":"

The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume this role.

" - }, - "ServiceRole":{ - "shape":"XmlString", - "documentation":"

The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.

" - }, - "AutoScalingRole":{ - "shape":"XmlString", - "documentation":"

An IAM role for automatic scaling policies. The default role is EMR_AutoScaling_DefaultRole. The IAM role provides a way for the automatic scaling feature to get the required permissions it needs to launch and terminate EC2 instances in an instance group.

" - }, - "ScaleDownBehavior":{ - "shape":"ScaleDownBehavior", - "documentation":"

The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized. TERMINATE_AT_INSTANCE_HOUR indicates that Amazon EMR terminates nodes at the instance-hour boundary, regardless of when the request to terminate the instance was submitted. This option is only available with Amazon EMR 5.1.0 and later and is the default for clusters created using that version. TERMINATE_AT_TASK_COMPLETION indicates that Amazon EMR blacklists and drains tasks from nodes before terminating the Amazon EC2 instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to HDFS corruption. TERMINATE_AT_TASK_COMPLETION available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.

" - } - }, - "documentation":"

A description of a cluster (job flow).

" - }, - "JobFlowDetailList":{ - "type":"list", - "member":{"shape":"JobFlowDetail"} - }, - "JobFlowExecutionState":{ - "type":"string", - "documentation":"

The type of instance.

", - "enum":[ - "STARTING", - "BOOTSTRAPPING", - "RUNNING", - "WAITING", - "SHUTTING_DOWN", - "TERMINATED", - "COMPLETED", - "FAILED" - ] - }, - "JobFlowExecutionStateList":{ - "type":"list", - "member":{"shape":"JobFlowExecutionState"} - }, - "JobFlowExecutionStatusDetail":{ - "type":"structure", - "required":[ - "State", - "CreationDateTime" - ], - "members":{ - "State":{ - "shape":"JobFlowExecutionState", - "documentation":"

The state of the job flow.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation date and time of the job flow.

" - }, - "StartDateTime":{ - "shape":"Date", - "documentation":"

The start date and time of the job flow.

" - }, - "ReadyDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the job flow was ready to start running bootstrap actions.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The completion date and time of the job flow.

" - }, - "LastStateChangeReason":{ - "shape":"XmlString", - "documentation":"

Description of the job flow last changed state.

" - } - }, - "documentation":"

Describes the status of the cluster (job flow).

" - }, - "JobFlowInstancesConfig":{ - "type":"structure", - "members":{ - "MasterInstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type of the master node.

" - }, - "SlaveInstanceType":{ - "shape":"InstanceType", - "documentation":"

The EC2 instance type of the slave nodes.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of EC2 instances in the cluster.

" - }, - "InstanceGroups":{ - "shape":"InstanceGroupConfigList", - "documentation":"

Configuration for the instance groups in a cluster.

" - }, - "InstanceFleets":{ - "shape":"InstanceFleetConfigList", - "documentation":"

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

Describes the EC2 instances and instance configurations for clusters that use the instance fleet configuration.

" - }, - "Ec2KeyName":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the EC2 key pair that can be used to ssh to the master node as the user called \"hadoop.\"

" - }, - "Placement":{ - "shape":"PlacementType", - "documentation":"

The Availability Zone in which the cluster runs.

" - }, - "KeepJobFlowAliveWhenNoSteps":{ - "shape":"Boolean", - "documentation":"

Specifies whether the cluster should remain available after completing all steps.

" - }, - "TerminationProtected":{ - "shape":"Boolean", - "documentation":"

Specifies whether to lock the cluster to prevent the Amazon EC2 instances from being terminated by API call, user intervention, or in the event of a job-flow error.

" - }, - "HadoopVersion":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version for the cluster. Valid inputs are \"0.18\" (deprecated), \"0.20\" (deprecated), \"0.20.205\" (deprecated), \"1.0.3\", \"2.2.0\", or \"2.4.0\". If you do not set this value, the default of 0.18 is used, unless the AmiVersion parameter is set in the RunJobFlow call, in which case the default version of Hadoop for that AMI version is used.

" - }, - "Ec2SubnetId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Applies to clusters that use the uniform instance group configuration. To launch the cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value, the cluster launches in the normal Amazon Web Services cloud, outside of an Amazon VPC, if the account launching the cluster supports EC2 Classic networks in the region where the cluster launches.

Amazon VPC currently does not support cluster compute quadruple extra large (cc1.4xlarge) instances. Thus you cannot specify the cc1.4xlarge instance type for clusters launched in an Amazon VPC.

" - }, - "Ec2SubnetIds":{ - "shape":"XmlStringMaxLen256List", - "documentation":"

Applies to clusters that use the instance fleet configuration. When multiple EC2 subnet IDs are specified, Amazon EMR evaluates them and launches instances in the optimal subnet.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "EmrManagedMasterSecurityGroup":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The identifier of the Amazon EC2 security group for the master node.

" - }, - "EmrManagedSlaveSecurityGroup":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The identifier of the Amazon EC2 security group for the slave nodes.

" - }, - "ServiceAccessSecurityGroup":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private subnets.

" - }, - "AdditionalMasterSecurityGroups":{ - "shape":"SecurityGroupsList", - "documentation":"

A list of additional Amazon EC2 security group IDs for the master node.

" - }, - "AdditionalSlaveSecurityGroups":{ - "shape":"SecurityGroupsList", - "documentation":"

A list of additional Amazon EC2 security group IDs for the slave nodes.

" - } - }, - "documentation":"

A description of the Amazon EC2 instance on which the cluster (job flow) runs. A valid JobFlowInstancesConfig must contain either InstanceGroups or InstanceFleets, which is the recommended configuration. They cannot be used together. You may also have MasterInstanceType, SlaveInstanceType, and InstanceCount (all three must be present), but we don't recommend this configuration.

" - }, - "JobFlowInstancesDetail":{ - "type":"structure", - "required":[ - "MasterInstanceType", - "SlaveInstanceType", - "InstanceCount" - ], - "members":{ - "MasterInstanceType":{ - "shape":"InstanceType", - "documentation":"

The Amazon EC2 master node instance type.

" - }, - "MasterPublicDnsName":{ - "shape":"XmlString", - "documentation":"

The DNS name of the master node. If the cluster is on a private subnet, this is the private DNS name. On a public subnet, this is the public DNS name.

" - }, - "MasterInstanceId":{ - "shape":"XmlString", - "documentation":"

The Amazon EC2 instance identifier of the master node.

" - }, - "SlaveInstanceType":{ - "shape":"InstanceType", - "documentation":"

The Amazon EC2 slave node instance type.

" - }, - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Amazon EC2 instances in the cluster. If the value is 1, the same instance serves as both the master and slave node. If the value is greater than 1, one instance is the master node and all others are slave nodes.

" - }, - "InstanceGroups":{ - "shape":"InstanceGroupDetailList", - "documentation":"

Details about the instance groups in a cluster.

" - }, - "NormalizedInstanceHours":{ - "shape":"Integer", - "documentation":"

An approximation of the cost of the cluster, represented in m1.small/hours. This value is incremented one time for every hour that an m1.small runs. Larger instances are weighted more, so an Amazon EC2 instance that is roughly four times more expensive would result in the normalized instance hours being incremented by four. This result is only an approximation and does not reflect the actual billing rate.

" - }, - "Ec2KeyName":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of an Amazon EC2 key pair that can be used to ssh to the master node.

" - }, - "Ec2SubnetId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

For clusters launched within Amazon Virtual Private Cloud, this is the identifier of the subnet where the cluster was launched.

" - }, - "Placement":{ - "shape":"PlacementType", - "documentation":"

The Amazon EC2 Availability Zone for the cluster.

" - }, - "KeepJobFlowAliveWhenNoSteps":{ - "shape":"Boolean", - "documentation":"

Specifies whether the cluster should remain available after completing all steps.

" - }, - "TerminationProtected":{ - "shape":"Boolean", - "documentation":"

Specifies whether the Amazon EC2 instances in the cluster are protected from termination by API calls, user intervention, or in the event of a job-flow error.

" - }, - "HadoopVersion":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The Hadoop version for the cluster.

" - } - }, - "documentation":"

Specify the type of Amazon EC2 instances that the cluster (job flow) runs on.

" - }, - "KerberosAttributes":{ - "type":"structure", - "required":[ - "Realm", - "KdcAdminPassword" - ], - "members":{ - "Realm":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the Kerberos realm to which all nodes in a cluster belong. For example, EC2.INTERNAL.

" - }, - "KdcAdminPassword":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The password used within the cluster for the kadmin service on the cluster-dedicated KDC, which maintains Kerberos principals, password policies, and keytabs for the cluster.

" - }, - "CrossRealmTrustPrincipalPassword":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Required only when establishing a cross-realm trust with a KDC in a different realm. The cross-realm principal password, which must be identical across realms.

" - }, - "ADDomainJoinUser":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Required only when establishing a cross-realm trust with an Active Directory domain. A user with sufficient privileges to join resources to the domain.

" - }, - "ADDomainJoinPassword":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The Active Directory password for ADDomainJoinUser.

" - } - }, - "documentation":"

Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see Use Kerberos Authentication in the EMR Management Guide.

" - }, - "KeyValue":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"XmlString", - "documentation":"

The unique identifier of a key value pair.

" - }, - "Value":{ - "shape":"XmlString", - "documentation":"

The value part of the identified key.

" - } - }, - "documentation":"

A key value pair.

" - }, - "KeyValueList":{ - "type":"list", - "member":{"shape":"KeyValue"} - }, - "ListBootstrapActionsInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The cluster identifier for the bootstrap actions to list.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines which bootstrap actions to retrieve.

" - }, - "ListBootstrapActionsOutput":{ - "type":"structure", - "members":{ - "BootstrapActions":{ - "shape":"CommandList", - "documentation":"

The bootstrap actions associated with the cluster.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This output contains the bootstrap actions detail.

" - }, - "ListClustersInput":{ - "type":"structure", - "members":{ - "CreatedAfter":{ - "shape":"Date", - "documentation":"

The creation date and time beginning value filter for listing clusters.

" - }, - "CreatedBefore":{ - "shape":"Date", - "documentation":"

The creation date and time end value filter for listing clusters.

" - }, - "ClusterStates":{ - "shape":"ClusterStateList", - "documentation":"

The cluster state filters to apply when listing clusters.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines how the ListClusters action filters the list of clusters that it returns.

" - }, - "ListClustersOutput":{ - "type":"structure", - "members":{ - "Clusters":{ - "shape":"ClusterSummaryList", - "documentation":"

The list of clusters for the account based on the given filters.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This contains a ClusterSummaryList with the cluster details; for example, the cluster IDs, names, and status.

" - }, - "ListInstanceFleetsInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The unique identifier of the cluster.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - } - }, - "ListInstanceFleetsOutput":{ - "type":"structure", - "members":{ - "InstanceFleets":{ - "shape":"InstanceFleetList", - "documentation":"

The list of instance fleets for the cluster and given filters.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - } - }, - "ListInstanceGroupsInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier of the cluster for which to list the instance groups.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines which instance groups to retrieve.

" - }, - "ListInstanceGroupsOutput":{ - "type":"structure", - "members":{ - "InstanceGroups":{ - "shape":"InstanceGroupList", - "documentation":"

The list of instance groups for the cluster and given filters.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines which instance groups to retrieve.

" - }, - "ListInstancesInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier of the cluster for which to list the instances.

" - }, - "InstanceGroupId":{ - "shape":"InstanceGroupId", - "documentation":"

The identifier of the instance group for which to list the instances.

" - }, - "InstanceGroupTypes":{ - "shape":"InstanceGroupTypeList", - "documentation":"

The type of instance group for which to list the instances.

" - }, - "InstanceFleetId":{ - "shape":"InstanceFleetId", - "documentation":"

The unique identifier of the instance fleet.

" - }, - "InstanceFleetType":{ - "shape":"InstanceFleetType", - "documentation":"

The node type of the instance fleet. For example MASTER, CORE, or TASK.

" - }, - "InstanceStates":{ - "shape":"InstanceStateList", - "documentation":"

A list of instance states that will filter the instances returned with this request.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines which instances to list.

" - }, - "ListInstancesOutput":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"InstanceList", - "documentation":"

The list of instances for the cluster and given filters.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This output contains the list of instances.

" - }, - "ListSecurityConfigurationsInput":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the set of results to retrieve.

" - } - } - }, - "ListSecurityConfigurationsOutput":{ - "type":"structure", - "members":{ - "SecurityConfigurations":{ - "shape":"SecurityConfigurationList", - "documentation":"

The creation date and time, and name, of each security configuration.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

A pagination token that indicates the next set of results to retrieve. Include the marker in the next ListSecurityConfiguration call to retrieve the next page of results, if required.

" - } - } - }, - "ListStepsInput":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The identifier of the cluster for which to list the steps.

" - }, - "StepStates":{ - "shape":"StepStateList", - "documentation":"

The filter to limit the step list based on certain states.

" - }, - "StepIds":{ - "shape":"XmlStringList", - "documentation":"

The filter to limit the step list based on the identifier of the steps.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This input determines which steps to list.

" - }, - "ListStepsOutput":{ - "type":"structure", - "members":{ - "Steps":{ - "shape":"StepSummaryList", - "documentation":"

The filtered list of steps for the cluster.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - }, - "documentation":"

This output contains the list of steps returned in reverse order. This means that the last step is the first element in the list.

" - }, - "Marker":{"type":"string"}, - "MarketType":{ - "type":"string", - "enum":[ - "ON_DEMAND", - "SPOT" - ] - }, - "MetricDimension":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The dimension name.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The dimension value.

" - } - }, - "documentation":"

A CloudWatch dimension, which is specified using a Key (known as a Name in CloudWatch), Value pair. By default, Amazon EMR uses one dimension whose Key is JobFlowID and Value is a variable representing the cluster ID, which is ${emr.clusterId}. This enables the rule to bootstrap when the cluster ID becomes available.

" - }, - "MetricDimensionList":{ - "type":"list", - "member":{"shape":"MetricDimension"} - }, - "ModifyInstanceFleetInput":{ - "type":"structure", - "required":[ - "ClusterId", - "InstanceFleet" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The unique identifier of the cluster.

" - }, - "InstanceFleet":{ - "shape":"InstanceFleetModifyConfig", - "documentation":"

The unique identifier of the instance fleet.

" - } - } - }, - "ModifyInstanceGroupsInput":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The ID of the cluster to which the instance group belongs.

" - }, - "InstanceGroups":{ - "shape":"InstanceGroupModifyConfigList", - "documentation":"

Instance groups to change.

" - } - }, - "documentation":"

Change the size of some instance groups.

" - }, - "NewSupportedProductsList":{ - "type":"list", - "member":{"shape":"SupportedProductConfig"} - }, - "NonNegativeDouble":{ - "type":"double", - "min":0.0 - }, - "PlacementType":{ - "type":"structure", - "members":{ - "AvailabilityZone":{ - "shape":"XmlString", - "documentation":"

The Amazon EC2 Availability Zone for the cluster. AvailabilityZone is used for uniform instance groups, while AvailabilityZones (plural) is used for instance fleets.

" - }, - "AvailabilityZones":{ - "shape":"XmlStringMaxLen256List", - "documentation":"

When multiple Availability Zones are specified, Amazon EMR evaluates them and launches instances in the optimal Availability Zone. AvailabilityZones is used for instance fleets, while AvailabilityZone (singular) is used for uniform instance groups.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - } - }, - "documentation":"

The Amazon EC2 Availability Zone configuration of the cluster (job flow).

" - }, - "PutAutoScalingPolicyInput":{ - "type":"structure", - "required":[ - "ClusterId", - "InstanceGroupId", - "AutoScalingPolicy" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

Specifies the ID of a cluster. The instance group to which the automatic scaling policy is applied is within this cluster.

" - }, - "InstanceGroupId":{ - "shape":"InstanceGroupId", - "documentation":"

Specifies the ID of the instance group to which the automatic scaling policy is applied.

" - }, - "AutoScalingPolicy":{ - "shape":"AutoScalingPolicy", - "documentation":"

Specifies the definition of the automatic scaling policy.

" - } - } - }, - "PutAutoScalingPolicyOutput":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

Specifies the ID of a cluster. The instance group to which the automatic scaling policy is applied is within this cluster.

" - }, - "InstanceGroupId":{ - "shape":"InstanceGroupId", - "documentation":"

Specifies the ID of the instance group to which the scaling policy is applied.

" - }, - "AutoScalingPolicy":{ - "shape":"AutoScalingPolicyDescription", - "documentation":"

The automatic scaling policy definition.

" - } - } - }, - "RemoveAutoScalingPolicyInput":{ - "type":"structure", - "required":[ - "ClusterId", - "InstanceGroupId" - ], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

Specifies the ID of a cluster. The instance group to which the automatic scaling policy is applied is within this cluster.

" - }, - "InstanceGroupId":{ - "shape":"InstanceGroupId", - "documentation":"

Specifies the ID of the instance group to which the scaling policy is applied.

" - } - } - }, - "RemoveAutoScalingPolicyOutput":{ - "type":"structure", - "members":{ - } - }, - "RemoveTagsInput":{ - "type":"structure", - "required":[ - "ResourceId", - "TagKeys" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The Amazon EMR resource identifier from which tags will be removed. This value must be a cluster identifier.

" - }, - "TagKeys":{ - "shape":"StringList", - "documentation":"

A list of tag keys to remove from a resource.

" - } - }, - "documentation":"

This input identifies a cluster and a list of tags to remove.

" - }, - "RemoveTagsOutput":{ - "type":"structure", - "members":{ - }, - "documentation":"

This output indicates the result of removing tags from a resource.

" - }, - "RepoUpgradeOnBoot":{ - "type":"string", - "enum":[ - "SECURITY", - "NONE" - ] - }, - "ResourceId":{"type":"string"}, - "RunJobFlowInput":{ - "type":"structure", - "required":[ - "Name", - "Instances" - ], - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the job flow.

" - }, - "LogUri":{ - "shape":"XmlString", - "documentation":"

The location in Amazon S3 to write the log files of the job flow. If a value is not provided, logs are not created.

" - }, - "AdditionalInfo":{ - "shape":"XmlString", - "documentation":"

A JSON string for selecting additional features.

" - }, - "AmiVersion":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR releases 4.0 and later, ReleaseLabel is used. To specify a custom AMI, use CustomAmiID.

" - }, - "ReleaseLabel":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster. Release labels are in the form emr-x.x.x, where x.x.x is an Amazon EMR release version, for example, emr-5.14.0. For more information about Amazon EMR release versions and included application versions and features, see http://docs.aws.amazon.com/emr/latest/ReleaseGuide/. The release label applies only to Amazon EMR releases versions 4.x and later. Earlier versions use AmiVersion.

" - }, - "Instances":{ - "shape":"JobFlowInstancesConfig", - "documentation":"

A specification of the number and type of Amazon EC2 instances.

" - }, - "Steps":{ - "shape":"StepConfigList", - "documentation":"

A list of steps to run.

" - }, - "BootstrapActions":{ - "shape":"BootstrapActionConfigList", - "documentation":"

A list of bootstrap actions to run before Hadoop starts on the cluster nodes.

" - }, - "SupportedProducts":{ - "shape":"SupportedProductsList", - "documentation":"

For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and later, use Applications.

A list of strings that indicates third-party software to use. For more information, see the Amazon EMR Developer Guide. Currently supported values are:

  • \"mapr-m3\" - launch the job flow using MapR M3 Edition.

  • \"mapr-m5\" - launch the job flow using MapR M5 Edition.

" - }, - "NewSupportedProducts":{ - "shape":"NewSupportedProductsList", - "documentation":"

For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and later, use Applications.

A list of strings that indicates third-party software to use with the job flow that accepts a user argument list. EMR accepts and forwards the argument list to the corresponding installation script as bootstrap action arguments. For more information, see \"Launch a Job Flow on the MapR Distribution for Hadoop\" in the Amazon EMR Developer Guide. Supported values are:

  • \"mapr-m3\" - launch the cluster using MapR M3 Edition.

  • \"mapr-m5\" - launch the cluster using MapR M5 Edition.

  • \"mapr\" with the user arguments specifying \"--edition,m3\" or \"--edition,m5\" - launch the job flow using MapR M3 or M5 Edition respectively.

  • \"mapr-m7\" - launch the cluster using MapR M7 Edition.

  • \"hunk\" - launch the cluster with the Hunk Big Data Analtics Platform.

  • \"hue\"- launch the cluster with Hue installed.

  • \"spark\" - launch the cluster with Apache Spark installed.

  • \"ganglia\" - launch the cluster with the Ganglia Monitoring System installed.

" - }, - "Applications":{ - "shape":"ApplicationList", - "documentation":"

For Amazon EMR releases 4.0 and later. A list of applications for the cluster. Valid values are: \"Hadoop\", \"Hive\", \"Mahout\", \"Pig\", and \"Spark.\" They are case insensitive.

" - }, - "Configurations":{ - "shape":"ConfigurationList", - "documentation":"

For Amazon EMR releases 4.0 and later. The list of configurations supplied for the EMR cluster you are creating.

" - }, - "VisibleToAllUsers":{ - "shape":"Boolean", - "documentation":"

Whether the cluster is visible to all IAM users of the AWS account associated with the cluster. If this value is set to true, all IAM users of that AWS account can view and (if they have the proper policy permissions set) manage the cluster. If it is set to false, only the IAM user that created the cluster can view and manage it.

" - }, - "JobFlowRole":{ - "shape":"XmlString", - "documentation":"

Also called instance profile and EC2 role. An IAM role for an EMR cluster. The EC2 instances of the cluster assume this role. The default role is EMR_EC2_DefaultRole. In order to use the default role, you must have already created it using the CLI or console.

" - }, - "ServiceRole":{ - "shape":"XmlString", - "documentation":"

The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags to associate with a cluster and propagate to Amazon EC2 instances.

" - }, - "SecurityConfiguration":{ - "shape":"XmlString", - "documentation":"

The name of a security configuration to apply to the cluster.

" - }, - "AutoScalingRole":{ - "shape":"XmlString", - "documentation":"

An IAM role for automatic scaling policies. The default role is EMR_AutoScaling_DefaultRole. The IAM role provides permissions that the automatic scaling feature requires to launch and terminate EC2 instances in an instance group.

" - }, - "ScaleDownBehavior":{ - "shape":"ScaleDownBehavior", - "documentation":"

Specifies the way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized. TERMINATE_AT_INSTANCE_HOUR indicates that Amazon EMR terminates nodes at the instance-hour boundary, regardless of when the request to terminate the instance was submitted. This option is only available with Amazon EMR 5.1.0 and later and is the default for clusters created using that version. TERMINATE_AT_TASK_COMPLETION indicates that Amazon EMR blacklists and drains tasks from nodes before terminating the Amazon EC2 instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to HDFS corruption. TERMINATE_AT_TASK_COMPLETION available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.

" - }, - "CustomAmiId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI. If specified, Amazon EMR uses this AMI when it launches cluster EC2 instances. For more information about custom AMIs in Amazon EMR, see Using a Custom AMI in the Amazon EMR Management Guide. If omitted, the cluster uses the base Linux AMI for the ReleaseLabel specified. For Amazon EMR versions 2.x and 3.x, use AmiVersion instead.

For information about creating a custom AMI, see Creating an Amazon EBS-Backed Linux AMI in the Amazon Elastic Compute Cloud User Guide for Linux Instances. For information about finding an AMI ID, see Finding a Linux AMI.

" - }, - "EbsRootVolumeSize":{ - "shape":"Integer", - "documentation":"

The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance. Available in Amazon EMR version 4.x and later.

" - }, - "RepoUpgradeOnBoot":{ - "shape":"RepoUpgradeOnBoot", - "documentation":"

Applies only when CustomAmiID is used. Specifies which updates from the Amazon Linux AMI package repositories to apply automatically when the instance boots using the AMI. If omitted, the default is SECURITY, which indicates that only security updates are applied. If NONE is specified, no updates are applied, and all updates must be applied manually.

" - }, - "KerberosAttributes":{ - "shape":"KerberosAttributes", - "documentation":"

Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see Use Kerberos Authentication in the EMR Management Guide.

" - } - }, - "documentation":"

Input to the RunJobFlow operation.

" - }, - "RunJobFlowOutput":{ - "type":"structure", - "members":{ - "JobFlowId":{ - "shape":"XmlStringMaxLen256", - "documentation":"

An unique identifier for the job flow.

" - } - }, - "documentation":"

The result of the RunJobFlow operation.

" - }, - "ScaleDownBehavior":{ - "type":"string", - "enum":[ - "TERMINATE_AT_INSTANCE_HOUR", - "TERMINATE_AT_TASK_COMPLETION" - ] - }, - "ScalingAction":{ - "type":"structure", - "required":["SimpleScalingPolicyConfiguration"], - "members":{ - "Market":{ - "shape":"MarketType", - "documentation":"

Not available for instance groups. Instance groups use the market type specified for the group.

" - }, - "SimpleScalingPolicyConfiguration":{ - "shape":"SimpleScalingPolicyConfiguration", - "documentation":"

The type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.

" - } - }, - "documentation":"

The type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.

" - }, - "ScalingConstraints":{ - "type":"structure", - "required":[ - "MinCapacity", - "MaxCapacity" - ], - "members":{ - "MinCapacity":{ - "shape":"Integer", - "documentation":"

The lower boundary of EC2 instances in an instance group below which scaling activities are not allowed to shrink. Scale-in activities will not terminate instances below this boundary.

" - }, - "MaxCapacity":{ - "shape":"Integer", - "documentation":"

The upper boundary of EC2 instances in an instance group beyond which scaling activities are not allowed to grow. Scale-out activities will not add instances beyond this boundary.

" - } - }, - "documentation":"

The upper and lower EC2 instance limits for an automatic scaling policy. Automatic scaling activities triggered by automatic scaling rules will not cause an instance group to grow above or below these limits.

" - }, - "ScalingRule":{ - "type":"structure", - "required":[ - "Name", - "Action", - "Trigger" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name used to identify an automatic scaling rule. Rule names must be unique within a scaling policy.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A friendly, more verbose description of the automatic scaling rule.

" - }, - "Action":{ - "shape":"ScalingAction", - "documentation":"

The conditions that trigger an automatic scaling activity.

" - }, - "Trigger":{ - "shape":"ScalingTrigger", - "documentation":"

The CloudWatch alarm definition that determines when automatic scaling activity is triggered.

" - } - }, - "documentation":"

A scale-in or scale-out rule that defines scaling activity, including the CloudWatch metric alarm that triggers activity, how EC2 instances are added or removed, and the periodicity of adjustments. The automatic scaling policy for an instance group can comprise one or more automatic scaling rules.

" - }, - "ScalingRuleList":{ - "type":"list", - "member":{"shape":"ScalingRule"} - }, - "ScalingTrigger":{ - "type":"structure", - "required":["CloudWatchAlarmDefinition"], - "members":{ - "CloudWatchAlarmDefinition":{ - "shape":"CloudWatchAlarmDefinition", - "documentation":"

The definition of a CloudWatch metric alarm. When the defined alarm conditions are met along with other trigger parameters, scaling activity begins.

" - } - }, - "documentation":"

The conditions that trigger an automatic scaling activity.

" - }, - "ScriptBootstrapActionConfig":{ - "type":"structure", - "required":["Path"], - "members":{ - "Path":{ - "shape":"XmlString", - "documentation":"

Location of the script to run during a bootstrap action. Can be either a location in Amazon S3 or on a local file system.

" - }, - "Args":{ - "shape":"XmlStringList", - "documentation":"

A list of command line arguments to pass to the bootstrap action script.

" - } - }, - "documentation":"

Configuration of the script to run during a bootstrap action.

" - }, - "SecurityConfigurationList":{ - "type":"list", - "member":{"shape":"SecurityConfigurationSummary"} - }, - "SecurityConfigurationSummary":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"XmlString", - "documentation":"

The name of the security configuration.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time the security configuration was created.

" - } - }, - "documentation":"

The creation date and time, and name, of a security configuration.

" - }, - "SecurityGroupsList":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - }, - "SetTerminationProtectionInput":{ - "type":"structure", - "required":[ - "JobFlowIds", - "TerminationProtected" - ], - "members":{ - "JobFlowIds":{ - "shape":"XmlStringList", - "documentation":"

A list of strings that uniquely identify the clusters to protect. This identifier is returned by RunJobFlow and can also be obtained from DescribeJobFlows .

" - }, - "TerminationProtected":{ - "shape":"Boolean", - "documentation":"

A Boolean that indicates whether to protect the cluster and prevent the Amazon EC2 instances in the cluster from shutting down due to API calls, user intervention, or job-flow error.

" - } - }, - "documentation":"

The input argument to the TerminationProtection operation.

" - }, - "SetVisibleToAllUsersInput":{ - "type":"structure", - "required":[ - "JobFlowIds", - "VisibleToAllUsers" - ], - "members":{ - "JobFlowIds":{ - "shape":"XmlStringList", - "documentation":"

Identifiers of the job flows to receive the new visibility setting.

" - }, - "VisibleToAllUsers":{ - "shape":"Boolean", - "documentation":"

Whether the specified clusters are visible to all IAM users of the AWS account associated with the cluster. If this value is set to True, all IAM users of that AWS account can view and, if they have the proper IAM policy permissions set, manage the clusters. If it is set to False, only the IAM user that created a cluster can view and manage it.

" - } - }, - "documentation":"

The input to the SetVisibleToAllUsers action.

" - }, - "ShrinkPolicy":{ - "type":"structure", - "members":{ - "DecommissionTimeout":{ - "shape":"Integer", - "documentation":"

The desired timeout for decommissioning an instance. Overrides the default YARN decommissioning timeout.

" - }, - "InstanceResizePolicy":{ - "shape":"InstanceResizePolicy", - "documentation":"

Custom policy for requesting termination protection or termination of specific instances when shrinking an instance group.

" - } - }, - "documentation":"

Policy for customizing shrink operations. Allows configuration of decommissioning timeout and targeted instance shrinking.

" - }, - "SimpleScalingPolicyConfiguration":{ - "type":"structure", - "required":["ScalingAdjustment"], - "members":{ - "AdjustmentType":{ - "shape":"AdjustmentType", - "documentation":"

The way in which EC2 instances are added (if ScalingAdjustment is a positive number) or terminated (if ScalingAdjustment is a negative number) each time the scaling activity is triggered. CHANGE_IN_CAPACITY is the default. CHANGE_IN_CAPACITY indicates that the EC2 instance count increments or decrements by ScalingAdjustment, which should be expressed as an integer. PERCENT_CHANGE_IN_CAPACITY indicates the instance count increments or decrements by the percentage specified by ScalingAdjustment, which should be expressed as an integer. For example, 20 indicates an increase in 20% increments of cluster capacity. EXACT_CAPACITY indicates the scaling activity results in an instance group with the number of EC2 instances specified by ScalingAdjustment, which should be expressed as a positive integer.

" - }, - "ScalingAdjustment":{ - "shape":"Integer", - "documentation":"

The amount by which to scale in or scale out, based on the specified AdjustmentType. A positive value adds to the instance group's EC2 instance count while a negative number removes instances. If AdjustmentType is set to EXACT_CAPACITY, the number should only be a positive integer. If AdjustmentType is set to PERCENT_CHANGE_IN_CAPACITY, the value should express the percentage as an integer. For example, -20 indicates a decrease in 20% increments of cluster capacity.

" - }, - "CoolDown":{ - "shape":"Integer", - "documentation":"

The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start. The default value is 0.

" - } - }, - "documentation":"

An automatic scaling configuration, which describes how the policy adds or removes instances, the cooldown period, and the number of EC2 instances that will be added each time the CloudWatch metric alarm condition is satisfied.

" - }, - "SpotProvisioningSpecification":{ - "type":"structure", - "required":[ - "TimeoutDurationMinutes", - "TimeoutAction" - ], - "members":{ - "TimeoutDurationMinutes":{ - "shape":"WholeNumber", - "documentation":"

The spot provisioning timeout period in minutes. If Spot instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.

" - }, - "TimeoutAction":{ - "shape":"SpotProvisioningTimeoutAction", - "documentation":"

The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired. Spot instances are not uprovisioned within the Spot provisioining timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND. SWITCH_TO_ON_DEMAND specifies that if no Spot instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.

" - }, - "BlockDurationMinutes":{ - "shape":"WholeNumber", - "documentation":"

The defined duration for Spot instances (also known as Spot blocks) in minutes. When specified, the Spot instance does not terminate before the defined duration expires, and defined duration pricing for Spot instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates.

" - } - }, - "documentation":"

The launch specification for Spot instances in the instance fleet, which determines the defined duration and provisioning timeout behavior.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

" - }, - "SpotProvisioningTimeoutAction":{ - "type":"string", - "enum":[ - "SWITCH_TO_ON_DEMAND", - "TERMINATE_CLUSTER" - ] - }, - "Statistic":{ - "type":"string", - "enum":[ - "SAMPLE_COUNT", - "AVERAGE", - "SUM", - "MINIMUM", - "MAXIMUM" - ] - }, - "Step":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"StepId", - "documentation":"

The identifier of the cluster step.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the cluster step.

" - }, - "Config":{ - "shape":"HadoopStepConfig", - "documentation":"

The Hadoop job configuration of the cluster step.

" - }, - "ActionOnFailure":{ - "shape":"ActionOnFailure", - "documentation":"

This specifies what action to take when the cluster step fails. Possible values are TERMINATE_CLUSTER, CANCEL_AND_WAIT, and CONTINUE.

" - }, - "Status":{ - "shape":"StepStatus", - "documentation":"

The current execution status details of the cluster step.

" - } - }, - "documentation":"

This represents a step in a cluster.

" - }, - "StepConfig":{ - "type":"structure", - "required":[ - "Name", - "HadoopJarStep" - ], - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the step.

" - }, - "ActionOnFailure":{ - "shape":"ActionOnFailure", - "documentation":"

The action to take if the step fails.

" - }, - "HadoopJarStep":{ - "shape":"HadoopJarStepConfig", - "documentation":"

The JAR file used for the step.

" - } - }, - "documentation":"

Specification of a cluster (job flow) step.

" - }, - "StepConfigList":{ - "type":"list", - "member":{"shape":"StepConfig"} - }, - "StepDetail":{ - "type":"structure", - "required":[ - "StepConfig", - "ExecutionStatusDetail" - ], - "members":{ - "StepConfig":{ - "shape":"StepConfig", - "documentation":"

The step configuration.

" - }, - "ExecutionStatusDetail":{ - "shape":"StepExecutionStatusDetail", - "documentation":"

The description of the step status.

" - } - }, - "documentation":"

Combines the execution state and configuration of a step.

" - }, - "StepDetailList":{ - "type":"list", - "member":{"shape":"StepDetail"} - }, - "StepExecutionState":{ - "type":"string", - "enum":[ - "PENDING", - "RUNNING", - "CONTINUE", - "COMPLETED", - "CANCELLED", - "FAILED", - "INTERRUPTED" - ] - }, - "StepExecutionStatusDetail":{ - "type":"structure", - "required":[ - "State", - "CreationDateTime" - ], - "members":{ - "State":{ - "shape":"StepExecutionState", - "documentation":"

The state of the step.

" - }, - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The creation date and time of the step.

" - }, - "StartDateTime":{ - "shape":"Date", - "documentation":"

The start date and time of the step.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The completion date and time of the step.

" - }, - "LastStateChangeReason":{ - "shape":"XmlString", - "documentation":"

A description of the step's current state.

" - } - }, - "documentation":"

The execution state of a step.

" - }, - "StepId":{"type":"string"}, - "StepIdsList":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - }, - "StepState":{ - "type":"string", - "enum":[ - "PENDING", - "CANCEL_PENDING", - "RUNNING", - "COMPLETED", - "CANCELLED", - "FAILED", - "INTERRUPTED" - ] - }, - "StepStateChangeReason":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"StepStateChangeReasonCode", - "documentation":"

The programmable code for the state change reason. Note: Currently, the service provides no code for the state change.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The descriptive message for the state change reason.

" - } - }, - "documentation":"

The details of the step state change reason.

" - }, - "StepStateChangeReasonCode":{ - "type":"string", - "enum":["NONE"] - }, - "StepStateList":{ - "type":"list", - "member":{"shape":"StepState"} - }, - "StepStatus":{ - "type":"structure", - "members":{ - "State":{ - "shape":"StepState", - "documentation":"

The execution state of the cluster step.

" - }, - "StateChangeReason":{ - "shape":"StepStateChangeReason", - "documentation":"

The reason for the step execution status change.

" - }, - "FailureDetails":{ - "shape":"FailureDetails", - "documentation":"

The details for the step failure including reason, message, and log file path where the root cause was identified.

" - }, - "Timeline":{ - "shape":"StepTimeline", - "documentation":"

The timeline of the cluster step status over time.

" - } - }, - "documentation":"

The execution status details of the cluster step.

" - }, - "StepSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"StepId", - "documentation":"

The identifier of the cluster step.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the cluster step.

" - }, - "Config":{ - "shape":"HadoopStepConfig", - "documentation":"

The Hadoop job configuration of the cluster step.

" - }, - "ActionOnFailure":{ - "shape":"ActionOnFailure", - "documentation":"

This specifies what action to take when the cluster step fails. Possible values are TERMINATE_CLUSTER, CANCEL_AND_WAIT, and CONTINUE.

" - }, - "Status":{ - "shape":"StepStatus", - "documentation":"

The current execution status details of the cluster step.

" - } - }, - "documentation":"

The summary of the cluster step.

" - }, - "StepSummaryList":{ - "type":"list", - "member":{"shape":"StepSummary"} - }, - "StepTimeline":{ - "type":"structure", - "members":{ - "CreationDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the cluster step was created.

" - }, - "StartDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the cluster step execution started.

" - }, - "EndDateTime":{ - "shape":"Date", - "documentation":"

The date and time when the cluster step execution completed or failed.

" - } - }, - "documentation":"

The timeline of the cluster step lifecycle.

" - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "StringMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "SupportedProductConfig":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"XmlStringMaxLen256", - "documentation":"

The name of the product configuration.

" - }, - "Args":{ - "shape":"XmlStringList", - "documentation":"

The list of user-supplied arguments.

" - } - }, - "documentation":"

The list of supported product configurations which allow user-supplied arguments. EMR accepts these arguments and forwards them to the corresponding installation script as bootstrap action arguments.

" - }, - "SupportedProductsList":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

A user-defined key, which is the minimum required information for a valid tag. For more information, see Tag .

" - }, - "Value":{ - "shape":"String", - "documentation":"

A user-defined value, which is optional in a tag. For more information, see Tag Clusters.

" - } - }, - "documentation":"

A key/value pair containing user-defined metadata that you can associate with an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more information, see Tag Clusters.

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TerminateJobFlowsInput":{ - "type":"structure", - "required":["JobFlowIds"], - "members":{ - "JobFlowIds":{ - "shape":"XmlStringList", - "documentation":"

A list of job flows to be shutdown.

" - } - }, - "documentation":"

Input to the TerminateJobFlows operation.

" - }, - "Unit":{ - "type":"string", - "enum":[ - "NONE", - "SECONDS", - "MICRO_SECONDS", - "MILLI_SECONDS", - "BYTES", - "KILO_BYTES", - "MEGA_BYTES", - "GIGA_BYTES", - "TERA_BYTES", - "BITS", - "KILO_BITS", - "MEGA_BITS", - "GIGA_BITS", - "TERA_BITS", - "PERCENT", - "COUNT", - "BYTES_PER_SECOND", - "KILO_BYTES_PER_SECOND", - "MEGA_BYTES_PER_SECOND", - "GIGA_BYTES_PER_SECOND", - "TERA_BYTES_PER_SECOND", - "BITS_PER_SECOND", - "KILO_BITS_PER_SECOND", - "MEGA_BITS_PER_SECOND", - "GIGA_BITS_PER_SECOND", - "TERA_BITS_PER_SECOND", - "COUNT_PER_SECOND" - ] - }, - "VolumeSpecification":{ - "type":"structure", - "required":[ - "VolumeType", - "SizeInGB" - ], - "members":{ - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. Volume types supported are gp2, io1, standard.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports.

" - }, - "SizeInGB":{ - "shape":"Integer", - "documentation":"

The volume size, in gibibytes (GiB). This can be a number from 1 - 1024. If the volume type is EBS-optimized, the minimum value is 10.

" - } - }, - "documentation":"

EBS volume specifications such as volume type, IOPS, and size (GiB) that will be requested for the EBS volume attached to an EC2 instance in the cluster.

" - }, - "WholeNumber":{ - "type":"integer", - "min":0 - }, - "XmlString":{ - "type":"string", - "max":10280, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringList":{ - "type":"list", - "member":{"shape":"XmlString"} - }, - "XmlStringMaxLen256":{ - "type":"string", - "max":256, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "XmlStringMaxLen256List":{ - "type":"list", - "member":{"shape":"XmlStringMaxLen256"} - } - }, - "documentation":"

Amazon EMR is a web service that makes it easy to process large amounts of data efficiently. Amazon EMR uses Hadoop processing combined with several AWS products to do tasks such as web indexing, data mining, log file analysis, machine learning, scientific simulation, and data warehousing.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/waiters-2.json deleted file mode 100644 index abba8c3c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/emr/2009-03-31/waiters-2.json +++ /dev/null @@ -1,86 +0,0 @@ -{ - "version": 2, - "waiters": { - "ClusterRunning": { - "delay": 30, - "operation": "DescribeCluster", - "maxAttempts": 60, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "RUNNING" - }, - { - "state": "success", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "WAITING" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "TERMINATING" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "TERMINATED" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "TERMINATED_WITH_ERRORS" - } - ] - }, - "StepComplete": { - "delay": 30, - "operation": "DescribeStep", - "maxAttempts": 60, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "Step.Status.State", - "expected": "COMPLETED" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Step.Status.State", - "expected": "FAILED" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Step.Status.State", - "expected": "CANCELLED" - } - ] - }, - "ClusterTerminated": { - "delay": 30, - "operation": "DescribeCluster", - "maxAttempts": 60, - "acceptors": [ - { - "state": "success", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "TERMINATED" - }, - { - "state": "failure", - "matcher": "path", - "argument": "Cluster.Status.State", - "expected": "TERMINATED_WITH_ERRORS" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/endpoints.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/endpoints.json deleted file mode 100644 index c3ba2aa0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/endpoints.json +++ /dev/null @@ -1,2832 +0,0 @@ -{ - "partitions" : [ { - "defaults" : { - "hostname" : "{service}.{region}.{dnsSuffix}", - "protocols" : [ "https" ], - "signatureVersions" : [ "v4" ] - }, - "dnsSuffix" : "amazonaws.com", - "partition" : "aws", - "partitionName" : "AWS Standard", - "regionRegex" : "^(us|eu|ap|sa|ca)\\-\\w+\\-\\d+$", - "regions" : { - "ap-northeast-1" : { - "description" : "Asia Pacific (Tokyo)" - }, - "ap-northeast-2" : { - "description" : "Asia Pacific (Seoul)" - }, - "ap-south-1" : { - "description" : "Asia Pacific (Mumbai)" - }, - "ap-southeast-1" : { - "description" : "Asia Pacific (Singapore)" - }, - "ap-southeast-2" : { - "description" : "Asia Pacific (Sydney)" - }, - "ca-central-1" : { - "description" : "Canada (Central)" - }, - "eu-central-1" : { - "description" : "EU (Frankfurt)" - }, - "eu-west-1" : { - "description" : "EU (Ireland)" - }, - "eu-west-2" : { - "description" : "EU (London)" - }, - "eu-west-3" : { - "description" : "EU (Paris)" - }, - "sa-east-1" : { - "description" : "South America (Sao Paulo)" - }, - "us-east-1" : { - "description" : "US East (N. Virginia)" - }, - "us-east-2" : { - "description" : "US East (Ohio)" - }, - "us-west-1" : { - "description" : "US West (N. California)" - }, - "us-west-2" : { - "description" : "US West (Oregon)" - } - }, - "services" : { - "a4b" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "acm" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "acm-pca" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "api.mediatailor" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "us-east-1" : { } - } - }, - "api.pricing" : { - "defaults" : { - "credentialScope" : { - "service" : "pricing" - } - }, - "endpoints" : { - "ap-south-1" : { }, - "us-east-1" : { } - } - }, - "apigateway" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "application-autoscaling" : { - "defaults" : { - "credentialScope" : { - "service" : "application-autoscaling" - }, - "hostname" : "autoscaling.{region}.amazonaws.com", - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "appstream2" : { - "defaults" : { - "credentialScope" : { - "service" : "appstream" - }, - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "athena" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "autoscaling" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "autoscaling-plans" : { - "defaults" : { - "credentialScope" : { - "service" : "autoscaling-plans" - }, - "hostname" : "autoscaling.{region}.amazonaws.com", - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-southeast-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "batch" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "budgets" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "budgets.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "ce" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "ce.us-east-1.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "cloud9" : { - "endpoints" : { - "ap-southeast-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "clouddirectory" : { - "endpoints" : { - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "cloudformation" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cloudfront" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "cloudfront.amazonaws.com", - "protocols" : [ "http", "https" ] - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "cloudhsm" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cloudhsmv2" : { - "defaults" : { - "credentialScope" : { - "service" : "cloudhsm" - } - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cloudsearch" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cloudtrail" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "codebuild" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-1-fips" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "codebuild-fips.us-east-1.amazonaws.com" - }, - "us-east-2" : { }, - "us-east-2-fips" : { - "credentialScope" : { - "region" : "us-east-2" - }, - "hostname" : "codebuild-fips.us-east-2.amazonaws.com" - }, - "us-west-1" : { }, - "us-west-1-fips" : { - "credentialScope" : { - "region" : "us-west-1" - }, - "hostname" : "codebuild-fips.us-west-1.amazonaws.com" - }, - "us-west-2" : { }, - "us-west-2-fips" : { - "credentialScope" : { - "region" : "us-west-2" - }, - "hostname" : "codebuild-fips.us-west-2.amazonaws.com" - } - } - }, - "codecommit" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "codedeploy" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "codepipeline" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "codestar" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cognito-identity" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "cognito-idp" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "cognito-sync" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "comprehend" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "config" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "cur" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "data.iot" : { - "defaults" : { - "credentialScope" : { - "service" : "iotdata" - }, - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "datapipeline" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "dax" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "devicefarm" : { - "endpoints" : { - "us-west-2" : { } - } - }, - "directconnect" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "discovery" : { - "endpoints" : { - "us-west-2" : { } - } - }, - "dms" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "ds" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "dynamodb" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "local" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "localhost:8000", - "protocols" : [ "http" ] - }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "ec2" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "ecr" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "ecs" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elasticache" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "fips" : { - "credentialScope" : { - "region" : "us-west-1" - }, - "hostname" : "elasticache-fips.us-west-1.amazonaws.com" - }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elasticbeanstalk" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elasticfilesystem" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elasticloadbalancing" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elasticmapreduce" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "sslCommonName" : "{region}.{service}.{dnsSuffix}" - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { - "sslCommonName" : "{service}.{region}.{dnsSuffix}" - }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { - "sslCommonName" : "{service}.{region}.{dnsSuffix}" - }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "elastictranscoder" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "email" : { - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "entitlement.marketplace" : { - "defaults" : { - "credentialScope" : { - "service" : "aws-marketplace" - } - }, - "endpoints" : { - "us-east-1" : { } - } - }, - "es" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "events" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "firehose" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "fms" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "gamelift" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "glacier" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "glue" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "greengrass" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - }, - "isRegionalized" : true - }, - "guardduty" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - }, - "isRegionalized" : true - }, - "health" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "iam" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "iam.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "importexport" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1", - "service" : "IngestionService" - }, - "hostname" : "importexport.amazonaws.com", - "signatureVersions" : [ "v2", "v4" ] - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "inspector" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "iot" : { - "defaults" : { - "credentialScope" : { - "service" : "execute-api" - } - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "kinesis" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "kinesisanalytics" : { - "endpoints" : { - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "kinesisvideo" : { - "endpoints" : { - "ap-northeast-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "kms" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "lambda" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "lightsail" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "logs" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "machinelearning" : { - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { } - } - }, - "marketplacecommerceanalytics" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "mediaconvert" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "medialive" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "mediapackage" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "mediastore" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "metering.marketplace" : { - "defaults" : { - "credentialScope" : { - "service" : "aws-marketplace" - } - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "mgh" : { - "endpoints" : { - "us-west-2" : { } - } - }, - "mobileanalytics" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "models.lex" : { - "defaults" : { - "credentialScope" : { - "service" : "lex" - } - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "monitoring" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "mturk-requester" : { - "endpoints" : { - "sandbox" : { - "hostname" : "mturk-requester-sandbox.us-east-1.amazonaws.com" - }, - "us-east-1" : { } - }, - "isRegionalized" : false - }, - "neptune" : { - "endpoints" : { - "eu-west-1" : { - "credentialScope" : { - "region" : "eu-west-1" - }, - "hostname" : "rds.eu-west-1.amazonaws.com" - }, - "us-east-1" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "rds.us-east-1.amazonaws.com" - }, - "us-east-2" : { - "credentialScope" : { - "region" : "us-east-2" - }, - "hostname" : "rds.us-east-2.amazonaws.com" - }, - "us-west-2" : { - "credentialScope" : { - "region" : "us-west-2" - }, - "hostname" : "rds.us-west-2.amazonaws.com" - } - } - }, - "opsworks" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "opsworks-cm" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "organizations" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "organizations.us-east-1.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "pinpoint" : { - "defaults" : { - "credentialScope" : { - "service" : "mobiletargeting" - } - }, - "endpoints" : { - "us-east-1" : { } - } - }, - "polly" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "rds" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { - "sslCommonName" : "{service}.{dnsSuffix}" - }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "redshift" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "rekognition" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "resource-groups" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "route53" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "route53.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "route53domains" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "runtime.lex" : { - "defaults" : { - "credentialScope" : { - "service" : "lex" - } - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "runtime.sagemaker" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "s3" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "signatureVersions" : [ "s3v4" ] - }, - "endpoints" : { - "ap-northeast-1" : { - "hostname" : "s3.ap-northeast-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { - "hostname" : "s3.ap-southeast-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "ap-southeast-2" : { - "hostname" : "s3.ap-southeast-2.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { - "hostname" : "s3.eu-west-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "s3-external-1" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "s3-external-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "sa-east-1" : { - "hostname" : "s3.sa-east-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "us-east-1" : { - "hostname" : "s3.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "us-east-2" : { }, - "us-west-1" : { - "hostname" : "s3.us-west-1.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - }, - "us-west-2" : { - "hostname" : "s3.us-west-2.amazonaws.com", - "signatureVersions" : [ "s3", "s3v4" ] - } - }, - "isRegionalized" : true, - "partitionEndpoint" : "us-east-1" - }, - "sagemaker" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "sdb" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "signatureVersions" : [ "v2" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "sa-east-1" : { }, - "us-east-1" : { - "hostname" : "sdb.amazonaws.com" - }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "secretsmanager" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "serverlessrepo" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { - "protocols" : [ "https" ] - }, - "ap-northeast-2" : { - "protocols" : [ "https" ] - }, - "ap-south-1" : { - "protocols" : [ "https" ] - }, - "ap-southeast-1" : { - "protocols" : [ "https" ] - }, - "ap-southeast-2" : { - "protocols" : [ "https" ] - }, - "ca-central-1" : { - "protocols" : [ "https" ] - }, - "eu-central-1" : { - "protocols" : [ "https" ] - }, - "eu-west-1" : { - "protocols" : [ "https" ] - }, - "eu-west-2" : { - "protocols" : [ "https" ] - }, - "sa-east-1" : { - "protocols" : [ "https" ] - }, - "us-east-1" : { - "protocols" : [ "https" ] - }, - "us-east-2" : { - "protocols" : [ "https" ] - }, - "us-west-1" : { - "protocols" : [ "https" ] - }, - "us-west-2" : { - "protocols" : [ "https" ] - } - } - }, - "servicecatalog" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "servicediscovery" : { - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "shield" : { - "defaults" : { - "protocols" : [ "https" ], - "sslCommonName" : "Shield.us-east-1.amazonaws.com" - }, - "endpoints" : { - "us-east-1" : { } - }, - "isRegionalized" : false - }, - "sms" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "snowball" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "sns" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "sqs" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "sslCommonName" : "{region}.queue.{dnsSuffix}" - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "fips-us-east-1" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "sqs-fips.us-east-1.amazonaws.com" - }, - "fips-us-east-2" : { - "credentialScope" : { - "region" : "us-east-2" - }, - "hostname" : "sqs-fips.us-east-2.amazonaws.com" - }, - "fips-us-west-1" : { - "credentialScope" : { - "region" : "us-west-1" - }, - "hostname" : "sqs-fips.us-west-1.amazonaws.com" - }, - "fips-us-west-2" : { - "credentialScope" : { - "region" : "us-west-2" - }, - "hostname" : "sqs-fips.us-west-2.amazonaws.com" - }, - "sa-east-1" : { }, - "us-east-1" : { - "sslCommonName" : "queue.{dnsSuffix}" - }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "ssm" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "states" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "storagegateway" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "streams.dynamodb" : { - "defaults" : { - "credentialScope" : { - "service" : "dynamodb" - }, - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "local" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "localhost:8000", - "protocols" : [ "http" ] - }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "sts" : { - "defaults" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "sts.amazonaws.com" - }, - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { - "credentialScope" : { - "region" : "ap-northeast-2" - }, - "hostname" : "sts.ap-northeast-2.amazonaws.com" - }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "aws-global" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-1-fips" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "sts-fips.us-east-1.amazonaws.com" - }, - "us-east-2" : { }, - "us-east-2-fips" : { - "credentialScope" : { - "region" : "us-east-2" - }, - "hostname" : "sts-fips.us-east-2.amazonaws.com" - }, - "us-west-1" : { }, - "us-west-1-fips" : { - "credentialScope" : { - "region" : "us-west-1" - }, - "hostname" : "sts-fips.us-west-1.amazonaws.com" - }, - "us-west-2" : { }, - "us-west-2-fips" : { - "credentialScope" : { - "region" : "us-west-2" - }, - "hostname" : "sts-fips.us-west-2.amazonaws.com" - } - }, - "partitionEndpoint" : "aws-global" - }, - "support" : { - "endpoints" : { - "us-east-1" : { } - } - }, - "swf" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "tagging" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "eu-west-3" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "translate" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-2" : { } - } - }, - "waf" : { - "endpoints" : { - "aws-global" : { - "credentialScope" : { - "region" : "us-east-1" - }, - "hostname" : "waf.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-global" - }, - "waf-regional" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-2" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - }, - "workdocs" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "workmail" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "eu-west-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "workspaces" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-west-2" : { } - } - }, - "xray" : { - "endpoints" : { - "ap-northeast-1" : { }, - "ap-northeast-2" : { }, - "ap-south-1" : { }, - "ap-southeast-1" : { }, - "ap-southeast-2" : { }, - "ca-central-1" : { }, - "eu-central-1" : { }, - "eu-west-1" : { }, - "eu-west-2" : { }, - "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } - } - } - } - }, { - "defaults" : { - "hostname" : "{service}.{region}.{dnsSuffix}", - "protocols" : [ "https" ], - "signatureVersions" : [ "v4" ] - }, - "dnsSuffix" : "amazonaws.com.cn", - "partition" : "aws-cn", - "partitionName" : "AWS China", - "regionRegex" : "^cn\\-\\w+\\-\\d+$", - "regions" : { - "cn-north-1" : { - "description" : "China (Beijing)" - }, - "cn-northwest-1" : { - "description" : "China (Ningxia)" - } - }, - "services" : { - "apigateway" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "application-autoscaling" : { - "defaults" : { - "credentialScope" : { - "service" : "application-autoscaling" - }, - "hostname" : "autoscaling.{region}.amazonaws.com", - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "autoscaling" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "cloudformation" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "cloudtrail" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "codedeploy" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "cognito-identity" : { - "endpoints" : { - "cn-north-1" : { } - } - }, - "config" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "data.iot" : { - "defaults" : { - "credentialScope" : { - "service" : "iotdata" - }, - "protocols" : [ "https" ] - }, - "endpoints" : { - "cn-north-1" : { } - } - }, - "directconnect" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "ds" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "dynamodb" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "ec2" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "ecr" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "ecs" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "elasticache" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "elasticbeanstalk" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "elasticloadbalancing" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "elasticmapreduce" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "es" : { - "endpoints" : { - "cn-northwest-1" : { } - } - }, - "events" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "glacier" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "iam" : { - "endpoints" : { - "aws-cn-global" : { - "credentialScope" : { - "region" : "cn-north-1" - }, - "hostname" : "iam.cn-north-1.amazonaws.com.cn" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-cn-global" - }, - "iot" : { - "defaults" : { - "credentialScope" : { - "service" : "execute-api" - } - }, - "endpoints" : { - "cn-north-1" : { } - } - }, - "kinesis" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "lambda" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "logs" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "monitoring" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "rds" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "redshift" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "s3" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "signatureVersions" : [ "s3v4" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "sms" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "snowball" : { - "endpoints" : { - "cn-north-1" : { } - } - }, - "sns" : { - "defaults" : { - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "sqs" : { - "defaults" : { - "protocols" : [ "http", "https" ], - "sslCommonName" : "{region}.queue.{dnsSuffix}" - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "ssm" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "storagegateway" : { - "endpoints" : { - "cn-north-1" : { } - } - }, - "streams.dynamodb" : { - "defaults" : { - "credentialScope" : { - "service" : "dynamodb" - }, - "protocols" : [ "http", "https" ] - }, - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "sts" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "swf" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - }, - "tagging" : { - "endpoints" : { - "cn-north-1" : { }, - "cn-northwest-1" : { } - } - } - } - }, { - "defaults" : { - "hostname" : "{service}.{region}.{dnsSuffix}", - "protocols" : [ "https" ], - "signatureVersions" : [ "v4" ] - }, - "dnsSuffix" : "amazonaws.com", - "partition" : "aws-us-gov", - "partitionName" : "AWS GovCloud (US)", - "regionRegex" : "^us\\-gov\\-\\w+\\-\\d+$", - "regions" : { - "us-gov-west-1" : { - "description" : "AWS GovCloud (US)" - } - }, - "services" : { - "acm" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "apigateway" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "autoscaling" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ] - } - } - }, - "cloudformation" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "cloudhsm" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "cloudhsmv2" : { - "defaults" : { - "credentialScope" : { - "service" : "cloudhsm" - } - }, - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "cloudtrail" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "codedeploy" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "config" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "directconnect" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "dms" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "dynamodb" : { - "endpoints" : { - "us-gov-west-1" : { }, - "us-gov-west-1-fips" : { - "credentialScope" : { - "region" : "us-gov-west-1" - }, - "hostname" : "dynamodb.us-gov-west-1.amazonaws.com" - } - } - }, - "ec2" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "ecr" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "ecs" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "elasticache" : { - "endpoints" : { - "fips" : { - "credentialScope" : { - "region" : "us-gov-west-1" - }, - "hostname" : "elasticache-fips.us-gov-west-1.amazonaws.com" - }, - "us-gov-west-1" : { } - } - }, - "elasticbeanstalk" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "elasticloadbalancing" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ] - } - } - }, - "elasticmapreduce" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ] - } - } - }, - "es" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "events" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "glacier" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ] - } - } - }, - "iam" : { - "endpoints" : { - "aws-us-gov-global" : { - "credentialScope" : { - "region" : "us-gov-west-1" - }, - "hostname" : "iam.us-gov.amazonaws.com" - } - }, - "isRegionalized" : false, - "partitionEndpoint" : "aws-us-gov-global" - }, - "inspector" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "kinesis" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "kms" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "lambda" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "logs" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "metering.marketplace" : { - "defaults" : { - "credentialScope" : { - "service" : "aws-marketplace" - } - }, - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "monitoring" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "polly" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "rds" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "redshift" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "rekognition" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "s3" : { - "defaults" : { - "signatureVersions" : [ "s3", "s3v4" ] - }, - "endpoints" : { - "fips-us-gov-west-1" : { - "credentialScope" : { - "region" : "us-gov-west-1" - }, - "hostname" : "s3-fips-us-gov-west-1.amazonaws.com" - }, - "us-gov-west-1" : { - "hostname" : "s3.us-gov-west-1.amazonaws.com", - "protocols" : [ "http", "https" ] - } - } - }, - "sms" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "snowball" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "sns" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ] - } - } - }, - "sqs" : { - "endpoints" : { - "us-gov-west-1" : { - "protocols" : [ "http", "https" ], - "sslCommonName" : "{region}.queue.{dnsSuffix}" - } - } - }, - "ssm" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "states" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "storagegateway" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "streams.dynamodb" : { - "defaults" : { - "credentialScope" : { - "service" : "dynamodb" - } - }, - "endpoints" : { - "us-gov-west-1" : { }, - "us-gov-west-1-fips" : { - "credentialScope" : { - "region" : "us-gov-west-1" - }, - "hostname" : "dynamodb.us-gov-west-1.amazonaws.com" - } - } - }, - "sts" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "swf" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "tagging" : { - "endpoints" : { - "us-gov-west-1" : { } - } - }, - "translate" : { - "defaults" : { - "protocols" : [ "https" ] - }, - "endpoints" : { - "us-gov-west-1" : { } - } - } - } - } ], - "version" : 3 -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/paginators-1.json deleted file mode 100644 index b6fefece..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "ListElasticsearchInstanceTypes": { - "result_key": "ElasticsearchInstanceTypes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListElasticsearchVersions": { - "result_key": "ElasticsearchVersions", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/service-2.json deleted file mode 100644 index c799d582..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/es/2015-01-01/service-2.json +++ /dev/null @@ -1,1817 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-01-01", - "endpointPrefix":"es", - "protocol":"rest-json", - "serviceFullName":"Amazon Elasticsearch Service", - "serviceId":"Elasticsearch Service", - "signatureVersion":"v4", - "uid":"es-2015-01-01" - }, - "operations":{ - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/tags" - }, - "input":{"shape":"AddTagsRequest"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"LimitExceededException"}, - {"shape":"ValidationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Attaches tags to an existing Elasticsearch domain. Tags are a set of case-sensitive key value pairs. An Elasticsearch domain may have up to 10 tags. See Tagging Amazon Elasticsearch Service Domains for more information.

" - }, - "CreateElasticsearchDomain":{ - "name":"CreateElasticsearchDomain", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/es/domain" - }, - "input":{"shape":"CreateElasticsearchDomainRequest"}, - "output":{"shape":"CreateElasticsearchDomainResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"DisabledOperationException"}, - {"shape":"InternalException"}, - {"shape":"InvalidTypeException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Creates a new Elasticsearch domain. For more information, see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide.

" - }, - "DeleteElasticsearchDomain":{ - "name":"DeleteElasticsearchDomain", - "http":{ - "method":"DELETE", - "requestUri":"/2015-01-01/es/domain/{DomainName}" - }, - "input":{"shape":"DeleteElasticsearchDomainRequest"}, - "output":{"shape":"DeleteElasticsearchDomainResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Permanently deletes the specified Elasticsearch domain and all of its data. Once a domain is deleted, it cannot be recovered.

" - }, - "DeleteElasticsearchServiceRole":{ - "name":"DeleteElasticsearchServiceRole", - "http":{ - "method":"DELETE", - "requestUri":"/2015-01-01/es/role" - }, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Deletes the service-linked role that Elasticsearch Service uses to manage and maintain VPC domains. Role deletion will fail if any existing VPC domains use the role. You must delete any such Elasticsearch domains before deleting the role. See Deleting Elasticsearch Service Role in VPC Endpoints for Amazon Elasticsearch Service Domains.

" - }, - "DescribeElasticsearchDomain":{ - "name":"DescribeElasticsearchDomain", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/domain/{DomainName}" - }, - "input":{"shape":"DescribeElasticsearchDomainRequest"}, - "output":{"shape":"DescribeElasticsearchDomainResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Returns domain configuration information about the specified Elasticsearch domain, including the domain ID, domain endpoint, and domain ARN.

" - }, - "DescribeElasticsearchDomainConfig":{ - "name":"DescribeElasticsearchDomainConfig", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/domain/{DomainName}/config" - }, - "input":{"shape":"DescribeElasticsearchDomainConfigRequest"}, - "output":{"shape":"DescribeElasticsearchDomainConfigResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Provides cluster configuration information about the specified Elasticsearch domain, such as the state, creation date, update version, and update date for cluster options.

" - }, - "DescribeElasticsearchDomains":{ - "name":"DescribeElasticsearchDomains", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/es/domain-info" - }, - "input":{"shape":"DescribeElasticsearchDomainsRequest"}, - "output":{"shape":"DescribeElasticsearchDomainsResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Returns domain configuration information about the specified Elasticsearch domains, including the domain ID, domain endpoint, and domain ARN.

" - }, - "DescribeElasticsearchInstanceTypeLimits":{ - "name":"DescribeElasticsearchInstanceTypeLimits", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/instanceTypeLimits/{ElasticsearchVersion}/{InstanceType}" - }, - "input":{"shape":"DescribeElasticsearchInstanceTypeLimitsRequest"}, - "output":{"shape":"DescribeElasticsearchInstanceTypeLimitsResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"InvalidTypeException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Describe Elasticsearch Limits for a given InstanceType and ElasticsearchVersion. When modifying existing Domain, specify the DomainName to know what Limits are supported for modifying.

" - }, - "DescribeReservedElasticsearchInstanceOfferings":{ - "name":"DescribeReservedElasticsearchInstanceOfferings", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/reservedInstanceOfferings" - }, - "input":{"shape":"DescribeReservedElasticsearchInstanceOfferingsRequest"}, - "output":{"shape":"DescribeReservedElasticsearchInstanceOfferingsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"DisabledOperationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Lists available reserved Elasticsearch instance offerings.

" - }, - "DescribeReservedElasticsearchInstances":{ - "name":"DescribeReservedElasticsearchInstances", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/reservedInstances" - }, - "input":{"shape":"DescribeReservedElasticsearchInstancesRequest"}, - "output":{"shape":"DescribeReservedElasticsearchInstancesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalException"}, - {"shape":"ValidationException"}, - {"shape":"DisabledOperationException"} - ], - "documentation":"

Returns information about reserved Elasticsearch instances for this account.

" - }, - "ListDomainNames":{ - "name":"ListDomainNames", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/domain" - }, - "output":{"shape":"ListDomainNamesResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Returns the name of all Elasticsearch domains owned by the current user's account.

" - }, - "ListElasticsearchInstanceTypes":{ - "name":"ListElasticsearchInstanceTypes", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/instanceTypes/{ElasticsearchVersion}" - }, - "input":{"shape":"ListElasticsearchInstanceTypesRequest"}, - "output":{"shape":"ListElasticsearchInstanceTypesResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

List all Elasticsearch instance types that are supported for given ElasticsearchVersion

" - }, - "ListElasticsearchVersions":{ - "name":"ListElasticsearchVersions", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/es/versions" - }, - "input":{"shape":"ListElasticsearchVersionsRequest"}, - "output":{"shape":"ListElasticsearchVersionsResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

List all supported Elasticsearch versions

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"GET", - "requestUri":"/2015-01-01/tags/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Returns all tags for the given Elasticsearch domain.

" - }, - "PurchaseReservedElasticsearchInstanceOffering":{ - "name":"PurchaseReservedElasticsearchInstanceOffering", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/es/purchaseReservedInstanceOffering" - }, - "input":{"shape":"PurchaseReservedElasticsearchInstanceOfferingRequest"}, - "output":{"shape":"PurchaseReservedElasticsearchInstanceOfferingResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"DisabledOperationException"}, - {"shape":"ValidationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Allows you to purchase reserved Elasticsearch instances.

" - }, - "RemoveTags":{ - "name":"RemoveTags", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/tags-removal" - }, - "input":{"shape":"RemoveTagsRequest"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"ValidationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Removes the specified set of tags from the specified Elasticsearch domain.

" - }, - "UpdateElasticsearchDomainConfig":{ - "name":"UpdateElasticsearchDomainConfig", - "http":{ - "method":"POST", - "requestUri":"/2015-01-01/es/domain/{DomainName}/config" - }, - "input":{"shape":"UpdateElasticsearchDomainConfigRequest"}, - "output":{"shape":"UpdateElasticsearchDomainConfigResponse"}, - "errors":[ - {"shape":"BaseException"}, - {"shape":"InternalException"}, - {"shape":"InvalidTypeException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Modifies the cluster configuration of the specified Elasticsearch domain, setting as setting the instance type and the number of instances.

" - } - }, - "shapes":{ - "ARN":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN) of the Elasticsearch domain. See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.

" - }, - "AccessPoliciesStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"PolicyDocument", - "documentation":"

The access policy configured for the Elasticsearch domain. Access policies may be resource-based, IP-based, or IAM-based. See Configuring Access Policiesfor more information.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

The status of the access policy for the Elasticsearch domain. See OptionStatus for the status information that's included.

" - } - }, - "documentation":"

The configured access rules for the domain's document and search endpoints, and the current status of those rules.

" - }, - "AddTagsRequest":{ - "type":"structure", - "required":[ - "ARN", - "TagList" - ], - "members":{ - "ARN":{ - "shape":"ARN", - "documentation":"

Specify the ARN for which you want to add the tags.

" - }, - "TagList":{ - "shape":"TagList", - "documentation":"

List of Tag that need to be added for the Elasticsearch domain.

" - } - }, - "documentation":"

Container for the parameters to the AddTags operation. Specify the tags that you want to attach to the Elasticsearch domain.

" - }, - "AdditionalLimit":{ - "type":"structure", - "members":{ - "LimitName":{ - "shape":"LimitName", - "documentation":"

Name of Additional Limit is specific to a given InstanceType and for each of it's InstanceRole etc.
Attributes and their details:

  • MaximumNumberOfDataNodesSupported
  • This attribute will be present in Master node only to specify how much data nodes upto which given ESPartitionInstanceType can support as master node.
  • MaximumNumberOfDataNodesWithoutMasterNode
  • This attribute will be present in Data node only to specify how much data nodes of given ESPartitionInstanceType upto which you don't need any master nodes to govern them.

" - }, - "LimitValues":{ - "shape":"LimitValueList", - "documentation":"

Value for given AdditionalLimit$LimitName .

" - } - }, - "documentation":"

List of limits that are specific to a given InstanceType and for each of it's InstanceRole .

" - }, - "AdditionalLimitList":{ - "type":"list", - "member":{"shape":"AdditionalLimit"} - }, - "AdvancedOptions":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"}, - "documentation":"

Exposes select native Elasticsearch configuration values from elasticsearch.yml. Currently, the following advanced options are available:

  • Option to allow references to indices in an HTTP request body. Must be false when configuring access to individual sub-resources. By default, the value is true. See Configuration Advanced Options for more information.
  • Option to specify the percentage of heap space that is allocated to field data. By default, this setting is unbounded.

For more information, see Configuring Advanced Options.

" - }, - "AdvancedOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"AdvancedOptions", - "documentation":"

Specifies the status of advanced options for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of OptionStatus for advanced options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the advanced options for the specified Elasticsearch domain. Currently, the following advanced options are available:

  • Option to allow references to indices in an HTTP request body. Must be false when configuring access to individual sub-resources. By default, the value is true. See Configuration Advanced Options for more information.
  • Option to specify the percentage of heap space that is allocated to field data. By default, this setting is unbounded.

For more information, see Configuring Advanced Options.

" - }, - "BaseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description of the error.

" - } - }, - "documentation":"

An error occurred while processing the request.

", - "exception":true - }, - "Boolean":{"type":"boolean"}, - "CloudWatchLogsLogGroupArn":{ - "type":"string", - "documentation":"

ARN of the Cloudwatch log group to which log needs to be published.

" - }, - "CognitoOptions":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Specifies the option to enable Cognito for Kibana authentication.

" - }, - "UserPoolId":{ - "shape":"UserPoolId", - "documentation":"

Specifies the Cognito user pool ID for Kibana authentication.

" - }, - "IdentityPoolId":{ - "shape":"IdentityPoolId", - "documentation":"

Specifies the Cognito identity pool ID for Kibana authentication.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

Specifies the role ARN that provides Elasticsearch permissions for accessing Cognito resources.

" - } - }, - "documentation":"

Options to specify the Cognito user and identity pools for Kibana authentication. For more information, see Amazon Cognito Authentication for Kibana.

" - }, - "CognitoOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"CognitoOptions", - "documentation":"

Specifies the Cognito options for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the Cognito options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the Cognito options for the specified Elasticsearch domain.

" - }, - "CreateElasticsearchDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the Elasticsearch domain that you are creating. Domain names are unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

" - }, - "ElasticsearchVersion":{ - "shape":"ElasticsearchVersionString", - "documentation":"

String of format X.Y to specify version for the Elasticsearch domain eg. \"1.5\" or \"2.3\". For more information, see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide.

" - }, - "ElasticsearchClusterConfig":{ - "shape":"ElasticsearchClusterConfig", - "documentation":"

Configuration options for an Elasticsearch domain. Specifies the instance type and number of instances in the domain cluster.

" - }, - "EBSOptions":{ - "shape":"EBSOptions", - "documentation":"

Options to enable, disable and specify the type and size of EBS storage volumes.

" - }, - "AccessPolicies":{ - "shape":"PolicyDocument", - "documentation":"

IAM access policy as a JSON-formatted string.

" - }, - "SnapshotOptions":{ - "shape":"SnapshotOptions", - "documentation":"

Option to set time, in UTC format, of the daily automated snapshot. Default value is 0 hours.

" - }, - "VPCOptions":{ - "shape":"VPCOptions", - "documentation":"

Options to specify the subnets and security groups for VPC endpoint. For more information, see Creating a VPC in VPC Endpoints for Amazon Elasticsearch Service Domains

" - }, - "CognitoOptions":{ - "shape":"CognitoOptions", - "documentation":"

Options to specify the Cognito user and identity pools for Kibana authentication. For more information, see Amazon Cognito Authentication for Kibana.

" - }, - "EncryptionAtRestOptions":{ - "shape":"EncryptionAtRestOptions", - "documentation":"

Specifies the Encryption At Rest Options.

" - }, - "AdvancedOptions":{ - "shape":"AdvancedOptions", - "documentation":"

Option to allow references to indices in an HTTP request body. Must be false when configuring access to individual sub-resources. By default, the value is true. See Configuration Advanced Options for more information.

" - }, - "LogPublishingOptions":{ - "shape":"LogPublishingOptions", - "documentation":"

Map of LogType and LogPublishingOption, each containing options to publish a given type of Elasticsearch log.

" - } - } - }, - "CreateElasticsearchDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{ - "shape":"ElasticsearchDomainStatus", - "documentation":"

The status of the newly created Elasticsearch domain.

" - } - }, - "documentation":"

The result of a CreateElasticsearchDomain operation. Contains the status of the newly created Elasticsearch domain.

" - }, - "DeleteElasticsearchDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the Elasticsearch domain that you want to permanently delete.

", - "location":"uri", - "locationName":"DomainName" - } - }, - "documentation":"

Container for the parameters to the DeleteElasticsearchDomain operation. Specifies the name of the Elasticsearch domain that you want to delete.

" - }, - "DeleteElasticsearchDomainResponse":{ - "type":"structure", - "members":{ - "DomainStatus":{ - "shape":"ElasticsearchDomainStatus", - "documentation":"

The status of the Elasticsearch domain being deleted.

" - } - }, - "documentation":"

The result of a DeleteElasticsearchDomain request. Contains the status of the pending deletion, or no status if the domain and all of its resources have been deleted.

" - }, - "DescribeElasticsearchDomainConfigRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The Elasticsearch domain that you want to get information about.

", - "location":"uri", - "locationName":"DomainName" - } - }, - "documentation":"

Container for the parameters to the DescribeElasticsearchDomainConfig operation. Specifies the domain name for which you want configuration information.

" - }, - "DescribeElasticsearchDomainConfigResponse":{ - "type":"structure", - "required":["DomainConfig"], - "members":{ - "DomainConfig":{ - "shape":"ElasticsearchDomainConfig", - "documentation":"

The configuration information of the domain requested in the DescribeElasticsearchDomainConfig request.

" - } - }, - "documentation":"

The result of a DescribeElasticsearchDomainConfig request. Contains the configuration information of the requested domain.

" - }, - "DescribeElasticsearchDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the Elasticsearch domain for which you want information.

", - "location":"uri", - "locationName":"DomainName" - } - }, - "documentation":"

Container for the parameters to the DescribeElasticsearchDomain operation.

" - }, - "DescribeElasticsearchDomainResponse":{ - "type":"structure", - "required":["DomainStatus"], - "members":{ - "DomainStatus":{ - "shape":"ElasticsearchDomainStatus", - "documentation":"

The current status of the Elasticsearch domain.

" - } - }, - "documentation":"

The result of a DescribeElasticsearchDomain request. Contains the status of the domain specified in the request.

" - }, - "DescribeElasticsearchDomainsRequest":{ - "type":"structure", - "required":["DomainNames"], - "members":{ - "DomainNames":{ - "shape":"DomainNameList", - "documentation":"

The Elasticsearch domains for which you want information.

" - } - }, - "documentation":"

Container for the parameters to the DescribeElasticsearchDomains operation. By default, the API returns the status of all Elasticsearch domains.

" - }, - "DescribeElasticsearchDomainsResponse":{ - "type":"structure", - "required":["DomainStatusList"], - "members":{ - "DomainStatusList":{ - "shape":"ElasticsearchDomainStatusList", - "documentation":"

The status of the domains requested in the DescribeElasticsearchDomains request.

" - } - }, - "documentation":"

The result of a DescribeElasticsearchDomains request. Contains the status of the specified domains or all domains owned by the account.

" - }, - "DescribeElasticsearchInstanceTypeLimitsRequest":{ - "type":"structure", - "required":[ - "InstanceType", - "ElasticsearchVersion" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

DomainName represents the name of the Domain that we are trying to modify. This should be present only if we are querying for Elasticsearch Limits for existing domain.

", - "location":"querystring", - "locationName":"domainName" - }, - "InstanceType":{ - "shape":"ESPartitionInstanceType", - "documentation":"

The instance type for an Elasticsearch cluster for which Elasticsearch Limits are needed.

", - "location":"uri", - "locationName":"InstanceType" - }, - "ElasticsearchVersion":{ - "shape":"ElasticsearchVersionString", - "documentation":"

Version of Elasticsearch for which Limits are needed.

", - "location":"uri", - "locationName":"ElasticsearchVersion" - } - }, - "documentation":"

Container for the parameters to DescribeElasticsearchInstanceTypeLimits operation.

" - }, - "DescribeElasticsearchInstanceTypeLimitsResponse":{ - "type":"structure", - "members":{ - "LimitsByRole":{"shape":"LimitsByRole"} - }, - "documentation":"

Container for the parameters received from DescribeElasticsearchInstanceTypeLimits operation.

" - }, - "DescribeReservedElasticsearchInstanceOfferingsRequest":{ - "type":"structure", - "members":{ - "ReservedElasticsearchInstanceOfferingId":{ - "shape":"GUID", - "documentation":"

The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.

", - "location":"querystring", - "locationName":"offeringId" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Set this value to limit the number of results returned. If not specified, defaults to 100.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken should be sent in case if earlier API call produced result containing NextToken. It is used for pagination.

", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Container for parameters to DescribeReservedElasticsearchInstanceOfferings

" - }, - "DescribeReservedElasticsearchInstanceOfferingsResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedElasticsearchInstanceOfferings":{ - "shape":"ReservedElasticsearchInstanceOfferingList", - "documentation":"

List of reserved Elasticsearch instance offerings

" - } - }, - "documentation":"

Container for results from DescribeReservedElasticsearchInstanceOfferings

" - }, - "DescribeReservedElasticsearchInstancesRequest":{ - "type":"structure", - "members":{ - "ReservedElasticsearchInstanceId":{ - "shape":"GUID", - "documentation":"

The reserved instance identifier filter value. Use this parameter to show only the reservation that matches the specified reserved Elasticsearch instance ID.

", - "location":"querystring", - "locationName":"reservationId" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Set this value to limit the number of results returned. If not specified, defaults to 100.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken should be sent in case if earlier API call produced result containing NextToken. It is used for pagination.

", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Container for parameters to DescribeReservedElasticsearchInstances

" - }, - "DescribeReservedElasticsearchInstancesResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

Provides an identifier to allow retrieval of paginated results.

" - }, - "ReservedElasticsearchInstances":{ - "shape":"ReservedElasticsearchInstanceList", - "documentation":"

List of reserved Elasticsearch instances.

" - } - }, - "documentation":"

Container for results from DescribeReservedElasticsearchInstances

" - }, - "DisabledOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An error occured because the client wanted to access a not supported operation. Gives http status code of 409.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DomainId":{ - "type":"string", - "documentation":"

Unique identifier for an Elasticsearch domain.

", - "max":64, - "min":1 - }, - "DomainInfo":{ - "type":"structure", - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

Specifies the DomainName.

" - } - } - }, - "DomainInfoList":{ - "type":"list", - "member":{"shape":"DomainInfo"}, - "documentation":"

Contains the list of Elasticsearch domain information.

" - }, - "DomainName":{ - "type":"string", - "documentation":"

The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

", - "max":28, - "min":3, - "pattern":"[a-z][a-z0-9\\-]+" - }, - "DomainNameList":{ - "type":"list", - "member":{"shape":"DomainName"}, - "documentation":"

A list of Elasticsearch domain names.

" - }, - "Double":{"type":"double"}, - "EBSOptions":{ - "type":"structure", - "members":{ - "EBSEnabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether EBS-based storage is enabled.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

Specifies the volume type for EBS-based storage.

" - }, - "VolumeSize":{ - "shape":"IntegerClass", - "documentation":"

Integer to specify the size of an EBS volume.

" - }, - "Iops":{ - "shape":"IntegerClass", - "documentation":"

Specifies the IOPD for a Provisioned IOPS EBS volume (SSD).

" - } - }, - "documentation":"

Options to enable, disable, and specify the properties of EBS storage volumes. For more information, see Configuring EBS-based Storage.

" - }, - "EBSOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"EBSOptions", - "documentation":"

Specifies the EBS options for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the EBS options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the EBS options for the specified Elasticsearch domain.

" - }, - "ESPartitionInstanceType":{ - "type":"string", - "enum":[ - "m3.medium.elasticsearch", - "m3.large.elasticsearch", - "m3.xlarge.elasticsearch", - "m3.2xlarge.elasticsearch", - "m4.large.elasticsearch", - "m4.xlarge.elasticsearch", - "m4.2xlarge.elasticsearch", - "m4.4xlarge.elasticsearch", - "m4.10xlarge.elasticsearch", - "t2.micro.elasticsearch", - "t2.small.elasticsearch", - "t2.medium.elasticsearch", - "r3.large.elasticsearch", - "r3.xlarge.elasticsearch", - "r3.2xlarge.elasticsearch", - "r3.4xlarge.elasticsearch", - "r3.8xlarge.elasticsearch", - "i2.xlarge.elasticsearch", - "i2.2xlarge.elasticsearch", - "d2.xlarge.elasticsearch", - "d2.2xlarge.elasticsearch", - "d2.4xlarge.elasticsearch", - "d2.8xlarge.elasticsearch", - "c4.large.elasticsearch", - "c4.xlarge.elasticsearch", - "c4.2xlarge.elasticsearch", - "c4.4xlarge.elasticsearch", - "c4.8xlarge.elasticsearch", - "r4.large.elasticsearch", - "r4.xlarge.elasticsearch", - "r4.2xlarge.elasticsearch", - "r4.4xlarge.elasticsearch", - "r4.8xlarge.elasticsearch", - "r4.16xlarge.elasticsearch", - "i3.large.elasticsearch", - "i3.xlarge.elasticsearch", - "i3.2xlarge.elasticsearch", - "i3.4xlarge.elasticsearch", - "i3.8xlarge.elasticsearch", - "i3.16xlarge.elasticsearch" - ] - }, - "ElasticsearchClusterConfig":{ - "type":"structure", - "members":{ - "InstanceType":{ - "shape":"ESPartitionInstanceType", - "documentation":"

The instance type for an Elasticsearch cluster.

" - }, - "InstanceCount":{ - "shape":"IntegerClass", - "documentation":"

The number of instances in the specified domain cluster.

" - }, - "DedicatedMasterEnabled":{ - "shape":"Boolean", - "documentation":"

A boolean value to indicate whether a dedicated master node is enabled. See About Dedicated Master Nodes for more information.

" - }, - "ZoneAwarenessEnabled":{ - "shape":"Boolean", - "documentation":"

A boolean value to indicate whether zone awareness is enabled. See About Zone Awareness for more information.

" - }, - "DedicatedMasterType":{ - "shape":"ESPartitionInstanceType", - "documentation":"

The instance type for a dedicated master node.

" - }, - "DedicatedMasterCount":{ - "shape":"IntegerClass", - "documentation":"

Total number of dedicated master nodes, active and on standby, for the cluster.

" - } - }, - "documentation":"

Specifies the configuration for the domain cluster, such as the type and number of instances.

" - }, - "ElasticsearchClusterConfigStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"ElasticsearchClusterConfig", - "documentation":"

Specifies the cluster configuration for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the configuration for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Specifies the configuration status for the specified Elasticsearch domain.

" - }, - "ElasticsearchDomainConfig":{ - "type":"structure", - "members":{ - "ElasticsearchVersion":{ - "shape":"ElasticsearchVersionStatus", - "documentation":"

String of format X.Y to specify version for the Elasticsearch domain.

" - }, - "ElasticsearchClusterConfig":{ - "shape":"ElasticsearchClusterConfigStatus", - "documentation":"

Specifies the ElasticsearchClusterConfig for the Elasticsearch domain.

" - }, - "EBSOptions":{ - "shape":"EBSOptionsStatus", - "documentation":"

Specifies the EBSOptions for the Elasticsearch domain.

" - }, - "AccessPolicies":{ - "shape":"AccessPoliciesStatus", - "documentation":"

IAM access policy as a JSON-formatted string.

" - }, - "SnapshotOptions":{ - "shape":"SnapshotOptionsStatus", - "documentation":"

Specifies the SnapshotOptions for the Elasticsearch domain.

" - }, - "VPCOptions":{ - "shape":"VPCDerivedInfoStatus", - "documentation":"

The VPCOptions for the specified domain. For more information, see VPC Endpoints for Amazon Elasticsearch Service Domains.

" - }, - "CognitoOptions":{ - "shape":"CognitoOptionsStatus", - "documentation":"

The CognitoOptions for the specified domain. For more information, see Amazon Cognito Authentication for Kibana.

" - }, - "EncryptionAtRestOptions":{ - "shape":"EncryptionAtRestOptionsStatus", - "documentation":"

Specifies the EncryptionAtRestOptions for the Elasticsearch domain.

" - }, - "AdvancedOptions":{ - "shape":"AdvancedOptionsStatus", - "documentation":"

Specifies the AdvancedOptions for the domain. See Configuring Advanced Options for more information.

" - }, - "LogPublishingOptions":{ - "shape":"LogPublishingOptionsStatus", - "documentation":"

Log publishing options for the given domain.

" - } - }, - "documentation":"

The configuration of an Elasticsearch domain.

" - }, - "ElasticsearchDomainStatus":{ - "type":"structure", - "required":[ - "DomainId", - "DomainName", - "ARN", - "ElasticsearchClusterConfig" - ], - "members":{ - "DomainId":{ - "shape":"DomainId", - "documentation":"

The unique identifier for the specified Elasticsearch domain.

" - }, - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

" - }, - "ARN":{ - "shape":"ARN", - "documentation":"

The Amazon resource name (ARN) of an Elasticsearch domain. See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.

" - }, - "Created":{ - "shape":"Boolean", - "documentation":"

The domain creation status. True if the creation of an Elasticsearch domain is complete. False if domain creation is still in progress.

" - }, - "Deleted":{ - "shape":"Boolean", - "documentation":"

The domain deletion status. True if a delete request has been received for the domain but resource cleanup is still in progress. False if the domain has not been deleted. Once domain deletion is complete, the status of the domain is no longer returned.

" - }, - "Endpoint":{ - "shape":"ServiceUrl", - "documentation":"

The Elasticsearch domain endpoint that you use to submit index and search requests.

" - }, - "Endpoints":{ - "shape":"EndpointsMap", - "documentation":"

Map containing the Elasticsearch domain endpoints used to submit index and search requests. Example key, value: 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com'.

" - }, - "Processing":{ - "shape":"Boolean", - "documentation":"

The status of the Elasticsearch domain configuration. True if Amazon Elasticsearch Service is processing configuration changes. False if the configuration is active.

" - }, - "ElasticsearchVersion":{"shape":"ElasticsearchVersionString"}, - "ElasticsearchClusterConfig":{ - "shape":"ElasticsearchClusterConfig", - "documentation":"

The type and number of instances in the domain cluster.

" - }, - "EBSOptions":{ - "shape":"EBSOptions", - "documentation":"

The EBSOptions for the specified domain. See Configuring EBS-based Storage for more information.

" - }, - "AccessPolicies":{ - "shape":"PolicyDocument", - "documentation":"

IAM access policy as a JSON-formatted string.

" - }, - "SnapshotOptions":{ - "shape":"SnapshotOptions", - "documentation":"

Specifies the status of the SnapshotOptions

" - }, - "VPCOptions":{ - "shape":"VPCDerivedInfo", - "documentation":"

The VPCOptions for the specified domain. For more information, see VPC Endpoints for Amazon Elasticsearch Service Domains.

" - }, - "CognitoOptions":{ - "shape":"CognitoOptions", - "documentation":"

The CognitoOptions for the specified domain. For more information, see Amazon Cognito Authentication for Kibana.

" - }, - "EncryptionAtRestOptions":{ - "shape":"EncryptionAtRestOptions", - "documentation":"

Specifies the status of the EncryptionAtRestOptions.

" - }, - "AdvancedOptions":{ - "shape":"AdvancedOptions", - "documentation":"

Specifies the status of the AdvancedOptions

" - }, - "LogPublishingOptions":{ - "shape":"LogPublishingOptions", - "documentation":"

Log publishing options for the given domain.

" - } - }, - "documentation":"

The current status of an Elasticsearch domain.

" - }, - "ElasticsearchDomainStatusList":{ - "type":"list", - "member":{"shape":"ElasticsearchDomainStatus"}, - "documentation":"

A list that contains the status of each requested Elasticsearch domain.

" - }, - "ElasticsearchInstanceTypeList":{ - "type":"list", - "member":{"shape":"ESPartitionInstanceType"}, - "documentation":"

List of instance types supported by Amazon Elasticsearch service.

" - }, - "ElasticsearchVersionList":{ - "type":"list", - "member":{"shape":"ElasticsearchVersionString"}, - "documentation":"

List of supported elastic search versions.

" - }, - "ElasticsearchVersionStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"ElasticsearchVersionString", - "documentation":"

Specifies the Elasticsearch version for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the Elasticsearch version options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the Elasticsearch version options for the specified Elasticsearch domain.

" - }, - "ElasticsearchVersionString":{"type":"string"}, - "EncryptionAtRestOptions":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Specifies the option to enable Encryption At Rest.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

Specifies the KMS Key ID for Encryption At Rest options.

" - } - }, - "documentation":"

Specifies the Encryption At Rest Options.

" - }, - "EncryptionAtRestOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"EncryptionAtRestOptions", - "documentation":"

Specifies the Encryption At Rest options for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the Encryption At Rest options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the Encryption At Rest options for the specified Elasticsearch domain.

" - }, - "EndpointsMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"ServiceUrl"} - }, - "ErrorMessage":{"type":"string"}, - "GUID":{ - "type":"string", - "pattern":"\\p{XDigit}{8}-\\p{XDigit}{4}-\\p{XDigit}{4}-\\p{XDigit}{4}-\\p{XDigit}{12}" - }, - "IdentityPoolId":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+:[0-9a-f-]+" - }, - "InstanceCount":{ - "type":"integer", - "documentation":"

Specifies the number of EC2 instances in the Elasticsearch domain.

", - "min":1 - }, - "InstanceCountLimits":{ - "type":"structure", - "members":{ - "MinimumInstanceCount":{"shape":"MinimumInstanceCount"}, - "MaximumInstanceCount":{"shape":"MaximumInstanceCount"} - }, - "documentation":"

InstanceCountLimits represents the limits on number of instances that be created in Amazon Elasticsearch for given InstanceType.

" - }, - "InstanceLimits":{ - "type":"structure", - "members":{ - "InstanceCountLimits":{"shape":"InstanceCountLimits"} - }, - "documentation":"

InstanceLimits represents the list of instance related attributes that are available for given InstanceType.

" - }, - "InstanceRole":{"type":"string"}, - "Integer":{"type":"integer"}, - "IntegerClass":{"type":"integer"}, - "InternalException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request processing has failed because of an unknown error, exception or failure (the failure is internal to the service) . Gives http status code of 500.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "InvalidTypeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An exception for trying to create or access sub-resource that is either invalid or not supported. Gives http status code of 409.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "KmsKeyId":{ - "type":"string", - "max":500, - "min":1 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An exception for trying to create more than allowed resources or sub-resources. Gives http status code of 409.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "LimitName":{"type":"string"}, - "LimitValue":{"type":"string"}, - "LimitValueList":{ - "type":"list", - "member":{"shape":"LimitValue"} - }, - "Limits":{ - "type":"structure", - "members":{ - "StorageTypes":{ - "shape":"StorageTypeList", - "documentation":"

StorageType represents the list of storage related types and attributes that are available for given InstanceType.

" - }, - "InstanceLimits":{"shape":"InstanceLimits"}, - "AdditionalLimits":{ - "shape":"AdditionalLimitList", - "documentation":"

List of additional limits that are specific to a given InstanceType and for each of it's InstanceRole .

" - } - }, - "documentation":"

Limits for given InstanceType and for each of it's role.
Limits contains following StorageTypes, InstanceLimits and AdditionalLimits

" - }, - "LimitsByRole":{ - "type":"map", - "key":{"shape":"InstanceRole"}, - "value":{"shape":"Limits"}, - "documentation":"

Map of Role of the Instance and Limits that are applicable. Role performed by given Instance in Elasticsearch can be one of the following:

  • Data: If the given InstanceType is used as Data node
  • Master: If the given InstanceType is used as Master node

" - }, - "ListDomainNamesResponse":{ - "type":"structure", - "members":{ - "DomainNames":{ - "shape":"DomainInfoList", - "documentation":"

List of Elasticsearch domain names.

" - } - }, - "documentation":"

The result of a ListDomainNames operation. Contains the names of all Elasticsearch domains owned by this account.

" - }, - "ListElasticsearchInstanceTypesRequest":{ - "type":"structure", - "required":["ElasticsearchVersion"], - "members":{ - "ElasticsearchVersion":{ - "shape":"ElasticsearchVersionString", - "documentation":"

Version of Elasticsearch for which list of supported elasticsearch instance types are needed.

", - "location":"uri", - "locationName":"ElasticsearchVersion" - }, - "DomainName":{ - "shape":"DomainName", - "documentation":"

DomainName represents the name of the Domain that we are trying to modify. This should be present only if we are querying for list of available Elasticsearch instance types when modifying existing domain.

", - "location":"querystring", - "locationName":"domainName" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Set this value to limit the number of results returned. Value provided must be greater than 30 else it wont be honored.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken should be sent in case if earlier API call produced result containing NextToken. It is used for pagination.

", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Container for the parameters to the ListElasticsearchInstanceTypes operation.

" - }, - "ListElasticsearchInstanceTypesResponse":{ - "type":"structure", - "members":{ - "ElasticsearchInstanceTypes":{ - "shape":"ElasticsearchInstanceTypeList", - "documentation":"

List of instance types supported by Amazon Elasticsearch service for given ElasticsearchVersion

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

In case if there are more results available NextToken would be present, make further request to the same API with received NextToken to paginate remaining results.

" - } - }, - "documentation":"

Container for the parameters returned by ListElasticsearchInstanceTypes operation.

" - }, - "ListElasticsearchVersionsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Set this value to limit the number of results returned. Value provided must be greater than 10 else it wont be honored.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Container for the parameters to the ListElasticsearchVersions operation.

Use MaxResults to control the maximum number of results to retrieve in a single call.

Use NextToken in response to retrieve more results. If the received response does not contain a NextToken, then there are no more results to retrieve.

" - }, - "ListElasticsearchVersionsResponse":{ - "type":"structure", - "members":{ - "ElasticsearchVersions":{"shape":"ElasticsearchVersionList"}, - "NextToken":{"shape":"NextToken"} - }, - "documentation":"

Container for the parameters for response received from ListElasticsearchVersions operation.

" - }, - "ListTagsRequest":{ - "type":"structure", - "required":["ARN"], - "members":{ - "ARN":{ - "shape":"ARN", - "documentation":"

Specify the ARN for the Elasticsearch domain to which the tags are attached that you want to view.

", - "location":"querystring", - "locationName":"arn" - } - }, - "documentation":"

Container for the parameters to the ListTags operation. Specify the ARN for the Elasticsearch domain to which the tags are attached that you want to view are attached.

" - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

List of Tag for the requested Elasticsearch domain.

" - } - }, - "documentation":"

The result of a ListTags operation. Contains tags for all requested Elasticsearch domains.

" - }, - "LogPublishingOption":{ - "type":"structure", - "members":{ - "CloudWatchLogsLogGroupArn":{"shape":"CloudWatchLogsLogGroupArn"}, - "Enabled":{ - "shape":"Boolean", - "documentation":"

Specifies whether given log publishing option is enabled or not.

" - } - }, - "documentation":"

Log Publishing option that is set for given domain.
Attributes and their details:

  • CloudWatchLogsLogGroupArn: ARN of the Cloudwatch log group to which log needs to be published.
  • Enabled: Whether the log publishing for given log type is enabled or not

" - }, - "LogPublishingOptions":{ - "type":"map", - "key":{"shape":"LogType"}, - "value":{"shape":"LogPublishingOption"} - }, - "LogPublishingOptionsStatus":{ - "type":"structure", - "members":{ - "Options":{ - "shape":"LogPublishingOptions", - "documentation":"

The log publishing options configured for the Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

The status of the log publishing options for the Elasticsearch domain. See OptionStatus for the status information that's included.

" - } - }, - "documentation":"

The configured log publishing options for the domain and their current status.

" - }, - "LogType":{ - "type":"string", - "documentation":"

Type of Log File, it can be one of the following:

  • INDEX_SLOW_LOGS: Index slow logs contain insert requests that took more time than configured index query log threshold to execute.
  • SEARCH_SLOW_LOGS: Search slow logs contain search queries that took more time than configured search query log threshold to execute.
  • ES_APPLICATION_LOGS: Elasticsearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.

", - "enum":[ - "INDEX_SLOW_LOGS", - "SEARCH_SLOW_LOGS", - "ES_APPLICATION_LOGS" - ] - }, - "MaxResults":{ - "type":"integer", - "documentation":"

Set this value to limit the number of results returned.

", - "max":100 - }, - "MaximumInstanceCount":{ - "type":"integer", - "documentation":"

Maximum number of Instances that can be instantiated for given InstanceType.

" - }, - "MinimumInstanceCount":{ - "type":"integer", - "documentation":"

Minimum number of Instances that can be instantiated for given InstanceType.

" - }, - "NextToken":{ - "type":"string", - "documentation":"

Paginated APIs accepts NextToken input to returns next page results and provides a NextToken output in the response which can be used by the client to retrieve more results.

" - }, - "OptionState":{ - "type":"string", - "documentation":"

The state of a requested change. One of the following:

  • Processing: The request change is still in-process.
  • Active: The request change is processed and deployed to the Elasticsearch domain.
", - "enum":[ - "RequiresIndexDocuments", - "Processing", - "Active" - ] - }, - "OptionStatus":{ - "type":"structure", - "required":[ - "CreationDate", - "UpdateDate", - "State" - ], - "members":{ - "CreationDate":{ - "shape":"UpdateTimestamp", - "documentation":"

Timestamp which tells the creation date for the entity.

" - }, - "UpdateDate":{ - "shape":"UpdateTimestamp", - "documentation":"

Timestamp which tells the last updated time for the entity.

" - }, - "UpdateVersion":{ - "shape":"UIntValue", - "documentation":"

Specifies the latest version for the entity.

" - }, - "State":{ - "shape":"OptionState", - "documentation":"

Provides the OptionState for the Elasticsearch domain.

" - }, - "PendingDeletion":{ - "shape":"Boolean", - "documentation":"

Indicates whether the Elasticsearch domain is being deleted.

" - } - }, - "documentation":"

Provides the current status of the entity.

" - }, - "PolicyDocument":{ - "type":"string", - "documentation":"

Access policy rules for an Elasticsearch domain service endpoints. For more information, see Configuring Access Policies in the Amazon Elasticsearch Service Developer Guide. The maximum size of a policy document is 100 KB.

" - }, - "PurchaseReservedElasticsearchInstanceOfferingRequest":{ - "type":"structure", - "required":[ - "ReservedElasticsearchInstanceOfferingId", - "ReservationName" - ], - "members":{ - "ReservedElasticsearchInstanceOfferingId":{ - "shape":"GUID", - "documentation":"

The ID of the reserved Elasticsearch instance offering to purchase.

" - }, - "ReservationName":{ - "shape":"ReservationToken", - "documentation":"

A customer-specified identifier to track this reservation.

" - }, - "InstanceCount":{ - "shape":"InstanceCount", - "documentation":"

The number of Elasticsearch instances to reserve.

" - } - }, - "documentation":"

Container for parameters to PurchaseReservedElasticsearchInstanceOffering

" - }, - "PurchaseReservedElasticsearchInstanceOfferingResponse":{ - "type":"structure", - "members":{ - "ReservedElasticsearchInstanceId":{ - "shape":"GUID", - "documentation":"

Details of the reserved Elasticsearch instance which was purchased.

" - }, - "ReservationName":{ - "shape":"ReservationToken", - "documentation":"

The customer-specified identifier used to track this reservation.

" - } - }, - "documentation":"

Represents the output of a PurchaseReservedElasticsearchInstanceOffering operation.

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The monetary amount of the recurring charge.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency of the recurring charge.

" - } - }, - "documentation":"

Contains the specific price and frequency of a recurring charges for a reserved Elasticsearch instance, or for a reserved Elasticsearch instance offering.

" - }, - "RecurringChargeList":{ - "type":"list", - "member":{"shape":"RecurringCharge"} - }, - "RemoveTagsRequest":{ - "type":"structure", - "required":[ - "ARN", - "TagKeys" - ], - "members":{ - "ARN":{ - "shape":"ARN", - "documentation":"

Specifies the ARN for the Elasticsearch domain from which you want to delete the specified tags.

" - }, - "TagKeys":{ - "shape":"StringList", - "documentation":"

Specifies the TagKey list which you want to remove from the Elasticsearch domain.

" - } - }, - "documentation":"

Container for the parameters to the RemoveTags operation. Specify the ARN for the Elasticsearch domain from which you want to remove the specified TagKey.

" - }, - "ReservationToken":{ - "type":"string", - "max":64, - "min":5 - }, - "ReservedElasticsearchInstance":{ - "type":"structure", - "members":{ - "ReservationName":{ - "shape":"ReservationToken", - "documentation":"

The customer-specified identifier to track this reservation.

" - }, - "ReservedElasticsearchInstanceId":{ - "shape":"GUID", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedElasticsearchInstanceOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "ElasticsearchInstanceType":{ - "shape":"ESPartitionInstanceType", - "documentation":"

The Elasticsearch instance type offered by the reserved instance offering.

" - }, - "StartTime":{ - "shape":"UpdateTimestamp", - "documentation":"

The time the reservation started.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration, in seconds, for which the Elasticsearch instance is reserved.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The upfront fixed charge you will paid to purchase the specific reserved Elasticsearch instance offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The rate you are charged for each hour for the domain that is using this reserved instance.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved Elasticsearch instance offering.

" - }, - "ElasticsearchInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of Elasticsearch instances that have been reserved.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved Elasticsearch instance.

" - }, - "PaymentOption":{ - "shape":"ReservedElasticsearchInstancePaymentOption", - "documentation":"

The payment option as defined in the reserved Elasticsearch instance offering.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The charge to your account regardless of whether you are creating any domains using the instance offering.

" - } - }, - "documentation":"

Details of a reserved Elasticsearch instance.

" - }, - "ReservedElasticsearchInstanceList":{ - "type":"list", - "member":{"shape":"ReservedElasticsearchInstance"} - }, - "ReservedElasticsearchInstanceOffering":{ - "type":"structure", - "members":{ - "ReservedElasticsearchInstanceOfferingId":{ - "shape":"GUID", - "documentation":"

The Elasticsearch reserved instance offering identifier.

" - }, - "ElasticsearchInstanceType":{ - "shape":"ESPartitionInstanceType", - "documentation":"

The Elasticsearch instance type offered by the reserved instance offering.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration, in seconds, for which the offering will reserve the Elasticsearch instance.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The upfront fixed charge you will pay to purchase the specific reserved Elasticsearch instance offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The rate you are charged for each hour the domain that is using the offering is running.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved Elasticsearch instance offering.

" - }, - "PaymentOption":{ - "shape":"ReservedElasticsearchInstancePaymentOption", - "documentation":"

Payment option for the reserved Elasticsearch instance offering

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The charge to your account regardless of whether you are creating any domains using the instance offering.

" - } - }, - "documentation":"

Details of a reserved Elasticsearch instance offering.

" - }, - "ReservedElasticsearchInstanceOfferingList":{ - "type":"list", - "member":{"shape":"ReservedElasticsearchInstanceOffering"} - }, - "ReservedElasticsearchInstancePaymentOption":{ - "type":"string", - "enum":[ - "ALL_UPFRONT", - "PARTIAL_UPFRONT", - "NO_UPFRONT" - ] - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An exception for creating a resource that already exists. Gives http status code of 400.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "RoleArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "ServiceUrl":{ - "type":"string", - "documentation":"

The endpoint to which service requests are submitted. For example, search-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com.

" - }, - "SnapshotOptions":{ - "type":"structure", - "members":{ - "AutomatedSnapshotStartHour":{ - "shape":"IntegerClass", - "documentation":"

Specifies the time, in UTC format, when the service takes a daily automated snapshot of the specified Elasticsearch domain. Default value is 0 hours.

" - } - }, - "documentation":"

Specifies the time, in UTC format, when the service takes a daily automated snapshot of the specified Elasticsearch domain. Default value is 0 hours.

" - }, - "SnapshotOptionsStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"SnapshotOptions", - "documentation":"

Specifies the daily snapshot options specified for the Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of a daily automated snapshot.

" - } - }, - "documentation":"

Status of a daily automated snapshot.

" - }, - "StorageSubTypeName":{ - "type":"string", - "documentation":"

SubType of the given storage type. List of available sub-storage options: For \"instance\" storageType we wont have any storageSubType, in case of \"ebs\" storageType we will have following valid storageSubTypes

  1. standard
  2. gp2
  3. io1
Refer VolumeType for more information regarding above EBS storage options.

" - }, - "StorageType":{ - "type":"structure", - "members":{ - "StorageTypeName":{"shape":"StorageTypeName"}, - "StorageSubTypeName":{"shape":"StorageSubTypeName"}, - "StorageTypeLimits":{ - "shape":"StorageTypeLimitList", - "documentation":"

List of limits that are applicable for given storage type.

" - } - }, - "documentation":"

StorageTypes represents the list of storage related types and their attributes that are available for given InstanceType.

" - }, - "StorageTypeLimit":{ - "type":"structure", - "members":{ - "LimitName":{ - "shape":"LimitName", - "documentation":"

Name of storage limits that are applicable for given storage type. If StorageType is ebs, following storage options are applicable

  1. MinimumVolumeSize
  2. Minimum amount of volume size that is applicable for given storage type.It can be empty if it is not applicable.
  3. MaximumVolumeSize
  4. Maximum amount of volume size that is applicable for given storage type.It can be empty if it is not applicable.
  5. MaximumIops
  6. Maximum amount of Iops that is applicable for given storage type.It can be empty if it is not applicable.
  7. MinimumIops
  8. Minimum amount of Iops that is applicable for given storage type.It can be empty if it is not applicable.

" - }, - "LimitValues":{ - "shape":"LimitValueList", - "documentation":"

Values for the StorageTypeLimit$LimitName .

" - } - }, - "documentation":"

Limits that are applicable for given storage type.

" - }, - "StorageTypeLimitList":{ - "type":"list", - "member":{"shape":"StorageTypeLimit"} - }, - "StorageTypeList":{ - "type":"list", - "member":{"shape":"StorageType"} - }, - "StorageTypeName":{ - "type":"string", - "documentation":"

Type of the storage. List of available storage options:

  1. instance
  2. Inbuilt storage available for the given Instance
  3. ebs
  4. Elastic block storage that would be attached to the given Instance

" - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

Specifies the TagKey, the name of the tag. Tag keys must be unique for the Elasticsearch domain to which they are attached.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

Specifies the TagValue, the value assigned to the corresponding tag key. Tag values can be null and do not have to be unique in a tag set. For example, you can have a key value pair in a tag set of project : Trinity and cost-center : Trinity

" - } - }, - "documentation":"

Specifies a key value pair for a resource tag.

" - }, - "TagKey":{ - "type":"string", - "documentation":"

A string of length from 1 to 128 characters that specifies the key for a Tag. Tag keys must be unique for the Elasticsearch domain to which they are attached.

", - "max":128, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "documentation":"

A list of Tag

" - }, - "TagValue":{ - "type":"string", - "documentation":"

A string of length from 0 to 256 characters that specifies the value for a Tag. Tag values can be null and do not have to be unique in a tag set.

", - "max":256, - "min":0 - }, - "UIntValue":{ - "type":"integer", - "min":0 - }, - "UpdateElasticsearchDomainConfigRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the Elasticsearch domain that you are updating.

", - "location":"uri", - "locationName":"DomainName" - }, - "ElasticsearchClusterConfig":{ - "shape":"ElasticsearchClusterConfig", - "documentation":"

The type and number of instances to instantiate for the domain cluster.

" - }, - "EBSOptions":{ - "shape":"EBSOptions", - "documentation":"

Specify the type and size of the EBS volume that you want to use.

" - }, - "SnapshotOptions":{ - "shape":"SnapshotOptions", - "documentation":"

Option to set the time, in UTC format, for the daily automated snapshot. Default value is 0 hours.

" - }, - "VPCOptions":{ - "shape":"VPCOptions", - "documentation":"

Options to specify the subnets and security groups for VPC endpoint. For more information, see Creating a VPC in VPC Endpoints for Amazon Elasticsearch Service Domains

" - }, - "CognitoOptions":{ - "shape":"CognitoOptions", - "documentation":"

Options to specify the Cognito user and identity pools for Kibana authentication. For more information, see Amazon Cognito Authentication for Kibana.

" - }, - "AdvancedOptions":{ - "shape":"AdvancedOptions", - "documentation":"

Modifies the advanced option to allow references to indices in an HTTP request body. Must be false when configuring access to individual sub-resources. By default, the value is true. See Configuration Advanced Options for more information.

" - }, - "AccessPolicies":{ - "shape":"PolicyDocument", - "documentation":"

IAM access policy as a JSON-formatted string.

" - }, - "LogPublishingOptions":{ - "shape":"LogPublishingOptions", - "documentation":"

Map of LogType and LogPublishingOption, each containing options to publish a given type of Elasticsearch log.

" - } - }, - "documentation":"

Container for the parameters to the UpdateElasticsearchDomain operation. Specifies the type and number of instances in the domain cluster.

" - }, - "UpdateElasticsearchDomainConfigResponse":{ - "type":"structure", - "required":["DomainConfig"], - "members":{ - "DomainConfig":{ - "shape":"ElasticsearchDomainConfig", - "documentation":"

The status of the updated Elasticsearch domain.

" - } - }, - "documentation":"

The result of an UpdateElasticsearchDomain request. Contains the status of the Elasticsearch domain being updated.

" - }, - "UpdateTimestamp":{"type":"timestamp"}, - "UserPoolId":{ - "type":"string", - "max":55, - "min":1, - "pattern":"[\\w-]+_[0-9a-zA-Z]+" - }, - "VPCDerivedInfo":{ - "type":"structure", - "members":{ - "VPCId":{ - "shape":"String", - "documentation":"

The VPC Id for the Elasticsearch domain. Exists only if the domain was created with VPCOptions.

" - }, - "SubnetIds":{ - "shape":"StringList", - "documentation":"

Specifies the subnets for VPC endpoint.

" - }, - "AvailabilityZones":{ - "shape":"StringList", - "documentation":"

The availability zones for the Elasticsearch domain. Exists only if the domain was created with VPCOptions.

" - }, - "SecurityGroupIds":{ - "shape":"StringList", - "documentation":"

Specifies the security groups for VPC endpoint.

" - } - }, - "documentation":"

Options to specify the subnets and security groups for VPC endpoint. For more information, see VPC Endpoints for Amazon Elasticsearch Service Domains.

" - }, - "VPCDerivedInfoStatus":{ - "type":"structure", - "required":[ - "Options", - "Status" - ], - "members":{ - "Options":{ - "shape":"VPCDerivedInfo", - "documentation":"

Specifies the VPC options for the specified Elasticsearch domain.

" - }, - "Status":{ - "shape":"OptionStatus", - "documentation":"

Specifies the status of the VPC options for the specified Elasticsearch domain.

" - } - }, - "documentation":"

Status of the VPC options for the specified Elasticsearch domain.

" - }, - "VPCOptions":{ - "type":"structure", - "members":{ - "SubnetIds":{ - "shape":"StringList", - "documentation":"

Specifies the subnets for VPC endpoint.

" - }, - "SecurityGroupIds":{ - "shape":"StringList", - "documentation":"

Specifies the security groups for VPC endpoint.

" - } - }, - "documentation":"

Options to specify the subnets and security groups for VPC endpoint. For more information, see VPC Endpoints for Amazon Elasticsearch Service Domains.

" - }, - "ValidationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An exception for missing / invalid input fields. Gives http status code of 400.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "VolumeType":{ - "type":"string", - "documentation":"

The type of EBS volume, standard, gp2, or io1. See Configuring EBS-based Storagefor more information.

", - "enum":[ - "standard", - "gp2", - "io1" - ] - } - }, - "documentation":"Amazon Elasticsearch Configuration Service

Use the Amazon Elasticsearch configuration API to create, configure, and manage Elasticsearch domains.

The endpoint for configuration service requests is region-specific: es.region.amazonaws.com. For example, es.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2014-02-03/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2014-02-03/service-2.json deleted file mode 100644 index e6cf2a40..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2014-02-03/service-2.json +++ /dev/null @@ -1,997 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-02-03", - "endpointPrefix":"events", - "jsonVersion":"1.1", - "serviceFullName":"Amazon CloudWatch Events", - "signatureVersion":"v4", - "targetPrefix":"AWSEvents", - "protocol":"json" - }, - "documentation":"

Amazon CloudWatch Events helps you to respond to state changes in your AWS resources. When your resources change state they automatically send events into an event stream. You can create rules that match selected events in the stream and route them to targets to take action. You can also use rules to take action on a pre-determined schedule. For example, you can configure rules to:

  • Automatically invoke an AWS Lambda function to update DNS entries when an event notifies you that Amazon EC2 instance enters the running state.
  • Direct specific API records from CloudTrail to an Amazon Kinesis stream for detailed analysis of potential security or availability risks.
  • Periodically invoke a built-in target to create a snapshot of an Amazon EBS volume.

For more information about Amazon CloudWatch Events features, see the Amazon CloudWatch Developer Guide.

", - "operations":{ - "DeleteRule":{ - "name":"DeleteRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteRuleRequest", - "documentation":"

Container for the parameters to the DeleteRule operation.

" - }, - "errors":[ - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Deletes a rule. You must remove all targets from a rule using RemoveTargets before you can delete the rule.

Note: When you make a change with this action, incoming events might still continue to match to the deleted rule. Please allow a short period of time for changes to take effect.

" - }, - "DescribeRule":{ - "name":"DescribeRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeRuleRequest", - "documentation":"

Container for the parameters to the DescribeRule operation.

" - }, - "output":{ - "shape":"DescribeRuleResponse", - "documentation":"

The result of the DescribeRule operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Describes the details of the specified rule.

" - }, - "DisableRule":{ - "name":"DisableRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DisableRuleRequest", - "documentation":"

Container for the parameters to the DisableRule operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Disables a rule. A disabled rule won't match any events, and won't self-trigger if it has a schedule expression.

Note: When you make a change with this action, incoming events might still continue to match to the disabled rule. Please allow a short period of time for changes to take effect.

" - }, - "EnableRule":{ - "name":"EnableRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"EnableRuleRequest", - "documentation":"

Container for the parameters to the EnableRule operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Enables a rule. If the rule does not exist, the operation fails.

Note: When you make a change with this action, incoming events might not immediately start matching to a newly enabled rule. Please allow a short period of time for changes to take effect.

" - }, - "ListRuleNamesByTarget":{ - "name":"ListRuleNamesByTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ListRuleNamesByTargetRequest", - "documentation":"

Container for the parameters to the ListRuleNamesByTarget operation.

" - }, - "output":{ - "shape":"ListRuleNamesByTargetResponse", - "documentation":"

The result of the ListRuleNamesByTarget operation.

" - }, - "errors":[ - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Lists the names of the rules that the given target is put to. Using this action, you can find out which of the rules in Amazon CloudWatch Events can invoke a specific target in your account. If you have more rules in your account than the given limit, the results will be paginated. In that case, use the next token returned in the response and repeat the ListRulesByTarget action until the NextToken in the response is returned as null.

" - }, - "ListRules":{ - "name":"ListRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ListRulesRequest", - "documentation":"

Container for the parameters to the ListRules operation.

" - }, - "output":{ - "shape":"ListRulesResponse", - "documentation":"

The result of the ListRules operation.

" - }, - "errors":[ - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Lists the Amazon CloudWatch Events rules in your account. You can either list all the rules or you can provide a prefix to match to the rule names. If you have more rules in your account than the given limit, the results will be paginated. In that case, use the next token returned in the response and repeat the ListRules action until the NextToken in the response is returned as null.

" - }, - "ListTargetsByRule":{ - "name":"ListTargetsByRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ListTargetsByRuleRequest", - "documentation":"

Container for the parameters to the ListTargetsByRule operation.

" - }, - "output":{ - "shape":"ListTargetsByRuleResponse", - "documentation":"

The result of the ListTargetsByRule operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Lists of targets assigned to the rule.

" - }, - "PutEvents":{ - "name":"PutEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PutEventsRequest", - "documentation":"

Container for the parameters to the PutEvents operation.

" - }, - "output":{ - "shape":"PutEventsResponse", - "documentation":"

The result of the PutEvents operation.

" - }, - "errors":[ - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Sends custom events to Amazon CloudWatch Events so that they can be matched to rules.

" - }, - "PutRule":{ - "name":"PutRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PutRuleRequest", - "documentation":"

Container for the parameters to the PutRule operation.

" - }, - "output":{ - "shape":"PutRuleResponse", - "documentation":"

The result of the PutRule operation.

" - }, - "errors":[ - { - "shape":"InvalidEventPatternException", - "exception":true, - "documentation":"

The event pattern is invalid.

" - }, - { - "shape":"LimitExceededException", - "exception":true, - "documentation":"

This exception occurs if you try to create more rules or add more targets to a rule than allowed by default.

" - }, - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Creates or updates a rule. Rules are enabled by default, or based on value of the State parameter. You can disable a rule using DisableRule.

Note: When you make a change with this action, incoming events might not immediately start matching to new or updated rules. Please allow a short period of time for changes to take effect.

A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can have both an EventPattern and a ScheduleExpression, in which case the rule will trigger on matching events as well as on a schedule.

Note: Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

" - }, - "PutTargets":{ - "name":"PutTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PutTargetsRequest", - "documentation":"

Container for the parameters to the PutTargets operation.

" - }, - "output":{ - "shape":"PutTargetsResponse", - "documentation":"

The result of the PutTargets operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"LimitExceededException", - "exception":true, - "documentation":"

This exception occurs if you try to create more rules or add more targets to a rule than allowed by default.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Adds target(s) to a rule. Updates the target(s) if they are already associated with the role. In other words, if there is already a target with the given target ID, then the target associated with that ID is updated.

Note: When you make a change with this action, when the associated rule triggers, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.

" - }, - "RemoveTargets":{ - "name":"RemoveTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RemoveTargetsRequest", - "documentation":"

Container for the parameters to the RemoveTargets operation.

" - }, - "output":{ - "shape":"RemoveTargetsResponse", - "documentation":"

The result of the RemoveTargets operation.

" - }, - "errors":[ - { - "shape":"ResourceNotFoundException", - "exception":true, - "documentation":"

The rule does not exist.

" - }, - { - "shape":"ConcurrentModificationException", - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Removes target(s) from a rule so that when the rule is triggered, those targets will no longer be invoked.

Note: When you make a change with this action, when the associated rule triggers, removed targets might still continue to be invoked. Please allow a short period of time for changes to take effect.

" - }, - "TestEventPattern":{ - "name":"TestEventPattern", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"TestEventPatternRequest", - "documentation":"

Container for the parameters to the TestEventPattern operation.

" - }, - "output":{ - "shape":"TestEventPatternResponse", - "documentation":"

The result of the TestEventPattern operation.

" - }, - "errors":[ - { - "shape":"InvalidEventPatternException", - "exception":true, - "documentation":"

The event pattern is invalid.

" - }, - { - "shape":"InternalException", - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - } - ], - "documentation":"

Tests whether an event pattern matches the provided event.

Note: Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

" - } - }, - "shapes":{ - "Boolean":{"type":"boolean"}, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "documentation":"

This exception occurs if there is concurrent modification on rule or target.

" - }, - "DeleteRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule to be deleted.

" - } - }, - "documentation":"

Container for the parameters to the DeleteRule operation.

" - }, - "DescribeRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule you want to describe details for.

" - } - }, - "documentation":"

Container for the parameters to the DescribeRule operation.

" - }, - "DescribeRuleResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The rule's name.

" - }, - "Arn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) associated with the rule.

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\".

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

Specifies whether the rule is enabled or disabled.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

The rule's description.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role associated with the rule.

" - } - }, - "documentation":"

The result of the DescribeRule operation.

" - }, - "DisableRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule you want to disable.

" - } - }, - "documentation":"

Container for the parameters to the DisableRule operation.

" - }, - "EnableRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule that you want to enable.

" - } - }, - "documentation":"

Container for the parameters to the EnableRule operation.

" - }, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "EventId":{"type":"string"}, - "EventPattern":{ - "type":"string", - "max":2048 - }, - "EventResource":{"type":"string"}, - "EventResourceList":{ - "type":"list", - "member":{"shape":"EventResource"} - }, - "EventTime":{"type":"timestamp"}, - "Integer":{"type":"integer"}, - "InternalException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "fault":true, - "documentation":"

This exception occurs due to unexpected causes.

" - }, - "InvalidEventPatternException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "documentation":"

The event pattern is invalid.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "documentation":"

This exception occurs if you try to create more rules or add more targets to a rule than allowed by default.

" - }, - "LimitMax100":{ - "type":"integer", - "min":1, - "max":100 - }, - "ListRuleNamesByTargetRequest":{ - "type":"structure", - "required":["TargetArn"], - "members":{ - "TargetArn":{ - "shape":"TargetArn", - "documentation":"

The Amazon Resource Name (ARN) of the target resource that you want to list the rules for.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - }, - "documentation":"

Container for the parameters to the ListRuleNamesByTarget operation.

" - }, - "ListRuleNamesByTargetResponse":{ - "type":"structure", - "members":{ - "RuleNames":{ - "shape":"RuleNameList", - "documentation":"

List of rules names that can invoke the given target.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates that there are additional results to retrieve.

" - } - }, - "documentation":"

The result of the ListRuleNamesByTarget operation.

" - }, - "ListRulesRequest":{ - "type":"structure", - "members":{ - "NamePrefix":{ - "shape":"RuleName", - "documentation":"

The prefix matching the rule name.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - }, - "documentation":"

Container for the parameters to the ListRules operation.

" - }, - "ListRulesResponse":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"RuleResponseList", - "documentation":"

List of rules matching the specified criteria.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates that there are additional results to retrieve.

" - } - }, - "documentation":"

The result of the ListRules operation.

" - }, - "ListTargetsByRuleRequest":{ - "type":"structure", - "required":["Rule"], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule whose targets you want to list.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to indicate that there is more data available.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - }, - "documentation":"

Container for the parameters to the ListTargetsByRule operation.

" - }, - "ListTargetsByRuleResponse":{ - "type":"structure", - "members":{ - "Targets":{ - "shape":"TargetList", - "documentation":"

Lists the targets assigned to the rule.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates that there are additional results to retrieve.

" - } - }, - "documentation":"

The result of the ListTargetsByRule operation.

" - }, - "NextToken":{ - "type":"string", - "min":1, - "max":2048 - }, - "PutEventsRequest":{ - "type":"structure", - "required":["Entries"], - "members":{ - "Entries":{ - "shape":"PutEventsRequestEntryList", - "documentation":"

The entry that defines an event in your system. You can specify several parameters for the entry such as the source and type of the event, resources associated with the event, and so on.

" - } - }, - "documentation":"

Container for the parameters to the PutEvents operation.

" - }, - "PutEventsRequestEntry":{ - "type":"structure", - "members":{ - "Time":{ - "shape":"EventTime", - "documentation":"

Timestamp of event, per RFC3339. If no timestamp is provided, the timestamp of the PutEvents call will be used.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the event.

" - }, - "Resources":{ - "shape":"EventResourceList", - "documentation":"

AWS resources, identified by Amazon Resource Name (ARN), which the event primarily concerns. Any number, including zero, may be present.

" - }, - "DetailType":{ - "shape":"String", - "documentation":"

Free-form string used to decide what fields to expect in the event detail.

" - }, - "Detail":{ - "shape":"String", - "documentation":"

In the JSON sense, an object containing fields, which may also contain nested sub-objects. No constraints are imposed on its contents.

" - } - }, - "documentation":"

Contains information about the event to be used in the PutEvents action.

" - }, - "PutEventsRequestEntryList":{ - "type":"list", - "member":{"shape":"PutEventsRequestEntry"}, - "min":1, - "max":10 - }, - "PutEventsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "Entries":{ - "shape":"PutEventsResultEntryList", - "documentation":"

A list of successfully and unsuccessfully ingested events results. If the ingestion was successful, the entry will have the event ID in it. If not, then the ErrorCode and ErrorMessage can be used to identify the problem with the entry.

" - } - }, - "documentation":"

The result of the PutEvents operation.

" - }, - "PutEventsResultEntry":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"EventId", - "documentation":"

The ID of the event submitted to Amazon CloudWatch Events.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code representing why the event submission failed on this entry.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message explaining why the event submission failed on this entry.

" - } - }, - "documentation":"

A PutEventsResult contains a list of PutEventsResultEntry.

" - }, - "PutEventsResultEntryList":{ - "type":"list", - "member":{"shape":"PutEventsResultEntry"} - }, - "PutRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule that you are creating or updating.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\".

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern.

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

Indicates whether the rule is enabled or disabled.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

A description of the rule.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role associated with the rule.

" - } - }, - "documentation":"

Container for the parameters to the PutRule operation.

" - }, - "PutRuleResponse":{ - "type":"structure", - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the rule.

" - } - }, - "documentation":"

The result of the PutRule operation.

" - }, - "PutTargetsRequest":{ - "type":"structure", - "required":[ - "Rule", - "Targets" - ], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule you want to add targets to.

" - }, - "Targets":{ - "shape":"TargetList", - "documentation":"

List of targets you want to update or add to the rule.

" - } - }, - "documentation":"

Container for the parameters to the PutTargets operation.

" - }, - "PutTargetsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "FailedEntries":{ - "shape":"PutTargetsResultEntryList", - "documentation":"

An array of failed target entries.

" - } - }, - "documentation":"

The result of the PutTargets operation.

" - }, - "PutTargetsResultEntry":{ - "type":"structure", - "members":{ - "TargetId":{ - "shape":"TargetId", - "documentation":"

The ID of the target submitted to Amazon CloudWatch Events.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code representing why the target submission failed on this entry.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message explaining why the target submission failed on this entry.

" - } - }, - "documentation":"

A PutTargetsResult contains a list of PutTargetsResultEntry.

" - }, - "PutTargetsResultEntryList":{ - "type":"list", - "member":{"shape":"PutTargetsResultEntry"} - }, - "RemoveTargetsRequest":{ - "type":"structure", - "required":[ - "Rule", - "Ids" - ], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule you want to remove targets from.

" - }, - "Ids":{ - "shape":"TargetIdList", - "documentation":"

The list of target IDs to remove from the rule.

" - } - }, - "documentation":"

Container for the parameters to the RemoveTargets operation.

" - }, - "RemoveTargetsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "FailedEntries":{ - "shape":"RemoveTargetsResultEntryList", - "documentation":"

An array of failed target entries.

" - } - }, - "documentation":"

The result of the RemoveTargets operation.

" - }, - "RemoveTargetsResultEntry":{ - "type":"structure", - "members":{ - "TargetId":{ - "shape":"TargetId", - "documentation":"

The ID of the target requested to be removed by Amazon CloudWatch Events.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code representing why the target removal failed on this entry.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message explaining why the target removal failed on this entry.

" - } - }, - "documentation":"

The ID of the target requested to be removed from the rule by Amazon CloudWatch Events.

" - }, - "RemoveTargetsResultEntryList":{ - "type":"list", - "member":{"shape":"RemoveTargetsResultEntry"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "documentation":"

The rule does not exist.

" - }, - "RoleArn":{ - "type":"string", - "min":1, - "max":1600 - }, - "Rule":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The rule's name.

" - }, - "Arn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern of the rule.

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

The rule's state.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

The description of the rule.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\".

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) associated with the role that is used for target invocation.

" - } - }, - "documentation":"

Contains information about a rule in Amazon CloudWatch Events. A ListRulesResult contains a list of Rules.

" - }, - "RuleArn":{ - "type":"string", - "min":1, - "max":1600 - }, - "RuleDescription":{ - "type":"string", - "max":512 - }, - "RuleName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[\\.\\-_A-Za-z0-9]+" - }, - "RuleNameList":{ - "type":"list", - "member":{"shape":"RuleName"} - }, - "RuleResponseList":{ - "type":"list", - "member":{"shape":"Rule"} - }, - "RuleState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "ScheduleExpression":{ - "type":"string", - "max":256 - }, - "String":{"type":"string"}, - "Target":{ - "type":"structure", - "required":[ - "Id", - "Arn" - ], - "members":{ - "Id":{ - "shape":"TargetId", - "documentation":"

The unique target assignment ID.

" - }, - "Arn":{ - "shape":"TargetArn", - "documentation":"

The Amazon Resource Name (ARN) associated of the target.

" - }, - "Input":{ - "shape":"TargetInput", - "documentation":"

Valid JSON text passed to the target. For more information about JSON text, see The JavaScript Object Notation (JSON) Data Interchange Format.

" - }, - "InputPath":{ - "shape":"TargetInputPath", - "documentation":"

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. For more information about JSON paths, see JSONPath.

" - } - }, - "documentation":"

Targets are the resources that can be invoked when a rule is triggered. For example, AWS Lambda functions, Amazon Kinesis streams, and built-in targets.

Input and InputPath are mutually-exclusive and optional parameters of a target. When a rule is triggered due to a matched event, if for a target:

  • Neither Input nor InputPath is specified, then the entire event is passed to the target in JSON form.
  • InputPath is specified in the form of JSONPath (e.g. $.detail), then only the part of the event specified in the path is passed to the target (e.g. only the detail part of the event is passed).
  • Input is specified in the form of a valid JSON, then the matched event is overridden with this constant.
" - }, - "TargetArn":{ - "type":"string", - "min":1, - "max":1600 - }, - "TargetId":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[\\.\\-_A-Za-z0-9]+" - }, - "TargetIdList":{ - "type":"list", - "member":{"shape":"TargetId"}, - "min":1, - "max":100 - }, - "TargetInput":{ - "type":"string", - "max":8192 - }, - "TargetInputPath":{ - "type":"string", - "max":256 - }, - "TargetList":{ - "type":"list", - "member":{"shape":"Target"} - }, - "TestEventPatternRequest":{ - "type":"structure", - "required":[ - "EventPattern", - "Event" - ], - "members":{ - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern you want to test.

" - }, - "Event":{ - "shape":"String", - "documentation":"

The event in the JSON format to test against the event pattern.

" - } - }, - "documentation":"

Container for the parameters to the TestEventPattern operation.

" - }, - "TestEventPatternResponse":{ - "type":"structure", - "members":{ - "Result":{ - "shape":"Boolean", - "documentation":"

Indicates whether the event matches the event pattern.

" - } - }, - "documentation":"

The result of the TestEventPattern operation.

" - } - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/examples-1.json deleted file mode 100644 index faff7689..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version":"1.0", - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/service-2.json deleted file mode 100644 index 0c7c5edf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/events/2015-10-07/service-2.json +++ /dev/null @@ -1,1118 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-10-07", - "endpointPrefix":"events", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon CloudWatch Events", - "serviceId":"CloudWatch Events", - "signatureVersion":"v4", - "targetPrefix":"AWSEvents", - "uid":"events-2015-10-07" - }, - "operations":{ - "DeleteRule":{ - "name":"DeleteRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleRequest"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Deletes the specified rule.

You must remove all targets from a rule using RemoveTargets before you can delete the rule.

When you delete a rule, incoming events might continue to match to the deleted rule. Please allow a short period of time for changes to take effect.

" - }, - "DescribeEventBus":{ - "name":"DescribeEventBus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventBusRequest"}, - "output":{"shape":"DescribeEventBusResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalException"} - ], - "documentation":"

Displays the external AWS accounts that are permitted to write events to your account using your account's event bus, and the associated policy. To enable your account to receive events from other accounts, use PutPermission.

" - }, - "DescribeRule":{ - "name":"DescribeRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRuleRequest"}, - "output":{"shape":"DescribeRuleResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalException"} - ], - "documentation":"

Describes the specified rule.

" - }, - "DisableRule":{ - "name":"DisableRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableRuleRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Disables the specified rule. A disabled rule won't match any events, and won't self-trigger if it has a schedule expression.

When you disable a rule, incoming events might continue to match to the disabled rule. Please allow a short period of time for changes to take effect.

" - }, - "EnableRule":{ - "name":"EnableRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableRuleRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Enables the specified rule. If the rule does not exist, the operation fails.

When you enable a rule, incoming events might not immediately start matching to a newly enabled rule. Please allow a short period of time for changes to take effect.

" - }, - "ListRuleNamesByTarget":{ - "name":"ListRuleNamesByTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRuleNamesByTargetRequest"}, - "output":{"shape":"ListRuleNamesByTargetResponse"}, - "errors":[ - {"shape":"InternalException"} - ], - "documentation":"

Lists the rules for the specified target. You can see which of the rules in Amazon CloudWatch Events can invoke a specific target in your account.

" - }, - "ListRules":{ - "name":"ListRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRulesRequest"}, - "output":{"shape":"ListRulesResponse"}, - "errors":[ - {"shape":"InternalException"} - ], - "documentation":"

Lists your Amazon CloudWatch Events rules. You can either list all the rules or you can provide a prefix to match to the rule names.

" - }, - "ListTargetsByRule":{ - "name":"ListTargetsByRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTargetsByRuleRequest"}, - "output":{"shape":"ListTargetsByRuleResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalException"} - ], - "documentation":"

Lists the targets assigned to the specified rule.

" - }, - "PutEvents":{ - "name":"PutEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutEventsRequest"}, - "output":{"shape":"PutEventsResponse"}, - "errors":[ - {"shape":"InternalException"} - ], - "documentation":"

Sends custom events to Amazon CloudWatch Events so that they can be matched to rules.

" - }, - "PutPermission":{ - "name":"PutPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutPermissionRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"PolicyLengthExceededException"}, - {"shape":"InternalException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Running PutPermission permits the specified AWS account to put events to your account's default event bus. CloudWatch Events rules in your account are triggered by these events arriving to your default event bus.

For another account to send events to your account, that external account must have a CloudWatch Events rule with your account's default event bus as a target.

To enable multiple AWS accounts to put events to your default event bus, run PutPermission once for each of these accounts.

The permission policy on the default event bus cannot exceed 10KB in size.

" - }, - "PutRule":{ - "name":"PutRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRuleRequest"}, - "output":{"shape":"PutRuleResponse"}, - "errors":[ - {"shape":"InvalidEventPatternException"}, - {"shape":"LimitExceededException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can disable a rule using DisableRule.

If you are updating an existing rule, the rule is completely replaced with what you specify in this PutRule command. If you omit arguments in PutRule, the old values for those arguments are not kept. Instead, they are replaced with null values.

When you create or update a rule, incoming events might not immediately start matching to new or updated rules. Please allow a short period of time for changes to take effect.

A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as on a schedule.

Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

" - }, - "PutTargets":{ - "name":"PutTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutTargetsRequest"}, - "output":{"shape":"PutTargetsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalException"} - ], - "documentation":"

Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.

Targets are the resources that are invoked when a rule is triggered.

You can configure the following as targets for CloudWatch Events:

  • EC2 instances

  • AWS Lambda functions

  • Streams in Amazon Kinesis Streams

  • Delivery streams in Amazon Kinesis Firehose

  • Amazon ECS tasks

  • AWS Step Functions state machines

  • AWS Batch jobs

  • Pipelines in Amazon Code Pipeline

  • Amazon Inspector assessment templates

  • Amazon SNS topics

  • Amazon SQS queues, including FIFO queues

  • The default event bus of another AWS account

Note that creating rules with built-in targets is supported only in the AWS Management Console.

For some target types, PutTargets provides target-specific parameters. If the target is an Amazon Kinesis stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field.

To be able to make API calls against the resources that you own, Amazon CloudWatch Events needs the appropriate permissions. For AWS Lambda and Amazon SNS resources, CloudWatch Events relies on resource-based policies. For EC2 instances, Amazon Kinesis streams, and AWS Step Functions state machines, CloudWatch Events relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon CloudWatch Events User Guide.

If another AWS account is in the same region and has granted you permission (using PutPermission), you can send events to that account by setting that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to antoher account is charged as a custom event. The account receiving the event is not charged. For more information on pricing, see Amazon CloudWatch Pricing.

For more information about enabling cross-account events, see PutPermission.

Input, InputPath and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:

  • If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON form (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target).

  • If Input is specified in the form of valid JSON, then the matched event is overridden with this constant.

  • If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed).

  • If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target.

When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation.

When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

" - }, - "RemovePermission":{ - "name":"RemovePermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemovePermissionRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Revokes the permission of another AWS account to be able to put events to your default event bus. Specify the account to revoke by the StatementId value that you associated with the account when you granted it permission with PutPermission. You can find the StatementId by using DescribeEventBus.

" - }, - "RemoveTargets":{ - "name":"RemoveTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTargetsRequest"}, - "output":{"shape":"RemoveTargetsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InternalException"} - ], - "documentation":"

Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.

When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Please allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

" - }, - "TestEventPattern":{ - "name":"TestEventPattern", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestEventPatternRequest"}, - "output":{"shape":"TestEventPatternResponse"}, - "errors":[ - {"shape":"InvalidEventPatternException"}, - {"shape":"InternalException"} - ], - "documentation":"

Tests whether the specified event pattern matches the provided event.

Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

" - } - }, - "shapes":{ - "Action":{ - "type":"string", - "max":64, - "min":1, - "pattern":"events:[a-zA-Z]+" - }, - "Arn":{ - "type":"string", - "max":1600, - "min":1 - }, - "BatchArrayProperties":{ - "type":"structure", - "members":{ - "Size":{ - "shape":"Integer", - "documentation":"

The size of the array, if this is an array batch job. Valid values are integers between 2 and 10,000.

" - } - }, - "documentation":"

The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. This parameter is used only if the target is an AWS Batch job.

" - }, - "BatchParameters":{ - "type":"structure", - "required":[ - "JobDefinition", - "JobName" - ], - "members":{ - "JobDefinition":{ - "shape":"String", - "documentation":"

The ARN or name of the job definition to use if the event target is an AWS Batch job. This job definition must already exist.

" - }, - "JobName":{ - "shape":"String", - "documentation":"

The name to use for this execution of the job, if the target is an AWS Batch job.

" - }, - "ArrayProperties":{ - "shape":"BatchArrayProperties", - "documentation":"

The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. This parameter is used only if the target is an AWS Batch job.

" - }, - "RetryStrategy":{ - "shape":"BatchRetryStrategy", - "documentation":"

The retry strategy to use for failed jobs, if the target is an AWS Batch job. The retry strategy is the number of times to retry the failed job execution. Valid values are 1 to 10. When you specify a retry strategy here, it overrides the retry strategy defined in the job definition.

" - } - }, - "documentation":"

The custom parameters to be used when the target is an AWS Batch job.

" - }, - "BatchRetryStrategy":{ - "type":"structure", - "members":{ - "Attempts":{ - "shape":"Integer", - "documentation":"

The number of times to attempt to retry, if the job fails. Valid values are 1 to 10.

" - } - }, - "documentation":"

The retry strategy to use for failed jobs, if the target is an AWS Batch job. If you specify a retry strategy here, it overrides the retry strategy defined in the job definition.

" - }, - "Boolean":{"type":"boolean"}, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is concurrent modification on a rule or target.

", - "exception":true - }, - "DeleteRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - } - } - }, - "DescribeEventBusRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeEventBusResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the event bus. Currently, this is always default.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the account permitted to write events to the current account.

" - }, - "Policy":{ - "shape":"String", - "documentation":"

The policy that enables the external account to send events to your account.

" - } - } - }, - "DescribeRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - } - } - }, - "DescribeRuleResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "Arn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern. For more information, see Events and Event Patterns in the Amazon CloudWatch Events User Guide.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\".

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

Specifies whether the rule is enabled or disabled.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

The description of the rule.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role associated with the rule.

" - } - } - }, - "DisableRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - } - } - }, - "EcsParameters":{ - "type":"structure", - "required":["TaskDefinitionArn"], - "members":{ - "TaskDefinitionArn":{ - "shape":"Arn", - "documentation":"

The ARN of the task definition to use if the event target is an Amazon ECS cluster.

" - }, - "TaskCount":{ - "shape":"LimitMin1", - "documentation":"

The number of tasks to create based on the TaskDefinition. The default is one.

" - } - }, - "documentation":"

The custom parameters to be used when the target is an Amazon ECS cluster.

" - }, - "EnableRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - } - } - }, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "EventId":{"type":"string"}, - "EventPattern":{"type":"string"}, - "EventResource":{"type":"string"}, - "EventResourceList":{ - "type":"list", - "member":{"shape":"EventResource"} - }, - "EventTime":{"type":"timestamp"}, - "InputTransformer":{ - "type":"structure", - "required":["InputTemplate"], - "members":{ - "InputPathsMap":{ - "shape":"TransformerPaths", - "documentation":"

Map of JSON paths to be extracted from the event. These are key-value pairs, where each value is a JSON path. You must use JSON dot notation, not bracket notation.

" - }, - "InputTemplate":{ - "shape":"TransformerInput", - "documentation":"

Input template where you can use the values of the keys from InputPathsMap to customize the data sent to the target.

" - } - }, - "documentation":"

Contains the parameters needed for you to provide custom input to a target based on one or more pieces of data extracted from the event.

" - }, - "InputTransformerPathKey":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[A-Za-z0-9\\_\\-]+" - }, - "Integer":{"type":"integer"}, - "InternalException":{ - "type":"structure", - "members":{ - }, - "documentation":"

This exception occurs due to unexpected causes.

", - "exception":true, - "fault":true - }, - "InvalidEventPatternException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The event pattern is not valid.

", - "exception":true - }, - "KinesisParameters":{ - "type":"structure", - "required":["PartitionKeyPath"], - "members":{ - "PartitionKeyPath":{ - "shape":"TargetPartitionKeyPath", - "documentation":"

The JSON path to be extracted from the event and used as the partition key. For more information, see Amazon Kinesis Streams Key Concepts in the Amazon Kinesis Streams Developer Guide.

" - } - }, - "documentation":"

This object enables you to specify a JSON path to extract from the event and use as the partition key for the Amazon Kinesis stream, so that you can control the shard to which the event goes. If you do not include this parameter, the default is to use the eventId as the partition key.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You tried to create more rules or add more targets to a rule than is allowed.

", - "exception":true - }, - "LimitMax100":{ - "type":"integer", - "max":100, - "min":1 - }, - "LimitMin1":{ - "type":"integer", - "min":1 - }, - "ListRuleNamesByTargetRequest":{ - "type":"structure", - "required":["TargetArn"], - "members":{ - "TargetArn":{ - "shape":"TargetArn", - "documentation":"

The Amazon Resource Name (ARN) of the target resource.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to retrieve the next set of results.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - } - }, - "ListRuleNamesByTargetResponse":{ - "type":"structure", - "members":{ - "RuleNames":{ - "shape":"RuleNameList", - "documentation":"

The names of the rules that can invoke the given target.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates whether there are additional results to retrieve. If there are no more results, the value is null.

" - } - } - }, - "ListRulesRequest":{ - "type":"structure", - "members":{ - "NamePrefix":{ - "shape":"RuleName", - "documentation":"

The prefix matching the rule name.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to retrieve the next set of results.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - } - }, - "ListRulesResponse":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"RuleResponseList", - "documentation":"

The rules that match the specified criteria.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates whether there are additional results to retrieve. If there are no more results, the value is null.

" - } - } - }, - "ListTargetsByRuleRequest":{ - "type":"structure", - "required":["Rule"], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token returned by a previous call to retrieve the next set of results.

" - }, - "Limit":{ - "shape":"LimitMax100", - "documentation":"

The maximum number of results to return.

" - } - } - }, - "ListTargetsByRuleResponse":{ - "type":"structure", - "members":{ - "Targets":{ - "shape":"TargetList", - "documentation":"

The targets assigned to the rule.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Indicates whether there are additional results to retrieve. If there are no more results, the value is null.

" - } - } - }, - "MessageGroupId":{"type":"string"}, - "NextToken":{ - "type":"string", - "max":2048, - "min":1 - }, - "PolicyLengthExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The event bus policy is too long. For more information, see the limits.

", - "exception":true - }, - "Principal":{ - "type":"string", - "max":12, - "min":1, - "pattern":"(\\d{12}|\\*)" - }, - "PutEventsRequest":{ - "type":"structure", - "required":["Entries"], - "members":{ - "Entries":{ - "shape":"PutEventsRequestEntryList", - "documentation":"

The entry that defines an event in your system. You can specify several parameters for the entry such as the source and type of the event, resources associated with the event, and so on.

" - } - } - }, - "PutEventsRequestEntry":{ - "type":"structure", - "members":{ - "Time":{ - "shape":"EventTime", - "documentation":"

The timestamp of the event, per RFC3339. If no timestamp is provided, the timestamp of the PutEvents call is used.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the event.

" - }, - "Resources":{ - "shape":"EventResourceList", - "documentation":"

AWS resources, identified by Amazon Resource Name (ARN), which the event primarily concerns. Any number, including zero, may be present.

" - }, - "DetailType":{ - "shape":"String", - "documentation":"

Free-form string used to decide what fields to expect in the event detail.

" - }, - "Detail":{ - "shape":"String", - "documentation":"

A valid JSON string. There is no other schema imposed. The JSON string may contain fields and nested subobjects.

" - } - }, - "documentation":"

Represents an event to be submitted.

" - }, - "PutEventsRequestEntryList":{ - "type":"list", - "member":{"shape":"PutEventsRequestEntry"}, - "max":10, - "min":1 - }, - "PutEventsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "Entries":{ - "shape":"PutEventsResultEntryList", - "documentation":"

The successfully and unsuccessfully ingested events results. If the ingestion was successful, the entry has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the entry.

" - } - } - }, - "PutEventsResultEntry":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"EventId", - "documentation":"

The ID of the event.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code that indicates why the event submission failed.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message that explains why the event submission failed.

" - } - }, - "documentation":"

Represents an event that failed to be submitted.

" - }, - "PutEventsResultEntryList":{ - "type":"list", - "member":{"shape":"PutEventsResultEntry"} - }, - "PutPermissionRequest":{ - "type":"structure", - "required":[ - "Action", - "Principal", - "StatementId" - ], - "members":{ - "Action":{ - "shape":"Action", - "documentation":"

The action that you are enabling the other account to perform. Currently, this must be events:PutEvents.

" - }, - "Principal":{ - "shape":"Principal", - "documentation":"

The 12-digit AWS account ID that you are permitting to put events to your default event bus. Specify \"*\" to permit any account to put events to your default event bus.

If you specify \"*\", avoid creating rules that may match undesirable events. To create more secure rules, make sure that the event pattern for each rule contains an account field with a specific account ID from which to receive events. Rules with an account field do not match any events sent from other accounts.

" - }, - "StatementId":{ - "shape":"StatementId", - "documentation":"

An identifier string for the external account that you are granting permissions to. If you later want to revoke the permission for this external account, specify this StatementId when you run RemovePermission.

" - } - } - }, - "PutRuleRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule that you are creating or updating.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\" or \"rate(5 minutes)\".

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern. For more information, see Events and Event Patterns in the Amazon CloudWatch Events User Guide.

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

Indicates whether the rule is enabled or disabled.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

A description of the rule.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role associated with the rule.

" - } - } - }, - "PutRuleResponse":{ - "type":"structure", - "members":{ - "RuleArn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - } - } - }, - "PutTargetsRequest":{ - "type":"structure", - "required":[ - "Rule", - "Targets" - ], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "Targets":{ - "shape":"TargetList", - "documentation":"

The targets to update or add to the rule.

" - } - } - }, - "PutTargetsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "FailedEntries":{ - "shape":"PutTargetsResultEntryList", - "documentation":"

The failed target entries.

" - } - } - }, - "PutTargetsResultEntry":{ - "type":"structure", - "members":{ - "TargetId":{ - "shape":"TargetId", - "documentation":"

The ID of the target.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code that indicates why the target addition failed. If the value is ConcurrentModificationException, too many requests were made at the same time.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message that explains why the target addition failed.

" - } - }, - "documentation":"

Represents a target that failed to be added to a rule.

" - }, - "PutTargetsResultEntryList":{ - "type":"list", - "member":{"shape":"PutTargetsResultEntry"} - }, - "RemovePermissionRequest":{ - "type":"structure", - "required":["StatementId"], - "members":{ - "StatementId":{ - "shape":"StatementId", - "documentation":"

The statement ID corresponding to the account that is no longer allowed to put events to the default event bus.

" - } - } - }, - "RemoveTargetsRequest":{ - "type":"structure", - "required":[ - "Rule", - "Ids" - ], - "members":{ - "Rule":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "Ids":{ - "shape":"TargetIdList", - "documentation":"

The IDs of the targets to remove from the rule.

" - } - } - }, - "RemoveTargetsResponse":{ - "type":"structure", - "members":{ - "FailedEntryCount":{ - "shape":"Integer", - "documentation":"

The number of failed entries.

" - }, - "FailedEntries":{ - "shape":"RemoveTargetsResultEntryList", - "documentation":"

The failed target entries.

" - } - } - }, - "RemoveTargetsResultEntry":{ - "type":"structure", - "members":{ - "TargetId":{ - "shape":"TargetId", - "documentation":"

The ID of the target.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code that indicates why the target removal failed. If the value is ConcurrentModificationException, too many requests were made at the same time.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message that explains why the target removal failed.

" - } - }, - "documentation":"

Represents a target that failed to be removed from a rule.

" - }, - "RemoveTargetsResultEntryList":{ - "type":"list", - "member":{"shape":"RemoveTargetsResultEntry"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An entity that you specified does not exist.

", - "exception":true - }, - "RoleArn":{ - "type":"string", - "max":1600, - "min":1 - }, - "Rule":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "Arn":{ - "shape":"RuleArn", - "documentation":"

The Amazon Resource Name (ARN) of the rule.

" - }, - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon CloudWatch Events User Guide.

" - }, - "State":{ - "shape":"RuleState", - "documentation":"

The state of the rule.

" - }, - "Description":{ - "shape":"RuleDescription", - "documentation":"

The description of the rule.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\".

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the role that is used for target invocation.

" - } - }, - "documentation":"

Contains information about a rule in Amazon CloudWatch Events.

" - }, - "RuleArn":{ - "type":"string", - "max":1600, - "min":1 - }, - "RuleDescription":{ - "type":"string", - "max":512 - }, - "RuleName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\.\\-_A-Za-z0-9]+" - }, - "RuleNameList":{ - "type":"list", - "member":{"shape":"RuleName"} - }, - "RuleResponseList":{ - "type":"list", - "member":{"shape":"Rule"} - }, - "RuleState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "RunCommandParameters":{ - "type":"structure", - "required":["RunCommandTargets"], - "members":{ - "RunCommandTargets":{ - "shape":"RunCommandTargets", - "documentation":"

Currently, we support including only one RunCommandTarget block, which specifies either an array of InstanceIds or a tag.

" - } - }, - "documentation":"

This parameter contains the criteria (either InstanceIds or a tag) used to specify which EC2 instances are to be sent the command.

" - }, - "RunCommandTarget":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"RunCommandTargetKey", - "documentation":"

Can be either tag: tag-key or InstanceIds.

" - }, - "Values":{ - "shape":"RunCommandTargetValues", - "documentation":"

If Key is tag: tag-key, Values is a list of tag values. If Key is InstanceIds, Values is a list of Amazon EC2 instance IDs.

" - } - }, - "documentation":"

Information about the EC2 instances that are to be sent the command, specified as key-value pairs. Each RunCommandTarget block can include only one key, but this key may specify multiple values.

" - }, - "RunCommandTargetKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*$" - }, - "RunCommandTargetValue":{ - "type":"string", - "max":256, - "min":1 - }, - "RunCommandTargetValues":{ - "type":"list", - "member":{"shape":"RunCommandTargetValue"}, - "max":50, - "min":1 - }, - "RunCommandTargets":{ - "type":"list", - "member":{"shape":"RunCommandTarget"}, - "max":5, - "min":1 - }, - "ScheduleExpression":{ - "type":"string", - "max":256 - }, - "SqsParameters":{ - "type":"structure", - "members":{ - "MessageGroupId":{ - "shape":"MessageGroupId", - "documentation":"

The FIFO message group ID to use as the target.

" - } - }, - "documentation":"

This structure includes the custom parameter to be used when the target is an SQS FIFO queue.

" - }, - "StatementId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z0-9-_]+" - }, - "String":{"type":"string"}, - "Target":{ - "type":"structure", - "required":[ - "Id", - "Arn" - ], - "members":{ - "Id":{ - "shape":"TargetId", - "documentation":"

The ID of the target.

" - }, - "Arn":{ - "shape":"TargetArn", - "documentation":"

The Amazon Resource Name (ARN) of the target.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.

" - }, - "Input":{ - "shape":"TargetInput", - "documentation":"

Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see The JavaScript Object Notation (JSON) Data Interchange Format.

" - }, - "InputPath":{ - "shape":"TargetInputPath", - "documentation":"

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see JSONPath.

" - }, - "InputTransformer":{ - "shape":"InputTransformer", - "documentation":"

Settings to enable you to provide custom input to a target based on certain event data. You can extract one or more key-value pairs from the event and then use that data to send customized input to the target.

" - }, - "KinesisParameters":{ - "shape":"KinesisParameters", - "documentation":"

The custom parameter you can use to control shard assignment, when the target is an Amazon Kinesis stream. If you do not include this parameter, the default is to use the eventId as the partition key.

" - }, - "RunCommandParameters":{ - "shape":"RunCommandParameters", - "documentation":"

Parameters used when you are using the rule to invoke Amazon EC2 Run Command.

" - }, - "EcsParameters":{ - "shape":"EcsParameters", - "documentation":"

Contains the Amazon ECS task definition and task count to be used, if the event target is an Amazon ECS task. For more information about Amazon ECS tasks, see Task Definitions in the Amazon EC2 Container Service Developer Guide.

" - }, - "BatchParameters":{ - "shape":"BatchParameters", - "documentation":"

Contains the job definition, job name, and other parameters if the event target is an AWS Batch job. For more information about AWS Batch, see Jobs in the AWS Batch User Guide.

" - }, - "SqsParameters":{ - "shape":"SqsParameters", - "documentation":"

Contains the message group ID to use when the target is a FIFO queue.

" - } - }, - "documentation":"

Targets are the resources to be invoked when a rule is triggered. Target types include EC2 instances, AWS Lambda functions, Amazon Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines, Run Command, and built-in targets.

" - }, - "TargetArn":{ - "type":"string", - "max":1600, - "min":1 - }, - "TargetId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\.\\-_A-Za-z0-9]+" - }, - "TargetIdList":{ - "type":"list", - "member":{"shape":"TargetId"}, - "max":100, - "min":1 - }, - "TargetInput":{ - "type":"string", - "max":8192 - }, - "TargetInputPath":{ - "type":"string", - "max":256 - }, - "TargetList":{ - "type":"list", - "member":{"shape":"Target"}, - "max":100, - "min":1 - }, - "TargetPartitionKeyPath":{ - "type":"string", - "max":256 - }, - "TestEventPatternRequest":{ - "type":"structure", - "required":[ - "EventPattern", - "Event" - ], - "members":{ - "EventPattern":{ - "shape":"EventPattern", - "documentation":"

The event pattern. For more information, see Events and Event Patterns in the Amazon CloudWatch Events User Guide.

" - }, - "Event":{ - "shape":"String", - "documentation":"

The event, in JSON format, to test against the event pattern.

" - } - } - }, - "TestEventPatternResponse":{ - "type":"structure", - "members":{ - "Result":{ - "shape":"Boolean", - "documentation":"

Indicates whether the event matches the event pattern.

" - } - } - }, - "TransformerInput":{ - "type":"string", - "max":8192, - "min":1 - }, - "TransformerPaths":{ - "type":"map", - "key":{"shape":"InputTransformerPathKey"}, - "value":{"shape":"TargetInputPath"}, - "max":10 - } - }, - "documentation":"

Amazon CloudWatch Events helps you to respond to state changes in your AWS resources. When your resources change state, they automatically send events into an event stream. You can create rules that match selected events in the stream and route them to targets to take action. You can also use rules to take action on a pre-determined schedule. For example, you can configure rules to:

  • Automatically invoke an AWS Lambda function to update DNS entries when an event notifies you that Amazon EC2 instance enters the running state.

  • Direct specific API records from CloudTrail to an Amazon Kinesis stream for detailed analysis of potential security or availability risks.

  • Periodically invoke a built-in target to create a snapshot of an Amazon EBS volume.

For more information about the features of Amazon CloudWatch Events, see the Amazon CloudWatch Events User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/service-2.json deleted file mode 100644 index 1e1fef61..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/firehose/2015-08-04/service-2.json +++ /dev/null @@ -1,2194 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-08-04", - "endpointPrefix":"firehose", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Firehose", - "serviceFullName":"Amazon Kinesis Firehose", - "serviceId":"Firehose", - "signatureVersion":"v4", - "targetPrefix":"Firehose_20150804", - "uid":"firehose-2015-08-04" - }, - "operations":{ - "CreateDeliveryStream":{ - "name":"CreateDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDeliveryStreamInput"}, - "output":{"shape":"CreateDeliveryStreamOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Creates a Kinesis Data Firehose delivery stream.

By default, you can create up to 50 delivery streams per AWS Region.

This is an asynchronous operation that immediately returns. The initial status of the delivery stream is CREATING. After the delivery stream is created, its status is ACTIVE and it now accepts data. Attempts to send data to a delivery stream that is not in the ACTIVE state cause an exception. To check the state of a delivery stream, use DescribeDeliveryStream.

A Kinesis Data Firehose delivery stream can be configured to receive records directly from providers using PutRecord or PutRecordBatch, or it can be configured to use an existing Kinesis stream as its source. To specify a Kinesis data stream as input, set the DeliveryStreamType parameter to KinesisStreamAsSource, and provide the Kinesis stream Amazon Resource Name (ARN) and role ARN in the KinesisStreamSourceConfiguration parameter.

A delivery stream is configured with a single destination: Amazon S3, Amazon ES, Amazon Redshift, or Splunk. You must specify only one of the following destination configuration parameters: ExtendedS3DestinationConfiguration, S3DestinationConfiguration, ElasticsearchDestinationConfiguration, RedshiftDestinationConfiguration, or SplunkDestinationConfiguration.

When you specify S3DestinationConfiguration, you can also provide the following optional values: BufferingHints, EncryptionConfiguration, and CompressionFormat. By default, if no BufferingHints value is provided, Kinesis Data Firehose buffers data up to 5 MB or for 5 minutes, whichever condition is satisfied first. BufferingHints is a hint, so there are some cases where the service cannot adhere to these conditions strictly. For example, record boundaries might be such that the size is a little over or under the configured buffering size. By default, no encryption is performed. We strongly recommend that you enable encryption to ensure secure data storage in Amazon S3.

A few notes about Amazon Redshift as a destination:

  • An Amazon Redshift destination requires an S3 bucket as intermediate location. Kinesis Data Firehose first delivers data to Amazon S3 and then uses COPY syntax to load data into an Amazon Redshift table. This is specified in the RedshiftDestinationConfiguration.S3Configuration parameter.

  • The compression formats SNAPPY or ZIP cannot be specified in RedshiftDestinationConfiguration.S3Configuration because the Amazon Redshift COPY operation that reads from the S3 bucket doesn't support these compression formats.

  • We strongly recommend that you use the user name and password you provide exclusively with Kinesis Data Firehose, and that the permissions for the account are restricted for Amazon Redshift INSERT permissions.

Kinesis Data Firehose assumes the IAM role that is configured as part of the destination. The role should allow the Kinesis Data Firehose principal to assume the role, and the role should have permissions that allow the service to deliver the data. For more information, see Grant Kinesis Data Firehose Access to an Amazon S3 Destination in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "DeleteDeliveryStream":{ - "name":"DeleteDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDeliveryStreamInput"}, - "output":{"shape":"DeleteDeliveryStreamOutput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a delivery stream and its data.

You can delete a delivery stream only if it is in ACTIVE or DELETING state, and not in the CREATING state. While the deletion request is in process, the delivery stream is in the DELETING state.

To check the state of a delivery stream, use DescribeDeliveryStream.

While the delivery stream is DELETING state, the service might continue to accept the records, but it doesn't make any guarantees with respect to delivering the data. Therefore, as a best practice, you should first stop any applications that are sending records before deleting a delivery stream.

" - }, - "DescribeDeliveryStream":{ - "name":"DescribeDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDeliveryStreamInput"}, - "output":{"shape":"DescribeDeliveryStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the specified delivery stream and gets the status. For example, after your delivery stream is created, call DescribeDeliveryStream to see whether the delivery stream is ACTIVE and therefore ready for data to be sent to it.

" - }, - "ListDeliveryStreams":{ - "name":"ListDeliveryStreams", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeliveryStreamsInput"}, - "output":{"shape":"ListDeliveryStreamsOutput"}, - "documentation":"

Lists your delivery streams.

The number of delivery streams might be too large to return using a single call to ListDeliveryStreams. You can limit the number of delivery streams returned, using the Limit parameter. To determine whether there are more delivery streams to list, check the value of HasMoreDeliveryStreams in the output. If there are more delivery streams to list, you can request them by specifying the name of the last delivery stream returned in the call in the ExclusiveStartDeliveryStreamName parameter of a subsequent call.

" - }, - "ListTagsForDeliveryStream":{ - "name":"ListTagsForDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForDeliveryStreamInput"}, - "output":{"shape":"ListTagsForDeliveryStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Lists the tags for the specified delivery stream. This operation has a limit of five transactions per second per account.

" - }, - "PutRecord":{ - "name":"PutRecord", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRecordInput"}, - "output":{"shape":"PutRecordOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Writes a single data record into an Amazon Kinesis Data Firehose delivery stream. To write multiple data records into a delivery stream, use PutRecordBatch. Applications using these operations are referred to as producers.

By default, each delivery stream can take in up to 2,000 transactions per second, 5,000 records per second, or 5 MB per second. If you use PutRecord and PutRecordBatch, the limits are an aggregate across these two operations for each delivery stream. For more information about limits and how to request an increase, see Amazon Kinesis Data Firehose Limits.

You must specify the name of the delivery stream and the data record when using PutRecord. The data record consists of a data blob that can be up to 1,000 KB in size, and any kind of data. For example, it can be a segment from a log file, geographic location data, website clickstream data, and so on.

Kinesis Data Firehose buffers records before delivering them to the destination. To disambiguate the data blobs at the destination, a common solution is to use delimiters in the data, such as a newline (\\n) or some other character unique within the data. This allows the consumer application to parse individual data items when reading the data from the destination.

The PutRecord operation returns a RecordId, which is a unique string assigned to each record. Producer applications can use this ID for purposes such as auditability and investigation.

If the PutRecord operation throws a ServiceUnavailableException, back off and retry. If the exception persists, it is possible that the throughput limits have been exceeded for the delivery stream.

Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they are added to a delivery stream as it tries to send the records to the destination. If the destination is unreachable for more than 24 hours, the data is no longer available.

" - }, - "PutRecordBatch":{ - "name":"PutRecordBatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRecordBatchInput"}, - "output":{"shape":"PutRecordBatchOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Writes multiple data records into a delivery stream in a single call, which can achieve higher throughput per producer than when writing single records. To write single data records into a delivery stream, use PutRecord. Applications using these operations are referred to as producers.

By default, each delivery stream can take in up to 2,000 transactions per second, 5,000 records per second, or 5 MB per second. If you use PutRecord and PutRecordBatch, the limits are an aggregate across these two operations for each delivery stream. For more information about limits, see Amazon Kinesis Data Firehose Limits.

Each PutRecordBatch request supports up to 500 records. Each record in the request can be as large as 1,000 KB (before 64-bit encoding), up to a limit of 4 MB for the entire request. These limits cannot be changed.

You must specify the name of the delivery stream and the data record when using PutRecord. The data record consists of a data blob that can be up to 1,000 KB in size, and any kind of data. For example, it could be a segment from a log file, geographic location data, website clickstream data, and so on.

Kinesis Data Firehose buffers records before delivering them to the destination. To disambiguate the data blobs at the destination, a common solution is to use delimiters in the data, such as a newline (\\n) or some other character unique within the data. This allows the consumer application to parse individual data items when reading the data from the destination.

The PutRecordBatch response includes a count of failed records, FailedPutCount, and an array of responses, RequestResponses. Each entry in the RequestResponses array provides additional information about the processed record. It directly correlates with a record in the request array using the same ordering, from the top to the bottom. The response array always includes the same number of records as the request array. RequestResponses includes both successfully and unsuccessfully processed records. Kinesis Data Firehose tries to process all records in each PutRecordBatch request. A single record failure does not stop the processing of subsequent records.

A successfully processed record includes a RecordId value, which is unique for the record. An unsuccessfully processed record includes ErrorCode and ErrorMessage values. ErrorCode reflects the type of error, and is one of the following values: ServiceUnavailable or InternalFailure. ErrorMessage provides more detailed information about the error.

If there is an internal server error or a timeout, the write might have completed or it might have failed. If FailedPutCount is greater than 0, retry the request, resending only those records that might have failed processing. This minimizes the possible duplicate records and also reduces the total bytes sent (and corresponding charges). We recommend that you handle any duplicates at the destination.

If PutRecordBatch throws ServiceUnavailableException, back off and retry. If the exception persists, it is possible that the throughput limits have been exceeded for the delivery stream.

Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they are added to a delivery stream as it attempts to send the records to the destination. If the destination is unreachable for more than 24 hours, the data is no longer available.

" - }, - "TagDeliveryStream":{ - "name":"TagDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagDeliveryStreamInput"}, - "output":{"shape":"TagDeliveryStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Adds or updates tags for the specified delivery stream. A tag is a key-value pair (the value is optional) that you can define and assign to AWS resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. Tags are metadata. For example, you can add friendly names and descriptions or other types of information that can help you distinguish the delivery stream. For more information about tags, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

Each delivery stream can have up to 50 tags.

This operation has a limit of five transactions per second per account.

" - }, - "UntagDeliveryStream":{ - "name":"UntagDeliveryStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagDeliveryStreamInput"}, - "output":{"shape":"UntagDeliveryStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Removes tags from the specified delivery stream. Removed tags are deleted, and you can't recover them after this operation successfully completes.

If you specify a tag that doesn't exist, the operation ignores it.

This operation has a limit of five transactions per second per account.

" - }, - "UpdateDestination":{ - "name":"UpdateDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDestinationInput"}, - "output":{"shape":"UpdateDestinationOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Updates the specified destination of the specified delivery stream.

Use this operation to change the destination type (for example, to replace the Amazon S3 destination with Amazon Redshift) or change the parameters associated with a destination (for example, to change the bucket name of the Amazon S3 destination). The update might not occur immediately. The target delivery stream remains active while the configurations are updated, so data writes to the delivery stream can continue during this process. The updated configurations are usually effective within a few minutes.

Switching between Amazon ES and other services is not supported. For an Amazon ES destination, you can only update to another Amazon ES destination.

If the destination type is the same, Kinesis Data Firehose merges the configuration parameters specified with the destination configuration that already exists on the delivery stream. If any of the parameters are not specified in the call, the existing values are retained. For example, in the Amazon S3 destination, if EncryptionConfiguration is not specified, then the existing EncryptionConfiguration is maintained on the destination.

If the destination type is not the same, for example, changing the destination from Amazon S3 to Amazon Redshift, Kinesis Data Firehose does not merge any parameters. In this case, all parameters must be specified.

Kinesis Data Firehose uses CurrentDeliveryStreamVersionId to avoid race conditions and conflicting merges. This is a required field, and the service updates the configuration only if the existing configuration has a version ID that matches. After the update is applied successfully, the version ID is updated, and can be retrieved using DescribeDeliveryStream. Use the new version ID to set CurrentDeliveryStreamVersionId in the next call.

" - } - }, - "shapes":{ - "AWSKMSKeyARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "BlockSizeBytes":{ - "type":"integer", - "min":67108864 - }, - "BooleanObject":{"type":"boolean"}, - "BucketARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:.*" - }, - "BufferingHints":{ - "type":"structure", - "members":{ - "SizeInMBs":{ - "shape":"SizeInMBs", - "documentation":"

Buffer incoming data to the specified size, in MBs, before delivering it to the destination. The default value is 5.

We recommend setting this parameter to a value greater than the amount of data you typically ingest into the delivery stream in 10 seconds. For example, if you typically ingest data at 1 MB/sec, the value should be 10 MB or higher.

" - }, - "IntervalInSeconds":{ - "shape":"IntervalInSeconds", - "documentation":"

Buffer incoming data for the specified period of time, in seconds, before delivering it to the destination. The default value is 300.

" - } - }, - "documentation":"

Describes hints for the buffering to perform before delivering data to the destination. These options are treated as hints, and therefore Kinesis Data Firehose might choose to use different values when it is optimal.

" - }, - "CloudWatchLoggingOptions":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables CloudWatch logging.

" - }, - "LogGroupName":{ - "shape":"LogGroupName", - "documentation":"

The CloudWatch group name for logging. This value is required if CloudWatch logging is enabled.

" - }, - "LogStreamName":{ - "shape":"LogStreamName", - "documentation":"

The CloudWatch log stream name for logging. This value is required if CloudWatch logging is enabled.

" - } - }, - "documentation":"

Describes the Amazon CloudWatch logging options for your delivery stream.

" - }, - "ClusterJDBCURL":{ - "type":"string", - "min":1, - "pattern":"jdbc:(redshift|postgresql)://((?!-)[A-Za-z0-9-]{1,63}(?A message that provides information about the error.

" - } - }, - "documentation":"

Another modification has already happened. Fetch VersionId again and use it to update the destination.

", - "exception":true - }, - "CopyCommand":{ - "type":"structure", - "required":["DataTableName"], - "members":{ - "DataTableName":{ - "shape":"DataTableName", - "documentation":"

The name of the target table. The table must already exist in the database.

" - }, - "DataTableColumns":{ - "shape":"DataTableColumns", - "documentation":"

A comma-separated list of column names.

" - }, - "CopyOptions":{ - "shape":"CopyOptions", - "documentation":"

Optional parameters to use with the Amazon Redshift COPY command. For more information, see the \"Optional Parameters\" section of Amazon Redshift COPY command. Some possible examples that would apply to Kinesis Data Firehose are as follows:

delimiter '\\t' lzop; - fields are delimited with \"\\t\" (TAB character) and compressed using lzop.

delimiter '|' - fields are delimited with \"|\" (this is the default delimiter).

delimiter '|' escape - the delimiter should be escaped.

fixedwidth 'venueid:3,venuename:25,venuecity:12,venuestate:2,venueseats:6' - fields are fixed width in the source, with each width specified after every column in the table.

JSON 's3://mybucket/jsonpaths.txt' - data is in JSON format, and the path specified is the format of the data.

For more examples, see Amazon Redshift COPY command examples.

" - } - }, - "documentation":"

Describes a COPY command for Amazon Redshift.

" - }, - "CopyOptions":{"type":"string"}, - "CreateDeliveryStreamInput":{ - "type":"structure", - "required":["DeliveryStreamName"], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream. This name must be unique per AWS account in the same AWS Region. If the delivery streams are in different accounts or different Regions, you can have multiple delivery streams with the same name.

" - }, - "DeliveryStreamType":{ - "shape":"DeliveryStreamType", - "documentation":"

The delivery stream type. This parameter can be one of the following values:

  • DirectPut: Provider applications access the delivery stream directly.

  • KinesisStreamAsSource: The delivery stream uses a Kinesis data stream as a source.

" - }, - "KinesisStreamSourceConfiguration":{ - "shape":"KinesisStreamSourceConfiguration", - "documentation":"

When a Kinesis data stream is used as the source for the delivery stream, a KinesisStreamSourceConfiguration containing the Kinesis data stream Amazon Resource Name (ARN) and the role ARN for the source stream.

" - }, - "S3DestinationConfiguration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

[Deprecated] The destination in Amazon S3. You can specify only one destination.

", - "deprecated":true - }, - "ExtendedS3DestinationConfiguration":{ - "shape":"ExtendedS3DestinationConfiguration", - "documentation":"

The destination in Amazon S3. You can specify only one destination.

" - }, - "RedshiftDestinationConfiguration":{ - "shape":"RedshiftDestinationConfiguration", - "documentation":"

The destination in Amazon Redshift. You can specify only one destination.

" - }, - "ElasticsearchDestinationConfiguration":{ - "shape":"ElasticsearchDestinationConfiguration", - "documentation":"

The destination in Amazon ES. You can specify only one destination.

" - }, - "SplunkDestinationConfiguration":{ - "shape":"SplunkDestinationConfiguration", - "documentation":"

The destination in Splunk. You can specify only one destination.

" - } - } - }, - "CreateDeliveryStreamOutput":{ - "type":"structure", - "members":{ - "DeliveryStreamARN":{ - "shape":"DeliveryStreamARN", - "documentation":"

The ARN of the delivery stream.

" - } - } - }, - "Data":{ - "type":"blob", - "max":1024000, - "min":0 - }, - "DataFormatConversionConfiguration":{ - "type":"structure", - "members":{ - "SchemaConfiguration":{ - "shape":"SchemaConfiguration", - "documentation":"

Specifies the AWS Glue Data Catalog table that contains the column information.

" - }, - "InputFormatConfiguration":{ - "shape":"InputFormatConfiguration", - "documentation":"

Specifies the deserializer that you want Kinesis Data Firehose to use to convert the format of your data from JSON.

" - }, - "OutputFormatConfiguration":{ - "shape":"OutputFormatConfiguration", - "documentation":"

Specifies the serializer that you want Kinesis Data Firehose to use to convert the format of your data to the Parquet or ORC format.

" - }, - "Enabled":{ - "shape":"BooleanObject", - "documentation":"

Defaults to true. Set it to false if you want to disable format conversion while preserving the configuration details.

" - } - }, - "documentation":"

Specifies that you want Kinesis Data Firehose to convert data from the JSON format to the Parquet or ORC format before writing it to Amazon S3. Kinesis Data Firehose uses the serializer and deserializer that you specify, in addition to the column information from the AWS Glue table, to deserialize your input data from JSON and then serialize it to the Parquet or ORC format. For more information, see Kinesis Data Firehose Record Format Conversion.

" - }, - "DataTableColumns":{"type":"string"}, - "DataTableName":{ - "type":"string", - "min":1 - }, - "DeleteDeliveryStreamInput":{ - "type":"structure", - "required":["DeliveryStreamName"], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - } - } - }, - "DeleteDeliveryStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "DeliveryStartTimestamp":{"type":"timestamp"}, - "DeliveryStreamARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "DeliveryStreamDescription":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "DeliveryStreamARN", - "DeliveryStreamStatus", - "DeliveryStreamType", - "VersionId", - "Destinations", - "HasMoreDestinations" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "DeliveryStreamARN":{ - "shape":"DeliveryStreamARN", - "documentation":"

The Amazon Resource Name (ARN) of the delivery stream. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "DeliveryStreamStatus":{ - "shape":"DeliveryStreamStatus", - "documentation":"

The status of the delivery stream.

" - }, - "DeliveryStreamType":{ - "shape":"DeliveryStreamType", - "documentation":"

The delivery stream type. This can be one of the following values:

  • DirectPut: Provider applications access the delivery stream directly.

  • KinesisStreamAsSource: The delivery stream uses a Kinesis data stream as a source.

" - }, - "VersionId":{ - "shape":"DeliveryStreamVersionId", - "documentation":"

Each time the destination is updated for a delivery stream, the version ID is changed, and the current version ID is required when updating the destination. This is so that the service knows it is applying the changes to the correct version of the delivery stream.

" - }, - "CreateTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the delivery stream was created.

" - }, - "LastUpdateTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the delivery stream was last updated.

" - }, - "Source":{ - "shape":"SourceDescription", - "documentation":"

If the DeliveryStreamType parameter is KinesisStreamAsSource, a SourceDescription object describing the source Kinesis data stream.

" - }, - "Destinations":{ - "shape":"DestinationDescriptionList", - "documentation":"

The destinations.

" - }, - "HasMoreDestinations":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether there are more destinations available to list.

" - } - }, - "documentation":"

Contains information about a delivery stream.

" - }, - "DeliveryStreamName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "DeliveryStreamNameList":{ - "type":"list", - "member":{"shape":"DeliveryStreamName"} - }, - "DeliveryStreamStatus":{ - "type":"string", - "enum":[ - "CREATING", - "DELETING", - "ACTIVE" - ] - }, - "DeliveryStreamType":{ - "type":"string", - "enum":[ - "DirectPut", - "KinesisStreamAsSource" - ] - }, - "DeliveryStreamVersionId":{ - "type":"string", - "max":50, - "min":1, - "pattern":"[0-9]+" - }, - "DescribeDeliveryStreamInput":{ - "type":"structure", - "required":["DeliveryStreamName"], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "Limit":{ - "shape":"DescribeDeliveryStreamInputLimit", - "documentation":"

The limit on the number of destinations to return. You can have one destination per delivery stream.

" - }, - "ExclusiveStartDestinationId":{ - "shape":"DestinationId", - "documentation":"

The ID of the destination to start returning the destination information. Kinesis Data Firehose supports one destination per delivery stream.

" - } - } - }, - "DescribeDeliveryStreamInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "DescribeDeliveryStreamOutput":{ - "type":"structure", - "required":["DeliveryStreamDescription"], - "members":{ - "DeliveryStreamDescription":{ - "shape":"DeliveryStreamDescription", - "documentation":"

Information about the delivery stream.

" - } - } - }, - "Deserializer":{ - "type":"structure", - "members":{ - "OpenXJsonSerDe":{ - "shape":"OpenXJsonSerDe", - "documentation":"

The OpenX SerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for serializing it to the Parquet or ORC format. This is one of two deserializers you can choose, depending on which one offers the functionality you need. The other option is the native Hive / HCatalog JsonSerDe.

" - }, - "HiveJsonSerDe":{ - "shape":"HiveJsonSerDe", - "documentation":"

The native Hive / HCatalog JsonSerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for serializing it to the Parquet or ORC format. This is one of two deserializers you can choose, depending on which one offers the functionality you need. The other option is the OpenX SerDe.

" - } - }, - "documentation":"

The deserializer you want Kinesis Data Firehose to use for converting the input data from JSON. Kinesis Data Firehose then serializes the data to its final format using the Serializer. Kinesis Data Firehose supports two types of deserializers: the Apache Hive JSON SerDe and the OpenX JSON SerDe.

" - }, - "DestinationDescription":{ - "type":"structure", - "required":["DestinationId"], - "members":{ - "DestinationId":{ - "shape":"DestinationId", - "documentation":"

The ID of the destination.

" - }, - "S3DestinationDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

[Deprecated] The destination in Amazon S3.

" - }, - "ExtendedS3DestinationDescription":{ - "shape":"ExtendedS3DestinationDescription", - "documentation":"

The destination in Amazon S3.

" - }, - "RedshiftDestinationDescription":{ - "shape":"RedshiftDestinationDescription", - "documentation":"

The destination in Amazon Redshift.

" - }, - "ElasticsearchDestinationDescription":{ - "shape":"ElasticsearchDestinationDescription", - "documentation":"

The destination in Amazon ES.

" - }, - "SplunkDestinationDescription":{ - "shape":"SplunkDestinationDescription", - "documentation":"

The destination in Splunk.

" - } - }, - "documentation":"

Describes the destination for a delivery stream.

" - }, - "DestinationDescriptionList":{ - "type":"list", - "member":{"shape":"DestinationDescription"} - }, - "DestinationId":{ - "type":"string", - "max":100, - "min":1 - }, - "ElasticsearchBufferingHints":{ - "type":"structure", - "members":{ - "IntervalInSeconds":{ - "shape":"ElasticsearchBufferingIntervalInSeconds", - "documentation":"

Buffer incoming data for the specified period of time, in seconds, before delivering it to the destination. The default value is 300 (5 minutes).

" - }, - "SizeInMBs":{ - "shape":"ElasticsearchBufferingSizeInMBs", - "documentation":"

Buffer incoming data to the specified size, in MBs, before delivering it to the destination. The default value is 5.

We recommend setting this parameter to a value greater than the amount of data you typically ingest into the delivery stream in 10 seconds. For example, if you typically ingest data at 1 MB/sec, the value should be 10 MB or higher.

" - } - }, - "documentation":"

Describes the buffering to perform before delivering data to the Amazon ES destination.

" - }, - "ElasticsearchBufferingIntervalInSeconds":{ - "type":"integer", - "max":900, - "min":60 - }, - "ElasticsearchBufferingSizeInMBs":{ - "type":"integer", - "max":100, - "min":1 - }, - "ElasticsearchDestinationConfiguration":{ - "type":"structure", - "required":[ - "RoleARN", - "DomainARN", - "IndexName", - "TypeName", - "S3Configuration" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to be assumed by Kinesis Data Firehose for calling the Amazon ES Configuration API and for indexing documents. For more information, see Grant Kinesis Data Firehose Access to an Amazon S3 Destination and Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "DomainARN":{ - "shape":"ElasticsearchDomainARN", - "documentation":"

The ARN of the Amazon ES domain. The IAM role must have permissions for DescribeElasticsearchDomain, DescribeElasticsearchDomains, and DescribeElasticsearchDomainConfig after assuming the role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "IndexName":{ - "shape":"ElasticsearchIndexName", - "documentation":"

The Elasticsearch index name.

" - }, - "TypeName":{ - "shape":"ElasticsearchTypeName", - "documentation":"

The Elasticsearch type name. For Elasticsearch 6.x, there can be only one type per index. If you try to specify a new type for an existing index that already has another type, Kinesis Data Firehose returns an error during run time.

" - }, - "IndexRotationPeriod":{ - "shape":"ElasticsearchIndexRotationPeriod", - "documentation":"

The Elasticsearch index rotation period. Index rotation appends a time stamp to the IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. The default value is OneDay.

" - }, - "BufferingHints":{ - "shape":"ElasticsearchBufferingHints", - "documentation":"

The buffering options. If no value is specified, the default values for ElasticsearchBufferingHints are used.

" - }, - "RetryOptions":{ - "shape":"ElasticsearchRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).

" - }, - "S3BackupMode":{ - "shape":"ElasticsearchS3BackupMode", - "documentation":"

Defines how documents should be delivered to Amazon S3. When it is set to FailedDocumentsOnly, Kinesis Data Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, with elasticsearch-failed/ appended to the key prefix. When set to AllDocuments, Kinesis Data Firehose delivers all incoming records to Amazon S3, and also writes failed documents with elasticsearch-failed/ appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination. Default value is FailedDocumentsOnly.

" - }, - "S3Configuration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

The configuration for the backup Amazon S3 location.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes the configuration of a destination in Amazon ES.

" - }, - "ElasticsearchDestinationDescription":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "DomainARN":{ - "shape":"ElasticsearchDomainARN", - "documentation":"

The ARN of the Amazon ES domain. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "IndexName":{ - "shape":"ElasticsearchIndexName", - "documentation":"

The Elasticsearch index name.

" - }, - "TypeName":{ - "shape":"ElasticsearchTypeName", - "documentation":"

The Elasticsearch type name.

" - }, - "IndexRotationPeriod":{ - "shape":"ElasticsearchIndexRotationPeriod", - "documentation":"

The Elasticsearch index rotation period

" - }, - "BufferingHints":{ - "shape":"ElasticsearchBufferingHints", - "documentation":"

The buffering options.

" - }, - "RetryOptions":{ - "shape":"ElasticsearchRetryOptions", - "documentation":"

The Amazon ES retry options.

" - }, - "S3BackupMode":{ - "shape":"ElasticsearchS3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3DestinationDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

The Amazon S3 destination.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options.

" - } - }, - "documentation":"

The destination description in Amazon ES.

" - }, - "ElasticsearchDestinationUpdate":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to be assumed by Kinesis Data Firehose for calling the Amazon ES Configuration API and for indexing documents. For more information, see Grant Kinesis Data Firehose Access to an Amazon S3 Destination and Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "DomainARN":{ - "shape":"ElasticsearchDomainARN", - "documentation":"

The ARN of the Amazon ES domain. The IAM role must have permissions for DescribeElasticsearchDomain, DescribeElasticsearchDomains, and DescribeElasticsearchDomainConfig after assuming the IAM role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "IndexName":{ - "shape":"ElasticsearchIndexName", - "documentation":"

The Elasticsearch index name.

" - }, - "TypeName":{ - "shape":"ElasticsearchTypeName", - "documentation":"

The Elasticsearch type name. For Elasticsearch 6.x, there can be only one type per index. If you try to specify a new type for an existing index that already has another type, Kinesis Data Firehose returns an error during runtime.

" - }, - "IndexRotationPeriod":{ - "shape":"ElasticsearchIndexRotationPeriod", - "documentation":"

The Elasticsearch index rotation period. Index rotation appends a time stamp to IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value is OneDay.

" - }, - "BufferingHints":{ - "shape":"ElasticsearchBufferingHints", - "documentation":"

The buffering options. If no value is specified, ElasticsearchBufferingHints object default values are used.

" - }, - "RetryOptions":{ - "shape":"ElasticsearchRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).

" - }, - "S3Update":{ - "shape":"S3DestinationUpdate", - "documentation":"

The Amazon S3 destination.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes an update for a destination in Amazon ES.

" - }, - "ElasticsearchDomainARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "ElasticsearchIndexName":{ - "type":"string", - "max":80, - "min":1 - }, - "ElasticsearchIndexRotationPeriod":{ - "type":"string", - "enum":[ - "NoRotation", - "OneHour", - "OneDay", - "OneWeek", - "OneMonth" - ] - }, - "ElasticsearchRetryDurationInSeconds":{ - "type":"integer", - "max":7200, - "min":0 - }, - "ElasticsearchRetryOptions":{ - "type":"structure", - "members":{ - "DurationInSeconds":{ - "shape":"ElasticsearchRetryDurationInSeconds", - "documentation":"

After an initial failure to deliver to Amazon ES, the total amount of time during which Kinesis Data Firehose retries delivery (including the first attempt). After this time has elapsed, the failed documents are written to Amazon S3. Default value is 300 seconds (5 minutes). A value of 0 (zero) results in no retries.

" - } - }, - "documentation":"

Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon ES.

" - }, - "ElasticsearchS3BackupMode":{ - "type":"string", - "enum":[ - "FailedDocumentsOnly", - "AllDocuments" - ] - }, - "ElasticsearchTypeName":{ - "type":"string", - "max":100, - "min":1 - }, - "EncryptionConfiguration":{ - "type":"structure", - "members":{ - "NoEncryptionConfig":{ - "shape":"NoEncryptionConfig", - "documentation":"

Specifically override existing encryption information to ensure that no encryption is used.

" - }, - "KMSEncryptionConfig":{ - "shape":"KMSEncryptionConfig", - "documentation":"

The encryption key.

" - } - }, - "documentation":"

Describes the encryption for a destination in Amazon S3.

" - }, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "ExtendedS3DestinationConfiguration":{ - "type":"structure", - "required":[ - "RoleARN", - "BucketARN" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"S3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3BackupConfiguration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

The configuration for backup in Amazon S3.

" - }, - "DataFormatConversionConfiguration":{ - "shape":"DataFormatConversionConfiguration", - "documentation":"

The serializer, deserializer, and schema for converting data from the JSON format to the Parquet or ORC format before writing it to Amazon S3.

" - } - }, - "documentation":"

Describes the configuration of a destination in Amazon S3.

" - }, - "ExtendedS3DestinationDescription":{ - "type":"structure", - "required":[ - "RoleARN", - "BucketARN", - "BufferingHints", - "CompressionFormat", - "EncryptionConfiguration" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"S3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3BackupDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

The configuration for backup in Amazon S3.

" - }, - "DataFormatConversionConfiguration":{ - "shape":"DataFormatConversionConfiguration", - "documentation":"

The serializer, deserializer, and schema for converting data from the JSON format to the Parquet or ORC format before writing it to Amazon S3.

" - } - }, - "documentation":"

Describes a destination in Amazon S3.

" - }, - "ExtendedS3DestinationUpdate":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"S3BackupMode", - "documentation":"

Enables or disables Amazon S3 backup mode.

" - }, - "S3BackupUpdate":{ - "shape":"S3DestinationUpdate", - "documentation":"

The Amazon S3 destination for backup.

" - }, - "DataFormatConversionConfiguration":{ - "shape":"DataFormatConversionConfiguration", - "documentation":"

The serializer, deserializer, and schema for converting data from the JSON format to the Parquet or ORC format before writing it to Amazon S3.

" - } - }, - "documentation":"

Describes an update for a destination in Amazon S3.

" - }, - "HECAcknowledgmentTimeoutInSeconds":{ - "type":"integer", - "max":600, - "min":180 - }, - "HECEndpoint":{"type":"string"}, - "HECEndpointType":{ - "type":"string", - "enum":[ - "Raw", - "Event" - ] - }, - "HECToken":{"type":"string"}, - "HiveJsonSerDe":{ - "type":"structure", - "members":{ - "TimestampFormats":{ - "shape":"ListOfNonEmptyStrings", - "documentation":"

Indicates how you want Kinesis Data Firehose to parse the date and time stamps that may be present in your input data JSON. To specify these format strings, follow the pattern syntax of JodaTime's DateTimeFormat format strings. For more information, see Class DateTimeFormat. You can also use the special value millis to parse time stamps in epoch milliseconds. If you don't specify a format, Kinesis Data Firehose uses java.sql.Timestamp::valueOf by default.

" - } - }, - "documentation":"

The native Hive / HCatalog JsonSerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for serializing it to the Parquet or ORC format. This is one of two deserializers you can choose, depending on which one offers the functionality you need. The other option is the OpenX SerDe.

" - }, - "InputFormatConfiguration":{ - "type":"structure", - "members":{ - "Deserializer":{ - "shape":"Deserializer", - "documentation":"

Specifies which deserializer to use. You can choose either the Apache Hive JSON SerDe or the OpenX JSON SerDe. If both are non-null, the server rejects the request.

" - } - }, - "documentation":"

Specifies the deserializer you want to use to convert the format of the input data.

" - }, - "IntervalInSeconds":{ - "type":"integer", - "max":900, - "min":60 - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The specified input parameter has a value that is not valid.

", - "exception":true - }, - "KMSEncryptionConfig":{ - "type":"structure", - "required":["AWSKMSKeyARN"], - "members":{ - "AWSKMSKeyARN":{ - "shape":"AWSKMSKeyARN", - "documentation":"

The Amazon Resource Name (ARN) of the encryption key. Must belong to the same AWS Region as the destination Amazon S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - } - }, - "documentation":"

Describes an encryption key for a destination in Amazon S3.

" - }, - "KinesisStreamARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "KinesisStreamSourceConfiguration":{ - "type":"structure", - "required":[ - "KinesisStreamARN", - "RoleARN" - ], - "members":{ - "KinesisStreamARN":{ - "shape":"KinesisStreamARN", - "documentation":"

The ARN of the source Kinesis data stream. For more information, see Amazon Kinesis Data Streams ARN Format.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The ARN of the role that provides access to the source Kinesis data stream. For more information, see AWS Identity and Access Management (IAM) ARN Format.

" - } - }, - "documentation":"

The stream and role Amazon Resource Names (ARNs) for a Kinesis data stream used as the source for a delivery stream.

" - }, - "KinesisStreamSourceDescription":{ - "type":"structure", - "members":{ - "KinesisStreamARN":{ - "shape":"KinesisStreamARN", - "documentation":"

The Amazon Resource Name (ARN) of the source Kinesis data stream. For more information, see Amazon Kinesis Data Streams ARN Format.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The ARN of the role used by the source Kinesis data stream. For more information, see AWS Identity and Access Management (IAM) ARN Format.

" - }, - "DeliveryStartTimestamp":{ - "shape":"DeliveryStartTimestamp", - "documentation":"

Kinesis Data Firehose starts retrieving records from the Kinesis data stream starting with this time stamp.

" - } - }, - "documentation":"

Details about a Kinesis data stream used as the source for a Kinesis Data Firehose delivery stream.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

You have already reached the limit for a requested resource.

", - "exception":true - }, - "ListDeliveryStreamsInput":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"ListDeliveryStreamsInputLimit", - "documentation":"

The maximum number of delivery streams to list. The default value is 10.

" - }, - "DeliveryStreamType":{ - "shape":"DeliveryStreamType", - "documentation":"

The delivery stream type. This can be one of the following values:

  • DirectPut: Provider applications access the delivery stream directly.

  • KinesisStreamAsSource: The delivery stream uses a Kinesis data stream as a source.

This parameter is optional. If this parameter is omitted, delivery streams of all types are returned.

" - }, - "ExclusiveStartDeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream to start the list with.

" - } - } - }, - "ListDeliveryStreamsInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ListDeliveryStreamsOutput":{ - "type":"structure", - "required":[ - "DeliveryStreamNames", - "HasMoreDeliveryStreams" - ], - "members":{ - "DeliveryStreamNames":{ - "shape":"DeliveryStreamNameList", - "documentation":"

The names of the delivery streams.

" - }, - "HasMoreDeliveryStreams":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether there are more delivery streams available to list.

" - } - } - }, - "ListOfNonEmptyStrings":{ - "type":"list", - "member":{"shape":"NonEmptyString"} - }, - "ListOfNonEmptyStringsWithoutWhitespace":{ - "type":"list", - "member":{"shape":"NonEmptyStringWithoutWhitespace"} - }, - "ListTagsForDeliveryStreamInput":{ - "type":"structure", - "required":["DeliveryStreamName"], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream whose tags you want to list.

" - }, - "ExclusiveStartTagKey":{ - "shape":"TagKey", - "documentation":"

The key to use as the starting point for the list of tags. If you set this parameter, ListTagsForDeliveryStream gets all tags that occur after ExclusiveStartTagKey.

" - }, - "Limit":{ - "shape":"ListTagsForDeliveryStreamInputLimit", - "documentation":"

The number of tags to return. If this number is less than the total number of tags associated with the delivery stream, HasMoreTags is set to true in the response. To list additional tags, set ExclusiveStartTagKey to the last key in the response.

" - } - } - }, - "ListTagsForDeliveryStreamInputLimit":{ - "type":"integer", - "max":50, - "min":1 - }, - "ListTagsForDeliveryStreamOutput":{ - "type":"structure", - "required":[ - "Tags", - "HasMoreTags" - ], - "members":{ - "Tags":{ - "shape":"ListTagsForDeliveryStreamOutputTagList", - "documentation":"

A list of tags associated with DeliveryStreamName, starting with the first tag after ExclusiveStartTagKey and up to the specified Limit.

" - }, - "HasMoreTags":{ - "shape":"BooleanObject", - "documentation":"

If this is true in the response, more tags are available. To list the remaining tags, set ExclusiveStartTagKey to the key of the last tag returned and call ListTagsForDeliveryStream again.

" - } - } - }, - "ListTagsForDeliveryStreamOutputTagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":0 - }, - "LogGroupName":{"type":"string"}, - "LogStreamName":{"type":"string"}, - "NoEncryptionConfig":{ - "type":"string", - "enum":["NoEncryption"] - }, - "NonEmptyString":{ - "type":"string", - "pattern":"^(?!\\s*$).+" - }, - "NonEmptyStringWithoutWhitespace":{ - "type":"string", - "pattern":"^\\S+$" - }, - "NonNegativeIntegerObject":{ - "type":"integer", - "min":0 - }, - "OpenXJsonSerDe":{ - "type":"structure", - "members":{ - "ConvertDotsInJsonKeysToUnderscores":{ - "shape":"BooleanObject", - "documentation":"

When set to true, specifies that the names of the keys include dots and that you want Kinesis Data Firehose to replace them with underscores. This is useful because Apache Hive does not allow dots in column names. For example, if the JSON contains a key whose name is \"a.b\", you can define the column name to be \"a_b\" when using this option.

The default is false.

" - }, - "CaseInsensitive":{ - "shape":"BooleanObject", - "documentation":"

When set to true, which is the default, Kinesis Data Firehose converts JSON keys to lowercase before deserializing them.

" - }, - "ColumnToJsonKeyMappings":{ - "shape":"ColumnToJsonKeyMappings", - "documentation":"

Maps column names to JSON keys that aren't identical to the column names. This is useful when the JSON contains keys that are Hive keywords. For example, timestamp is a Hive keyword. If you have a JSON key named timestamp, set this parameter to {\"ts\": \"timestamp\"} to map this key to a column named ts.

" - } - }, - "documentation":"

The OpenX SerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for serializing it to the Parquet or ORC format. This is one of two deserializers you can choose, depending on which one offers the functionality you need. The other option is the native Hive / HCatalog JsonSerDe.

" - }, - "OrcCompression":{ - "type":"string", - "enum":[ - "NONE", - "ZLIB", - "SNAPPY" - ] - }, - "OrcFormatVersion":{ - "type":"string", - "enum":[ - "V0_11", - "V0_12" - ] - }, - "OrcRowIndexStride":{ - "type":"integer", - "min":1000 - }, - "OrcSerDe":{ - "type":"structure", - "members":{ - "StripeSizeBytes":{ - "shape":"OrcStripeSizeBytes", - "documentation":"

The number of bytes in each stripe. The default is 64 MiB and the minimum is 8 MiB.

" - }, - "BlockSizeBytes":{ - "shape":"BlockSizeBytes", - "documentation":"

The Hadoop Distributed File System (HDFS) block size. This is useful if you intend to copy the data from Amazon S3 to HDFS before querying. The default is 256 MiB and the minimum is 64 MiB. Kinesis Data Firehose uses this value for padding calculations.

" - }, - "RowIndexStride":{ - "shape":"OrcRowIndexStride", - "documentation":"

The number of rows between index entries. The default is 10,000 and the minimum is 1,000.

" - }, - "EnablePadding":{ - "shape":"BooleanObject", - "documentation":"

Set this to true to indicate that you want stripes to be padded to the HDFS block boundaries. This is useful if you intend to copy the data from Amazon S3 to HDFS before querying. The default is false.

" - }, - "PaddingTolerance":{ - "shape":"Proportion", - "documentation":"

A number between 0 and 1 that defines the tolerance for block padding as a decimal fraction of stripe size. The default value is 0.05, which means 5 percent of stripe size.

For the default values of 64 MiB ORC stripes and 256 MiB HDFS blocks, the default block padding tolerance of 5 percent reserves a maximum of 3.2 MiB for padding within the 256 MiB block. In such a case, if the available size within the block is more than 3.2 MiB, a new, smaller stripe is inserted to fit within that space. This ensures that no stripe crosses block boundaries and causes remote reads within a node-local task.

Kinesis Data Firehose ignores this parameter when OrcSerDe$EnablePadding is false.

" - }, - "Compression":{ - "shape":"OrcCompression", - "documentation":"

The compression code to use over data blocks. The default is SNAPPY.

" - }, - "BloomFilterColumns":{ - "shape":"ListOfNonEmptyStringsWithoutWhitespace", - "documentation":"

The column names for which you want Kinesis Data Firehose to create bloom filters. The default is null.

" - }, - "BloomFilterFalsePositiveProbability":{ - "shape":"Proportion", - "documentation":"

The Bloom filter false positive probability (FPP). The lower the FPP, the bigger the Bloom filter. The default value is 0.05, the minimum is 0, and the maximum is 1.

" - }, - "DictionaryKeyThreshold":{ - "shape":"Proportion", - "documentation":"

Represents the fraction of the total number of non-null rows. To turn off dictionary encoding, set this fraction to a number that is less than the number of distinct keys in a dictionary. To always use dictionary encoding, set this threshold to 1.

" - }, - "FormatVersion":{ - "shape":"OrcFormatVersion", - "documentation":"

The version of the file to write. The possible values are V0_11 and V0_12. The default is V0_12.

" - } - }, - "documentation":"

A serializer to use for converting data to the ORC format before storing it in Amazon S3. For more information, see Apache ORC.

" - }, - "OrcStripeSizeBytes":{ - "type":"integer", - "min":8388608 - }, - "OutputFormatConfiguration":{ - "type":"structure", - "members":{ - "Serializer":{ - "shape":"Serializer", - "documentation":"

Specifies which serializer to use. You can choose either the ORC SerDe or the Parquet SerDe. If both are non-null, the server rejects the request.

" - } - }, - "documentation":"

Specifies the serializer that you want Kinesis Data Firehose to use to convert the format of your data before it writes it to Amazon S3.

" - }, - "ParquetCompression":{ - "type":"string", - "enum":[ - "UNCOMPRESSED", - "GZIP", - "SNAPPY" - ] - }, - "ParquetPageSizeBytes":{ - "type":"integer", - "min":65536 - }, - "ParquetSerDe":{ - "type":"structure", - "members":{ - "BlockSizeBytes":{ - "shape":"BlockSizeBytes", - "documentation":"

The Hadoop Distributed File System (HDFS) block size. This is useful if you intend to copy the data from Amazon S3 to HDFS before querying. The default is 256 MiB and the minimum is 64 MiB. Kinesis Data Firehose uses this value for padding calculations.

" - }, - "PageSizeBytes":{ - "shape":"ParquetPageSizeBytes", - "documentation":"

The Parquet page size. Column chunks are divided into pages. A page is conceptually an indivisible unit (in terms of compression and encoding). The minimum value is 64 KiB and the default is 1 MiB.

" - }, - "Compression":{ - "shape":"ParquetCompression", - "documentation":"

The compression code to use over data blocks. The possible values are UNCOMPRESSED, SNAPPY, and GZIP, with the default being SNAPPY. Use SNAPPY for higher decompression speed. Use GZIP if the compression ration is more important than speed.

" - }, - "EnableDictionaryCompression":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether to enable dictionary compression.

" - }, - "MaxPaddingBytes":{ - "shape":"NonNegativeIntegerObject", - "documentation":"

The maximum amount of padding to apply. This is useful if you intend to copy the data from Amazon S3 to HDFS before querying. The default is 0.

" - }, - "WriterVersion":{ - "shape":"ParquetWriterVersion", - "documentation":"

Indicates the version of row format to output. The possible values are V1 and V2. The default is V1.

" - } - }, - "documentation":"

A serializer to use for converting data to the Parquet format before storing it in Amazon S3. For more information, see Apache Parquet.

" - }, - "ParquetWriterVersion":{ - "type":"string", - "enum":[ - "V1", - "V2" - ] - }, - "Password":{ - "type":"string", - "min":6, - "sensitive":true - }, - "Prefix":{"type":"string"}, - "ProcessingConfiguration":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"BooleanObject", - "documentation":"

Enables or disables data processing.

" - }, - "Processors":{ - "shape":"ProcessorList", - "documentation":"

The data processors.

" - } - }, - "documentation":"

Describes a data processing configuration.

" - }, - "Processor":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"ProcessorType", - "documentation":"

The type of processor.

" - }, - "Parameters":{ - "shape":"ProcessorParameterList", - "documentation":"

The processor parameters.

" - } - }, - "documentation":"

Describes a data processor.

" - }, - "ProcessorList":{ - "type":"list", - "member":{"shape":"Processor"} - }, - "ProcessorParameter":{ - "type":"structure", - "required":[ - "ParameterName", - "ParameterValue" - ], - "members":{ - "ParameterName":{ - "shape":"ProcessorParameterName", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"ProcessorParameterValue", - "documentation":"

The parameter value.

" - } - }, - "documentation":"

Describes the processor parameter.

" - }, - "ProcessorParameterList":{ - "type":"list", - "member":{"shape":"ProcessorParameter"} - }, - "ProcessorParameterName":{ - "type":"string", - "enum":[ - "LambdaArn", - "NumberOfRetries", - "RoleArn", - "BufferSizeInMBs", - "BufferIntervalInSeconds" - ] - }, - "ProcessorParameterValue":{ - "type":"string", - "max":512, - "min":1 - }, - "ProcessorType":{ - "type":"string", - "enum":["Lambda"] - }, - "Proportion":{ - "type":"double", - "max":1, - "min":0 - }, - "PutRecordBatchInput":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "Records" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "Records":{ - "shape":"PutRecordBatchRequestEntryList", - "documentation":"

One or more records.

" - } - } - }, - "PutRecordBatchOutput":{ - "type":"structure", - "required":[ - "FailedPutCount", - "RequestResponses" - ], - "members":{ - "FailedPutCount":{ - "shape":"NonNegativeIntegerObject", - "documentation":"

The number of records that might have failed processing.

" - }, - "RequestResponses":{ - "shape":"PutRecordBatchResponseEntryList", - "documentation":"

The results array. For each record, the index of the response element is the same as the index used in the request array.

" - } - } - }, - "PutRecordBatchRequestEntryList":{ - "type":"list", - "member":{"shape":"Record"}, - "max":500, - "min":1 - }, - "PutRecordBatchResponseEntry":{ - "type":"structure", - "members":{ - "RecordId":{ - "shape":"PutResponseRecordId", - "documentation":"

The ID of the record.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code for an individual record result.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message for an individual record result.

" - } - }, - "documentation":"

Contains the result for an individual record from a PutRecordBatch request. If the record is successfully added to your delivery stream, it receives a record ID. If the record fails to be added to your delivery stream, the result includes an error code and an error message.

" - }, - "PutRecordBatchResponseEntryList":{ - "type":"list", - "member":{"shape":"PutRecordBatchResponseEntry"}, - "max":500, - "min":1 - }, - "PutRecordInput":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "Record" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "Record":{ - "shape":"Record", - "documentation":"

The record.

" - } - } - }, - "PutRecordOutput":{ - "type":"structure", - "required":["RecordId"], - "members":{ - "RecordId":{ - "shape":"PutResponseRecordId", - "documentation":"

The ID of the record.

" - } - } - }, - "PutResponseRecordId":{ - "type":"string", - "min":1 - }, - "Record":{ - "type":"structure", - "required":["Data"], - "members":{ - "Data":{ - "shape":"Data", - "documentation":"

The data blob, which is base64-encoded when the blob is serialized. The maximum size of the data blob, before base64-encoding, is 1,000 KB.

" - } - }, - "documentation":"

The unit of data in a delivery stream.

" - }, - "RedshiftDestinationConfiguration":{ - "type":"structure", - "required":[ - "RoleARN", - "ClusterJDBCURL", - "CopyCommand", - "Username", - "Password", - "S3Configuration" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ClusterJDBCURL":{ - "shape":"ClusterJDBCURL", - "documentation":"

The database connection string.

" - }, - "CopyCommand":{ - "shape":"CopyCommand", - "documentation":"

The COPY command.

" - }, - "Username":{ - "shape":"Username", - "documentation":"

The name of the user.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The user password.

" - }, - "RetryOptions":{ - "shape":"RedshiftRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon Redshift. Default value is 3600 (60 minutes).

" - }, - "S3Configuration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

The configuration for the intermediate Amazon S3 location from which Amazon Redshift obtains data. Restrictions are described in the topic for CreateDeliveryStream.

The compression formats SNAPPY or ZIP cannot be specified in RedshiftDestinationConfiguration.S3Configuration because the Amazon Redshift COPY operation that reads from the S3 bucket doesn't support these compression formats.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"RedshiftS3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3BackupConfiguration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

The configuration for backup in Amazon S3.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes the configuration of a destination in Amazon Redshift.

" - }, - "RedshiftDestinationDescription":{ - "type":"structure", - "required":[ - "RoleARN", - "ClusterJDBCURL", - "CopyCommand", - "Username", - "S3DestinationDescription" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ClusterJDBCURL":{ - "shape":"ClusterJDBCURL", - "documentation":"

The database connection string.

" - }, - "CopyCommand":{ - "shape":"CopyCommand", - "documentation":"

The COPY command.

" - }, - "Username":{ - "shape":"Username", - "documentation":"

The name of the user.

" - }, - "RetryOptions":{ - "shape":"RedshiftRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon Redshift. Default value is 3600 (60 minutes).

" - }, - "S3DestinationDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

The Amazon S3 destination.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"RedshiftS3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3BackupDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

The configuration for backup in Amazon S3.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes a destination in Amazon Redshift.

" - }, - "RedshiftDestinationUpdate":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ClusterJDBCURL":{ - "shape":"ClusterJDBCURL", - "documentation":"

The database connection string.

" - }, - "CopyCommand":{ - "shape":"CopyCommand", - "documentation":"

The COPY command.

" - }, - "Username":{ - "shape":"Username", - "documentation":"

The name of the user.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The user password.

" - }, - "RetryOptions":{ - "shape":"RedshiftRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon Redshift. Default value is 3600 (60 minutes).

" - }, - "S3Update":{ - "shape":"S3DestinationUpdate", - "documentation":"

The Amazon S3 destination.

The compression formats SNAPPY or ZIP cannot be specified in RedshiftDestinationUpdate.S3Update because the Amazon Redshift COPY operation that reads from the S3 bucket doesn't support these compression formats.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "S3BackupMode":{ - "shape":"RedshiftS3BackupMode", - "documentation":"

The Amazon S3 backup mode.

" - }, - "S3BackupUpdate":{ - "shape":"S3DestinationUpdate", - "documentation":"

The Amazon S3 destination for backup.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes an update for a destination in Amazon Redshift.

" - }, - "RedshiftRetryDurationInSeconds":{ - "type":"integer", - "max":7200, - "min":0 - }, - "RedshiftRetryOptions":{ - "type":"structure", - "members":{ - "DurationInSeconds":{ - "shape":"RedshiftRetryDurationInSeconds", - "documentation":"

The length of time during which Kinesis Data Firehose retries delivery after a failure, starting from the initial request and including the first attempt. The default value is 3600 seconds (60 minutes). Kinesis Data Firehose does not retry if the value of DurationInSeconds is 0 (zero) or if the first delivery attempt takes longer than the current value.

" - } - }, - "documentation":"

Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon Redshift.

" - }, - "RedshiftS3BackupMode":{ - "type":"string", - "enum":[ - "Disabled", - "Enabled" - ] - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The resource is already in use and not available for this operation.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The specified resource could not be found.

", - "exception":true - }, - "RoleARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "S3BackupMode":{ - "type":"string", - "enum":[ - "Disabled", - "Enabled" - ] - }, - "S3DestinationConfiguration":{ - "type":"structure", - "required":[ - "RoleARN", - "BucketARN" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option. If no value is specified, BufferingHints object default values are used.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes the configuration of a destination in Amazon S3.

" - }, - "S3DestinationDescription":{ - "type":"structure", - "required":[ - "RoleARN", - "BucketARN", - "BufferingHints", - "CompressionFormat", - "EncryptionConfiguration" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option. If no value is specified, BufferingHints object default values are used.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes a destination in Amazon S3.

" - }, - "S3DestinationUpdate":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The Amazon Resource Name (ARN) of the AWS credentials. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

The ARN of the S3 bucket. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The \"YYYY/MM/DD/HH\" time format prefix is automatically used for delivered Amazon S3 files. You can specify an extra prefix to be added in front of the time format prefix. If the prefix ends with a slash, it appears as a folder in the S3 bucket. For more information, see Amazon S3 Object Name Format in the Amazon Kinesis Data Firehose Developer Guide.

" - }, - "BufferingHints":{ - "shape":"BufferingHints", - "documentation":"

The buffering option. If no value is specified, BufferingHints object default values are used.

" - }, - "CompressionFormat":{ - "shape":"CompressionFormat", - "documentation":"

The compression format. If no value is specified, the default is UNCOMPRESSED.

The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

The encryption configuration. If no value is specified, the default is no encryption.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes an update for a destination in Amazon S3.

" - }, - "SchemaConfiguration":{ - "type":"structure", - "members":{ - "RoleARN":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

The role that Kinesis Data Firehose can use to access AWS Glue. This role must be in the same account you use for Kinesis Data Firehose. Cross-account roles aren't allowed.

" - }, - "CatalogId":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

The ID of the AWS Glue Data Catalog. If you don't supply this, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

Specifies the name of the AWS Glue database that contains the schema for the output data.

" - }, - "TableName":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

Specifies the AWS Glue table that contains the column information that constitutes your data schema.

" - }, - "Region":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

If you don't specify an AWS Region, the default is the current Region.

" - }, - "VersionId":{ - "shape":"NonEmptyStringWithoutWhitespace", - "documentation":"

Specifies the table version for the output data schema. If you don't specify this version ID, or if you set it to LATEST, Kinesis Data Firehose uses the most recent version. This means that any updates to the table are automatically picked up.

" - } - }, - "documentation":"

Specifies the schema to which you want Kinesis Data Firehose to configure your data before it writes it to Amazon S3.

" - }, - "Serializer":{ - "type":"structure", - "members":{ - "ParquetSerDe":{ - "shape":"ParquetSerDe", - "documentation":"

A serializer to use for converting data to the Parquet format before storing it in Amazon S3. For more information, see Apache Parquet.

" - }, - "OrcSerDe":{ - "shape":"OrcSerDe", - "documentation":"

A serializer to use for converting data to the ORC format before storing it in Amazon S3. For more information, see Apache ORC.

" - } - }, - "documentation":"

The serializer that you want Kinesis Data Firehose to use to convert data to the target format before writing it to Amazon S3. Kinesis Data Firehose supports two types of serializers: the ORC SerDe and the Parquet SerDe.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The service is unavailable. Back off and retry the operation. If you continue to see the exception, throughput limits for the delivery stream may have been exceeded. For more information about limits and how to request an increase, see Amazon Kinesis Data Firehose Limits.

", - "exception":true, - "fault":true - }, - "SizeInMBs":{ - "type":"integer", - "max":128, - "min":1 - }, - "SourceDescription":{ - "type":"structure", - "members":{ - "KinesisStreamSourceDescription":{ - "shape":"KinesisStreamSourceDescription", - "documentation":"

The KinesisStreamSourceDescription value for the source Kinesis data stream.

" - } - }, - "documentation":"

Details about a Kinesis data stream used as the source for a Kinesis Data Firehose delivery stream.

" - }, - "SplunkDestinationConfiguration":{ - "type":"structure", - "required":[ - "HECEndpoint", - "HECEndpointType", - "HECToken", - "S3Configuration" - ], - "members":{ - "HECEndpoint":{ - "shape":"HECEndpoint", - "documentation":"

The HTTP Event Collector (HEC) endpoint to which Kinesis Data Firehose sends your data.

" - }, - "HECEndpointType":{ - "shape":"HECEndpointType", - "documentation":"

This type can be either \"Raw\" or \"Event.\"

" - }, - "HECToken":{ - "shape":"HECToken", - "documentation":"

This is a GUID that you obtain from your Splunk cluster when you create a new HEC endpoint.

" - }, - "HECAcknowledgmentTimeoutInSeconds":{ - "shape":"HECAcknowledgmentTimeoutInSeconds", - "documentation":"

The amount of time that Kinesis Data Firehose waits to receive an acknowledgment from Splunk after it sends it data. At the end of the timeout period, Kinesis Data Firehose either tries to send the data again or considers it an error, based on your retry settings.

" - }, - "RetryOptions":{ - "shape":"SplunkRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver data to Splunk, or if it doesn't receive an acknowledgment of receipt from Splunk.

" - }, - "S3BackupMode":{ - "shape":"SplunkS3BackupMode", - "documentation":"

Defines how documents should be delivered to Amazon S3. When set to FailedDocumentsOnly, Kinesis Data Firehose writes any data that could not be indexed to the configured Amazon S3 destination. When set to AllDocuments, Kinesis Data Firehose delivers all incoming records to Amazon S3, and also writes failed documents to Amazon S3. Default value is FailedDocumentsOnly.

" - }, - "S3Configuration":{ - "shape":"S3DestinationConfiguration", - "documentation":"

The configuration for the backup Amazon S3 location.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes the configuration of a destination in Splunk.

" - }, - "SplunkDestinationDescription":{ - "type":"structure", - "members":{ - "HECEndpoint":{ - "shape":"HECEndpoint", - "documentation":"

The HTTP Event Collector (HEC) endpoint to which Kinesis Data Firehose sends your data.

" - }, - "HECEndpointType":{ - "shape":"HECEndpointType", - "documentation":"

This type can be either \"Raw\" or \"Event.\"

" - }, - "HECToken":{ - "shape":"HECToken", - "documentation":"

A GUID you obtain from your Splunk cluster when you create a new HEC endpoint.

" - }, - "HECAcknowledgmentTimeoutInSeconds":{ - "shape":"HECAcknowledgmentTimeoutInSeconds", - "documentation":"

The amount of time that Kinesis Data Firehose waits to receive an acknowledgment from Splunk after it sends it data. At the end of the timeout period, Kinesis Data Firehose either tries to send the data again or considers it an error, based on your retry settings.

" - }, - "RetryOptions":{ - "shape":"SplunkRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver data to Splunk or if it doesn't receive an acknowledgment of receipt from Splunk.

" - }, - "S3BackupMode":{ - "shape":"SplunkS3BackupMode", - "documentation":"

Defines how documents should be delivered to Amazon S3. When set to FailedDocumentsOnly, Kinesis Data Firehose writes any data that could not be indexed to the configured Amazon S3 destination. When set to AllDocuments, Kinesis Data Firehose delivers all incoming records to Amazon S3, and also writes failed documents to Amazon S3. Default value is FailedDocumentsOnly.

" - }, - "S3DestinationDescription":{ - "shape":"S3DestinationDescription", - "documentation":"

The Amazon S3 destination.>

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes a destination in Splunk.

" - }, - "SplunkDestinationUpdate":{ - "type":"structure", - "members":{ - "HECEndpoint":{ - "shape":"HECEndpoint", - "documentation":"

The HTTP Event Collector (HEC) endpoint to which Kinesis Data Firehose sends your data.

" - }, - "HECEndpointType":{ - "shape":"HECEndpointType", - "documentation":"

This type can be either \"Raw\" or \"Event.\"

" - }, - "HECToken":{ - "shape":"HECToken", - "documentation":"

A GUID that you obtain from your Splunk cluster when you create a new HEC endpoint.

" - }, - "HECAcknowledgmentTimeoutInSeconds":{ - "shape":"HECAcknowledgmentTimeoutInSeconds", - "documentation":"

The amount of time that Kinesis Data Firehose waits to receive an acknowledgment from Splunk after it sends data. At the end of the timeout period, Kinesis Data Firehose either tries to send the data again or considers it an error, based on your retry settings.

" - }, - "RetryOptions":{ - "shape":"SplunkRetryOptions", - "documentation":"

The retry behavior in case Kinesis Data Firehose is unable to deliver data to Splunk or if it doesn't receive an acknowledgment of receipt from Splunk.

" - }, - "S3BackupMode":{ - "shape":"SplunkS3BackupMode", - "documentation":"

Defines how documents should be delivered to Amazon S3. When set to FailedDocumentsOnly, Kinesis Data Firehose writes any data that could not be indexed to the configured Amazon S3 destination. When set to AllDocuments, Kinesis Data Firehose delivers all incoming records to Amazon S3, and also writes failed documents to Amazon S3. Default value is FailedDocumentsOnly.

" - }, - "S3Update":{ - "shape":"S3DestinationUpdate", - "documentation":"

Your update to the configuration of the backup Amazon S3 location.

" - }, - "ProcessingConfiguration":{ - "shape":"ProcessingConfiguration", - "documentation":"

The data processing configuration.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

The Amazon CloudWatch logging options for your delivery stream.

" - } - }, - "documentation":"

Describes an update for a destination in Splunk.

" - }, - "SplunkRetryDurationInSeconds":{ - "type":"integer", - "max":7200, - "min":0 - }, - "SplunkRetryOptions":{ - "type":"structure", - "members":{ - "DurationInSeconds":{ - "shape":"SplunkRetryDurationInSeconds", - "documentation":"

The total amount of time that Kinesis Data Firehose spends on retries. This duration starts after the initial attempt to send data to Splunk fails. It doesn't include the periods during which Kinesis Data Firehose waits for acknowledgment from Splunk after each attempt.

" - } - }, - "documentation":"

Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Splunk, or if it doesn't receive an acknowledgment from Splunk.

" - }, - "SplunkS3BackupMode":{ - "type":"string", - "enum":[ - "FailedEventsOnly", - "AllEvents" - ] - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A unique identifier for the tag. Maximum length: 128 characters. Valid characters: Unicode letters, digits, white space, _ . / = + - % @

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

An optional string, which you can use to describe or define the tag. Maximum length: 256 characters. Valid characters: Unicode letters, digits, white space, _ . / = + - % @

" - } - }, - "documentation":"

Metadata that you can assign to a delivery stream, consisting of a key-value pair.

" - }, - "TagDeliveryStreamInput":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "Tags" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream to which you want to add the tags.

" - }, - "Tags":{ - "shape":"TagDeliveryStreamInputTagList", - "documentation":"

A set of key-value pairs to use to create the tags.

" - } - } - }, - "TagDeliveryStreamInputTagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TagDeliveryStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0 - }, - "Timestamp":{"type":"timestamp"}, - "UntagDeliveryStreamInput":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "TagKeys" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys. Each corresponding tag is removed from the delivery stream.

" - } - } - }, - "UntagDeliveryStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "UpdateDestinationInput":{ - "type":"structure", - "required":[ - "DeliveryStreamName", - "CurrentDeliveryStreamVersionId", - "DestinationId" - ], - "members":{ - "DeliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The name of the delivery stream.

" - }, - "CurrentDeliveryStreamVersionId":{ - "shape":"DeliveryStreamVersionId", - "documentation":"

Obtain this value from the VersionId result of DeliveryStreamDescription. This value is required, and helps the service perform conditional operations. For example, if there is an interleaving update and this value is null, then the update destination fails. After the update is successful, the VersionId value is updated. The service then performs a merge of the old configuration with the new configuration.

" - }, - "DestinationId":{ - "shape":"DestinationId", - "documentation":"

The ID of the destination.

" - }, - "S3DestinationUpdate":{ - "shape":"S3DestinationUpdate", - "documentation":"

[Deprecated] Describes an update for a destination in Amazon S3.

", - "deprecated":true - }, - "ExtendedS3DestinationUpdate":{ - "shape":"ExtendedS3DestinationUpdate", - "documentation":"

Describes an update for a destination in Amazon S3.

" - }, - "RedshiftDestinationUpdate":{ - "shape":"RedshiftDestinationUpdate", - "documentation":"

Describes an update for a destination in Amazon Redshift.

" - }, - "ElasticsearchDestinationUpdate":{ - "shape":"ElasticsearchDestinationUpdate", - "documentation":"

Describes an update for a destination in Amazon ES.

" - }, - "SplunkDestinationUpdate":{ - "shape":"SplunkDestinationUpdate", - "documentation":"

Describes an update for a destination in Splunk.

" - } - } - }, - "UpdateDestinationOutput":{ - "type":"structure", - "members":{ - } - }, - "Username":{ - "type":"string", - "min":1, - "sensitive":true - } - }, - "documentation":"Amazon Kinesis Data Firehose API Reference

Amazon Kinesis Data Firehose is a fully managed service that delivers real-time streaming data to destinations such as Amazon Simple Storage Service (Amazon S3), Amazon Elasticsearch Service (Amazon ES), Amazon Redshift, and Splunk.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/service-2.json deleted file mode 100644 index dc3df2d5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/fms/2018-01-01/service-2.json +++ /dev/null @@ -1,753 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2018-01-01", - "endpointPrefix":"fms", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"FMS", - "serviceFullName":"Firewall Management Service", - "serviceId":"FMS", - "signatureVersion":"v4", - "targetPrefix":"AWSFMS_20180101", - "uid":"fms-2018-01-01" - }, - "operations":{ - "AssociateAdminAccount":{ - "name":"AssociateAdminAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateAdminAccountRequest"}, - "errors":[ - {"shape":"InvalidOperationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Sets the AWS Firewall Manager administrator account. AWS Firewall Manager must be associated with a master account in AWS Organizations or associated with a member account that has the appropriate permissions. If the account ID that you submit is not an AWS Organizations master account, AWS Firewall Manager will set the appropriate permissions for the given member account.

The account that you associate with AWS Firewall Manager is called the AWS Firewall manager administrator account.

" - }, - "DeleteNotificationChannel":{ - "name":"DeleteNotificationChannel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNotificationChannelRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Deletes an AWS Firewall Manager association with the IAM role and the Amazon Simple Notification Service (SNS) topic that is used to record AWS Firewall Manager SNS logs.

" - }, - "DeletePolicy":{ - "name":"DeletePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePolicyRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Permanently deletes an AWS Firewall Manager policy.

" - }, - "DisassociateAdminAccount":{ - "name":"DisassociateAdminAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateAdminAccountRequest"}, - "errors":[ - {"shape":"InvalidOperationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Disassociates the account that has been set as the AWS Firewall Manager administrator account. You will need to submit an AssociateAdminAccount request to set a new account as the AWS Firewall administrator.

" - }, - "GetAdminAccount":{ - "name":"GetAdminAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAdminAccountRequest"}, - "output":{"shape":"GetAdminAccountResponse"}, - "errors":[ - {"shape":"InvalidOperationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns the AWS Organizations master account that is associated with AWS Firewall Manager as the AWS Firewall Manager administrator.

" - }, - "GetComplianceDetail":{ - "name":"GetComplianceDetail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetComplianceDetailRequest"}, - "output":{"shape":"GetComplianceDetailResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns detailed compliance information about the specified member account. Details include resources that are in and out of compliance with the specified policy. Resources are considered non-compliant if the specified policy has not been applied to them.

" - }, - "GetNotificationChannel":{ - "name":"GetNotificationChannel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetNotificationChannelRequest"}, - "output":{"shape":"GetNotificationChannelResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns information about the Amazon Simple Notification Service (SNS) topic that is used to record AWS Firewall Manager SNS logs.

" - }, - "GetPolicy":{ - "name":"GetPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPolicyRequest"}, - "output":{"shape":"GetPolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns information about the specified AWS Firewall Manager policy.

" - }, - "ListComplianceStatus":{ - "name":"ListComplianceStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListComplianceStatusRequest"}, - "output":{"shape":"ListComplianceStatusResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns an array of PolicyComplianceStatus objects in the response. Use PolicyComplianceStatus to get a summary of which member accounts are protected by the specified policy.

" - }, - "ListPolicies":{ - "name":"ListPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPoliciesRequest"}, - "output":{"shape":"ListPoliciesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns an array of PolicySummary objects in the response.

" - }, - "PutNotificationChannel":{ - "name":"PutNotificationChannel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutNotificationChannelRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Designates the IAM role and Amazon Simple Notification Service (SNS) topic that AWS Firewall Manager uses to record SNS logs.

" - }, - "PutPolicy":{ - "name":"PutPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutPolicyRequest"}, - "output":{"shape":"PutPolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalErrorException"} - ], - "documentation":"

Creates an AWS Firewall Manager policy.

" - } - }, - "shapes":{ - "AWSAccountId":{ - "type":"string", - "max":1024, - "min":1 - }, - "AssociateAdminAccountRequest":{ - "type":"structure", - "required":["AdminAccount"], - "members":{ - "AdminAccount":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account ID to associate with AWS Firewall Manager as the AWS Firewall Manager administrator account. This can be an AWS Organizations master account or a member account. For more information about AWS Organizations and master accounts, see Managing the AWS Accounts in Your Organization.

" - } - } - }, - "Boolean":{"type":"boolean"}, - "ComplianceViolator":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource ID.

" - }, - "ViolationReason":{ - "shape":"ViolationReason", - "documentation":"

The reason that the resource is not protected by the policy.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type. This is in the format shown in AWS Resource Types Reference. Valid values are AWS::ElasticLoadBalancingV2::LoadBalancer or AWS::CloudFront::Distribution.

" - } - }, - "documentation":"

Details of the resource that is not protected by the policy.

" - }, - "ComplianceViolators":{ - "type":"list", - "member":{"shape":"ComplianceViolator"} - }, - "DeleteNotificationChannelRequest":{ - "type":"structure", - "members":{ - } - }, - "DeletePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the policy that you want to delete. PolicyId is returned by PutPolicy and by ListPolicies.

" - } - } - }, - "DisassociateAdminAccountRequest":{ - "type":"structure", - "members":{ - } - }, - "ErrorMessage":{"type":"string"}, - "EvaluationResult":{ - "type":"structure", - "members":{ - "ComplianceStatus":{ - "shape":"PolicyComplianceStatusType", - "documentation":"

Describes an AWS account's compliance with the AWS Firewall Manager policy.

" - }, - "ViolatorCount":{ - "shape":"ResourceCount", - "documentation":"

Number of resources that are non-compliant with the specified policy. A resource is considered non-compliant if it is not associated with the specified policy.

" - }, - "EvaluationLimitExceeded":{ - "shape":"Boolean", - "documentation":"

Indicates that over 100 resources are non-compliant with the AWS Firewall Manager policy.

" - } - }, - "documentation":"

Describes the compliance status for the account. An account is considered non-compliant if it includes resources that are not protected by the specified policy.

" - }, - "EvaluationResults":{ - "type":"list", - "member":{"shape":"EvaluationResult"} - }, - "GetAdminAccountRequest":{ - "type":"structure", - "members":{ - } - }, - "GetAdminAccountResponse":{ - "type":"structure", - "members":{ - "AdminAccount":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account that is set as the AWS Firewall Manager administrator.

" - } - } - }, - "GetComplianceDetailRequest":{ - "type":"structure", - "required":[ - "PolicyId", - "MemberAccount" - ], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the policy that you want to get the details for. PolicyId is returned by PutPolicy and by ListPolicies.

" - }, - "MemberAccount":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account that owns the resources that you want to get the details for.

" - } - } - }, - "GetComplianceDetailResponse":{ - "type":"structure", - "members":{ - "PolicyComplianceDetail":{ - "shape":"PolicyComplianceDetail", - "documentation":"

Information about the resources and the policy that you specified in the GetComplianceDetail request.

" - } - } - }, - "GetNotificationChannelRequest":{ - "type":"structure", - "members":{ - } - }, - "GetNotificationChannelResponse":{ - "type":"structure", - "members":{ - "SnsTopicArn":{ - "shape":"ResourceArn", - "documentation":"

The SNS topic that records AWS Firewall Manager activity.

" - }, - "SnsRoleName":{ - "shape":"ResourceArn", - "documentation":"

The IAM role that is used by AWS Firewall Manager to record activity to SNS.

" - } - } - }, - "GetPolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the AWS Firewall Manager policy that you want the details for.

" - } - } - }, - "GetPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

Information about the specified AWS Firewall Manager policy.

" - }, - "PolicyArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the specified policy.

" - } - } - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The operation failed because of a system problem, even though the request was valid. Retry your request.

", - "exception":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The parameters of the request were invalid.

", - "exception":true - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The operation failed because there was nothing to do. For example, you might have submitted an AssociateAdminAccount request, but the account ID that you submitted was already set as the AWS Firewall Manager administrator.

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The operation exceeds a resource limit, for example, the maximum number of policy objects that you can create for an AWS account. For more information, see Firewall Manager Limits in the AWS WAF Developer Guide.

", - "exception":true - }, - "ListComplianceStatusRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the AWS Firewall Manager policy that you want the details for.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If you specify a value for MaxResults and you have more PolicyComplianceStatus objects than the number that you specify for MaxResults, AWS Firewall Manager returns a NextToken value in the response that allows you to list another group of PolicyComplianceStatus objects. For the second and subsequent ListComplianceStatus requests, specify the value of NextToken from the previous response to get information about another batch of PolicyComplianceStatus objects.

" - }, - "MaxResults":{ - "shape":"PaginationMaxResults", - "documentation":"

Specifies the number of PolicyComplianceStatus objects that you want AWS Firewall Manager to return for this request. If you have more PolicyComplianceStatus objects than the number that you specify for MaxResults, the response includes a NextToken value that you can use to get another batch of PolicyComplianceStatus objects.

" - } - } - }, - "ListComplianceStatusResponse":{ - "type":"structure", - "members":{ - "PolicyComplianceStatusList":{ - "shape":"PolicyComplianceStatusList", - "documentation":"

An array of PolicyComplianceStatus objects.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If you have more PolicyComplianceStatus objects than the number that you specified for MaxResults in the request, the response includes a NextToken value. To list more PolicyComplianceStatus objects, submit another ListComplianceStatus request, and specify the NextToken value from the response in the NextToken value in the next request.

" - } - } - }, - "ListPoliciesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If you specify a value for MaxResults and you have more PolicySummary objects than the number that you specify for MaxResults, AWS Firewall Manager returns a NextToken value in the response that allows you to list another group of PolicySummary objects. For the second and subsequent ListPolicies requests, specify the value of NextToken from the previous response to get information about another batch of PolicySummary objects.

" - }, - "MaxResults":{ - "shape":"PaginationMaxResults", - "documentation":"

Specifies the number of PolicySummary objects that you want AWS Firewall Manager to return for this request. If you have more PolicySummary objects than the number that you specify for MaxResults, the response includes a NextToken value that you can use to get another batch of PolicySummary objects.

" - } - } - }, - "ListPoliciesResponse":{ - "type":"structure", - "members":{ - "PolicyList":{ - "shape":"PolicySummaryList", - "documentation":"

An array of PolicySummary objects.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If you have more PolicySummary objects than the number that you specified for MaxResults in the request, the response includes a NextToken value. To list more PolicySummary objects, submit another ListPolicies request, and specify the NextToken value from the response in the NextToken value in the next request.

" - } - } - }, - "ManagedServiceData":{ - "type":"string", - "max":1024, - "min":1 - }, - "PaginationMaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "PaginationToken":{ - "type":"string", - "min":1 - }, - "Policy":{ - "type":"structure", - "required":[ - "PolicyName", - "SecurityServicePolicyData", - "ResourceType", - "ExcludeResourceTags", - "RemediationEnabled" - ], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the AWS Firewall Manager policy.

" - }, - "PolicyName":{ - "shape":"ResourceName", - "documentation":"

The friendly name of the AWS Firewall Manager policy.

" - }, - "PolicyUpdateToken":{ - "shape":"PolicyUpdateToken", - "documentation":"

A unique identifier for each update to the policy. When issuing a PutPolicy request, the PolicyUpdateToken in the request must match the PolicyUpdateToken of the current policy version. To get the PolicyUpdateToken of the current policy version, use a GetPolicy request.

" - }, - "SecurityServicePolicyData":{ - "shape":"SecurityServicePolicyData", - "documentation":"

Details about the security service that is being used to protect the resources.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to protect with the policy, either an Application Load Balancer or a CloudFront distribution. This is in the format shown in AWS Resource Types Reference. Valid values are AWS::ElasticLoadBalancingV2::LoadBalancer or AWS::CloudFront::Distribution.

" - }, - "ResourceTags":{ - "shape":"ResourceTags", - "documentation":"

An array of ResourceTag objects.

" - }, - "ExcludeResourceTags":{ - "shape":"Boolean", - "documentation":"

If set to True, resources with the tags that are specified in the ResourceTag array are not protected by the policy. If set to False, and the ResourceTag array is not null, only resources with the specified tags are associated with the policy.

" - }, - "RemediationEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates if the policy should be automatically applied to new resources.

" - } - }, - "documentation":"

An AWS Firewall Manager policy.

" - }, - "PolicyComplianceDetail":{ - "type":"structure", - "members":{ - "PolicyOwner":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account that created the AWS Firewall Manager policy.

" - }, - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the AWS Firewall Manager policy.

" - }, - "MemberAccount":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account ID.

" - }, - "Violators":{ - "shape":"ComplianceViolators", - "documentation":"

An array of resources that are not protected by the policy.

" - }, - "EvaluationLimitExceeded":{ - "shape":"Boolean", - "documentation":"

Indicates if over 100 resources are non-compliant with the AWS Firewall Manager policy.

" - }, - "ExpiredAt":{ - "shape":"TimeStamp", - "documentation":"

A time stamp that indicates when the returned information should be considered out-of-date.

" - } - }, - "documentation":"

Describes the non-compliant resources in a member account for a specific AWS Firewall Manager policy. A maximum of 100 entries are displayed. If more than 100 resources are non-compliant, EvaluationLimitExceeded is set to True.

" - }, - "PolicyComplianceStatus":{ - "type":"structure", - "members":{ - "PolicyOwner":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account that created the AWS Firewall Manager policy.

" - }, - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the AWS Firewall Manager policy.

" - }, - "PolicyName":{ - "shape":"ResourceName", - "documentation":"

The friendly name of the AWS Firewall Manager policy.

" - }, - "MemberAccount":{ - "shape":"AWSAccountId", - "documentation":"

The member account ID.

" - }, - "EvaluationResults":{ - "shape":"EvaluationResults", - "documentation":"

An array of EvaluationResult objects.

" - }, - "LastUpdated":{ - "shape":"TimeStamp", - "documentation":"

Time stamp of the last update to the EvaluationResult objects.

" - } - }, - "documentation":"

Indicates whether the account is compliant with the specified policy. An account is considered non-compliant if it includes resources that are not protected by the policy.

" - }, - "PolicyComplianceStatusList":{ - "type":"list", - "member":{"shape":"PolicyComplianceStatus"} - }, - "PolicyComplianceStatusType":{ - "type":"string", - "enum":[ - "COMPLIANT", - "NON_COMPLIANT" - ] - }, - "PolicyId":{ - "type":"string", - "max":36, - "min":36 - }, - "PolicySummary":{ - "type":"structure", - "members":{ - "PolicyArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the specified policy.

" - }, - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The ID of the specified policy.

" - }, - "PolicyName":{ - "shape":"ResourceName", - "documentation":"

The friendly name of the specified policy.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to protect with the policy, either an Application Load Balancer or a CloudFront distribution. This is in the format shown in AWS Resource Types Reference. Valid values are AWS::ElasticLoadBalancingV2::LoadBalancer or AWS::CloudFront::Distribution.

" - }, - "SecurityServiceType":{ - "shape":"SecurityServiceType", - "documentation":"

The service that the policy is using to protect the resources. This value is WAF.

" - }, - "RemediationEnabled":{ - "shape":"Boolean", - "documentation":"

Indicates if the policy should be automatically applied to new resources.

" - } - }, - "documentation":"

Details of the AWS Firewall Manager policy.

" - }, - "PolicySummaryList":{ - "type":"list", - "member":{"shape":"PolicySummary"} - }, - "PolicyUpdateToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "PutNotificationChannelRequest":{ - "type":"structure", - "required":[ - "SnsTopicArn", - "SnsRoleName" - ], - "members":{ - "SnsTopicArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic that collects notifications from AWS Firewall Manager.

" - }, - "SnsRoleName":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that allows Amazon SNS to record AWS Firewall Manager activity.

" - } - } - }, - "PutPolicyRequest":{ - "type":"structure", - "required":["Policy"], - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

The details of the AWS Firewall Manager policy to be created.

" - } - } - }, - "PutPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

The details of the AWS Firewall Manager policy that was created.

" - }, - "PolicyArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the policy that was created.

" - } - } - }, - "ResourceArn":{ - "type":"string", - "max":1024, - "min":1 - }, - "ResourceCount":{ - "type":"long", - "min":0 - }, - "ResourceId":{ - "type":"string", - "max":1024, - "min":1 - }, - "ResourceName":{ - "type":"string", - "max":128, - "min":1 - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource was not found.

", - "exception":true - }, - "ResourceTag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The resource tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The resource tag value.

" - } - }, - "documentation":"

The resource tags that AWS Firewall Manager uses to determine if a particular resource should be included or excluded from protection by the AWS Firewall Manager policy. Tags enable you to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. Tags are combined with an \"OR.\" That is, if you add more than one tag, if any of the tags matches, the resource is considered a match for the include or exclude. Working with Tag Editor.

" - }, - "ResourceTags":{ - "type":"list", - "member":{"shape":"ResourceTag"}, - "max":8, - "min":0 - }, - "ResourceType":{ - "type":"string", - "max":128, - "min":1 - }, - "SecurityServicePolicyData":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"SecurityServiceType", - "documentation":"

The service that the policy is using to protect the resources. This value is WAF.

" - }, - "ManagedServiceData":{ - "shape":"ManagedServiceData", - "documentation":"

Details about the service. This contains WAF data in JSON format, as shown in the following example:

ManagedServiceData\": \"{\\\"type\\\": \\\"WAF\\\", \\\"ruleGroups\\\": [{\\\"id\\\": \\\"12345678-1bcd-9012-efga-0987654321ab\\\", \\\"overrideAction\\\" : {\\\"type\\\": \\\"COUNT\\\"}}], \\\"defaultAction\\\": {\\\"type\\\": \\\"BLOCK\\\"}}

" - } - }, - "documentation":"

Details about the security service that is being used to protect the resources.

" - }, - "SecurityServiceType":{ - "type":"string", - "enum":["WAF"] - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagValue":{ - "type":"string", - "max":256, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TimeStamp":{"type":"timestamp"}, - "ViolationReason":{ - "type":"string", - "enum":[ - "WEB_ACL_MISSING_RULE_GROUP", - "RESOURCE_MISSING_WEB_ACL", - "RESOURCE_INCORRECT_WEB_ACL" - ] - } - }, - "documentation":"AWS Firewall Manager

This is the AWS Firewall Manager API Reference. This guide is for developers who need detailed information about the AWS Firewall Manager API actions, data types, and errors. For detailed information about AWS Firewall Manager features, see the AWS Firewall Manager Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/service-2.json deleted file mode 100644 index 4b399380..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/gamelift/2015-10-01/service-2.json +++ /dev/null @@ -1,5040 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-10-01", - "endpointPrefix":"gamelift", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon GameLift", - "serviceId":"GameLift", - "signatureVersion":"v4", - "targetPrefix":"GameLift", - "uid":"gamelift-2015-10-01" - }, - "operations":{ - "AcceptMatch":{ - "name":"AcceptMatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptMatchInput"}, - "output":{"shape":"AcceptMatchOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Registers a player's acceptance or rejection of a proposed FlexMatch match. A matchmaking configuration may require player acceptance; if so, then matches built with that configuration cannot be completed unless all players accept the proposed match within a specified time limit.

When FlexMatch builds a match, all the matchmaking tickets involved in the proposed match are placed into status REQUIRES_ACCEPTANCE. This is a trigger for your game to get acceptance from all players in the ticket. Acceptances are only valid for tickets when they are in this status; all other acceptances result in an error.

To register acceptance, specify the ticket ID, a response, and one or more players. Once all players have registered acceptance, the matchmaking tickets advance to status PLACING, where a new game session is created for the match.

If any player rejects the match, or if acceptances are not received before a specified timeout, the proposed match is dropped. The matchmaking tickets are then handled in one of two ways: For tickets where all players accepted the match, the ticket status is returned to SEARCHING to find a new match. For tickets where one or more players failed to accept the match, the ticket status is set to FAILED, and processing is terminated. A new matchmaking request for these players can be submitted as needed.

Matchmaking-related operations include:

" - }, - "CreateAlias":{ - "name":"CreateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAliasInput"}, - "output":{"shape":"CreateAliasOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ConflictException"}, - {"shape":"InternalServiceException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an alias for a fleet. In most situations, you can use an alias ID in place of a fleet ID. By using a fleet alias instead of a specific fleet ID, you can switch gameplay and players to a new fleet without changing your game client or other game components. For example, for games in production, using an alias allows you to seamlessly redirect your player base to a new game server update.

Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. A simple alias points to an active fleet. A terminal alias is used to display messaging or link to a URL instead of routing players to an active fleet. For example, you might use a terminal alias when a game version is no longer supported and you want to direct players to an upgrade site.

To create a fleet alias, specify an alias name, routing strategy, and optional description. Each simple alias can point to only one fleet, but a fleet can have multiple aliases. If successful, a new alias record is returned, including an alias ID, which you can reference when creating a game session. You can reassign an alias to another fleet by calling UpdateAlias.

Alias-related operations include:

" - }, - "CreateBuild":{ - "name":"CreateBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBuildInput"}, - "output":{"shape":"CreateBuildOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ConflictException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Creates a new Amazon GameLift build record for your game server binary files and points to the location of your game server build files in an Amazon Simple Storage Service (Amazon S3) location.

Game server binaries must be combined into a .zip file for use with Amazon GameLift. See Uploading Your Game for more information.

To create new builds quickly and easily, use the AWS CLI command upload-build . This helper command uploads your build and creates a new build record in one step, and automatically handles the necessary permissions. See Upload Build Files to Amazon GameLift for more help.

The CreateBuild operation should be used only when you need to manually upload your build files, as in the following scenarios:

  • Store a build file in an Amazon S3 bucket under your own AWS account. To use this option, you must first give Amazon GameLift access to that Amazon S3 bucket. See Create a Build with Files in Amazon S3 for detailed help. To create a new build record using files in your Amazon S3 bucket, call CreateBuild and specify a build name, operating system, and the storage location of your game build.

  • Upload a build file directly to Amazon GameLift's Amazon S3 account. To use this option, you first call CreateBuild with a build name and operating system. This action creates a new build record and returns an Amazon S3 storage location (bucket and key only) and temporary access credentials. Use the credentials to manually upload your build file to the storage location (see the Amazon S3 topic Uploading Objects). You can upload files to a location only once.

If successful, this operation creates a new build record with a unique build ID and places it in INITIALIZED status. You can use DescribeBuild to check the status of your build. A build must be in READY status before it can be used to create fleets.

Build-related operations include:

" - }, - "CreateFleet":{ - "name":"CreateFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateFleetInput"}, - "output":{"shape":"CreateFleetOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Creates a new fleet to run your game servers. A fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can run multiple server processes to host game sessions. You set up a fleet to use instances with certain hardware specifications (see Amazon EC2 Instance Types for more information), and deploy your game build to run on each instance.

To create a new fleet, you must specify the following: (1) a fleet name, (2) the build ID of a successfully uploaded game build, (3) an EC2 instance type, and (4) a run-time configuration, which describes the server processes to run on each instance in the fleet. If you don't specify a fleet type (on-demand or spot), the new fleet uses on-demand instances by default.

You can also configure the new fleet with the following settings:

  • Fleet description

  • Access permissions for inbound traffic

  • Fleet-wide game session protection

  • Resource usage limits

If you use Amazon CloudWatch for metrics, you can add the new fleet to a metric group. By adding multiple fleets to a metric group, you can view aggregated metrics for all the fleets in the group.

If the CreateFleet call is successful, Amazon GameLift performs the following tasks. You can track the process of a fleet by checking the fleet status or by monitoring fleet creation events:

  • Creates a fleet record. Status: NEW.

  • Begins writing events to the fleet event log, which can be accessed in the Amazon GameLift console.

    Sets the fleet's target capacity to 1 (desired instances), which triggers Amazon GameLift to start one new EC2 instance.

  • Downloads the game build to the new instance and installs it. Statuses: DOWNLOADING, VALIDATING, BUILDING.

  • Starts launching server processes on the instance. If the fleet is configured to run multiple server processes per instance, Amazon GameLift staggers each launch by a few seconds. Status: ACTIVATING.

  • Sets the fleet's status to ACTIVE as soon as one server process is ready to host a game session.

Fleet-related operations include:

" - }, - "CreateGameSession":{ - "name":"CreateGameSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGameSessionInput"}, - "output":{"shape":"CreateGameSessionOutput"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidFleetStatusException"}, - {"shape":"TerminalRoutingStrategyException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"FleetCapacityExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"IdempotentParameterMismatchException"} - ], - "documentation":"

Creates a multiplayer game session for players. This action creates a game session record and assigns an available server process in the specified fleet to host the game session. A fleet must have an ACTIVE status before a game session can be created in it.

To create a game session, specify either fleet ID or alias ID and indicate a maximum number of players to allow in the game session. You can also provide a name and game-specific properties for this game session. If successful, a GameSession object is returned containing the game session properties and other settings you specified.

Idempotency tokens. You can add a token that uniquely identifies game session requests. This is useful for ensuring that game session requests are idempotent. Multiple requests with the same idempotency token are processed only once; subsequent requests return the original result. All response values are the same with the exception of game session status, which may change.

Resource creation limits. If you are creating a game session on a fleet with a resource creation limit policy in force, then you must specify a creator ID. Without this ID, Amazon GameLift has no way to evaluate the policy for this new game session request.

Player acceptance policy. By default, newly created game sessions are open to new players. You can restrict new player access by using UpdateGameSession to change the game session's player session creation policy.

Game session logs. Logs are retained for all active game sessions for 14 days. To access the logs, call GetGameSessionLogUrl to download the log files.

Available in Amazon GameLift Local.

Game-session-related operations include:

" - }, - "CreateGameSessionQueue":{ - "name":"CreateGameSessionQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGameSessionQueueInput"}, - "output":{"shape":"CreateGameSessionQueueOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Establishes a new queue for processing requests to place new game sessions. A queue identifies where new game sessions can be hosted -- by specifying a list of destinations (fleets or aliases) -- and how long requests can wait in the queue before timing out. You can set up a queue to try to place game sessions on fleets in multiple regions. To add placement requests to a queue, call StartGameSessionPlacement and reference the queue name.

Destination order. When processing a request for a game session, Amazon GameLift tries each destination in order until it finds one with available resources to host the new game session. A queue's default order is determined by how destinations are listed. The default order is overridden when a game session placement request provides player latency information. Player latency information enables Amazon GameLift to prioritize destinations where players report the lowest average latency, as a result placing the new game session where the majority of players will have the best possible gameplay experience.

Player latency policies. For placement requests containing player latency information, use player latency policies to protect individual players from very high latencies. With a latency cap, even when a destination can deliver a low latency for most players, the game is not placed where any individual player is reporting latency higher than a policy's maximum. A queue can have multiple latency policies, which are enforced consecutively starting with the policy with the lowest latency cap. Use multiple policies to gradually relax latency controls; for example, you might set a policy with a low latency cap for the first 60 seconds, a second policy with a higher cap for the next 60 seconds, etc.

To create a new queue, provide a name, timeout value, a list of destinations and, if desired, a set of latency policies. If successful, a new queue object is returned.

Queue-related operations include:

" - }, - "CreateMatchmakingConfiguration":{ - "name":"CreateMatchmakingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateMatchmakingConfigurationInput"}, - "output":{"shape":"CreateMatchmakingConfigurationOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Defines a new matchmaking configuration for use with FlexMatch. A matchmaking configuration sets out guidelines for matching players and getting the matches into games. You can set up multiple matchmaking configurations to handle the scenarios needed for your game. Each matchmaking ticket (StartMatchmaking or StartMatchBackfill) specifies a configuration for the match and provides player attributes to support the configuration being used.

To create a matchmaking configuration, at a minimum you must specify the following: configuration name; a rule set that governs how to evaluate players and find acceptable matches; a game session queue to use when placing a new game session for the match; and the maximum time allowed for a matchmaking attempt.

Player acceptance -- In each configuration, you have the option to require that all players accept participation in a proposed match. To enable this feature, set AcceptanceRequired to true and specify a time limit for player acceptance. Players have the option to accept or reject a proposed match, and a match does not move ahead to game session placement unless all matched players accept.

Matchmaking status notification -- There are two ways to track the progress of matchmaking tickets: (1) polling ticket status with DescribeMatchmaking; or (2) receiving notifications with Amazon Simple Notification Service (SNS). To use notifications, you first need to set up an SNS topic to receive the notifications, and provide the topic ARN in the matchmaking configuration (see Setting up Notifications for Matchmaking). Since notifications promise only \"best effort\" delivery, we recommend calling DescribeMatchmaking if no notifications are received within 30 seconds.

Operations related to match configurations and rule sets include:

" - }, - "CreateMatchmakingRuleSet":{ - "name":"CreateMatchmakingRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateMatchmakingRuleSetInput"}, - "output":{"shape":"CreateMatchmakingRuleSetOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Creates a new rule set for FlexMatch matchmaking. A rule set describes the type of match to create, such as the number and size of teams, and sets the parameters for acceptable player matches, such as minimum skill level or character type. Rule sets are used in matchmaking configurations, which define how matchmaking requests are handled. Each MatchmakingConfiguration uses one rule set; you can set up multiple rule sets to handle the scenarios that suit your game (such as for different game modes), and create a separate matchmaking configuration for each rule set. See additional information on rule set content in the MatchmakingRuleSet structure. For help creating rule sets, including useful examples, see the topic Adding FlexMatch to Your Game.

Once created, matchmaking rule sets cannot be changed or deleted, so we recommend checking the rule set syntax using ValidateMatchmakingRuleSet before creating the rule set.

To create a matchmaking rule set, provide the set of rules and a unique name. Rule sets must be defined in the same region as the matchmaking configuration they will be used with. Rule sets cannot be edited or deleted. If you need to change a rule set, create a new one with the necessary edits and then update matchmaking configurations to use the new rule set.

Operations related to match configurations and rule sets include:

" - }, - "CreatePlayerSession":{ - "name":"CreatePlayerSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlayerSessionInput"}, - "output":{"shape":"CreatePlayerSessionOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidGameSessionStatusException"}, - {"shape":"GameSessionFullException"}, - {"shape":"TerminalRoutingStrategyException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Adds a player to a game session and creates a player session record. Before a player can be added, a game session must have an ACTIVE status, have a creation policy of ALLOW_ALL, and have an open player slot. To add a group of players to a game session, use CreatePlayerSessions.

To create a player session, specify a game session ID, player ID, and optionally a string of player data. If successful, the player is added to the game session and a new PlayerSession object is returned. Player sessions cannot be updated.

Available in Amazon GameLift Local.

Player-session-related operations include:

" - }, - "CreatePlayerSessions":{ - "name":"CreatePlayerSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlayerSessionsInput"}, - "output":{"shape":"CreatePlayerSessionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidGameSessionStatusException"}, - {"shape":"GameSessionFullException"}, - {"shape":"TerminalRoutingStrategyException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Adds a group of players to a game session. This action is useful with a team matching feature. Before players can be added, a game session must have an ACTIVE status, have a creation policy of ALLOW_ALL, and have an open player slot. To add a single player to a game session, use CreatePlayerSession.

To create player sessions, specify a game session ID, a list of player IDs, and optionally a set of player data strings. If successful, the players are added to the game session and a set of new PlayerSession objects is returned. Player sessions cannot be updated.

Available in Amazon GameLift Local.

Player-session-related operations include:

" - }, - "CreateVpcPeeringAuthorization":{ - "name":"CreateVpcPeeringAuthorization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringAuthorizationInput"}, - "output":{"shape":"CreateVpcPeeringAuthorizationOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Requests authorization to create or delete a peer connection between the VPC for your Amazon GameLift fleet and a virtual private cloud (VPC) in your AWS account. VPC peering enables the game servers on your fleet to communicate directly with other AWS resources. Once you've received authorization, call CreateVpcPeeringConnection to establish the peering connection. For more information, see VPC Peering with Amazon GameLift Fleets.

You can peer with VPCs that are owned by any AWS account you have access to, including the account that you use to manage your Amazon GameLift fleets. You cannot peer with VPCs that are in different regions.

To request authorization to create a connection, call this operation from the AWS account with the VPC that you want to peer to your Amazon GameLift fleet. For example, to enable your game servers to retrieve data from a DynamoDB table, use the account that manages that DynamoDB resource. Identify the following values: (1) The ID of the VPC that you want to peer with, and (2) the ID of the AWS account that you use to manage Amazon GameLift. If successful, VPC peering is authorized for the specified VPC.

To request authorization to delete a connection, call this operation from the AWS account with the VPC that is peered with your Amazon GameLift fleet. Identify the following values: (1) VPC ID that you want to delete the peering connection for, and (2) ID of the AWS account that you use to manage Amazon GameLift.

The authorization remains valid for 24 hours unless it is canceled by a call to DeleteVpcPeeringAuthorization. You must create or delete the peering connection while the authorization is valid.

VPC peering connection operations include:

" - }, - "CreateVpcPeeringConnection":{ - "name":"CreateVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVpcPeeringConnectionInput"}, - "output":{"shape":"CreateVpcPeeringConnectionOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Establishes a VPC peering connection between a virtual private cloud (VPC) in an AWS account with the VPC for your Amazon GameLift fleet. VPC peering enables the game servers on your fleet to communicate directly with other AWS resources. You can peer with VPCs in any AWS account that you have access to, including the account that you use to manage your Amazon GameLift fleets. You cannot peer with VPCs that are in different regions. For more information, see VPC Peering with Amazon GameLift Fleets.

Before calling this operation to establish the peering connection, you first need to call CreateVpcPeeringAuthorization and identify the VPC you want to peer with. Once the authorization for the specified VPC is issued, you have 24 hours to establish the connection. These two operations handle all tasks necessary to peer the two VPCs, including acceptance, updating routing tables, etc.

To establish the connection, call this operation from the AWS account that is used to manage the Amazon GameLift fleets. Identify the following values: (1) The ID of the fleet you want to be enable a VPC peering connection for; (2) The AWS account with the VPC that you want to peer with; and (3) The ID of the VPC you want to peer with. This operation is asynchronous. If successful, a VpcPeeringConnection request is created. You can use continuous polling to track the request's status using DescribeVpcPeeringConnections, or by monitoring fleet events for success or failure using DescribeFleetEvents.

VPC peering connection operations include:

" - }, - "DeleteAlias":{ - "name":"DeleteAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAliasInput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Deletes an alias. This action removes all record of the alias. Game clients attempting to access a server process using the deleted alias receive an error. To delete an alias, specify the alias ID to be deleted.

Alias-related operations include:

" - }, - "DeleteBuild":{ - "name":"DeleteBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBuildInput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Deletes a build. This action permanently deletes the build record and any uploaded build files.

To delete a build, specify its ID. Deleting a build does not affect the status of any active fleets using the build, but you can no longer create new fleets with the deleted build.

Build-related operations include:

" - }, - "DeleteFleet":{ - "name":"DeleteFleet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFleetInput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidFleetStatusException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Deletes everything related to a fleet. Before deleting a fleet, you must set the fleet's desired capacity to zero. See UpdateFleetCapacity.

This action removes the fleet's resources and the fleet record. Once a fleet is deleted, you can no longer use that fleet.

Fleet-related operations include:

" - }, - "DeleteGameSessionQueue":{ - "name":"DeleteGameSessionQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGameSessionQueueInput"}, - "output":{"shape":"DeleteGameSessionQueueOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Deletes a game session queue. This action means that any StartGameSessionPlacement requests that reference this queue will fail. To delete a queue, specify the queue name.

Queue-related operations include:

" - }, - "DeleteMatchmakingConfiguration":{ - "name":"DeleteMatchmakingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMatchmakingConfigurationInput"}, - "output":{"shape":"DeleteMatchmakingConfigurationOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Permanently removes a FlexMatch matchmaking configuration. To delete, specify the configuration name. A matchmaking configuration cannot be deleted if it is being used in any active matchmaking tickets.

Operations related to match configurations and rule sets include:

" - }, - "DeleteScalingPolicy":{ - "name":"DeleteScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteScalingPolicyInput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a fleet scaling policy. This action means that the policy is no longer in force and removes all record of it. To delete a scaling policy, specify both the scaling policy name and the fleet ID it is associated with.

To temporarily suspend scaling policies, call StopFleetActions. This operation suspends all policies for the fleet.

Operations related to fleet capacity scaling include:

" - }, - "DeleteVpcPeeringAuthorization":{ - "name":"DeleteVpcPeeringAuthorization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringAuthorizationInput"}, - "output":{"shape":"DeleteVpcPeeringAuthorizationOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Cancels a pending VPC peering authorization for the specified VPC. If the authorization has already been used to create a peering connection, call DeleteVpcPeeringConnection to remove the connection.

VPC peering connection operations include:

" - }, - "DeleteVpcPeeringConnection":{ - "name":"DeleteVpcPeeringConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVpcPeeringConnectionInput"}, - "output":{"shape":"DeleteVpcPeeringConnectionOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Removes a VPC peering connection. To delete the connection, you must have a valid authorization for the VPC peering connection that you want to delete. You can check for an authorization by calling DescribeVpcPeeringAuthorizations or request a new one using CreateVpcPeeringAuthorization.

Once a valid authorization exists, call this operation from the AWS account that is used to manage the Amazon GameLift fleets. Identify the connection to delete by the connection ID and fleet ID. If successful, the connection is removed.

VPC peering connection operations include:

" - }, - "DescribeAlias":{ - "name":"DescribeAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAliasInput"}, - "output":{"shape":"DescribeAliasOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves properties for an alias. This operation returns all alias metadata and settings. To get an alias's target fleet ID only, use ResolveAlias.

To get alias properties, specify the alias ID. If successful, the requested alias record is returned.

Alias-related operations include:

" - }, - "DescribeBuild":{ - "name":"DescribeBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBuildInput"}, - "output":{"shape":"DescribeBuildOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves properties for a build. To request a build record, specify a build ID. If successful, an object containing the build properties is returned.

Build-related operations include:

" - }, - "DescribeEC2InstanceLimits":{ - "name":"DescribeEC2InstanceLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEC2InstanceLimitsInput"}, - "output":{"shape":"DescribeEC2InstanceLimitsOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves the following information for the specified EC2 instance type:

  • maximum number of instances allowed per AWS account (service limit)

  • current usage level for the AWS account

Service limits vary depending on region. Available regions for Amazon GameLift can be found in the AWS Management Console for Amazon GameLift (see the drop-down list in the upper right corner).

Fleet-related operations include:

" - }, - "DescribeFleetAttributes":{ - "name":"DescribeFleetAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetAttributesInput"}, - "output":{"shape":"DescribeFleetAttributesOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves fleet properties, including metadata, status, and configuration, for one or more fleets. You can request attributes for all fleets, or specify a list of one or more fleet IDs. When requesting multiple fleets, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a FleetAttributes object is returned for each requested fleet ID. When specifying a list of fleet IDs, attribute objects are returned only for fleets that currently exist.

Some API actions may limit the number of fleet IDs allowed in one request. If a request exceeds this limit, the request fails and the error message includes the maximum allowed.

Fleet-related operations include:

" - }, - "DescribeFleetCapacity":{ - "name":"DescribeFleetCapacity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetCapacityInput"}, - "output":{"shape":"DescribeFleetCapacityOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves the current status of fleet capacity for one or more fleets. This information includes the number of instances that have been requested for the fleet and the number currently active. You can request capacity for all fleets, or specify a list of one or more fleet IDs. When requesting multiple fleets, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a FleetCapacity object is returned for each requested fleet ID. When specifying a list of fleet IDs, attribute objects are returned only for fleets that currently exist.

Some API actions may limit the number of fleet IDs allowed in one request. If a request exceeds this limit, the request fails and the error message includes the maximum allowed.

Fleet-related operations include:

" - }, - "DescribeFleetEvents":{ - "name":"DescribeFleetEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetEventsInput"}, - "output":{"shape":"DescribeFleetEventsOutput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Retrieves entries from the specified fleet's event log. You can specify a time range to limit the result set. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a collection of event log entries matching the request are returned.

Fleet-related operations include:

" - }, - "DescribeFleetPortSettings":{ - "name":"DescribeFleetPortSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetPortSettingsInput"}, - "output":{"shape":"DescribeFleetPortSettingsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves the inbound connection permissions for a fleet. Connection permissions include a range of IP addresses and port settings that incoming traffic can use to access server processes in the fleet. To get a fleet's inbound connection permissions, specify a fleet ID. If successful, a collection of IpPermission objects is returned for the requested fleet ID. If the requested fleet has been deleted, the result set is empty.

Fleet-related operations include:

" - }, - "DescribeFleetUtilization":{ - "name":"DescribeFleetUtilization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFleetUtilizationInput"}, - "output":{"shape":"DescribeFleetUtilizationOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves utilization statistics for one or more fleets. You can request utilization data for all fleets, or specify a list of one or more fleet IDs. When requesting multiple fleets, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a FleetUtilization object is returned for each requested fleet ID. When specifying a list of fleet IDs, utilization objects are returned only for fleets that currently exist.

Some API actions may limit the number of fleet IDs allowed in one request. If a request exceeds this limit, the request fails and the error message includes the maximum allowed.

Fleet-related operations include:

" - }, - "DescribeGameSessionDetails":{ - "name":"DescribeGameSessionDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGameSessionDetailsInput"}, - "output":{"shape":"DescribeGameSessionDetailsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TerminalRoutingStrategyException"} - ], - "documentation":"

Retrieves properties, including the protection policy in force, for one or more game sessions. This action can be used in several ways: (1) provide a GameSessionId or GameSessionArn to request details for a specific game session; (2) provide either a FleetId or an AliasId to request properties for all game sessions running on a fleet.

To get game session record(s), specify just one of the following: game session ID, fleet ID, or alias ID. You can filter this request by game session status. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a GameSessionDetail object is returned for each session matching the request.

Game-session-related operations include:

" - }, - "DescribeGameSessionPlacement":{ - "name":"DescribeGameSessionPlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGameSessionPlacementInput"}, - "output":{"shape":"DescribeGameSessionPlacementOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves properties and current status of a game session placement request. To get game session placement details, specify the placement ID. If successful, a GameSessionPlacement object is returned.

Game-session-related operations include:

" - }, - "DescribeGameSessionQueues":{ - "name":"DescribeGameSessionQueues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGameSessionQueuesInput"}, - "output":{"shape":"DescribeGameSessionQueuesOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves the properties for one or more game session queues. When requesting multiple queues, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a GameSessionQueue object is returned for each requested queue. When specifying a list of queues, objects are returned only for queues that currently exist in the region.

Queue-related operations include:

" - }, - "DescribeGameSessions":{ - "name":"DescribeGameSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGameSessionsInput"}, - "output":{"shape":"DescribeGameSessionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TerminalRoutingStrategyException"} - ], - "documentation":"

Retrieves a set of one or more game sessions. Request a specific game session or request all game sessions on a fleet. Alternatively, use SearchGameSessions to request a set of active game sessions that are filtered by certain criteria. To retrieve protection policy settings for game sessions, use DescribeGameSessionDetails.

To get game sessions, specify one of the following: game session ID, fleet ID, or alias ID. You can filter this request by game session status. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a GameSession object is returned for each game session matching the request.

Available in Amazon GameLift Local.

Game-session-related operations include:

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesInput"}, - "output":{"shape":"DescribeInstancesOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves information about a fleet's instances, including instance IDs. Use this action to get details on all instances in the fleet or get details on one specific instance.

To get a specific instance, specify fleet ID and instance ID. To get all instances in a fleet, specify a fleet ID only. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, an Instance object is returned for each result.

" - }, - "DescribeMatchmaking":{ - "name":"DescribeMatchmaking", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMatchmakingInput"}, - "output":{"shape":"DescribeMatchmakingOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Retrieves one or more matchmaking tickets. Use this operation to retrieve ticket information, including status and--once a successful match is made--acquire connection information for the resulting new game session.

You can use this operation to track the progress of matchmaking requests (through polling) as an alternative to using event notifications. See more details on tracking matchmaking requests through polling or notifications in StartMatchmaking.

To request matchmaking tickets, provide a list of up to 10 ticket IDs. If the request is successful, a ticket object is returned for each requested ID that currently exists.

Matchmaking-related operations include:

" - }, - "DescribeMatchmakingConfigurations":{ - "name":"DescribeMatchmakingConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMatchmakingConfigurationsInput"}, - "output":{"shape":"DescribeMatchmakingConfigurationsOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Retrieves the details of FlexMatch matchmaking configurations. with this operation, you have the following options: (1) retrieve all existing configurations, (2) provide the names of one or more configurations to retrieve, or (3) retrieve all configurations that use a specified rule set name. When requesting multiple items, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a configuration is returned for each requested name. When specifying a list of names, only configurations that currently exist are returned.

Operations related to match configurations and rule sets include:

" - }, - "DescribeMatchmakingRuleSets":{ - "name":"DescribeMatchmakingRuleSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMatchmakingRuleSetsInput"}, - "output":{"shape":"DescribeMatchmakingRuleSetsOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Retrieves the details for FlexMatch matchmaking rule sets. You can request all existing rule sets for the region, or provide a list of one or more rule set names. When requesting multiple items, use the pagination parameters to retrieve results as a set of sequential pages. If successful, a rule set is returned for each requested name.

Operations related to match configurations and rule sets include:

" - }, - "DescribePlayerSessions":{ - "name":"DescribePlayerSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePlayerSessionsInput"}, - "output":{"shape":"DescribePlayerSessionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves properties for one or more player sessions. This action can be used in several ways: (1) provide a PlayerSessionId to request properties for a specific player session; (2) provide a GameSessionId to request properties for all player sessions in the specified game session; (3) provide a PlayerId to request properties for all player sessions of a specified player.

To get game session record(s), specify only one of the following: a player session ID, a game session ID, or a player ID. You can filter this request by player session status. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a PlayerSession object is returned for each session matching the request.

Available in Amazon GameLift Local.

Player-session-related operations include:

" - }, - "DescribeRuntimeConfiguration":{ - "name":"DescribeRuntimeConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRuntimeConfigurationInput"}, - "output":{"shape":"DescribeRuntimeConfigurationOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Retrieves the current run-time configuration for the specified fleet. The run-time configuration tells Amazon GameLift how to launch server processes on instances in the fleet.

Fleet-related operations include:

" - }, - "DescribeScalingPolicies":{ - "name":"DescribeScalingPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeScalingPoliciesInput"}, - "output":{"shape":"DescribeScalingPoliciesOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Retrieves all scaling policies applied to a fleet.

To get a fleet's scaling policies, specify the fleet ID. You can filter this request by policy status, such as to retrieve only active scaling policies. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, set of ScalingPolicy objects is returned for the fleet.

A fleet may have all of its scaling policies suspended (StopFleetActions). This action does not affect the status of the scaling policies, which remains ACTIVE. To see whether a fleet's scaling policies are in force or suspended, call DescribeFleetAttributes and check the stopped actions.

Operations related to fleet capacity scaling include:

" - }, - "DescribeVpcPeeringAuthorizations":{ - "name":"DescribeVpcPeeringAuthorizations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringAuthorizationsInput"}, - "output":{"shape":"DescribeVpcPeeringAuthorizationsOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves valid VPC peering authorizations that are pending for the AWS account. This operation returns all VPC peering authorizations and requests for peering. This includes those initiated and received by this account.

VPC peering connection operations include:

" - }, - "DescribeVpcPeeringConnections":{ - "name":"DescribeVpcPeeringConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVpcPeeringConnectionsInput"}, - "output":{"shape":"DescribeVpcPeeringConnectionsOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves information on VPC peering connections. Use this operation to get peering information for all fleets or for one specific fleet ID.

To retrieve connection information, call this operation from the AWS account that is used to manage the Amazon GameLift fleets. Specify a fleet ID or leave the parameter empty to retrieve all connection records. If successful, the retrieved information includes both active and pending connections. Active connections identify the IpV4 CIDR block that the VPC uses to connect.

VPC peering connection operations include:

" - }, - "GetGameSessionLogUrl":{ - "name":"GetGameSessionLogUrl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGameSessionLogUrlInput"}, - "output":{"shape":"GetGameSessionLogUrlOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Retrieves the location of stored game session logs for a specified game session. When a game session is terminated, Amazon GameLift automatically stores the logs in Amazon S3 and retains them for 14 days. Use this URL to download the logs.

See the AWS Service Limits page for maximum log file sizes. Log files that exceed this limit are not saved.

Game-session-related operations include:

" - }, - "GetInstanceAccess":{ - "name":"GetInstanceAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceAccessInput"}, - "output":{"shape":"GetInstanceAccessOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Requests remote access to a fleet instance. Remote access is useful for debugging, gathering benchmarking data, or watching activity in real time.

Access requires credentials that match the operating system of the instance. For a Windows instance, Amazon GameLift returns a user name and password as strings for use with a Windows Remote Desktop client. For a Linux instance, Amazon GameLift returns a user name and RSA private key, also as strings, for use with an SSH client. The private key must be saved in the proper format to a .pem file before using. If you're making this request using the AWS CLI, saving the secret can be handled as part of the GetInstanceAccess request. (See the example later in this topic). For more information on remote access, see Remotely Accessing an Instance.

To request access to a specific instance, specify the IDs of the instance and the fleet it belongs to. If successful, an InstanceAccess object is returned containing the instance's IP address and a set of credentials.

" - }, - "ListAliases":{ - "name":"ListAliases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAliasesInput"}, - "output":{"shape":"ListAliasesOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves all aliases for this AWS account. You can filter the result set by alias name and/or routing strategy type. Use the pagination parameters to retrieve results in sequential pages.

Returned aliases are not listed in any particular order.

Alias-related operations include:

" - }, - "ListBuilds":{ - "name":"ListBuilds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBuildsInput"}, - "output":{"shape":"ListBuildsOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves build records for all builds associated with the AWS account in use. You can limit results to builds that are in a specific status by using the Status parameter. Use the pagination parameters to retrieve results in a set of sequential pages.

Build records are not listed in any particular order.

Build-related operations include:

" - }, - "ListFleets":{ - "name":"ListFleets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListFleetsInput"}, - "output":{"shape":"ListFleetsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Retrieves a collection of fleet records for this AWS account. You can filter the result set by build ID. Use the pagination parameters to retrieve results in sequential pages.

Fleet records are not listed in any particular order.

Fleet-related operations include:

" - }, - "PutScalingPolicy":{ - "name":"PutScalingPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutScalingPolicyInput"}, - "output":{"shape":"PutScalingPolicyOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Creates or updates a scaling policy for a fleet. Scaling policies are used to automatically scale a fleet's hosting capacity to meet player demand. An active scaling policy instructs Amazon GameLift to track a fleet metric and automatically change the fleet's capacity when a certain threshold is reached. There are two types of scaling policies: target-based and rule-based. Use a target-based policy to quickly and efficiently manage fleet scaling; this option is the most commonly used. Use rule-based policies when you need to exert fine-grained control over auto-scaling.

Fleets can have multiple scaling policies of each type in force at the same time; you can have one target-based policy, one or multiple rule-based scaling policies, or both. We recommend caution, however, because multiple auto-scaling policies can have unintended consequences.

You can temporarily suspend all scaling policies for a fleet by calling StopFleetActions with the fleet action AUTO_SCALING. To resume scaling policies, call StartFleetActions with the same fleet action. To stop just one scaling policy--or to permanently remove it, you must delete the policy with DeleteScalingPolicy.

Learn more about how to work with auto-scaling in Set Up Fleet Automatic Scaling.

Target-based policy

A target-based policy tracks a single metric: PercentAvailableGameSessions. This metric tells us how much of a fleet's hosting capacity is ready to host game sessions but is not currently in use. This is the fleet's buffer; it measures the additional player demand that the fleet could handle at current capacity. With a target-based policy, you set your ideal buffer size and leave it to Amazon GameLift to take whatever action is needed to maintain that target.

For example, you might choose to maintain a 10% buffer for a fleet that has the capacity to host 100 simultaneous game sessions. This policy tells Amazon GameLift to take action whenever the fleet's available capacity falls below or rises above 10 game sessions. Amazon GameLift will start new instances or stop unused instances in order to return to the 10% buffer.

To create or update a target-based policy, specify a fleet ID and name, and set the policy type to \"TargetBased\". Specify the metric to track (PercentAvailableGameSessions) and reference a TargetConfiguration object with your desired buffer value. Exclude all other parameters. On a successful request, the policy name is returned. The scaling policy is automatically in force as soon as it's successfully created. If the fleet's auto-scaling actions are temporarily suspended, the new policy will be in force once the fleet actions are restarted.

Rule-based policy

A rule-based policy tracks specified fleet metric, sets a threshold value, and specifies the type of action to initiate when triggered. With a rule-based policy, you can select from several available fleet metrics. Each policy specifies whether to scale up or scale down (and by how much), so you need one policy for each type of action.

For example, a policy may make the following statement: \"If the percentage of idle instances is greater than 20% for more than 15 minutes, then reduce the fleet capacity by 10%.\"

A policy's rule statement has the following structure:

If [MetricName] is [ComparisonOperator] [Threshold] for [EvaluationPeriods] minutes, then [ScalingAdjustmentType] to/by [ScalingAdjustment].

To implement the example, the rule statement would look like this:

If [PercentIdleInstances] is [GreaterThanThreshold] [20] for [15] minutes, then [PercentChangeInCapacity] to/by [10].

To create or update a scaling policy, specify a unique combination of name and fleet ID, and set the policy type to \"RuleBased\". Specify the parameter values for a policy rule statement. On a successful request, the policy name is returned. Scaling policies are automatically in force as soon as they're successfully created. If the fleet's auto-scaling actions are temporarily suspended, the new policy will be in force once the fleet actions are restarted.

Operations related to fleet capacity scaling include:

" - }, - "RequestUploadCredentials":{ - "name":"RequestUploadCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestUploadCredentialsInput"}, - "output":{"shape":"RequestUploadCredentialsOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves a fresh set of credentials for use when uploading a new set of game build files to Amazon GameLift's Amazon S3. This is done as part of the build creation process; see CreateBuild.

To request new credentials, specify the build ID as returned with an initial CreateBuild request. If successful, a new set of credentials are returned, along with the S3 storage location associated with the build ID.

" - }, - "ResolveAlias":{ - "name":"ResolveAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResolveAliasInput"}, - "output":{"shape":"ResolveAliasOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"TerminalRoutingStrategyException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves the fleet ID that a specified alias is currently pointing to.

Alias-related operations include:

" - }, - "SearchGameSessions":{ - "name":"SearchGameSessions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchGameSessionsInput"}, - "output":{"shape":"SearchGameSessionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TerminalRoutingStrategyException"} - ], - "documentation":"

Retrieves all active game sessions that match a set of search criteria and sorts them in a specified order. You can search or sort by the following game session attributes:

  • gameSessionId -- Unique identifier for the game session. You can use either a GameSessionId or GameSessionArn value.

  • gameSessionName -- Name assigned to a game session. This value is set when requesting a new game session with CreateGameSession or updating with UpdateGameSession. Game session names do not need to be unique to a game session.

  • gameSessionProperties -- Custom data defined in a game session's GameProperty parameter. GameProperty values are stored as key:value pairs; the filter expression must indicate the key and a string to search the data values for. For example, to search for game sessions with custom data containing the key:value pair \"gameMode:brawl\", specify the following: gameSessionProperties.gameMode = \"brawl\". All custom data values are searched as strings.

  • maximumSessions -- Maximum number of player sessions allowed for a game session. This value is set when requesting a new game session with CreateGameSession or updating with UpdateGameSession.

  • creationTimeMillis -- Value indicating when a game session was created. It is expressed in Unix time as milliseconds.

  • playerSessionCount -- Number of players currently connected to a game session. This value changes rapidly as players join the session or drop out.

  • hasAvailablePlayerSessions -- Boolean value indicating whether a game session has reached its maximum number of players. It is highly recommended that all search requests include this filter attribute to optimize search performance and return only sessions that players can join.

Returned values for playerSessionCount and hasAvailablePlayerSessions change quickly as players join sessions and others drop out. Results should be considered a snapshot in time. Be sure to refresh search results often, and handle sessions that fill up before a player can join.

To search or sort, specify either a fleet ID or an alias ID, and provide a search filter expression, a sort expression, or both. If successful, a collection of GameSession objects matching the request is returned. Use the pagination parameters to retrieve results as a set of sequential pages.

You can search for game sessions one fleet at a time only. To find game sessions across multiple fleets, you must search each fleet separately and combine the results. This search feature finds only game sessions that are in ACTIVE status. To locate games in statuses other than active, use DescribeGameSessionDetails.

Game-session-related operations include:

" - }, - "StartFleetActions":{ - "name":"StartFleetActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartFleetActionsInput"}, - "output":{"shape":"StartFleetActionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Resumes activity on a fleet that was suspended with StopFleetActions. Currently, this operation is used to restart a fleet's auto-scaling activity.

To start fleet actions, specify the fleet ID and the type of actions to restart. When auto-scaling fleet actions are restarted, Amazon GameLift once again initiates scaling events as triggered by the fleet's scaling policies. If actions on the fleet were never stopped, this operation will have no effect. You can view a fleet's stopped actions using DescribeFleetAttributes.

Operations related to fleet capacity scaling include:

" - }, - "StartGameSessionPlacement":{ - "name":"StartGameSessionPlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartGameSessionPlacementInput"}, - "output":{"shape":"StartGameSessionPlacementOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Places a request for a new game session in a queue (see CreateGameSessionQueue). When processing a placement request, Amazon GameLift searches for available resources on the queue's destinations, scanning each until it finds resources or the placement request times out.

A game session placement request can also request player sessions. When a new game session is successfully created, Amazon GameLift creates a player session for each player included in the request.

When placing a game session, by default Amazon GameLift tries each fleet in the order they are listed in the queue configuration. Ideally, a queue's destinations are listed in preference order.

Alternatively, when requesting a game session with players, you can also provide latency data for each player in relevant regions. Latency data indicates the performance lag a player experiences when connected to a fleet in the region. Amazon GameLift uses latency data to reorder the list of destinations to place the game session in a region with minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each region's average lag for all players and reorders to get the best game play across all players.

To place a new game session request, specify the following:

  • The queue name and a set of game session properties and settings

  • A unique ID (such as a UUID) for the placement. You use this ID to track the status of the placement request

  • (Optional) A set of IDs and player data for each player you want to join to the new game session

  • Latency data for all players (if you want to optimize game play for the players)

If successful, a new game session placement is created.

To track the status of a placement request, call DescribeGameSessionPlacement and check the request's status. If the status is FULFILLED, a new game session has been created and a game session ARN and region are referenced. If the placement request times out, you can resubmit the request or retry it with a different queue.

Game-session-related operations include:

" - }, - "StartMatchBackfill":{ - "name":"StartMatchBackfill", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartMatchBackfillInput"}, - "output":{"shape":"StartMatchBackfillOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Finds new players to fill open slots in an existing game session. This operation can be used to add players to matched games that start with fewer than the maximum number of players or to replace players when they drop out. By backfilling with the same matchmaker used to create the original match, you ensure that new players meet the match criteria and maintain a consistent experience throughout the game session. You can backfill a match anytime after a game session has been created.

To request a match backfill, specify a unique ticket ID, the existing game session's ARN, a matchmaking configuration, and a set of data that describes all current players in the game session. If successful, a match backfill ticket is created and returned with status set to QUEUED. The ticket is placed in the matchmaker's ticket pool and processed. Track the status of the ticket to respond as needed. For more detail how to set up backfilling, see Backfill Existing Games with FlexMatch.

The process of finding backfill matches is essentially identical to the initial matchmaking process. The matchmaker searches the pool and groups tickets together to form potential matches, allowing only one backfill ticket per potential match. Once the a match is formed, the matchmaker creates player sessions for the new players. All tickets in the match are updated with the game session's connection information, and the GameSession object is updated to include matchmaker data on the new players. For more detail on how match backfill requests are processed, see How Amazon GameLift FlexMatch Works.

Matchmaking-related operations include:

" - }, - "StartMatchmaking":{ - "name":"StartMatchmaking", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartMatchmakingInput"}, - "output":{"shape":"StartMatchmakingOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Uses FlexMatch to create a game match for a group of players based on custom matchmaking rules, and starts a new game for the matched players. Each matchmaking request specifies the type of match to build (team configuration, rules for an acceptable match, etc.). The request also specifies the players to find a match for and where to host the new game session for optimal performance. A matchmaking request might start with a single player or a group of players who want to play together. FlexMatch finds additional players as needed to fill the match. Match type, rules, and the queue used to place a new game session are defined in a MatchmakingConfiguration. For complete information on setting up and using FlexMatch, see the topic Adding FlexMatch to Your Game.

To start matchmaking, provide a unique ticket ID, specify a matchmaking configuration, and include the players to be matched. You must also include a set of player attributes relevant for the matchmaking configuration. If successful, a matchmaking ticket is returned with status set to QUEUED. Track the status of the ticket to respond as needed and acquire game session connection information for successfully completed matches.

Tracking ticket status -- A couple of options are available for tracking the status of matchmaking requests:

  • Polling -- Call DescribeMatchmaking. This operation returns the full ticket object, including current status and (for completed tickets) game session connection info. We recommend polling no more than once every 10 seconds.

  • Notifications -- Get event notifications for changes in ticket status using Amazon Simple Notification Service (SNS). Notifications are easy to set up (see CreateMatchmakingConfiguration) and typically deliver match status changes faster and more efficiently than polling. We recommend that you use polling to back up to notifications (since delivery is not guaranteed) and call DescribeMatchmaking only when notifications are not received within 30 seconds.

Processing a matchmaking request -- FlexMatch handles a matchmaking request as follows:

  1. Your client code submits a StartMatchmaking request for one or more players and tracks the status of the request ticket.

  2. FlexMatch uses this ticket and others in process to build an acceptable match. When a potential match is identified, all tickets in the proposed match are advanced to the next status.

  3. If the match requires player acceptance (set in the matchmaking configuration), the tickets move into status REQUIRES_ACCEPTANCE. This status triggers your client code to solicit acceptance from all players in every ticket involved in the match, and then call AcceptMatch for each player. If any player rejects or fails to accept the match before a specified timeout, the proposed match is dropped (see AcceptMatch for more details).

  4. Once a match is proposed and accepted, the matchmaking tickets move into status PLACING. FlexMatch locates resources for a new game session using the game session queue (set in the matchmaking configuration) and creates the game session based on the match data.

  5. When the match is successfully placed, the matchmaking tickets move into COMPLETED status. Connection information (including game session endpoint and player session) is added to the matchmaking tickets. Matched players can use the connection information to join the game.

Matchmaking-related operations include:

" - }, - "StopFleetActions":{ - "name":"StopFleetActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopFleetActionsInput"}, - "output":{"shape":"StopFleetActionsOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Suspends activity on a fleet. Currently, this operation is used to stop a fleet's auto-scaling activity. It is used to temporarily stop scaling events triggered by the fleet's scaling policies. The policies can be retained and auto-scaling activity can be restarted using StartFleetActions. You can view a fleet's stopped actions using DescribeFleetAttributes.

To stop fleet actions, specify the fleet ID and the type of actions to suspend. When auto-scaling fleet actions are stopped, Amazon GameLift no longer initiates scaling events except to maintain the fleet's desired instances setting (FleetCapacity. Changes to the fleet's capacity must be done manually using UpdateFleetCapacity.

" - }, - "StopGameSessionPlacement":{ - "name":"StopGameSessionPlacement", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopGameSessionPlacementInput"}, - "output":{"shape":"StopGameSessionPlacementOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Cancels a game session placement that is in PENDING status. To stop a placement, provide the placement ID values. If successful, the placement is moved to CANCELLED status.

Game-session-related operations include:

" - }, - "StopMatchmaking":{ - "name":"StopMatchmaking", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopMatchmakingInput"}, - "output":{"shape":"StopMatchmakingOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Cancels a matchmaking ticket that is currently being processed. To stop the matchmaking operation, specify the ticket ID. If successful, work on the ticket is stopped, and the ticket status is changed to CANCELLED.

Matchmaking-related operations include:

" - }, - "UpdateAlias":{ - "name":"UpdateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAliasInput"}, - "output":{"shape":"UpdateAliasOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Updates properties for an alias. To update properties, specify the alias ID to be updated and provide the information to be changed. To reassign an alias to another fleet, provide an updated routing strategy. If successful, the updated alias record is returned.

Alias-related operations include:

" - }, - "UpdateBuild":{ - "name":"UpdateBuild", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateBuildInput"}, - "output":{"shape":"UpdateBuildOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Updates metadata in a build record, including the build name and version. To update the metadata, specify the build ID to update and provide the new values. If successful, a build object containing the updated metadata is returned.

Build-related operations include:

" - }, - "UpdateFleetAttributes":{ - "name":"UpdateFleetAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateFleetAttributesInput"}, - "output":{"shape":"UpdateFleetAttributesOutput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"InvalidFleetStatusException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Updates fleet properties, including name and description, for a fleet. To update metadata, specify the fleet ID and the property values that you want to change. If successful, the fleet ID for the updated fleet is returned.

Fleet-related operations include:

" - }, - "UpdateFleetCapacity":{ - "name":"UpdateFleetCapacity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateFleetCapacityInput"}, - "output":{"shape":"UpdateFleetCapacityOutput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidFleetStatusException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Updates capacity settings for a fleet. Use this action to specify the number of EC2 instances (hosts) that you want this fleet to contain. Before calling this action, you may want to call DescribeEC2InstanceLimits to get the maximum capacity based on the fleet's EC2 instance type.

Specify minimum and maximum number of instances. Amazon GameLift will not change fleet capacity to values fall outside of this range. This is particularly important when using auto-scaling (see PutScalingPolicy) to allow capacity to adjust based on player demand while imposing limits on automatic adjustments.

To update fleet capacity, specify the fleet ID and the number of instances you want the fleet to host. If successful, Amazon GameLift starts or terminates instances so that the fleet's active instance count matches the desired instance count. You can view a fleet's current capacity information by calling DescribeFleetCapacity. If the desired instance count is higher than the instance type's limit, the \"Limit Exceeded\" exception occurs.

Fleet-related operations include:

" - }, - "UpdateFleetPortSettings":{ - "name":"UpdateFleetPortSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateFleetPortSettingsInput"}, - "output":{"shape":"UpdateFleetPortSettingsOutput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"InvalidFleetStatusException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Updates port settings for a fleet. To update settings, specify the fleet ID to be updated and list the permissions you want to update. List the permissions you want to add in InboundPermissionAuthorizations, and permissions you want to remove in InboundPermissionRevocations. Permissions to be removed must match existing fleet permissions. If successful, the fleet ID for the updated fleet is returned.

Fleet-related operations include:

" - }, - "UpdateGameSession":{ - "name":"UpdateGameSession", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGameSessionInput"}, - "output":{"shape":"UpdateGameSessionOutput"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InvalidGameSessionStatusException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Updates game session properties. This includes the session name, maximum player count, protection policy, which controls whether or not an active game session can be terminated during a scale-down event, and the player session creation policy, which controls whether or not new players can join the session. To update a game session, specify the game session ID and the values you want to change. If successful, an updated GameSession object is returned.

Game-session-related operations include:

" - }, - "UpdateGameSessionQueue":{ - "name":"UpdateGameSessionQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGameSessionQueueInput"}, - "output":{"shape":"UpdateGameSessionQueueOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Updates settings for a game session queue, which determines how new game session requests in the queue are processed. To update settings, specify the queue name to be updated and provide the new settings. When updating destinations, provide a complete list of destinations.

Queue-related operations include:

" - }, - "UpdateMatchmakingConfiguration":{ - "name":"UpdateMatchmakingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMatchmakingConfigurationInput"}, - "output":{"shape":"UpdateMatchmakingConfigurationOutput"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"} - ], - "documentation":"

Updates settings for a FlexMatch matchmaking configuration. To update settings, specify the configuration name to be updated and provide the new settings.

Operations related to match configurations and rule sets include:

" - }, - "UpdateRuntimeConfiguration":{ - "name":"UpdateRuntimeConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRuntimeConfigurationInput"}, - "output":{"shape":"UpdateRuntimeConfigurationOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InvalidFleetStatusException"} - ], - "documentation":"

Updates the current run-time configuration for the specified fleet, which tells Amazon GameLift how to launch server processes on instances in the fleet. You can update a fleet's run-time configuration at any time after the fleet is created; it does not need to be in an ACTIVE status.

To update run-time configuration, specify the fleet ID and provide a RuntimeConfiguration object with the updated collection of server process configurations.

Each instance in a Amazon GameLift fleet checks regularly for an updated run-time configuration and changes how it launches server processes to comply with the latest version. Existing server processes are not affected by the update; they continue to run until they end, while Amazon GameLift simply adds new server processes to fit the current run-time configuration. As a result, the run-time configuration changes are applied gradually as existing processes shut down and new processes are launched in Amazon GameLift's normal process recycling activity.

Fleet-related operations include:

" - }, - "ValidateMatchmakingRuleSet":{ - "name":"ValidateMatchmakingRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ValidateMatchmakingRuleSetInput"}, - "output":{"shape":"ValidateMatchmakingRuleSetOutput"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"UnsupportedRegionException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Validates the syntax of a matchmaking rule or rule set. This operation checks that the rule set uses syntactically correct JSON and that it conforms to allowed property expressions. To validate syntax, provide a rule set string.

Operations related to match configurations and rule sets include:

" - } - }, - "shapes":{ - "AcceptMatchInput":{ - "type":"structure", - "required":[ - "TicketId", - "PlayerIds", - "AcceptanceType" - ], - "members":{ - "TicketId":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking ticket. The ticket must be in status REQUIRES_ACCEPTANCE; otherwise this request will fail.

" - }, - "PlayerIds":{ - "shape":"StringList", - "documentation":"

Unique identifier for a player delivering the response. This parameter can include one or multiple player IDs.

" - }, - "AcceptanceType":{ - "shape":"AcceptanceType", - "documentation":"

Player response to the proposed match.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "AcceptMatchOutput":{ - "type":"structure", - "members":{ - } - }, - "AcceptanceType":{ - "type":"string", - "enum":[ - "ACCEPT", - "REJECT" - ] - }, - "Alias":{ - "type":"structure", - "members":{ - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for an alias; alias IDs are unique within a region.

" - }, - "Name":{ - "shape":"NonBlankAndLengthConstraintString", - "documentation":"

Descriptive label that is associated with an alias. Alias names do not need to be unique.

" - }, - "AliasArn":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for an alias; alias ARNs are unique across all regions.

" - }, - "Description":{ - "shape":"FreeText", - "documentation":"

Human-readable description of an alias.

" - }, - "RoutingStrategy":{ - "shape":"RoutingStrategy", - "documentation":"

Alias configuration for the alias, including routing type and settings.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "LastUpdatedTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was last modified. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - } - }, - "documentation":"

Properties describing a fleet alias.

Alias-related operations include:

" - }, - "AliasId":{ - "type":"string", - "pattern":"^alias-\\S+" - }, - "AliasList":{ - "type":"list", - "member":{"shape":"Alias"} - }, - "ArnStringModel":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9:/-]+" - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "S":{ - "shape":"NonZeroAndMaxString", - "documentation":"

For single string values. Maximum string length is 100 characters.

" - }, - "N":{ - "shape":"DoubleObject", - "documentation":"

For number values, expressed as double.

" - }, - "SL":{ - "shape":"StringList", - "documentation":"

For a list of up to 10 strings. Maximum length for each string is 100 characters. Duplicate values are not recognized; all occurrences of the repeated value after the first of a repeated value are ignored.

" - }, - "SDM":{ - "shape":"StringDoubleMap", - "documentation":"

For a map of up to 10 data type:value pairs. Maximum length for each string value is 100 characters.

" - } - }, - "documentation":"

Values for use in Player attribute key:value pairs. This object lets you specify an attribute value using any of the valid data types: string, number, string array or data map. Each AttributeValue object can use only one of the available properties.

" - }, - "AwsCredentials":{ - "type":"structure", - "members":{ - "AccessKeyId":{ - "shape":"NonEmptyString", - "documentation":"

Temporary key allowing access to the Amazon GameLift S3 account.

" - }, - "SecretAccessKey":{ - "shape":"NonEmptyString", - "documentation":"

Temporary secret key allowing access to the Amazon GameLift S3 account.

" - }, - "SessionToken":{ - "shape":"NonEmptyString", - "documentation":"

Token used to associate a specific build ID with the files uploaded using these credentials.

" - } - }, - "documentation":"

Temporary access credentials used for uploading game build files to Amazon GameLift. They are valid for a limited time. If they expire before you upload your game build, get a new set by calling RequestUploadCredentials.

", - "sensitive":true - }, - "BooleanModel":{"type":"boolean"}, - "Build":{ - "type":"structure", - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build.

" - }, - "Name":{ - "shape":"FreeText", - "documentation":"

Descriptive label that is associated with a build. Build names do not need to be unique. It can be set using CreateBuild or UpdateBuild.

" - }, - "Version":{ - "shape":"FreeText", - "documentation":"

Version that is associated with this build. Version strings do not need to be unique. This value can be set using CreateBuild or UpdateBuild.

" - }, - "Status":{ - "shape":"BuildStatus", - "documentation":"

Current status of the build.

Possible build statuses include the following:

  • INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.

  • READY -- The game build has been successfully uploaded. You can now create new fleets for this build.

  • FAILED -- The game build upload failed. You cannot create new fleets for this build.

" - }, - "SizeOnDisk":{ - "shape":"PositiveLong", - "documentation":"

File size of the uploaded game build, expressed in bytes. When the build status is INITIALIZED, this value is 0.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - } - }, - "documentation":"

Properties describing a game build.

Build-related operations include:

" - }, - "BuildId":{ - "type":"string", - "pattern":"^build-\\S+" - }, - "BuildList":{ - "type":"list", - "member":{"shape":"Build"} - }, - "BuildStatus":{ - "type":"string", - "enum":[ - "INITIALIZED", - "READY", - "FAILED" - ] - }, - "ComparisonOperatorType":{ - "type":"string", - "enum":[ - "GreaterThanOrEqualToThreshold", - "GreaterThanThreshold", - "LessThanThreshold", - "LessThanOrEqualToThreshold" - ] - }, - "ConflictException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.

", - "exception":true - }, - "CreateAliasInput":{ - "type":"structure", - "required":[ - "Name", - "RoutingStrategy" - ], - "members":{ - "Name":{ - "shape":"NonBlankAndLengthConstraintString", - "documentation":"

Descriptive label that is associated with an alias. Alias names do not need to be unique.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Human-readable description of an alias.

" - }, - "RoutingStrategy":{ - "shape":"RoutingStrategy", - "documentation":"

Object that specifies the fleet and routing type to use for the alias.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateAliasOutput":{ - "type":"structure", - "members":{ - "Alias":{ - "shape":"Alias", - "documentation":"

Object that describes the newly created alias record.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateBuildInput":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a build. Build names do not need to be unique. You can use UpdateBuild to change this value later.

" - }, - "Version":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Version that is associated with this build. Version strings do not need to be unique. You can use UpdateBuild to change this value later.

" - }, - "StorageLocation":{ - "shape":"S3Location", - "documentation":"

Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key, as well as a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket must be in the same region that you want to create a new build in.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateBuildOutput":{ - "type":"structure", - "members":{ - "Build":{ - "shape":"Build", - "documentation":"

The newly created build record, including a unique build ID and status.

" - }, - "UploadCredentials":{ - "shape":"AwsCredentials", - "documentation":"

This element is returned only when the operation is called without a storage location. It contains credentials to use when you are uploading a build file to an Amazon S3 bucket that is owned by Amazon GameLift. Credentials have a limited life span. To refresh these credentials, call RequestUploadCredentials.

" - }, - "StorageLocation":{ - "shape":"S3Location", - "documentation":"

Amazon S3 location for your game build file, including bucket name and key.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateFleetInput":{ - "type":"structure", - "required":[ - "Name", - "BuildId", - "EC2InstanceType" - ], - "members":{ - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a fleet. Fleet names do not need to be unique.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Human-readable description of a fleet.

" - }, - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to be deployed on the new fleet. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.

" - }, - "ServerLaunchPath":{ - "shape":"NonZeroAndMaxString", - "documentation":"

This parameter is no longer used. Instead, specify a server launch path using the RuntimeConfiguration parameter. (Requests that specify a server launch path and launch parameters instead of a run-time configuration will continue to work.)

" - }, - "ServerLaunchParameters":{ - "shape":"NonZeroAndMaxString", - "documentation":"

This parameter is no longer used. Instead, specify server launch parameters in the RuntimeConfiguration parameter. (Requests that specify a server launch path and launch parameters instead of a run-time configuration will continue to work.)

" - }, - "LogPaths":{ - "shape":"StringList", - "documentation":"

This parameter is no longer used. Instead, to specify where Amazon GameLift should store log files once a server process shuts down, use the Amazon GameLift server API ProcessReady() and specify one or more directory paths in logParameters. See more information in the Server API Reference.

" - }, - "EC2InstanceType":{ - "shape":"EC2InstanceType", - "documentation":"

Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. Amazon GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.

" - }, - "EC2InboundPermissions":{ - "shape":"IpPermissionsList", - "documentation":"

Range of IP addresses and port settings that permit inbound traffic to access server processes running on the fleet. If no inbound permissions are set, including both IP address range and port range, the server processes in the fleet cannot accept connections. You can specify one or more sets of permissions for a fleet.

" - }, - "NewGameSessionProtectionPolicy":{ - "shape":"ProtectionPolicy", - "documentation":"

Game session protection policy to apply to all instances in this fleet. If this parameter is not set, instances in this fleet default to no protection. You can change a fleet's protection policy using UpdateFleetAttributes, but this change will only affect sessions created after the policy change. You can also set protection for individual instances using UpdateGameSession.

  • NoProtection -- The game session can be terminated during a scale-down event.

  • FullProtection -- If the game session is in an ACTIVE status, it cannot be terminated during a scale-down event.

" - }, - "RuntimeConfiguration":{ - "shape":"RuntimeConfiguration", - "documentation":"

Instructions for launching server processes on each instance in the fleet. The run-time configuration for a fleet has a collection of server process configurations, one for each type of server process to run on an instance. A server process configuration specifies the location of the server executable, launch parameters, and the number of concurrent processes with that configuration to maintain on each instance. A CreateFleet request must include a run-time configuration with at least one server process configuration; otherwise the request fails with an invalid request exception. (This parameter replaces the parameters ServerLaunchPath and ServerLaunchParameters; requests that contain values for these parameters instead of a run-time configuration will continue to work.)

" - }, - "ResourceCreationLimitPolicy":{ - "shape":"ResourceCreationLimitPolicy", - "documentation":"

Policy that limits the number of game sessions an individual player can create over a span of time for this fleet.

" - }, - "MetricGroups":{ - "shape":"MetricGroupList", - "documentation":"

Name of a metric group to add this fleet to. A metric group tracks metrics across all fleets in the group. Use an existing metric group name to add this fleet to the group, or use a new name to create a new metric group. A fleet can only be included in one metric group at a time.

" - }, - "PeerVpcAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the AWS account with the VPC that you want to peer your Amazon GameLift fleet with. You can find your Account ID in the AWS Management Console under account settings.

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - }, - "FleetType":{ - "shape":"FleetType", - "documentation":"

Indicates whether to use on-demand instances or spot instances for this fleet. If empty, the default is ON_DEMAND. Both categories of instances use identical hardware and configurations, based on the instance type selected for this fleet. You can acquire on-demand instances at any time for a fixed price and keep them as long as you need them. Spot instances have lower prices, but spot pricing is variable, and while in use they can be interrupted (with a two-minute notification). Learn more about Amazon GameLift spot instances with at Choose Computing Resources.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateFleetOutput":{ - "type":"structure", - "members":{ - "FleetAttributes":{ - "shape":"FleetAttributes", - "documentation":"

Properties for the newly created fleet.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateGameSessionInput":{ - "type":"structure", - "required":["MaximumPlayerSessionCount"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to create a game session in. Each request must reference either a fleet ID or alias ID, but not both.

" - }, - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for an alias associated with the fleet to create a game session in. Each request must reference either a fleet ID or alias ID, but not both.

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of players that can be connected simultaneously to the game session.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a game session. Session names do not need to be unique.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - }, - "CreatorId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player or entity creating the game session. This ID is used to enforce a resource protection policy (if one exists) that limits the number of concurrent active game sessions one player can have.

" - }, - "GameSessionId":{ - "shape":"IdStringModel", - "documentation":"

This parameter is no longer preferred. Please use IdempotencyToken instead. Custom string that uniquely identifies a request for a new game session. Maximum token length is 48 characters. If provided, this string is included in the new game session's ID. (A game session ARN has the following format: arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.)

" - }, - "IdempotencyToken":{ - "shape":"IdStringModel", - "documentation":"

Custom string that uniquely identifies a request for a new game session. Maximum token length is 48 characters. If provided, this string is included in the new game session's ID. (A game session ARN has the following format: arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.) Idempotency tokens remain in use for 30 days after a game session has ended; game session objects are retained for this time period and then deleted.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateGameSessionOutput":{ - "type":"structure", - "members":{ - "GameSession":{ - "shape":"GameSession", - "documentation":"

Object that describes the newly created game session record.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateGameSessionQueueInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"GameSessionQueueName", - "documentation":"

Descriptive label that is associated with game session queue. Queue names must be unique within each region.

" - }, - "TimeoutInSeconds":{ - "shape":"WholeNumber", - "documentation":"

Maximum time, in seconds, that a new game session placement request remains in the queue. When a request exceeds this time, the game session placement changes to a TIMED_OUT status.

" - }, - "PlayerLatencyPolicies":{ - "shape":"PlayerLatencyPolicyList", - "documentation":"

Collection of latency policies to apply when processing game sessions placement requests with player latency information. Multiple policies are evaluated in order of the maximum latency value, starting with the lowest latency values. With just one policy, it is enforced at the start of the game session placement for the duration period. With multiple policies, each policy is enforced consecutively for its duration period. For example, a queue might enforce a 60-second policy followed by a 120-second policy, and then no policy for the remainder of the placement. A player latency policy must set a value for MaximumIndividualPlayerLatencyMilliseconds; if none is set, this API requests will fail.

" - }, - "Destinations":{ - "shape":"GameSessionQueueDestinationList", - "documentation":"

List of fleets that can be used to fulfill game session placement requests in the queue. Fleets are identified by either a fleet ARN or a fleet alias ARN. Destinations are listed in default preference order.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateGameSessionQueueOutput":{ - "type":"structure", - "members":{ - "GameSessionQueue":{ - "shape":"GameSessionQueue", - "documentation":"

Object that describes the newly created game session queue.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateMatchmakingConfigurationInput":{ - "type":"structure", - "required":[ - "Name", - "GameSessionQueueArns", - "RequestTimeoutSeconds", - "AcceptanceRequired", - "RuleSetName" - ], - "members":{ - "Name":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking configuration. This name is used to identify the configuration associated with a matchmaking request or ticket.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Meaningful description of the matchmaking configuration.

" - }, - "GameSessionQueueArns":{ - "shape":"QueueArnsList", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session queue and uniquely identifies it. Format is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. These queues are used when placing game sessions for matches that are created with this matchmaking configuration. Queues can be located in any region.

" - }, - "RequestTimeoutSeconds":{ - "shape":"MatchmakingRequestTimeoutInteger", - "documentation":"

Maximum duration, in seconds, that a matchmaking ticket can remain in process before timing out. Requests that time out can be resubmitted as needed.

" - }, - "AcceptanceTimeoutSeconds":{ - "shape":"MatchmakingAcceptanceTimeoutInteger", - "documentation":"

Length of time (in seconds) to wait for players to accept a proposed match. If any player rejects the match or fails to accept before the timeout, the ticket continues to look for an acceptable match.

" - }, - "AcceptanceRequired":{ - "shape":"BooleanModel", - "documentation":"

Flag that determines whether or not a match that was created with this configuration must be accepted by the matched players. To require acceptance, set to TRUE.

" - }, - "RuleSetName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set to use with this configuration. A matchmaking configuration can only use rule sets that are defined in the same region.

" - }, - "NotificationTarget":{ - "shape":"SnsArnStringModel", - "documentation":"

SNS topic ARN that is set up to receive matchmaking notifications.

" - }, - "AdditionalPlayerCount":{ - "shape":"WholeNumber", - "documentation":"

Number of player slots in a match to keep open for future players. For example, if the configuration's rule set specifies a match for a single 12-person team, and the additional player count is set to 2, only 10 players are selected for the match.

" - }, - "CustomEventData":{ - "shape":"CustomEventData", - "documentation":"

Information to attached to all events related to the matchmaking configuration.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateMatchmakingConfigurationOutput":{ - "type":"structure", - "members":{ - "Configuration":{ - "shape":"MatchmakingConfiguration", - "documentation":"

Object that describes the newly created matchmaking configuration.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateMatchmakingRuleSetInput":{ - "type":"structure", - "required":[ - "Name", - "RuleSetBody" - ], - "members":{ - "Name":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set. This name is used to identify the rule set associated with a matchmaking configuration.

" - }, - "RuleSetBody":{ - "shape":"RuleSetBody", - "documentation":"

Collection of matchmaking rules, formatted as a JSON string. (Note that comments are not allowed in JSON, but most elements support a description field.)

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateMatchmakingRuleSetOutput":{ - "type":"structure", - "required":["RuleSet"], - "members":{ - "RuleSet":{ - "shape":"MatchmakingRuleSet", - "documentation":"

Object that describes the newly created matchmaking rule set.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreatePlayerSessionInput":{ - "type":"structure", - "required":[ - "GameSessionId", - "PlayerId" - ], - "members":{ - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to add a player to.

" - }, - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player. Player IDs are developer-defined.

" - }, - "PlayerData":{ - "shape":"PlayerData", - "documentation":"

Developer-defined information related to a player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreatePlayerSessionOutput":{ - "type":"structure", - "members":{ - "PlayerSession":{ - "shape":"PlayerSession", - "documentation":"

Object that describes the newly created player session record.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreatePlayerSessionsInput":{ - "type":"structure", - "required":[ - "GameSessionId", - "PlayerIds" - ], - "members":{ - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to add players to.

" - }, - "PlayerIds":{ - "shape":"PlayerIdList", - "documentation":"

List of unique identifiers for the players to be added.

" - }, - "PlayerDataMap":{ - "shape":"PlayerDataMap", - "documentation":"

Map of string pairs, each specifying a player ID and a set of developer-defined information related to the player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game. Player data strings for player IDs not included in the PlayerIds parameter are ignored.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreatePlayerSessionsOutput":{ - "type":"structure", - "members":{ - "PlayerSessions":{ - "shape":"PlayerSessionList", - "documentation":"

Collection of player session objects created for the added players.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateVpcPeeringAuthorizationInput":{ - "type":"structure", - "required":[ - "GameLiftAwsAccountId", - "PeerVpcId" - ], - "members":{ - "GameLiftAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the AWS account that you use to manage your Amazon GameLift fleet. You can find your Account ID in the AWS Management Console under account settings.

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateVpcPeeringAuthorizationOutput":{ - "type":"structure", - "members":{ - "VpcPeeringAuthorization":{ - "shape":"VpcPeeringAuthorization", - "documentation":"

Details on the requested VPC peering authorization, including expiration.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "CreateVpcPeeringConnectionInput":{ - "type":"structure", - "required":[ - "FleetId", - "PeerVpcAwsAccountId", - "PeerVpcId" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet. This tells Amazon GameLift which GameLift VPC to peer with.

" - }, - "PeerVpcAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the AWS account with the VPC that you want to peer your Amazon GameLift fleet with. You can find your Account ID in the AWS Management Console under account settings.

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "CreateVpcPeeringConnectionOutput":{ - "type":"structure", - "members":{ - } - }, - "CustomEventData":{ - "type":"string", - "max":256, - "min":0 - }, - "DeleteAliasInput":{ - "type":"structure", - "required":["AliasId"], - "members":{ - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for a fleet alias. Specify the alias you want to delete.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteBuildInput":{ - "type":"structure", - "required":["BuildId"], - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to delete.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteFleetInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to be deleted.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteGameSessionQueueInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"GameSessionQueueName", - "documentation":"

Descriptive label that is associated with game session queue. Queue names must be unique within each region.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteGameSessionQueueOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteMatchmakingConfigurationInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking configuration

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteMatchmakingConfigurationOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteScalingPolicyInput":{ - "type":"structure", - "required":[ - "Name", - "FleetId" - ], - "members":{ - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

" - }, - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to be deleted.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteVpcPeeringAuthorizationInput":{ - "type":"structure", - "required":[ - "GameLiftAwsAccountId", - "PeerVpcId" - ], - "members":{ - "GameLiftAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the AWS account that you use to manage your Amazon GameLift fleet. You can find your Account ID in the AWS Management Console under account settings.

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteVpcPeeringAuthorizationOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteVpcPeeringConnectionInput":{ - "type":"structure", - "required":[ - "FleetId", - "VpcPeeringConnectionId" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet. This value must match the fleet ID referenced in the VPC peering connection record.

" - }, - "VpcPeeringConnectionId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC peering connection. This value is included in the VpcPeeringConnection object, which can be retrieved by calling DescribeVpcPeeringConnections.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DeleteVpcPeeringConnectionOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeAliasInput":{ - "type":"structure", - "required":["AliasId"], - "members":{ - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for a fleet alias. Specify the alias you want to retrieve.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeAliasOutput":{ - "type":"structure", - "members":{ - "Alias":{ - "shape":"Alias", - "documentation":"

Object that contains the requested alias.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeBuildInput":{ - "type":"structure", - "required":["BuildId"], - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to retrieve properties for.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeBuildOutput":{ - "type":"structure", - "members":{ - "Build":{ - "shape":"Build", - "documentation":"

Set of properties describing the requested build.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeEC2InstanceLimitsInput":{ - "type":"structure", - "members":{ - "EC2InstanceType":{ - "shape":"EC2InstanceType", - "documentation":"

Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. Amazon GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions. Leave this parameter blank to retrieve limits for all types.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeEC2InstanceLimitsOutput":{ - "type":"structure", - "members":{ - "EC2InstanceLimits":{ - "shape":"EC2InstanceLimitList", - "documentation":"

Object that contains the maximum number of instances for the specified instance type.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeFleetAttributesInput":{ - "type":"structure", - "members":{ - "FleetIds":{ - "shape":"FleetIdList", - "documentation":"

Unique identifier for a fleet(s) to retrieve attributes for. To request attributes for all fleets, leave this parameter empty.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeFleetAttributesOutput":{ - "type":"structure", - "members":{ - "FleetAttributes":{ - "shape":"FleetAttributesList", - "documentation":"

Collection of objects containing attribute metadata for each requested fleet ID.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeFleetCapacityInput":{ - "type":"structure", - "members":{ - "FleetIds":{ - "shape":"FleetIdList", - "documentation":"

Unique identifier for a fleet(s) to retrieve capacity information for. To request capacity information for all fleets, leave this parameter empty.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeFleetCapacityOutput":{ - "type":"structure", - "members":{ - "FleetCapacity":{ - "shape":"FleetCapacityList", - "documentation":"

Collection of objects containing capacity information for each requested fleet ID. Leave this parameter empty to retrieve capacity information for all fleets.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeFleetEventsInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to get event logs for.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

Earliest date to retrieve event logs for. If no start time is specified, this call returns entries starting from when the fleet was created to the specified end time. Format is a number expressed in Unix time as milliseconds (ex: \"1469498468.057\").

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

Most recent date to retrieve event logs for. If no end time is specified, this call returns entries from the specified start time up to the present. Format is a number expressed in Unix time as milliseconds (ex: \"1469498468.057\").

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeFleetEventsOutput":{ - "type":"structure", - "members":{ - "Events":{ - "shape":"EventList", - "documentation":"

Collection of objects containing event log entries for the specified fleet.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeFleetPortSettingsInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to retrieve port settings for.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeFleetPortSettingsOutput":{ - "type":"structure", - "members":{ - "InboundPermissions":{ - "shape":"IpPermissionsList", - "documentation":"

Object that contains port settings for the requested fleet ID.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeFleetUtilizationInput":{ - "type":"structure", - "members":{ - "FleetIds":{ - "shape":"FleetIdList", - "documentation":"

Unique identifier for a fleet(s) to retrieve utilization data for. To request utilization data for all fleets, leave this parameter empty.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value. This parameter is ignored when the request specifies one or a list of fleet IDs.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeFleetUtilizationOutput":{ - "type":"structure", - "members":{ - "FleetUtilization":{ - "shape":"FleetUtilizationList", - "documentation":"

Collection of objects containing utilization information for each requested fleet ID.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeGameSessionDetailsInput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to retrieve all game sessions active on the fleet.

" - }, - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to retrieve.

" - }, - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for an alias associated with the fleet to retrieve all game sessions for.

" - }, - "StatusFilter":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Game session status to filter results on. Possible game session statuses include ACTIVE, TERMINATED, ACTIVATING and TERMINATING (the last two are transitory).

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeGameSessionDetailsOutput":{ - "type":"structure", - "members":{ - "GameSessionDetails":{ - "shape":"GameSessionDetailList", - "documentation":"

Collection of objects containing game session properties and the protection policy currently in force for each session matching the request.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeGameSessionPlacementInput":{ - "type":"structure", - "required":["PlacementId"], - "members":{ - "PlacementId":{ - "shape":"IdStringModel", - "documentation":"

Unique identifier for a game session placement to retrieve.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeGameSessionPlacementOutput":{ - "type":"structure", - "members":{ - "GameSessionPlacement":{ - "shape":"GameSessionPlacement", - "documentation":"

Object that describes the requested game session placement.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeGameSessionQueuesInput":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"GameSessionQueueNameList", - "documentation":"

List of queue names to retrieve information for. To request settings for all queues, leave this parameter empty.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeGameSessionQueuesOutput":{ - "type":"structure", - "members":{ - "GameSessionQueues":{ - "shape":"GameSessionQueueList", - "documentation":"

Collection of objects that describes the requested game session queues.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeGameSessionsInput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to retrieve all game sessions for.

" - }, - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to retrieve. You can use either a GameSessionId or GameSessionArn value.

" - }, - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for an alias associated with the fleet to retrieve all game sessions for.

" - }, - "StatusFilter":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Game session status to filter results on. Possible game session statuses include ACTIVE, TERMINATED, ACTIVATING, and TERMINATING (the last two are transitory).

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeGameSessionsOutput":{ - "type":"structure", - "members":{ - "GameSessions":{ - "shape":"GameSessionList", - "documentation":"

Collection of objects containing game session properties for each session matching the request.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeInstancesInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to retrieve instance information for.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

Unique identifier for an instance to retrieve. Specify an instance ID or leave blank to retrieve all instances in the fleet.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeInstancesOutput":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"InstanceList", - "documentation":"

Collection of objects containing properties for each instance returned.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeMatchmakingConfigurationsInput":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"MatchmakingIdList", - "documentation":"

Unique identifier for a matchmaking configuration(s) to retrieve. To request all existing configurations, leave this parameter empty.

" - }, - "RuleSetName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set. Use this parameter to retrieve all matchmaking configurations that use this rule set.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. This parameter is limited to 10.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeMatchmakingConfigurationsOutput":{ - "type":"structure", - "members":{ - "Configurations":{ - "shape":"MatchmakingConfigurationList", - "documentation":"

Collection of requested matchmaking configuration objects.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeMatchmakingInput":{ - "type":"structure", - "required":["TicketIds"], - "members":{ - "TicketIds":{ - "shape":"MatchmakingIdList", - "documentation":"

Unique identifier for a matchmaking ticket. You can include up to 10 ID values.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeMatchmakingOutput":{ - "type":"structure", - "members":{ - "TicketList":{ - "shape":"MatchmakingTicketList", - "documentation":"

Collection of existing matchmaking ticket objects matching the request.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeMatchmakingRuleSetsInput":{ - "type":"structure", - "members":{ - "Names":{ - "shape":"MatchmakingRuleSetNameList", - "documentation":"

Unique identifier for a matchmaking rule set. This name is used to identify the rule set associated with a matchmaking configuration.

" - }, - "Limit":{ - "shape":"RuleSetLimit", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeMatchmakingRuleSetsOutput":{ - "type":"structure", - "required":["RuleSets"], - "members":{ - "RuleSets":{ - "shape":"MatchmakingRuleSetList", - "documentation":"

Collection of requested matchmaking rule set objects.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribePlayerSessionsInput":{ - "type":"structure", - "members":{ - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to retrieve player sessions for.

" - }, - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player to retrieve player sessions for.

" - }, - "PlayerSessionId":{ - "shape":"PlayerSessionId", - "documentation":"

Unique identifier for a player session to retrieve.

" - }, - "PlayerSessionStatusFilter":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Player session status to filter results on.

Possible player session statuses include the following:

  • RESERVED -- The player session request has been received, but the player has not yet connected to the server process and/or been validated.

  • ACTIVE -- The player has been validated by the server process and is currently connected.

  • COMPLETED -- The player connection has been dropped.

  • TIMEDOUT -- A player session request was received, but the player did not connect and/or was not validated within the timeout limit (60 seconds).

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. If a player session ID is specified, this parameter is ignored.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value. If a player session ID is specified, this parameter is ignored.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribePlayerSessionsOutput":{ - "type":"structure", - "members":{ - "PlayerSessions":{ - "shape":"PlayerSessionList", - "documentation":"

Collection of objects containing properties for each player session that matches the request.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeRuntimeConfigurationInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to get the run-time configuration for.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeRuntimeConfigurationOutput":{ - "type":"structure", - "members":{ - "RuntimeConfiguration":{ - "shape":"RuntimeConfiguration", - "documentation":"

Instructions describing how server processes should be launched and maintained on each instance in the fleet.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeScalingPoliciesInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to retrieve scaling policies for.

" - }, - "StatusFilter":{ - "shape":"ScalingStatusType", - "documentation":"

Scaling policy status to filter results on. A scaling policy is only in force when in an ACTIVE status.

  • ACTIVE -- The scaling policy is currently in force.

  • UPDATEREQUESTED -- A request to update the scaling policy has been received.

  • UPDATING -- A change is being made to the scaling policy.

  • DELETEREQUESTED -- A request to delete the scaling policy has been received.

  • DELETING -- The scaling policy is being deleted.

  • DELETED -- The scaling policy has been deleted.

  • ERROR -- An error occurred in creating the policy. It should be removed and recreated.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeScalingPoliciesOutput":{ - "type":"structure", - "members":{ - "ScalingPolicies":{ - "shape":"ScalingPolicyList", - "documentation":"

Collection of objects containing the scaling policies matching the request.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DescribeVpcPeeringAuthorizationsInput":{ - "type":"structure", - "members":{ - } - }, - "DescribeVpcPeeringAuthorizationsOutput":{ - "type":"structure", - "members":{ - "VpcPeeringAuthorizations":{ - "shape":"VpcPeeringAuthorizationList", - "documentation":"

Collection of objects that describe all valid VPC peering operations for the current AWS account.

" - } - } - }, - "DescribeVpcPeeringConnectionsInput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "DescribeVpcPeeringConnectionsOutput":{ - "type":"structure", - "members":{ - "VpcPeeringConnections":{ - "shape":"VpcPeeringConnectionList", - "documentation":"

Collection of VPC peering connection records that match the request.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "DesiredPlayerSession":{ - "type":"structure", - "members":{ - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player to associate with the player session.

" - }, - "PlayerData":{ - "shape":"PlayerData", - "documentation":"

Developer-defined information related to a player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game.

" - } - }, - "documentation":"

Player information for use when creating player sessions using a game session placement request with StartGameSessionPlacement.

" - }, - "DesiredPlayerSessionList":{ - "type":"list", - "member":{"shape":"DesiredPlayerSession"} - }, - "Double":{"type":"double"}, - "DoubleObject":{"type":"double"}, - "EC2InstanceCounts":{ - "type":"structure", - "members":{ - "DESIRED":{ - "shape":"WholeNumber", - "documentation":"

Ideal number of active instances in the fleet.

" - }, - "MINIMUM":{ - "shape":"WholeNumber", - "documentation":"

Minimum value allowed for the fleet's instance count.

" - }, - "MAXIMUM":{ - "shape":"WholeNumber", - "documentation":"

Maximum value allowed for the fleet's instance count.

" - }, - "PENDING":{ - "shape":"WholeNumber", - "documentation":"

Number of instances in the fleet that are starting but not yet active.

" - }, - "ACTIVE":{ - "shape":"WholeNumber", - "documentation":"

Actual number of active instances in the fleet.

" - }, - "IDLE":{ - "shape":"WholeNumber", - "documentation":"

Number of active instances in the fleet that are not currently hosting a game session.

" - }, - "TERMINATING":{ - "shape":"WholeNumber", - "documentation":"

Number of instances in the fleet that are no longer active but haven't yet been terminated.

" - } - }, - "documentation":"

Current status of fleet capacity. The number of active instances should match or be in the process of matching the number of desired instances. Pending and terminating counts are non-zero only if fleet capacity is adjusting to an UpdateFleetCapacity request, or if access to resources is temporarily affected.

Fleet-related operations include:

" - }, - "EC2InstanceLimit":{ - "type":"structure", - "members":{ - "EC2InstanceType":{ - "shape":"EC2InstanceType", - "documentation":"

Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. Amazon GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.

" - }, - "CurrentInstances":{ - "shape":"WholeNumber", - "documentation":"

Number of instances of the specified type that are currently in use by this AWS account.

" - }, - "InstanceLimit":{ - "shape":"WholeNumber", - "documentation":"

Number of instances allowed.

" - } - }, - "documentation":"

Maximum number of instances allowed based on the Amazon Elastic Compute Cloud (Amazon EC2) instance type. Instance limits can be retrieved by calling DescribeEC2InstanceLimits.

" - }, - "EC2InstanceLimitList":{ - "type":"list", - "member":{"shape":"EC2InstanceLimit"} - }, - "EC2InstanceType":{ - "type":"string", - "enum":[ - "t2.micro", - "t2.small", - "t2.medium", - "t2.large", - "c3.large", - "c3.xlarge", - "c3.2xlarge", - "c3.4xlarge", - "c3.8xlarge", - "c4.large", - "c4.xlarge", - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "r3.large", - "r3.xlarge", - "r3.2xlarge", - "r3.4xlarge", - "r3.8xlarge", - "r4.large", - "r4.xlarge", - "r4.2xlarge", - "r4.4xlarge", - "r4.8xlarge", - "r4.16xlarge", - "m3.medium", - "m3.large", - "m3.xlarge", - "m3.2xlarge", - "m4.large", - "m4.xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge" - ] - }, - "Event":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a fleet event.

" - }, - "ResourceId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for an event resource, such as a fleet ID.

" - }, - "EventCode":{ - "shape":"EventCode", - "documentation":"

Type of event being logged. The following events are currently in use:

Fleet creation events:

  • FLEET_CREATED -- A fleet record was successfully created with a status of NEW. Event messaging includes the fleet ID.

  • FLEET_STATE_DOWNLOADING -- Fleet status changed from NEW to DOWNLOADING. The compressed build has started downloading to a fleet instance for installation.

  • FLEET_BINARY_DOWNLOAD_FAILED -- The build failed to download to the fleet instance.

  • FLEET_CREATION_EXTRACTING_BUILD – The game server build was successfully downloaded to an instance, and the build files are now being extracted from the uploaded build and saved to an instance. Failure at this stage prevents a fleet from moving to ACTIVE status. Logs for this stage display a list of the files that are extracted and saved on the instance. Access the logs by using the URL in PreSignedLogUrl.

  • FLEET_CREATION_RUNNING_INSTALLER – The game server build files were successfully extracted, and the Amazon GameLift is now running the build's install script (if one is included). Failure in this stage prevents a fleet from moving to ACTIVE status. Logs for this stage list the installation steps and whether or not the install completed successfully. Access the logs by using the URL in PreSignedLogUrl.

  • FLEET_CREATION_VALIDATING_RUNTIME_CONFIG -- The build process was successful, and the Amazon GameLift is now verifying that the game server launch paths, which are specified in the fleet's run-time configuration, exist. If any listed launch path exists, Amazon GameLift tries to launch a game server process and waits for the process to report ready. Failures in this stage prevent a fleet from moving to ACTIVE status. Logs for this stage list the launch paths in the run-time configuration and indicate whether each is found. Access the logs by using the URL in PreSignedLogUrl.

  • FLEET_STATE_VALIDATING -- Fleet status changed from DOWNLOADING to VALIDATING.

  • FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND -- Validation of the run-time configuration failed because the executable specified in a launch path does not exist on the instance.

  • FLEET_STATE_BUILDING -- Fleet status changed from VALIDATING to BUILDING.

  • FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE -- Validation of the run-time configuration failed because the executable specified in a launch path failed to run on the fleet instance.

  • FLEET_STATE_ACTIVATING -- Fleet status changed from BUILDING to ACTIVATING.

  • FLEET_ACTIVATION_FAILED - The fleet failed to successfully complete one of the steps in the fleet activation process. This event code indicates that the game build was successfully downloaded to a fleet instance, built, and validated, but was not able to start a server process. A possible reason for failure is that the game server is not reporting \"process ready\" to the Amazon GameLift service.

  • FLEET_STATE_ACTIVE -- The fleet's status changed from ACTIVATING to ACTIVE. The fleet is now ready to host game sessions.

VPC peering events:

  • FLEET_VPC_PEERING_SUCCEEDED -- A VPC peering connection has been established between the VPC for an Amazon GameLift fleet and a VPC in your AWS account.

  • FLEET_VPC_PEERING_FAILED -- A requested VPC peering connection has failed. Event details and status information (see DescribeVpcPeeringConnections) provide additional detail. A common reason for peering failure is that the two VPCs have overlapping CIDR blocks of IPv4 addresses. To resolve this, change the CIDR block for the VPC in your AWS account. For more information on VPC peering failures, see http://docs.aws.amazon.com/AmazonVPC/latest/PeeringGuide/invalid-peering-configurations.html

  • FLEET_VPC_PEERING_DELETED -- A VPC peering connection has been successfully deleted.

Spot instance events:

  • INSTANCE_INTERRUPTED -- A spot instance was interrupted by EC2 with a two-minute notification.

Other fleet events:

  • FLEET_SCALING_EVENT -- A change was made to the fleet's capacity settings (desired instances, minimum/maximum scaling limits). Event messaging includes the new capacity settings.

  • FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED -- A change was made to the fleet's game session protection policy setting. Event messaging includes both the old and new policy setting.

  • FLEET_DELETED -- A request to delete a fleet was initiated.

  • GENERIC_EVENT -- An unspecified event has occurred.

" - }, - "Message":{ - "shape":"NonEmptyString", - "documentation":"

Additional information related to the event.

" - }, - "EventTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this event occurred. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "PreSignedLogUrl":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Location of stored logs with additional detail that is related to the event. This is useful for debugging issues. The URL is valid for 15 minutes. You can also access fleet creation logs through the Amazon GameLift console.

" - } - }, - "documentation":"

Log entry describing an event that involves Amazon GameLift resources (such as a fleet). In addition to tracking activity, event codes and messages can provide additional information for troubleshooting and debugging problems.

" - }, - "EventCode":{ - "type":"string", - "enum":[ - "GENERIC_EVENT", - "FLEET_CREATED", - "FLEET_DELETED", - "FLEET_SCALING_EVENT", - "FLEET_STATE_DOWNLOADING", - "FLEET_STATE_VALIDATING", - "FLEET_STATE_BUILDING", - "FLEET_STATE_ACTIVATING", - "FLEET_STATE_ACTIVE", - "FLEET_STATE_ERROR", - "FLEET_INITIALIZATION_FAILED", - "FLEET_BINARY_DOWNLOAD_FAILED", - "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND", - "FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE", - "FLEET_VALIDATION_TIMED_OUT", - "FLEET_ACTIVATION_FAILED", - "FLEET_ACTIVATION_FAILED_NO_INSTANCES", - "FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED", - "SERVER_PROCESS_INVALID_PATH", - "SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT", - "SERVER_PROCESS_PROCESS_READY_TIMEOUT", - "SERVER_PROCESS_CRASHED", - "SERVER_PROCESS_TERMINATED_UNHEALTHY", - "SERVER_PROCESS_FORCE_TERMINATED", - "SERVER_PROCESS_PROCESS_EXIT_TIMEOUT", - "GAME_SESSION_ACTIVATION_TIMEOUT", - "FLEET_CREATION_EXTRACTING_BUILD", - "FLEET_CREATION_RUNNING_INSTALLER", - "FLEET_CREATION_VALIDATING_RUNTIME_CONFIG", - "FLEET_VPC_PEERING_SUCCEEDED", - "FLEET_VPC_PEERING_FAILED", - "FLEET_VPC_PEERING_DELETED", - "INSTANCE_INTERRUPTED" - ] - }, - "EventList":{ - "type":"list", - "member":{"shape":"Event"} - }, - "FleetAction":{ - "type":"string", - "enum":["AUTO_SCALING"] - }, - "FleetActionList":{ - "type":"list", - "member":{"shape":"FleetAction"}, - "max":1, - "min":1 - }, - "FleetAttributes":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet.

" - }, - "FleetArn":{ - "shape":"ArnStringModel", - "documentation":"

Identifier for a fleet that is unique across all regions.

" - }, - "FleetType":{ - "shape":"FleetType", - "documentation":"

Indicates whether the fleet uses on-demand or spot instances. A spot instance in use may be interrupted with a two-minute notification.

" - }, - "InstanceType":{ - "shape":"EC2InstanceType", - "documentation":"

EC2 instance type indicating the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. See Amazon EC2 Instance Types for detailed descriptions.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Human-readable description of the fleet.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a fleet. Fleet names do not need to be unique.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "TerminationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "Status":{ - "shape":"FleetStatus", - "documentation":"

Current status of the fleet.

Possible fleet statuses include the following:

  • NEW -- A new fleet has been defined and desired instances is set to 1.

  • DOWNLOADING/VALIDATING/BUILDING/ACTIVATING -- Amazon GameLift is setting up the new fleet, creating new instances with the game build and starting server processes.

  • ACTIVE -- Hosts can now accept game sessions.

  • ERROR -- An error occurred when downloading, validating, building, or activating the fleet.

  • DELETING -- Hosts are responding to a delete fleet request.

  • TERMINATED -- The fleet no longer exists.

" - }, - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build.

" - }, - "ServerLaunchPath":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Path to a game server executable in the fleet's build, specified for fleets created before 2016-08-04 (or AWS SDK v. 0.12.16). Server launch paths for fleets created after this date are specified in the fleet's RuntimeConfiguration.

" - }, - "ServerLaunchParameters":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Game server launch parameters specified for fleets created before 2016-08-04 (or AWS SDK v. 0.12.16). Server launch parameters for fleets created after this date are specified in the fleet's RuntimeConfiguration.

" - }, - "LogPaths":{ - "shape":"StringList", - "documentation":"

Location of default log files. When a server process is shut down, Amazon GameLift captures and stores any log files in this location. These logs are in addition to game session logs; see more on game session logs in the Amazon GameLift Developer Guide. If no default log path for a fleet is specified, Amazon GameLift automatically uploads logs that are stored on each instance at C:\\game\\logs (for Windows) or /local/game/logs (for Linux). Use the Amazon GameLift console to access stored logs.

" - }, - "NewGameSessionProtectionPolicy":{ - "shape":"ProtectionPolicy", - "documentation":"

Type of game session protection to set for all new instances started in the fleet.

  • NoProtection -- The game session can be terminated during a scale-down event.

  • FullProtection -- If the game session is in an ACTIVE status, it cannot be terminated during a scale-down event.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Operating system of the fleet's computing resources. A fleet's operating system depends on the OS specified for the build that is deployed on this fleet.

" - }, - "ResourceCreationLimitPolicy":{ - "shape":"ResourceCreationLimitPolicy", - "documentation":"

Fleet policy to limit the number of game sessions an individual player can create over a span of time.

" - }, - "MetricGroups":{ - "shape":"MetricGroupList", - "documentation":"

Names of metric groups that this fleet is included in. In Amazon CloudWatch, you can view metrics for an individual fleet or aggregated metrics for fleets that are in a fleet metric group. A fleet can be included in only one metric group at a time.

" - }, - "StoppedActions":{ - "shape":"FleetActionList", - "documentation":"

List of fleet actions that have been suspended using StopFleetActions. This includes auto-scaling.

" - } - }, - "documentation":"

General properties describing a fleet.

Fleet-related operations include:

" - }, - "FleetAttributesList":{ - "type":"list", - "member":{"shape":"FleetAttributes"} - }, - "FleetCapacity":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet.

" - }, - "InstanceType":{ - "shape":"EC2InstanceType", - "documentation":"

Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. Amazon GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.

" - }, - "InstanceCounts":{ - "shape":"EC2InstanceCounts", - "documentation":"

Current status of fleet capacity.

" - } - }, - "documentation":"

Information about the fleet's capacity. Fleet capacity is measured in EC2 instances. By default, new fleets have a capacity of one instance, but can be updated as needed. The maximum number of instances for a fleet is determined by the fleet's instance type.

Fleet-related operations include:

" - }, - "FleetCapacityExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The specified fleet has no available instances to fulfill a CreateGameSession request. Clients can retry such requests immediately or after a waiting period.

", - "exception":true - }, - "FleetCapacityList":{ - "type":"list", - "member":{"shape":"FleetCapacity"} - }, - "FleetId":{ - "type":"string", - "pattern":"^fleet-\\S+" - }, - "FleetIdList":{ - "type":"list", - "member":{"shape":"FleetId"}, - "min":1 - }, - "FleetStatus":{ - "type":"string", - "enum":[ - "NEW", - "DOWNLOADING", - "VALIDATING", - "BUILDING", - "ACTIVATING", - "ACTIVE", - "DELETING", - "ERROR", - "TERMINATED" - ] - }, - "FleetType":{ - "type":"string", - "enum":[ - "ON_DEMAND", - "SPOT" - ] - }, - "FleetUtilization":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet.

" - }, - "ActiveServerProcessCount":{ - "shape":"WholeNumber", - "documentation":"

Number of server processes in an ACTIVE status currently running across all instances in the fleet

" - }, - "ActiveGameSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Number of active game sessions currently being hosted on all instances in the fleet.

" - }, - "CurrentPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Number of active player sessions currently being hosted on all instances in the fleet.

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum players allowed across all game sessions currently being hosted on all instances in the fleet.

" - } - }, - "documentation":"

Current status of fleet utilization, including the number of game and player sessions being hosted.

Fleet-related operations include:

" - }, - "FleetUtilizationList":{ - "type":"list", - "member":{"shape":"FleetUtilization"} - }, - "Float":{"type":"float"}, - "FreeText":{"type":"string"}, - "GameProperty":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"GamePropertyKey", - "documentation":"

Game property identifier.

" - }, - "Value":{ - "shape":"GamePropertyValue", - "documentation":"

Game property value.

" - } - }, - "documentation":"

Set of key-value pairs that contain information about a game session. When included in a game session request, these properties communicate details to be used when setting up the new game session, such as to specify a game mode, level, or map. Game properties are passed to the game server process when initiating a new game session; the server process uses the properties as appropriate. For more information, see the Amazon GameLift Developer Guide.

" - }, - "GamePropertyKey":{ - "type":"string", - "max":32 - }, - "GamePropertyList":{ - "type":"list", - "member":{"shape":"GameProperty"}, - "max":16 - }, - "GamePropertyValue":{ - "type":"string", - "max":96 - }, - "GameSession":{ - "type":"structure", - "members":{ - "GameSessionId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the game session. A game session ARN has the following format: arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a game session. Session names do not need to be unique.

" - }, - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that the game session is running on.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "TerminationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "CurrentPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Number of players currently in the game session.

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of players that can be connected simultaneously to the game session.

" - }, - "Status":{ - "shape":"GameSessionStatus", - "documentation":"

Current status of the game session. A game session must have an ACTIVE status to have player sessions.

" - }, - "StatusReason":{ - "shape":"GameSessionStatusReason", - "documentation":"

Provides additional information about game session status. INTERRUPTED indicates that the game session was hosted on a spot instance that was reclaimed, causing the active game session to be terminated.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). You can search for active game sessions based on this custom data with SearchGameSessions.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number.

" - }, - "Port":{ - "shape":"PortNumber", - "documentation":"

Port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number.

" - }, - "PlayerSessionCreationPolicy":{ - "shape":"PlayerSessionCreationPolicy", - "documentation":"

Indicates whether or not the game session is accepting new players.

" - }, - "CreatorId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player. This ID is used to enforce a resource protection policy (if one exists), that limits the number of game sessions a player can create.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - }, - "MatchmakerData":{ - "shape":"MatchmakerData", - "documentation":"

Information about the matchmaking process that was used to create the game session. It is in JSON syntax, formatted as a string. In addition the matchmaking configuration used, it contains data on all players assigned to the match, including player attributes and team assignments. For more details on matchmaker data, see Match Data. Matchmaker data is useful when requesting match backfills, and is updated whenever new players are added during a successful backfill (see StartMatchBackfill).

" - } - }, - "documentation":"

Properties describing a game session.

A game session in ACTIVE status can host players. When a game session ends, its status is set to TERMINATED.

Once the session ends, the game session object is retained for 30 days. This means you can reuse idempotency token values after this time. Game session logs are retained for 14 days.

Game-session-related operations include:

" - }, - "GameSessionActivationTimeoutSeconds":{ - "type":"integer", - "max":600, - "min":1 - }, - "GameSessionConnectionInfo":{ - "type":"structure", - "members":{ - "GameSessionArn":{ - "shape":"ArnStringModel", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session and uniquely identifies it.

" - }, - "IpAddress":{ - "shape":"StringModel", - "documentation":"

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number.

" - }, - "Port":{ - "shape":"PositiveInteger", - "documentation":"

Port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number.

" - }, - "MatchedPlayerSessions":{ - "shape":"MatchedPlayerSessionList", - "documentation":"

Collection of player session IDs, one for each player ID that was included in the original matchmaking request.

" - } - }, - "documentation":"

Connection information for the new game session that is created with matchmaking. (with StartMatchmaking). Once a match is set, the FlexMatch engine places the match and creates a new game session for it. This information, including the game session endpoint and player sessions for each player in the original matchmaking request, is added to the MatchmakingTicket, which can be retrieved by calling DescribeMatchmaking.

" - }, - "GameSessionData":{ - "type":"string", - "max":4096, - "min":1 - }, - "GameSessionDetail":{ - "type":"structure", - "members":{ - "GameSession":{ - "shape":"GameSession", - "documentation":"

Object that describes a game session.

" - }, - "ProtectionPolicy":{ - "shape":"ProtectionPolicy", - "documentation":"

Current status of protection for the game session.

  • NoProtection -- The game session can be terminated during a scale-down event.

  • FullProtection -- If the game session is in an ACTIVE status, it cannot be terminated during a scale-down event.

" - } - }, - "documentation":"

A game session's properties plus the protection policy currently in force.

" - }, - "GameSessionDetailList":{ - "type":"list", - "member":{"shape":"GameSessionDetail"} - }, - "GameSessionFullException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The game instance is currently full and cannot allow the requested player(s) to join. Clients can retry such requests immediately or after a waiting period.

", - "exception":true - }, - "GameSessionList":{ - "type":"list", - "member":{"shape":"GameSession"} - }, - "GameSessionPlacement":{ - "type":"structure", - "members":{ - "PlacementId":{ - "shape":"IdStringModel", - "documentation":"

Unique identifier for a game session placement.

" - }, - "GameSessionQueueName":{ - "shape":"GameSessionQueueName", - "documentation":"

Descriptive label that is associated with game session queue. Queue names must be unique within each region.

" - }, - "Status":{ - "shape":"GameSessionPlacementState", - "documentation":"

Current status of the game session placement request.

  • PENDING -- The placement request is currently in the queue waiting to be processed.

  • FULFILLED -- A new game session and player sessions (if requested) have been successfully created. Values for GameSessionArn and GameSessionRegion are available.

  • CANCELLED -- The placement request was canceled with a call to StopGameSessionPlacement.

  • TIMED_OUT -- A new game session was not successfully created before the time limit expired. You can resubmit the placement request as needed.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of players that can be connected simultaneously to the game session.

" - }, - "GameSessionName":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a game session. Session names do not need to be unique.

" - }, - "GameSessionId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the game session. This value is set once the new game session is placed (placement status is FULFILLED).

" - }, - "GameSessionArn":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Identifier for the game session created by this placement request. This value is set once the new game session is placed (placement status is FULFILLED). This identifier is unique across all regions. You can use this value as a GameSessionId value as needed.

" - }, - "GameSessionRegion":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Name of the region where the game session created by this placement request is running. This value is set once the new game session is placed (placement status is FULFILLED).

" - }, - "PlayerLatencies":{ - "shape":"PlayerLatencyList", - "documentation":"

Set of values, expressed in milliseconds, indicating the amount of latency that a player experiences when connected to AWS regions.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this request was placed in the queue. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this request was completed, canceled, or timed out.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is FULFILLED).

" - }, - "Port":{ - "shape":"PortNumber", - "documentation":"

Port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is FULFILLED).

" - }, - "PlacedPlayerSessions":{ - "shape":"PlacedPlayerSessionList", - "documentation":"

Collection of information on player sessions created in response to the game session placement request. These player sessions are created only once a new game session is successfully placed (placement status is FULFILLED). This information includes the player ID (as provided in the placement request) and the corresponding player session ID. Retrieve full player sessions by calling DescribePlayerSessions with the player session ID.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - }, - "MatchmakerData":{ - "shape":"MatchmakerData", - "documentation":"

Information on the matchmaking process for this game. Data is in JSON syntax, formatted as a string. It identifies the matchmaking configuration used to create the match, and contains data on all players assigned to the match, including player attributes and team assignments. For more details on matchmaker data, see Match Data.

" - } - }, - "documentation":"

Object that describes a StartGameSessionPlacement request. This object includes the full details of the original request plus the current status and start/end time stamps.

Game session placement-related operations include:

" - }, - "GameSessionPlacementState":{ - "type":"string", - "enum":[ - "PENDING", - "FULFILLED", - "CANCELLED", - "TIMED_OUT" - ] - }, - "GameSessionQueue":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"GameSessionQueueName", - "documentation":"

Descriptive label that is associated with game session queue. Queue names must be unique within each region.

" - }, - "GameSessionQueueArn":{ - "shape":"ArnStringModel", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session queue and uniquely identifies it. Format is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912.

" - }, - "TimeoutInSeconds":{ - "shape":"WholeNumber", - "documentation":"

Maximum time, in seconds, that a new game session placement request remains in the queue. When a request exceeds this time, the game session placement changes to a TIMED_OUT status.

" - }, - "PlayerLatencyPolicies":{ - "shape":"PlayerLatencyPolicyList", - "documentation":"

Collection of latency policies to apply when processing game sessions placement requests with player latency information. Multiple policies are evaluated in order of the maximum latency value, starting with the lowest latency values. With just one policy, it is enforced at the start of the game session placement for the duration period. With multiple policies, each policy is enforced consecutively for its duration period. For example, a queue might enforce a 60-second policy followed by a 120-second policy, and then no policy for the remainder of the placement.

" - }, - "Destinations":{ - "shape":"GameSessionQueueDestinationList", - "documentation":"

List of fleets that can be used to fulfill game session placement requests in the queue. Fleets are identified by either a fleet ARN or a fleet alias ARN. Destinations are listed in default preference order.

" - } - }, - "documentation":"

Configuration of a queue that is used to process game session placement requests. The queue configuration identifies several game features:

  • The destinations where a new game session can potentially be hosted. Amazon GameLift tries these destinations in an order based on either the queue's default order or player latency information, if provided in a placement request. With latency information, Amazon GameLift can place game sessions where the majority of players are reporting the lowest possible latency.

  • The length of time that placement requests can wait in the queue before timing out.

  • A set of optional latency policies that protect individual players from high latencies, preventing game sessions from being placed where any individual player is reporting latency higher than a policy's maximum.

Queue-related operations include:

" - }, - "GameSessionQueueDestination":{ - "type":"structure", - "members":{ - "DestinationArn":{ - "shape":"ArnStringModel", - "documentation":"

Amazon Resource Name (ARN) assigned to fleet or fleet alias. ARNs, which include a fleet ID or alias ID and a region name, provide a unique identifier across all regions.

" - } - }, - "documentation":"

Fleet designated in a game session queue. Requests for new game sessions in the queue are fulfilled by starting a new game session on any destination configured for a queue.

Queue-related operations include:

" - }, - "GameSessionQueueDestinationList":{ - "type":"list", - "member":{"shape":"GameSessionQueueDestination"} - }, - "GameSessionQueueList":{ - "type":"list", - "member":{"shape":"GameSessionQueue"} - }, - "GameSessionQueueName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9-]+" - }, - "GameSessionQueueNameList":{ - "type":"list", - "member":{"shape":"GameSessionQueueName"} - }, - "GameSessionStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "ACTIVATING", - "TERMINATED", - "TERMINATING", - "ERROR" - ] - }, - "GameSessionStatusReason":{ - "type":"string", - "enum":["INTERRUPTED"] - }, - "GetGameSessionLogUrlInput":{ - "type":"structure", - "required":["GameSessionId"], - "members":{ - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to get logs for.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "GetGameSessionLogUrlOutput":{ - "type":"structure", - "members":{ - "PreSignedUrl":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Location of the requested game session logs, available for download.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "GetInstanceAccessInput":{ - "type":"structure", - "required":[ - "FleetId", - "InstanceId" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that contains the instance you want access to. The fleet can be in any of the following statuses: ACTIVATING, ACTIVE, or ERROR. Fleets with an ERROR status may be accessible for a short time before they are deleted.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

Unique identifier for an instance you want to get access to. You can access an instance in any status.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "GetInstanceAccessOutput":{ - "type":"structure", - "members":{ - "InstanceAccess":{ - "shape":"InstanceAccess", - "documentation":"

Object that contains connection information for a fleet instance, including IP address and access credentials.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "IdStringModel":{ - "type":"string", - "max":48, - "min":1, - "pattern":"[a-zA-Z0-9-]+" - }, - "IdempotentParameterMismatchException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

A game session with this custom ID string already exists in this fleet. Resolve this conflict before retrying this request.

", - "exception":true - }, - "Instance":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that the instance is in.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

Unique identifier for an instance.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

IP address assigned to the instance.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Operating system that is running on this instance.

" - }, - "Type":{ - "shape":"EC2InstanceType", - "documentation":"

EC2 instance type that defines the computing resources of this instance.

" - }, - "Status":{ - "shape":"InstanceStatus", - "documentation":"

Current status of the instance. Possible statuses include the following:

  • PENDING -- The instance is in the process of being created and launching server processes as defined in the fleet's run-time configuration.

  • ACTIVE -- The instance has been successfully created and at least one server process has successfully launched and reported back to Amazon GameLift that it is ready to host a game session. The instance is now considered ready to host game sessions.

  • TERMINATING -- The instance is in the process of shutting down. This may happen to reduce capacity during a scaling down event or to recycle resources in the event of a problem.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - } - }, - "documentation":"

Properties that describe an instance of a virtual computing resource that hosts one or more game servers. A fleet may contain zero or more instances.

" - }, - "InstanceAccess":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet containing the instance being accessed.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

Unique identifier for an instance being accessed.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

IP address assigned to the instance.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Operating system that is running on the instance.

" - }, - "Credentials":{ - "shape":"InstanceCredentials", - "documentation":"

Credentials required to access the instance.

" - } - }, - "documentation":"

Information required to remotely connect to a fleet instance. Access is requested by calling GetInstanceAccess.

" - }, - "InstanceCredentials":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"NonEmptyString", - "documentation":"

User login string.

" - }, - "Secret":{ - "shape":"NonEmptyString", - "documentation":"

Secret string. For Windows instances, the secret is a password for use with Windows Remote Desktop. For Linux instances, it is a private key (which must be saved as a .pem file) for use with SSH.

" - } - }, - "documentation":"

Set of credentials required to remotely access a fleet instance. Access credentials are requested by calling GetInstanceAccess and returned in an InstanceAccess object.

", - "sensitive":true - }, - "InstanceId":{ - "type":"string", - "pattern":"[a-zA-Z0-9\\.-]+" - }, - "InstanceList":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InstanceStatus":{ - "type":"string", - "enum":[ - "PENDING", - "ACTIVE", - "TERMINATING" - ] - }, - "Integer":{"type":"integer"}, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period.

", - "exception":true, - "fault":true - }, - "InvalidFleetStatusException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The requested operation would cause a conflict with the current state of a resource associated with the request and/or the fleet. Resolve the conflict before retrying.

", - "exception":true - }, - "InvalidGameSessionStatusException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The requested operation would cause a conflict with the current state of a resource associated with the request and/or the game instance. Resolve the conflict before retrying.

", - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying.

", - "exception":true - }, - "IpAddress":{"type":"string"}, - "IpPermission":{ - "type":"structure", - "required":[ - "FromPort", - "ToPort", - "IpRange", - "Protocol" - ], - "members":{ - "FromPort":{ - "shape":"PortNumber", - "documentation":"

Starting value for a range of allowed port numbers.

" - }, - "ToPort":{ - "shape":"PortNumber", - "documentation":"

Ending value for a range of allowed port numbers. Port numbers are end-inclusive. This value must be higher than FromPort.

" - }, - "IpRange":{ - "shape":"NonBlankString", - "documentation":"

Range of allowed IP addresses. This value must be expressed in CIDR notation. Example: \"000.000.000.000/[subnet mask]\" or optionally the shortened version \"0.0.0.0/[subnet mask]\".

" - }, - "Protocol":{ - "shape":"IpProtocol", - "documentation":"

Network communication protocol used by the fleet.

" - } - }, - "documentation":"

A range of IP addresses and port settings that allow inbound traffic to connect to server processes on Amazon GameLift. Each game session hosted on a fleet is assigned a unique combination of IP address and port number, which must fall into the fleet's allowed ranges. This combination is included in the GameSession object.

" - }, - "IpPermissionsList":{ - "type":"list", - "member":{"shape":"IpPermission"}, - "max":50 - }, - "IpProtocol":{ - "type":"string", - "enum":[ - "TCP", - "UDP" - ] - }, - "LatencyMap":{ - "type":"map", - "key":{"shape":"NonEmptyString"}, - "value":{"shape":"PositiveInteger"} - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue before retrying.

", - "exception":true - }, - "ListAliasesInput":{ - "type":"structure", - "members":{ - "RoutingStrategyType":{ - "shape":"RoutingStrategyType", - "documentation":"

Type of routing to filter results on. Use this parameter to retrieve only aliases of a certain type. To retrieve all aliases, leave this parameter empty.

Possible routing types include the following:

  • SIMPLE -- The alias resolves to one specific fleet. Use this type when routing to active fleets.

  • TERMINAL -- The alias does not resolve to a fleet but instead can be used to display a message to the user. A terminal alias throws a TerminalRoutingStrategyException with the RoutingStrategy message embedded.

" - }, - "Name":{ - "shape":"NonEmptyString", - "documentation":"

Descriptive label that is associated with an alias. Alias names do not need to be unique.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "ListAliasesOutput":{ - "type":"structure", - "members":{ - "Aliases":{ - "shape":"AliasList", - "documentation":"

Collection of alias records that match the list request.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ListBuildsInput":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"BuildStatus", - "documentation":"

Build status to filter results by. To retrieve all builds, leave this parameter empty.

Possible build statuses include the following:

  • INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.

  • READY -- The game build has been successfully uploaded. You can now create new fleets for this build.

  • FAILED -- The game build upload failed. You cannot create new fleets for this build.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "ListBuildsOutput":{ - "type":"structure", - "members":{ - "Builds":{ - "shape":"BuildList", - "documentation":"

Collection of build records that match the request.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ListFleetsInput":{ - "type":"structure", - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to return fleets for. Use this parameter to return only fleets using the specified build. To retrieve all fleets, leave this parameter empty.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "ListFleetsOutput":{ - "type":"structure", - "members":{ - "FleetIds":{ - "shape":"FleetIdList", - "documentation":"

Set of fleet IDs matching the list request. You can retrieve additional information about all returned fleets by passing this result set to a call to DescribeFleetAttributes, DescribeFleetCapacity, or DescribeFleetUtilization.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "MatchedPlayerSession":{ - "type":"structure", - "members":{ - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player

" - }, - "PlayerSessionId":{ - "shape":"PlayerSessionId", - "documentation":"

Unique identifier for a player session

" - } - }, - "documentation":"

Represents a new player session that is created as a result of a successful FlexMatch match. A successful match automatically creates new player sessions for every player ID in the original matchmaking request.

When players connect to the match's game session, they must include both player ID and player session ID in order to claim their assigned player slot.

" - }, - "MatchedPlayerSessionList":{ - "type":"list", - "member":{"shape":"MatchedPlayerSession"} - }, - "MatchmakerData":{ - "type":"string", - "max":390000, - "min":1 - }, - "MatchmakingAcceptanceTimeoutInteger":{ - "type":"integer", - "max":600, - "min":1 - }, - "MatchmakingConfiguration":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking configuration. This name is used to identify the configuration associated with a matchmaking request or ticket.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with matchmaking configuration.

" - }, - "GameSessionQueueArns":{ - "shape":"QueueArnsList", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session queue and uniquely identifies it. Format is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. These queues are used when placing game sessions for matches that are created with this matchmaking configuration. Queues can be located in any region.

" - }, - "RequestTimeoutSeconds":{ - "shape":"MatchmakingRequestTimeoutInteger", - "documentation":"

Maximum duration, in seconds, that a matchmaking ticket can remain in process before timing out. Requests that time out can be resubmitted as needed.

" - }, - "AcceptanceTimeoutSeconds":{ - "shape":"MatchmakingAcceptanceTimeoutInteger", - "documentation":"

Length of time (in seconds) to wait for players to accept a proposed match. If any player rejects the match or fails to accept before the timeout, the ticket continues to look for an acceptable match.

" - }, - "AcceptanceRequired":{ - "shape":"BooleanModel", - "documentation":"

Flag that determines whether or not a match that was created with this configuration must be accepted by the matched players. To require acceptance, set to TRUE.

" - }, - "RuleSetName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set to use with this configuration. A matchmaking configuration can only use rule sets that are defined in the same region.

" - }, - "NotificationTarget":{ - "shape":"SnsArnStringModel", - "documentation":"

SNS topic ARN that is set up to receive matchmaking notifications.

" - }, - "AdditionalPlayerCount":{ - "shape":"WholeNumber", - "documentation":"

Number of player slots in a match to keep open for future players. For example, if the configuration's rule set specifies a match for a single 12-person team, and the additional player count is set to 2, only 10 players are selected for the match.

" - }, - "CustomEventData":{ - "shape":"CustomEventData", - "documentation":"

Information to attached to all events related to the matchmaking configuration.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - } - }, - "documentation":"

Guidelines for use with FlexMatch to match players into games. All matchmaking requests must specify a matchmaking configuration.

" - }, - "MatchmakingConfigurationList":{ - "type":"list", - "member":{"shape":"MatchmakingConfiguration"} - }, - "MatchmakingConfigurationStatus":{ - "type":"string", - "enum":[ - "CANCELLED", - "COMPLETED", - "FAILED", - "PLACING", - "QUEUED", - "REQUIRES_ACCEPTANCE", - "SEARCHING", - "TIMED_OUT" - ] - }, - "MatchmakingIdList":{ - "type":"list", - "member":{"shape":"MatchmakingIdStringModel"} - }, - "MatchmakingIdStringModel":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9-\\.]+" - }, - "MatchmakingRequestTimeoutInteger":{ - "type":"integer", - "max":43200, - "min":1 - }, - "MatchmakingRuleSet":{ - "type":"structure", - "required":["RuleSetBody"], - "members":{ - "RuleSetName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set

" - }, - "RuleSetBody":{ - "shape":"RuleSetBody", - "documentation":"

Collection of matchmaking rules, formatted as a JSON string. (Note that comments14 are not allowed in JSON, but most elements support a description field.)

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - } - }, - "documentation":"

Set of rule statements, used with FlexMatch, that determine how to build a certain kind of player match. Each rule set describes a type of group to be created and defines the parameters for acceptable player matches. Rule sets are used in MatchmakingConfiguration objects.

A rule set may define the following elements for a match. For detailed information and examples showing how to construct a rule set, see Build a FlexMatch Rule Set.

  • Teams -- Required. A rule set must define one or multiple teams for the match and set minimum and maximum team sizes. For example, a rule set might describe a 4x4 match that requires all eight slots to be filled.

  • Player attributes -- Optional. These attributes specify a set of player characteristics to evaluate when looking for a match. Matchmaking requests that use a rule set with player attributes must provide the corresponding attribute values. For example, an attribute might specify a player's skill or level.

  • Rules -- Optional. Rules define how to evaluate potential players for a match based on player attributes. A rule might specify minimum requirements for individual players, teams, or entire matches. For example, a rule might require each player to meet a certain skill level, each team to have at least one player in a certain role, or the match to have a minimum average skill level. or may describe an entire group--such as all teams must be evenly matched or have at least one player in a certain role.

  • Expansions -- Optional. Expansions allow you to relax the rules after a period of time when no acceptable matches are found. This feature lets you balance getting players into games in a reasonable amount of time instead of making them wait indefinitely for the best possible match. For example, you might use an expansion to increase the maximum skill variance between players after 30 seconds.

" - }, - "MatchmakingRuleSetList":{ - "type":"list", - "member":{"shape":"MatchmakingRuleSet"} - }, - "MatchmakingRuleSetNameList":{ - "type":"list", - "member":{"shape":"MatchmakingIdStringModel"}, - "max":10, - "min":1 - }, - "MatchmakingTicket":{ - "type":"structure", - "members":{ - "TicketId":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking ticket.

" - }, - "ConfigurationName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Name of the MatchmakingConfiguration that is used with this ticket. Matchmaking configurations determine how players are grouped into a match and how a new game session is created for the match.

" - }, - "Status":{ - "shape":"MatchmakingConfigurationStatus", - "documentation":"

Current status of the matchmaking request.

  • QUEUED -- The matchmaking request has been received and is currently waiting to be processed.

  • SEARCHING -- The matchmaking request is currently being processed.

  • REQUIRES_ACCEPTANCE -- A match has been proposed and the players must accept the match (see AcceptMatch). This status is used only with requests that use a matchmaking configuration with a player acceptance requirement.

  • PLACING -- The FlexMatch engine has matched players and is in the process of placing a new game session for the match.

  • COMPLETED -- Players have been matched and a game session is ready to host the players. A ticket in this state contains the necessary connection information for players.

  • FAILED -- The matchmaking request was not completed. Tickets with players who fail to accept a proposed match are placed in FAILED status.

  • CANCELLED -- The matchmaking request was canceled with a call to StopMatchmaking.

  • TIMED_OUT -- The matchmaking request was not successful within the duration specified in the matchmaking configuration.

Matchmaking requests that fail to successfully complete (statuses FAILED, CANCELLED, TIMED_OUT) can be resubmitted as new requests with new ticket IDs.

" - }, - "StatusReason":{ - "shape":"StringModel", - "documentation":"

Code to explain the current status. For example, a status reason may indicate when a ticket has returned to SEARCHING status after a proposed match fails to receive player acceptances.

" - }, - "StatusMessage":{ - "shape":"StringModel", - "documentation":"

Additional information about the current status.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this matchmaking request was received. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this matchmaking request stopped being processed due to success, failure, or cancellation. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "Players":{ - "shape":"PlayerList", - "documentation":"

A set of Player objects, each representing a player to find matches for. Players are identified by a unique player ID and may include latency data for use during matchmaking. If the ticket is in status COMPLETED, the Player objects include the team the players were assigned to in the resulting match.

" - }, - "GameSessionConnectionInfo":{ - "shape":"GameSessionConnectionInfo", - "documentation":"

Identifier and connection information of the game session created for the match. This information is added to the ticket only after the matchmaking request has been successfully completed.

" - }, - "EstimatedWaitTime":{ - "shape":"WholeNumber", - "documentation":"

Average amount of time (in seconds) that players are currently waiting for a match. If there is not enough recent data, this property may be empty.

" - } - }, - "documentation":"

Ticket generated to track the progress of a matchmaking request. Each ticket is uniquely identified by a ticket ID, supplied by the requester, when creating a matchmaking request with StartMatchmaking. Tickets can be retrieved by calling DescribeMatchmaking with the ticket ID.

" - }, - "MatchmakingTicketList":{ - "type":"list", - "member":{"shape":"MatchmakingTicket"} - }, - "MaxConcurrentGameSessionActivations":{ - "type":"integer", - "max":2147483647, - "min":1 - }, - "MetricGroup":{ - "type":"string", - "max":255, - "min":1 - }, - "MetricGroupList":{ - "type":"list", - "member":{"shape":"MetricGroup"}, - "max":1 - }, - "MetricName":{ - "type":"string", - "enum":[ - "ActivatingGameSessions", - "ActiveGameSessions", - "ActiveInstances", - "AvailableGameSessions", - "AvailablePlayerSessions", - "CurrentPlayerSessions", - "IdleInstances", - "PercentAvailableGameSessions", - "PercentIdleInstances", - "QueueDepth", - "WaitTime" - ] - }, - "NonBlankAndLengthConstraintString":{ - "type":"string", - "max":1024, - "min":1, - "pattern":".*\\S.*" - }, - "NonBlankString":{ - "type":"string", - "pattern":"[^\\s]+" - }, - "NonEmptyString":{ - "type":"string", - "min":1 - }, - "NonZeroAndMaxString":{ - "type":"string", - "max":1024, - "min":1 - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

A service resource associated with the request could not be found. Clients should not retry such requests.

", - "exception":true - }, - "OperatingSystem":{ - "type":"string", - "enum":[ - "WINDOWS_2012", - "AMAZON_LINUX" - ] - }, - "PlacedPlayerSession":{ - "type":"structure", - "members":{ - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player that is associated with this player session.

" - }, - "PlayerSessionId":{ - "shape":"PlayerSessionId", - "documentation":"

Unique identifier for a player session.

" - } - }, - "documentation":"

Information about a player session that was created as part of a StartGameSessionPlacement request. This object contains only the player ID and player session ID. To retrieve full details on a player session, call DescribePlayerSessions with the player session ID.

Player-session-related operations include:

" - }, - "PlacedPlayerSessionList":{ - "type":"list", - "member":{"shape":"PlacedPlayerSession"} - }, - "Player":{ - "type":"structure", - "members":{ - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player

" - }, - "PlayerAttributes":{ - "shape":"PlayerAttributeMap", - "documentation":"

Collection of key:value pairs containing player information for use in matchmaking. Player attribute keys must match the playerAttributes used in a matchmaking rule set. Example: \"PlayerAttributes\": {\"skill\": {\"N\": \"23\"}, \"gameMode\": {\"S\": \"deathmatch\"}}.

" - }, - "Team":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Name of the team that the player is assigned to in a match. Team names are defined in a matchmaking rule set.

" - }, - "LatencyInMs":{ - "shape":"LatencyMap", - "documentation":"

Set of values, expressed in milliseconds, indicating the amount of latency that a player experiences when connected to AWS regions. If this property is present, FlexMatch considers placing the match only in regions for which latency is reported.

If a matchmaker has a rule that evaluates player latency, players must report latency in order to be matched. If no latency is reported in this scenario, FlexMatch assumes that no regions are available to the player and the ticket is not matchable.

" - } - }, - "documentation":"

Represents a player in matchmaking. When starting a matchmaking request, a player has a player ID, attributes, and may have latency data. Team information is added after a match has been successfully completed.

" - }, - "PlayerAttributeMap":{ - "type":"map", - "key":{"shape":"NonZeroAndMaxString"}, - "value":{"shape":"AttributeValue"} - }, - "PlayerData":{ - "type":"string", - "max":2048, - "min":1 - }, - "PlayerDataMap":{ - "type":"map", - "key":{"shape":"NonZeroAndMaxString"}, - "value":{"shape":"PlayerData"} - }, - "PlayerIdList":{ - "type":"list", - "member":{"shape":"NonZeroAndMaxString"}, - "max":25, - "min":1 - }, - "PlayerLatency":{ - "type":"structure", - "members":{ - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player associated with the latency data.

" - }, - "RegionIdentifier":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Name of the region that is associated with the latency value.

" - }, - "LatencyInMilliseconds":{ - "shape":"Float", - "documentation":"

Amount of time that represents the time lag experienced by the player when connected to the specified region.

" - } - }, - "documentation":"

Regional latency information for a player, used when requesting a new game session with StartGameSessionPlacement. This value indicates the amount of time lag that exists when the player is connected to a fleet in the specified region. The relative difference between a player's latency values for multiple regions are used to determine which fleets are best suited to place a new game session for the player.

" - }, - "PlayerLatencyList":{ - "type":"list", - "member":{"shape":"PlayerLatency"} - }, - "PlayerLatencyPolicy":{ - "type":"structure", - "members":{ - "MaximumIndividualPlayerLatencyMilliseconds":{ - "shape":"WholeNumber", - "documentation":"

The maximum latency value that is allowed for any player, in milliseconds. All policies must have a value set for this property.

" - }, - "PolicyDurationSeconds":{ - "shape":"WholeNumber", - "documentation":"

The length of time, in seconds, that the policy is enforced while placing a new game session. A null value for this property means that the policy is enforced until the queue times out.

" - } - }, - "documentation":"

Queue setting that determines the highest latency allowed for individual players when placing a game session. When a latency policy is in force, a game session cannot be placed at any destination in a region where a player is reporting latency higher than the cap. Latency policies are only enforced when the placement request contains player latency information.

Queue-related operations include:

" - }, - "PlayerLatencyPolicyList":{ - "type":"list", - "member":{"shape":"PlayerLatencyPolicy"} - }, - "PlayerList":{ - "type":"list", - "member":{"shape":"Player"} - }, - "PlayerSession":{ - "type":"structure", - "members":{ - "PlayerSessionId":{ - "shape":"PlayerSessionId", - "documentation":"

Unique identifier for a player session.

" - }, - "PlayerId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a player that is associated with this player session.

" - }, - "GameSessionId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the game session that the player session is connected to.

" - }, - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that the player's game session is running on.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "TerminationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "Status":{ - "shape":"PlayerSessionStatus", - "documentation":"

Current status of the player session.

Possible player session statuses include the following:

  • RESERVED -- The player session request has been received, but the player has not yet connected to the server process and/or been validated.

  • ACTIVE -- The player has been validated by the server process and is currently connected.

  • COMPLETED -- The player connection has been dropped.

  • TIMEDOUT -- A player session request was received, but the player did not connect and/or was not validated within the timeout limit (60 seconds).

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number.

" - }, - "Port":{ - "shape":"PortNumber", - "documentation":"

Port number for the game session. To connect to a Amazon GameLift server process, an app needs both the IP address and port number.

" - }, - "PlayerData":{ - "shape":"PlayerData", - "documentation":"

Developer-defined information related to a player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game.

" - } - }, - "documentation":"

Properties describing a player session. Player session objects are created either by creating a player session for a specific game session, or as part of a game session placement. A player session represents either a player reservation for a game session (status RESERVED) or actual player activity in a game session (status ACTIVE). A player session object (including player data) is automatically passed to a game session when the player connects to the game session and is validated.

When a player disconnects, the player session status changes to COMPLETED. Once the session ends, the player session object is retained for 30 days and then removed.

Player-session-related operations include:

" - }, - "PlayerSessionCreationPolicy":{ - "type":"string", - "enum":[ - "ACCEPT_ALL", - "DENY_ALL" - ] - }, - "PlayerSessionId":{ - "type":"string", - "pattern":"^psess-\\S+" - }, - "PlayerSessionList":{ - "type":"list", - "member":{"shape":"PlayerSession"} - }, - "PlayerSessionStatus":{ - "type":"string", - "enum":[ - "RESERVED", - "ACTIVE", - "COMPLETED", - "TIMEDOUT" - ] - }, - "PolicyType":{ - "type":"string", - "enum":[ - "RuleBased", - "TargetBased" - ] - }, - "PortNumber":{ - "type":"integer", - "max":60000, - "min":1 - }, - "PositiveInteger":{ - "type":"integer", - "min":1 - }, - "PositiveLong":{ - "type":"long", - "min":1 - }, - "ProtectionPolicy":{ - "type":"string", - "enum":[ - "NoProtection", - "FullProtection" - ] - }, - "PutScalingPolicyInput":{ - "type":"structure", - "required":[ - "Name", - "FleetId", - "MetricName" - ], - "members":{ - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a scaling policy. Policy names do not need to be unique. A fleet can have only one scaling policy with the same name.

" - }, - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to apply this policy to. The fleet cannot be in any of the following statuses: ERROR or DELETING.

" - }, - "ScalingAdjustment":{ - "shape":"Integer", - "documentation":"

Amount of adjustment to make, based on the scaling adjustment type.

" - }, - "ScalingAdjustmentType":{ - "shape":"ScalingAdjustmentType", - "documentation":"

Type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity -- add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity -- set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity -- increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down; for example, a value of \"-10\" scales the fleet down by 10%.

" - }, - "Threshold":{ - "shape":"Double", - "documentation":"

Metric value used to trigger a scaling event.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperatorType", - "documentation":"

Comparison operator to use when measuring the metric against the threshold value.

" - }, - "EvaluationPeriods":{ - "shape":"PositiveInteger", - "documentation":"

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions -- Game sessions in the process of being created.

  • ActiveGameSessions -- Game sessions that are currently running.

  • ActiveInstances -- Fleet instances that are currently running at least one game session.

  • AvailableGameSessions -- Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions -- Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessions -- Player slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances -- Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions -- Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances -- Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth -- Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime -- Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

Type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

" - }, - "TargetConfiguration":{ - "shape":"TargetConfiguration", - "documentation":"

Object that contains settings for a target-based scaling policy.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "PutScalingPolicyOutput":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "QueueArnsList":{ - "type":"list", - "member":{"shape":"ArnStringModel"} - }, - "RequestUploadCredentialsInput":{ - "type":"structure", - "required":["BuildId"], - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to get credentials for.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "RequestUploadCredentialsOutput":{ - "type":"structure", - "members":{ - "UploadCredentials":{ - "shape":"AwsCredentials", - "documentation":"

AWS credentials required when uploading a game build to the storage location. These credentials have a limited lifespan and are valid only for the build they were issued for.

" - }, - "StorageLocation":{ - "shape":"S3Location", - "documentation":"

Amazon S3 path and key, identifying where the game build files are stored.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ResolveAliasInput":{ - "type":"structure", - "required":["AliasId"], - "members":{ - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for the alias you want to resolve.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "ResolveAliasOutput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Fleet identifier that is associated with the requested alias.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ResourceCreationLimitPolicy":{ - "type":"structure", - "members":{ - "NewGameSessionsPerCreator":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of game sessions that an individual can create during the policy period.

" - }, - "PolicyPeriodInMinutes":{ - "shape":"WholeNumber", - "documentation":"

Time span used in evaluating the resource creation limit policy.

" - } - }, - "documentation":"

Policy that limits the number of game sessions a player can create on the same fleet. This optional policy gives game owners control over how players can consume available game server resources. A resource creation policy makes the following statement: \"An individual player can create a maximum number of new game sessions within a specified time period\".

The policy is evaluated when a player tries to create a new game session. For example, with a policy of 10 new game sessions and a time period of 60 minutes, on receiving a CreateGameSession request, Amazon GameLift checks that the player (identified by CreatorId) has created fewer than 10 game sessions in the past 60 minutes.

" - }, - "RoutingStrategy":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"RoutingStrategyType", - "documentation":"

Type of routing strategy.

Possible routing types include the following:

  • SIMPLE -- The alias resolves to one specific fleet. Use this type when routing to active fleets.

  • TERMINAL -- The alias does not resolve to a fleet but instead can be used to display a message to the user. A terminal alias throws a TerminalRoutingStrategyException with the RoutingStrategy message embedded.

" - }, - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that the alias points to.

" - }, - "Message":{ - "shape":"FreeText", - "documentation":"

Message text to be used with a terminal routing strategy.

" - } - }, - "documentation":"

Routing configuration for a fleet alias.

Fleet-related operations include:

" - }, - "RoutingStrategyType":{ - "type":"string", - "enum":[ - "SIMPLE", - "TERMINAL" - ] - }, - "RuleSetBody":{ - "type":"string", - "max":65535, - "min":1 - }, - "RuleSetLimit":{ - "type":"integer", - "max":10, - "min":1 - }, - "RuntimeConfiguration":{ - "type":"structure", - "members":{ - "ServerProcesses":{ - "shape":"ServerProcessList", - "documentation":"

Collection of server process configurations that describe which server processes to run on each instance in a fleet.

" - }, - "MaxConcurrentGameSessionActivations":{ - "shape":"MaxConcurrentGameSessionActivations", - "documentation":"

Maximum number of game sessions with status ACTIVATING to allow on an instance simultaneously. This setting limits the amount of instance resources that can be used for new game activations at any one time.

" - }, - "GameSessionActivationTimeoutSeconds":{ - "shape":"GameSessionActivationTimeoutSeconds", - "documentation":"

Maximum amount of time (in seconds) that a game session can remain in status ACTIVATING. If the game session is not active before the timeout, activation is terminated and the game session status is changed to TERMINATED.

" - } - }, - "documentation":"

A collection of server process configurations that describe what processes to run on each instance in a fleet. All fleets must have a run-time configuration. Each instance in the fleet launches the server processes specified in the run-time configuration and launches new ones as existing processes end. Each instance regularly checks for an updated run-time configuration and follows the new instructions.

The run-time configuration enables the instances in a fleet to run multiple processes simultaneously. Potential scenarios are as follows: (1) Run multiple processes of a single game server executable to maximize usage of your hosting resources. (2) Run one or more processes of different build executables, such as your game server executable and a related program, or two or more different versions of a game server. (3) Run multiple processes of a single game server but with different launch parameters, for example to run one process on each instance in debug mode.

A Amazon GameLift instance is limited to 50 processes running simultaneously. A run-time configuration must specify fewer than this limit. To calculate the total number of processes specified in a run-time configuration, add the values of the ConcurrentExecutions parameter for each ServerProcess object in the run-time configuration.

Fleet-related operations include:

" - }, - "S3Location":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"NonEmptyString", - "documentation":"

Amazon S3 bucket identifier. This is the name of your S3 bucket.

" - }, - "Key":{ - "shape":"NonEmptyString", - "documentation":"

Name of the zip file containing your build files.

" - }, - "RoleArn":{ - "shape":"NonEmptyString", - "documentation":"

Amazon Resource Name (ARN) for the access role that allows Amazon GameLift to access your S3 bucket.

" - } - }, - "documentation":"

Location in Amazon Simple Storage Service (Amazon S3) where build files can be stored for access by Amazon GameLift. This location is specified in a CreateBuild request. For more details, see the Create a Build with Files in Amazon S3.

" - }, - "ScalingAdjustmentType":{ - "type":"string", - "enum":[ - "ChangeInCapacity", - "ExactCapacity", - "PercentChangeInCapacity" - ] - }, - "ScalingPolicy":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that is associated with this scaling policy.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

" - }, - "Status":{ - "shape":"ScalingStatusType", - "documentation":"

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE -- The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED -- A request to update the scaling policy has been received.

  • UPDATING -- A change is being made to the scaling policy.

  • DELETE_REQUESTED -- A request to delete the scaling policy has been received.

  • DELETING -- The scaling policy is being deleted.

  • DELETED -- The scaling policy has been deleted.

  • ERROR -- An error occurred in creating the policy. It should be removed and recreated.

" - }, - "ScalingAdjustment":{ - "shape":"Integer", - "documentation":"

Amount of adjustment to make, based on the scaling adjustment type.

" - }, - "ScalingAdjustmentType":{ - "shape":"ScalingAdjustmentType", - "documentation":"

Type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity -- add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity -- set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity -- increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperatorType", - "documentation":"

Comparison operator to use when measuring a metric against the threshold value.

" - }, - "Threshold":{ - "shape":"Double", - "documentation":"

Metric value used to trigger a scaling event.

" - }, - "EvaluationPeriods":{ - "shape":"PositiveInteger", - "documentation":"

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions -- Game sessions in the process of being created.

  • ActiveGameSessions -- Game sessions that are currently running.

  • ActiveInstances -- Fleet instances that are currently running at least one game session.

  • AvailableGameSessions -- Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions -- Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessions -- Player slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances -- Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions -- Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances -- Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth -- Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime -- Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

Type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

" - }, - "TargetConfiguration":{ - "shape":"TargetConfiguration", - "documentation":"

Object that contains settings for a target-based scaling policy.

" - } - }, - "documentation":"

Rule that controls how a fleet is scaled. Scaling policies are uniquely identified by the combination of name and fleet ID.

Operations related to fleet capacity scaling include:

" - }, - "ScalingPolicyList":{ - "type":"list", - "member":{"shape":"ScalingPolicy"} - }, - "ScalingStatusType":{ - "type":"string", - "enum":[ - "ACTIVE", - "UPDATE_REQUESTED", - "UPDATING", - "DELETE_REQUESTED", - "DELETING", - "DELETED", - "ERROR" - ] - }, - "SearchGameSessionsInput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to search for active game sessions. Each request must reference either a fleet ID or alias ID, but not both.

" - }, - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for an alias associated with the fleet to search for active game sessions. Each request must reference either a fleet ID or alias ID, but not both.

" - }, - "FilterExpression":{ - "shape":"NonZeroAndMaxString", - "documentation":"

String containing the search criteria for the session search. If no filter expression is included, the request returns results for all game sessions in the fleet that are in ACTIVE status.

A filter expression can contain one or multiple conditions. Each condition consists of the following:

  • Operand -- Name of a game session attribute. Valid values are gameSessionName, gameSessionId, gameSessionProperties, maximumSessions, creationTimeMillis, playerSessionCount, hasAvailablePlayerSessions.

  • Comparator -- Valid comparators are: =, <>, <, >, <=, >=.

  • Value -- Value to be searched for. Values may be numbers, boolean values (true/false) or strings depending on the operand. String values are case sensitive and must be enclosed in single quotes. Special characters must be escaped. Boolean and string values can only be used with the comparators = and <>. For example, the following filter expression searches on gameSessionName: \"FilterExpression\": \"gameSessionName = 'Matt\\\\'s Awesome Game 1'\".

To chain multiple conditions in a single expression, use the logical keywords AND, OR, and NOT and parentheses as needed. For example: x AND y AND NOT z, NOT (x OR y).

Session search evaluates conditions from left to right using the following precedence rules:

  1. =, <>, <, >, <=, >=

  2. Parentheses

  3. NOT

  4. AND

  5. OR

For example, this filter expression retrieves game sessions hosting at least ten players that have an open player slot: \"maximumSessions>=10 AND hasAvailablePlayerSessions=true\".

" - }, - "SortExpression":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Instructions on how to sort the search results. If no sort expression is included, the request returns results in random order. A sort expression consists of the following elements:

  • Operand -- Name of a game session attribute. Valid values are gameSessionName, gameSessionId, gameSessionProperties, maximumSessions, creationTimeMillis, playerSessionCount, hasAvailablePlayerSessions.

  • Order -- Valid sort orders are ASC (ascending) and DESC (descending).

For example, this sort expression returns the oldest active sessions first: \"SortExpression\": \"creationTimeMillis ASC\". Results with a null value for the sort operand are returned at the end of the list.

" - }, - "Limit":{ - "shape":"PositiveInteger", - "documentation":"

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. The maximum number of results returned is 20, even if this value is not set or is set higher than 20.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To start at the beginning of the result set, do not specify a value.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "SearchGameSessionsOutput":{ - "type":"structure", - "members":{ - "GameSessions":{ - "shape":"GameSessionList", - "documentation":"

Collection of objects containing game session properties for each session matching the request.

" - }, - "NextToken":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Token that indicates where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ServerProcess":{ - "type":"structure", - "required":[ - "LaunchPath", - "ConcurrentExecutions" - ], - "members":{ - "LaunchPath":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Location of the server executable in a game build. All game builds are installed on instances at the root : for Windows instances C:\\game, and for Linux instances /local/game. A Windows game build with an executable file located at MyGame\\latest\\server.exe must have a launch path of \"C:\\game\\MyGame\\latest\\server.exe\". A Linux game build with an executable file located at MyGame/latest/server.exe must have a launch path of \"/local/game/MyGame/latest/server.exe\".

" - }, - "Parameters":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Optional list of parameters to pass to the server executable on launch.

" - }, - "ConcurrentExecutions":{ - "shape":"PositiveInteger", - "documentation":"

Number of server processes using this configuration to run concurrently on an instance.

" - } - }, - "documentation":"

A set of instructions for launching server processes on each instance in a fleet. Each instruction set identifies the location of the server executable, optional launch parameters, and the number of server processes with this configuration to maintain concurrently on the instance. Server process configurations make up a fleet's RuntimeConfiguration .

" - }, - "ServerProcessList":{ - "type":"list", - "member":{"shape":"ServerProcess"}, - "max":50, - "min":1 - }, - "SnsArnStringModel":{ - "type":"string", - "max":300, - "min":0, - "pattern":"[a-zA-Z0-9:_/-]*" - }, - "StartFleetActionsInput":{ - "type":"structure", - "required":[ - "FleetId", - "Actions" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet

" - }, - "Actions":{ - "shape":"FleetActionList", - "documentation":"

List of actions to restart on the fleet.

" - } - } - }, - "StartFleetActionsOutput":{ - "type":"structure", - "members":{ - } - }, - "StartGameSessionPlacementInput":{ - "type":"structure", - "required":[ - "PlacementId", - "GameSessionQueueName", - "MaximumPlayerSessionCount" - ], - "members":{ - "PlacementId":{ - "shape":"IdStringModel", - "documentation":"

Unique identifier to assign to the new game session placement. This value is developer-defined. The value must be unique across all regions and cannot be reused unless you are resubmitting a canceled or timed-out placement request.

" - }, - "GameSessionQueueName":{ - "shape":"GameSessionQueueName", - "documentation":"

Name of the queue to use to place the new game session.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of players that can be connected simultaneously to the game session.

" - }, - "GameSessionName":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a game session. Session names do not need to be unique.

" - }, - "PlayerLatencies":{ - "shape":"PlayerLatencyList", - "documentation":"

Set of values, expressed in milliseconds, indicating the amount of latency that a player experiences when connected to AWS regions. This information is used to try to place the new game session where it can offer the best possible gameplay experience for the players.

" - }, - "DesiredPlayerSessions":{ - "shape":"DesiredPlayerSessionList", - "documentation":"

Set of information on each player to create a player session for.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session).

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "StartGameSessionPlacementOutput":{ - "type":"structure", - "members":{ - "GameSessionPlacement":{ - "shape":"GameSessionPlacement", - "documentation":"

Object that describes the newly created game session placement. This object includes all the information provided in the request, as well as start/end time stamps and placement status.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "StartMatchBackfillInput":{ - "type":"structure", - "required":[ - "ConfigurationName", - "GameSessionArn", - "Players" - ], - "members":{ - "TicketId":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking ticket. If no ticket ID is specified here, Amazon GameLift will generate one in the form of a UUID. Use this identifier to track the match backfill ticket status and retrieve match results.

" - }, - "ConfigurationName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Name of the matchmaker to use for this request. The name of the matchmaker that was used with the original game session is listed in the GameSession object, MatchmakerData property. This property contains a matchmaking configuration ARN value, which includes the matchmaker name. (In the ARN value \"arn:aws:gamelift:us-west-2:111122223333:matchmakingconfiguration/MM-4v4\", the matchmaking configuration name is \"MM-4v4\".) Use only the name for this parameter.

" - }, - "GameSessionArn":{ - "shape":"ArnStringModel", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session and uniquely identifies it.

" - }, - "Players":{ - "shape":"PlayerList", - "documentation":"

Match information on all players that are currently assigned to the game session. This information is used by the matchmaker to find new players and add them to the existing game.

  • PlayerID, PlayerAttributes, Team -\\\\- This information is maintained in the GameSession object, MatchmakerData property, for all players who are currently assigned to the game session. The matchmaker data is in JSON syntax, formatted as a string. For more details, see Match Data.

  • LatencyInMs -\\\\- If the matchmaker uses player latency, include a latency value, in milliseconds, for the region that the game session is currently in. Do not include latency values for any other region.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "StartMatchBackfillOutput":{ - "type":"structure", - "members":{ - "MatchmakingTicket":{ - "shape":"MatchmakingTicket", - "documentation":"

Ticket representing the backfill matchmaking request. This object includes the information in the request, ticket status, and match results as generated during the matchmaking process.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "StartMatchmakingInput":{ - "type":"structure", - "required":[ - "ConfigurationName", - "Players" - ], - "members":{ - "TicketId":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking ticket. If no ticket ID is specified here, Amazon GameLift will generate one in the form of a UUID. Use this identifier to track the matchmaking ticket status and retrieve match results.

" - }, - "ConfigurationName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Name of the matchmaking configuration to use for this request. Matchmaking configurations must exist in the same region as this request.

" - }, - "Players":{ - "shape":"PlayerList", - "documentation":"

Information on each player to be matched. This information must include a player ID, and may contain player attributes and latency data to be used in the matchmaking process. After a successful match, Player objects contain the name of the team the player is assigned to.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "StartMatchmakingOutput":{ - "type":"structure", - "members":{ - "MatchmakingTicket":{ - "shape":"MatchmakingTicket", - "documentation":"

Ticket representing the matchmaking request. This object include the information included in the request, ticket status, and match results as generated during the matchmaking process.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "StopFleetActionsInput":{ - "type":"structure", - "required":[ - "FleetId", - "Actions" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet

" - }, - "Actions":{ - "shape":"FleetActionList", - "documentation":"

List of actions to suspend on the fleet.

" - } - } - }, - "StopFleetActionsOutput":{ - "type":"structure", - "members":{ - } - }, - "StopGameSessionPlacementInput":{ - "type":"structure", - "required":["PlacementId"], - "members":{ - "PlacementId":{ - "shape":"IdStringModel", - "documentation":"

Unique identifier for a game session placement to cancel.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "StopGameSessionPlacementOutput":{ - "type":"structure", - "members":{ - "GameSessionPlacement":{ - "shape":"GameSessionPlacement", - "documentation":"

Object that describes the canceled game session placement, with CANCELLED status and an end time stamp.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "StopMatchmakingInput":{ - "type":"structure", - "required":["TicketId"], - "members":{ - "TicketId":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking ticket.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "StopMatchmakingOutput":{ - "type":"structure", - "members":{ - } - }, - "StringDoubleMap":{ - "type":"map", - "key":{"shape":"NonZeroAndMaxString"}, - "value":{"shape":"DoubleObject"} - }, - "StringList":{ - "type":"list", - "member":{"shape":"NonZeroAndMaxString"} - }, - "StringModel":{"type":"string"}, - "TargetConfiguration":{ - "type":"structure", - "required":["TargetValue"], - "members":{ - "TargetValue":{ - "shape":"Double", - "documentation":"

Desired value to use with a target-based scaling policy. The value must be relevant for whatever metric the scaling policy is using. For example, in a policy using the metric PercentAvailableGameSessions, the target value should be the preferred size of the fleet's buffer (the percent of capacity that should be idle and ready for new game sessions).

" - } - }, - "documentation":"

Settings for a target-based scaling policy (see ScalingPolicy. A target-based policy tracks a particular fleet metric specifies a target value for the metric. As player usage changes, the policy triggers Amazon GameLift to adjust capacity so that the metric returns to the target value. The target configuration specifies settings as needed for the target based policy, including the target value.

Operations related to fleet capacity scaling include:

" - }, - "TerminalRoutingStrategyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The service is unable to resolve the routing for a particular alias because it has a terminal RoutingStrategy associated with it. The message returned in this exception is the message defined in the routing strategy itself. Such requests should only be retried if the routing strategy for the specified alias is modified.

", - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The client failed authentication. Clients should not retry such requests.

", - "exception":true - }, - "UnsupportedRegionException":{ - "type":"structure", - "members":{ - "Message":{"shape":"NonEmptyString"} - }, - "documentation":"

The requested operation is not supported in the region specified.

", - "exception":true - }, - "UpdateAliasInput":{ - "type":"structure", - "required":["AliasId"], - "members":{ - "AliasId":{ - "shape":"AliasId", - "documentation":"

Unique identifier for a fleet alias. Specify the alias you want to update.

" - }, - "Name":{ - "shape":"NonBlankAndLengthConstraintString", - "documentation":"

Descriptive label that is associated with an alias. Alias names do not need to be unique.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Human-readable description of an alias.

" - }, - "RoutingStrategy":{ - "shape":"RoutingStrategy", - "documentation":"

Object that specifies the fleet and routing type to use for the alias.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateAliasOutput":{ - "type":"structure", - "members":{ - "Alias":{ - "shape":"Alias", - "documentation":"

Object that contains the updated alias configuration.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateBuildInput":{ - "type":"structure", - "required":["BuildId"], - "members":{ - "BuildId":{ - "shape":"BuildId", - "documentation":"

Unique identifier for a build to update.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a build. Build names do not need to be unique.

" - }, - "Version":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Version that is associated with this build. Version strings do not need to be unique.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateBuildOutput":{ - "type":"structure", - "members":{ - "Build":{ - "shape":"Build", - "documentation":"

Object that contains the updated build record.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateFleetAttributesInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to update attribute metadata for.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a fleet. Fleet names do not need to be unique.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Human-readable description of a fleet.

" - }, - "NewGameSessionProtectionPolicy":{ - "shape":"ProtectionPolicy", - "documentation":"

Game session protection policy to apply to all new instances created in this fleet. Instances that already exist are not affected. You can set protection for individual instances using UpdateGameSession.

  • NoProtection -- The game session can be terminated during a scale-down event.

  • FullProtection -- If the game session is in an ACTIVE status, it cannot be terminated during a scale-down event.

" - }, - "ResourceCreationLimitPolicy":{ - "shape":"ResourceCreationLimitPolicy", - "documentation":"

Policy that limits the number of game sessions an individual player can create over a span of time.

" - }, - "MetricGroups":{ - "shape":"MetricGroupList", - "documentation":"

Names of metric groups to include this fleet in. Amazon CloudWatch uses a fleet metric group is to aggregate metrics from multiple fleets. Use an existing metric group name to add this fleet to the group. Or use a new name to create a new metric group. A fleet can only be included in one metric group at a time.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateFleetAttributesOutput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that was updated.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateFleetCapacityInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to update capacity for.

" - }, - "DesiredInstances":{ - "shape":"WholeNumber", - "documentation":"

Number of EC2 instances you want this fleet to host.

" - }, - "MinSize":{ - "shape":"WholeNumber", - "documentation":"

Minimum value allowed for the fleet's instance count. Default if not set is 0.

" - }, - "MaxSize":{ - "shape":"WholeNumber", - "documentation":"

Maximum value allowed for the fleet's instance count. Default if not set is 1.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateFleetCapacityOutput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that was updated.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateFleetPortSettingsInput":{ - "type":"structure", - "required":["FleetId"], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to update port settings for.

" - }, - "InboundPermissionAuthorizations":{ - "shape":"IpPermissionsList", - "documentation":"

Collection of port settings to be added to the fleet record.

" - }, - "InboundPermissionRevocations":{ - "shape":"IpPermissionsList", - "documentation":"

Collection of port settings to be removed from the fleet record.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateFleetPortSettingsOutput":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet that was updated.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateGameSessionInput":{ - "type":"structure", - "required":["GameSessionId"], - "members":{ - "GameSessionId":{ - "shape":"ArnStringModel", - "documentation":"

Unique identifier for the game session to update.

" - }, - "MaximumPlayerSessionCount":{ - "shape":"WholeNumber", - "documentation":"

Maximum number of players that can be connected simultaneously to the game session.

" - }, - "Name":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with a game session. Session names do not need to be unique.

" - }, - "PlayerSessionCreationPolicy":{ - "shape":"PlayerSessionCreationPolicy", - "documentation":"

Policy determining whether or not the game session accepts new players.

" - }, - "ProtectionPolicy":{ - "shape":"ProtectionPolicy", - "documentation":"

Game session protection policy to apply to this game session only.

  • NoProtection -- The game session can be terminated during a scale-down event.

  • FullProtection -- If the game session is in an ACTIVE status, it cannot be terminated during a scale-down event.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateGameSessionOutput":{ - "type":"structure", - "members":{ - "GameSession":{ - "shape":"GameSession", - "documentation":"

Object that contains the updated game session metadata.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateGameSessionQueueInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"GameSessionQueueName", - "documentation":"

Descriptive label that is associated with game session queue. Queue names must be unique within each region.

" - }, - "TimeoutInSeconds":{ - "shape":"WholeNumber", - "documentation":"

Maximum time, in seconds, that a new game session placement request remains in the queue. When a request exceeds this time, the game session placement changes to a TIMED_OUT status.

" - }, - "PlayerLatencyPolicies":{ - "shape":"PlayerLatencyPolicyList", - "documentation":"

Collection of latency policies to apply when processing game sessions placement requests with player latency information. Multiple policies are evaluated in order of the maximum latency value, starting with the lowest latency values. With just one policy, it is enforced at the start of the game session placement for the duration period. With multiple policies, each policy is enforced consecutively for its duration period. For example, a queue might enforce a 60-second policy followed by a 120-second policy, and then no policy for the remainder of the placement. When updating policies, provide a complete collection of policies.

" - }, - "Destinations":{ - "shape":"GameSessionQueueDestinationList", - "documentation":"

List of fleets that can be used to fulfill game session placement requests in the queue. Fleets are identified by either a fleet ARN or a fleet alias ARN. Destinations are listed in default preference order. When updating this list, provide a complete list of destinations.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateGameSessionQueueOutput":{ - "type":"structure", - "members":{ - "GameSessionQueue":{ - "shape":"GameSessionQueue", - "documentation":"

Object that describes the newly updated game session queue.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateMatchmakingConfigurationInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking configuration to update.

" - }, - "Description":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Descriptive label that is associated with matchmaking configuration.

" - }, - "GameSessionQueueArns":{ - "shape":"QueueArnsList", - "documentation":"

Amazon Resource Name (ARN) that is assigned to a game session queue and uniquely identifies it. Format is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. These queues are used when placing game sessions for matches that are created with this matchmaking configuration. Queues can be located in any region.

" - }, - "RequestTimeoutSeconds":{ - "shape":"MatchmakingRequestTimeoutInteger", - "documentation":"

Maximum duration, in seconds, that a matchmaking ticket can remain in process before timing out. Requests that time out can be resubmitted as needed.

" - }, - "AcceptanceTimeoutSeconds":{ - "shape":"MatchmakingAcceptanceTimeoutInteger", - "documentation":"

Length of time (in seconds) to wait for players to accept a proposed match. If any player rejects the match or fails to accept before the timeout, the ticket continues to look for an acceptable match.

" - }, - "AcceptanceRequired":{ - "shape":"BooleanModel", - "documentation":"

Flag that determines whether or not a match that was created with this configuration must be accepted by the matched players. To require acceptance, set to TRUE.

" - }, - "RuleSetName":{ - "shape":"MatchmakingIdStringModel", - "documentation":"

Unique identifier for a matchmaking rule set to use with this configuration. A matchmaking configuration can only use rule sets that are defined in the same region.

" - }, - "NotificationTarget":{ - "shape":"SnsArnStringModel", - "documentation":"

SNS topic ARN that is set up to receive matchmaking notifications. See Setting up Notifications for Matchmaking for more information.

" - }, - "AdditionalPlayerCount":{ - "shape":"WholeNumber", - "documentation":"

Number of player slots in a match to keep open for future players. For example, if the configuration's rule set specifies a match for a single 12-person team, and the additional player count is set to 2, only 10 players are selected for the match.

" - }, - "CustomEventData":{ - "shape":"CustomEventData", - "documentation":"

Information to attached to all events related to the matchmaking configuration.

" - }, - "GameProperties":{ - "shape":"GamePropertyList", - "documentation":"

Set of custom properties for a game session, formatted as key:value pairs. These properties are passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - }, - "GameSessionData":{ - "shape":"GameSessionData", - "documentation":"

Set of custom game session properties, formatted as a single string value. This data is passed to a game server process in the GameSession object with a request to start a new game session (see Start a Game Session). This information is added to the new GameSession object that is created for a successful match.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateMatchmakingConfigurationOutput":{ - "type":"structure", - "members":{ - "Configuration":{ - "shape":"MatchmakingConfiguration", - "documentation":"

Object that describes the updated matchmaking configuration.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "UpdateRuntimeConfigurationInput":{ - "type":"structure", - "required":[ - "FleetId", - "RuntimeConfiguration" - ], - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet to update run-time configuration for.

" - }, - "RuntimeConfiguration":{ - "shape":"RuntimeConfiguration", - "documentation":"

Instructions for launching server processes on each instance in the fleet. The run-time configuration for a fleet has a collection of server process configurations, one for each type of server process to run on an instance. A server process configuration specifies the location of the server executable, launch parameters, and the number of concurrent processes with that configuration to maintain on each instance.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "UpdateRuntimeConfigurationOutput":{ - "type":"structure", - "members":{ - "RuntimeConfiguration":{ - "shape":"RuntimeConfiguration", - "documentation":"

The run-time configuration currently in force. If the update was successful, this object matches the one in the request.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "ValidateMatchmakingRuleSetInput":{ - "type":"structure", - "required":["RuleSetBody"], - "members":{ - "RuleSetBody":{ - "shape":"RuleSetBody", - "documentation":"

Collection of matchmaking rules to validate, formatted as a JSON string.

" - } - }, - "documentation":"

Represents the input for a request action.

" - }, - "ValidateMatchmakingRuleSetOutput":{ - "type":"structure", - "members":{ - "Valid":{ - "shape":"BooleanModel", - "documentation":"

Response indicating whether or not the rule set is valid.

" - } - }, - "documentation":"

Represents the returned data in response to a request action.

" - }, - "VpcPeeringAuthorization":{ - "type":"structure", - "members":{ - "GameLiftAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the AWS account that you use to manage your Amazon GameLift fleet. You can find your Account ID in the AWS Management Console under account settings.

" - }, - "PeerVpcAwsAccountId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this authorization was issued. Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - }, - "ExpirationTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp indicating when this authorization expires (24 hours after issuance). Format is a number expressed in Unix time as milliseconds (for example \"1469498468.057\").

" - } - }, - "documentation":"

Represents an authorization for a VPC peering connection between the VPC for an Amazon GameLift fleet and another VPC on an account you have access to. This authorization must exist and be valid for the peering connection to be established. Authorizations are valid for 24 hours after they are issued.

VPC peering connection operations include:

" - }, - "VpcPeeringAuthorizationList":{ - "type":"list", - "member":{"shape":"VpcPeeringAuthorization"} - }, - "VpcPeeringConnection":{ - "type":"structure", - "members":{ - "FleetId":{ - "shape":"FleetId", - "documentation":"

Unique identifier for a fleet. This ID determines the ID of the Amazon GameLift VPC for your fleet.

" - }, - "IpV4CidrBlock":{ - "shape":"NonZeroAndMaxString", - "documentation":"

CIDR block of IPv4 addresses assigned to the VPC peering connection for the GameLift VPC. The peered VPC also has an IPv4 CIDR block associated with it; these blocks cannot overlap or the peering connection cannot be created.

" - }, - "VpcPeeringConnectionId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier that is automatically assigned to the connection record. This ID is referenced in VPC peering connection events, and is used when deleting a connection with DeleteVpcPeeringConnection.

" - }, - "Status":{ - "shape":"VpcPeeringConnectionStatus", - "documentation":"

Object that contains status information about the connection. Status indicates if a connection is pending, successful, or failed.

" - }, - "PeerVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same region where your fleet is deployed. To get VPC information, including IDs, use the Virtual Private Cloud service tools, including the VPC Dashboard in the AWS Management Console.

" - }, - "GameLiftVpcId":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Unique identifier for the VPC that contains the Amazon GameLift fleet for this connection. This VPC is managed by Amazon GameLift and does not appear in your AWS account.

" - } - }, - "documentation":"

Represents a peering connection between a VPC on one of your AWS accounts and the VPC for your Amazon GameLift fleets. This record may be for an active peering connection or a pending connection that has not yet been established.

VPC peering connection operations include:

" - }, - "VpcPeeringConnectionList":{ - "type":"list", - "member":{"shape":"VpcPeeringConnection"} - }, - "VpcPeeringConnectionStatus":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Code indicating the status of a VPC peering connection.

" - }, - "Message":{ - "shape":"NonZeroAndMaxString", - "documentation":"

Additional messaging associated with the connection status.

" - } - }, - "documentation":"

Represents status information for a VPC peering connection. Status is associated with a VpcPeeringConnection object. Status codes and messages are provided from EC2 (see VpcPeeringConnectionStateReason). Connection status information is also communicated as a fleet Event.

" - }, - "WholeNumber":{ - "type":"integer", - "min":0 - } - }, - "documentation":"Amazon GameLift Service

Amazon GameLift is a managed service for developers who need a scalable, dedicated server solution for their multiplayer games. Use Amazon GameLift for these tasks: (1) set up computing resources and deploy your game servers, (2) run game sessions and get players into games, (3) automatically scale your resources to meet player demand and manage costs, and (4) track in-depth metrics on game server performance and player usage.

The Amazon GameLift service API includes two important function sets:

  • Manage game sessions and player access -- Retrieve information on available game sessions; create new game sessions; send player requests to join a game session.

  • Configure and manage game server resources -- Manage builds, fleets, queues, and aliases; set auto-scaling policies; retrieve logs and metrics.

This reference guide describes the low-level service API for Amazon GameLift. You can use the API functionality with these tools:

  • The Amazon Web Services software development kit (AWS SDK) is available in multiple languages including C++ and C#. Use the SDK to access the API programmatically from an application, such as a game client.

  • The AWS command-line interface (CLI) tool is primarily useful for handling administrative actions, such as setting up and managing Amazon GameLift settings and resources. You can use the AWS CLI to manage all of your AWS services.

  • The AWS Management Console for Amazon GameLift provides a web interface to manage your Amazon GameLift settings and resources. The console includes a dashboard for tracking key resources, including builds and fleets, and displays usage and performance metrics for your games as customizable graphs.

  • Amazon GameLift Local is a tool for testing your game's integration with Amazon GameLift before deploying it on the service. This tools supports a subset of key API actions, which can be called from either the AWS CLI or programmatically. See Testing an Integration.

Learn more

API SUMMARY

This list offers a functional overview of the Amazon GameLift service API.

Managing Games and Players

Use these actions to start new game sessions, find existing game sessions, track game session status and other information, and enable player access to game sessions.

  • Discover existing game sessions

    • SearchGameSessions -- Retrieve all available game sessions or search for game sessions that match a set of criteria.

  • Start new game sessions

    • Start new games with Queues to find the best available hosting resources across multiple regions, minimize player latency, and balance game session activity for efficiency and cost effectiveness.

    • CreateGameSession -- Start a new game session on a specific fleet. Available in Amazon GameLift Local.

  • Match players to game sessions with FlexMatch matchmaking

    • StartMatchmaking -- Request matchmaking for one players or a group who want to play together.

    • StartMatchBackfill - Request additional player matches to fill empty slots in an existing game session.

    • DescribeMatchmaking -- Get details on a matchmaking request, including status.

    • AcceptMatch -- Register that a player accepts a proposed match, for matches that require player acceptance.

    • StopMatchmaking -- Cancel a matchmaking request.

  • Manage game session data

    • DescribeGameSessions -- Retrieve metadata for one or more game sessions, including length of time active and current player count. Available in Amazon GameLift Local.

    • DescribeGameSessionDetails -- Retrieve metadata and the game session protection setting for one or more game sessions.

    • UpdateGameSession -- Change game session settings, such as maximum player count and join policy.

    • GetGameSessionLogUrl -- Get the location of saved logs for a game session.

  • Manage player sessions

    • CreatePlayerSession -- Send a request for a player to join a game session. Available in Amazon GameLift Local.

    • CreatePlayerSessions -- Send a request for multiple players to join a game session. Available in Amazon GameLift Local.

    • DescribePlayerSessions -- Get details on player activity, including status, playing time, and player data. Available in Amazon GameLift Local.

Setting Up and Managing Game Servers

When setting up Amazon GameLift resources for your game, you first create a game build and upload it to Amazon GameLift. You can then use these actions to configure and manage a fleet of resources to run your game servers, scale capacity to meet player demand, access performance and utilization metrics, and more.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/examples-1.json deleted file mode 100644 index 7ecea259..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/examples-1.json +++ /dev/null @@ -1,806 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AbortMultipartUpload": [ - { - "input": { - "accountId": "-", - "uploadId": "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ", - "vaultName": "my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example deletes an in-progress multipart upload to a vault named my-vault:", - "id": "f3d907f6-e71c-420c-8f71-502346a2c48a", - "title": "To abort a multipart upload identified by the upload ID" - } - ], - "AbortVaultLock": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example aborts the vault locking process if the vault lock is not in the Locked state for the vault named examplevault.", - "id": "to-abort-a-vault-lock-1481839357947", - "title": "To abort a vault lock" - } - ], - "AddTagsToVault": [ - { - "input": { - "Tags": { - "examplekey1": "examplevalue1", - "examplekey2": "examplevalue2" - }, - "accountId": "-", - "vaultName": "my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example adds two tags to a my-vault.", - "id": "add-tags-to-vault-post-tags-add-1481663457694", - "title": "To add tags to a vault" - } - ], - "CompleteMultipartUpload": [ - { - "input": { - "accountId": "-", - "archiveSize": "3145728", - "checksum": "9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67", - "uploadId": "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ", - "vaultName": "my-vault" - }, - "output": { - "archiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", - "checksum": "9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67", - "location": "/111122223333/vaults/my-vault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example completes a multipart upload for a 3 MiB archive.", - "id": "272aa0b8-e44c-4a64-add2-ad905a37984d", - "title": "To complete a multipart upload" - } - ], - "CompleteVaultLock": [ - { - "input": { - "accountId": "-", - "lockId": "AE863rKkWZU53SLW5be4DUcW", - "vaultName": "example-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example completes the vault locking process by transitioning the vault lock from the InProgress state to the Locked state.", - "id": "to-complete-a-vault-lock-1481839721312", - "title": "To complete a vault lock" - } - ], - "CreateVault": [ - { - "input": { - "accountId": "-", - "vaultName": "my-vault" - }, - "output": { - "location": "/111122223333/vaults/my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a new vault named my-vault.", - "id": "1dc0313d-ace1-4e6c-9d13-1ec7813b14b7", - "title": "To create a new vault" - } - ], - "DeleteArchive": [ - { - "input": { - "accountId": "-", - "archiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example deletes the archive specified by the archive ID.", - "id": "delete-archive-1481667809463", - "title": "To delete an archive" - } - ], - "DeleteVault": [ - { - "input": { - "accountId": "-", - "vaultName": "my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example deletes a vault named my-vault:", - "id": "7f7f000b-4bdb-40d2-91e6-7c902f60f60f", - "title": "To delete a vault" - } - ], - "DeleteVaultAccessPolicy": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example deletes the access policy associated with the vault named examplevault.", - "id": "to-delete-the-vault-access-policy-1481840424677", - "title": "To delete the vault access policy" - } - ], - "DeleteVaultNotifications": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example deletes the notification configuration set for the vault named examplevault.", - "id": "to-delete-the-notification-configuration-set-for-a-vault-1481840646090", - "title": "To delete the notification configuration set for a vault" - } - ], - "DescribeJob": [ - { - "input": { - "accountId": "-", - "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4Cn", - "vaultName": "my-vault" - }, - "output": { - "Action": "InventoryRetrieval", - "Completed": false, - "CreationDate": "2015-07-17T20:23:41.616Z", - "InventoryRetrievalParameters": { - "Format": "JSON" - }, - "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", - "StatusCode": "InProgress", - "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example returns information about the previously initiated job specified by the job ID.", - "id": "to-get-information-about-a-job-you-previously-initiated-1481840928592", - "title": "To get information about a previously initiated job" - } - ], - "DescribeVault": [ - { - "input": { - "accountId": "-", - "vaultName": "my-vault" - }, - "output": { - "CreationDate": "2016-09-23T19:27:18.665Z", - "NumberOfArchives": 0, - "SizeInBytes": 0, - "VaultARN": "arn:aws:glacier:us-west-2:111122223333:vaults/my-vault", - "VaultName": "my-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example retrieves data about a vault named my-vault.", - "id": "3c1c6e9d-f5a2-427a-aa6a-f439eacfc05f", - "title": "To retrieve information about a vault" - } - ], - "GetDataRetrievalPolicy": [ - { - "input": { - "accountId": "-" - }, - "output": { - "Policy": { - "Rules": [ - { - "BytesPerHour": 10737418240, - "Strategy": "BytesPerHour" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example returns the current data retrieval policy for the account.", - "id": "to-get-the-current-data-retrieval-policy-for-the-account-1481851580439", - "title": "To get the current data retrieval policy for an account" - } - ], - "GetJobOutput": [ - { - "input": { - "accountId": "-", - "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", - "range": "", - "vaultName": "my-vaul" - }, - "output": { - "acceptRanges": "bytes", - "body": "inventory-data", - "contentType": "application/json", - "status": 200 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example downloads the output of a previously initiated inventory retrieval job that is identified by the job ID.", - "id": "to-get-the-output-of-a-previously-initiated-job-1481848550859", - "title": "To get the output of a previously initiated job" - } - ], - "GetVaultAccessPolicy": [ - { - "input": { - "accountId": "-", - "vaultName": "example-vault" - }, - "output": { - "policy": { - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example retrieves the access-policy set on the vault named example-vault.", - "id": "to--get-the-access-policy-set-on-the-vault-1481936004590", - "title": "To get the access-policy set on the vault" - } - ], - "GetVaultLock": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "output": { - "CreationDate": "exampledate", - "ExpirationDate": "exampledate", - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}", - "State": "InProgress" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example retrieves the attributes from the lock-policy subresource set on the vault named examplevault.", - "id": "to-retrieve-vault-lock-policy-related-attributes-that-are-set-on-a-vault-1481851363097", - "title": "To retrieve vault lock-policy related attributes that are set on a vault" - } - ], - "GetVaultNotifications": [ - { - "input": { - "accountId": "-", - "vaultName": "my-vault" - }, - "output": { - "vaultNotificationConfig": { - "Events": [ - "InventoryRetrievalCompleted", - "ArchiveRetrievalCompleted" - ], - "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example retrieves the notification-configuration for the vault named my-vault.", - "id": "to-get-the-notification-configuration-for-the-specified-vault-1481918746677", - "title": "To get the notification-configuration for the specified vault" - } - ], - "InitiateJob": [ - { - "input": { - "accountId": "-", - "jobParameters": { - "Description": "My inventory job", - "Format": "CSV", - "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example", - "Type": "inventory-retrieval" - }, - "vaultName": "examplevault" - }, - "output": { - "jobId": " HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", - "location": "/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example initiates an inventory-retrieval job for the vault named examplevault.", - "id": "to-initiate-an-inventory-retrieval-job-1482186883826", - "title": "To initiate an inventory-retrieval job" - } - ], - "InitiateMultipartUpload": [ - { - "input": { - "accountId": "-", - "partSize": "1048576", - "vaultName": "my-vault" - }, - "output": { - "location": "/111122223333/vaults/my-vault/multipart-uploads/19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ", - "uploadId": "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example initiates a multipart upload to a vault named my-vault with a part size of 1 MiB (1024 x 1024 bytes) per file.", - "id": "72f2db19-3d93-4c74-b2ed-38703baacf49", - "title": "To initiate a multipart upload" - } - ], - "InitiateVaultLock": [ - { - "input": { - "accountId": "-", - "policy": { - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}" - }, - "vaultName": "my-vault" - }, - "output": { - "lockId": "AE863rKkWZU53SLW5be4DUcW" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example initiates the vault locking process for the vault named my-vault.", - "id": "to-initiate-the-vault-locking-process-1481919693394", - "title": "To initiate the vault locking process" - } - ], - "ListJobs": [ - { - "input": { - "accountId": "-", - "vaultName": "my-vault" - }, - "output": { - "JobList": [ - { - "Action": "ArchiveRetrieval", - "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", - "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", - "ArchiveSizeInBytes": 3145728, - "Completed": false, - "CreationDate": "2015-07-17T21:16:13.840Z", - "JobDescription": "Retrieve archive on 2015-07-17", - "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", - "RetrievalByteRange": "0-3145727", - "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", - "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", - "StatusCode": "InProgress", - "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault" - }, - { - "Action": "InventoryRetrieval", - "Completed": false, - "CreationDate": "2015-07-17T20:23:41.616Z", - "InventoryRetrievalParameters": { - "Format": "JSON" - }, - "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", - "StatusCode": "InProgress", - "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists jobs for the vault named my-vault.", - "id": "to-list-jobs-for-a-vault-1481920530537", - "title": "To list jobs for a vault" - } - ], - "ListMultipartUploads": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "output": { - "Marker": "null", - "UploadsList": [ - { - "ArchiveDescription": "archive 1", - "CreationDate": "2012-03-19T23:20:59.130Z", - "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev", - "PartSizeInBytes": 4194304, - "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" - }, - { - "ArchiveDescription": "archive 2", - "CreationDate": "2012-04-01T15:00:00.000Z", - "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", - "PartSizeInBytes": 4194304, - "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" - }, - { - "ArchiveDescription": "archive 3", - "CreationDate": "2012-03-20T17:03:43.221Z", - "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", - "PartSizeInBytes": 4194304, - "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists all the in-progress multipart uploads for the vault named examplevault.", - "id": "to-list-all-the-in-progress-multipart-uploads-for-a-vault-1481935250590", - "title": "To list all the in-progress multipart uploads for a vault" - } - ], - "ListParts": [ - { - "input": { - "accountId": "-", - "uploadId": "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", - "vaultName": "examplevault" - }, - "output": { - "ArchiveDescription": "archive description", - "CreationDate": "2012-03-20T17:03:43.221Z", - "Marker": "null", - "MultipartUploadId": "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", - "PartSizeInBytes": 4194304, - "Parts": [ - { - "RangeInBytes": "0-4194303", - "SHA256TreeHash": "01d34dabf7be316472c93b1ef80721f5d4" - }, - { - "RangeInBytes": "4194304-8388607", - "SHA256TreeHash": "0195875365afda349fc21c84c099987164" - } - ], - "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists all the parts of a multipart upload.", - "id": "to-list-the-parts-of-an-archive-that-have-been-uploaded-in-a-multipart-upload-1481921767590", - "title": "To list the parts of an archive that have been uploaded in a multipart upload" - } - ], - "ListProvisionedCapacity": [ - { - "input": { - "accountId": "-" - }, - "output": { - "ProvisionedCapacityList": [ - { - "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z", - "ExpirationDate": "2016-12-12T00:00:00.000Z", - "StartDate": "2016-11-11T20:11:51.095Z" - }, - { - "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z", - "ExpirationDate": "2017-01-15T00:00:00.000Z", - "StartDate": "2016-12-13T20:11:51.095Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists the provisioned capacity units for an account.", - "id": "to-list-the-provisioned-capacity-units-for-an-account-1481923656130", - "title": "To list the provisioned capacity units for an account" - } - ], - "ListTagsForVault": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault" - }, - "output": { - "Tags": { - "date": "july2015", - "id": "1234" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists all the tags attached to the vault examplevault.", - "id": "list-tags-for-vault-1481755839720", - "title": "To list the tags for a vault" - } - ], - "ListVaults": [ - { - "input": { - "accountId": "-", - "limit": "", - "marker": "" - }, - "output": { - "VaultList": [ - { - "CreationDate": "2015-04-06T21:23:45.708Z", - "LastInventoryDate": "2015-04-07T00:26:19.028Z", - "NumberOfArchives": 1, - "SizeInBytes": 3178496, - "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", - "VaultName": "my-vault" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example lists all vaults owned by the specified AWS account.", - "id": "list-vaults-1481753006990", - "title": "To list all vaults owned by the calling user's account" - } - ], - "PurchaseProvisionedCapacity": [ - { - "input": { - "accountId": "-" - }, - "output": { - "capacityId": "zSaq7NzHFQDANTfQkDen4V7z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example purchases provisioned capacity unit for an AWS account.", - "id": "to-purchases-a-provisioned-capacity-unit-for-an-aws-account-1481927446662", - "title": "To purchases a provisioned capacity unit for an AWS account" - } - ], - "RemoveTagsFromVault": [ - { - "input": { - "TagKeys": [ - "examplekey1", - "examplekey2" - ], - "accountId": "-", - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example removes two tags from the vault named examplevault.", - "id": "remove-tags-from-vault-1481754998801", - "title": "To remove tags from a vault" - } - ], - "SetDataRetrievalPolicy": [ - { - "input": { - "Policy": { - "Rules": [ - { - "BytesPerHour": 10737418240, - "Strategy": "BytesPerHour" - } - ] - }, - "accountId": "-" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example sets and then enacts a data retrieval policy.", - "id": "to-set-and-then-enact-a-data-retrieval-policy--1481928352408", - "title": "To set and then enact a data retrieval policy " - } - ], - "SetVaultAccessPolicy": [ - { - "input": { - "accountId": "-", - "policy": { - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}" - }, - "vaultName": "examplevault" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example configures an access policy for the vault named examplevault.", - "id": "to--set-the-access-policy-on-a-vault-1482185872517", - "title": "To set the access-policy on a vault" - } - ], - "SetVaultNotifications": [ - { - "input": { - "accountId": "-", - "vaultName": "examplevault", - "vaultNotificationConfig": { - "Events": [ - "ArchiveRetrievalCompleted", - "InventoryRetrievalCompleted" - ], - "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example sets the examplevault notification configuration.", - "id": "to-configure-a-vault-to-post-a-message-to-an-amazon-simple-notification-service-amazon-sns-topic-when-jobs-complete-1482186397475", - "title": "To configure a vault to post a message to an Amazon SNS topic when jobs complete" - } - ], - "UploadArchive": [ - { - "input": { - "accountId": "-", - "archiveDescription": "", - "body": "example-data-to-upload", - "checksum": "", - "vaultName": "my-vault" - }, - "output": { - "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", - "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", - "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example adds an archive to a vault.", - "id": "upload-archive-1481668510494", - "title": "To upload an archive" - } - ], - "UploadMultipartPart": [ - { - "input": { - "accountId": "-", - "body": "part1", - "checksum": "c06f7cd4baacb087002a99a5f48bf953", - "range": "bytes 0-1048575/*", - "uploadId": "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ", - "vaultName": "examplevault" - }, - "output": { - "checksum": "c06f7cd4baacb087002a99a5f48bf953" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The example uploads the first 1 MiB (1024 x 1024 bytes) part of an archive.", - "id": "to-upload-the-first-part-of-an-archive-1481835899519", - "title": "To upload the first part of an archive" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/paginators-1.json deleted file mode 100644 index 69691437..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "ListJobs": { - "input_token": "marker", - "output_token": "Marker", - "limit_key": "limit", - "result_key": "JobList" - }, - "ListMultipartUploads": { - "input_token": "marker", - "output_token": "Marker", - "limit_key": "limit", - "result_key": "UploadsList" - }, - "ListParts": { - "input_token": "marker", - "output_token": "Marker", - "limit_key": "limit", - "result_key": "Parts" - }, - "ListVaults": { - "input_token": "marker", - "output_token": "Marker", - "limit_key": "limit", - "result_key": "VaultList" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/service-2.json deleted file mode 100644 index 350983c2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/service-2.json +++ /dev/null @@ -1,2580 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-06-01", - "checksumFormat":"sha256", - "endpointPrefix":"glacier", - "protocol":"rest-json", - "serviceFullName":"Amazon Glacier", - "serviceId":"Glacier", - "signatureVersion":"v4", - "uid":"glacier-2012-06-01" - }, - "operations":{ - "AbortMultipartUpload":{ - "name":"AbortMultipartUpload", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads/{uploadId}", - "responseCode":204 - }, - "input":{"shape":"AbortMultipartUploadInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation aborts a multipart upload identified by the upload ID.

After the Abort Multipart Upload request succeeds, you cannot upload any more parts to the multipart upload or complete the multipart upload. Aborting a completed upload fails. However, aborting an already-aborted upload will succeed, for a short time. For more information about uploading a part and completing a multipart upload, see UploadMultipartPart and CompleteMultipartUpload.

This operation is idempotent.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Working with Archives in Amazon Glacier and Abort Multipart Upload in the Amazon Glacier Developer Guide.

" - }, - "AbortVaultLock":{ - "name":"AbortVaultLock", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}/lock-policy", - "responseCode":204 - }, - "input":{"shape":"AbortVaultLockInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation aborts the vault locking process if the vault lock is not in the Locked state. If the vault lock is in the Locked state when this operation is requested, the operation returns an AccessDeniedException error. Aborting the vault locking process removes the vault lock policy from the specified vault.

A vault lock is put into the InProgress state by calling InitiateVaultLock. A vault lock is put into the Locked state by calling CompleteVaultLock. You can get the state of a vault lock by calling GetVaultLock. For more information about the vault locking process, see Amazon Glacier Vault Lock. For more information about vault lock policies, see Amazon Glacier Access Control with Vault Lock Policies.

This operation is idempotent. You can successfully invoke this operation multiple times, if the vault lock is in the InProgress state or if there is no policy associated with the vault.

" - }, - "AddTagsToVault":{ - "name":"AddTagsToVault", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/tags?operation=add", - "responseCode":204 - }, - "input":{"shape":"AddTagsToVaultInput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation adds the specified tags to a vault. Each tag is composed of a key and a value. Each vault can have up to 10 tags. If your request would cause the tag limit for the vault to be exceeded, the operation throws the LimitExceededException error. If a tag already exists on the vault under a specified key, the existing key value will be overwritten. For more information about tags, see Tagging Amazon Glacier Resources.

" - }, - "CompleteMultipartUpload":{ - "name":"CompleteMultipartUpload", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads/{uploadId}", - "responseCode":201 - }, - "input":{"shape":"CompleteMultipartUploadInput"}, - "output":{"shape":"ArchiveCreationOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

You call this operation to inform Amazon Glacier that all the archive parts have been uploaded and that Amazon Glacier can now assemble the archive from the uploaded parts. After assembling and saving the archive to the vault, Amazon Glacier returns the URI path of the newly created archive resource. Using the URI path, you can then access the archive. After you upload an archive, you should save the archive ID returned to retrieve the archive at a later point. You can also get the vault inventory to obtain a list of archive IDs in a vault. For more information, see InitiateJob.

In the request, you must include the computed SHA256 tree hash of the entire archive you have uploaded. For information about computing a SHA256 tree hash, see Computing Checksums. On the server side, Amazon Glacier also constructs the SHA256 tree hash of the assembled archive. If the values match, Amazon Glacier saves the archive to the vault; otherwise, it returns an error, and the operation fails. The ListParts operation returns a list of parts uploaded for a specific multipart upload. It includes checksum information for each uploaded part that can be used to debug a bad checksum issue.

Additionally, Amazon Glacier also checks for any missing content ranges when assembling the archive, if missing content ranges are found, Amazon Glacier returns an error and the operation fails.

Complete Multipart Upload is an idempotent operation. After your first successful complete multipart upload, if you call the operation again within a short period, the operation will succeed and return the same archive ID. This is useful in the event you experience a network issue that causes an aborted connection or receive a 500 server error, in which case you can repeat your Complete Multipart Upload request and get the same archive ID without creating duplicate archives. Note, however, that after the multipart upload completes, you cannot call the List Parts operation and the multipart upload will not appear in List Multipart Uploads response, even if idempotent complete is possible.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Uploading Large Archives in Parts (Multipart Upload) and Complete Multipart Upload in the Amazon Glacier Developer Guide.

" - }, - "CompleteVaultLock":{ - "name":"CompleteVaultLock", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/lock-policy/{lockId}", - "responseCode":204 - }, - "input":{"shape":"CompleteVaultLockInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation completes the vault locking process by transitioning the vault lock from the InProgress state to the Locked state, which causes the vault lock policy to become unchangeable. A vault lock is put into the InProgress state by calling InitiateVaultLock. You can obtain the state of the vault lock by calling GetVaultLock. For more information about the vault locking process, Amazon Glacier Vault Lock.

This operation is idempotent. This request is always successful if the vault lock is in the Locked state and the provided lock ID matches the lock ID originally used to lock the vault.

If an invalid lock ID is passed in the request when the vault lock is in the Locked state, the operation returns an AccessDeniedException error. If an invalid lock ID is passed in the request when the vault lock is in the InProgress state, the operation throws an InvalidParameter error.

" - }, - "CreateVault":{ - "name":"CreateVault", - "http":{ - "method":"PUT", - "requestUri":"/{accountId}/vaults/{vaultName}", - "responseCode":201 - }, - "input":{"shape":"CreateVaultInput"}, - "output":{"shape":"CreateVaultOutput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

This operation creates a new vault with the specified name. The name of the vault must be unique within a region for an AWS account. You can create up to 1,000 vaults per account. If you need to create more vaults, contact Amazon Glacier.

You must use the following guidelines when naming a vault.

  • Names can be between 1 and 255 characters long.

  • Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.' (period).

This operation is idempotent.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Creating a Vault in Amazon Glacier and Create Vault in the Amazon Glacier Developer Guide.

" - }, - "DeleteArchive":{ - "name":"DeleteArchive", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}/archives/{archiveId}", - "responseCode":204 - }, - "input":{"shape":"DeleteArchiveInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation deletes an archive from a vault. Subsequent requests to initiate a retrieval of this archive will fail. Archive retrievals that are in progress for this archive ID may or may not succeed according to the following scenarios:

  • If the archive retrieval job is actively preparing the data for download when Amazon Glacier receives the delete archive request, the archival retrieval operation might fail.

  • If the archive retrieval job has successfully prepared the archive for download when Amazon Glacier receives the delete archive request, you will be able to download the output.

This operation is idempotent. Attempting to delete an already-deleted archive does not result in an error.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Deleting an Archive in Amazon Glacier and Delete Archive in the Amazon Glacier Developer Guide.

" - }, - "DeleteVault":{ - "name":"DeleteVault", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}", - "responseCode":204 - }, - "input":{"shape":"DeleteVaultInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation deletes a vault. Amazon Glacier will delete a vault only if there are no archives in the vault as of the last inventory and there have been no writes to the vault since the last inventory. If either of these conditions is not satisfied, the vault deletion fails (that is, the vault is not removed) and Amazon Glacier returns an error. You can use DescribeVault to return the number of archives in a vault, and you can use Initiate a Job (POST jobs) to initiate a new inventory retrieval for a vault. The inventory contains the archive IDs you use to delete archives using Delete Archive (DELETE archive).

This operation is idempotent.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Deleting a Vault in Amazon Glacier and Delete Vault in the Amazon Glacier Developer Guide.

" - }, - "DeleteVaultAccessPolicy":{ - "name":"DeleteVaultAccessPolicy", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}/access-policy", - "responseCode":204 - }, - "input":{"shape":"DeleteVaultAccessPolicyInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation deletes the access policy associated with the specified vault. The operation is eventually consistent; that is, it might take some time for Amazon Glacier to completely remove the access policy, and you might still see the effect of the policy for a short time after you send the delete request.

This operation is idempotent. You can invoke delete multiple times, even if there is no policy associated with the vault. For more information about vault access policies, see Amazon Glacier Access Control with Vault Access Policies.

" - }, - "DeleteVaultNotifications":{ - "name":"DeleteVaultNotifications", - "http":{ - "method":"DELETE", - "requestUri":"/{accountId}/vaults/{vaultName}/notification-configuration", - "responseCode":204 - }, - "input":{"shape":"DeleteVaultNotificationsInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation deletes the notification configuration set for a vault. The operation is eventually consistent; that is, it might take some time for Amazon Glacier to completely disable the notifications and you might still receive some notifications for a short time after you send the delete request.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Configuring Vault Notifications in Amazon Glacier and Delete Vault Notification Configuration in the Amazon Glacier Developer Guide.

" - }, - "DescribeJob":{ - "name":"DescribeJob", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/jobs/{jobId}" - }, - "input":{"shape":"DescribeJobInput"}, - "output":{"shape":"GlacierJobDescription"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation returns information about a job you previously initiated, including the job initiation date, the user who initiated the job, the job status code/message and the Amazon SNS topic to notify after Amazon Glacier completes the job. For more information about initiating a job, see InitiateJob.

This operation enables you to check the status of your job. However, it is strongly recommended that you set up an Amazon SNS topic and specify it in your initiate job request so that Amazon Glacier can notify the topic after it completes the job.

A job ID will not expire for at least 24 hours after Amazon Glacier completes the job.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For more information about using this operation, see the documentation for the underlying REST API Describe Job in the Amazon Glacier Developer Guide.

" - }, - "DescribeVault":{ - "name":"DescribeVault", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}" - }, - "input":{"shape":"DescribeVaultInput"}, - "output":{"shape":"DescribeVaultOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation returns information about a vault, including the vault's Amazon Resource Name (ARN), the date the vault was created, the number of archives it contains, and the total size of all the archives in the vault. The number of archives and their total size are as of the last inventory generation. This means that if you add or remove an archive from a vault, and then immediately use Describe Vault, the change in contents will not be immediately reflected. If you want to retrieve the latest inventory of the vault, use InitiateJob. Amazon Glacier generates vault inventories approximately daily. For more information, see Downloading a Vault Inventory in Amazon Glacier.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Retrieving Vault Metadata in Amazon Glacier and Describe Vault in the Amazon Glacier Developer Guide.

" - }, - "GetDataRetrievalPolicy":{ - "name":"GetDataRetrievalPolicy", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/policies/data-retrieval" - }, - "input":{"shape":"GetDataRetrievalPolicyInput"}, - "output":{"shape":"GetDataRetrievalPolicyOutput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation returns the current data retrieval policy for the account and region specified in the GET request. For more information about data retrieval policies, see Amazon Glacier Data Retrieval Policies.

" - }, - "GetJobOutput":{ - "name":"GetJobOutput", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/jobs/{jobId}/output" - }, - "input":{"shape":"GetJobOutputInput"}, - "output":{"shape":"GetJobOutputOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation downloads the output of the job you initiated using InitiateJob. Depending on the job type you specified when you initiated the job, the output will be either the content of an archive or a vault inventory.

You can download all the job output or download a portion of the output by specifying a byte range. In the case of an archive retrieval job, depending on the byte range you specify, Amazon Glacier returns the checksum for the portion of the data. You can compute the checksum on the client and verify that the values match to ensure the portion you downloaded is the correct data.

A job ID will not expire for at least 24 hours after Amazon Glacier completes the job. That a byte range. For both archive and inventory retrieval jobs, you should verify the downloaded size against the size returned in the headers from the Get Job Output response.

For archive retrieval jobs, you should also verify that the size is what you expected. If you download a portion of the output, the expected size is based on the range of bytes you specified. For example, if you specify a range of bytes=0-1048575, you should verify your download size is 1,048,576 bytes. If you download an entire archive, the expected size is the size of the archive when you uploaded it to Amazon Glacier The expected size is also returned in the headers from the Get Job Output response.

In the case of an archive retrieval job, depending on the byte range you specify, Amazon Glacier returns the checksum for the portion of the data. To ensure the portion you downloaded is the correct data, compute the checksum on the client, verify that the values match, and verify that the size is what you expected.

A job ID does not expire for at least 24 hours after Amazon Glacier completes the job. That is, you can download the job output within the 24 hours period after Amazon Glacier completes the job.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and the underlying REST API, see Downloading a Vault Inventory, Downloading an Archive, and Get Job Output

" - }, - "GetVaultAccessPolicy":{ - "name":"GetVaultAccessPolicy", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/access-policy" - }, - "input":{"shape":"GetVaultAccessPolicyInput"}, - "output":{"shape":"GetVaultAccessPolicyOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation retrieves the access-policy subresource set on the vault; for more information on setting this subresource, see Set Vault Access Policy (PUT access-policy). If there is no access policy set on the vault, the operation returns a 404 Not found error. For more information about vault access policies, see Amazon Glacier Access Control with Vault Access Policies.

" - }, - "GetVaultLock":{ - "name":"GetVaultLock", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/lock-policy" - }, - "input":{"shape":"GetVaultLockInput"}, - "output":{"shape":"GetVaultLockOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation retrieves the following attributes from the lock-policy subresource set on the specified vault:

  • The vault lock policy set on the vault.

  • The state of the vault lock, which is either InProgess or Locked.

  • When the lock ID expires. The lock ID is used to complete the vault locking process.

  • When the vault lock was initiated and put into the InProgress state.

A vault lock is put into the InProgress state by calling InitiateVaultLock. A vault lock is put into the Locked state by calling CompleteVaultLock. You can abort the vault locking process by calling AbortVaultLock. For more information about the vault locking process, Amazon Glacier Vault Lock.

If there is no vault lock policy set on the vault, the operation returns a 404 Not found error. For more information about vault lock policies, Amazon Glacier Access Control with Vault Lock Policies.

" - }, - "GetVaultNotifications":{ - "name":"GetVaultNotifications", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/notification-configuration" - }, - "input":{"shape":"GetVaultNotificationsInput"}, - "output":{"shape":"GetVaultNotificationsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation retrieves the notification-configuration subresource of the specified vault.

For information about setting a notification configuration on a vault, see SetVaultNotifications. If a notification configuration for a vault is not set, the operation returns a 404 Not Found error. For more information about vault notifications, see Configuring Vault Notifications in Amazon Glacier.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Configuring Vault Notifications in Amazon Glacier and Get Vault Notification Configuration in the Amazon Glacier Developer Guide.

" - }, - "InitiateJob":{ - "name":"InitiateJob", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/jobs", - "responseCode":202 - }, - "input":{"shape":"InitiateJobInput"}, - "output":{"shape":"InitiateJobOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"PolicyEnforcedException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"InsufficientCapacityException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation initiates a job of the specified type, which can be a select, an archival retrieval, or a vault retrieval. For more information about using this operation, see the documentation for the underlying REST API Initiate a Job.

" - }, - "InitiateMultipartUpload":{ - "name":"InitiateMultipartUpload", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads", - "responseCode":201 - }, - "input":{"shape":"InitiateMultipartUploadInput"}, - "output":{"shape":"InitiateMultipartUploadOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation initiates a multipart upload. Amazon Glacier creates a multipart upload resource and returns its ID in the response. The multipart upload ID is used in subsequent requests to upload parts of an archive (see UploadMultipartPart).

When you initiate a multipart upload, you specify the part size in number of bytes. The part size must be a megabyte (1024 KB) multiplied by a power of 2-for example, 1048576 (1 MB), 2097152 (2 MB), 4194304 (4 MB), 8388608 (8 MB), and so on. The minimum allowable part size is 1 MB, and the maximum is 4 GB.

Every part you upload to this resource (see UploadMultipartPart), except the last one, must have the same size. The last one can be the same size or smaller. For example, suppose you want to upload a 16.2 MB file. If you initiate the multipart upload with a part size of 4 MB, you will upload four parts of 4 MB each and one part of 0.2 MB.

You don't need to know the size of the archive when you start a multipart upload because Amazon Glacier does not require you to specify the overall archive size.

After you complete the multipart upload, Amazon Glacier removes the multipart upload resource referenced by the ID. Amazon Glacier also removes the multipart upload resource if you cancel the multipart upload or it may be removed if there is no activity for a period of 24 hours.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Uploading Large Archives in Parts (Multipart Upload) and Initiate Multipart Upload in the Amazon Glacier Developer Guide.

" - }, - "InitiateVaultLock":{ - "name":"InitiateVaultLock", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/lock-policy", - "responseCode":201 - }, - "input":{"shape":"InitiateVaultLockInput"}, - "output":{"shape":"InitiateVaultLockOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation initiates the vault locking process by doing the following:

  • Installing a vault lock policy on the specified vault.

  • Setting the lock state of vault lock to InProgress.

  • Returning a lock ID, which is used to complete the vault locking process.

You can set one vault lock policy for each vault and this policy can be up to 20 KB in size. For more information about vault lock policies, see Amazon Glacier Access Control with Vault Lock Policies.

You must complete the vault locking process within 24 hours after the vault lock enters the InProgress state. After the 24 hour window ends, the lock ID expires, the vault automatically exits the InProgress state, and the vault lock policy is removed from the vault. You call CompleteVaultLock to complete the vault locking process by setting the state of the vault lock to Locked.

After a vault lock is in the Locked state, you cannot initiate a new vault lock for the vault.

You can abort the vault locking process by calling AbortVaultLock. You can get the state of the vault lock by calling GetVaultLock. For more information about the vault locking process, Amazon Glacier Vault Lock.

If this operation is called when the vault lock is in the InProgress state, the operation returns an AccessDeniedException error. When the vault lock is in the InProgress state you must call AbortVaultLock before you can initiate a new vault lock policy.

" - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/jobs" - }, - "input":{"shape":"ListJobsInput"}, - "output":{"shape":"ListJobsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists jobs for a vault, including jobs that are in-progress and jobs that have recently finished. The List Job operation returns a list of these jobs sorted by job initiation time.

Amazon Glacier retains recently completed jobs for a period before deleting them; however, it eventually removes completed jobs. The output of completed jobs can be retrieved. Retaining completed jobs for a period of time after they have completed enables you to get a job output in the event you miss the job completion notification or your first attempt to download it fails. For example, suppose you start an archive retrieval job to download an archive. After the job completes, you start to download the archive but encounter a network error. In this scenario, you can retry and download the archive while the job exists.

The List Jobs operation supports pagination. You should always check the response Marker field. If there are no more jobs to list, the Marker field is set to null. If there are more jobs to list, the Marker field is set to a non-null value, which you can use to continue the pagination of the list. To return a list of jobs that begins at a specific job, set the marker request parameter to the Marker value for that job that you obtained from a previous List Jobs request.

You can set a maximum limit for the number of jobs returned in the response by specifying the limit parameter in the request. The default limit is 50. The number of jobs returned might be fewer than the limit, but the number of returned jobs never exceeds the limit.

Additionally, you can filter the jobs list returned by specifying the optional statuscode parameter or completed parameter, or both. Using the statuscode parameter, you can specify to return only jobs that match either the InProgress, Succeeded, or Failed status. Using the completed parameter, you can specify to return only jobs that were completed (true) or jobs that were not completed (false).

For more information about using this operation, see the documentation for the underlying REST API List Jobs.

" - }, - "ListMultipartUploads":{ - "name":"ListMultipartUploads", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads" - }, - "input":{"shape":"ListMultipartUploadsInput"}, - "output":{"shape":"ListMultipartUploadsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists in-progress multipart uploads for the specified vault. An in-progress multipart upload is a multipart upload that has been initiated by an InitiateMultipartUpload request, but has not yet been completed or aborted. The list returned in the List Multipart Upload response has no guaranteed order.

The List Multipart Uploads operation supports pagination. By default, this operation returns up to 50 multipart uploads in the response. You should always check the response for a marker at which to continue the list; if there are no more items the marker is null. To return a list of multipart uploads that begins at a specific upload, set the marker request parameter to the value you obtained from a previous List Multipart Upload request. You can also limit the number of uploads returned in the response by specifying the limit parameter in the request.

Note the difference between this operation and listing parts (ListParts). The List Multipart Uploads operation lists all multipart uploads for a vault and does not require a multipart upload ID. The List Parts operation requires a multipart upload ID since parts are associated with a single upload.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and the underlying REST API, see Working with Archives in Amazon Glacier and List Multipart Uploads in the Amazon Glacier Developer Guide.

" - }, - "ListParts":{ - "name":"ListParts", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads/{uploadId}" - }, - "input":{"shape":"ListPartsInput"}, - "output":{"shape":"ListPartsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists the parts of an archive that have been uploaded in a specific multipart upload. You can make this request at any time during an in-progress multipart upload before you complete the upload (see CompleteMultipartUpload. List Parts returns an error for completed uploads. The list returned in the List Parts response is sorted by part range.

The List Parts operation supports pagination. By default, this operation returns up to 50 uploaded parts in the response. You should always check the response for a marker at which to continue the list; if there are no more items the marker is null. To return a list of parts that begins at a specific part, set the marker request parameter to the value you obtained from a previous List Parts request. You can also limit the number of parts returned in the response by specifying the limit parameter in the request.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and the underlying REST API, see Working with Archives in Amazon Glacier and List Parts in the Amazon Glacier Developer Guide.

" - }, - "ListProvisionedCapacity":{ - "name":"ListProvisionedCapacity", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/provisioned-capacity" - }, - "input":{"shape":"ListProvisionedCapacityInput"}, - "output":{"shape":"ListProvisionedCapacityOutput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists the provisioned capacity units for the specified AWS account.

" - }, - "ListTagsForVault":{ - "name":"ListTagsForVault", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults/{vaultName}/tags" - }, - "input":{"shape":"ListTagsForVaultInput"}, - "output":{"shape":"ListTagsForVaultOutput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists all the tags attached to a vault. The operation returns an empty map if there are no tags. For more information about tags, see Tagging Amazon Glacier Resources.

" - }, - "ListVaults":{ - "name":"ListVaults", - "http":{ - "method":"GET", - "requestUri":"/{accountId}/vaults" - }, - "input":{"shape":"ListVaultsInput"}, - "output":{"shape":"ListVaultsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation lists all vaults owned by the calling user's account. The list returned in the response is ASCII-sorted by vault name.

By default, this operation returns up to 10 items. If there are more vaults to list, the response marker field contains the vault Amazon Resource Name (ARN) at which to continue the list with a new List Vaults request; otherwise, the marker field is null. To return a list of vaults that begins at a specific vault, set the marker request parameter to the vault ARN you obtained from a previous List Vaults request. You can also limit the number of vaults returned in the response by specifying the limit parameter in the request.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Retrieving Vault Metadata in Amazon Glacier and List Vaults in the Amazon Glacier Developer Guide.

" - }, - "PurchaseProvisionedCapacity":{ - "name":"PurchaseProvisionedCapacity", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/provisioned-capacity", - "responseCode":201 - }, - "input":{"shape":"PurchaseProvisionedCapacityInput"}, - "output":{"shape":"PurchaseProvisionedCapacityOutput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation purchases a provisioned capacity unit for an AWS account.

" - }, - "RemoveTagsFromVault":{ - "name":"RemoveTagsFromVault", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/tags?operation=remove", - "responseCode":204 - }, - "input":{"shape":"RemoveTagsFromVaultInput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation removes one or more tags from the set of tags attached to a vault. For more information about tags, see Tagging Amazon Glacier Resources. This operation is idempotent. The operation will be successful, even if there are no tags attached to the vault.

" - }, - "SetDataRetrievalPolicy":{ - "name":"SetDataRetrievalPolicy", - "http":{ - "method":"PUT", - "requestUri":"/{accountId}/policies/data-retrieval", - "responseCode":204 - }, - "input":{"shape":"SetDataRetrievalPolicyInput"}, - "errors":[ - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation sets and then enacts a data retrieval policy in the region specified in the PUT request. You can set one policy per region for an AWS account. The policy is enacted within a few minutes of a successful PUT operation.

The set policy operation does not affect retrieval jobs that were in progress before the policy was enacted. For more information about data retrieval policies, see Amazon Glacier Data Retrieval Policies.

" - }, - "SetVaultAccessPolicy":{ - "name":"SetVaultAccessPolicy", - "http":{ - "method":"PUT", - "requestUri":"/{accountId}/vaults/{vaultName}/access-policy", - "responseCode":204 - }, - "input":{"shape":"SetVaultAccessPolicyInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation configures an access policy for a vault and will overwrite an existing policy. To configure a vault access policy, send a PUT request to the access-policy subresource of the vault. An access policy is specific to a vault and is also called a vault subresource. You can set one access policy per vault and the policy can be up to 20 KB in size. For more information about vault access policies, see Amazon Glacier Access Control with Vault Access Policies.

" - }, - "SetVaultNotifications":{ - "name":"SetVaultNotifications", - "http":{ - "method":"PUT", - "requestUri":"/{accountId}/vaults/{vaultName}/notification-configuration", - "responseCode":204 - }, - "input":{"shape":"SetVaultNotificationsInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation configures notifications that will be sent when specific events happen to a vault. By default, you don't get any notifications.

To configure vault notifications, send a PUT request to the notification-configuration subresource of the vault. The request should include a JSON document that provides an Amazon SNS topic and specific events for which you want Amazon Glacier to send notifications to the topic.

Amazon SNS topics must grant permission to the vault to be allowed to publish notifications to the topic. You can configure a vault to publish a notification for the following vault events:

  • ArchiveRetrievalCompleted This event occurs when a job that was initiated for an archive retrieval is completed (InitiateJob). The status of the completed job can be \"Succeeded\" or \"Failed\". The notification sent to the SNS topic is the same output as returned from DescribeJob.

  • InventoryRetrievalCompleted This event occurs when a job that was initiated for an inventory retrieval is completed (InitiateJob). The status of the completed job can be \"Succeeded\" or \"Failed\". The notification sent to the SNS topic is the same output as returned from DescribeJob.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Configuring Vault Notifications in Amazon Glacier and Set Vault Notification Configuration in the Amazon Glacier Developer Guide.

" - }, - "UploadArchive":{ - "name":"UploadArchive", - "http":{ - "method":"POST", - "requestUri":"/{accountId}/vaults/{vaultName}/archives", - "responseCode":201 - }, - "input":{"shape":"UploadArchiveInput"}, - "output":{"shape":"ArchiveCreationOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"RequestTimeoutException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation adds an archive to a vault. This is a synchronous operation, and for a successful upload, your data is durably persisted. Amazon Glacier returns the archive ID in the x-amz-archive-id header of the response.

You must use the archive ID to access your data in Amazon Glacier. After you upload an archive, you should save the archive ID returned so that you can retrieve or delete the archive later. Besides saving the archive ID, you can also index it and give it a friendly name to allow for better searching. You can also use the optional archive description field to specify how the archive is referred to in an external index of archives, such as you might create in Amazon DynamoDB. You can also get the vault inventory to obtain a list of archive IDs in a vault. For more information, see InitiateJob.

You must provide a SHA256 tree hash of the data you are uploading. For information about computing a SHA256 tree hash, see Computing Checksums.

You can optionally specify an archive description of up to 1,024 printable ASCII characters. You can get the archive description when you either retrieve the archive or get the vault inventory. For more information, see InitiateJob. Amazon Glacier does not interpret the description in any way. An archive description does not need to be unique. You cannot use the description to retrieve or sort the archive list.

Archives are immutable. After you upload an archive, you cannot edit the archive or its description.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Uploading an Archive in Amazon Glacier and Upload Archive in the Amazon Glacier Developer Guide.

" - }, - "UploadMultipartPart":{ - "name":"UploadMultipartPart", - "http":{ - "method":"PUT", - "requestUri":"/{accountId}/vaults/{vaultName}/multipart-uploads/{uploadId}", - "responseCode":204 - }, - "input":{"shape":"UploadMultipartPartInput"}, - "output":{"shape":"UploadMultipartPartOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"MissingParameterValueException"}, - {"shape":"RequestTimeoutException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

This operation uploads a part of an archive. You can upload archive parts in any order. You can also upload them in parallel. You can upload up to 10,000 parts for a multipart upload.

Amazon Glacier rejects your upload part request if any of the following conditions is true:

  • SHA256 tree hash does not matchTo ensure that part data is not corrupted in transmission, you compute a SHA256 tree hash of the part and include it in your request. Upon receiving the part data, Amazon Glacier also computes a SHA256 tree hash. If these hash values don't match, the operation fails. For information about computing a SHA256 tree hash, see Computing Checksums.

  • Part size does not matchThe size of each part except the last must match the size specified in the corresponding InitiateMultipartUpload request. The size of the last part must be the same size as, or smaller than, the specified size.

    If you upload a part whose size is smaller than the part size you specified in your initiate multipart upload request and that part is not the last part, then the upload part request will succeed. However, the subsequent Complete Multipart Upload request will fail.

  • Range does not alignThe byte range value in the request does not align with the part size specified in the corresponding initiate request. For example, if you specify a part size of 4194304 bytes (4 MB), then 0 to 4194303 bytes (4 MB - 1) and 4194304 (4 MB) to 8388607 (8 MB - 1) are valid part ranges. However, if you set a range value of 2 MB to 6 MB, the range does not align with the part size and the upload will fail.

This operation is idempotent. If you upload the same part multiple times, the data included in the most recent request overwrites the previously uploaded data.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).

For conceptual information and underlying REST API, see Uploading Large Archives in Parts (Multipart Upload) and Upload Part in the Amazon Glacier Developer Guide.

" - } - }, - "shapes":{ - "AbortMultipartUploadInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "uploadId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "uploadId":{ - "shape":"string", - "documentation":"

The upload ID of the multipart upload to delete.

", - "location":"uri", - "locationName":"uploadId" - } - }, - "documentation":"

Provides options to abort a multipart upload identified by the upload ID.

For information about the underlying REST API, see Abort Multipart Upload. For conceptual information, see Working with Archives in Amazon Glacier.

" - }, - "AbortVaultLockInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

The input values for AbortVaultLock.

" - }, - "AccessControlPolicyList":{ - "type":"list", - "member":{"shape":"Grant"} - }, - "ActionCode":{ - "type":"string", - "enum":[ - "ArchiveRetrieval", - "InventoryRetrieval", - "Select" - ] - }, - "AddTagsToVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "Tags":{ - "shape":"TagMap", - "documentation":"

The tags to add to the vault. Each tag is composed of a key and a value. The value can be an empty string.

" - } - }, - "documentation":"

The input values for AddTagsToVault.

" - }, - "ArchiveCreationOutput":{ - "type":"structure", - "members":{ - "location":{ - "shape":"string", - "documentation":"

The relative URI path of the newly added archive resource.

", - "location":"header", - "locationName":"Location" - }, - "checksum":{ - "shape":"string", - "documentation":"

The checksum of the archive computed by Amazon Glacier.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - }, - "archiveId":{ - "shape":"string", - "documentation":"

The ID of the archive. This value is also included as part of the location.

", - "location":"header", - "locationName":"x-amz-archive-id" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

For information about the underlying REST API, see Upload Archive. For conceptual information, see Working with Archives in Amazon Glacier.

" - }, - "CSVInput":{ - "type":"structure", - "members":{ - "FileHeaderInfo":{ - "shape":"FileHeaderInfo", - "documentation":"

Describes the first line of input. Valid values are None, Ignore, and Use.

" - }, - "Comments":{ - "shape":"string", - "documentation":"

A single character used to indicate that a row should be ignored when the character is present at the start of that row.

" - }, - "QuoteEscapeCharacter":{ - "shape":"string", - "documentation":"

A single character used for escaping the quotation-mark character inside an already escaped value.

" - }, - "RecordDelimiter":{ - "shape":"string", - "documentation":"

A value used to separate individual records from each other.

" - }, - "FieldDelimiter":{ - "shape":"string", - "documentation":"

A value used to separate individual fields from each other within a record.

" - }, - "QuoteCharacter":{ - "shape":"string", - "documentation":"

A value used as an escape character where the field delimiter is part of the value.

" - } - }, - "documentation":"

Contains information about the comma-separated value (CSV) file to select from.

" - }, - "CSVOutput":{ - "type":"structure", - "members":{ - "QuoteFields":{ - "shape":"QuoteFields", - "documentation":"

A value that indicates whether all output fields should be contained within quotation marks.

" - }, - "QuoteEscapeCharacter":{ - "shape":"string", - "documentation":"

A single character used for escaping the quotation-mark character inside an already escaped value.

" - }, - "RecordDelimiter":{ - "shape":"string", - "documentation":"

A value used to separate individual records from each other.

" - }, - "FieldDelimiter":{ - "shape":"string", - "documentation":"

A value used to separate individual fields from each other within a record.

" - }, - "QuoteCharacter":{ - "shape":"string", - "documentation":"

A value used as an escape character where the field delimiter is part of the value.

" - } - }, - "documentation":"

Contains information about the comma-separated value (CSV) file that the job results are stored in.

" - }, - "CannedACL":{ - "type":"string", - "enum":[ - "private", - "public-read", - "public-read-write", - "aws-exec-read", - "authenticated-read", - "bucket-owner-read", - "bucket-owner-full-control" - ] - }, - "CompleteMultipartUploadInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "uploadId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "uploadId":{ - "shape":"string", - "documentation":"

The upload ID of the multipart upload.

", - "location":"uri", - "locationName":"uploadId" - }, - "archiveSize":{ - "shape":"string", - "documentation":"

The total size, in bytes, of the entire archive. This value should be the sum of all the sizes of the individual parts that you uploaded.

", - "location":"header", - "locationName":"x-amz-archive-size" - }, - "checksum":{ - "shape":"string", - "documentation":"

The SHA256 tree hash of the entire archive. It is the tree hash of SHA256 tree hash of the individual parts. If the value you specify in the request does not match the SHA256 tree hash of the final assembled archive as computed by Amazon Glacier, Amazon Glacier returns an error and the request fails.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - } - }, - "documentation":"

Provides options to complete a multipart upload operation. This informs Amazon Glacier that all the archive parts have been uploaded and Amazon Glacier can now assemble the archive from the uploaded parts. After assembling and saving the archive to the vault, Amazon Glacier returns the URI path of the newly created archive resource.

" - }, - "CompleteVaultLockInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "lockId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "lockId":{ - "shape":"string", - "documentation":"

The lockId value is the lock ID obtained from a InitiateVaultLock request.

", - "location":"uri", - "locationName":"lockId" - } - }, - "documentation":"

The input values for CompleteVaultLock.

" - }, - "CreateVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Provides options to create a vault.

" - }, - "CreateVaultOutput":{ - "type":"structure", - "members":{ - "location":{ - "shape":"string", - "documentation":"

The URI of the vault that was created.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "DataRetrievalPolicy":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"DataRetrievalRulesList", - "documentation":"

The policy rule. Although this is a list type, currently there must be only one rule, which contains a Strategy field and optionally a BytesPerHour field.

" - } - }, - "documentation":"

Data retrieval policy.

" - }, - "DataRetrievalRule":{ - "type":"structure", - "members":{ - "Strategy":{ - "shape":"string", - "documentation":"

The type of data retrieval policy to set.

Valid values: BytesPerHour|FreeTier|None

" - }, - "BytesPerHour":{ - "shape":"NullableLong", - "documentation":"

The maximum number of bytes that can be retrieved in an hour.

This field is required only if the value of the Strategy field is BytesPerHour. Your PUT operation will be rejected if the Strategy field is not set to BytesPerHour and you set this field.

" - } - }, - "documentation":"

Data retrieval policy rule.

" - }, - "DataRetrievalRulesList":{ - "type":"list", - "member":{"shape":"DataRetrievalRule"} - }, - "DateTime":{"type":"string"}, - "DeleteArchiveInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "archiveId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "archiveId":{ - "shape":"string", - "documentation":"

The ID of the archive to delete.

", - "location":"uri", - "locationName":"archiveId" - } - }, - "documentation":"

Provides options for deleting an archive from an Amazon Glacier vault.

" - }, - "DeleteVaultAccessPolicyInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

DeleteVaultAccessPolicy input.

" - }, - "DeleteVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Provides options for deleting a vault from Amazon Glacier.

" - }, - "DeleteVaultNotificationsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Provides options for deleting a vault notification configuration from an Amazon Glacier vault.

" - }, - "DescribeJobInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "jobId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "jobId":{ - "shape":"string", - "documentation":"

The ID of the job to describe.

", - "location":"uri", - "locationName":"jobId" - } - }, - "documentation":"

Provides options for retrieving a job description.

" - }, - "DescribeVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Provides options for retrieving metadata for a specific vault in Amazon Glacier.

" - }, - "DescribeVaultOutput":{ - "type":"structure", - "members":{ - "VaultARN":{ - "shape":"string", - "documentation":"

The Amazon Resource Name (ARN) of the vault.

" - }, - "VaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

" - }, - "CreationDate":{ - "shape":"string", - "documentation":"

The Universal Coordinated Time (UTC) date when the vault was created. This value should be a string in the ISO 8601 date format, for example 2012-03-20T17:03:43.221Z.

" - }, - "LastInventoryDate":{ - "shape":"string", - "documentation":"

The Universal Coordinated Time (UTC) date when Amazon Glacier completed the last vault inventory. This value should be a string in the ISO 8601 date format, for example 2012-03-20T17:03:43.221Z.

" - }, - "NumberOfArchives":{ - "shape":"long", - "documentation":"

The number of archives in the vault as of the last inventory date. This field will return null if an inventory has not yet run on the vault, for example if you just created the vault.

" - }, - "SizeInBytes":{ - "shape":"long", - "documentation":"

Total size, in bytes, of the archives in the vault as of the last inventory date. This field will return null if an inventory has not yet run on the vault, for example if you just created the vault.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "Encryption":{ - "type":"structure", - "members":{ - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The server-side encryption algorithm used when storing job results in Amazon S3, for example AES256 or aws:kms.

" - }, - "KMSKeyId":{ - "shape":"string", - "documentation":"

The AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS fail if not made by using Secure Sockets Layer (SSL) or Signature Version 4.

" - }, - "KMSContext":{ - "shape":"string", - "documentation":"

Optional. If the encryption type is aws:kms, you can use this value to specify the encryption context for the job results.

" - } - }, - "documentation":"

Contains information about the encryption used to store the job results in Amazon S3.

" - }, - "EncryptionType":{ - "type":"string", - "enum":[ - "aws:kms", - "AES256" - ] - }, - "ExpressionType":{ - "type":"string", - "enum":["SQL"] - }, - "FileHeaderInfo":{ - "type":"string", - "enum":[ - "USE", - "IGNORE", - "NONE" - ] - }, - "GetDataRetrievalPolicyInput":{ - "type":"structure", - "required":["accountId"], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - } - }, - "documentation":"

Input for GetDataRetrievalPolicy.

" - }, - "GetDataRetrievalPolicyOutput":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"DataRetrievalPolicy", - "documentation":"

Contains the returned data retrieval policy in JSON format.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to the GetDataRetrievalPolicy request.

" - }, - "GetJobOutputInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "jobId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "jobId":{ - "shape":"string", - "documentation":"

The job ID whose data is downloaded.

", - "location":"uri", - "locationName":"jobId" - }, - "range":{ - "shape":"string", - "documentation":"

The range of bytes to retrieve from the output. For example, if you want to download the first 1,048,576 bytes, specify the range as bytes=0-1048575. By default, this operation downloads the entire output.

If the job output is large, then you can use a range to retrieve a portion of the output. This allows you to download the entire output in smaller chunks of bytes. For example, suppose you have 1 GB of job output you want to download and you decide to download 128 MB chunks of data at a time, which is a total of eight Get Job Output requests. You use the following process to download the job output:

  1. Download a 128 MB chunk of output by specifying the appropriate byte range. Verify that all 128 MB of data was received.

  2. Along with the data, the response includes a SHA256 tree hash of the payload. You compute the checksum of the payload on the client and compare it with the checksum you received in the response to ensure you received all the expected data.

  3. Repeat steps 1 and 2 for all the eight 128 MB chunks of output data, each time specifying the appropriate byte range.

  4. After downloading all the parts of the job output, you have a list of eight checksum values. Compute the tree hash of these values to find the checksum of the entire output. Using the DescribeJob API, obtain job information of the job that provided you the output. The response includes the checksum of the entire archive stored in Amazon Glacier. You compare this value with the checksum you computed to ensure you have downloaded the entire archive content with no errors.

", - "location":"header", - "locationName":"Range" - } - }, - "documentation":"

Provides options for downloading output of an Amazon Glacier job.

" - }, - "GetJobOutputOutput":{ - "type":"structure", - "members":{ - "body":{ - "shape":"Stream", - "documentation":"

The job data, either archive data or inventory data.

" - }, - "checksum":{ - "shape":"string", - "documentation":"

The checksum of the data in the response. This header is returned only when retrieving the output for an archive retrieval job. Furthermore, this header appears only under the following conditions:

  • You get the entire range of the archive.

  • You request a range to return of the archive that starts and ends on a multiple of 1 MB. For example, if you have an 3.1 MB archive and you specify a range to return that starts at 1 MB and ends at 2 MB, then the x-amz-sha256-tree-hash is returned as a response header.

  • You request a range of the archive to return that starts on a multiple of 1 MB and goes to the end of the archive. For example, if you have a 3.1 MB archive and you specify a range that starts at 2 MB and ends at 3.1 MB (the end of the archive), then the x-amz-sha256-tree-hash is returned as a response header.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - }, - "status":{ - "shape":"httpstatus", - "documentation":"

The HTTP response code for a job output request. The value depends on whether a range was specified in the request.

", - "location":"statusCode" - }, - "contentRange":{ - "shape":"string", - "documentation":"

The range of bytes returned by Amazon Glacier. If only partial output is downloaded, the response provides the range of bytes Amazon Glacier returned. For example, bytes 0-1048575/8388608 returns the first 1 MB from 8 MB.

", - "location":"header", - "locationName":"Content-Range" - }, - "acceptRanges":{ - "shape":"string", - "documentation":"

Indicates the range units accepted. For more information, see RFC2616.

", - "location":"header", - "locationName":"Accept-Ranges" - }, - "contentType":{ - "shape":"string", - "documentation":"

The Content-Type depends on whether the job output is an archive or a vault inventory. For archive data, the Content-Type is application/octet-stream. For vault inventory, if you requested CSV format when you initiated the job, the Content-Type is text/csv. Otherwise, by default, vault inventory is returned as JSON, and the Content-Type is application/json.

", - "location":"header", - "locationName":"Content-Type" - }, - "archiveDescription":{ - "shape":"string", - "documentation":"

The description of an archive.

", - "location":"header", - "locationName":"x-amz-archive-description" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

", - "payload":"body" - }, - "GetVaultAccessPolicyInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Input for GetVaultAccessPolicy.

" - }, - "GetVaultAccessPolicyOutput":{ - "type":"structure", - "members":{ - "policy":{ - "shape":"VaultAccessPolicy", - "documentation":"

Contains the returned vault access policy as a JSON string.

" - } - }, - "documentation":"

Output for GetVaultAccessPolicy.

", - "payload":"policy" - }, - "GetVaultLockInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

The input values for GetVaultLock.

" - }, - "GetVaultLockOutput":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"string", - "documentation":"

The vault lock policy as a JSON string, which uses \"\\\" as an escape character.

" - }, - "State":{ - "shape":"string", - "documentation":"

The state of the vault lock. InProgress or Locked.

" - }, - "ExpirationDate":{ - "shape":"string", - "documentation":"

The UTC date and time at which the lock ID expires. This value can be null if the vault lock is in a Locked state.

" - }, - "CreationDate":{ - "shape":"string", - "documentation":"

The UTC date and time at which the vault lock was put into the InProgress state.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "GetVaultNotificationsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

Provides options for retrieving the notification configuration set on an Amazon Glacier vault.

" - }, - "GetVaultNotificationsOutput":{ - "type":"structure", - "members":{ - "vaultNotificationConfig":{ - "shape":"VaultNotificationConfig", - "documentation":"

Returns the notification configuration set on the vault.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

", - "payload":"vaultNotificationConfig" - }, - "GlacierJobDescription":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"string", - "documentation":"

An opaque string that identifies an Amazon Glacier job.

" - }, - "JobDescription":{ - "shape":"string", - "documentation":"

The job description provided when initiating the job.

" - }, - "Action":{ - "shape":"ActionCode", - "documentation":"

The job type. This value is either ArchiveRetrieval, InventoryRetrieval, or Select.

" - }, - "ArchiveId":{ - "shape":"string", - "documentation":"

The archive ID requested for a select job or archive retrieval. Otherwise, this field is null.

" - }, - "VaultARN":{ - "shape":"string", - "documentation":"

The Amazon Resource Name (ARN) of the vault from which an archive retrieval was requested.

" - }, - "CreationDate":{ - "shape":"string", - "documentation":"

The UTC date when the job was created. This value is a string representation of ISO 8601 date format, for example \"2012-03-20T17:03:43.221Z\".

" - }, - "Completed":{ - "shape":"boolean", - "documentation":"

The job status. When a job is completed, you get the job's output using Get Job Output (GET output).

" - }, - "StatusCode":{ - "shape":"StatusCode", - "documentation":"

The status code can be InProgress, Succeeded, or Failed, and indicates the status of the job.

" - }, - "StatusMessage":{ - "shape":"string", - "documentation":"

A friendly message that describes the job status.

" - }, - "ArchiveSizeInBytes":{ - "shape":"Size", - "documentation":"

For an archive retrieval job, this value is the size in bytes of the archive being requested for download. For an inventory retrieval or select job, this value is null.

" - }, - "InventorySizeInBytes":{ - "shape":"Size", - "documentation":"

For an inventory retrieval job, this value is the size in bytes of the inventory requested for download. For an archive retrieval or select job, this value is null.

" - }, - "SNSTopic":{ - "shape":"string", - "documentation":"

An Amazon SNS topic that receives notification.

" - }, - "CompletionDate":{ - "shape":"string", - "documentation":"

The UTC time that the job request completed. While the job is in progress, the value is null.

" - }, - "SHA256TreeHash":{ - "shape":"string", - "documentation":"

For an archive retrieval job, this value is the checksum of the archive. Otherwise, this value is null.

The SHA256 tree hash value for the requested range of an archive. If the InitiateJob request for an archive specified a tree-hash aligned range, then this field returns a value.

If the whole archive is retrieved, this value is the same as the ArchiveSHA256TreeHash value.

This field is null for the following:

  • Archive retrieval jobs that specify a range that is not tree-hash aligned

  • Archival jobs that specify a range that is equal to the whole archive, when the job status is InProgress

  • Inventory jobs

  • Select jobs

" - }, - "ArchiveSHA256TreeHash":{ - "shape":"string", - "documentation":"

The SHA256 tree hash of the entire archive for an archive retrieval. For inventory retrieval or select jobs, this field is null.

" - }, - "RetrievalByteRange":{ - "shape":"string", - "documentation":"

The retrieved byte range for archive retrieval jobs in the form StartByteValue-EndByteValue. If no range was specified in the archive retrieval, then the whole archive is retrieved. In this case, StartByteValue equals 0 and EndByteValue equals the size of the archive minus 1. For inventory retrieval or select jobs, this field is null.

" - }, - "Tier":{ - "shape":"string", - "documentation":"

The tier to use for a select or an archive retrieval. Valid values are Expedited, Standard, or Bulk. Standard is the default.

" - }, - "InventoryRetrievalParameters":{ - "shape":"InventoryRetrievalJobDescription", - "documentation":"

Parameters used for range inventory retrieval.

" - }, - "JobOutputPath":{ - "shape":"string", - "documentation":"

Contains the job output location.

" - }, - "SelectParameters":{ - "shape":"SelectParameters", - "documentation":"

Contains the parameters used for a select.

" - }, - "OutputLocation":{ - "shape":"OutputLocation", - "documentation":"

Contains the location where the data from the select job is stored.

" - } - }, - "documentation":"

Contains the description of an Amazon Glacier job.

" - }, - "Grant":{ - "type":"structure", - "members":{ - "Grantee":{ - "shape":"Grantee", - "documentation":"

The grantee.

" - }, - "Permission":{ - "shape":"Permission", - "documentation":"

Specifies the permission given to the grantee.

" - } - }, - "documentation":"

Contains information about a grant.

" - }, - "Grantee":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"Type", - "documentation":"

Type of grantee

" - }, - "DisplayName":{ - "shape":"string", - "documentation":"

Screen name of the grantee.

" - }, - "URI":{ - "shape":"string", - "documentation":"

URI of the grantee group.

" - }, - "ID":{ - "shape":"string", - "documentation":"

The canonical user ID of the grantee.

" - }, - "EmailAddress":{ - "shape":"string", - "documentation":"

Email address of the grantee.

" - } - }, - "documentation":"

Contains information about the grantee.

" - }, - "InitiateJobInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "jobParameters":{ - "shape":"JobParameters", - "documentation":"

Provides options for specifying job information.

" - } - }, - "documentation":"

Provides options for initiating an Amazon Glacier job.

", - "payload":"jobParameters" - }, - "InitiateJobOutput":{ - "type":"structure", - "members":{ - "location":{ - "shape":"string", - "documentation":"

The relative URI path of the job.

", - "location":"header", - "locationName":"Location" - }, - "jobId":{ - "shape":"string", - "documentation":"

The ID of the job.

", - "location":"header", - "locationName":"x-amz-job-id" - }, - "jobOutputPath":{ - "shape":"string", - "documentation":"

The path to the location of where the select results are stored.

", - "location":"header", - "locationName":"x-amz-job-output-path" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "InitiateMultipartUploadInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "archiveDescription":{ - "shape":"string", - "documentation":"

The archive description that you are uploading in parts.

The part size must be a megabyte (1024 KB) multiplied by a power of 2, for example 1048576 (1 MB), 2097152 (2 MB), 4194304 (4 MB), 8388608 (8 MB), and so on. The minimum allowable part size is 1 MB, and the maximum is 4 GB (4096 MB).

", - "location":"header", - "locationName":"x-amz-archive-description" - }, - "partSize":{ - "shape":"string", - "documentation":"

The size of each part except the last, in bytes. The last part can be smaller than this part size.

", - "location":"header", - "locationName":"x-amz-part-size" - } - }, - "documentation":"

Provides options for initiating a multipart upload to an Amazon Glacier vault.

" - }, - "InitiateMultipartUploadOutput":{ - "type":"structure", - "members":{ - "location":{ - "shape":"string", - "documentation":"

The relative URI path of the multipart upload ID Amazon Glacier created.

", - "location":"header", - "locationName":"Location" - }, - "uploadId":{ - "shape":"string", - "documentation":"

The ID of the multipart upload. This value is also included as part of the location.

", - "location":"header", - "locationName":"x-amz-multipart-upload-id" - } - }, - "documentation":"

The Amazon Glacier response to your request.

" - }, - "InitiateVaultLockInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "policy":{ - "shape":"VaultLockPolicy", - "documentation":"

The vault lock policy as a JSON string, which uses \"\\\" as an escape character.

" - } - }, - "documentation":"

The input values for InitiateVaultLock.

", - "payload":"policy" - }, - "InitiateVaultLockOutput":{ - "type":"structure", - "members":{ - "lockId":{ - "shape":"string", - "documentation":"

The lock ID, which is used to complete the vault locking process.

", - "location":"header", - "locationName":"x-amz-lock-id" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "InputSerialization":{ - "type":"structure", - "members":{ - "csv":{ - "shape":"CSVInput", - "documentation":"

Describes the serialization of a CSV-encoded object.

" - } - }, - "documentation":"

Describes how the archive is serialized.

" - }, - "InsufficientCapacityException":{ - "type":"structure", - "members":{ - "type":{"shape":"string"}, - "code":{"shape":"string"}, - "message":{"shape":"string"} - }, - "documentation":"

Returned if there is insufficient capacity to process this expedited request. This error only applies to expedited retrievals and not to standard or bulk retrievals.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client

" - }, - "code":{ - "shape":"string", - "documentation":"

400 Bad Request

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if a parameter of the request is incorrectly specified.

" - } - }, - "documentation":"

Returned if a parameter of the request is incorrectly specified.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InventoryRetrievalJobDescription":{ - "type":"structure", - "members":{ - "Format":{ - "shape":"string", - "documentation":"

The output format for the vault inventory list, which is set by the InitiateJob request when initiating a job to retrieve a vault inventory. Valid values are CSV and JSON.

" - }, - "StartDate":{ - "shape":"DateTime", - "documentation":"

The start of the date range in Universal Coordinated Time (UTC) for vault inventory retrieval that includes archives created on or after this date. This value should be a string in the ISO 8601 date format, for example 2013-03-20T17:03:43Z.

" - }, - "EndDate":{ - "shape":"DateTime", - "documentation":"

The end of the date range in UTC for vault inventory retrieval that includes archives created before this date. This value should be a string in the ISO 8601 date format, for example 2013-03-20T17:03:43Z.

" - }, - "Limit":{ - "shape":"string", - "documentation":"

The maximum number of inventory items returned per vault inventory retrieval request. This limit is set when initiating the job with the a InitiateJob request.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

An opaque string that represents where to continue pagination of the vault inventory retrieval results. You use the marker in a new InitiateJob request to obtain additional inventory items. If there are no more inventory items, this value is null. For more information, see Range Inventory Retrieval.

" - } - }, - "documentation":"

Describes the options for a range inventory retrieval job.

" - }, - "InventoryRetrievalJobInput":{ - "type":"structure", - "members":{ - "StartDate":{ - "shape":"string", - "documentation":"

The start of the date range in UTC for vault inventory retrieval that includes archives created on or after this date. This value should be a string in the ISO 8601 date format, for example 2013-03-20T17:03:43Z.

" - }, - "EndDate":{ - "shape":"string", - "documentation":"

The end of the date range in UTC for vault inventory retrieval that includes archives created before this date. This value should be a string in the ISO 8601 date format, for example 2013-03-20T17:03:43Z.

" - }, - "Limit":{ - "shape":"string", - "documentation":"

Specifies the maximum number of inventory items returned per vault inventory retrieval request. Valid values are greater than or equal to 1.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

An opaque string that represents where to continue pagination of the vault inventory retrieval results. You use the marker in a new InitiateJob request to obtain additional inventory items. If there are no more inventory items, this value is null.

" - } - }, - "documentation":"

Provides options for specifying a range inventory retrieval job.

" - }, - "JobList":{ - "type":"list", - "member":{"shape":"GlacierJobDescription"} - }, - "JobParameters":{ - "type":"structure", - "members":{ - "Format":{ - "shape":"string", - "documentation":"

When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format. If you are initiating an inventory job and do not specify a Format field, JSON is the default format. Valid values are \"CSV\" and \"JSON\".

" - }, - "Type":{ - "shape":"string", - "documentation":"

The job type. You can initiate a job to perform a select query on an archive, retrieve an archive, or get an inventory of a vault. Valid values are \"select\", \"archive-retrieval\" and \"inventory-retrieval\".

" - }, - "ArchiveId":{ - "shape":"string", - "documentation":"

The ID of the archive that you want to retrieve. This field is required only if Type is set to select or archive-retrievalcode>. An error occurs if you specify this request parameter for an inventory retrieval job request.

" - }, - "Description":{ - "shape":"string", - "documentation":"

The optional description for the job. The description must be less than or equal to 1,024 bytes. The allowable characters are 7-bit ASCII without control codes-specifically, ASCII values 32-126 decimal or 0x20-0x7E hexadecimal.

" - }, - "SNSTopic":{ - "shape":"string", - "documentation":"

The Amazon SNS topic ARN to which Amazon Glacier sends a notification when the job is completed and the output is ready for you to download. The specified topic publishes the notification to its subscribers. The SNS topic must exist.

" - }, - "RetrievalByteRange":{ - "shape":"string", - "documentation":"

The byte range to retrieve for an archive retrieval. in the form \"StartByteValue-EndByteValue\" If not specified, the whole archive is retrieved. If specified, the byte range must be megabyte (1024*1024) aligned which means that StartByteValue must be divisible by 1 MB and EndByteValue plus 1 must be divisible by 1 MB or be the end of the archive specified as the archive byte size value minus 1. If RetrievalByteRange is not megabyte aligned, this operation returns a 400 response.

An error occurs if you specify this field for an inventory retrieval job request.

" - }, - "Tier":{ - "shape":"string", - "documentation":"

The tier to use for a select or an archive retrieval job. Valid values are Expedited, Standard, or Bulk. Standard is the default.

" - }, - "InventoryRetrievalParameters":{ - "shape":"InventoryRetrievalJobInput", - "documentation":"

Input parameters used for range inventory retrieval.

" - }, - "SelectParameters":{ - "shape":"SelectParameters", - "documentation":"

Contains the parameters that define a job.

" - }, - "OutputLocation":{ - "shape":"OutputLocation", - "documentation":"

Contains information about the location where the select job results are stored.

" - } - }, - "documentation":"

Provides options for defining a job.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client

" - }, - "code":{ - "shape":"string", - "documentation":"

400 Bad Request

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if the request results in a vault limit or tags limit being exceeded.

" - } - }, - "documentation":"

Returned if the request results in a vault or account limit being exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ListJobsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "limit":{ - "shape":"string", - "documentation":"

The maximum number of jobs to be returned. The default limit is 50. The number of jobs returned might be fewer than the specified limit, but the number of returned jobs never exceeds the limit.

", - "location":"querystring", - "locationName":"limit" - }, - "marker":{ - "shape":"string", - "documentation":"

An opaque string used for pagination. This value specifies the job at which the listing of jobs should begin. Get the marker value from a previous List Jobs response. You only need to include the marker if you are continuing the pagination of results started in a previous List Jobs request.

", - "location":"querystring", - "locationName":"marker" - }, - "statuscode":{ - "shape":"string", - "documentation":"

The type of job status to return. You can specify the following values: InProgress, Succeeded, or Failed.

", - "location":"querystring", - "locationName":"statuscode" - }, - "completed":{ - "shape":"string", - "documentation":"

The state of the jobs to return. You can specify true or false.

", - "location":"querystring", - "locationName":"completed" - } - }, - "documentation":"

Provides options for retrieving a job list for an Amazon Glacier vault.

" - }, - "ListJobsOutput":{ - "type":"structure", - "members":{ - "JobList":{ - "shape":"JobList", - "documentation":"

A list of job objects. Each job object contains metadata describing the job.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

An opaque string used for pagination that specifies the job at which the listing of jobs should begin. You get the marker value from a previous List Jobs response. You only need to include the marker if you are continuing the pagination of the results started in a previous List Jobs request.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "ListMultipartUploadsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "marker":{ - "shape":"string", - "documentation":"

An opaque string used for pagination. This value specifies the upload at which the listing of uploads should begin. Get the marker value from a previous List Uploads response. You need only include the marker if you are continuing the pagination of results started in a previous List Uploads request.

", - "location":"querystring", - "locationName":"marker" - }, - "limit":{ - "shape":"string", - "documentation":"

Specifies the maximum number of uploads returned in the response body. If this value is not specified, the List Uploads operation returns up to 50 uploads.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Provides options for retrieving list of in-progress multipart uploads for an Amazon Glacier vault.

" - }, - "ListMultipartUploadsOutput":{ - "type":"structure", - "members":{ - "UploadsList":{ - "shape":"UploadsList", - "documentation":"

A list of in-progress multipart uploads.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

An opaque string that represents where to continue pagination of the results. You use the marker in a new List Multipart Uploads request to obtain more uploads in the list. If there are no more uploads, this value is null.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "ListPartsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "uploadId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "uploadId":{ - "shape":"string", - "documentation":"

The upload ID of the multipart upload.

", - "location":"uri", - "locationName":"uploadId" - }, - "marker":{ - "shape":"string", - "documentation":"

An opaque string used for pagination. This value specifies the part at which the listing of parts should begin. Get the marker value from the response of a previous List Parts response. You need only include the marker if you are continuing the pagination of results started in a previous List Parts request.

", - "location":"querystring", - "locationName":"marker" - }, - "limit":{ - "shape":"string", - "documentation":"

The maximum number of parts to be returned. The default limit is 50. The number of parts returned might be fewer than the specified limit, but the number of returned parts never exceeds the limit.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Provides options for retrieving a list of parts of an archive that have been uploaded in a specific multipart upload.

" - }, - "ListPartsOutput":{ - "type":"structure", - "members":{ - "MultipartUploadId":{ - "shape":"string", - "documentation":"

The ID of the upload to which the parts are associated.

" - }, - "VaultARN":{ - "shape":"string", - "documentation":"

The Amazon Resource Name (ARN) of the vault to which the multipart upload was initiated.

" - }, - "ArchiveDescription":{ - "shape":"string", - "documentation":"

The description of the archive that was specified in the Initiate Multipart Upload request.

" - }, - "PartSizeInBytes":{ - "shape":"long", - "documentation":"

The part size in bytes. This is the same value that you specified in the Initiate Multipart Upload request.

" - }, - "CreationDate":{ - "shape":"string", - "documentation":"

The UTC time at which the multipart upload was initiated.

" - }, - "Parts":{ - "shape":"PartList", - "documentation":"

A list of the part sizes of the multipart upload. Each object in the array contains a RangeBytes and sha256-tree-hash name/value pair.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

An opaque string that represents where to continue pagination of the results. You use the marker in a new List Parts request to obtain more jobs in the list. If there are no more parts, this value is null.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "ListProvisionedCapacityInput":{ - "type":"structure", - "required":["accountId"], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, don't include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - } - } - }, - "ListProvisionedCapacityOutput":{ - "type":"structure", - "members":{ - "ProvisionedCapacityList":{ - "shape":"ProvisionedCapacityList", - "documentation":"

The response body contains the following JSON fields.

" - } - } - }, - "ListTagsForVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - } - }, - "documentation":"

The input value for ListTagsForVaultInput.

" - }, - "ListTagsForVaultOutput":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagMap", - "documentation":"

The tags attached to the vault. Each tag is composed of a key and a value.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "ListVaultsInput":{ - "type":"structure", - "required":["accountId"], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "marker":{ - "shape":"string", - "documentation":"

A string used for pagination. The marker specifies the vault ARN after which the listing of vaults should begin.

", - "location":"querystring", - "locationName":"marker" - }, - "limit":{ - "shape":"string", - "documentation":"

The maximum number of vaults to be returned. The default limit is 10. The number of vaults returned might be fewer than the specified limit, but the number of returned vaults never exceeds the limit.

", - "location":"querystring", - "locationName":"limit" - } - }, - "documentation":"

Provides options to retrieve the vault list owned by the calling user's account. The list provides metadata information for each vault.

" - }, - "ListVaultsOutput":{ - "type":"structure", - "members":{ - "VaultList":{ - "shape":"VaultList", - "documentation":"

List of vaults.

" - }, - "Marker":{ - "shape":"string", - "documentation":"

The vault ARN at which to continue pagination of the results. You use the marker in another List Vaults request to obtain more vaults in the list.

" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "MissingParameterValueException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client.

" - }, - "code":{ - "shape":"string", - "documentation":"

400 Bad Request

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if no authentication data is found for the request.

" - } - }, - "documentation":"

Returned if a required header or parameter is missing from the request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotificationEventList":{ - "type":"list", - "member":{"shape":"string"} - }, - "NullableLong":{"type":"long"}, - "OutputLocation":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Location", - "documentation":"

Describes an S3 location that will receive the results of the job request.

" - } - }, - "documentation":"

Contains information about the location where the select job results are stored.

" - }, - "OutputSerialization":{ - "type":"structure", - "members":{ - "csv":{ - "shape":"CSVOutput", - "documentation":"

Describes the serialization of CSV-encoded query results.

" - } - }, - "documentation":"

Describes how the select output is serialized.

" - }, - "PartList":{ - "type":"list", - "member":{"shape":"PartListElement"} - }, - "PartListElement":{ - "type":"structure", - "members":{ - "RangeInBytes":{ - "shape":"string", - "documentation":"

The byte range of a part, inclusive of the upper value of the range.

" - }, - "SHA256TreeHash":{ - "shape":"string", - "documentation":"

The SHA256 tree hash value that Amazon Glacier calculated for the part. This field is never null.

" - } - }, - "documentation":"

A list of the part sizes of the multipart upload.

" - }, - "Permission":{ - "type":"string", - "enum":[ - "FULL_CONTROL", - "WRITE", - "WRITE_ACP", - "READ", - "READ_ACP" - ] - }, - "PolicyEnforcedException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client

" - }, - "code":{ - "shape":"string", - "documentation":"

PolicyEnforcedException

" - }, - "message":{ - "shape":"string", - "documentation":"

InitiateJob request denied by current data retrieval policy.

" - } - }, - "documentation":"

Returned if a retrieval job would exceed the current data policy's retrieval rate limit. For more information about data retrieval policies,

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ProvisionedCapacityDescription":{ - "type":"structure", - "members":{ - "CapacityId":{ - "shape":"string", - "documentation":"

The ID that identifies the provisioned capacity unit.

" - }, - "StartDate":{ - "shape":"string", - "documentation":"

The date that the provisioned capacity unit was purchased, in Universal Coordinated Time (UTC).

" - }, - "ExpirationDate":{ - "shape":"string", - "documentation":"

The date that the provisioned capacity unit expires, in Universal Coordinated Time (UTC).

" - } - }, - "documentation":"

The definition for a provisioned capacity unit.

" - }, - "ProvisionedCapacityList":{ - "type":"list", - "member":{"shape":"ProvisionedCapacityDescription"} - }, - "PurchaseProvisionedCapacityInput":{ - "type":"structure", - "required":["accountId"], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, don't include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - } - } - }, - "PurchaseProvisionedCapacityOutput":{ - "type":"structure", - "members":{ - "capacityId":{ - "shape":"string", - "documentation":"

The ID that identifies the provisioned capacity unit.

", - "location":"header", - "locationName":"x-amz-capacity-id" - } - } - }, - "QuoteFields":{ - "type":"string", - "enum":[ - "ALWAYS", - "ASNEEDED" - ] - }, - "RemoveTagsFromVaultInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys. Each corresponding tag is removed from the vault.

" - } - }, - "documentation":"

The input value for RemoveTagsFromVaultInput.

" - }, - "RequestTimeoutException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client

" - }, - "code":{ - "shape":"string", - "documentation":"

408 Request Timeout

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if, when uploading an archive, Amazon Glacier times out while receiving the upload.

" - } - }, - "documentation":"

Returned if, when uploading an archive, Amazon Glacier times out while receiving the upload.

", - "error":{"httpStatusCode":408}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Client

" - }, - "code":{ - "shape":"string", - "documentation":"

404 Not Found

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't exist.

" - } - }, - "documentation":"

Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "S3Location":{ - "type":"structure", - "members":{ - "BucketName":{ - "shape":"string", - "documentation":"

The name of the Amazon S3 bucket where the job results are stored.

" - }, - "Prefix":{ - "shape":"string", - "documentation":"

The prefix that is prepended to the results for this request.

" - }, - "Encryption":{ - "shape":"Encryption", - "documentation":"

Contains information about the encryption used to store the job results in Amazon S3.

" - }, - "CannedACL":{ - "shape":"CannedACL", - "documentation":"

The canned access control list (ACL) to apply to the job results.

" - }, - "AccessControlList":{ - "shape":"AccessControlPolicyList", - "documentation":"

A list of grants that control access to the staged results.

" - }, - "Tagging":{ - "shape":"hashmap", - "documentation":"

The tag-set that is applied to the job results.

" - }, - "UserMetadata":{ - "shape":"hashmap", - "documentation":"

A map of metadata to store with the job results in Amazon S3.

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The storage class used to store the job results.

" - } - }, - "documentation":"

Contains information about the location in Amazon S3 where the select job results are stored.

" - }, - "SelectParameters":{ - "type":"structure", - "members":{ - "InputSerialization":{ - "shape":"InputSerialization", - "documentation":"

Describes the serialization format of the object.

" - }, - "ExpressionType":{ - "shape":"ExpressionType", - "documentation":"

The type of the provided expression, for example SQL.

" - }, - "Expression":{ - "shape":"string", - "documentation":"

The expression that is used to select the object.

" - }, - "OutputSerialization":{ - "shape":"OutputSerialization", - "documentation":"

Describes how the results of the select job are serialized.

" - } - }, - "documentation":"

Contains information about the parameters used for a select.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "type":{ - "shape":"string", - "documentation":"

Server

" - }, - "code":{ - "shape":"string", - "documentation":"

500 Internal Server Error

" - }, - "message":{ - "shape":"string", - "documentation":"

Returned if the service cannot complete the request.

" - } - }, - "documentation":"

Returned if the service cannot complete the request.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "SetDataRetrievalPolicyInput":{ - "type":"structure", - "required":["accountId"], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "Policy":{ - "shape":"DataRetrievalPolicy", - "documentation":"

The data retrieval policy in JSON format.

" - } - }, - "documentation":"

SetDataRetrievalPolicy input.

" - }, - "SetVaultAccessPolicyInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "policy":{ - "shape":"VaultAccessPolicy", - "documentation":"

The vault access policy as a JSON string.

" - } - }, - "documentation":"

SetVaultAccessPolicy input.

", - "payload":"policy" - }, - "SetVaultNotificationsInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "vaultNotificationConfig":{ - "shape":"VaultNotificationConfig", - "documentation":"

Provides options for specifying notification configuration.

" - } - }, - "documentation":"

Provides options to configure notifications that will be sent when specific events happen to a vault.

", - "payload":"vaultNotificationConfig" - }, - "Size":{"type":"long"}, - "StatusCode":{ - "type":"string", - "enum":[ - "InProgress", - "Succeeded", - "Failed" - ] - }, - "StorageClass":{ - "type":"string", - "enum":[ - "STANDARD", - "REDUCED_REDUNDANCY", - "STANDARD_IA" - ] - }, - "Stream":{ - "type":"blob", - "streaming":true - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{"shape":"string"} - }, - "TagMap":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"} - }, - "TagValue":{"type":"string"}, - "Type":{ - "type":"string", - "enum":[ - "AmazonCustomerByEmail", - "CanonicalUser", - "Group" - ] - }, - "UploadArchiveInput":{ - "type":"structure", - "required":[ - "vaultName", - "accountId" - ], - "members":{ - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "archiveDescription":{ - "shape":"string", - "documentation":"

The optional description of the archive you are uploading.

", - "location":"header", - "locationName":"x-amz-archive-description" - }, - "checksum":{ - "shape":"string", - "documentation":"

The SHA256 tree hash of the data being uploaded.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - }, - "body":{ - "shape":"Stream", - "documentation":"

The data to upload.

" - } - }, - "documentation":"

Provides options to add an archive to a vault.

", - "payload":"body" - }, - "UploadListElement":{ - "type":"structure", - "members":{ - "MultipartUploadId":{ - "shape":"string", - "documentation":"

The ID of a multipart upload.

" - }, - "VaultARN":{ - "shape":"string", - "documentation":"

The Amazon Resource Name (ARN) of the vault that contains the archive.

" - }, - "ArchiveDescription":{ - "shape":"string", - "documentation":"

The description of the archive that was specified in the Initiate Multipart Upload request.

" - }, - "PartSizeInBytes":{ - "shape":"long", - "documentation":"

The part size, in bytes, specified in the Initiate Multipart Upload request. This is the size of all the parts in the upload except the last part, which may be smaller than this size.

" - }, - "CreationDate":{ - "shape":"string", - "documentation":"

The UTC time at which the multipart upload was initiated.

" - } - }, - "documentation":"

A list of in-progress multipart uploads for a vault.

" - }, - "UploadMultipartPartInput":{ - "type":"structure", - "required":[ - "accountId", - "vaultName", - "uploadId" - ], - "members":{ - "accountId":{ - "shape":"string", - "documentation":"

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens ('-') in the ID.

", - "location":"uri", - "locationName":"accountId" - }, - "vaultName":{ - "shape":"string", - "documentation":"

The name of the vault.

", - "location":"uri", - "locationName":"vaultName" - }, - "uploadId":{ - "shape":"string", - "documentation":"

The upload ID of the multipart upload.

", - "location":"uri", - "locationName":"uploadId" - }, - "checksum":{ - "shape":"string", - "documentation":"

The SHA256 tree hash of the data being uploaded.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - }, - "range":{ - "shape":"string", - "documentation":"

Identifies the range of bytes in the assembled archive that will be uploaded in this part. Amazon Glacier uses this information to assemble the archive in the proper sequence. The format of this header follows RFC 2616. An example header is Content-Range:bytes 0-4194303/*.

", - "location":"header", - "locationName":"Content-Range" - }, - "body":{ - "shape":"Stream", - "documentation":"

The data to upload.

" - } - }, - "documentation":"

Provides options to upload a part of an archive in a multipart upload operation.

", - "payload":"body" - }, - "UploadMultipartPartOutput":{ - "type":"structure", - "members":{ - "checksum":{ - "shape":"string", - "documentation":"

The SHA256 tree hash that Amazon Glacier computed for the uploaded part.

", - "location":"header", - "locationName":"x-amz-sha256-tree-hash" - } - }, - "documentation":"

Contains the Amazon Glacier response to your request.

" - }, - "UploadsList":{ - "type":"list", - "member":{"shape":"UploadListElement"} - }, - "VaultAccessPolicy":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"string", - "documentation":"

The vault access policy.

" - } - }, - "documentation":"

Contains the vault access policy.

" - }, - "VaultList":{ - "type":"list", - "member":{"shape":"DescribeVaultOutput"} - }, - "VaultLockPolicy":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"string", - "documentation":"

The vault lock policy.

" - } - }, - "documentation":"

Contains the vault lock policy.

" - }, - "VaultNotificationConfig":{ - "type":"structure", - "members":{ - "SNSTopic":{ - "shape":"string", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) topic Amazon Resource Name (ARN).

" - }, - "Events":{ - "shape":"NotificationEventList", - "documentation":"

A list of one or more events for which Amazon Glacier will send a notification to the specified Amazon SNS topic.

" - } - }, - "documentation":"

Represents a vault's notification configuration.

" - }, - "boolean":{"type":"boolean"}, - "hashmap":{ - "type":"map", - "key":{"shape":"string"}, - "value":{"shape":"string"} - }, - "httpstatus":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"} - }, - "documentation":"

Amazon Glacier is a storage solution for \"cold data.\"

Amazon Glacier is an extremely low-cost storage service that provides secure, durable, and easy-to-use storage for data backup and archival. With Amazon Glacier, customers can store their data cost effectively for months, years, or decades. Amazon Glacier also enables customers to offload the administrative burdens of operating and scaling storage to AWS, so they don't have to worry about capacity planning, hardware provisioning, data replication, hardware failure and recovery, or time-consuming hardware migrations.

Amazon Glacier is a great storage choice when low storage cost is paramount and your data is rarely retrieved. If your application requires fast or frequent access to your data, consider using Amazon S3. For more information, see Amazon Simple Storage Service (Amazon S3).

You can store any kind of data in any format. There is no maximum limit on the total amount of data you can store in Amazon Glacier.

If you are a first-time user of Amazon Glacier, we recommend that you begin by reading the following sections in the Amazon Glacier Developer Guide:

  • What is Amazon Glacier - This section of the Developer Guide describes the underlying data model, the operations it supports, and the AWS SDKs that you can use to interact with the service.

  • Getting Started with Amazon Glacier - The Getting Started section walks you through the process of creating a vault, uploading archives, creating jobs to download archives, retrieving the job output, and deleting archives.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/waiters-2.json deleted file mode 100644 index 07a64a05..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glacier/2012-06-01/waiters-2.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "version": 2, - "waiters": { - "VaultExists": { - "operation": "DescribeVault", - "delay": 3, - "maxAttempts": 15, - "acceptors": [ - { - "state": "success", - "matcher": "status", - "expected": 200 - }, - { - "state": "retry", - "matcher": "error", - "expected": "ResourceNotFoundException" - } - ] - }, - "VaultNotExists": { - "operation": "DescribeVault", - "delay": 3, - "maxAttempts": 15, - "acceptors": [ - { - "state": "retry", - "matcher": "status", - "expected": 200 - }, - { - "state": "success", - "matcher": "error", - "expected": "ResourceNotFoundException" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/paginators-1.json deleted file mode 100644 index e90ffafe..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/paginators-1.json +++ /dev/null @@ -1,82 +0,0 @@ -{ - "pagination": { - "GetJobs": { - "result_key": "Jobs", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetPartitions": { - "result_key": "Partitions", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetDatabases": { - "result_key": "DatabaseList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetClassifiers": { - "result_key": "Classifiers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetTableVersions": { - "result_key": "TableVersions", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetCrawlers": { - "result_key": "Crawlers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetDevEndpoints": { - "result_key": "DevEndpoints", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetJobRuns": { - "result_key": "JobRuns", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetTriggers": { - "result_key": "Triggers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetTables": { - "result_key": "TableList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetUserDefinedFunctions": { - "result_key": "UserDefinedFunctions", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetCrawlerMetrics": { - "result_key": "CrawlerMetricsList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetConnections": { - "result_key": "ConnectionList", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/service-2.json deleted file mode 100644 index 58b569d7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/glue/2017-03-31/service-2.json +++ /dev/null @@ -1,6120 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-03-31", - "endpointPrefix":"glue", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Glue", - "serviceId":"Glue", - "signatureVersion":"v4", - "targetPrefix":"AWSGlue", - "uid":"glue-2017-03-31" - }, - "operations":{ - "BatchCreatePartition":{ - "name":"BatchCreatePartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchCreatePartitionRequest"}, - "output":{"shape":"BatchCreatePartitionResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Creates one or more partitions in a batch operation.

" - }, - "BatchDeleteConnection":{ - "name":"BatchDeleteConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteConnectionRequest"}, - "output":{"shape":"BatchDeleteConnectionResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a list of connection definitions from the Data Catalog.

" - }, - "BatchDeletePartition":{ - "name":"BatchDeletePartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeletePartitionRequest"}, - "output":{"shape":"BatchDeletePartitionResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes one or more partitions in a batch operation.

" - }, - "BatchDeleteTable":{ - "name":"BatchDeleteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteTableRequest"}, - "output":{"shape":"BatchDeleteTableResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes multiple tables at once.

" - }, - "BatchDeleteTableVersion":{ - "name":"BatchDeleteTableVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteTableVersionRequest"}, - "output":{"shape":"BatchDeleteTableVersionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a specified batch of versions of a table.

" - }, - "BatchGetPartition":{ - "name":"BatchGetPartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchGetPartitionRequest"}, - "output":{"shape":"BatchGetPartitionResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves partitions in a batch request.

" - }, - "BatchStopJobRun":{ - "name":"BatchStopJobRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchStopJobRunRequest"}, - "output":{"shape":"BatchStopJobRunResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Stops one or more job runs for a specified job definition.

" - }, - "CreateClassifier":{ - "name":"CreateClassifier", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClassifierRequest"}, - "output":{"shape":"CreateClassifierResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Creates a classifier in the user's account. This may be a GrokClassifier, an XMLClassifier, or abbrev JsonClassifier, depending on which field of the request is present.

" - }, - "CreateConnection":{ - "name":"CreateConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConnectionRequest"}, - "output":{"shape":"CreateConnectionResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"} - ], - "documentation":"

Creates a connection definition in the Data Catalog.

" - }, - "CreateCrawler":{ - "name":"CreateCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCrawlerRequest"}, - "output":{"shape":"CreateCrawlerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"} - ], - "documentation":"

Creates a new crawler with specified targets, role, configuration, and optional schedule. At least one crawl target must be specified, in the s3Targets field, the jdbcTargets field, or the DynamoDBTargets field.

" - }, - "CreateDatabase":{ - "name":"CreateDatabase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDatabaseRequest"}, - "output":{"shape":"CreateDatabaseResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Creates a new database in a Data Catalog.

" - }, - "CreateDevEndpoint":{ - "name":"CreateDevEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDevEndpointRequest"}, - "output":{"shape":"CreateDevEndpointResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InvalidInputException"}, - {"shape":"ValidationException"}, - {"shape":"ResourceNumberLimitExceededException"} - ], - "documentation":"

Creates a new DevEndpoint.

" - }, - "CreateJob":{ - "name":"CreateJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateJobRequest"}, - "output":{"shape":"CreateJobResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Creates a new job definition.

" - }, - "CreatePartition":{ - "name":"CreatePartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePartitionRequest"}, - "output":{"shape":"CreatePartitionResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Creates a new partition.

" - }, - "CreateScript":{ - "name":"CreateScript", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateScriptRequest"}, - "output":{"shape":"CreateScriptResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Transforms a directed acyclic graph (DAG) into code.

" - }, - "CreateTable":{ - "name":"CreateTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTableRequest"}, - "output":{"shape":"CreateTableResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Creates a new table definition in the Data Catalog.

" - }, - "CreateTrigger":{ - "name":"CreateTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTriggerRequest"}, - "output":{"shape":"CreateTriggerResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidInputException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Creates a new trigger.

" - }, - "CreateUserDefinedFunction":{ - "name":"CreateUserDefinedFunction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserDefinedFunctionRequest"}, - "output":{"shape":"CreateUserDefinedFunctionResponse"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"} - ], - "documentation":"

Creates a new function definition in the Data Catalog.

" - }, - "DeleteClassifier":{ - "name":"DeleteClassifier", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClassifierRequest"}, - "output":{"shape":"DeleteClassifierResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Removes a classifier from the Data Catalog.

" - }, - "DeleteConnection":{ - "name":"DeleteConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConnectionRequest"}, - "output":{"shape":"DeleteConnectionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a connection from the Data Catalog.

" - }, - "DeleteCrawler":{ - "name":"DeleteCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCrawlerRequest"}, - "output":{"shape":"DeleteCrawlerResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"CrawlerRunningException"}, - {"shape":"SchedulerTransitioningException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Removes a specified crawler from the Data Catalog, unless the crawler state is RUNNING.

" - }, - "DeleteDatabase":{ - "name":"DeleteDatabase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDatabaseRequest"}, - "output":{"shape":"DeleteDatabaseResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Removes a specified Database from a Data Catalog.

" - }, - "DeleteDevEndpoint":{ - "name":"DeleteDevEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDevEndpointRequest"}, - "output":{"shape":"DeleteDevEndpointResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Deletes a specified DevEndpoint.

" - }, - "DeleteJob":{ - "name":"DeleteJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteJobRequest"}, - "output":{"shape":"DeleteJobResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a specified job definition. If the job definition is not found, no exception is thrown.

" - }, - "DeletePartition":{ - "name":"DeletePartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePartitionRequest"}, - "output":{"shape":"DeletePartitionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a specified partition.

" - }, - "DeleteTable":{ - "name":"DeleteTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTableRequest"}, - "output":{"shape":"DeleteTableResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Removes a table definition from the Data Catalog.

" - }, - "DeleteTableVersion":{ - "name":"DeleteTableVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTableVersionRequest"}, - "output":{"shape":"DeleteTableVersionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes a specified version of a table.

" - }, - "DeleteTrigger":{ - "name":"DeleteTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTriggerRequest"}, - "output":{"shape":"DeleteTriggerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes a specified trigger. If the trigger is not found, no exception is thrown.

" - }, - "DeleteUserDefinedFunction":{ - "name":"DeleteUserDefinedFunction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserDefinedFunctionRequest"}, - "output":{"shape":"DeleteUserDefinedFunctionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Deletes an existing function definition from the Data Catalog.

" - }, - "GetCatalogImportStatus":{ - "name":"GetCatalogImportStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCatalogImportStatusRequest"}, - "output":{"shape":"GetCatalogImportStatusResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves the status of a migration operation.

" - }, - "GetClassifier":{ - "name":"GetClassifier", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetClassifierRequest"}, - "output":{"shape":"GetClassifierResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieve a classifier by name.

" - }, - "GetClassifiers":{ - "name":"GetClassifiers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetClassifiersRequest"}, - "output":{"shape":"GetClassifiersResponse"}, - "errors":[ - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Lists all classifier objects in the Data Catalog.

" - }, - "GetConnection":{ - "name":"GetConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConnectionRequest"}, - "output":{"shape":"GetConnectionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves a connection definition from the Data Catalog.

" - }, - "GetConnections":{ - "name":"GetConnections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConnectionsRequest"}, - "output":{"shape":"GetConnectionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves a list of connection definitions from the Data Catalog.

" - }, - "GetCrawler":{ - "name":"GetCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCrawlerRequest"}, - "output":{"shape":"GetCrawlerResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves metadata for a specified crawler.

" - }, - "GetCrawlerMetrics":{ - "name":"GetCrawlerMetrics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCrawlerMetricsRequest"}, - "output":{"shape":"GetCrawlerMetricsResponse"}, - "errors":[ - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves metrics about specified crawlers.

" - }, - "GetCrawlers":{ - "name":"GetCrawlers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCrawlersRequest"}, - "output":{"shape":"GetCrawlersResponse"}, - "errors":[ - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves metadata for all crawlers defined in the customer account.

" - }, - "GetDatabase":{ - "name":"GetDatabase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDatabaseRequest"}, - "output":{"shape":"GetDatabaseResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves the definition of a specified database.

" - }, - "GetDatabases":{ - "name":"GetDatabases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDatabasesRequest"}, - "output":{"shape":"GetDatabasesResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves all Databases defined in a given Data Catalog.

" - }, - "GetDataflowGraph":{ - "name":"GetDataflowGraph", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDataflowGraphRequest"}, - "output":{"shape":"GetDataflowGraphResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Transforms a Python script into a directed acyclic graph (DAG).

" - }, - "GetDevEndpoint":{ - "name":"GetDevEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDevEndpointRequest"}, - "output":{"shape":"GetDevEndpointResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Retrieves information about a specified DevEndpoint.

" - }, - "GetDevEndpoints":{ - "name":"GetDevEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDevEndpointsRequest"}, - "output":{"shape":"GetDevEndpointsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Retrieves all the DevEndpoints in this AWS account.

" - }, - "GetJob":{ - "name":"GetJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobRequest"}, - "output":{"shape":"GetJobResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves an existing job definition.

" - }, - "GetJobRun":{ - "name":"GetJobRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobRunRequest"}, - "output":{"shape":"GetJobRunResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves the metadata for a given job run.

" - }, - "GetJobRuns":{ - "name":"GetJobRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobRunsRequest"}, - "output":{"shape":"GetJobRunsResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves metadata for all runs of a given job definition.

" - }, - "GetJobs":{ - "name":"GetJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobsRequest"}, - "output":{"shape":"GetJobsResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves all current job definitions.

" - }, - "GetMapping":{ - "name":"GetMapping", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMappingRequest"}, - "output":{"shape":"GetMappingResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"EntityNotFoundException"} - ], - "documentation":"

Creates mappings.

" - }, - "GetPartition":{ - "name":"GetPartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPartitionRequest"}, - "output":{"shape":"GetPartitionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves information about a specified partition.

" - }, - "GetPartitions":{ - "name":"GetPartitions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPartitionsRequest"}, - "output":{"shape":"GetPartitionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves information about the partitions in a table.

" - }, - "GetPlan":{ - "name":"GetPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPlanRequest"}, - "output":{"shape":"GetPlanResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Gets code to perform a specified mapping.

" - }, - "GetTable":{ - "name":"GetTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTableRequest"}, - "output":{"shape":"GetTableResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves the Table definition in a Data Catalog for a specified table.

" - }, - "GetTableVersion":{ - "name":"GetTableVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTableVersionRequest"}, - "output":{"shape":"GetTableVersionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves a specified version of a table.

" - }, - "GetTableVersions":{ - "name":"GetTableVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTableVersionsRequest"}, - "output":{"shape":"GetTableVersionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves a list of strings that identify available versions of a specified table.

" - }, - "GetTables":{ - "name":"GetTables", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTablesRequest"}, - "output":{"shape":"GetTablesResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves the definitions of some or all of the tables in a given Database.

" - }, - "GetTrigger":{ - "name":"GetTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTriggerRequest"}, - "output":{"shape":"GetTriggerResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves the definition of a trigger.

" - }, - "GetTriggers":{ - "name":"GetTriggers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTriggersRequest"}, - "output":{"shape":"GetTriggersResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Gets all the triggers associated with a job.

" - }, - "GetUserDefinedFunction":{ - "name":"GetUserDefinedFunction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserDefinedFunctionRequest"}, - "output":{"shape":"GetUserDefinedFunctionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Retrieves a specified function definition from the Data Catalog.

" - }, - "GetUserDefinedFunctions":{ - "name":"GetUserDefinedFunctions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserDefinedFunctionsRequest"}, - "output":{"shape":"GetUserDefinedFunctionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Retrieves a multiple function definitions from the Data Catalog.

" - }, - "ImportCatalogToGlue":{ - "name":"ImportCatalogToGlue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportCatalogToGlueRequest"}, - "output":{"shape":"ImportCatalogToGlueResponse"}, - "errors":[ - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Imports an existing Athena Data Catalog to AWS Glue

" - }, - "ResetJobBookmark":{ - "name":"ResetJobBookmark", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetJobBookmarkRequest"}, - "output":{"shape":"ResetJobBookmarkResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Resets a bookmark entry.

" - }, - "StartCrawler":{ - "name":"StartCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartCrawlerRequest"}, - "output":{"shape":"StartCrawlerResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"CrawlerRunningException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Starts a crawl using the specified crawler, regardless of what is scheduled. If the crawler is already running, returns a CrawlerRunningException.

" - }, - "StartCrawlerSchedule":{ - "name":"StartCrawlerSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartCrawlerScheduleRequest"}, - "output":{"shape":"StartCrawlerScheduleResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"SchedulerRunningException"}, - {"shape":"SchedulerTransitioningException"}, - {"shape":"NoScheduleException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Changes the schedule state of the specified crawler to SCHEDULED, unless the crawler is already running or the schedule state is already SCHEDULED.

" - }, - "StartJobRun":{ - "name":"StartJobRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartJobRunRequest"}, - "output":{"shape":"StartJobRunResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"ConcurrentRunsExceededException"} - ], - "documentation":"

Starts a job run using a job definition.

" - }, - "StartTrigger":{ - "name":"StartTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartTriggerRequest"}, - "output":{"shape":"StartTriggerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ResourceNumberLimitExceededException"}, - {"shape":"ConcurrentRunsExceededException"} - ], - "documentation":"

Starts an existing trigger. See Triggering Jobs for information about how different types of trigger are started.

" - }, - "StopCrawler":{ - "name":"StopCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopCrawlerRequest"}, - "output":{"shape":"StopCrawlerResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"CrawlerNotRunningException"}, - {"shape":"CrawlerStoppingException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

If the specified crawler is running, stops the crawl.

" - }, - "StopCrawlerSchedule":{ - "name":"StopCrawlerSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopCrawlerScheduleRequest"}, - "output":{"shape":"StopCrawlerScheduleResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"SchedulerNotRunningException"}, - {"shape":"SchedulerTransitioningException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Sets the schedule state of the specified crawler to NOT_SCHEDULED, but does not stop the crawler if it is already running.

" - }, - "StopTrigger":{ - "name":"StopTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopTriggerRequest"}, - "output":{"shape":"StopTriggerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Stops a specified trigger.

" - }, - "UpdateClassifier":{ - "name":"UpdateClassifier", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateClassifierRequest"}, - "output":{"shape":"UpdateClassifierResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"VersionMismatchException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Modifies an existing classifier (a GrokClassifier, XMLClassifier, or JsonClassifier, depending on which field is present).

" - }, - "UpdateConnection":{ - "name":"UpdateConnection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConnectionRequest"}, - "output":{"shape":"UpdateConnectionResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates a connection definition in the Data Catalog.

" - }, - "UpdateCrawler":{ - "name":"UpdateCrawler", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCrawlerRequest"}, - "output":{"shape":"UpdateCrawlerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"VersionMismatchException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"CrawlerRunningException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates a crawler. If a crawler is running, you must stop it using StopCrawler before updating it.

" - }, - "UpdateCrawlerSchedule":{ - "name":"UpdateCrawlerSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCrawlerScheduleRequest"}, - "output":{"shape":"UpdateCrawlerScheduleResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"VersionMismatchException"}, - {"shape":"SchedulerTransitioningException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates the schedule of a crawler using a cron expression.

" - }, - "UpdateDatabase":{ - "name":"UpdateDatabase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDatabaseRequest"}, - "output":{"shape":"UpdateDatabaseResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates an existing database definition in a Data Catalog.

" - }, - "UpdateDevEndpoint":{ - "name":"UpdateDevEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDevEndpointRequest"}, - "output":{"shape":"UpdateDevEndpointResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"InvalidInputException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Updates a specified DevEndpoint.

" - }, - "UpdateJob":{ - "name":"UpdateJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateJobRequest"}, - "output":{"shape":"UpdateJobResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Updates an existing job definition.

" - }, - "UpdatePartition":{ - "name":"UpdatePartition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePartitionRequest"}, - "output":{"shape":"UpdatePartitionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates a partition.

" - }, - "UpdateTable":{ - "name":"UpdateTable", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTableRequest"}, - "output":{"shape":"UpdateTableResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ResourceNumberLimitExceededException"} - ], - "documentation":"

Updates a metadata table in the Data Catalog.

" - }, - "UpdateTrigger":{ - "name":"UpdateTrigger", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTriggerRequest"}, - "output":{"shape":"UpdateTriggerResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"OperationTimeoutException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Updates a trigger definition.

" - }, - "UpdateUserDefinedFunction":{ - "name":"UpdateUserDefinedFunction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserDefinedFunctionRequest"}, - "output":{"shape":"UpdateUserDefinedFunctionResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"InternalServiceException"}, - {"shape":"OperationTimeoutException"} - ], - "documentation":"

Updates an existing function definition in the Data Catalog.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

Access to a resource was denied.

", - "exception":true - }, - "Action":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of a job to be executed.

" - }, - "Arguments":{ - "shape":"GenericMap", - "documentation":"

Arguments to be passed to the job.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own Job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job run timeout in minutes. It overrides the timeout value of the job.

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job run notification.

" - } - }, - "documentation":"

Defines an action to be initiated by a trigger.

" - }, - "ActionList":{ - "type":"list", - "member":{"shape":"Action"} - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

A resource to be created or added already exists.

", - "exception":true - }, - "AttemptCount":{"type":"integer"}, - "BatchCreatePartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionInputList" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the catalog in which the partion is to be created. Currently, this should be the AWS account ID.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the metadata database in which the partition is to be created.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the metadata table in which the partition is to be created.

" - }, - "PartitionInputList":{ - "shape":"PartitionInputList", - "documentation":"

A list of PartitionInput structures that define the partitions to be created.

" - } - } - }, - "BatchCreatePartitionResponse":{ - "type":"structure", - "members":{ - "Errors":{ - "shape":"PartitionErrors", - "documentation":"

Errors encountered when trying to create the requested partitions.

" - } - } - }, - "BatchDeleteConnectionRequest":{ - "type":"structure", - "required":["ConnectionNameList"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the connections reside. If none is supplied, the AWS account ID is used by default.

" - }, - "ConnectionNameList":{ - "shape":"DeleteConnectionNameList", - "documentation":"

A list of names of the connections to delete.

" - } - } - }, - "BatchDeleteConnectionResponse":{ - "type":"structure", - "members":{ - "Succeeded":{ - "shape":"NameStringList", - "documentation":"

A list of names of the connection definitions that were successfully deleted.

" - }, - "Errors":{ - "shape":"ErrorByName", - "documentation":"

A map of the names of connections that were not successfully deleted to error details.

" - } - } - }, - "BatchDeletePartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionsToDelete" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partition to be deleted resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which the table in question resides.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table where the partitions to be deleted is located.

" - }, - "PartitionsToDelete":{ - "shape":"BatchDeletePartitionValueList", - "documentation":"

A list of PartitionInput structures that define the partitions to be deleted.

" - } - } - }, - "BatchDeletePartitionResponse":{ - "type":"structure", - "members":{ - "Errors":{ - "shape":"PartitionErrors", - "documentation":"

Errors encountered when trying to delete the requested partitions.

" - } - } - }, - "BatchDeletePartitionValueList":{ - "type":"list", - "member":{"shape":"PartitionValueList"}, - "max":25, - "min":0 - }, - "BatchDeleteTableNameList":{ - "type":"list", - "member":{"shape":"NameString"}, - "max":100, - "min":0 - }, - "BatchDeleteTableRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TablesToDelete" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the table resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the tables to delete reside. For Hive compatibility, this name is entirely lowercase.

" - }, - "TablesToDelete":{ - "shape":"BatchDeleteTableNameList", - "documentation":"

A list of the table to delete.

" - } - } - }, - "BatchDeleteTableResponse":{ - "type":"structure", - "members":{ - "Errors":{ - "shape":"TableErrors", - "documentation":"

A list of errors encountered in attempting to delete the specified tables.

" - } - } - }, - "BatchDeleteTableVersionList":{ - "type":"list", - "member":{"shape":"VersionString"}, - "max":100, - "min":0 - }, - "BatchDeleteTableVersionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "VersionIds" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the tables reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in the catalog in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table. For Hive compatibility, this name is entirely lowercase.

" - }, - "VersionIds":{ - "shape":"BatchDeleteTableVersionList", - "documentation":"

A list of the IDs of versions to be deleted.

" - } - } - }, - "BatchDeleteTableVersionResponse":{ - "type":"structure", - "members":{ - "Errors":{ - "shape":"TableVersionErrors", - "documentation":"

A list of errors encountered while trying to delete the specified table versions.

" - } - } - }, - "BatchGetPartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionsToGet" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partitions in question reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the partitions reside.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the partitions' table.

" - }, - "PartitionsToGet":{ - "shape":"BatchGetPartitionValueList", - "documentation":"

A list of partition values identifying the partitions to retrieve.

" - } - } - }, - "BatchGetPartitionResponse":{ - "type":"structure", - "members":{ - "Partitions":{ - "shape":"PartitionList", - "documentation":"

A list of the requested partitions.

" - }, - "UnprocessedKeys":{ - "shape":"BatchGetPartitionValueList", - "documentation":"

A list of the partition values in the request for which partions were not returned.

" - } - } - }, - "BatchGetPartitionValueList":{ - "type":"list", - "member":{"shape":"PartitionValueList"}, - "max":1000, - "min":0 - }, - "BatchStopJobRunError":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition used in the job run in question.

" - }, - "JobRunId":{ - "shape":"IdString", - "documentation":"

The JobRunId of the job run in question.

" - }, - "ErrorDetail":{ - "shape":"ErrorDetail", - "documentation":"

Specifies details about the error that was encountered.

" - } - }, - "documentation":"

Records an error that occurred when attempting to stop a specified job run.

" - }, - "BatchStopJobRunErrorList":{ - "type":"list", - "member":{"shape":"BatchStopJobRunError"} - }, - "BatchStopJobRunJobRunIdList":{ - "type":"list", - "member":{"shape":"IdString"}, - "max":25, - "min":1 - }, - "BatchStopJobRunRequest":{ - "type":"structure", - "required":[ - "JobName", - "JobRunIds" - ], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition for which to stop job runs.

" - }, - "JobRunIds":{ - "shape":"BatchStopJobRunJobRunIdList", - "documentation":"

A list of the JobRunIds that should be stopped for that job definition.

" - } - } - }, - "BatchStopJobRunResponse":{ - "type":"structure", - "members":{ - "SuccessfulSubmissions":{ - "shape":"BatchStopJobRunSuccessfulSubmissionList", - "documentation":"

A list of the JobRuns that were successfully submitted for stopping.

" - }, - "Errors":{ - "shape":"BatchStopJobRunErrorList", - "documentation":"

A list of the errors that were encountered in tryng to stop JobRuns, including the JobRunId for which each error was encountered and details about the error.

" - } - } - }, - "BatchStopJobRunSuccessfulSubmission":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition used in the job run that was stopped.

" - }, - "JobRunId":{ - "shape":"IdString", - "documentation":"

The JobRunId of the job run that was stopped.

" - } - }, - "documentation":"

Records a successful request to stop a specified JobRun.

" - }, - "BatchStopJobRunSuccessfulSubmissionList":{ - "type":"list", - "member":{"shape":"BatchStopJobRunSuccessfulSubmission"} - }, - "Boolean":{"type":"boolean"}, - "BooleanNullable":{"type":"boolean"}, - "BooleanValue":{"type":"boolean"}, - "BoundedPartitionValueList":{ - "type":"list", - "member":{"shape":"ValueString"}, - "max":100, - "min":0 - }, - "CatalogEntries":{ - "type":"list", - "member":{"shape":"CatalogEntry"} - }, - "CatalogEntry":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName" - ], - "members":{ - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in which the table metadata resides.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table in question.

" - } - }, - "documentation":"

Specifies a table definition in the Data Catalog.

" - }, - "CatalogIdString":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "CatalogImportStatus":{ - "type":"structure", - "members":{ - "ImportCompleted":{ - "shape":"Boolean", - "documentation":"

True if the migration has completed, or False otherwise.

" - }, - "ImportTime":{ - "shape":"Timestamp", - "documentation":"

The time that the migration was started.

" - }, - "ImportedBy":{ - "shape":"NameString", - "documentation":"

The name of the person who initiated the migration.

" - } - }, - "documentation":"

A structure containing migration status information.

" - }, - "Classification":{"type":"string"}, - "Classifier":{ - "type":"structure", - "members":{ - "GrokClassifier":{ - "shape":"GrokClassifier", - "documentation":"

A GrokClassifier object.

" - }, - "XMLClassifier":{ - "shape":"XMLClassifier", - "documentation":"

An XMLClassifier object.

" - }, - "JsonClassifier":{ - "shape":"JsonClassifier", - "documentation":"

A JsonClassifier object.

" - } - }, - "documentation":"

Classifiers are triggered during a crawl task. A classifier checks whether a given file is in a format it can handle, and if it is, the classifier creates a schema in the form of a StructType object that matches that data format.

You can use the standard classifiers that AWS Glue supplies, or you can write your own classifiers to best categorize your data sources and specify the appropriate schemas to use for them. A classifier can be a grok classifier, an XML classifier, or a JSON classifier, as specified in one of the fields in the Classifier object.

" - }, - "ClassifierList":{ - "type":"list", - "member":{"shape":"Classifier"} - }, - "ClassifierNameList":{ - "type":"list", - "member":{"shape":"NameString"} - }, - "CodeGenArgName":{"type":"string"}, - "CodeGenArgValue":{"type":"string"}, - "CodeGenEdge":{ - "type":"structure", - "required":[ - "Source", - "Target" - ], - "members":{ - "Source":{ - "shape":"CodeGenIdentifier", - "documentation":"

The ID of the node at which the edge starts.

" - }, - "Target":{ - "shape":"CodeGenIdentifier", - "documentation":"

The ID of the node at which the edge ends.

" - }, - "TargetParameter":{ - "shape":"CodeGenArgName", - "documentation":"

The target of the edge.

" - } - }, - "documentation":"

Represents a directional edge in a directed acyclic graph (DAG).

" - }, - "CodeGenIdentifier":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[A-Za-z_][A-Za-z0-9_]*" - }, - "CodeGenNode":{ - "type":"structure", - "required":[ - "Id", - "NodeType", - "Args" - ], - "members":{ - "Id":{ - "shape":"CodeGenIdentifier", - "documentation":"

A node identifier that is unique within the node's graph.

" - }, - "NodeType":{ - "shape":"CodeGenNodeType", - "documentation":"

The type of node this is.

" - }, - "Args":{ - "shape":"CodeGenNodeArgs", - "documentation":"

Properties of the node, in the form of name-value pairs.

" - }, - "LineNumber":{ - "shape":"Integer", - "documentation":"

The line number of the node.

" - } - }, - "documentation":"

Represents a node in a directed acyclic graph (DAG)

" - }, - "CodeGenNodeArg":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"CodeGenArgName", - "documentation":"

The name of the argument or property.

" - }, - "Value":{ - "shape":"CodeGenArgValue", - "documentation":"

The value of the argument or property.

" - }, - "Param":{ - "shape":"Boolean", - "documentation":"

True if the value is used as a parameter.

" - } - }, - "documentation":"

An argument or property of a node.

" - }, - "CodeGenNodeArgs":{ - "type":"list", - "member":{"shape":"CodeGenNodeArg"}, - "max":50, - "min":0 - }, - "CodeGenNodeType":{"type":"string"}, - "Column":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the Column.

" - }, - "Type":{ - "shape":"ColumnTypeString", - "documentation":"

The datatype of data in the Column.

" - }, - "Comment":{ - "shape":"CommentString", - "documentation":"

Free-form text comment.

" - } - }, - "documentation":"

A column in a Table.

" - }, - "ColumnList":{ - "type":"list", - "member":{"shape":"Column"} - }, - "ColumnTypeString":{ - "type":"string", - "max":131072, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "ColumnValueStringList":{ - "type":"list", - "member":{"shape":"ColumnValuesString"} - }, - "ColumnValuesString":{"type":"string"}, - "CommentString":{ - "type":"string", - "max":255, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

Two processes are trying to modify a resource simultaneously.

", - "exception":true - }, - "ConcurrentRunsExceededException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

Too many jobs are being run concurrently.

", - "exception":true - }, - "Condition":{ - "type":"structure", - "members":{ - "LogicalOperator":{ - "shape":"LogicalOperator", - "documentation":"

A logical operator.

" - }, - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the Job to whose JobRuns this condition applies and on which this trigger waits.

" - }, - "State":{ - "shape":"JobRunState", - "documentation":"

The condition state. Currently, the values supported are SUCCEEDED, STOPPED, TIMEOUT and FAILED.

" - } - }, - "documentation":"

Defines a condition under which a trigger fires.

" - }, - "ConditionList":{ - "type":"list", - "member":{"shape":"Condition"} - }, - "Connection":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the connection definition.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the connection.

" - }, - "ConnectionType":{ - "shape":"ConnectionType", - "documentation":"

The type of the connection. Currently, only JDBC is supported; SFTP is not supported.

" - }, - "MatchCriteria":{ - "shape":"MatchCriteria", - "documentation":"

A list of criteria that can be used in selecting this connection.

" - }, - "ConnectionProperties":{ - "shape":"ConnectionProperties", - "documentation":"

A list of key-value pairs used as parameters for this connection.

" - }, - "PhysicalConnectionRequirements":{ - "shape":"PhysicalConnectionRequirements", - "documentation":"

A map of physical connection requirements, such as VPC and SecurityGroup, needed for making this connection successfully.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time this connection definition was created.

" - }, - "LastUpdatedTime":{ - "shape":"Timestamp", - "documentation":"

The last time this connection definition was updated.

" - }, - "LastUpdatedBy":{ - "shape":"NameString", - "documentation":"

The user, group or role that last updated this connection definition.

" - } - }, - "documentation":"

Defines a connection to a data source.

" - }, - "ConnectionInput":{ - "type":"structure", - "required":[ - "Name", - "ConnectionType", - "ConnectionProperties" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the connection.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the connection.

" - }, - "ConnectionType":{ - "shape":"ConnectionType", - "documentation":"

The type of the connection. Currently, only JDBC is supported; SFTP is not supported.

" - }, - "MatchCriteria":{ - "shape":"MatchCriteria", - "documentation":"

A list of criteria that can be used in selecting this connection.

" - }, - "ConnectionProperties":{ - "shape":"ConnectionProperties", - "documentation":"

A list of key-value pairs used as parameters for this connection.

" - }, - "PhysicalConnectionRequirements":{ - "shape":"PhysicalConnectionRequirements", - "documentation":"

A map of physical connection requirements, such as VPC and SecurityGroup, needed for making this connection successfully.

" - } - }, - "documentation":"

A structure used to specify a connection to create or update.

" - }, - "ConnectionList":{ - "type":"list", - "member":{"shape":"Connection"} - }, - "ConnectionName":{"type":"string"}, - "ConnectionProperties":{ - "type":"map", - "key":{"shape":"ConnectionPropertyKey"}, - "value":{"shape":"ValueString"}, - "max":100, - "min":0 - }, - "ConnectionPropertyKey":{ - "type":"string", - "enum":[ - "HOST", - "PORT", - "USERNAME", - "PASSWORD", - "JDBC_DRIVER_JAR_URI", - "JDBC_DRIVER_CLASS_NAME", - "JDBC_ENGINE", - "JDBC_ENGINE_VERSION", - "CONFIG_FILES", - "INSTANCE_ID", - "JDBC_CONNECTION_URL" - ] - }, - "ConnectionType":{ - "type":"string", - "enum":[ - "JDBC", - "SFTP" - ] - }, - "ConnectionsList":{ - "type":"structure", - "members":{ - "Connections":{ - "shape":"StringList", - "documentation":"

A list of connections used by the job.

" - } - }, - "documentation":"

Specifies the connections used by a job.

" - }, - "Crawler":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The crawler name.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM role (or ARN of an IAM role) used to access customer resources, such as data in Amazon S3.

" - }, - "Targets":{ - "shape":"CrawlerTargets", - "documentation":"

A collection of targets to crawl.

" - }, - "DatabaseName":{ - "shape":"DatabaseName", - "documentation":"

The database where metadata is written by this crawler.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A description of the crawler.

" - }, - "Classifiers":{ - "shape":"ClassifierNameList", - "documentation":"

A list of custom classifiers associated with the crawler.

" - }, - "SchemaChangePolicy":{ - "shape":"SchemaChangePolicy", - "documentation":"

Sets the behavior when the crawler finds a changed or deleted object.

" - }, - "State":{ - "shape":"CrawlerState", - "documentation":"

Indicates whether the crawler is running, or whether a run is pending.

" - }, - "TablePrefix":{ - "shape":"TablePrefix", - "documentation":"

The prefix added to the names of tables that are created.

" - }, - "Schedule":{ - "shape":"Schedule", - "documentation":"

For scheduled crawlers, the schedule when the crawler runs.

" - }, - "CrawlElapsedTime":{ - "shape":"MillisecondsCount", - "documentation":"

If the crawler is running, contains the total time elapsed since the last crawl began.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time when the crawler was created.

" - }, - "LastUpdated":{ - "shape":"Timestamp", - "documentation":"

The time the crawler was last updated.

" - }, - "LastCrawl":{ - "shape":"LastCrawlInfo", - "documentation":"

The status of the last crawl, and potentially error information if an error occurred.

" - }, - "Version":{ - "shape":"VersionId", - "documentation":"

The version of the crawler.

" - }, - "Configuration":{ - "shape":"CrawlerConfiguration", - "documentation":"

Crawler configuration information. This versioned JSON string allows users to specify aspects of a crawler's behavior. For more information, see Configuring a Crawler.

" - } - }, - "documentation":"

Specifies a crawler program that examines a data source and uses classifiers to try to determine its schema. If successful, the crawler records metadata concerning the data source in the AWS Glue Data Catalog.

" - }, - "CrawlerConfiguration":{"type":"string"}, - "CrawlerList":{ - "type":"list", - "member":{"shape":"Crawler"} - }, - "CrawlerMetrics":{ - "type":"structure", - "members":{ - "CrawlerName":{ - "shape":"NameString", - "documentation":"

The name of the crawler.

" - }, - "TimeLeftSeconds":{ - "shape":"NonNegativeDouble", - "documentation":"

The estimated time left to complete a running crawl.

" - }, - "StillEstimating":{ - "shape":"Boolean", - "documentation":"

True if the crawler is still estimating how long it will take to complete this run.

" - }, - "LastRuntimeSeconds":{ - "shape":"NonNegativeDouble", - "documentation":"

The duration of the crawler's most recent run, in seconds.

" - }, - "MedianRuntimeSeconds":{ - "shape":"NonNegativeDouble", - "documentation":"

The median duration of this crawler's runs, in seconds.

" - }, - "TablesCreated":{ - "shape":"NonNegativeInteger", - "documentation":"

The number of tables created by this crawler.

" - }, - "TablesUpdated":{ - "shape":"NonNegativeInteger", - "documentation":"

The number of tables updated by this crawler.

" - }, - "TablesDeleted":{ - "shape":"NonNegativeInteger", - "documentation":"

The number of tables deleted by this crawler.

" - } - }, - "documentation":"

Metrics for a specified crawler.

" - }, - "CrawlerMetricsList":{ - "type":"list", - "member":{"shape":"CrawlerMetrics"} - }, - "CrawlerNameList":{ - "type":"list", - "member":{"shape":"NameString"}, - "max":100, - "min":0 - }, - "CrawlerNotRunningException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The specified crawler is not running.

", - "exception":true - }, - "CrawlerRunningException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The operation cannot be performed because the crawler is already running.

", - "exception":true - }, - "CrawlerState":{ - "type":"string", - "enum":[ - "READY", - "RUNNING", - "STOPPING" - ] - }, - "CrawlerStoppingException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The specified crawler is stopping.

", - "exception":true - }, - "CrawlerTargets":{ - "type":"structure", - "members":{ - "S3Targets":{ - "shape":"S3TargetList", - "documentation":"

Specifies Amazon S3 targets.

" - }, - "JdbcTargets":{ - "shape":"JdbcTargetList", - "documentation":"

Specifies JDBC targets.

" - }, - "DynamoDBTargets":{ - "shape":"DynamoDBTargetList", - "documentation":"

Specifies DynamoDB targets.

" - } - }, - "documentation":"

Specifies data stores to crawl.

" - }, - "CreateClassifierRequest":{ - "type":"structure", - "members":{ - "GrokClassifier":{ - "shape":"CreateGrokClassifierRequest", - "documentation":"

A GrokClassifier object specifying the classifier to create.

" - }, - "XMLClassifier":{ - "shape":"CreateXMLClassifierRequest", - "documentation":"

An XMLClassifier object specifying the classifier to create.

" - }, - "JsonClassifier":{ - "shape":"CreateJsonClassifierRequest", - "documentation":"

A JsonClassifier object specifying the classifier to create.

" - } - } - }, - "CreateClassifierResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateConnectionRequest":{ - "type":"structure", - "required":["ConnectionInput"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which to create the connection. If none is supplied, the AWS account ID is used by default.

" - }, - "ConnectionInput":{ - "shape":"ConnectionInput", - "documentation":"

A ConnectionInput object defining the connection to create.

" - } - } - }, - "CreateConnectionResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateCrawlerRequest":{ - "type":"structure", - "required":[ - "Name", - "Role", - "DatabaseName", - "Targets" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the new crawler.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM role (or ARN of an IAM role) used by the new crawler to access customer resources.

" - }, - "DatabaseName":{ - "shape":"DatabaseName", - "documentation":"

The AWS Glue database where results are written, such as: arn:aws:daylight:us-east-1::database/sometable/*.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A description of the new crawler.

" - }, - "Targets":{ - "shape":"CrawlerTargets", - "documentation":"

A list of collection of targets to crawl.

" - }, - "Schedule":{ - "shape":"CronExpression", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - }, - "Classifiers":{ - "shape":"ClassifierNameList", - "documentation":"

A list of custom classifiers that the user has registered. By default, all built-in classifiers are included in a crawl, but these custom classifiers always override the default classifiers for a given classification.

" - }, - "TablePrefix":{ - "shape":"TablePrefix", - "documentation":"

The table prefix used for catalog tables that are created.

" - }, - "SchemaChangePolicy":{ - "shape":"SchemaChangePolicy", - "documentation":"

Policy for the crawler's update and deletion behavior.

" - }, - "Configuration":{ - "shape":"CrawlerConfiguration", - "documentation":"

Crawler configuration information. This versioned JSON string allows users to specify aspects of a crawler's behavior. For more information, see Configuring a Crawler.

" - } - } - }, - "CreateCrawlerResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateDatabaseRequest":{ - "type":"structure", - "required":["DatabaseInput"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which to create the database. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseInput":{ - "shape":"DatabaseInput", - "documentation":"

A DatabaseInput object defining the metadata database to create in the catalog.

" - } - } - }, - "CreateDatabaseResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateDevEndpointRequest":{ - "type":"structure", - "required":[ - "EndpointName", - "RoleArn" - ], - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

The name to be assigned to the new DevEndpoint.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The IAM role for the DevEndpoint.

" - }, - "SecurityGroupIds":{ - "shape":"StringList", - "documentation":"

Security group IDs for the security groups to be used by the new DevEndpoint.

" - }, - "SubnetId":{ - "shape":"GenericString", - "documentation":"

The subnet ID for the new DevEndpoint to use.

" - }, - "PublicKey":{ - "shape":"GenericString", - "documentation":"

The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.

" - }, - "PublicKeys":{ - "shape":"PublicKeysList", - "documentation":"

A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.

If you previously created an endpoint with a public key, you must remove that key to be able to set a list of public keys: call the UpdateDevEndpoint API with the public key content in the deletePublicKeys attribute, and the list of new keys in the addPublicKeys attribute.

" - }, - "NumberOfNodes":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue Data Processing Units (DPUs) to allocate to this DevEndpoint.

" - }, - "ExtraPythonLibsS3Path":{ - "shape":"GenericString", - "documentation":"

Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.

Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.

" - }, - "ExtraJarsS3Path":{ - "shape":"GenericString", - "documentation":"

Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.

" - } - } - }, - "CreateDevEndpointResponse":{ - "type":"structure", - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

The name assigned to the new DevEndpoint.

" - }, - "Status":{ - "shape":"GenericString", - "documentation":"

The current status of the new DevEndpoint.

" - }, - "SecurityGroupIds":{ - "shape":"StringList", - "documentation":"

The security groups assigned to the new DevEndpoint.

" - }, - "SubnetId":{ - "shape":"GenericString", - "documentation":"

The subnet ID assigned to the new DevEndpoint.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The AWS ARN of the role assigned to the new DevEndpoint.

" - }, - "YarnEndpointAddress":{ - "shape":"GenericString", - "documentation":"

The address of the YARN endpoint used by this DevEndpoint.

" - }, - "ZeppelinRemoteSparkInterpreterPort":{ - "shape":"IntegerValue", - "documentation":"

The Apache Zeppelin port for the remote Apache Spark interpreter.

" - }, - "NumberOfNodes":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.

" - }, - "AvailabilityZone":{ - "shape":"GenericString", - "documentation":"

The AWS availability zone where this DevEndpoint is located.

" - }, - "VpcId":{ - "shape":"GenericString", - "documentation":"

The ID of the VPC used by this DevEndpoint.

" - }, - "ExtraPythonLibsS3Path":{ - "shape":"GenericString", - "documentation":"

Path(s) to one or more Python libraries in an S3 bucket that will be loaded in your DevEndpoint.

" - }, - "ExtraJarsS3Path":{ - "shape":"GenericString", - "documentation":"

Path to one or more Java Jars in an S3 bucket that will be loaded in your DevEndpoint.

" - }, - "FailureReason":{ - "shape":"GenericString", - "documentation":"

The reason for a current failure in this DevEndpoint.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampValue", - "documentation":"

The point in time at which this DevEndpoint was created.

" - } - } - }, - "CreateGrokClassifierRequest":{ - "type":"structure", - "required":[ - "Classification", - "Name", - "GrokPattern" - ], - "members":{ - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches, such as Twitter, JSON, Omniture logs, Amazon CloudWatch Logs, and so on.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the new classifier.

" - }, - "GrokPattern":{ - "shape":"GrokPattern", - "documentation":"

The grok pattern used by this classifier.

" - }, - "CustomPatterns":{ - "shape":"CustomPatterns", - "documentation":"

Optional custom grok patterns used by this classifier.

" - } - }, - "documentation":"

Specifies a grok classifier for CreateClassifier to create.

" - }, - "CreateJobRequest":{ - "type":"structure", - "required":[ - "Name", - "Role", - "Command" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name you assign to this job definition. It must be unique in your account.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the job being defined.

" - }, - "LogUri":{ - "shape":"UriString", - "documentation":"

This field is reserved for future use.

" - }, - "Role":{ - "shape":"RoleString", - "documentation":"

The name or ARN of the IAM role associated with this job.

" - }, - "ExecutionProperty":{ - "shape":"ExecutionProperty", - "documentation":"

An ExecutionProperty specifying the maximum number of concurrent runs allowed for this job.

" - }, - "Command":{ - "shape":"JobCommand", - "documentation":"

The JobCommand that executes this job.

" - }, - "DefaultArguments":{ - "shape":"GenericMap", - "documentation":"

The default arguments for this job.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own Job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "Connections":{ - "shape":"ConnectionsList", - "documentation":"

The connections used for this job.

" - }, - "MaxRetries":{ - "shape":"MaxRetries", - "documentation":"

The maximum number of times to retry this job if it fails.

" - }, - "AllocatedCapacity":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue data processing units (DPUs) to allocate to this Job. From 2 to 100 DPUs can be allocated; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job timeout in minutes. The default is 2880 minutes (48 hours).

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job notification.

" - } - } - }, - "CreateJobResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The unique name that was provided for this job definition.

" - } - } - }, - "CreateJsonClassifierRequest":{ - "type":"structure", - "required":[ - "Name", - "JsonPath" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "JsonPath":{ - "shape":"JsonPath", - "documentation":"

A JsonPath string defining the JSON data for the classifier to classify. AWS Glue supports a subset of JsonPath, as described in Writing JsonPath Custom Classifiers.

" - } - }, - "documentation":"

Specifies a JSON classifier for CreateClassifier to create.

" - }, - "CreatePartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the catalog in which the partion is to be created. Currently, this should be the AWS account ID.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the metadata database in which the partition is to be created.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the metadata table in which the partition is to be created.

" - }, - "PartitionInput":{ - "shape":"PartitionInput", - "documentation":"

A PartitionInput structure defining the partition to be created.

" - } - } - }, - "CreatePartitionResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateScriptRequest":{ - "type":"structure", - "members":{ - "DagNodes":{ - "shape":"DagNodes", - "documentation":"

A list of the nodes in the DAG.

" - }, - "DagEdges":{ - "shape":"DagEdges", - "documentation":"

A list of the edges in the DAG.

" - }, - "Language":{ - "shape":"Language", - "documentation":"

The programming language of the resulting code from the DAG.

" - } - } - }, - "CreateScriptResponse":{ - "type":"structure", - "members":{ - "PythonScript":{ - "shape":"PythonScript", - "documentation":"

The Python script generated from the DAG.

" - }, - "ScalaCode":{ - "shape":"ScalaCode", - "documentation":"

The Scala code generated from the DAG.

" - } - } - }, - "CreateTableRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which to create the Table. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The catalog database in which to create the new table. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableInput":{ - "shape":"TableInput", - "documentation":"

The TableInput object that defines the metadata table to create in the catalog.

" - } - } - }, - "CreateTableResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateTriggerRequest":{ - "type":"structure", - "required":[ - "Name", - "Type", - "Actions" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger.

" - }, - "Type":{ - "shape":"TriggerType", - "documentation":"

The type of the new trigger.

" - }, - "Schedule":{ - "shape":"GenericString", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

This field is required when the trigger type is SCHEDULED.

" - }, - "Predicate":{ - "shape":"Predicate", - "documentation":"

A predicate to specify when the new trigger should fire.

This field is required when the trigger type is CONDITIONAL.

" - }, - "Actions":{ - "shape":"ActionList", - "documentation":"

The actions initiated by this trigger when it fires.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A description of the new trigger.

" - }, - "StartOnCreation":{ - "shape":"BooleanValue", - "documentation":"

Set to true to start SCHEDULED and CONDITIONAL triggers when created. True not supported for ON_DEMAND triggers.

" - } - } - }, - "CreateTriggerResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger.

" - } - } - }, - "CreateUserDefinedFunctionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "FunctionInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which to create the function. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which to create the function.

" - }, - "FunctionInput":{ - "shape":"UserDefinedFunctionInput", - "documentation":"

A FunctionInput object that defines the function to create in the Data Catalog.

" - } - } - }, - "CreateUserDefinedFunctionResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateXMLClassifierRequest":{ - "type":"structure", - "required":[ - "Classification", - "Name" - ], - "members":{ - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "RowTag":{ - "shape":"RowTag", - "documentation":"

The XML tag designating the element that contains each record in an XML document being parsed. Note that this cannot identify a self-closing element (closed by />). An empty row element that contains only attributes can be parsed as long as it ends with a closing tag (for example, <row item_a=\"A\" item_b=\"B\"></row> is okay, but <row item_a=\"A\" item_b=\"B\" /> is not).

" - } - }, - "documentation":"

Specifies an XML classifier for CreateClassifier to create.

" - }, - "CronExpression":{"type":"string"}, - "CustomPatterns":{ - "type":"string", - "max":16000, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "DagEdges":{ - "type":"list", - "member":{"shape":"CodeGenEdge"} - }, - "DagNodes":{ - "type":"list", - "member":{"shape":"CodeGenNode"} - }, - "Database":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the database. For Hive compatibility, this is folded to lowercase when it is stored.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the database.

" - }, - "LocationUri":{ - "shape":"URI", - "documentation":"

The location of the database (for example, an HDFS path).

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

A list of key-value pairs that define parameters and properties of the database.

" - }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the metadata database was created in the catalog.

" - } - }, - "documentation":"

The Database object represents a logical grouping of tables that may reside in a Hive metastore or an RDBMS.

" - }, - "DatabaseInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the database. For Hive compatibility, this is folded to lowercase when it is stored.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the database

" - }, - "LocationUri":{ - "shape":"URI", - "documentation":"

The location of the database (for example, an HDFS path).

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

A list of key-value pairs that define parameters and properties of the database.

" - } - }, - "documentation":"

The structure used to create or update a database.

" - }, - "DatabaseList":{ - "type":"list", - "member":{"shape":"Database"} - }, - "DatabaseName":{"type":"string"}, - "DeleteBehavior":{ - "type":"string", - "enum":[ - "LOG", - "DELETE_FROM_DATABASE", - "DEPRECATE_IN_DATABASE" - ] - }, - "DeleteClassifierRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the classifier to remove.

" - } - } - }, - "DeleteClassifierResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteConnectionNameList":{ - "type":"list", - "member":{"shape":"NameString"}, - "max":25, - "min":0 - }, - "DeleteConnectionRequest":{ - "type":"structure", - "required":["ConnectionName"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the connection resides. If none is supplied, the AWS account ID is used by default.

" - }, - "ConnectionName":{ - "shape":"NameString", - "documentation":"

The name of the connection to delete.

" - } - } - }, - "DeleteConnectionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteCrawlerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the crawler to remove.

" - } - } - }, - "DeleteCrawlerResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteDatabaseRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the database resides. If none is supplied, the AWS account ID is used by default.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the Database to delete. For Hive compatibility, this must be all lowercase.

" - } - } - }, - "DeleteDatabaseResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteDevEndpointRequest":{ - "type":"structure", - "required":["EndpointName"], - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

The name of the DevEndpoint.

" - } - } - }, - "DeleteDevEndpointResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteJobRequest":{ - "type":"structure", - "required":["JobName"], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition to delete.

" - } - } - }, - "DeleteJobResponse":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition that was deleted.

" - } - } - }, - "DeletePartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionValues" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partition to be deleted resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which the table in question resides.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table where the partition to be deleted is located.

" - }, - "PartitionValues":{ - "shape":"ValueStringList", - "documentation":"

The values that define the partition.

" - } - } - }, - "DeletePartitionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteTableRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "Name" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the table resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the table to be deleted. For Hive compatibility, this name is entirely lowercase.

" - } - } - }, - "DeleteTableResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteTableVersionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "VersionId" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the tables reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in the catalog in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table. For Hive compatibility, this name is entirely lowercase.

" - }, - "VersionId":{ - "shape":"VersionString", - "documentation":"

The ID of the table version to be deleted.

" - } - } - }, - "DeleteTableVersionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteTriggerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger to delete.

" - } - } - }, - "DeleteTriggerResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger that was deleted.

" - } - } - }, - "DeleteUserDefinedFunctionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "FunctionName" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the function to be deleted is located. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the function is located.

" - }, - "FunctionName":{ - "shape":"NameString", - "documentation":"

The name of the function definition to be deleted.

" - } - } - }, - "DeleteUserDefinedFunctionResponse":{ - "type":"structure", - "members":{ - } - }, - "DescriptionString":{ - "type":"string", - "max":2048, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "DescriptionStringRemovable":{ - "type":"string", - "max":2048, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "DevEndpoint":{ - "type":"structure", - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

The name of the DevEndpoint.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The AWS ARN of the IAM role used in this DevEndpoint.

" - }, - "SecurityGroupIds":{ - "shape":"StringList", - "documentation":"

A list of security group identifiers used in this DevEndpoint.

" - }, - "SubnetId":{ - "shape":"GenericString", - "documentation":"

The subnet ID for this DevEndpoint.

" - }, - "YarnEndpointAddress":{ - "shape":"GenericString", - "documentation":"

The YARN endpoint address used by this DevEndpoint.

" - }, - "PrivateAddress":{ - "shape":"GenericString", - "documentation":"

A private DNS to access the DevEndpoint within a VPC, if the DevEndpoint is created within one.

" - }, - "ZeppelinRemoteSparkInterpreterPort":{ - "shape":"IntegerValue", - "documentation":"

The Apache Zeppelin port for the remote Apache Spark interpreter.

" - }, - "PublicAddress":{ - "shape":"GenericString", - "documentation":"

The public VPC address used by this DevEndpoint.

" - }, - "Status":{ - "shape":"GenericString", - "documentation":"

The current status of this DevEndpoint.

" - }, - "NumberOfNodes":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue Data Processing Units (DPUs) allocated to this DevEndpoint.

" - }, - "AvailabilityZone":{ - "shape":"GenericString", - "documentation":"

The AWS availability zone where this DevEndpoint is located.

" - }, - "VpcId":{ - "shape":"GenericString", - "documentation":"

The ID of the virtual private cloud (VPC) used by this DevEndpoint.

" - }, - "ExtraPythonLibsS3Path":{ - "shape":"GenericString", - "documentation":"

Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.

Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.

" - }, - "ExtraJarsS3Path":{ - "shape":"GenericString", - "documentation":"

Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.

Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.

" - }, - "FailureReason":{ - "shape":"GenericString", - "documentation":"

The reason for a current failure in this DevEndpoint.

" - }, - "LastUpdateStatus":{ - "shape":"GenericString", - "documentation":"

The status of the last update.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampValue", - "documentation":"

The point in time at which this DevEndpoint was created.

" - }, - "LastModifiedTimestamp":{ - "shape":"TimestampValue", - "documentation":"

The point in time at which this DevEndpoint was last modified.

" - }, - "PublicKey":{ - "shape":"GenericString", - "documentation":"

The public key to be used by this DevEndpoint for authentication. This attribute is provided for backward compatibility, as the recommended attribute to use is public keys.

" - }, - "PublicKeys":{ - "shape":"PublicKeysList", - "documentation":"

A list of public keys to be used by the DevEndpoints for authentication. The use of this attribute is preferred over a single public key because the public keys allow you to have a different private key per client.

If you previously created an endpoint with a public key, you must remove that key to be able to set a list of public keys: call the UpdateDevEndpoint API with the public key content in the deletePublicKeys attribute, and the list of new keys in the addPublicKeys attribute.

" - } - }, - "documentation":"

A development endpoint where a developer can remotely debug ETL scripts.

" - }, - "DevEndpointCustomLibraries":{ - "type":"structure", - "members":{ - "ExtraPythonLibsS3Path":{ - "shape":"GenericString", - "documentation":"

Path(s) to one or more Python libraries in an S3 bucket that should be loaded in your DevEndpoint. Multiple values must be complete paths separated by a comma.

Please note that only pure Python libraries can currently be used on a DevEndpoint. Libraries that rely on C extensions, such as the pandas Python data analysis library, are not yet supported.

" - }, - "ExtraJarsS3Path":{ - "shape":"GenericString", - "documentation":"

Path to one or more Java Jars in an S3 bucket that should be loaded in your DevEndpoint.

Please note that only pure Java/Scala libraries can currently be used on a DevEndpoint.

" - } - }, - "documentation":"

Custom libraries to be loaded into a DevEndpoint.

" - }, - "DevEndpointList":{ - "type":"list", - "member":{"shape":"DevEndpoint"} - }, - "DynamoDBTarget":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"Path", - "documentation":"

The name of the DynamoDB table to crawl.

" - } - }, - "documentation":"

Specifies a DynamoDB table to crawl.

" - }, - "DynamoDBTargetList":{ - "type":"list", - "member":{"shape":"DynamoDBTarget"} - }, - "EntityNotFoundException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

A specified entity does not exist

", - "exception":true - }, - "ErrorByName":{ - "type":"map", - "key":{"shape":"NameString"}, - "value":{"shape":"ErrorDetail"} - }, - "ErrorDetail":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"NameString", - "documentation":"

The code associated with this error.

" - }, - "ErrorMessage":{ - "shape":"DescriptionString", - "documentation":"

A message describing the error.

" - } - }, - "documentation":"

Contains details about an error.

" - }, - "ErrorString":{"type":"string"}, - "ExecutionProperty":{ - "type":"structure", - "members":{ - "MaxConcurrentRuns":{ - "shape":"MaxConcurrentRuns", - "documentation":"

The maximum number of concurrent runs allowed for the job. The default is 1. An error is returned when this threshold is reached. The maximum value you can specify is controlled by a service limit.

" - } - }, - "documentation":"

An execution property of a job.

" - }, - "ExecutionTime":{"type":"integer"}, - "FieldType":{"type":"string"}, - "FilterString":{ - "type":"string", - "max":2048, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "FormatString":{ - "type":"string", - "max":128, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "GenericMap":{ - "type":"map", - "key":{"shape":"GenericString"}, - "value":{"shape":"GenericString"} - }, - "GenericString":{"type":"string"}, - "GetCatalogImportStatusRequest":{ - "type":"structure", - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the catalog to migrate. Currently, this should be the AWS account ID.

" - } - } - }, - "GetCatalogImportStatusResponse":{ - "type":"structure", - "members":{ - "ImportStatus":{ - "shape":"CatalogImportStatus", - "documentation":"

The status of the specified catalog migration.

" - } - } - }, - "GetClassifierRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the classifier to retrieve.

" - } - } - }, - "GetClassifierResponse":{ - "type":"structure", - "members":{ - "Classifier":{ - "shape":"Classifier", - "documentation":"

The requested classifier.

" - } - } - }, - "GetClassifiersRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"PageSize", - "documentation":"

Size of the list to return (optional).

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

An optional continuation token.

" - } - } - }, - "GetClassifiersResponse":{ - "type":"structure", - "members":{ - "Classifiers":{ - "shape":"ClassifierList", - "documentation":"

The requested list of classifier objects.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token.

" - } - } - }, - "GetConnectionRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the connection resides. If none is supplied, the AWS account ID is used by default.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the connection definition to retrieve.

" - } - } - }, - "GetConnectionResponse":{ - "type":"structure", - "members":{ - "Connection":{ - "shape":"Connection", - "documentation":"

The requested connection definition.

" - } - } - }, - "GetConnectionsFilter":{ - "type":"structure", - "members":{ - "MatchCriteria":{ - "shape":"MatchCriteria", - "documentation":"

A criteria string that must match the criteria recorded in the connection definition for that connection definition to be returned.

" - }, - "ConnectionType":{ - "shape":"ConnectionType", - "documentation":"

The type of connections to return. Currently, only JDBC is supported; SFTP is not supported.

" - } - }, - "documentation":"

Filters the connection definitions returned by the GetConnections API.

" - }, - "GetConnectionsRequest":{ - "type":"structure", - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the connections reside. If none is supplied, the AWS account ID is used by default.

" - }, - "Filter":{ - "shape":"GetConnectionsFilter", - "documentation":"

A filter that controls which connections will be returned.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of connections to return in one response.

" - } - } - }, - "GetConnectionsResponse":{ - "type":"structure", - "members":{ - "ConnectionList":{ - "shape":"ConnectionList", - "documentation":"

A list of requested connection definitions.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the list of connections returned does not include the last of the filtered connections.

" - } - } - }, - "GetCrawlerMetricsRequest":{ - "type":"structure", - "members":{ - "CrawlerNameList":{ - "shape":"CrawlerNameList", - "documentation":"

A list of the names of crawlers about which to retrieve metrics.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum size of a list to return.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is a continuation call.

" - } - } - }, - "GetCrawlerMetricsResponse":{ - "type":"structure", - "members":{ - "CrawlerMetricsList":{ - "shape":"CrawlerMetricsList", - "documentation":"

A list of metrics for the specified crawler.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the returned list does not contain the last metric available.

" - } - } - }, - "GetCrawlerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the crawler to retrieve metadata for.

" - } - } - }, - "GetCrawlerResponse":{ - "type":"structure", - "members":{ - "Crawler":{ - "shape":"Crawler", - "documentation":"

The metadata for the specified crawler.

" - } - } - }, - "GetCrawlersRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The number of crawlers to return on each call.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is a continuation request.

" - } - } - }, - "GetCrawlersResponse":{ - "type":"structure", - "members":{ - "Crawlers":{ - "shape":"CrawlerList", - "documentation":"

A list of crawler metadata.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the returned list has not reached the end of those defined in this customer account.

" - } - } - }, - "GetDatabaseRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the database resides. If none is supplied, the AWS account ID is used by default.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the database to retrieve. For Hive compatibility, this should be all lowercase.

" - } - } - }, - "GetDatabaseResponse":{ - "type":"structure", - "members":{ - "Database":{ - "shape":"Database", - "documentation":"

The definition of the specified database in the catalog.

" - } - } - }, - "GetDatabasesRequest":{ - "type":"structure", - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog from which to retrieve Databases. If none is supplied, the AWS account ID is used by default.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of databases to return in one response.

" - } - } - }, - "GetDatabasesResponse":{ - "type":"structure", - "required":["DatabaseList"], - "members":{ - "DatabaseList":{ - "shape":"DatabaseList", - "documentation":"

A list of Database objects from the specified catalog.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token for paginating the returned list of tokens, returned if the current segment of the list is not the last.

" - } - } - }, - "GetDataflowGraphRequest":{ - "type":"structure", - "members":{ - "PythonScript":{ - "shape":"PythonScript", - "documentation":"

The Python script to transform.

" - } - } - }, - "GetDataflowGraphResponse":{ - "type":"structure", - "members":{ - "DagNodes":{ - "shape":"DagNodes", - "documentation":"

A list of the nodes in the resulting DAG.

" - }, - "DagEdges":{ - "shape":"DagEdges", - "documentation":"

A list of the edges in the resulting DAG.

" - } - } - }, - "GetDevEndpointRequest":{ - "type":"structure", - "required":["EndpointName"], - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

Name of the DevEndpoint for which to retrieve information.

" - } - } - }, - "GetDevEndpointResponse":{ - "type":"structure", - "members":{ - "DevEndpoint":{ - "shape":"DevEndpoint", - "documentation":"

A DevEndpoint definition.

" - } - } - }, - "GetDevEndpointsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum size of information to return.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if this is a continuation call.

" - } - } - }, - "GetDevEndpointsResponse":{ - "type":"structure", - "members":{ - "DevEndpoints":{ - "shape":"DevEndpointList", - "documentation":"

A list of DevEndpoint definitions.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if not all DevEndpoint definitions have yet been returned.

" - } - } - }, - "GetJobRequest":{ - "type":"structure", - "required":["JobName"], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition to retrieve.

" - } - } - }, - "GetJobResponse":{ - "type":"structure", - "members":{ - "Job":{ - "shape":"Job", - "documentation":"

The requested job definition.

" - } - } - }, - "GetJobRunRequest":{ - "type":"structure", - "required":[ - "JobName", - "RunId" - ], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

Name of the job definition being run.

" - }, - "RunId":{ - "shape":"IdString", - "documentation":"

The ID of the job run.

" - }, - "PredecessorsIncluded":{ - "shape":"BooleanValue", - "documentation":"

True if a list of predecessor runs should be returned.

" - } - } - }, - "GetJobRunResponse":{ - "type":"structure", - "members":{ - "JobRun":{ - "shape":"JobRun", - "documentation":"

The requested job-run metadata.

" - } - } - }, - "GetJobRunsRequest":{ - "type":"structure", - "required":["JobName"], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition for which to retrieve all job runs.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum size of the response.

" - } - } - }, - "GetJobRunsResponse":{ - "type":"structure", - "members":{ - "JobRuns":{ - "shape":"JobRunList", - "documentation":"

A list of job-run metatdata objects.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if not all reequested job runs have been returned.

" - } - } - }, - "GetJobsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum size of the response.

" - } - } - }, - "GetJobsResponse":{ - "type":"structure", - "members":{ - "Jobs":{ - "shape":"JobList", - "documentation":"

A list of job definitions.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if not all job definitions have yet been returned.

" - } - } - }, - "GetMappingRequest":{ - "type":"structure", - "required":["Source"], - "members":{ - "Source":{ - "shape":"CatalogEntry", - "documentation":"

Specifies the source table.

" - }, - "Sinks":{ - "shape":"CatalogEntries", - "documentation":"

A list of target tables.

" - }, - "Location":{ - "shape":"Location", - "documentation":"

Parameters for the mapping.

" - } - } - }, - "GetMappingResponse":{ - "type":"structure", - "required":["Mapping"], - "members":{ - "Mapping":{ - "shape":"MappingList", - "documentation":"

A list of mappings to the specified targets.

" - } - } - }, - "GetPartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionValues" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partition in question resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the partition resides.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the partition's table.

" - }, - "PartitionValues":{ - "shape":"ValueStringList", - "documentation":"

The values that define the partition.

" - } - } - }, - "GetPartitionResponse":{ - "type":"structure", - "members":{ - "Partition":{ - "shape":"Partition", - "documentation":"

The requested information, in the form of a Partition object.

" - } - } - }, - "GetPartitionsRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partitions in question reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the partitions reside.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the partitions' table.

" - }, - "Expression":{ - "shape":"PredicateString", - "documentation":"

An expression filtering the partitions to be returned.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is not the first call to retrieve these partitions.

" - }, - "Segment":{ - "shape":"Segment", - "documentation":"

The segment of the table's partitions to scan in this request.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of partitions to return in a single response.

" - } - } - }, - "GetPartitionsResponse":{ - "type":"structure", - "members":{ - "Partitions":{ - "shape":"PartitionList", - "documentation":"

A list of requested partitions.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the returned list of partitions does not does not include the last one.

" - } - } - }, - "GetPlanRequest":{ - "type":"structure", - "required":[ - "Mapping", - "Source" - ], - "members":{ - "Mapping":{ - "shape":"MappingList", - "documentation":"

The list of mappings from a source table to target tables.

" - }, - "Source":{ - "shape":"CatalogEntry", - "documentation":"

The source table.

" - }, - "Sinks":{ - "shape":"CatalogEntries", - "documentation":"

The target tables.

" - }, - "Location":{ - "shape":"Location", - "documentation":"

Parameters for the mapping.

" - }, - "Language":{ - "shape":"Language", - "documentation":"

The programming language of the code to perform the mapping.

" - } - } - }, - "GetPlanResponse":{ - "type":"structure", - "members":{ - "PythonScript":{ - "shape":"PythonScript", - "documentation":"

A Python script to perform the mapping.

" - }, - "ScalaCode":{ - "shape":"ScalaCode", - "documentation":"

Scala code to perform the mapping.

" - } - } - }, - "GetTableRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "Name" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the table resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the database in the catalog in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the table for which to retrieve the definition. For Hive compatibility, this name is entirely lowercase.

" - } - } - }, - "GetTableResponse":{ - "type":"structure", - "members":{ - "Table":{ - "shape":"Table", - "documentation":"

The Table object that defines the specified table.

" - } - } - }, - "GetTableVersionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the tables reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in the catalog in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table. For Hive compatibility, this name is entirely lowercase.

" - }, - "VersionId":{ - "shape":"VersionString", - "documentation":"

The ID value of the table version to be retrieved.

" - } - } - }, - "GetTableVersionResponse":{ - "type":"structure", - "members":{ - "TableVersion":{ - "shape":"TableVersion", - "documentation":"

The requested table version.

" - } - } - }, - "GetTableVersionsList":{ - "type":"list", - "member":{"shape":"TableVersion"} - }, - "GetTableVersionsRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the tables reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in the catalog in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table. For Hive compatibility, this name is entirely lowercase.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is not the first call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of table versions to return in one response.

" - } - } - }, - "GetTableVersionsResponse":{ - "type":"structure", - "members":{ - "TableVersions":{ - "shape":"GetTableVersionsList", - "documentation":"

A list of strings identifying available versions of the specified table.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the list of available versions does not include the last one.

" - } - } - }, - "GetTablesRequest":{ - "type":"structure", - "required":["DatabaseName"], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the tables reside. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The database in the catalog whose tables to list. For Hive compatibility, this name is entirely lowercase.

" - }, - "Expression":{ - "shape":"FilterString", - "documentation":"

A regular expression pattern. If present, only those tables whose names match the pattern are returned.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, included if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of tables to return in a single response.

" - } - } - }, - "GetTablesResponse":{ - "type":"structure", - "members":{ - "TableList":{ - "shape":"TableList", - "documentation":"

A list of the requested Table objects.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, present if the current list segment is not the last.

" - } - } - }, - "GetTriggerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger to retrieve.

" - } - } - }, - "GetTriggerResponse":{ - "type":"structure", - "members":{ - "Trigger":{ - "shape":"Trigger", - "documentation":"

The requested trigger definition.

" - } - } - }, - "GetTriggersRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "DependentJobName":{ - "shape":"NameString", - "documentation":"

The name of the job for which to retrieve triggers. The trigger that can start this job will be returned, and if there is no such trigger, all triggers will be returned.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum size of the response.

" - } - } - }, - "GetTriggersResponse":{ - "type":"structure", - "members":{ - "Triggers":{ - "shape":"TriggerList", - "documentation":"

A list of triggers for the specified job.

" - }, - "NextToken":{ - "shape":"GenericString", - "documentation":"

A continuation token, if not all the requested triggers have yet been returned.

" - } - } - }, - "GetUserDefinedFunctionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "FunctionName" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the function to be retrieved is located. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the function is located.

" - }, - "FunctionName":{ - "shape":"NameString", - "documentation":"

The name of the function.

" - } - } - }, - "GetUserDefinedFunctionResponse":{ - "type":"structure", - "members":{ - "UserDefinedFunction":{ - "shape":"UserDefinedFunction", - "documentation":"

The requested function definition.

" - } - } - }, - "GetUserDefinedFunctionsRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "Pattern" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the functions to be retrieved are located. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the functions are located.

" - }, - "Pattern":{ - "shape":"NameString", - "documentation":"

An optional function-name pattern string that filters the function definitions returned.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if this is a continuation call.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of functions to return in one response.

" - } - } - }, - "GetUserDefinedFunctionsResponse":{ - "type":"structure", - "members":{ - "UserDefinedFunctions":{ - "shape":"UserDefinedFunctionList", - "documentation":"

A list of requested function definitions.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

A continuation token, if the list of functions returned does not include the last requested function.

" - } - } - }, - "GrokClassifier":{ - "type":"structure", - "required":[ - "Name", - "Classification", - "GrokPattern" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches, such as Twitter, JSON, Omniture logs, and so on.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was registered.

" - }, - "LastUpdated":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was last updated.

" - }, - "Version":{ - "shape":"VersionId", - "documentation":"

The version of this classifier.

" - }, - "GrokPattern":{ - "shape":"GrokPattern", - "documentation":"

The grok pattern applied to a data store by this classifier. For more information, see built-in patterns in Writing Custom Classifers.

" - }, - "CustomPatterns":{ - "shape":"CustomPatterns", - "documentation":"

Optional custom grok patterns defined by this classifier. For more information, see custom patterns in Writing Custom Classifers.

" - } - }, - "documentation":"

A classifier that uses grok patterns.

" - }, - "GrokPattern":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\t]*" - }, - "IdString":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "IdempotentParameterMismatchException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The same unique identifier was associated with two different records.

", - "exception":true - }, - "ImportCatalogToGlueRequest":{ - "type":"structure", - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the catalog to import. Currently, this should be the AWS account ID.

" - } - } - }, - "ImportCatalogToGlueResponse":{ - "type":"structure", - "members":{ - } - }, - "Integer":{"type":"integer"}, - "IntegerFlag":{ - "type":"integer", - "max":1, - "min":0 - }, - "IntegerValue":{"type":"integer"}, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

An internal service error occurred.

", - "exception":true, - "fault":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The input provided was not valid.

", - "exception":true - }, - "JdbcTarget":{ - "type":"structure", - "members":{ - "ConnectionName":{ - "shape":"ConnectionName", - "documentation":"

The name of the connection to use to connect to the JDBC target.

" - }, - "Path":{ - "shape":"Path", - "documentation":"

The path of the JDBC target.

" - }, - "Exclusions":{ - "shape":"PathList", - "documentation":"

A list of glob patterns used to exclude from the crawl. For more information, see Catalog Tables with a Crawler.

" - } - }, - "documentation":"

Specifies a JDBC data store to crawl.

" - }, - "JdbcTargetList":{ - "type":"list", - "member":{"shape":"JdbcTarget"} - }, - "Job":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name you assign to this job definition.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the job being defined.

" - }, - "LogUri":{ - "shape":"UriString", - "documentation":"

This field is reserved for future use.

" - }, - "Role":{ - "shape":"RoleString", - "documentation":"

The name or ARN of the IAM role associated with this job.

" - }, - "CreatedOn":{ - "shape":"TimestampValue", - "documentation":"

The time and date that this job definition was created.

" - }, - "LastModifiedOn":{ - "shape":"TimestampValue", - "documentation":"

The last point in time when this job definition was modified.

" - }, - "ExecutionProperty":{ - "shape":"ExecutionProperty", - "documentation":"

An ExecutionProperty specifying the maximum number of concurrent runs allowed for this job.

" - }, - "Command":{ - "shape":"JobCommand", - "documentation":"

The JobCommand that executes this job.

" - }, - "DefaultArguments":{ - "shape":"GenericMap", - "documentation":"

The default arguments for this job, specified as name-value pairs.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own Job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "Connections":{ - "shape":"ConnectionsList", - "documentation":"

The connections used for this job.

" - }, - "MaxRetries":{ - "shape":"MaxRetries", - "documentation":"

The maximum number of times to retry this job after a JobRun fails.

" - }, - "AllocatedCapacity":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue data processing units (DPUs) allocated to runs of this job. From 2 to 100 DPUs can be allocated; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job timeout in minutes.

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job notification.

" - } - }, - "documentation":"

Specifies a job definition.

" - }, - "JobBookmarkEntry":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

Name of the job in question.

" - }, - "Version":{ - "shape":"IntegerValue", - "documentation":"

Version of the job.

" - }, - "Run":{ - "shape":"IntegerValue", - "documentation":"

The run ID number.

" - }, - "Attempt":{ - "shape":"IntegerValue", - "documentation":"

The attempt ID number.

" - }, - "JobBookmark":{ - "shape":"JsonValue", - "documentation":"

The bookmark itself.

" - } - }, - "documentation":"

Defines a point which a job can resume processing.

" - }, - "JobCommand":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"GenericString", - "documentation":"

The name of the job command: this must be glueetl.

" - }, - "ScriptLocation":{ - "shape":"ScriptLocationString", - "documentation":"

Specifies the S3 path to a script that executes a job (required).

" - } - }, - "documentation":"

Specifies code executed when a job is run.

" - }, - "JobList":{ - "type":"list", - "member":{"shape":"Job"} - }, - "JobName":{"type":"string"}, - "JobRun":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdString", - "documentation":"

The ID of this job run.

" - }, - "Attempt":{ - "shape":"AttemptCount", - "documentation":"

The number of the attempt to run this job.

" - }, - "PreviousRunId":{ - "shape":"IdString", - "documentation":"

The ID of the previous run of this job. For example, the JobRunId specified in the StartJobRun action.

" - }, - "TriggerName":{ - "shape":"NameString", - "documentation":"

The name of the trigger that started this job run.

" - }, - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition being used in this run.

" - }, - "StartedOn":{ - "shape":"TimestampValue", - "documentation":"

The date and time at which this job run was started.

" - }, - "LastModifiedOn":{ - "shape":"TimestampValue", - "documentation":"

The last time this job run was modified.

" - }, - "CompletedOn":{ - "shape":"TimestampValue", - "documentation":"

The date and time this job run completed.

" - }, - "JobRunState":{ - "shape":"JobRunState", - "documentation":"

The current state of the job run.

" - }, - "Arguments":{ - "shape":"GenericMap", - "documentation":"

The job arguments associated with this run. These override equivalent default arguments set for the job.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "ErrorMessage":{ - "shape":"ErrorString", - "documentation":"

An error message associated with this job run.

" - }, - "PredecessorRuns":{ - "shape":"PredecessorList", - "documentation":"

A list of predecessors to this job run.

" - }, - "AllocatedCapacity":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue data processing units (DPUs) allocated to this JobRun. From 2 to 100 DPUs can be allocated; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page.

" - }, - "ExecutionTime":{ - "shape":"ExecutionTime", - "documentation":"

The amount of time (in seconds) that the job run consumed resources.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job run timeout in minutes.

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job run notification.

" - } - }, - "documentation":"

Contains information about a job run.

" - }, - "JobRunList":{ - "type":"list", - "member":{"shape":"JobRun"} - }, - "JobRunState":{ - "type":"string", - "enum":[ - "STARTING", - "RUNNING", - "STOPPING", - "STOPPED", - "SUCCEEDED", - "FAILED", - "TIMEOUT" - ] - }, - "JobUpdate":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the job being defined.

" - }, - "LogUri":{ - "shape":"UriString", - "documentation":"

This field is reserved for future use.

" - }, - "Role":{ - "shape":"RoleString", - "documentation":"

The name or ARN of the IAM role associated with this job (required).

" - }, - "ExecutionProperty":{ - "shape":"ExecutionProperty", - "documentation":"

An ExecutionProperty specifying the maximum number of concurrent runs allowed for this job.

" - }, - "Command":{ - "shape":"JobCommand", - "documentation":"

The JobCommand that executes this job (required).

" - }, - "DefaultArguments":{ - "shape":"GenericMap", - "documentation":"

The default arguments for this job.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own Job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "Connections":{ - "shape":"ConnectionsList", - "documentation":"

The connections used for this job.

" - }, - "MaxRetries":{ - "shape":"MaxRetries", - "documentation":"

The maximum number of times to retry this job if it fails.

" - }, - "AllocatedCapacity":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue data processing units (DPUs) to allocate to this Job. From 2 to 100 DPUs can be allocated; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job timeout in minutes. The default is 2880 minutes (48 hours).

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job notification.

" - } - }, - "documentation":"

Specifies information used to update an existing job definition. Note that the previous job definition will be completely overwritten by this information.

" - }, - "JsonClassifier":{ - "type":"structure", - "required":[ - "Name", - "JsonPath" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was registered.

" - }, - "LastUpdated":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was last updated.

" - }, - "Version":{ - "shape":"VersionId", - "documentation":"

The version of this classifier.

" - }, - "JsonPath":{ - "shape":"JsonPath", - "documentation":"

A JsonPath string defining the JSON data for the classifier to classify. AWS Glue supports a subset of JsonPath, as described in Writing JsonPath Custom Classifiers.

" - } - }, - "documentation":"

A classifier for JSON content.

" - }, - "JsonPath":{"type":"string"}, - "JsonValue":{"type":"string"}, - "KeyString":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "Language":{ - "type":"string", - "enum":[ - "PYTHON", - "SCALA" - ] - }, - "LastCrawlInfo":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"LastCrawlStatus", - "documentation":"

Status of the last crawl.

" - }, - "ErrorMessage":{ - "shape":"DescriptionString", - "documentation":"

If an error occurred, the error information about the last crawl.

" - }, - "LogGroup":{ - "shape":"LogGroup", - "documentation":"

The log group for the last crawl.

" - }, - "LogStream":{ - "shape":"LogStream", - "documentation":"

The log stream for the last crawl.

" - }, - "MessagePrefix":{ - "shape":"MessagePrefix", - "documentation":"

The prefix for a message about this crawl.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the crawl started.

" - } - }, - "documentation":"

Status and error information about the most recent crawl.

" - }, - "LastCrawlStatus":{ - "type":"string", - "enum":[ - "SUCCEEDED", - "CANCELLED", - "FAILED" - ] - }, - "Location":{ - "type":"structure", - "members":{ - "Jdbc":{ - "shape":"CodeGenNodeArgs", - "documentation":"

A JDBC location.

" - }, - "S3":{ - "shape":"CodeGenNodeArgs", - "documentation":"

An Amazon S3 location.

" - }, - "DynamoDB":{ - "shape":"CodeGenNodeArgs", - "documentation":"

A DynamoDB Table location.

" - } - }, - "documentation":"

The location of resources.

" - }, - "LocationMap":{ - "type":"map", - "key":{"shape":"ColumnValuesString"}, - "value":{"shape":"ColumnValuesString"} - }, - "LocationString":{ - "type":"string", - "max":2056, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "LogGroup":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[\\.\\-_/#A-Za-z0-9]+" - }, - "LogStream":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[^:*]*" - }, - "Logical":{ - "type":"string", - "enum":[ - "AND", - "ANY" - ] - }, - "LogicalOperator":{ - "type":"string", - "enum":["EQUALS"] - }, - "MappingEntry":{ - "type":"structure", - "members":{ - "SourceTable":{ - "shape":"TableName", - "documentation":"

The name of the source table.

" - }, - "SourcePath":{ - "shape":"SchemaPathString", - "documentation":"

The source path.

" - }, - "SourceType":{ - "shape":"FieldType", - "documentation":"

The source type.

" - }, - "TargetTable":{ - "shape":"TableName", - "documentation":"

The target table.

" - }, - "TargetPath":{ - "shape":"SchemaPathString", - "documentation":"

The target path.

" - }, - "TargetType":{ - "shape":"FieldType", - "documentation":"

The target type.

" - } - }, - "documentation":"

Defines a mapping.

" - }, - "MappingList":{ - "type":"list", - "member":{"shape":"MappingEntry"} - }, - "MatchCriteria":{ - "type":"list", - "member":{"shape":"NameString"}, - "max":10, - "min":0 - }, - "MaxConcurrentRuns":{"type":"integer"}, - "MaxRetries":{"type":"integer"}, - "MessagePrefix":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "MessageString":{"type":"string"}, - "MillisecondsCount":{"type":"long"}, - "NameString":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "NameStringList":{ - "type":"list", - "member":{"shape":"NameString"} - }, - "NoScheduleException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

There is no applicable schedule.

", - "exception":true - }, - "NonNegativeDouble":{ - "type":"double", - "min":0.0 - }, - "NonNegativeInteger":{ - "type":"integer", - "min":0 - }, - "NotificationProperty":{ - "type":"structure", - "members":{ - "NotifyDelayAfter":{ - "shape":"NotifyDelayAfter", - "documentation":"

After a job run starts, the number of minutes to wait before sending a job run delay notification.

" - } - }, - "documentation":"

Specifies configuration properties of a notification.

" - }, - "NotifyDelayAfter":{ - "type":"integer", - "box":true, - "min":1 - }, - "OperationTimeoutException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The operation timed out.

", - "exception":true - }, - "Order":{ - "type":"structure", - "required":[ - "Column", - "SortOrder" - ], - "members":{ - "Column":{ - "shape":"NameString", - "documentation":"

The name of the column.

" - }, - "SortOrder":{ - "shape":"IntegerFlag", - "documentation":"

Indicates that the column is sorted in ascending order (== 1), or in descending order (==0).

" - } - }, - "documentation":"

Specifies the sort order of a sorted column.

" - }, - "OrderList":{ - "type":"list", - "member":{"shape":"Order"} - }, - "PageSize":{ - "type":"integer", - "box":true, - "max":1000, - "min":1 - }, - "ParametersMap":{ - "type":"map", - "key":{"shape":"KeyString"}, - "value":{"shape":"ParametersMapValue"} - }, - "ParametersMapValue":{ - "type":"string", - "max":512000 - }, - "Partition":{ - "type":"structure", - "members":{ - "Values":{ - "shape":"ValueStringList", - "documentation":"

The values of the partition.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the table in question is located.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table in question.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the partition was created.

" - }, - "LastAccessTime":{ - "shape":"Timestamp", - "documentation":"

The last time at which the partition was accessed.

" - }, - "StorageDescriptor":{ - "shape":"StorageDescriptor", - "documentation":"

Provides information about the physical location where the partition is stored.

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

Partition parameters, in the form of a list of key-value pairs.

" - }, - "LastAnalyzedTime":{ - "shape":"Timestamp", - "documentation":"

The last time at which column statistics were computed for this partition.

" - } - }, - "documentation":"

Represents a slice of table data.

" - }, - "PartitionError":{ - "type":"structure", - "members":{ - "PartitionValues":{ - "shape":"ValueStringList", - "documentation":"

The values that define the partition.

" - }, - "ErrorDetail":{ - "shape":"ErrorDetail", - "documentation":"

Details about the partition error.

" - } - }, - "documentation":"

Contains information about a partition error.

" - }, - "PartitionErrors":{ - "type":"list", - "member":{"shape":"PartitionError"} - }, - "PartitionInput":{ - "type":"structure", - "members":{ - "Values":{ - "shape":"ValueStringList", - "documentation":"

The values of the partition.

" - }, - "LastAccessTime":{ - "shape":"Timestamp", - "documentation":"

The last time at which the partition was accessed.

" - }, - "StorageDescriptor":{ - "shape":"StorageDescriptor", - "documentation":"

Provides information about the physical location where the partition is stored.

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

Partition parameters, in the form of a list of key-value pairs.

" - }, - "LastAnalyzedTime":{ - "shape":"Timestamp", - "documentation":"

The last time at which column statistics were computed for this partition.

" - } - }, - "documentation":"

The structure used to create and update a partion.

" - }, - "PartitionInputList":{ - "type":"list", - "member":{"shape":"PartitionInput"}, - "max":100, - "min":0 - }, - "PartitionList":{ - "type":"list", - "member":{"shape":"Partition"} - }, - "PartitionValueList":{ - "type":"structure", - "required":["Values"], - "members":{ - "Values":{ - "shape":"ValueStringList", - "documentation":"

The list of values.

" - } - }, - "documentation":"

Contains a list of values defining partitions.

" - }, - "Path":{"type":"string"}, - "PathList":{ - "type":"list", - "member":{"shape":"Path"} - }, - "PhysicalConnectionRequirements":{ - "type":"structure", - "members":{ - "SubnetId":{ - "shape":"NameString", - "documentation":"

The subnet ID used by the connection.

" - }, - "SecurityGroupIdList":{ - "shape":"SecurityGroupIdList", - "documentation":"

The security group ID list used by the connection.

" - }, - "AvailabilityZone":{ - "shape":"NameString", - "documentation":"

The connection's availability zone. This field is deprecated and has no effect.

" - } - }, - "documentation":"

Specifies the physical requirements for a connection.

" - }, - "Predecessor":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition used by the predecessor job run.

" - }, - "RunId":{ - "shape":"IdString", - "documentation":"

The job-run ID of the predecessor job run.

" - } - }, - "documentation":"

A job run that was used in the predicate of a conditional trigger that triggered this job run.

" - }, - "PredecessorList":{ - "type":"list", - "member":{"shape":"Predecessor"} - }, - "Predicate":{ - "type":"structure", - "members":{ - "Logical":{ - "shape":"Logical", - "documentation":"

Optional field if only one condition is listed. If multiple conditions are listed, then this field is required.

" - }, - "Conditions":{ - "shape":"ConditionList", - "documentation":"

A list of the conditions that determine when the trigger will fire.

" - } - }, - "documentation":"

Defines the predicate of the trigger, which determines when it fires.

" - }, - "PredicateString":{ - "type":"string", - "max":2048, - "min":0, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "PrincipalType":{ - "type":"string", - "enum":[ - "USER", - "ROLE", - "GROUP" - ] - }, - "PublicKeysList":{ - "type":"list", - "member":{"shape":"GenericString"}, - "max":5 - }, - "PythonScript":{"type":"string"}, - "ResetJobBookmarkRequest":{ - "type":"structure", - "required":["JobName"], - "members":{ - "JobName":{ - "shape":"JobName", - "documentation":"

The name of the job in question.

" - } - } - }, - "ResetJobBookmarkResponse":{ - "type":"structure", - "members":{ - "JobBookmarkEntry":{ - "shape":"JobBookmarkEntry", - "documentation":"

The reset bookmark entry.

" - } - } - }, - "ResourceNumberLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

A resource numerical limit was exceeded.

", - "exception":true - }, - "ResourceType":{ - "type":"string", - "enum":[ - "JAR", - "FILE", - "ARCHIVE" - ] - }, - "ResourceUri":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of the resource.

" - }, - "Uri":{ - "shape":"URI", - "documentation":"

The URI for accessing the resource.

" - } - }, - "documentation":"

URIs for function resources.

" - }, - "ResourceUriList":{ - "type":"list", - "member":{"shape":"ResourceUri"}, - "max":1000, - "min":0 - }, - "Role":{"type":"string"}, - "RoleArn":{ - "type":"string", - "pattern":"arn:aws:iam::\\d{12}:role/.*" - }, - "RoleString":{"type":"string"}, - "RowTag":{"type":"string"}, - "S3Target":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"Path", - "documentation":"

The path to the Amazon S3 target.

" - }, - "Exclusions":{ - "shape":"PathList", - "documentation":"

A list of glob patterns used to exclude from the crawl. For more information, see Catalog Tables with a Crawler.

" - } - }, - "documentation":"

Specifies a data store in Amazon S3.

" - }, - "S3TargetList":{ - "type":"list", - "member":{"shape":"S3Target"} - }, - "ScalaCode":{"type":"string"}, - "Schedule":{ - "type":"structure", - "members":{ - "ScheduleExpression":{ - "shape":"CronExpression", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - }, - "State":{ - "shape":"ScheduleState", - "documentation":"

The state of the schedule.

" - } - }, - "documentation":"

A scheduling object using a cron statement to schedule an event.

" - }, - "ScheduleState":{ - "type":"string", - "enum":[ - "SCHEDULED", - "NOT_SCHEDULED", - "TRANSITIONING" - ] - }, - "SchedulerNotRunningException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The specified scheduler is not running.

", - "exception":true - }, - "SchedulerRunningException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The specified scheduler is already running.

", - "exception":true - }, - "SchedulerTransitioningException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

The specified scheduler is transitioning.

", - "exception":true - }, - "SchemaChangePolicy":{ - "type":"structure", - "members":{ - "UpdateBehavior":{ - "shape":"UpdateBehavior", - "documentation":"

The update behavior when the crawler finds a changed schema.

" - }, - "DeleteBehavior":{ - "shape":"DeleteBehavior", - "documentation":"

The deletion behavior when the crawler finds a deleted object.

" - } - }, - "documentation":"

Crawler policy for update and deletion behavior.

" - }, - "SchemaPathString":{"type":"string"}, - "ScriptLocationString":{"type":"string"}, - "SecurityGroupIdList":{ - "type":"list", - "member":{"shape":"NameString"}, - "max":50, - "min":0 - }, - "Segment":{ - "type":"structure", - "required":[ - "SegmentNumber", - "TotalSegments" - ], - "members":{ - "SegmentNumber":{ - "shape":"NonNegativeInteger", - "documentation":"

The zero-based index number of the this segment. For example, if the total number of segments is 4, SegmentNumber values will range from zero through three.

" - }, - "TotalSegments":{ - "shape":"TotalSegmentsInteger", - "documentation":"

The total numer of segments.

" - } - }, - "documentation":"

Defines a non-overlapping region of a table's partitions, allowing multiple requests to be executed in parallel.

" - }, - "SerDeInfo":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the SerDe.

" - }, - "SerializationLibrary":{ - "shape":"NameString", - "documentation":"

Usually the class that implements the SerDe. An example is: org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

A list of initialization parameters for the SerDe, in key-value form.

" - } - }, - "documentation":"

Information about a serialization/deserialization program (SerDe) which serves as an extractor and loader.

" - }, - "SkewedInfo":{ - "type":"structure", - "members":{ - "SkewedColumnNames":{ - "shape":"NameStringList", - "documentation":"

A list of names of columns that contain skewed values.

" - }, - "SkewedColumnValues":{ - "shape":"ColumnValueStringList", - "documentation":"

A list of values that appear so frequently as to be considered skewed.

" - }, - "SkewedColumnValueLocationMaps":{ - "shape":"LocationMap", - "documentation":"

A mapping of skewed values to the columns that contain them.

" - } - }, - "documentation":"

Specifies skewed values in a table. Skewed are ones that occur with very high frequency.

" - }, - "StartCrawlerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the crawler to start.

" - } - } - }, - "StartCrawlerResponse":{ - "type":"structure", - "members":{ - } - }, - "StartCrawlerScheduleRequest":{ - "type":"structure", - "required":["CrawlerName"], - "members":{ - "CrawlerName":{ - "shape":"NameString", - "documentation":"

Name of the crawler to schedule.

" - } - } - }, - "StartCrawlerScheduleResponse":{ - "type":"structure", - "members":{ - } - }, - "StartJobRunRequest":{ - "type":"structure", - "required":["JobName"], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

The name of the job definition to use.

" - }, - "JobRunId":{ - "shape":"IdString", - "documentation":"

The ID of a previous JobRun to retry.

" - }, - "Arguments":{ - "shape":"GenericMap", - "documentation":"

The job arguments specifically for this run. They override the equivalent default arguments set for in the job definition itself.

You can specify arguments here that your own job-execution script consumes, as well as arguments that AWS Glue itself consumes.

For information about how to specify and consume your own Job arguments, see the Calling AWS Glue APIs in Python topic in the developer guide.

For information about the key-value pairs that AWS Glue consumes to set up your job, see the Special Parameters Used by AWS Glue topic in the developer guide.

" - }, - "AllocatedCapacity":{ - "shape":"IntegerValue", - "documentation":"

The number of AWS Glue data processing units (DPUs) to allocate to this JobRun. From 2 to 100 DPUs can be allocated; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The job run timeout in minutes. It overrides the timeout value of the job.

" - }, - "NotificationProperty":{ - "shape":"NotificationProperty", - "documentation":"

Specifies configuration properties of a job run notification.

" - } - } - }, - "StartJobRunResponse":{ - "type":"structure", - "members":{ - "JobRunId":{ - "shape":"IdString", - "documentation":"

The ID assigned to this job run.

" - } - } - }, - "StartTriggerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger to start.

" - } - } - }, - "StartTriggerResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger that was started.

" - } - } - }, - "StopCrawlerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the crawler to stop.

" - } - } - }, - "StopCrawlerResponse":{ - "type":"structure", - "members":{ - } - }, - "StopCrawlerScheduleRequest":{ - "type":"structure", - "required":["CrawlerName"], - "members":{ - "CrawlerName":{ - "shape":"NameString", - "documentation":"

Name of the crawler whose schedule state to set.

" - } - } - }, - "StopCrawlerScheduleResponse":{ - "type":"structure", - "members":{ - } - }, - "StopTriggerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger to stop.

" - } - } - }, - "StopTriggerResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger that was stopped.

" - } - } - }, - "StorageDescriptor":{ - "type":"structure", - "members":{ - "Columns":{ - "shape":"ColumnList", - "documentation":"

A list of the Columns in the table.

" - }, - "Location":{ - "shape":"LocationString", - "documentation":"

The physical location of the table. By default this takes the form of the warehouse location, followed by the database location in the warehouse, followed by the table name.

" - }, - "InputFormat":{ - "shape":"FormatString", - "documentation":"

The input format: SequenceFileInputFormat (binary), or TextInputFormat, or a custom format.

" - }, - "OutputFormat":{ - "shape":"FormatString", - "documentation":"

The output format: SequenceFileOutputFormat (binary), or IgnoreKeyTextOutputFormat, or a custom format.

" - }, - "Compressed":{ - "shape":"Boolean", - "documentation":"

True if the data in the table is compressed, or False if not.

" - }, - "NumberOfBuckets":{ - "shape":"Integer", - "documentation":"

Must be specified if the table contains any dimension columns.

" - }, - "SerdeInfo":{ - "shape":"SerDeInfo", - "documentation":"

Serialization/deserialization (SerDe) information.

" - }, - "BucketColumns":{ - "shape":"NameStringList", - "documentation":"

A list of reducer grouping columns, clustering columns, and bucketing columns in the table.

" - }, - "SortColumns":{ - "shape":"OrderList", - "documentation":"

A list specifying the sort order of each bucket in the table.

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

User-supplied properties in key-value form.

" - }, - "SkewedInfo":{ - "shape":"SkewedInfo", - "documentation":"

Information about values that appear very frequently in a column (skewed values).

" - }, - "StoredAsSubDirectories":{ - "shape":"Boolean", - "documentation":"

True if the table data is stored in subdirectories, or False if not.

" - } - }, - "documentation":"

Describes the physical storage of table data.

" - }, - "StringList":{ - "type":"list", - "member":{"shape":"GenericString"} - }, - "Table":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the table. For Hive compatibility, this must be entirely lowercase.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

Name of the metadata database where the table metadata resides. For Hive compatibility, this must be all lowercase.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the table.

" - }, - "Owner":{ - "shape":"NameString", - "documentation":"

Owner of the table.

" - }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"

Time when the table definition was created in the Data Catalog.

" - }, - "UpdateTime":{ - "shape":"Timestamp", - "documentation":"

Last time the table was updated.

" - }, - "LastAccessTime":{ - "shape":"Timestamp", - "documentation":"

Last time the table was accessed. This is usually taken from HDFS, and may not be reliable.

" - }, - "LastAnalyzedTime":{ - "shape":"Timestamp", - "documentation":"

Last time column statistics were computed for this table.

" - }, - "Retention":{ - "shape":"NonNegativeInteger", - "documentation":"

Retention time for this table.

" - }, - "StorageDescriptor":{ - "shape":"StorageDescriptor", - "documentation":"

A storage descriptor containing information about the physical storage of this table.

" - }, - "PartitionKeys":{ - "shape":"ColumnList", - "documentation":"

A list of columns by which the table is partitioned. Only primitive types are supported as partition keys.

" - }, - "ViewOriginalText":{ - "shape":"ViewTextString", - "documentation":"

If the table is a view, the original text of the view; otherwise null.

" - }, - "ViewExpandedText":{ - "shape":"ViewTextString", - "documentation":"

If the table is a view, the expanded text of the view; otherwise null.

" - }, - "TableType":{ - "shape":"TableTypeString", - "documentation":"

The type of this table (EXTERNAL_TABLE, VIRTUAL_VIEW, etc.).

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

Properties associated with this table, as a list of key-value pairs.

" - }, - "CreatedBy":{ - "shape":"NameString", - "documentation":"

Person or entity who created the table.

" - } - }, - "documentation":"

Represents a collection of related data organized in columns and rows.

" - }, - "TableError":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"NameString", - "documentation":"

Name of the table. For Hive compatibility, this must be entirely lowercase.

" - }, - "ErrorDetail":{ - "shape":"ErrorDetail", - "documentation":"

Detail about the error.

" - } - }, - "documentation":"

An error record for table operations.

" - }, - "TableErrors":{ - "type":"list", - "member":{"shape":"TableError"} - }, - "TableInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the table. For Hive compatibility, this is folded to lowercase when it is stored.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

Description of the table.

" - }, - "Owner":{ - "shape":"NameString", - "documentation":"

Owner of the table.

" - }, - "LastAccessTime":{ - "shape":"Timestamp", - "documentation":"

Last time the table was accessed.

" - }, - "LastAnalyzedTime":{ - "shape":"Timestamp", - "documentation":"

Last time column statistics were computed for this table.

" - }, - "Retention":{ - "shape":"NonNegativeInteger", - "documentation":"

Retention time for this table.

" - }, - "StorageDescriptor":{ - "shape":"StorageDescriptor", - "documentation":"

A storage descriptor containing information about the physical storage of this table.

" - }, - "PartitionKeys":{ - "shape":"ColumnList", - "documentation":"

A list of columns by which the table is partitioned. Only primitive types are supported as partition keys.

" - }, - "ViewOriginalText":{ - "shape":"ViewTextString", - "documentation":"

If the table is a view, the original text of the view; otherwise null.

" - }, - "ViewExpandedText":{ - "shape":"ViewTextString", - "documentation":"

If the table is a view, the expanded text of the view; otherwise null.

" - }, - "TableType":{ - "shape":"TableTypeString", - "documentation":"

The type of this table (EXTERNAL_TABLE, VIRTUAL_VIEW, etc.).

" - }, - "Parameters":{ - "shape":"ParametersMap", - "documentation":"

Properties associated with this table, as a list of key-value pairs.

" - } - }, - "documentation":"

Structure used to create or update the table.

" - }, - "TableList":{ - "type":"list", - "member":{"shape":"Table"} - }, - "TableName":{"type":"string"}, - "TablePrefix":{ - "type":"string", - "max":128, - "min":0 - }, - "TableTypeString":{ - "type":"string", - "max":255 - }, - "TableVersion":{ - "type":"structure", - "members":{ - "Table":{ - "shape":"Table", - "documentation":"

The table in question

" - }, - "VersionId":{ - "shape":"VersionString", - "documentation":"

The ID value that identifies this table version.

" - } - }, - "documentation":"

Specifies a version of a table.

" - }, - "TableVersionError":{ - "type":"structure", - "members":{ - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table in question.

" - }, - "VersionId":{ - "shape":"VersionString", - "documentation":"

The ID value of the version in question.

" - }, - "ErrorDetail":{ - "shape":"ErrorDetail", - "documentation":"

Detail about the error.

" - } - }, - "documentation":"

An error record for table-version operations.

" - }, - "TableVersionErrors":{ - "type":"list", - "member":{"shape":"TableVersionError"} - }, - "Timeout":{ - "type":"integer", - "box":true, - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "TimestampValue":{"type":"timestamp"}, - "Token":{"type":"string"}, - "TotalSegmentsInteger":{ - "type":"integer", - "max":10, - "min":1 - }, - "Trigger":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the trigger.

" - }, - "Id":{ - "shape":"IdString", - "documentation":"

Reserved for future use.

" - }, - "Type":{ - "shape":"TriggerType", - "documentation":"

The type of trigger that this is.

" - }, - "State":{ - "shape":"TriggerState", - "documentation":"

The current state of the trigger.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A description of this trigger.

" - }, - "Schedule":{ - "shape":"GenericString", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - }, - "Actions":{ - "shape":"ActionList", - "documentation":"

The actions initiated by this trigger.

" - }, - "Predicate":{ - "shape":"Predicate", - "documentation":"

The predicate of this trigger, which defines when it will fire.

" - } - }, - "documentation":"

Information about a specific trigger.

" - }, - "TriggerList":{ - "type":"list", - "member":{"shape":"Trigger"} - }, - "TriggerState":{ - "type":"string", - "enum":[ - "CREATING", - "CREATED", - "ACTIVATING", - "ACTIVATED", - "DEACTIVATING", - "DEACTIVATED", - "DELETING", - "UPDATING" - ] - }, - "TriggerType":{ - "type":"string", - "enum":[ - "SCHEDULED", - "CONDITIONAL", - "ON_DEMAND" - ] - }, - "TriggerUpdate":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Reserved for future use.

" - }, - "Description":{ - "shape":"DescriptionString", - "documentation":"

A description of this trigger.

" - }, - "Schedule":{ - "shape":"GenericString", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - }, - "Actions":{ - "shape":"ActionList", - "documentation":"

The actions initiated by this trigger.

" - }, - "Predicate":{ - "shape":"Predicate", - "documentation":"

The predicate of this trigger, which defines when it will fire.

" - } - }, - "documentation":"

A structure used to provide information used to update a trigger. This object will update the the previous trigger definition by overwriting it completely.

" - }, - "URI":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" - }, - "UpdateBehavior":{ - "type":"string", - "enum":[ - "LOG", - "UPDATE_IN_DATABASE" - ] - }, - "UpdateClassifierRequest":{ - "type":"structure", - "members":{ - "GrokClassifier":{ - "shape":"UpdateGrokClassifierRequest", - "documentation":"

A GrokClassifier object with updated fields.

" - }, - "XMLClassifier":{ - "shape":"UpdateXMLClassifierRequest", - "documentation":"

An XMLClassifier object with updated fields.

" - }, - "JsonClassifier":{ - "shape":"UpdateJsonClassifierRequest", - "documentation":"

A JsonClassifier object with updated fields.

" - } - } - }, - "UpdateClassifierResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateConnectionRequest":{ - "type":"structure", - "required":[ - "Name", - "ConnectionInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the connection resides. If none is supplied, the AWS account ID is used by default.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the connection definition to update.

" - }, - "ConnectionInput":{ - "shape":"ConnectionInput", - "documentation":"

A ConnectionInput object that redefines the connection in question.

" - } - } - }, - "UpdateConnectionResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateCrawlerRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

Name of the new crawler.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The IAM role (or ARN of an IAM role) used by the new crawler to access customer resources.

" - }, - "DatabaseName":{ - "shape":"DatabaseName", - "documentation":"

The AWS Glue database where results are stored, such as: arn:aws:daylight:us-east-1::database/sometable/*.

" - }, - "Description":{ - "shape":"DescriptionStringRemovable", - "documentation":"

A description of the new crawler.

" - }, - "Targets":{ - "shape":"CrawlerTargets", - "documentation":"

A list of targets to crawl.

" - }, - "Schedule":{ - "shape":"CronExpression", - "documentation":"

A cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - }, - "Classifiers":{ - "shape":"ClassifierNameList", - "documentation":"

A list of custom classifiers that the user has registered. By default, all built-in classifiers are included in a crawl, but these custom classifiers always override the default classifiers for a given classification.

" - }, - "TablePrefix":{ - "shape":"TablePrefix", - "documentation":"

The table prefix used for catalog tables that are created.

" - }, - "SchemaChangePolicy":{ - "shape":"SchemaChangePolicy", - "documentation":"

Policy for the crawler's update and deletion behavior.

" - }, - "Configuration":{ - "shape":"CrawlerConfiguration", - "documentation":"

Crawler configuration information. This versioned JSON string allows users to specify aspects of a crawler's behavior. For more information, see Configuring a Crawler.

" - } - } - }, - "UpdateCrawlerResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateCrawlerScheduleRequest":{ - "type":"structure", - "required":["CrawlerName"], - "members":{ - "CrawlerName":{ - "shape":"NameString", - "documentation":"

Name of the crawler whose schedule to update.

" - }, - "Schedule":{ - "shape":"CronExpression", - "documentation":"

The updated cron expression used to specify the schedule (see Time-Based Schedules for Jobs and Crawlers. For example, to run something every day at 12:15 UTC, you would specify: cron(15 12 * * ? *).

" - } - } - }, - "UpdateCrawlerScheduleResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateDatabaseRequest":{ - "type":"structure", - "required":[ - "Name", - "DatabaseInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog in which the metadata database resides. If none is supplied, the AWS account ID is used by default.

" - }, - "Name":{ - "shape":"NameString", - "documentation":"

The name of the database to update in the catalog. For Hive compatibility, this is folded to lowercase.

" - }, - "DatabaseInput":{ - "shape":"DatabaseInput", - "documentation":"

A DatabaseInput object specifying the new definition of the metadata database in the catalog.

" - } - } - }, - "UpdateDatabaseResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateDevEndpointRequest":{ - "type":"structure", - "required":["EndpointName"], - "members":{ - "EndpointName":{ - "shape":"GenericString", - "documentation":"

The name of the DevEndpoint to be updated.

" - }, - "PublicKey":{ - "shape":"GenericString", - "documentation":"

The public key for the DevEndpoint to use.

" - }, - "AddPublicKeys":{ - "shape":"PublicKeysList", - "documentation":"

The list of public keys for the DevEndpoint to use.

" - }, - "DeletePublicKeys":{ - "shape":"PublicKeysList", - "documentation":"

The list of public keys to be deleted from the DevEndpoint.

" - }, - "CustomLibraries":{ - "shape":"DevEndpointCustomLibraries", - "documentation":"

Custom Python or Java libraries to be loaded in the DevEndpoint.

" - }, - "UpdateEtlLibraries":{ - "shape":"BooleanValue", - "documentation":"

True if the list of custom libraries to be loaded in the development endpoint needs to be updated, or False otherwise.

" - } - } - }, - "UpdateDevEndpointResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateGrokClassifierRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the GrokClassifier.

" - }, - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches, such as Twitter, JSON, Omniture logs, Amazon CloudWatch Logs, and so on.

" - }, - "GrokPattern":{ - "shape":"GrokPattern", - "documentation":"

The grok pattern used by this classifier.

" - }, - "CustomPatterns":{ - "shape":"CustomPatterns", - "documentation":"

Optional custom grok patterns used by this classifier.

" - } - }, - "documentation":"

Specifies a grok classifier to update when passed to UpdateClassifier.

" - }, - "UpdateJobRequest":{ - "type":"structure", - "required":[ - "JobName", - "JobUpdate" - ], - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

Name of the job definition to update.

" - }, - "JobUpdate":{ - "shape":"JobUpdate", - "documentation":"

Specifies the values with which to update the job definition.

" - } - } - }, - "UpdateJobResponse":{ - "type":"structure", - "members":{ - "JobName":{ - "shape":"NameString", - "documentation":"

Returns the name of the updated job definition.

" - } - } - }, - "UpdateJsonClassifierRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "JsonPath":{ - "shape":"JsonPath", - "documentation":"

A JsonPath string defining the JSON data for the classifier to classify. AWS Glue supports a subset of JsonPath, as described in Writing JsonPath Custom Classifiers.

" - } - }, - "documentation":"

Specifies a JSON classifier to be updated.

" - }, - "UpdatePartitionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableName", - "PartitionValueList", - "PartitionInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the partition to be updated resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which the table in question resides.

" - }, - "TableName":{ - "shape":"NameString", - "documentation":"

The name of the table where the partition to be updated is located.

" - }, - "PartitionValueList":{ - "shape":"BoundedPartitionValueList", - "documentation":"

A list of the values defining the partition.

" - }, - "PartitionInput":{ - "shape":"PartitionInput", - "documentation":"

The new partition object to which to update the partition.

" - } - } - }, - "UpdatePartitionResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateTableRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "TableInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the table resides. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database in which the table resides. For Hive compatibility, this name is entirely lowercase.

" - }, - "TableInput":{ - "shape":"TableInput", - "documentation":"

An updated TableInput object to define the metadata table in the catalog.

" - }, - "SkipArchive":{ - "shape":"BooleanNullable", - "documentation":"

By default, UpdateTable always creates an archived version of the table before updating it. If skipArchive is set to true, however, UpdateTable does not create the archived version.

" - } - } - }, - "UpdateTableResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateTriggerRequest":{ - "type":"structure", - "required":[ - "Name", - "TriggerUpdate" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the trigger to update.

" - }, - "TriggerUpdate":{ - "shape":"TriggerUpdate", - "documentation":"

The new values with which to update the trigger.

" - } - } - }, - "UpdateTriggerResponse":{ - "type":"structure", - "members":{ - "Trigger":{ - "shape":"Trigger", - "documentation":"

The resulting trigger definition.

" - } - } - }, - "UpdateUserDefinedFunctionRequest":{ - "type":"structure", - "required":[ - "DatabaseName", - "FunctionName", - "FunctionInput" - ], - "members":{ - "CatalogId":{ - "shape":"CatalogIdString", - "documentation":"

The ID of the Data Catalog where the function to be updated is located. If none is supplied, the AWS account ID is used by default.

" - }, - "DatabaseName":{ - "shape":"NameString", - "documentation":"

The name of the catalog database where the function to be updated is located.

" - }, - "FunctionName":{ - "shape":"NameString", - "documentation":"

The name of the function.

" - }, - "FunctionInput":{ - "shape":"UserDefinedFunctionInput", - "documentation":"

A FunctionInput object that re-defines the function in the Data Catalog.

" - } - } - }, - "UpdateUserDefinedFunctionResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateXMLClassifierRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches.

" - }, - "RowTag":{ - "shape":"RowTag", - "documentation":"

The XML tag designating the element that contains each record in an XML document being parsed. Note that this cannot identify a self-closing element (closed by />). An empty row element that contains only attributes can be parsed as long as it ends with a closing tag (for example, <row item_a=\"A\" item_b=\"B\"></row> is okay, but <row item_a=\"A\" item_b=\"B\" /> is not).

" - } - }, - "documentation":"

Specifies an XML classifier to be updated.

" - }, - "UriString":{"type":"string"}, - "UserDefinedFunction":{ - "type":"structure", - "members":{ - "FunctionName":{ - "shape":"NameString", - "documentation":"

The name of the function.

" - }, - "ClassName":{ - "shape":"NameString", - "documentation":"

The Java class that contains the function code.

" - }, - "OwnerName":{ - "shape":"NameString", - "documentation":"

The owner of the function.

" - }, - "OwnerType":{ - "shape":"PrincipalType", - "documentation":"

The owner type.

" - }, - "CreateTime":{ - "shape":"Timestamp", - "documentation":"

The time at which the function was created.

" - }, - "ResourceUris":{ - "shape":"ResourceUriList", - "documentation":"

The resource URIs for the function.

" - } - }, - "documentation":"

Represents the equivalent of a Hive user-defined function (UDF) definition.

" - }, - "UserDefinedFunctionInput":{ - "type":"structure", - "members":{ - "FunctionName":{ - "shape":"NameString", - "documentation":"

The name of the function.

" - }, - "ClassName":{ - "shape":"NameString", - "documentation":"

The Java class that contains the function code.

" - }, - "OwnerName":{ - "shape":"NameString", - "documentation":"

The owner of the function.

" - }, - "OwnerType":{ - "shape":"PrincipalType", - "documentation":"

The owner type.

" - }, - "ResourceUris":{ - "shape":"ResourceUriList", - "documentation":"

The resource URIs for the function.

" - } - }, - "documentation":"

A structure used to create or updata a user-defined function.

" - }, - "UserDefinedFunctionList":{ - "type":"list", - "member":{"shape":"UserDefinedFunction"} - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

A value could not be validated.

", - "exception":true - }, - "ValueString":{ - "type":"string", - "max":1024 - }, - "ValueStringList":{ - "type":"list", - "member":{"shape":"ValueString"} - }, - "VersionId":{"type":"long"}, - "VersionMismatchException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"MessageString", - "documentation":"

A message describing the problem.

" - } - }, - "documentation":"

There was a version conflict.

", - "exception":true - }, - "VersionString":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\t]*" - }, - "ViewTextString":{ - "type":"string", - "max":409600 - }, - "XMLClassifier":{ - "type":"structure", - "required":[ - "Name", - "Classification" - ], - "members":{ - "Name":{ - "shape":"NameString", - "documentation":"

The name of the classifier.

" - }, - "Classification":{ - "shape":"Classification", - "documentation":"

An identifier of the data format that the classifier matches.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was registered.

" - }, - "LastUpdated":{ - "shape":"Timestamp", - "documentation":"

The time this classifier was last updated.

" - }, - "Version":{ - "shape":"VersionId", - "documentation":"

The version of this classifier.

" - }, - "RowTag":{ - "shape":"RowTag", - "documentation":"

The XML tag designating the element that contains each record in an XML document being parsed. Note that this cannot identify a self-closing element (closed by />). An empty row element that contains only attributes can be parsed as long as it ends with a closing tag (for example, <row item_a=\"A\" item_b=\"B\"></row> is okay, but <row item_a=\"A\" item_b=\"B\" /> is not).

" - } - }, - "documentation":"

A classifier for XML content.

" - } - }, - "documentation":"AWS Glue

Defines the public endpoint for the AWS Glue service.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/greengrass/2017-06-07/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/greengrass/2017-06-07/service-2.json deleted file mode 100644 index 2bf2ec8a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/greengrass/2017-06-07/service-2.json +++ /dev/null @@ -1,4854 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2017-06-07", - "endpointPrefix" : "greengrass", - "signingName" : "greengrass", - "serviceFullName" : "AWS Greengrass", - "serviceId" : "Greengrass", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "greengrass-2017-06-07", - "signatureVersion" : "v4" - }, - "operations" : { - "AssociateRoleToGroup" : { - "name" : "AssociateRoleToGroup", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/groups/{GroupId}/role", - "responseCode" : 200 - }, - "input" : { - "shape" : "AssociateRoleToGroupRequest" - }, - "output" : { - "shape" : "AssociateRoleToGroupResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Associates a role with a group. Your AWS Greengrass core will use the role to access AWS cloud services. The role's permissions should allow Greengrass core Lambda functions to perform actions against the cloud." - }, - "AssociateServiceRoleToAccount" : { - "name" : "AssociateServiceRoleToAccount", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/servicerole", - "responseCode" : 200 - }, - "input" : { - "shape" : "AssociateServiceRoleToAccountRequest" - }, - "output" : { - "shape" : "AssociateServiceRoleToAccountResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Associates a role with your account. AWS Greengrass will use the role to access your Lambda functions and AWS IoT resources. This is necessary for deployments to succeed. The role must have at least minimum permissions in the policy ''AWSGreengrassResourceAccessRolePolicy''." - }, - "CreateCoreDefinition" : { - "name" : "CreateCoreDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/cores", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateCoreDefinitionRequest" - }, - "output" : { - "shape" : "CreateCoreDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a core definition. You may provide the initial version of the core definition now or use ''CreateCoreDefinitionVersion'' at a later time. AWS Greengrass groups must each contain exactly one AWS Greengrass core." - }, - "CreateCoreDefinitionVersion" : { - "name" : "CreateCoreDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateCoreDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateCoreDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a core definition that has already been defined. AWS Greengrass groups must each contain exactly one AWS Greengrass core." - }, - "CreateDeployment" : { - "name" : "CreateDeployment", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/groups/{GroupId}/deployments", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateDeploymentRequest" - }, - "output" : { - "shape" : "CreateDeploymentResponse", - "documentation" : "Success. The group was deployed." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a deployment." - }, - "CreateDeviceDefinition" : { - "name" : "CreateDeviceDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/devices", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateDeviceDefinitionRequest" - }, - "output" : { - "shape" : "CreateDeviceDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a device definition. You may provide the initial version of the device definition now or use ''CreateDeviceDefinitionVersion'' at a later time." - }, - "CreateDeviceDefinitionVersion" : { - "name" : "CreateDeviceDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateDeviceDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateDeviceDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a device definition that has already been defined." - }, - "CreateFunctionDefinition" : { - "name" : "CreateFunctionDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/functions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateFunctionDefinitionRequest" - }, - "output" : { - "shape" : "CreateFunctionDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a Lambda function definition which contains a list of Lambda functions and their configurations to be used in a group. You can create an initial version of the definition by providing a list of Lambda functions and their configurations now, or use ''CreateFunctionDefinitionVersion'' later." - }, - "CreateFunctionDefinitionVersion" : { - "name" : "CreateFunctionDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateFunctionDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateFunctionDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a Lambda function definition that has already been defined." - }, - "CreateGroup" : { - "name" : "CreateGroup", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/groups", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateGroupRequest" - }, - "output" : { - "shape" : "CreateGroupResponse", - "documentation" : "Success. The group was created." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a group. You may provide the initial version of the group or use ''CreateGroupVersion'' at a later time." - }, - "CreateGroupCertificateAuthority" : { - "name" : "CreateGroupCertificateAuthority", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/groups/{GroupId}/certificateauthorities", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateGroupCertificateAuthorityRequest" - }, - "output" : { - "shape" : "CreateGroupCertificateAuthorityResponse", - "documentation" : "Success. The response body contains the new active CA ARN." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Creates a CA for the group. If a CA already exists, it will rotate the existing CA." - }, - "CreateGroupVersion" : { - "name" : "CreateGroupVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/groups/{GroupId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateGroupVersionRequest" - }, - "output" : { - "shape" : "CreateGroupVersionResponse", - "documentation" : "Success. The response contains information about the group version." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a group which has already been defined." - }, - "CreateLoggerDefinition" : { - "name" : "CreateLoggerDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/loggers", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateLoggerDefinitionRequest" - }, - "output" : { - "shape" : "CreateLoggerDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a logger definition. You may provide the initial version of the logger definition now or use ''CreateLoggerDefinitionVersion'' at a later time." - }, - "CreateLoggerDefinitionVersion" : { - "name" : "CreateLoggerDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateLoggerDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateLoggerDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a logger definition that has already been defined." - }, - "CreateResourceDefinition" : { - "name" : "CreateResourceDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/resources", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateResourceDefinitionRequest" - }, - "output" : { - "shape" : "CreateResourceDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a resource definition which contains a list of resources to be used in a group. You can create an initial version of the definition by providing a list of resources now, or use ''CreateResourceDefinitionVersion'' later." - }, - "CreateResourceDefinitionVersion" : { - "name" : "CreateResourceDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateResourceDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateResourceDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a resource definition that has already been defined." - }, - "CreateSoftwareUpdateJob" : { - "name" : "CreateSoftwareUpdateJob", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/updates", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateSoftwareUpdateJobRequest" - }, - "output" : { - "shape" : "CreateSoftwareUpdateJobResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Creates a software update for a core or group of cores (specified as an IoT thing group.) Use this to update the OTA Agent as well as the Greengrass core software. It makes use of the IoT Jobs feature which provides additional commands to manage a Greengrass core software update job." - }, - "CreateSubscriptionDefinition" : { - "name" : "CreateSubscriptionDefinition", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/subscriptions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateSubscriptionDefinitionRequest" - }, - "output" : { - "shape" : "CreateSubscriptionDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a subscription definition. You may provide the initial version of the subscription definition now or use ''CreateSubscriptionDefinitionVersion'' at a later time." - }, - "CreateSubscriptionDefinitionVersion" : { - "name" : "CreateSubscriptionDefinitionVersion", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateSubscriptionDefinitionVersionRequest" - }, - "output" : { - "shape" : "CreateSubscriptionDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Creates a version of a subscription definition which has already been defined." - }, - "DeleteCoreDefinition" : { - "name" : "DeleteCoreDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteCoreDefinitionRequest" - }, - "output" : { - "shape" : "DeleteCoreDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a core definition." - }, - "DeleteDeviceDefinition" : { - "name" : "DeleteDeviceDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteDeviceDefinitionRequest" - }, - "output" : { - "shape" : "DeleteDeviceDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a device definition." - }, - "DeleteFunctionDefinition" : { - "name" : "DeleteFunctionDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteFunctionDefinitionRequest" - }, - "output" : { - "shape" : "DeleteFunctionDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a Lambda function definition." - }, - "DeleteGroup" : { - "name" : "DeleteGroup", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/groups/{GroupId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteGroupRequest" - }, - "output" : { - "shape" : "DeleteGroupResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a group." - }, - "DeleteLoggerDefinition" : { - "name" : "DeleteLoggerDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteLoggerDefinitionRequest" - }, - "output" : { - "shape" : "DeleteLoggerDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a logger definition." - }, - "DeleteResourceDefinition" : { - "name" : "DeleteResourceDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteResourceDefinitionRequest" - }, - "output" : { - "shape" : "DeleteResourceDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a resource definition." - }, - "DeleteSubscriptionDefinition" : { - "name" : "DeleteSubscriptionDefinition", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteSubscriptionDefinitionRequest" - }, - "output" : { - "shape" : "DeleteSubscriptionDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Deletes a subscription definition." - }, - "DisassociateRoleFromGroup" : { - "name" : "DisassociateRoleFromGroup", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/groups/{GroupId}/role", - "responseCode" : 200 - }, - "input" : { - "shape" : "DisassociateRoleFromGroupRequest" - }, - "output" : { - "shape" : "DisassociateRoleFromGroupResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Disassociates the role from a group." - }, - "DisassociateServiceRoleFromAccount" : { - "name" : "DisassociateServiceRoleFromAccount", - "http" : { - "method" : "DELETE", - "requestUri" : "/greengrass/servicerole", - "responseCode" : 200 - }, - "input" : { - "shape" : "DisassociateServiceRoleFromAccountRequest" - }, - "output" : { - "shape" : "DisassociateServiceRoleFromAccountResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Disassociates the service role from your account. Without a service role, deployments will not work." - }, - "GetAssociatedRole" : { - "name" : "GetAssociatedRole", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/role", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetAssociatedRoleRequest" - }, - "output" : { - "shape" : "GetAssociatedRoleResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retrieves the role associated with a particular group." - }, - "GetConnectivityInfo" : { - "name" : "GetConnectivityInfo", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/things/{ThingName}/connectivityInfo", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetConnectivityInfoRequest" - }, - "output" : { - "shape" : "GetConnectivityInfoResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retrieves the connectivity information for a core." - }, - "GetCoreDefinition" : { - "name" : "GetCoreDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCoreDefinitionRequest" - }, - "output" : { - "shape" : "GetCoreDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a core definition version." - }, - "GetCoreDefinitionVersion" : { - "name" : "GetCoreDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}/versions/{CoreDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCoreDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetCoreDefinitionVersionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a core definition version." - }, - "GetDeploymentStatus" : { - "name" : "GetDeploymentStatus", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/deployments/{DeploymentId}/status", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetDeploymentStatusRequest" - }, - "output" : { - "shape" : "GetDeploymentStatusResponse", - "documentation" : "Success. The response body contains the status of the deployment for the group." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Returns the status of a deployment." - }, - "GetDeviceDefinition" : { - "name" : "GetDeviceDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetDeviceDefinitionRequest" - }, - "output" : { - "shape" : "GetDeviceDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a device definition." - }, - "GetDeviceDefinitionVersion" : { - "name" : "GetDeviceDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}/versions/{DeviceDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetDeviceDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetDeviceDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a device definition version." - }, - "GetFunctionDefinition" : { - "name" : "GetFunctionDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetFunctionDefinitionRequest" - }, - "output" : { - "shape" : "GetFunctionDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a Lambda function definition, including its creation time and latest version." - }, - "GetFunctionDefinitionVersion" : { - "name" : "GetFunctionDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}/versions/{FunctionDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetFunctionDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetFunctionDefinitionVersionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a Lambda function definition version, including which Lambda functions are included in the version and their configurations." - }, - "GetGroup" : { - "name" : "GetGroup", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetGroupRequest" - }, - "output" : { - "shape" : "GetGroupResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a group." - }, - "GetGroupCertificateAuthority" : { - "name" : "GetGroupCertificateAuthority", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/certificateauthorities/{CertificateAuthorityId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetGroupCertificateAuthorityRequest" - }, - "output" : { - "shape" : "GetGroupCertificateAuthorityResponse", - "documentation" : "Success. The response body contains the PKI Configuration." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retreives the CA associated with a group. Returns the public key of the CA." - }, - "GetGroupCertificateConfiguration" : { - "name" : "GetGroupCertificateConfiguration", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/certificateauthorities/configuration/expiry", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetGroupCertificateConfigurationRequest" - }, - "output" : { - "shape" : "GetGroupCertificateConfigurationResponse", - "documentation" : "Success. The response body contains the PKI Configuration." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retrieves the current configuration for the CA used by the group." - }, - "GetGroupVersion" : { - "name" : "GetGroupVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/versions/{GroupVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetGroupVersionRequest" - }, - "output" : { - "shape" : "GetGroupVersionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a group version." - }, - "GetLoggerDefinition" : { - "name" : "GetLoggerDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetLoggerDefinitionRequest" - }, - "output" : { - "shape" : "GetLoggerDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a logger definition." - }, - "GetLoggerDefinitionVersion" : { - "name" : "GetLoggerDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}/versions/{LoggerDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetLoggerDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetLoggerDefinitionVersionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a logger definition version." - }, - "GetResourceDefinition" : { - "name" : "GetResourceDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetResourceDefinitionRequest" - }, - "output" : { - "shape" : "GetResourceDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a resource definition, including its creation time and latest version." - }, - "GetResourceDefinitionVersion" : { - "name" : "GetResourceDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}/versions/{ResourceDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetResourceDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetResourceDefinitionVersionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a resource definition version, including which resources are included in the version." - }, - "GetServiceRoleForAccount" : { - "name" : "GetServiceRoleForAccount", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/servicerole", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetServiceRoleForAccountRequest" - }, - "output" : { - "shape" : "GetServiceRoleForAccountResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retrieves the service role that is attached to your account." - }, - "GetSubscriptionDefinition" : { - "name" : "GetSubscriptionDefinition", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSubscriptionDefinitionRequest" - }, - "output" : { - "shape" : "GetSubscriptionDefinitionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a subscription definition." - }, - "GetSubscriptionDefinitionVersion" : { - "name" : "GetSubscriptionDefinitionVersion", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions/{SubscriptionDefinitionVersionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSubscriptionDefinitionVersionRequest" - }, - "output" : { - "shape" : "GetSubscriptionDefinitionVersionResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Retrieves information about a subscription definition version." - }, - "ListCoreDefinitionVersions" : { - "name" : "ListCoreDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListCoreDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListCoreDefinitionVersionsResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a core definition." - }, - "ListCoreDefinitions" : { - "name" : "ListCoreDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/cores", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListCoreDefinitionsRequest" - }, - "output" : { - "shape" : "ListCoreDefinitionsResponse" - }, - "errors" : [ ], - "documentation" : "Retrieves a list of core definitions." - }, - "ListDeployments" : { - "name" : "ListDeployments", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/deployments", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDeploymentsRequest" - }, - "output" : { - "shape" : "ListDeploymentsResponse", - "documentation" : "Success. The response body contains the list of deployments for the given group." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Returns a history of deployments for the group." - }, - "ListDeviceDefinitionVersions" : { - "name" : "ListDeviceDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDeviceDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListDeviceDefinitionVersionsResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a device definition." - }, - "ListDeviceDefinitions" : { - "name" : "ListDeviceDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/devices", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDeviceDefinitionsRequest" - }, - "output" : { - "shape" : "ListDeviceDefinitionsResponse" - }, - "errors" : [ ], - "documentation" : "Retrieves a list of device definitions." - }, - "ListFunctionDefinitionVersions" : { - "name" : "ListFunctionDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListFunctionDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListFunctionDefinitionVersionsResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a Lambda function definition." - }, - "ListFunctionDefinitions" : { - "name" : "ListFunctionDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/functions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListFunctionDefinitionsRequest" - }, - "output" : { - "shape" : "ListFunctionDefinitionsResponse", - "documentation" : "Success. The response contains the IDs of all the Greengrass Lambda function definitions in this account." - }, - "errors" : [ ], - "documentation" : "Retrieves a list of Lambda function definitions." - }, - "ListGroupCertificateAuthorities" : { - "name" : "ListGroupCertificateAuthorities", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/certificateauthorities", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListGroupCertificateAuthoritiesRequest" - }, - "output" : { - "shape" : "ListGroupCertificateAuthoritiesResponse", - "documentation" : "Success. The response body contains the PKI Configuration." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Retrieves the current CAs for a group." - }, - "ListGroupVersions" : { - "name" : "ListGroupVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups/{GroupId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListGroupVersionsRequest" - }, - "output" : { - "shape" : "ListGroupVersionsResponse", - "documentation" : "Success. The response contains the list of versions and metadata for the given group." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a group." - }, - "ListGroups" : { - "name" : "ListGroups", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/groups", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListGroupsRequest" - }, - "output" : { - "shape" : "ListGroupsResponse" - }, - "errors" : [ ], - "documentation" : "Retrieves a list of groups." - }, - "ListLoggerDefinitionVersions" : { - "name" : "ListLoggerDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListLoggerDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListLoggerDefinitionVersionsResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a logger definition." - }, - "ListLoggerDefinitions" : { - "name" : "ListLoggerDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/loggers", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListLoggerDefinitionsRequest" - }, - "output" : { - "shape" : "ListLoggerDefinitionsResponse" - }, - "errors" : [ ], - "documentation" : "Retrieves a list of logger definitions." - }, - "ListResourceDefinitionVersions" : { - "name" : "ListResourceDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListResourceDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListResourceDefinitionVersionsResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a resource definition." - }, - "ListResourceDefinitions" : { - "name" : "ListResourceDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/resources", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListResourceDefinitionsRequest" - }, - "output" : { - "shape" : "ListResourceDefinitionsResponse", - "documentation" : "The IDs of all the Greengrass resource definitions in this account." - }, - "errors" : [ ], - "documentation" : "Retrieves a list of resource definitions." - }, - "ListSubscriptionDefinitionVersions" : { - "name" : "ListSubscriptionDefinitionVersions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListSubscriptionDefinitionVersionsRequest" - }, - "output" : { - "shape" : "ListSubscriptionDefinitionVersionsResponse" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Lists the versions of a subscription definition." - }, - "ListSubscriptionDefinitions" : { - "name" : "ListSubscriptionDefinitions", - "http" : { - "method" : "GET", - "requestUri" : "/greengrass/definition/subscriptions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListSubscriptionDefinitionsRequest" - }, - "output" : { - "shape" : "ListSubscriptionDefinitionsResponse" - }, - "errors" : [ ], - "documentation" : "Retrieves a list of subscription definitions." - }, - "ResetDeployments" : { - "name" : "ResetDeployments", - "http" : { - "method" : "POST", - "requestUri" : "/greengrass/groups/{GroupId}/deployments/$reset", - "responseCode" : 200 - }, - "input" : { - "shape" : "ResetDeploymentsRequest" - }, - "output" : { - "shape" : "ResetDeploymentsResponse", - "documentation" : "Success. The group's deployments were reset." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Resets a group's deployments." - }, - "UpdateConnectivityInfo" : { - "name" : "UpdateConnectivityInfo", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/things/{ThingName}/connectivityInfo", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateConnectivityInfoRequest" - }, - "output" : { - "shape" : "UpdateConnectivityInfoResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Updates the connectivity information for the core. Any devices that belong to the group which has this core will receive this information in order to find the location of the core and connect to it." - }, - "UpdateCoreDefinition" : { - "name" : "UpdateCoreDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/cores/{CoreDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateCoreDefinitionRequest" - }, - "output" : { - "shape" : "UpdateCoreDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a core definition." - }, - "UpdateDeviceDefinition" : { - "name" : "UpdateDeviceDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/devices/{DeviceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateDeviceDefinitionRequest" - }, - "output" : { - "shape" : "UpdateDeviceDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a device definition." - }, - "UpdateFunctionDefinition" : { - "name" : "UpdateFunctionDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/functions/{FunctionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateFunctionDefinitionRequest" - }, - "output" : { - "shape" : "UpdateFunctionDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a Lambda function definition." - }, - "UpdateGroup" : { - "name" : "UpdateGroup", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/groups/{GroupId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateGroupRequest" - }, - "output" : { - "shape" : "UpdateGroupResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a group." - }, - "UpdateGroupCertificateConfiguration" : { - "name" : "UpdateGroupCertificateConfiguration", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/groups/{GroupId}/certificateauthorities/configuration/expiry", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateGroupCertificateConfigurationRequest" - }, - "output" : { - "shape" : "UpdateGroupCertificateConfigurationResponse", - "documentation" : "Success. The response body contains the PKI Configuration." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "server error" - } ], - "documentation" : "Updates the Certificate expiry time for a group." - }, - "UpdateLoggerDefinition" : { - "name" : "UpdateLoggerDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/loggers/{LoggerDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateLoggerDefinitionRequest" - }, - "output" : { - "shape" : "UpdateLoggerDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a logger definition." - }, - "UpdateResourceDefinition" : { - "name" : "UpdateResourceDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/resources/{ResourceDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateResourceDefinitionRequest" - }, - "output" : { - "shape" : "UpdateResourceDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a resource definition." - }, - "UpdateSubscriptionDefinition" : { - "name" : "UpdateSubscriptionDefinition", - "http" : { - "method" : "PUT", - "requestUri" : "/greengrass/definition/subscriptions/{SubscriptionDefinitionId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateSubscriptionDefinitionRequest" - }, - "output" : { - "shape" : "UpdateSubscriptionDefinitionResponse", - "documentation" : "success" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "invalid request" - } ], - "documentation" : "Updates a subscription definition." - } - }, - "shapes" : { - "AssociateRoleToGroupRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of the role you wish to associate with this group." - } - }, - "required" : [ "GroupId" ] - }, - "AssociateRoleToGroupResponse" : { - "type" : "structure", - "members" : { - "AssociatedAt" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the role ARN was associated with the group." - } - } - }, - "AssociateServiceRoleToAccountRequest" : { - "type" : "structure", - "members" : { - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of the service role you wish to associate with your account." - } - } - }, - "AssociateServiceRoleToAccountResponse" : { - "type" : "structure", - "members" : { - "AssociatedAt" : { - "shape" : "__string", - "documentation" : "The time when the service role was associated with the account." - } - } - }, - "BadRequestException" : { - "type" : "structure", - "members" : { - "ErrorDetails" : { - "shape" : "ErrorDetails", - "documentation" : "Details about the error." - }, - "Message" : { - "shape" : "__string", - "documentation" : "A message containing information about the error." - } - }, - "documentation" : "General error information.", - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "ConnectivityInfo" : { - "type" : "structure", - "members" : { - "HostAddress" : { - "shape" : "__string", - "documentation" : "The endpoint for the Greengrass core. Can be an IP address or DNS." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the connectivity information." - }, - "Metadata" : { - "shape" : "__string", - "documentation" : "Metadata for this endpoint." - }, - "PortNumber" : { - "shape" : "__integer", - "documentation" : "The port of the Greengrass core. Usually 8883." - } - }, - "documentation" : "Information about a Greengrass core's connectivity." - }, - "Core" : { - "type" : "structure", - "members" : { - "CertificateArn" : { - "shape" : "__string", - "documentation" : "The ARN of the certificate associated with the core." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the core." - }, - "SyncShadow" : { - "shape" : "__boolean", - "documentation" : "If true, the core's local shadow is automatically synced with the cloud." - }, - "ThingArn" : { - "shape" : "__string", - "documentation" : "The ARN of the thing which is the core." - } - }, - "documentation" : "Information about a core.", - "required" : [ ] - }, - "CoreDefinitionVersion" : { - "type" : "structure", - "members" : { - "Cores" : { - "shape" : "__listOfCore", - "documentation" : "A list of cores in the core definition version." - } - }, - "documentation" : "Information about a core definition version." - }, - "CreateCoreDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "CoreDefinitionVersion", - "documentation" : "Information about the initial version of the core definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the core definition." - } - }, - "documentation" : "Information needed to create a core definition." - }, - "CreateCoreDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateCoreDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - }, - "Cores" : { - "shape" : "__listOfCore", - "documentation" : "A list of cores in the core definition version." - } - }, - "required" : [ "CoreDefinitionId" ] - }, - "CreateCoreDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateDeploymentRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "DeploymentId" : { - "shape" : "__string", - "documentation" : "The ID of the deployment if you wish to redeploy a previous deployment." - }, - "DeploymentType" : { - "shape" : "DeploymentType", - "documentation" : "The type of deployment. When used in ''CreateDeployment'', only ''NewDeployment'' and ''Redeployment'' are valid." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "GroupVersionId" : { - "shape" : "__string", - "documentation" : "The ID of the group version to be deployed." - } - }, - "required" : [ "GroupId" ] - }, - "CreateDeploymentResponse" : { - "type" : "structure", - "members" : { - "DeploymentArn" : { - "shape" : "__string", - "documentation" : "The ARN of the deployment." - }, - "DeploymentId" : { - "shape" : "__string", - "documentation" : "The ID of the deployment." - } - } - }, - "CreateDeviceDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "DeviceDefinitionVersion", - "documentation" : "Information about the initial version of the device definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the device definition." - } - } - }, - "CreateDeviceDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateDeviceDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - }, - "Devices" : { - "shape" : "__listOfDevice", - "documentation" : "A list of devices in the definition version." - } - }, - "required" : [ "DeviceDefinitionId" ] - }, - "CreateDeviceDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateFunctionDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "FunctionDefinitionVersion", - "documentation" : "Information about the initial version of the function definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the function definition." - } - } - }, - "CreateFunctionDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateFunctionDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - }, - "Functions" : { - "shape" : "__listOfFunction", - "documentation" : "A list of Lambda functions in this function definition version." - } - }, - "documentation" : "Information needed to create a function definition version.", - "required" : [ "FunctionDefinitionId" ] - }, - "CreateFunctionDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateGroupCertificateAuthorityRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "CreateGroupCertificateAuthorityResponse" : { - "type" : "structure", - "members" : { - "GroupCertificateAuthorityArn" : { - "shape" : "__string", - "documentation" : "The ARN of the group certificate authority." - } - } - }, - "CreateGroupRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "GroupVersion", - "documentation" : "Information about the initial version of the group." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the group." - } - } - }, - "CreateGroupResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateGroupVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "CoreDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the core definition version for this group." - }, - "DeviceDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the device definition version for this group." - }, - "FunctionDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the function definition version for this group." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "LoggerDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the logger definition version for this group." - }, - "ResourceDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The resource definition version ARN for this group." - }, - "SubscriptionDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the subscription definition version for this group." - } - }, - "required" : [ "GroupId" ] - }, - "CreateGroupVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateLoggerDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "LoggerDefinitionVersion", - "documentation" : "Information about the initial version of the logger definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the logger definition." - } - } - }, - "CreateLoggerDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateLoggerDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - }, - "Loggers" : { - "shape" : "__listOfLogger", - "documentation" : "A list of loggers." - } - }, - "required" : [ "LoggerDefinitionId" ] - }, - "CreateLoggerDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateResourceDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "ResourceDefinitionVersion", - "documentation" : "Information about the initial version of the resource definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the resource definition." - } - } - }, - "CreateResourceDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateResourceDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - }, - "Resources" : { - "shape" : "__listOfResource", - "documentation" : "A list of resources." - } - }, - "required" : [ "ResourceDefinitionId" ] - }, - "CreateResourceDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "CreateSoftwareUpdateJobRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "S3UrlSignerRole" : { - "shape" : "S3UrlSignerRole" - }, - "SoftwareToUpdate" : { - "shape" : "SoftwareToUpdate" - }, - "UpdateAgentLogLevel" : { - "shape" : "UpdateAgentLogLevel" - }, - "UpdateTargets" : { - "shape" : "UpdateTargets" - }, - "UpdateTargetsArchitecture" : { - "shape" : "UpdateTargetsArchitecture" - }, - "UpdateTargetsOperatingSystem" : { - "shape" : "UpdateTargetsOperatingSystem" - } - } - }, - "CreateSoftwareUpdateJobResponse" : { - "type" : "structure", - "members" : { - "IotJobArn" : { - "shape" : "__string", - "documentation" : "The IoT Job ARN corresponding to this update." - }, - "IotJobId" : { - "shape" : "__string", - "documentation" : "The IoT Job Id corresponding to this update." - } - } - }, - "CreateSubscriptionDefinitionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "InitialVersion" : { - "shape" : "SubscriptionDefinitionVersion", - "documentation" : "Information about the initial version of the subscription definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the subscription definition." - } - } - }, - "CreateSubscriptionDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "CreateSubscriptionDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - }, - "Subscriptions" : { - "shape" : "__listOfSubscription", - "documentation" : "A list of subscriptions." - } - }, - "required" : [ "SubscriptionDefinitionId" ] - }, - "CreateSubscriptionDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - } - }, - "DefinitionInformation" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "documentation" : "Information about a definition." - }, - "DeleteCoreDefinitionRequest" : { - "type" : "structure", - "members" : { - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - } - }, - "required" : [ "CoreDefinitionId" ] - }, - "DeleteCoreDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteDeviceDefinitionRequest" : { - "type" : "structure", - "members" : { - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - } - }, - "required" : [ "DeviceDefinitionId" ] - }, - "DeleteDeviceDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteFunctionDefinitionRequest" : { - "type" : "structure", - "members" : { - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - } - }, - "required" : [ "FunctionDefinitionId" ] - }, - "DeleteFunctionDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteGroupRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "DeleteGroupResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteLoggerDefinitionRequest" : { - "type" : "structure", - "members" : { - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - } - }, - "required" : [ "LoggerDefinitionId" ] - }, - "DeleteLoggerDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteResourceDefinitionRequest" : { - "type" : "structure", - "members" : { - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - } - }, - "required" : [ "ResourceDefinitionId" ] - }, - "DeleteResourceDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteSubscriptionDefinitionRequest" : { - "type" : "structure", - "members" : { - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - } - }, - "required" : [ "SubscriptionDefinitionId" ] - }, - "DeleteSubscriptionDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "Deployment" : { - "type" : "structure", - "members" : { - "CreatedAt" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the deployment was created." - }, - "DeploymentArn" : { - "shape" : "__string", - "documentation" : "The ARN of the deployment." - }, - "DeploymentId" : { - "shape" : "__string", - "documentation" : "The ID of the deployment." - }, - "DeploymentType" : { - "shape" : "DeploymentType", - "documentation" : "The type of the deployment." - }, - "GroupArn" : { - "shape" : "__string", - "documentation" : "The ARN of the group for this deployment." - } - }, - "documentation" : "Information about a deployment." - }, - "DeploymentType" : { - "type" : "string", - "enum" : [ "NewDeployment", "Redeployment", "ResetDeployment", "ForceResetDeployment" ] - }, - "Deployments" : { - "type" : "list", - "member" : { - "shape" : "Deployment" - } - }, - "Device" : { - "type" : "structure", - "members" : { - "CertificateArn" : { - "shape" : "__string", - "documentation" : "The ARN of the certificate associated with the device." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the device." - }, - "SyncShadow" : { - "shape" : "__boolean", - "documentation" : "If true, the device's local shadow will be automatically synced with the cloud." - }, - "ThingArn" : { - "shape" : "__string", - "documentation" : "The thing ARN of the device." - } - }, - "documentation" : "Information about a device.", - "required" : [ ] - }, - "DeviceDefinitionVersion" : { - "type" : "structure", - "members" : { - "Devices" : { - "shape" : "__listOfDevice", - "documentation" : "A list of devices in the definition version." - } - }, - "documentation" : "Information about a device definition version." - }, - "DisassociateRoleFromGroupRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "DisassociateRoleFromGroupResponse" : { - "type" : "structure", - "members" : { - "DisassociatedAt" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the role was disassociated from the group." - } - } - }, - "DisassociateServiceRoleFromAccountRequest" : { - "type" : "structure", - "members" : { } - }, - "DisassociateServiceRoleFromAccountResponse" : { - "type" : "structure", - "members" : { - "DisassociatedAt" : { - "shape" : "__string", - "documentation" : "The time when the service role was disassociated from the account." - } - } - }, - "Empty" : { - "type" : "structure", - "members" : { }, - "documentation" : "Empty" - }, - "EncodingType" : { - "type" : "string", - "enum" : [ "binary", "json" ] - }, - "ErrorDetail" : { - "type" : "structure", - "members" : { - "DetailedErrorCode" : { - "shape" : "__string", - "documentation" : "A detailed error code." - }, - "DetailedErrorMessage" : { - "shape" : "__string", - "documentation" : "A detailed error message." - } - }, - "documentation" : "Details about the error." - }, - "ErrorDetails" : { - "type" : "list", - "documentation" : "A list of error details.", - "member" : { - "shape" : "ErrorDetail" - } - }, - "Function" : { - "type" : "structure", - "members" : { - "FunctionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the Lambda function." - }, - "FunctionConfiguration" : { - "shape" : "FunctionConfiguration", - "documentation" : "The configuration of the Lambda function." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the Lambda function." - } - }, - "documentation" : "Information about a Lambda function.", - "required" : [ ] - }, - "FunctionConfiguration" : { - "type" : "structure", - "members" : { - "EncodingType" : { - "shape" : "EncodingType", - "documentation" : "The expected encoding type of the input payload for the function. The default is ''json''." - }, - "Environment" : { - "shape" : "FunctionConfigurationEnvironment", - "documentation" : "The environment configuration of the function." - }, - "ExecArgs" : { - "shape" : "__string", - "documentation" : "The execution arguments." - }, - "Executable" : { - "shape" : "__string", - "documentation" : "The name of the function executable." - }, - "MemorySize" : { - "shape" : "__integer", - "documentation" : "The memory size, in KB, which the function requires." - }, - "Pinned" : { - "shape" : "__boolean", - "documentation" : "True if the function is pinned. Pinned means the function is long-lived and starts when the core starts." - }, - "Timeout" : { - "shape" : "__integer", - "documentation" : "The allowed function execution time, after which Lambda should terminate the function. This timeout still applies to pinned lambdas for each request." - } - }, - "documentation" : "The configuration of the Lambda function." - }, - "FunctionConfigurationEnvironment" : { - "type" : "structure", - "members" : { - "AccessSysfs" : { - "shape" : "__boolean", - "documentation" : "If true, the Lambda function is allowed to access the host's /sys folder. Use this when the Lambda function needs to read device information from /sys." - }, - "ResourceAccessPolicies" : { - "shape" : "__listOfResourceAccessPolicy", - "documentation" : "A list of the resources, with their permissions, to which the Lambda function will be granted access. A Lambda function can have at most 10 resources." - }, - "Variables" : { - "shape" : "__mapOf__string", - "documentation" : "Environment variables for the Lambda function's configuration." - } - }, - "documentation" : "The environment configuration of the function." - }, - "FunctionDefinitionVersion" : { - "type" : "structure", - "members" : { - "Functions" : { - "shape" : "__listOfFunction", - "documentation" : "A list of Lambda functions in this function definition version." - } - }, - "documentation" : "Information about a function definition version." - }, - "GeneralError" : { - "type" : "structure", - "members" : { - "ErrorDetails" : { - "shape" : "ErrorDetails", - "documentation" : "Details about the error." - }, - "Message" : { - "shape" : "__string", - "documentation" : "A message containing information about the error." - } - }, - "documentation" : "General error information." - }, - "GetAssociatedRoleRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "GetAssociatedRoleResponse" : { - "type" : "structure", - "members" : { - "AssociatedAt" : { - "shape" : "__string", - "documentation" : "The time when the role was associated with the group." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of the role that is associated with the group." - } - } - }, - "GetConnectivityInfoRequest" : { - "type" : "structure", - "members" : { - "ThingName" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ThingName", - "documentation" : "The thing name." - } - }, - "required" : [ "ThingName" ] - }, - "GetConnectivityInfoResponse" : { - "type" : "structure", - "members" : { - "ConnectivityInfo" : { - "shape" : "__listOfConnectivityInfo", - "documentation" : "Connectivity info list." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "A message about the connectivity info request." - } - } - }, - "GetCoreDefinitionRequest" : { - "type" : "structure", - "members" : { - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - } - }, - "required" : [ "CoreDefinitionId" ] - }, - "GetCoreDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetCoreDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - }, - "CoreDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionVersionId", - "documentation" : "The ID of the core definition version." - } - }, - "required" : [ "CoreDefinitionId", "CoreDefinitionVersionId" ] - }, - "GetCoreDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the core definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the core definition version was created." - }, - "Definition" : { - "shape" : "CoreDefinitionVersion", - "documentation" : "Information about the core definition version." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the core definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the core definition version." - } - } - }, - "GetDeploymentStatusRequest" : { - "type" : "structure", - "members" : { - "DeploymentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeploymentId", - "documentation" : "The ID of the deployment." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId", "DeploymentId" ] - }, - "GetDeploymentStatusResponse" : { - "type" : "structure", - "members" : { - "DeploymentStatus" : { - "shape" : "__string", - "documentation" : "The status of the deployment." - }, - "DeploymentType" : { - "shape" : "DeploymentType", - "documentation" : "The type of the deployment." - }, - "ErrorDetails" : { - "shape" : "ErrorDetails", - "documentation" : "Error details" - }, - "ErrorMessage" : { - "shape" : "__string", - "documentation" : "Error message" - }, - "UpdatedAt" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the deployment status was updated." - } - } - }, - "GetDeviceDefinitionRequest" : { - "type" : "structure", - "members" : { - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - } - }, - "required" : [ "DeviceDefinitionId" ] - }, - "GetDeviceDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetDeviceDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - }, - "DeviceDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionVersionId", - "documentation" : "The ID of the device definition version." - } - }, - "required" : [ "DeviceDefinitionVersionId", "DeviceDefinitionId" ] - }, - "GetDeviceDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the device definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the device definition version was created." - }, - "Definition" : { - "shape" : "DeviceDefinitionVersion", - "documentation" : "Information about the device definition version." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the device definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the device definition version." - } - } - }, - "GetFunctionDefinitionRequest" : { - "type" : "structure", - "members" : { - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - } - }, - "required" : [ "FunctionDefinitionId" ] - }, - "GetFunctionDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetFunctionDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - }, - "FunctionDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionVersionId", - "documentation" : "The ID of the function definition version." - } - }, - "required" : [ "FunctionDefinitionId", "FunctionDefinitionVersionId" ] - }, - "GetFunctionDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the function definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the function definition version was created." - }, - "Definition" : { - "shape" : "FunctionDefinitionVersion", - "documentation" : "Information on the definition." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the function definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the function definition version." - } - } - }, - "GetGroupCertificateAuthorityRequest" : { - "type" : "structure", - "members" : { - "CertificateAuthorityId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CertificateAuthorityId", - "documentation" : "The ID of the certificate authority." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "CertificateAuthorityId", "GroupId" ] - }, - "GetGroupCertificateAuthorityResponse" : { - "type" : "structure", - "members" : { - "GroupCertificateAuthorityArn" : { - "shape" : "__string", - "documentation" : "The ARN of the certificate authority for the group." - }, - "GroupCertificateAuthorityId" : { - "shape" : "__string", - "documentation" : "The ID of the certificate authority for the group." - }, - "PemEncodedCertificate" : { - "shape" : "__string", - "documentation" : "The PEM encoded certificate for the group." - } - } - }, - "GetGroupCertificateConfigurationRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "GetGroupCertificateConfigurationResponse" : { - "type" : "structure", - "members" : { - "CertificateAuthorityExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate authority expires, in milliseconds." - }, - "CertificateExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate expires, in milliseconds." - }, - "GroupId" : { - "shape" : "__string", - "documentation" : "The ID of the group certificate configuration." - } - } - }, - "GetGroupRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "GetGroupResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetGroupVersionRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "GroupVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupVersionId", - "documentation" : "The ID of the group version." - } - }, - "required" : [ "GroupVersionId", "GroupId" ] - }, - "GetGroupVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the group version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the group version was created." - }, - "Definition" : { - "shape" : "GroupVersion", - "documentation" : "Information about the group version definition." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the group version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID for the version of the group." - } - } - }, - "GetLoggerDefinitionRequest" : { - "type" : "structure", - "members" : { - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - } - }, - "required" : [ "LoggerDefinitionId" ] - }, - "GetLoggerDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetLoggerDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - }, - "LoggerDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionVersionId", - "documentation" : "The ID of the logger definition version." - } - }, - "required" : [ "LoggerDefinitionVersionId", "LoggerDefinitionId" ] - }, - "GetLoggerDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the logger definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the logger definition version was created." - }, - "Definition" : { - "shape" : "LoggerDefinitionVersion", - "documentation" : "Information about the logger definition version." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the logger definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the logger definition version." - } - } - }, - "GetResourceDefinitionRequest" : { - "type" : "structure", - "members" : { - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - } - }, - "required" : [ "ResourceDefinitionId" ] - }, - "GetResourceDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetResourceDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - }, - "ResourceDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionVersionId", - "documentation" : "The ID of the resource definition version." - } - }, - "required" : [ "ResourceDefinitionVersionId", "ResourceDefinitionId" ] - }, - "GetResourceDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "Arn of the resource definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the resource definition version was created." - }, - "Definition" : { - "shape" : "ResourceDefinitionVersion", - "documentation" : "Information about the definition." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the resource definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the resource definition version." - } - } - }, - "GetServiceRoleForAccountRequest" : { - "type" : "structure", - "members" : { } - }, - "GetServiceRoleForAccountResponse" : { - "type" : "structure", - "members" : { - "AssociatedAt" : { - "shape" : "__string", - "documentation" : "The time when the service role was associated with the account." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of the role which is associated with the account." - } - } - }, - "GetSubscriptionDefinitionRequest" : { - "type" : "structure", - "members" : { - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - } - }, - "required" : [ "SubscriptionDefinitionId" ] - }, - "GetSubscriptionDefinitionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the definition." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the definition." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the definition was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the definition." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - } - }, - "GetSubscriptionDefinitionVersionRequest" : { - "type" : "structure", - "members" : { - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - }, - "SubscriptionDefinitionVersionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionVersionId", - "documentation" : "The ID of the subscription definition version." - } - }, - "required" : [ "SubscriptionDefinitionId", "SubscriptionDefinitionVersionId" ] - }, - "GetSubscriptionDefinitionVersionResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the subscription definition version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the subscription definition version was created." - }, - "Definition" : { - "shape" : "SubscriptionDefinitionVersion", - "documentation" : "Information about the subscription definition version." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the subscription definition version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The version of the subscription definition version." - } - } - }, - "GroupCertificateAuthorityProperties" : { - "type" : "structure", - "members" : { - "GroupCertificateAuthorityArn" : { - "shape" : "__string", - "documentation" : "The ARN of the certificate authority for the group." - }, - "GroupCertificateAuthorityId" : { - "shape" : "__string", - "documentation" : "The ID of the certificate authority for the group." - } - }, - "documentation" : "Information about a certificate authority for a group." - }, - "GroupCertificateConfiguration" : { - "type" : "structure", - "members" : { - "CertificateAuthorityExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate authority expires, in milliseconds." - }, - "CertificateExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate expires, in milliseconds." - }, - "GroupId" : { - "shape" : "__string", - "documentation" : "The ID of the group certificate configuration." - } - }, - "documentation" : "Information about a group certificate configuration." - }, - "GroupInformation" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the group." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the group was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the group." - }, - "LastUpdatedTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the group was last updated." - }, - "LatestVersion" : { - "shape" : "__string", - "documentation" : "The latest version of the group." - }, - "LatestVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the latest version of the group." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the group." - } - }, - "documentation" : "Information about a group." - }, - "GroupOwnerSetting" : { - "type" : "structure", - "members" : { - "AutoAddGroupOwner" : { - "shape" : "__boolean", - "documentation" : "If true, GreenGrass automatically adds the specified Linux OS group owner of the resource to the Lambda process privileges. Thus the Lambda process will have the file access permissions of the added Linux group." - }, - "GroupOwner" : { - "shape" : "__string", - "documentation" : "The name of the Linux OS group whose privileges will be added to the Lambda process. This field is optional." - } - }, - "documentation" : "Group owner related settings for local resources." - }, - "GroupVersion" : { - "type" : "structure", - "members" : { - "CoreDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the core definition version for this group." - }, - "DeviceDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the device definition version for this group." - }, - "FunctionDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the function definition version for this group." - }, - "LoggerDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the logger definition version for this group." - }, - "ResourceDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The resource definition version ARN for this group." - }, - "SubscriptionDefinitionVersionArn" : { - "shape" : "__string", - "documentation" : "The ARN of the subscription definition version for this group." - } - }, - "documentation" : "Information about a group version." - }, - "InternalServerErrorException" : { - "type" : "structure", - "members" : { - "ErrorDetails" : { - "shape" : "ErrorDetails", - "documentation" : "Details about the error." - }, - "Message" : { - "shape" : "__string", - "documentation" : "A message containing information about the error." - } - }, - "documentation" : "General error information.", - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "ListCoreDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "CoreDefinitionId" ] - }, - "ListCoreDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListCoreDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListCoreDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "documentation" : "A list of definitions." - }, - "ListDeploymentsRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "GroupId" ] - }, - "ListDeploymentsResponse" : { - "type" : "structure", - "members" : { - "Deployments" : { - "shape" : "Deployments", - "documentation" : "A list of deployments for the requested groups." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListDeviceDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "DeviceDefinitionId" ] - }, - "ListDeviceDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListDeviceDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListDeviceDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListFunctionDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "FunctionDefinitionId" ] - }, - "ListFunctionDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListFunctionDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListFunctionDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListGroupCertificateAuthoritiesRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "ListGroupCertificateAuthoritiesResponse" : { - "type" : "structure", - "members" : { - "GroupCertificateAuthorities" : { - "shape" : "__listOfGroupCertificateAuthorityProperties", - "documentation" : "A list of certificate authorities associated with the group." - } - } - }, - "ListGroupVersionsRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "GroupId" ] - }, - "ListGroupVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListGroupsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListGroupsResponse" : { - "type" : "structure", - "members" : { - "Groups" : { - "shape" : "__listOfGroupInformation", - "documentation" : "Information about a group." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListLoggerDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - }, - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - }, - "required" : [ "LoggerDefinitionId" ] - }, - "ListLoggerDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListLoggerDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListLoggerDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListResourceDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - } - }, - "required" : [ "ResourceDefinitionId" ] - }, - "ListResourceDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListResourceDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListResourceDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListSubscriptionDefinitionVersionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - } - }, - "required" : [ "SubscriptionDefinitionId" ] - }, - "ListSubscriptionDefinitionVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - } - }, - "ListSubscriptionDefinitionsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "The maximum number of results to be returned per request." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListSubscriptionDefinitionsResponse" : { - "type" : "structure", - "members" : { - "Definitions" : { - "shape" : "__listOfDefinitionInformation", - "documentation" : "Information about a definition." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - } - } - }, - "ListVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "documentation" : "The token for the next set of results, or ''null'' if there are no additional results." - }, - "Versions" : { - "shape" : "__listOfVersionInformation", - "documentation" : "Information about a version." - } - }, - "documentation" : "A list of versions." - }, - "LocalDeviceResourceData" : { - "type" : "structure", - "members" : { - "GroupOwnerSetting" : { - "shape" : "GroupOwnerSetting", - "documentation" : "Group/owner related settings for local resources." - }, - "SourcePath" : { - "shape" : "__string", - "documentation" : "The local absolute path of the device resource. The source path for a device resource can refer only to a character device or block device under ''/dev''." - } - }, - "documentation" : "Attributes that define a local device resource." - }, - "LocalVolumeResourceData" : { - "type" : "structure", - "members" : { - "DestinationPath" : { - "shape" : "__string", - "documentation" : "The absolute local path of the resource inside the lambda environment." - }, - "GroupOwnerSetting" : { - "shape" : "GroupOwnerSetting", - "documentation" : "Allows you to configure additional group privileges for the Lambda process. This field is optional." - }, - "SourcePath" : { - "shape" : "__string", - "documentation" : "The local absolute path of the volume resource on the host. The source path for a volume resource type cannot start with ''/sys''." - } - }, - "documentation" : "Attributes that define a local volume resource." - }, - "Logger" : { - "type" : "structure", - "members" : { - "Component" : { - "shape" : "LoggerComponent", - "documentation" : "The component that will be subject to logging." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The id of the logger." - }, - "Level" : { - "shape" : "LoggerLevel", - "documentation" : "The level of the logs." - }, - "Space" : { - "shape" : "__integer", - "documentation" : "The amount of file space, in KB, to use if the local file system is used for logging purposes." - }, - "Type" : { - "shape" : "LoggerType", - "documentation" : "The type of log output which will be used." - } - }, - "documentation" : "Information about a logger", - "required" : [ ] - }, - "LoggerComponent" : { - "type" : "string", - "enum" : [ "GreengrassSystem", "Lambda" ] - }, - "LoggerDefinitionVersion" : { - "type" : "structure", - "members" : { - "Loggers" : { - "shape" : "__listOfLogger", - "documentation" : "A list of loggers." - } - }, - "documentation" : "Information about a logger definition version." - }, - "LoggerLevel" : { - "type" : "string", - "enum" : [ "DEBUG", "INFO", "WARN", "ERROR", "FATAL" ] - }, - "LoggerType" : { - "type" : "string", - "enum" : [ "FileSystem", "AWSCloudWatch" ] - }, - "Permission" : { - "type" : "string", - "documentation" : "The type of permission a function has to access a resource.", - "enum" : [ "ro", "rw" ] - }, - "ResetDeploymentsRequest" : { - "type" : "structure", - "members" : { - "AmznClientToken" : { - "shape" : "__string", - "location" : "header", - "locationName" : "X-Amzn-Client-Token", - "documentation" : "A client token used to correlate requests and responses." - }, - "Force" : { - "shape" : "__boolean", - "documentation" : "If true, performs a best-effort only core reset." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "documentation" : "Information needed to reset deployments.", - "required" : [ "GroupId" ] - }, - "ResetDeploymentsResponse" : { - "type" : "structure", - "members" : { - "DeploymentArn" : { - "shape" : "__string", - "documentation" : "The ARN of the deployment." - }, - "DeploymentId" : { - "shape" : "__string", - "documentation" : "The ID of the deployment." - } - } - }, - "Resource" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "documentation" : "The resource ID, used to refer to a resource in the Lambda function configuration. Max length is 128 characters with pattern ''[a-zA-Z0-9:_-]+''. This must be unique within a Greengrass group." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The descriptive resource name, which is displayed on the Greengrass console. Max length 128 characters with pattern ''[a-zA-Z0-9:_-]+''. This must be unique within a Greengrass group." - }, - "ResourceDataContainer" : { - "shape" : "ResourceDataContainer", - "documentation" : "A container of data for all resource types." - } - }, - "documentation" : "Information about a resource.", - "required" : [ ] - }, - "ResourceAccessPolicy" : { - "type" : "structure", - "members" : { - "Permission" : { - "shape" : "Permission", - "documentation" : "The permissions that the Lambda function has to the resource. Can be one of ''rw'' (read/write) or ''ro'' (read-only)." - }, - "ResourceId" : { - "shape" : "__string", - "documentation" : "The ID of the resource. (This ID is assigned to the resource when you create the resource definiton.)" - } - }, - "documentation" : "A policy used by the function to access a resource.", - "required" : [ ] - }, - "ResourceDataContainer" : { - "type" : "structure", - "members" : { - "LocalDeviceResourceData" : { - "shape" : "LocalDeviceResourceData", - "documentation" : "Attributes that define the local device resource." - }, - "LocalVolumeResourceData" : { - "shape" : "LocalVolumeResourceData", - "documentation" : "Attributes that define the local volume resource." - }, - "S3MachineLearningModelResourceData" : { - "shape" : "S3MachineLearningModelResourceData", - "documentation" : "Attributes that define an S3 machine learning resource." - }, - "SageMakerMachineLearningModelResourceData" : { - "shape" : "SageMakerMachineLearningModelResourceData", - "documentation" : "Attributes that define an SageMaker machine learning resource." - } - }, - "documentation" : "A container for resource data. The container takes only one of the following supported resource data types: ''LocalDeviceResourceData'', ''LocalVolumeResourceData'', ''SageMakerMachineLearningModelResourceData'', ''S3MachineLearningModelResourceData''." - }, - "ResourceDefinitionVersion" : { - "type" : "structure", - "members" : { - "Resources" : { - "shape" : "__listOfResource", - "documentation" : "A list of resources." - } - }, - "documentation" : "Information about a resource definition version." - }, - "S3MachineLearningModelResourceData" : { - "type" : "structure", - "members" : { - "DestinationPath" : { - "shape" : "__string", - "documentation" : "The absolute local path of the resource inside the Lambda environment." - }, - "S3Uri" : { - "shape" : "__string", - "documentation" : "The URI of the source model in an S3 bucket. The model package must be in tar.gz or .zip format." - } - }, - "documentation" : "Attributes that define an S3 machine learning resource." - }, - "S3UrlSignerRole" : { - "type" : "string", - "documentation" : "The IAM Role that Greengrass will use to create pre-signed URLs pointing towards the update artifact." - }, - "SageMakerMachineLearningModelResourceData" : { - "type" : "structure", - "members" : { - "DestinationPath" : { - "shape" : "__string", - "documentation" : "The absolute local path of the resource inside the Lambda environment." - }, - "SageMakerJobArn" : { - "shape" : "__string", - "documentation" : "The ARN of the SageMaker training job that represents the source model." - } - }, - "documentation" : "Attributes that define an SageMaker machine learning resource." - }, - "SoftwareToUpdate" : { - "type" : "string", - "documentation" : "The piece of software on the Greengrass core that will be updated.", - "enum" : [ "core", "ota_agent" ] - }, - "Subscription" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "documentation" : "The id of the subscription." - }, - "Source" : { - "shape" : "__string", - "documentation" : "The source of the subscription. Can be a thing ARN, a Lambda function ARN, 'cloud' (which represents the IoT cloud), or 'GGShadowService'." - }, - "Subject" : { - "shape" : "__string", - "documentation" : "The subject of the message." - }, - "Target" : { - "shape" : "__string", - "documentation" : "Where the message is sent to. Can be a thing ARN, a Lambda function ARN, 'cloud' (which represents the IoT cloud), or 'GGShadowService'." - } - }, - "documentation" : "Information about a subscription.", - "required" : [ ] - }, - "SubscriptionDefinitionVersion" : { - "type" : "structure", - "members" : { - "Subscriptions" : { - "shape" : "__listOfSubscription", - "documentation" : "A list of subscriptions." - } - }, - "documentation" : "Information about a subscription definition version." - }, - "UpdateAgentLogLevel" : { - "type" : "string", - "documentation" : "The minimum level of log statements that should be logged by the OTA Agent during an update.", - "enum" : [ "NONE", "TRACE", "DEBUG", "VERBOSE", "INFO", "WARN", "ERROR", "FATAL" ] - }, - "UpdateConnectivityInfoRequest" : { - "type" : "structure", - "members" : { - "ConnectivityInfo" : { - "shape" : "__listOfConnectivityInfo", - "documentation" : "A list of connectivity info." - }, - "ThingName" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ThingName", - "documentation" : "The thing name." - } - }, - "documentation" : "Connectivity information.", - "required" : [ "ThingName" ] - }, - "UpdateConnectivityInfoResponse" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "A message about the connectivity info update request." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The new version of the connectivity info." - } - } - }, - "UpdateCoreDefinitionRequest" : { - "type" : "structure", - "members" : { - "CoreDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "CoreDefinitionId", - "documentation" : "The ID of the core definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "required" : [ "CoreDefinitionId" ] - }, - "UpdateCoreDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateDeviceDefinitionRequest" : { - "type" : "structure", - "members" : { - "DeviceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "DeviceDefinitionId", - "documentation" : "The ID of the device definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "required" : [ "DeviceDefinitionId" ] - }, - "UpdateDeviceDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateFunctionDefinitionRequest" : { - "type" : "structure", - "members" : { - "FunctionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "FunctionDefinitionId", - "documentation" : "The ID of the Lambda function definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "required" : [ "FunctionDefinitionId" ] - }, - "UpdateFunctionDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateGroupCertificateConfigurationRequest" : { - "type" : "structure", - "members" : { - "CertificateExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate expires, in milliseconds." - }, - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - } - }, - "required" : [ "GroupId" ] - }, - "UpdateGroupCertificateConfigurationResponse" : { - "type" : "structure", - "members" : { - "CertificateAuthorityExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate authority expires, in milliseconds." - }, - "CertificateExpiryInMilliseconds" : { - "shape" : "__string", - "documentation" : "The amount of time remaining before the certificate expires, in milliseconds." - }, - "GroupId" : { - "shape" : "__string", - "documentation" : "The ID of the group certificate configuration." - } - } - }, - "UpdateGroupRequest" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "GroupId", - "documentation" : "The ID of the AWS Greengrass group." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "required" : [ "GroupId" ] - }, - "UpdateGroupResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateLoggerDefinitionRequest" : { - "type" : "structure", - "members" : { - "LoggerDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "LoggerDefinitionId", - "documentation" : "The ID of the logger definition." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - } - }, - "required" : [ "LoggerDefinitionId" ] - }, - "UpdateLoggerDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateResourceDefinitionRequest" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - }, - "ResourceDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ResourceDefinitionId", - "documentation" : "The ID of the resource definition." - } - }, - "required" : [ "ResourceDefinitionId" ] - }, - "UpdateResourceDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateSubscriptionDefinitionRequest" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "documentation" : "The name of the definition." - }, - "SubscriptionDefinitionId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "SubscriptionDefinitionId", - "documentation" : "The ID of the subscription definition." - } - }, - "required" : [ "SubscriptionDefinitionId" ] - }, - "UpdateSubscriptionDefinitionResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateTargets" : { - "type" : "list", - "documentation" : "The ARNs of the targets (IoT things or IoT thing groups) that this update will be applied to.", - "member" : { - "shape" : "__string" - } - }, - "UpdateTargetsArchitecture" : { - "type" : "string", - "documentation" : "The architecture of the cores which are the targets of an update.", - "enum" : [ "armv7l", "x86_64", "aarch64" ] - }, - "UpdateTargetsOperatingSystem" : { - "type" : "string", - "documentation" : "The operating system of the cores which are the targets of an update.", - "enum" : [ "ubuntu", "raspbian", "amazon_linux" ] - }, - "VersionInformation" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "documentation" : "The ARN of the version." - }, - "CreationTimestamp" : { - "shape" : "__string", - "documentation" : "The time, in milliseconds since the epoch, when the version was created." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The ID of the version." - }, - "Version" : { - "shape" : "__string", - "documentation" : "The unique ID of the version." - } - }, - "documentation" : "Information about a version." - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__listOfConnectivityInfo" : { - "type" : "list", - "member" : { - "shape" : "ConnectivityInfo" - } - }, - "__listOfCore" : { - "type" : "list", - "member" : { - "shape" : "Core" - } - }, - "__listOfDefinitionInformation" : { - "type" : "list", - "member" : { - "shape" : "DefinitionInformation" - } - }, - "__listOfDevice" : { - "type" : "list", - "member" : { - "shape" : "Device" - } - }, - "__listOfFunction" : { - "type" : "list", - "member" : { - "shape" : "Function" - } - }, - "__listOfGroupCertificateAuthorityProperties" : { - "type" : "list", - "member" : { - "shape" : "GroupCertificateAuthorityProperties" - } - }, - "__listOfGroupInformation" : { - "type" : "list", - "member" : { - "shape" : "GroupInformation" - } - }, - "__listOfLogger" : { - "type" : "list", - "member" : { - "shape" : "Logger" - } - }, - "__listOfResource" : { - "type" : "list", - "member" : { - "shape" : "Resource" - } - }, - "__listOfResourceAccessPolicy" : { - "type" : "list", - "member" : { - "shape" : "ResourceAccessPolicy" - } - }, - "__listOfSubscription" : { - "type" : "list", - "member" : { - "shape" : "Subscription" - } - }, - "__listOfVersionInformation" : { - "type" : "list", - "member" : { - "shape" : "VersionInformation" - } - }, - "__long" : { - "type" : "long" - }, - "__mapOf__string" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "__string" - } - }, - "__string" : { - "type" : "string" - }, - "__timestamp" : { - "type" : "timestamp" - } - }, - "documentation" : "AWS Greengrass seamlessly extends AWS onto physical devices so they can act locally on the data they generate, while still using the cloud for management, analytics, and durable storage. AWS Greengrass ensures your devices can respond quickly to local events and operate with intermittent connectivity. AWS Greengrass minimizes the cost of transmitting data to the cloud by allowing you to author AWS Lambda functions that execute locally." -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/paginators-1.json deleted file mode 100644 index 92a10d33..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/paginators-1.json +++ /dev/null @@ -1,46 +0,0 @@ -{ - "pagination": { - "ListDetectors": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "DetectorIds" - }, - "ListFindings": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "FindingIds" - }, - "ListIPSets": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "IpSetIds" - }, - "ListThreatIntelSets": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "ThreatIntelSetIds" - }, - "ListInvitations": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "Invitations" - }, - "ListMembers": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "Members" - }, - "ListFilters": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "FilterNames" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/service-2.json deleted file mode 100644 index b6197573..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/guardduty/2017-11-28/service-2.json +++ /dev/null @@ -1,3562 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2017-11-28", - "endpointPrefix" : "guardduty", - "signingName" : "guardduty", - "serviceFullName" : "Amazon GuardDuty", - "serviceId" : "GuardDuty", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "guardduty-2017-11-28", - "signatureVersion" : "v4" - }, - "operations" : { - "AcceptInvitation" : { - "name" : "AcceptInvitation", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/master", - "responseCode" : 200 - }, - "input" : { - "shape" : "AcceptInvitationRequest" - }, - "output" : { - "shape" : "AcceptInvitationResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Accepts the invitation to be monitored by a master GuardDuty account." - }, - "ArchiveFindings" : { - "name" : "ArchiveFindings", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/archive", - "responseCode" : 200 - }, - "input" : { - "shape" : "ArchiveFindingsRequest" - }, - "output" : { - "shape" : "ArchiveFindingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Archives Amazon GuardDuty findings specified by the list of finding IDs." - }, - "CreateDetector" : { - "name" : "CreateDetector", - "http" : { - "method" : "POST", - "requestUri" : "/detector", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateDetectorRequest" - }, - "output" : { - "shape" : "CreateDetectorResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Creates a single Amazon GuardDuty detector. A detector is an object that represents the GuardDuty service. A detector must be created in order for GuardDuty to become operational." - }, - "CreateFilter" : { - "name" : "CreateFilter", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/filter", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateFilterRequest" - }, - "output" : { - "shape" : "CreateFilterResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Creates a filter using the specified finding criteria." - }, - "CreateIPSet" : { - "name" : "CreateIPSet", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/ipset", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateIPSetRequest" - }, - "output" : { - "shape" : "CreateIPSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Creates a new IPSet - a list of trusted IP addresses that have been whitelisted for secure communication with AWS infrastructure and applications." - }, - "CreateMembers" : { - "name" : "CreateMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateMembersRequest" - }, - "output" : { - "shape" : "CreateMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Creates member accounts of the current AWS account by specifying a list of AWS account IDs. The current AWS account can then invite these members to manage GuardDuty in their accounts." - }, - "CreateSampleFindings" : { - "name" : "CreateSampleFindings", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/create", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateSampleFindingsRequest" - }, - "output" : { - "shape" : "CreateSampleFindingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Generates example findings of types specified by the list of finding types. If 'NULL' is specified for findingTypes, the API generates example findings of all supported finding types." - }, - "CreateThreatIntelSet" : { - "name" : "CreateThreatIntelSet", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/threatintelset", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateThreatIntelSetRequest" - }, - "output" : { - "shape" : "CreateThreatIntelSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Create a new ThreatIntelSet. ThreatIntelSets consist of known malicious IP addresses. GuardDuty generates findings based on ThreatIntelSets." - }, - "DeclineInvitations" : { - "name" : "DeclineInvitations", - "http" : { - "method" : "POST", - "requestUri" : "/invitation/decline", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeclineInvitationsRequest" - }, - "output" : { - "shape" : "DeclineInvitationsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Declines invitations sent to the current member account by AWS account specified by their account IDs." - }, - "DeleteDetector" : { - "name" : "DeleteDetector", - "http" : { - "method" : "DELETE", - "requestUri" : "/detector/{detectorId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteDetectorRequest" - }, - "output" : { - "shape" : "DeleteDetectorResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes a Amazon GuardDuty detector specified by the detector ID." - }, - "DeleteFilter" : { - "name" : "DeleteFilter", - "http" : { - "method" : "DELETE", - "requestUri" : "/detector/{detectorId}/filter/{filterName}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteFilterRequest" - }, - "output" : { - "shape" : "DeleteFilterResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes the filter specified by the filter name." - }, - "DeleteIPSet" : { - "name" : "DeleteIPSet", - "http" : { - "method" : "DELETE", - "requestUri" : "/detector/{detectorId}/ipset/{ipSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteIPSetRequest" - }, - "output" : { - "shape" : "DeleteIPSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes the IPSet specified by the IPSet ID." - }, - "DeleteInvitations" : { - "name" : "DeleteInvitations", - "http" : { - "method" : "POST", - "requestUri" : "/invitation/delete", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteInvitationsRequest" - }, - "output" : { - "shape" : "DeleteInvitationsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes invitations sent to the current member account by AWS accounts specified by their account IDs." - }, - "DeleteMembers" : { - "name" : "DeleteMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/delete", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteMembersRequest" - }, - "output" : { - "shape" : "DeleteMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs." - }, - "DeleteThreatIntelSet" : { - "name" : "DeleteThreatIntelSet", - "http" : { - "method" : "DELETE", - "requestUri" : "/detector/{detectorId}/threatintelset/{threatIntelSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteThreatIntelSetRequest" - }, - "output" : { - "shape" : "DeleteThreatIntelSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Deletes ThreatIntelSet specified by the ThreatIntelSet ID." - }, - "DisassociateFromMasterAccount" : { - "name" : "DisassociateFromMasterAccount", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/master/disassociate", - "responseCode" : 200 - }, - "input" : { - "shape" : "DisassociateFromMasterAccountRequest" - }, - "output" : { - "shape" : "DisassociateFromMasterAccountResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Disassociates the current GuardDuty member account from its master account." - }, - "DisassociateMembers" : { - "name" : "DisassociateMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/disassociate", - "responseCode" : 200 - }, - "input" : { - "shape" : "DisassociateMembersRequest" - }, - "output" : { - "shape" : "DisassociateMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Disassociates GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs." - }, - "GetDetector" : { - "name" : "GetDetector", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetDetectorRequest" - }, - "output" : { - "shape" : "GetDetectorResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Retrieves an Amazon GuardDuty detector specified by the detectorId." - }, - "GetFilter" : { - "name" : "GetFilter", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/filter/{filterName}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetFilterRequest" - }, - "output" : { - "shape" : "GetFilterResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Returns the details of the filter specified by the filter name." - }, - "GetFindings" : { - "name" : "GetFindings", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/get", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetFindingsRequest" - }, - "output" : { - "shape" : "GetFindingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Describes Amazon GuardDuty findings specified by finding IDs." - }, - "GetFindingsStatistics" : { - "name" : "GetFindingsStatistics", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/statistics", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetFindingsStatisticsRequest" - }, - "output" : { - "shape" : "GetFindingsStatisticsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists Amazon GuardDuty findings' statistics for the specified detector ID." - }, - "GetIPSet" : { - "name" : "GetIPSet", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/ipset/{ipSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetIPSetRequest" - }, - "output" : { - "shape" : "GetIPSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Retrieves the IPSet specified by the IPSet ID." - }, - "GetInvitationsCount" : { - "name" : "GetInvitationsCount", - "http" : { - "method" : "GET", - "requestUri" : "/invitation/count", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetInvitationsCountRequest" - }, - "output" : { - "shape" : "GetInvitationsCountResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Returns the count of all GuardDuty membership invitations that were sent to the current member account except the currently accepted invitation." - }, - "GetMasterAccount" : { - "name" : "GetMasterAccount", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/master", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetMasterAccountRequest" - }, - "output" : { - "shape" : "GetMasterAccountResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Provides the details for the GuardDuty master account to the current GuardDuty member account." - }, - "GetMembers" : { - "name" : "GetMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/get", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetMembersRequest" - }, - "output" : { - "shape" : "GetMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Retrieves GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs." - }, - "GetThreatIntelSet" : { - "name" : "GetThreatIntelSet", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/threatintelset/{threatIntelSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetThreatIntelSetRequest" - }, - "output" : { - "shape" : "GetThreatIntelSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Retrieves the ThreatIntelSet that is specified by the ThreatIntelSet ID." - }, - "InviteMembers" : { - "name" : "InviteMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/invite", - "responseCode" : 200 - }, - "input" : { - "shape" : "InviteMembersRequest" - }, - "output" : { - "shape" : "InviteMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Invites other AWS accounts (created as members of the current AWS account by CreateMembers) to enable GuardDuty and allow the current AWS account to view and manage these accounts' GuardDuty findings on their behalf as the master account." - }, - "ListDetectors" : { - "name" : "ListDetectors", - "http" : { - "method" : "GET", - "requestUri" : "/detector", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDetectorsRequest" - }, - "output" : { - "shape" : "ListDetectorsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists detectorIds of all the existing Amazon GuardDuty detector resources." - }, - "ListFilters" : { - "name" : "ListFilters", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/filter", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListFiltersRequest" - }, - "output" : { - "shape" : "ListFiltersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Returns a paginated list of the current filters." - }, - "ListFindings" : { - "name" : "ListFindings", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListFindingsRequest" - }, - "output" : { - "shape" : "ListFindingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists Amazon GuardDuty findings for the specified detector ID." - }, - "ListIPSets" : { - "name" : "ListIPSets", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/ipset", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListIPSetsRequest" - }, - "output" : { - "shape" : "ListIPSetsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists the IPSets of the GuardDuty service specified by the detector ID." - }, - "ListInvitations" : { - "name" : "ListInvitations", - "http" : { - "method" : "GET", - "requestUri" : "/invitation", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListInvitationsRequest" - }, - "output" : { - "shape" : "ListInvitationsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists all GuardDuty membership invitations that were sent to the current AWS account." - }, - "ListMembers" : { - "name" : "ListMembers", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/member", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListMembersRequest" - }, - "output" : { - "shape" : "ListMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists details about all member accounts for the current GuardDuty master account." - }, - "ListThreatIntelSets" : { - "name" : "ListThreatIntelSets", - "http" : { - "method" : "GET", - "requestUri" : "/detector/{detectorId}/threatintelset", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListThreatIntelSetsRequest" - }, - "output" : { - "shape" : "ListThreatIntelSetsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Lists the ThreatIntelSets of the GuardDuty service specified by the detector ID." - }, - "StartMonitoringMembers" : { - "name" : "StartMonitoringMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/start", - "responseCode" : 200 - }, - "input" : { - "shape" : "StartMonitoringMembersRequest" - }, - "output" : { - "shape" : "StartMonitoringMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Re-enables GuardDuty to monitor findings of the member accounts specified by the account IDs. A master GuardDuty account can run this command after disabling GuardDuty from monitoring these members' findings by running StopMonitoringMembers." - }, - "StopMonitoringMembers" : { - "name" : "StopMonitoringMembers", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/member/stop", - "responseCode" : 200 - }, - "input" : { - "shape" : "StopMonitoringMembersRequest" - }, - "output" : { - "shape" : "StopMonitoringMembersResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Disables GuardDuty from monitoring findings of the member accounts specified by the account IDs. After running this command, a master GuardDuty account can run StartMonitoringMembers to re-enable GuardDuty to monitor these members’ findings." - }, - "UnarchiveFindings" : { - "name" : "UnarchiveFindings", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/unarchive", - "responseCode" : 200 - }, - "input" : { - "shape" : "UnarchiveFindingsRequest" - }, - "output" : { - "shape" : "UnarchiveFindingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Unarchives Amazon GuardDuty findings specified by the list of finding IDs." - }, - "UpdateDetector" : { - "name" : "UpdateDetector", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateDetectorRequest" - }, - "output" : { - "shape" : "UpdateDetectorResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Updates an Amazon GuardDuty detector specified by the detectorId." - }, - "UpdateFilter" : { - "name" : "UpdateFilter", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/filter/{filterName}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateFilterRequest" - }, - "output" : { - "shape" : "UpdateFilterResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Updates the filter specified by the filter name." - }, - "UpdateFindingsFeedback" : { - "name" : "UpdateFindingsFeedback", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/findings/feedback", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateFindingsFeedbackRequest" - }, - "output" : { - "shape" : "UpdateFindingsFeedbackResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Marks specified Amazon GuardDuty findings as useful or not useful." - }, - "UpdateIPSet" : { - "name" : "UpdateIPSet", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/ipset/{ipSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateIPSetRequest" - }, - "output" : { - "shape" : "UpdateIPSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Updates the IPSet specified by the IPSet ID." - }, - "UpdateThreatIntelSet" : { - "name" : "UpdateThreatIntelSet", - "http" : { - "method" : "POST", - "requestUri" : "/detector/{detectorId}/threatintelset/{threatIntelSetId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateThreatIntelSetRequest" - }, - "output" : { - "shape" : "UpdateThreatIntelSetResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - } ], - "documentation" : "Updates the ThreatIntelSet specified by ThreatIntelSet ID." - } - }, - "shapes" : { - "AcceptInvitationRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty member account." - }, - "InvitationId" : { - "shape" : "InvitationId", - "locationName" : "invitationId", - "documentation" : "This value is used to validate the master account to the member account." - }, - "MasterId" : { - "shape" : "MasterId", - "locationName" : "masterId", - "documentation" : "The account ID of the master GuardDuty account whose invitation you're accepting." - } - }, - "documentation" : "AcceptInvitation request body.", - "required" : [ "DetectorId" ] - }, - "AcceptInvitationResponse" : { - "type" : "structure", - "members" : { } - }, - "AccessKeyDetails" : { - "type" : "structure", - "members" : { - "AccessKeyId" : { - "shape" : "__string", - "locationName" : "accessKeyId", - "documentation" : "Access key ID of the user." - }, - "PrincipalId" : { - "shape" : "__string", - "locationName" : "principalId", - "documentation" : "The principal ID of the user." - }, - "UserName" : { - "shape" : "__string", - "locationName" : "userName", - "documentation" : "The name of the user." - }, - "UserType" : { - "shape" : "__string", - "locationName" : "userType", - "documentation" : "The type of the user." - } - }, - "documentation" : "The IAM access key details (IAM user information) of a user that engaged in the activity that prompted GuardDuty to generate a finding." - }, - "AccountDetail" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "AccountId", - "locationName" : "accountId", - "documentation" : "Member account ID." - }, - "Email" : { - "shape" : "Email", - "locationName" : "email", - "documentation" : "Member account's email address." - } - }, - "documentation" : "An object containing the member's accountId and email address.", - "required" : [ "Email", "AccountId" ] - }, - "AccountDetails" : { - "type" : "list", - "documentation" : "A list of account/email pairs.", - "member" : { - "shape" : "AccountDetail" - } - }, - "AccountId" : { - "type" : "string", - "documentation" : "AWS account ID." - }, - "AccountIds" : { - "type" : "list", - "documentation" : "A list of account IDs.", - "member" : { - "shape" : "__string" - } - }, - "Action" : { - "type" : "structure", - "members" : { - "ActionType" : { - "shape" : "__string", - "locationName" : "actionType", - "documentation" : "GuardDuty Finding activity type." - }, - "AwsApiCallAction" : { - "shape" : "AwsApiCallAction", - "locationName" : "awsApiCallAction", - "documentation" : "Information about the AWS_API_CALL action described in this finding." - }, - "DnsRequestAction" : { - "shape" : "DnsRequestAction", - "locationName" : "dnsRequestAction", - "documentation" : "Information about the DNS_REQUEST action described in this finding." - }, - "NetworkConnectionAction" : { - "shape" : "NetworkConnectionAction", - "locationName" : "networkConnectionAction", - "documentation" : "Information about the NETWORK_CONNECTION action described in this finding." - }, - "PortProbeAction" : { - "shape" : "PortProbeAction", - "locationName" : "portProbeAction", - "documentation" : "Information about the PORT_PROBE action described in this finding." - } - }, - "documentation" : "Information about the activity described in a finding." - }, - "Activate" : { - "type" : "boolean", - "documentation" : "Whether we should start processing the list immediately or not." - }, - "ArchiveFindingsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings you want to archive." - }, - "FindingIds" : { - "shape" : "FindingIds", - "locationName" : "findingIds", - "documentation" : "IDs of the findings that you want to archive." - } - }, - "documentation" : "ArchiveFindings request body.", - "required" : [ "DetectorId" ] - }, - "ArchiveFindingsResponse" : { - "type" : "structure", - "members" : { } - }, - "AwsApiCallAction" : { - "type" : "structure", - "members" : { - "Api" : { - "shape" : "__string", - "locationName" : "api", - "documentation" : "AWS API name." - }, - "CallerType" : { - "shape" : "__string", - "locationName" : "callerType", - "documentation" : "AWS API caller type." - }, - "DomainDetails" : { - "shape" : "DomainDetails", - "locationName" : "domainDetails", - "documentation" : "Domain information for the AWS API call." - }, - "RemoteIpDetails" : { - "shape" : "RemoteIpDetails", - "locationName" : "remoteIpDetails", - "documentation" : "Remote IP information of the connection." - }, - "ServiceName" : { - "shape" : "__string", - "locationName" : "serviceName", - "documentation" : "AWS service name whose API was invoked." - } - }, - "documentation" : "Information about the AWS_API_CALL action described in this finding." - }, - "BadRequestException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The error message." - }, - "Type" : { - "shape" : "__string", - "locationName" : "__type", - "documentation" : "The error type." - } - }, - "documentation" : "Error response object.", - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "City" : { - "type" : "structure", - "members" : { - "CityName" : { - "shape" : "__string", - "locationName" : "cityName", - "documentation" : "City name of the remote IP address." - } - }, - "documentation" : "City information of the remote IP address." - }, - "Comments" : { - "type" : "string", - "documentation" : "Additional feedback about the GuardDuty findings." - }, - "Condition" : { - "type" : "structure", - "members" : { - "Eq" : { - "shape" : "Eq", - "locationName" : "eq", - "documentation" : "Represents the equal condition to be applied to a single field when querying for findings." - }, - "Gt" : { - "shape" : "__integer", - "locationName" : "gt", - "documentation" : "Represents the greater than condition to be applied to a single field when querying for findings." - }, - "Gte" : { - "shape" : "__integer", - "locationName" : "gte", - "documentation" : "Represents the greater than equal condition to be applied to a single field when querying for findings." - }, - "Lt" : { - "shape" : "__integer", - "locationName" : "lt", - "documentation" : "Represents the less than condition to be applied to a single field when querying for findings." - }, - "Lte" : { - "shape" : "__integer", - "locationName" : "lte", - "documentation" : "Represents the less than equal condition to be applied to a single field when querying for findings." - }, - "Neq" : { - "shape" : "Neq", - "locationName" : "neq", - "documentation" : "Represents the not equal condition to be applied to a single field when querying for findings." - } - }, - "documentation" : "Finding attribute (for example, accountId) for which conditions and values must be specified when querying findings." - }, - "CountBySeverityFindingStatistic" : { - "type" : "integer", - "documentation" : "The count of findings for the given severity." - }, - "Country" : { - "type" : "structure", - "members" : { - "CountryCode" : { - "shape" : "__string", - "locationName" : "countryCode", - "documentation" : "Country code of the remote IP address." - }, - "CountryName" : { - "shape" : "__string", - "locationName" : "countryName", - "documentation" : "Country name of the remote IP address." - } - }, - "documentation" : "Country information of the remote IP address." - }, - "CreateDetectorRequest" : { - "type" : "structure", - "members" : { - "Enable" : { - "shape" : "Enable", - "locationName" : "enable", - "documentation" : "A boolean value that specifies whether the detector is to be enabled." - } - }, - "documentation" : "CreateDetector request body." - }, - "CreateDetectorResponse" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "DetectorId", - "locationName" : "detectorId", - "documentation" : "The unique ID of the created detector." - } - } - }, - "CreateFilterRequest" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "FilterAction", - "locationName" : "action", - "documentation" : "Specifies the action that is to be applied to the findings that match the filter." - }, - "ClientToken" : { - "shape" : "__stringMin0Max64", - "locationName" : "clientToken", - "documentation" : "The idempotency token for the create request.", - "idempotencyToken" : true - }, - "Description" : { - "shape" : "FilterDescription", - "locationName" : "description", - "documentation" : "The description of the filter." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to update." - }, - "FindingCriteria" : { - "shape" : "FindingCriteria", - "locationName" : "findingCriteria", - "documentation" : "Represents the criteria to be used in the filter for querying findings." - }, - "Name" : { - "shape" : "FilterName", - "locationName" : "name", - "documentation" : "The name of the filter." - }, - "Rank" : { - "shape" : "FilterRank", - "locationName" : "rank", - "documentation" : "Specifies the position of the filter in the list of current filters. Also specifies the order in which this filter is applied to the findings." - } - }, - "documentation" : "CreateFilterRequest request body.", - "required" : [ "DetectorId" ] - }, - "CreateFilterResponse" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "FilterName", - "locationName" : "name", - "documentation" : "The name of the successfully created filter." - } - } - }, - "CreateIPSetRequest" : { - "type" : "structure", - "members" : { - "Activate" : { - "shape" : "Activate", - "locationName" : "activate", - "documentation" : "A boolean value that indicates whether GuardDuty is to start using the uploaded IPSet." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to update." - }, - "Format" : { - "shape" : "IpSetFormat", - "locationName" : "format", - "documentation" : "The format of the file that contains the IPSet." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The URI of the file that contains the IPSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)" - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "The user friendly name to identify the IPSet. This name is displayed in all findings that are triggered by activity that involves IP addresses included in this IPSet." - } - }, - "documentation" : "CreateIPSet request body.", - "required" : [ "DetectorId" ] - }, - "CreateIPSetResponse" : { - "type" : "structure", - "members" : { - "IpSetId" : { - "shape" : "IpSetId", - "locationName" : "ipSetId" - } - } - }, - "CreateMembersRequest" : { - "type" : "structure", - "members" : { - "AccountDetails" : { - "shape" : "AccountDetails", - "locationName" : "accountDetails", - "documentation" : "A list of account ID and email address pairs of the accounts that you want to associate with the master GuardDuty account." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account with which you want to associate member accounts." - } - }, - "documentation" : "CreateMembers request body.", - "required" : [ "DetectorId" ] - }, - "CreateMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "CreateSampleFindingsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector to create sample findings for." - }, - "FindingTypes" : { - "shape" : "FindingTypes", - "locationName" : "findingTypes", - "documentation" : "Types of sample findings that you want to generate." - } - }, - "documentation" : "CreateSampleFindings request body.", - "required" : [ "DetectorId" ] - }, - "CreateSampleFindingsResponse" : { - "type" : "structure", - "members" : { } - }, - "CreateThreatIntelSetRequest" : { - "type" : "structure", - "members" : { - "Activate" : { - "shape" : "Activate", - "locationName" : "activate", - "documentation" : "A boolean value that indicates whether GuardDuty is to start using the uploaded ThreatIntelSet." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to update." - }, - "Format" : { - "shape" : "ThreatIntelSetFormat", - "locationName" : "format", - "documentation" : "The format of the file that contains the ThreatIntelSet." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The URI of the file that contains the ThreatIntelSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)." - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "A user-friendly ThreatIntelSet name that is displayed in all finding generated by activity that involves IP addresses included in this ThreatIntelSet." - } - }, - "documentation" : "CreateThreatIntelSet request body.", - "required" : [ "DetectorId" ] - }, - "CreateThreatIntelSetResponse" : { - "type" : "structure", - "members" : { - "ThreatIntelSetId" : { - "shape" : "ThreatIntelSetId", - "locationName" : "threatIntelSetId" - } - } - }, - "CreatedAt" : { - "type" : "string", - "documentation" : "The first time a resource was created. The format will be ISO-8601." - }, - "DeclineInvitationsRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the AWS accounts that sent invitations to the current member account that you want to decline invitations from." - } - }, - "documentation" : "DeclineInvitations request body." - }, - "DeclineInvitationsResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "DeleteDetectorRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID that specifies the detector that you want to delete." - } - }, - "required" : [ "DetectorId" ] - }, - "DeleteDetectorResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteFilterRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID that specifies the detector where you want to delete a filter." - }, - "FilterName" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "filterName", - "documentation" : "The name of the filter." - } - }, - "required" : [ "DetectorId", "FilterName" ] - }, - "DeleteFilterResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteIPSetRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose IPSet you want to delete." - }, - "IpSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ipSetId", - "documentation" : "The unique ID that specifies the IPSet that you want to delete." - } - }, - "required" : [ "DetectorId", "IpSetId" ] - }, - "DeleteIPSetResponse" : { - "type" : "structure", - "members" : { } - }, - "DeleteInvitationsRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the AWS accounts that sent invitations to the current member account that you want to delete invitations from." - } - }, - "documentation" : "DeleteInvitations request body." - }, - "DeleteInvitationsResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "DeleteMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the GuardDuty member accounts that you want to delete." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account whose members you want to delete." - } - }, - "documentation" : "DeleteMembers request body.", - "required" : [ "DetectorId" ] - }, - "DeleteMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "DeleteThreatIntelSetRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose ThreatIntelSet you want to delete." - }, - "ThreatIntelSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "threatIntelSetId", - "documentation" : "The unique ID that specifies the ThreatIntelSet that you want to delete." - } - }, - "required" : [ "ThreatIntelSetId", "DetectorId" ] - }, - "DeleteThreatIntelSetResponse" : { - "type" : "structure", - "members" : { } - }, - "DetectorId" : { - "type" : "string", - "documentation" : "The unique identifier for a detector." - }, - "DetectorIds" : { - "type" : "list", - "documentation" : "A list of detector Ids.", - "member" : { - "shape" : "DetectorId" - } - }, - "DetectorStatus" : { - "type" : "string", - "documentation" : "The status of detector.", - "enum" : [ "ENABLED", "DISABLED" ] - }, - "DisassociateFromMasterAccountRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty member account." - } - }, - "required" : [ "DetectorId" ] - }, - "DisassociateFromMasterAccountResponse" : { - "type" : "structure", - "members" : { } - }, - "DisassociateMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the GuardDuty member accounts that you want to disassociate from master." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account whose members you want to disassociate from master." - } - }, - "documentation" : "DisassociateMembers request body.", - "required" : [ "DetectorId" ] - }, - "DisassociateMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "DnsRequestAction" : { - "type" : "structure", - "members" : { - "Domain" : { - "shape" : "Domain", - "locationName" : "domain", - "documentation" : "Domain information for the DNS request." - } - }, - "documentation" : "Information about the DNS_REQUEST action described in this finding." - }, - "Domain" : { - "type" : "string", - "documentation" : "A domain name." - }, - "DomainDetails" : { - "type" : "structure", - "members" : { }, - "documentation" : "Domain information for the AWS API call." - }, - "Email" : { - "type" : "string", - "documentation" : "Member account's email address." - }, - "Enable" : { - "type" : "boolean", - "documentation" : "A boolean value that specifies whether the detector is to be enabled." - }, - "Eq" : { - "type" : "list", - "documentation" : "Represents the equal condition to be applied to a single field when querying for findings.", - "member" : { - "shape" : "__string" - } - }, - "ErrorResponse" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The error message." - }, - "Type" : { - "shape" : "__string", - "locationName" : "__type", - "documentation" : "The error type." - } - }, - "documentation" : "Error response object." - }, - "Feedback" : { - "type" : "string", - "documentation" : "Finding Feedback Value", - "enum" : [ "USEFUL", "NOT_USEFUL" ] - }, - "FilterAction" : { - "type" : "string", - "documentation" : "The action associated with a filter.", - "enum" : [ "NOOP", "ARCHIVE" ] - }, - "FilterDescription" : { - "type" : "string", - "documentation" : "The filter description" - }, - "FilterName" : { - "type" : "string", - "documentation" : "The unique identifier for a filter" - }, - "FilterNames" : { - "type" : "list", - "documentation" : "A list of filter names", - "member" : { - "shape" : "FilterName" - } - }, - "FilterRank" : { - "type" : "integer", - "documentation" : "Relative position of filter among list of exisiting filters." - }, - "Finding" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "__string", - "locationName" : "accountId", - "documentation" : "AWS account ID where the activity occurred that prompted GuardDuty to generate a finding." - }, - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "The ARN of a finding described by the action." - }, - "Confidence" : { - "shape" : "__double", - "locationName" : "confidence", - "documentation" : "The confidence level of a finding." - }, - "CreatedAt" : { - "shape" : "CreatedAt", - "locationName" : "createdAt", - "documentation" : "The time stamp at which a finding was generated." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of a finding." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "The identifier that corresponds to a finding described by the action." - }, - "Partition" : { - "shape" : "__string", - "locationName" : "partition", - "documentation" : "The AWS resource partition." - }, - "Region" : { - "shape" : "__string", - "locationName" : "region", - "documentation" : "The AWS region where the activity occurred that prompted GuardDuty to generate a finding." - }, - "Resource" : { - "shape" : "Resource", - "locationName" : "resource", - "documentation" : "The AWS resource associated with the activity that prompted GuardDuty to generate a finding." - }, - "SchemaVersion" : { - "shape" : "__string", - "locationName" : "schemaVersion", - "documentation" : "Findings' schema version." - }, - "Service" : { - "shape" : "Service", - "locationName" : "service", - "documentation" : "Additional information assigned to the generated finding by GuardDuty." - }, - "Severity" : { - "shape" : "__double", - "locationName" : "severity", - "documentation" : "The severity of a finding." - }, - "Title" : { - "shape" : "__string", - "locationName" : "title", - "documentation" : "The title of a finding." - }, - "Type" : { - "shape" : "__string", - "locationName" : "type", - "documentation" : "The type of a finding described by the action." - }, - "UpdatedAt" : { - "shape" : "UpdatedAt", - "locationName" : "updatedAt", - "documentation" : "The time stamp at which a finding was last updated." - } - }, - "documentation" : "Representation of a abnormal or suspicious activity.", - "required" : [ "AccountId", "SchemaVersion", "CreatedAt", "Resource", "Severity", "UpdatedAt", "Type", "Region", "Id", "Arn" ] - }, - "FindingCriteria" : { - "type" : "structure", - "members" : { - "Criterion" : { - "shape" : "__mapOfCondition", - "locationName" : "criterion", - "documentation" : "Represents a map of finding properties that match specified conditions and values when querying findings." - } - }, - "documentation" : "Represents the criteria used for querying findings." - }, - "FindingId" : { - "type" : "string", - "documentation" : "The unique identifier for the Finding" - }, - "FindingIds" : { - "type" : "list", - "documentation" : "The list of the Findings.", - "member" : { - "shape" : "FindingId" - } - }, - "FindingStatisticType" : { - "type" : "string", - "documentation" : "The types of finding statistics.", - "enum" : [ "COUNT_BY_SEVERITY" ] - }, - "FindingStatisticTypes" : { - "type" : "list", - "documentation" : "The list of the finding statistics.", - "member" : { - "shape" : "FindingStatisticType" - } - }, - "FindingStatistics" : { - "type" : "structure", - "members" : { - "CountBySeverity" : { - "shape" : "__mapOfCountBySeverityFindingStatistic", - "locationName" : "countBySeverity", - "documentation" : "Represents a map of severity to count statistic for a set of findings" - } - }, - "documentation" : "Finding statistics object." - }, - "FindingType" : { - "type" : "string", - "documentation" : "The finding type for the finding" - }, - "FindingTypes" : { - "type" : "list", - "documentation" : "The list of the finding types.", - "member" : { - "shape" : "FindingType" - } - }, - "Findings" : { - "type" : "list", - "documentation" : "A list of findings.", - "member" : { - "shape" : "Finding" - } - }, - "GeoLocation" : { - "type" : "structure", - "members" : { - "Lat" : { - "shape" : "__double", - "locationName" : "lat", - "documentation" : "Latitude information of remote IP address." - }, - "Lon" : { - "shape" : "__double", - "locationName" : "lon", - "documentation" : "Longitude information of remote IP address." - } - }, - "documentation" : "Location information of the remote IP address." - }, - "GetDetectorRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to retrieve." - } - }, - "required" : [ "DetectorId" ] - }, - "GetDetectorResponse" : { - "type" : "structure", - "members" : { - "CreatedAt" : { - "shape" : "CreatedAt", - "locationName" : "createdAt" - }, - "ServiceRole" : { - "shape" : "ServiceRole", - "locationName" : "serviceRole" - }, - "Status" : { - "shape" : "DetectorStatus", - "locationName" : "status" - }, - "UpdatedAt" : { - "shape" : "UpdatedAt", - "locationName" : "updatedAt" - } - } - }, - "GetFilterRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detector ID that specifies the GuardDuty service where you want to list the details of the specified filter." - }, - "FilterName" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "filterName", - "documentation" : "The name of the filter whose details you want to get." - } - }, - "required" : [ "DetectorId", "FilterName" ] - }, - "GetFilterResponse" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "FilterAction", - "locationName" : "action", - "documentation" : "Specifies the action that is to be applied to the findings that match the filter." - }, - "Description" : { - "shape" : "FilterDescription", - "locationName" : "description", - "documentation" : "The description of the filter." - }, - "FindingCriteria" : { - "shape" : "FindingCriteria", - "locationName" : "findingCriteria", - "documentation" : "Represents the criteria to be used in the filter for querying findings." - }, - "Name" : { - "shape" : "FilterName", - "locationName" : "name", - "documentation" : "The name of the filter." - }, - "Rank" : { - "shape" : "FilterRank", - "locationName" : "rank", - "documentation" : "Specifies the position of the filter in the list of current filters. Also specifies the order in which this filter is applied to the findings." - } - } - }, - "GetFindingsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings you want to retrieve." - }, - "FindingIds" : { - "shape" : "FindingIds", - "locationName" : "findingIds", - "documentation" : "IDs of the findings that you want to retrieve." - }, - "SortCriteria" : { - "shape" : "SortCriteria", - "locationName" : "sortCriteria", - "documentation" : "Represents the criteria used for sorting findings." - } - }, - "documentation" : "GetFindings request body.", - "required" : [ "DetectorId" ] - }, - "GetFindingsResponse" : { - "type" : "structure", - "members" : { - "Findings" : { - "shape" : "Findings", - "locationName" : "findings" - } - } - }, - "GetFindingsStatisticsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings' statistics you want to retrieve." - }, - "FindingCriteria" : { - "shape" : "FindingCriteria", - "locationName" : "findingCriteria", - "documentation" : "Represents the criteria used for querying findings." - }, - "FindingStatisticTypes" : { - "shape" : "FindingStatisticTypes", - "locationName" : "findingStatisticTypes", - "documentation" : "Types of finding statistics to retrieve." - } - }, - "documentation" : "GetFindingsStatistics request body.", - "required" : [ "DetectorId" ] - }, - "GetFindingsStatisticsResponse" : { - "type" : "structure", - "members" : { - "FindingStatistics" : { - "shape" : "FindingStatistics", - "locationName" : "findingStatistics", - "documentation" : "Finding statistics object." - } - } - }, - "GetIPSetRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose IPSet you want to retrieve." - }, - "IpSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ipSetId", - "documentation" : "The unique ID that specifies the IPSet that you want to describe." - } - }, - "required" : [ "DetectorId", "IpSetId" ] - }, - "GetIPSetResponse" : { - "type" : "structure", - "members" : { - "Format" : { - "shape" : "IpSetFormat", - "locationName" : "format", - "documentation" : "The format of the file that contains the IPSet." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The URI of the file that contains the IPSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)" - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "The user friendly name to identify the IPSet. This name is displayed in all findings that are triggered by activity that involves IP addresses included in this IPSet." - }, - "Status" : { - "shape" : "IpSetStatus", - "locationName" : "status", - "documentation" : "The status of ipSet file uploaded." - } - } - }, - "GetInvitationsCountRequest" : { - "type" : "structure", - "members" : { } - }, - "GetInvitationsCountResponse" : { - "type" : "structure", - "members" : { - "InvitationsCount" : { - "shape" : "__integer", - "locationName" : "invitationsCount", - "documentation" : "The number of received invitations." - } - } - }, - "GetMasterAccountRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty member account." - } - }, - "required" : [ "DetectorId" ] - }, - "GetMasterAccountResponse" : { - "type" : "structure", - "members" : { - "Master" : { - "shape" : "Master", - "locationName" : "master" - } - } - }, - "GetMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the GuardDuty member accounts that you want to describe." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account whose members you want to retrieve." - } - }, - "documentation" : "GetMembers request body.", - "required" : [ "DetectorId" ] - }, - "GetMembersResponse" : { - "type" : "structure", - "members" : { - "Members" : { - "shape" : "Members", - "locationName" : "members" - }, - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "GetThreatIntelSetRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose ThreatIntelSet you want to describe." - }, - "ThreatIntelSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "threatIntelSetId", - "documentation" : "The unique ID that specifies the ThreatIntelSet that you want to describe." - } - }, - "required" : [ "ThreatIntelSetId", "DetectorId" ] - }, - "GetThreatIntelSetResponse" : { - "type" : "structure", - "members" : { - "Format" : { - "shape" : "ThreatIntelSetFormat", - "locationName" : "format", - "documentation" : "The format of the threatIntelSet." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The URI of the file that contains the ThreatIntelSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)." - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "A user-friendly ThreatIntelSet name that is displayed in all finding generated by activity that involves IP addresses included in this ThreatIntelSet." - }, - "Status" : { - "shape" : "ThreatIntelSetStatus", - "locationName" : "status", - "documentation" : "The status of threatIntelSet file uploaded." - } - } - }, - "IamInstanceProfile" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "AWS EC2 instance profile ARN." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "AWS EC2 instance profile ID." - } - }, - "documentation" : "The profile information of the EC2 instance." - }, - "InstanceDetails" : { - "type" : "structure", - "members" : { - "AvailabilityZone" : { - "shape" : "__string", - "locationName" : "availabilityZone", - "documentation" : "The availability zone of the EC2 instance." - }, - "IamInstanceProfile" : { - "shape" : "IamInstanceProfile", - "locationName" : "iamInstanceProfile" - }, - "ImageDescription" : { - "shape" : "__string", - "locationName" : "imageDescription", - "documentation" : "The image description of the EC2 instance." - }, - "ImageId" : { - "shape" : "__string", - "locationName" : "imageId", - "documentation" : "The image ID of the EC2 instance." - }, - "InstanceId" : { - "shape" : "__string", - "locationName" : "instanceId", - "documentation" : "The ID of the EC2 instance." - }, - "InstanceState" : { - "shape" : "__string", - "locationName" : "instanceState", - "documentation" : "The state of the EC2 instance." - }, - "InstanceType" : { - "shape" : "__string", - "locationName" : "instanceType", - "documentation" : "The type of the EC2 instance." - }, - "LaunchTime" : { - "shape" : "__string", - "locationName" : "launchTime", - "documentation" : "The launch time of the EC2 instance." - }, - "NetworkInterfaces" : { - "shape" : "NetworkInterfaces", - "locationName" : "networkInterfaces", - "documentation" : "The network interface information of the EC2 instance." - }, - "Platform" : { - "shape" : "__string", - "locationName" : "platform", - "documentation" : "The platform of the EC2 instance." - }, - "ProductCodes" : { - "shape" : "ProductCodes", - "locationName" : "productCodes", - "documentation" : "The product code of the EC2 instance." - }, - "Tags" : { - "shape" : "Tags", - "locationName" : "tags", - "documentation" : "The tags of the EC2 instance." - } - }, - "documentation" : "The information about the EC2 instance associated with the activity that prompted GuardDuty to generate a finding." - }, - "InternalServerErrorException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The error message." - }, - "Type" : { - "shape" : "__string", - "locationName" : "__type", - "documentation" : "The error type." - } - }, - "documentation" : "Error response object.", - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "Invitation" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "__string", - "locationName" : "accountId", - "documentation" : "Inviter account ID" - }, - "InvitationId" : { - "shape" : "InvitationId", - "locationName" : "invitationId", - "documentation" : "This value is used to validate the inviter account to the member account." - }, - "InvitedAt" : { - "shape" : "InvitedAt", - "locationName" : "invitedAt", - "documentation" : "Timestamp at which the invitation was sent" - }, - "RelationshipStatus" : { - "shape" : "__string", - "locationName" : "relationshipStatus", - "documentation" : "The status of the relationship between the inviter and invitee accounts." - } - }, - "documentation" : "Invitation from an AWS account to become the current account's master." - }, - "InvitationId" : { - "type" : "string", - "documentation" : "This value is used to validate the master account to the member account." - }, - "Invitations" : { - "type" : "list", - "documentation" : "A list of invitation descriptions.", - "member" : { - "shape" : "Invitation" - } - }, - "InviteMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the accounts that you want to invite to GuardDuty as members." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account with which you want to invite members." - }, - "DisableEmailNotification" : { - "shape" : "__boolean", - "locationName" : "disableEmailNotification", - "documentation" : "A boolean value that specifies whether you want to disable email notification to the accounts that you’re inviting to GuardDuty as members." - }, - "Message" : { - "shape" : "Message", - "locationName" : "message", - "documentation" : "The invitation message that you want to send to the accounts that you’re inviting to GuardDuty as members." - } - }, - "documentation" : "InviteMembers request body.", - "required" : [ "DetectorId" ] - }, - "InviteMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "InvitedAt" : { - "type" : "string", - "documentation" : "Timestamp at which a member has been invited. The format will be ISO-8601." - }, - "IpSetFormat" : { - "type" : "string", - "documentation" : "The format of the ipSet.", - "enum" : [ "TXT", "STIX", "OTX_CSV", "ALIEN_VAULT", "PROOF_POINT", "FIRE_EYE" ] - }, - "IpSetId" : { - "type" : "string", - "documentation" : "The unique identifier for an IP Set" - }, - "IpSetIds" : { - "type" : "list", - "documentation" : "A list of the IP set IDs", - "member" : { - "shape" : "IpSetId" - } - }, - "IpSetStatus" : { - "type" : "string", - "documentation" : "The status of ipSet file uploaded.", - "enum" : [ "INACTIVE", "ACTIVATING", "ACTIVE", "DEACTIVATING", "ERROR", "DELETE_PENDING", "DELETED" ] - }, - "Ipv6Address" : { - "type" : "string", - "documentation" : "IpV6 address of the EC2 instance." - }, - "Ipv6Addresses" : { - "type" : "list", - "documentation" : "A list of EC2 instance IPv6 address information.", - "member" : { - "shape" : "Ipv6Address" - } - }, - "ListDetectorsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of detectors that you want in the response." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListDetectors action. For subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data." - } - } - }, - "ListDetectorsResponse" : { - "type" : "structure", - "members" : { - "DetectorIds" : { - "shape" : "DetectorIds", - "locationName" : "detectorIds" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListFiltersRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service where you want to list filters." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "Indicates the maximum number of items that you want in the response. The maximum value is 50." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "Paginates results. Set the value of this parameter to NULL on your first call to the ListFilters operation.For subsequent calls to the operation, fill nextToken in the request with the value of nextToken from the previous response to continue listing data." - } - }, - "required" : [ "DetectorId" ] - }, - "ListFiltersResponse" : { - "type" : "structure", - "members" : { - "FilterNames" : { - "shape" : "FilterNames", - "locationName" : "filterNames" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListFindingsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings you want to list." - }, - "FindingCriteria" : { - "shape" : "FindingCriteria", - "locationName" : "findingCriteria", - "documentation" : "Represents the criteria used for querying findings." - }, - "MaxResults" : { - "shape" : "MaxResults", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of items you want in the response. The default value is 50. The maximum value is 50." - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListFindings action. For subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data." - }, - "SortCriteria" : { - "shape" : "SortCriteria", - "locationName" : "sortCriteria", - "documentation" : "Represents the criteria used for sorting findings." - } - }, - "documentation" : "ListFindings request body.", - "required" : [ "DetectorId" ] - }, - "ListFindingsResponse" : { - "type" : "structure", - "members" : { - "FindingIds" : { - "shape" : "FindingIds", - "locationName" : "findingIds" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListIPSetsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to retrieve." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 7. The maximum value is 7." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListIPSet action. For subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data." - } - }, - "required" : [ "DetectorId" ] - }, - "ListIPSetsResponse" : { - "type" : "structure", - "members" : { - "IpSetIds" : { - "shape" : "IpSetIds", - "locationName" : "ipSetIds" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListInvitationsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of invitations you want in the response. The default value is 50. The maximum value is 50." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListInvitations action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data." - } - } - }, - "ListInvitationsResponse" : { - "type" : "structure", - "members" : { - "Invitations" : { - "shape" : "Invitations", - "locationName" : "invitations" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListMembersRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account whose members you want to list." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of items you want in the response. The default value is 1. The maximum value is 50." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListMembers action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data." - }, - "OnlyAssociated" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "onlyAssociated", - "documentation" : "Specifies what member accounts the response is to include based on their relationship status with the master account. The default value is TRUE. If onlyAssociated is set to TRUE, the response will include member accounts whose relationship status with the master is set to Enabled, Disabled. If onlyAssociated is set to FALSE, the response will include all existing member accounts." - } - }, - "required" : [ "DetectorId" ] - }, - "ListMembersResponse" : { - "type" : "structure", - "members" : { - "Members" : { - "shape" : "Members", - "locationName" : "members" - }, - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - } - } - }, - "ListThreatIntelSetsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose ThreatIntelSets you want to list." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 7. The maximum value is 7." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "Pagination token to start retrieving threat intel sets from." - } - }, - "required" : [ "DetectorId" ] - }, - "ListThreatIntelSetsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "NextToken", - "locationName" : "nextToken" - }, - "ThreatIntelSetIds" : { - "shape" : "ThreatIntelSetIds", - "locationName" : "threatIntelSetIds" - } - } - }, - "LocalPortDetails" : { - "type" : "structure", - "members" : { - "Port" : { - "shape" : "__integer", - "locationName" : "port", - "documentation" : "Port number of the local connection." - }, - "PortName" : { - "shape" : "__string", - "locationName" : "portName", - "documentation" : "Port name of the local connection." - } - }, - "documentation" : "Local port information of the connection." - }, - "Location" : { - "type" : "string", - "documentation" : "The location of the S3 bucket where the list resides. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)" - }, - "Master" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "__string", - "locationName" : "accountId", - "documentation" : "Master account ID" - }, - "InvitationId" : { - "shape" : "InvitationId", - "locationName" : "invitationId", - "documentation" : "This value is used to validate the master account to the member account." - }, - "InvitedAt" : { - "shape" : "InvitedAt", - "locationName" : "invitedAt", - "documentation" : "Timestamp at which the invitation was sent" - }, - "RelationshipStatus" : { - "shape" : "__string", - "locationName" : "relationshipStatus", - "documentation" : "The status of the relationship between the master and member accounts." - } - }, - "documentation" : "Contains details about the master account." - }, - "MasterId" : { - "type" : "string", - "documentation" : "The master account ID." - }, - "MaxResults" : { - "type" : "integer", - "min" : 1, - "max" : 50 - }, - "Member" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "AccountId", - "locationName" : "accountId" - }, - "DetectorId" : { - "shape" : "DetectorId", - "locationName" : "detectorId" - }, - "Email" : { - "shape" : "Email", - "locationName" : "email", - "documentation" : "Member account's email address." - }, - "InvitedAt" : { - "shape" : "InvitedAt", - "locationName" : "invitedAt", - "documentation" : "Timestamp at which the invitation was sent" - }, - "MasterId" : { - "shape" : "MasterId", - "locationName" : "masterId" - }, - "RelationshipStatus" : { - "shape" : "__string", - "locationName" : "relationshipStatus", - "documentation" : "The status of the relationship between the member and the master." - }, - "UpdatedAt" : { - "shape" : "UpdatedAt", - "locationName" : "updatedAt" - } - }, - "documentation" : "Contains details about the member account.", - "required" : [ "Email", "AccountId", "MasterId", "UpdatedAt", "RelationshipStatus" ] - }, - "Members" : { - "type" : "list", - "documentation" : "A list of member descriptions.", - "member" : { - "shape" : "Member" - } - }, - "Message" : { - "type" : "string", - "documentation" : "The invitation message that you want to send to the accounts that you’re inviting to GuardDuty as members." - }, - "Name" : { - "type" : "string", - "documentation" : "The user-friendly name to identify the list." - }, - "Neq" : { - "type" : "list", - "documentation" : "Represents the not equal condition to be applied to a single field when querying for findings.", - "member" : { - "shape" : "__string" - } - }, - "NetworkConnectionAction" : { - "type" : "structure", - "members" : { - "Blocked" : { - "shape" : "__boolean", - "locationName" : "blocked", - "documentation" : "Network connection blocked information." - }, - "ConnectionDirection" : { - "shape" : "__string", - "locationName" : "connectionDirection", - "documentation" : "Network connection direction." - }, - "LocalPortDetails" : { - "shape" : "LocalPortDetails", - "locationName" : "localPortDetails", - "documentation" : "Local port information of the connection." - }, - "Protocol" : { - "shape" : "__string", - "locationName" : "protocol", - "documentation" : "Network connection protocol." - }, - "RemoteIpDetails" : { - "shape" : "RemoteIpDetails", - "locationName" : "remoteIpDetails", - "documentation" : "Remote IP information of the connection." - }, - "RemotePortDetails" : { - "shape" : "RemotePortDetails", - "locationName" : "remotePortDetails", - "documentation" : "Remote port information of the connection." - } - }, - "documentation" : "Information about the NETWORK_CONNECTION action described in this finding." - }, - "NetworkInterface" : { - "type" : "structure", - "members" : { - "Ipv6Addresses" : { - "shape" : "Ipv6Addresses", - "locationName" : "ipv6Addresses", - "documentation" : "A list of EC2 instance IPv6 address information." - }, - "NetworkInterfaceId" : { - "shape" : "NetworkInterfaceId", - "locationName" : "networkInterfaceId", - "documentation" : "The ID of the network interface" - }, - "PrivateDnsName" : { - "shape" : "PrivateDnsName", - "locationName" : "privateDnsName", - "documentation" : "Private DNS name of the EC2 instance." - }, - "PrivateIpAddress" : { - "shape" : "PrivateIpAddress", - "locationName" : "privateIpAddress", - "documentation" : "Private IP address of the EC2 instance." - }, - "PrivateIpAddresses" : { - "shape" : "PrivateIpAddresses", - "locationName" : "privateIpAddresses", - "documentation" : "Other private IP address information of the EC2 instance." - }, - "PublicDnsName" : { - "shape" : "__string", - "locationName" : "publicDnsName", - "documentation" : "Public DNS name of the EC2 instance." - }, - "PublicIp" : { - "shape" : "__string", - "locationName" : "publicIp", - "documentation" : "Public IP address of the EC2 instance." - }, - "SecurityGroups" : { - "shape" : "SecurityGroups", - "locationName" : "securityGroups", - "documentation" : "Security groups associated with the EC2 instance." - }, - "SubnetId" : { - "shape" : "__string", - "locationName" : "subnetId", - "documentation" : "The subnet ID of the EC2 instance." - }, - "VpcId" : { - "shape" : "__string", - "locationName" : "vpcId", - "documentation" : "The VPC ID of the EC2 instance." - } - }, - "documentation" : "The network interface information of the EC2 instance." - }, - "NetworkInterfaceId" : { - "type" : "string", - "documentation" : "The ID of the network interface." - }, - "NetworkInterfaces" : { - "type" : "list", - "documentation" : "The network interface information of the EC2 instance.", - "member" : { - "shape" : "NetworkInterface" - } - }, - "NextToken" : { - "type" : "string", - "documentation" : "You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the list action. For subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data." - }, - "OrderBy" : { - "type" : "string", - "enum" : [ "ASC", "DESC" ] - }, - "Organization" : { - "type" : "structure", - "members" : { - "Asn" : { - "shape" : "__string", - "locationName" : "asn", - "documentation" : "Autonomous system number of the internet provider of the remote IP address." - }, - "AsnOrg" : { - "shape" : "__string", - "locationName" : "asnOrg", - "documentation" : "Organization that registered this ASN." - }, - "Isp" : { - "shape" : "__string", - "locationName" : "isp", - "documentation" : "ISP information for the internet provider." - }, - "Org" : { - "shape" : "__string", - "locationName" : "org", - "documentation" : "Name of the internet provider." - } - }, - "documentation" : "ISP Organization information of the remote IP address." - }, - "PortProbeAction" : { - "type" : "structure", - "members" : { - "Blocked" : { - "shape" : "__boolean", - "locationName" : "blocked", - "documentation" : "Port probe blocked information." - }, - "PortProbeDetails" : { - "shape" : "__listOfPortProbeDetail", - "locationName" : "portProbeDetails", - "documentation" : "A list of port probe details objects." - } - }, - "documentation" : "Information about the PORT_PROBE action described in this finding." - }, - "PortProbeDetail" : { - "type" : "structure", - "members" : { - "LocalPortDetails" : { - "shape" : "LocalPortDetails", - "locationName" : "localPortDetails", - "documentation" : "Local port information of the connection." - }, - "RemoteIpDetails" : { - "shape" : "RemoteIpDetails", - "locationName" : "remoteIpDetails", - "documentation" : "Remote IP information of the connection." - } - }, - "documentation" : "Details about the port probe finding." - }, - "PrivateDnsName" : { - "type" : "string", - "documentation" : "Private DNS name of the EC2 instance." - }, - "PrivateIpAddress" : { - "type" : "string", - "documentation" : "Private IP address of the EC2 instance." - }, - "PrivateIpAddressDetails" : { - "type" : "structure", - "members" : { - "PrivateDnsName" : { - "shape" : "PrivateDnsName", - "locationName" : "privateDnsName", - "documentation" : "Private DNS name of the EC2 instance." - }, - "PrivateIpAddress" : { - "shape" : "PrivateIpAddress", - "locationName" : "privateIpAddress", - "documentation" : "Private IP address of the EC2 instance." - } - }, - "documentation" : "Other private IP address information of the EC2 instance." - }, - "PrivateIpAddresses" : { - "type" : "list", - "documentation" : "Other private IP address information of the EC2 instance.", - "member" : { - "shape" : "PrivateIpAddressDetails" - } - }, - "ProductCode" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "Product code information." - }, - "ProductType" : { - "shape" : "__string", - "locationName" : "productType", - "documentation" : "Product code type." - } - }, - "documentation" : "The product code of the EC2 instance." - }, - "ProductCodes" : { - "type" : "list", - "documentation" : "The product code of the EC2 instance.", - "member" : { - "shape" : "ProductCode" - } - }, - "RemoteIpDetails" : { - "type" : "structure", - "members" : { - "City" : { - "shape" : "City", - "locationName" : "city", - "documentation" : "City information of the remote IP address." - }, - "Country" : { - "shape" : "Country", - "locationName" : "country", - "documentation" : "Country code of the remote IP address." - }, - "GeoLocation" : { - "shape" : "GeoLocation", - "locationName" : "geoLocation", - "documentation" : "Location information of the remote IP address." - }, - "IpAddressV4" : { - "shape" : "__string", - "locationName" : "ipAddressV4", - "documentation" : "IPV4 remote address of the connection." - }, - "Organization" : { - "shape" : "Organization", - "locationName" : "organization", - "documentation" : "ISP Organization information of the remote IP address." - } - }, - "documentation" : "Remote IP information of the connection." - }, - "RemotePortDetails" : { - "type" : "structure", - "members" : { - "Port" : { - "shape" : "__integer", - "locationName" : "port", - "documentation" : "Port number of the remote connection." - }, - "PortName" : { - "shape" : "__string", - "locationName" : "portName", - "documentation" : "Port name of the remote connection." - } - }, - "documentation" : "Remote port information of the connection." - }, - "Resource" : { - "type" : "structure", - "members" : { - "AccessKeyDetails" : { - "shape" : "AccessKeyDetails", - "locationName" : "accessKeyDetails" - }, - "InstanceDetails" : { - "shape" : "InstanceDetails", - "locationName" : "instanceDetails" - }, - "ResourceType" : { - "shape" : "__string", - "locationName" : "resourceType", - "documentation" : "The type of the AWS resource." - } - }, - "documentation" : "The AWS resource associated with the activity that prompted GuardDuty to generate a finding." - }, - "SecurityGroup" : { - "type" : "structure", - "members" : { - "GroupId" : { - "shape" : "__string", - "locationName" : "groupId", - "documentation" : "EC2 instance's security group ID." - }, - "GroupName" : { - "shape" : "__string", - "locationName" : "groupName", - "documentation" : "EC2 instance's security group name." - } - }, - "documentation" : "Security groups associated with the EC2 instance." - }, - "SecurityGroups" : { - "type" : "list", - "documentation" : "Security groups associated with the EC2 instance.", - "member" : { - "shape" : "SecurityGroup" - } - }, - "Service" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "locationName" : "action", - "documentation" : "Information about the activity described in a finding." - }, - "Archived" : { - "shape" : "__boolean", - "locationName" : "archived", - "documentation" : "Indicates whether this finding is archived." - }, - "Count" : { - "shape" : "__integer", - "locationName" : "count", - "documentation" : "Total count of the occurrences of this finding type." - }, - "DetectorId" : { - "shape" : "DetectorId", - "locationName" : "detectorId", - "documentation" : "Detector ID for the GuardDuty service." - }, - "EventFirstSeen" : { - "shape" : "__string", - "locationName" : "eventFirstSeen", - "documentation" : "First seen timestamp of the activity that prompted GuardDuty to generate this finding." - }, - "EventLastSeen" : { - "shape" : "__string", - "locationName" : "eventLastSeen", - "documentation" : "Last seen timestamp of the activity that prompted GuardDuty to generate this finding." - }, - "ResourceRole" : { - "shape" : "__string", - "locationName" : "resourceRole", - "documentation" : "Resource role information for this finding." - }, - "ServiceName" : { - "shape" : "__string", - "locationName" : "serviceName", - "documentation" : "The name of the AWS service (GuardDuty) that generated a finding." - }, - "UserFeedback" : { - "shape" : "__string", - "locationName" : "userFeedback", - "documentation" : "Feedback left about the finding." - } - }, - "documentation" : "Additional information assigned to the generated finding by GuardDuty." - }, - "ServiceRole" : { - "type" : "string", - "documentation" : "Customer serviceRole name or ARN for accessing customer resources" - }, - "SortCriteria" : { - "type" : "structure", - "members" : { - "AttributeName" : { - "shape" : "__string", - "locationName" : "attributeName", - "documentation" : "Represents the finding attribute (for example, accountId) by which to sort findings." - }, - "OrderBy" : { - "shape" : "OrderBy", - "locationName" : "orderBy", - "documentation" : "Order by which the sorted findings are to be displayed." - } - }, - "documentation" : "Represents the criteria used for sorting findings." - }, - "StartMonitoringMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the GuardDuty member accounts whose findings you want the master account to monitor." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account whom you want to re-enable to monitor members' findings." - } - }, - "documentation" : "StartMonitoringMembers request body.", - "required" : [ "DetectorId" ] - }, - "StartMonitoringMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "StopMonitoringMembersRequest" : { - "type" : "structure", - "members" : { - "AccountIds" : { - "shape" : "AccountIds", - "locationName" : "accountIds", - "documentation" : "A list of account IDs of the GuardDuty member accounts whose findings you want the master account to stop monitoring." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector of the GuardDuty account that you want to stop from monitor members' findings." - } - }, - "documentation" : "StopMonitoringMembers request body.", - "required" : [ "DetectorId" ] - }, - "StopMonitoringMembersResponse" : { - "type" : "structure", - "members" : { - "UnprocessedAccounts" : { - "shape" : "UnprocessedAccounts", - "locationName" : "unprocessedAccounts", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed." - } - } - }, - "Tag" : { - "type" : "structure", - "members" : { - "Key" : { - "shape" : "__string", - "locationName" : "key", - "documentation" : "EC2 instance tag key." - }, - "Value" : { - "shape" : "__string", - "locationName" : "value", - "documentation" : "EC2 instance tag value." - } - }, - "documentation" : "A tag of the EC2 instance." - }, - "Tags" : { - "type" : "list", - "documentation" : "The tags of the EC2 instance.", - "member" : { - "shape" : "Tag" - } - }, - "ThreatIntelSetFormat" : { - "type" : "string", - "documentation" : "The format of the threatIntelSet.", - "enum" : [ "TXT", "STIX", "OTX_CSV", "ALIEN_VAULT", "PROOF_POINT", "FIRE_EYE" ] - }, - "ThreatIntelSetId" : { - "type" : "string", - "documentation" : "The unique identifier for an threat intel set" - }, - "ThreatIntelSetIds" : { - "type" : "list", - "documentation" : "The list of the threat intel set IDs", - "member" : { - "shape" : "ThreatIntelSetId" - } - }, - "ThreatIntelSetStatus" : { - "type" : "string", - "documentation" : "The status of threatIntelSet file uploaded.", - "enum" : [ "INACTIVE", "ACTIVATING", "ACTIVE", "DEACTIVATING", "ERROR", "DELETE_PENDING", "DELETED" ] - }, - "UnarchiveFindingsRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings you want to unarchive." - }, - "FindingIds" : { - "shape" : "FindingIds", - "locationName" : "findingIds", - "documentation" : "IDs of the findings that you want to unarchive." - } - }, - "documentation" : "UnarchiveFindings request body.", - "required" : [ "DetectorId" ] - }, - "UnarchiveFindingsResponse" : { - "type" : "structure", - "members" : { } - }, - "UnprocessedAccount" : { - "type" : "structure", - "members" : { - "AccountId" : { - "shape" : "__string", - "locationName" : "accountId", - "documentation" : "AWS Account ID." - }, - "Result" : { - "shape" : "__string", - "locationName" : "result", - "documentation" : "A reason why the account hasn't been processed." - } - }, - "documentation" : "An object containing the unprocessed account and a result string explaining why it was unprocessed.", - "required" : [ "AccountId", "Result" ] - }, - "UnprocessedAccounts" : { - "type" : "list", - "documentation" : "A list of objects containing the unprocessed account and a result string explaining why it was unprocessed.", - "member" : { - "shape" : "UnprocessedAccount" - } - }, - "UpdateDetectorRequest" : { - "type" : "structure", - "members" : { - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that you want to update." - }, - "Enable" : { - "shape" : "Enable", - "locationName" : "enable", - "documentation" : "Updated boolean value for the detector that specifies whether the detector is enabled." - } - }, - "documentation" : "UpdateDetector request body.", - "required" : [ "DetectorId" ] - }, - "UpdateDetectorResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateFilterRequest" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "FilterAction", - "locationName" : "action", - "documentation" : "Specifies the action that is to be applied to the findings that match the filter." - }, - "Description" : { - "shape" : "FilterDescription", - "locationName" : "description", - "documentation" : "The description of the filter." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The unique ID of the detector that specifies the GuardDuty service where you want to update a filter." - }, - "FilterName" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "filterName", - "documentation" : "The name of the filter." - }, - "FindingCriteria" : { - "shape" : "FindingCriteria", - "locationName" : "findingCriteria", - "documentation" : "Represents the criteria to be used in the filter for querying findings." - }, - "Rank" : { - "shape" : "FilterRank", - "locationName" : "rank", - "documentation" : "Specifies the position of the filter in the list of current filters. Also specifies the order in which this filter is applied to the findings." - } - }, - "documentation" : "UpdateFilterRequest request body.", - "required" : [ "DetectorId", "FilterName" ] - }, - "UpdateFilterResponse" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "FilterName", - "locationName" : "name", - "documentation" : "The name of the filter." - } - } - }, - "UpdateFindingsFeedbackRequest" : { - "type" : "structure", - "members" : { - "Comments" : { - "shape" : "Comments", - "locationName" : "comments", - "documentation" : "Additional feedback about the GuardDuty findings." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The ID of the detector that specifies the GuardDuty service whose findings you want to mark as useful or not useful." - }, - "Feedback" : { - "shape" : "Feedback", - "locationName" : "feedback", - "documentation" : "Valid values: USEFUL | NOT_USEFUL" - }, - "FindingIds" : { - "shape" : "FindingIds", - "locationName" : "findingIds", - "documentation" : "IDs of the findings that you want to mark as useful or not useful." - } - }, - "documentation" : "UpdateFindingsFeedback request body.", - "required" : [ "DetectorId" ] - }, - "UpdateFindingsFeedbackResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateIPSetRequest" : { - "type" : "structure", - "members" : { - "Activate" : { - "shape" : "Activate", - "locationName" : "activate", - "documentation" : "The updated boolean value that specifies whether the IPSet is active or not." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose IPSet you want to update." - }, - "IpSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "ipSetId", - "documentation" : "The unique ID that specifies the IPSet that you want to update." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The updated URI of the file that contains the IPSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)." - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "The unique ID that specifies the IPSet that you want to update." - } - }, - "documentation" : "UpdateIPSet request body.", - "required" : [ "DetectorId", "IpSetId" ] - }, - "UpdateIPSetResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdateThreatIntelSetRequest" : { - "type" : "structure", - "members" : { - "Activate" : { - "shape" : "Activate", - "locationName" : "activate", - "documentation" : "The updated boolean value that specifies whether the ThreateIntelSet is active or not." - }, - "DetectorId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "detectorId", - "documentation" : "The detectorID that specifies the GuardDuty service whose ThreatIntelSet you want to update." - }, - "Location" : { - "shape" : "Location", - "locationName" : "location", - "documentation" : "The updated URI of the file that contains the ThreateIntelSet. For example (https://s3.us-west-2.amazonaws.com/my-bucket/my-object-key)" - }, - "Name" : { - "shape" : "Name", - "locationName" : "name", - "documentation" : "The unique ID that specifies the ThreatIntelSet that you want to update." - }, - "ThreatIntelSetId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "threatIntelSetId", - "documentation" : "The unique ID that specifies the ThreatIntelSet that you want to update." - } - }, - "documentation" : "UpdateThreatIntelSet request body.", - "required" : [ "ThreatIntelSetId", "DetectorId" ] - }, - "UpdateThreatIntelSetResponse" : { - "type" : "structure", - "members" : { } - }, - "UpdatedAt" : { - "type" : "string", - "documentation" : "The first time a resource was created. The format will be ISO-8601." - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__listOfPortProbeDetail" : { - "type" : "list", - "member" : { - "shape" : "PortProbeDetail" - } - }, - "__long" : { - "type" : "long" - }, - "__mapOfCondition" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "Condition" - } - }, - "__mapOfCountBySeverityFindingStatistic" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "CountBySeverityFindingStatistic" - } - }, - "__string" : { - "type" : "string" - }, - "__stringMin0Max64" : { - "type" : "string", - "min" : 0, - "max" : 64 - }, - "__timestamp" : { - "type" : "timestamp" - } - }, - "documentation" : "Assess, monitor, manage, and remediate security issues across your AWS infrastructure, applications, and data." -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/paginators-1.json deleted file mode 100644 index dcf401ad..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "DescribeAffectedEntities": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "entities" - }, - "DescribeEventAggregates": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "eventAggregates" - }, - "DescribeEvents": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "events" - }, - "DescribeEventTypes": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "eventTypes" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/service-2.json deleted file mode 100644 index 7a3b3ca9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/health/2016-08-04/service-2.json +++ /dev/null @@ -1,824 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-08-04", - "endpointPrefix":"health", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWSHealth", - "serviceFullName":"AWS Health APIs and Notifications", - "serviceId":"Health", - "signatureVersion":"v4", - "targetPrefix":"AWSHealth_20160804", - "uid":"health-2016-08-04" - }, - "operations":{ - "DescribeAffectedEntities":{ - "name":"DescribeAffectedEntities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAffectedEntitiesRequest"}, - "output":{"shape":"DescribeAffectedEntitiesResponse"}, - "errors":[ - {"shape":"InvalidPaginationToken"}, - {"shape":"UnsupportedLocale"} - ], - "documentation":"

Returns a list of entities that have been affected by the specified events, based on the specified filter criteria. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service. Events that have impact beyond that of the affected entities, or where the extent of impact is unknown, include at least one entity indicating this.

At least one event ARN is required. Results are sorted by the lastUpdatedTime of the entity, starting with the most recent.

", - "idempotent":true - }, - "DescribeEntityAggregates":{ - "name":"DescribeEntityAggregates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEntityAggregatesRequest"}, - "output":{"shape":"DescribeEntityAggregatesResponse"}, - "documentation":"

Returns the number of entities that are affected by each of the specified events. If no events are specified, the counts of all affected entities are returned.

", - "idempotent":true - }, - "DescribeEventAggregates":{ - "name":"DescribeEventAggregates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventAggregatesRequest"}, - "output":{"shape":"DescribeEventAggregatesResponse"}, - "errors":[ - {"shape":"InvalidPaginationToken"} - ], - "documentation":"

Returns the number of events of each event type (issue, scheduled change, and account notification). If no filter is specified, the counts of all events in each category are returned.

", - "idempotent":true - }, - "DescribeEventDetails":{ - "name":"DescribeEventDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventDetailsRequest"}, - "output":{"shape":"DescribeEventDetailsResponse"}, - "errors":[ - {"shape":"UnsupportedLocale"} - ], - "documentation":"

Returns detailed information about one or more specified events. Information includes standard event data (region, service, etc., as returned by DescribeEvents), a detailed event description, and possible additional metadata that depends upon the nature of the event. Affected entities are not included; to retrieve those, use the DescribeAffectedEntities operation.

If a specified event cannot be retrieved, an error message is returned for that event.

", - "idempotent":true - }, - "DescribeEventTypes":{ - "name":"DescribeEventTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventTypesRequest"}, - "output":{"shape":"DescribeEventTypesResponse"}, - "errors":[ - {"shape":"InvalidPaginationToken"}, - {"shape":"UnsupportedLocale"} - ], - "documentation":"

Returns the event types that meet the specified filter criteria. If no filter criteria are specified, all event types are returned, in no particular order.

", - "idempotent":true - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsRequest"}, - "output":{"shape":"DescribeEventsResponse"}, - "errors":[ - {"shape":"InvalidPaginationToken"}, - {"shape":"UnsupportedLocale"} - ], - "documentation":"

Returns information about events that meet the specified filter criteria. Events are returned in a summary form and do not include the detailed description, any additional metadata that depends on the event type, or any affected resources. To retrieve that information, use the DescribeEventDetails and DescribeAffectedEntities operations.

If no filter criteria are specified, all events are returned. Results are sorted by lastModifiedTime, starting with the most recent.

", - "idempotent":true - } - }, - "shapes":{ - "AffectedEntity":{ - "type":"structure", - "members":{ - "entityArn":{ - "shape":"entityArn", - "documentation":"

The unique identifier for the entity. Format: arn:aws:health:entity-region:aws-account:entity/entity-id . Example: arn:aws:health:us-east-1:111222333444:entity/AVh5GGT7ul1arKr1sE1K

" - }, - "eventArn":{ - "shape":"eventArn", - "documentation":"

The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456

" - }, - "entityValue":{ - "shape":"entityValue", - "documentation":"

The ID of the affected entity.

" - }, - "awsAccountId":{ - "shape":"accountId", - "documentation":"

The 12-digit AWS account number that contains the affected entity.

" - }, - "lastUpdatedTime":{ - "shape":"timestamp", - "documentation":"

The most recent time that the entity was updated.

" - }, - "statusCode":{ - "shape":"entityStatusCode", - "documentation":"

The most recent status of the entity affected by the event. The possible values are IMPAIRED, UNIMPAIRED, and UNKNOWN.

" - }, - "tags":{ - "shape":"tagSet", - "documentation":"

A map of entity tags attached to the affected entity.

" - } - }, - "documentation":"

Information about an entity that is affected by a Health event.

" - }, - "DateTimeRange":{ - "type":"structure", - "members":{ - "from":{ - "shape":"timestamp", - "documentation":"

The starting date and time of a time range.

" - }, - "to":{ - "shape":"timestamp", - "documentation":"

The ending date and time of a time range.

" - } - }, - "documentation":"

A range of dates and times that is used by the EventFilter and EntityFilter objects. If from is set and to is set: match items where the timestamp (startTime, endTime, or lastUpdatedTime) is between from and to inclusive. If from is set and to is not set: match items where the timestamp value is equal to or after from. If from is not set and to is set: match items where the timestamp value is equal to or before to.

" - }, - "DescribeAffectedEntitiesRequest":{ - "type":"structure", - "required":["filter"], - "members":{ - "filter":{ - "shape":"EntityFilter", - "documentation":"

Values to narrow the results returned. At least one event ARN is required.

" - }, - "locale":{ - "shape":"locale", - "documentation":"

The locale (language) to return information in. English (en) is the default and the only supported value at this time.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - }, - "maxResults":{ - "shape":"maxResults", - "documentation":"

The maximum number of items to return in one batch, between 10 and 100, inclusive.

" - } - } - }, - "DescribeAffectedEntitiesResponse":{ - "type":"structure", - "members":{ - "entities":{ - "shape":"EntityList", - "documentation":"

The entities that match the filter criteria.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - } - } - }, - "DescribeEntityAggregatesRequest":{ - "type":"structure", - "members":{ - "eventArns":{ - "shape":"EventArnsList", - "documentation":"

A list of event ARNs (unique identifiers). For example: \"arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456\", \"arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101\"

" - } - } - }, - "DescribeEntityAggregatesResponse":{ - "type":"structure", - "members":{ - "entityAggregates":{ - "shape":"EntityAggregateList", - "documentation":"

The number of entities that are affected by each of the specified events.

" - } - } - }, - "DescribeEventAggregatesRequest":{ - "type":"structure", - "required":["aggregateField"], - "members":{ - "filter":{ - "shape":"EventFilter", - "documentation":"

Values to narrow the results returned.

" - }, - "aggregateField":{ - "shape":"eventAggregateField", - "documentation":"

The only currently supported value is eventTypeCategory.

" - }, - "maxResults":{ - "shape":"maxResults", - "documentation":"

The maximum number of items to return in one batch, between 10 and 100, inclusive.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - } - } - }, - "DescribeEventAggregatesResponse":{ - "type":"structure", - "members":{ - "eventAggregates":{ - "shape":"EventAggregateList", - "documentation":"

The number of events in each category that meet the optional filter criteria.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - } - } - }, - "DescribeEventDetailsFailedSet":{ - "type":"list", - "member":{"shape":"EventDetailsErrorItem"} - }, - "DescribeEventDetailsRequest":{ - "type":"structure", - "required":["eventArns"], - "members":{ - "eventArns":{ - "shape":"eventArnList", - "documentation":"

A list of event ARNs (unique identifiers). For example: \"arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456\", \"arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101\"

" - }, - "locale":{ - "shape":"locale", - "documentation":"

The locale (language) to return information in. English (en) is the default and the only supported value at this time.

" - } - } - }, - "DescribeEventDetailsResponse":{ - "type":"structure", - "members":{ - "successfulSet":{ - "shape":"DescribeEventDetailsSuccessfulSet", - "documentation":"

Information about the events that could be retrieved.

" - }, - "failedSet":{ - "shape":"DescribeEventDetailsFailedSet", - "documentation":"

Error messages for any events that could not be retrieved.

" - } - } - }, - "DescribeEventDetailsSuccessfulSet":{ - "type":"list", - "member":{"shape":"EventDetails"} - }, - "DescribeEventTypesRequest":{ - "type":"structure", - "members":{ - "filter":{ - "shape":"EventTypeFilter", - "documentation":"

Values to narrow the results returned.

" - }, - "locale":{ - "shape":"locale", - "documentation":"

The locale (language) to return information in. English (en) is the default and the only supported value at this time.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - }, - "maxResults":{ - "shape":"maxResults", - "documentation":"

The maximum number of items to return in one batch, between 10 and 100, inclusive.

" - } - } - }, - "DescribeEventTypesResponse":{ - "type":"structure", - "members":{ - "eventTypes":{ - "shape":"EventTypeList", - "documentation":"

A list of event types that match the filter criteria. Event types have a category (issue, accountNotification, or scheduledChange), a service (for example, EC2, RDS, DATAPIPELINE, BILLING), and a code (in the format AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT).

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - } - } - }, - "DescribeEventsRequest":{ - "type":"structure", - "members":{ - "filter":{ - "shape":"EventFilter", - "documentation":"

Values to narrow the results returned.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - }, - "maxResults":{ - "shape":"maxResults", - "documentation":"

The maximum number of items to return in one batch, between 10 and 100, inclusive.

" - }, - "locale":{ - "shape":"locale", - "documentation":"

The locale (language) to return information in. English (en) is the default and the only supported value at this time.

" - } - } - }, - "DescribeEventsResponse":{ - "type":"structure", - "members":{ - "events":{ - "shape":"EventList", - "documentation":"

The events that match the specified filter criteria.

" - }, - "nextToken":{ - "shape":"nextToken", - "documentation":"

If the results of a search are large, only a portion of the results are returned, and a nextToken pagination token is returned in the response. To retrieve the next batch of results, reissue the search request and include the returned token. When all results have been returned, the response does not contain a pagination token value.

" - } - } - }, - "EntityAggregate":{ - "type":"structure", - "members":{ - "eventArn":{ - "shape":"eventArn", - "documentation":"

The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456

" - }, - "count":{ - "shape":"count", - "documentation":"

The number entities that match the criteria for the specified events.

" - } - }, - "documentation":"

The number of entities that are affected by one or more events. Returned by the DescribeEntityAggregates operation.

" - }, - "EntityAggregateList":{ - "type":"list", - "member":{"shape":"EntityAggregate"} - }, - "EntityFilter":{ - "type":"structure", - "required":["eventArns"], - "members":{ - "eventArns":{ - "shape":"eventArnList", - "documentation":"

A list of event ARNs (unique identifiers). For example: \"arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456\", \"arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101\"

" - }, - "entityArns":{ - "shape":"entityArnList", - "documentation":"

A list of entity ARNs (unique identifiers).

" - }, - "entityValues":{ - "shape":"entityValueList", - "documentation":"

A list of IDs for affected entities.

" - }, - "lastUpdatedTimes":{ - "shape":"dateTimeRangeList", - "documentation":"

A list of the most recent dates and times that the entity was updated.

" - }, - "tags":{ - "shape":"tagFilter", - "documentation":"

A map of entity tags attached to the affected entity.

" - }, - "statusCodes":{ - "shape":"entityStatusCodeList", - "documentation":"

A list of entity status codes (IMPAIRED, UNIMPAIRED, or UNKNOWN).

" - } - }, - "documentation":"

The values to use to filter results from the DescribeAffectedEntities operation.

" - }, - "EntityList":{ - "type":"list", - "member":{"shape":"AffectedEntity"} - }, - "Event":{ - "type":"structure", - "members":{ - "arn":{ - "shape":"eventArn", - "documentation":"

The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456

" - }, - "service":{ - "shape":"service", - "documentation":"

The AWS service that is affected by the event. For example, EC2, RDS.

" - }, - "eventTypeCode":{ - "shape":"eventTypeCode", - "documentation":"

The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.

" - }, - "eventTypeCategory":{ - "shape":"eventTypeCategory", - "documentation":"

The category of the event. Possible values are issue, scheduledChange, and accountNotification.

" - }, - "region":{ - "shape":"region", - "documentation":"

The AWS region name of the event.

" - }, - "availabilityZone":{ - "shape":"availabilityZone", - "documentation":"

The AWS Availability Zone of the event. For example, us-east-1a.

" - }, - "startTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the event began.

" - }, - "endTime":{ - "shape":"timestamp", - "documentation":"

The date and time that the event ended.

" - }, - "lastUpdatedTime":{ - "shape":"timestamp", - "documentation":"

The most recent date and time that the event was updated.

" - }, - "statusCode":{ - "shape":"eventStatusCode", - "documentation":"

The most recent status of the event. Possible values are open, closed, and upcoming.

" - } - }, - "documentation":"

Summary information about an event, returned by the DescribeEvents operation. The DescribeEventDetails operation also returns this information, as well as the EventDescription and additional event metadata.

" - }, - "EventAggregate":{ - "type":"structure", - "members":{ - "aggregateValue":{ - "shape":"aggregateValue", - "documentation":"

The issue type for the associated count.

" - }, - "count":{ - "shape":"count", - "documentation":"

The number of events of the associated issue type.

" - } - }, - "documentation":"

The number of events of each issue type. Returned by the DescribeEventAggregates operation.

" - }, - "EventAggregateList":{ - "type":"list", - "member":{"shape":"EventAggregate"} - }, - "EventArnsList":{ - "type":"list", - "member":{"shape":"eventArn"}, - "max":50, - "min":1 - }, - "EventDescription":{ - "type":"structure", - "members":{ - "latestDescription":{ - "shape":"eventDescription", - "documentation":"

The most recent description of the event.

" - } - }, - "documentation":"

The detailed description of the event. Included in the information returned by the DescribeEventDetails operation.

" - }, - "EventDetails":{ - "type":"structure", - "members":{ - "event":{ - "shape":"Event", - "documentation":"

Summary information about the event.

" - }, - "eventDescription":{ - "shape":"EventDescription", - "documentation":"

The most recent description of the event.

" - }, - "eventMetadata":{ - "shape":"eventMetadata", - "documentation":"

Additional metadata about the event.

" - } - }, - "documentation":"

Detailed information about an event. A combination of an Event object, an EventDescription object, and additional metadata about the event. Returned by the DescribeEventDetails operation.

" - }, - "EventDetailsErrorItem":{ - "type":"structure", - "members":{ - "eventArn":{ - "shape":"eventArn", - "documentation":"

The unique identifier for the event. Format: arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID . Example: Example: arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-DEF456

" - }, - "errorName":{ - "shape":"string", - "documentation":"

The name of the error.

" - }, - "errorMessage":{ - "shape":"string", - "documentation":"

A message that describes the error.

" - } - }, - "documentation":"

Error information returned when a DescribeEventDetails operation cannot find a specified event.

" - }, - "EventFilter":{ - "type":"structure", - "members":{ - "eventArns":{ - "shape":"eventArnList", - "documentation":"

A list of event ARNs (unique identifiers). For example: \"arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456\", \"arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101\"

" - }, - "eventTypeCodes":{ - "shape":"eventTypeList", - "documentation":"

A list of unique identifiers for event types. For example, \"AWS_EC2_SYSTEM_MAINTENANCE_EVENT\",\"AWS_RDS_MAINTENANCE_SCHEDULED\"

" - }, - "services":{ - "shape":"serviceList", - "documentation":"

The AWS services associated with the event. For example, EC2, RDS.

" - }, - "regions":{ - "shape":"regionList", - "documentation":"

A list of AWS regions.

" - }, - "availabilityZones":{ - "shape":"availabilityZones", - "documentation":"

A list of AWS availability zones.

" - }, - "startTimes":{ - "shape":"dateTimeRangeList", - "documentation":"

A list of dates and times that the event began.

" - }, - "endTimes":{ - "shape":"dateTimeRangeList", - "documentation":"

A list of dates and times that the event ended.

" - }, - "lastUpdatedTimes":{ - "shape":"dateTimeRangeList", - "documentation":"

A list of dates and times that the event was last updated.

" - }, - "entityArns":{ - "shape":"entityArnList", - "documentation":"

A list of entity ARNs (unique identifiers).

" - }, - "entityValues":{ - "shape":"entityValueList", - "documentation":"

A list of entity identifiers, such as EC2 instance IDs (i-34ab692e) or EBS volumes (vol-426ab23e).

" - }, - "eventTypeCategories":{ - "shape":"eventTypeCategoryList", - "documentation":"

A list of event type category codes (issue, scheduledChange, or accountNotification).

" - }, - "tags":{ - "shape":"tagFilter", - "documentation":"

A map of entity tags attached to the affected entity.

" - }, - "eventStatusCodes":{ - "shape":"eventStatusCodeList", - "documentation":"

A list of event status codes.

" - } - }, - "documentation":"

The values to use to filter results from the DescribeEvents and DescribeEventAggregates operations.

" - }, - "EventList":{ - "type":"list", - "member":{"shape":"Event"} - }, - "EventType":{ - "type":"structure", - "members":{ - "service":{ - "shape":"service", - "documentation":"

The AWS service that is affected by the event. For example, EC2, RDS.

" - }, - "code":{ - "shape":"eventTypeCode", - "documentation":"

The unique identifier for the event type. The format is AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT.

" - }, - "category":{ - "shape":"eventTypeCategory", - "documentation":"

A list of event type category codes (issue, scheduledChange, or accountNotification).

" - } - }, - "documentation":"

Metadata about a type of event that is reported by AWS Health. Data consists of the category (for example, issue), the service (for example, EC2), and the event type code (for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT).

" - }, - "EventTypeCategoryList":{ - "type":"list", - "member":{"shape":"eventTypeCategory"}, - "max":10, - "min":1 - }, - "EventTypeCodeList":{ - "type":"list", - "member":{"shape":"eventTypeCode"}, - "max":10, - "min":1 - }, - "EventTypeFilter":{ - "type":"structure", - "members":{ - "eventTypeCodes":{ - "shape":"EventTypeCodeList", - "documentation":"

A list of event type codes.

" - }, - "services":{ - "shape":"serviceList", - "documentation":"

The AWS services associated with the event. For example, EC2, RDS.

" - }, - "eventTypeCategories":{ - "shape":"EventTypeCategoryList", - "documentation":"

A list of event type category codes (issue, scheduledChange, or accountNotification).

" - } - }, - "documentation":"

The values to use to filter results from the DescribeEventTypes operation.

" - }, - "EventTypeList":{ - "type":"list", - "member":{"shape":"EventType"} - }, - "InvalidPaginationToken":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

The specified pagination token (nextToken) is not valid.

", - "exception":true - }, - "UnsupportedLocale":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

The specified locale is not supported.

", - "exception":true - }, - "accountId":{ - "type":"string", - "pattern":"[0-9]{12}" - }, - "aggregateValue":{"type":"string"}, - "availabilityZone":{ - "type":"string", - "pattern":"[a-z]{2}\\-[0-9a-z\\-]{4,16}" - }, - "availabilityZones":{ - "type":"list", - "member":{"shape":"availabilityZone"} - }, - "count":{"type":"integer"}, - "dateTimeRangeList":{ - "type":"list", - "member":{"shape":"DateTimeRange"}, - "max":10, - "min":1 - }, - "entityArn":{ - "type":"string", - "max":1600 - }, - "entityArnList":{ - "type":"list", - "member":{"shape":"entityArn"}, - "max":100, - "min":1 - }, - "entityStatusCode":{ - "type":"string", - "enum":[ - "IMPAIRED", - "UNIMPAIRED", - "UNKNOWN" - ] - }, - "entityStatusCodeList":{ - "type":"list", - "member":{"shape":"entityStatusCode"}, - "max":3, - "min":1 - }, - "entityValue":{ - "type":"string", - "max":256 - }, - "entityValueList":{ - "type":"list", - "member":{"shape":"entityValue"}, - "max":100, - "min":1 - }, - "eventAggregateField":{ - "type":"string", - "enum":["eventTypeCategory"] - }, - "eventArn":{ - "type":"string", - "max":1600, - "pattern":"arn:aws:health:[^:]*:[^:]*:event(?:/[\\w-]+){1}((?:/[\\w-]+){2})?" - }, - "eventArnList":{ - "type":"list", - "member":{"shape":"eventArn"}, - "max":10, - "min":1 - }, - "eventDescription":{"type":"string"}, - "eventMetadata":{ - "type":"map", - "key":{"shape":"metadataKey"}, - "value":{"shape":"metadataValue"} - }, - "eventStatusCode":{ - "type":"string", - "enum":[ - "open", - "closed", - "upcoming" - ] - }, - "eventStatusCodeList":{ - "type":"list", - "member":{"shape":"eventStatusCode"}, - "max":6, - "min":1 - }, - "eventType":{ - "type":"string", - "max":100, - "min":3 - }, - "eventTypeCategory":{ - "type":"string", - "enum":[ - "issue", - "accountNotification", - "scheduledChange" - ], - "max":255, - "min":3 - }, - "eventTypeCategoryList":{ - "type":"list", - "member":{"shape":"eventTypeCategory"}, - "max":10, - "min":1 - }, - "eventTypeCode":{ - "type":"string", - "max":100, - "min":3 - }, - "eventTypeList":{ - "type":"list", - "member":{"shape":"eventType"}, - "max":10, - "min":1 - }, - "locale":{ - "type":"string", - "max":256, - "min":2 - }, - "maxResults":{ - "type":"integer", - "max":100, - "min":10 - }, - "metadataKey":{"type":"string"}, - "metadataValue":{ - "type":"string", - "max":10240 - }, - "nextToken":{ - "type":"string", - "pattern":"[a-zA-Z0-9=/+_.-]{4,512}" - }, - "region":{ - "type":"string", - "pattern":"[^:/]{2,25}" - }, - "regionList":{ - "type":"list", - "member":{"shape":"region"}, - "max":10, - "min":1 - }, - "service":{ - "type":"string", - "max":30, - "min":2 - }, - "serviceList":{ - "type":"list", - "member":{"shape":"service"}, - "max":10, - "min":1 - }, - "string":{"type":"string"}, - "tagFilter":{ - "type":"list", - "member":{"shape":"tagSet"}, - "max":50 - }, - "tagKey":{ - "type":"string", - "max":127 - }, - "tagSet":{ - "type":"map", - "key":{"shape":"tagKey"}, - "value":{"shape":"tagValue"}, - "max":50 - }, - "tagValue":{ - "type":"string", - "max":255 - }, - "timestamp":{"type":"timestamp"} - }, - "documentation":"AWS Health

The AWS Health API provides programmatic access to the AWS Health information that is presented in the AWS Personal Health Dashboard. You can get information about events that affect your AWS resources:

In addition, these operations provide information about event types and summary counts of events or affected entities:

The Health API requires a Business or Enterprise support plan from AWS Support. Calling the Health API from an account that does not have a Business or Enterprise support plan causes a SubscriptionRequiredException.

For authentication of requests, AWS Health uses the Signature Version 4 Signing Process.

See the AWS Health User Guide for information about how to use the API.

Service Endpoint

The HTTP endpoint for the AWS Health API is:

  • https://health.us-east-1.amazonaws.com

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/examples-1.json deleted file mode 100644 index f23d8ebf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/examples-1.json +++ /dev/null @@ -1,1191 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddClientIDToOpenIDConnectProvider": [ - { - "input": { - "ClientID": "my-application-ID", - "OpenIDConnectProviderArn": "arn:aws:iam::123456789012:oidc-provider/server.example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following add-client-id-to-open-id-connect-provider command adds the client ID my-application-ID to the OIDC provider named server.example.com:", - "id": "028e91f4-e2a6-4d59-9e3b-4965a3fb19be", - "title": "To add a client ID (audience) to an Open-ID Connect (OIDC) provider" - } - ], - "AddRoleToInstanceProfile": [ - { - "input": { - "InstanceProfileName": "Webserver", - "RoleName": "S3Access" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command adds the role named S3Access to the instance profile named Webserver:", - "id": "c107fac3-edb6-4827-8a71-8863ec91c81f", - "title": "To add a role to an instance profile" - } - ], - "AddUserToGroup": [ - { - "input": { - "GroupName": "Admins", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command adds an IAM user named Bob to the IAM group named Admins:", - "id": "619c7e6b-09f8-4036-857b-51a6ea5027ca", - "title": "To add a user to an IAM group" - } - ], - "AttachGroupPolicy": [ - { - "input": { - "GroupName": "Finance", - "PolicyArn": "arn:aws:iam::aws:policy/ReadOnlyAccess" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command attaches the AWS managed policy named ReadOnlyAccess to the IAM group named Finance.", - "id": "87551489-86f0-45db-9889-759936778f2b", - "title": "To attach a managed policy to an IAM group" - } - ], - "AttachRolePolicy": [ - { - "input": { - "PolicyArn": "arn:aws:iam::aws:policy/ReadOnlyAccess", - "RoleName": "ReadOnlyRole" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command attaches the AWS managed policy named ReadOnlyAccess to the IAM role named ReadOnlyRole.", - "id": "3e1b8c7c-99c8-4fc4-a20c-131fe3f22c7e", - "title": "To attach a managed policy to an IAM role" - } - ], - "AttachUserPolicy": [ - { - "input": { - "PolicyArn": "arn:aws:iam::aws:policy/AdministratorAccess", - "UserName": "Alice" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command attaches the AWS managed policy named AdministratorAccess to the IAM user named Alice.", - "id": "1372ebd8-9475-4b1a-a479-23b6fd4b8b3e", - "title": "To attach a managed policy to an IAM user" - } - ], - "ChangePassword": [ - { - "input": { - "NewPassword": "]35d/{pB9Fo9wJ", - "OldPassword": "3s0K_;xh4~8XXI" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command changes the password for the current IAM user.", - "id": "3a80c66f-bffb-46df-947c-1e8fa583b470", - "title": "To change the password for your IAM user" - } - ], - "CreateAccessKey": [ - { - "input": { - "UserName": "Bob" - }, - "output": { - "AccessKey": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "CreateDate": "2015-03-09T18:39:23.411Z", - "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", - "Status": "Active", - "UserName": "Bob" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command creates an access key (access key ID and secret access key) for the IAM user named Bob.", - "id": "1fbb3211-4cf2-41db-8c20-ba58d9f5802d", - "title": "To create an access key for an IAM user" - } - ], - "CreateAccountAlias": [ - { - "input": { - "AccountAlias": "examplecorp" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command associates the alias examplecorp to your AWS account.", - "id": "5adaf6fb-94fc-4ca2-b825-2fbc2062add1", - "title": "To create an account alias" - } - ], - "CreateGroup": [ - { - "input": { - "GroupName": "Admins" - }, - "output": { - "Group": { - "Arn": "arn:aws:iam::123456789012:group/Admins", - "CreateDate": "2015-03-09T20:30:24.940Z", - "GroupId": "AIDGPMS9RO4H3FEXAMPLE", - "GroupName": "Admins", - "Path": "/" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command creates an IAM group named Admins.", - "id": "d5da2a90-5e69-4ef7-8ae8-4c33dc21fd21", - "title": "To create an IAM group" - } - ], - "CreateInstanceProfile": [ - { - "input": { - "InstanceProfileName": "Webserver" - }, - "output": { - "InstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/Webserver", - "CreateDate": "2015-03-09T20:33:19.626Z", - "InstanceProfileId": "AIPAJMBYC7DLSPEXAMPLE", - "InstanceProfileName": "Webserver", - "Path": "/", - "Roles": [ - - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command creates an instance profile named Webserver that is ready to have a role attached and then be associated with an EC2 instance.", - "id": "5d84e6ae-5921-4e39-8454-10232cd9ff9a", - "title": "To create an instance profile" - } - ], - "CreateLoginProfile": [ - { - "input": { - "Password": "h]6EszR}vJ*m", - "PasswordResetRequired": true, - "UserName": "Bob" - }, - "output": { - "LoginProfile": { - "CreateDate": "2015-03-10T20:55:40.274Z", - "PasswordResetRequired": true, - "UserName": "Bob" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command changes IAM user Bob's password and sets the flag that required Bob to change the password the next time he signs in.", - "id": "c63795bc-3444-40b3-89df-83c474ef88be", - "title": "To create an instance profile" - } - ], - "CreateOpenIDConnectProvider": [ - { - "input": { - "ClientIDList": [ - "my-application-id" - ], - "ThumbprintList": [ - "3768084dfb3d2b68b7897bf5f565da8efEXAMPLE" - ], - "Url": "https://server.example.com" - }, - "output": { - "OpenIDConnectProviderArn": "arn:aws:iam::123456789012:oidc-provider/server.example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example defines a new OIDC provider in IAM with a client ID of my-application-id and pointing at the server with a URL of https://server.example.com.", - "id": "4e4a6bff-cc97-4406-922e-0ab4a82cdb63", - "title": "To create an instance profile" - } - ], - "CreateRole": [ - { - "input": { - "AssumeRolePolicyDocument": "", - "Path": "/", - "RoleName": "Test-Role" - }, - "output": { - "Role": { - "Arn": "arn:aws:iam::123456789012:role/Test-Role", - "AssumeRolePolicyDocument": "", - "CreateDate": "2013-06-07T20:43:32.821Z", - "Path": "/", - "RoleId": "AKIAIOSFODNN7EXAMPLE", - "RoleName": "Test-Role" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command creates a role named Test-Role and attaches a trust policy to it that is provided as a URL-encoded JSON string.", - "id": "eaaa4b5f-51f1-4f73-b0d3-30127040eff8", - "title": "To create an IAM role" - } - ], - "CreateUser": [ - { - "input": { - "UserName": "Bob" - }, - "output": { - "User": { - "Arn": "arn:aws:iam::123456789012:user/Bob", - "CreateDate": "2013-06-08T03:20:41.270Z", - "Path": "/", - "UserId": "AKIAIOSFODNN7EXAMPLE", - "UserName": "Bob" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following create-user command creates an IAM user named Bob in the current account.", - "id": "eb15f90b-e5f5-4af8-a594-e4e82b181a62", - "title": "To create an IAM user" - } - ], - "DeleteAccessKey": [ - { - "input": { - "AccessKeyId": "AKIDPMS9RO4H3FEXAMPLE", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deletes one access key (access key ID and secret access key) assigned to the IAM user named Bob.", - "id": "61a785a7-d30a-415a-ae18-ab9236e56871", - "title": "To delete an access key for an IAM user" - } - ], - "DeleteAccountAlias": [ - { - "input": { - "AccountAlias": "mycompany" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the alias mycompany from the current AWS account:", - "id": "7abeca65-04a8-4500-a890-47f1092bf766", - "title": "To delete an account alias" - } - ], - "DeleteAccountPasswordPolicy": [ - { - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the password policy from the current AWS account:", - "id": "9ddf755e-495c-49bc-ae3b-ea6cc9b8ebcf", - "title": "To delete the current account password policy" - } - ], - "DeleteGroupPolicy": [ - { - "input": { - "GroupName": "Admins", - "PolicyName": "ExamplePolicy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deletes the policy named ExamplePolicy from the group named Admins:", - "id": "e683f2bd-98a4-4fe0-bb66-33169c692d4a", - "title": "To delete a policy from an IAM group" - } - ], - "DeleteInstanceProfile": [ - { - "input": { - "InstanceProfileName": "ExampleInstanceProfile" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deletes the instance profile named ExampleInstanceProfile", - "id": "12d74fb8-3433-49db-8171-a1fc764e354d", - "title": "To delete an instance profile" - } - ], - "DeleteLoginProfile": [ - { - "input": { - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deletes the password for the IAM user named Bob.", - "id": "1fe57059-fc73-42e2-b992-517b7d573b5c", - "title": "To delete a password for an IAM user" - } - ], - "DeleteRole": [ - { - "input": { - "RoleName": "Test-Role" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the role named Test-Role.", - "id": "053cdf74-9bda-44b8-bdbb-140fd5a32603", - "title": "To delete an IAM role" - } - ], - "DeleteRolePolicy": [ - { - "input": { - "PolicyName": "ExamplePolicy", - "RoleName": "Test-Role" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the policy named ExamplePolicy from the role named Test-Role.", - "id": "9c667336-fde3-462c-b8f3-950800821e27", - "title": "To remove a policy from an IAM role" - } - ], - "DeleteSigningCertificate": [ - { - "input": { - "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", - "UserName": "Anika" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deletes the specified signing certificate for the IAM user named Anika.", - "id": "e3357586-ba9c-4070-b35b-d1a899b71987", - "title": "To delete a signing certificate for an IAM user" - } - ], - "DeleteUser": [ - { - "input": { - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the IAM user named Bob from the current account.", - "id": "a13dc3f9-59fe-42d9-abbb-fb98b204fdf0", - "title": "To delete an IAM user" - } - ], - "DeleteUserPolicy": [ - { - "input": { - "PolicyName": "ExamplePolicy", - "UserName": "Juan" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following delete-user-policy command removes the specified policy from the IAM user named Juan:", - "id": "34f07ddc-9bc1-4f52-bc59-cd0a3ccd06c8", - "title": "To remove a policy from an IAM user" - } - ], - "DeleteVirtualMFADevice": [ - { - "input": { - "SerialNumber": "arn:aws:iam::123456789012:mfa/ExampleName" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following delete-virtual-mfa-device command removes the specified MFA device from the current AWS account.", - "id": "2933b08b-dbe7-4b89-b8c1-fdf75feea1ee", - "title": "To remove a virtual MFA device" - } - ], - "GetAccountPasswordPolicy": [ - { - "output": { - "PasswordPolicy": { - "AllowUsersToChangePassword": false, - "ExpirePasswords": false, - "HardExpiry": false, - "MaxPasswordAge": 90, - "MinimumPasswordLength": 8, - "PasswordReusePrevention": 12, - "RequireLowercaseCharacters": false, - "RequireNumbers": true, - "RequireSymbols": true, - "RequireUppercaseCharacters": false - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command displays details about the password policy for the current AWS account.", - "id": "5e4598c7-c425-431f-8af1-19073b3c4a5f", - "title": "To see the current account password policy" - } - ], - "GetAccountSummary": [ - { - "output": { - "SummaryMap": { - "AccessKeysPerUserQuota": 2, - "AccountAccessKeysPresent": 1, - "AccountMFAEnabled": 0, - "AccountSigningCertificatesPresent": 0, - "AttachedPoliciesPerGroupQuota": 10, - "AttachedPoliciesPerRoleQuota": 10, - "AttachedPoliciesPerUserQuota": 10, - "GroupPolicySizeQuota": 5120, - "Groups": 15, - "GroupsPerUserQuota": 10, - "GroupsQuota": 100, - "MFADevices": 6, - "MFADevicesInUse": 3, - "Policies": 8, - "PoliciesQuota": 1000, - "PolicySizeQuota": 5120, - "PolicyVersionsInUse": 22, - "PolicyVersionsInUseQuota": 10000, - "ServerCertificates": 1, - "ServerCertificatesQuota": 20, - "SigningCertificatesPerUserQuota": 2, - "UserPolicySizeQuota": 2048, - "Users": 27, - "UsersQuota": 5000, - "VersionsPerPolicyQuota": 5 - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command returns information about the IAM entity quotas and usage in the current AWS account.", - "id": "9d8447af-f344-45de-8219-2cebc3cce7f2", - "title": "To get information about IAM entity quotas and usage in the current account" - } - ], - "GetInstanceProfile": [ - { - "input": { - "InstanceProfileName": "ExampleInstanceProfile" - }, - "output": { - "InstanceProfile": { - "Arn": "arn:aws:iam::336924118301:instance-profile/ExampleInstanceProfile", - "CreateDate": "2013-06-12T23:52:02Z", - "InstanceProfileId": "AID2MAB8DPLSRHEXAMPLE", - "InstanceProfileName": "ExampleInstanceProfile", - "Path": "/", - "Roles": [ - { - "Arn": "arn:aws:iam::336924118301:role/Test-Role", - "AssumeRolePolicyDocument": "", - "CreateDate": "2013-01-09T06:33:26Z", - "Path": "/", - "RoleId": "AIDGPMS9RO4H3FEXAMPLE", - "RoleName": "Test-Role" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command gets information about the instance profile named ExampleInstanceProfile.", - "id": "463b9ba5-18cc-4608-9ccb-5a7c6b6e5fe7", - "title": "To get information about an instance profile" - } - ], - "GetLoginProfile": [ - { - "input": { - "UserName": "Anika" - }, - "output": { - "LoginProfile": { - "CreateDate": "2012-09-21T23:03:39Z", - "UserName": "Anika" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command gets information about the password for the IAM user named Anika.", - "id": "d6b580cc-909f-4925-9caa-d425cbc1ad47", - "title": "To get password information for an IAM user" - } - ], - "GetRole": [ - { - "input": { - "RoleName": "Test-Role" - }, - "output": { - "Role": { - "Arn": "arn:aws:iam::123456789012:role/Test-Role", - "AssumeRolePolicyDocument": "", - "CreateDate": "2013-04-18T05:01:58Z", - "Path": "/", - "RoleId": "AIDIODR4TAW7CSEXAMPLE", - "RoleName": "Test-Role" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command gets information about the role named Test-Role.", - "id": "5b7d03a6-340c-472d-aa77-56425950d8b0", - "title": "To get information about an IAM role" - } - ], - "GetUser": [ - { - "input": { - "UserName": "Bob" - }, - "output": { - "User": { - "Arn": "arn:aws:iam::123456789012:user/Bob", - "CreateDate": "2012-09-21T23:03:13Z", - "Path": "/", - "UserId": "AKIAIOSFODNN7EXAMPLE", - "UserName": "Bob" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command gets information about the IAM user named Bob.", - "id": "ede000a1-9e4c-40db-bd0a-d4f95e41a6ab", - "title": "To get information about an IAM user" - } - ], - "ListAccessKeys": [ - { - "input": { - "UserName": "Alice" - }, - "output": { - "AccessKeyMetadata": [ - { - "AccessKeyId": "AKIA111111111EXAMPLE", - "CreateDate": "2016-12-01T22:19:58Z", - "Status": "Active", - "UserName": "Alice" - }, - { - "AccessKeyId": "AKIA222222222EXAMPLE", - "CreateDate": "2016-12-01T22:20:01Z", - "Status": "Active", - "UserName": "Alice" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the access keys IDs for the IAM user named Alice.", - "id": "15571463-ebea-411a-a021-1c76bd2a3625", - "title": "To list the access key IDs for an IAM user" - } - ], - "ListAccountAliases": [ - { - "input": { - }, - "output": { - "AccountAliases": [ - "exmaple-corporation" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the aliases for the current account.", - "id": "e27b457a-16f9-4e05-a006-3df7b3472741", - "title": "To list account aliases" - } - ], - "ListGroupPolicies": [ - { - "input": { - "GroupName": "Admins" - }, - "output": { - "PolicyNames": [ - "AdminRoot", - "KeyPolicy" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the names of in-line policies that are embedded in the IAM group named Admins.", - "id": "02de5095-2410-4d3a-ac1b-cc40234af68f", - "title": "To list the in-line policies for an IAM group" - } - ], - "ListGroups": [ - { - "input": { - }, - "output": { - "Groups": [ - { - "Arn": "arn:aws:iam::123456789012:group/Admins", - "CreateDate": "2016-12-15T21:40:08.121Z", - "GroupId": "AGPA1111111111EXAMPLE", - "GroupName": "Admins", - "Path": "/division_abc/subdivision_xyz/" - }, - { - "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/engineering/Test", - "CreateDate": "2016-11-30T14:10:01.156Z", - "GroupId": "AGP22222222222EXAMPLE", - "GroupName": "Test", - "Path": "/division_abc/subdivision_xyz/product_1234/engineering/" - }, - { - "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/Managers", - "CreateDate": "2016-06-12T20:14:52.032Z", - "GroupId": "AGPI3333333333EXAMPLE", - "GroupName": "Managers", - "Path": "/division_abc/subdivision_xyz/product_1234/" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the IAM groups in the current account:", - "id": "b3ab1380-2a21-42fb-8e85-503f65512c66", - "title": "To list the IAM groups for the current account" - } - ], - "ListGroupsForUser": [ - { - "input": { - "UserName": "Bob" - }, - "output": { - "Groups": [ - { - "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/engineering/Test", - "CreateDate": "2016-11-30T14:10:01.156Z", - "GroupId": "AGP2111111111EXAMPLE", - "GroupName": "Test", - "Path": "/division_abc/subdivision_xyz/product_1234/engineering/" - }, - { - "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/Managers", - "CreateDate": "2016-06-12T20:14:52.032Z", - "GroupId": "AGPI222222222SEXAMPLE", - "GroupName": "Managers", - "Path": "/division_abc/subdivision_xyz/product_1234/" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command displays the groups that the IAM user named Bob belongs to.", - "id": "278ec2ee-fc28-4136-83fb-433af0ae46a2", - "title": "To list the groups that an IAM user belongs to" - } - ], - "ListSigningCertificates": [ - { - "input": { - "UserName": "Bob" - }, - "output": { - "Certificates": [ - { - "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", - "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", - "Status": "Active", - "UploadDate": "2013-06-06T21:40:08Z", - "UserName": "Bob" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the signing certificates for the IAM user named Bob.", - "id": "b4c10256-4fc9-457e-b3fd-4a110d4d73dc", - "title": "To list the signing certificates for an IAM user" - } - ], - "ListUsers": [ - { - "input": { - }, - "output": { - "Users": [ - { - "Arn": "arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/engineering/Juan", - "CreateDate": "2012-09-05T19:38:48Z", - "PasswordLastUsed": "2016-09-08T21:47:36Z", - "Path": "/division_abc/subdivision_xyz/engineering/", - "UserId": "AID2MAB8DPLSRHEXAMPLE", - "UserName": "Juan" - }, - { - "Arn": "arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/engineering/Anika", - "CreateDate": "2014-04-09T15:43:45Z", - "PasswordLastUsed": "2016-09-24T16:18:07Z", - "Path": "/division_abc/subdivision_xyz/engineering/", - "UserId": "AIDIODR4TAW7CSEXAMPLE", - "UserName": "Anika" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the IAM users in the current account.", - "id": "9edfbd73-03d8-4d8a-9a79-76c85e8c8298", - "title": "To list IAM users" - } - ], - "ListVirtualMFADevices": [ - { - "input": { - }, - "output": { - "VirtualMFADevices": [ - { - "SerialNumber": "arn:aws:iam::123456789012:mfa/ExampleMFADevice" - }, - { - "SerialNumber": "arn:aws:iam::123456789012:mfa/Juan" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command lists the virtual MFA devices that have been configured for the current account.", - "id": "54f9ac18-5100-4070-bec4-fe5f612710d5", - "title": "To list virtual MFA devices" - } - ], - "PutGroupPolicy": [ - { - "input": { - "GroupName": "Admins", - "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"*\",\"Resource\":\"*\"}}", - "PolicyName": "AllPerms" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command adds a policy named AllPerms to the IAM group named Admins.", - "id": "4bc17418-758f-4d0f-ab0c-4d00265fec2e", - "title": "To add a policy to a group" - } - ], - "PutRolePolicy": [ - { - "input": { - "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}", - "PolicyName": "S3AccessPolicy", - "RoleName": "S3Access" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command adds a permissions policy to the role named Test-Role.", - "id": "de62fd00-46c7-4601-9e0d-71d5fbb11ecb", - "title": "To attach a permissions policy to an IAM role" - } - ], - "PutUserPolicy": [ - { - "input": { - "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"*\",\"Resource\":\"*\"}}", - "PolicyName": "AllAccessPolicy", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command attaches a policy to the IAM user named Bob.", - "id": "2551ffc6-3576-4d39-823f-30b60bffc2c7", - "title": "To attach a policy to an IAM user" - } - ], - "RemoveRoleFromInstanceProfile": [ - { - "input": { - "InstanceProfileName": "ExampleInstanceProfile", - "RoleName": "Test-Role" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the role named Test-Role from the instance profile named ExampleInstanceProfile.", - "id": "6d9f46f1-9f4a-4873-b403-51a85c5c627c", - "title": "To remove a role from an instance profile" - } - ], - "RemoveUserFromGroup": [ - { - "input": { - "GroupName": "Admins", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command removes the user named Bob from the IAM group named Admins.", - "id": "fb54d5b4-0caf-41d8-af0e-10a84413f174", - "title": "To remove a user from an IAM group" - } - ], - "UpdateAccessKey": [ - { - "input": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "Status": "Inactive", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command deactivates the specified access key (access key ID and secret access key) for the IAM user named Bob.", - "id": "02b556fd-e673-49b7-ab6b-f2f9035967d0", - "title": "To activate or deactivate an access key for an IAM user" - } - ], - "UpdateAccountPasswordPolicy": [ - { - "input": { - "MinimumPasswordLength": 8, - "RequireNumbers": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command sets the password policy to require a minimum length of eight characters and to require one or more numbers in the password:", - "id": "c263a1af-37dc-4423-8dba-9790284ef5e0", - "title": "To set or change the current account password policy" - } - ], - "UpdateAssumeRolePolicy": [ - { - "input": { - "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":[\"ec2.amazonaws.com\"]},\"Action\":[\"sts:AssumeRole\"]}]}", - "RoleName": "S3AccessForEC2Instances" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command updates the role trust policy for the role named Test-Role:", - "id": "c9150063-d953-4e99-9576-9685872006c6", - "title": "To update the trust policy for an IAM role" - } - ], - "UpdateGroup": [ - { - "input": { - "GroupName": "Test", - "NewGroupName": "Test-1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command changes the name of the IAM group Test to Test-1.", - "id": "f0cf1662-91ae-4278-a80e-7db54256ccba", - "title": "To rename an IAM group" - } - ], - "UpdateLoginProfile": [ - { - "input": { - "Password": "SomeKindOfPassword123!@#", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command creates or changes the password for the IAM user named Bob.", - "id": "036d9498-ecdb-4ed6-a8d8-366c383d1487", - "title": "To change the password for an IAM user" - } - ], - "UpdateSigningCertificate": [ - { - "input": { - "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", - "Status": "Inactive", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command changes the status of a signing certificate for a user named Bob to Inactive.", - "id": "829aee7b-efc5-4b3b-84a5-7f899b38018d", - "title": "To change the active status of a signing certificate for an IAM user" - } - ], - "UpdateUser": [ - { - "input": { - "NewUserName": "Robert", - "UserName": "Bob" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command changes the name of the IAM user Bob to Robert. It does not change the user's path.", - "id": "275d53ed-347a-44e6-b7d0-a96276154352", - "title": "To change an IAM user's name" - } - ], - "UploadServerCertificate": [ - { - "input": { - "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", - "Path": "/company/servercerts/", - "PrivateKey": "-----BEGIN DSA PRIVATE KEY----------END DSA PRIVATE KEY-----", - "ServerCertificateName": "ProdServerCert" - }, - "output": { - "ServerCertificateMetadata": { - "Arn": "arn:aws:iam::123456789012:server-certificate/company/servercerts/ProdServerCert", - "Expiration": "2012-05-08T01:02:03.004Z", - "Path": "/company/servercerts/", - "ServerCertificateId": "ASCA1111111111EXAMPLE", - "ServerCertificateName": "ProdServerCert", - "UploadDate": "2010-05-08T01:02:03.004Z" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following upload-server-certificate command uploads a server certificate to your AWS account:", - "id": "06eab6d1-ebf2-4bd9-839d-f7508b9a38b6", - "title": "To upload a server certificate to your AWS account" - } - ], - "UploadSigningCertificate": [ - { - "input": { - "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", - "UserName": "Bob" - }, - "output": { - "Certificate": { - "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", - "CertificateId": "ID123456789012345EXAMPLE", - "Status": "Active", - "UploadDate": "2015-06-06T21:40:08.121Z", - "UserName": "Bob" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following command uploads a signing certificate for the IAM user named Bob.", - "id": "e67489b6-7b73-4e30-9ed3-9a9e0231e458", - "title": "To upload a signing certificate for an IAM user" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/paginators-1.json deleted file mode 100644 index 83e78d89..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/paginators-1.json +++ /dev/null @@ -1,198 +0,0 @@ -{ - "pagination": { - "GetAccountAuthorizationDetails": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": [ - "UserDetailList", - "GroupDetailList", - "RoleDetailList", - "Policies" - ] - }, - "GetGroup": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Users", - "non_aggregate_keys": [ - "Group" - ] - }, - "ListAccessKeys": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "AccessKeyMetadata" - }, - "ListAccountAliases": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "AccountAliases" - }, - "ListAttachedGroupPolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "AttachedPolicies" - }, - "ListAttachedRolePolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "AttachedPolicies" - }, - "ListAttachedUserPolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "AttachedPolicies" - }, - "ListEntitiesForPolicy": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": [ - "PolicyGroups", - "PolicyUsers", - "PolicyRoles" - ] - }, - "ListGroupPolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "PolicyNames" - }, - "ListGroups": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Groups" - }, - "ListGroupsForUser": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Groups" - }, - "ListInstanceProfiles": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "InstanceProfiles" - }, - "ListInstanceProfilesForRole": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "InstanceProfiles" - }, - "ListMFADevices": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "MFADevices" - }, - "ListPolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Policies" - }, - "ListPolicyVersions": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Versions" - }, - "ListRolePolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "PolicyNames" - }, - "ListRoles": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Roles" - }, - "ListServerCertificates": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "ServerCertificateMetadataList" - }, - "ListSigningCertificates": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Certificates" - }, - "ListSSHPublicKeys": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "SSHPublicKeys" - }, - "ListUserPolicies": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "PolicyNames" - }, - "ListUsers": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "Users" - }, - "ListVirtualMFADevices": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "VirtualMFADevices" - }, - "SimulateCustomPolicy": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "EvaluationResults" - }, - "SimulatePrincipalPolicy": { - "input_token": "Marker", - "limit_key": "MaxItems", - "more_results": "IsTruncated", - "output_token": "Marker", - "result_key": "EvaluationResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/service-2.json deleted file mode 100644 index be52c7ba..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/service-2.json +++ /dev/null @@ -1,7259 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-05-08", - "endpointPrefix":"iam", - "globalEndpoint":"iam.amazonaws.com", - "protocol":"query", - "serviceAbbreviation":"IAM", - "serviceFullName":"AWS Identity and Access Management", - "serviceId":"IAM", - "signatureVersion":"v4", - "uid":"iam-2010-05-08", - "xmlNamespace":"https://iam.amazonaws.com/doc/2010-05-08/" - }, - "operations":{ - "AddClientIDToOpenIDConnectProvider":{ - "name":"AddClientIDToOpenIDConnectProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddClientIDToOpenIDConnectProviderRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds a new client ID (also known as audience) to the list of client IDs already registered for the specified IAM OpenID Connect (OIDC) provider resource.

This operation is idempotent; it does not fail or return an error if you add an existing client ID to the provider.

" - }, - "AddRoleToInstanceProfile":{ - "name":"AddRoleToInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddRoleToInstanceProfileRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds the specified IAM role to the specified instance profile. An instance profile can contain only one role, and this limit cannot be increased. You can remove the existing role and then add a different role to an instance profile. You must then wait for the change to appear across all of AWS because of eventual consistency. To force the change, you must disassociate the instance profile and then associate the instance profile, or you can stop your instance and then restart it.

The caller of this API must be granted the PassRole permission on the IAM role by a permission policy.

For more information about roles, go to Working with Roles. For more information about instance profiles, go to About Instance Profiles.

" - }, - "AddUserToGroup":{ - "name":"AddUserToGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddUserToGroupRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds the specified user to the specified group.

" - }, - "AttachGroupPolicy":{ - "name":"AttachGroupPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachGroupPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotAttachableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Attaches the specified managed policy to the specified IAM group.

You use this API to attach a managed policy to a group. To embed an inline policy in a group, use PutGroupPolicy.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "AttachRolePolicy":{ - "name":"AttachRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachRolePolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"PolicyNotAttachableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Attaches the specified managed policy to the specified IAM role. When you attach a managed policy to a role, the managed policy becomes part of the role's permission (access) policy.

You cannot use a managed policy as the role's trust policy. The role's trust policy is created at the same time as the role, using CreateRole. You can update a role's trust policy using UpdateAssumeRolePolicy.

Use this API to attach a managed policy to a role. To embed an inline policy in a role, use PutRolePolicy. For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "AttachUserPolicy":{ - "name":"AttachUserPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachUserPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotAttachableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Attaches the specified managed policy to the specified user.

You use this API to attach a managed policy to a user. To embed an inline policy in a user, use PutUserPolicy.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "ChangePassword":{ - "name":"ChangePassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ChangePasswordRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidUserTypeException"}, - {"shape":"LimitExceededException"}, - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"PasswordPolicyViolationException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Changes the password of the IAM user who is calling this operation. The AWS account root user password is not affected by this operation.

To change the password for a different user, see UpdateLoginProfile. For more information about modifying passwords, see Managing Passwords in the IAM User Guide.

" - }, - "CreateAccessKey":{ - "name":"CreateAccessKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAccessKeyRequest"}, - "output":{ - "shape":"CreateAccessKeyResponse", - "resultWrapper":"CreateAccessKeyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new AWS secret access key and corresponding AWS access key ID for the specified user. The default status for new keys is Active.

If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials. This is true even if the AWS account has no associated users.

For information about limits on the number of keys you can create, see Limitations on IAM Entities in the IAM User Guide.

To ensure the security of your AWS account, the secret access key is accessible only during key and user creation. You must save the key (for example, in a text file) if you want to be able to access it again. If a secret key is lost, you can delete the access keys for the associated user and then create new keys.

" - }, - "CreateAccountAlias":{ - "name":"CreateAccountAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAccountAliasRequest"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates an alias for your AWS account. For information about using an AWS account alias, see Using an Alias for Your AWS Account ID in the IAM User Guide.

" - }, - "CreateGroup":{ - "name":"CreateGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGroupRequest"}, - "output":{ - "shape":"CreateGroupResponse", - "resultWrapper":"CreateGroupResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new group.

For information about the number of groups you can create, see Limitations on IAM Entities in the IAM User Guide.

" - }, - "CreateInstanceProfile":{ - "name":"CreateInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceProfileRequest"}, - "output":{ - "shape":"CreateInstanceProfileResponse", - "resultWrapper":"CreateInstanceProfileResult" - }, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new instance profile. For information about instance profiles, go to About Instance Profiles.

For information about the number of instance profiles you can create, see Limitations on IAM Entities in the IAM User Guide.

" - }, - "CreateLoginProfile":{ - "name":"CreateLoginProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoginProfileRequest"}, - "output":{ - "shape":"CreateLoginProfileResponse", - "resultWrapper":"CreateLoginProfileResult" - }, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"PasswordPolicyViolationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a password for the specified user, giving the user the ability to access AWS services through the AWS Management Console. For more information about managing passwords, see Managing Passwords in the IAM User Guide.

" - }, - "CreateOpenIDConnectProvider":{ - "name":"CreateOpenIDConnectProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateOpenIDConnectProviderRequest"}, - "output":{ - "shape":"CreateOpenIDConnectProviderResponse", - "resultWrapper":"CreateOpenIDConnectProviderResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates an IAM entity to describe an identity provider (IdP) that supports OpenID Connect (OIDC).

The OIDC provider that you create with this operation can be used as a principal in a role's trust policy. Such a policy establishes a trust relationship between AWS and the OIDC provider.

When you create the IAM OIDC provider, you specify the following:

  • The URL of the OIDC identity provider (IdP) to trust

  • A list of client IDs (also known as audiences) that identify the application or applications that are allowed to authenticate using the OIDC provider

  • A list of thumbprints of the server certificate(s) that the IdP uses.

You get all of this information from the OIDC IdP that you want to use to access AWS.

Because trust for the OIDC provider is derived from the IAM provider that this operation creates, it is best to limit access to the CreateOpenIDConnectProvider operation to highly privileged users.

" - }, - "CreatePolicy":{ - "name":"CreatePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePolicyRequest"}, - "output":{ - "shape":"CreatePolicyResponse", - "resultWrapper":"CreatePolicyResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new managed policy for your AWS account.

This operation creates a policy version with a version identifier of v1 and sets v1 as the policy's default version. For more information about policy versions, see Versioning for Managed Policies in the IAM User Guide.

For more information about managed policies in general, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "CreatePolicyVersion":{ - "name":"CreatePolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePolicyVersionRequest"}, - "output":{ - "shape":"CreatePolicyVersionResponse", - "resultWrapper":"CreatePolicyVersionResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new version of the specified managed policy. To update a managed policy, you create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must delete an existing version using DeletePolicyVersion before you create a new version.

Optionally, you can set the new version as the policy's default version. The default version is the version that is in effect for the IAM users, groups, and roles to which the policy is attached.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - }, - "CreateRole":{ - "name":"CreateRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRoleRequest"}, - "output":{ - "shape":"CreateRoleResponse", - "resultWrapper":"CreateRoleResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new role for your AWS account. For more information about roles, go to IAM Roles. For information about limitations on role names and the number of roles you can create, go to Limitations on IAM Entities in the IAM User Guide.

" - }, - "CreateSAMLProvider":{ - "name":"CreateSAMLProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSAMLProviderRequest"}, - "output":{ - "shape":"CreateSAMLProviderResponse", - "resultWrapper":"CreateSAMLProviderResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates an IAM resource that describes an identity provider (IdP) that supports SAML 2.0.

The SAML provider resource that you create with this operation can be used as a principal in an IAM role's trust policy. Such a policy can enable federated users who sign-in using the SAML IdP to assume the role. You can create an IAM role that supports Web-based single sign-on (SSO) to the AWS Management Console or one that supports API access to AWS.

When you create the SAML provider resource, you upload a SAML metadata document that you get from your IdP. That document includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that the IdP sends. You must generate the metadata document using the identity management software that is used as your organization's IdP.

This operation requires Signature Version 4.

For more information, see Enabling SAML 2.0 Federated Users to Access the AWS Management Console and About SAML 2.0-based Federation in the IAM User Guide.

" - }, - "CreateServiceLinkedRole":{ - "name":"CreateServiceLinkedRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateServiceLinkedRoleRequest"}, - "output":{ - "shape":"CreateServiceLinkedRoleResponse", - "resultWrapper":"CreateServiceLinkedRoleResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates an IAM role that is linked to a specific AWS service. The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed.

The name of the role is generated by combining the string that you specify for the AWSServiceName parameter with the string that you specify for the CustomSuffix parameter. The resulting name must be unique in your account or the request fails.

To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.

" - }, - "CreateServiceSpecificCredential":{ - "name":"CreateServiceSpecificCredential", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateServiceSpecificCredentialRequest"}, - "output":{ - "shape":"CreateServiceSpecificCredentialResponse", - "resultWrapper":"CreateServiceSpecificCredentialResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceNotSupportedException"} - ], - "documentation":"

Generates a set of credentials consisting of a user name and password that can be used to access the service specified in the request. These credentials are generated by IAM, and can be used only for the specified service.

You can have a maximum of two sets of service-specific credentials for each supported service per user.

The only supported service at this time is AWS CodeCommit.

You can reset the password to a new service-generated value by calling ResetServiceSpecificCredential.

For more information about service-specific credentials, see Using IAM with AWS CodeCommit: Git Credentials, SSH Keys, and AWS Access Keys in the IAM User Guide.

" - }, - "CreateUser":{ - "name":"CreateUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserRequest"}, - "output":{ - "shape":"CreateUserResponse", - "resultWrapper":"CreateUserResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new IAM user for your AWS account.

For information about limitations on the number of IAM users you can create, see Limitations on IAM Entities in the IAM User Guide.

" - }, - "CreateVirtualMFADevice":{ - "name":"CreateVirtualMFADevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVirtualMFADeviceRequest"}, - "output":{ - "shape":"CreateVirtualMFADeviceResponse", - "resultWrapper":"CreateVirtualMFADeviceResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Creates a new virtual MFA device for the AWS account. After creating the virtual MFA, use EnableMFADevice to attach the MFA device to an IAM user. For more information about creating and working with virtual MFA devices, go to Using a Virtual MFA Device in the IAM User Guide.

For information about limits on the number of MFA devices you can create, see Limitations on Entities in the IAM User Guide.

The seed information contained in the QR code and the Base32 string should be treated like any other secret access information, such as your AWS access keys or your passwords. After you provision your virtual device, you should ensure that the information is destroyed following secure procedures.

" - }, - "DeactivateMFADevice":{ - "name":"DeactivateMFADevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeactivateMFADeviceRequest"}, - "errors":[ - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deactivates the specified MFA device and removes it from association with the user name for which it was originally enabled.

For more information about creating and working with virtual MFA devices, go to Using a Virtual MFA Device in the IAM User Guide.

" - }, - "DeleteAccessKey":{ - "name":"DeleteAccessKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAccessKeyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the access key pair associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

" - }, - "DeleteAccountAlias":{ - "name":"DeleteAccountAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAccountAliasRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified AWS account alias. For information about using an AWS account alias, see Using an Alias for Your AWS Account ID in the IAM User Guide.

" - }, - "DeleteAccountPasswordPolicy":{ - "name":"DeleteAccountPasswordPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the password policy for the AWS account. There are no parameters.

" - }, - "DeleteGroup":{ - "name":"DeleteGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGroupRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified IAM group. The group must not contain any users or have any attached policies.

" - }, - "DeleteGroupPolicy":{ - "name":"DeleteGroupPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGroupPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified inline policy that is embedded in the specified IAM group.

A group can also have managed policies attached to it. To detach a managed policy from a group, use DetachGroupPolicy. For more information about policies, refer to Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DeleteInstanceProfile":{ - "name":"DeleteInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInstanceProfileRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified instance profile. The instance profile must not have an associated role.

Make sure that you do not have any Amazon EC2 instances running with the instance profile you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.

For more information about instance profiles, go to About Instance Profiles.

" - }, - "DeleteLoginProfile":{ - "name":"DeleteLoginProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoginProfileRequest"}, - "errors":[ - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the password for the specified IAM user, which terminates the user's ability to access AWS services through the AWS Management Console.

Deleting a user's password does not prevent a user from accessing AWS through the command line interface or the API. To prevent all user access you must also either make any access keys inactive or delete them. For more information about making keys inactive or deleting them, see UpdateAccessKey and DeleteAccessKey.

" - }, - "DeleteOpenIDConnectProvider":{ - "name":"DeleteOpenIDConnectProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteOpenIDConnectProviderRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes an OpenID Connect identity provider (IdP) resource object in IAM.

Deleting an IAM OIDC provider resource does not update any roles that reference the provider as a principal in their trust policies. Any attempt to assume a role that references a deleted provider fails.

This operation is idempotent; it does not fail or return an error if you call the operation for a provider that does not exist.

" - }, - "DeletePolicy":{ - "name":"DeletePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"DeleteConflictException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified managed policy.

Before you can delete a managed policy, you must first detach the policy from all users, groups, and roles that it is attached to. In addition you must delete all the policy's versions. The following steps describe the process for deleting a managed policy:

  • Detach the policy from all users, groups, and roles that the policy is attached to, using the DetachUserPolicy, DetachGroupPolicy, or DetachRolePolicy API operations. To list all the users, groups, and roles that a policy is attached to, use ListEntitiesForPolicy.

  • Delete all versions of the policy using DeletePolicyVersion. To list the policy's versions, use ListPolicyVersions. You cannot use DeletePolicyVersion to delete the version that is marked as the default version. You delete the policy's default version in the next step of the process.

  • Delete the policy (this automatically deletes the policy's default version) using this API.

For information about managed policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DeletePolicyVersion":{ - "name":"DeletePolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePolicyVersionRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"DeleteConflictException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified version from the specified managed policy.

You cannot delete the default version from a policy using this API. To delete the default version from a policy, use DeletePolicy. To find out which version of a policy is marked as the default version, use ListPolicyVersions.

For information about versions for managed policies, see Versioning for Managed Policies in the IAM User Guide.

" - }, - "DeleteRole":{ - "name":"DeleteRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRoleRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified role. The role must not have any policies attached. For more information about roles, go to Working with Roles.

Make sure that you do not have any Amazon EC2 instances running with the role you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.

" - }, - "DeleteRolePermissionsBoundary":{ - "name":"DeleteRolePermissionsBoundary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRolePermissionsBoundaryRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the permissions boundary for the specified IAM role.

Deleting the permissions boundary for a role might increase its permissions by allowing anyone who assumes the role to perform all the actions granted in its permissions policies.

" - }, - "DeleteRolePolicy":{ - "name":"DeleteRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRolePolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified inline policy that is embedded in the specified IAM role.

A role can also have managed policies attached to it. To detach a managed policy from a role, use DetachRolePolicy. For more information about policies, refer to Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DeleteSAMLProvider":{ - "name":"DeleteSAMLProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSAMLProviderRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes a SAML provider resource in IAM.

Deleting the provider resource from IAM does not update any roles that reference the SAML provider resource's ARN as a principal in their trust policies. Any attempt to assume a role that references a non-existent provider resource ARN fails.

This operation requires Signature Version 4.

" - }, - "DeleteSSHPublicKey":{ - "name":"DeleteSSHPublicKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSSHPublicKeyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Deletes the specified SSH public key.

The SSH public key deleted by this operation is used only for authenticating the associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH Connections in the AWS CodeCommit User Guide.

" - }, - "DeleteServerCertificate":{ - "name":"DeleteServerCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServerCertificateRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified server certificate.

For more information about working with server certificates, see Working with Server Certificates in the IAM User Guide. This topic also includes a list of AWS services that can use the server certificates that you manage with IAM.

If you are using a server certificate with Elastic Load Balancing, deleting the certificate could have implications for your application. If Elastic Load Balancing doesn't detect the deletion of bound certificates, it may continue to use the certificates. This could cause Elastic Load Balancing to stop accepting traffic. We recommend that you remove the reference to the certificate from Elastic Load Balancing before using this command to delete the certificate. For more information, go to DeleteLoadBalancerListeners in the Elastic Load Balancing API Reference.

" - }, - "DeleteServiceLinkedRole":{ - "name":"DeleteServiceLinkedRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServiceLinkedRoleRequest"}, - "output":{ - "shape":"DeleteServiceLinkedRoleResponse", - "resultWrapper":"DeleteServiceLinkedRoleResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Submits a service-linked role deletion request and returns a DeletionTaskId, which you can use to check the status of the deletion. Before you call this operation, confirm that the role has no active sessions and that any resources used by the role in the linked service are deleted. If you call this operation more than once for the same service-linked role and an earlier deletion task is not complete, then the DeletionTaskId of the earlier request is returned.

If you submit a deletion request for a service-linked role whose linked service is still accessing a resource, then the deletion task fails. If it fails, the GetServiceLinkedRoleDeletionStatus API operation returns the reason for the failure, usually including the resources that must be deleted. To delete the service-linked role, you must first remove those resources from the linked service and then submit the deletion request again. Resources are specific to the service that is linked to the role. For more information about removing resources from a service, see the AWS documentation for your service.

For more information about service-linked roles, see Roles Terms and Concepts: AWS Service-Linked Role in the IAM User Guide.

" - }, - "DeleteServiceSpecificCredential":{ - "name":"DeleteServiceSpecificCredential", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServiceSpecificCredentialRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Deletes the specified service-specific credential.

" - }, - "DeleteSigningCertificate":{ - "name":"DeleteSigningCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSigningCertificateRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes a signing certificate associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated IAM users.

" - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserRequest"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified IAM user. The user must not belong to any groups or have any access keys, signing certificates, or attached policies.

" - }, - "DeleteUserPermissionsBoundary":{ - "name":"DeleteUserPermissionsBoundary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserPermissionsBoundaryRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the permissions boundary for the specified IAM user.

Deleting the permissions boundary for a user might increase its permissions by allowing the user to perform all the actions granted in its permissions policies.

" - }, - "DeleteUserPolicy":{ - "name":"DeleteUserPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified inline policy that is embedded in the specified IAM user.

A user can also have managed policies attached to it. To detach a managed policy from a user, use DetachUserPolicy. For more information about policies, refer to Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DeleteVirtualMFADevice":{ - "name":"DeleteVirtualMFADevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVirtualMFADeviceRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"DeleteConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes a virtual MFA device.

You must deactivate a user's virtual MFA device before you can delete it. For information about deactivating MFA devices, see DeactivateMFADevice.

" - }, - "DetachGroupPolicy":{ - "name":"DetachGroupPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachGroupPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified managed policy from the specified IAM group.

A group can also have inline policies embedded with it. To delete an inline policy, use the DeleteGroupPolicy API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DetachRolePolicy":{ - "name":"DetachRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachRolePolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified managed policy from the specified role.

A role can also have inline policies embedded with it. To delete an inline policy, use the DeleteRolePolicy API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "DetachUserPolicy":{ - "name":"DetachUserPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachUserPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified managed policy from the specified user.

A user can also have inline policies embedded with it. To delete an inline policy, use the DeleteUserPolicy API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "EnableMFADevice":{ - "name":"EnableMFADevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableMFADeviceRequest"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"InvalidAuthenticationCodeException"}, - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Enables the specified MFA device and associates it with the specified IAM user. When enabled, the MFA device is required for every subsequent login by the IAM user associated with the device.

" - }, - "GenerateCredentialReport":{ - "name":"GenerateCredentialReport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GenerateCredentialReportResponse", - "resultWrapper":"GenerateCredentialReportResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Generates a credential report for the AWS account. For more information about the credential report, see Getting Credential Reports in the IAM User Guide.

" - }, - "GetAccessKeyLastUsed":{ - "name":"GetAccessKeyLastUsed", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAccessKeyLastUsedRequest"}, - "output":{ - "shape":"GetAccessKeyLastUsedResponse", - "resultWrapper":"GetAccessKeyLastUsedResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Retrieves information about when the specified access key was last used. The information includes the date and time of last use, along with the AWS service and region that were specified in the last request made with that key.

" - }, - "GetAccountAuthorizationDetails":{ - "name":"GetAccountAuthorizationDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAccountAuthorizationDetailsRequest"}, - "output":{ - "shape":"GetAccountAuthorizationDetailsResponse", - "resultWrapper":"GetAccountAuthorizationDetailsResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about all IAM users, groups, roles, and policies in your AWS account, including their relationships to one another. Use this API to obtain a snapshot of the configuration of IAM permissions (users, groups, roles, and policies) in your account.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

You can optionally filter the results using the Filter parameter. You can paginate the results using the MaxItems and Marker parameters.

" - }, - "GetAccountPasswordPolicy":{ - "name":"GetAccountPasswordPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetAccountPasswordPolicyResponse", - "resultWrapper":"GetAccountPasswordPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the password policy for the AWS account. For more information about using a password policy, go to Managing an IAM Password Policy.

" - }, - "GetAccountSummary":{ - "name":"GetAccountSummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetAccountSummaryResponse", - "resultWrapper":"GetAccountSummaryResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about IAM entity usage and IAM quotas in the AWS account.

For information about limitations on IAM entities, see Limitations on IAM Entities in the IAM User Guide.

" - }, - "GetContextKeysForCustomPolicy":{ - "name":"GetContextKeysForCustomPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContextKeysForCustomPolicyRequest"}, - "output":{ - "shape":"GetContextKeysForPolicyResponse", - "resultWrapper":"GetContextKeysForCustomPolicyResult" - }, - "errors":[ - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets a list of all of the context keys referenced in the input policies. The policies are supplied as a list of one or more strings. To get the context keys from policies associated with an IAM user, group, or role, use GetContextKeysForPrincipalPolicy.

Context keys are variables maintained by AWS and its services that provide details about the context of an API query request. Context keys can be evaluated by testing against a value specified in an IAM policy. Use GetContextKeysForCustomPolicy to understand what key names and values you must supply when you call SimulateCustomPolicy. Note that all parameters are shown in unencoded form here for clarity but must be URL encoded to be included as a part of a real HTML request.

" - }, - "GetContextKeysForPrincipalPolicy":{ - "name":"GetContextKeysForPrincipalPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContextKeysForPrincipalPolicyRequest"}, - "output":{ - "shape":"GetContextKeysForPolicyResponse", - "resultWrapper":"GetContextKeysForPrincipalPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Gets a list of all of the context keys referenced in all the IAM policies that are attached to the specified IAM entity. The entity can be an IAM user, group, or role. If you specify a user, then the request also includes all of the policies attached to groups that the user is a member of.

You can optionally include a list of one or more additional policies, specified as strings. If you want to include only a list of policies by string, use GetContextKeysForCustomPolicy instead.

Note: This API discloses information about the permissions granted to other users. If you do not want users to see other user's permissions, then consider allowing them to use GetContextKeysForCustomPolicy instead.

Context keys are variables maintained by AWS and its services that provide details about the context of an API query request. Context keys can be evaluated by testing against a value in an IAM policy. Use GetContextKeysForPrincipalPolicy to understand what key names and values you must supply when you call SimulatePrincipalPolicy.

" - }, - "GetCredentialReport":{ - "name":"GetCredentialReport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetCredentialReportResponse", - "resultWrapper":"GetCredentialReportResult" - }, - "errors":[ - {"shape":"CredentialReportNotPresentException"}, - {"shape":"CredentialReportExpiredException"}, - {"shape":"CredentialReportNotReadyException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves a credential report for the AWS account. For more information about the credential report, see Getting Credential Reports in the IAM User Guide.

" - }, - "GetGroup":{ - "name":"GetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGroupRequest"}, - "output":{ - "shape":"GetGroupResponse", - "resultWrapper":"GetGroupResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns a list of IAM users that are in the specified IAM group. You can paginate the results using the MaxItems and Marker parameters.

" - }, - "GetGroupPolicy":{ - "name":"GetGroupPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGroupPolicyRequest"}, - "output":{ - "shape":"GetGroupPolicyResponse", - "resultWrapper":"GetGroupPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the specified inline policy document that is embedded in the specified IAM group.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

An IAM group can also have managed policies attached to it. To retrieve a managed policy document that is attached to a group, use GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "GetInstanceProfile":{ - "name":"GetInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceProfileRequest"}, - "output":{ - "shape":"GetInstanceProfileResponse", - "resultWrapper":"GetInstanceProfileResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role. For more information about instance profiles, see About Instance Profiles in the IAM User Guide.

" - }, - "GetLoginProfile":{ - "name":"GetLoginProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLoginProfileRequest"}, - "output":{ - "shape":"GetLoginProfileResponse", - "resultWrapper":"GetLoginProfileResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the user name and password-creation date for the specified IAM user. If the user has not been assigned a password, the operation returns a 404 (NoSuchEntity) error.

" - }, - "GetOpenIDConnectProvider":{ - "name":"GetOpenIDConnectProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOpenIDConnectProviderRequest"}, - "output":{ - "shape":"GetOpenIDConnectProviderResponse", - "resultWrapper":"GetOpenIDConnectProviderResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns information about the specified OpenID Connect (OIDC) provider resource object in IAM.

" - }, - "GetPolicy":{ - "name":"GetPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPolicyRequest"}, - "output":{ - "shape":"GetPolicyResponse", - "resultWrapper":"GetPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified managed policy, including the policy's default version and the total number of IAM users, groups, and roles to which the policy is attached. To retrieve the list of the specific users, groups, and roles that the policy is attached to, use the ListEntitiesForPolicy API. This API returns metadata about the policy. To retrieve the actual policy document for a specific version of the policy, use GetPolicyVersion.

This API retrieves information about managed policies. To retrieve information about an inline policy that is embedded with an IAM user, group, or role, use the GetUserPolicy, GetGroupPolicy, or GetRolePolicy API.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "GetPolicyVersion":{ - "name":"GetPolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPolicyVersionRequest"}, - "output":{ - "shape":"GetPolicyVersionResponse", - "resultWrapper":"GetPolicyVersionResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified version of the specified managed policy, including the policy document.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

To list the available versions for a policy, use ListPolicyVersions.

This API retrieves information about managed policies. To retrieve information about an inline policy that is embedded in a user, group, or role, use the GetUserPolicy, GetGroupPolicy, or GetRolePolicy API.

For more information about the types of policies, see Managed Policies and Inline Policies in the IAM User Guide.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - }, - "GetRole":{ - "name":"GetRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRoleRequest"}, - "output":{ - "shape":"GetRoleResponse", - "resultWrapper":"GetRoleResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified role, including the role's path, GUID, ARN, and the role's trust policy that grants permission to assume the role. For more information about roles, see Working with Roles.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

" - }, - "GetRolePolicy":{ - "name":"GetRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRolePolicyRequest"}, - "output":{ - "shape":"GetRolePolicyResponse", - "resultWrapper":"GetRolePolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the specified inline policy document that is embedded with the specified IAM role.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

An IAM role can also have managed policies attached to it. To retrieve a managed policy document that is attached to a role, use GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

For more information about roles, see Using Roles to Delegate Permissions and Federate Identities.

" - }, - "GetSAMLProvider":{ - "name":"GetSAMLProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSAMLProviderRequest"}, - "output":{ - "shape":"GetSAMLProviderResponse", - "resultWrapper":"GetSAMLProviderResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns the SAML provider metadocument that was uploaded when the IAM SAML provider resource object was created or updated.

This operation requires Signature Version 4.

" - }, - "GetSSHPublicKey":{ - "name":"GetSSHPublicKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSSHPublicKeyRequest"}, - "output":{ - "shape":"GetSSHPublicKeyResponse", - "resultWrapper":"GetSSHPublicKeyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"UnrecognizedPublicKeyEncodingException"} - ], - "documentation":"

Retrieves the specified SSH public key, including metadata about the key.

The SSH public key retrieved by this operation is used only for authenticating the associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH Connections in the AWS CodeCommit User Guide.

" - }, - "GetServerCertificate":{ - "name":"GetServerCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetServerCertificateRequest"}, - "output":{ - "shape":"GetServerCertificateResponse", - "resultWrapper":"GetServerCertificateResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified server certificate stored in IAM.

For more information about working with server certificates, see Working with Server Certificates in the IAM User Guide. This topic includes a list of AWS services that can use the server certificates that you manage with IAM.

" - }, - "GetServiceLinkedRoleDeletionStatus":{ - "name":"GetServiceLinkedRoleDeletionStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetServiceLinkedRoleDeletionStatusRequest"}, - "output":{ - "shape":"GetServiceLinkedRoleDeletionStatusResponse", - "resultWrapper":"GetServiceLinkedRoleDeletionStatusResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the status of your service-linked role deletion. After you use the DeleteServiceLinkedRole API operation to submit a service-linked role for deletion, you can use the DeletionTaskId parameter in GetServiceLinkedRoleDeletionStatus to check the status of the deletion. If the deletion fails, this operation returns the reason that it failed, if that information is returned by the service.

" - }, - "GetUser":{ - "name":"GetUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserRequest"}, - "output":{ - "shape":"GetUserResponse", - "resultWrapper":"GetUserResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves information about the specified IAM user, including the user's creation date, path, unique ID, and ARN.

If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID used to sign the request to this API.

" - }, - "GetUserPolicy":{ - "name":"GetUserPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetUserPolicyRequest"}, - "output":{ - "shape":"GetUserPolicyResponse", - "resultWrapper":"GetUserPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Retrieves the specified inline policy document that is embedded in the specified IAM user.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

An IAM user can also have managed policies attached to it. To retrieve a managed policy document that is attached to a user, use GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "ListAccessKeys":{ - "name":"ListAccessKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAccessKeysRequest"}, - "output":{ - "shape":"ListAccessKeysResponse", - "resultWrapper":"ListAccessKeysResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns information about the access key IDs associated with the specified IAM user. If there are none, the operation returns an empty list.

Although each user is limited to a small number of keys, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the AWS access key ID used to sign the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

To ensure the security of your AWS account, the secret access key is accessible only during key and user creation.

" - }, - "ListAccountAliases":{ - "name":"ListAccountAliases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAccountAliasesRequest"}, - "output":{ - "shape":"ListAccountAliasesResponse", - "resultWrapper":"ListAccountAliasesResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the account alias associated with the AWS account (Note: you can have only one). For information about using an AWS account alias, see Using an Alias for Your AWS Account ID in the IAM User Guide.

" - }, - "ListAttachedGroupPolicies":{ - "name":"ListAttachedGroupPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttachedGroupPoliciesRequest"}, - "output":{ - "shape":"ListAttachedGroupPoliciesResponse", - "resultWrapper":"ListAttachedGroupPoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists all managed policies that are attached to the specified IAM group.

An IAM group can also have inline policies embedded with it. To list the inline policies for a group, use the ListGroupPolicies API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified group (or none that match the specified path prefix), the operation returns an empty list.

" - }, - "ListAttachedRolePolicies":{ - "name":"ListAttachedRolePolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttachedRolePoliciesRequest"}, - "output":{ - "shape":"ListAttachedRolePoliciesResponse", - "resultWrapper":"ListAttachedRolePoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists all managed policies that are attached to the specified IAM role.

An IAM role can also have inline policies embedded with it. To list the inline policies for a role, use the ListRolePolicies API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified role (or none that match the specified path prefix), the operation returns an empty list.

" - }, - "ListAttachedUserPolicies":{ - "name":"ListAttachedUserPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttachedUserPoliciesRequest"}, - "output":{ - "shape":"ListAttachedUserPoliciesResponse", - "resultWrapper":"ListAttachedUserPoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists all managed policies that are attached to the specified IAM user.

An IAM user can also have inline policies embedded with it. To list the inline policies for a user, use the ListUserPolicies API. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified group (or none that match the specified path prefix), the operation returns an empty list.

" - }, - "ListEntitiesForPolicy":{ - "name":"ListEntitiesForPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEntitiesForPolicyRequest"}, - "output":{ - "shape":"ListEntitiesForPolicyResponse", - "resultWrapper":"ListEntitiesForPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists all IAM users, groups, and roles that the specified managed policy is attached to.

You can use the optional EntityFilter parameter to limit the results to a particular type of entity (users, groups, or roles). For example, to list only the roles that are attached to the specified policy, set EntityFilter to Role.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListGroupPolicies":{ - "name":"ListGroupPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupPoliciesRequest"}, - "output":{ - "shape":"ListGroupPoliciesResponse", - "resultWrapper":"ListGroupPoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the names of the inline policies that are embedded in the specified IAM group.

An IAM group can also have managed policies attached to it. To list the managed policies that are attached to a group, use ListAttachedGroupPolicies. For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. If there are no inline policies embedded with the specified group, the operation returns an empty list.

" - }, - "ListGroups":{ - "name":"ListGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupsRequest"}, - "output":{ - "shape":"ListGroupsResponse", - "resultWrapper":"ListGroupsResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the IAM groups that have the specified path prefix.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListGroupsForUser":{ - "name":"ListGroupsForUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupsForUserRequest"}, - "output":{ - "shape":"ListGroupsForUserResponse", - "resultWrapper":"ListGroupsForUserResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the IAM groups that the specified IAM user belongs to.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListInstanceProfiles":{ - "name":"ListInstanceProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstanceProfilesRequest"}, - "output":{ - "shape":"ListInstanceProfilesResponse", - "resultWrapper":"ListInstanceProfilesResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the instance profiles that have the specified path prefix. If there are none, the operation returns an empty list. For more information about instance profiles, go to About Instance Profiles.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListInstanceProfilesForRole":{ - "name":"ListInstanceProfilesForRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstanceProfilesForRoleRequest"}, - "output":{ - "shape":"ListInstanceProfilesForRoleResponse", - "resultWrapper":"ListInstanceProfilesForRoleResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the instance profiles that have the specified associated IAM role. If there are none, the operation returns an empty list. For more information about instance profiles, go to About Instance Profiles.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListMFADevices":{ - "name":"ListMFADevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListMFADevicesRequest"}, - "output":{ - "shape":"ListMFADevicesResponse", - "resultWrapper":"ListMFADevicesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the MFA devices for an IAM user. If the request includes a IAM user name, then this operation lists all the MFA devices associated with the specified user. If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request for this API.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListOpenIDConnectProviders":{ - "name":"ListOpenIDConnectProviders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOpenIDConnectProvidersRequest"}, - "output":{ - "shape":"ListOpenIDConnectProvidersResponse", - "resultWrapper":"ListOpenIDConnectProvidersResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists information about the IAM OpenID Connect (OIDC) provider resource objects defined in the AWS account.

" - }, - "ListPolicies":{ - "name":"ListPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPoliciesRequest"}, - "output":{ - "shape":"ListPoliciesResponse", - "resultWrapper":"ListPoliciesResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists all the managed policies that are available in your AWS account, including your own customer-defined managed policies and all AWS managed policies.

You can filter the list of policies that is returned using the optional OnlyAttached, Scope, and PathPrefix parameters. For example, to list only the customer managed policies in your AWS account, set Scope to Local. To list only AWS managed policies, set Scope to AWS.

You can paginate the results using the MaxItems and Marker parameters.

For more information about managed policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "ListPolicyVersions":{ - "name":"ListPolicyVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPolicyVersionsRequest"}, - "output":{ - "shape":"ListPolicyVersionsResponse", - "resultWrapper":"ListPolicyVersionsResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists information about the versions of the specified managed policy, including the version that is currently set as the policy's default version.

For more information about managed policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "ListRolePolicies":{ - "name":"ListRolePolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRolePoliciesRequest"}, - "output":{ - "shape":"ListRolePoliciesResponse", - "resultWrapper":"ListRolePoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the names of the inline policies that are embedded in the specified IAM role.

An IAM role can also have managed policies attached to it. To list the managed policies that are attached to a role, use ListAttachedRolePolicies. For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. If there are no inline policies embedded with the specified role, the operation returns an empty list.

" - }, - "ListRoles":{ - "name":"ListRoles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRolesRequest"}, - "output":{ - "shape":"ListRolesResponse", - "resultWrapper":"ListRolesResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the IAM roles that have the specified path prefix. If there are none, the operation returns an empty list. For more information about roles, go to Working with Roles.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListSAMLProviders":{ - "name":"ListSAMLProviders", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSAMLProvidersRequest"}, - "output":{ - "shape":"ListSAMLProvidersResponse", - "resultWrapper":"ListSAMLProvidersResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the SAML provider resource objects defined in IAM in the account.

This operation requires Signature Version 4.

" - }, - "ListSSHPublicKeys":{ - "name":"ListSSHPublicKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSSHPublicKeysRequest"}, - "output":{ - "shape":"ListSSHPublicKeysResponse", - "resultWrapper":"ListSSHPublicKeysResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Returns information about the SSH public keys associated with the specified IAM user. If there are none, the operation returns an empty list.

The SSH public keys returned by this operation are used only for authenticating the IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH Connections in the AWS CodeCommit User Guide.

Although each user is limited to a small number of keys, you can still paginate the results using the MaxItems and Marker parameters.

" - }, - "ListServerCertificates":{ - "name":"ListServerCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListServerCertificatesRequest"}, - "output":{ - "shape":"ListServerCertificatesResponse", - "resultWrapper":"ListServerCertificatesResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the server certificates stored in IAM that have the specified path prefix. If none exist, the operation returns an empty list.

You can paginate the results using the MaxItems and Marker parameters.

For more information about working with server certificates, see Working with Server Certificates in the IAM User Guide. This topic also includes a list of AWS services that can use the server certificates that you manage with IAM.

" - }, - "ListServiceSpecificCredentials":{ - "name":"ListServiceSpecificCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListServiceSpecificCredentialsRequest"}, - "output":{ - "shape":"ListServiceSpecificCredentialsResponse", - "resultWrapper":"ListServiceSpecificCredentialsResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceNotSupportedException"} - ], - "documentation":"

Returns information about the service-specific credentials associated with the specified IAM user. If there are none, the operation returns an empty list. The service-specific credentials returned by this operation are used only for authenticating the IAM user to a specific service. For more information about using service-specific credentials to authenticate to an AWS service, see Set Up service-specific credentials in the AWS CodeCommit User Guide.

" - }, - "ListSigningCertificates":{ - "name":"ListSigningCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSigningCertificatesRequest"}, - "output":{ - "shape":"ListSigningCertificatesResponse", - "resultWrapper":"ListSigningCertificatesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns information about the signing certificates associated with the specified IAM user. If there are none, the operation returns an empty list.

Although each user is limited to a small number of signing certificates, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the AWS access key ID used to sign the request for this API. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

" - }, - "ListUserPolicies":{ - "name":"ListUserPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUserPoliciesRequest"}, - "output":{ - "shape":"ListUserPoliciesResponse", - "resultWrapper":"ListUserPoliciesResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the names of the inline policies embedded in the specified IAM user.

An IAM user can also have managed policies attached to it. To list the managed policies that are attached to a user, use ListAttachedUserPolicies. For more information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. If there are no inline policies embedded with the specified user, the operation returns an empty list.

" - }, - "ListUsers":{ - "name":"ListUsers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUsersRequest"}, - "output":{ - "shape":"ListUsersResponse", - "resultWrapper":"ListUsersResult" - }, - "errors":[ - {"shape":"ServiceFailureException"} - ], - "documentation":"

Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation returns all users in the AWS account. If there are none, the operation returns an empty list.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "ListVirtualMFADevices":{ - "name":"ListVirtualMFADevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVirtualMFADevicesRequest"}, - "output":{ - "shape":"ListVirtualMFADevicesResponse", - "resultWrapper":"ListVirtualMFADevicesResult" - }, - "documentation":"

Lists the virtual MFA devices defined in the AWS account by assignment status. If you do not specify an assignment status, the operation returns a list of all virtual MFA devices. Assignment status can be Assigned, Unassigned, or Any.

You can paginate the results using the MaxItems and Marker parameters.

" - }, - "PutGroupPolicy":{ - "name":"PutGroupPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutGroupPolicyRequest"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds or updates an inline policy document that is embedded in the specified IAM group.

A user can also have managed policies attached to it. To attach a managed policy to a group, use AttachGroupPolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

For information about limits on the number of inline policies that you can embed in a group, see Limitations on IAM Entities in the IAM User Guide.

Because policy documents can be large, you should use POST rather than GET when calling PutGroupPolicy. For general information about using the Query API with IAM, go to Making Query Requests in the IAM User Guide.

" - }, - "PutRolePermissionsBoundary":{ - "name":"PutRolePermissionsBoundary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRolePermissionsBoundaryRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"PolicyNotAttachableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds or updates the policy that is specified as the IAM role's permissions boundary. You can use an AWS managed policy or a customer managed policy to set the boundary for a role. Use the boundary to control the maximum permissions that the role can have. Setting a permissions boundary is an advanced feature that can affect the permissions for the role.

You cannot set the boundary for a service-linked role.

Policies used as permissions boundaries do not provide permissions. You must also attach a permissions policy to the role. To learn how the effective permissions for a role are evaluated, see IAM JSON Policy Evaluation Logic in the IAM User Guide.

" - }, - "PutRolePolicy":{ - "name":"PutRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRolePolicyRequest"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds or updates an inline policy document that is embedded in the specified IAM role.

When you embed an inline policy in a role, the inline policy is used as part of the role's access (permissions) policy. The role's trust policy is created at the same time as the role, using CreateRole. You can update a role's trust policy using UpdateAssumeRolePolicy. For more information about IAM roles, go to Using Roles to Delegate Permissions and Federate Identities.

A role can also have a managed policy attached to it. To attach a managed policy to a role, use AttachRolePolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

For information about limits on the number of inline policies that you can embed with a role, see Limitations on IAM Entities in the IAM User Guide.

Because policy documents can be large, you should use POST rather than GET when calling PutRolePolicy. For general information about using the Query API with IAM, go to Making Query Requests in the IAM User Guide.

" - }, - "PutUserPermissionsBoundary":{ - "name":"PutUserPermissionsBoundary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutUserPermissionsBoundaryRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotAttachableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds or updates the policy that is specified as the IAM user's permissions boundary. You can use an AWS managed policy or a customer managed policy to set the boundary for a user. Use the boundary to control the maximum permissions that the user can have. Setting a permissions boundary is an advanced feature that can affect the permissions for the user.

Policies that are used as permissions boundaries do not provide permissions. You must also attach a permissions policy to the user. To learn how the effective permissions for a user are evaluated, see IAM JSON Policy Evaluation Logic in the IAM User Guide.

" - }, - "PutUserPolicy":{ - "name":"PutUserPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutUserPolicyRequest"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Adds or updates an inline policy document that is embedded in the specified IAM user.

An IAM user can also have a managed policy attached to it. To attach a managed policy to a user, use AttachUserPolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed Policies and Inline Policies in the IAM User Guide.

For information about limits on the number of inline policies that you can embed in a user, see Limitations on IAM Entities in the IAM User Guide.

Because policy documents can be large, you should use POST rather than GET when calling PutUserPolicy. For general information about using the Query API with IAM, go to Making Query Requests in the IAM User Guide.

" - }, - "RemoveClientIDFromOpenIDConnectProvider":{ - "name":"RemoveClientIDFromOpenIDConnectProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveClientIDFromOpenIDConnectProviderRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified client ID (also known as audience) from the list of client IDs registered for the specified IAM OpenID Connect (OIDC) provider resource object.

This operation is idempotent; it does not fail or return an error if you try to remove a client ID that does not exist.

" - }, - "RemoveRoleFromInstanceProfile":{ - "name":"RemoveRoleFromInstanceProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveRoleFromInstanceProfileRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified IAM role from the specified EC2 instance profile.

Make sure that you do not have any Amazon EC2 instances running with the role you are about to remove from the instance profile. Removing a role from an instance profile that is associated with a running instance might break any applications running on the instance.

For more information about IAM roles, go to Working with Roles. For more information about instance profiles, go to About Instance Profiles.

" - }, - "RemoveUserFromGroup":{ - "name":"RemoveUserFromGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveUserFromGroupRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Removes the specified user from the specified group.

" - }, - "ResetServiceSpecificCredential":{ - "name":"ResetServiceSpecificCredential", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetServiceSpecificCredentialRequest"}, - "output":{ - "shape":"ResetServiceSpecificCredentialResponse", - "resultWrapper":"ResetServiceSpecificCredentialResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Resets the password for a service-specific credential. The new password is AWS generated and cryptographically strong. It cannot be configured by the user. Resetting the password immediately invalidates the previous password associated with this user.

" - }, - "ResyncMFADevice":{ - "name":"ResyncMFADevice", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResyncMFADeviceRequest"}, - "errors":[ - {"shape":"InvalidAuthenticationCodeException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Synchronizes the specified MFA device with its IAM resource object on the AWS servers.

For more information about creating and working with virtual MFA devices, go to Using a Virtual MFA Device in the IAM User Guide.

" - }, - "SetDefaultPolicyVersion":{ - "name":"SetDefaultPolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetDefaultPolicyVersionRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Sets the specified version of the specified policy as the policy's default (operative) version.

This operation affects all users, groups, and roles that the policy is attached to. To list the users, groups, and roles that the policy is attached to, use the ListEntitiesForPolicy API.

For information about managed policies, see Managed Policies and Inline Policies in the IAM User Guide.

" - }, - "SimulateCustomPolicy":{ - "name":"SimulateCustomPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SimulateCustomPolicyRequest"}, - "output":{ - "shape":"SimulatePolicyResponse", - "resultWrapper":"SimulateCustomPolicyResult" - }, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"PolicyEvaluationException"} - ], - "documentation":"

Simulate how a set of IAM policies and optionally a resource-based policy works with a list of API operations and AWS resources to determine the policies' effective permissions. The policies are provided as strings.

The simulation does not perform the API operations; it only checks the authorization to determine if the simulated policies allow or deny the operations.

If you want to simulate existing policies attached to an IAM user, group, or role, use SimulatePrincipalPolicy instead.

Context keys are variables maintained by AWS and its services that provide details about the context of an API query request. You can use the Condition element of an IAM policy to evaluate context keys. To get the list of context keys that the policies require for correct simulation, use GetContextKeysForCustomPolicy.

If the output is long, you can use MaxItems and Marker parameters to paginate the results.

" - }, - "SimulatePrincipalPolicy":{ - "name":"SimulatePrincipalPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SimulatePrincipalPolicyRequest"}, - "output":{ - "shape":"SimulatePolicyResponse", - "resultWrapper":"SimulatePrincipalPolicyResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyEvaluationException"} - ], - "documentation":"

Simulate how a set of IAM policies attached to an IAM entity works with a list of API operations and AWS resources to determine the policies' effective permissions. The entity can be an IAM user, group, or role. If you specify a user, then the simulation also includes all of the policies that are attached to groups that the user belongs to.

You can optionally include a list of one or more additional policies specified as strings to include in the simulation. If you want to simulate only policies specified as strings, use SimulateCustomPolicy instead.

You can also optionally include one resource-based policy to be evaluated with each of the resources included in the simulation.

The simulation does not perform the API operations, it only checks the authorization to determine if the simulated policies allow or deny the operations.

Note: This API discloses information about the permissions granted to other users. If you do not want users to see other user's permissions, then consider allowing them to use SimulateCustomPolicy instead.

Context keys are variables maintained by AWS and its services that provide details about the context of an API query request. You can use the Condition element of an IAM policy to evaluate context keys. To get the list of context keys that the policies require for correct simulation, use GetContextKeysForPrincipalPolicy.

If the output is long, you can use the MaxItems and Marker parameters to paginate the results.

" - }, - "UpdateAccessKey":{ - "name":"UpdateAccessKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAccessKeyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Changes the status of the specified access key from Active to Inactive, or vice versa. This operation can be used to disable a user's key as part of a key rotation workflow.

If the UserName field is not specified, the user name is determined implicitly based on the AWS access key ID used to sign the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

For information about rotating keys, see Managing Keys and Certificates in the IAM User Guide.

" - }, - "UpdateAccountPasswordPolicy":{ - "name":"UpdateAccountPasswordPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAccountPasswordPolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the password policy settings for the AWS account.

  • This operation does not support partial updates. No parameters are required, but if you do not specify a parameter, that parameter's value reverts to its default value. See the Request Parameters section for each parameter's default value. Also note that some parameters do not allow the default parameter to be explicitly set. Instead, to invoke the default value, do not include that parameter when you invoke the operation.

For more information about using a password policy, see Managing an IAM Password Policy in the IAM User Guide.

" - }, - "UpdateAssumeRolePolicy":{ - "name":"UpdateAssumeRolePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAssumeRolePolicyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the policy that grants an IAM entity permission to assume a role. This is typically referred to as the \"role trust policy\". For more information about roles, go to Using Roles to Delegate Permissions and Federate Identities.

" - }, - "UpdateGroup":{ - "name":"UpdateGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGroupRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the name and/or the path of the specified IAM group.

You should understand the implications of changing a group's path or name. For more information, see Renaming Users and Groups in the IAM User Guide.

The person making the request (the principal), must have permission to change the role group with the old name and the new name. For example, to change the group named Managers to MGRs, the principal must have a policy that allows them to update both groups. If the principal has permission to update the Managers group, but not the MGRs group, then the update fails. For more information about permissions, see Access Management.

" - }, - "UpdateLoginProfile":{ - "name":"UpdateLoginProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateLoginProfileRequest"}, - "errors":[ - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"PasswordPolicyViolationException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Changes the password for the specified IAM user.

IAM users can change their own passwords by calling ChangePassword. For more information about modifying passwords, see Managing Passwords in the IAM User Guide.

" - }, - "UpdateOpenIDConnectProviderThumbprint":{ - "name":"UpdateOpenIDConnectProviderThumbprint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateOpenIDConnectProviderThumbprintRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Replaces the existing list of server certificate thumbprints associated with an OpenID Connect (OIDC) provider resource object with a new list of thumbprints.

The list that you pass with this operation completely replaces the existing list of thumbprints. (The lists are not merged.)

Typically, you need to update a thumbprint only when the identity provider's certificate changes, which occurs rarely. However, if the provider's certificate does change, any attempt to assume an IAM role that specifies the OIDC provider as a principal fails until the certificate thumbprint is updated.

Because trust for the OIDC provider is derived from the provider's certificate and is validated by the thumbprint, it is best to limit access to the UpdateOpenIDConnectProviderThumbprint operation to highly privileged users.

" - }, - "UpdateRole":{ - "name":"UpdateRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRoleRequest"}, - "output":{ - "shape":"UpdateRoleResponse", - "resultWrapper":"UpdateRoleResult" - }, - "errors":[ - {"shape":"UnmodifiableEntityException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the description or maximum session duration setting of a role.

" - }, - "UpdateRoleDescription":{ - "name":"UpdateRoleDescription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRoleDescriptionRequest"}, - "output":{ - "shape":"UpdateRoleDescriptionResponse", - "resultWrapper":"UpdateRoleDescriptionResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"UnmodifiableEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Use instead.

Modifies only the description of a role. This operation performs the same function as the Description parameter in the UpdateRole operation.

" - }, - "UpdateSAMLProvider":{ - "name":"UpdateSAMLProvider", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSAMLProviderRequest"}, - "output":{ - "shape":"UpdateSAMLProviderResponse", - "resultWrapper":"UpdateSAMLProviderResult" - }, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the metadata document for an existing SAML provider resource object.

This operation requires Signature Version 4.

" - }, - "UpdateSSHPublicKey":{ - "name":"UpdateSSHPublicKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSSHPublicKeyRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Sets the status of an IAM user's SSH public key to active or inactive. SSH public keys that are inactive cannot be used for authentication. This operation can be used to disable a user's SSH public key as part of a key rotation work flow.

The SSH public key affected by this operation is used only for authenticating the associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH Connections in the AWS CodeCommit User Guide.

" - }, - "UpdateServerCertificate":{ - "name":"UpdateServerCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServerCertificateRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the name and/or the path of the specified server certificate stored in IAM.

For more information about working with server certificates, see Working with Server Certificates in the IAM User Guide. This topic also includes a list of AWS services that can use the server certificates that you manage with IAM.

You should understand the implications of changing a server certificate's path or name. For more information, see Renaming a Server Certificate in the IAM User Guide.

The person making the request (the principal), must have permission to change the server certificate with the old name and the new name. For example, to change the certificate named ProductionCert to ProdCert, the principal must have a policy that allows them to update both certificates. If the principal has permission to update the ProductionCert group, but not the ProdCert certificate, then the update fails. For more information about permissions, see Access Management in the IAM User Guide.

" - }, - "UpdateServiceSpecificCredential":{ - "name":"UpdateServiceSpecificCredential", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServiceSpecificCredentialRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Sets the status of a service-specific credential to Active or Inactive. Service-specific credentials that are inactive cannot be used for authentication to the service. This operation can be used to disable a user's service-specific credential as part of a credential rotation work flow.

" - }, - "UpdateSigningCertificate":{ - "name":"UpdateSigningCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSigningCertificateRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Changes the status of the specified user signing certificate from active to disabled, or vice versa. This operation can be used to disable an IAM user's signing certificate as part of a certificate rotation work flow.

If the UserName field is not specified, the user name is determined implicitly based on the AWS access key ID used to sign the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

" - }, - "UpdateUser":{ - "name":"UpdateUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserRequest"}, - "errors":[ - {"shape":"NoSuchEntityException"}, - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"EntityTemporarilyUnmodifiableException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Updates the name and/or the path of the specified IAM user.

You should understand the implications of changing an IAM user's path or name. For more information, see Renaming an IAM User and Renaming an IAM Group in the IAM User Guide.

To change a user name, the requester must have appropriate permissions on both the source object and the target object. For example, to change Bob to Robert, the entity making the request must have permission on Bob and Robert, or must have permission on all (*). For more information about permissions, see Permissions and Policies.

" - }, - "UploadSSHPublicKey":{ - "name":"UploadSSHPublicKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UploadSSHPublicKeyRequest"}, - "output":{ - "shape":"UploadSSHPublicKeyResponse", - "resultWrapper":"UploadSSHPublicKeyResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidPublicKeyException"}, - {"shape":"DuplicateSSHPublicKeyException"}, - {"shape":"UnrecognizedPublicKeyEncodingException"} - ], - "documentation":"

Uploads an SSH public key and associates it with the specified IAM user.

The SSH public key uploaded by this operation can be used only for authenticating the associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH Connections in the AWS CodeCommit User Guide.

" - }, - "UploadServerCertificate":{ - "name":"UploadServerCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UploadServerCertificateRequest"}, - "output":{ - "shape":"UploadServerCertificateResponse", - "resultWrapper":"UploadServerCertificateResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"MalformedCertificateException"}, - {"shape":"KeyPairMismatchException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Uploads a server certificate entity for the AWS account. The server certificate entity includes a public key certificate, a private key, and an optional certificate chain, which should all be PEM-encoded.

We recommend that you use AWS Certificate Manager to provision, manage, and deploy your server certificates. With ACM you can request a certificate, deploy it to AWS resources, and let ACM handle certificate renewals for you. Certificates provided by ACM are free. For more information about using ACM, see the AWS Certificate Manager User Guide.

For more information about working with server certificates, see Working with Server Certificates in the IAM User Guide. This topic includes a list of AWS services that can use the server certificates that you manage with IAM.

For information about the number of server certificates you can upload, see Limitations on IAM Entities and Objects in the IAM User Guide.

Because the body of the public key certificate, private key, and the certificate chain can be large, you should use POST rather than GET when calling UploadServerCertificate. For information about setting up signatures and authorization through the API, go to Signing AWS API Requests in the AWS General Reference. For general information about using the Query API with IAM, go to Calling the API by Making HTTP Query Requests in the IAM User Guide.

" - }, - "UploadSigningCertificate":{ - "name":"UploadSigningCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UploadSigningCertificateRequest"}, - "output":{ - "shape":"UploadSigningCertificateResponse", - "resultWrapper":"UploadSigningCertificateResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"MalformedCertificateException"}, - {"shape":"InvalidCertificateException"}, - {"shape":"DuplicateCertificateException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Uploads an X.509 signing certificate and associates it with the specified IAM user. Some AWS services use X.509 signing certificates to validate requests that are signed with a corresponding private key. When you upload the certificate, its default status is Active.

If the UserName field is not specified, the IAM user name is determined implicitly based on the AWS access key ID used to sign the request. Because this operation works for access keys under the AWS account, you can use this operation to manage AWS account root user credentials even if the AWS account has no associated users.

Because the body of an X.509 certificate can be large, you should use POST rather than GET when calling UploadSigningCertificate. For information about setting up signatures and authorization through the API, go to Signing AWS API Requests in the AWS General Reference. For general information about using the Query API with IAM, go to Making Query Requests in the IAM User Guide.

" - } - }, - "shapes":{ - "AccessKey":{ - "type":"structure", - "required":[ - "UserName", - "AccessKeyId", - "Status", - "SecretAccessKey" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user that the access key is associated with.

" - }, - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The ID for this access key.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the access key. Active means that the key is valid for API calls, while Inactive means it is not.

" - }, - "SecretAccessKey":{ - "shape":"accessKeySecretType", - "documentation":"

The secret key used to sign requests.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date when the access key was created.

" - } - }, - "documentation":"

Contains information about an AWS access key.

This data type is used as a response element in the CreateAccessKey and ListAccessKeys operations.

The SecretAccessKey value is returned only in response to CreateAccessKey. You can get a secret access key only when you first create an access key; you cannot recover the secret access key later. If you lose a secret access key, you must create a new access key.

" - }, - "AccessKeyLastUsed":{ - "type":"structure", - "required":[ - "LastUsedDate", - "ServiceName", - "Region" - ], - "members":{ - "LastUsedDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the access key was most recently used. This field is null in the following situations:

  • The user does not have an access key.

  • An access key exists but has never been used, at least not since IAM started tracking this information on April 22nd, 2015.

  • There is no sign-in data associated with the user

" - }, - "ServiceName":{ - "shape":"stringType", - "documentation":"

The name of the AWS service with which this access key was most recently used. This field displays \"N/A\" in the following situations:

  • The user does not have an access key.

  • An access key exists but has never been used, at least not since IAM started tracking this information on April 22nd, 2015.

  • There is no sign-in data associated with the user

" - }, - "Region":{ - "shape":"stringType", - "documentation":"

The AWS region where this access key was most recently used. This field is displays \"N/A\" in the following situations:

  • The user does not have an access key.

  • An access key exists but has never been used, at least not since IAM started tracking this information on April 22nd, 2015.

  • There is no sign-in data associated with the user

For more information about AWS regions, see Regions and Endpoints in the Amazon Web Services General Reference.

" - } - }, - "documentation":"

Contains information about the last time an AWS access key was used.

This data type is used as a response element in the GetAccessKeyLastUsed operation.

" - }, - "AccessKeyMetadata":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user that the key is associated with.

" - }, - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The ID for this access key.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the access key. Active means the key is valid for API calls; Inactive means it is not.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date when the access key was created.

" - } - }, - "documentation":"

Contains information about an AWS access key, without its secret key.

This data type is used as a response element in the ListAccessKeys operation.

" - }, - "ActionNameListType":{ - "type":"list", - "member":{"shape":"ActionNameType"} - }, - "ActionNameType":{ - "type":"string", - "max":128, - "min":3 - }, - "AddClientIDToOpenIDConnectProviderRequest":{ - "type":"structure", - "required":[ - "OpenIDConnectProviderArn", - "ClientID" - ], - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM OpenID Connect (OIDC) provider resource to add the client ID to. You can get a list of OIDC provider ARNs by using the ListOpenIDConnectProviders operation.

" - }, - "ClientID":{ - "shape":"clientIDType", - "documentation":"

The client ID (also known as audience) to add to the IAM OpenID Connect provider resource.

" - } - } - }, - "AddRoleToInstanceProfileRequest":{ - "type":"structure", - "required":[ - "InstanceProfileName", - "RoleName" - ], - "members":{ - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name of the instance profile to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to add.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "AddUserToGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserName" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to add.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "ArnListType":{ - "type":"list", - "member":{"shape":"arnType"} - }, - "AttachGroupPolicyRequest":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyArn" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name (friendly name, not ARN) of the group to attach the policy to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to attach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "AttachRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyArn" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) of the role to attach the policy to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to attach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "AttachUserPolicyRequest":{ - "type":"structure", - "required":[ - "UserName", - "PolicyArn" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM user to attach the policy to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to attach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "AttachedPermissionsBoundary":{ - "type":"structure", - "members":{ - "PermissionsBoundaryType":{ - "shape":"PermissionsBoundaryAttachmentType", - "documentation":"

The permissions boundary usage type that indicates what type of IAM resource is used as the permissions boundary for an entity. This data type can only have a value of Policy.

" - }, - "PermissionsBoundaryArn":{ - "shape":"arnType", - "documentation":"

The ARN of the policy used to set the permissions boundary for the user or role.

" - } - }, - "documentation":"

Contains information about an attached permissions boundary.

An attached permissions boundary is a managed policy that has been attached to a user or role to set the permissions boundary.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - }, - "AttachedPolicy":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The friendly name of the attached policy.

" - }, - "PolicyArn":{"shape":"arnType"} - }, - "documentation":"

Contains information about an attached policy.

An attached policy is a managed policy that has been attached to a user, group, or role. This data type is used as a response element in the ListAttachedGroupPolicies, ListAttachedRolePolicies, ListAttachedUserPolicies, and GetAccountAuthorizationDetails operations.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "BootstrapDatum":{ - "type":"blob", - "sensitive":true - }, - "ChangePasswordRequest":{ - "type":"structure", - "required":[ - "OldPassword", - "NewPassword" - ], - "members":{ - "OldPassword":{ - "shape":"passwordType", - "documentation":"

The IAM user's current password.

" - }, - "NewPassword":{ - "shape":"passwordType", - "documentation":"

The new password. The new password must conform to the AWS account's password policy, if one exists.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the AWS Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

" - } - } - }, - "ColumnNumber":{"type":"integer"}, - "ContextEntry":{ - "type":"structure", - "members":{ - "ContextKeyName":{ - "shape":"ContextKeyNameType", - "documentation":"

The full name of a condition context key, including the service prefix. For example, aws:SourceIp or s3:VersionId.

" - }, - "ContextKeyValues":{ - "shape":"ContextKeyValueListType", - "documentation":"

The value (or values, if the condition context key supports multiple values) to provide to the simulation when the key is referenced by a Condition element in an input policy.

" - }, - "ContextKeyType":{ - "shape":"ContextKeyTypeEnum", - "documentation":"

The data type of the value (or values) specified in the ContextKeyValues parameter.

" - } - }, - "documentation":"

Contains information about a condition context key. It includes the name of the key and specifies the value (or values, if the context key supports multiple values) to use in the simulation. This information is used when evaluating the Condition elements of the input policies.

This data type is used as an input parameter to SimulateCustomPolicy and SimulateCustomPolicy .

" - }, - "ContextEntryListType":{ - "type":"list", - "member":{"shape":"ContextEntry"} - }, - "ContextKeyNameType":{ - "type":"string", - "max":256, - "min":5 - }, - "ContextKeyNamesResultListType":{ - "type":"list", - "member":{"shape":"ContextKeyNameType"} - }, - "ContextKeyTypeEnum":{ - "type":"string", - "enum":[ - "string", - "stringList", - "numeric", - "numericList", - "boolean", - "booleanList", - "ip", - "ipList", - "binary", - "binaryList", - "date", - "dateList" - ] - }, - "ContextKeyValueListType":{ - "type":"list", - "member":{"shape":"ContextKeyValueType"} - }, - "ContextKeyValueType":{"type":"string"}, - "CreateAccessKeyRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the IAM user that the new key will belong to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "CreateAccessKeyResponse":{ - "type":"structure", - "required":["AccessKey"], - "members":{ - "AccessKey":{ - "shape":"AccessKey", - "documentation":"

A structure with details about the access key.

" - } - }, - "documentation":"

Contains the response to a successful CreateAccessKey request.

" - }, - "CreateAccountAliasRequest":{ - "type":"structure", - "required":["AccountAlias"], - "members":{ - "AccountAlias":{ - "shape":"accountAliasType", - "documentation":"

The account alias to create.

This parameter allows (per its regex pattern) a string of characters consisting of lowercase letters, digits, and dashes. You cannot start or finish with a dash, nor can you have two dashes in a row.

" - } - } - }, - "CreateGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the group. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group to create. Do not include the path in this value.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-. The group name must be unique within the account. Group names are not distinguished by case. For example, you cannot create groups named both \"ADMINS\" and \"admins\".

" - } - } - }, - "CreateGroupResponse":{ - "type":"structure", - "required":["Group"], - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

A structure containing details about the new group.

" - } - }, - "documentation":"

Contains the response to a successful CreateGroup request.

" - }, - "CreateInstanceProfileRequest":{ - "type":"structure", - "required":["InstanceProfileName"], - "members":{ - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name of the instance profile to create.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Path":{ - "shape":"pathType", - "documentation":"

The path to the instance profile. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - } - } - }, - "CreateInstanceProfileResponse":{ - "type":"structure", - "required":["InstanceProfile"], - "members":{ - "InstanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

A structure containing details about the new instance profile.

" - } - }, - "documentation":"

Contains the response to a successful CreateInstanceProfile request.

" - }, - "CreateLoginProfileRequest":{ - "type":"structure", - "required":[ - "UserName", - "Password" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user to create a password for. The user must already exist.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Password":{ - "shape":"passwordType", - "documentation":"

The new password for the user.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the AWS Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

" - }, - "PasswordResetRequired":{ - "shape":"booleanType", - "documentation":"

Specifies whether the user is required to set a new password on next sign-in.

" - } - } - }, - "CreateLoginProfileResponse":{ - "type":"structure", - "required":["LoginProfile"], - "members":{ - "LoginProfile":{ - "shape":"LoginProfile", - "documentation":"

A structure containing the user name and password create date.

" - } - }, - "documentation":"

Contains the response to a successful CreateLoginProfile request.

" - }, - "CreateOpenIDConnectProviderRequest":{ - "type":"structure", - "required":[ - "Url", - "ThumbprintList" - ], - "members":{ - "Url":{ - "shape":"OpenIDConnectProviderUrlType", - "documentation":"

The URL of the identity provider. The URL must begin with https:// and should correspond to the iss claim in the provider's OpenID Connect ID tokens. Per the OIDC standard, path components are allowed but query parameters are not. Typically the URL consists of only a hostname, like https://server.example.org or https://example.com.

You cannot register the same provider multiple times in a single AWS account. If you try to submit a URL that has already been used for an OpenID Connect provider in the AWS account, you will get an error.

" - }, - "ClientIDList":{ - "shape":"clientIDListType", - "documentation":"

A list of client IDs (also known as audiences). When a mobile or web app registers with an OpenID Connect provider, they establish a value that identifies the application. (This is the value that's sent as the client_id parameter on OAuth requests.)

You can register multiple client IDs with the same provider. For example, you might have multiple applications that use the same OIDC provider. You cannot register more than 100 client IDs with a single IAM OIDC provider.

There is no defined format for a client ID. The CreateOpenIDConnectProviderRequest operation accepts client IDs up to 255 characters long.

" - }, - "ThumbprintList":{ - "shape":"thumbprintListType", - "documentation":"

A list of server certificate thumbprints for the OpenID Connect (OIDC) identity provider's server certificates. Typically this list includes only one entry. However, IAM lets you have up to five thumbprints for an OIDC provider. This lets you maintain multiple thumbprints if the identity provider is rotating certificates.

The server certificate thumbprint is the hex-encoded SHA-1 hash value of the X.509 certificate used by the domain where the OpenID Connect provider makes its keys available. It is always a 40-character string.

You must provide at least one thumbprint when creating an IAM OIDC provider. For example, assume that the OIDC provider is server.example.com and the provider stores its keys at https://keys.server.example.com/openid-connect. In that case, the thumbprint string would be the hex-encoded SHA-1 hash value of the certificate used by https://keys.server.example.com.

For more information about obtaining the OIDC provider's thumbprint, see Obtaining the Thumbprint for an OpenID Connect Provider in the IAM User Guide.

" - } - } - }, - "CreateOpenIDConnectProviderResponse":{ - "type":"structure", - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the new IAM OpenID Connect provider that is created. For more information, see OpenIDConnectProviderListEntry.

" - } - }, - "documentation":"

Contains the response to a successful CreateOpenIDConnectProvider request.

" - }, - "CreatePolicyRequest":{ - "type":"structure", - "required":[ - "PolicyName", - "PolicyDocument" - ], - "members":{ - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The friendly name of the policy.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Path":{ - "shape":"policyPathType", - "documentation":"

The path for the policy.

For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The JSON policy document that you want to use as the content for the new policy.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "Description":{ - "shape":"policyDescriptionType", - "documentation":"

A friendly description of the policy.

Typically used to store information about the permissions defined in the policy. For example, \"Grants access to production DynamoDB tables.\"

The policy description is immutable. After a value is assigned, it cannot be changed.

" - } - } - }, - "CreatePolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

A structure containing details about the new policy.

" - } - }, - "documentation":"

Contains the response to a successful CreatePolicy request.

" - }, - "CreatePolicyVersionRequest":{ - "type":"structure", - "required":[ - "PolicyArn", - "PolicyDocument" - ], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy to which you want to add a new version.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The JSON policy document that you want to use as the content for this new version of the policy.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "SetAsDefault":{ - "shape":"booleanType", - "documentation":"

Specifies whether to set this version as the policy's default version.

When this parameter is true, the new policy version becomes the operative version. That is, it becomes the version that is in effect for the IAM users, groups, and roles that the policy is attached to.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - } - } - }, - "CreatePolicyVersionResponse":{ - "type":"structure", - "members":{ - "PolicyVersion":{ - "shape":"PolicyVersion", - "documentation":"

A structure containing details about the new policy version.

" - } - }, - "documentation":"

Contains the response to a successful CreatePolicyVersion request.

" - }, - "CreateRoleRequest":{ - "type":"structure", - "required":[ - "RoleName", - "AssumeRolePolicyDocument" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the role. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to create.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Role names are not distinguished by case. For example, you cannot create roles named both \"PRODROLE\" and \"prodrole\".

" - }, - "AssumeRolePolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The trust relationship policy document that grants an entity permission to assume the role.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "Description":{ - "shape":"roleDescriptionType", - "documentation":"

A description of the role.

" - }, - "MaxSessionDuration":{ - "shape":"roleMaxSessionDurationType", - "documentation":"

The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.

Anyone who assumes the role from the AWS CLI or API can use the DurationSeconds API parameter or the duration-seconds CLI parameter to request a longer session. The MaxSessionDuration setting determines the maximum duration that can be requested using the DurationSeconds parameter. If users don't specify a value for the DurationSeconds parameter, their security credentials are valid for one hour by default. This applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide.

" - }, - "PermissionsBoundary":{ - "shape":"arnType", - "documentation":"

The ARN of the policy that is used to set the permissions boundary for the role.

" - } - } - }, - "CreateRoleResponse":{ - "type":"structure", - "required":["Role"], - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

A structure containing details about the new role.

" - } - }, - "documentation":"

Contains the response to a successful CreateRole request.

" - }, - "CreateSAMLProviderRequest":{ - "type":"structure", - "required":[ - "SAMLMetadataDocument", - "Name" - ], - "members":{ - "SAMLMetadataDocument":{ - "shape":"SAMLMetadataDocumentType", - "documentation":"

An XML document generated by an identity provider (IdP) that supports SAML 2.0. The document includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that are received from the IdP. You must generate the metadata document using the identity management software that is used as your organization's IdP.

For more information, see About SAML 2.0-based Federation in the IAM User Guide

" - }, - "Name":{ - "shape":"SAMLProviderNameType", - "documentation":"

The name of the provider to create.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "CreateSAMLProviderResponse":{ - "type":"structure", - "members":{ - "SAMLProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the new SAML provider resource in IAM.

" - } - }, - "documentation":"

Contains the response to a successful CreateSAMLProvider request.

" - }, - "CreateServiceLinkedRoleRequest":{ - "type":"structure", - "required":["AWSServiceName"], - "members":{ - "AWSServiceName":{ - "shape":"groupNameType", - "documentation":"

The AWS service to which this role is attached. You use a string similar to a URL but without the http:// in front. For example: elasticbeanstalk.amazonaws.com

" - }, - "Description":{ - "shape":"roleDescriptionType", - "documentation":"

The description of the role.

" - }, - "CustomSuffix":{ - "shape":"customSuffixType", - "documentation":"

A string that you provide, which is combined with the service name to form the complete role name. If you make multiple requests for the same service, then you must supply a different CustomSuffix for each request. Otherwise the request fails with a duplicate role name error. For example, you could add -1 or -debug to the suffix.

" - } - } - }, - "CreateServiceLinkedRoleResponse":{ - "type":"structure", - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

A Role object that contains details about the newly created role.

" - } - } - }, - "CreateServiceSpecificCredentialRequest":{ - "type":"structure", - "required":[ - "UserName", - "ServiceName" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user that is to be associated with the credentials. The new service-specific credentials have the same permissions as the associated user except that they can be used only to access the specified service.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "ServiceName":{ - "shape":"serviceName", - "documentation":"

The name of the AWS service that is to be associated with the credentials. The service you specify here is the only service that can be accessed using these credentials.

" - } - } - }, - "CreateServiceSpecificCredentialResponse":{ - "type":"structure", - "members":{ - "ServiceSpecificCredential":{ - "shape":"ServiceSpecificCredential", - "documentation":"

A structure that contains information about the newly created service-specific credential.

This is the only time that the password for this credential set is available. It cannot be recovered later. Instead, you will have to reset the password with ResetServiceSpecificCredential.

" - } - } - }, - "CreateUserRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path for the user name. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user to create.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-. User names are not distinguished by case. For example, you cannot create users named both \"TESTUSER\" and \"testuser\".

" - }, - "PermissionsBoundary":{ - "shape":"arnType", - "documentation":"

The ARN of the policy that is used to set the permissions boundary for the user.

" - } - } - }, - "CreateUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

A structure with details about the new IAM user.

" - } - }, - "documentation":"

Contains the response to a successful CreateUser request.

" - }, - "CreateVirtualMFADeviceRequest":{ - "type":"structure", - "required":["VirtualMFADeviceName"], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path for the virtual MFA device. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "VirtualMFADeviceName":{ - "shape":"virtualMFADeviceName", - "documentation":"

The name of the virtual MFA device. Use with path to uniquely identify a virtual MFA device.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "CreateVirtualMFADeviceResponse":{ - "type":"structure", - "required":["VirtualMFADevice"], - "members":{ - "VirtualMFADevice":{ - "shape":"VirtualMFADevice", - "documentation":"

A structure containing details about the new virtual MFA device.

" - } - }, - "documentation":"

Contains the response to a successful CreateVirtualMFADevice request.

" - }, - "CredentialReportExpiredException":{ - "type":"structure", - "members":{ - "message":{"shape":"credentialReportExpiredExceptionMessage"} - }, - "documentation":"

The request was rejected because the most recent credential report has expired. To generate a new credential report, use GenerateCredentialReport. For more information about credential report expiration, see Getting Credential Reports in the IAM User Guide.

", - "error":{ - "code":"ReportExpired", - "httpStatusCode":410, - "senderFault":true - }, - "exception":true - }, - "CredentialReportNotPresentException":{ - "type":"structure", - "members":{ - "message":{"shape":"credentialReportNotPresentExceptionMessage"} - }, - "documentation":"

The request was rejected because the credential report does not exist. To generate a credential report, use GenerateCredentialReport.

", - "error":{ - "code":"ReportNotPresent", - "httpStatusCode":410, - "senderFault":true - }, - "exception":true - }, - "CredentialReportNotReadyException":{ - "type":"structure", - "members":{ - "message":{"shape":"credentialReportNotReadyExceptionMessage"} - }, - "documentation":"

The request was rejected because the credential report is still being generated.

", - "error":{ - "code":"ReportInProgress", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DeactivateMFADeviceRequest":{ - "type":"structure", - "required":[ - "UserName", - "SerialNumber" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user whose MFA device you want to deactivate.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the device ARN.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@:/-

" - } - } - }, - "DeleteAccessKeyRequest":{ - "type":"structure", - "required":["AccessKeyId"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user whose access key pair you want to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The access key ID for the access key ID and secret access key you want to delete.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - } - } - }, - "DeleteAccountAliasRequest":{ - "type":"structure", - "required":["AccountAlias"], - "members":{ - "AccountAlias":{ - "shape":"accountAliasType", - "documentation":"

The name of the account alias to delete.

This parameter allows (per its regex pattern) a string of characters consisting of lowercase letters, digits, and dashes. You cannot start or finish with a dash, nor can you have two dashes in a row.

" - } - } - }, - "DeleteConflictException":{ - "type":"structure", - "members":{ - "message":{"shape":"deleteConflictMessage"} - }, - "documentation":"

The request was rejected because it attempted to delete a resource that has attached subordinate entities. The error message describes these entities.

", - "error":{ - "code":"DeleteConflict", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "DeleteGroupPolicyRequest":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyName" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name (friendly name, not ARN) identifying the group that the policy is embedded in.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name identifying the policy document to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the IAM group to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteInstanceProfileRequest":{ - "type":"structure", - "required":["InstanceProfileName"], - "members":{ - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name of the instance profile to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteLoginProfileRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user whose password you want to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteOpenIDConnectProviderRequest":{ - "type":"structure", - "required":["OpenIDConnectProviderArn"], - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM OpenID Connect provider resource object to delete. You can get a list of OpenID Connect provider resource ARNs by using the ListOpenIDConnectProviders operation.

" - } - } - }, - "DeletePolicyRequest":{ - "type":"structure", - "required":["PolicyArn"], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to delete.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "DeletePolicyVersionRequest":{ - "type":"structure", - "required":[ - "PolicyArn", - "VersionId" - ], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy from which you want to delete a version.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "VersionId":{ - "shape":"policyVersionIdType", - "documentation":"

The policy version to delete.

This parameter allows (per its regex pattern) a string of characters that consists of the lowercase letter 'v' followed by one or two digits, and optionally followed by a period '.' and a string of letters and digits.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - } - } - }, - "DeleteRolePermissionsBoundaryRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM role from which you want to remove the permissions boundary.

" - } - } - }, - "DeleteRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyName" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) identifying the role that the policy is embedded in.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the inline policy to delete from the specified IAM role.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteSAMLProviderRequest":{ - "type":"structure", - "required":["SAMLProviderArn"], - "members":{ - "SAMLProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider to delete.

" - } - } - }, - "DeleteSSHPublicKeyRequest":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyId" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the SSH public key.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SSHPublicKeyId":{ - "shape":"publicKeyIdType", - "documentation":"

The unique identifier for the SSH public key.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - } - } - }, - "DeleteServerCertificateRequest":{ - "type":"structure", - "required":["ServerCertificateName"], - "members":{ - "ServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The name of the server certificate you want to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteServiceLinkedRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the service-linked role to be deleted.

" - } - } - }, - "DeleteServiceLinkedRoleResponse":{ - "type":"structure", - "required":["DeletionTaskId"], - "members":{ - "DeletionTaskId":{ - "shape":"DeletionTaskIdType", - "documentation":"

The deletion task identifier that you can use to check the status of the deletion. This identifier is returned in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.

" - } - } - }, - "DeleteServiceSpecificCredentialRequest":{ - "type":"structure", - "required":["ServiceSpecificCredentialId"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the service-specific credential. If this value is not specified, then the operation assumes the user whose credentials are used to call the operation.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "ServiceSpecificCredentialId":{ - "shape":"serviceSpecificCredentialId", - "documentation":"

The unique identifier of the service-specific credential. You can get this value by calling ListServiceSpecificCredentials.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - } - } - }, - "DeleteSigningCertificateRequest":{ - "type":"structure", - "required":["CertificateId"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user the signing certificate belongs to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "CertificateId":{ - "shape":"certificateIdType", - "documentation":"

The ID of the signing certificate to delete.

The format of this parameter, as described by its regex pattern, is a string of characters that can be upper- or lower-cased letters or digits.

" - } - } - }, - "DeleteUserPermissionsBoundaryRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM user from which you want to remove the permissions boundary.

" - } - } - }, - "DeleteUserPolicyRequest":{ - "type":"structure", - "required":[ - "UserName", - "PolicyName" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name (friendly name, not ARN) identifying the user that the policy is embedded in.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name identifying the policy document to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteUserRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to delete.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "DeleteVirtualMFADeviceRequest":{ - "type":"structure", - "required":["SerialNumber"], - "members":{ - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the same as the ARN.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@:/-

" - } - } - }, - "DeletionTaskFailureReasonType":{ - "type":"structure", - "members":{ - "Reason":{ - "shape":"ReasonType", - "documentation":"

A short description of the reason that the service-linked role deletion failed.

" - }, - "RoleUsageList":{ - "shape":"RoleUsageListType", - "documentation":"

A list of objects that contains details about the service-linked role deletion failure, if that information is returned by the service. If the service-linked role has active sessions or if any resources that were used by the role have not been deleted from the linked service, the role can't be deleted. This parameter includes a list of the resources that are associated with the role and the region in which the resources are being used.

" - } - }, - "documentation":"

The reason that the service-linked role deletion failed.

This data type is used as a response element in the GetServiceLinkedRoleDeletionStatus operation.

" - }, - "DeletionTaskIdType":{ - "type":"string", - "max":1000, - "min":1 - }, - "DeletionTaskStatusType":{ - "type":"string", - "enum":[ - "SUCCEEDED", - "IN_PROGRESS", - "FAILED", - "NOT_STARTED" - ] - }, - "DetachGroupPolicyRequest":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyArn" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM group to detach the policy from.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to detach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "DetachRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyArn" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM role to detach the policy from.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to detach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "DetachUserPolicyRequest":{ - "type":"structure", - "required":[ - "UserName", - "PolicyArn" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM user to detach the policy from.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy you want to detach.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "DuplicateCertificateException":{ - "type":"structure", - "members":{ - "message":{"shape":"duplicateCertificateMessage"} - }, - "documentation":"

The request was rejected because the same certificate is associated with an IAM user in the account.

", - "error":{ - "code":"DuplicateCertificate", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "DuplicateSSHPublicKeyException":{ - "type":"structure", - "members":{ - "message":{"shape":"duplicateSSHPublicKeyMessage"} - }, - "documentation":"

The request was rejected because the SSH public key is already associated with the specified IAM user.

", - "error":{ - "code":"DuplicateSSHPublicKey", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EnableMFADeviceRequest":{ - "type":"structure", - "required":[ - "UserName", - "SerialNumber", - "AuthenticationCode1", - "AuthenticationCode2" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the IAM user for whom you want to enable the MFA device.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the device ARN.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@:/-

" - }, - "AuthenticationCode1":{ - "shape":"authenticationCodeType", - "documentation":"

An authentication code emitted by the device.

The format for this parameter is a string of six digits.

Submit your request immediately after generating the authentication codes. If you generate the codes and then wait too long to submit the request, the MFA device successfully associates with the user but the MFA device becomes out of sync. This happens because time-based one-time passwords (TOTP) expire after a short period of time. If this happens, you can resync the device.

" - }, - "AuthenticationCode2":{ - "shape":"authenticationCodeType", - "documentation":"

A subsequent authentication code emitted by the device.

The format for this parameter is a string of six digits.

Submit your request immediately after generating the authentication codes. If you generate the codes and then wait too long to submit the request, the MFA device successfully associates with the user but the MFA device becomes out of sync. This happens because time-based one-time passwords (TOTP) expire after a short period of time. If this happens, you can resync the device.

" - } - } - }, - "EntityAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"entityAlreadyExistsMessage"} - }, - "documentation":"

The request was rejected because it attempted to create a resource that already exists.

", - "error":{ - "code":"EntityAlreadyExists", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "EntityTemporarilyUnmodifiableException":{ - "type":"structure", - "members":{ - "message":{"shape":"entityTemporarilyUnmodifiableMessage"} - }, - "documentation":"

The request was rejected because it referenced an entity that is temporarily unmodifiable, such as a user name that was deleted and then recreated. The error indicates that the request is likely to succeed if you try again after waiting several minutes. The error message describes the entity.

", - "error":{ - "code":"EntityTemporarilyUnmodifiable", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "EntityType":{ - "type":"string", - "enum":[ - "User", - "Role", - "Group", - "LocalManagedPolicy", - "AWSManagedPolicy" - ] - }, - "EvalDecisionDetailsType":{ - "type":"map", - "key":{"shape":"EvalDecisionSourceType"}, - "value":{"shape":"PolicyEvaluationDecisionType"} - }, - "EvalDecisionSourceType":{ - "type":"string", - "max":256, - "min":3 - }, - "EvaluationResult":{ - "type":"structure", - "required":[ - "EvalActionName", - "EvalDecision" - ], - "members":{ - "EvalActionName":{ - "shape":"ActionNameType", - "documentation":"

The name of the API operation tested on the indicated resource.

" - }, - "EvalResourceName":{ - "shape":"ResourceNameType", - "documentation":"

The ARN of the resource that the indicated API operation was tested on.

" - }, - "EvalDecision":{ - "shape":"PolicyEvaluationDecisionType", - "documentation":"

The result of the simulation.

" - }, - "MatchedStatements":{ - "shape":"StatementListType", - "documentation":"

A list of the statements in the input policies that determine the result for this scenario. Remember that even if multiple statements allow the operation on the resource, if only one statement denies that operation, then the explicit deny overrides any allow, and the deny statement is the only entry included in the result.

" - }, - "MissingContextValues":{ - "shape":"ContextKeyNamesResultListType", - "documentation":"

A list of context keys that are required by the included input policies but that were not provided by one of the input parameters. This list is used when the resource in a simulation is \"*\", either explicitly, or when the ResourceArns parameter blank. If you include a list of resources, then any missing context values are instead included under the ResourceSpecificResults section. To discover the context keys used by a set of policies, you can call GetContextKeysForCustomPolicy or GetContextKeysForPrincipalPolicy.

" - }, - "OrganizationsDecisionDetail":{ - "shape":"OrganizationsDecisionDetail", - "documentation":"

A structure that details how AWS Organizations and its service control policies affect the results of the simulation. Only applies if the simulated user's account is part of an organization.

" - }, - "EvalDecisionDetails":{ - "shape":"EvalDecisionDetailsType", - "documentation":"

Additional details about the results of the evaluation decision. When there are both IAM policies and resource policies, this parameter explains how each set of policies contributes to the final evaluation decision. When simulating cross-account access to a resource, both the resource-based policy and the caller's IAM policy must grant access. See How IAM Roles Differ from Resource-based Policies

" - }, - "ResourceSpecificResults":{ - "shape":"ResourceSpecificResultListType", - "documentation":"

The individual results of the simulation of the API operation specified in EvalActionName on each resource.

" - } - }, - "documentation":"

Contains the results of a simulation.

This data type is used by the return parameter of SimulateCustomPolicy and SimulatePrincipalPolicy .

" - }, - "EvaluationResultsListType":{ - "type":"list", - "member":{"shape":"EvaluationResult"} - }, - "GenerateCredentialReportResponse":{ - "type":"structure", - "members":{ - "State":{ - "shape":"ReportStateType", - "documentation":"

Information about the state of the credential report.

" - }, - "Description":{ - "shape":"ReportStateDescriptionType", - "documentation":"

Information about the credential report.

" - } - }, - "documentation":"

Contains the response to a successful GenerateCredentialReport request.

" - }, - "GetAccessKeyLastUsedRequest":{ - "type":"structure", - "required":["AccessKeyId"], - "members":{ - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The identifier of an access key.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - } - } - }, - "GetAccessKeyLastUsedResponse":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the AWS IAM user that owns this access key.

" - }, - "AccessKeyLastUsed":{ - "shape":"AccessKeyLastUsed", - "documentation":"

Contains information about the last time the access key was used.

" - } - }, - "documentation":"

Contains the response to a successful GetAccessKeyLastUsed request. It is also returned as a member of the AccessKeyMetaData structure returned by the ListAccessKeys action.

" - }, - "GetAccountAuthorizationDetailsRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"entityListType", - "documentation":"

A list of entity types used to filter the results. Only the entities that match the types you specify are included in the output. Use the value LocalManagedPolicy to include customer managed policies.

The format for this parameter is a comma-separated (if more than one) list of strings. Each string value in the list must be one of the valid values listed below.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - } - } - }, - "GetAccountAuthorizationDetailsResponse":{ - "type":"structure", - "members":{ - "UserDetailList":{ - "shape":"userDetailListType", - "documentation":"

A list containing information about IAM users.

" - }, - "GroupDetailList":{ - "shape":"groupDetailListType", - "documentation":"

A list containing information about IAM groups.

" - }, - "RoleDetailList":{ - "shape":"roleDetailListType", - "documentation":"

A list containing information about IAM roles.

" - }, - "Policies":{ - "shape":"ManagedPolicyDetailListType", - "documentation":"

A list containing information about managed policies.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful GetAccountAuthorizationDetails request.

" - }, - "GetAccountPasswordPolicyResponse":{ - "type":"structure", - "required":["PasswordPolicy"], - "members":{ - "PasswordPolicy":{ - "shape":"PasswordPolicy", - "documentation":"

A structure that contains details about the account's password policy.

" - } - }, - "documentation":"

Contains the response to a successful GetAccountPasswordPolicy request.

" - }, - "GetAccountSummaryResponse":{ - "type":"structure", - "members":{ - "SummaryMap":{ - "shape":"summaryMapType", - "documentation":"

A set of key value pairs containing information about IAM entity usage and IAM quotas.

" - } - }, - "documentation":"

Contains the response to a successful GetAccountSummary request.

" - }, - "GetContextKeysForCustomPolicyRequest":{ - "type":"structure", - "required":["PolicyInputList"], - "members":{ - "PolicyInputList":{ - "shape":"SimulationPolicyListType", - "documentation":"

A list of policies for which you want the list of context keys referenced in those policies. Each document is specified as a string containing the complete, valid JSON text of an IAM policy.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "GetContextKeysForPolicyResponse":{ - "type":"structure", - "members":{ - "ContextKeyNames":{ - "shape":"ContextKeyNamesResultListType", - "documentation":"

The list of context keys that are referenced in the input policies.

" - } - }, - "documentation":"

Contains the response to a successful GetContextKeysForPrincipalPolicy or GetContextKeysForCustomPolicy request.

" - }, - "GetContextKeysForPrincipalPolicyRequest":{ - "type":"structure", - "required":["PolicySourceArn"], - "members":{ - "PolicySourceArn":{ - "shape":"arnType", - "documentation":"

The ARN of a user, group, or role whose policies contain the context keys that you want listed. If you specify a user, the list includes context keys that are found in all policies that are attached to the user. The list also includes all groups that the user is a member of. If you pick a group or a role, then it includes only those context keys that are found in policies attached to that entity. Note that all parameters are shown in unencoded form here for clarity, but must be URL encoded to be included as a part of a real HTML request.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "PolicyInputList":{ - "shape":"SimulationPolicyListType", - "documentation":"

An optional list of additional policies for which you want the list of context keys that are referenced.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "GetCredentialReportResponse":{ - "type":"structure", - "members":{ - "Content":{ - "shape":"ReportContentType", - "documentation":"

Contains the credential report. The report is Base64-encoded.

" - }, - "ReportFormat":{ - "shape":"ReportFormatType", - "documentation":"

The format (MIME type) of the credential report.

" - }, - "GeneratedTime":{ - "shape":"dateType", - "documentation":"

The date and time when the credential report was created, in ISO 8601 date-time format.

" - } - }, - "documentation":"

Contains the response to a successful GetCredentialReport request.

" - }, - "GetGroupPolicyRequest":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyName" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group the policy is associated with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document to get.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetGroupPolicyResponse":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The group the policy is associated with.

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

" - } - }, - "documentation":"

Contains the response to a successful GetGroupPolicy request.

" - }, - "GetGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "GetGroupResponse":{ - "type":"structure", - "required":[ - "Group", - "Users" - ], - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

A structure that contains details about the group.

" - }, - "Users":{ - "shape":"userListType", - "documentation":"

A list of users in the group.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful GetGroup request.

" - }, - "GetInstanceProfileRequest":{ - "type":"structure", - "required":["InstanceProfileName"], - "members":{ - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name of the instance profile to get information about.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetInstanceProfileResponse":{ - "type":"structure", - "required":["InstanceProfile"], - "members":{ - "InstanceProfile":{ - "shape":"InstanceProfile", - "documentation":"

A structure containing details about the instance profile.

" - } - }, - "documentation":"

Contains the response to a successful GetInstanceProfile request.

" - }, - "GetLoginProfileRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user whose login profile you want to retrieve.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetLoginProfileResponse":{ - "type":"structure", - "required":["LoginProfile"], - "members":{ - "LoginProfile":{ - "shape":"LoginProfile", - "documentation":"

A structure containing the user name and password create date for the user.

" - } - }, - "documentation":"

Contains the response to a successful GetLoginProfile request.

" - }, - "GetOpenIDConnectProviderRequest":{ - "type":"structure", - "required":["OpenIDConnectProviderArn"], - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the OIDC provider resource object in IAM to get information for. You can get a list of OIDC provider resource ARNs by using the ListOpenIDConnectProviders operation.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "GetOpenIDConnectProviderResponse":{ - "type":"structure", - "members":{ - "Url":{ - "shape":"OpenIDConnectProviderUrlType", - "documentation":"

The URL that the IAM OIDC provider resource object is associated with. For more information, see CreateOpenIDConnectProvider.

" - }, - "ClientIDList":{ - "shape":"clientIDListType", - "documentation":"

A list of client IDs (also known as audiences) that are associated with the specified IAM OIDC provider resource object. For more information, see CreateOpenIDConnectProvider.

" - }, - "ThumbprintList":{ - "shape":"thumbprintListType", - "documentation":"

A list of certificate thumbprints that are associated with the specified IAM OIDC provider resource object. For more information, see CreateOpenIDConnectProvider.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time when the IAM OIDC provider resource object was created in the AWS account.

" - } - }, - "documentation":"

Contains the response to a successful GetOpenIDConnectProvider request.

" - }, - "GetPolicyRequest":{ - "type":"structure", - "required":["PolicyArn"], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the managed policy that you want information about.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "GetPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

A structure containing details about the policy.

" - } - }, - "documentation":"

Contains the response to a successful GetPolicy request.

" - }, - "GetPolicyVersionRequest":{ - "type":"structure", - "required":[ - "PolicyArn", - "VersionId" - ], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the managed policy that you want information about.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "VersionId":{ - "shape":"policyVersionIdType", - "documentation":"

Identifies the policy version to retrieve.

This parameter allows (per its regex pattern) a string of characters that consists of the lowercase letter 'v' followed by one or two digits, and optionally followed by a period '.' and a string of letters and digits.

" - } - } - }, - "GetPolicyVersionResponse":{ - "type":"structure", - "members":{ - "PolicyVersion":{ - "shape":"PolicyVersion", - "documentation":"

A structure containing details about the policy version.

" - } - }, - "documentation":"

Contains the response to a successful GetPolicyVersion request.

" - }, - "GetRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyName" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role associated with the policy.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document to get.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetRolePolicyResponse":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The role the policy is associated with.

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

" - } - }, - "documentation":"

Contains the response to a successful GetRolePolicy request.

" - }, - "GetRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the IAM role to get information about.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetRoleResponse":{ - "type":"structure", - "required":["Role"], - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

A structure containing details about the IAM role.

" - } - }, - "documentation":"

Contains the response to a successful GetRole request.

" - }, - "GetSAMLProviderRequest":{ - "type":"structure", - "required":["SAMLProviderArn"], - "members":{ - "SAMLProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider resource object in IAM to get information about.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "GetSAMLProviderResponse":{ - "type":"structure", - "members":{ - "SAMLMetadataDocument":{ - "shape":"SAMLMetadataDocumentType", - "documentation":"

The XML metadata document that includes information about an identity provider.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time when the SAML provider was created.

" - }, - "ValidUntil":{ - "shape":"dateType", - "documentation":"

The expiration date and time for the SAML provider.

" - } - }, - "documentation":"

Contains the response to a successful GetSAMLProvider request.

" - }, - "GetSSHPublicKeyRequest":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyId", - "Encoding" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the SSH public key.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SSHPublicKeyId":{ - "shape":"publicKeyIdType", - "documentation":"

The unique identifier for the SSH public key.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - }, - "Encoding":{ - "shape":"encodingType", - "documentation":"

Specifies the public key encoding format to use in the response. To retrieve the public key in ssh-rsa format, use SSH. To retrieve the public key in PEM format, use PEM.

" - } - } - }, - "GetSSHPublicKeyResponse":{ - "type":"structure", - "members":{ - "SSHPublicKey":{ - "shape":"SSHPublicKey", - "documentation":"

A structure containing details about the SSH public key.

" - } - }, - "documentation":"

Contains the response to a successful GetSSHPublicKey request.

" - }, - "GetServerCertificateRequest":{ - "type":"structure", - "required":["ServerCertificateName"], - "members":{ - "ServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The name of the server certificate you want to retrieve information about.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetServerCertificateResponse":{ - "type":"structure", - "required":["ServerCertificate"], - "members":{ - "ServerCertificate":{ - "shape":"ServerCertificate", - "documentation":"

A structure containing details about the server certificate.

" - } - }, - "documentation":"

Contains the response to a successful GetServerCertificate request.

" - }, - "GetServiceLinkedRoleDeletionStatusRequest":{ - "type":"structure", - "required":["DeletionTaskId"], - "members":{ - "DeletionTaskId":{ - "shape":"DeletionTaskIdType", - "documentation":"

The deletion task identifier. This identifier is returned by the DeleteServiceLinkedRole operation in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.

" - } - } - }, - "GetServiceLinkedRoleDeletionStatusResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"DeletionTaskStatusType", - "documentation":"

The status of the deletion.

" - }, - "Reason":{ - "shape":"DeletionTaskFailureReasonType", - "documentation":"

An object that contains details about the reason the deletion failed.

" - } - } - }, - "GetUserPolicyRequest":{ - "type":"structure", - "required":[ - "UserName", - "PolicyName" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user who the policy is associated with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document to get.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetUserPolicyResponse":{ - "type":"structure", - "required":[ - "UserName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The user the policy is associated with.

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

" - } - }, - "documentation":"

Contains the response to a successful GetUserPolicy request.

" - }, - "GetUserRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to get information about.

This parameter is optional. If it is not included, it defaults to the user making the request. This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "GetUserResponse":{ - "type":"structure", - "required":["User"], - "members":{ - "User":{ - "shape":"User", - "documentation":"

A structure containing details about the IAM user.

Due to a service issue, password last used data does not include password use from May 3rd 2018 22:50 PDT to May 23rd 2018 14:08 PDT. This affects last sign-in dates shown in the IAM console and password last used dates in the IAM credential report, and returned by this GetUser API. If users signed in during the affected time, the password last used date that is returned is the date the user last signed in before May 3rd 2018. For users that signed in after May 23rd 2018 14:08 PDT, the returned password last used date is accurate.

If you use password last used information to identify unused credentials for deletion, such as deleting users who did not sign in to AWS in the last 90 days, we recommend that you adjust your evaluation window to include dates after May 23rd 2018. Alternatively, if your users use access keys to access AWS programmatically you can refer to access key last used information because it is accurate for all dates.

" - } - }, - "documentation":"

Contains the response to a successful GetUser request.

" - }, - "Group":{ - "type":"structure", - "required":[ - "Path", - "GroupName", - "GroupId", - "Arn", - "CreateDate" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the group. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The friendly name that identifies the group.

" - }, - "GroupId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the group. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) specifying the group. For more information about ARNs and how to use them in policies, see IAM Identifiers in the Using IAM guide.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the group was created.

" - } - }, - "documentation":"

Contains information about an IAM group entity.

This data type is used as a response element in the following operations:

" - }, - "GroupDetail":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the group. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The friendly name that identifies the group.

" - }, - "GroupId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the group. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{"shape":"arnType"}, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the group was created.

" - }, - "GroupPolicyList":{ - "shape":"policyDetailListType", - "documentation":"

A list of the inline policies embedded in the group.

" - }, - "AttachedManagedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of the managed policies attached to the group.

" - } - }, - "documentation":"

Contains information about an IAM group, including all of the group's policies.

This data type is used as a response element in the GetAccountAuthorizationDetails operation.

" - }, - "InstanceProfile":{ - "type":"structure", - "required":[ - "Path", - "InstanceProfileName", - "InstanceProfileId", - "Arn", - "CreateDate", - "Roles" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the instance profile. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name identifying the instance profile.

" - }, - "InstanceProfileId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the instance profile. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) specifying the instance profile. For more information about ARNs and how to use them in policies, see IAM Identifiers in the Using IAM guide.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date when the instance profile was created.

" - }, - "Roles":{ - "shape":"roleListType", - "documentation":"

The role associated with the instance profile.

" - } - }, - "documentation":"

Contains information about an instance profile.

This data type is used as a response element in the following operations:

" - }, - "InvalidAuthenticationCodeException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidAuthenticationCodeMessage"} - }, - "documentation":"

The request was rejected because the authentication code was not recognized. The error message describes the specific error.

", - "error":{ - "code":"InvalidAuthenticationCode", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "InvalidCertificateException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidCertificateMessage"} - }, - "documentation":"

The request was rejected because the certificate is invalid.

", - "error":{ - "code":"InvalidCertificate", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidInputMessage"} - }, - "documentation":"

The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

", - "error":{ - "code":"InvalidInput", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidPublicKeyException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidPublicKeyMessage"} - }, - "documentation":"

The request was rejected because the public key is malformed or otherwise invalid.

", - "error":{ - "code":"InvalidPublicKey", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidUserTypeException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidUserTypeMessage"} - }, - "documentation":"

The request was rejected because the type of user for the transaction was incorrect.

", - "error":{ - "code":"InvalidUserType", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KeyPairMismatchException":{ - "type":"structure", - "members":{ - "message":{"shape":"keyPairMismatchMessage"} - }, - "documentation":"

The request was rejected because the public key certificate and the private key do not match.

", - "error":{ - "code":"KeyPairMismatch", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"limitExceededMessage"} - }, - "documentation":"

The request was rejected because it attempted to create resources beyond the current AWS account limits. The error message describes the limit exceeded.

", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true - }, - "LineNumber":{"type":"integer"}, - "ListAccessKeysRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListAccessKeysResponse":{ - "type":"structure", - "required":["AccessKeyMetadata"], - "members":{ - "AccessKeyMetadata":{ - "shape":"accessKeyMetadataListType", - "documentation":"

A list of objects containing metadata about the access keys.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListAccessKeys request.

" - }, - "ListAccountAliasesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListAccountAliasesResponse":{ - "type":"structure", - "required":["AccountAliases"], - "members":{ - "AccountAliases":{ - "shape":"accountAliasListType", - "documentation":"

A list of aliases associated with the account. AWS supports only one alias per account.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListAccountAliases request.

" - }, - "ListAttachedGroupPoliciesRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name (friendly name, not ARN) of the group to list attached policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PathPrefix":{ - "shape":"policyPathType", - "documentation":"

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListAttachedGroupPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of the attached policies.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListAttachedGroupPolicies request.

" - }, - "ListAttachedRolePoliciesRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) of the role to list attached policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PathPrefix":{ - "shape":"policyPathType", - "documentation":"

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListAttachedRolePoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of the attached policies.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListAttachedRolePolicies request.

" - }, - "ListAttachedUserPoliciesRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) of the user to list attached policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PathPrefix":{ - "shape":"policyPathType", - "documentation":"

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListAttachedUserPoliciesResponse":{ - "type":"structure", - "members":{ - "AttachedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of the attached policies.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListAttachedUserPolicies request.

" - }, - "ListEntitiesForPolicyRequest":{ - "type":"structure", - "required":["PolicyArn"], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy for which you want the versions.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "EntityFilter":{ - "shape":"EntityType", - "documentation":"

The entity type to use for filtering the results.

For example, when EntityFilter is Role, only the roles that are attached to the specified policy are returned. This parameter is optional. If it is not included, all attached entities (users, groups, and roles) are returned. The argument for this parameter must be one of the valid values listed below.

" - }, - "PathPrefix":{ - "shape":"pathType", - "documentation":"

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all entities.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "PolicyUsageFilter":{ - "shape":"PolicyUsageType", - "documentation":"

The policy usage method to use for filtering the results.

To list only permissions policies, set PolicyUsageFilter to PermissionsPolicy. To list only the policies used to set permissions boundaries, set the value to PermissionsBoundary.

This parameter is optional. If it is not included, all policies are returned.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListEntitiesForPolicyResponse":{ - "type":"structure", - "members":{ - "PolicyGroups":{ - "shape":"PolicyGroupListType", - "documentation":"

A list of IAM groups that the policy is attached to.

" - }, - "PolicyUsers":{ - "shape":"PolicyUserListType", - "documentation":"

A list of IAM users that the policy is attached to.

" - }, - "PolicyRoles":{ - "shape":"PolicyRoleListType", - "documentation":"

A list of IAM roles that the policy is attached to.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListEntitiesForPolicy request.

" - }, - "ListGroupPoliciesRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group to list policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListGroupPoliciesResponse":{ - "type":"structure", - "required":["PolicyNames"], - "members":{ - "PolicyNames":{ - "shape":"policyNameListType", - "documentation":"

A list of policy names.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListGroupPolicies request.

" - }, - "ListGroupsForUserRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to list groups for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListGroupsForUserResponse":{ - "type":"structure", - "required":["Groups"], - "members":{ - "Groups":{ - "shape":"groupListType", - "documentation":"

A list of groups.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListGroupsForUser request.

" - }, - "ListGroupsRequest":{ - "type":"structure", - "members":{ - "PathPrefix":{ - "shape":"pathPrefixType", - "documentation":"

The path prefix for filtering the results. For example, the prefix /division_abc/subdivision_xyz/ gets all groups whose path starts with /division_abc/subdivision_xyz/.

This parameter is optional. If it is not included, it defaults to a slash (/), listing all groups. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListGroupsResponse":{ - "type":"structure", - "required":["Groups"], - "members":{ - "Groups":{ - "shape":"groupListType", - "documentation":"

A list of groups.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListGroups request.

" - }, - "ListInstanceProfilesForRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to list instance profiles for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListInstanceProfilesForRoleResponse":{ - "type":"structure", - "required":["InstanceProfiles"], - "members":{ - "InstanceProfiles":{ - "shape":"instanceProfileListType", - "documentation":"

A list of instance profiles.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListInstanceProfilesForRole request.

" - }, - "ListInstanceProfilesRequest":{ - "type":"structure", - "members":{ - "PathPrefix":{ - "shape":"pathPrefixType", - "documentation":"

The path prefix for filtering the results. For example, the prefix /application_abc/component_xyz/ gets all instance profiles whose path starts with /application_abc/component_xyz/.

This parameter is optional. If it is not included, it defaults to a slash (/), listing all instance profiles. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListInstanceProfilesResponse":{ - "type":"structure", - "required":["InstanceProfiles"], - "members":{ - "InstanceProfiles":{ - "shape":"instanceProfileListType", - "documentation":"

A list of instance profiles.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListInstanceProfiles request.

" - }, - "ListMFADevicesRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user whose MFA devices you want to list.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListMFADevicesResponse":{ - "type":"structure", - "required":["MFADevices"], - "members":{ - "MFADevices":{ - "shape":"mfaDeviceListType", - "documentation":"

A list of MFA devices.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListMFADevices request.

" - }, - "ListOpenIDConnectProvidersRequest":{ - "type":"structure", - "members":{ - } - }, - "ListOpenIDConnectProvidersResponse":{ - "type":"structure", - "members":{ - "OpenIDConnectProviderList":{ - "shape":"OpenIDConnectProviderListType", - "documentation":"

The list of IAM OIDC provider resource objects defined in the AWS account.

" - } - }, - "documentation":"

Contains the response to a successful ListOpenIDConnectProviders request.

" - }, - "ListPoliciesRequest":{ - "type":"structure", - "members":{ - "Scope":{ - "shape":"policyScopeType", - "documentation":"

The scope to use for filtering the results.

To list only AWS managed policies, set Scope to AWS. To list only the customer managed policies in your AWS account, set Scope to Local.

This parameter is optional. If it is not included, or if it is set to All, all policies are returned.

" - }, - "OnlyAttached":{ - "shape":"booleanType", - "documentation":"

A flag to filter the results to only the attached policies.

When OnlyAttached is true, the returned list contains only the policies that are attached to an IAM user, group, or role. When OnlyAttached is false, or when the parameter is not included, all policies are returned.

" - }, - "PathPrefix":{ - "shape":"policyPathType", - "documentation":"

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "PolicyUsageFilter":{ - "shape":"PolicyUsageType", - "documentation":"

The policy usage method to use for filtering the results.

To list only permissions policies, set PolicyUsageFilter to PermissionsPolicy. To list only the policies used to set permissions boundaries, set the value to PermissionsBoundary.

This parameter is optional. If it is not included, all policies are returned.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListPoliciesResponse":{ - "type":"structure", - "members":{ - "Policies":{ - "shape":"policyListType", - "documentation":"

A list of policies.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListPolicies request.

" - }, - "ListPolicyVersionsRequest":{ - "type":"structure", - "required":["PolicyArn"], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy for which you want the versions.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListPolicyVersionsResponse":{ - "type":"structure", - "members":{ - "Versions":{ - "shape":"policyDocumentVersionListType", - "documentation":"

A list of policy versions.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListPolicyVersions request.

" - }, - "ListRolePoliciesRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to list policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListRolePoliciesResponse":{ - "type":"structure", - "required":["PolicyNames"], - "members":{ - "PolicyNames":{ - "shape":"policyNameListType", - "documentation":"

A list of policy names.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListRolePolicies request.

" - }, - "ListRolesRequest":{ - "type":"structure", - "members":{ - "PathPrefix":{ - "shape":"pathPrefixType", - "documentation":"

The path prefix for filtering the results. For example, the prefix /application_abc/component_xyz/ gets all roles whose path starts with /application_abc/component_xyz/.

This parameter is optional. If it is not included, it defaults to a slash (/), listing all roles. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListRolesResponse":{ - "type":"structure", - "required":["Roles"], - "members":{ - "Roles":{ - "shape":"roleListType", - "documentation":"

A list of roles.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListRoles request.

" - }, - "ListSAMLProvidersRequest":{ - "type":"structure", - "members":{ - } - }, - "ListSAMLProvidersResponse":{ - "type":"structure", - "members":{ - "SAMLProviderList":{ - "shape":"SAMLProviderListType", - "documentation":"

The list of SAML provider resource objects defined in IAM for this AWS account.

" - } - }, - "documentation":"

Contains the response to a successful ListSAMLProviders request.

" - }, - "ListSSHPublicKeysRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user to list SSH public keys for. If none is specified, the UserName field is determined implicitly based on the AWS access key used to sign the request.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListSSHPublicKeysResponse":{ - "type":"structure", - "members":{ - "SSHPublicKeys":{ - "shape":"SSHPublicKeyListType", - "documentation":"

A list of the SSH public keys assigned to IAM user.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListSSHPublicKeys request.

" - }, - "ListServerCertificatesRequest":{ - "type":"structure", - "members":{ - "PathPrefix":{ - "shape":"pathPrefixType", - "documentation":"

The path prefix for filtering the results. For example: /company/servercerts would get all server certificates for which the path starts with /company/servercerts.

This parameter is optional. If it is not included, it defaults to a slash (/), listing all server certificates. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListServerCertificatesResponse":{ - "type":"structure", - "required":["ServerCertificateMetadataList"], - "members":{ - "ServerCertificateMetadataList":{ - "shape":"serverCertificateMetadataListType", - "documentation":"

A list of server certificates.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListServerCertificates request.

" - }, - "ListServiceSpecificCredentialsRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user whose service-specific credentials you want information about. If this value is not specified, then the operation assumes the user whose credentials are used to call the operation.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "ServiceName":{ - "shape":"serviceName", - "documentation":"

Filters the returned results to only those for the specified AWS service. If not specified, then AWS returns service-specific credentials for all services.

" - } - } - }, - "ListServiceSpecificCredentialsResponse":{ - "type":"structure", - "members":{ - "ServiceSpecificCredentials":{ - "shape":"ServiceSpecificCredentialsListType", - "documentation":"

A list of structures that each contain details about a service-specific credential.

" - } - } - }, - "ListSigningCertificatesRequest":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the IAM user whose signing certificates you want to examine.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListSigningCertificatesResponse":{ - "type":"structure", - "required":["Certificates"], - "members":{ - "Certificates":{ - "shape":"certificateListType", - "documentation":"

A list of the user's signing certificate information.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListSigningCertificates request.

" - }, - "ListUserPoliciesRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to list policies for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListUserPoliciesResponse":{ - "type":"structure", - "required":["PolicyNames"], - "members":{ - "PolicyNames":{ - "shape":"policyNameListType", - "documentation":"

A list of policy names.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListUserPolicies request.

" - }, - "ListUsersRequest":{ - "type":"structure", - "members":{ - "PathPrefix":{ - "shape":"pathPrefixType", - "documentation":"

The path prefix for filtering the results. For example: /division_abc/subdivision_xyz/, which would get all user names whose path starts with /division_abc/subdivision_xyz/.

This parameter is optional. If it is not included, it defaults to a slash (/), listing all user names. This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListUsersResponse":{ - "type":"structure", - "required":["Users"], - "members":{ - "Users":{ - "shape":"userListType", - "documentation":"

A list of users.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListUsers request.

" - }, - "ListVirtualMFADevicesRequest":{ - "type":"structure", - "members":{ - "AssignmentStatus":{ - "shape":"assignmentStatusType", - "documentation":"

The status (Unassigned or Assigned) of the devices to list. If you do not specify an AssignmentStatus, the operation defaults to Any which lists both assigned and unassigned virtual MFA devices.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - } - } - }, - "ListVirtualMFADevicesResponse":{ - "type":"structure", - "required":["VirtualMFADevices"], - "members":{ - "VirtualMFADevices":{ - "shape":"virtualMFADeviceListType", - "documentation":"

The list of virtual MFA devices in the current account that match the AssignmentStatus value that was passed in the request.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful ListVirtualMFADevices request.

" - }, - "LoginProfile":{ - "type":"structure", - "required":[ - "UserName", - "CreateDate" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user, which can be used for signing in to the AWS Management Console.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date when the password for the user was created.

" - }, - "PasswordResetRequired":{ - "shape":"booleanType", - "documentation":"

Specifies whether the user is required to set a new password on next sign-in.

" - } - }, - "documentation":"

Contains the user name and password create date for a user.

This data type is used as a response element in the CreateLoginProfile and GetLoginProfile operations.

" - }, - "MFADevice":{ - "type":"structure", - "required":[ - "UserName", - "SerialNumber", - "EnableDate" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The user with whom the MFA device is associated.

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the device ARN.

" - }, - "EnableDate":{ - "shape":"dateType", - "documentation":"

The date when the MFA device was enabled for the user.

" - } - }, - "documentation":"

Contains information about an MFA device.

This data type is used as a response element in the ListMFADevices operation.

" - }, - "MalformedCertificateException":{ - "type":"structure", - "members":{ - "message":{"shape":"malformedCertificateMessage"} - }, - "documentation":"

The request was rejected because the certificate was malformed or expired. The error message describes the specific error.

", - "error":{ - "code":"MalformedCertificate", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "MalformedPolicyDocumentException":{ - "type":"structure", - "members":{ - "message":{"shape":"malformedPolicyDocumentMessage"} - }, - "documentation":"

The request was rejected because the policy document was malformed. The error message describes the specific error.

", - "error":{ - "code":"MalformedPolicyDocument", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ManagedPolicyDetail":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The friendly name (not ARN) identifying the policy.

" - }, - "PolicyId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the policy.

For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{"shape":"arnType"}, - "Path":{ - "shape":"policyPathType", - "documentation":"

The path to the policy.

For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "DefaultVersionId":{ - "shape":"policyVersionIdType", - "documentation":"

The identifier for the version of the policy that is set as the default (operative) version.

For more information about policy versions, see Versioning for Managed Policies in the Using IAM guide.

" - }, - "AttachmentCount":{ - "shape":"attachmentCountType", - "documentation":"

The number of principal entities (users, groups, and roles) that the policy is attached to.

" - }, - "PermissionsBoundaryUsageCount":{ - "shape":"attachmentCountType", - "documentation":"

The number of entities (users and roles) for which the policy is used as the permissions boundary.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - }, - "IsAttachable":{ - "shape":"booleanType", - "documentation":"

Specifies whether the policy can be attached to an IAM user, group, or role.

" - }, - "Description":{ - "shape":"policyDescriptionType", - "documentation":"

A friendly description of the policy.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the policy was created.

" - }, - "UpdateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the policy was last updated.

When a policy has only one version, this field contains the date and time when the policy was created. When a policy has more than one version, this field contains the date and time when the most recent policy version was created.

" - }, - "PolicyVersionList":{ - "shape":"policyDocumentVersionListType", - "documentation":"

A list containing information about the versions of the policy.

" - } - }, - "documentation":"

Contains information about a managed policy, including the policy's ARN, versions, and the number of principal entities (users, groups, and roles) that the policy is attached to.

This data type is used as a response element in the GetAccountAuthorizationDetails operation.

For more information about managed policies, see Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "ManagedPolicyDetailListType":{ - "type":"list", - "member":{"shape":"ManagedPolicyDetail"} - }, - "NoSuchEntityException":{ - "type":"structure", - "members":{ - "message":{"shape":"noSuchEntityMessage"} - }, - "documentation":"

The request was rejected because it referenced an entity that does not exist. The error message describes the entity.

", - "error":{ - "code":"NoSuchEntity", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "OpenIDConnectProviderListEntry":{ - "type":"structure", - "members":{ - "Arn":{"shape":"arnType"} - }, - "documentation":"

Contains the Amazon Resource Name (ARN) for an IAM OpenID Connect provider.

" - }, - "OpenIDConnectProviderListType":{ - "type":"list", - "member":{"shape":"OpenIDConnectProviderListEntry"}, - "documentation":"

Contains a list of IAM OpenID Connect providers.

" - }, - "OpenIDConnectProviderUrlType":{ - "type":"string", - "documentation":"

Contains a URL that specifies the endpoint for an OpenID Connect provider.

", - "max":255, - "min":1 - }, - "OrganizationsDecisionDetail":{ - "type":"structure", - "members":{ - "AllowedByOrganizations":{ - "shape":"booleanType", - "documentation":"

Specifies whether the simulated operation is allowed by the AWS Organizations service control policies that impact the simulated user's account.

" - } - }, - "documentation":"

Contains information about AWS Organizations's effect on a policy simulation.

" - }, - "PasswordPolicy":{ - "type":"structure", - "members":{ - "MinimumPasswordLength":{ - "shape":"minimumPasswordLengthType", - "documentation":"

Minimum length to require for IAM user passwords.

" - }, - "RequireSymbols":{ - "shape":"booleanType", - "documentation":"

Specifies whether to require symbols for IAM user passwords.

" - }, - "RequireNumbers":{ - "shape":"booleanType", - "documentation":"

Specifies whether to require numbers for IAM user passwords.

" - }, - "RequireUppercaseCharacters":{ - "shape":"booleanType", - "documentation":"

Specifies whether to require uppercase characters for IAM user passwords.

" - }, - "RequireLowercaseCharacters":{ - "shape":"booleanType", - "documentation":"

Specifies whether to require lowercase characters for IAM user passwords.

" - }, - "AllowUsersToChangePassword":{ - "shape":"booleanType", - "documentation":"

Specifies whether IAM users are allowed to change their own password.

" - }, - "ExpirePasswords":{ - "shape":"booleanType", - "documentation":"

Indicates whether passwords in the account expire. Returns true if MaxPasswordAge contains a value greater than 0. Returns false if MaxPasswordAge is 0 or not present.

" - }, - "MaxPasswordAge":{ - "shape":"maxPasswordAgeType", - "documentation":"

The number of days that an IAM user password is valid.

" - }, - "PasswordReusePrevention":{ - "shape":"passwordReusePreventionType", - "documentation":"

Specifies the number of previous passwords that IAM users are prevented from reusing.

" - }, - "HardExpiry":{ - "shape":"booleanObjectType", - "documentation":"

Specifies whether IAM users are prevented from setting a new password after their password has expired.

" - } - }, - "documentation":"

Contains information about the account password policy.

This data type is used as a response element in the GetAccountPasswordPolicy operation.

" - }, - "PasswordPolicyViolationException":{ - "type":"structure", - "members":{ - "message":{"shape":"passwordPolicyViolationMessage"} - }, - "documentation":"

The request was rejected because the provided password did not meet the requirements imposed by the account password policy.

", - "error":{ - "code":"PasswordPolicyViolation", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PermissionsBoundaryAttachmentType":{ - "type":"string", - "enum":["PermissionsBoundaryPolicy"] - }, - "Policy":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The friendly name (not ARN) identifying the policy.

" - }, - "PolicyId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the policy.

For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{"shape":"arnType"}, - "Path":{ - "shape":"policyPathType", - "documentation":"

The path to the policy.

For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "DefaultVersionId":{ - "shape":"policyVersionIdType", - "documentation":"

The identifier for the version of the policy that is set as the default version.

" - }, - "AttachmentCount":{ - "shape":"attachmentCountType", - "documentation":"

The number of entities (users, groups, and roles) that the policy is attached to.

" - }, - "PermissionsBoundaryUsageCount":{ - "shape":"attachmentCountType", - "documentation":"

The number of entities (users and roles) for which the policy is used to set the permissions boundary.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - }, - "IsAttachable":{ - "shape":"booleanType", - "documentation":"

Specifies whether the policy can be attached to an IAM user, group, or role.

" - }, - "Description":{ - "shape":"policyDescriptionType", - "documentation":"

A friendly description of the policy.

This element is included in the response to the GetPolicy operation. It is not included in the response to the ListPolicies operation.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the policy was created.

" - }, - "UpdateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the policy was last updated.

When a policy has only one version, this field contains the date and time when the policy was created. When a policy has more than one version, this field contains the date and time when the most recent policy version was created.

" - } - }, - "documentation":"

Contains information about a managed policy.

This data type is used as a response element in the CreatePolicy, GetPolicy, and ListPolicies operations.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "PolicyDetail":{ - "type":"structure", - "members":{ - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy.

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

" - } - }, - "documentation":"

Contains information about an IAM policy, including the policy document.

This data type is used as a response element in the GetAccountAuthorizationDetails operation.

" - }, - "PolicyEvaluationDecisionType":{ - "type":"string", - "enum":[ - "allowed", - "explicitDeny", - "implicitDeny" - ] - }, - "PolicyEvaluationException":{ - "type":"structure", - "members":{ - "message":{"shape":"policyEvaluationErrorMessage"} - }, - "documentation":"

The request failed because a provided policy could not be successfully evaluated. An additional detailed message indicates the source of the failure.

", - "error":{ - "code":"PolicyEvaluation", - "httpStatusCode":500 - }, - "exception":true - }, - "PolicyGroup":{ - "type":"structure", - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name (friendly name, not ARN) identifying the group.

" - }, - "GroupId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the group. For more information about IDs, see IAM Identifiers in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about a group that a managed policy is attached to.

This data type is used as a response element in the ListEntitiesForPolicy operation.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "PolicyGroupListType":{ - "type":"list", - "member":{"shape":"PolicyGroup"} - }, - "PolicyIdentifierType":{"type":"string"}, - "PolicyNotAttachableException":{ - "type":"structure", - "members":{ - "message":{"shape":"policyNotAttachableMessage"} - }, - "documentation":"

The request failed because AWS service role policies can only be attached to the service-linked role for that service.

", - "error":{ - "code":"PolicyNotAttachable", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PolicyRole":{ - "type":"structure", - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) identifying the role.

" - }, - "RoleId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the role. For more information about IDs, see IAM Identifiers in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about a role that a managed policy is attached to.

This data type is used as a response element in the ListEntitiesForPolicy operation.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "PolicyRoleListType":{ - "type":"list", - "member":{"shape":"PolicyRole"} - }, - "PolicySourceType":{ - "type":"string", - "enum":[ - "user", - "group", - "role", - "aws-managed", - "user-managed", - "resource", - "none" - ] - }, - "PolicyUsageType":{ - "type":"string", - "documentation":"

The policy usage type that indicates whether the policy is used as a permissions policy or as the permissions boundary for an entity.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

", - "enum":[ - "PermissionsPolicy", - "PermissionsBoundary" - ] - }, - "PolicyUser":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) identifying the user.

" - }, - "UserId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the user. For more information about IDs, see IAM Identifiers in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about a user that a managed policy is attached to.

This data type is used as a response element in the ListEntitiesForPolicy operation.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "PolicyUserListType":{ - "type":"list", - "member":{"shape":"PolicyUser"} - }, - "PolicyVersion":{ - "type":"structure", - "members":{ - "Document":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

The policy document is returned in the response to the GetPolicyVersion and GetAccountAuthorizationDetails operations. It is not returned in the response to the CreatePolicyVersion or ListPolicyVersions operations.

The policy document returned in this structure is URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

" - }, - "VersionId":{ - "shape":"policyVersionIdType", - "documentation":"

The identifier for the policy version.

Policy version identifiers always begin with v (always lowercase). When a policy is created, the first policy version is v1.

" - }, - "IsDefaultVersion":{ - "shape":"booleanType", - "documentation":"

Specifies whether the policy version is set as the policy's default version.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the policy version was created.

" - } - }, - "documentation":"

Contains information about a version of a managed policy.

This data type is used as a response element in the CreatePolicyVersion, GetPolicyVersion, ListPolicyVersions, and GetAccountAuthorizationDetails operations.

For more information about managed policies, refer to Managed Policies and Inline Policies in the Using IAM guide.

" - }, - "Position":{ - "type":"structure", - "members":{ - "Line":{ - "shape":"LineNumber", - "documentation":"

The line containing the specified position in the document.

" - }, - "Column":{ - "shape":"ColumnNumber", - "documentation":"

The column in the line containing the specified position in the document.

" - } - }, - "documentation":"

Contains the row and column of a location of a Statement element in a policy document.

This data type is used as a member of the Statement type.

" - }, - "PutGroupPolicyRequest":{ - "type":"structure", - "required":[ - "GroupName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group to associate the policy with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "PutRolePermissionsBoundaryRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PermissionsBoundary" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM role for which you want to set the permissions boundary.

" - }, - "PermissionsBoundary":{ - "shape":"arnType", - "documentation":"

The ARN of the policy that is used to set the permissions boundary for the role.

" - } - } - }, - "PutRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to associate the policy with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "PutUserPermissionsBoundaryRequest":{ - "type":"structure", - "required":[ - "UserName", - "PermissionsBoundary" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name (friendly name, not ARN) of the IAM user for which you want to set the permissions boundary.

" - }, - "PermissionsBoundary":{ - "shape":"arnType", - "documentation":"

The ARN of the policy that is used to set the permissions boundary for the user.

" - } - } - }, - "PutUserPolicyRequest":{ - "type":"structure", - "required":[ - "UserName", - "PolicyName", - "PolicyDocument" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to associate the policy with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyName":{ - "shape":"policyNameType", - "documentation":"

The name of the policy document.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy document.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "ReasonType":{ - "type":"string", - "max":1000 - }, - "RegionNameType":{ - "type":"string", - "max":100, - "min":1 - }, - "RemoveClientIDFromOpenIDConnectProviderRequest":{ - "type":"structure", - "required":[ - "OpenIDConnectProviderArn", - "ClientID" - ], - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM OIDC provider resource to remove the client ID from. You can get a list of OIDC provider ARNs by using the ListOpenIDConnectProviders operation.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "ClientID":{ - "shape":"clientIDType", - "documentation":"

The client ID (also known as audience) to remove from the IAM OIDC provider resource. For more information about client IDs, see CreateOpenIDConnectProvider.

" - } - } - }, - "RemoveRoleFromInstanceProfileRequest":{ - "type":"structure", - "required":[ - "InstanceProfileName", - "RoleName" - ], - "members":{ - "InstanceProfileName":{ - "shape":"instanceProfileNameType", - "documentation":"

The name of the instance profile to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to remove.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "RemoveUserFromGroupRequest":{ - "type":"structure", - "required":[ - "GroupName", - "UserName" - ], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

The name of the group to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user to remove.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "ReportContentType":{"type":"blob"}, - "ReportFormatType":{ - "type":"string", - "enum":["text/csv"] - }, - "ReportStateDescriptionType":{"type":"string"}, - "ReportStateType":{ - "type":"string", - "enum":[ - "STARTED", - "INPROGRESS", - "COMPLETE" - ] - }, - "ResetServiceSpecificCredentialRequest":{ - "type":"structure", - "required":["ServiceSpecificCredentialId"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the service-specific credential. If this value is not specified, then the operation assumes the user whose credentials are used to call the operation.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "ServiceSpecificCredentialId":{ - "shape":"serviceSpecificCredentialId", - "documentation":"

The unique identifier of the service-specific credential.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - } - } - }, - "ResetServiceSpecificCredentialResponse":{ - "type":"structure", - "members":{ - "ServiceSpecificCredential":{ - "shape":"ServiceSpecificCredential", - "documentation":"

A structure with details about the updated service-specific credential, including the new password.

This is the only time that you can access the password. You cannot recover the password later, but you can reset it again.

" - } - } - }, - "ResourceHandlingOptionType":{ - "type":"string", - "max":64, - "min":1 - }, - "ResourceNameListType":{ - "type":"list", - "member":{"shape":"ResourceNameType"} - }, - "ResourceNameType":{ - "type":"string", - "max":2048, - "min":1 - }, - "ResourceSpecificResult":{ - "type":"structure", - "required":[ - "EvalResourceName", - "EvalResourceDecision" - ], - "members":{ - "EvalResourceName":{ - "shape":"ResourceNameType", - "documentation":"

The name of the simulated resource, in Amazon Resource Name (ARN) format.

" - }, - "EvalResourceDecision":{ - "shape":"PolicyEvaluationDecisionType", - "documentation":"

The result of the simulation of the simulated API operation on the resource specified in EvalResourceName.

" - }, - "MatchedStatements":{ - "shape":"StatementListType", - "documentation":"

A list of the statements in the input policies that determine the result for this part of the simulation. Remember that even if multiple statements allow the operation on the resource, if any statement denies that operation, then the explicit deny overrides any allow, and the deny statement is the only entry included in the result.

" - }, - "MissingContextValues":{ - "shape":"ContextKeyNamesResultListType", - "documentation":"

A list of context keys that are required by the included input policies but that were not provided by one of the input parameters. This list is used when a list of ARNs is included in the ResourceArns parameter instead of \"*\". If you do not specify individual resources, by setting ResourceArns to \"*\" or by not including the ResourceArns parameter, then any missing context values are instead included under the EvaluationResults section. To discover the context keys used by a set of policies, you can call GetContextKeysForCustomPolicy or GetContextKeysForPrincipalPolicy.

" - }, - "EvalDecisionDetails":{ - "shape":"EvalDecisionDetailsType", - "documentation":"

Additional details about the results of the evaluation decision. When there are both IAM policies and resource policies, this parameter explains how each set of policies contributes to the final evaluation decision. When simulating cross-account access to a resource, both the resource-based policy and the caller's IAM policy must grant access.

" - } - }, - "documentation":"

Contains the result of the simulation of a single API operation call on a single resource.

This data type is used by a member of the EvaluationResult data type.

" - }, - "ResourceSpecificResultListType":{ - "type":"list", - "member":{"shape":"ResourceSpecificResult"} - }, - "ResyncMFADeviceRequest":{ - "type":"structure", - "required":[ - "UserName", - "SerialNumber", - "AuthenticationCode1", - "AuthenticationCode2" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user whose MFA device you want to resynchronize.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

Serial number that uniquely identifies the MFA device.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "AuthenticationCode1":{ - "shape":"authenticationCodeType", - "documentation":"

An authentication code emitted by the device.

The format for this parameter is a sequence of six digits.

" - }, - "AuthenticationCode2":{ - "shape":"authenticationCodeType", - "documentation":"

A subsequent authentication code emitted by the device.

The format for this parameter is a sequence of six digits.

" - } - } - }, - "Role":{ - "type":"structure", - "required":[ - "Path", - "RoleName", - "RoleId", - "Arn", - "CreateDate" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the role. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The friendly name that identifies the role.

" - }, - "RoleId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the role. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) specifying the role. For more information about ARNs and how to use them in policies, see IAM Identifiers in the IAM User Guide guide.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the role was created.

" - }, - "AssumeRolePolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy that grants an entity permission to assume the role.

" - }, - "Description":{ - "shape":"roleDescriptionType", - "documentation":"

A description of the role that you provide.

" - }, - "MaxSessionDuration":{ - "shape":"roleMaxSessionDurationType", - "documentation":"

The maximum session duration (in seconds) for the specified role. Anyone who uses the AWS CLI or API to assume the role can specify the duration using the optional DurationSeconds API parameter or duration-seconds CLI parameter.

" - }, - "PermissionsBoundary":{ - "shape":"AttachedPermissionsBoundary", - "documentation":"

The ARN of the policy used to set the permissions boundary for the role.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about an IAM role. This structure is returned as a response element in several API operations that interact with roles.

" - }, - "RoleDetail":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the role. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The friendly name that identifies the role.

" - }, - "RoleId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the role. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{"shape":"arnType"}, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the role was created.

" - }, - "AssumeRolePolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The trust policy that grants permission to assume the role.

" - }, - "InstanceProfileList":{ - "shape":"instanceProfileListType", - "documentation":"

A list of instance profiles that contain this role.

" - }, - "RolePolicyList":{ - "shape":"policyDetailListType", - "documentation":"

A list of inline policies embedded in the role. These policies are the role's access (permissions) policies.

" - }, - "AttachedManagedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of managed policies attached to the role. These policies are the role's access (permissions) policies.

" - }, - "PermissionsBoundary":{ - "shape":"AttachedPermissionsBoundary", - "documentation":"

The ARN of the policy used to set the permissions boundary for the role.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about an IAM role, including all of the role's policies.

This data type is used as a response element in the GetAccountAuthorizationDetails operation.

" - }, - "RoleUsageListType":{ - "type":"list", - "member":{"shape":"RoleUsageType"} - }, - "RoleUsageType":{ - "type":"structure", - "members":{ - "Region":{ - "shape":"RegionNameType", - "documentation":"

The name of the region where the service-linked role is being used.

" - }, - "Resources":{ - "shape":"ArnListType", - "documentation":"

The name of the resource that is using the service-linked role.

" - } - }, - "documentation":"

An object that contains details about how a service-linked role is used, if that information is returned by the service.

This data type is used as a response element in the GetServiceLinkedRoleDeletionStatus operation.

" - }, - "SAMLMetadataDocumentType":{ - "type":"string", - "max":10000000, - "min":1000 - }, - "SAMLProviderListEntry":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider.

" - }, - "ValidUntil":{ - "shape":"dateType", - "documentation":"

The expiration date and time for the SAML provider.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time when the SAML provider was created.

" - } - }, - "documentation":"

Contains the list of SAML providers for this account.

" - }, - "SAMLProviderListType":{ - "type":"list", - "member":{"shape":"SAMLProviderListEntry"} - }, - "SAMLProviderNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w._-]+" - }, - "SSHPublicKey":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyId", - "Fingerprint", - "SSHPublicKeyBody", - "Status" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the SSH public key.

" - }, - "SSHPublicKeyId":{ - "shape":"publicKeyIdType", - "documentation":"

The unique identifier for the SSH public key.

" - }, - "Fingerprint":{ - "shape":"publicKeyFingerprintType", - "documentation":"

The MD5 message digest of the SSH public key.

" - }, - "SSHPublicKeyBody":{ - "shape":"publicKeyMaterialType", - "documentation":"

The SSH public key.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the SSH public key. Active means that the key can be used for authentication with an AWS CodeCommit repository. Inactive means that the key cannot be used.

" - }, - "UploadDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the SSH public key was uploaded.

" - } - }, - "documentation":"

Contains information about an SSH public key.

This data type is used as a response element in the GetSSHPublicKey and UploadSSHPublicKey operations.

" - }, - "SSHPublicKeyListType":{ - "type":"list", - "member":{"shape":"SSHPublicKeyMetadata"} - }, - "SSHPublicKeyMetadata":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyId", - "Status", - "UploadDate" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the SSH public key.

" - }, - "SSHPublicKeyId":{ - "shape":"publicKeyIdType", - "documentation":"

The unique identifier for the SSH public key.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the SSH public key. Active means that the key can be used for authentication with an AWS CodeCommit repository. Inactive means that the key cannot be used.

" - }, - "UploadDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the SSH public key was uploaded.

" - } - }, - "documentation":"

Contains information about an SSH public key, without the key's body or fingerprint.

This data type is used as a response element in the ListSSHPublicKeys operation.

" - }, - "ServerCertificate":{ - "type":"structure", - "required":[ - "ServerCertificateMetadata", - "CertificateBody" - ], - "members":{ - "ServerCertificateMetadata":{ - "shape":"ServerCertificateMetadata", - "documentation":"

The meta information of the server certificate, such as its name, path, ID, and ARN.

" - }, - "CertificateBody":{ - "shape":"certificateBodyType", - "documentation":"

The contents of the public key certificate.

" - }, - "CertificateChain":{ - "shape":"certificateChainType", - "documentation":"

The contents of the public key certificate chain.

" - } - }, - "documentation":"

Contains information about a server certificate.

This data type is used as a response element in the GetServerCertificate operation.

" - }, - "ServerCertificateMetadata":{ - "type":"structure", - "required":[ - "Path", - "ServerCertificateName", - "ServerCertificateId", - "Arn" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the server certificate. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "ServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The name that identifies the server certificate.

" - }, - "ServerCertificateId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the server certificate. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) specifying the server certificate. For more information about ARNs and how to use them in policies, see IAM Identifiers in the Using IAM guide.

" - }, - "UploadDate":{ - "shape":"dateType", - "documentation":"

The date when the server certificate was uploaded.

" - }, - "Expiration":{ - "shape":"dateType", - "documentation":"

The date on which the certificate is set to expire.

" - } - }, - "documentation":"

Contains information about a server certificate without its certificate body, certificate chain, and private key.

This data type is used as a response element in the UploadServerCertificate and ListServerCertificates operations.

" - }, - "ServiceFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"serviceFailureExceptionMessage"} - }, - "documentation":"

The request processing has failed because of an unknown error, exception or failure.

", - "error":{ - "code":"ServiceFailure", - "httpStatusCode":500 - }, - "exception":true - }, - "ServiceNotSupportedException":{ - "type":"structure", - "members":{ - "message":{"shape":"serviceNotSupportedMessage"} - }, - "documentation":"

The specified service does not support service-specific credentials.

", - "error":{ - "code":"NotSupportedService", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ServiceSpecificCredential":{ - "type":"structure", - "required":[ - "CreateDate", - "ServiceName", - "ServiceUserName", - "ServicePassword", - "ServiceSpecificCredentialId", - "UserName", - "Status" - ], - "members":{ - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the service-specific credential were created.

" - }, - "ServiceName":{ - "shape":"serviceName", - "documentation":"

The name of the service associated with the service-specific credential.

" - }, - "ServiceUserName":{ - "shape":"serviceUserName", - "documentation":"

The generated user name for the service-specific credential. This value is generated by combining the IAM user's name combined with the ID number of the AWS account, as in jane-at-123456789012, for example. This value cannot be configured by the user.

" - }, - "ServicePassword":{ - "shape":"servicePassword", - "documentation":"

The generated password for the service-specific credential.

" - }, - "ServiceSpecificCredentialId":{ - "shape":"serviceSpecificCredentialId", - "documentation":"

The unique identifier for the service-specific credential.

" - }, - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the service-specific credential.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the service-specific credential. Active means that the key is valid for API calls, while Inactive means it is not.

" - } - }, - "documentation":"

Contains the details of a service-specific credential.

" - }, - "ServiceSpecificCredentialMetadata":{ - "type":"structure", - "required":[ - "UserName", - "Status", - "ServiceUserName", - "CreateDate", - "ServiceSpecificCredentialId", - "ServiceName" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the service-specific credential.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the service-specific credential. Active means that the key is valid for API calls, while Inactive means it is not.

" - }, - "ServiceUserName":{ - "shape":"serviceUserName", - "documentation":"

The generated user name for the service-specific credential.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the service-specific credential were created.

" - }, - "ServiceSpecificCredentialId":{ - "shape":"serviceSpecificCredentialId", - "documentation":"

The unique identifier for the service-specific credential.

" - }, - "ServiceName":{ - "shape":"serviceName", - "documentation":"

The name of the service associated with the service-specific credential.

" - } - }, - "documentation":"

Contains additional details about a service-specific credential.

" - }, - "ServiceSpecificCredentialsListType":{ - "type":"list", - "member":{"shape":"ServiceSpecificCredentialMetadata"} - }, - "SetDefaultPolicyVersionRequest":{ - "type":"structure", - "required":[ - "PolicyArn", - "VersionId" - ], - "members":{ - "PolicyArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM policy whose default version you want to set.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "VersionId":{ - "shape":"policyVersionIdType", - "documentation":"

The version of the policy to set as the default (operative) version.

For more information about managed policy versions, see Versioning for Managed Policies in the IAM User Guide.

" - } - } - }, - "SigningCertificate":{ - "type":"structure", - "required":[ - "UserName", - "CertificateId", - "CertificateBody", - "Status" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user the signing certificate is associated with.

" - }, - "CertificateId":{ - "shape":"certificateIdType", - "documentation":"

The ID for the signing certificate.

" - }, - "CertificateBody":{ - "shape":"certificateBodyType", - "documentation":"

The contents of the signing certificate.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status of the signing certificate. Active means that the key is valid for API calls, while Inactive means it is not.

" - }, - "UploadDate":{ - "shape":"dateType", - "documentation":"

The date when the signing certificate was uploaded.

" - } - }, - "documentation":"

Contains information about an X.509 signing certificate.

This data type is used as a response element in the UploadSigningCertificate and ListSigningCertificates operations.

" - }, - "SimulateCustomPolicyRequest":{ - "type":"structure", - "required":[ - "PolicyInputList", - "ActionNames" - ], - "members":{ - "PolicyInputList":{ - "shape":"SimulationPolicyListType", - "documentation":"

A list of policy documents to include in the simulation. Each document is specified as a string containing the complete, valid JSON text of an IAM policy. Do not include any resource-based policies in this parameter. Any resource-based policy must be submitted with the ResourcePolicy parameter. The policies cannot be \"scope-down\" policies, such as you could include in a call to GetFederationToken or one of the AssumeRole API operations. In other words, do not use policies designed to restrict what a user can do while using the temporary credentials.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "ActionNames":{ - "shape":"ActionNameListType", - "documentation":"

A list of names of API operations to evaluate in the simulation. Each operation is evaluated against each resource. Each operation must include the service identifier, such as iam:CreateUser.

" - }, - "ResourceArns":{ - "shape":"ResourceNameListType", - "documentation":"

A list of ARNs of AWS resources to include in the simulation. If this parameter is not provided then the value defaults to * (all resources). Each API in the ActionNames parameter is evaluated for each resource in this list. The simulation determines the access result (allowed or denied) of each combination and reports it in the response.

The simulation does not automatically retrieve policies for the specified resources. If you want to include a resource policy in the simulation, then you must include the policy as a string in the ResourcePolicy parameter.

If you include a ResourcePolicy, then it must be applicable to all of the resources included in the simulation or you receive an invalid input error.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "ResourcePolicy":{ - "shape":"policyDocumentType", - "documentation":"

A resource-based policy to include in the simulation provided as a string. Each resource in the simulation is treated as if it had this policy attached. You can include only one resource-based policy in a simulation.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "ResourceOwner":{ - "shape":"ResourceNameType", - "documentation":"

An ARN representing the AWS account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN, such as an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

The ARN for an account uses the following syntax: arn:aws:iam::AWS-account-ID:root. For example, to represent the account with the 112233445566 ID, use the following ARN: arn:aws:iam::112233445566-ID:root.

" - }, - "CallerArn":{ - "shape":"ResourceNameType", - "documentation":"

The ARN of the IAM user that you want to use as the simulated caller of the API operations. CallerArn is required if you include a ResourcePolicy so that the policy's Principal element has a value to use in evaluating the policy.

You can specify only the ARN of an IAM user. You cannot specify the ARN of an assumed role, federated user, or a service principal.

" - }, - "ContextEntries":{ - "shape":"ContextEntryListType", - "documentation":"

A list of context keys and corresponding values for the simulation to use. Whenever a context key is evaluated in one of the simulated IAM permission policies, the corresponding value is supplied.

" - }, - "ResourceHandlingOption":{ - "shape":"ResourceHandlingOptionType", - "documentation":"

Specifies the type of simulation to run. Different API operations that support resource-based policies require different combinations of resources. By specifying the type of simulation to run, you enable the policy simulator to enforce the presence of the required resources to ensure reliable simulation results. If your simulation does not match one of the following scenarios, then you can omit this parameter. The following list shows each of the supported scenario values and the resources that you must define to run the simulation.

Each of the EC2 scenarios requires that you specify instance, image, and security-group resources. If your scenario includes an EBS volume, then you must specify that volume as a resource. If the EC2 scenario includes VPC, then you must supply the network-interface resource. If it includes an IP subnet, then you must specify the subnet resource. For more information on the EC2 scenario options, see Supported Platforms in the Amazon EC2 User Guide.

  • EC2-Classic-InstanceStore

    instance, image, security-group

  • EC2-Classic-EBS

    instance, image, security-group, volume

  • EC2-VPC-InstanceStore

    instance, image, security-group, network-interface

  • EC2-VPC-InstanceStore-Subnet

    instance, image, security-group, network-interface, subnet

  • EC2-VPC-EBS

    instance, image, security-group, network-interface, volume

  • EC2-VPC-EBS-Subnet

    instance, image, security-group, network-interface, subnet, volume

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - } - } - }, - "SimulatePolicyResponse":{ - "type":"structure", - "members":{ - "EvaluationResults":{ - "shape":"EvaluationResultsListType", - "documentation":"

The results of the simulation.

" - }, - "IsTruncated":{ - "shape":"booleanType", - "documentation":"

A flag that indicates whether there are more items to return. If your results were truncated, you can make a subsequent pagination request using the Marker request parameter to retrieve more items. Note that IAM might return fewer than the MaxItems number of results even when there are more results available. We recommend that you check IsTruncated after every call to ensure that you receive all of your results.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

When IsTruncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent pagination request.

" - } - }, - "documentation":"

Contains the response to a successful SimulatePrincipalPolicy or SimulateCustomPolicy request.

" - }, - "SimulatePrincipalPolicyRequest":{ - "type":"structure", - "required":[ - "PolicySourceArn", - "ActionNames" - ], - "members":{ - "PolicySourceArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of a user, group, or role whose policies you want to include in the simulation. If you specify a user, group, or role, the simulation includes all policies that are associated with that entity. If you specify a user, the simulation also includes all policies that are attached to any groups the user belongs to.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "PolicyInputList":{ - "shape":"SimulationPolicyListType", - "documentation":"

An optional list of additional policy documents to include in the simulation. Each document is specified as a string containing the complete, valid JSON text of an IAM policy.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "ActionNames":{ - "shape":"ActionNameListType", - "documentation":"

A list of names of API operations to evaluate in the simulation. Each operation is evaluated for each resource. Each operation must include the service identifier, such as iam:CreateUser.

" - }, - "ResourceArns":{ - "shape":"ResourceNameListType", - "documentation":"

A list of ARNs of AWS resources to include in the simulation. If this parameter is not provided, then the value defaults to * (all resources). Each API in the ActionNames parameter is evaluated for each resource in this list. The simulation determines the access result (allowed or denied) of each combination and reports it in the response.

The simulation does not automatically retrieve policies for the specified resources. If you want to include a resource policy in the simulation, then you must include the policy as a string in the ResourcePolicy parameter.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "ResourcePolicy":{ - "shape":"policyDocumentType", - "documentation":"

A resource-based policy to include in the simulation provided as a string. Each resource in the simulation is treated as if it had this policy attached. You can include only one resource-based policy in a simulation.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "ResourceOwner":{ - "shape":"ResourceNameType", - "documentation":"

An AWS account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN, such as an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

" - }, - "CallerArn":{ - "shape":"ResourceNameType", - "documentation":"

The ARN of the IAM user that you want to specify as the simulated caller of the API operations. If you do not specify a CallerArn, it defaults to the ARN of the user that you specify in PolicySourceArn, if you specified a user. If you include both a PolicySourceArn (for example, arn:aws:iam::123456789012:user/David) and a CallerArn (for example, arn:aws:iam::123456789012:user/Bob), the result is that you simulate calling the API operations as Bob, as if Bob had David's policies.

You can specify only the ARN of an IAM user. You cannot specify the ARN of an assumed role, federated user, or a service principal.

CallerArn is required if you include a ResourcePolicy and the PolicySourceArn is not the ARN for an IAM user. This is required so that the resource-based policy's Principal element has a value to use in evaluating the policy.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "ContextEntries":{ - "shape":"ContextEntryListType", - "documentation":"

A list of context keys and corresponding values for the simulation to use. Whenever a context key is evaluated in one of the simulated IAM permission policies, the corresponding value is supplied.

" - }, - "ResourceHandlingOption":{ - "shape":"ResourceHandlingOptionType", - "documentation":"

Specifies the type of simulation to run. Different API operations that support resource-based policies require different combinations of resources. By specifying the type of simulation to run, you enable the policy simulator to enforce the presence of the required resources to ensure reliable simulation results. If your simulation does not match one of the following scenarios, then you can omit this parameter. The following list shows each of the supported scenario values and the resources that you must define to run the simulation.

Each of the EC2 scenarios requires that you specify instance, image, and security-group resources. If your scenario includes an EBS volume, then you must specify that volume as a resource. If the EC2 scenario includes VPC, then you must supply the network-interface resource. If it includes an IP subnet, then you must specify the subnet resource. For more information on the EC2 scenario options, see Supported Platforms in the Amazon EC2 User Guide.

  • EC2-Classic-InstanceStore

    instance, image, security-group

  • EC2-Classic-EBS

    instance, image, security-group, volume

  • EC2-VPC-InstanceStore

    instance, image, security-group, network-interface

  • EC2-VPC-InstanceStore-Subnet

    instance, image, security-group, network-interface, subnet

  • EC2-VPC-EBS

    instance, image, security-group, network-interface, volume

  • EC2-VPC-EBS-Subnet

    instance, image, security-group, network-interface, subnet, volume

" - }, - "MaxItems":{ - "shape":"maxItemsType", - "documentation":"

(Optional) Use this only when paginating results to indicate the maximum number of items you want in the response. If additional items exist beyond the maximum you specify, the IsTruncated response element is true.

If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when there are more results available. In that case, the IsTruncated response element returns true and Marker contains a value to include in the subsequent call that tells the service where to continue from.

" - }, - "Marker":{ - "shape":"markerType", - "documentation":"

Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the Marker element in the response that you received to indicate where the next call should start.

" - } - } - }, - "SimulationPolicyListType":{ - "type":"list", - "member":{"shape":"policyDocumentType"} - }, - "Statement":{ - "type":"structure", - "members":{ - "SourcePolicyId":{ - "shape":"PolicyIdentifierType", - "documentation":"

The identifier of the policy that was provided as an input.

" - }, - "SourcePolicyType":{ - "shape":"PolicySourceType", - "documentation":"

The type of the policy.

" - }, - "StartPosition":{ - "shape":"Position", - "documentation":"

The row and column of the beginning of the Statement in an IAM policy.

" - }, - "EndPosition":{ - "shape":"Position", - "documentation":"

The row and column of the end of a Statement in an IAM policy.

" - } - }, - "documentation":"

Contains a reference to a Statement element in a policy document that determines the result of the simulation.

This data type is used by the MatchedStatements member of the EvaluationResult type.

" - }, - "StatementListType":{ - "type":"list", - "member":{"shape":"Statement"} - }, - "UnmodifiableEntityException":{ - "type":"structure", - "members":{ - "message":{"shape":"unmodifiableEntityMessage"} - }, - "documentation":"

The request was rejected because only the service that depends on the service-linked role can modify or delete the role on your behalf. The error message includes the name of the service that depends on this service-linked role. You must request the change through that service.

", - "error":{ - "code":"UnmodifiableEntity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnrecognizedPublicKeyEncodingException":{ - "type":"structure", - "members":{ - "message":{"shape":"unrecognizedPublicKeyEncodingMessage"} - }, - "documentation":"

The request was rejected because the public key encoding format is unsupported or unrecognized.

", - "error":{ - "code":"UnrecognizedPublicKeyEncoding", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UpdateAccessKeyRequest":{ - "type":"structure", - "required":[ - "AccessKeyId", - "Status" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user whose key you want to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The access key ID of the secret access key you want to update.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status you want to assign to the secret access key. Active means that the key can be used for API calls to AWS, while Inactive means that the key cannot be used.

" - } - } - }, - "UpdateAccountPasswordPolicyRequest":{ - "type":"structure", - "members":{ - "MinimumPasswordLength":{ - "shape":"minimumPasswordLengthType", - "documentation":"

The minimum number of characters allowed in an IAM user password.

If you do not specify a value for this parameter, then the operation uses the default value of 6.

" - }, - "RequireSymbols":{ - "shape":"booleanType", - "documentation":"

Specifies whether IAM user passwords must contain at least one of the following non-alphanumeric characters:

! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one symbol character.

" - }, - "RequireNumbers":{ - "shape":"booleanType", - "documentation":"

Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one numeric character.

" - }, - "RequireUppercaseCharacters":{ - "shape":"booleanType", - "documentation":"

Specifies whether IAM user passwords must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one uppercase character.

" - }, - "RequireLowercaseCharacters":{ - "shape":"booleanType", - "documentation":"

Specifies whether IAM user passwords must contain at least one lowercase character from the ISO basic Latin alphabet (a to z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one lowercase character.

" - }, - "AllowUsersToChangePassword":{ - "shape":"booleanType", - "documentation":"

Allows all IAM users in your account to use the AWS Management Console to change their own passwords. For more information, see Letting IAM Users Change Their Own Passwords in the IAM User Guide.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

" - }, - "MaxPasswordAge":{ - "shape":"maxPasswordAgeType", - "documentation":"

The number of days that an IAM user password is valid.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM user passwords never expire.

" - }, - "PasswordReusePrevention":{ - "shape":"passwordReusePreventionType", - "documentation":"

Specifies the number of previous passwords that IAM users are prevented from reusing.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM users are not prevented from reusing previous passwords.

" - }, - "HardExpiry":{ - "shape":"booleanObjectType", - "documentation":"

Prevents IAM users from setting a new password after their password has expired. The IAM user cannot be accessed until an administrator resets the password.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users can change their passwords after they expire and continue to sign in as the user.

" - } - } - }, - "UpdateAssumeRolePolicyRequest":{ - "type":"structure", - "required":[ - "RoleName", - "PolicyDocument" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role to update with the new policy.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "PolicyDocument":{ - "shape":"policyDocumentType", - "documentation":"

The policy that grants an entity permission to assume the role.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "UpdateGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"groupNameType", - "documentation":"

Name of the IAM group to update. If you're changing the name of the group, this is the original name.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "NewPath":{ - "shape":"pathType", - "documentation":"

New path for the IAM group. Only include this if changing the group's path.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "NewGroupName":{ - "shape":"groupNameType", - "documentation":"

New name for the IAM group. Only include this if changing the group's name.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "UpdateLoginProfileRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the user whose password you want to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "Password":{ - "shape":"passwordType", - "documentation":"

The new password for the specified IAM user.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

However, the format can be further restricted by the account administrator by setting a password policy on the AWS account. For more information, see UpdateAccountPasswordPolicy.

" - }, - "PasswordResetRequired":{ - "shape":"booleanObjectType", - "documentation":"

Allows this new password to be used only once by requiring the specified IAM user to set a new password on next sign-in.

" - } - } - }, - "UpdateOpenIDConnectProviderThumbprintRequest":{ - "type":"structure", - "required":[ - "OpenIDConnectProviderArn", - "ThumbprintList" - ], - "members":{ - "OpenIDConnectProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the IAM OIDC provider resource object for which you want to update the thumbprint. You can get a list of OIDC provider ARNs by using the ListOpenIDConnectProviders operation.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "ThumbprintList":{ - "shape":"thumbprintListType", - "documentation":"

A list of certificate thumbprints that are associated with the specified IAM OpenID Connect provider. For more information, see CreateOpenIDConnectProvider.

" - } - } - }, - "UpdateRoleDescriptionRequest":{ - "type":"structure", - "required":[ - "RoleName", - "Description" - ], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role that you want to modify.

" - }, - "Description":{ - "shape":"roleDescriptionType", - "documentation":"

The new description that you want to apply to the specified role.

" - } - } - }, - "UpdateRoleDescriptionResponse":{ - "type":"structure", - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

A structure that contains details about the modified role.

" - } - } - }, - "UpdateRoleRequest":{ - "type":"structure", - "required":["RoleName"], - "members":{ - "RoleName":{ - "shape":"roleNameType", - "documentation":"

The name of the role that you want to modify.

" - }, - "Description":{ - "shape":"roleDescriptionType", - "documentation":"

The new description that you want to apply to the specified role.

" - }, - "MaxSessionDuration":{ - "shape":"roleMaxSessionDurationType", - "documentation":"

The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.

Anyone who assumes the role from the AWS CLI or API can use the DurationSeconds API parameter or the duration-seconds CLI parameter to request a longer session. The MaxSessionDuration setting determines the maximum duration that can be requested using the DurationSeconds parameter. If users don't specify a value for the DurationSeconds parameter, their security credentials are valid for one hour by default. This applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide.

" - } - } - }, - "UpdateRoleResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateSAMLProviderRequest":{ - "type":"structure", - "required":[ - "SAMLMetadataDocument", - "SAMLProviderArn" - ], - "members":{ - "SAMLMetadataDocument":{ - "shape":"SAMLMetadataDocumentType", - "documentation":"

An XML document generated by an identity provider (IdP) that supports SAML 2.0. The document includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that are received from the IdP. You must generate the metadata document using the identity management software that is used as your organization's IdP.

" - }, - "SAMLProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider to update.

For more information about ARNs, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - } - } - }, - "UpdateSAMLProviderResponse":{ - "type":"structure", - "members":{ - "SAMLProviderArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider that was updated.

" - } - }, - "documentation":"

Contains the response to a successful UpdateSAMLProvider request.

" - }, - "UpdateSSHPublicKeyRequest":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyId", - "Status" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the SSH public key.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SSHPublicKeyId":{ - "shape":"publicKeyIdType", - "documentation":"

The unique identifier for the SSH public key.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status to assign to the SSH public key. Active means that the key can be used for authentication with an AWS CodeCommit repository. Inactive means that the key cannot be used.

" - } - } - }, - "UpdateServerCertificateRequest":{ - "type":"structure", - "required":["ServerCertificateName"], - "members":{ - "ServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The name of the server certificate that you want to update.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "NewPath":{ - "shape":"pathType", - "documentation":"

The new path for the server certificate. Include this only if you are updating the server certificate's path.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "NewServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The new name for the server certificate. Include this only if you are updating the server certificate's name. The name of the certificate cannot contain any spaces.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "UpdateServiceSpecificCredentialRequest":{ - "type":"structure", - "required":[ - "ServiceSpecificCredentialId", - "Status" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user associated with the service-specific credential. If you do not specify this value, then the operation assumes the user whose credentials are used to call the operation.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "ServiceSpecificCredentialId":{ - "shape":"serviceSpecificCredentialId", - "documentation":"

The unique identifier of the service-specific credential.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status to be assigned to the service-specific credential.

" - } - } - }, - "UpdateSigningCertificateRequest":{ - "type":"structure", - "required":[ - "CertificateId", - "Status" - ], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the IAM user the signing certificate belongs to.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "CertificateId":{ - "shape":"certificateIdType", - "documentation":"

The ID of the signing certificate you want to update.

This parameter allows (per its regex pattern) a string of characters that can consist of any upper or lowercased letter or digit.

" - }, - "Status":{ - "shape":"statusType", - "documentation":"

The status you want to assign to the certificate. Active means that the certificate can be used for API calls to AWS Inactive means that the certificate cannot be used.

" - } - } - }, - "UpdateUserRequest":{ - "type":"structure", - "required":["UserName"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

Name of the user to update. If you're changing the name of the user, this is the original user name.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "NewPath":{ - "shape":"pathType", - "documentation":"

New path for the IAM user. Include this parameter only if you're changing the user's path.

This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

" - }, - "NewUserName":{ - "shape":"userNameType", - "documentation":"

New name for the user. Include this parameter only if you're changing the user's name.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - } - } - }, - "UploadSSHPublicKeyRequest":{ - "type":"structure", - "required":[ - "UserName", - "SSHPublicKeyBody" - ], - "members":{ - "UserName":{ - "shape":"userNameType", - "documentation":"

The name of the IAM user to associate the SSH public key with.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "SSHPublicKeyBody":{ - "shape":"publicKeyMaterialType", - "documentation":"

The SSH public key. The public key must be encoded in ssh-rsa format or PEM format. The miminum bit-length of the public key is 2048 bits. For example, you can generate a 2048-bit key, and the resulting PEM file is 1679 bytes long.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "UploadSSHPublicKeyResponse":{ - "type":"structure", - "members":{ - "SSHPublicKey":{ - "shape":"SSHPublicKey", - "documentation":"

Contains information about the SSH public key.

" - } - }, - "documentation":"

Contains the response to a successful UploadSSHPublicKey request.

" - }, - "UploadServerCertificateRequest":{ - "type":"structure", - "required":[ - "ServerCertificateName", - "CertificateBody", - "PrivateKey" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path for the server certificate. For more information about paths, see IAM Identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/). This parameter allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

If you are uploading a server certificate specifically for use with Amazon CloudFront distributions, you must specify a path using the path parameter. The path must begin with /cloudfront and must include a trailing slash (for example, /cloudfront/test/).

" - }, - "ServerCertificateName":{ - "shape":"serverCertificateNameType", - "documentation":"

The name for the server certificate. Do not include the path in this value. The name of the certificate cannot contain any spaces.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "CertificateBody":{ - "shape":"certificateBodyType", - "documentation":"

The contents of the public key certificate in PEM-encoded format.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "PrivateKey":{ - "shape":"privateKeyType", - "documentation":"

The contents of the private key in PEM-encoded format.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - }, - "CertificateChain":{ - "shape":"certificateChainType", - "documentation":"

The contents of the certificate chain. This is typically a concatenation of the PEM-encoded public key certificates of the chain.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "UploadServerCertificateResponse":{ - "type":"structure", - "members":{ - "ServerCertificateMetadata":{ - "shape":"ServerCertificateMetadata", - "documentation":"

The meta information of the uploaded server certificate without its certificate body, certificate chain, and private key.

" - } - }, - "documentation":"

Contains the response to a successful UploadServerCertificate request.

" - }, - "UploadSigningCertificateRequest":{ - "type":"structure", - "required":["CertificateBody"], - "members":{ - "UserName":{ - "shape":"existingUserNameType", - "documentation":"

The name of the user the signing certificate is for.

This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

" - }, - "CertificateBody":{ - "shape":"certificateBodyType", - "documentation":"

The contents of the signing certificate.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

  • Any printable ASCII character ranging from the space character (\\u0020) through the end of the ASCII character range

  • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \\u00FF)

  • The special characters tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D)

" - } - } - }, - "UploadSigningCertificateResponse":{ - "type":"structure", - "required":["Certificate"], - "members":{ - "Certificate":{ - "shape":"SigningCertificate", - "documentation":"

Information about the certificate.

" - } - }, - "documentation":"

Contains the response to a successful UploadSigningCertificate request.

" - }, - "User":{ - "type":"structure", - "required":[ - "Path", - "UserName", - "UserId", - "Arn", - "CreateDate" - ], - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the user. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "UserName":{ - "shape":"userNameType", - "documentation":"

The friendly name identifying the user.

" - }, - "UserId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the user. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) that identifies the user. For more information about ARNs and how to use ARNs in policies, see IAM Identifiers in the Using IAM guide.

" - }, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the user was created.

" - }, - "PasswordLastUsed":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the user's password was last used to sign in to an AWS website. For a list of AWS websites that capture a user's last sign-in time, see the Credential Reports topic in the Using IAM guide. If a password is used more than once in a five-minute span, only the first use is returned in this field. If the field is null (no value) then it indicates that they never signed in with a password. This can be because:

  • The user never had a password.

  • A password exists but has not been used since IAM started tracking this information on October 20th, 2014.

A null does not mean that the user never had a password. Also, if the user does not currently have a password, but had one in the past, then this field contains the date and time the most recent password was used.

This value is returned only in the GetUser and ListUsers operations.

" - }, - "PermissionsBoundary":{ - "shape":"AttachedPermissionsBoundary", - "documentation":"

The ARN of the policy used to set the permissions boundary for the user.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about an IAM user entity.

This data type is used as a response element in the following operations:

" - }, - "UserDetail":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"pathType", - "documentation":"

The path to the user. For more information about paths, see IAM Identifiers in the Using IAM guide.

" - }, - "UserName":{ - "shape":"userNameType", - "documentation":"

The friendly name identifying the user.

" - }, - "UserId":{ - "shape":"idType", - "documentation":"

The stable and unique string identifying the user. For more information about IDs, see IAM Identifiers in the Using IAM guide.

" - }, - "Arn":{"shape":"arnType"}, - "CreateDate":{ - "shape":"dateType", - "documentation":"

The date and time, in ISO 8601 date-time format, when the user was created.

" - }, - "UserPolicyList":{ - "shape":"policyDetailListType", - "documentation":"

A list of the inline policies embedded in the user.

" - }, - "GroupList":{ - "shape":"groupNameListType", - "documentation":"

A list of IAM groups that the user is in.

" - }, - "AttachedManagedPolicies":{ - "shape":"attachedPoliciesListType", - "documentation":"

A list of the managed policies attached to the user.

" - }, - "PermissionsBoundary":{ - "shape":"AttachedPermissionsBoundary", - "documentation":"

The ARN of the policy used to set the permissions boundary for the user.

For more information about permissions boundaries, see Permissions Boundaries for IAM Identities in the IAM User Guide.

" - } - }, - "documentation":"

Contains information about an IAM user, including all the user's policies and all the IAM groups the user is in.

This data type is used as a response element in the GetAccountAuthorizationDetails operation.

" - }, - "VirtualMFADevice":{ - "type":"structure", - "required":["SerialNumber"], - "members":{ - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The serial number associated with VirtualMFADevice.

" - }, - "Base32StringSeed":{ - "shape":"BootstrapDatum", - "documentation":"

The Base32 seed defined as specified in RFC3548. The Base32StringSeed is Base64-encoded.

" - }, - "QRCodePNG":{ - "shape":"BootstrapDatum", - "documentation":"

A QR code PNG image that encodes otpauth://totp/$virtualMFADeviceName@$AccountName?secret=$Base32String where $virtualMFADeviceName is one of the create call arguments, AccountName is the user name if set (otherwise, the account ID otherwise), and Base32String is the seed in Base32 format. The Base32String value is Base64-encoded.

" - }, - "User":{ - "shape":"User", - "documentation":"

The IAM user associated with this virtual MFA device.

" - }, - "EnableDate":{ - "shape":"dateType", - "documentation":"

The date and time on which the virtual MFA device was enabled.

" - } - }, - "documentation":"

Contains information about a virtual MFA device.

" - }, - "accessKeyIdType":{ - "type":"string", - "max":128, - "min":16, - "pattern":"[\\w]+" - }, - "accessKeyMetadataListType":{ - "type":"list", - "member":{"shape":"AccessKeyMetadata"}, - "documentation":"

Contains a list of access key metadata.

This data type is used as a response element in the ListAccessKeys operation.

" - }, - "accessKeySecretType":{ - "type":"string", - "sensitive":true - }, - "accountAliasListType":{ - "type":"list", - "member":{"shape":"accountAliasType"} - }, - "accountAliasType":{ - "type":"string", - "max":63, - "min":3, - "pattern":"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$" - }, - "arnType":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN). ARNs are unique identifiers for AWS resources.

For more information about ARNs, go to Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

", - "max":2048, - "min":20 - }, - "assignmentStatusType":{ - "type":"string", - "enum":[ - "Assigned", - "Unassigned", - "Any" - ] - }, - "attachedPoliciesListType":{ - "type":"list", - "member":{"shape":"AttachedPolicy"} - }, - "attachmentCountType":{"type":"integer"}, - "authenticationCodeType":{ - "type":"string", - "max":6, - "min":6, - "pattern":"[\\d]+" - }, - "booleanObjectType":{ - "type":"boolean", - "box":true - }, - "booleanType":{"type":"boolean"}, - "certificateBodyType":{ - "type":"string", - "max":16384, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "certificateChainType":{ - "type":"string", - "max":2097152, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "certificateIdType":{ - "type":"string", - "max":128, - "min":24, - "pattern":"[\\w]+" - }, - "certificateListType":{ - "type":"list", - "member":{"shape":"SigningCertificate"}, - "documentation":"

Contains a list of signing certificates.

This data type is used as a response element in the ListSigningCertificates operation.

" - }, - "clientIDListType":{ - "type":"list", - "member":{"shape":"clientIDType"} - }, - "clientIDType":{ - "type":"string", - "max":255, - "min":1 - }, - "credentialReportExpiredExceptionMessage":{"type":"string"}, - "credentialReportNotPresentExceptionMessage":{"type":"string"}, - "credentialReportNotReadyExceptionMessage":{"type":"string"}, - "customSuffixType":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "dateType":{"type":"timestamp"}, - "deleteConflictMessage":{"type":"string"}, - "duplicateCertificateMessage":{"type":"string"}, - "duplicateSSHPublicKeyMessage":{"type":"string"}, - "encodingType":{ - "type":"string", - "enum":[ - "SSH", - "PEM" - ] - }, - "entityAlreadyExistsMessage":{"type":"string"}, - "entityListType":{ - "type":"list", - "member":{"shape":"EntityType"} - }, - "entityTemporarilyUnmodifiableMessage":{"type":"string"}, - "existingUserNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "groupDetailListType":{ - "type":"list", - "member":{"shape":"GroupDetail"} - }, - "groupListType":{ - "type":"list", - "member":{"shape":"Group"}, - "documentation":"

Contains a list of IAM groups.

This data type is used as a response element in the ListGroups operation.

" - }, - "groupNameListType":{ - "type":"list", - "member":{"shape":"groupNameType"} - }, - "groupNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "idType":{ - "type":"string", - "max":128, - "min":16, - "pattern":"[\\w]+" - }, - "instanceProfileListType":{ - "type":"list", - "member":{"shape":"InstanceProfile"}, - "documentation":"

Contains a list of instance profiles.

" - }, - "instanceProfileNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "invalidAuthenticationCodeMessage":{"type":"string"}, - "invalidCertificateMessage":{"type":"string"}, - "invalidInputMessage":{"type":"string"}, - "invalidPublicKeyMessage":{"type":"string"}, - "invalidUserTypeMessage":{"type":"string"}, - "keyPairMismatchMessage":{"type":"string"}, - "limitExceededMessage":{"type":"string"}, - "malformedCertificateMessage":{"type":"string"}, - "malformedPolicyDocumentMessage":{"type":"string"}, - "markerType":{ - "type":"string", - "max":320, - "min":1, - "pattern":"[\\u0020-\\u00FF]+" - }, - "maxItemsType":{ - "type":"integer", - "max":1000, - "min":1 - }, - "maxPasswordAgeType":{ - "type":"integer", - "box":true, - "max":1095, - "min":1 - }, - "mfaDeviceListType":{ - "type":"list", - "member":{"shape":"MFADevice"}, - "documentation":"

Contains a list of MFA devices.

This data type is used as a response element in the ListMFADevices and ListVirtualMFADevices operations.

" - }, - "minimumPasswordLengthType":{ - "type":"integer", - "max":128, - "min":6 - }, - "noSuchEntityMessage":{"type":"string"}, - "passwordPolicyViolationMessage":{"type":"string"}, - "passwordReusePreventionType":{ - "type":"integer", - "box":true, - "max":24, - "min":1 - }, - "passwordType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+", - "sensitive":true - }, - "pathPrefixType":{ - "type":"string", - "max":512, - "min":1, - "pattern":"\\u002F[\\u0021-\\u007F]*" - }, - "pathType":{ - "type":"string", - "max":512, - "min":1, - "pattern":"(\\u002F)|(\\u002F[\\u0021-\\u007F]+\\u002F)" - }, - "policyDescriptionType":{ - "type":"string", - "max":1000 - }, - "policyDetailListType":{ - "type":"list", - "member":{"shape":"PolicyDetail"} - }, - "policyDocumentType":{ - "type":"string", - "max":131072, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "policyDocumentVersionListType":{ - "type":"list", - "member":{"shape":"PolicyVersion"} - }, - "policyEvaluationErrorMessage":{"type":"string"}, - "policyListType":{ - "type":"list", - "member":{"shape":"Policy"} - }, - "policyNameListType":{ - "type":"list", - "member":{"shape":"policyNameType"}, - "documentation":"

Contains a list of policy names.

This data type is used as a response element in the ListPolicies operation.

" - }, - "policyNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "policyNotAttachableMessage":{"type":"string"}, - "policyPathType":{ - "type":"string", - "pattern":"((/[A-Za-z0-9\\.,\\+@=_-]+)*)/" - }, - "policyScopeType":{ - "type":"string", - "enum":[ - "All", - "AWS", - "Local" - ] - }, - "policyVersionIdType":{ - "type":"string", - "pattern":"v[1-9][0-9]*(\\.[A-Za-z0-9-]*)?" - }, - "privateKeyType":{ - "type":"string", - "max":16384, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+", - "sensitive":true - }, - "publicKeyFingerprintType":{ - "type":"string", - "max":48, - "min":48, - "pattern":"[:\\w]+" - }, - "publicKeyIdType":{ - "type":"string", - "max":128, - "min":20, - "pattern":"[\\w]+" - }, - "publicKeyMaterialType":{ - "type":"string", - "max":16384, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "roleDescriptionType":{ - "type":"string", - "max":1000, - "pattern":"[\\p{L}\\p{M}\\p{Z}\\p{S}\\p{N}\\p{P}]*" - }, - "roleDetailListType":{ - "type":"list", - "member":{"shape":"RoleDetail"} - }, - "roleListType":{ - "type":"list", - "member":{"shape":"Role"}, - "documentation":"

Contains a list of IAM roles.

This data type is used as a response element in the ListRoles operation.

" - }, - "roleMaxSessionDurationType":{ - "type":"integer", - "max":43200, - "min":3600 - }, - "roleNameType":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "serialNumberType":{ - "type":"string", - "max":256, - "min":9, - "pattern":"[\\w+=/:,.@-]+" - }, - "serverCertificateMetadataListType":{ - "type":"list", - "member":{"shape":"ServerCertificateMetadata"} - }, - "serverCertificateNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "serviceFailureExceptionMessage":{"type":"string"}, - "serviceName":{"type":"string"}, - "serviceNotSupportedMessage":{"type":"string"}, - "servicePassword":{ - "type":"string", - "sensitive":true - }, - "serviceSpecificCredentialId":{ - "type":"string", - "max":128, - "min":20, - "pattern":"[\\w]+" - }, - "serviceUserName":{ - "type":"string", - "max":200, - "min":17, - "pattern":"[\\w+=,.@-]+" - }, - "statusType":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "stringType":{"type":"string"}, - "summaryKeyType":{ - "type":"string", - "enum":[ - "Users", - "UsersQuota", - "Groups", - "GroupsQuota", - "ServerCertificates", - "ServerCertificatesQuota", - "UserPolicySizeQuota", - "GroupPolicySizeQuota", - "GroupsPerUserQuota", - "SigningCertificatesPerUserQuota", - "AccessKeysPerUserQuota", - "MFADevices", - "MFADevicesInUse", - "AccountMFAEnabled", - "AccountAccessKeysPresent", - "AccountSigningCertificatesPresent", - "AttachedPoliciesPerGroupQuota", - "AttachedPoliciesPerRoleQuota", - "AttachedPoliciesPerUserQuota", - "Policies", - "PoliciesQuota", - "PolicySizeQuota", - "PolicyVersionsInUse", - "PolicyVersionsInUseQuota", - "VersionsPerPolicyQuota" - ] - }, - "summaryMapType":{ - "type":"map", - "key":{"shape":"summaryKeyType"}, - "value":{"shape":"summaryValueType"} - }, - "summaryValueType":{"type":"integer"}, - "thumbprintListType":{ - "type":"list", - "member":{"shape":"thumbprintType"}, - "documentation":"

Contains a list of thumbprints of identity provider server certificates.

" - }, - "thumbprintType":{ - "type":"string", - "documentation":"

Contains a thumbprint for an identity provider's server certificate.

The identity provider's server certificate thumbprint is the hex-encoded SHA-1 hash value of the self-signed X.509 certificate used by the domain where the OpenID Connect provider makes its keys available. It is always a 40-character string.

", - "max":40, - "min":40 - }, - "unmodifiableEntityMessage":{"type":"string"}, - "unrecognizedPublicKeyEncodingMessage":{"type":"string"}, - "userDetailListType":{ - "type":"list", - "member":{"shape":"UserDetail"} - }, - "userListType":{ - "type":"list", - "member":{"shape":"User"}, - "documentation":"

Contains a list of users.

This data type is used as a response element in the GetGroup and ListUsers operations.

" - }, - "userNameType":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "virtualMFADeviceListType":{ - "type":"list", - "member":{"shape":"VirtualMFADevice"} - }, - "virtualMFADeviceName":{ - "type":"string", - "min":1, - "pattern":"[\\w+=,.@-]+" - } - }, - "documentation":"AWS Identity and Access Management

AWS Identity and Access Management (IAM) is a web service that you can use to manage users and user permissions under your AWS account. This guide provides descriptions of IAM actions that you can call programmatically. For general information about IAM, see AWS Identity and Access Management (IAM). For the user guide for IAM, see Using IAM.

AWS provides SDKs that consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to IAM and AWS. For example, the SDKs take care of tasks such as cryptographically signing requests (see below), managing errors, and retrying requests automatically. For information about the AWS SDKs, including how to download and install them, see the Tools for Amazon Web Services page.

We recommend that you use the AWS SDKs to make programmatic API calls to IAM. However, you can also use the IAM Query API to make direct calls to the IAM web service. To learn more about the IAM Query API, see Making Query Requests in the Using IAM guide. IAM supports GET and POST requests for all actions. That is, the API does not require you to use GET for some actions and POST for others. However, GET requests are subject to the limitation size of a URL. Therefore, for operations that require larger sizes, use a POST request.

Signing Requests

Requests must be signed using an access key ID and a secret access key. We strongly recommend that you do not use your AWS account access key ID and secret access key for everyday work with IAM. You can use the access key ID and secret access key for an IAM user or you can use the AWS Security Token Service to generate temporary security credentials and use those to sign requests.

To sign requests, we recommend that you use Signature Version 4. If you have an existing application that uses Signature Version 2, you do not have to update it to use Signature Version 4. However, some operations now require Signature Version 4. The documentation for operations that require version 4 indicate this requirement.

Additional Resources

For more information, see the following:

  • AWS Security Credentials. This topic provides general information about the types of credentials used for accessing AWS.

  • IAM Best Practices. This topic presents a list of suggestions for using the IAM service to help secure your AWS resources.

  • Signing AWS API Requests. This set of topics walk you through the process of signing a request using an access key ID and secret access key.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/waiters-2.json deleted file mode 100644 index ba453826..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iam/2010-05-08/waiters-2.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "version": 2, - "waiters": { - "InstanceProfileExists": { - "delay": 1, - "operation": "GetInstanceProfile", - "maxAttempts": 40, - "acceptors": [ - { - "expected": 200, - "matcher": "status", - "state": "success" - }, - { - "state": "retry", - "matcher": "status", - "expected": 404 - } - ] - }, - "UserExists": { - "delay": 1, - "operation": "GetUser", - "maxAttempts": 20, - "acceptors": [ - { - "state": "success", - "matcher": "status", - "expected": 200 - }, - { - "state": "retry", - "matcher": "error", - "expected": "NoSuchEntity" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/paginators-1.json deleted file mode 100644 index 702385ea..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/paginators-1.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "pagination": { - "ListJobs": { - "input_token": "Marker", - "output_token": "Jobs[-1].JobId", - "more_results": "IsTruncated", - "limit_key": "MaxJobs", - "result_key": "Jobs" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/service-2.json deleted file mode 100644 index 64d0ad11..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/importexport/2010-06-01/service-2.json +++ /dev/null @@ -1,898 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"importexport-2010-06-01", - "apiVersion":"2010-06-01", - "endpointPrefix":"importexport", - "globalEndpoint":"importexport.amazonaws.com", - "serviceFullName":"AWS Import/Export", - "serviceId":"ImportExport", - "signatureVersion":"v2", - "xmlNamespace":"http://importexport.amazonaws.com/doc/2010-06-01/", - "protocol":"query" - }, - "documentation":"AWS Import/Export Service AWS Import/Export accelerates transferring large amounts of data between the AWS cloud and portable storage devices that you mail to us. AWS Import/Export transfers data directly onto and off of your storage devices using Amazon's high-speed internal network and bypassing the Internet. For large data sets, AWS Import/Export is often faster than Internet transfer and more cost effective than upgrading your connectivity.", - "operations":{ - "CancelJob":{ - "name":"CancelJob", - "http":{ - "method":"POST", - "requestUri":"/?Operation=CancelJob" - }, - "input":{ - "shape":"CancelJobInput", - "documentation":"Input structure for the CancelJob operation." - }, - "output":{ - "shape":"CancelJobOutput", - "documentation":"Output structure for the CancelJob operation.", - "resultWrapper":"CancelJobResult" - }, - "errors":[ - { - "shape":"InvalidJobIdException", - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - { - "shape":"ExpiredJobIdException", - "exception":true, - "documentation":"Indicates that the specified job has expired out of the system." - }, - { - "shape":"CanceledJobIdException", - "exception":true, - "documentation":"The specified job ID has been canceled and is no longer valid." - }, - { - "shape":"UnableToCancelJobIdException", - "exception":true, - "documentation":"AWS Import/Export cannot cancel the job" - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - } - ], - "documentation":"This operation cancels a specified job. Only the job owner can cancel it. The operation fails if the job has already started or is complete." - }, - "CreateJob":{ - "name":"CreateJob", - "http":{ - "method":"POST", - "requestUri":"/?Operation=CreateJob" - }, - "input":{ - "shape":"CreateJobInput", - "documentation":"Input structure for the CreateJob operation." - }, - "output":{ - "shape":"CreateJobOutput", - "documentation":"Output structure for the CreateJob operation.", - "resultWrapper":"CreateJobResult" - }, - "errors":[ - { - "shape":"MissingParameterException", - "exception":true, - "documentation":"One or more required parameters was missing from the request." - }, - { - "shape":"InvalidParameterException", - "exception":true, - "documentation":"One or more parameters had an invalid value." - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidAddressException", - "exception":true, - "documentation":"The address specified in the manifest is invalid." - }, - { - "shape":"InvalidManifestFieldException", - "exception":true, - "documentation":"One or more manifest fields was invalid. Please correct and resubmit." - }, - { - "shape":"MissingManifestFieldException", - "exception":true, - "documentation":"One or more required fields were missing from the manifest file. Please correct and resubmit." - }, - { - "shape":"NoSuchBucketException", - "exception":true, - "documentation":"The specified bucket does not exist. Create the specified bucket or change the manifest's bucket, exportBucket, or logBucket field to a bucket that the account, as specified by the manifest's Access Key ID, has write permissions to." - }, - { - "shape":"MissingCustomsException", - "exception":true, - "documentation":"One or more required customs parameters was missing from the manifest." - }, - { - "shape":"InvalidCustomsException", - "exception":true, - "documentation":"One or more customs parameters was invalid. Please correct and resubmit." - }, - { - "shape":"InvalidFileSystemException", - "exception":true, - "documentation":"File system specified in export manifest is invalid." - }, - { - "shape":"MultipleRegionsException", - "exception":true, - "documentation":"Your manifest file contained buckets from multiple regions. A job is restricted to buckets from one region. Please correct and resubmit." - }, - { - "shape":"BucketPermissionException", - "exception":true, - "documentation":"The account specified does not have the appropriate bucket permissions." - }, - { - "shape":"MalformedManifestException", - "exception":true, - "documentation":"Your manifest is not well-formed." - }, - { - "shape":"CreateJobQuotaExceededException", - "exception":true, - "documentation":"Each account can create only a certain number of jobs per day. If you need to create more than this, please contact awsimportexport@amazon.com to explain your particular use case." - }, - { - "shape":"InvalidJobIdException", - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - } - ], - "documentation":"This operation initiates the process of scheduling an upload or download of your data. You include in the request a manifest that describes the data transfer specifics. The response to the request includes a job ID, which you can use in other operations, a signature that you use to identify your storage device, and the address where you should ship your storage device." - }, - "GetShippingLabel":{ - "name":"GetShippingLabel", - "http":{ - "method":"POST", - "requestUri":"/?Operation=GetShippingLabel" - }, - "input":{"shape":"GetShippingLabelInput"}, - "output":{ - "shape":"GetShippingLabelOutput", - "resultWrapper":"GetShippingLabelResult" - }, - "errors":[ - { - "shape":"InvalidJobIdException", - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - { - "shape":"ExpiredJobIdException", - "exception":true, - "documentation":"Indicates that the specified job has expired out of the system." - }, - { - "shape":"CanceledJobIdException", - "exception":true, - "documentation":"The specified job ID has been canceled and is no longer valid." - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidAddressException", - "exception":true, - "documentation":"The address specified in the manifest is invalid." - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - }, - { - "shape":"InvalidParameterException", - "exception":true, - "documentation":"One or more parameters had an invalid value." - } - ], - "documentation":"This operation generates a pre-paid UPS shipping label that you will use to ship your device to AWS for processing." - }, - "GetStatus":{ - "name":"GetStatus", - "http":{ - "method":"POST", - "requestUri":"/?Operation=GetStatus" - }, - "input":{ - "shape":"GetStatusInput", - "documentation":"Input structure for the GetStatus operation." - }, - "output":{ - "shape":"GetStatusOutput", - "documentation":"Output structure for the GetStatus operation.", - "resultWrapper":"GetStatusResult" - }, - "errors":[ - { - "shape":"InvalidJobIdException", - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - { - "shape":"ExpiredJobIdException", - "exception":true, - "documentation":"Indicates that the specified job has expired out of the system." - }, - { - "shape":"CanceledJobIdException", - "exception":true, - "documentation":"The specified job ID has been canceled and is no longer valid." - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - } - ], - "documentation":"This operation returns information about a job, including where the job is in the processing pipeline, the status of the results, and the signature value associated with the job. You can only return information about jobs you own." - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"POST", - "requestUri":"/?Operation=ListJobs" - }, - "input":{ - "shape":"ListJobsInput", - "documentation":"Input structure for the ListJobs operation." - }, - "output":{ - "shape":"ListJobsOutput", - "documentation":"Output structure for the ListJobs operation.", - "resultWrapper":"ListJobsResult" - }, - "errors":[ - { - "shape":"InvalidParameterException", - "exception":true, - "documentation":"One or more parameters had an invalid value." - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - } - ], - "documentation":"This operation returns the jobs associated with the requester. AWS Import/Export lists the jobs in reverse chronological order based on the date of creation. For example if Job Test1 was created 2009Dec30 and Test2 was created 2010Feb05, the ListJobs operation would return Test2 followed by Test1." - }, - "UpdateJob":{ - "name":"UpdateJob", - "http":{ - "method":"POST", - "requestUri":"/?Operation=UpdateJob" - }, - "input":{ - "shape":"UpdateJobInput", - "documentation":"Input structure for the UpateJob operation." - }, - "output":{ - "shape":"UpdateJobOutput", - "documentation":"Output structure for the UpateJob operation.", - "resultWrapper":"UpdateJobResult" - }, - "errors":[ - { - "shape":"MissingParameterException", - "exception":true, - "documentation":"One or more required parameters was missing from the request." - }, - { - "shape":"InvalidParameterException", - "exception":true, - "documentation":"One or more parameters had an invalid value." - }, - { - "shape":"InvalidAccessKeyIdException", - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - { - "shape":"InvalidAddressException", - "exception":true, - "documentation":"The address specified in the manifest is invalid." - }, - { - "shape":"InvalidManifestFieldException", - "exception":true, - "documentation":"One or more manifest fields was invalid. Please correct and resubmit." - }, - { - "shape":"InvalidJobIdException", - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - { - "shape":"MissingManifestFieldException", - "exception":true, - "documentation":"One or more required fields were missing from the manifest file. Please correct and resubmit." - }, - { - "shape":"NoSuchBucketException", - "exception":true, - "documentation":"The specified bucket does not exist. Create the specified bucket or change the manifest's bucket, exportBucket, or logBucket field to a bucket that the account, as specified by the manifest's Access Key ID, has write permissions to." - }, - { - "shape":"ExpiredJobIdException", - "exception":true, - "documentation":"Indicates that the specified job has expired out of the system." - }, - { - "shape":"CanceledJobIdException", - "exception":true, - "documentation":"The specified job ID has been canceled and is no longer valid." - }, - { - "shape":"MissingCustomsException", - "exception":true, - "documentation":"One or more required customs parameters was missing from the manifest." - }, - { - "shape":"InvalidCustomsException", - "exception":true, - "documentation":"One or more customs parameters was invalid. Please correct and resubmit." - }, - { - "shape":"InvalidFileSystemException", - "exception":true, - "documentation":"File system specified in export manifest is invalid." - }, - { - "shape":"MultipleRegionsException", - "exception":true, - "documentation":"Your manifest file contained buckets from multiple regions. A job is restricted to buckets from one region. Please correct and resubmit." - }, - { - "shape":"BucketPermissionException", - "exception":true, - "documentation":"The account specified does not have the appropriate bucket permissions." - }, - { - "shape":"MalformedManifestException", - "exception":true, - "documentation":"Your manifest is not well-formed." - }, - { - "shape":"UnableToUpdateJobIdException", - "exception":true, - "documentation":"AWS Import/Export cannot update the job" - }, - { - "shape":"InvalidVersionException", - "exception":true, - "documentation":"The client tool version is invalid." - } - ], - "documentation":"You use this operation to change the parameters specified in the original manifest file by supplying a new manifest file. The manifest file attached to this request replaces the original manifest file. You can only use the operation after a CreateJob request but before the data transfer starts and you can only use it on jobs you own." - } - }, - "shapes":{ - "APIVersion":{ - "type":"string", - "documentation":"Specifies the version of the client tool." - }, - "Artifact":{ - "type":"structure", - "members":{ - "Description":{"shape":"Description"}, - "URL":{"shape":"URL"} - }, - "documentation":"A discrete item that contains the description and URL of an artifact (such as a PDF)." - }, - "ArtifactList":{ - "type":"list", - "member":{"shape":"Artifact"}, - "documentation":"A collection of artifacts." - }, - "BucketPermissionException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The account specified does not have the appropriate bucket permissions." - }, - "CancelJobInput":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{"shape":"JobId"}, - "APIVersion":{"shape":"APIVersion"} - }, - "documentation":"Input structure for the CancelJob operation." - }, - "CancelJobOutput":{ - "type":"structure", - "members":{ - "Success":{"shape":"Success"} - }, - "documentation":"Output structure for the CancelJob operation." - }, - "CanceledJobIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The specified job ID has been canceled and is no longer valid." - }, - "Carrier":{ - "type":"string", - "documentation":"Name of the shipping company. This value is included when the LocationCode is \"Returned\"." - }, - "CreateJobInput":{ - "type":"structure", - "required":[ - "JobType", - "Manifest", - "ValidateOnly" - ], - "members":{ - "JobType":{"shape":"JobType"}, - "Manifest":{"shape":"Manifest"}, - "ManifestAddendum":{"shape":"ManifestAddendum"}, - "ValidateOnly":{"shape":"ValidateOnly"}, - "APIVersion":{"shape":"APIVersion"} - }, - "documentation":"Input structure for the CreateJob operation." - }, - "CreateJobOutput":{ - "type":"structure", - "members":{ - "JobId":{"shape":"JobId"}, - "JobType":{"shape":"JobType"}, - "Signature":{"shape":"Signature"}, - "SignatureFileContents":{"shape":"SignatureFileContents"}, - "WarningMessage":{"shape":"WarningMessage"}, - "ArtifactList":{"shape":"ArtifactList"} - }, - "documentation":"Output structure for the CreateJob operation." - }, - "CreateJobQuotaExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"Each account can create only a certain number of jobs per day. If you need to create more than this, please contact awsimportexport@amazon.com to explain your particular use case." - }, - "CreationDate":{ - "type":"timestamp", - "documentation":"Timestamp of the CreateJob request in ISO8601 date format. For example \"2010-03-28T20:27:35Z\"." - }, - "CurrentManifest":{ - "type":"string", - "documentation":"The last manifest submitted, which will be used to process the job." - }, - "Description":{ - "type":"string", - "documentation":"The associated description for this object." - }, - "ErrorCount":{ - "type":"integer", - "documentation":"Number of errors. We return this value when the ProgressCode is Success or SuccessWithErrors." - }, - "ErrorMessage":{ - "type":"string", - "documentation":"The human-readable description of a particular error." - }, - "ExpiredJobIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"Indicates that the specified job has expired out of the system." - }, - "GenericString":{"type":"string"}, - "GetShippingLabelInput":{ - "type":"structure", - "required":["jobIds"], - "members":{ - "jobIds":{"shape":"JobIdList"}, - "name":{"shape":"name"}, - "company":{"shape":"company"}, - "phoneNumber":{"shape":"phoneNumber"}, - "country":{"shape":"country"}, - "stateOrProvince":{"shape":"stateOrProvince"}, - "city":{"shape":"city"}, - "postalCode":{"shape":"postalCode"}, - "street1":{"shape":"street1"}, - "street2":{"shape":"street2"}, - "street3":{"shape":"street3"}, - "APIVersion":{"shape":"APIVersion"} - } - }, - "GetShippingLabelOutput":{ - "type":"structure", - "members":{ - "ShippingLabelURL":{"shape":"GenericString"}, - "Warning":{"shape":"GenericString"} - } - }, - "GetStatusInput":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{"shape":"JobId"}, - "APIVersion":{"shape":"APIVersion"} - }, - "documentation":"Input structure for the GetStatus operation." - }, - "GetStatusOutput":{ - "type":"structure", - "members":{ - "JobId":{"shape":"JobId"}, - "JobType":{"shape":"JobType"}, - "LocationCode":{"shape":"LocationCode"}, - "LocationMessage":{"shape":"LocationMessage"}, - "ProgressCode":{"shape":"ProgressCode"}, - "ProgressMessage":{"shape":"ProgressMessage"}, - "Carrier":{"shape":"Carrier"}, - "TrackingNumber":{"shape":"TrackingNumber"}, - "LogBucket":{"shape":"LogBucket"}, - "LogKey":{"shape":"LogKey"}, - "ErrorCount":{"shape":"ErrorCount"}, - "Signature":{"shape":"Signature"}, - "SignatureFileContents":{"shape":"Signature"}, - "CurrentManifest":{"shape":"CurrentManifest"}, - "CreationDate":{"shape":"CreationDate"}, - "ArtifactList":{"shape":"ArtifactList"} - }, - "documentation":"Output structure for the GetStatus operation." - }, - "InvalidAccessKeyIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The AWS Access Key ID specified in the request did not match the manifest's accessKeyId value. The manifest and the request authentication must use the same AWS Access Key ID." - }, - "InvalidAddressException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The address specified in the manifest is invalid." - }, - "InvalidCustomsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more customs parameters was invalid. Please correct and resubmit." - }, - "InvalidFileSystemException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"File system specified in export manifest is invalid." - }, - "InvalidJobIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The JOBID was missing, not found, or not associated with the AWS account." - }, - "InvalidManifestFieldException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more manifest fields was invalid. Please correct and resubmit." - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more parameters had an invalid value." - }, - "InvalidVersionException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The client tool version is invalid." - }, - "IsCanceled":{ - "type":"boolean", - "documentation":"Indicates whether the job was canceled." - }, - "IsTruncated":{ - "type":"boolean", - "documentation":"Indicates whether the list of jobs was truncated. If true, then call ListJobs again using the last JobId element as the marker." - }, - "Job":{ - "type":"structure", - "members":{ - "JobId":{"shape":"JobId"}, - "CreationDate":{"shape":"CreationDate"}, - "IsCanceled":{"shape":"IsCanceled"}, - "JobType":{"shape":"JobType"} - }, - "documentation":"Representation of a job returned by the ListJobs operation." - }, - "JobId":{ - "type":"string", - "documentation":"A unique identifier which refers to a particular job." - }, - "JobIdList":{ - "type":"list", - "member":{"shape":"GenericString"} - }, - "JobType":{ - "type":"string", - "enum":[ - "Import", - "Export" - ], - "documentation":"Specifies whether the job to initiate is an import or export job." - }, - "JobsList":{ - "type":"list", - "member":{"shape":"Job"}, - "documentation":"A list container for Jobs returned by the ListJobs operation." - }, - "ListJobsInput":{ - "type":"structure", - "members":{ - "MaxJobs":{"shape":"MaxJobs"}, - "Marker":{"shape":"Marker"}, - "APIVersion":{"shape":"APIVersion"} - }, - "documentation":"Input structure for the ListJobs operation." - }, - "ListJobsOutput":{ - "type":"structure", - "members":{ - "Jobs":{"shape":"JobsList"}, - "IsTruncated":{"shape":"IsTruncated"} - }, - "documentation":"Output structure for the ListJobs operation." - }, - "LocationCode":{ - "type":"string", - "documentation":"A token representing the location of the storage device, such as \"AtAWS\"." - }, - "LocationMessage":{ - "type":"string", - "documentation":"A more human readable form of the physical location of the storage device." - }, - "LogBucket":{ - "type":"string", - "documentation":"Amazon S3 bucket for user logs." - }, - "LogKey":{ - "type":"string", - "documentation":"The key where the user logs were stored." - }, - "MalformedManifestException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"Your manifest is not well-formed." - }, - "Manifest":{ - "type":"string", - "documentation":"The UTF-8 encoded text of the manifest file." - }, - "ManifestAddendum":{ - "type":"string", - "documentation":"For internal use only." - }, - "Marker":{ - "type":"string", - "documentation":"Specifies the JOBID to start after when listing the jobs created with your account. AWS Import/Export lists your jobs in reverse chronological order. See MaxJobs." - }, - "MaxJobs":{ - "type":"integer", - "documentation":"Sets the maximum number of jobs returned in the response. If there are additional jobs that were not returned because MaxJobs was exceeded, the response contains <IsTruncated>true</IsTruncated>. To return the additional jobs, see Marker." - }, - "MissingCustomsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more required customs parameters was missing from the manifest." - }, - "MissingManifestFieldException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more required fields were missing from the manifest file. Please correct and resubmit." - }, - "MissingParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"One or more required parameters was missing from the request." - }, - "MultipleRegionsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"Your manifest file contained buckets from multiple regions. A job is restricted to buckets from one region. Please correct and resubmit." - }, - "NoSuchBucketException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"The specified bucket does not exist. Create the specified bucket or change the manifest's bucket, exportBucket, or logBucket field to a bucket that the account, as specified by the manifest's Access Key ID, has write permissions to." - }, - "ProgressCode":{ - "type":"string", - "documentation":"A token representing the state of the job, such as \"Started\"." - }, - "ProgressMessage":{ - "type":"string", - "documentation":"A more human readable form of the job status." - }, - "Signature":{ - "type":"string", - "documentation":"An encrypted code used to authenticate the request and response, for example, \"DV+TpDfx1/TdSE9ktyK9k/bDTVI=\". Only use this value is you want to create the signature file yourself. Generally you should use the SignatureFileContents value." - }, - "SignatureFileContents":{ - "type":"string", - "documentation":"The actual text of the SIGNATURE file to be written to disk." - }, - "Success":{ - "type":"boolean", - "documentation":"Specifies whether (true) or not (false) AWS Import/Export updated your job." - }, - "TrackingNumber":{ - "type":"string", - "documentation":"The shipping tracking number assigned by AWS Import/Export to the storage device when it's returned to you. We return this value when the LocationCode is \"Returned\"." - }, - "URL":{ - "type":"string", - "documentation":"The URL for a given Artifact." - }, - "UnableToCancelJobIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"AWS Import/Export cannot cancel the job" - }, - "UnableToUpdateJobIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "documentation":"AWS Import/Export cannot update the job" - }, - "UpdateJobInput":{ - "type":"structure", - "required":[ - "JobId", - "Manifest", - "JobType", - "ValidateOnly" - ], - "members":{ - "JobId":{"shape":"JobId"}, - "Manifest":{"shape":"Manifest"}, - "JobType":{"shape":"JobType"}, - "ValidateOnly":{"shape":"ValidateOnly"}, - "APIVersion":{"shape":"APIVersion"} - }, - "documentation":"Input structure for the UpateJob operation." - }, - "UpdateJobOutput":{ - "type":"structure", - "members":{ - "Success":{"shape":"Success"}, - "WarningMessage":{"shape":"WarningMessage"}, - "ArtifactList":{"shape":"ArtifactList"} - }, - "documentation":"Output structure for the UpateJob operation." - }, - "ValidateOnly":{ - "type":"boolean", - "documentation":"Validate the manifest and parameter values in the request but do not actually create a job." - }, - "WarningMessage":{ - "type":"string", - "documentation":"An optional message notifying you of non-fatal issues with the job, such as use of an incompatible Amazon S3 bucket name." - }, - "city":{ - "type":"string", - "documentation":"Specifies the name of your city for the return address." - }, - "company":{ - "type":"string", - "documentation":"Specifies the name of the company that will ship this package." - }, - "country":{ - "type":"string", - "documentation":"Specifies the name of your country for the return address." - }, - "name":{ - "type":"string", - "documentation":"Specifies the name of the person responsible for shipping this package." - }, - "phoneNumber":{ - "type":"string", - "documentation":"Specifies the phone number of the person responsible for shipping this package." - }, - "postalCode":{ - "type":"string", - "documentation":"Specifies the postal code for the return address." - }, - "stateOrProvince":{ - "type":"string", - "documentation":"Specifies the name of your state or your province for the return address." - }, - "street1":{ - "type":"string", - "documentation":"Specifies the first part of the street address for the return address, for example 1234 Main Street." - }, - "street2":{ - "type":"string", - "documentation":"Specifies the optional second part of the street address for the return address, for example Suite 100." - }, - "street3":{ - "type":"string", - "documentation":"Specifies the optional third part of the street address for the return address, for example c/o Jane Doe." - } - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2015-08-18/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2015-08-18/service-2.json deleted file mode 100644 index 83b0bb1b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2015-08-18/service-2.json +++ /dev/null @@ -1,2100 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-08-18", - "endpointPrefix":"inspector", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Inspector", - "signatureVersion":"v4", - "targetPrefix":"InspectorService" - }, - "operations":{ - "AddAttributesToFindings":{ - "name":"AddAttributesToFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddAttributesToFindingsRequest"}, - "output":{"shape":"AddAttributesToFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Assigns attributes (key and value pair) to the findings specified by the findings' ARNs.

" - }, - "AttachAssessmentAndRulesPackage":{ - "name":"AttachAssessmentAndRulesPackage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachAssessmentAndRulesPackageRequest"}, - "output":{"shape":"AttachAssessmentAndRulesPackageResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Attaches the rules package specified by the rules package ARN to the assessment specified by the assessment ARN.

" - }, - "CreateApplication":{ - "name":"CreateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationRequest"}, - "output":{"shape":"CreateApplicationResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Creates a new application using the resource group ARN generated by CreateResourceGroup. You can create up to 50 applications per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Inspector Applications.

" - }, - "CreateAssessment":{ - "name":"CreateAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAssessmentRequest"}, - "output":{"shape":"CreateAssessmentResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Creates an assessment for the application specified by the application ARN. You can create up to 500 assessments per AWS account.

" - }, - "CreateResourceGroup":{ - "name":"CreateResourceGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateResourceGroupRequest"}, - "output":{"shape":"CreateResourceGroupResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Inspector application. The created resource group is then used to create an Inspector application.

" - }, - "DeleteApplication":{ - "name":"DeleteApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationRequest"}, - "output":{"shape":"DeleteApplicationResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationInProgressException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Deletes the application specified by the application ARN.

" - }, - "DeleteAssessment":{ - "name":"DeleteAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAssessmentRequest"}, - "output":{"shape":"DeleteAssessmentResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"OperationInProgressException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Deletes the assessment specified by the assessment ARN.

" - }, - "DeleteRun":{ - "name":"DeleteRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRunRequest"}, - "output":{"shape":"DeleteRunResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Deletes the assessment run specified by the run ARN.

" - }, - "DescribeApplication":{ - "name":"DescribeApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeApplicationRequest"}, - "output":{"shape":"DescribeApplicationResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the application specified by the application ARN.

" - }, - "DescribeAssessment":{ - "name":"DescribeAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssessmentRequest"}, - "output":{"shape":"DescribeAssessmentResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the assessment specified by the assessment ARN.

" - }, - "DescribeCrossAccountAccessRole":{ - "name":"DescribeCrossAccountAccessRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"DescribeCrossAccountAccessRoleResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Describes the IAM role that enables Inspector to access your AWS account.

" - }, - "DescribeFinding":{ - "name":"DescribeFinding", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFindingRequest"}, - "output":{"shape":"DescribeFindingResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the finding specified by the finding ARN.

" - }, - "DescribeResourceGroup":{ - "name":"DescribeResourceGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResourceGroupRequest"}, - "output":{"shape":"DescribeResourceGroupResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the resource group specified by the resource group ARN.

" - }, - "DescribeRulesPackage":{ - "name":"DescribeRulesPackage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRulesPackageRequest"}, - "output":{"shape":"DescribeRulesPackageResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the rules package specified by the rules package ARN.

" - }, - "DescribeRun":{ - "name":"DescribeRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRunRequest"}, - "output":{"shape":"DescribeRunResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Describes the assessment run specified by the run ARN.

" - }, - "DetachAssessmentAndRulesPackage":{ - "name":"DetachAssessmentAndRulesPackage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachAssessmentAndRulesPackageRequest"}, - "output":{"shape":"DetachAssessmentAndRulesPackageResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Detaches the rules package specified by the rules package ARN from the assessment specified by the assessment ARN.

" - }, - "GetAssessmentTelemetry":{ - "name":"GetAssessmentTelemetry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAssessmentTelemetryRequest"}, - "output":{"shape":"GetAssessmentTelemetryResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Returns the metadata about the telemetry (application behavioral data) for the assessment specified by the assessment ARN.

" - }, - "ListApplications":{ - "name":"ListApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListApplicationsRequest"}, - "output":{"shape":"ListApplicationsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Lists the ARNs of the applications within this AWS account. For more information about applications, see Inspector Applications.

" - }, - "ListAssessmentAgents":{ - "name":"ListAssessmentAgents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentAgentsRequest"}, - "output":{"shape":"ListAssessmentAgentsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the agents of the assessment specified by the assessment ARN.

" - }, - "ListAssessments":{ - "name":"ListAssessments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentsRequest"}, - "output":{"shape":"ListAssessmentsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the assessments corresponding to applications specified by the applications' ARNs.

" - }, - "ListAttachedAssessments":{ - "name":"ListAttachedAssessments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttachedAssessmentsRequest"}, - "output":{"shape":"ListAttachedAssessmentsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the assessments attached to the rules package specified by the rules package ARN.

" - }, - "ListAttachedRulesPackages":{ - "name":"ListAttachedRulesPackages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttachedRulesPackagesRequest"}, - "output":{"shape":"ListAttachedRulesPackagesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the rules packages attached to the assessment specified by the assessment ARN.

" - }, - "ListFindings":{ - "name":"ListFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListFindingsRequest"}, - "output":{"shape":"ListFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists findings generated by the assessment run specified by the run ARNs.

" - }, - "ListRulesPackages":{ - "name":"ListRulesPackages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRulesPackagesRequest"}, - "output":{"shape":"ListRulesPackagesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Lists all available Inspector rules packages.

" - }, - "ListRuns":{ - "name":"ListRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRunsRequest"}, - "output":{"shape":"ListRunsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the assessment runs associated with the assessments specified by the assessment ARNs.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists all tags associated with a resource.

" - }, - "LocalizeText":{ - "name":"LocalizeText", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LocalizeTextRequest"}, - "output":{"shape":"LocalizeTextResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Translates a textual identifier into a user-readable text in a specified locale.

" - }, - "PreviewAgentsForResourceGroup":{ - "name":"PreviewAgentsForResourceGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PreviewAgentsForResourceGroupRequest"}, - "output":{"shape":"PreviewAgentsForResourceGroupResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidCrossAccountRoleException"} - ], - "documentation":"

Previews the agents installed on the EC2 instances that are included in the application created with the specified resource group.

" - }, - "RegisterCrossAccountAccessRole":{ - "name":"RegisterCrossAccountAccessRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterCrossAccountAccessRoleRequest"}, - "output":{"shape":"RegisterCrossAccountAccessRoleResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidCrossAccountRoleException"} - ], - "documentation":"

Register the role that Inspector uses to list your EC2 instances during the assessment.

" - }, - "RemoveAttributesFromFindings":{ - "name":"RemoveAttributesFromFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveAttributesFromFindingsRequest"}, - "output":{"shape":"RemoveAttributesFromFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Removes the entire attribute (key and value pair) from the findings specified by the finding ARNs where an attribute with the specified key exists.

" - }, - "RunAssessment":{ - "name":"RunAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RunAssessmentRequest"}, - "output":{"shape":"RunAssessmentResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Starts the analysis of the application’s behavior against selected rule packages for the assessment specified by the assessment ARN.

" - }, - "SetTagsForResource":{ - "name":"SetTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetTagsForResourceRequest"}, - "output":{"shape":"SetTagsForResourceResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Sets tags (key and value pairs) to the assessment specified by the assessment ARN.

" - }, - "StartDataCollection":{ - "name":"StartDataCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartDataCollectionRequest"}, - "output":{"shape":"StartDataCollectionResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidCrossAccountRoleException"} - ], - "documentation":"

Starts data collection for the assessment specified by the assessment ARN. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.

" - }, - "StopDataCollection":{ - "name":"StopDataCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopDataCollectionRequest"}, - "output":{"shape":"StopDataCollectionResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Stop data collection for the assessment specified by the assessment ARN.

" - }, - "UpdateApplication":{ - "name":"UpdateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationRequest"}, - "output":{"shape":"UpdateApplicationResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Updates application specified by the application ARN.

" - }, - "UpdateAssessment":{ - "name":"UpdateAssessment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAssessmentRequest"}, - "output":{"shape":"UpdateAssessmentResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Updates the assessment specified by the assessment ARN.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "AddAttributesToFindingsRequest":{ - "type":"structure", - "required":[ - "findingArns", - "attributes" - ], - "members":{ - "findingArns":{ - "shape":"ArnList", - "documentation":"

The ARNs specifying the findings that you want to assign attributes to.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

The array of attributes that you want to assign to specified findings.

" - } - } - }, - "AddAttributesToFindingsResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Agent":{ - "type":"structure", - "members":{ - "agentId":{ - "shape":"AgentId", - "documentation":"

The EC2 instance ID where the agent is installed.

" - }, - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment that is associated with the agent.

" - }, - "agentHealth":{ - "shape":"AgentHealth", - "documentation":"

The current health state of the agent. Values can be set to HEALTHY or UNHEALTHY.

" - }, - "agentHealthCode":{ - "shape":"AgentHealthCode", - "documentation":"

The detailed health state of the agent. Values can be set to RUNNING, HEALTHY, UNHEALTHY, UNKNOWN, BLACKLISTED, SHUTDOWN, THROTTLED.

" - }, - "agentHealthDetails":{ - "shape":"AgentHealthDetails", - "documentation":"

The description for the agent health code.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

This data type property is currently not used.

" - }, - "accountId":{ - "shape":"AwsAccount", - "documentation":"

AWS account of the EC2 instance where the agent is installed.

" - }, - "telemetry":{ - "shape":"TelemetryList", - "documentation":"

The Inspector application data metrics collected by the agent.

" - } - }, - "documentation":"

Contains information about an Inspector agent. This data type is used as a response element in the ListAssessmentAgents action.

" - }, - "AgentHealth":{"type":"string"}, - "AgentHealthCode":{"type":"string"}, - "AgentHealthDetails":{"type":"string"}, - "AgentHealthList":{ - "type":"list", - "member":{"shape":"AgentHealth"} - }, - "AgentId":{"type":"string"}, - "AgentList":{ - "type":"list", - "member":{"shape":"Agent"} - }, - "AgentPreview":{ - "type":"structure", - "members":{ - "agentId":{ - "shape":"AgentId", - "documentation":"

The id of the EC2 instance where the agent is intalled.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

The autoscaling group for the EC2 instance where the agent is installed.

" - } - }, - "documentation":"

This data type is used as a response element in the PreviewAgentsForResourceGroup action.

" - }, - "AgentPreviewList":{ - "type":"list", - "member":{"shape":"AgentPreview"} - }, - "AgentsFilter":{ - "type":"structure", - "members":{ - "agentHealthList":{ - "shape":"AgentHealthList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the agentHealth property of the Agent data type.

" - } - }, - "documentation":"

This data type is used as a response element in the ListAssessmentAgents action.

" - }, - "Application":{ - "type":"structure", - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the Inspector application.

" - }, - "applicationName":{ - "shape":"Name", - "documentation":"

The name of the Inspector application.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the resource group that is associated with the application.

" - } - }, - "documentation":"

Contains information about an Inspector application.

This data type is used as the response element in the DescribeApplication action.

" - }, - "ApplicationsFilter":{ - "type":"structure", - "members":{ - "applicationNamePatterns":{ - "shape":"NamePatternList", - "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the applicationName property of the Application data type.

" - } - }, - "documentation":"

This data type is used as the request parameter in the ListApplications action.

" - }, - "Arn":{"type":"string"}, - "ArnList":{ - "type":"list", - "member":{"shape":"Arn"} - }, - "Assessment":{ - "type":"structure", - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment.

" - }, - "assessmentName":{ - "shape":"Name", - "documentation":"

The name of the assessment.

" - }, - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN of the application that corresponds to this assessment.

" - }, - "assessmentState":{ - "shape":"AssessmentState", - "documentation":"

The state of the assessment. Values can be set to Created, Collecting Data, Stopping, and Completed.

" - }, - "failureMessage":{ - "shape":"FailureMessage", - "documentation":"

This data type property is not currently used.

" - }, - "dataCollected":{ - "shape":"Bool", - "documentation":"

Boolean value (true or false) specifying whether the data collection process is completed.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

The assessment start time.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

The assessment end time.

" - }, - "durationInSeconds":{ - "shape":"Duration", - "documentation":"

The assessment duration in seconds. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" - }, - "userAttributesForFindings":{ - "shape":"AttributeList", - "documentation":"

The user-defined attributes that are assigned to every generated finding.

" - } - }, - "documentation":"

Contains information about an Inspector assessment.

This data type is used as the response element in the DescribeAssessment action.

" - }, - "AssessmentState":{"type":"string"}, - "AssessmentStateList":{ - "type":"list", - "member":{"shape":"AssessmentState"} - }, - "AssessmentsFilter":{ - "type":"structure", - "members":{ - "assessmentNamePatterns":{ - "shape":"NamePatternList", - "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the assessmentName property of the Assessment data type.

" - }, - "assessmentStates":{ - "shape":"AssessmentStateList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the assessmentState property of the Assessment data type.

" - }, - "dataCollected":{ - "shape":"Bool", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the dataCollected property of the Assessment data type.

" - }, - "startTimeRange":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the startTime property of the Assessment data type.

" - }, - "endTimeRange":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the endTime property of the Assessment data type.

" - }, - "durationRange":{ - "shape":"DurationRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the durationInSeconds property of the Assessment data type.

" - } - }, - "documentation":"

This data type is used as the request parameter in the ListAssessments and ListAttachedAssessments actions.

" - }, - "AttachAssessmentAndRulesPackageRequest":{ - "type":"structure", - "required":[ - "assessmentArn", - "rulesPackageArn" - ], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment to which you want to attach a rules package.

" - }, - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the rules package that you want to attach to the assessment.

" - } - } - }, - "AttachAssessmentAndRulesPackageResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Attribute":{ - "type":"structure", - "members":{ - "key":{ - "shape":"AttributeKey", - "documentation":"

The attribute key.

" - }, - "value":{ - "shape":"AttributeValue", - "documentation":"

The value assigned to the attribute key.

" - } - }, - "documentation":"

This data type is used as a response element in the AddAttributesToFindings action and a request parameter in the CreateAssessment action.

" - }, - "AttributeKey":{"type":"string"}, - "AttributeKeyList":{ - "type":"list", - "member":{"shape":"AttributeKey"} - }, - "AttributeList":{ - "type":"list", - "member":{"shape":"Attribute"} - }, - "AttributeValue":{"type":"string"}, - "AutoScalingGroup":{"type":"string"}, - "AwsAccount":{"type":"string"}, - "Bool":{"type":"boolean"}, - "CreateApplicationRequest":{ - "type":"structure", - "required":[ - "applicationName", - "resourceGroupArn" - ], - "members":{ - "applicationName":{ - "shape":"Name", - "documentation":"

The user-defined name identifying the application that you want to create. The name must be unique within the AWS account.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the resource group that is used to create the application.

" - } - } - }, - "CreateApplicationResponse":{ - "type":"structure", - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the application that is created.

" - } - } - }, - "CreateAssessmentRequest":{ - "type":"structure", - "required":[ - "applicationArn", - "assessmentName", - "durationInSeconds" - ], - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the application for which you want to create an assessment.

" - }, - "assessmentName":{ - "shape":"Name", - "documentation":"

The user-defined name identifying the assessment that you want to create. You can create several assessments for an application. The names of the assessments corresponding to a particular application must be unique.

" - }, - "durationInSeconds":{ - "shape":"Duration", - "documentation":"

The duration of the assessment in seconds. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" - }, - "userAttributesForFindings":{ - "shape":"AttributeList", - "documentation":"

The user-defined attributes that are assigned to every finding generated by running this assessment.

" - } - } - }, - "CreateAssessmentResponse":{ - "type":"structure", - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment that is created.

" - } - } - }, - "CreateResourceGroupRequest":{ - "type":"structure", - "required":["resourceGroupTags"], - "members":{ - "resourceGroupTags":{ - "shape":"ResourceGroupTags", - "documentation":"

A collection of keys and an array of possible values in JSON format.

For example, [{ \"key1\" : [\"Value1\",\"Value2\"]},{\"Key2\": [\"Value3\"]}]

" - } - } - }, - "CreateResourceGroupResponse":{ - "type":"structure", - "members":{ - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the resource group that is created.

" - } - } - }, - "DeleteApplicationRequest":{ - "type":"structure", - "required":["applicationArn"], - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the application that you want to delete.

" - } - } - }, - "DeleteApplicationResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "DeleteAssessmentRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment that you want to delete.

" - } - } - }, - "DeleteAssessmentResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "DeleteRunRequest":{ - "type":"structure", - "required":["runArn"], - "members":{ - "runArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment run that you want to delete.

" - } - } - }, - "DeleteRunResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "DescribeApplicationRequest":{ - "type":"structure", - "required":["applicationArn"], - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the application that you want to describe.

" - } - } - }, - "DescribeApplicationResponse":{ - "type":"structure", - "members":{ - "application":{ - "shape":"Application", - "documentation":"

Information about the application.

" - } - } - }, - "DescribeAssessmentRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment that you want to describe.

" - } - } - }, - "DescribeAssessmentResponse":{ - "type":"structure", - "members":{ - "assessment":{ - "shape":"Assessment", - "documentation":"

Information about the assessment.

" - } - } - }, - "DescribeCrossAccountAccessRoleResponse":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the IAM role that Inspector uses to access your AWS account.

" - }, - "valid":{ - "shape":"Bool", - "documentation":"

A Boolean value that specifies whether the IAM role has the necessary policies attached to enable Inspector to access your AWS account.

" - } - } - }, - "DescribeFindingRequest":{ - "type":"structure", - "required":["findingArn"], - "members":{ - "findingArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the finding that you want to describe.

" - } - } - }, - "DescribeFindingResponse":{ - "type":"structure", - "members":{ - "finding":{ - "shape":"Finding", - "documentation":"

Information about the finding.

" - } - } - }, - "DescribeResourceGroupRequest":{ - "type":"structure", - "required":["resourceGroupArn"], - "members":{ - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the resource group that you want to describe.

" - } - } - }, - "DescribeResourceGroupResponse":{ - "type":"structure", - "members":{ - "resourceGroup":{ - "shape":"ResourceGroup", - "documentation":"

Information about the resource group.

" - } - } - }, - "DescribeRulesPackageRequest":{ - "type":"structure", - "required":["rulesPackageArn"], - "members":{ - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the rules package that you want to describe.

" - } - } - }, - "DescribeRulesPackageResponse":{ - "type":"structure", - "members":{ - "rulesPackage":{ - "shape":"RulesPackage", - "documentation":"

Information about the rules package.

" - } - } - }, - "DescribeRunRequest":{ - "type":"structure", - "required":["runArn"], - "members":{ - "runArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment run that you want to describe.

" - } - } - }, - "DescribeRunResponse":{ - "type":"structure", - "members":{ - "run":{ - "shape":"Run", - "documentation":"

Information about the assessment run.

" - } - } - }, - "DetachAssessmentAndRulesPackageRequest":{ - "type":"structure", - "required":[ - "assessmentArn", - "rulesPackageArn" - ], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment from which you want to detach a rules package.

" - }, - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the rules package that you want to detach from the assessment.

" - } - } - }, - "DetachAssessmentAndRulesPackageResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Duration":{"type":"integer"}, - "DurationRange":{ - "type":"structure", - "members":{ - "minimum":{ - "shape":"Duration", - "documentation":"

The minimum value of the duration range. Must be greater than zero.

" - }, - "maximum":{ - "shape":"Duration", - "documentation":"

The maximum value of the duration range. Must be less than or equal to 604800 seconds (1 week).

" - } - }, - "documentation":"

This data type is used in the AssessmentsFilter data type.

" - }, - "FailureMessage":{"type":"string"}, - "Finding":{ - "type":"structure", - "members":{ - "findingArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the finding.

" - }, - "runArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that generated the finding.

" - }, - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the rules package that is used to generate the finding.

" - }, - "ruleName":{ - "shape":"Name", - "documentation":"

The rule name that is used to generate the finding.

" - }, - "agentId":{ - "shape":"AgentId", - "documentation":"

The EC2 instance ID where the agent is installed that is used during the assessment that generates the finding.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

The autoscaling group of the EC2 instance where the agent is installed that is used during the assessment that generates the finding.

" - }, - "severity":{ - "shape":"Severity", - "documentation":"

The finding severity. Values can be set to High, Medium, Low, and Informational.

" - }, - "finding":{ - "shape":"LocalizedText", - "documentation":"

A short description that identifies the finding.

" - }, - "description":{ - "shape":"LocalizedText", - "documentation":"

The description of the finding.

" - }, - "recommendation":{ - "shape":"LocalizedText", - "documentation":"

The recommendation for the finding.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

The system-defined attributes for the finding.

" - }, - "userAttributes":{ - "shape":"AttributeList", - "documentation":"

The user-defined attributes that are assigned to the finding.

" - } - }, - "documentation":"

Contains information about an Inspector finding.

This data type is used as the response element in the DescribeFinding action.

" - }, - "FindingsFilter":{ - "type":"structure", - "members":{ - "rulesPackageArns":{ - "shape":"ArnList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the rulesPackageArn property of the Finding data type.

" - }, - "ruleNames":{ - "shape":"NameList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the ruleName property of the Finding data type.

" - }, - "severities":{ - "shape":"SeverityList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the severity property of the Finding data type.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the attributes property of the Finding data type.

" - }, - "userAttributes":{ - "shape":"AttributeList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the userAttributes property of the Finding data type.

" - } - }, - "documentation":"

This data type is used as a request parameter in the ListFindings action.

" - }, - "GetAssessmentTelemetryRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment the telemetry of which you want to obtain.

" - } - } - }, - "GetAssessmentTelemetryResponse":{ - "type":"structure", - "members":{ - "telemetry":{ - "shape":"TelemetryList", - "documentation":"

Telemetry details.

" - } - } - }, - "Integer":{"type":"integer"}, - "InternalException":{ - "type":"structure", - "members":{ - }, - "exception":true, - "fault":true - }, - "InvalidCrossAccountRoleException":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "ListApplicationsRequest":{ - "type":"structure", - "members":{ - "filter":{ - "shape":"ApplicationsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListApplications action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListApplicationsResponse":{ - "type":"structure", - "members":{ - "applicationArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the applications returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListAssessmentAgentsRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment whose agents you want to list.

" - }, - "filter":{ - "shape":"AgentsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAssessmentAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentAgentsResponse":{ - "type":"structure", - "members":{ - "agentList":{ - "shape":"AgentList", - "documentation":"

A list of ARNs specifying the agents returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListAssessmentsRequest":{ - "type":"structure", - "members":{ - "applicationArns":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the applications the assessments of which you want to list.

" - }, - "filter":{ - "shape":"AssessmentsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAssessments action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentsResponse":{ - "type":"structure", - "members":{ - "assessmentArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the assessments returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListAttachedAssessmentsRequest":{ - "type":"structure", - "required":["rulesPackageArn"], - "members":{ - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the rules package whose assessments you want to list.

" - }, - "filter":{ - "shape":"AssessmentsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAttachedAssessments action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAttachedAssessmentsResponse":{ - "type":"structure", - "members":{ - "assessmentArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the assessments returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListAttachedRulesPackagesRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the assessment whose rules packages you want to list.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAttachedRulesPackages action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAttachedRulesPackagesResponse":{ - "type":"structure", - "members":{ - "rulesPackageArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the rules packages returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListFindingsRequest":{ - "type":"structure", - "members":{ - "runArns":{ - "shape":"ArnList", - "documentation":"

The ARNs of the assessment runs that generate the findings that you want to list.

" - }, - "filter":{ - "shape":"FindingsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListFindings action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListFindingsResponse":{ - "type":"structure", - "members":{ - "findingArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the findings returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListRulesPackagesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListRulesPackages action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListRulesPackagesResponse":{ - "type":"structure", - "members":{ - "rulesPackageArnList":{ - "shape":"ArnList", - "documentation":"

The list of ARNs specifying the rules packages returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListRunsRequest":{ - "type":"structure", - "members":{ - "assessmentArns":{ - "shape":"ArnList", - "documentation":"

The ARNs specifying the assessments whose runs you want to list.

" - }, - "filter":{ - "shape":"RunsFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListRuns action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListRunsResponse":{ - "type":"structure", - "members":{ - "runArnList":{ - "shape":"ArnList", - "documentation":"

A list of ARNs specifying the assessment runs returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the resource whose tags you want to list.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "tagList":{ - "shape":"TagList", - "documentation":"

A collection of key and value pairs.

" - } - } - }, - "Locale":{"type":"string"}, - "LocalizeTextRequest":{ - "type":"structure", - "required":[ - "localizedTexts", - "locale" - ], - "members":{ - "localizedTexts":{ - "shape":"LocalizedTextList", - "documentation":"

A list of textual identifiers.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The locale that you want to translate a textual identifier into.

" - } - } - }, - "LocalizeTextResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - }, - "results":{ - "shape":"TextList", - "documentation":"

The resulting list of user-readable texts.

" - } - } - }, - "LocalizedFacility":{"type":"string"}, - "LocalizedText":{ - "type":"structure", - "members":{ - "key":{ - "shape":"LocalizedTextKey", - "documentation":"

The facility and id properties of the LocalizedTextKey data type.

" - }, - "parameters":{ - "shape":"ParameterList", - "documentation":"

Values for the dynamic elements of the string specified by the textual identifier.

" - } - }, - "documentation":"

The textual identifier. This data type is used as the request parameter in the LocalizeText action.

" - }, - "LocalizedTextId":{"type":"string"}, - "LocalizedTextKey":{ - "type":"structure", - "members":{ - "facility":{ - "shape":"LocalizedFacility", - "documentation":"

The module response source of the text.

" - }, - "id":{ - "shape":"LocalizedTextId", - "documentation":"

Part of the module response source of the text.

" - } - }, - "documentation":"

This data type is used in the LocalizedText data type.

" - }, - "LocalizedTextList":{ - "type":"list", - "member":{"shape":"LocalizedText"} - }, - "Long":{"type":"long"}, - "Message":{"type":"string"}, - "MessageType":{"type":"string"}, - "MessageTypeTelemetry":{ - "type":"structure", - "members":{ - "messageType":{ - "shape":"MessageType", - "documentation":"

A specific type of behavioral data that is collected by the agent.

" - }, - "count":{ - "shape":"Long", - "documentation":"

The number of times that the behavioral data is collected by the agent during an assessment.

" - }, - "dataSize":{ - "shape":"Long", - "documentation":"

The total size of the behavioral data that is collected by the agent during an assessment.

" - } - }, - "documentation":"

This data type is used in the Telemetry data type.

This is metadata about the behavioral data collected by the Inspector agent on your EC2 instances during an assessment and passed to the Inspector service for analysis.

" - }, - "MessageTypeTelemetryList":{ - "type":"list", - "member":{"shape":"MessageTypeTelemetry"} - }, - "Name":{"type":"string"}, - "NameList":{ - "type":"list", - "member":{"shape":"Name"} - }, - "NamePattern":{"type":"string"}, - "NamePatternList":{ - "type":"list", - "member":{"shape":"NamePattern"} - }, - "NoSuchEntityException":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "OperationInProgressException":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "PaginationToken":{"type":"string"}, - "Parameter":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ParameterName", - "documentation":"

The name of the variable that is being replaced.

" - }, - "value":{ - "shape":"ParameterValue", - "documentation":"

The value assigned to the variable that is being replaced.

" - } - }, - "documentation":"

This data type is used in the LocalizedText data type.

" - }, - "ParameterList":{ - "type":"list", - "member":{"shape":"Parameter"} - }, - "ParameterName":{"type":"string"}, - "ParameterValue":{"type":"string"}, - "PreviewAgentsForResourceGroupRequest":{ - "type":"structure", - "required":["resourceGroupArn"], - "members":{ - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource group that is used to create an application.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the PreviewAgentsForResourceGroup action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"Integer", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "PreviewAgentsForResourceGroupResponse":{ - "type":"structure", - "members":{ - "agentPreviewList":{ - "shape":"AgentPreviewList", - "documentation":"

The resulting list of agents.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to 'null'.

" - } - } - }, - "RegisterCrossAccountAccessRoleRequest":{ - "type":"structure", - "required":["roleArn"], - "members":{ - "roleArn":{ - "shape":"Arn", - "documentation":"The ARN of the IAM role that Inspector uses to list your EC2 instances during the assessment." - } - } - }, - "RegisterCrossAccountAccessRoleResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "RemoveAttributesFromFindingsRequest":{ - "type":"structure", - "required":[ - "findingArns", - "attributeKeys" - ], - "members":{ - "findingArns":{ - "shape":"ArnList", - "documentation":"

The ARNs specifying the findings that you want to remove attributes from.

" - }, - "attributeKeys":{ - "shape":"AttributeKeyList", - "documentation":"

The array of attribute keys that you want to remove from specified findings.

" - } - } - }, - "RemoveAttributesFromFindingsResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "ResourceGroup":{ - "type":"structure", - "members":{ - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource group.

" - }, - "resourceGroupTags":{ - "shape":"ResourceGroupTags", - "documentation":"

The tags (key and value pairs) of the resource group.

This data type property is used in the CreateResourceGroup action.

A collection of keys and an array of possible values in JSON format.

For example, [{ \"key1\" : [\"Value1\",\"Value2\"]},{\"Key2\": [\"Value3\"]}]

" - } - }, - "documentation":"

Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that comprise the application.

This data type is used as the response element in the DescribeResourceGroup action.

" - }, - "ResourceGroupTags":{"type":"string"}, - "RulesPackage":{ - "type":"structure", - "members":{ - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the rules package.

" - }, - "rulesPackageName":{ - "shape":"Name", - "documentation":"

The name of the rules package.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version id of the rules package.

" - }, - "provider":{ - "shape":"Name", - "documentation":"

The provider of the rules package.

" - }, - "description":{ - "shape":"LocalizedText", - "documentation":"

The description of the rules package.

" - } - }, - "documentation":"

Contains information about an Inspector rules package.

This data type is used as the response element in the DescribeRulesPackage action.

" - }, - "Run":{ - "type":"structure", - "members":{ - "runArn":{ - "shape":"Arn", - "documentation":"

The ARN of the run.

" - }, - "runName":{ - "shape":"Name", - "documentation":"

The auto-generated name for the run.

" - }, - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment that is associated with the run.

" - }, - "runState":{ - "shape":"RunState", - "documentation":"

The state of the run. Values can be set to DataCollectionComplete, EvaluatingPolicies, EvaluatingPoliciesErrorCanRetry, Completed, Failed, TombStoned.

" - }, - "rulesPackages":{ - "shape":"ArnList", - "documentation":"

Rules packages selected for the run of the assessment.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

Run creation time that corresponds to the data collection completion time or failure.

" - }, - "completionTime":{ - "shape":"Timestamp", - "documentation":"

Run completion time that corresponds to the rules packages evaluation completion time or failure.

" - } - }, - "documentation":"

A snapshot of an Inspector assessment that contains the assessment's findings.

This data type is used as the response element in the DescribeRun action.

" - }, - "RunAssessmentRequest":{ - "type":"structure", - "required":[ - "assessmentArn", - "runName" - ], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment that you want to run.

" - }, - "runName":{ - "shape":"Name", - "documentation":"

A name specifying the run of the assessment.

" - } - } - }, - "RunAssessmentResponse":{ - "type":"structure", - "members":{ - "runArn":{ - "shape":"Arn", - "documentation":"

The ARN specifying the run of the assessment.

" - } - } - }, - "RunState":{"type":"string"}, - "RunStateList":{ - "type":"list", - "member":{"shape":"RunState"} - }, - "RunsFilter":{ - "type":"structure", - "members":{ - "runNamePatterns":{ - "shape":"NamePatternList", - "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the runName property of the Run data type.

" - }, - "runStates":{ - "shape":"RunStateList", - "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the runState property of the Run data type.

" - }, - "rulesPackages":{ - "shape":"ArnList", - "documentation":"

For a record to match a filter, the value specified for this data type property must match a list of values of the rulesPackages property of the Run data type.

" - }, - "creationTime":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the creationTime property of the Run data type.

" - }, - "completionTime":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the completionTime property of the Run data type.

" - } - }, - "documentation":"

This data type is used as the request parameter in the ListRuns action.

" - }, - "SetTagsForResourceRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment that you want to set tags to.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

A collection of key and value pairs that you want to set to an assessment.

" - } - } - }, - "SetTagsForResourceResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Severity":{"type":"string"}, - "SeverityList":{ - "type":"list", - "member":{"shape":"Severity"} - }, - "StartDataCollectionRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment for which you want to start the data collection process.

" - } - } - }, - "StartDataCollectionResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "StopDataCollectionRequest":{ - "type":"structure", - "required":["assessmentArn"], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment for which you want to stop the data collection process.

" - } - } - }, - "StopDataCollectionResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value assigned to a tag key.

" - } - }, - "documentation":"

A key and value pair.

This data type is used as a request parameter in the SetTagsForResource action and a response element in the ListTagsForResource action.

" - }, - "TagKey":{"type":"string"}, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{"type":"string"}, - "Telemetry":{ - "type":"structure", - "members":{ - "status":{ - "shape":"TelemetryStatus", - "documentation":"

The category of the individual metrics that together constitute the telemetry that Inspector received from the agent.

" - }, - "messageTypeTelemetries":{ - "shape":"MessageTypeTelemetryList", - "documentation":"

Counts of individual metrics received by Inspector from the agent.

" - } - }, - "documentation":"

The metadata about the Inspector application data metrics collected by the agent.

This data type is used as the response element in the GetAssessmentTelemetry action.

" - }, - "TelemetryList":{ - "type":"list", - "member":{"shape":"Telemetry"} - }, - "TelemetryStatus":{"type":"string"}, - "Text":{"type":"string"}, - "TextList":{ - "type":"list", - "member":{"shape":"Text"} - }, - "Timestamp":{"type":"timestamp"}, - "TimestampRange":{ - "type":"structure", - "members":{ - "minimum":{ - "shape":"Timestamp", - "documentation":"

The minimum value of the timestamp range.

" - }, - "maximum":{ - "shape":"Timestamp", - "documentation":"

The maximum value of the timestamp range.

" - } - }, - "documentation":"

This data type is used in the AssessmentsFilter and RunsFilter data types.

" - }, - "UpdateApplicationRequest":{ - "type":"structure", - "required":[ - "applicationArn", - "applicationName", - "resourceGroupArn" - ], - "members":{ - "applicationArn":{ - "shape":"Arn", - "documentation":"

Application ARN that you want to update.

" - }, - "applicationName":{ - "shape":"Name", - "documentation":"

Application name that you want to update.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The resource group ARN that you want to update.

" - } - } - }, - "UpdateApplicationResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "UpdateAssessmentRequest":{ - "type":"structure", - "required":[ - "assessmentArn", - "assessmentName", - "durationInSeconds" - ], - "members":{ - "assessmentArn":{ - "shape":"Arn", - "documentation":"

Asessment ARN that you want to update.

" - }, - "assessmentName":{ - "shape":"Name", - "documentation":"

Assessment name that you want to update.

" - }, - "durationInSeconds":{ - "shape":"Duration", - "documentation":"

Assessment duration in seconds that you want to update. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" - } - } - }, - "UpdateAssessmentResponse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"Message", - "documentation":"

Confirmation details of the action performed.

" - } - } - }, - "Version":{"type":"string"} - }, - "documentation":"Amazon Inspector

Amazon Inspector enables you to analyze the behavior of the applications you run in AWS and to identify potential security issues. For more information, see Amazon Inspector User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/examples-1.json deleted file mode 100644 index 24fcb7a9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/examples-1.json +++ /dev/null @@ -1,1140 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddAttributesToFindings": [ - { - "input": { - "attributes": [ - { - "key": "Example", - "value": "example" - } - ], - "findingArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU" - ] - }, - "output": { - "failedItems": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.", - "id": "add-attributes-to-findings-1481063856401", - "title": "Add attributes to findings" - } - ], - "CreateAssessmentTarget": [ - { - "input": { - "assessmentTargetName": "ExampleAssessmentTarget", - "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv" - }, - "output": { - "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account.", - "id": "create-assessment-target-1481063953657", - "title": "Create assessment target" - } - ], - "CreateAssessmentTemplate": [ - { - "input": { - "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX", - "assessmentTemplateName": "ExampleAssessmentTemplate", - "durationInSeconds": 180, - "rulesPackageArns": [ - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-11B9DBXp" - ], - "userAttributesForFindings": [ - { - "key": "Example", - "value": "example" - } - ] - }, - "output": { - "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates an assessment template for the assessment target that is specified by the ARN of the assessment target.", - "id": "create-assessment-template-1481064046719", - "title": "Create assessment template" - } - ], - "CreateResourceGroup": [ - { - "input": { - "resourceGroupTags": [ - { - "key": "Name", - "value": "example" - } - ] - }, - "output": { - "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector assessment target. The created resource group is then used to create an Amazon Inspector assessment target. ", - "id": "create-resource-group-1481064169037", - "title": "Create resource group" - } - ], - "DeleteAssessmentRun": [ - { - "input": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the assessment run that is specified by the ARN of the assessment run.", - "id": "delete-assessment-run-1481064251629", - "title": "Delete assessment run" - } - ], - "DeleteAssessmentTarget": [ - { - "input": { - "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the assessment target that is specified by the ARN of the assessment target.", - "id": "delete-assessment-target-1481064309029", - "title": "Delete assessment target" - } - ], - "DeleteAssessmentTemplate": [ - { - "input": { - "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the assessment template that is specified by the ARN of the assessment template.", - "id": "delete-assessment-template-1481064364074", - "title": "Delete assessment template" - } - ], - "DescribeAssessmentRuns": [ - { - "input": { - "assessmentRunArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE" - ] - }, - "output": { - "assessmentRuns": [ - { - "name": "Run 1 for ExampleAssessmentTemplate", - "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", - "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", - "completedAt": "1458680301.4", - "createdAt": "1458680170.035", - "dataCollected": true, - "durationInSeconds": 3600, - "notifications": [ - - ], - "rulesPackageArns": [ - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" - ], - "startedAt": "1458680170.161", - "state": "COMPLETED", - "stateChangedAt": "1458680301.4", - "stateChanges": [ - { - "state": "CREATED", - "stateChangedAt": "1458680170.035" - }, - { - "state": "START_DATA_COLLECTION_PENDING", - "stateChangedAt": "1458680170.065" - }, - { - "state": "START_DATA_COLLECTION_IN_PROGRESS", - "stateChangedAt": "1458680170.096" - }, - { - "state": "COLLECTING_DATA", - "stateChangedAt": "1458680170.161" - }, - { - "state": "STOP_DATA_COLLECTION_PENDING", - "stateChangedAt": "1458680239.883" - }, - { - "state": "DATA_COLLECTED", - "stateChangedAt": "1458680299.847" - }, - { - "state": "EVALUATING_RULES", - "stateChangedAt": "1458680300.099" - }, - { - "state": "COMPLETED", - "stateChangedAt": "1458680301.4" - } - ], - "userAttributesForFindings": [ - - ] - } - ], - "failedItems": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the assessment runs that are specified by the ARNs of the assessment runs.", - "id": "describte-assessment-runs-1481064424352", - "title": "Describte assessment runs" - } - ], - "DescribeAssessmentTargets": [ - { - "input": { - "assessmentTargetArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" - ] - }, - "output": { - "assessmentTargets": [ - { - "name": "ExampleAssessmentTarget", - "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", - "createdAt": "1458074191.459", - "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", - "updatedAt": "1458074191.459" - } - ], - "failedItems": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the assessment targets that are specified by the ARNs of the assessment targets.", - "id": "describte-assessment-targets-1481064527735", - "title": "Describte assessment targets" - } - ], - "DescribeAssessmentTemplates": [ - { - "input": { - "assessmentTemplateArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw" - ] - }, - "output": { - "assessmentTemplates": [ - { - "name": "ExampleAssessmentTemplate", - "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", - "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", - "createdAt": "1458074191.844", - "durationInSeconds": 3600, - "rulesPackageArns": [ - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" - ], - "userAttributesForFindings": [ - - ] - } - ], - "failedItems": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the assessment templates that are specified by the ARNs of the assessment templates.", - "id": "describte-assessment-templates-1481064606829", - "title": "Describte assessment templates" - } - ], - "DescribeCrossAccountAccessRole": [ - { - "output": { - "registeredAt": "1458069182.826", - "roleArn": "arn:aws:iam::123456789012:role/inspector", - "valid": true - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the IAM role that enables Amazon Inspector to access your AWS account.", - "id": "describte-cross-account-access-role-1481064682267", - "title": "Describte cross account access role" - } - ], - "DescribeFindings": [ - { - "input": { - "findingArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4" - ] - }, - "output": { - "failedItems": { - }, - "findings": [ - { - "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", - "assetAttributes": { - "ipv4Addresses": [ - - ], - "schemaVersion": 1 - }, - "assetType": "ec2-instance", - "attributes": [ - - ], - "confidence": 10, - "createdAt": "1458680301.37", - "description": "Amazon Inspector did not find any potential security issues during this assessment.", - "indicatorOfCompromise": false, - "numericSeverity": 0, - "recommendation": "No remediation needed.", - "schemaVersion": 1, - "service": "Inspector", - "serviceAttributes": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", - "rulesPackageArn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP", - "schemaVersion": 1 - }, - "severity": "Informational", - "title": "No potential security issues found", - "updatedAt": "1458680301.37", - "userAttributes": [ - - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the findings that are specified by the ARNs of the findings.", - "id": "describte-findings-1481064771803", - "title": "Describe findings" - } - ], - "DescribeResourceGroups": [ - { - "input": { - "resourceGroupArns": [ - "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI" - ] - }, - "output": { - "failedItems": { - }, - "resourceGroups": [ - { - "arn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", - "createdAt": "1458074191.098", - "tags": [ - { - "key": "Name", - "value": "example" - } - ] - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the resource groups that are specified by the ARNs of the resource groups.", - "id": "describe-resource-groups-1481065787743", - "title": "Describe resource groups" - } - ], - "DescribeRulesPackages": [ - { - "input": { - "rulesPackageArns": [ - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ" - ] - }, - "output": { - "failedItems": { - }, - "rulesPackages": [ - { - "version": "1.1", - "name": "Security Best Practices", - "arn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ", - "description": "The rules in this package help determine whether your systems are configured securely.", - "provider": "Amazon Web Services, Inc." - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the rules packages that are specified by the ARNs of the rules packages.", - "id": "describe-rules-packages-1481069641979", - "title": "Describe rules packages" - } - ], - "GetTelemetryMetadata": [ - { - "input": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE" - }, - "output": { - "telemetryMetadata": [ - { - "count": 2, - "dataSize": 345, - "messageType": "InspectorDuplicateProcess" - }, - { - "count": 3, - "dataSize": 255, - "messageType": "InspectorTimeEventMsg" - }, - { - "count": 4, - "dataSize": 1082, - "messageType": "InspectorNetworkInterface" - }, - { - "count": 2, - "dataSize": 349, - "messageType": "InspectorDnsEntry" - }, - { - "count": 11, - "dataSize": 2514, - "messageType": "InspectorDirectoryInfoMsg" - }, - { - "count": 1, - "dataSize": 179, - "messageType": "InspectorTcpV6ListeningPort" - }, - { - "count": 101, - "dataSize": 10949, - "messageType": "InspectorTerminal" - }, - { - "count": 26, - "dataSize": 5916, - "messageType": "InspectorUser" - }, - { - "count": 282, - "dataSize": 32148, - "messageType": "InspectorDynamicallyLoadedCodeModule" - }, - { - "count": 18, - "dataSize": 10172, - "messageType": "InspectorCreateProcess" - }, - { - "count": 3, - "dataSize": 8001, - "messageType": "InspectorProcessPerformance" - }, - { - "count": 1, - "dataSize": 360, - "messageType": "InspectorOperatingSystem" - }, - { - "count": 6, - "dataSize": 546, - "messageType": "InspectorStopProcess" - }, - { - "count": 1, - "dataSize": 1553, - "messageType": "InspectorInstanceMetaData" - }, - { - "count": 2, - "dataSize": 434, - "messageType": "InspectorTcpV4Connection" - }, - { - "count": 474, - "dataSize": 2960322, - "messageType": "InspectorPackageInfo" - }, - { - "count": 3, - "dataSize": 2235, - "messageType": "InspectorSystemPerformance" - }, - { - "count": 105, - "dataSize": 46048, - "messageType": "InspectorCodeModule" - }, - { - "count": 1, - "dataSize": 182, - "messageType": "InspectorUdpV6ListeningPort" - }, - { - "count": 2, - "dataSize": 371, - "messageType": "InspectorUdpV4ListeningPort" - }, - { - "count": 18, - "dataSize": 8362, - "messageType": "InspectorKernelModule" - }, - { - "count": 29, - "dataSize": 48788, - "messageType": "InspectorConfigurationInfo" - }, - { - "count": 1, - "dataSize": 79, - "messageType": "InspectorMonitoringStart" - }, - { - "count": 5, - "dataSize": 0, - "messageType": "InspectorSplitMsgBegin" - }, - { - "count": 51, - "dataSize": 4593, - "messageType": "InspectorGroup" - }, - { - "count": 1, - "dataSize": 184, - "messageType": "InspectorTcpV4ListeningPort" - }, - { - "count": 1159, - "dataSize": 3146579, - "messageType": "Total" - }, - { - "count": 5, - "dataSize": 0, - "messageType": "InspectorSplitMsgEnd" - }, - { - "count": 1, - "dataSize": 612, - "messageType": "InspectorLoadImageInProcess" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Information about the data that is collected for the specified assessment run.", - "id": "get-telemetry-metadata-1481066021297", - "title": "Get telemetry metadata" - } - ], - "ListAssessmentRunAgents": [ - { - "input": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", - "maxResults": 123 - }, - "output": { - "assessmentRunAgents": [ - { - "agentHealth": "HEALTHY", - "agentHealthCode": "RUNNING", - "agentId": "i-49113b93", - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", - "telemetryMetadata": [ - { - "count": 2, - "dataSize": 345, - "messageType": "InspectorDuplicateProcess" - }, - { - "count": 3, - "dataSize": 255, - "messageType": "InspectorTimeEventMsg" - }, - { - "count": 4, - "dataSize": 1082, - "messageType": "InspectorNetworkInterface" - }, - { - "count": 2, - "dataSize": 349, - "messageType": "InspectorDnsEntry" - }, - { - "count": 11, - "dataSize": 2514, - "messageType": "InspectorDirectoryInfoMsg" - }, - { - "count": 1, - "dataSize": 179, - "messageType": "InspectorTcpV6ListeningPort" - }, - { - "count": 101, - "dataSize": 10949, - "messageType": "InspectorTerminal" - }, - { - "count": 26, - "dataSize": 5916, - "messageType": "InspectorUser" - }, - { - "count": 282, - "dataSize": 32148, - "messageType": "InspectorDynamicallyLoadedCodeModule" - }, - { - "count": 18, - "dataSize": 10172, - "messageType": "InspectorCreateProcess" - }, - { - "count": 3, - "dataSize": 8001, - "messageType": "InspectorProcessPerformance" - }, - { - "count": 1, - "dataSize": 360, - "messageType": "InspectorOperatingSystem" - }, - { - "count": 6, - "dataSize": 546, - "messageType": "InspectorStopProcess" - }, - { - "count": 1, - "dataSize": 1553, - "messageType": "InspectorInstanceMetaData" - }, - { - "count": 2, - "dataSize": 434, - "messageType": "InspectorTcpV4Connection" - }, - { - "count": 474, - "dataSize": 2960322, - "messageType": "InspectorPackageInfo" - }, - { - "count": 3, - "dataSize": 2235, - "messageType": "InspectorSystemPerformance" - }, - { - "count": 105, - "dataSize": 46048, - "messageType": "InspectorCodeModule" - }, - { - "count": 1, - "dataSize": 182, - "messageType": "InspectorUdpV6ListeningPort" - }, - { - "count": 2, - "dataSize": 371, - "messageType": "InspectorUdpV4ListeningPort" - }, - { - "count": 18, - "dataSize": 8362, - "messageType": "InspectorKernelModule" - }, - { - "count": 29, - "dataSize": 48788, - "messageType": "InspectorConfigurationInfo" - }, - { - "count": 1, - "dataSize": 79, - "messageType": "InspectorMonitoringStart" - }, - { - "count": 5, - "dataSize": 0, - "messageType": "InspectorSplitMsgBegin" - }, - { - "count": 51, - "dataSize": 4593, - "messageType": "InspectorGroup" - }, - { - "count": 1, - "dataSize": 184, - "messageType": "InspectorTcpV4ListeningPort" - }, - { - "count": 1159, - "dataSize": 3146579, - "messageType": "Total" - }, - { - "count": 5, - "dataSize": 0, - "messageType": "InspectorSplitMsgEnd" - }, - { - "count": 1, - "dataSize": 612, - "messageType": "InspectorLoadImageInProcess" - } - ] - } - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.", - "id": "list-assessment-run-agents-1481918140642", - "title": "List assessment run agents" - } - ], - "ListAssessmentRuns": [ - { - "input": { - "assessmentTemplateArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw" - ], - "maxResults": 123 - }, - "output": { - "assessmentRunArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v" - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.", - "id": "list-assessment-runs-1481066340844", - "title": "List assessment runs" - } - ], - "ListAssessmentTargets": [ - { - "input": { - "maxResults": 123 - }, - "output": { - "assessmentTargetArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the ARNs of the assessment targets within this AWS account. ", - "id": "list-assessment-targets-1481066540849", - "title": "List assessment targets" - } - ], - "ListAssessmentTemplates": [ - { - "input": { - "assessmentTargetArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" - ], - "maxResults": 123 - }, - "output": { - "assessmentTemplateArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-Uza6ihLh" - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets.", - "id": "list-assessment-templates-1481066623520", - "title": "List assessment templates" - } - ], - "ListEventSubscriptions": [ - { - "input": { - "maxResults": 123, - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0" - }, - "output": { - "nextToken": "1", - "subscriptions": [ - { - "eventSubscriptions": [ - { - "event": "ASSESSMENT_RUN_COMPLETED", - "subscribedAt": "1459455440.867" - } - ], - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", - "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template. ", - "id": "list-event-subscriptions-1481068376945", - "title": "List event subscriptions" - } - ], - "ListFindings": [ - { - "input": { - "assessmentRunArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE" - ], - "maxResults": 123 - }, - "output": { - "findingArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v/finding/0-tyvmqBLy" - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs.", - "id": "list-findings-1481066840611", - "title": "List findings" - } - ], - "ListRulesPackages": [ - { - "input": { - "maxResults": 123 - }, - "output": { - "nextToken": "1", - "rulesPackageArns": [ - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p", - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-H5hpSawc", - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ", - "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-vg5GGHSD" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists all available Amazon Inspector rules packages.", - "id": "list-rules-packages-1481066954883", - "title": "List rules packages" - } - ], - "ListTagsForResource": [ - { - "input": { - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYu" - }, - "output": { - "tags": [ - { - "key": "Name", - "value": "Example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists all tags associated with an assessment template.", - "id": "list-tags-for-resource-1481067025240", - "title": "List tags for resource" - } - ], - "PreviewAgents": [ - { - "input": { - "maxResults": 123, - "previewAgentsArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" - }, - "output": { - "agentPreviews": [ - { - "agentId": "i-49113b93" - } - ], - "nextToken": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Previews the agents installed on the EC2 instances that are part of the specified assessment target.", - "id": "preview-agents-1481067101888", - "title": "Preview agents" - } - ], - "RegisterCrossAccountAccessRole": [ - { - "input": { - "roleArn": "arn:aws:iam::123456789012:role/inspector" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Registers the IAM role that Amazon Inspector uses to list your EC2 instances at the start of the assessment run or when you call the PreviewAgents action.", - "id": "register-cross-account-access-role-1481067178301", - "title": "Register cross account access role" - } - ], - "RemoveAttributesFromFindings": [ - { - "input": { - "attributeKeys": [ - "key=Example,value=example" - ], - "findingArns": [ - "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU" - ] - }, - "output": { - "failedItems": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists.", - "id": "remove-attributes-from-findings-1481067246548", - "title": "Remove attributes from findings" - } - ], - "SetTagsForResource": [ - { - "input": { - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", - "tags": [ - { - "key": "Example", - "value": "example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template.", - "id": "set-tags-for-resource-1481067329646", - "title": "Set tags for resource" - } - ], - "StartAssessmentRun": [ - { - "input": { - "assessmentRunName": "examplerun", - "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T" - }, - "output": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Starts the assessment run specified by the ARN of the assessment template. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.", - "id": "start-assessment-run-1481067407484", - "title": "Start assessment run" - } - ], - "StopAssessmentRun": [ - { - "input": { - "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Stops the assessment run that is specified by the ARN of the assessment run.", - "id": "stop-assessment-run-1481067502857", - "title": "Stop assessment run" - } - ], - "SubscribeToEvent": [ - { - "input": { - "event": "ASSESSMENT_RUN_COMPLETED", - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", - "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.", - "id": "subscribe-to-event-1481067686031", - "title": "Subscribe to event" - } - ], - "UnsubscribeFromEvent": [ - { - "input": { - "event": "ASSESSMENT_RUN_COMPLETED", - "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", - "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.", - "id": "unsubscribe-from-event-1481067781705", - "title": "Unsubscribe from event" - } - ], - "UpdateAssessmentTarget": [ - { - "input": { - "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX", - "assessmentTargetName": "Example", - "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5Pt" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates the assessment target that is specified by the ARN of the assessment target.", - "id": "update-assessment-target-1481067866692", - "title": "Update assessment target" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/paginators-1.json deleted file mode 100644 index 83d2ad2c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/paginators-1.json +++ /dev/null @@ -1,52 +0,0 @@ -{ - "pagination": { - "ListFindings": { - "result_key": "findingArns", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListAssessmentTemplates": { - "result_key": "assessmentTemplateArns", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "PreviewAgents": { - "result_key": "agentPreviews", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListEventSubscriptions": { - "result_key": "subscriptions", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListRulesPackages": { - "result_key": "rulesPackageArns", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListAssessmentRunAgents": { - "result_key": "assessmentRunAgents", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListAssessmentRuns": { - "result_key": "assessmentRunArns", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListAssessmentTargets": { - "result_key": "assessmentTargetArns", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/service-2.json deleted file mode 100644 index cc6ef8a2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/inspector/2016-02-16/service-2.json +++ /dev/null @@ -1,3315 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-02-16", - "endpointPrefix":"inspector", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Inspector", - "serviceId":"Inspector", - "signatureVersion":"v4", - "targetPrefix":"InspectorService", - "uid":"inspector-2016-02-16" - }, - "operations":{ - "AddAttributesToFindings":{ - "name":"AddAttributesToFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddAttributesToFindingsRequest"}, - "output":{"shape":"AddAttributesToFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.

" - }, - "CreateAssessmentTarget":{ - "name":"CreateAssessmentTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAssessmentTargetRequest"}, - "output":{"shape":"CreateAssessmentTargetResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidCrossAccountRoleException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Amazon Inspector Assessment Targets.

" - }, - "CreateAssessmentTemplate":{ - "name":"CreateAssessmentTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAssessmentTemplateRequest"}, - "output":{"shape":"CreateAssessmentTemplateResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Creates an assessment template for the assessment target that is specified by the ARN of the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments.

" - }, - "CreateExclusionsPreview":{ - "name":"CreateExclusionsPreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateExclusionsPreviewRequest"}, - "output":{"shape":"CreateExclusionsPreviewResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"PreviewGenerationInProgressException"}, - {"shape":"InternalException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview lists the potential exclusions (ExclusionPreview) that Inspector can detect before it runs the assessment.

" - }, - "CreateResourceGroup":{ - "name":"CreateResourceGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateResourceGroupRequest"}, - "output":{"shape":"CreateResourceGroupResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector assessment target. The created resource group is then used to create an Amazon Inspector assessment target. For more information, see CreateAssessmentTarget.

" - }, - "DeleteAssessmentRun":{ - "name":"DeleteAssessmentRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAssessmentRunRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AssessmentRunInProgressException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Deletes the assessment run that is specified by the ARN of the assessment run.

" - }, - "DeleteAssessmentTarget":{ - "name":"DeleteAssessmentTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAssessmentTargetRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AssessmentRunInProgressException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Deletes the assessment target that is specified by the ARN of the assessment target.

" - }, - "DeleteAssessmentTemplate":{ - "name":"DeleteAssessmentTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAssessmentTemplateRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AssessmentRunInProgressException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Deletes the assessment template that is specified by the ARN of the assessment template.

" - }, - "DescribeAssessmentRuns":{ - "name":"DescribeAssessmentRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssessmentRunsRequest"}, - "output":{"shape":"DescribeAssessmentRunsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the assessment runs that are specified by the ARNs of the assessment runs.

" - }, - "DescribeAssessmentTargets":{ - "name":"DescribeAssessmentTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssessmentTargetsRequest"}, - "output":{"shape":"DescribeAssessmentTargetsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the assessment targets that are specified by the ARNs of the assessment targets.

" - }, - "DescribeAssessmentTemplates":{ - "name":"DescribeAssessmentTemplates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssessmentTemplatesRequest"}, - "output":{"shape":"DescribeAssessmentTemplatesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the assessment templates that are specified by the ARNs of the assessment templates.

" - }, - "DescribeCrossAccountAccessRole":{ - "name":"DescribeCrossAccountAccessRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"DescribeCrossAccountAccessRoleResponse"}, - "errors":[ - {"shape":"InternalException"} - ], - "documentation":"

Describes the IAM role that enables Amazon Inspector to access your AWS account.

" - }, - "DescribeExclusions":{ - "name":"DescribeExclusions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExclusionsRequest"}, - "output":{"shape":"DescribeExclusionsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the exclusions that are specified by the exclusions' ARNs.

" - }, - "DescribeFindings":{ - "name":"DescribeFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeFindingsRequest"}, - "output":{"shape":"DescribeFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the findings that are specified by the ARNs of the findings.

" - }, - "DescribeResourceGroups":{ - "name":"DescribeResourceGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResourceGroupsRequest"}, - "output":{"shape":"DescribeResourceGroupsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the resource groups that are specified by the ARNs of the resource groups.

" - }, - "DescribeRulesPackages":{ - "name":"DescribeRulesPackages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRulesPackagesRequest"}, - "output":{"shape":"DescribeRulesPackagesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Describes the rules packages that are specified by the ARNs of the rules packages.

" - }, - "GetAssessmentReport":{ - "name":"GetAssessmentReport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAssessmentReportRequest"}, - "output":{"shape":"GetAssessmentReportResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"AssessmentRunInProgressException"}, - {"shape":"UnsupportedFeatureException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Produces an assessment report that includes detailed and comprehensive results of a specified assessment run.

" - }, - "GetExclusionsPreview":{ - "name":"GetExclusionsPreview", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetExclusionsPreviewRequest"}, - "output":{"shape":"GetExclusionsPreviewResponse"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token. You can obtain the preview token by running the CreateExclusionsPreview API.

" - }, - "GetTelemetryMetadata":{ - "name":"GetTelemetryMetadata", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTelemetryMetadataRequest"}, - "output":{"shape":"GetTelemetryMetadataResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Information about the data that is collected for the specified assessment run.

" - }, - "ListAssessmentRunAgents":{ - "name":"ListAssessmentRunAgents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentRunAgentsRequest"}, - "output":{"shape":"ListAssessmentRunAgentsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.

" - }, - "ListAssessmentRuns":{ - "name":"ListAssessmentRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentRunsRequest"}, - "output":{"shape":"ListAssessmentRunsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.

" - }, - "ListAssessmentTargets":{ - "name":"ListAssessmentTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentTargetsRequest"}, - "output":{"shape":"ListAssessmentTargetsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Lists the ARNs of the assessment targets within this AWS account. For more information about assessment targets, see Amazon Inspector Assessment Targets.

" - }, - "ListAssessmentTemplates":{ - "name":"ListAssessmentTemplates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssessmentTemplatesRequest"}, - "output":{"shape":"ListAssessmentTemplatesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets.

" - }, - "ListEventSubscriptions":{ - "name":"ListEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEventSubscriptionsRequest"}, - "output":{"shape":"ListEventSubscriptionsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template. For more information, see SubscribeToEvent and UnsubscribeFromEvent.

" - }, - "ListExclusions":{ - "name":"ListExclusions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListExclusionsRequest"}, - "output":{"shape":"ListExclusionsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

List exclusions that are generated by the assessment run.

" - }, - "ListFindings":{ - "name":"ListFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListFindingsRequest"}, - "output":{"shape":"ListFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs.

" - }, - "ListRulesPackages":{ - "name":"ListRulesPackages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRulesPackagesRequest"}, - "output":{"shape":"ListRulesPackagesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Lists all available Amazon Inspector rules packages.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"} - ], - "documentation":"

Lists all tags associated with an assessment template.

" - }, - "PreviewAgents":{ - "name":"PreviewAgents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PreviewAgentsRequest"}, - "output":{"shape":"PreviewAgentsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidCrossAccountRoleException"} - ], - "documentation":"

Previews the agents installed on the EC2 instances that are part of the specified assessment target.

" - }, - "RegisterCrossAccountAccessRole":{ - "name":"RegisterCrossAccountAccessRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterCrossAccountAccessRoleRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InvalidCrossAccountRoleException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Registers the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.

" - }, - "RemoveAttributesFromFindings":{ - "name":"RemoveAttributesFromFindings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveAttributesFromFindingsRequest"}, - "output":{"shape":"RemoveAttributesFromFindingsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists.

" - }, - "SetTagsForResource":{ - "name":"SetTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetTagsForResourceRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template.

" - }, - "StartAssessmentRun":{ - "name":"StartAssessmentRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartAssessmentRunRequest"}, - "output":{"shape":"StartAssessmentRunResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"InvalidCrossAccountRoleException"}, - {"shape":"AgentsAlreadyRunningAssessmentException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Starts the assessment run specified by the ARN of the assessment template. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.

" - }, - "StopAssessmentRun":{ - "name":"StopAssessmentRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopAssessmentRunRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Stops the assessment run that is specified by the ARN of the assessment run.

" - }, - "SubscribeToEvent":{ - "name":"SubscribeToEvent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SubscribeToEventRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.

" - }, - "UnsubscribeFromEvent":{ - "name":"UnsubscribeFromEvent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnsubscribeFromEventRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.

" - }, - "UpdateAssessmentTarget":{ - "name":"UpdateAssessmentTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAssessmentTargetRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"NoSuchEntityException"}, - {"shape":"ServiceTemporarilyUnavailableException"} - ], - "documentation":"

Updates the assessment target that is specified by the ARN of the assessment target.

If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.

" - } - }, - "shapes":{ - "AccessDeniedErrorCode":{ - "type":"string", - "enum":[ - "ACCESS_DENIED_TO_ASSESSMENT_TARGET", - "ACCESS_DENIED_TO_ASSESSMENT_TEMPLATE", - "ACCESS_DENIED_TO_ASSESSMENT_RUN", - "ACCESS_DENIED_TO_FINDING", - "ACCESS_DENIED_TO_RESOURCE_GROUP", - "ACCESS_DENIED_TO_RULES_PACKAGE", - "ACCESS_DENIED_TO_SNS_TOPIC", - "ACCESS_DENIED_TO_IAM_ROLE" - ] - }, - "AccessDeniedException":{ - "type":"structure", - "required":[ - "message", - "errorCode", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "errorCode":{ - "shape":"AccessDeniedErrorCode", - "documentation":"

Code that indicates the type of error that is generated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

You do not have required permissions to access the requested resource.

", - "exception":true - }, - "AddAttributesToFindingsRequest":{ - "type":"structure", - "required":[ - "findingArns", - "attributes" - ], - "members":{ - "findingArns":{ - "shape":"AddRemoveAttributesFindingArnList", - "documentation":"

The ARNs that specify the findings that you want to assign attributes to.

" - }, - "attributes":{ - "shape":"UserAttributeList", - "documentation":"

The array of attributes that you want to assign to specified findings.

" - } - } - }, - "AddAttributesToFindingsResponse":{ - "type":"structure", - "required":["failedItems"], - "members":{ - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Attribute details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "AddRemoveAttributesFindingArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":10, - "min":1 - }, - "AgentAlreadyRunningAssessment":{ - "type":"structure", - "required":[ - "agentId", - "assessmentRunArn" - ], - "members":{ - "agentId":{ - "shape":"AgentId", - "documentation":"

ID of the agent that is running on an EC2 instance that is already participating in another started assessment run.

" - }, - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that has already been started.

" - } - }, - "documentation":"

Used in the exception error that is thrown if you start an assessment run for an assessment target that includes an EC2 instance that is already participating in another started assessment run.

" - }, - "AgentAlreadyRunningAssessmentList":{ - "type":"list", - "member":{"shape":"AgentAlreadyRunningAssessment"}, - "max":10, - "min":1 - }, - "AgentFilter":{ - "type":"structure", - "required":[ - "agentHealths", - "agentHealthCodes" - ], - "members":{ - "agentHealths":{ - "shape":"AgentHealthList", - "documentation":"

The current health state of the agent. Values can be set to HEALTHY or UNHEALTHY.

" - }, - "agentHealthCodes":{ - "shape":"AgentHealthCodeList", - "documentation":"

The detailed health state of the agent. Values can be set to IDLE, RUNNING, SHUTDOWN, UNHEALTHY, THROTTLED, and UNKNOWN.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector agent. This data type is used as a request parameter in the ListAssessmentRunAgents action.

" - }, - "AgentHealth":{ - "type":"string", - "enum":[ - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - }, - "AgentHealthCode":{ - "type":"string", - "enum":[ - "IDLE", - "RUNNING", - "SHUTDOWN", - "UNHEALTHY", - "THROTTLED", - "UNKNOWN" - ] - }, - "AgentHealthCodeList":{ - "type":"list", - "member":{"shape":"AgentHealthCode"}, - "max":10, - "min":0 - }, - "AgentHealthList":{ - "type":"list", - "member":{"shape":"AgentHealth"}, - "max":10, - "min":0 - }, - "AgentId":{ - "type":"string", - "max":128, - "min":1 - }, - "AgentIdList":{ - "type":"list", - "member":{"shape":"AgentId"}, - "max":500, - "min":0 - }, - "AgentPreview":{ - "type":"structure", - "required":["agentId"], - "members":{ - "hostname":{ - "shape":"Hostname", - "documentation":"

The hostname of the EC2 instance on which the Amazon Inspector Agent is installed.

" - }, - "agentId":{ - "shape":"AgentId", - "documentation":"

The ID of the EC2 instance where the agent is installed.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

The Auto Scaling group for the EC2 instance where the agent is installed.

" - }, - "agentHealth":{ - "shape":"AgentHealth", - "documentation":"

The health status of the Amazon Inspector Agent.

" - }, - "agentVersion":{ - "shape":"AgentVersion", - "documentation":"

The version of the Amazon Inspector Agent.

" - }, - "operatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

The operating system running on the EC2 instance on which the Amazon Inspector Agent is installed.

" - }, - "kernelVersion":{ - "shape":"KernelVersion", - "documentation":"

The kernel version of the operating system running on the EC2 instance on which the Amazon Inspector Agent is installed.

" - }, - "ipv4Address":{ - "shape":"Ipv4Address", - "documentation":"

The IP address of the EC2 instance on which the Amazon Inspector Agent is installed.

" - } - }, - "documentation":"

Used as a response element in the PreviewAgents action.

" - }, - "AgentPreviewList":{ - "type":"list", - "member":{"shape":"AgentPreview"}, - "max":100, - "min":0 - }, - "AgentVersion":{ - "type":"string", - "max":128, - "min":1 - }, - "AgentsAlreadyRunningAssessmentException":{ - "type":"structure", - "required":[ - "message", - "agents", - "agentsTruncated", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "agents":{ - "shape":"AgentAlreadyRunningAssessmentList", - "documentation":"

" - }, - "agentsTruncated":{ - "shape":"Bool", - "documentation":"

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

You started an assessment run, but one of the instances is already participating in another assessment run.

", - "exception":true - }, - "AmiId":{ - "type":"string", - "max":256, - "min":0 - }, - "Arn":{ - "type":"string", - "max":300, - "min":1 - }, - "ArnCount":{"type":"integer"}, - "AssessmentRulesPackageArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":50, - "min":1 - }, - "AssessmentRun":{ - "type":"structure", - "required":[ - "arn", - "name", - "assessmentTemplateArn", - "state", - "durationInSeconds", - "rulesPackageArns", - "userAttributesForFindings", - "createdAt", - "stateChangedAt", - "dataCollected", - "stateChanges", - "notifications", - "findingCounts" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run.

" - }, - "name":{ - "shape":"AssessmentRunName", - "documentation":"

The auto-generated name for the assessment run.

" - }, - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template that is associated with the assessment run.

" - }, - "state":{ - "shape":"AssessmentRunState", - "documentation":"

The state of the assessment run.

" - }, - "durationInSeconds":{ - "shape":"AssessmentRunDuration", - "documentation":"

The duration of the assessment run.

" - }, - "rulesPackageArns":{ - "shape":"AssessmentRulesPackageArnList", - "documentation":"

The rules packages selected for the assessment run.

" - }, - "userAttributesForFindings":{ - "shape":"UserAttributeList", - "documentation":"

The user-defined attributes that are assigned to every generated finding.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The time when StartAssessmentRun was called.

" - }, - "startedAt":{ - "shape":"Timestamp", - "documentation":"

The time when StartAssessmentRun was called.

" - }, - "completedAt":{ - "shape":"Timestamp", - "documentation":"

The assessment run completion time that corresponds to the rules packages evaluation completion time or failure.

" - }, - "stateChangedAt":{ - "shape":"Timestamp", - "documentation":"

The last time when the assessment run's state changed.

" - }, - "dataCollected":{ - "shape":"Bool", - "documentation":"

A Boolean value (true or false) that specifies whether the process of collecting data from the agents is completed.

" - }, - "stateChanges":{ - "shape":"AssessmentRunStateChangeList", - "documentation":"

A list of the assessment run state changes.

" - }, - "notifications":{ - "shape":"AssessmentRunNotificationList", - "documentation":"

A list of notifications for the event subscriptions. A notification about a particular generated finding is added to this list only once.

" - }, - "findingCounts":{ - "shape":"AssessmentRunFindingCounts", - "documentation":"

Provides a total count of generated findings per severity.

" - } - }, - "documentation":"

A snapshot of an Amazon Inspector assessment run that contains the findings of the assessment run .

Used as the response element in the DescribeAssessmentRuns action.

" - }, - "AssessmentRunAgent":{ - "type":"structure", - "required":[ - "agentId", - "assessmentRunArn", - "agentHealth", - "agentHealthCode", - "telemetryMetadata" - ], - "members":{ - "agentId":{ - "shape":"AgentId", - "documentation":"

The AWS account of the EC2 instance where the agent is installed.

" - }, - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that is associated with the agent.

" - }, - "agentHealth":{ - "shape":"AgentHealth", - "documentation":"

The current health state of the agent.

" - }, - "agentHealthCode":{ - "shape":"AgentHealthCode", - "documentation":"

The detailed health state of the agent.

" - }, - "agentHealthDetails":{ - "shape":"Message", - "documentation":"

The description for the agent health code.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

The Auto Scaling group of the EC2 instance that is specified by the agent ID.

" - }, - "telemetryMetadata":{ - "shape":"TelemetryMetadataList", - "documentation":"

The Amazon Inspector application data metrics that are collected by the agent.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector agent. This data type is used as a response element in the ListAssessmentRunAgents action.

" - }, - "AssessmentRunAgentList":{ - "type":"list", - "member":{"shape":"AssessmentRunAgent"}, - "max":500, - "min":0 - }, - "AssessmentRunDuration":{ - "type":"integer", - "max":86400, - "min":180 - }, - "AssessmentRunFilter":{ - "type":"structure", - "members":{ - "namePattern":{ - "shape":"NamePattern", - "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard that is specified for this data type property must match the value of the assessmentRunName property of the AssessmentRun data type.

" - }, - "states":{ - "shape":"AssessmentRunStateList", - "documentation":"

For a record to match a filter, one of the values specified for this data type property must be the exact match of the value of the assessmentRunState property of the AssessmentRun data type.

" - }, - "durationRange":{ - "shape":"DurationRange", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the durationInSeconds property of the AssessmentRun data type.

" - }, - "rulesPackageArns":{ - "shape":"FilterRulesPackageArnList", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must be contained in the list of values of the rulesPackages property of the AssessmentRun data type.

" - }, - "startTimeRange":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the startTime property of the AssessmentRun data type.

" - }, - "completionTimeRange":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the completedAt property of the AssessmentRun data type.

" - }, - "stateChangeTimeRange":{ - "shape":"TimestampRange", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must match the stateChangedAt property of the AssessmentRun data type.

" - } - }, - "documentation":"

Used as the request parameter in the ListAssessmentRuns action.

" - }, - "AssessmentRunFindingCounts":{ - "type":"map", - "key":{"shape":"Severity"}, - "value":{"shape":"FindingCount"} - }, - "AssessmentRunInProgressArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":10, - "min":1 - }, - "AssessmentRunInProgressException":{ - "type":"structure", - "required":[ - "message", - "assessmentRunArns", - "assessmentRunArnsTruncated", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "assessmentRunArns":{ - "shape":"AssessmentRunInProgressArnList", - "documentation":"

The ARNs of the assessment runs that are currently in progress.

" - }, - "assessmentRunArnsTruncated":{ - "shape":"Bool", - "documentation":"

Boolean value that indicates whether the ARN list of the assessment runs is truncated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

You cannot perform a specified action if an assessment run is currently in progress.

", - "exception":true - }, - "AssessmentRunList":{ - "type":"list", - "member":{"shape":"AssessmentRun"}, - "max":10, - "min":0 - }, - "AssessmentRunName":{ - "type":"string", - "max":140, - "min":1 - }, - "AssessmentRunNotification":{ - "type":"structure", - "required":[ - "date", - "event", - "error" - ], - "members":{ - "date":{ - "shape":"Timestamp", - "documentation":"

The date of the notification.

" - }, - "event":{ - "shape":"InspectorEvent", - "documentation":"

The event for which a notification is sent.

" - }, - "message":{ - "shape":"Message", - "documentation":"

The message included in the notification.

" - }, - "error":{ - "shape":"Bool", - "documentation":"

The Boolean value that specifies whether the notification represents an error.

" - }, - "snsTopicArn":{ - "shape":"Arn", - "documentation":"

The SNS topic to which the SNS notification is sent.

" - }, - "snsPublishStatusCode":{ - "shape":"AssessmentRunNotificationSnsStatusCode", - "documentation":"

The status code of the SNS notification.

" - } - }, - "documentation":"

Used as one of the elements of the AssessmentRun data type.

" - }, - "AssessmentRunNotificationList":{ - "type":"list", - "member":{"shape":"AssessmentRunNotification"}, - "max":50, - "min":0 - }, - "AssessmentRunNotificationSnsStatusCode":{ - "type":"string", - "enum":[ - "SUCCESS", - "TOPIC_DOES_NOT_EXIST", - "ACCESS_DENIED", - "INTERNAL_ERROR" - ] - }, - "AssessmentRunState":{ - "type":"string", - "enum":[ - "CREATED", - "START_DATA_COLLECTION_PENDING", - "START_DATA_COLLECTION_IN_PROGRESS", - "COLLECTING_DATA", - "STOP_DATA_COLLECTION_PENDING", - "DATA_COLLECTED", - "START_EVALUATING_RULES_PENDING", - "EVALUATING_RULES", - "FAILED", - "ERROR", - "COMPLETED", - "COMPLETED_WITH_ERRORS", - "CANCELED" - ] - }, - "AssessmentRunStateChange":{ - "type":"structure", - "required":[ - "stateChangedAt", - "state" - ], - "members":{ - "stateChangedAt":{ - "shape":"Timestamp", - "documentation":"

The last time the assessment run state changed.

" - }, - "state":{ - "shape":"AssessmentRunState", - "documentation":"

The assessment run state.

" - } - }, - "documentation":"

Used as one of the elements of the AssessmentRun data type.

" - }, - "AssessmentRunStateChangeList":{ - "type":"list", - "member":{"shape":"AssessmentRunStateChange"}, - "max":50, - "min":0 - }, - "AssessmentRunStateList":{ - "type":"list", - "member":{"shape":"AssessmentRunState"}, - "max":50, - "min":0 - }, - "AssessmentTarget":{ - "type":"structure", - "required":[ - "arn", - "name", - "createdAt", - "updatedAt" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the Amazon Inspector assessment target.

" - }, - "name":{ - "shape":"AssessmentTargetName", - "documentation":"

The name of the Amazon Inspector assessment target.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the resource group that is associated with the assessment target.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The time at which the assessment target is created.

" - }, - "updatedAt":{ - "shape":"Timestamp", - "documentation":"

The time at which UpdateAssessmentTarget is called.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector application. This data type is used as the response element in the DescribeAssessmentTargets action.

" - }, - "AssessmentTargetFilter":{ - "type":"structure", - "members":{ - "assessmentTargetNamePattern":{ - "shape":"NamePattern", - "documentation":"

For a record to match a filter, an explicit value or a string that contains a wildcard that is specified for this data type property must match the value of the assessmentTargetName property of the AssessmentTarget data type.

" - } - }, - "documentation":"

Used as the request parameter in the ListAssessmentTargets action.

" - }, - "AssessmentTargetList":{ - "type":"list", - "member":{"shape":"AssessmentTarget"}, - "max":10, - "min":0 - }, - "AssessmentTargetName":{ - "type":"string", - "max":140, - "min":1 - }, - "AssessmentTemplate":{ - "type":"structure", - "required":[ - "arn", - "name", - "assessmentTargetArn", - "durationInSeconds", - "rulesPackageArns", - "userAttributesForFindings", - "assessmentRunCount", - "createdAt" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template.

" - }, - "name":{ - "shape":"AssessmentTemplateName", - "documentation":"

The name of the assessment template.

" - }, - "assessmentTargetArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment target that corresponds to this assessment template.

" - }, - "durationInSeconds":{ - "shape":"AssessmentRunDuration", - "documentation":"

The duration in seconds specified for this assessment template. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" - }, - "rulesPackageArns":{ - "shape":"AssessmentTemplateRulesPackageArnList", - "documentation":"

The rules packages that are specified for this assessment template.

" - }, - "userAttributesForFindings":{ - "shape":"UserAttributeList", - "documentation":"

The user-defined attributes that are assigned to every generated finding from the assessment run that uses this assessment template.

" - }, - "lastAssessmentRunArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the most recent assessment run associated with this assessment template. This value exists only when the value of assessmentRunCount is greaterpa than zero.

" - }, - "assessmentRunCount":{ - "shape":"ArnCount", - "documentation":"

The number of existing assessment runs associated with this assessment template. This value can be zero or a positive integer.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The time at which the assessment template is created.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector assessment template. This data type is used as the response element in the DescribeAssessmentTemplates action.

" - }, - "AssessmentTemplateFilter":{ - "type":"structure", - "members":{ - "namePattern":{ - "shape":"NamePattern", - "documentation":"

For a record to match a filter, an explicit value or a string that contains a wildcard that is specified for this data type property must match the value of the assessmentTemplateName property of the AssessmentTemplate data type.

" - }, - "durationRange":{ - "shape":"DurationRange", - "documentation":"

For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the durationInSeconds property of the AssessmentTemplate data type.

" - }, - "rulesPackageArns":{ - "shape":"FilterRulesPackageArnList", - "documentation":"

For a record to match a filter, the values that are specified for this data type property must be contained in the list of values of the rulesPackageArns property of the AssessmentTemplate data type.

" - } - }, - "documentation":"

Used as the request parameter in the ListAssessmentTemplates action.

" - }, - "AssessmentTemplateList":{ - "type":"list", - "member":{"shape":"AssessmentTemplate"}, - "max":10, - "min":0 - }, - "AssessmentTemplateName":{ - "type":"string", - "max":140, - "min":1 - }, - "AssessmentTemplateRulesPackageArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":50, - "min":0 - }, - "AssetAttributes":{ - "type":"structure", - "required":["schemaVersion"], - "members":{ - "schemaVersion":{ - "shape":"NumericVersion", - "documentation":"

The schema version of this data type.

" - }, - "agentId":{ - "shape":"AgentId", - "documentation":"

The ID of the agent that is installed on the EC2 instance where the finding is generated.

" - }, - "autoScalingGroup":{ - "shape":"AutoScalingGroup", - "documentation":"

The Auto Scaling group of the EC2 instance where the finding is generated.

" - }, - "amiId":{ - "shape":"AmiId", - "documentation":"

The ID of the Amazon Machine Image (AMI) that is installed on the EC2 instance where the finding is generated.

" - }, - "hostname":{ - "shape":"Hostname", - "documentation":"

The hostname of the EC2 instance where the finding is generated.

" - }, - "ipv4Addresses":{ - "shape":"Ipv4AddressList", - "documentation":"

The list of IP v4 addresses of the EC2 instance where the finding is generated.

" - } - }, - "documentation":"

A collection of attributes of the host from which the finding is generated.

" - }, - "AssetType":{ - "type":"string", - "enum":["ec2-instance"] - }, - "Attribute":{ - "type":"structure", - "required":["key"], - "members":{ - "key":{ - "shape":"AttributeKey", - "documentation":"

The attribute key.

" - }, - "value":{ - "shape":"AttributeValue", - "documentation":"

The value assigned to the attribute key.

" - } - }, - "documentation":"

This data type is used as a request parameter in the AddAttributesToFindings and CreateAssessmentTemplate actions.

" - }, - "AttributeKey":{ - "type":"string", - "max":128, - "min":1 - }, - "AttributeList":{ - "type":"list", - "member":{"shape":"Attribute"}, - "max":50, - "min":0 - }, - "AttributeValue":{ - "type":"string", - "max":256, - "min":1 - }, - "AutoScalingGroup":{ - "type":"string", - "max":256, - "min":1 - }, - "AutoScalingGroupList":{ - "type":"list", - "member":{"shape":"AutoScalingGroup"}, - "max":20, - "min":0 - }, - "BatchDescribeArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":10, - "min":1 - }, - "BatchDescribeExclusionsArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":100, - "min":1 - }, - "Bool":{"type":"boolean"}, - "CreateAssessmentTargetRequest":{ - "type":"structure", - "required":["assessmentTargetName"], - "members":{ - "assessmentTargetName":{ - "shape":"AssessmentTargetName", - "documentation":"

The user-defined name that identifies the assessment target that you want to create. The name must be unique within the AWS account.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the resource group that is used to create the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.

" - } - } - }, - "CreateAssessmentTargetResponse":{ - "type":"structure", - "required":["assessmentTargetArn"], - "members":{ - "assessmentTargetArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment target that is created.

" - } - } - }, - "CreateAssessmentTemplateRequest":{ - "type":"structure", - "required":[ - "assessmentTargetArn", - "assessmentTemplateName", - "durationInSeconds", - "rulesPackageArns" - ], - "members":{ - "assessmentTargetArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment target for which you want to create the assessment template.

" - }, - "assessmentTemplateName":{ - "shape":"AssessmentTemplateName", - "documentation":"

The user-defined name that identifies the assessment template that you want to create. You can create several assessment templates for an assessment target. The names of the assessment templates that correspond to a particular assessment target must be unique.

" - }, - "durationInSeconds":{ - "shape":"AssessmentRunDuration", - "documentation":"

The duration of the assessment run in seconds.

" - }, - "rulesPackageArns":{ - "shape":"AssessmentTemplateRulesPackageArnList", - "documentation":"

The ARNs that specify the rules packages that you want to attach to the assessment template.

" - }, - "userAttributesForFindings":{ - "shape":"UserAttributeList", - "documentation":"

The user-defined attributes that are assigned to every finding that is generated by the assessment run that uses this assessment template. An attribute is a key and value pair (an Attribute object). Within an assessment template, each key must be unique.

" - } - } - }, - "CreateAssessmentTemplateResponse":{ - "type":"structure", - "required":["assessmentTemplateArn"], - "members":{ - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment template that is created.

" - } - } - }, - "CreateExclusionsPreviewRequest":{ - "type":"structure", - "required":["assessmentTemplateArn"], - "members":{ - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment template for which you want to create an exclusions preview.

" - } - } - }, - "CreateExclusionsPreviewResponse":{ - "type":"structure", - "required":["previewToken"], - "members":{ - "previewToken":{ - "shape":"UUID", - "documentation":"

Specifies the unique identifier of the requested exclusions preview. You can use the unique identifier to retrieve the exclusions preview when running the GetExclusionsPreview API.

" - } - } - }, - "CreateResourceGroupRequest":{ - "type":"structure", - "required":["resourceGroupTags"], - "members":{ - "resourceGroupTags":{ - "shape":"ResourceGroupTags", - "documentation":"

A collection of keys and an array of possible values, '[{\"key\":\"key1\",\"values\":[\"Value1\",\"Value2\"]},{\"key\":\"Key2\",\"values\":[\"Value3\"]}]'.

For example,'[{\"key\":\"Name\",\"values\":[\"TestEC2Instance\"]}]'.

" - } - } - }, - "CreateResourceGroupResponse":{ - "type":"structure", - "required":["resourceGroupArn"], - "members":{ - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the resource group that is created.

" - } - } - }, - "DeleteAssessmentRunRequest":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment run that you want to delete.

" - } - } - }, - "DeleteAssessmentTargetRequest":{ - "type":"structure", - "required":["assessmentTargetArn"], - "members":{ - "assessmentTargetArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment target that you want to delete.

" - } - } - }, - "DeleteAssessmentTemplateRequest":{ - "type":"structure", - "required":["assessmentTemplateArn"], - "members":{ - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment template that you want to delete.

" - } - } - }, - "DescribeAssessmentRunsRequest":{ - "type":"structure", - "required":["assessmentRunArns"], - "members":{ - "assessmentRunArns":{ - "shape":"BatchDescribeArnList", - "documentation":"

The ARN that specifies the assessment run that you want to describe.

" - } - } - }, - "DescribeAssessmentRunsResponse":{ - "type":"structure", - "required":[ - "assessmentRuns", - "failedItems" - ], - "members":{ - "assessmentRuns":{ - "shape":"AssessmentRunList", - "documentation":"

Information about the assessment run.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Assessment run details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeAssessmentTargetsRequest":{ - "type":"structure", - "required":["assessmentTargetArns"], - "members":{ - "assessmentTargetArns":{ - "shape":"BatchDescribeArnList", - "documentation":"

The ARNs that specifies the assessment targets that you want to describe.

" - } - } - }, - "DescribeAssessmentTargetsResponse":{ - "type":"structure", - "required":[ - "assessmentTargets", - "failedItems" - ], - "members":{ - "assessmentTargets":{ - "shape":"AssessmentTargetList", - "documentation":"

Information about the assessment targets.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Assessment target details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeAssessmentTemplatesRequest":{ - "type":"structure", - "required":["assessmentTemplateArns"], - "members":{ - "assessmentTemplateArns":{"shape":"BatchDescribeArnList"} - } - }, - "DescribeAssessmentTemplatesResponse":{ - "type":"structure", - "required":[ - "assessmentTemplates", - "failedItems" - ], - "members":{ - "assessmentTemplates":{ - "shape":"AssessmentTemplateList", - "documentation":"

Information about the assessment templates.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Assessment template details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeCrossAccountAccessRoleResponse":{ - "type":"structure", - "required":[ - "roleArn", - "valid", - "registeredAt" - ], - "members":{ - "roleArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the IAM role that Amazon Inspector uses to access your AWS account.

" - }, - "valid":{ - "shape":"Bool", - "documentation":"

A Boolean value that specifies whether the IAM role has the necessary policies attached to enable Amazon Inspector to access your AWS account.

" - }, - "registeredAt":{ - "shape":"Timestamp", - "documentation":"

The date when the cross-account access role was registered.

" - } - } - }, - "DescribeExclusionsRequest":{ - "type":"structure", - "required":["exclusionArns"], - "members":{ - "exclusionArns":{ - "shape":"BatchDescribeExclusionsArnList", - "documentation":"

The list of ARNs that specify the exclusions that you want to describe.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The locale into which you want to translate the exclusion's title, description, and recommendation.

" - } - } - }, - "DescribeExclusionsResponse":{ - "type":"structure", - "required":[ - "exclusions", - "failedItems" - ], - "members":{ - "exclusions":{ - "shape":"ExclusionMap", - "documentation":"

Information about the exclusions.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Exclusion details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeFindingsRequest":{ - "type":"structure", - "required":["findingArns"], - "members":{ - "findingArns":{ - "shape":"BatchDescribeArnList", - "documentation":"

The ARN that specifies the finding that you want to describe.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The locale into which you want to translate a finding description, recommendation, and the short description that identifies the finding.

" - } - } - }, - "DescribeFindingsResponse":{ - "type":"structure", - "required":[ - "findings", - "failedItems" - ], - "members":{ - "findings":{ - "shape":"FindingList", - "documentation":"

Information about the finding.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Finding details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeResourceGroupsRequest":{ - "type":"structure", - "required":["resourceGroupArns"], - "members":{ - "resourceGroupArns":{ - "shape":"BatchDescribeArnList", - "documentation":"

The ARN that specifies the resource group that you want to describe.

" - } - } - }, - "DescribeResourceGroupsResponse":{ - "type":"structure", - "required":[ - "resourceGroups", - "failedItems" - ], - "members":{ - "resourceGroups":{ - "shape":"ResourceGroupList", - "documentation":"

Information about a resource group.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Resource group details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DescribeRulesPackagesRequest":{ - "type":"structure", - "required":["rulesPackageArns"], - "members":{ - "rulesPackageArns":{ - "shape":"BatchDescribeArnList", - "documentation":"

The ARN that specifies the rules package that you want to describe.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The locale that you want to translate a rules package description into.

" - } - } - }, - "DescribeRulesPackagesResponse":{ - "type":"structure", - "required":[ - "rulesPackages", - "failedItems" - ], - "members":{ - "rulesPackages":{ - "shape":"RulesPackageList", - "documentation":"

Information about the rules package.

" - }, - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Rules package details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "DurationRange":{ - "type":"structure", - "members":{ - "minSeconds":{ - "shape":"AssessmentRunDuration", - "documentation":"

The minimum value of the duration range. Must be greater than zero.

" - }, - "maxSeconds":{ - "shape":"AssessmentRunDuration", - "documentation":"

The maximum value of the duration range. Must be less than or equal to 604800 seconds (1 week).

" - } - }, - "documentation":"

This data type is used in the AssessmentTemplateFilter data type.

" - }, - "ErrorMessage":{ - "type":"string", - "max":1000, - "min":0 - }, - "EventSubscription":{ - "type":"structure", - "required":[ - "event", - "subscribedAt" - ], - "members":{ - "event":{ - "shape":"InspectorEvent", - "documentation":"

The event for which Amazon Simple Notification Service (SNS) notifications are sent.

" - }, - "subscribedAt":{ - "shape":"Timestamp", - "documentation":"

The time at which SubscribeToEvent is called.

" - } - }, - "documentation":"

This data type is used in the Subscription data type.

" - }, - "EventSubscriptionList":{ - "type":"list", - "member":{"shape":"EventSubscription"}, - "max":50, - "min":1 - }, - "Exclusion":{ - "type":"structure", - "required":[ - "arn", - "title", - "description", - "recommendation", - "scopes" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the exclusion.

" - }, - "title":{ - "shape":"Text", - "documentation":"

The name of the exclusion.

" - }, - "description":{ - "shape":"Text", - "documentation":"

The description of the exclusion.

" - }, - "recommendation":{ - "shape":"Text", - "documentation":"

The recommendation for the exclusion.

" - }, - "scopes":{ - "shape":"ScopeList", - "documentation":"

The AWS resources for which the exclusion pertains.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

The system-defined attributes for the exclusion.

" - } - }, - "documentation":"

Contains information about what was excluded from an assessment run.

" - }, - "ExclusionMap":{ - "type":"map", - "key":{"shape":"Arn"}, - "value":{"shape":"Exclusion"}, - "max":100, - "min":1 - }, - "ExclusionPreview":{ - "type":"structure", - "required":[ - "title", - "description", - "recommendation", - "scopes" - ], - "members":{ - "title":{ - "shape":"Text", - "documentation":"

The name of the exclusion preview.

" - }, - "description":{ - "shape":"Text", - "documentation":"

The description of the exclusion preview.

" - }, - "recommendation":{ - "shape":"Text", - "documentation":"

The recommendation for the exclusion preview.

" - }, - "scopes":{ - "shape":"ScopeList", - "documentation":"

The AWS resources for which the exclusion preview pertains.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

The system-defined attributes for the exclusion preview.

" - } - }, - "documentation":"

Contains information about what is excluded from an assessment run given the current state of the assessment template.

" - }, - "ExclusionPreviewList":{ - "type":"list", - "member":{"shape":"ExclusionPreview"}, - "max":100, - "min":0 - }, - "FailedItemDetails":{ - "type":"structure", - "required":[ - "failureCode", - "retryable" - ], - "members":{ - "failureCode":{ - "shape":"FailedItemErrorCode", - "documentation":"

The status code of a failed item.

" - }, - "retryable":{ - "shape":"Bool", - "documentation":"

Indicates whether you can immediately retry a request for this item for a specified resource.

" - } - }, - "documentation":"

Includes details about the failed items.

" - }, - "FailedItemErrorCode":{ - "type":"string", - "enum":[ - "INVALID_ARN", - "DUPLICATE_ARN", - "ITEM_DOES_NOT_EXIST", - "ACCESS_DENIED", - "LIMIT_EXCEEDED", - "INTERNAL_ERROR" - ] - }, - "FailedItems":{ - "type":"map", - "key":{"shape":"Arn"}, - "value":{"shape":"FailedItemDetails"} - }, - "FilterRulesPackageArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":50, - "min":0 - }, - "Finding":{ - "type":"structure", - "required":[ - "arn", - "attributes", - "userAttributes", - "createdAt", - "updatedAt" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the finding.

" - }, - "schemaVersion":{ - "shape":"NumericVersion", - "documentation":"

The schema version of this data type.

" - }, - "service":{ - "shape":"ServiceName", - "documentation":"

The data element is set to \"Inspector\".

" - }, - "serviceAttributes":{ - "shape":"InspectorServiceAttributes", - "documentation":"

This data type is used in the Finding data type.

" - }, - "assetType":{ - "shape":"AssetType", - "documentation":"

The type of the host from which the finding is generated.

" - }, - "assetAttributes":{ - "shape":"AssetAttributes", - "documentation":"

A collection of attributes of the host from which the finding is generated.

" - }, - "id":{ - "shape":"FindingId", - "documentation":"

The ID of the finding.

" - }, - "title":{ - "shape":"Text", - "documentation":"

The name of the finding.

" - }, - "description":{ - "shape":"Text", - "documentation":"

The description of the finding.

" - }, - "recommendation":{ - "shape":"Text", - "documentation":"

The recommendation for the finding.

" - }, - "severity":{ - "shape":"Severity", - "documentation":"

The finding severity. Values can be set to High, Medium, Low, and Informational.

" - }, - "numericSeverity":{ - "shape":"NumericSeverity", - "documentation":"

The numeric value of the finding severity.

" - }, - "confidence":{ - "shape":"IocConfidence", - "documentation":"

This data element is currently not used.

" - }, - "indicatorOfCompromise":{ - "shape":"Bool", - "documentation":"

This data element is currently not used.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

The system-defined attributes for the finding.

" - }, - "userAttributes":{ - "shape":"UserAttributeList", - "documentation":"

The user-defined attributes that are assigned to the finding.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The time when the finding was generated.

" - }, - "updatedAt":{ - "shape":"Timestamp", - "documentation":"

The time when AddAttributesToFindings is called.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector finding. This data type is used as the response element in the DescribeFindings action.

" - }, - "FindingCount":{"type":"integer"}, - "FindingFilter":{ - "type":"structure", - "members":{ - "agentIds":{ - "shape":"AgentIdList", - "documentation":"

For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the agentId property of the Finding data type.

" - }, - "autoScalingGroups":{ - "shape":"AutoScalingGroupList", - "documentation":"

For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the autoScalingGroup property of the Finding data type.

" - }, - "ruleNames":{ - "shape":"RuleNameList", - "documentation":"

For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the ruleName property of the Finding data type.

" - }, - "severities":{ - "shape":"SeverityList", - "documentation":"

For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the severity property of the Finding data type.

" - }, - "rulesPackageArns":{ - "shape":"FilterRulesPackageArnList", - "documentation":"

For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the rulesPackageArn property of the Finding data type.

" - }, - "attributes":{ - "shape":"AttributeList", - "documentation":"

For a record to match a filter, the list of values that are specified for this data type property must be contained in the list of values of the attributes property of the Finding data type.

" - }, - "userAttributes":{ - "shape":"AttributeList", - "documentation":"

For a record to match a filter, the value that is specified for this data type property must be contained in the list of values of the userAttributes property of the Finding data type.

" - }, - "creationTimeRange":{ - "shape":"TimestampRange", - "documentation":"

The time range during which the finding is generated.

" - } - }, - "documentation":"

This data type is used as a request parameter in the ListFindings action.

" - }, - "FindingId":{ - "type":"string", - "max":128, - "min":0 - }, - "FindingList":{ - "type":"list", - "member":{"shape":"Finding"}, - "max":100, - "min":0 - }, - "GetAssessmentReportRequest":{ - "type":"structure", - "required":[ - "assessmentRunArn", - "reportFileFormat", - "reportType" - ], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment run for which you want to generate a report.

" - }, - "reportFileFormat":{ - "shape":"ReportFileFormat", - "documentation":"

Specifies the file format (html or pdf) of the assessment report that you want to generate.

" - }, - "reportType":{ - "shape":"ReportType", - "documentation":"

Specifies the type of the assessment report that you want to generate. There are two types of assessment reports: a finding report and a full report. For more information, see Assessment Reports.

" - } - } - }, - "GetAssessmentReportResponse":{ - "type":"structure", - "required":["status"], - "members":{ - "status":{ - "shape":"ReportStatus", - "documentation":"

Specifies the status of the request to generate an assessment report.

" - }, - "url":{ - "shape":"Url", - "documentation":"

Specifies the URL where you can find the generated assessment report. This parameter is only returned if the report is successfully generated.

" - } - } - }, - "GetExclusionsPreviewRequest":{ - "type":"structure", - "required":[ - "assessmentTemplateArn", - "previewToken" - ], - "members":{ - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment template for which the exclusions preview was requested.

" - }, - "previewToken":{ - "shape":"UUID", - "documentation":"

The unique identifier associated of the exclusions preview.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the GetExclusionsPreviewRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The locale into which you want to translate the exclusion's title, description, and recommendation.

" - } - } - }, - "GetExclusionsPreviewResponse":{ - "type":"structure", - "required":["previewStatus"], - "members":{ - "previewStatus":{ - "shape":"PreviewStatus", - "documentation":"

Specifies the status of the request to generate an exclusions preview.

" - }, - "exclusionPreviews":{ - "shape":"ExclusionPreviewList", - "documentation":"

Information about the exclusions included in the preview.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "GetTelemetryMetadataRequest":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment run that has the telemetry data that you want to obtain.

" - } - } - }, - "GetTelemetryMetadataResponse":{ - "type":"structure", - "required":["telemetryMetadata"], - "members":{ - "telemetryMetadata":{ - "shape":"TelemetryMetadataList", - "documentation":"

Telemetry details.

" - } - } - }, - "Hostname":{ - "type":"string", - "max":256, - "min":0 - }, - "InspectorEvent":{ - "type":"string", - "enum":[ - "ASSESSMENT_RUN_STARTED", - "ASSESSMENT_RUN_COMPLETED", - "ASSESSMENT_RUN_STATE_CHANGED", - "FINDING_REPORTED", - "OTHER" - ] - }, - "InspectorServiceAttributes":{ - "type":"structure", - "required":["schemaVersion"], - "members":{ - "schemaVersion":{ - "shape":"NumericVersion", - "documentation":"

The schema version of this data type.

" - }, - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run during which the finding is generated.

" - }, - "rulesPackageArn":{ - "shape":"Arn", - "documentation":"

The ARN of the rules package that is used to generate the finding.

" - } - }, - "documentation":"

This data type is used in the Finding data type.

" - }, - "InternalException":{ - "type":"structure", - "required":[ - "message", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

Internal server error.

", - "exception":true, - "fault":true - }, - "InvalidCrossAccountRoleErrorCode":{ - "type":"string", - "enum":[ - "ROLE_DOES_NOT_EXIST_OR_INVALID_TRUST_RELATIONSHIP", - "ROLE_DOES_NOT_HAVE_CORRECT_POLICY" - ] - }, - "InvalidCrossAccountRoleException":{ - "type":"structure", - "required":[ - "message", - "errorCode", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "errorCode":{ - "shape":"InvalidCrossAccountRoleErrorCode", - "documentation":"

Code that indicates the type of error that is generated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

Amazon Inspector cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.

", - "exception":true - }, - "InvalidInputErrorCode":{ - "type":"string", - "enum":[ - "INVALID_ASSESSMENT_TARGET_ARN", - "INVALID_ASSESSMENT_TEMPLATE_ARN", - "INVALID_ASSESSMENT_RUN_ARN", - "INVALID_FINDING_ARN", - "INVALID_RESOURCE_GROUP_ARN", - "INVALID_RULES_PACKAGE_ARN", - "INVALID_RESOURCE_ARN", - "INVALID_SNS_TOPIC_ARN", - "INVALID_IAM_ROLE_ARN", - "INVALID_ASSESSMENT_TARGET_NAME", - "INVALID_ASSESSMENT_TARGET_NAME_PATTERN", - "INVALID_ASSESSMENT_TEMPLATE_NAME", - "INVALID_ASSESSMENT_TEMPLATE_NAME_PATTERN", - "INVALID_ASSESSMENT_TEMPLATE_DURATION", - "INVALID_ASSESSMENT_TEMPLATE_DURATION_RANGE", - "INVALID_ASSESSMENT_RUN_DURATION_RANGE", - "INVALID_ASSESSMENT_RUN_START_TIME_RANGE", - "INVALID_ASSESSMENT_RUN_COMPLETION_TIME_RANGE", - "INVALID_ASSESSMENT_RUN_STATE_CHANGE_TIME_RANGE", - "INVALID_ASSESSMENT_RUN_STATE", - "INVALID_TAG", - "INVALID_TAG_KEY", - "INVALID_TAG_VALUE", - "INVALID_RESOURCE_GROUP_TAG_KEY", - "INVALID_RESOURCE_GROUP_TAG_VALUE", - "INVALID_ATTRIBUTE", - "INVALID_USER_ATTRIBUTE", - "INVALID_USER_ATTRIBUTE_KEY", - "INVALID_USER_ATTRIBUTE_VALUE", - "INVALID_PAGINATION_TOKEN", - "INVALID_MAX_RESULTS", - "INVALID_AGENT_ID", - "INVALID_AUTO_SCALING_GROUP", - "INVALID_RULE_NAME", - "INVALID_SEVERITY", - "INVALID_LOCALE", - "INVALID_EVENT", - "ASSESSMENT_TARGET_NAME_ALREADY_TAKEN", - "ASSESSMENT_TEMPLATE_NAME_ALREADY_TAKEN", - "INVALID_NUMBER_OF_ASSESSMENT_TARGET_ARNS", - "INVALID_NUMBER_OF_ASSESSMENT_TEMPLATE_ARNS", - "INVALID_NUMBER_OF_ASSESSMENT_RUN_ARNS", - "INVALID_NUMBER_OF_FINDING_ARNS", - "INVALID_NUMBER_OF_RESOURCE_GROUP_ARNS", - "INVALID_NUMBER_OF_RULES_PACKAGE_ARNS", - "INVALID_NUMBER_OF_ASSESSMENT_RUN_STATES", - "INVALID_NUMBER_OF_TAGS", - "INVALID_NUMBER_OF_RESOURCE_GROUP_TAGS", - "INVALID_NUMBER_OF_ATTRIBUTES", - "INVALID_NUMBER_OF_USER_ATTRIBUTES", - "INVALID_NUMBER_OF_AGENT_IDS", - "INVALID_NUMBER_OF_AUTO_SCALING_GROUPS", - "INVALID_NUMBER_OF_RULE_NAMES", - "INVALID_NUMBER_OF_SEVERITIES" - ] - }, - "InvalidInputException":{ - "type":"structure", - "required":[ - "message", - "errorCode", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "errorCode":{ - "shape":"InvalidInputErrorCode", - "documentation":"

Code that indicates the type of error that is generated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

", - "exception":true - }, - "IocConfidence":{ - "type":"integer", - "max":10, - "min":0 - }, - "Ipv4Address":{ - "type":"string", - "max":15, - "min":7 - }, - "Ipv4AddressList":{ - "type":"list", - "member":{"shape":"Ipv4Address"}, - "max":50, - "min":0 - }, - "KernelVersion":{ - "type":"string", - "max":128, - "min":1 - }, - "LimitExceededErrorCode":{ - "type":"string", - "enum":[ - "ASSESSMENT_TARGET_LIMIT_EXCEEDED", - "ASSESSMENT_TEMPLATE_LIMIT_EXCEEDED", - "ASSESSMENT_RUN_LIMIT_EXCEEDED", - "RESOURCE_GROUP_LIMIT_EXCEEDED", - "EVENT_SUBSCRIPTION_LIMIT_EXCEEDED" - ] - }, - "LimitExceededException":{ - "type":"structure", - "required":[ - "message", - "errorCode", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "errorCode":{ - "shape":"LimitExceededErrorCode", - "documentation":"

Code that indicates the type of error that is generated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

", - "exception":true - }, - "ListAssessmentRunAgentsRequest":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment run whose agents you want to list.

" - }, - "filter":{ - "shape":"AgentFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentRunAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentRunAgentsResponse":{ - "type":"structure", - "required":["assessmentRunAgents"], - "members":{ - "assessmentRunAgents":{ - "shape":"AssessmentRunAgentList", - "documentation":"

A list of ARNs that specifies the agents returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListAssessmentRunsRequest":{ - "type":"structure", - "members":{ - "assessmentTemplateArns":{ - "shape":"ListParentArnList", - "documentation":"

The ARNs that specify the assessment templates whose assessment runs you want to list.

" - }, - "filter":{ - "shape":"AssessmentRunFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentRuns action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentRunsResponse":{ - "type":"structure", - "required":["assessmentRunArns"], - "members":{ - "assessmentRunArns":{ - "shape":"ListReturnedArnList", - "documentation":"

A list of ARNs that specifies the assessment runs that are returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListAssessmentTargetsRequest":{ - "type":"structure", - "members":{ - "filter":{ - "shape":"AssessmentTargetFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentTargets action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentTargetsResponse":{ - "type":"structure", - "required":["assessmentTargetArns"], - "members":{ - "assessmentTargetArns":{ - "shape":"ListReturnedArnList", - "documentation":"

A list of ARNs that specifies the assessment targets that are returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListAssessmentTemplatesRequest":{ - "type":"structure", - "members":{ - "assessmentTargetArns":{ - "shape":"ListParentArnList", - "documentation":"

A list of ARNs that specifies the assessment targets whose assessment templates you want to list.

" - }, - "filter":{ - "shape":"AssessmentTemplateFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentTemplates action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListAssessmentTemplatesResponse":{ - "type":"structure", - "required":["assessmentTemplateArns"], - "members":{ - "assessmentTemplateArns":{ - "shape":"ListReturnedArnList", - "documentation":"

A list of ARNs that specifies the assessment templates returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListEventSubscriptionsMaxResults":{"type":"integer"}, - "ListEventSubscriptionsRequest":{ - "type":"structure", - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template for which you want to list the existing event subscriptions.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListEventSubscriptions action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListEventSubscriptionsMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListEventSubscriptionsResponse":{ - "type":"structure", - "required":["subscriptions"], - "members":{ - "subscriptions":{ - "shape":"SubscriptionList", - "documentation":"

Details of the returned event subscriptions.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListExclusionsRequest":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that generated the exclusions that you want to list.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListExclusionsRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.

" - } - } - }, - "ListExclusionsResponse":{ - "type":"structure", - "required":["exclusionArns"], - "members":{ - "exclusionArns":{ - "shape":"ListReturnedArnList", - "documentation":"

A list of exclusions' ARNs returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListFindingsRequest":{ - "type":"structure", - "members":{ - "assessmentRunArns":{ - "shape":"ListParentArnList", - "documentation":"

The ARNs of the assessment runs that generate the findings that you want to list.

" - }, - "filter":{ - "shape":"FindingFilter", - "documentation":"

You can use this parameter to specify a subset of data to be included in the action's response.

For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListFindings action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListFindingsResponse":{ - "type":"structure", - "required":["findingArns"], - "members":{ - "findingArns":{ - "shape":"ListReturnedArnList", - "documentation":"

A list of ARNs that specifies the findings returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListMaxResults":{"type":"integer"}, - "ListParentArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":50, - "min":0 - }, - "ListReturnedArnList":{ - "type":"list", - "member":{"shape":"Arn"}, - "max":100, - "min":0 - }, - "ListRulesPackagesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListRulesPackages action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"ListMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "ListRulesPackagesResponse":{ - "type":"structure", - "required":["rulesPackageArns"], - "members":{ - "rulesPackageArns":{ - "shape":"ListReturnedArnList", - "documentation":"

The list of ARNs that specifies the rules packages returned by the action.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN that specifies the assessment template whose tags you want to list.

" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "required":["tags"], - "members":{ - "tags":{ - "shape":"TagList", - "documentation":"

A collection of key and value pairs.

" - } - } - }, - "Locale":{ - "type":"string", - "enum":["EN_US"] - }, - "Long":{"type":"long"}, - "Message":{ - "type":"string", - "max":1000, - "min":0 - }, - "MessageType":{ - "type":"string", - "max":300, - "min":1 - }, - "NamePattern":{ - "type":"string", - "max":140, - "min":1 - }, - "NoSuchEntityErrorCode":{ - "type":"string", - "enum":[ - "ASSESSMENT_TARGET_DOES_NOT_EXIST", - "ASSESSMENT_TEMPLATE_DOES_NOT_EXIST", - "ASSESSMENT_RUN_DOES_NOT_EXIST", - "FINDING_DOES_NOT_EXIST", - "RESOURCE_GROUP_DOES_NOT_EXIST", - "RULES_PACKAGE_DOES_NOT_EXIST", - "SNS_TOPIC_DOES_NOT_EXIST", - "IAM_ROLE_DOES_NOT_EXIST" - ] - }, - "NoSuchEntityException":{ - "type":"structure", - "required":[ - "message", - "errorCode", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "errorCode":{ - "shape":"NoSuchEntityErrorCode", - "documentation":"

Code that indicates the type of error that is generated.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can immediately retry your request.

" - } - }, - "documentation":"

The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

", - "exception":true - }, - "NumericSeverity":{ - "type":"double", - "max":10.0, - "min":0.0 - }, - "NumericVersion":{ - "type":"integer", - "min":0 - }, - "OperatingSystem":{ - "type":"string", - "max":256, - "min":1 - }, - "PaginationToken":{ - "type":"string", - "max":300, - "min":1 - }, - "PreviewAgentsMaxResults":{"type":"integer"}, - "PreviewAgentsRequest":{ - "type":"structure", - "required":["previewAgentsArn"], - "members":{ - "previewAgentsArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment target whose agents you want to preview.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the PreviewAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"PreviewAgentsMaxResults", - "documentation":"

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.

" - } - } - }, - "PreviewAgentsResponse":{ - "type":"structure", - "required":["agentPreviews"], - "members":{ - "agentPreviews":{ - "shape":"AgentPreviewList", - "documentation":"

The resulting list of agents.

" - }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "PreviewGenerationInProgressException":{ - "type":"structure", - "required":["message"], - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request is rejected. The specified assessment template is currently generating an exclusions preview.

", - "exception":true - }, - "PreviewStatus":{ - "type":"string", - "enum":[ - "WORK_IN_PROGRESS", - "COMPLETED" - ] - }, - "ProviderName":{ - "type":"string", - "max":1000, - "min":0 - }, - "RegisterCrossAccountAccessRoleRequest":{ - "type":"structure", - "required":["roleArn"], - "members":{ - "roleArn":{ - "shape":"Arn", - "documentation":"

The ARN of the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.

" - } - } - }, - "RemoveAttributesFromFindingsRequest":{ - "type":"structure", - "required":[ - "findingArns", - "attributeKeys" - ], - "members":{ - "findingArns":{ - "shape":"AddRemoveAttributesFindingArnList", - "documentation":"

The ARNs that specify the findings that you want to remove attributes from.

" - }, - "attributeKeys":{ - "shape":"UserAttributeKeyList", - "documentation":"

The array of attribute keys that you want to remove from specified findings.

" - } - } - }, - "RemoveAttributesFromFindingsResponse":{ - "type":"structure", - "required":["failedItems"], - "members":{ - "failedItems":{ - "shape":"FailedItems", - "documentation":"

Attributes details that cannot be described. An error code is provided for each failed item.

" - } - } - }, - "ReportFileFormat":{ - "type":"string", - "enum":[ - "HTML", - "PDF" - ] - }, - "ReportStatus":{ - "type":"string", - "enum":[ - "WORK_IN_PROGRESS", - "FAILED", - "COMPLETED" - ] - }, - "ReportType":{ - "type":"string", - "enum":[ - "FINDING", - "FULL" - ] - }, - "ResourceGroup":{ - "type":"structure", - "required":[ - "arn", - "tags", - "createdAt" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource group.

" - }, - "tags":{ - "shape":"ResourceGroupTags", - "documentation":"

The tags (key and value pairs) of the resource group. This data type property is used in the CreateResourceGroup action.

" - }, - "createdAt":{ - "shape":"Timestamp", - "documentation":"

The time at which resource group is created.

" - } - }, - "documentation":"

Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that make up the assessment target. This data type is used as the response element in the DescribeResourceGroups action.

" - }, - "ResourceGroupList":{ - "type":"list", - "member":{"shape":"ResourceGroup"}, - "max":10, - "min":0 - }, - "ResourceGroupTag":{ - "type":"structure", - "required":["key"], - "members":{ - "key":{ - "shape":"TagKey", - "documentation":"

A tag key.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

The value assigned to a tag key.

" - } - }, - "documentation":"

This data type is used as one of the elements of the ResourceGroup data type.

" - }, - "ResourceGroupTags":{ - "type":"list", - "member":{"shape":"ResourceGroupTag"}, - "max":10, - "min":1 - }, - "RuleName":{ - "type":"string", - "max":1000 - }, - "RuleNameList":{ - "type":"list", - "member":{"shape":"RuleName"}, - "max":50, - "min":0 - }, - "RulesPackage":{ - "type":"structure", - "required":[ - "arn", - "name", - "version", - "provider" - ], - "members":{ - "arn":{ - "shape":"Arn", - "documentation":"

The ARN of the rules package.

" - }, - "name":{ - "shape":"RulesPackageName", - "documentation":"

The name of the rules package.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version ID of the rules package.

" - }, - "provider":{ - "shape":"ProviderName", - "documentation":"

The provider of the rules package.

" - }, - "description":{ - "shape":"Text", - "documentation":"

The description of the rules package.

" - } - }, - "documentation":"

Contains information about an Amazon Inspector rules package. This data type is used as the response element in the DescribeRulesPackages action.

" - }, - "RulesPackageList":{ - "type":"list", - "member":{"shape":"RulesPackage"}, - "max":10, - "min":0 - }, - "RulesPackageName":{ - "type":"string", - "max":1000, - "min":0 - }, - "Scope":{ - "type":"structure", - "members":{ - "key":{ - "shape":"ScopeType", - "documentation":"

The type of the scope.

" - }, - "value":{ - "shape":"ScopeValue", - "documentation":"

The resource identifier for the specified scope type.

" - } - }, - "documentation":"

This data type contains key-value pairs that identify various Amazon resources.

" - }, - "ScopeList":{ - "type":"list", - "member":{"shape":"Scope"}, - "min":1 - }, - "ScopeType":{ - "type":"string", - "enum":[ - "INSTANCE_ID", - "RULES_PACKAGE_ARN" - ] - }, - "ScopeValue":{"type":"string"}, - "ServiceName":{ - "type":"string", - "max":128, - "min":0 - }, - "ServiceTemporarilyUnavailableException":{ - "type":"structure", - "required":[ - "message", - "canRetry" - ], - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Details of the exception error.

" - }, - "canRetry":{ - "shape":"Bool", - "documentation":"

You can wait and then retry your request.

" - } - }, - "documentation":"

The serice is temporary unavailable.

", - "exception":true - }, - "SetTagsForResourceRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template that you want to set tags to.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

A collection of key and value pairs that you want to set to the assessment template.

" - } - } - }, - "Severity":{ - "type":"string", - "enum":[ - "Low", - "Medium", - "High", - "Informational", - "Undefined" - ] - }, - "SeverityList":{ - "type":"list", - "member":{"shape":"Severity"}, - "max":50, - "min":0 - }, - "StartAssessmentRunRequest":{ - "type":"structure", - "required":["assessmentTemplateArn"], - "members":{ - "assessmentTemplateArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template of the assessment run that you want to start.

" - }, - "assessmentRunName":{ - "shape":"AssessmentRunName", - "documentation":"

You can specify the name for the assessment run. The name must be unique for the assessment template whose ARN is used to start the assessment run.

" - } - } - }, - "StartAssessmentRunResponse":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that has been started.

" - } - } - }, - "StopAction":{ - "type":"string", - "enum":[ - "START_EVALUATION", - "SKIP_EVALUATION" - ] - }, - "StopAssessmentRunRequest":{ - "type":"structure", - "required":["assessmentRunArn"], - "members":{ - "assessmentRunArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment run that you want to stop.

" - }, - "stopAction":{ - "shape":"StopAction", - "documentation":"

An input option that can be set to either START_EVALUATION or SKIP_EVALUATION. START_EVALUATION (the default value), stops the AWS agent from collecting data and begins the results evaluation and the findings generation process. SKIP_EVALUATION cancels the assessment run immediately, after which no findings are generated.

" - } - } - }, - "SubscribeToEventRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "event", - "topicArn" - ], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template that is used during the event for which you want to receive SNS notifications.

" - }, - "event":{ - "shape":"InspectorEvent", - "documentation":"

The event for which you want to receive SNS notifications.

" - }, - "topicArn":{ - "shape":"Arn", - "documentation":"

The ARN of the SNS topic to which the SNS notifications are sent.

" - } - } - }, - "Subscription":{ - "type":"structure", - "required":[ - "resourceArn", - "topicArn", - "eventSubscriptions" - ], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template that is used during the event for which the SNS notification is sent.

" - }, - "topicArn":{ - "shape":"Arn", - "documentation":"

The ARN of the Amazon Simple Notification Service (SNS) topic to which the SNS notifications are sent.

" - }, - "eventSubscriptions":{ - "shape":"EventSubscriptionList", - "documentation":"

The list of existing event subscriptions.

" - } - }, - "documentation":"

This data type is used as a response element in the ListEventSubscriptions action.

" - }, - "SubscriptionList":{ - "type":"list", - "member":{"shape":"Subscription"}, - "max":50, - "min":0 - }, - "Tag":{ - "type":"structure", - "required":["key"], - "members":{ - "key":{ - "shape":"TagKey", - "documentation":"

A tag key.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

A value assigned to a tag key.

" - } - }, - "documentation":"

A key and value pair. This data type is used as a request parameter in the SetTagsForResource action and a response element in the ListTagsForResource action.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":10, - "min":0 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1 - }, - "TelemetryMetadata":{ - "type":"structure", - "required":[ - "messageType", - "count" - ], - "members":{ - "messageType":{ - "shape":"MessageType", - "documentation":"

A specific type of behavioral data that is collected by the agent.

" - }, - "count":{ - "shape":"Long", - "documentation":"

The count of messages that the agent sends to the Amazon Inspector service.

" - }, - "dataSize":{ - "shape":"Long", - "documentation":"

The data size of messages that the agent sends to the Amazon Inspector service.

" - } - }, - "documentation":"

The metadata about the Amazon Inspector application data metrics collected by the agent. This data type is used as the response element in the GetTelemetryMetadata action.

" - }, - "TelemetryMetadataList":{ - "type":"list", - "member":{"shape":"TelemetryMetadata"}, - "max":5000, - "min":0 - }, - "Text":{ - "type":"string", - "max":20000, - "min":0 - }, - "Timestamp":{"type":"timestamp"}, - "TimestampRange":{ - "type":"structure", - "members":{ - "beginDate":{ - "shape":"Timestamp", - "documentation":"

The minimum value of the timestamp range.

" - }, - "endDate":{ - "shape":"Timestamp", - "documentation":"

The maximum value of the timestamp range.

" - } - }, - "documentation":"

This data type is used in the AssessmentRunFilter data type.

" - }, - "UUID":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "UnsubscribeFromEventRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "event", - "topicArn" - ], - "members":{ - "resourceArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment template that is used during the event for which you want to stop receiving SNS notifications.

" - }, - "event":{ - "shape":"InspectorEvent", - "documentation":"

The event for which you want to stop receiving SNS notifications.

" - }, - "topicArn":{ - "shape":"Arn", - "documentation":"

The ARN of the SNS topic to which SNS notifications are sent.

" - } - } - }, - "UnsupportedFeatureException":{ - "type":"structure", - "required":[ - "message", - "canRetry" - ], - "members":{ - "message":{"shape":"ErrorMessage"}, - "canRetry":{"shape":"Bool"} - }, - "documentation":"

Used by the GetAssessmentReport API. The request was rejected because you tried to generate a report for an assessment run that existed before reporting was supported in Amazon Inspector. You can only generate reports for assessment runs that took place or will take place after generating reports in Amazon Inspector became available.

", - "exception":true - }, - "UpdateAssessmentTargetRequest":{ - "type":"structure", - "required":[ - "assessmentTargetArn", - "assessmentTargetName" - ], - "members":{ - "assessmentTargetArn":{ - "shape":"Arn", - "documentation":"

The ARN of the assessment target that you want to update.

" - }, - "assessmentTargetName":{ - "shape":"AssessmentTargetName", - "documentation":"

The name of the assessment target that you want to update.

" - }, - "resourceGroupArn":{ - "shape":"Arn", - "documentation":"

The ARN of the resource group that is used to specify the new resource group to associate with the assessment target.

" - } - } - }, - "Url":{ - "type":"string", - "max":2048 - }, - "UserAttributeKeyList":{ - "type":"list", - "member":{"shape":"AttributeKey"}, - "max":10, - "min":0 - }, - "UserAttributeList":{ - "type":"list", - "member":{"shape":"Attribute"}, - "max":10, - "min":0 - }, - "Version":{ - "type":"string", - "max":1000, - "min":0 - } - }, - "documentation":"Amazon Inspector

Amazon Inspector enables you to analyze the behavior of your AWS resources and to identify potential security issues. For more information, see Amazon Inspector User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-data/2015-05-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-data/2015-05-28/service-2.json deleted file mode 100644 index 88fba6cd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-data/2015-05-28/service-2.json +++ /dev/null @@ -1,337 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"iot-data-2015-05-28", - "apiVersion":"2015-05-28", - "endpointPrefix":"data.iot", - "protocol":"rest-json", - "serviceFullName":"AWS IoT Data Plane", - "serviceId":"IoT Data Plane", - "signatureVersion":"v4", - "signingName":"iotdata" - }, - "operations":{ - "DeleteThingShadow":{ - "name":"DeleteThingShadow", - "http":{ - "method":"DELETE", - "requestUri":"/things/{thingName}/shadow" - }, - "input":{"shape":"DeleteThingShadowRequest"}, - "output":{"shape":"DeleteThingShadowResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"UnsupportedDocumentEncodingException"} - ], - "documentation":"

Deletes the thing shadow for the specified thing.

For more information, see DeleteThingShadow in the AWS IoT Developer Guide.

" - }, - "GetThingShadow":{ - "name":"GetThingShadow", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/shadow" - }, - "input":{"shape":"GetThingShadowRequest"}, - "output":{"shape":"GetThingShadowResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"UnsupportedDocumentEncodingException"} - ], - "documentation":"

Gets the thing shadow for the specified thing.

For more information, see GetThingShadow in the AWS IoT Developer Guide.

" - }, - "Publish":{ - "name":"Publish", - "http":{ - "method":"POST", - "requestUri":"/topics/{topic}" - }, - "input":{"shape":"PublishRequest"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"MethodNotAllowedException"} - ], - "documentation":"

Publishes state information.

For more information, see HTTP Protocol in the AWS IoT Developer Guide.

" - }, - "UpdateThingShadow":{ - "name":"UpdateThingShadow", - "http":{ - "method":"POST", - "requestUri":"/things/{thingName}/shadow" - }, - "input":{"shape":"UpdateThingShadowRequest"}, - "output":{"shape":"UpdateThingShadowResponse"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"RequestEntityTooLargeException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"UnsupportedDocumentEncodingException"} - ], - "documentation":"

Updates the thing shadow for the specified thing.

For more information, see UpdateThingShadow in the AWS IoT Developer Guide.

" - } - }, - "shapes":{ - "ConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The specified version does not match the version of the document.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DeleteThingShadowRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - } - }, - "documentation":"

The input for the DeleteThingShadow operation.

" - }, - "DeleteThingShadowResponse":{ - "type":"structure", - "required":["payload"], - "members":{ - "payload":{ - "shape":"JsonDocument", - "documentation":"

The state information, in JSON format.

" - } - }, - "documentation":"

The output from the DeleteThingShadow operation.

", - "payload":"payload" - }, - "ErrorMessage":{"type":"string"}, - "GetThingShadowRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - } - }, - "documentation":"

The input for the GetThingShadow operation.

" - }, - "GetThingShadowResponse":{ - "type":"structure", - "members":{ - "payload":{ - "shape":"JsonDocument", - "documentation":"

The state information, in JSON format.

" - } - }, - "documentation":"

The output from the GetThingShadow operation.

", - "payload":"payload" - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

An unexpected error has occurred.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The request is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "JsonDocument":{"type":"blob"}, - "MethodNotAllowedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The specified combination of HTTP verb and URI is not supported.

", - "error":{"httpStatusCode":405}, - "exception":true - }, - "Payload":{"type":"blob"}, - "PublishRequest":{ - "type":"structure", - "required":["topic"], - "members":{ - "topic":{ - "shape":"Topic", - "documentation":"

The name of the MQTT topic.

", - "location":"uri", - "locationName":"topic" - }, - "qos":{ - "shape":"Qos", - "documentation":"

The Quality of Service (QoS) level.

", - "location":"querystring", - "locationName":"qos" - }, - "payload":{ - "shape":"Payload", - "documentation":"

The state information, in JSON format.

" - } - }, - "documentation":"

The input for the Publish operation.

", - "payload":"payload" - }, - "Qos":{ - "type":"integer", - "max":1, - "min":0 - }, - "RequestEntityTooLargeException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The payload exceeds the maximum size allowed.

", - "error":{"httpStatusCode":413}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The specified resource does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The service is temporarily unavailable.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "ThingName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The rate exceeds the limit.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "Topic":{"type":"string"}, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

You are not authorized to perform this operation.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UnsupportedDocumentEncodingException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The document encoding is not supported.

", - "error":{"httpStatusCode":415}, - "exception":true - }, - "UpdateThingShadowRequest":{ - "type":"structure", - "required":[ - "thingName", - "payload" - ], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - }, - "payload":{ - "shape":"JsonDocument", - "documentation":"

The state information, in JSON format.

" - } - }, - "documentation":"

The input for the UpdateThingShadow operation.

", - "payload":"payload" - }, - "UpdateThingShadowResponse":{ - "type":"structure", - "members":{ - "payload":{ - "shape":"JsonDocument", - "documentation":"

The state information, in JSON format.

" - } - }, - "documentation":"

The output from the UpdateThingShadow operation.

", - "payload":"payload" - }, - "errorMessage":{"type":"string"} - }, - "documentation":"AWS IoT

AWS IoT-Data enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the AWS cloud. It implements a broker for applications and things to publish messages over HTTP (Publish) and retrieve, update, and delete thing shadows. A thing shadow is a persistent representation of your things and their state in the AWS cloud.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/service-2.json deleted file mode 100644 index 8fb28a2b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot-jobs-data/2017-09-29/service-2.json +++ /dev/null @@ -1,474 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-29", - "endpointPrefix":"data.jobs.iot", - "protocol":"rest-json", - "serviceFullName":"AWS IoT Jobs Data Plane", - "serviceId":"IoT Jobs Data Plane", - "signatureVersion":"v4", - "signingName":"iot-jobs-data", - "uid":"iot-jobs-data-2017-09-29" - }, - "operations":{ - "DescribeJobExecution":{ - "name":"DescribeJobExecution", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/jobs/{jobId}" - }, - "input":{"shape":"DescribeJobExecutionRequest"}, - "output":{"shape":"DescribeJobExecutionResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"CertificateValidationException"}, - {"shape":"TerminalStateException"} - ], - "documentation":"

Gets details of a job execution.

" - }, - "GetPendingJobExecutions":{ - "name":"GetPendingJobExecutions", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/jobs" - }, - "input":{"shape":"GetPendingJobExecutionsRequest"}, - "output":{"shape":"GetPendingJobExecutionsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"CertificateValidationException"} - ], - "documentation":"

Gets the list of all jobs for a thing that are not in a terminal status.

" - }, - "StartNextPendingJobExecution":{ - "name":"StartNextPendingJobExecution", - "http":{ - "method":"PUT", - "requestUri":"/things/{thingName}/jobs/$next" - }, - "input":{"shape":"StartNextPendingJobExecutionRequest"}, - "output":{"shape":"StartNextPendingJobExecutionResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"CertificateValidationException"} - ], - "documentation":"

Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing.

" - }, - "UpdateJobExecution":{ - "name":"UpdateJobExecution", - "http":{ - "method":"POST", - "requestUri":"/things/{thingName}/jobs/{jobId}" - }, - "input":{"shape":"UpdateJobExecutionRequest"}, - "output":{"shape":"UpdateJobExecutionResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"CertificateValidationException"}, - {"shape":"InvalidStateTransitionException"} - ], - "documentation":"

Updates the status of a job execution.

" - } - }, - "shapes":{ - "CertificateValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Additional information about the exception.

" - } - }, - "documentation":"

The certificate is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "DescribeJobExecutionJobId":{ - "type":"string", - "pattern":"[a-zA-Z0-9_-]+|^\\$next" - }, - "DescribeJobExecutionRequest":{ - "type":"structure", - "required":[ - "jobId", - "thingName" - ], - "members":{ - "jobId":{ - "shape":"DescribeJobExecutionJobId", - "documentation":"

The unique identifier assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing name associated with the device the job execution is running on.

", - "location":"uri", - "locationName":"thingName" - }, - "includeJobDocument":{ - "shape":"IncludeJobDocument", - "documentation":"

Optional. When set to true, the response contains the job document. The default is false.

", - "location":"querystring", - "locationName":"includeJobDocument" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

Optional. A number that identifies a particular job execution on a particular device. If not specified, the latest job execution is returned.

", - "location":"querystring", - "locationName":"executionNumber" - } - } - }, - "DescribeJobExecutionResponse":{ - "type":"structure", - "members":{ - "execution":{ - "shape":"JobExecution", - "documentation":"

Contains data about a job execution.

" - } - } - }, - "DetailsKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "DetailsMap":{ - "type":"map", - "key":{"shape":"DetailsKey"}, - "value":{"shape":"DetailsValue"} - }, - "DetailsValue":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[^\\p{C}]*+" - }, - "ExecutionNumber":{"type":"long"}, - "ExpectedVersion":{"type":"long"}, - "GetPendingJobExecutionsRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing that is executing the job.

", - "location":"uri", - "locationName":"thingName" - } - } - }, - "GetPendingJobExecutionsResponse":{ - "type":"structure", - "members":{ - "inProgressJobs":{ - "shape":"JobExecutionSummaryList", - "documentation":"

A list of JobExecutionSummary objects with status IN_PROGRESS.

" - }, - "queuedJobs":{ - "shape":"JobExecutionSummaryList", - "documentation":"

A list of JobExecutionSummary objects with status QUEUED.

" - } - } - }, - "IncludeExecutionState":{"type":"boolean"}, - "IncludeJobDocument":{"type":"boolean"}, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The contents of the request were invalid. For example, this code is returned when an UpdateJobExecution request contains invalid status details. The message contains details about the error.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidStateTransitionException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

An update attempted to change the job execution to a state that is invalid because of the job execution's current state (for example, an attempt to change a request in state SUCCESS to state IN_PROGRESS). In this case, the body of the error message also contains the executionState field.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "JobDocument":{ - "type":"string", - "max":32768 - }, - "JobExecution":{ - "type":"structure", - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing that is executing the job.

" - }, - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The status of the job execution. Can be one of: \"QUEUED\", \"IN_PROGRESS\", \"FAILED\", \"SUCCESS\", \"CANCELED\", \"REJECTED\", or \"REMOVED\".

" - }, - "statusDetails":{ - "shape":"DetailsMap", - "documentation":"

A collection of name/value pairs that describe the status of the job execution.

" - }, - "queuedAt":{ - "shape":"QueuedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was enqueued.

" - }, - "startedAt":{ - "shape":"StartedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was started.

" - }, - "lastUpdatedAt":{ - "shape":"LastUpdatedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was last updated.

" - }, - "versionNumber":{ - "shape":"VersionNumber", - "documentation":"

The version of the job execution. Job execution versions are incremented each time they are updated by a device.

" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

A number that identifies a particular job execution on a particular device. It can be used later in commands that return or update job execution information.

" - }, - "jobDocument":{ - "shape":"JobDocument", - "documentation":"

The content of the job document.

" - } - }, - "documentation":"

Contains data about a job execution.

" - }, - "JobExecutionState":{ - "type":"structure", - "members":{ - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The status of the job execution. Can be one of: \"QUEUED\", \"IN_PROGRESS\", \"FAILED\", \"SUCCESS\", \"CANCELED\", \"REJECTED\", or \"REMOVED\".

" - }, - "statusDetails":{ - "shape":"DetailsMap", - "documentation":"

A collection of name/value pairs that describe the status of the job execution.

" - }, - "versionNumber":{ - "shape":"VersionNumber", - "documentation":"

The version of the job execution. Job execution versions are incremented each time they are updated by a device.

" - } - }, - "documentation":"

Contains data about the state of a job execution.

" - }, - "JobExecutionStatus":{ - "type":"string", - "enum":[ - "QUEUED", - "IN_PROGRESS", - "SUCCEEDED", - "FAILED", - "REJECTED", - "REMOVED", - "CANCELED" - ] - }, - "JobExecutionSummary":{ - "type":"structure", - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "queuedAt":{ - "shape":"QueuedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was enqueued.

" - }, - "startedAt":{ - "shape":"StartedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution started.

" - }, - "lastUpdatedAt":{ - "shape":"LastUpdatedAt", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was last updated.

" - }, - "versionNumber":{ - "shape":"VersionNumber", - "documentation":"

The version of the job execution. Job execution versions are incremented each time AWS IoT Jobs receives an update from a device.

" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

A number that identifies a particular job execution on a particular device.

" - } - }, - "documentation":"

Contains a subset of information about a job execution.

" - }, - "JobExecutionSummaryList":{ - "type":"list", - "member":{"shape":"JobExecutionSummary"} - }, - "JobId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "LastUpdatedAt":{"type":"long"}, - "QueuedAt":{"type":"long"}, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The specified resource does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The service is temporarily unavailable.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "StartNextPendingJobExecutionRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing associated with the device.

", - "location":"uri", - "locationName":"thingName" - }, - "statusDetails":{ - "shape":"DetailsMap", - "documentation":"

A collection of name/value pairs that describe the status of the job execution. If not specified, the statusDetails are unchanged.

" - } - } - }, - "StartNextPendingJobExecutionResponse":{ - "type":"structure", - "members":{ - "execution":{ - "shape":"JobExecution", - "documentation":"

A JobExecution object.

" - } - } - }, - "StartedAt":{"type":"long"}, - "TerminalStateException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The job is in a terminal state.

", - "error":{"httpStatusCode":410}, - "exception":true - }, - "ThingName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The rate exceeds the limit.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UpdateJobExecutionRequest":{ - "type":"structure", - "required":[ - "jobId", - "thingName", - "status" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing associated with the device.

", - "location":"uri", - "locationName":"thingName" - }, - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The new status for the job execution (IN_PROGRESS, FAILED, SUCCESS, or REJECTED). This must be specified on every update.

" - }, - "statusDetails":{ - "shape":"DetailsMap", - "documentation":"

Optional. A collection of name/value pairs that describe the status of the job execution. If not specified, the statusDetails are unchanged.

" - }, - "expectedVersion":{ - "shape":"ExpectedVersion", - "documentation":"

Optional. The expected current version of the job execution. Each time you update the job execution, its version is incremented. If the version of the job execution stored in Jobs does not match, the update is rejected with a VersionMismatch error, and an ErrorResponse that contains the current job execution status data is returned. (This makes it unnecessary to perform a separate DescribeJobExecution request in order to obtain the job execution status data.)

" - }, - "includeJobExecutionState":{ - "shape":"IncludeExecutionState", - "documentation":"

Optional. When included and set to true, the response contains the JobExecutionState data. The default is false.

" - }, - "includeJobDocument":{ - "shape":"IncludeJobDocument", - "documentation":"

Optional. When set to true, the response contains the job document. The default is false.

" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

Optional. A number that identifies a particular job execution on a particular device.

" - } - } - }, - "UpdateJobExecutionResponse":{ - "type":"structure", - "members":{ - "executionState":{ - "shape":"JobExecutionState", - "documentation":"

A JobExecutionState object.

" - }, - "jobDocument":{ - "shape":"JobDocument", - "documentation":"

The contents of the Job Documents.

" - } - } - }, - "VersionNumber":{"type":"long"}, - "errorMessage":{"type":"string"} - }, - "documentation":"

AWS IoT Jobs is a service that allows you to define a set of jobs — remote operations that are sent to and executed on one or more devices connected to AWS IoT. For example, you can define a job that instructs a set of devices to download and install application or firmware updates, reboot, rotate certificates, or perform remote troubleshooting operations.

To create a job, you make a job document which is a description of the remote operations to be performed, and you specify a list of targets that should perform the operations. The targets can be individual things, thing groups or both.

AWS IoT Jobs sends a message to inform the targets that a job is available. The target starts the execution of the job by downloading the job document, performing the operations it specifies, and reporting its progress to AWS IoT. The Jobs service provides commands to track the progress of a job on a specific target and for all the targets of the job

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/examples-1.json deleted file mode 100644 index faff7689..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version":"1.0", - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/paginators-1.json deleted file mode 100644 index cc1934b2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/paginators-1.json +++ /dev/null @@ -1,70 +0,0 @@ -{ - "pagination": { - "ListCACertificates": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "certificates" - }, - "ListCertificates": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "certificates" - }, - "ListCertificatesByCA": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "certificates" - }, - "ListOutgoingCertificates": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "outgoingCertificates" - }, - "ListPolicies": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "policies" - }, - "ListPolicyPrincipals": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "principals" - }, - "ListPrincipalPolicies": { - "input_token": "marker", - "output_token": "nextMarker", - "limit_key": "pageSize", - "result_key": "policies" - }, - "ListPrincipalThings": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "things" - }, - "ListThingTypes": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "thingTypes" - }, - "ListThings": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "things" - }, - "ListTopicRules": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "rules" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/service-2.json deleted file mode 100644 index ae7565de..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot/2015-05-28/service-2.json +++ /dev/null @@ -1,11066 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-05-28", - "endpointPrefix":"iot", - "protocol":"rest-json", - "serviceFullName":"AWS IoT", - "serviceId":"IoT", - "signatureVersion":"v4", - "signingName":"execute-api", - "uid":"iot-2015-05-28" - }, - "operations":{ - "AcceptCertificateTransfer":{ - "name":"AcceptCertificateTransfer", - "http":{ - "method":"PATCH", - "requestUri":"/accept-certificate-transfer/{certificateId}" - }, - "input":{"shape":"AcceptCertificateTransferRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"TransferAlreadyCompletedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Accepts a pending certificate transfer. The default state of the certificate is INACTIVE.

To check for pending certificate transfers, call ListCertificates to enumerate your certificates.

" - }, - "AddThingToThingGroup":{ - "name":"AddThingToThingGroup", - "http":{ - "method":"PUT", - "requestUri":"/thing-groups/addThingToThingGroup" - }, - "input":{"shape":"AddThingToThingGroupRequest"}, - "output":{"shape":"AddThingToThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Adds a thing to a thing group.

" - }, - "AssociateTargetsWithJob":{ - "name":"AssociateTargetsWithJob", - "http":{ - "method":"POST", - "requestUri":"/jobs/{jobId}/targets" - }, - "input":{"shape":"AssociateTargetsWithJobRequest"}, - "output":{"shape":"AssociateTargetsWithJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Associates a group with a continuous job. The following criteria must be met:

  • The job must have been created with the targetSelection field set to \"CONTINUOUS\".

  • The job status must currently be \"IN_PROGRESS\".

  • The total number of targets associated with a job must not exceed 100.

" - }, - "AttachPolicy":{ - "name":"AttachPolicy", - "http":{ - "method":"PUT", - "requestUri":"/target-policies/{policyName}" - }, - "input":{"shape":"AttachPolicyRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Attaches a policy to the specified target.

" - }, - "AttachPrincipalPolicy":{ - "name":"AttachPrincipalPolicy", - "http":{ - "method":"PUT", - "requestUri":"/principal-policies/{policyName}" - }, - "input":{"shape":"AttachPrincipalPolicyRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Attaches the specified policy to the specified principal (certificate or other credential).

Note: This API is deprecated. Please use AttachPolicy instead.

", - "deprecated":true - }, - "AttachSecurityProfile":{ - "name":"AttachSecurityProfile", - "http":{ - "method":"PUT", - "requestUri":"/security-profiles/{securityProfileName}/targets" - }, - "input":{"shape":"AttachSecurityProfileRequest"}, - "output":{"shape":"AttachSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"VersionConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Associates a Device Defender security profile with a thing group or with this account. Each thing group or account can have up to five security profiles associated with it.

" - }, - "AttachThingPrincipal":{ - "name":"AttachThingPrincipal", - "http":{ - "method":"PUT", - "requestUri":"/things/{thingName}/principals" - }, - "input":{"shape":"AttachThingPrincipalRequest"}, - "output":{"shape":"AttachThingPrincipalResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Attaches the specified principal to the specified thing.

" - }, - "CancelAuditTask":{ - "name":"CancelAuditTask", - "http":{ - "method":"PUT", - "requestUri":"/audit/tasks/{taskId}/cancel" - }, - "input":{"shape":"CancelAuditTaskRequest"}, - "output":{"shape":"CancelAuditTaskResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Cancels an audit that is in progress. The audit can be either scheduled or on-demand. If the audit is not in progress, an \"InvalidRequestException\" occurs.

" - }, - "CancelCertificateTransfer":{ - "name":"CancelCertificateTransfer", - "http":{ - "method":"PATCH", - "requestUri":"/cancel-certificate-transfer/{certificateId}" - }, - "input":{"shape":"CancelCertificateTransferRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"TransferAlreadyCompletedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Cancels a pending transfer for the specified certificate.

Note Only the transfer source account can use this operation to cancel a transfer. (Transfer destinations can use RejectCertificateTransfer instead.) After transfer, AWS IoT returns the certificate to the source account in the INACTIVE state. After the destination account has accepted the transfer, the transfer cannot be cancelled.

After a certificate transfer is cancelled, the status of the certificate changes from PENDING_TRANSFER to INACTIVE.

" - }, - "CancelJob":{ - "name":"CancelJob", - "http":{ - "method":"PUT", - "requestUri":"/jobs/{jobId}/cancel" - }, - "input":{"shape":"CancelJobRequest"}, - "output":{"shape":"CancelJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Cancels a job.

" - }, - "CancelJobExecution":{ - "name":"CancelJobExecution", - "http":{ - "method":"PUT", - "requestUri":"/things/{thingName}/jobs/{jobId}/cancel" - }, - "input":{"shape":"CancelJobExecutionRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidStateTransitionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"VersionConflictException"} - ], - "documentation":"

Cancels the execution of a job for a given thing.

" - }, - "ClearDefaultAuthorizer":{ - "name":"ClearDefaultAuthorizer", - "http":{ - "method":"DELETE", - "requestUri":"/default-authorizer" - }, - "input":{"shape":"ClearDefaultAuthorizerRequest"}, - "output":{"shape":"ClearDefaultAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Clears the default authorizer.

" - }, - "CreateAuthorizer":{ - "name":"CreateAuthorizer", - "http":{ - "method":"POST", - "requestUri":"/authorizer/{authorizerName}" - }, - "input":{"shape":"CreateAuthorizerRequest"}, - "output":{"shape":"CreateAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates an authorizer.

" - }, - "CreateCertificateFromCsr":{ - "name":"CreateCertificateFromCsr", - "http":{ - "method":"POST", - "requestUri":"/certificates" - }, - "input":{"shape":"CreateCertificateFromCsrRequest"}, - "output":{"shape":"CreateCertificateFromCsrResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates an X.509 certificate using the specified certificate signing request.

Note: The CSR must include a public key that is either an RSA key with a length of at least 2048 bits or an ECC key from NIST P-256 or NIST P-384 curves.

Note: Reusing the same certificate signing request (CSR) results in a distinct certificate.

You can create multiple certificates in a batch by creating a directory, copying multiple .csr files into that directory, and then specifying that directory on the command line. The following commands show how to create a batch of certificates given a batch of CSRs.

Assuming a set of CSRs are located inside of the directory my-csr-directory:

On Linux and OS X, the command is:

$ ls my-csr-directory/ | xargs -I {} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{}

This command lists all of the CSRs in my-csr-directory and pipes each CSR file name to the aws iot create-certificate-from-csr AWS CLI command to create a certificate for the corresponding CSR.

The aws iot create-certificate-from-csr part of the command can also be run in parallel to speed up the certificate creation process:

$ ls my-csr-directory/ | xargs -P 10 -I {} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{}

On Windows PowerShell, the command to create certificates for all CSRs in my-csr-directory is:

> ls -Name my-csr-directory | %{aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/$_}

On a Windows command prompt, the command to create certificates for all CSRs in my-csr-directory is:

> forfiles /p my-csr-directory /c \"cmd /c aws iot create-certificate-from-csr --certificate-signing-request file://@path\"

" - }, - "CreateJob":{ - "name":"CreateJob", - "http":{ - "method":"PUT", - "requestUri":"/jobs/{jobId}" - }, - "input":{"shape":"CreateJobRequest"}, - "output":{"shape":"CreateJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a job.

" - }, - "CreateKeysAndCertificate":{ - "name":"CreateKeysAndCertificate", - "http":{ - "method":"POST", - "requestUri":"/keys-and-certificate" - }, - "input":{"shape":"CreateKeysAndCertificateRequest"}, - "output":{"shape":"CreateKeysAndCertificateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a 2048-bit RSA key pair and issues an X.509 certificate using the issued public key.

Note This is the only time AWS IoT issues the private key for this certificate, so it is important to keep it in a secure location.

" - }, - "CreateOTAUpdate":{ - "name":"CreateOTAUpdate", - "http":{ - "method":"POST", - "requestUri":"/otaUpdates/{otaUpdateId}" - }, - "input":{"shape":"CreateOTAUpdateRequest"}, - "output":{"shape":"CreateOTAUpdateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates an AWS IoT OTAUpdate on a target group of things or groups.

" - }, - "CreatePolicy":{ - "name":"CreatePolicy", - "http":{ - "method":"POST", - "requestUri":"/policies/{policyName}" - }, - "input":{"shape":"CreatePolicyRequest"}, - "output":{"shape":"CreatePolicyResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"MalformedPolicyException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates an AWS IoT policy.

The created policy is the default version for the policy. This operation creates a policy version with a version identifier of 1 and sets 1 as the policy's default version.

" - }, - "CreatePolicyVersion":{ - "name":"CreatePolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/policies/{policyName}/version" - }, - "input":{"shape":"CreatePolicyVersionRequest"}, - "output":{"shape":"CreatePolicyVersionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"MalformedPolicyException"}, - {"shape":"VersionsLimitExceededException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a new version of the specified AWS IoT policy. To update a policy, create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must use DeletePolicyVersion to delete an existing version before you create a new one.

Optionally, you can set the new version as the policy's default version. The default version is the operative version (that is, the version that is in effect for the certificates to which the policy is attached).

" - }, - "CreateRoleAlias":{ - "name":"CreateRoleAlias", - "http":{ - "method":"POST", - "requestUri":"/role-aliases/{roleAlias}" - }, - "input":{"shape":"CreateRoleAliasRequest"}, - "output":{"shape":"CreateRoleAliasResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a role alias.

" - }, - "CreateScheduledAudit":{ - "name":"CreateScheduledAudit", - "http":{ - "method":"POST", - "requestUri":"/audit/scheduledaudits/{scheduledAuditName}" - }, - "input":{"shape":"CreateScheduledAuditRequest"}, - "output":{"shape":"CreateScheduledAuditResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a scheduled audit that is run at a specified time interval.

" - }, - "CreateSecurityProfile":{ - "name":"CreateSecurityProfile", - "http":{ - "method":"POST", - "requestUri":"/security-profiles/{securityProfileName}" - }, - "input":{"shape":"CreateSecurityProfileRequest"}, - "output":{"shape":"CreateSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a Device Defender security profile.

" - }, - "CreateStream":{ - "name":"CreateStream", - "http":{ - "method":"POST", - "requestUri":"/streams/{streamId}" - }, - "input":{"shape":"CreateStreamRequest"}, - "output":{"shape":"CreateStreamResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a stream for delivering one or more large files in chunks over MQTT. A stream transports data bytes in chunks or blocks packaged as MQTT messages from a source like S3. You can have one or more files associated with a stream. The total size of a file associated with the stream cannot exceed more than 2 MB. The stream will be created with version 0. If a stream is created with the same streamID as a stream that existed and was deleted within last 90 days, we will resurrect that old stream by incrementing the version by 1.

" - }, - "CreateThing":{ - "name":"CreateThing", - "http":{ - "method":"POST", - "requestUri":"/things/{thingName}" - }, - "input":{"shape":"CreateThingRequest"}, - "output":{"shape":"CreateThingResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a thing record in the registry.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

" - }, - "CreateThingGroup":{ - "name":"CreateThingGroup", - "http":{ - "method":"POST", - "requestUri":"/thing-groups/{thingGroupName}" - }, - "input":{"shape":"CreateThingGroupRequest"}, - "output":{"shape":"CreateThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Create a thing group.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

" - }, - "CreateThingType":{ - "name":"CreateThingType", - "http":{ - "method":"POST", - "requestUri":"/thing-types/{thingTypeName}" - }, - "input":{"shape":"CreateThingTypeRequest"}, - "output":{"shape":"CreateThingTypeResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceAlreadyExistsException"} - ], - "documentation":"

Creates a new thing type.

" - }, - "CreateTopicRule":{ - "name":"CreateTopicRule", - "http":{ - "method":"POST", - "requestUri":"/rules/{ruleName}" - }, - "input":{"shape":"CreateTopicRuleRequest"}, - "errors":[ - {"shape":"SqlParseException"}, - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a rule. Creating rules is an administrator-level action. Any user who has permission to create rules will be able to access data processed by the rule.

" - }, - "DeleteAccountAuditConfiguration":{ - "name":"DeleteAccountAuditConfiguration", - "http":{ - "method":"DELETE", - "requestUri":"/audit/configuration" - }, - "input":{"shape":"DeleteAccountAuditConfigurationRequest"}, - "output":{"shape":"DeleteAccountAuditConfigurationResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Restores the default settings for Device Defender audits for this account. Any configuration data you entered is deleted and all audit checks are reset to disabled.

" - }, - "DeleteAuthorizer":{ - "name":"DeleteAuthorizer", - "http":{ - "method":"DELETE", - "requestUri":"/authorizer/{authorizerName}" - }, - "input":{"shape":"DeleteAuthorizerRequest"}, - "output":{"shape":"DeleteAuthorizerResponse"}, - "errors":[ - {"shape":"DeleteConflictException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes an authorizer.

" - }, - "DeleteCACertificate":{ - "name":"DeleteCACertificate", - "http":{ - "method":"DELETE", - "requestUri":"/cacertificate/{caCertificateId}" - }, - "input":{"shape":"DeleteCACertificateRequest"}, - "output":{"shape":"DeleteCACertificateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"CertificateStateException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a registered CA certificate.

" - }, - "DeleteCertificate":{ - "name":"DeleteCertificate", - "http":{ - "method":"DELETE", - "requestUri":"/certificates/{certificateId}" - }, - "input":{"shape":"DeleteCertificateRequest"}, - "errors":[ - {"shape":"CertificateStateException"}, - {"shape":"DeleteConflictException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes the specified certificate.

A certificate cannot be deleted if it has a policy attached to it or if its status is set to ACTIVE. To delete a certificate, first use the DetachPrincipalPolicy API to detach all policies. Next, use the UpdateCertificate API to set the certificate to the INACTIVE status.

" - }, - "DeleteJob":{ - "name":"DeleteJob", - "http":{ - "method":"DELETE", - "requestUri":"/jobs/{jobId}" - }, - "input":{"shape":"DeleteJobRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidStateTransitionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes a job and its related job executions.

Deleting a job may take time, depending on the number of job executions created for the job and various other factors. While the job is being deleted, the status of the job will be shown as \"DELETION_IN_PROGRESS\". Attempting to delete or cancel a job whose status is already \"DELETION_IN_PROGRESS\" will result in an error.

Only 10 jobs may have status \"DELETION_IN_PROGRESS\" at the same time, or a LimitExceededException will occur.

" - }, - "DeleteJobExecution":{ - "name":"DeleteJobExecution", - "http":{ - "method":"DELETE", - "requestUri":"/things/{thingName}/jobs/{jobId}/executionNumber/{executionNumber}" - }, - "input":{"shape":"DeleteJobExecutionRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InvalidStateTransitionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes a job execution.

" - }, - "DeleteOTAUpdate":{ - "name":"DeleteOTAUpdate", - "http":{ - "method":"DELETE", - "requestUri":"/otaUpdates/{otaUpdateId}" - }, - "input":{"shape":"DeleteOTAUpdateRequest"}, - "output":{"shape":"DeleteOTAUpdateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Delete an OTA update.

" - }, - "DeletePolicy":{ - "name":"DeletePolicy", - "http":{ - "method":"DELETE", - "requestUri":"/policies/{policyName}" - }, - "input":{"shape":"DeletePolicyRequest"}, - "errors":[ - {"shape":"DeleteConflictException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes the specified policy.

A policy cannot be deleted if it has non-default versions or it is attached to any certificate.

To delete a policy, use the DeletePolicyVersion API to delete all non-default versions of the policy; use the DetachPrincipalPolicy API to detach the policy from any certificate; and then use the DeletePolicy API to delete the policy.

When a policy is deleted using DeletePolicy, its default version is deleted with it.

" - }, - "DeletePolicyVersion":{ - "name":"DeletePolicyVersion", - "http":{ - "method":"DELETE", - "requestUri":"/policies/{policyName}/version/{policyVersionId}" - }, - "input":{"shape":"DeletePolicyVersionRequest"}, - "errors":[ - {"shape":"DeleteConflictException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes the specified version of the specified policy. You cannot delete the default version of a policy using this API. To delete the default version of a policy, use DeletePolicy. To find out which version of a policy is marked as the default version, use ListPolicyVersions.

" - }, - "DeleteRegistrationCode":{ - "name":"DeleteRegistrationCode", - "http":{ - "method":"DELETE", - "requestUri":"/registrationcode" - }, - "input":{"shape":"DeleteRegistrationCodeRequest"}, - "output":{"shape":"DeleteRegistrationCodeResponse"}, - "errors":[ - {"shape":"ThrottlingException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a CA certificate registration code.

" - }, - "DeleteRoleAlias":{ - "name":"DeleteRoleAlias", - "http":{ - "method":"DELETE", - "requestUri":"/role-aliases/{roleAlias}" - }, - "input":{"shape":"DeleteRoleAliasRequest"}, - "output":{"shape":"DeleteRoleAliasResponse"}, - "errors":[ - {"shape":"DeleteConflictException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a role alias

" - }, - "DeleteScheduledAudit":{ - "name":"DeleteScheduledAudit", - "http":{ - "method":"DELETE", - "requestUri":"/audit/scheduledaudits/{scheduledAuditName}" - }, - "input":{"shape":"DeleteScheduledAuditRequest"}, - "output":{"shape":"DeleteScheduledAuditResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a scheduled audit.

" - }, - "DeleteSecurityProfile":{ - "name":"DeleteSecurityProfile", - "http":{ - "method":"DELETE", - "requestUri":"/security-profiles/{securityProfileName}" - }, - "input":{"shape":"DeleteSecurityProfileRequest"}, - "output":{"shape":"DeleteSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"VersionConflictException"} - ], - "documentation":"

Deletes a Device Defender security profile.

" - }, - "DeleteStream":{ - "name":"DeleteStream", - "http":{ - "method":"DELETE", - "requestUri":"/streams/{streamId}" - }, - "input":{"shape":"DeleteStreamRequest"}, - "output":{"shape":"DeleteStreamResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"DeleteConflictException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a stream.

" - }, - "DeleteThing":{ - "name":"DeleteThing", - "http":{ - "method":"DELETE", - "requestUri":"/things/{thingName}" - }, - "input":{"shape":"DeleteThingRequest"}, - "output":{"shape":"DeleteThingResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"VersionConflictException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes the specified thing.

" - }, - "DeleteThingGroup":{ - "name":"DeleteThingGroup", - "http":{ - "method":"DELETE", - "requestUri":"/thing-groups/{thingGroupName}" - }, - "input":{"shape":"DeleteThingGroupRequest"}, - "output":{"shape":"DeleteThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"VersionConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a thing group.

" - }, - "DeleteThingType":{ - "name":"DeleteThingType", - "http":{ - "method":"DELETE", - "requestUri":"/thing-types/{thingTypeName}" - }, - "input":{"shape":"DeleteThingTypeRequest"}, - "output":{"shape":"DeleteThingTypeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes the specified thing type . You cannot delete a thing type if it has things associated with it. To delete a thing type, first mark it as deprecated by calling DeprecateThingType, then remove any associated things by calling UpdateThing to change the thing type on any associated thing, and finally use DeleteThingType to delete the thing type.

" - }, - "DeleteTopicRule":{ - "name":"DeleteTopicRule", - "http":{ - "method":"DELETE", - "requestUri":"/rules/{ruleName}" - }, - "input":{"shape":"DeleteTopicRuleRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Deletes the rule.

" - }, - "DeleteV2LoggingLevel":{ - "name":"DeleteV2LoggingLevel", - "http":{ - "method":"DELETE", - "requestUri":"/v2LoggingLevel" - }, - "input":{"shape":"DeleteV2LoggingLevelRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes a logging level.

" - }, - "DeprecateThingType":{ - "name":"DeprecateThingType", - "http":{ - "method":"POST", - "requestUri":"/thing-types/{thingTypeName}/deprecate" - }, - "input":{"shape":"DeprecateThingTypeRequest"}, - "output":{"shape":"DeprecateThingTypeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deprecates a thing type. You can not associate new things with deprecated thing type.

" - }, - "DescribeAccountAuditConfiguration":{ - "name":"DescribeAccountAuditConfiguration", - "http":{ - "method":"GET", - "requestUri":"/audit/configuration" - }, - "input":{"shape":"DescribeAccountAuditConfigurationRequest"}, - "output":{"shape":"DescribeAccountAuditConfigurationResponse"}, - "errors":[ - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about the Device Defender audit settings for this account. Settings include how audit notifications are sent and which audit checks are enabled or disabled.

" - }, - "DescribeAuditTask":{ - "name":"DescribeAuditTask", - "http":{ - "method":"GET", - "requestUri":"/audit/tasks/{taskId}" - }, - "input":{"shape":"DescribeAuditTaskRequest"}, - "output":{"shape":"DescribeAuditTaskResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about a Device Defender audit.

" - }, - "DescribeAuthorizer":{ - "name":"DescribeAuthorizer", - "http":{ - "method":"GET", - "requestUri":"/authorizer/{authorizerName}" - }, - "input":{"shape":"DescribeAuthorizerRequest"}, - "output":{"shape":"DescribeAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Describes an authorizer.

" - }, - "DescribeCACertificate":{ - "name":"DescribeCACertificate", - "http":{ - "method":"GET", - "requestUri":"/cacertificate/{caCertificateId}" - }, - "input":{"shape":"DescribeCACertificateRequest"}, - "output":{"shape":"DescribeCACertificateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a registered CA certificate.

" - }, - "DescribeCertificate":{ - "name":"DescribeCertificate", - "http":{ - "method":"GET", - "requestUri":"/certificates/{certificateId}" - }, - "input":{"shape":"DescribeCertificateRequest"}, - "output":{"shape":"DescribeCertificateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified certificate.

" - }, - "DescribeDefaultAuthorizer":{ - "name":"DescribeDefaultAuthorizer", - "http":{ - "method":"GET", - "requestUri":"/default-authorizer" - }, - "input":{"shape":"DescribeDefaultAuthorizerRequest"}, - "output":{"shape":"DescribeDefaultAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Describes the default authorizer.

" - }, - "DescribeEndpoint":{ - "name":"DescribeEndpoint", - "http":{ - "method":"GET", - "requestUri":"/endpoint" - }, - "input":{"shape":"DescribeEndpointRequest"}, - "output":{"shape":"DescribeEndpointResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Returns a unique endpoint specific to the AWS account making the call.

" - }, - "DescribeEventConfigurations":{ - "name":"DescribeEventConfigurations", - "http":{ - "method":"GET", - "requestUri":"/event-configurations" - }, - "input":{"shape":"DescribeEventConfigurationsRequest"}, - "output":{"shape":"DescribeEventConfigurationsResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Describes event configurations.

" - }, - "DescribeIndex":{ - "name":"DescribeIndex", - "http":{ - "method":"GET", - "requestUri":"/indices/{indexName}" - }, - "input":{"shape":"DescribeIndexRequest"}, - "output":{"shape":"DescribeIndexResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a search index.

" - }, - "DescribeJob":{ - "name":"DescribeJob", - "http":{ - "method":"GET", - "requestUri":"/jobs/{jobId}" - }, - "input":{"shape":"DescribeJobRequest"}, - "output":{"shape":"DescribeJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes a job.

" - }, - "DescribeJobExecution":{ - "name":"DescribeJobExecution", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/jobs/{jobId}" - }, - "input":{"shape":"DescribeJobExecutionRequest"}, - "output":{"shape":"DescribeJobExecutionResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes a job execution.

" - }, - "DescribeRoleAlias":{ - "name":"DescribeRoleAlias", - "http":{ - "method":"GET", - "requestUri":"/role-aliases/{roleAlias}" - }, - "input":{"shape":"DescribeRoleAliasRequest"}, - "output":{"shape":"DescribeRoleAliasResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a role alias.

" - }, - "DescribeScheduledAudit":{ - "name":"DescribeScheduledAudit", - "http":{ - "method":"GET", - "requestUri":"/audit/scheduledaudits/{scheduledAuditName}" - }, - "input":{"shape":"DescribeScheduledAuditRequest"}, - "output":{"shape":"DescribeScheduledAuditResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about a scheduled audit.

" - }, - "DescribeSecurityProfile":{ - "name":"DescribeSecurityProfile", - "http":{ - "method":"GET", - "requestUri":"/security-profiles/{securityProfileName}" - }, - "input":{"shape":"DescribeSecurityProfileRequest"}, - "output":{"shape":"DescribeSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about a Device Defender security profile.

" - }, - "DescribeStream":{ - "name":"DescribeStream", - "http":{ - "method":"GET", - "requestUri":"/streams/{streamId}" - }, - "input":{"shape":"DescribeStreamRequest"}, - "output":{"shape":"DescribeStreamResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about a stream.

" - }, - "DescribeThing":{ - "name":"DescribeThing", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}" - }, - "input":{"shape":"DescribeThingRequest"}, - "output":{"shape":"DescribeThingResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about the specified thing.

" - }, - "DescribeThingGroup":{ - "name":"DescribeThingGroup", - "http":{ - "method":"GET", - "requestUri":"/thing-groups/{thingGroupName}" - }, - "input":{"shape":"DescribeThingGroupRequest"}, - "output":{"shape":"DescribeThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describe a thing group.

" - }, - "DescribeThingRegistrationTask":{ - "name":"DescribeThingRegistrationTask", - "http":{ - "method":"GET", - "requestUri":"/thing-registration-tasks/{taskId}" - }, - "input":{"shape":"DescribeThingRegistrationTaskRequest"}, - "output":{"shape":"DescribeThingRegistrationTaskResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a bulk thing provisioning task.

" - }, - "DescribeThingType":{ - "name":"DescribeThingType", - "http":{ - "method":"GET", - "requestUri":"/thing-types/{thingTypeName}" - }, - "input":{"shape":"DescribeThingTypeRequest"}, - "output":{"shape":"DescribeThingTypeResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about the specified thing type.

" - }, - "DetachPolicy":{ - "name":"DetachPolicy", - "http":{ - "method":"POST", - "requestUri":"/target-policies/{policyName}" - }, - "input":{"shape":"DetachPolicyRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Detaches a policy from the specified target.

" - }, - "DetachPrincipalPolicy":{ - "name":"DetachPrincipalPolicy", - "http":{ - "method":"DELETE", - "requestUri":"/principal-policies/{policyName}" - }, - "input":{"shape":"DetachPrincipalPolicyRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Removes the specified policy from the specified certificate.

Note: This API is deprecated. Please use DetachPolicy instead.

", - "deprecated":true - }, - "DetachSecurityProfile":{ - "name":"DetachSecurityProfile", - "http":{ - "method":"DELETE", - "requestUri":"/security-profiles/{securityProfileName}/targets" - }, - "input":{"shape":"DetachSecurityProfileRequest"}, - "output":{"shape":"DetachSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Disassociates a Device Defender security profile from a thing group or from this account.

" - }, - "DetachThingPrincipal":{ - "name":"DetachThingPrincipal", - "http":{ - "method":"DELETE", - "requestUri":"/things/{thingName}/principals" - }, - "input":{"shape":"DetachThingPrincipalRequest"}, - "output":{"shape":"DetachThingPrincipalResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Detaches the specified principal from the specified thing.

" - }, - "DisableTopicRule":{ - "name":"DisableTopicRule", - "http":{ - "method":"POST", - "requestUri":"/rules/{ruleName}/disable" - }, - "input":{"shape":"DisableTopicRuleRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Disables the rule.

" - }, - "EnableTopicRule":{ - "name":"EnableTopicRule", - "http":{ - "method":"POST", - "requestUri":"/rules/{ruleName}/enable" - }, - "input":{"shape":"EnableTopicRuleRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Enables the rule.

" - }, - "GetEffectivePolicies":{ - "name":"GetEffectivePolicies", - "http":{ - "method":"POST", - "requestUri":"/effective-policies" - }, - "input":{"shape":"GetEffectivePoliciesRequest"}, - "output":{"shape":"GetEffectivePoliciesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Gets a list of the policies that have an effect on the authorization behavior of the specified device when it connects to the AWS IoT device gateway.

" - }, - "GetIndexingConfiguration":{ - "name":"GetIndexingConfiguration", - "http":{ - "method":"GET", - "requestUri":"/indexing/config" - }, - "input":{"shape":"GetIndexingConfigurationRequest"}, - "output":{"shape":"GetIndexingConfigurationResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets the search configuration.

" - }, - "GetJobDocument":{ - "name":"GetJobDocument", - "http":{ - "method":"GET", - "requestUri":"/jobs/{jobId}/job-document" - }, - "input":{"shape":"GetJobDocumentRequest"}, - "output":{"shape":"GetJobDocumentResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Gets a job document.

" - }, - "GetLoggingOptions":{ - "name":"GetLoggingOptions", - "http":{ - "method":"GET", - "requestUri":"/loggingOptions" - }, - "input":{"shape":"GetLoggingOptionsRequest"}, - "output":{"shape":"GetLoggingOptionsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Gets the logging options.

NOTE: use of this command is not recommended. Use GetV2LoggingOptions instead.

" - }, - "GetOTAUpdate":{ - "name":"GetOTAUpdate", - "http":{ - "method":"GET", - "requestUri":"/otaUpdates/{otaUpdateId}" - }, - "input":{"shape":"GetOTAUpdateRequest"}, - "output":{"shape":"GetOTAUpdateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets an OTA update.

" - }, - "GetPolicy":{ - "name":"GetPolicy", - "http":{ - "method":"GET", - "requestUri":"/policies/{policyName}" - }, - "input":{"shape":"GetPolicyRequest"}, - "output":{"shape":"GetPolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about the specified policy with the policy document of the default version.

" - }, - "GetPolicyVersion":{ - "name":"GetPolicyVersion", - "http":{ - "method":"GET", - "requestUri":"/policies/{policyName}/version/{policyVersionId}" - }, - "input":{"shape":"GetPolicyVersionRequest"}, - "output":{"shape":"GetPolicyVersionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Gets information about the specified policy version.

" - }, - "GetRegistrationCode":{ - "name":"GetRegistrationCode", - "http":{ - "method":"GET", - "requestUri":"/registrationcode" - }, - "input":{"shape":"GetRegistrationCodeRequest"}, - "output":{"shape":"GetRegistrationCodeResponse"}, - "errors":[ - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Gets a registration code used to register a CA certificate with AWS IoT.

" - }, - "GetTopicRule":{ - "name":"GetTopicRule", - "http":{ - "method":"GET", - "requestUri":"/rules/{ruleName}" - }, - "input":{"shape":"GetTopicRuleRequest"}, - "output":{"shape":"GetTopicRuleResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Gets information about the rule.

" - }, - "GetV2LoggingOptions":{ - "name":"GetV2LoggingOptions", - "http":{ - "method":"GET", - "requestUri":"/v2LoggingOptions" - }, - "input":{"shape":"GetV2LoggingOptionsRequest"}, - "output":{"shape":"GetV2LoggingOptionsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"NotConfiguredException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Gets the fine grained logging options.

" - }, - "ListActiveViolations":{ - "name":"ListActiveViolations", - "http":{ - "method":"GET", - "requestUri":"/active-violations" - }, - "input":{"shape":"ListActiveViolationsRequest"}, - "output":{"shape":"ListActiveViolationsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the active violations for a given Device Defender security profile.

" - }, - "ListAttachedPolicies":{ - "name":"ListAttachedPolicies", - "http":{ - "method":"POST", - "requestUri":"/attached-policies/{target}" - }, - "input":{"shape":"ListAttachedPoliciesRequest"}, - "output":{"shape":"ListAttachedPoliciesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Lists the policies attached to the specified thing group.

" - }, - "ListAuditFindings":{ - "name":"ListAuditFindings", - "http":{ - "method":"POST", - "requestUri":"/audit/findings" - }, - "input":{"shape":"ListAuditFindingsRequest"}, - "output":{"shape":"ListAuditFindingsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the findings (results) of a Device Defender audit or of the audits performed during a specified time period. (Findings are retained for 180 days.)

" - }, - "ListAuditTasks":{ - "name":"ListAuditTasks", - "http":{ - "method":"GET", - "requestUri":"/audit/tasks" - }, - "input":{"shape":"ListAuditTasksRequest"}, - "output":{"shape":"ListAuditTasksResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the Device Defender audits that have been performed during a given time period.

" - }, - "ListAuthorizers":{ - "name":"ListAuthorizers", - "http":{ - "method":"GET", - "requestUri":"/authorizers/" - }, - "input":{"shape":"ListAuthorizersRequest"}, - "output":{"shape":"ListAuthorizersResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the authorizers registered in your account.

" - }, - "ListCACertificates":{ - "name":"ListCACertificates", - "http":{ - "method":"GET", - "requestUri":"/cacertificates" - }, - "input":{"shape":"ListCACertificatesRequest"}, - "output":{"shape":"ListCACertificatesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the CA certificates registered for your AWS account.

The results are paginated with a default page size of 25. You can use the returned marker to retrieve additional results.

" - }, - "ListCertificates":{ - "name":"ListCertificates", - "http":{ - "method":"GET", - "requestUri":"/certificates" - }, - "input":{"shape":"ListCertificatesRequest"}, - "output":{"shape":"ListCertificatesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the certificates registered in your AWS account.

The results are paginated with a default page size of 25. You can use the returned marker to retrieve additional results.

" - }, - "ListCertificatesByCA":{ - "name":"ListCertificatesByCA", - "http":{ - "method":"GET", - "requestUri":"/certificates-by-ca/{caCertificateId}" - }, - "input":{"shape":"ListCertificatesByCARequest"}, - "output":{"shape":"ListCertificatesByCAResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

List the device certificates signed by the specified CA certificate.

" - }, - "ListIndices":{ - "name":"ListIndices", - "http":{ - "method":"GET", - "requestUri":"/indices" - }, - "input":{"shape":"ListIndicesRequest"}, - "output":{"shape":"ListIndicesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the search indices.

" - }, - "ListJobExecutionsForJob":{ - "name":"ListJobExecutionsForJob", - "http":{ - "method":"GET", - "requestUri":"/jobs/{jobId}/things" - }, - "input":{"shape":"ListJobExecutionsForJobRequest"}, - "output":{"shape":"ListJobExecutionsForJobResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the job executions for a job.

" - }, - "ListJobExecutionsForThing":{ - "name":"ListJobExecutionsForThing", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/jobs" - }, - "input":{"shape":"ListJobExecutionsForThingRequest"}, - "output":{"shape":"ListJobExecutionsForThingResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the job executions for the specified thing.

" - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"GET", - "requestUri":"/jobs" - }, - "input":{"shape":"ListJobsRequest"}, - "output":{"shape":"ListJobsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists jobs.

" - }, - "ListOTAUpdates":{ - "name":"ListOTAUpdates", - "http":{ - "method":"GET", - "requestUri":"/otaUpdates" - }, - "input":{"shape":"ListOTAUpdatesRequest"}, - "output":{"shape":"ListOTAUpdatesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists OTA updates.

" - }, - "ListOutgoingCertificates":{ - "name":"ListOutgoingCertificates", - "http":{ - "method":"GET", - "requestUri":"/certificates-out-going" - }, - "input":{"shape":"ListOutgoingCertificatesRequest"}, - "output":{"shape":"ListOutgoingCertificatesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists certificates that are being transferred but not yet accepted.

" - }, - "ListPolicies":{ - "name":"ListPolicies", - "http":{ - "method":"GET", - "requestUri":"/policies" - }, - "input":{"shape":"ListPoliciesRequest"}, - "output":{"shape":"ListPoliciesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists your policies.

" - }, - "ListPolicyPrincipals":{ - "name":"ListPolicyPrincipals", - "http":{ - "method":"GET", - "requestUri":"/policy-principals" - }, - "input":{"shape":"ListPolicyPrincipalsRequest"}, - "output":{"shape":"ListPolicyPrincipalsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the principals associated with the specified policy.

Note: This API is deprecated. Please use ListTargetsForPolicy instead.

", - "deprecated":true - }, - "ListPolicyVersions":{ - "name":"ListPolicyVersions", - "http":{ - "method":"GET", - "requestUri":"/policies/{policyName}/version" - }, - "input":{"shape":"ListPolicyVersionsRequest"}, - "output":{"shape":"ListPolicyVersionsResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the versions of the specified policy and identifies the default version.

" - }, - "ListPrincipalPolicies":{ - "name":"ListPrincipalPolicies", - "http":{ - "method":"GET", - "requestUri":"/principal-policies" - }, - "input":{"shape":"ListPrincipalPoliciesRequest"}, - "output":{"shape":"ListPrincipalPoliciesResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the policies attached to the specified principal. If you use an Cognito identity, the ID must be in AmazonCognito Identity format.

Note: This API is deprecated. Please use ListAttachedPolicies instead.

", - "deprecated":true - }, - "ListPrincipalThings":{ - "name":"ListPrincipalThings", - "http":{ - "method":"GET", - "requestUri":"/principals/things" - }, - "input":{"shape":"ListPrincipalThingsRequest"}, - "output":{"shape":"ListPrincipalThingsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the things associated with the specified principal.

" - }, - "ListRoleAliases":{ - "name":"ListRoleAliases", - "http":{ - "method":"GET", - "requestUri":"/role-aliases" - }, - "input":{"shape":"ListRoleAliasesRequest"}, - "output":{"shape":"ListRoleAliasesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the role aliases registered in your account.

" - }, - "ListScheduledAudits":{ - "name":"ListScheduledAudits", - "http":{ - "method":"GET", - "requestUri":"/audit/scheduledaudits" - }, - "input":{"shape":"ListScheduledAuditsRequest"}, - "output":{"shape":"ListScheduledAuditsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists all of your scheduled audits.

" - }, - "ListSecurityProfiles":{ - "name":"ListSecurityProfiles", - "http":{ - "method":"GET", - "requestUri":"/security-profiles" - }, - "input":{"shape":"ListSecurityProfilesRequest"}, - "output":{"shape":"ListSecurityProfilesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the Device Defender security profiles you have created. You can use filters to list only those security profiles associated with a thing group or only those associated with your account.

" - }, - "ListSecurityProfilesForTarget":{ - "name":"ListSecurityProfilesForTarget", - "http":{ - "method":"GET", - "requestUri":"/security-profiles-for-target" - }, - "input":{"shape":"ListSecurityProfilesForTargetRequest"}, - "output":{"shape":"ListSecurityProfilesForTargetResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the Device Defender security profiles attached to a target (thing group).

" - }, - "ListStreams":{ - "name":"ListStreams", - "http":{ - "method":"GET", - "requestUri":"/streams" - }, - "input":{"shape":"ListStreamsRequest"}, - "output":{"shape":"ListStreamsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists all of the streams in your AWS account.

" - }, - "ListTargetsForPolicy":{ - "name":"ListTargetsForPolicy", - "http":{ - "method":"POST", - "requestUri":"/policy-targets/{policyName}" - }, - "input":{"shape":"ListTargetsForPolicyRequest"}, - "output":{"shape":"ListTargetsForPolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

List targets for the specified policy.

" - }, - "ListTargetsForSecurityProfile":{ - "name":"ListTargetsForSecurityProfile", - "http":{ - "method":"GET", - "requestUri":"/security-profiles/{securityProfileName}/targets" - }, - "input":{"shape":"ListTargetsForSecurityProfileRequest"}, - "output":{"shape":"ListTargetsForSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the targets (thing groups) associated with a given Device Defender security profile.

" - }, - "ListThingGroups":{ - "name":"ListThingGroups", - "http":{ - "method":"GET", - "requestUri":"/thing-groups" - }, - "input":{"shape":"ListThingGroupsRequest"}, - "output":{"shape":"ListThingGroupsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

List the thing groups in your account.

" - }, - "ListThingGroupsForThing":{ - "name":"ListThingGroupsForThing", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/thing-groups" - }, - "input":{"shape":"ListThingGroupsForThingRequest"}, - "output":{"shape":"ListThingGroupsForThingResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

List the thing groups to which the specified thing belongs.

" - }, - "ListThingPrincipals":{ - "name":"ListThingPrincipals", - "http":{ - "method":"GET", - "requestUri":"/things/{thingName}/principals" - }, - "input":{"shape":"ListThingPrincipalsRequest"}, - "output":{"shape":"ListThingPrincipalsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the principals associated with the specified thing.

" - }, - "ListThingRegistrationTaskReports":{ - "name":"ListThingRegistrationTaskReports", - "http":{ - "method":"GET", - "requestUri":"/thing-registration-tasks/{taskId}/reports" - }, - "input":{"shape":"ListThingRegistrationTaskReportsRequest"}, - "output":{"shape":"ListThingRegistrationTaskReportsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Information about the thing registration tasks.

" - }, - "ListThingRegistrationTasks":{ - "name":"ListThingRegistrationTasks", - "http":{ - "method":"GET", - "requestUri":"/thing-registration-tasks" - }, - "input":{"shape":"ListThingRegistrationTasksRequest"}, - "output":{"shape":"ListThingRegistrationTasksResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

List bulk thing provisioning tasks.

" - }, - "ListThingTypes":{ - "name":"ListThingTypes", - "http":{ - "method":"GET", - "requestUri":"/thing-types" - }, - "input":{"shape":"ListThingTypesRequest"}, - "output":{"shape":"ListThingTypesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the existing thing types.

" - }, - "ListThings":{ - "name":"ListThings", - "http":{ - "method":"GET", - "requestUri":"/things" - }, - "input":{"shape":"ListThingsRequest"}, - "output":{"shape":"ListThingsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists your things. Use the attributeName and attributeValue parameters to filter your things. For example, calling ListThings with attributeName=Color and attributeValue=Red retrieves all things in the registry that contain an attribute Color with the value Red.

" - }, - "ListThingsInThingGroup":{ - "name":"ListThingsInThingGroup", - "http":{ - "method":"GET", - "requestUri":"/thing-groups/{thingGroupName}/things" - }, - "input":{"shape":"ListThingsInThingGroupRequest"}, - "output":{"shape":"ListThingsInThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the things in the specified group.

" - }, - "ListTopicRules":{ - "name":"ListTopicRules", - "http":{ - "method":"GET", - "requestUri":"/rules" - }, - "input":{"shape":"ListTopicRulesRequest"}, - "output":{"shape":"ListTopicRulesResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the rules for the specific topic.

" - }, - "ListV2LoggingLevels":{ - "name":"ListV2LoggingLevels", - "http":{ - "method":"GET", - "requestUri":"/v2LoggingLevel" - }, - "input":{"shape":"ListV2LoggingLevelsRequest"}, - "output":{"shape":"ListV2LoggingLevelsResponse"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"NotConfiguredException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists logging levels.

" - }, - "ListViolationEvents":{ - "name":"ListViolationEvents", - "http":{ - "method":"GET", - "requestUri":"/violation-events" - }, - "input":{"shape":"ListViolationEventsRequest"}, - "output":{"shape":"ListViolationEventsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists the Device Defender security profile violations discovered during the given time period. You can use filters to limit the results to those alerts issued for a particular security profile, behavior or thing (device).

" - }, - "RegisterCACertificate":{ - "name":"RegisterCACertificate", - "http":{ - "method":"POST", - "requestUri":"/cacertificate" - }, - "input":{"shape":"RegisterCACertificateRequest"}, - "output":{"shape":"RegisterCACertificateResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"RegistrationCodeValidationException"}, - {"shape":"InvalidRequestException"}, - {"shape":"CertificateValidationException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Registers a CA certificate with AWS IoT. This CA certificate can then be used to sign device certificates, which can be then registered with AWS IoT. You can register up to 10 CA certificates per AWS account that have the same subject field. This enables you to have up to 10 certificate authorities sign your device certificates. If you have more than one CA certificate registered, make sure you pass the CA certificate when you register your device certificates with the RegisterCertificate API.

" - }, - "RegisterCertificate":{ - "name":"RegisterCertificate", - "http":{ - "method":"POST", - "requestUri":"/certificate/register" - }, - "input":{"shape":"RegisterCertificateRequest"}, - "output":{"shape":"RegisterCertificateResponse"}, - "errors":[ - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InvalidRequestException"}, - {"shape":"CertificateValidationException"}, - {"shape":"CertificateStateException"}, - {"shape":"CertificateConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Registers a device certificate with AWS IoT. If you have more than one CA certificate that has the same subject field, you must specify the CA certificate that was used to sign the device certificate being registered.

" - }, - "RegisterThing":{ - "name":"RegisterThing", - "http":{ - "method":"POST", - "requestUri":"/things" - }, - "input":{"shape":"RegisterThingRequest"}, - "output":{"shape":"RegisterThingResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ThrottlingException"}, - {"shape":"ConflictingResourceUpdateException"}, - {"shape":"ResourceRegistrationFailureException"} - ], - "documentation":"

Provisions a thing.

" - }, - "RejectCertificateTransfer":{ - "name":"RejectCertificateTransfer", - "http":{ - "method":"PATCH", - "requestUri":"/reject-certificate-transfer/{certificateId}" - }, - "input":{"shape":"RejectCertificateTransferRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"TransferAlreadyCompletedException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Rejects a pending certificate transfer. After AWS IoT rejects a certificate transfer, the certificate status changes from PENDING_TRANSFER to INACTIVE.

To check for pending certificate transfers, call ListCertificates to enumerate your certificates.

This operation can only be called by the transfer destination. After it is called, the certificate will be returned to the source's account in the INACTIVE state.

" - }, - "RemoveThingFromThingGroup":{ - "name":"RemoveThingFromThingGroup", - "http":{ - "method":"PUT", - "requestUri":"/thing-groups/removeThingFromThingGroup" - }, - "input":{"shape":"RemoveThingFromThingGroupRequest"}, - "output":{"shape":"RemoveThingFromThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Remove the specified thing from the specified group.

" - }, - "ReplaceTopicRule":{ - "name":"ReplaceTopicRule", - "http":{ - "method":"PATCH", - "requestUri":"/rules/{ruleName}" - }, - "input":{"shape":"ReplaceTopicRuleRequest"}, - "errors":[ - {"shape":"SqlParseException"}, - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"} - ], - "documentation":"

Replaces the rule. You must specify all parameters for the new rule. Creating rules is an administrator-level action. Any user who has permission to create rules will be able to access data processed by the rule.

" - }, - "SearchIndex":{ - "name":"SearchIndex", - "http":{ - "method":"POST", - "requestUri":"/indices/search" - }, - "input":{"shape":"SearchIndexRequest"}, - "output":{"shape":"SearchIndexResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidQueryException"}, - {"shape":"IndexNotReadyException"} - ], - "documentation":"

The query search index.

" - }, - "SetDefaultAuthorizer":{ - "name":"SetDefaultAuthorizer", - "http":{ - "method":"POST", - "requestUri":"/default-authorizer" - }, - "input":{"shape":"SetDefaultAuthorizerRequest"}, - "output":{"shape":"SetDefaultAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceAlreadyExistsException"} - ], - "documentation":"

Sets the default authorizer. This will be used if a websocket connection is made without specifying an authorizer.

" - }, - "SetDefaultPolicyVersion":{ - "name":"SetDefaultPolicyVersion", - "http":{ - "method":"PATCH", - "requestUri":"/policies/{policyName}/version/{policyVersionId}" - }, - "input":{"shape":"SetDefaultPolicyVersionRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Sets the specified version of the specified policy as the policy's default (operative) version. This action affects all certificates to which the policy is attached. To list the principals the policy is attached to, use the ListPrincipalPolicy API.

" - }, - "SetLoggingOptions":{ - "name":"SetLoggingOptions", - "http":{ - "method":"POST", - "requestUri":"/loggingOptions" - }, - "input":{"shape":"SetLoggingOptionsRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Sets the logging options.

NOTE: use of this command is not recommended. Use SetV2LoggingOptions instead.

" - }, - "SetV2LoggingLevel":{ - "name":"SetV2LoggingLevel", - "http":{ - "method":"POST", - "requestUri":"/v2LoggingLevel" - }, - "input":{"shape":"SetV2LoggingLevelRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"NotConfiguredException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Sets the logging level.

" - }, - "SetV2LoggingOptions":{ - "name":"SetV2LoggingOptions", - "http":{ - "method":"POST", - "requestUri":"/v2LoggingOptions" - }, - "input":{"shape":"SetV2LoggingOptionsRequest"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Sets the logging options for the V2 logging service.

" - }, - "StartOnDemandAuditTask":{ - "name":"StartOnDemandAuditTask", - "http":{ - "method":"POST", - "requestUri":"/audit/tasks" - }, - "input":{"shape":"StartOnDemandAuditTaskRequest"}, - "output":{"shape":"StartOnDemandAuditTaskResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Starts an on-demand Device Defender audit.

" - }, - "StartThingRegistrationTask":{ - "name":"StartThingRegistrationTask", - "http":{ - "method":"POST", - "requestUri":"/thing-registration-tasks" - }, - "input":{"shape":"StartThingRegistrationTaskRequest"}, - "output":{"shape":"StartThingRegistrationTaskResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Creates a bulk thing provisioning task.

" - }, - "StopThingRegistrationTask":{ - "name":"StopThingRegistrationTask", - "http":{ - "method":"PUT", - "requestUri":"/thing-registration-tasks/{taskId}/cancel" - }, - "input":{"shape":"StopThingRegistrationTaskRequest"}, - "output":{"shape":"StopThingRegistrationTaskResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Cancels a bulk thing provisioning task.

" - }, - "TestAuthorization":{ - "name":"TestAuthorization", - "http":{ - "method":"POST", - "requestUri":"/test-authorization" - }, - "input":{"shape":"TestAuthorizationRequest"}, - "output":{"shape":"TestAuthorizationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Tests if a specified principal is authorized to perform an AWS IoT action on a specified resource. Use this to test and debug the authorization behavior of devices that connect to the AWS IoT device gateway.

" - }, - "TestInvokeAuthorizer":{ - "name":"TestInvokeAuthorizer", - "http":{ - "method":"POST", - "requestUri":"/authorizer/{authorizerName}/test" - }, - "input":{"shape":"TestInvokeAuthorizerRequest"}, - "output":{"shape":"TestInvokeAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"InvalidResponseException"} - ], - "documentation":"

Tests a custom authorization behavior by invoking a specified custom authorizer. Use this to test and debug the custom authorization behavior of devices that connect to the AWS IoT device gateway.

" - }, - "TransferCertificate":{ - "name":"TransferCertificate", - "http":{ - "method":"PATCH", - "requestUri":"/transfer-certificate/{certificateId}" - }, - "input":{"shape":"TransferCertificateRequest"}, - "output":{"shape":"TransferCertificateResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"CertificateStateException"}, - {"shape":"TransferConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Transfers the specified certificate to the specified AWS account.

You can cancel the transfer until it is acknowledged by the recipient.

No notification is sent to the transfer destination's account. It is up to the caller to notify the transfer target.

The certificate being transferred must not be in the ACTIVE state. You can use the UpdateCertificate API to deactivate it.

The certificate must not have any policies attached to it. You can use the DetachPrincipalPolicy API to detach them.

" - }, - "UpdateAccountAuditConfiguration":{ - "name":"UpdateAccountAuditConfiguration", - "http":{ - "method":"PATCH", - "requestUri":"/audit/configuration" - }, - "input":{"shape":"UpdateAccountAuditConfigurationRequest"}, - "output":{"shape":"UpdateAccountAuditConfigurationResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Configures or reconfigures the Device Defender audit settings for this account. Settings include how audit notifications are sent and which audit checks are enabled or disabled.

" - }, - "UpdateAuthorizer":{ - "name":"UpdateAuthorizer", - "http":{ - "method":"PUT", - "requestUri":"/authorizer/{authorizerName}" - }, - "input":{"shape":"UpdateAuthorizerRequest"}, - "output":{"shape":"UpdateAuthorizerResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates an authorizer.

" - }, - "UpdateCACertificate":{ - "name":"UpdateCACertificate", - "http":{ - "method":"PUT", - "requestUri":"/cacertificate/{caCertificateId}" - }, - "input":{"shape":"UpdateCACertificateRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a registered CA certificate.

" - }, - "UpdateCertificate":{ - "name":"UpdateCertificate", - "http":{ - "method":"PUT", - "requestUri":"/certificates/{certificateId}" - }, - "input":{"shape":"UpdateCertificateRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"CertificateStateException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates the status of the specified certificate. This operation is idempotent.

Moving a certificate from the ACTIVE state (including REVOKED) will not disconnect currently connected devices, but these devices will be unable to reconnect.

The ACTIVE state is required to authenticate devices connecting to AWS IoT using a certificate.

" - }, - "UpdateEventConfigurations":{ - "name":"UpdateEventConfigurations", - "http":{ - "method":"PATCH", - "requestUri":"/event-configurations" - }, - "input":{"shape":"UpdateEventConfigurationsRequest"}, - "output":{"shape":"UpdateEventConfigurationsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Updates the event configurations.

" - }, - "UpdateIndexingConfiguration":{ - "name":"UpdateIndexingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/indexing/config" - }, - "input":{"shape":"UpdateIndexingConfigurationRequest"}, - "output":{"shape":"UpdateIndexingConfigurationResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates the search configuration.

" - }, - "UpdateRoleAlias":{ - "name":"UpdateRoleAlias", - "http":{ - "method":"PUT", - "requestUri":"/role-aliases/{roleAlias}" - }, - "input":{"shape":"UpdateRoleAliasRequest"}, - "output":{"shape":"UpdateRoleAliasResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a role alias.

" - }, - "UpdateScheduledAudit":{ - "name":"UpdateScheduledAudit", - "http":{ - "method":"PATCH", - "requestUri":"/audit/scheduledaudits/{scheduledAuditName}" - }, - "input":{"shape":"UpdateScheduledAuditRequest"}, - "output":{"shape":"UpdateScheduledAuditResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a scheduled audit, including what checks are performed and how often the audit takes place.

" - }, - "UpdateSecurityProfile":{ - "name":"UpdateSecurityProfile", - "http":{ - "method":"PATCH", - "requestUri":"/security-profiles/{securityProfileName}" - }, - "input":{"shape":"UpdateSecurityProfileRequest"}, - "output":{"shape":"UpdateSecurityProfileResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"VersionConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates a Device Defender security profile.

" - }, - "UpdateStream":{ - "name":"UpdateStream", - "http":{ - "method":"PUT", - "requestUri":"/streams/{streamId}" - }, - "input":{"shape":"UpdateStreamRequest"}, - "output":{"shape":"UpdateStreamResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Updates an existing stream. The stream version will be incremented by one.

" - }, - "UpdateThing":{ - "name":"UpdateThing", - "http":{ - "method":"PATCH", - "requestUri":"/things/{thingName}" - }, - "input":{"shape":"UpdateThingRequest"}, - "output":{"shape":"UpdateThingResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"VersionConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"UnauthorizedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the data for a thing.

" - }, - "UpdateThingGroup":{ - "name":"UpdateThingGroup", - "http":{ - "method":"PATCH", - "requestUri":"/thing-groups/{thingGroupName}" - }, - "input":{"shape":"UpdateThingGroupRequest"}, - "output":{"shape":"UpdateThingGroupResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"VersionConflictException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Update a thing group.

" - }, - "UpdateThingGroupsForThing":{ - "name":"UpdateThingGroupsForThing", - "http":{ - "method":"PUT", - "requestUri":"/thing-groups/updateThingGroupsForThing" - }, - "input":{"shape":"UpdateThingGroupsForThingRequest"}, - "output":{"shape":"UpdateThingGroupsForThingResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the groups to which the thing belongs.

" - }, - "ValidateSecurityProfileBehaviors":{ - "name":"ValidateSecurityProfileBehaviors", - "http":{ - "method":"POST", - "requestUri":"/security-profile-behaviors/validate" - }, - "input":{"shape":"ValidateSecurityProfileBehaviorsRequest"}, - "output":{"shape":"ValidateSecurityProfileBehaviorsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Validates a Device Defender security profile behaviors specification.

" - } - }, - "shapes":{ - "AcceptCertificateTransferRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - }, - "setAsActive":{ - "shape":"SetAsActive", - "documentation":"

Specifies whether the certificate is active.

", - "location":"querystring", - "locationName":"setAsActive" - } - }, - "documentation":"

The input for the AcceptCertificateTransfer operation.

" - }, - "Action":{ - "type":"structure", - "members":{ - "dynamoDB":{ - "shape":"DynamoDBAction", - "documentation":"

Write to a DynamoDB table.

" - }, - "dynamoDBv2":{ - "shape":"DynamoDBv2Action", - "documentation":"

Write to a DynamoDB table. This is a new version of the DynamoDB action. It allows you to write each attribute in an MQTT message payload into a separate DynamoDB column.

" - }, - "lambda":{ - "shape":"LambdaAction", - "documentation":"

Invoke a Lambda function.

" - }, - "sns":{ - "shape":"SnsAction", - "documentation":"

Publish to an Amazon SNS topic.

" - }, - "sqs":{ - "shape":"SqsAction", - "documentation":"

Publish to an Amazon SQS queue.

" - }, - "kinesis":{ - "shape":"KinesisAction", - "documentation":"

Write data to an Amazon Kinesis stream.

" - }, - "republish":{ - "shape":"RepublishAction", - "documentation":"

Publish to another MQTT topic.

" - }, - "s3":{ - "shape":"S3Action", - "documentation":"

Write to an Amazon S3 bucket.

" - }, - "firehose":{ - "shape":"FirehoseAction", - "documentation":"

Write to an Amazon Kinesis Firehose stream.

" - }, - "cloudwatchMetric":{ - "shape":"CloudwatchMetricAction", - "documentation":"

Capture a CloudWatch metric.

" - }, - "cloudwatchAlarm":{ - "shape":"CloudwatchAlarmAction", - "documentation":"

Change the state of a CloudWatch alarm.

" - }, - "elasticsearch":{ - "shape":"ElasticsearchAction", - "documentation":"

Write data to an Amazon Elasticsearch Service domain.

" - }, - "salesforce":{ - "shape":"SalesforceAction", - "documentation":"

Send a message to a Salesforce IoT Cloud Input Stream.

" - }, - "iotAnalytics":{ - "shape":"IotAnalyticsAction", - "documentation":"

Sends message data to an AWS IoT Analytics channel.

" - }, - "stepFunctions":{ - "shape":"StepFunctionsAction", - "documentation":"

Starts execution of a Step Functions state machine.

" - } - }, - "documentation":"

Describes the actions associated with a rule.

" - }, - "ActionList":{ - "type":"list", - "member":{"shape":"Action"}, - "max":10, - "min":0 - }, - "ActionType":{ - "type":"string", - "enum":[ - "PUBLISH", - "SUBSCRIBE", - "RECEIVE", - "CONNECT" - ] - }, - "ActiveViolation":{ - "type":"structure", - "members":{ - "violationId":{ - "shape":"ViolationId", - "documentation":"

The ID of the active violation.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing responsible for the active violation.

" - }, - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The security profile whose behavior is in violation.

" - }, - "behavior":{ - "shape":"Behavior", - "documentation":"

The behavior which is being violated.

" - }, - "lastViolationValue":{ - "shape":"MetricValue", - "documentation":"

The value of the metric (the measurement) which caused the most recent violation.

" - }, - "lastViolationTime":{ - "shape":"Timestamp", - "documentation":"

The time the most recent violation occurred.

" - }, - "violationStartTime":{ - "shape":"Timestamp", - "documentation":"

The time the violation started.

" - } - }, - "documentation":"

Information about an active Device Defender security profile behavior violation.

" - }, - "ActiveViolations":{ - "type":"list", - "member":{"shape":"ActiveViolation"} - }, - "AddThingToThingGroupRequest":{ - "type":"structure", - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The name of the group to which you are adding a thing.

" - }, - "thingGroupArn":{ - "shape":"ThingGroupArn", - "documentation":"

The ARN of the group to which you are adding a thing.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing to add to a group.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the thing to add to a group.

" - } - } - }, - "AddThingToThingGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "AdditionalParameterMap":{ - "type":"map", - "key":{"shape":"Key"}, - "value":{"shape":"Value"} - }, - "AlarmName":{"type":"string"}, - "AlertTarget":{ - "type":"structure", - "required":[ - "alertTargetArn", - "roleArn" - ], - "members":{ - "alertTargetArn":{ - "shape":"AlertTargetArn", - "documentation":"

The ARN of the notification target to which alerts are sent.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that grants permission to send alerts to the notification target.

" - } - }, - "documentation":"

A structure containing the alert target ARN and the role ARN.

" - }, - "AlertTargetArn":{"type":"string"}, - "AlertTargetType":{ - "type":"string", - "documentation":"

The type of alert target: one of \"SNS\".

", - "enum":["SNS"] - }, - "AlertTargets":{ - "type":"map", - "key":{"shape":"AlertTargetType"}, - "value":{"shape":"AlertTarget"} - }, - "AllowAutoRegistration":{"type":"boolean"}, - "Allowed":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

A list of policies that allowed the authentication.

" - } - }, - "documentation":"

Contains information that allowed the authorization.

" - }, - "AscendingOrder":{"type":"boolean"}, - "AssociateTargetsWithJobRequest":{ - "type":"structure", - "required":[ - "targets", - "jobId" - ], - "members":{ - "targets":{ - "shape":"JobTargets", - "documentation":"

A list of thing group ARNs that define the targets of the job.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "comment":{ - "shape":"Comment", - "documentation":"

An optional comment string describing why the job was associated with the targets.

" - } - } - }, - "AssociateTargetsWithJobResponse":{ - "type":"structure", - "members":{ - "jobArn":{ - "shape":"JobArn", - "documentation":"

An ARN identifying the job.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "description":{ - "shape":"JobDescription", - "documentation":"

A short text description of the job.

" - } - } - }, - "AttachPolicyRequest":{ - "type":"structure", - "required":[ - "policyName", - "target" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy to attach.

", - "location":"uri", - "locationName":"policyName" - }, - "target":{ - "shape":"PolicyTarget", - "documentation":"

The identity to which the policy is attached.

" - } - } - }, - "AttachPrincipalPolicyRequest":{ - "type":"structure", - "required":[ - "policyName", - "principal" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - }, - "principal":{ - "shape":"Principal", - "documentation":"

The principal, which can be a certificate ARN (as returned from the CreateCertificate operation) or an Amazon Cognito ID.

", - "location":"header", - "locationName":"x-amzn-iot-principal" - } - }, - "documentation":"

The input for the AttachPrincipalPolicy operation.

" - }, - "AttachSecurityProfileRequest":{ - "type":"structure", - "required":[ - "securityProfileName", - "securityProfileTargetArn" - ], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The security profile that is attached.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "securityProfileTargetArn":{ - "shape":"SecurityProfileTargetArn", - "documentation":"

The ARN of the target (thing group) to which the security profile is attached.

", - "location":"querystring", - "locationName":"securityProfileTargetArn" - } - } - }, - "AttachSecurityProfileResponse":{ - "type":"structure", - "members":{ - } - }, - "AttachThingPrincipalRequest":{ - "type":"structure", - "required":[ - "thingName", - "principal" - ], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - }, - "principal":{ - "shape":"Principal", - "documentation":"

The principal, such as a certificate or other credential.

", - "location":"header", - "locationName":"x-amzn-principal" - } - }, - "documentation":"

The input for the AttachThingPrincipal operation.

" - }, - "AttachThingPrincipalResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output from the AttachThingPrincipal operation.

" - }, - "AttributeName":{ - "type":"string", - "max":128, - "pattern":"[a-zA-Z0-9_.,@/:#-]+" - }, - "AttributePayload":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"Attributes", - "documentation":"

A JSON string containing up to three key-value pair in JSON format. For example:

{\\\"attributes\\\":{\\\"string1\\\":\\\"string2\\\"}}

" - }, - "merge":{ - "shape":"Flag", - "documentation":"

Specifies whether the list of attributes provided in the AttributePayload is merged with the attributes stored in the registry, instead of overwriting them.

To remove an attribute, call UpdateThing with an empty attribute value.

The merge attribute is only valid when calling UpdateThing.

" - } - }, - "documentation":"

The attribute payload.

" - }, - "AttributeValue":{ - "type":"string", - "max":800, - "pattern":"[a-zA-Z0-9_.,@/:#-]*" - }, - "Attributes":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "AttributesMap":{ - "type":"map", - "key":{"shape":"Key"}, - "value":{"shape":"Value"} - }, - "AuditCheckConfiguration":{ - "type":"structure", - "members":{ - "enabled":{ - "shape":"Enabled", - "documentation":"

True if this audit check is enabled for this account.

" - } - }, - "documentation":"

Which audit checks are enabled and disabled for this account.

" - }, - "AuditCheckConfigurations":{ - "type":"map", - "key":{"shape":"AuditCheckName"}, - "value":{"shape":"AuditCheckConfiguration"} - }, - "AuditCheckDetails":{ - "type":"structure", - "members":{ - "checkRunStatus":{ - "shape":"AuditCheckRunStatus", - "documentation":"

The completion status of this check, one of \"IN_PROGRESS\", \"WAITING_FOR_DATA_COLLECTION\", \"CANCELED\", \"COMPLETED_COMPLIANT\", \"COMPLETED_NON_COMPLIANT\", or \"FAILED\".

" - }, - "checkCompliant":{ - "shape":"CheckCompliant", - "documentation":"

True if the check completed and found all resources compliant.

" - }, - "totalResourcesCount":{ - "shape":"TotalResourcesCount", - "documentation":"

The number of resources on which the check was performed.

" - }, - "nonCompliantResourcesCount":{ - "shape":"NonCompliantResourcesCount", - "documentation":"

The number of resources that the check found non-compliant.

" - }, - "errorCode":{ - "shape":"ErrorCode", - "documentation":"

The code of any error encountered when performing this check during this audit. One of \"INSUFFICIENT_PERMISSIONS\", or \"AUDIT_CHECK_DISABLED\".

" - }, - "message":{ - "shape":"ErrorMessage", - "documentation":"

The message associated with any error encountered when performing this check during this audit.

" - } - }, - "documentation":"

Information about the audit check.

" - }, - "AuditCheckName":{ - "type":"string", - "documentation":"

An audit check name. Checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks including those that are enabled or UpdateAccountAuditConfiguration to select which checks are enabled.)

" - }, - "AuditCheckRunStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "WAITING_FOR_DATA_COLLECTION", - "CANCELED", - "COMPLETED_COMPLIANT", - "COMPLETED_NON_COMPLIANT", - "FAILED" - ] - }, - "AuditDetails":{ - "type":"map", - "key":{"shape":"AuditCheckName"}, - "value":{"shape":"AuditCheckDetails"} - }, - "AuditFinding":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

The ID of the audit that generated this result (finding)

" - }, - "checkName":{ - "shape":"AuditCheckName", - "documentation":"

The audit check that generated this result.

" - }, - "taskStartTime":{ - "shape":"Timestamp", - "documentation":"

The time the audit started.

" - }, - "findingTime":{ - "shape":"Timestamp", - "documentation":"

The time the result (finding) was discovered.

" - }, - "severity":{ - "shape":"AuditFindingSeverity", - "documentation":"

The severity of the result (finding).

" - }, - "nonCompliantResource":{ - "shape":"NonCompliantResource", - "documentation":"

The resource that was found to be non-compliant with the audit check.

" - }, - "relatedResources":{ - "shape":"RelatedResources", - "documentation":"

The list of related resources.

" - }, - "reasonForNonCompliance":{ - "shape":"ReasonForNonCompliance", - "documentation":"

The reason the resource was non-compliant.

" - }, - "reasonForNonComplianceCode":{ - "shape":"ReasonForNonComplianceCode", - "documentation":"

A code which indicates the reason that the resource was non-compliant.

" - } - }, - "documentation":"

The findings (results) of the audit.

" - }, - "AuditFindingSeverity":{ - "type":"string", - "enum":[ - "CRITICAL", - "HIGH", - "MEDIUM", - "LOW" - ] - }, - "AuditFindings":{ - "type":"list", - "member":{"shape":"AuditFinding"} - }, - "AuditFrequency":{ - "type":"string", - "enum":[ - "DAILY", - "WEEKLY", - "BIWEEKLY", - "MONTHLY" - ] - }, - "AuditNotificationTarget":{ - "type":"structure", - "members":{ - "targetArn":{ - "shape":"TargetArn", - "documentation":"

The ARN of the target (SNS topic) to which audit notifications are sent.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that grants permission to send notifications to the target.

" - }, - "enabled":{ - "shape":"Enabled", - "documentation":"

True if notifications to the target are enabled.

" - } - }, - "documentation":"

Information about the targets to which audit notifications are sent.

" - }, - "AuditNotificationTargetConfigurations":{ - "type":"map", - "key":{"shape":"AuditNotificationType"}, - "value":{"shape":"AuditNotificationTarget"} - }, - "AuditNotificationType":{ - "type":"string", - "enum":["SNS"] - }, - "AuditTaskId":{ - "type":"string", - "max":40, - "min":1, - "pattern":"[a-zA-Z0-9\\-]+" - }, - "AuditTaskMetadata":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

The ID of this audit.

" - }, - "taskStatus":{ - "shape":"AuditTaskStatus", - "documentation":"

The status of this audit: one of \"IN_PROGRESS\", \"COMPLETED\", \"FAILED\" or \"CANCELED\".

" - }, - "taskType":{ - "shape":"AuditTaskType", - "documentation":"

The type of this audit: one of \"ON_DEMAND_AUDIT_TASK\" or \"SCHEDULED_AUDIT_TASK\".

" - } - }, - "documentation":"

The audits that were performed.

" - }, - "AuditTaskMetadataList":{ - "type":"list", - "member":{"shape":"AuditTaskMetadata"} - }, - "AuditTaskStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "COMPLETED", - "FAILED", - "CANCELED" - ] - }, - "AuditTaskType":{ - "type":"string", - "enum":[ - "ON_DEMAND_AUDIT_TASK", - "SCHEDULED_AUDIT_TASK" - ] - }, - "AuthDecision":{ - "type":"string", - "enum":[ - "ALLOWED", - "EXPLICIT_DENY", - "IMPLICIT_DENY" - ] - }, - "AuthInfo":{ - "type":"structure", - "members":{ - "actionType":{ - "shape":"ActionType", - "documentation":"

The type of action for which the principal is being authorized.

" - }, - "resources":{ - "shape":"Resources", - "documentation":"

The resources for which the principal is being authorized to perform the specified action.

" - } - }, - "documentation":"

A collection of authorization information.

" - }, - "AuthInfos":{ - "type":"list", - "member":{"shape":"AuthInfo"}, - "max":10, - "min":1 - }, - "AuthResult":{ - "type":"structure", - "members":{ - "authInfo":{ - "shape":"AuthInfo", - "documentation":"

Authorization information.

" - }, - "allowed":{ - "shape":"Allowed", - "documentation":"

The policies and statements that allowed the specified action.

" - }, - "denied":{ - "shape":"Denied", - "documentation":"

The policies and statements that denied the specified action.

" - }, - "authDecision":{ - "shape":"AuthDecision", - "documentation":"

The final authorization decision of this scenario. Multiple statements are taken into account when determining the authorization decision. An explicit deny statement can override multiple allow statements.

" - }, - "missingContextValues":{ - "shape":"MissingContextValues", - "documentation":"

Contains any missing context values found while evaluating policy.

" - } - }, - "documentation":"

The authorizer result.

" - }, - "AuthResults":{ - "type":"list", - "member":{"shape":"AuthResult"} - }, - "AuthorizerArn":{"type":"string"}, - "AuthorizerDescription":{ - "type":"structure", - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

" - }, - "authorizerArn":{ - "shape":"AuthorizerArn", - "documentation":"

The authorizer ARN.

" - }, - "authorizerFunctionArn":{ - "shape":"AuthorizerFunctionArn", - "documentation":"

The authorizer's Lambda function ARN.

" - }, - "tokenKeyName":{ - "shape":"TokenKeyName", - "documentation":"

The key used to extract the token from the HTTP headers.

" - }, - "tokenSigningPublicKeys":{ - "shape":"PublicKeyMap", - "documentation":"

The public keys used to validate the token signature returned by your custom authentication service.

" - }, - "status":{ - "shape":"AuthorizerStatus", - "documentation":"

The status of the authorizer.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The UNIX timestamp of when the authorizer was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The UNIX timestamp of when the authorizer was last updated.

" - } - }, - "documentation":"

The authorizer description.

" - }, - "AuthorizerFunctionArn":{"type":"string"}, - "AuthorizerName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w=,@-]+" - }, - "AuthorizerStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE" - ] - }, - "AuthorizerSummary":{ - "type":"structure", - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

" - }, - "authorizerArn":{ - "shape":"AuthorizerArn", - "documentation":"

The authorizer ARN.

" - } - }, - "documentation":"

The authorizer summary.

" - }, - "Authorizers":{ - "type":"list", - "member":{"shape":"AuthorizerSummary"} - }, - "AutoRegistrationStatus":{ - "type":"string", - "enum":[ - "ENABLE", - "DISABLE" - ] - }, - "AwsAccountId":{ - "type":"string", - "max":12, - "min":12, - "pattern":"[0-9]+" - }, - "AwsArn":{"type":"string"}, - "AwsIotJobArn":{"type":"string"}, - "AwsIotJobId":{"type":"string"}, - "AwsIotSqlVersion":{"type":"string"}, - "Behavior":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"BehaviorName", - "documentation":"

The name you have given to the behavior.

" - }, - "metric":{ - "shape":"BehaviorMetric", - "documentation":"

What is measured by the behavior.

" - }, - "criteria":{ - "shape":"BehaviorCriteria", - "documentation":"

The criteria that determine if a device is behaving normally in regard to the metric.

" - } - }, - "documentation":"

A Device Defender security profile behavior.

" - }, - "BehaviorCriteria":{ - "type":"structure", - "members":{ - "comparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The operator that relates the thing measured (metric) to the criteria (value).

" - }, - "value":{ - "shape":"MetricValue", - "documentation":"

The value to be compared with the metric.

" - }, - "durationSeconds":{ - "shape":"DurationSeconds", - "documentation":"

Use this to specify the period of time over which the behavior is evaluated, for those criteria which have a time dimension (for example, NUM_MESSAGES_SENT).

" - } - }, - "documentation":"

The criteria by which the behavior is determined to be normal.

" - }, - "BehaviorMetric":{"type":"string"}, - "BehaviorName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "Behaviors":{ - "type":"list", - "member":{"shape":"Behavior"}, - "max":100 - }, - "Boolean":{"type":"boolean"}, - "BucketName":{"type":"string"}, - "CACertificate":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The ARN of the CA certificate.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the CA certificate.

" - }, - "status":{ - "shape":"CACertificateStatus", - "documentation":"

The status of the CA certificate.

The status value REGISTER_INACTIVE is deprecated and should not be used.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date the CA certificate was created.

" - } - }, - "documentation":"

A CA certificate.

" - }, - "CACertificateDescription":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The CA certificate ARN.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The CA certificate ID.

" - }, - "status":{ - "shape":"CACertificateStatus", - "documentation":"

The status of a CA certificate.

" - }, - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

The CA certificate data, in PEM format.

" - }, - "ownedBy":{ - "shape":"AwsAccountId", - "documentation":"

The owner of the CA certificate.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date the CA certificate was created.

" - }, - "autoRegistrationStatus":{ - "shape":"AutoRegistrationStatus", - "documentation":"

Whether the CA certificate configured for auto registration of device certificates. Valid values are \"ENABLE\" and \"DISABLE\"

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the CA certificate was last modified.

" - }, - "customerVersion":{ - "shape":"CustomerVersion", - "documentation":"

The customer version of the CA certificate.

" - }, - "generationId":{ - "shape":"GenerationId", - "documentation":"

The generation ID of the CA certificate.

" - }, - "validity":{ - "shape":"CertificateValidity", - "documentation":"

When the CA certificate is valid.

" - } - }, - "documentation":"

Describes a CA certificate.

" - }, - "CACertificateStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE" - ] - }, - "CACertificates":{ - "type":"list", - "member":{"shape":"CACertificate"} - }, - "CancelAuditTaskRequest":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

The ID of the audit you want to cancel. You can only cancel an audit that is \"IN_PROGRESS\".

", - "location":"uri", - "locationName":"taskId" - } - } - }, - "CancelAuditTaskResponse":{ - "type":"structure", - "members":{ - } - }, - "CancelCertificateTransferRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - } - }, - "documentation":"

The input for the CancelCertificateTransfer operation.

" - }, - "CancelJobExecutionRequest":{ - "type":"structure", - "required":[ - "jobId", - "thingName" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The ID of the job to be canceled.

", - "location":"uri", - "locationName":"jobId" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing whose execution of the job will be canceled.

", - "location":"uri", - "locationName":"thingName" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

(Optional) If true the job execution will be canceled if it has status IN_PROGRESS or QUEUED, otherwise the job execution will be canceled only if it has status QUEUED. If you attempt to cancel a job execution that is IN_PROGRESS, and you do not set force to true, then an InvalidStateTransitionException will be thrown. The default is false.

Canceling a job execution which is \"IN_PROGRESS\", will cause the device to be unable to update the job execution status. Use caution and ensure that the device is able to recover to a valid state.

", - "location":"querystring", - "locationName":"force" - }, - "expectedVersion":{ - "shape":"ExpectedVersion", - "documentation":"

(Optional) The expected current version of the job execution. Each time you update the job execution, its version is incremented. If the version of the job execution stored in Jobs does not match, the update is rejected with a VersionMismatch error, and an ErrorResponse that contains the current job execution status data is returned. (This makes it unnecessary to perform a separate DescribeJobExecution request in order to obtain the job execution status data.)

" - }, - "statusDetails":{ - "shape":"DetailsMap", - "documentation":"

A collection of name/value pairs that describe the status of the job execution. If not specified, the statusDetails are unchanged. You can specify at most 10 name/value pairs.

" - } - } - }, - "CancelJobRequest":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "comment":{ - "shape":"Comment", - "documentation":"

An optional comment string describing why the job was canceled.

" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

(Optional) If true job executions with status \"IN_PROGRESS\" and \"QUEUED\" are canceled, otherwise only job executions with status \"QUEUED\" are canceled. The default is false.

Canceling a job which is \"IN_PROGRESS\", will cause a device which is executing the job to be unable to update the job execution status. Use caution and ensure that each device executing a job which is canceled is able to recover to a valid state.

", - "location":"querystring", - "locationName":"force" - } - } - }, - "CancelJobResponse":{ - "type":"structure", - "members":{ - "jobArn":{ - "shape":"JobArn", - "documentation":"

The job ARN.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "description":{ - "shape":"JobDescription", - "documentation":"

A short text description of the job.

" - } - } - }, - "CanceledChecksCount":{"type":"integer"}, - "CanceledThings":{"type":"integer"}, - "CannedAccessControlList":{ - "type":"string", - "enum":[ - "private", - "public-read", - "public-read-write", - "aws-exec-read", - "authenticated-read", - "bucket-owner-read", - "bucket-owner-full-control", - "log-delivery-write" - ] - }, - "Certificate":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The ARN of the certificate.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

" - }, - "status":{ - "shape":"CertificateStatus", - "documentation":"

The status of the certificate.

The status value REGISTER_INACTIVE is deprecated and should not be used.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date and time the certificate was created.

" - } - }, - "documentation":"

Information about a certificate.

" - }, - "CertificateArn":{"type":"string"}, - "CertificateConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

Unable to verify the CA certificate used to sign the device certificate you are attempting to register. This is happens when you have registered more than one CA certificate that has the same subject field and public key.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CertificateDescription":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The ARN of the certificate.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate.

" - }, - "caCertificateId":{ - "shape":"CertificateId", - "documentation":"

The certificate ID of the CA certificate used to sign this certificate.

" - }, - "status":{ - "shape":"CertificateStatus", - "documentation":"

The status of the certificate.

" - }, - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

The certificate data, in PEM format.

" - }, - "ownedBy":{ - "shape":"AwsAccountId", - "documentation":"

The ID of the AWS account that owns the certificate.

" - }, - "previousOwnedBy":{ - "shape":"AwsAccountId", - "documentation":"

The ID of the AWS account of the previous owner of the certificate.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date and time the certificate was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date and time the certificate was last modified.

" - }, - "customerVersion":{ - "shape":"CustomerVersion", - "documentation":"

The customer version of the certificate.

" - }, - "transferData":{ - "shape":"TransferData", - "documentation":"

The transfer data.

" - }, - "generationId":{ - "shape":"GenerationId", - "documentation":"

The generation ID of the certificate.

" - }, - "validity":{ - "shape":"CertificateValidity", - "documentation":"

When the certificate is valid.

" - } - }, - "documentation":"

Describes a certificate.

" - }, - "CertificateId":{ - "type":"string", - "max":64, - "min":64, - "pattern":"(0x)?[a-fA-F0-9]+" - }, - "CertificateName":{"type":"string"}, - "CertificatePem":{ - "type":"string", - "documentation":"

The PEM of a certificate.

", - "max":65536, - "min":1 - }, - "CertificateSigningRequest":{ - "type":"string", - "min":1 - }, - "CertificateStateException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The certificate operation is not allowed.

", - "error":{"httpStatusCode":406}, - "exception":true - }, - "CertificateStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE", - "REVOKED", - "PENDING_TRANSFER", - "REGISTER_INACTIVE", - "PENDING_ACTIVATION" - ] - }, - "CertificateValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Additional information about the exception.

" - } - }, - "documentation":"

The certificate is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "CertificateValidity":{ - "type":"structure", - "members":{ - "notBefore":{ - "shape":"DateType", - "documentation":"

The certificate is not valid before this date.

" - }, - "notAfter":{ - "shape":"DateType", - "documentation":"

The certificate is not valid after this date.

" - } - }, - "documentation":"

When the certificate is valid.

" - }, - "Certificates":{ - "type":"list", - "member":{"shape":"Certificate"} - }, - "ChannelName":{"type":"string"}, - "CheckCompliant":{"type":"boolean"}, - "Cidr":{ - "type":"string", - "max":43, - "min":2, - "pattern":"[a-fA-F0-9:\\.\\/]+" - }, - "Cidrs":{ - "type":"list", - "member":{"shape":"Cidr"} - }, - "ClearDefaultAuthorizerRequest":{ - "type":"structure", - "members":{ - } - }, - "ClearDefaultAuthorizerResponse":{ - "type":"structure", - "members":{ - } - }, - "ClientId":{"type":"string"}, - "CloudwatchAlarmAction":{ - "type":"structure", - "required":[ - "roleArn", - "alarmName", - "stateReason", - "stateValue" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The IAM role that allows access to the CloudWatch alarm.

" - }, - "alarmName":{ - "shape":"AlarmName", - "documentation":"

The CloudWatch alarm name.

" - }, - "stateReason":{ - "shape":"StateReason", - "documentation":"

The reason for the alarm change.

" - }, - "stateValue":{ - "shape":"StateValue", - "documentation":"

The value of the alarm state. Acceptable values are: OK, ALARM, INSUFFICIENT_DATA.

" - } - }, - "documentation":"

Describes an action that updates a CloudWatch alarm.

" - }, - "CloudwatchMetricAction":{ - "type":"structure", - "required":[ - "roleArn", - "metricNamespace", - "metricName", - "metricValue", - "metricUnit" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The IAM role that allows access to the CloudWatch metric.

" - }, - "metricNamespace":{ - "shape":"String", - "documentation":"

The CloudWatch metric namespace name.

" - }, - "metricName":{ - "shape":"String", - "documentation":"

The CloudWatch metric name.

" - }, - "metricValue":{ - "shape":"String", - "documentation":"

The CloudWatch metric value.

" - }, - "metricUnit":{ - "shape":"String", - "documentation":"

The metric unit supported by CloudWatch.

" - }, - "metricTimestamp":{ - "shape":"String", - "documentation":"

An optional Unix timestamp.

" - } - }, - "documentation":"

Describes an action that captures a CloudWatch metric.

" - }, - "Code":{"type":"string"}, - "CodeSigning":{ - "type":"structure", - "members":{ - "awsSignerJobId":{ - "shape":"SigningJobId", - "documentation":"

The ID of the AWSSignerJob which was created to sign the file.

" - }, - "customCodeSigning":{ - "shape":"CustomCodeSigning", - "documentation":"

A custom method for code signing a file.

" - } - }, - "documentation":"

Describes the method to use when code signing a file.

" - }, - "CodeSigningCertificateChain":{ - "type":"structure", - "members":{ - "stream":{ - "shape":"Stream", - "documentation":"

A stream of the certificate chain files.

" - }, - "certificateName":{ - "shape":"CertificateName", - "documentation":"

The name of the certificate.

" - }, - "inlineDocument":{ - "shape":"InlineDocument", - "documentation":"

A base64 encoded binary representation of the code signing certificate chain.

" - } - }, - "documentation":"

Describes the certificate chain being used when code signing a file.

" - }, - "CodeSigningSignature":{ - "type":"structure", - "members":{ - "stream":{ - "shape":"Stream", - "documentation":"

A stream of the code signing signature.

" - }, - "inlineDocument":{ - "shape":"Signature", - "documentation":"

A base64 encoded binary representation of the code signing signature.

" - } - }, - "documentation":"

Describes the signature for a file.

" - }, - "CognitoIdentityPoolId":{"type":"string"}, - "Comment":{ - "type":"string", - "max":2028, - "pattern":"[^\\p{C}]+" - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "less-than", - "less-than-equals", - "greater-than", - "greater-than-equals", - "in-cidr-set", - "not-in-cidr-set", - "in-port-set", - "not-in-port-set" - ] - }, - "CompliantChecksCount":{"type":"integer"}, - "Configuration":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Enabled", - "documentation":"

True to enable the configuration.

" - } - }, - "documentation":"

Configuration.

" - }, - "ConflictingResourceUpdateException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

A conflicting resource update exception. This exception is thrown when two pending updates cause a conflict.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "Count":{"type":"integer"}, - "CreateAuthorizerRequest":{ - "type":"structure", - "required":[ - "authorizerName", - "authorizerFunctionArn", - "tokenKeyName", - "tokenSigningPublicKeys" - ], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

", - "location":"uri", - "locationName":"authorizerName" - }, - "authorizerFunctionArn":{ - "shape":"AuthorizerFunctionArn", - "documentation":"

The ARN of the authorizer's Lambda function.

" - }, - "tokenKeyName":{ - "shape":"TokenKeyName", - "documentation":"

The name of the token key used to extract the token from the HTTP headers.

" - }, - "tokenSigningPublicKeys":{ - "shape":"PublicKeyMap", - "documentation":"

The public keys used to verify the digital signature returned by your custom authentication service.

" - }, - "status":{ - "shape":"AuthorizerStatus", - "documentation":"

The status of the create authorizer request.

" - } - } - }, - "CreateAuthorizerResponse":{ - "type":"structure", - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer's name.

" - }, - "authorizerArn":{ - "shape":"AuthorizerArn", - "documentation":"

The authorizer ARN.

" - } - } - }, - "CreateCertificateFromCsrRequest":{ - "type":"structure", - "required":["certificateSigningRequest"], - "members":{ - "certificateSigningRequest":{ - "shape":"CertificateSigningRequest", - "documentation":"

The certificate signing request (CSR).

" - }, - "setAsActive":{ - "shape":"SetAsActive", - "documentation":"

Specifies whether the certificate is active.

", - "location":"querystring", - "locationName":"setAsActive" - } - }, - "documentation":"

The input for the CreateCertificateFromCsr operation.

" - }, - "CreateCertificateFromCsrResponse":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The Amazon Resource Name (ARN) of the certificate. You can use the ARN as a principal for policy operations.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. Certificate management operations only take a certificateId.

" - }, - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

The certificate data, in PEM format.

" - } - }, - "documentation":"

The output from the CreateCertificateFromCsr operation.

" - }, - "CreateJobRequest":{ - "type":"structure", - "required":[ - "jobId", - "targets" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

A job identifier which must be unique for your AWS account. We recommend using a UUID. Alpha-numeric characters, \"-\" and \"_\" are valid for use here.

", - "location":"uri", - "locationName":"jobId" - }, - "targets":{ - "shape":"JobTargets", - "documentation":"

A list of things and thing groups to which the job should be sent.

" - }, - "documentSource":{ - "shape":"JobDocumentSource", - "documentation":"

An S3 link to the job document.

" - }, - "document":{ - "shape":"JobDocument", - "documentation":"

The job document.

" - }, - "description":{ - "shape":"JobDescription", - "documentation":"

A short text description of the job.

" - }, - "presignedUrlConfig":{ - "shape":"PresignedUrlConfig", - "documentation":"

Configuration information for pre-signed S3 URLs.

" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a thing when the thing is added to a target group, even after the job was completed by all things originally in the group.

" - }, - "jobExecutionsRolloutConfig":{ - "shape":"JobExecutionsRolloutConfig", - "documentation":"

Allows you to create a staged rollout of the job.

" - } - } - }, - "CreateJobResponse":{ - "type":"structure", - "members":{ - "jobArn":{ - "shape":"JobArn", - "documentation":"

The job ARN.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job.

" - }, - "description":{ - "shape":"JobDescription", - "documentation":"

The job description.

" - } - } - }, - "CreateKeysAndCertificateRequest":{ - "type":"structure", - "members":{ - "setAsActive":{ - "shape":"SetAsActive", - "documentation":"

Specifies whether the certificate is active.

", - "location":"querystring", - "locationName":"setAsActive" - } - }, - "documentation":"

The input for the CreateKeysAndCertificate operation.

" - }, - "CreateKeysAndCertificateResponse":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The ARN of the certificate.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. AWS IoT issues a default subject name for the certificate (for example, AWS IoT Certificate).

" - }, - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

The certificate data, in PEM format.

" - }, - "keyPair":{ - "shape":"KeyPair", - "documentation":"

The generated key pair.

" - } - }, - "documentation":"

The output of the CreateKeysAndCertificate operation.

" - }, - "CreateOTAUpdateRequest":{ - "type":"structure", - "required":[ - "otaUpdateId", - "targets", - "files", - "roleArn" - ], - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The ID of the OTA update to be created.

", - "location":"uri", - "locationName":"otaUpdateId" - }, - "description":{ - "shape":"OTAUpdateDescription", - "documentation":"

The description of the OTA update.

" - }, - "targets":{ - "shape":"Targets", - "documentation":"

The targeted devices to receive OTA updates.

" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the update will continue to run (CONTINUOUS), or will be complete after all the things specified as targets have completed the update (SNAPSHOT). If continuous, the update may also be run on a thing when a change is detected in a target. For example, an update will run on a thing when the thing is added to a target group, even after the update was completed by all things originally in the group. Valid values: CONTINUOUS | SNAPSHOT.

" - }, - "files":{ - "shape":"OTAUpdateFiles", - "documentation":"

The files to be streamed by the OTA update.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The IAM role that allows access to the AWS IoT Jobs service.

" - }, - "additionalParameters":{ - "shape":"AdditionalParameterMap", - "documentation":"

A list of additional OTA update parameters which are name-value pairs.

" - } - } - }, - "CreateOTAUpdateResponse":{ - "type":"structure", - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The OTA update ID.

" - }, - "awsIotJobId":{ - "shape":"AwsIotJobId", - "documentation":"

The AWS IoT job ID associated with the OTA update.

" - }, - "otaUpdateArn":{ - "shape":"OTAUpdateArn", - "documentation":"

The OTA update ARN.

" - }, - "awsIotJobArn":{ - "shape":"AwsIotJobArn", - "documentation":"

The AWS IoT job ARN associated with the OTA update.

" - }, - "otaUpdateStatus":{ - "shape":"OTAUpdateStatus", - "documentation":"

The OTA update status.

" - } - } - }, - "CreatePolicyRequest":{ - "type":"structure", - "required":[ - "policyName", - "policyDocument" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy. policyDocument must have a minimum length of 1, with a maximum length of 2048, excluding whitespace.

" - } - }, - "documentation":"

The input for the CreatePolicy operation.

" - }, - "CreatePolicyResponse":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

" - }, - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy.

" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

" - } - }, - "documentation":"

The output from the CreatePolicy operation.

" - }, - "CreatePolicyVersionRequest":{ - "type":"structure", - "required":[ - "policyName", - "policyDocument" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy. Minimum length of 1. Maximum length of 2048, excluding whitespace.

" - }, - "setAsDefault":{ - "shape":"SetAsDefault", - "documentation":"

Specifies whether the policy version is set as the default. When this parameter is true, the new policy version becomes the operative version (that is, the version that is in effect for the certificates to which the policy is attached).

", - "location":"querystring", - "locationName":"setAsDefault" - } - }, - "documentation":"

The input for the CreatePolicyVersion operation.

" - }, - "CreatePolicyVersionResponse":{ - "type":"structure", - "members":{ - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy.

" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

" - }, - "isDefaultVersion":{ - "shape":"IsDefaultVersion", - "documentation":"

Specifies whether the policy version is the default.

" - } - }, - "documentation":"

The output of the CreatePolicyVersion operation.

" - }, - "CreateRoleAliasRequest":{ - "type":"structure", - "required":[ - "roleAlias", - "roleArn" - ], - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias that points to a role ARN. This allows you to change the role without having to update the device.

", - "location":"uri", - "locationName":"roleAlias" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The role ARN.

" - }, - "credentialDurationSeconds":{ - "shape":"CredentialDurationSeconds", - "documentation":"

How long (in seconds) the credentials will be valid.

" - } - } - }, - "CreateRoleAliasResponse":{ - "type":"structure", - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias.

" - }, - "roleAliasArn":{ - "shape":"RoleAliasArn", - "documentation":"

The role alias ARN.

" - } - } - }, - "CreateScheduledAuditRequest":{ - "type":"structure", - "required":[ - "frequency", - "targetCheckNames", - "scheduledAuditName" - ], - "members":{ - "frequency":{ - "shape":"AuditFrequency", - "documentation":"

How often the scheduled audit takes place. Can be one of \"DAILY\", \"WEEKLY\", \"BIWEEKLY\" or \"MONTHLY\". The actual start time of each audit is determined by the system.

" - }, - "dayOfMonth":{ - "shape":"DayOfMonth", - "documentation":"

The day of the month on which the scheduled audit takes place. Can be \"1\" through \"31\" or \"LAST\". This field is required if the \"frequency\" parameter is set to \"MONTHLY\". If days 29-31 are specified, and the month does not have that many days, the audit takes place on the \"LAST\" day of the month.

" - }, - "dayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

The day of the week on which the scheduled audit takes place. Can be one of \"SUN\", \"MON\", \"TUE\", \"WED\", \"THU\", \"FRI\" or \"SAT\". This field is required if the \"frequency\" parameter is set to \"WEEKLY\" or \"BIWEEKLY\".

" - }, - "targetCheckNames":{ - "shape":"TargetAuditCheckNames", - "documentation":"

Which checks are performed during the scheduled audit. Checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks including those that are enabled or UpdateAccountAuditConfiguration to select which checks are enabled.)

" - }, - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name you want to give to the scheduled audit. (Max. 128 chars)

", - "location":"uri", - "locationName":"scheduledAuditName" - } - } - }, - "CreateScheduledAuditResponse":{ - "type":"structure", - "members":{ - "scheduledAuditArn":{ - "shape":"ScheduledAuditArn", - "documentation":"

The ARN of the scheduled audit.

" - } - } - }, - "CreateSecurityProfileRequest":{ - "type":"structure", - "required":[ - "securityProfileName", - "behaviors" - ], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name you are giving to the security profile.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "securityProfileDescription":{ - "shape":"SecurityProfileDescription", - "documentation":"

A description of the security profile.

" - }, - "behaviors":{ - "shape":"Behaviors", - "documentation":"

Specifies the behaviors that, when violated by a device (thing), cause an alert.

" - }, - "alertTargets":{ - "shape":"AlertTargets", - "documentation":"

Specifies the destinations to which alerts are sent. (Alerts are always sent to the console.) Alerts are generated when a device (thing) violates a behavior.

" - } - } - }, - "CreateSecurityProfileResponse":{ - "type":"structure", - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name you gave to the security profile.

" - }, - "securityProfileArn":{ - "shape":"SecurityProfileArn", - "documentation":"

The ARN of the security profile.

" - } - } - }, - "CreateStreamRequest":{ - "type":"structure", - "required":[ - "streamId", - "files", - "roleArn" - ], - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

", - "location":"uri", - "locationName":"streamId" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

A description of the stream.

" - }, - "files":{ - "shape":"StreamFiles", - "documentation":"

The files to stream.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

An IAM role that allows the IoT service principal assumes to access your S3 files.

" - } - } - }, - "CreateStreamResponse":{ - "type":"structure", - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

" - }, - "streamArn":{ - "shape":"StreamArn", - "documentation":"

The stream ARN.

" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

A description of the stream.

" - }, - "streamVersion":{ - "shape":"StreamVersion", - "documentation":"

The version of the stream.

" - } - } - }, - "CreateThingGroupRequest":{ - "type":"structure", - "required":["thingGroupName"], - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The thing group name to create.

", - "location":"uri", - "locationName":"thingGroupName" - }, - "parentGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The name of the parent thing group.

" - }, - "thingGroupProperties":{ - "shape":"ThingGroupProperties", - "documentation":"

The thing group properties.

" - } - } - }, - "CreateThingGroupResponse":{ - "type":"structure", - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The thing group name.

" - }, - "thingGroupArn":{ - "shape":"ThingGroupArn", - "documentation":"

The thing group ARN.

" - }, - "thingGroupId":{ - "shape":"ThingGroupId", - "documentation":"

The thing group ID.

" - } - } - }, - "CreateThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing to create.

", - "location":"uri", - "locationName":"thingName" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type associated with the new thing.

" - }, - "attributePayload":{ - "shape":"AttributePayload", - "documentation":"

The attribute payload, which consists of up to three name/value pairs in a JSON document. For example:

{\\\"attributes\\\":{\\\"string1\\\":\\\"string2\\\"}}

" - } - }, - "documentation":"

The input for the CreateThing operation.

" - }, - "CreateThingResponse":{ - "type":"structure", - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the new thing.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the new thing.

" - }, - "thingId":{ - "shape":"ThingId", - "documentation":"

The thing ID.

" - } - }, - "documentation":"

The output of the CreateThing operation.

" - }, - "CreateThingTypeRequest":{ - "type":"structure", - "required":["thingTypeName"], - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

", - "location":"uri", - "locationName":"thingTypeName" - }, - "thingTypeProperties":{ - "shape":"ThingTypeProperties", - "documentation":"

The ThingTypeProperties for the thing type to create. It contains information about the new thing type including a description, and a list of searchable thing attribute names.

" - } - }, - "documentation":"

The input for the CreateThingType operation.

" - }, - "CreateThingTypeResponse":{ - "type":"structure", - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

" - }, - "thingTypeArn":{ - "shape":"ThingTypeArn", - "documentation":"

The Amazon Resource Name (ARN) of the thing type.

" - }, - "thingTypeId":{ - "shape":"ThingTypeId", - "documentation":"

The thing type ID.

" - } - }, - "documentation":"

The output of the CreateThingType operation.

" - }, - "CreateTopicRuleRequest":{ - "type":"structure", - "required":[ - "ruleName", - "topicRulePayload" - ], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

", - "location":"uri", - "locationName":"ruleName" - }, - "topicRulePayload":{ - "shape":"TopicRulePayload", - "documentation":"

The rule payload.

" - } - }, - "documentation":"

The input for the CreateTopicRule operation.

", - "payload":"topicRulePayload" - }, - "CreatedAtDate":{"type":"timestamp"}, - "CreationDate":{"type":"timestamp"}, - "CredentialDurationSeconds":{ - "type":"integer", - "max":3600, - "min":900 - }, - "CustomCodeSigning":{ - "type":"structure", - "members":{ - "signature":{ - "shape":"CodeSigningSignature", - "documentation":"

The signature for the file.

" - }, - "certificateChain":{ - "shape":"CodeSigningCertificateChain", - "documentation":"

The certificate chain.

" - }, - "hashAlgorithm":{ - "shape":"HashAlgorithm", - "documentation":"

The hash algorithm used to code sign the file.

" - }, - "signatureAlgorithm":{ - "shape":"SignatureAlgorithm", - "documentation":"

The signature algorithm used to code sign the file.

" - } - }, - "documentation":"

Describes a custom method used to code sign a file.

" - }, - "CustomerVersion":{ - "type":"integer", - "min":1 - }, - "DateType":{"type":"timestamp"}, - "DayOfMonth":{ - "type":"string", - "pattern":"^([1-9]|[12][0-9]|3[01])$|^LAST$" - }, - "DayOfWeek":{ - "type":"string", - "enum":[ - "SUN", - "MON", - "TUE", - "WED", - "THU", - "FRI", - "SAT" - ] - }, - "DeleteAccountAuditConfigurationRequest":{ - "type":"structure", - "members":{ - "deleteScheduledAudits":{ - "shape":"DeleteScheduledAudits", - "documentation":"

If true, all scheduled audits are deleted.

", - "location":"querystring", - "locationName":"deleteScheduledAudits" - } - } - }, - "DeleteAccountAuditConfigurationResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteAuthorizerRequest":{ - "type":"structure", - "required":["authorizerName"], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The name of the authorizer to delete.

", - "location":"uri", - "locationName":"authorizerName" - } - } - }, - "DeleteAuthorizerResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteCACertificateRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate to delete. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"caCertificateId" - } - }, - "documentation":"

Input for the DeleteCACertificate operation.

" - }, - "DeleteCACertificateResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the DeleteCACertificate operation.

" - }, - "DeleteCertificateRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - }, - "forceDelete":{ - "shape":"ForceDelete", - "documentation":"

Forces a certificate request to be deleted.

", - "location":"querystring", - "locationName":"forceDelete" - } - }, - "documentation":"

The input for the DeleteCertificate operation.

" - }, - "DeleteConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

You can't delete the resource because it is attached to one or more resources.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DeleteJobExecutionRequest":{ - "type":"structure", - "required":[ - "jobId", - "thingName", - "executionNumber" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The ID of the job whose execution on a particular device will be deleted.

", - "location":"uri", - "locationName":"jobId" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing whose job execution will be deleted.

", - "location":"uri", - "locationName":"thingName" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

The ID of the job execution to be deleted. The executionNumber refers to the execution of a particular job on a particular device.

Note that once a job execution is deleted, the executionNumber may be reused by IoT, so be sure you get and use the correct value here.

", - "location":"uri", - "locationName":"executionNumber" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

(Optional) When true, you can delete a job execution which is \"IN_PROGRESS\". Otherwise, you can only delete a job execution which is in a terminal state (\"SUCCEEDED\", \"FAILED\", \"REJECTED\", \"REMOVED\" or \"CANCELED\") or an exception will occur. The default is false.

Deleting a job execution which is \"IN_PROGRESS\", will cause the device to be unable to access job information or update the job execution status. Use caution and ensure that the device is able to recover to a valid state.

", - "location":"querystring", - "locationName":"force" - } - } - }, - "DeleteJobRequest":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The ID of the job to be deleted.

After a job deletion is completed, you may reuse this jobId when you create a new job. However, this is not recommended, and you must ensure that your devices are not using the jobId to refer to the deleted job.

", - "location":"uri", - "locationName":"jobId" - }, - "force":{ - "shape":"ForceFlag", - "documentation":"

(Optional) When true, you can delete a job which is \"IN_PROGRESS\". Otherwise, you can only delete a job which is in a terminal state (\"COMPLETED\" or \"CANCELED\") or an exception will occur. The default is false.

Deleting a job which is \"IN_PROGRESS\", will cause a device which is executing the job to be unable to access job information or update the job execution status. Use caution and ensure that each device executing a job which is deleted is able to recover to a valid state.

", - "location":"querystring", - "locationName":"force" - } - } - }, - "DeleteOTAUpdateRequest":{ - "type":"structure", - "required":["otaUpdateId"], - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The OTA update ID to delete.

", - "location":"uri", - "locationName":"otaUpdateId" - } - } - }, - "DeleteOTAUpdateResponse":{ - "type":"structure", - "members":{ - } - }, - "DeletePolicyRequest":{ - "type":"structure", - "required":["policyName"], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy to delete.

", - "location":"uri", - "locationName":"policyName" - } - }, - "documentation":"

The input for the DeletePolicy operation.

" - }, - "DeletePolicyVersionRequest":{ - "type":"structure", - "required":[ - "policyName", - "policyVersionId" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

", - "location":"uri", - "locationName":"policyName" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

", - "location":"uri", - "locationName":"policyVersionId" - } - }, - "documentation":"

The input for the DeletePolicyVersion operation.

" - }, - "DeleteRegistrationCodeRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

The input for the DeleteRegistrationCode operation.

" - }, - "DeleteRegistrationCodeResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the DeleteRegistrationCode operation.

" - }, - "DeleteRoleAliasRequest":{ - "type":"structure", - "required":["roleAlias"], - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias to delete.

", - "location":"uri", - "locationName":"roleAlias" - } - } - }, - "DeleteRoleAliasResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteScheduledAuditRequest":{ - "type":"structure", - "required":["scheduledAuditName"], - "members":{ - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit you want to delete.

", - "location":"uri", - "locationName":"scheduledAuditName" - } - } - }, - "DeleteScheduledAuditResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteScheduledAudits":{"type":"boolean"}, - "DeleteSecurityProfileRequest":{ - "type":"structure", - "required":["securityProfileName"], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile to be deleted.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the security profile. A new version is generated whenever the security profile is updated. If you specify a value that is different than the actual version, a VersionConflictException is thrown.

", - "location":"querystring", - "locationName":"expectedVersion" - } - } - }, - "DeleteSecurityProfileResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteStreamRequest":{ - "type":"structure", - "required":["streamId"], - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

", - "location":"uri", - "locationName":"streamId" - } - } - }, - "DeleteStreamResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteThingGroupRequest":{ - "type":"structure", - "required":["thingGroupName"], - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The name of the thing group to delete.

", - "location":"uri", - "locationName":"thingGroupName" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the thing group to delete.

", - "location":"querystring", - "locationName":"expectedVersion" - } - } - }, - "DeleteThingGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing to delete.

", - "location":"uri", - "locationName":"thingName" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the thing record in the registry. If the version of the record in the registry does not match the expected version specified in the request, the DeleteThing request is rejected with a VersionConflictException.

", - "location":"querystring", - "locationName":"expectedVersion" - } - }, - "documentation":"

The input for the DeleteThing operation.

" - }, - "DeleteThingResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output of the DeleteThing operation.

" - }, - "DeleteThingTypeRequest":{ - "type":"structure", - "required":["thingTypeName"], - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

", - "location":"uri", - "locationName":"thingTypeName" - } - }, - "documentation":"

The input for the DeleteThingType operation.

" - }, - "DeleteThingTypeResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the DeleteThingType operation.

" - }, - "DeleteTopicRuleRequest":{ - "type":"structure", - "required":["ruleName"], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

", - "location":"uri", - "locationName":"ruleName" - } - }, - "documentation":"

The input for the DeleteTopicRule operation.

" - }, - "DeleteV2LoggingLevelRequest":{ - "type":"structure", - "required":[ - "targetType", - "targetName" - ], - "members":{ - "targetType":{ - "shape":"LogTargetType", - "documentation":"

The type of resource for which you are configuring logging. Must be THING_Group.

", - "location":"querystring", - "locationName":"targetType" - }, - "targetName":{ - "shape":"LogTargetName", - "documentation":"

The name of the resource for which you are configuring logging.

", - "location":"querystring", - "locationName":"targetName" - } - } - }, - "DeliveryStreamName":{"type":"string"}, - "Denied":{ - "type":"structure", - "members":{ - "implicitDeny":{ - "shape":"ImplicitDeny", - "documentation":"

Information that implicitly denies the authorization. When a policy doesn't explicitly deny or allow an action on a resource it is considered an implicit deny.

" - }, - "explicitDeny":{ - "shape":"ExplicitDeny", - "documentation":"

Information that explicitly denies the authorization.

" - } - }, - "documentation":"

Contains information that denied the authorization.

" - }, - "DeprecateThingTypeRequest":{ - "type":"structure", - "required":["thingTypeName"], - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type to deprecate.

", - "location":"uri", - "locationName":"thingTypeName" - }, - "undoDeprecate":{ - "shape":"UndoDeprecate", - "documentation":"

Whether to undeprecate a deprecated thing type. If true, the thing type will not be deprecated anymore and you can associate it with things.

" - } - }, - "documentation":"

The input for the DeprecateThingType operation.

" - }, - "DeprecateThingTypeResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output for the DeprecateThingType operation.

" - }, - "DeprecationDate":{"type":"timestamp"}, - "DescribeAccountAuditConfigurationRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeAccountAuditConfigurationResponse":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that grants permission to AWS IoT to access information about your devices, policies, certificates and other items as necessary when performing an audit.

On the first call to UpdateAccountAuditConfiguration this parameter is required.

" - }, - "auditNotificationTargetConfigurations":{ - "shape":"AuditNotificationTargetConfigurations", - "documentation":"

Information about the targets to which audit notifications are sent for this account.

" - }, - "auditCheckConfigurations":{ - "shape":"AuditCheckConfigurations", - "documentation":"

Which audit checks are enabled and disabled for this account.

" - } - } - }, - "DescribeAuditTaskRequest":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

The ID of the audit whose information you want to get.

", - "location":"uri", - "locationName":"taskId" - } - } - }, - "DescribeAuditTaskResponse":{ - "type":"structure", - "members":{ - "taskStatus":{ - "shape":"AuditTaskStatus", - "documentation":"

The status of the audit: one of \"IN_PROGRESS\", \"COMPLETED\", \"FAILED\", or \"CANCELED\".

" - }, - "taskType":{ - "shape":"AuditTaskType", - "documentation":"

The type of audit: \"ON_DEMAND_AUDIT_TASK\" or \"SCHEDULED_AUDIT_TASK\".

" - }, - "taskStartTime":{ - "shape":"Timestamp", - "documentation":"

The time the audit started.

" - }, - "taskStatistics":{ - "shape":"TaskStatistics", - "documentation":"

Statistical information about the audit.

" - }, - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit (only if the audit was a scheduled audit).

" - }, - "auditDetails":{ - "shape":"AuditDetails", - "documentation":"

Detailed information about each check performed during this audit.

" - } - } - }, - "DescribeAuthorizerRequest":{ - "type":"structure", - "required":["authorizerName"], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The name of the authorizer to describe.

", - "location":"uri", - "locationName":"authorizerName" - } - } - }, - "DescribeAuthorizerResponse":{ - "type":"structure", - "members":{ - "authorizerDescription":{ - "shape":"AuthorizerDescription", - "documentation":"

The authorizer description.

" - } - } - }, - "DescribeCACertificateRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The CA certificate identifier.

", - "location":"uri", - "locationName":"caCertificateId" - } - }, - "documentation":"

The input for the DescribeCACertificate operation.

" - }, - "DescribeCACertificateResponse":{ - "type":"structure", - "members":{ - "certificateDescription":{ - "shape":"CACertificateDescription", - "documentation":"

The CA certificate description.

" - }, - "registrationConfig":{ - "shape":"RegistrationConfig", - "documentation":"

Information about the registration configuration.

" - } - }, - "documentation":"

The output from the DescribeCACertificate operation.

" - }, - "DescribeCertificateRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - } - }, - "documentation":"

The input for the DescribeCertificate operation.

" - }, - "DescribeCertificateResponse":{ - "type":"structure", - "members":{ - "certificateDescription":{ - "shape":"CertificateDescription", - "documentation":"

The description of the certificate.

" - } - }, - "documentation":"

The output of the DescribeCertificate operation.

" - }, - "DescribeDefaultAuthorizerRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeDefaultAuthorizerResponse":{ - "type":"structure", - "members":{ - "authorizerDescription":{ - "shape":"AuthorizerDescription", - "documentation":"

The default authorizer's description.

" - } - } - }, - "DescribeEndpointRequest":{ - "type":"structure", - "members":{ - "endpointType":{ - "shape":"EndpointType", - "documentation":"

The endpoint type.

", - "location":"querystring", - "locationName":"endpointType" - } - }, - "documentation":"

The input for the DescribeEndpoint operation.

" - }, - "DescribeEndpointResponse":{ - "type":"structure", - "members":{ - "endpointAddress":{ - "shape":"EndpointAddress", - "documentation":"

The endpoint. The format of the endpoint is as follows: identifier.iot.region.amazonaws.com.

" - } - }, - "documentation":"

The output from the DescribeEndpoint operation.

" - }, - "DescribeEventConfigurationsRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeEventConfigurationsResponse":{ - "type":"structure", - "members":{ - "eventConfigurations":{ - "shape":"EventConfigurations", - "documentation":"

The event configurations.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The creation date of the event configuration.

" - }, - "lastModifiedDate":{ - "shape":"LastModifiedDate", - "documentation":"

The date the event configurations were last modified.

" - } - } - }, - "DescribeIndexRequest":{ - "type":"structure", - "required":["indexName"], - "members":{ - "indexName":{ - "shape":"IndexName", - "documentation":"

The index name.

", - "location":"uri", - "locationName":"indexName" - } - } - }, - "DescribeIndexResponse":{ - "type":"structure", - "members":{ - "indexName":{ - "shape":"IndexName", - "documentation":"

The index name.

" - }, - "indexStatus":{ - "shape":"IndexStatus", - "documentation":"

The index status.

" - }, - "schema":{ - "shape":"IndexSchema", - "documentation":"

Contains a value that specifies the type of indexing performed. Valid values are:

  1. REGISTRY – Your thing index will contain only registry data.

  2. REGISTRY_AND_SHADOW - Your thing index will contain registry and shadow data.

" - } - } - }, - "DescribeJobExecutionRequest":{ - "type":"structure", - "required":[ - "jobId", - "thingName" - ], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing on which the job execution is running.

", - "location":"uri", - "locationName":"thingName" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

A string (consisting of the digits \"0\" through \"9\" which is used to specify a particular job execution on a particular device.

", - "location":"querystring", - "locationName":"executionNumber" - } - } - }, - "DescribeJobExecutionResponse":{ - "type":"structure", - "members":{ - "execution":{ - "shape":"JobExecution", - "documentation":"

Information about the job execution.

" - } - } - }, - "DescribeJobRequest":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - } - } - }, - "DescribeJobResponse":{ - "type":"structure", - "members":{ - "documentSource":{ - "shape":"JobDocumentSource", - "documentation":"

An S3 link to the job document.

" - }, - "job":{ - "shape":"Job", - "documentation":"

Information about the job.

" - } - } - }, - "DescribeRoleAliasRequest":{ - "type":"structure", - "required":["roleAlias"], - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias to describe.

", - "location":"uri", - "locationName":"roleAlias" - } - } - }, - "DescribeRoleAliasResponse":{ - "type":"structure", - "members":{ - "roleAliasDescription":{ - "shape":"RoleAliasDescription", - "documentation":"

The role alias description.

" - } - } - }, - "DescribeScheduledAuditRequest":{ - "type":"structure", - "required":["scheduledAuditName"], - "members":{ - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit whose information you want to get.

", - "location":"uri", - "locationName":"scheduledAuditName" - } - } - }, - "DescribeScheduledAuditResponse":{ - "type":"structure", - "members":{ - "frequency":{ - "shape":"AuditFrequency", - "documentation":"

How often the scheduled audit takes place. One of \"DAILY\", \"WEEKLY\", \"BIWEEKLY\" or \"MONTHLY\". The actual start time of each audit is determined by the system.

" - }, - "dayOfMonth":{ - "shape":"DayOfMonth", - "documentation":"

The day of the month on which the scheduled audit takes place. Will be \"1\" through \"31\" or \"LAST\". If days 29-31 are specified, and the month does not have that many days, the audit takes place on the \"LAST\" day of the month.

" - }, - "dayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

The day of the week on which the scheduled audit takes place. One of \"SUN\", \"MON\", \"TUE\", \"WED\", \"THU\", \"FRI\" or \"SAT\".

" - }, - "targetCheckNames":{ - "shape":"TargetAuditCheckNames", - "documentation":"

Which checks are performed during the scheduled audit. (Note that checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks including those that are enabled or UpdateAccountAuditConfiguration to select which checks are enabled.)

" - }, - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit.

" - }, - "scheduledAuditArn":{ - "shape":"ScheduledAuditArn", - "documentation":"

The ARN of the scheduled audit.

" - } - } - }, - "DescribeSecurityProfileRequest":{ - "type":"structure", - "required":["securityProfileName"], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile whose information you want to get.

", - "location":"uri", - "locationName":"securityProfileName" - } - } - }, - "DescribeSecurityProfileResponse":{ - "type":"structure", - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile.

" - }, - "securityProfileArn":{ - "shape":"SecurityProfileArn", - "documentation":"

The ARN of the security profile.

" - }, - "securityProfileDescription":{ - "shape":"SecurityProfileDescription", - "documentation":"

A description of the security profile (associated with the security profile when it was created or updated).

" - }, - "behaviors":{ - "shape":"Behaviors", - "documentation":"

Specifies the behaviors that, when violated by a device (thing), cause an alert.

" - }, - "alertTargets":{ - "shape":"AlertTargets", - "documentation":"

Where the alerts are sent. (Alerts are always sent to the console.)

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the security profile. A new version is generated whenever the security profile is updated.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The time the security profile was created.

" - }, - "lastModifiedDate":{ - "shape":"Timestamp", - "documentation":"

The time the security profile was last modified.

" - } - } - }, - "DescribeStreamRequest":{ - "type":"structure", - "required":["streamId"], - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

", - "location":"uri", - "locationName":"streamId" - } - } - }, - "DescribeStreamResponse":{ - "type":"structure", - "members":{ - "streamInfo":{ - "shape":"StreamInfo", - "documentation":"

Information about the stream.

" - } - } - }, - "DescribeThingGroupRequest":{ - "type":"structure", - "required":["thingGroupName"], - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The name of the thing group.

", - "location":"uri", - "locationName":"thingGroupName" - } - } - }, - "DescribeThingGroupResponse":{ - "type":"structure", - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The name of the thing group.

" - }, - "thingGroupId":{ - "shape":"ThingGroupId", - "documentation":"

The thing group ID.

" - }, - "thingGroupArn":{ - "shape":"ThingGroupArn", - "documentation":"

The thing group ARN.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the thing group.

" - }, - "thingGroupProperties":{ - "shape":"ThingGroupProperties", - "documentation":"

The thing group properties.

" - }, - "thingGroupMetadata":{ - "shape":"ThingGroupMetadata", - "documentation":"

Thing group metadata.

" - } - } - }, - "DescribeThingRegistrationTaskRequest":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"TaskId", - "documentation":"

The task ID.

", - "location":"uri", - "locationName":"taskId" - } - } - }, - "DescribeThingRegistrationTaskResponse":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"TaskId", - "documentation":"

The task ID.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The task creation date.

" - }, - "lastModifiedDate":{ - "shape":"LastModifiedDate", - "documentation":"

The date when the task was last modified.

" - }, - "templateBody":{ - "shape":"TemplateBody", - "documentation":"

The task's template.

" - }, - "inputFileBucket":{ - "shape":"RegistryS3BucketName", - "documentation":"

The S3 bucket that contains the input file.

" - }, - "inputFileKey":{ - "shape":"RegistryS3KeyName", - "documentation":"

The input file key.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The role ARN that grants access to the input file bucket.

" - }, - "status":{ - "shape":"Status", - "documentation":"

The status of the bulk thing provisioning task.

" - }, - "message":{ - "shape":"ErrorMessage", - "documentation":"

The message.

" - }, - "successCount":{ - "shape":"Count", - "documentation":"

The number of things successfully provisioned.

" - }, - "failureCount":{ - "shape":"Count", - "documentation":"

The number of things that failed to be provisioned.

" - }, - "percentageProgress":{ - "shape":"Percentage", - "documentation":"

The progress of the bulk provisioning task expressed as a percentage.

" - } - } - }, - "DescribeThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - } - }, - "documentation":"

The input for the DescribeThing operation.

" - }, - "DescribeThingResponse":{ - "type":"structure", - "members":{ - "defaultClientId":{ - "shape":"ClientId", - "documentation":"

The default client ID.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

" - }, - "thingId":{ - "shape":"ThingId", - "documentation":"

The ID of the thing to describe.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the thing to describe.

" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The thing type name.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The thing attributes.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The current version of the thing record in the registry.

To avoid unintentional changes to the information in the registry, you can pass the version information in the expectedVersion parameter of the UpdateThing and DeleteThing calls.

" - } - }, - "documentation":"

The output from the DescribeThing operation.

" - }, - "DescribeThingTypeRequest":{ - "type":"structure", - "required":["thingTypeName"], - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

", - "location":"uri", - "locationName":"thingTypeName" - } - }, - "documentation":"

The input for the DescribeThingType operation.

" - }, - "DescribeThingTypeResponse":{ - "type":"structure", - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

" - }, - "thingTypeId":{ - "shape":"ThingTypeId", - "documentation":"

The thing type ID.

" - }, - "thingTypeArn":{ - "shape":"ThingTypeArn", - "documentation":"

The thing type ARN.

" - }, - "thingTypeProperties":{ - "shape":"ThingTypeProperties", - "documentation":"

The ThingTypeProperties contains information about the thing type including description, and a list of searchable thing attribute names.

" - }, - "thingTypeMetadata":{ - "shape":"ThingTypeMetadata", - "documentation":"

The ThingTypeMetadata contains additional information about the thing type including: creation date and time, a value indicating whether the thing type is deprecated, and a date and time when it was deprecated.

" - } - }, - "documentation":"

The output for the DescribeThingType operation.

" - }, - "Description":{"type":"string"}, - "DetachPolicyRequest":{ - "type":"structure", - "required":[ - "policyName", - "target" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy to detach.

", - "location":"uri", - "locationName":"policyName" - }, - "target":{ - "shape":"PolicyTarget", - "documentation":"

The target from which the policy will be detached.

" - } - } - }, - "DetachPrincipalPolicyRequest":{ - "type":"structure", - "required":[ - "policyName", - "principal" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy to detach.

", - "location":"uri", - "locationName":"policyName" - }, - "principal":{ - "shape":"Principal", - "documentation":"

The principal.

If the principal is a certificate, specify the certificate ARN. If the principal is an Amazon Cognito identity, specify the identity ID.

", - "location":"header", - "locationName":"x-amzn-iot-principal" - } - }, - "documentation":"

The input for the DetachPrincipalPolicy operation.

" - }, - "DetachSecurityProfileRequest":{ - "type":"structure", - "required":[ - "securityProfileName", - "securityProfileTargetArn" - ], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The security profile that is detached.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "securityProfileTargetArn":{ - "shape":"SecurityProfileTargetArn", - "documentation":"

The ARN of the thing group from which the security profile is detached.

", - "location":"querystring", - "locationName":"securityProfileTargetArn" - } - } - }, - "DetachSecurityProfileResponse":{ - "type":"structure", - "members":{ - } - }, - "DetachThingPrincipalRequest":{ - "type":"structure", - "required":[ - "thingName", - "principal" - ], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - }, - "principal":{ - "shape":"Principal", - "documentation":"

If the principal is a certificate, this value must be ARN of the certificate. If the principal is an Amazon Cognito identity, this value must be the ID of the Amazon Cognito identity.

", - "location":"header", - "locationName":"x-amzn-principal" - } - }, - "documentation":"

The input for the DetachThingPrincipal operation.

" - }, - "DetachThingPrincipalResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output from the DetachThingPrincipal operation.

" - }, - "DetailsKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "DetailsMap":{ - "type":"map", - "key":{"shape":"DetailsKey"}, - "value":{"shape":"DetailsValue"} - }, - "DetailsValue":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[^\\p{C}]*+" - }, - "DisableAllLogs":{"type":"boolean"}, - "DisableTopicRuleRequest":{ - "type":"structure", - "required":["ruleName"], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule to disable.

", - "location":"uri", - "locationName":"ruleName" - } - }, - "documentation":"

The input for the DisableTopicRuleRequest operation.

" - }, - "DurationSeconds":{"type":"integer"}, - "DynamoDBAction":{ - "type":"structure", - "required":[ - "tableName", - "roleArn", - "hashKeyField", - "hashKeyValue" - ], - "members":{ - "tableName":{ - "shape":"TableName", - "documentation":"

The name of the DynamoDB table.

" - }, - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access to the DynamoDB table.

" - }, - "operation":{ - "shape":"DynamoOperation", - "documentation":"

The type of operation to be performed. This follows the substitution template, so it can be ${operation}, but the substitution must result in one of the following: INSERT, UPDATE, or DELETE.

" - }, - "hashKeyField":{ - "shape":"HashKeyField", - "documentation":"

The hash key name.

" - }, - "hashKeyValue":{ - "shape":"HashKeyValue", - "documentation":"

The hash key value.

" - }, - "hashKeyType":{ - "shape":"DynamoKeyType", - "documentation":"

The hash key type. Valid values are \"STRING\" or \"NUMBER\"

" - }, - "rangeKeyField":{ - "shape":"RangeKeyField", - "documentation":"

The range key name.

" - }, - "rangeKeyValue":{ - "shape":"RangeKeyValue", - "documentation":"

The range key value.

" - }, - "rangeKeyType":{ - "shape":"DynamoKeyType", - "documentation":"

The range key type. Valid values are \"STRING\" or \"NUMBER\"

" - }, - "payloadField":{ - "shape":"PayloadField", - "documentation":"

The action payload. This name can be customized.

" - } - }, - "documentation":"

Describes an action to write to a DynamoDB table.

The tableName, hashKeyField, and rangeKeyField values must match the values used when you created the table.

The hashKeyValue and rangeKeyvalue fields use a substitution template syntax. These templates provide data at runtime. The syntax is as follows: ${sql-expression}.

You can specify any valid expression in a WHERE or SELECT clause, including JSON properties, comparisons, calculations, and functions. For example, the following field uses the third level of the topic:

\"hashKeyValue\": \"${topic(3)}\"

The following field uses the timestamp:

\"rangeKeyValue\": \"${timestamp()}\"

" - }, - "DynamoDBv2Action":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access to the DynamoDB table.

" - }, - "putItem":{ - "shape":"PutItemInput", - "documentation":"

Specifies the DynamoDB table to which the message data will be written. For example:

{ \"dynamoDBv2\": { \"roleArn\": \"aws:iam:12341251:my-role\" \"putItem\": { \"tableName\": \"my-table\" } } }

Each attribute in the message payload will be written to a separate column in the DynamoDB database.

" - } - }, - "documentation":"

Describes an action to write to a DynamoDB table.

This DynamoDB action writes each attribute in the message payload into it's own column in the DynamoDB table.

" - }, - "DynamoKeyType":{ - "type":"string", - "enum":[ - "STRING", - "NUMBER" - ] - }, - "DynamoOperation":{"type":"string"}, - "EffectivePolicies":{ - "type":"list", - "member":{"shape":"EffectivePolicy"} - }, - "EffectivePolicy":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

" - }, - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The IAM policy document.

" - } - }, - "documentation":"

The policy that has the effect on the authorization results.

" - }, - "ElasticsearchAction":{ - "type":"structure", - "required":[ - "roleArn", - "endpoint", - "index", - "type", - "id" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The IAM role ARN that has access to Elasticsearch.

" - }, - "endpoint":{ - "shape":"ElasticsearchEndpoint", - "documentation":"

The endpoint of your Elasticsearch domain.

" - }, - "index":{ - "shape":"ElasticsearchIndex", - "documentation":"

The Elasticsearch index where you want to store your data.

" - }, - "type":{ - "shape":"ElasticsearchType", - "documentation":"

The type of document you are storing.

" - }, - "id":{ - "shape":"ElasticsearchId", - "documentation":"

The unique identifier for the document you are storing.

" - } - }, - "documentation":"

Describes an action that writes data to an Amazon Elasticsearch Service domain.

" - }, - "ElasticsearchEndpoint":{ - "type":"string", - "pattern":"https?://.*" - }, - "ElasticsearchId":{"type":"string"}, - "ElasticsearchIndex":{"type":"string"}, - "ElasticsearchType":{"type":"string"}, - "EnableTopicRuleRequest":{ - "type":"structure", - "required":["ruleName"], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the topic rule to enable.

", - "location":"uri", - "locationName":"ruleName" - } - }, - "documentation":"

The input for the EnableTopicRuleRequest operation.

" - }, - "Enabled":{"type":"boolean"}, - "EndpointAddress":{"type":"string"}, - "EndpointType":{"type":"string"}, - "ErrorCode":{"type":"string"}, - "ErrorInfo":{ - "type":"structure", - "members":{ - "code":{ - "shape":"Code", - "documentation":"

The error code.

" - }, - "message":{ - "shape":"OTAUpdateErrorMessage", - "documentation":"

The error message.

" - } - }, - "documentation":"

Error information.

" - }, - "ErrorMessage":{ - "type":"string", - "max":2048 - }, - "EventConfigurations":{ - "type":"map", - "key":{"shape":"EventType"}, - "value":{"shape":"Configuration"} - }, - "EventType":{ - "type":"string", - "enum":[ - "THING", - "THING_GROUP", - "THING_TYPE", - "THING_GROUP_MEMBERSHIP", - "THING_GROUP_HIERARCHY", - "THING_TYPE_ASSOCIATION", - "JOB", - "JOB_EXECUTION", - "POLICY", - "CERTIFICATE", - "CA_CERTIFICATE" - ] - }, - "ExecutionNamePrefix":{"type":"string"}, - "ExecutionNumber":{"type":"long"}, - "ExpectedVersion":{"type":"long"}, - "ExpiresInSec":{ - "type":"long", - "max":3600, - "min":60 - }, - "ExplicitDeny":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

The policies that denied the authorization.

" - } - }, - "documentation":"

Information that explicitly denies authorization.

" - }, - "FailedChecksCount":{"type":"integer"}, - "FailedThings":{"type":"integer"}, - "FileId":{ - "type":"integer", - "max":255, - "min":0 - }, - "FileName":{"type":"string"}, - "FirehoseAction":{ - "type":"structure", - "required":[ - "roleArn", - "deliveryStreamName" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The IAM role that grants access to the Amazon Kinesis Firehose stream.

" - }, - "deliveryStreamName":{ - "shape":"DeliveryStreamName", - "documentation":"

The delivery stream name.

" - }, - "separator":{ - "shape":"FirehoseSeparator", - "documentation":"

A character separator that will be used to separate records written to the Firehose stream. Valid values are: '\\n' (newline), '\\t' (tab), '\\r\\n' (Windows newline), ',' (comma).

" - } - }, - "documentation":"

Describes an action that writes data to an Amazon Kinesis Firehose stream.

" - }, - "FirehoseSeparator":{ - "type":"string", - "pattern":"([\\n\\t])|(\\r\\n)|(,)" - }, - "Flag":{"type":"boolean"}, - "ForceDelete":{"type":"boolean"}, - "ForceFlag":{"type":"boolean"}, - "Forced":{"type":"boolean"}, - "FunctionArn":{"type":"string"}, - "GEMaxResults":{ - "type":"integer", - "max":10000, - "min":1 - }, - "GenerationId":{"type":"string"}, - "GetEffectivePoliciesRequest":{ - "type":"structure", - "members":{ - "principal":{ - "shape":"Principal", - "documentation":"

The principal.

" - }, - "cognitoIdentityPoolId":{ - "shape":"CognitoIdentityPoolId", - "documentation":"

The Cognito identity pool ID.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing name.

", - "location":"querystring", - "locationName":"thingName" - } - } - }, - "GetEffectivePoliciesResponse":{ - "type":"structure", - "members":{ - "effectivePolicies":{ - "shape":"EffectivePolicies", - "documentation":"

The effective policies.

" - } - } - }, - "GetIndexingConfigurationRequest":{ - "type":"structure", - "members":{ - } - }, - "GetIndexingConfigurationResponse":{ - "type":"structure", - "members":{ - "thingIndexingConfiguration":{ - "shape":"ThingIndexingConfiguration", - "documentation":"

Thing indexing configuration.

" - } - } - }, - "GetJobDocumentRequest":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - } - } - }, - "GetJobDocumentResponse":{ - "type":"structure", - "members":{ - "document":{ - "shape":"JobDocument", - "documentation":"

The job document content.

" - } - } - }, - "GetLoggingOptionsRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

The input for the GetLoggingOptions operation.

" - }, - "GetLoggingOptionsResponse":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "logLevel":{ - "shape":"LogLevel", - "documentation":"

The logging level.

" - } - }, - "documentation":"

The output from the GetLoggingOptions operation.

" - }, - "GetOTAUpdateRequest":{ - "type":"structure", - "required":["otaUpdateId"], - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The OTA update ID.

", - "location":"uri", - "locationName":"otaUpdateId" - } - } - }, - "GetOTAUpdateResponse":{ - "type":"structure", - "members":{ - "otaUpdateInfo":{ - "shape":"OTAUpdateInfo", - "documentation":"

The OTA update info.

" - } - } - }, - "GetPolicyRequest":{ - "type":"structure", - "required":["policyName"], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

", - "location":"uri", - "locationName":"policyName" - } - }, - "documentation":"

The input for the GetPolicy operation.

" - }, - "GetPolicyResponse":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

" - }, - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy.

" - }, - "defaultVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The default policy version ID.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date the policy was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the policy was last modified.

" - }, - "generationId":{ - "shape":"GenerationId", - "documentation":"

The generation ID of the policy.

" - } - }, - "documentation":"

The output from the GetPolicy operation.

" - }, - "GetPolicyVersionRequest":{ - "type":"structure", - "required":[ - "policyName", - "policyVersionId" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

", - "location":"uri", - "locationName":"policyName" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

", - "location":"uri", - "locationName":"policyVersionId" - } - }, - "documentation":"

The input for the GetPolicyVersion operation.

" - }, - "GetPolicyVersionResponse":{ - "type":"structure", - "members":{ - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - }, - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The JSON document that describes the policy.

" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

" - }, - "isDefaultVersion":{ - "shape":"IsDefaultVersion", - "documentation":"

Specifies whether the policy version is the default.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date the policy version was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date the policy version was last modified.

" - }, - "generationId":{ - "shape":"GenerationId", - "documentation":"

The generation ID of the policy version.

" - } - }, - "documentation":"

The output from the GetPolicyVersion operation.

" - }, - "GetRegistrationCodeRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

The input to the GetRegistrationCode operation.

" - }, - "GetRegistrationCodeResponse":{ - "type":"structure", - "members":{ - "registrationCode":{ - "shape":"RegistrationCode", - "documentation":"

The CA certificate registration code.

" - } - }, - "documentation":"

The output from the GetRegistrationCode operation.

" - }, - "GetTopicRuleRequest":{ - "type":"structure", - "required":["ruleName"], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

", - "location":"uri", - "locationName":"ruleName" - } - }, - "documentation":"

The input for the GetTopicRule operation.

" - }, - "GetTopicRuleResponse":{ - "type":"structure", - "members":{ - "ruleArn":{ - "shape":"RuleArn", - "documentation":"

The rule ARN.

" - }, - "rule":{ - "shape":"TopicRule", - "documentation":"

The rule.

" - } - }, - "documentation":"

The output from the GetTopicRule operation.

" - }, - "GetV2LoggingOptionsRequest":{ - "type":"structure", - "members":{ - } - }, - "GetV2LoggingOptionsResponse":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The IAM role ARN AWS IoT uses to write to your CloudWatch logs.

" - }, - "defaultLogLevel":{ - "shape":"LogLevel", - "documentation":"

The default log level.

" - }, - "disableAllLogs":{ - "shape":"DisableAllLogs", - "documentation":"

Disables all logs.

" - } - } - }, - "GroupNameAndArn":{ - "type":"structure", - "members":{ - "groupName":{ - "shape":"ThingGroupName", - "documentation":"

The group name.

" - }, - "groupArn":{ - "shape":"ThingGroupArn", - "documentation":"

The group ARN.

" - } - }, - "documentation":"

The name and ARN of a group.

" - }, - "HashAlgorithm":{"type":"string"}, - "HashKeyField":{"type":"string"}, - "HashKeyValue":{"type":"string"}, - "ImplicitDeny":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

Policies that don't contain a matching allow or deny statement for the specified action on the specified resource.

" - } - }, - "documentation":"

Information that implicitly denies authorization. When policy doesn't explicitly deny or allow an action on a resource it is considered an implicit deny.

" - }, - "InProgressChecksCount":{"type":"integer"}, - "InProgressThings":{"type":"integer"}, - "IndexName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "IndexNamesList":{ - "type":"list", - "member":{"shape":"IndexName"} - }, - "IndexNotReadyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The index is not ready.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "IndexSchema":{"type":"string"}, - "IndexStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "BUILDING", - "REBUILDING" - ] - }, - "InlineDocument":{"type":"string"}, - "InternalException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

An unexpected error has occurred.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

An unexpected error has occurred.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "InvalidQueryException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The query is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The request is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResponseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The response is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidStateTransitionException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

An attempt was made to change to an invalid state, for example by deleting a job or a job execution which is \"IN_PROGRESS\" without setting the force parameter.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "IotAnalyticsAction":{ - "type":"structure", - "members":{ - "channelArn":{ - "shape":"AwsArn", - "documentation":"

(deprecated) The ARN of the IoT Analytics channel to which message data will be sent.

" - }, - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the IoT Analytics channel to which message data will be sent.

" - }, - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the role which has a policy that grants IoT Analytics permission to send message data via IoT Analytics (iotanalytics:BatchPutMessage).

" - } - }, - "documentation":"

Sends messge data to an AWS IoT Analytics channel.

" - }, - "IsAuthenticated":{"type":"boolean"}, - "IsDefaultVersion":{"type":"boolean"}, - "IsDisabled":{"type":"boolean"}, - "Job":{ - "type":"structure", - "members":{ - "jobArn":{ - "shape":"JobArn", - "documentation":"

An ARN identifying the job with format \"arn:aws:iot:region:account:job/jobId\".

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.

" - }, - "status":{ - "shape":"JobStatus", - "documentation":"

The status of the job, one of IN_PROGRESS, CANCELED, or COMPLETED.

" - }, - "forceCanceled":{ - "shape":"Forced", - "documentation":"

Will be true if the job was canceled with the optional force parameter set to true.

" - }, - "comment":{ - "shape":"Comment", - "documentation":"

If the job was updated, describes the reason for the update.

" - }, - "targets":{ - "shape":"JobTargets", - "documentation":"

A list of IoT things and thing groups to which the job should be sent.

" - }, - "description":{ - "shape":"JobDescription", - "documentation":"

A short text description of the job.

" - }, - "presignedUrlConfig":{ - "shape":"PresignedUrlConfig", - "documentation":"

Configuration for pre-signed S3 URLs.

" - }, - "jobExecutionsRolloutConfig":{ - "shape":"JobExecutionsRolloutConfig", - "documentation":"

Allows you to create a staged rollout of a job.

" - }, - "createdAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job was created.

" - }, - "lastUpdatedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job was last updated.

" - }, - "completedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job was completed.

" - }, - "jobProcessDetails":{ - "shape":"JobProcessDetails", - "documentation":"

Details about the job process.

" - } - }, - "documentation":"

The Job object contains details about a job.

" - }, - "JobArn":{"type":"string"}, - "JobDescription":{ - "type":"string", - "max":2028, - "pattern":"[^\\p{C}]+" - }, - "JobDocument":{ - "type":"string", - "max":32768 - }, - "JobDocumentSource":{ - "type":"string", - "max":1350, - "min":1 - }, - "JobExecution":{ - "type":"structure", - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to the job when it was created.

" - }, - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The status of the job execution (IN_PROGRESS, QUEUED, FAILED, SUCCESS, CANCELED, or REJECTED).

" - }, - "forceCanceled":{ - "shape":"Forced", - "documentation":"

Will be true if the job execution was canceled with the optional force parameter set to true.

" - }, - "statusDetails":{ - "shape":"JobExecutionStatusDetails", - "documentation":"

A collection of name/value pairs that describe the status of the job execution.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the thing on which the job execution is running.

" - }, - "queuedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was queued.

" - }, - "startedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution started.

" - }, - "lastUpdatedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was last updated.

" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

A string (consisting of the digits \"0\" through \"9\") which identifies this particular job execution on this particular device. It can be used in commands which return or update job execution information.

" - }, - "versionNumber":{ - "shape":"VersionNumber", - "documentation":"

The version of the job execution. Job execution versions are incremented each time they are updated by a device.

" - } - }, - "documentation":"

The job execution object represents the execution of a job on a particular device.

" - }, - "JobExecutionStatus":{ - "type":"string", - "enum":[ - "QUEUED", - "IN_PROGRESS", - "SUCCEEDED", - "FAILED", - "REJECTED", - "REMOVED", - "CANCELED" - ] - }, - "JobExecutionStatusDetails":{ - "type":"structure", - "members":{ - "detailsMap":{ - "shape":"DetailsMap", - "documentation":"

The job execution status.

" - } - }, - "documentation":"

Details of the job execution status.

" - }, - "JobExecutionSummary":{ - "type":"structure", - "members":{ - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The status of the job execution.

" - }, - "queuedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was queued.

" - }, - "startedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution started.

" - }, - "lastUpdatedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job execution was last updated.

" - }, - "executionNumber":{ - "shape":"ExecutionNumber", - "documentation":"

A string (consisting of the digits \"0\" through \"9\") which identifies this particular job execution on this particular device. It can be used later in commands which return or update job execution information.

" - } - }, - "documentation":"

The job execution summary.

" - }, - "JobExecutionSummaryForJob":{ - "type":"structure", - "members":{ - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the thing on which the job execution is running.

" - }, - "jobExecutionSummary":{ - "shape":"JobExecutionSummary", - "documentation":"

Contains a subset of information about a job execution.

" - } - }, - "documentation":"

Contains a summary of information about job executions for a specific job.

" - }, - "JobExecutionSummaryForJobList":{ - "type":"list", - "member":{"shape":"JobExecutionSummaryForJob"} - }, - "JobExecutionSummaryForThing":{ - "type":"structure", - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "jobExecutionSummary":{ - "shape":"JobExecutionSummary", - "documentation":"

Contains a subset of information about a job execution.

" - } - }, - "documentation":"

The job execution summary for a thing.

" - }, - "JobExecutionSummaryForThingList":{ - "type":"list", - "member":{"shape":"JobExecutionSummaryForThing"} - }, - "JobExecutionsRolloutConfig":{ - "type":"structure", - "members":{ - "maximumPerMinute":{ - "shape":"MaxJobExecutionsPerMin", - "documentation":"

The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.

" - } - }, - "documentation":"

Allows you to create a staged rollout of a job.

" - }, - "JobId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "JobProcessDetails":{ - "type":"structure", - "members":{ - "processingTargets":{ - "shape":"ProcessingTargetNameList", - "documentation":"

The target devices to which the job execution is being rolled out. This value will be null after the job execution has finished rolling out to all the target devices.

" - }, - "numberOfCanceledThings":{ - "shape":"CanceledThings", - "documentation":"

The number of things that cancelled the job.

" - }, - "numberOfSucceededThings":{ - "shape":"SucceededThings", - "documentation":"

The number of things which successfully completed the job.

" - }, - "numberOfFailedThings":{ - "shape":"FailedThings", - "documentation":"

The number of things that failed executing the job.

" - }, - "numberOfRejectedThings":{ - "shape":"RejectedThings", - "documentation":"

The number of things that rejected the job.

" - }, - "numberOfQueuedThings":{ - "shape":"QueuedThings", - "documentation":"

The number of things that are awaiting execution of the job.

" - }, - "numberOfInProgressThings":{ - "shape":"InProgressThings", - "documentation":"

The number of things currently executing the job.

" - }, - "numberOfRemovedThings":{ - "shape":"RemovedThings", - "documentation":"

The number of things that are no longer scheduled to execute the job because they have been deleted or have been removed from the group that was a target of the job.

" - } - }, - "documentation":"

The job process details.

" - }, - "JobStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "CANCELED", - "COMPLETED", - "DELETION_IN_PROGRESS" - ] - }, - "JobSummary":{ - "type":"structure", - "members":{ - "jobArn":{ - "shape":"JobArn", - "documentation":"

The job ARN.

" - }, - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

" - }, - "thingGroupId":{ - "shape":"ThingGroupId", - "documentation":"

The ID of the thing group.

" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a thing when the thing is added to a target group, even after the job was completed by all things originally in the group.

" - }, - "status":{ - "shape":"JobStatus", - "documentation":"

The job summary status.

" - }, - "createdAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job was created.

" - }, - "lastUpdatedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job was last updated.

" - }, - "completedAt":{ - "shape":"DateType", - "documentation":"

The time, in milliseconds since the epoch, when the job completed.

" - } - }, - "documentation":"

The job summary.

" - }, - "JobSummaryList":{ - "type":"list", - "member":{"shape":"JobSummary"} - }, - "JobTargets":{ - "type":"list", - "member":{"shape":"TargetArn"}, - "min":1 - }, - "JsonDocument":{"type":"string"}, - "Key":{"type":"string"}, - "KeyName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "KeyPair":{ - "type":"structure", - "members":{ - "PublicKey":{ - "shape":"PublicKey", - "documentation":"

The public key.

" - }, - "PrivateKey":{ - "shape":"PrivateKey", - "documentation":"

The private key.

" - } - }, - "documentation":"

Describes a key pair.

" - }, - "KeyValue":{ - "type":"string", - "max":5120 - }, - "KinesisAction":{ - "type":"structure", - "required":[ - "roleArn", - "streamName" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access to the Amazon Kinesis stream.

" - }, - "streamName":{ - "shape":"StreamName", - "documentation":"

The name of the Amazon Kinesis stream.

" - }, - "partitionKey":{ - "shape":"PartitionKey", - "documentation":"

The partition key.

" - } - }, - "documentation":"

Describes an action to write data to an Amazon Kinesis stream.

" - }, - "LambdaAction":{ - "type":"structure", - "required":["functionArn"], - "members":{ - "functionArn":{ - "shape":"FunctionArn", - "documentation":"

The ARN of the Lambda function.

" - } - }, - "documentation":"

Describes an action to invoke a Lambda function.

" - }, - "LaserMaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "LastModifiedDate":{"type":"timestamp"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

A limit has been exceeded.

", - "error":{"httpStatusCode":410}, - "exception":true - }, - "ListActiveViolationsRequest":{ - "type":"structure", - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing whose active violations are listed.

", - "location":"querystring", - "locationName":"thingName" - }, - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the Device Defender security profile for which violations are listed.

", - "location":"querystring", - "locationName":"securityProfileName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListActiveViolationsResponse":{ - "type":"structure", - "members":{ - "activeViolations":{ - "shape":"ActiveViolations", - "documentation":"

The list of active violations.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListAttachedPoliciesRequest":{ - "type":"structure", - "required":["target"], - "members":{ - "target":{ - "shape":"PolicyTarget", - "documentation":"

The group for which the policies will be listed.

", - "location":"uri", - "locationName":"target" - }, - "recursive":{ - "shape":"Recursive", - "documentation":"

When true, recursively list attached policies.

", - "location":"querystring", - "locationName":"recursive" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to be returned per request.

", - "location":"querystring", - "locationName":"pageSize" - } - } - }, - "ListAttachedPoliciesResponse":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

The policies.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The token to retrieve the next set of results, or ``null`` if there are no more results.

" - } - } - }, - "ListAuditFindingsRequest":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

A filter to limit results to the audit with the specified ID. You must specify either the taskId or the startTime and endTime, but not both.

" - }, - "checkName":{ - "shape":"AuditCheckName", - "documentation":"

A filter to limit results to the findings for the specified audit check.

" - }, - "resourceIdentifier":{ - "shape":"ResourceIdentifier", - "documentation":"

Information identifying the non-compliant resource.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time. The default is 25.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

A filter to limit results to those found after the specified time. You must specify either the startTime and endTime or the taskId, but not both.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

A filter to limit results to those found before the specified time. You must specify either the startTime and endTime or the taskId, but not both.

" - } - } - }, - "ListAuditFindingsResponse":{ - "type":"structure", - "members":{ - "findings":{ - "shape":"AuditFindings", - "documentation":"

The findings (results) of the audit.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListAuditTasksRequest":{ - "type":"structure", - "required":[ - "startTime", - "endTime" - ], - "members":{ - "startTime":{ - "shape":"Timestamp", - "documentation":"

The beginning of the time period. Note that audit information is retained for a limited time (180 days). Requesting a start time prior to what is retained results in an \"InvalidRequestException\".

", - "location":"querystring", - "locationName":"startTime" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time period.

", - "location":"querystring", - "locationName":"endTime" - }, - "taskType":{ - "shape":"AuditTaskType", - "documentation":"

A filter to limit the output to the specified type of audit: can be one of \"ON_DEMAND_AUDIT_TASK\" or \"SCHEDULED__AUDIT_TASK\".

", - "location":"querystring", - "locationName":"taskType" - }, - "taskStatus":{ - "shape":"AuditTaskStatus", - "documentation":"

A filter to limit the output to audits with the specified completion status: can be one of \"IN_PROGRESS\", \"COMPLETED\", \"FAILED\" or \"CANCELED\".

", - "location":"querystring", - "locationName":"taskStatus" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time. The default is 25.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListAuditTasksResponse":{ - "type":"structure", - "members":{ - "tasks":{ - "shape":"AuditTaskMetadataList", - "documentation":"

The audits that were performed during the specified time period.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListAuthorizersRequest":{ - "type":"structure", - "members":{ - "pageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Return the list of authorizers in ascending alphabetical order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - }, - "status":{ - "shape":"AuthorizerStatus", - "documentation":"

The status of the list authorizers request.

", - "location":"querystring", - "locationName":"status" - } - } - }, - "ListAuthorizersResponse":{ - "type":"structure", - "members":{ - "authorizers":{ - "shape":"Authorizers", - "documentation":"

The authorizers.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

" - } - } - }, - "ListCACertificatesRequest":{ - "type":"structure", - "members":{ - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Determines the order of the results.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

Input for the ListCACertificates operation.

" - }, - "ListCACertificatesResponse":{ - "type":"structure", - "members":{ - "certificates":{ - "shape":"CACertificates", - "documentation":"

The CA certificates registered in your AWS account.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The current position within the list of CA certificates.

" - } - }, - "documentation":"

The output from the ListCACertificates operation.

" - }, - "ListCertificatesByCARequest":{ - "type":"structure", - "required":["caCertificateId"], - "members":{ - "caCertificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the CA certificate. This operation will list all registered device certificate that were signed by this CA certificate.

", - "location":"uri", - "locationName":"caCertificateId" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If True, the results are returned in ascending order, based on the creation date.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input to the ListCertificatesByCA operation.

" - }, - "ListCertificatesByCAResponse":{ - "type":"structure", - "members":{ - "certificates":{ - "shape":"Certificates", - "documentation":"

The device certificates signed by the specified CA certificate.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output of the ListCertificatesByCA operation.

" - }, - "ListCertificatesRequest":{ - "type":"structure", - "members":{ - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If True, the results are returned in ascending order, based on the creation date.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input for the ListCertificates operation.

" - }, - "ListCertificatesResponse":{ - "type":"structure", - "members":{ - "certificates":{ - "shape":"Certificates", - "documentation":"

The descriptions of the certificates.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output of the ListCertificates operation.

" - }, - "ListIndicesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"QueryMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListIndicesResponse":{ - "type":"structure", - "members":{ - "indexNames":{ - "shape":"IndexNamesList", - "documentation":"

The index names.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListJobExecutionsForJobRequest":{ - "type":"structure", - "required":["jobId"], - "members":{ - "jobId":{ - "shape":"JobId", - "documentation":"

The unique identifier you assigned to this job when it was created.

", - "location":"uri", - "locationName":"jobId" - }, - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

The status of the job.

", - "location":"querystring", - "locationName":"status" - }, - "maxResults":{ - "shape":"LaserMaxResults", - "documentation":"

The maximum number of results to be returned per request.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - } - } - }, - "ListJobExecutionsForJobResponse":{ - "type":"structure", - "members":{ - "executionSummaries":{ - "shape":"JobExecutionSummaryForJobList", - "documentation":"

A list of job execution summaries.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results, or null if there are no additional results.

" - } - } - }, - "ListJobExecutionsForThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing name.

", - "location":"uri", - "locationName":"thingName" - }, - "status":{ - "shape":"JobExecutionStatus", - "documentation":"

An optional filter that lets you search for jobs that have the specified status.

", - "location":"querystring", - "locationName":"status" - }, - "maxResults":{ - "shape":"LaserMaxResults", - "documentation":"

The maximum number of results to be returned per request.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - } - } - }, - "ListJobExecutionsForThingResponse":{ - "type":"structure", - "members":{ - "executionSummaries":{ - "shape":"JobExecutionSummaryForThingList", - "documentation":"

A list of job execution summaries.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results, or null if there are no additional results.

" - } - } - }, - "ListJobsRequest":{ - "type":"structure", - "members":{ - "status":{ - "shape":"JobStatus", - "documentation":"

An optional filter that lets you search for jobs that have the specified status.

", - "location":"querystring", - "locationName":"status" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a thing when the thing is added to a target group, even after the job was completed by all things originally in the group.

", - "location":"querystring", - "locationName":"targetSelection" - }, - "maxResults":{ - "shape":"LaserMaxResults", - "documentation":"

The maximum number of results to return per request.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

A filter that limits the returned jobs to those for the specified group.

", - "location":"querystring", - "locationName":"thingGroupName" - }, - "thingGroupId":{ - "shape":"ThingGroupId", - "documentation":"

A filter that limits the returned jobs to those for the specified group.

", - "location":"querystring", - "locationName":"thingGroupId" - } - } - }, - "ListJobsResponse":{ - "type":"structure", - "members":{ - "jobs":{ - "shape":"JobSummaryList", - "documentation":"

A list of jobs.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results, or null if there are no additional results.

" - } - } - }, - "ListOTAUpdatesRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token used to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "otaUpdateStatus":{ - "shape":"OTAUpdateStatus", - "documentation":"

The OTA update job status.

", - "location":"querystring", - "locationName":"otaUpdateStatus" - } - } - }, - "ListOTAUpdatesResponse":{ - "type":"structure", - "members":{ - "otaUpdates":{ - "shape":"OTAUpdatesSummary", - "documentation":"

A list of OTA update jobs.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token to use to get the next set of results.

" - } - } - }, - "ListOutgoingCertificatesRequest":{ - "type":"structure", - "members":{ - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If True, the results are returned in ascending order, based on the creation date.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input to the ListOutgoingCertificates operation.

" - }, - "ListOutgoingCertificatesResponse":{ - "type":"structure", - "members":{ - "outgoingCertificates":{ - "shape":"OutgoingCertificates", - "documentation":"

The certificates that are being transferred but not yet accepted.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

" - } - }, - "documentation":"

The output from the ListOutgoingCertificates operation.

" - }, - "ListPoliciesRequest":{ - "type":"structure", - "members":{ - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If true, the results are returned in ascending creation order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input for the ListPolicies operation.

" - }, - "ListPoliciesResponse":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

The descriptions of the policies.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output from the ListPolicies operation.

" - }, - "ListPolicyPrincipalsRequest":{ - "type":"structure", - "required":["policyName"], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"header", - "locationName":"x-amzn-iot-policy" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If true, the results are returned in ascending creation order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input for the ListPolicyPrincipals operation.

" - }, - "ListPolicyPrincipalsResponse":{ - "type":"structure", - "members":{ - "principals":{ - "shape":"Principals", - "documentation":"

The descriptions of the principals.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output from the ListPolicyPrincipals operation.

" - }, - "ListPolicyVersionsRequest":{ - "type":"structure", - "required":["policyName"], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - } - }, - "documentation":"

The input for the ListPolicyVersions operation.

" - }, - "ListPolicyVersionsResponse":{ - "type":"structure", - "members":{ - "policyVersions":{ - "shape":"PolicyVersions", - "documentation":"

The policy versions.

" - } - }, - "documentation":"

The output from the ListPolicyVersions operation.

" - }, - "ListPrincipalPoliciesRequest":{ - "type":"structure", - "required":["principal"], - "members":{ - "principal":{ - "shape":"Principal", - "documentation":"

The principal.

", - "location":"header", - "locationName":"x-amzn-iot-principal" - }, - "marker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The result page size.

", - "location":"querystring", - "locationName":"pageSize" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Specifies the order for results. If true, results are returned in ascending creation order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - }, - "documentation":"

The input for the ListPrincipalPolicies operation.

" - }, - "ListPrincipalPoliciesResponse":{ - "type":"structure", - "members":{ - "policies":{ - "shape":"Policies", - "documentation":"

The policies.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

The marker for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output from the ListPrincipalPolicies operation.

" - }, - "ListPrincipalThingsRequest":{ - "type":"structure", - "required":["principal"], - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return in this operation.

", - "location":"querystring", - "locationName":"maxResults" - }, - "principal":{ - "shape":"Principal", - "documentation":"

The principal.

", - "location":"header", - "locationName":"x-amzn-principal" - } - }, - "documentation":"

The input for the ListPrincipalThings operation.

" - }, - "ListPrincipalThingsResponse":{ - "type":"structure", - "members":{ - "things":{ - "shape":"ThingNameList", - "documentation":"

The things.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output from the ListPrincipalThings operation.

" - }, - "ListRoleAliasesRequest":{ - "type":"structure", - "members":{ - "pageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"pageSize" - }, - "marker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Return the list of role aliases in ascending alphabetical order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - } - }, - "ListRoleAliasesResponse":{ - "type":"structure", - "members":{ - "roleAliases":{ - "shape":"RoleAliases", - "documentation":"

The role aliases.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

" - } - } - }, - "ListScheduledAuditsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time. The default is 25.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListScheduledAuditsResponse":{ - "type":"structure", - "members":{ - "scheduledAudits":{ - "shape":"ScheduledAuditMetadataList", - "documentation":"

The list of scheduled audits.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListSecurityProfilesForTargetRequest":{ - "type":"structure", - "required":["securityProfileTargetArn"], - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - }, - "recursive":{ - "shape":"Recursive", - "documentation":"

If true, return child groups as well.

", - "location":"querystring", - "locationName":"recursive" - }, - "securityProfileTargetArn":{ - "shape":"SecurityProfileTargetArn", - "documentation":"

The ARN of the target (thing group) whose attached security profiles you want to get.

", - "location":"querystring", - "locationName":"securityProfileTargetArn" - } - } - }, - "ListSecurityProfilesForTargetResponse":{ - "type":"structure", - "members":{ - "securityProfileTargetMappings":{ - "shape":"SecurityProfileTargetMappings", - "documentation":"

A list of security profiles and their associated targets.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListSecurityProfilesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListSecurityProfilesResponse":{ - "type":"structure", - "members":{ - "securityProfileIdentifiers":{ - "shape":"SecurityProfileIdentifiers", - "documentation":"

A list of security profile identifiers (names and ARNs).

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListStreamsRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at a time.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token used to get the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "ascendingOrder":{ - "shape":"AscendingOrder", - "documentation":"

Set to true to return the list of streams in ascending order.

", - "location":"querystring", - "locationName":"isAscendingOrder" - } - } - }, - "ListStreamsResponse":{ - "type":"structure", - "members":{ - "streams":{ - "shape":"StreamsSummary", - "documentation":"

A list of streams.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token used to get the next set of results.

" - } - } - }, - "ListTargetsForPolicyRequest":{ - "type":"structure", - "required":["policyName"], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - }, - "marker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

", - "location":"querystring", - "locationName":"marker" - }, - "pageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"pageSize" - } - } - }, - "ListTargetsForPolicyResponse":{ - "type":"structure", - "members":{ - "targets":{ - "shape":"PolicyTargets", - "documentation":"

The policy targets.

" - }, - "nextMarker":{ - "shape":"Marker", - "documentation":"

A marker used to get the next set of results.

" - } - } - }, - "ListTargetsForSecurityProfileRequest":{ - "type":"structure", - "required":["securityProfileName"], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The security profile.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListTargetsForSecurityProfileResponse":{ - "type":"structure", - "members":{ - "securityProfileTargets":{ - "shape":"SecurityProfileTargets", - "documentation":"

The thing groups to which the security profile is attached.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingGroupsForThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing name.

", - "location":"uri", - "locationName":"thingName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListThingGroupsForThingResponse":{ - "type":"structure", - "members":{ - "thingGroups":{ - "shape":"ThingGroupNameAndArnList", - "documentation":"

The thing groups.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingGroupsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - }, - "parentGroup":{ - "shape":"ThingGroupName", - "documentation":"

A filter that limits the results to those with the specified parent group.

", - "location":"querystring", - "locationName":"parentGroup" - }, - "namePrefixFilter":{ - "shape":"ThingGroupName", - "documentation":"

A filter that limits the results to those with the specified name prefix.

", - "location":"querystring", - "locationName":"namePrefixFilter" - }, - "recursive":{ - "shape":"RecursiveWithoutDefault", - "documentation":"

If true, return child groups as well.

", - "location":"querystring", - "locationName":"recursive" - } - } - }, - "ListThingGroupsResponse":{ - "type":"structure", - "members":{ - "thingGroups":{ - "shape":"ThingGroupNameAndArnList", - "documentation":"

The thing groups.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingPrincipalsRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

", - "location":"uri", - "locationName":"thingName" - } - }, - "documentation":"

The input for the ListThingPrincipal operation.

" - }, - "ListThingPrincipalsResponse":{ - "type":"structure", - "members":{ - "principals":{ - "shape":"Principals", - "documentation":"

The principals associated with the thing.

" - } - }, - "documentation":"

The output from the ListThingPrincipals operation.

" - }, - "ListThingRegistrationTaskReportsRequest":{ - "type":"structure", - "required":[ - "taskId", - "reportType" - ], - "members":{ - "taskId":{ - "shape":"TaskId", - "documentation":"

The id of the task.

", - "location":"uri", - "locationName":"taskId" - }, - "reportType":{ - "shape":"ReportType", - "documentation":"

The type of task report.

", - "location":"querystring", - "locationName":"reportType" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return per request.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListThingRegistrationTaskReportsResponse":{ - "type":"structure", - "members":{ - "resourceLinks":{ - "shape":"S3FileUrlList", - "documentation":"

Links to the task resources.

" - }, - "reportType":{ - "shape":"ReportType", - "documentation":"

The type of task report.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingRegistrationTasksRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - }, - "status":{ - "shape":"Status", - "documentation":"

The status of the bulk thing provisioning task.

", - "location":"querystring", - "locationName":"status" - } - } - }, - "ListThingRegistrationTasksResponse":{ - "type":"structure", - "members":{ - "taskIds":{ - "shape":"TaskIdList", - "documentation":"

A list of bulk thing provisioning task IDs.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingTypesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return in this operation.

", - "location":"querystring", - "locationName":"maxResults" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

", - "location":"querystring", - "locationName":"thingTypeName" - } - }, - "documentation":"

The input for the ListThingTypes operation.

" - }, - "ListThingTypesResponse":{ - "type":"structure", - "members":{ - "thingTypes":{ - "shape":"ThingTypeList", - "documentation":"

The thing types.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output for the ListThingTypes operation.

" - }, - "ListThingsInThingGroupRequest":{ - "type":"structure", - "required":["thingGroupName"], - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The thing group name.

", - "location":"uri", - "locationName":"thingGroupName" - }, - "recursive":{ - "shape":"Recursive", - "documentation":"

When true, list things in this thing group and in all child groups as well.

", - "location":"querystring", - "locationName":"recursive" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListThingsInThingGroupResponse":{ - "type":"structure", - "members":{ - "things":{ - "shape":"ThingNameList", - "documentation":"

The things in the specified thing group.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListThingsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"RegistryMaxResults", - "documentation":"

The maximum number of results to return in this operation.

", - "location":"querystring", - "locationName":"maxResults" - }, - "attributeName":{ - "shape":"AttributeName", - "documentation":"

The attribute name used to search for things.

", - "location":"querystring", - "locationName":"attributeName" - }, - "attributeValue":{ - "shape":"AttributeValue", - "documentation":"

The attribute value used to search for things.

", - "location":"querystring", - "locationName":"attributeValue" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type used to search for things.

", - "location":"querystring", - "locationName":"thingTypeName" - } - }, - "documentation":"

The input for the ListThings operation.

" - }, - "ListThingsResponse":{ - "type":"structure", - "members":{ - "things":{ - "shape":"ThingAttributeList", - "documentation":"

The things.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - }, - "documentation":"

The output from the ListThings operation.

" - }, - "ListTopicRulesRequest":{ - "type":"structure", - "members":{ - "topic":{ - "shape":"Topic", - "documentation":"

The topic.

", - "location":"querystring", - "locationName":"topic" - }, - "maxResults":{ - "shape":"GEMaxResults", - "documentation":"

The maximum number of results to return.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token used to retrieve the next value.

", - "location":"querystring", - "locationName":"nextToken" - }, - "ruleDisabled":{ - "shape":"IsDisabled", - "documentation":"

Specifies whether the rule is disabled.

", - "location":"querystring", - "locationName":"ruleDisabled" - } - }, - "documentation":"

The input for the ListTopicRules operation.

" - }, - "ListTopicRulesResponse":{ - "type":"structure", - "members":{ - "rules":{ - "shape":"TopicRuleList", - "documentation":"

The rules.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token used to retrieve the next value.

" - } - }, - "documentation":"

The output from the ListTopicRules operation.

" - }, - "ListV2LoggingLevelsRequest":{ - "type":"structure", - "members":{ - "targetType":{ - "shape":"LogTargetType", - "documentation":"

The type of resource for which you are configuring logging. Must be THING_Group.

", - "location":"querystring", - "locationName":"targetType" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"SkyfallMaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListV2LoggingLevelsResponse":{ - "type":"structure", - "members":{ - "logTargetConfigurations":{ - "shape":"LogTargetConfigurations", - "documentation":"

The logging configuration for a target.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - } - } - }, - "ListViolationEventsRequest":{ - "type":"structure", - "required":[ - "startTime", - "endTime" - ], - "members":{ - "startTime":{ - "shape":"Timestamp", - "documentation":"

The start time for the alerts to be listed.

", - "location":"querystring", - "locationName":"startTime" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

The end time for the alerts to be listed.

", - "location":"querystring", - "locationName":"endTime" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

A filter to limit results to those alerts caused by the specified thing.

", - "location":"querystring", - "locationName":"thingName" - }, - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

A filter to limit results to those alerts generated by the specified security profile.

", - "location":"querystring", - "locationName":"securityProfileName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return at one time.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListViolationEventsResponse":{ - "type":"structure", - "members":{ - "violationEvents":{ - "shape":"ViolationEvents", - "documentation":"

The security profile violation alerts issued for this account during the given time frame, potentially filtered by security profile, behavior violated, or thing (device) violating.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A token that can be used to retrieve the next set of results, or null if there are no additional results.

" - } - } - }, - "LogLevel":{ - "type":"string", - "enum":[ - "DEBUG", - "INFO", - "ERROR", - "WARN", - "DISABLED" - ] - }, - "LogTarget":{ - "type":"structure", - "required":["targetType"], - "members":{ - "targetType":{ - "shape":"LogTargetType", - "documentation":"

The target type.

" - }, - "targetName":{ - "shape":"LogTargetName", - "documentation":"

The target name.

" - } - }, - "documentation":"

A log target.

" - }, - "LogTargetConfiguration":{ - "type":"structure", - "members":{ - "logTarget":{ - "shape":"LogTarget", - "documentation":"

A log target

" - }, - "logLevel":{ - "shape":"LogLevel", - "documentation":"

The logging level.

" - } - }, - "documentation":"

The target configuration.

" - }, - "LogTargetConfigurations":{ - "type":"list", - "member":{"shape":"LogTargetConfiguration"} - }, - "LogTargetName":{"type":"string"}, - "LogTargetType":{ - "type":"string", - "enum":[ - "DEFAULT", - "THING_GROUP" - ] - }, - "LoggingOptionsPayload":{ - "type":"structure", - "required":["roleArn"], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "logLevel":{ - "shape":"LogLevel", - "documentation":"

The log level.

" - } - }, - "documentation":"

Describes the logging options payload.

" - }, - "MalformedPolicyException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The policy documentation is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Marker":{ - "type":"string", - "pattern":"[A-Za-z0-9+/]+={0,2}" - }, - "MaxJobExecutionsPerMin":{ - "type":"integer", - "max":1000, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "Message":{ - "type":"string", - "max":128 - }, - "MessageFormat":{ - "type":"string", - "enum":[ - "RAW", - "JSON" - ] - }, - "MetricValue":{ - "type":"structure", - "members":{ - "count":{ - "shape":"UnsignedLong", - "documentation":"

If the comparisonOperator calls for a numeric value, use this to specify that numeric value to be compared with the metric.

" - }, - "cidrs":{ - "shape":"Cidrs", - "documentation":"

If the comparisonOperator calls for a set of CIDRs, use this to specify that set to be compared with the metric.

" - }, - "ports":{ - "shape":"Ports", - "documentation":"

If the comparisonOperator calls for a set of ports, use this to specify that set to be compared with the metric.

" - } - }, - "documentation":"

The value to be compared with the metric.

" - }, - "MissingContextValue":{"type":"string"}, - "MissingContextValues":{ - "type":"list", - "member":{"shape":"MissingContextValue"} - }, - "NextToken":{"type":"string"}, - "NonCompliantChecksCount":{"type":"integer"}, - "NonCompliantResource":{ - "type":"structure", - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of the non-compliant resource.

" - }, - "resourceIdentifier":{ - "shape":"ResourceIdentifier", - "documentation":"

Information identifying the non-compliant resource.

" - }, - "additionalInfo":{ - "shape":"StringMap", - "documentation":"

Additional information about the non-compliant resource.

" - } - }, - "documentation":"

Information about the resource that was non-compliant with the audit check.

" - }, - "NonCompliantResourcesCount":{"type":"long"}, - "NotConfiguredException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The resource is not configured.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "OTAUpdateArn":{"type":"string"}, - "OTAUpdateDescription":{ - "type":"string", - "max":2028, - "pattern":"[^\\p{C}]+" - }, - "OTAUpdateErrorMessage":{"type":"string"}, - "OTAUpdateFile":{ - "type":"structure", - "members":{ - "fileName":{ - "shape":"FileName", - "documentation":"

The name of the file.

" - }, - "fileVersion":{ - "shape":"OTAUpdateFileVersion", - "documentation":"

The file version.

" - }, - "fileSource":{ - "shape":"Stream", - "documentation":"

The source of the file.

" - }, - "codeSigning":{ - "shape":"CodeSigning", - "documentation":"

The code signing method of the file.

" - }, - "attributes":{ - "shape":"AttributesMap", - "documentation":"

A list of name/attribute pairs.

" - } - }, - "documentation":"

Describes a file to be associated with an OTA update.

" - }, - "OTAUpdateFileVersion":{"type":"string"}, - "OTAUpdateFiles":{ - "type":"list", - "member":{"shape":"OTAUpdateFile"}, - "max":10, - "min":1 - }, - "OTAUpdateId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "OTAUpdateInfo":{ - "type":"structure", - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The OTA update ID.

" - }, - "otaUpdateArn":{ - "shape":"OTAUpdateArn", - "documentation":"

The OTA update ARN.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date when the OTA update was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The date when the OTA update was last updated.

" - }, - "description":{ - "shape":"OTAUpdateDescription", - "documentation":"

A description of the OTA update.

" - }, - "targets":{ - "shape":"Targets", - "documentation":"

The targets of the OTA update.

" - }, - "targetSelection":{ - "shape":"TargetSelection", - "documentation":"

Specifies whether the OTA update will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the OTA update (SNAPSHOT). If continuous, the OTA update may also be run on a thing when a change is detected in a target. For example, an OTA update will run on a thing when the thing is added to a target group, even after the OTA update was completed by all things originally in the group.

" - }, - "otaUpdateFiles":{ - "shape":"OTAUpdateFiles", - "documentation":"

A list of files associated with the OTA update.

" - }, - "otaUpdateStatus":{ - "shape":"OTAUpdateStatus", - "documentation":"

The status of the OTA update.

" - }, - "awsIotJobId":{ - "shape":"AwsIotJobId", - "documentation":"

The AWS IoT job ID associated with the OTA update.

" - }, - "awsIotJobArn":{ - "shape":"AwsIotJobArn", - "documentation":"

The AWS IoT job ARN associated with the OTA update.

" - }, - "errorInfo":{ - "shape":"ErrorInfo", - "documentation":"

Error information associated with the OTA update.

" - }, - "additionalParameters":{ - "shape":"AdditionalParameterMap", - "documentation":"

A collection of name/value pairs

" - } - }, - "documentation":"

Information about an OTA update.

" - }, - "OTAUpdateStatus":{ - "type":"string", - "enum":[ - "CREATE_PENDING", - "CREATE_IN_PROGRESS", - "CREATE_COMPLETE", - "CREATE_FAILED" - ] - }, - "OTAUpdateSummary":{ - "type":"structure", - "members":{ - "otaUpdateId":{ - "shape":"OTAUpdateId", - "documentation":"

The OTA update ID.

" - }, - "otaUpdateArn":{ - "shape":"OTAUpdateArn", - "documentation":"

The OTA update ARN.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The date when the OTA update was created.

" - } - }, - "documentation":"

An OTA update summary.

" - }, - "OTAUpdatesSummary":{ - "type":"list", - "member":{"shape":"OTAUpdateSummary"} - }, - "OptionalVersion":{"type":"long"}, - "OutgoingCertificate":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The certificate ARN.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The certificate ID.

" - }, - "transferredTo":{ - "shape":"AwsAccountId", - "documentation":"

The AWS account to which the transfer was made.

" - }, - "transferDate":{ - "shape":"DateType", - "documentation":"

The date the transfer was initiated.

" - }, - "transferMessage":{ - "shape":"Message", - "documentation":"

The transfer message.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The certificate creation date.

" - } - }, - "documentation":"

A certificate that has been transferred but not yet accepted.

" - }, - "OutgoingCertificates":{ - "type":"list", - "member":{"shape":"OutgoingCertificate"} - }, - "PageSize":{ - "type":"integer", - "max":250, - "min":1 - }, - "Parameter":{"type":"string"}, - "Parameters":{ - "type":"map", - "key":{"shape":"Parameter"}, - "value":{"shape":"Value"} - }, - "PartitionKey":{"type":"string"}, - "PayloadField":{"type":"string"}, - "Percentage":{ - "type":"integer", - "max":100, - "min":0 - }, - "Policies":{ - "type":"list", - "member":{"shape":"Policy"} - }, - "Policy":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

" - }, - "policyArn":{ - "shape":"PolicyArn", - "documentation":"

The policy ARN.

" - } - }, - "documentation":"

Describes an AWS IoT policy.

" - }, - "PolicyArn":{"type":"string"}, - "PolicyDocument":{"type":"string"}, - "PolicyDocuments":{ - "type":"list", - "member":{"shape":"PolicyDocument"} - }, - "PolicyName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]+" - }, - "PolicyNames":{ - "type":"list", - "member":{"shape":"PolicyName"} - }, - "PolicyTarget":{"type":"string"}, - "PolicyTargets":{ - "type":"list", - "member":{"shape":"PolicyTarget"} - }, - "PolicyVersion":{ - "type":"structure", - "members":{ - "versionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

" - }, - "isDefaultVersion":{ - "shape":"IsDefaultVersion", - "documentation":"

Specifies whether the policy version is the default.

" - }, - "createDate":{ - "shape":"DateType", - "documentation":"

The date and time the policy was created.

" - } - }, - "documentation":"

Describes a policy version.

" - }, - "PolicyVersionId":{ - "type":"string", - "pattern":"[0-9]+" - }, - "PolicyVersionIdentifier":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The ID of the version of the policy associated with the resource.

" - } - }, - "documentation":"

Information about the version of the policy associated with the resource.

" - }, - "PolicyVersions":{ - "type":"list", - "member":{"shape":"PolicyVersion"} - }, - "Port":{ - "type":"integer", - "max":65535, - "min":0 - }, - "Ports":{ - "type":"list", - "member":{"shape":"Port"} - }, - "PresignedUrlConfig":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of an IAM role that grants grants permission to download files from the S3 bucket where the job data/updates are stored. The role must also grant permission for IoT to download the files.

" - }, - "expiresInSec":{ - "shape":"ExpiresInSec", - "documentation":"

How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds. Pre-signed URLs are generated when Jobs receives an MQTT request for the job document.

" - } - }, - "documentation":"

Configuration for pre-signed S3 URLs.

" - }, - "Principal":{"type":"string"}, - "PrincipalArn":{"type":"string"}, - "PrincipalId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9]+" - }, - "Principals":{ - "type":"list", - "member":{"shape":"PrincipalArn"} - }, - "PrivateKey":{ - "type":"string", - "min":1, - "sensitive":true - }, - "ProcessingTargetName":{"type":"string"}, - "ProcessingTargetNameList":{ - "type":"list", - "member":{"shape":"ProcessingTargetName"} - }, - "PublicKey":{ - "type":"string", - "min":1 - }, - "PublicKeyMap":{ - "type":"map", - "key":{"shape":"KeyName"}, - "value":{"shape":"KeyValue"} - }, - "PutItemInput":{ - "type":"structure", - "required":["tableName"], - "members":{ - "tableName":{ - "shape":"TableName", - "documentation":"

The table where the message data will be written

" - } - }, - "documentation":"

The input for the DynamoActionVS action that specifies the DynamoDB table to which the message data will be written.

" - }, - "QueryMaxResults":{ - "type":"integer", - "max":500, - "min":1 - }, - "QueryString":{ - "type":"string", - "max":1000, - "min":1 - }, - "QueryVersion":{"type":"string"}, - "QueueUrl":{"type":"string"}, - "QueuedThings":{"type":"integer"}, - "RangeKeyField":{"type":"string"}, - "RangeKeyValue":{"type":"string"}, - "ReasonForNonCompliance":{"type":"string"}, - "ReasonForNonComplianceCode":{"type":"string"}, - "Recursive":{"type":"boolean"}, - "RecursiveWithoutDefault":{"type":"boolean"}, - "RegisterCACertificateRequest":{ - "type":"structure", - "required":[ - "caCertificate", - "verificationCertificate" - ], - "members":{ - "caCertificate":{ - "shape":"CertificatePem", - "documentation":"

The CA certificate.

" - }, - "verificationCertificate":{ - "shape":"CertificatePem", - "documentation":"

The private key verification certificate.

" - }, - "setAsActive":{ - "shape":"SetAsActive", - "documentation":"

A boolean value that specifies if the CA certificate is set to active.

", - "location":"querystring", - "locationName":"setAsActive" - }, - "allowAutoRegistration":{ - "shape":"AllowAutoRegistration", - "documentation":"

Allows this CA certificate to be used for auto registration of device certificates.

", - "location":"querystring", - "locationName":"allowAutoRegistration" - }, - "registrationConfig":{ - "shape":"RegistrationConfig", - "documentation":"

Information about the registration configuration.

" - } - }, - "documentation":"

The input to the RegisterCACertificate operation.

" - }, - "RegisterCACertificateResponse":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The CA certificate ARN.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The CA certificate identifier.

" - } - }, - "documentation":"

The output from the RegisterCACertificateResponse operation.

" - }, - "RegisterCertificateRequest":{ - "type":"structure", - "required":["certificatePem"], - "members":{ - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

The certificate data, in PEM format.

" - }, - "caCertificatePem":{ - "shape":"CertificatePem", - "documentation":"

The CA certificate used to sign the device certificate being registered.

" - }, - "setAsActive":{ - "shape":"SetAsActiveFlag", - "documentation":"

A boolean value that specifies if the CA certificate is set to active.

", - "deprecated":true, - "location":"querystring", - "locationName":"setAsActive" - }, - "status":{ - "shape":"CertificateStatus", - "documentation":"

The status of the register certificate request.

" - } - }, - "documentation":"

The input to the RegisterCertificate operation.

" - }, - "RegisterCertificateResponse":{ - "type":"structure", - "members":{ - "certificateArn":{ - "shape":"CertificateArn", - "documentation":"

The certificate ARN.

" - }, - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The certificate identifier.

" - } - }, - "documentation":"

The output from the RegisterCertificate operation.

" - }, - "RegisterThingRequest":{ - "type":"structure", - "required":["templateBody"], - "members":{ - "templateBody":{ - "shape":"TemplateBody", - "documentation":"

The provisioning template. See Programmatic Provisioning for more information.

" - }, - "parameters":{ - "shape":"Parameters", - "documentation":"

The parameters for provisioning a thing. See Programmatic Provisioning for more information.

" - } - } - }, - "RegisterThingResponse":{ - "type":"structure", - "members":{ - "certificatePem":{ - "shape":"CertificatePem", - "documentation":"

.

" - }, - "resourceArns":{ - "shape":"ResourceArns", - "documentation":"

ARNs for the generated resources.

" - } - } - }, - "RegistrationCode":{ - "type":"string", - "max":64, - "min":64, - "pattern":"(0x)?[a-fA-F0-9]+" - }, - "RegistrationCodeValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

Additional information about the exception.

" - } - }, - "documentation":"

The registration code is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "RegistrationConfig":{ - "type":"structure", - "members":{ - "templateBody":{ - "shape":"TemplateBody", - "documentation":"

The template body.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role.

" - } - }, - "documentation":"

The registration configuration.

" - }, - "RegistryMaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "RegistryS3BucketName":{ - "type":"string", - "max":256, - "min":3, - "pattern":"[a-zA-Z0-9._-]+" - }, - "RegistryS3KeyName":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[a-zA-Z0-9!_.*'()-\\/]+" - }, - "RejectCertificateTransferRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - }, - "rejectReason":{ - "shape":"Message", - "documentation":"

The reason the certificate transfer was rejected.

" - } - }, - "documentation":"

The input for the RejectCertificateTransfer operation.

" - }, - "RejectedThings":{"type":"integer"}, - "RelatedResource":{ - "type":"structure", - "members":{ - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource.

" - }, - "resourceIdentifier":{ - "shape":"ResourceIdentifier", - "documentation":"

Information identifying the resource.

" - }, - "additionalInfo":{ - "shape":"StringMap", - "documentation":"

Additional information about the resource.

" - } - }, - "documentation":"

Information about a related resource.

" - }, - "RelatedResources":{ - "type":"list", - "member":{"shape":"RelatedResource"} - }, - "RemoveAutoRegistration":{"type":"boolean"}, - "RemoveThingFromThingGroupRequest":{ - "type":"structure", - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The group name.

" - }, - "thingGroupArn":{ - "shape":"ThingGroupArn", - "documentation":"

The group ARN.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing to remove from the group.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The ARN of the thing to remove from the group.

" - } - } - }, - "RemoveThingFromThingGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "RemoveThingType":{"type":"boolean"}, - "RemovedThings":{"type":"integer"}, - "ReplaceTopicRuleRequest":{ - "type":"structure", - "required":[ - "ruleName", - "topicRulePayload" - ], - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

", - "location":"uri", - "locationName":"ruleName" - }, - "topicRulePayload":{ - "shape":"TopicRulePayload", - "documentation":"

The rule payload.

" - } - }, - "documentation":"

The input for the ReplaceTopicRule operation.

", - "payload":"topicRulePayload" - }, - "ReportType":{ - "type":"string", - "enum":[ - "ERRORS", - "RESULTS" - ] - }, - "RepublishAction":{ - "type":"structure", - "required":[ - "roleArn", - "topic" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "topic":{ - "shape":"TopicPattern", - "documentation":"

The name of the MQTT topic.

" - } - }, - "documentation":"

Describes an action to republish to another topic.

" - }, - "Resource":{"type":"string"}, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - }, - "resourceId":{ - "shape":"resourceId", - "documentation":"

The ID of the resource that caused the exception.

" - }, - "resourceArn":{ - "shape":"resourceArn", - "documentation":"

The ARN of the resource that caused the exception.

" - } - }, - "documentation":"

The resource already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceArn":{"type":"string"}, - "ResourceArns":{ - "type":"map", - "key":{"shape":"ResourceLogicalId"}, - "value":{"shape":"ResourceArn"} - }, - "ResourceIdentifier":{ - "type":"structure", - "members":{ - "deviceCertificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate attached to the resource.

" - }, - "caCertificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the CA certificate used to authorize the certificate.

" - }, - "cognitoIdentityPoolId":{ - "shape":"CognitoIdentityPoolId", - "documentation":"

The ID of the Cognito Identity Pool.

" - }, - "clientId":{ - "shape":"ClientId", - "documentation":"

The client ID.

" - }, - "policyVersionIdentifier":{ - "shape":"PolicyVersionIdentifier", - "documentation":"

The version of the policy associated with the resource.

" - }, - "account":{ - "shape":"AwsAccountId", - "documentation":"

The account with which the resource is associated.

" - } - }, - "documentation":"

Information identifying the non-compliant resource.

" - }, - "ResourceLogicalId":{"type":"string"}, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The specified resource does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ResourceRegistrationFailureException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The resource registration failed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ResourceType":{ - "type":"string", - "enum":[ - "DEVICE_CERTIFICATE", - "CA_CERTIFICATE", - "IOT_POLICY", - "COGNITO_IDENTITY_POOL", - "CLIENT_ID", - "ACCOUNT_SETTINGS" - ] - }, - "Resources":{ - "type":"list", - "member":{"shape":"Resource"} - }, - "RoleAlias":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w=,@-]+" - }, - "RoleAliasArn":{"type":"string"}, - "RoleAliasDescription":{ - "type":"structure", - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias.

" - }, - "roleAliasArn":{ - "shape":"RoleAliasArn", - "documentation":"

The ARN of the role alias.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The role ARN.

" - }, - "owner":{ - "shape":"AwsAccountId", - "documentation":"

The role alias owner.

" - }, - "credentialDurationSeconds":{ - "shape":"CredentialDurationSeconds", - "documentation":"

The number of seconds for which the credential is valid.

" - }, - "creationDate":{ - "shape":"DateType", - "documentation":"

The UNIX timestamp of when the role alias was created.

" - }, - "lastModifiedDate":{ - "shape":"DateType", - "documentation":"

The UNIX timestamp of when the role alias was last modified.

" - } - }, - "documentation":"

Role alias description.

" - }, - "RoleAliases":{ - "type":"list", - "member":{"shape":"RoleAlias"} - }, - "RoleArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "RuleArn":{"type":"string"}, - "RuleName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "S3Action":{ - "type":"structure", - "required":[ - "roleArn", - "bucketName", - "key" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "bucketName":{ - "shape":"BucketName", - "documentation":"

The Amazon S3 bucket.

" - }, - "key":{ - "shape":"Key", - "documentation":"

The object key.

" - }, - "cannedAcl":{ - "shape":"CannedAccessControlList", - "documentation":"

The Amazon S3 canned ACL that controls access to the object identified by the object key. For more information, see S3 canned ACLs.

" - } - }, - "documentation":"

Describes an action to write data to an Amazon S3 bucket.

" - }, - "S3Bucket":{ - "type":"string", - "min":1 - }, - "S3FileUrl":{ - "type":"string", - "max":65535 - }, - "S3FileUrlList":{ - "type":"list", - "member":{"shape":"S3FileUrl"} - }, - "S3Key":{ - "type":"string", - "min":1 - }, - "S3Location":{ - "type":"structure", - "required":[ - "bucket", - "key" - ], - "members":{ - "bucket":{ - "shape":"S3Bucket", - "documentation":"

The S3 bucket that contains the file to stream.

" - }, - "key":{ - "shape":"S3Key", - "documentation":"

The name of the file within the S3 bucket to stream.

" - }, - "version":{ - "shape":"S3Version", - "documentation":"

The file version.

" - } - }, - "documentation":"

The location in S3 the contains the files to stream.

" - }, - "S3Version":{"type":"string"}, - "SQL":{"type":"string"}, - "SalesforceAction":{ - "type":"structure", - "required":[ - "token", - "url" - ], - "members":{ - "token":{ - "shape":"SalesforceToken", - "documentation":"

The token used to authenticate access to the Salesforce IoT Cloud Input Stream. The token is available from the Salesforce IoT Cloud platform after creation of the Input Stream.

" - }, - "url":{ - "shape":"SalesforceEndpoint", - "documentation":"

The URL exposed by the Salesforce IoT Cloud Input Stream. The URL is available from the Salesforce IoT Cloud platform after creation of the Input Stream.

" - } - }, - "documentation":"

Describes an action to write a message to a Salesforce IoT Cloud Input Stream.

" - }, - "SalesforceEndpoint":{ - "type":"string", - "max":2000, - "pattern":"https://ingestion-[a-zA-Z0-9]{1,12}\\.[a-zA-Z0-9]+\\.((sfdc-matrix\\.net)|(sfdcnow\\.com))/streams/\\w{1,20}/\\w{1,20}/event" - }, - "SalesforceToken":{ - "type":"string", - "min":40 - }, - "ScheduledAuditArn":{"type":"string"}, - "ScheduledAuditMetadata":{ - "type":"structure", - "members":{ - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit.

" - }, - "scheduledAuditArn":{ - "shape":"ScheduledAuditArn", - "documentation":"

The ARN of the scheduled audit.

" - }, - "frequency":{ - "shape":"AuditFrequency", - "documentation":"

How often the scheduled audit takes place.

" - }, - "dayOfMonth":{ - "shape":"DayOfMonth", - "documentation":"

The day of the month on which the scheduled audit is run (if the frequency is \"MONTHLY\"). If days 29-31 are specified, and the month does not have that many days, the audit takes place on the \"LAST\" day of the month.

" - }, - "dayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

The day of the week on which the scheduled audit is run (if the frequency is \"WEEKLY\" or \"BIWEEKLY\").

" - } - }, - "documentation":"

Information about the scheduled audit.

" - }, - "ScheduledAuditMetadataList":{ - "type":"list", - "member":{"shape":"ScheduledAuditMetadata"} - }, - "ScheduledAuditName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "SearchIndexRequest":{ - "type":"structure", - "required":["queryString"], - "members":{ - "indexName":{ - "shape":"IndexName", - "documentation":"

The search index name.

" - }, - "queryString":{ - "shape":"QueryString", - "documentation":"

The search query string.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - }, - "maxResults":{ - "shape":"QueryMaxResults", - "documentation":"

The maximum number of results to return at one time.

" - }, - "queryVersion":{ - "shape":"QueryVersion", - "documentation":"

The query version.

" - } - } - }, - "SearchIndexResponse":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to get the next set of results, or null if there are no additional results.

" - }, - "things":{ - "shape":"ThingDocumentList", - "documentation":"

The things that match the search query.

" - } - } - }, - "SearchableAttributes":{ - "type":"list", - "member":{"shape":"AttributeName"} - }, - "Seconds":{"type":"integer"}, - "SecurityProfileArn":{"type":"string"}, - "SecurityProfileDescription":{ - "type":"string", - "max":1000, - "pattern":"[\\p{Graph}\\x20]*" - }, - "SecurityProfileIdentifier":{ - "type":"structure", - "required":[ - "name", - "arn" - ], - "members":{ - "name":{ - "shape":"SecurityProfileName", - "documentation":"

The name you have given to the security profile.

" - }, - "arn":{ - "shape":"SecurityProfileArn", - "documentation":"

The ARN of the security profile.

" - } - }, - "documentation":"

Identifying information for a Device Defender security profile.

" - }, - "SecurityProfileIdentifiers":{ - "type":"list", - "member":{"shape":"SecurityProfileIdentifier"} - }, - "SecurityProfileName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "SecurityProfileTarget":{ - "type":"structure", - "required":["arn"], - "members":{ - "arn":{ - "shape":"SecurityProfileTargetArn", - "documentation":"

The ARN of the security profile.

" - } - }, - "documentation":"

A target to which an alert is sent when a security profile behavior is violated.

" - }, - "SecurityProfileTargetArn":{"type":"string"}, - "SecurityProfileTargetMapping":{ - "type":"structure", - "members":{ - "securityProfileIdentifier":{ - "shape":"SecurityProfileIdentifier", - "documentation":"

Information that identifies the security profile.

" - }, - "target":{ - "shape":"SecurityProfileTarget", - "documentation":"

Information about the target (thing group) associated with the security profile.

" - } - }, - "documentation":"

Information about a security profile and the target associated with it.

" - }, - "SecurityProfileTargetMappings":{ - "type":"list", - "member":{"shape":"SecurityProfileTargetMapping"} - }, - "SecurityProfileTargets":{ - "type":"list", - "member":{"shape":"SecurityProfileTarget"} - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The service is temporarily unavailable.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "SetAsActive":{"type":"boolean"}, - "SetAsActiveFlag":{"type":"boolean"}, - "SetAsDefault":{"type":"boolean"}, - "SetDefaultAuthorizerRequest":{ - "type":"structure", - "required":["authorizerName"], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

" - } - } - }, - "SetDefaultAuthorizerResponse":{ - "type":"structure", - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

" - }, - "authorizerArn":{ - "shape":"AuthorizerArn", - "documentation":"

The authorizer ARN.

" - } - } - }, - "SetDefaultPolicyVersionRequest":{ - "type":"structure", - "required":[ - "policyName", - "policyVersionId" - ], - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The policy name.

", - "location":"uri", - "locationName":"policyName" - }, - "policyVersionId":{ - "shape":"PolicyVersionId", - "documentation":"

The policy version ID.

", - "location":"uri", - "locationName":"policyVersionId" - } - }, - "documentation":"

The input for the SetDefaultPolicyVersion operation.

" - }, - "SetLoggingOptionsRequest":{ - "type":"structure", - "required":["loggingOptionsPayload"], - "members":{ - "loggingOptionsPayload":{ - "shape":"LoggingOptionsPayload", - "documentation":"

The logging options payload.

" - } - }, - "documentation":"

The input for the SetLoggingOptions operation.

", - "payload":"loggingOptionsPayload" - }, - "SetV2LoggingLevelRequest":{ - "type":"structure", - "required":[ - "logTarget", - "logLevel" - ], - "members":{ - "logTarget":{ - "shape":"LogTarget", - "documentation":"

The log target.

" - }, - "logLevel":{ - "shape":"LogLevel", - "documentation":"

The log level.

" - } - } - }, - "SetV2LoggingOptionsRequest":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the role that allows IoT to write to Cloudwatch logs.

" - }, - "defaultLogLevel":{ - "shape":"LogLevel", - "documentation":"

The default logging level.

" - }, - "disableAllLogs":{ - "shape":"DisableAllLogs", - "documentation":"

If true all logs are disabled. The default is false.

" - } - } - }, - "Signature":{"type":"blob"}, - "SignatureAlgorithm":{"type":"string"}, - "SigningJobId":{"type":"string"}, - "SkyfallMaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "SnsAction":{ - "type":"structure", - "required":[ - "targetArn", - "roleArn" - ], - "members":{ - "targetArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the SNS topic.

" - }, - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "messageFormat":{ - "shape":"MessageFormat", - "documentation":"

(Optional) The message format of the message to publish. Accepted values are \"JSON\" and \"RAW\". The default value of the attribute is \"RAW\". SNS uses this setting to determine if the payload should be parsed and relevant platform-specific bits of the payload should be extracted. To read more about SNS message formats, see http://docs.aws.amazon.com/sns/latest/dg/json-formats.html refer to their official documentation.

" - } - }, - "documentation":"

Describes an action to publish to an Amazon SNS topic.

" - }, - "SqlParseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The Rule-SQL expression can't be parsed correctly.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SqsAction":{ - "type":"structure", - "required":[ - "roleArn", - "queueUrl" - ], - "members":{ - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the IAM role that grants access.

" - }, - "queueUrl":{ - "shape":"QueueUrl", - "documentation":"

The URL of the Amazon SQS queue.

" - }, - "useBase64":{ - "shape":"UseBase64", - "documentation":"

Specifies whether to use Base64 encoding.

" - } - }, - "documentation":"

Describes an action to publish data to an Amazon SQS queue.

" - }, - "StartOnDemandAuditTaskRequest":{ - "type":"structure", - "required":["targetCheckNames"], - "members":{ - "targetCheckNames":{ - "shape":"TargetAuditCheckNames", - "documentation":"

Which checks are performed during the audit. The checks you specify must be enabled for your account or an exception occurs. Use DescribeAccountAuditConfiguration to see the list of all checks including those that are enabled or UpdateAccountAuditConfiguration to select which checks are enabled.

" - } - } - }, - "StartOnDemandAuditTaskResponse":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"AuditTaskId", - "documentation":"

The ID of the on-demand audit you started.

" - } - } - }, - "StartThingRegistrationTaskRequest":{ - "type":"structure", - "required":[ - "templateBody", - "inputFileBucket", - "inputFileKey", - "roleArn" - ], - "members":{ - "templateBody":{ - "shape":"TemplateBody", - "documentation":"

The provisioning template.

" - }, - "inputFileBucket":{ - "shape":"RegistryS3BucketName", - "documentation":"

The S3 bucket that contains the input file.

" - }, - "inputFileKey":{ - "shape":"RegistryS3KeyName", - "documentation":"

The name of input file within the S3 bucket. This file contains a newline delimited JSON file. Each line contains the parameter values to provision one device (thing).

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The IAM role ARN that grants permission the input file.

" - } - } - }, - "StartThingRegistrationTaskResponse":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"TaskId", - "documentation":"

The bulk thing provisioning task ID.

" - } - } - }, - "StateMachineName":{"type":"string"}, - "StateReason":{"type":"string"}, - "StateValue":{"type":"string"}, - "Status":{ - "type":"string", - "enum":[ - "InProgress", - "Completed", - "Failed", - "Cancelled", - "Cancelling" - ] - }, - "StepFunctionsAction":{ - "type":"structure", - "required":[ - "stateMachineName", - "roleArn" - ], - "members":{ - "executionNamePrefix":{ - "shape":"ExecutionNamePrefix", - "documentation":"

(Optional) A name will be given to the state machine execution consisting of this prefix followed by a UUID. Step Functions automatically creates a unique name for each state machine execution if one is not provided.

" - }, - "stateMachineName":{ - "shape":"StateMachineName", - "documentation":"

The name of the Step Functions state machine whose execution will be started.

" - }, - "roleArn":{ - "shape":"AwsArn", - "documentation":"

The ARN of the role that grants IoT permission to start execution of a state machine (\"Action\":\"states:StartExecution\").

" - } - }, - "documentation":"

Starts execution of a Step Functions state machine.

" - }, - "StopThingRegistrationTaskRequest":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"TaskId", - "documentation":"

The bulk thing provisioning task ID.

", - "location":"uri", - "locationName":"taskId" - } - } - }, - "StopThingRegistrationTaskResponse":{ - "type":"structure", - "members":{ - } - }, - "Stream":{ - "type":"structure", - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

" - }, - "fileId":{ - "shape":"FileId", - "documentation":"

The ID of a file associated with a stream.

" - } - }, - "documentation":"

Describes a group of files that can be streamed.

" - }, - "StreamArn":{"type":"string"}, - "StreamDescription":{ - "type":"string", - "max":2028, - "pattern":"[^\\p{C}]+" - }, - "StreamFile":{ - "type":"structure", - "members":{ - "fileId":{ - "shape":"FileId", - "documentation":"

The file ID.

" - }, - "s3Location":{ - "shape":"S3Location", - "documentation":"

The location of the file in S3.

" - } - }, - "documentation":"

Represents a file to stream.

" - }, - "StreamFiles":{ - "type":"list", - "member":{"shape":"StreamFile"}, - "max":10, - "min":1 - }, - "StreamId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "StreamInfo":{ - "type":"structure", - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

" - }, - "streamArn":{ - "shape":"StreamArn", - "documentation":"

The stream ARN.

" - }, - "streamVersion":{ - "shape":"StreamVersion", - "documentation":"

The stream version.

" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

The description of the stream.

" - }, - "files":{ - "shape":"StreamFiles", - "documentation":"

The files to stream.

" - }, - "createdAt":{ - "shape":"DateType", - "documentation":"

The date when the stream was created.

" - }, - "lastUpdatedAt":{ - "shape":"DateType", - "documentation":"

The date when the stream was last updated.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

An IAM role AWS IoT assumes to access your S3 files.

" - } - }, - "documentation":"

Information about a stream.

" - }, - "StreamName":{"type":"string"}, - "StreamSummary":{ - "type":"structure", - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

" - }, - "streamArn":{ - "shape":"StreamArn", - "documentation":"

The stream ARN.

" - }, - "streamVersion":{ - "shape":"StreamVersion", - "documentation":"

The stream version.

" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

A description of the stream.

" - } - }, - "documentation":"

A summary of a stream.

" - }, - "StreamVersion":{ - "type":"integer", - "max":65535, - "min":0 - }, - "StreamsSummary":{ - "type":"list", - "member":{"shape":"StreamSummary"} - }, - "String":{"type":"string"}, - "StringMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "SucceededThings":{"type":"integer"}, - "TableName":{"type":"string"}, - "Target":{"type":"string"}, - "TargetArn":{"type":"string"}, - "TargetAuditCheckNames":{ - "type":"list", - "member":{"shape":"AuditCheckName"} - }, - "TargetSelection":{ - "type":"string", - "enum":[ - "CONTINUOUS", - "SNAPSHOT" - ] - }, - "Targets":{ - "type":"list", - "member":{"shape":"Target"}, - "min":1 - }, - "TaskId":{ - "type":"string", - "max":40 - }, - "TaskIdList":{ - "type":"list", - "member":{"shape":"TaskId"} - }, - "TaskStatistics":{ - "type":"structure", - "members":{ - "totalChecks":{ - "shape":"TotalChecksCount", - "documentation":"

The number of checks in this audit.

" - }, - "inProgressChecks":{ - "shape":"InProgressChecksCount", - "documentation":"

The number of checks in progress.

" - }, - "waitingForDataCollectionChecks":{ - "shape":"WaitingForDataCollectionChecksCount", - "documentation":"

The number of checks waiting for data collection.

" - }, - "compliantChecks":{ - "shape":"CompliantChecksCount", - "documentation":"

The number of checks that found compliant resources.

" - }, - "nonCompliantChecks":{ - "shape":"NonCompliantChecksCount", - "documentation":"

The number of checks that found non-compliant resources.

" - }, - "failedChecks":{ - "shape":"FailedChecksCount", - "documentation":"

The number of checks

" - }, - "canceledChecks":{ - "shape":"CanceledChecksCount", - "documentation":"

The number of checks that did not run because the audit was canceled.

" - } - }, - "documentation":"

Statistics for the checks performed during the audit.

" - }, - "TemplateBody":{"type":"string"}, - "TestAuthorizationRequest":{ - "type":"structure", - "required":["authInfos"], - "members":{ - "principal":{ - "shape":"Principal", - "documentation":"

The principal.

" - }, - "cognitoIdentityPoolId":{ - "shape":"CognitoIdentityPoolId", - "documentation":"

The Cognito identity pool ID.

" - }, - "authInfos":{ - "shape":"AuthInfos", - "documentation":"

A list of authorization info objects. Simulating authorization will create a response for each authInfo object in the list.

" - }, - "clientId":{ - "shape":"ClientId", - "documentation":"

The MQTT client ID.

", - "location":"querystring", - "locationName":"clientId" - }, - "policyNamesToAdd":{ - "shape":"PolicyNames", - "documentation":"

When testing custom authorization, the policies specified here are treated as if they are attached to the principal being authorized.

" - }, - "policyNamesToSkip":{ - "shape":"PolicyNames", - "documentation":"

When testing custom authorization, the policies specified here are treated as if they are not attached to the principal being authorized.

" - } - } - }, - "TestAuthorizationResponse":{ - "type":"structure", - "members":{ - "authResults":{ - "shape":"AuthResults", - "documentation":"

The authentication results.

" - } - } - }, - "TestInvokeAuthorizerRequest":{ - "type":"structure", - "required":[ - "authorizerName", - "token", - "tokenSignature" - ], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The custom authorizer name.

", - "location":"uri", - "locationName":"authorizerName" - }, - "token":{ - "shape":"Token", - "documentation":"

The token returned by your custom authentication service.

" - }, - "tokenSignature":{ - "shape":"TokenSignature", - "documentation":"

The signature made with the token and your custom authentication service's private key.

" - } - } - }, - "TestInvokeAuthorizerResponse":{ - "type":"structure", - "members":{ - "isAuthenticated":{ - "shape":"IsAuthenticated", - "documentation":"

True if the token is authenticated, otherwise false.

" - }, - "principalId":{ - "shape":"PrincipalId", - "documentation":"

The principal ID.

" - }, - "policyDocuments":{ - "shape":"PolicyDocuments", - "documentation":"

IAM policy documents.

" - }, - "refreshAfterInSeconds":{ - "shape":"Seconds", - "documentation":"

The number of seconds after which the temporary credentials are refreshed.

" - }, - "disconnectAfterInSeconds":{ - "shape":"Seconds", - "documentation":"

The number of seconds after which the connection is terminated.

" - } - } - }, - "ThingArn":{"type":"string"}, - "ThingAttribute":{ - "type":"structure", - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing.

" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type, if the thing has been associated with a type.

" - }, - "thingArn":{ - "shape":"ThingArn", - "documentation":"

The thing ARN.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

A list of thing attributes which are name-value pairs.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the thing record in the registry.

" - } - }, - "documentation":"

The properties of the thing, including thing name, thing type name, and a list of thing attributes.

" - }, - "ThingAttributeList":{ - "type":"list", - "member":{"shape":"ThingAttribute"} - }, - "ThingDocument":{ - "type":"structure", - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing name.

" - }, - "thingId":{ - "shape":"ThingId", - "documentation":"

The thing ID.

" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The thing type name.

" - }, - "thingGroupNames":{ - "shape":"ThingGroupNameList", - "documentation":"

Thing group names.

" - }, - "attributes":{ - "shape":"Attributes", - "documentation":"

The attributes.

" - }, - "shadow":{ - "shape":"JsonDocument", - "documentation":"

The shadow.

" - } - }, - "documentation":"

The thing search index document.

" - }, - "ThingDocumentList":{ - "type":"list", - "member":{"shape":"ThingDocument"} - }, - "ThingGroupArn":{"type":"string"}, - "ThingGroupDescription":{ - "type":"string", - "max":2028, - "pattern":"[\\p{Graph}\\x20]*" - }, - "ThingGroupId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9\\-]+" - }, - "ThingGroupList":{ - "type":"list", - "member":{"shape":"ThingGroupName"} - }, - "ThingGroupMetadata":{ - "type":"structure", - "members":{ - "parentGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The parent thing group name.

" - }, - "rootToParentThingGroups":{ - "shape":"ThingGroupNameAndArnList", - "documentation":"

The root parent thing group.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The UNIX timestamp of when the thing group was created.

" - } - }, - "documentation":"

Thing group metadata.

" - }, - "ThingGroupName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "ThingGroupNameAndArnList":{ - "type":"list", - "member":{"shape":"GroupNameAndArn"} - }, - "ThingGroupNameList":{ - "type":"list", - "member":{"shape":"ThingGroupName"} - }, - "ThingGroupProperties":{ - "type":"structure", - "members":{ - "thingGroupDescription":{ - "shape":"ThingGroupDescription", - "documentation":"

The thing group description.

" - }, - "attributePayload":{ - "shape":"AttributePayload", - "documentation":"

The thing group attributes in JSON format.

" - } - }, - "documentation":"

Thing group properties.

" - }, - "ThingId":{"type":"string"}, - "ThingIndexingConfiguration":{ - "type":"structure", - "members":{ - "thingIndexingMode":{ - "shape":"ThingIndexingMode", - "documentation":"

Thing indexing mode. Valid values are:

  • REGISTRY – Your thing index will contain only registry data.

  • REGISTRY_AND_SHADOW - Your thing index will contain registry and shadow data.

  • OFF - Thing indexing is disabled.

" - } - }, - "documentation":"

Thing indexing configuration.

" - }, - "ThingIndexingMode":{ - "type":"string", - "enum":[ - "OFF", - "REGISTRY", - "REGISTRY_AND_SHADOW" - ] - }, - "ThingName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "ThingNameList":{ - "type":"list", - "member":{"shape":"ThingName"} - }, - "ThingTypeArn":{"type":"string"}, - "ThingTypeDefinition":{ - "type":"structure", - "members":{ - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

" - }, - "thingTypeArn":{ - "shape":"ThingTypeArn", - "documentation":"

The thing type ARN.

" - }, - "thingTypeProperties":{ - "shape":"ThingTypeProperties", - "documentation":"

The ThingTypeProperties for the thing type.

" - }, - "thingTypeMetadata":{ - "shape":"ThingTypeMetadata", - "documentation":"

The ThingTypeMetadata contains additional information about the thing type including: creation date and time, a value indicating whether the thing type is deprecated, and a date and time when it was deprecated.

" - } - }, - "documentation":"

The definition of the thing type, including thing type name and description.

" - }, - "ThingTypeDescription":{ - "type":"string", - "max":2028, - "pattern":"[\\p{Graph}\\x20]*" - }, - "ThingTypeId":{"type":"string"}, - "ThingTypeList":{ - "type":"list", - "member":{"shape":"ThingTypeDefinition"} - }, - "ThingTypeMetadata":{ - "type":"structure", - "members":{ - "deprecated":{ - "shape":"Boolean", - "documentation":"

Whether the thing type is deprecated. If true, no new things could be associated with this type.

" - }, - "deprecationDate":{ - "shape":"DeprecationDate", - "documentation":"

The date and time when the thing type was deprecated.

" - }, - "creationDate":{ - "shape":"CreationDate", - "documentation":"

The date and time when the thing type was created.

" - } - }, - "documentation":"

The ThingTypeMetadata contains additional information about the thing type including: creation date and time, a value indicating whether the thing type is deprecated, and a date and time when time was deprecated.

" - }, - "ThingTypeName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9:_-]+" - }, - "ThingTypeProperties":{ - "type":"structure", - "members":{ - "thingTypeDescription":{ - "shape":"ThingTypeDescription", - "documentation":"

The description of the thing type.

" - }, - "searchableAttributes":{ - "shape":"SearchableAttributes", - "documentation":"

A list of searchable thing attribute names.

" - } - }, - "documentation":"

The ThingTypeProperties contains information about the thing type including: a thing type description, and a list of searchable thing attribute names.

" - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The rate exceeds the limit.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "Token":{ - "type":"string", - "max":6144, - "min":1 - }, - "TokenKeyName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_-]+" - }, - "TokenSignature":{ - "type":"string", - "max":2560, - "min":1, - "pattern":"[A-Za-z0-9+/]+={0,2}" - }, - "Topic":{"type":"string"}, - "TopicPattern":{"type":"string"}, - "TopicRule":{ - "type":"structure", - "members":{ - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "sql":{ - "shape":"SQL", - "documentation":"

The SQL statement used to query the topic. When using a SQL query with multiple lines, be sure to escape the newline characters.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the rule.

" - }, - "createdAt":{ - "shape":"CreatedAtDate", - "documentation":"

The date and time the rule was created.

" - }, - "actions":{ - "shape":"ActionList", - "documentation":"

The actions associated with the rule.

" - }, - "ruleDisabled":{ - "shape":"IsDisabled", - "documentation":"

Specifies whether the rule is disabled.

" - }, - "awsIotSqlVersion":{ - "shape":"AwsIotSqlVersion", - "documentation":"

The version of the SQL rules engine to use when evaluating the rule.

" - }, - "errorAction":{ - "shape":"Action", - "documentation":"

The action to perform when an error occurs.

" - } - }, - "documentation":"

Describes a rule.

" - }, - "TopicRuleList":{ - "type":"list", - "member":{"shape":"TopicRuleListItem"} - }, - "TopicRuleListItem":{ - "type":"structure", - "members":{ - "ruleArn":{ - "shape":"RuleArn", - "documentation":"

The rule ARN.

" - }, - "ruleName":{ - "shape":"RuleName", - "documentation":"

The name of the rule.

" - }, - "topicPattern":{ - "shape":"TopicPattern", - "documentation":"

The pattern for the topic names that apply.

" - }, - "createdAt":{ - "shape":"CreatedAtDate", - "documentation":"

The date and time the rule was created.

" - }, - "ruleDisabled":{ - "shape":"IsDisabled", - "documentation":"

Specifies whether the rule is disabled.

" - } - }, - "documentation":"

Describes a rule.

" - }, - "TopicRulePayload":{ - "type":"structure", - "required":[ - "sql", - "actions" - ], - "members":{ - "sql":{ - "shape":"SQL", - "documentation":"

The SQL statement used to query the topic. For more information, see AWS IoT SQL Reference in the AWS IoT Developer Guide.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the rule.

" - }, - "actions":{ - "shape":"ActionList", - "documentation":"

The actions associated with the rule.

" - }, - "ruleDisabled":{ - "shape":"IsDisabled", - "documentation":"

Specifies whether the rule is disabled.

" - }, - "awsIotSqlVersion":{ - "shape":"AwsIotSqlVersion", - "documentation":"

The version of the SQL rules engine to use when evaluating the rule.

" - }, - "errorAction":{ - "shape":"Action", - "documentation":"

The action to take when an error occurs.

" - } - }, - "documentation":"

Describes a rule.

" - }, - "TotalChecksCount":{"type":"integer"}, - "TotalResourcesCount":{"type":"long"}, - "TransferAlreadyCompletedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

You can't revert the certificate transfer because the transfer is already complete.

", - "error":{"httpStatusCode":410}, - "exception":true - }, - "TransferCertificateRequest":{ - "type":"structure", - "required":[ - "certificateId", - "targetAwsAccount" - ], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - }, - "targetAwsAccount":{ - "shape":"AwsAccountId", - "documentation":"

The AWS account.

", - "location":"querystring", - "locationName":"targetAwsAccount" - }, - "transferMessage":{ - "shape":"Message", - "documentation":"

The transfer message.

" - } - }, - "documentation":"

The input for the TransferCertificate operation.

" - }, - "TransferCertificateResponse":{ - "type":"structure", - "members":{ - "transferredCertificateArn":{ - "shape":"CertificateArn", - "documentation":"

The ARN of the certificate.

" - } - }, - "documentation":"

The output from the TransferCertificate operation.

" - }, - "TransferConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

You can't transfer the certificate because authorization policies are still attached.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "TransferData":{ - "type":"structure", - "members":{ - "transferMessage":{ - "shape":"Message", - "documentation":"

The transfer message.

" - }, - "rejectReason":{ - "shape":"Message", - "documentation":"

The reason why the transfer was rejected.

" - }, - "transferDate":{ - "shape":"DateType", - "documentation":"

The date the transfer took place.

" - }, - "acceptDate":{ - "shape":"DateType", - "documentation":"

The date the transfer was accepted.

" - }, - "rejectDate":{ - "shape":"DateType", - "documentation":"

The date the transfer was rejected.

" - } - }, - "documentation":"

Data used to transfer a certificate to an AWS account.

" - }, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

You are not authorized to perform this operation.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UndoDeprecate":{"type":"boolean"}, - "UnsignedLong":{ - "type":"long", - "min":0 - }, - "UpdateAccountAuditConfigurationRequest":{ - "type":"structure", - "members":{ - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that grants permission to AWS IoT to access information about your devices, policies, certificates and other items as necessary when performing an audit.

" - }, - "auditNotificationTargetConfigurations":{ - "shape":"AuditNotificationTargetConfigurations", - "documentation":"

Information about the targets to which audit notifications are sent.

" - }, - "auditCheckConfigurations":{ - "shape":"AuditCheckConfigurations", - "documentation":"

Specifies which audit checks are enabled and disabled for this account. Use DescribeAccountAuditConfiguration to see the list of all checks including those that are currently enabled.

Note that some data collection may begin immediately when certain checks are enabled. When a check is disabled, any data collected so far in relation to the check is deleted.

You cannot disable a check if it is used by any scheduled audit. You must first delete the check from the scheduled audit or delete the scheduled audit itself.

On the first call to UpdateAccountAuditConfiguration this parameter is required and must specify at least one enabled check.

" - } - } - }, - "UpdateAccountAuditConfigurationResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateAuthorizerRequest":{ - "type":"structure", - "required":["authorizerName"], - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

", - "location":"uri", - "locationName":"authorizerName" - }, - "authorizerFunctionArn":{ - "shape":"AuthorizerFunctionArn", - "documentation":"

The ARN of the authorizer's Lambda function.

" - }, - "tokenKeyName":{ - "shape":"TokenKeyName", - "documentation":"

The key used to extract the token from the HTTP headers.

" - }, - "tokenSigningPublicKeys":{ - "shape":"PublicKeyMap", - "documentation":"

The public keys used to verify the token signature.

" - }, - "status":{ - "shape":"AuthorizerStatus", - "documentation":"

The status of the update authorizer request.

" - } - } - }, - "UpdateAuthorizerResponse":{ - "type":"structure", - "members":{ - "authorizerName":{ - "shape":"AuthorizerName", - "documentation":"

The authorizer name.

" - }, - "authorizerArn":{ - "shape":"AuthorizerArn", - "documentation":"

The authorizer ARN.

" - } - } - }, - "UpdateCACertificateRequest":{ - "type":"structure", - "required":["certificateId"], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The CA certificate identifier.

", - "location":"uri", - "locationName":"caCertificateId" - }, - "newStatus":{ - "shape":"CACertificateStatus", - "documentation":"

The updated status of the CA certificate.

Note: The status value REGISTER_INACTIVE is deprecated and should not be used.

", - "location":"querystring", - "locationName":"newStatus" - }, - "newAutoRegistrationStatus":{ - "shape":"AutoRegistrationStatus", - "documentation":"

The new value for the auto registration status. Valid values are: \"ENABLE\" or \"DISABLE\".

", - "location":"querystring", - "locationName":"newAutoRegistrationStatus" - }, - "registrationConfig":{ - "shape":"RegistrationConfig", - "documentation":"

Information about the registration configuration.

" - }, - "removeAutoRegistration":{ - "shape":"RemoveAutoRegistration", - "documentation":"

If true, remove auto registration.

" - } - }, - "documentation":"

The input to the UpdateCACertificate operation.

" - }, - "UpdateCertificateRequest":{ - "type":"structure", - "required":[ - "certificateId", - "newStatus" - ], - "members":{ - "certificateId":{ - "shape":"CertificateId", - "documentation":"

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

", - "location":"uri", - "locationName":"certificateId" - }, - "newStatus":{ - "shape":"CertificateStatus", - "documentation":"

The new status.

Note: Setting the status to PENDING_TRANSFER will result in an exception being thrown. PENDING_TRANSFER is a status used internally by AWS IoT. It is not intended for developer use.

Note: The status value REGISTER_INACTIVE is deprecated and should not be used.

", - "location":"querystring", - "locationName":"newStatus" - } - }, - "documentation":"

The input for the UpdateCertificate operation.

" - }, - "UpdateEventConfigurationsRequest":{ - "type":"structure", - "members":{ - "eventConfigurations":{ - "shape":"EventConfigurations", - "documentation":"

The new event configuration values.

" - } - } - }, - "UpdateEventConfigurationsResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateIndexingConfigurationRequest":{ - "type":"structure", - "members":{ - "thingIndexingConfiguration":{ - "shape":"ThingIndexingConfiguration", - "documentation":"

Thing indexing configuration.

" - } - } - }, - "UpdateIndexingConfigurationResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateRoleAliasRequest":{ - "type":"structure", - "required":["roleAlias"], - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias to update.

", - "location":"uri", - "locationName":"roleAlias" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The role ARN.

" - }, - "credentialDurationSeconds":{ - "shape":"CredentialDurationSeconds", - "documentation":"

The number of seconds the credential will be valid.

" - } - } - }, - "UpdateRoleAliasResponse":{ - "type":"structure", - "members":{ - "roleAlias":{ - "shape":"RoleAlias", - "documentation":"

The role alias.

" - }, - "roleAliasArn":{ - "shape":"RoleAliasArn", - "documentation":"

The role alias ARN.

" - } - } - }, - "UpdateScheduledAuditRequest":{ - "type":"structure", - "required":["scheduledAuditName"], - "members":{ - "frequency":{ - "shape":"AuditFrequency", - "documentation":"

How often the scheduled audit takes place. Can be one of \"DAILY\", \"WEEKLY\", \"BIWEEKLY\" or \"MONTHLY\". The actual start time of each audit is determined by the system.

" - }, - "dayOfMonth":{ - "shape":"DayOfMonth", - "documentation":"

The day of the month on which the scheduled audit takes place. Can be \"1\" through \"31\" or \"LAST\". This field is required if the \"frequency\" parameter is set to \"MONTHLY\". If days 29-31 are specified, and the month does not have that many days, the audit takes place on the \"LAST\" day of the month.

" - }, - "dayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

The day of the week on which the scheduled audit takes place. Can be one of \"SUN\", \"MON\", \"TUE\", \"WED\", \"THU\", \"FRI\" or \"SAT\". This field is required if the \"frequency\" parameter is set to \"WEEKLY\" or \"BIWEEKLY\".

" - }, - "targetCheckNames":{ - "shape":"TargetAuditCheckNames", - "documentation":"

Which checks are performed during the scheduled audit. Checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks including those that are enabled or UpdateAccountAuditConfiguration to select which checks are enabled.)

" - }, - "scheduledAuditName":{ - "shape":"ScheduledAuditName", - "documentation":"

The name of the scheduled audit. (Max. 128 chars)

", - "location":"uri", - "locationName":"scheduledAuditName" - } - } - }, - "UpdateScheduledAuditResponse":{ - "type":"structure", - "members":{ - "scheduledAuditArn":{ - "shape":"ScheduledAuditArn", - "documentation":"

The ARN of the scheduled audit.

" - } - } - }, - "UpdateSecurityProfileRequest":{ - "type":"structure", - "required":["securityProfileName"], - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile you want to update.

", - "location":"uri", - "locationName":"securityProfileName" - }, - "securityProfileDescription":{ - "shape":"SecurityProfileDescription", - "documentation":"

A description of the security profile.

" - }, - "behaviors":{ - "shape":"Behaviors", - "documentation":"

Specifies the behaviors that, when violated by a device (thing), cause an alert.

" - }, - "alertTargets":{ - "shape":"AlertTargets", - "documentation":"

Where the alerts are sent. (Alerts are always sent to the console.)

" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the security profile. A new version is generated whenever the security profile is updated. If you specify a value that is different than the actual version, a VersionConflictException is thrown.

", - "location":"querystring", - "locationName":"expectedVersion" - } - } - }, - "UpdateSecurityProfileResponse":{ - "type":"structure", - "members":{ - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile that was updated.

" - }, - "securityProfileArn":{ - "shape":"SecurityProfileArn", - "documentation":"

The ARN of the security profile that was updated.

" - }, - "securityProfileDescription":{ - "shape":"SecurityProfileDescription", - "documentation":"

The description of the security profile.

" - }, - "behaviors":{ - "shape":"Behaviors", - "documentation":"

Specifies the behaviors that, when violated by a device (thing), cause an alert.

" - }, - "alertTargets":{ - "shape":"AlertTargets", - "documentation":"

Where the alerts are sent. (Alerts are always sent to the console.)

" - }, - "version":{ - "shape":"Version", - "documentation":"

The updated version of the security profile.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The time the security profile was created.

" - }, - "lastModifiedDate":{ - "shape":"Timestamp", - "documentation":"

The time the security profile was last modified.

" - } - } - }, - "UpdateStreamRequest":{ - "type":"structure", - "required":["streamId"], - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

", - "location":"uri", - "locationName":"streamId" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

The description of the stream.

" - }, - "files":{ - "shape":"StreamFiles", - "documentation":"

The files associated with the stream.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

An IAM role that allows the IoT service principal assumes to access your S3 files.

" - } - } - }, - "UpdateStreamResponse":{ - "type":"structure", - "members":{ - "streamId":{ - "shape":"StreamId", - "documentation":"

The stream ID.

" - }, - "streamArn":{ - "shape":"StreamArn", - "documentation":"

The stream ARN.

" - }, - "description":{ - "shape":"StreamDescription", - "documentation":"

A description of the stream.

" - }, - "streamVersion":{ - "shape":"StreamVersion", - "documentation":"

The stream version.

" - } - } - }, - "UpdateThingGroupRequest":{ - "type":"structure", - "required":[ - "thingGroupName", - "thingGroupProperties" - ], - "members":{ - "thingGroupName":{ - "shape":"ThingGroupName", - "documentation":"

The thing group to update.

", - "location":"uri", - "locationName":"thingGroupName" - }, - "thingGroupProperties":{ - "shape":"ThingGroupProperties", - "documentation":"

The thing group properties.

" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the thing group. If this does not match the version of the thing group being updated, the update will fail.

" - } - } - }, - "UpdateThingGroupResponse":{ - "type":"structure", - "members":{ - "version":{ - "shape":"Version", - "documentation":"

The version of the updated thing group.

" - } - } - }, - "UpdateThingGroupsForThingRequest":{ - "type":"structure", - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The thing whose group memberships will be updated.

" - }, - "thingGroupsToAdd":{ - "shape":"ThingGroupList", - "documentation":"

The groups to which the thing will be added.

" - }, - "thingGroupsToRemove":{ - "shape":"ThingGroupList", - "documentation":"

The groups from which the thing will be removed.

" - } - } - }, - "UpdateThingGroupsForThingResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateThingRequest":{ - "type":"structure", - "required":["thingName"], - "members":{ - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing to update.

", - "location":"uri", - "locationName":"thingName" - }, - "thingTypeName":{ - "shape":"ThingTypeName", - "documentation":"

The name of the thing type.

" - }, - "attributePayload":{ - "shape":"AttributePayload", - "documentation":"

A list of thing attributes, a JSON string containing name-value pairs. For example:

{\\\"attributes\\\":{\\\"name1\\\":\\\"value2\\\"}}

This data is used to add new attributes or update existing attributes.

" - }, - "expectedVersion":{ - "shape":"OptionalVersion", - "documentation":"

The expected version of the thing record in the registry. If the version of the record in the registry does not match the expected version specified in the request, the UpdateThing request is rejected with a VersionConflictException.

" - }, - "removeThingType":{ - "shape":"RemoveThingType", - "documentation":"

Remove a thing type association. If true, the association is removed.

" - } - }, - "documentation":"

The input for the UpdateThing operation.

" - }, - "UpdateThingResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output from the UpdateThing operation.

" - }, - "UseBase64":{"type":"boolean"}, - "Valid":{"type":"boolean"}, - "ValidateSecurityProfileBehaviorsRequest":{ - "type":"structure", - "required":["behaviors"], - "members":{ - "behaviors":{ - "shape":"Behaviors", - "documentation":"

Specifies the behaviors that, when violated by a device (thing), cause an alert.

" - } - } - }, - "ValidateSecurityProfileBehaviorsResponse":{ - "type":"structure", - "members":{ - "valid":{ - "shape":"Valid", - "documentation":"

True if the behaviors were valid.

" - }, - "validationErrors":{ - "shape":"ValidationErrors", - "documentation":"

The list of any errors found in the behaviors.

" - } - } - }, - "ValidationError":{ - "type":"structure", - "members":{ - "errorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The description of an error found in the behaviors.

" - } - }, - "documentation":"

Information about an error found in a behavior specification.

" - }, - "ValidationErrors":{ - "type":"list", - "member":{"shape":"ValidationError"} - }, - "Value":{"type":"string"}, - "Version":{"type":"long"}, - "VersionConflictException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

An exception thrown when the version of an entity specified with the expectedVersion parameter does not match the latest version in the system.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "VersionNumber":{"type":"long"}, - "VersionsLimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"errorMessage", - "documentation":"

The message for the exception.

" - } - }, - "documentation":"

The number of policy versions exceeds the limit.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ViolationEvent":{ - "type":"structure", - "members":{ - "violationId":{ - "shape":"ViolationId", - "documentation":"

The ID of the violation event.

" - }, - "thingName":{ - "shape":"ThingName", - "documentation":"

The name of the thing responsible for the violation event.

" - }, - "securityProfileName":{ - "shape":"SecurityProfileName", - "documentation":"

The name of the security profile whose behavior was violated.

" - }, - "behavior":{ - "shape":"Behavior", - "documentation":"

The behavior which was violated.

" - }, - "metricValue":{ - "shape":"MetricValue", - "documentation":"

The value of the metric (the measurement).

" - }, - "violationEventType":{ - "shape":"ViolationEventType", - "documentation":"

The type of violation event.

" - }, - "violationEventTime":{ - "shape":"Timestamp", - "documentation":"

The time the violation event occurred.

" - } - }, - "documentation":"

Information about a Device Defender security profile behavior violation.

" - }, - "ViolationEventType":{ - "type":"string", - "enum":[ - "in-alarm", - "alarm-cleared", - "alarm-invalidated" - ] - }, - "ViolationEvents":{ - "type":"list", - "member":{"shape":"ViolationEvent"} - }, - "ViolationId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9\\-]+" - }, - "WaitingForDataCollectionChecksCount":{"type":"integer"}, - "errorMessage":{"type":"string"}, - "resourceArn":{"type":"string"}, - "resourceId":{"type":"string"} - }, - "documentation":"AWS IoT

AWS IoT provides secure, bi-directional communication between Internet-connected devices (such as sensors, actuators, embedded devices, or smart appliances) and the AWS cloud. You can discover your custom IoT-Data endpoint to communicate with, configure rules for data processing and integration with other services, organize resources associated with each device (Registry), configure logging, and create and manage policies and credentials to authenticate devices.

For more information about how AWS IoT works, see the Developer Guide.

For information about how to use the credentials provider for AWS IoT, see Authorizing Direct Calls to AWS Services.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-devices/2018-05-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-devices/2018-05-14/service-2.json deleted file mode 100644 index 127c6d12..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-devices/2018-05-14/service-2.json +++ /dev/null @@ -1,889 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2018-05-14", - "endpointPrefix" : "devices.iot1click", - "signingName" : "iot1click", - "serviceFullName" : "AWS IoT 1-Click Devices Service", - "serviceId" : "IoT 1Click Devices Service", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "devices-2018-05-14", - "signatureVersion" : "v4" - }, - "operations" : { - "ClaimDevicesByClaimCode" : { - "name" : "ClaimDevicesByClaimCode", - "http" : { - "method" : "PUT", - "requestUri" : "/claims/{claimCode}", - "responseCode" : 200 - }, - "input" : { - "shape" : "ClaimDevicesByClaimCodeRequest" - }, - "output" : { - "shape" : "ClaimDevicesByClaimCodeResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

403 response

" - } ], - "documentation" : "

Adds device(s) to your account (i.e., claim one or more devices) if and only if\n you received a claim code with the device(s).

" - }, - "DescribeDevice" : { - "name" : "DescribeDevice", - "http" : { - "method" : "GET", - "requestUri" : "/devices/{deviceId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DescribeDeviceRequest" - }, - "output" : { - "shape" : "DescribeDeviceResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Given a device ID, returns a DescribeDeviceResponse object describing\n the details of the device.

" - }, - "FinalizeDeviceClaim" : { - "name" : "FinalizeDeviceClaim", - "http" : { - "method" : "PUT", - "requestUri" : "/devices/{deviceId}/finalize-claim", - "responseCode" : 200 - }, - "input" : { - "shape" : "FinalizeDeviceClaimRequest" - }, - "output" : { - "shape" : "FinalizeDeviceClaimResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - }, { - "shape" : "PreconditionFailedException", - "documentation" : "

412 response

" - }, { - "shape" : "ResourceConflictException", - "documentation" : "

409 response

" - } ], - "documentation" : "

Given a device ID, finalizes the claim request for the associated device.

\n

Claiming a device consists of initiating a claim, then publishing a device\n event, and finalizing the claim. For a device of type button, a\n device event can be published by simply clicking the device.

\n
" - }, - "GetDeviceMethods" : { - "name" : "GetDeviceMethods", - "http" : { - "method" : "GET", - "requestUri" : "/devices/{deviceId}/methods", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetDeviceMethodsRequest" - }, - "output" : { - "shape" : "GetDeviceMethodsResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Given a device ID, returns the invokable methods associated with the\n device.

" - }, - "InitiateDeviceClaim" : { - "name" : "InitiateDeviceClaim", - "http" : { - "method" : "PUT", - "requestUri" : "/devices/{deviceId}/initiate-claim", - "responseCode" : 200 - }, - "input" : { - "shape" : "InitiateDeviceClaimRequest" - }, - "output" : { - "shape" : "InitiateDeviceClaimResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - }, { - "shape" : "ResourceConflictException", - "documentation" : "

409 response

" - } ], - "documentation" : "

Given a device ID, initiates a claim request for the associated device.

\n

Claiming a device consists of initiating a claim, then publishing a device\n event, and finalizing the claim. For a device of type button, a\n device event can be published by simply clicking the device.

\n
" - }, - "InvokeDeviceMethod" : { - "name" : "InvokeDeviceMethod", - "http" : { - "method" : "POST", - "requestUri" : "/devices/{deviceId}/methods", - "responseCode" : 200 - }, - "input" : { - "shape" : "InvokeDeviceMethodRequest" - }, - "output" : { - "shape" : "InvokeDeviceMethodResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "PreconditionFailedException", - "documentation" : "

412 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - }, { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "RangeNotSatisfiableException", - "documentation" : "

416 response

" - }, { - "shape" : "ResourceConflictException", - "documentation" : "

409 response

" - } ], - "documentation" : "

Given a device ID, issues a request to invoke a named device method (with possible\n parameters). See the \"Example POST\" code snippet below.

" - }, - "ListDeviceEvents" : { - "name" : "ListDeviceEvents", - "http" : { - "method" : "GET", - "requestUri" : "/devices/{deviceId}/events", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDeviceEventsRequest" - }, - "output" : { - "shape" : "ListDeviceEventsResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "RangeNotSatisfiableException", - "documentation" : "

416 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Using a device ID, returns a DeviceEventsResponse object containing\n an array of events for the device.

" - }, - "ListDevices" : { - "name" : "ListDevices", - "http" : { - "method" : "GET", - "requestUri" : "/devices", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListDevicesRequest" - }, - "output" : { - "shape" : "ListDevicesResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "RangeNotSatisfiableException", - "documentation" : "

416 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Lists the 1-Click compatible devices associated with your AWS account.

" - }, - "UnclaimDevice" : { - "name" : "UnclaimDevice", - "http" : { - "method" : "PUT", - "requestUri" : "/devices/{deviceId}/unclaim", - "responseCode" : 200 - }, - "input" : { - "shape" : "UnclaimDeviceRequest" - }, - "output" : { - "shape" : "UnclaimDeviceResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Disassociates a device from your AWS account using its device ID.

" - }, - "UpdateDeviceState" : { - "name" : "UpdateDeviceState", - "http" : { - "method" : "PUT", - "requestUri" : "/devices/{deviceId}/state", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateDeviceStateRequest" - }, - "output" : { - "shape" : "UpdateDeviceStateResponse", - "documentation" : "

200 response

" - }, - "errors" : [ { - "shape" : "ResourceNotFoundException", - "documentation" : "

404 response

" - }, { - "shape" : "InvalidRequestException", - "documentation" : "

400 response

" - }, { - "shape" : "InternalFailureException", - "documentation" : "

500 response

" - } ], - "documentation" : "

Using a Boolean value (true or false), this operation\n enables or disables the device given a device ID.

" - } - }, - "shapes" : { - "Attributes" : { - "type" : "structure", - "members" : { } - }, - "ClaimDevicesByClaimCodeRequest" : { - "type" : "structure", - "members" : { - "ClaimCode" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "claimCode", - "documentation" : "

The claim code, starting with \"C-\", as provided by the device manufacturer.

" - } - }, - "required" : [ "ClaimCode" ] - }, - "ClaimDevicesByClaimCodeResponse" : { - "type" : "structure", - "members" : { - "ClaimCode" : { - "shape" : "__stringMin12Max40", - "locationName" : "claimCode", - "documentation" : "

The claim code provided by the device manufacturer.

" - }, - "Total" : { - "shape" : "__integer", - "locationName" : "total", - "documentation" : "

The total number of devices associated with the claim code that has been processed\n in the claim request.

" - } - } - }, - "DescribeDeviceRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - } - }, - "required" : [ "DeviceId" ] - }, - "DescribeDeviceResponse" : { - "type" : "structure", - "members" : { - "DeviceDescription" : { - "shape" : "DeviceDescription", - "locationName" : "deviceDescription", - "documentation" : "

Device details.

" - } - } - }, - "Device" : { - "type" : "structure", - "members" : { - "Attributes" : { - "shape" : "Attributes", - "locationName" : "attributes", - "documentation" : "

The user specified attributes associated with the device for an event.

" - }, - "DeviceId" : { - "shape" : "__string", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - }, - "Type" : { - "shape" : "__string", - "locationName" : "type", - "documentation" : "

The device type, such as \"button\".

" - } - } - }, - "DeviceAttributes" : { - "type" : "map", - "documentation" : "

\n DeviceAttributes is a string-to-string map specified by the user.

", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "__string" - } - }, - "DeviceClaimResponse" : { - "type" : "structure", - "members" : { - "State" : { - "shape" : "__string", - "locationName" : "state", - "documentation" : "

The device's final claim state.

" - } - } - }, - "DeviceDescription" : { - "type" : "structure", - "members" : { - "Attributes" : { - "shape" : "DeviceAttributes", - "locationName" : "attributes", - "documentation" : "

An array of zero or more elements of DeviceAttribute objects\n providing user specified device attributes.

" - }, - "DeviceId" : { - "shape" : "__string", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - }, - "Enabled" : { - "shape" : "__boolean", - "locationName" : "enabled", - "documentation" : "

A Boolean value indicating whether or not the device is enabled.

" - }, - "RemainingLife" : { - "shape" : "__doubleMin0Max100", - "locationName" : "remainingLife", - "documentation" : "

A value between 0 and 1 inclusive, representing the fraction of life remaining for\n the device.

" - }, - "Type" : { - "shape" : "__string", - "locationName" : "type", - "documentation" : "

The type of the device, such as \"button\".

" - } - } - }, - "DeviceEvent" : { - "type" : "structure", - "members" : { - "Device" : { - "shape" : "Device", - "locationName" : "device", - "documentation" : "

An object representing the device associated with the event.

" - }, - "StdEvent" : { - "shape" : "__string", - "locationName" : "stdEvent", - "documentation" : "

A serialized JSON object representing the device-type specific event.

" - } - } - }, - "DeviceEventsResponse" : { - "type" : "structure", - "members" : { - "Events" : { - "shape" : "__listOfDeviceEvent", - "locationName" : "events", - "documentation" : "

An array of zero or more elements describing the event(s) associated with the\n device.

" - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to retrieve the next set of results.

" - } - } - }, - "DeviceMethod" : { - "type" : "structure", - "members" : { - "DeviceType" : { - "shape" : "__string", - "locationName" : "deviceType", - "documentation" : "

The type of the device, such as \"button\".

" - }, - "MethodName" : { - "shape" : "__string", - "locationName" : "methodName", - "documentation" : "

The name of the method applicable to the deviceType.

" - } - } - }, - "Empty" : { - "type" : "structure", - "members" : { }, - "documentation" : "

On success, an empty object is returned.

" - }, - "FinalizeDeviceClaimRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - } - }, - "required" : [ "DeviceId" ] - }, - "FinalizeDeviceClaimResponse" : { - "type" : "structure", - "members" : { - "State" : { - "shape" : "__string", - "locationName" : "state", - "documentation" : "

The device's final claim state.

" - } - } - }, - "ForbiddenException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

403

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The 403 error message returned by the web server.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 403 - } - }, - "GetDeviceMethodsRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - } - }, - "required" : [ "DeviceId" ] - }, - "GetDeviceMethodsResponse" : { - "type" : "structure", - "members" : { - "DeviceMethods" : { - "shape" : "__listOfDeviceMethod", - "locationName" : "deviceMethods", - "documentation" : "

List of available device APIs.

" - } - } - }, - "InitiateDeviceClaimRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - } - }, - "required" : [ "DeviceId" ] - }, - "InitiateDeviceClaimResponse" : { - "type" : "structure", - "members" : { - "State" : { - "shape" : "__string", - "locationName" : "state", - "documentation" : "

The device's final claim state.

" - } - } - }, - "InternalFailureException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

500

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The 500 error message returned by the web server.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "InvalidRequestException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

400

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The 400 error message returned by the web server.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "InvokeDeviceMethodRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - }, - "DeviceMethod" : { - "shape" : "DeviceMethod", - "locationName" : "deviceMethod", - "documentation" : "

The device method to invoke.

" - }, - "DeviceMethodParameters" : { - "shape" : "__string", - "locationName" : "deviceMethodParameters", - "documentation" : "

A JSON encoded string containing the device method request parameters.

" - } - }, - "required" : [ "DeviceId" ] - }, - "InvokeDeviceMethodResponse" : { - "type" : "structure", - "members" : { - "DeviceMethodResponse" : { - "shape" : "__string", - "locationName" : "deviceMethodResponse", - "documentation" : "

A JSON encoded string containing the device method response.

" - } - } - }, - "ListDeviceEventsRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - }, - "FromTimeStamp" : { - "shape" : "__timestampIso8601", - "location" : "querystring", - "locationName" : "fromTimeStamp", - "documentation" : "

The start date for the device event query, in ISO8061 format. For example,\n 2018-03-28T15:45:12.880Z\n

" - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "

The maximum number of results to return per request. If not set, a default value\n of 100 is used.

" - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "

The token to retrieve the next set of results.

" - }, - "ToTimeStamp" : { - "shape" : "__timestampIso8601", - "location" : "querystring", - "locationName" : "toTimeStamp", - "documentation" : "

The end date for the device event query, in ISO8061 format. For example,\n 2018-03-28T15:45:12.880Z\n

" - } - }, - "required" : [ "DeviceId", "FromTimeStamp", "ToTimeStamp" ] - }, - "ListDeviceEventsResponse" : { - "type" : "structure", - "members" : { - "Events" : { - "shape" : "__listOfDeviceEvent", - "locationName" : "events", - "documentation" : "

An array of zero or more elements describing the event(s) associated with the\n device.

" - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to retrieve the next set of results.

" - } - } - }, - "ListDevicesRequest" : { - "type" : "structure", - "members" : { - "DeviceType" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "deviceType", - "documentation" : "

The type of the device, such as \"button\".

" - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "

The maximum number of results to return per request. If not set, a default value\n of 100 is used.

" - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "

The token to retrieve the next set of results.

" - } - } - }, - "ListDevicesResponse" : { - "type" : "structure", - "members" : { - "Devices" : { - "shape" : "__listOfDeviceDescription", - "locationName" : "devices", - "documentation" : "

A list of devices.

" - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to retrieve the next set of results.

" - } - } - }, - "MaxResults" : { - "type" : "integer", - "min" : 1, - "max" : 250 - }, - "PreconditionFailedException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

412

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

An error message explaining the error or its remedy.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 412 - } - }, - "RangeNotSatisfiableException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

416

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The requested number of results specified by nextToken cannot be\n satisfied.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 416 - } - }, - "ResourceConflictException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

409

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

An error message explaining the error or its remedy.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 409 - } - }, - "ResourceNotFoundException" : { - "type" : "structure", - "members" : { - "Code" : { - "shape" : "__string", - "locationName" : "code", - "documentation" : "

404

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The requested device could not be found.

" - } - }, - "exception" : true, - "error" : { - "httpStatusCode" : 404 - } - }, - "UnclaimDeviceRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - } - }, - "required" : [ "DeviceId" ] - }, - "UnclaimDeviceResponse" : { - "type" : "structure", - "members" : { - "State" : { - "shape" : "__string", - "locationName" : "state", - "documentation" : "

The device's final claim state.

" - } - } - }, - "UpdateDeviceStateRequest" : { - "type" : "structure", - "members" : { - "DeviceId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "deviceId", - "documentation" : "

The unique identifier of the device.

" - }, - "Enabled" : { - "shape" : "__boolean", - "locationName" : "enabled", - "documentation" : "

If true, the device is enabled. If false, the device is\n disabled.

" - } - }, - "required" : [ "DeviceId" ] - }, - "UpdateDeviceStateResponse" : { - "type" : "structure", - "members" : { } - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__doubleMin0Max100" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__listOfDeviceDescription" : { - "type" : "list", - "member" : { - "shape" : "DeviceDescription" - } - }, - "__listOfDeviceEvent" : { - "type" : "list", - "member" : { - "shape" : "DeviceEvent" - } - }, - "__listOfDeviceMethod" : { - "type" : "list", - "member" : { - "shape" : "DeviceMethod" - } - }, - "__long" : { - "type" : "long" - }, - "__string" : { - "type" : "string" - }, - "__stringMin12Max40" : { - "type" : "string", - "min" : 12, - "max" : 40 - }, - "__timestampIso8601" : { - "type" : "timestamp", - "timestampFormat" : "iso8601" - }, - "__timestampUnix" : { - "type" : "timestamp", - "timestampFormat" : "unixTimestamp" - } - }, - "documentation" : "

Stub description

" -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/service-2.json deleted file mode 100644 index b918b054..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iot1click-projects/2018-05-14/service-2.json +++ /dev/null @@ -1,907 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2018-05-14", - "endpointPrefix":"projects.iot1click", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceAbbreviation":"AWS IoT 1-Click Projects", - "serviceFullName":"AWS IoT 1-Click Projects Service", - "serviceId":"IoT 1Click Projects", - "signatureVersion":"v4", - "signingName":"iot1click", - "uid":"iot1click-projects-2018-05-14" - }, - "operations":{ - "AssociateDeviceWithPlacement":{ - "name":"AssociateDeviceWithPlacement", - "http":{ - "method":"PUT", - "requestUri":"/projects/{projectName}/placements/{placementName}/devices/{deviceTemplateName}" - }, - "input":{"shape":"AssociateDeviceWithPlacementRequest"}, - "output":{"shape":"AssociateDeviceWithPlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceConflictException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Associates a physical device with a placement.

" - }, - "CreatePlacement":{ - "name":"CreatePlacement", - "http":{ - "method":"POST", - "requestUri":"/projects/{projectName}/placements" - }, - "input":{"shape":"CreatePlacementRequest"}, - "output":{"shape":"CreatePlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceConflictException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates an empty placement.

" - }, - "CreateProject":{ - "name":"CreateProject", - "http":{ - "method":"POST", - "requestUri":"/projects" - }, - "input":{"shape":"CreateProjectRequest"}, - "output":{"shape":"CreateProjectResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceConflictException"} - ], - "documentation":"

Creates an empty project with a placement template. A project contains zero or more placements that adhere to the placement template defined in the project.

" - }, - "DeletePlacement":{ - "name":"DeletePlacement", - "http":{ - "method":"DELETE", - "requestUri":"/projects/{projectName}/placements/{placementName}" - }, - "input":{"shape":"DeletePlacementRequest"}, - "output":{"shape":"DeletePlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes a placement. To delete a placement, it must not have any devices associated with it.

When you delete a placement, all associated data becomes irretrievable.

" - }, - "DeleteProject":{ - "name":"DeleteProject", - "http":{ - "method":"DELETE", - "requestUri":"/projects/{projectName}" - }, - "input":{"shape":"DeleteProjectRequest"}, - "output":{"shape":"DeleteProjectResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes a project. To delete a project, it must not have any placements associated with it.

When you delete a project, all associated data becomes irretrievable.

" - }, - "DescribePlacement":{ - "name":"DescribePlacement", - "http":{ - "method":"GET", - "requestUri":"/projects/{projectName}/placements/{placementName}" - }, - "input":{"shape":"DescribePlacementRequest"}, - "output":{"shape":"DescribePlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a placement in a project.

" - }, - "DescribeProject":{ - "name":"DescribeProject", - "http":{ - "method":"GET", - "requestUri":"/projects/{projectName}" - }, - "input":{"shape":"DescribeProjectRequest"}, - "output":{"shape":"DescribeProjectResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns an object describing a project.

" - }, - "DisassociateDeviceFromPlacement":{ - "name":"DisassociateDeviceFromPlacement", - "http":{ - "method":"DELETE", - "requestUri":"/projects/{projectName}/placements/{placementName}/devices/{deviceTemplateName}" - }, - "input":{"shape":"DisassociateDeviceFromPlacementRequest"}, - "output":{"shape":"DisassociateDeviceFromPlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Removes a physical device from a placement.

" - }, - "GetDevicesInPlacement":{ - "name":"GetDevicesInPlacement", - "http":{ - "method":"GET", - "requestUri":"/projects/{projectName}/placements/{placementName}/devices" - }, - "input":{"shape":"GetDevicesInPlacementRequest"}, - "output":{"shape":"GetDevicesInPlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns an object enumerating the devices in a placement.

" - }, - "ListPlacements":{ - "name":"ListPlacements", - "http":{ - "method":"GET", - "requestUri":"/projects/{projectName}/placements" - }, - "input":{"shape":"ListPlacementsRequest"}, - "output":{"shape":"ListPlacementsResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the placement(s) of a project.

" - }, - "ListProjects":{ - "name":"ListProjects", - "http":{ - "method":"GET", - "requestUri":"/projects" - }, - "input":{"shape":"ListProjectsRequest"}, - "output":{"shape":"ListProjectsResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Lists the AWS IoT 1-Click project(s) associated with your AWS account and region.

" - }, - "UpdatePlacement":{ - "name":"UpdatePlacement", - "http":{ - "method":"PUT", - "requestUri":"/projects/{projectName}/placements/{placementName}" - }, - "input":{"shape":"UpdatePlacementRequest"}, - "output":{"shape":"UpdatePlacementResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates a placement with the given attributes. To clear an attribute, pass an empty value (i.e., \"\").

" - }, - "UpdateProject":{ - "name":"UpdateProject", - "http":{ - "method":"PUT", - "requestUri":"/projects/{projectName}" - }, - "input":{"shape":"UpdateProjectRequest"}, - "output":{"shape":"UpdateProjectResponse"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates a project associated with your AWS account and region. With the exception of device template names, you can pass just the values that need to be updated because the update request will change only the values that are provided. To clear a value, pass the empty string (i.e., \"\").

" - } - }, - "shapes":{ - "AssociateDeviceWithPlacementRequest":{ - "type":"structure", - "required":[ - "projectName", - "placementName", - "deviceId", - "deviceTemplateName" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project containing the placement in which to associate the device.

", - "location":"uri", - "locationName":"projectName" - }, - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement in which to associate the device.

", - "location":"uri", - "locationName":"placementName" - }, - "deviceId":{ - "shape":"DeviceId", - "documentation":"

The ID of the physical device to be associated with the given placement in the project. Note that a mandatory 4 character prefix is required for all deviceId values.

" - }, - "deviceTemplateName":{ - "shape":"DeviceTemplateName", - "documentation":"

The device template name to associate with the device ID.

", - "location":"uri", - "locationName":"deviceTemplateName" - } - } - }, - "AssociateDeviceWithPlacementResponse":{ - "type":"structure", - "members":{ - } - }, - "AttributeDefaultValue":{ - "type":"string", - "max":800 - }, - "AttributeName":{ - "type":"string", - "max":128, - "min":1 - }, - "AttributeValue":{ - "type":"string", - "max":800 - }, - "Code":{"type":"string"}, - "CreatePlacementRequest":{ - "type":"structure", - "required":[ - "placementName", - "projectName" - ], - "members":{ - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement to be created.

" - }, - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project in which to create the placement.

", - "location":"uri", - "locationName":"projectName" - }, - "attributes":{ - "shape":"PlacementAttributeMap", - "documentation":"

Optional user-defined key/value pairs providing contextual data (such as location or function) for the placement.

" - } - } - }, - "CreatePlacementResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateProjectRequest":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project to create.

" - }, - "description":{ - "shape":"Description", - "documentation":"

An optional description for the project.

" - }, - "placementTemplate":{ - "shape":"PlacementTemplate", - "documentation":"

The schema defining the placement to be created. A placement template defines placement default attributes and device templates. You cannot add or remove device templates after the project has been created. However, you can update callbackOverrides for the device templates using the UpdateProject API.

" - } - } - }, - "CreateProjectResponse":{ - "type":"structure", - "members":{ - } - }, - "DefaultPlacementAttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeDefaultValue"} - }, - "DeletePlacementRequest":{ - "type":"structure", - "required":[ - "placementName", - "projectName" - ], - "members":{ - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the empty placement to delete.

", - "location":"uri", - "locationName":"placementName" - }, - "projectName":{ - "shape":"ProjectName", - "documentation":"

The project containing the empty placement to delete.

", - "location":"uri", - "locationName":"projectName" - } - } - }, - "DeletePlacementResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteProjectRequest":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the empty project to delete.

", - "location":"uri", - "locationName":"projectName" - } - } - }, - "DeleteProjectResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribePlacementRequest":{ - "type":"structure", - "required":[ - "placementName", - "projectName" - ], - "members":{ - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement within a project.

", - "location":"uri", - "locationName":"placementName" - }, - "projectName":{ - "shape":"ProjectName", - "documentation":"

The project containing the placement to be described.

", - "location":"uri", - "locationName":"projectName" - } - } - }, - "DescribePlacementResponse":{ - "type":"structure", - "required":["placement"], - "members":{ - "placement":{ - "shape":"PlacementDescription", - "documentation":"

An object describing the placement.

" - } - } - }, - "DescribeProjectRequest":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project to be described.

", - "location":"uri", - "locationName":"projectName" - } - } - }, - "DescribeProjectResponse":{ - "type":"structure", - "required":["project"], - "members":{ - "project":{ - "shape":"ProjectDescription", - "documentation":"

An object describing the project.

" - } - } - }, - "Description":{ - "type":"string", - "max":500, - "min":0 - }, - "DeviceCallbackKey":{ - "type":"string", - "max":128, - "min":1 - }, - "DeviceCallbackOverrideMap":{ - "type":"map", - "key":{"shape":"DeviceCallbackKey"}, - "value":{"shape":"DeviceCallbackValue"} - }, - "DeviceCallbackValue":{ - "type":"string", - "max":200 - }, - "DeviceId":{ - "type":"string", - "max":32, - "min":1 - }, - "DeviceMap":{ - "type":"map", - "key":{"shape":"DeviceTemplateName"}, - "value":{"shape":"DeviceId"} - }, - "DeviceTemplate":{ - "type":"structure", - "members":{ - "deviceType":{ - "shape":"DeviceType", - "documentation":"

The device type, which currently must be \"button\".

" - }, - "callbackOverrides":{ - "shape":"DeviceCallbackOverrideMap", - "documentation":"

An optional Lambda function to invoke instead of the default Lambda function provided by the placement template.

" - } - }, - "documentation":"

An object representing a device for a placement template (see PlacementTemplate).

" - }, - "DeviceTemplateMap":{ - "type":"map", - "key":{"shape":"DeviceTemplateName"}, - "value":{"shape":"DeviceTemplate"} - }, - "DeviceTemplateName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_-]+$" - }, - "DeviceType":{ - "type":"string", - "max":128 - }, - "DisassociateDeviceFromPlacementRequest":{ - "type":"structure", - "required":[ - "projectName", - "placementName", - "deviceTemplateName" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project that contains the placement.

", - "location":"uri", - "locationName":"projectName" - }, - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement that the device should be removed from.

", - "location":"uri", - "locationName":"placementName" - }, - "deviceTemplateName":{ - "shape":"DeviceTemplateName", - "documentation":"

The device ID that should be removed from the placement.

", - "location":"uri", - "locationName":"deviceTemplateName" - } - } - }, - "DisassociateDeviceFromPlacementResponse":{ - "type":"structure", - "members":{ - } - }, - "GetDevicesInPlacementRequest":{ - "type":"structure", - "required":[ - "projectName", - "placementName" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project containing the placement.

", - "location":"uri", - "locationName":"projectName" - }, - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement to get the devices from.

", - "location":"uri", - "locationName":"placementName" - } - } - }, - "GetDevicesInPlacementResponse":{ - "type":"structure", - "required":["devices"], - "members":{ - "devices":{ - "shape":"DeviceMap", - "documentation":"

An object containing the devices (zero or more) within the placement.

" - } - } - }, - "InternalFailureException":{ - "type":"structure", - "required":[ - "code", - "message" - ], - "members":{ - "code":{"shape":"Code"}, - "message":{"shape":"Message"} - }, - "documentation":"

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "required":[ - "code", - "message" - ], - "members":{ - "code":{"shape":"Code"}, - "message":{"shape":"Message"} - }, - "documentation":"

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ListPlacementsRequest":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The project containing the placements to be listed.

", - "location":"uri", - "locationName":"projectName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return per request. If not set, a default value of 100 is used.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListPlacementsResponse":{ - "type":"structure", - "required":["placements"], - "members":{ - "placements":{ - "shape":"PlacementSummaryList", - "documentation":"

An object listing the requested placements.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to retrieve the next set of results - will be effectively empty if there are no further results.

" - } - } - }, - "ListProjectsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return per request. If not set, a default value of 100 is used.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListProjectsResponse":{ - "type":"structure", - "required":["projects"], - "members":{ - "projects":{ - "shape":"ProjectSummaryList", - "documentation":"

An object containing the list of projects.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token used to retrieve the next set of results - will be effectively empty if there are no further results.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "Message":{"type":"string"}, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "PlacementAttributeMap":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "PlacementDescription":{ - "type":"structure", - "required":[ - "projectName", - "placementName", - "attributes", - "createdDate", - "updatedDate" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project containing the placement.

" - }, - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement.

" - }, - "attributes":{ - "shape":"PlacementAttributeMap", - "documentation":"

The user-defined attributes associated with the placement.

" - }, - "createdDate":{ - "shape":"Time", - "documentation":"

The date when the placement was initially created, in UNIX epoch time format.

" - }, - "updatedDate":{ - "shape":"Time", - "documentation":"

The date when the placement was last updated, in UNIX epoch time format. If the placement was not updated, then createdDate and updatedDate are the same.

" - } - }, - "documentation":"

An object describing a project's placement.

" - }, - "PlacementName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_-]+$" - }, - "PlacementSummary":{ - "type":"structure", - "required":[ - "projectName", - "placementName", - "createdDate", - "updatedDate" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project containing the placement.

" - }, - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement being summarized.

" - }, - "createdDate":{ - "shape":"Time", - "documentation":"

The date when the placement was originally created, in UNIX epoch time format.

" - }, - "updatedDate":{ - "shape":"Time", - "documentation":"

The date when the placement was last updated, in UNIX epoch time format. If the placement was not updated, then createdDate and updatedDate are the same.

" - } - }, - "documentation":"

An object providing summary information for a particular placement.

" - }, - "PlacementSummaryList":{ - "type":"list", - "member":{"shape":"PlacementSummary"} - }, - "PlacementTemplate":{ - "type":"structure", - "members":{ - "defaultAttributes":{ - "shape":"DefaultPlacementAttributeMap", - "documentation":"

The default attributes (key/value pairs) to be applied to all placements using this template.

" - }, - "deviceTemplates":{ - "shape":"DeviceTemplateMap", - "documentation":"

An object specifying the DeviceTemplate for all placements using this (PlacementTemplate) template.

" - } - }, - "documentation":"

An object defining the template for a placement.

" - }, - "ProjectDescription":{ - "type":"structure", - "required":[ - "projectName", - "createdDate", - "updatedDate" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project for which to obtain information from.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the project.

" - }, - "createdDate":{ - "shape":"Time", - "documentation":"

The date when the project was originally created, in UNIX epoch time format.

" - }, - "updatedDate":{ - "shape":"Time", - "documentation":"

The date when the project was last updated, in UNIX epoch time format. If the project was not updated, then createdDate and updatedDate are the same.

" - }, - "placementTemplate":{ - "shape":"PlacementTemplate", - "documentation":"

An object describing the project's placement specifications.

" - } - }, - "documentation":"

An object providing detailed information for a particular project associated with an AWS account and region.

" - }, - "ProjectName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[0-9A-Za-z_-]+$" - }, - "ProjectSummary":{ - "type":"structure", - "required":[ - "projectName", - "createdDate", - "updatedDate" - ], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project being summarized.

" - }, - "createdDate":{ - "shape":"Time", - "documentation":"

The date when the project was originally created, in UNIX epoch time format.

" - }, - "updatedDate":{ - "shape":"Time", - "documentation":"

The date when the project was last updated, in UNIX epoch time format. If the project was not updated, then createdDate and updatedDate are the same.

" - } - }, - "documentation":"

An object providing summary information for a particular project for an associated AWS account and region.

" - }, - "ProjectSummaryList":{ - "type":"list", - "member":{"shape":"ProjectSummary"} - }, - "ResourceConflictException":{ - "type":"structure", - "required":[ - "code", - "message" - ], - "members":{ - "code":{"shape":"Code"}, - "message":{"shape":"Message"} - }, - "documentation":"

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "required":[ - "code", - "message" - ], - "members":{ - "code":{"shape":"Code"}, - "message":{"shape":"Message"} - }, - "documentation":"

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Time":{"type":"timestamp"}, - "TooManyRequestsException":{ - "type":"structure", - "required":[ - "code", - "message" - ], - "members":{ - "code":{"shape":"Code"}, - "message":{"shape":"Message"} - }, - "documentation":"

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UpdatePlacementRequest":{ - "type":"structure", - "required":[ - "placementName", - "projectName" - ], - "members":{ - "placementName":{ - "shape":"PlacementName", - "documentation":"

The name of the placement to update.

", - "location":"uri", - "locationName":"placementName" - }, - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project containing the placement to be updated.

", - "location":"uri", - "locationName":"projectName" - }, - "attributes":{ - "shape":"PlacementAttributeMap", - "documentation":"

The user-defined object of attributes used to update the placement. The maximum number of key/value pairs is 50.

" - } - } - }, - "UpdatePlacementResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateProjectRequest":{ - "type":"structure", - "required":["projectName"], - "members":{ - "projectName":{ - "shape":"ProjectName", - "documentation":"

The name of the project to be updated.

", - "location":"uri", - "locationName":"projectName" - }, - "description":{ - "shape":"Description", - "documentation":"

An optional user-defined description for the project.

" - }, - "placementTemplate":{ - "shape":"PlacementTemplate", - "documentation":"

An object defining the project update. Once a project has been created, you cannot add device template names to the project. However, for a given placementTemplate, you can update the associated callbackOverrides for the device definition using this API.

" - } - } - }, - "UpdateProjectResponse":{ - "type":"structure", - "members":{ - } - } - }, - "documentation":"

The AWS IoT 1-Click Project API Reference

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/service-2.json deleted file mode 100644 index a047fd12..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/iotanalytics/2017-11-27/service-2.json +++ /dev/null @@ -1,2426 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-11-27", - "endpointPrefix":"iotanalytics", - "protocol":"rest-json", - "serviceFullName":"AWS IoT Analytics", - "serviceId":"IoTAnalytics", - "signatureVersion":"v4", - "signingName":"iotanalytics", - "uid":"iotanalytics-2017-11-27" - }, - "operations":{ - "BatchPutMessage":{ - "name":"BatchPutMessage", - "http":{ - "method":"POST", - "requestUri":"/messages/batch", - "responseCode":200 - }, - "input":{"shape":"BatchPutMessageRequest"}, - "output":{"shape":"BatchPutMessageResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Sends messages to a channel.

" - }, - "CancelPipelineReprocessing":{ - "name":"CancelPipelineReprocessing", - "http":{ - "method":"DELETE", - "requestUri":"/pipelines/{pipelineName}/reprocessing/{reprocessingId}" - }, - "input":{"shape":"CancelPipelineReprocessingRequest"}, - "output":{"shape":"CancelPipelineReprocessingResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Cancels the reprocessing of data through the pipeline.

" - }, - "CreateChannel":{ - "name":"CreateChannel", - "http":{ - "method":"POST", - "requestUri":"/channels", - "responseCode":201 - }, - "input":{"shape":"CreateChannelRequest"}, - "output":{"shape":"CreateChannelResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a channel. A channel collects data from an MQTT topic and archives the raw, unprocessed messages before publishing the data to a pipeline.

" - }, - "CreateDataset":{ - "name":"CreateDataset", - "http":{ - "method":"POST", - "requestUri":"/datasets", - "responseCode":201 - }, - "input":{"shape":"CreateDatasetRequest"}, - "output":{"shape":"CreateDatasetResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a data set. A data set stores data retrieved from a data store by applying an SQL action.

This operation creates the skeleton of a data set. To populate the data set, call \"CreateDatasetContent\".

" - }, - "CreateDatasetContent":{ - "name":"CreateDatasetContent", - "http":{ - "method":"POST", - "requestUri":"/datasets/{datasetName}/content" - }, - "input":{"shape":"CreateDatasetContentRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Creates the content of a data set by applying an SQL action.

" - }, - "CreateDatastore":{ - "name":"CreateDatastore", - "http":{ - "method":"POST", - "requestUri":"/datastores", - "responseCode":201 - }, - "input":{"shape":"CreateDatastoreRequest"}, - "output":{"shape":"CreateDatastoreResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a data store, which is a repository for messages.

" - }, - "CreatePipeline":{ - "name":"CreatePipeline", - "http":{ - "method":"POST", - "requestUri":"/pipelines", - "responseCode":201 - }, - "input":{"shape":"CreatePipelineRequest"}, - "output":{"shape":"CreatePipelineResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a pipeline. A pipeline consumes messages from one or more channels and allows you to process the messages before storing them in a data store.

" - }, - "DeleteChannel":{ - "name":"DeleteChannel", - "http":{ - "method":"DELETE", - "requestUri":"/channels/{channelName}", - "responseCode":204 - }, - "input":{"shape":"DeleteChannelRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Deletes the specified channel.

" - }, - "DeleteDataset":{ - "name":"DeleteDataset", - "http":{ - "method":"DELETE", - "requestUri":"/datasets/{datasetName}", - "responseCode":204 - }, - "input":{"shape":"DeleteDatasetRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Deletes the specified data set.

You do not have to delete the content of the data set before you perform this operation.

" - }, - "DeleteDatasetContent":{ - "name":"DeleteDatasetContent", - "http":{ - "method":"DELETE", - "requestUri":"/datasets/{datasetName}/content", - "responseCode":204 - }, - "input":{"shape":"DeleteDatasetContentRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Deletes the content of the specified data set.

" - }, - "DeleteDatastore":{ - "name":"DeleteDatastore", - "http":{ - "method":"DELETE", - "requestUri":"/datastores/{datastoreName}", - "responseCode":204 - }, - "input":{"shape":"DeleteDatastoreRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Deletes the specified data store.

" - }, - "DeletePipeline":{ - "name":"DeletePipeline", - "http":{ - "method":"DELETE", - "requestUri":"/pipelines/{pipelineName}", - "responseCode":204 - }, - "input":{"shape":"DeletePipelineRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Deletes the specified pipeline.

" - }, - "DescribeChannel":{ - "name":"DescribeChannel", - "http":{ - "method":"GET", - "requestUri":"/channels/{channelName}" - }, - "input":{"shape":"DescribeChannelRequest"}, - "output":{"shape":"DescribeChannelResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves information about a channel.

" - }, - "DescribeDataset":{ - "name":"DescribeDataset", - "http":{ - "method":"GET", - "requestUri":"/datasets/{datasetName}" - }, - "input":{"shape":"DescribeDatasetRequest"}, - "output":{"shape":"DescribeDatasetResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves information about a data set.

" - }, - "DescribeDatastore":{ - "name":"DescribeDatastore", - "http":{ - "method":"GET", - "requestUri":"/datastores/{datastoreName}" - }, - "input":{"shape":"DescribeDatastoreRequest"}, - "output":{"shape":"DescribeDatastoreResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves information about a data store.

" - }, - "DescribeLoggingOptions":{ - "name":"DescribeLoggingOptions", - "http":{ - "method":"GET", - "requestUri":"/logging" - }, - "input":{"shape":"DescribeLoggingOptionsRequest"}, - "output":{"shape":"DescribeLoggingOptionsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves the current settings of the AWS IoT Analytics logging options.

" - }, - "DescribePipeline":{ - "name":"DescribePipeline", - "http":{ - "method":"GET", - "requestUri":"/pipelines/{pipelineName}" - }, - "input":{"shape":"DescribePipelineRequest"}, - "output":{"shape":"DescribePipelineResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves information about a pipeline.

" - }, - "GetDatasetContent":{ - "name":"GetDatasetContent", - "http":{ - "method":"GET", - "requestUri":"/datasets/{datasetName}/content" - }, - "input":{"shape":"GetDatasetContentRequest"}, - "output":{"shape":"GetDatasetContentResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves the contents of a data set as pre-signed URIs.

" - }, - "ListChannels":{ - "name":"ListChannels", - "http":{ - "method":"GET", - "requestUri":"/channels" - }, - "input":{"shape":"ListChannelsRequest"}, - "output":{"shape":"ListChannelsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves a list of channels.

" - }, - "ListDatasets":{ - "name":"ListDatasets", - "http":{ - "method":"GET", - "requestUri":"/datasets" - }, - "input":{"shape":"ListDatasetsRequest"}, - "output":{"shape":"ListDatasetsResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves information about data sets.

" - }, - "ListDatastores":{ - "name":"ListDatastores", - "http":{ - "method":"GET", - "requestUri":"/datastores" - }, - "input":{"shape":"ListDatastoresRequest"}, - "output":{"shape":"ListDatastoresResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves a list of data stores.

" - }, - "ListPipelines":{ - "name":"ListPipelines", - "http":{ - "method":"GET", - "requestUri":"/pipelines" - }, - "input":{"shape":"ListPipelinesRequest"}, - "output":{"shape":"ListPipelinesResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves a list of pipelines.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"GET", - "requestUri":"/tags" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the tags (metadata) which you have assigned to the resource.

" - }, - "PutLoggingOptions":{ - "name":"PutLoggingOptions", - "http":{ - "method":"PUT", - "requestUri":"/logging" - }, - "input":{"shape":"PutLoggingOptionsRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Sets or updates the AWS IoT Analytics logging options.

Note that if you update the value of any loggingOptions field, it takes up to one minute for the change to take effect. Also, if you change the policy attached to the role you specified in the roleArn field (for example, to correct an invalid policy) it takes up to 5 minutes for that change to take effect.

" - }, - "RunPipelineActivity":{ - "name":"RunPipelineActivity", - "http":{ - "method":"POST", - "requestUri":"/pipelineactivities/run" - }, - "input":{"shape":"RunPipelineActivityRequest"}, - "output":{"shape":"RunPipelineActivityResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Simulates the results of running a pipeline activity on a message payload.

" - }, - "SampleChannelData":{ - "name":"SampleChannelData", - "http":{ - "method":"GET", - "requestUri":"/channels/{channelName}/sample" - }, - "input":{"shape":"SampleChannelDataRequest"}, - "output":{"shape":"SampleChannelDataResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Retrieves a sample of messages from the specified channel ingested during the specified timeframe. Up to 10 messages can be retrieved.

" - }, - "StartPipelineReprocessing":{ - "name":"StartPipelineReprocessing", - "http":{ - "method":"POST", - "requestUri":"/pipelines/{pipelineName}/reprocessing" - }, - "input":{"shape":"StartPipelineReprocessingRequest"}, - "output":{"shape":"StartPipelineReprocessingResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts the reprocessing of raw message data through the pipeline.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/tags", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "output":{"shape":"TagResourceResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Adds to or modifies the tags of the given resource. Tags are metadata which can be used to manage a resource.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"DELETE", - "requestUri":"/tags", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "output":{"shape":"UntagResourceResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes the given tags (metadata) from the resource.

" - }, - "UpdateChannel":{ - "name":"UpdateChannel", - "http":{ - "method":"PUT", - "requestUri":"/channels/{channelName}" - }, - "input":{"shape":"UpdateChannelRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Updates the settings of a channel.

" - }, - "UpdateDataset":{ - "name":"UpdateDataset", - "http":{ - "method":"PUT", - "requestUri":"/datasets/{datasetName}" - }, - "input":{"shape":"UpdateDatasetRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Updates the settings of a data set.

" - }, - "UpdateDatastore":{ - "name":"UpdateDatastore", - "http":{ - "method":"PUT", - "requestUri":"/datastores/{datastoreName}" - }, - "input":{"shape":"UpdateDatastoreRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Updates the settings of a data store.

" - }, - "UpdatePipeline":{ - "name":"UpdatePipeline", - "http":{ - "method":"PUT", - "requestUri":"/pipelines/{pipelineName}" - }, - "input":{"shape":"UpdatePipelineRequest"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ThrottlingException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Updates the settings of a pipeline.

" - } - }, - "shapes":{ - "ActivityBatchSize":{ - "type":"integer", - "max":1000, - "min":1 - }, - "ActivityName":{ - "type":"string", - "max":128, - "min":1 - }, - "AddAttributesActivity":{ - "type":"structure", - "required":[ - "name", - "attributes" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'addAttributes' activity.

" - }, - "attributes":{ - "shape":"AttributeNameMapping", - "documentation":"

A list of 1-50 \"AttributeNameMapping\" objects that map an existing attribute to a new attribute.

The existing attributes remain in the message, so if you want to remove the originals, use \"RemoveAttributeActivity\".

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that adds other attributes based on existing attributes in the message.

" - }, - "AttributeName":{ - "type":"string", - "max":256, - "min":1 - }, - "AttributeNameMapping":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeName"}, - "max":50, - "min":1 - }, - "AttributeNames":{ - "type":"list", - "member":{"shape":"AttributeName"}, - "max":50, - "min":1 - }, - "BatchPutMessageErrorEntries":{ - "type":"list", - "member":{"shape":"BatchPutMessageErrorEntry"} - }, - "BatchPutMessageErrorEntry":{ - "type":"structure", - "members":{ - "messageId":{ - "shape":"MessageId", - "documentation":"

The ID of the message that caused the error. (See the value corresponding to the \"messageId\" key in the message object.)

" - }, - "errorCode":{ - "shape":"ErrorCode", - "documentation":"

The code associated with the error.

" - }, - "errorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The message associated with the error.

" - } - }, - "documentation":"

Contains informations about errors.

" - }, - "BatchPutMessageRequest":{ - "type":"structure", - "required":[ - "channelName", - "messages" - ], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel where the messages are sent.

" - }, - "messages":{ - "shape":"Messages", - "documentation":"

The list of messages to be sent. Each message has format: '{ \"messageId\": \"string\", \"payload\": \"string\"}'.

" - } - } - }, - "BatchPutMessageResponse":{ - "type":"structure", - "members":{ - "batchPutMessageErrorEntries":{ - "shape":"BatchPutMessageErrorEntries", - "documentation":"

A list of any errors encountered when sending the messages to the channel.

" - } - } - }, - "CancelPipelineReprocessingRequest":{ - "type":"structure", - "required":[ - "pipelineName", - "reprocessingId" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of pipeline for which data reprocessing is canceled.

", - "location":"uri", - "locationName":"pipelineName" - }, - "reprocessingId":{ - "shape":"ReprocessingId", - "documentation":"

The ID of the reprocessing task (returned by \"StartPipelineReprocessing\").

", - "location":"uri", - "locationName":"reprocessingId" - } - } - }, - "CancelPipelineReprocessingResponse":{ - "type":"structure", - "members":{ - } - }, - "Channel":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ChannelName", - "documentation":"

The name of the channel.

" - }, - "arn":{ - "shape":"ChannelArn", - "documentation":"

The ARN of the channel.

" - }, - "status":{ - "shape":"ChannelStatus", - "documentation":"

The status of the channel.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the channel.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the channel was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

When the channel was last updated.

" - } - }, - "documentation":"

A collection of data from an MQTT topic. Channels archive the raw, unprocessed messages before publishing the data to a pipeline.

" - }, - "ChannelActivity":{ - "type":"structure", - "required":[ - "name", - "channelName" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'channel' activity.

" - }, - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel from which the messages are processed.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

The activity that determines the source of the messages to be processed.

" - }, - "ChannelArn":{"type":"string"}, - "ChannelName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "ChannelStatistics":{ - "type":"structure", - "members":{ - "size":{ - "shape":"EstimatedResourceSize", - "documentation":"

The estimated size of the channel.

" - } - }, - "documentation":"

Statistics information about the channel.

" - }, - "ChannelStatus":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "DELETING" - ] - }, - "ChannelSummaries":{ - "type":"list", - "member":{"shape":"ChannelSummary"} - }, - "ChannelSummary":{ - "type":"structure", - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel.

" - }, - "status":{ - "shape":"ChannelStatus", - "documentation":"

The status of the channel.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the channel was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the channel was updated.

" - } - }, - "documentation":"

A summary of information about a channel.

" - }, - "CreateChannelRequest":{ - "type":"structure", - "required":["channelName"], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the channel.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

Metadata which can be used to manage the channel.

" - } - } - }, - "CreateChannelResponse":{ - "type":"structure", - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel.

" - }, - "channelArn":{ - "shape":"ChannelArn", - "documentation":"

The ARN of the channel.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the channel.

" - } - } - }, - "CreateDatasetContentRequest":{ - "type":"structure", - "required":["datasetName"], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set.

", - "location":"uri", - "locationName":"datasetName" - } - } - }, - "CreateDatasetRequest":{ - "type":"structure", - "required":[ - "datasetName", - "actions" - ], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set.

" - }, - "actions":{ - "shape":"DatasetActions", - "documentation":"

A list of actions that create the data set. Only one action is supported at this time.

" - }, - "triggers":{ - "shape":"DatasetTriggers", - "documentation":"

A list of triggers. A trigger causes data set content to be populated at a specified time or time interval. The list of triggers can be empty or contain up to five DataSetTrigger objects.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

Metadata which can be used to manage the data set.

" - } - } - }, - "CreateDatasetResponse":{ - "type":"structure", - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set.

" - }, - "datasetArn":{ - "shape":"DatasetArn", - "documentation":"

The ARN of the data set.

" - } - } - }, - "CreateDatastoreRequest":{ - "type":"structure", - "required":["datastoreName"], - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the data store.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

Metadata which can be used to manage the data store.

" - } - } - }, - "CreateDatastoreResponse":{ - "type":"structure", - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store.

" - }, - "datastoreArn":{ - "shape":"DatastoreArn", - "documentation":"

The ARN of the data store.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the data store.

" - } - } - }, - "CreatePipelineRequest":{ - "type":"structure", - "required":[ - "pipelineName", - "pipelineActivities" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline.

" - }, - "pipelineActivities":{ - "shape":"PipelineActivities", - "documentation":"

A list of pipeline activities.

The list can be 1-25 PipelineActivity objects. Activities perform transformations on your messages, such as removing, renaming, or adding message attributes; filtering messages based on attribute values; invoking your Lambda functions on messages for advanced processing; or performing mathematical transformations to normalize device data.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

Metadata which can be used to manage the pipeline.

" - } - } - }, - "CreatePipelineResponse":{ - "type":"structure", - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline.

" - }, - "pipelineArn":{ - "shape":"PipelineArn", - "documentation":"

The ARN of the pipeline.

" - } - } - }, - "Dataset":{ - "type":"structure", - "members":{ - "name":{ - "shape":"DatasetName", - "documentation":"

The name of the data set.

" - }, - "arn":{ - "shape":"DatasetArn", - "documentation":"

The ARN of the data set.

" - }, - "actions":{ - "shape":"DatasetActions", - "documentation":"

The \"DatasetAction\" objects that create the data set.

" - }, - "triggers":{ - "shape":"DatasetTriggers", - "documentation":"

The \"DatasetTrigger\" objects that specify when the data set is automatically updated.

" - }, - "status":{ - "shape":"DatasetStatus", - "documentation":"

The status of the data set.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the data set was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the data set was updated.

" - } - }, - "documentation":"

Information about a data set.

" - }, - "DatasetAction":{ - "type":"structure", - "members":{ - "actionName":{ - "shape":"DatasetActionName", - "documentation":"

The name of the data set action.

" - }, - "queryAction":{ - "shape":"SqlQueryDatasetAction", - "documentation":"

An \"SqlQueryDatasetAction\" object that contains the SQL query to modify the message.

" - } - }, - "documentation":"

A \"DatasetAction\" object specifying the query that creates the data set content.

" - }, - "DatasetActionName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "DatasetActions":{ - "type":"list", - "member":{"shape":"DatasetAction"}, - "max":1, - "min":1 - }, - "DatasetArn":{"type":"string"}, - "DatasetContentState":{ - "type":"string", - "enum":[ - "CREATING", - "SUCCEEDED", - "FAILED" - ] - }, - "DatasetContentStatus":{ - "type":"structure", - "members":{ - "state":{ - "shape":"DatasetContentState", - "documentation":"

The state of the data set. Can be one of \"CREATING\", \"SUCCEEDED\" or \"FAILED\".

" - }, - "reason":{ - "shape":"Reason", - "documentation":"

The reason the data set is in this state.

" - } - }, - "documentation":"

The state of the data set and the reason it is in this state.

" - }, - "DatasetContentVersion":{"type":"string"}, - "DatasetEntries":{ - "type":"list", - "member":{"shape":"DatasetEntry"} - }, - "DatasetEntry":{ - "type":"structure", - "members":{ - "entryName":{ - "shape":"EntryName", - "documentation":"

The name of the data set item.

" - }, - "dataURI":{ - "shape":"PresignedURI", - "documentation":"

The pre-signed URI of the data set item.

" - } - }, - "documentation":"

The reference to a data set entry.

" - }, - "DatasetName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "DatasetStatus":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "DELETING" - ] - }, - "DatasetSummaries":{ - "type":"list", - "member":{"shape":"DatasetSummary"} - }, - "DatasetSummary":{ - "type":"structure", - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set.

" - }, - "status":{ - "shape":"DatasetStatus", - "documentation":"

The status of the data set.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The time the data set was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the data set was updated.

" - } - }, - "documentation":"

A summary of information about a data set.

" - }, - "DatasetTrigger":{ - "type":"structure", - "members":{ - "schedule":{ - "shape":"Schedule", - "documentation":"

The \"Schedule\" when the trigger is initiated.

" - } - }, - "documentation":"

The \"DatasetTrigger\" that specifies when the data set is automatically updated.

" - }, - "DatasetTriggers":{ - "type":"list", - "member":{"shape":"DatasetTrigger"}, - "max":5, - "min":0 - }, - "Datastore":{ - "type":"structure", - "members":{ - "name":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store.

" - }, - "arn":{ - "shape":"DatastoreArn", - "documentation":"

The ARN of the data store.

" - }, - "status":{ - "shape":"DatastoreStatus", - "documentation":"

The status of a data store:

CREATING

The data store is being created.

ACTIVE

The data store has been created and can be used.

DELETING

The data store is being deleted.

" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the data store.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the data store was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the data store was updated.

" - } - }, - "documentation":"

Information about a data store.

" - }, - "DatastoreActivity":{ - "type":"structure", - "required":[ - "name", - "datastoreName" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'datastore' activity.

" - }, - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store where processed messages are stored.

" - } - }, - "documentation":"

The 'datastore' activity that specifies where to store the processed data.

" - }, - "DatastoreArn":{"type":"string"}, - "DatastoreName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "DatastoreStatistics":{ - "type":"structure", - "members":{ - "size":{ - "shape":"EstimatedResourceSize", - "documentation":"

The estimated size of the data store.

" - } - }, - "documentation":"

Statistics information about the data store.

" - }, - "DatastoreStatus":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "DELETING" - ] - }, - "DatastoreSummaries":{ - "type":"list", - "member":{"shape":"DatastoreSummary"} - }, - "DatastoreSummary":{ - "type":"structure", - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store.

" - }, - "status":{ - "shape":"DatastoreStatus", - "documentation":"

The status of the data store.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the data store was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the data store was updated.

" - } - }, - "documentation":"

A summary of information about a data store.

" - }, - "DeleteChannelRequest":{ - "type":"structure", - "required":["channelName"], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel to delete.

", - "location":"uri", - "locationName":"channelName" - } - } - }, - "DeleteDatasetContentRequest":{ - "type":"structure", - "required":["datasetName"], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set whose content is deleted.

", - "location":"uri", - "locationName":"datasetName" - }, - "versionId":{ - "shape":"DatasetContentVersion", - "documentation":"

The version of the data set whose content is deleted. You can also use the strings \"$LATEST\" or \"$LATEST_SUCCEEDED\" to delete the latest or latest successfully completed data set. If not specified, \"$LATEST_SUCCEEDED\" is the default.

", - "location":"querystring", - "locationName":"versionId" - } - } - }, - "DeleteDatasetRequest":{ - "type":"structure", - "required":["datasetName"], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set to delete.

", - "location":"uri", - "locationName":"datasetName" - } - } - }, - "DeleteDatastoreRequest":{ - "type":"structure", - "required":["datastoreName"], - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store to delete.

", - "location":"uri", - "locationName":"datastoreName" - } - } - }, - "DeletePipelineRequest":{ - "type":"structure", - "required":["pipelineName"], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline to delete.

", - "location":"uri", - "locationName":"pipelineName" - } - } - }, - "DescribeChannelRequest":{ - "type":"structure", - "required":["channelName"], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel whose information is retrieved.

", - "location":"uri", - "locationName":"channelName" - }, - "includeStatistics":{ - "shape":"IncludeStatisticsFlag", - "documentation":"

If true, include statistics about the channel in the response.

", - "location":"querystring", - "locationName":"includeStatistics" - } - } - }, - "DescribeChannelResponse":{ - "type":"structure", - "members":{ - "channel":{ - "shape":"Channel", - "documentation":"

An object that contains information about the channel.

" - }, - "statistics":{ - "shape":"ChannelStatistics", - "documentation":"

Statistics about the channel. Included if the 'includeStatistics' parameter is set to true in the request.

" - } - } - }, - "DescribeDatasetRequest":{ - "type":"structure", - "required":["datasetName"], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set whose information is retrieved.

", - "location":"uri", - "locationName":"datasetName" - } - } - }, - "DescribeDatasetResponse":{ - "type":"structure", - "members":{ - "dataset":{ - "shape":"Dataset", - "documentation":"

An object that contains information about the data set.

" - } - } - }, - "DescribeDatastoreRequest":{ - "type":"structure", - "required":["datastoreName"], - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store

", - "location":"uri", - "locationName":"datastoreName" - }, - "includeStatistics":{ - "shape":"IncludeStatisticsFlag", - "documentation":"

If true, include statistics about the data store in the response.

", - "location":"querystring", - "locationName":"includeStatistics" - } - } - }, - "DescribeDatastoreResponse":{ - "type":"structure", - "members":{ - "datastore":{ - "shape":"Datastore", - "documentation":"

Information about the data store.

" - }, - "statistics":{ - "shape":"DatastoreStatistics", - "documentation":"

Statistics about the data store. Included if the 'includeStatistics' parameter is set to true in the request.

" - } - } - }, - "DescribeLoggingOptionsRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeLoggingOptionsResponse":{ - "type":"structure", - "members":{ - "loggingOptions":{ - "shape":"LoggingOptions", - "documentation":"

The current settings of the AWS IoT Analytics logging options.

" - } - } - }, - "DescribePipelineRequest":{ - "type":"structure", - "required":["pipelineName"], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline whose information is retrieved.

", - "location":"uri", - "locationName":"pipelineName" - } - } - }, - "DescribePipelineResponse":{ - "type":"structure", - "members":{ - "pipeline":{ - "shape":"Pipeline", - "documentation":"

A \"Pipeline\" object that contains information about the pipeline.

" - } - } - }, - "DeviceRegistryEnrichActivity":{ - "type":"structure", - "required":[ - "name", - "attribute", - "thingName", - "roleArn" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'deviceRegistryEnrich' activity.

" - }, - "attribute":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute that is added to the message.

" - }, - "thingName":{ - "shape":"AttributeName", - "documentation":"

The name of the IoT device whose registry information is added to the message.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that allows access to the device's registry information.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that adds data from the AWS IoT device registry to your message.

" - }, - "DeviceShadowEnrichActivity":{ - "type":"structure", - "required":[ - "name", - "attribute", - "thingName", - "roleArn" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'deviceShadowEnrich' activity.

" - }, - "attribute":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute that is added to the message.

" - }, - "thingName":{ - "shape":"AttributeName", - "documentation":"

The name of the IoT device whose shadow information is added to the message.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that allows access to the device's shadow.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that adds information from the AWS IoT Device Shadows service to a message.

" - }, - "EndTime":{"type":"timestamp"}, - "EntryName":{"type":"string"}, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "EstimatedResourceSize":{ - "type":"structure", - "members":{ - "estimatedSizeInBytes":{ - "shape":"SizeInBytes", - "documentation":"

The estimated size of the resource in bytes.

" - }, - "estimatedOn":{ - "shape":"Timestamp", - "documentation":"

The time when the estimate of the size of the resource was made.

" - } - }, - "documentation":"

The estimated size of the resource.

" - }, - "FilterActivity":{ - "type":"structure", - "required":[ - "name", - "filter" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'filter' activity.

" - }, - "filter":{ - "shape":"FilterExpression", - "documentation":"

An expression that looks like an SQL WHERE clause that must return a Boolean value.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that filters a message based on its attributes.

" - }, - "FilterExpression":{ - "type":"string", - "max":256, - "min":1 - }, - "GetDatasetContentRequest":{ - "type":"structure", - "required":["datasetName"], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set whose contents are retrieved.

", - "location":"uri", - "locationName":"datasetName" - }, - "versionId":{ - "shape":"DatasetContentVersion", - "documentation":"

The version of the data set whose contents are retrieved. You can also use the strings \"$LATEST\" or \"$LATEST_SUCCEEDED\" to retrieve the contents of the latest or latest successfully completed data set. If not specified, \"$LATEST_SUCCEEDED\" is the default.

", - "location":"querystring", - "locationName":"versionId" - } - } - }, - "GetDatasetContentResponse":{ - "type":"structure", - "members":{ - "entries":{ - "shape":"DatasetEntries", - "documentation":"

A list of \"DatasetEntry\" objects.

" - }, - "timestamp":{ - "shape":"Timestamp", - "documentation":"

The time when the request was made.

" - }, - "status":{ - "shape":"DatasetContentStatus", - "documentation":"

The status of the data set content.

" - } - } - }, - "IncludeStatisticsFlag":{"type":"boolean"}, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

There was an internal failure.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The request was not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LambdaActivity":{ - "type":"structure", - "required":[ - "name", - "lambdaName", - "batchSize" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'lambda' activity.

" - }, - "lambdaName":{ - "shape":"LambdaName", - "documentation":"

The name of the Lambda function that is run on the message.

" - }, - "batchSize":{ - "shape":"ActivityBatchSize", - "documentation":"

The number of messages passed to the Lambda function for processing.

The AWS Lambda function must be able to process all of these messages within five minutes, which is the maximum timeout duration for Lambda functions.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that runs a Lambda function to modify the message.

" - }, - "LambdaName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9_-]+$" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The command caused an internal limit to be exceeded.

", - "error":{"httpStatusCode":410}, - "exception":true - }, - "ListChannelsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in this request.

The default value is 100.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListChannelsResponse":{ - "type":"structure", - "members":{ - "channelSummaries":{ - "shape":"ChannelSummaries", - "documentation":"

A list of \"ChannelSummary\" objects.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results, or null if there are no more results.

" - } - } - }, - "ListDatasetsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in this request.

The default value is 100.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListDatasetsResponse":{ - "type":"structure", - "members":{ - "datasetSummaries":{ - "shape":"DatasetSummaries", - "documentation":"

A list of \"DatasetSummary\" objects.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results, or null if there are no more results.

" - } - } - }, - "ListDatastoresRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in this request.

The default value is 100.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListDatastoresResponse":{ - "type":"structure", - "members":{ - "datastoreSummaries":{ - "shape":"DatastoreSummaries", - "documentation":"

A list of \"DatastoreSummary\" objects.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results, or null if there are no more results.

" - } - } - }, - "ListPipelinesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of results.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in this request.

The default value is 100.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "ListPipelinesResponse":{ - "type":"structure", - "members":{ - "pipelineSummaries":{ - "shape":"PipelineSummaries", - "documentation":"

A list of \"PipelineSummary\" objects.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to retrieve the next set of results, or null if there are no more results.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":["resourceArn"], - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN of the resource whose tags you want to list.

", - "location":"querystring", - "locationName":"resourceArn" - } - } - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"TagList", - "documentation":"

The tags (metadata) which you have assigned to the resource.

" - } - } - }, - "LogResult":{"type":"string"}, - "LoggingEnabled":{"type":"boolean"}, - "LoggingLevel":{ - "type":"string", - "enum":["ERROR"] - }, - "LoggingOptions":{ - "type":"structure", - "required":[ - "roleArn", - "level", - "enabled" - ], - "members":{ - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of the role that grants permission to AWS IoT Analytics to perform logging.

" - }, - "level":{ - "shape":"LoggingLevel", - "documentation":"

The logging level. Currently, only \"ERROR\" is supported.

" - }, - "enabled":{ - "shape":"LoggingEnabled", - "documentation":"

If true, logging is enabled for AWS IoT Analytics.

" - } - }, - "documentation":"

Information about logging options.

" - }, - "MathActivity":{ - "type":"structure", - "required":[ - "name", - "attribute", - "math" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'math' activity.

" - }, - "attribute":{ - "shape":"AttributeName", - "documentation":"

The name of the attribute that will contain the result of the math operation.

" - }, - "math":{ - "shape":"MathExpression", - "documentation":"

An expression that uses one or more existing attributes and must return an integer value.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that computes an arithmetic expression using the message's attributes.

" - }, - "MathExpression":{ - "type":"string", - "max":256, - "min":1 - }, - "MaxMessages":{ - "type":"integer", - "max":10, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":250, - "min":1 - }, - "Message":{ - "type":"structure", - "required":[ - "messageId", - "payload" - ], - "members":{ - "messageId":{ - "shape":"MessageId", - "documentation":"

The ID you wish to assign to the message. Each \"messageId\" must be unique within each batch sent.

" - }, - "payload":{ - "shape":"MessagePayload", - "documentation":"

The payload of the message. This may be a JSON string or a Base64-encoded string representing binary data (in which case you must decode it by means of a pipeline activity).

" - } - }, - "documentation":"

Information about a message.

" - }, - "MessageId":{ - "type":"string", - "max":128, - "min":1 - }, - "MessagePayload":{"type":"blob"}, - "MessagePayloads":{ - "type":"list", - "member":{"shape":"MessagePayload"}, - "max":10, - "min":1 - }, - "Messages":{ - "type":"list", - "member":{"shape":"Message"} - }, - "NextToken":{"type":"string"}, - "Pipeline":{ - "type":"structure", - "members":{ - "name":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline.

" - }, - "arn":{ - "shape":"PipelineArn", - "documentation":"

The ARN of the pipeline.

" - }, - "activities":{ - "shape":"PipelineActivities", - "documentation":"

The activities that perform transformations on the messages.

" - }, - "reprocessingSummaries":{ - "shape":"ReprocessingSummaries", - "documentation":"

A summary of information about the pipeline reprocessing.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the pipeline was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

The last time the pipeline was updated.

" - } - }, - "documentation":"

Contains information about a pipeline.

" - }, - "PipelineActivities":{ - "type":"list", - "member":{"shape":"PipelineActivity"}, - "max":25, - "min":1 - }, - "PipelineActivity":{ - "type":"structure", - "members":{ - "channel":{ - "shape":"ChannelActivity", - "documentation":"

Determines the source of the messages to be processed.

" - }, - "lambda":{ - "shape":"LambdaActivity", - "documentation":"

Runs a Lambda function to modify the message.

" - }, - "datastore":{ - "shape":"DatastoreActivity", - "documentation":"

Specifies where to store the processed message data.

" - }, - "addAttributes":{ - "shape":"AddAttributesActivity", - "documentation":"

Adds other attributes based on existing attributes in the message.

" - }, - "removeAttributes":{ - "shape":"RemoveAttributesActivity", - "documentation":"

Removes attributes from a message.

" - }, - "selectAttributes":{ - "shape":"SelectAttributesActivity", - "documentation":"

Creates a new message using only the specified attributes from the original message.

" - }, - "filter":{ - "shape":"FilterActivity", - "documentation":"

Filters a message based on its attributes.

" - }, - "math":{ - "shape":"MathActivity", - "documentation":"

Computes an arithmetic expression using the message's attributes and adds it to the message.

" - }, - "deviceRegistryEnrich":{ - "shape":"DeviceRegistryEnrichActivity", - "documentation":"

Adds data from the AWS IoT device registry to your message.

" - }, - "deviceShadowEnrich":{ - "shape":"DeviceShadowEnrichActivity", - "documentation":"

Adds information from the AWS IoT Device Shadows service to a message.

" - } - }, - "documentation":"

An activity that performs a transformation on a message.

" - }, - "PipelineArn":{"type":"string"}, - "PipelineName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_]+$" - }, - "PipelineSummaries":{ - "type":"list", - "member":{"shape":"PipelineSummary"} - }, - "PipelineSummary":{ - "type":"structure", - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline.

" - }, - "reprocessingSummaries":{ - "shape":"ReprocessingSummaries", - "documentation":"

A summary of information about the pipeline reprocessing.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

When the pipeline was created.

" - }, - "lastUpdateTime":{ - "shape":"Timestamp", - "documentation":"

When the pipeline was last updated.

" - } - }, - "documentation":"

A summary of information about a pipeline.

" - }, - "PresignedURI":{"type":"string"}, - "PutLoggingOptionsRequest":{ - "type":"structure", - "required":["loggingOptions"], - "members":{ - "loggingOptions":{ - "shape":"LoggingOptions", - "documentation":"

The new values of the AWS IoT Analytics logging options.

" - } - } - }, - "Reason":{"type":"string"}, - "RemoveAttributesActivity":{ - "type":"structure", - "required":[ - "name", - "attributes" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'removeAttributes' activity.

" - }, - "attributes":{ - "shape":"AttributeNames", - "documentation":"

A list of 1-50 attributes to remove from the message.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

An activity that removes attributes from a message.

" - }, - "ReprocessingId":{"type":"string"}, - "ReprocessingStatus":{ - "type":"string", - "enum":[ - "RUNNING", - "SUCCEEDED", - "CANCELLED", - "FAILED" - ] - }, - "ReprocessingSummaries":{ - "type":"list", - "member":{"shape":"ReprocessingSummary"} - }, - "ReprocessingSummary":{ - "type":"structure", - "members":{ - "id":{ - "shape":"ReprocessingId", - "documentation":"

The 'reprocessingId' returned by \"StartPipelineReprocessing\".

" - }, - "status":{ - "shape":"ReprocessingStatus", - "documentation":"

The status of the pipeline reprocessing.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The time the pipeline reprocessing was created.

" - } - }, - "documentation":"

Information about pipeline reprocessing.

" - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"}, - "resourceId":{ - "shape":"resourceId", - "documentation":"

The ID of the resource.

" - }, - "resourceArn":{ - "shape":"resourceArn", - "documentation":"

The ARN of the resource.

" - } - }, - "documentation":"

A resource with the same name already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

A resource with the specified name could not be found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "RetentionPeriod":{ - "type":"structure", - "members":{ - "unlimited":{ - "shape":"UnlimitedRetentionPeriod", - "documentation":"

If true, message data is kept indefinitely.

" - }, - "numberOfDays":{ - "shape":"RetentionPeriodInDays", - "documentation":"

The number of days that message data is kept. The \"unlimited\" parameter must be false.

" - } - }, - "documentation":"

How long, in days, message data is kept.

" - }, - "RetentionPeriodInDays":{ - "type":"integer", - "min":1 - }, - "RoleArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "RunPipelineActivityRequest":{ - "type":"structure", - "required":[ - "pipelineActivity", - "payloads" - ], - "members":{ - "pipelineActivity":{ - "shape":"PipelineActivity", - "documentation":"

The pipeline activity that is run. This must not be a 'channel' activity or a 'datastore' activity because these activities are used in a pipeline only to load the original message and to store the (possibly) transformed message. If a 'lambda' activity is specified, only short-running Lambda functions (those with a timeout of less than 30 seconds or less) can be used.

" - }, - "payloads":{ - "shape":"MessagePayloads", - "documentation":"

The sample message payloads on which the pipeline activity is run.

" - } - } - }, - "RunPipelineActivityResponse":{ - "type":"structure", - "members":{ - "payloads":{ - "shape":"MessagePayloads", - "documentation":"

The enriched or transformed sample message payloads as base64-encoded strings. (The results of running the pipeline activity on each input sample message payload, encoded in base64.)

" - }, - "logResult":{ - "shape":"LogResult", - "documentation":"

In case the pipeline activity fails, the log message that is generated.

" - } - } - }, - "SampleChannelDataRequest":{ - "type":"structure", - "required":["channelName"], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel whose message samples are retrieved.

", - "location":"uri", - "locationName":"channelName" - }, - "maxMessages":{ - "shape":"MaxMessages", - "documentation":"

The number of sample messages to be retrieved. The limit is 10, the default is also 10.

", - "location":"querystring", - "locationName":"maxMessages" - }, - "startTime":{ - "shape":"StartTime", - "documentation":"

The start of the time window from which sample messages are retrieved.

", - "location":"querystring", - "locationName":"startTime" - }, - "endTime":{ - "shape":"EndTime", - "documentation":"

The end of the time window from which sample messages are retrieved.

", - "location":"querystring", - "locationName":"endTime" - } - } - }, - "SampleChannelDataResponse":{ - "type":"structure", - "members":{ - "payloads":{ - "shape":"MessagePayloads", - "documentation":"

The list of message samples. Each sample message is returned as a base64-encoded string.

" - } - } - }, - "Schedule":{ - "type":"structure", - "members":{ - "expression":{ - "shape":"ScheduleExpression", - "documentation":"

The expression that defines when to trigger an update. For more information, see Schedule Expressions for Rules in the Amazon CloudWatch documentation.

" - } - }, - "documentation":"

The schedule for when to trigger an update.

" - }, - "ScheduleExpression":{"type":"string"}, - "SelectAttributesActivity":{ - "type":"structure", - "required":[ - "name", - "attributes" - ], - "members":{ - "name":{ - "shape":"ActivityName", - "documentation":"

The name of the 'selectAttributes' activity.

" - }, - "attributes":{ - "shape":"AttributeNames", - "documentation":"

A list of the attributes to select from the message.

" - }, - "next":{ - "shape":"ActivityName", - "documentation":"

The next activity in the pipeline.

" - } - }, - "documentation":"

Creates a new message using only the specified attributes from the original message.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The service is temporarily unavailable.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "SizeInBytes":{"type":"double"}, - "SqlQuery":{"type":"string"}, - "SqlQueryDatasetAction":{ - "type":"structure", - "required":["sqlQuery"], - "members":{ - "sqlQuery":{ - "shape":"SqlQuery", - "documentation":"

An SQL query string.

" - } - }, - "documentation":"

The SQL query to modify the message.

" - }, - "StartPipelineReprocessingRequest":{ - "type":"structure", - "required":["pipelineName"], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline on which to start reprocessing.

", - "location":"uri", - "locationName":"pipelineName" - }, - "startTime":{ - "shape":"StartTime", - "documentation":"

The start time (inclusive) of raw message data that is reprocessed.

" - }, - "endTime":{ - "shape":"EndTime", - "documentation":"

The end time (exclusive) of raw message data that is reprocessed.

" - } - } - }, - "StartPipelineReprocessingResponse":{ - "type":"structure", - "members":{ - "reprocessingId":{ - "shape":"ReprocessingId", - "documentation":"

The ID of the pipeline reprocessing activity that was started.

" - } - } - }, - "StartTime":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"TagKey", - "documentation":"

The tag's key.

" - }, - "value":{ - "shape":"TagValue", - "documentation":"

The tag's value.

" - } - }, - "documentation":"

A set of key/value pairs which are used to manage the resource.

" - }, - "TagKey":{ - "type":"string", - "max":256, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":1 - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tags" - ], - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN of the resource whose tags will be modified.

", - "location":"querystring", - "locationName":"resourceArn" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The new or modified tags for the resource.

" - } - } - }, - "TagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1 - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The request was denied due to request throttling.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "UnlimitedRetentionPeriod":{"type":"boolean"}, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "resourceArn", - "tagKeys" - ], - "members":{ - "resourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN of the resource whose tags will be removed.

", - "location":"querystring", - "locationName":"resourceArn" - }, - "tagKeys":{ - "shape":"TagKeyList", - "documentation":"

The keys of those tags which will be removed.

", - "location":"querystring", - "locationName":"tagKeys" - } - } - }, - "UntagResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateChannelRequest":{ - "type":"structure", - "required":["channelName"], - "members":{ - "channelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel to be updated.

", - "location":"uri", - "locationName":"channelName" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the channel.

" - } - } - }, - "UpdateDatasetRequest":{ - "type":"structure", - "required":[ - "datasetName", - "actions" - ], - "members":{ - "datasetName":{ - "shape":"DatasetName", - "documentation":"

The name of the data set to update.

", - "location":"uri", - "locationName":"datasetName" - }, - "actions":{ - "shape":"DatasetActions", - "documentation":"

A list of \"DatasetAction\" objects. Only one action is supported at this time.

" - }, - "triggers":{ - "shape":"DatasetTriggers", - "documentation":"

A list of \"DatasetTrigger\" objects. The list can be empty or can contain up to five DataSetTrigger objects.

" - } - } - }, - "UpdateDatastoreRequest":{ - "type":"structure", - "required":["datastoreName"], - "members":{ - "datastoreName":{ - "shape":"DatastoreName", - "documentation":"

The name of the data store to be updated.

", - "location":"uri", - "locationName":"datastoreName" - }, - "retentionPeriod":{ - "shape":"RetentionPeriod", - "documentation":"

How long, in days, message data is kept for the data store.

" - } - } - }, - "UpdatePipelineRequest":{ - "type":"structure", - "required":[ - "pipelineName", - "pipelineActivities" - ], - "members":{ - "pipelineName":{ - "shape":"PipelineName", - "documentation":"

The name of the pipeline to update.

", - "location":"uri", - "locationName":"pipelineName" - }, - "pipelineActivities":{ - "shape":"PipelineActivities", - "documentation":"

A list of \"PipelineActivity\" objects.

The list can be 1-25 PipelineActivity objects. Activities perform transformations on your messages, such as removing, renaming or adding message attributes; filtering messages based on attribute values; invoking your Lambda functions on messages for advanced processing; or performing mathematical transformations to normalize device data.

" - } - } - }, - "errorMessage":{"type":"string"}, - "resourceArn":{"type":"string"}, - "resourceId":{"type":"string"} - }, - "documentation":"

AWS IoT Analytics allows you to collect large amounts of device data, process messages, and store them. You can then query the data and run sophisticated analytics on it. AWS IoT Analytics enables advanced data exploration through integration with Jupyter Notebooks and data visualization through integration with Amazon QuickSight.

Traditional analytics and business intelligence tools are designed to process structured data. IoT data often comes from devices that record noisy processes (such as temperature, motion, or sound). As a result the data from these devices can have significant gaps, corrupted messages, and false readings that must be cleaned up before analysis can occur. Also, IoT data is often only meaningful in the context of other data from external sources.

AWS IoT Analytics automates the steps required to analyze data from IoT devices. AWS IoT Analytics filters, transforms, and enriches IoT data before storing it in a time-series data store for analysis. You can set up the service to collect only the data you need from your devices, apply mathematical transforms to process the data, and enrich the data with device-specific metadata such as device type and location before storing it. Then, you can analyze your data by running queries using the built-in SQL query engine, or perform more complex analytics and machine learning inference. AWS IoT Analytics includes pre-built models for common IoT use cases so you can answer questions like which devices are about to fail or which customers are at risk of abandoning their wearable devices.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json deleted file mode 100644 index 78176e37..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json +++ /dev/null @@ -1,426 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-30", - "endpointPrefix":"kinesisvideo", - "protocol":"rest-json", - "serviceAbbreviation":"Kinesis Video Archived Media", - "serviceFullName":"Amazon Kinesis Video Streams Archived Media", - "serviceId":"Kinesis Video Archived Media", - "signatureVersion":"v4", - "uid":"kinesis-video-archived-media-2017-09-30" - }, - "operations":{ - "GetHLSStreamingSessionURL":{ - "name":"GetHLSStreamingSessionURL", - "http":{ - "method":"POST", - "requestUri":"/getHLSStreamingSessionURL" - }, - "input":{"shape":"GetHLSStreamingSessionURLInput"}, - "output":{"shape":"GetHLSStreamingSessionURLOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"UnsupportedStreamMediaTypeException"}, - {"shape":"NoDataRetentionException"}, - {"shape":"MissingCodecPrivateDataException"}, - {"shape":"InvalidCodecPrivateDataException"} - ], - "documentation":"

Retrieves an HTTP Live Streaming (HLS) URL for the stream. You can then open the URL in a browser or media player to view the stream contents.

You must specify either the StreamName or the StreamARN.

An Amazon Kinesis video stream has the following requirements for providing data through HLS:

  • The media type must be video/h264.

  • Data retention must be greater than 0.

  • The fragments must contain codec private data in the AVC (Advanced Video Coding) for H.264 format (MPEG-4 specification ISO/IEC 14496-15). For information about adapting stream data to a given format, see NAL Adaptation Flags.

Kinesis Video Streams HLS sessions contain fragments in the fragmented MPEG-4 form (also called fMP4 or CMAF), rather than the MPEG-2 form (also called TS chunks, which the HLS specification also supports). For more information about HLS fragment types, see the HLS specification.

The following procedure shows how to use HLS with Kinesis Video Streams:

  1. Get an endpoint using GetDataEndpoint, specifying GET_HLS_STREAMING_SESSION_URL for the APIName parameter.

  2. Retrieve the HLS URL using GetHLSStreamingSessionURL. Kinesis Video Streams creates an HLS streaming session to be used for accessing content in a stream using the HLS protocol. GetHLSStreamingSessionURL returns an authenticated URL (that includes an encrypted session token) for the session's HLS master playlist (the root resource needed for streaming with HLS).

    Don't share or store this token where an unauthorized entity could access it. The token provides access to the content of the stream. Safeguard the token with the same measures that you would use with your AWS credentials.

    The media that is made available through the playlist consists only of the requested stream, time range, and format. No other media data (such as frames outside the requested window or alternate bit rates) is made available.

  3. Provide the URL (containing the encrypted session token) for the HLS master playlist to a media player that supports the HLS protocol. Kinesis Video Streams makes the HLS media playlist, initialization fragment, and media fragments available through the master playlist URL. The initialization fragment contains the codec private data for the stream, and other data needed to set up the video decoder and renderer. The media fragments contain H.264-encoded video frames and time stamps.

  4. The media player receives the authenticated URL and requests stream metadata and media data normally. When the media player requests data, it calls the following actions:

    • GetHLSMasterPlaylist: Retrieves an HLS master playlist, which contains a URL for the GetHLSMediaPlaylist action, and additional metadata for the media player, including estimated bit rate and resolution.

    • GetHLSMediaPlaylist: Retrieves an HLS media playlist, which contains a URL to access the MP4 initialization fragment with the GetMP4InitFragment action, and URLs to access the MP4 media fragments with the GetMP4MediaFragment actions. The HLS media playlist also contains metadata about the stream that the player needs to play it, such as whether the PlaybackMode is LIVE or ON_DEMAND. The HLS media playlist is typically static for sessions with a PlaybackType of ON_DEMAND. The HLS media playlist is continually updated with new fragments for sessions with a PlaybackType of LIVE.

    • GetMP4InitFragment: Retrieves the MP4 initialization fragment. The media player typically loads the initialization fragment before loading any media fragments. This fragment contains the \"fytp\" and \"moov\" MP4 atoms, and the child atoms that are needed to initialize the media player decoder.

      The initialization fragment does not correspond to a fragment in a Kinesis video stream. It contains only the codec private data for the stream, which the media player needs to decode video frames.

    • GetMP4MediaFragment: Retrieves MP4 media fragments. These fragments contain the \"moof\" and \"mdat\" MP4 atoms and their child atoms, containing the encoded fragment's video frames and their time stamps.

      After the first media fragment is made available in a streaming session, any fragments that don't contain the same codec private data are excluded in the HLS media playlist. Therefore, the codec private data does not change between fragments in a session.

      Data retrieved with this action is billable. See Pricing for details.

The following restrictions apply to HLS sessions:

  • A streaming session URL should not be shared between players. The service might throttle a session if multiple media players are sharing it. For connection limits, see Kinesis Video Streams Limits.

  • A Kinesis video stream can have a maximum of five active HLS streaming sessions. If a new session is created when the maximum number of sessions is already active, the oldest (earliest created) session is closed. The number of active GetMedia connections on a Kinesis video stream does not count against this limit, and the number of active HLS sessions does not count against the active GetMedia connection limit.

You can monitor the amount of data that the media player consumes by monitoring the GetMP4MediaFragment.OutgoingBytes Amazon CloudWatch metric. For information about using CloudWatch to monitor Kinesis Video Streams, see Monitoring Kinesis Video Streams. For pricing information, see Amazon Kinesis Video Streams Pricing and AWS Pricing. Charges for both HLS sessions and outgoing AWS data apply.

For more information about HLS, see HTTP Live Streaming on the Apple Developer site.

" - }, - "GetMediaForFragmentList":{ - "name":"GetMediaForFragmentList", - "http":{ - "method":"POST", - "requestUri":"/getMediaForFragmentList" - }, - "input":{"shape":"GetMediaForFragmentListInput"}, - "output":{"shape":"GetMediaForFragmentListOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Gets media for a list of fragments (specified by fragment number) from the archived data in an Amazon Kinesis video stream.

The following limits apply when using the GetMediaForFragmentList API:

  • A client can call GetMediaForFragmentList up to five times per second per stream.

  • Kinesis Video Streams sends media data at a rate of up to 25 megabytes per second (or 200 megabits per second) during a GetMediaForFragmentList session.

" - }, - "ListFragments":{ - "name":"ListFragments", - "http":{ - "method":"POST", - "requestUri":"/listFragments" - }, - "input":{"shape":"ListFragmentsInput"}, - "output":{"shape":"ListFragmentsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Returns a list of Fragment objects from the specified stream and start location within the archived data.

" - } - }, - "shapes":{ - "ClientLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client calls. Try making the call later.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ContentType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_\\.\\-]+$" - }, - "DiscontinuityMode":{ - "type":"string", - "enum":[ - "ALWAYS", - "NEVER" - ] - }, - "ErrorMessage":{"type":"string"}, - "Expires":{ - "type":"integer", - "max":43200, - "min":300 - }, - "Fragment":{ - "type":"structure", - "members":{ - "FragmentNumber":{ - "shape":"String", - "documentation":"

The index value of the fragment.

" - }, - "FragmentSizeInBytes":{ - "shape":"Long", - "documentation":"

The total fragment size, including information about the fragment and contained media data.

" - }, - "ProducerTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp from the producer corresponding to the fragment.

" - }, - "ServerTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp from the AWS server corresponding to the fragment.

" - }, - "FragmentLengthInMilliseconds":{ - "shape":"Long", - "documentation":"

The playback duration or other time value associated with the fragment.

" - } - }, - "documentation":"

Represents a segment of video or other time-delimited data.

" - }, - "FragmentList":{ - "type":"list", - "member":{"shape":"Fragment"} - }, - "FragmentNumberList":{ - "type":"list", - "member":{"shape":"FragmentNumberString"}, - "max":1000, - "min":1 - }, - "FragmentNumberString":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[0-9]+$" - }, - "FragmentSelector":{ - "type":"structure", - "required":[ - "FragmentSelectorType", - "TimestampRange" - ], - "members":{ - "FragmentSelectorType":{ - "shape":"FragmentSelectorType", - "documentation":"

The origin of the time stamps to use (Server or Producer).

" - }, - "TimestampRange":{ - "shape":"TimestampRange", - "documentation":"

The range of time stamps to return.

" - } - }, - "documentation":"

Describes the time stamp range and time stamp origin of a range of fragments.

" - }, - "FragmentSelectorType":{ - "type":"string", - "enum":[ - "PRODUCER_TIMESTAMP", - "SERVER_TIMESTAMP" - ] - }, - "GetHLSStreamingSessionURLInput":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream for which to retrieve the HLS master playlist URL.

You must specify either the StreamName or the StreamARN.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream for which to retrieve the HLS master playlist URL.

You must specify either the StreamName or the StreamARN.

" - }, - "PlaybackMode":{ - "shape":"PlaybackMode", - "documentation":"

Whether to retrieve live or archived, on-demand data.

Features of the two types of session include the following:

  • LIVE : For sessions of this type, the HLS media playlist is continually updated with the latest fragments as they become available. We recommend that the media player retrieve a new playlist on a one-second interval. When this type of session is played in a media player, the user interface typically displays a \"live\" notification, with no scrubber control for choosing the position in the playback window to display.

    In LIVE mode, the newest available fragments are included in an HLS media playlist, even if there is a gap between fragments (that is, if a fragment is missing). A gap like this might cause a media player to halt or cause a jump in playback. In this mode, fragments are not added to the HLS media playlist if they are older than the newest fragment in the playlist. If the missing fragment becomes available after a subsequent fragment is added to the playlist, the older fragment is not added, and the gap is not filled.

  • ON_DEMAND : For sessions of this type, the HLS media playlist contains all the fragments for the session, up to the number that is specified in MaxMediaPlaylistFragmentResults. The playlist must be retrieved only once for each session. When this type of session is played in a media player, the user interface typically displays a scrubber control for choosing the position in the playback window to display.

In both playback modes, if FragmentSelectorType is PRODUCER_TIMESTAMP, and if there are multiple fragments with the same start time stamp, the fragment that has the larger fragment number (that is, the newer fragment) is included in the HLS media playlist. The other fragments are not included. Fragments that have different time stamps but have overlapping durations are still included in the HLS media playlist. This can lead to unexpected behavior in the media player.

The default is LIVE.

" - }, - "HLSFragmentSelector":{ - "shape":"HLSFragmentSelector", - "documentation":"

The time range of the requested fragment, and the source of the time stamps.

This parameter is required if PlaybackMode is ON_DEMAND. This parameter is optional if PlaybackMode is LIVE. If PlaybackMode is LIVE, the FragmentSelectorType can be set, but the TimestampRange should not be set. If PlaybackMode is ON_DEMAND, both FragmentSelectorType and TimestampRange must be set.

" - }, - "DiscontinuityMode":{ - "shape":"DiscontinuityMode", - "documentation":"

Specifies when flags marking discontinuities between fragments will be added to the media playlists. The default is ALWAYS when HLSFragmentSelector is SERVER_TIMESTAMP, and NEVER when it is PRODUCER_TIMESTAMP.

Media players typically build a timeline of media content to play, based on the time stamps of each fragment. This means that if there is any overlap between fragments (as is typical if HLSFragmentSelector is SERVER_TIMESTAMP), the media player timeline has small gaps between fragments in some places, and overwrites frames in other places. When there are discontinuity flags between fragments, the media player is expected to reset the timeline, resulting in the fragment being played immediately after the previous fragment. We recommend that you always have discontinuity flags between fragments if the fragment time stamps are not accurate or if fragments might be missing. You should not place discontinuity flags between fragments for the player timeline to accurately map to the producer time stamps.

" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The time in seconds until the requested session expires. This value can be between 300 (5 minutes) and 43200 (12 hours).

When a session expires, no new calls to GetHLSMasterPlaylist, GetHLSMediaPlaylist, GetMP4InitFragment, or GetMP4MediaFragment can be made for that session.

The default is 300 (5 minutes).

" - }, - "MaxMediaPlaylistFragmentResults":{ - "shape":"PageLimit", - "documentation":"

The maximum number of fragments that are returned in the HLS media playlists.

When the PlaybackMode is LIVE, the most recent fragments are returned up to this value. When the PlaybackMode is ON_DEMAND, the oldest fragments are returned, up to this maximum number.

When there are a higher number of fragments available in a live HLS media playlist, video players often buffer content before starting playback. Increasing the buffer size increases the playback latency, but it decreases the likelihood that rebuffering will occur during playback. We recommend that a live HLS media playlist have a minimum of 3 fragments and a maximum of 10 fragments.

The default is 5 fragments if PlaybackMode is LIVE, and 1,000 if PlaybackMode is ON_DEMAND.

The maximum value of 1,000 fragments corresponds to more than 16 minutes of video on streams with 1-second fragments, and more than 2 1/2 hours of video on streams with 10-second fragments.

" - } - } - }, - "GetHLSStreamingSessionURLOutput":{ - "type":"structure", - "members":{ - "HLSStreamingSessionURL":{ - "shape":"HLSStreamingSessionURL", - "documentation":"

The URL (containing the session token) that a media player can use to retrieve the HLS master playlist.

" - } - } - }, - "GetMediaForFragmentListInput":{ - "type":"structure", - "required":[ - "StreamName", - "Fragments" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream from which to retrieve fragment media.

" - }, - "Fragments":{ - "shape":"FragmentNumberList", - "documentation":"

A list of the numbers of fragments for which to retrieve media. You retrieve these values with ListFragments.

" - } - } - }, - "GetMediaForFragmentListOutput":{ - "type":"structure", - "members":{ - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the requested media.

", - "location":"header", - "locationName":"Content-Type" - }, - "Payload":{ - "shape":"Payload", - "documentation":"

The payload that Kinesis Video Streams returns is a sequence of chunks from the specified stream. For information about the chunks, see PutMedia. The chunks that Kinesis Video Streams returns in the GetMediaForFragmentList call also include the following additional Matroska (MKV) tags:

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Fragment number returned in the chunk.

  • AWS_KINESISVIDEO_SERVER_SIDE_TIMESTAMP - Server-side time stamp of the fragment.

  • AWS_KINESISVIDEO_PRODUCER_SIDE_TIMESTAMP - Producer-side time stamp of the fragment.

The following tags will be included if an exception occurs:

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - The number of the fragment that threw the exception

  • AWS_KINESISVIDEO_EXCEPTION_ERROR_CODE - The integer code of the exception

  • AWS_KINESISVIDEO_EXCEPTION_MESSAGE - A text description of the exception

" - } - }, - "payload":"Payload" - }, - "HLSFragmentSelector":{ - "type":"structure", - "members":{ - "FragmentSelectorType":{ - "shape":"HLSFragmentSelectorType", - "documentation":"

The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is ON_DEMAND, the first fragment ingested with a producer time stamp within the specified FragmentSelector$TimestampRange is included in the media playlist. In addition, the fragments with producer time stamps within the TimestampRange ingested immediately following the first fragment (up to the GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults value) are included.

Fragments that have duplicate producer time stamps are deduplicated. This means that if producers are producing a stream of fragments with producer time stamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested time stamp range. If some fragments are ingested within the same time range and very different points in time, only the oldest ingested collection of fragments are returned.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is LIVE, the producer time stamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server time stamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer time stamps with values now, they are not included in the HLS media playlist.

The default is SERVER_TIMESTAMP.

" - }, - "TimestampRange":{ - "shape":"HLSTimestampRange", - "documentation":"

The start and end of the time stamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

" - } - }, - "documentation":"

Contains the range of time stamps for the requested media, and the source of the time stamps.

" - }, - "HLSFragmentSelectorType":{ - "type":"string", - "enum":[ - "PRODUCER_TIMESTAMP", - "SERVER_TIMESTAMP" - ] - }, - "HLSStreamingSessionURL":{"type":"string"}, - "HLSTimestampRange":{ - "type":"structure", - "members":{ - "StartTimestamp":{ - "shape":"Timestamp", - "documentation":"

The start of the time stamp range for the requested media.

If the HLSTimestampRange value is specified, the StartTimestamp value is required.

This value is inclusive. Fragments that start before the StartTimestamp and continue past it are included in the session. If FragmentSelectorType is SERVER_TIMESTAMP, the StartTimestamp must be later than the stream head.

" - }, - "EndTimestamp":{ - "shape":"Timestamp", - "documentation":"

The end of the time stamp range for the requested media. This value must be within 3 hours of the specified StartTimestamp, and it must be later than the StartTimestamp value.

If FragmentSelectorType for the request is SERVER_TIMESTAMP, this value must be in the past.

If the HLSTimestampRange value is specified, the EndTimestamp value is required.

This value is inclusive. The EndTimestamp is compared to the (starting) time stamp of the fragment. Fragments that start before the EndTimestamp value and continue past it are included in the session.

" - } - }, - "documentation":"

The start and end of the time stamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

The values in the HLSTimestampRange are inclusive. Fragments that begin before the start time but continue past it, or fragments that begin before the end time but continue past it, are included in the session.

" - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

A specified parameter exceeds its restrictions, is not supported, or can't be used.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidCodecPrivateDataException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The Codec Private Data in the video stream is not valid for this operation.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ListFragmentsInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream from which to retrieve a fragment list.

" - }, - "MaxResults":{ - "shape":"PageLimit", - "documentation":"

The total number of fragments to return. If the total number of fragments available is more than the value specified in max-results, then a ListFragmentsOutput$NextToken is provided in the output that you can use to resume pagination.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

A token to specify where to start paginating. This is the ListFragmentsOutput$NextToken from a previously truncated response.

" - }, - "FragmentSelector":{ - "shape":"FragmentSelector", - "documentation":"

Describes the time stamp range and time stamp origin for the range of fragments to return.

" - } - } - }, - "ListFragmentsOutput":{ - "type":"structure", - "members":{ - "Fragments":{ - "shape":"FragmentList", - "documentation":"

A list of fragment numbers that correspond to the time stamp range provided.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If the returned list is truncated, the operation returns this token to use to retrieve the next page of results. This value is null when there are no more results to return.

" - } - } - }, - "Long":{"type":"long"}, - "MissingCodecPrivateDataException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

No Codec Private Data was found in the video stream.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NoDataRetentionException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

A PlaybackMode of ON_DEMAND was requested for a stream that does not retain data (that is, has a DataRetentionInHours of 0).

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Status Code: 403, The caller is not authorized to perform an operation on the given stream, or the token has expired.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "PageLimit":{ - "type":"long", - "max":1000, - "min":1 - }, - "Payload":{ - "type":"blob", - "streaming":true - }, - "PlaybackMode":{ - "type":"string", - "enum":[ - "LIVE", - "ON_DEMAND" - ] - }, - "ResourceARN":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

GetMedia throws this error when Kinesis Video Streams can't find the stream that you specified.

GetHLSStreamingSessionURL throws this error if a session with a PlaybackMode of ON_DEMAND is requested for a stream that has no fragments within the requested time range, or if a session with a PlaybackMode of LIVE is requested for a stream that has no fragments within the last 30 seconds.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "StreamName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "String":{ - "type":"string", - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "TimestampRange":{ - "type":"structure", - "required":[ - "StartTimestamp", - "EndTimestamp" - ], - "members":{ - "StartTimestamp":{ - "shape":"Timestamp", - "documentation":"

The starting time stamp in the range of time stamps for which to return fragments.

" - }, - "EndTimestamp":{ - "shape":"Timestamp", - "documentation":"

The ending time stamp in the range of time stamps for which to return fragments.

" - } - }, - "documentation":"

The range of time stamps for which to return fragments.

" - }, - "UnsupportedStreamMediaTypeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An HLS streaming session was requested for a stream with a media type that is not video/h264.

", - "error":{"httpStatusCode":400}, - "exception":true - } - }, - "documentation":"

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/service-2.json deleted file mode 100644 index fe307b52..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis-video-media/2017-09-30/service-2.json +++ /dev/null @@ -1,194 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-30", - "endpointPrefix":"kinesisvideo", - "protocol":"rest-json", - "serviceAbbreviation":"Kinesis Video Media", - "serviceFullName":"Amazon Kinesis Video Streams Media", - "serviceId":"Kinesis Video Media", - "signatureVersion":"v4", - "uid":"kinesis-video-media-2017-09-30" - }, - "operations":{ - "GetMedia":{ - "name":"GetMedia", - "http":{ - "method":"POST", - "requestUri":"/getMedia" - }, - "input":{"shape":"GetMediaInput"}, - "output":{"shape":"GetMediaOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidEndpointException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"ConnectionLimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Use this API to retrieve media content from a Kinesis video stream. In the request, you identify stream name or stream Amazon Resource Name (ARN), and the starting chunk. Kinesis Video Streams then returns a stream of chunks in order by fragment number.

You must first call the GetDataEndpoint API to get an endpoint to which you can then send the GetMedia requests.

When you put media data (fragments) on a stream, Kinesis Video Streams stores each incoming fragment and related metadata in what is called a \"chunk.\" For more information, see . The GetMedia API returns a stream of these chunks starting from the chunk that you specify in the request.

The following limits apply when using the GetMedia API:

  • A client can call GetMedia up to five times per second per stream.

  • Kinesis Video Streams sends media data at a rate of up to 25 megabytes per second (or 200 megabits per second) during a GetMedia session.

" - } - }, - "shapes":{ - "ClientLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client calls. Try making the call later.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ConnectionLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client connections.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ContentType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_\\.\\-]+$" - }, - "ContinuationToken":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[a-zA-Z0-9_\\.\\-]+$" - }, - "ErrorMessage":{"type":"string"}, - "FragmentNumberString":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[0-9]+$" - }, - "GetMediaInput":{ - "type":"structure", - "required":["StartSelector"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The Kinesis video stream name from where you want to get the media content. If you don't specify the streamName, you must specify the streamARN.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN of the stream from where you want to get the media content. If you don't specify the streamARN, you must specify the streamName.

" - }, - "StartSelector":{ - "shape":"StartSelector", - "documentation":"

Identifies the starting chunk to get from the specified stream.

" - } - } - }, - "GetMediaOutput":{ - "type":"structure", - "members":{ - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the requested media.

", - "location":"header", - "locationName":"Content-Type" - }, - "Payload":{ - "shape":"Payload", - "documentation":"

The payload Kinesis Video Streams returns is a sequence of chunks from the specified stream. For information about the chunks, see . The chunks that Kinesis Video Streams returns in the GetMedia call also include the following additional Matroska (MKV) tags:

  • AWS_KINESISVIDEO_CONTINUATION_TOKEN (UTF-8 string) - In the event your GetMedia call terminates, you can use this continuation token in your next request to get the next chunk where the last request terminated.

  • AWS_KINESISVIDEO_MILLIS_BEHIND_NOW (UTF-8 string) - Client applications can use this tag value to determine how far behind the chunk returned in the response is from the latest chunk on the stream.

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Fragment number returned in the chunk.

  • AWS_KINESISVIDEO_SERVER_TIMESTAMP - Server time stamp of the fragment.

  • AWS_KINESISVIDEO_PRODUCER_TIMESTAMP - Producer time stamp of the fragment.

The following tags will be present if an error occurs:

  • AWS_KINESISVIDEO_ERROR_CODE - String description of an error that caused GetMedia to stop.

  • AWS_KINESISVIDEO_ERROR_ID: Integer code of the error.

The error codes are as follows:

  • 3002 - Error writing to the stream

  • 4000 - Requested fragment is not found

  • 4500 - Access denied for the stream's KMS key

  • 4501 - Stream's KMS key is disabled

  • 4502 - Validation error on the Stream's KMS key

  • 4503 - KMS key specified in the stream is unavailable

  • 4504 - Invalid usage of the KMS key specified in the stream

  • 4505 - Invalid state of the KMS key specified in the stream

  • 4506 - Unable to find the KMS key specified in the stream

  • 5000 - Internal error

" - } - }, - "payload":"Payload" - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The value for this input parameter is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidEndpointException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Status Code: 400, Caller used wrong endpoint to write data to a stream. On receiving such an exception, the user must call GetDataEndpoint with AccessMode set to \"READ\" and use the endpoint Kinesis Video returns in the next GetMedia call.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Status Code: 403, The caller is not authorized to perform an operation on the given stream, or the token has expired.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "Payload":{ - "type":"blob", - "streaming":true - }, - "ResourceARN":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Status Code: 404, The stream with the given name does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "StartSelector":{ - "type":"structure", - "required":["StartSelectorType"], - "members":{ - "StartSelectorType":{ - "shape":"StartSelectorType", - "documentation":"

Identifies the fragment on the Kinesis video stream where you want to start getting the data from.

  • NOW - Start with the latest chunk on the stream.

  • EARLIEST - Start with earliest available chunk on the stream.

  • FRAGMENT_NUMBER - Start with the chunk containing the specific fragment. You must also specify the StartFragmentNumber.

  • PRODUCER_TIMESTAMP or SERVER_TIMESTAMP - Start with the chunk containing a fragment with the specified producer or server time stamp. You specify the time stamp by adding StartTimestamp.

  • CONTINUATION_TOKEN - Read using the specified continuation token.

If you choose the NOW, EARLIEST, or CONTINUATION_TOKEN as the startSelectorType, you don't provide any additional information in the startSelector.

" - }, - "AfterFragmentNumber":{ - "shape":"FragmentNumberString", - "documentation":"

Specifies the fragment number from where you want the GetMedia API to start returning the fragments.

" - }, - "StartTimestamp":{ - "shape":"Timestamp", - "documentation":"

A time stamp value. This value is required if you choose the PRODUCER_TIMESTAMP or the SERVER_TIMESTAMP as the startSelectorType. The GetMedia API then starts with the chunk containing the fragment that has the specified time stamp.

" - }, - "ContinuationToken":{ - "shape":"ContinuationToken", - "documentation":"

Continuation token that Kinesis Video Streams returned in the previous GetMedia response. The GetMedia API then starts with the chunk identified by the continuation token.

" - } - }, - "documentation":"

Identifies the chunk on the Kinesis video stream where you want the GetMedia API to start returning media data. You have the following options to identify the starting chunk:

  • Choose the latest (or oldest) chunk.

  • Identify a specific chunk. You can identify a specific chunk either by providing a fragment number or time stamp (server or producer).

  • Each chunk's metadata includes a continuation token as a Matroska (MKV) tag (AWS_KINESISVIDEO_CONTINUATION_TOKEN). If your previous GetMedia request terminated, you can use this tag value in your next GetMedia request. The API then starts returning chunks starting where the last API ended.

" - }, - "StartSelectorType":{ - "type":"string", - "enum":[ - "FRAGMENT_NUMBER", - "SERVER_TIMESTAMP", - "PRODUCER_TIMESTAMP", - "NOW", - "EARLIEST", - "CONTINUATION_TOKEN" - ] - }, - "StreamName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "Timestamp":{"type":"timestamp"} - }, - "documentation":"

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/paginators-1.json deleted file mode 100644 index 5f6d0a45..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "DescribeStream": { - "input_token": "ExclusiveStartShardId", - "limit_key": "Limit", - "more_results": "StreamDescription.HasMoreShards", - "output_token": "StreamDescription.Shards[-1].ShardId", - "result_key": "StreamDescription.Shards", - "non_aggregate_keys": [ - "StreamDescription.StreamARN", - "StreamDescription.StreamName", - "StreamDescription.StreamStatus", - "StreamDescription.RetentionPeriodHours", - "StreamDescription.EnhancedMonitoring", - "StreamDescription.EncryptionType", - "StreamDescription.KeyId", - "StreamDescription.StreamCreationTimestamp" - ] - }, - "ListStreams": { - "input_token": "ExclusiveStartStreamName", - "limit_key": "Limit", - "more_results": "HasMoreStreams", - "output_token": "StreamNames[-1]", - "result_key": "StreamNames" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/service-2.json deleted file mode 100644 index 21eb2c60..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/service-2.json +++ /dev/null @@ -1,2005 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-12-02", - "endpointPrefix":"kinesis", - "jsonVersion":"1.1", - "protocol":"json", - "protocolSettings":{"h2":"eventstream"}, - "serviceAbbreviation":"Kinesis", - "serviceFullName":"Amazon Kinesis", - "serviceId":"Kinesis", - "signatureVersion":"v4", - "targetPrefix":"Kinesis_20131202", - "uid":"kinesis-2013-12-02" - }, - "operations":{ - "AddTagsToStream":{ - "name":"AddTagsToStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToStreamInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Adds or updates tags for the specified Kinesis data stream. Each time you invoke this operation, you can specify up to 10 tags. If you want to add more than 10 tags to your stream, you can invoke this operation multiple times. In total, each stream can have up to 50 tags.

If tags have already been assigned to the stream, AddTagsToStream overwrites any existing tags that correspond to the specified tag keys.

AddTagsToStream has a limit of five transactions per second per account.

" - }, - "CreateStream":{ - "name":"CreateStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStreamInput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Creates a Kinesis data stream. A stream captures and transports data records that are continuously emitted from different data sources or producers. Scale-out within a stream is explicitly supported by means of shards, which are uniquely identified groups of data records in a stream.

You specify and control the number of shards that a stream is composed of. Each shard can support reads up to five transactions per second, up to a maximum data read total of 2 MB per second. Each shard can support writes up to 1,000 records per second, up to a maximum data write total of 1 MB per second. If the amount of data input increases or decreases, you can add or remove shards.

The stream name identifies the stream. The name is scoped to the AWS account used by the application. It is also scoped by AWS Region. That is, two streams in two different accounts can have the same name, and two streams in the same account, but in two different Regions, can have the same name.

CreateStream is an asynchronous operation. Upon receiving a CreateStream request, Kinesis Data Streams immediately returns and sets the stream status to CREATING. After the stream is created, Kinesis Data Streams sets the stream status to ACTIVE. You should perform read and write operations only on an ACTIVE stream.

You receive a LimitExceededException when making a CreateStream request when you try to do one of the following:

  • Have more than five streams in the CREATING state at any point in time.

  • Create more shards than are authorized for your account.

For the default shard limit for an AWS account, see Amazon Kinesis Data Streams Limits in the Amazon Kinesis Data Streams Developer Guide. To increase this limit, contact AWS Support.

You can use DescribeStream to check the stream status, which is returned in StreamStatus.

CreateStream has a limit of five transactions per second per account.

" - }, - "DecreaseStreamRetentionPeriod":{ - "name":"DecreaseStreamRetentionPeriod", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DecreaseStreamRetentionPeriodInput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Decreases the Kinesis data stream's retention period, which is the length of time data records are accessible after they are added to the stream. The minimum value of a stream's retention period is 24 hours.

This operation may result in lost data. For example, if the stream's retention period is 48 hours and is decreased to 24 hours, any data already in the stream that is older than 24 hours is inaccessible.

" - }, - "DeleteStream":{ - "name":"DeleteStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStreamInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes a Kinesis data stream and all its shards and data. You must shut down any applications that are operating on the stream before you delete the stream. If an application attempts to operate on a deleted stream, it receives the exception ResourceNotFoundException.

If the stream is in the ACTIVE state, you can delete it. After a DeleteStream request, the specified stream is in the DELETING state until Kinesis Data Streams completes the deletion.

Note: Kinesis Data Streams might continue to accept data read and write operations, such as PutRecord, PutRecords, and GetRecords, on a stream in the DELETING state until the stream deletion is complete.

When you delete a stream, any shards in that stream are also deleted, and any tags are dissociated from the stream.

You can use the DescribeStream operation to check the state of the stream, which is returned in StreamStatus.

DeleteStream has a limit of five transactions per second per account.

" - }, - "DeregisterStreamConsumer":{ - "name":"DeregisterStreamConsumer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterStreamConsumerInput"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

To deregister a consumer, provide its ARN. Alternatively, you can provide the ARN of the data stream and the name you gave the consumer when you registered it. You may also provide all three parameters, as long as they don't conflict with each other. If you don't know the name or ARN of the consumer that you want to deregister, you can use the ListStreamConsumers operation to get a list of the descriptions of all the consumers that are currently registered with a given data stream. The description of a consumer contains its name and ARN.

This operation has a limit of five transactions per second per account.

" - }, - "DescribeLimits":{ - "name":"DescribeLimits", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLimitsInput"}, - "output":{"shape":"DescribeLimitsOutput"}, - "errors":[ - {"shape":"LimitExceededException"} - ], - "documentation":"

Describes the shard limits and usage for the account.

If you update your account limits, the old limits might be returned for a few minutes.

This operation has a limit of one transaction per second per account.

" - }, - "DescribeStream":{ - "name":"DescribeStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStreamInput"}, - "output":{"shape":"DescribeStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Describes the specified Kinesis data stream.

The information returned includes the stream name, Amazon Resource Name (ARN), creation time, enhanced metric configuration, and shard map. The shard map is an array of shard objects. For each shard object, there is the hash key and sequence number ranges that the shard spans, and the IDs of any earlier shards that played in a role in creating the shard. Every record ingested in the stream is identified by a sequence number, which is assigned when the record is put into the stream.

You can limit the number of shards returned by each call. For more information, see Retrieving Shards from a Stream in the Amazon Kinesis Data Streams Developer Guide.

There are no guarantees about the chronological order shards returned. To process shards in chronological order, use the ID of the parent shard to track the lineage to the oldest shard.

This operation has a limit of 10 transactions per second per account.

" - }, - "DescribeStreamConsumer":{ - "name":"DescribeStreamConsumer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStreamConsumerInput"}, - "output":{"shape":"DescribeStreamConsumerOutput"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

To get the description of a registered consumer, provide the ARN of the consumer. Alternatively, you can provide the ARN of the data stream and the name you gave the consumer when you registered it. You may also provide all three parameters, as long as they don't conflict with each other. If you don't know the name or ARN of the consumer that you want to describe, you can use the ListStreamConsumers operation to get a list of the descriptions of all the consumers that are currently registered with a given data stream.

This operation has a limit of 20 transactions per second per account.

" - }, - "DescribeStreamSummary":{ - "name":"DescribeStreamSummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStreamSummaryInput"}, - "output":{"shape":"DescribeStreamSummaryOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Provides a summarized description of the specified Kinesis data stream without the shard list.

The information returned includes the stream name, Amazon Resource Name (ARN), status, record retention period, approximate creation time, monitoring, encryption details, and open shard count.

" - }, - "DisableEnhancedMonitoring":{ - "name":"DisableEnhancedMonitoring", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableEnhancedMonitoringInput"}, - "output":{"shape":"EnhancedMonitoringOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disables enhanced monitoring.

" - }, - "EnableEnhancedMonitoring":{ - "name":"EnableEnhancedMonitoring", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableEnhancedMonitoringInput"}, - "output":{"shape":"EnhancedMonitoringOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Enables enhanced Kinesis data stream monitoring for shard-level metrics.

" - }, - "GetRecords":{ - "name":"GetRecords", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRecordsInput"}, - "output":{"shape":"GetRecordsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ExpiredIteratorException"}, - {"shape":"KMSDisabledException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"KMSAccessDeniedException"}, - {"shape":"KMSNotFoundException"}, - {"shape":"KMSOptInRequired"}, - {"shape":"KMSThrottlingException"} - ], - "documentation":"

Gets data records from a Kinesis data stream's shard.

Specify a shard iterator using the ShardIterator parameter. The shard iterator specifies the position in the shard from which you want to start reading data records sequentially. If there are no records available in the portion of the shard that the iterator points to, GetRecords returns an empty list. It might take multiple calls to get to a portion of the shard that contains records.

You can scale by provisioning multiple shards per stream while considering service limits (for more information, see Amazon Kinesis Data Streams Limits in the Amazon Kinesis Data Streams Developer Guide). Your application should have one thread per shard, each reading continuously from its stream. To read from a stream continually, call GetRecords in a loop. Use GetShardIterator to get the shard iterator to specify in the first GetRecords call. GetRecords returns a new shard iterator in NextShardIterator. Specify the shard iterator returned in NextShardIterator in subsequent calls to GetRecords. If the shard has been closed, the shard iterator can't return more data and GetRecords returns null in NextShardIterator. You can terminate the loop when the shard is closed, or when the shard iterator reaches the record with the sequence number or other attribute that marks it as the last record to process.

Each data record can be up to 1 MiB in size, and each shard can read up to 2 MiB per second. You can ensure that your calls don't exceed the maximum supported size or throughput by using the Limit parameter to specify the maximum number of records that GetRecords can return. Consider your average record size when determining this limit. The maximum number of records that can be returned per call is 10,000.

The size of the data returned by GetRecords varies depending on the utilization of the shard. The maximum size of data that GetRecords can return is 10 MiB. If a call returns this amount of data, subsequent calls made within the next 5 seconds throw ProvisionedThroughputExceededException. If there is insufficient provisioned throughput on the stream, subsequent calls made within the next 1 second throw ProvisionedThroughputExceededException. GetRecords doesn't return any data when it throws an exception. For this reason, we recommend that you wait 1 second between calls to GetRecords. However, it's possible that the application will get exceptions for longer than 1 second.

To detect whether the application is falling behind in processing, you can use the MillisBehindLatest response attribute. You can also monitor the stream using CloudWatch metrics and other mechanisms (see Monitoring in the Amazon Kinesis Data Streams Developer Guide).

Each Amazon Kinesis record includes a value, ApproximateArrivalTimestamp, that is set when a stream successfully receives and stores a record. This is commonly referred to as a server-side time stamp, whereas a client-side time stamp is set when a data producer creates or sends the record to a stream (a data producer is any data source putting data records into a stream, for example with PutRecords). The time stamp has millisecond precision. There are no guarantees about the time stamp accuracy, or that the time stamp is always increasing. For example, records in a shard or across a stream might have time stamps that are out of order.

This operation has a limit of five transactions per second per account.

" - }, - "GetShardIterator":{ - "name":"GetShardIterator", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetShardIteratorInput"}, - "output":{"shape":"GetShardIteratorOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Gets an Amazon Kinesis shard iterator. A shard iterator expires 5 minutes after it is returned to the requester.

A shard iterator specifies the shard position from which to start reading data records sequentially. The position is specified using the sequence number of a data record in a shard. A sequence number is the identifier associated with every record ingested in the stream, and is assigned when a record is put into the stream. Each stream has one or more shards.

You must specify the shard iterator type. For example, you can set the ShardIteratorType parameter to read exactly from the position denoted by a specific sequence number by using the AT_SEQUENCE_NUMBER shard iterator type. Alternatively, the parameter can read right after the sequence number by using the AFTER_SEQUENCE_NUMBER shard iterator type, using sequence numbers returned by earlier calls to PutRecord, PutRecords, GetRecords, or DescribeStream. In the request, you can specify the shard iterator type AT_TIMESTAMP to read records from an arbitrary point in time, TRIM_HORIZON to cause ShardIterator to point to the last untrimmed record in the shard in the system (the oldest data record in the shard), or LATEST so that you always read the most recent data in the shard.

When you read repeatedly from a stream, use a GetShardIterator request to get the first shard iterator for use in your first GetRecords request and for subsequent reads use the shard iterator returned by the GetRecords request in NextShardIterator. A new shard iterator is returned by every GetRecords request in NextShardIterator, which you use in the ShardIterator parameter of the next GetRecords request.

If a GetShardIterator request is made too often, you receive a ProvisionedThroughputExceededException. For more information about throughput limits, see GetRecords, and Streams Limits in the Amazon Kinesis Data Streams Developer Guide.

If the shard is closed, GetShardIterator returns a valid iterator for the last sequence number of the shard. A shard can be closed as a result of using SplitShard or MergeShards.

GetShardIterator has a limit of five transactions per second per account per open shard.

" - }, - "IncreaseStreamRetentionPeriod":{ - "name":"IncreaseStreamRetentionPeriod", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IncreaseStreamRetentionPeriodInput"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Increases the Kinesis data stream's retention period, which is the length of time data records are accessible after they are added to the stream. The maximum value of a stream's retention period is 168 hours (7 days).

If you choose a longer stream retention period, this operation increases the time period during which records that have not yet expired are accessible. However, it does not make previous, expired data (older than the stream's previous retention period) accessible after the operation has been called. For example, if a stream's retention period is set to 24 hours and is increased to 168 hours, any data that is older than 24 hours remains inaccessible to consumer applications.

" - }, - "ListShards":{ - "name":"ListShards", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListShardsInput"}, - "output":{"shape":"ListShardsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ExpiredNextTokenException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Lists the shards in a stream and provides information about each shard. This operation has a limit of 100 transactions per second per data stream.

This API is a new operation that is used by the Amazon Kinesis Client Library (KCL). If you have a fine-grained IAM policy that only allows specific operations, you must update your policy to allow calls to this API. For more information, see Controlling Access to Amazon Kinesis Data Streams Resources Using IAM.

" - }, - "ListStreamConsumers":{ - "name":"ListStreamConsumers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStreamConsumersInput"}, - "output":{"shape":"ListStreamConsumersOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ExpiredNextTokenException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Lists the consumers registered to receive data from a stream using enhanced fan-out, and provides information about each consumer.

This operation has a limit of 10 transactions per second per account.

" - }, - "ListStreams":{ - "name":"ListStreams", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStreamsInput"}, - "output":{"shape":"ListStreamsOutput"}, - "errors":[ - {"shape":"LimitExceededException"} - ], - "documentation":"

Lists your Kinesis data streams.

The number of streams may be too large to return from a single call to ListStreams. You can limit the number of returned streams using the Limit parameter. If you do not specify a value for the Limit parameter, Kinesis Data Streams uses the default limit, which is currently 10.

You can detect if there are more streams available to list by using the HasMoreStreams flag from the returned output. If there are more streams available, you can request more streams by using the name of the last stream returned by the ListStreams request in the ExclusiveStartStreamName parameter in a subsequent request to ListStreams. The group of stream names returned by the subsequent request is then added to the list. You can continue this process until all the stream names have been collected in the list.

ListStreams has a limit of five transactions per second per account.

" - }, - "ListTagsForStream":{ - "name":"ListTagsForStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForStreamInput"}, - "output":{"shape":"ListTagsForStreamOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Lists the tags for the specified Kinesis data stream. This operation has a limit of five transactions per second per account.

" - }, - "MergeShards":{ - "name":"MergeShards", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MergeShardsInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Merges two adjacent shards in a Kinesis data stream and combines them into a single shard to reduce the stream's capacity to ingest and transport data. Two shards are considered adjacent if the union of the hash key ranges for the two shards form a contiguous set with no gaps. For example, if you have two shards, one with a hash key range of 276...381 and the other with a hash key range of 382...454, then you could merge these two shards into a single shard that would have a hash key range of 276...454. After the merge, the single child shard receives data for all hash key values covered by the two parent shards.

MergeShards is called when there is a need to reduce the overall capacity of a stream because of excess capacity that is not being used. You must specify the shard to be merged and the adjacent shard for a stream. For more information about merging shards, see Merge Two Shards in the Amazon Kinesis Data Streams Developer Guide.

If the stream is in the ACTIVE state, you can call MergeShards. If a stream is in the CREATING, UPDATING, or DELETING state, MergeShards returns a ResourceInUseException. If the specified stream does not exist, MergeShards returns a ResourceNotFoundException.

You can use DescribeStream to check the state of the stream, which is returned in StreamStatus.

MergeShards is an asynchronous operation. Upon receiving a MergeShards request, Amazon Kinesis Data Streams immediately returns a response and sets the StreamStatus to UPDATING. After the operation is completed, Kinesis Data Streams sets the StreamStatus to ACTIVE. Read and write operations continue to work while the stream is in the UPDATING state.

You use DescribeStream to determine the shard IDs that are specified in the MergeShards request.

If you try to operate on too many streams in parallel using CreateStream, DeleteStream, MergeShards, or SplitShard, you receive a LimitExceededException.

MergeShards has a limit of five transactions per second per account.

" - }, - "PutRecord":{ - "name":"PutRecord", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRecordInput"}, - "output":{"shape":"PutRecordOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"KMSDisabledException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"KMSAccessDeniedException"}, - {"shape":"KMSNotFoundException"}, - {"shape":"KMSOptInRequired"}, - {"shape":"KMSThrottlingException"} - ], - "documentation":"

Writes a single data record into an Amazon Kinesis data stream. Call PutRecord to send data into the stream for real-time ingestion and subsequent processing, one record at a time. Each shard can support writes up to 1,000 records per second, up to a maximum data write total of 1 MB per second.

You must specify the name of the stream that captures, stores, and transports the data; a partition key; and the data blob itself.

The data blob can be any type of data; for example, a segment from a log file, geographic/location data, website clickstream data, and so on.

The partition key is used by Kinesis Data Streams to distribute data across shards. Kinesis Data Streams segregates the data records that belong to a stream into multiple shards, using the partition key associated with each data record to determine the shard to which a given data record belongs.

Partition keys are Unicode strings, with a maximum length limit of 256 characters for each key. An MD5 hash function is used to map partition keys to 128-bit integer values and to map associated data records to shards using the hash key ranges of the shards. You can override hashing the partition key to determine the shard by explicitly specifying a hash value using the ExplicitHashKey parameter. For more information, see Adding Data to a Stream in the Amazon Kinesis Data Streams Developer Guide.

PutRecord returns the shard ID of where the data record was placed and the sequence number that was assigned to the data record.

Sequence numbers increase over time and are specific to a shard within a stream, not across all shards within a stream. To guarantee strictly increasing ordering, write serially to a shard and use the SequenceNumberForOrdering parameter. For more information, see Adding Data to a Stream in the Amazon Kinesis Data Streams Developer Guide.

If a PutRecord request cannot be processed because of insufficient provisioned throughput on the shard involved in the request, PutRecord throws ProvisionedThroughputExceededException.

By default, data records are accessible for 24 hours from the time that they are added to a stream. You can use IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to modify this retention period.

" - }, - "PutRecords":{ - "name":"PutRecords", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRecordsInput"}, - "output":{"shape":"PutRecordsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"KMSDisabledException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"KMSAccessDeniedException"}, - {"shape":"KMSNotFoundException"}, - {"shape":"KMSOptInRequired"}, - {"shape":"KMSThrottlingException"} - ], - "documentation":"

Writes multiple data records into a Kinesis data stream in a single call (also referred to as a PutRecords request). Use this operation to send data into the stream for data ingestion and processing.

Each PutRecords request can support up to 500 records. Each record in the request can be as large as 1 MB, up to a limit of 5 MB for the entire request, including partition keys. Each shard can support writes up to 1,000 records per second, up to a maximum data write total of 1 MB per second.

You must specify the name of the stream that captures, stores, and transports the data; and an array of request Records, with each record in the array requiring a partition key and data blob. The record size limit applies to the total size of the partition key and data blob.

The data blob can be any type of data; for example, a segment from a log file, geographic/location data, website clickstream data, and so on.

The partition key is used by Kinesis Data Streams as input to a hash function that maps the partition key and associated data to a specific shard. An MD5 hash function is used to map partition keys to 128-bit integer values and to map associated data records to shards. As a result of this hashing mechanism, all data records with the same partition key map to the same shard within the stream. For more information, see Adding Data to a Stream in the Amazon Kinesis Data Streams Developer Guide.

Each record in the Records array may include an optional parameter, ExplicitHashKey, which overrides the partition key to shard mapping. This parameter allows a data producer to determine explicitly the shard where the record is stored. For more information, see Adding Multiple Records with PutRecords in the Amazon Kinesis Data Streams Developer Guide.

The PutRecords response includes an array of response Records. Each record in the response array directly correlates with a record in the request array using natural ordering, from the top to the bottom of the request and response. The response Records array always includes the same number of records as the request array.

The response Records array includes both successfully and unsuccessfully processed records. Kinesis Data Streams attempts to process all records in each PutRecords request. A single record failure does not stop the processing of subsequent records.

A successfully processed record includes ShardId and SequenceNumber values. The ShardId parameter identifies the shard in the stream where the record is stored. The SequenceNumber parameter is an identifier assigned to the put record, unique to all records in the stream.

An unsuccessfully processed record includes ErrorCode and ErrorMessage values. ErrorCode reflects the type of error and can be one of the following values: ProvisionedThroughputExceededException or InternalFailure. ErrorMessage provides more detailed information about the ProvisionedThroughputExceededException exception including the account ID, stream name, and shard ID of the record that was throttled. For more information about partially successful responses, see Adding Multiple Records with PutRecords in the Amazon Kinesis Data Streams Developer Guide.

By default, data records are accessible for 24 hours from the time that they are added to a stream. You can use IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to modify this retention period.

" - }, - "RegisterStreamConsumer":{ - "name":"RegisterStreamConsumer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterStreamConsumerInput"}, - "output":{"shape":"RegisterStreamConsumerOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers a consumer with a Kinesis data stream. When you use this operation, the consumer you register can read data from the stream at a rate of up to 2 MiB per second. This rate is unaffected by the total number of consumers that read from the same stream.

You can register up to 5 consumers per stream. A given consumer can only be registered with one stream.

This operation has a limit of five transactions per second per account.

" - }, - "RemoveTagsFromStream":{ - "name":"RemoveTagsFromStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromStreamInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Removes tags from the specified Kinesis data stream. Removed tags are deleted and cannot be recovered after this operation successfully completes.

If you specify a tag that does not exist, it is ignored.

RemoveTagsFromStream has a limit of five transactions per second per account.

" - }, - "SplitShard":{ - "name":"SplitShard", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SplitShardInput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Splits a shard into two new shards in the Kinesis data stream, to increase the stream's capacity to ingest and transport data. SplitShard is called when there is a need to increase the overall capacity of a stream because of an expected increase in the volume of data records being ingested.

You can also use SplitShard when a shard appears to be approaching its maximum utilization; for example, the producers sending data into the specific shard are suddenly sending more than previously anticipated. You can also call SplitShard to increase stream capacity, so that more Kinesis Data Streams applications can simultaneously read data from the stream for real-time processing.

You must specify the shard to be split and the new hash key, which is the position in the shard where the shard gets split in two. In many cases, the new hash key might be the average of the beginning and ending hash key, but it can be any hash key value in the range being mapped into the shard. For more information, see Split a Shard in the Amazon Kinesis Data Streams Developer Guide.

You can use DescribeStream to determine the shard ID and hash key values for the ShardToSplit and NewStartingHashKey parameters that are specified in the SplitShard request.

SplitShard is an asynchronous operation. Upon receiving a SplitShard request, Kinesis Data Streams immediately returns a response and sets the stream status to UPDATING. After the operation is completed, Kinesis Data Streams sets the stream status to ACTIVE. Read and write operations continue to work while the stream is in the UPDATING state.

You can use DescribeStream to check the status of the stream, which is returned in StreamStatus. If the stream is in the ACTIVE state, you can call SplitShard. If a stream is in CREATING or UPDATING or DELETING states, DescribeStream returns a ResourceInUseException.

If the specified stream does not exist, DescribeStream returns a ResourceNotFoundException. If you try to create more shards than are authorized for your account, you receive a LimitExceededException.

For the default shard limit for an AWS account, see Kinesis Data Streams Limits in the Amazon Kinesis Data Streams Developer Guide. To increase this limit, contact AWS Support.

If you try to operate on too many streams simultaneously using CreateStream, DeleteStream, MergeShards, and/or SplitShard, you receive a LimitExceededException.

SplitShard has a limit of five transactions per second per account.

" - }, - "StartStreamEncryption":{ - "name":"StartStreamEncryption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartStreamEncryptionInput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"KMSDisabledException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"KMSAccessDeniedException"}, - {"shape":"KMSNotFoundException"}, - {"shape":"KMSOptInRequired"}, - {"shape":"KMSThrottlingException"} - ], - "documentation":"

Enables or updates server-side encryption using an AWS KMS key for a specified stream.

Starting encryption is an asynchronous operation. Upon receiving the request, Kinesis Data Streams returns immediately and sets the status of the stream to UPDATING. After the update is complete, Kinesis Data Streams sets the status of the stream back to ACTIVE. Updating or applying encryption normally takes a few seconds to complete, but it can take minutes. You can continue to read and write data to your stream while its status is UPDATING. Once the status of the stream is ACTIVE, encryption begins for records written to the stream.

API Limits: You can successfully apply a new AWS KMS key for server-side encryption 25 times in a rolling 24-hour period.

Note: It can take up to 5 seconds after the stream is in an ACTIVE status before all records written to the stream are encrypted. After you enable encryption, you can verify that encryption is applied by inspecting the API response from PutRecord or PutRecords.

" - }, - "StopStreamEncryption":{ - "name":"StopStreamEncryption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopStreamEncryptionInput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disables server-side encryption for a specified stream.

Stopping encryption is an asynchronous operation. Upon receiving the request, Kinesis Data Streams returns immediately and sets the status of the stream to UPDATING. After the update is complete, Kinesis Data Streams sets the status of the stream back to ACTIVE. Stopping encryption normally takes a few seconds to complete, but it can take minutes. You can continue to read and write data to your stream while its status is UPDATING. Once the status of the stream is ACTIVE, records written to the stream are no longer encrypted by Kinesis Data Streams.

API Limits: You can successfully disable server-side encryption 25 times in a rolling 24-hour period.

Note: It can take up to 5 seconds after the stream is in an ACTIVE status before all records written to the stream are no longer subject to encryption. After you disabled encryption, you can verify that encryption is not applied by inspecting the API response from PutRecord or PutRecords.

" - }, - "SubscribeToShard":{ - "name":"SubscribeToShard", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SubscribeToShardInput"}, - "output":{"shape":"SubscribeToShardOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Call this operation from your consumer after you call RegisterStreamConsumer to register the consumer with Kinesis Data Streams. If the call succeeds, your consumer starts receiving events of type SubscribeToShardEvent for up to 5 minutes, after which time you need to call SubscribeToShard again to renew the subscription if you want to continue to receive records.

You can make one call to SubscribeToShard per second per ConsumerARN. If your call succeeds, and then you call the operation again less than 5 seconds later, the second call generates a ResourceInUseException. If you call the operation a second time more than 5 seconds after the first call succeeds, the second call succeeds and the first connection gets shut down.

" - }, - "UpdateShardCount":{ - "name":"UpdateShardCount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateShardCountInput"}, - "output":{"shape":"UpdateShardCountOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the shard count of the specified stream to the specified number of shards.

Updating the shard count is an asynchronous operation. Upon receiving the request, Kinesis Data Streams returns immediately and sets the status of the stream to UPDATING. After the update is complete, Kinesis Data Streams sets the status of the stream back to ACTIVE. Depending on the size of the stream, the scaling action could take a few minutes to complete. You can continue to read and write data to your stream while its status is UPDATING.

To update the shard count, Kinesis Data Streams performs splits or merges on individual shards. This can cause short-lived shards to be created, in addition to the final shards. We recommend that you double or halve the shard count, as this results in the fewest number of splits or merges.

This operation has the following default limits. By default, you cannot do the following:

  • Scale more than twice per rolling 24-hour period per stream

  • Scale up to more than double your current shard count for a stream

  • Scale down below half your current shard count for a stream

  • Scale up to more than 500 shards in a stream

  • Scale a stream with more than 500 shards down unless the result is less than 500 shards

  • Scale up to more than the shard limit for your account

For the default limits for an AWS account, see Streams Limits in the Amazon Kinesis Data Streams Developer Guide. To request an increase in the call rate limit, the shard limit for this API, or your overall shard limit, use the limits form.

" - } - }, - "shapes":{ - "AddTagsToStreamInput":{ - "type":"structure", - "required":[ - "StreamName", - "Tags" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "Tags":{ - "shape":"TagMap", - "documentation":"

A set of up to 10 key-value pairs to use to create the tags.

" - } - }, - "documentation":"

Represents the input for AddTagsToStream.

" - }, - "BooleanObject":{"type":"boolean"}, - "Consumer":{ - "type":"structure", - "required":[ - "ConsumerName", - "ConsumerARN", - "ConsumerStatus", - "ConsumerCreationTimestamp" - ], - "members":{ - "ConsumerName":{ - "shape":"ConsumerName", - "documentation":"

The name of the consumer is something you choose when you register the consumer.

" - }, - "ConsumerARN":{ - "shape":"ConsumerARN", - "documentation":"

When you register a consumer, Kinesis Data Streams generates an ARN for it. You need this ARN to be able to call SubscribeToShard.

If you delete a consumer and then create a new one with the same name, it won't have the same ARN. That's because consumer ARNs contain the creation timestamp. This is important to keep in mind if you have IAM policies that reference consumer ARNs.

" - }, - "ConsumerStatus":{ - "shape":"ConsumerStatus", - "documentation":"

A consumer can't read data while in the CREATING or DELETING states.

" - }, - "ConsumerCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

" - } - }, - "documentation":"

An object that represents the details of the consumer you registered.

" - }, - "ConsumerARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"^(arn):aws.*:kinesis:.*:\\d{12}:.*stream\\/[a-zA-Z0-9_.-]+\\/consumer\\/[a-zA-Z0-9_.-]+:[0-9]+" - }, - "ConsumerCountObject":{ - "type":"integer", - "max":1000000, - "min":0 - }, - "ConsumerDescription":{ - "type":"structure", - "required":[ - "ConsumerName", - "ConsumerARN", - "ConsumerStatus", - "ConsumerCreationTimestamp", - "StreamARN" - ], - "members":{ - "ConsumerName":{ - "shape":"ConsumerName", - "documentation":"

The name of the consumer is something you choose when you register the consumer.

" - }, - "ConsumerARN":{ - "shape":"ConsumerARN", - "documentation":"

When you register a consumer, Kinesis Data Streams generates an ARN for it. You need this ARN to be able to call SubscribeToShard.

If you delete a consumer and then create a new one with the same name, it won't have the same ARN. That's because consumer ARNs contain the creation timestamp. This is important to keep in mind if you have IAM policies that reference consumer ARNs.

" - }, - "ConsumerStatus":{ - "shape":"ConsumerStatus", - "documentation":"

A consumer can't read data while in the CREATING or DELETING states.

" - }, - "ConsumerCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

" - }, - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The ARN of the stream with which you registered the consumer.

" - } - }, - "documentation":"

An object that represents the details of a registered consumer.

" - }, - "ConsumerList":{ - "type":"list", - "member":{"shape":"Consumer"} - }, - "ConsumerName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "ConsumerStatus":{ - "type":"string", - "enum":[ - "CREATING", - "DELETING", - "ACTIVE" - ] - }, - "CreateStreamInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardCount" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

A name to identify the stream. The stream name is scoped to the AWS account used by the application that creates the stream. It is also scoped by AWS Region. That is, two streams in two different AWS accounts can have the same name. Two streams in the same AWS account but in two different Regions can also have the same name.

" - }, - "ShardCount":{ - "shape":"PositiveIntegerObject", - "documentation":"

The number of shards that the stream will use. The throughput of the stream is a function of the number of shards; more shards are required for greater provisioned throughput.

DefaultShardLimit;

" - } - }, - "documentation":"

Represents the input for CreateStream.

" - }, - "Data":{ - "type":"blob", - "max":1048576, - "min":0 - }, - "DecreaseStreamRetentionPeriodInput":{ - "type":"structure", - "required":[ - "StreamName", - "RetentionPeriodHours" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to modify.

" - }, - "RetentionPeriodHours":{ - "shape":"RetentionPeriodHours", - "documentation":"

The new retention period of the stream, in hours. Must be less than the current retention period.

" - } - }, - "documentation":"

Represents the input for DecreaseStreamRetentionPeriod.

" - }, - "DeleteStreamInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to delete.

" - }, - "EnforceConsumerDeletion":{ - "shape":"BooleanObject", - "documentation":"

If this parameter is unset (null) or if you set it to false, and the stream has registered consumers, the call to DeleteStream fails with a ResourceInUseException.

" - } - }, - "documentation":"

Represents the input for DeleteStream.

" - }, - "DeregisterStreamConsumerInput":{ - "type":"structure", - "members":{ - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The ARN of the Kinesis data stream that the consumer is registered with. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ConsumerName":{ - "shape":"ConsumerName", - "documentation":"

The name that you gave to the consumer.

" - }, - "ConsumerARN":{ - "shape":"ConsumerARN", - "documentation":"

The ARN returned by Kinesis Data Streams when you registered the consumer. If you don't know the ARN of the consumer that you want to deregister, you can use the ListStreamConsumers operation to get a list of the descriptions of all the consumers that are currently registered with a given data stream. The description of a consumer contains its ARN.

" - } - } - }, - "DescribeLimitsInput":{ - "type":"structure", - "members":{ - } - }, - "DescribeLimitsOutput":{ - "type":"structure", - "required":[ - "ShardLimit", - "OpenShardCount" - ], - "members":{ - "ShardLimit":{ - "shape":"ShardCountObject", - "documentation":"

The maximum number of shards.

" - }, - "OpenShardCount":{ - "shape":"ShardCountObject", - "documentation":"

The number of open shards.

" - } - } - }, - "DescribeStreamConsumerInput":{ - "type":"structure", - "members":{ - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The ARN of the Kinesis data stream that the consumer is registered with. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ConsumerName":{ - "shape":"ConsumerName", - "documentation":"

The name that you gave to the consumer.

" - }, - "ConsumerARN":{ - "shape":"ConsumerARN", - "documentation":"

The ARN returned by Kinesis Data Streams when you registered the consumer.

" - } - } - }, - "DescribeStreamConsumerOutput":{ - "type":"structure", - "required":["ConsumerDescription"], - "members":{ - "ConsumerDescription":{ - "shape":"ConsumerDescription", - "documentation":"

An object that represents the details of the consumer.

" - } - } - }, - "DescribeStreamInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to describe.

" - }, - "Limit":{ - "shape":"DescribeStreamInputLimit", - "documentation":"

The maximum number of shards to return in a single call. The default value is 100. If you specify a value greater than 100, at most 100 shards are returned.

" - }, - "ExclusiveStartShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard to start with.

" - } - }, - "documentation":"

Represents the input for DescribeStream.

" - }, - "DescribeStreamInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "DescribeStreamOutput":{ - "type":"structure", - "required":["StreamDescription"], - "members":{ - "StreamDescription":{ - "shape":"StreamDescription", - "documentation":"

The current status of the stream, the stream Amazon Resource Name (ARN), an array of shard objects that comprise the stream, and whether there are more shards available.

" - } - }, - "documentation":"

Represents the output for DescribeStream.

" - }, - "DescribeStreamSummaryInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to describe.

" - } - } - }, - "DescribeStreamSummaryOutput":{ - "type":"structure", - "required":["StreamDescriptionSummary"], - "members":{ - "StreamDescriptionSummary":{ - "shape":"StreamDescriptionSummary", - "documentation":"

A StreamDescriptionSummary containing information about the stream.

" - } - } - }, - "DisableEnhancedMonitoringInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardLevelMetrics" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the Kinesis data stream for which to disable enhanced monitoring.

" - }, - "ShardLevelMetrics":{ - "shape":"MetricsNameList", - "documentation":"

List of shard-level metrics to disable.

The following are the valid shard-level metrics. The value \"ALL\" disables every metric.

  • IncomingBytes

  • IncomingRecords

  • OutgoingBytes

  • OutgoingRecords

  • WriteProvisionedThroughputExceeded

  • ReadProvisionedThroughputExceeded

  • IteratorAgeMilliseconds

  • ALL

For more information, see Monitoring the Amazon Kinesis Data Streams Service with Amazon CloudWatch in the Amazon Kinesis Data Streams Developer Guide.

" - } - }, - "documentation":"

Represents the input for DisableEnhancedMonitoring.

" - }, - "EnableEnhancedMonitoringInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardLevelMetrics" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream for which to enable enhanced monitoring.

" - }, - "ShardLevelMetrics":{ - "shape":"MetricsNameList", - "documentation":"

List of shard-level metrics to enable.

The following are the valid shard-level metrics. The value \"ALL\" enables every metric.

  • IncomingBytes

  • IncomingRecords

  • OutgoingBytes

  • OutgoingRecords

  • WriteProvisionedThroughputExceeded

  • ReadProvisionedThroughputExceeded

  • IteratorAgeMilliseconds

  • ALL

For more information, see Monitoring the Amazon Kinesis Data Streams Service with Amazon CloudWatch in the Amazon Kinesis Data Streams Developer Guide.

" - } - }, - "documentation":"

Represents the input for EnableEnhancedMonitoring.

" - }, - "EncryptionType":{ - "type":"string", - "enum":[ - "NONE", - "KMS" - ] - }, - "EnhancedMetrics":{ - "type":"structure", - "members":{ - "ShardLevelMetrics":{ - "shape":"MetricsNameList", - "documentation":"

List of shard-level metrics.

The following are the valid shard-level metrics. The value \"ALL\" enhances every metric.

  • IncomingBytes

  • IncomingRecords

  • OutgoingBytes

  • OutgoingRecords

  • WriteProvisionedThroughputExceeded

  • ReadProvisionedThroughputExceeded

  • IteratorAgeMilliseconds

  • ALL

For more information, see Monitoring the Amazon Kinesis Data Streams Service with Amazon CloudWatch in the Amazon Kinesis Data Streams Developer Guide.

" - } - }, - "documentation":"

Represents enhanced metrics types.

" - }, - "EnhancedMonitoringList":{ - "type":"list", - "member":{"shape":"EnhancedMetrics"} - }, - "EnhancedMonitoringOutput":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the Kinesis data stream.

" - }, - "CurrentShardLevelMetrics":{ - "shape":"MetricsNameList", - "documentation":"

Represents the current state of the metrics that are in the enhanced state before the operation.

" - }, - "DesiredShardLevelMetrics":{ - "shape":"MetricsNameList", - "documentation":"

Represents the list of all the metrics that would be in the enhanced state after the operation.

" - } - }, - "documentation":"

Represents the output for EnableEnhancedMonitoring and DisableEnhancedMonitoring.

" - }, - "ErrorCode":{"type":"string"}, - "ErrorMessage":{"type":"string"}, - "ExpiredIteratorException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The provided iterator exceeds the maximum age allowed.

", - "exception":true - }, - "ExpiredNextTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The pagination token passed to the operation is expired.

", - "exception":true - }, - "GetRecordsInput":{ - "type":"structure", - "required":["ShardIterator"], - "members":{ - "ShardIterator":{ - "shape":"ShardIterator", - "documentation":"

The position in the shard from which you want to start sequentially reading data records. A shard iterator specifies this position using the sequence number of a data record in the shard.

" - }, - "Limit":{ - "shape":"GetRecordsInputLimit", - "documentation":"

The maximum number of records to return. Specify a value of up to 10,000. If you specify a value that is greater than 10,000, GetRecords throws InvalidArgumentException.

" - } - }, - "documentation":"

Represents the input for GetRecords.

" - }, - "GetRecordsInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "GetRecordsOutput":{ - "type":"structure", - "required":["Records"], - "members":{ - "Records":{ - "shape":"RecordList", - "documentation":"

The data records retrieved from the shard.

" - }, - "NextShardIterator":{ - "shape":"ShardIterator", - "documentation":"

The next position in the shard from which to start sequentially reading data records. If set to null, the shard has been closed and the requested iterator does not return any more data.

" - }, - "MillisBehindLatest":{ - "shape":"MillisBehindLatest", - "documentation":"

The number of milliseconds the GetRecords response is from the tip of the stream, indicating how far behind current time the consumer is. A value of zero indicates that record processing is caught up, and there are no new records to process at this moment.

" - } - }, - "documentation":"

Represents the output for GetRecords.

" - }, - "GetShardIteratorInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardId", - "ShardIteratorType" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the Amazon Kinesis data stream.

" - }, - "ShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the Kinesis Data Streams shard to get the iterator for.

" - }, - "ShardIteratorType":{ - "shape":"ShardIteratorType", - "documentation":"

Determines how the shard iterator is used to start reading data records from the shard.

The following are the valid Amazon Kinesis shard iterator types:

  • AT_SEQUENCE_NUMBER - Start reading from the position denoted by a specific sequence number, provided in the value StartingSequenceNumber.

  • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number, provided in the value StartingSequenceNumber.

  • AT_TIMESTAMP - Start reading from the position denoted by a specific time stamp, provided in the value Timestamp.

  • TRIM_HORIZON - Start reading at the last untrimmed record in the shard in the system, which is the oldest data record in the shard.

  • LATEST - Start reading just after the most recent record in the shard, so that you always read the most recent data in the shard.

" - }, - "StartingSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The sequence number of the data record in the shard from which to start reading. Used with shard iterator type AT_SEQUENCE_NUMBER and AFTER_SEQUENCE_NUMBER.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time stamp of the data record from which to start reading. Used with shard iterator type AT_TIMESTAMP. A time stamp is the Unix epoch date with precision in milliseconds. For example, 2016-04-04T19:58:46.480-00:00 or 1459799926.480. If a record with this exact time stamp does not exist, the iterator returned is for the next (later) record. If the time stamp is older than the current trim horizon, the iterator returned is for the oldest untrimmed data record (TRIM_HORIZON).

" - } - }, - "documentation":"

Represents the input for GetShardIterator.

" - }, - "GetShardIteratorOutput":{ - "type":"structure", - "members":{ - "ShardIterator":{ - "shape":"ShardIterator", - "documentation":"

The position in the shard from which to start reading data records sequentially. A shard iterator specifies this position using the sequence number of a data record in a shard.

" - } - }, - "documentation":"

Represents the output for GetShardIterator.

" - }, - "HashKey":{ - "type":"string", - "pattern":"0|([1-9]\\d{0,38})" - }, - "HashKeyRange":{ - "type":"structure", - "required":[ - "StartingHashKey", - "EndingHashKey" - ], - "members":{ - "StartingHashKey":{ - "shape":"HashKey", - "documentation":"

The starting hash key of the hash key range.

" - }, - "EndingHashKey":{ - "shape":"HashKey", - "documentation":"

The ending hash key of the hash key range.

" - } - }, - "documentation":"

The range of possible hash key values for the shard, which is a set of ordered contiguous positive integers.

" - }, - "IncreaseStreamRetentionPeriodInput":{ - "type":"structure", - "required":[ - "StreamName", - "RetentionPeriodHours" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to modify.

" - }, - "RetentionPeriodHours":{ - "shape":"RetentionPeriodHours", - "documentation":"

The new retention period of the stream, in hours. Must be more than the current retention period.

" - } - }, - "documentation":"

Represents the input for IncreaseStreamRetentionPeriod.

" - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true, - "fault":true - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

A specified parameter exceeds its restrictions, is not supported, or can't be used. For more information, see the returned message.

", - "exception":true - }, - "KMSAccessDeniedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The ciphertext references a key that doesn't exist or that you don't have access to.

", - "exception":true - }, - "KMSDisabledException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The request was rejected because the specified customer master key (CMK) isn't enabled.

", - "exception":true - }, - "KMSInvalidStateException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The request was rejected because the state of the specified resource isn't valid for this request. For more information, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

", - "exception":true - }, - "KMSNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The request was rejected because the specified entity or resource can't be found.

", - "exception":true - }, - "KMSOptInRequired":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The AWS access key ID needs a subscription for the service.

", - "exception":true - }, - "KMSThrottlingException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The request was denied due to request throttling. For more information about throttling, see Limits in the AWS Key Management Service Developer Guide.

", - "exception":true - }, - "KeyId":{ - "type":"string", - "max":2048, - "min":1 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.

", - "exception":true - }, - "ListShardsInput":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the data stream whose shards you want to list.

You cannot specify this parameter if you specify the NextToken parameter.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the number of shards in the data stream is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of shards in the data stream, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListShards to list the next set of shards.

Don't specify StreamName or StreamCreationTimestamp if you specify NextToken because the latter unambiguously identifies the stream.

You can optionally specify a value for the MaxResults parameter when you specify NextToken. If you specify a MaxResults value that is less than the number of shards that the operation returns if you don't specify MaxResults, the response will contain a new NextToken value. You can use the new NextToken value in a subsequent call to the ListShards operation.

Tokens expire after 300 seconds. When you obtain a value for NextToken in the response to a call to ListShards, you have 300 seconds to use that value. If you specify an expired token in a call to ListShards, you get ExpiredNextTokenException.

" - }, - "ExclusiveStartShardId":{ - "shape":"ShardId", - "documentation":"

Specify this parameter to indicate that you want to list the shards starting with the shard whose ID immediately follows ExclusiveStartShardId.

If you don't specify this parameter, the default behavior is for ListShards to list the shards starting with the first one in the stream.

You cannot specify this parameter if you specify NextToken.

" - }, - "MaxResults":{ - "shape":"ListShardsInputLimit", - "documentation":"

The maximum number of shards to return in a single call to ListShards. The minimum value you can specify for this parameter is 1, and the maximum is 1,000, which is also the default.

When the number of shards to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListShards to list the next set of shards.

" - }, - "StreamCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

Specify this input parameter to distinguish data streams that have the same name. For example, if you create a data stream and then delete it, and you later create another data stream with the same name, you can use this input parameter to specify which of the two streams you want to list the shards for.

You cannot specify this parameter if you specify the NextToken parameter.

" - } - } - }, - "ListShardsInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ListShardsOutput":{ - "type":"structure", - "members":{ - "Shards":{ - "shape":"ShardList", - "documentation":"

An array of JSON objects. Each object represents one shard and specifies the IDs of the shard, the shard's parent, and the shard that's adjacent to the shard's parent. Each object also contains the starting and ending hash keys and the starting and ending sequence numbers for the shard.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the number of shards in the data stream is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of shards in the data stream, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListShards to list the next set of shards. For more information about the use of this pagination token when calling the ListShards operation, see ListShardsInput$NextToken.

Tokens expire after 300 seconds. When you obtain a value for NextToken in the response to a call to ListShards, you have 300 seconds to use that value. If you specify an expired token in a call to ListShards, you get ExpiredNextTokenException.

" - } - } - }, - "ListStreamConsumersInput":{ - "type":"structure", - "required":["StreamARN"], - "members":{ - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The ARN of the Kinesis data stream for which you want to list the registered consumers. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the number of consumers that are registered with the data stream is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of consumers that are registered with the data stream, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListStreamConsumers to list the next set of registered consumers.

Don't specify StreamName or StreamCreationTimestamp if you specify NextToken because the latter unambiguously identifies the stream.

You can optionally specify a value for the MaxResults parameter when you specify NextToken. If you specify a MaxResults value that is less than the number of consumers that the operation returns if you don't specify MaxResults, the response will contain a new NextToken value. You can use the new NextToken value in a subsequent call to the ListStreamConsumers operation to list the next set of consumers.

Tokens expire after 300 seconds. When you obtain a value for NextToken in the response to a call to ListStreamConsumers, you have 300 seconds to use that value. If you specify an expired token in a call to ListStreamConsumers, you get ExpiredNextTokenException.

" - }, - "MaxResults":{ - "shape":"ListStreamConsumersInputLimit", - "documentation":"

The maximum number of consumers that you want a single call of ListStreamConsumers to return.

" - }, - "StreamCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

Specify this input parameter to distinguish data streams that have the same name. For example, if you create a data stream and then delete it, and you later create another data stream with the same name, you can use this input parameter to specify which of the two streams you want to list the consumers for.

You can't specify this parameter if you specify the NextToken parameter.

" - } - } - }, - "ListStreamConsumersInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ListStreamConsumersOutput":{ - "type":"structure", - "members":{ - "Consumers":{ - "shape":"ConsumerList", - "documentation":"

An array of JSON objects. Each object represents one registered consumer.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

When the number of consumers that are registered with the data stream is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of registered consumers, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListStreamConsumers to list the next set of registered consumers. For more information about the use of this pagination token when calling the ListStreamConsumers operation, see ListStreamConsumersInput$NextToken.

Tokens expire after 300 seconds. When you obtain a value for NextToken in the response to a call to ListStreamConsumers, you have 300 seconds to use that value. If you specify an expired token in a call to ListStreamConsumers, you get ExpiredNextTokenException.

" - } - } - }, - "ListStreamsInput":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"ListStreamsInputLimit", - "documentation":"

The maximum number of streams to list.

" - }, - "ExclusiveStartStreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to start the list with.

" - } - }, - "documentation":"

Represents the input for ListStreams.

" - }, - "ListStreamsInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ListStreamsOutput":{ - "type":"structure", - "required":[ - "StreamNames", - "HasMoreStreams" - ], - "members":{ - "StreamNames":{ - "shape":"StreamNameList", - "documentation":"

The names of the streams that are associated with the AWS account making the ListStreams request.

" - }, - "HasMoreStreams":{ - "shape":"BooleanObject", - "documentation":"

If set to true, there are more streams available to list.

" - } - }, - "documentation":"

Represents the output for ListStreams.

" - }, - "ListTagsForStreamInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "ExclusiveStartTagKey":{ - "shape":"TagKey", - "documentation":"

The key to use as the starting point for the list of tags. If this parameter is set, ListTagsForStream gets all tags that occur after ExclusiveStartTagKey.

" - }, - "Limit":{ - "shape":"ListTagsForStreamInputLimit", - "documentation":"

The number of tags to return. If this number is less than the total number of tags associated with the stream, HasMoreTags is set to true. To list additional tags, set ExclusiveStartTagKey to the last key in the response.

" - } - }, - "documentation":"

Represents the input for ListTagsForStream.

" - }, - "ListTagsForStreamInputLimit":{ - "type":"integer", - "max":50, - "min":1 - }, - "ListTagsForStreamOutput":{ - "type":"structure", - "required":[ - "Tags", - "HasMoreTags" - ], - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags associated with StreamName, starting with the first tag after ExclusiveStartTagKey and up to the specified Limit.

" - }, - "HasMoreTags":{ - "shape":"BooleanObject", - "documentation":"

If set to true, more tags are available. To request additional tags, set ExclusiveStartTagKey to the key of the last tag returned.

" - } - }, - "documentation":"

Represents the output for ListTagsForStream.

" - }, - "MergeShardsInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardToMerge", - "AdjacentShardToMerge" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream for the merge.

" - }, - "ShardToMerge":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard to combine with the adjacent shard for the merge.

" - }, - "AdjacentShardToMerge":{ - "shape":"ShardId", - "documentation":"

The shard ID of the adjacent shard for the merge.

" - } - }, - "documentation":"

Represents the input for MergeShards.

" - }, - "MetricsName":{ - "type":"string", - "enum":[ - "IncomingBytes", - "IncomingRecords", - "OutgoingBytes", - "OutgoingRecords", - "WriteProvisionedThroughputExceeded", - "ReadProvisionedThroughputExceeded", - "IteratorAgeMilliseconds", - "ALL" - ] - }, - "MetricsNameList":{ - "type":"list", - "member":{"shape":"MetricsName"}, - "max":7, - "min":1 - }, - "MillisBehindLatest":{ - "type":"long", - "min":0 - }, - "NextToken":{ - "type":"string", - "max":1048576, - "min":1 - }, - "PartitionKey":{ - "type":"string", - "max":256, - "min":1 - }, - "PositiveIntegerObject":{ - "type":"integer", - "max":100000, - "min":1 - }, - "ProvisionedThroughputExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The request rate for the stream is too high, or the requested data is too large for the available throughput. Reduce the frequency or size of your requests. For more information, see Streams Limits in the Amazon Kinesis Data Streams Developer Guide, and Error Retries and Exponential Backoff in AWS in the AWS General Reference.

", - "exception":true - }, - "PutRecordInput":{ - "type":"structure", - "required":[ - "StreamName", - "Data", - "PartitionKey" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream to put the data record into.

" - }, - "Data":{ - "shape":"Data", - "documentation":"

The data blob to put into the record, which is base64-encoded when the blob is serialized. When the data blob (the payload before base64-encoding) is added to the partition key size, the total size must not exceed the maximum record size (1 MB).

" - }, - "PartitionKey":{ - "shape":"PartitionKey", - "documentation":"

Determines which shard in the stream the data record is assigned to. Partition keys are Unicode strings with a maximum length limit of 256 characters for each key. Amazon Kinesis Data Streams uses the partition key as input to a hash function that maps the partition key and associated data to a specific shard. Specifically, an MD5 hash function is used to map partition keys to 128-bit integer values and to map associated data records to shards. As a result of this hashing mechanism, all data records with the same partition key map to the same shard within the stream.

" - }, - "ExplicitHashKey":{ - "shape":"HashKey", - "documentation":"

The hash value used to explicitly determine the shard the data record is assigned to by overriding the partition key hash.

" - }, - "SequenceNumberForOrdering":{ - "shape":"SequenceNumber", - "documentation":"

Guarantees strictly increasing sequence numbers, for puts from the same client and to the same partition key. Usage: set the SequenceNumberForOrdering of record n to the sequence number of record n-1 (as returned in the result when putting record n-1). If this parameter is not set, records are coarsely ordered based on arrival time.

" - } - }, - "documentation":"

Represents the input for PutRecord.

" - }, - "PutRecordOutput":{ - "type":"structure", - "required":[ - "ShardId", - "SequenceNumber" - ], - "members":{ - "ShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard where the data record was placed.

" - }, - "SequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The sequence number identifier that was assigned to the put data record. The sequence number for the record is unique across all records in the stream. A sequence number is the identifier associated with every record put into the stream.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type to use on the record. This parameter can be one of the following values:

  • NONE: Do not encrypt the records in the stream.

  • KMS: Use server-side encryption on the records in the stream using a customer-managed AWS KMS key.

" - } - }, - "documentation":"

Represents the output for PutRecord.

" - }, - "PutRecordsInput":{ - "type":"structure", - "required":[ - "Records", - "StreamName" - ], - "members":{ - "Records":{ - "shape":"PutRecordsRequestEntryList", - "documentation":"

The records associated with the request.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

The stream name associated with the request.

" - } - }, - "documentation":"

A PutRecords request.

" - }, - "PutRecordsOutput":{ - "type":"structure", - "required":["Records"], - "members":{ - "FailedRecordCount":{ - "shape":"PositiveIntegerObject", - "documentation":"

The number of unsuccessfully processed records in a PutRecords request.

" - }, - "Records":{ - "shape":"PutRecordsResultEntryList", - "documentation":"

An array of successfully and unsuccessfully processed record results, correlated with the request by natural ordering. A record that is successfully added to a stream includes SequenceNumber and ShardId in the result. A record that fails to be added to a stream includes ErrorCode and ErrorMessage in the result.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type used on the records. This parameter can be one of the following values:

  • NONE: Do not encrypt the records.

  • KMS: Use server-side encryption on the records using a customer-managed AWS KMS key.

" - } - }, - "documentation":"

PutRecords results.

" - }, - "PutRecordsRequestEntry":{ - "type":"structure", - "required":[ - "Data", - "PartitionKey" - ], - "members":{ - "Data":{ - "shape":"Data", - "documentation":"

The data blob to put into the record, which is base64-encoded when the blob is serialized. When the data blob (the payload before base64-encoding) is added to the partition key size, the total size must not exceed the maximum record size (1 MB).

" - }, - "ExplicitHashKey":{ - "shape":"HashKey", - "documentation":"

The hash value used to determine explicitly the shard that the data record is assigned to by overriding the partition key hash.

" - }, - "PartitionKey":{ - "shape":"PartitionKey", - "documentation":"

Determines which shard in the stream the data record is assigned to. Partition keys are Unicode strings with a maximum length limit of 256 characters for each key. Amazon Kinesis Data Streams uses the partition key as input to a hash function that maps the partition key and associated data to a specific shard. Specifically, an MD5 hash function is used to map partition keys to 128-bit integer values and to map associated data records to shards. As a result of this hashing mechanism, all data records with the same partition key map to the same shard within the stream.

" - } - }, - "documentation":"

Represents the output for PutRecords.

" - }, - "PutRecordsRequestEntryList":{ - "type":"list", - "member":{"shape":"PutRecordsRequestEntry"}, - "max":500, - "min":1 - }, - "PutRecordsResultEntry":{ - "type":"structure", - "members":{ - "SequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The sequence number for an individual record result.

" - }, - "ShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID for an individual record result.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The error code for an individual record result. ErrorCodes can be either ProvisionedThroughputExceededException or InternalFailure.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The error message for an individual record result. An ErrorCode value of ProvisionedThroughputExceededException has an error message that includes the account ID, stream name, and shard ID. An ErrorCode value of InternalFailure has the error message \"Internal Service Failure\".

" - } - }, - "documentation":"

Represents the result of an individual record from a PutRecords request. A record that is successfully added to a stream includes SequenceNumber and ShardId in the result. A record that fails to be added to the stream includes ErrorCode and ErrorMessage in the result.

" - }, - "PutRecordsResultEntryList":{ - "type":"list", - "member":{"shape":"PutRecordsResultEntry"}, - "max":500, - "min":1 - }, - "Record":{ - "type":"structure", - "required":[ - "SequenceNumber", - "Data", - "PartitionKey" - ], - "members":{ - "SequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The unique identifier of the record within its shard.

" - }, - "ApproximateArrivalTimestamp":{ - "shape":"Timestamp", - "documentation":"

The approximate time that the record was inserted into the stream.

" - }, - "Data":{ - "shape":"Data", - "documentation":"

The data blob. The data in the blob is both opaque and immutable to Kinesis Data Streams, which does not inspect, interpret, or change the data in the blob in any way. When the data blob (the payload before base64-encoding) is added to the partition key size, the total size must not exceed the maximum record size (1 MB).

" - }, - "PartitionKey":{ - "shape":"PartitionKey", - "documentation":"

Identifies which shard in the stream the data record is assigned to.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type used on the record. This parameter can be one of the following values:

  • NONE: Do not encrypt the records in the stream.

  • KMS: Use server-side encryption on the records in the stream using a customer-managed AWS KMS key.

" - } - }, - "documentation":"

The unit of data of the Kinesis data stream, which is composed of a sequence number, a partition key, and a data blob.

" - }, - "RecordList":{ - "type":"list", - "member":{"shape":"Record"} - }, - "RegisterStreamConsumerInput":{ - "type":"structure", - "required":[ - "StreamARN", - "ConsumerName" - ], - "members":{ - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The ARN of the Kinesis data stream that you want to register the consumer with. For more info, see Amazon Resource Names (ARNs) and AWS Service Namespaces.

" - }, - "ConsumerName":{ - "shape":"ConsumerName", - "documentation":"

For a given Kinesis data stream, each consumer must have a unique name. However, consumer names don't have to be unique across data streams.

" - } - } - }, - "RegisterStreamConsumerOutput":{ - "type":"structure", - "required":["Consumer"], - "members":{ - "Consumer":{ - "shape":"Consumer", - "documentation":"

An object that represents the details of the consumer you registered. When you register a consumer, it gets an ARN that is generated by Kinesis Data Streams.

" - } - } - }, - "RemoveTagsFromStreamInput":{ - "type":"structure", - "required":[ - "StreamName", - "TagKeys" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys. Each corresponding tag is removed from the stream.

" - } - }, - "documentation":"

Represents the input for RemoveTagsFromStream.

" - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The resource is not available for this operation. For successful operation, the resource must be in the ACTIVE state.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A message that provides information about the error.

" - } - }, - "documentation":"

The requested resource could not be found. The stream might not be specified correctly.

", - "exception":true - }, - "RetentionPeriodHours":{ - "type":"integer", - "max":168, - "min":1 - }, - "ScalingType":{ - "type":"string", - "enum":["UNIFORM_SCALING"] - }, - "SequenceNumber":{ - "type":"string", - "pattern":"0|([1-9]\\d{0,128})" - }, - "SequenceNumberRange":{ - "type":"structure", - "required":["StartingSequenceNumber"], - "members":{ - "StartingSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The starting sequence number for the range.

" - }, - "EndingSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

The ending sequence number for the range. Shards that are in the OPEN state have an ending sequence number of null.

" - } - }, - "documentation":"

The range of possible sequence numbers for the shard.

" - }, - "Shard":{ - "type":"structure", - "required":[ - "ShardId", - "HashKeyRange", - "SequenceNumberRange" - ], - "members":{ - "ShardId":{ - "shape":"ShardId", - "documentation":"

The unique identifier of the shard within the stream.

" - }, - "ParentShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard's parent.

" - }, - "AdjacentParentShardId":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard adjacent to the shard's parent.

" - }, - "HashKeyRange":{ - "shape":"HashKeyRange", - "documentation":"

The range of possible hash key values for the shard, which is a set of ordered contiguous positive integers.

" - }, - "SequenceNumberRange":{ - "shape":"SequenceNumberRange", - "documentation":"

The range of possible sequence numbers for the shard.

" - } - }, - "documentation":"

A uniquely identified group of data records in a Kinesis data stream.

" - }, - "ShardCountObject":{ - "type":"integer", - "max":1000000, - "min":0 - }, - "ShardId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "ShardIterator":{ - "type":"string", - "max":512, - "min":1 - }, - "ShardIteratorType":{ - "type":"string", - "enum":[ - "AT_SEQUENCE_NUMBER", - "AFTER_SEQUENCE_NUMBER", - "TRIM_HORIZON", - "LATEST", - "AT_TIMESTAMP" - ] - }, - "ShardList":{ - "type":"list", - "member":{"shape":"Shard"} - }, - "SplitShardInput":{ - "type":"structure", - "required":[ - "StreamName", - "ShardToSplit", - "NewStartingHashKey" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream for the shard split.

" - }, - "ShardToSplit":{ - "shape":"ShardId", - "documentation":"

The shard ID of the shard to split.

" - }, - "NewStartingHashKey":{ - "shape":"HashKey", - "documentation":"

A hash key value for the starting hash key of one of the child shards created by the split. The hash key range for a given shard constitutes a set of ordered contiguous positive integers. The value for NewStartingHashKey must be in the range of hash keys being mapped into the shard. The NewStartingHashKey hash key value and all higher hash key values in hash key range are distributed to one of the child shards. All the lower hash key values in the range are distributed to the other child shard.

" - } - }, - "documentation":"

Represents the input for SplitShard.

" - }, - "StartStreamEncryptionInput":{ - "type":"structure", - "required":[ - "StreamName", - "EncryptionType", - "KeyId" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream for which to start encrypting records.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type to use. The only valid value is KMS.

" - }, - "KeyId":{ - "shape":"KeyId", - "documentation":"

The GUID for the customer-managed AWS KMS key to use for encryption. This value can be a globally unique identifier, a fully specified Amazon Resource Name (ARN) to either an alias or a key, or an alias name prefixed by \"alias/\".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.

  • Key ARN example: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • Alias ARN example: arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • Globally unique key ID example: 12345678-1234-1234-1234-123456789012

  • Alias name example: alias/MyAliasName

  • Master key owned by Kinesis Data Streams: alias/aws/kinesis

" - } - } - }, - "StartingPosition":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{"shape":"ShardIteratorType"}, - "SequenceNumber":{"shape":"SequenceNumber"}, - "Timestamp":{"shape":"Timestamp"} - } - }, - "StopStreamEncryptionInput":{ - "type":"structure", - "required":[ - "StreamName", - "EncryptionType", - "KeyId" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream on which to stop encrypting records.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type. The only valid value is KMS.

" - }, - "KeyId":{ - "shape":"KeyId", - "documentation":"

The GUID for the customer-managed AWS KMS key to use for encryption. This value can be a globally unique identifier, a fully specified Amazon Resource Name (ARN) to either an alias or a key, or an alias name prefixed by \"alias/\".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.

  • Key ARN example: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • Alias ARN example: arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • Globally unique key ID example: 12345678-1234-1234-1234-123456789012

  • Alias name example: alias/MyAliasName

  • Master key owned by Kinesis Data Streams: alias/aws/kinesis

" - } - } - }, - "StreamARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:aws.*:kinesis:.*:\\d{12}:stream/.*" - }, - "StreamDescription":{ - "type":"structure", - "required":[ - "StreamName", - "StreamARN", - "StreamStatus", - "Shards", - "HasMoreShards", - "RetentionPeriodHours", - "StreamCreationTimestamp", - "EnhancedMonitoring" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream being described.

" - }, - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The Amazon Resource Name (ARN) for the stream being described.

" - }, - "StreamStatus":{ - "shape":"StreamStatus", - "documentation":"

The current status of the stream being described. The stream status is one of the following states:

  • CREATING - The stream is being created. Kinesis Data Streams immediately returns and sets StreamStatus to CREATING.

  • DELETING - The stream is being deleted. The specified stream is in the DELETING state until Kinesis Data Streams completes the deletion.

  • ACTIVE - The stream exists and is ready for read and write operations or deletion. You should perform read and write operations only on an ACTIVE stream.

  • UPDATING - Shards in the stream are being merged or split. Read and write operations continue to work while the stream is in the UPDATING state.

" - }, - "Shards":{ - "shape":"ShardList", - "documentation":"

The shards that comprise the stream.

" - }, - "HasMoreShards":{ - "shape":"BooleanObject", - "documentation":"

If set to true, more shards in the stream are available to describe.

" - }, - "RetentionPeriodHours":{ - "shape":"RetentionPeriodHours", - "documentation":"

The current retention period, in hours.

" - }, - "StreamCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

The approximate time that the stream was created.

" - }, - "EnhancedMonitoring":{ - "shape":"EnhancedMonitoringList", - "documentation":"

Represents the current enhanced monitoring settings of the stream.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The server-side encryption type used on the stream. This parameter can be one of the following values:

  • NONE: Do not encrypt the records in the stream.

  • KMS: Use server-side encryption on the records in the stream using a customer-managed AWS KMS key.

" - }, - "KeyId":{ - "shape":"KeyId", - "documentation":"

The GUID for the customer-managed AWS KMS key to use for encryption. This value can be a globally unique identifier, a fully specified ARN to either an alias or a key, or an alias name prefixed by \"alias/\".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.

  • Key ARN example: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • Alias ARN example: arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • Globally unique key ID example: 12345678-1234-1234-1234-123456789012

  • Alias name example: alias/MyAliasName

  • Master key owned by Kinesis Data Streams: alias/aws/kinesis

" - } - }, - "documentation":"

Represents the output for DescribeStream.

" - }, - "StreamDescriptionSummary":{ - "type":"structure", - "required":[ - "StreamName", - "StreamARN", - "StreamStatus", - "RetentionPeriodHours", - "StreamCreationTimestamp", - "EnhancedMonitoring", - "OpenShardCount" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream being described.

" - }, - "StreamARN":{ - "shape":"StreamARN", - "documentation":"

The Amazon Resource Name (ARN) for the stream being described.

" - }, - "StreamStatus":{ - "shape":"StreamStatus", - "documentation":"

The current status of the stream being described. The stream status is one of the following states:

  • CREATING - The stream is being created. Kinesis Data Streams immediately returns and sets StreamStatus to CREATING.

  • DELETING - The stream is being deleted. The specified stream is in the DELETING state until Kinesis Data Streams completes the deletion.

  • ACTIVE - The stream exists and is ready for read and write operations or deletion. You should perform read and write operations only on an ACTIVE stream.

  • UPDATING - Shards in the stream are being merged or split. Read and write operations continue to work while the stream is in the UPDATING state.

" - }, - "RetentionPeriodHours":{ - "shape":"PositiveIntegerObject", - "documentation":"

The current retention period, in hours.

" - }, - "StreamCreationTimestamp":{ - "shape":"Timestamp", - "documentation":"

The approximate time that the stream was created.

" - }, - "EnhancedMonitoring":{ - "shape":"EnhancedMonitoringList", - "documentation":"

Represents the current enhanced monitoring settings of the stream.

" - }, - "EncryptionType":{ - "shape":"EncryptionType", - "documentation":"

The encryption type used. This value is one of the following:

  • KMS

  • NONE

" - }, - "KeyId":{ - "shape":"KeyId", - "documentation":"

The GUID for the customer-managed AWS KMS key to use for encryption. This value can be a globally unique identifier, a fully specified ARN to either an alias or a key, or an alias name prefixed by \"alias/\".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.

  • Key ARN example: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

  • Alias ARN example: arn:aws:kms:us-east-1:123456789012:alias/MyAliasName

  • Globally unique key ID example: 12345678-1234-1234-1234-123456789012

  • Alias name example: alias/MyAliasName

  • Master key owned by Kinesis Data Streams: alias/aws/kinesis

" - }, - "OpenShardCount":{ - "shape":"ShardCountObject", - "documentation":"

The number of open shards in the stream.

" - }, - "ConsumerCount":{ - "shape":"ConsumerCountObject", - "documentation":"

The number of enhanced fan-out consumers registered with the stream.

" - } - }, - "documentation":"

Represents the output for DescribeStreamSummary

" - }, - "StreamName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "StreamNameList":{ - "type":"list", - "member":{"shape":"StreamName"} - }, - "StreamStatus":{ - "type":"string", - "enum":[ - "CREATING", - "DELETING", - "ACTIVE", - "UPDATING" - ] - }, - "SubscribeToShardEvent":{ - "type":"structure", - "required":[ - "Records", - "ContinuationSequenceNumber", - "MillisBehindLatest" - ], - "members":{ - "Records":{ - "shape":"RecordList", - "documentation":"

" - }, - "ContinuationSequenceNumber":{ - "shape":"SequenceNumber", - "documentation":"

Use this as StartingSequenceNumber in the next call to SubscribeToShard.

" - }, - "MillisBehindLatest":{ - "shape":"MillisBehindLatest", - "documentation":"

The number of milliseconds the read records are from the tip of the stream, indicating how far behind current time the consumer is. A value of zero indicates that record processing is caught up, and there are no new records to process at this moment.

" - } - }, - "documentation":"

After you call SubscribeToShard, Kinesis Data Streams sends events of this type to your consumer.

", - "event":true - }, - "SubscribeToShardEventStream":{ - "type":"structure", - "required":["SubscribeToShardEvent"], - "members":{ - "SubscribeToShardEvent":{"shape":"SubscribeToShardEvent"}, - "ResourceNotFoundException":{"shape":"ResourceNotFoundException"}, - "ResourceInUseException":{"shape":"ResourceInUseException"}, - "KMSDisabledException":{"shape":"KMSDisabledException"}, - "KMSInvalidStateException":{"shape":"KMSInvalidStateException"}, - "KMSAccessDeniedException":{"shape":"KMSAccessDeniedException"}, - "KMSNotFoundException":{"shape":"KMSNotFoundException"}, - "KMSOptInRequired":{"shape":"KMSOptInRequired"}, - "KMSThrottlingException":{"shape":"KMSThrottlingException"}, - "InternalFailureException":{"shape":"InternalFailureException"} - }, - "eventstream":true - }, - "SubscribeToShardInput":{ - "type":"structure", - "required":[ - "ConsumerARN", - "ShardId", - "StartingPosition" - ], - "members":{ - "ConsumerARN":{ - "shape":"ConsumerARN", - "documentation":"

For this parameter, use the value you obtained when you called RegisterStreamConsumer.

" - }, - "ShardId":{ - "shape":"ShardId", - "documentation":"

The ID of the shard you want to subscribe to. To see a list of all the shards for a given stream, use ListShards.

" - }, - "StartingPosition":{"shape":"StartingPosition"} - } - }, - "SubscribeToShardOutput":{ - "type":"structure", - "required":["EventStream"], - "members":{ - "EventStream":{ - "shape":"SubscribeToShardEventStream", - "documentation":"

The event stream that your consumer can use to read records from the shard.

" - } - } - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A unique identifier for the tag. Maximum length: 128 characters. Valid characters: Unicode letters, digits, white space, _ . / = + - % @

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

An optional string, typically used to describe or define the tag. Maximum length: 256 characters. Valid characters: Unicode letters, digits, white space, _ . / = + - % @

" - } - }, - "documentation":"

Metadata assigned to the stream, consisting of a key-value pair.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "min":0 - }, - "TagMap":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"}, - "max":50, - "min":1 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0 - }, - "Timestamp":{"type":"timestamp"}, - "UpdateShardCountInput":{ - "type":"structure", - "required":[ - "StreamName", - "TargetShardCount", - "ScalingType" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "TargetShardCount":{ - "shape":"PositiveIntegerObject", - "documentation":"

The new number of shards.

" - }, - "ScalingType":{ - "shape":"ScalingType", - "documentation":"

The scaling type. Uniform scaling creates shards of equal size.

" - } - } - }, - "UpdateShardCountOutput":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "CurrentShardCount":{ - "shape":"PositiveIntegerObject", - "documentation":"

The current number of shards.

" - }, - "TargetShardCount":{ - "shape":"PositiveIntegerObject", - "documentation":"

The updated number of shards.

" - } - } - } - }, - "documentation":"Amazon Kinesis Data Streams Service API Reference

Amazon Kinesis Data Streams is a managed service that scales elastically for real-time processing of streaming big data.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/waiters-2.json deleted file mode 100644 index d61efe43..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesis/2013-12-02/waiters-2.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "version": 2, - "waiters": { - "StreamExists": { - "delay": 10, - "operation": "DescribeStream", - "maxAttempts": 18, - "acceptors": [ - { - "expected": "ACTIVE", - "matcher": "path", - "state": "success", - "argument": "StreamDescription.StreamStatus" - } - ] - }, - "StreamNotExists": { - "delay": 10, - "operation": "DescribeStream", - "maxAttempts": 18, - "acceptors": [ - { - "expected": "ResourceNotFoundException", - "matcher": "error", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/service-2.json deleted file mode 100644 index b0cec25b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisanalytics/2015-08-14/service-2.json +++ /dev/null @@ -1,2105 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-08-14", - "endpointPrefix":"kinesisanalytics", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Kinesis Analytics", - "serviceFullName":"Amazon Kinesis Analytics", - "serviceId":"Kinesis Analytics", - "signatureVersion":"v4", - "targetPrefix":"KinesisAnalytics_20150814", - "timestampFormat":"unixTimestamp", - "uid":"kinesisanalytics-2015-08-14" - }, - "operations":{ - "AddApplicationCloudWatchLoggingOption":{ - "name":"AddApplicationCloudWatchLoggingOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddApplicationCloudWatchLoggingOptionRequest"}, - "output":{"shape":"AddApplicationCloudWatchLoggingOptionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds a CloudWatch log stream to monitor application configuration errors. For more information about using CloudWatch log streams with Amazon Kinesis Analytics applications, see Working with Amazon CloudWatch Logs.

" - }, - "AddApplicationInput":{ - "name":"AddApplicationInput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddApplicationInputRequest"}, - "output":{"shape":"AddApplicationInputResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"CodeValidationException"} - ], - "documentation":"

Adds a streaming source to your Amazon Kinesis application. For conceptual information, see Configuring Application Input.

You can add a streaming source either when you create an application or you can use this operation to add a streaming source after you create an application. For more information, see CreateApplication.

Any configuration update, including adding a streaming source using this operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application version.

This operation requires permissions to perform the kinesisanalytics:AddApplicationInput action.

" - }, - "AddApplicationInputProcessingConfiguration":{ - "name":"AddApplicationInputProcessingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddApplicationInputProcessingConfigurationRequest"}, - "output":{"shape":"AddApplicationInputProcessingConfigurationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds an InputProcessingConfiguration to an application. An input processor preprocesses records on the input stream before the application's SQL code executes. Currently, the only input processor available is AWS Lambda.

" - }, - "AddApplicationOutput":{ - "name":"AddApplicationOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddApplicationOutputRequest"}, - "output":{"shape":"AddApplicationOutputResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds an external destination to your Amazon Kinesis Analytics application.

If you want Amazon Kinesis Analytics to deliver data from an in-application stream within your application to an external destination (such as an Amazon Kinesis stream, an Amazon Kinesis Firehose delivery stream, or an Amazon Lambda function), you add the relevant configuration to your application using this operation. You can configure one or more outputs for your application. Each output configuration maps an in-application stream and an external destination.

You can use one of the output configurations to deliver data from your in-application error stream to an external destination so that you can analyze the errors. For conceptual information, see Understanding Application Output (Destination).

Note that any configuration update, including adding a streaming source using this operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application version.

For the limits on the number of application inputs and outputs you can configure, see Limits.

This operation requires permissions to perform the kinesisanalytics:AddApplicationOutput action.

" - }, - "AddApplicationReferenceDataSource":{ - "name":"AddApplicationReferenceDataSource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddApplicationReferenceDataSourceRequest"}, - "output":{"shape":"AddApplicationReferenceDataSourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Adds a reference data source to an existing application.

Amazon Kinesis Analytics reads reference data (that is, an Amazon S3 object) and creates an in-application table within your application. In the request, you provide the source (S3 bucket name and object key name), name of the in-application table to create, and the necessary mapping information that describes how data in Amazon S3 object maps to columns in the resulting in-application table.

For conceptual information, see Configuring Application Input. For the limits on data sources you can add to your application, see Limits.

This operation requires permissions to perform the kinesisanalytics:AddApplicationOutput action.

" - }, - "CreateApplication":{ - "name":"CreateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateApplicationRequest"}, - "output":{"shape":"CreateApplicationResponse"}, - "errors":[ - {"shape":"CodeValidationException"}, - {"shape":"ResourceInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Creates an Amazon Kinesis Analytics application. You can configure each application with one streaming source as input, application code to process the input, and up to three destinations where you want Amazon Kinesis Analytics to write the output data from your application. For an overview, see How it Works.

In the input configuration, you map the streaming source to an in-application stream, which you can think of as a constantly updating table. In the mapping, you must provide a schema for the in-application stream and map each data column in the in-application stream to a data element in the streaming source.

Your application code is one or more SQL statements that read input data, transform it, and generate output. Your application code can create one or more SQL artifacts like SQL streams or pumps.

In the output configuration, you can configure the application to write data from in-application streams created in your applications to up to three destinations.

To read data from your source stream or write data to destination streams, Amazon Kinesis Analytics needs your permissions. You grant these permissions by creating IAM roles. This operation requires permissions to perform the kinesisanalytics:CreateApplication action.

For introductory exercises to create an Amazon Kinesis Analytics application, see Getting Started.

" - }, - "DeleteApplication":{ - "name":"DeleteApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationRequest"}, - "output":{"shape":"DeleteApplicationResponse"}, - "errors":[ - {"shape":"ConcurrentModificationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes the specified application. Amazon Kinesis Analytics halts application execution and deletes the application, including any application artifacts (such as in-application streams, reference table, and application code).

This operation requires permissions to perform the kinesisanalytics:DeleteApplication action.

" - }, - "DeleteApplicationCloudWatchLoggingOption":{ - "name":"DeleteApplicationCloudWatchLoggingOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationCloudWatchLoggingOptionRequest"}, - "output":{"shape":"DeleteApplicationCloudWatchLoggingOptionResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes a CloudWatch log stream from an application. For more information about using CloudWatch log streams with Amazon Kinesis Analytics applications, see Working with Amazon CloudWatch Logs.

" - }, - "DeleteApplicationInputProcessingConfiguration":{ - "name":"DeleteApplicationInputProcessingConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationInputProcessingConfigurationRequest"}, - "output":{"shape":"DeleteApplicationInputProcessingConfigurationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes an InputProcessingConfiguration from an input.

" - }, - "DeleteApplicationOutput":{ - "name":"DeleteApplicationOutput", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationOutputRequest"}, - "output":{"shape":"DeleteApplicationOutputResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes output destination configuration from your application configuration. Amazon Kinesis Analytics will no longer write data from the corresponding in-application stream to the external output destination.

This operation requires permissions to perform the kinesisanalytics:DeleteApplicationOutput action.

" - }, - "DeleteApplicationReferenceDataSource":{ - "name":"DeleteApplicationReferenceDataSource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteApplicationReferenceDataSourceRequest"}, - "output":{"shape":"DeleteApplicationReferenceDataSourceResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Deletes a reference data source configuration from the specified application configuration.

If the application is running, Amazon Kinesis Analytics immediately removes the in-application table that you created using the AddApplicationReferenceDataSource operation.

This operation requires permissions to perform the kinesisanalytics.DeleteApplicationReferenceDataSource action.

" - }, - "DescribeApplication":{ - "name":"DescribeApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeApplicationRequest"}, - "output":{"shape":"DescribeApplicationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns information about a specific Amazon Kinesis Analytics application.

If you want to retrieve a list of all applications in your account, use the ListApplications operation.

This operation requires permissions to perform the kinesisanalytics:DescribeApplication action. You can use DescribeApplication to get the current application versionId, which you need to call other operations such as Update.

" - }, - "DiscoverInputSchema":{ - "name":"DiscoverInputSchema", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DiscoverInputSchemaRequest"}, - "output":{"shape":"DiscoverInputSchemaResponse"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"UnableToDetectSchemaException"}, - {"shape":"ResourceProvisionedThroughputExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Infers a schema by evaluating sample records on the specified streaming source (Amazon Kinesis stream or Amazon Kinesis Firehose delivery stream) or S3 object. In the response, the operation returns the inferred schema and also the sample records that the operation used to infer the schema.

You can use the inferred schema when configuring a streaming source for your application. For conceptual information, see Configuring Application Input. Note that when you create an application using the Amazon Kinesis Analytics console, the console uses this operation to infer a schema and show it in the console user interface.

This operation requires permissions to perform the kinesisanalytics:DiscoverInputSchema action.

" - }, - "ListApplications":{ - "name":"ListApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListApplicationsRequest"}, - "output":{"shape":"ListApplicationsResponse"}, - "documentation":"

Returns a list of Amazon Kinesis Analytics applications in your account. For each application, the response includes the application name, Amazon Resource Name (ARN), and status. If the response returns the HasMoreApplications value as true, you can send another request by adding the ExclusiveStartApplicationName in the request body, and set the value of this to the last application name from the previous response.

If you want detailed information about a specific application, use DescribeApplication.

This operation requires permissions to perform the kinesisanalytics:ListApplications action.

" - }, - "StartApplication":{ - "name":"StartApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartApplicationRequest"}, - "output":{"shape":"StartApplicationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"InvalidApplicationConfigurationException"} - ], - "documentation":"

Starts the specified Amazon Kinesis Analytics application. After creating an application, you must exclusively call this operation to start your application.

After the application starts, it begins consuming the input data, processes it, and writes the output to the configured destination.

The application status must be READY for you to start an application. You can get the application status in the console or using the DescribeApplication operation.

After you start the application, you can stop the application from processing the input by calling the StopApplication operation.

This operation requires permissions to perform the kinesisanalytics:StartApplication action.

" - }, - "StopApplication":{ - "name":"StopApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopApplicationRequest"}, - "output":{"shape":"StopApplicationResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Stops the application from processing input data. You can stop an application only if it is in the running state. You can use the DescribeApplication operation to find the application state. After the application is stopped, Amazon Kinesis Analytics stops reading data from the input, the application stops processing data, and there is no output written to the destination.

This operation requires permissions to perform the kinesisanalytics:StopApplication action.

" - }, - "UpdateApplication":{ - "name":"UpdateApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateApplicationRequest"}, - "output":{"shape":"UpdateApplicationResponse"}, - "errors":[ - {"shape":"CodeValidationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ConcurrentModificationException"} - ], - "documentation":"

Updates an existing Amazon Kinesis Analytics application. Using this API, you can update application code, input configuration, and output configuration.

Note that Amazon Kinesis Analytics updates the CurrentApplicationVersionId each time you update your application.

This operation requires permission for the kinesisanalytics:UpdateApplication action.

" - } - }, - "shapes":{ - "AddApplicationCloudWatchLoggingOptionRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "CloudWatchLoggingOption" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The Kinesis Analytics application name.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

The version ID of the Kinesis Analytics application.

" - }, - "CloudWatchLoggingOption":{ - "shape":"CloudWatchLoggingOption", - "documentation":"

Provides the CloudWatch log stream Amazon Resource Name (ARN) and the IAM role ARN. Note: To write application messages to CloudWatch, the IAM role that is used must have the PutLogEvents policy action enabled.

" - } - } - }, - "AddApplicationCloudWatchLoggingOptionResponse":{ - "type":"structure", - "members":{ - } - }, - "AddApplicationInputProcessingConfigurationRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "InputId", - "InputProcessingConfiguration" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application to which you want to add the input processing configuration.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Version of the application to which you want to add the input processing configuration. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

" - }, - "InputId":{ - "shape":"Id", - "documentation":"

The ID of the input configuration to add the input processing configuration to. You can get a list of the input IDs for an application using the DescribeApplication operation.

" - }, - "InputProcessingConfiguration":{ - "shape":"InputProcessingConfiguration", - "documentation":"

The InputProcessingConfiguration to add to the application.

" - } - } - }, - "AddApplicationInputProcessingConfigurationResponse":{ - "type":"structure", - "members":{ - } - }, - "AddApplicationInputRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "Input" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of your existing Amazon Kinesis Analytics application to which you want to add the streaming source.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Current version of your Amazon Kinesis Analytics application. You can use the DescribeApplication operation to find the current application version.

" - }, - "Input":{ - "shape":"Input", - "documentation":"

The Input to add.

" - } - }, - "documentation":"

" - }, - "AddApplicationInputResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "AddApplicationOutputRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "Output" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application to which you want to add the output configuration.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Version of the application to which you want to add the output configuration. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

" - }, - "Output":{ - "shape":"Output", - "documentation":"

An array of objects, each describing one output configuration. In the output configuration, you specify the name of an in-application stream, a destination (that is, an Amazon Kinesis stream, an Amazon Kinesis Firehose delivery stream, or an Amazon Lambda function), and record the formation to use when writing to the destination.

" - } - }, - "documentation":"

" - }, - "AddApplicationOutputResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "AddApplicationReferenceDataSourceRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "ReferenceDataSource" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of an existing application.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Version of the application for which you are adding the reference data source. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

" - }, - "ReferenceDataSource":{ - "shape":"ReferenceDataSource", - "documentation":"

The reference data source can be an object in your Amazon S3 bucket. Amazon Kinesis Analytics reads the object and copies the data into the in-application table that is created. You provide an S3 bucket, object key name, and the resulting in-application table that is created. You must also provide an IAM role with the necessary permissions that Amazon Kinesis Analytics can assume to read the object from your S3 bucket on your behalf.

" - } - }, - "documentation":"

" - }, - "AddApplicationReferenceDataSourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "ApplicationCode":{ - "type":"string", - "max":51200, - "min":0 - }, - "ApplicationDescription":{ - "type":"string", - "max":1024, - "min":0 - }, - "ApplicationDetail":{ - "type":"structure", - "required":[ - "ApplicationName", - "ApplicationARN", - "ApplicationStatus", - "ApplicationVersionId" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application.

" - }, - "ApplicationDescription":{ - "shape":"ApplicationDescription", - "documentation":"

Description of the application.

" - }, - "ApplicationARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the application.

" - }, - "ApplicationStatus":{ - "shape":"ApplicationStatus", - "documentation":"

Status of the application.

" - }, - "CreateTimestamp":{ - "shape":"Timestamp", - "documentation":"

Time stamp when the application version was created.

" - }, - "LastUpdateTimestamp":{ - "shape":"Timestamp", - "documentation":"

Time stamp when the application was last updated.

" - }, - "InputDescriptions":{ - "shape":"InputDescriptions", - "documentation":"

Describes the application input configuration. For more information, see Configuring Application Input.

" - }, - "OutputDescriptions":{ - "shape":"OutputDescriptions", - "documentation":"

Describes the application output configuration. For more information, see Configuring Application Output.

" - }, - "ReferenceDataSourceDescriptions":{ - "shape":"ReferenceDataSourceDescriptions", - "documentation":"

Describes reference data sources configured for the application. For more information, see Configuring Application Input.

" - }, - "CloudWatchLoggingOptionDescriptions":{ - "shape":"CloudWatchLoggingOptionDescriptions", - "documentation":"

Describes the CloudWatch log streams that are configured to receive application messages. For more information about using CloudWatch log streams with Amazon Kinesis Analytics applications, see Working with Amazon CloudWatch Logs.

" - }, - "ApplicationCode":{ - "shape":"ApplicationCode", - "documentation":"

Returns the application code that you provided to perform data analysis on any of the in-application streams in your application.

" - }, - "ApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Provides the current application version.

" - } - }, - "documentation":"

Provides a description of the application, including the application Amazon Resource Name (ARN), status, latest version, and input and output configuration.

" - }, - "ApplicationName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "ApplicationStatus":{ - "type":"string", - "enum":[ - "DELETING", - "STARTING", - "STOPPING", - "READY", - "RUNNING", - "UPDATING" - ] - }, - "ApplicationSummaries":{ - "type":"list", - "member":{"shape":"ApplicationSummary"} - }, - "ApplicationSummary":{ - "type":"structure", - "required":[ - "ApplicationName", - "ApplicationARN", - "ApplicationStatus" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application.

" - }, - "ApplicationARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the application.

" - }, - "ApplicationStatus":{ - "shape":"ApplicationStatus", - "documentation":"

Status of the application.

" - } - }, - "documentation":"

Provides application summary information, including the application Amazon Resource Name (ARN), name, and status.

" - }, - "ApplicationUpdate":{ - "type":"structure", - "members":{ - "InputUpdates":{ - "shape":"InputUpdates", - "documentation":"

Describes application input configuration updates.

" - }, - "ApplicationCodeUpdate":{ - "shape":"ApplicationCode", - "documentation":"

Describes application code updates.

" - }, - "OutputUpdates":{ - "shape":"OutputUpdates", - "documentation":"

Describes application output configuration updates.

" - }, - "ReferenceDataSourceUpdates":{ - "shape":"ReferenceDataSourceUpdates", - "documentation":"

Describes application reference data source updates.

" - }, - "CloudWatchLoggingOptionUpdates":{ - "shape":"CloudWatchLoggingOptionUpdates", - "documentation":"

Describes application CloudWatch logging option updates.

" - } - }, - "documentation":"

Describes updates to apply to an existing Amazon Kinesis Analytics application.

" - }, - "ApplicationVersionId":{ - "type":"long", - "max":999999999, - "min":1 - }, - "BooleanObject":{"type":"boolean"}, - "BucketARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:.*" - }, - "CSVMappingParameters":{ - "type":"structure", - "required":[ - "RecordRowDelimiter", - "RecordColumnDelimiter" - ], - "members":{ - "RecordRowDelimiter":{ - "shape":"RecordRowDelimiter", - "documentation":"

Row delimiter. For example, in a CSV format, '\\n' is the typical row delimiter.

" - }, - "RecordColumnDelimiter":{ - "shape":"RecordColumnDelimiter", - "documentation":"

Column delimiter. For example, in a CSV format, a comma (\",\") is the typical column delimiter.

" - } - }, - "documentation":"

Provides additional mapping information when the record format uses delimiters, such as CSV. For example, the following sample records use CSV format, where the records use the '\\n' as the row delimiter and a comma (\",\") as the column delimiter:

\"name1\", \"address1\"

\"name2, \"address2\"

" - }, - "CloudWatchLoggingOption":{ - "type":"structure", - "required":[ - "LogStreamARN", - "RoleARN" - ], - "members":{ - "LogStreamARN":{ - "shape":"LogStreamARN", - "documentation":"

ARN of the CloudWatch log to receive application messages.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

IAM ARN of the role to use to send application messages. Note: To write application messages to CloudWatch, the IAM role that is used must have the PutLogEvents policy action enabled.

" - } - }, - "documentation":"

Provides a description of CloudWatch logging options, including the log stream Amazon Resource Name (ARN) and the role ARN.

" - }, - "CloudWatchLoggingOptionDescription":{ - "type":"structure", - "required":[ - "LogStreamARN", - "RoleARN" - ], - "members":{ - "CloudWatchLoggingOptionId":{ - "shape":"Id", - "documentation":"

ID of the CloudWatch logging option description.

" - }, - "LogStreamARN":{ - "shape":"LogStreamARN", - "documentation":"

ARN of the CloudWatch log to receive application messages.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

IAM ARN of the role to use to send application messages. Note: To write application messages to CloudWatch, the IAM role used must have the PutLogEvents policy action enabled.

" - } - }, - "documentation":"

Description of the CloudWatch logging option.

" - }, - "CloudWatchLoggingOptionDescriptions":{ - "type":"list", - "member":{"shape":"CloudWatchLoggingOptionDescription"} - }, - "CloudWatchLoggingOptionUpdate":{ - "type":"structure", - "required":["CloudWatchLoggingOptionId"], - "members":{ - "CloudWatchLoggingOptionId":{ - "shape":"Id", - "documentation":"

ID of the CloudWatch logging option to update

" - }, - "LogStreamARNUpdate":{ - "shape":"LogStreamARN", - "documentation":"

ARN of the CloudWatch log to receive application messages.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

IAM ARN of the role to use to send application messages. Note: To write application messages to CloudWatch, the IAM role used must have the PutLogEvents policy action enabled.

" - } - }, - "documentation":"

Describes CloudWatch logging option updates.

" - }, - "CloudWatchLoggingOptionUpdates":{ - "type":"list", - "member":{"shape":"CloudWatchLoggingOptionUpdate"} - }, - "CloudWatchLoggingOptions":{ - "type":"list", - "member":{"shape":"CloudWatchLoggingOption"} - }, - "CodeValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Test

" - } - }, - "documentation":"

User-provided application code (query) is invalid. This can be a simple syntax error.

", - "exception":true - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Exception thrown as a result of concurrent modification to an application. For example, two individuals attempting to edit the same application at the same time.

", - "exception":true - }, - "CreateApplicationRequest":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of your Amazon Kinesis Analytics application (for example, sample-app).

" - }, - "ApplicationDescription":{ - "shape":"ApplicationDescription", - "documentation":"

Summary description of the application.

" - }, - "Inputs":{ - "shape":"Inputs", - "documentation":"

Use this parameter to configure the application input.

You can configure your application to receive input from a single streaming source. In this configuration, you map this streaming source to an in-application stream that is created. Your application code can then query the in-application stream like a table (you can think of it as a constantly updating table).

For the streaming source, you provide its Amazon Resource Name (ARN) and format of data on the stream (for example, JSON, CSV, etc.). You also must provide an IAM role that Amazon Kinesis Analytics can assume to read this stream on your behalf.

To create the in-application stream, you need to specify a schema to transform your data into a schematized version used in SQL. In the schema, you provide the necessary mapping of the data elements in the streaming source to record columns in the in-app stream.

" - }, - "Outputs":{ - "shape":"Outputs", - "documentation":"

You can configure application output to write data from any of the in-application streams to up to three destinations.

These destinations can be Amazon Kinesis streams, Amazon Kinesis Firehose delivery streams, Amazon Lambda destinations, or any combination of the three.

In the configuration, you specify the in-application stream name, the destination stream or Lambda function Amazon Resource Name (ARN), and the format to use when writing data. You must also provide an IAM role that Amazon Kinesis Analytics can assume to write to the destination stream or Lambda function on your behalf.

In the output configuration, you also provide the output stream or Lambda function ARN. For stream destinations, you provide the format of data in the stream (for example, JSON, CSV). You also must provide an IAM role that Amazon Kinesis Analytics can assume to write to the stream or Lambda function on your behalf.

" - }, - "CloudWatchLoggingOptions":{ - "shape":"CloudWatchLoggingOptions", - "documentation":"

Use this parameter to configure a CloudWatch log stream to monitor application configuration errors. For more information, see Working with Amazon CloudWatch Logs.

" - }, - "ApplicationCode":{ - "shape":"ApplicationCode", - "documentation":"

One or more SQL statements that read input data, transform it, and generate output. For example, you can write a SQL statement that reads data from one in-application stream, generates a running average of the number of advertisement clicks by vendor, and insert resulting rows in another in-application stream using pumps. For more information about the typical pattern, see Application Code.

You can provide such series of SQL statements, where output of one statement can be used as the input for the next statement. You store intermediate results by creating in-application streams and pumps.

Note that the application code must create the streams with names specified in the Outputs. For example, if your Outputs defines output streams named ExampleOutputStream1 and ExampleOutputStream2, then your application code must create these streams.

" - } - }, - "documentation":"

TBD

" - }, - "CreateApplicationResponse":{ - "type":"structure", - "required":["ApplicationSummary"], - "members":{ - "ApplicationSummary":{ - "shape":"ApplicationSummary", - "documentation":"

In response to your CreateApplication request, Amazon Kinesis Analytics returns a response with a summary of the application it created, including the application Amazon Resource Name (ARN), name, and status.

" - } - }, - "documentation":"

TBD

" - }, - "DeleteApplicationCloudWatchLoggingOptionRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "CloudWatchLoggingOptionId" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The Kinesis Analytics application name.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

The version ID of the Kinesis Analytics application.

" - }, - "CloudWatchLoggingOptionId":{ - "shape":"Id", - "documentation":"

The CloudWatchLoggingOptionId of the CloudWatch logging option to delete. You can get the CloudWatchLoggingOptionId by using the DescribeApplication operation.

" - } - } - }, - "DeleteApplicationCloudWatchLoggingOptionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteApplicationInputProcessingConfigurationRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "InputId" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

The Kinesis Analytics application name.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

The version ID of the Kinesis Analytics application.

" - }, - "InputId":{ - "shape":"Id", - "documentation":"

The ID of the input configuration from which to delete the input processing configuration. You can get a list of the input IDs for an application by using the DescribeApplication operation.

" - } - } - }, - "DeleteApplicationInputProcessingConfigurationResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteApplicationOutputRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "OutputId" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Amazon Kinesis Analytics application name.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Amazon Kinesis Analytics application version. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

" - }, - "OutputId":{ - "shape":"Id", - "documentation":"

The ID of the configuration to delete. Each output configuration that is added to the application, either when the application is created or later using the AddApplicationOutput operation, has a unique ID. You need to provide the ID to uniquely identify the output configuration that you want to delete from the application configuration. You can use the DescribeApplication operation to get the specific OutputId.

" - } - }, - "documentation":"

" - }, - "DeleteApplicationOutputResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "DeleteApplicationReferenceDataSourceRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "ReferenceId" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of an existing application.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

Version of the application. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

" - }, - "ReferenceId":{ - "shape":"Id", - "documentation":"

ID of the reference data source. When you add a reference data source to your application using the AddApplicationReferenceDataSource, Amazon Kinesis Analytics assigns an ID. You can use the DescribeApplication operation to get the reference ID.

" - } - } - }, - "DeleteApplicationReferenceDataSourceResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteApplicationRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CreateTimestamp" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the Amazon Kinesis Analytics application to delete.

" - }, - "CreateTimestamp":{ - "shape":"Timestamp", - "documentation":"

You can use the DescribeApplication operation to get this value.

" - } - }, - "documentation":"

" - }, - "DeleteApplicationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "DescribeApplicationRequest":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application.

" - } - }, - "documentation":"

" - }, - "DescribeApplicationResponse":{ - "type":"structure", - "required":["ApplicationDetail"], - "members":{ - "ApplicationDetail":{ - "shape":"ApplicationDetail", - "documentation":"

Provides a description of the application, such as the application Amazon Resource Name (ARN), status, latest version, and input and output configuration details.

" - } - }, - "documentation":"

" - }, - "DestinationSchema":{ - "type":"structure", - "members":{ - "RecordFormatType":{ - "shape":"RecordFormatType", - "documentation":"

Specifies the format of the records on the output stream.

" - } - }, - "documentation":"

Describes the data format when records are written to the destination. For more information, see Configuring Application Output.

" - }, - "DiscoverInputSchemaRequest":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the streaming source.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf.

" - }, - "InputStartingPositionConfiguration":{ - "shape":"InputStartingPositionConfiguration", - "documentation":"

Point at which you want Amazon Kinesis Analytics to start reading records from the specified streaming source discovery purposes.

" - }, - "S3Configuration":{ - "shape":"S3Configuration", - "documentation":"

Specify this parameter to discover a schema from data in an S3 object.

" - }, - "InputProcessingConfiguration":{ - "shape":"InputProcessingConfiguration", - "documentation":"

The InputProcessingConfiguration to use to preprocess the records before discovering the schema of the records.

" - } - } - }, - "DiscoverInputSchemaResponse":{ - "type":"structure", - "members":{ - "InputSchema":{ - "shape":"SourceSchema", - "documentation":"

Schema inferred from the streaming source. It identifies the format of the data in the streaming source and how each data element maps to corresponding columns in the in-application stream that you can create.

" - }, - "ParsedInputRecords":{ - "shape":"ParsedInputRecords", - "documentation":"

An array of elements, where each element corresponds to a row in a stream record (a stream record can have more than one row).

" - }, - "ProcessedInputRecords":{ - "shape":"ProcessedInputRecords", - "documentation":"

Stream data that was modified by the processor specified in the InputProcessingConfiguration parameter.

" - }, - "RawInputRecords":{ - "shape":"RawInputRecords", - "documentation":"

Raw stream data that was sampled to infer the schema.

" - } - }, - "documentation":"

" - }, - "ErrorMessage":{"type":"string"}, - "FileKey":{ - "type":"string", - "max":1024, - "min":1 - }, - "Id":{ - "type":"string", - "max":50, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "InAppStreamName":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[a-zA-Z][a-zA-Z0-9_]+" - }, - "InAppStreamNames":{ - "type":"list", - "member":{"shape":"InAppStreamName"} - }, - "InAppTableName":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[a-zA-Z][a-zA-Z0-9_]+" - }, - "Input":{ - "type":"structure", - "required":[ - "NamePrefix", - "InputSchema" - ], - "members":{ - "NamePrefix":{ - "shape":"InAppStreamName", - "documentation":"

Name prefix to use when creating an in-application stream. Suppose that you specify a prefix \"MyInApplicationStream.\" Amazon Kinesis Analytics then creates one or more (as per the InputParallelism count you specified) in-application streams with names \"MyInApplicationStream_001,\" \"MyInApplicationStream_002,\" and so on.

" - }, - "InputProcessingConfiguration":{ - "shape":"InputProcessingConfiguration", - "documentation":"

The InputProcessingConfiguration for the input. An input processor transforms records as they are received from the stream, before the application's SQL code executes. Currently, the only input processing configuration available is InputLambdaProcessor.

" - }, - "KinesisStreamsInput":{ - "shape":"KinesisStreamsInput", - "documentation":"

If the streaming source is an Amazon Kinesis stream, identifies the stream's Amazon Resource Name (ARN) and an IAM role that enables Amazon Kinesis Analytics to access the stream on your behalf.

Note: Either KinesisStreamsInput or KinesisFirehoseInput is required.

" - }, - "KinesisFirehoseInput":{ - "shape":"KinesisFirehoseInput", - "documentation":"

If the streaming source is an Amazon Kinesis Firehose delivery stream, identifies the delivery stream's ARN and an IAM role that enables Amazon Kinesis Analytics to access the stream on your behalf.

Note: Either KinesisStreamsInput or KinesisFirehoseInput is required.

" - }, - "InputParallelism":{ - "shape":"InputParallelism", - "documentation":"

Describes the number of in-application streams to create.

Data from your source is routed to these in-application input streams.

(see Configuring Application Input.

" - }, - "InputSchema":{ - "shape":"SourceSchema", - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns in the in-application stream that is being created.

Also used to describe the format of the reference data source.

" - } - }, - "documentation":"

When you configure the application input, you specify the streaming source, the in-application stream name that is created, and the mapping between the two. For more information, see Configuring Application Input.

" - }, - "InputConfiguration":{ - "type":"structure", - "required":[ - "Id", - "InputStartingPositionConfiguration" - ], - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

Input source ID. You can get this ID by calling the DescribeApplication operation.

" - }, - "InputStartingPositionConfiguration":{ - "shape":"InputStartingPositionConfiguration", - "documentation":"

Point at which you want the application to start processing records from the streaming source.

" - } - }, - "documentation":"

When you start your application, you provide this configuration, which identifies the input source and the point in the input source at which you want the application to start processing records.

" - }, - "InputConfigurations":{ - "type":"list", - "member":{"shape":"InputConfiguration"} - }, - "InputDescription":{ - "type":"structure", - "members":{ - "InputId":{ - "shape":"Id", - "documentation":"

Input ID associated with the application input. This is the ID that Amazon Kinesis Analytics assigns to each input configuration you add to your application.

" - }, - "NamePrefix":{ - "shape":"InAppStreamName", - "documentation":"

In-application name prefix.

" - }, - "InAppStreamNames":{ - "shape":"InAppStreamNames", - "documentation":"

Returns the in-application stream names that are mapped to the stream source.

" - }, - "InputProcessingConfigurationDescription":{ - "shape":"InputProcessingConfigurationDescription", - "documentation":"

The description of the preprocessor that executes on records in this input before the application's code is run.

" - }, - "KinesisStreamsInputDescription":{ - "shape":"KinesisStreamsInputDescription", - "documentation":"

If an Amazon Kinesis stream is configured as streaming source, provides Amazon Kinesis stream's Amazon Resource Name (ARN) and an IAM role that enables Amazon Kinesis Analytics to access the stream on your behalf.

" - }, - "KinesisFirehoseInputDescription":{ - "shape":"KinesisFirehoseInputDescription", - "documentation":"

If an Amazon Kinesis Firehose delivery stream is configured as a streaming source, provides the delivery stream's ARN and an IAM role that enables Amazon Kinesis Analytics to access the stream on your behalf.

" - }, - "InputSchema":{ - "shape":"SourceSchema", - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns in the in-application stream that is being created.

" - }, - "InputParallelism":{ - "shape":"InputParallelism", - "documentation":"

Describes the configured parallelism (number of in-application streams mapped to the streaming source).

" - }, - "InputStartingPositionConfiguration":{ - "shape":"InputStartingPositionConfiguration", - "documentation":"

Point at which the application is configured to read from the input stream.

" - } - }, - "documentation":"

Describes the application input configuration. For more information, see Configuring Application Input.

" - }, - "InputDescriptions":{ - "type":"list", - "member":{"shape":"InputDescription"} - }, - "InputLambdaProcessor":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN of the AWS Lambda function that operates on records in the stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The ARN of the IAM role that is used to access the AWS Lambda function.

" - } - }, - "documentation":"

An object that contains the Amazon Resource Name (ARN) of the AWS Lambda function that is used to preprocess records in the stream, and the ARN of the IAM role that is used to access the AWS Lambda function.

" - }, - "InputLambdaProcessorDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN of the AWS Lambda function that is used to preprocess the records in the stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The ARN of the IAM role that is used to access the AWS Lambda function.

" - } - }, - "documentation":"

An object that contains the Amazon Resource Name (ARN) of the AWS Lambda function that is used to preprocess records in the stream, and the ARN of the IAM role that is used to access the AWS Lambda expression.

" - }, - "InputLambdaProcessorUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the new AWS Lambda function that is used to preprocess the records in the stream.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

The ARN of the new IAM role that is used to access the AWS Lambda function.

" - } - }, - "documentation":"

Represents an update to the InputLambdaProcessor that is used to preprocess the records in the stream.

" - }, - "InputParallelism":{ - "type":"structure", - "members":{ - "Count":{ - "shape":"InputParallelismCount", - "documentation":"

Number of in-application streams to create. For more information, see Limits.

" - } - }, - "documentation":"

Describes the number of in-application streams to create for a given streaming source. For information about parallelism, see Configuring Application Input.

" - }, - "InputParallelismCount":{ - "type":"integer", - "max":64, - "min":1 - }, - "InputParallelismUpdate":{ - "type":"structure", - "members":{ - "CountUpdate":{ - "shape":"InputParallelismCount", - "documentation":"

Number of in-application streams to create for the specified streaming source.

" - } - }, - "documentation":"

Provides updates to the parallelism count.

" - }, - "InputProcessingConfiguration":{ - "type":"structure", - "required":["InputLambdaProcessor"], - "members":{ - "InputLambdaProcessor":{ - "shape":"InputLambdaProcessor", - "documentation":"

The InputLambdaProcessor that is used to preprocess the records in the stream before being processed by your application code.

" - } - }, - "documentation":"

Provides a description of a processor that is used to preprocess the records in the stream before being processed by your application code. Currently, the only input processor available is AWS Lambda.

" - }, - "InputProcessingConfigurationDescription":{ - "type":"structure", - "members":{ - "InputLambdaProcessorDescription":{ - "shape":"InputLambdaProcessorDescription", - "documentation":"

Provides configuration information about the associated InputLambdaProcessorDescription.

" - } - }, - "documentation":"

Provides configuration information about an input processor. Currently, the only input processor available is AWS Lambda.

" - }, - "InputProcessingConfigurationUpdate":{ - "type":"structure", - "required":["InputLambdaProcessorUpdate"], - "members":{ - "InputLambdaProcessorUpdate":{ - "shape":"InputLambdaProcessorUpdate", - "documentation":"

Provides update information for an InputLambdaProcessor.

" - } - }, - "documentation":"

Describes updates to an InputProcessingConfiguration.

" - }, - "InputSchemaUpdate":{ - "type":"structure", - "members":{ - "RecordFormatUpdate":{ - "shape":"RecordFormat", - "documentation":"

Specifies the format of the records on the streaming source.

" - }, - "RecordEncodingUpdate":{ - "shape":"RecordEncoding", - "documentation":"

Specifies the encoding of the records in the streaming source. For example, UTF-8.

" - }, - "RecordColumnUpdates":{ - "shape":"RecordColumns", - "documentation":"

A list of RecordColumn objects. Each object describes the mapping of the streaming source element to the corresponding column in the in-application stream.

" - } - }, - "documentation":"

Describes updates for the application's input schema.

" - }, - "InputStartingPosition":{ - "type":"string", - "enum":[ - "NOW", - "TRIM_HORIZON", - "LAST_STOPPED_POINT" - ] - }, - "InputStartingPositionConfiguration":{ - "type":"structure", - "members":{ - "InputStartingPosition":{ - "shape":"InputStartingPosition", - "documentation":"

The starting position on the stream.

  • NOW - Start reading just after the most recent record in the stream, start at the request time stamp that the customer issued.

  • TRIM_HORIZON - Start reading at the last untrimmed record in the stream, which is the oldest record available in the stream. This option is not available for an Amazon Kinesis Firehose delivery stream.

  • LAST_STOPPED_POINT - Resume reading from where the application last stopped reading.

" - } - }, - "documentation":"

Describes the point at which the application reads from the streaming source.

" - }, - "InputUpdate":{ - "type":"structure", - "required":["InputId"], - "members":{ - "InputId":{ - "shape":"Id", - "documentation":"

Input ID of the application input to be updated.

" - }, - "NamePrefixUpdate":{ - "shape":"InAppStreamName", - "documentation":"

Name prefix for in-application streams that Amazon Kinesis Analytics creates for the specific streaming source.

" - }, - "InputProcessingConfigurationUpdate":{ - "shape":"InputProcessingConfigurationUpdate", - "documentation":"

Describes updates for an input processing configuration.

" - }, - "KinesisStreamsInputUpdate":{ - "shape":"KinesisStreamsInputUpdate", - "documentation":"

If an Amazon Kinesis stream is the streaming source to be updated, provides an updated stream Amazon Resource Name (ARN) and IAM role ARN.

" - }, - "KinesisFirehoseInputUpdate":{ - "shape":"KinesisFirehoseInputUpdate", - "documentation":"

If an Amazon Kinesis Firehose delivery stream is the streaming source to be updated, provides an updated stream ARN and IAM role ARN.

" - }, - "InputSchemaUpdate":{ - "shape":"InputSchemaUpdate", - "documentation":"

Describes the data format on the streaming source, and how record elements on the streaming source map to columns of the in-application stream that is created.

" - }, - "InputParallelismUpdate":{ - "shape":"InputParallelismUpdate", - "documentation":"

Describes the parallelism updates (the number in-application streams Amazon Kinesis Analytics creates for the specific streaming source).

" - } - }, - "documentation":"

Describes updates to a specific input configuration (identified by the InputId of an application).

" - }, - "InputUpdates":{ - "type":"list", - "member":{"shape":"InputUpdate"} - }, - "Inputs":{ - "type":"list", - "member":{"shape":"Input"} - }, - "InvalidApplicationConfigurationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

test

" - } - }, - "documentation":"

User-provided application configuration is not valid.

", - "exception":true - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Specified input parameter value is invalid.

", - "exception":true - }, - "JSONMappingParameters":{ - "type":"structure", - "required":["RecordRowPath"], - "members":{ - "RecordRowPath":{ - "shape":"RecordRowPath", - "documentation":"

Path to the top-level parent that contains the records.

" - } - }, - "documentation":"

Provides additional mapping information when JSON is the record format on the streaming source.

" - }, - "KinesisFirehoseInput":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the input delivery stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to make sure the role has necessary permissions to access the stream.

" - } - }, - "documentation":"

Identifies an Amazon Kinesis Firehose delivery stream as the streaming source. You provide the delivery stream's Amazon Resource Name (ARN) and an IAM role ARN that enables Amazon Kinesis Analytics to access the stream on your behalf.

" - }, - "KinesisFirehoseInputDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis Firehose delivery stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics assumes to access the stream.

" - } - }, - "documentation":"

Describes the Amazon Kinesis Firehose delivery stream that is configured as the streaming source in the application input configuration.

" - }, - "KinesisFirehoseInputUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the input Amazon Kinesis Firehose delivery stream to read.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to grant necessary permissions to this role.

" - } - }, - "documentation":"

When updating application input configuration, provides information about an Amazon Kinesis Firehose delivery stream as the streaming source.

" - }, - "KinesisFirehoseOutput":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the destination Amazon Kinesis Firehose delivery stream to write to.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to write to the destination stream on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When configuring application output, identifies an Amazon Kinesis Firehose delivery stream as the destination. You provide the stream Amazon Resource Name (ARN) and an IAM role that enables Amazon Kinesis Analytics to write to the stream on your behalf.

" - }, - "KinesisFirehoseOutputDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis Firehose delivery stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream.

" - } - }, - "documentation":"

For an application output, describes the Amazon Kinesis Firehose delivery stream configured as its destination.

" - }, - "KinesisFirehoseOutputUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis Firehose delivery stream to write to.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to grant necessary permissions to this role.

" - } - }, - "documentation":"

When updating an output configuration using the UpdateApplication operation, provides information about an Amazon Kinesis Firehose delivery stream configured as the destination.

" - }, - "KinesisStreamsInput":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the input Amazon Kinesis stream to read.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

Identifies an Amazon Kinesis stream as the streaming source. You provide the stream's Amazon Resource Name (ARN) and an IAM role ARN that enables Amazon Kinesis Analytics to access the stream on your behalf.

" - }, - "KinesisStreamsInputDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream.

" - } - }, - "documentation":"

Describes the Amazon Kinesis stream that is configured as the streaming source in the application input configuration.

" - }, - "KinesisStreamsInputUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the input Amazon Kinesis stream to read.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When updating application input configuration, provides information about an Amazon Kinesis stream as the streaming source.

" - }, - "KinesisStreamsOutput":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

ARN of the destination Amazon Kinesis stream to write to.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to write to the destination stream on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When configuring application output, identifies an Amazon Kinesis stream as the destination. You provide the stream Amazon Resource Name (ARN) and also an IAM role ARN that Amazon Kinesis Analytics can use to write to the stream on your behalf.

" - }, - "KinesisStreamsOutputDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis stream.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream.

" - } - }, - "documentation":"

For an application output, describes the Amazon Kinesis stream configured as its destination.

" - }, - "KinesisStreamsOutputUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the Amazon Kinesis stream where you want to write the output.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When updating an output configuration using the UpdateApplication operation, provides information about an Amazon Kinesis stream configured as the destination.

" - }, - "LambdaOutput":{ - "type":"structure", - "required":[ - "ResourceARN", - "RoleARN" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the destination Lambda function to write to.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to write to the destination function on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When configuring application output, identifies an AWS Lambda function as the destination. You provide the function Amazon Resource Name (ARN) and also an IAM role ARN that Amazon Kinesis Analytics can use to write to the function on your behalf.

" - }, - "LambdaOutputDescription":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the destination Lambda function.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to write to the destination function.

" - } - }, - "documentation":"

For an application output, describes the AWS Lambda function configured as its destination.

" - }, - "LambdaOutputUpdate":{ - "type":"structure", - "members":{ - "ResourceARNUpdate":{ - "shape":"ResourceARN", - "documentation":"

Amazon Resource Name (ARN) of the destination Lambda function.

" - }, - "RoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to write to the destination function on your behalf. You need to grant the necessary permissions to this role.

" - } - }, - "documentation":"

When updating an output configuration using the UpdateApplication operation, provides information about an AWS Lambda function configured as the destination.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Exceeded the number of applications allowed.

", - "exception":true - }, - "ListApplicationsInputLimit":{ - "type":"integer", - "max":50, - "min":1 - }, - "ListApplicationsRequest":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"ListApplicationsInputLimit", - "documentation":"

Maximum number of applications to list.

" - }, - "ExclusiveStartApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application to start the list with. When using pagination to retrieve the list, you don't need to specify this parameter in the first request. However, in subsequent requests, you add the last application name from the previous response to get the next page of applications.

" - } - }, - "documentation":"

" - }, - "ListApplicationsResponse":{ - "type":"structure", - "required":[ - "ApplicationSummaries", - "HasMoreApplications" - ], - "members":{ - "ApplicationSummaries":{ - "shape":"ApplicationSummaries", - "documentation":"

List of ApplicationSummary objects.

" - }, - "HasMoreApplications":{ - "shape":"BooleanObject", - "documentation":"

Returns true if there are more applications to retrieve.

" - } - }, - "documentation":"

" - }, - "LogStreamARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:.*" - }, - "MappingParameters":{ - "type":"structure", - "members":{ - "JSONMappingParameters":{ - "shape":"JSONMappingParameters", - "documentation":"

Provides additional mapping information when JSON is the record format on the streaming source.

" - }, - "CSVMappingParameters":{ - "shape":"CSVMappingParameters", - "documentation":"

Provides additional mapping information when the record format uses delimiters (for example, CSV).

" - } - }, - "documentation":"

When configuring application input at the time of creating or updating an application, provides additional mapping information specific to the record format (such as JSON, CSV, or record fields delimited by some delimiter) on the streaming source.

" - }, - "Output":{ - "type":"structure", - "required":[ - "Name", - "DestinationSchema" - ], - "members":{ - "Name":{ - "shape":"InAppStreamName", - "documentation":"

Name of the in-application stream.

" - }, - "KinesisStreamsOutput":{ - "shape":"KinesisStreamsOutput", - "documentation":"

Identifies an Amazon Kinesis stream as the destination.

" - }, - "KinesisFirehoseOutput":{ - "shape":"KinesisFirehoseOutput", - "documentation":"

Identifies an Amazon Kinesis Firehose delivery stream as the destination.

" - }, - "LambdaOutput":{ - "shape":"LambdaOutput", - "documentation":"

Identifies an AWS Lambda function as the destination.

" - }, - "DestinationSchema":{ - "shape":"DestinationSchema", - "documentation":"

Describes the data format when records are written to the destination. For more information, see Configuring Application Output.

" - } - }, - "documentation":"

Describes application output configuration in which you identify an in-application stream and a destination where you want the in-application stream data to be written. The destination can be an Amazon Kinesis stream or an Amazon Kinesis Firehose delivery stream.

For limits on how many destinations an application can write and other limitations, see Limits.

" - }, - "OutputDescription":{ - "type":"structure", - "members":{ - "OutputId":{ - "shape":"Id", - "documentation":"

A unique identifier for the output configuration.

" - }, - "Name":{ - "shape":"InAppStreamName", - "documentation":"

Name of the in-application stream configured as output.

" - }, - "KinesisStreamsOutputDescription":{ - "shape":"KinesisStreamsOutputDescription", - "documentation":"

Describes Amazon Kinesis stream configured as the destination where output is written.

" - }, - "KinesisFirehoseOutputDescription":{ - "shape":"KinesisFirehoseOutputDescription", - "documentation":"

Describes the Amazon Kinesis Firehose delivery stream configured as the destination where output is written.

" - }, - "LambdaOutputDescription":{ - "shape":"LambdaOutputDescription", - "documentation":"

Describes the AWS Lambda function configured as the destination where output is written.

" - }, - "DestinationSchema":{ - "shape":"DestinationSchema", - "documentation":"

Data format used for writing data to the destination.

" - } - }, - "documentation":"

Describes the application output configuration, which includes the in-application stream name and the destination where the stream data is written. The destination can be an Amazon Kinesis stream or an Amazon Kinesis Firehose delivery stream.

" - }, - "OutputDescriptions":{ - "type":"list", - "member":{"shape":"OutputDescription"} - }, - "OutputUpdate":{ - "type":"structure", - "required":["OutputId"], - "members":{ - "OutputId":{ - "shape":"Id", - "documentation":"

Identifies the specific output configuration that you want to update.

" - }, - "NameUpdate":{ - "shape":"InAppStreamName", - "documentation":"

If you want to specify a different in-application stream for this output configuration, use this field to specify the new in-application stream name.

" - }, - "KinesisStreamsOutputUpdate":{ - "shape":"KinesisStreamsOutputUpdate", - "documentation":"

Describes an Amazon Kinesis stream as the destination for the output.

" - }, - "KinesisFirehoseOutputUpdate":{ - "shape":"KinesisFirehoseOutputUpdate", - "documentation":"

Describes an Amazon Kinesis Firehose delivery stream as the destination for the output.

" - }, - "LambdaOutputUpdate":{ - "shape":"LambdaOutputUpdate", - "documentation":"

Describes an AWS Lambda function as the destination for the output.

" - }, - "DestinationSchemaUpdate":{ - "shape":"DestinationSchema", - "documentation":"

Describes the data format when records are written to the destination. For more information, see Configuring Application Output.

" - } - }, - "documentation":"

Describes updates to the output configuration identified by the OutputId.

" - }, - "OutputUpdates":{ - "type":"list", - "member":{"shape":"OutputUpdate"} - }, - "Outputs":{ - "type":"list", - "member":{"shape":"Output"} - }, - "ParsedInputRecord":{ - "type":"list", - "member":{"shape":"ParsedInputRecordField"} - }, - "ParsedInputRecordField":{"type":"string"}, - "ParsedInputRecords":{ - "type":"list", - "member":{"shape":"ParsedInputRecord"} - }, - "ProcessedInputRecord":{"type":"string"}, - "ProcessedInputRecords":{ - "type":"list", - "member":{"shape":"ProcessedInputRecord"} - }, - "RawInputRecord":{"type":"string"}, - "RawInputRecords":{ - "type":"list", - "member":{"shape":"RawInputRecord"} - }, - "RecordColumn":{ - "type":"structure", - "required":[ - "Name", - "SqlType" - ], - "members":{ - "Name":{ - "shape":"RecordColumnName", - "documentation":"

Name of the column created in the in-application input stream or reference table.

" - }, - "Mapping":{ - "shape":"RecordColumnMapping", - "documentation":"

Reference to the data element in the streaming input of the reference data source.

" - }, - "SqlType":{ - "shape":"RecordColumnSqlType", - "documentation":"

Type of column created in the in-application input stream or reference table.

" - } - }, - "documentation":"

Describes the mapping of each data element in the streaming source to the corresponding column in the in-application stream.

Also used to describe the format of the reference data source.

" - }, - "RecordColumnDelimiter":{ - "type":"string", - "min":1 - }, - "RecordColumnMapping":{"type":"string"}, - "RecordColumnName":{ - "type":"string", - "pattern":"[a-zA-Z_][a-zA-Z0-9_]*" - }, - "RecordColumnSqlType":{ - "type":"string", - "min":1 - }, - "RecordColumns":{ - "type":"list", - "member":{"shape":"RecordColumn"}, - "max":1000, - "min":1 - }, - "RecordEncoding":{ - "type":"string", - "pattern":"UTF-8" - }, - "RecordFormat":{ - "type":"structure", - "required":["RecordFormatType"], - "members":{ - "RecordFormatType":{ - "shape":"RecordFormatType", - "documentation":"

The type of record format.

" - }, - "MappingParameters":{ - "shape":"MappingParameters", - "documentation":"

When configuring application input at the time of creating or updating an application, provides additional mapping information specific to the record format (such as JSON, CSV, or record fields delimited by some delimiter) on the streaming source.

" - } - }, - "documentation":"

Describes the record format and relevant mapping information that should be applied to schematize the records on the stream.

" - }, - "RecordFormatType":{ - "type":"string", - "enum":[ - "JSON", - "CSV" - ] - }, - "RecordRowDelimiter":{ - "type":"string", - "min":1 - }, - "RecordRowPath":{ - "type":"string", - "min":1 - }, - "ReferenceDataSource":{ - "type":"structure", - "required":[ - "TableName", - "ReferenceSchema" - ], - "members":{ - "TableName":{ - "shape":"InAppTableName", - "documentation":"

Name of the in-application table to create.

" - }, - "S3ReferenceDataSource":{ - "shape":"S3ReferenceDataSource", - "documentation":"

Identifies the S3 bucket and object that contains the reference data. Also identifies the IAM role Amazon Kinesis Analytics can assume to read this object on your behalf. An Amazon Kinesis Analytics application loads reference data only once. If the data changes, you call the UpdateApplication operation to trigger reloading of data into your application.

" - }, - "ReferenceSchema":{ - "shape":"SourceSchema", - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns created in the in-application stream.

" - } - }, - "documentation":"

Describes the reference data source by providing the source information (S3 bucket name and object key name), the resulting in-application table name that is created, and the necessary schema to map the data elements in the Amazon S3 object to the in-application table.

" - }, - "ReferenceDataSourceDescription":{ - "type":"structure", - "required":[ - "ReferenceId", - "TableName", - "S3ReferenceDataSourceDescription" - ], - "members":{ - "ReferenceId":{ - "shape":"Id", - "documentation":"

ID of the reference data source. This is the ID that Amazon Kinesis Analytics assigns when you add the reference data source to your application using the AddApplicationReferenceDataSource operation.

" - }, - "TableName":{ - "shape":"InAppTableName", - "documentation":"

The in-application table name created by the specific reference data source configuration.

" - }, - "S3ReferenceDataSourceDescription":{ - "shape":"S3ReferenceDataSourceDescription", - "documentation":"

Provides the S3 bucket name, the object key name that contains the reference data. It also provides the Amazon Resource Name (ARN) of the IAM role that Amazon Kinesis Analytics can assume to read the Amazon S3 object and populate the in-application reference table.

" - }, - "ReferenceSchema":{ - "shape":"SourceSchema", - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns created in the in-application stream.

" - } - }, - "documentation":"

Describes the reference data source configured for an application.

" - }, - "ReferenceDataSourceDescriptions":{ - "type":"list", - "member":{"shape":"ReferenceDataSourceDescription"} - }, - "ReferenceDataSourceUpdate":{ - "type":"structure", - "required":["ReferenceId"], - "members":{ - "ReferenceId":{ - "shape":"Id", - "documentation":"

ID of the reference data source being updated. You can use the DescribeApplication operation to get this value.

" - }, - "TableNameUpdate":{ - "shape":"InAppTableName", - "documentation":"

In-application table name that is created by this update.

" - }, - "S3ReferenceDataSourceUpdate":{ - "shape":"S3ReferenceDataSourceUpdate", - "documentation":"

Describes the S3 bucket name, object key name, and IAM role that Amazon Kinesis Analytics can assume to read the Amazon S3 object on your behalf and populate the in-application reference table.

" - }, - "ReferenceSchemaUpdate":{ - "shape":"SourceSchema", - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns created in the in-application stream.

" - } - }, - "documentation":"

When you update a reference data source configuration for an application, this object provides all the updated values (such as the source bucket name and object key name), the in-application table name that is created, and updated mapping information that maps the data in the Amazon S3 object to the in-application reference table that is created.

" - }, - "ReferenceDataSourceUpdates":{ - "type":"list", - "member":{"shape":"ReferenceDataSourceUpdate"} - }, - "ResourceARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:.*" - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Application is not available for this operation.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

" - } - }, - "documentation":"

Specified application can't be found.

", - "exception":true - }, - "ResourceProvisionedThroughputExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Discovery failed to get a record from the streaming source because of the Amazon Kinesis Streams ProvisionedThroughputExceededException. For more information, see GetRecords in the Amazon Kinesis Streams API Reference.

", - "exception":true - }, - "RoleARN":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - }, - "S3Configuration":{ - "type":"structure", - "required":[ - "RoleARN", - "BucketARN", - "FileKey" - ], - "members":{ - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

IAM ARN of the role used to access the data.

" - }, - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

ARN of the S3 bucket that contains the data.

" - }, - "FileKey":{ - "shape":"FileKey", - "documentation":"

The name of the object that contains the data.

" - } - }, - "documentation":"

Provides a description of an Amazon S3 data source, including the Amazon Resource Name (ARN) of the S3 bucket, the ARN of the IAM role that is used to access the bucket, and the name of the S3 object that contains the data.

" - }, - "S3ReferenceDataSource":{ - "type":"structure", - "required":[ - "BucketARN", - "FileKey", - "ReferenceRoleARN" - ], - "members":{ - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

Amazon Resource Name (ARN) of the S3 bucket.

" - }, - "FileKey":{ - "shape":"FileKey", - "documentation":"

Object key name containing reference data.

" - }, - "ReferenceRoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that the service can assume to read data on your behalf. This role must have permission for the s3:GetObject action on the object and trust policy that allows Amazon Kinesis Analytics service principal to assume this role.

" - } - }, - "documentation":"

Identifies the S3 bucket and object that contains the reference data. Also identifies the IAM role Amazon Kinesis Analytics can assume to read this object on your behalf.

An Amazon Kinesis Analytics application loads reference data only once. If the data changes, you call the UpdateApplication operation to trigger reloading of data into your application.

" - }, - "S3ReferenceDataSourceDescription":{ - "type":"structure", - "required":[ - "BucketARN", - "FileKey", - "ReferenceRoleARN" - ], - "members":{ - "BucketARN":{ - "shape":"BucketARN", - "documentation":"

Amazon Resource Name (ARN) of the S3 bucket.

" - }, - "FileKey":{ - "shape":"FileKey", - "documentation":"

Amazon S3 object key name.

" - }, - "ReferenceRoleARN":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to read the Amazon S3 object on your behalf to populate the in-application reference table.

" - } - }, - "documentation":"

Provides the bucket name and object key name that stores the reference data.

" - }, - "S3ReferenceDataSourceUpdate":{ - "type":"structure", - "members":{ - "BucketARNUpdate":{ - "shape":"BucketARN", - "documentation":"

Amazon Resource Name (ARN) of the S3 bucket.

" - }, - "FileKeyUpdate":{ - "shape":"FileKey", - "documentation":"

Object key name.

" - }, - "ReferenceRoleARNUpdate":{ - "shape":"RoleARN", - "documentation":"

ARN of the IAM role that Amazon Kinesis Analytics can assume to read the Amazon S3 object and populate the in-application.

" - } - }, - "documentation":"

Describes the S3 bucket name, object key name, and IAM role that Amazon Kinesis Analytics can assume to read the Amazon S3 object on your behalf and populate the in-application reference table.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service is unavailable, back off and retry the operation.

", - "exception":true, - "fault":true - }, - "SourceSchema":{ - "type":"structure", - "required":[ - "RecordFormat", - "RecordColumns" - ], - "members":{ - "RecordFormat":{ - "shape":"RecordFormat", - "documentation":"

Specifies the format of the records on the streaming source.

" - }, - "RecordEncoding":{ - "shape":"RecordEncoding", - "documentation":"

Specifies the encoding of the records in the streaming source. For example, UTF-8.

" - }, - "RecordColumns":{ - "shape":"RecordColumns", - "documentation":"

A list of RecordColumn objects.

" - } - }, - "documentation":"

Describes the format of the data in the streaming source, and how each data element maps to corresponding columns created in the in-application stream.

" - }, - "StartApplicationRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "InputConfigurations" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the application.

" - }, - "InputConfigurations":{ - "shape":"InputConfigurations", - "documentation":"

Identifies the specific input, by ID, that the application starts consuming. Amazon Kinesis Analytics starts reading the streaming source associated with the input. You can also specify where in the streaming source you want Amazon Kinesis Analytics to start reading.

" - } - }, - "documentation":"

" - }, - "StartApplicationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "StopApplicationRequest":{ - "type":"structure", - "required":["ApplicationName"], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the running application to stop.

" - } - }, - "documentation":"

" - }, - "StopApplicationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "Timestamp":{"type":"timestamp"}, - "UnableToDetectSchemaException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "RawInputRecords":{"shape":"RawInputRecords"}, - "ProcessedInputRecords":{"shape":"ProcessedInputRecords"} - }, - "documentation":"

Data format is not valid, Amazon Kinesis Analytics is not able to detect schema for the given streaming source.

", - "exception":true - }, - "UpdateApplicationRequest":{ - "type":"structure", - "required":[ - "ApplicationName", - "CurrentApplicationVersionId", - "ApplicationUpdate" - ], - "members":{ - "ApplicationName":{ - "shape":"ApplicationName", - "documentation":"

Name of the Amazon Kinesis Analytics application to update.

" - }, - "CurrentApplicationVersionId":{ - "shape":"ApplicationVersionId", - "documentation":"

The current application version ID. You can use the DescribeApplication operation to get this value.

" - }, - "ApplicationUpdate":{ - "shape":"ApplicationUpdate", - "documentation":"

Describes application updates.

" - } - } - }, - "UpdateApplicationResponse":{ - "type":"structure", - "members":{ - } - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/service-2.json deleted file mode 100644 index 98504cc0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kinesisvideo/2017-09-30/service-2.json +++ /dev/null @@ -1,729 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-30", - "endpointPrefix":"kinesisvideo", - "protocol":"rest-json", - "serviceAbbreviation":"Kinesis Video", - "serviceFullName":"Amazon Kinesis Video Streams", - "serviceId":"Kinesis Video", - "signatureVersion":"v4", - "uid":"kinesisvideo-2017-09-30" - }, - "operations":{ - "CreateStream":{ - "name":"CreateStream", - "http":{ - "method":"POST", - "requestUri":"/createStream" - }, - "input":{"shape":"CreateStreamInput"}, - "output":{"shape":"CreateStreamOutput"}, - "errors":[ - {"shape":"AccountStreamLimitExceededException"}, - {"shape":"DeviceStreamLimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidDeviceException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ClientLimitExceededException"} - ], - "documentation":"

Creates a new Kinesis video stream.

When you create a new stream, Kinesis Video Streams assigns it a version number. When you change the stream's metadata, Kinesis Video Streams updates the version.

CreateStream is an asynchronous operation.

For information about how the service works, see How it Works.

You must have permissions for the KinesisVideo:CreateStream action.

" - }, - "DeleteStream":{ - "name":"DeleteStream", - "http":{ - "method":"POST", - "requestUri":"/deleteStream" - }, - "input":{"shape":"DeleteStreamInput"}, - "output":{"shape":"DeleteStreamOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Deletes a Kinesis video stream and the data contained in the stream.

This method marks the stream for deletion, and makes the data in the stream inaccessible immediately.

To ensure that you have the latest version of the stream before deleting it, you can specify the stream version. Kinesis Video Streams assigns a version to each stream. When you update a stream, Kinesis Video Streams assigns a new version number. To get the latest stream version, use the DescribeStream API.

This operation requires permission for the KinesisVideo:DeleteStream action.

" - }, - "DescribeStream":{ - "name":"DescribeStream", - "http":{ - "method":"POST", - "requestUri":"/describeStream" - }, - "input":{"shape":"DescribeStreamInput"}, - "output":{"shape":"DescribeStreamOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Returns the most current information about the specified stream. You must specify either the StreamName or the StreamARN.

" - }, - "GetDataEndpoint":{ - "name":"GetDataEndpoint", - "http":{ - "method":"POST", - "requestUri":"/getDataEndpoint" - }, - "input":{"shape":"GetDataEndpointInput"}, - "output":{"shape":"GetDataEndpointOutput"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ClientLimitExceededException"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Gets an endpoint for a specified stream for either reading or writing. Use this endpoint in your application to read from the specified stream (using the GetMedia or GetMediaForFragmentList operations) or write to it (using the PutMedia operation).

The returned endpoint does not have the API name appended. The client needs to add the API name to the returned endpoint.

In the request, specify the stream either by StreamName or StreamARN.

" - }, - "ListStreams":{ - "name":"ListStreams", - "http":{ - "method":"POST", - "requestUri":"/listStreams" - }, - "input":{"shape":"ListStreamsInput"}, - "output":{"shape":"ListStreamsOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Returns an array of StreamInfo objects. Each object describes a stream. To retrieve only streams that satisfy a specific condition, you can specify a StreamNameCondition.

" - }, - "ListTagsForStream":{ - "name":"ListTagsForStream", - "http":{ - "method":"POST", - "requestUri":"/listTagsForStream" - }, - "input":{"shape":"ListTagsForStreamInput"}, - "output":{"shape":"ListTagsForStreamOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidResourceFormatException"} - ], - "documentation":"

Returns a list of tags associated with the specified stream.

In the request, you must specify either the StreamName or the StreamARN.

" - }, - "TagStream":{ - "name":"TagStream", - "http":{ - "method":"POST", - "requestUri":"/tagStream" - }, - "input":{"shape":"TagStreamInput"}, - "output":{"shape":"TagStreamOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidResourceFormatException"}, - {"shape":"TagsPerResourceExceededLimitException"} - ], - "documentation":"

Adds one or more tags to a stream. A tag is a key-value pair (the value is optional) that you can define and assign to AWS resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

You must provide either the StreamName or the StreamARN.

This operation requires permission for the KinesisVideo:TagStream action.

Kinesis video streams support up to 50 tags.

" - }, - "UntagStream":{ - "name":"UntagStream", - "http":{ - "method":"POST", - "requestUri":"/untagStream" - }, - "input":{"shape":"UntagStreamInput"}, - "output":{"shape":"UntagStreamOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidResourceFormatException"} - ], - "documentation":"

Removes one or more tags from a stream. In the request, specify only a tag key or keys; don't specify the value. If you specify a tag key that does not exist, it's ignored.

In the request, you must provide the StreamName or StreamARN.

" - }, - "UpdateDataRetention":{ - "name":"UpdateDataRetention", - "http":{ - "method":"POST", - "requestUri":"/updateDataRetention" - }, - "input":{"shape":"UpdateDataRetentionInput"}, - "output":{"shape":"UpdateDataRetentionOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"VersionMismatchException"} - ], - "documentation":"

Increases or decreases the stream's data retention period by the value that you specify. To indicate whether you want to increase or decrease the data retention period, specify the Operation parameter in the request body. In the request, you must specify either the StreamName or the StreamARN.

The retention period that you specify replaces the current value.

This operation requires permission for the KinesisVideo:UpdateDataRetention action.

Changing the data retention period affects the data in the stream as follows:

  • If the data retention period is increased, existing data is retained for the new retention period. For example, if the data retention period is increased from one hour to seven hours, all existing data is retained for seven hours.

  • If the data retention period is decreased, existing data is retained for the new retention period. For example, if the data retention period is decreased from seven hours to one hour, all existing data is retained for one hour, and any data older than one hour is deleted immediately.

" - }, - "UpdateStream":{ - "name":"UpdateStream", - "http":{ - "method":"POST", - "requestUri":"/updateStream" - }, - "input":{"shape":"UpdateStreamInput"}, - "output":{"shape":"UpdateStreamOutput"}, - "errors":[ - {"shape":"ClientLimitExceededException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"NotAuthorizedException"}, - {"shape":"VersionMismatchException"} - ], - "documentation":"

Updates stream metadata, such as the device name and media type.

You must provide the stream name or the Amazon Resource Name (ARN) of the stream.

To make sure that you have the latest version of the stream before updating it, you can specify the stream version. Kinesis Video Streams assigns a version to each stream. When you update a stream, Kinesis Video Streams assigns a new version number. To get the latest stream version, use the DescribeStream API.

UpdateStream is an asynchronous operation, and takes time to complete.

" - } - }, - "shapes":{ - "APIName":{ - "type":"string", - "enum":[ - "PUT_MEDIA", - "GET_MEDIA", - "LIST_FRAGMENTS", - "GET_MEDIA_FOR_FRAGMENT_LIST", - "GET_HLS_STREAMING_SESSION_URL" - ] - }, - "AccountStreamLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The number of streams created for the account is too high.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ClientLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client calls. Try making the call later.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ComparisonOperator":{ - "type":"string", - "enum":["BEGINS_WITH"] - }, - "CreateStreamInput":{ - "type":"structure", - "required":["StreamName"], - "members":{ - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The name of the device that is writing to the stream.

In the current implementation, Kinesis Video Streams does not use this name.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

A name for the stream that you are creating.

The stream name is an identifier for the stream, and must be unique for each account and region.

" - }, - "MediaType":{ - "shape":"MediaType", - "documentation":"

The media type of the stream. Consumers of the stream can use this information when processing the stream. For more information about media types, see Media Types. If you choose to specify the MediaType, see Naming Requirements for guidelines.

To play video on the console, the media must be H.264 encoded, and you need to specify this video type in this parameter as video/h264.

This parameter is optional; the default value is null (or empty in JSON).

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The ID of the AWS Key Management Service (AWS KMS) key that you want Kinesis Video Streams to use to encrypt stream data.

If no key ID is specified, the default, Kinesis Video-managed key (aws/kinesisvideo) is used.

For more information, see DescribeKey.

" - }, - "DataRetentionInHours":{ - "shape":"DataRetentionInHours", - "documentation":"

The number of hours that you want to retain the data in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream.

The default value is 0, indicating that the stream does not persist data.

When the DataRetentionInHours value is 0, consumers can still consume the fragments that remain in the service host buffer, which has a retention time limit of 5 minutes and a retention memory limit of 200 MB. Fragments are removed from the buffer when either limit is reached.

" - } - } - }, - "CreateStreamOutput":{ - "type":"structure", - "members":{ - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream.

" - } - } - }, - "DataEndpoint":{"type":"string"}, - "DataRetentionChangeInHours":{ - "type":"integer", - "min":1 - }, - "DataRetentionInHours":{ - "type":"integer", - "min":0 - }, - "DeleteStreamInput":{ - "type":"structure", - "required":["StreamARN"], - "members":{ - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream that you want to delete.

" - }, - "CurrentVersion":{ - "shape":"Version", - "documentation":"

Optional: The version of the stream that you want to delete.

Specify the version as a safeguard to ensure that your are deleting the correct stream. To get the stream version, use the DescribeStream API.

If not specified, only the CreationTime is checked before deleting the stream.

" - } - } - }, - "DeleteStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeStreamInput":{ - "type":"structure", - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream.

" - } - } - }, - "DescribeStreamOutput":{ - "type":"structure", - "members":{ - "StreamInfo":{ - "shape":"StreamInfo", - "documentation":"

An object that describes the stream.

" - } - } - }, - "DeviceName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "DeviceStreamLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Not implemented.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ErrorMessage":{"type":"string"}, - "GetDataEndpointInput":{ - "type":"structure", - "required":["APIName"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream that you want to get the endpoint for. You must specify either this parameter or a StreamARN in the request.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream that you want to get the endpoint for. You must specify either this parameter or a StreamName in the request.

" - }, - "APIName":{ - "shape":"APIName", - "documentation":"

The name of the API action for which to get an endpoint.

" - } - } - }, - "GetDataEndpointOutput":{ - "type":"structure", - "members":{ - "DataEndpoint":{ - "shape":"DataEndpoint", - "documentation":"

The endpoint value. To read data from the stream or to write data to it, specify this endpoint in your application.

" - } - } - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The value for this input parameter is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidDeviceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Not implemented.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidResourceFormatException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The format of the StreamARN is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "KmsKeyId":{ - "type":"string", - "max":2048, - "min":1 - }, - "ListStreamsInput":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"ListStreamsInputLimit", - "documentation":"

The maximum number of streams to return in the response. The default is 10,000.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If you specify this parameter, when the result of a ListStreams operation is truncated, the call returns the NextToken in the response. To get another batch of streams, provide this token in your next request.

" - }, - "StreamNameCondition":{ - "shape":"StreamNameCondition", - "documentation":"

Optional: Returns only streams that satisfy a specific condition. Currently, you can specify only the prefix of a stream name as a condition.

" - } - } - }, - "ListStreamsInputLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ListStreamsOutput":{ - "type":"structure", - "members":{ - "StreamInfoList":{ - "shape":"StreamInfoList", - "documentation":"

An array of StreamInfo objects.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, the call returns this element with a token. To get the next batch of streams, use this token in your next request.

" - } - } - }, - "ListTagsForStreamInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If you specify this parameter and the result of a ListTagsForStream call is truncated, the response includes a token that you can use in the next request to fetch the next batch of tags.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream that you want to list tags for.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream that you want to list tags for.

" - } - } - }, - "ListTagsForStreamOutput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If you specify this parameter and the result of a ListTags call is truncated, the response includes a token that you can use in the next request to fetch the next set of tags.

" - }, - "Tags":{ - "shape":"ResourceTags", - "documentation":"

A map of tag keys and values associated with the specified stream.

" - } - } - }, - "MediaType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w\\-\\.\\+]+/[\\w\\-\\.\\+]+" - }, - "NextToken":{ - "type":"string", - "max":512, - "min":0 - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The caller is not authorized to perform this operation.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "ResourceARN":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+" - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The stream is currently not available for this operation.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Amazon Kinesis Video Streams can't find the stream that you specified.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ResourceTags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"}, - "max":50, - "min":1 - }, - "Status":{ - "type":"string", - "enum":[ - "CREATING", - "ACTIVE", - "UPDATING", - "DELETING" - ] - }, - "StreamInfo":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The name of the device that is associated with the stream.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream.

" - }, - "MediaType":{ - "shape":"MediaType", - "documentation":"

The MediaType of the stream.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The ID of the AWS Key Management Service (AWS KMS) key that Kinesis Video Streams uses to encrypt data on the stream.

" - }, - "Version":{ - "shape":"Version", - "documentation":"

The version of the stream.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the stream.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A time stamp that indicates when the stream was created.

" - }, - "DataRetentionInHours":{ - "shape":"DataRetentionInHours", - "documentation":"

How long the stream retains data, in hours.

" - } - }, - "documentation":"

An object describing a Kinesis video stream.

" - }, - "StreamInfoList":{ - "type":"list", - "member":{"shape":"StreamInfo"} - }, - "StreamName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "StreamNameCondition":{ - "type":"structure", - "members":{ - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

A comparison operator. Currently, you can specify only the BEGINS_WITH operator, which finds streams whose names start with a given prefix.

" - }, - "ComparisonValue":{ - "shape":"StreamName", - "documentation":"

A value to compare.

" - } - }, - "documentation":"

Specifies the condition that streams must satisfy to be returned when you list streams (see the ListStreams API). A condition has a comparison operation and a value. Currently, you can specify only the BEGINS_WITH operator, which finds streams whose names start with a given prefix.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagStreamInput":{ - "type":"structure", - "required":["Tags"], - "members":{ - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource that you want to add the tag or tags to.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream that you want to add the tag or tags to.

" - }, - "Tags":{ - "shape":"ResourceTags", - "documentation":"

A list of tags to associate with the specified stream. Each tag is a key-value pair (the value is optional).

" - } - } - }, - "TagStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0 - }, - "TagsPerResourceExceededLimitException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You have exceeded the limit of tags that you can associate with the resource. Kinesis video streams support up to 50 tags.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "UntagStreamInput":{ - "type":"structure", - "required":["TagKeyList"], - "members":{ - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream that you want to remove tags from.

" - }, - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream that you want to remove tags from.

" - }, - "TagKeyList":{ - "shape":"TagKeyList", - "documentation":"

A list of the keys of the tags that you want to remove.

" - } - } - }, - "UntagStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "UpdateDataRetentionInput":{ - "type":"structure", - "required":[ - "CurrentVersion", - "Operation", - "DataRetentionChangeInHours" - ], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream whose retention period you want to change.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the stream whose retention period you want to change.

" - }, - "CurrentVersion":{ - "shape":"Version", - "documentation":"

The version of the stream whose retention period you want to change. To get the version, call either the DescribeStream or the ListStreams API.

" - }, - "Operation":{ - "shape":"UpdateDataRetentionOperation", - "documentation":"

Indicates whether you want to increase or decrease the retention period.

" - }, - "DataRetentionChangeInHours":{ - "shape":"DataRetentionChangeInHours", - "documentation":"

The retention period, in hours. The value you specify replaces the current value.

" - } - } - }, - "UpdateDataRetentionOperation":{ - "type":"string", - "enum":[ - "INCREASE_DATA_RETENTION", - "DECREASE_DATA_RETENTION" - ] - }, - "UpdateDataRetentionOutput":{ - "type":"structure", - "members":{ - } - }, - "UpdateStreamInput":{ - "type":"structure", - "required":["CurrentVersion"], - "members":{ - "StreamName":{ - "shape":"StreamName", - "documentation":"

The name of the stream whose metadata you want to update.

The stream name is an identifier for the stream, and must be unique for each account and region.

" - }, - "StreamARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN of the stream whose metadata you want to update.

" - }, - "CurrentVersion":{ - "shape":"Version", - "documentation":"

The version of the stream whose metadata you want to update.

" - }, - "DeviceName":{ - "shape":"DeviceName", - "documentation":"

The name of the device that is writing to the stream.

In the current implementation, Kinesis Video Streams does not use this name.

" - }, - "MediaType":{ - "shape":"MediaType", - "documentation":"

The stream's media type. Use MediaType to specify the type of content that the stream contains to the consumers of the stream. For more information about media types, see Media Types. If you choose to specify the MediaType, see Naming Requirements.

To play video on the console, you must specify the correct video type. For example, if the video in the stream is H.264, specify video/h264 as the MediaType.

" - } - } - }, - "UpdateStreamOutput":{ - "type":"structure", - "members":{ - } - }, - "Version":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[a-zA-Z0-9]+" - }, - "VersionMismatchException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The stream version that you specified is not the latest version. To get the latest version, use the DescribeStream API.

", - "error":{"httpStatusCode":400}, - "exception":true - } - }, - "documentation":"

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/examples-1.json deleted file mode 100644 index feafe0b1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/examples-1.json +++ /dev/null @@ -1,815 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CancelKeyDeletion": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "output": { - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose deletion you are canceling. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - }, - "output": { - "KeyId": "The ARN of the CMK whose deletion you canceled." - } - }, - "description": "The following example cancels deletion of the specified CMK.", - "id": "to-cancel-deletion-of-a-cmk-1477428535102", - "title": "To cancel deletion of a customer master key (CMK)" - } - ], - "CreateAlias": [ - { - "input": { - "AliasName": "alias/ExampleAlias", - "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "AliasName": "The alias to create. Aliases must begin with 'alias/'. Do not use aliases that begin with 'alias/aws' because they are reserved for use by AWS.", - "TargetKeyId": "The identifier of the CMK whose alias you are creating. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example creates an alias for the specified customer master key (CMK).", - "id": "to-create-an-alias-1477505685119", - "title": "To create an alias" - } - ], - "CreateGrant": [ - { - "input": { - "GranteePrincipal": "arn:aws:iam::111122223333:role/ExampleRole", - "KeyId": "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "Encrypt", - "Decrypt" - ] - }, - "output": { - "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60", - "GrantToken": "AQpAM2RhZTk1MGMyNTk2ZmZmMzEyYWVhOWViN2I1MWM4Mzc0MWFiYjc0ZDE1ODkyNGFlNTIzODZhMzgyZjBlNGY3NiKIAgEBAgB4Pa6VDCWW__MSrqnre1HIN0Grt00ViSSuUjhqOC8OT3YAAADfMIHcBgkqhkiG9w0BBwaggc4wgcsCAQAwgcUGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMmqLyBTAegIn9XlK5AgEQgIGXZQjkBcl1dykDdqZBUQ6L1OfUivQy7JVYO2-ZJP7m6f1g8GzV47HX5phdtONAP7K_HQIflcgpkoCqd_fUnE114mSmiagWkbQ5sqAVV3ov-VeqgrvMe5ZFEWLMSluvBAqdjHEdMIkHMlhlj4ENZbzBfo9Wxk8b8SnwP4kc4gGivedzFXo-dwN8fxjjq_ZZ9JFOj2ijIbj5FyogDCN0drOfi8RORSEuCEmPvjFRMFAwcmwFkN2NPp89amA" - }, - "comments": { - "input": { - "GranteePrincipal": "The identity that is given permission to perform the operations specified in the grant.", - "KeyId": "The identifier of the CMK to which the grant applies. You can use the key ID or the Amazon Resource Name (ARN) of the CMK.", - "Operations": "A list of operations that the grant allows." - }, - "output": { - "GrantId": "The unique identifier of the grant.", - "GrantToken": "The grant token." - } - }, - "description": "The following example creates a grant that allows the specified IAM role to encrypt data with the specified customer master key (CMK).", - "id": "to-create-a-grant-1477972226782", - "title": "To create a grant" - } - ], - "CreateKey": [ - { - "output": { - "KeyMetadata": { - "AWSAccountId": "111122223333", - "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "CreationDate": "2016-11-01T10:15:42-07:00", - "Description": "", - "Enabled": true, - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "KeyState": "Enabled", - "KeyUsage": "ENCRYPT_DECRYPT", - "Origin": "AWS_KMS" - } - }, - "comments": { - "output": { - "KeyMetadata": "An object that contains information about the CMK created by this operation." - } - }, - "description": "The following example creates a CMK.", - "id": "to-create-a-cmk-1478028992966", - "title": "To create a customer master key (CMK)" - } - ], - "Decrypt": [ - { - "input": { - "CiphertextBlob": "" - }, - "output": { - "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Plaintext": "" - }, - "comments": { - "input": { - "CiphertextBlob": "The encrypted data (ciphertext)." - }, - "output": { - "KeyId": "The Amazon Resource Name (ARN) of the CMK that was used to decrypt the data.", - "Plaintext": "The decrypted (plaintext) data." - } - }, - "description": "The following example decrypts data that was encrypted with a customer master key (CMK) in AWS KMS.", - "id": "to-decrypt-data-1478281622886", - "title": "To decrypt data" - } - ], - "DeleteAlias": [ - { - "input": { - "AliasName": "alias/ExampleAlias" - }, - "comments": { - "input": { - "AliasName": "The alias to delete." - } - }, - "description": "The following example deletes the specified alias.", - "id": "to-delete-an-alias-1478285209338", - "title": "To delete an alias" - } - ], - "DeleteImportedKeyMaterial": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose imported key material you are deleting. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example deletes the imported key material from the specified customer master key (CMK).", - "id": "to-delete-imported-key-material-1478561674507", - "title": "To delete imported key material" - } - ], - "DescribeKey": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "output": { - "KeyMetadata": { - "AWSAccountId": "111122223333", - "Arn": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "CreationDate": "2015-10-12T11:45:07-07:00", - "Description": "", - "Enabled": true, - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "KeyState": "Enabled", - "KeyUsage": "ENCRYPT_DECRYPT", - "Origin": "AWS_KMS" - } - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK that you want information about. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - }, - "output": { - "KeyMetadata": "An object that contains information about the specified CMK." - } - }, - "description": "The following example returns information (metadata) about the specified CMK.", - "id": "to-obtain-information-about-a-cmk-1478565820907", - "title": "To obtain information about a customer master key (CMK)" - } - ], - "DisableKey": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to disable. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example disables the specified CMK.", - "id": "to-disable-a-cmk-1478566583659", - "title": "To disable a customer master key (CMK)" - } - ], - "DisableKeyRotation": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose key material will no longer be rotated. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example disables automatic annual rotation of the key material for the specified CMK.", - "id": "to-disable-automatic-rotation-of-key-material-1478624396092", - "title": "To disable automatic rotation of key material" - } - ], - "EnableKey": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to enable. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example enables the specified CMK.", - "id": "to-enable-a-cmk-1478627501129", - "title": "To enable a customer master key (CMK)" - } - ], - "EnableKeyRotation": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose key material will be rotated annually. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example enables automatic annual rotation of the key material for the specified CMK.", - "id": "to-enable-automatic-rotation-of-key-material-1478629109677", - "title": "To enable automatic rotation of key material" - } - ], - "Encrypt": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "Plaintext": "" - }, - "output": { - "CiphertextBlob": "", - "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to use for encryption. You can use the key ID or Amazon Resource Name (ARN) of the CMK, or the name or ARN of an alias that refers to the CMK.", - "Plaintext": "The data to encrypt." - }, - "output": { - "CiphertextBlob": "The encrypted data (ciphertext).", - "KeyId": "The ARN of the CMK that was used to encrypt the data." - } - }, - "description": "The following example encrypts data with the specified customer master key (CMK).", - "id": "to-encrypt-data-1478906026012", - "title": "To encrypt data" - } - ], - "GenerateDataKey": [ - { - "input": { - "KeyId": "alias/ExampleAlias", - "KeySpec": "AES_256" - }, - "output": { - "CiphertextBlob": "", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Plaintext": "" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to use to encrypt the data key. You can use the key ID or Amazon Resource Name (ARN) of the CMK, or the name or ARN of an alias that refers to the CMK.", - "KeySpec": "Specifies the type of data key to return." - }, - "output": { - "CiphertextBlob": "The encrypted data key.", - "KeyId": "The ARN of the CMK that was used to encrypt the data key.", - "Plaintext": "The unencrypted (plaintext) data key." - } - }, - "description": "The following example generates a 256-bit symmetric data encryption key (data key) in two formats. One is the unencrypted (plainext) data key, and the other is the data key encrypted with the specified customer master key (CMK).", - "id": "to-generate-a-data-key-1478912956062", - "title": "To generate a data key" - } - ], - "GenerateDataKeyWithoutPlaintext": [ - { - "input": { - "KeyId": "alias/ExampleAlias", - "KeySpec": "AES_256" - }, - "output": { - "CiphertextBlob": "", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to use to encrypt the data key. You can use the key ID or Amazon Resource Name (ARN) of the CMK, or the name or ARN of an alias that refers to the CMK.", - "KeySpec": "Specifies the type of data key to return." - }, - "output": { - "CiphertextBlob": "The encrypted data key.", - "KeyId": "The ARN of the CMK that was used to encrypt the data key." - } - }, - "description": "The following example generates an encrypted copy of a 256-bit symmetric data encryption key (data key). The data key is encrypted with the specified customer master key (CMK).", - "id": "to-generate-an-encrypted-data-key-1478914121134", - "title": "To generate an encrypted data key" - } - ], - "GenerateRandom": [ - { - "input": { - "NumberOfBytes": 32 - }, - "output": { - "Plaintext": "" - }, - "comments": { - "input": { - "NumberOfBytes": "The length of the random data, specified in number of bytes." - }, - "output": { - "Plaintext": "The random data." - } - }, - "description": "The following example uses AWS KMS to generate 32 bytes of random data.", - "id": "to-generate-random-data-1479163645600", - "title": "To generate random data" - } - ], - "GetKeyPolicy": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "PolicyName": "default" - }, - "output": { - "Policy": "{\n \"Version\" : \"2012-10-17\",\n \"Id\" : \"key-default-1\",\n \"Statement\" : [ {\n \"Sid\" : \"Enable IAM User Permissions\",\n \"Effect\" : \"Allow\",\n \"Principal\" : {\n \"AWS\" : \"arn:aws:iam::111122223333:root\"\n },\n \"Action\" : \"kms:*\",\n \"Resource\" : \"*\"\n } ]\n}" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose key policy you want to retrieve. You can use the key ID or the Amazon Resource Name (ARN) of the CMK.", - "PolicyName": "The name of the key policy to retrieve." - }, - "output": { - "Policy": "The key policy document." - } - }, - "description": "The following example retrieves the key policy for the specified customer master key (CMK).", - "id": "to-retrieve-a-key-policy-1479170128325", - "title": "To retrieve a key policy" - } - ], - "GetKeyRotationStatus": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "output": { - "KeyRotationEnabled": true - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose key material rotation status you want to retrieve. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - }, - "output": { - "KeyRotationEnabled": "A boolean that indicates the key material rotation status. Returns true when automatic annual rotation of the key material is enabled, or false when it is not." - } - }, - "description": "The following example retrieves the status of automatic annual rotation of the key material for the specified CMK.", - "id": "to-retrieve-the-rotation-status-for-a-cmk-1479172287408", - "title": "To retrieve the rotation status for a customer master key (CMK)" - } - ], - "GetParametersForImport": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "WrappingAlgorithm": "RSAES_OAEP_SHA_1", - "WrappingKeySpec": "RSA_2048" - }, - "output": { - "ImportToken": "", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "ParametersValidTo": "2016-12-01T14:52:17-08:00", - "PublicKey": "" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK for which to retrieve the public key and import token. You can use the key ID or the Amazon Resource Name (ARN) of the CMK.", - "WrappingAlgorithm": "The algorithm that you will use to encrypt the key material before importing it.", - "WrappingKeySpec": "The type of wrapping key (public key) to return in the response." - }, - "output": { - "ImportToken": "The import token to send with a subsequent ImportKeyMaterial request.", - "KeyId": "The ARN of the CMK for which you are retrieving the public key and import token. This is the same CMK specified in the request.", - "ParametersValidTo": "The time at which the import token and public key are no longer valid.", - "PublicKey": "The public key to use to encrypt the key material before importing it." - } - }, - "description": "The following example retrieves the public key and import token for the specified CMK.", - "id": "to-retrieve-the-public-key-and-import-token-for-a-cmk-1480626483211", - "title": "To retrieve the public key and import token for a customer master key (CMK)" - } - ], - "ImportKeyMaterial": [ - { - "input": { - "EncryptedKeyMaterial": "", - "ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE", - "ImportToken": "", - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "EncryptedKeyMaterial": "The encrypted key material to import.", - "ExpirationModel": "A value that specifies whether the key material expires.", - "ImportToken": "The import token that you received in the response to a previous GetParametersForImport request.", - "KeyId": "The identifier of the CMK to import the key material into. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example imports key material into the specified CMK.", - "id": "to-import-key-material-into-a-cmk-1480630551969", - "title": "To import key material into a customer master key (CMK)" - } - ], - "ListAliases": [ - { - "output": { - "Aliases": [ - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/acm", - "AliasName": "alias/aws/acm", - "TargetKeyId": "da03f6f7-d279-427a-9cae-de48d07e5b66" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/ebs", - "AliasName": "alias/aws/ebs", - "TargetKeyId": "25a217e7-7170-4b8c-8bf6-045ea5f70e5b" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/rds", - "AliasName": "alias/aws/rds", - "TargetKeyId": "7ec3104e-c3f2-4b5c-bf42-bfc4772c6685" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/redshift", - "AliasName": "alias/aws/redshift", - "TargetKeyId": "08f7a25a-69e2-4fb5-8f10-393db27326fa" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/s3", - "AliasName": "alias/aws/s3", - "TargetKeyId": "d2b0f1a3-580d-4f79-b836-bc983be8cfa5" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example1", - "AliasName": "alias/example1", - "TargetKeyId": "4da1e216-62d0-46c5-a7c0-5f3a3d2f8046" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example2", - "AliasName": "alias/example2", - "TargetKeyId": "f32fef59-2cc2-445b-8573-2d73328acbee" - }, - { - "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example3", - "AliasName": "alias/example3", - "TargetKeyId": "1374ef38-d34e-4d5f-b2c9-4e0daee38855" - } - ], - "Truncated": false - }, - "comments": { - "output": { - "Aliases": "A list of aliases, including the key ID of the customer master key (CMK) that each alias refers to.", - "Truncated": "A boolean that indicates whether there are more items in the list. Returns true when there are more items, or false when there are not." - } - }, - "description": "The following example lists aliases.", - "id": "to-list-aliases-1480729693349", - "title": "To list aliases" - } - ], - "ListGrants": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "output": { - "Grants": [ - { - "CreationDate": "2016-10-25T14:37:41-07:00", - "GrantId": "91ad875e49b04a9d1f3bdeb84d821f9db6ea95e1098813f6d47f0c65fbe2a172", - "GranteePrincipal": "acm.us-east-2.amazonaws.com", - "IssuingAccount": "arn:aws:iam::111122223333:root", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "Encrypt", - "ReEncryptFrom", - "ReEncryptTo" - ], - "RetiringPrincipal": "acm.us-east-2.amazonaws.com" - }, - { - "CreationDate": "2016-10-25T14:37:41-07:00", - "GrantId": "a5d67d3e207a8fc1f4928749ee3e52eb0440493a8b9cf05bbfad91655b056200", - "GranteePrincipal": "acm.us-east-2.amazonaws.com", - "IssuingAccount": "arn:aws:iam::111122223333:root", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "ReEncryptFrom", - "ReEncryptTo" - ], - "RetiringPrincipal": "acm.us-east-2.amazonaws.com" - }, - { - "CreationDate": "2016-10-25T14:37:41-07:00", - "GrantId": "c541aaf05d90cb78846a73b346fc43e65be28b7163129488c738e0c9e0628f4f", - "GranteePrincipal": "acm.us-east-2.amazonaws.com", - "IssuingAccount": "arn:aws:iam::111122223333:root", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "Encrypt", - "ReEncryptFrom", - "ReEncryptTo" - ], - "RetiringPrincipal": "acm.us-east-2.amazonaws.com" - }, - { - "CreationDate": "2016-10-25T14:37:41-07:00", - "GrantId": "dd2052c67b4c76ee45caf1dc6a1e2d24e8dc744a51b36ae2f067dc540ce0105c", - "GranteePrincipal": "acm.us-east-2.amazonaws.com", - "IssuingAccount": "arn:aws:iam::111122223333:root", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "Encrypt", - "ReEncryptFrom", - "ReEncryptTo" - ], - "RetiringPrincipal": "acm.us-east-2.amazonaws.com" - } - ], - "Truncated": true - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose grants you want to list. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - }, - "output": { - "Grants": "A list of grants.", - "Truncated": "A boolean that indicates whether there are more items in the list. Returns true when there are more items, or false when there are not." - } - }, - "description": "The following example lists grants for the specified CMK.", - "id": "to-list-grants-for-a-cmk-1481067365389", - "title": "To list grants for a customer master key (CMK)" - } - ], - "ListKeyPolicies": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "output": { - "PolicyNames": [ - "default" - ], - "Truncated": false - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK whose key policies you want to list. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - }, - "output": { - "PolicyNames": "A list of key policy names.", - "Truncated": "A boolean that indicates whether there are more items in the list. Returns true when there are more items, or false when there are not." - } - }, - "description": "The following example lists key policies for the specified CMK.", - "id": "to-list-key-policies-for-a-cmk-1481069780998", - "title": "To list key policies for a customer master key (CMK)" - } - ], - "ListKeys": [ - { - "output": { - "Keys": [ - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/0d990263-018e-4e65-a703-eff731de951e", - "KeyId": "0d990263-018e-4e65-a703-eff731de951e" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/144be297-0ae1-44ac-9c8f-93cd8c82f841", - "KeyId": "144be297-0ae1-44ac-9c8f-93cd8c82f841" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/21184251-b765-428e-b852-2c7353e72571", - "KeyId": "21184251-b765-428e-b852-2c7353e72571" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/214fe92f-5b03-4ae1-b350-db2a45dbe10c", - "KeyId": "214fe92f-5b03-4ae1-b350-db2a45dbe10c" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/339963f2-e523-49d3-af24-a0fe752aa458", - "KeyId": "339963f2-e523-49d3-af24-a0fe752aa458" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/b776a44b-df37-4438-9be4-a27494e4271a", - "KeyId": "b776a44b-df37-4438-9be4-a27494e4271a" - }, - { - "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb", - "KeyId": "deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb" - } - ], - "Truncated": false - }, - "comments": { - "output": { - "Keys": "A list of CMKs, including the key ID and Amazon Resource Name (ARN) of each one.", - "Truncated": "A boolean that indicates whether there are more items in the list. Returns true when there are more items, or false when there are not." - } - }, - "description": "The following example lists CMKs.", - "id": "to-list-cmks-1481071643069", - "title": "To list customer master keys (CMKs)" - } - ], - "ListRetirableGrants": [ - { - "input": { - "RetiringPrincipal": "arn:aws:iam::111122223333:role/ExampleRole" - }, - "output": { - "Grants": [ - { - "CreationDate": "2016-12-07T11:09:35-08:00", - "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60", - "GranteePrincipal": "arn:aws:iam::111122223333:role/ExampleRole", - "IssuingAccount": "arn:aws:iam::444455556666:root", - "KeyId": "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab", - "Operations": [ - "Decrypt", - "Encrypt" - ], - "RetiringPrincipal": "arn:aws:iam::111122223333:role/ExampleRole" - } - ], - "Truncated": false - }, - "comments": { - "input": { - "RetiringPrincipal": "The retiring principal whose grants you want to list. Use the Amazon Resource Name (ARN) of an AWS principal such as an AWS account (root), IAM user, federated user, or assumed role user." - }, - "output": { - "Grants": "A list of grants that the specified principal can retire.", - "Truncated": "A boolean that indicates whether there are more items in the list. Returns true when there are more items, or false when there are not." - } - }, - "description": "The following example lists the grants that the specified principal (identity) can retire.", - "id": "to-list-grants-that-the-specified-principal-can-retire-1481140499620", - "title": "To list grants that the specified principal can retire" - } - ], - "PutKeyPolicy": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "Policy": "{\n \"Version\": \"2012-10-17\",\n \"Id\": \"custom-policy-2016-12-07\",\n \"Statement\": [\n {\n \"Sid\": \"Enable IAM User Permissions\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"AWS\": \"arn:aws:iam::111122223333:root\"\n },\n \"Action\": \"kms:*\",\n \"Resource\": \"*\"\n },\n {\n \"Sid\": \"Allow access for Key Administrators\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"AWS\": [\n \"arn:aws:iam::111122223333:user/ExampleAdminUser\",\n \"arn:aws:iam::111122223333:role/ExampleAdminRole\"\n ]\n },\n \"Action\": [\n \"kms:Create*\",\n \"kms:Describe*\",\n \"kms:Enable*\",\n \"kms:List*\",\n \"kms:Put*\",\n \"kms:Update*\",\n \"kms:Revoke*\",\n \"kms:Disable*\",\n \"kms:Get*\",\n \"kms:Delete*\",\n \"kms:ScheduleKeyDeletion\",\n \"kms:CancelKeyDeletion\"\n ],\n \"Resource\": \"*\"\n },\n {\n \"Sid\": \"Allow use of the key\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"AWS\": \"arn:aws:iam::111122223333:role/ExamplePowerUserRole\"\n },\n \"Action\": [\n \"kms:Encrypt\",\n \"kms:Decrypt\",\n \"kms:ReEncrypt*\",\n \"kms:GenerateDataKey*\",\n \"kms:DescribeKey\"\n ],\n \"Resource\": \"*\"\n },\n {\n \"Sid\": \"Allow attachment of persistent resources\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"AWS\": \"arn:aws:iam::111122223333:role/ExamplePowerUserRole\"\n },\n \"Action\": [\n \"kms:CreateGrant\",\n \"kms:ListGrants\",\n \"kms:RevokeGrant\"\n ],\n \"Resource\": \"*\",\n \"Condition\": {\n \"Bool\": {\n \"kms:GrantIsForAWSResource\": \"true\"\n }\n }\n }\n ]\n}\n", - "PolicyName": "default" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to attach the key policy to. You can use the key ID or the Amazon Resource Name (ARN) of the CMK.", - "Policy": "The key policy document.", - "PolicyName": "The name of the key policy." - } - }, - "description": "The following example attaches a key policy to the specified CMK.", - "id": "to-attach-a-key-policy-to-a-cmk-1481147345018", - "title": "To attach a key policy to a customer master key (CMK)" - } - ], - "ReEncrypt": [ - { - "input": { - "CiphertextBlob": "", - "DestinationKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321" - }, - "output": { - "CiphertextBlob": "", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321", - "SourceKeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "CiphertextBlob": "The data to reencrypt.", - "DestinationKeyId": "The identifier of the CMK to use to reencrypt the data. You can use the key ID or Amazon Resource Name (ARN) of the CMK, or the name or ARN of an alias that refers to the CMK." - }, - "output": { - "CiphertextBlob": "The reencrypted data.", - "KeyId": "The ARN of the CMK that was used to reencrypt the data.", - "SourceKeyId": "The ARN of the CMK that was used to originally encrypt the data." - } - }, - "description": "The following example reencrypts data with the specified CMK.", - "id": "to-reencrypt-data-1481230358001", - "title": "To reencrypt data" - } - ], - "RetireGrant": [ - { - "input": { - "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60", - "KeyId": "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "GrantId": "The identifier of the grant to retire.", - "KeyId": "The Amazon Resource Name (ARN) of the customer master key (CMK) associated with the grant." - } - }, - "description": "The following example retires a grant.", - "id": "to-retire-a-grant-1481327028297", - "title": "To retire a grant" - } - ], - "RevokeGrant": [ - { - "input": { - "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60", - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "GrantId": "The identifier of the grant to revoke.", - "KeyId": "The identifier of the customer master key (CMK) associated with the grant. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example revokes a grant.", - "id": "to-revoke-a-grant-1481329549302", - "title": "To revoke a grant" - } - ], - "ScheduleKeyDeletion": [ - { - "input": { - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", - "PendingWindowInDays": 7 - }, - "output": { - "DeletionDate": "2016-12-17T16:00:00-08:00", - "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "KeyId": "The identifier of the CMK to schedule for deletion. You can use the key ID or the Amazon Resource Name (ARN) of the CMK.", - "PendingWindowInDays": "The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the CMK." - }, - "output": { - "DeletionDate": "The date and time after which AWS KMS deletes the CMK.", - "KeyId": "The ARN of the CMK that is scheduled for deletion." - } - }, - "description": "The following example schedules the specified CMK for deletion.", - "id": "to-schedule-a-cmk-for-deletion-1481331111094", - "title": "To schedule a customer master key (CMK) for deletion" - } - ], - "UpdateAlias": [ - { - "input": { - "AliasName": "alias/ExampleAlias", - "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "AliasName": "The alias to update.", - "TargetKeyId": "The identifier of the CMK that the alias will refer to after this operation succeeds. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example updates the specified alias to refer to the specified customer master key (CMK).", - "id": "to-update-an-alias-1481572726920", - "title": "To update an alias" - } - ], - "UpdateKeyDescription": [ - { - "input": { - "Description": "Example description that indicates the intended use of this CMK.", - "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab" - }, - "comments": { - "input": { - "Description": "The updated description.", - "KeyId": "The identifier of the CMK whose description you are updating. You can use the key ID or the Amazon Resource Name (ARN) of the CMK." - } - }, - "description": "The following example updates the description of the specified CMK.", - "id": "to-update-the-description-of-a-cmk-1481574808619", - "title": "To update the description of a customer master key (CMK)" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/paginators-1.json deleted file mode 100644 index 522d171f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/paginators-1.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "pagination": { - "ListAliases": { - "limit_key": "Limit", - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "Truncated", - "result_key": "Aliases" - }, - "ListGrants": { - "limit_key": "Limit", - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "Truncated", - "result_key": "Grants" - }, - "ListKeyPolicies": { - "limit_key": "Limit", - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "Truncated", - "result_key": "PolicyNames" - }, - "ListKeys": { - "limit_key": "Limit", - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "Truncated", - "result_key": "Keys" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/service-2.json deleted file mode 100644 index 3fcccccd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/kms/2014-11-01/service-2.json +++ /dev/null @@ -1,2065 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-11-01", - "endpointPrefix":"kms", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"KMS", - "serviceFullName":"AWS Key Management Service", - "serviceId":"KMS", - "signatureVersion":"v4", - "targetPrefix":"TrentService", - "uid":"kms-2014-11-01" - }, - "operations":{ - "CancelKeyDeletion":{ - "name":"CancelKeyDeletion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelKeyDeletionRequest"}, - "output":{"shape":"CancelKeyDeletionResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Cancels the deletion of a customer master key (CMK). When this operation is successful, the CMK is set to the Disabled state. To enable a CMK, use EnableKey. You cannot perform this operation on a CMK in a different AWS account.

For more information about scheduling and canceling deletion of a CMK, see Deleting Customer Master Keys in the AWS Key Management Service Developer Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "CreateAlias":{ - "name":"CreateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAliasRequest"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidAliasNameException"}, - {"shape":"KMSInternalException"}, - {"shape":"LimitExceededException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Creates a display name for a customer-managed customer master key (CMK). You can use an alias to identify a CMK in selected operations, such as Encrypt and GenerateDataKey.

Each CMK can have multiple aliases, but each alias points to only one CMK. The alias name must be unique in the AWS account and region. To simplify code that runs in multiple regions, use the same alias name, but point it to a different CMK in each region.

Because an alias is not a property of a CMK, you can delete and change the aliases of a CMK without affecting the CMK. Also, aliases do not appear in the response from the DescribeKey operation. To get the aliases of all CMKs, use the ListAliases operation.

The alias name can contain only alphanumeric characters, forward slashes (/), underscores (_), and dashes (-). Alias names cannot begin with aws/. That alias name prefix is reserved for AWS managed CMKs.

The alias and the CMK it is mapped to must be in the same AWS account and the same region. You cannot perform this operation on an alias in a different AWS account.

To map an existing alias to a different CMK, call UpdateAlias.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "CreateGrant":{ - "name":"CreateGrant", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGrantRequest"}, - "output":{"shape":"CreateGrantResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidArnException"}, - {"shape":"KMSInternalException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"LimitExceededException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Adds a grant to a customer master key (CMK). The grant specifies who can use the CMK and under what conditions. When setting permissions, grants are an alternative to key policies.

To perform this operation on a CMK in a different AWS account, specify the key ARN in the value of the KeyId parameter. For more information about grants, see Grants in the AWS Key Management Service Developer Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "CreateKey":{ - "name":"CreateKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyRequest"}, - "output":{"shape":"CreateKeyResponse"}, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidArnException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"KMSInternalException"}, - {"shape":"LimitExceededException"}, - {"shape":"TagException"} - ], - "documentation":"

Creates a customer master key (CMK) in the caller's AWS account.

You can use a CMK to encrypt small amounts of data (4 KiB or less) directly. But CMKs are more commonly used to encrypt data encryption keys (DEKs), which are used to encrypt raw data. For more information about DEKs and the difference between CMKs and DEKs, see the following:

You cannot use this operation to create a CMK in a different AWS account.

" - }, - "Decrypt":{ - "name":"Decrypt", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DecryptRequest"}, - "output":{"shape":"DecryptResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"InvalidCiphertextException"}, - {"shape":"KeyUnavailableException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Decrypts ciphertext. Ciphertext is plaintext that has been previously encrypted by using any of the following operations:

Whenever possible, use key policies to give users permission to call the Decrypt operation on the CMK, instead of IAM policies. Otherwise, you might create an IAM user policy that gives the user Decrypt permission on all CMKs. This user could decrypt ciphertext that was encrypted by CMKs in other accounts if the key policy for the cross-account CMK permits it. If you must use an IAM policy for Decrypt permissions, limit the user to particular CMKs or particular trusted accounts.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "DeleteAlias":{ - "name":"DeleteAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAliasRequest"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Deletes the specified alias. You cannot perform this operation on an alias in a different AWS account.

Because an alias is not a property of a CMK, you can delete and change the aliases of a CMK without affecting the CMK. Also, aliases do not appear in the response from the DescribeKey operation. To get the aliases of all CMKs, use the ListAliases operation.

Each CMK can have multiple aliases. To change the alias of a CMK, use DeleteAlias to delete the current alias and CreateAlias to create a new alias. To associate an existing alias with a different customer master key (CMK), call UpdateAlias.

" - }, - "DeleteImportedKeyMaterial":{ - "name":"DeleteImportedKeyMaterial", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteImportedKeyMaterialRequest"}, - "errors":[ - {"shape":"InvalidArnException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Deletes key material that you previously imported. This operation makes the specified customer master key (CMK) unusable. For more information about importing key material into AWS KMS, see Importing Key Material in the AWS Key Management Service Developer Guide. You cannot perform this operation on a CMK in a different AWS account.

When the specified CMK is in the PendingDeletion state, this operation does not change the CMK's state. Otherwise, it changes the CMK's state to PendingImport.

After you delete key material, you can use ImportKeyMaterial to reimport the same key material into the CMK.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "DescribeKey":{ - "name":"DescribeKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeKeyRequest"}, - "output":{"shape":"DescribeKeyResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"} - ], - "documentation":"

Provides detailed information about the specified customer master key (CMK).

You can use DescribeKey on a predefined AWS alias, that is, an AWS alias with no key ID. When you do, AWS KMS associates the alias with an AWS managed CMK and returns its KeyId and Arn in the response.

To perform this operation on a CMK in a different AWS account, specify the key ARN or alias ARN in the value of the KeyId parameter.

" - }, - "DisableKey":{ - "name":"DisableKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableKeyRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Sets the state of a customer master key (CMK) to disabled, thereby preventing its use for cryptographic operations. You cannot perform this operation on a CMK in a different AWS account.

For more information about how key state affects the use of a CMK, see How Key State Affects the Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "DisableKeyRotation":{ - "name":"DisableKeyRotation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableKeyRotationRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Disables automatic rotation of the key material for the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "EnableKey":{ - "name":"EnableKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableKeyRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"LimitExceededException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Sets the state of a customer master key (CMK) to enabled, thereby permitting its use for cryptographic operations. You cannot perform this operation on a CMK in a different AWS account.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "EnableKeyRotation":{ - "name":"EnableKeyRotation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableKeyRotationRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Enables automatic rotation of the key material for the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "Encrypt":{ - "name":"Encrypt", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EncryptRequest"}, - "output":{"shape":"EncryptResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"KeyUnavailableException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidKeyUsageException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Encrypts plaintext into ciphertext by using a customer master key (CMK). The Encrypt operation has two primary use cases:

  • You can encrypt up to 4 kilobytes (4096 bytes) of arbitrary data such as an RSA key, a database password, or other sensitive information.

  • You can use the Encrypt operation to move encrypted data from one AWS region to another. In the first region, generate a data key and use the plaintext key to encrypt the data. Then, in the new region, call the Encrypt method on same plaintext data key. Now, you can safely move the encrypted data and encrypted data key to the new region, and decrypt in the new region when necessary.

You don't need use this operation to encrypt a data key within a region. The GenerateDataKey and GenerateDataKeyWithoutPlaintext operations return an encrypted data key.

Also, you don't need to use this operation to encrypt data in your application. You can use the plaintext and encrypted data keys that the GenerateDataKey operation returns.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

To perform this operation on a CMK in a different AWS account, specify the key ARN or alias ARN in the value of the KeyId parameter.

" - }, - "GenerateDataKey":{ - "name":"GenerateDataKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GenerateDataKeyRequest"}, - "output":{"shape":"GenerateDataKeyResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"KeyUnavailableException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidKeyUsageException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Returns a data encryption key that you can use in your application to encrypt data locally.

You must specify the customer master key (CMK) under which to generate the data key. You must also specify the length of the data key using either the KeySpec or NumberOfBytes field. You must specify one field or the other, but not both. For common key lengths (128-bit and 256-bit symmetric keys), we recommend that you use KeySpec. To perform this operation on a CMK in a different AWS account, specify the key ARN or alias ARN in the value of the KeyId parameter.

This operation returns a plaintext copy of the data key in the Plaintext field of the response, and an encrypted copy of the data key in the CiphertextBlob field. The data key is encrypted under the CMK specified in the KeyId field of the request.

We recommend that you use the following pattern to encrypt data locally in your application:

  1. Use this operation (GenerateDataKey) to get a data encryption key.

  2. Use the plaintext data encryption key (returned in the Plaintext field of the response) to encrypt data locally, then erase the plaintext data key from memory.

  3. Store the encrypted data key (returned in the CiphertextBlob field of the response) alongside the locally encrypted data.

To decrypt data locally:

  1. Use the Decrypt operation to decrypt the encrypted data key into a plaintext copy of the data key.

  2. Use the plaintext data key to decrypt data locally, then erase the plaintext data key from memory.

To return only an encrypted copy of the data key, use GenerateDataKeyWithoutPlaintext. To return a random byte string that is cryptographically secure, use GenerateRandom.

If you use the optional EncryptionContext field, you must store at least enough information to be able to reconstruct the full encryption context when you later send the ciphertext to the Decrypt operation. It is a good practice to choose an encryption context that you can reconstruct on the fly to better secure the ciphertext. For more information, see Encryption Context in the AWS Key Management Service Developer Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "GenerateDataKeyWithoutPlaintext":{ - "name":"GenerateDataKeyWithoutPlaintext", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GenerateDataKeyWithoutPlaintextRequest"}, - "output":{"shape":"GenerateDataKeyWithoutPlaintextResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"KeyUnavailableException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidKeyUsageException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Returns a data encryption key encrypted under a customer master key (CMK). This operation is identical to GenerateDataKey but returns only the encrypted copy of the data key.

To perform this operation on a CMK in a different AWS account, specify the key ARN or alias ARN in the value of the KeyId parameter.

This operation is useful in a system that has multiple components with different degrees of trust. For example, consider a system that stores encrypted data in containers. Each container stores the encrypted data and an encrypted copy of the data key. One component of the system, called the control plane, creates new containers. When it creates a new container, it uses this operation (GenerateDataKeyWithoutPlaintext) to get an encrypted data key and then stores it in the container. Later, a different component of the system, called the data plane, puts encrypted data into the containers. To do this, it passes the encrypted data key to the Decrypt operation. It then uses the returned plaintext data key to encrypt data and finally stores the encrypted data in the container. In this system, the control plane never sees the plaintext data key.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "GenerateRandom":{ - "name":"GenerateRandom", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GenerateRandomRequest"}, - "output":{"shape":"GenerateRandomResponse"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"} - ], - "documentation":"

Returns a random byte string that is cryptographically secure.

For more information about entropy and random number generation, see the AWS Key Management Service Cryptographic Details whitepaper.

" - }, - "GetKeyPolicy":{ - "name":"GetKeyPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetKeyPolicyRequest"}, - "output":{"shape":"GetKeyPolicyResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Gets a key policy attached to the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

" - }, - "GetKeyRotationStatus":{ - "name":"GetKeyRotationStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetKeyRotationStatusRequest"}, - "output":{"shape":"GetKeyRotationStatusResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Gets a Boolean value that indicates whether automatic rotation of the key material is enabled for the specified customer master key (CMK).

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

  • Disabled: The key rotation status does not change when you disable a CMK. However, while the CMK is disabled, AWS KMS does not rotate the backing key.

  • Pending deletion: While a CMK is pending deletion, its key rotation status is false and AWS KMS does not rotate the backing key. If you cancel the deletion, the original key rotation status is restored.

To perform this operation on a CMK in a different AWS account, specify the key ARN in the value of the KeyId parameter.

" - }, - "GetParametersForImport":{ - "name":"GetParametersForImport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetParametersForImportRequest"}, - "output":{"shape":"GetParametersForImportResponse"}, - "errors":[ - {"shape":"InvalidArnException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Returns the items you need in order to import key material into AWS KMS from your existing key management infrastructure. For more information about importing key material into AWS KMS, see Importing Key Material in the AWS Key Management Service Developer Guide.

You must specify the key ID of the customer master key (CMK) into which you will import key material. This CMK's Origin must be EXTERNAL. You must also specify the wrapping algorithm and type of wrapping key (public key) that you will use to encrypt the key material. You cannot perform this operation on a CMK in a different AWS account.

This operation returns a public key and an import token. Use the public key to encrypt the key material. Store the import token to send with a subsequent ImportKeyMaterial request. The public key and import token from the same response must be used together. These items are valid for 24 hours. When they expire, they cannot be used for a subsequent ImportKeyMaterial request. To get new ones, send another GetParametersForImport request.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "ImportKeyMaterial":{ - "name":"ImportKeyMaterial", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyMaterialRequest"}, - "output":{"shape":"ImportKeyMaterialResponse"}, - "errors":[ - {"shape":"InvalidArnException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"InvalidCiphertextException"}, - {"shape":"IncorrectKeyMaterialException"}, - {"shape":"ExpiredImportTokenException"}, - {"shape":"InvalidImportTokenException"} - ], - "documentation":"

Imports key material into an existing AWS KMS customer master key (CMK) that was created without key material. You cannot perform this operation on a CMK in a different AWS account. For more information about creating CMKs with no key material and then importing key material, see Importing Key Material in the AWS Key Management Service Developer Guide.

Before using this operation, call GetParametersForImport. Its response includes a public key and an import token. Use the public key to encrypt the key material. Then, submit the import token from the same GetParametersForImport response.

When calling this operation, you must specify the following values:

  • The key ID or key ARN of a CMK with no key material. Its Origin must be EXTERNAL.

    To create a CMK with no key material, call CreateKey and set the value of its Origin parameter to EXTERNAL. To get the Origin of a CMK, call DescribeKey.)

  • The encrypted key material. To get the public key to encrypt the key material, call GetParametersForImport.

  • The import token that GetParametersForImport returned. This token and the public key used to encrypt the key material must have come from the same response.

  • Whether the key material expires and if so, when. If you set an expiration date, you can change it only by reimporting the same key material and specifying a new expiration date. If the key material expires, AWS KMS deletes the key material and the CMK becomes unusable. To use the CMK again, you must reimport the same key material.

When this operation is successful, the CMK's key state changes from PendingImport to Enabled, and you can use the CMK. After you successfully import key material into a CMK, you can reimport the same key material into that CMK, but you cannot import different key material.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "ListAliases":{ - "name":"ListAliases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAliasesRequest"}, - "output":{"shape":"ListAliasesResponse"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidMarkerException"}, - {"shape":"KMSInternalException"} - ], - "documentation":"

Gets a list of aliases in the caller's AWS account and region. You cannot list aliases in other accounts. For more information about aliases, see CreateAlias.

By default, the ListAliases command returns all aliases in the account and region. To get only the aliases that point to a particular customer master key (CMK), use the KeyId parameter.

The ListAliases response can include aliases that you created and associated with your customer managed CMKs, and aliases that AWS created and associated with AWS managed CMKs in your account. You can recognize AWS aliases because their names have the format aws/<service-name>, such as aws/dynamodb.

The response might also include aliases that have no TargetKeyId field. These are predefined aliases that AWS has created but has not yet associated with a CMK. Aliases that AWS creates in your account, including predefined aliases, do not count against your AWS KMS aliases limit.

" - }, - "ListGrants":{ - "name":"ListGrants", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGrantsRequest"}, - "output":{"shape":"ListGrantsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidMarkerException"}, - {"shape":"InvalidArnException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Gets a list of all grants for the specified customer master key (CMK).

To perform this operation on a CMK in a different AWS account, specify the key ARN in the value of the KeyId parameter.

" - }, - "ListKeyPolicies":{ - "name":"ListKeyPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListKeyPoliciesRequest"}, - "output":{"shape":"ListKeyPoliciesResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Gets the names of the key policies that are attached to a customer master key (CMK). This operation is designed to get policy names that you can use in a GetKeyPolicy operation. However, the only valid policy name is default. You cannot perform this operation on a CMK in a different AWS account.

" - }, - "ListKeys":{ - "name":"ListKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListKeysRequest"}, - "output":{"shape":"ListKeysResponse"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"InvalidMarkerException"} - ], - "documentation":"

Gets a list of all customer master keys (CMKs) in the caller's AWS account and region.

" - }, - "ListResourceTags":{ - "name":"ListResourceTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourceTagsRequest"}, - "output":{"shape":"ListResourceTagsResponse"}, - "errors":[ - {"shape":"KMSInternalException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidMarkerException"} - ], - "documentation":"

Returns a list of all tags for the specified customer master key (CMK).

You cannot perform this operation on a CMK in a different AWS account.

" - }, - "ListRetirableGrants":{ - "name":"ListRetirableGrants", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRetirableGrantsRequest"}, - "output":{"shape":"ListGrantsResponse"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidMarkerException"}, - {"shape":"InvalidArnException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"} - ], - "documentation":"

Returns a list of all grants for which the grant's RetiringPrincipal matches the one specified.

A typical use is to list all grants that you are able to retire. To retire a grant, use RetireGrant.

" - }, - "PutKeyPolicy":{ - "name":"PutKeyPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutKeyPolicyRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"UnsupportedOperationException"}, - {"shape":"KMSInternalException"}, - {"shape":"LimitExceededException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Attaches a key policy to the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

For more information about key policies, see Key Policies in the AWS Key Management Service Developer Guide.

" - }, - "ReEncrypt":{ - "name":"ReEncrypt", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReEncryptRequest"}, - "output":{"shape":"ReEncryptResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DisabledException"}, - {"shape":"InvalidCiphertextException"}, - {"shape":"KeyUnavailableException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidKeyUsageException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Encrypts data on the server side with a new customer master key (CMK) without exposing the plaintext of the data on the client side. The data is first decrypted and then reencrypted. You can also use this operation to change the encryption context of a ciphertext.

You can reencrypt data using CMKs in different AWS accounts.

Unlike other operations, ReEncrypt is authorized twice, once as ReEncryptFrom on the source CMK and once as ReEncryptTo on the destination CMK. We recommend that you include the \"kms:ReEncrypt*\" permission in your key policies to permit reencryption from or to the CMK. This permission is automatically included in the key policy when you create a CMK through the console. But you must include it manually when you create a CMK programmatically or when you set a key policy with the PutKeyPolicy operation.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "RetireGrant":{ - "name":"RetireGrant", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetireGrantRequest"}, - "errors":[ - {"shape":"InvalidArnException"}, - {"shape":"InvalidGrantTokenException"}, - {"shape":"InvalidGrantIdException"}, - {"shape":"NotFoundException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Retires a grant. To clean up, you can retire a grant when you're done using it. You should revoke a grant when you intend to actively deny operations that depend on it. The following are permitted to call this API:

  • The AWS account (root user) under which the grant was created

  • The RetiringPrincipal, if present in the grant

  • The GranteePrincipal, if RetireGrant is an operation specified in the grant

You must identify the grant to retire by its grant token or by a combination of the grant ID and the Amazon Resource Name (ARN) of the customer master key (CMK). A grant token is a unique variable-length base64-encoded string. A grant ID is a 64 character unique identifier of a grant. The CreateGrant operation returns both.

" - }, - "RevokeGrant":{ - "name":"RevokeGrant", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeGrantRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"InvalidArnException"}, - {"shape":"InvalidGrantIdException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Revokes the specified grant for the specified customer master key (CMK). You can revoke a grant to actively deny operations that depend on it.

To perform this operation on a CMK in a different AWS account, specify the key ARN in the value of the KeyId parameter.

" - }, - "ScheduleKeyDeletion":{ - "name":"ScheduleKeyDeletion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScheduleKeyDeletionRequest"}, - "output":{"shape":"ScheduleKeyDeletionResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Schedules the deletion of a customer master key (CMK). You may provide a waiting period, specified in days, before deletion occurs. If you do not provide a waiting period, the default period of 30 days is used. When this operation is successful, the state of the CMK changes to PendingDeletion. Before the waiting period ends, you can use CancelKeyDeletion to cancel the deletion of the CMK. After the waiting period ends, AWS KMS deletes the CMK and all AWS KMS data associated with it, including all aliases that refer to it.

You cannot perform this operation on a CMK in a different AWS account.

Deleting a CMK is a destructive and potentially dangerous operation. When a CMK is deleted, all data that was encrypted under the CMK is rendered unrecoverable. To restrict the use of a CMK without deleting it, use DisableKey.

For more information about scheduling a CMK for deletion, see Deleting Customer Master Keys in the AWS Key Management Service Developer Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"KMSInternalException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"LimitExceededException"}, - {"shape":"TagException"} - ], - "documentation":"

Adds or edits tags for a customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty (null) strings.

You can only use a tag key once for each CMK. If you use the tag key again, AWS KMS replaces the current tag value with the specified value.

For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User Guide.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"KMSInternalException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"TagException"} - ], - "documentation":"

Removes the specified tags from the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

To remove a tag, specify the tag key. To change the tag value of an existing tag key, use TagResource.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "UpdateAlias":{ - "name":"UpdateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAliasRequest"}, - "errors":[ - {"shape":"DependencyTimeoutException"}, - {"shape":"NotFoundException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Associates an existing alias with a different customer master key (CMK). Each CMK can have multiple aliases, but the aliases must be unique within the account and region. You cannot perform this operation on an alias in a different AWS account.

This operation works only on existing aliases. To change the alias of a CMK to a new value, use CreateAlias to create a new alias and DeleteAlias to delete the old alias.

Because an alias is not a property of a CMK, you can create, update, and delete the aliases of a CMK without affecting the CMK. Also, aliases do not appear in the response from the DescribeKey operation. To get the aliases of all CMKs in the account, use the ListAliases operation.

An alias name can contain only alphanumeric characters, forward slashes (/), underscores (_), and dashes (-). An alias must start with the word alias followed by a forward slash (alias/). The alias name can contain only alphanumeric characters, forward slashes (/), underscores (_), and dashes (-). Alias names cannot begin with aws; that alias name prefix is reserved by Amazon Web Services (AWS).

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "UpdateKeyDescription":{ - "name":"UpdateKeyDescription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateKeyDescriptionRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"InvalidArnException"}, - {"shape":"DependencyTimeoutException"}, - {"shape":"KMSInternalException"}, - {"shape":"KMSInvalidStateException"} - ], - "documentation":"

Updates the description of a customer master key (CMK). To see the description of a CMK, use DescribeKey.

You cannot perform this operation on a CMK in a different AWS account.

The result of this operation varies with the key state of the CMK. For details, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - } - }, - "shapes":{ - "AWSAccountIdType":{"type":"string"}, - "AlgorithmSpec":{ - "type":"string", - "enum":[ - "RSAES_PKCS1_V1_5", - "RSAES_OAEP_SHA_1", - "RSAES_OAEP_SHA_256" - ] - }, - "AliasList":{ - "type":"list", - "member":{"shape":"AliasListEntry"} - }, - "AliasListEntry":{ - "type":"structure", - "members":{ - "AliasName":{ - "shape":"AliasNameType", - "documentation":"

String that contains the alias.

" - }, - "AliasArn":{ - "shape":"ArnType", - "documentation":"

String that contains the key ARN.

" - }, - "TargetKeyId":{ - "shape":"KeyIdType", - "documentation":"

String that contains the key identifier referred to by the alias.

" - } - }, - "documentation":"

Contains information about an alias.

" - }, - "AliasNameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^[a-zA-Z0-9:/_-]+$" - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because it attempted to create a resource that already exists.

", - "exception":true - }, - "ArnType":{ - "type":"string", - "max":2048, - "min":20 - }, - "BooleanType":{"type":"boolean"}, - "CancelKeyDeletionRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier for the customer master key (CMK) for which to cancel deletion.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "CancelKeyDeletionResponse":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier of the master key for which deletion is canceled.

" - } - } - }, - "CiphertextType":{ - "type":"blob", - "max":6144, - "min":1 - }, - "CreateAliasRequest":{ - "type":"structure", - "required":[ - "AliasName", - "TargetKeyId" - ], - "members":{ - "AliasName":{ - "shape":"AliasNameType", - "documentation":"

Specifies the alias name. This value must begin with alias/ followed by the alias name, such as alias/ExampleAlias. The alias name cannot begin with aws/. The alias/aws/ prefix is reserved for AWS managed CMKs.

" - }, - "TargetKeyId":{ - "shape":"KeyIdType", - "documentation":"

Identifies the CMK for which you are creating the alias. This value cannot be an alias.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "CreateGrantRequest":{ - "type":"structure", - "required":[ - "KeyId", - "GranteePrincipal", - "Operations" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier for the customer master key (CMK) that the grant applies to.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "GranteePrincipal":{ - "shape":"PrincipalIdType", - "documentation":"

The principal that is given permission to perform the operations that the grant permits.

To specify the principal, use the Amazon Resource Name (ARN) of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, IAM roles, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see AWS Identity and Access Management (IAM) in the Example ARNs section of the AWS General Reference.

" - }, - "RetiringPrincipal":{ - "shape":"PrincipalIdType", - "documentation":"

The principal that is given permission to retire the grant by using RetireGrant operation.

To specify the principal, use the Amazon Resource Name (ARN) of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see AWS Identity and Access Management (IAM) in the Example ARNs section of the AWS General Reference.

" - }, - "Operations":{ - "shape":"GrantOperationList", - "documentation":"

A list of operations that the grant permits.

" - }, - "Constraints":{ - "shape":"GrantConstraints", - "documentation":"

A structure that you can use to allow certain operations in the grant only when the desired encryption context is present. For more information about encryption context, see Encryption Context in the AWS Key Management Service Developer Guide.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - }, - "Name":{ - "shape":"GrantNameType", - "documentation":"

A friendly name for identifying the grant. Use this value to prevent the unintended creation of duplicate grants when retrying this request.

When this value is absent, all CreateGrant requests result in a new grant with a unique GrantId even if all the supplied parameters are identical. This can result in unintended duplicates when you retry the CreateGrant request.

When this value is present, you can retry a CreateGrant request with identical parameters; if the grant already exists, the original GrantId is returned without creating a new grant. Note that the returned grant token is unique with every CreateGrant request, even when a duplicate GrantId is returned. All grant tokens obtained in this way can be used interchangeably.

" - } - } - }, - "CreateGrantResponse":{ - "type":"structure", - "members":{ - "GrantToken":{ - "shape":"GrantTokenType", - "documentation":"

The grant token.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - }, - "GrantId":{ - "shape":"GrantIdType", - "documentation":"

The unique identifier for the grant.

You can use the GrantId in a subsequent RetireGrant or RevokeGrant operation.

" - } - } - }, - "CreateKeyRequest":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"PolicyType", - "documentation":"

The key policy to attach to the CMK.

If you provide a key policy, it must meet the following criteria:

  • If you don't set BypassPolicyLockoutSafetyCheck to true, the key policy must allow the principal that is making the CreateKey request to make a subsequent PutKeyPolicy request on the CMK. This reduces the risk that the CMK becomes unmanageable. For more information, refer to the scenario in the Default Key Policy section of the AWS Key Management Service Developer Guide.

  • Each statement in the key policy must contain one or more principals. The principals in the key policy must exist and be visible to AWS KMS. When you create a new AWS principal (for example, an IAM user or role), you might need to enforce a delay before including the new principal in a key policy. The reason for this is that the new principal might not be immediately visible to AWS KMS. For more information, see Changes that I make are not always immediately visible in the AWS Identity and Access Management User Guide.

If you do not provide a key policy, AWS KMS attaches a default key policy to the CMK. For more information, see Default Key Policy in the AWS Key Management Service Developer Guide.

The key policy size limit is 32 kilobytes (32768 bytes).

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

A description of the CMK.

Use a description that helps you decide whether the CMK is appropriate for a task.

" - }, - "KeyUsage":{ - "shape":"KeyUsageType", - "documentation":"

The intended use of the CMK.

You can use CMKs only for symmetric encryption and decryption.

" - }, - "Origin":{ - "shape":"OriginType", - "documentation":"

The source of the CMK's key material.

The default is AWS_KMS, which means AWS KMS creates the key material. When this parameter is set to EXTERNAL, the request creates a CMK without key material so that you can import key material from your existing key management infrastructure. For more information about importing key material into AWS KMS, see Importing Key Material in the AWS Key Management Service Developer Guide.

The CMK's Origin is immutable and is set when the CMK is created.

" - }, - "BypassPolicyLockoutSafetyCheck":{ - "shape":"BooleanType", - "documentation":"

A flag to indicate whether to bypass the key policy lockout safety check.

Setting this value to true increases the risk that the CMK becomes unmanageable. Do not set this value to true indiscriminately.

For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.

Use this parameter only when you include a policy in the request and you intend to prevent the principal that is making the request from making a subsequent PutKeyPolicy request on the CMK.

The default value is false.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty (null) strings.

Use this parameter to tag the CMK when it is created. Alternately, you can omit this parameter and instead tag the CMK after it is created using TagResource.

" - } - } - }, - "CreateKeyResponse":{ - "type":"structure", - "members":{ - "KeyMetadata":{ - "shape":"KeyMetadata", - "documentation":"

Metadata associated with the CMK.

" - } - } - }, - "DataKeySpec":{ - "type":"string", - "enum":[ - "AES_256", - "AES_128" - ] - }, - "DateType":{"type":"timestamp"}, - "DecryptRequest":{ - "type":"structure", - "required":["CiphertextBlob"], - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

Ciphertext to be decrypted. The blob includes metadata.

" - }, - "EncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

The encryption context. If this was specified in the Encrypt function, it must be specified here or the decryption operation will fail. For more information, see Encryption Context.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "DecryptResponse":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

ARN of the key used to perform the decryption. This value is returned if no errors are encountered during the operation.

" - }, - "Plaintext":{ - "shape":"PlaintextType", - "documentation":"

Decrypted plaintext data. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - } - } - }, - "DeleteAliasRequest":{ - "type":"structure", - "required":["AliasName"], - "members":{ - "AliasName":{ - "shape":"AliasNameType", - "documentation":"

The alias to be deleted. The name must start with the word \"alias\" followed by a forward slash (alias/). Aliases that begin with \"alias/aws\" are reserved.

" - } - } - }, - "DeleteImportedKeyMaterialRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK whose key material to delete. The CMK's Origin must be EXTERNAL.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "DependencyTimeoutException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The system timed out while trying to fulfill the request. The request can be retried.

", - "exception":true, - "fault":true - }, - "DescribeKeyRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

Describes the specified customer master key (CMK).

If you specify a predefined AWS alias (an AWS alias with no key ID), KMS associates the alias with an AWS managed CMK and returns its KeyId and Arn in the response.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. When using an alias name, prefix it with \"alias/\". To specify a CMK in a different AWS account, you must use the key ARN or alias ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Alias name: alias/ExampleAlias

  • Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey. To get the alias name and alias ARN, use ListAliases.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "DescribeKeyResponse":{ - "type":"structure", - "members":{ - "KeyMetadata":{ - "shape":"KeyMetadata", - "documentation":"

Metadata associated with the key.

" - } - } - }, - "DescriptionType":{ - "type":"string", - "max":8192, - "min":0 - }, - "DisableKeyRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "DisableKeyRotationRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "DisabledException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified CMK is not enabled.

", - "exception":true - }, - "EnableKeyRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "EnableKeyRotationRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "EncryptRequest":{ - "type":"structure", - "required":[ - "KeyId", - "Plaintext" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. When using an alias name, prefix it with \"alias/\". To specify a CMK in a different AWS account, you must use the key ARN or alias ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Alias name: alias/ExampleAlias

  • Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey. To get the alias name and alias ARN, use ListAliases.

" - }, - "Plaintext":{ - "shape":"PlaintextType", - "documentation":"

Data to be encrypted.

" - }, - "EncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

Name-value pair that specifies the encryption context to be used for authenticated encryption. If used here, the same value must be supplied to the Decrypt API or decryption will fail. For more information, see Encryption Context.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "EncryptResponse":{ - "type":"structure", - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

The encrypted plaintext. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The ID of the key used during encryption.

" - } - } - }, - "EncryptionContextKey":{"type":"string"}, - "EncryptionContextType":{ - "type":"map", - "key":{"shape":"EncryptionContextKey"}, - "value":{"shape":"EncryptionContextValue"} - }, - "EncryptionContextValue":{"type":"string"}, - "ErrorMessageType":{"type":"string"}, - "ExpirationModelType":{ - "type":"string", - "enum":[ - "KEY_MATERIAL_EXPIRES", - "KEY_MATERIAL_DOES_NOT_EXPIRE" - ] - }, - "ExpiredImportTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the provided import token is expired. Use GetParametersForImport to get a new import token and public key, use the new public key to encrypt the key material, and then try the request again.

", - "exception":true - }, - "GenerateDataKeyRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK under which to generate and encrypt the data encryption key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. When using an alias name, prefix it with \"alias/\". To specify a CMK in a different AWS account, you must use the key ARN or alias ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Alias name: alias/ExampleAlias

  • Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey. To get the alias name and alias ARN, use ListAliases.

" - }, - "EncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

A set of key-value pairs that represents additional authenticated data.

For more information, see Encryption Context in the AWS Key Management Service Developer Guide.

" - }, - "NumberOfBytes":{ - "shape":"NumberOfBytesType", - "documentation":"

The length of the data encryption key in bytes. For example, use the value 64 to generate a 512-bit data key (64 bytes is 512 bits). For common key lengths (128-bit and 256-bit symmetric keys), we recommend that you use the KeySpec field instead of this one.

" - }, - "KeySpec":{ - "shape":"DataKeySpec", - "documentation":"

The length of the data encryption key. Use AES_128 to generate a 128-bit symmetric key, or AES_256 to generate a 256-bit symmetric key.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "GenerateDataKeyResponse":{ - "type":"structure", - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

The encrypted data encryption key. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - }, - "Plaintext":{ - "shape":"PlaintextType", - "documentation":"

The data encryption key. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded. Use this data key for local encryption and decryption, then remove it from memory as soon as possible.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK under which the data encryption key was generated and encrypted.

" - } - } - }, - "GenerateDataKeyWithoutPlaintextRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the customer master key (CMK) under which to generate and encrypt the data encryption key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. When using an alias name, prefix it with \"alias/\". To specify a CMK in a different AWS account, you must use the key ARN or alias ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Alias name: alias/ExampleAlias

  • Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey. To get the alias name and alias ARN, use ListAliases.

" - }, - "EncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

A set of key-value pairs that represents additional authenticated data.

For more information, see Encryption Context in the AWS Key Management Service Developer Guide.

" - }, - "KeySpec":{ - "shape":"DataKeySpec", - "documentation":"

The length of the data encryption key. Use AES_128 to generate a 128-bit symmetric key, or AES_256 to generate a 256-bit symmetric key.

" - }, - "NumberOfBytes":{ - "shape":"NumberOfBytesType", - "documentation":"

The length of the data encryption key in bytes. For example, use the value 64 to generate a 512-bit data key (64 bytes is 512 bits). For common key lengths (128-bit and 256-bit symmetric keys), we recommend that you use the KeySpec field instead of this one.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "GenerateDataKeyWithoutPlaintextResponse":{ - "type":"structure", - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

The encrypted data encryption key. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK under which the data encryption key was generated and encrypted.

" - } - } - }, - "GenerateRandomRequest":{ - "type":"structure", - "members":{ - "NumberOfBytes":{ - "shape":"NumberOfBytesType", - "documentation":"

The length of the byte string.

" - } - } - }, - "GenerateRandomResponse":{ - "type":"structure", - "members":{ - "Plaintext":{ - "shape":"PlaintextType", - "documentation":"

The random byte string. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - } - } - }, - "GetKeyPolicyRequest":{ - "type":"structure", - "required":[ - "KeyId", - "PolicyName" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "PolicyName":{ - "shape":"PolicyNameType", - "documentation":"

Specifies the name of the key policy. The only valid name is default. To get the names of key policies, use ListKeyPolicies.

" - } - } - }, - "GetKeyPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"PolicyType", - "documentation":"

A key policy document in JSON format.

" - } - } - }, - "GetKeyRotationStatusRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "GetKeyRotationStatusResponse":{ - "type":"structure", - "members":{ - "KeyRotationEnabled":{ - "shape":"BooleanType", - "documentation":"

A Boolean value that specifies whether key rotation is enabled.

" - } - } - }, - "GetParametersForImportRequest":{ - "type":"structure", - "required":[ - "KeyId", - "WrappingAlgorithm", - "WrappingKeySpec" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK into which you will import key material. The CMK's Origin must be EXTERNAL.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "WrappingAlgorithm":{ - "shape":"AlgorithmSpec", - "documentation":"

The algorithm you use to encrypt the key material before importing it with ImportKeyMaterial. For more information, see Encrypt the Key Material in the AWS Key Management Service Developer Guide.

" - }, - "WrappingKeySpec":{ - "shape":"WrappingKeySpec", - "documentation":"

The type of wrapping key (public key) to return in the response. Only 2048-bit RSA public keys are supported.

" - } - } - }, - "GetParametersForImportResponse":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK to use in a subsequent ImportKeyMaterial request. This is the same CMK specified in the GetParametersForImport request.

" - }, - "ImportToken":{ - "shape":"CiphertextType", - "documentation":"

The import token to send in a subsequent ImportKeyMaterial request.

" - }, - "PublicKey":{ - "shape":"PlaintextType", - "documentation":"

The public key to use to encrypt the key material before importing it with ImportKeyMaterial.

" - }, - "ParametersValidTo":{ - "shape":"DateType", - "documentation":"

The time at which the import token and public key are no longer valid. After this time, you cannot use them to make an ImportKeyMaterial request and you must send another GetParametersForImport request to get new ones.

" - } - } - }, - "GrantConstraints":{ - "type":"structure", - "members":{ - "EncryptionContextSubset":{ - "shape":"EncryptionContextType", - "documentation":"

A list of key-value pairs, all of which must be present in the encryption context of certain subsequent operations that the grant allows. When certain subsequent operations allowed by the grant include encryption context that matches this list or is a superset of this list, the grant allows the operation. Otherwise, the grant does not allow the operation.

" - }, - "EncryptionContextEquals":{ - "shape":"EncryptionContextType", - "documentation":"

A list of key-value pairs that must be present in the encryption context of certain subsequent operations that the grant allows. When certain subsequent operations allowed by the grant include encryption context that matches this list, the grant allows the operation. Otherwise, the grant does not allow the operation.

" - } - }, - "documentation":"

A structure that you can use to allow certain operations in the grant only when the preferred encryption context is present. For more information about encryption context, see Encryption Context in the AWS Key Management Service Developer Guide.

Grant constraints apply only to operations that accept encryption context as input. For example, the DescribeKey operation does not accept encryption context as input. A grant that allows the DescribeKey operation does so regardless of the grant constraints. In contrast, the Encrypt operation accepts encryption context as input. A grant that allows the Encrypt operation does so only when the encryption context of the Encrypt operation satisfies the grant constraints.

" - }, - "GrantIdType":{ - "type":"string", - "max":128, - "min":1 - }, - "GrantList":{ - "type":"list", - "member":{"shape":"GrantListEntry"} - }, - "GrantListEntry":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier for the customer master key (CMK) to which the grant applies.

" - }, - "GrantId":{ - "shape":"GrantIdType", - "documentation":"

The unique identifier for the grant.

" - }, - "Name":{ - "shape":"GrantNameType", - "documentation":"

The friendly name that identifies the grant. If a name was provided in the CreateGrant request, that name is returned. Otherwise this value is null.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date and time when the grant was created.

" - }, - "GranteePrincipal":{ - "shape":"PrincipalIdType", - "documentation":"

The principal that receives the grant's permissions.

" - }, - "RetiringPrincipal":{ - "shape":"PrincipalIdType", - "documentation":"

The principal that can retire the grant.

" - }, - "IssuingAccount":{ - "shape":"PrincipalIdType", - "documentation":"

The AWS account under which the grant was issued.

" - }, - "Operations":{ - "shape":"GrantOperationList", - "documentation":"

The list of operations permitted by the grant.

" - }, - "Constraints":{ - "shape":"GrantConstraints", - "documentation":"

A list of key-value pairs that must be present in the encryption context of certain subsequent operations that the grant allows.

" - } - }, - "documentation":"

Contains information about an entry in a list of grants.

" - }, - "GrantNameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^[a-zA-Z0-9:/_-]+$" - }, - "GrantOperation":{ - "type":"string", - "enum":[ - "Decrypt", - "Encrypt", - "GenerateDataKey", - "GenerateDataKeyWithoutPlaintext", - "ReEncryptFrom", - "ReEncryptTo", - "CreateGrant", - "RetireGrant", - "DescribeKey" - ] - }, - "GrantOperationList":{ - "type":"list", - "member":{"shape":"GrantOperation"} - }, - "GrantTokenList":{ - "type":"list", - "member":{"shape":"GrantTokenType"}, - "max":10, - "min":0 - }, - "GrantTokenType":{ - "type":"string", - "max":8192, - "min":1 - }, - "ImportKeyMaterialRequest":{ - "type":"structure", - "required":[ - "KeyId", - "ImportToken", - "EncryptedKeyMaterial" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The identifier of the CMK to import the key material into. The CMK's Origin must be EXTERNAL.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "ImportToken":{ - "shape":"CiphertextType", - "documentation":"

The import token that you received in the response to a previous GetParametersForImport request. It must be from the same response that contained the public key that you used to encrypt the key material.

" - }, - "EncryptedKeyMaterial":{ - "shape":"CiphertextType", - "documentation":"

The encrypted key material to import. It must be encrypted with the public key that you received in the response to a previous GetParametersForImport request, using the wrapping algorithm that you specified in that request.

" - }, - "ValidTo":{ - "shape":"DateType", - "documentation":"

The time at which the imported key material expires. When the key material expires, AWS KMS deletes the key material and the CMK becomes unusable. You must omit this parameter when the ExpirationModel parameter is set to KEY_MATERIAL_DOES_NOT_EXPIRE. Otherwise it is required.

" - }, - "ExpirationModel":{ - "shape":"ExpirationModelType", - "documentation":"

Specifies whether the key material expires. The default is KEY_MATERIAL_EXPIRES, in which case you must include the ValidTo parameter. When this parameter is set to KEY_MATERIAL_DOES_NOT_EXPIRE, you must omit the ValidTo parameter.

" - } - } - }, - "ImportKeyMaterialResponse":{ - "type":"structure", - "members":{ - } - }, - "IncorrectKeyMaterialException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the provided key material is invalid or is not the same key material that was previously imported into this customer master key (CMK).

", - "exception":true - }, - "InvalidAliasNameException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified alias name is not valid.

", - "exception":true - }, - "InvalidArnException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because a specified ARN was not valid.

", - "exception":true - }, - "InvalidCiphertextException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified ciphertext, or additional authenticated data incorporated into the ciphertext, such as the encryption context, is corrupted, missing, or otherwise invalid.

", - "exception":true - }, - "InvalidGrantIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified GrantId is not valid.

", - "exception":true - }, - "InvalidGrantTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified grant token is not valid.

", - "exception":true - }, - "InvalidImportTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the provided import token is invalid or is associated with a different customer master key (CMK).

", - "exception":true - }, - "InvalidKeyUsageException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified KeySpec value is not valid.

", - "exception":true - }, - "InvalidMarkerException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the marker that specifies where pagination should next begin is not valid.

", - "exception":true - }, - "KMSInternalException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because an internal exception occurred. The request can be retried.

", - "exception":true - }, - "KMSInvalidStateException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the state of the specified resource is not valid for this request.

For more information about how key state affects the use of a CMK, see How Key State Affects Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

", - "exception":true - }, - "KeyIdType":{ - "type":"string", - "max":2048, - "min":1 - }, - "KeyList":{ - "type":"list", - "member":{"shape":"KeyListEntry"} - }, - "KeyListEntry":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

Unique identifier of the key.

" - }, - "KeyArn":{ - "shape":"ArnType", - "documentation":"

ARN of the key.

" - } - }, - "documentation":"

Contains information about each entry in the key list.

" - }, - "KeyManagerType":{ - "type":"string", - "enum":[ - "AWS", - "CUSTOMER" - ] - }, - "KeyMetadata":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "AWSAccountId":{ - "shape":"AWSAccountIdType", - "documentation":"

The twelve-digit account ID of the AWS account that owns the CMK.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The globally unique identifier for the CMK.

" - }, - "Arn":{ - "shape":"ArnType", - "documentation":"

The Amazon Resource Name (ARN) of the CMK. For examples, see AWS Key Management Service (AWS KMS) in the Example ARNs section of the AWS General Reference.

" - }, - "CreationDate":{ - "shape":"DateType", - "documentation":"

The date and time when the CMK was created.

" - }, - "Enabled":{ - "shape":"BooleanType", - "documentation":"

Specifies whether the CMK is enabled. When KeyState is Enabled this value is true, otherwise it is false.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

The description of the CMK.

" - }, - "KeyUsage":{ - "shape":"KeyUsageType", - "documentation":"

The cryptographic operations for which you can use the CMK. Currently the only allowed value is ENCRYPT_DECRYPT, which means you can use the CMK for the Encrypt and Decrypt operations.

" - }, - "KeyState":{ - "shape":"KeyState", - "documentation":"

The state of the CMK.

For more information about how key state affects the use of a CMK, see How Key State Affects the Use of a Customer Master Key in the AWS Key Management Service Developer Guide.

" - }, - "DeletionDate":{ - "shape":"DateType", - "documentation":"

The date and time after which AWS KMS deletes the CMK. This value is present only when KeyState is PendingDeletion, otherwise this value is omitted.

" - }, - "ValidTo":{ - "shape":"DateType", - "documentation":"

The time at which the imported key material expires. When the key material expires, AWS KMS deletes the key material and the CMK becomes unusable. This value is present only for CMKs whose Origin is EXTERNAL and whose ExpirationModel is KEY_MATERIAL_EXPIRES, otherwise this value is omitted.

" - }, - "Origin":{ - "shape":"OriginType", - "documentation":"

The source of the CMK's key material. When this value is AWS_KMS, AWS KMS created the key material. When this value is EXTERNAL, the key material was imported from your existing key management infrastructure or the CMK lacks key material.

" - }, - "ExpirationModel":{ - "shape":"ExpirationModelType", - "documentation":"

Specifies whether the CMK's key material expires. This value is present only when Origin is EXTERNAL, otherwise this value is omitted.

" - }, - "KeyManager":{ - "shape":"KeyManagerType", - "documentation":"

The CMK's manager. CMKs are either customer managed or AWS managed. For more information about the difference, see Customer Master Keys in the AWS Key Management Service Developer Guide.

" - } - }, - "documentation":"

Contains metadata about a customer master key (CMK).

This data type is used as a response element for the CreateKey and DescribeKey operations.

" - }, - "KeyState":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled", - "PendingDeletion", - "PendingImport" - ] - }, - "KeyUnavailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified CMK was not available. The request can be retried.

", - "exception":true, - "fault":true - }, - "KeyUsageType":{ - "type":"string", - "enum":["ENCRYPT_DECRYPT"] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because a limit was exceeded. For more information, see Limits in the AWS Key Management Service Developer Guide.

", - "exception":true - }, - "LimitType":{ - "type":"integer", - "max":1000, - "min":1 - }, - "ListAliasesRequest":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

Lists only aliases that refer to the specified CMK. The value of this parameter can be the ID or Amazon Resource Name (ARN) of a CMK in the caller's account and region. You cannot use an alias name or alias ARN in this value.

This parameter is optional. If you omit it, ListAliases returns all aliases in the account and region.

" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 100, inclusive. If you do not include a value, it defaults to 50.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

" - } - } - }, - "ListAliasesResponse":{ - "type":"structure", - "members":{ - "Aliases":{ - "shape":"AliasList", - "documentation":"

A list of aliases.

" - }, - "NextMarker":{ - "shape":"MarkerType", - "documentation":"

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

" - }, - "Truncated":{ - "shape":"BooleanType", - "documentation":"

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

" - } - } - }, - "ListGrantsRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 100, inclusive. If you do not include a value, it defaults to 50.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - } - } - }, - "ListGrantsResponse":{ - "type":"structure", - "members":{ - "Grants":{ - "shape":"GrantList", - "documentation":"

A list of grants.

" - }, - "NextMarker":{ - "shape":"MarkerType", - "documentation":"

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

" - }, - "Truncated":{ - "shape":"BooleanType", - "documentation":"

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

" - } - } - }, - "ListKeyPoliciesRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 1000, inclusive. If you do not include a value, it defaults to 100.

Currently only 1 policy can be attached to a key.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

" - } - } - }, - "ListKeyPoliciesResponse":{ - "type":"structure", - "members":{ - "PolicyNames":{ - "shape":"PolicyNameList", - "documentation":"

A list of key policy names. Currently, there is only one key policy per CMK and it is always named default.

" - }, - "NextMarker":{ - "shape":"MarkerType", - "documentation":"

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

" - }, - "Truncated":{ - "shape":"BooleanType", - "documentation":"

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

" - } - } - }, - "ListKeysRequest":{ - "type":"structure", - "members":{ - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 1000, inclusive. If you do not include a value, it defaults to 100.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

" - } - } - }, - "ListKeysResponse":{ - "type":"structure", - "members":{ - "Keys":{ - "shape":"KeyList", - "documentation":"

A list of customer master keys (CMKs).

" - }, - "NextMarker":{ - "shape":"MarkerType", - "documentation":"

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

" - }, - "Truncated":{ - "shape":"BooleanType", - "documentation":"

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

" - } - } - }, - "ListResourceTagsRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 50, inclusive. If you do not include a value, it defaults to 50.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

Do not attempt to construct this value. Use only the value of NextMarker from the truncated response you just received.

" - } - } - }, - "ListResourceTagsResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags. Each tag consists of a tag key and a tag value.

" - }, - "NextMarker":{ - "shape":"MarkerType", - "documentation":"

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

Do not assume or infer any information from this value.

" - }, - "Truncated":{ - "shape":"BooleanType", - "documentation":"

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

" - } - } - }, - "ListRetirableGrantsRequest":{ - "type":"structure", - "required":["RetiringPrincipal"], - "members":{ - "Limit":{ - "shape":"LimitType", - "documentation":"

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer.

This value is optional. If you include a value, it must be between 1 and 100, inclusive. If you do not include a value, it defaults to 50.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

" - }, - "RetiringPrincipal":{ - "shape":"PrincipalIdType", - "documentation":"

The retiring principal for which to list grants.

To specify the retiring principal, use the Amazon Resource Name (ARN) of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax for specifying a principal, see AWS Identity and Access Management (IAM) in the Example ARNs section of the Amazon Web Services General Reference.

" - } - } - }, - "MalformedPolicyDocumentException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified policy is not syntactically or semantically correct.

", - "exception":true - }, - "MarkerType":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[\\u0020-\\u00FF]*" - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because the specified entity or resource could not be found.

", - "exception":true - }, - "NumberOfBytesType":{ - "type":"integer", - "max":1024, - "min":1 - }, - "OriginType":{ - "type":"string", - "enum":[ - "AWS_KMS", - "EXTERNAL" - ] - }, - "PendingWindowInDaysType":{ - "type":"integer", - "max":365, - "min":1 - }, - "PlaintextType":{ - "type":"blob", - "max":4096, - "min":1, - "sensitive":true - }, - "PolicyNameList":{ - "type":"list", - "member":{"shape":"PolicyNameType"} - }, - "PolicyNameType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w]+" - }, - "PolicyType":{ - "type":"string", - "max":131072, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "PrincipalIdType":{ - "type":"string", - "max":256, - "min":1 - }, - "PutKeyPolicyRequest":{ - "type":"structure", - "required":[ - "KeyId", - "PolicyName", - "Policy" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "PolicyName":{ - "shape":"PolicyNameType", - "documentation":"

The name of the key policy. The only valid value is default.

" - }, - "Policy":{ - "shape":"PolicyType", - "documentation":"

The key policy to attach to the CMK.

The key policy must meet the following criteria:

  • If you don't set BypassPolicyLockoutSafetyCheck to true, the key policy must allow the principal that is making the PutKeyPolicy request to make a subsequent PutKeyPolicy request on the CMK. This reduces the risk that the CMK becomes unmanageable. For more information, refer to the scenario in the Default Key Policy section of the AWS Key Management Service Developer Guide.

  • Each statement in the key policy must contain one or more principals. The principals in the key policy must exist and be visible to AWS KMS. When you create a new AWS principal (for example, an IAM user or role), you might need to enforce a delay before including the new principal in a key policy. The reason for this is that the new principal might not be immediately visible to AWS KMS. For more information, see Changes that I make are not always immediately visible in the AWS Identity and Access Management User Guide.

The key policy size limit is 32 kilobytes (32768 bytes).

" - }, - "BypassPolicyLockoutSafetyCheck":{ - "shape":"BooleanType", - "documentation":"

A flag to indicate whether to bypass the key policy lockout safety check.

Setting this value to true increases the risk that the CMK becomes unmanageable. Do not set this value to true indiscriminately.

For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.

Use this parameter only when you intend to prevent the principal that is making the request from making a subsequent PutKeyPolicy request on the CMK.

The default value is false.

" - } - } - }, - "ReEncryptRequest":{ - "type":"structure", - "required":[ - "CiphertextBlob", - "DestinationKeyId" - ], - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

Ciphertext of the data to reencrypt.

" - }, - "SourceEncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

Encryption context used to encrypt and decrypt the data specified in the CiphertextBlob parameter.

" - }, - "DestinationKeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the CMK that is used to reencrypt the data.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. When using an alias name, prefix it with \"alias/\". To specify a CMK in a different AWS account, you must use the key ARN or alias ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Alias name: alias/ExampleAlias

  • Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey. To get the alias name and alias ARN, use ListAliases.

" - }, - "DestinationEncryptionContext":{ - "shape":"EncryptionContextType", - "documentation":"

Encryption context to use when the data is reencrypted.

" - }, - "GrantTokens":{ - "shape":"GrantTokenList", - "documentation":"

A list of grant tokens.

For more information, see Grant Tokens in the AWS Key Management Service Developer Guide.

" - } - } - }, - "ReEncryptResponse":{ - "type":"structure", - "members":{ - "CiphertextBlob":{ - "shape":"CiphertextType", - "documentation":"

The reencrypted data. When you use the HTTP API or the AWS CLI, the value is Base64-encoded. Otherwise, it is not encoded.

" - }, - "SourceKeyId":{ - "shape":"KeyIdType", - "documentation":"

Unique identifier of the CMK used to originally encrypt the data.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

Unique identifier of the CMK used to reencrypt the data.

" - } - } - }, - "RetireGrantRequest":{ - "type":"structure", - "members":{ - "GrantToken":{ - "shape":"GrantTokenType", - "documentation":"

Token that identifies the grant to be retired.

" - }, - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The Amazon Resource Name (ARN) of the CMK associated with the grant.

For example: arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab

" - }, - "GrantId":{ - "shape":"GrantIdType", - "documentation":"

Unique identifier of the grant to retire. The grant ID is returned in the response to a CreateGrant operation.

  • Grant ID Example - 0123456789012345678901234567890123456789012345678901234567890123

" - } - } - }, - "RevokeGrantRequest":{ - "type":"structure", - "required":[ - "KeyId", - "GrantId" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key associated with the grant.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "GrantId":{ - "shape":"GrantIdType", - "documentation":"

Identifier of the grant to be revoked.

" - } - } - }, - "ScheduleKeyDeletionRequest":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier of the customer master key (CMK) to delete.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "PendingWindowInDays":{ - "shape":"PendingWindowInDaysType", - "documentation":"

The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the customer master key (CMK).

This value is optional. If you include a value, it must be between 7 and 30, inclusive. If you do not include a value, it defaults to 30.

" - } - } - }, - "ScheduleKeyDeletionResponse":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

The unique identifier of the customer master key (CMK) for which deletion is scheduled.

" - }, - "DeletionDate":{ - "shape":"DateType", - "documentation":"

The date and time after which AWS KMS deletes the customer master key (CMK).

" - } - } - }, - "Tag":{ - "type":"structure", - "required":[ - "TagKey", - "TagValue" - ], - "members":{ - "TagKey":{ - "shape":"TagKeyType", - "documentation":"

The key of the tag.

" - }, - "TagValue":{ - "shape":"TagValueType", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

A key-value pair. A tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty (null) strings.

For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User Guide.

" - }, - "TagException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because one or more tags are not valid.

", - "exception":true - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKeyType"} - }, - "TagKeyType":{ - "type":"string", - "max":128, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "KeyId", - "Tags" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the CMK you are tagging.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. Each tag consists of a tag key and a tag value.

" - } - } - }, - "TagValueType":{ - "type":"string", - "max":256, - "min":0 - }, - "UnsupportedOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

", - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "KeyId", - "TagKeys" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the CMK from which you are removing tags.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

One or more tag keys. Specify only the tag keys, not the tag values.

" - } - } - }, - "UpdateAliasRequest":{ - "type":"structure", - "required":[ - "AliasName", - "TargetKeyId" - ], - "members":{ - "AliasName":{ - "shape":"AliasNameType", - "documentation":"

String that contains the name of the alias to be modified. The name must start with the word \"alias\" followed by a forward slash (alias/). Aliases that begin with \"alias/aws\" are reserved.

" - }, - "TargetKeyId":{ - "shape":"KeyIdType", - "documentation":"

Unique identifier of the customer master key to be mapped to the alias.

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

To verify that the alias is mapped to the correct CMK, use ListAliases.

" - } - } - }, - "UpdateKeyDescriptionRequest":{ - "type":"structure", - "required":[ - "KeyId", - "Description" - ], - "members":{ - "KeyId":{ - "shape":"KeyIdType", - "documentation":"

A unique identifier for the customer master key (CMK).

Specify the key ID or the Amazon Resource Name (ARN) of the CMK.

For example:

  • Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

New description for the CMK.

" - } - } - }, - "WrappingKeySpec":{ - "type":"string", - "enum":["RSA_2048"] - } - }, - "documentation":"AWS Key Management Service

AWS Key Management Service (AWS KMS) is an encryption and key management web service. This guide describes the AWS KMS operations that you can call programmatically. For general information about AWS KMS, see the AWS Key Management Service Developer Guide.

AWS provides SDKs that consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .Net, macOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to AWS KMS and other AWS services. For example, the SDKs take care of tasks such as signing requests (see below), managing errors, and retrying requests automatically. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.

We recommend that you use the AWS SDKs to make programmatic API calls to AWS KMS.

Clients must support TLS (Transport Layer Security) 1.0. We recommend TLS 1.2. Clients must also support cipher suites with Perfect Forward Secrecy (PFS) such as Ephemeral Diffie-Hellman (DHE) or Elliptic Curve Ephemeral Diffie-Hellman (ECDHE). Most modern systems such as Java 7 and later support these modes.

Signing Requests

Requests must be signed by using an access key ID and a secret access key. We strongly recommend that you do not use your AWS account (root) access key ID and secret key for everyday work with AWS KMS. Instead, use the access key ID and secret access key for an IAM user. You can also use the AWS Security Token Service to generate temporary security credentials that you can use to sign requests.

All AWS KMS operations require Signature Version 4.

Logging API Requests

AWS KMS supports AWS CloudTrail, a service that logs AWS API calls and related events for your AWS account and delivers them to an Amazon S3 bucket that you specify. By using the information collected by CloudTrail, you can determine what requests were made to AWS KMS, who made the request, when it was made, and so on. To learn more about CloudTrail, including how to turn it on and find your log files, see the AWS CloudTrail User Guide.

Additional Resources

For more information about credentials and request signing, see the following:

Commonly Used API Operations

Of the API operations discussed in this guide, the following will prove the most useful for most applications. You will likely perform operations other than these, such as creating keys and assigning policies, by using the console.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2014-11-11/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2014-11-11/service-2.json deleted file mode 100644 index 8351ac87..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2014-11-11/service-2.json +++ /dev/null @@ -1,873 +0,0 @@ -{ - "metadata":{ - "apiVersion":"2014-11-11", - "endpointPrefix":"lambda", - "serviceFullName":"AWS Lambda", - "signatureVersion":"v4", - "protocol":"rest-json" - }, - "documentation":"AWS Lambda

Overview

This is the AWS Lambda API Reference. The AWS Lambda Developer Guide provides additional information. For the service overview, go to What is AWS Lambda, and for information about how the service works, go to AWS LambdaL How it Works in the AWS Lambda Developer Guide.

", - "operations":{ - "AddEventSource":{ - "name":"AddEventSource", - "http":{ - "method":"POST", - "requestUri":"/2014-11-13/event-source-mappings/" - }, - "input":{"shape":"AddEventSourceRequest"}, - "output":{ - "shape":"EventSourceConfiguration", - "documentation":"

Describes mapping between an Amazon Kinesis stream and a Lambda function.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - } - ], - "documentation":"

Identifies a stream as an event source for an AWS Lambda function. It can be either an Amazon Kinesis stream or a Amazon DynamoDB stream. AWS Lambda invokes the specified function when records are posted to the stream.

This is the pull model, where AWS Lambda invokes the function. For more information, go to AWS Lambda: How it Works in the AWS Lambda Developer Guide.

This association between an Amazon Kinesis stream and an AWS Lambda function is called the event source mapping. You provide the configuration information (for example, which stream to read from and which AWS Lambda function to invoke) for the event source mapping in the request body.

Each event source, such as a Kinesis stream, can only be associated with one AWS Lambda function. If you call AddEventSource for an event source that is already mapped to another AWS Lambda function, the existing mapping is updated to call the new function instead of the old one.

This operation requires permission for the iam:PassRole action for the IAM role. It also requires permission for the lambda:AddEventSource action.

" - }, - "DeleteFunction":{ - "name":"DeleteFunction", - "http":{ - "method":"DELETE", - "requestUri":"/2014-11-13/functions/{FunctionName}", - "responseCode":204 - }, - "input":{"shape":"DeleteFunctionRequest"}, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - } - ], - "documentation":"

Deletes the specified Lambda function code and configuration.

This operation requires permission for the lambda:DeleteFunction action.

" - }, - "GetEventSource":{ - "name":"GetEventSource", - "http":{ - "method":"GET", - "requestUri":"/2014-11-13/event-source-mappings/{UUID}", - "responseCode":200 - }, - "input":{"shape":"GetEventSourceRequest"}, - "output":{ - "shape":"EventSourceConfiguration", - "documentation":"

Describes mapping between an Amazon Kinesis stream and a Lambda function.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - } - ], - "documentation":"

Returns configuration information for the specified event source mapping (see AddEventSource).

This operation requires permission for the lambda:GetEventSource action.

" - }, - "GetFunction":{ - "name":"GetFunction", - "http":{ - "method":"GET", - "requestUri":"/2014-11-13/functions/{FunctionName}", - "responseCode":200 - }, - "input":{"shape":"GetFunctionRequest"}, - "output":{ - "shape":"GetFunctionResponse", - "documentation":"

This response contains the object for AWS Lambda function location (see API_FunctionCodeLocation

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - } - ], - "documentation":"

Returns the configuration information of the Lambda function and a presigned URL link to the .zip file you uploaded with UploadFunction so you can download the .zip file. Note that the URL is valid for up to 10 minutes. The configuration information is the same information you provided as parameters when uploading the function.

This operation requires permission for the lambda:GetFunction action.

" - }, - "GetFunctionConfiguration":{ - "name":"GetFunctionConfiguration", - "http":{ - "method":"GET", - "requestUri":"/2014-11-13/functions/{FunctionName}/configuration", - "responseCode":200 - }, - "input":{"shape":"GetFunctionConfigurationRequest"}, - "output":{ - "shape":"FunctionConfiguration", - "documentation":"

A complex type that describes function metadata.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - } - ], - "documentation":"

Returns the configuration information of the Lambda function. This the same information you provided as parameters when uploading the function by using UploadFunction.

This operation requires permission for the lambda:GetFunctionConfiguration operation.

" - }, - "InvokeAsync":{ - "name":"InvokeAsync", - "http":{ - "method":"POST", - "requestUri":"/2014-11-13/functions/{FunctionName}/invoke-async/", - "responseCode":202 - }, - "input":{"shape":"InvokeAsyncRequest"}, - "output":{ - "shape":"InvokeAsyncResponse", - "documentation":"

Upon success, it returns empty response. Otherwise, throws an exception.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - { - "shape":"InvalidRequestContentException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

The request body could not be parsed as JSON.

" - } - ], - "documentation":"

Submits an invocation request to AWS Lambda. Upon receiving the request, Lambda executes the specified function asynchronously. To see the logs generated by the Lambda function execution, see the CloudWatch logs console.

This operation requires permission for the lambda:InvokeAsync action.

" - }, - "ListEventSources":{ - "name":"ListEventSources", - "http":{ - "method":"GET", - "requestUri":"/2014-11-13/event-source-mappings/", - "responseCode":200 - }, - "input":{"shape":"ListEventSourcesRequest"}, - "output":{ - "shape":"ListEventSourcesResponse", - "documentation":"

Contains a list of event sources (see API_EventSourceConfiguration)

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - } - ], - "documentation":"

Returns a list of event source mappings you created using the AddEventSource (see AddEventSource), where you identify a stream as event source. This list does not include Amazon S3 event sources.

For each mapping, the API returns configuration information. You can optionally specify filters to retrieve specific event source mappings.

This operation requires permission for the lambda:ListEventSources action.

" - }, - "ListFunctions":{ - "name":"ListFunctions", - "http":{ - "method":"GET", - "requestUri":"/2014-11-13/functions/", - "responseCode":200 - }, - "input":{"shape":"ListFunctionsRequest"}, - "output":{ - "shape":"ListFunctionsResponse", - "documentation":"

Contains a list of AWS Lambda function configurations (see API_FunctionConfiguration.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - } - ], - "documentation":"

Returns a list of your Lambda functions. For each function, the response includes the function configuration information. You must use GetFunction to retrieve the code for your function.

This operation requires permission for the lambda:ListFunctions action.

" - }, - "RemoveEventSource":{ - "name":"RemoveEventSource", - "http":{ - "method":"DELETE", - "requestUri":"/2014-11-13/event-source-mappings/{UUID}", - "responseCode":204 - }, - "input":{"shape":"RemoveEventSourceRequest"}, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - } - ], - "documentation":"

Removes an event source mapping. This means AWS Lambda will no longer invoke the function for events in the associated source.

This operation requires permission for the lambda:RemoveEventSource action.

" - }, - "UpdateFunctionConfiguration":{ - "name":"UpdateFunctionConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/2014-11-13/functions/{FunctionName}/configuration", - "responseCode":200 - }, - "input":{"shape":"UpdateFunctionConfigurationRequest"}, - "output":{ - "shape":"FunctionConfiguration", - "documentation":"

A complex type that describes function metadata.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - } - ], - "documentation":"

Updates the configuration parameters for the specified Lambda function by using the values provided in the request. You provide only the parameters you want to change. This operation must only be used on an existing Lambda function and cannot be used to update the function's code.

This operation requires permission for the lambda:UpdateFunctionConfiguration action.

" - }, - "UploadFunction":{ - "name":"UploadFunction", - "http":{ - "method":"PUT", - "requestUri":"/2014-11-13/functions/{FunctionName}", - "responseCode":201 - }, - "input":{"shape":"UploadFunctionRequest"}, - "output":{ - "shape":"FunctionConfiguration", - "documentation":"

A complex type that describes function metadata.

" - }, - "errors":[ - { - "shape":"ServiceException", - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - { - "shape":"InvalidParameterValueException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - } - ], - "documentation":"

Creates a new Lambda function or updates an existing function. The function metadata is created from the request parameters, and the code for the function is provided by a .zip file in the request body. If the function name already exists, the existing Lambda function is updated with the new code and metadata.

This operation requires permission for the lambda:UploadFunction action.

" - } - }, - "shapes":{ - "AddEventSourceRequest":{ - "type":"structure", - "required":[ - "EventSource", - "FunctionName", - "Role" - ], - "members":{ - "EventSource":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Kinesis stream that is the event source. Any record added to this stream causes AWS Lambda to invoke your Lambda function. AWS Lambda POSTs the Amazon Kinesis event, containing records, to your Lambda function as JSON.

" - }, - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function to invoke when AWS Lambda detects an event on the stream.

" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The ARN of the IAM role (invocation role) that AWS Lambda can assume to read from the stream and invoke the function.

" - }, - "BatchSize":{ - "shape":"Integer", - "documentation":"

The largest number of records that AWS Lambda will give to your function in a single event. The default is 100 records.

" - }, - "Parameters":{ - "shape":"Map", - "documentation":"

A map (key-value pairs) defining the configuration for AWS Lambda to use when reading the event source. Currently, AWS Lambda supports only the InitialPositionInStream key. The valid values are: \"TRIM_HORIZON\" and \"LATEST\". The default value is \"TRIM_HORIZON\". For more information, go to ShardIteratorType in the Amazon Kinesis Service API Reference.

" - } - } - }, - "Blob":{ - "type":"blob", - "streaming":true - }, - "DeleteFunctionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The Lambda function to delete.

" - } - } - }, - "Description":{ - "type":"string", - "min":0, - "max":256 - }, - "EventSourceConfiguration":{ - "type":"structure", - "members":{ - "UUID":{ - "shape":"String", - "documentation":"

The AWS Lambda assigned opaque identifier for the mapping.

" - }, - "BatchSize":{ - "shape":"Integer", - "documentation":"

The largest number of records that AWS Lambda will POST in the invocation request to your function.

" - }, - "EventSource":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Kinesis stream that is the source of events.

" - }, - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function to invoke when AWS Lambda detects an event on the stream.

" - }, - "Parameters":{ - "shape":"Map", - "documentation":"

The map (key-value pairs) defining the configuration for AWS Lambda to use when reading the event source.

" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The ARN of the IAM role (invocation role) that AWS Lambda can assume to read from the stream and invoke the function.

" - }, - "LastModified":{ - "shape":"Timestamp", - "documentation":"

The UTC time string indicating the last time the event mapping was updated.

" - }, - "IsActive":{ - "shape":"Boolean", - "documentation":"

Indicates whether the event source mapping is currently honored. Events are only processes if IsActive is true.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The description of the health of the event source mapping. Valid values are: \"PENDING\", \"OK\", and \"PROBLEM:message\". Initially this staus is \"PENDING\". When AWS Lambda begins processing events, it changes the status to \"OK\".

" - } - }, - "documentation":"

Describes mapping between an Amazon Kinesis stream and a Lambda function.

" - }, - "EventSourceList":{ - "type":"list", - "member":{"shape":"EventSourceConfiguration"} - }, - "FunctionArn":{ - "type":"string", - "pattern":"arn:aws:lambda:[a-z]{2}-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_]+(\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})?" - }, - "FunctionCodeLocation":{ - "type":"structure", - "members":{ - "RepositoryType":{ - "shape":"String", - "documentation":"

The repository from which you can download the function.

" - }, - "Location":{ - "shape":"String", - "documentation":"

The presigned URL you can use to download the function's .zip file that you previously uploaded. The URL is valid for up to 10 minutes.

" - } - }, - "documentation":"

The object for the Lambda function location.

" - }, - "FunctionConfiguration":{ - "type":"structure", - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name of the function.

" - }, - "FunctionARN":{ - "shape":"FunctionArn", - "documentation":"

The Amazon Resource Name (ARN) assigned to the function.

" - }, - "ConfigurationId":{ - "shape":"String", - "documentation":"

A Lambda-assigned unique identifier for the current function code and related configuration.

" - }, - "Runtime":{ - "shape":"Runtime", - "documentation":"

The runtime environment for the Lambda function.

" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

" - }, - "Handler":{ - "shape":"Handler", - "documentation":"

The function Lambda calls to begin executing your function.

" - }, - "Mode":{ - "shape":"Mode", - "documentation":"

The type of the Lambda function you uploaded.

" - }, - "CodeSize":{ - "shape":"Long", - "documentation":"

The size, in bytes, of the function .zip file you uploaded.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The user-provided description.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "documentation":"

The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.

" - }, - "LastModified":{ - "shape":"Timestamp", - "documentation":"

The timestamp of the last time you updated the function.

" - } - }, - "documentation":"

A complex type that describes function metadata.

" - }, - "FunctionList":{ - "type":"list", - "member":{"shape":"FunctionConfiguration"} - }, - "FunctionName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-zA-Z0-9-_]+" - }, - "GetEventSourceRequest":{ - "type":"structure", - "required":["UUID"], - "members":{ - "UUID":{ - "shape":"String", - "location":"uri", - "locationName":"UUID", - "documentation":"

The AWS Lambda assigned ID of the event source mapping.

" - } - } - }, - "GetFunctionConfigurationRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The name of the Lambda function for which you want to retrieve the configuration information.

" - } - } - }, - "GetFunctionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The Lambda function name.

" - } - } - }, - "GetFunctionResponse":{ - "type":"structure", - "members":{ - "Configuration":{"shape":"FunctionConfiguration"}, - "Code":{"shape":"FunctionCodeLocation"} - }, - "documentation":"

This response contains the object for AWS Lambda function location (see API_FunctionCodeLocation

" - }, - "Handler":{ - "type":"string", - "pattern":"[a-zA-Z0-9./\\-_]+" - }, - "HttpStatus":{"type":"integer"}, - "Integer":{"type":"integer"}, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "message":{"shape":"String"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the UploadFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

" - }, - "InvalidRequestContentException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "message":{"shape":"String"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

The request body could not be parsed as JSON.

" - }, - "InvokeAsyncRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "InvokeArgs" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The Lambda function name.

" - }, - "InvokeArgs":{ - "shape":"Blob", - "documentation":"

JSON that you want to provide to your Lambda function as input.

" - } - }, - "payload":"InvokeArgs" - }, - "InvokeAsyncResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"HttpStatus", - "location":"statusCode", - "documentation":"

It will be 202 upon success.

" - } - }, - "documentation":"

Upon success, it returns empty response. Otherwise, throws an exception.

" - }, - "ListEventSourcesRequest":{ - "type":"structure", - "members":{ - "EventSourceArn":{ - "shape":"String", - "location":"querystring", - "locationName":"EventSource", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Kinesis stream.

" - }, - "FunctionName":{ - "shape":"FunctionName", - "location":"querystring", - "locationName":"FunctionName", - "documentation":"

The name of the AWS Lambda function.

" - }, - "Marker":{ - "shape":"String", - "location":"querystring", - "locationName":"Marker", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListEventSources operation. If present, specifies to continue the list from where the returning call left off.

" - }, - "MaxItems":{ - "shape":"MaxListItems", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"

Optional integer. Specifies the maximum number of event sources to return in response. This value must be greater than 0.

" - } - } - }, - "ListEventSourcesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more event source mappings.

" - }, - "EventSources":{ - "shape":"EventSourceList", - "documentation":"

An arrary of EventSourceConfiguration objects.

" - } - }, - "documentation":"

Contains a list of event sources (see API_EventSourceConfiguration)

" - }, - "ListFunctionsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "location":"querystring", - "locationName":"Marker", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListFunctions operation. If present, indicates where to continue the listing.

" - }, - "MaxItems":{ - "shape":"MaxListItems", - "location":"querystring", - "locationName":"MaxItems", - "documentation":"

Optional integer. Specifies the maximum number of AWS Lambda functions to return in response. This parameter value must be greater than 0.

" - } - } - }, - "ListFunctionsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more functions.

" - }, - "Functions":{ - "shape":"FunctionList", - "documentation":"

A list of Lambda functions.

" - } - }, - "documentation":"

Contains a list of AWS Lambda function configurations (see API_FunctionConfiguration.

" - }, - "Long":{"type":"long"}, - "Map":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "MaxListItems":{ - "type":"integer", - "min":1, - "max":10000 - }, - "MemorySize":{ - "type":"integer", - "min":128, - "max":1024 - }, - "Mode":{ - "type":"string", - "enum":["event"] - }, - "RemoveEventSourceRequest":{ - "type":"structure", - "required":["UUID"], - "members":{ - "UUID":{ - "shape":"String", - "location":"uri", - "locationName":"UUID", - "documentation":"

The event source mapping ID.

" - } - } - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

The function or the event source specified in the request does not exist.

" - }, - "RoleArn":{ - "type":"string", - "pattern":"arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - }, - "Runtime":{ - "type":"string", - "enum":["nodejs"] - }, - "ServiceException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "error":{"httpStatusCode":500}, - "exception":true, - "documentation":"

The AWS Lambda service encountered an internal error.

" - }, - "String":{"type":"string"}, - "Timeout":{ - "type":"integer", - "min":1, - "max":60 - }, - "Timestamp":{"type":"string"}, - "UpdateFunctionConfigurationRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The name of the Lambda function.

" - }, - "Role":{ - "shape":"RoleArn", - "location":"querystring", - "locationName":"Role", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda will assume when it executes your function.

" - }, - "Handler":{ - "shape":"Handler", - "location":"querystring", - "locationName":"Handler", - "documentation":"

The function that Lambda calls to begin executing your function. For Node.js, it is the module-name.export value in your function.

" - }, - "Description":{ - "shape":"Description", - "location":"querystring", - "locationName":"Description", - "documentation":"

A short user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

" - }, - "Timeout":{ - "shape":"Timeout", - "location":"querystring", - "locationName":"Timeout", - "documentation":"

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "location":"querystring", - "locationName":"MemorySize", - "documentation":"

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

" - } - } - }, - "UploadFunctionRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "FunctionZip", - "Runtime", - "Role", - "Handler", - "Mode" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "location":"uri", - "locationName":"FunctionName", - "documentation":"

The name you want to assign to the function you are uploading. The function names appear in the console and are returned in the ListFunctions API. Function names are used to specify functions to other AWS Lambda APIs, such as InvokeAsync.

" - }, - "FunctionZip":{ - "shape":"Blob", - "documentation":"

A .zip file containing your packaged source code. For more information about creating a .zip file, go to AWS LambdaL How it Works in the AWS Lambda Developer Guide.

" - }, - "Runtime":{ - "shape":"Runtime", - "location":"querystring", - "locationName":"Runtime", - "documentation":"

The runtime environment for the Lambda function you are uploading. Currently, Lambda supports only \"nodejs\" as the runtime.

" - }, - "Role":{ - "shape":"RoleArn", - "location":"querystring", - "locationName":"Role", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

" - }, - "Handler":{ - "shape":"Handler", - "location":"querystring", - "locationName":"Handler", - "documentation":"

The function that Lambda calls to begin execution. For Node.js, it is the module-name.export value in your function.

" - }, - "Mode":{ - "shape":"Mode", - "location":"querystring", - "locationName":"Mode", - "documentation":"

How the Lambda function will be invoked. Lambda supports only the \"event\" mode.

" - }, - "Description":{ - "shape":"Description", - "location":"querystring", - "locationName":"Description", - "documentation":"

A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

" - }, - "Timeout":{ - "shape":"Timeout", - "location":"querystring", - "locationName":"Timeout", - "documentation":"

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "location":"querystring", - "locationName":"MemorySize", - "documentation":"

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU allocated to your function. Your function use-case determines your CPU and memory requirements. For example, database operation might need less memory compared to image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

" - } - }, - "payload":"FunctionZip" - }, - "Boolean":{"type":"boolean"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/examples-1.json deleted file mode 100644 index 9aea28ad..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/examples-1.json +++ /dev/null @@ -1,614 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddPermission": [ - { - "input": { - "Action": "lambda:InvokeFunction", - "FunctionName": "MyFunction", - "Principal": "s3.amazonaws.com", - "SourceAccount": "123456789012", - "SourceArn": "arn:aws:s3:::examplebucket/*", - "StatementId": "ID-1" - }, - "output": { - "Statement": "ID-1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds a permission for an S3 bucket to invoke a Lambda function.", - "id": "add-permission-1474651469455", - "title": "add-permission" - } - ], - "CreateFunction": [ - { - "input": { - "Code": { - }, - "Description": "", - "FunctionName": "MyFunction", - "Handler": "souce_file.handler_name", - "MemorySize": 128, - "Publish": true, - "Role": "arn:aws:iam::123456789012:role/service-role/role-name", - "Runtime": "nodejs4.3", - "Timeout": 15, - "VpcConfig": { - } - }, - "output": { - "CodeSha256": "", - "CodeSize": 123, - "Description": "", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyFunction", - "FunctionName": "MyFunction", - "Handler": "source_file.handler_name", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/service-role/role-name", - "Runtime": "nodejs4.3", - "Timeout": 123, - "Version": "1", - "VpcConfig": { - } - }, - "comments": { - "input": { - "Handler": "is of the form of the name of your source file and then name of your function handler", - "Role": "replace with the actual arn of the execution role you created" - }, - "output": { - } - }, - "description": "This example creates a Lambda function.", - "id": "create-function-1474653449931", - "title": "create-function" - } - ], - "DeleteAlias": [ - { - "input": { - "FunctionName": "myFunction", - "Name": "alias" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes a Lambda function alias", - "id": "to-delete-a-lambda-function-alias-1481660370804", - "title": "To delete a Lambda function alias" - } - ], - "DeleteEventSourceMapping": [ - { - "input": { - "UUID": "12345kxodurf3443" - }, - "output": { - "BatchSize": 123, - "EventSourceArn": "arn:aws:s3:::examplebucket/*", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "LastModified": "2016-11-21T19:49:20.006+0000", - "LastProcessingResult": "", - "State": "", - "StateTransitionReason": "", - "UUID": "12345kxodurf3443" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes a Lambda function event source mapping", - "id": "to-delete-a-lambda-function-event-source-mapping-1481658973862", - "title": "To delete a Lambda function event source mapping" - } - ], - "DeleteFunction": [ - { - "input": { - "FunctionName": "myFunction", - "Qualifier": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes a Lambda function", - "id": "to-delete-a-lambda-function-1481648553696", - "title": "To delete a Lambda function" - } - ], - "GetAccountSettings": [ - { - "input": { - }, - "output": { - "AccountLimit": { - }, - "AccountUsage": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda customer's account settings", - "id": "to-retrieves-a-lambda-customers-account-settings-1481657495274", - "title": "To retrieves a Lambda customer's account settings" - } - ], - "GetAlias": [ - { - "input": { - "FunctionName": "myFunction", - "Name": "myFunctionAlias" - }, - "output": { - "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunctionAlias", - "Description": "", - "FunctionVersion": "1", - "Name": "myFunctionAlias" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function alias", - "id": "to-retrieve-a-lambda-function-alias-1481648742254", - "title": "To retrieve a Lambda function alias" - } - ], - "GetEventSourceMapping": [ - { - "input": { - "UUID": "123489-xxxxx-kdla8d89d7" - }, - "output": { - "BatchSize": 123, - "EventSourceArn": "arn:aws:iam::123456789012:eventsource", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "LastModified": "2016-11-21T19:49:20.006+0000", - "LastProcessingResult": "", - "State": "", - "StateTransitionReason": "", - "UUID": "123489-xxxxx-kdla8d89d7" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function's event source mapping", - "id": "to-retrieve-a-lambda-functions-event-source-mapping-1481661622799", - "title": "To retrieve a Lambda function's event source mapping" - } - ], - "GetFunction": [ - { - "input": { - "FunctionName": "myFunction", - "Qualifier": "1" - }, - "output": { - "Code": { - "Location": "somelocation", - "RepositoryType": "S3" - }, - "Configuration": { - "CodeSha256": "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=", - "CodeSize": 262, - "Description": "A starter AWS Lambda function.", - "Environment": { - "Variables": { - "S3_BUCKET": "test" - } - }, - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "FunctionName": "myFunction", - "Handler": "index.handler", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "nodejs4.3", - "Timeout": 3, - "Version": "$LATEST", - "VpcConfig": { - "SecurityGroupIds": [ - - ], - "SubnetIds": [ - - ] - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function's event source mapping", - "id": "to-retrieve-a-lambda-functions-event-source-mapping-1481661622799", - "title": "To retrieve a Lambda function's event source mapping" - } - ], - "GetFunctionConfiguration": [ - { - "input": { - "FunctionName": "myFunction", - "Qualifier": "1" - }, - "output": { - "CodeSha256": "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=", - "CodeSize": 123, - "DeadLetterConfig": { - }, - "Description": "", - "Environment": { - }, - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "FunctionName": "myFunction", - "Handler": "index.handler", - "KMSKeyArn": "", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "python2.7", - "Timeout": 123, - "Version": "1", - "VpcConfig": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function's event source mapping", - "id": "to-retrieve-a-lambda-functions-event-source-mapping-1481661622799", - "title": "To retrieve a Lambda function's event source mapping" - } - ], - "GetPolicy": [ - { - "input": { - "FunctionName": "myFunction", - "Qualifier": "1" - }, - "output": { - "Policy": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function policy", - "id": "to-retrieve-a-lambda-function-policy-1481649319053", - "title": "To retrieve a Lambda function policy" - } - ], - "Invoke": [ - { - "input": { - "ClientContext": "MyApp", - "FunctionName": "MyFunction", - "InvocationType": "Event", - "LogType": "Tail", - "Payload": "fileb://file-path/input.json", - "Qualifier": "1" - }, - "output": { - "FunctionError": "", - "LogResult": "", - "Payload": "?", - "StatusCode": 123 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation invokes a Lambda function", - "id": "to-invoke-a-lambda-function-1481659683915", - "title": "To invoke a Lambda function" - } - ], - "InvokeAsync": [ - { - "input": { - "FunctionName": "myFunction", - "InvokeArgs": "fileb://file-path/input.json" - }, - "output": { - "Status": 123 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation invokes a Lambda function asynchronously", - "id": "to-invoke-a-lambda-function-asynchronously-1481649694923", - "title": "To invoke a Lambda function asynchronously" - } - ], - "ListAliases": [ - { - "input": { - "FunctionName": "myFunction", - "FunctionVersion": "1", - "Marker": "", - "MaxItems": 123 - }, - "output": { - "Aliases": [ - - ], - "NextMarker": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function's aliases", - "id": "to-retrieve-a-lambda-function-aliases-1481650199732", - "title": "To retrieve a Lambda function aliases" - } - ], - "ListFunctions": [ - { - "input": { - "Marker": "", - "MaxItems": 123 - }, - "output": { - "Functions": [ - - ], - "NextMarker": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda functions", - "id": "to-retrieve-a-list-of-lambda-functions-1481650507425", - "title": "To retrieve a list of Lambda functions" - } - ], - "ListVersionsByFunction": [ - { - "input": { - "FunctionName": "myFunction", - "Marker": "", - "MaxItems": 123 - }, - "output": { - "NextMarker": "", - "Versions": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation retrieves a Lambda function versions", - "id": "to-retrieve-a-list-of-lambda-function-versions-1481650603750", - "title": "To retrieve a list of Lambda function versions" - } - ], - "PublishVersion": [ - { - "input": { - "CodeSha256": "", - "Description": "", - "FunctionName": "myFunction" - }, - "output": { - "CodeSha256": "", - "CodeSize": 123, - "Description": "", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction:1", - "FunctionName": "myFunction", - "Handler": "index.handler", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "python2.7", - "Timeout": 123, - "Version": "1", - "VpcConfig": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation publishes a version of a Lambda function", - "id": "to-publish-a-version-of-a-lambda-function-1481650704986", - "title": "To publish a version of a Lambda function" - } - ], - "RemovePermission": [ - { - "input": { - "FunctionName": "myFunction", - "Qualifier": "1", - "StatementId": "role-statement-id" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation removes a Lambda function's permissions", - "id": "to-remove-a-lambda-functions-permissions-1481661337021", - "title": "To remove a Lambda function's permissions" - } - ], - "UpdateAlias": [ - { - "input": { - "Description": "", - "FunctionName": "myFunction", - "FunctionVersion": "1", - "Name": "functionAlias" - }, - "output": { - "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:functionAlias", - "Description": "", - "FunctionVersion": "1", - "Name": "functionAlias" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation updates a Lambda function alias", - "id": "to-update-a-lambda-function-alias-1481650817950", - "title": "To update a Lambda function alias" - } - ], - "UpdateEventSourceMapping": [ - { - "input": { - "BatchSize": 123, - "Enabled": true, - "FunctionName": "myFunction", - "UUID": "1234xCy789012" - }, - "output": { - "BatchSize": 123, - "EventSourceArn": "arn:aws:s3:::examplebucket/*", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "LastModified": "2016-11-21T19:49:20.006+0000", - "LastProcessingResult": "", - "State": "", - "StateTransitionReason": "", - "UUID": "1234xCy789012" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation updates a Lambda function event source mapping", - "id": "to-update-a-lambda-function-event-source-mapping-1481650907413", - "title": "To update a Lambda function event source mapping" - } - ], - "UpdateFunctionCode": [ - { - "input": { - "FunctionName": "myFunction", - "Publish": true, - "S3Bucket": "myBucket", - "S3Key": "myKey", - "S3ObjectVersion": "1", - "ZipFile": "fileb://file-path/file.zip" - }, - "output": { - "CodeSha256": "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=", - "CodeSize": 123, - "Description": "", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "FunctionName": "myFunction", - "Handler": "index.handler", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "python2.7", - "Timeout": 123, - "Version": "1", - "VpcConfig": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation updates a Lambda function's code", - "id": "to-update-a-lambda-functions-code-1481650992672", - "title": "To update a Lambda function's code" - } - ], - "UpdateFunctionConfiguration": [ - { - "input": { - "Description": "", - "FunctionName": "myFunction", - "Handler": "index.handler", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "python2.7", - "Timeout": 123, - "VpcConfig": { - } - }, - "output": { - "CodeSha256": "LQT+0DHxxxxcfwLyQjzoEFKZtdqQjHXanlSdfXBlEW0VA=", - "CodeSize": 123, - "Description": "", - "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:myFunction", - "FunctionName": "myFunction", - "Handler": "index.handler", - "LastModified": "2016-11-21T19:49:20.006+0000", - "MemorySize": 128, - "Role": "arn:aws:iam::123456789012:role/lambda_basic_execution", - "Runtime": "python2.7", - "Timeout": 123, - "Version": "1", - "VpcConfig": { - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation updates a Lambda function's configuration", - "id": "to-update-a-lambda-functions-configuration-1481651096447", - "title": "To update a Lambda function's configuration" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/paginators-1.json deleted file mode 100644 index b2d1577f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "ListEventSourceMappings": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "EventSourceMappings" - }, - "ListFunctions": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "Functions" - }, - "ListAliases": { - "input_token": "Marker", - "output_token": "NextMarker", - "limit_key": "MaxItems", - "result_key": "Aliases" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/service-2.json deleted file mode 100644 index 6d406f88..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lambda/2015-03-31/service-2.json +++ /dev/null @@ -1,2442 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-03-31", - "endpointPrefix":"lambda", - "protocol":"rest-json", - "serviceFullName":"AWS Lambda", - "serviceId":"Lambda", - "signatureVersion":"v4", - "uid":"lambda-2015-03-31" - }, - "operations":{ - "AddPermission":{ - "name":"AddPermission", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/functions/{FunctionName}/policy", - "responseCode":201 - }, - "input":{"shape":"AddPermissionRequest"}, - "output":{"shape":"AddPermissionResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceConflictException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"PolicyLengthExceededException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Adds a permission to the resource policy associated with the specified AWS Lambda function. You use resource policies to grant permissions to event sources that use push model. In a push model, event sources (such as Amazon S3 and custom applications) invoke your Lambda function. Each permission you add to the resource policy allows an event source, permission to invoke the Lambda function.

For information about the push model, see Lambda Functions.

If you are using versioning, the permissions you add are specific to the Lambda function version or alias you specify in the AddPermission request via the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:AddPermission action.

" - }, - "CreateAlias":{ - "name":"CreateAlias", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/functions/{FunctionName}/aliases", - "responseCode":201 - }, - "input":{"shape":"CreateAliasRequest"}, - "output":{"shape":"AliasConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceConflictException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates an alias that points to the specified Lambda function version. For more information, see Introduction to AWS Lambda Aliases.

Alias names are unique for a given function. This requires permission for the lambda:CreateAlias action.

" - }, - "CreateEventSourceMapping":{ - "name":"CreateEventSourceMapping", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/event-source-mappings/", - "responseCode":202 - }, - "input":{"shape":"CreateEventSourceMappingRequest"}, - "output":{"shape":"EventSourceMappingConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Identifies a poll-based event source for a Lambda function. It can be either an Amazon Kinesis or DynamoDB stream, or an Amazon SQS queue. AWS Lambda invokes the specified function when records are posted to the event source.

This association between a poll-based source and a Lambda function is called the event source mapping.

You provide mapping information (for example, which stream or SQS queue to read from and which Lambda function to invoke) in the request body.

Amazon Kinesis or DynamoDB stream event sources can be associated with multiple AWS Lambda functions and a given Lambda function can be associated with multiple AWS event sources. For Amazon SQS, you can configure multiple queues as event sources for a single Lambda function, but an SQS queue can be mapped only to a single Lambda function.

If you are using versioning, you can specify a specific function version or an alias via the function name parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:CreateEventSourceMapping action.

" - }, - "CreateFunction":{ - "name":"CreateFunction", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/functions", - "responseCode":201 - }, - "input":{"shape":"CreateFunctionRequest"}, - "output":{"shape":"FunctionConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceConflictException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"CodeStorageExceededException"} - ], - "documentation":"

Creates a new Lambda function. The function metadata is created from the request parameters, and the code for the function is provided by a .zip file in the request body. If the function name already exists, the operation will fail. Note that the function name is case-sensitive.

If you are using versioning, you can also publish a version of the Lambda function you are creating using the Publish parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:CreateFunction action.

" - }, - "DeleteAlias":{ - "name":"DeleteAlias", - "http":{ - "method":"DELETE", - "requestUri":"/2015-03-31/functions/{FunctionName}/aliases/{Name}", - "responseCode":204 - }, - "input":{"shape":"DeleteAliasRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the specified Lambda function alias. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:DeleteAlias action.

" - }, - "DeleteEventSourceMapping":{ - "name":"DeleteEventSourceMapping", - "http":{ - "method":"DELETE", - "requestUri":"/2015-03-31/event-source-mappings/{UUID}", - "responseCode":202 - }, - "input":{"shape":"DeleteEventSourceMappingRequest"}, - "output":{"shape":"EventSourceMappingConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Removes an event source mapping. This means AWS Lambda will no longer invoke the function for events in the associated source.

This operation requires permission for the lambda:DeleteEventSourceMapping action.

" - }, - "DeleteFunction":{ - "name":"DeleteFunction", - "http":{ - "method":"DELETE", - "requestUri":"/2015-03-31/functions/{FunctionName}", - "responseCode":204 - }, - "input":{"shape":"DeleteFunctionRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ResourceConflictException"} - ], - "documentation":"

Deletes the specified Lambda function code and configuration.

If you are using the versioning feature and you don't specify a function version in your DeleteFunction request, AWS Lambda will delete the function, including all its versions, and any aliases pointing to the function versions. To delete a specific function version, you must provide the function version via the Qualifier parameter. For information about function versioning, see AWS Lambda Function Versioning and Aliases.

When you delete a function the associated resource policy is also deleted. You will need to delete the event source mappings explicitly.

This operation requires permission for the lambda:DeleteFunction action.

" - }, - "DeleteFunctionConcurrency":{ - "name":"DeleteFunctionConcurrency", - "http":{ - "method":"DELETE", - "requestUri":"/2017-10-31/functions/{FunctionName}/concurrency", - "responseCode":204 - }, - "input":{"shape":"DeleteFunctionConcurrencyRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Removes concurrent execution limits from this function. For more information, see concurrent-executions.

" - }, - "GetAccountSettings":{ - "name":"GetAccountSettings", - "http":{ - "method":"GET", - "requestUri":"/2016-08-19/account-settings/", - "responseCode":200 - }, - "input":{"shape":"GetAccountSettingsRequest"}, - "output":{"shape":"GetAccountSettingsResponse"}, - "errors":[ - {"shape":"TooManyRequestsException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Returns a customer's account settings.

You can use this operation to retrieve Lambda limits information, such as code size and concurrency limits. For more information about limits, see AWS Lambda Limits. You can also retrieve resource usage statistics, such as code storage usage and function count.

" - }, - "GetAlias":{ - "name":"GetAlias", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}/aliases/{Name}", - "responseCode":200 - }, - "input":{"shape":"GetAliasRequest"}, - "output":{"shape":"AliasConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns the specified alias information such as the alias ARN, description, and function version it is pointing to. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:GetAlias action.

" - }, - "GetEventSourceMapping":{ - "name":"GetEventSourceMapping", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/event-source-mappings/{UUID}", - "responseCode":200 - }, - "input":{"shape":"GetEventSourceMappingRequest"}, - "output":{"shape":"EventSourceMappingConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns configuration information for the specified event source mapping (see CreateEventSourceMapping).

This operation requires permission for the lambda:GetEventSourceMapping action.

" - }, - "GetFunction":{ - "name":"GetFunction", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}", - "responseCode":200 - }, - "input":{"shape":"GetFunctionRequest"}, - "output":{"shape":"GetFunctionResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns the configuration information of the Lambda function and a presigned URL link to the .zip file you uploaded with CreateFunction so you can download the .zip file. Note that the URL is valid for up to 10 minutes. The configuration information is the same information you provided as parameters when uploading the function.

Using the optional Qualifier parameter, you can specify a specific function version for which you want this information. If you don't specify this parameter, the API uses unqualified function ARN which return information about the $LATEST version of the Lambda function. For more information, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunction action.

" - }, - "GetFunctionConfiguration":{ - "name":"GetFunctionConfiguration", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}/configuration", - "responseCode":200 - }, - "input":{"shape":"GetFunctionConfigurationRequest"}, - "output":{"shape":"FunctionConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns the configuration information of the Lambda function. This the same information you provided as parameters when uploading the function by using CreateFunction.

If you are using the versioning feature, you can retrieve this information for a specific function version by using the optional Qualifier parameter and specifying the function version or alias that points to it. If you don't provide it, the API returns information about the $LATEST version of the function. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunctionConfiguration operation.

" - }, - "GetPolicy":{ - "name":"GetPolicy", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}/policy", - "responseCode":200 - }, - "input":{"shape":"GetPolicyRequest"}, - "output":{"shape":"GetPolicyResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns the resource policy associated with the specified Lambda function.

If you are using the versioning feature, you can get the resource policy associated with the specific Lambda function version or alias by specifying the version or alias name using the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

You need permission for the lambda:GetPolicy action.

" - }, - "Invoke":{ - "name":"Invoke", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/functions/{FunctionName}/invocations" - }, - "input":{"shape":"InvocationRequest"}, - "output":{"shape":"InvocationResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestContentException"}, - {"shape":"RequestTooLargeException"}, - {"shape":"UnsupportedMediaTypeException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"EC2UnexpectedException"}, - {"shape":"SubnetIPAddressLimitReachedException"}, - {"shape":"ENILimitReachedException"}, - {"shape":"EC2ThrottledException"}, - {"shape":"EC2AccessDeniedException"}, - {"shape":"InvalidSubnetIDException"}, - {"shape":"InvalidSecurityGroupIDException"}, - {"shape":"InvalidZipFileException"}, - {"shape":"KMSDisabledException"}, - {"shape":"KMSInvalidStateException"}, - {"shape":"KMSAccessDeniedException"}, - {"shape":"KMSNotFoundException"}, - {"shape":"InvalidRuntimeException"} - ], - "documentation":"

Invokes a specific Lambda function. For an example, see Create the Lambda Function and Test It Manually.

If you are using the versioning feature, you can invoke the specific function version by providing function version or alias name that is pointing to the function version using the Qualifier parameter in the request. If you don't provide the Qualifier parameter, the $LATEST version of the Lambda function is invoked. Invocations occur at least once in response to an event and functions must be idempotent to handle this. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:InvokeFunction action.

The TooManyRequestsException noted below will return the following: ConcurrentInvocationLimitExceeded will be returned if you have no functions with reserved concurrency and have exceeded your account concurrent limit or if a function without reserved concurrency exceeds the account's unreserved concurrency limit. ReservedFunctionConcurrentInvocationLimitExceeded will be returned when a function with reserved concurrency exceeds its configured concurrency limit.

" - }, - "InvokeAsync":{ - "name":"InvokeAsync", - "http":{ - "method":"POST", - "requestUri":"/2014-11-13/functions/{FunctionName}/invoke-async/", - "responseCode":202 - }, - "input":{"shape":"InvokeAsyncRequest"}, - "output":{"shape":"InvokeAsyncResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestContentException"}, - {"shape":"InvalidRuntimeException"} - ], - "documentation":"

This API is deprecated. We recommend you use Invoke API (see Invoke).

Submits an invocation request to AWS Lambda. Upon receiving the request, Lambda executes the specified function asynchronously. To see the logs generated by the Lambda function execution, see the CloudWatch Logs console.

This operation requires permission for the lambda:InvokeFunction action.

", - "deprecated":true - }, - "ListAliases":{ - "name":"ListAliases", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}/aliases", - "responseCode":200 - }, - "input":{"shape":"ListAliasesRequest"}, - "output":{"shape":"ListAliasesResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns list of aliases created for a Lambda function. For each alias, the response includes information such as the alias ARN, description, alias name, and the function version to which it points. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:ListAliases action.

" - }, - "ListEventSourceMappings":{ - "name":"ListEventSourceMappings", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/event-source-mappings/", - "responseCode":200 - }, - "input":{"shape":"ListEventSourceMappingsRequest"}, - "output":{"shape":"ListEventSourceMappingsResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns a list of event source mappings you created using the CreateEventSourceMapping (see CreateEventSourceMapping).

For each mapping, the API returns configuration information. You can optionally specify filters to retrieve specific event source mappings.

If you are using the versioning feature, you can get list of event source mappings for a specific Lambda function version or an alias as described in the FunctionName parameter. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:ListEventSourceMappings action.

" - }, - "ListFunctions":{ - "name":"ListFunctions", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/", - "responseCode":200 - }, - "input":{"shape":"ListFunctionsRequest"}, - "output":{"shape":"ListFunctionsResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InvalidParameterValueException"} - ], - "documentation":"

Returns a list of your Lambda functions. For each function, the response includes the function configuration information. You must use GetFunction to retrieve the code for your function.

This operation requires permission for the lambda:ListFunctions action.

If you are using the versioning feature, you can list all of your functions or only $LATEST versions. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"GET", - "requestUri":"/2017-03-31/tags/{ARN}" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns a list of tags assigned to a function when supplied the function ARN (Amazon Resource Name). For more information on Tagging, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - }, - "ListVersionsByFunction":{ - "name":"ListVersionsByFunction", - "http":{ - "method":"GET", - "requestUri":"/2015-03-31/functions/{FunctionName}/versions", - "responseCode":200 - }, - "input":{"shape":"ListVersionsByFunctionRequest"}, - "output":{"shape":"ListVersionsByFunctionResponse"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

List all versions of a function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

" - }, - "PublishVersion":{ - "name":"PublishVersion", - "http":{ - "method":"POST", - "requestUri":"/2015-03-31/functions/{FunctionName}/versions", - "responseCode":201 - }, - "input":{"shape":"PublishVersionRequest"}, - "output":{"shape":"FunctionConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"CodeStorageExceededException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Publishes a version of your function from the current snapshot of $LATEST. That is, AWS Lambda takes a snapshot of the function code and configuration information from $LATEST and publishes a new version. The code and configuration cannot be modified after publication. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

" - }, - "PutFunctionConcurrency":{ - "name":"PutFunctionConcurrency", - "http":{ - "method":"PUT", - "requestUri":"/2017-10-31/functions/{FunctionName}/concurrency", - "responseCode":200 - }, - "input":{"shape":"PutFunctionConcurrencyRequest"}, - "output":{"shape":"Concurrency"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Sets a limit on the number of concurrent executions available to this function. It is a subset of your account's total concurrent execution limit per region. Note that Lambda automatically reserves a buffer of 100 concurrent executions for functions without any reserved concurrency limit. This means if your account limit is 1000, you have a total of 900 available to allocate to individual functions. For more information, see concurrent-executions.

" - }, - "RemovePermission":{ - "name":"RemovePermission", - "http":{ - "method":"DELETE", - "requestUri":"/2015-03-31/functions/{FunctionName}/policy/{StatementId}", - "responseCode":204 - }, - "input":{"shape":"RemovePermissionRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

You can remove individual permissions from an resource policy associated with a Lambda function by providing a statement ID that you provided when you added the permission.

If you are using versioning, the permissions you remove are specific to the Lambda function version or alias you specify in the AddPermission request via the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

Note that removal of a permission will cause an active event source to lose permission to the function.

You need permission for the lambda:RemovePermission action.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/2017-03-31/tags/{ARN}", - "responseCode":204 - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a list of tags (key-value pairs) on the Lambda function. Requires the Lambda function ARN (Amazon Resource Name). If a key is specified without a value, Lambda creates a tag with the specified key and a value of null. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"DELETE", - "requestUri":"/2017-03-31/tags/{ARN}", - "responseCode":204 - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Removes tags from a Lambda function. Requires the function ARN (Amazon Resource Name). For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - }, - "UpdateAlias":{ - "name":"UpdateAlias", - "http":{ - "method":"PUT", - "requestUri":"/2015-03-31/functions/{FunctionName}/aliases/{Name}", - "responseCode":200 - }, - "input":{"shape":"UpdateAliasRequest"}, - "output":{"shape":"AliasConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Using this API you can update the function version to which the alias points and the alias description. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:UpdateAlias action.

" - }, - "UpdateEventSourceMapping":{ - "name":"UpdateEventSourceMapping", - "http":{ - "method":"PUT", - "requestUri":"/2015-03-31/event-source-mappings/{UUID}", - "responseCode":202 - }, - "input":{"shape":"UpdateEventSourceMappingRequest"}, - "output":{"shape":"EventSourceMappingConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceConflictException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

You can update an event source mapping. This is useful if you want to change the parameters of the existing mapping without losing your position in the stream. You can change which function will receive the stream records, but to change the stream itself, you must create a new mapping.

If you are using the versioning feature, you can update the event source mapping to map to a specific Lambda function version or alias as described in the FunctionName parameter. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

If you disable the event source mapping, AWS Lambda stops polling. If you enable again, it will resume polling from the time it had stopped polling, so you don't lose processing of any records. However, if you delete event source mapping and create it again, it will reset.

This operation requires permission for the lambda:UpdateEventSourceMapping action.

" - }, - "UpdateFunctionCode":{ - "name":"UpdateFunctionCode", - "http":{ - "method":"PUT", - "requestUri":"/2015-03-31/functions/{FunctionName}/code", - "responseCode":200 - }, - "input":{"shape":"UpdateFunctionCodeRequest"}, - "output":{"shape":"FunctionConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"CodeStorageExceededException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Updates the code for the specified Lambda function. This operation must only be used on an existing Lambda function and cannot be used to update the function configuration.

If you are using the versioning feature, note this API will always update the $LATEST version of your Lambda function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:UpdateFunctionCode action.

" - }, - "UpdateFunctionConfiguration":{ - "name":"UpdateFunctionConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/2015-03-31/functions/{FunctionName}/configuration", - "responseCode":200 - }, - "input":{"shape":"UpdateFunctionConfigurationRequest"}, - "output":{"shape":"FunctionConfiguration"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ResourceConflictException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Updates the configuration parameters for the specified Lambda function by using the values provided in the request. You provide only the parameters you want to change. This operation must only be used on an existing Lambda function and cannot be used to update the function's code.

If you are using the versioning feature, note this API will always update the $LATEST version of your Lambda function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:UpdateFunctionConfiguration action.

" - } - }, - "shapes":{ - "AccountLimit":{ - "type":"structure", - "members":{ - "TotalCodeSize":{ - "shape":"Long", - "documentation":"

Maximum size, in bytes, of a code package you can upload per region. The default size is 75 GB.

" - }, - "CodeSizeUnzipped":{ - "shape":"Long", - "documentation":"

Size, in bytes, of code/dependencies that you can zip into a deployment package (uncompressed zip/jar size) for uploading. The default limit is 250 MB.

" - }, - "CodeSizeZipped":{ - "shape":"Long", - "documentation":"

Size, in bytes, of a single zipped code/dependencies package you can upload for your Lambda function(.zip/.jar file). Try using Amazon S3 for uploading larger files. Default limit is 50 MB.

" - }, - "ConcurrentExecutions":{ - "shape":"Integer", - "documentation":"

Number of simultaneous executions of your function per region. For more information or to request a limit increase for concurrent executions, see Lambda Function Concurrent Executions. The default limit is 1000.

" - }, - "UnreservedConcurrentExecutions":{ - "shape":"UnreservedConcurrentExecutions", - "documentation":"

The number of concurrent executions available to functions that do not have concurrency limits set. For more information, see concurrent-executions.

" - } - }, - "documentation":"

Provides limits of code size and concurrency associated with the current account and region.

" - }, - "AccountUsage":{ - "type":"structure", - "members":{ - "TotalCodeSize":{ - "shape":"Long", - "documentation":"

Total size, in bytes, of the account's deployment packages per region.

" - }, - "FunctionCount":{ - "shape":"Long", - "documentation":"

The number of your account's existing functions per region.

" - } - }, - "documentation":"

Provides code size usage and function count associated with the current account and region.

" - }, - "Action":{ - "type":"string", - "pattern":"(lambda:[*]|lambda:[a-zA-Z]+|[*])" - }, - "AddPermissionRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "StatementId", - "Action", - "Principal" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

Name of the Lambda function whose resource policy you are updating by adding a new permission.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "StatementId":{ - "shape":"StatementId", - "documentation":"

A unique statement identifier.

" - }, - "Action":{ - "shape":"Action", - "documentation":"

The AWS Lambda action you want to allow in this statement. Each Lambda action is a string starting with lambda: followed by the API name . For example, lambda:CreateFunction. You can use wildcard (lambda:*) to grant permission for all AWS Lambda actions.

" - }, - "Principal":{ - "shape":"Principal", - "documentation":"

The principal who is getting this permission. It can be Amazon S3 service Principal (s3.amazonaws.com) if you want Amazon S3 to invoke the function, an AWS account ID if you are granting cross-account permission, or any valid AWS service principal such as sns.amazonaws.com. For example, you might want to allow a custom application in another AWS account to push events to AWS Lambda by invoking your function.

" - }, - "SourceArn":{ - "shape":"Arn", - "documentation":"

This is optional; however, when granting permission to invoke your function, you should specify this field with the Amazon Resource Name (ARN) as its value. This ensures that only events generated from the specified source can invoke the function.

If you add a permission without providing the source ARN, any AWS account that creates a mapping to your function ARN can send events to invoke your Lambda function.

" - }, - "SourceAccount":{ - "shape":"SourceOwner", - "documentation":"

This parameter is used for S3 and SES. The AWS account ID (without a hyphen) of the source owner. For example, if the SourceArn identifies a bucket, then this is the bucket owner's account ID. You can use this additional condition to ensure the bucket you specify is owned by a specific account (it is possible the bucket owner deleted the bucket and some other AWS account created the bucket). You can also use this condition to specify all sources (that is, you don't specify the SourceArn) owned by a specific account.

" - }, - "EventSourceToken":{ - "shape":"EventSourceToken", - "documentation":"

A unique token that must be supplied by the principal invoking the function. This is currently only used for Alexa Smart Home functions.

" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

You can use this optional query parameter to describe a qualified ARN using a function version or an alias name. The permission will then apply to the specific qualified ARN. For example, if you specify function version 2 as the qualifier, then permission applies only when request is made using qualified function ARN:

arn:aws:lambda:aws-region:acct-id:function:function-name:2

If you specify an alias name, for example PROD, then the permission is valid only for requests made using the alias ARN:

arn:aws:lambda:aws-region:acct-id:function:function-name:PROD

If the qualifier is not specified, the permission is valid only when requests is made using unqualified function ARN.

arn:aws:lambda:aws-region:acct-id:function:function-name

", - "location":"querystring", - "locationName":"Qualifier" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" - } - }, - "documentation":"

" - }, - "AddPermissionResponse":{ - "type":"structure", - "members":{ - "Statement":{ - "shape":"String", - "documentation":"

The permission statement you specified in the request. The response returns the same as a string using a backslash (\"\\\") as an escape character in the JSON.

" - } - }, - "documentation":"

" - }, - "AdditionalVersion":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"[0-9]+" - }, - "AdditionalVersionWeights":{ - "type":"map", - "key":{"shape":"AdditionalVersion"}, - "value":{"shape":"Weight"} - }, - "Alias":{ - "type":"string", - "max":128, - "min":1, - "pattern":"(?!^[0-9]+$)([a-zA-Z0-9-_]+)" - }, - "AliasConfiguration":{ - "type":"structure", - "members":{ - "AliasArn":{ - "shape":"FunctionArn", - "documentation":"

Lambda function ARN that is qualified using the alias name as the suffix. For example, if you create an alias called BETA that points to a helloworld function version, the ARN is arn:aws:lambda:aws-regions:acct-id:function:helloworld:BETA.

" - }, - "Name":{ - "shape":"Alias", - "documentation":"

Alias name.

" - }, - "FunctionVersion":{ - "shape":"Version", - "documentation":"

Function version to which the alias points.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Alias description.

" - }, - "RoutingConfig":{ - "shape":"AliasRoutingConfiguration", - "documentation":"

Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

Represents the latest updated revision of the function or alias.

" - } - }, - "documentation":"

Provides configuration information about a Lambda function version alias.

" - }, - "AliasList":{ - "type":"list", - "member":{"shape":"AliasConfiguration"} - }, - "AliasRoutingConfiguration":{ - "type":"structure", - "members":{ - "AdditionalVersionWeights":{ - "shape":"AdditionalVersionWeights", - "documentation":"

Set this value to dictate what percentage of traffic will invoke the updated function version. If set to an empty string, 100 percent of traffic will invoke function-version. For more information, see lambda-traffic-shifting-using-aliases.

" - } - }, - "documentation":"

The parent object that implements what percentage of traffic will invoke each function version. For more information, see lambda-traffic-shifting-using-aliases.

" - }, - "Arn":{ - "type":"string", - "pattern":"arn:aws:([a-zA-Z0-9\\-])+:([a-z]{2}-[a-z]+-\\d{1})?:(\\d{12})?:(.*)" - }, - "BatchSize":{ - "type":"integer", - "max":10000, - "min":1 - }, - "Blob":{ - "type":"blob", - "sensitive":true - }, - "BlobStream":{ - "type":"blob", - "streaming":true - }, - "Boolean":{"type":"boolean"}, - "CodeStorageExceededException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

" - }, - "message":{"shape":"String"} - }, - "documentation":"

You have exceeded your maximum total code size per account. Limits

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Concurrency":{ - "type":"structure", - "members":{ - "ReservedConcurrentExecutions":{ - "shape":"ReservedConcurrentExecutions", - "documentation":"

The number of concurrent executions reserved for this function. For more information, see concurrent-executions.

" - } - } - }, - "CreateAliasRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "Name", - "FunctionVersion" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

Name of the Lambda function for which you want to create an alias. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Name":{ - "shape":"Alias", - "documentation":"

Name for the alias you are creating.

" - }, - "FunctionVersion":{ - "shape":"Version", - "documentation":"

Lambda function version for which you are creating the alias.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Description of the alias.

" - }, - "RoutingConfig":{ - "shape":"AliasRoutingConfiguration", - "documentation":"

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

" - } - } - }, - "CreateEventSourceMappingRequest":{ - "type":"structure", - "required":[ - "EventSourceArn", - "FunctionName" - ], - "members":{ - "EventSourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the event source. Any record added to this source could cause AWS Lambda to invoke your Lambda function, it depends on the BatchSize. AWS Lambda POSTs the event's records to your Lambda function as JSON.

" - }, - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function to invoke when AWS Lambda detects an event on the stream.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail).

If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). For more information about versioning, see AWS Lambda Function Versioning and Aliases

AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail).

Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Indicates whether AWS Lambda should begin polling the event source. By default, Enabled is true.

" - }, - "BatchSize":{ - "shape":"BatchSize", - "documentation":"

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. The default for Amazon Kinesis and Amazon DynamoDB is 100 records. For SQS, the default is 1.

" - }, - "StartingPosition":{ - "shape":"EventSourcePosition", - "documentation":"

The position in the DynamoDB or Kinesis stream where AWS Lambda should start reading. For more information, see GetShardIterator in the Amazon Kinesis API Reference Guide or GetShardIterator in the Amazon DynamoDB API Reference Guide. The AT_TIMESTAMP value is supported only for Kinesis streams.

" - }, - "StartingPositionTimestamp":{ - "shape":"Date", - "documentation":"

The timestamp of the data record from which to start reading. Used with shard iterator type AT_TIMESTAMP. If a record with this exact timestamp does not exist, the iterator returned is for the next (later) record. If the timestamp is older than the current trim horizon, the iterator returned is for the oldest untrimmed data record (TRIM_HORIZON). Valid only for Kinesis streams.

" - } - }, - "documentation":"

" - }, - "CreateFunctionRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "Runtime", - "Role", - "Handler", - "Code" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name you want to assign to the function you are uploading. The function names appear in the console and are returned in the ListFunctions API. Function names are used to specify functions to other AWS Lambda API operations, such as Invoke. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

" - }, - "Runtime":{ - "shape":"Runtime", - "documentation":"

The runtime environment for the Lambda function you are uploading.

To use the Python runtime v3.6, set the value to \"python3.6\". To use the Python runtime v2.7, set the value to \"python2.7\". To use the Node.js runtime v6.10, set the value to \"nodejs6.10\". To use the Node.js runtime v4.3, set the value to \"nodejs4.3\". To use the .NET Core runtime v1.0, set the value to \"dotnetcore1.0\". To use the .NET Core runtime v2.0, set the value to \"dotnetcore2.0\".

Node v0.10.42 is currently marked as deprecated. You must migrate existing functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 or nodejs6.10) as soon as possible. Failure to do so will result in an invalid parameter error being returned. Note that you will have to follow this procedure for each region that contains functions written in the Node v0.10.42 runtime.

" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources. For more information, see AWS Lambda: How it Works.

" - }, - "Handler":{ - "shape":"Handler", - "documentation":"

The function within your code that Lambda calls to begin execution. For Node.js, it is the module-name.export value in your function. For Java, it can be package.class-name::handler or package.class-name. For more information, see Lambda Function Handler (Java).

" - }, - "Code":{ - "shape":"FunctionCode", - "documentation":"

The code for the Lambda function.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "documentation":"

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU and memory allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

" - }, - "Publish":{ - "shape":"Boolean", - "documentation":"

This boolean parameter can be used to request AWS Lambda to create the Lambda function and publish a version as an atomic operation.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

" - }, - "DeadLetterConfig":{ - "shape":"DeadLetterConfig", - "documentation":"

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

" - }, - "Environment":{"shape":"Environment"}, - "KMSKeyArn":{ - "shape":"KMSKeyArn", - "documentation":"

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.

" - }, - "TracingConfig":{ - "shape":"TracingConfig", - "documentation":"

The parent object that contains your function's tracing settings.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The list of tags (key-value pairs) assigned to the new function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - } - }, - "documentation":"

" - }, - "Date":{"type":"timestamp"}, - "DeadLetterConfig":{ - "type":"structure", - "members":{ - "TargetArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic you specify as your Dead Letter Queue (DLQ). dlq. For more information, see dlq.

" - } - }, - "documentation":"

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic you specify as your Dead Letter Queue (DLQ). For more information, see dlq.

" - }, - "DeleteAliasRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "Name" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function name for which the alias is created. Deleting an alias does not delete the function version to which it is pointing. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Name":{ - "shape":"Alias", - "documentation":"

Name of the alias to delete.

", - "location":"uri", - "locationName":"Name" - } - } - }, - "DeleteEventSourceMappingRequest":{ - "type":"structure", - "required":["UUID"], - "members":{ - "UUID":{ - "shape":"String", - "documentation":"

The event source mapping ID.

", - "location":"uri", - "locationName":"UUID" - } - }, - "documentation":"

" - }, - "DeleteFunctionConcurrencyRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name of the function you are removing concurrent execution limits from. For more information, see concurrent-executions.

", - "location":"uri", - "locationName":"FunctionName" - } - } - }, - "DeleteFunctionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function to delete.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

Using this optional parameter you can specify a function version (but not the $LATEST version) to direct AWS Lambda to delete a specific function version. If the function version has one or more aliases pointing to it, you will get an error because you cannot have aliases pointing to it. You can delete any function version but not the $LATEST, that is, you cannot specify $LATEST as the value of this parameter. The $LATEST version can be deleted only when you want to delete all the function versions and aliases.

You can only specify a function version, not an alias name, using this parameter. You cannot delete a function version using its alias.

If you don't specify this parameter, AWS Lambda will delete the function, including all of its versions and aliases.

", - "location":"querystring", - "locationName":"Qualifier" - } - } - }, - "Description":{ - "type":"string", - "max":256, - "min":0 - }, - "EC2AccessDeniedException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "EC2ThrottledException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

AWS Lambda was throttled by Amazon EC2 during Lambda function initialization using the execution role provided for the Lambda function.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "EC2UnexpectedException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"}, - "EC2ErrorCode":{"shape":"String"} - }, - "documentation":"

AWS Lambda received an unexpected EC2 client exception while setting up for the Lambda function.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "ENILimitReachedException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

AWS Lambda was not able to create an Elastic Network Interface (ENI) in the VPC, specified as part of Lambda function configuration, because the limit for network interfaces has been reached.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "Enabled":{"type":"boolean"}, - "Environment":{ - "type":"structure", - "members":{ - "Variables":{ - "shape":"EnvironmentVariables", - "documentation":"

The key-value pairs that represent your environment's configuration settings.

" - } - }, - "documentation":"

The parent object that contains your environment's configuration settings.

" - }, - "EnvironmentError":{ - "type":"structure", - "members":{ - "ErrorCode":{ - "shape":"String", - "documentation":"

The error code returned by the environment error object.

" - }, - "Message":{ - "shape":"SensitiveString", - "documentation":"

The message returned by the environment error object.

" - } - }, - "documentation":"

The parent object that contains error information associated with your configuration settings.

" - }, - "EnvironmentResponse":{ - "type":"structure", - "members":{ - "Variables":{ - "shape":"EnvironmentVariables", - "documentation":"

The key-value pairs returned that represent your environment's configuration settings or error information.

" - }, - "Error":{"shape":"EnvironmentError"} - }, - "documentation":"

The parent object returned that contains your environment's configuration settings or any error information associated with your configuration settings.

" - }, - "EnvironmentVariableName":{ - "type":"string", - "pattern":"[a-zA-Z]([a-zA-Z0-9_])+", - "sensitive":true - }, - "EnvironmentVariableValue":{ - "type":"string", - "sensitive":true - }, - "EnvironmentVariables":{ - "type":"map", - "key":{"shape":"EnvironmentVariableName"}, - "value":{"shape":"EnvironmentVariableValue"}, - "sensitive":true - }, - "EventSourceMappingConfiguration":{ - "type":"structure", - "members":{ - "UUID":{ - "shape":"String", - "documentation":"

The AWS Lambda assigned opaque identifier for the mapping.

" - }, - "BatchSize":{ - "shape":"BatchSize", - "documentation":"

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records.

" - }, - "EventSourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream or the SQS queue that is the source of events.

" - }, - "FunctionArn":{ - "shape":"FunctionArn", - "documentation":"

The Lambda function to invoke when AWS Lambda detects an event on the poll-based source.

" - }, - "LastModified":{ - "shape":"Date", - "documentation":"

The UTC time string indicating the last time the event mapping was updated.

" - }, - "LastProcessingResult":{ - "shape":"String", - "documentation":"

The result of the last AWS Lambda invocation of your Lambda function.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the event source mapping. It can be Creating, Enabled, Disabled, Enabling, Disabling, Updating, or Deleting.

" - }, - "StateTransitionReason":{ - "shape":"String", - "documentation":"

The reason the event source mapping is in its current state. It is either user-requested or an AWS Lambda-initiated state transition.

" - } - }, - "documentation":"

Describes mapping between an Amazon Kinesis or DynamoDB stream or an Amazon SQS queue and a Lambda function.

" - }, - "EventSourceMappingsList":{ - "type":"list", - "member":{"shape":"EventSourceMappingConfiguration"} - }, - "EventSourcePosition":{ - "type":"string", - "enum":[ - "TRIM_HORIZON", - "LATEST", - "AT_TIMESTAMP" - ] - }, - "EventSourceToken":{ - "type":"string", - "max":256, - "min":0, - "pattern":"[a-zA-Z0-9._\\-]+" - }, - "FunctionArn":{ - "type":"string", - "pattern":"arn:aws:lambda:[a-z]{2}-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" - }, - "FunctionCode":{ - "type":"structure", - "members":{ - "ZipFile":{ - "shape":"Blob", - "documentation":"

The contents of your zip file containing your deployment package. If you are using the web API directly, the contents of the zip file must be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the encoding for you. For more information about creating a .zip file, see Execution Permissions in the AWS Lambda Developer Guide.

" - }, - "S3Bucket":{ - "shape":"S3Bucket", - "documentation":"

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS region where you are creating the Lambda function.

" - }, - "S3Key":{ - "shape":"S3Key", - "documentation":"

The Amazon S3 object (the deployment package) key name you want to upload.

" - }, - "S3ObjectVersion":{ - "shape":"S3ObjectVersion", - "documentation":"

The Amazon S3 object (the deployment package) version you want to upload.

" - } - }, - "documentation":"

The code for the Lambda function.

" - }, - "FunctionCodeLocation":{ - "type":"structure", - "members":{ - "RepositoryType":{ - "shape":"String", - "documentation":"

The repository from which you can download the function.

" - }, - "Location":{ - "shape":"String", - "documentation":"

The presigned URL you can use to download the function's .zip file that you previously uploaded. The URL is valid for up to 10 minutes.

" - } - }, - "documentation":"

The object for the Lambda function location.

" - }, - "FunctionConfiguration":{ - "type":"structure", - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

The name of the function. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

" - }, - "FunctionArn":{ - "shape":"NameSpacedFunctionArn", - "documentation":"

The Amazon Resource Name (ARN) assigned to the function.

" - }, - "Runtime":{ - "shape":"Runtime", - "documentation":"

The runtime environment for the Lambda function.

" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

" - }, - "Handler":{ - "shape":"Handler", - "documentation":"

The function Lambda calls to begin executing your function.

" - }, - "CodeSize":{ - "shape":"Long", - "documentation":"

The size, in bytes, of the function .zip file you uploaded.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The user-provided description.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "documentation":"

The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.

" - }, - "LastModified":{ - "shape":"Timestamp", - "documentation":"

The time stamp of the last time you updated the function. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats.

" - }, - "CodeSha256":{ - "shape":"String", - "documentation":"

It is the SHA256 hash of your function deployment package.

" - }, - "Version":{ - "shape":"Version", - "documentation":"

The version of the Lambda function.

" - }, - "VpcConfig":{ - "shape":"VpcConfigResponse", - "documentation":"

VPC configuration associated with your Lambda function.

" - }, - "DeadLetterConfig":{ - "shape":"DeadLetterConfig", - "documentation":"

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

" - }, - "Environment":{ - "shape":"EnvironmentResponse", - "documentation":"

The parent object that contains your environment's configuration settings.

" - }, - "KMSKeyArn":{ - "shape":"KMSKeyArn", - "documentation":"

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.

" - }, - "TracingConfig":{ - "shape":"TracingConfigResponse", - "documentation":"

The parent object that contains your function's tracing settings.

" - }, - "MasterArn":{ - "shape":"FunctionArn", - "documentation":"

Returns the ARN (Amazon Resource Name) of the master function.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

Represents the latest updated revision of the function or alias.

" - } - }, - "documentation":"

A complex type that describes function metadata.

" - }, - "FunctionList":{ - "type":"list", - "member":{"shape":"FunctionConfiguration"} - }, - "FunctionName":{ - "type":"string", - "max":140, - "min":1, - "pattern":"(arn:aws:lambda:)?([a-z]{2}-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" - }, - "FunctionVersion":{ - "type":"string", - "enum":["ALL"] - }, - "GetAccountSettingsRequest":{ - "type":"structure", - "members":{ - } - }, - "GetAccountSettingsResponse":{ - "type":"structure", - "members":{ - "AccountLimit":{"shape":"AccountLimit"}, - "AccountUsage":{"shape":"AccountUsage"} - } - }, - "GetAliasRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "Name" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

Function name for which the alias is created. An alias is a subresource that exists only in the context of an existing Lambda function so you must specify the function name. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Name":{ - "shape":"Alias", - "documentation":"

Name of the alias for which you want to retrieve information.

", - "location":"uri", - "locationName":"Name" - } - } - }, - "GetEventSourceMappingRequest":{ - "type":"structure", - "required":["UUID"], - "members":{ - "UUID":{ - "shape":"String", - "documentation":"

The AWS Lambda assigned ID of the event source mapping.

", - "location":"uri", - "locationName":"UUID" - } - }, - "documentation":"

" - }, - "GetFunctionConfigurationRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

The name of the Lambda function for which you want to retrieve the configuration information.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

Using this optional parameter you can specify a function version or an alias name. If you specify function version, the API uses qualified function ARN and returns information about the specific function version. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points.

If you don't specify this parameter, the API uses unqualified function ARN, and returns information about the $LATEST function version.

", - "location":"querystring", - "locationName":"Qualifier" - } - }, - "documentation":"

" - }, - "GetFunctionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

The Lambda function name.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

Use this optional parameter to specify a function version or an alias name. If you specify function version, the API uses qualified function ARN for the request and returns information about the specific Lambda function version. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points. If you don't provide this parameter, the API uses unqualified function ARN and returns information about the $LATEST version of the Lambda function.

", - "location":"querystring", - "locationName":"Qualifier" - } - }, - "documentation":"

" - }, - "GetFunctionResponse":{ - "type":"structure", - "members":{ - "Configuration":{"shape":"FunctionConfiguration"}, - "Code":{"shape":"FunctionCodeLocation"}, - "Tags":{ - "shape":"Tags", - "documentation":"

Returns the list of tags associated with the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - }, - "Concurrency":{ - "shape":"Concurrency", - "documentation":"

The concurrent execution limit set for this function. For more information, see concurrent-executions.

" - } - }, - "documentation":"

This response contains the object for the Lambda function location (see FunctionCodeLocation.

" - }, - "GetPolicyRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

Function name whose resource policy you want to retrieve.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

You can specify this optional query parameter to specify a function version or an alias name in which case this API will return all permissions associated with the specific qualified ARN. If you don't provide this parameter, the API will return permissions that apply to the unqualified function ARN.

", - "location":"querystring", - "locationName":"Qualifier" - } - }, - "documentation":"

" - }, - "GetPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"String", - "documentation":"

The resource policy associated with the specified function. The response returns the same as a string using a backslash (\"\\\") as an escape character in the JSON.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

Represents the latest updated revision of the function or alias.

" - } - }, - "documentation":"

" - }, - "Handler":{ - "type":"string", - "max":128, - "pattern":"[^\\s]+" - }, - "HttpStatus":{"type":"integer"}, - "Integer":{"type":"integer"}, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

" - }, - "message":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

One of the parameters in the request is invalid. For example, if you provided an IAM role for AWS Lambda to assume in the CreateFunction or the UpdateFunctionConfiguration API, that AWS Lambda is unable to assume you will get this exception.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRequestContentException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

" - }, - "message":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

The request body could not be parsed as JSON.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidRuntimeException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

The runtime or runtime version specified is not supported.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "InvalidSecurityGroupIDException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

The Security Group ID provided in the Lambda function VPC configuration is invalid.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "InvalidSubnetIDException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

The Subnet ID provided in the Lambda function VPC configuration is invalid.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "InvalidZipFileException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

AWS Lambda could not unzip the function zip file.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "InvocationRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

The Lambda function name.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "InvocationType":{ - "shape":"InvocationType", - "documentation":"

By default, the Invoke API assumes RequestResponse invocation type. You can optionally request asynchronous execution by specifying Event as the InvocationType. You can also use this parameter to request AWS Lambda to not execute the function but do some verification, such as if the caller is authorized to invoke the function and if the inputs are valid. You request this by specifying DryRun as the InvocationType. This is useful in a cross-account scenario when you want to verify access to a function without running it.

", - "location":"header", - "locationName":"X-Amz-Invocation-Type" - }, - "LogType":{ - "shape":"LogType", - "documentation":"

You can set this optional parameter to Tail in the request only if you specify the InvocationType parameter with value RequestResponse. In this case, AWS Lambda returns the base64-encoded last 4 KB of log data produced by your Lambda function in the x-amz-log-result header.

", - "location":"header", - "locationName":"X-Amz-Log-Type" - }, - "ClientContext":{ - "shape":"String", - "documentation":"

Using the ClientContext you can pass client-specific information to the Lambda function you are invoking. You can then process the client information in your Lambda function as you choose through the context variable. For an example of a ClientContext JSON, see PutEvents in the Amazon Mobile Analytics API Reference and User Guide.

The ClientContext JSON must be base64-encoded and has a maximum size of 3583 bytes.

", - "location":"header", - "locationName":"X-Amz-Client-Context" - }, - "Payload":{ - "shape":"Blob", - "documentation":"

JSON that you want to provide to your Lambda function as input.

" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

You can use this optional parameter to specify a Lambda function version or alias name. If you specify a function version, the API uses the qualified function ARN to invoke a specific Lambda function. If you specify an alias name, the API uses the alias ARN to invoke the Lambda function version to which the alias points.

If you don't provide this parameter, then the API uses unqualified function ARN which results in invocation of the $LATEST version.

", - "location":"querystring", - "locationName":"Qualifier" - } - }, - "documentation":"

", - "payload":"Payload" - }, - "InvocationResponse":{ - "type":"structure", - "members":{ - "StatusCode":{ - "shape":"Integer", - "documentation":"

The HTTP status code will be in the 200 range for successful request. For the RequestResponse invocation type this status code will be 200. For the Event invocation type this status code will be 202. For the DryRun invocation type the status code will be 204.

", - "location":"statusCode" - }, - "FunctionError":{ - "shape":"String", - "documentation":"

Indicates whether an error occurred while executing the Lambda function. If an error occurred this field will have one of two values; Handled or Unhandled. Handled errors are errors that are reported by the function while the Unhandled errors are those detected and reported by AWS Lambda. Unhandled errors include out of memory errors and function timeouts. For information about how to report an Handled error, see Programming Model.

", - "location":"header", - "locationName":"X-Amz-Function-Error" - }, - "LogResult":{ - "shape":"String", - "documentation":"

It is the base64-encoded logs for the Lambda function invocation. This is present only if the invocation type is RequestResponse and the logs were requested.

", - "location":"header", - "locationName":"X-Amz-Log-Result" - }, - "Payload":{ - "shape":"Blob", - "documentation":"

It is the JSON representation of the object returned by the Lambda function. This is present only if the invocation type is RequestResponse.

In the event of a function error this field contains a message describing the error. For the Handled errors the Lambda function will report this message. For Unhandled errors AWS Lambda reports the message.

" - }, - "ExecutedVersion":{ - "shape":"Version", - "documentation":"

The function version that has been executed. This value is returned only if the invocation type is RequestResponse. For more information, see lambda-traffic-shifting-using-aliases.

", - "location":"header", - "locationName":"X-Amz-Executed-Version" - } - }, - "documentation":"

Upon success, returns an empty response. Otherwise, throws an exception.

", - "payload":"Payload" - }, - "InvocationType":{ - "type":"string", - "enum":[ - "Event", - "RequestResponse", - "DryRun" - ] - }, - "InvokeAsyncRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "InvokeArgs" - ], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

The Lambda function name. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "InvokeArgs":{ - "shape":"BlobStream", - "documentation":"

JSON that you want to provide to your Lambda function as input.

" - } - }, - "documentation":"

", - "deprecated":true, - "payload":"InvokeArgs" - }, - "InvokeAsyncResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"HttpStatus", - "documentation":"

It will be 202 upon success.

", - "location":"statusCode" - } - }, - "documentation":"

Upon success, it returns empty response. Otherwise, throws an exception.

", - "deprecated":true - }, - "KMSAccessDeniedException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

Lambda was unable to decrypt the environment variables because KMS access was denied. Check the Lambda function's KMS permissions.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "KMSDisabledException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

Lambda was unable to decrypt the environment variables because the KMS key used is disabled. Check the Lambda function's KMS key settings.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "KMSInvalidStateException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

Lambda was unable to decrypt the environment variables because the KMS key used is in an invalid state for Decrypt. Check the function's KMS key settings.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "KMSKeyArn":{ - "type":"string", - "pattern":"(arn:aws:[a-z0-9-.]+:.*)|()" - }, - "KMSNotFoundException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

Lambda was unable to decrypt the environment variables because the KMS key was not found. Check the function's KMS key settings.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "ListAliasesRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

Lambda function name for which the alias is created. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "FunctionVersion":{ - "shape":"Version", - "documentation":"

If you specify this optional parameter, the API returns only the aliases that are pointing to the specific Lambda function version, otherwise the API returns all of the aliases created for the Lambda function.

", - "location":"querystring", - "locationName":"FunctionVersion" - }, - "Marker":{ - "shape":"String", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListAliases operation. If present, indicates where to continue the listing.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"MaxListItems", - "documentation":"

Optional integer. Specifies the maximum number of aliases to return in response. This parameter value must be greater than 0.

", - "location":"querystring", - "locationName":"MaxItems" - } - } - }, - "ListAliasesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more aliases.

" - }, - "Aliases":{ - "shape":"AliasList", - "documentation":"

A list of aliases.

" - } - } - }, - "ListEventSourceMappingsRequest":{ - "type":"structure", - "members":{ - "EventSourceArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream, or an SQS queue. (This parameter is optional.)

", - "location":"querystring", - "locationName":"EventSourceArn" - }, - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name of the Lambda function.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"querystring", - "locationName":"FunctionName" - }, - "Marker":{ - "shape":"String", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListEventSourceMappings operation. If present, specifies to continue the list from where the returning call left off.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"MaxListItems", - "documentation":"

Optional integer. Specifies the maximum number of event sources to return in response. This value must be greater than 0.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

" - }, - "ListEventSourceMappingsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more event source mappings.

" - }, - "EventSourceMappings":{ - "shape":"EventSourceMappingsList", - "documentation":"

An array of EventSourceMappingConfiguration objects.

" - } - }, - "documentation":"

Contains a list of event sources (see EventSourceMappingConfiguration)

" - }, - "ListFunctionsRequest":{ - "type":"structure", - "members":{ - "MasterRegion":{ - "shape":"MasterRegion", - "documentation":"

Optional string. If not specified, will return only regular function versions (i.e., non-replicated versions).

Valid values are:

The region from which the functions are replicated. For example, if you specify us-east-1, only functions replicated from that region will be returned.

ALL: Will return all functions from any region. If specified, you also must specify a valid FunctionVersion parameter.

", - "location":"querystring", - "locationName":"MasterRegion" - }, - "FunctionVersion":{ - "shape":"FunctionVersion", - "documentation":"

Optional string. If not specified, only the unqualified functions ARNs (Amazon Resource Names) will be returned.

Valid value:

ALL: Will return all versions, including $LATEST which will have fully qualified ARNs (Amazon Resource Names).

", - "location":"querystring", - "locationName":"FunctionVersion" - }, - "Marker":{ - "shape":"String", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListFunctions operation. If present, indicates where to continue the listing.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"MaxListItems", - "documentation":"

Optional integer. Specifies the maximum number of AWS Lambda functions to return in response. This parameter value must be greater than 0.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

" - }, - "ListFunctionsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more functions.

" - }, - "Functions":{ - "shape":"FunctionList", - "documentation":"

A list of Lambda functions.

" - } - }, - "documentation":"

Contains a list of AWS Lambda function configurations (see FunctionConfiguration.

" - }, - "ListTagsRequest":{ - "type":"structure", - "required":["Resource"], - "members":{ - "Resource":{ - "shape":"FunctionArn", - "documentation":"

The ARN (Amazon Resource Name) of the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", - "location":"uri", - "locationName":"ARN" - } - } - }, - "ListTagsResponse":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

The list of tags assigned to the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - } - } - }, - "ListVersionsByFunctionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"NamespacedFunctionName", - "documentation":"

Function name whose versions to list. You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Marker":{ - "shape":"String", - "documentation":"

Optional string. An opaque pagination token returned from a previous ListVersionsByFunction operation. If present, indicates where to continue the listing.

", - "location":"querystring", - "locationName":"Marker" - }, - "MaxItems":{ - "shape":"MaxListItems", - "documentation":"

Optional integer. Specifies the maximum number of AWS Lambda function versions to return in response. This parameter value must be greater than 0.

", - "location":"querystring", - "locationName":"MaxItems" - } - }, - "documentation":"

" - }, - "ListVersionsByFunctionResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"String", - "documentation":"

A string, present if there are more function versions.

" - }, - "Versions":{ - "shape":"FunctionList", - "documentation":"

A list of Lambda function versions.

" - } - }, - "documentation":"

" - }, - "LogType":{ - "type":"string", - "enum":[ - "None", - "Tail" - ] - }, - "Long":{"type":"long"}, - "MasterRegion":{ - "type":"string", - "pattern":"ALL|[a-z]{2}(-gov)?-[a-z]+-\\d{1}" - }, - "MaxListItems":{ - "type":"integer", - "max":10000, - "min":1 - }, - "MemorySize":{ - "type":"integer", - "max":3008, - "min":128 - }, - "NameSpacedFunctionArn":{ - "type":"string", - "pattern":"arn:aws:lambda:[a-z]{2}-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_\\.]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" - }, - "NamespacedFunctionName":{ - "type":"string", - "max":170, - "min":1, - "pattern":"(arn:aws:lambda:)?([a-z]{2}-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_\\.]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" - }, - "NamespacedStatementId":{ - "type":"string", - "max":100, - "min":1, - "pattern":"([a-zA-Z0-9-_.]+)" - }, - "PolicyLengthExceededException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "message":{"shape":"String"} - }, - "documentation":"

Lambda function access policy is limited to 20 KB.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "PreconditionFailedException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

" - }, - "message":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

The RevisionId provided does not match the latest RevisionId for the Lambda function or alias. Call the GetFunction or the GetAlias API to retrieve the latest RevisionId for your resource.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "Principal":{ - "type":"string", - "pattern":".*" - }, - "PublishVersionRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function name. You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "CodeSha256":{ - "shape":"String", - "documentation":"

The SHA256 hash of the deployment package you want to publish. This provides validation on the code you are publishing. If you provide this parameter, the value must match the SHA256 of the $LATEST version for the publication to succeed. You can use the DryRun parameter of UpdateFunctionCode to verify the hash value that will be returned before publishing your new version.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description for the version you are publishing. If not provided, AWS Lambda copies the description from the $LATEST version.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" - } - }, - "documentation":"

" - }, - "PutFunctionConcurrencyRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "ReservedConcurrentExecutions" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name of the function you are setting concurrent execution limits on. For more information, see concurrent-executions.

", - "location":"uri", - "locationName":"FunctionName" - }, - "ReservedConcurrentExecutions":{ - "shape":"ReservedConcurrentExecutions", - "documentation":"

The concurrent execution limit reserved for this function. For more information, see concurrent-executions.

" - } - } - }, - "Qualifier":{ - "type":"string", - "max":128, - "min":1, - "pattern":"(|[a-zA-Z0-9$_-]+)" - }, - "RemovePermissionRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "StatementId" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

Lambda function whose resource policy you want to remove a permission from.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "StatementId":{ - "shape":"NamespacedStatementId", - "documentation":"

Statement ID of the permission to remove.

", - "location":"uri", - "locationName":"StatementId" - }, - "Qualifier":{ - "shape":"Qualifier", - "documentation":"

You can specify this optional parameter to remove permission associated with a specific function version or function alias. If you don't specify this parameter, the API removes permission associated with the unqualified function ARN.

", - "location":"querystring", - "locationName":"Qualifier" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", - "location":"querystring", - "locationName":"RevisionId" - } - }, - "documentation":"

" - }, - "RequestTooLargeException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "message":{"shape":"String"} - }, - "documentation":"

The request payload exceeded the Invoke request body JSON input limit. For more information, see Limits.

", - "error":{"httpStatusCode":413}, - "exception":true - }, - "ReservedConcurrentExecutions":{ - "type":"integer", - "min":0 - }, - "ResourceArn":{ - "type":"string", - "pattern":"(arn:aws:[a-z0-9-.]+:.*)|()" - }, - "ResourceConflictException":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

" - }, - "message":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

The resource already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

The operation conflicts with the resource's availability. For example, you attempted to update an EventSoure Mapping in CREATING, or tried to delete a EventSoure mapping currently in the UPDATING state.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

The resource (for example, a Lambda function or access policy statement) specified in the request does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "RoleArn":{ - "type":"string", - "pattern":"arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - }, - "Runtime":{ - "type":"string", - "enum":[ - "nodejs", - "nodejs4.3", - "nodejs6.10", - "nodejs8.10", - "java8", - "python2.7", - "python3.6", - "dotnetcore1.0", - "dotnetcore2.0", - "dotnetcore2.1", - "nodejs4.3-edge", - "go1.x" - ] - }, - "S3Bucket":{ - "type":"string", - "max":63, - "min":3, - "pattern":"^[0-9A-Za-z\\.\\-_]*(?The AWS Lambda service encountered an internal error.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "SourceOwner":{ - "type":"string", - "pattern":"\\d{12}" - }, - "StatementId":{ - "type":"string", - "max":100, - "min":1, - "pattern":"([a-zA-Z0-9-_]+)" - }, - "String":{"type":"string"}, - "SubnetIPAddressLimitReachedException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "Message":{"shape":"String"} - }, - "documentation":"

AWS Lambda was not able to set up VPC access for the Lambda function because one or more configured subnets has no available IP addresses.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "SubnetId":{"type":"string"}, - "SubnetIds":{ - "type":"list", - "member":{"shape":"SubnetId"}, - "max":16 - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "Tags" - ], - "members":{ - "Resource":{ - "shape":"FunctionArn", - "documentation":"

The ARN (Amazon Resource Name) of the Lambda function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", - "location":"uri", - "locationName":"ARN" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The list of tags (key-value pairs) you are assigning to the Lambda function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" - } - } - }, - "TagValue":{"type":"string"}, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"} - }, - "ThrottleReason":{ - "type":"string", - "enum":[ - "ConcurrentInvocationLimitExceeded", - "FunctionInvocationRateLimitExceeded", - "ReservedFunctionConcurrentInvocationLimitExceeded", - "ReservedFunctionInvocationRateLimitExceeded", - "CallerRateLimitExceeded" - ] - }, - "Timeout":{ - "type":"integer", - "min":1 - }, - "Timestamp":{"type":"string"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "documentation":"

The number of seconds the caller should wait before retrying.

", - "location":"header", - "locationName":"Retry-After" - }, - "Type":{"shape":"String"}, - "message":{"shape":"String"}, - "Reason":{"shape":"ThrottleReason"} - }, - "documentation":"

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "TracingConfig":{ - "type":"structure", - "members":{ - "Mode":{ - "shape":"TracingMode", - "documentation":"

Can be either PassThrough or Active. If PassThrough, Lambda will only trace the request from an upstream service if it contains a tracing header with \"sampled=1\". If Active, Lambda will respect any tracing header it receives from an upstream service. If no tracing header is received, Lambda will call X-Ray for a tracing decision.

" - } - }, - "documentation":"

The parent object that contains your function's tracing settings.

" - }, - "TracingConfigResponse":{ - "type":"structure", - "members":{ - "Mode":{ - "shape":"TracingMode", - "documentation":"

The tracing mode associated with your Lambda function.

" - } - }, - "documentation":"

Parent object of the tracing information associated with your Lambda function.

" - }, - "TracingMode":{ - "type":"string", - "enum":[ - "Active", - "PassThrough" - ] - }, - "UnreservedConcurrentExecutions":{ - "type":"integer", - "min":0 - }, - "UnsupportedMediaTypeException":{ - "type":"structure", - "members":{ - "Type":{"shape":"String"}, - "message":{"shape":"String"} - }, - "documentation":"

The content type of the Invoke request body is not JSON.

", - "error":{"httpStatusCode":415}, - "exception":true - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "Resource", - "TagKeys" - ], - "members":{ - "Resource":{ - "shape":"FunctionArn", - "documentation":"

The ARN (Amazon Resource Name) of the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", - "location":"uri", - "locationName":"ARN" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The list of tag keys to be deleted from the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", - "location":"querystring", - "locationName":"tagKeys" - } - } - }, - "UpdateAliasRequest":{ - "type":"structure", - "required":[ - "FunctionName", - "Name" - ], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The function name for which the alias is created. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Name":{ - "shape":"Alias", - "documentation":"

The alias name.

", - "location":"uri", - "locationName":"Name" - }, - "FunctionVersion":{ - "shape":"Version", - "documentation":"

Using this parameter you can change the Lambda function version to which the alias points.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

You can change the description of the alias using this parameter.

" - }, - "RoutingConfig":{ - "shape":"AliasRoutingConfiguration", - "documentation":"

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" - } - } - }, - "UpdateEventSourceMappingRequest":{ - "type":"structure", - "required":["UUID"], - "members":{ - "UUID":{ - "shape":"String", - "documentation":"

The event source mapping identifier.

", - "location":"uri", - "locationName":"UUID" - }, - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The Lambda function to which you want the stream records sent.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). For more information about versioning, see AWS Lambda Function Versioning and Aliases

Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Specifies whether AWS Lambda should actively poll the stream or not. If disabled, AWS Lambda will not poll the stream.

" - }, - "BatchSize":{ - "shape":"BatchSize", - "documentation":"

The maximum number of stream records that can be sent to your Lambda function for a single invocation.

" - } - }, - "documentation":"

" - }, - "UpdateFunctionCodeRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The existing Lambda function name whose code you want to replace.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "ZipFile":{ - "shape":"Blob", - "documentation":"

The contents of your zip file containing your deployment package. If you are using the web API directly, the contents of the zip file must be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the encoding for you. For more information about creating a .zip file, see Execution Permissions.

" - }, - "S3Bucket":{ - "shape":"S3Bucket", - "documentation":"

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS Region where you are creating the Lambda function.

" - }, - "S3Key":{ - "shape":"S3Key", - "documentation":"

The Amazon S3 object (the deployment package) key name you want to upload.

" - }, - "S3ObjectVersion":{ - "shape":"S3ObjectVersion", - "documentation":"

The Amazon S3 object (the deployment package) version you want to upload.

" - }, - "Publish":{ - "shape":"Boolean", - "documentation":"

This boolean parameter can be used to request AWS Lambda to update the Lambda function and publish a version as an atomic operation.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

This boolean parameter can be used to test your request to AWS Lambda to update the Lambda function and publish a version as an atomic operation. It will do all necessary computation and validation of your code but will not upload it or a publish a version. Each time this operation is invoked, the CodeSha256 hash value of the provided code will also be computed and returned in the response.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" - } - }, - "documentation":"

" - }, - "UpdateFunctionConfigurationRequest":{ - "type":"structure", - "required":["FunctionName"], - "members":{ - "FunctionName":{ - "shape":"FunctionName", - "documentation":"

The name of the Lambda function.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length.

", - "location":"uri", - "locationName":"FunctionName" - }, - "Role":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Lambda will assume when it executes your function.

" - }, - "Handler":{ - "shape":"Handler", - "documentation":"

The function that Lambda calls to begin executing your function. For Node.js, it is the module-name.export value in your function.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A short user-defined function description. AWS Lambda does not use this value. Assign a meaningful description as you see fit.

" - }, - "Timeout":{ - "shape":"Timeout", - "documentation":"

The function execution time at which AWS Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" - }, - "MemorySize":{ - "shape":"MemorySize", - "documentation":"

The amount of memory, in MB, your Lambda function is given. AWS Lambda uses this memory size to infer the amount of CPU allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

" - }, - "VpcConfig":{"shape":"VpcConfig"}, - "Environment":{ - "shape":"Environment", - "documentation":"

The parent object that contains your environment's configuration settings.

" - }, - "Runtime":{ - "shape":"Runtime", - "documentation":"

The runtime environment for the Lambda function.

To use the Python runtime v3.6, set the value to \"python3.6\". To use the Python runtime v2.7, set the value to \"python2.7\". To use the Node.js runtime v6.10, set the value to \"nodejs6.10\". To use the Node.js runtime v4.3, set the value to \"nodejs4.3\". To use the .NET Core runtime v1.0, set the value to \"dotnetcore1.0\". To use the .NET Core runtime v2.0, set the value to \"dotnetcore2.0\".

Node v0.10.42 is currently marked as deprecated. You must migrate existing functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 or nodejs6.10) as soon as possible. Failure to do so will result in an invalid parameter error being returned. Note that you will have to follow this procedure for each region that contains functions written in the Node v0.10.42 runtime.

" - }, - "DeadLetterConfig":{ - "shape":"DeadLetterConfig", - "documentation":"

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

" - }, - "KMSKeyArn":{ - "shape":"KMSKeyArn", - "documentation":"

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If you elect to use the AWS Lambda default service key, pass in an empty string (\"\") for this parameter.

" - }, - "TracingConfig":{ - "shape":"TracingConfig", - "documentation":"

The parent object that contains your function's tracing settings.

" - }, - "RevisionId":{ - "shape":"String", - "documentation":"

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" - } - }, - "documentation":"

" - }, - "Version":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"(\\$LATEST|[0-9]+)" - }, - "VpcConfig":{ - "type":"structure", - "members":{ - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

A list of one or more subnet IDs in your VPC.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIds", - "documentation":"

A list of one or more security groups IDs in your VPC.

" - } - }, - "documentation":"

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

" - }, - "VpcConfigResponse":{ - "type":"structure", - "members":{ - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

A list of subnet IDs associated with the Lambda function.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIds", - "documentation":"

A list of security group IDs associated with the Lambda function.

" - }, - "VpcId":{ - "shape":"VpcId", - "documentation":"

The VPC ID associated with you Lambda function.

" - } - }, - "documentation":"

VPC configuration associated with your Lambda function.

" - }, - "VpcId":{"type":"string"}, - "Weight":{ - "type":"double", - "max":1.0, - "min":0.0 - } - }, - "documentation":"AWS Lambda

Overview

This is the AWS Lambda API Reference. The AWS Lambda Developer Guide provides additional information. For the service overview, see What is AWS Lambda, and for information about how the service works, see AWS Lambda: How it Works in the AWS Lambda Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/paginators-1.json deleted file mode 100644 index 02d23082..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/paginators-1.json +++ /dev/null @@ -1,64 +0,0 @@ -{ - "pagination": { - "GetSlotTypeVersions": { - "result_key": "slotTypes", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetSlotTypes": { - "result_key": "slotTypes", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetIntents": { - "result_key": "intents", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBotChannelAssociations": { - "result_key": "botChannelAssociations", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBots": { - "result_key": "bots", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBuiltinSlotTypes": { - "result_key": "slotTypes", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetIntentVersions": { - "result_key": "intents", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBotAliases": { - "result_key": "BotAliases", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBuiltinIntents": { - "result_key": "intents", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "GetBotVersions": { - "result_key": "bots", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/service-2.json deleted file mode 100644 index 21e445c4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-models/2017-04-19/service-2.json +++ /dev/null @@ -1,3270 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-04-19", - "endpointPrefix":"models.lex", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"Amazon Lex Model Building Service", - "serviceId":"Lex Model Building Service", - "signatureVersion":"v4", - "signingName":"lex", - "uid":"lex-models-2017-04-19" - }, - "operations":{ - "CreateBotVersion":{ - "name":"CreateBotVersion", - "http":{ - "method":"POST", - "requestUri":"/bots/{name}/versions", - "responseCode":201 - }, - "input":{"shape":"CreateBotVersionRequest"}, - "output":{"shape":"CreateBotVersionResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates a new version of the bot based on the $LATEST version. If the $LATEST version of this resource hasn't changed since you created the last version, Amazon Lex doesn't create a new version. It returns the last created version.

You can update only the $LATEST version of the bot. You can't update the numbered versions that you create with the CreateBotVersion operation.

When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see versioning-intro.

This operation requires permission for the lex:CreateBotVersion action.

" - }, - "CreateIntentVersion":{ - "name":"CreateIntentVersion", - "http":{ - "method":"POST", - "requestUri":"/intents/{name}/versions", - "responseCode":201 - }, - "input":{"shape":"CreateIntentVersionRequest"}, - "output":{"shape":"CreateIntentVersionResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates a new version of an intent based on the $LATEST version of the intent. If the $LATEST version of this intent hasn't changed since you last updated it, Amazon Lex doesn't create a new version. It returns the last version you created.

You can update only the $LATEST version of the intent. You can't update the numbered versions that you create with the CreateIntentVersion operation.

When you create a version of an intent, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see versioning-intro.

This operation requires permissions to perform the lex:CreateIntentVersion action.

" - }, - "CreateSlotTypeVersion":{ - "name":"CreateSlotTypeVersion", - "http":{ - "method":"POST", - "requestUri":"/slottypes/{name}/versions", - "responseCode":201 - }, - "input":{"shape":"CreateSlotTypeVersionRequest"}, - "output":{"shape":"CreateSlotTypeVersionResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates a new version of a slot type based on the $LATEST version of the specified slot type. If the $LATEST version of this resource has not changed since the last version that you created, Amazon Lex doesn't create a new version. It returns the last version that you created.

You can update only the $LATEST version of a slot type. You can't update the numbered versions that you create with the CreateSlotTypeVersion operation.

When you create a version of a slot type, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see versioning-intro.

This operation requires permissions for the lex:CreateSlotTypeVersion action.

" - }, - "DeleteBot":{ - "name":"DeleteBot", - "http":{ - "method":"DELETE", - "requestUri":"/bots/{name}", - "responseCode":204 - }, - "input":{"shape":"DeleteBotRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes all versions of the bot, including the $LATEST version. To delete a specific version of the bot, use the DeleteBotVersion operation.

If a bot has an alias, you can't delete it. Instead, the DeleteBot operation returns a ResourceInUseException exception that includes a reference to the alias that refers to the bot. To remove the reference to the bot, delete the alias. If you get the same exception again, delete the referring alias until the DeleteBot operation is successful.

This operation requires permissions for the lex:DeleteBot action.

" - }, - "DeleteBotAlias":{ - "name":"DeleteBotAlias", - "http":{ - "method":"DELETE", - "requestUri":"/bots/{botName}/aliases/{name}", - "responseCode":204 - }, - "input":{"shape":"DeleteBotAliasRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes an alias for the specified bot.

You can't delete an alias that is used in the association between a bot and a messaging channel. If an alias is used in a channel association, the DeleteBot operation returns a ResourceInUseException exception that includes a reference to the channel association that refers to the bot. You can remove the reference to the alias by deleting the channel association. If you get the same exception again, delete the referring association until the DeleteBotAlias operation is successful.

" - }, - "DeleteBotChannelAssociation":{ - "name":"DeleteBotChannelAssociation", - "http":{ - "method":"DELETE", - "requestUri":"/bots/{botName}/aliases/{aliasName}/channels/{name}", - "responseCode":204 - }, - "input":{"shape":"DeleteBotChannelAssociationRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Deletes the association between an Amazon Lex bot and a messaging platform.

This operation requires permission for the lex:DeleteBotChannelAssociation action.

" - }, - "DeleteBotVersion":{ - "name":"DeleteBotVersion", - "http":{ - "method":"DELETE", - "requestUri":"/bots/{name}/versions/{version}", - "responseCode":204 - }, - "input":{"shape":"DeleteBotVersionRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes a specific version of a bot. To delete all versions of a bot, use the DeleteBot operation.

This operation requires permissions for the lex:DeleteBotVersion action.

" - }, - "DeleteIntent":{ - "name":"DeleteIntent", - "http":{ - "method":"DELETE", - "requestUri":"/intents/{name}", - "responseCode":204 - }, - "input":{"shape":"DeleteIntentRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes all versions of the intent, including the $LATEST version. To delete a specific version of the intent, use the DeleteIntentVersion operation.

You can delete a version of an intent only if it is not referenced. To delete an intent that is referred to in one or more bots (see how-it-works), you must remove those references first.

If you get the ResourceInUseException exception, it provides an example reference that shows where the intent is referenced. To remove the reference to the intent, either update the bot or delete it. If you get the same exception when you attempt to delete the intent again, repeat until the intent has no references and the call to DeleteIntent is successful.

This operation requires permission for the lex:DeleteIntent action.

" - }, - "DeleteIntentVersion":{ - "name":"DeleteIntentVersion", - "http":{ - "method":"DELETE", - "requestUri":"/intents/{name}/versions/{version}", - "responseCode":204 - }, - "input":{"shape":"DeleteIntentVersionRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes a specific version of an intent. To delete all versions of a intent, use the DeleteIntent operation.

This operation requires permissions for the lex:DeleteIntentVersion action.

" - }, - "DeleteSlotType":{ - "name":"DeleteSlotType", - "http":{ - "method":"DELETE", - "requestUri":"/slottypes/{name}", - "responseCode":204 - }, - "input":{"shape":"DeleteSlotTypeRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes all versions of the slot type, including the $LATEST version. To delete a specific version of the slot type, use the DeleteSlotTypeVersion operation.

You can delete a version of a slot type only if it is not referenced. To delete a slot type that is referred to in one or more intents, you must remove those references first.

If you get the ResourceInUseException exception, the exception provides an example reference that shows the intent where the slot type is referenced. To remove the reference to the slot type, either update the intent or delete it. If you get the same exception when you attempt to delete the slot type again, repeat until the slot type has no references and the DeleteSlotType call is successful.

This operation requires permission for the lex:DeleteSlotType action.

" - }, - "DeleteSlotTypeVersion":{ - "name":"DeleteSlotTypeVersion", - "http":{ - "method":"DELETE", - "requestUri":"/slottypes/{name}/version/{version}", - "responseCode":204 - }, - "input":{"shape":"DeleteSlotTypeVersionRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"ResourceInUseException"} - ], - "documentation":"

Deletes a specific version of a slot type. To delete all versions of a slot type, use the DeleteSlotType operation.

This operation requires permissions for the lex:DeleteSlotTypeVersion action.

" - }, - "DeleteUtterances":{ - "name":"DeleteUtterances", - "http":{ - "method":"DELETE", - "requestUri":"/bots/{botName}/utterances/{userId}", - "responseCode":204 - }, - "input":{"shape":"DeleteUtterancesRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Deletes stored utterances.

Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 days for use with the GetUtterancesView operation, and then stored indefinitely for use in improving the ability of your bot to respond to user input.

Use the DeleteStoredUtterances operation to manually delete stored utterances for a specific user.

This operation requires permissions for the lex:DeleteUtterances action.

" - }, - "GetBot":{ - "name":"GetBot", - "http":{ - "method":"GET", - "requestUri":"/bots/{name}/versions/{versionoralias}", - "responseCode":200 - }, - "input":{"shape":"GetBotRequest"}, - "output":{"shape":"GetBotResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns metadata information for a specific bot. You must provide the bot name and the bot version or alias.

This operation requires permissions for the lex:GetBot action.

" - }, - "GetBotAlias":{ - "name":"GetBotAlias", - "http":{ - "method":"GET", - "requestUri":"/bots/{botName}/aliases/{name}", - "responseCode":200 - }, - "input":{"shape":"GetBotAliasRequest"}, - "output":{"shape":"GetBotAliasResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns information about an Amazon Lex bot alias. For more information about aliases, see versioning-aliases.

This operation requires permissions for the lex:GetBotAlias action.

" - }, - "GetBotAliases":{ - "name":"GetBotAliases", - "http":{ - "method":"GET", - "requestUri":"/bots/{botName}/aliases/", - "responseCode":200 - }, - "input":{"shape":"GetBotAliasesRequest"}, - "output":{"shape":"GetBotAliasesResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns a list of aliases for a specified Amazon Lex bot.

This operation requires permissions for the lex:GetBotAliases action.

" - }, - "GetBotChannelAssociation":{ - "name":"GetBotChannelAssociation", - "http":{ - "method":"GET", - "requestUri":"/bots/{botName}/aliases/{aliasName}/channels/{name}", - "responseCode":200 - }, - "input":{"shape":"GetBotChannelAssociationRequest"}, - "output":{"shape":"GetBotChannelAssociationResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns information about the association between an Amazon Lex bot and a messaging platform.

This operation requires permissions for the lex:GetBotChannelAssociation action.

" - }, - "GetBotChannelAssociations":{ - "name":"GetBotChannelAssociations", - "http":{ - "method":"GET", - "requestUri":"/bots/{botName}/aliases/{aliasName}/channels/", - "responseCode":200 - }, - "input":{"shape":"GetBotChannelAssociationsRequest"}, - "output":{"shape":"GetBotChannelAssociationsResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns a list of all of the channels associated with the specified bot.

The GetBotChannelAssociations operation requires permissions for the lex:GetBotChannelAssociations action.

" - }, - "GetBotVersions":{ - "name":"GetBotVersions", - "http":{ - "method":"GET", - "requestUri":"/bots/{name}/versions/", - "responseCode":200 - }, - "input":{"shape":"GetBotVersionsRequest"}, - "output":{"shape":"GetBotVersionsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets information about all of the versions of a bot.

The GetBotVersions operation returns a BotMetadata object for each version of a bot. For example, if a bot has three numbered versions, the GetBotVersions operation returns four BotMetadata objects in the response, one for each numbered version and one for the $LATEST version.

The GetBotVersions operation always returns at least one version, the $LATEST version.

This operation requires permissions for the lex:GetBotVersions action.

" - }, - "GetBots":{ - "name":"GetBots", - "http":{ - "method":"GET", - "requestUri":"/bots/", - "responseCode":200 - }, - "input":{"shape":"GetBotsRequest"}, - "output":{"shape":"GetBotsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns bot information as follows:

  • If you provide the nameContains field, the response includes information for the $LATEST version of all bots whose name contains the specified string.

  • If you don't specify the nameContains field, the operation returns information about the $LATEST version of all of your bots.

This operation requires permission for the lex:GetBots action.

" - }, - "GetBuiltinIntent":{ - "name":"GetBuiltinIntent", - "http":{ - "method":"GET", - "requestUri":"/builtins/intents/{signature}", - "responseCode":200 - }, - "input":{"shape":"GetBuiltinIntentRequest"}, - "output":{"shape":"GetBuiltinIntentResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns information about a built-in intent.

This operation requires permission for the lex:GetBuiltinIntent action.

" - }, - "GetBuiltinIntents":{ - "name":"GetBuiltinIntents", - "http":{ - "method":"GET", - "requestUri":"/builtins/intents/", - "responseCode":200 - }, - "input":{"shape":"GetBuiltinIntentsRequest"}, - "output":{"shape":"GetBuiltinIntentsResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets a list of built-in intents that meet the specified criteria.

This operation requires permission for the lex:GetBuiltinIntents action.

" - }, - "GetBuiltinSlotTypes":{ - "name":"GetBuiltinSlotTypes", - "http":{ - "method":"GET", - "requestUri":"/builtins/slottypes/", - "responseCode":200 - }, - "input":{"shape":"GetBuiltinSlotTypesRequest"}, - "output":{"shape":"GetBuiltinSlotTypesResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets a list of built-in slot types that meet the specified criteria.

For a list of built-in slot types, see Slot Type Reference in the Alexa Skills Kit.

This operation requires permission for the lex:GetBuiltInSlotTypes action.

" - }, - "GetExport":{ - "name":"GetExport", - "http":{ - "method":"GET", - "requestUri":"/exports/", - "responseCode":200 - }, - "input":{"shape":"GetExportRequest"}, - "output":{"shape":"GetExportResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Exports the contents of a Amazon Lex resource in a specified format.

" - }, - "GetImport":{ - "name":"GetImport", - "http":{ - "method":"GET", - "requestUri":"/imports/{importId}", - "responseCode":200 - }, - "input":{"shape":"GetImportRequest"}, - "output":{"shape":"GetImportResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets information about an import job started with the StartImport operation.

" - }, - "GetIntent":{ - "name":"GetIntent", - "http":{ - "method":"GET", - "requestUri":"/intents/{name}/versions/{version}", - "responseCode":200 - }, - "input":{"shape":"GetIntentRequest"}, - "output":{"shape":"GetIntentResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns information about an intent. In addition to the intent name, you must specify the intent version.

This operation requires permissions to perform the lex:GetIntent action.

" - }, - "GetIntentVersions":{ - "name":"GetIntentVersions", - "http":{ - "method":"GET", - "requestUri":"/intents/{name}/versions/", - "responseCode":200 - }, - "input":{"shape":"GetIntentVersionsRequest"}, - "output":{"shape":"GetIntentVersionsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets information about all of the versions of an intent.

The GetIntentVersions operation returns an IntentMetadata object for each version of an intent. For example, if an intent has three numbered versions, the GetIntentVersions operation returns four IntentMetadata objects in the response, one for each numbered version and one for the $LATEST version.

The GetIntentVersions operation always returns at least one version, the $LATEST version.

This operation requires permissions for the lex:GetIntentVersions action.

" - }, - "GetIntents":{ - "name":"GetIntents", - "http":{ - "method":"GET", - "requestUri":"/intents/", - "responseCode":200 - }, - "input":{"shape":"GetIntentsRequest"}, - "output":{"shape":"GetIntentsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns intent information as follows:

  • If you specify the nameContains field, returns the $LATEST version of all intents that contain the specified string.

  • If you don't specify the nameContains field, returns information about the $LATEST version of all intents.

The operation requires permission for the lex:GetIntents action.

" - }, - "GetSlotType":{ - "name":"GetSlotType", - "http":{ - "method":"GET", - "requestUri":"/slottypes/{name}/versions/{version}", - "responseCode":200 - }, - "input":{"shape":"GetSlotTypeRequest"}, - "output":{"shape":"GetSlotTypeResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns information about a specific version of a slot type. In addition to specifying the slot type name, you must specify the slot type version.

This operation requires permissions for the lex:GetSlotType action.

" - }, - "GetSlotTypeVersions":{ - "name":"GetSlotTypeVersions", - "http":{ - "method":"GET", - "requestUri":"/slottypes/{name}/versions/", - "responseCode":200 - }, - "input":{"shape":"GetSlotTypeVersionsRequest"}, - "output":{"shape":"GetSlotTypeVersionsResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets information about all versions of a slot type.

The GetSlotTypeVersions operation returns a SlotTypeMetadata object for each version of a slot type. For example, if a slot type has three numbered versions, the GetSlotTypeVersions operation returns four SlotTypeMetadata objects in the response, one for each numbered version and one for the $LATEST version.

The GetSlotTypeVersions operation always returns at least one version, the $LATEST version.

This operation requires permissions for the lex:GetSlotTypeVersions action.

" - }, - "GetSlotTypes":{ - "name":"GetSlotTypes", - "http":{ - "method":"GET", - "requestUri":"/slottypes/", - "responseCode":200 - }, - "input":{"shape":"GetSlotTypesRequest"}, - "output":{"shape":"GetSlotTypesResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Returns slot type information as follows:

  • If you specify the nameContains field, returns the $LATEST version of all slot types that contain the specified string.

  • If you don't specify the nameContains field, returns information about the $LATEST version of all slot types.

The operation requires permission for the lex:GetSlotTypes action.

" - }, - "GetUtterancesView":{ - "name":"GetUtterancesView", - "http":{ - "method":"GET", - "requestUri":"/bots/{botname}/utterances?view=aggregation", - "responseCode":200 - }, - "input":{"shape":"GetUtterancesViewRequest"}, - "output":{"shape":"GetUtterancesViewResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Use the GetUtterancesView operation to get information about the utterances that your users have made to your bot. You can use this list to tune the utterances that your bot responds to.

For example, say that you have created a bot to order flowers. After your users have used your bot for a while, use the GetUtterancesView operation to see the requests that they have made and whether they have been successful. You might find that the utterance \"I want flowers\" is not being recognized. You could add this utterance to the OrderFlowers intent so that your bot recognizes that utterance.

After you publish a new version of a bot, you can get information about the old version and the new so that you can compare the performance across the two versions.

Utterance statistics are generated once a day. Data is available for the last 15 days. You can request information for up to 5 versions in each request. The response contains information about a maximum of 100 utterances for each version.

This operation requires permissions for the lex:GetUtterancesView action.

" - }, - "PutBot":{ - "name":"PutBot", - "http":{ - "method":"PUT", - "requestUri":"/bots/{name}/versions/$LATEST", - "responseCode":200 - }, - "input":{"shape":"PutBotRequest"}, - "output":{"shape":"PutBotResponse"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates an Amazon Lex conversational bot or replaces an existing bot. When you create or update a bot you are only required to specify a name, a locale, and whether the bot is directed toward children under age 13. You can use this to add intents later, or to remove intents from an existing bot. When you create a bot with the minimum information, the bot is created or updated but Amazon Lex returns the response FAILED. You can build the bot after you add one or more intents. For more information about Amazon Lex bots, see how-it-works.

If you specify the name of an existing bot, the fields in the request replace the existing values in the $LATEST version of the bot. Amazon Lex removes any fields that you don't provide values for in the request, except for the idleTTLInSeconds and privacySettings fields, which are set to their default values. If you don't specify values for required fields, Amazon Lex throws an exception.

This operation requires permissions for the lex:PutBot action. For more information, see auth-and-access-control.

" - }, - "PutBotAlias":{ - "name":"PutBotAlias", - "http":{ - "method":"PUT", - "requestUri":"/bots/{botName}/aliases/{name}", - "responseCode":200 - }, - "input":{"shape":"PutBotAliasRequest"}, - "output":{"shape":"PutBotAliasResponse"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates an alias for the specified version of the bot or replaces an alias for the specified bot. To change the version of the bot that the alias points to, replace the alias. For more information about aliases, see versioning-aliases.

This operation requires permissions for the lex:PutBotAlias action.

" - }, - "PutIntent":{ - "name":"PutIntent", - "http":{ - "method":"PUT", - "requestUri":"/intents/{name}/versions/$LATEST", - "responseCode":200 - }, - "input":{"shape":"PutIntentRequest"}, - "output":{"shape":"PutIntentResponse"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates an intent or replaces an existing intent.

To define the interaction between the user and your bot, you use one or more intents. For a pizza ordering bot, for example, you would create an OrderPizza intent.

To create an intent or replace an existing intent, you must provide the following:

  • Intent name. For example, OrderPizza.

  • Sample utterances. For example, \"Can I order a pizza, please.\" and \"I want to order a pizza.\"

  • Information to be gathered. You specify slot types for the information that your bot will request from the user. You can specify standard slot types, such as a date or a time, or custom slot types such as the size and crust of a pizza.

  • How the intent will be fulfilled. You can provide a Lambda function or configure the intent to return the intent information to the client application. If you use a Lambda function, when all of the intent information is available, Amazon Lex invokes your Lambda function. If you configure your intent to return the intent information to the client application.

You can specify other optional information in the request, such as:

  • A confirmation prompt to ask the user to confirm an intent. For example, \"Shall I order your pizza?\"

  • A conclusion statement to send to the user after the intent has been fulfilled. For example, \"I placed your pizza order.\"

  • A follow-up prompt that asks the user for additional activity. For example, asking \"Do you want to order a drink with your pizza?\"

If you specify an existing intent name to update the intent, Amazon Lex replaces the values in the $LATEST version of the intent with the values in the request. Amazon Lex removes fields that you don't provide in the request. If you don't specify the required fields, Amazon Lex throws an exception. When you update the $LATEST version of an intent, the status field of any bot that uses the $LATEST version of the intent is set to NOT_BUILT.

For more information, see how-it-works.

This operation requires permissions for the lex:PutIntent action.

" - }, - "PutSlotType":{ - "name":"PutSlotType", - "http":{ - "method":"PUT", - "requestUri":"/slottypes/{name}/versions/$LATEST", - "responseCode":200 - }, - "input":{"shape":"PutSlotTypeRequest"}, - "output":{"shape":"PutSlotTypeResponse"}, - "errors":[ - {"shape":"ConflictException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"}, - {"shape":"PreconditionFailedException"} - ], - "documentation":"

Creates a custom slot type or replaces an existing custom slot type.

To create a custom slot type, specify a name for the slot type and a set of enumeration values, which are the values that a slot of this type can assume. For more information, see how-it-works.

If you specify the name of an existing slot type, the fields in the request replace the existing values in the $LATEST version of the slot type. Amazon Lex removes the fields that you don't provide in the request. If you don't specify required fields, Amazon Lex throws an exception. When you update the $LATEST version of a slot type, if a bot uses the $LATEST version of an intent that contains the slot type, the bot's status field is set to NOT_BUILT.

This operation requires permissions for the lex:PutSlotType action.

" - }, - "StartImport":{ - "name":"StartImport", - "http":{ - "method":"POST", - "requestUri":"/imports/", - "responseCode":201 - }, - "input":{"shape":"StartImportRequest"}, - "output":{"shape":"StartImportResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Starts a job to import a resource to Amazon Lex.

" - } - }, - "shapes":{ - "AliasName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^([A-Za-z]_?)+$" - }, - "AliasNameOrListAll":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^(-|^([A-Za-z]_?)+$)$" - }, - "BadRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Blob":{"type":"blob"}, - "Boolean":{"type":"boolean"}, - "BotAliasMetadata":{ - "type":"structure", - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the bot alias.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot alias.

" - }, - "botVersion":{ - "shape":"Version", - "documentation":"

The version of the Amazon Lex bot to which the alias points.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot to which the alias points.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was updated. When you create a resource, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was created.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the bot alias.

" - } - }, - "documentation":"

Provides information about a bot alias.

" - }, - "BotAliasMetadataList":{ - "type":"list", - "member":{"shape":"BotAliasMetadata"} - }, - "BotChannelAssociation":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotChannelName", - "documentation":"

The name of the association between the bot and the channel.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A text description of the association you are creating.

" - }, - "botAlias":{ - "shape":"AliasName", - "documentation":"

An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot to which this association is being made.

Currently, Amazon Lex supports associations with Facebook and Slack, and Twilio.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the association between the Amazon Lex bot and the channel was created.

" - }, - "type":{ - "shape":"ChannelType", - "documentation":"

Specifies the type of association by indicating the type of channel being established between the Amazon Lex bot and the external messaging platform.

" - }, - "botConfiguration":{ - "shape":"ChannelConfigurationMap", - "documentation":"

Provides information necessary to communicate with the messaging platform.

" - }, - "status":{ - "shape":"ChannelStatus", - "documentation":"

The status of the bot channel.

  • CREATED - The channel has been created and is ready for use.

  • IN_PROGRESS - Channel creation is in progress.

  • FAILED - There was an error creating the channel. For information about the reason for the failure, see the failureReason field.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex provides the reason that it failed to create the association.

" - } - }, - "documentation":"

Represents an association between an Amazon Lex bot and an external messaging platform.

" - }, - "BotChannelAssociationList":{ - "type":"list", - "member":{"shape":"BotChannelAssociation"} - }, - "BotChannelName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^([A-Za-z]_?)+$" - }, - "BotMetadata":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot.

" - }, - "status":{ - "shape":"Status", - "documentation":"

The status of the bot.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was updated. When you create a bot, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the bot. For a new bot, the version is always $LATEST.

" - } - }, - "documentation":"

Provides information about a bot. .

" - }, - "BotMetadataList":{ - "type":"list", - "member":{"shape":"BotMetadata"} - }, - "BotName":{ - "type":"string", - "max":50, - "min":2, - "pattern":"^([A-Za-z]_?)+$" - }, - "BotVersions":{ - "type":"list", - "member":{"shape":"Version"}, - "max":5, - "min":1 - }, - "BuiltinIntentMetadata":{ - "type":"structure", - "members":{ - "signature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

A unique identifier for the built-in intent. To find the signature for an intent, see Standard Built-in Intents in the Alexa Skills Kit.

" - }, - "supportedLocales":{ - "shape":"LocaleList", - "documentation":"

A list of identifiers for the locales that the intent supports.

" - } - }, - "documentation":"

Provides metadata for a built-in intent.

" - }, - "BuiltinIntentMetadataList":{ - "type":"list", - "member":{"shape":"BuiltinIntentMetadata"} - }, - "BuiltinIntentSignature":{"type":"string"}, - "BuiltinIntentSlot":{ - "type":"structure", - "members":{ - "name":{ - "shape":"String", - "documentation":"

A list of the slots defined for the intent.

" - } - }, - "documentation":"

Provides information about a slot used in a built-in intent.

" - }, - "BuiltinIntentSlotList":{ - "type":"list", - "member":{"shape":"BuiltinIntentSlot"} - }, - "BuiltinSlotTypeMetadata":{ - "type":"structure", - "members":{ - "signature":{ - "shape":"BuiltinSlotTypeSignature", - "documentation":"

A unique identifier for the built-in slot type. To find the signature for a slot type, see Slot Type Reference in the Alexa Skills Kit.

" - }, - "supportedLocales":{ - "shape":"LocaleList", - "documentation":"

A list of target locales for the slot.

" - } - }, - "documentation":"

Provides information about a built in slot type.

" - }, - "BuiltinSlotTypeMetadataList":{ - "type":"list", - "member":{"shape":"BuiltinSlotTypeMetadata"} - }, - "BuiltinSlotTypeSignature":{"type":"string"}, - "ChannelConfigurationMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"}, - "max":10, - "min":1, - "sensitive":true - }, - "ChannelStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "CREATED", - "FAILED" - ] - }, - "ChannelType":{ - "type":"string", - "enum":[ - "Facebook", - "Slack", - "Twilio-Sms", - "Kik" - ] - }, - "CodeHook":{ - "type":"structure", - "required":[ - "uri", - "messageVersion" - ], - "members":{ - "uri":{ - "shape":"LambdaARN", - "documentation":"

The Amazon Resource Name (ARN) of the Lambda function.

" - }, - "messageVersion":{ - "shape":"MessageVersion", - "documentation":"

The version of the request-response that you want Amazon Lex to use to invoke your Lambda function. For more information, see using-lambda.

" - } - }, - "documentation":"

Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot..

" - }, - "ConflictException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

There was a conflict processing the request. Try your request again.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ContentString":{ - "type":"string", - "max":1000, - "min":1 - }, - "ContentType":{ - "type":"string", - "enum":[ - "PlainText", - "SSML", - "CustomPayload" - ] - }, - "Count":{"type":"integer"}, - "CreateBotVersionRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot that you want to create a new version of. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "checksum":{ - "shape":"String", - "documentation":"

Identifies a specific revision of the $LATEST version of the bot. If you specify a checksum and the $LATEST version of the bot has a different checksum, a PreconditionFailedException exception is returned and Amazon Lex doesn't publish a new version. If you don't specify a checksum, Amazon Lex publishes the $LATEST version.

" - } - } - }, - "CreateBotVersionResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot.

" - }, - "intents":{ - "shape":"IntentList", - "documentation":"

An array of Intent objects. For more information, see PutBot.

" - }, - "clarificationPrompt":{ - "shape":"Prompt", - "documentation":"

The message that Amazon Lex uses when it doesn't understand the user's request. For more information, see PutBot.

" - }, - "abortStatement":{ - "shape":"Statement", - "documentation":"

The message that Amazon Lex uses to abort a conversation. For more information, see PutBot.

" - }, - "status":{ - "shape":"Status", - "documentation":"

When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failureReason response element.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date when the $LATEST version of this bot was updated.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date when the bot version was created.

" - }, - "idleSessionTTLInSeconds":{ - "shape":"SessionTTL", - "documentation":"

The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. For more information, see PutBot.

" - }, - "voiceId":{ - "shape":"String", - "documentation":"

The Amazon Polly voice ID that Amazon Lex uses for voice interactions with the user.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum identifying the version of the bot that was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the bot.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

Specifies the target locale for the bot.

" - }, - "childDirected":{ - "shape":"Boolean", - "documentation":"

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

" - } - } - }, - "CreateIntentVersionRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent that you want to create a new version of. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the $LATEST version of the intent that should be used to create the new version. If you specify a checksum and the $LATEST version of the intent has a different checksum, Amazon Lex returns a PreconditionFailedException exception and doesn't publish a new version. If you don't specify a checksum, Amazon Lex publishes the $LATEST version.

" - } - } - }, - "CreateIntentVersionResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the intent.

" - }, - "slots":{ - "shape":"SlotList", - "documentation":"

An array of slot types that defines the information required to fulfill the intent.

" - }, - "sampleUtterances":{ - "shape":"IntentUtteranceList", - "documentation":"

An array of sample utterances configured for the intent.

" - }, - "confirmationPrompt":{ - "shape":"Prompt", - "documentation":"

If defined, the prompt that Amazon Lex uses to confirm the user's intent before fulfilling it.

" - }, - "rejectionStatement":{ - "shape":"Statement", - "documentation":"

If the user answers \"no\" to the question defined in confirmationPrompt, Amazon Lex responds with this statement to acknowledge that the intent was canceled.

" - }, - "followUpPrompt":{ - "shape":"FollowUpPrompt", - "documentation":"

If defined, Amazon Lex uses this prompt to solicit additional user activity after the intent is fulfilled.

" - }, - "conclusionStatement":{ - "shape":"Statement", - "documentation":"

After the Lambda function specified in the fulfillmentActivity field fulfills the intent, Amazon Lex conveys this statement to the user.

" - }, - "dialogCodeHook":{ - "shape":"CodeHook", - "documentation":"

If defined, Amazon Lex invokes this Lambda function for each user input.

" - }, - "fulfillmentActivity":{ - "shape":"FulfillmentActivity", - "documentation":"

Describes how the intent is fulfilled.

" - }, - "parentIntentSignature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

A unique identifier for a built-in intent.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was updated.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version number assigned to the new version of the intent.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the intent version created.

" - } - } - }, - "CreateSlotTypeVersionRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type that you want to create a new version for. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum for the $LATEST version of the slot type that you want to publish. If you specify a checksum and the $LATEST version of the slot type has a different checksum, Amazon Lex returns a PreconditionFailedException exception and doesn't publish the new version. If you don't specify a checksum, Amazon Lex publishes the $LATEST version.

" - } - } - }, - "CreateSlotTypeVersionResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot type.

" - }, - "enumerationValues":{ - "shape":"EnumerationValues", - "documentation":"

A list of EnumerationValue objects that defines the values that the slot type can take.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was updated. When you create a resource, the creation date and last update date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version assigned to the new slot type version.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the $LATEST version of the slot type.

" - }, - "valueSelectionStrategy":{ - "shape":"SlotValueSelectionStrategy", - "documentation":"

The strategy that Amazon Lex uses to determine the value of the slot. For more information, see PutSlotType.

" - } - } - }, - "CustomOrBuiltinSlotTypeName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^((AMAZON\\.)_?|[A-Za-z]_?)+" - }, - "DeleteBotAliasRequest":{ - "type":"structure", - "required":[ - "name", - "botName" - ], - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the alias to delete. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot that the alias points to.

", - "location":"uri", - "locationName":"botName" - } - } - }, - "DeleteBotChannelAssociationRequest":{ - "type":"structure", - "required":[ - "name", - "botName", - "botAlias" - ], - "members":{ - "name":{ - "shape":"BotChannelName", - "documentation":"

The name of the association. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botName" - }, - "botAlias":{ - "shape":"AliasName", - "documentation":"

An alias that points to the specific version of the Amazon Lex bot to which this association is being made.

", - "location":"uri", - "locationName":"aliasName" - } - } - }, - "DeleteBotRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DeleteBotVersionRequest":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot.

", - "location":"uri", - "locationName":"name" - }, - "version":{ - "shape":"NumericalVersion", - "documentation":"

The version of the bot to delete. You cannot delete the $LATEST version of the bot. To delete the $LATEST version, use the DeleteBot operation.

", - "location":"uri", - "locationName":"version" - } - } - }, - "DeleteIntentRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DeleteIntentVersionRequest":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

", - "location":"uri", - "locationName":"name" - }, - "version":{ - "shape":"NumericalVersion", - "documentation":"

The version of the intent to delete. You cannot delete the $LATEST version of the intent. To delete the $LATEST version, use the DeleteIntent operation.

", - "location":"uri", - "locationName":"version" - } - } - }, - "DeleteSlotTypeRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - } - } - }, - "DeleteSlotTypeVersionRequest":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type.

", - "location":"uri", - "locationName":"name" - }, - "version":{ - "shape":"NumericalVersion", - "documentation":"

The version of the slot type to delete. You cannot delete the $LATEST version of the slot type. To delete the $LATEST version, use the DeleteSlotType operation.

", - "location":"uri", - "locationName":"version" - } - } - }, - "DeleteUtterancesRequest":{ - "type":"structure", - "required":[ - "botName", - "userId" - ], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot that stored the utterances.

", - "location":"uri", - "locationName":"botName" - }, - "userId":{ - "shape":"UserId", - "documentation":"

The unique identifier for the user that made the utterances. This is the user ID that was sent in the PostContent or PostText operation request that contained the utterance.

", - "location":"uri", - "locationName":"userId" - } - } - }, - "Description":{ - "type":"string", - "max":200, - "min":0 - }, - "EnumerationValue":{ - "type":"structure", - "required":["value"], - "members":{ - "value":{ - "shape":"Value", - "documentation":"

The value of the slot type.

" - }, - "synonyms":{ - "shape":"SynonymList", - "documentation":"

Additional values related to the slot type value.

" - } - }, - "documentation":"

Each slot type can have a set of values. Each enumeration value represents a value the slot type can take.

For example, a pizza ordering bot could have a slot type that specifies the type of crust that the pizza should have. The slot type could include the values

  • thick

  • thin

  • stuffed

" - }, - "EnumerationValues":{ - "type":"list", - "member":{"shape":"EnumerationValue"}, - "max":10000, - "min":1 - }, - "ExportStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "READY", - "FAILED" - ] - }, - "ExportType":{ - "type":"string", - "enum":[ - "ALEXA_SKILLS_KIT", - "LEX" - ] - }, - "FollowUpPrompt":{ - "type":"structure", - "required":[ - "prompt", - "rejectionStatement" - ], - "members":{ - "prompt":{ - "shape":"Prompt", - "documentation":"

Prompts for information from the user.

" - }, - "rejectionStatement":{ - "shape":"Statement", - "documentation":"

If the user answers \"no\" to the question defined in the prompt field, Amazon Lex responds with this statement to acknowledge that the intent was canceled.

" - } - }, - "documentation":"

A prompt for additional activity after an intent is fulfilled. For example, after the OrderPizza intent is fulfilled, you might prompt the user to find out whether the user wants to order drinks.

" - }, - "FulfillmentActivity":{ - "type":"structure", - "required":["type"], - "members":{ - "type":{ - "shape":"FulfillmentActivityType", - "documentation":"

How the intent should be fulfilled, either by running a Lambda function or by returning the slot data to the client application.

" - }, - "codeHook":{ - "shape":"CodeHook", - "documentation":"

A description of the Lambda function that is run to fulfill the intent.

" - } - }, - "documentation":"

Describes how the intent is fulfilled after the user provides all of the information required for the intent. You can provide a Lambda function to process the intent, or you can return the intent information to the client application. We recommend that you use a Lambda function so that the relevant logic lives in the Cloud and limit the client-side code primarily to presentation. If you need to update the logic, you only update the Lambda function; you don't need to upgrade your client application.

Consider the following examples:

  • In a pizza ordering application, after the user provides all of the information for placing an order, you use a Lambda function to place an order with a pizzeria.

  • In a gaming application, when a user says \"pick up a rock,\" this information must go back to the client application so that it can perform the operation and update the graphics. In this case, you want Amazon Lex to return the intent data to the client.

" - }, - "FulfillmentActivityType":{ - "type":"string", - "enum":[ - "ReturnIntent", - "CodeHook" - ] - }, - "GetBotAliasRequest":{ - "type":"structure", - "required":[ - "name", - "botName" - ], - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the bot alias. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot.

", - "location":"uri", - "locationName":"botName" - } - } - }, - "GetBotAliasResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the bot alias.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot alias.

" - }, - "botVersion":{ - "shape":"Version", - "documentation":"

The version of the bot that the alias points to.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot that the alias points to.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was updated. When you create a resource, the creation date and the last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was created.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the bot alias.

" - } - } - }, - "GetBotAliasesRequest":{ - "type":"structure", - "required":["botName"], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot.

", - "location":"uri", - "locationName":"botName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of aliases. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of aliases, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of aliases to return in the response. The default is 50. .

", - "location":"querystring", - "locationName":"maxResults" - }, - "nameContains":{ - "shape":"AliasName", - "documentation":"

Substring to match in bot alias names. An alias will be returned if any part of its name matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\"

", - "location":"querystring", - "locationName":"nameContains" - } - } - }, - "GetBotAliasesResponse":{ - "type":"structure", - "members":{ - "BotAliases":{ - "shape":"BotAliasMetadataList", - "documentation":"

An array of BotAliasMetadata objects, each describing a bot alias.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching next page of aliases. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of aliases, specify the pagination token in the next request.

" - } - } - }, - "GetBotChannelAssociationRequest":{ - "type":"structure", - "required":[ - "name", - "botName", - "botAlias" - ], - "members":{ - "name":{ - "shape":"BotChannelName", - "documentation":"

The name of the association between the bot and the channel. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botName" - }, - "botAlias":{ - "shape":"AliasName", - "documentation":"

An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.

", - "location":"uri", - "locationName":"aliasName" - } - } - }, - "GetBotChannelAssociationResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotChannelName", - "documentation":"

The name of the association between the bot and the channel.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the association between the bot and the channel.

" - }, - "botAlias":{ - "shape":"AliasName", - "documentation":"

An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the association between the bot and the channel was created.

" - }, - "type":{ - "shape":"ChannelType", - "documentation":"

The type of the messaging platform.

" - }, - "botConfiguration":{ - "shape":"ChannelConfigurationMap", - "documentation":"

Provides information that the messaging platform needs to communicate with the Amazon Lex bot.

" - }, - "status":{ - "shape":"ChannelStatus", - "documentation":"

The status of the bot channel.

  • CREATED - The channel has been created and is ready for use.

  • IN_PROGRESS - Channel creation is in progress.

  • FAILED - There was an error creating the channel. For information about the reason for the failure, see the failureReason field.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex provides the reason that it failed to create the association.

" - } - } - }, - "GetBotChannelAssociationsRequest":{ - "type":"structure", - "required":[ - "botName", - "botAlias" - ], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot in the association.

", - "location":"uri", - "locationName":"botName" - }, - "botAlias":{ - "shape":"AliasNameOrListAll", - "documentation":"

An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.

", - "location":"uri", - "locationName":"aliasName" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of associations. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of associations, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of associations to return in the response. The default is 50.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nameContains":{ - "shape":"BotChannelName", - "documentation":"

Substring to match in channel association names. An association will be returned if any part of its name matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\" To return all bot channel associations, use a hyphen (\"-\") as the nameContains parameter.

", - "location":"querystring", - "locationName":"nameContains" - } - } - }, - "GetBotChannelAssociationsResponse":{ - "type":"structure", - "members":{ - "botChannelAssociations":{ - "shape":"BotChannelAssociationList", - "documentation":"

An array of objects, one for each association, that provides information about the Amazon Lex bot and its association with the channel.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of associations. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of associations, specify the pagination token in the next request.

" - } - } - }, - "GetBotRequest":{ - "type":"structure", - "required":[ - "name", - "versionOrAlias" - ], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "versionOrAlias":{ - "shape":"String", - "documentation":"

The version or alias of the bot.

", - "location":"uri", - "locationName":"versionoralias" - } - } - }, - "GetBotResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot.

" - }, - "intents":{ - "shape":"IntentList", - "documentation":"

An array of intent objects. For more information, see PutBot.

" - }, - "clarificationPrompt":{ - "shape":"Prompt", - "documentation":"

The message Amazon Lex uses when it doesn't understand the user's request. For more information, see PutBot.

" - }, - "abortStatement":{ - "shape":"Statement", - "documentation":"

The message that Amazon Lex returns when the user elects to end the conversation without completing it. For more information, see PutBot.

" - }, - "status":{ - "shape":"Status", - "documentation":"

The status of the bot. If the bot is ready to run, the status is READY. If there was a problem with building the bot, the status is FAILED and the failureReason explains why the bot did not build. If the bot was saved but not built, the status is NOT BUILT.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex explains why it failed to build the bot.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was updated. When you create a resource, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was created.

" - }, - "idleSessionTTLInSeconds":{ - "shape":"SessionTTL", - "documentation":"

The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. For more information, see PutBot.

" - }, - "voiceId":{ - "shape":"String", - "documentation":"

The Amazon Polly voice ID that Amazon Lex uses for voice interaction with the user. For more information, see PutBot.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the bot used to identify a specific revision of the bot's $LATEST version.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the bot. For a new bot, the version is always $LATEST.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The target locale for the bot.

" - }, - "childDirected":{ - "shape":"Boolean", - "documentation":"

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

" - } - } - }, - "GetBotVersionsRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot for which versions should be returned.

", - "location":"uri", - "locationName":"name" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of bot versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of bot versions to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "GetBotVersionsResponse":{ - "type":"structure", - "members":{ - "bots":{ - "shape":"BotMetadataList", - "documentation":"

An array of BotMetadata objects, one for each numbered version of the bot plus one for the $LATEST version.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of bot versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

" - } - } - }, - "GetBotsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of bots. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of bots, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of bots to return in the response that the request will return. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nameContains":{ - "shape":"BotName", - "documentation":"

Substring to match in bot names. A bot will be returned if any part of its name matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\"

", - "location":"querystring", - "locationName":"nameContains" - } - } - }, - "GetBotsResponse":{ - "type":"structure", - "members":{ - "bots":{ - "shape":"BotMetadataList", - "documentation":"

An array of botMetadata objects, with one entry for each bot.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, it includes a pagination token that you can specify in your next request to fetch the next page of bots.

" - } - } - }, - "GetBuiltinIntentRequest":{ - "type":"structure", - "required":["signature"], - "members":{ - "signature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

The unique identifier for a built-in intent. To find the signature for an intent, see Standard Built-in Intents in the Alexa Skills Kit.

", - "location":"uri", - "locationName":"signature" - } - } - }, - "GetBuiltinIntentResponse":{ - "type":"structure", - "members":{ - "signature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

The unique identifier for a built-in intent.

" - }, - "supportedLocales":{ - "shape":"LocaleList", - "documentation":"

A list of locales that the intent supports.

" - }, - "slots":{ - "shape":"BuiltinIntentSlotList", - "documentation":"

An array of BuiltinIntentSlot objects, one entry for each slot type in the intent.

" - } - } - }, - "GetBuiltinIntentsRequest":{ - "type":"structure", - "members":{ - "locale":{ - "shape":"Locale", - "documentation":"

A list of locales that the intent supports.

", - "location":"querystring", - "locationName":"locale" - }, - "signatureContains":{ - "shape":"String", - "documentation":"

Substring to match in built-in intent signatures. An intent will be returned if any part of its signature matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\" To find the signature for an intent, see Standard Built-in Intents in the Alexa Skills Kit.

", - "location":"querystring", - "locationName":"signatureContains" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of intents. If this API call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of intents, use the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of intents to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "GetBuiltinIntentsResponse":{ - "type":"structure", - "members":{ - "intents":{ - "shape":"BuiltinIntentMetadataList", - "documentation":"

An array of builtinIntentMetadata objects, one for each intent in the response.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of intents. If the response to this API call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of intents, specify the pagination token in the next request.

" - } - } - }, - "GetBuiltinSlotTypesRequest":{ - "type":"structure", - "members":{ - "locale":{ - "shape":"Locale", - "documentation":"

A list of locales that the slot type supports.

", - "location":"querystring", - "locationName":"locale" - }, - "signatureContains":{ - "shape":"String", - "documentation":"

Substring to match in built-in slot type signatures. A slot type will be returned if any part of its signature matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\"

", - "location":"querystring", - "locationName":"signatureContains" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of slot types. If the response to this API call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of slot types, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of slot types to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "GetBuiltinSlotTypesResponse":{ - "type":"structure", - "members":{ - "slotTypes":{ - "shape":"BuiltinSlotTypeMetadataList", - "documentation":"

An array of BuiltInSlotTypeMetadata objects, one entry for each slot type returned.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, the response includes a pagination token that you can use in your next request to fetch the next page of slot types.

" - } - } - }, - "GetExportRequest":{ - "type":"structure", - "required":[ - "name", - "version", - "resourceType", - "exportType" - ], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the bot to export.

", - "location":"querystring", - "locationName":"name" - }, - "version":{ - "shape":"NumericalVersion", - "documentation":"

The version of the bot to export.

", - "location":"querystring", - "locationName":"version" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to export.

", - "location":"querystring", - "locationName":"resourceType" - }, - "exportType":{ - "shape":"ExportType", - "documentation":"

The format of the exported data.

", - "location":"querystring", - "locationName":"exportType" - } - } - }, - "GetExportResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the bot being exported.

" - }, - "version":{ - "shape":"NumericalVersion", - "documentation":"

The version of the bot being exported.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of the exported resource.

" - }, - "exportType":{ - "shape":"ExportType", - "documentation":"

The format of the exported data.

" - }, - "exportStatus":{ - "shape":"ExportStatus", - "documentation":"

The status of the export.

  • IN_PROGRESS - The export is in progress.

  • READY - The export is complete.

  • FAILED - The export could not be completed.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex provides the reason that it failed to export the resource.

" - }, - "url":{ - "shape":"String", - "documentation":"

An S3 pre-signed URL that provides the location of the exported resource. The exported resource is a ZIP archive that contains the exported resource in JSON format. The structure of the archive may change. Your code should not rely on the archive structure.

" - } - } - }, - "GetImportRequest":{ - "type":"structure", - "required":["importId"], - "members":{ - "importId":{ - "shape":"String", - "documentation":"

The identifier of the import job information to return.

", - "location":"uri", - "locationName":"importId" - } - } - }, - "GetImportResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name given to the import job.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource imported.

" - }, - "mergeStrategy":{ - "shape":"MergeStrategy", - "documentation":"

The action taken when there was a conflict between an existing resource and a resource in the import file.

" - }, - "importId":{ - "shape":"String", - "documentation":"

The identifier for the specific import job.

" - }, - "importStatus":{ - "shape":"ImportStatus", - "documentation":"

The status of the import job. If the status is FAILED, you can get the reason for the failure from the failureReason field.

" - }, - "failureReason":{ - "shape":"StringList", - "documentation":"

A string that describes why an import job failed to complete.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

A timestamp for the date and time that the import job was created.

" - } - } - }, - "GetIntentRequest":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the intent.

", - "location":"uri", - "locationName":"version" - } - } - }, - "GetIntentResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the intent.

" - }, - "slots":{ - "shape":"SlotList", - "documentation":"

An array of intent slots configured for the intent.

" - }, - "sampleUtterances":{ - "shape":"IntentUtteranceList", - "documentation":"

An array of sample utterances configured for the intent.

" - }, - "confirmationPrompt":{ - "shape":"Prompt", - "documentation":"

If defined in the bot, Amazon Lex uses prompt to confirm the intent before fulfilling the user's request. For more information, see PutIntent.

" - }, - "rejectionStatement":{ - "shape":"Statement", - "documentation":"

If the user answers \"no\" to the question defined in confirmationPrompt, Amazon Lex responds with this statement to acknowledge that the intent was canceled.

" - }, - "followUpPrompt":{ - "shape":"FollowUpPrompt", - "documentation":"

If defined in the bot, Amazon Lex uses this prompt to solicit additional user activity after the intent is fulfilled. For more information, see PutIntent.

" - }, - "conclusionStatement":{ - "shape":"Statement", - "documentation":"

After the Lambda function specified in the fulfillmentActivity element fulfills the intent, Amazon Lex conveys this statement to the user.

" - }, - "dialogCodeHook":{ - "shape":"CodeHook", - "documentation":"

If defined in the bot, Amazon Amazon Lex invokes this Lambda function for each user input. For more information, see PutIntent.

" - }, - "fulfillmentActivity":{ - "shape":"FulfillmentActivity", - "documentation":"

Describes how the intent is fulfilled. For more information, see PutIntent.

" - }, - "parentIntentSignature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

A unique identifier for a built-in intent.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was updated. When you create a resource, the creation date and the last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the intent.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the intent.

" - } - } - }, - "GetIntentVersionsRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent for which versions should be returned.

", - "location":"uri", - "locationName":"name" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of intent versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of intent versions to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "GetIntentVersionsResponse":{ - "type":"structure", - "members":{ - "intents":{ - "shape":"IntentMetadataList", - "documentation":"

An array of IntentMetadata objects, one for each numbered version of the intent plus one for the $LATEST version.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of intent versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

" - } - } - }, - "GetIntentsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of intents. If the response to this API call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of intents, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of intents to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nameContains":{ - "shape":"IntentName", - "documentation":"

Substring to match in intent names. An intent will be returned if any part of its name matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\"

", - "location":"querystring", - "locationName":"nameContains" - } - } - }, - "GetIntentsResponse":{ - "type":"structure", - "members":{ - "intents":{ - "shape":"IntentMetadataList", - "documentation":"

An array of Intent objects. For more information, see PutBot.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, the response includes a pagination token that you can specify in your next request to fetch the next page of intents.

" - } - } - }, - "GetSlotTypeRequest":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type. The name is case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the slot type.

", - "location":"uri", - "locationName":"version" - } - } - }, - "GetSlotTypeResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot type.

" - }, - "enumerationValues":{ - "shape":"EnumerationValues", - "documentation":"

A list of EnumerationValue objects that defines the values that the slot type can take.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was updated. When you create a resource, the creation date and last update date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the slot type.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the $LATEST version of the slot type.

" - }, - "valueSelectionStrategy":{ - "shape":"SlotValueSelectionStrategy", - "documentation":"

The strategy that Amazon Lex uses to determine the value of the slot. For more information, see PutSlotType.

" - } - } - }, - "GetSlotTypeVersionsRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type for which versions should be returned.

", - "location":"uri", - "locationName":"name" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of slot type versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of slot type versions to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - } - } - }, - "GetSlotTypeVersionsResponse":{ - "type":"structure", - "members":{ - "slotTypes":{ - "shape":"SlotTypeMetadataList", - "documentation":"

An array of SlotTypeMetadata objects, one for each numbered version of the slot type plus one for the $LATEST version.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token for fetching the next page of slot type versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

" - } - } - }, - "GetSlotTypesRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

A pagination token that fetches the next page of slot types. If the response to this API call is truncated, Amazon Lex returns a pagination token in the response. To fetch next page of slot types, specify the pagination token in the next request.

", - "location":"querystring", - "locationName":"nextToken" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of slot types to return in the response. The default is 10.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nameContains":{ - "shape":"SlotTypeName", - "documentation":"

Substring to match in slot type names. A slot type will be returned if any part of its name matches the substring. For example, \"xyz\" matches both \"xyzabc\" and \"abcxyz.\"

", - "location":"querystring", - "locationName":"nameContains" - } - } - }, - "GetSlotTypesResponse":{ - "type":"structure", - "members":{ - "slotTypes":{ - "shape":"SlotTypeMetadataList", - "documentation":"

An array of objects, one for each slot type, that provides information such as the name of the slot type, the version, and a description.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, it includes a pagination token that you can specify in your next request to fetch the next page of slot types.

" - } - } - }, - "GetUtterancesViewRequest":{ - "type":"structure", - "required":[ - "botName", - "botVersions", - "statusType" - ], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot for which utterance information should be returned.

", - "location":"uri", - "locationName":"botname" - }, - "botVersions":{ - "shape":"BotVersions", - "documentation":"

An array of bot versions for which utterance information should be returned. The limit is 5 versions per request.

", - "location":"querystring", - "locationName":"bot_versions" - }, - "statusType":{ - "shape":"StatusType", - "documentation":"

To return utterances that were recognized and handled, useDetected. To return utterances that were not recognized, use Missed.

", - "location":"querystring", - "locationName":"status_type" - } - } - }, - "GetUtterancesViewResponse":{ - "type":"structure", - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot for which utterance information was returned.

" - }, - "utterances":{ - "shape":"ListsOfUtterances", - "documentation":"

An array of UtteranceList objects, each containing a list of UtteranceData objects describing the utterances that were processed by your bot. The response contains a maximum of 100 UtteranceData objects for each version.

" - } - } - }, - "GroupNumber":{ - "type":"integer", - "box":true, - "max":5, - "min":1 - }, - "ImportStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "COMPLETE", - "FAILED" - ] - }, - "Intent":{ - "type":"structure", - "required":[ - "intentName", - "intentVersion" - ], - "members":{ - "intentName":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

" - }, - "intentVersion":{ - "shape":"Version", - "documentation":"

The version of the intent.

" - } - }, - "documentation":"

Identifies the specific version of an intent.

" - }, - "IntentList":{ - "type":"list", - "member":{"shape":"Intent"} - }, - "IntentMetadata":{ - "type":"structure", - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the intent.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was updated. When you create an intent, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the intent.

" - } - }, - "documentation":"

Provides information about an intent.

" - }, - "IntentMetadataList":{ - "type":"list", - "member":{"shape":"IntentMetadata"} - }, - "IntentName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^([A-Za-z]_?)+$" - }, - "IntentUtteranceList":{ - "type":"list", - "member":{"shape":"Utterance"}, - "max":1500, - "min":0 - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

An internal Amazon Lex error occurred. Try your request again.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "LambdaARN":{ - "type":"string", - "max":2048, - "min":20, - "pattern":"arn:aws:lambda:[a-z]+-[a-z]+-[0-9]:[0-9]{12}:function:[a-zA-Z0-9-_]+(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})?(:[a-zA-Z0-9-_]+)?" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"String"} - }, - "documentation":"

The request exceeded a limit. Try your request again.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListOfUtterance":{ - "type":"list", - "member":{"shape":"UtteranceData"} - }, - "ListsOfUtterances":{ - "type":"list", - "member":{"shape":"UtteranceList"} - }, - "Locale":{ - "type":"string", - "enum":[ - "en-US", - "en-GB", - "de-DE" - ] - }, - "LocaleList":{ - "type":"list", - "member":{"shape":"Locale"} - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":50, - "min":1 - }, - "MergeStrategy":{ - "type":"string", - "enum":[ - "OVERWRITE_LATEST", - "FAIL_ON_CONFLICT" - ] - }, - "Message":{ - "type":"structure", - "required":[ - "contentType", - "content" - ], - "members":{ - "contentType":{ - "shape":"ContentType", - "documentation":"

The content type of the message string.

" - }, - "content":{ - "shape":"ContentString", - "documentation":"

The text of the message.

" - }, - "groupNumber":{ - "shape":"GroupNumber", - "documentation":"

Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.

" - } - }, - "documentation":"

The message object that provides the message text and its type.

" - }, - "MessageList":{ - "type":"list", - "member":{"shape":"Message"}, - "max":15, - "min":1 - }, - "MessageVersion":{ - "type":"string", - "max":5, - "min":1 - }, - "Name":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[a-zA-Z_]+" - }, - "NextToken":{"type":"string"}, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The resource specified in the request was not found. Check the resource and try again.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NumericalVersion":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[0-9]+" - }, - "PreconditionFailedException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The checksum of the resource that you are trying to change does not match the checksum in the request. Check the resource's checksum and try again.

", - "error":{"httpStatusCode":412}, - "exception":true - }, - "Priority":{ - "type":"integer", - "max":100, - "min":0 - }, - "ProcessBehavior":{ - "type":"string", - "enum":[ - "SAVE", - "BUILD" - ] - }, - "Prompt":{ - "type":"structure", - "required":[ - "messages", - "maxAttempts" - ], - "members":{ - "messages":{ - "shape":"MessageList", - "documentation":"

An array of objects, each of which provides a message string and its type. You can specify the message string in plain text or in Speech Synthesis Markup Language (SSML).

" - }, - "maxAttempts":{ - "shape":"PromptMaxAttempts", - "documentation":"

The number of times to prompt the user for information.

" - }, - "responseCard":{ - "shape":"ResponseCard", - "documentation":"

A response card. Amazon Lex uses this prompt at runtime, in the PostText API response. It substitutes session attributes and slot values for placeholders in the response card. For more information, see ex-resp-card.

" - } - }, - "documentation":"

Obtains information from the user. To define a prompt, provide one or more messages and specify the number of attempts to get information from the user. If you provide more than one message, Amazon Lex chooses one of the messages to use to prompt the user. For more information, see how-it-works.

" - }, - "PromptMaxAttempts":{ - "type":"integer", - "max":5, - "min":1 - }, - "PutBotAliasRequest":{ - "type":"structure", - "required":[ - "name", - "botVersion", - "botName" - ], - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the alias. The name is not case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the alias.

" - }, - "botVersion":{ - "shape":"Version", - "documentation":"

The version of the bot.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot.

", - "location":"uri", - "locationName":"botName" - }, - "checksum":{ - "shape":"String", - "documentation":"

Identifies a specific revision of the $LATEST version.

When you create a new bot alias, leave the checksum field blank. If you specify a checksum you get a BadRequestException exception.

When you want to update a bot alias, set the checksum field to the checksum of the most recent revision of the $LATEST version. If you don't specify the checksum field, or if the checksum does not match the $LATEST version, you get a PreconditionFailedException exception.

" - } - } - }, - "PutBotAliasResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"AliasName", - "documentation":"

The name of the alias.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the alias.

" - }, - "botVersion":{ - "shape":"Version", - "documentation":"

The version of the bot that the alias points to.

" - }, - "botName":{ - "shape":"BotName", - "documentation":"

The name of the bot that the alias points to.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was updated. When you create a resource, the creation date and the last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot alias was created.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

The checksum for the current version of the alias.

" - } - } - }, - "PutBotRequest":{ - "type":"structure", - "required":[ - "name", - "locale", - "childDirected" - ], - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot. The name is not case sensitive.

", - "location":"uri", - "locationName":"name" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot.

" - }, - "intents":{ - "shape":"IntentList", - "documentation":"

An array of Intent objects. Each intent represents a command that a user can express. For example, a pizza ordering bot might support an OrderPizza intent. For more information, see how-it-works.

" - }, - "clarificationPrompt":{ - "shape":"Prompt", - "documentation":"

When Amazon Lex doesn't understand the user's intent, it uses this message to get clarification. To specify how many times Amazon Lex should repeate the clarification prompt, use the maxAttempts field. If Amazon Lex still doesn't understand, it sends the message in the abortStatement field.

When you create a clarification prompt, make sure that it suggests the correct response from the user. for example, for a bot that orders pizza and drinks, you might create this clarification prompt: \"What would you like to do? You can say 'Order a pizza' or 'Order a drink.'\"

" - }, - "abortStatement":{ - "shape":"Statement", - "documentation":"

When Amazon Lex can't understand the user's input in context, it tries to elicit the information a few times. After that, Amazon Lex sends the message defined in abortStatement to the user, and then aborts the conversation. To set the number of retries, use the valueElicitationPrompt field for the slot type.

For example, in a pizza ordering bot, Amazon Lex might ask a user \"What type of crust would you like?\" If the user's response is not one of the expected responses (for example, \"thin crust, \"deep dish,\" etc.), Amazon Lex tries to elicit a correct response a few more times.

For example, in a pizza ordering application, OrderPizza might be one of the intents. This intent might require the CrustType slot. You specify the valueElicitationPrompt field when you create the CrustType slot.

" - }, - "idleSessionTTLInSeconds":{ - "shape":"SessionTTL", - "documentation":"

The maximum time in seconds that Amazon Lex retains the data gathered in a conversation.

A user interaction session remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

For example, suppose that a user chooses the OrderPizza intent, but gets sidetracked halfway through placing an order. If the user doesn't complete the order within the specified time, Amazon Lex discards the slot information that it gathered, and the user must start over.

If you don't include the idleSessionTTLInSeconds element in a PutBot operation request, Amazon Lex uses the default value. This is also true if the request replaces an existing bot.

The default is 300 seconds (5 minutes).

" - }, - "voiceId":{ - "shape":"String", - "documentation":"

The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Identifies a specific revision of the $LATEST version.

When you create a new bot, leave the checksum field blank. If you specify a checksum you get a BadRequestException exception.

When you want to update a bot, set the checksum field to the checksum of the most recent revision of the $LATEST version. If you don't specify the checksum field, or if the checksum does not match the $LATEST version, you get a PreconditionFailedException exception.

" - }, - "processBehavior":{ - "shape":"ProcessBehavior", - "documentation":"

If you set the processBehavior element to BUILD, Amazon Lex builds the bot so that it can be run. If you set the element to SAVE Amazon Lex saves the bot, but doesn't build it.

If you don't specify this value, the default value is BUILD.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot.

The default is en-US.

" - }, - "childDirected":{ - "shape":"Boolean", - "documentation":"

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "PutBotResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"BotName", - "documentation":"

The name of the bot.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the bot.

" - }, - "intents":{ - "shape":"IntentList", - "documentation":"

An array of Intent objects. For more information, see PutBot.

" - }, - "clarificationPrompt":{ - "shape":"Prompt", - "documentation":"

The prompts that Amazon Lex uses when it doesn't understand the user's intent. For more information, see PutBot.

" - }, - "abortStatement":{ - "shape":"Statement", - "documentation":"

The message that Amazon Lex uses to abort a conversation. For more information, see PutBot.

" - }, - "status":{ - "shape":"Status", - "documentation":"

When you send a request to create a bot with processBehavior set to BUILD, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, Amazon Lex sets status to FAILED. Amazon Lex returns the reason for the failure in the failureReason response element.

When you set processBehaviorto SAVE, Amazon Lex sets the status code to NOT BUILT.

" - }, - "failureReason":{ - "shape":"String", - "documentation":"

If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was updated. When you create a resource, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the bot was created.

" - }, - "idleSessionTTLInSeconds":{ - "shape":"SessionTTL", - "documentation":"

The maximum length of time that Amazon Lex retains the data gathered in a conversation. For more information, see PutBot.

" - }, - "voiceId":{ - "shape":"String", - "documentation":"

The Amazon Polly voice ID that Amazon Lex uses for voice interaction with the user. For more information, see PutBot.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the bot that you created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the bot. For a new bot, the version is always $LATEST.

" - }, - "locale":{ - "shape":"Locale", - "documentation":"

The target locale for the bot.

" - }, - "childDirected":{ - "shape":"Boolean", - "documentation":"

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "PutIntentRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent. The name is not case sensitive.

The name can't match a built-in intent name, or a built-in intent name with \"AMAZON.\" removed. For example, because there is a built-in intent called AMAZON.HelpIntent, you can't create a custom intent called HelpIntent.

For a list of built-in intents, see Standard Built-in Intents in the Alexa Skills Kit.

", - "location":"uri", - "locationName":"name" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the intent.

" - }, - "slots":{ - "shape":"SlotList", - "documentation":"

An array of intent slots. At runtime, Amazon Lex elicits required slot values from the user using prompts defined in the slots. For more information, see how-it-works.

" - }, - "sampleUtterances":{ - "shape":"IntentUtteranceList", - "documentation":"

An array of utterances (strings) that a user might say to signal the intent. For example, \"I want {PizzaSize} pizza\", \"Order {Quantity} {PizzaSize} pizzas\".

In each utterance, a slot name is enclosed in curly braces.

" - }, - "confirmationPrompt":{ - "shape":"Prompt", - "documentation":"

Prompts the user to confirm the intent. This question should have a yes or no answer.

Amazon Lex uses this prompt to ensure that the user acknowledges that the intent is ready for fulfillment. For example, with the OrderPizza intent, you might want to confirm that the order is correct before placing it. For other intents, such as intents that simply respond to user questions, you might not need to ask the user for confirmation before providing the information.

You you must provide both the rejectionStatement and the confirmationPrompt, or neither.

" - }, - "rejectionStatement":{ - "shape":"Statement", - "documentation":"

When the user answers \"no\" to the question defined in confirmationPrompt, Amazon Lex responds with this statement to acknowledge that the intent was canceled.

You must provide both the rejectionStatement and the confirmationPrompt, or neither.

" - }, - "followUpPrompt":{ - "shape":"FollowUpPrompt", - "documentation":"

Amazon Lex uses this prompt to solicit additional activity after fulfilling an intent. For example, after the OrderPizza intent is fulfilled, you might prompt the user to order a drink.

The action that Amazon Lex takes depends on the user's response, as follows:

  • If the user says \"Yes\" it responds with the clarification prompt that is configured for the bot.

  • if the user says \"Yes\" and continues with an utterance that triggers an intent it starts a conversation for the intent.

  • If the user says \"No\" it responds with the rejection statement configured for the the follow-up prompt.

  • If it doesn't recognize the utterance it repeats the follow-up prompt again.

The followUpPrompt field and the conclusionStatement field are mutually exclusive. You can specify only one.

" - }, - "conclusionStatement":{ - "shape":"Statement", - "documentation":"

The statement that you want Amazon Lex to convey to the user after the intent is successfully fulfilled by the Lambda function.

This element is relevant only if you provide a Lambda function in the fulfillmentActivity. If you return the intent to the client application, you can't specify this element.

The followUpPrompt and conclusionStatement are mutually exclusive. You can specify only one.

" - }, - "dialogCodeHook":{ - "shape":"CodeHook", - "documentation":"

Specifies a Lambda function to invoke for each user input. You can invoke this Lambda function to personalize user interaction.

For example, suppose your bot determines that the user is John. Your Lambda function might retrieve John's information from a backend database and prepopulate some of the values. For example, if you find that John is gluten intolerant, you might set the corresponding intent slot, GlutenIntolerant, to true. You might find John's phone number and set the corresponding session attribute.

" - }, - "fulfillmentActivity":{ - "shape":"FulfillmentActivity", - "documentation":"

Required. Describes how the intent is fulfilled. For example, after a user provides all of the information for a pizza order, fulfillmentActivity defines how the bot places an order with a local pizza store.

You might configure Amazon Lex to return all of the intent information to the client application, or direct it to invoke a Lambda function that can process the intent (for example, place an order with a pizzeria).

" - }, - "parentIntentSignature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

A unique identifier for the built-in intent to base this intent on. To find the signature for an intent, see Standard Built-in Intents in the Alexa Skills Kit.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Identifies a specific revision of the $LATEST version.

When you create a new intent, leave the checksum field blank. If you specify a checksum you get a BadRequestException exception.

When you want to update a intent, set the checksum field to the checksum of the most recent revision of the $LATEST version. If you don't specify the checksum field, or if the checksum does not match the $LATEST version, you get a PreconditionFailedException exception.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "PutIntentResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"IntentName", - "documentation":"

The name of the intent.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the intent.

" - }, - "slots":{ - "shape":"SlotList", - "documentation":"

An array of intent slots that are configured for the intent.

" - }, - "sampleUtterances":{ - "shape":"IntentUtteranceList", - "documentation":"

An array of sample utterances that are configured for the intent.

" - }, - "confirmationPrompt":{ - "shape":"Prompt", - "documentation":"

If defined in the intent, Amazon Lex prompts the user to confirm the intent before fulfilling it.

" - }, - "rejectionStatement":{ - "shape":"Statement", - "documentation":"

If the user answers \"no\" to the question defined in confirmationPrompt Amazon Lex responds with this statement to acknowledge that the intent was canceled.

" - }, - "followUpPrompt":{ - "shape":"FollowUpPrompt", - "documentation":"

If defined in the intent, Amazon Lex uses this prompt to solicit additional user activity after the intent is fulfilled.

" - }, - "conclusionStatement":{ - "shape":"Statement", - "documentation":"

After the Lambda function specified in thefulfillmentActivityintent fulfills the intent, Amazon Lex conveys this statement to the user.

" - }, - "dialogCodeHook":{ - "shape":"CodeHook", - "documentation":"

If defined in the intent, Amazon Lex invokes this Lambda function for each user input.

" - }, - "fulfillmentActivity":{ - "shape":"FulfillmentActivity", - "documentation":"

If defined in the intent, Amazon Lex invokes this Lambda function to fulfill the intent after the user provides all of the information required by the intent.

" - }, - "parentIntentSignature":{ - "shape":"BuiltinIntentSignature", - "documentation":"

A unique identifier for the built-in intent that this intent is based on.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was updated. When you create a resource, the creation date and last update dates are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the intent was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the intent. For a new intent, the version is always $LATEST.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the $LATESTversion of the intent created or updated.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "PutSlotTypeRequest":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type. The name is not case sensitive.

The name can't match a built-in slot type name, or a built-in slot type name with \"AMAZON.\" removed. For example, because there is a built-in slot type called AMAZON.DATE, you can't create a custom slot type called DATE.

For a list of built-in slot types, see Slot Type Reference in the Alexa Skills Kit.

", - "location":"uri", - "locationName":"name" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot type.

" - }, - "enumerationValues":{ - "shape":"EnumerationValues", - "documentation":"

A list of EnumerationValue objects that defines the values that the slot type can take. Each value can have a list of synonyms, which are additional values that help train the machine learning model about the values that it resolves for a slot.

When Amazon Lex resolves a slot value, it generates a resolution list that contains up to five possible values for the slot. If you are using a Lambda function, this resolution list is passed to the function. If you are not using a Lambda function you can choose to return the value that the user entered or the first value in the resolution list as the slot value. The valueSelectionStrategy field indicates the option to use.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Identifies a specific revision of the $LATEST version.

When you create a new slot type, leave the checksum field blank. If you specify a checksum you get a BadRequestException exception.

When you want to update a slot type, set the checksum field to the checksum of the most recent revision of the $LATEST version. If you don't specify the checksum field, or if the checksum does not match the $LATEST version, you get a PreconditionFailedException exception.

" - }, - "valueSelectionStrategy":{ - "shape":"SlotValueSelectionStrategy", - "documentation":"

Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

  • ORIGINAL_VALUE - Returns the value entered by the user, if the user value is similar to the slot value.

  • TOP_RESOLUTION - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

If you don't specify the valueSelectionStrategy, the default is ORIGINAL_VALUE.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "PutSlotTypeResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot type.

" - }, - "enumerationValues":{ - "shape":"EnumerationValues", - "documentation":"

A list of EnumerationValue objects that defines the values that the slot type can take.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was updated. When you create a slot type, the creation date and last update date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the slot type. For a new slot type, the version is always $LATEST.

" - }, - "checksum":{ - "shape":"String", - "documentation":"

Checksum of the $LATEST version of the slot type.

" - }, - "valueSelectionStrategy":{ - "shape":"SlotValueSelectionStrategy", - "documentation":"

The slot resolution strategy that Amazon Lex uses to determine the value of the slot. For more information, see PutSlotType.

" - }, - "createVersion":{"shape":"Boolean"} - } - }, - "ReferenceType":{ - "type":"string", - "enum":[ - "Intent", - "Bot", - "BotAlias", - "BotChannel" - ] - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "referenceType":{"shape":"ReferenceType"}, - "exampleReference":{"shape":"ResourceReference"} - }, - "documentation":"

The resource that you are attempting to delete is referred to by another resource. Use this information to remove references to the resource that you are trying to delete.

The body of the exception contains a JSON object that describes the resource.

{ \"resourceType\": BOT | BOTALIAS | BOTCHANNEL | INTENT,

\"resourceReference\": {

\"name\": string, \"version\": string } }

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ResourceReference":{ - "type":"structure", - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the resource that is using the resource that you are trying to delete.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the resource that is using the resource that you are trying to delete.

" - } - }, - "documentation":"

Describes the resource that refers to the resource that you are attempting to delete. This object is returned as part of the ResourceInUseException exception.

" - }, - "ResourceType":{ - "type":"string", - "enum":[ - "BOT", - "INTENT", - "SLOT_TYPE" - ] - }, - "ResponseCard":{ - "type":"string", - "max":50000, - "min":1 - }, - "SessionTTL":{ - "type":"integer", - "max":86400, - "min":60 - }, - "Slot":{ - "type":"structure", - "required":[ - "name", - "slotConstraint" - ], - "members":{ - "name":{ - "shape":"SlotName", - "documentation":"

The name of the slot.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot.

" - }, - "slotConstraint":{ - "shape":"SlotConstraint", - "documentation":"

Specifies whether the slot is required or optional.

" - }, - "slotType":{ - "shape":"CustomOrBuiltinSlotTypeName", - "documentation":"

The type of the slot, either a custom slot type that you defined or one of the built-in slot types.

" - }, - "slotTypeVersion":{ - "shape":"Version", - "documentation":"

The version of the slot type.

" - }, - "valueElicitationPrompt":{ - "shape":"Prompt", - "documentation":"

The prompt that Amazon Lex uses to elicit the slot value from the user.

" - }, - "priority":{ - "shape":"Priority", - "documentation":"

Directs Lex the order in which to elicit this slot value from the user. For example, if the intent has two slots with priorities 1 and 2, AWS Lex first elicits a value for the slot with priority 1.

If multiple slots share the same priority, the order in which Lex elicits values is arbitrary.

" - }, - "sampleUtterances":{ - "shape":"SlotUtteranceList", - "documentation":"

If you know a specific pattern with which users might respond to an Amazon Lex request for a slot value, you can provide those utterances to improve accuracy. This is optional. In most cases, Amazon Lex is capable of understanding user utterances.

" - }, - "responseCard":{ - "shape":"ResponseCard", - "documentation":"

A set of possible responses for the slot type used by text-based clients. A user chooses an option from the response card, instead of using text to reply.

" - } - }, - "documentation":"

Identifies the version of a specific slot.

" - }, - "SlotConstraint":{ - "type":"string", - "enum":[ - "Required", - "Optional" - ] - }, - "SlotList":{ - "type":"list", - "member":{"shape":"Slot"}, - "max":100, - "min":0 - }, - "SlotName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^([A-Za-z](-|_|.)?)+$" - }, - "SlotTypeMetadata":{ - "type":"structure", - "members":{ - "name":{ - "shape":"SlotTypeName", - "documentation":"

The name of the slot type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A description of the slot type.

" - }, - "lastUpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was updated. When you create a resource, the creation date and last updated date are the same.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

The date that the slot type was created.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the slot type.

" - } - }, - "documentation":"

Provides information about a slot type..

" - }, - "SlotTypeMetadataList":{ - "type":"list", - "member":{"shape":"SlotTypeMetadata"} - }, - "SlotTypeName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^([A-Za-z]_?)+$" - }, - "SlotUtteranceList":{ - "type":"list", - "member":{"shape":"Utterance"}, - "max":10, - "min":0 - }, - "SlotValueSelectionStrategy":{ - "type":"string", - "enum":[ - "ORIGINAL_VALUE", - "TOP_RESOLUTION" - ] - }, - "StartImportRequest":{ - "type":"structure", - "required":[ - "payload", - "resourceType", - "mergeStrategy" - ], - "members":{ - "payload":{ - "shape":"Blob", - "documentation":"

A zip archive in binary format. The archive should contain one file, a JSON file containing the resource to import. The resource should match the type specified in the resourceType field.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

Specifies the type of resource to export. Each resource also exports any resources that it depends on.

  • A bot exports dependent intents.

  • An intent exports dependent slot types.

" - }, - "mergeStrategy":{ - "shape":"MergeStrategy", - "documentation":"

Specifies the action that the StartImport operation should take when there is an existing resource with the same name.

  • FAIL_ON_CONFLICT - The import operation is stopped on the first conflict between a resource in the import file and an existing resource. The name of the resource causing the conflict is in the failureReason field of the response to the GetImport operation.

    OVERWRITE_LATEST - The import operation proceeds even if there is a conflict with an existing resource. The $LASTEST version of the existing resource is overwritten with the data from the import file.

" - } - } - }, - "StartImportResponse":{ - "type":"structure", - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name given to the import job.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource to import.

" - }, - "mergeStrategy":{ - "shape":"MergeStrategy", - "documentation":"

The action to take when there is a merge conflict.

" - }, - "importId":{ - "shape":"String", - "documentation":"

The identifier for the specific import job.

" - }, - "importStatus":{ - "shape":"ImportStatus", - "documentation":"

The status of the import job. If the status is FAILED, you can get the reason for the failure using the GetImport operation.

" - }, - "createdDate":{ - "shape":"Timestamp", - "documentation":"

A timestamp for the date and time that the import job was requested.

" - } - } - }, - "Statement":{ - "type":"structure", - "required":["messages"], - "members":{ - "messages":{ - "shape":"MessageList", - "documentation":"

A collection of message objects.

" - }, - "responseCard":{ - "shape":"ResponseCard", - "documentation":"

At runtime, if the client is using the PostText API, Amazon Lex includes the response card in the response. It substitutes all of the session attributes and slot values for placeholders in the response card.

" - } - }, - "documentation":"

A collection of messages that convey information to the user. At runtime, Amazon Lex selects the message to convey.

" - }, - "Status":{ - "type":"string", - "enum":[ - "BUILDING", - "READY", - "FAILED", - "NOT_BUILT" - ] - }, - "StatusType":{ - "type":"string", - "enum":[ - "Detected", - "Missed" - ] - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SynonymList":{ - "type":"list", - "member":{"shape":"Value"} - }, - "Timestamp":{"type":"timestamp"}, - "UserId":{ - "type":"string", - "max":100, - "min":2 - }, - "Utterance":{ - "type":"string", - "max":200, - "min":1 - }, - "UtteranceData":{ - "type":"structure", - "members":{ - "utteranceString":{ - "shape":"UtteranceString", - "documentation":"

The text that was entered by the user or the text representation of an audio clip.

" - }, - "count":{ - "shape":"Count", - "documentation":"

The number of times that the utterance was processed.

" - }, - "distinctUsers":{ - "shape":"Count", - "documentation":"

The total number of individuals that used the utterance.

" - }, - "firstUtteredDate":{ - "shape":"Timestamp", - "documentation":"

The date that the utterance was first recorded.

" - }, - "lastUtteredDate":{ - "shape":"Timestamp", - "documentation":"

The date that the utterance was last recorded.

" - } - }, - "documentation":"

Provides information about a single utterance that was made to your bot.

" - }, - "UtteranceList":{ - "type":"structure", - "members":{ - "botVersion":{ - "shape":"Version", - "documentation":"

The version of the bot that processed the list.

" - }, - "utterances":{ - "shape":"ListOfUtterance", - "documentation":"

One or more UtteranceData objects that contain information about the utterances that have been made to a bot. The maximum number of object is 100.

" - } - }, - "documentation":"

Provides a list of utterances that have been made to a specific version of your bot. The list contains a maximum of 100 utterances.

" - }, - "UtteranceString":{ - "type":"string", - "max":2000, - "min":1 - }, - "Value":{ - "type":"string", - "max":140, - "min":1 - }, - "Version":{ - "type":"string", - "max":64, - "min":1, - "pattern":"\\$LATEST|[0-9]+" - } - }, - "documentation":"Amazon Lex Build-Time Actions

Amazon Lex is an AWS service for building conversational voice and text interfaces. Use these actions to create, update, and delete conversational bots for new and existing client applications.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/service-2.json deleted file mode 100644 index 1b3bc10e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lex-runtime/2016-11-28/service-2.json +++ /dev/null @@ -1,524 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-28", - "endpointPrefix":"runtime.lex", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"Amazon Lex Runtime Service", - "serviceId":"Lex Runtime Service", - "signatureVersion":"v4", - "signingName":"lex", - "uid":"runtime.lex-2016-11-28" - }, - "operations":{ - "PostContent":{ - "name":"PostContent", - "http":{ - "method":"POST", - "requestUri":"/bot/{botName}/alias/{botAlias}/user/{userId}/content" - }, - "input":{"shape":"PostContentRequest"}, - "output":{"shape":"PostContentResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ConflictException"}, - {"shape":"UnsupportedMediaTypeException"}, - {"shape":"NotAcceptableException"}, - {"shape":"RequestTimeoutException"}, - {"shape":"DependencyFailedException"}, - {"shape":"BadGatewayException"}, - {"shape":"LoopDetectedException"} - ], - "documentation":"

Sends user input (text or speech) to Amazon Lex. Clients use this API to send text and audio requests to Amazon Lex at runtime. Amazon Lex interprets the user input using the machine learning model that it built for the bot.

The PostContent operation supports audio input at 8kHz and 16kHz. You can use 8kHz audio to achieve higher speech recognition accuracy in telephone audio applications.

In response, Amazon Lex returns the next message to convey to the user. Consider the following example messages:

  • For a user input \"I would like a pizza,\" Amazon Lex might return a response with a message eliciting slot data (for example, PizzaSize): \"What size pizza would you like?\".

  • After the user provides all of the pizza order information, Amazon Lex might return a response with a message to get user confirmation: \"Order the pizza?\".

  • After the user replies \"Yes\" to the confirmation prompt, Amazon Lex might return a conclusion statement: \"Thank you, your cheese pizza has been ordered.\".

Not all Amazon Lex messages require a response from the user. For example, conclusion statements do not require a response. Some messages require only a yes or no response. In addition to the message, Amazon Lex provides additional context about the message in the response that you can use to enhance client behavior, such as displaying the appropriate client user interface. Consider the following examples:

  • If the message is to elicit slot data, Amazon Lex returns the following context information:

    • x-amz-lex-dialog-state header set to ElicitSlot

    • x-amz-lex-intent-name header set to the intent name in the current context

    • x-amz-lex-slot-to-elicit header set to the slot name for which the message is eliciting information

    • x-amz-lex-slots header set to a map of slots configured for the intent with their current values

  • If the message is a confirmation prompt, the x-amz-lex-dialog-state header is set to Confirmation and the x-amz-lex-slot-to-elicit header is omitted.

  • If the message is a clarification prompt configured for the intent, indicating that the user intent is not understood, the x-amz-dialog-state header is set to ElicitIntent and the x-amz-slot-to-elicit header is omitted.

In addition, Amazon Lex also returns your application-specific sessionAttributes. For more information, see Managing Conversation Context.

", - "authtype":"v4-unsigned-body" - }, - "PostText":{ - "name":"PostText", - "http":{ - "method":"POST", - "requestUri":"/bot/{botName}/alias/{botAlias}/user/{userId}/text" - }, - "input":{"shape":"PostTextRequest"}, - "output":{"shape":"PostTextResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ConflictException"}, - {"shape":"DependencyFailedException"}, - {"shape":"BadGatewayException"}, - {"shape":"LoopDetectedException"} - ], - "documentation":"

Sends user input (text-only) to Amazon Lex. Client applications can use this API to send requests to Amazon Lex at runtime. Amazon Lex then interprets the user input using the machine learning model it built for the bot.

In response, Amazon Lex returns the next message to convey to the user an optional responseCard to display. Consider the following example messages:

  • For a user input \"I would like a pizza\", Amazon Lex might return a response with a message eliciting slot data (for example, PizzaSize): \"What size pizza would you like?\"

  • After the user provides all of the pizza order information, Amazon Lex might return a response with a message to obtain user confirmation \"Proceed with the pizza order?\".

  • After the user replies to a confirmation prompt with a \"yes\", Amazon Lex might return a conclusion statement: \"Thank you, your cheese pizza has been ordered.\".

Not all Amazon Lex messages require a user response. For example, a conclusion statement does not require a response. Some messages require only a \"yes\" or \"no\" user response. In addition to the message, Amazon Lex provides additional context about the message in the response that you might use to enhance client behavior, for example, to display the appropriate client user interface. These are the slotToElicit, dialogState, intentName, and slots fields in the response. Consider the following examples:

  • If the message is to elicit slot data, Amazon Lex returns the following context information:

    • dialogState set to ElicitSlot

    • intentName set to the intent name in the current context

    • slotToElicit set to the slot name for which the message is eliciting information

    • slots set to a map of slots, configured for the intent, with currently known values

  • If the message is a confirmation prompt, the dialogState is set to ConfirmIntent and SlotToElicit is set to null.

  • If the message is a clarification prompt (configured for the intent) that indicates that user intent is not understood, the dialogState is set to ElicitIntent and slotToElicit is set to null.

In addition, Amazon Lex also returns your application-specific sessionAttributes. For more information, see Managing Conversation Context.

" - } - }, - "shapes":{ - "Accept":{"type":"string"}, - "AttributesString":{ - "type":"string", - "sensitive":true - }, - "BadGatewayException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Either the Amazon Lex bot is still building, or one of the dependent services (Amazon Polly, AWS Lambda) failed with an internal service error.

", - "error":{"httpStatusCode":502}, - "exception":true - }, - "BadRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Request validation failed, there is no usable message in the context, or the bot build failed, is still in progress, or contains unbuilt changes.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "BlobStream":{ - "type":"blob", - "streaming":true - }, - "BotAlias":{"type":"string"}, - "BotName":{"type":"string"}, - "Button":{ - "type":"structure", - "required":[ - "text", - "value" - ], - "members":{ - "text":{ - "shape":"ButtonTextStringWithLength", - "documentation":"

Text that is visible to the user on the button.

" - }, - "value":{ - "shape":"ButtonValueStringWithLength", - "documentation":"

The value sent to Amazon Lex when a user chooses the button. For example, consider button text \"NYC.\" When the user chooses the button, the value sent can be \"New York City.\"

" - } - }, - "documentation":"

Represents an option to be shown on the client platform (Facebook, Slack, etc.)

" - }, - "ButtonTextStringWithLength":{ - "type":"string", - "max":15, - "min":1 - }, - "ButtonValueStringWithLength":{ - "type":"string", - "max":1000, - "min":1 - }, - "ConflictException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Two clients are using the same AWS account, Amazon Lex bot, and user ID.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ContentType":{ - "type":"string", - "enum":["application/vnd.amazonaws.card.generic"] - }, - "DependencyFailedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

One of the dependencies, such as AWS Lambda or Amazon Polly, threw an exception. For example,

  • If Amazon Lex does not have sufficient permissions to call a Lambda function.

  • If a Lambda function takes longer than 30 seconds to execute.

  • If a fulfillment Lambda function returns a Delegate dialog action without removing any slot values.

", - "error":{"httpStatusCode":424}, - "exception":true - }, - "DialogState":{ - "type":"string", - "enum":[ - "ElicitIntent", - "ConfirmIntent", - "ElicitSlot", - "Fulfilled", - "ReadyForFulfillment", - "Failed" - ] - }, - "ErrorMessage":{"type":"string"}, - "GenericAttachment":{ - "type":"structure", - "members":{ - "title":{ - "shape":"StringWithLength", - "documentation":"

The title of the option.

" - }, - "subTitle":{ - "shape":"StringWithLength", - "documentation":"

The subtitle shown below the title.

" - }, - "attachmentLinkUrl":{ - "shape":"StringUrlWithLength", - "documentation":"

The URL of an attachment to the response card.

" - }, - "imageUrl":{ - "shape":"StringUrlWithLength", - "documentation":"

The URL of an image that is displayed to the user.

" - }, - "buttons":{ - "shape":"listOfButtons", - "documentation":"

The list of options to show to the user.

" - } - }, - "documentation":"

Represents an option rendered to the user when a prompt is shown. It could be an image, a button, a link, or text.

" - }, - "HttpContentType":{"type":"string"}, - "IntentName":{"type":"string"}, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

Internal service error. Retry the call.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"String", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"String"} - }, - "documentation":"

Exceeded a limit.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "LoopDetectedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

This exception is not used.

", - "error":{"httpStatusCode":508}, - "exception":true - }, - "MessageFormatType":{ - "type":"string", - "enum":[ - "PlainText", - "CustomPayload", - "SSML", - "Composite" - ] - }, - "NotAcceptableException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The accept header in the request does not have a valid value.

", - "error":{"httpStatusCode":406}, - "exception":true - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The resource (such as the Amazon Lex bot or an alias) that is referred to is not found.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "PostContentRequest":{ - "type":"structure", - "required":[ - "botName", - "botAlias", - "userId", - "contentType", - "inputStream" - ], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

Name of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botName" - }, - "botAlias":{ - "shape":"BotAlias", - "documentation":"

Alias of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botAlias" - }, - "userId":{ - "shape":"UserId", - "documentation":"

The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the userID field.

To decide the user ID to use for your application, consider the following factors.

  • The userID field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.

  • If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.

  • If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.

  • A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.

", - "location":"uri", - "locationName":"userId" - }, - "sessionAttributes":{ - "shape":"AttributesString", - "documentation":"

You pass this value as the x-amz-lex-session-attributes HTTP header.

Application-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the sessionAttributes and requestAttributes headers is limited to 12 KB.

For more information, see Setting Session Attributes.

", - "jsonvalue":true, - "location":"header", - "locationName":"x-amz-lex-session-attributes" - }, - "requestAttributes":{ - "shape":"AttributesString", - "documentation":"

You pass this value as the x-amz-lex-request-attributes HTTP header.

Request-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the requestAttributes and sessionAttributes headers is limited to 12 KB.

The namespace x-amz-lex: is reserved for special attributes. Don't create any request attributes with the prefix x-amz-lex:.

For more information, see Setting Request Attributes.

", - "jsonvalue":true, - "location":"header", - "locationName":"x-amz-lex-request-attributes" - }, - "contentType":{ - "shape":"HttpContentType", - "documentation":"

You pass this value as the Content-Type HTTP header.

Indicates the audio format or text. The header value must start with one of the following prefixes:

  • PCM format, audio data must be in little-endian byte order.

    • audio/l16; rate=16000; channels=1

    • audio/x-l16; sample-rate=16000; channel-count=1

    • audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false

  • Opus format

    • audio/x-cbr-opus-with-preamble; preamble-size=0; bit-rate=256000; frame-size-milliseconds=4

  • Text format

    • text/plain; charset=utf-8

", - "location":"header", - "locationName":"Content-Type" - }, - "accept":{ - "shape":"Accept", - "documentation":"

You pass this value as the Accept HTTP header.

The message Amazon Lex returns in the response can be either text or speech based on the Accept HTTP header value in the request.

  • If the value is text/plain; charset=utf-8, Amazon Lex returns text in the response.

  • If the value begins with audio/, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech (using the configuration you specified in the Accept header). For example, if you specify audio/mpeg as the value, Amazon Lex returns speech in the MPEG format.

    The following are the accepted values:

    • audio/mpeg

    • audio/ogg

    • audio/pcm

    • text/plain; charset=utf-8

    • audio/* (defaults to mpeg)

", - "location":"header", - "locationName":"Accept" - }, - "inputStream":{ - "shape":"BlobStream", - "documentation":"

User input in PCM or Opus audio format or text format as described in the Content-Type HTTP header.

You can stream audio data to Amazon Lex or you can create a local buffer that captures all of the audio data before sending. In general, you get better performance if you stream audio data rather than buffering the data locally.

" - } - }, - "payload":"inputStream" - }, - "PostContentResponse":{ - "type":"structure", - "members":{ - "contentType":{ - "shape":"HttpContentType", - "documentation":"

Content type as specified in the Accept HTTP header in the request.

", - "location":"header", - "locationName":"Content-Type" - }, - "intentName":{ - "shape":"IntentName", - "documentation":"

Current user intent that Amazon Lex is aware of.

", - "location":"header", - "locationName":"x-amz-lex-intent-name" - }, - "slots":{ - "shape":"String", - "documentation":"

Map of zero or more intent slots (name/value pairs) Amazon Lex detected from the user input during the conversation.

Amazon Lex creates a resolution list containing likely values for a slot. The value that it returns is determined by the valueSelectionStrategy selected when the slot type was created or updated. If valueSelectionStrategy is set to ORIGINAL_VALUE, the value provided by the user is returned, if the user value is similar to the slot values. If valueSelectionStrategy is set to TOP_RESOLUTION Amazon Lex returns the first value in the resolution list or, if there is no resolution list, null. If you don't specify a valueSelectionStrategy, the default is ORIGINAL_VALUE.

", - "jsonvalue":true, - "location":"header", - "locationName":"x-amz-lex-slots" - }, - "sessionAttributes":{ - "shape":"String", - "documentation":"

Map of key/value pairs representing the session-specific context information.

", - "jsonvalue":true, - "location":"header", - "locationName":"x-amz-lex-session-attributes" - }, - "message":{ - "shape":"Text", - "documentation":"

The message to convey to the user. The message can come from the bot's configuration or from a Lambda function.

If the intent is not configured with a Lambda function, or if the Lambda function returned Delegate as the dialogAction.type its response, Amazon Lex decides on the next course of action and selects an appropriate message from the bot's configuration based on the current interaction context. For example, if Amazon Lex isn't able to understand user input, it uses a clarification prompt message.

When you create an intent you can assign messages to groups. When messages are assigned to groups Amazon Lex returns one message from each group in the response. The message field is an escaped JSON string containing the messages. For more information about the structure of the JSON string returned, see msg-prompts-formats.

If the Lambda function returns a message, Amazon Lex passes it to the client in its response.

", - "location":"header", - "locationName":"x-amz-lex-message" - }, - "messageFormat":{ - "shape":"MessageFormatType", - "documentation":"

The format of the response message. One of the following values:

  • PlainText - The message contains plain UTF-8 text.

  • CustomPayload - The message is a custom format for the client.

  • SSML - The message contains text formatted for voice output.

  • Composite - The message contains an escaped JSON object containing one or more messages from the groups that messages were assigned to when the intent was created.

", - "location":"header", - "locationName":"x-amz-lex-message-format" - }, - "dialogState":{ - "shape":"DialogState", - "documentation":"

Identifies the current state of the user interaction. Amazon Lex returns one of the following values as dialogState. The client can optionally use this information to customize the user interface.

  • ElicitIntent - Amazon Lex wants to elicit the user's intent. Consider the following examples:

    For example, a user might utter an intent (\"I want to order a pizza\"). If Amazon Lex cannot infer the user intent from this utterance, it will return this dialog state.

  • ConfirmIntent - Amazon Lex is expecting a \"yes\" or \"no\" response.

    For example, Amazon Lex wants user confirmation before fulfilling an intent. Instead of a simple \"yes\" or \"no\" response, a user might respond with additional information. For example, \"yes, but make it a thick crust pizza\" or \"no, I want to order a drink.\" Amazon Lex can process such additional information (in these examples, update the crust type slot or change the intent from OrderPizza to OrderDrink).

  • ElicitSlot - Amazon Lex is expecting the value of a slot for the current intent.

    For example, suppose that in the response Amazon Lex sends this message: \"What size pizza would you like?\". A user might reply with the slot value (e.g., \"medium\"). The user might also provide additional information in the response (e.g., \"medium thick crust pizza\"). Amazon Lex can process such additional information appropriately.

  • Fulfilled - Conveys that the Lambda function has successfully fulfilled the intent.

  • ReadyForFulfillment - Conveys that the client has to fulfill the request.

  • Failed - Conveys that the conversation with the user failed.

    This can happen for various reasons, including that the user does not provide an appropriate response to prompts from the service (you can configure how many times Amazon Lex can prompt a user for specific information), or if the Lambda function fails to fulfill the intent.

", - "location":"header", - "locationName":"x-amz-lex-dialog-state" - }, - "slotToElicit":{ - "shape":"String", - "documentation":"

If the dialogState value is ElicitSlot, returns the name of the slot for which Amazon Lex is eliciting a value.

", - "location":"header", - "locationName":"x-amz-lex-slot-to-elicit" - }, - "inputTranscript":{ - "shape":"String", - "documentation":"

The text used to process the request.

If the input was an audio stream, the inputTranscript field contains the text extracted from the audio stream. This is the text that is actually processed to recognize intents and slot values. You can use this information to determine if Amazon Lex is correctly processing the audio that you send.

", - "location":"header", - "locationName":"x-amz-lex-input-transcript" - }, - "audioStream":{ - "shape":"BlobStream", - "documentation":"

The prompt (or statement) to convey to the user. This is based on the bot configuration and context. For example, if Amazon Lex did not understand the user intent, it sends the clarificationPrompt configured for the bot. If the intent requires confirmation before taking the fulfillment action, it sends the confirmationPrompt. Another example: Suppose that the Lambda function successfully fulfilled the intent, and sent a message to convey to the user. Then Amazon Lex sends that message in the response.

" - } - }, - "payload":"audioStream" - }, - "PostTextRequest":{ - "type":"structure", - "required":[ - "botName", - "botAlias", - "userId", - "inputText" - ], - "members":{ - "botName":{ - "shape":"BotName", - "documentation":"

The name of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botName" - }, - "botAlias":{ - "shape":"BotAlias", - "documentation":"

The alias of the Amazon Lex bot.

", - "location":"uri", - "locationName":"botAlias" - }, - "userId":{ - "shape":"UserId", - "documentation":"

The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the userID field.

To decide the user ID to use for your application, consider the following factors.

  • The userID field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.

  • If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.

  • If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.

  • A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.

", - "location":"uri", - "locationName":"userId" - }, - "sessionAttributes":{ - "shape":"StringMap", - "documentation":"

Application-specific information passed between Amazon Lex and a client application.

For more information, see Setting Session Attributes.

" - }, - "requestAttributes":{ - "shape":"StringMap", - "documentation":"

Request-specific information passed between Amazon Lex and a client application.

The namespace x-amz-lex: is reserved for special attributes. Don't create any request attributes with the prefix x-amz-lex:.

For more information, see Setting Request Attributes.

" - }, - "inputText":{ - "shape":"Text", - "documentation":"

The text that the user entered (Amazon Lex interprets this text).

" - } - } - }, - "PostTextResponse":{ - "type":"structure", - "members":{ - "intentName":{ - "shape":"IntentName", - "documentation":"

The current user intent that Amazon Lex is aware of.

" - }, - "slots":{ - "shape":"StringMap", - "documentation":"

The intent slots that Amazon Lex detected from the user input in the conversation.

Amazon Lex creates a resolution list containing likely values for a slot. The value that it returns is determined by the valueSelectionStrategy selected when the slot type was created or updated. If valueSelectionStrategy is set to ORIGINAL_VALUE, the value provided by the user is returned, if the user value is similar to the slot values. If valueSelectionStrategy is set to TOP_RESOLUTION Amazon Lex returns the first value in the resolution list or, if there is no resolution list, null. If you don't specify a valueSelectionStrategy, the default is ORIGINAL_VALUE.

" - }, - "sessionAttributes":{ - "shape":"StringMap", - "documentation":"

A map of key-value pairs representing the session-specific context information.

" - }, - "message":{ - "shape":"Text", - "documentation":"

The message to convey to the user. The message can come from the bot's configuration or from a Lambda function.

If the intent is not configured with a Lambda function, or if the Lambda function returned Delegate as the dialogAction.type its response, Amazon Lex decides on the next course of action and selects an appropriate message from the bot's configuration based on the current interaction context. For example, if Amazon Lex isn't able to understand user input, it uses a clarification prompt message.

When you create an intent you can assign messages to groups. When messages are assigned to groups Amazon Lex returns one message from each group in the response. The message field is an escaped JSON string containing the messages. For more information about the structure of the JSON string returned, see msg-prompts-formats.

If the Lambda function returns a message, Amazon Lex passes it to the client in its response.

" - }, - "messageFormat":{ - "shape":"MessageFormatType", - "documentation":"

The format of the response message. One of the following values:

  • PlainText - The message contains plain UTF-8 text.

  • CustomPayload - The message is a custom format defined by the Lambda function.

  • SSML - The message contains text formatted for voice output.

  • Composite - The message contains an escaped JSON object containing one or more messages from the groups that messages were assigned to when the intent was created.

" - }, - "dialogState":{ - "shape":"DialogState", - "documentation":"

Identifies the current state of the user interaction. Amazon Lex returns one of the following values as dialogState. The client can optionally use this information to customize the user interface.

  • ElicitIntent - Amazon Lex wants to elicit user intent.

    For example, a user might utter an intent (\"I want to order a pizza\"). If Amazon Lex cannot infer the user intent from this utterance, it will return this dialogState.

  • ConfirmIntent - Amazon Lex is expecting a \"yes\" or \"no\" response.

    For example, Amazon Lex wants user confirmation before fulfilling an intent.

    Instead of a simple \"yes\" or \"no,\" a user might respond with additional information. For example, \"yes, but make it thick crust pizza\" or \"no, I want to order a drink\". Amazon Lex can process such additional information (in these examples, update the crust type slot value, or change intent from OrderPizza to OrderDrink).

  • ElicitSlot - Amazon Lex is expecting a slot value for the current intent.

    For example, suppose that in the response Amazon Lex sends this message: \"What size pizza would you like?\". A user might reply with the slot value (e.g., \"medium\"). The user might also provide additional information in the response (e.g., \"medium thick crust pizza\"). Amazon Lex can process such additional information appropriately.

  • Fulfilled - Conveys that the Lambda function configured for the intent has successfully fulfilled the intent.

  • ReadyForFulfillment - Conveys that the client has to fulfill the intent.

  • Failed - Conveys that the conversation with the user failed.

    This can happen for various reasons including that the user did not provide an appropriate response to prompts from the service (you can configure how many times Amazon Lex can prompt a user for specific information), or the Lambda function failed to fulfill the intent.

" - }, - "slotToElicit":{ - "shape":"String", - "documentation":"

If the dialogState value is ElicitSlot, returns the name of the slot for which Amazon Lex is eliciting a value.

" - }, - "responseCard":{ - "shape":"ResponseCard", - "documentation":"

Represents the options that the user has to respond to the current prompt. Response Card can come from the bot configuration (in the Amazon Lex console, choose the settings button next to a slot) or from a code hook (Lambda function).

" - } - } - }, - "RequestTimeoutException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The input speech is too long.

", - "error":{"httpStatusCode":408}, - "exception":true - }, - "ResponseCard":{ - "type":"structure", - "members":{ - "version":{ - "shape":"String", - "documentation":"

The version of the response card format.

" - }, - "contentType":{ - "shape":"ContentType", - "documentation":"

The content type of the response.

" - }, - "genericAttachments":{ - "shape":"genericAttachmentList", - "documentation":"

An array of attachment objects representing options.

" - } - }, - "documentation":"

If you configure a response card when creating your bots, Amazon Lex substitutes the session attributes and slot values that are available, and then returns it. The response card can also come from a Lambda function ( dialogCodeHook and fulfillmentActivity on an intent).

" - }, - "String":{"type":"string"}, - "StringMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"}, - "sensitive":true - }, - "StringUrlWithLength":{ - "type":"string", - "max":2048, - "min":1 - }, - "StringWithLength":{ - "type":"string", - "max":80, - "min":1 - }, - "Text":{ - "type":"string", - "max":1024, - "min":1, - "sensitive":true - }, - "UnsupportedMediaTypeException":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The Content-Type header (PostContent API) has an invalid value.

", - "error":{"httpStatusCode":415}, - "exception":true - }, - "UserId":{ - "type":"string", - "max":100, - "min":2, - "pattern":"[0-9a-zA-Z._:-]+" - }, - "genericAttachmentList":{ - "type":"list", - "member":{"shape":"GenericAttachment"}, - "max":10, - "min":0 - }, - "listOfButtons":{ - "type":"list", - "member":{"shape":"Button"}, - "max":5, - "min":0 - } - }, - "documentation":"

Amazon Lex provides both build and runtime endpoints. Each endpoint provides a set of operations (API). Your conversational bot uses the runtime API to understand user utterances (user input text or voice). For example, suppose a user says \"I want pizza\", your bot sends this input to Amazon Lex using the runtime API. Amazon Lex recognizes that the user request is for the OrderPizza intent (one of the intents defined in the bot). Then Amazon Lex engages in user conversation on behalf of the bot to elicit required information (slot values, such as pizza size and crust type), and then performs fulfillment activity (that you configured when you created the bot). You use the build-time API to create and manage your Amazon Lex bot. For a list of build-time operations, see the build-time API, .

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/paginators-1.json deleted file mode 100644 index 7c9c475f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/paginators-1.json +++ /dev/null @@ -1,49 +0,0 @@ -{ - "pagination": { - "GetActiveNames": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "activeNames" - }, - "GetBlueprints": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "blueprints" - }, - "GetBundles": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "bundles" - }, - "GetDomains": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "domains" - }, - "GetInstanceSnapshots": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "instanceSnapshots" - }, - "GetInstances": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "instances" - }, - "GetKeyPairs": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "keyPairs" - }, - "GetOperations": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "operations" - }, - "GetStaticIps": { - "input_token": "pageToken", - "output_token": "nextPageToken", - "result_key": "staticIps" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/service-2.json deleted file mode 100644 index 134b2bc2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/lightsail/2016-11-28/service-2.json +++ /dev/null @@ -1,4791 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-28", - "endpointPrefix":"lightsail", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Lightsail", - "serviceId":"Lightsail", - "signatureVersion":"v4", - "targetPrefix":"Lightsail_20161128", - "uid":"lightsail-2016-11-28" - }, - "operations":{ - "AllocateStaticIp":{ - "name":"AllocateStaticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AllocateStaticIpRequest"}, - "output":{"shape":"AllocateStaticIpResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Allocates a static IP address.

" - }, - "AttachDisk":{ - "name":"AttachDisk", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachDiskRequest"}, - "output":{"shape":"AttachDiskResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Attaches a block storage disk to a running or stopped Lightsail instance and exposes it to the instance with the specified disk name.

" - }, - "AttachInstancesToLoadBalancer":{ - "name":"AttachInstancesToLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachInstancesToLoadBalancerRequest"}, - "output":{"shape":"AttachInstancesToLoadBalancerResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Attaches one or more Lightsail instances to a load balancer.

After some time, the instances are attached to the load balancer and the health check status is available.

" - }, - "AttachLoadBalancerTlsCertificate":{ - "name":"AttachLoadBalancerTlsCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachLoadBalancerTlsCertificateRequest"}, - "output":{"shape":"AttachLoadBalancerTlsCertificateResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Attaches a Transport Layer Security (TLS) certificate to your load balancer. TLS is just an updated, more secure version of Secure Socket Layer (SSL).

Once you create and validate your certificate, you can attach it to your load balancer. You can also use this API to rotate the certificates on your account. Use the AttachLoadBalancerTlsCertificate operation with the non-attached certificate, and it will replace the existing one and become the attached certificate.

" - }, - "AttachStaticIp":{ - "name":"AttachStaticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachStaticIpRequest"}, - "output":{"shape":"AttachStaticIpResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Attaches a static IP address to a specific Amazon Lightsail instance.

" - }, - "CloseInstancePublicPorts":{ - "name":"CloseInstancePublicPorts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CloseInstancePublicPortsRequest"}, - "output":{"shape":"CloseInstancePublicPortsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Closes the public ports on a specific Amazon Lightsail instance.

" - }, - "CreateDisk":{ - "name":"CreateDisk", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDiskRequest"}, - "output":{"shape":"CreateDiskResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a block storage disk that can be attached to a Lightsail instance in the same Availability Zone (e.g., us-east-2a). The disk is created in the regional endpoint that you send the HTTP request to. For more information, see Regions and Availability Zones in Lightsail.

" - }, - "CreateDiskFromSnapshot":{ - "name":"CreateDiskFromSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDiskFromSnapshotRequest"}, - "output":{"shape":"CreateDiskFromSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a block storage disk from a disk snapshot that can be attached to a Lightsail instance in the same Availability Zone (e.g., us-east-2a). The disk is created in the regional endpoint that you send the HTTP request to. For more information, see Regions and Availability Zones in Lightsail.

" - }, - "CreateDiskSnapshot":{ - "name":"CreateDiskSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDiskSnapshotRequest"}, - "output":{"shape":"CreateDiskSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a snapshot of a block storage disk. You can use snapshots for backups, to make copies of disks, and to save data before shutting down a Lightsail instance.

You can take a snapshot of an attached disk that is in use; however, snapshots only capture data that has been written to your disk at the time the snapshot command is issued. This may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the disk long enough to take a snapshot, your snapshot should be complete. Nevertheless, if you cannot pause all file writes to the disk, you should unmount the disk from within the Lightsail instance, issue the create disk snapshot command, and then remount the disk to ensure a consistent and complete snapshot. You may remount and use your disk while the snapshot status is pending.

" - }, - "CreateDomain":{ - "name":"CreateDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDomainRequest"}, - "output":{"shape":"CreateDomainResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a domain resource for the specified domain (e.g., example.com).

" - }, - "CreateDomainEntry":{ - "name":"CreateDomainEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDomainEntryRequest"}, - "output":{"shape":"CreateDomainEntryResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates one of the following entry records associated with the domain: A record, CNAME record, TXT record, or MX record.

" - }, - "CreateInstanceSnapshot":{ - "name":"CreateInstanceSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceSnapshotRequest"}, - "output":{"shape":"CreateInstanceSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a snapshot of a specific virtual private server, or instance. You can use a snapshot to create a new instance that is based on that snapshot.

" - }, - "CreateInstances":{ - "name":"CreateInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstancesRequest"}, - "output":{"shape":"CreateInstancesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates one or more Amazon Lightsail virtual private servers, or instances.

" - }, - "CreateInstancesFromSnapshot":{ - "name":"CreateInstancesFromSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstancesFromSnapshotRequest"}, - "output":{"shape":"CreateInstancesFromSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Uses a specific snapshot as a blueprint for creating one or more new instances that are based on that identical configuration.

" - }, - "CreateKeyPair":{ - "name":"CreateKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateKeyPairRequest"}, - "output":{"shape":"CreateKeyPairResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates sn SSH key pair.

" - }, - "CreateLoadBalancer":{ - "name":"CreateLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoadBalancerRequest"}, - "output":{"shape":"CreateLoadBalancerResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a Lightsail load balancer. To learn more about deciding whether to load balance your application, see Configure your Lightsail instances for load balancing. You can create up to 5 load balancers per AWS Region in your account.

When you create a load balancer, you can specify a unique name and port settings. To change additional load balancer settings, use the UpdateLoadBalancerAttribute operation.

" - }, - "CreateLoadBalancerTlsCertificate":{ - "name":"CreateLoadBalancerTlsCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLoadBalancerTlsCertificateRequest"}, - "output":{"shape":"CreateLoadBalancerTlsCertificateResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Creates a Lightsail load balancer TLS certificate.

TLS is just an updated, more secure version of Secure Socket Layer (SSL).

" - }, - "DeleteDisk":{ - "name":"DeleteDisk", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDiskRequest"}, - "output":{"shape":"DeleteDiskResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes the specified block storage disk. The disk must be in the available state (not attached to a Lightsail instance).

The disk may remain in the deleting state for several minutes.

" - }, - "DeleteDiskSnapshot":{ - "name":"DeleteDiskSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDiskSnapshotRequest"}, - "output":{"shape":"DeleteDiskSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes the specified disk snapshot.

When you make periodic snapshots of a disk, the snapshots are incremental, and only the blocks on the device that have changed since your last snapshot are saved in the new snapshot. When you delete a snapshot, only the data not needed for any other snapshot is removed. So regardless of which prior snapshots have been deleted, all active snapshots will have access to all the information needed to restore the disk.

" - }, - "DeleteDomain":{ - "name":"DeleteDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDomainRequest"}, - "output":{"shape":"DeleteDomainResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes the specified domain recordset and all of its domain records.

" - }, - "DeleteDomainEntry":{ - "name":"DeleteDomainEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDomainEntryRequest"}, - "output":{"shape":"DeleteDomainEntryResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a specific domain entry.

" - }, - "DeleteInstance":{ - "name":"DeleteInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInstanceRequest"}, - "output":{"shape":"DeleteInstanceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a specific Amazon Lightsail virtual private server, or instance.

" - }, - "DeleteInstanceSnapshot":{ - "name":"DeleteInstanceSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInstanceSnapshotRequest"}, - "output":{"shape":"DeleteInstanceSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a specific snapshot of a virtual private server (or instance).

" - }, - "DeleteKeyPair":{ - "name":"DeleteKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteKeyPairRequest"}, - "output":{"shape":"DeleteKeyPairResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a specific SSH key pair.

" - }, - "DeleteLoadBalancer":{ - "name":"DeleteLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoadBalancerRequest"}, - "output":{"shape":"DeleteLoadBalancerResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a Lightsail load balancer and all its associated SSL/TLS certificates. Once the load balancer is deleted, you will need to create a new load balancer, create a new certificate, and verify domain ownership again.

" - }, - "DeleteLoadBalancerTlsCertificate":{ - "name":"DeleteLoadBalancerTlsCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLoadBalancerTlsCertificateRequest"}, - "output":{"shape":"DeleteLoadBalancerTlsCertificateResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes an SSL/TLS certificate associated with a Lightsail load balancer.

" - }, - "DetachDisk":{ - "name":"DetachDisk", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachDiskRequest"}, - "output":{"shape":"DetachDiskResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Detaches a stopped block storage disk from a Lightsail instance. Make sure to unmount any file systems on the device within your operating system before stopping the instance and detaching the disk.

" - }, - "DetachInstancesFromLoadBalancer":{ - "name":"DetachInstancesFromLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachInstancesFromLoadBalancerRequest"}, - "output":{"shape":"DetachInstancesFromLoadBalancerResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Detaches the specified instances from a Lightsail load balancer.

This operation waits until the instances are no longer needed before they are detached from the load balancer.

" - }, - "DetachStaticIp":{ - "name":"DetachStaticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachStaticIpRequest"}, - "output":{"shape":"DetachStaticIpResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Detaches a static IP from the Amazon Lightsail instance to which it is attached.

" - }, - "DownloadDefaultKeyPair":{ - "name":"DownloadDefaultKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DownloadDefaultKeyPairRequest"}, - "output":{"shape":"DownloadDefaultKeyPairResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Downloads the default SSH key pair from the user's account.

" - }, - "GetActiveNames":{ - "name":"GetActiveNames", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetActiveNamesRequest"}, - "output":{"shape":"GetActiveNamesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the names of all active (not deleted) resources.

" - }, - "GetBlueprints":{ - "name":"GetBlueprints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetBlueprintsRequest"}, - "output":{"shape":"GetBlueprintsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the list of available instance images, or blueprints. You can use a blueprint to create a new virtual private server already running a specific operating system, as well as a preinstalled app or development stack. The software each instance is running depends on the blueprint image you choose.

" - }, - "GetBundles":{ - "name":"GetBundles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetBundlesRequest"}, - "output":{"shape":"GetBundlesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the list of bundles that are available for purchase. A bundle describes the specs for your virtual private server (or instance).

" - }, - "GetDisk":{ - "name":"GetDisk", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDiskRequest"}, - "output":{"shape":"GetDiskResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific block storage disk.

" - }, - "GetDiskSnapshot":{ - "name":"GetDiskSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDiskSnapshotRequest"}, - "output":{"shape":"GetDiskSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific block storage disk snapshot.

" - }, - "GetDiskSnapshots":{ - "name":"GetDiskSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDiskSnapshotsRequest"}, - "output":{"shape":"GetDiskSnapshotsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all block storage disk snapshots in your AWS account and region.

If you are describing a long list of disk snapshots, you can paginate the output to make the list more manageable. You can use the pageToken and nextPageToken values to retrieve the next items in the list.

" - }, - "GetDisks":{ - "name":"GetDisks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDisksRequest"}, - "output":{"shape":"GetDisksResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all block storage disks in your AWS account and region.

If you are describing a long list of disks, you can paginate the output to make the list more manageable. You can use the pageToken and nextPageToken values to retrieve the next items in the list.

" - }, - "GetDomain":{ - "name":"GetDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDomainRequest"}, - "output":{"shape":"GetDomainResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific domain recordset.

" - }, - "GetDomains":{ - "name":"GetDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDomainsRequest"}, - "output":{"shape":"GetDomainsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns a list of all domains in the user's account.

" - }, - "GetInstance":{ - "name":"GetInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceRequest"}, - "output":{"shape":"GetInstanceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific Amazon Lightsail instance, which is a virtual private server.

" - }, - "GetInstanceAccessDetails":{ - "name":"GetInstanceAccessDetails", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceAccessDetailsRequest"}, - "output":{"shape":"GetInstanceAccessDetailsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns temporary SSH keys you can use to connect to a specific virtual private server, or instance.

" - }, - "GetInstanceMetricData":{ - "name":"GetInstanceMetricData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceMetricDataRequest"}, - "output":{"shape":"GetInstanceMetricDataResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the data points for the specified Amazon Lightsail instance metric, given an instance name.

" - }, - "GetInstancePortStates":{ - "name":"GetInstancePortStates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstancePortStatesRequest"}, - "output":{"shape":"GetInstancePortStatesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the port states for a specific virtual private server, or instance.

" - }, - "GetInstanceSnapshot":{ - "name":"GetInstanceSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceSnapshotRequest"}, - "output":{"shape":"GetInstanceSnapshotResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific instance snapshot.

" - }, - "GetInstanceSnapshots":{ - "name":"GetInstanceSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceSnapshotsRequest"}, - "output":{"shape":"GetInstanceSnapshotsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns all instance snapshots for the user's account.

" - }, - "GetInstanceState":{ - "name":"GetInstanceState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceStateRequest"}, - "output":{"shape":"GetInstanceStateResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns the state of a specific instance. Works on one instance at a time.

" - }, - "GetInstances":{ - "name":"GetInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstancesRequest"}, - "output":{"shape":"GetInstancesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all Amazon Lightsail virtual private servers, or instances.

" - }, - "GetKeyPair":{ - "name":"GetKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetKeyPairRequest"}, - "output":{"shape":"GetKeyPairResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific key pair.

" - }, - "GetKeyPairs":{ - "name":"GetKeyPairs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetKeyPairsRequest"}, - "output":{"shape":"GetKeyPairsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all key pairs in the user's account.

" - }, - "GetLoadBalancer":{ - "name":"GetLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLoadBalancerRequest"}, - "output":{"shape":"GetLoadBalancerResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about the specified Lightsail load balancer.

" - }, - "GetLoadBalancerMetricData":{ - "name":"GetLoadBalancerMetricData", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLoadBalancerMetricDataRequest"}, - "output":{"shape":"GetLoadBalancerMetricDataResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about health metrics for your Lightsail load balancer.

" - }, - "GetLoadBalancerTlsCertificates":{ - "name":"GetLoadBalancerTlsCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLoadBalancerTlsCertificatesRequest"}, - "output":{"shape":"GetLoadBalancerTlsCertificatesResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about the TLS certificates that are associated with the specified Lightsail load balancer.

TLS is just an updated, more secure version of Secure Socket Layer (SSL).

You can have a maximum of 2 certificates associated with a Lightsail load balancer. One is active and the other is inactive.

" - }, - "GetLoadBalancers":{ - "name":"GetLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLoadBalancersRequest"}, - "output":{"shape":"GetLoadBalancersResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all load balancers in an account.

If you are describing a long list of load balancers, you can paginate the output to make the list more manageable. You can use the pageToken and nextPageToken values to retrieve the next items in the list.

" - }, - "GetOperation":{ - "name":"GetOperation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOperationRequest"}, - "output":{"shape":"GetOperationResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific operation. Operations include events such as when you create an instance, allocate a static IP, attach a static IP, and so on.

" - }, - "GetOperations":{ - "name":"GetOperations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOperationsRequest"}, - "output":{"shape":"GetOperationsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all operations.

Results are returned from oldest to newest, up to a maximum of 200. Results can be paged by making each subsequent call to GetOperations use the maximum (last) statusChangedAt value from the previous request.

" - }, - "GetOperationsForResource":{ - "name":"GetOperationsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOperationsForResourceRequest"}, - "output":{"shape":"GetOperationsForResourceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Gets operations for a specific resource (e.g., an instance or a static IP).

" - }, - "GetRegions":{ - "name":"GetRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRegionsRequest"}, - "output":{"shape":"GetRegionsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns a list of all valid regions for Amazon Lightsail. Use the include availability zones parameter to also return the availability zones in a region.

" - }, - "GetStaticIp":{ - "name":"GetStaticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetStaticIpRequest"}, - "output":{"shape":"GetStaticIpResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about a specific static IP.

" - }, - "GetStaticIps":{ - "name":"GetStaticIps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetStaticIpsRequest"}, - "output":{"shape":"GetStaticIpsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns information about all static IPs in the user's account.

" - }, - "ImportKeyPair":{ - "name":"ImportKeyPair", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportKeyPairRequest"}, - "output":{"shape":"ImportKeyPairResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Imports a public SSH key from a specific key pair.

" - }, - "IsVpcPeered":{ - "name":"IsVpcPeered", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IsVpcPeeredRequest"}, - "output":{"shape":"IsVpcPeeredResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Returns a Boolean value indicating whether your Lightsail VPC is peered.

" - }, - "OpenInstancePublicPorts":{ - "name":"OpenInstancePublicPorts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"OpenInstancePublicPortsRequest"}, - "output":{"shape":"OpenInstancePublicPortsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Adds public ports to an Amazon Lightsail instance.

" - }, - "PeerVpc":{ - "name":"PeerVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PeerVpcRequest"}, - "output":{"shape":"PeerVpcResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Tries to peer the Lightsail VPC with the user's default VPC.

" - }, - "PutInstancePublicPorts":{ - "name":"PutInstancePublicPorts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutInstancePublicPortsRequest"}, - "output":{"shape":"PutInstancePublicPortsResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Sets the specified open ports for an Amazon Lightsail instance, and closes all ports for every protocol not included in the current request.

" - }, - "RebootInstance":{ - "name":"RebootInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstanceRequest"}, - "output":{"shape":"RebootInstanceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Restarts a specific instance. When your Amazon Lightsail instance is finished rebooting, Lightsail assigns a new public IP address. To use the same IP address after restarting, create a static IP address and attach it to the instance.

" - }, - "ReleaseStaticIp":{ - "name":"ReleaseStaticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReleaseStaticIpRequest"}, - "output":{"shape":"ReleaseStaticIpResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Deletes a specific static IP from your account.

" - }, - "StartInstance":{ - "name":"StartInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstanceRequest"}, - "output":{"shape":"StartInstanceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Starts a specific Amazon Lightsail instance from a stopped state. To restart an instance, use the reboot instance operation.

" - }, - "StopInstance":{ - "name":"StopInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstanceRequest"}, - "output":{"shape":"StopInstanceResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Stops a specific Amazon Lightsail instance that is currently running.

" - }, - "UnpeerVpc":{ - "name":"UnpeerVpc", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnpeerVpcRequest"}, - "output":{"shape":"UnpeerVpcResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Attempts to unpeer the Lightsail VPC from the user's default VPC.

" - }, - "UpdateDomainEntry":{ - "name":"UpdateDomainEntry", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDomainEntryRequest"}, - "output":{"shape":"UpdateDomainEntryResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Updates a domain recordset after it is created.

" - }, - "UpdateLoadBalancerAttribute":{ - "name":"UpdateLoadBalancerAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateLoadBalancerAttributeRequest"}, - "output":{"shape":"UpdateLoadBalancerAttributeResult"}, - "errors":[ - {"shape":"ServiceException"}, - {"shape":"InvalidInputException"}, - {"shape":"NotFoundException"}, - {"shape":"OperationFailureException"}, - {"shape":"AccessDeniedException"}, - {"shape":"AccountSetupInProgressException"}, - {"shape":"UnauthenticatedException"} - ], - "documentation":"

Updates the specified attribute for a load balancer. You can only update one attribute at a time.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials to access a resource.

", - "exception":true - }, - "AccessDirection":{ - "type":"string", - "enum":[ - "inbound", - "outbound" - ] - }, - "AccountSetupInProgressException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when an account is still in the setup in progress state.

", - "exception":true - }, - "AllocateStaticIpRequest":{ - "type":"structure", - "required":["staticIpName"], - "members":{ - "staticIpName":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP address.

" - } - } - }, - "AllocateStaticIpResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the static IP address you allocated.

" - } - } - }, - "AttachDiskRequest":{ - "type":"structure", - "required":[ - "diskName", - "instanceName", - "diskPath" - ], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique Lightsail disk name (e.g., my-disk).

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the Lightsail instance where you want to utilize the storage disk.

" - }, - "diskPath":{ - "shape":"NonEmptyString", - "documentation":"

The disk path to expose to the instance (e.g., /dev/xvdf).

" - } - } - }, - "AttachDiskResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "AttachInstancesToLoadBalancerRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "instanceNames" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer.

" - }, - "instanceNames":{ - "shape":"ResourceNameList", - "documentation":"

An array of strings representing the instance name(s) you want to attach to your load balancer.

An instance must be running before you can attach it to your load balancer.

There are no additional limits on the number of instances you can attach to your load balancer, aside from the limit of Lightsail instances you can create in your account (20).

" - } - } - }, - "AttachInstancesToLoadBalancerResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object representing the API operations.

" - } - } - }, - "AttachLoadBalancerTlsCertificateRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "certificateName" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer to which you want to associate the SSL/TLS certificate.

" - }, - "certificateName":{ - "shape":"ResourceName", - "documentation":"

The name of your SSL/TLS certificate.

" - } - } - }, - "AttachLoadBalancerTlsCertificateResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object representing the API operations.

These SSL/TLS certificates are only usable by Lightsail load balancers. You can't get the certificate and use it for another purpose.

" - } - } - }, - "AttachStaticIpRequest":{ - "type":"structure", - "required":[ - "staticIpName", - "instanceName" - ], - "members":{ - "staticIpName":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP.

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The instance name to which you want to attach the static IP address.

" - } - } - }, - "AttachStaticIpResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about your API operations.

" - } - } - }, - "AttachedDiskMap":{ - "type":"map", - "key":{"shape":"ResourceName"}, - "value":{"shape":"DiskMapList"} - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "zoneName":{ - "shape":"NonEmptyString", - "documentation":"

The name of the Availability Zone. The format is us-east-2a (case-sensitive).

" - }, - "state":{ - "shape":"NonEmptyString", - "documentation":"

The state of the Availability Zone.

" - } - }, - "documentation":"

Describes an Availability Zone.

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{"shape":"AvailabilityZone"} - }, - "Base64":{"type":"string"}, - "Blueprint":{ - "type":"structure", - "members":{ - "blueprintId":{ - "shape":"NonEmptyString", - "documentation":"

The ID for the virtual private server image (e.g., app_wordpress_4_4 or app_lamp_7_0).

" - }, - "name":{ - "shape":"ResourceName", - "documentation":"

The friendly name of the blueprint (e.g., Amazon Linux).

" - }, - "group":{ - "shape":"NonEmptyString", - "documentation":"

The group name of the blueprint (e.g., amazon-linux).

" - }, - "type":{ - "shape":"BlueprintType", - "documentation":"

The type of the blueprint (e.g., os or app).

" - }, - "description":{ - "shape":"string", - "documentation":"

The description of the blueprint.

" - }, - "isActive":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether the blueprint is active. When you update your blueprints, you will inactivate old blueprints and keep the most recent versions active.

" - }, - "minPower":{ - "shape":"integer", - "documentation":"

The minimum bundle power required to run this blueprint. For example, you need a bundle with a power value of 500 or more to create an instance that uses a blueprint with a minimum power value of 500. 0 indicates that the blueprint runs on all instance sizes.

" - }, - "version":{ - "shape":"string", - "documentation":"

The version number of the operating system, application, or stack (e.g., 2016.03.0).

" - }, - "versionCode":{ - "shape":"string", - "documentation":"

The version code.

" - }, - "productUrl":{ - "shape":"string", - "documentation":"

The product URL to learn more about the image or blueprint.

" - }, - "licenseUrl":{ - "shape":"string", - "documentation":"

The end-user license agreement URL for the image or blueprint.

" - }, - "platform":{ - "shape":"InstancePlatform", - "documentation":"

The operating system platform (either Linux/Unix-based or Windows Server-based) of the blueprint.

" - } - }, - "documentation":"

Describes a blueprint (a virtual private server image).

" - }, - "BlueprintList":{ - "type":"list", - "member":{"shape":"Blueprint"} - }, - "BlueprintType":{ - "type":"string", - "enum":[ - "os", - "app" - ] - }, - "Bundle":{ - "type":"structure", - "members":{ - "price":{ - "shape":"float", - "documentation":"

The price in US dollars (e.g., 5.0).

" - }, - "cpuCount":{ - "shape":"integer", - "documentation":"

The number of vCPUs included in the bundle (e.g., 2).

" - }, - "diskSizeInGb":{ - "shape":"integer", - "documentation":"

The size of the SSD (e.g., 30).

" - }, - "bundleId":{ - "shape":"NonEmptyString", - "documentation":"

The bundle ID (e.g., micro_1_0).

" - }, - "instanceType":{ - "shape":"string", - "documentation":"

The Amazon EC2 instance type (e.g., t2.micro).

" - }, - "isActive":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether the bundle is active.

" - }, - "name":{ - "shape":"string", - "documentation":"

A friendly name for the bundle (e.g., Micro).

" - }, - "power":{ - "shape":"integer", - "documentation":"

A numeric value that represents the power of the bundle (e.g., 500). You can use the bundle's power value in conjunction with a blueprint's minimum power value to determine whether the blueprint will run on the bundle. For example, you need a bundle with a power value of 500 or more to create an instance that uses a blueprint with a minimum power value of 500.

" - }, - "ramSizeInGb":{ - "shape":"float", - "documentation":"

The amount of RAM in GB (e.g., 2.0).

" - }, - "transferPerMonthInGb":{ - "shape":"integer", - "documentation":"

The data transfer rate per month in GB (e.g., 2000).

" - }, - "supportedPlatforms":{ - "shape":"InstancePlatformList", - "documentation":"

The operating system platform (Linux/Unix-based or Windows Server-based) that the bundle supports. You can only launch a WINDOWS bundle on a blueprint that supports the WINDOWS platform. LINUX_UNIX blueprints require a LINUX_UNIX bundle.

" - } - }, - "documentation":"

Describes a bundle, which is a set of specs describing your virtual private server (or instance).

" - }, - "BundleList":{ - "type":"list", - "member":{"shape":"Bundle"} - }, - "CloseInstancePublicPortsRequest":{ - "type":"structure", - "required":[ - "portInfo", - "instanceName" - ], - "members":{ - "portInfo":{ - "shape":"PortInfo", - "documentation":"

Information about the public port you are trying to close.

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance on which you're attempting to close the public ports.

" - } - } - }, - "CloseInstancePublicPortsResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs that contains information about the operation.

" - } - } - }, - "CreateDiskFromSnapshotRequest":{ - "type":"structure", - "required":[ - "diskName", - "diskSnapshotName", - "availabilityZone", - "sizeInGb" - ], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique Lightsail disk name (e.g., my-disk).

" - }, - "diskSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the disk snapshot (e.g., my-snapshot) from which to create the new storage disk.

" - }, - "availabilityZone":{ - "shape":"NonEmptyString", - "documentation":"

The Availability Zone where you want to create the disk (e.g., us-east-2a). Choose the same Availability Zone as the Lightsail instance where you want to create the disk.

Use the GetRegions operation to list the Availability Zones where Lightsail is currently available.

" - }, - "sizeInGb":{ - "shape":"integer", - "documentation":"

The size of the disk in GB (e.g., 32).

" - } - } - }, - "CreateDiskFromSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "CreateDiskRequest":{ - "type":"structure", - "required":[ - "diskName", - "availabilityZone", - "sizeInGb" - ], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique Lightsail disk name (e.g., my-disk).

" - }, - "availabilityZone":{ - "shape":"NonEmptyString", - "documentation":"

The Availability Zone where you want to create the disk (e.g., us-east-2a). Choose the same Availability Zone as the Lightsail instance where you want to create the disk.

Use the GetRegions operation to list the Availability Zones where Lightsail is currently available.

" - }, - "sizeInGb":{ - "shape":"integer", - "documentation":"

The size of the disk in GB (e.g., 32).

" - } - } - }, - "CreateDiskResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "CreateDiskSnapshotRequest":{ - "type":"structure", - "required":[ - "diskName", - "diskSnapshotName" - ], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique name of the source disk (e.g., my-source-disk).

" - }, - "diskSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the destination disk snapshot (e.g., my-disk-snapshot) based on the source disk.

" - } - } - }, - "CreateDiskSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "CreateDomainEntryRequest":{ - "type":"structure", - "required":[ - "domainName", - "domainEntry" - ], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name (e.g., example.com) for which you want to create the domain entry.

" - }, - "domainEntry":{ - "shape":"DomainEntry", - "documentation":"

An array of key-value pairs containing information about the domain entry request.

" - } - } - }, - "CreateDomainEntryResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the operation.

" - } - } - }, - "CreateDomainRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name to manage (e.g., example.com).

You cannot register a new domain name using Lightsail. You must register a domain name using Amazon Route 53 or another domain name registrar. If you have already registered your domain, you can enter its name in this parameter to manage the DNS records for that domain.

" - } - } - }, - "CreateDomainResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the domain resource you created.

" - } - } - }, - "CreateInstanceSnapshotRequest":{ - "type":"structure", - "required":[ - "instanceSnapshotName", - "instanceName" - ], - "members":{ - "instanceSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name for your new snapshot.

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The Lightsail instance on which to base your snapshot.

" - } - } - }, - "CreateInstanceSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your create instances snapshot request.

" - } - } - }, - "CreateInstancesFromSnapshotRequest":{ - "type":"structure", - "required":[ - "instanceNames", - "availabilityZone", - "instanceSnapshotName", - "bundleId" - ], - "members":{ - "instanceNames":{ - "shape":"StringList", - "documentation":"

The names for your new instances.

" - }, - "attachedDiskMapping":{ - "shape":"AttachedDiskMap", - "documentation":"

An object containing information about one or more disk mappings.

" - }, - "availabilityZone":{ - "shape":"string", - "documentation":"

The Availability Zone where you want to create your instances. Use the following formatting: us-east-2a (case sensitive). You can get a list of availability zones by using the get regions operation. Be sure to add the include availability zones parameter to your request.

" - }, - "instanceSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance snapshot on which you are basing your new instances. Use the get instance snapshots operation to return information about your existing snapshots.

" - }, - "bundleId":{ - "shape":"NonEmptyString", - "documentation":"

The bundle of specification information for your virtual private server (or instance), including the pricing plan (e.g., micro_1_0).

" - }, - "userData":{ - "shape":"string", - "documentation":"

You can create a launch script that configures a server with additional user data. For example, apt-get -y update.

Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, and FreeBSD uses pkg. For a complete list, see the Dev Guide.

" - }, - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name for your key pair.

" - } - } - }, - "CreateInstancesFromSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your create instances from snapshot request.

" - } - } - }, - "CreateInstancesRequest":{ - "type":"structure", - "required":[ - "instanceNames", - "availabilityZone", - "blueprintId", - "bundleId" - ], - "members":{ - "instanceNames":{ - "shape":"StringList", - "documentation":"

The names to use for your new Lightsail instances. Separate multiple values using quotation marks and commas, for example: [\"MyFirstInstance\",\"MySecondInstance\"]

" - }, - "availabilityZone":{ - "shape":"string", - "documentation":"

The Availability Zone in which to create your instance. Use the following format: us-east-2a (case sensitive). You can get a list of availability zones by using the get regions operation. Be sure to add the include availability zones parameter to your request.

" - }, - "customImageName":{ - "shape":"ResourceName", - "documentation":"

(Deprecated) The name for your custom image.

In releases prior to June 12, 2017, this parameter was ignored by the API. It is now deprecated.

", - "deprecated":true - }, - "blueprintId":{ - "shape":"NonEmptyString", - "documentation":"

The ID for a virtual private server image (e.g., app_wordpress_4_4 or app_lamp_7_0). Use the get blueprints operation to return a list of available images (or blueprints).

" - }, - "bundleId":{ - "shape":"NonEmptyString", - "documentation":"

The bundle of specification information for your virtual private server (or instance), including the pricing plan (e.g., micro_1_0).

" - }, - "userData":{ - "shape":"string", - "documentation":"

A launch script you can create that configures a server with additional user data. For example, you might want to run apt-get -y update.

Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, and FreeBSD uses pkg. For a complete list, see the Dev Guide.

" - }, - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name of your key pair.

" - } - } - }, - "CreateInstancesResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your create instances request.

" - } - } - }, - "CreateKeyPairRequest":{ - "type":"structure", - "required":["keyPairName"], - "members":{ - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name for your new key pair.

" - } - } - }, - "CreateKeyPairResult":{ - "type":"structure", - "members":{ - "keyPair":{ - "shape":"KeyPair", - "documentation":"

An array of key-value pairs containing information about the new key pair you just created.

" - }, - "publicKeyBase64":{ - "shape":"Base64", - "documentation":"

A base64-encoded public key of the ssh-rsa type.

" - }, - "privateKeyBase64":{ - "shape":"Base64", - "documentation":"

A base64-encoded RSA private key.

" - }, - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the results of your create key pair request.

" - } - } - }, - "CreateLoadBalancerRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "instancePort" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of your load balancer.

" - }, - "instancePort":{ - "shape":"Port", - "documentation":"

The instance port where you're creating your load balancer.

" - }, - "healthCheckPath":{ - "shape":"string", - "documentation":"

The path you provided to perform the load balancer health check. If you didn't specify a health check path, Lightsail uses the root path of your website (e.g., \"/\").

You may want to specify a custom health check path other than the root of your application if your home page loads slowly or has a lot of media or scripting on it.

" - }, - "certificateName":{ - "shape":"ResourceName", - "documentation":"

The name of the SSL/TLS certificate.

If you specify certificateName, then certificateDomainName is required (and vice-versa).

" - }, - "certificateDomainName":{ - "shape":"DomainName", - "documentation":"

The domain name with which your certificate is associated (e.g., example.com).

If you specify certificateDomainName, then certificateName is required (and vice-versa).

" - }, - "certificateAlternativeNames":{ - "shape":"DomainNameList", - "documentation":"

The optional alternative domains and subdomains to use with your SSL/TLS certificate (e.g., www.example.com, example.com, m.example.com, blog.example.com).

" - } - } - }, - "CreateLoadBalancerResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object containing information about the API operations.

" - } - } - }, - "CreateLoadBalancerTlsCertificateRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "certificateName", - "certificateDomainName" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The load balancer name where you want to create the SSL/TLS certificate.

" - }, - "certificateName":{ - "shape":"ResourceName", - "documentation":"

The SSL/TLS certificate name.

You can have up to 10 certificates in your account at one time. Each Lightsail load balancer can have up to 2 certificates associated with it at one time. There is also an overall limit to the number of certificates that can be issue in a 365-day period. For more information, see Limits.

" - }, - "certificateDomainName":{ - "shape":"DomainName", - "documentation":"

The domain name (e.g., example.com) for your SSL/TLS certificate.

" - }, - "certificateAlternativeNames":{ - "shape":"DomainNameList", - "documentation":"

An array of strings listing alternative domains and subdomains for your SSL/TLS certificate. Lightsail will de-dupe the names for you. You can have a maximum of 9 alternative names (in addition to the 1 primary domain). We do not support wildcards (e.g., *.example.com).

" - } - } - }, - "CreateLoadBalancerTlsCertificateResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object containing information about the API operations.

" - } - } - }, - "DeleteDiskRequest":{ - "type":"structure", - "required":["diskName"], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique name of the disk you want to delete (e.g., my-disk).

" - } - } - }, - "DeleteDiskResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DeleteDiskSnapshotRequest":{ - "type":"structure", - "required":["diskSnapshotName"], - "members":{ - "diskSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the disk snapshot you want to delete (e.g., my-disk-snapshot).

" - } - } - }, - "DeleteDiskSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DeleteDomainEntryRequest":{ - "type":"structure", - "required":[ - "domainName", - "domainEntry" - ], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain entry to delete.

" - }, - "domainEntry":{ - "shape":"DomainEntry", - "documentation":"

An array of key-value pairs containing information about your domain entries.

" - } - } - }, - "DeleteDomainEntryResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the results of your delete domain entry request.

" - } - } - }, - "DeleteDomainRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The specific domain name to delete.

" - } - } - }, - "DeleteDomainResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the results of your delete domain request.

" - } - } - }, - "DeleteInstanceRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance to delete.

" - } - } - }, - "DeleteInstanceResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your delete instance request.

" - } - } - }, - "DeleteInstanceSnapshotRequest":{ - "type":"structure", - "required":["instanceSnapshotName"], - "members":{ - "instanceSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the snapshot to delete.

" - } - } - }, - "DeleteInstanceSnapshotResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your delete instance snapshot request.

" - } - } - }, - "DeleteKeyPairRequest":{ - "type":"structure", - "required":["keyPairName"], - "members":{ - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name of the key pair to delete.

" - } - } - }, - "DeleteKeyPairResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the results of your delete key pair request.

" - } - } - }, - "DeleteLoadBalancerRequest":{ - "type":"structure", - "required":["loadBalancerName"], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer you want to delete.

" - } - } - }, - "DeleteLoadBalancerResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DeleteLoadBalancerTlsCertificateRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "certificateName" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The load balancer name.

" - }, - "certificateName":{ - "shape":"ResourceName", - "documentation":"

The SSL/TLS certificate name.

" - }, - "force":{ - "shape":"boolean", - "documentation":"

When true, forces the deletion of an SSL/TLS certificate.

There can be two certificates associated with a Lightsail load balancer: the primary and the backup. The force parameter is required when the primary SSL/TLS certificate is in use by an instance attached to the load balancer.

" - } - } - }, - "DeleteLoadBalancerTlsCertificateResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DetachDiskRequest":{ - "type":"structure", - "required":["diskName"], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The unique name of the disk you want to detach from your instance (e.g., my-disk).

" - } - } - }, - "DetachDiskResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DetachInstancesFromLoadBalancerRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "instanceNames" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the Lightsail load balancer.

" - }, - "instanceNames":{ - "shape":"ResourceNameList", - "documentation":"

An array of strings containing the names of the instances you want to detach from the load balancer.

" - } - } - }, - "DetachInstancesFromLoadBalancerResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "DetachStaticIpRequest":{ - "type":"structure", - "required":["staticIpName"], - "members":{ - "staticIpName":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP to detach from the instance.

" - } - } - }, - "DetachStaticIpResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your detach static IP request.

" - } - } - }, - "Disk":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The unique name of the disk.

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the disk.

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The date when the disk was created.

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The AWS Region and Availability Zone where the disk is located.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The Lightsail resource type (e.g., Disk).

" - }, - "sizeInGb":{ - "shape":"integer", - "documentation":"

The size of the disk in GB.

" - }, - "isSystemDisk":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether this disk is a system disk (has an operating system loaded on it).

" - }, - "iops":{ - "shape":"integer", - "documentation":"

The input/output operations per second (IOPS) of the disk.

" - }, - "path":{ - "shape":"string", - "documentation":"

The disk path.

" - }, - "state":{ - "shape":"DiskState", - "documentation":"

Describes the status of the disk.

" - }, - "attachedTo":{ - "shape":"ResourceName", - "documentation":"

The resources to which the disk is attached.

" - }, - "isAttached":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether the disk is attached.

" - }, - "attachmentState":{ - "shape":"string", - "documentation":"

(Deprecated) The attachment state of the disk.

In releases prior to November 14, 2017, this parameter returned attached for system disks in the API response. It is now deprecated, but still included in the response. Use isAttached instead.

", - "deprecated":true - }, - "gbInUse":{ - "shape":"integer", - "documentation":"

(Deprecated) The number of GB in use by the disk.

In releases prior to November 14, 2017, this parameter was not included in the API response. It is now deprecated.

", - "deprecated":true - } - }, - "documentation":"

Describes a system disk or an block storage disk.

" - }, - "DiskList":{ - "type":"list", - "member":{"shape":"Disk"} - }, - "DiskMap":{ - "type":"structure", - "members":{ - "originalDiskPath":{ - "shape":"NonEmptyString", - "documentation":"

The original disk path exposed to the instance (for example, /dev/sdh).

" - }, - "newDiskName":{ - "shape":"ResourceName", - "documentation":"

The new disk name (e.g., my-new-disk).

" - } - }, - "documentation":"

Describes a block storage disk mapping.

" - }, - "DiskMapList":{ - "type":"list", - "member":{"shape":"DiskMap"} - }, - "DiskSnapshot":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the disk snapshot (e.g., my-disk-snapshot).

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the disk snapshot.

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The date when the disk snapshot was created.

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The AWS Region and Availability Zone where the disk snapshot was created.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The Lightsail resource type (e.g., DiskSnapshot).

" - }, - "sizeInGb":{ - "shape":"integer", - "documentation":"

The size of the disk in GB.

" - }, - "state":{ - "shape":"DiskSnapshotState", - "documentation":"

The status of the disk snapshot operation.

" - }, - "progress":{ - "shape":"string", - "documentation":"

The progress of the disk snapshot operation.

" - }, - "fromDiskName":{ - "shape":"ResourceName", - "documentation":"

The unique name of the source disk from which you are creating the disk snapshot.

" - }, - "fromDiskArn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the source disk from which you are creating the disk snapshot.

" - } - }, - "documentation":"

Describes a block storage disk snapshot.

" - }, - "DiskSnapshotList":{ - "type":"list", - "member":{"shape":"DiskSnapshot"} - }, - "DiskSnapshotState":{ - "type":"string", - "enum":[ - "pending", - "completed", - "error", - "unknown" - ] - }, - "DiskState":{ - "type":"string", - "enum":[ - "pending", - "error", - "available", - "in-use", - "unknown" - ] - }, - "Domain":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the domain.

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the domain recordset (e.g., arn:aws:lightsail:global:123456789101:Domain/824cede0-abc7-4f84-8dbc-12345EXAMPLE).

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The date when the domain recordset was created.

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The AWS Region and Availability Zones where the domain recordset was created.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

" - }, - "domainEntries":{ - "shape":"DomainEntryList", - "documentation":"

An array of key-value pairs containing information about the domain entries.

" - } - }, - "documentation":"

Describes a domain where you are storing recordsets in Lightsail.

" - }, - "DomainEntry":{ - "type":"structure", - "members":{ - "id":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the domain recordset entry.

" - }, - "name":{ - "shape":"DomainName", - "documentation":"

The name of the domain.

" - }, - "target":{ - "shape":"string", - "documentation":"

The target AWS name server (e.g., ns-111.awsdns-22.com.).

For Lightsail load balancers, the value looks like ab1234c56789c6b86aba6fb203d443bc-123456789.us-east-2.elb.amazonaws.com. Be sure to also set isAlias to true when setting up an A record for a load balancer.

" - }, - "isAlias":{ - "shape":"boolean", - "documentation":"

When true, specifies whether the domain entry is an alias used by the Lightsail load balancer. You can include an alias (A type) record in your request, which points to a load balancer DNS name and routes traffic to your load balancer

" - }, - "type":{ - "shape":"DomainEntryType", - "documentation":"

The type of domain entry (e.g., SOA or NS).

" - }, - "options":{ - "shape":"DomainEntryOptions", - "documentation":"

(Deprecated) The options for the domain entry.

In releases prior to November 29, 2017, this parameter was not included in the API response. It is now deprecated.

", - "deprecated":true - } - }, - "documentation":"

Describes a domain recordset entry.

" - }, - "DomainEntryList":{ - "type":"list", - "member":{"shape":"DomainEntry"} - }, - "DomainEntryOptions":{ - "type":"map", - "key":{"shape":"DomainEntryOptionsKeys"}, - "value":{"shape":"string"} - }, - "DomainEntryOptionsKeys":{"type":"string"}, - "DomainEntryType":{"type":"string"}, - "DomainList":{ - "type":"list", - "member":{"shape":"Domain"} - }, - "DomainName":{"type":"string"}, - "DomainNameList":{ - "type":"list", - "member":{"shape":"DomainName"} - }, - "DownloadDefaultKeyPairRequest":{ - "type":"structure", - "members":{ - } - }, - "DownloadDefaultKeyPairResult":{ - "type":"structure", - "members":{ - "publicKeyBase64":{ - "shape":"Base64", - "documentation":"

A base64-encoded public key of the ssh-rsa type.

" - }, - "privateKeyBase64":{ - "shape":"Base64", - "documentation":"

A base64-encoded RSA private key.

" - } - } - }, - "GetActiveNamesRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for paginating results from your get active names request.

" - } - } - }, - "GetActiveNamesResult":{ - "type":"structure", - "members":{ - "activeNames":{ - "shape":"StringList", - "documentation":"

The list of active names returned by the get active names request.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get active names request.

" - } - } - }, - "GetBlueprintsRequest":{ - "type":"structure", - "members":{ - "includeInactive":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether to include inactive results in your request.

" - }, - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get blueprints request.

" - } - } - }, - "GetBlueprintsResult":{ - "type":"structure", - "members":{ - "blueprints":{ - "shape":"BlueprintList", - "documentation":"

An array of key-value pairs that contains information about the available blueprints.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get blueprints request.

" - } - } - }, - "GetBundlesRequest":{ - "type":"structure", - "members":{ - "includeInactive":{ - "shape":"boolean", - "documentation":"

A Boolean value that indicates whether to include inactive bundle results in your request.

" - }, - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get bundles request.

" - } - } - }, - "GetBundlesResult":{ - "type":"structure", - "members":{ - "bundles":{ - "shape":"BundleList", - "documentation":"

An array of key-value pairs that contains information about the available bundles.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get active names request.

" - } - } - }, - "GetDiskRequest":{ - "type":"structure", - "required":["diskName"], - "members":{ - "diskName":{ - "shape":"ResourceName", - "documentation":"

The name of the disk (e.g., my-disk).

" - } - } - }, - "GetDiskResult":{ - "type":"structure", - "members":{ - "disk":{ - "shape":"Disk", - "documentation":"

An object containing information about the disk.

" - } - } - }, - "GetDiskSnapshotRequest":{ - "type":"structure", - "required":["diskSnapshotName"], - "members":{ - "diskSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the disk snapshot (e.g., my-disk-snapshot).

" - } - } - }, - "GetDiskSnapshotResult":{ - "type":"structure", - "members":{ - "diskSnapshot":{ - "shape":"DiskSnapshot", - "documentation":"

An object containing information about the disk snapshot.

" - } - } - }, - "GetDiskSnapshotsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your GetDiskSnapshots request.

" - } - } - }, - "GetDiskSnapshotsResult":{ - "type":"structure", - "members":{ - "diskSnapshots":{ - "shape":"DiskSnapshotList", - "documentation":"

An array of objects containing information about all block storage disk snapshots.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your GetDiskSnapshots request.

" - } - } - }, - "GetDisksRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your GetDisks request.

" - } - } - }, - "GetDisksResult":{ - "type":"structure", - "members":{ - "disks":{ - "shape":"DiskList", - "documentation":"

An array of objects containing information about all block storage disks.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your GetDisks request.

" - } - } - }, - "GetDomainRequest":{ - "type":"structure", - "required":["domainName"], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name for which your want to return information about.

" - } - } - }, - "GetDomainResult":{ - "type":"structure", - "members":{ - "domain":{ - "shape":"Domain", - "documentation":"

An array of key-value pairs containing information about your get domain request.

" - } - } - }, - "GetDomainsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get domains request.

" - } - } - }, - "GetDomainsResult":{ - "type":"structure", - "members":{ - "domains":{ - "shape":"DomainList", - "documentation":"

An array of key-value pairs containing information about each of the domain entries in the user's account.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get active names request.

" - } - } - }, - "GetInstanceAccessDetailsRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance to access.

" - }, - "protocol":{ - "shape":"InstanceAccessProtocol", - "documentation":"

The protocol to use to connect to your instance. Defaults to ssh.

" - } - } - }, - "GetInstanceAccessDetailsResult":{ - "type":"structure", - "members":{ - "accessDetails":{ - "shape":"InstanceAccessDetails", - "documentation":"

An array of key-value pairs containing information about a get instance access request.

" - } - } - }, - "GetInstanceMetricDataRequest":{ - "type":"structure", - "required":[ - "instanceName", - "metricName", - "period", - "startTime", - "endTime", - "unit", - "statistics" - ], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance for which you want to get metrics data.

" - }, - "metricName":{ - "shape":"InstanceMetricName", - "documentation":"

The metric name to get data about.

" - }, - "period":{ - "shape":"MetricPeriod", - "documentation":"

The time period for which you are requesting data.

" - }, - "startTime":{ - "shape":"timestamp", - "documentation":"

The start time of the time period.

" - }, - "endTime":{ - "shape":"timestamp", - "documentation":"

The end time of the time period.

" - }, - "unit":{ - "shape":"MetricUnit", - "documentation":"

The unit. The list of valid values is below.

" - }, - "statistics":{ - "shape":"MetricStatisticList", - "documentation":"

The instance statistics.

" - } - } - }, - "GetInstanceMetricDataResult":{ - "type":"structure", - "members":{ - "metricName":{ - "shape":"InstanceMetricName", - "documentation":"

The metric name to return data for.

" - }, - "metricData":{ - "shape":"MetricDatapointList", - "documentation":"

An array of key-value pairs containing information about the results of your get instance metric data request.

" - } - } - }, - "GetInstancePortStatesRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance.

" - } - } - }, - "GetInstancePortStatesResult":{ - "type":"structure", - "members":{ - "portStates":{ - "shape":"InstancePortStateList", - "documentation":"

Information about the port states resulting from your request.

" - } - } - }, - "GetInstanceRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance.

" - } - } - }, - "GetInstanceResult":{ - "type":"structure", - "members":{ - "instance":{ - "shape":"Instance", - "documentation":"

An array of key-value pairs containing information about the specified instance.

" - } - } - }, - "GetInstanceSnapshotRequest":{ - "type":"structure", - "required":["instanceSnapshotName"], - "members":{ - "instanceSnapshotName":{ - "shape":"ResourceName", - "documentation":"

The name of the snapshot for which you are requesting information.

" - } - } - }, - "GetInstanceSnapshotResult":{ - "type":"structure", - "members":{ - "instanceSnapshot":{ - "shape":"InstanceSnapshot", - "documentation":"

An array of key-value pairs containing information about the results of your get instance snapshot request.

" - } - } - }, - "GetInstanceSnapshotsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get instance snapshots request.

" - } - } - }, - "GetInstanceSnapshotsResult":{ - "type":"structure", - "members":{ - "instanceSnapshots":{ - "shape":"InstanceSnapshotList", - "documentation":"

An array of key-value pairs containing information about the results of your get instance snapshots request.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get instance snapshots request.

" - } - } - }, - "GetInstanceStateRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance to get state information about.

" - } - } - }, - "GetInstanceStateResult":{ - "type":"structure", - "members":{ - "state":{ - "shape":"InstanceState", - "documentation":"

The state of the instance.

" - } - } - }, - "GetInstancesRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get instances request.

" - } - } - }, - "GetInstancesResult":{ - "type":"structure", - "members":{ - "instances":{ - "shape":"InstanceList", - "documentation":"

An array of key-value pairs containing information about your instances.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get instances request.

" - } - } - }, - "GetKeyPairRequest":{ - "type":"structure", - "required":["keyPairName"], - "members":{ - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name of the key pair for which you are requesting information.

" - } - } - }, - "GetKeyPairResult":{ - "type":"structure", - "members":{ - "keyPair":{ - "shape":"KeyPair", - "documentation":"

An array of key-value pairs containing information about the key pair.

" - } - } - }, - "GetKeyPairsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get key pairs request.

" - } - } - }, - "GetKeyPairsResult":{ - "type":"structure", - "members":{ - "keyPairs":{ - "shape":"KeyPairList", - "documentation":"

An array of key-value pairs containing information about the key pairs.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get key pairs request.

" - } - } - }, - "GetLoadBalancerMetricDataRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "metricName", - "period", - "startTime", - "endTime", - "unit", - "statistics" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer.

" - }, - "metricName":{ - "shape":"LoadBalancerMetricName", - "documentation":"

The metric about which you want to return information. Valid values are listed below, along with the most useful statistics to include in your request.

  • ClientTLSNegotiationErrorCount - The number of TLS connections initiated by the client that did not establish a session with the load balancer. Possible causes include a mismatch of ciphers or protocols.

    Statistics: The most useful statistic is Sum.

  • HealthyHostCount - The number of target instances that are considered healthy.

    Statistics: The most useful statistic are Average, Minimum, and Maximum.

  • UnhealthyHostCount - The number of target instances that are considered unhealthy.

    Statistics: The most useful statistic are Average, Minimum, and Maximum.

  • HTTPCode_LB_4XX_Count - The number of HTTP 4XX client error codes that originate from the load balancer. Client errors are generated when requests are malformed or incomplete. These requests have not been received by the target instance. This count does not include any response codes generated by the target instances.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_LB_5XX_Count - The number of HTTP 5XX server error codes that originate from the load balancer. This count does not include any response codes generated by the target instances.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_2XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_3XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_4XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_5XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • InstanceResponseTime - The time elapsed, in seconds, after the request leaves the load balancer until a response from the target instance is received.

    Statistics: The most useful statistic is Average.

  • RejectedConnectionCount - The number of connections that were rejected because the load balancer had reached its maximum number of connections.

    Statistics: The most useful statistic is Sum.

  • RequestCount - The number of requests processed over IPv4. This count includes only the requests with a response generated by a target instance of the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

" - }, - "period":{ - "shape":"MetricPeriod", - "documentation":"

The time period duration for your health data request.

" - }, - "startTime":{ - "shape":"timestamp", - "documentation":"

The start time of the period.

" - }, - "endTime":{ - "shape":"timestamp", - "documentation":"

The end time of the period.

" - }, - "unit":{ - "shape":"MetricUnit", - "documentation":"

The unit for the time period request. Valid values are listed below.

" - }, - "statistics":{ - "shape":"MetricStatisticList", - "documentation":"

An array of statistics that you want to request metrics for. Valid values are listed below.

  • SampleCount - The count (number) of data points used for the statistical calculation.

  • Average - The value of Sum / SampleCount during the specified period. By comparing this statistic with the Minimum and Maximum, you can determine the full scope of a metric and how close the average use is to the Minimum and Maximum. This comparison helps you to know when to increase or decrease your resources as needed.

  • Sum - All values submitted for the matching metric added together. This statistic can be useful for determining the total volume of a metric.

  • Minimum - The lowest value observed during the specified period. You can use this value to determine low volumes of activity for your application.

  • Maximum - The highest value observed during the specified period. You can use this value to determine high volumes of activity for your application.

" - } - } - }, - "GetLoadBalancerMetricDataResult":{ - "type":"structure", - "members":{ - "metricName":{ - "shape":"LoadBalancerMetricName", - "documentation":"

The metric about which you are receiving information. Valid values are listed below, along with the most useful statistics to include in your request.

  • ClientTLSNegotiationErrorCount - The number of TLS connections initiated by the client that did not establish a session with the load balancer. Possible causes include a mismatch of ciphers or protocols.

    Statistics: The most useful statistic is Sum.

  • HealthyHostCount - The number of target instances that are considered healthy.

    Statistics: The most useful statistic are Average, Minimum, and Maximum.

  • UnhealthyHostCount - The number of target instances that are considered unhealthy.

    Statistics: The most useful statistic are Average, Minimum, and Maximum.

  • HTTPCode_LB_4XX_Count - The number of HTTP 4XX client error codes that originate from the load balancer. Client errors are generated when requests are malformed or incomplete. These requests have not been received by the target instance. This count does not include any response codes generated by the target instances.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_LB_5XX_Count - The number of HTTP 5XX server error codes that originate from the load balancer. This count does not include any response codes generated by the target instances.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_2XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_3XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_4XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • HTTPCode_Instance_5XX_Count - The number of HTTP response codes generated by the target instances. This does not include any response codes generated by the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

  • InstanceResponseTime - The time elapsed, in seconds, after the request leaves the load balancer until a response from the target instance is received.

    Statistics: The most useful statistic is Average.

  • RejectedConnectionCount - The number of connections that were rejected because the load balancer had reached its maximum number of connections.

    Statistics: The most useful statistic is Sum.

  • RequestCount - The number of requests processed over IPv4. This count includes only the requests with a response generated by a target instance of the load balancer.

    Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average all return 1.

" - }, - "metricData":{ - "shape":"MetricDatapointList", - "documentation":"

An array of metric datapoint objects.

" - } - } - }, - "GetLoadBalancerRequest":{ - "type":"structure", - "required":["loadBalancerName"], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer.

" - } - } - }, - "GetLoadBalancerResult":{ - "type":"structure", - "members":{ - "loadBalancer":{ - "shape":"LoadBalancer", - "documentation":"

An object containing information about your load balancer.

" - } - } - }, - "GetLoadBalancerTlsCertificatesRequest":{ - "type":"structure", - "required":["loadBalancerName"], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer you associated with your SSL/TLS certificate.

" - } - } - }, - "GetLoadBalancerTlsCertificatesResult":{ - "type":"structure", - "members":{ - "tlsCertificates":{ - "shape":"LoadBalancerTlsCertificateList", - "documentation":"

An array of LoadBalancerTlsCertificate objects describing your SSL/TLS certificates.

" - } - } - }, - "GetLoadBalancersRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for paginating the results from your GetLoadBalancers request.

" - } - } - }, - "GetLoadBalancersResult":{ - "type":"structure", - "members":{ - "loadBalancers":{ - "shape":"LoadBalancerList", - "documentation":"

An array of LoadBalancer objects describing your load balancers.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your GetLoadBalancers request.

" - } - } - }, - "GetOperationRequest":{ - "type":"structure", - "required":["operationId"], - "members":{ - "operationId":{ - "shape":"NonEmptyString", - "documentation":"

A GUID used to identify the operation.

" - } - } - }, - "GetOperationResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the results of your get operation request.

" - } - } - }, - "GetOperationsForResourceRequest":{ - "type":"structure", - "required":["resourceName"], - "members":{ - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The name of the resource for which you are requesting information.

" - }, - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get operations for resource request.

" - } - } - }, - "GetOperationsForResourceResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your get operations for resource request.

" - }, - "nextPageCount":{ - "shape":"string", - "documentation":"

(Deprecated) Returns the number of pages of results that remain.

In releases prior to June 12, 2017, this parameter returned null by the API. It is now deprecated, and the API returns the nextPageToken parameter instead.

", - "deprecated":true - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

" - } - } - }, - "GetOperationsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get operations request.

" - } - } - }, - "GetOperationsResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the results of your get operations request.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get operations request.

" - } - } - }, - "GetRegionsRequest":{ - "type":"structure", - "members":{ - "includeAvailabilityZones":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether to also include Availability Zones in your get regions request. Availability Zones are indicated with a letter: e.g., us-east-2a.

" - } - } - }, - "GetRegionsResult":{ - "type":"structure", - "members":{ - "regions":{ - "shape":"RegionList", - "documentation":"

An array of key-value pairs containing information about your get regions request.

" - } - } - }, - "GetStaticIpRequest":{ - "type":"structure", - "required":["staticIpName"], - "members":{ - "staticIpName":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP in Lightsail.

" - } - } - }, - "GetStaticIpResult":{ - "type":"structure", - "members":{ - "staticIp":{ - "shape":"StaticIp", - "documentation":"

An array of key-value pairs containing information about the requested static IP.

" - } - } - }, - "GetStaticIpsRequest":{ - "type":"structure", - "members":{ - "pageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get static IPs request.

" - } - } - }, - "GetStaticIpsResult":{ - "type":"structure", - "members":{ - "staticIps":{ - "shape":"StaticIpList", - "documentation":"

An array of key-value pairs containing information about your get static IPs request.

" - }, - "nextPageToken":{ - "shape":"string", - "documentation":"

A token used for advancing to the next page of results from your get static IPs request.

" - } - } - }, - "ImportKeyPairRequest":{ - "type":"structure", - "required":[ - "keyPairName", - "publicKeyBase64" - ], - "members":{ - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name of the key pair for which you want to import the public key.

" - }, - "publicKeyBase64":{ - "shape":"Base64", - "documentation":"

A base64-encoded public key of the ssh-rsa type.

" - } - } - }, - "ImportKeyPairResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "Instance":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name the user gave the instance (e.g., Amazon_Linux-1GB-Ohio-1).

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the instance (e.g., arn:aws:lightsail:us-east-2:123456789101:Instance/244ad76f-8aad-4741-809f-12345EXAMPLE).

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the instance was created (e.g., 1479734909.17).

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The region name and availability zone where the instance is located.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource (usually Instance).

" - }, - "blueprintId":{ - "shape":"NonEmptyString", - "documentation":"

The blueprint ID (e.g., os_amlinux_2016_03).

" - }, - "blueprintName":{ - "shape":"NonEmptyString", - "documentation":"

The friendly name of the blueprint (e.g., Amazon Linux).

" - }, - "bundleId":{ - "shape":"NonEmptyString", - "documentation":"

The bundle for the instance (e.g., micro_1_0).

" - }, - "isStaticIp":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether this instance has a static IP assigned to it.

" - }, - "privateIpAddress":{ - "shape":"IpAddress", - "documentation":"

The private IP address of the instance.

" - }, - "publicIpAddress":{ - "shape":"IpAddress", - "documentation":"

The public IP address of the instance.

" - }, - "ipv6Address":{ - "shape":"IpV6Address", - "documentation":"

The IPv6 address of the instance.

" - }, - "hardware":{ - "shape":"InstanceHardware", - "documentation":"

The size of the vCPU and the amount of RAM for the instance.

" - }, - "networking":{ - "shape":"InstanceNetworking", - "documentation":"

Information about the public ports and monthly data transfer rates for the instance.

" - }, - "state":{ - "shape":"InstanceState", - "documentation":"

The status code and the state (e.g., running) for the instance.

" - }, - "username":{ - "shape":"NonEmptyString", - "documentation":"

The user name for connecting to the instance (e.g., ec2-user).

" - }, - "sshKeyName":{ - "shape":"ResourceName", - "documentation":"

The name of the SSH key being used to connect to the instance (e.g., LightsailDefaultKeyPair).

" - } - }, - "documentation":"

Describes an instance (a virtual private server).

" - }, - "InstanceAccessDetails":{ - "type":"structure", - "members":{ - "certKey":{ - "shape":"string", - "documentation":"

For SSH access, the public key to use when accessing your instance For OpenSSH clients (e.g., command line SSH), you should save this value to tempkey-cert.pub.

" - }, - "expiresAt":{ - "shape":"IsoDate", - "documentation":"

For SSH access, the date on which the temporary keys expire.

" - }, - "ipAddress":{ - "shape":"IpAddress", - "documentation":"

The public IP address of the Amazon Lightsail instance.

" - }, - "password":{ - "shape":"string", - "documentation":"

For RDP access, the password for your Amazon Lightsail instance. Password will be an empty string if the password for your new instance is not ready yet. When you create an instance, it can take up to 15 minutes for the instance to be ready.

If you create an instance using any key pair other than the default (LightsailDefaultKeyPair), password will always be an empty string.

If you change the Administrator password on the instance, Lightsail will continue to return the original password value. When accessing the instance using RDP, you need to manually enter the Administrator password after changing it from the default.

" - }, - "passwordData":{ - "shape":"PasswordData", - "documentation":"

For a Windows Server-based instance, an object with the data you can use to retrieve your password. This is only needed if password is empty and the instance is not new (and therefore the password is not ready yet). When you create an instance, it can take up to 15 minutes for the instance to be ready.

" - }, - "privateKey":{ - "shape":"string", - "documentation":"

For SSH access, the temporary private key. For OpenSSH clients (e.g., command line SSH), you should save this value to tempkey).

" - }, - "protocol":{ - "shape":"InstanceAccessProtocol", - "documentation":"

The protocol for these Amazon Lightsail instance access details.

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of this Amazon Lightsail instance.

" - }, - "username":{ - "shape":"string", - "documentation":"

The user name to use when logging in to the Amazon Lightsail instance.

" - } - }, - "documentation":"

The parameters for gaining temporary access to one of your Amazon Lightsail instances.

" - }, - "InstanceAccessProtocol":{ - "type":"string", - "enum":[ - "ssh", - "rdp" - ] - }, - "InstanceHardware":{ - "type":"structure", - "members":{ - "cpuCount":{ - "shape":"integer", - "documentation":"

The number of vCPUs the instance has.

" - }, - "disks":{ - "shape":"DiskList", - "documentation":"

The disks attached to the instance.

" - }, - "ramSizeInGb":{ - "shape":"float", - "documentation":"

The amount of RAM in GB on the instance (e.g., 1.0).

" - } - }, - "documentation":"

Describes the hardware for the instance.

" - }, - "InstanceHealthReason":{ - "type":"string", - "enum":[ - "Lb.RegistrationInProgress", - "Lb.InitialHealthChecking", - "Lb.InternalError", - "Instance.ResponseCodeMismatch", - "Instance.Timeout", - "Instance.FailedHealthChecks", - "Instance.NotRegistered", - "Instance.NotInUse", - "Instance.DeregistrationInProgress", - "Instance.InvalidState", - "Instance.IpUnusable" - ] - }, - "InstanceHealthState":{ - "type":"string", - "enum":[ - "initial", - "healthy", - "unhealthy", - "unused", - "draining", - "unavailable" - ] - }, - "InstanceHealthSummary":{ - "type":"structure", - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the Lightsail instance for which you are requesting health check data.

" - }, - "instanceHealth":{ - "shape":"InstanceHealthState", - "documentation":"

Describes the overall instance health. Valid values are below.

" - }, - "instanceHealthReason":{ - "shape":"InstanceHealthReason", - "documentation":"

More information about the instance health. If the instanceHealth is healthy, then an instanceHealthReason value is not provided.

If instanceHealth is initial, the instanceHealthReason value can be one of the following:

  • Lb.RegistrationInProgress - The target instance is in the process of being registered with the load balancer.

  • Lb.InitialHealthChecking - The Lightsail load balancer is still sending the target instance the minimum number of health checks required to determine its health status.

If instanceHealth is unhealthy, the instanceHealthReason value can be one of the following:

  • Instance.ResponseCodeMismatch - The health checks did not return an expected HTTP code.

  • Instance.Timeout - The health check requests timed out.

  • Instance.FailedHealthChecks - The health checks failed because the connection to the target instance timed out, the target instance response was malformed, or the target instance failed the health check for an unknown reason.

  • Lb.InternalError - The health checks failed due to an internal error.

If instanceHealth is unused, the instanceHealthReason value can be one of the following:

  • Instance.NotRegistered - The target instance is not registered with the target group.

  • Instance.NotInUse - The target group is not used by any load balancer, or the target instance is in an Availability Zone that is not enabled for its load balancer.

  • Instance.IpUnusable - The target IP address is reserved for use by a Lightsail load balancer.

  • Instance.InvalidState - The target is in the stopped or terminated state.

If instanceHealth is draining, the instanceHealthReason value can be one of the following:

  • Instance.DeregistrationInProgress - The target instance is in the process of being deregistered and the deregistration delay period has not expired.

" - } - }, - "documentation":"

Describes information about the health of the instance.

" - }, - "InstanceHealthSummaryList":{ - "type":"list", - "member":{"shape":"InstanceHealthSummary"} - }, - "InstanceList":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InstanceMetricName":{ - "type":"string", - "enum":[ - "CPUUtilization", - "NetworkIn", - "NetworkOut", - "StatusCheckFailed", - "StatusCheckFailed_Instance", - "StatusCheckFailed_System" - ] - }, - "InstanceNetworking":{ - "type":"structure", - "members":{ - "monthlyTransfer":{ - "shape":"MonthlyTransfer", - "documentation":"

The amount of data in GB allocated for monthly data transfers.

" - }, - "ports":{ - "shape":"InstancePortInfoList", - "documentation":"

An array of key-value pairs containing information about the ports on the instance.

" - } - }, - "documentation":"

Describes monthly data transfer rates and port information for an instance.

" - }, - "InstancePlatform":{ - "type":"string", - "enum":[ - "LINUX_UNIX", - "WINDOWS" - ] - }, - "InstancePlatformList":{ - "type":"list", - "member":{"shape":"InstancePlatform"} - }, - "InstancePortInfo":{ - "type":"structure", - "members":{ - "fromPort":{ - "shape":"Port", - "documentation":"

The first port in the range.

" - }, - "toPort":{ - "shape":"Port", - "documentation":"

The last port in the range.

" - }, - "protocol":{ - "shape":"NetworkProtocol", - "documentation":"

The protocol being used. Can be one of the following.

  • tcp - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.

  • all - All transport layer protocol types. For more general information, see Transport layer on Wikipedia.

  • udp - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.

" - }, - "accessFrom":{ - "shape":"string", - "documentation":"

The location from which access is allowed (e.g., Anywhere (0.0.0.0/0)).

" - }, - "accessType":{ - "shape":"PortAccessType", - "documentation":"

The type of access (Public or Private).

" - }, - "commonName":{ - "shape":"string", - "documentation":"

The common name.

" - }, - "accessDirection":{ - "shape":"AccessDirection", - "documentation":"

The access direction (inbound or outbound).

" - } - }, - "documentation":"

Describes information about the instance ports.

" - }, - "InstancePortInfoList":{ - "type":"list", - "member":{"shape":"InstancePortInfo"} - }, - "InstancePortState":{ - "type":"structure", - "members":{ - "fromPort":{ - "shape":"Port", - "documentation":"

The first port in the range.

" - }, - "toPort":{ - "shape":"Port", - "documentation":"

The last port in the range.

" - }, - "protocol":{ - "shape":"NetworkProtocol", - "documentation":"

The protocol being used. Can be one of the following.

  • tcp - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.

  • all - All transport layer protocol types. For more general information, see Transport layer on Wikipedia.

  • udp - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.

" - }, - "state":{ - "shape":"PortState", - "documentation":"

Specifies whether the instance port is open or closed.

" - } - }, - "documentation":"

Describes the port state.

" - }, - "InstancePortStateList":{ - "type":"list", - "member":{"shape":"InstancePortState"} - }, - "InstanceSnapshot":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the snapshot.

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the snapshot (e.g., arn:aws:lightsail:us-east-2:123456789101:InstanceSnapshot/d23b5706-3322-4d83-81e5-12345EXAMPLE).

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the snapshot was created (e.g., 1479907467.024).

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The region name and availability zone where you created the snapshot.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The type of resource (usually InstanceSnapshot).

" - }, - "state":{ - "shape":"InstanceSnapshotState", - "documentation":"

The state the snapshot is in.

" - }, - "progress":{ - "shape":"string", - "documentation":"

The progress of the snapshot.

" - }, - "fromAttachedDisks":{ - "shape":"DiskList", - "documentation":"

An array of disk objects containing information about all block storage disks.

" - }, - "fromInstanceName":{ - "shape":"ResourceName", - "documentation":"

The instance from which the snapshot was created.

" - }, - "fromInstanceArn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the instance from which the snapshot was created (e.g., arn:aws:lightsail:us-east-2:123456789101:Instance/64b8404c-ccb1-430b-8daf-12345EXAMPLE).

" - }, - "fromBlueprintId":{ - "shape":"string", - "documentation":"

The blueprint ID from which you created the snapshot (e.g., os_debian_8_3). A blueprint is a virtual private server (or instance) image used to create instances quickly.

" - }, - "fromBundleId":{ - "shape":"string", - "documentation":"

The bundle ID from which you created the snapshot (e.g., micro_1_0).

" - }, - "sizeInGb":{ - "shape":"integer", - "documentation":"

The size in GB of the SSD.

" - } - }, - "documentation":"

Describes the snapshot of the virtual private server, or instance.

" - }, - "InstanceSnapshotList":{ - "type":"list", - "member":{"shape":"InstanceSnapshot"} - }, - "InstanceSnapshotState":{ - "type":"string", - "enum":[ - "pending", - "error", - "available" - ] - }, - "InstanceState":{ - "type":"structure", - "members":{ - "code":{ - "shape":"integer", - "documentation":"

The status code for the instance.

" - }, - "name":{ - "shape":"string", - "documentation":"

The state of the instance (e.g., running or pending).

" - } - }, - "documentation":"

Describes the virtual private server (or instance) status.

" - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when user input does not conform to the validation rules of an input field.

Domain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set your AWS Region configuration to us-east-1 to create, view, or edit these resources.

", - "exception":true - }, - "IpAddress":{ - "type":"string", - "pattern":"([0-9]{1,3}\\.){3}[0-9]{1,3}" - }, - "IpV6Address":{ - "type":"string", - "pattern":"([A-F0-9]{1,4}:){7}[A-F0-9]{1,4}" - }, - "IsVpcPeeredRequest":{ - "type":"structure", - "members":{ - } - }, - "IsVpcPeeredResult":{ - "type":"structure", - "members":{ - "isPeered":{ - "shape":"boolean", - "documentation":"

Returns true if the Lightsail VPC is peered; otherwise, false.

" - } - } - }, - "IsoDate":{"type":"timestamp"}, - "KeyPair":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The friendly name of the SSH key pair.

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the key pair (e.g., arn:aws:lightsail:us-east-2:123456789101:KeyPair/05859e3d-331d-48ba-9034-12345EXAMPLE).

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the key pair was created (e.g., 1479816991.349).

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The region name and Availability Zone where the key pair was created.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type (usually KeyPair).

" - }, - "fingerprint":{ - "shape":"Base64", - "documentation":"

The RSA fingerprint of the key pair.

" - } - }, - "documentation":"

Describes the SSH key pair.

" - }, - "KeyPairList":{ - "type":"list", - "member":{"shape":"KeyPair"} - }, - "LoadBalancer":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer (e.g., my-load-balancer).

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about your Lightsail load balancer. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The date when your load balancer was created.

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The AWS Region where your load balancer was created (e.g., us-east-2a). Lightsail automatically creates your load balancer across Availability Zones.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type (e.g., LoadBalancer.

" - }, - "dnsName":{ - "shape":"NonEmptyString", - "documentation":"

The DNS name of your Lightsail load balancer.

" - }, - "state":{ - "shape":"LoadBalancerState", - "documentation":"

The status of your load balancer. Valid values are below.

" - }, - "protocol":{ - "shape":"LoadBalancerProtocol", - "documentation":"

The protocol you have enabled for your load balancer. Valid values are below.

You can't just have HTTP_HTTPS, but you can have just HTTP.

" - }, - "publicPorts":{ - "shape":"PortList", - "documentation":"

An array of public port settings for your load balancer. For HTTP, use port 80. For HTTPS, use port 443.

" - }, - "healthCheckPath":{ - "shape":"NonEmptyString", - "documentation":"

The path you specified to perform your health checks. If no path is specified, the load balancer tries to make a request to the default (root) page.

" - }, - "instancePort":{ - "shape":"integer", - "documentation":"

The port where the load balancer will direct traffic to your Lightsail instances. For HTTP traffic, it's port 80. For HTTPS traffic, it's port 443.

" - }, - "instanceHealthSummary":{ - "shape":"InstanceHealthSummaryList", - "documentation":"

An array of InstanceHealthSummary objects describing the health of the load balancer.

" - }, - "tlsCertificateSummaries":{ - "shape":"LoadBalancerTlsCertificateSummaryList", - "documentation":"

An array of LoadBalancerTlsCertificateSummary objects that provide additional information about the SSL/TLS certificates. For example, if true, the certificate is attached to the load balancer.

" - }, - "configurationOptions":{ - "shape":"LoadBalancerConfigurationOptions", - "documentation":"

A string to string map of the configuration options for your load balancer. Valid values are listed below.

" - } - }, - "documentation":"

Describes the Lightsail load balancer.

" - }, - "LoadBalancerAttributeName":{ - "type":"string", - "enum":[ - "HealthCheckPath", - "SessionStickinessEnabled", - "SessionStickiness_LB_CookieDurationSeconds" - ] - }, - "LoadBalancerConfigurationOptions":{ - "type":"map", - "key":{"shape":"LoadBalancerAttributeName"}, - "value":{"shape":"string"} - }, - "LoadBalancerList":{ - "type":"list", - "member":{"shape":"LoadBalancer"} - }, - "LoadBalancerMetricName":{ - "type":"string", - "enum":[ - "ClientTLSNegotiationErrorCount", - "HealthyHostCount", - "UnhealthyHostCount", - "HTTPCode_LB_4XX_Count", - "HTTPCode_LB_5XX_Count", - "HTTPCode_Instance_2XX_Count", - "HTTPCode_Instance_3XX_Count", - "HTTPCode_Instance_4XX_Count", - "HTTPCode_Instance_5XX_Count", - "InstanceResponseTime", - "RejectedConnectionCount", - "RequestCount" - ] - }, - "LoadBalancerProtocol":{ - "type":"string", - "enum":[ - "HTTP_HTTPS", - "HTTP" - ] - }, - "LoadBalancerState":{ - "type":"string", - "enum":[ - "active", - "provisioning", - "active_impaired", - "failed", - "unknown" - ] - }, - "LoadBalancerTlsCertificate":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the SSL/TLS certificate (e.g., my-certificate).

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the SSL/TLS certificate.

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about your Lightsail load balancer or SSL/TLS certificate. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The time when you created your SSL/TLS certificate.

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The AWS Region and Availability Zone where you created your certificate.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type (e.g., LoadBalancerTlsCertificate).

  • Instance - A Lightsail instance (a virtual private server)

  • StaticIp - A static IP address

  • KeyPair - The key pair used to connect to a Lightsail instance

  • InstanceSnapshot - A Lightsail instance snapshot

  • Domain - A DNS zone

  • PeeredVpc - A peered VPC

  • LoadBalancer - A Lightsail load balancer

  • LoadBalancerTlsCertificate - An SSL/TLS certificate associated with a Lightsail load balancer

  • Disk - A Lightsail block storage disk

  • DiskSnapshot - A block storage disk snapshot

" - }, - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The load balancer name where your SSL/TLS certificate is attached.

" - }, - "isAttached":{ - "shape":"boolean", - "documentation":"

When true, the SSL/TLS certificate is attached to the Lightsail load balancer.

" - }, - "status":{ - "shape":"LoadBalancerTlsCertificateStatus", - "documentation":"

The status of the SSL/TLS certificate. Valid values are below.

" - }, - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name for your SSL/TLS certificate.

" - }, - "domainValidationRecords":{ - "shape":"LoadBalancerTlsCertificateDomainValidationRecordList", - "documentation":"

An array of LoadBalancerTlsCertificateDomainValidationRecord objects describing the records.

" - }, - "failureReason":{ - "shape":"LoadBalancerTlsCertificateFailureReason", - "documentation":"

The reason for the SSL/TLS certificate validation failure.

" - }, - "issuedAt":{ - "shape":"IsoDate", - "documentation":"

The time when the SSL/TLS certificate was issued.

" - }, - "issuer":{ - "shape":"NonEmptyString", - "documentation":"

The issuer of the certificate.

" - }, - "keyAlgorithm":{ - "shape":"NonEmptyString", - "documentation":"

The algorithm that was used to generate the key pair (the public and private key).

" - }, - "notAfter":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the SSL/TLS certificate expires.

" - }, - "notBefore":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the SSL/TLS certificate is first valid.

" - }, - "renewalSummary":{ - "shape":"LoadBalancerTlsCertificateRenewalSummary", - "documentation":"

An object containing information about the status of Lightsail's managed renewal for the certificate.

" - }, - "revocationReason":{ - "shape":"LoadBalancerTlsCertificateRevocationReason", - "documentation":"

The reason the certificate was revoked. Valid values are below.

" - }, - "revokedAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the SSL/TLS certificate was revoked.

" - }, - "serial":{ - "shape":"NonEmptyString", - "documentation":"

The serial number of the certificate.

" - }, - "signatureAlgorithm":{ - "shape":"NonEmptyString", - "documentation":"

The algorithm that was used to sign the certificate.

" - }, - "subject":{ - "shape":"NonEmptyString", - "documentation":"

The name of the entity that is associated with the public key contained in the certificate.

" - }, - "subjectAlternativeNames":{ - "shape":"StringList", - "documentation":"

One or more domains or subdomains included in the certificate. This list contains the domain names that are bound to the public key that is contained in the certificate. The subject alternative names include the canonical domain name (CNAME) of the certificate and additional domain names that can be used to connect to the website, such as example.com, www.example.com, or m.example.com.

" - } - }, - "documentation":"

Describes a load balancer SSL/TLS certificate.

TLS is just an updated, more secure version of Secure Socket Layer (SSL).

" - }, - "LoadBalancerTlsCertificateDomainStatus":{ - "type":"string", - "enum":[ - "PENDING_VALIDATION", - "FAILED", - "SUCCESS" - ] - }, - "LoadBalancerTlsCertificateDomainValidationOption":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The fully qualified domain name in the certificate request.

" - }, - "validationStatus":{ - "shape":"LoadBalancerTlsCertificateDomainStatus", - "documentation":"

The status of the domain validation. Valid values are listed below.

" - } - }, - "documentation":"

Contains information about the domain names on an SSL/TLS certificate that you will use to validate domain ownership.

" - }, - "LoadBalancerTlsCertificateDomainValidationOptionList":{ - "type":"list", - "member":{"shape":"LoadBalancerTlsCertificateDomainValidationOption"} - }, - "LoadBalancerTlsCertificateDomainValidationRecord":{ - "type":"structure", - "members":{ - "name":{ - "shape":"NonEmptyString", - "documentation":"

A fully qualified domain name in the certificate. For example, example.com.

" - }, - "type":{ - "shape":"NonEmptyString", - "documentation":"

The type of validation record. For example, CNAME for domain validation.

" - }, - "value":{ - "shape":"NonEmptyString", - "documentation":"

The value for that type.

" - }, - "validationStatus":{ - "shape":"LoadBalancerTlsCertificateDomainStatus", - "documentation":"

The validation status. Valid values are listed below.

" - }, - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name against which your SSL/TLS certificate was validated.

" - } - }, - "documentation":"

Describes the validation record of each domain name in the SSL/TLS certificate.

" - }, - "LoadBalancerTlsCertificateDomainValidationRecordList":{ - "type":"list", - "member":{"shape":"LoadBalancerTlsCertificateDomainValidationRecord"} - }, - "LoadBalancerTlsCertificateFailureReason":{ - "type":"string", - "enum":[ - "NO_AVAILABLE_CONTACTS", - "ADDITIONAL_VERIFICATION_REQUIRED", - "DOMAIN_NOT_ALLOWED", - "INVALID_PUBLIC_DOMAIN", - "OTHER" - ] - }, - "LoadBalancerTlsCertificateList":{ - "type":"list", - "member":{"shape":"LoadBalancerTlsCertificate"} - }, - "LoadBalancerTlsCertificateRenewalStatus":{ - "type":"string", - "enum":[ - "PENDING_AUTO_RENEWAL", - "PENDING_VALIDATION", - "SUCCESS", - "FAILED" - ] - }, - "LoadBalancerTlsCertificateRenewalSummary":{ - "type":"structure", - "members":{ - "renewalStatus":{ - "shape":"LoadBalancerTlsCertificateRenewalStatus", - "documentation":"

The status of Lightsail's managed renewal of the certificate. Valid values are listed below.

" - }, - "domainValidationOptions":{ - "shape":"LoadBalancerTlsCertificateDomainValidationOptionList", - "documentation":"

Contains information about the validation of each domain name in the certificate, as it pertains to Lightsail's managed renewal. This is different from the initial validation that occurs as a result of the RequestCertificate request.

" - } - }, - "documentation":"

Contains information about the status of Lightsail's managed renewal for the certificate.

" - }, - "LoadBalancerTlsCertificateRevocationReason":{ - "type":"string", - "enum":[ - "UNSPECIFIED", - "KEY_COMPROMISE", - "CA_COMPROMISE", - "AFFILIATION_CHANGED", - "SUPERCEDED", - "CESSATION_OF_OPERATION", - "CERTIFICATE_HOLD", - "REMOVE_FROM_CRL", - "PRIVILEGE_WITHDRAWN", - "A_A_COMPROMISE" - ] - }, - "LoadBalancerTlsCertificateStatus":{ - "type":"string", - "enum":[ - "PENDING_VALIDATION", - "ISSUED", - "INACTIVE", - "EXPIRED", - "VALIDATION_TIMED_OUT", - "REVOKED", - "FAILED", - "UNKNOWN" - ] - }, - "LoadBalancerTlsCertificateSummary":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the SSL/TLS certificate.

" - }, - "isAttached":{ - "shape":"boolean", - "documentation":"

When true, the SSL/TLS certificate is attached to the Lightsail load balancer.

" - } - }, - "documentation":"

Provides a summary of SSL/TLS certificate metadata.

" - }, - "LoadBalancerTlsCertificateSummaryList":{ - "type":"list", - "member":{"shape":"LoadBalancerTlsCertificateSummary"} - }, - "MetricDatapoint":{ - "type":"structure", - "members":{ - "average":{ - "shape":"double", - "documentation":"

The average.

" - }, - "maximum":{ - "shape":"double", - "documentation":"

The maximum.

" - }, - "minimum":{ - "shape":"double", - "documentation":"

The minimum.

" - }, - "sampleCount":{ - "shape":"double", - "documentation":"

The sample count.

" - }, - "sum":{ - "shape":"double", - "documentation":"

The sum.

" - }, - "timestamp":{ - "shape":"timestamp", - "documentation":"

The timestamp (e.g., 1479816991.349).

" - }, - "unit":{ - "shape":"MetricUnit", - "documentation":"

The unit.

" - } - }, - "documentation":"

Describes the metric data point.

" - }, - "MetricDatapointList":{ - "type":"list", - "member":{"shape":"MetricDatapoint"} - }, - "MetricPeriod":{ - "type":"integer", - "max":86400, - "min":60 - }, - "MetricStatistic":{ - "type":"string", - "enum":[ - "Minimum", - "Maximum", - "Sum", - "Average", - "SampleCount" - ] - }, - "MetricStatisticList":{ - "type":"list", - "member":{"shape":"MetricStatistic"} - }, - "MetricUnit":{ - "type":"string", - "enum":[ - "Seconds", - "Microseconds", - "Milliseconds", - "Bytes", - "Kilobytes", - "Megabytes", - "Gigabytes", - "Terabytes", - "Bits", - "Kilobits", - "Megabits", - "Gigabits", - "Terabits", - "Percent", - "Count", - "Bytes/Second", - "Kilobytes/Second", - "Megabytes/Second", - "Gigabytes/Second", - "Terabytes/Second", - "Bits/Second", - "Kilobits/Second", - "Megabits/Second", - "Gigabits/Second", - "Terabits/Second", - "Count/Second", - "None" - ] - }, - "MonthlyTransfer":{ - "type":"structure", - "members":{ - "gbPerMonthAllocated":{ - "shape":"integer", - "documentation":"

The amount allocated per month (in GB).

" - } - }, - "documentation":"

Describes the monthly data transfer in and out of your virtual private server (or instance).

" - }, - "NetworkProtocol":{ - "type":"string", - "enum":[ - "tcp", - "all", - "udp" - ] - }, - "NonEmptyString":{ - "type":"string", - "pattern":".*\\S.*" - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when it cannot find a resource.

", - "exception":true - }, - "OpenInstancePublicPortsRequest":{ - "type":"structure", - "required":[ - "portInfo", - "instanceName" - ], - "members":{ - "portInfo":{ - "shape":"PortInfo", - "documentation":"

An array of key-value pairs containing information about the port mappings.

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance for which you want to open the public ports.

" - } - } - }, - "OpenInstancePublicPortsResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "Operation":{ - "type":"structure", - "members":{ - "id":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the operation.

" - }, - "resourceName":{ - "shape":"ResourceName", - "documentation":"

The resource name.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the operation was initialized (e.g., 1479816991.349).

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The region and Availability Zone.

" - }, - "isTerminal":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether the operation is terminal.

" - }, - "operationDetails":{ - "shape":"string", - "documentation":"

Details about the operation (e.g., Debian-1GB-Ohio-1).

" - }, - "operationType":{ - "shape":"OperationType", - "documentation":"

The type of operation.

" - }, - "status":{ - "shape":"OperationStatus", - "documentation":"

The status of the operation.

" - }, - "statusChangedAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the status was changed (e.g., 1479816991.349).

" - }, - "errorCode":{ - "shape":"string", - "documentation":"

The error code.

" - }, - "errorDetails":{ - "shape":"string", - "documentation":"

The error details.

" - } - }, - "documentation":"

Describes the API operation.

" - }, - "OperationFailureException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when an operation fails to execute.

", - "exception":true - }, - "OperationList":{ - "type":"list", - "member":{"shape":"Operation"} - }, - "OperationStatus":{ - "type":"string", - "enum":[ - "NotStarted", - "Started", - "Failed", - "Completed", - "Succeeded" - ] - }, - "OperationType":{ - "type":"string", - "enum":[ - "DeleteInstance", - "CreateInstance", - "StopInstance", - "StartInstance", - "RebootInstance", - "OpenInstancePublicPorts", - "PutInstancePublicPorts", - "CloseInstancePublicPorts", - "AllocateStaticIp", - "ReleaseStaticIp", - "AttachStaticIp", - "DetachStaticIp", - "UpdateDomainEntry", - "DeleteDomainEntry", - "CreateDomain", - "DeleteDomain", - "CreateInstanceSnapshot", - "DeleteInstanceSnapshot", - "CreateInstancesFromSnapshot", - "CreateLoadBalancer", - "DeleteLoadBalancer", - "AttachInstancesToLoadBalancer", - "DetachInstancesFromLoadBalancer", - "UpdateLoadBalancerAttribute", - "CreateLoadBalancerTlsCertificate", - "DeleteLoadBalancerTlsCertificate", - "AttachLoadBalancerTlsCertificate", - "CreateDisk", - "DeleteDisk", - "AttachDisk", - "DetachDisk", - "CreateDiskSnapshot", - "DeleteDiskSnapshot", - "CreateDiskFromSnapshot" - ] - }, - "PasswordData":{ - "type":"structure", - "members":{ - "ciphertext":{ - "shape":"string", - "documentation":"

The encrypted password. Ciphertext will be an empty string if access to your new instance is not ready yet. When you create an instance, it can take up to 15 minutes for the instance to be ready.

If you use the default key pair (LightsailDefaultKeyPair), the decrypted password will be available in the password field.

If you are using a custom key pair, you need to use your own means of decryption.

If you change the Administrator password on the instance, Lightsail will continue to return the original ciphertext value. When accessing the instance using RDP, you need to manually enter the Administrator password after changing it from the default.

" - }, - "keyPairName":{ - "shape":"ResourceName", - "documentation":"

The name of the key pair that you used when creating your instance. If no key pair name was specified when creating the instance, Lightsail uses the default key pair (LightsailDefaultKeyPair).

If you are using a custom key pair, you need to use your own means of decrypting your password using the ciphertext. Lightsail creates the ciphertext by encrypting your password with the public key part of this key pair.

" - } - }, - "documentation":"

The password data for the Windows Server-based instance, including the ciphertext and the key pair name.

" - }, - "PeerVpcRequest":{ - "type":"structure", - "members":{ - } - }, - "PeerVpcResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "Port":{ - "type":"integer", - "max":65535, - "min":0 - }, - "PortAccessType":{ - "type":"string", - "enum":[ - "Public", - "Private" - ] - }, - "PortInfo":{ - "type":"structure", - "members":{ - "fromPort":{ - "shape":"Port", - "documentation":"

The first port in the range.

" - }, - "toPort":{ - "shape":"Port", - "documentation":"

The last port in the range.

" - }, - "protocol":{ - "shape":"NetworkProtocol", - "documentation":"

The protocol.

" - } - }, - "documentation":"

Describes information about the ports on your virtual private server (or instance).

" - }, - "PortInfoList":{ - "type":"list", - "member":{"shape":"PortInfo"} - }, - "PortList":{ - "type":"list", - "member":{"shape":"Port"} - }, - "PortState":{ - "type":"string", - "enum":[ - "open", - "closed" - ] - }, - "PutInstancePublicPortsRequest":{ - "type":"structure", - "required":[ - "portInfos", - "instanceName" - ], - "members":{ - "portInfos":{ - "shape":"PortInfoList", - "documentation":"

Specifies information about the public port(s).

" - }, - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The Lightsail instance name of the public port(s) you are setting.

" - } - } - }, - "PutInstancePublicPortsResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

Describes metadata about the operation you just executed.

" - } - } - }, - "RebootInstanceRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance to reboot.

" - } - } - }, - "RebootInstanceResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the request operations.

" - } - } - }, - "Region":{ - "type":"structure", - "members":{ - "continentCode":{ - "shape":"string", - "documentation":"

The continent code (e.g., NA, meaning North America).

" - }, - "description":{ - "shape":"string", - "documentation":"

The description of the AWS Region (e.g., This region is recommended to serve users in the eastern United States and eastern Canada).

" - }, - "displayName":{ - "shape":"string", - "documentation":"

The display name (e.g., Ohio).

" - }, - "name":{ - "shape":"RegionName", - "documentation":"

The region name (e.g., us-east-2).

" - }, - "availabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

The Availability Zones. Follows the format us-east-2a (case-sensitive).

" - } - }, - "documentation":"

Describes the AWS Region.

" - }, - "RegionList":{ - "type":"list", - "member":{"shape":"Region"} - }, - "RegionName":{ - "type":"string", - "enum":[ - "us-east-1", - "us-east-2", - "us-west-1", - "us-west-2", - "eu-central-1", - "eu-west-1", - "eu-west-2", - "ap-south-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1", - "ap-northeast-2" - ] - }, - "ReleaseStaticIpRequest":{ - "type":"structure", - "required":["staticIpName"], - "members":{ - "staticIpName":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP to delete.

" - } - } - }, - "ReleaseStaticIpResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "ResourceLocation":{ - "type":"structure", - "members":{ - "availabilityZone":{ - "shape":"string", - "documentation":"

The Availability Zone. Follows the format us-east-2a (case-sensitive).

" - }, - "regionName":{ - "shape":"RegionName", - "documentation":"

The AWS Region name.

" - } - }, - "documentation":"

Describes the resource location.

" - }, - "ResourceName":{ - "type":"string", - "pattern":"\\w[\\w\\-]*\\w" - }, - "ResourceNameList":{ - "type":"list", - "member":{"shape":"ResourceName"} - }, - "ResourceType":{ - "type":"string", - "enum":[ - "Instance", - "StaticIp", - "KeyPair", - "InstanceSnapshot", - "Domain", - "PeeredVpc", - "LoadBalancer", - "LoadBalancerTlsCertificate", - "Disk", - "DiskSnapshot" - ] - }, - "ServiceException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

A general service exception.

", - "exception":true, - "fault":true - }, - "StartInstanceRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance (a virtual private server) to start.

" - } - } - }, - "StartInstanceResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "StaticIp":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ResourceName", - "documentation":"

The name of the static IP (e.g., StaticIP-Ohio-EXAMPLE).

" - }, - "arn":{ - "shape":"NonEmptyString", - "documentation":"

The Amazon Resource Name (ARN) of the static IP (e.g., arn:aws:lightsail:us-east-2:123456789101:StaticIp/9cbb4a9e-f8e3-4dfe-b57e-12345EXAMPLE).

" - }, - "supportCode":{ - "shape":"string", - "documentation":"

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

" - }, - "createdAt":{ - "shape":"IsoDate", - "documentation":"

The timestamp when the static IP was created (e.g., 1479735304.222).

" - }, - "location":{ - "shape":"ResourceLocation", - "documentation":"

The region and Availability Zone where the static IP was created.

" - }, - "resourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type (usually StaticIp).

" - }, - "ipAddress":{ - "shape":"IpAddress", - "documentation":"

The static IP address.

" - }, - "attachedTo":{ - "shape":"ResourceName", - "documentation":"

The instance where the static IP is attached (e.g., Amazon_Linux-1GB-Ohio-1).

" - }, - "isAttached":{ - "shape":"boolean", - "documentation":"

A Boolean value indicating whether the static IP is attached.

" - } - }, - "documentation":"

Describes the static IP.

" - }, - "StaticIpList":{ - "type":"list", - "member":{"shape":"StaticIp"} - }, - "StopInstanceRequest":{ - "type":"structure", - "required":["instanceName"], - "members":{ - "instanceName":{ - "shape":"ResourceName", - "documentation":"

The name of the instance (a virtual private server) to stop.

" - }, - "force":{ - "shape":"boolean", - "documentation":"

When set to True, forces a Lightsail instance that is stuck in a stopping state to stop.

Only use the force parameter if your instance is stuck in the stopping state. In any other state, your instance should stop normally without adding this parameter to your API request.

" - } - } - }, - "StopInstanceResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "StringList":{ - "type":"list", - "member":{"shape":"string"} - }, - "StringMax256":{ - "type":"string", - "max":256, - "min":1 - }, - "UnauthenticatedException":{ - "type":"structure", - "members":{ - "code":{"shape":"string"}, - "docs":{"shape":"string"}, - "message":{"shape":"string"}, - "tip":{"shape":"string"} - }, - "documentation":"

Lightsail throws this exception when the user has not been authenticated.

", - "exception":true - }, - "UnpeerVpcRequest":{ - "type":"structure", - "members":{ - } - }, - "UnpeerVpcResult":{ - "type":"structure", - "members":{ - "operation":{ - "shape":"Operation", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "UpdateDomainEntryRequest":{ - "type":"structure", - "required":[ - "domainName", - "domainEntry" - ], - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain recordset to update.

" - }, - "domainEntry":{ - "shape":"DomainEntry", - "documentation":"

An array of key-value pairs containing information about the domain entry.

" - } - } - }, - "UpdateDomainEntryResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An array of key-value pairs containing information about the request operation.

" - } - } - }, - "UpdateLoadBalancerAttributeRequest":{ - "type":"structure", - "required":[ - "loadBalancerName", - "attributeName", - "attributeValue" - ], - "members":{ - "loadBalancerName":{ - "shape":"ResourceName", - "documentation":"

The name of the load balancer that you want to modify (e.g., my-load-balancer.

" - }, - "attributeName":{ - "shape":"LoadBalancerAttributeName", - "documentation":"

The name of the attribute you want to update. Valid values are below.

" - }, - "attributeValue":{ - "shape":"StringMax256", - "documentation":"

The value that you want to specify for the attribute name.

" - } - } - }, - "UpdateLoadBalancerAttributeResult":{ - "type":"structure", - "members":{ - "operations":{ - "shape":"OperationList", - "documentation":"

An object describing the API operations.

" - } - } - }, - "boolean":{"type":"boolean"}, - "double":{"type":"double"}, - "float":{"type":"float"}, - "integer":{"type":"integer"}, - "string":{"type":"string"}, - "timestamp":{"type":"timestamp"} - }, - "documentation":"

Amazon Lightsail is the easiest way to get started with AWS for developers who just need virtual private servers. Lightsail includes everything you need to launch your project quickly - a virtual machine, SSD-based storage, data transfer, DNS management, and a static IP - for a low, predictable price. You manage those Lightsail servers through the Lightsail console or by using the API or command-line interface (CLI).

For more information about Lightsail concepts and tasks, see the Lightsail Dev Guide.

To use the Lightsail API or the CLI, you will need to use AWS Identity and Access Management (IAM) to generate access keys. For details about how to set this up, see the Lightsail Dev Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/paginators-1.json deleted file mode 100644 index 57449c57..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/paginators-1.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "pagination": { - "DescribeDestinations": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": "destinations" - }, - "DescribeLogGroups": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": "logGroups" - }, - "DescribeLogStreams": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": "logStreams" - }, - "DescribeMetricFilters": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": "metricFilters" - }, - "DescribeSubscriptionFilters": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": "subscriptionFilters" - }, - "FilterLogEvents": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "limit", - "result_key": [ - "events", - "searchedLogStreams" - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/service-2.json deleted file mode 100644 index 4ff0125c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/logs/2014-03-28/service-2.json +++ /dev/null @@ -1,2014 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-03-28", - "endpointPrefix":"logs", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon CloudWatch Logs", - "serviceId":"CloudWatch Logs", - "signatureVersion":"v4", - "targetPrefix":"Logs_20140328", - "uid":"logs-2014-03-28" - }, - "operations":{ - "AssociateKmsKey":{ - "name":"AssociateKmsKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateKmsKeyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Associates the specified AWS Key Management Service (AWS KMS) customer master key (CMK) with the specified log group.

Associating an AWS KMS CMK with a log group overrides any existing associations between the log group and a CMK. After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

Note that it can take up to 5 minutes for this operation to take effect.

If you attempt to associate a CMK with a log group but the CMK does not exist or the CMK is disabled, you will receive an InvalidParameterException error.

" - }, - "CancelExportTask":{ - "name":"CancelExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelExportTaskRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidOperationException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Cancels the specified export task.

The task must be in the PENDING or RUNNING state.

" - }, - "CreateExportTask":{ - "name":"CreateExportTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateExportTaskRequest"}, - "output":{"shape":"CreateExportTaskResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"LimitExceededException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAlreadyExistsException"} - ], - "documentation":"

Creates an export task, which allows you to efficiently export data from a log group to an Amazon S3 bucket.

This is an asynchronous call. If all the required information is provided, this operation initiates an export task and responds with the ID of the task. After the task has started, you can use DescribeExportTasks to get the status of the export task. Each account can only have one active (RUNNING or PENDING) export task at a time. To cancel an export task, use CancelExportTask.

You can export logs from multiple log groups or multiple time ranges to the same S3 bucket. To separate out log data for each export task, you can specify a prefix to be used as the Amazon S3 key prefix for all exported objects.

" - }, - "CreateLogGroup":{ - "name":"CreateLogGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLogGroupRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a log group with the specified name.

You can create up to 5000 log groups per account.

You must use the following guidelines when naming a log group:

  • Log group names must be unique within a region for an AWS account.

  • Log group names can be between 1 and 512 characters long.

  • Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).

If you associate a AWS Key Management Service (AWS KMS) customer master key (CMK) with the log group, ingested data is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

If you attempt to associate a CMK with the log group but the CMK does not exist or the CMK is disabled, you will receive an InvalidParameterException error.

" - }, - "CreateLogStream":{ - "name":"CreateLogStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLogStreamRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a log stream for the specified log group.

There is no limit on the number of log streams that you can create for a log group.

You must use the following guidelines when naming a log stream:

  • Log stream names must be unique within the log group.

  • Log stream names can be between 1 and 512 characters long.

  • The ':' (colon) and '*' (asterisk) characters are not allowed.

" - }, - "DeleteDestination":{ - "name":"DeleteDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDestinationRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified destination, and eventually disables all the subscription filters that publish to it. This operation does not delete the physical resource encapsulated by the destination.

" - }, - "DeleteLogGroup":{ - "name":"DeleteLogGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLogGroupRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified log group and permanently deletes all the archived log events associated with the log group.

" - }, - "DeleteLogStream":{ - "name":"DeleteLogStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLogStreamRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified log stream and permanently deletes all the archived log events associated with the log stream.

" - }, - "DeleteMetricFilter":{ - "name":"DeleteMetricFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMetricFilterRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified metric filter.

" - }, - "DeleteResourcePolicy":{ - "name":"DeleteResourcePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteResourcePolicyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes a resource policy from this account. This revokes the access of the identities in that policy to put log events to this account.

" - }, - "DeleteRetentionPolicy":{ - "name":"DeleteRetentionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRetentionPolicyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified retention policy.

Log events do not expire if they belong to log groups without a retention policy.

" - }, - "DeleteSubscriptionFilter":{ - "name":"DeleteSubscriptionFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubscriptionFilterRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified subscription filter.

" - }, - "DescribeDestinations":{ - "name":"DescribeDestinations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDestinationsRequest"}, - "output":{"shape":"DescribeDestinationsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists all your destinations. The results are ASCII-sorted by destination name.

" - }, - "DescribeExportTasks":{ - "name":"DescribeExportTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExportTasksRequest"}, - "output":{"shape":"DescribeExportTasksResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the specified export tasks. You can list all your export tasks or filter the results based on task ID or task status.

" - }, - "DescribeLogGroups":{ - "name":"DescribeLogGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLogGroupsRequest"}, - "output":{"shape":"DescribeLogGroupsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the specified log groups. You can list all your log groups or filter the results by prefix. The results are ASCII-sorted by log group name.

" - }, - "DescribeLogStreams":{ - "name":"DescribeLogStreams", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLogStreamsRequest"}, - "output":{"shape":"DescribeLogStreamsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the log streams for the specified log group. You can list all the log streams or filter the results by prefix. You can also control how the results are ordered.

This operation has a limit of five transactions per second, after which transactions are throttled.

" - }, - "DescribeMetricFilters":{ - "name":"DescribeMetricFilters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMetricFiltersRequest"}, - "output":{"shape":"DescribeMetricFiltersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the specified metric filters. You can list all the metric filters or filter the results by log name, prefix, metric name, or metric namespace. The results are ASCII-sorted by filter name.

" - }, - "DescribeResourcePolicies":{ - "name":"DescribeResourcePolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResourcePoliciesRequest"}, - "output":{"shape":"DescribeResourcePoliciesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the resource policies in this account.

" - }, - "DescribeSubscriptionFilters":{ - "name":"DescribeSubscriptionFilters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubscriptionFiltersRequest"}, - "output":{"shape":"DescribeSubscriptionFiltersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the subscription filters for the specified log group. You can list all the subscription filters or filter the results by prefix. The results are ASCII-sorted by filter name.

" - }, - "DisassociateKmsKey":{ - "name":"DisassociateKmsKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateKmsKeyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Disassociates the associated AWS Key Management Service (AWS KMS) customer master key (CMK) from the specified log group.

After the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

Note that it can take up to 5 minutes for this operation to take effect.

" - }, - "FilterLogEvents":{ - "name":"FilterLogEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"FilterLogEventsRequest"}, - "output":{"shape":"FilterLogEventsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists log events from the specified log group. You can list all the log events or filter the results using a filter pattern, a time range, and the name of the log stream.

By default, this operation returns as many log events as can fit in 1 MB (up to 10,000 log events), or all the events found within the time range that you specify. If the results include a token, then there are more log events available, and you can get additional results by specifying the token in a subsequent call.

" - }, - "GetLogEvents":{ - "name":"GetLogEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLogEventsRequest"}, - "output":{"shape":"GetLogEventsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists log events from the specified log stream. You can list all the log events or filter using a time range.

By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events). You can get additional log events by specifying one of the tokens in a subsequent call.

" - }, - "ListTagsLogGroup":{ - "name":"ListTagsLogGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsLogGroupRequest"}, - "output":{"shape":"ListTagsLogGroupResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the tags for the specified log group.

" - }, - "PutDestination":{ - "name":"PutDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutDestinationRequest"}, - "output":{"shape":"PutDestinationResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates or updates a destination. A destination encapsulates a physical resource (such as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events for a different account, ingested using PutLogEvents. Currently, the only supported physical resource is a Kinesis stream belonging to the same account as the destination.

Through an access policy, a destination controls what is written to its Kinesis stream. By default, PutDestination does not set any access policy with the destination, which means a cross-account user cannot call PutSubscriptionFilter against this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination.

" - }, - "PutDestinationPolicy":{ - "name":"PutDestinationPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutDestinationPolicyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates or updates an access policy associated with an existing destination. An access policy is an IAM policy document that is used to authorize claims to register a subscription filter against a given destination.

" - }, - "PutLogEvents":{ - "name":"PutLogEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutLogEventsRequest"}, - "output":{"shape":"PutLogEventsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidSequenceTokenException"}, - {"shape":"DataAlreadyAcceptedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnrecognizedClientException"} - ], - "documentation":"

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.

The batch of events must satisfy the following constraints:

  • The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.

  • None of the log events in the batch can be more than 2 hours in the future.

  • None of the log events in the batch can be older than 14 days or the retention period of the log group.

  • The log events in the batch must be in chronological ordered by their time stamp. The time stamp is the time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. (In AWS Tools for PowerShell and the AWS SDK for .NET, the timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. For example, 2017-09-15T13:45:30.)

  • The maximum number of log events in a batch is 10,000.

  • A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.

If a call to PutLogEvents returns \"UnrecognizedClientException\" the most likely cause is an invalid AWS access key ID or secret key.

" - }, - "PutMetricFilter":{ - "name":"PutMetricFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutMetricFilterRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through PutLogEvents.

The maximum number of metric filters that can be associated with a log group is 100.

" - }, - "PutResourcePolicy":{ - "name":"PutResourcePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutResourcePolicyRequest"}, - "output":{"shape":"PutResourcePolicyResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates or updates a resource policy allowing other AWS services to put log events to this account, such as Amazon Route 53. An account can have up to 10 resource policies per region.

" - }, - "PutRetentionPolicy":{ - "name":"PutRetentionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutRetentionPolicyRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Sets the retention of the specified log group. A retention policy allows you to configure the number of days for which to retain log events in the specified log group.

" - }, - "PutSubscriptionFilter":{ - "name":"PutSubscriptionFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutSubscriptionFilterRequest"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OperationAbortedException"}, - {"shape":"LimitExceededException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. Currently, the supported destinations are:

  • An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.

  • A logical destination that belongs to a different account, for cross-account delivery.

  • An Amazon Kinesis Firehose delivery stream that belongs to the same account as the subscription filter, for same-account delivery.

  • An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.

There can only be one subscription filter associated with a log group. If you are updating an existing filter, you must specify the correct name in filterName. Otherwise, the call fails because you cannot associate a second filter with a log group.

" - }, - "TagLogGroup":{ - "name":"TagLogGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagLogGroupRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Adds or updates the specified tags for the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To remove tags, use UntagLogGroup.

For more information about tags, see Tag Log Groups in Amazon CloudWatch Logs in the Amazon CloudWatch Logs User Guide.

" - }, - "TestMetricFilter":{ - "name":"TestMetricFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestMetricFilterRequest"}, - "output":{"shape":"TestMetricFilterResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.

" - }, - "UntagLogGroup":{ - "name":"UntagLogGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagLogGroupRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes the specified tags from the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To add tags, use UntagLogGroup.

" - } - }, - "shapes":{ - "AccessPolicy":{ - "type":"string", - "min":1 - }, - "Arn":{"type":"string"}, - "AssociateKmsKeyRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "kmsKeyId" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "kmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS).

" - } - } - }, - "CancelExportTaskRequest":{ - "type":"structure", - "required":["taskId"], - "members":{ - "taskId":{ - "shape":"ExportTaskId", - "documentation":"

The ID of the export task.

" - } - } - }, - "CreateExportTaskRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "from", - "to", - "destination" - ], - "members":{ - "taskName":{ - "shape":"ExportTaskName", - "documentation":"

The name of the export task.

" - }, - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamNamePrefix":{ - "shape":"LogStreamName", - "documentation":"

Export only log streams that match the provided prefix. If you don't specify a value, no prefix filter is applied.

" - }, - "from":{ - "shape":"Timestamp", - "documentation":"

The start time of the range for the request, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp earlier than this time are not exported.

" - }, - "to":{ - "shape":"Timestamp", - "documentation":"

The end time of the range for the request, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp later than this time are not exported.

" - }, - "destination":{ - "shape":"ExportDestinationBucket", - "documentation":"

The name of S3 bucket for the exported log data. The bucket must be in the same AWS region.

" - }, - "destinationPrefix":{ - "shape":"ExportDestinationPrefix", - "documentation":"

The prefix used as the start of the key for every object exported. If you don't specify a value, the default is exportedlogs.

" - } - } - }, - "CreateExportTaskResponse":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"ExportTaskId", - "documentation":"

The ID of the export task.

" - } - } - }, - "CreateLogGroupRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "kmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS).

" - }, - "tags":{ - "shape":"Tags", - "documentation":"

The key-value pairs to use for the tags.

" - } - } - }, - "CreateLogStreamRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "logStreamName" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - } - } - }, - "DataAlreadyAcceptedException":{ - "type":"structure", - "members":{ - "expectedSequenceToken":{"shape":"SequenceToken"} - }, - "documentation":"

The event was already logged.

", - "exception":true - }, - "Days":{ - "type":"integer", - "documentation":"

The number of days to retain the log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, and 3653.

" - }, - "DefaultValue":{"type":"double"}, - "DeleteDestinationRequest":{ - "type":"structure", - "required":["destinationName"], - "members":{ - "destinationName":{ - "shape":"DestinationName", - "documentation":"

The name of the destination.

" - } - } - }, - "DeleteLogGroupRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - } - } - }, - "DeleteLogStreamRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "logStreamName" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - } - } - }, - "DeleteMetricFilterRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "filterName" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterName":{ - "shape":"FilterName", - "documentation":"

The name of the metric filter.

" - } - } - }, - "DeleteResourcePolicyRequest":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy to be revoked. This parameter is required.

" - } - } - }, - "DeleteRetentionPolicyRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - } - } - }, - "DeleteSubscriptionFilterRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "filterName" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterName":{ - "shape":"FilterName", - "documentation":"

The name of the subscription filter.

" - } - } - }, - "Descending":{"type":"boolean"}, - "DescribeDestinationsRequest":{ - "type":"structure", - "members":{ - "DestinationNamePrefix":{ - "shape":"DestinationName", - "documentation":"

The prefix to match. If you don't specify a value, no prefix filter is applied.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - } - } - }, - "DescribeDestinationsResponse":{ - "type":"structure", - "members":{ - "destinations":{ - "shape":"Destinations", - "documentation":"

The destinations.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeExportTasksRequest":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"ExportTaskId", - "documentation":"

The ID of the export task. Specifying a task ID filters the results to zero or one export tasks.

" - }, - "statusCode":{ - "shape":"ExportTaskStatusCode", - "documentation":"

The status code of the export task. Specifying a status code filters the results to zero or more export tasks.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - } - } - }, - "DescribeExportTasksResponse":{ - "type":"structure", - "members":{ - "exportTasks":{ - "shape":"ExportTasks", - "documentation":"

The export tasks.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeLimit":{ - "type":"integer", - "max":50, - "min":1 - }, - "DescribeLogGroupsRequest":{ - "type":"structure", - "members":{ - "logGroupNamePrefix":{ - "shape":"LogGroupName", - "documentation":"

The prefix to match.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - } - } - }, - "DescribeLogGroupsResponse":{ - "type":"structure", - "members":{ - "logGroups":{ - "shape":"LogGroups", - "documentation":"

The log groups.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeLogStreamsRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamNamePrefix":{ - "shape":"LogStreamName", - "documentation":"

The prefix to match.

If orderBy is LastEventTime,you cannot specify this parameter.

" - }, - "orderBy":{ - "shape":"OrderBy", - "documentation":"

If the value is LogStreamName, the results are ordered by log stream name. If the value is LastEventTime, the results are ordered by the event time. The default value is LogStreamName.

If you order the results by event time, you cannot specify the logStreamNamePrefix parameter.

lastEventTimestamp represents the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.

" - }, - "descending":{ - "shape":"Descending", - "documentation":"

If the value is true, results are returned in descending order. If the value is to false, results are returned in ascending order. The default value is false.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - } - } - }, - "DescribeLogStreamsResponse":{ - "type":"structure", - "members":{ - "logStreams":{ - "shape":"LogStreams", - "documentation":"

The log streams.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeMetricFiltersRequest":{ - "type":"structure", - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterNamePrefix":{ - "shape":"FilterName", - "documentation":"

The prefix to match.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - }, - "metricName":{ - "shape":"MetricName", - "documentation":"

Filters results to include only those with the specified metric name. If you include this parameter in your request, you must also include the metricNamespace parameter.

" - }, - "metricNamespace":{ - "shape":"MetricNamespace", - "documentation":"

Filters results to include only those in the specified namespace. If you include this parameter in your request, you must also include the metricName parameter.

" - } - } - }, - "DescribeMetricFiltersResponse":{ - "type":"structure", - "members":{ - "metricFilters":{ - "shape":"MetricFilters", - "documentation":"

The metric filters.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeResourcePoliciesRequest":{ - "type":"structure", - "members":{ - "nextToken":{"shape":"NextToken"}, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of resource policies to be displayed with one call of this API.

" - } - } - }, - "DescribeResourcePoliciesResponse":{ - "type":"structure", - "members":{ - "resourcePolicies":{ - "shape":"ResourcePolicies", - "documentation":"

The resource policies that exist in this account.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "DescribeSubscriptionFiltersRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterNamePrefix":{ - "shape":"FilterName", - "documentation":"

The prefix to match. If you don't specify a value, no prefix filter is applied.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"DescribeLimit", - "documentation":"

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

" - } - } - }, - "DescribeSubscriptionFiltersResponse":{ - "type":"structure", - "members":{ - "subscriptionFilters":{ - "shape":"SubscriptionFilters", - "documentation":"

The subscription filters.

" - }, - "nextToken":{"shape":"NextToken"} - } - }, - "Destination":{ - "type":"structure", - "members":{ - "destinationName":{ - "shape":"DestinationName", - "documentation":"

The name of the destination.

" - }, - "targetArn":{ - "shape":"TargetArn", - "documentation":"

The Amazon Resource Name (ARN) of the physical target to where the log events are delivered (for example, a Kinesis stream).

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

A role for impersonation, used when delivering log events to the target.

" - }, - "accessPolicy":{ - "shape":"AccessPolicy", - "documentation":"

An IAM policy document that governs which AWS accounts can create subscription filters against this destination.

" - }, - "arn":{ - "shape":"Arn", - "documentation":"

The ARN of this destination.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the destination, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - } - }, - "documentation":"

Represents a cross-account destination that receives subscription log events.

" - }, - "DestinationArn":{ - "type":"string", - "min":1 - }, - "DestinationName":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[^:*]*" - }, - "Destinations":{ - "type":"list", - "member":{"shape":"Destination"} - }, - "DisassociateKmsKeyRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - } - } - }, - "Distribution":{ - "type":"string", - "documentation":"

The method used to distribute log data to the destination, which can be either random or grouped by log stream.

", - "enum":[ - "Random", - "ByLogStream" - ] - }, - "EventId":{"type":"string"}, - "EventMessage":{ - "type":"string", - "min":1 - }, - "EventNumber":{"type":"long"}, - "EventsLimit":{ - "type":"integer", - "max":10000, - "min":1 - }, - "ExportDestinationBucket":{ - "type":"string", - "max":512, - "min":1 - }, - "ExportDestinationPrefix":{"type":"string"}, - "ExportTask":{ - "type":"structure", - "members":{ - "taskId":{ - "shape":"ExportTaskId", - "documentation":"

The ID of the export task.

" - }, - "taskName":{ - "shape":"ExportTaskName", - "documentation":"

The name of the export task.

" - }, - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group from which logs data was exported.

" - }, - "from":{ - "shape":"Timestamp", - "documentation":"

The start time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp before this time are not exported.

" - }, - "to":{ - "shape":"Timestamp", - "documentation":"

The end time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp later than this time are not exported.

" - }, - "destination":{ - "shape":"ExportDestinationBucket", - "documentation":"

The name of Amazon S3 bucket to which the log data was exported.

" - }, - "destinationPrefix":{ - "shape":"ExportDestinationPrefix", - "documentation":"

The prefix that was used as the start of Amazon S3 key for every object exported.

" - }, - "status":{ - "shape":"ExportTaskStatus", - "documentation":"

The status of the export task.

" - }, - "executionInfo":{ - "shape":"ExportTaskExecutionInfo", - "documentation":"

Execution info about the export task.

" - } - }, - "documentation":"

Represents an export task.

" - }, - "ExportTaskExecutionInfo":{ - "type":"structure", - "members":{ - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "completionTime":{ - "shape":"Timestamp", - "documentation":"

The completion time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - } - }, - "documentation":"

Represents the status of an export task.

" - }, - "ExportTaskId":{ - "type":"string", - "max":512, - "min":1 - }, - "ExportTaskName":{ - "type":"string", - "max":512, - "min":1 - }, - "ExportTaskStatus":{ - "type":"structure", - "members":{ - "code":{ - "shape":"ExportTaskStatusCode", - "documentation":"

The status code of the export task.

" - }, - "message":{ - "shape":"ExportTaskStatusMessage", - "documentation":"

The status message related to the status code.

" - } - }, - "documentation":"

Represents the status of an export task.

" - }, - "ExportTaskStatusCode":{ - "type":"string", - "enum":[ - "CANCELLED", - "COMPLETED", - "FAILED", - "PENDING", - "PENDING_CANCEL", - "RUNNING" - ] - }, - "ExportTaskStatusMessage":{"type":"string"}, - "ExportTasks":{ - "type":"list", - "member":{"shape":"ExportTask"} - }, - "ExtractedValues":{ - "type":"map", - "key":{"shape":"Token"}, - "value":{"shape":"Value"} - }, - "FilterCount":{"type":"integer"}, - "FilterLogEventsRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamNames":{ - "shape":"InputLogStreamNames", - "documentation":"

Optional list of log stream names.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

The start of the time range, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp before this time are not returned.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time range, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp later than this time are not returned.

" - }, - "filterPattern":{ - "shape":"FilterPattern", - "documentation":"

The filter pattern to use. If not provided, all the events are matched.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of events to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"EventsLimit", - "documentation":"

The maximum number of events to return. The default is 10,000 events.

" - }, - "interleaved":{ - "shape":"Interleaved", - "documentation":"

If the value is true, the operation makes a best effort to provide responses that contain events from multiple log streams within the log group, interleaved in a single response. If the value is false, all the matched log events in the first log stream are searched first, then those in the next log stream, and so on. The default is false.

" - } - } - }, - "FilterLogEventsResponse":{ - "type":"structure", - "members":{ - "events":{ - "shape":"FilteredLogEvents", - "documentation":"

The matched events.

" - }, - "searchedLogStreams":{ - "shape":"SearchedLogStreams", - "documentation":"

Indicates which log streams have been searched and whether each has been searched completely.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. The token expires after 24 hours.

" - } - } - }, - "FilterName":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[^:*]*" - }, - "FilterPattern":{ - "type":"string", - "documentation":"

A symbolic description of how CloudWatch Logs should interpret the data in each log event. For example, a log event may contain time stamps, IP addresses, strings, and so on. You use the filter pattern to specify what to look for in the log event message.

", - "max":1024, - "min":0 - }, - "FilteredLogEvent":{ - "type":"structure", - "members":{ - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream this event belongs to.

" - }, - "timestamp":{ - "shape":"Timestamp", - "documentation":"

The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "message":{ - "shape":"EventMessage", - "documentation":"

The data contained in the log event.

" - }, - "ingestionTime":{ - "shape":"Timestamp", - "documentation":"

The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "eventId":{ - "shape":"EventId", - "documentation":"

The ID of the event.

" - } - }, - "documentation":"

Represents a matched event.

" - }, - "FilteredLogEvents":{ - "type":"list", - "member":{"shape":"FilteredLogEvent"} - }, - "GetLogEventsRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "logStreamName" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - }, - "startTime":{ - "shape":"Timestamp", - "documentation":"

The start of the time range, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp equal to this time or later than this time are included. Events with a time stamp earlier than this time are not included.

" - }, - "endTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time range, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp equal to or later than this time are not included.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "limit":{ - "shape":"EventsLimit", - "documentation":"

The maximum number of log events returned. If you don't specify a value, the maximum is as many log events as can fit in a response size of 1 MB, up to 10,000 log events.

" - }, - "startFromHead":{ - "shape":"StartFromHead", - "documentation":"

If the value is true, the earliest log events are returned first. If the value is false, the latest log events are returned first. The default value is false.

" - } - } - }, - "GetLogEventsResponse":{ - "type":"structure", - "members":{ - "events":{ - "shape":"OutputLogEvents", - "documentation":"

The events.

" - }, - "nextForwardToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items in the forward direction. The token expires after 24 hours. If you have reached the end of the stream, it will return the same token you passed in.

" - }, - "nextBackwardToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items in the backward direction. The token expires after 24 hours. This token will never be null. If you have reached the end of the stream, it will return the same token you passed in.

" - } - } - }, - "InputLogEvent":{ - "type":"structure", - "required":[ - "timestamp", - "message" - ], - "members":{ - "timestamp":{ - "shape":"Timestamp", - "documentation":"

The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "message":{ - "shape":"EventMessage", - "documentation":"

The raw event message.

" - } - }, - "documentation":"

Represents a log event, which is a record of activity that was recorded by the application or resource being monitored.

" - }, - "InputLogEvents":{ - "type":"list", - "member":{"shape":"InputLogEvent"}, - "max":10000, - "min":1 - }, - "InputLogStreamNames":{ - "type":"list", - "member":{"shape":"LogStreamName"}, - "max":100, - "min":1 - }, - "Interleaved":{"type":"boolean"}, - "InvalidOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation is not valid on the specified resource.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A parameter is specified incorrectly.

", - "exception":true - }, - "InvalidSequenceTokenException":{ - "type":"structure", - "members":{ - "expectedSequenceToken":{"shape":"SequenceToken"} - }, - "documentation":"

The sequence token is not valid.

", - "exception":true - }, - "KmsKeyId":{ - "type":"string", - "max":256 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have reached the maximum number of resources that can be created.

", - "exception":true - }, - "ListTagsLogGroupRequest":{ - "type":"structure", - "required":["logGroupName"], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - } - } - }, - "ListTagsLogGroupResponse":{ - "type":"structure", - "members":{ - "tags":{ - "shape":"Tags", - "documentation":"

The tags for the log group.

" - } - } - }, - "LogEventIndex":{"type":"integer"}, - "LogGroup":{ - "type":"structure", - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the log group, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "retentionInDays":{"shape":"Days"}, - "metricFilterCount":{ - "shape":"FilterCount", - "documentation":"

The number of metric filters.

" - }, - "arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the log group.

" - }, - "storedBytes":{ - "shape":"StoredBytes", - "documentation":"

The number of bytes stored.

" - }, - "kmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data.

" - } - }, - "documentation":"

Represents a log group.

" - }, - "LogGroupName":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[\\.\\-_/#A-Za-z0-9]+" - }, - "LogGroups":{ - "type":"list", - "member":{"shape":"LogGroup"} - }, - "LogStream":{ - "type":"structure", - "members":{ - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the stream, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "firstEventTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time of the first event, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "lastEventTimestamp":{ - "shape":"Timestamp", - "documentation":"

the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.

" - }, - "lastIngestionTime":{ - "shape":"Timestamp", - "documentation":"

The ingestion time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "uploadSequenceToken":{ - "shape":"SequenceToken", - "documentation":"

The sequence token.

" - }, - "arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the log stream.

" - }, - "storedBytes":{ - "shape":"StoredBytes", - "documentation":"

The number of bytes stored.

" - } - }, - "documentation":"

Represents a log stream, which is a sequence of log events from a single emitter of logs.

" - }, - "LogStreamName":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[^:*]*" - }, - "LogStreamSearchedCompletely":{"type":"boolean"}, - "LogStreams":{ - "type":"list", - "member":{"shape":"LogStream"} - }, - "MetricFilter":{ - "type":"structure", - "members":{ - "filterName":{ - "shape":"FilterName", - "documentation":"

The name of the metric filter.

" - }, - "filterPattern":{"shape":"FilterPattern"}, - "metricTransformations":{ - "shape":"MetricTransformations", - "documentation":"

The metric transformations.

" - }, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the metric filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - } - }, - "documentation":"

Metric filters express how CloudWatch Logs would extract metric observations from ingested log events and transform them into metric data in a CloudWatch metric.

" - }, - "MetricFilterMatchRecord":{ - "type":"structure", - "members":{ - "eventNumber":{ - "shape":"EventNumber", - "documentation":"

The event number.

" - }, - "eventMessage":{ - "shape":"EventMessage", - "documentation":"

The raw event data.

" - }, - "extractedValues":{ - "shape":"ExtractedValues", - "documentation":"

The values extracted from the event data by the filter.

" - } - }, - "documentation":"

Represents a matched event.

" - }, - "MetricFilterMatches":{ - "type":"list", - "member":{"shape":"MetricFilterMatchRecord"} - }, - "MetricFilters":{ - "type":"list", - "member":{"shape":"MetricFilter"} - }, - "MetricName":{ - "type":"string", - "documentation":"

The name of the CloudWatch metric to which the monitored log information should be published. For example, you may publish to a metric called ErrorCount.

", - "max":255, - "pattern":"[^:*$]*" - }, - "MetricNamespace":{ - "type":"string", - "max":255, - "pattern":"[^:*$]*" - }, - "MetricTransformation":{ - "type":"structure", - "required":[ - "metricName", - "metricNamespace", - "metricValue" - ], - "members":{ - "metricName":{ - "shape":"MetricName", - "documentation":"

The name of the CloudWatch metric.

" - }, - "metricNamespace":{ - "shape":"MetricNamespace", - "documentation":"

The namespace of the CloudWatch metric.

" - }, - "metricValue":{ - "shape":"MetricValue", - "documentation":"

The value to publish to the CloudWatch metric when a filter pattern matches a log event.

" - }, - "defaultValue":{ - "shape":"DefaultValue", - "documentation":"

(Optional) The value to emit when a filter pattern does not match a log event. This value can be null.

" - } - }, - "documentation":"

Indicates how to transform ingested log events in to metric data in a CloudWatch metric.

" - }, - "MetricTransformations":{ - "type":"list", - "member":{"shape":"MetricTransformation"}, - "max":1, - "min":1 - }, - "MetricValue":{ - "type":"string", - "documentation":"

The value to publish to the CloudWatch metric. For example, if you're counting the occurrences of a term like \"Error\", the value is \"1\" for each occurrence. If you're counting the bytes transferred, the value is the value in the log event.

", - "max":100 - }, - "NextToken":{ - "type":"string", - "documentation":"

The token for the next set of items to return. The token expires after 24 hours.

", - "min":1 - }, - "OperationAbortedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Multiple requests to update the same resource were in conflict.

", - "exception":true - }, - "OrderBy":{ - "type":"string", - "enum":[ - "LogStreamName", - "LastEventTime" - ] - }, - "OutputLogEvent":{ - "type":"structure", - "members":{ - "timestamp":{ - "shape":"Timestamp", - "documentation":"

The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - }, - "message":{ - "shape":"EventMessage", - "documentation":"

The data contained in the log event.

" - }, - "ingestionTime":{ - "shape":"Timestamp", - "documentation":"

The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - } - }, - "documentation":"

Represents a log event.

" - }, - "OutputLogEvents":{ - "type":"list", - "member":{"shape":"OutputLogEvent"} - }, - "PolicyDocument":{ - "type":"string", - "max":5120, - "min":1 - }, - "PolicyName":{"type":"string"}, - "PutDestinationPolicyRequest":{ - "type":"structure", - "required":[ - "destinationName", - "accessPolicy" - ], - "members":{ - "destinationName":{ - "shape":"DestinationName", - "documentation":"

A name for an existing destination.

" - }, - "accessPolicy":{ - "shape":"AccessPolicy", - "documentation":"

An IAM policy document that authorizes cross-account users to deliver their log events to the associated destination.

" - } - } - }, - "PutDestinationRequest":{ - "type":"structure", - "required":[ - "destinationName", - "targetArn", - "roleArn" - ], - "members":{ - "destinationName":{ - "shape":"DestinationName", - "documentation":"

A name for the destination.

" - }, - "targetArn":{ - "shape":"TargetArn", - "documentation":"

The ARN of an Amazon Kinesis stream to which to deliver matching log events.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis PutRecord operation on the destination stream.

" - } - } - }, - "PutDestinationResponse":{ - "type":"structure", - "members":{ - "destination":{ - "shape":"Destination", - "documentation":"

The destination.

" - } - } - }, - "PutLogEventsRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "logStreamName", - "logEvents" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - }, - "logEvents":{ - "shape":"InputLogEvents", - "documentation":"

The log events.

" - }, - "sequenceToken":{ - "shape":"SequenceToken", - "documentation":"

The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.

" - } - } - }, - "PutLogEventsResponse":{ - "type":"structure", - "members":{ - "nextSequenceToken":{ - "shape":"SequenceToken", - "documentation":"

The next sequence token.

" - }, - "rejectedLogEventsInfo":{ - "shape":"RejectedLogEventsInfo", - "documentation":"

The rejected events.

" - } - } - }, - "PutMetricFilterRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "filterName", - "filterPattern", - "metricTransformations" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterName":{ - "shape":"FilterName", - "documentation":"

A name for the metric filter.

" - }, - "filterPattern":{ - "shape":"FilterPattern", - "documentation":"

A filter pattern for extracting metric data out of ingested log events.

" - }, - "metricTransformations":{ - "shape":"MetricTransformations", - "documentation":"

A collection of information that defines how metric data gets emitted.

" - } - } - }, - "PutResourcePolicyRequest":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

Name of the new policy. This parameter is required.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

Details of the new policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string.

The following example creates a resource policy enabling the Route 53 service to put DNS query logs in to the specified log group. Replace \"logArn\" with the ARN of your CloudWatch Logs resource, such as a log group or log stream.

{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"Route53LogsToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"route53.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"logArn\" } ] }

" - } - } - }, - "PutResourcePolicyResponse":{ - "type":"structure", - "members":{ - "resourcePolicy":{ - "shape":"ResourcePolicy", - "documentation":"

The new policy.

" - } - } - }, - "PutRetentionPolicyRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "retentionInDays" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "retentionInDays":{"shape":"Days"} - } - }, - "PutSubscriptionFilterRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "filterName", - "filterPattern", - "destinationArn" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterName":{ - "shape":"FilterName", - "documentation":"

A name for the subscription filter. If you are updating an existing filter, you must specify the correct name in filterName. Otherwise, the call fails because you cannot associate a second filter with a log group. To find the name of the filter currently associated with a log group, use DescribeSubscriptionFilters.

" - }, - "filterPattern":{ - "shape":"FilterPattern", - "documentation":"

A filter pattern for subscribing to a filtered stream of log events.

" - }, - "destinationArn":{ - "shape":"DestinationArn", - "documentation":"

The ARN of the destination to deliver matching log events to. Currently, the supported destinations are:

  • An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.

  • A logical destination (specified using an ARN) belonging to a different account, for cross-account delivery.

  • An Amazon Kinesis Firehose delivery stream belonging to the same account as the subscription filter, for same-account delivery.

  • An AWS Lambda function belonging to the same account as the subscription filter, for same-account delivery.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of an IAM role that grants CloudWatch Logs permissions to deliver ingested log events to the destination stream. You don't need to provide the ARN when you are working with a logical destination for cross-account delivery.

" - }, - "distribution":{ - "shape":"Distribution", - "documentation":"

The method used to distribute log data to the destination. By default log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream.

" - } - } - }, - "RejectedLogEventsInfo":{ - "type":"structure", - "members":{ - "tooNewLogEventStartIndex":{ - "shape":"LogEventIndex", - "documentation":"

The log events that are too new.

" - }, - "tooOldLogEventEndIndex":{ - "shape":"LogEventIndex", - "documentation":"

The log events that are too old.

" - }, - "expiredLogEventEndIndex":{ - "shape":"LogEventIndex", - "documentation":"

The expired log events.

" - } - }, - "documentation":"

Represents the rejected events.

" - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource already exists.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource does not exist.

", - "exception":true - }, - "ResourcePolicies":{ - "type":"list", - "member":{"shape":"ResourcePolicy"} - }, - "ResourcePolicy":{ - "type":"structure", - "members":{ - "policyName":{ - "shape":"PolicyName", - "documentation":"

The name of the resource policy.

" - }, - "policyDocument":{ - "shape":"PolicyDocument", - "documentation":"

The details of the policy.

" - }, - "lastUpdatedTime":{ - "shape":"Timestamp", - "documentation":"

Time stamp showing when this policy was last updated, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - } - }, - "documentation":"

A policy enabling one or more entities to put logs to a log group in this account.

" - }, - "RoleArn":{ - "type":"string", - "min":1 - }, - "SearchedLogStream":{ - "type":"structure", - "members":{ - "logStreamName":{ - "shape":"LogStreamName", - "documentation":"

The name of the log stream.

" - }, - "searchedCompletely":{ - "shape":"LogStreamSearchedCompletely", - "documentation":"

Indicates whether all the events in this log stream were searched.

" - } - }, - "documentation":"

Represents the search status of a log stream.

" - }, - "SearchedLogStreams":{ - "type":"list", - "member":{"shape":"SearchedLogStream"} - }, - "SequenceToken":{ - "type":"string", - "min":1 - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The service cannot complete the request.

", - "exception":true, - "fault":true - }, - "StartFromHead":{"type":"boolean"}, - "StoredBytes":{ - "type":"long", - "min":0 - }, - "SubscriptionFilter":{ - "type":"structure", - "members":{ - "filterName":{ - "shape":"FilterName", - "documentation":"

The name of the subscription filter.

" - }, - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "filterPattern":{"shape":"FilterPattern"}, - "destinationArn":{ - "shape":"DestinationArn", - "documentation":"

The Amazon Resource Name (ARN) of the destination.

" - }, - "roleArn":{ - "shape":"RoleArn", - "documentation":"

" - }, - "distribution":{"shape":"Distribution"}, - "creationTime":{ - "shape":"Timestamp", - "documentation":"

The creation time of the subscription filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

" - } - }, - "documentation":"

Represents a subscription filter.

" - }, - "SubscriptionFilters":{ - "type":"list", - "member":{"shape":"SubscriptionFilter"} - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]+)$" - }, - "TagList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "min":1 - }, - "TagLogGroupRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "tags" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "tags":{ - "shape":"Tags", - "documentation":"

The key-value pairs to use for the tags.

" - } - } - }, - "TagValue":{ - "type":"string", - "max":256, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"}, - "max":50, - "min":1 - }, - "TargetArn":{ - "type":"string", - "min":1 - }, - "TestEventMessages":{ - "type":"list", - "member":{"shape":"EventMessage"}, - "max":50, - "min":1 - }, - "TestMetricFilterRequest":{ - "type":"structure", - "required":[ - "filterPattern", - "logEventMessages" - ], - "members":{ - "filterPattern":{"shape":"FilterPattern"}, - "logEventMessages":{ - "shape":"TestEventMessages", - "documentation":"

The log event messages to test.

" - } - } - }, - "TestMetricFilterResponse":{ - "type":"structure", - "members":{ - "matches":{ - "shape":"MetricFilterMatches", - "documentation":"

The matched events.

" - } - } - }, - "Timestamp":{ - "type":"long", - "min":0 - }, - "Token":{"type":"string"}, - "UnrecognizedClientException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The most likely cause is an invalid AWS access key ID or secret key.

", - "exception":true - }, - "UntagLogGroupRequest":{ - "type":"structure", - "required":[ - "logGroupName", - "tags" - ], - "members":{ - "logGroupName":{ - "shape":"LogGroupName", - "documentation":"

The name of the log group.

" - }, - "tags":{ - "shape":"TagList", - "documentation":"

The tag keys. The corresponding tags are removed from the log group.

" - } - } - }, - "Value":{"type":"string"} - }, - "documentation":"

You can use Amazon CloudWatch Logs to monitor, store, and access your log files from Amazon EC2 instances, AWS CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the AWS CLI, CloudWatch Logs API, or CloudWatch Logs SDK.

You can use CloudWatch Logs to:

  • Monitor logs from EC2 instances in real-time: You can use CloudWatch Logs to monitor applications and systems using log data. For example, CloudWatch Logs can track the number of errors that occur in your application logs and send you a notification whenever the rate of errors exceeds a threshold that you specify. CloudWatch Logs uses your log data for monitoring; so, no code changes are required. For example, you can monitor application logs for specific literal terms (such as \"NullReferenceException\") or count the number of occurrences of a literal term at a particular position in log data (such as \"404\" status codes in an Apache access log). When the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch metric that you specify.

  • Monitor AWS CloudTrail logged events: You can create alarms in CloudWatch and receive notifications of particular API activity as captured by CloudTrail and use the notification to perform troubleshooting.

  • Archive log data: You can use CloudWatch Logs to store your log data in highly durable storage. You can change the log retention setting so that any log events older than this setting are automatically deleted. The CloudWatch Logs agent makes it easy to quickly send both rotated and non-rotated log data off of a host and into the log service. You can then access the raw log data when you need it.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/examples-1.json deleted file mode 100644 index faff7689..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version":"1.0", - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/paginators-1.json deleted file mode 100644 index c13ce65a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "DescribeBatchPredictions": { - "limit_key": "Limit", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Results" - }, - "DescribeDataSources": { - "limit_key": "Limit", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Results" - }, - "DescribeEvaluations": { - "limit_key": "Limit", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Results" - }, - "DescribeMLModels": { - "limit_key": "Limit", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Results" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/service-2.json deleted file mode 100644 index 5e849383..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/service-2.json +++ /dev/null @@ -1,3144 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"machinelearning-2014-12-12", - "apiVersion":"2014-12-12", - "endpointPrefix":"machinelearning", - "jsonVersion":"1.1", - "serviceFullName":"Amazon Machine Learning", - "serviceId":"Machine Learning", - "signatureVersion":"v4", - "targetPrefix":"AmazonML_20141212", - "protocol":"json" - }, - "documentation":"Definition of the public APIs exposed by Amazon Machine Learning", - "operations":{ - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsInput"}, - "output":{ - "shape":"AddTagsOutput", - "documentation":"

Amazon ML returns the following elements.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InvalidTagException", - "exception":true - }, - { - "shape":"TagLimitExceededException", - "exception":true - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Adds one or more tags to an object, up to a limit of 10. Each tag consists of a key and an optional value. If you add a tag using a key that is already associated with the ML object, AddTags updates the tag's value.

" - }, - "CreateBatchPrediction":{ - "name":"CreateBatchPrediction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBatchPredictionInput"}, - "output":{ - "shape":"CreateBatchPredictionOutput", - "documentation":"

Represents the output of a CreateBatchPrediction operation, and is an acknowledgement that Amazon ML received the request.

The CreateBatchPrediction operation is asynchronous. You can poll for status updates by using the >GetBatchPrediction operation and checking the Status parameter of the result.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Generates predictions for a group of observations. The observations to process exist in one or more data files referenced by a DataSource. This operation creates a new BatchPrediction, and uses an MLModel and the data files referenced by the DataSource as information sources.

CreateBatchPrediction is an asynchronous operation. In response to CreateBatchPrediction, Amazon Machine Learning (Amazon ML) immediately returns and sets the BatchPrediction status to PENDING. After the BatchPrediction completes, Amazon ML sets the status to COMPLETED.

You can poll for status updates by using the GetBatchPrediction operation and checking the Status parameter of the result. After the COMPLETED status appears, the results are available in the location specified by the OutputUri parameter.

" - }, - "CreateDataSourceFromRDS":{ - "name":"CreateDataSourceFromRDS", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDataSourceFromRDSInput"}, - "output":{ - "shape":"CreateDataSourceFromRDSOutput", - "documentation":"

Represents the output of a CreateDataSourceFromRDS operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromRDS> operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter. You can inspect the Message when Status shows up as FAILED. You can also check the progress of the copy operation by going to the DataPipeline console and looking up the pipeline using the pipelineId from the describe call.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Creates a DataSource object from an Amazon Relational Database Service (Amazon RDS). A DataSource references data that can be used to perform CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations.

CreateDataSourceFromRDS is an asynchronous operation. In response to CreateDataSourceFromRDS, Amazon Machine Learning (Amazon ML) immediately returns and sets the DataSource status to PENDING. After the DataSource is created and ready for use, Amazon ML sets the Status parameter to COMPLETED. DataSource in the COMPLETED or PENDING state can be used only to perform >CreateMLModel>, CreateEvaluation, or CreateBatchPrediction operations.

If Amazon ML cannot accept the input source, it sets the Status parameter to FAILED and includes an error message in the Message attribute of the GetDataSource operation response.

" - }, - "CreateDataSourceFromRedshift":{ - "name":"CreateDataSourceFromRedshift", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDataSourceFromRedshiftInput"}, - "output":{ - "shape":"CreateDataSourceFromRedshiftOutput", - "documentation":"

Represents the output of a CreateDataSourceFromRedshift operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromRedshift operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Creates a DataSource from a database hosted on an Amazon Redshift cluster. A DataSource references data that can be used to perform either CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations.

CreateDataSourceFromRedshift is an asynchronous operation. In response to CreateDataSourceFromRedshift, Amazon Machine Learning (Amazon ML) immediately returns and sets the DataSource status to PENDING. After the DataSource is created and ready for use, Amazon ML sets the Status parameter to COMPLETED. DataSource in COMPLETED or PENDING states can be used to perform only CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations.

If Amazon ML can't accept the input source, it sets the Status parameter to FAILED and includes an error message in the Message attribute of the GetDataSource operation response.

The observations should be contained in the database hosted on an Amazon Redshift cluster and should be specified by a SelectSqlQuery query. Amazon ML executes an Unload command in Amazon Redshift to transfer the result set of the SelectSqlQuery query to S3StagingLocation.

After the DataSource has been created, it's ready for use in evaluations and batch predictions. If you plan to use the DataSource to train an MLModel, the DataSource also requires a recipe. A recipe describes how each input variable will be used in training an MLModel. Will the variable be included or excluded from training? Will the variable be manipulated; for example, will it be combined with another variable or will it be split apart into word combinations? The recipe provides answers to these questions.

You can't change an existing datasource, but you can copy and modify the settings from an existing Amazon Redshift datasource to create a new datasource. To do so, call GetDataSource for an existing datasource and copy the values to a CreateDataSource call. Change the settings that you want to change and make sure that all required fields have the appropriate values.

" - }, - "CreateDataSourceFromS3":{ - "name":"CreateDataSourceFromS3", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDataSourceFromS3Input"}, - "output":{ - "shape":"CreateDataSourceFromS3Output", - "documentation":"

Represents the output of a CreateDataSourceFromS3 operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromS3 operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Creates a DataSource object. A DataSource references data that can be used to perform CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations.

CreateDataSourceFromS3 is an asynchronous operation. In response to CreateDataSourceFromS3, Amazon Machine Learning (Amazon ML) immediately returns and sets the DataSource status to PENDING. After the DataSource has been created and is ready for use, Amazon ML sets the Status parameter to COMPLETED. DataSource in the COMPLETED or PENDING state can be used to perform only CreateMLModel, CreateEvaluation or CreateBatchPrediction operations.

If Amazon ML can't accept the input source, it sets the Status parameter to FAILED and includes an error message in the Message attribute of the GetDataSource operation response.

The observation data used in a DataSource should be ready to use; that is, it should have a consistent structure, and missing data values should be kept to a minimum. The observation data must reside in one or more .csv files in an Amazon Simple Storage Service (Amazon S3) location, along with a schema that describes the data items by name and type. The same schema must be used for all of the data files referenced by the DataSource.

After the DataSource has been created, it's ready to use in evaluations and batch predictions. If you plan to use the DataSource to train an MLModel, the DataSource also needs a recipe. A recipe describes how each input variable will be used in training an MLModel. Will the variable be included or excluded from training? Will the variable be manipulated; for example, will it be combined with another variable or will it be split apart into word combinations? The recipe provides answers to these questions.

" - }, - "CreateEvaluation":{ - "name":"CreateEvaluation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEvaluationInput"}, - "output":{ - "shape":"CreateEvaluationOutput", - "documentation":"

Represents the output of a CreateEvaluation operation, and is an acknowledgement that Amazon ML received the request.

CreateEvaluation operation is asynchronous. You can poll for status updates by using the GetEvcaluation operation and checking the Status parameter.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Creates a new Evaluation of an MLModel. An MLModel is evaluated on a set of observations associated to a DataSource. Like a DataSource for an MLModel, the DataSource for an Evaluation contains values for the Target Variable. The Evaluation compares the predicted result for each observation to the actual outcome and provides a summary so that you know how effective the MLModel functions on the test data. Evaluation generates a relevant performance metric, such as BinaryAUC, RegressionRMSE or MulticlassAvgFScore based on the corresponding MLModelType: BINARY, REGRESSION or MULTICLASS.

CreateEvaluation is an asynchronous operation. In response to CreateEvaluation, Amazon Machine Learning (Amazon ML) immediately returns and sets the evaluation status to PENDING. After the Evaluation is created and ready for use, Amazon ML sets the status to COMPLETED.

You can use the GetEvaluation operation to check progress of the evaluation during the creation operation.

" - }, - "CreateMLModel":{ - "name":"CreateMLModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateMLModelInput"}, - "output":{ - "shape":"CreateMLModelOutput", - "documentation":"

Represents the output of a CreateMLModel operation, and is an acknowledgement that Amazon ML received the request.

The CreateMLModel operation is asynchronous. You can poll for status updates by using the GetMLModel operation and checking the Status parameter.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"IdempotentParameterMismatchException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - } - ], - "documentation":"

Creates a new MLModel using the DataSource and the recipe as information sources.

An MLModel is nearly immutable. Users can update only the MLModelName and the ScoreThreshold in an MLModel without creating a new MLModel.

CreateMLModel is an asynchronous operation. In response to CreateMLModel, Amazon Machine Learning (Amazon ML) immediately returns and sets the MLModel status to PENDING. After the MLModel has been created and ready is for use, Amazon ML sets the status to COMPLETED.

You can use the GetMLModel operation to check the progress of the MLModel during the creation operation.

CreateMLModel requires a DataSource with computed statistics, which can be created by setting ComputeStatistics to true in CreateDataSourceFromRDS, CreateDataSourceFromS3, or CreateDataSourceFromRedshift operations.

" - }, - "CreateRealtimeEndpoint":{ - "name":"CreateRealtimeEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRealtimeEndpointInput"}, - "output":{ - "shape":"CreateRealtimeEndpointOutput", - "documentation":"

Represents the output of an CreateRealtimeEndpoint operation.

The result contains the MLModelId and the endpoint information for the MLModel.

The endpoint information includes the URI of the MLModel; that is, the location to send online prediction requests for the specified MLModel.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Creates a real-time endpoint for the MLModel. The endpoint contains the URI of the MLModel; that is, the location to send real-time prediction requests for the specified MLModel.

" - }, - "DeleteBatchPrediction":{ - "name":"DeleteBatchPrediction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBatchPredictionInput"}, - "output":{ - "shape":"DeleteBatchPredictionOutput", - "documentation":"

Represents the output of a DeleteBatchPrediction operation.

You can use the GetBatchPrediction operation and check the value of the Status parameter to see whether a BatchPrediction is marked as DELETED.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Assigns the DELETED status to a BatchPrediction, rendering it unusable.

After using the DeleteBatchPrediction operation, you can use the GetBatchPrediction operation to verify that the status of the BatchPrediction changed to DELETED.

Caution: The result of the DeleteBatchPrediction operation is irreversible.

" - }, - "DeleteDataSource":{ - "name":"DeleteDataSource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDataSourceInput"}, - "output":{ - "shape":"DeleteDataSourceOutput", - "documentation":"

Represents the output of a DeleteDataSource operation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Assigns the DELETED status to a DataSource, rendering it unusable.

After using the DeleteDataSource operation, you can use the GetDataSource operation to verify that the status of the DataSource changed to DELETED.

Caution: The results of the DeleteDataSource operation are irreversible.

" - }, - "DeleteEvaluation":{ - "name":"DeleteEvaluation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEvaluationInput"}, - "output":{ - "shape":"DeleteEvaluationOutput", - "documentation":"

Represents the output of a DeleteEvaluation operation. The output indicates that Amazon Machine Learning (Amazon ML) received the request.

You can use the GetEvaluation operation and check the value of the Status parameter to see whether an Evaluation is marked as DELETED.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Assigns the DELETED status to an Evaluation, rendering it unusable.

After invoking the DeleteEvaluation operation, you can use the GetEvaluation operation to verify that the status of the Evaluation changed to DELETED.

Caution

The results of the DeleteEvaluation operation are irreversible.

" - }, - "DeleteMLModel":{ - "name":"DeleteMLModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMLModelInput"}, - "output":{ - "shape":"DeleteMLModelOutput", - "documentation":"

Represents the output of a DeleteMLModel operation.

You can use the GetMLModel operation and check the value of the Status parameter to see whether an MLModel is marked as DELETED.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Assigns the DELETED status to an MLModel, rendering it unusable.

After using the DeleteMLModel operation, you can use the GetMLModel operation to verify that the status of the MLModel changed to DELETED.

Caution: The result of the DeleteMLModel operation is irreversible.

" - }, - "DeleteRealtimeEndpoint":{ - "name":"DeleteRealtimeEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRealtimeEndpointInput"}, - "output":{ - "shape":"DeleteRealtimeEndpointOutput", - "documentation":"

Represents the output of an DeleteRealtimeEndpoint operation.

The result contains the MLModelId and the endpoint information for the MLModel.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Deletes a real time endpoint of an MLModel.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsInput"}, - "output":{ - "shape":"DeleteTagsOutput", - "documentation":"

Amazon ML returns the following elements.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InvalidTagException", - "exception":true - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Deletes the specified tags associated with an ML object. After this operation is complete, you can't recover deleted tags.

If you specify a tag that doesn't exist, Amazon ML ignores it.

" - }, - "DescribeBatchPredictions":{ - "name":"DescribeBatchPredictions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBatchPredictionsInput"}, - "output":{ - "shape":"DescribeBatchPredictionsOutput", - "documentation":"

Represents the output of a DescribeBatchPredictions operation. The content is essentially a list of BatchPredictions.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a list of BatchPrediction operations that match the search criteria in the request.

" - }, - "DescribeDataSources":{ - "name":"DescribeDataSources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDataSourcesInput"}, - "output":{ - "shape":"DescribeDataSourcesOutput", - "documentation":"

Represents the query results from a DescribeDataSources operation. The content is essentially a list of DataSource.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a list of DataSource that match the search criteria in the request.

" - }, - "DescribeEvaluations":{ - "name":"DescribeEvaluations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEvaluationsInput"}, - "output":{ - "shape":"DescribeEvaluationsOutput", - "documentation":"

Represents the query results from a DescribeEvaluations operation. The content is essentially a list of Evaluation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a list of DescribeEvaluations that match the search criteria in the request.

" - }, - "DescribeMLModels":{ - "name":"DescribeMLModels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMLModelsInput"}, - "output":{ - "shape":"DescribeMLModelsOutput", - "documentation":"

Represents the output of a DescribeMLModels operation. The content is essentially a list of MLModel.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a list of MLModel that match the search criteria in the request.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsInput"}, - "output":{ - "shape":"DescribeTagsOutput", - "documentation":"

Amazon ML returns the following elements.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Describes one or more of the tags for your Amazon ML object.

" - }, - "GetBatchPrediction":{ - "name":"GetBatchPrediction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetBatchPredictionInput"}, - "output":{ - "shape":"GetBatchPredictionOutput", - "documentation":"

Represents the output of a GetBatchPrediction operation and describes a BatchPrediction.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a BatchPrediction that includes detailed metadata, status, and data file information for a Batch Prediction request.

" - }, - "GetDataSource":{ - "name":"GetDataSource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDataSourceInput"}, - "output":{ - "shape":"GetDataSourceOutput", - "documentation":"

Represents the output of a GetDataSource operation and describes a DataSource.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns a DataSource that includes metadata and data file information, as well as the current status of the DataSource.

GetDataSource provides results in normal or verbose format. The verbose format adds the schema description and the list of files pointed to by the DataSource to the normal format.

" - }, - "GetEvaluation":{ - "name":"GetEvaluation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetEvaluationInput"}, - "output":{ - "shape":"GetEvaluationOutput", - "documentation":"

Represents the output of a GetEvaluation operation and describes an Evaluation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns an Evaluation that includes metadata as well as the current status of the Evaluation.

" - }, - "GetMLModel":{ - "name":"GetMLModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMLModelInput"}, - "output":{ - "shape":"GetMLModelOutput", - "documentation":"

Represents the output of a GetMLModel operation, and provides detailed information about a MLModel.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Returns an MLModel that includes detailed metadata, data source information, and the current status of the MLModel.

GetMLModel provides results in normal or verbose format.

" - }, - "Predict":{ - "name":"Predict", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PredictInput"}, - "output":{"shape":"PredictOutput"}, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"LimitExceededException", - "error":{"httpStatusCode":417}, - "exception":true, - "documentation":"

The subscriber exceeded the maximum number of operations. This exception can occur when listing objects such as DataSource.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - { - "shape":"PredictorNotMountedException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

The exception is thrown when a predict request is made to an unmounted MLModel.

" - } - ], - "documentation":"

Generates a prediction for the observation using the specified ML Model.

Note

Not all response parameters will be populated. Whether a response parameter is populated depends on the type of model requested.

" - }, - "UpdateBatchPrediction":{ - "name":"UpdateBatchPrediction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateBatchPredictionInput"}, - "output":{ - "shape":"UpdateBatchPredictionOutput", - "documentation":"

Represents the output of an UpdateBatchPrediction operation.

You can see the updated content by using the GetBatchPrediction operation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Updates the BatchPredictionName of a BatchPrediction.

You can use the GetBatchPrediction operation to view the contents of the updated data element.

" - }, - "UpdateDataSource":{ - "name":"UpdateDataSource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDataSourceInput"}, - "output":{ - "shape":"UpdateDataSourceOutput", - "documentation":"

Represents the output of an UpdateDataSource operation.

You can see the updated content by using the GetBatchPrediction operation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Updates the DataSourceName of a DataSource.

You can use the GetDataSource operation to view the contents of the updated data element.

" - }, - "UpdateEvaluation":{ - "name":"UpdateEvaluation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEvaluationInput"}, - "output":{ - "shape":"UpdateEvaluationOutput", - "documentation":"

Represents the output of an UpdateEvaluation operation.

You can see the updated content by using the GetEvaluation operation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Updates the EvaluationName of an Evaluation.

You can use the GetEvaluation operation to view the contents of the updated data element.

" - }, - "UpdateMLModel":{ - "name":"UpdateMLModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMLModelInput"}, - "output":{ - "shape":"UpdateMLModelOutput", - "documentation":"

Represents the output of an UpdateMLModel operation.

You can see the updated content by using the GetMLModel operation.

" - }, - "errors":[ - { - "shape":"InvalidInputException", - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - { - "shape":"ResourceNotFoundException", - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - { - "shape":"InternalServerException", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - } - ], - "documentation":"

Updates the MLModelName and the ScoreThreshold of an MLModel.

You can use the GetMLModel operation to view the contents of the updated data element.

" - } - }, - "shapes":{ - "AddTagsInput":{ - "type":"structure", - "required":[ - "Tags", - "ResourceId", - "ResourceType" - ], - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

The key-value pairs to use to create tags. If you specify a key without specifying a value, Amazon ML creates a tag with the specified key and a value of null.

" - }, - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the ML object to tag. For example, exampleModelId.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the ML object to tag.

" - } - } - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the ML object that was tagged.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the ML object that was tagged.

" - } - }, - "documentation":"

Amazon ML returns the following elements.

" - }, - "Algorithm":{ - "type":"string", - "enum":["sgd"], - "documentation":"

The function used to train an MLModel. Training choices supported by Amazon ML include the following:

  • SGD - Stochastic Gradient Descent.
  • RandomForest - Random forest of decision trees.
" - }, - "AwsUserArn":{ - "type":"string", - "pattern":"arn:aws:iam::[0-9]+:((user/.+)|(root))", - "documentation":"

An Amazon Web Service (AWS) user account identifier. The account identifier can be an AWS root account or an AWS Identity and Access Management (IAM) user.

" - }, - "BatchPrediction":{ - "type":"structure", - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the BatchPrediction at creation. This value should be identical to the value of the BatchPredictionID in the request.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel that generated predictions for the BatchPrediction request.

" - }, - "BatchPredictionDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the DataSource that points to the group of observations to predict.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account that invoked the BatchPrediction. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the BatchPrediction was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the BatchPrediction. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the BatchPrediction.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The status of the BatchPrediction. This element can have one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to generate predictions for a batch of observations.
  • INPROGRESS - The process is underway.
  • FAILED - The request to perform a batch prediction did not run to completion. It is not usable.
  • COMPLETED - The batch prediction process completed successfully.
  • DELETED - The BatchPrediction is marked as deleted. It is not usable.
" - }, - "OutputUri":{ - "shape":"S3Url", - "documentation":"

The location of an Amazon S3 bucket or directory to receive the operation results. The following substrings are not allowed in the s3 key portion of the outputURI field: ':', '//', '/./', '/../'.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about processing the batch prediction request.

" - }, - "ComputeTime":{"shape":"LongType"}, - "FinishedAt":{"shape":"EpochTime"}, - "StartedAt":{"shape":"EpochTime"}, - "TotalRecordCount":{"shape":"LongType"}, - "InvalidRecordCount":{"shape":"LongType"} - }, - "documentation":"

Represents the output of a GetBatchPrediction operation.

The content consists of the detailed metadata, the status, and the data file information of a Batch Prediction.

" - }, - "BatchPredictionFilterVariable":{ - "type":"string", - "enum":[ - "CreatedAt", - "LastUpdatedAt", - "Status", - "Name", - "IAMUser", - "MLModelId", - "DataSourceId", - "DataURI" - ], - "documentation":"

A list of the variables to use in searching or filtering BatchPrediction.

  • CreatedAt - Sets the search criteria to BatchPrediction creation date.
  • Status - Sets the search criteria to BatchPrediction status.
  • Name - Sets the search criteria to the contents of BatchPrediction Name.
  • IAMUser - Sets the search criteria to the user account that invoked the BatchPrediction creation.
  • MLModelId - Sets the search criteria to the MLModel used in the BatchPrediction.
  • DataSourceId - Sets the search criteria to the DataSource used in the BatchPrediction.
  • DataURI - Sets the search criteria to the data file(s) used in the BatchPrediction. The URL can identify either a file or an Amazon Simple Storage Service (Amazon S3) bucket or directory.
" - }, - "BatchPredictions":{ - "type":"list", - "member":{"shape":"BatchPrediction"} - }, - "ComparatorValue":{ - "type":"string", - "max":1024, - "pattern":".*\\S.*|^$", - "documentation":"

The value specified in a filtering condition. The ComparatorValue becomes the reference value when matching or evaluating data values in filtering and searching functions.

" - }, - "ComputeStatistics":{"type":"boolean"}, - "CreateBatchPredictionInput":{ - "type":"structure", - "required":[ - "BatchPredictionId", - "MLModelId", - "BatchPredictionDataSourceId", - "OutputUri" - ], - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the BatchPrediction.

" - }, - "BatchPredictionName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the BatchPrediction. BatchPredictionName can only use the UTF-8 character set.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel that will generate predictions for the group of observations.

" - }, - "BatchPredictionDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the DataSource that points to the group of observations to predict.

" - }, - "OutputUri":{ - "shape":"S3Url", - "documentation":"

The location of an Amazon Simple Storage Service (Amazon S3) bucket or directory to store the batch prediction results. The following substrings are not allowed in the s3 key portion of the outputURI field: ':', '//', '/./', '/../'.

Amazon ML needs permissions to store and retrieve the logs on your behalf. For information about how to set permissions, see the Amazon Machine Learning Developer Guide.

" - } - } - }, - "CreateBatchPredictionOutput":{ - "type":"structure", - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the BatchPrediction. This value is identical to the value of the BatchPredictionId in the request.

" - } - }, - "documentation":"

Represents the output of a CreateBatchPrediction operation, and is an acknowledgement that Amazon ML received the request.

The CreateBatchPrediction operation is asynchronous. You can poll for status updates by using the >GetBatchPrediction operation and checking the Status parameter of the result.

" - }, - "CreateDataSourceFromRDSInput":{ - "type":"structure", - "required":[ - "DataSourceId", - "RDSData", - "RoleARN" - ], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the DataSource. Typically, an Amazon Resource Number (ARN) becomes the ID for a DataSource.

" - }, - "DataSourceName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the DataSource.

" - }, - "RDSData":{ - "shape":"RDSDataSpec", - "documentation":"

The data specification of an Amazon RDS DataSource:

  • DatabaseInformation -

    • DatabaseName - The name of the Amazon RDS database.
    • InstanceIdentifier - A unique identifier for the Amazon RDS database instance.

  • DatabaseCredentials - AWS Identity and Access Management (IAM) credentials that are used to connect to the Amazon RDS database.

  • ResourceRole - A role (DataPipelineDefaultResourceRole) assumed by an EC2 instance to carry out the copy task from Amazon RDS to Amazon Simple Storage Service (Amazon S3). For more information, see Role templates for data pipelines.

  • ServiceRole - A role (DataPipelineDefaultRole) assumed by the AWS Data Pipeline service to monitor the progress of the copy task from Amazon RDS to Amazon S3. For more information, see Role templates for data pipelines.

  • SecurityInfo - The security information to use to access an RDS DB instance. You need to set up appropriate ingress rules for the security entity IDs provided to allow access to the Amazon RDS instance. Specify a [SubnetId, SecurityGroupIds] pair for a VPC-based RDS DB instance.

  • SelectSqlQuery - A query that is used to retrieve the observation data for the Datasource.

  • S3StagingLocation - The Amazon S3 location for staging Amazon RDS data. The data retrieved from Amazon RDS using SelectSqlQuery is stored in this location.

  • DataSchemaUri - The Amazon S3 location of the DataSchema.

  • DataSchema - A JSON string representing the schema. This is not required if DataSchemaUri is specified.

  • DataRearrangement - A JSON string that represents the splitting and rearrangement requirements for the Datasource.


    Sample - \"{\\\"splitting\\\":{\\\"percentBegin\\\":10,\\\"percentEnd\\\":60}}\"

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The role that Amazon ML assumes on behalf of the user to create and activate a data pipeline in the user's account and copy data using the SelectSqlQuery query from Amazon RDS to Amazon S3.

" - }, - "ComputeStatistics":{ - "shape":"ComputeStatistics", - "documentation":"

The compute statistics for a DataSource. The statistics are generated from the observation data referenced by a DataSource. Amazon ML uses the statistics internally during MLModel training. This parameter must be set to true if the DataSource needs to be used for MLModel training.

" - } - } - }, - "CreateDataSourceFromRDSOutput":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the datasource. This value should be identical to the value of the DataSourceID in the request.

" - } - }, - "documentation":"

Represents the output of a CreateDataSourceFromRDS operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromRDS> operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter. You can inspect the Message when Status shows up as FAILED. You can also check the progress of the copy operation by going to the DataPipeline console and looking up the pipeline using the pipelineId from the describe call.

" - }, - "CreateDataSourceFromRedshiftInput":{ - "type":"structure", - "required":[ - "DataSourceId", - "DataSpec", - "RoleARN" - ], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the DataSource.

" - }, - "DataSourceName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the DataSource.

" - }, - "DataSpec":{ - "shape":"RedshiftDataSpec", - "documentation":"

The data specification of an Amazon Redshift DataSource:

  • DatabaseInformation -

    • DatabaseName - The name of the Amazon Redshift database.
    • ClusterIdentifier - The unique ID for the Amazon Redshift cluster.

  • DatabaseCredentials - The AWS Identity and Access Management (IAM) credentials that are used to connect to the Amazon Redshift database.

  • SelectSqlQuery - The query that is used to retrieve the observation data for the Datasource.

  • S3StagingLocation - The Amazon Simple Storage Service (Amazon S3) location for staging Amazon Redshift data. The data retrieved from Amazon Redshift using the SelectSqlQuery query is stored in this location.

  • DataSchemaUri - The Amazon S3 location of the DataSchema.

  • DataSchema - A JSON string representing the schema. This is not required if DataSchemaUri is specified.

  • DataRearrangement - A JSON string that represents the splitting and rearrangement requirements for the DataSource.

    Sample - \"{\\\"splitting\\\":{\\\"percentBegin\\\":10,\\\"percentEnd\\\":60}}\"

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

A fully specified role Amazon Resource Name (ARN). Amazon ML assumes the role on behalf of the user to create the following:

  • A security group to allow Amazon ML to execute the SelectSqlQuery query on an Amazon Redshift cluster

  • An Amazon S3 bucket policy to grant Amazon ML read/write permissions on the S3StagingLocation

" - }, - "ComputeStatistics":{ - "shape":"ComputeStatistics", - "documentation":"

The compute statistics for a DataSource. The statistics are generated from the observation data referenced by a DataSource. Amazon ML uses the statistics internally during MLModel training. This parameter must be set to true if the DataSource needs to be used for MLModel training.

" - } - } - }, - "CreateDataSourceFromRedshiftOutput":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the datasource. This value should be identical to the value of the DataSourceID in the request.

" - } - }, - "documentation":"

Represents the output of a CreateDataSourceFromRedshift operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromRedshift operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter.

" - }, - "CreateDataSourceFromS3Input":{ - "type":"structure", - "required":[ - "DataSourceId", - "DataSpec" - ], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied identifier that uniquely identifies the DataSource.

" - }, - "DataSourceName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the DataSource.

" - }, - "DataSpec":{ - "shape":"S3DataSpec", - "documentation":"

The data specification of a DataSource:

  • DataLocationS3 - The Amazon S3 location of the observation data.

  • DataSchemaLocationS3 - The Amazon S3 location of the DataSchema.

  • DataSchema - A JSON string representing the schema. This is not required if DataSchemaUri is specified.

  • DataRearrangement - A JSON string that represents the splitting and rearrangement requirements for the Datasource.

    Sample - \"{\\\"splitting\\\":{\\\"percentBegin\\\":10,\\\"percentEnd\\\":60}}\"

" - }, - "ComputeStatistics":{ - "shape":"ComputeStatistics", - "documentation":"

The compute statistics for a DataSource. The statistics are generated from the observation data referenced by a DataSource. Amazon ML uses the statistics internally during MLModel training. This parameter must be set to true if the DataSource needs to be used for MLModel training.

" - } - } - }, - "CreateDataSourceFromS3Output":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the DataSource. This value should be identical to the value of the DataSourceID in the request.

" - } - }, - "documentation":"

Represents the output of a CreateDataSourceFromS3 operation, and is an acknowledgement that Amazon ML received the request.

The CreateDataSourceFromS3 operation is asynchronous. You can poll for updates by using the GetBatchPrediction operation and checking the Status parameter.

" - }, - "CreateEvaluationInput":{ - "type":"structure", - "required":[ - "EvaluationId", - "MLModelId", - "EvaluationDataSourceId" - ], - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the Evaluation.

" - }, - "EvaluationName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the Evaluation.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel to evaluate.

The schema used in creating the MLModel must match the schema of the DataSource used in the Evaluation.

" - }, - "EvaluationDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the DataSource for the evaluation. The schema of the DataSource must match the schema used to create the MLModel.

" - } - } - }, - "CreateEvaluationOutput":{ - "type":"structure", - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The user-supplied ID that uniquely identifies the Evaluation. This value should be identical to the value of the EvaluationId in the request.

" - } - }, - "documentation":"

Represents the output of a CreateEvaluation operation, and is an acknowledgement that Amazon ML received the request.

CreateEvaluation operation is asynchronous. You can poll for status updates by using the GetEvcaluation operation and checking the Status parameter.

" - }, - "CreateMLModelInput":{ - "type":"structure", - "required":[ - "MLModelId", - "MLModelType", - "TrainingDataSourceId" - ], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel.

" - }, - "MLModelName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the MLModel.

" - }, - "MLModelType":{ - "shape":"MLModelType", - "documentation":"

The category of supervised learning that this MLModel will address. Choose from the following types:

  • Choose REGRESSION if the MLModel will be used to predict a numeric value.
  • Choose BINARY if the MLModel result has two possible values.
  • Choose MULTICLASS if the MLModel result has a limited number of values.

For more information, see the Amazon Machine Learning Developer Guide.

" - }, - "Parameters":{ - "shape":"TrainingParameters", - "documentation":"

A list of the training parameters in the MLModel. The list is implemented as a map of key-value pairs.

The following is the current set of training parameters:

  • sgd.maxMLModelSizeInBytes - The maximum allowed size of the model. Depending on the input data, the size of the model might affect its performance.

    The value is an integer that ranges from 100000 to 2147483648. The default value is 33554432.

  • sgd.maxPasses - The number of times that the training process traverses the observations to build the MLModel. The value is an integer that ranges from 1 to 10000. The default value is 10.

  • sgd.shuffleType - Whether Amazon ML shuffles the training data. Shuffling the data improves a model's ability to find the optimal solution for a variety of data types. The valid values are auto and none. The default value is none. We strongly recommend that you shuffle your data.

  • sgd.l1RegularizationAmount - The coefficient regularization L1 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to zero, resulting in a sparse feature set. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L1 normalization. This parameter can't be used when L2 is specified. Use this parameter sparingly.

  • sgd.l2RegularizationAmount - The coefficient regularization L2 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to small, nonzero values. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L2 normalization. This parameter can't be used when L1 is specified. Use this parameter sparingly.

" - }, - "TrainingDataSourceId":{ - "shape":"EntityId", - "documentation":"

The DataSource that points to the training data.

" - }, - "Recipe":{ - "shape":"Recipe", - "documentation":"

The data recipe for creating the MLModel. You must specify either the recipe or its URI. If you don't specify a recipe or its URI, Amazon ML creates a default.

" - }, - "RecipeUri":{ - "shape":"S3Url", - "documentation":"

The Amazon Simple Storage Service (Amazon S3) location and file name that contains the MLModel recipe. You must specify either the recipe or its URI. If you don't specify a recipe or its URI, Amazon ML creates a default.

" - } - } - }, - "CreateMLModelOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel. This value should be identical to the value of the MLModelId in the request.

" - } - }, - "documentation":"

Represents the output of a CreateMLModel operation, and is an acknowledgement that Amazon ML received the request.

The CreateMLModel operation is asynchronous. You can poll for status updates by using the GetMLModel operation and checking the Status parameter.

" - }, - "CreateRealtimeEndpointInput":{ - "type":"structure", - "required":["MLModelId"], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel during creation.

" - } - } - }, - "CreateRealtimeEndpointOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel. This value should be identical to the value of the MLModelId in the request.

" - }, - "RealtimeEndpointInfo":{ - "shape":"RealtimeEndpointInfo", - "documentation":"

The endpoint information of the MLModel

" - } - }, - "documentation":"

Represents the output of an CreateRealtimeEndpoint operation.

The result contains the MLModelId and the endpoint information for the MLModel.

The endpoint information includes the URI of the MLModel; that is, the location to send online prediction requests for the specified MLModel.

" - }, - "DataRearrangement":{"type":"string"}, - "DataSchema":{ - "type":"string", - "max":131071, - "documentation":"

The schema of a DataSource. The DataSchema defines the structure of the observation data in the data file(s) referenced in the DataSource. The DataSource schema is expressed in JSON format.

DataSchema is not required if you specify a DataSchemaUri

{ \"version\": \"1.0\", \"recordAnnotationFieldName\": \"F1\", \"recordWeightFieldName\": \"F2\", \"targetFieldName\": \"F3\", \"dataFormat\": \"CSV\", \"dataFileContainsHeader\": true, \"variables\": [ { \"fieldName\": \"F1\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F2\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F3\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F4\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F5\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F6\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F7\", \"fieldType\": \"WEIGHTED_INT_SEQUENCE\" }, { \"fieldName\": \"F8\", \"fieldType\": \"WEIGHTED_STRING_SEQUENCE\" } ], \"excludedVariableNames\": [ \"F6\" ] }

" - }, - "DataSource":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID that is assigned to the DataSource during creation.

" - }, - "DataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location and name of the data in Amazon Simple Storage Service (Amazon S3) that is used by a DataSource.

" - }, - "DataRearrangement":{ - "shape":"DataRearrangement", - "documentation":"

A JSON string that represents the splitting and rearrangement requirement used when this DataSource was created.

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account from which the DataSource was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the DataSource was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the BatchPrediction. The time is expressed in epoch time.

" - }, - "DataSizeInBytes":{ - "shape":"LongType", - "documentation":"

The total number of observations contained in the data files that the DataSource references.

" - }, - "NumberOfFiles":{ - "shape":"LongType", - "documentation":"

The number of data files referenced by the DataSource.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the DataSource.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The current status of the DataSource. This element can have one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to create a DataSource.
  • INPROGRESS - The creation process is underway.
  • FAILED - The request to create a DataSource did not run to completion. It is not usable.
  • COMPLETED - The creation process completed successfully.
  • DELETED - The DataSource is marked as deleted. It is not usable.
" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about creating the DataSource.

" - }, - "RedshiftMetadata":{"shape":"RedshiftMetadata"}, - "RDSMetadata":{"shape":"RDSMetadata"}, - "RoleARN":{"shape":"RoleARN"}, - "ComputeStatistics":{ - "shape":"ComputeStatistics", - "documentation":"

The parameter is true if statistics need to be generated from the observation data.

" - }, - "ComputeTime":{"shape":"LongType"}, - "FinishedAt":{"shape":"EpochTime"}, - "StartedAt":{"shape":"EpochTime"} - }, - "documentation":"

Represents the output of the GetDataSource operation.

The content consists of the detailed metadata and data file information and the current status of the DataSource.

" - }, - "DataSourceFilterVariable":{ - "type":"string", - "enum":[ - "CreatedAt", - "LastUpdatedAt", - "Status", - "Name", - "DataLocationS3", - "IAMUser" - ], - "documentation":"

A list of the variables to use in searching or filtering DataSource.

  • CreatedAt - Sets the search criteria to DataSource creation date.
  • Status - Sets the search criteria to DataSource status.
  • Name - Sets the search criteria to the contents of DataSource Name.
  • DataUri - Sets the search criteria to the URI of data files used to create the DataSource. The URI can identify either a file or an Amazon Simple Storage Service (Amazon S3) bucket or directory.
  • IAMUser - Sets the search criteria to the user account that invoked the DataSource creation.
Note

The variable names should match the variable names in the DataSource.

" - }, - "DataSources":{ - "type":"list", - "member":{"shape":"DataSource"} - }, - "DeleteBatchPredictionInput":{ - "type":"structure", - "required":["BatchPredictionId"], - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the BatchPrediction.

" - } - } - }, - "DeleteBatchPredictionOutput":{ - "type":"structure", - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the BatchPrediction. This value should be identical to the value of the BatchPredictionID in the request.

" - } - }, - "documentation":"

Represents the output of a DeleteBatchPrediction operation.

You can use the GetBatchPrediction operation and check the value of the Status parameter to see whether a BatchPrediction is marked as DELETED.

" - }, - "DeleteDataSourceInput":{ - "type":"structure", - "required":["DataSourceId"], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the DataSource.

" - } - } - }, - "DeleteDataSourceOutput":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the DataSource. This value should be identical to the value of the DataSourceID in the request.

" - } - }, - "documentation":"

Represents the output of a DeleteDataSource operation.

" - }, - "DeleteEvaluationInput":{ - "type":"structure", - "required":["EvaluationId"], - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the Evaluation to delete.

" - } - } - }, - "DeleteEvaluationOutput":{ - "type":"structure", - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the Evaluation. This value should be identical to the value of the EvaluationId in the request.

" - } - }, - "documentation":"

Represents the output of a DeleteEvaluation operation. The output indicates that Amazon Machine Learning (Amazon ML) received the request.

You can use the GetEvaluation operation and check the value of the Status parameter to see whether an Evaluation is marked as DELETED.

" - }, - "DeleteMLModelInput":{ - "type":"structure", - "required":["MLModelId"], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel.

" - } - } - }, - "DeleteMLModelOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel. This value should be identical to the value of the MLModelID in the request.

" - } - }, - "documentation":"

Represents the output of a DeleteMLModel operation.

You can use the GetMLModel operation and check the value of the Status parameter to see whether an MLModel is marked as DELETED.

" - }, - "DeleteRealtimeEndpointInput":{ - "type":"structure", - "required":["MLModelId"], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel during creation.

" - } - } - }, - "DeleteRealtimeEndpointOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A user-supplied ID that uniquely identifies the MLModel. This value should be identical to the value of the MLModelId in the request.

" - }, - "RealtimeEndpointInfo":{ - "shape":"RealtimeEndpointInfo", - "documentation":"

The endpoint information of the MLModel

" - } - }, - "documentation":"

Represents the output of an DeleteRealtimeEndpoint operation.

The result contains the MLModelId and the endpoint information for the MLModel.

" - }, - "DeleteTagsInput":{ - "type":"structure", - "required":[ - "TagKeys", - "ResourceId", - "ResourceType" - ], - "members":{ - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

One or more tags to delete.

" - }, - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the tagged ML object. For example, exampleModelId.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the tagged ML object.

" - } - } - }, - "DeleteTagsOutput":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the ML object from which tags were deleted.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the ML object from which tags were deleted.

" - } - }, - "documentation":"

Amazon ML returns the following elements.

" - }, - "DescribeBatchPredictionsInput":{ - "type":"structure", - "members":{ - "FilterVariable":{ - "shape":"BatchPredictionFilterVariable", - "documentation":"

Use one of the following variables to filter a list of BatchPrediction:

  • CreatedAt - Sets the search criteria to the BatchPrediction creation date.
  • Status - Sets the search criteria to the BatchPrediction status.
  • Name - Sets the search criteria to the contents of the BatchPrediction Name.
  • IAMUser - Sets the search criteria to the user account that invoked the BatchPrediction creation.
  • MLModelId - Sets the search criteria to the MLModel used in the BatchPrediction.
  • DataSourceId - Sets the search criteria to the DataSource used in the BatchPrediction.
  • DataURI - Sets the search criteria to the data file(s) used in the BatchPrediction. The URL can identify either a file or an Amazon Simple Storage Solution (Amazon S3) bucket or directory.
" - }, - "EQ":{ - "shape":"ComparatorValue", - "documentation":"

The equal to operator. The BatchPrediction results will have FilterVariable values that exactly match the value specified with EQ.

" - }, - "GT":{ - "shape":"ComparatorValue", - "documentation":"

The greater than operator. The BatchPrediction results will have FilterVariable values that are greater than the value specified with GT.

" - }, - "LT":{ - "shape":"ComparatorValue", - "documentation":"

The less than operator. The BatchPrediction results will have FilterVariable values that are less than the value specified with LT.

" - }, - "GE":{ - "shape":"ComparatorValue", - "documentation":"

The greater than or equal to operator. The BatchPrediction results will have FilterVariable values that are greater than or equal to the value specified with GE.

" - }, - "LE":{ - "shape":"ComparatorValue", - "documentation":"

The less than or equal to operator. The BatchPrediction results will have FilterVariable values that are less than or equal to the value specified with LE.

" - }, - "NE":{ - "shape":"ComparatorValue", - "documentation":"

The not equal to operator. The BatchPrediction results will have FilterVariable values not equal to the value specified with NE.

" - }, - "Prefix":{ - "shape":"ComparatorValue", - "documentation":"

A string that is found at the beginning of a variable, such as Name or Id.

For example, a Batch Prediction operation could have the Name 2014-09-09-HolidayGiftMailer. To search for this BatchPrediction, select Name for the FilterVariable and any of the following strings for the Prefix:

  • 2014-09

  • 2014-09-09

  • 2014-09-09-Holiday

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

A two-value parameter that determines the sequence of the resulting list of MLModels.

  • asc - Arranges the list in ascending order (A-Z, 0-9).
  • dsc - Arranges the list in descending order (Z-A, 9-0).

Results are sorted by FilterVariable.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

An ID of the page in the paginated results.

" - }, - "Limit":{ - "shape":"PageLimit", - "documentation":"

The number of pages of information to include in the result. The range of acceptable values is 1 through 100. The default value is 100.

" - } - } - }, - "DescribeBatchPredictionsOutput":{ - "type":"structure", - "members":{ - "Results":{ - "shape":"BatchPredictions", - "documentation":"

A list of BatchPrediction objects that meet the search criteria.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the next page in the paginated results that indicates at least one more page follows.

" - } - }, - "documentation":"

Represents the output of a DescribeBatchPredictions operation. The content is essentially a list of BatchPredictions.

" - }, - "DescribeDataSourcesInput":{ - "type":"structure", - "members":{ - "FilterVariable":{ - "shape":"DataSourceFilterVariable", - "documentation":"

Use one of the following variables to filter a list of DataSource:

  • CreatedAt - Sets the search criteria to DataSource creation dates.
  • Status - Sets the search criteria to DataSource statuses.
  • Name - Sets the search criteria to the contents of DataSource Name.
  • DataUri - Sets the search criteria to the URI of data files used to create the DataSource. The URI can identify either a file or an Amazon Simple Storage Service (Amazon S3) bucket or directory.
  • IAMUser - Sets the search criteria to the user account that invoked the DataSource creation.
" - }, - "EQ":{ - "shape":"ComparatorValue", - "documentation":"

The equal to operator. The DataSource results will have FilterVariable values that exactly match the value specified with EQ.

" - }, - "GT":{ - "shape":"ComparatorValue", - "documentation":"

The greater than operator. The DataSource results will have FilterVariable values that are greater than the value specified with GT.

" - }, - "LT":{ - "shape":"ComparatorValue", - "documentation":"

The less than operator. The DataSource results will have FilterVariable values that are less than the value specified with LT.

" - }, - "GE":{ - "shape":"ComparatorValue", - "documentation":"

The greater than or equal to operator. The DataSource results will have FilterVariable values that are greater than or equal to the value specified with GE.

" - }, - "LE":{ - "shape":"ComparatorValue", - "documentation":"

The less than or equal to operator. The DataSource results will have FilterVariable values that are less than or equal to the value specified with LE.

" - }, - "NE":{ - "shape":"ComparatorValue", - "documentation":"

The not equal to operator. The DataSource results will have FilterVariable values not equal to the value specified with NE.

" - }, - "Prefix":{ - "shape":"ComparatorValue", - "documentation":"

A string that is found at the beginning of a variable, such as Name or Id.

For example, a DataSource could have the Name 2014-09-09-HolidayGiftMailer. To search for this DataSource, select Name for the FilterVariable and any of the following strings for the Prefix:

  • 2014-09

  • 2014-09-09

  • 2014-09-09-Holiday

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

A two-value parameter that determines the sequence of the resulting list of DataSource.

  • asc - Arranges the list in ascending order (A-Z, 0-9).
  • dsc - Arranges the list in descending order (Z-A, 9-0).

Results are sorted by FilterVariable.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the page in the paginated results.

" - }, - "Limit":{ - "shape":"PageLimit", - "documentation":"

The maximum number of DataSource to include in the result.

" - } - } - }, - "DescribeDataSourcesOutput":{ - "type":"structure", - "members":{ - "Results":{ - "shape":"DataSources", - "documentation":"

A list of DataSource that meet the search criteria.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

An ID of the next page in the paginated results that indicates at least one more page follows.

" - } - }, - "documentation":"

Represents the query results from a DescribeDataSources operation. The content is essentially a list of DataSource.

" - }, - "DescribeEvaluationsInput":{ - "type":"structure", - "members":{ - "FilterVariable":{ - "shape":"EvaluationFilterVariable", - "documentation":"

Use one of the following variable to filter a list of Evaluation objects:

  • CreatedAt - Sets the search criteria to the Evaluation creation date.
  • Status - Sets the search criteria to the Evaluation status.
  • Name - Sets the search criteria to the contents of Evaluation Name.
  • IAMUser - Sets the search criteria to the user account that invoked an Evaluation.
  • MLModelId - Sets the search criteria to the MLModel that was evaluated.
  • DataSourceId - Sets the search criteria to the DataSource used in Evaluation.
  • DataUri - Sets the search criteria to the data file(s) used in Evaluation. The URL can identify either a file or an Amazon Simple Storage Solution (Amazon S3) bucket or directory.
" - }, - "EQ":{ - "shape":"ComparatorValue", - "documentation":"

The equal to operator. The Evaluation results will have FilterVariable values that exactly match the value specified with EQ.

" - }, - "GT":{ - "shape":"ComparatorValue", - "documentation":"

The greater than operator. The Evaluation results will have FilterVariable values that are greater than the value specified with GT.

" - }, - "LT":{ - "shape":"ComparatorValue", - "documentation":"

The less than operator. The Evaluation results will have FilterVariable values that are less than the value specified with LT.

" - }, - "GE":{ - "shape":"ComparatorValue", - "documentation":"

The greater than or equal to operator. The Evaluation results will have FilterVariable values that are greater than or equal to the value specified with GE.

" - }, - "LE":{ - "shape":"ComparatorValue", - "documentation":"

The less than or equal to operator. The Evaluation results will have FilterVariable values that are less than or equal to the value specified with LE.

" - }, - "NE":{ - "shape":"ComparatorValue", - "documentation":"

The not equal to operator. The Evaluation results will have FilterVariable values not equal to the value specified with NE.

" - }, - "Prefix":{ - "shape":"ComparatorValue", - "documentation":"

A string that is found at the beginning of a variable, such as Name or Id.

For example, an Evaluation could have the Name 2014-09-09-HolidayGiftMailer. To search for this Evaluation, select Name for the FilterVariable and any of the following strings for the Prefix:

  • 2014-09

  • 2014-09-09

  • 2014-09-09-Holiday

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

A two-value parameter that determines the sequence of the resulting list of Evaluation.

  • asc - Arranges the list in ascending order (A-Z, 0-9).
  • dsc - Arranges the list in descending order (Z-A, 9-0).

Results are sorted by FilterVariable.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the page in the paginated results.

" - }, - "Limit":{ - "shape":"PageLimit", - "documentation":"

The maximum number of Evaluation to include in the result.

" - } - } - }, - "DescribeEvaluationsOutput":{ - "type":"structure", - "members":{ - "Results":{ - "shape":"Evaluations", - "documentation":"

A list of Evaluation that meet the search criteria.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the next page in the paginated results that indicates at least one more page follows.

" - } - }, - "documentation":"

Represents the query results from a DescribeEvaluations operation. The content is essentially a list of Evaluation.

" - }, - "DescribeMLModelsInput":{ - "type":"structure", - "members":{ - "FilterVariable":{ - "shape":"MLModelFilterVariable", - "documentation":"

Use one of the following variables to filter a list of MLModel:

  • CreatedAt - Sets the search criteria to MLModel creation date.
  • Status - Sets the search criteria to MLModel status.
  • Name - Sets the search criteria to the contents of MLModel Name.
  • IAMUser - Sets the search criteria to the user account that invoked the MLModel creation.
  • TrainingDataSourceId - Sets the search criteria to the DataSource used to train one or more MLModel.
  • RealtimeEndpointStatus - Sets the search criteria to the MLModel real-time endpoint status.
  • MLModelType - Sets the search criteria to MLModel type: binary, regression, or multi-class.
  • Algorithm - Sets the search criteria to the algorithm that the MLModel uses.
  • TrainingDataURI - Sets the search criteria to the data file(s) used in training a MLModel. The URL can identify either a file or an Amazon Simple Storage Service (Amazon S3) bucket or directory.
" - }, - "EQ":{ - "shape":"ComparatorValue", - "documentation":"

The equal to operator. The MLModel results will have FilterVariable values that exactly match the value specified with EQ.

" - }, - "GT":{ - "shape":"ComparatorValue", - "documentation":"

The greater than operator. The MLModel results will have FilterVariable values that are greater than the value specified with GT.

" - }, - "LT":{ - "shape":"ComparatorValue", - "documentation":"

The less than operator. The MLModel results will have FilterVariable values that are less than the value specified with LT.

" - }, - "GE":{ - "shape":"ComparatorValue", - "documentation":"

The greater than or equal to operator. The MLModel results will have FilterVariable values that are greater than or equal to the value specified with GE.

" - }, - "LE":{ - "shape":"ComparatorValue", - "documentation":"

The less than or equal to operator. The MLModel results will have FilterVariable values that are less than or equal to the value specified with LE.

" - }, - "NE":{ - "shape":"ComparatorValue", - "documentation":"

The not equal to operator. The MLModel results will have FilterVariable values not equal to the value specified with NE.

" - }, - "Prefix":{ - "shape":"ComparatorValue", - "documentation":"

A string that is found at the beginning of a variable, such as Name or Id.

For example, an MLModel could have the Name 2014-09-09-HolidayGiftMailer. To search for this MLModel, select Name for the FilterVariable and any of the following strings for the Prefix:

  • 2014-09

  • 2014-09-09

  • 2014-09-09-Holiday

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

A two-value parameter that determines the sequence of the resulting list of MLModel.

  • asc - Arranges the list in ascending order (A-Z, 0-9).
  • dsc - Arranges the list in descending order (Z-A, 9-0).

Results are sorted by FilterVariable.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the page in the paginated results.

" - }, - "Limit":{ - "shape":"PageLimit", - "documentation":"

The number of pages of information to include in the result. The range of acceptable values is 1 through 100. The default value is 100.

" - } - } - }, - "DescribeMLModelsOutput":{ - "type":"structure", - "members":{ - "Results":{ - "shape":"MLModels", - "documentation":"

A list of MLModel that meet the search criteria.

" - }, - "NextToken":{ - "shape":"StringType", - "documentation":"

The ID of the next page in the paginated results that indicates at least one more page follows.

" - } - }, - "documentation":"

Represents the output of a DescribeMLModels operation. The content is essentially a list of MLModel.

" - }, - "DescribeTagsInput":{ - "type":"structure", - "required":[ - "ResourceId", - "ResourceType" - ], - "members":{ - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the ML object. For example, exampleModelId.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the ML object.

" - } - } - }, - "DescribeTagsOutput":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the tagged ML object.

" - }, - "ResourceType":{ - "shape":"TaggableResourceType", - "documentation":"

The type of the tagged ML object.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags associated with the ML object.

" - } - }, - "documentation":"

Amazon ML returns the following elements.

" - }, - "DetailsAttributes":{ - "type":"string", - "enum":[ - "PredictiveModelType", - "Algorithm" - ], - "documentation":"Contains the key values of DetailsMap: PredictiveModelType - Indicates the type of the MLModel. Algorithm - Indicates the algorithm that was used for the MLModel." - }, - "DetailsMap":{ - "type":"map", - "key":{"shape":"DetailsAttributes"}, - "value":{"shape":"DetailsValue"}, - "documentation":"Provides any additional details regarding the prediction." - }, - "DetailsValue":{ - "type":"string", - "min":1 - }, - "EDPPipelineId":{ - "type":"string", - "min":1, - "max":1024 - }, - "EDPResourceRole":{ - "type":"string", - "min":1, - "max":64 - }, - "EDPSecurityGroupId":{ - "type":"string", - "min":1, - "max":255 - }, - "EDPSecurityGroupIds":{ - "type":"list", - "member":{"shape":"EDPSecurityGroupId"} - }, - "EDPServiceRole":{ - "type":"string", - "min":1, - "max":64 - }, - "EDPSubnetId":{ - "type":"string", - "min":1, - "max":255 - }, - "EntityId":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-zA-Z0-9_.-]+" - }, - "EntityName":{ - "type":"string", - "max":1024, - "pattern":".*\\S.*|^$", - "documentation":"

A user-supplied name or description of the Amazon ML resource.

" - }, - "EntityStatus":{ - "type":"string", - "enum":[ - "PENDING", - "INPROGRESS", - "FAILED", - "COMPLETED", - "DELETED" - ], - "documentation":"

Object status with the following possible values:

  • PENDING
  • INPROGRESS
  • FAILED
  • COMPLETED
  • DELETED
" - }, - "EpochTime":{ - "type":"timestamp", - "documentation":"

A timestamp represented in epoch time.

" - }, - "ErrorCode":{"type":"integer"}, - "ErrorMessage":{ - "type":"string", - "max":2048 - }, - "Evaluation":{ - "type":"structure", - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The ID that is assigned to the Evaluation at creation.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel that is the focus of the evaluation.

" - }, - "EvaluationDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the DataSource that is used to evaluate the MLModel.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location and name of the data in Amazon Simple Storage Server (Amazon S3) that is used in the evaluation.

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account that invoked the evaluation. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the Evaluation was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the Evaluation. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the Evaluation.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The status of the evaluation. This element can have one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to evaluate an MLModel.
  • INPROGRESS - The evaluation is underway.
  • FAILED - The request to evaluate an MLModel did not run to completion. It is not usable.
  • COMPLETED - The evaluation process completed successfully.
  • DELETED - The Evaluation is marked as deleted. It is not usable.
" - }, - "PerformanceMetrics":{ - "shape":"PerformanceMetrics", - "documentation":"

Measurements of how well the MLModel performed, using observations referenced by the DataSource. One of the following metrics is returned, based on the type of the MLModel:

  • BinaryAUC: A binary MLModel uses the Area Under the Curve (AUC) technique to measure performance.

  • RegressionRMSE: A regression MLModel uses the Root Mean Square Error (RMSE) technique to measure performance. RMSE measures the difference between predicted and actual values for a single variable.

  • MulticlassAvgFScore: A multiclass MLModel uses the F1 score technique to measure performance.

For more information about performance metrics, please see the Amazon Machine Learning Developer Guide.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about evaluating the MLModel.

" - }, - "ComputeTime":{"shape":"LongType"}, - "FinishedAt":{"shape":"EpochTime"}, - "StartedAt":{"shape":"EpochTime"} - }, - "documentation":"

Represents the output of GetEvaluation operation.

The content consists of the detailed metadata and data file information and the current status of the Evaluation.

" - }, - "EvaluationFilterVariable":{ - "type":"string", - "enum":[ - "CreatedAt", - "LastUpdatedAt", - "Status", - "Name", - "IAMUser", - "MLModelId", - "DataSourceId", - "DataURI" - ], - "documentation":"

A list of the variables to use in searching or filtering Evaluation.

  • CreatedAt - Sets the search criteria to Evaluation creation date.
  • Status - Sets the search criteria to Evaluation status.
  • Name - Sets the search criteria to the contents of Evaluation Name.
  • IAMUser - Sets the search criteria to the user account that invoked an evaluation.
  • MLModelId - Sets the search criteria to the Predictor that was evaluated.
  • DataSourceId - Sets the search criteria to the DataSource used in evaluation.
  • DataUri - Sets the search criteria to the data file(s) used in evaluation. The URL can identify either a file or an Amazon Simple Storage Service (Amazon S3) bucket or directory.
" - }, - "Evaluations":{ - "type":"list", - "member":{"shape":"Evaluation"} - }, - "GetBatchPredictionInput":{ - "type":"structure", - "required":["BatchPredictionId"], - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

An ID assigned to the BatchPrediction at creation.

" - } - } - }, - "GetBatchPredictionOutput":{ - "type":"structure", - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

An ID assigned to the BatchPrediction at creation. This value should be identical to the value of the BatchPredictionID in the request.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel that generated predictions for the BatchPrediction request.

" - }, - "BatchPredictionDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the DataSource that was used to create the BatchPrediction.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account that invoked the BatchPrediction. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time when the BatchPrediction was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to BatchPrediction. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the BatchPrediction.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The status of the BatchPrediction, which can be one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to generate batch predictions.
  • INPROGRESS - The batch predictions are in progress.
  • FAILED - The request to perform a batch prediction did not run to completion. It is not usable.
  • COMPLETED - The batch prediction process completed successfully.
  • DELETED - The BatchPrediction is marked as deleted. It is not usable.
" - }, - "OutputUri":{ - "shape":"S3Url", - "documentation":"

The location of an Amazon S3 bucket or directory to receive the operation results.

" - }, - "LogUri":{ - "shape":"PresignedS3Url", - "documentation":"

A link to the file that contains logs of the CreateBatchPrediction operation.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about processing the batch prediction request.

" - }, - "ComputeTime":{ - "shape":"LongType", - "documentation":"

The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the BatchPrediction, normalized and scaled on computation resources. ComputeTime is only available if the BatchPrediction is in the COMPLETED state.

" - }, - "FinishedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the BatchPrediction as COMPLETED or FAILED. FinishedAt is only available when the BatchPrediction is in the COMPLETED or FAILED state.

" - }, - "StartedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the BatchPrediction as INPROGRESS. StartedAt isn't available if the BatchPrediction is in the PENDING state.

" - }, - "TotalRecordCount":{ - "shape":"LongType", - "documentation":"

The number of total records that Amazon Machine Learning saw while processing the BatchPrediction.

" - }, - "InvalidRecordCount":{ - "shape":"LongType", - "documentation":"

The number of invalid records that Amazon Machine Learning saw while processing the BatchPrediction.

" - } - }, - "documentation":"

Represents the output of a GetBatchPrediction operation and describes a BatchPrediction.

" - }, - "GetDataSourceInput":{ - "type":"structure", - "required":["DataSourceId"], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the DataSource at creation.

" - }, - "Verbose":{ - "shape":"Verbose", - "documentation":"

Specifies whether the GetDataSource operation should return DataSourceSchema.

If true, DataSourceSchema is returned.

If false, DataSourceSchema is not returned.

" - } - } - }, - "GetDataSourceOutput":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the DataSource at creation. This value should be identical to the value of the DataSourceId in the request.

" - }, - "DataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "DataRearrangement":{ - "shape":"DataRearrangement", - "documentation":"

A JSON string that represents the splitting and rearrangement requirement used when this DataSource was created.

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account from which the DataSource was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the DataSource was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the DataSource. The time is expressed in epoch time.

" - }, - "DataSizeInBytes":{ - "shape":"LongType", - "documentation":"

The total size of observations in the data files.

" - }, - "NumberOfFiles":{ - "shape":"LongType", - "documentation":"

The number of data files referenced by the DataSource.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the DataSource.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The current status of the DataSource. This element can have one of the following values:

  • PENDING - Amazon ML submitted a request to create a DataSource.
  • INPROGRESS - The creation process is underway.
  • FAILED - The request to create a DataSource did not run to completion. It is not usable.
  • COMPLETED - The creation process completed successfully.
  • DELETED - The DataSource is marked as deleted. It is not usable.
" - }, - "LogUri":{ - "shape":"PresignedS3Url", - "documentation":"

A link to the file containing logs of CreateDataSourceFrom* operations.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

The user-supplied description of the most recent details about creating the DataSource.

" - }, - "RedshiftMetadata":{"shape":"RedshiftMetadata"}, - "RDSMetadata":{"shape":"RDSMetadata"}, - "RoleARN":{"shape":"RoleARN"}, - "ComputeStatistics":{ - "shape":"ComputeStatistics", - "documentation":"

The parameter is true if statistics need to be generated from the observation data.

" - }, - "ComputeTime":{ - "shape":"LongType", - "documentation":"

The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the DataSource, normalized and scaled on computation resources. ComputeTime is only available if the DataSource is in the COMPLETED state and the ComputeStatistics is set to true.

" - }, - "FinishedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the DataSource as COMPLETED or FAILED. FinishedAt is only available when the DataSource is in the COMPLETED or FAILED state.

" - }, - "StartedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the DataSource as INPROGRESS. StartedAt isn't available if the DataSource is in the PENDING state.

" - }, - "DataSourceSchema":{ - "shape":"DataSchema", - "documentation":"

The schema used by all of the data files of this DataSource.

Note

This parameter is provided as part of the verbose format.

" - } - }, - "documentation":"

Represents the output of a GetDataSource operation and describes a DataSource.

" - }, - "GetEvaluationInput":{ - "type":"structure", - "required":["EvaluationId"], - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The ID of the Evaluation to retrieve. The evaluation of each MLModel is recorded and cataloged. The ID provides the means to access the information.

" - } - } - }, - "GetEvaluationOutput":{ - "type":"structure", - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The evaluation ID which is same as the EvaluationId in the request.

" - }, - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID of the MLModel that was the focus of the evaluation.

" - }, - "EvaluationDataSourceId":{ - "shape":"EntityId", - "documentation":"

The DataSource used for this evaluation.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account that invoked the evaluation. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the Evaluation was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the Evaluation. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the Evaluation.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The status of the evaluation. This element can have one of the following values:

  • PENDING - Amazon Machine Language (Amazon ML) submitted a request to evaluate an MLModel.
  • INPROGRESS - The evaluation is underway.
  • FAILED - The request to evaluate an MLModel did not run to completion. It is not usable.
  • COMPLETED - The evaluation process completed successfully.
  • DELETED - The Evaluation is marked as deleted. It is not usable.
" - }, - "PerformanceMetrics":{ - "shape":"PerformanceMetrics", - "documentation":"

Measurements of how well the MLModel performed using observations referenced by the DataSource. One of the following metric is returned based on the type of the MLModel:

  • BinaryAUC: A binary MLModel uses the Area Under the Curve (AUC) technique to measure performance.

  • RegressionRMSE: A regression MLModel uses the Root Mean Square Error (RMSE) technique to measure performance. RMSE measures the difference between predicted and actual values for a single variable.

  • MulticlassAvgFScore: A multiclass MLModel uses the F1 score technique to measure performance.

For more information about performance metrics, please see the Amazon Machine Learning Developer Guide.

" - }, - "LogUri":{ - "shape":"PresignedS3Url", - "documentation":"

A link to the file that contains logs of the CreateEvaluation operation.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about evaluating the MLModel.

" - }, - "ComputeTime":{ - "shape":"LongType", - "documentation":"

The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the Evaluation, normalized and scaled on computation resources. ComputeTime is only available if the Evaluation is in the COMPLETED state.

" - }, - "FinishedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the Evaluation as COMPLETED or FAILED. FinishedAt is only available when the Evaluation is in the COMPLETED or FAILED state.

" - }, - "StartedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the Evaluation as INPROGRESS. StartedAt isn't available if the Evaluation is in the PENDING state.

" - } - }, - "documentation":"

Represents the output of a GetEvaluation operation and describes an Evaluation.

" - }, - "GetMLModelInput":{ - "type":"structure", - "required":["MLModelId"], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel at creation.

" - }, - "Verbose":{ - "shape":"Verbose", - "documentation":"

Specifies whether the GetMLModel operation should return Recipe.

If true, Recipe is returned.

If false, Recipe is not returned.

" - } - } - }, - "GetMLModelOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The MLModel ID, which is same as the MLModelId in the request.

" - }, - "TrainingDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the training DataSource.

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account from which the MLModel was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the MLModel was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the MLModel. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"MLModelName", - "documentation":"

A user-supplied name or description of the MLModel.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The current status of the MLModel. This element can have one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to describe a MLModel.
  • INPROGRESS - The request is processing.
  • FAILED - The request did not run to completion. The ML model isn't usable.
  • COMPLETED - The request completed successfully.
  • DELETED - The MLModel is marked as deleted. It isn't usable.
" - }, - "SizeInBytes":{"shape":"LongType"}, - "EndpointInfo":{ - "shape":"RealtimeEndpointInfo", - "documentation":"

The current endpoint of the MLModel

" - }, - "TrainingParameters":{ - "shape":"TrainingParameters", - "documentation":"

A list of the training parameters in the MLModel. The list is implemented as a map of key-value pairs.

The following is the current set of training parameters:

  • sgd.maxMLModelSizeInBytes - The maximum allowed size of the model. Depending on the input data, the size of the model might affect its performance.

    The value is an integer that ranges from 100000 to 2147483648. The default value is 33554432.

  • sgd.maxPasses - The number of times that the training process traverses the observations to build the MLModel. The value is an integer that ranges from 1 to 10000. The default value is 10.

  • sgd.shuffleType - Whether Amazon ML shuffles the training data. Shuffling data improves a model's ability to find the optimal solution for a variety of data types. The valid values are auto and none. The default value is none. We strongly recommend that you shuffle your data.

  • sgd.l1RegularizationAmount - The coefficient regularization L1 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to zero, resulting in a sparse feature set. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L1 normalization. This parameter can't be used when L2 is specified. Use this parameter sparingly.

  • sgd.l2RegularizationAmount - The coefficient regularization L2 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to small, nonzero values. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L2 normalization. This parameter can't be used when L1 is specified. Use this parameter sparingly.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "MLModelType":{ - "shape":"MLModelType", - "documentation":"

Identifies the MLModel category. The following are the available types:

  • REGRESSION -- Produces a numeric result. For example, \"What price should a house be listed at?\"
  • BINARY -- Produces one of two possible results. For example, \"Is this an e-commerce website?\"
  • MULTICLASS -- Produces one of several possible results. For example, \"Is this a HIGH, LOW or MEDIUM risk trade?\"
" - }, - "ScoreThreshold":{ - "shape":"ScoreThreshold", - "documentation":"

The scoring threshold is used in binary classification MLModel models. It marks the boundary between a positive prediction and a negative prediction.

Output values greater than or equal to the threshold receive a positive result from the MLModel, such as true. Output values less than the threshold receive a negative response from the MLModel, such as false.

" - }, - "ScoreThresholdLastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the ScoreThreshold. The time is expressed in epoch time.

" - }, - "LogUri":{ - "shape":"PresignedS3Url", - "documentation":"

A link to the file that contains logs of the CreateMLModel operation.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about accessing the MLModel.

" - }, - "ComputeTime":{ - "shape":"LongType", - "documentation":"

The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the MLModel, normalized and scaled on computation resources. ComputeTime is only available if the MLModel is in the COMPLETED state.

" - }, - "FinishedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the MLModel as COMPLETED or FAILED. FinishedAt is only available when the MLModel is in the COMPLETED or FAILED state.

" - }, - "StartedAt":{ - "shape":"EpochTime", - "documentation":"

The epoch time when Amazon Machine Learning marked the MLModel as INPROGRESS. StartedAt isn't available if the MLModel is in the PENDING state.

" - }, - "Recipe":{ - "shape":"Recipe", - "documentation":"

The recipe to use when training the MLModel. The Recipe provides detailed information about the observation data to use during training, and manipulations to perform on the observation data during training.

Note

This parameter is provided as part of the verbose format.

" - }, - "Schema":{ - "shape":"DataSchema", - "documentation":"

The schema used by all of the data files referenced by the DataSource.

Note

This parameter is provided as part of the verbose format.

" - } - }, - "documentation":"

Represents the output of a GetMLModel operation, and provides detailed information about a MLModel.

" - }, - "IdempotentParameterMismatchException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "code":{"shape":"ErrorCode"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

A second request to use or change an object was not allowed. This can result from retrying a request using a parameter that was not present in the original request.

" - }, - "IntegerType":{ - "type":"integer", - "documentation":"

Integer type that is a 32-bit signed number.

" - }, - "InternalServerException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "code":{"shape":"ErrorCode"} - }, - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true, - "documentation":"

An error on the server occurred when trying to process a request.

" - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "code":{"shape":"ErrorCode"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

An error on the client occurred. Typically, the cause is an invalid input value.

" - }, - "InvalidTagException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true - }, - "Label":{ - "type":"string", - "min":1 - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "code":{"shape":"ErrorCode"} - }, - "error":{"httpStatusCode":417}, - "exception":true, - "documentation":"

The subscriber exceeded the maximum number of operations. This exception can occur when listing objects such as DataSource.

" - }, - "LongType":{ - "type":"long", - "documentation":"

Long integer type that is a 64-bit signed number.

" - }, - "MLModel":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel at creation.

" - }, - "TrainingDataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID of the training DataSource. The CreateMLModel operation uses the TrainingDataSourceId.

" - }, - "CreatedByIamUser":{ - "shape":"AwsUserArn", - "documentation":"

The AWS user account from which the MLModel was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the MLModel was created. The time is expressed in epoch time.

" - }, - "LastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the MLModel. The time is expressed in epoch time.

" - }, - "Name":{ - "shape":"MLModelName", - "documentation":"

A user-supplied name or description of the MLModel.

" - }, - "Status":{ - "shape":"EntityStatus", - "documentation":"

The current status of an MLModel. This element can have one of the following values:

  • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to create an MLModel.
  • INPROGRESS - The creation process is underway.
  • FAILED - The request to create an MLModel didn't run to completion. The model isn't usable.
  • COMPLETED - The creation process completed successfully.
  • DELETED - The MLModel is marked as deleted. It isn't usable.
" - }, - "SizeInBytes":{"shape":"LongType"}, - "EndpointInfo":{ - "shape":"RealtimeEndpointInfo", - "documentation":"

The current endpoint of the MLModel.

" - }, - "TrainingParameters":{ - "shape":"TrainingParameters", - "documentation":"

A list of the training parameters in the MLModel. The list is implemented as a map of key-value pairs.

The following is the current set of training parameters:

  • sgd.maxMLModelSizeInBytes - The maximum allowed size of the model. Depending on the input data, the size of the model might affect its performance.

    The value is an integer that ranges from 100000 to 2147483648. The default value is 33554432.

  • sgd.maxPasses - The number of times that the training process traverses the observations to build the MLModel. The value is an integer that ranges from 1 to 10000. The default value is 10.

  • sgd.shuffleType - Whether Amazon ML shuffles the training data. Shuffling the data improves a model's ability to find the optimal solution for a variety of data types. The valid values are auto and none. The default value is none.

  • sgd.l1RegularizationAmount - The coefficient regularization L1 norm, which controls overfitting the data by penalizing large coefficients. This parameter tends to drive coefficients to zero, resulting in sparse feature set. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L1 normalization. This parameter can't be used when L2 is specified. Use this parameter sparingly.

  • sgd.l2RegularizationAmount - The coefficient regularization L2 norm, which controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to small, nonzero values. If you use this parameter, start by specifying a small value, such as 1.0E-08.

    The value is a double that ranges from 0 to MAX_DOUBLE. The default is to not use L2 normalization. This parameter can't be used when L1 is specified. Use this parameter sparingly.

" - }, - "InputDataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

" - }, - "Algorithm":{ - "shape":"Algorithm", - "documentation":"

The algorithm used to train the MLModel. The following algorithm is supported:

  • SGD -- Stochastic gradient descent. The goal of SGD is to minimize the gradient of the loss function.
" - }, - "MLModelType":{ - "shape":"MLModelType", - "documentation":"

Identifies the MLModel category. The following are the available types:

  • REGRESSION - Produces a numeric result. For example, \"What price should a house be listed at?\"
  • BINARY - Produces one of two possible results. For example, \"Is this a child-friendly web site?\".
  • MULTICLASS - Produces one of several possible results. For example, \"Is this a HIGH-, LOW-, or MEDIUM-risk trade?\".
" - }, - "ScoreThreshold":{"shape":"ScoreThreshold"}, - "ScoreThresholdLastUpdatedAt":{ - "shape":"EpochTime", - "documentation":"

The time of the most recent edit to the ScoreThreshold. The time is expressed in epoch time.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

A description of the most recent details about accessing the MLModel.

" - }, - "ComputeTime":{"shape":"LongType"}, - "FinishedAt":{"shape":"EpochTime"}, - "StartedAt":{"shape":"EpochTime"} - }, - "documentation":"

Represents the output of a GetMLModel operation.

The content consists of the detailed metadata and the current status of the MLModel.

" - }, - "MLModelFilterVariable":{ - "type":"string", - "enum":[ - "CreatedAt", - "LastUpdatedAt", - "Status", - "Name", - "IAMUser", - "TrainingDataSourceId", - "RealtimeEndpointStatus", - "MLModelType", - "Algorithm", - "TrainingDataURI" - ] - }, - "MLModelName":{ - "type":"string", - "max":1024 - }, - "MLModelType":{ - "type":"string", - "enum":[ - "REGRESSION", - "BINARY", - "MULTICLASS" - ] - }, - "MLModels":{ - "type":"list", - "member":{"shape":"MLModel"} - }, - "Message":{ - "type":"string", - "max":10240, - "documentation":"

Description of the most recent details about an object.

" - }, - "PageLimit":{ - "type":"integer", - "min":1, - "max":100 - }, - "PerformanceMetrics":{ - "type":"structure", - "members":{ - "Properties":{"shape":"PerformanceMetricsProperties"} - }, - "documentation":"

Measurements of how well the MLModel performed on known observations. One of the following metrics is returned, based on the type of the MLModel:

  • BinaryAUC: The binary MLModel uses the Area Under the Curve (AUC) technique to measure performance.

  • RegressionRMSE: The regression MLModel uses the Root Mean Square Error (RMSE) technique to measure performance. RMSE measures the difference between predicted and actual values for a single variable.

  • MulticlassAvgFScore: The multiclass MLModel uses the F1 score technique to measure performance.

For more information about performance metrics, please see the Amazon Machine Learning Developer Guide.

" - }, - "PerformanceMetricsProperties":{ - "type":"map", - "key":{"shape":"PerformanceMetricsPropertyKey"}, - "value":{"shape":"PerformanceMetricsPropertyValue"} - }, - "PerformanceMetricsPropertyKey":{"type":"string"}, - "PerformanceMetricsPropertyValue":{"type":"string"}, - "PredictInput":{ - "type":"structure", - "required":[ - "MLModelId", - "Record", - "PredictEndpoint" - ], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

A unique identifier of the MLModel.

" - }, - "Record":{"shape":"Record"}, - "PredictEndpoint":{"shape":"VipURL"} - } - }, - "PredictOutput":{ - "type":"structure", - "members":{ - "Prediction":{"shape":"Prediction"} - } - }, - "Prediction":{ - "type":"structure", - "members":{ - "predictedLabel":{ - "shape":"Label", - "documentation":"

The prediction label for either a BINARY or MULTICLASS MLModel.

" - }, - "predictedValue":{ - "shape":"floatLabel", - "documentation":"The prediction value for REGRESSION MLModel." - }, - "predictedScores":{"shape":"ScoreValuePerLabelMap"}, - "details":{"shape":"DetailsMap"} - }, - "documentation":"

The output from a Predict operation:

  • Details - Contains the following attributes: DetailsAttributes.PREDICTIVE_MODEL_TYPE - REGRESSION | BINARY | MULTICLASS DetailsAttributes.ALGORITHM - SGD

  • PredictedLabel - Present for either a BINARY or MULTICLASS MLModel request.

  • PredictedScores - Contains the raw classification score corresponding to each label.

  • PredictedValue - Present for a REGRESSION MLModel request.

" - }, - "PredictorNotMountedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "error":{"httpStatusCode":400}, - "exception":true, - "documentation":"

The exception is thrown when a predict request is made to an unmounted MLModel.

" - }, - "PresignedS3Url":{"type":"string"}, - "RDSDataSpec":{ - "type":"structure", - "required":[ - "DatabaseInformation", - "SelectSqlQuery", - "DatabaseCredentials", - "S3StagingLocation", - "ResourceRole", - "ServiceRole", - "SubnetId", - "SecurityGroupIds" - ], - "members":{ - "DatabaseInformation":{ - "shape":"RDSDatabase", - "documentation":"

Describes the DatabaseName and InstanceIdentifier of an Amazon RDS database.

" - }, - "SelectSqlQuery":{ - "shape":"RDSSelectSqlQuery", - "documentation":"

The query that is used to retrieve the observation data for the DataSource.

" - }, - "DatabaseCredentials":{ - "shape":"RDSDatabaseCredentials", - "documentation":"

The AWS Identity and Access Management (IAM) credentials that are used connect to the Amazon RDS database.

" - }, - "S3StagingLocation":{ - "shape":"S3Url", - "documentation":"

The Amazon S3 location for staging Amazon RDS data. The data retrieved from Amazon RDS using SelectSqlQuery is stored in this location.

" - }, - "DataRearrangement":{ - "shape":"DataRearrangement", - "documentation":"

A JSON string that represents the splitting and rearrangement processing to be applied to a DataSource. If the DataRearrangement parameter is not provided, all of the input data is used to create the Datasource.

There are multiple parameters that control what data is used to create a datasource:

  • percentBegin

    Use percentBegin to indicate the beginning of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • percentEnd

    Use percentEnd to indicate the end of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • complement

    The complement parameter instructs Amazon ML to use the data that is not included in the range of percentBegin to percentEnd to create a datasource. The complement parameter is useful if you need to create complementary datasources for training and evaluation. To create a complementary datasource, use the same values for percentBegin and percentEnd, along with the complement parameter.

    For example, the following two datasources do not share any data, and can be used to train and evaluate a model. The first datasource has 25 percent of the data, and the second one has 75 percent of the data.

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25}}

    Datasource for training: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25, \"complement\":\"true\"}}

  • strategy

    To change how Amazon ML splits the data for a datasource, use the strategy parameter.

    The default value for the strategy parameter is sequential, meaning that Amazon ML takes all of the data records between the percentBegin and percentEnd parameters for the datasource, in the order that the records appear in the input data.

    The following two DataRearrangement lines are examples of sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\", \"complement\":\"true\"}}

    To randomly split the input data into the proportions indicated by the percentBegin and percentEnd parameters, set the strategy parameter to random and provide a string that is used as the seed value for the random data splitting (for example, you can use the S3 path to your data as the random seed string). If you choose the random split strategy, Amazon ML assigns each row of data a pseudo-random number between 0 and 100, and then selects the rows that have an assigned number between percentBegin and percentEnd. Pseudo-random numbers are assigned using both the input seed string value and the byte offset as a seed, so changing the data results in a different split. Any existing ordering is preserved. The random splitting strategy ensures that variables in the training and evaluation data are distributed similarly. It is useful in the cases where the input data may have an implicit sort order, which would otherwise result in training and evaluation datasources containing non-similar data records.

    The following two DataRearrangement lines are examples of non-sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\", \"complement\":\"true\"}}

" - }, - "DataSchema":{ - "shape":"DataSchema", - "documentation":"

A JSON string that represents the schema for an Amazon RDS DataSource. The DataSchema defines the structure of the observation data in the data file(s) referenced in the DataSource.

A DataSchema is not required if you specify a DataSchemaUri

Define your DataSchema as a series of key-value pairs. attributes and excludedVariableNames have an array of key-value pairs for their value. Use the following format to define your DataSchema.

{ \"version\": \"1.0\",

\"recordAnnotationFieldName\": \"F1\",

\"recordWeightFieldName\": \"F2\",

\"targetFieldName\": \"F3\",

\"dataFormat\": \"CSV\",

\"dataFileContainsHeader\": true,

\"attributes\": [

{ \"fieldName\": \"F1\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F2\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F3\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F4\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F5\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F6\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F7\", \"fieldType\": \"WEIGHTED_INT_SEQUENCE\" }, { \"fieldName\": \"F8\", \"fieldType\": \"WEIGHTED_STRING_SEQUENCE\" } ],

\"excludedVariableNames\": [ \"F6\" ] }

" - }, - "DataSchemaUri":{ - "shape":"S3Url", - "documentation":"

The Amazon S3 location of the DataSchema.

" - }, - "ResourceRole":{ - "shape":"EDPResourceRole", - "documentation":"

The role (DataPipelineDefaultResourceRole) assumed by an Amazon Elastic Compute Cloud (Amazon EC2) instance to carry out the copy operation from Amazon RDS to an Amazon S3 task. For more information, see Role templates for data pipelines.

" - }, - "ServiceRole":{ - "shape":"EDPServiceRole", - "documentation":"

The role (DataPipelineDefaultRole) assumed by AWS Data Pipeline service to monitor the progress of the copy task from Amazon RDS to Amazon S3. For more information, see Role templates for data pipelines.

" - }, - "SubnetId":{ - "shape":"EDPSubnetId", - "documentation":"

The subnet ID to be used to access a VPC-based RDS DB instance. This attribute is used by Data Pipeline to carry out the copy task from Amazon RDS to Amazon S3.

" - }, - "SecurityGroupIds":{ - "shape":"EDPSecurityGroupIds", - "documentation":"

The security group IDs to be used to access a VPC-based RDS DB instance. Ensure that there are appropriate ingress rules set up to allow access to the RDS DB instance. This attribute is used by Data Pipeline to carry out the copy operation from Amazon RDS to an Amazon S3 task.

" - } - }, - "documentation":"

The data specification of an Amazon Relational Database Service (Amazon RDS) DataSource.

" - }, - "RDSDatabase":{ - "type":"structure", - "required":[ - "InstanceIdentifier", - "DatabaseName" - ], - "members":{ - "InstanceIdentifier":{ - "shape":"RDSInstanceIdentifier", - "documentation":"

The ID of an RDS DB instance.

" - }, - "DatabaseName":{"shape":"RDSDatabaseName"} - }, - "documentation":"

The database details of an Amazon RDS database.

" - }, - "RDSDatabaseCredentials":{ - "type":"structure", - "required":[ - "Username", - "Password" - ], - "members":{ - "Username":{"shape":"RDSDatabaseUsername"}, - "Password":{"shape":"RDSDatabasePassword"} - }, - "documentation":"

The database credentials to connect to a database on an RDS DB instance.

" - }, - "RDSDatabaseName":{ - "type":"string", - "min":1, - "max":64, - "documentation":"

The name of a database hosted on an RDS DB instance.

" - }, - "RDSDatabasePassword":{ - "type":"string", - "min":8, - "max":128, - "documentation":"

The password to be used by Amazon ML to connect to a database on an RDS DB instance. The password should have sufficient permissions to execute the RDSSelectQuery query.

" - }, - "RDSDatabaseUsername":{ - "type":"string", - "min":1, - "max":128, - "documentation":"

The username to be used by Amazon ML to connect to database on an Amazon RDS instance. The username should have sufficient permissions to execute an RDSSelectSqlQuery query.

" - }, - "RDSInstanceIdentifier":{ - "type":"string", - "min":1, - "max":63, - "pattern":"[a-z0-9-]+", - "documentation":"Identifier of RDS DB Instances." - }, - "RDSMetadata":{ - "type":"structure", - "members":{ - "Database":{ - "shape":"RDSDatabase", - "documentation":"

The database details required to connect to an Amazon RDS.

" - }, - "DatabaseUserName":{"shape":"RDSDatabaseUsername"}, - "SelectSqlQuery":{ - "shape":"RDSSelectSqlQuery", - "documentation":"

The SQL query that is supplied during CreateDataSourceFromRDS. Returns only if Verbose is true in GetDataSourceInput.

" - }, - "ResourceRole":{ - "shape":"EDPResourceRole", - "documentation":"

The role (DataPipelineDefaultResourceRole) assumed by an Amazon EC2 instance to carry out the copy task from Amazon RDS to Amazon S3. For more information, see Role templates for data pipelines.

" - }, - "ServiceRole":{ - "shape":"EDPServiceRole", - "documentation":"

The role (DataPipelineDefaultRole) assumed by the Data Pipeline service to monitor the progress of the copy task from Amazon RDS to Amazon S3. For more information, see Role templates for data pipelines.

" - }, - "DataPipelineId":{ - "shape":"EDPPipelineId", - "documentation":"

The ID of the Data Pipeline instance that is used to carry to copy data from Amazon RDS to Amazon S3. You can use the ID to find details about the instance in the Data Pipeline console.

" - } - }, - "documentation":"

The datasource details that are specific to Amazon RDS.

" - }, - "RDSSelectSqlQuery":{ - "type":"string", - "min":1, - "max":16777216, - "documentation":"

The SQL query to be executed against the Amazon RDS database. The SQL query should be valid for the Amazon RDS type being used.

" - }, - "RealtimeEndpointInfo":{ - "type":"structure", - "members":{ - "PeakRequestsPerSecond":{ - "shape":"IntegerType", - "documentation":"

The maximum processing rate for the real-time endpoint for MLModel, measured in incoming requests per second.

" - }, - "CreatedAt":{ - "shape":"EpochTime", - "documentation":"

The time that the request to create the real-time endpoint for the MLModel was received. The time is expressed in epoch time.

" - }, - "EndpointUrl":{ - "shape":"VipURL", - "documentation":"

The URI that specifies where to send real-time prediction requests for the MLModel.

Note

The application must wait until the real-time endpoint is ready before using this URI.

" - }, - "EndpointStatus":{ - "shape":"RealtimeEndpointStatus", - "documentation":"

The current status of the real-time endpoint for the MLModel. This element can have one of the following values:

  • NONE - Endpoint does not exist or was previously deleted.
  • READY - Endpoint is ready to be used for real-time predictions.
  • UPDATING - Updating/creating the endpoint.
" - } - }, - "documentation":"

Describes the real-time endpoint information for an MLModel.

" - }, - "RealtimeEndpointStatus":{ - "type":"string", - "enum":[ - "NONE", - "READY", - "UPDATING", - "FAILED" - ] - }, - "Recipe":{ - "type":"string", - "max":131071 - }, - "Record":{ - "type":"map", - "key":{"shape":"VariableName"}, - "value":{"shape":"VariableValue"}, - "documentation":"

A map of variable name-value pairs that represent an observation.

" - }, - "RedshiftClusterIdentifier":{ - "type":"string", - "min":1, - "max":63, - "pattern":"[a-z0-9-]+", - "documentation":"

The ID of an Amazon Redshift cluster.

" - }, - "RedshiftDataSpec":{ - "type":"structure", - "required":[ - "DatabaseInformation", - "SelectSqlQuery", - "DatabaseCredentials", - "S3StagingLocation" - ], - "members":{ - "DatabaseInformation":{ - "shape":"RedshiftDatabase", - "documentation":"

Describes the DatabaseName and ClusterIdentifier for an Amazon Redshift DataSource.

" - }, - "SelectSqlQuery":{ - "shape":"RedshiftSelectSqlQuery", - "documentation":"

Describes the SQL Query to execute on an Amazon Redshift database for an Amazon Redshift DataSource.

" - }, - "DatabaseCredentials":{ - "shape":"RedshiftDatabaseCredentials", - "documentation":"

Describes AWS Identity and Access Management (IAM) credentials that are used connect to the Amazon Redshift database.

" - }, - "S3StagingLocation":{ - "shape":"S3Url", - "documentation":"

Describes an Amazon S3 location to store the result set of the SelectSqlQuery query.

" - }, - "DataRearrangement":{ - "shape":"DataRearrangement", - "documentation":"

A JSON string that represents the splitting and rearrangement processing to be applied to a DataSource. If the DataRearrangement parameter is not provided, all of the input data is used to create the Datasource.

There are multiple parameters that control what data is used to create a datasource:

  • percentBegin

    Use percentBegin to indicate the beginning of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • percentEnd

    Use percentEnd to indicate the end of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • complement

    The complement parameter instructs Amazon ML to use the data that is not included in the range of percentBegin to percentEnd to create a datasource. The complement parameter is useful if you need to create complementary datasources for training and evaluation. To create a complementary datasource, use the same values for percentBegin and percentEnd, along with the complement parameter.

    For example, the following two datasources do not share any data, and can be used to train and evaluate a model. The first datasource has 25 percent of the data, and the second one has 75 percent of the data.

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25}}

    Datasource for training: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25, \"complement\":\"true\"}}

  • strategy

    To change how Amazon ML splits the data for a datasource, use the strategy parameter.

    The default value for the strategy parameter is sequential, meaning that Amazon ML takes all of the data records between the percentBegin and percentEnd parameters for the datasource, in the order that the records appear in the input data.

    The following two DataRearrangement lines are examples of sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\", \"complement\":\"true\"}}

    To randomly split the input data into the proportions indicated by the percentBegin and percentEnd parameters, set the strategy parameter to random and provide a string that is used as the seed value for the random data splitting (for example, you can use the S3 path to your data as the random seed string). If you choose the random split strategy, Amazon ML assigns each row of data a pseudo-random number between 0 and 100, and then selects the rows that have an assigned number between percentBegin and percentEnd. Pseudo-random numbers are assigned using both the input seed string value and the byte offset as a seed, so changing the data results in a different split. Any existing ordering is preserved. The random splitting strategy ensures that variables in the training and evaluation data are distributed similarly. It is useful in the cases where the input data may have an implicit sort order, which would otherwise result in training and evaluation datasources containing non-similar data records.

    The following two DataRearrangement lines are examples of non-sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\", \"complement\":\"true\"}}

" - }, - "DataSchema":{ - "shape":"DataSchema", - "documentation":"

A JSON string that represents the schema for an Amazon Redshift DataSource. The DataSchema defines the structure of the observation data in the data file(s) referenced in the DataSource.

A DataSchema is not required if you specify a DataSchemaUri.

Define your DataSchema as a series of key-value pairs. attributes and excludedVariableNames have an array of key-value pairs for their value. Use the following format to define your DataSchema.

{ \"version\": \"1.0\",

\"recordAnnotationFieldName\": \"F1\",

\"recordWeightFieldName\": \"F2\",

\"targetFieldName\": \"F3\",

\"dataFormat\": \"CSV\",

\"dataFileContainsHeader\": true,

\"attributes\": [

{ \"fieldName\": \"F1\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F2\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F3\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F4\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F5\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F6\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F7\", \"fieldType\": \"WEIGHTED_INT_SEQUENCE\" }, { \"fieldName\": \"F8\", \"fieldType\": \"WEIGHTED_STRING_SEQUENCE\" } ],

\"excludedVariableNames\": [ \"F6\" ] }

" - }, - "DataSchemaUri":{ - "shape":"S3Url", - "documentation":"

Describes the schema location for an Amazon Redshift DataSource.

" - } - }, - "documentation":"

Describes the data specification of an Amazon Redshift DataSource.

" - }, - "RedshiftDatabase":{ - "type":"structure", - "required":[ - "DatabaseName", - "ClusterIdentifier" - ], - "members":{ - "DatabaseName":{"shape":"RedshiftDatabaseName"}, - "ClusterIdentifier":{"shape":"RedshiftClusterIdentifier"} - }, - "documentation":"

Describes the database details required to connect to an Amazon Redshift database.

" - }, - "RedshiftDatabaseCredentials":{ - "type":"structure", - "required":[ - "Username", - "Password" - ], - "members":{ - "Username":{"shape":"RedshiftDatabaseUsername"}, - "Password":{"shape":"RedshiftDatabasePassword"} - }, - "documentation":"

Describes the database credentials for connecting to a database on an Amazon Redshift cluster.

" - }, - "RedshiftDatabaseName":{ - "type":"string", - "min":1, - "max":64, - "pattern":"[a-z0-9]+", - "documentation":"

The name of a database hosted on an Amazon Redshift cluster.

" - }, - "RedshiftDatabasePassword":{ - "type":"string", - "min":8, - "max":64, - "documentation":"

A password to be used by Amazon ML to connect to a database on an Amazon Redshift cluster. The password should have sufficient permissions to execute a RedshiftSelectSqlQuery query. The password should be valid for an Amazon Redshift USER.

" - }, - "RedshiftDatabaseUsername":{ - "type":"string", - "min":1, - "max":128, - "documentation":"

A username to be used by Amazon Machine Learning (Amazon ML)to connect to a database on an Amazon Redshift cluster. The username should have sufficient permissions to execute the RedshiftSelectSqlQuery query. The username should be valid for an Amazon Redshift USER.

" - }, - "RedshiftMetadata":{ - "type":"structure", - "members":{ - "RedshiftDatabase":{"shape":"RedshiftDatabase"}, - "DatabaseUserName":{"shape":"RedshiftDatabaseUsername"}, - "SelectSqlQuery":{ - "shape":"RedshiftSelectSqlQuery", - "documentation":"

The SQL query that is specified during CreateDataSourceFromRedshift. Returns only if Verbose is true in GetDataSourceInput.

" - } - }, - "documentation":"

Describes the DataSource details specific to Amazon Redshift.

" - }, - "RedshiftSelectSqlQuery":{ - "type":"string", - "min":1, - "max":16777216, - "documentation":"

Describes the SQL query to execute on the Amazon Redshift database. The SQL query should be valid for an Amazon Redshift SELECT.

" - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"}, - "code":{"shape":"ErrorCode"} - }, - "error":{"httpStatusCode":404}, - "exception":true, - "documentation":"

A specified resource cannot be located.

" - }, - "RoleARN":{ - "type":"string", - "min":1, - "max":110, - "documentation":"

The Amazon Resource Name (ARN) of an AWS IAM Role, such as the following: arn:aws:iam::account:role/rolename.

" - }, - "S3DataSpec":{ - "type":"structure", - "required":["DataLocationS3"], - "members":{ - "DataLocationS3":{ - "shape":"S3Url", - "documentation":"

The location of the data file(s) used by a DataSource. The URI specifies a data file or an Amazon Simple Storage Service (Amazon S3) directory or bucket containing data files.

" - }, - "DataRearrangement":{ - "shape":"DataRearrangement", - "documentation":"

A JSON string that represents the splitting and rearrangement processing to be applied to a DataSource. If the DataRearrangement parameter is not provided, all of the input data is used to create the Datasource.

There are multiple parameters that control what data is used to create a datasource:

  • percentBegin

    Use percentBegin to indicate the beginning of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • percentEnd

    Use percentEnd to indicate the end of the range of the data used to create the Datasource. If you do not include percentBegin and percentEnd, Amazon ML includes all of the data when creating the datasource.

  • complement

    The complement parameter instructs Amazon ML to use the data that is not included in the range of percentBegin to percentEnd to create a datasource. The complement parameter is useful if you need to create complementary datasources for training and evaluation. To create a complementary datasource, use the same values for percentBegin and percentEnd, along with the complement parameter.

    For example, the following two datasources do not share any data, and can be used to train and evaluate a model. The first datasource has 25 percent of the data, and the second one has 75 percent of the data.

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25}}

    Datasource for training: {\"splitting\":{\"percentBegin\":0, \"percentEnd\":25, \"complement\":\"true\"}}

  • strategy

    To change how Amazon ML splits the data for a datasource, use the strategy parameter.

    The default value for the strategy parameter is sequential, meaning that Amazon ML takes all of the data records between the percentBegin and percentEnd parameters for the datasource, in the order that the records appear in the input data.

    The following two DataRearrangement lines are examples of sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"sequential\", \"complement\":\"true\"}}

    To randomly split the input data into the proportions indicated by the percentBegin and percentEnd parameters, set the strategy parameter to random and provide a string that is used as the seed value for the random data splitting (for example, you can use the S3 path to your data as the random seed string). If you choose the random split strategy, Amazon ML assigns each row of data a pseudo-random number between 0 and 100, and then selects the rows that have an assigned number between percentBegin and percentEnd. Pseudo-random numbers are assigned using both the input seed string value and the byte offset as a seed, so changing the data results in a different split. Any existing ordering is preserved. The random splitting strategy ensures that variables in the training and evaluation data are distributed similarly. It is useful in the cases where the input data may have an implicit sort order, which would otherwise result in training and evaluation datasources containing non-similar data records.

    The following two DataRearrangement lines are examples of non-sequentially ordered training and evaluation datasources:

    Datasource for evaluation: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\"}}

    Datasource for training: {\"splitting\":{\"percentBegin\":70, \"percentEnd\":100, \"strategy\":\"random\", \"randomSeed\"=\"s3://my_s3_path/bucket/file.csv\", \"complement\":\"true\"}}

" - }, - "DataSchema":{ - "shape":"DataSchema", - "documentation":"

A JSON string that represents the schema for an Amazon S3 DataSource. The DataSchema defines the structure of the observation data in the data file(s) referenced in the DataSource.

You must provide either the DataSchema or the DataSchemaLocationS3.

Define your DataSchema as a series of key-value pairs. attributes and excludedVariableNames have an array of key-value pairs for their value. Use the following format to define your DataSchema.

{ \"version\": \"1.0\",

\"recordAnnotationFieldName\": \"F1\",

\"recordWeightFieldName\": \"F2\",

\"targetFieldName\": \"F3\",

\"dataFormat\": \"CSV\",

\"dataFileContainsHeader\": true,

\"attributes\": [

{ \"fieldName\": \"F1\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F2\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F3\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F4\", \"fieldType\": \"NUMERIC\" }, { \"fieldName\": \"F5\", \"fieldType\": \"CATEGORICAL\" }, { \"fieldName\": \"F6\", \"fieldType\": \"TEXT\" }, { \"fieldName\": \"F7\", \"fieldType\": \"WEIGHTED_INT_SEQUENCE\" }, { \"fieldName\": \"F8\", \"fieldType\": \"WEIGHTED_STRING_SEQUENCE\" } ],

\"excludedVariableNames\": [ \"F6\" ] }

" - }, - "DataSchemaLocationS3":{ - "shape":"S3Url", - "documentation":"

Describes the schema location in Amazon S3. You must provide either the DataSchema or the DataSchemaLocationS3.

" - } - }, - "documentation":"

Describes the data specification of a DataSource.

" - }, - "S3Url":{ - "type":"string", - "max":2048, - "pattern":"s3://([^/]+)(/.*)?", - "documentation":"

A reference to a file or bucket on Amazon Simple Storage Service (Amazon S3).

" - }, - "ScoreThreshold":{"type":"float"}, - "ScoreValue":{"type":"float"}, - "ScoreValuePerLabelMap":{ - "type":"map", - "key":{"shape":"Label"}, - "value":{"shape":"ScoreValue"}, - "documentation":"Provides the raw classification score corresponding to each label." - }, - "SortOrder":{ - "type":"string", - "enum":[ - "asc", - "dsc" - ], - "documentation":"

The sort order specified in a listing condition. Possible values include the following:

  • asc - Present the information in ascending order (from A-Z).
  • dsc - Present the information in descending order (from Z-A).
" - }, - "StringType":{ - "type":"string", - "documentation":"

String type.

" - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

A unique identifier for the tag. Valid characters include Unicode letters, digits, white space, _, ., /, =, +, -, %, and @.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

An optional string, typically used to describe or define the tag. Valid characters include Unicode letters, digits, white space, _, ., /, =, +, -, %, and @.

" - } - }, - "documentation":"

A custom key-value pair associated with an ML object, such as an ML model.

" - }, - "TagKey":{ - "type":"string", - "min":1, - "max":128, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":100 - }, - "TagLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":100 - }, - "TagValue":{ - "type":"string", - "min":0, - "max":256, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TaggableResourceType":{ - "type":"string", - "enum":[ - "BatchPrediction", - "DataSource", - "Evaluation", - "MLModel" - ] - }, - "TrainingParameters":{ - "type":"map", - "key":{"shape":"StringType"}, - "value":{"shape":"StringType"} - }, - "UpdateBatchPredictionInput":{ - "type":"structure", - "required":[ - "BatchPredictionId", - "BatchPredictionName" - ], - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the BatchPrediction during creation.

" - }, - "BatchPredictionName":{ - "shape":"EntityName", - "documentation":"

A new user-supplied name or description of the BatchPrediction.

" - } - } - }, - "UpdateBatchPredictionOutput":{ - "type":"structure", - "members":{ - "BatchPredictionId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the BatchPrediction during creation. This value should be identical to the value of the BatchPredictionId in the request.

" - } - }, - "documentation":"

Represents the output of an UpdateBatchPrediction operation.

You can see the updated content by using the GetBatchPrediction operation.

" - }, - "UpdateDataSourceInput":{ - "type":"structure", - "required":[ - "DataSourceId", - "DataSourceName" - ], - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the DataSource during creation.

" - }, - "DataSourceName":{ - "shape":"EntityName", - "documentation":"

A new user-supplied name or description of the DataSource that will replace the current description.

" - } - } - }, - "UpdateDataSourceOutput":{ - "type":"structure", - "members":{ - "DataSourceId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the DataSource during creation. This value should be identical to the value of the DataSourceID in the request.

" - } - }, - "documentation":"

Represents the output of an UpdateDataSource operation.

You can see the updated content by using the GetBatchPrediction operation.

" - }, - "UpdateEvaluationInput":{ - "type":"structure", - "required":[ - "EvaluationId", - "EvaluationName" - ], - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the Evaluation during creation.

" - }, - "EvaluationName":{ - "shape":"EntityName", - "documentation":"

A new user-supplied name or description of the Evaluation that will replace the current content.

" - } - } - }, - "UpdateEvaluationOutput":{ - "type":"structure", - "members":{ - "EvaluationId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the Evaluation during creation. This value should be identical to the value of the Evaluation in the request.

" - } - }, - "documentation":"

Represents the output of an UpdateEvaluation operation.

You can see the updated content by using the GetEvaluation operation.

" - }, - "UpdateMLModelInput":{ - "type":"structure", - "required":["MLModelId"], - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel during creation.

" - }, - "MLModelName":{ - "shape":"EntityName", - "documentation":"

A user-supplied name or description of the MLModel.

" - }, - "ScoreThreshold":{ - "shape":"ScoreThreshold", - "documentation":"

The ScoreThreshold used in binary classification MLModel that marks the boundary between a positive prediction and a negative prediction.

Output values greater than or equal to the ScoreThreshold receive a positive result from the MLModel, such as true. Output values less than the ScoreThreshold receive a negative response from the MLModel, such as false.

" - } - } - }, - "UpdateMLModelOutput":{ - "type":"structure", - "members":{ - "MLModelId":{ - "shape":"EntityId", - "documentation":"

The ID assigned to the MLModel during creation. This value should be identical to the value of the MLModelID in the request.

" - } - }, - "documentation":"

Represents the output of an UpdateMLModel operation.

You can see the updated content by using the GetMLModel operation.

" - }, - "VariableName":{ - "type":"string", - "documentation":"

The name of a variable. Currently it's used to specify the name of the target value, label, weight, and tags.

" - }, - "VariableValue":{ - "type":"string", - "documentation":"

The value of a variable. Currently it's used to specify values of the target value, weights, and tag variables and for filtering variable values.

" - }, - "Verbose":{ - "type":"boolean", - "documentation":"

Specifies whether a describe operation should return exhaustive or abbreviated information.

" - }, - "VipURL":{ - "type":"string", - "max":2048, - "pattern":"https://[a-zA-Z0-9-.]*\\.amazon(aws)?\\.com[/]?" - }, - "floatLabel":{"type":"float"} - }, - "examples":{ - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/waiters-2.json deleted file mode 100644 index da6b1c95..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/machinelearning/2014-12-12/waiters-2.json +++ /dev/null @@ -1,81 +0,0 @@ -{ - "version": 2, - "waiters": { - "DataSourceAvailable": { - "delay": 30, - "operation": "DescribeDataSources", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "COMPLETED", - "matcher": "pathAll", - "state": "success", - "argument": "Results[].Status" - }, - { - "expected": "FAILED", - "matcher": "pathAny", - "state": "failure", - "argument": "Results[].Status" - } - ] - }, - "MLModelAvailable": { - "delay": 30, - "operation": "DescribeMLModels", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "COMPLETED", - "matcher": "pathAll", - "state": "success", - "argument": "Results[].Status" - }, - { - "expected": "FAILED", - "matcher": "pathAny", - "state": "failure", - "argument": "Results[].Status" - } - ] - }, - "EvaluationAvailable": { - "delay": 30, - "operation": "DescribeEvaluations", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "COMPLETED", - "matcher": "pathAll", - "state": "success", - "argument": "Results[].Status" - }, - { - "expected": "FAILED", - "matcher": "pathAny", - "state": "failure", - "argument": "Results[].Status" - } - ] - }, - "BatchPredictionAvailable": { - "delay": 30, - "operation": "DescribeBatchPredictions", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "COMPLETED", - "matcher": "pathAll", - "state": "success", - "argument": "Results[].Status" - }, - { - "expected": "FAILED", - "matcher": "pathAny", - "state": "failure", - "argument": "Results[].Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/service-2.json deleted file mode 100644 index c3114b69..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/macie/2017-12-19/service-2.json +++ /dev/null @@ -1,495 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-12-19", - "endpointPrefix":"macie", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Macie", - "serviceId":"Macie", - "signatureVersion":"v4", - "targetPrefix":"MacieService", - "uid":"macie-2017-12-19" - }, - "operations":{ - "AssociateMemberAccount":{ - "name":"AssociateMemberAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateMemberAccountRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalException"} - ], - "documentation":"

Associates a specified AWS account with Amazon Macie as a member account.

" - }, - "AssociateS3Resources":{ - "name":"AssociateS3Resources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateS3ResourcesRequest"}, - "output":{"shape":"AssociateS3ResourcesResult"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalException"} - ], - "documentation":"

Associates specified S3 resources with Amazon Macie for monitoring and data classification. If memberAccountId isn't specified, the action associates specified S3 resources with Macie for the current master account. If memberAccountId is specified, the action associates specified S3 resources with Macie for the specified member account.

" - }, - "DisassociateMemberAccount":{ - "name":"DisassociateMemberAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateMemberAccountRequest"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"InternalException"} - ], - "documentation":"

Removes the specified member account from Amazon Macie.

" - }, - "DisassociateS3Resources":{ - "name":"DisassociateS3Resources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateS3ResourcesRequest"}, - "output":{"shape":"DisassociateS3ResourcesResult"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalException"} - ], - "documentation":"

Removes specified S3 resources from being monitored by Amazon Macie. If memberAccountId isn't specified, the action removes specified S3 resources from Macie for the current master account. If memberAccountId is specified, the action removes specified S3 resources from Macie for the specified member account.

" - }, - "ListMemberAccounts":{ - "name":"ListMemberAccounts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListMemberAccountsRequest"}, - "output":{"shape":"ListMemberAccountsResult"}, - "errors":[ - {"shape":"InternalException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Lists all Amazon Macie member accounts for the current Amazon Macie master account.

" - }, - "ListS3Resources":{ - "name":"ListS3Resources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListS3ResourcesRequest"}, - "output":{"shape":"ListS3ResourcesResult"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalException"} - ], - "documentation":"

Lists all the S3 resources associated with Amazon Macie. If memberAccountId isn't specified, the action lists the S3 resources associated with Amazon Macie for the current master account. If memberAccountId is specified, the action lists the S3 resources associated with Amazon Macie for the specified member account.

" - }, - "UpdateS3Resources":{ - "name":"UpdateS3Resources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateS3ResourcesRequest"}, - "output":{"shape":"UpdateS3ResourcesResult"}, - "errors":[ - {"shape":"InvalidInputException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalException"} - ], - "documentation":"

Updates the classification types for the specified S3 resources. If memberAccountId isn't specified, the action updates the classification types of the S3 resources associated with Amazon Macie for the current master account. If memberAccountId is specified, the action updates the classification types of the S3 resources associated with Amazon Macie for the specified member account.

" - } - }, - "shapes":{ - "AWSAccountId":{ - "type":"string", - "pattern":"[0-9]{12}" - }, - "AccessDeniedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"}, - "resourceType":{"shape":"ResourceType"} - }, - "documentation":"

You do not have required permissions to access the requested resource.

", - "exception":true - }, - "AssociateMemberAccountRequest":{ - "type":"structure", - "required":["memberAccountId"], - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The ID of the AWS account that you want to associate with Amazon Macie as a member account.

" - } - } - }, - "AssociateS3ResourcesRequest":{ - "type":"structure", - "required":["s3Resources"], - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The ID of the Amazon Macie member account whose resources you want to associate with Macie.

" - }, - "s3Resources":{ - "shape":"S3ResourcesClassification", - "documentation":"

The S3 resources that you want to associate with Amazon Macie for monitoring and data classification.

" - } - } - }, - "AssociateS3ResourcesResult":{ - "type":"structure", - "members":{ - "failedS3Resources":{ - "shape":"FailedS3Resources", - "documentation":"

S3 resources that couldn't be associated with Amazon Macie. An error code and an error message are provided for each failed item.

" - } - } - }, - "BucketName":{ - "type":"string", - "max":500 - }, - "ClassificationType":{ - "type":"structure", - "required":[ - "oneTime", - "continuous" - ], - "members":{ - "oneTime":{ - "shape":"S3OneTimeClassificationType", - "documentation":"

A one-time classification of all of the existing objects in a specified S3 bucket.

" - }, - "continuous":{ - "shape":"S3ContinuousClassificationType", - "documentation":"

A continuous classification of the objects that are added to a specified S3 bucket. Amazon Macie begins performing continuous classification after a bucket is successfully associated with Amazon Macie.

" - } - }, - "documentation":"

The classification type that Amazon Macie applies to the associated S3 resources.

" - }, - "ClassificationTypeUpdate":{ - "type":"structure", - "members":{ - "oneTime":{ - "shape":"S3OneTimeClassificationType", - "documentation":"

A one-time classification of all of the existing objects in a specified S3 bucket.

" - }, - "continuous":{ - "shape":"S3ContinuousClassificationType", - "documentation":"

A continuous classification of the objects that are added to a specified S3 bucket. Amazon Macie begins performing continuous classification after a bucket is successfully associated with Amazon Macie.

" - } - }, - "documentation":"

The classification type that Amazon Macie applies to the associated S3 resources. At least one of the classification types (oneTime or continuous) must be specified.

" - }, - "DisassociateMemberAccountRequest":{ - "type":"structure", - "required":["memberAccountId"], - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The ID of the member account that you want to remove from Amazon Macie.

" - } - } - }, - "DisassociateS3ResourcesRequest":{ - "type":"structure", - "required":["associatedS3Resources"], - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The ID of the Amazon Macie member account whose resources you want to remove from being monitored by Amazon Macie.

" - }, - "associatedS3Resources":{ - "shape":"S3Resources", - "documentation":"

The S3 resources (buckets or prefixes) that you want to remove from being monitored and classified by Amazon Macie.

" - } - } - }, - "DisassociateS3ResourcesResult":{ - "type":"structure", - "members":{ - "failedS3Resources":{ - "shape":"FailedS3Resources", - "documentation":"

S3 resources that couldn't be removed from being monitored and classified by Amazon Macie. An error code and an error message are provided for each failed item.

" - } - } - }, - "ErrorCode":{ - "type":"string", - "documentation":"Error code for the exception", - "max":10 - }, - "ExceptionMessage":{ - "type":"string", - "max":10000 - }, - "FailedS3Resource":{ - "type":"structure", - "members":{ - "failedItem":{ - "shape":"S3Resource", - "documentation":"

The failed S3 resources.

" - }, - "errorCode":{ - "shape":"ErrorCode", - "documentation":"

The status code of a failed item.

" - }, - "errorMessage":{ - "shape":"ExceptionMessage", - "documentation":"

The error message of a failed item.

" - } - }, - "documentation":"

Includes details about the failed S3 resources.

" - }, - "FailedS3Resources":{ - "type":"list", - "member":{"shape":"FailedS3Resource"} - }, - "FieldName":{ - "type":"string", - "documentation":"Field that has invalid input", - "max":1000 - }, - "InternalException":{ - "type":"structure", - "members":{ - "errorCode":{"shape":"ErrorCode"}, - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Internal server error.

", - "exception":true, - "fault":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "errorCode":{"shape":"ErrorCode"}, - "message":{"shape":"ExceptionMessage"}, - "fieldName":{"shape":"FieldName"} - }, - "documentation":"

The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

", - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "errorCode":{"shape":"ErrorCode"}, - "message":{"shape":"ExceptionMessage"}, - "resourceType":{"shape":"ResourceType"} - }, - "documentation":"

The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

", - "exception":true - }, - "ListMemberAccountsRequest":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListMemberAccounts action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

Use this parameter to indicate the maximum number of items that you want in the response. The default value is 250.

" - } - } - }, - "ListMemberAccountsResult":{ - "type":"structure", - "members":{ - "memberAccounts":{ - "shape":"MemberAccounts", - "documentation":"

A list of the Amazon Macie member accounts returned by the action. The current master account is also included in this list.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "ListS3ResourcesRequest":{ - "type":"structure", - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The Amazon Macie member account ID whose associated S3 resources you want to list.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter when paginating results. Set its value to null on your first call to the ListS3Resources action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

Use this parameter to indicate the maximum number of items that you want in the response. The default value is 250.

" - } - } - }, - "ListS3ResourcesResult":{ - "type":"structure", - "members":{ - "s3Resources":{ - "shape":"S3ResourcesClassification", - "documentation":"

A list of the associated S3 resources returned by the action.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":250 - }, - "MemberAccount":{ - "type":"structure", - "members":{ - "accountId":{ - "shape":"AWSAccountId", - "documentation":"

The AWS account ID of the Amazon Macie member account.

" - } - }, - "documentation":"

Contains information about the Amazon Macie member account.

" - }, - "MemberAccounts":{ - "type":"list", - "member":{"shape":"MemberAccount"} - }, - "NextToken":{ - "type":"string", - "max":500 - }, - "Prefix":{ - "type":"string", - "max":10000 - }, - "ResourceType":{ - "type":"string", - "documentation":"Resource type that caused the exception", - "max":1000 - }, - "S3ContinuousClassificationType":{ - "type":"string", - "enum":["FULL"] - }, - "S3OneTimeClassificationType":{ - "type":"string", - "enum":[ - "FULL", - "NONE" - ] - }, - "S3Resource":{ - "type":"structure", - "required":["bucketName"], - "members":{ - "bucketName":{ - "shape":"BucketName", - "documentation":"

The name of the S3 bucket.

" - }, - "prefix":{ - "shape":"Prefix", - "documentation":"

The prefix of the S3 bucket.

" - } - }, - "documentation":"

Contains information about the S3 resource. This data type is used as a request parameter in the DisassociateS3Resources action and can be used as a response parameter in the AssociateS3Resources and UpdateS3Resources actions.

" - }, - "S3ResourceClassification":{ - "type":"structure", - "required":[ - "bucketName", - "classificationType" - ], - "members":{ - "bucketName":{ - "shape":"BucketName", - "documentation":"

The name of the S3 bucket that you want to associate with Amazon Macie.

" - }, - "prefix":{ - "shape":"Prefix", - "documentation":"

The prefix of the S3 bucket that you want to associate with Amazon Macie.

" - }, - "classificationType":{ - "shape":"ClassificationType", - "documentation":"

The classification type that you want to specify for the resource associated with Amazon Macie.

" - } - }, - "documentation":"

The S3 resources that you want to associate with Amazon Macie for monitoring and data classification. This data type is used as a request parameter in the AssociateS3Resources action and a response parameter in the ListS3Resources action.

" - }, - "S3ResourceClassificationUpdate":{ - "type":"structure", - "required":[ - "bucketName", - "classificationTypeUpdate" - ], - "members":{ - "bucketName":{ - "shape":"BucketName", - "documentation":"

The name of the S3 bucket whose classification types you want to update.

" - }, - "prefix":{ - "shape":"Prefix", - "documentation":"

The prefix of the S3 bucket whose classification types you want to update.

" - }, - "classificationTypeUpdate":{ - "shape":"ClassificationTypeUpdate", - "documentation":"

The classification type that you want to update for the resource associated with Amazon Macie.

" - } - }, - "documentation":"

The S3 resources whose classification types you want to update. This data type is used as a request parameter in the UpdateS3Resources action.

" - }, - "S3Resources":{ - "type":"list", - "member":{"shape":"S3Resource"} - }, - "S3ResourcesClassification":{ - "type":"list", - "member":{"shape":"S3ResourceClassification"} - }, - "S3ResourcesClassificationUpdate":{ - "type":"list", - "member":{"shape":"S3ResourceClassificationUpdate"} - }, - "UpdateS3ResourcesRequest":{ - "type":"structure", - "required":["s3ResourcesUpdate"], - "members":{ - "memberAccountId":{ - "shape":"AWSAccountId", - "documentation":"

The AWS ID of the Amazon Macie member account whose S3 resources' classification types you want to update.

" - }, - "s3ResourcesUpdate":{ - "shape":"S3ResourcesClassificationUpdate", - "documentation":"

The S3 resources whose classification types you want to update.

" - } - } - }, - "UpdateS3ResourcesResult":{ - "type":"structure", - "members":{ - "failedS3Resources":{ - "shape":"FailedS3Resources", - "documentation":"

The S3 resources whose classification types can't be updated. An error code and an error message are provided for each failed item.

" - } - } - } - }, - "documentation":"Amazon Macie

Amazon Macie is a security service that uses machine learning to automatically discover, classify, and protect sensitive data in AWS. Macie recognizes sensitive data such as personally identifiable information (PII) or intellectual property, and provides you with dashboards and alerts that give visibility into how this data is being accessed or moved. For more information, see the Macie User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/service-2.json deleted file mode 100644 index acdee343..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplace-entitlement/2017-01-11/service-2.json +++ /dev/null @@ -1,183 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-01-11", - "endpointPrefix":"entitlement.marketplace", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Marketplace Entitlement Service", - "serviceId":"Marketplace Entitlement Service", - "signatureVersion":"v4", - "signingName":"aws-marketplace", - "targetPrefix":"AWSMPEntitlementService", - "uid":"entitlement.marketplace-2017-01-11" - }, - "operations":{ - "GetEntitlements":{ - "name":"GetEntitlements", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetEntitlementsRequest"}, - "output":{"shape":"GetEntitlementsResult"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceErrorException"} - ], - "documentation":"

GetEntitlements retrieves entitlement values for a given product. The results can be filtered based on customer identifier or product dimensions.

" - } - }, - "shapes":{ - "Boolean":{"type":"boolean"}, - "Double":{"type":"double"}, - "Entitlement":{ - "type":"structure", - "members":{ - "ProductCode":{ - "shape":"ProductCode", - "documentation":"

The product code for which the given entitlement applies. Product codes are provided by AWS Marketplace when the product listing is created.

" - }, - "Dimension":{ - "shape":"NonEmptyString", - "documentation":"

The dimension for which the given entitlement applies. Dimensions represent categories of capacity in a product and are specified when the product is listed in AWS Marketplace.

" - }, - "CustomerIdentifier":{ - "shape":"NonEmptyString", - "documentation":"

The customer identifier is a handle to each unique customer in an application. Customer identifiers are obtained through the ResolveCustomer operation in AWS Marketplace Metering Service.

" - }, - "Value":{ - "shape":"EntitlementValue", - "documentation":"

The EntitlementValue represents the amount of capacity that the customer is entitled to for the product.

" - }, - "ExpirationDate":{ - "shape":"Timestamp", - "documentation":"

The expiration date represents the minimum date through which this entitlement is expected to remain valid. For contractual products listed on AWS Marketplace, the expiration date is the date at which the customer will renew or cancel their contract. Customers who are opting to renew their contract will still have entitlements with an expiration date.

" - } - }, - "documentation":"

An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.

" - }, - "EntitlementList":{ - "type":"list", - "member":{"shape":"Entitlement"}, - "min":0 - }, - "EntitlementValue":{ - "type":"structure", - "members":{ - "IntegerValue":{ - "shape":"Integer", - "documentation":"

The IntegerValue field will be populated with an integer value when the entitlement is an integer type. Otherwise, the field will not be set.

" - }, - "DoubleValue":{ - "shape":"Double", - "documentation":"

The DoubleValue field will be populated with a double value when the entitlement is a double type. Otherwise, the field will not be set.

" - }, - "BooleanValue":{ - "shape":"Boolean", - "documentation":"

The BooleanValue field will be populated with a boolean value when the entitlement is a boolean type. Otherwise, the field will not be set.

" - }, - "StringValue":{ - "shape":"String", - "documentation":"

The StringValue field will be populated with a string value when the entitlement is a string type. Otherwise, the field will not be set.

" - } - }, - "documentation":"

The EntitlementValue represents the amount of capacity that the customer is entitled to for the product.

" - }, - "ErrorMessage":{"type":"string"}, - "FilterValue":{"type":"string"}, - "FilterValueList":{ - "type":"list", - "member":{"shape":"FilterValue"}, - "min":1 - }, - "GetEntitlementFilterName":{ - "type":"string", - "enum":[ - "CUSTOMER_IDENTIFIER", - "DIMENSION" - ] - }, - "GetEntitlementFilters":{ - "type":"map", - "key":{"shape":"GetEntitlementFilterName"}, - "value":{"shape":"FilterValueList"} - }, - "GetEntitlementsRequest":{ - "type":"structure", - "required":["ProductCode"], - "members":{ - "ProductCode":{ - "shape":"ProductCode", - "documentation":"

Product code is used to uniquely identify a product in AWS Marketplace. The product code will be provided by AWS Marketplace when the product listing is created.

" - }, - "Filter":{ - "shape":"GetEntitlementFilters", - "documentation":"

Filter is used to return entitlements for a specific customer or for a specific dimension. Filters are described as keys mapped to a lists of values. Filtered requests are unioned for each value in the value list, and then intersected for each filter key.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

For paginated calls to GetEntitlements, pass the NextToken from the previous GetEntitlementsResult.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

The maximum number of items to retrieve from the GetEntitlements operation. For pagination, use the NextToken field in subsequent calls to GetEntitlements.

" - } - }, - "documentation":"

The GetEntitlementsRequest contains parameters for the GetEntitlements operation.

" - }, - "GetEntitlementsResult":{ - "type":"structure", - "members":{ - "Entitlements":{ - "shape":"EntitlementList", - "documentation":"

The set of entitlements found through the GetEntitlements operation. If the result contains an empty set of entitlements, NextToken might still be present and should be used.

" - }, - "NextToken":{ - "shape":"NonEmptyString", - "documentation":"

For paginated results, use NextToken in subsequent calls to GetEntitlements. If the result contains an empty set of entitlements, NextToken might still be present and should be used.

" - } - }, - "documentation":"

The GetEntitlementsRequest contains results from the GetEntitlements operation.

" - }, - "Integer":{"type":"integer"}, - "InternalServiceErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.

", - "exception":true, - "fault":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

One or more parameters in your request was invalid.

", - "exception":true - }, - "NonEmptyString":{ - "type":"string", - "pattern":"\\S+" - }, - "ProductCode":{ - "type":"string", - "max":255, - "min":1 - }, - "String":{"type":"string"}, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The calls to the GetEntitlements API are throttled.

", - "exception":true - }, - "Timestamp":{"type":"timestamp"} - }, - "documentation":"AWS Marketplace Entitlement Service

This reference provides descriptions of the AWS Marketplace Entitlement Service API.

AWS Marketplace Entitlement Service is used to determine the entitlement of a customer to a given product. An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.

Getting Entitlement Records

  • GetEntitlements- Gets the entitlements for a Marketplace product.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/service-2.json deleted file mode 100644 index 1b773f64..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/marketplacecommerceanalytics/2015-07-01/service-2.json +++ /dev/null @@ -1,231 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-07-01", - "endpointPrefix":"marketplacecommerceanalytics", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Marketplace Commerce Analytics", - "serviceId":"Marketplace Commerce Analytics", - "signatureVersion":"v4", - "signingName":"marketplacecommerceanalytics", - "targetPrefix":"MarketplaceCommerceAnalytics20150701", - "uid":"marketplacecommerceanalytics-2015-07-01" - }, - "operations":{ - "GenerateDataSet":{ - "name":"GenerateDataSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GenerateDataSetRequest"}, - "output":{"shape":"GenerateDataSetResult"}, - "errors":[ - {"shape":"MarketplaceCommerceAnalyticsException"} - ], - "documentation":"Given a data set type and data set publication date, asynchronously publishes the requested data set to the specified S3 bucket and notifies the specified SNS topic once the data is available. Returns a unique request identifier that can be used to correlate requests with notifications from the SNS topic. Data sets will be published in comma-separated values (CSV) format with the file name {data_set_type}_YYYY-MM-DD.csv. If a file with the same name already exists (e.g. if the same data set is requested twice), the original file will be overwritten by the new file. Requires a Role with an attached permissions policy providing Allow permissions for the following actions: s3:PutObject, s3:GetBucketLocation, sns:GetTopicAttributes, sns:Publish, iam:GetRolePolicy." - }, - "StartSupportDataExport":{ - "name":"StartSupportDataExport", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartSupportDataExportRequest"}, - "output":{"shape":"StartSupportDataExportResult"}, - "errors":[ - {"shape":"MarketplaceCommerceAnalyticsException"} - ], - "documentation":"Given a data set type and a from date, asynchronously publishes the requested customer support data to the specified S3 bucket and notifies the specified SNS topic once the data is available. Returns a unique request identifier that can be used to correlate requests with notifications from the SNS topic. Data sets will be published in comma-separated values (CSV) format with the file name {data_set_type}_YYYY-MM-DD'T'HH-mm-ss'Z'.csv. If a file with the same name already exists (e.g. if the same data set is requested twice), the original file will be overwritten by the new file. Requires a Role with an attached permissions policy providing Allow permissions for the following actions: s3:PutObject, s3:GetBucketLocation, sns:GetTopicAttributes, sns:Publish, iam:GetRolePolicy." - } - }, - "shapes":{ - "CustomerDefinedValues":{ - "type":"map", - "key":{"shape":"OptionalKey"}, - "value":{"shape":"OptionalValue"}, - "max":5, - "min":1 - }, - "DataSetPublicationDate":{"type":"timestamp"}, - "DataSetRequestId":{"type":"string"}, - "DataSetType":{ - "type":"string", - "enum":[ - "customer_subscriber_hourly_monthly_subscriptions", - "customer_subscriber_annual_subscriptions", - "daily_business_usage_by_instance_type", - "daily_business_fees", - "daily_business_free_trial_conversions", - "daily_business_new_instances", - "daily_business_new_product_subscribers", - "daily_business_canceled_product_subscribers", - "monthly_revenue_billing_and_revenue_data", - "monthly_revenue_annual_subscriptions", - "disbursed_amount_by_product", - "disbursed_amount_by_product_with_uncollected_funds", - "disbursed_amount_by_instance_hours", - "disbursed_amount_by_customer_geo", - "disbursed_amount_by_age_of_uncollected_funds", - "disbursed_amount_by_age_of_disbursed_funds", - "customer_profile_by_industry", - "customer_profile_by_revenue", - "customer_profile_by_geography", - "sales_compensation_billed_revenue", - "us_sales_and_use_tax_records" - ], - "max":255, - "min":1 - }, - "DestinationS3BucketName":{ - "type":"string", - "min":1 - }, - "DestinationS3Prefix":{"type":"string"}, - "ExceptionMessage":{"type":"string"}, - "FromDate":{"type":"timestamp"}, - "GenerateDataSetRequest":{ - "type":"structure", - "required":[ - "dataSetType", - "dataSetPublicationDate", - "roleNameArn", - "destinationS3BucketName", - "snsTopicArn" - ], - "members":{ - "dataSetType":{ - "shape":"DataSetType", - "documentation":"

The desired data set type.

  • customer_subscriber_hourly_monthly_subscriptions

    From 2014-07-21 to present: Available daily by 5:00 PM Pacific Time.

  • customer_subscriber_annual_subscriptions

    From 2014-07-21 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_usage_by_instance_type

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_fees

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_free_trial_conversions

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_new_instances

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_new_product_subscribers

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • daily_business_canceled_product_subscribers

    From 2015-01-26 to present: Available daily by 5:00 PM Pacific Time.

  • monthly_revenue_billing_and_revenue_data

    From 2015-02 to 2017-06: Available monthly on the 4th day of the month by 5:00pm Pacific Time. Data includes metered transactions (e.g. hourly) from two months prior.

    From 2017-07 to present: Available monthly on the 15th day of the month by 5:00pm Pacific Time. Data includes metered transactions (e.g. hourly) from one month prior.

  • monthly_revenue_annual_subscriptions

    From 2015-02 to 2017-06: Available monthly on the 4th day of the month by 5:00pm Pacific Time. Data includes up-front software charges (e.g. annual) from one month prior.

    From 2017-07 to present: Available monthly on the 15th day of the month by 5:00pm Pacific Time. Data includes up-front software charges (e.g. annual) from one month prior.

  • disbursed_amount_by_product

    From 2015-01-26 to present: Available every 30 days by 5:00 PM Pacific Time.

  • disbursed_amount_by_product_with_uncollected_funds

    From 2012-04-19 to 2015-01-25: Available every 30 days by 5:00 PM Pacific Time.

    From 2015-01-26 to present: This data set was split into three data sets: disbursed_amount_by_product, disbursed_amount_by_age_of_uncollected_funds, and disbursed_amount_by_age_of_disbursed_funds.

  • disbursed_amount_by_instance_hours

    From 2012-09-04 to present: Available every 30 days by 5:00 PM Pacific Time.

  • disbursed_amount_by_customer_geo

    From 2012-04-19 to present: Available every 30 days by 5:00 PM Pacific Time.

  • disbursed_amount_by_age_of_uncollected_funds

    From 2015-01-26 to present: Available every 30 days by 5:00 PM Pacific Time.

  • disbursed_amount_by_age_of_disbursed_funds

    From 2015-01-26 to present: Available every 30 days by 5:00 PM Pacific Time.

  • customer_profile_by_industry

    From 2015-10-01 to 2017-06-29: Available daily by 5:00 PM Pacific Time.

    From 2017-06-30 to present: This data set is no longer available.

  • customer_profile_by_revenue

    From 2015-10-01 to 2017-06-29: Available daily by 5:00 PM Pacific Time.

    From 2017-06-30 to present: This data set is no longer available.

  • customer_profile_by_geography

    From 2015-10-01 to 2017-06-29: Available daily by 5:00 PM Pacific Time.

    From 2017-06-30 to present: This data set is no longer available.

  • sales_compensation_billed_revenue

    From 2016-12 to 2017-06: Available monthly on the 4th day of the month by 5:00pm Pacific Time. Data includes metered transactions (e.g. hourly) from two months prior, and up-front software charges (e.g. annual) from one month prior.

    From 2017-06 to present: Available monthly on the 15th day of the month by 5:00pm Pacific Time. Data includes metered transactions (e.g. hourly) from one month prior, and up-front software charges (e.g. annual) from one month prior.

  • us_sales_and_use_tax_records

    From 2017-02-15 to present: Available monthly on the 15th day of the month by 5:00 PM Pacific Time.

" - }, - "dataSetPublicationDate":{ - "shape":"DataSetPublicationDate", - "documentation":"The date a data set was published. For daily data sets, provide a date with day-level granularity for the desired day. For weekly data sets, provide a date with day-level granularity within the desired week (the day value will be ignored). For monthly data sets, provide a date with month-level granularity for the desired month (the day value will be ignored)." - }, - "roleNameArn":{ - "shape":"RoleNameArn", - "documentation":"The Amazon Resource Name (ARN) of the Role with an attached permissions policy to interact with the provided AWS services." - }, - "destinationS3BucketName":{ - "shape":"DestinationS3BucketName", - "documentation":"The name (friendly name, not ARN) of the destination S3 bucket." - }, - "destinationS3Prefix":{ - "shape":"DestinationS3Prefix", - "documentation":"(Optional) The desired S3 prefix for the published data set, similar to a directory path in standard file systems. For example, if given the bucket name \"mybucket\" and the prefix \"myprefix/mydatasets\", the output file \"outputfile\" would be published to \"s3://mybucket/myprefix/mydatasets/outputfile\". If the prefix directory structure does not exist, it will be created. If no prefix is provided, the data set will be published to the S3 bucket root." - }, - "snsTopicArn":{ - "shape":"SnsTopicArn", - "documentation":"Amazon Resource Name (ARN) for the SNS Topic that will be notified when the data set has been published or if an error has occurred." - }, - "customerDefinedValues":{ - "shape":"CustomerDefinedValues", - "documentation":"(Optional) Key-value pairs which will be returned, unmodified, in the Amazon SNS notification message and the data set metadata file. These key-value pairs can be used to correlated responses with tracking information from other systems." - } - }, - "documentation":"Container for the parameters to the GenerateDataSet operation." - }, - "GenerateDataSetResult":{ - "type":"structure", - "members":{ - "dataSetRequestId":{ - "shape":"DataSetRequestId", - "documentation":"A unique identifier representing a specific request to the GenerateDataSet operation. This identifier can be used to correlate a request with notifications from the SNS topic." - } - }, - "documentation":"Container for the result of the GenerateDataSet operation." - }, - "MarketplaceCommerceAnalyticsException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"This message describes details of the error." - } - }, - "documentation":"This exception is thrown when an internal service error occurs.", - "exception":true, - "fault":true - }, - "OptionalKey":{ - "type":"string", - "max":255, - "min":1 - }, - "OptionalValue":{ - "type":"string", - "max":255, - "min":1 - }, - "RoleNameArn":{ - "type":"string", - "min":1 - }, - "SnsTopicArn":{ - "type":"string", - "min":1 - }, - "StartSupportDataExportRequest":{ - "type":"structure", - "required":[ - "dataSetType", - "fromDate", - "roleNameArn", - "destinationS3BucketName", - "snsTopicArn" - ], - "members":{ - "dataSetType":{ - "shape":"SupportDataSetType", - "documentation":"

Specifies the data set type to be written to the output csv file. The data set types customer_support_contacts_data and test_customer_support_contacts_data both result in a csv file containing the following fields: Product Id, Product Code, Customer Guid, Subscription Guid, Subscription Start Date, Organization, AWS Account Id, Given Name, Surname, Telephone Number, Email, Title, Country Code, ZIP Code, Operation Type, and Operation Time.

  • customer_support_contacts_data Customer support contact data. The data set will contain all changes (Creates, Updates, and Deletes) to customer support contact data from the date specified in the from_date parameter.
  • test_customer_support_contacts_data An example data set containing static test data in the same format as customer_support_contacts_data

" - }, - "fromDate":{ - "shape":"FromDate", - "documentation":"The start date from which to retrieve the data set in UTC. This parameter only affects the customer_support_contacts_data data set type." - }, - "roleNameArn":{ - "shape":"RoleNameArn", - "documentation":"The Amazon Resource Name (ARN) of the Role with an attached permissions policy to interact with the provided AWS services." - }, - "destinationS3BucketName":{ - "shape":"DestinationS3BucketName", - "documentation":"The name (friendly name, not ARN) of the destination S3 bucket." - }, - "destinationS3Prefix":{ - "shape":"DestinationS3Prefix", - "documentation":"(Optional) The desired S3 prefix for the published data set, similar to a directory path in standard file systems. For example, if given the bucket name \"mybucket\" and the prefix \"myprefix/mydatasets\", the output file \"outputfile\" would be published to \"s3://mybucket/myprefix/mydatasets/outputfile\". If the prefix directory structure does not exist, it will be created. If no prefix is provided, the data set will be published to the S3 bucket root." - }, - "snsTopicArn":{ - "shape":"SnsTopicArn", - "documentation":"Amazon Resource Name (ARN) for the SNS Topic that will be notified when the data set has been published or if an error has occurred." - }, - "customerDefinedValues":{ - "shape":"CustomerDefinedValues", - "documentation":"(Optional) Key-value pairs which will be returned, unmodified, in the Amazon SNS notification message and the data set metadata file." - } - }, - "documentation":"Container for the parameters to the StartSupportDataExport operation." - }, - "StartSupportDataExportResult":{ - "type":"structure", - "members":{ - "dataSetRequestId":{ - "shape":"DataSetRequestId", - "documentation":"A unique identifier representing a specific request to the StartSupportDataExport operation. This identifier can be used to correlate a request with notifications from the SNS topic." - } - }, - "documentation":"Container for the result of the StartSupportDataExport operation." - }, - "SupportDataSetType":{ - "type":"string", - "enum":[ - "customer_support_contacts_data", - "test_customer_support_contacts_data" - ], - "max":255, - "min":1 - } - }, - "documentation":"Provides AWS Marketplace business intelligence data on-demand." -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediaconvert/2017-08-29/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediaconvert/2017-08-29/service-2.json deleted file mode 100644 index 454631b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediaconvert/2017-08-29/service-2.json +++ /dev/null @@ -1,8235 +0,0 @@ -{ - "metadata": { - "apiVersion": "2017-08-29", - "endpointPrefix": "mediaconvert", - "signingName": "mediaconvert", - "serviceFullName": "AWS Elemental MediaConvert", - "serviceId": "MediaConvert", - "protocol": "rest-json", - "jsonVersion": "1.1", - "uid": "mediaconvert-2017-08-29", - "signatureVersion": "v4", - "serviceAbbreviation": "MediaConvert" - }, - "operations": { - "CancelJob": { - "name": "CancelJob", - "http": { - "method": "DELETE", - "requestUri": "/2017-08-29/jobs/{id}", - "responseCode": 202 - }, - "input": { - "shape": "CancelJobRequest" - }, - "output": { - "shape": "CancelJobResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Permanently remove a job from a queue. Once you have canceled a job, you can't start it again. You can't delete a running job." - }, - "CreateJob": { - "name": "CreateJob", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/jobs", - "responseCode": 201 - }, - "input": { - "shape": "CreateJobRequest" - }, - "output": { - "shape": "CreateJobResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Create a new transcoding job. For information about jobs and job settings, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "CreateJobTemplate": { - "name": "CreateJobTemplate", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/jobTemplates", - "responseCode": 201 - }, - "input": { - "shape": "CreateJobTemplateRequest" - }, - "output": { - "shape": "CreateJobTemplateResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Create a new job template. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "CreatePreset": { - "name": "CreatePreset", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/presets", - "responseCode": 201 - }, - "input": { - "shape": "CreatePresetRequest" - }, - "output": { - "shape": "CreatePresetResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Create a new preset. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "CreateQueue": { - "name": "CreateQueue", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/queues", - "responseCode": 201 - }, - "input": { - "shape": "CreateQueueRequest" - }, - "output": { - "shape": "CreateQueueResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Create a new transcoding queue. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "DeleteJobTemplate": { - "name": "DeleteJobTemplate", - "http": { - "method": "DELETE", - "requestUri": "/2017-08-29/jobTemplates/{name}", - "responseCode": 202 - }, - "input": { - "shape": "DeleteJobTemplateRequest" - }, - "output": { - "shape": "DeleteJobTemplateResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Permanently delete a job template you have created." - }, - "DeletePreset": { - "name": "DeletePreset", - "http": { - "method": "DELETE", - "requestUri": "/2017-08-29/presets/{name}", - "responseCode": 202 - }, - "input": { - "shape": "DeletePresetRequest" - }, - "output": { - "shape": "DeletePresetResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Permanently delete a preset you have created." - }, - "DeleteQueue": { - "name": "DeleteQueue", - "http": { - "method": "DELETE", - "requestUri": "/2017-08-29/queues/{name}", - "responseCode": 202 - }, - "input": { - "shape": "DeleteQueueRequest" - }, - "output": { - "shape": "DeleteQueueResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Permanently delete a queue you have created." - }, - "DescribeEndpoints": { - "name": "DescribeEndpoints", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/endpoints", - "responseCode": 200 - }, - "input": { - "shape": "DescribeEndpointsRequest" - }, - "output": { - "shape": "DescribeEndpointsResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "BadRequestException" - }, - { - "shape": "InternalServerErrorException", - "documentation": "InternalServiceException" - }, - { - "shape": "ForbiddenException", - "documentation": "AccessDeniedException" - }, - { - "shape": "NotFoundException", - "documentation": "ResourceNotFoundException" - }, - { - "shape": "TooManyRequestsException", - "documentation": "LimitExceededException" - }, - { - "shape": "ConflictException", - "documentation": "ResourceInUseException" - } - ], - "documentation": "Send an request with an empty body to the regional API endpoint to get your account API endpoint." - }, - "GetJob": { - "name": "GetJob", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/jobs/{id}", - "responseCode": 200 - }, - "input": { - "shape": "GetJobRequest" - }, - "output": { - "shape": "GetJobResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve the JSON for a specific completed transcoding job." - }, - "GetJobTemplate": { - "name": "GetJobTemplate", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/jobTemplates/{name}", - "responseCode": 200 - }, - "input": { - "shape": "GetJobTemplateRequest" - }, - "output": { - "shape": "GetJobTemplateResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve the JSON for a specific job template." - }, - "GetPreset": { - "name": "GetPreset", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/presets/{name}", - "responseCode": 200 - }, - "input": { - "shape": "GetPresetRequest" - }, - "output": { - "shape": "GetPresetResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve the JSON for a specific preset." - }, - "GetQueue": { - "name": "GetQueue", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/queues/{name}", - "responseCode": 200 - }, - "input": { - "shape": "GetQueueRequest" - }, - "output": { - "shape": "GetQueueResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve the JSON for a specific queue." - }, - "ListJobTemplates": { - "name": "ListJobTemplates", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/jobTemplates", - "responseCode": 200 - }, - "input": { - "shape": "ListJobTemplatesRequest" - }, - "output": { - "shape": "ListJobTemplatesResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve a JSON array of up to twenty of your job templates. This will return the templates themselves, not just a list of them. To retrieve the next twenty templates, use the nextToken string returned with the array" - }, - "ListJobs": { - "name": "ListJobs", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/jobs", - "responseCode": 200 - }, - "input": { - "shape": "ListJobsRequest" - }, - "output": { - "shape": "ListJobsResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve a JSON array of up to twenty of your most recently created jobs. This array includes in-process, completed, and errored jobs. This will return the jobs themselves, not just a list of the jobs. To retrieve the twenty next most recent jobs, use the nextToken string returned with the array." - }, - "ListPresets": { - "name": "ListPresets", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/presets", - "responseCode": 200 - }, - "input": { - "shape": "ListPresetsRequest" - }, - "output": { - "shape": "ListPresetsResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve a JSON array of up to twenty of your presets. This will return the presets themselves, not just a list of them. To retrieve the next twenty presets, use the nextToken string returned with the array." - }, - "ListQueues": { - "name": "ListQueues", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/queues", - "responseCode": 200 - }, - "input": { - "shape": "ListQueuesRequest" - }, - "output": { - "shape": "ListQueuesResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve a JSON array of up to twenty of your queues. This will return the queues themselves, not just a list of them. To retrieve the next twenty queues, use the nextToken string returned with the array." - }, - "ListTagsForResource": { - "name": "ListTagsForResource", - "http": { - "method": "GET", - "requestUri": "/2017-08-29/tags/{arn}", - "responseCode": 200 - }, - "input": { - "shape": "ListTagsForResourceRequest" - }, - "output": { - "shape": "ListTagsForResourceResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Retrieve the tags for a MediaConvert resource." - }, - "TagResource": { - "name": "TagResource", - "http": { - "method": "POST", - "requestUri": "/2017-08-29/tags", - "responseCode": 200 - }, - "input": { - "shape": "TagResourceRequest" - }, - "output": { - "shape": "TagResourceResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Tag a MediaConvert queue, preset, or job template. For information about these resource types, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "UntagResource": { - "name": "UntagResource", - "http": { - "method": "DELETE", - "requestUri": "/2017-08-29/tags", - "responseCode": 200 - }, - "input": { - "shape": "UntagResourceRequest" - }, - "output": { - "shape": "UntagResourceResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Untag a MediaConvert queue, preset, or job template. For information about these resource types, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "UpdateJobTemplate": { - "name": "UpdateJobTemplate", - "http": { - "method": "PUT", - "requestUri": "/2017-08-29/jobTemplates/{name}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateJobTemplateRequest" - }, - "output": { - "shape": "UpdateJobTemplateResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Modify one of your existing job templates." - }, - "UpdatePreset": { - "name": "UpdatePreset", - "http": { - "method": "PUT", - "requestUri": "/2017-08-29/presets/{name}", - "responseCode": 200 - }, - "input": { - "shape": "UpdatePresetRequest" - }, - "output": { - "shape": "UpdatePresetResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Modify one of your existing presets." - }, - "UpdateQueue": { - "name": "UpdateQueue", - "http": { - "method": "PUT", - "requestUri": "/2017-08-29/queues/{name}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateQueueRequest" - }, - "output": { - "shape": "UpdateQueueResponse" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - { - "shape": "InternalServerErrorException", - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - { - "shape": "ForbiddenException", - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - { - "shape": "NotFoundException", - "documentation": "The resource you requested does not exist." - }, - { - "shape": "TooManyRequestsException", - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - { - "shape": "ConflictException", - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - } - ], - "documentation": "Modify one of your existing queues." - } - }, - "shapes": { - "AacAudioDescriptionBroadcasterMix": { - "type": "string", - "documentation": "Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains \"broadcaster mixed AD\". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType.", - "enum": [ - "BROADCASTER_MIXED_AD", - "NORMAL" - ] - }, - "AacCodecProfile": { - "type": "string", - "documentation": "AAC Profile.", - "enum": [ - "LC", - "HEV1", - "HEV2" - ] - }, - "AacCodingMode": { - "type": "string", - "documentation": "Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. \"1.0 - Audio Description (Receiver Mix)\" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E.", - "enum": [ - "AD_RECEIVER_MIX", - "CODING_MODE_1_0", - "CODING_MODE_1_1", - "CODING_MODE_2_0", - "CODING_MODE_5_1" - ] - }, - "AacRateControlMode": { - "type": "string", - "documentation": "Rate Control Mode.", - "enum": [ - "CBR", - "VBR" - ] - }, - "AacRawFormat": { - "type": "string", - "documentation": "Enables LATM/LOAS AAC output. Note that if you use LATM/LOAS AAC in an output, you must choose \"No container\" for the output container.", - "enum": [ - "LATM_LOAS", - "NONE" - ] - }, - "AacSettings": { - "type": "structure", - "members": { - "AudioDescriptionBroadcasterMix": { - "shape": "AacAudioDescriptionBroadcasterMix", - "locationName": "audioDescriptionBroadcasterMix" - }, - "Bitrate": { - "shape": "__integerMin6000Max1024000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Defaults and valid values depend on rate control mode and profile." - }, - "CodecProfile": { - "shape": "AacCodecProfile", - "locationName": "codecProfile" - }, - "CodingMode": { - "shape": "AacCodingMode", - "locationName": "codingMode" - }, - "RateControlMode": { - "shape": "AacRateControlMode", - "locationName": "rateControlMode" - }, - "RawFormat": { - "shape": "AacRawFormat", - "locationName": "rawFormat" - }, - "SampleRate": { - "shape": "__integerMin8000Max96000", - "locationName": "sampleRate", - "documentation": "Sample rate in Hz. Valid values depend on rate control mode and profile." - }, - "Specification": { - "shape": "AacSpecification", - "locationName": "specification" - }, - "VbrQuality": { - "shape": "AacVbrQuality", - "locationName": "vbrQuality" - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to \"VBR\" or \"CBR\". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.", - "required": [ - "CodingMode", - "SampleRate" - ] - }, - "AacSpecification": { - "type": "string", - "documentation": "Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers.", - "enum": [ - "MPEG2", - "MPEG4" - ] - }, - "AacVbrQuality": { - "type": "string", - "documentation": "VBR Quality Level - Only used if rate_control_mode is VBR.", - "enum": [ - "LOW", - "MEDIUM_LOW", - "MEDIUM_HIGH", - "HIGH" - ] - }, - "Ac3BitstreamMode": { - "type": "string", - "documentation": "Specifies the \"Bitstream Mode\" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values.", - "enum": [ - "COMPLETE_MAIN", - "COMMENTARY", - "DIALOGUE", - "EMERGENCY", - "HEARING_IMPAIRED", - "MUSIC_AND_EFFECTS", - "VISUALLY_IMPAIRED", - "VOICE_OVER" - ] - }, - "Ac3CodingMode": { - "type": "string", - "documentation": "Dolby Digital coding mode. Determines number of channels.", - "enum": [ - "CODING_MODE_1_0", - "CODING_MODE_1_1", - "CODING_MODE_2_0", - "CODING_MODE_3_2_LFE" - ] - }, - "Ac3DynamicRangeCompressionProfile": { - "type": "string", - "documentation": "If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification.", - "enum": [ - "FILM_STANDARD", - "NONE" - ] - }, - "Ac3LfeFilter": { - "type": "string", - "documentation": "Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "Ac3MetadataControl": { - "type": "string", - "documentation": "When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used.", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ] - }, - "Ac3Settings": { - "type": "structure", - "members": { - "Bitrate": { - "shape": "__integerMin64000Max640000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode." - }, - "BitstreamMode": { - "shape": "Ac3BitstreamMode", - "locationName": "bitstreamMode" - }, - "CodingMode": { - "shape": "Ac3CodingMode", - "locationName": "codingMode" - }, - "Dialnorm": { - "shape": "__integerMin1Max31", - "locationName": "dialnorm", - "documentation": "Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through." - }, - "DynamicRangeCompressionProfile": { - "shape": "Ac3DynamicRangeCompressionProfile", - "locationName": "dynamicRangeCompressionProfile" - }, - "LfeFilter": { - "shape": "Ac3LfeFilter", - "locationName": "lfeFilter" - }, - "MetadataControl": { - "shape": "Ac3MetadataControl", - "locationName": "metadataControl" - }, - "SampleRate": { - "shape": "__integerMin48000Max48000", - "locationName": "sampleRate", - "documentation": "Sample rate in hz. Sample rate is always 48000." - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3." - }, - "AfdSignaling": { - "type": "string", - "documentation": "This setting only applies to H.264 and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.", - "enum": [ - "NONE", - "AUTO", - "FIXED" - ] - }, - "AiffSettings": { - "type": "structure", - "members": { - "BitDepth": { - "shape": "__integerMin16Max24", - "locationName": "bitDepth", - "documentation": "Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track." - }, - "Channels": { - "shape": "__integerMin1Max2", - "locationName": "channels", - "documentation": "Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2." - }, - "SampleRate": { - "shape": "__integerMin8000Max192000", - "locationName": "sampleRate", - "documentation": "Sample rate in hz." - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF." - }, - "AncillarySourceSettings": { - "type": "structure", - "members": { - "SourceAncillaryChannelNumber": { - "shape": "__integerMin1Max4", - "locationName": "sourceAncillaryChannelNumber", - "documentation": "Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough." - } - }, - "documentation": "Settings for ancillary captions source." - }, - "AntiAlias": { - "type": "string", - "documentation": "Enable Anti-alias (AntiAlias) to enhance sharp edges in video output when your input resolution is much larger than your output resolution. Default is enabled.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "AudioCodec": { - "type": "string", - "documentation": "Type of Audio codec.", - "enum": [ - "AAC", - "MP2", - "WAV", - "AIFF", - "AC3", - "EAC3", - "PASSTHROUGH" - ] - }, - "AudioCodecSettings": { - "type": "structure", - "members": { - "AacSettings": { - "shape": "AacSettings", - "locationName": "aacSettings" - }, - "Ac3Settings": { - "shape": "Ac3Settings", - "locationName": "ac3Settings" - }, - "AiffSettings": { - "shape": "AiffSettings", - "locationName": "aiffSettings" - }, - "Codec": { - "shape": "AudioCodec", - "locationName": "codec" - }, - "Eac3Settings": { - "shape": "Eac3Settings", - "locationName": "eac3Settings" - }, - "Mp2Settings": { - "shape": "Mp2Settings", - "locationName": "mp2Settings" - }, - "WavSettings": { - "shape": "WavSettings", - "locationName": "wavSettings" - } - }, - "documentation": "Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3Settings", - "required": [ - "Codec" - ] - }, - "AudioDefaultSelection": { - "type": "string", - "documentation": "Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio.", - "enum": [ - "DEFAULT", - "NOT_DEFAULT" - ] - }, - "AudioDescription": { - "type": "structure", - "members": { - "AudioNormalizationSettings": { - "shape": "AudioNormalizationSettings", - "locationName": "audioNormalizationSettings" - }, - "AudioSourceName": { - "shape": "__string", - "locationName": "audioSourceName", - "documentation": "Specifies which audio data to use from each input. In the simplest case, specify an \"Audio Selector\":#inputs-audio_selector by name based on its order within each input. For example if you specify \"Audio Selector 3\", then the third audio selector will be used from each input. If an input does not have an \"Audio Selector 3\", then the audio selector marked as \"default\" in that input will be used. If there is no audio selector marked as \"default\", silence will be inserted for the duration of that input. Alternatively, an \"Audio Selector Group\":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then \"Audio Selector 1\" will be chosen automatically." - }, - "AudioType": { - "shape": "__integerMin0Max255", - "locationName": "audioType", - "documentation": "Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved." - }, - "AudioTypeControl": { - "shape": "AudioTypeControl", - "locationName": "audioTypeControl" - }, - "CodecSettings": { - "shape": "AudioCodecSettings", - "locationName": "codecSettings" - }, - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input." - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode", - "documentation": "Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input." - }, - "LanguageCodeControl": { - "shape": "AudioLanguageCodeControl", - "locationName": "languageCodeControl" - }, - "RemixSettings": { - "shape": "RemixSettings", - "locationName": "remixSettings", - "documentation": "Advanced audio remixing settings." - }, - "StreamName": { - "shape": "__stringPatternWS", - "locationName": "streamName", - "documentation": "Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal." - } - }, - "documentation": "Description of audio output", - "required": [ - "CodecSettings" - ] - }, - "AudioLanguageCodeControl": { - "type": "string", - "documentation": "Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input.", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ] - }, - "AudioNormalizationAlgorithm": { - "type": "string", - "documentation": "Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification.", - "enum": [ - "ITU_BS_1770_1", - "ITU_BS_1770_2" - ] - }, - "AudioNormalizationAlgorithmControl": { - "type": "string", - "documentation": "When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.", - "enum": [ - "CORRECT_AUDIO", - "MEASURE_ONLY" - ] - }, - "AudioNormalizationLoudnessLogging": { - "type": "string", - "documentation": "If set to LOG, log each output's audio track loudness to a CSV file.", - "enum": [ - "LOG", - "DONT_LOG" - ] - }, - "AudioNormalizationPeakCalculation": { - "type": "string", - "documentation": "If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.", - "enum": [ - "TRUE_PEAK", - "NONE" - ] - }, - "AudioNormalizationSettings": { - "type": "structure", - "members": { - "Algorithm": { - "shape": "AudioNormalizationAlgorithm", - "locationName": "algorithm" - }, - "AlgorithmControl": { - "shape": "AudioNormalizationAlgorithmControl", - "locationName": "algorithmControl" - }, - "CorrectionGateLevel": { - "shape": "__integerMinNegative70Max0", - "locationName": "correctionGateLevel", - "documentation": "Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction." - }, - "LoudnessLogging": { - "shape": "AudioNormalizationLoudnessLogging", - "locationName": "loudnessLogging" - }, - "PeakCalculation": { - "shape": "AudioNormalizationPeakCalculation", - "locationName": "peakCalculation" - }, - "TargetLkfs": { - "shape": "__doubleMinNegative59Max0", - "locationName": "targetLkfs", - "documentation": "Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS." - } - }, - "documentation": "Advanced audio normalization settings." - }, - "AudioSelector": { - "type": "structure", - "members": { - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code" - }, - "DefaultSelection": { - "shape": "AudioDefaultSelection", - "locationName": "defaultSelection" - }, - "ExternalAudioFileInput": { - "shape": "__stringPatternS3MM2VVMMPPEEGGAAVVIIMMPP4FFLLVVMMPPTTMMPPGGMM4VVTTRRPPFF4VVMM2TTSSTTSS264HH264MMKKVVMMOOVVMMTTSSMM2TTWWMMVVAASSFFVVOOBB3GGPP3GGPPPPMMXXFFDDIIVVXXXXVVIIDDRRAAWWDDVVGGXXFFMM1VV3GG2VVMMFFMM3UU8LLCCHHGGXXFFMMPPEEGG2MMXXFFMMPPEEGG2MMXXFFHHDDWWAAVVYY4MMAAAACCAAIIFFFFMMPP2AACC3EECC3DDTTSSEE", - "locationName": "externalAudioFileInput", - "documentation": "Specifies audio data from an external file source." - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode", - "documentation": "Selects a specific language code from within an audio source." - }, - "Offset": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "offset", - "documentation": "Specifies a time delta in milliseconds to offset the audio from the input video." - }, - "Pids": { - "shape": "__listOf__integerMin1Max2147483647", - "locationName": "pids", - "documentation": "Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101)." - }, - "ProgramSelection": { - "shape": "__integerMin0Max8", - "locationName": "programSelection", - "documentation": "Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track." - }, - "RemixSettings": { - "shape": "RemixSettings", - "locationName": "remixSettings", - "documentation": "Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other." - }, - "SelectorType": { - "shape": "AudioSelectorType", - "locationName": "selectorType" - }, - "Tracks": { - "shape": "__listOf__integerMin1Max2147483647", - "locationName": "tracks", - "documentation": "Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type \"1,2,3\" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, \"tracks\": [1,2,3]." - } - }, - "documentation": "Selector for Audio" - }, - "AudioSelectorGroup": { - "type": "structure", - "members": { - "AudioSelectorNames": { - "shape": "__listOf__stringMin1", - "locationName": "audioSelectorNames", - "documentation": "Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., \"Audio Selector 1\"). The audio selector name parameter can be repeated to add any number of audio selectors to the group." - } - }, - "documentation": "Group of Audio Selectors", - "required": [ - "AudioSelectorNames" - ] - }, - "AudioSelectorType": { - "type": "string", - "documentation": "Specifies the type of the audio selector.", - "enum": [ - "PID", - "TRACK", - "LANGUAGE_CODE" - ] - }, - "AudioTypeControl": { - "type": "string", - "documentation": "When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD.", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ] - }, - "AvailBlanking": { - "type": "structure", - "members": { - "AvailBlankingImage": { - "shape": "__stringMin14PatternS3BmpBMPPngPNG", - "locationName": "availBlankingImage", - "documentation": "Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported." - } - }, - "documentation": "Settings for Avail Blanking" - }, - "BadRequestException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 400 - }, - "documentation": "The service can't process your request because of a problem in the request. Please check your request form and syntax." - }, - "BurninDestinationSettings": { - "type": "structure", - "members": { - "Alignment": { - "shape": "BurninSubtitleAlignment", - "locationName": "alignment" - }, - "BackgroundColor": { - "shape": "BurninSubtitleBackgroundColor", - "locationName": "backgroundColor" - }, - "BackgroundOpacity": { - "shape": "__integerMin0Max255", - "locationName": "backgroundOpacity", - "documentation": "Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "FontColor": { - "shape": "BurninSubtitleFontColor", - "locationName": "fontColor" - }, - "FontOpacity": { - "shape": "__integerMin0Max255", - "locationName": "fontOpacity", - "documentation": "Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent.\nAll burn-in and DVB-Sub font settings must match." - }, - "FontResolution": { - "shape": "__integerMin96Max600", - "locationName": "fontResolution", - "documentation": "Font resolution in DPI (dots per inch); default is 96 dpi.\nAll burn-in and DVB-Sub font settings must match." - }, - "FontSize": { - "shape": "__integerMin0Max96", - "locationName": "fontSize", - "documentation": "A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match." - }, - "OutlineColor": { - "shape": "BurninSubtitleOutlineColor", - "locationName": "outlineColor" - }, - "OutlineSize": { - "shape": "__integerMin0Max10", - "locationName": "outlineSize", - "documentation": "Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "ShadowColor": { - "shape": "BurninSubtitleShadowColor", - "locationName": "shadowColor" - }, - "ShadowOpacity": { - "shape": "__integerMin0Max255", - "locationName": "shadowOpacity", - "documentation": "Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "ShadowXOffset": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "shadowXOffset", - "documentation": "Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match." - }, - "ShadowYOffset": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "shadowYOffset", - "documentation": "Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match." - }, - "TeletextSpacing": { - "shape": "BurninSubtitleTeletextSpacing", - "locationName": "teletextSpacing" - }, - "XPosition": { - "shape": "__integerMin0Max2147483647", - "locationName": "xPosition", - "documentation": "Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "YPosition": { - "shape": "__integerMin0Max2147483647", - "locationName": "yPosition", - "documentation": "Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - } - }, - "documentation": "Burn-In Destination Settings.", - "required": [ - "OutlineColor", - "Alignment", - "OutlineSize", - "FontOpacity" - ] - }, - "BurninSubtitleAlignment": { - "type": "string", - "documentation": "If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "CENTERED", - "LEFT" - ] - }, - "BurninSubtitleBackgroundColor": { - "type": "string", - "documentation": "Specifies the color of the rectangle behind the captions.\nAll burn-in and DVB-Sub font settings must match.", - "enum": [ - "NONE", - "BLACK", - "WHITE" - ] - }, - "BurninSubtitleFontColor": { - "type": "string", - "documentation": "Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "WHITE", - "BLACK", - "YELLOW", - "RED", - "GREEN", - "BLUE" - ] - }, - "BurninSubtitleOutlineColor": { - "type": "string", - "documentation": "Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "BLACK", - "WHITE", - "YELLOW", - "RED", - "GREEN", - "BLUE" - ] - }, - "BurninSubtitleShadowColor": { - "type": "string", - "documentation": "Specifies the color of the shadow cast by the captions.\nAll burn-in and DVB-Sub font settings must match.", - "enum": [ - "NONE", - "BLACK", - "WHITE" - ] - }, - "BurninSubtitleTeletextSpacing": { - "type": "string", - "documentation": "Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption.", - "enum": [ - "FIXED_GRID", - "PROPORTIONAL" - ] - }, - "CancelJobRequest": { - "type": "structure", - "members": { - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The Job ID of the job to be cancelled.", - "location": "uri" - } - }, - "required": [ - "Id" - ] - }, - "CancelJobResponse": { - "type": "structure", - "members": { - } - }, - "CaptionDescription": { - "type": "structure", - "members": { - "CaptionSelectorName": { - "shape": "__stringMin1", - "locationName": "captionSelectorName", - "documentation": "Specifies which \"Caption Selector\":#inputs-caption_selector to use from each input when generating captions. The name should be of the format \"Caption Selector \", which denotes that the Nth Caption Selector will be used from each input." - }, - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code" - }, - "DestinationSettings": { - "shape": "CaptionDestinationSettings", - "locationName": "destinationSettings" - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode", - "documentation": "Indicates the language of the caption output track." - }, - "LanguageDescription": { - "shape": "__string", - "locationName": "languageDescription", - "documentation": "Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal." - } - }, - "documentation": "Description of Caption output", - "required": [ - "DestinationSettings", - "CaptionSelectorName" - ] - }, - "CaptionDescriptionPreset": { - "type": "structure", - "members": { - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code" - }, - "DestinationSettings": { - "shape": "CaptionDestinationSettings", - "locationName": "destinationSettings" - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode", - "documentation": "Indicates the language of the caption output track." - }, - "LanguageDescription": { - "shape": "__string", - "locationName": "languageDescription", - "documentation": "Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal." - } - }, - "documentation": "Caption Description for preset", - "required": [ - "DestinationSettings" - ] - }, - "CaptionDestinationSettings": { - "type": "structure", - "members": { - "BurninDestinationSettings": { - "shape": "BurninDestinationSettings", - "locationName": "burninDestinationSettings" - }, - "DestinationType": { - "shape": "CaptionDestinationType", - "locationName": "destinationType" - }, - "DvbSubDestinationSettings": { - "shape": "DvbSubDestinationSettings", - "locationName": "dvbSubDestinationSettings" - }, - "SccDestinationSettings": { - "shape": "SccDestinationSettings", - "locationName": "sccDestinationSettings" - }, - "TeletextDestinationSettings": { - "shape": "TeletextDestinationSettings", - "locationName": "teletextDestinationSettings" - }, - "TtmlDestinationSettings": { - "shape": "TtmlDestinationSettings", - "locationName": "ttmlDestinationSettings" - } - }, - "documentation": "Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.", - "required": [ - "DestinationType" - ] - }, - "CaptionDestinationType": { - "type": "string", - "documentation": "Type of Caption output, including Burn-In, Embedded, SCC, SRT, TTML, WebVTT, DVB-Sub, Teletext.", - "enum": [ - "BURN_IN", - "DVB_SUB", - "EMBEDDED", - "SCC", - "SRT", - "TELETEXT", - "TTML", - "WEBVTT" - ] - }, - "CaptionSelector": { - "type": "structure", - "members": { - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions." - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode", - "documentation": "The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions." - }, - "SourceSettings": { - "shape": "CaptionSourceSettings", - "locationName": "sourceSettings" - } - }, - "documentation": "Set up captions in your outputs by first selecting them from your input here.", - "required": [ - "SourceSettings" - ] - }, - "CaptionSourceSettings": { - "type": "structure", - "members": { - "AncillarySourceSettings": { - "shape": "AncillarySourceSettings", - "locationName": "ancillarySourceSettings" - }, - "DvbSubSourceSettings": { - "shape": "DvbSubSourceSettings", - "locationName": "dvbSubSourceSettings" - }, - "EmbeddedSourceSettings": { - "shape": "EmbeddedSourceSettings", - "locationName": "embeddedSourceSettings" - }, - "FileSourceSettings": { - "shape": "FileSourceSettings", - "locationName": "fileSourceSettings" - }, - "SourceType": { - "shape": "CaptionSourceType", - "locationName": "sourceType" - }, - "TeletextSourceSettings": { - "shape": "TeletextSourceSettings", - "locationName": "teletextSourceSettings" - } - }, - "documentation": "Source settings (SourceSettings) contains the group of settings for captions in the input.", - "required": [ - "SourceType" - ] - }, - "CaptionSourceType": { - "type": "string", - "documentation": "Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format.", - "enum": [ - "ANCILLARY", - "DVB_SUB", - "EMBEDDED", - "SCC", - "TTML", - "STL", - "SRT", - "TELETEXT", - "NULL_SOURCE" - ] - }, - "ChannelMapping": { - "type": "structure", - "members": { - "OutputChannels": { - "shape": "__listOfOutputChannelMapping", - "locationName": "outputChannels", - "documentation": "List of output channels" - } - }, - "documentation": "Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).", - "required": [ - "OutputChannels" - ] - }, - "CmafClientCache": { - "type": "string", - "documentation": "When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "CmafCodecSpecification": { - "type": "string", - "documentation": "Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation.", - "enum": [ - "RFC_6381", - "RFC_4281" - ] - }, - "CmafEncryptionSettings": { - "type": "structure", - "members": { - "ConstantInitializationVector": { - "shape": "__stringMin32Max32Pattern09aFAF32", - "locationName": "constantInitializationVector", - "documentation": "This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default." - }, - "EncryptionMethod": { - "shape": "CmafEncryptionType", - "locationName": "encryptionMethod" - }, - "InitializationVectorInManifest": { - "shape": "CmafInitializationVectorInManifest", - "locationName": "initializationVectorInManifest" - }, - "StaticKeyProvider": { - "shape": "StaticKeyProvider", - "locationName": "staticKeyProvider" - }, - "Type": { - "shape": "CmafKeyProviderType", - "locationName": "type" - } - }, - "documentation": "Settings for CMAF encryption", - "required": [ - "Type" - ] - }, - "CmafEncryptionType": { - "type": "string", - "documentation": "Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption.", - "enum": [ - "SAMPLE_AES" - ] - }, - "CmafGroupSettings": { - "type": "structure", - "members": { - "BaseUrl": { - "shape": "__string", - "locationName": "baseUrl", - "documentation": "A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file." - }, - "ClientCache": { - "shape": "CmafClientCache", - "locationName": "clientCache" - }, - "CodecSpecification": { - "shape": "CmafCodecSpecification", - "locationName": "codecSpecification" - }, - "Destination": { - "shape": "__stringPatternS3", - "locationName": "destination", - "documentation": "Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file." - }, - "Encryption": { - "shape": "CmafEncryptionSettings", - "locationName": "encryption", - "documentation": "DRM settings." - }, - "FragmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "fragmentLength", - "documentation": "Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types." - }, - "ManifestCompression": { - "shape": "CmafManifestCompression", - "locationName": "manifestCompression" - }, - "ManifestDurationFormat": { - "shape": "CmafManifestDurationFormat", - "locationName": "manifestDurationFormat" - }, - "MinBufferTime": { - "shape": "__integerMin0Max2147483647", - "locationName": "minBufferTime", - "documentation": "Minimum time of initially buffered media that is needed to ensure smooth playout." - }, - "MinFinalSegmentLength": { - "shape": "__doubleMin0Max2147483647", - "locationName": "minFinalSegmentLength", - "documentation": "Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds." - }, - "SegmentControl": { - "shape": "CmafSegmentControl", - "locationName": "segmentControl" - }, - "SegmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "segmentLength", - "documentation": "Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment." - }, - "StreamInfResolution": { - "shape": "CmafStreamInfResolution", - "locationName": "streamInfResolution" - }, - "WriteDashManifest": { - "shape": "CmafWriteDASHManifest", - "locationName": "writeDashManifest" - }, - "WriteHlsManifest": { - "shape": "CmafWriteHLSManifest", - "locationName": "writeHlsManifest" - } - }, - "documentation": "Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.", - "required": [ - "FragmentLength", - "SegmentLength" - ] - }, - "CmafInitializationVectorInManifest": { - "type": "string", - "documentation": "The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "CmafKeyProviderType": { - "type": "string", - "documentation": "Indicates which type of key provider is used for encryption.", - "enum": [ - "STATIC_KEY" - ] - }, - "CmafManifestCompression": { - "type": "string", - "documentation": "When set to GZIP, compresses HLS playlist.", - "enum": [ - "GZIP", - "NONE" - ] - }, - "CmafManifestDurationFormat": { - "type": "string", - "documentation": "Indicates whether the output manifest should use floating point values for segment duration.", - "enum": [ - "FLOATING_POINT", - "INTEGER" - ] - }, - "CmafSegmentControl": { - "type": "string", - "documentation": "When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created.", - "enum": [ - "SINGLE_FILE", - "SEGMENTED_FILES" - ] - }, - "CmafStreamInfResolution": { - "type": "string", - "documentation": "Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "CmafWriteDASHManifest": { - "type": "string", - "documentation": "When set to ENABLED, a DASH MPD manifest will be generated for this output.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "CmafWriteHLSManifest": { - "type": "string", - "documentation": "When set to ENABLED, an Apple HLS manifest will be generated for this output.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "ColorCorrector": { - "type": "structure", - "members": { - "Brightness": { - "shape": "__integerMin1Max100", - "locationName": "brightness", - "documentation": "Brightness level." - }, - "ColorSpaceConversion": { - "shape": "ColorSpaceConversion", - "locationName": "colorSpaceConversion" - }, - "Contrast": { - "shape": "__integerMin1Max100", - "locationName": "contrast", - "documentation": "Contrast level." - }, - "Hdr10Metadata": { - "shape": "Hdr10Metadata", - "locationName": "hdr10Metadata" - }, - "Hue": { - "shape": "__integerMinNegative180Max180", - "locationName": "hue", - "documentation": "Hue in degrees." - }, - "Saturation": { - "shape": "__integerMin1Max100", - "locationName": "saturation", - "documentation": "Saturation level." - } - }, - "documentation": "Settings for color correction." - }, - "ColorMetadata": { - "type": "string", - "documentation": "Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default.", - "enum": [ - "IGNORE", - "INSERT" - ] - }, - "ColorSpace": { - "type": "string", - "documentation": "If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values.", - "enum": [ - "FOLLOW", - "REC_601", - "REC_709", - "HDR10", - "HLG_2020" - ] - }, - "ColorSpaceConversion": { - "type": "string", - "documentation": "Determines if colorspace conversion will be performed. If set to _None_, no conversion will be performed. If _Force 601_ or _Force 709_ are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the \"Video Selector\":#inputs-video_selector if necessary.", - "enum": [ - "NONE", - "FORCE_601", - "FORCE_709", - "FORCE_HDR10", - "FORCE_HLG_2020" - ] - }, - "ColorSpaceUsage": { - "type": "string", - "documentation": "There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available.", - "enum": [ - "FORCE", - "FALLBACK" - ] - }, - "ConflictException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 409 - }, - "documentation": "The service could not complete your request because there is a conflict with the current state of the resource." - }, - "ContainerSettings": { - "type": "structure", - "members": { - "Container": { - "shape": "ContainerType", - "locationName": "container" - }, - "F4vSettings": { - "shape": "F4vSettings", - "locationName": "f4vSettings" - }, - "M2tsSettings": { - "shape": "M2tsSettings", - "locationName": "m2tsSettings" - }, - "M3u8Settings": { - "shape": "M3u8Settings", - "locationName": "m3u8Settings" - }, - "MovSettings": { - "shape": "MovSettings", - "locationName": "movSettings" - }, - "Mp4Settings": { - "shape": "Mp4Settings", - "locationName": "mp4Settings" - } - }, - "documentation": "Container specific settings.", - "required": [ - "Container" - ] - }, - "ContainerType": { - "type": "string", - "documentation": "Container for this output. Some containers require a container settings object. If not specified, the default object will be created.", - "enum": [ - "F4V", - "ISMV", - "M2TS", - "M3U8", - "CMFC", - "MOV", - "MP4", - "MPD", - "MXF", - "RAW" - ] - }, - "CreateJobRequest": { - "type": "structure", - "members": { - "ClientRequestToken": { - "shape": "__string", - "locationName": "clientRequestToken", - "documentation": "Idempotency token for CreateJob operation.", - "idempotencyToken": true - }, - "JobTemplate": { - "shape": "__string", - "locationName": "jobTemplate", - "documentation": "When you create a job, you can either specify a job template or specify the transcoding settings individually" - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html." - }, - "Role": { - "shape": "__string", - "locationName": "role", - "documentation": "Required. The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html." - }, - "Settings": { - "shape": "JobSettings", - "locationName": "settings" - }, - "UserMetadata": { - "shape": "__mapOf__string", - "locationName": "userMetadata", - "documentation": "User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs." - } - }, - "required": [ - "Role", - "Settings" - ] - }, - "CreateJobResponse": { - "type": "structure", - "members": { - "Job": { - "shape": "Job", - "locationName": "job" - } - } - }, - "CreateJobTemplateRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "Optional. A category for the job template you are creating" - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "Optional. A description of the job template you are creating." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the job template you are creating." - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue." - }, - "Settings": { - "shape": "JobTemplateSettings", - "locationName": "settings" - }, - "Tags": { - "shape": "__mapOf__string", - "locationName": "tags", - "documentation": "The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key." - } - }, - "required": [ - "Settings", - "Name" - ] - }, - "CreateJobTemplateResponse": { - "type": "structure", - "members": { - "JobTemplate": { - "shape": "JobTemplate", - "locationName": "jobTemplate" - } - } - }, - "CreatePresetRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "Optional. A category for the preset you are creating." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "Optional. A description of the preset you are creating." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the preset you are creating." - }, - "Settings": { - "shape": "PresetSettings", - "locationName": "settings" - }, - "Tags": { - "shape": "__mapOf__string", - "locationName": "tags", - "documentation": "The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key." - } - }, - "required": [ - "Settings", - "Name" - ] - }, - "CreatePresetResponse": { - "type": "structure", - "members": { - "Preset": { - "shape": "Preset", - "locationName": "preset" - } - } - }, - "CreateQueueRequest": { - "type": "structure", - "members": { - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "Optional. A description of the queue you are creating." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the queue you are creating." - }, - "Tags": { - "shape": "__mapOf__string", - "locationName": "tags", - "documentation": "The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key." - } - }, - "required": [ - "Name" - ] - }, - "CreateQueueResponse": { - "type": "structure", - "members": { - "Queue": { - "shape": "Queue", - "locationName": "queue" - } - } - }, - "DashIsoEncryptionSettings": { - "type": "structure", - "members": { - "SpekeKeyProvider": { - "shape": "SpekeKeyProvider", - "locationName": "spekeKeyProvider" - } - }, - "documentation": "Specifies DRM settings for DASH outputs.", - "required": [ - "SpekeKeyProvider" - ] - }, - "DashIsoGroupSettings": { - "type": "structure", - "members": { - "BaseUrl": { - "shape": "__string", - "locationName": "baseUrl", - "documentation": "A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file." - }, - "Destination": { - "shape": "__stringPatternS3", - "locationName": "destination", - "documentation": "Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file." - }, - "Encryption": { - "shape": "DashIsoEncryptionSettings", - "locationName": "encryption", - "documentation": "DRM settings." - }, - "FragmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "fragmentLength", - "documentation": "Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types." - }, - "HbbtvCompliance": { - "shape": "DashIsoHbbtvCompliance", - "locationName": "hbbtvCompliance" - }, - "MinBufferTime": { - "shape": "__integerMin0Max2147483647", - "locationName": "minBufferTime", - "documentation": "Minimum time of initially buffered media that is needed to ensure smooth playout." - }, - "SegmentControl": { - "shape": "DashIsoSegmentControl", - "locationName": "segmentControl" - }, - "SegmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "segmentLength", - "documentation": "Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types." - } - }, - "documentation": "Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.", - "required": [ - "SegmentLength", - "FragmentLength" - ] - }, - "DashIsoHbbtvCompliance": { - "type": "string", - "documentation": "Supports HbbTV specification as indicated", - "enum": [ - "HBBTV_1_5", - "NONE" - ] - }, - "DashIsoSegmentControl": { - "type": "string", - "documentation": "When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created.", - "enum": [ - "SINGLE_FILE", - "SEGMENTED_FILES" - ] - }, - "DeinterlaceAlgorithm": { - "type": "string", - "documentation": "Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame.", - "enum": [ - "INTERPOLATE", - "INTERPOLATE_TICKER", - "BLEND", - "BLEND_TICKER" - ] - }, - "Deinterlacer": { - "type": "structure", - "members": { - "Algorithm": { - "shape": "DeinterlaceAlgorithm", - "locationName": "algorithm" - }, - "Control": { - "shape": "DeinterlacerControl", - "locationName": "control" - }, - "Mode": { - "shape": "DeinterlacerMode", - "locationName": "mode" - } - }, - "documentation": "Settings for deinterlacer" - }, - "DeinterlacerControl": { - "type": "string", - "documentation": "- When set to NORMAL (default), the deinterlacer does not convert frames that are tagged in metadata as progressive. It will only convert those that are tagged as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video.", - "enum": [ - "FORCE_ALL_FRAMES", - "NORMAL" - ] - }, - "DeinterlacerMode": { - "type": "string", - "documentation": "Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive.", - "enum": [ - "DEINTERLACE", - "INVERSE_TELECINE", - "ADAPTIVE" - ] - }, - "DeleteJobTemplateRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the job template to be deleted.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "DeleteJobTemplateResponse": { - "type": "structure", - "members": { - } - }, - "DeletePresetRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the preset to be deleted.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "DeletePresetResponse": { - "type": "structure", - "members": { - } - }, - "DeleteQueueRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the queue to be deleted.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "DeleteQueueResponse": { - "type": "structure", - "members": { - } - }, - "DescribeEndpointsRequest": { - "type": "structure", - "members": { - "MaxResults": { - "shape": "__integer", - "locationName": "maxResults", - "documentation": "Optional. Max number of endpoints, up to twenty, that will be returned at one time." - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string, provided with the response to a previous request, to request the next batch of endpoints." - } - }, - "documentation": "DescribeEndpointsRequest" - }, - "DescribeEndpointsResponse": { - "type": "structure", - "members": { - "Endpoints": { - "shape": "__listOfEndpoint", - "locationName": "endpoints", - "documentation": "List of endpoints" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string to request the next batch of endpoints." - } - } - }, - "DropFrameTimecode": { - "type": "string", - "documentation": "Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "DvbNitSettings": { - "type": "structure", - "members": { - "NetworkId": { - "shape": "__integerMin0Max65535", - "locationName": "networkId", - "documentation": "The numeric value placed in the Network Information Table (NIT)." - }, - "NetworkName": { - "shape": "__stringMin1Max256", - "locationName": "networkName", - "documentation": "The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters." - }, - "NitInterval": { - "shape": "__integerMin25Max10000", - "locationName": "nitInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - } - }, - "documentation": "Inserts DVB Network Information Table (NIT) at the specified table repetition interval.", - "required": [ - "NetworkName", - "NitInterval", - "NetworkId" - ] - }, - "DvbSdtSettings": { - "type": "structure", - "members": { - "OutputSdt": { - "shape": "OutputSdt", - "locationName": "outputSdt" - }, - "SdtInterval": { - "shape": "__integerMin25Max2000", - "locationName": "sdtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "ServiceName": { - "shape": "__stringMin1Max256", - "locationName": "serviceName", - "documentation": "The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters." - }, - "ServiceProviderName": { - "shape": "__stringMin1Max256", - "locationName": "serviceProviderName", - "documentation": "The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters." - } - }, - "documentation": "Inserts DVB Service Description Table (NIT) at the specified table repetition interval." - }, - "DvbSubDestinationSettings": { - "type": "structure", - "members": { - "Alignment": { - "shape": "DvbSubtitleAlignment", - "locationName": "alignment" - }, - "BackgroundColor": { - "shape": "DvbSubtitleBackgroundColor", - "locationName": "backgroundColor" - }, - "BackgroundOpacity": { - "shape": "__integerMin0Max255", - "locationName": "backgroundOpacity", - "documentation": "Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "FontColor": { - "shape": "DvbSubtitleFontColor", - "locationName": "fontColor" - }, - "FontOpacity": { - "shape": "__integerMin0Max255", - "locationName": "fontOpacity", - "documentation": "Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent.\nAll burn-in and DVB-Sub font settings must match." - }, - "FontResolution": { - "shape": "__integerMin96Max600", - "locationName": "fontResolution", - "documentation": "Font resolution in DPI (dots per inch); default is 96 dpi.\nAll burn-in and DVB-Sub font settings must match." - }, - "FontSize": { - "shape": "__integerMin0Max96", - "locationName": "fontSize", - "documentation": "A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match." - }, - "OutlineColor": { - "shape": "DvbSubtitleOutlineColor", - "locationName": "outlineColor" - }, - "OutlineSize": { - "shape": "__integerMin0Max10", - "locationName": "outlineSize", - "documentation": "Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "ShadowColor": { - "shape": "DvbSubtitleShadowColor", - "locationName": "shadowColor" - }, - "ShadowOpacity": { - "shape": "__integerMin0Max255", - "locationName": "shadowOpacity", - "documentation": "Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "ShadowXOffset": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "shadowXOffset", - "documentation": "Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match." - }, - "ShadowYOffset": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "shadowYOffset", - "documentation": "Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match." - }, - "TeletextSpacing": { - "shape": "DvbSubtitleTeletextSpacing", - "locationName": "teletextSpacing" - }, - "XPosition": { - "shape": "__integerMin0Max2147483647", - "locationName": "xPosition", - "documentation": "Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "YPosition": { - "shape": "__integerMin0Max2147483647", - "locationName": "yPosition", - "documentation": "Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - } - }, - "documentation": "DVB-Sub Destination Settings", - "required": [ - "OutlineColor", - "Alignment", - "OutlineSize", - "FontOpacity" - ] - }, - "DvbSubSourceSettings": { - "type": "structure", - "members": { - "Pid": { - "shape": "__integerMin1Max2147483647", - "locationName": "pid", - "documentation": "When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors." - } - }, - "documentation": "DVB Sub Source Settings" - }, - "DvbSubtitleAlignment": { - "type": "string", - "documentation": "If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "CENTERED", - "LEFT" - ] - }, - "DvbSubtitleBackgroundColor": { - "type": "string", - "documentation": "Specifies the color of the rectangle behind the captions.\nAll burn-in and DVB-Sub font settings must match.", - "enum": [ - "NONE", - "BLACK", - "WHITE" - ] - }, - "DvbSubtitleFontColor": { - "type": "string", - "documentation": "Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "WHITE", - "BLACK", - "YELLOW", - "RED", - "GREEN", - "BLUE" - ] - }, - "DvbSubtitleOutlineColor": { - "type": "string", - "documentation": "Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.", - "enum": [ - "BLACK", - "WHITE", - "YELLOW", - "RED", - "GREEN", - "BLUE" - ] - }, - "DvbSubtitleShadowColor": { - "type": "string", - "documentation": "Specifies the color of the shadow cast by the captions.\nAll burn-in and DVB-Sub font settings must match.", - "enum": [ - "NONE", - "BLACK", - "WHITE" - ] - }, - "DvbSubtitleTeletextSpacing": { - "type": "string", - "documentation": "Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption.", - "enum": [ - "FIXED_GRID", - "PROPORTIONAL" - ] - }, - "DvbTdtSettings": { - "type": "structure", - "members": { - "TdtInterval": { - "shape": "__integerMin1000Max30000", - "locationName": "tdtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - } - }, - "documentation": "Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.", - "required": [ - "TdtInterval" - ] - }, - "Eac3AttenuationControl": { - "type": "string", - "documentation": "If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode.", - "enum": [ - "ATTENUATE_3_DB", - "NONE" - ] - }, - "Eac3BitstreamMode": { - "type": "string", - "documentation": "Specifies the \"Bitstream Mode\" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values.", - "enum": [ - "COMPLETE_MAIN", - "COMMENTARY", - "EMERGENCY", - "HEARING_IMPAIRED", - "VISUALLY_IMPAIRED" - ] - }, - "Eac3CodingMode": { - "type": "string", - "documentation": "Dolby Digital Plus coding mode. Determines number of channels.", - "enum": [ - "CODING_MODE_1_0", - "CODING_MODE_2_0", - "CODING_MODE_3_2" - ] - }, - "Eac3DcFilter": { - "type": "string", - "documentation": "Activates a DC highpass filter for all input channels.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "Eac3DynamicRangeCompressionLine": { - "type": "string", - "documentation": "Enables Dynamic Range Compression that restricts the absolute peak level for a signal.", - "enum": [ - "NONE", - "FILM_STANDARD", - "FILM_LIGHT", - "MUSIC_STANDARD", - "MUSIC_LIGHT", - "SPEECH" - ] - }, - "Eac3DynamicRangeCompressionRf": { - "type": "string", - "documentation": "Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels.", - "enum": [ - "NONE", - "FILM_STANDARD", - "FILM_LIGHT", - "MUSIC_STANDARD", - "MUSIC_LIGHT", - "SPEECH" - ] - }, - "Eac3LfeControl": { - "type": "string", - "documentation": "When encoding 3/2 audio, controls whether the LFE channel is enabled", - "enum": [ - "LFE", - "NO_LFE" - ] - }, - "Eac3LfeFilter": { - "type": "string", - "documentation": "Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "Eac3MetadataControl": { - "type": "string", - "documentation": "When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used.", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ] - }, - "Eac3PassthroughControl": { - "type": "string", - "documentation": "When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding.", - "enum": [ - "WHEN_POSSIBLE", - "NO_PASSTHROUGH" - ] - }, - "Eac3PhaseControl": { - "type": "string", - "documentation": "Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode.", - "enum": [ - "SHIFT_90_DEGREES", - "NO_SHIFT" - ] - }, - "Eac3Settings": { - "type": "structure", - "members": { - "AttenuationControl": { - "shape": "Eac3AttenuationControl", - "locationName": "attenuationControl" - }, - "Bitrate": { - "shape": "__integerMin64000Max640000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode." - }, - "BitstreamMode": { - "shape": "Eac3BitstreamMode", - "locationName": "bitstreamMode" - }, - "CodingMode": { - "shape": "Eac3CodingMode", - "locationName": "codingMode" - }, - "DcFilter": { - "shape": "Eac3DcFilter", - "locationName": "dcFilter" - }, - "Dialnorm": { - "shape": "__integerMin1Max31", - "locationName": "dialnorm", - "documentation": "Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through." - }, - "DynamicRangeCompressionLine": { - "shape": "Eac3DynamicRangeCompressionLine", - "locationName": "dynamicRangeCompressionLine" - }, - "DynamicRangeCompressionRf": { - "shape": "Eac3DynamicRangeCompressionRf", - "locationName": "dynamicRangeCompressionRf" - }, - "LfeControl": { - "shape": "Eac3LfeControl", - "locationName": "lfeControl" - }, - "LfeFilter": { - "shape": "Eac3LfeFilter", - "locationName": "lfeFilter" - }, - "LoRoCenterMixLevel": { - "shape": "__doubleMinNegative60Max3", - "locationName": "loRoCenterMixLevel", - "documentation": "Left only/Right only center mix level. Only used for 3/2 coding mode.\nValid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60" - }, - "LoRoSurroundMixLevel": { - "shape": "__doubleMinNegative60MaxNegative1", - "locationName": "loRoSurroundMixLevel", - "documentation": "Left only/Right only surround mix level. Only used for 3/2 coding mode.\nValid values: -1.5 -3.0 -4.5 -6.0 -60" - }, - "LtRtCenterMixLevel": { - "shape": "__doubleMinNegative60Max3", - "locationName": "ltRtCenterMixLevel", - "documentation": "Left total/Right total center mix level. Only used for 3/2 coding mode.\nValid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60" - }, - "LtRtSurroundMixLevel": { - "shape": "__doubleMinNegative60MaxNegative1", - "locationName": "ltRtSurroundMixLevel", - "documentation": "Left total/Right total surround mix level. Only used for 3/2 coding mode.\nValid values: -1.5 -3.0 -4.5 -6.0 -60" - }, - "MetadataControl": { - "shape": "Eac3MetadataControl", - "locationName": "metadataControl" - }, - "PassthroughControl": { - "shape": "Eac3PassthroughControl", - "locationName": "passthroughControl" - }, - "PhaseControl": { - "shape": "Eac3PhaseControl", - "locationName": "phaseControl" - }, - "SampleRate": { - "shape": "__integerMin48000Max48000", - "locationName": "sampleRate", - "documentation": "Sample rate in hz. Sample rate is always 48000." - }, - "StereoDownmix": { - "shape": "Eac3StereoDownmix", - "locationName": "stereoDownmix" - }, - "SurroundExMode": { - "shape": "Eac3SurroundExMode", - "locationName": "surroundExMode" - }, - "SurroundMode": { - "shape": "Eac3SurroundMode", - "locationName": "surroundMode" - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3." - }, - "Eac3StereoDownmix": { - "type": "string", - "documentation": "Stereo downmix preference. Only used for 3/2 coding mode.", - "enum": [ - "NOT_INDICATED", - "LO_RO", - "LT_RT", - "DPL2" - ] - }, - "Eac3SurroundExMode": { - "type": "string", - "documentation": "When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels.", - "enum": [ - "NOT_INDICATED", - "ENABLED", - "DISABLED" - ] - }, - "Eac3SurroundMode": { - "type": "string", - "documentation": "When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels.", - "enum": [ - "NOT_INDICATED", - "ENABLED", - "DISABLED" - ] - }, - "EmbeddedConvert608To708": { - "type": "string", - "documentation": "When set to UPCONVERT, 608 data is both passed through via the \"608 compatibility bytes\" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded.", - "enum": [ - "UPCONVERT", - "DISABLED" - ] - }, - "EmbeddedSourceSettings": { - "type": "structure", - "members": { - "Convert608To708": { - "shape": "EmbeddedConvert608To708", - "locationName": "convert608To708" - }, - "Source608ChannelNumber": { - "shape": "__integerMin1Max4", - "locationName": "source608ChannelNumber", - "documentation": "Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough." - }, - "Source608TrackNumber": { - "shape": "__integerMin1Max1", - "locationName": "source608TrackNumber", - "documentation": "Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'." - } - }, - "documentation": "Settings for embedded captions Source" - }, - "Endpoint": { - "type": "structure", - "members": { - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "URL of endpoint" - } - }, - "documentation": "Describes account specific API endpoint" - }, - "ExceptionBody": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - } - }, - "F4vMoovPlacement": { - "type": "string", - "documentation": "If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end.", - "enum": [ - "PROGRESSIVE_DOWNLOAD", - "NORMAL" - ] - }, - "F4vSettings": { - "type": "structure", - "members": { - "MoovPlacement": { - "shape": "F4vMoovPlacement", - "locationName": "moovPlacement" - } - }, - "documentation": "Settings for F4v container" - }, - "FileGroupSettings": { - "type": "structure", - "members": { - "Destination": { - "shape": "__stringPatternS3", - "locationName": "destination", - "documentation": "Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file." - } - }, - "documentation": "Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS." - }, - "FileSourceConvert608To708": { - "type": "string", - "documentation": "If set to UPCONVERT, 608 caption data is both passed through via the \"608 compatibility bytes\" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded.", - "enum": [ - "UPCONVERT", - "DISABLED" - ] - }, - "FileSourceSettings": { - "type": "structure", - "members": { - "Convert608To708": { - "shape": "FileSourceConvert608To708", - "locationName": "convert608To708" - }, - "SourceFile": { - "shape": "__stringMin14PatternS3SccSCCTtmlTTMLDfxpDFXPStlSTLSrtSRTSmiSMI", - "locationName": "sourceFile", - "documentation": "External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'." - }, - "TimeDelta": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "timeDelta", - "documentation": "Specifies a time delta in seconds to offset the captions from the source file." - } - }, - "documentation": "Settings for File-based Captions in Source", - "required": [ - "SourceFile" - ] - }, - "ForbiddenException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 403 - }, - "documentation": "You don't have permissions for this action with the credentials you sent." - }, - "FrameCaptureSettings": { - "type": "structure", - "members": { - "FramerateDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateDenominator", - "documentation": "Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture." - }, - "FramerateNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateNumerator", - "documentation": "Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places." - }, - "MaxCaptures": { - "shape": "__integerMin1Max10000000", - "locationName": "maxCaptures", - "documentation": "Maximum number of captures (encoded jpg output files)." - }, - "Quality": { - "shape": "__integerMin1Max100", - "locationName": "quality", - "documentation": "JPEG Quality - a higher value equals higher quality." - } - }, - "documentation": "Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE." - }, - "GetJobRequest": { - "type": "structure", - "members": { - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "the job ID of the job.", - "location": "uri" - } - }, - "required": [ - "Id" - ] - }, - "GetJobResponse": { - "type": "structure", - "members": { - "Job": { - "shape": "Job", - "locationName": "job" - } - } - }, - "GetJobTemplateRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the job template.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "GetJobTemplateResponse": { - "type": "structure", - "members": { - "JobTemplate": { - "shape": "JobTemplate", - "locationName": "jobTemplate" - } - } - }, - "GetPresetRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the preset.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "GetPresetResponse": { - "type": "structure", - "members": { - "Preset": { - "shape": "Preset", - "locationName": "preset" - } - } - }, - "GetQueueRequest": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the queue.", - "location": "uri" - } - }, - "required": [ - "Name" - ] - }, - "GetQueueResponse": { - "type": "structure", - "members": { - "Queue": { - "shape": "Queue", - "locationName": "queue" - } - } - }, - "H264AdaptiveQuantization": { - "type": "string", - "documentation": "Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.", - "enum": [ - "OFF", - "LOW", - "MEDIUM", - "HIGH", - "HIGHER", - "MAX" - ] - }, - "H264CodecLevel": { - "type": "string", - "documentation": "H.264 Level.", - "enum": [ - "AUTO", - "LEVEL_1", - "LEVEL_1_1", - "LEVEL_1_2", - "LEVEL_1_3", - "LEVEL_2", - "LEVEL_2_1", - "LEVEL_2_2", - "LEVEL_3", - "LEVEL_3_1", - "LEVEL_3_2", - "LEVEL_4", - "LEVEL_4_1", - "LEVEL_4_2", - "LEVEL_5", - "LEVEL_5_1", - "LEVEL_5_2" - ] - }, - "H264CodecProfile": { - "type": "string", - "documentation": "H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License.", - "enum": [ - "BASELINE", - "HIGH", - "HIGH_10BIT", - "HIGH_422", - "HIGH_422_10BIT", - "MAIN" - ] - }, - "H264DynamicSubGop": { - "type": "string", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames).", - "enum": [ - "ADAPTIVE", - "STATIC" - ] - }, - "H264EntropyEncoding": { - "type": "string", - "documentation": "Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC.", - "enum": [ - "CABAC", - "CAVLC" - ] - }, - "H264FieldEncoding": { - "type": "string", - "documentation": "Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs.", - "enum": [ - "PAFF", - "FORCE_FIELD" - ] - }, - "H264FlickerAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame to reduce flicker or 'pop' on I-frames.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264FramerateControl": { - "type": "string", - "documentation": "If you are using the console, use the Framerate setting to specify the framerate for this output. If you want to keep the same framerate as the input video, choose Follow source. If you want to do framerate conversion, choose a framerate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your framerate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the framerate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Choose SPECIFIED if you want the service to use the framerate you specify in the settings FramerateNumerator and FramerateDenominator.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "H264FramerateConversionAlgorithm": { - "type": "string", - "documentation": "When set to INTERPOLATE, produces smoother motion during framerate conversion.", - "enum": [ - "DUPLICATE_DROP", - "INTERPOLATE" - ] - }, - "H264GopBReference": { - "type": "string", - "documentation": "If enable, use reference B frames for GOP structures that have B frames > 1.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264GopSizeUnits": { - "type": "string", - "documentation": "Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.", - "enum": [ - "FRAMES", - "SECONDS" - ] - }, - "H264InterlaceMode": { - "type": "string", - "documentation": "Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows.\n - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of \"top field first\" and \"bottom field first\".\n - If the source is progressive, the output will be interlaced with \"top field first\" or \"bottom field first\" polarity, depending on which of the Follow options you chose.", - "enum": [ - "PROGRESSIVE", - "TOP_FIELD", - "BOTTOM_FIELD", - "FOLLOW_TOP_FIELD", - "FOLLOW_BOTTOM_FIELD" - ] - }, - "H264ParControl": { - "type": "string", - "documentation": "Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "H264QualityTuningLevel": { - "type": "string", - "documentation": "Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding.", - "enum": [ - "SINGLE_PASS", - "SINGLE_PASS_HQ", - "MULTI_PASS_HQ" - ] - }, - "H264QvbrSettings": { - "type": "structure", - "members": { - "MaxAverageBitrate": { - "shape": "__integerMin1000Max1152000000", - "locationName": "maxAverageBitrate", - "documentation": "Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output." - }, - "QvbrQualityLevel": { - "shape": "__integerMin1Max10", - "locationName": "qvbrQualityLevel", - "documentation": "Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9." - } - }, - "documentation": "Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.", - "required": [ - "QvbrQualityLevel" - ] - }, - "H264RateControlMode": { - "type": "string", - "documentation": "Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR).", - "enum": [ - "VBR", - "CBR", - "QVBR" - ] - }, - "H264RepeatPps": { - "type": "string", - "documentation": "Places a PPS header on each encoded picture, even if repeated.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264SceneChangeDetect": { - "type": "string", - "documentation": "Scene change detection (inserts I-frames on scene changes).", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264Settings": { - "type": "structure", - "members": { - "AdaptiveQuantization": { - "shape": "H264AdaptiveQuantization", - "locationName": "adaptiveQuantization" - }, - "Bitrate": { - "shape": "__integerMin1000Max1152000000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000." - }, - "CodecLevel": { - "shape": "H264CodecLevel", - "locationName": "codecLevel" - }, - "CodecProfile": { - "shape": "H264CodecProfile", - "locationName": "codecProfile" - }, - "DynamicSubGop": { - "shape": "H264DynamicSubGop", - "locationName": "dynamicSubGop", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames)." - }, - "EntropyEncoding": { - "shape": "H264EntropyEncoding", - "locationName": "entropyEncoding" - }, - "FieldEncoding": { - "shape": "H264FieldEncoding", - "locationName": "fieldEncoding" - }, - "FlickerAdaptiveQuantization": { - "shape": "H264FlickerAdaptiveQuantization", - "locationName": "flickerAdaptiveQuantization" - }, - "FramerateControl": { - "shape": "H264FramerateControl", - "locationName": "framerateControl" - }, - "FramerateConversionAlgorithm": { - "shape": "H264FramerateConversionAlgorithm", - "locationName": "framerateConversionAlgorithm" - }, - "FramerateDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateDenominator", - "documentation": "When you use the API for transcode jobs that use framerate conversion, specify the framerate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use framerate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976." - }, - "FramerateNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateNumerator", - "documentation": "Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps." - }, - "GopBReference": { - "shape": "H264GopBReference", - "locationName": "gopBReference" - }, - "GopClosedCadence": { - "shape": "__integerMin0Max2147483647", - "locationName": "gopClosedCadence", - "documentation": "Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting." - }, - "GopSize": { - "shape": "__doubleMin0", - "locationName": "gopSize", - "documentation": "GOP Length (keyframe interval) in frames or seconds. Must be greater than zero." - }, - "GopSizeUnits": { - "shape": "H264GopSizeUnits", - "locationName": "gopSizeUnits" - }, - "HrdBufferInitialFillPercentage": { - "shape": "__integerMin0Max100", - "locationName": "hrdBufferInitialFillPercentage", - "documentation": "Percentage of the buffer that should initially be filled (HRD buffer model)." - }, - "HrdBufferSize": { - "shape": "__integerMin0Max1152000000", - "locationName": "hrdBufferSize", - "documentation": "Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000." - }, - "InterlaceMode": { - "shape": "H264InterlaceMode", - "locationName": "interlaceMode" - }, - "MaxBitrate": { - "shape": "__integerMin1000Max1152000000", - "locationName": "maxBitrate", - "documentation": "Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR." - }, - "MinIInterval": { - "shape": "__integerMin0Max30", - "locationName": "minIInterval", - "documentation": "Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1" - }, - "NumberBFramesBetweenReferenceFrames": { - "shape": "__integerMin0Max7", - "locationName": "numberBFramesBetweenReferenceFrames", - "documentation": "Number of B-frames between reference frames." - }, - "NumberReferenceFrames": { - "shape": "__integerMin1Max6", - "locationName": "numberReferenceFrames", - "documentation": "Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding." - }, - "ParControl": { - "shape": "H264ParControl", - "locationName": "parControl" - }, - "ParDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parDenominator", - "documentation": "Pixel Aspect Ratio denominator." - }, - "ParNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parNumerator", - "documentation": "Pixel Aspect Ratio numerator." - }, - "QualityTuningLevel": { - "shape": "H264QualityTuningLevel", - "locationName": "qualityTuningLevel" - }, - "QvbrSettings": { - "shape": "H264QvbrSettings", - "locationName": "qvbrSettings", - "documentation": "Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode." - }, - "RateControlMode": { - "shape": "H264RateControlMode", - "locationName": "rateControlMode" - }, - "RepeatPps": { - "shape": "H264RepeatPps", - "locationName": "repeatPps" - }, - "SceneChangeDetect": { - "shape": "H264SceneChangeDetect", - "locationName": "sceneChangeDetect" - }, - "Slices": { - "shape": "__integerMin1Max32", - "locationName": "slices", - "documentation": "Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures." - }, - "SlowPal": { - "shape": "H264SlowPal", - "locationName": "slowPal" - }, - "Softness": { - "shape": "__integerMin0Max128", - "locationName": "softness", - "documentation": "Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image." - }, - "SpatialAdaptiveQuantization": { - "shape": "H264SpatialAdaptiveQuantization", - "locationName": "spatialAdaptiveQuantization" - }, - "Syntax": { - "shape": "H264Syntax", - "locationName": "syntax" - }, - "Telecine": { - "shape": "H264Telecine", - "locationName": "telecine" - }, - "TemporalAdaptiveQuantization": { - "shape": "H264TemporalAdaptiveQuantization", - "locationName": "temporalAdaptiveQuantization" - }, - "UnregisteredSeiTimecode": { - "shape": "H264UnregisteredSeiTimecode", - "locationName": "unregisteredSeiTimecode" - } - }, - "documentation": "Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264." - }, - "H264SlowPal": { - "type": "string", - "documentation": "Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264SpatialAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on spatial variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264Syntax": { - "type": "string", - "documentation": "Produces a bitstream compliant with SMPTE RP-2027.", - "enum": [ - "DEFAULT", - "RP2027" - ] - }, - "H264Telecine": { - "type": "string", - "documentation": "This field applies only if the Streams > Advanced > Framerate (framerate) field is set to 29.970. This field works with the Streams > Advanced > Preprocessors > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i.", - "enum": [ - "NONE", - "SOFT", - "HARD" - ] - }, - "H264TemporalAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on temporal variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H264UnregisteredSeiTimecode": { - "type": "string", - "documentation": "Inserts timecode for each frame as 4 bytes of an unregistered SEI message.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265AdaptiveQuantization": { - "type": "string", - "documentation": "Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.", - "enum": [ - "OFF", - "LOW", - "MEDIUM", - "HIGH", - "HIGHER", - "MAX" - ] - }, - "H265AlternateTransferFunctionSei": { - "type": "string", - "documentation": "Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF).", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265CodecLevel": { - "type": "string", - "documentation": "H.265 Level.", - "enum": [ - "AUTO", - "LEVEL_1", - "LEVEL_2", - "LEVEL_2_1", - "LEVEL_3", - "LEVEL_3_1", - "LEVEL_4", - "LEVEL_4_1", - "LEVEL_5", - "LEVEL_5_1", - "LEVEL_5_2", - "LEVEL_6", - "LEVEL_6_1", - "LEVEL_6_2" - ] - }, - "H265CodecProfile": { - "type": "string", - "documentation": "Represents the Profile and Tier, per the HEVC (H.265) specification. Selections are grouped as [Profile] / [Tier], so \"Main/High\" represents Main Profile with High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License.", - "enum": [ - "MAIN_MAIN", - "MAIN_HIGH", - "MAIN10_MAIN", - "MAIN10_HIGH", - "MAIN_422_8BIT_MAIN", - "MAIN_422_8BIT_HIGH", - "MAIN_422_10BIT_MAIN", - "MAIN_422_10BIT_HIGH" - ] - }, - "H265DynamicSubGop": { - "type": "string", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames).", - "enum": [ - "ADAPTIVE", - "STATIC" - ] - }, - "H265FlickerAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame to reduce flicker or 'pop' on I-frames.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265FramerateControl": { - "type": "string", - "documentation": "If you are using the console, use the Framerate setting to specify the framerate for this output. If you want to keep the same framerate as the input video, choose Follow source. If you want to do framerate conversion, choose a framerate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your framerate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the framerate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Choose SPECIFIED if you want the service to use the framerate you specify in the settings FramerateNumerator and FramerateDenominator.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "H265FramerateConversionAlgorithm": { - "type": "string", - "documentation": "When set to INTERPOLATE, produces smoother motion during framerate conversion.", - "enum": [ - "DUPLICATE_DROP", - "INTERPOLATE" - ] - }, - "H265GopBReference": { - "type": "string", - "documentation": "If enable, use reference B frames for GOP structures that have B frames > 1.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265GopSizeUnits": { - "type": "string", - "documentation": "Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.", - "enum": [ - "FRAMES", - "SECONDS" - ] - }, - "H265InterlaceMode": { - "type": "string", - "documentation": "Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type.\n - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of \"top field first\" and \"bottom field first\".\n - If the source is progressive, the output will be interlaced with \"top field first\" or \"bottom field first\" polarity, depending on which of the Follow options you chose.", - "enum": [ - "PROGRESSIVE", - "TOP_FIELD", - "BOTTOM_FIELD", - "FOLLOW_TOP_FIELD", - "FOLLOW_BOTTOM_FIELD" - ] - }, - "H265ParControl": { - "type": "string", - "documentation": "Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "H265QualityTuningLevel": { - "type": "string", - "documentation": "Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding.", - "enum": [ - "SINGLE_PASS", - "SINGLE_PASS_HQ", - "MULTI_PASS_HQ" - ] - }, - "H265QvbrSettings": { - "type": "structure", - "members": { - "MaxAverageBitrate": { - "shape": "__integerMin1000Max1466400000", - "locationName": "maxAverageBitrate", - "documentation": "Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output." - }, - "QvbrQualityLevel": { - "shape": "__integerMin1Max10", - "locationName": "qvbrQualityLevel", - "documentation": "Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9." - } - }, - "documentation": "Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.", - "required": [ - "QvbrQualityLevel" - ] - }, - "H265RateControlMode": { - "type": "string", - "documentation": "Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR).", - "enum": [ - "VBR", - "CBR", - "QVBR" - ] - }, - "H265SampleAdaptiveOffsetFilterMode": { - "type": "string", - "documentation": "Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content", - "enum": [ - "DEFAULT", - "ADAPTIVE", - "OFF" - ] - }, - "H265SceneChangeDetect": { - "type": "string", - "documentation": "Scene change detection (inserts I-frames on scene changes).", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265Settings": { - "type": "structure", - "members": { - "AdaptiveQuantization": { - "shape": "H265AdaptiveQuantization", - "locationName": "adaptiveQuantization" - }, - "AlternateTransferFunctionSei": { - "shape": "H265AlternateTransferFunctionSei", - "locationName": "alternateTransferFunctionSei" - }, - "Bitrate": { - "shape": "__integerMin1000Max1466400000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000." - }, - "CodecLevel": { - "shape": "H265CodecLevel", - "locationName": "codecLevel" - }, - "CodecProfile": { - "shape": "H265CodecProfile", - "locationName": "codecProfile" - }, - "DynamicSubGop": { - "shape": "H265DynamicSubGop", - "locationName": "dynamicSubGop", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames)." - }, - "FlickerAdaptiveQuantization": { - "shape": "H265FlickerAdaptiveQuantization", - "locationName": "flickerAdaptiveQuantization" - }, - "FramerateControl": { - "shape": "H265FramerateControl", - "locationName": "framerateControl" - }, - "FramerateConversionAlgorithm": { - "shape": "H265FramerateConversionAlgorithm", - "locationName": "framerateConversionAlgorithm" - }, - "FramerateDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateDenominator", - "documentation": "Framerate denominator." - }, - "FramerateNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateNumerator", - "documentation": "Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps." - }, - "GopBReference": { - "shape": "H265GopBReference", - "locationName": "gopBReference" - }, - "GopClosedCadence": { - "shape": "__integerMin0Max2147483647", - "locationName": "gopClosedCadence", - "documentation": "Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting." - }, - "GopSize": { - "shape": "__doubleMin0", - "locationName": "gopSize", - "documentation": "GOP Length (keyframe interval) in frames or seconds. Must be greater than zero." - }, - "GopSizeUnits": { - "shape": "H265GopSizeUnits", - "locationName": "gopSizeUnits" - }, - "HrdBufferInitialFillPercentage": { - "shape": "__integerMin0Max100", - "locationName": "hrdBufferInitialFillPercentage", - "documentation": "Percentage of the buffer that should initially be filled (HRD buffer model)." - }, - "HrdBufferSize": { - "shape": "__integerMin0Max1466400000", - "locationName": "hrdBufferSize", - "documentation": "Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000." - }, - "InterlaceMode": { - "shape": "H265InterlaceMode", - "locationName": "interlaceMode" - }, - "MaxBitrate": { - "shape": "__integerMin1000Max1466400000", - "locationName": "maxBitrate", - "documentation": "Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR." - }, - "MinIInterval": { - "shape": "__integerMin0Max30", - "locationName": "minIInterval", - "documentation": "Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1" - }, - "NumberBFramesBetweenReferenceFrames": { - "shape": "__integerMin0Max7", - "locationName": "numberBFramesBetweenReferenceFrames", - "documentation": "Number of B-frames between reference frames." - }, - "NumberReferenceFrames": { - "shape": "__integerMin1Max6", - "locationName": "numberReferenceFrames", - "documentation": "Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding." - }, - "ParControl": { - "shape": "H265ParControl", - "locationName": "parControl" - }, - "ParDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parDenominator", - "documentation": "Pixel Aspect Ratio denominator." - }, - "ParNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parNumerator", - "documentation": "Pixel Aspect Ratio numerator." - }, - "QualityTuningLevel": { - "shape": "H265QualityTuningLevel", - "locationName": "qualityTuningLevel" - }, - "QvbrSettings": { - "shape": "H265QvbrSettings", - "locationName": "qvbrSettings", - "documentation": "Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode." - }, - "RateControlMode": { - "shape": "H265RateControlMode", - "locationName": "rateControlMode" - }, - "SampleAdaptiveOffsetFilterMode": { - "shape": "H265SampleAdaptiveOffsetFilterMode", - "locationName": "sampleAdaptiveOffsetFilterMode" - }, - "SceneChangeDetect": { - "shape": "H265SceneChangeDetect", - "locationName": "sceneChangeDetect" - }, - "Slices": { - "shape": "__integerMin1Max32", - "locationName": "slices", - "documentation": "Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures." - }, - "SlowPal": { - "shape": "H265SlowPal", - "locationName": "slowPal" - }, - "SpatialAdaptiveQuantization": { - "shape": "H265SpatialAdaptiveQuantization", - "locationName": "spatialAdaptiveQuantization" - }, - "Telecine": { - "shape": "H265Telecine", - "locationName": "telecine" - }, - "TemporalAdaptiveQuantization": { - "shape": "H265TemporalAdaptiveQuantization", - "locationName": "temporalAdaptiveQuantization" - }, - "TemporalIds": { - "shape": "H265TemporalIds", - "locationName": "temporalIds" - }, - "Tiles": { - "shape": "H265Tiles", - "locationName": "tiles" - }, - "UnregisteredSeiTimecode": { - "shape": "H265UnregisteredSeiTimecode", - "locationName": "unregisteredSeiTimecode" - }, - "WriteMp4PackagingType": { - "shape": "H265WriteMp4PackagingType", - "locationName": "writeMp4PackagingType" - } - }, - "documentation": "Settings for H265 codec" - }, - "H265SlowPal": { - "type": "string", - "documentation": "Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265SpatialAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on spatial variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265Telecine": { - "type": "string", - "documentation": "This field applies only if the Streams > Advanced > Framerate (framerate) field is set to 29.970. This field works with the Streams > Advanced > Preprocessors > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i.", - "enum": [ - "NONE", - "SOFT", - "HARD" - ] - }, - "H265TemporalAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on temporal variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265TemporalIds": { - "type": "string", - "documentation": "Enables temporal layer identifiers in the encoded bitstream. Up to 3 layers are supported depending on GOP structure: I- and P-frames form one layer, reference B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265Tiles": { - "type": "string", - "documentation": "Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265UnregisteredSeiTimecode": { - "type": "string", - "documentation": "Inserts timecode for each frame as 4 bytes of an unregistered SEI message.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "H265WriteMp4PackagingType": { - "type": "string", - "documentation": "If HVC1, output that is H.265 will be marked as HVC1 and adhere to the ISO-IECJTC1-SC29_N13798_Text_ISOIEC_FDIS_14496-15_3rd_E spec which states that parameter set NAL units will be stored in the sample headers but not in the samples directly. If HEV1, then H.265 will be marked as HEV1 and parameter set NAL units will be written into the samples.", - "enum": [ - "HVC1", - "HEV1" - ] - }, - "Hdr10Metadata": { - "type": "structure", - "members": { - "BluePrimaryX": { - "shape": "__integerMin0Max50000", - "locationName": "bluePrimaryX", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "BluePrimaryY": { - "shape": "__integerMin0Max50000", - "locationName": "bluePrimaryY", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "GreenPrimaryX": { - "shape": "__integerMin0Max50000", - "locationName": "greenPrimaryX", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "GreenPrimaryY": { - "shape": "__integerMin0Max50000", - "locationName": "greenPrimaryY", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "MaxContentLightLevel": { - "shape": "__integerMin0Max65535", - "locationName": "maxContentLightLevel", - "documentation": "Maximum light level among all samples in the coded video sequence, in units of candelas per square meter." - }, - "MaxFrameAverageLightLevel": { - "shape": "__integerMin0Max65535", - "locationName": "maxFrameAverageLightLevel", - "documentation": "Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter." - }, - "MaxLuminance": { - "shape": "__integerMin0Max2147483647", - "locationName": "maxLuminance", - "documentation": "Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter." - }, - "MinLuminance": { - "shape": "__integerMin0Max2147483647", - "locationName": "minLuminance", - "documentation": "Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meter" - }, - "RedPrimaryX": { - "shape": "__integerMin0Max50000", - "locationName": "redPrimaryX", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "RedPrimaryY": { - "shape": "__integerMin0Max50000", - "locationName": "redPrimaryY", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "WhitePointX": { - "shape": "__integerMin0Max50000", - "locationName": "whitePointX", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - }, - "WhitePointY": { - "shape": "__integerMin0Max50000", - "locationName": "whitePointY", - "documentation": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction." - } - }, - "documentation": "Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the HVC1 for H.265 setting.", - "required": [ - "MaxContentLightLevel", - "MaxFrameAverageLightLevel" - ] - }, - "HlsAdMarkers": { - "type": "string", - "enum": [ - "ELEMENTAL", - "ELEMENTAL_SCTE35" - ] - }, - "HlsAudioTrackType": { - "type": "string", - "documentation": "Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO", - "enum": [ - "ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT", - "ALTERNATE_AUDIO_AUTO_SELECT", - "ALTERNATE_AUDIO_NOT_AUTO_SELECT", - "AUDIO_ONLY_VARIANT_STREAM" - ] - }, - "HlsCaptionLanguageMapping": { - "type": "structure", - "members": { - "CaptionChannel": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "captionChannel", - "documentation": "Caption channel." - }, - "CustomLanguageCode": { - "shape": "__stringMin3Max3PatternAZaZ3", - "locationName": "customLanguageCode", - "documentation": "Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language code" - }, - "LanguageCode": { - "shape": "LanguageCode", - "locationName": "languageCode" - }, - "LanguageDescription": { - "shape": "__string", - "locationName": "languageDescription", - "documentation": "Caption language description." - } - }, - "documentation": "Caption Language Mapping" - }, - "HlsCaptionLanguageSetting": { - "type": "string", - "documentation": "Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest.", - "enum": [ - "INSERT", - "OMIT", - "NONE" - ] - }, - "HlsClientCache": { - "type": "string", - "documentation": "When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "HlsCodecSpecification": { - "type": "string", - "documentation": "Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation.", - "enum": [ - "RFC_6381", - "RFC_4281" - ] - }, - "HlsDirectoryStructure": { - "type": "string", - "documentation": "Indicates whether segments should be placed in subdirectories.", - "enum": [ - "SINGLE_DIRECTORY", - "SUBDIRECTORY_PER_STREAM" - ] - }, - "HlsEncryptionSettings": { - "type": "structure", - "members": { - "ConstantInitializationVector": { - "shape": "__stringMin32Max32Pattern09aFAF32", - "locationName": "constantInitializationVector", - "documentation": "This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default." - }, - "EncryptionMethod": { - "shape": "HlsEncryptionType", - "locationName": "encryptionMethod" - }, - "InitializationVectorInManifest": { - "shape": "HlsInitializationVectorInManifest", - "locationName": "initializationVectorInManifest" - }, - "SpekeKeyProvider": { - "shape": "SpekeKeyProvider", - "locationName": "spekeKeyProvider" - }, - "StaticKeyProvider": { - "shape": "StaticKeyProvider", - "locationName": "staticKeyProvider" - }, - "Type": { - "shape": "HlsKeyProviderType", - "locationName": "type" - } - }, - "documentation": "Settings for HLS encryption", - "required": [ - "Type" - ] - }, - "HlsEncryptionType": { - "type": "string", - "documentation": "Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption.", - "enum": [ - "AES128", - "SAMPLE_AES" - ] - }, - "HlsGroupSettings": { - "type": "structure", - "members": { - "AdMarkers": { - "shape": "__listOfHlsAdMarkers", - "locationName": "adMarkers", - "documentation": "Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs." - }, - "BaseUrl": { - "shape": "__string", - "locationName": "baseUrl", - "documentation": "A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file." - }, - "CaptionLanguageMappings": { - "shape": "__listOfHlsCaptionLanguageMapping", - "locationName": "captionLanguageMappings", - "documentation": "Language to be used on Caption outputs" - }, - "CaptionLanguageSetting": { - "shape": "HlsCaptionLanguageSetting", - "locationName": "captionLanguageSetting" - }, - "ClientCache": { - "shape": "HlsClientCache", - "locationName": "clientCache" - }, - "CodecSpecification": { - "shape": "HlsCodecSpecification", - "locationName": "codecSpecification" - }, - "Destination": { - "shape": "__stringPatternS3", - "locationName": "destination", - "documentation": "Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file." - }, - "DirectoryStructure": { - "shape": "HlsDirectoryStructure", - "locationName": "directoryStructure" - }, - "Encryption": { - "shape": "HlsEncryptionSettings", - "locationName": "encryption", - "documentation": "DRM settings." - }, - "ManifestCompression": { - "shape": "HlsManifestCompression", - "locationName": "manifestCompression" - }, - "ManifestDurationFormat": { - "shape": "HlsManifestDurationFormat", - "locationName": "manifestDurationFormat" - }, - "MinFinalSegmentLength": { - "shape": "__doubleMin0Max2147483647", - "locationName": "minFinalSegmentLength", - "documentation": "Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds." - }, - "MinSegmentLength": { - "shape": "__integerMin0Max2147483647", - "locationName": "minSegmentLength", - "documentation": "When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed." - }, - "OutputSelection": { - "shape": "HlsOutputSelection", - "locationName": "outputSelection" - }, - "ProgramDateTime": { - "shape": "HlsProgramDateTime", - "locationName": "programDateTime" - }, - "ProgramDateTimePeriod": { - "shape": "__integerMin0Max3600", - "locationName": "programDateTimePeriod", - "documentation": "Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds." - }, - "SegmentControl": { - "shape": "HlsSegmentControl", - "locationName": "segmentControl" - }, - "SegmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "segmentLength", - "documentation": "Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer." - }, - "SegmentsPerSubdirectory": { - "shape": "__integerMin1Max2147483647", - "locationName": "segmentsPerSubdirectory", - "documentation": "Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect." - }, - "StreamInfResolution": { - "shape": "HlsStreamInfResolution", - "locationName": "streamInfResolution" - }, - "TimedMetadataId3Frame": { - "shape": "HlsTimedMetadataId3Frame", - "locationName": "timedMetadataId3Frame" - }, - "TimedMetadataId3Period": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "timedMetadataId3Period", - "documentation": "Timed Metadata interval in seconds." - }, - "TimestampDeltaMilliseconds": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "timestampDeltaMilliseconds", - "documentation": "Provides an extra millisecond delta offset to fine tune the timestamps." - } - }, - "documentation": "Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.", - "required": [ - "MinSegmentLength", - "SegmentLength" - ] - }, - "HlsIFrameOnlyManifest": { - "type": "string", - "documentation": "When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "HlsInitializationVectorInManifest": { - "type": "string", - "documentation": "The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "HlsKeyProviderType": { - "type": "string", - "documentation": "Indicates which type of key provider is used for encryption.", - "enum": [ - "SPEKE", - "STATIC_KEY" - ] - }, - "HlsManifestCompression": { - "type": "string", - "documentation": "When set to GZIP, compresses HLS playlist.", - "enum": [ - "GZIP", - "NONE" - ] - }, - "HlsManifestDurationFormat": { - "type": "string", - "documentation": "Indicates whether the output manifest should use floating point values for segment duration.", - "enum": [ - "FLOATING_POINT", - "INTEGER" - ] - }, - "HlsOutputSelection": { - "type": "string", - "documentation": "Indicates whether the .m3u8 manifest file should be generated for this HLS output group.", - "enum": [ - "MANIFESTS_AND_SEGMENTS", - "SEGMENTS_ONLY" - ] - }, - "HlsProgramDateTime": { - "type": "string", - "documentation": "Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "HlsSegmentControl": { - "type": "string", - "documentation": "When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback.", - "enum": [ - "SINGLE_FILE", - "SEGMENTED_FILES" - ] - }, - "HlsSettings": { - "type": "structure", - "members": { - "AudioGroupId": { - "shape": "__string", - "locationName": "audioGroupId", - "documentation": "Specifies the group to which the audio Rendition belongs." - }, - "AudioRenditionSets": { - "shape": "__string", - "locationName": "audioRenditionSets", - "documentation": "List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','." - }, - "AudioTrackType": { - "shape": "HlsAudioTrackType", - "locationName": "audioTrackType" - }, - "IFrameOnlyManifest": { - "shape": "HlsIFrameOnlyManifest", - "locationName": "iFrameOnlyManifest" - }, - "SegmentModifier": { - "shape": "__string", - "locationName": "segmentModifier", - "documentation": "String concatenated to end of segment filenames. Accepts \"Format Identifiers\":#format_identifier_parameters." - } - }, - "documentation": "Settings for HLS output groups" - }, - "HlsStreamInfResolution": { - "type": "string", - "documentation": "Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "HlsTimedMetadataId3Frame": { - "type": "string", - "documentation": "Indicates ID3 frame that has the timecode.", - "enum": [ - "NONE", - "PRIV", - "TDRL" - ] - }, - "Id3Insertion": { - "type": "structure", - "members": { - "Id3": { - "shape": "__stringPatternAZaZ0902", - "locationName": "id3", - "documentation": "Use ID3 tag (Id3) to provide a tag value in base64-encode format." - }, - "Timecode": { - "shape": "__stringPattern010920405090509092", - "locationName": "timecode", - "documentation": "Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format." - } - }, - "documentation": "To insert ID3 tags in your output, specify two values. Use ID3 tag (Id3) to specify the base 64 encoded string and use Timecode (TimeCode) to specify the time when the tag should be inserted. To insert multiple ID3 tags in your output, create multiple instances of ID3 insertion (Id3Insertion).", - "required": [ - "Timecode", - "Id3" - ] - }, - "ImageInserter": { - "type": "structure", - "members": { - "InsertableImages": { - "shape": "__listOfInsertableImage", - "locationName": "insertableImages", - "documentation": "Image to insert. Must be 32 bit windows BMP, PNG, or TGA file. Must not be larger than the output frames." - } - }, - "documentation": "Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.", - "required": [ - "InsertableImages" - ] - }, - "Input": { - "type": "structure", - "members": { - "AudioSelectorGroups": { - "shape": "__mapOfAudioSelectorGroup", - "locationName": "audioSelectorGroups", - "documentation": "Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See \"Audio Selector Group\":#inputs-audio_selector_group for more information." - }, - "AudioSelectors": { - "shape": "__mapOfAudioSelector", - "locationName": "audioSelectors", - "documentation": "Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input." - }, - "CaptionSelectors": { - "shape": "__mapOfCaptionSelector", - "locationName": "captionSelectors", - "documentation": "Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input." - }, - "DeblockFilter": { - "shape": "InputDeblockFilter", - "locationName": "deblockFilter" - }, - "DenoiseFilter": { - "shape": "InputDenoiseFilter", - "locationName": "denoiseFilter" - }, - "FileInput": { - "shape": "__stringPatternS3MM2VVMMPPEEGGAAVVIIMMPP4FFLLVVMMPPTTMMPPGGMM4VVTTRRPPFF4VVMM2TTSSTTSS264HH264MMKKVVMMOOVVMMTTSSMM2TTWWMMVVAASSFFVVOOBB3GGPP3GGPPPPMMXXFFDDIIVVXXXXVVIIDDRRAAWWDDVVGGXXFFMM1VV3GG2VVMMFFMM3UU8LLCCHHGGXXFFMMPPEEGG2MMXXFFMMPPEEGG2MMXXFFHHDDWWAAVVYY4MM", - "locationName": "fileInput", - "documentation": "Use Input (fileInput) to define the source file used in the transcode job. There can be multiple inputs in a job. These inputs are concantenated, in the order they are specified in the job, to create the output." - }, - "FilterEnable": { - "shape": "InputFilterEnable", - "locationName": "filterEnable" - }, - "FilterStrength": { - "shape": "__integerMinNegative5Max5", - "locationName": "filterStrength", - "documentation": "Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0." - }, - "InputClippings": { - "shape": "__listOfInputClipping", - "locationName": "inputClippings", - "documentation": "(InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them." - }, - "ProgramNumber": { - "shape": "__integerMin1Max2147483647", - "locationName": "programNumber", - "documentation": "Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default." - }, - "PsiControl": { - "shape": "InputPsiControl", - "locationName": "psiControl" - }, - "TimecodeSource": { - "shape": "InputTimecodeSource", - "locationName": "timecodeSource" - }, - "VideoSelector": { - "shape": "VideoSelector", - "locationName": "videoSelector" - } - }, - "documentation": "Specifies media input", - "required": [ - "FileInput" - ] - }, - "InputClipping": { - "type": "structure", - "members": { - "EndTimecode": { - "shape": "__stringPattern010920405090509092", - "locationName": "endTimecode", - "documentation": "Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00." - }, - "StartTimecode": { - "shape": "__stringPattern010920405090509092", - "locationName": "startTimecode", - "documentation": "Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00." - } - }, - "documentation": "To transcode only portions of your input (clips), include one Input clipping (one instance of InputClipping in the JSON job file) for each input clip. All input clips you specify will be included in every output of the job." - }, - "InputDeblockFilter": { - "type": "string", - "documentation": "Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "InputDenoiseFilter": { - "type": "string", - "documentation": "Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "InputFilterEnable": { - "type": "string", - "documentation": "Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type.", - "enum": [ - "AUTO", - "DISABLE", - "FORCE" - ] - }, - "InputPsiControl": { - "type": "string", - "documentation": "Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data.", - "enum": [ - "IGNORE_PSI", - "USE_PSI" - ] - }, - "InputTemplate": { - "type": "structure", - "members": { - "AudioSelectorGroups": { - "shape": "__mapOfAudioSelectorGroup", - "locationName": "audioSelectorGroups", - "documentation": "Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See \"Audio Selector Group\":#inputs-audio_selector_group for more information." - }, - "AudioSelectors": { - "shape": "__mapOfAudioSelector", - "locationName": "audioSelectors", - "documentation": "Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input." - }, - "CaptionSelectors": { - "shape": "__mapOfCaptionSelector", - "locationName": "captionSelectors", - "documentation": "Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input." - }, - "DeblockFilter": { - "shape": "InputDeblockFilter", - "locationName": "deblockFilter" - }, - "DenoiseFilter": { - "shape": "InputDenoiseFilter", - "locationName": "denoiseFilter" - }, - "FilterEnable": { - "shape": "InputFilterEnable", - "locationName": "filterEnable" - }, - "FilterStrength": { - "shape": "__integerMinNegative5Max5", - "locationName": "filterStrength", - "documentation": "Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0." - }, - "InputClippings": { - "shape": "__listOfInputClipping", - "locationName": "inputClippings", - "documentation": "(InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them." - }, - "ProgramNumber": { - "shape": "__integerMin1Max2147483647", - "locationName": "programNumber", - "documentation": "Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default." - }, - "PsiControl": { - "shape": "InputPsiControl", - "locationName": "psiControl" - }, - "TimecodeSource": { - "shape": "InputTimecodeSource", - "locationName": "timecodeSource" - }, - "VideoSelector": { - "shape": "VideoSelector", - "locationName": "videoSelector" - } - }, - "documentation": "Specified video input in a template." - }, - "InputTimecodeSource": { - "type": "string", - "documentation": "Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes.", - "enum": [ - "EMBEDDED", - "ZEROBASED", - "SPECIFIEDSTART" - ] - }, - "InsertableImage": { - "type": "structure", - "members": { - "Duration": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "duration", - "documentation": "Use Duration (Duration) to set the time, in milliseconds, for the image to remain on the output video." - }, - "FadeIn": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "fadeIn", - "documentation": "Use Fade in (FadeIut) to set the length, in milliseconds, of the inserted image fade in. If you don't specify a value for Fade in, the image will appear abruptly at the Start time." - }, - "FadeOut": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "fadeOut", - "documentation": "Use Fade out (FadeOut) to set the length, in milliseconds, of the inserted image fade out. If you don't specify a value for Fade out, the image will disappear abruptly at the end of the inserted image duration." - }, - "Height": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "height", - "documentation": "Specify the Height (Height) of the inserted image. Use a value that is less than or equal to the video resolution height. Leave this setting blank to use the native height of the image." - }, - "ImageInserterInput": { - "shape": "__stringMin14PatternS3BmpBMPPngPNGTgaTGA", - "locationName": "imageInserterInput", - "documentation": "Use Image location (imageInserterInput) to specify the Amazon S3 location of the image to be inserted into the output. Use a 32 bit BMP, PNG, or TGA file that fits inside the video frame." - }, - "ImageX": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "imageX", - "documentation": "Use Left (ImageX) to set the distance, in pixels, between the inserted image and the left edge of the frame. Required for BMP, PNG and TGA input." - }, - "ImageY": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "imageY", - "documentation": "Use Top (ImageY) to set the distance, in pixels, between the inserted image and the top edge of the video frame. Required for BMP, PNG and TGA input." - }, - "Layer": { - "shape": "__integerMin0Max99", - "locationName": "layer", - "documentation": "Use Layer (Layer) to specify how overlapping inserted images appear. Images with higher values of layer appear on top of images with lower values of layer." - }, - "Opacity": { - "shape": "__integerMin0Max100", - "locationName": "opacity", - "documentation": "Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50." - }, - "StartTime": { - "shape": "__stringPattern01D20305D205D", - "locationName": "startTime", - "documentation": "Use Start time (StartTime) to specify the video timecode when the image is inserted in the output. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format." - }, - "Width": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "width", - "documentation": "Specify the Width (Width) of the inserted image. Use a value that is less than or equal to the video resolution width. Leave this setting blank to use the native width of the image." - } - }, - "documentation": "Settings for Insertable Image", - "required": [ - "ImageY", - "ImageX", - "ImageInserterInput", - "Opacity", - "Layer" - ] - }, - "InternalServerErrorException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 500 - }, - "documentation": "The service encountered an unexpected condition and cannot fulfill your request." - }, - "Job": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "An identifier for this resource that is unique within all of AWS." - }, - "CreatedAt": { - "shape": "__timestampUnix", - "locationName": "createdAt", - "documentation": "The time, in Unix epoch format in seconds, when the job got created." - }, - "ErrorCode": { - "shape": "__integer", - "locationName": "errorCode", - "documentation": "Error code for the job" - }, - "ErrorMessage": { - "shape": "__string", - "locationName": "errorMessage", - "documentation": "Error message of Job" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "A portion of the job's ARN, unique within your AWS Elemental MediaConvert resources" - }, - "JobTemplate": { - "shape": "__string", - "locationName": "jobTemplate", - "documentation": "The job template that the job is created from, if it is created from a job template." - }, - "OutputGroupDetails": { - "shape": "__listOfOutputGroupDetail", - "locationName": "outputGroupDetails", - "documentation": "List of output group details" - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html" - }, - "Role": { - "shape": "__string", - "locationName": "role", - "documentation": "The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html" - }, - "Settings": { - "shape": "JobSettings", - "locationName": "settings" - }, - "Status": { - "shape": "JobStatus", - "locationName": "status" - }, - "Timing": { - "shape": "Timing", - "locationName": "timing" - }, - "UserMetadata": { - "shape": "__mapOf__string", - "locationName": "userMetadata", - "documentation": "User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs." - } - }, - "documentation": "Each job converts an input file into an output file or files. For more information, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html", - "required": [ - "Role", - "Settings" - ] - }, - "JobSettings": { - "type": "structure", - "members": { - "AdAvailOffset": { - "shape": "__integerMinNegative1000Max1000", - "locationName": "adAvailOffset", - "documentation": "When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time." - }, - "AvailBlanking": { - "shape": "AvailBlanking", - "locationName": "availBlanking", - "documentation": "Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails." - }, - "Inputs": { - "shape": "__listOfInput", - "locationName": "inputs", - "documentation": "Use Inputs (inputs) to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output." - }, - "NielsenConfiguration": { - "shape": "NielsenConfiguration", - "locationName": "nielsenConfiguration" - }, - "OutputGroups": { - "shape": "__listOfOutputGroup", - "locationName": "outputGroups", - "documentation": "(OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettings" - }, - "TimecodeConfig": { - "shape": "TimecodeConfig", - "locationName": "timecodeConfig", - "documentation": "Contains settings used to acquire and adjust timecode information from inputs." - }, - "TimedMetadataInsertion": { - "shape": "TimedMetadataInsertion", - "locationName": "timedMetadataInsertion" - } - }, - "documentation": "JobSettings contains all the transcode settings for a job.", - "required": [ - "OutputGroups", - "Inputs" - ] - }, - "JobStatus": { - "type": "string", - "documentation": "A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR.", - "enum": [ - "SUBMITTED", - "PROGRESSING", - "COMPLETE", - "CANCELED", - "ERROR" - ] - }, - "JobTemplate": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "An identifier for this resource that is unique within all of AWS." - }, - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "An optional category you create to organize your job templates." - }, - "CreatedAt": { - "shape": "__timestampUnix", - "locationName": "createdAt", - "documentation": "The timestamp in epoch seconds for Job template creation." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "An optional description you create for each job template." - }, - "LastUpdated": { - "shape": "__timestampUnix", - "locationName": "lastUpdated", - "documentation": "The timestamp in epoch seconds when the Job template was last updated." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "A name you create for each job template. Each name must be unique within your account." - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue." - }, - "Settings": { - "shape": "JobTemplateSettings", - "locationName": "settings" - }, - "Type": { - "shape": "Type", - "locationName": "type", - "documentation": "A job template can be of two types: system or custom. System or built-in job templates can't be modified or deleted by the user." - } - }, - "documentation": "A job template is a pre-made set of encoding instructions that you can use to quickly create a job.", - "required": [ - "Settings", - "Name" - ] - }, - "JobTemplateListBy": { - "type": "string", - "documentation": "Optional. When you request a list of job templates, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name.", - "enum": [ - "NAME", - "CREATION_DATE", - "SYSTEM" - ] - }, - "JobTemplateSettings": { - "type": "structure", - "members": { - "AdAvailOffset": { - "shape": "__integerMinNegative1000Max1000", - "locationName": "adAvailOffset", - "documentation": "When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time." - }, - "AvailBlanking": { - "shape": "AvailBlanking", - "locationName": "availBlanking", - "documentation": "Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails." - }, - "Inputs": { - "shape": "__listOfInputTemplate", - "locationName": "inputs", - "documentation": "Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template." - }, - "NielsenConfiguration": { - "shape": "NielsenConfiguration", - "locationName": "nielsenConfiguration" - }, - "OutputGroups": { - "shape": "__listOfOutputGroup", - "locationName": "outputGroups", - "documentation": "(OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettings" - }, - "TimecodeConfig": { - "shape": "TimecodeConfig", - "locationName": "timecodeConfig", - "documentation": "Contains settings used to acquire and adjust timecode information from inputs." - }, - "TimedMetadataInsertion": { - "shape": "TimedMetadataInsertion", - "locationName": "timedMetadataInsertion" - } - }, - "documentation": "JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.", - "required": [ - "OutputGroups" - ] - }, - "LanguageCode": { - "type": "string", - "documentation": "Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php.", - "enum": [ - "ENG", - "SPA", - "FRA", - "DEU", - "GER", - "ZHO", - "ARA", - "HIN", - "JPN", - "RUS", - "POR", - "ITA", - "URD", - "VIE", - "KOR", - "PAN", - "ABK", - "AAR", - "AFR", - "AKA", - "SQI", - "AMH", - "ARG", - "HYE", - "ASM", - "AVA", - "AVE", - "AYM", - "AZE", - "BAM", - "BAK", - "EUS", - "BEL", - "BEN", - "BIH", - "BIS", - "BOS", - "BRE", - "BUL", - "MYA", - "CAT", - "KHM", - "CHA", - "CHE", - "NYA", - "CHU", - "CHV", - "COR", - "COS", - "CRE", - "HRV", - "CES", - "DAN", - "DIV", - "NLD", - "DZO", - "ENM", - "EPO", - "EST", - "EWE", - "FAO", - "FIJ", - "FIN", - "FRM", - "FUL", - "GLA", - "GLG", - "LUG", - "KAT", - "ELL", - "GRN", - "GUJ", - "HAT", - "HAU", - "HEB", - "HER", - "HMO", - "HUN", - "ISL", - "IDO", - "IBO", - "IND", - "INA", - "ILE", - "IKU", - "IPK", - "GLE", - "JAV", - "KAL", - "KAN", - "KAU", - "KAS", - "KAZ", - "KIK", - "KIN", - "KIR", - "KOM", - "KON", - "KUA", - "KUR", - "LAO", - "LAT", - "LAV", - "LIM", - "LIN", - "LIT", - "LUB", - "LTZ", - "MKD", - "MLG", - "MSA", - "MAL", - "MLT", - "GLV", - "MRI", - "MAR", - "MAH", - "MON", - "NAU", - "NAV", - "NDE", - "NBL", - "NDO", - "NEP", - "SME", - "NOR", - "NOB", - "NNO", - "OCI", - "OJI", - "ORI", - "ORM", - "OSS", - "PLI", - "FAS", - "POL", - "PUS", - "QUE", - "QAA", - "RON", - "ROH", - "RUN", - "SMO", - "SAG", - "SAN", - "SRD", - "SRB", - "SNA", - "III", - "SND", - "SIN", - "SLK", - "SLV", - "SOM", - "SOT", - "SUN", - "SWA", - "SSW", - "SWE", - "TGL", - "TAH", - "TGK", - "TAM", - "TAT", - "TEL", - "THA", - "BOD", - "TIR", - "TON", - "TSO", - "TSN", - "TUR", - "TUK", - "TWI", - "UIG", - "UKR", - "UZB", - "VEN", - "VOL", - "WLN", - "CYM", - "FRY", - "WOL", - "XHO", - "YID", - "YOR", - "ZHA", - "ZUL", - "ORJ", - "QPC", - "TNG" - ] - }, - "ListJobTemplatesRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "Optionally, specify a job template category to limit responses to only job templates from that category.", - "location": "querystring" - }, - "ListBy": { - "shape": "JobTemplateListBy", - "locationName": "listBy", - "location": "querystring" - }, - "MaxResults": { - "shape": "__integerMin1Max20", - "locationName": "maxResults", - "documentation": "Optional. Number of job templates, up to twenty, that will be returned at one time.", - "location": "querystring" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string, provided with the response to a previous request, to request the next batch of job templates.", - "location": "querystring" - }, - "Order": { - "shape": "Order", - "locationName": "order", - "location": "querystring" - } - } - }, - "ListJobTemplatesResponse": { - "type": "structure", - "members": { - "JobTemplates": { - "shape": "__listOfJobTemplate", - "locationName": "jobTemplates", - "documentation": "List of Job templates." - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string to request the next batch of job templates." - } - } - }, - "ListJobsRequest": { - "type": "structure", - "members": { - "MaxResults": { - "shape": "__integerMin1Max20", - "locationName": "maxResults", - "documentation": "Optional. Number of jobs, up to twenty, that will be returned at one time.", - "location": "querystring" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string, provided with the response to a previous request, to request the next batch of jobs.", - "location": "querystring" - }, - "Order": { - "shape": "Order", - "locationName": "order", - "location": "querystring" - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "Provide a queue name to get back only jobs from that queue.", - "location": "querystring" - }, - "Status": { - "shape": "JobStatus", - "locationName": "status", - "location": "querystring" - } - } - }, - "ListJobsResponse": { - "type": "structure", - "members": { - "Jobs": { - "shape": "__listOfJob", - "locationName": "jobs", - "documentation": "List of jobs" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string to request the next batch of jobs." - } - } - }, - "ListPresetsRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "Optionally, specify a preset category to limit responses to only presets from that category.", - "location": "querystring" - }, - "ListBy": { - "shape": "PresetListBy", - "locationName": "listBy", - "location": "querystring" - }, - "MaxResults": { - "shape": "__integerMin1Max20", - "locationName": "maxResults", - "documentation": "Optional. Number of presets, up to twenty, that will be returned at one time", - "location": "querystring" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string, provided with the response to a previous request, to request the next batch of presets.", - "location": "querystring" - }, - "Order": { - "shape": "Order", - "locationName": "order", - "location": "querystring" - } - } - }, - "ListPresetsResponse": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string to request the next batch of presets." - }, - "Presets": { - "shape": "__listOfPreset", - "locationName": "presets", - "documentation": "List of presets" - } - } - }, - "ListQueuesRequest": { - "type": "structure", - "members": { - "ListBy": { - "shape": "QueueListBy", - "locationName": "listBy", - "location": "querystring" - }, - "MaxResults": { - "shape": "__integerMin1Max20", - "locationName": "maxResults", - "documentation": "Optional. Number of queues, up to twenty, that will be returned at one time.", - "location": "querystring" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string, provided with the response to a previous request, to request the next batch of queues.", - "location": "querystring" - }, - "Order": { - "shape": "Order", - "locationName": "order", - "location": "querystring" - } - } - }, - "ListQueuesResponse": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Use this string to request the next batch of queues." - }, - "Queues": { - "shape": "__listOfQueue", - "locationName": "queues", - "documentation": "List of queues" - } - } - }, - "ListTagsForResourceRequest": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Amazon Resource Name (ARN) of the resource that you want to list tags for. To get the ARN, send a GET request with the resource name.", - "location": "uri" - } - }, - "required": [ - "Arn" - ] - }, - "ListTagsForResourceResponse": { - "type": "structure", - "members": { - "ResourceTags": { - "shape": "ResourceTags", - "locationName": "resourceTags" - } - } - }, - "M2tsAudioBufferModel": { - "type": "string", - "documentation": "Selects between the DVB and ATSC buffer models for Dolby Digital audio.", - "enum": [ - "DVB", - "ATSC" - ] - }, - "M2tsBufferModel": { - "type": "string", - "documentation": "Controls what buffer model to use for accurate interleaving. If set to MULTIPLEX, use multiplex buffer model. If set to NONE, this can lead to lower latency, but low-memory devices may not be able to play back the stream without interruptions.", - "enum": [ - "MULTIPLEX", - "NONE" - ] - }, - "M2tsEbpAudioInterval": { - "type": "string", - "documentation": "When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY).", - "enum": [ - "VIDEO_AND_FIXED_INTERVALS", - "VIDEO_INTERVAL" - ] - }, - "M2tsEbpPlacement": { - "type": "string", - "documentation": "Selects which PIDs to place EBP markers on. They can either be placed only on the video PID, or on both the video PID and all audio PIDs. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY).", - "enum": [ - "VIDEO_AND_AUDIO_PIDS", - "VIDEO_PID" - ] - }, - "M2tsEsRateInPes": { - "type": "string", - "documentation": "Controls whether to include the ES Rate field in the PES header.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "M2tsNielsenId3": { - "type": "string", - "documentation": "If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.", - "enum": [ - "INSERT", - "NONE" - ] - }, - "M2tsPcrControl": { - "type": "string", - "documentation": "When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream.", - "enum": [ - "PCR_EVERY_PES_PACKET", - "CONFIGURED_PCR_PERIOD" - ] - }, - "M2tsRateMode": { - "type": "string", - "documentation": "When set to CBR, inserts null packets into transport stream to fill specified bitrate. When set to VBR, the bitrate setting acts as the maximum bitrate, but the output will not be padded up to that bitrate.", - "enum": [ - "VBR", - "CBR" - ] - }, - "M2tsScte35Source": { - "type": "string", - "documentation": "Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output.", - "enum": [ - "PASSTHROUGH", - "NONE" - ] - }, - "M2tsSegmentationMarkers": { - "type": "string", - "documentation": "Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format.", - "enum": [ - "NONE", - "RAI_SEGSTART", - "RAI_ADAPT", - "PSI_SEGSTART", - "EBP", - "EBP_LEGACY" - ] - }, - "M2tsSegmentationStyle": { - "type": "string", - "documentation": "The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of \"reset_cadence\" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of \"maintain_cadence\" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule.", - "enum": [ - "MAINTAIN_CADENCE", - "RESET_CADENCE" - ] - }, - "M2tsSettings": { - "type": "structure", - "members": { - "AudioBufferModel": { - "shape": "M2tsAudioBufferModel", - "locationName": "audioBufferModel" - }, - "AudioFramesPerPes": { - "shape": "__integerMin0Max2147483647", - "locationName": "audioFramesPerPes", - "documentation": "The number of audio frames to insert for each PES packet." - }, - "AudioPids": { - "shape": "__listOf__integerMin32Max8182", - "locationName": "audioPids", - "documentation": "Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation." - }, - "Bitrate": { - "shape": "__integerMin0Max2147483647", - "locationName": "bitrate", - "documentation": "The output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000." - }, - "BufferModel": { - "shape": "M2tsBufferModel", - "locationName": "bufferModel" - }, - "DvbNitSettings": { - "shape": "DvbNitSettings", - "locationName": "dvbNitSettings" - }, - "DvbSdtSettings": { - "shape": "DvbSdtSettings", - "locationName": "dvbSdtSettings" - }, - "DvbSubPids": { - "shape": "__listOf__integerMin32Max8182", - "locationName": "dvbSubPids", - "documentation": "Packet Identifier (PID) for input source DVB Subtitle data to this output. Multiple values are accepted, and can be entered in ranges and/or by comma separation." - }, - "DvbTdtSettings": { - "shape": "DvbTdtSettings", - "locationName": "dvbTdtSettings" - }, - "DvbTeletextPid": { - "shape": "__integerMin32Max8182", - "locationName": "dvbTeletextPid", - "documentation": "Packet Identifier (PID) for input source DVB Teletext data to this output." - }, - "EbpAudioInterval": { - "shape": "M2tsEbpAudioInterval", - "locationName": "ebpAudioInterval" - }, - "EbpPlacement": { - "shape": "M2tsEbpPlacement", - "locationName": "ebpPlacement" - }, - "EsRateInPes": { - "shape": "M2tsEsRateInPes", - "locationName": "esRateInPes" - }, - "FragmentTime": { - "shape": "__doubleMin0", - "locationName": "fragmentTime", - "documentation": "The length in seconds of each fragment. Only used with EBP markers." - }, - "MaxPcrInterval": { - "shape": "__integerMin0Max500", - "locationName": "maxPcrInterval", - "documentation": "Maximum time in milliseconds between Program Clock References (PCRs) inserted into the transport stream." - }, - "MinEbpInterval": { - "shape": "__integerMin0Max10000", - "locationName": "minEbpInterval", - "documentation": "When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is \"stretched\" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate." - }, - "NielsenId3": { - "shape": "M2tsNielsenId3", - "locationName": "nielsenId3" - }, - "NullPacketBitrate": { - "shape": "__doubleMin0", - "locationName": "nullPacketBitrate", - "documentation": "Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets." - }, - "PatInterval": { - "shape": "__integerMin0Max1000", - "locationName": "patInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "PcrControl": { - "shape": "M2tsPcrControl", - "locationName": "pcrControl" - }, - "PcrPid": { - "shape": "__integerMin32Max8182", - "locationName": "pcrPid", - "documentation": "Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID." - }, - "PmtInterval": { - "shape": "__integerMin0Max1000", - "locationName": "pmtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "PmtPid": { - "shape": "__integerMin32Max8182", - "locationName": "pmtPid", - "documentation": "Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream." - }, - "PrivateMetadataPid": { - "shape": "__integerMin32Max8182", - "locationName": "privateMetadataPid", - "documentation": "Packet Identifier (PID) of the private metadata stream in the transport stream." - }, - "ProgramNumber": { - "shape": "__integerMin0Max65535", - "locationName": "programNumber", - "documentation": "The value of the program number field in the Program Map Table." - }, - "RateMode": { - "shape": "M2tsRateMode", - "locationName": "rateMode" - }, - "Scte35Pid": { - "shape": "__integerMin32Max8182", - "locationName": "scte35Pid", - "documentation": "Packet Identifier (PID) of the SCTE-35 stream in the transport stream." - }, - "Scte35Source": { - "shape": "M2tsScte35Source", - "locationName": "scte35Source" - }, - "SegmentationMarkers": { - "shape": "M2tsSegmentationMarkers", - "locationName": "segmentationMarkers" - }, - "SegmentationStyle": { - "shape": "M2tsSegmentationStyle", - "locationName": "segmentationStyle" - }, - "SegmentationTime": { - "shape": "__doubleMin0", - "locationName": "segmentationTime", - "documentation": "The length in seconds of each segment. Required unless markers is set to _none_." - }, - "TimedMetadataPid": { - "shape": "__integerMin32Max8182", - "locationName": "timedMetadataPid", - "documentation": "Packet Identifier (PID) of the timed metadata stream in the transport stream." - }, - "TransportStreamId": { - "shape": "__integerMin0Max65535", - "locationName": "transportStreamId", - "documentation": "The value of the transport stream ID field in the Program Map Table." - }, - "VideoPid": { - "shape": "__integerMin32Max8182", - "locationName": "videoPid", - "documentation": "Packet Identifier (PID) of the elementary video stream in the transport stream." - } - }, - "documentation": "Settings for M2TS Container." - }, - "M3u8NielsenId3": { - "type": "string", - "documentation": "If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.", - "enum": [ - "INSERT", - "NONE" - ] - }, - "M3u8PcrControl": { - "type": "string", - "documentation": "When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.", - "enum": [ - "PCR_EVERY_PES_PACKET", - "CONFIGURED_PCR_PERIOD" - ] - }, - "M3u8Scte35Source": { - "type": "string", - "documentation": "Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output.", - "enum": [ - "PASSTHROUGH", - "NONE" - ] - }, - "M3u8Settings": { - "type": "structure", - "members": { - "AudioFramesPerPes": { - "shape": "__integerMin0Max2147483647", - "locationName": "audioFramesPerPes", - "documentation": "The number of audio frames to insert for each PES packet." - }, - "AudioPids": { - "shape": "__listOf__integerMin32Max8182", - "locationName": "audioPids", - "documentation": "Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation." - }, - "NielsenId3": { - "shape": "M3u8NielsenId3", - "locationName": "nielsenId3" - }, - "PatInterval": { - "shape": "__integerMin0Max1000", - "locationName": "patInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "PcrControl": { - "shape": "M3u8PcrControl", - "locationName": "pcrControl" - }, - "PcrPid": { - "shape": "__integerMin32Max8182", - "locationName": "pcrPid", - "documentation": "Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID." - }, - "PmtInterval": { - "shape": "__integerMin0Max1000", - "locationName": "pmtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "PmtPid": { - "shape": "__integerMin32Max8182", - "locationName": "pmtPid", - "documentation": "Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream." - }, - "PrivateMetadataPid": { - "shape": "__integerMin32Max8182", - "locationName": "privateMetadataPid", - "documentation": "Packet Identifier (PID) of the private metadata stream in the transport stream." - }, - "ProgramNumber": { - "shape": "__integerMin0Max65535", - "locationName": "programNumber", - "documentation": "The value of the program number field in the Program Map Table." - }, - "Scte35Pid": { - "shape": "__integerMin32Max8182", - "locationName": "scte35Pid", - "documentation": "Packet Identifier (PID) of the SCTE-35 stream in the transport stream." - }, - "Scte35Source": { - "shape": "M3u8Scte35Source", - "locationName": "scte35Source" - }, - "TimedMetadata": { - "shape": "TimedMetadata", - "locationName": "timedMetadata" - }, - "TimedMetadataPid": { - "shape": "__integerMin32Max8182", - "locationName": "timedMetadataPid", - "documentation": "Packet Identifier (PID) of the timed metadata stream in the transport stream." - }, - "TransportStreamId": { - "shape": "__integerMin0Max65535", - "locationName": "transportStreamId", - "documentation": "The value of the transport stream ID field in the Program Map Table." - }, - "VideoPid": { - "shape": "__integerMin32Max8182", - "locationName": "videoPid", - "documentation": "Packet Identifier (PID) of the elementary video stream in the transport stream." - } - }, - "documentation": "Settings for TS segments in HLS" - }, - "MovClapAtom": { - "type": "string", - "documentation": "When enabled, include 'clap' atom if appropriate for the video output settings.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "MovCslgAtom": { - "type": "string", - "documentation": "When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "MovMpeg2FourCCControl": { - "type": "string", - "documentation": "When set to XDCAM, writes MPEG2 video streams into the QuickTime file using XDCAM fourcc codes. This increases compatibility with Apple editors and players, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2.", - "enum": [ - "XDCAM", - "MPEG" - ] - }, - "MovPaddingControl": { - "type": "string", - "documentation": "If set to OMNEON, inserts Omneon-compatible padding", - "enum": [ - "OMNEON", - "NONE" - ] - }, - "MovReference": { - "type": "string", - "documentation": "A value of 'external' creates separate media files and the wrapper file (.mov) contains references to these media files. A value of 'self_contained' creates only a wrapper (.mov) file and this file contains all of the media.", - "enum": [ - "SELF_CONTAINED", - "EXTERNAL" - ] - }, - "MovSettings": { - "type": "structure", - "members": { - "ClapAtom": { - "shape": "MovClapAtom", - "locationName": "clapAtom" - }, - "CslgAtom": { - "shape": "MovCslgAtom", - "locationName": "cslgAtom" - }, - "Mpeg2FourCCControl": { - "shape": "MovMpeg2FourCCControl", - "locationName": "mpeg2FourCCControl" - }, - "PaddingControl": { - "shape": "MovPaddingControl", - "locationName": "paddingControl" - }, - "Reference": { - "shape": "MovReference", - "locationName": "reference" - } - }, - "documentation": "Settings for MOV Container." - }, - "Mp2Settings": { - "type": "structure", - "members": { - "Bitrate": { - "shape": "__integerMin32000Max384000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second." - }, - "Channels": { - "shape": "__integerMin1Max2", - "locationName": "channels", - "documentation": "Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2." - }, - "SampleRate": { - "shape": "__integerMin32000Max48000", - "locationName": "sampleRate", - "documentation": "Sample rate in hz." - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2." - }, - "Mp4CslgAtom": { - "type": "string", - "documentation": "When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "Mp4FreeSpaceBox": { - "type": "string", - "documentation": "Inserts a free-space box immediately after the moov box.", - "enum": [ - "INCLUDE", - "EXCLUDE" - ] - }, - "Mp4MoovPlacement": { - "type": "string", - "documentation": "If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end.", - "enum": [ - "PROGRESSIVE_DOWNLOAD", - "NORMAL" - ] - }, - "Mp4Settings": { - "type": "structure", - "members": { - "CslgAtom": { - "shape": "Mp4CslgAtom", - "locationName": "cslgAtom" - }, - "FreeSpaceBox": { - "shape": "Mp4FreeSpaceBox", - "locationName": "freeSpaceBox" - }, - "MoovPlacement": { - "shape": "Mp4MoovPlacement", - "locationName": "moovPlacement" - }, - "Mp4MajorBrand": { - "shape": "__string", - "locationName": "mp4MajorBrand", - "documentation": "Overrides the \"Major Brand\" field in the output file. Usually not necessary to specify." - } - }, - "documentation": "Settings for MP4 Container" - }, - "Mpeg2AdaptiveQuantization": { - "type": "string", - "documentation": "Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.", - "enum": [ - "OFF", - "LOW", - "MEDIUM", - "HIGH" - ] - }, - "Mpeg2CodecLevel": { - "type": "string", - "documentation": "Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output.", - "enum": [ - "AUTO", - "LOW", - "MAIN", - "HIGH1440", - "HIGH" - ] - }, - "Mpeg2CodecProfile": { - "type": "string", - "documentation": "Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output.", - "enum": [ - "MAIN", - "PROFILE_422" - ] - }, - "Mpeg2DynamicSubGop": { - "type": "string", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames).", - "enum": [ - "ADAPTIVE", - "STATIC" - ] - }, - "Mpeg2FramerateControl": { - "type": "string", - "documentation": "If you are using the console, use the Framerate setting to specify the framerate for this output. If you want to keep the same framerate as the input video, choose Follow source. If you want to do framerate conversion, choose a framerate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your framerate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the framerate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Choose SPECIFIED if you want the service to use the framerate you specify in the settings FramerateNumerator and FramerateDenominator.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "Mpeg2FramerateConversionAlgorithm": { - "type": "string", - "documentation": "When set to INTERPOLATE, produces smoother motion during framerate conversion.", - "enum": [ - "DUPLICATE_DROP", - "INTERPOLATE" - ] - }, - "Mpeg2GopSizeUnits": { - "type": "string", - "documentation": "Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.", - "enum": [ - "FRAMES", - "SECONDS" - ] - }, - "Mpeg2InterlaceMode": { - "type": "string", - "documentation": "Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type.\n - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of \"top field first\" and \"bottom field first\".\n - If the source is progressive, the output will be interlaced with \"top field first\" or \"bottom field first\" polarity, depending on which of the Follow options you chose.", - "enum": [ - "PROGRESSIVE", - "TOP_FIELD", - "BOTTOM_FIELD", - "FOLLOW_TOP_FIELD", - "FOLLOW_BOTTOM_FIELD" - ] - }, - "Mpeg2IntraDcPrecision": { - "type": "string", - "documentation": "Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.", - "enum": [ - "AUTO", - "INTRA_DC_PRECISION_8", - "INTRA_DC_PRECISION_9", - "INTRA_DC_PRECISION_10", - "INTRA_DC_PRECISION_11" - ] - }, - "Mpeg2ParControl": { - "type": "string", - "documentation": "Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "Mpeg2QualityTuningLevel": { - "type": "string", - "documentation": "Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding.", - "enum": [ - "SINGLE_PASS", - "MULTI_PASS" - ] - }, - "Mpeg2RateControlMode": { - "type": "string", - "documentation": "Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr).", - "enum": [ - "VBR", - "CBR" - ] - }, - "Mpeg2SceneChangeDetect": { - "type": "string", - "documentation": "Scene change detection (inserts I-frames on scene changes).", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "Mpeg2Settings": { - "type": "structure", - "members": { - "AdaptiveQuantization": { - "shape": "Mpeg2AdaptiveQuantization", - "locationName": "adaptiveQuantization" - }, - "Bitrate": { - "shape": "__integerMin1000Max288000000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000." - }, - "CodecLevel": { - "shape": "Mpeg2CodecLevel", - "locationName": "codecLevel" - }, - "CodecProfile": { - "shape": "Mpeg2CodecProfile", - "locationName": "codecProfile" - }, - "DynamicSubGop": { - "shape": "Mpeg2DynamicSubGop", - "locationName": "dynamicSubGop", - "documentation": "Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames)." - }, - "FramerateControl": { - "shape": "Mpeg2FramerateControl", - "locationName": "framerateControl" - }, - "FramerateConversionAlgorithm": { - "shape": "Mpeg2FramerateConversionAlgorithm", - "locationName": "framerateConversionAlgorithm" - }, - "FramerateDenominator": { - "shape": "__integerMin1Max1001", - "locationName": "framerateDenominator", - "documentation": "Framerate denominator." - }, - "FramerateNumerator": { - "shape": "__integerMin24Max60000", - "locationName": "framerateNumerator", - "documentation": "Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps." - }, - "GopClosedCadence": { - "shape": "__integerMin0Max2147483647", - "locationName": "gopClosedCadence", - "documentation": "Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting." - }, - "GopSize": { - "shape": "__doubleMin0", - "locationName": "gopSize", - "documentation": "GOP Length (keyframe interval) in frames or seconds. Must be greater than zero." - }, - "GopSizeUnits": { - "shape": "Mpeg2GopSizeUnits", - "locationName": "gopSizeUnits" - }, - "HrdBufferInitialFillPercentage": { - "shape": "__integerMin0Max100", - "locationName": "hrdBufferInitialFillPercentage", - "documentation": "Percentage of the buffer that should initially be filled (HRD buffer model)." - }, - "HrdBufferSize": { - "shape": "__integerMin0Max47185920", - "locationName": "hrdBufferSize", - "documentation": "Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000." - }, - "InterlaceMode": { - "shape": "Mpeg2InterlaceMode", - "locationName": "interlaceMode" - }, - "IntraDcPrecision": { - "shape": "Mpeg2IntraDcPrecision", - "locationName": "intraDcPrecision" - }, - "MaxBitrate": { - "shape": "__integerMin1000Max300000000", - "locationName": "maxBitrate", - "documentation": "Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000." - }, - "MinIInterval": { - "shape": "__integerMin0Max30", - "locationName": "minIInterval", - "documentation": "Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1" - }, - "NumberBFramesBetweenReferenceFrames": { - "shape": "__integerMin0Max7", - "locationName": "numberBFramesBetweenReferenceFrames", - "documentation": "Number of B-frames between reference frames." - }, - "ParControl": { - "shape": "Mpeg2ParControl", - "locationName": "parControl" - }, - "ParDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parDenominator", - "documentation": "Pixel Aspect Ratio denominator." - }, - "ParNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parNumerator", - "documentation": "Pixel Aspect Ratio numerator." - }, - "QualityTuningLevel": { - "shape": "Mpeg2QualityTuningLevel", - "locationName": "qualityTuningLevel" - }, - "RateControlMode": { - "shape": "Mpeg2RateControlMode", - "locationName": "rateControlMode" - }, - "SceneChangeDetect": { - "shape": "Mpeg2SceneChangeDetect", - "locationName": "sceneChangeDetect" - }, - "SlowPal": { - "shape": "Mpeg2SlowPal", - "locationName": "slowPal" - }, - "Softness": { - "shape": "__integerMin0Max128", - "locationName": "softness", - "documentation": "Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image." - }, - "SpatialAdaptiveQuantization": { - "shape": "Mpeg2SpatialAdaptiveQuantization", - "locationName": "spatialAdaptiveQuantization" - }, - "Syntax": { - "shape": "Mpeg2Syntax", - "locationName": "syntax" - }, - "Telecine": { - "shape": "Mpeg2Telecine", - "locationName": "telecine" - }, - "TemporalAdaptiveQuantization": { - "shape": "Mpeg2TemporalAdaptiveQuantization", - "locationName": "temporalAdaptiveQuantization" - } - }, - "documentation": "Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2." - }, - "Mpeg2SlowPal": { - "type": "string", - "documentation": "Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "Mpeg2SpatialAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on spatial variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "Mpeg2Syntax": { - "type": "string", - "documentation": "Produces a Type D-10 compatible bitstream (SMPTE 356M-2001).", - "enum": [ - "DEFAULT", - "D_10" - ] - }, - "Mpeg2Telecine": { - "type": "string", - "documentation": "Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player.", - "enum": [ - "NONE", - "SOFT", - "HARD" - ] - }, - "Mpeg2TemporalAdaptiveQuantization": { - "type": "string", - "documentation": "Adjust quantization within each frame based on temporal variation of content complexity.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "MsSmoothAudioDeduplication": { - "type": "string", - "documentation": "COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream.", - "enum": [ - "COMBINE_DUPLICATE_STREAMS", - "NONE" - ] - }, - "MsSmoothEncryptionSettings": { - "type": "structure", - "members": { - "SpekeKeyProvider": { - "shape": "SpekeKeyProvider", - "locationName": "spekeKeyProvider" - } - }, - "documentation": "If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.", - "required": [ - "SpekeKeyProvider" - ] - }, - "MsSmoothGroupSettings": { - "type": "structure", - "members": { - "AudioDeduplication": { - "shape": "MsSmoothAudioDeduplication", - "locationName": "audioDeduplication" - }, - "Destination": { - "shape": "__stringPatternS3", - "locationName": "destination", - "documentation": "Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file." - }, - "Encryption": { - "shape": "MsSmoothEncryptionSettings", - "locationName": "encryption" - }, - "FragmentLength": { - "shape": "__integerMin1Max2147483647", - "locationName": "fragmentLength", - "documentation": "Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and framerate." - }, - "ManifestEncoding": { - "shape": "MsSmoothManifestEncoding", - "locationName": "manifestEncoding" - } - }, - "documentation": "Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.", - "required": [ - "FragmentLength" - ] - }, - "MsSmoothManifestEncoding": { - "type": "string", - "documentation": "Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16.", - "enum": [ - "UTF8", - "UTF16" - ] - }, - "NielsenConfiguration": { - "type": "structure", - "members": { - "BreakoutCode": { - "shape": "__integerMin0Max9", - "locationName": "breakoutCode", - "documentation": "Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9." - }, - "DistributorId": { - "shape": "__string", - "locationName": "distributorId", - "documentation": "Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen." - } - }, - "documentation": "Settings for Nielsen Configuration" - }, - "NoiseReducer": { - "type": "structure", - "members": { - "Filter": { - "shape": "NoiseReducerFilter", - "locationName": "filter" - }, - "FilterSettings": { - "shape": "NoiseReducerFilterSettings", - "locationName": "filterSettings" - }, - "SpatialFilterSettings": { - "shape": "NoiseReducerSpatialFilterSettings", - "locationName": "spatialFilterSettings" - } - }, - "documentation": "Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default. When you enable Noise reducer (NoiseReducer), you must also select a value for Noise reducer filter (NoiseReducerFilter).", - "required": [ - "Filter" - ] - }, - "NoiseReducerFilter": { - "type": "string", - "documentation": "Use Noise reducer filter (NoiseReducerFilter) to select one of the following spatial image filtering functions. To use this setting, you must also enable Noise reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles.", - "enum": [ - "BILATERAL", - "MEAN", - "GAUSSIAN", - "LANCZOS", - "SHARPEN", - "CONSERVE", - "SPATIAL" - ] - }, - "NoiseReducerFilterSettings": { - "type": "structure", - "members": { - "Strength": { - "shape": "__integerMin0Max3", - "locationName": "strength", - "documentation": "Relative strength of noise reducing filter. Higher values produce stronger filtering." - } - }, - "documentation": "Settings for a noise reducer filter" - }, - "NoiseReducerSpatialFilterSettings": { - "type": "structure", - "members": { - "PostFilterSharpenStrength": { - "shape": "__integerMin0Max3", - "locationName": "postFilterSharpenStrength", - "documentation": "Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength." - }, - "Speed": { - "shape": "__integerMinNegative2Max3", - "locationName": "speed", - "documentation": "The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value." - }, - "Strength": { - "shape": "__integerMin0Max16", - "locationName": "strength", - "documentation": "Relative strength of noise reducing filter. Higher values produce stronger filtering." - } - }, - "documentation": "Noise reducer filter settings for spatial filter." - }, - "NotFoundException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 404 - }, - "documentation": "The resource you requested does not exist." - }, - "Order": { - "type": "string", - "documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.", - "enum": [ - "ASCENDING", - "DESCENDING" - ] - }, - "Output": { - "type": "structure", - "members": { - "AudioDescriptions": { - "shape": "__listOfAudioDescription", - "locationName": "audioDescriptions", - "documentation": "(AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings." - }, - "CaptionDescriptions": { - "shape": "__listOfCaptionDescription", - "locationName": "captionDescriptions", - "documentation": "(CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings." - }, - "ContainerSettings": { - "shape": "ContainerSettings", - "locationName": "containerSettings" - }, - "Extension": { - "shape": "__string", - "locationName": "extension", - "documentation": "Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)" - }, - "NameModifier": { - "shape": "__stringMin1", - "locationName": "nameModifier", - "documentation": "Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group." - }, - "OutputSettings": { - "shape": "OutputSettings", - "locationName": "outputSettings" - }, - "Preset": { - "shape": "__stringMin0", - "locationName": "preset", - "documentation": "Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both." - }, - "VideoDescription": { - "shape": "VideoDescription", - "locationName": "videoDescription", - "documentation": "(VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output." - } - }, - "documentation": "An output object describes the settings for a single output file or stream in an output group." - }, - "OutputChannelMapping": { - "type": "structure", - "members": { - "InputChannels": { - "shape": "__listOf__integerMinNegative60Max6", - "locationName": "inputChannels", - "documentation": "List of input channels" - } - }, - "documentation": "OutputChannel mapping settings.", - "required": [ - "InputChannels" - ] - }, - "OutputDetail": { - "type": "structure", - "members": { - "DurationInMs": { - "shape": "__integer", - "locationName": "durationInMs", - "documentation": "Duration in milliseconds" - }, - "VideoDetails": { - "shape": "VideoDetail", - "locationName": "videoDetails" - } - }, - "documentation": "Details regarding output" - }, - "OutputGroup": { - "type": "structure", - "members": { - "CustomName": { - "shape": "__string", - "locationName": "customName", - "documentation": "Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the output group" - }, - "OutputGroupSettings": { - "shape": "OutputGroupSettings", - "locationName": "outputGroupSettings" - }, - "Outputs": { - "shape": "__listOfOutput", - "locationName": "outputs", - "documentation": "This object holds groups of encoding settings, one group of settings per output." - } - }, - "documentation": "Group of outputs", - "required": [ - "Outputs", - "OutputGroupSettings" - ] - }, - "OutputGroupDetail": { - "type": "structure", - "members": { - "OutputDetails": { - "shape": "__listOfOutputDetail", - "locationName": "outputDetails", - "documentation": "Details about the output" - } - }, - "documentation": "Contains details about the output groups specified in the job settings." - }, - "OutputGroupSettings": { - "type": "structure", - "members": { - "CmafGroupSettings": { - "shape": "CmafGroupSettings", - "locationName": "cmafGroupSettings" - }, - "DashIsoGroupSettings": { - "shape": "DashIsoGroupSettings", - "locationName": "dashIsoGroupSettings" - }, - "FileGroupSettings": { - "shape": "FileGroupSettings", - "locationName": "fileGroupSettings" - }, - "HlsGroupSettings": { - "shape": "HlsGroupSettings", - "locationName": "hlsGroupSettings" - }, - "MsSmoothGroupSettings": { - "shape": "MsSmoothGroupSettings", - "locationName": "msSmoothGroupSettings" - }, - "Type": { - "shape": "OutputGroupType", - "locationName": "type" - } - }, - "documentation": "Output Group settings, including type", - "required": [ - "Type" - ] - }, - "OutputGroupType": { - "type": "string", - "documentation": "Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF)", - "enum": [ - "HLS_GROUP_SETTINGS", - "DASH_ISO_GROUP_SETTINGS", - "FILE_GROUP_SETTINGS", - "MS_SMOOTH_GROUP_SETTINGS", - "CMAF_GROUP_SETTINGS" - ] - }, - "OutputSdt": { - "type": "string", - "documentation": "Selects method of inserting SDT information into output stream. \"Follow input SDT\" copies SDT information from input stream to output stream. \"Follow input SDT if present\" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter \"SDT Manually\" means user will enter the SDT information. \"No SDT\" means output stream will not contain SDT information.", - "enum": [ - "SDT_FOLLOW", - "SDT_FOLLOW_IF_PRESENT", - "SDT_MANUAL", - "SDT_NONE" - ] - }, - "OutputSettings": { - "type": "structure", - "members": { - "HlsSettings": { - "shape": "HlsSettings", - "locationName": "hlsSettings" - } - }, - "documentation": "Specific settings for this type of output." - }, - "Preset": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "An identifier for this resource that is unique within all of AWS." - }, - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "An optional category you create to organize your presets." - }, - "CreatedAt": { - "shape": "__timestampUnix", - "locationName": "createdAt", - "documentation": "The timestamp in epoch seconds for preset creation." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "An optional description you create for each preset." - }, - "LastUpdated": { - "shape": "__timestampUnix", - "locationName": "lastUpdated", - "documentation": "The timestamp in epoch seconds when the preset was last updated." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "A name you create for each preset. Each name must be unique within your account." - }, - "Settings": { - "shape": "PresetSettings", - "locationName": "settings" - }, - "Type": { - "shape": "Type", - "locationName": "type", - "documentation": "A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user." - } - }, - "documentation": "A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.", - "required": [ - "Settings", - "Name" - ] - }, - "PresetListBy": { - "type": "string", - "documentation": "Optional. When you request a list of presets, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name.", - "enum": [ - "NAME", - "CREATION_DATE", - "SYSTEM" - ] - }, - "PresetSettings": { - "type": "structure", - "members": { - "AudioDescriptions": { - "shape": "__listOfAudioDescription", - "locationName": "audioDescriptions", - "documentation": "(AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings." - }, - "CaptionDescriptions": { - "shape": "__listOfCaptionDescriptionPreset", - "locationName": "captionDescriptions", - "documentation": "Caption settings for this preset. There can be multiple caption settings in a single output." - }, - "ContainerSettings": { - "shape": "ContainerSettings", - "locationName": "containerSettings" - }, - "VideoDescription": { - "shape": "VideoDescription", - "locationName": "videoDescription", - "documentation": "(VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output." - } - }, - "documentation": "Settings for preset" - }, - "ProresCodecProfile": { - "type": "string", - "documentation": "Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output.", - "enum": [ - "APPLE_PRORES_422", - "APPLE_PRORES_422_HQ", - "APPLE_PRORES_422_LT", - "APPLE_PRORES_422_PROXY" - ] - }, - "ProresFramerateControl": { - "type": "string", - "documentation": "If you are using the console, use the Framerate setting to specify the framerate for this output. If you want to keep the same framerate as the input video, choose Follow source. If you want to do framerate conversion, choose a framerate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your framerate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the framerate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Choose SPECIFIED if you want the service to use the framerate you specify in the settings FramerateNumerator and FramerateDenominator.", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "ProresFramerateConversionAlgorithm": { - "type": "string", - "documentation": "When set to INTERPOLATE, produces smoother motion during framerate conversion.", - "enum": [ - "DUPLICATE_DROP", - "INTERPOLATE" - ] - }, - "ProresInterlaceMode": { - "type": "string", - "documentation": "Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type.\n - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of \"top field first\" and \"bottom field first\".\n - If the source is progressive, the output will be interlaced with \"top field first\" or \"bottom field first\" polarity, depending on which of the Follow options you chose.", - "enum": [ - "PROGRESSIVE", - "TOP_FIELD", - "BOTTOM_FIELD", - "FOLLOW_TOP_FIELD", - "FOLLOW_BOTTOM_FIELD" - ] - }, - "ProresParControl": { - "type": "string", - "documentation": "Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator).", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ] - }, - "ProresSettings": { - "type": "structure", - "members": { - "CodecProfile": { - "shape": "ProresCodecProfile", - "locationName": "codecProfile" - }, - "FramerateControl": { - "shape": "ProresFramerateControl", - "locationName": "framerateControl" - }, - "FramerateConversionAlgorithm": { - "shape": "ProresFramerateConversionAlgorithm", - "locationName": "framerateConversionAlgorithm" - }, - "FramerateDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateDenominator", - "documentation": "Framerate denominator." - }, - "FramerateNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "framerateNumerator", - "documentation": "When you use the API for transcode jobs that use framerate conversion, specify the framerate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator." - }, - "InterlaceMode": { - "shape": "ProresInterlaceMode", - "locationName": "interlaceMode" - }, - "ParControl": { - "shape": "ProresParControl", - "locationName": "parControl" - }, - "ParDenominator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parDenominator", - "documentation": "Pixel Aspect Ratio denominator." - }, - "ParNumerator": { - "shape": "__integerMin1Max2147483647", - "locationName": "parNumerator", - "documentation": "Pixel Aspect Ratio numerator." - }, - "SlowPal": { - "shape": "ProresSlowPal", - "locationName": "slowPal" - }, - "Telecine": { - "shape": "ProresTelecine", - "locationName": "telecine" - } - }, - "documentation": "Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES." - }, - "ProresSlowPal": { - "type": "string", - "documentation": "Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.", - "enum": [ - "DISABLED", - "ENABLED" - ] - }, - "ProresTelecine": { - "type": "string", - "documentation": "Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player.", - "enum": [ - "NONE", - "HARD" - ] - }, - "Queue": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "An identifier for this resource that is unique within all of AWS." - }, - "CreatedAt": { - "shape": "__timestampUnix", - "locationName": "createdAt", - "documentation": "The timestamp in epoch seconds for queue creation." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "An optional description you create for each queue." - }, - "LastUpdated": { - "shape": "__timestampUnix", - "locationName": "lastUpdated", - "documentation": "The timestamp in epoch seconds when the queue was last updated." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "A name you create for each queue. Each name must be unique within your account." - }, - "ProgressingJobsCount": { - "shape": "__integer", - "locationName": "progressingJobsCount", - "documentation": "Estimated number of jobs in PROGRESSING status." - }, - "Status": { - "shape": "QueueStatus", - "locationName": "status" - }, - "SubmittedJobsCount": { - "shape": "__integer", - "locationName": "submittedJobsCount", - "documentation": "Estimated number of jobs in SUBMITTED status." - }, - "Type": { - "shape": "Type", - "locationName": "type", - "documentation": "A queue can be of two types: system or custom. System or built-in queues can't be modified or deleted by the user." - } - }, - "documentation": "MediaConvert jobs are submitted to a queue. Unless specified otherwise jobs are submitted to a built-in default queue. User can create additional queues to separate the jobs of different categories or priority.", - "required": [ - "Name" - ] - }, - "QueueListBy": { - "type": "string", - "documentation": "Optional. When you request a list of queues, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by creation date.", - "enum": [ - "NAME", - "CREATION_DATE" - ] - }, - "QueueStatus": { - "type": "string", - "documentation": "Queues can be ACTIVE or PAUSED. If you pause a queue, jobs in that queue will not begin. Jobs running when a queue is paused continue to run until they finish or error out.", - "enum": [ - "ACTIVE", - "PAUSED" - ] - }, - "Rectangle": { - "type": "structure", - "members": { - "Height": { - "shape": "__integerMin2Max2147483647", - "locationName": "height", - "documentation": "Height of rectangle in pixels. Specify only even numbers." - }, - "Width": { - "shape": "__integerMin2Max2147483647", - "locationName": "width", - "documentation": "Width of rectangle in pixels. Specify only even numbers." - }, - "X": { - "shape": "__integerMin0Max2147483647", - "locationName": "x", - "documentation": "The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers." - }, - "Y": { - "shape": "__integerMin0Max2147483647", - "locationName": "y", - "documentation": "The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers." - } - }, - "documentation": "Use Rectangle to identify a specific area of the video frame.", - "required": [ - "X", - "Y", - "Height", - "Width" - ] - }, - "RemixSettings": { - "type": "structure", - "members": { - "ChannelMapping": { - "shape": "ChannelMapping", - "locationName": "channelMapping" - }, - "ChannelsIn": { - "shape": "__integerMin1Max16", - "locationName": "channelsIn", - "documentation": "Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different." - }, - "ChannelsOut": { - "shape": "__integerMin1Max8", - "locationName": "channelsOut", - "documentation": "Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8" - } - }, - "documentation": "Use Manual audio remixing (RemixSettings) to adjust audio levels for each audio channel in each output of your job. With audio remixing, you can output more or fewer audio channels than your input audio source provides.", - "required": [ - "ChannelsOut", - "ChannelMapping", - "ChannelsIn" - ] - }, - "ResourceTags": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Amazon Resource Name (ARN) of the resource." - }, - "Tags": { - "shape": "__mapOf__string", - "locationName": "tags", - "documentation": "The tags for the resource." - } - }, - "documentation": "The Amazon Resource Name (ARN) and tags for an AWS Elemental MediaConvert resource." - }, - "RespondToAfd": { - "type": "string", - "documentation": "Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.", - "enum": [ - "NONE", - "RESPOND", - "PASSTHROUGH" - ] - }, - "ScalingBehavior": { - "type": "string", - "documentation": "Applies only if your input aspect ratio is different from your output aspect ratio. Enable Stretch to output (StretchToOutput) to have the service stretch your video image to fit. Leave this setting disabled to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job.", - "enum": [ - "DEFAULT", - "STRETCH_TO_OUTPUT" - ] - }, - "SccDestinationFramerate": { - "type": "string", - "documentation": "Set Framerate (SccDestinationFramerate) to make sure that the captions and the video are synchronized in the output. Specify a framerate that matches the framerate of the associated video. If the video framerate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME).", - "enum": [ - "FRAMERATE_23_97", - "FRAMERATE_24", - "FRAMERATE_29_97_DROPFRAME", - "FRAMERATE_29_97_NON_DROPFRAME" - ] - }, - "SccDestinationSettings": { - "type": "structure", - "members": { - "Framerate": { - "shape": "SccDestinationFramerate", - "locationName": "framerate" - } - }, - "documentation": "Settings for SCC caption output." - }, - "SpekeKeyProvider": { - "type": "structure", - "members": { - "ResourceId": { - "shape": "__string", - "locationName": "resourceId", - "documentation": "The SPEKE-compliant server uses Resource ID (ResourceId) to identify content." - }, - "SystemIds": { - "shape": "__listOf__stringPattern09aFAF809aFAF409aFAF409aFAF409aFAF12", - "locationName": "systemIds", - "documentation": "Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id." - }, - "Url": { - "shape": "__stringPatternHttps", - "locationName": "url", - "documentation": "Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content." - } - }, - "documentation": "Settings for use with a SPEKE key provider", - "required": [ - "ResourceId", - "SystemIds", - "Url" - ] - }, - "StaticKeyProvider": { - "type": "structure", - "members": { - "KeyFormat": { - "shape": "__stringPatternIdentityAZaZ26AZaZ09163", - "locationName": "keyFormat", - "documentation": "Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'." - }, - "KeyFormatVersions": { - "shape": "__stringPatternDD", - "locationName": "keyFormatVersions", - "documentation": "Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3)." - }, - "StaticKeyValue": { - "shape": "__stringPatternAZaZ0932", - "locationName": "staticKeyValue", - "documentation": "Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue)." - }, - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "Relates to DRM implementation. The location of the license server used for protecting content." - } - }, - "documentation": "Settings for use with a SPEKE key provider.", - "required": [ - "Url", - "StaticKeyValue" - ] - }, - "TagResourceRequest": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Amazon Resource Name (ARN) of the resource that you want to tag. To get the ARN, send a GET request with the resource name." - }, - "Tags": { - "shape": "__mapOf__string", - "locationName": "tags", - "documentation": "The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key." - } - }, - "required": [ - "Arn", - "Tags" - ] - }, - "TagResourceResponse": { - "type": "structure", - "members": { - } - }, - "TeletextDestinationSettings": { - "type": "structure", - "members": { - "PageNumber": { - "shape": "__stringMin3Max3Pattern1809aFAF09aEAE", - "locationName": "pageNumber", - "documentation": "Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field." - } - }, - "documentation": "Settings for Teletext caption output" - }, - "TeletextSourceSettings": { - "type": "structure", - "members": { - "PageNumber": { - "shape": "__stringMin3Max3Pattern1809aFAF09aEAE", - "locationName": "pageNumber", - "documentation": "Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output." - } - }, - "documentation": "Settings specific to Teletext caption sources, including Page number." - }, - "TimecodeBurnin": { - "type": "structure", - "members": { - "FontSize": { - "shape": "__integerMin10Max48", - "locationName": "fontSize", - "documentation": "Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48." - }, - "Position": { - "shape": "TimecodeBurninPosition", - "locationName": "position" - }, - "Prefix": { - "shape": "__stringPattern", - "locationName": "prefix", - "documentation": "Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of \"EZ-\" will result in the timecode \"EZ-00:00:00:00\". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard." - } - }, - "documentation": "Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output." - }, - "TimecodeBurninPosition": { - "type": "string", - "documentation": "Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video.", - "enum": [ - "TOP_CENTER", - "TOP_LEFT", - "TOP_RIGHT", - "MIDDLE_LEFT", - "MIDDLE_CENTER", - "MIDDLE_RIGHT", - "BOTTOM_LEFT", - "BOTTOM_CENTER", - "BOTTOM_RIGHT" - ] - }, - "TimecodeConfig": { - "type": "structure", - "members": { - "Anchor": { - "shape": "__stringPattern010920405090509092", - "locationName": "anchor", - "documentation": "If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores framerate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input." - }, - "Source": { - "shape": "TimecodeSource", - "locationName": "source" - }, - "Start": { - "shape": "__stringPattern010920405090509092", - "locationName": "start", - "documentation": "Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF)." - }, - "TimestampOffset": { - "shape": "__stringPattern0940191020191209301", - "locationName": "timestampOffset", - "documentation": "Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format \"yyyy-mm-dd\". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25." - } - }, - "documentation": "These settings control how the service handles timecodes throughout the job. These settings don't affect input clipping." - }, - "TimecodeSource": { - "type": "string", - "documentation": "Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value.", - "enum": [ - "EMBEDDED", - "ZEROBASED", - "SPECIFIEDSTART" - ] - }, - "TimedMetadata": { - "type": "string", - "documentation": "Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output.", - "enum": [ - "PASSTHROUGH", - "NONE" - ] - }, - "TimedMetadataInsertion": { - "type": "structure", - "members": { - "Id3Insertions": { - "shape": "__listOfId3Insertion", - "locationName": "id3Insertions", - "documentation": "Id3Insertions contains the array of Id3Insertion instances." - } - }, - "documentation": "Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.", - "required": [ - "Id3Insertions" - ] - }, - "Timing": { - "type": "structure", - "members": { - "FinishTime": { - "shape": "__timestampUnix", - "locationName": "finishTime", - "documentation": "The time, in Unix epoch format, that the transcoding job finished" - }, - "StartTime": { - "shape": "__timestampUnix", - "locationName": "startTime", - "documentation": "The time, in Unix epoch format, that transcoding for the job began." - }, - "SubmitTime": { - "shape": "__timestampUnix", - "locationName": "submitTime", - "documentation": "The time, in Unix epoch format, that you submitted the job." - } - }, - "documentation": "Information about when jobs are submitted, started, and finished is specified in Unix epoch format in seconds." - }, - "TooManyRequestsException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 429 - }, - "documentation": "Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests." - }, - "TtmlDestinationSettings": { - "type": "structure", - "members": { - "StylePassthrough": { - "shape": "TtmlStylePassthrough", - "locationName": "stylePassthrough" - } - }, - "documentation": "Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough)." - }, - "TtmlStylePassthrough": { - "type": "string", - "documentation": "Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output.", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "Type": { - "type": "string", - "enum": [ - "SYSTEM", - "CUSTOM" - ] - }, - "UntagResourceRequest": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Amazon Resource Name (ARN) of the resource that you want to remove tags from. To get the ARN, send a GET request with the resource name." - }, - "TagKeys": { - "shape": "__listOf__string", - "locationName": "tagKeys", - "documentation": "The keys of the tags that you want to remove from the resource." - } - } - }, - "UntagResourceResponse": { - "type": "structure", - "members": { - } - }, - "UpdateJobTemplateRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "The new category for the job template, if you are changing it." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "The new description for the job template, if you are changing it." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the job template you are modifying", - "location": "uri" - }, - "Queue": { - "shape": "__string", - "locationName": "queue", - "documentation": "The new queue for the job template, if you are changing it." - }, - "Settings": { - "shape": "JobTemplateSettings", - "locationName": "settings" - } - }, - "required": [ - "Name" - ] - }, - "UpdateJobTemplateResponse": { - "type": "structure", - "members": { - "JobTemplate": { - "shape": "JobTemplate", - "locationName": "jobTemplate" - } - } - }, - "UpdatePresetRequest": { - "type": "structure", - "members": { - "Category": { - "shape": "__string", - "locationName": "category", - "documentation": "The new category for the preset, if you are changing it." - }, - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "The new description for the preset, if you are changing it." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the preset you are modifying.", - "location": "uri" - }, - "Settings": { - "shape": "PresetSettings", - "locationName": "settings" - } - }, - "required": [ - "Name" - ] - }, - "UpdatePresetResponse": { - "type": "structure", - "members": { - "Preset": { - "shape": "Preset", - "locationName": "preset" - } - } - }, - "UpdateQueueRequest": { - "type": "structure", - "members": { - "Description": { - "shape": "__string", - "locationName": "description", - "documentation": "The new description for the queue, if you are changing it." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the queue you are modifying.", - "location": "uri" - }, - "Status": { - "shape": "QueueStatus", - "locationName": "status" - } - }, - "required": [ - "Name" - ] - }, - "UpdateQueueResponse": { - "type": "structure", - "members": { - "Queue": { - "shape": "Queue", - "locationName": "queue" - } - } - }, - "VideoCodec": { - "type": "string", - "documentation": "Type of video codec", - "enum": [ - "FRAME_CAPTURE", - "H_264", - "H_265", - "MPEG2", - "PRORES" - ] - }, - "VideoCodecSettings": { - "type": "structure", - "members": { - "Codec": { - "shape": "VideoCodec", - "locationName": "codec" - }, - "FrameCaptureSettings": { - "shape": "FrameCaptureSettings", - "locationName": "frameCaptureSettings" - }, - "H264Settings": { - "shape": "H264Settings", - "locationName": "h264Settings" - }, - "H265Settings": { - "shape": "H265Settings", - "locationName": "h265Settings" - }, - "Mpeg2Settings": { - "shape": "Mpeg2Settings", - "locationName": "mpeg2Settings" - }, - "ProresSettings": { - "shape": "ProresSettings", - "locationName": "proresSettings" - } - }, - "documentation": "Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettings", - "required": [ - "Codec" - ] - }, - "VideoDescription": { - "type": "structure", - "members": { - "AfdSignaling": { - "shape": "AfdSignaling", - "locationName": "afdSignaling" - }, - "AntiAlias": { - "shape": "AntiAlias", - "locationName": "antiAlias" - }, - "CodecSettings": { - "shape": "VideoCodecSettings", - "locationName": "codecSettings" - }, - "ColorMetadata": { - "shape": "ColorMetadata", - "locationName": "colorMetadata" - }, - "Crop": { - "shape": "Rectangle", - "locationName": "crop", - "documentation": "Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. Do not use this setting if you have enabled Stretch to output (stretchToOutput) in your output settings." - }, - "DropFrameTimecode": { - "shape": "DropFrameTimecode", - "locationName": "dropFrameTimecode" - }, - "FixedAfd": { - "shape": "__integerMin0Max15", - "locationName": "fixedAfd", - "documentation": "Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output." - }, - "Height": { - "shape": "__integerMin32Max2160", - "locationName": "height", - "documentation": "Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height." - }, - "Position": { - "shape": "Rectangle", - "locationName": "position", - "documentation": "Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio." - }, - "RespondToAfd": { - "shape": "RespondToAfd", - "locationName": "respondToAfd" - }, - "ScalingBehavior": { - "shape": "ScalingBehavior", - "locationName": "scalingBehavior" - }, - "Sharpness": { - "shape": "__integerMin0Max100", - "locationName": "sharpness", - "documentation": "Use Sharpness (Sharpness)setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution, and if you set Anti-alias (AntiAlias) to ENABLED. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content." - }, - "TimecodeInsertion": { - "shape": "VideoTimecodeInsertion", - "locationName": "timecodeInsertion" - }, - "VideoPreprocessors": { - "shape": "VideoPreprocessor", - "locationName": "videoPreprocessors", - "documentation": "Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default." - }, - "Width": { - "shape": "__integerMin32Max4096", - "locationName": "width", - "documentation": "Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width." - } - }, - "documentation": "Settings for video outputs", - "required": [ - "CodecSettings" - ] - }, - "VideoDetail": { - "type": "structure", - "members": { - "HeightInPx": { - "shape": "__integer", - "locationName": "heightInPx", - "documentation": "Height in pixels for the output" - }, - "WidthInPx": { - "shape": "__integer", - "locationName": "widthInPx", - "documentation": "Width in pixels for the output" - } - }, - "documentation": "Contains details about the output's video stream" - }, - "VideoPreprocessor": { - "type": "structure", - "members": { - "ColorCorrector": { - "shape": "ColorCorrector", - "locationName": "colorCorrector", - "documentation": "Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default." - }, - "Deinterlacer": { - "shape": "Deinterlacer", - "locationName": "deinterlacer", - "documentation": "Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture." - }, - "ImageInserter": { - "shape": "ImageInserter", - "locationName": "imageInserter", - "documentation": "Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default." - }, - "NoiseReducer": { - "shape": "NoiseReducer", - "locationName": "noiseReducer", - "documentation": "Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default." - }, - "TimecodeBurnin": { - "shape": "TimecodeBurnin", - "locationName": "timecodeBurnin", - "documentation": "Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output." - } - }, - "documentation": "Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default." - }, - "VideoSelector": { - "type": "structure", - "members": { - "ColorSpace": { - "shape": "ColorSpace", - "locationName": "colorSpace" - }, - "ColorSpaceUsage": { - "shape": "ColorSpaceUsage", - "locationName": "colorSpaceUsage" - }, - "Hdr10Metadata": { - "shape": "Hdr10Metadata", - "locationName": "hdr10Metadata" - }, - "Pid": { - "shape": "__integerMin1Max2147483647", - "locationName": "pid", - "documentation": "Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container." - }, - "ProgramNumber": { - "shape": "__integerMinNegative2147483648Max2147483647", - "locationName": "programNumber", - "documentation": "Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported." - } - }, - "documentation": "Selector for video." - }, - "VideoTimecodeInsertion": { - "type": "string", - "documentation": "Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input framerate is identical to the output framerate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does.", - "enum": [ - "DISABLED", - "PIC_TIMING_SEI" - ] - }, - "WavFormat": { - "type": "string", - "documentation": "The service defaults to using RIFF for WAV outputs. If your output audio is likely to exceed 4 GB in file size, or if you otherwise need the extended support of the RF64 format, set your output WAV file format to RF64.", - "enum": [ - "RIFF", - "RF64" - ] - }, - "WavSettings": { - "type": "structure", - "members": { - "BitDepth": { - "shape": "__integerMin16Max24", - "locationName": "bitDepth", - "documentation": "Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track." - }, - "Channels": { - "shape": "__integerMin1Max8", - "locationName": "channels", - "documentation": "Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively." - }, - "Format": { - "shape": "WavFormat", - "locationName": "format" - }, - "SampleRate": { - "shape": "__integerMin8000Max192000", - "locationName": "sampleRate", - "documentation": "Sample rate in Hz." - } - }, - "documentation": "Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV." - }, - "__boolean": { - "type": "boolean" - }, - "__double": { - "type": "double" - }, - "__doubleMin0": { - "type": "double" - }, - "__doubleMin0Max2147483647": { - "type": "double" - }, - "__doubleMinNegative59Max0": { - "type": "double" - }, - "__doubleMinNegative60Max3": { - "type": "double" - }, - "__doubleMinNegative60MaxNegative1": { - "type": "double" - }, - "__integer": { - "type": "integer" - }, - "__integerMin0Max10": { - "type": "integer", - "min": 0, - "max": 10 - }, - "__integerMin0Max100": { - "type": "integer", - "min": 0, - "max": 100 - }, - "__integerMin0Max1000": { - "type": "integer", - "min": 0, - "max": 1000 - }, - "__integerMin0Max10000": { - "type": "integer", - "min": 0, - "max": 10000 - }, - "__integerMin0Max1152000000": { - "type": "integer", - "min": 0, - "max": 1152000000 - }, - "__integerMin0Max128": { - "type": "integer", - "min": 0, - "max": 128 - }, - "__integerMin0Max1466400000": { - "type": "integer", - "min": 0, - "max": 1466400000 - }, - "__integerMin0Max15": { - "type": "integer", - "min": 0, - "max": 15 - }, - "__integerMin0Max16": { - "type": "integer", - "min": 0, - "max": 16 - }, - "__integerMin0Max2147483647": { - "type": "integer", - "min": 0, - "max": 2147483647 - }, - "__integerMin0Max255": { - "type": "integer", - "min": 0, - "max": 255 - }, - "__integerMin0Max3": { - "type": "integer", - "min": 0, - "max": 3 - }, - "__integerMin0Max30": { - "type": "integer", - "min": 0, - "max": 30 - }, - "__integerMin0Max3600": { - "type": "integer", - "min": 0, - "max": 3600 - }, - "__integerMin0Max47185920": { - "type": "integer", - "min": 0, - "max": 47185920 - }, - "__integerMin0Max500": { - "type": "integer", - "min": 0, - "max": 500 - }, - "__integerMin0Max50000": { - "type": "integer", - "min": 0, - "max": 50000 - }, - "__integerMin0Max65535": { - "type": "integer", - "min": 0, - "max": 65535 - }, - "__integerMin0Max7": { - "type": "integer", - "min": 0, - "max": 7 - }, - "__integerMin0Max8": { - "type": "integer", - "min": 0, - "max": 8 - }, - "__integerMin0Max9": { - "type": "integer", - "min": 0, - "max": 9 - }, - "__integerMin0Max96": { - "type": "integer", - "min": 0, - "max": 96 - }, - "__integerMin0Max99": { - "type": "integer", - "min": 0, - "max": 99 - }, - "__integerMin1000Max1152000000": { - "type": "integer", - "min": 1000, - "max": 1152000000 - }, - "__integerMin1000Max1466400000": { - "type": "integer", - "min": 1000, - "max": 1466400000 - }, - "__integerMin1000Max288000000": { - "type": "integer", - "min": 1000, - "max": 288000000 - }, - "__integerMin1000Max30000": { - "type": "integer", - "min": 1000, - "max": 30000 - }, - "__integerMin1000Max300000000": { - "type": "integer", - "min": 1000, - "max": 300000000 - }, - "__integerMin10Max48": { - "type": "integer", - "min": 10, - "max": 48 - }, - "__integerMin16Max24": { - "type": "integer", - "min": 16, - "max": 24 - }, - "__integerMin1Max1": { - "type": "integer", - "min": 1, - "max": 1 - }, - "__integerMin1Max10": { - "type": "integer", - "min": 1, - "max": 10 - }, - "__integerMin1Max100": { - "type": "integer", - "min": 1, - "max": 100 - }, - "__integerMin1Max10000000": { - "type": "integer", - "min": 1, - "max": 10000000 - }, - "__integerMin1Max1001": { - "type": "integer", - "min": 1, - "max": 1001 - }, - "__integerMin1Max16": { - "type": "integer", - "min": 1, - "max": 16 - }, - "__integerMin1Max2": { - "type": "integer", - "min": 1, - "max": 2 - }, - "__integerMin1Max20": { - "type": "integer", - "min": 1, - "max": 20 - }, - "__integerMin1Max2147483647": { - "type": "integer", - "min": 1, - "max": 2147483647 - }, - "__integerMin1Max31": { - "type": "integer", - "min": 1, - "max": 31 - }, - "__integerMin1Max32": { - "type": "integer", - "min": 1, - "max": 32 - }, - "__integerMin1Max4": { - "type": "integer", - "min": 1, - "max": 4 - }, - "__integerMin1Max6": { - "type": "integer", - "min": 1, - "max": 6 - }, - "__integerMin1Max8": { - "type": "integer", - "min": 1, - "max": 8 - }, - "__integerMin24Max60000": { - "type": "integer", - "min": 24, - "max": 60000 - }, - "__integerMin25Max10000": { - "type": "integer", - "min": 25, - "max": 10000 - }, - "__integerMin25Max2000": { - "type": "integer", - "min": 25, - "max": 2000 - }, - "__integerMin2Max2147483647": { - "type": "integer", - "min": 2, - "max": 2147483647 - }, - "__integerMin32000Max384000": { - "type": "integer", - "min": 32000, - "max": 384000 - }, - "__integerMin32000Max48000": { - "type": "integer", - "min": 32000, - "max": 48000 - }, - "__integerMin32Max2160": { - "type": "integer", - "min": 32, - "max": 2160 - }, - "__integerMin32Max4096": { - "type": "integer", - "min": 32, - "max": 4096 - }, - "__integerMin32Max8182": { - "type": "integer", - "min": 32, - "max": 8182 - }, - "__integerMin48000Max48000": { - "type": "integer", - "min": 48000, - "max": 48000 - }, - "__integerMin6000Max1024000": { - "type": "integer", - "min": 6000, - "max": 1024000 - }, - "__integerMin64000Max640000": { - "type": "integer", - "min": 64000, - "max": 640000 - }, - "__integerMin8000Max192000": { - "type": "integer", - "min": 8000, - "max": 192000 - }, - "__integerMin8000Max96000": { - "type": "integer", - "min": 8000, - "max": 96000 - }, - "__integerMin96Max600": { - "type": "integer", - "min": 96, - "max": 600 - }, - "__integerMinNegative1000Max1000": { - "type": "integer", - "min": -1000, - "max": 1000 - }, - "__integerMinNegative180Max180": { - "type": "integer", - "min": -180, - "max": 180 - }, - "__integerMinNegative2147483648Max2147483647": { - "type": "integer", - "min": -2147483648, - "max": 2147483647 - }, - "__integerMinNegative2Max3": { - "type": "integer", - "min": -2, - "max": 3 - }, - "__integerMinNegative5Max5": { - "type": "integer", - "min": -5, - "max": 5 - }, - "__integerMinNegative60Max6": { - "type": "integer", - "min": -60, - "max": 6 - }, - "__integerMinNegative70Max0": { - "type": "integer", - "min": -70, - "max": 0 - }, - "__listOfAudioDescription": { - "type": "list", - "member": { - "shape": "AudioDescription" - } - }, - "__listOfCaptionDescription": { - "type": "list", - "member": { - "shape": "CaptionDescription" - } - }, - "__listOfCaptionDescriptionPreset": { - "type": "list", - "member": { - "shape": "CaptionDescriptionPreset" - } - }, - "__listOfEndpoint": { - "type": "list", - "member": { - "shape": "Endpoint" - } - }, - "__listOfHlsAdMarkers": { - "type": "list", - "member": { - "shape": "HlsAdMarkers" - } - }, - "__listOfHlsCaptionLanguageMapping": { - "type": "list", - "member": { - "shape": "HlsCaptionLanguageMapping" - } - }, - "__listOfId3Insertion": { - "type": "list", - "member": { - "shape": "Id3Insertion" - } - }, - "__listOfInput": { - "type": "list", - "member": { - "shape": "Input" - } - }, - "__listOfInputClipping": { - "type": "list", - "member": { - "shape": "InputClipping" - } - }, - "__listOfInputTemplate": { - "type": "list", - "member": { - "shape": "InputTemplate" - } - }, - "__listOfInsertableImage": { - "type": "list", - "member": { - "shape": "InsertableImage" - } - }, - "__listOfJob": { - "type": "list", - "member": { - "shape": "Job" - } - }, - "__listOfJobTemplate": { - "type": "list", - "member": { - "shape": "JobTemplate" - } - }, - "__listOfOutput": { - "type": "list", - "member": { - "shape": "Output" - } - }, - "__listOfOutputChannelMapping": { - "type": "list", - "member": { - "shape": "OutputChannelMapping" - } - }, - "__listOfOutputDetail": { - "type": "list", - "member": { - "shape": "OutputDetail" - } - }, - "__listOfOutputGroup": { - "type": "list", - "member": { - "shape": "OutputGroup" - } - }, - "__listOfOutputGroupDetail": { - "type": "list", - "member": { - "shape": "OutputGroupDetail" - } - }, - "__listOfPreset": { - "type": "list", - "member": { - "shape": "Preset" - } - }, - "__listOfQueue": { - "type": "list", - "member": { - "shape": "Queue" - } - }, - "__listOf__integerMin1Max2147483647": { - "type": "list", - "member": { - "shape": "__integerMin1Max2147483647" - } - }, - "__listOf__integerMin32Max8182": { - "type": "list", - "member": { - "shape": "__integerMin32Max8182" - } - }, - "__listOf__integerMinNegative60Max6": { - "type": "list", - "member": { - "shape": "__integerMinNegative60Max6" - } - }, - "__listOf__string": { - "type": "list", - "member": { - "shape": "__string" - } - }, - "__listOf__stringMin1": { - "type": "list", - "member": { - "shape": "__stringMin1" - } - }, - "__listOf__stringPattern09aFAF809aFAF409aFAF409aFAF409aFAF12": { - "type": "list", - "member": { - "shape": "__stringPattern09aFAF809aFAF409aFAF409aFAF409aFAF12" - } - }, - "__long": { - "type": "long" - }, - "__mapOfAudioSelector": { - "type": "map", - "key": { - "shape": "__string" - }, - "value": { - "shape": "AudioSelector" - } - }, - "__mapOfAudioSelectorGroup": { - "type": "map", - "key": { - "shape": "__string" - }, - "value": { - "shape": "AudioSelectorGroup" - } - }, - "__mapOfCaptionSelector": { - "type": "map", - "key": { - "shape": "__string" - }, - "value": { - "shape": "CaptionSelector" - } - }, - "__mapOf__string": { - "type": "map", - "key": { - "shape": "__string" - }, - "value": { - "shape": "__string" - } - }, - "__string": { - "type": "string" - }, - "__stringMin0": { - "type": "string", - "min": 0 - }, - "__stringMin1": { - "type": "string", - "min": 1 - }, - "__stringMin14PatternS3BmpBMPPngPNG": { - "type": "string", - "min": 14, - "pattern": "^(s3:\\/\\/)(.*?)\\.(bmp|BMP|png|PNG)$" - }, - "__stringMin14PatternS3BmpBMPPngPNGTgaTGA": { - "type": "string", - "min": 14, - "pattern": "^(s3:\\/\\/)(.*?)\\.(bmp|BMP|png|PNG|tga|TGA)$" - }, - "__stringMin14PatternS3SccSCCTtmlTTMLDfxpDFXPStlSTLSrtSRTSmiSMI": { - "type": "string", - "min": 14, - "pattern": "^(s3:\\/\\/)(.*?)\\.(scc|SCC|ttml|TTML|dfxp|DFXP|stl|STL|srt|SRT|smi|SMI)$" - }, - "__stringMin1Max256": { - "type": "string", - "min": 1, - "max": 256 - }, - "__stringMin32Max32Pattern09aFAF32": { - "type": "string", - "min": 32, - "max": 32, - "pattern": "^[0-9a-fA-F]{32}$" - }, - "__stringMin3Max3Pattern1809aFAF09aEAE": { - "type": "string", - "min": 3, - "max": 3, - "pattern": "^[1-8][0-9a-fA-F][0-9a-eA-E]$" - }, - "__stringMin3Max3PatternAZaZ3": { - "type": "string", - "min": 3, - "max": 3, - "pattern": "^[A-Za-z]{3}$" - }, - "__stringPattern": { - "type": "string", - "pattern": "^[ -~]+$" - }, - "__stringPattern010920405090509092": { - "type": "string", - "pattern": "^([01][0-9]|2[0-4]):[0-5][0-9]:[0-5][0-9][:;][0-9]{2}$" - }, - "__stringPattern01D20305D205D": { - "type": "string", - "pattern": "^((([0-1]\\d)|(2[0-3]))(:[0-5]\\d){2}([:;][0-5]\\d))$" - }, - "__stringPattern0940191020191209301": { - "type": "string", - "pattern": "^([0-9]{4})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$" - }, - "__stringPattern09aFAF809aFAF409aFAF409aFAF409aFAF12": { - "type": "string", - "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" - }, - "__stringPatternAZaZ0902": { - "type": "string", - "pattern": "^[A-Za-z0-9+\\/]+={0,2}$" - }, - "__stringPatternAZaZ0932": { - "type": "string", - "pattern": "^[A-Za-z0-9]{32}$" - }, - "__stringPatternDD": { - "type": "string", - "pattern": "^(\\d+(\\/\\d+)*)$" - }, - "__stringPatternHttps": { - "type": "string", - "pattern": "^https:\\/\\/" - }, - "__stringPatternIdentityAZaZ26AZaZ09163": { - "type": "string", - "pattern": "^(identity|[A-Za-z]{2,6}(\\.[A-Za-z0-9-]{1,63})+)$" - }, - "__stringPatternS3": { - "type": "string", - "pattern": "^s3:\\/\\/" - }, - "__stringPatternS3MM2VVMMPPEEGGAAVVIIMMPP4FFLLVVMMPPTTMMPPGGMM4VVTTRRPPFF4VVMM2TTSSTTSS264HH264MMKKVVMMOOVVMMTTSSMM2TTWWMMVVAASSFFVVOOBB3GGPP3GGPPPPMMXXFFDDIIVVXXXXVVIIDDRRAAWWDDVVGGXXFFMM1VV3GG2VVMMFFMM3UU8LLCCHHGGXXFFMMPPEEGG2MMXXFFMMPPEEGG2MMXXFFHHDDWWAAVVYY4MM": { - "type": "string", - "pattern": "^(s3:\\/\\/)([^\\/]+\\/)+([^\\/\\.]+|(([^\\/]*)\\.([mM]2[vV]|[mM][pP][eE][gG]|[aA][vV][iI]|[mM][pP]4|[fF][lL][vV]|[mM][pP][tT]|[mM][pP][gG]|[mM]4[vV]|[tT][rR][pP]|[fF]4[vV]|[mM]2[tT][sS]|[tT][sS]|264|[hH]264|[mM][kK][vV]|[mM][oO][vV]|[mM][tT][sS]|[mM]2[tT]|[wW][mM][vV]|[aA][sS][fF]|[vV][oO][bB]|3[gG][pP]|3[gG][pP][pP]|[mM][xX][fF]|[dD][iI][vV][xX]|[xX][vV][iI][dD]|[rR][aA][wW]|[dD][vV]|[gG][xX][fF]|[mM]1[vV]|3[gG]2|[vV][mM][fF]|[mM]3[uU]8|[lL][cC][hH]|[gG][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF][hH][dD]|[wW][aA][vV]|[yY]4[mM])))$" - }, - "__stringPatternS3MM2VVMMPPEEGGAAVVIIMMPP4FFLLVVMMPPTTMMPPGGMM4VVTTRRPPFF4VVMM2TTSSTTSS264HH264MMKKVVMMOOVVMMTTSSMM2TTWWMMVVAASSFFVVOOBB3GGPP3GGPPPPMMXXFFDDIIVVXXXXVVIIDDRRAAWWDDVVGGXXFFMM1VV3GG2VVMMFFMM3UU8LLCCHHGGXXFFMMPPEEGG2MMXXFFMMPPEEGG2MMXXFFHHDDWWAAVVYY4MMAAAACCAAIIFFFFMMPP2AACC3EECC3DDTTSSEE": { - "type": "string", - "pattern": "^(s3:\\/\\/)([^\\/]+\\/)+([^\\/\\.]+|(([^\\/]*)\\.([mM]2[vV]|[mM][pP][eE][gG]|[aA][vV][iI]|[mM][pP]4|[fF][lL][vV]|[mM][pP][tT]|[mM][pP][gG]|[mM]4[vV]|[tT][rR][pP]|[fF]4[vV]|[mM]2[tT][sS]|[tT][sS]|264|[hH]264|[mM][kK][vV]|[mM][oO][vV]|[mM][tT][sS]|[mM]2[tT]|[wW][mM][vV]|[aA][sS][fF]|[vV][oO][bB]|3[gG][pP]|3[gG][pP][pP]|[mM][xX][fF]|[dD][iI][vV][xX]|[xX][vV][iI][dD]|[rR][aA][wW]|[dD][vV]|[gG][xX][fF]|[mM]1[vV]|3[gG]2|[vV][mM][fF]|[mM]3[uU]8|[lL][cC][hH]|[gG][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF][hH][dD]|[wW][aA][vV]|[yY]4[mM]|[aA][aA][cC]|[aA][iI][fF][fF]|[mM][pP]2|[aA][cC]3|[eE][cC]3|[dD][tT][sS][eE])))$" - }, - "__stringPatternWS": { - "type": "string", - "pattern": "^[\\w\\s]*$" - }, - "__timestampIso8601": { - "type": "timestamp", - "timestampFormat": "iso8601" - }, - "__timestampUnix": { - "type": "timestamp", - "timestampFormat": "unixTimestamp" - } - }, - "documentation": "AWS Elemental MediaConvert" -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/paginators-1.json deleted file mode 100644 index c9bc58df..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/paginators-1.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "pagination": { - "ListInputs": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Inputs" - }, - "ListChannels": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Channels" - }, - "ListInputSecurityGroups": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InputSecurityGroups" - }, - "ListOfferings": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Offerings" - }, - "ListReservations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Reservations" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/service-2.json deleted file mode 100644 index a7a31279..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/medialive/2017-10-14/service-2.json +++ /dev/null @@ -1,8365 +0,0 @@ -{ - "metadata": { - "apiVersion": "2017-10-14", - "endpointPrefix": "medialive", - "signingName": "medialive", - "serviceFullName": "AWS Elemental MediaLive", - "serviceId": "MediaLive", - "protocol": "rest-json", - "jsonVersion": "1.1", - "uid": "medialive-2017-10-14", - "signatureVersion": "v4", - "serviceAbbreviation": "MediaLive" - }, - "operations": { - "CreateChannel": { - "name": "CreateChannel", - "http": { - "method": "POST", - "requestUri": "/prod/channels", - "responseCode": 201 - }, - "input": { - "shape": "CreateChannelRequest" - }, - "output": { - "shape": "CreateChannelResponse", - "documentation": "Creation of channel is started." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid." - }, - { - "shape": "UnprocessableEntityException", - "documentation": "The Channel failed validation and could not be created." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to create the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on create channel calls to channel service." - }, - { - "shape": "ConflictException", - "documentation": "The channel is unable to create due to an issue with channel resources." - } - ], - "documentation": "Creates a new channel" - }, - "CreateInput": { - "name": "CreateInput", - "http": { - "method": "POST", - "requestUri": "/prod/inputs", - "responseCode": 201 - }, - "input": { - "shape": "CreateInputRequest" - }, - "output": { - "shape": "CreateInputResponse", - "documentation": "Successfully created the input." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Service Error" - }, - { - "shape": "ForbiddenException", - "documentation": "Access was denied" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit exceeded" - } - ], - "documentation": "Create an input" - }, - "CreateInputSecurityGroup": { - "name": "CreateInputSecurityGroup", - "http": { - "method": "POST", - "requestUri": "/prod/inputSecurityGroups", - "responseCode": 200 - }, - "input": { - "shape": "CreateInputSecurityGroupRequest" - }, - "output": { - "shape": "CreateInputSecurityGroupResponse", - "documentation": "Successfully created the Input Security Group." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The request to create an Input Security Group was Invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Server Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to create an Input Security Group" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit Exceeded Error" - } - ], - "documentation": "Creates a Input Security Group" - }, - "DeleteChannel": { - "name": "DeleteChannel", - "http": { - "method": "DELETE", - "requestUri": "/prod/channels/{channelId}", - "responseCode": 200 - }, - "input": { - "shape": "DeleteChannelRequest" - }, - "output": { - "shape": "DeleteChannelResponse", - "documentation": "Deletion was successfully initiated." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to delete the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The channel you're requesting to delete does not exist." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on delete channel calls to channel service." - }, - { - "shape": "ConflictException", - "documentation": "The channel is unable to delete due to an issue with channel resources." - } - ], - "documentation": "Starts deletion of channel. The associated outputs are also deleted." - }, - "DeleteInput": { - "name": "DeleteInput", - "http": { - "method": "DELETE", - "requestUri": "/prod/inputs/{inputId}", - "responseCode": 200 - }, - "input": { - "shape": "DeleteInputRequest" - }, - "output": { - "shape": "DeleteInputResponse", - "documentation": "Successful deletion" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Service Error" - }, - { - "shape": "ForbiddenException", - "documentation": "Access was denied" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "Input not found" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit exceeded" - }, - { - "shape": "ConflictException", - "documentation": "Resource conflict" - } - ], - "documentation": "Deletes the input end point" - }, - "DeleteInputSecurityGroup": { - "name": "DeleteInputSecurityGroup", - "http": { - "method": "DELETE", - "requestUri": "/prod/inputSecurityGroups/{inputSecurityGroupId}", - "responseCode": 200 - }, - "input": { - "shape": "DeleteInputSecurityGroupRequest" - }, - "output": { - "shape": "DeleteInputSecurityGroupResponse", - "documentation": "An Input Security Group" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The request to delete the Input Security Group was Invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Server Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to delete this Input Security Group" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "Input Security Group not found" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit Exceeded Error" - } - ], - "documentation": "Deletes an Input Security Group" - }, - "DeleteReservation": { - "name": "DeleteReservation", - "http": { - "method": "DELETE", - "requestUri": "/prod/reservations/{reservationId}", - "responseCode": 200 - }, - "input": { - "shape": "DeleteReservationRequest" - }, - "output": { - "shape": "DeleteReservationResponse", - "documentation": "Deleted reservation" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to delete reservation" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "NotFoundException", - "documentation": "Reservation you're attempting to delete does not exist" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on delete reservation request" - }, - { - "shape": "ConflictException", - "documentation": "The reservation could not be deleted because it is currently active." - } - ], - "documentation": "Delete an expired reservation." - }, - "DescribeChannel": { - "name": "DescribeChannel", - "http": { - "method": "GET", - "requestUri": "/prod/channels/{channelId}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeChannelRequest" - }, - "output": { - "shape": "DescribeChannelResponse", - "documentation": "Channel details" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to describe the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The channel you're requesting to describe does not exist." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on describe channel calls to channel service." - } - ], - "documentation": "Gets details about a channel" - }, - "DescribeInput": { - "name": "DescribeInput", - "http": { - "method": "GET", - "requestUri": "/prod/inputs/{inputId}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeInputRequest" - }, - "output": { - "shape": "DescribeInputResponse", - "documentation": "Input details" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Service Error" - }, - { - "shape": "ForbiddenException", - "documentation": "Access was denied" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "Input not found" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit exceeded" - } - ], - "documentation": "Produces details about an input" - }, - "DescribeInputSecurityGroup": { - "name": "DescribeInputSecurityGroup", - "http": { - "method": "GET", - "requestUri": "/prod/inputSecurityGroups/{inputSecurityGroupId}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeInputSecurityGroupRequest" - }, - "output": { - "shape": "DescribeInputSecurityGroupResponse", - "documentation": "An Input Security Group" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The request to describe an Input Security Group was Invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Server Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to describe this Input Security Group" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "Input Security Group not found" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit Exceeded Error" - } - ], - "documentation": "Produces a summary of an Input Security Group" - }, - "DescribeOffering": { - "name": "DescribeOffering", - "http": { - "method": "GET", - "requestUri": "/prod/offerings/{offeringId}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeOfferingRequest" - }, - "output": { - "shape": "DescribeOfferingResponse", - "documentation": "Offering details" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to describe offering" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "NotFoundException", - "documentation": "Offering you're attempting to describe does not exist" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on describe offering request" - } - ], - "documentation": "Get details for an offering." - }, - "DescribeReservation": { - "name": "DescribeReservation", - "http": { - "method": "GET", - "requestUri": "/prod/reservations/{reservationId}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeReservationRequest" - }, - "output": { - "shape": "DescribeReservationResponse", - "documentation": "Reservation details" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to describe reservation" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "NotFoundException", - "documentation": "Reservation you're attempting to describe does not exist" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on describe reservation request" - } - ], - "documentation": "Get details for a reservation." - }, - "ListChannels": { - "name": "ListChannels", - "http": { - "method": "GET", - "requestUri": "/prod/channels", - "responseCode": 200 - }, - "input": { - "shape": "ListChannelsRequest" - }, - "output": { - "shape": "ListChannelsResponse", - "documentation": "An array of channels" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to list channels." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on list channel calls to channel service." - } - ], - "documentation": "Produces list of channels that have been created" - }, - "ListInputSecurityGroups": { - "name": "ListInputSecurityGroups", - "http": { - "method": "GET", - "requestUri": "/prod/inputSecurityGroups", - "responseCode": 200 - }, - "input": { - "shape": "ListInputSecurityGroupsRequest" - }, - "output": { - "shape": "ListInputSecurityGroupsResponse", - "documentation": "An array of Input Security Groups" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The request to list Input Security Groups was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Server Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to call ListInputSecurityGroups" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit Exceeded Error" - } - ], - "documentation": "Produces a list of Input Security Groups for an account" - }, - "ListInputs": { - "name": "ListInputs", - "http": { - "method": "GET", - "requestUri": "/prod/inputs", - "responseCode": 200 - }, - "input": { - "shape": "ListInputsRequest" - }, - "output": { - "shape": "ListInputsResponse", - "documentation": "An array of inputs" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Service Error" - }, - { - "shape": "ForbiddenException", - "documentation": "Access was denied" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Limit exceeded" - } - ], - "documentation": "Produces list of inputs that have been created" - }, - "ListOfferings": { - "name": "ListOfferings", - "http": { - "method": "GET", - "requestUri": "/prod/offerings", - "responseCode": 200 - }, - "input": { - "shape": "ListOfferingsRequest" - }, - "output": { - "shape": "ListOfferingsResponse", - "documentation": "List of offerings" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to list offerings" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on list offerings request" - } - ], - "documentation": "List offerings available for purchase." - }, - "ListReservations": { - "name": "ListReservations", - "http": { - "method": "GET", - "requestUri": "/prod/reservations", - "responseCode": 200 - }, - "input": { - "shape": "ListReservationsRequest" - }, - "output": { - "shape": "ListReservationsResponse", - "documentation": "List of reservations" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to list reservations" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on list reservations request" - } - ], - "documentation": "List purchased reservations." - }, - "PurchaseOffering": { - "name": "PurchaseOffering", - "http": { - "method": "POST", - "requestUri": "/prod/offerings/{offeringId}/purchase", - "responseCode": 201 - }, - "input": { - "shape": "PurchaseOfferingRequest" - }, - "output": { - "shape": "PurchaseOfferingResponse", - "documentation": "Purchased reservation" - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal service error" - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to purchase the offering" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad gateway error" - }, - { - "shape": "NotFoundException", - "documentation": "Offering you're attempting to purchase does not exist" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway timeout error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on purchase offering request" - }, - { - "shape": "ConflictException", - "documentation": "Offering purchase prevented by service resource issue" - } - ], - "documentation": "Purchase an offering and create a reservation." - }, - "StartChannel": { - "name": "StartChannel", - "http": { - "method": "POST", - "requestUri": "/prod/channels/{channelId}/start", - "responseCode": 200 - }, - "input": { - "shape": "StartChannelRequest" - }, - "output": { - "shape": "StartChannelResponse", - "documentation": "Successfully initiated start of the channel." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to start the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The channel you're requesting to start does not exist." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on start channel calls to channel service." - }, - { - "shape": "ConflictException", - "documentation": "The channel is unable to start due to an issue with channel resources." - } - ], - "documentation": "Starts an existing channel" - }, - "StopChannel": { - "name": "StopChannel", - "http": { - "method": "POST", - "requestUri": "/prod/channels/{channelId}/stop", - "responseCode": 200 - }, - "input": { - "shape": "StopChannelRequest" - }, - "output": { - "shape": "StopChannelResponse", - "documentation": "Successfully initiated stop of the channel." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to stop the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The channel you're requesting to stop does not exist." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "TooManyRequestsException", - "documentation": "Request limit exceeded on stop channel calls to channel service." - }, - { - "shape": "ConflictException", - "documentation": "The channel is unable to stop due to an issue with channel resources." - } - ], - "documentation": "Stops a running channel" - }, - "UpdateChannel": { - "name": "UpdateChannel", - "http": { - "method": "PUT", - "requestUri": "/prod/channels/{channelId}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateChannelRequest" - }, - "output": { - "shape": "UpdateChannelResponse", - "documentation": "Channel is successfully updated." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request was invalid." - }, - { - "shape": "UnprocessableEntityException", - "documentation": "The channel configuration failed validation and could not be updated." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Unexpected internal service error." - }, - { - "shape": "ForbiddenException", - "documentation": "You do not have permission to update the channel." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "ConflictException", - "documentation": "The channel is unable to update due to an issue with channel resources." - } - ], - "documentation": "Updates a channel." - }, - "UpdateInput": { - "name": "UpdateInput", - "http": { - "method": "PUT", - "requestUri": "/prod/inputs/{inputId}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateInputRequest" - }, - "output": { - "shape": "UpdateInputResponse", - "documentation": "The input update is successfully initiated." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "This request to update the input was invalid." - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Service Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to update an input." - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The input was not found." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "ConflictException", - "documentation": "The input was unable to be updated at this time due to an issue with input resources." - } - ], - "documentation": "Updates an input." - }, - "UpdateInputSecurityGroup": { - "name": "UpdateInputSecurityGroup", - "http": { - "method": "PUT", - "requestUri": "/prod/inputSecurityGroups/{inputSecurityGroupId}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateInputSecurityGroupRequest" - }, - "output": { - "shape": "UpdateInputSecurityGroupResponse", - "documentation": "Successfully initiated the update of the Input Security Group." - }, - "errors": [ - { - "shape": "BadRequestException", - "documentation": "The request to update the Input Security Group was invalid" - }, - { - "shape": "InternalServerErrorException", - "documentation": "Internal Server Error" - }, - { - "shape": "ForbiddenException", - "documentation": "The requester does not have permission to update an Input Security Group" - }, - { - "shape": "BadGatewayException", - "documentation": "Bad Gateway Error" - }, - { - "shape": "NotFoundException", - "documentation": "The Input Security Group was not found." - }, - { - "shape": "GatewayTimeoutException", - "documentation": "Gateway Timeout Error" - }, - { - "shape": "ConflictException", - "documentation": "The Input Security Group was unable to be updated due to an issue with input security group resources." - } - ], - "documentation": "Update an Input Security Group's Whilelists." - } - }, - "shapes": { - "AacCodingMode": { - "type": "string", - "enum": [ - "AD_RECEIVER_MIX", - "CODING_MODE_1_0", - "CODING_MODE_1_1", - "CODING_MODE_2_0", - "CODING_MODE_5_1" - ], - "documentation": "Placeholder documentation for AacCodingMode" - }, - "AacInputType": { - "type": "string", - "enum": [ - "BROADCASTER_MIXED_AD", - "NORMAL" - ], - "documentation": "Placeholder documentation for AacInputType" - }, - "AacProfile": { - "type": "string", - "enum": [ - "HEV1", - "HEV2", - "LC" - ], - "documentation": "Placeholder documentation for AacProfile" - }, - "AacRateControlMode": { - "type": "string", - "enum": [ - "CBR", - "VBR" - ], - "documentation": "Placeholder documentation for AacRateControlMode" - }, - "AacRawFormat": { - "type": "string", - "enum": [ - "LATM_LOAS", - "NONE" - ], - "documentation": "Placeholder documentation for AacRawFormat" - }, - "AacSettings": { - "type": "structure", - "members": { - "Bitrate": { - "shape": "__double", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid values depend on rate control mode and profile." - }, - "CodingMode": { - "shape": "AacCodingMode", - "locationName": "codingMode", - "documentation": "Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. The adReceiverMix setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E." - }, - "InputType": { - "shape": "AacInputType", - "locationName": "inputType", - "documentation": "Set to \"broadcasterMixedAd\" when input contains pre-mixed main audio + AD (narration) as a stereo pair. The Audio Type field (audioType) will be set to 3, which signals to downstream systems that this stream contains \"broadcaster mixed AD\". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. The values in audioTypeControl and audioType (in AudioDescription) are ignored when set to broadcasterMixedAd.\n\nLeave set to \"normal\" when input does not contain pre-mixed audio + AD." - }, - "Profile": { - "shape": "AacProfile", - "locationName": "profile", - "documentation": "AAC Profile." - }, - "RateControlMode": { - "shape": "AacRateControlMode", - "locationName": "rateControlMode", - "documentation": "Rate Control Mode." - }, - "RawFormat": { - "shape": "AacRawFormat", - "locationName": "rawFormat", - "documentation": "Sets LATM / LOAS AAC output for raw containers." - }, - "SampleRate": { - "shape": "__double", - "locationName": "sampleRate", - "documentation": "Sample rate in Hz. Valid values depend on rate control mode and profile." - }, - "Spec": { - "shape": "AacSpec", - "locationName": "spec", - "documentation": "Use MPEG-2 AAC audio instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers." - }, - "VbrQuality": { - "shape": "AacVbrQuality", - "locationName": "vbrQuality", - "documentation": "VBR Quality Level - Only used if rateControlMode is VBR." - } - }, - "documentation": "Placeholder documentation for AacSettings" - }, - "AacSpec": { - "type": "string", - "enum": [ - "MPEG2", - "MPEG4" - ], - "documentation": "Placeholder documentation for AacSpec" - }, - "AacVbrQuality": { - "type": "string", - "enum": [ - "HIGH", - "LOW", - "MEDIUM_HIGH", - "MEDIUM_LOW" - ], - "documentation": "Placeholder documentation for AacVbrQuality" - }, - "Ac3BitstreamMode": { - "type": "string", - "enum": [ - "COMMENTARY", - "COMPLETE_MAIN", - "DIALOGUE", - "EMERGENCY", - "HEARING_IMPAIRED", - "MUSIC_AND_EFFECTS", - "VISUALLY_IMPAIRED", - "VOICE_OVER" - ], - "documentation": "Placeholder documentation for Ac3BitstreamMode" - }, - "Ac3CodingMode": { - "type": "string", - "enum": [ - "CODING_MODE_1_0", - "CODING_MODE_1_1", - "CODING_MODE_2_0", - "CODING_MODE_3_2_LFE" - ], - "documentation": "Placeholder documentation for Ac3CodingMode" - }, - "Ac3DrcProfile": { - "type": "string", - "enum": [ - "FILM_STANDARD", - "NONE" - ], - "documentation": "Placeholder documentation for Ac3DrcProfile" - }, - "Ac3LfeFilter": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for Ac3LfeFilter" - }, - "Ac3MetadataControl": { - "type": "string", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for Ac3MetadataControl" - }, - "Ac3Settings": { - "type": "structure", - "members": { - "Bitrate": { - "shape": "__double", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode." - }, - "BitstreamMode": { - "shape": "Ac3BitstreamMode", - "locationName": "bitstreamMode", - "documentation": "Specifies the bitstream mode (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values." - }, - "CodingMode": { - "shape": "Ac3CodingMode", - "locationName": "codingMode", - "documentation": "Dolby Digital coding mode. Determines number of channels." - }, - "Dialnorm": { - "shape": "__integerMin1Max31", - "locationName": "dialnorm", - "documentation": "Sets the dialnorm for the output. If excluded and input audio is Dolby Digital, dialnorm will be passed through." - }, - "DrcProfile": { - "shape": "Ac3DrcProfile", - "locationName": "drcProfile", - "documentation": "If set to filmStandard, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification." - }, - "LfeFilter": { - "shape": "Ac3LfeFilter", - "locationName": "lfeFilter", - "documentation": "When set to enabled, applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid in codingMode32Lfe mode." - }, - "MetadataControl": { - "shape": "Ac3MetadataControl", - "locationName": "metadataControl", - "documentation": "When set to \"followInput\", encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used." - } - }, - "documentation": "Placeholder documentation for Ac3Settings" - }, - "AccessDenied": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for AccessDenied" - }, - "AfdSignaling": { - "type": "string", - "enum": [ - "AUTO", - "FIXED", - "NONE" - ], - "documentation": "Placeholder documentation for AfdSignaling" - }, - "ArchiveContainerSettings": { - "type": "structure", - "members": { - "M2tsSettings": { - "shape": "M2tsSettings", - "locationName": "m2tsSettings" - } - }, - "documentation": "Placeholder documentation for ArchiveContainerSettings" - }, - "ArchiveGroupSettings": { - "type": "structure", - "members": { - "Destination": { - "shape": "OutputLocationRef", - "locationName": "destination", - "documentation": "A directory and base filename where archive files should be written. If the base filename portion of the URI is left blank, the base filename of the first input will be automatically inserted." - }, - "RolloverInterval": { - "shape": "__integerMin1", - "locationName": "rolloverInterval", - "documentation": "Number of seconds to write to archive file before closing and starting a new one." - } - }, - "required": [ - "Destination" - ], - "documentation": "Placeholder documentation for ArchiveGroupSettings" - }, - "ArchiveOutputSettings": { - "type": "structure", - "members": { - "ContainerSettings": { - "shape": "ArchiveContainerSettings", - "locationName": "containerSettings", - "documentation": "Settings specific to the container type of the file." - }, - "Extension": { - "shape": "__string", - "locationName": "extension", - "documentation": "Output file extension. If excluded, this will be auto-selected from the container type." - }, - "NameModifier": { - "shape": "__string", - "locationName": "nameModifier", - "documentation": "String concatenated to the end of the destination filename. Required for multiple outputs of the same type." - } - }, - "required": [ - "ContainerSettings" - ], - "documentation": "Placeholder documentation for ArchiveOutputSettings" - }, - "AribDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for AribDestinationSettings" - }, - "AribSourceSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for AribSourceSettings" - }, - "AudioChannelMapping": { - "type": "structure", - "members": { - "InputChannelLevels": { - "shape": "__listOfInputChannelLevel", - "locationName": "inputChannelLevels", - "documentation": "Indices and gain values for each input channel that should be remixed into this output channel." - }, - "OutputChannel": { - "shape": "__integerMin0Max7", - "locationName": "outputChannel", - "documentation": "The index of the output channel being produced." - } - }, - "required": [ - "OutputChannel", - "InputChannelLevels" - ], - "documentation": "Placeholder documentation for AudioChannelMapping" - }, - "AudioCodecSettings": { - "type": "structure", - "members": { - "AacSettings": { - "shape": "AacSettings", - "locationName": "aacSettings" - }, - "Ac3Settings": { - "shape": "Ac3Settings", - "locationName": "ac3Settings" - }, - "Eac3Settings": { - "shape": "Eac3Settings", - "locationName": "eac3Settings" - }, - "Mp2Settings": { - "shape": "Mp2Settings", - "locationName": "mp2Settings" - }, - "PassThroughSettings": { - "shape": "PassThroughSettings", - "locationName": "passThroughSettings" - } - }, - "documentation": "Placeholder documentation for AudioCodecSettings" - }, - "AudioDescription": { - "type": "structure", - "members": { - "AudioNormalizationSettings": { - "shape": "AudioNormalizationSettings", - "locationName": "audioNormalizationSettings", - "documentation": "Advanced audio normalization settings." - }, - "AudioSelectorName": { - "shape": "__string", - "locationName": "audioSelectorName", - "documentation": "The name of the AudioSelector used as the source for this AudioDescription." - }, - "AudioType": { - "shape": "AudioType", - "locationName": "audioType", - "documentation": "Applies only if audioTypeControl is useConfigured. The values for audioType are defined in ISO-IEC 13818-1." - }, - "AudioTypeControl": { - "shape": "AudioDescriptionAudioTypeControl", - "locationName": "audioTypeControl", - "documentation": "Determines how audio type is determined.\n followInput: If the input contains an ISO 639 audioType, then that value is passed through to the output. If the input contains no ISO 639 audioType, the value in Audio Type is included in the output.\n useConfigured: The value in Audio Type is included in the output.\nNote that this field and audioType are both ignored if inputType is broadcasterMixedAd." - }, - "CodecSettings": { - "shape": "AudioCodecSettings", - "locationName": "codecSettings", - "documentation": "Audio codec settings." - }, - "LanguageCode": { - "shape": "__stringMin3Max3", - "locationName": "languageCode", - "documentation": "Indicates the language of the audio output track. Only used if languageControlMode is useConfigured, or there is no ISO 639 language code specified in the input." - }, - "LanguageCodeControl": { - "shape": "AudioDescriptionLanguageCodeControl", - "locationName": "languageCodeControl", - "documentation": "Choosing followInput will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The languageCode will be used when useConfigured is set, or when followInput is selected but there is no ISO 639 language code specified by the input." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of this AudioDescription. Outputs will use this name to uniquely identify this AudioDescription. Description names should be unique within this Live Event." - }, - "RemixSettings": { - "shape": "RemixSettings", - "locationName": "remixSettings", - "documentation": "Settings that control how input audio channels are remixed into the output audio channels." - }, - "StreamName": { - "shape": "__string", - "locationName": "streamName", - "documentation": "Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary)." - } - }, - "required": [ - "AudioSelectorName", - "Name" - ], - "documentation": "Placeholder documentation for AudioDescription" - }, - "AudioDescriptionAudioTypeControl": { - "type": "string", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for AudioDescriptionAudioTypeControl" - }, - "AudioDescriptionLanguageCodeControl": { - "type": "string", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for AudioDescriptionLanguageCodeControl" - }, - "AudioLanguageSelection": { - "type": "structure", - "members": { - "LanguageCode": { - "shape": "__string", - "locationName": "languageCode", - "documentation": "Selects a specific three-letter language code from within an audio source." - }, - "LanguageSelectionPolicy": { - "shape": "AudioLanguageSelectionPolicy", - "locationName": "languageSelectionPolicy", - "documentation": "When set to \"strict\", the transport stream demux strictly identifies audio streams by their language descriptor. If a PMT update occurs such that an audio stream matching the initially selected language is no longer present then mute will be encoded until the language returns. If \"loose\", then on a PMT update the demux will choose another audio stream in the program with the same stream type if it can't find one with the same language." - } - }, - "required": [ - "LanguageCode" - ], - "documentation": "Placeholder documentation for AudioLanguageSelection" - }, - "AudioLanguageSelectionPolicy": { - "type": "string", - "enum": [ - "LOOSE", - "STRICT" - ], - "documentation": "Placeholder documentation for AudioLanguageSelectionPolicy" - }, - "AudioNormalizationAlgorithm": { - "type": "string", - "enum": [ - "ITU_1770_1", - "ITU_1770_2" - ], - "documentation": "Placeholder documentation for AudioNormalizationAlgorithm" - }, - "AudioNormalizationAlgorithmControl": { - "type": "string", - "enum": [ - "CORRECT_AUDIO" - ], - "documentation": "Placeholder documentation for AudioNormalizationAlgorithmControl" - }, - "AudioNormalizationSettings": { - "type": "structure", - "members": { - "Algorithm": { - "shape": "AudioNormalizationAlgorithm", - "locationName": "algorithm", - "documentation": "Audio normalization algorithm to use. itu17701 conforms to the CALM Act specification, itu17702 conforms to the EBU R-128 specification." - }, - "AlgorithmControl": { - "shape": "AudioNormalizationAlgorithmControl", - "locationName": "algorithmControl", - "documentation": "When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted." - }, - "TargetLkfs": { - "shape": "__doubleMinNegative59Max0", - "locationName": "targetLkfs", - "documentation": "Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS." - } - }, - "documentation": "Placeholder documentation for AudioNormalizationSettings" - }, - "AudioOnlyHlsSettings": { - "type": "structure", - "members": { - "AudioGroupId": { - "shape": "__string", - "locationName": "audioGroupId", - "documentation": "Specifies the group to which the audio Rendition belongs." - }, - "AudioOnlyImage": { - "shape": "InputLocation", - "locationName": "audioOnlyImage", - "documentation": "For use with an audio only Stream. Must be a .jpg or .png file. If given, this image will be used as the cover-art for the audio only output. Ideally, it should be formatted for an iPhone screen for two reasons. The iPhone does not resize the image, it crops a centered image on the top/bottom and left/right. Additionally, this image file gets saved bit-for-bit into every 10-second segment file, so will increase bandwidth by {image file size} * {segment count} * {user count.}." - }, - "AudioTrackType": { - "shape": "AudioOnlyHlsTrackType", - "locationName": "audioTrackType", - "documentation": "Four types of audio-only tracks are supported:\n\nAudio-Only Variant Stream\nThe client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest.\n\nAlternate Audio, Auto Select, Default\nAlternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES\n\nAlternate Audio, Auto Select, Not Default\nAlternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES\n\nAlternate Audio, not Auto Select\nAlternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO" - } - }, - "documentation": "Placeholder documentation for AudioOnlyHlsSettings" - }, - "AudioOnlyHlsTrackType": { - "type": "string", - "enum": [ - "ALTERNATE_AUDIO_AUTO_SELECT", - "ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT", - "ALTERNATE_AUDIO_NOT_AUTO_SELECT", - "AUDIO_ONLY_VARIANT_STREAM" - ], - "documentation": "Placeholder documentation for AudioOnlyHlsTrackType" - }, - "AudioPidSelection": { - "type": "structure", - "members": { - "Pid": { - "shape": "__integerMin0Max8191", - "locationName": "pid", - "documentation": "Selects a specific PID from within a source." - } - }, - "required": [ - "Pid" - ], - "documentation": "Placeholder documentation for AudioPidSelection" - }, - "AudioSelector": { - "type": "structure", - "members": { - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of this AudioSelector. AudioDescriptions will use this name to uniquely identify this Selector. Selector names should be unique per input." - }, - "SelectorSettings": { - "shape": "AudioSelectorSettings", - "locationName": "selectorSettings", - "documentation": "The audio selector settings." - } - }, - "required": [ - "Name" - ], - "documentation": "Placeholder documentation for AudioSelector" - }, - "AudioSelectorSettings": { - "type": "structure", - "members": { - "AudioLanguageSelection": { - "shape": "AudioLanguageSelection", - "locationName": "audioLanguageSelection" - }, - "AudioPidSelection": { - "shape": "AudioPidSelection", - "locationName": "audioPidSelection" - } - }, - "documentation": "Placeholder documentation for AudioSelectorSettings" - }, - "AudioType": { - "type": "string", - "enum": [ - "CLEAN_EFFECTS", - "HEARING_IMPAIRED", - "UNDEFINED", - "VISUAL_IMPAIRED_COMMENTARY" - ], - "documentation": "Placeholder documentation for AudioType" - }, - "AuthenticationScheme": { - "type": "string", - "enum": [ - "AKAMAI", - "COMMON" - ], - "documentation": "Placeholder documentation for AuthenticationScheme" - }, - "AvailBlanking": { - "type": "structure", - "members": { - "AvailBlankingImage": { - "shape": "InputLocation", - "locationName": "availBlankingImage", - "documentation": "Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported." - }, - "State": { - "shape": "AvailBlankingState", - "locationName": "state", - "documentation": "When set to enabled, causes video, audio and captions to be blanked when insertion metadata is added." - } - }, - "documentation": "Placeholder documentation for AvailBlanking" - }, - "AvailBlankingState": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for AvailBlankingState" - }, - "AvailConfiguration": { - "type": "structure", - "members": { - "AvailSettings": { - "shape": "AvailSettings", - "locationName": "availSettings", - "documentation": "Ad avail settings." - } - }, - "documentation": "Placeholder documentation for AvailConfiguration" - }, - "AvailSettings": { - "type": "structure", - "members": { - "Scte35SpliceInsert": { - "shape": "Scte35SpliceInsert", - "locationName": "scte35SpliceInsert" - }, - "Scte35TimeSignalApos": { - "shape": "Scte35TimeSignalApos", - "locationName": "scte35TimeSignalApos" - } - }, - "documentation": "Placeholder documentation for AvailSettings" - }, - "BadGatewayException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 502 - }, - "documentation": "Placeholder documentation for BadGatewayException" - }, - "BadRequestException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 400 - }, - "documentation": "Placeholder documentation for BadRequestException" - }, - "BlackoutSlate": { - "type": "structure", - "members": { - "BlackoutSlateImage": { - "shape": "InputLocation", - "locationName": "blackoutSlateImage", - "documentation": "Blackout slate image to be used. Leave empty for solid black. Only bmp and png images are supported." - }, - "NetworkEndBlackout": { - "shape": "BlackoutSlateNetworkEndBlackout", - "locationName": "networkEndBlackout", - "documentation": "Setting to enabled causes the encoder to blackout the video, audio, and captions, and raise the \"Network Blackout Image\" slate when an SCTE104/35 Network End Segmentation Descriptor is encountered. The blackout will be lifted when the Network Start Segmentation Descriptor is encountered. The Network End and Network Start descriptors must contain a network ID that matches the value entered in \"Network ID\"." - }, - "NetworkEndBlackoutImage": { - "shape": "InputLocation", - "locationName": "networkEndBlackoutImage", - "documentation": "Path to local file to use as Network End Blackout image. Image will be scaled to fill the entire output raster." - }, - "NetworkId": { - "shape": "__stringMin34Max34", - "locationName": "networkId", - "documentation": "Provides Network ID that matches EIDR ID format (e.g., \"10.XXXX/XXXX-XXXX-XXXX-XXXX-XXXX-C\")." - }, - "State": { - "shape": "BlackoutSlateState", - "locationName": "state", - "documentation": "When set to enabled, causes video, audio and captions to be blanked when indicated by program metadata." - } - }, - "documentation": "Placeholder documentation for BlackoutSlate" - }, - "BlackoutSlateNetworkEndBlackout": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for BlackoutSlateNetworkEndBlackout" - }, - "BlackoutSlateState": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for BlackoutSlateState" - }, - "BurnInAlignment": { - "type": "string", - "enum": [ - "CENTERED", - "LEFT", - "SMART" - ], - "documentation": "Placeholder documentation for BurnInAlignment" - }, - "BurnInBackgroundColor": { - "type": "string", - "enum": [ - "BLACK", - "NONE", - "WHITE" - ], - "documentation": "Placeholder documentation for BurnInBackgroundColor" - }, - "BurnInDestinationSettings": { - "type": "structure", - "members": { - "Alignment": { - "shape": "BurnInAlignment", - "locationName": "alignment", - "documentation": "If no explicit xPosition or yPosition is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. Selecting \"smart\" justification will left-justify live subtitles and center-justify pre-recorded subtitles. All burn-in and DVB-Sub font settings must match." - }, - "BackgroundColor": { - "shape": "BurnInBackgroundColor", - "locationName": "backgroundColor", - "documentation": "Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match." - }, - "BackgroundOpacity": { - "shape": "__integerMin0Max255", - "locationName": "backgroundOpacity", - "documentation": "Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter out is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "Font": { - "shape": "InputLocation", - "locationName": "font", - "documentation": "External font file used for caption burn-in. File extension must be 'ttf' or 'tte'. Although the user can select output fonts for many different types of input captions, embedded, STL and teletext sources use a strict grid system. Using external fonts with these caption sources could cause unexpected display of proportional fonts. All burn-in and DVB-Sub font settings must match." - }, - "FontColor": { - "shape": "BurnInFontColor", - "locationName": "fontColor", - "documentation": "Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "FontOpacity": { - "shape": "__integerMin0Max255", - "locationName": "fontOpacity", - "documentation": "Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match." - }, - "FontResolution": { - "shape": "__integerMin96Max600", - "locationName": "fontResolution", - "documentation": "Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match." - }, - "FontSize": { - "shape": "__string", - "locationName": "fontSize", - "documentation": "When set to 'auto' fontSize will scale depending on the size of the output. Giving a positive integer will specify the exact font size in points. All burn-in and DVB-Sub font settings must match." - }, - "OutlineColor": { - "shape": "BurnInOutlineColor", - "locationName": "outlineColor", - "documentation": "Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "OutlineSize": { - "shape": "__integerMin0Max10", - "locationName": "outlineSize", - "documentation": "Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "ShadowColor": { - "shape": "BurnInShadowColor", - "locationName": "shadowColor", - "documentation": "Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match." - }, - "ShadowOpacity": { - "shape": "__integerMin0Max255", - "locationName": "shadowOpacity", - "documentation": "Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter out is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "ShadowXOffset": { - "shape": "__integer", - "locationName": "shadowXOffset", - "documentation": "Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match." - }, - "ShadowYOffset": { - "shape": "__integer", - "locationName": "shadowYOffset", - "documentation": "Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match." - }, - "TeletextGridControl": { - "shape": "BurnInTeletextGridControl", - "locationName": "teletextGridControl", - "documentation": "Controls whether a fixed grid size will be used to generate the output subtitles bitmap. Only applicable for Teletext inputs and DVB-Sub/Burn-in outputs." - }, - "XPosition": { - "shape": "__integerMin0", - "locationName": "xPosition", - "documentation": "Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit xPosition is provided, the horizontal caption position will be determined by the alignment parameter. All burn-in and DVB-Sub font settings must match." - }, - "YPosition": { - "shape": "__integerMin0", - "locationName": "yPosition", - "documentation": "Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit yPosition is provided, the caption will be positioned towards the bottom of the output. All burn-in and DVB-Sub font settings must match." - } - }, - "documentation": "Placeholder documentation for BurnInDestinationSettings" - }, - "BurnInFontColor": { - "type": "string", - "enum": [ - "BLACK", - "BLUE", - "GREEN", - "RED", - "WHITE", - "YELLOW" - ], - "documentation": "Placeholder documentation for BurnInFontColor" - }, - "BurnInOutlineColor": { - "type": "string", - "enum": [ - "BLACK", - "BLUE", - "GREEN", - "RED", - "WHITE", - "YELLOW" - ], - "documentation": "Placeholder documentation for BurnInOutlineColor" - }, - "BurnInShadowColor": { - "type": "string", - "enum": [ - "BLACK", - "NONE", - "WHITE" - ], - "documentation": "Placeholder documentation for BurnInShadowColor" - }, - "BurnInTeletextGridControl": { - "type": "string", - "enum": [ - "FIXED", - "SCALED" - ], - "documentation": "Placeholder documentation for BurnInTeletextGridControl" - }, - "CaptionDescription": { - "type": "structure", - "members": { - "CaptionSelectorName": { - "shape": "__string", - "locationName": "captionSelectorName", - "documentation": "Specifies which input caption selector to use as a caption source when generating output captions. This field should match a captionSelector name." - }, - "DestinationSettings": { - "shape": "CaptionDestinationSettings", - "locationName": "destinationSettings", - "documentation": "Additional settings for captions destination that depend on the destination type." - }, - "LanguageCode": { - "shape": "__string", - "locationName": "languageCode", - "documentation": "ISO 639-2 three-digit code: http://www.loc.gov/standards/iso639-2/" - }, - "LanguageDescription": { - "shape": "__string", - "locationName": "languageDescription", - "documentation": "Human readable information to indicate captions available for players (eg. English, or Spanish)." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the caption description. Used to associate a caption description with an output. Names must be unique within an event." - } - }, - "documentation": "Output groups for this Live Event. Output groups contain information about where streams should be distributed.", - "required": [ - "CaptionSelectorName", - "Name" - ] - }, - "CaptionDestinationSettings": { - "type": "structure", - "members": { - "AribDestinationSettings": { - "shape": "AribDestinationSettings", - "locationName": "aribDestinationSettings" - }, - "BurnInDestinationSettings": { - "shape": "BurnInDestinationSettings", - "locationName": "burnInDestinationSettings" - }, - "DvbSubDestinationSettings": { - "shape": "DvbSubDestinationSettings", - "locationName": "dvbSubDestinationSettings" - }, - "EmbeddedDestinationSettings": { - "shape": "EmbeddedDestinationSettings", - "locationName": "embeddedDestinationSettings" - }, - "EmbeddedPlusScte20DestinationSettings": { - "shape": "EmbeddedPlusScte20DestinationSettings", - "locationName": "embeddedPlusScte20DestinationSettings" - }, - "RtmpCaptionInfoDestinationSettings": { - "shape": "RtmpCaptionInfoDestinationSettings", - "locationName": "rtmpCaptionInfoDestinationSettings" - }, - "Scte20PlusEmbeddedDestinationSettings": { - "shape": "Scte20PlusEmbeddedDestinationSettings", - "locationName": "scte20PlusEmbeddedDestinationSettings" - }, - "Scte27DestinationSettings": { - "shape": "Scte27DestinationSettings", - "locationName": "scte27DestinationSettings" - }, - "SmpteTtDestinationSettings": { - "shape": "SmpteTtDestinationSettings", - "locationName": "smpteTtDestinationSettings" - }, - "TeletextDestinationSettings": { - "shape": "TeletextDestinationSettings", - "locationName": "teletextDestinationSettings" - }, - "TtmlDestinationSettings": { - "shape": "TtmlDestinationSettings", - "locationName": "ttmlDestinationSettings" - }, - "WebvttDestinationSettings": { - "shape": "WebvttDestinationSettings", - "locationName": "webvttDestinationSettings" - } - }, - "documentation": "Placeholder documentation for CaptionDestinationSettings" - }, - "CaptionLanguageMapping": { - "type": "structure", - "members": { - "CaptionChannel": { - "shape": "__integerMin1Max4", - "locationName": "captionChannel", - "documentation": "The closed caption channel being described by this CaptionLanguageMapping. Each channel mapping must have a unique channel number (maximum of 4)" - }, - "LanguageCode": { - "shape": "__stringMin3Max3", - "locationName": "languageCode", - "documentation": "Three character ISO 639-2 language code (see http://www.loc.gov/standards/iso639-2)" - }, - "LanguageDescription": { - "shape": "__stringMin1", - "locationName": "languageDescription", - "documentation": "Textual description of language" - } - }, - "documentation": "Maps a caption channel to an ISO 693-2 language code (http://www.loc.gov/standards/iso639-2), with an optional description.", - "required": [ - "LanguageCode", - "LanguageDescription", - "CaptionChannel" - ] - }, - "CaptionSelector": { - "type": "structure", - "members": { - "LanguageCode": { - "shape": "__string", - "locationName": "languageCode", - "documentation": "When specified this field indicates the three letter language code of the caption track to extract from the source." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name identifier for a caption selector. This name is used to associate this caption selector with one or more caption descriptions. Names must be unique within an event." - }, - "SelectorSettings": { - "shape": "CaptionSelectorSettings", - "locationName": "selectorSettings", - "documentation": "Caption selector settings." - } - }, - "documentation": "Output groups for this Live Event. Output groups contain information about where streams should be distributed.", - "required": [ - "Name" - ] - }, - "CaptionSelectorSettings": { - "type": "structure", - "members": { - "AribSourceSettings": { - "shape": "AribSourceSettings", - "locationName": "aribSourceSettings" - }, - "DvbSubSourceSettings": { - "shape": "DvbSubSourceSettings", - "locationName": "dvbSubSourceSettings" - }, - "EmbeddedSourceSettings": { - "shape": "EmbeddedSourceSettings", - "locationName": "embeddedSourceSettings" - }, - "Scte20SourceSettings": { - "shape": "Scte20SourceSettings", - "locationName": "scte20SourceSettings" - }, - "Scte27SourceSettings": { - "shape": "Scte27SourceSettings", - "locationName": "scte27SourceSettings" - }, - "TeletextSourceSettings": { - "shape": "TeletextSourceSettings", - "locationName": "teletextSourceSettings" - } - }, - "documentation": "Placeholder documentation for CaptionSelectorSettings" - }, - "Channel": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for Channel" - }, - "ChannelConfigurationValidationError": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - }, - "ValidationErrors": { - "shape": "__listOfValidationError", - "locationName": "validationErrors", - "documentation": "A collection of validation error responses from attempting to create a channel with a bouquet of settings." - } - }, - "documentation": "Placeholder documentation for ChannelConfigurationValidationError" - }, - "ChannelEgressEndpoint": { - "type": "structure", - "members": { - "SourceIp": { - "shape": "__string", - "locationName": "sourceIp", - "documentation": "Public IP of where a channel's output comes from" - } - }, - "documentation": "Placeholder documentation for ChannelEgressEndpoint" - }, - "ChannelState": { - "type": "string", - "enum": [ - "CREATING", - "CREATE_FAILED", - "IDLE", - "STARTING", - "RUNNING", - "RECOVERING", - "STOPPING", - "DELETING", - "DELETED" - ], - "documentation": "Placeholder documentation for ChannelState" - }, - "ChannelSummary": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for ChannelSummary" - }, - "ConflictException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 409 - }, - "documentation": "Placeholder documentation for ConflictException" - }, - "CreateChannel": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification", - "documentation": "Specification of input for this channel (max. bitrate, resolution, codec, etc.)" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level to write to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of channel." - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique request ID to be specified. This is needed to prevent retries from\ncreating multiple resources.\n", - "idempotencyToken": true - }, - "Reserved": { - "shape": "__string", - "locationName": "reserved", - "documentation": "Deprecated field that's only usable by whitelisted customers.", - "deprecated": true - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "An optional Amazon Resource Name (ARN) of the role to assume when running the Channel." - } - }, - "documentation": "Placeholder documentation for CreateChannel" - }, - "CreateChannelRequest": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification", - "documentation": "Specification of input for this channel (max. bitrate, resolution, codec, etc.)" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level to write to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of channel." - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique request ID to be specified. This is needed to prevent retries from\ncreating multiple resources.\n", - "idempotencyToken": true - }, - "Reserved": { - "shape": "__string", - "locationName": "reserved", - "documentation": "Deprecated field that's only usable by whitelisted customers.", - "deprecated": true - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "An optional Amazon Resource Name (ARN) of the role to assume when running the Channel." - } - }, - "documentation": "A request to create a channel" - }, - "CreateChannelResponse": { - "type": "structure", - "members": { - "Channel": { - "shape": "Channel", - "locationName": "channel" - } - }, - "documentation": "Placeholder documentation for CreateChannelResponse" - }, - "CreateChannelResultModel": { - "type": "structure", - "members": { - "Channel": { - "shape": "Channel", - "locationName": "channel" - } - }, - "documentation": "Placeholder documentation for CreateChannelResultModel" - }, - "CreateInput": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfInputDestinationRequest", - "locationName": "destinations", - "documentation": "Destination settings for PUSH type inputs." - }, - "InputSecurityGroups": { - "shape": "__listOf__string", - "locationName": "inputSecurityGroups", - "documentation": "A list of security groups referenced by IDs to attach to the input." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the input." - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique identifier of the request to ensure the request is handled\nexactly once in case of retries.\n", - "idempotencyToken": true - }, - "Sources": { - "shape": "__listOfInputSourceRequest", - "locationName": "sources", - "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty.\n" - }, - "Type": { - "shape": "InputType", - "locationName": "type" - } - }, - "documentation": "Placeholder documentation for CreateInput" - }, - "CreateInputRequest": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfInputDestinationRequest", - "locationName": "destinations", - "documentation": "Destination settings for PUSH type inputs." - }, - "InputSecurityGroups": { - "shape": "__listOf__string", - "locationName": "inputSecurityGroups", - "documentation": "A list of security groups referenced by IDs to attach to the input." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the input." - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique identifier of the request to ensure the request is handled\nexactly once in case of retries.\n", - "idempotencyToken": true - }, - "Sources": { - "shape": "__listOfInputSourceRequest", - "locationName": "sources", - "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty.\n" - }, - "Type": { - "shape": "InputType", - "locationName": "type" - } - }, - "documentation": "The name of the input" - }, - "CreateInputResponse": { - "type": "structure", - "members": { - "Input": { - "shape": "Input", - "locationName": "input" - } - }, - "documentation": "Placeholder documentation for CreateInputResponse" - }, - "CreateInputResultModel": { - "type": "structure", - "members": { - "Input": { - "shape": "Input", - "locationName": "input" - } - }, - "documentation": "Placeholder documentation for CreateInputResultModel" - }, - "CreateInputSecurityGroupRequest": { - "type": "structure", - "members": { - "WhitelistRules": { - "shape": "__listOfInputWhitelistRuleCidr", - "locationName": "whitelistRules", - "documentation": "List of IPv4 CIDR addresses to whitelist" - } - }, - "documentation": "The IPv4 CIDRs to whitelist for this Input Security Group" - }, - "CreateInputSecurityGroupResponse": { - "type": "structure", - "members": { - "SecurityGroup": { - "shape": "InputSecurityGroup", - "locationName": "securityGroup" - } - }, - "documentation": "Placeholder documentation for CreateInputSecurityGroupResponse" - }, - "CreateInputSecurityGroupResultModel": { - "type": "structure", - "members": { - "SecurityGroup": { - "shape": "InputSecurityGroup", - "locationName": "securityGroup" - } - }, - "documentation": "Placeholder documentation for CreateInputSecurityGroupResultModel" - }, - "DeleteChannelRequest": { - "type": "structure", - "members": { - "ChannelId": { - "shape": "__string", - "location": "uri", - "locationName": "channelId", - "documentation": "Unique ID of the channel." - } - }, - "required": [ - "ChannelId" - ], - "documentation": "Placeholder documentation for DeleteChannelRequest" - }, - "DeleteChannelResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for DeleteChannelResponse" - }, - "DeleteInputRequest": { - "type": "structure", - "members": { - "InputId": { - "shape": "__string", - "location": "uri", - "locationName": "inputId", - "documentation": "Unique ID of the input" - } - }, - "required": [ - "InputId" - ], - "documentation": "Placeholder documentation for DeleteInputRequest" - }, - "DeleteInputResponse": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for DeleteInputResponse" - }, - "DeleteInputSecurityGroupRequest": { - "type": "structure", - "members": { - "InputSecurityGroupId": { - "shape": "__string", - "location": "uri", - "locationName": "inputSecurityGroupId", - "documentation": "The Input Security Group to delete" - } - }, - "required": [ - "InputSecurityGroupId" - ], - "documentation": "Placeholder documentation for DeleteInputSecurityGroupRequest" - }, - "DeleteInputSecurityGroupResponse": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for DeleteInputSecurityGroupResponse" - }, - "DeleteReservationRequest": { - "type": "structure", - "members": { - "ReservationId": { - "shape": "__string", - "location": "uri", - "locationName": "reservationId", - "documentation": "Unique reservation ID, e.g. '1234567'" - } - }, - "required": [ - "ReservationId" - ], - "documentation": "Placeholder documentation for DeleteReservationRequest" - }, - "DeleteReservationResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique reservation ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:reservation:1234567'" - }, - "Count": { - "shape": "__integer", - "locationName": "count", - "documentation": "Number of reserved resources" - }, - "CurrencyCode": { - "shape": "__string", - "locationName": "currencyCode", - "documentation": "Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'" - }, - "Duration": { - "shape": "__integer", - "locationName": "duration", - "documentation": "Lease duration, e.g. '12'" - }, - "DurationUnits": { - "shape": "OfferingDurationUnits", - "locationName": "durationUnits", - "documentation": "Units for duration, e.g. 'MONTHS'" - }, - "End": { - "shape": "__string", - "locationName": "end", - "documentation": "Reservation UTC end date and time in ISO-8601 format, e.g. '2019-03-01T00:00:00'" - }, - "FixedPrice": { - "shape": "__double", - "locationName": "fixedPrice", - "documentation": "One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering" - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "User specified reservation name" - }, - "OfferingDescription": { - "shape": "__string", - "locationName": "offeringDescription", - "documentation": "Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'" - }, - "OfferingId": { - "shape": "__string", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - }, - "OfferingType": { - "shape": "OfferingType", - "locationName": "offeringType", - "documentation": "Offering type, e.g. 'NO_UPFRONT'" - }, - "Region": { - "shape": "__string", - "locationName": "region", - "documentation": "AWS region, e.g. 'us-west-2'" - }, - "ReservationId": { - "shape": "__string", - "locationName": "reservationId", - "documentation": "Unique reservation ID, e.g. '1234567'" - }, - "ResourceSpecification": { - "shape": "ReservationResourceSpecification", - "locationName": "resourceSpecification", - "documentation": "Resource configuration details" - }, - "Start": { - "shape": "__string", - "locationName": "start", - "documentation": "Reservation UTC start date and time in ISO-8601 format, e.g. '2018-03-01T00:00:00'" - }, - "State": { - "shape": "ReservationState", - "locationName": "state", - "documentation": "Current state of reservation, e.g. 'ACTIVE'" - }, - "UsagePrice": { - "shape": "__double", - "locationName": "usagePrice", - "documentation": "Recurring usage charge for each reserved resource, e.g. '157.0'" - } - }, - "documentation": "Placeholder documentation for DeleteReservationResponse" - }, - "DescribeChannelRequest": { - "type": "structure", - "members": { - "ChannelId": { - "shape": "__string", - "location": "uri", - "locationName": "channelId", - "documentation": "channel ID" - } - }, - "required": [ - "ChannelId" - ], - "documentation": "Placeholder documentation for DescribeChannelRequest" - }, - "DescribeChannelResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for DescribeChannelResponse" - }, - "DescribeInputRequest": { - "type": "structure", - "members": { - "InputId": { - "shape": "__string", - "location": "uri", - "locationName": "inputId", - "documentation": "Unique ID of the input" - } - }, - "required": [ - "InputId" - ], - "documentation": "Placeholder documentation for DescribeInputRequest" - }, - "DescribeInputResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Unique ARN of the input (generated, immutable)." - }, - "AttachedChannels": { - "shape": "__listOf__string", - "locationName": "attachedChannels", - "documentation": "A list of channel IDs that that input is attached to (currently an input can only be attached to one channel)." - }, - "Destinations": { - "shape": "__listOfInputDestination", - "locationName": "destinations", - "documentation": "A list of the destinations of the input (PUSH-type)." - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The generated ID of the input (unique for user account, immutable)." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The user-assigned name (This is a mutable value)." - }, - "SecurityGroups": { - "shape": "__listOf__string", - "locationName": "securityGroups", - "documentation": "A list of IDs for all the security groups attached to the input." - }, - "Sources": { - "shape": "__listOfInputSource", - "locationName": "sources", - "documentation": "A list of the sources of the input (PULL-type)." - }, - "State": { - "shape": "InputState", - "locationName": "state" - }, - "Type": { - "shape": "InputType", - "locationName": "type" - } - }, - "documentation": "Placeholder documentation for DescribeInputResponse" - }, - "DescribeInputSecurityGroupRequest": { - "type": "structure", - "members": { - "InputSecurityGroupId": { - "shape": "__string", - "location": "uri", - "locationName": "inputSecurityGroupId", - "documentation": "The id of the Input Security Group to describe" - } - }, - "required": [ - "InputSecurityGroupId" - ], - "documentation": "Placeholder documentation for DescribeInputSecurityGroupRequest" - }, - "DescribeInputSecurityGroupResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique ARN of Input Security Group" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The Id of the Input Security Group" - }, - "Inputs": { - "shape": "__listOf__string", - "locationName": "inputs", - "documentation": "The list of inputs currently using this Input Security Group." - }, - "State": { - "shape": "InputSecurityGroupState", - "locationName": "state", - "documentation": "The current state of the Input Security Group." - }, - "WhitelistRules": { - "shape": "__listOfInputWhitelistRule", - "locationName": "whitelistRules", - "documentation": "Whitelist rules and their sync status" - } - }, - "documentation": "Placeholder documentation for DescribeInputSecurityGroupResponse" - }, - "DescribeOfferingRequest": { - "type": "structure", - "members": { - "OfferingId": { - "shape": "__string", - "location": "uri", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - } - }, - "required": [ - "OfferingId" - ], - "documentation": "Placeholder documentation for DescribeOfferingRequest" - }, - "DescribeOfferingResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique offering ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:offering:87654321'" - }, - "CurrencyCode": { - "shape": "__string", - "locationName": "currencyCode", - "documentation": "Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'" - }, - "Duration": { - "shape": "__integer", - "locationName": "duration", - "documentation": "Lease duration, e.g. '12'" - }, - "DurationUnits": { - "shape": "OfferingDurationUnits", - "locationName": "durationUnits", - "documentation": "Units for duration, e.g. 'MONTHS'" - }, - "FixedPrice": { - "shape": "__double", - "locationName": "fixedPrice", - "documentation": "One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering" - }, - "OfferingDescription": { - "shape": "__string", - "locationName": "offeringDescription", - "documentation": "Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'" - }, - "OfferingId": { - "shape": "__string", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - }, - "OfferingType": { - "shape": "OfferingType", - "locationName": "offeringType", - "documentation": "Offering type, e.g. 'NO_UPFRONT'" - }, - "Region": { - "shape": "__string", - "locationName": "region", - "documentation": "AWS region, e.g. 'us-west-2'" - }, - "ResourceSpecification": { - "shape": "ReservationResourceSpecification", - "locationName": "resourceSpecification", - "documentation": "Resource configuration details" - }, - "UsagePrice": { - "shape": "__double", - "locationName": "usagePrice", - "documentation": "Recurring usage charge for each reserved resource, e.g. '157.0'" - } - }, - "documentation": "Placeholder documentation for DescribeOfferingResponse" - }, - "DescribeReservationRequest": { - "type": "structure", - "members": { - "ReservationId": { - "shape": "__string", - "location": "uri", - "locationName": "reservationId", - "documentation": "Unique reservation ID, e.g. '1234567'" - } - }, - "required": [ - "ReservationId" - ], - "documentation": "Placeholder documentation for DescribeReservationRequest" - }, - "DescribeReservationResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique reservation ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:reservation:1234567'" - }, - "Count": { - "shape": "__integer", - "locationName": "count", - "documentation": "Number of reserved resources" - }, - "CurrencyCode": { - "shape": "__string", - "locationName": "currencyCode", - "documentation": "Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'" - }, - "Duration": { - "shape": "__integer", - "locationName": "duration", - "documentation": "Lease duration, e.g. '12'" - }, - "DurationUnits": { - "shape": "OfferingDurationUnits", - "locationName": "durationUnits", - "documentation": "Units for duration, e.g. 'MONTHS'" - }, - "End": { - "shape": "__string", - "locationName": "end", - "documentation": "Reservation UTC end date and time in ISO-8601 format, e.g. '2019-03-01T00:00:00'" - }, - "FixedPrice": { - "shape": "__double", - "locationName": "fixedPrice", - "documentation": "One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering" - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "User specified reservation name" - }, - "OfferingDescription": { - "shape": "__string", - "locationName": "offeringDescription", - "documentation": "Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'" - }, - "OfferingId": { - "shape": "__string", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - }, - "OfferingType": { - "shape": "OfferingType", - "locationName": "offeringType", - "documentation": "Offering type, e.g. 'NO_UPFRONT'" - }, - "Region": { - "shape": "__string", - "locationName": "region", - "documentation": "AWS region, e.g. 'us-west-2'" - }, - "ReservationId": { - "shape": "__string", - "locationName": "reservationId", - "documentation": "Unique reservation ID, e.g. '1234567'" - }, - "ResourceSpecification": { - "shape": "ReservationResourceSpecification", - "locationName": "resourceSpecification", - "documentation": "Resource configuration details" - }, - "Start": { - "shape": "__string", - "locationName": "start", - "documentation": "Reservation UTC start date and time in ISO-8601 format, e.g. '2018-03-01T00:00:00'" - }, - "State": { - "shape": "ReservationState", - "locationName": "state", - "documentation": "Current state of reservation, e.g. 'ACTIVE'" - }, - "UsagePrice": { - "shape": "__double", - "locationName": "usagePrice", - "documentation": "Recurring usage charge for each reserved resource, e.g. '157.0'" - } - }, - "documentation": "Placeholder documentation for DescribeReservationResponse" - }, - "DvbNitSettings": { - "type": "structure", - "members": { - "NetworkId": { - "shape": "__integerMin0Max65536", - "locationName": "networkId", - "documentation": "The numeric value placed in the Network Information Table (NIT)." - }, - "NetworkName": { - "shape": "__stringMin1Max256", - "locationName": "networkName", - "documentation": "The network name text placed in the networkNameDescriptor inside the Network Information Table. Maximum length is 256 characters." - }, - "RepInterval": { - "shape": "__integerMin25Max10000", - "locationName": "repInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - } - }, - "documentation": "DVB Network Information Table (NIT)", - "required": [ - "NetworkName", - "NetworkId" - ] - }, - "DvbSdtOutputSdt": { - "type": "string", - "enum": [ - "SDT_FOLLOW", - "SDT_FOLLOW_IF_PRESENT", - "SDT_MANUAL", - "SDT_NONE" - ], - "documentation": "Placeholder documentation for DvbSdtOutputSdt" - }, - "DvbSdtSettings": { - "type": "structure", - "members": { - "OutputSdt": { - "shape": "DvbSdtOutputSdt", - "locationName": "outputSdt", - "documentation": "Selects method of inserting SDT information into output stream. The sdtFollow setting copies SDT information from input stream to output stream. The sdtFollowIfPresent setting copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. The sdtManual setting means user will enter the SDT information. The sdtNone setting means output stream will not contain SDT information." - }, - "RepInterval": { - "shape": "__integerMin25Max2000", - "locationName": "repInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - }, - "ServiceName": { - "shape": "__stringMin1Max256", - "locationName": "serviceName", - "documentation": "The service name placed in the serviceDescriptor in the Service Description Table. Maximum length is 256 characters." - }, - "ServiceProviderName": { - "shape": "__stringMin1Max256", - "locationName": "serviceProviderName", - "documentation": "The service provider name placed in the serviceDescriptor in the Service Description Table. Maximum length is 256 characters." - } - }, - "documentation": "DVB Service Description Table (SDT)" - }, - "DvbSubDestinationAlignment": { - "type": "string", - "enum": [ - "CENTERED", - "LEFT", - "SMART" - ], - "documentation": "Placeholder documentation for DvbSubDestinationAlignment" - }, - "DvbSubDestinationBackgroundColor": { - "type": "string", - "enum": [ - "BLACK", - "NONE", - "WHITE" - ], - "documentation": "Placeholder documentation for DvbSubDestinationBackgroundColor" - }, - "DvbSubDestinationFontColor": { - "type": "string", - "enum": [ - "BLACK", - "BLUE", - "GREEN", - "RED", - "WHITE", - "YELLOW" - ], - "documentation": "Placeholder documentation for DvbSubDestinationFontColor" - }, - "DvbSubDestinationOutlineColor": { - "type": "string", - "enum": [ - "BLACK", - "BLUE", - "GREEN", - "RED", - "WHITE", - "YELLOW" - ], - "documentation": "Placeholder documentation for DvbSubDestinationOutlineColor" - }, - "DvbSubDestinationSettings": { - "type": "structure", - "members": { - "Alignment": { - "shape": "DvbSubDestinationAlignment", - "locationName": "alignment", - "documentation": "If no explicit xPosition or yPosition is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. Selecting \"smart\" justification will left-justify live subtitles and center-justify pre-recorded subtitles. This option is not valid for source captions that are STL or 608/embedded. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "BackgroundColor": { - "shape": "DvbSubDestinationBackgroundColor", - "locationName": "backgroundColor", - "documentation": "Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match." - }, - "BackgroundOpacity": { - "shape": "__integerMin0Max255", - "locationName": "backgroundOpacity", - "documentation": "Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "Font": { - "shape": "InputLocation", - "locationName": "font", - "documentation": "External font file used for caption burn-in. File extension must be 'ttf' or 'tte'. Although the user can select output fonts for many different types of input captions, embedded, STL and teletext sources use a strict grid system. Using external fonts with these caption sources could cause unexpected display of proportional fonts. All burn-in and DVB-Sub font settings must match." - }, - "FontColor": { - "shape": "DvbSubDestinationFontColor", - "locationName": "fontColor", - "documentation": "Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "FontOpacity": { - "shape": "__integerMin0Max255", - "locationName": "fontOpacity", - "documentation": "Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match." - }, - "FontResolution": { - "shape": "__integerMin96Max600", - "locationName": "fontResolution", - "documentation": "Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match." - }, - "FontSize": { - "shape": "__string", - "locationName": "fontSize", - "documentation": "When set to auto fontSize will scale depending on the size of the output. Giving a positive integer will specify the exact font size in points. All burn-in and DVB-Sub font settings must match." - }, - "OutlineColor": { - "shape": "DvbSubDestinationOutlineColor", - "locationName": "outlineColor", - "documentation": "Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "OutlineSize": { - "shape": "__integerMin0Max10", - "locationName": "outlineSize", - "documentation": "Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "ShadowColor": { - "shape": "DvbSubDestinationShadowColor", - "locationName": "shadowColor", - "documentation": "Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match." - }, - "ShadowOpacity": { - "shape": "__integerMin0Max255", - "locationName": "shadowOpacity", - "documentation": "Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match." - }, - "ShadowXOffset": { - "shape": "__integer", - "locationName": "shadowXOffset", - "documentation": "Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match." - }, - "ShadowYOffset": { - "shape": "__integer", - "locationName": "shadowYOffset", - "documentation": "Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match." - }, - "TeletextGridControl": { - "shape": "DvbSubDestinationTeletextGridControl", - "locationName": "teletextGridControl", - "documentation": "Controls whether a fixed grid size will be used to generate the output subtitles bitmap. Only applicable for Teletext inputs and DVB-Sub/Burn-in outputs." - }, - "XPosition": { - "shape": "__integerMin0", - "locationName": "xPosition", - "documentation": "Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit xPosition is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - }, - "YPosition": { - "shape": "__integerMin0", - "locationName": "yPosition", - "documentation": "Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit yPosition is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match." - } - }, - "documentation": "Placeholder documentation for DvbSubDestinationSettings" - }, - "DvbSubDestinationShadowColor": { - "type": "string", - "enum": [ - "BLACK", - "NONE", - "WHITE" - ], - "documentation": "Placeholder documentation for DvbSubDestinationShadowColor" - }, - "DvbSubDestinationTeletextGridControl": { - "type": "string", - "enum": [ - "FIXED", - "SCALED" - ], - "documentation": "Placeholder documentation for DvbSubDestinationTeletextGridControl" - }, - "DvbSubSourceSettings": { - "type": "structure", - "members": { - "Pid": { - "shape": "__integerMin1", - "locationName": "pid", - "documentation": "When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors." - } - }, - "documentation": "Placeholder documentation for DvbSubSourceSettings" - }, - "DvbTdtSettings": { - "type": "structure", - "members": { - "RepInterval": { - "shape": "__integerMin1000Max30000", - "locationName": "repInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream." - } - }, - "documentation": "DVB Time and Date Table (SDT)" - }, - "Eac3AttenuationControl": { - "type": "string", - "enum": [ - "ATTENUATE_3_DB", - "NONE" - ], - "documentation": "Placeholder documentation for Eac3AttenuationControl" - }, - "Eac3BitstreamMode": { - "type": "string", - "enum": [ - "COMMENTARY", - "COMPLETE_MAIN", - "EMERGENCY", - "HEARING_IMPAIRED", - "VISUALLY_IMPAIRED" - ], - "documentation": "Placeholder documentation for Eac3BitstreamMode" - }, - "Eac3CodingMode": { - "type": "string", - "enum": [ - "CODING_MODE_1_0", - "CODING_MODE_2_0", - "CODING_MODE_3_2" - ], - "documentation": "Placeholder documentation for Eac3CodingMode" - }, - "Eac3DcFilter": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for Eac3DcFilter" - }, - "Eac3DrcLine": { - "type": "string", - "enum": [ - "FILM_LIGHT", - "FILM_STANDARD", - "MUSIC_LIGHT", - "MUSIC_STANDARD", - "NONE", - "SPEECH" - ], - "documentation": "Placeholder documentation for Eac3DrcLine" - }, - "Eac3DrcRf": { - "type": "string", - "enum": [ - "FILM_LIGHT", - "FILM_STANDARD", - "MUSIC_LIGHT", - "MUSIC_STANDARD", - "NONE", - "SPEECH" - ], - "documentation": "Placeholder documentation for Eac3DrcRf" - }, - "Eac3LfeControl": { - "type": "string", - "enum": [ - "LFE", - "NO_LFE" - ], - "documentation": "Placeholder documentation for Eac3LfeControl" - }, - "Eac3LfeFilter": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for Eac3LfeFilter" - }, - "Eac3MetadataControl": { - "type": "string", - "enum": [ - "FOLLOW_INPUT", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for Eac3MetadataControl" - }, - "Eac3PassthroughControl": { - "type": "string", - "enum": [ - "NO_PASSTHROUGH", - "WHEN_POSSIBLE" - ], - "documentation": "Placeholder documentation for Eac3PassthroughControl" - }, - "Eac3PhaseControl": { - "type": "string", - "enum": [ - "NO_SHIFT", - "SHIFT_90_DEGREES" - ], - "documentation": "Placeholder documentation for Eac3PhaseControl" - }, - "Eac3Settings": { - "type": "structure", - "members": { - "AttenuationControl": { - "shape": "Eac3AttenuationControl", - "locationName": "attenuationControl", - "documentation": "When set to attenuate3Db, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode." - }, - "Bitrate": { - "shape": "__double", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Valid bitrates depend on the coding mode." - }, - "BitstreamMode": { - "shape": "Eac3BitstreamMode", - "locationName": "bitstreamMode", - "documentation": "Specifies the bitstream mode (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values." - }, - "CodingMode": { - "shape": "Eac3CodingMode", - "locationName": "codingMode", - "documentation": "Dolby Digital Plus coding mode. Determines number of channels." - }, - "DcFilter": { - "shape": "Eac3DcFilter", - "locationName": "dcFilter", - "documentation": "When set to enabled, activates a DC highpass filter for all input channels." - }, - "Dialnorm": { - "shape": "__integerMin1Max31", - "locationName": "dialnorm", - "documentation": "Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through." - }, - "DrcLine": { - "shape": "Eac3DrcLine", - "locationName": "drcLine", - "documentation": "Sets the Dolby dynamic range compression profile." - }, - "DrcRf": { - "shape": "Eac3DrcRf", - "locationName": "drcRf", - "documentation": "Sets the profile for heavy Dolby dynamic range compression, ensures that the instantaneous signal peaks do not exceed specified levels." - }, - "LfeControl": { - "shape": "Eac3LfeControl", - "locationName": "lfeControl", - "documentation": "When encoding 3/2 audio, setting to lfe enables the LFE channel" - }, - "LfeFilter": { - "shape": "Eac3LfeFilter", - "locationName": "lfeFilter", - "documentation": "When set to enabled, applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with codingMode32 coding mode." - }, - "LoRoCenterMixLevel": { - "shape": "__double", - "locationName": "loRoCenterMixLevel", - "documentation": "Left only/Right only center mix level. Only used for 3/2 coding mode." - }, - "LoRoSurroundMixLevel": { - "shape": "__double", - "locationName": "loRoSurroundMixLevel", - "documentation": "Left only/Right only surround mix level. Only used for 3/2 coding mode." - }, - "LtRtCenterMixLevel": { - "shape": "__double", - "locationName": "ltRtCenterMixLevel", - "documentation": "Left total/Right total center mix level. Only used for 3/2 coding mode." - }, - "LtRtSurroundMixLevel": { - "shape": "__double", - "locationName": "ltRtSurroundMixLevel", - "documentation": "Left total/Right total surround mix level. Only used for 3/2 coding mode." - }, - "MetadataControl": { - "shape": "Eac3MetadataControl", - "locationName": "metadataControl", - "documentation": "When set to followInput, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used." - }, - "PassthroughControl": { - "shape": "Eac3PassthroughControl", - "locationName": "passthroughControl", - "documentation": "When set to whenPossible, input DD+ audio will be passed through if it is present on the input. This detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding." - }, - "PhaseControl": { - "shape": "Eac3PhaseControl", - "locationName": "phaseControl", - "documentation": "When set to shift90Degrees, applies a 90-degree phase shift to the surround channels. Only used for 3/2 coding mode." - }, - "StereoDownmix": { - "shape": "Eac3StereoDownmix", - "locationName": "stereoDownmix", - "documentation": "Stereo downmix preference. Only used for 3/2 coding mode." - }, - "SurroundExMode": { - "shape": "Eac3SurroundExMode", - "locationName": "surroundExMode", - "documentation": "When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels." - }, - "SurroundMode": { - "shape": "Eac3SurroundMode", - "locationName": "surroundMode", - "documentation": "When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels." - } - }, - "documentation": "Placeholder documentation for Eac3Settings" - }, - "Eac3StereoDownmix": { - "type": "string", - "enum": [ - "DPL2", - "LO_RO", - "LT_RT", - "NOT_INDICATED" - ], - "documentation": "Placeholder documentation for Eac3StereoDownmix" - }, - "Eac3SurroundExMode": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED", - "NOT_INDICATED" - ], - "documentation": "Placeholder documentation for Eac3SurroundExMode" - }, - "Eac3SurroundMode": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED", - "NOT_INDICATED" - ], - "documentation": "Placeholder documentation for Eac3SurroundMode" - }, - "EmbeddedConvert608To708": { - "type": "string", - "enum": [ - "DISABLED", - "UPCONVERT" - ], - "documentation": "Placeholder documentation for EmbeddedConvert608To708" - }, - "EmbeddedDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for EmbeddedDestinationSettings" - }, - "EmbeddedPlusScte20DestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for EmbeddedPlusScte20DestinationSettings" - }, - "EmbeddedScte20Detection": { - "type": "string", - "enum": [ - "AUTO", - "OFF" - ], - "documentation": "Placeholder documentation for EmbeddedScte20Detection" - }, - "EmbeddedSourceSettings": { - "type": "structure", - "members": { - "Convert608To708": { - "shape": "EmbeddedConvert608To708", - "locationName": "convert608To708", - "documentation": "If upconvert, 608 data is both passed through via the \"608 compatibility bytes\" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded." - }, - "Scte20Detection": { - "shape": "EmbeddedScte20Detection", - "locationName": "scte20Detection", - "documentation": "Set to \"auto\" to handle streams with intermittent and/or non-aligned SCTE-20 and Embedded captions." - }, - "Source608ChannelNumber": { - "shape": "__integerMin1Max4", - "locationName": "source608ChannelNumber", - "documentation": "Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough." - }, - "Source608TrackNumber": { - "shape": "__integerMin1Max5", - "locationName": "source608TrackNumber", - "documentation": "This field is unused and deprecated." - } - }, - "documentation": "Placeholder documentation for EmbeddedSourceSettings" - }, - "Empty": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for Empty" - }, - "EncoderSettings": { - "type": "structure", - "members": { - "AudioDescriptions": { - "shape": "__listOfAudioDescription", - "locationName": "audioDescriptions" - }, - "AvailBlanking": { - "shape": "AvailBlanking", - "locationName": "availBlanking", - "documentation": "Settings for ad avail blanking." - }, - "AvailConfiguration": { - "shape": "AvailConfiguration", - "locationName": "availConfiguration", - "documentation": "Event-wide configuration settings for ad avail insertion." - }, - "BlackoutSlate": { - "shape": "BlackoutSlate", - "locationName": "blackoutSlate", - "documentation": "Settings for blackout slate." - }, - "CaptionDescriptions": { - "shape": "__listOfCaptionDescription", - "locationName": "captionDescriptions", - "documentation": "Settings for caption decriptions" - }, - "GlobalConfiguration": { - "shape": "GlobalConfiguration", - "locationName": "globalConfiguration", - "documentation": "Configuration settings that apply to the event as a whole." - }, - "OutputGroups": { - "shape": "__listOfOutputGroup", - "locationName": "outputGroups" - }, - "TimecodeConfig": { - "shape": "TimecodeConfig", - "locationName": "timecodeConfig", - "documentation": "Contains settings used to acquire and adjust timecode information from inputs." - }, - "VideoDescriptions": { - "shape": "__listOfVideoDescription", - "locationName": "videoDescriptions" - } - }, - "required": [ - "VideoDescriptions", - "AudioDescriptions", - "OutputGroups", - "TimecodeConfig" - ], - "documentation": "Placeholder documentation for EncoderSettings" - }, - "FecOutputIncludeFec": { - "type": "string", - "enum": [ - "COLUMN", - "COLUMN_AND_ROW" - ], - "documentation": "Placeholder documentation for FecOutputIncludeFec" - }, - "FecOutputSettings": { - "type": "structure", - "members": { - "ColumnDepth": { - "shape": "__integerMin4Max20", - "locationName": "columnDepth", - "documentation": "Parameter D from SMPTE 2022-1. The height of the FEC protection matrix. The number of transport stream packets per column error correction packet. Must be between 4 and 20, inclusive." - }, - "IncludeFec": { - "shape": "FecOutputIncludeFec", - "locationName": "includeFec", - "documentation": "Enables column only or column and row based FEC" - }, - "RowLength": { - "shape": "__integerMin1Max20", - "locationName": "rowLength", - "documentation": "Parameter L from SMPTE 2022-1. The width of the FEC protection matrix. Must be between 1 and 20, inclusive. If only Column FEC is used, then larger values increase robustness. If Row FEC is used, then this is the number of transport stream packets per row error correction packet, and the value must be between 4 and 20, inclusive, if includeFec is columnAndRow. If includeFec is column, this value must be 1 to 20, inclusive." - } - }, - "documentation": "Placeholder documentation for FecOutputSettings" - }, - "FixedAfd": { - "type": "string", - "enum": [ - "AFD_0000", - "AFD_0010", - "AFD_0011", - "AFD_0100", - "AFD_1000", - "AFD_1001", - "AFD_1010", - "AFD_1011", - "AFD_1101", - "AFD_1110", - "AFD_1111" - ], - "documentation": "Placeholder documentation for FixedAfd" - }, - "ForbiddenException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 403 - }, - "documentation": "Placeholder documentation for ForbiddenException" - }, - "GatewayTimeoutException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 504 - }, - "documentation": "Placeholder documentation for GatewayTimeoutException" - }, - "GlobalConfiguration": { - "type": "structure", - "members": { - "InitialAudioGain": { - "shape": "__integerMinNegative60Max60", - "locationName": "initialAudioGain", - "documentation": "Value to set the initial audio gain for the Live Event." - }, - "InputEndAction": { - "shape": "GlobalConfigurationInputEndAction", - "locationName": "inputEndAction", - "documentation": "Indicates the action to take when an input completes (e.g. end-of-file.) Options include immediately switching to the next sequential input (via \"switchInput\"), switching to the next input and looping back to the first input when last input ends (via \"switchAndLoopInputs\") or not switching inputs and instead transcoding black / color / slate images per the \"Input Loss Behavior\" configuration until an activateInput REST command is received (via \"none\")." - }, - "InputLossBehavior": { - "shape": "InputLossBehavior", - "locationName": "inputLossBehavior", - "documentation": "Settings for system actions when input is lost." - }, - "OutputTimingSource": { - "shape": "GlobalConfigurationOutputTimingSource", - "locationName": "outputTimingSource", - "documentation": "Indicates whether the rate of frames emitted by the Live encoder should be paced by its system clock (which optionally may be locked to another source via NTP) or should be locked to the clock of the source that is providing the input stream." - }, - "SupportLowFramerateInputs": { - "shape": "GlobalConfigurationLowFramerateInputs", - "locationName": "supportLowFramerateInputs", - "documentation": "Adjusts video input buffer for streams with very low video framerates. This is commonly set to enabled for music channels with less than one video frame per second." - } - }, - "documentation": "Placeholder documentation for GlobalConfiguration" - }, - "GlobalConfigurationInputEndAction": { - "type": "string", - "enum": [ - "NONE", - "SWITCH_AND_LOOP_INPUTS" - ], - "documentation": "Placeholder documentation for GlobalConfigurationInputEndAction" - }, - "GlobalConfigurationLowFramerateInputs": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for GlobalConfigurationLowFramerateInputs" - }, - "GlobalConfigurationOutputTimingSource": { - "type": "string", - "enum": [ - "INPUT_CLOCK", - "SYSTEM_CLOCK" - ], - "documentation": "Placeholder documentation for GlobalConfigurationOutputTimingSource" - }, - "H264AdaptiveQuantization": { - "type": "string", - "enum": [ - "HIGH", - "HIGHER", - "LOW", - "MAX", - "MEDIUM", - "OFF" - ], - "documentation": "Placeholder documentation for H264AdaptiveQuantization" - }, - "H264ColorMetadata": { - "type": "string", - "enum": [ - "IGNORE", - "INSERT" - ], - "documentation": "Placeholder documentation for H264ColorMetadata" - }, - "H264EntropyEncoding": { - "type": "string", - "enum": [ - "CABAC", - "CAVLC" - ], - "documentation": "Placeholder documentation for H264EntropyEncoding" - }, - "H264FlickerAq": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for H264FlickerAq" - }, - "H264FramerateControl": { - "type": "string", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ], - "documentation": "Placeholder documentation for H264FramerateControl" - }, - "H264GopBReference": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for H264GopBReference" - }, - "H264GopSizeUnits": { - "type": "string", - "enum": [ - "FRAMES", - "SECONDS" - ], - "documentation": "Placeholder documentation for H264GopSizeUnits" - }, - "H264Level": { - "type": "string", - "enum": [ - "H264_LEVEL_1", - "H264_LEVEL_1_1", - "H264_LEVEL_1_2", - "H264_LEVEL_1_3", - "H264_LEVEL_2", - "H264_LEVEL_2_1", - "H264_LEVEL_2_2", - "H264_LEVEL_3", - "H264_LEVEL_3_1", - "H264_LEVEL_3_2", - "H264_LEVEL_4", - "H264_LEVEL_4_1", - "H264_LEVEL_4_2", - "H264_LEVEL_5", - "H264_LEVEL_5_1", - "H264_LEVEL_5_2", - "H264_LEVEL_AUTO" - ], - "documentation": "Placeholder documentation for H264Level" - }, - "H264LookAheadRateControl": { - "type": "string", - "enum": [ - "HIGH", - "LOW", - "MEDIUM" - ], - "documentation": "Placeholder documentation for H264LookAheadRateControl" - }, - "H264ParControl": { - "type": "string", - "enum": [ - "INITIALIZE_FROM_SOURCE", - "SPECIFIED" - ], - "documentation": "Placeholder documentation for H264ParControl" - }, - "H264Profile": { - "type": "string", - "enum": [ - "BASELINE", - "HIGH", - "HIGH_10BIT", - "HIGH_422", - "HIGH_422_10BIT", - "MAIN" - ], - "documentation": "Placeholder documentation for H264Profile" - }, - "H264RateControlMode": { - "type": "string", - "enum": [ - "CBR", - "VBR" - ], - "documentation": "Placeholder documentation for H264RateControlMode" - }, - "H264ScanType": { - "type": "string", - "enum": [ - "INTERLACED", - "PROGRESSIVE" - ], - "documentation": "Placeholder documentation for H264ScanType" - }, - "H264SceneChangeDetect": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for H264SceneChangeDetect" - }, - "H264Settings": { - "type": "structure", - "members": { - "AdaptiveQuantization": { - "shape": "H264AdaptiveQuantization", - "locationName": "adaptiveQuantization", - "documentation": "Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality." - }, - "AfdSignaling": { - "shape": "AfdSignaling", - "locationName": "afdSignaling", - "documentation": "Indicates that AFD values will be written into the output stream. If afdSignaling is \"auto\", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to \"fixed\", the AFD value will be the value configured in the fixedAfd parameter." - }, - "Bitrate": { - "shape": "__integerMin1000", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second. Required for VBR, CBR, and ABR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000." - }, - "BufFillPct": { - "shape": "__integerMin0Max100", - "locationName": "bufFillPct", - "documentation": "Percentage of the buffer that should initially be filled (HRD buffer model)." - }, - "BufSize": { - "shape": "__integerMin0", - "locationName": "bufSize", - "documentation": "Size of buffer (HRD buffer model) in bits/second." - }, - "ColorMetadata": { - "shape": "H264ColorMetadata", - "locationName": "colorMetadata", - "documentation": "Includes colorspace metadata in the output." - }, - "EntropyEncoding": { - "shape": "H264EntropyEncoding", - "locationName": "entropyEncoding", - "documentation": "Entropy encoding mode. Use cabac (must be in Main or High profile) or cavlc." - }, - "FixedAfd": { - "shape": "FixedAfd", - "locationName": "fixedAfd", - "documentation": "Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'." - }, - "FlickerAq": { - "shape": "H264FlickerAq", - "locationName": "flickerAq", - "documentation": "If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames." - }, - "FramerateControl": { - "shape": "H264FramerateControl", - "locationName": "framerateControl", - "documentation": "This field indicates how the output video frame rate is specified. If \"specified\" is selected then the output video frame rate is determined by framerateNumerator and framerateDenominator, else if \"initializeFromSource\" is selected then the output video frame rate will be set equal to the input video frame rate of the first input." - }, - "FramerateDenominator": { - "shape": "__integer", - "locationName": "framerateDenominator", - "documentation": "Framerate denominator." - }, - "FramerateNumerator": { - "shape": "__integer", - "locationName": "framerateNumerator", - "documentation": "Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps." - }, - "GopBReference": { - "shape": "H264GopBReference", - "locationName": "gopBReference", - "documentation": "Documentation update needed" - }, - "GopClosedCadence": { - "shape": "__integerMin0", - "locationName": "gopClosedCadence", - "documentation": "Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting." - }, - "GopNumBFrames": { - "shape": "__integerMin0Max7", - "locationName": "gopNumBFrames", - "documentation": "Number of B-frames between reference frames." - }, - "GopSize": { - "shape": "__doubleMin1", - "locationName": "gopSize", - "documentation": "GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits. Must be greater than zero." - }, - "GopSizeUnits": { - "shape": "H264GopSizeUnits", - "locationName": "gopSizeUnits", - "documentation": "Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time." - }, - "Level": { - "shape": "H264Level", - "locationName": "level", - "documentation": "H.264 Level." - }, - "LookAheadRateControl": { - "shape": "H264LookAheadRateControl", - "locationName": "lookAheadRateControl", - "documentation": "Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content." - }, - "MaxBitrate": { - "shape": "__integerMin1000", - "locationName": "maxBitrate", - "documentation": "Maximum bitrate in bits/second (for VBR mode only)." - }, - "MinIInterval": { - "shape": "__integerMin0Max30", - "locationName": "minIInterval", - "documentation": "Only meaningful if sceneChangeDetect is set to enabled. Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1" - }, - "NumRefFrames": { - "shape": "__integerMin1Max6", - "locationName": "numRefFrames", - "documentation": "Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding." - }, - "ParControl": { - "shape": "H264ParControl", - "locationName": "parControl", - "documentation": "This field indicates how the output pixel aspect ratio is specified. If \"specified\" is selected then the output video pixel aspect ratio is determined by parNumerator and parDenominator, else if \"initializeFromSource\" is selected then the output pixsel aspect ratio will be set equal to the input video pixel aspect ratio of the first input." - }, - "ParDenominator": { - "shape": "__integerMin1", - "locationName": "parDenominator", - "documentation": "Pixel Aspect Ratio denominator." - }, - "ParNumerator": { - "shape": "__integer", - "locationName": "parNumerator", - "documentation": "Pixel Aspect Ratio numerator." - }, - "Profile": { - "shape": "H264Profile", - "locationName": "profile", - "documentation": "H.264 Profile." - }, - "RateControlMode": { - "shape": "H264RateControlMode", - "locationName": "rateControlMode", - "documentation": "Rate control mode." - }, - "ScanType": { - "shape": "H264ScanType", - "locationName": "scanType", - "documentation": "Sets the scan type of the output to progressive or top-field-first interlaced." - }, - "SceneChangeDetect": { - "shape": "H264SceneChangeDetect", - "locationName": "sceneChangeDetect", - "documentation": "Scene change detection. Inserts I-frames on scene changes when enabled." - }, - "Slices": { - "shape": "__integerMin1Max32", - "locationName": "slices", - "documentation": "Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.\nThis field is optional; when no value is specified the encoder will choose the number of slices based on encode resolution." - }, - "Softness": { - "shape": "__integerMin0Max128", - "locationName": "softness", - "documentation": "Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image." - }, - "SpatialAq": { - "shape": "H264SpatialAq", - "locationName": "spatialAq", - "documentation": "If set to enabled, adjust quantization within each frame based on spatial variation of content complexity." - }, - "Syntax": { - "shape": "H264Syntax", - "locationName": "syntax", - "documentation": "Produces a bitstream compliant with SMPTE RP-2027." - }, - "TemporalAq": { - "shape": "H264TemporalAq", - "locationName": "temporalAq", - "documentation": "If set to enabled, adjust quantization within each frame based on temporal variation of content complexity." - }, - "TimecodeInsertion": { - "shape": "H264TimecodeInsertionBehavior", - "locationName": "timecodeInsertion", - "documentation": "Determines how timecodes should be inserted into the video elementary stream.\n- 'disabled': Do not include timecodes\n- 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config" - } - }, - "documentation": "Placeholder documentation for H264Settings" - }, - "H264SpatialAq": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for H264SpatialAq" - }, - "H264Syntax": { - "type": "string", - "enum": [ - "DEFAULT", - "RP2027" - ], - "documentation": "Placeholder documentation for H264Syntax" - }, - "H264TemporalAq": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for H264TemporalAq" - }, - "H264TimecodeInsertionBehavior": { - "type": "string", - "enum": [ - "DISABLED", - "PIC_TIMING_SEI" - ], - "documentation": "Placeholder documentation for H264TimecodeInsertionBehavior" - }, - "HlsAdMarkers": { - "type": "string", - "enum": [ - "ADOBE", - "ELEMENTAL", - "ELEMENTAL_SCTE35" - ], - "documentation": "Placeholder documentation for HlsAdMarkers" - }, - "HlsAkamaiHttpTransferMode": { - "type": "string", - "enum": [ - "CHUNKED", - "NON_CHUNKED" - ], - "documentation": "Placeholder documentation for HlsAkamaiHttpTransferMode" - }, - "HlsAkamaiSettings": { - "type": "structure", - "members": { - "ConnectionRetryInterval": { - "shape": "__integerMin0", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying connection to the CDN if the connection is lost." - }, - "FilecacheDuration": { - "shape": "__integerMin0Max600", - "locationName": "filecacheDuration", - "documentation": "Size in seconds of file cache for streaming outputs." - }, - "HttpTransferMode": { - "shape": "HlsAkamaiHttpTransferMode", - "locationName": "httpTransferMode", - "documentation": "Specify whether or not to use chunked transfer encoding to Akamai. User should contact Akamai to enable this feature." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts that will be made before the Live Event is put into an error state." - }, - "RestartDelay": { - "shape": "__integerMin0Max15", - "locationName": "restartDelay", - "documentation": "If a streaming output fails, number of seconds to wait until a restart is initiated. A value of 0 means never restart." - }, - "Salt": { - "shape": "__string", - "locationName": "salt", - "documentation": "Salt for authenticated Akamai." - }, - "Token": { - "shape": "__string", - "locationName": "token", - "documentation": "Token parameter for authenticated akamai. If not specified, _gda_ is used." - } - }, - "documentation": "Placeholder documentation for HlsAkamaiSettings" - }, - "HlsBasicPutSettings": { - "type": "structure", - "members": { - "ConnectionRetryInterval": { - "shape": "__integerMin0", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying connection to the CDN if the connection is lost." - }, - "FilecacheDuration": { - "shape": "__integerMin0Max600", - "locationName": "filecacheDuration", - "documentation": "Size in seconds of file cache for streaming outputs." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts that will be made before the Live Event is put into an error state." - }, - "RestartDelay": { - "shape": "__integerMin0Max15", - "locationName": "restartDelay", - "documentation": "If a streaming output fails, number of seconds to wait until a restart is initiated. A value of 0 means never restart." - } - }, - "documentation": "Placeholder documentation for HlsBasicPutSettings" - }, - "HlsCaptionLanguageSetting": { - "type": "string", - "enum": [ - "INSERT", - "NONE", - "OMIT" - ], - "documentation": "Placeholder documentation for HlsCaptionLanguageSetting" - }, - "HlsCdnSettings": { - "type": "structure", - "members": { - "HlsAkamaiSettings": { - "shape": "HlsAkamaiSettings", - "locationName": "hlsAkamaiSettings" - }, - "HlsBasicPutSettings": { - "shape": "HlsBasicPutSettings", - "locationName": "hlsBasicPutSettings" - }, - "HlsMediaStoreSettings": { - "shape": "HlsMediaStoreSettings", - "locationName": "hlsMediaStoreSettings" - }, - "HlsWebdavSettings": { - "shape": "HlsWebdavSettings", - "locationName": "hlsWebdavSettings" - } - }, - "documentation": "Placeholder documentation for HlsCdnSettings" - }, - "HlsClientCache": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for HlsClientCache" - }, - "HlsCodecSpecification": { - "type": "string", - "enum": [ - "RFC_4281", - "RFC_6381" - ], - "documentation": "Placeholder documentation for HlsCodecSpecification" - }, - "HlsDirectoryStructure": { - "type": "string", - "enum": [ - "SINGLE_DIRECTORY", - "SUBDIRECTORY_PER_STREAM" - ], - "documentation": "Placeholder documentation for HlsDirectoryStructure" - }, - "HlsEncryptionType": { - "type": "string", - "enum": [ - "AES128", - "SAMPLE_AES" - ], - "documentation": "Placeholder documentation for HlsEncryptionType" - }, - "HlsGroupSettings": { - "type": "structure", - "members": { - "AdMarkers": { - "shape": "__listOfHlsAdMarkers", - "locationName": "adMarkers", - "documentation": "Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs." - }, - "BaseUrlContent": { - "shape": "__string", - "locationName": "baseUrlContent", - "documentation": "A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file." - }, - "BaseUrlManifest": { - "shape": "__string", - "locationName": "baseUrlManifest", - "documentation": "A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file." - }, - "CaptionLanguageMappings": { - "shape": "__listOfCaptionLanguageMapping", - "locationName": "captionLanguageMappings", - "documentation": "Mapping of up to 4 caption channels to caption languages. Is only meaningful if captionLanguageSetting is set to \"insert\"." - }, - "CaptionLanguageSetting": { - "shape": "HlsCaptionLanguageSetting", - "locationName": "captionLanguageSetting", - "documentation": "Applies only to 608 Embedded output captions.\ninsert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions.\nnone: Include CLOSED-CAPTIONS=NONE line in the manifest.\nomit: Omit any CLOSED-CAPTIONS line from the manifest." - }, - "ClientCache": { - "shape": "HlsClientCache", - "locationName": "clientCache", - "documentation": "When set to \"disabled\", sets the #EXT-X-ALLOW-CACHE:no tag in the manifest, which prevents clients from saving media segments for later replay." - }, - "CodecSpecification": { - "shape": "HlsCodecSpecification", - "locationName": "codecSpecification", - "documentation": "Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation." - }, - "ConstantIv": { - "shape": "__stringMin32Max32", - "locationName": "constantIv", - "documentation": "For use with encryptionType. This is a 128-bit, 16-byte hex value represented by a 32-character text string. If ivSource is set to \"explicit\" then this parameter is required and is used as the IV for encryption." - }, - "Destination": { - "shape": "OutputLocationRef", - "locationName": "destination", - "documentation": "A directory or HTTP destination for the HLS segments, manifest files, and encryption keys (if enabled)." - }, - "DirectoryStructure": { - "shape": "HlsDirectoryStructure", - "locationName": "directoryStructure", - "documentation": "Place segments in subdirectories." - }, - "EncryptionType": { - "shape": "HlsEncryptionType", - "locationName": "encryptionType", - "documentation": "Encrypts the segments with the given encryption scheme. Exclude this parameter if no encryption is desired." - }, - "HlsCdnSettings": { - "shape": "HlsCdnSettings", - "locationName": "hlsCdnSettings", - "documentation": "Parameters that control interactions with the CDN." - }, - "IndexNSegments": { - "shape": "__integerMin3", - "locationName": "indexNSegments", - "documentation": "If mode is \"live\", the number of segments to retain in the manifest (.m3u8) file. This number must be less than or equal to keepSegments. If mode is \"vod\", this parameter has no effect." - }, - "InputLossAction": { - "shape": "InputLossActionForHlsOut", - "locationName": "inputLossAction", - "documentation": "Parameter that control output group behavior on input loss." - }, - "IvInManifest": { - "shape": "HlsIvInManifest", - "locationName": "ivInManifest", - "documentation": "For use with encryptionType. The IV (Initialization Vector) is a 128-bit number used in conjunction with the key for encrypting blocks. If set to \"include\", IV is listed in the manifest, otherwise the IV is not in the manifest." - }, - "IvSource": { - "shape": "HlsIvSource", - "locationName": "ivSource", - "documentation": "For use with encryptionType. The IV (Initialization Vector) is a 128-bit number used in conjunction with the key for encrypting blocks. If this setting is \"followsSegmentNumber\", it will cause the IV to change every segment (to match the segment number). If this is set to \"explicit\", you must enter a constantIv value." - }, - "KeepSegments": { - "shape": "__integerMin1", - "locationName": "keepSegments", - "documentation": "If mode is \"live\", the number of TS segments to retain in the destination directory. If mode is \"vod\", this parameter has no effect." - }, - "KeyFormat": { - "shape": "__string", - "locationName": "keyFormat", - "documentation": "The value specifies how the key is represented in the resource identified by the URI. If parameter is absent, an implicit value of \"identity\" is used. A reverse DNS string can also be given." - }, - "KeyFormatVersions": { - "shape": "__string", - "locationName": "keyFormatVersions", - "documentation": "Either a single positive integer version value or a slash delimited list of version values (1/2/3)." - }, - "KeyProviderSettings": { - "shape": "KeyProviderSettings", - "locationName": "keyProviderSettings", - "documentation": "The key provider settings." - }, - "ManifestCompression": { - "shape": "HlsManifestCompression", - "locationName": "manifestCompression", - "documentation": "When set to gzip, compresses HLS playlist." - }, - "ManifestDurationFormat": { - "shape": "HlsManifestDurationFormat", - "locationName": "manifestDurationFormat", - "documentation": "Indicates whether the output manifest should use floating point or integer values for segment duration." - }, - "MinSegmentLength": { - "shape": "__integerMin0", - "locationName": "minSegmentLength", - "documentation": "When set, minimumSegmentLength is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed." - }, - "Mode": { - "shape": "HlsMode", - "locationName": "mode", - "documentation": "If \"vod\", all segments are indexed and kept permanently in the destination and manifest. If \"live\", only the number segments specified in keepSegments and indexNSegments are kept; newer segments replace older segments, which may prevent players from rewinding all the way to the beginning of the event.\n\nVOD mode uses HLS EXT-X-PLAYLIST-TYPE of EVENT while the channel is running, converting it to a \"VOD\" type manifest on completion of the stream." - }, - "OutputSelection": { - "shape": "HlsOutputSelection", - "locationName": "outputSelection", - "documentation": "Generates the .m3u8 playlist file for this HLS output group. The segmentsOnly option will output segments without the .m3u8 file." - }, - "ProgramDateTime": { - "shape": "HlsProgramDateTime", - "locationName": "programDateTime", - "documentation": "Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestampOffset." - }, - "ProgramDateTimePeriod": { - "shape": "__integerMin0Max3600", - "locationName": "programDateTimePeriod", - "documentation": "Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds." - }, - "SegmentLength": { - "shape": "__integerMin1", - "locationName": "segmentLength", - "documentation": "Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer." - }, - "SegmentationMode": { - "shape": "HlsSegmentationMode", - "locationName": "segmentationMode", - "documentation": "When set to useInputSegmentation, the output segment or fragment points are set by the RAI markers from the input streams." - }, - "SegmentsPerSubdirectory": { - "shape": "__integerMin1", - "locationName": "segmentsPerSubdirectory", - "documentation": "Number of segments to write to a subdirectory before starting a new one. directoryStructure must be subdirectoryPerStream for this setting to have an effect." - }, - "StreamInfResolution": { - "shape": "HlsStreamInfResolution", - "locationName": "streamInfResolution", - "documentation": "Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest." - }, - "TimedMetadataId3Frame": { - "shape": "HlsTimedMetadataId3Frame", - "locationName": "timedMetadataId3Frame", - "documentation": "Indicates ID3 frame that has the timecode." - }, - "TimedMetadataId3Period": { - "shape": "__integerMin0", - "locationName": "timedMetadataId3Period", - "documentation": "Timed Metadata interval in seconds." - }, - "TimestampDeltaMilliseconds": { - "shape": "__integerMin0", - "locationName": "timestampDeltaMilliseconds", - "documentation": "Provides an extra millisecond delta offset to fine tune the timestamps." - }, - "TsFileMode": { - "shape": "HlsTsFileMode", - "locationName": "tsFileMode", - "documentation": "When set to \"singleFile\", emits the program as a single media resource (.ts) file, and uses #EXT-X-BYTERANGE tags to index segment for playback. Playback of VOD mode content during event is not guaranteed due to HTTP server caching." - } - }, - "required": [ - "Destination" - ], - "documentation": "Placeholder documentation for HlsGroupSettings" - }, - "HlsInputSettings": { - "type": "structure", - "members": { - "Bandwidth": { - "shape": "__integerMin0", - "locationName": "bandwidth", - "documentation": "When specified the HLS stream with the m3u8 BANDWIDTH that most closely matches this value will be chosen, otherwise the highest bandwidth stream in the m3u8 will be chosen. The bitrate is specified in bits per second, as in an HLS manifest." - }, - "BufferSegments": { - "shape": "__integerMin0", - "locationName": "bufferSegments", - "documentation": "When specified, reading of the HLS input will begin this many buffer segments from the end (most recently written segment). When not specified, the HLS input will begin with the first segment specified in the m3u8." - }, - "Retries": { - "shape": "__integerMin0", - "locationName": "retries", - "documentation": "The number of consecutive times that attempts to read a manifest or segment must fail before the input is considered unavailable." - }, - "RetryInterval": { - "shape": "__integerMin0", - "locationName": "retryInterval", - "documentation": "The number of seconds between retries when an attempt to read a manifest or segment fails." - } - }, - "documentation": "Placeholder documentation for HlsInputSettings" - }, - "HlsIvInManifest": { - "type": "string", - "enum": [ - "EXCLUDE", - "INCLUDE" - ], - "documentation": "Placeholder documentation for HlsIvInManifest" - }, - "HlsIvSource": { - "type": "string", - "enum": [ - "EXPLICIT", - "FOLLOWS_SEGMENT_NUMBER" - ], - "documentation": "Placeholder documentation for HlsIvSource" - }, - "HlsManifestCompression": { - "type": "string", - "enum": [ - "GZIP", - "NONE" - ], - "documentation": "Placeholder documentation for HlsManifestCompression" - }, - "HlsManifestDurationFormat": { - "type": "string", - "enum": [ - "FLOATING_POINT", - "INTEGER" - ], - "documentation": "Placeholder documentation for HlsManifestDurationFormat" - }, - "HlsMediaStoreSettings": { - "type": "structure", - "members": { - "ConnectionRetryInterval": { - "shape": "__integerMin0", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying connection to the CDN if the connection is lost." - }, - "FilecacheDuration": { - "shape": "__integerMin0Max600", - "locationName": "filecacheDuration", - "documentation": "Size in seconds of file cache for streaming outputs." - }, - "MediaStoreStorageClass": { - "shape": "HlsMediaStoreStorageClass", - "locationName": "mediaStoreStorageClass", - "documentation": "When set to temporal, output files are stored in non-persistent memory for faster reading and writing." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts that will be made before the Live Event is put into an error state." - }, - "RestartDelay": { - "shape": "__integerMin0Max15", - "locationName": "restartDelay", - "documentation": "If a streaming output fails, number of seconds to wait until a restart is initiated. A value of 0 means never restart." - } - }, - "documentation": "Placeholder documentation for HlsMediaStoreSettings" - }, - "HlsMediaStoreStorageClass": { - "type": "string", - "enum": [ - "TEMPORAL" - ], - "documentation": "Placeholder documentation for HlsMediaStoreStorageClass" - }, - "HlsMode": { - "type": "string", - "enum": [ - "LIVE", - "VOD" - ], - "documentation": "Placeholder documentation for HlsMode" - }, - "HlsOutputSelection": { - "type": "string", - "enum": [ - "MANIFESTS_AND_SEGMENTS", - "SEGMENTS_ONLY" - ], - "documentation": "Placeholder documentation for HlsOutputSelection" - }, - "HlsOutputSettings": { - "type": "structure", - "members": { - "HlsSettings": { - "shape": "HlsSettings", - "locationName": "hlsSettings", - "documentation": "Settings regarding the underlying stream. These settings are different for audio-only outputs." - }, - "NameModifier": { - "shape": "__stringMin1", - "locationName": "nameModifier", - "documentation": "String concatenated to the end of the destination filename. Accepts \\\"Format Identifiers\\\":#formatIdentifierParameters." - }, - "SegmentModifier": { - "shape": "__string", - "locationName": "segmentModifier", - "documentation": "String concatenated to end of segment filenames." - } - }, - "required": [ - "HlsSettings" - ], - "documentation": "Placeholder documentation for HlsOutputSettings" - }, - "HlsProgramDateTime": { - "type": "string", - "enum": [ - "EXCLUDE", - "INCLUDE" - ], - "documentation": "Placeholder documentation for HlsProgramDateTime" - }, - "HlsSegmentationMode": { - "type": "string", - "enum": [ - "USE_INPUT_SEGMENTATION", - "USE_SEGMENT_DURATION" - ], - "documentation": "Placeholder documentation for HlsSegmentationMode" - }, - "HlsSettings": { - "type": "structure", - "members": { - "AudioOnlyHlsSettings": { - "shape": "AudioOnlyHlsSettings", - "locationName": "audioOnlyHlsSettings" - }, - "StandardHlsSettings": { - "shape": "StandardHlsSettings", - "locationName": "standardHlsSettings" - } - }, - "documentation": "Placeholder documentation for HlsSettings" - }, - "HlsStreamInfResolution": { - "type": "string", - "enum": [ - "EXCLUDE", - "INCLUDE" - ], - "documentation": "Placeholder documentation for HlsStreamInfResolution" - }, - "HlsTimedMetadataId3Frame": { - "type": "string", - "enum": [ - "NONE", - "PRIV", - "TDRL" - ], - "documentation": "Placeholder documentation for HlsTimedMetadataId3Frame" - }, - "HlsTsFileMode": { - "type": "string", - "enum": [ - "SEGMENTED_FILES", - "SINGLE_FILE" - ], - "documentation": "Placeholder documentation for HlsTsFileMode" - }, - "HlsWebdavHttpTransferMode": { - "type": "string", - "enum": [ - "CHUNKED", - "NON_CHUNKED" - ], - "documentation": "Placeholder documentation for HlsWebdavHttpTransferMode" - }, - "HlsWebdavSettings": { - "type": "structure", - "members": { - "ConnectionRetryInterval": { - "shape": "__integerMin0", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying connection to the CDN if the connection is lost." - }, - "FilecacheDuration": { - "shape": "__integerMin0Max600", - "locationName": "filecacheDuration", - "documentation": "Size in seconds of file cache for streaming outputs." - }, - "HttpTransferMode": { - "shape": "HlsWebdavHttpTransferMode", - "locationName": "httpTransferMode", - "documentation": "Specify whether or not to use chunked transfer encoding to WebDAV." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts that will be made before the Live Event is put into an error state." - }, - "RestartDelay": { - "shape": "__integerMin0Max15", - "locationName": "restartDelay", - "documentation": "If a streaming output fails, number of seconds to wait until a restart is initiated. A value of 0 means never restart." - } - }, - "documentation": "Placeholder documentation for HlsWebdavSettings" - }, - "Input": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The Unique ARN of the input (generated, immutable)." - }, - "AttachedChannels": { - "shape": "__listOf__string", - "locationName": "attachedChannels", - "documentation": "A list of channel IDs that that input is attached to (currently an input can only be attached to one channel)." - }, - "Destinations": { - "shape": "__listOfInputDestination", - "locationName": "destinations", - "documentation": "A list of the destinations of the input (PUSH-type)." - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The generated ID of the input (unique for user account, immutable)." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The user-assigned name (This is a mutable value)." - }, - "SecurityGroups": { - "shape": "__listOf__string", - "locationName": "securityGroups", - "documentation": "A list of IDs for all the security groups attached to the input." - }, - "Sources": { - "shape": "__listOfInputSource", - "locationName": "sources", - "documentation": "A list of the sources of the input (PULL-type)." - }, - "State": { - "shape": "InputState", - "locationName": "state" - }, - "Type": { - "shape": "InputType", - "locationName": "type" - } - }, - "documentation": "Placeholder documentation for Input" - }, - "InputAttachment": { - "type": "structure", - "members": { - "InputId": { - "shape": "__string", - "locationName": "inputId", - "documentation": "The ID of the input" - }, - "InputSettings": { - "shape": "InputSettings", - "locationName": "inputSettings", - "documentation": "Settings of an input (caption selector, etc.)" - } - }, - "documentation": "Placeholder documentation for InputAttachment" - }, - "InputChannelLevel": { - "type": "structure", - "members": { - "Gain": { - "shape": "__integerMinNegative60Max6", - "locationName": "gain", - "documentation": "Remixing value. Units are in dB and acceptable values are within the range from -60 (mute) and 6 dB." - }, - "InputChannel": { - "shape": "__integerMin0Max15", - "locationName": "inputChannel", - "documentation": "The index of the input channel used as a source." - } - }, - "required": [ - "InputChannel", - "Gain" - ], - "documentation": "Placeholder documentation for InputChannelLevel" - }, - "InputCodec": { - "type": "string", - "documentation": "codec in increasing order of complexity", - "enum": [ - "MPEG2", - "AVC", - "HEVC" - ] - }, - "InputDeblockFilter": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for InputDeblockFilter" - }, - "InputDenoiseFilter": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for InputDenoiseFilter" - }, - "InputDestination": { - "type": "structure", - "members": { - "Ip": { - "shape": "__string", - "locationName": "ip", - "documentation": "The system-generated static IP address of endpoint.\nIt remains fixed for the lifetime of the input.\n" - }, - "Port": { - "shape": "__string", - "locationName": "port", - "documentation": "The port number for the input." - }, - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "This represents the endpoint that the customer stream will be\npushed to.\n" - } - }, - "documentation": "The settings for a PUSH type input." - }, - "InputDestinationRequest": { - "type": "structure", - "members": { - "StreamName": { - "shape": "__string", - "locationName": "streamName", - "documentation": "A unique name for the location the RTMP stream is being pushed\nto.\n" - } - }, - "documentation": "Endpoint settings for a PUSH type input." - }, - "InputFilter": { - "type": "string", - "enum": [ - "AUTO", - "DISABLED", - "FORCED" - ], - "documentation": "Placeholder documentation for InputFilter" - }, - "InputLocation": { - "type": "structure", - "members": { - "PasswordParam": { - "shape": "__string", - "locationName": "passwordParam", - "documentation": "key used to extract the password from EC2 Parameter store" - }, - "Uri": { - "shape": "__string", - "locationName": "uri", - "documentation": "Uniform Resource Identifier - This should be a path to a file accessible to the Live system (eg. a http:// URI) depending on the output type. For example, a RTMP destination should have a uri simliar to: \"rtmp://fmsserver/live\"." - }, - "Username": { - "shape": "__string", - "locationName": "username", - "documentation": "Documentation update needed" - } - }, - "required": [ - "Uri" - ], - "documentation": "Placeholder documentation for InputLocation" - }, - "InputLossActionForHlsOut": { - "type": "string", - "enum": [ - "EMIT_OUTPUT", - "PAUSE_OUTPUT" - ], - "documentation": "Placeholder documentation for InputLossActionForHlsOut" - }, - "InputLossActionForMsSmoothOut": { - "type": "string", - "enum": [ - "EMIT_OUTPUT", - "PAUSE_OUTPUT" - ], - "documentation": "Placeholder documentation for InputLossActionForMsSmoothOut" - }, - "InputLossActionForUdpOut": { - "type": "string", - "enum": [ - "DROP_PROGRAM", - "DROP_TS", - "EMIT_PROGRAM" - ], - "documentation": "Placeholder documentation for InputLossActionForUdpOut" - }, - "InputLossBehavior": { - "type": "structure", - "members": { - "BlackFrameMsec": { - "shape": "__integerMin0Max1000000", - "locationName": "blackFrameMsec", - "documentation": "Documentation update needed" - }, - "InputLossImageColor": { - "shape": "__stringMin6Max6", - "locationName": "inputLossImageColor", - "documentation": "When input loss image type is \"color\" this field specifies the color to use. Value: 6 hex characters representing the values of RGB." - }, - "InputLossImageSlate": { - "shape": "InputLocation", - "locationName": "inputLossImageSlate", - "documentation": "When input loss image type is \"slate\" these fields specify the parameters for accessing the slate." - }, - "InputLossImageType": { - "shape": "InputLossImageType", - "locationName": "inputLossImageType", - "documentation": "Indicates whether to substitute a solid color or a slate into the output after input loss exceeds blackFrameMsec." - }, - "RepeatFrameMsec": { - "shape": "__integerMin0Max1000000", - "locationName": "repeatFrameMsec", - "documentation": "Documentation update needed" - } - }, - "documentation": "Placeholder documentation for InputLossBehavior" - }, - "InputLossImageType": { - "type": "string", - "enum": [ - "COLOR", - "SLATE" - ], - "documentation": "Placeholder documentation for InputLossImageType" - }, - "InputMaximumBitrate": { - "type": "string", - "documentation": "Maximum input bitrate in megabits per second. Bitrates up to 50 Mbps are supported currently.", - "enum": [ - "MAX_10_MBPS", - "MAX_20_MBPS", - "MAX_50_MBPS" - ] - }, - "InputResolution": { - "type": "string", - "documentation": "Input resolution based on lines of vertical resolution in the input; SD is less than 720 lines, HD is 720 to 1080 lines, UHD is greater than 1080 lines\n", - "enum": [ - "SD", - "HD", - "UHD" - ] - }, - "InputSecurityGroup": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique ARN of Input Security Group" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The Id of the Input Security Group" - }, - "Inputs": { - "shape": "__listOf__string", - "locationName": "inputs", - "documentation": "The list of inputs currently using this Input Security Group." - }, - "State": { - "shape": "InputSecurityGroupState", - "locationName": "state", - "documentation": "The current state of the Input Security Group." - }, - "WhitelistRules": { - "shape": "__listOfInputWhitelistRule", - "locationName": "whitelistRules", - "documentation": "Whitelist rules and their sync status" - } - }, - "documentation": "An Input Security Group" - }, - "InputSecurityGroupState": { - "type": "string", - "enum": [ - "IDLE", - "IN_USE", - "UPDATING", - "DELETED" - ], - "documentation": "Placeholder documentation for InputSecurityGroupState" - }, - "InputSecurityGroupWhitelistRequest": { - "type": "structure", - "members": { - "WhitelistRules": { - "shape": "__listOfInputWhitelistRuleCidr", - "locationName": "whitelistRules", - "documentation": "List of IPv4 CIDR addresses to whitelist" - } - }, - "documentation": "Request of IPv4 CIDR addresses to whitelist in a security group." - }, - "InputSettings": { - "type": "structure", - "members": { - "AudioSelectors": { - "shape": "__listOfAudioSelector", - "locationName": "audioSelectors", - "documentation": "Used to select the audio stream to decode for inputs that have multiple available." - }, - "CaptionSelectors": { - "shape": "__listOfCaptionSelector", - "locationName": "captionSelectors", - "documentation": "Used to select the caption input to use for inputs that have multiple available." - }, - "DeblockFilter": { - "shape": "InputDeblockFilter", - "locationName": "deblockFilter", - "documentation": "Enable or disable the deblock filter when filtering." - }, - "DenoiseFilter": { - "shape": "InputDenoiseFilter", - "locationName": "denoiseFilter", - "documentation": "Enable or disable the denoise filter when filtering." - }, - "FilterStrength": { - "shape": "__integerMin1Max5", - "locationName": "filterStrength", - "documentation": "Adjusts the magnitude of filtering from 1 (minimal) to 5 (strongest)." - }, - "InputFilter": { - "shape": "InputFilter", - "locationName": "inputFilter", - "documentation": "Turns on the filter for this input. MPEG-2 inputs have the deblocking filter enabled by default.\n1) auto - filtering will be applied depending on input type/quality\n2) disabled - no filtering will be applied to the input\n3) forced - filtering will be applied regardless of input type" - }, - "NetworkInputSettings": { - "shape": "NetworkInputSettings", - "locationName": "networkInputSettings", - "documentation": "Input settings." - }, - "SourceEndBehavior": { - "shape": "InputSourceEndBehavior", - "locationName": "sourceEndBehavior", - "documentation": "Loop input if it is a file. This allows a file input to be streamed indefinitely." - }, - "VideoSelector": { - "shape": "VideoSelector", - "locationName": "videoSelector", - "documentation": "Informs which video elementary stream to decode for input types that have multiple available." - } - }, - "documentation": "Live Event input parameters. There can be multiple inputs in a single Live Event." - }, - "InputSource": { - "type": "structure", - "members": { - "PasswordParam": { - "shape": "__string", - "locationName": "passwordParam", - "documentation": "The key used to extract the password from EC2 Parameter store." - }, - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "This represents the customer's source URL where stream is\npulled from.\n" - }, - "Username": { - "shape": "__string", - "locationName": "username", - "documentation": "The username for the input source." - } - }, - "documentation": "The settings for a PULL type input." - }, - "InputSourceEndBehavior": { - "type": "string", - "enum": [ - "CONTINUE", - "LOOP" - ], - "documentation": "Placeholder documentation for InputSourceEndBehavior" - }, - "InputSourceRequest": { - "type": "structure", - "members": { - "PasswordParam": { - "shape": "__string", - "locationName": "passwordParam", - "documentation": "The key used to extract the password from EC2 Parameter store." - }, - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "This represents the customer's source URL where stream is\npulled from.\n" - }, - "Username": { - "shape": "__string", - "locationName": "username", - "documentation": "The username for the input source." - } - }, - "documentation": "Settings for for a PULL type input." - }, - "InputSpecification": { - "type": "structure", - "members": { - "Codec": { - "shape": "InputCodec", - "locationName": "codec", - "documentation": "Input codec" - }, - "MaximumBitrate": { - "shape": "InputMaximumBitrate", - "locationName": "maximumBitrate", - "documentation": "Maximum input bitrate, categorized coarsely" - }, - "Resolution": { - "shape": "InputResolution", - "locationName": "resolution", - "documentation": "Input resolution, categorized coarsely" - } - }, - "documentation": "Placeholder documentation for InputSpecification" - }, - "InputState": { - "type": "string", - "enum": [ - "CREATING", - "DETACHED", - "ATTACHED", - "DELETING", - "DELETED" - ], - "documentation": "Placeholder documentation for InputState" - }, - "InputType": { - "type": "string", - "enum": [ - "UDP_PUSH", - "RTP_PUSH", - "RTMP_PUSH", - "RTMP_PULL", - "URL_PULL" - ], - "documentation": "Placeholder documentation for InputType" - }, - "InputWhitelistRule": { - "type": "structure", - "members": { - "Cidr": { - "shape": "__string", - "locationName": "cidr", - "documentation": "The IPv4 CIDR that's whitelisted." - } - }, - "documentation": "Whitelist rule" - }, - "InputWhitelistRuleCidr": { - "type": "structure", - "members": { - "Cidr": { - "shape": "__string", - "locationName": "cidr", - "documentation": "The IPv4 CIDR to whitelist." - } - }, - "documentation": "An IPv4 CIDR to whitelist." - }, - "InternalServerErrorException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 500 - }, - "documentation": "Placeholder documentation for InternalServerErrorException" - }, - "InternalServiceError": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for InternalServiceError" - }, - "InvalidRequest": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for InvalidRequest" - }, - "KeyProviderSettings": { - "type": "structure", - "members": { - "StaticKeySettings": { - "shape": "StaticKeySettings", - "locationName": "staticKeySettings" - } - }, - "documentation": "Placeholder documentation for KeyProviderSettings" - }, - "LimitExceeded": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for LimitExceeded" - }, - "ListChannelsRequest": { - "type": "structure", - "members": { - "MaxResults": { - "shape": "MaxResults", - "location": "querystring", - "locationName": "maxResults" - }, - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListChannelsRequest" - }, - "ListChannelsResponse": { - "type": "structure", - "members": { - "Channels": { - "shape": "__listOfChannelSummary", - "locationName": "channels" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListChannelsResponse" - }, - "ListChannelsResultModel": { - "type": "structure", - "members": { - "Channels": { - "shape": "__listOfChannelSummary", - "locationName": "channels" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListChannelsResultModel" - }, - "ListInputSecurityGroupsRequest": { - "type": "structure", - "members": { - "MaxResults": { - "shape": "MaxResults", - "location": "querystring", - "locationName": "maxResults" - }, - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListInputSecurityGroupsRequest" - }, - "ListInputSecurityGroupsResponse": { - "type": "structure", - "members": { - "InputSecurityGroups": { - "shape": "__listOfInputSecurityGroup", - "locationName": "inputSecurityGroups", - "documentation": "List of input security groups" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListInputSecurityGroupsResponse" - }, - "ListInputSecurityGroupsResultModel": { - "type": "structure", - "members": { - "InputSecurityGroups": { - "shape": "__listOfInputSecurityGroup", - "locationName": "inputSecurityGroups", - "documentation": "List of input security groups" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Result of input security group list request" - }, - "ListInputsRequest": { - "type": "structure", - "members": { - "MaxResults": { - "shape": "MaxResults", - "location": "querystring", - "locationName": "maxResults" - }, - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListInputsRequest" - }, - "ListInputsResponse": { - "type": "structure", - "members": { - "Inputs": { - "shape": "__listOfInput", - "locationName": "inputs" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListInputsResponse" - }, - "ListInputsResultModel": { - "type": "structure", - "members": { - "Inputs": { - "shape": "__listOfInput", - "locationName": "inputs" - }, - "NextToken": { - "shape": "__string", - "locationName": "nextToken" - } - }, - "documentation": "Placeholder documentation for ListInputsResultModel" - }, - "ListOfferingsRequest": { - "type": "structure", - "members": { - "ChannelConfiguration": { - "shape": "__string", - "location": "querystring", - "locationName": "channelConfiguration", - "documentation": "Filter to offerings that match the configuration of an existing channel, e.g. '2345678' (a channel ID)\n" - }, - "Codec": { - "shape": "__string", - "location": "querystring", - "locationName": "codec", - "documentation": "Filter by codec, 'AVC', 'HEVC', 'MPEG2', or 'AUDIO'" - }, - "MaxResults": { - "shape": "MaxResults", - "location": "querystring", - "locationName": "maxResults" - }, - "MaximumBitrate": { - "shape": "__string", - "location": "querystring", - "locationName": "maximumBitrate", - "documentation": "Filter by bitrate, 'MAX_10_MBPS', 'MAX_20_MBPS', or 'MAX_50_MBPS'\n" - }, - "MaximumFramerate": { - "shape": "__string", - "location": "querystring", - "locationName": "maximumFramerate", - "documentation": "Filter by framerate, 'MAX_30_FPS' or 'MAX_60_FPS'" - }, - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "nextToken" - }, - "Resolution": { - "shape": "__string", - "location": "querystring", - "locationName": "resolution", - "documentation": "Filter by resolution, 'SD', 'HD', or 'UHD'" - }, - "ResourceType": { - "shape": "__string", - "location": "querystring", - "locationName": "resourceType", - "documentation": "Filter by resource type, 'INPUT', 'OUTPUT', or 'CHANNEL'" - }, - "SpecialFeature": { - "shape": "__string", - "location": "querystring", - "locationName": "specialFeature", - "documentation": "Filter by special feature, 'ADVANCED_AUDIO' or 'AUDIO_NORMALIZATION'\n" - }, - "VideoQuality": { - "shape": "__string", - "location": "querystring", - "locationName": "videoQuality", - "documentation": "Filter by video quality, 'STANDARD', 'ENHANCED', or 'PREMIUM'\n" - } - }, - "documentation": "Placeholder documentation for ListOfferingsRequest" - }, - "ListOfferingsResponse": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Token to retrieve the next page of results" - }, - "Offerings": { - "shape": "__listOfOffering", - "locationName": "offerings", - "documentation": "List of offerings" - } - }, - "documentation": "Placeholder documentation for ListOfferingsResponse" - }, - "ListOfferingsResultModel": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Token to retrieve the next page of results" - }, - "Offerings": { - "shape": "__listOfOffering", - "locationName": "offerings", - "documentation": "List of offerings" - } - }, - "documentation": "ListOfferings response" - }, - "ListReservationsRequest": { - "type": "structure", - "members": { - "Codec": { - "shape": "__string", - "location": "querystring", - "locationName": "codec", - "documentation": "Filter by codec, 'AVC', 'HEVC', 'MPEG2', or 'AUDIO'" - }, - "MaxResults": { - "shape": "MaxResults", - "location": "querystring", - "locationName": "maxResults" - }, - "MaximumBitrate": { - "shape": "__string", - "location": "querystring", - "locationName": "maximumBitrate", - "documentation": "Filter by bitrate, 'MAX_10_MBPS', 'MAX_20_MBPS', or 'MAX_50_MBPS'\n" - }, - "MaximumFramerate": { - "shape": "__string", - "location": "querystring", - "locationName": "maximumFramerate", - "documentation": "Filter by framerate, 'MAX_30_FPS' or 'MAX_60_FPS'" - }, - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "nextToken" - }, - "Resolution": { - "shape": "__string", - "location": "querystring", - "locationName": "resolution", - "documentation": "Filter by resolution, 'SD', 'HD', or 'UHD'" - }, - "ResourceType": { - "shape": "__string", - "location": "querystring", - "locationName": "resourceType", - "documentation": "Filter by resource type, 'INPUT', 'OUTPUT', or 'CHANNEL'" - }, - "SpecialFeature": { - "shape": "__string", - "location": "querystring", - "locationName": "specialFeature", - "documentation": "Filter by special feature, 'ADVANCED_AUDIO' or 'AUDIO_NORMALIZATION'\n" - }, - "VideoQuality": { - "shape": "__string", - "location": "querystring", - "locationName": "videoQuality", - "documentation": "Filter by video quality, 'STANDARD', 'ENHANCED', or 'PREMIUM'\n" - } - }, - "documentation": "Placeholder documentation for ListReservationsRequest" - }, - "ListReservationsResponse": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Token to retrieve the next page of results" - }, - "Reservations": { - "shape": "__listOfReservation", - "locationName": "reservations", - "documentation": "List of reservations" - } - }, - "documentation": "Placeholder documentation for ListReservationsResponse" - }, - "ListReservationsResultModel": { - "type": "structure", - "members": { - "NextToken": { - "shape": "__string", - "locationName": "nextToken", - "documentation": "Token to retrieve the next page of results" - }, - "Reservations": { - "shape": "__listOfReservation", - "locationName": "reservations", - "documentation": "List of reservations" - } - }, - "documentation": "ListReservations response" - }, - "LogLevel": { - "type": "string", - "enum": [ - "ERROR", - "WARNING", - "INFO", - "DEBUG", - "DISABLED" - ], - "documentation": "The log level the user wants for their channel." - }, - "M2tsAbsentInputAudioBehavior": { - "type": "string", - "enum": [ - "DROP", - "ENCODE_SILENCE" - ], - "documentation": "Placeholder documentation for M2tsAbsentInputAudioBehavior" - }, - "M2tsArib": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for M2tsArib" - }, - "M2tsAribCaptionsPidControl": { - "type": "string", - "enum": [ - "AUTO", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for M2tsAribCaptionsPidControl" - }, - "M2tsAudioBufferModel": { - "type": "string", - "enum": [ - "ATSC", - "DVB" - ], - "documentation": "Placeholder documentation for M2tsAudioBufferModel" - }, - "M2tsAudioInterval": { - "type": "string", - "enum": [ - "VIDEO_AND_FIXED_INTERVALS", - "VIDEO_INTERVAL" - ], - "documentation": "Placeholder documentation for M2tsAudioInterval" - }, - "M2tsAudioStreamType": { - "type": "string", - "enum": [ - "ATSC", - "DVB" - ], - "documentation": "Placeholder documentation for M2tsAudioStreamType" - }, - "M2tsBufferModel": { - "type": "string", - "enum": [ - "MULTIPLEX", - "NONE" - ], - "documentation": "Placeholder documentation for M2tsBufferModel" - }, - "M2tsCcDescriptor": { - "type": "string", - "enum": [ - "DISABLED", - "ENABLED" - ], - "documentation": "Placeholder documentation for M2tsCcDescriptor" - }, - "M2tsEbifControl": { - "type": "string", - "enum": [ - "NONE", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M2tsEbifControl" - }, - "M2tsEbpPlacement": { - "type": "string", - "enum": [ - "VIDEO_AND_AUDIO_PIDS", - "VIDEO_PID" - ], - "documentation": "Placeholder documentation for M2tsEbpPlacement" - }, - "M2tsEsRateInPes": { - "type": "string", - "enum": [ - "EXCLUDE", - "INCLUDE" - ], - "documentation": "Placeholder documentation for M2tsEsRateInPes" - }, - "M2tsKlv": { - "type": "string", - "enum": [ - "NONE", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M2tsKlv" - }, - "M2tsPcrControl": { - "type": "string", - "enum": [ - "CONFIGURED_PCR_PERIOD", - "PCR_EVERY_PES_PACKET" - ], - "documentation": "Placeholder documentation for M2tsPcrControl" - }, - "M2tsRateMode": { - "type": "string", - "enum": [ - "CBR", - "VBR" - ], - "documentation": "Placeholder documentation for M2tsRateMode" - }, - "M2tsScte35Control": { - "type": "string", - "enum": [ - "NONE", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M2tsScte35Control" - }, - "M2tsSegmentationMarkers": { - "type": "string", - "enum": [ - "EBP", - "EBP_LEGACY", - "NONE", - "PSI_SEGSTART", - "RAI_ADAPT", - "RAI_SEGSTART" - ], - "documentation": "Placeholder documentation for M2tsSegmentationMarkers" - }, - "M2tsSegmentationStyle": { - "type": "string", - "enum": [ - "MAINTAIN_CADENCE", - "RESET_CADENCE" - ], - "documentation": "Placeholder documentation for M2tsSegmentationStyle" - }, - "M2tsSettings": { - "type": "structure", - "members": { - "AbsentInputAudioBehavior": { - "shape": "M2tsAbsentInputAudioBehavior", - "locationName": "absentInputAudioBehavior", - "documentation": "When set to drop, output audio streams will be removed from the program if the selected input audio stream is removed from the input. This allows the output audio configuration to dynamically change based on input configuration. If this is set to encodeSilence, all output audio streams will output encoded silence when not connected to an active input stream." - }, - "Arib": { - "shape": "M2tsArib", - "locationName": "arib", - "documentation": "When set to enabled, uses ARIB-compliant field muxing and removes video descriptor." - }, - "AribCaptionsPid": { - "shape": "__string", - "locationName": "aribCaptionsPid", - "documentation": "Packet Identifier (PID) for ARIB Captions in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "AribCaptionsPidControl": { - "shape": "M2tsAribCaptionsPidControl", - "locationName": "aribCaptionsPidControl", - "documentation": "If set to auto, pid number used for ARIB Captions will be auto-selected from unused pids. If set to useConfigured, ARIB Captions will be on the configured pid number." - }, - "AudioBufferModel": { - "shape": "M2tsAudioBufferModel", - "locationName": "audioBufferModel", - "documentation": "When set to dvb, uses DVB buffer model for Dolby Digital audio. When set to atsc, the ATSC model is used." - }, - "AudioFramesPerPes": { - "shape": "__integerMin0", - "locationName": "audioFramesPerPes", - "documentation": "The number of audio frames to insert for each PES packet." - }, - "AudioPids": { - "shape": "__string", - "locationName": "audioPids", - "documentation": "Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation. Can be entered as decimal or hexadecimal values. Each PID specified must be in the range of 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "AudioStreamType": { - "shape": "M2tsAudioStreamType", - "locationName": "audioStreamType", - "documentation": "When set to atsc, uses stream type = 0x81 for AC3 and stream type = 0x87 for EAC3. When set to dvb, uses stream type = 0x06." - }, - "Bitrate": { - "shape": "__integerMin0", - "locationName": "bitrate", - "documentation": "The output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate." - }, - "BufferModel": { - "shape": "M2tsBufferModel", - "locationName": "bufferModel", - "documentation": "If set to multiplex, use multiplex buffer model for accurate interleaving. Setting to bufferModel to none can lead to lower latency, but low-memory devices may not be able to play back the stream without interruptions." - }, - "CcDescriptor": { - "shape": "M2tsCcDescriptor", - "locationName": "ccDescriptor", - "documentation": "When set to enabled, generates captionServiceDescriptor in PMT." - }, - "DvbNitSettings": { - "shape": "DvbNitSettings", - "locationName": "dvbNitSettings", - "documentation": "Inserts DVB Network Information Table (NIT) at the specified table repetition interval." - }, - "DvbSdtSettings": { - "shape": "DvbSdtSettings", - "locationName": "dvbSdtSettings", - "documentation": "Inserts DVB Service Description Table (SDT) at the specified table repetition interval." - }, - "DvbSubPids": { - "shape": "__string", - "locationName": "dvbSubPids", - "documentation": "Packet Identifier (PID) for input source DVB Subtitle data to this output. Multiple values are accepted, and can be entered in ranges and/or by comma separation. Can be entered as decimal or hexadecimal values. Each PID specified must be in the range of 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "DvbTdtSettings": { - "shape": "DvbTdtSettings", - "locationName": "dvbTdtSettings", - "documentation": "Inserts DVB Time and Date Table (TDT) at the specified table repetition interval." - }, - "DvbTeletextPid": { - "shape": "__string", - "locationName": "dvbTeletextPid", - "documentation": "Packet Identifier (PID) for input source DVB Teletext data to this output. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "Ebif": { - "shape": "M2tsEbifControl", - "locationName": "ebif", - "documentation": "If set to passthrough, passes any EBIF data from the input source to this output." - }, - "EbpAudioInterval": { - "shape": "M2tsAudioInterval", - "locationName": "ebpAudioInterval", - "documentation": "When videoAndFixedIntervals is selected, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. Only available when EBP Cablelabs segmentation markers are selected. Partitions 1 and 2 will always follow the video interval." - }, - "EbpLookaheadMs": { - "shape": "__integerMin0Max10000", - "locationName": "ebpLookaheadMs", - "documentation": "When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is \"stretched\" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate." - }, - "EbpPlacement": { - "shape": "M2tsEbpPlacement", - "locationName": "ebpPlacement", - "documentation": "Controls placement of EBP on Audio PIDs. If set to videoAndAudioPids, EBP markers will be placed on the video PID and all audio PIDs. If set to videoPid, EBP markers will be placed on only the video PID." - }, - "EcmPid": { - "shape": "__string", - "locationName": "ecmPid", - "documentation": "This field is unused and deprecated." - }, - "EsRateInPes": { - "shape": "M2tsEsRateInPes", - "locationName": "esRateInPes", - "documentation": "Include or exclude the ES Rate field in the PES header." - }, - "EtvPlatformPid": { - "shape": "__string", - "locationName": "etvPlatformPid", - "documentation": "Packet Identifier (PID) for input source ETV Platform data to this output. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "EtvSignalPid": { - "shape": "__string", - "locationName": "etvSignalPid", - "documentation": "Packet Identifier (PID) for input source ETV Signal data to this output. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "FragmentTime": { - "shape": "__doubleMin0", - "locationName": "fragmentTime", - "documentation": "The length in seconds of each fragment. Only used with EBP markers." - }, - "Klv": { - "shape": "M2tsKlv", - "locationName": "klv", - "documentation": "If set to passthrough, passes any KLV data from the input source to this output." - }, - "KlvDataPids": { - "shape": "__string", - "locationName": "klvDataPids", - "documentation": "Packet Identifier (PID) for input source KLV data to this output. Multiple values are accepted, and can be entered in ranges and/or by comma separation. Can be entered as decimal or hexadecimal values. Each PID specified must be in the range of 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "NullPacketBitrate": { - "shape": "__doubleMin0", - "locationName": "nullPacketBitrate", - "documentation": "Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets." - }, - "PatInterval": { - "shape": "__integerMin0Max1000", - "locationName": "patInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream. Valid values are 0, 10..1000." - }, - "PcrControl": { - "shape": "M2tsPcrControl", - "locationName": "pcrControl", - "documentation": "When set to pcrEveryPesPacket, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream." - }, - "PcrPeriod": { - "shape": "__integerMin0Max500", - "locationName": "pcrPeriod", - "documentation": "Maximum time in milliseconds between Program Clock Reference (PCRs) inserted into the transport stream." - }, - "PcrPid": { - "shape": "__string", - "locationName": "pcrPid", - "documentation": "Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "PmtInterval": { - "shape": "__integerMin0Max1000", - "locationName": "pmtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream. Valid values are 0, 10..1000." - }, - "PmtPid": { - "shape": "__string", - "locationName": "pmtPid", - "documentation": "Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "ProgramNum": { - "shape": "__integerMin0Max65535", - "locationName": "programNum", - "documentation": "The value of the program number field in the Program Map Table." - }, - "RateMode": { - "shape": "M2tsRateMode", - "locationName": "rateMode", - "documentation": "When vbr, does not insert null packets into transport stream to fill specified bitrate. The bitrate setting acts as the maximum bitrate when vbr is set." - }, - "Scte27Pids": { - "shape": "__string", - "locationName": "scte27Pids", - "documentation": "Packet Identifier (PID) for input source SCTE-27 data to this output. Multiple values are accepted, and can be entered in ranges and/or by comma separation. Can be entered as decimal or hexadecimal values. Each PID specified must be in the range of 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "Scte35Control": { - "shape": "M2tsScte35Control", - "locationName": "scte35Control", - "documentation": "Optionally pass SCTE-35 signals from the input source to this output." - }, - "Scte35Pid": { - "shape": "__string", - "locationName": "scte35Pid", - "documentation": "Packet Identifier (PID) of the SCTE-35 stream in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "SegmentationMarkers": { - "shape": "M2tsSegmentationMarkers", - "locationName": "segmentationMarkers", - "documentation": "Inserts segmentation markers at each segmentationTime period. raiSegstart sets the Random Access Indicator bit in the adaptation field. raiAdapt sets the RAI bit and adds the current timecode in the private data bytes. psiSegstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebpLegacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format." - }, - "SegmentationStyle": { - "shape": "M2tsSegmentationStyle", - "locationName": "segmentationStyle", - "documentation": "The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted.\n\nWhen a segmentation style of \"resetCadence\" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of $segmentationTime seconds.\n\nWhen a segmentation style of \"maintainCadence\" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentationTime seconds. Note that EBP lookahead is a slight exception to this rule." - }, - "SegmentationTime": { - "shape": "__doubleMin1", - "locationName": "segmentationTime", - "documentation": "The length in seconds of each segment. Required unless markers is set to None_." - }, - "TimedMetadataBehavior": { - "shape": "M2tsTimedMetadataBehavior", - "locationName": "timedMetadataBehavior", - "documentation": "When set to passthrough, timed metadata will be passed through from input to output." - }, - "TimedMetadataPid": { - "shape": "__string", - "locationName": "timedMetadataPid", - "documentation": "Packet Identifier (PID) of the timed metadata stream in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "TransportStreamId": { - "shape": "__integerMin0Max65535", - "locationName": "transportStreamId", - "documentation": "The value of the transport stream ID field in the Program Map Table." - }, - "VideoPid": { - "shape": "__string", - "locationName": "videoPid", - "documentation": "Packet Identifier (PID) of the elementary video stream in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - } - }, - "documentation": "Placeholder documentation for M2tsSettings" - }, - "M2tsTimedMetadataBehavior": { - "type": "string", - "enum": [ - "NO_PASSTHROUGH", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M2tsTimedMetadataBehavior" - }, - "M3u8PcrControl": { - "type": "string", - "enum": [ - "CONFIGURED_PCR_PERIOD", - "PCR_EVERY_PES_PACKET" - ], - "documentation": "Placeholder documentation for M3u8PcrControl" - }, - "M3u8Scte35Behavior": { - "type": "string", - "enum": [ - "NO_PASSTHROUGH", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M3u8Scte35Behavior" - }, - "M3u8Settings": { - "type": "structure", - "members": { - "AudioFramesPerPes": { - "shape": "__integerMin0", - "locationName": "audioFramesPerPes", - "documentation": "The number of audio frames to insert for each PES packet." - }, - "AudioPids": { - "shape": "__string", - "locationName": "audioPids", - "documentation": "Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation. Can be entered as decimal or hexadecimal values." - }, - "EcmPid": { - "shape": "__string", - "locationName": "ecmPid", - "documentation": "This parameter is unused and deprecated." - }, - "PatInterval": { - "shape": "__integerMin0Max1000", - "locationName": "patInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream. A value of \\\"0\\\" writes out the PMT once per segment file." - }, - "PcrControl": { - "shape": "M3u8PcrControl", - "locationName": "pcrControl", - "documentation": "When set to pcrEveryPesPacket, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream." - }, - "PcrPeriod": { - "shape": "__integerMin0Max500", - "locationName": "pcrPeriod", - "documentation": "Maximum time in milliseconds between Program Clock References (PCRs) inserted into the transport stream." - }, - "PcrPid": { - "shape": "__string", - "locationName": "pcrPid", - "documentation": "Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID. Can be entered as a decimal or hexadecimal value." - }, - "PmtInterval": { - "shape": "__integerMin0Max1000", - "locationName": "pmtInterval", - "documentation": "The number of milliseconds between instances of this table in the output transport stream. A value of \\\"0\\\" writes out the PMT once per segment file." - }, - "PmtPid": { - "shape": "__string", - "locationName": "pmtPid", - "documentation": "Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream. Can be entered as a decimal or hexadecimal value." - }, - "ProgramNum": { - "shape": "__integerMin0Max65535", - "locationName": "programNum", - "documentation": "The value of the program number field in the Program Map Table." - }, - "Scte35Behavior": { - "shape": "M3u8Scte35Behavior", - "locationName": "scte35Behavior", - "documentation": "If set to passthrough, passes any SCTE-35 signals from the input source to this output." - }, - "Scte35Pid": { - "shape": "__string", - "locationName": "scte35Pid", - "documentation": "Packet Identifier (PID) of the SCTE-35 stream in the transport stream. Can be entered as a decimal or hexadecimal value." - }, - "TimedMetadataBehavior": { - "shape": "M3u8TimedMetadataBehavior", - "locationName": "timedMetadataBehavior", - "documentation": "When set to passthrough, timed metadata is passed through from input to output." - }, - "TimedMetadataPid": { - "shape": "__string", - "locationName": "timedMetadataPid", - "documentation": "Packet Identifier (PID) of the timed metadata stream in the transport stream. Can be entered as a decimal or hexadecimal value. Valid values are 32 (or 0x20)..8182 (or 0x1ff6)." - }, - "TransportStreamId": { - "shape": "__integerMin0Max65535", - "locationName": "transportStreamId", - "documentation": "The value of the transport stream ID field in the Program Map Table." - }, - "VideoPid": { - "shape": "__string", - "locationName": "videoPid", - "documentation": "Packet Identifier (PID) of the elementary video stream in the transport stream. Can be entered as a decimal or hexadecimal value." - } - }, - "documentation": "Settings information for the .m3u8 container" - }, - "M3u8TimedMetadataBehavior": { - "type": "string", - "enum": [ - "NO_PASSTHROUGH", - "PASSTHROUGH" - ], - "documentation": "Placeholder documentation for M3u8TimedMetadataBehavior" - }, - "MaxResults": { - "type": "integer", - "min": 1, - "max": 1000, - "documentation": "Placeholder documentation for MaxResults" - }, - "Mp2CodingMode": { - "type": "string", - "enum": [ - "CODING_MODE_1_0", - "CODING_MODE_2_0" - ], - "documentation": "Placeholder documentation for Mp2CodingMode" - }, - "Mp2Settings": { - "type": "structure", - "members": { - "Bitrate": { - "shape": "__double", - "locationName": "bitrate", - "documentation": "Average bitrate in bits/second." - }, - "CodingMode": { - "shape": "Mp2CodingMode", - "locationName": "codingMode", - "documentation": "The MPEG2 Audio coding mode. Valid values are codingMode10 (for mono) or codingMode20 (for stereo)." - }, - "SampleRate": { - "shape": "__double", - "locationName": "sampleRate", - "documentation": "Sample rate in Hz." - } - }, - "documentation": "Placeholder documentation for Mp2Settings" - }, - "MsSmoothGroupSettings": { - "type": "structure", - "members": { - "AcquisitionPointId": { - "shape": "__string", - "locationName": "acquisitionPointId", - "documentation": "The value of the \"Acquisition Point Identity\" element used in each message placed in the sparse track. Only enabled if sparseTrackType is not \"none\"." - }, - "AudioOnlyTimecodeControl": { - "shape": "SmoothGroupAudioOnlyTimecodeControl", - "locationName": "audioOnlyTimecodeControl", - "documentation": "If set to passthrough for an audio-only MS Smooth output, the fragment absolute time will be set to the current timecode. This option does not write timecodes to the audio elementary stream." - }, - "CertificateMode": { - "shape": "SmoothGroupCertificateMode", - "locationName": "certificateMode", - "documentation": "If set to verifyAuthenticity, verify the https certificate chain to a trusted Certificate Authority (CA). This will cause https outputs to self-signed certificates to fail." - }, - "ConnectionRetryInterval": { - "shape": "__integerMin0", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying connection to the IIS server if the connection is lost. Content will be cached during this time and the cache will be be delivered to the IIS server once the connection is re-established." - }, - "Destination": { - "shape": "OutputLocationRef", - "locationName": "destination", - "documentation": "Smooth Streaming publish point on an IIS server. Elemental Live acts as a \"Push\" encoder to IIS." - }, - "EventId": { - "shape": "__string", - "locationName": "eventId", - "documentation": "MS Smooth event ID to be sent to the IIS server.\n\nShould only be specified if eventIdMode is set to useConfigured." - }, - "EventIdMode": { - "shape": "SmoothGroupEventIdMode", - "locationName": "eventIdMode", - "documentation": "Specifies whether or not to send an event ID to the IIS server. If no event ID is sent and the same Live Event is used without changing the publishing point, clients might see cached video from the previous run.\n\nOptions:\n- \"useConfigured\" - use the value provided in eventId\n- \"useTimestamp\" - generate and send an event ID based on the current timestamp\n- \"noEventId\" - do not send an event ID to the IIS server." - }, - "EventStopBehavior": { - "shape": "SmoothGroupEventStopBehavior", - "locationName": "eventStopBehavior", - "documentation": "When set to sendEos, send EOS signal to IIS server when stopping the event" - }, - "FilecacheDuration": { - "shape": "__integerMin0", - "locationName": "filecacheDuration", - "documentation": "Size in seconds of file cache for streaming outputs." - }, - "FragmentLength": { - "shape": "__integerMin1", - "locationName": "fragmentLength", - "documentation": "Length of mp4 fragments to generate (in seconds). Fragment length must be compatible with GOP size and framerate." - }, - "InputLossAction": { - "shape": "InputLossActionForMsSmoothOut", - "locationName": "inputLossAction", - "documentation": "Parameter that control output group behavior on input loss." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts." - }, - "RestartDelay": { - "shape": "__integerMin0", - "locationName": "restartDelay", - "documentation": "Number of seconds before initiating a restart due to output failure, due to exhausting the numRetries on one segment, or exceeding filecacheDuration." - }, - "SegmentationMode": { - "shape": "SmoothGroupSegmentationMode", - "locationName": "segmentationMode", - "documentation": "When set to useInputSegmentation, the output segment or fragment points are set by the RAI markers from the input streams." - }, - "SendDelayMs": { - "shape": "__integerMin0Max10000", - "locationName": "sendDelayMs", - "documentation": "Outputs that are \"output locked\" can use this delay. Assign a delay to the output that is \"secondary\". Do not assign a delay to the \"primary\" output. The delay means that the primary output will always reach the downstream system before the secondary, which helps ensure that the downstream system always uses the primary output. (If there were no delay, the downstream system might flip-flop between whichever output happens to arrive first.) If the primary fails, the downstream system will switch to the secondary output. When the primary is restarted, the downstream system will switch back to the primary (because once again it is always arriving first)" - }, - "SparseTrackType": { - "shape": "SmoothGroupSparseTrackType", - "locationName": "sparseTrackType", - "documentation": "If set to scte35, use incoming SCTE-35 messages to generate a sparse track in this group of MS-Smooth outputs." - }, - "StreamManifestBehavior": { - "shape": "SmoothGroupStreamManifestBehavior", - "locationName": "streamManifestBehavior", - "documentation": "When set to send, send stream manifest so publishing point doesn't start until all streams start." - }, - "TimestampOffset": { - "shape": "__string", - "locationName": "timestampOffset", - "documentation": "Timestamp offset for the event. Only used if timestampOffsetMode is set to useConfiguredOffset." - }, - "TimestampOffsetMode": { - "shape": "SmoothGroupTimestampOffsetMode", - "locationName": "timestampOffsetMode", - "documentation": "Type of timestamp date offset to use.\n- useEventStartDate: Use the date the event was started as the offset\n- useConfiguredOffset: Use an explicitly configured date as the offset" - } - }, - "required": [ - "Destination" - ], - "documentation": "Placeholder documentation for MsSmoothGroupSettings" - }, - "MsSmoothOutputSettings": { - "type": "structure", - "members": { - "NameModifier": { - "shape": "__string", - "locationName": "nameModifier", - "documentation": "String concatenated to the end of the destination filename. Required for multiple outputs of the same type." - } - }, - "documentation": "Placeholder documentation for MsSmoothOutputSettings" - }, - "NetworkInputServerValidation": { - "type": "string", - "enum": [ - "CHECK_CRYPTOGRAPHY_AND_VALIDATE_NAME", - "CHECK_CRYPTOGRAPHY_ONLY" - ], - "documentation": "Placeholder documentation for NetworkInputServerValidation" - }, - "NetworkInputSettings": { - "type": "structure", - "members": { - "HlsInputSettings": { - "shape": "HlsInputSettings", - "locationName": "hlsInputSettings", - "documentation": "Specifies HLS input settings when the uri is for a HLS manifest." - }, - "ServerValidation": { - "shape": "NetworkInputServerValidation", - "locationName": "serverValidation", - "documentation": "Check HTTPS server certificates. When set to checkCryptographyOnly, cryptography in the certificate will be checked, but not the server's name. Certain subdomains (notably S3 buckets that use dots in the bucket name) do not strictly match the corresponding certificate's wildcard pattern and would otherwise cause the event to error. This setting is ignored for protocols that do not use https." - } - }, - "documentation": "Network source to transcode. Must be accessible to the Elemental Live node that is running the live event through a network connection." - }, - "NotFoundException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 404 - }, - "documentation": "Placeholder documentation for NotFoundException" - }, - "Offering": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique offering ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:offering:87654321'" - }, - "CurrencyCode": { - "shape": "__string", - "locationName": "currencyCode", - "documentation": "Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'" - }, - "Duration": { - "shape": "__integer", - "locationName": "duration", - "documentation": "Lease duration, e.g. '12'" - }, - "DurationUnits": { - "shape": "OfferingDurationUnits", - "locationName": "durationUnits", - "documentation": "Units for duration, e.g. 'MONTHS'" - }, - "FixedPrice": { - "shape": "__double", - "locationName": "fixedPrice", - "documentation": "One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering" - }, - "OfferingDescription": { - "shape": "__string", - "locationName": "offeringDescription", - "documentation": "Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'" - }, - "OfferingId": { - "shape": "__string", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - }, - "OfferingType": { - "shape": "OfferingType", - "locationName": "offeringType", - "documentation": "Offering type, e.g. 'NO_UPFRONT'" - }, - "Region": { - "shape": "__string", - "locationName": "region", - "documentation": "AWS region, e.g. 'us-west-2'" - }, - "ResourceSpecification": { - "shape": "ReservationResourceSpecification", - "locationName": "resourceSpecification", - "documentation": "Resource configuration details" - }, - "UsagePrice": { - "shape": "__double", - "locationName": "usagePrice", - "documentation": "Recurring usage charge for each reserved resource, e.g. '157.0'" - } - }, - "documentation": "Reserved resources available for purchase" - }, - "OfferingDurationUnits": { - "type": "string", - "documentation": "Units for duration, e.g. 'MONTHS'", - "enum": [ - "MONTHS" - ] - }, - "OfferingType": { - "type": "string", - "documentation": "Offering type, e.g. 'NO_UPFRONT'", - "enum": [ - "NO_UPFRONT" - ] - }, - "Output": { - "type": "structure", - "members": { - "AudioDescriptionNames": { - "shape": "__listOf__string", - "locationName": "audioDescriptionNames", - "documentation": "The names of the AudioDescriptions used as audio sources for this output." - }, - "CaptionDescriptionNames": { - "shape": "__listOf__string", - "locationName": "captionDescriptionNames", - "documentation": "The names of the CaptionDescriptions used as caption sources for this output." - }, - "OutputName": { - "shape": "__stringMin1Max255", - "locationName": "outputName", - "documentation": "The name used to identify an output." - }, - "OutputSettings": { - "shape": "OutputSettings", - "locationName": "outputSettings", - "documentation": "Output type-specific settings." - }, - "VideoDescriptionName": { - "shape": "__string", - "locationName": "videoDescriptionName", - "documentation": "The name of the VideoDescription used as the source for this output." - } - }, - "documentation": "Output settings. There can be multiple outputs within a group.", - "required": [ - "OutputSettings" - ] - }, - "OutputDestination": { - "type": "structure", - "members": { - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "User-specified id. This is used in an output group or an output." - }, - "Settings": { - "shape": "__listOfOutputDestinationSettings", - "locationName": "settings", - "documentation": "Destination settings for output; one for each redundant encoder." - } - }, - "documentation": "Placeholder documentation for OutputDestination" - }, - "OutputDestinationSettings": { - "type": "structure", - "members": { - "PasswordParam": { - "shape": "__string", - "locationName": "passwordParam", - "documentation": "key used to extract the password from EC2 Parameter store" - }, - "StreamName": { - "shape": "__string", - "locationName": "streamName", - "documentation": "Stream name for RTMP destinations (URLs of type rtmp://)" - }, - "Url": { - "shape": "__string", - "locationName": "url", - "documentation": "A URL specifying a destination" - }, - "Username": { - "shape": "__string", - "locationName": "username", - "documentation": "username for destination" - } - }, - "documentation": "Placeholder documentation for OutputDestinationSettings" - }, - "OutputGroup": { - "type": "structure", - "members": { - "Name": { - "shape": "__stringMax32", - "locationName": "name", - "documentation": "Custom output group name optionally defined by the user. Only letters, numbers, and the underscore character allowed; only 32 characters allowed." - }, - "OutputGroupSettings": { - "shape": "OutputGroupSettings", - "locationName": "outputGroupSettings", - "documentation": "Settings associated with the output group." - }, - "Outputs": { - "shape": "__listOfOutput", - "locationName": "outputs" - } - }, - "documentation": "Output groups for this Live Event. Output groups contain information about where streams should be distributed.", - "required": [ - "Outputs", - "OutputGroupSettings" - ] - }, - "OutputGroupSettings": { - "type": "structure", - "members": { - "ArchiveGroupSettings": { - "shape": "ArchiveGroupSettings", - "locationName": "archiveGroupSettings" - }, - "HlsGroupSettings": { - "shape": "HlsGroupSettings", - "locationName": "hlsGroupSettings" - }, - "MsSmoothGroupSettings": { - "shape": "MsSmoothGroupSettings", - "locationName": "msSmoothGroupSettings" - }, - "RtmpGroupSettings": { - "shape": "RtmpGroupSettings", - "locationName": "rtmpGroupSettings" - }, - "UdpGroupSettings": { - "shape": "UdpGroupSettings", - "locationName": "udpGroupSettings" - } - }, - "documentation": "Placeholder documentation for OutputGroupSettings" - }, - "OutputLocationRef": { - "type": "structure", - "members": { - "DestinationRefId": { - "shape": "__string", - "locationName": "destinationRefId" - } - }, - "documentation": "Reference to an OutputDestination ID defined in the channel" - }, - "OutputSettings": { - "type": "structure", - "members": { - "ArchiveOutputSettings": { - "shape": "ArchiveOutputSettings", - "locationName": "archiveOutputSettings" - }, - "HlsOutputSettings": { - "shape": "HlsOutputSettings", - "locationName": "hlsOutputSettings" - }, - "MsSmoothOutputSettings": { - "shape": "MsSmoothOutputSettings", - "locationName": "msSmoothOutputSettings" - }, - "RtmpOutputSettings": { - "shape": "RtmpOutputSettings", - "locationName": "rtmpOutputSettings" - }, - "UdpOutputSettings": { - "shape": "UdpOutputSettings", - "locationName": "udpOutputSettings" - } - }, - "documentation": "Placeholder documentation for OutputSettings" - }, - "PassThroughSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for PassThroughSettings" - }, - "PurchaseOffering": { - "type": "structure", - "members": { - "Count": { - "shape": "__integerMin1", - "locationName": "count", - "documentation": "Number of resources" - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name for the new reservation" - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique request ID to be specified. This is needed to prevent retries from creating multiple resources.", - "idempotencyToken": true - } - }, - "documentation": "PurchaseOffering request" - }, - "PurchaseOfferingRequest": { - "type": "structure", - "members": { - "Count": { - "shape": "__integerMin1", - "locationName": "count", - "documentation": "Number of resources" - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name for the new reservation" - }, - "OfferingId": { - "shape": "__string", - "location": "uri", - "locationName": "offeringId", - "documentation": "Offering to purchase, e.g. '87654321'" - }, - "RequestId": { - "shape": "__string", - "locationName": "requestId", - "documentation": "Unique request ID to be specified. This is needed to prevent retries from creating multiple resources.", - "idempotencyToken": true - } - }, - "required": [ - "OfferingId" - ], - "documentation": "Placeholder documentation for PurchaseOfferingRequest" - }, - "PurchaseOfferingResponse": { - "type": "structure", - "members": { - "Reservation": { - "shape": "Reservation", - "locationName": "reservation" - } - }, - "documentation": "Placeholder documentation for PurchaseOfferingResponse" - }, - "PurchaseOfferingResultModel": { - "type": "structure", - "members": { - "Reservation": { - "shape": "Reservation", - "locationName": "reservation" - } - }, - "documentation": "PurchaseOffering response" - }, - "RemixSettings": { - "type": "structure", - "members": { - "ChannelMappings": { - "shape": "__listOfAudioChannelMapping", - "locationName": "channelMappings", - "documentation": "Mapping of input channels to output channels, with appropriate gain adjustments." - }, - "ChannelsIn": { - "shape": "__integerMin1Max16", - "locationName": "channelsIn", - "documentation": "Number of input channels to be used." - }, - "ChannelsOut": { - "shape": "__integerMin1Max8", - "locationName": "channelsOut", - "documentation": "Number of output channels to be produced.\nValid values: 1, 2, 4, 6, 8" - } - }, - "required": [ - "ChannelMappings" - ], - "documentation": "Placeholder documentation for RemixSettings" - }, - "Reservation": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "Unique reservation ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:reservation:1234567'" - }, - "Count": { - "shape": "__integer", - "locationName": "count", - "documentation": "Number of reserved resources" - }, - "CurrencyCode": { - "shape": "__string", - "locationName": "currencyCode", - "documentation": "Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'" - }, - "Duration": { - "shape": "__integer", - "locationName": "duration", - "documentation": "Lease duration, e.g. '12'" - }, - "DurationUnits": { - "shape": "OfferingDurationUnits", - "locationName": "durationUnits", - "documentation": "Units for duration, e.g. 'MONTHS'" - }, - "End": { - "shape": "__string", - "locationName": "end", - "documentation": "Reservation UTC end date and time in ISO-8601 format, e.g. '2019-03-01T00:00:00'" - }, - "FixedPrice": { - "shape": "__double", - "locationName": "fixedPrice", - "documentation": "One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering" - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "User specified reservation name" - }, - "OfferingDescription": { - "shape": "__string", - "locationName": "offeringDescription", - "documentation": "Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'" - }, - "OfferingId": { - "shape": "__string", - "locationName": "offeringId", - "documentation": "Unique offering ID, e.g. '87654321'" - }, - "OfferingType": { - "shape": "OfferingType", - "locationName": "offeringType", - "documentation": "Offering type, e.g. 'NO_UPFRONT'" - }, - "Region": { - "shape": "__string", - "locationName": "region", - "documentation": "AWS region, e.g. 'us-west-2'" - }, - "ReservationId": { - "shape": "__string", - "locationName": "reservationId", - "documentation": "Unique reservation ID, e.g. '1234567'" - }, - "ResourceSpecification": { - "shape": "ReservationResourceSpecification", - "locationName": "resourceSpecification", - "documentation": "Resource configuration details" - }, - "Start": { - "shape": "__string", - "locationName": "start", - "documentation": "Reservation UTC start date and time in ISO-8601 format, e.g. '2018-03-01T00:00:00'" - }, - "State": { - "shape": "ReservationState", - "locationName": "state", - "documentation": "Current state of reservation, e.g. 'ACTIVE'" - }, - "UsagePrice": { - "shape": "__double", - "locationName": "usagePrice", - "documentation": "Recurring usage charge for each reserved resource, e.g. '157.0'" - } - }, - "documentation": "Reserved resources available to use" - }, - "ReservationCodec": { - "type": "string", - "documentation": "Codec, 'MPEG2', 'AVC', 'HEVC', or 'AUDIO'", - "enum": [ - "MPEG2", - "AVC", - "HEVC", - "AUDIO" - ] - }, - "ReservationMaximumBitrate": { - "type": "string", - "documentation": "Maximum bitrate in megabits per second", - "enum": [ - "MAX_10_MBPS", - "MAX_20_MBPS", - "MAX_50_MBPS" - ] - }, - "ReservationMaximumFramerate": { - "type": "string", - "documentation": "Maximum framerate in frames per second (Outputs only)", - "enum": [ - "MAX_30_FPS", - "MAX_60_FPS" - ] - }, - "ReservationResolution": { - "type": "string", - "documentation": "Resolution based on lines of vertical resolution; SD is less than 720 lines, HD is 720 to 1080 lines, UHD is greater than 1080 lines\n", - "enum": [ - "SD", - "HD", - "UHD" - ] - }, - "ReservationResourceSpecification": { - "type": "structure", - "members": { - "Codec": { - "shape": "ReservationCodec", - "locationName": "codec", - "documentation": "Codec, e.g. 'AVC'" - }, - "MaximumBitrate": { - "shape": "ReservationMaximumBitrate", - "locationName": "maximumBitrate", - "documentation": "Maximum bitrate, e.g. 'MAX_20_MBPS'" - }, - "MaximumFramerate": { - "shape": "ReservationMaximumFramerate", - "locationName": "maximumFramerate", - "documentation": "Maximum framerate, e.g. 'MAX_30_FPS' (Outputs only)" - }, - "Resolution": { - "shape": "ReservationResolution", - "locationName": "resolution", - "documentation": "Resolution, e.g. 'HD'" - }, - "ResourceType": { - "shape": "ReservationResourceType", - "locationName": "resourceType", - "documentation": "Resource type, 'INPUT', 'OUTPUT', or 'CHANNEL'" - }, - "SpecialFeature": { - "shape": "ReservationSpecialFeature", - "locationName": "specialFeature", - "documentation": "Special feature, e.g. 'AUDIO_NORMALIZATION' (Channels only)" - }, - "VideoQuality": { - "shape": "ReservationVideoQuality", - "locationName": "videoQuality", - "documentation": "Video quality, e.g. 'STANDARD' (Outputs only)" - } - }, - "documentation": "Resource configuration (codec, resolution, bitrate, ...)" - }, - "ReservationResourceType": { - "type": "string", - "documentation": "Resource type, 'INPUT', 'OUTPUT', or 'CHANNEL'", - "enum": [ - "INPUT", - "OUTPUT", - "CHANNEL" - ] - }, - "ReservationSpecialFeature": { - "type": "string", - "documentation": "Special features, 'ADVANCED_AUDIO' or 'AUDIO_NORMALIZATION'", - "enum": [ - "ADVANCED_AUDIO", - "AUDIO_NORMALIZATION" - ] - }, - "ReservationState": { - "type": "string", - "documentation": "Current reservation state", - "enum": [ - "ACTIVE", - "EXPIRED", - "CANCELED", - "DELETED" - ] - }, - "ReservationVideoQuality": { - "type": "string", - "documentation": "Video quality, e.g. 'STANDARD' (Outputs only)", - "enum": [ - "STANDARD", - "ENHANCED", - "PREMIUM" - ] - }, - "ResourceConflict": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for ResourceConflict" - }, - "ResourceNotFound": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "documentation": "Placeholder documentation for ResourceNotFound" - }, - "RtmpCacheFullBehavior": { - "type": "string", - "enum": [ - "DISCONNECT_IMMEDIATELY", - "WAIT_FOR_SERVER" - ], - "documentation": "Placeholder documentation for RtmpCacheFullBehavior" - }, - "RtmpCaptionData": { - "type": "string", - "enum": [ - "ALL", - "FIELD1_608", - "FIELD1_AND_FIELD2_608" - ], - "documentation": "Placeholder documentation for RtmpCaptionData" - }, - "RtmpCaptionInfoDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for RtmpCaptionInfoDestinationSettings" - }, - "RtmpGroupSettings": { - "type": "structure", - "members": { - "AuthenticationScheme": { - "shape": "AuthenticationScheme", - "locationName": "authenticationScheme", - "documentation": "Authentication scheme to use when connecting with CDN" - }, - "CacheFullBehavior": { - "shape": "RtmpCacheFullBehavior", - "locationName": "cacheFullBehavior", - "documentation": "Controls behavior when content cache fills up. If remote origin server stalls the RTMP connection and does not accept content fast enough the 'Media Cache' will fill up. When the cache reaches the duration specified by cacheLength the cache will stop accepting new content. If set to disconnectImmediately, the RTMP output will force a disconnect. Clear the media cache, and reconnect after restartDelay seconds. If set to waitForServer, the RTMP output will wait up to 5 minutes to allow the origin server to begin accepting data again." - }, - "CacheLength": { - "shape": "__integerMin30", - "locationName": "cacheLength", - "documentation": "Cache length, in seconds, is used to calculate buffer size." - }, - "CaptionData": { - "shape": "RtmpCaptionData", - "locationName": "captionData", - "documentation": "Controls the types of data that passes to onCaptionInfo outputs. If set to 'all' then 608 and 708 carried DTVCC data will be passed. If set to 'field1AndField2608' then DTVCC data will be stripped out, but 608 data from both fields will be passed. If set to 'field1608' then only the data carried in 608 from field 1 video will be passed." - }, - "RestartDelay": { - "shape": "__integerMin0", - "locationName": "restartDelay", - "documentation": "If a streaming output fails, number of seconds to wait until a restart is initiated. A value of 0 means never restart." - } - }, - "documentation": "Placeholder documentation for RtmpGroupSettings" - }, - "RtmpOutputCertificateMode": { - "type": "string", - "enum": [ - "SELF_SIGNED", - "VERIFY_AUTHENTICITY" - ], - "documentation": "Placeholder documentation for RtmpOutputCertificateMode" - }, - "RtmpOutputSettings": { - "type": "structure", - "members": { - "CertificateMode": { - "shape": "RtmpOutputCertificateMode", - "locationName": "certificateMode", - "documentation": "If set to verifyAuthenticity, verify the tls certificate chain to a trusted Certificate Authority (CA). This will cause rtmps outputs with self-signed certificates to fail." - }, - "ConnectionRetryInterval": { - "shape": "__integerMin1", - "locationName": "connectionRetryInterval", - "documentation": "Number of seconds to wait before retrying a connection to the Flash Media server if the connection is lost." - }, - "Destination": { - "shape": "OutputLocationRef", - "locationName": "destination", - "documentation": "The RTMP endpoint excluding the stream name (eg. rtmp://host/appname). For connection to Akamai, a username and password must be supplied. URI fields accept format identifiers." - }, - "NumRetries": { - "shape": "__integerMin0", - "locationName": "numRetries", - "documentation": "Number of retry attempts." - } - }, - "required": [ - "Destination" - ], - "documentation": "Placeholder documentation for RtmpOutputSettings" - }, - "Scte20Convert608To708": { - "type": "string", - "enum": [ - "DISABLED", - "UPCONVERT" - ], - "documentation": "Placeholder documentation for Scte20Convert608To708" - }, - "Scte20PlusEmbeddedDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for Scte20PlusEmbeddedDestinationSettings" - }, - "Scte20SourceSettings": { - "type": "structure", - "members": { - "Convert608To708": { - "shape": "Scte20Convert608To708", - "locationName": "convert608To708", - "documentation": "If upconvert, 608 data is both passed through via the \"608 compatibility bytes\" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded." - }, - "Source608ChannelNumber": { - "shape": "__integerMin1Max4", - "locationName": "source608ChannelNumber", - "documentation": "Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough." - } - }, - "documentation": "Placeholder documentation for Scte20SourceSettings" - }, - "Scte27DestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for Scte27DestinationSettings" - }, - "Scte27SourceSettings": { - "type": "structure", - "members": { - "Pid": { - "shape": "__integerMin1", - "locationName": "pid", - "documentation": "The pid field is used in conjunction with the caption selector languageCode field as follows:\n - Specify PID and Language: Extracts captions from that PID; the language is \"informational\".\n - Specify PID and omit Language: Extracts the specified PID.\n - Omit PID and specify Language: Extracts the specified language, whichever PID that happens to be.\n - Omit PID and omit Language: Valid only if source is DVB-Sub that is being passed through; all languages will be passed through." - } - }, - "documentation": "Placeholder documentation for Scte27SourceSettings" - }, - "Scte35AposNoRegionalBlackoutBehavior": { - "type": "string", - "enum": [ - "FOLLOW", - "IGNORE" - ], - "documentation": "Placeholder documentation for Scte35AposNoRegionalBlackoutBehavior" - }, - "Scte35AposWebDeliveryAllowedBehavior": { - "type": "string", - "enum": [ - "FOLLOW", - "IGNORE" - ], - "documentation": "Placeholder documentation for Scte35AposWebDeliveryAllowedBehavior" - }, - "Scte35SpliceInsert": { - "type": "structure", - "members": { - "AdAvailOffset": { - "shape": "__integerMinNegative1000Max1000", - "locationName": "adAvailOffset", - "documentation": "When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time. This only applies to embedded SCTE 104/35 messages and does not apply to OOB messages." - }, - "NoRegionalBlackoutFlag": { - "shape": "Scte35SpliceInsertNoRegionalBlackoutBehavior", - "locationName": "noRegionalBlackoutFlag", - "documentation": "When set to ignore, Segment Descriptors with noRegionalBlackoutFlag set to 0 will no longer trigger blackouts or Ad Avail slates" - }, - "WebDeliveryAllowedFlag": { - "shape": "Scte35SpliceInsertWebDeliveryAllowedBehavior", - "locationName": "webDeliveryAllowedFlag", - "documentation": "When set to ignore, Segment Descriptors with webDeliveryAllowedFlag set to 0 will no longer trigger blackouts or Ad Avail slates" - } - }, - "documentation": "Placeholder documentation for Scte35SpliceInsert" - }, - "Scte35SpliceInsertNoRegionalBlackoutBehavior": { - "type": "string", - "enum": [ - "FOLLOW", - "IGNORE" - ], - "documentation": "Placeholder documentation for Scte35SpliceInsertNoRegionalBlackoutBehavior" - }, - "Scte35SpliceInsertWebDeliveryAllowedBehavior": { - "type": "string", - "enum": [ - "FOLLOW", - "IGNORE" - ], - "documentation": "Placeholder documentation for Scte35SpliceInsertWebDeliveryAllowedBehavior" - }, - "Scte35TimeSignalApos": { - "type": "structure", - "members": { - "AdAvailOffset": { - "shape": "__integerMinNegative1000Max1000", - "locationName": "adAvailOffset", - "documentation": "When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time. This only applies to embedded SCTE 104/35 messages and does not apply to OOB messages." - }, - "NoRegionalBlackoutFlag": { - "shape": "Scte35AposNoRegionalBlackoutBehavior", - "locationName": "noRegionalBlackoutFlag", - "documentation": "When set to ignore, Segment Descriptors with noRegionalBlackoutFlag set to 0 will no longer trigger blackouts or Ad Avail slates" - }, - "WebDeliveryAllowedFlag": { - "shape": "Scte35AposWebDeliveryAllowedBehavior", - "locationName": "webDeliveryAllowedFlag", - "documentation": "When set to ignore, Segment Descriptors with webDeliveryAllowedFlag set to 0 will no longer trigger blackouts or Ad Avail slates" - } - }, - "documentation": "Placeholder documentation for Scte35TimeSignalApos" - }, - "SmoothGroupAudioOnlyTimecodeControl": { - "type": "string", - "enum": [ - "PASSTHROUGH", - "USE_CONFIGURED_CLOCK" - ], - "documentation": "Placeholder documentation for SmoothGroupAudioOnlyTimecodeControl" - }, - "SmoothGroupCertificateMode": { - "type": "string", - "enum": [ - "SELF_SIGNED", - "VERIFY_AUTHENTICITY" - ], - "documentation": "Placeholder documentation for SmoothGroupCertificateMode" - }, - "SmoothGroupEventIdMode": { - "type": "string", - "enum": [ - "NO_EVENT_ID", - "USE_CONFIGURED", - "USE_TIMESTAMP" - ], - "documentation": "Placeholder documentation for SmoothGroupEventIdMode" - }, - "SmoothGroupEventStopBehavior": { - "type": "string", - "enum": [ - "NONE", - "SEND_EOS" - ], - "documentation": "Placeholder documentation for SmoothGroupEventStopBehavior" - }, - "SmoothGroupSegmentationMode": { - "type": "string", - "enum": [ - "USE_INPUT_SEGMENTATION", - "USE_SEGMENT_DURATION" - ], - "documentation": "Placeholder documentation for SmoothGroupSegmentationMode" - }, - "SmoothGroupSparseTrackType": { - "type": "string", - "enum": [ - "NONE", - "SCTE_35" - ], - "documentation": "Placeholder documentation for SmoothGroupSparseTrackType" - }, - "SmoothGroupStreamManifestBehavior": { - "type": "string", - "enum": [ - "DO_NOT_SEND", - "SEND" - ], - "documentation": "Placeholder documentation for SmoothGroupStreamManifestBehavior" - }, - "SmoothGroupTimestampOffsetMode": { - "type": "string", - "enum": [ - "USE_CONFIGURED_OFFSET", - "USE_EVENT_START_DATE" - ], - "documentation": "Placeholder documentation for SmoothGroupTimestampOffsetMode" - }, - "SmpteTtDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for SmpteTtDestinationSettings" - }, - "StandardHlsSettings": { - "type": "structure", - "members": { - "AudioRenditionSets": { - "shape": "__string", - "locationName": "audioRenditionSets", - "documentation": "List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','." - }, - "M3u8Settings": { - "shape": "M3u8Settings", - "locationName": "m3u8Settings" - } - }, - "required": [ - "M3u8Settings" - ], - "documentation": "Placeholder documentation for StandardHlsSettings" - }, - "StartChannelRequest": { - "type": "structure", - "members": { - "ChannelId": { - "shape": "__string", - "location": "uri", - "locationName": "channelId", - "documentation": "A request to start a channel" - } - }, - "required": [ - "ChannelId" - ], - "documentation": "Placeholder documentation for StartChannelRequest" - }, - "StartChannelResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for StartChannelResponse" - }, - "StaticKeySettings": { - "type": "structure", - "members": { - "KeyProviderServer": { - "shape": "InputLocation", - "locationName": "keyProviderServer", - "documentation": "The URL of the license server used for protecting content." - }, - "StaticKeyValue": { - "shape": "__stringMin32Max32", - "locationName": "staticKeyValue", - "documentation": "Static key value as a 32 character hexadecimal string." - } - }, - "required": [ - "StaticKeyValue" - ], - "documentation": "Placeholder documentation for StaticKeySettings" - }, - "StopChannelRequest": { - "type": "structure", - "members": { - "ChannelId": { - "shape": "__string", - "location": "uri", - "locationName": "channelId", - "documentation": "A request to stop a running channel" - } - }, - "required": [ - "ChannelId" - ], - "documentation": "Placeholder documentation for StopChannelRequest" - }, - "StopChannelResponse": { - "type": "structure", - "members": { - "Arn": { - "shape": "__string", - "locationName": "arn", - "documentation": "The unique arn of the channel." - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of destinations of the channel. For UDP outputs, there is one\ndestination per output. For other types (HLS, for example), there is\none destination per packager.\n" - }, - "EgressEndpoints": { - "shape": "__listOfChannelEgressEndpoint", - "locationName": "egressEndpoints", - "documentation": "The endpoints where outgoing connections initiate from" - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings" - }, - "Id": { - "shape": "__string", - "locationName": "id", - "documentation": "The unique id of the channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments", - "documentation": "List of input attachments for channel." - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level being written to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel. (user-mutable)" - }, - "PipelinesRunningCount": { - "shape": "__integer", - "locationName": "pipelinesRunningCount", - "documentation": "The number of currently healthy pipelines." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "The Amazon Resource Name (ARN) of the role assumed when running the Channel." - }, - "State": { - "shape": "ChannelState", - "locationName": "state" - } - }, - "documentation": "Placeholder documentation for StopChannelResponse" - }, - "TeletextDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for TeletextDestinationSettings" - }, - "TeletextSourceSettings": { - "type": "structure", - "members": { - "PageNumber": { - "shape": "__string", - "locationName": "pageNumber", - "documentation": "Specifies the teletext page number within the data stream from which to extract captions. Range of 0x100 (256) to 0x8FF (2303). Unused for passthrough. Should be specified as a hexadecimal string with no \"0x\" prefix." - } - }, - "documentation": "Placeholder documentation for TeletextSourceSettings" - }, - "TimecodeConfig": { - "type": "structure", - "members": { - "Source": { - "shape": "TimecodeConfigSource", - "locationName": "source", - "documentation": "Identifies the source for the timecode that will be associated with the events outputs.\n-Embedded (embedded): Initialize the output timecode with timecode from the the source. If no embedded timecode is detected in the source, the system falls back to using \"Start at 0\" (zerobased).\n-System Clock (systemclock): Use the UTC time.\n-Start at 0 (zerobased): The time of the first frame of the event will be 00:00:00:00." - }, - "SyncThreshold": { - "shape": "__integerMin1Max1000000", - "locationName": "syncThreshold", - "documentation": "Threshold in frames beyond which output timecode is resynchronized to the input timecode. Discrepancies below this threshold are permitted to avoid unnecessary discontinuities in the output timecode. No timecode sync when this is not specified." - } - }, - "required": [ - "Source" - ], - "documentation": "Placeholder documentation for TimecodeConfig" - }, - "TimecodeConfigSource": { - "type": "string", - "enum": [ - "EMBEDDED", - "SYSTEMCLOCK", - "ZEROBASED" - ], - "documentation": "Placeholder documentation for TimecodeConfigSource" - }, - "TooManyRequestsException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - } - }, - "exception": true, - "error": { - "httpStatusCode": 429 - }, - "documentation": "Placeholder documentation for TooManyRequestsException" - }, - "TtmlDestinationSettings": { - "type": "structure", - "members": { - "StyleControl": { - "shape": "TtmlDestinationStyleControl", - "locationName": "styleControl", - "documentation": "When set to passthrough, passes through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output." - } - }, - "documentation": "Placeholder documentation for TtmlDestinationSettings" - }, - "TtmlDestinationStyleControl": { - "type": "string", - "enum": [ - "PASSTHROUGH", - "USE_CONFIGURED" - ], - "documentation": "Placeholder documentation for TtmlDestinationStyleControl" - }, - "UdpContainerSettings": { - "type": "structure", - "members": { - "M2tsSettings": { - "shape": "M2tsSettings", - "locationName": "m2tsSettings" - } - }, - "documentation": "Placeholder documentation for UdpContainerSettings" - }, - "UdpGroupSettings": { - "type": "structure", - "members": { - "InputLossAction": { - "shape": "InputLossActionForUdpOut", - "locationName": "inputLossAction", - "documentation": "Specifies behavior of last resort when input video is lost, and no more backup inputs are available. When dropTs is selected the entire transport stream will stop being emitted. When dropProgram is selected the program can be dropped from the transport stream (and replaced with null packets to meet the TS bitrate requirement). Or, when emitProgram is chosen the transport stream will continue to be produced normally with repeat frames, black frames, or slate frames substituted for the absent input video." - }, - "TimedMetadataId3Frame": { - "shape": "UdpTimedMetadataId3Frame", - "locationName": "timedMetadataId3Frame", - "documentation": "Indicates ID3 frame that has the timecode." - }, - "TimedMetadataId3Period": { - "shape": "__integerMin0", - "locationName": "timedMetadataId3Period", - "documentation": "Timed Metadata interval in seconds." - } - }, - "documentation": "Placeholder documentation for UdpGroupSettings" - }, - "UdpOutputSettings": { - "type": "structure", - "members": { - "BufferMsec": { - "shape": "__integerMin0Max10000", - "locationName": "bufferMsec", - "documentation": "UDP output buffering in milliseconds. Larger values increase latency through the transcoder but simultaneously assist the transcoder in maintaining a constant, low-jitter UDP/RTP output while accommodating clock recovery, input switching, input disruptions, picture reordering, etc." - }, - "ContainerSettings": { - "shape": "UdpContainerSettings", - "locationName": "containerSettings" - }, - "Destination": { - "shape": "OutputLocationRef", - "locationName": "destination", - "documentation": "Destination address and port number for RTP or UDP packets. Can be unicast or multicast RTP or UDP (eg. rtp://239.10.10.10:5001 or udp://10.100.100.100:5002)." - }, - "FecOutputSettings": { - "shape": "FecOutputSettings", - "locationName": "fecOutputSettings", - "documentation": "Settings for enabling and adjusting Forward Error Correction on UDP outputs." - } - }, - "required": [ - "Destination", - "ContainerSettings" - ], - "documentation": "Placeholder documentation for UdpOutputSettings" - }, - "UdpTimedMetadataId3Frame": { - "type": "string", - "enum": [ - "NONE", - "PRIV", - "TDRL" - ], - "documentation": "Placeholder documentation for UdpTimedMetadataId3Frame" - }, - "UnprocessableEntityException": { - "type": "structure", - "members": { - "Message": { - "shape": "__string", - "locationName": "message" - }, - "ValidationErrors": { - "shape": "__listOfValidationError", - "locationName": "validationErrors", - "documentation": "A collection of validation error responses from attempting to create a channel with a bouquet of settings." - } - }, - "exception": true, - "error": { - "httpStatusCode": 422 - }, - "documentation": "Placeholder documentation for UnprocessableEntityException" - }, - "UpdateChannel": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of output destinations for this channel." - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings", - "documentation": "The encoder settings for this channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments" - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification", - "documentation": "Specification of input for this channel (max. bitrate, resolution, codec, etc.)" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level to write to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "An optional Amazon Resource Name (ARN) of the role to assume when running the Channel. If you do not specify this on an update call but the role was previously set that role will be removed." - } - }, - "documentation": "Placeholder documentation for UpdateChannel" - }, - "UpdateChannelRequest": { - "type": "structure", - "members": { - "ChannelId": { - "shape": "__string", - "location": "uri", - "locationName": "channelId", - "documentation": "channel ID" - }, - "Destinations": { - "shape": "__listOfOutputDestination", - "locationName": "destinations", - "documentation": "A list of output destinations for this channel." - }, - "EncoderSettings": { - "shape": "EncoderSettings", - "locationName": "encoderSettings", - "documentation": "The encoder settings for this channel." - }, - "InputAttachments": { - "shape": "__listOfInputAttachment", - "locationName": "inputAttachments" - }, - "InputSpecification": { - "shape": "InputSpecification", - "locationName": "inputSpecification", - "documentation": "Specification of input for this channel (max. bitrate, resolution, codec, etc.)" - }, - "LogLevel": { - "shape": "LogLevel", - "locationName": "logLevel", - "documentation": "The log level to write to CloudWatch Logs." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of the channel." - }, - "RoleArn": { - "shape": "__string", - "locationName": "roleArn", - "documentation": "An optional Amazon Resource Name (ARN) of the role to assume when running the Channel. If you do not specify this on an update call but the role was previously set that role will be removed." - } - }, - "documentation": "A request to update a channel.", - "required": [ - "ChannelId" - ] - }, - "UpdateChannelResponse": { - "type": "structure", - "members": { - "Channel": { - "shape": "Channel", - "locationName": "channel" - } - }, - "documentation": "Placeholder documentation for UpdateChannelResponse" - }, - "UpdateChannelResultModel": { - "type": "structure", - "members": { - "Channel": { - "shape": "Channel", - "locationName": "channel" - } - }, - "documentation": "The updated channel's description." - }, - "UpdateInput": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfInputDestinationRequest", - "locationName": "destinations", - "documentation": "Destination settings for PUSH type inputs." - }, - "InputSecurityGroups": { - "shape": "__listOf__string", - "locationName": "inputSecurityGroups", - "documentation": "A list of security groups referenced by IDs to attach to the input." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the input." - }, - "Sources": { - "shape": "__listOfInputSourceRequest", - "locationName": "sources", - "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty.\n" - } - }, - "documentation": "Placeholder documentation for UpdateInput" - }, - "UpdateInputRequest": { - "type": "structure", - "members": { - "Destinations": { - "shape": "__listOfInputDestinationRequest", - "locationName": "destinations", - "documentation": "Destination settings for PUSH type inputs." - }, - "InputId": { - "shape": "__string", - "location": "uri", - "locationName": "inputId", - "documentation": "Unique ID of the input." - }, - "InputSecurityGroups": { - "shape": "__listOf__string", - "locationName": "inputSecurityGroups", - "documentation": "A list of security groups referenced by IDs to attach to the input." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "Name of the input." - }, - "Sources": { - "shape": "__listOfInputSourceRequest", - "locationName": "sources", - "documentation": "The source URLs for a PULL-type input. Every PULL type input needs\nexactly two source URLs for redundancy.\nOnly specify sources for PULL type Inputs. Leave Destinations empty.\n" - } - }, - "documentation": "A request to update an input.", - "required": [ - "InputId" - ] - }, - "UpdateInputResponse": { - "type": "structure", - "members": { - "Input": { - "shape": "Input", - "locationName": "input" - } - }, - "documentation": "Placeholder documentation for UpdateInputResponse" - }, - "UpdateInputResultModel": { - "type": "structure", - "members": { - "Input": { - "shape": "Input", - "locationName": "input" - } - }, - "documentation": "Placeholder documentation for UpdateInputResultModel" - }, - "UpdateInputSecurityGroupRequest": { - "type": "structure", - "members": { - "InputSecurityGroupId": { - "shape": "__string", - "location": "uri", - "locationName": "inputSecurityGroupId", - "documentation": "The id of the Input Security Group to update." - }, - "WhitelistRules": { - "shape": "__listOfInputWhitelistRuleCidr", - "locationName": "whitelistRules", - "documentation": "List of IPv4 CIDR addresses to whitelist" - } - }, - "documentation": "The request to update some combination of the Input Security Group name and the IPv4 CIDRs the Input Security Group should allow.", - "required": [ - "InputSecurityGroupId" - ] - }, - "UpdateInputSecurityGroupResponse": { - "type": "structure", - "members": { - "SecurityGroup": { - "shape": "InputSecurityGroup", - "locationName": "securityGroup" - } - }, - "documentation": "Placeholder documentation for UpdateInputSecurityGroupResponse" - }, - "UpdateInputSecurityGroupResultModel": { - "type": "structure", - "members": { - "SecurityGroup": { - "shape": "InputSecurityGroup", - "locationName": "securityGroup" - } - }, - "documentation": "Placeholder documentation for UpdateInputSecurityGroupResultModel" - }, - "ValidationError": { - "type": "structure", - "members": { - "ElementPath": { - "shape": "__string", - "locationName": "elementPath" - }, - "ErrorMessage": { - "shape": "__string", - "locationName": "errorMessage" - } - }, - "documentation": "Placeholder documentation for ValidationError" - }, - "VideoCodecSettings": { - "type": "structure", - "members": { - "H264Settings": { - "shape": "H264Settings", - "locationName": "h264Settings" - } - }, - "documentation": "Placeholder documentation for VideoCodecSettings" - }, - "VideoDescription": { - "type": "structure", - "members": { - "CodecSettings": { - "shape": "VideoCodecSettings", - "locationName": "codecSettings", - "documentation": "Video codec settings." - }, - "Height": { - "shape": "__integer", - "locationName": "height", - "documentation": "Output video height (in pixels). Leave blank to use source video height. If left blank, width must also be unspecified." - }, - "Name": { - "shape": "__string", - "locationName": "name", - "documentation": "The name of this VideoDescription. Outputs will use this name to uniquely identify this Description. Description names should be unique within this Live Event." - }, - "RespondToAfd": { - "shape": "VideoDescriptionRespondToAfd", - "locationName": "respondToAfd", - "documentation": "Indicates how to respond to the AFD values in the input stream. Setting to \"respond\" causes input video to be clipped, depending on AFD value, input display aspect ratio and output display aspect ratio." - }, - "ScalingBehavior": { - "shape": "VideoDescriptionScalingBehavior", - "locationName": "scalingBehavior", - "documentation": "When set to \"stretchToOutput\", automatically configures the output position to stretch the video to the specified output resolution. This option will override any position value." - }, - "Sharpness": { - "shape": "__integerMin0Max100", - "locationName": "sharpness", - "documentation": "Changes the width of the anti-alias filter kernel used for scaling. Only applies if scaling is being performed and antiAlias is set to true. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content." - }, - "Width": { - "shape": "__integer", - "locationName": "width", - "documentation": "Output video width (in pixels). Leave out to use source video width. If left out, height must also be left out. Display aspect ratio is always preserved by letterboxing or pillarboxing when necessary." - } - }, - "documentation": "Video settings for this stream.", - "required": [ - "Name" - ] - }, - "VideoDescriptionRespondToAfd": { - "type": "string", - "enum": [ - "NONE", - "PASSTHROUGH", - "RESPOND" - ], - "documentation": "Placeholder documentation for VideoDescriptionRespondToAfd" - }, - "VideoDescriptionScalingBehavior": { - "type": "string", - "enum": [ - "DEFAULT", - "STRETCH_TO_OUTPUT" - ], - "documentation": "Placeholder documentation for VideoDescriptionScalingBehavior" - }, - "VideoSelector": { - "type": "structure", - "members": { - "ColorSpace": { - "shape": "VideoSelectorColorSpace", - "locationName": "colorSpace", - "documentation": "Specifies the colorspace of an input. This setting works in tandem with colorSpaceConversion to determine if any conversion will be performed." - }, - "ColorSpaceUsage": { - "shape": "VideoSelectorColorSpaceUsage", - "locationName": "colorSpaceUsage", - "documentation": "Applies only if colorSpace is a value other than follow. This field controls how the value in the colorSpace field will be used. fallback means that when the input does include color space data, that data will be used, but when the input has no color space data, the value in colorSpace will be used. Choose fallback if your input is sometimes missing color space data, but when it does have color space data, that data is correct. force means to always use the value in colorSpace. Choose force if your input usually has no color space data or might have unreliable color space data." - }, - "SelectorSettings": { - "shape": "VideoSelectorSettings", - "locationName": "selectorSettings", - "documentation": "The video selector settings." - } - }, - "documentation": "Specifies a particular video stream within an input source. An input may have only a single video selector." - }, - "VideoSelectorColorSpace": { - "type": "string", - "enum": [ - "FOLLOW", - "REC_601", - "REC_709" - ], - "documentation": "Placeholder documentation for VideoSelectorColorSpace" - }, - "VideoSelectorColorSpaceUsage": { - "type": "string", - "enum": [ - "FALLBACK", - "FORCE" - ], - "documentation": "Placeholder documentation for VideoSelectorColorSpaceUsage" - }, - "VideoSelectorPid": { - "type": "structure", - "members": { - "Pid": { - "shape": "__integerMin0Max8191", - "locationName": "pid", - "documentation": "Selects a specific PID from within a video source." - } - }, - "documentation": "Placeholder documentation for VideoSelectorPid" - }, - "VideoSelectorProgramId": { - "type": "structure", - "members": { - "ProgramId": { - "shape": "__integerMin0Max65536", - "locationName": "programId", - "documentation": "Selects a specific program from within a multi-program transport stream. If the program doesn't exist, the first program within the transport stream will be selected by default." - } - }, - "documentation": "Placeholder documentation for VideoSelectorProgramId" - }, - "VideoSelectorSettings": { - "type": "structure", - "members": { - "VideoSelectorPid": { - "shape": "VideoSelectorPid", - "locationName": "videoSelectorPid" - }, - "VideoSelectorProgramId": { - "shape": "VideoSelectorProgramId", - "locationName": "videoSelectorProgramId" - } - }, - "documentation": "Placeholder documentation for VideoSelectorSettings" - }, - "WebvttDestinationSettings": { - "type": "structure", - "members": { - }, - "documentation": "Placeholder documentation for WebvttDestinationSettings" - }, - "__boolean": { - "type": "boolean", - "documentation": "Placeholder documentation for __boolean" - }, - "__double": { - "type": "double", - "documentation": "Placeholder documentation for __double" - }, - "__doubleMin0": { - "type": "double", - "documentation": "Placeholder documentation for __doubleMin0" - }, - "__doubleMin1": { - "type": "double", - "documentation": "Placeholder documentation for __doubleMin1" - }, - "__doubleMinNegative59Max0": { - "type": "double", - "documentation": "Placeholder documentation for __doubleMinNegative59Max0" - }, - "__integer": { - "type": "integer", - "documentation": "Placeholder documentation for __integer" - }, - "__integerMin0": { - "type": "integer", - "min": 0, - "documentation": "Placeholder documentation for __integerMin0" - }, - "__integerMin0Max10": { - "type": "integer", - "min": 0, - "max": 10, - "documentation": "Placeholder documentation for __integerMin0Max10" - }, - "__integerMin0Max100": { - "type": "integer", - "min": 0, - "max": 100, - "documentation": "Placeholder documentation for __integerMin0Max100" - }, - "__integerMin0Max1000": { - "type": "integer", - "min": 0, - "max": 1000, - "documentation": "Placeholder documentation for __integerMin0Max1000" - }, - "__integerMin0Max10000": { - "type": "integer", - "min": 0, - "max": 10000, - "documentation": "Placeholder documentation for __integerMin0Max10000" - }, - "__integerMin0Max1000000": { - "type": "integer", - "min": 0, - "max": 1000000, - "documentation": "Placeholder documentation for __integerMin0Max1000000" - }, - "__integerMin0Max128": { - "type": "integer", - "min": 0, - "max": 128, - "documentation": "Placeholder documentation for __integerMin0Max128" - }, - "__integerMin0Max15": { - "type": "integer", - "min": 0, - "max": 15, - "documentation": "Placeholder documentation for __integerMin0Max15" - }, - "__integerMin0Max255": { - "type": "integer", - "min": 0, - "max": 255, - "documentation": "Placeholder documentation for __integerMin0Max255" - }, - "__integerMin0Max30": { - "type": "integer", - "min": 0, - "max": 30, - "documentation": "Placeholder documentation for __integerMin0Max30" - }, - "__integerMin0Max3600": { - "type": "integer", - "min": 0, - "max": 3600, - "documentation": "Placeholder documentation for __integerMin0Max3600" - }, - "__integerMin0Max500": { - "type": "integer", - "min": 0, - "max": 500, - "documentation": "Placeholder documentation for __integerMin0Max500" - }, - "__integerMin0Max600": { - "type": "integer", - "min": 0, - "max": 600, - "documentation": "Placeholder documentation for __integerMin0Max600" - }, - "__integerMin0Max65535": { - "type": "integer", - "min": 0, - "max": 65535, - "documentation": "Placeholder documentation for __integerMin0Max65535" - }, - "__integerMin0Max65536": { - "type": "integer", - "min": 0, - "max": 65536, - "documentation": "Placeholder documentation for __integerMin0Max65536" - }, - "__integerMin0Max7": { - "type": "integer", - "min": 0, - "max": 7, - "documentation": "Placeholder documentation for __integerMin0Max7" - }, - "__integerMin0Max8191": { - "type": "integer", - "min": 0, - "max": 8191, - "documentation": "Placeholder documentation for __integerMin0Max8191" - }, - "__integerMin1": { - "type": "integer", - "min": 1, - "documentation": "Placeholder documentation for __integerMin1" - }, - "__integerMin1000": { - "type": "integer", - "min": 1000, - "documentation": "Placeholder documentation for __integerMin1000" - }, - "__integerMin1000Max30000": { - "type": "integer", - "min": 1000, - "max": 30000, - "documentation": "Placeholder documentation for __integerMin1000Max30000" - }, - "__integerMin1Max1000000": { - "type": "integer", - "min": 1, - "max": 1000000, - "documentation": "Placeholder documentation for __integerMin1Max1000000" - }, - "__integerMin1Max16": { - "type": "integer", - "min": 1, - "max": 16, - "documentation": "Placeholder documentation for __integerMin1Max16" - }, - "__integerMin1Max20": { - "type": "integer", - "min": 1, - "max": 20, - "documentation": "Placeholder documentation for __integerMin1Max20" - }, - "__integerMin1Max31": { - "type": "integer", - "min": 1, - "max": 31, - "documentation": "Placeholder documentation for __integerMin1Max31" - }, - "__integerMin1Max32": { - "type": "integer", - "min": 1, - "max": 32, - "documentation": "Placeholder documentation for __integerMin1Max32" - }, - "__integerMin1Max4": { - "type": "integer", - "min": 1, - "max": 4, - "documentation": "Placeholder documentation for __integerMin1Max4" - }, - "__integerMin1Max5": { - "type": "integer", - "min": 1, - "max": 5, - "documentation": "Placeholder documentation for __integerMin1Max5" - }, - "__integerMin1Max6": { - "type": "integer", - "min": 1, - "max": 6, - "documentation": "Placeholder documentation for __integerMin1Max6" - }, - "__integerMin1Max8": { - "type": "integer", - "min": 1, - "max": 8, - "documentation": "Placeholder documentation for __integerMin1Max8" - }, - "__integerMin25Max10000": { - "type": "integer", - "min": 25, - "max": 10000, - "documentation": "Placeholder documentation for __integerMin25Max10000" - }, - "__integerMin25Max2000": { - "type": "integer", - "min": 25, - "max": 2000, - "documentation": "Placeholder documentation for __integerMin25Max2000" - }, - "__integerMin3": { - "type": "integer", - "min": 3, - "documentation": "Placeholder documentation for __integerMin3" - }, - "__integerMin30": { - "type": "integer", - "min": 30, - "documentation": "Placeholder documentation for __integerMin30" - }, - "__integerMin4Max20": { - "type": "integer", - "min": 4, - "max": 20, - "documentation": "Placeholder documentation for __integerMin4Max20" - }, - "__integerMin96Max600": { - "type": "integer", - "min": 96, - "max": 600, - "documentation": "Placeholder documentation for __integerMin96Max600" - }, - "__integerMinNegative1000Max1000": { - "type": "integer", - "min": -1000, - "max": 1000, - "documentation": "Placeholder documentation for __integerMinNegative1000Max1000" - }, - "__integerMinNegative60Max6": { - "type": "integer", - "min": -60, - "max": 6, - "documentation": "Placeholder documentation for __integerMinNegative60Max6" - }, - "__integerMinNegative60Max60": { - "type": "integer", - "min": -60, - "max": 60, - "documentation": "Placeholder documentation for __integerMinNegative60Max60" - }, - "__listOfAudioChannelMapping": { - "type": "list", - "member": { - "shape": "AudioChannelMapping" - }, - "documentation": "Placeholder documentation for __listOfAudioChannelMapping" - }, - "__listOfAudioDescription": { - "type": "list", - "member": { - "shape": "AudioDescription" - }, - "documentation": "Placeholder documentation for __listOfAudioDescription" - }, - "__listOfAudioSelector": { - "type": "list", - "member": { - "shape": "AudioSelector" - }, - "documentation": "Placeholder documentation for __listOfAudioSelector" - }, - "__listOfCaptionDescription": { - "type": "list", - "member": { - "shape": "CaptionDescription" - }, - "documentation": "Placeholder documentation for __listOfCaptionDescription" - }, - "__listOfCaptionLanguageMapping": { - "type": "list", - "member": { - "shape": "CaptionLanguageMapping" - }, - "documentation": "Placeholder documentation for __listOfCaptionLanguageMapping" - }, - "__listOfCaptionSelector": { - "type": "list", - "member": { - "shape": "CaptionSelector" - }, - "documentation": "Placeholder documentation for __listOfCaptionSelector" - }, - "__listOfChannelEgressEndpoint": { - "type": "list", - "member": { - "shape": "ChannelEgressEndpoint" - }, - "documentation": "Placeholder documentation for __listOfChannelEgressEndpoint" - }, - "__listOfChannelSummary": { - "type": "list", - "member": { - "shape": "ChannelSummary" - }, - "documentation": "Placeholder documentation for __listOfChannelSummary" - }, - "__listOfHlsAdMarkers": { - "type": "list", - "member": { - "shape": "HlsAdMarkers" - }, - "documentation": "Placeholder documentation for __listOfHlsAdMarkers" - }, - "__listOfInput": { - "type": "list", - "member": { - "shape": "Input" - }, - "documentation": "Placeholder documentation for __listOfInput" - }, - "__listOfInputAttachment": { - "type": "list", - "member": { - "shape": "InputAttachment" - }, - "documentation": "Placeholder documentation for __listOfInputAttachment" - }, - "__listOfInputChannelLevel": { - "type": "list", - "member": { - "shape": "InputChannelLevel" - }, - "documentation": "Placeholder documentation for __listOfInputChannelLevel" - }, - "__listOfInputDestination": { - "type": "list", - "member": { - "shape": "InputDestination" - }, - "documentation": "Placeholder documentation for __listOfInputDestination" - }, - "__listOfInputDestinationRequest": { - "type": "list", - "member": { - "shape": "InputDestinationRequest" - }, - "documentation": "Placeholder documentation for __listOfInputDestinationRequest" - }, - "__listOfInputSecurityGroup": { - "type": "list", - "member": { - "shape": "InputSecurityGroup" - }, - "documentation": "Placeholder documentation for __listOfInputSecurityGroup" - }, - "__listOfInputSource": { - "type": "list", - "member": { - "shape": "InputSource" - }, - "documentation": "Placeholder documentation for __listOfInputSource" - }, - "__listOfInputSourceRequest": { - "type": "list", - "member": { - "shape": "InputSourceRequest" - }, - "documentation": "Placeholder documentation for __listOfInputSourceRequest" - }, - "__listOfInputWhitelistRule": { - "type": "list", - "member": { - "shape": "InputWhitelistRule" - }, - "documentation": "Placeholder documentation for __listOfInputWhitelistRule" - }, - "__listOfInputWhitelistRuleCidr": { - "type": "list", - "member": { - "shape": "InputWhitelistRuleCidr" - }, - "documentation": "Placeholder documentation for __listOfInputWhitelistRuleCidr" - }, - "__listOfOffering": { - "type": "list", - "member": { - "shape": "Offering" - }, - "documentation": "Placeholder documentation for __listOfOffering" - }, - "__listOfOutput": { - "type": "list", - "member": { - "shape": "Output" - }, - "documentation": "Placeholder documentation for __listOfOutput" - }, - "__listOfOutputDestination": { - "type": "list", - "member": { - "shape": "OutputDestination" - }, - "documentation": "Placeholder documentation for __listOfOutputDestination" - }, - "__listOfOutputDestinationSettings": { - "type": "list", - "member": { - "shape": "OutputDestinationSettings" - }, - "documentation": "Placeholder documentation for __listOfOutputDestinationSettings" - }, - "__listOfOutputGroup": { - "type": "list", - "member": { - "shape": "OutputGroup" - }, - "documentation": "Placeholder documentation for __listOfOutputGroup" - }, - "__listOfReservation": { - "type": "list", - "member": { - "shape": "Reservation" - }, - "documentation": "Placeholder documentation for __listOfReservation" - }, - "__listOfValidationError": { - "type": "list", - "member": { - "shape": "ValidationError" - }, - "documentation": "Placeholder documentation for __listOfValidationError" - }, - "__listOfVideoDescription": { - "type": "list", - "member": { - "shape": "VideoDescription" - }, - "documentation": "Placeholder documentation for __listOfVideoDescription" - }, - "__listOf__string": { - "type": "list", - "member": { - "shape": "__string" - }, - "documentation": "Placeholder documentation for __listOf__string" - }, - "__long": { - "type": "long", - "documentation": "Placeholder documentation for __long" - }, - "__string": { - "type": "string", - "documentation": "Placeholder documentation for __string" - }, - "__stringMax32": { - "type": "string", - "max": 32, - "documentation": "Placeholder documentation for __stringMax32" - }, - "__stringMin1": { - "type": "string", - "min": 1, - "documentation": "Placeholder documentation for __stringMin1" - }, - "__stringMin1Max255": { - "type": "string", - "min": 1, - "max": 255, - "documentation": "Placeholder documentation for __stringMin1Max255" - }, - "__stringMin1Max256": { - "type": "string", - "min": 1, - "max": 256, - "documentation": "Placeholder documentation for __stringMin1Max256" - }, - "__stringMin32Max32": { - "type": "string", - "min": 32, - "max": 32, - "documentation": "Placeholder documentation for __stringMin32Max32" - }, - "__stringMin34Max34": { - "type": "string", - "min": 34, - "max": 34, - "documentation": "Placeholder documentation for __stringMin34Max34" - }, - "__stringMin3Max3": { - "type": "string", - "min": 3, - "max": 3, - "documentation": "Placeholder documentation for __stringMin3Max3" - }, - "__stringMin6Max6": { - "type": "string", - "min": 6, - "max": 6, - "documentation": "Placeholder documentation for __stringMin6Max6" - } - }, - "documentation": "API for AWS Elemental MediaLive" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/paginators-1.json deleted file mode 100644 index 34eaef1e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "ListChannels": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Channels" - }, - "ListOriginEndpoints": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "OriginEndpoints" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/service-2.json deleted file mode 100644 index 84093d0d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediapackage/2017-10-12/service-2.json +++ /dev/null @@ -1,1905 +0,0 @@ -{ - "documentation": "AWS Elemental MediaPackage", - "metadata": { - "apiVersion": "2017-10-12", - "endpointPrefix": "mediapackage", - "jsonVersion": "1.1", - "protocol": "rest-json", - "serviceAbbreviation": "MediaPackage", - "serviceFullName": "AWS Elemental MediaPackage", - "serviceId": "MediaPackage", - "signatureVersion": "v4", - "signingName": "mediapackage", - "uid": "mediapackage-2017-10-12" - }, - "operations": { - "CreateChannel": { - "documentation": "Creates a new Channel.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "POST", - "requestUri": "/channels", - "responseCode": 200 - }, - "input": { - "shape": "CreateChannelRequest" - }, - "name": "CreateChannel", - "output": { - "documentation": "The new Channel record.", - "shape": "CreateChannelResponse" - } - }, - "CreateOriginEndpoint": { - "documentation": "Creates a new OriginEndpoint record.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "POST", - "requestUri": "/origin_endpoints", - "responseCode": 200 - }, - "input": { - "shape": "CreateOriginEndpointRequest" - }, - "name": "CreateOriginEndpoint", - "output": { - "documentation": "A new OriginEndpoint record.", - "shape": "CreateOriginEndpointResponse" - } - }, - "DeleteChannel": { - "documentation": "Deletes an existing Channel.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "DELETE", - "requestUri": "/channels/{id}", - "responseCode": 202 - }, - "input": { - "shape": "DeleteChannelRequest" - }, - "name": "DeleteChannel", - "output": { - "documentation": "The Channel has been deleted.", - "shape": "DeleteChannelResponse" - } - }, - "DeleteOriginEndpoint": { - "documentation": "Deletes an existing OriginEndpoint.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "DELETE", - "requestUri": "/origin_endpoints/{id}", - "responseCode": 202 - }, - "input": { - "shape": "DeleteOriginEndpointRequest" - }, - "name": "DeleteOriginEndpoint", - "output": { - "documentation": "The OriginEndpoint has been deleted.", - "shape": "DeleteOriginEndpointResponse" - } - }, - "DescribeChannel": { - "documentation": "Gets details about a Channel.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "GET", - "requestUri": "/channels/{id}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeChannelRequest" - }, - "name": "DescribeChannel", - "output": { - "documentation": "A Channel record.", - "shape": "DescribeChannelResponse" - } - }, - "DescribeOriginEndpoint": { - "documentation": "Gets details about an existing OriginEndpoint.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "GET", - "requestUri": "/origin_endpoints/{id}", - "responseCode": 200 - }, - "input": { - "shape": "DescribeOriginEndpointRequest" - }, - "name": "DescribeOriginEndpoint", - "output": { - "documentation": "An OriginEndpoint record.", - "shape": "DescribeOriginEndpointResponse" - } - }, - "ListChannels": { - "documentation": "Returns a collection of Channels.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "GET", - "requestUri": "/channels", - "responseCode": 200 - }, - "input": { - "shape": "ListChannelsRequest" - }, - "name": "ListChannels", - "output": { - "documentation": "A collection of Channel records.", - "shape": "ListChannelsResponse" - } - }, - "ListOriginEndpoints": { - "documentation": "Returns a collection of OriginEndpoint records.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "GET", - "requestUri": "/origin_endpoints", - "responseCode": 200 - }, - "input": { - "shape": "ListOriginEndpointsRequest" - }, - "name": "ListOriginEndpoints", - "output": { - "documentation": "A collection of OriginEndpoint records.", - "shape": "ListOriginEndpointsResponse" - } - }, - "RotateChannelCredentials": { - "documentation": "Changes the Channel ingest username and password.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "PUT", - "requestUri": "/channels/{id}/credentials", - "responseCode": 200 - }, - "input": { - "shape": "RotateChannelCredentialsRequest" - }, - "name": "RotateChannelCredentials", - "output": { - "documentation": "The updated Channel record.", - "shape": "RotateChannelCredentialsResponse" - } - }, - "UpdateChannel": { - "documentation": "Updates an existing Channel.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "PUT", - "requestUri": "/channels/{id}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateChannelRequest" - }, - "name": "UpdateChannel", - "output": { - "documentation": "The updated Channel record.", - "shape": "UpdateChannelResponse" - } - }, - "UpdateOriginEndpoint": { - "documentation": "Updates an existing OriginEndpoint.", - "errors": [ - { - "shape": "UnprocessableEntityException" - }, - { - "shape": "InternalServerErrorException" - }, - { - "shape": "ForbiddenException" - }, - { - "shape": "NotFoundException" - }, - { - "shape": "ServiceUnavailableException" - }, - { - "shape": "TooManyRequestsException" - } - ], - "http": { - "method": "PUT", - "requestUri": "/origin_endpoints/{id}", - "responseCode": 200 - }, - "input": { - "shape": "UpdateOriginEndpointRequest" - }, - "name": "UpdateOriginEndpoint", - "output": { - "documentation": "An updated OriginEndpoint record.", - "shape": "UpdateOriginEndpointResponse" - } - } - }, - "shapes": { - "AdMarkers": { - "enum": [ - "NONE", - "SCTE35_ENHANCED", - "PASSTHROUGH" - ], - "type": "string" - }, - "Channel": { - "documentation": "A Channel resource configuration.", - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the Channel.", - "locationName": "arn", - "shape": "__string" - }, - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "HlsIngest": { - "locationName": "hlsIngest", - "shape": "HlsIngest" - }, - "Id": { - "documentation": "The ID of the Channel.", - "locationName": "id", - "shape": "__string" - } - }, - "type": "structure" - }, - "ChannelCreateParameters": { - "documentation": "Configuration parameters for a new Channel.", - "members": { - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "Id": { - "documentation": "The ID of the Channel. The ID must be unique within the region and it\ncannot be changed after a Channel is created.\n", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "ChannelList": { - "documentation": "A collection of Channel records.", - "members": { - "Channels": { - "documentation": "A list of Channel records.", - "locationName": "channels", - "shape": "__listOfChannel" - }, - "NextToken": { - "documentation": "A token that can be used to resume pagination from the end of the collection.", - "locationName": "nextToken", - "shape": "__string" - } - }, - "type": "structure" - }, - "ChannelUpdateParameters": { - "documentation": "Configuration parameters for updating an existing Channel.", - "members": { - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - } - }, - "type": "structure" - }, - "CmafEncryption": { - "documentation": "A Common Media Application Format (CMAF) encryption configuration.", - "members": { - "KeyRotationIntervalSeconds": { - "documentation": "Time (in seconds) between each encryption key rotation.", - "locationName": "keyRotationIntervalSeconds", - "shape": "__integer" - }, - "SpekeKeyProvider": { - "locationName": "spekeKeyProvider", - "shape": "SpekeKeyProvider" - } - }, - "required": [ - "SpekeKeyProvider" - ], - "type": "structure" - }, - "CmafPackage": { - "documentation": "A Common Media Application Format (CMAF) packaging configuration.", - "members": { - "Encryption": { - "locationName": "encryption", - "shape": "CmafEncryption" - }, - "HlsManifests": { - "documentation": "A list of HLS manifest configurations", - "locationName": "hlsManifests", - "shape": "__listOfHlsManifest" - }, - "SegmentDurationSeconds": { - "documentation": "Duration (in seconds) of each segment. Actual segments will be\nrounded to the nearest multiple of the source segment duration.\n", - "locationName": "segmentDurationSeconds", - "shape": "__integer" - }, - "SegmentPrefix": { - "documentation": "An optional custom string that is prepended to the name of each segment. If not specified, it defaults to the ChannelId.", - "locationName": "segmentPrefix", - "shape": "__string" - }, - "StreamSelection": { - "locationName": "streamSelection", - "shape": "StreamSelection" - } - }, - "type": "structure" - }, - "CmafPackageCreateOrUpdateParameters": { - "documentation": "A Common Media Application Format (CMAF) packaging configuration.", - "members": { - "Encryption": { - "locationName": "encryption", - "shape": "CmafEncryption" - }, - "HlsManifests": { - "documentation": "A list of HLS manifest configurations", - "locationName": "hlsManifests", - "shape": "__listOfHlsManifestCreateOrUpdateParameters" - }, - "SegmentDurationSeconds": { - "documentation": "Duration (in seconds) of each segment. Actual segments will be\nrounded to the nearest multiple of the source segment duration.\n", - "locationName": "segmentDurationSeconds", - "shape": "__integer" - }, - "SegmentPrefix": { - "documentation": "An optional custom string that is prepended to the name of each segment. If not specified, it defaults to the ChannelId.", - "locationName": "segmentPrefix", - "shape": "__string" - }, - "StreamSelection": { - "locationName": "streamSelection", - "shape": "StreamSelection" - } - }, - "type": "structure" - }, - "CreateChannelRequest": { - "documentation": "A new Channel configuration.", - "members": { - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "Id": { - "documentation": "The ID of the Channel. The ID must be unique within the region and it\ncannot be changed after a Channel is created.\n", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "CreateChannelResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the Channel.", - "locationName": "arn", - "shape": "__string" - }, - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "HlsIngest": { - "locationName": "hlsIngest", - "shape": "HlsIngest" - }, - "Id": { - "documentation": "The ID of the Channel.", - "locationName": "id", - "shape": "__string" - } - }, - "type": "structure" - }, - "CreateOriginEndpointRequest": { - "documentation": "Configuration parameters used to create a new OriginEndpoint.", - "members": { - "ChannelId": { - "documentation": "The ID of the Channel that the OriginEndpoint will be associated with.\nThis cannot be changed after the OriginEndpoint is created.\n", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackageCreateOrUpdateParameters" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint. The ID must be unique within the region\nand it cannot be changed after the OriginEndpoint is created.\n", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string that will be used as the filename of the OriginEndpoint URL (defaults to \"index\").", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "required": [ - "ChannelId", - "Id" - ], - "type": "structure" - }, - "CreateOriginEndpointResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the OriginEndpoint.", - "locationName": "arn", - "shape": "__string" - }, - "ChannelId": { - "documentation": "The ID of the Channel the OriginEndpoint is associated with.", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackage" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint.", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string appended to the end of the OriginEndpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Url": { - "documentation": "The URL of the packaged OriginEndpoint for consumption.", - "locationName": "url", - "shape": "__string" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "type": "structure" - }, - "DashEncryption": { - "documentation": "A Dynamic Adaptive Streaming over HTTP (DASH) encryption configuration.", - "members": { - "KeyRotationIntervalSeconds": { - "documentation": "Time (in seconds) between each encryption key rotation.", - "locationName": "keyRotationIntervalSeconds", - "shape": "__integer" - }, - "SpekeKeyProvider": { - "locationName": "spekeKeyProvider", - "shape": "SpekeKeyProvider" - } - }, - "required": [ - "SpekeKeyProvider" - ], - "type": "structure" - }, - "DashPackage": { - "documentation": "A Dynamic Adaptive Streaming over HTTP (DASH) packaging configuration.", - "members": { - "Encryption": { - "locationName": "encryption", - "shape": "DashEncryption" - }, - "ManifestWindowSeconds": { - "documentation": "Time window (in seconds) contained in each manifest.", - "locationName": "manifestWindowSeconds", - "shape": "__integer" - }, - "MinBufferTimeSeconds": { - "documentation": "Minimum duration (in seconds) that a player will buffer media before starting the presentation.", - "locationName": "minBufferTimeSeconds", - "shape": "__integer" - }, - "MinUpdatePeriodSeconds": { - "documentation": "Minimum duration (in seconds) between potential changes to the Dynamic Adaptive Streaming over HTTP (DASH) Media Presentation Description (MPD).", - "locationName": "minUpdatePeriodSeconds", - "shape": "__integer" - }, - "PeriodTriggers": { - "documentation": "A list of triggers that controls when the outgoing Dynamic Adaptive Streaming over HTTP (DASH)\nMedia Presentation Description (MPD) will be partitioned into multiple periods. If empty, the content will not\nbe partitioned into more than one period. If the list contains \"ADS\", new periods will be created where\nthe Channel source contains SCTE-35 ad markers.\n", - "locationName": "periodTriggers", - "shape": "__listOf__PeriodTriggersElement" - }, - "Profile": { - "documentation": "The Dynamic Adaptive Streaming over HTTP (DASH) profile type. When set to \"HBBTV_1_5\", HbbTV 1.5 compliant output is enabled.", - "locationName": "profile", - "shape": "Profile" - }, - "SegmentDurationSeconds": { - "documentation": "Duration (in seconds) of each segment. Actual segments will be\nrounded to the nearest multiple of the source segment duration.\n", - "locationName": "segmentDurationSeconds", - "shape": "__integer" - }, - "StreamSelection": { - "locationName": "streamSelection", - "shape": "StreamSelection" - }, - "SuggestedPresentationDelaySeconds": { - "documentation": "Duration (in seconds) to delay live content before presentation.", - "locationName": "suggestedPresentationDelaySeconds", - "shape": "__integer" - } - }, - "type": "structure" - }, - "DeleteChannelRequest": { - "members": { - "Id": { - "documentation": "The ID of the Channel to delete.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "DeleteChannelResponse": { - "members": {}, - "type": "structure" - }, - "DeleteOriginEndpointRequest": { - "members": { - "Id": { - "documentation": "The ID of the OriginEndpoint to delete.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "DeleteOriginEndpointResponse": { - "members": {}, - "type": "structure" - }, - "DescribeChannelRequest": { - "members": { - "Id": { - "documentation": "The ID of a Channel.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "DescribeChannelResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the Channel.", - "locationName": "arn", - "shape": "__string" - }, - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "HlsIngest": { - "locationName": "hlsIngest", - "shape": "HlsIngest" - }, - "Id": { - "documentation": "The ID of the Channel.", - "locationName": "id", - "shape": "__string" - } - }, - "type": "structure" - }, - "DescribeOriginEndpointRequest": { - "members": { - "Id": { - "documentation": "The ID of the OriginEndpoint.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "DescribeOriginEndpointResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the OriginEndpoint.", - "locationName": "arn", - "shape": "__string" - }, - "ChannelId": { - "documentation": "The ID of the Channel the OriginEndpoint is associated with.", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackage" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint.", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string appended to the end of the OriginEndpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Url": { - "documentation": "The URL of the packaged OriginEndpoint for consumption.", - "locationName": "url", - "shape": "__string" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "type": "structure" - }, - "EncryptionMethod": { - "enum": [ - "AES_128", - "SAMPLE_AES" - ], - "type": "string" - }, - "ForbiddenException": { - "documentation": "The client is not authorized to access the requested resource.", - "error": { - "httpStatusCode": 403 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "HlsEncryption": { - "documentation": "An HTTP Live Streaming (HLS) encryption configuration.", - "members": { - "ConstantInitializationVector": { - "documentation": "A constant initialization vector for encryption (optional).\nWhen not specified the initialization vector will be periodically rotated.\n", - "locationName": "constantInitializationVector", - "shape": "__string" - }, - "EncryptionMethod": { - "documentation": "The encryption method to use.", - "locationName": "encryptionMethod", - "shape": "EncryptionMethod" - }, - "KeyRotationIntervalSeconds": { - "documentation": "Interval (in seconds) between each encryption key rotation.", - "locationName": "keyRotationIntervalSeconds", - "shape": "__integer" - }, - "RepeatExtXKey": { - "documentation": "When enabled, the EXT-X-KEY tag will be repeated in output manifests.", - "locationName": "repeatExtXKey", - "shape": "__boolean" - }, - "SpekeKeyProvider": { - "locationName": "spekeKeyProvider", - "shape": "SpekeKeyProvider" - } - }, - "required": [ - "SpekeKeyProvider" - ], - "type": "structure" - }, - "HlsIngest": { - "documentation": "An HTTP Live Streaming (HLS) ingest resource configuration.", - "members": { - "IngestEndpoints": { - "documentation": "A list of endpoints to which the source stream should be sent.", - "locationName": "ingestEndpoints", - "shape": "__listOfIngestEndpoint" - } - }, - "type": "structure" - }, - "HlsManifest": { - "documentation": "A HTTP Live Streaming (HLS) manifest configuration.", - "members": { - "AdMarkers": { - "documentation": "This setting controls how ad markers are included in the packaged OriginEndpoint.\n\"NONE\" will omit all SCTE-35 ad markers from the output.\n\"PASSTHROUGH\" causes the manifest to contain a copy of the SCTE-35 ad\nmarkers (comments) taken directly from the input HTTP Live Streaming (HLS) manifest.\n\"SCTE35_ENHANCED\" generates ad markers and blackout tags based on SCTE-35\nmessages in the input source.\n", - "locationName": "adMarkers", - "shape": "AdMarkers" - }, - "Id": { - "documentation": "The ID of the manifest. The ID must be unique within the OriginEndpoint and it cannot be changed after it is created.", - "locationName": "id", - "shape": "__string" - }, - "IncludeIframeOnlyStream": { - "documentation": "When enabled, an I-Frame only stream will be included in the output.", - "locationName": "includeIframeOnlyStream", - "shape": "__boolean" - }, - "ManifestName": { - "documentation": "An optional short string appended to the end of the OriginEndpoint URL. If not specified, defaults to the manifestName for the OriginEndpoint.", - "locationName": "manifestName", - "shape": "__string" - }, - "PlaylistType": { - "documentation": "The HTTP Live Streaming (HLS) playlist type.\nWhen either \"EVENT\" or \"VOD\" is specified, a corresponding EXT-X-PLAYLIST-TYPE\nentry will be included in the media playlist.\n", - "locationName": "playlistType", - "shape": "PlaylistType" - }, - "PlaylistWindowSeconds": { - "documentation": "Time window (in seconds) contained in each parent manifest.", - "locationName": "playlistWindowSeconds", - "shape": "__integer" - }, - "ProgramDateTimeIntervalSeconds": { - "documentation": "The interval (in seconds) between each EXT-X-PROGRAM-DATE-TIME tag\ninserted into manifests. Additionally, when an interval is specified\nID3Timed Metadata messages will be generated every 5 seconds using the\ningest time of the content.\nIf the interval is not specified, or set to 0, then\nno EXT-X-PROGRAM-DATE-TIME tags will be inserted into manifests and no\nID3Timed Metadata messages will be generated. Note that irrespective\nof this parameter, if any ID3 Timed Metadata is found in HTTP Live Streaming (HLS) input,\nit will be passed through to HLS output.\n", - "locationName": "programDateTimeIntervalSeconds", - "shape": "__integer" - }, - "Url": { - "documentation": "The URL of the packaged OriginEndpoint for consumption.", - "locationName": "url", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "HlsManifestCreateOrUpdateParameters": { - "documentation": "A HTTP Live Streaming (HLS) manifest configuration.", - "members": { - "AdMarkers": { - "documentation": "This setting controls how ad markers are included in the packaged OriginEndpoint.\n\"NONE\" will omit all SCTE-35 ad markers from the output.\n\"PASSTHROUGH\" causes the manifest to contain a copy of the SCTE-35 ad\nmarkers (comments) taken directly from the input HTTP Live Streaming (HLS) manifest.\n\"SCTE35_ENHANCED\" generates ad markers and blackout tags based on SCTE-35\nmessages in the input source.\n", - "locationName": "adMarkers", - "shape": "AdMarkers" - }, - "Id": { - "documentation": "The ID of the manifest. The ID must be unique within the OriginEndpoint and it cannot be changed after it is created.", - "locationName": "id", - "shape": "__string" - }, - "IncludeIframeOnlyStream": { - "documentation": "When enabled, an I-Frame only stream will be included in the output.", - "locationName": "includeIframeOnlyStream", - "shape": "__boolean" - }, - "ManifestName": { - "documentation": "An optional short string appended to the end of the OriginEndpoint URL. If not specified, defaults to the manifestName for the OriginEndpoint.", - "locationName": "manifestName", - "shape": "__string" - }, - "PlaylistType": { - "documentation": "The HTTP Live Streaming (HLS) playlist type.\nWhen either \"EVENT\" or \"VOD\" is specified, a corresponding EXT-X-PLAYLIST-TYPE\nentry will be included in the media playlist.\n", - "locationName": "playlistType", - "shape": "PlaylistType" - }, - "PlaylistWindowSeconds": { - "documentation": "Time window (in seconds) contained in each parent manifest.", - "locationName": "playlistWindowSeconds", - "shape": "__integer" - }, - "ProgramDateTimeIntervalSeconds": { - "documentation": "The interval (in seconds) between each EXT-X-PROGRAM-DATE-TIME tag\ninserted into manifests. Additionally, when an interval is specified\nID3Timed Metadata messages will be generated every 5 seconds using the\ningest time of the content.\nIf the interval is not specified, or set to 0, then\nno EXT-X-PROGRAM-DATE-TIME tags will be inserted into manifests and no\nID3Timed Metadata messages will be generated. Note that irrespective\nof this parameter, if any ID3 Timed Metadata is found in HTTP Live Streaming (HLS) input,\nit will be passed through to HLS output.\n", - "locationName": "programDateTimeIntervalSeconds", - "shape": "__integer" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "HlsPackage": { - "documentation": "An HTTP Live Streaming (HLS) packaging configuration.", - "members": { - "AdMarkers": { - "documentation": "This setting controls how ad markers are included in the packaged OriginEndpoint.\n\"NONE\" will omit all SCTE-35 ad markers from the output.\n\"PASSTHROUGH\" causes the manifest to contain a copy of the SCTE-35 ad\nmarkers (comments) taken directly from the input HTTP Live Streaming (HLS) manifest.\n\"SCTE35_ENHANCED\" generates ad markers and blackout tags based on SCTE-35\nmessages in the input source.\n", - "locationName": "adMarkers", - "shape": "AdMarkers" - }, - "Encryption": { - "locationName": "encryption", - "shape": "HlsEncryption" - }, - "IncludeIframeOnlyStream": { - "documentation": "When enabled, an I-Frame only stream will be included in the output.", - "locationName": "includeIframeOnlyStream", - "shape": "__boolean" - }, - "PlaylistType": { - "documentation": "The HTTP Live Streaming (HLS) playlist type.\nWhen either \"EVENT\" or \"VOD\" is specified, a corresponding EXT-X-PLAYLIST-TYPE\nentry will be included in the media playlist.\n", - "locationName": "playlistType", - "shape": "PlaylistType" - }, - "PlaylistWindowSeconds": { - "documentation": "Time window (in seconds) contained in each parent manifest.", - "locationName": "playlistWindowSeconds", - "shape": "__integer" - }, - "ProgramDateTimeIntervalSeconds": { - "documentation": "The interval (in seconds) between each EXT-X-PROGRAM-DATE-TIME tag\ninserted into manifests. Additionally, when an interval is specified\nID3Timed Metadata messages will be generated every 5 seconds using the\ningest time of the content.\nIf the interval is not specified, or set to 0, then\nno EXT-X-PROGRAM-DATE-TIME tags will be inserted into manifests and no\nID3Timed Metadata messages will be generated. Note that irrespective\nof this parameter, if any ID3 Timed Metadata is found in HTTP Live Streaming (HLS) input,\nit will be passed through to HLS output.\n", - "locationName": "programDateTimeIntervalSeconds", - "shape": "__integer" - }, - "SegmentDurationSeconds": { - "documentation": "Duration (in seconds) of each fragment. Actual fragments will be\nrounded to the nearest multiple of the source fragment duration.\n", - "locationName": "segmentDurationSeconds", - "shape": "__integer" - }, - "StreamSelection": { - "locationName": "streamSelection", - "shape": "StreamSelection" - }, - "UseAudioRenditionGroup": { - "documentation": "When enabled, audio streams will be placed in rendition groups in the output.", - "locationName": "useAudioRenditionGroup", - "shape": "__boolean" - } - }, - "type": "structure" - }, - "IngestEndpoint": { - "documentation": "An endpoint for ingesting source content for a Channel.", - "members": { - "Password": { - "documentation": "The system generated password for ingest authentication.", - "locationName": "password", - "shape": "__string" - }, - "Url": { - "documentation": "The ingest URL to which the source stream should be sent.", - "locationName": "url", - "shape": "__string" - }, - "Username": { - "documentation": "The system generated username for ingest authentication.", - "locationName": "username", - "shape": "__string" - } - }, - "type": "structure" - }, - "InternalServerErrorException": { - "documentation": "An unexpected error occurred.", - "error": { - "httpStatusCode": 500 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "ListChannelsRequest": { - "members": { - "MaxResults": { - "documentation": "Upper bound on number of records to return.", - "location": "querystring", - "locationName": "maxResults", - "shape": "MaxResults" - }, - "NextToken": { - "documentation": "A token used to resume pagination from the end of a previous request.", - "location": "querystring", - "locationName": "nextToken", - "shape": "__string" - } - }, - "type": "structure" - }, - "ListChannelsResponse": { - "members": { - "Channels": { - "documentation": "A list of Channel records.", - "locationName": "channels", - "shape": "__listOfChannel" - }, - "NextToken": { - "documentation": "A token that can be used to resume pagination from the end of the collection.", - "locationName": "nextToken", - "shape": "__string" - } - }, - "type": "structure" - }, - "ListOriginEndpointsRequest": { - "members": { - "ChannelId": { - "documentation": "When specified, the request will return only OriginEndpoints associated with the given Channel ID.", - "location": "querystring", - "locationName": "channelId", - "shape": "__string" - }, - "MaxResults": { - "documentation": "The upper bound on the number of records to return.", - "location": "querystring", - "locationName": "maxResults", - "shape": "MaxResults" - }, - "NextToken": { - "documentation": "A token used to resume pagination from the end of a previous request.", - "location": "querystring", - "locationName": "nextToken", - "shape": "__string" - } - }, - "type": "structure" - }, - "ListOriginEndpointsResponse": { - "members": { - "NextToken": { - "documentation": "A token that can be used to resume pagination from the end of the collection.", - "locationName": "nextToken", - "shape": "__string" - }, - "OriginEndpoints": { - "documentation": "A list of OriginEndpoint records.", - "locationName": "originEndpoints", - "shape": "__listOfOriginEndpoint" - } - }, - "type": "structure" - }, - "MaxResults": { - "max": 1000, - "min": 1, - "type": "integer" - }, - "MssEncryption": { - "documentation": "A Microsoft Smooth Streaming (MSS) encryption configuration.", - "members": { - "SpekeKeyProvider": { - "locationName": "spekeKeyProvider", - "shape": "SpekeKeyProvider" - } - }, - "required": [ - "SpekeKeyProvider" - ], - "type": "structure" - }, - "MssPackage": { - "documentation": "A Microsoft Smooth Streaming (MSS) packaging configuration.", - "members": { - "Encryption": { - "locationName": "encryption", - "shape": "MssEncryption" - }, - "ManifestWindowSeconds": { - "documentation": "The time window (in seconds) contained in each manifest.", - "locationName": "manifestWindowSeconds", - "shape": "__integer" - }, - "SegmentDurationSeconds": { - "documentation": "The duration (in seconds) of each segment.", - "locationName": "segmentDurationSeconds", - "shape": "__integer" - }, - "StreamSelection": { - "locationName": "streamSelection", - "shape": "StreamSelection" - } - }, - "type": "structure" - }, - "NotFoundException": { - "documentation": "The requested resource does not exist.", - "error": { - "httpStatusCode": 404 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "OriginEndpoint": { - "documentation": "An OriginEndpoint resource configuration.", - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the OriginEndpoint.", - "locationName": "arn", - "shape": "__string" - }, - "ChannelId": { - "documentation": "The ID of the Channel the OriginEndpoint is associated with.", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackage" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint.", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string appended to the end of the OriginEndpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Url": { - "documentation": "The URL of the packaged OriginEndpoint for consumption.", - "locationName": "url", - "shape": "__string" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "type": "structure" - }, - "OriginEndpointCreateParameters": { - "documentation": "Configuration parameters for a new OriginEndpoint.", - "members": { - "ChannelId": { - "documentation": "The ID of the Channel that the OriginEndpoint will be associated with.\nThis cannot be changed after the OriginEndpoint is created.\n", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackageCreateOrUpdateParameters" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint. The ID must be unique within the region\nand it cannot be changed after the OriginEndpoint is created.\n", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string that will be used as the filename of the OriginEndpoint URL (defaults to \"index\").", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "required": [ - "Id", - "ChannelId" - ], - "type": "structure" - }, - "OriginEndpointList": { - "documentation": "A collection of OriginEndpoint records.", - "members": { - "NextToken": { - "documentation": "A token that can be used to resume pagination from the end of the collection.", - "locationName": "nextToken", - "shape": "__string" - }, - "OriginEndpoints": { - "documentation": "A list of OriginEndpoint records.", - "locationName": "originEndpoints", - "shape": "__listOfOriginEndpoint" - } - }, - "type": "structure" - }, - "OriginEndpointUpdateParameters": { - "documentation": "Configuration parameters for updating an existing OriginEndpoint.", - "members": { - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackageCreateOrUpdateParameters" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "ManifestName": { - "documentation": "A short string that will be appended to the end of the Endpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (in seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (in seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "type": "structure" - }, - "PlaylistType": { - "enum": [ - "NONE", - "EVENT", - "VOD" - ], - "type": "string" - }, - "Profile": { - "enum": [ - "NONE", - "HBBTV_1_5" - ], - "type": "string" - }, - "RotateChannelCredentialsRequest": { - "members": { - "Id": { - "documentation": "The ID of the channel to update.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "RotateChannelCredentialsResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the Channel.", - "locationName": "arn", - "shape": "__string" - }, - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "HlsIngest": { - "locationName": "hlsIngest", - "shape": "HlsIngest" - }, - "Id": { - "documentation": "The ID of the Channel.", - "locationName": "id", - "shape": "__string" - } - }, - "type": "structure" - }, - "ServiceUnavailableException": { - "documentation": "An unexpected error occurred.", - "error": { - "httpStatusCode": 503 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "SpekeKeyProvider": { - "documentation": "A configuration for accessing an external Secure Packager and Encoder Key Exchange (SPEKE) service that will provide encryption keys.", - "members": { - "ResourceId": { - "documentation": "The resource ID to include in key requests.", - "locationName": "resourceId", - "shape": "__string" - }, - "RoleArn": { - "documentation": "An Amazon Resource Name (ARN) of an IAM role that AWS Elemental\nMediaPackage will assume when accessing the key provider service.\n", - "locationName": "roleArn", - "shape": "__string" - }, - "SystemIds": { - "documentation": "The system IDs to include in key requests.", - "locationName": "systemIds", - "shape": "__listOf__string" - }, - "Url": { - "documentation": "The URL of the external key provider service.", - "locationName": "url", - "shape": "__string" - } - }, - "required": [ - "Url", - "ResourceId", - "RoleArn", - "SystemIds" - ], - "type": "structure" - }, - "StreamOrder": { - "enum": [ - "ORIGINAL", - "VIDEO_BITRATE_ASCENDING", - "VIDEO_BITRATE_DESCENDING" - ], - "type": "string" - }, - "StreamSelection": { - "documentation": "A StreamSelection configuration.", - "members": { - "MaxVideoBitsPerSecond": { - "documentation": "The maximum video bitrate (bps) to include in output.", - "locationName": "maxVideoBitsPerSecond", - "shape": "__integer" - }, - "MinVideoBitsPerSecond": { - "documentation": "The minimum video bitrate (bps) to include in output.", - "locationName": "minVideoBitsPerSecond", - "shape": "__integer" - }, - "StreamOrder": { - "documentation": "A directive that determines the order of streams in the output.", - "locationName": "streamOrder", - "shape": "StreamOrder" - } - }, - "type": "structure" - }, - "TooManyRequestsException": { - "documentation": "The client has exceeded their resource or throttling limits.", - "error": { - "httpStatusCode": 429 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "UnprocessableEntityException": { - "documentation": "The parameters sent in the request are not valid.", - "error": { - "httpStatusCode": 422 - }, - "exception": true, - "members": { - "Message": { - "locationName": "message", - "shape": "__string" - } - }, - "type": "structure" - }, - "UpdateChannelRequest": { - "documentation": "Configuration parameters used to update the Channel.", - "members": { - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "Id": { - "documentation": "The ID of the Channel to update.", - "location": "uri", - "locationName": "id", - "shape": "__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "UpdateChannelResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the Channel.", - "locationName": "arn", - "shape": "__string" - }, - "Description": { - "documentation": "A short text description of the Channel.", - "locationName": "description", - "shape": "__string" - }, - "HlsIngest": { - "locationName": "hlsIngest", - "shape": "HlsIngest" - }, - "Id": { - "documentation": "The ID of the Channel.", - "locationName": "id", - "shape": "__string" - } - }, - "type": "structure" - }, - "UpdateOriginEndpointRequest": { - "documentation": "Configuration parameters used to update an existing OriginEndpoint.", - "members": { - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackageCreateOrUpdateParameters" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint to update.", - "location": "uri", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string that will be appended to the end of the Endpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (in seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (in seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "required": [ - "Id" - ], - "type": "structure" - }, - "UpdateOriginEndpointResponse": { - "members": { - "Arn": { - "documentation": "The Amazon Resource Name (ARN) assigned to the OriginEndpoint.", - "locationName": "arn", - "shape": "__string" - }, - "ChannelId": { - "documentation": "The ID of the Channel the OriginEndpoint is associated with.", - "locationName": "channelId", - "shape": "__string" - }, - "CmafPackage": { - "locationName": "cmafPackage", - "shape": "CmafPackage" - }, - "DashPackage": { - "locationName": "dashPackage", - "shape": "DashPackage" - }, - "Description": { - "documentation": "A short text description of the OriginEndpoint.", - "locationName": "description", - "shape": "__string" - }, - "HlsPackage": { - "locationName": "hlsPackage", - "shape": "HlsPackage" - }, - "Id": { - "documentation": "The ID of the OriginEndpoint.", - "locationName": "id", - "shape": "__string" - }, - "ManifestName": { - "documentation": "A short string appended to the end of the OriginEndpoint URL.", - "locationName": "manifestName", - "shape": "__string" - }, - "MssPackage": { - "locationName": "mssPackage", - "shape": "MssPackage" - }, - "StartoverWindowSeconds": { - "documentation": "Maximum duration (seconds) of content to retain for startover playback.\nIf not specified, startover playback will be disabled for the OriginEndpoint.\n", - "locationName": "startoverWindowSeconds", - "shape": "__integer" - }, - "TimeDelaySeconds": { - "documentation": "Amount of delay (seconds) to enforce on the playback of live content.\nIf not specified, there will be no time delay in effect for the OriginEndpoint.\n", - "locationName": "timeDelaySeconds", - "shape": "__integer" - }, - "Url": { - "documentation": "The URL of the packaged OriginEndpoint for consumption.", - "locationName": "url", - "shape": "__string" - }, - "Whitelist": { - "documentation": "A list of source IP CIDR blocks that will be allowed to access the OriginEndpoint.", - "locationName": "whitelist", - "shape": "__listOf__string" - } - }, - "type": "structure" - }, - "__PeriodTriggersElement": { - "enum": [ - "ADS" - ], - "type": "string" - }, - "__boolean": { - "type": "boolean" - }, - "__double": { - "type": "double" - }, - "__integer": { - "type": "integer" - }, - "__listOfChannel": { - "member": { - "shape": "Channel" - }, - "type": "list" - }, - "__listOfHlsManifest": { - "member": { - "shape": "HlsManifest" - }, - "type": "list" - }, - "__listOfHlsManifestCreateOrUpdateParameters": { - "member": { - "shape": "HlsManifestCreateOrUpdateParameters" - }, - "type": "list" - }, - "__listOfIngestEndpoint": { - "member": { - "shape": "IngestEndpoint" - }, - "type": "list" - }, - "__listOfOriginEndpoint": { - "member": { - "shape": "OriginEndpoint" - }, - "type": "list" - }, - "__listOf__PeriodTriggersElement": { - "member": { - "shape": "__PeriodTriggersElement" - }, - "type": "list" - }, - "__listOf__string": { - "member": { - "shape": "__string" - }, - "type": "list" - }, - "__long": { - "type": "long" - }, - "__string": { - "type": "string" - } - } -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/service-2.json deleted file mode 100644 index 024feff1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore-data/2017-09-01/service-2.json +++ /dev/null @@ -1,465 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-01", - "endpointPrefix":"data.mediastore", - "protocol":"rest-json", - "serviceAbbreviation":"MediaStore Data", - "serviceFullName":"AWS Elemental MediaStore Data Plane", - "serviceId":"MediaStore Data", - "signatureVersion":"v4", - "signingName":"mediastore", - "uid":"mediastore-data-2017-09-01" - }, - "operations":{ - "DeleteObject":{ - "name":"DeleteObject", - "http":{ - "method":"DELETE", - "requestUri":"/{Path+}" - }, - "input":{"shape":"DeleteObjectRequest"}, - "output":{"shape":"DeleteObjectResponse"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes an object at the specified path.

" - }, - "DescribeObject":{ - "name":"DescribeObject", - "http":{ - "method":"HEAD", - "requestUri":"/{Path+}" - }, - "input":{"shape":"DescribeObjectRequest"}, - "output":{"shape":"DescribeObjectResponse"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gets the headers for an object at the specified path.

" - }, - "GetObject":{ - "name":"GetObject", - "http":{ - "method":"GET", - "requestUri":"/{Path+}" - }, - "input":{"shape":"GetObjectRequest"}, - "output":{"shape":"GetObjectResponse"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"ObjectNotFoundException"}, - {"shape":"RequestedRangeNotSatisfiableException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Downloads the object at the specified path.

" - }, - "ListItems":{ - "name":"ListItems", - "http":{ - "method":"GET", - "requestUri":"/" - }, - "input":{"shape":"ListItemsRequest"}, - "output":{"shape":"ListItemsResponse"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Provides a list of metadata entries about folders and objects in the specified folder.

" - }, - "PutObject":{ - "name":"PutObject", - "http":{ - "method":"PUT", - "requestUri":"/{Path+}" - }, - "input":{"shape":"PutObjectRequest"}, - "output":{"shape":"PutObjectResponse"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Uploads an object to the specified path. Object sizes are limited to 10 MB.

", - "authtype":"v4-unsigned-body" - } - }, - "shapes":{ - "ContainerNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified container was not found for the specified account.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ContentRangePattern":{ - "type":"string", - "pattern":"^bytes=\\d+\\-\\d+/\\d+$" - }, - "ContentType":{ - "type":"string", - "pattern":"^[\\w\\-\\/\\.]{1,255}$" - }, - "DeleteObjectRequest":{ - "type":"structure", - "required":["Path"], - "members":{ - "Path":{ - "shape":"PathNaming", - "documentation":"

The path (including the file name) where the object is stored in the container. Format: <folder name>/<folder name>/<file name>

", - "location":"uri", - "locationName":"Path" - } - } - }, - "DeleteObjectResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeObjectRequest":{ - "type":"structure", - "required":["Path"], - "members":{ - "Path":{ - "shape":"PathNaming", - "documentation":"

The path (including the file name) where the object is stored in the container. Format: <folder name>/<folder name>/<file name>

", - "location":"uri", - "locationName":"Path" - } - } - }, - "DescribeObjectResponse":{ - "type":"structure", - "members":{ - "ETag":{ - "shape":"ETag", - "documentation":"

The ETag that represents a unique instance of the object.

", - "location":"header", - "locationName":"ETag" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the object.

", - "location":"header", - "locationName":"Content-Type" - }, - "ContentLength":{ - "shape":"NonNegativeLong", - "documentation":"

The length of the object in bytes.

", - "location":"header", - "locationName":"Content-Length" - }, - "CacheControl":{ - "shape":"StringPrimitive", - "documentation":"

An optional CacheControl header that allows the caller to control the object's cache behavior. Headers can be passed in as specified in the HTTP at https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9.

Headers with a custom user-defined value are also accepted.

", - "location":"header", - "locationName":"Cache-Control" - }, - "LastModified":{ - "shape":"TimeStamp", - "documentation":"

The date and time that the object was last modified.

", - "location":"header", - "locationName":"Last-Modified" - } - } - }, - "ETag":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[0-9A-Fa-f]+" - }, - "ErrorMessage":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[ \\w:\\.\\?-]+" - }, - "GetObjectRequest":{ - "type":"structure", - "required":["Path"], - "members":{ - "Path":{ - "shape":"PathNaming", - "documentation":"

The path (including the file name) where the object is stored in the container. Format: <folder name>/<folder name>/<file name>

For example, to upload the file mlaw.avi to the folder path premium\\canada in the container movies, enter the path premium/canada/mlaw.avi.

Do not include the container name in this path.

If the path includes any folders that don't exist yet, the service creates them. For example, suppose you have an existing premium/usa subfolder. If you specify premium/canada, the service creates a canada subfolder in the premium folder. You then have two subfolders, usa and canada, in the premium folder.

There is no correlation between the path to the source and the path (folders) in the container in AWS Elemental MediaStore.

For more information about folders and how they exist in a container, see the AWS Elemental MediaStore User Guide.

The file name is the name that is assigned to the file that you upload. The file can have the same name inside and outside of AWS Elemental MediaStore, or it can have the same name. The file name can include or omit an extension.

", - "location":"uri", - "locationName":"Path" - }, - "Range":{ - "shape":"RangePattern", - "documentation":"

The range bytes of an object to retrieve. For more information about the Range header, go to http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.

", - "location":"header", - "locationName":"Range" - } - } - }, - "GetObjectResponse":{ - "type":"structure", - "required":["StatusCode"], - "members":{ - "Body":{ - "shape":"PayloadBlob", - "documentation":"

The bytes of the object.

" - }, - "CacheControl":{ - "shape":"StringPrimitive", - "documentation":"

An optional CacheControl header that allows the caller to control the object's cache behavior. Headers can be passed in as specified in the HTTP spec at https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9.

Headers with a custom user-defined value are also accepted.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentRange":{ - "shape":"ContentRangePattern", - "documentation":"

The range of bytes to retrieve.

", - "location":"header", - "locationName":"Content-Range" - }, - "ContentLength":{ - "shape":"NonNegativeLong", - "documentation":"

The length of the object in bytes.

", - "location":"header", - "locationName":"Content-Length" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the object.

", - "location":"header", - "locationName":"Content-Type" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

The ETag that represents a unique instance of the object.

", - "location":"header", - "locationName":"ETag" - }, - "LastModified":{ - "shape":"TimeStamp", - "documentation":"

The date and time that the object was last modified.

", - "location":"header", - "locationName":"Last-Modified" - }, - "StatusCode":{ - "shape":"statusCode", - "documentation":"

The HTML status code of the request. Status codes ranging from 200 to 299 indicate success. All other status codes indicate the type of error that occurred.

", - "location":"statusCode" - } - }, - "payload":"Body" - }, - "InternalServerError":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service is temporarily unavailable.

", - "exception":true, - "fault":true - }, - "Item":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ItemName", - "documentation":"

The name of the item.

" - }, - "Type":{ - "shape":"ItemType", - "documentation":"

The item type (folder or object).

" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

The ETag that represents a unique instance of the item.

" - }, - "LastModified":{ - "shape":"TimeStamp", - "documentation":"

The date and time that the item was last modified.

" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the item.

" - }, - "ContentLength":{ - "shape":"NonNegativeLong", - "documentation":"

The length of the item in bytes.

" - } - }, - "documentation":"

A metadata entry for a folder or object.

" - }, - "ItemList":{ - "type":"list", - "member":{"shape":"Item"} - }, - "ItemName":{ - "type":"string", - "pattern":"[A-Za-z0-9_\\.\\-\\~]+" - }, - "ItemType":{ - "type":"string", - "enum":[ - "OBJECT", - "FOLDER" - ] - }, - "ListItemsRequest":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"ListPathNaming", - "documentation":"

The path in the container from which to retrieve items. Format: <folder name>/<folder name>/<file name>

", - "location":"querystring", - "locationName":"Path" - }, - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The maximum results to return. The service might return fewer results.

", - "location":"querystring", - "locationName":"MaxResults" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The NextToken received in the ListItemsResponse for the same container and path. Tokens expire after 15 minutes.

", - "location":"querystring", - "locationName":"NextToken" - } - } - }, - "ListItemsResponse":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"ItemList", - "documentation":"

Metadata entries for the folders and objects at the requested path.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The NextToken used to request the next page of results using ListItems.

" - } - } - }, - "ListLimit":{ - "type":"integer", - "max":1000, - "min":1 - }, - "ListPathNaming":{ - "type":"string", - "max":900, - "min":0, - "pattern":"/?(?:[A-Za-z0-9_\\.\\-\\~]+/){0,10}(?:[A-Za-z0-9_\\.\\-\\~]+)?/?" - }, - "NonNegativeLong":{ - "type":"long", - "min":0 - }, - "ObjectNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Could not perform an operation on an object that does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "PaginationToken":{"type":"string"}, - "PathNaming":{ - "type":"string", - "max":900, - "min":1, - "pattern":"(?:[A-Za-z0-9_\\.\\-\\~]+/){0,10}[A-Za-z0-9_\\.\\-\\~]+" - }, - "PayloadBlob":{ - "type":"blob", - "streaming":true - }, - "PutObjectRequest":{ - "type":"structure", - "required":[ - "Body", - "Path" - ], - "members":{ - "Body":{ - "shape":"PayloadBlob", - "documentation":"

The bytes to be stored.

" - }, - "Path":{ - "shape":"PathNaming", - "documentation":"

The path (including the file name) where the object is stored in the container. Format: <folder name>/<folder name>/<file name>

For example, to upload the file mlaw.avi to the folder path premium\\canada in the container movies, enter the path premium/canada/mlaw.avi.

Do not include the container name in this path.

If the path includes any folders that don't exist yet, the service creates them. For example, suppose you have an existing premium/usa subfolder. If you specify premium/canada, the service creates a canada subfolder in the premium folder. You then have two subfolders, usa and canada, in the premium folder.

There is no correlation between the path to the source and the path (folders) in the container in AWS Elemental MediaStore.

For more information about folders and how they exist in a container, see the AWS Elemental MediaStore User Guide.

The file name is the name that is assigned to the file that you upload. The file can have the same name inside and outside of AWS Elemental MediaStore, or it can have the same name. The file name can include or omit an extension.

", - "location":"uri", - "locationName":"Path" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The content type of the object.

", - "location":"header", - "locationName":"Content-Type" - }, - "CacheControl":{ - "shape":"StringPrimitive", - "documentation":"

An optional CacheControl header that allows the caller to control the object's cache behavior. Headers can be passed in as specified in the HTTP at https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9.

Headers with a custom user-defined value are also accepted.

", - "location":"header", - "locationName":"Cache-Control" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

Indicates the storage class of a Put request. Defaults to high-performance temporal storage class, and objects are persisted into durable storage shortly after being received.

", - "location":"header", - "locationName":"x-amz-storage-class" - } - }, - "payload":"Body" - }, - "PutObjectResponse":{ - "type":"structure", - "members":{ - "ContentSHA256":{ - "shape":"SHA256Hash", - "documentation":"

The SHA256 digest of the object that is persisted.

" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

Unique identifier of the object in the container.

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The storage class where the object was persisted. Should be “Temporal”.

" - } - } - }, - "RangePattern":{ - "type":"string", - "pattern":"^bytes=(?:\\d+\\-\\d*|\\d*\\-\\d+)$" - }, - "RequestedRangeNotSatisfiableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The requested content range is not valid.

", - "error":{"httpStatusCode":416}, - "exception":true - }, - "SHA256Hash":{ - "type":"string", - "max":64, - "min":64, - "pattern":"[0-9A-Fa-f]{64}" - }, - "StorageClass":{ - "type":"string", - "enum":["TEMPORAL"], - "max":16, - "min":1 - }, - "StringPrimitive":{"type":"string"}, - "TimeStamp":{"type":"timestamp"}, - "statusCode":{"type":"integer"} - }, - "documentation":"

An AWS Elemental MediaStore asset is an object, similar to an object in the Amazon S3 service. Objects are the fundamental entities that are stored in AWS Elemental MediaStore.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/service-2.json deleted file mode 100644 index 4e2ce7ec..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediastore/2017-09-01/service-2.json +++ /dev/null @@ -1,570 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-09-01", - "endpointPrefix":"mediastore", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"MediaStore", - "serviceFullName":"AWS Elemental MediaStore", - "serviceId":"MediaStore", - "signatureVersion":"v4", - "signingName":"mediastore", - "targetPrefix":"MediaStore_20170901", - "uid":"mediastore-2017-09-01" - }, - "operations":{ - "CreateContainer":{ - "name":"CreateContainer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateContainerInput"}, - "output":{"shape":"CreateContainerOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a storage container to hold objects. A container is similar to a bucket in the Amazon S3 service.

" - }, - "DeleteContainer":{ - "name":"DeleteContainer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteContainerInput"}, - "output":{"shape":"DeleteContainerOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"ContainerNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the specified container. Before you make a DeleteContainer request, delete any objects in the container or in any folders in the container. You can delete only empty containers.

" - }, - "DeleteContainerPolicy":{ - "name":"DeleteContainerPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteContainerPolicyInput"}, - "output":{"shape":"DeleteContainerPolicyOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"ContainerNotFoundException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the access policy that is associated with the specified container.

" - }, - "DeleteCorsPolicy":{ - "name":"DeleteCorsPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCorsPolicyInput"}, - "output":{"shape":"DeleteCorsPolicyOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"ContainerNotFoundException"}, - {"shape":"CorsPolicyNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:DeleteCorsPolicy action. The container owner has this permission by default and can grant this permission to others.

" - }, - "DescribeContainer":{ - "name":"DescribeContainer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeContainerInput"}, - "output":{"shape":"DescribeContainerOutput"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the properties of the requested container. This request is commonly used to retrieve the endpoint of a container. An endpoint is a value assigned by the service when a new container is created. A container's endpoint does not change after it has been assigned. The DescribeContainer request returns a single Container object based on ContainerName. To return all Container objects that are associated with a specified AWS account, use ListContainers.

" - }, - "GetContainerPolicy":{ - "name":"GetContainerPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContainerPolicyInput"}, - "output":{"shape":"GetContainerPolicyOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"ContainerNotFoundException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the access policy for the specified container. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

" - }, - "GetCorsPolicy":{ - "name":"GetCorsPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCorsPolicyInput"}, - "output":{"shape":"GetCorsPolicyOutput"}, - "errors":[ - {"shape":"ContainerInUseException"}, - {"shape":"ContainerNotFoundException"}, - {"shape":"CorsPolicyNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:GetCorsPolicy action. By default, the container owner has this permission and can grant it to others.

" - }, - "ListContainers":{ - "name":"ListContainers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListContainersInput"}, - "output":{"shape":"ListContainersOutput"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the properties of all containers in AWS Elemental MediaStore.

You can query to receive all the containers in one response. Or you can include the MaxResults parameter to receive a limited number of containers in each response. In this case, the response includes a token. To get the next set of containers, send the command again, this time with the NextToken parameter (with the returned token as its value). The next set of responses appears, with a token if there are still more containers to receive.

See also DescribeContainer, which gets the properties of one container.

" - }, - "PutContainerPolicy":{ - "name":"PutContainerPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutContainerPolicyInput"}, - "output":{"shape":"PutContainerPolicyOutput"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"ContainerInUseException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates an access policy for the specified container to restrict the users and clients that can access it. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

For this release of the REST API, you can create only one policy for a container. If you enter PutContainerPolicy twice, the second command modifies the existing policy.

" - }, - "PutCorsPolicy":{ - "name":"PutCorsPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutCorsPolicyInput"}, - "output":{"shape":"PutCorsPolicyOutput"}, - "errors":[ - {"shape":"ContainerNotFoundException"}, - {"shape":"ContainerInUseException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests. For example, you might want to enable a request whose origin is http://www.example.com to access your AWS Elemental MediaStore container at my.example.container.com by using the browser's XMLHttpRequest capability.

To enable CORS on a container, you attach a CORS policy to the container. In the CORS policy, you configure rules that identify origins and the HTTP methods that can be executed on your container. The policy can contain up to 398,000 characters. You can add up to 100 rules to a CORS policy. If more than one rule applies, the service uses the first applicable rule listed.

" - } - }, - "shapes":{ - "AllowedHeaders":{ - "type":"list", - "member":{"shape":"Header"}, - "max":100, - "min":0 - }, - "AllowedMethods":{ - "type":"list", - "member":{"shape":"MethodName"} - }, - "AllowedOrigins":{ - "type":"list", - "member":{"shape":"Origin"} - }, - "Container":{ - "type":"structure", - "members":{ - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The DNS endpoint of the container. Use the endpoint to identify the specific container when sending requests to the data plane. The service assigns this value when the container is created. Once the value has been assigned, it does not change.

" - }, - "CreationTime":{ - "shape":"TimeStamp", - "documentation":"

Unix timestamp.

" - }, - "ARN":{ - "shape":"ContainerARN", - "documentation":"

The Amazon Resource Name (ARN) of the container. The ARN has the following format:

arn:aws:<region>:<account that owns this container>:container/<name of container>

For example: arn:aws:mediastore:us-west-2:111122223333:container/movies

" - }, - "Name":{ - "shape":"ContainerName", - "documentation":"

The name of the container.

" - }, - "Status":{ - "shape":"ContainerStatus", - "documentation":"

The status of container creation or deletion. The status is one of the following: CREATING, ACTIVE, or DELETING. While the service is creating the container, the status is CREATING. When the endpoint is available, the status changes to ACTIVE.

" - } - }, - "documentation":"

This section describes operations that you can perform on an AWS Elemental MediaStore container.

" - }, - "ContainerARN":{ - "type":"string", - "max":1024, - "min":1, - "pattern":"arn:aws:mediastore:[a-z]+-[a-z]+-\\d:\\d{12}:container/\\w{1,255}" - }, - "ContainerInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Resource already exists or is being updated.

", - "exception":true - }, - "ContainerList":{ - "type":"list", - "member":{"shape":"Container"} - }, - "ContainerListLimit":{ - "type":"integer", - "max":100, - "min":1 - }, - "ContainerName":{ - "type":"string", - "max":255, - "min":1, - "pattern":"\\w+" - }, - "ContainerNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Could not perform an operation on a container that does not exist.

", - "exception":true - }, - "ContainerPolicy":{ - "type":"string", - "max":8192, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "ContainerStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "CREATING", - "DELETING" - ], - "max":16, - "min":1 - }, - "CorsPolicy":{ - "type":"list", - "member":{"shape":"CorsRule"}, - "documentation":"

The CORS policy of the container.

", - "max":100, - "min":1 - }, - "CorsPolicyNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Could not perform an operation on a policy that does not exist.

", - "exception":true - }, - "CorsRule":{ - "type":"structure", - "members":{ - "AllowedOrigins":{ - "shape":"AllowedOrigins", - "documentation":"

One or more response headers that you want users to be able to access from their applications (for example, from a JavaScript XMLHttpRequest object).

Each CORS rule must have at least one AllowedOrigin element. The string value can include only one wildcard character (*), for example, http://*.example.com. Additionally, you can specify only one wildcard character to allow cross-origin access for all origins.

" - }, - "AllowedMethods":{ - "shape":"AllowedMethods", - "documentation":"

Identifies an HTTP method that the origin that is specified in the rule is allowed to execute.

Each CORS rule must contain at least one AllowedMethod and one AllowedOrigin element.

" - }, - "AllowedHeaders":{ - "shape":"AllowedHeaders", - "documentation":"

Specifies which headers are allowed in a preflight OPTIONS request through the Access-Control-Request-Headers header. Each header name that is specified in Access-Control-Request-Headers must have a corresponding entry in the rule. Only the headers that were requested are sent back.

This element can contain only one wildcard character (*).

" - }, - "MaxAgeSeconds":{ - "shape":"MaxAgeSeconds", - "documentation":"

The time in seconds that your browser caches the preflight response for the specified resource.

A CORS rule can have only one MaxAgeSeconds element.

" - }, - "ExposeHeaders":{ - "shape":"ExposeHeaders", - "documentation":"

One or more headers in the response that you want users to be able to access from their applications (for example, from a JavaScript XMLHttpRequest object).

This element is optional for each rule.

" - } - }, - "documentation":"

A rule for a CORS policy. You can add up to 100 rules to a CORS policy. If more than one rule applies, the service uses the first applicable rule listed.

" - }, - "CreateContainerInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name for the container. The name must be from 1 to 255 characters. Container names must be unique to your AWS account within a specific region. As an example, you could create a container named movies in every region, as long as you don’t have an existing container with that name.

" - } - } - }, - "CreateContainerOutput":{ - "type":"structure", - "required":["Container"], - "members":{ - "Container":{ - "shape":"Container", - "documentation":"

ContainerARN: The Amazon Resource Name (ARN) of the newly created container. The ARN has the following format: arn:aws:<region>:<account that owns this container>:container/<name of container>. For example: arn:aws:mediastore:us-west-2:111122223333:container/movies

ContainerName: The container name as specified in the request.

CreationTime: Unix time stamp.

Status: The status of container creation or deletion. The status is one of the following: CREATING, ACTIVE, or DELETING. While the service is creating the container, the status is CREATING. When an endpoint is available, the status changes to ACTIVE.

The return value does not include the container's endpoint. To make downstream requests, you must obtain this value by using DescribeContainer or ListContainers.

" - } - } - }, - "DeleteContainerInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container to delete.

" - } - } - }, - "DeleteContainerOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteContainerPolicyInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container that holds the policy.

" - } - } - }, - "DeleteContainerPolicyOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteCorsPolicyInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container to remove the policy from.

" - } - } - }, - "DeleteCorsPolicyOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeContainerInput":{ - "type":"structure", - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container to query.

" - } - } - }, - "DescribeContainerOutput":{ - "type":"structure", - "members":{ - "Container":{ - "shape":"Container", - "documentation":"

The name of the queried container.

" - } - } - }, - "Endpoint":{ - "type":"string", - "max":255, - "min":1 - }, - "ErrorMessage":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[ \\w:\\.\\?-]+" - }, - "ExposeHeaders":{ - "type":"list", - "member":{"shape":"Header"}, - "max":100, - "min":0 - }, - "GetContainerPolicyInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container.

" - } - } - }, - "GetContainerPolicyOutput":{ - "type":"structure", - "required":["Policy"], - "members":{ - "Policy":{ - "shape":"ContainerPolicy", - "documentation":"

The contents of the access policy.

" - } - } - }, - "GetCorsPolicyInput":{ - "type":"structure", - "required":["ContainerName"], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container that the policy is assigned to.

" - } - } - }, - "GetCorsPolicyOutput":{ - "type":"structure", - "required":["CorsPolicy"], - "members":{ - "CorsPolicy":{"shape":"CorsPolicy"} - } - }, - "Header":{ - "type":"string", - "max":8192, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "InternalServerError":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service is temporarily unavailable.

", - "exception":true, - "fault":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

A service limit has been exceeded.

", - "exception":true - }, - "ListContainersInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Only if you used MaxResults in the first command, enter the token (which was included in the previous response) to obtain the next set of containers. This token is included in a response only if there actually are more containers to list.

" - }, - "MaxResults":{ - "shape":"ContainerListLimit", - "documentation":"

Enter the maximum number of containers in the response. Use from 1 to 255 characters.

" - } - } - }, - "ListContainersOutput":{ - "type":"structure", - "required":["Containers"], - "members":{ - "Containers":{ - "shape":"ContainerList", - "documentation":"

The names of the containers.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

NextToken is the token to use in the next call to ListContainers. This token is returned only if you included the MaxResults tag in the original command, and only if there are still containers to return.

" - } - } - }, - "MaxAgeSeconds":{ - "type":"integer", - "max":2147483647, - "min":0 - }, - "MethodName":{ - "type":"string", - "enum":[ - "PUT", - "GET", - "DELETE", - "HEAD" - ] - }, - "Origin":{ - "type":"string", - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "PaginationToken":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[0-9A-Za-z=/+]+" - }, - "PolicyNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Could not perform an operation on a policy that does not exist.

", - "exception":true - }, - "PutContainerPolicyInput":{ - "type":"structure", - "required":[ - "ContainerName", - "Policy" - ], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container.

" - }, - "Policy":{ - "shape":"ContainerPolicy", - "documentation":"

The contents of the policy, which includes the following:

  • One Version tag

  • One Statement tag that contains the standard tags for the policy.

" - } - } - }, - "PutContainerPolicyOutput":{ - "type":"structure", - "members":{ - } - }, - "PutCorsPolicyInput":{ - "type":"structure", - "required":[ - "ContainerName", - "CorsPolicy" - ], - "members":{ - "ContainerName":{ - "shape":"ContainerName", - "documentation":"

The name of the container that you want to assign the CORS policy to.

" - }, - "CorsPolicy":{ - "shape":"CorsPolicy", - "documentation":"

The CORS policy to apply to the container.

" - } - } - }, - "PutCorsPolicyOutput":{ - "type":"structure", - "members":{ - } - }, - "TimeStamp":{"type":"timestamp"} - }, - "documentation":"

An AWS Elemental MediaStore container is a namespace that holds folders and objects. You use a container endpoint to create, read, and delete objects.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/service-2.json deleted file mode 100644 index 5f3e6707..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mediatailor/2018-04-23/service-2.json +++ /dev/null @@ -1,320 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2018-04-23", - "endpointPrefix" : "api.mediatailor", - "signingName" : "mediatailor", - "serviceFullName" : "AWS MediaTailor", - "serviceId" : "MediaTailor", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "mediatailor-2018-04-23", - "signatureVersion" : "v4", - "serviceAbbreviation": "MediaTailor" - }, - "operations" : { - "DeletePlaybackConfiguration" : { - "name" : "DeletePlaybackConfiguration", - "http" : { - "method" : "DELETE", - "requestUri" : "/playbackConfiguration/{Name}", - "responseCode" : 204 - }, - "input" : { - "shape" : "DeletePlaybackConfigurationRequest" - }, - "output" : { - "shape" : "DeletePlaybackConfigurationResponse" - }, - "errors" : [ ], - "documentation" : "

Deletes the configuration for the specified name.

" - }, - "GetPlaybackConfiguration" : { - "name" : "GetPlaybackConfiguration", - "http" : { - "method" : "GET", - "requestUri" : "/playbackConfiguration/{Name}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetPlaybackConfigurationRequest" - }, - "output" : { - "shape" : "GetPlaybackConfigurationResponse" - }, - "errors" : [ ], - "documentation" : "

Returns the configuration for the specified name.

" - }, - "ListPlaybackConfigurations" : { - "name" : "ListPlaybackConfigurations", - "http" : { - "method" : "GET", - "requestUri" : "/playbackConfigurations", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListPlaybackConfigurationsRequest" - }, - "output" : { - "shape" : "ListPlaybackConfigurationsResponse" - }, - "errors" : [ ], - "documentation" : "

Returns a list of the configurations defined in AWS Elemental MediaTailor. You can specify a max number of configurations to return at a time. The default max is 50. Results are returned in pagefuls. If AWS Elemental MediaTailor has more configurations than the specified max, it provides parameters in the response that you can use to retrieve the next pageful.

" - }, - "PutPlaybackConfiguration" : { - "name" : "PutPlaybackConfiguration", - "http" : { - "method" : "PUT", - "requestUri" : "/playbackConfiguration", - "responseCode" : 200 - }, - "input" : { - "shape" : "PutPlaybackConfigurationRequest" - }, - "output" : { - "shape" : "PutPlaybackConfigurationResponse" - }, - "errors" : [ ], - "documentation" : "

Adds a new configuration to AWS Elemental MediaTailor.

" - } - }, - "shapes" : { - "CdnConfiguration" : { - "type" : "structure", - "members" : { - "AdSegmentUrlPrefix" : { - "shape" : "__string", - "documentation" : "

A non-default content delivery network (CDN) to serve ad segments. By default, AWS Elemental MediaTailor uses Amazon CloudFront with default cache settings as its CDN for ad segments. To set up an alternate CDN, create a rule in your CDN for the following origin: ads.mediatailor.<region>.amazonaws.com. Then specify the rule's name in this AdSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for ad segments.

" - }, - "ContentSegmentUrlPrefix" : { - "shape" : "__string", - "documentation" : "

A content delivery network (CDN) to cache content segments, so that content requests don’t always have to go to the origin server. First, create a rule in your CDN for the content segment origin server. Then specify the rule's name in this ContentSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for content segments.

" - } - }, - "documentation" : "

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.

" - }, - "HlsConfiguration": { - "type" : "structure", - "members" : { - "ManifestEndpointPrefix" : { - "shape" : "__string", - "documentation" : "

The URL that is used to initiate a playback session for devices that support Apple HLS. The session uses server-side reporting.

" - } - }, - "documentation" : "

The configuration for HLS content.

" - }, - "DeletePlaybackConfigurationRequest" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "Name", - "documentation" : "

The identifier for the configuration.

" - } - }, - "required" : [ "Name" ] - }, - "DeletePlaybackConfigurationResponse" : { - "type" : "structure", - "members" : { } - }, - "Empty" : { - "type" : "structure", - "members" : { } - }, - "GetPlaybackConfigurationRequest" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "Name", - "documentation" : "

The identifier for the configuration.

" - } - }, - "required" : [ "Name" ] - }, - "GetPlaybackConfigurationResponse" : { - "type" : "structure", - "members" : { - "AdDecisionServerUrl" : { - "shape" : "__string", - "documentation" : "

The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25000 characters.

" - }, - "CdnConfiguration" : { - "shape" : "CdnConfiguration", - "documentation" : "

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.

" - }, - "HlsConfiguration" : { - "shape" : "HlsConfiguration", - "documentation" : "

The configuration for HLS content.

" - }, - "Name" : { - "shape" : "__string", - "documentation" : "

The identifier for the configuration.

" - }, - "PlaybackEndpointPrefix" : { - "shape" : "__string", - "documentation" : "

The URL that the player accesses to get a manifest from AWS Elemental MediaTailor. This session will use server-side reporting.

" - }, - "SessionInitializationEndpointPrefix" : { - "shape" : "__string", - "documentation" : "

The URL that the player uses to initialize a session that uses client-side reporting.

" - }, - "SlateAdUrl" : { - "shape" : "__string", - "documentation" : "

URL for a high-quality video asset to transcode and use to fill in time that's not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID configurations. For VPAID, the slate is required because AWS Elemental MediaTailor provides it in the slots designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.

" - }, - "VideoContentSourceUrl" : { - "shape" : "__string", - "documentation" : "

The URL prefix for the master playlist for the stream, minus the asset ID. The maximum length is 512 characters.

" - } - } - }, - "PlaybackConfiguration" : { - "type" : "structure", - "documentation": "

The AWSMediaTailor configuration.

", - "members" : { - "AdDecisionServerUrl" : { - "shape" : "__string", - "documentation" : "

The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25000 characters.

" - }, - "CdnConfiguration" : { - "shape" : "CdnConfiguration", - "documentation" : "

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.

" - }, - "Name" : { - "shape" : "__string", - "documentation" : "

The identifier for the configuration.

" - }, - "SlateAdUrl" : { - "shape" : "__string", - "documentation" : "

URL for a high-quality video asset to transcode and use to fill in time that's not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID configurations. For VPAID, the slate is required because AWS Elemental MediaTailor provides it in the slots designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.

" - }, - "VideoContentSourceUrl" : { - "shape" : "__string", - "documentation" : "

The URL prefix for the master playlist for the stream, minus the asset ID. The maximum length is 512 characters.

" - } - } - }, - "ListPlaybackConfigurationsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "__integerMin1Max100", - "location" : "querystring", - "locationName" : "MaxResults", - "documentation" : "

Maximum number of records to return.

" - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "NextToken", - "documentation" : "

Pagination token returned by the GET list request when results overrun the meximum allowed. Use the token to fetch the next page of results.

" - } - } - }, - "ListPlaybackConfigurationsResponse" : { - "type" : "structure", - "members" : { - "Items" : { - "shape" : "__listOfPlaybackConfigurations", - "documentation" : "

Array of playback configurations. This may be all of the available configurations or a subset, depending on the settings you provide and on the total number of configurations stored.

" - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "

Pagination token returned by the GET list request when results overrun the meximum allowed. Use the token to fetch the next page of results.

" - } - } - }, - "PutPlaybackConfigurationRequest" : { - "type" : "structure", - "members" : { - "AdDecisionServerUrl" : { - "shape" : "__string", - "documentation" : "

The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing you can provide a static VAST URL. The maximum length is 25000 characters.

" - }, - "CdnConfiguration" : { - "shape" : "CdnConfiguration", - "documentation" : "

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.

" - }, - "Name" : { - "shape" : "__string", - "documentation" : "

The identifier for the configuration.

" - }, - "SlateAdUrl" : { - "shape" : "__string", - "documentation" : "

The URL for a high-quality video asset to transcode and use to fill in time that's not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID configurations. For VPAID, the slate is required because AWS Elemental MediaTailor provides it in the slots that are designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.

" - }, - "VideoContentSourceUrl" : { - "shape" : "__string", - "documentation" : "

The URL prefix for the master playlist for the stream, minus the asset ID. The maximum length is 512 characters.

" - } - } - }, - "PutPlaybackConfigurationResponse" : { - "type" : "structure", - "members" : { - "AdDecisionServerUrl" : { - "shape" : "__string", - "documentation" : "

The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25000 characters.

" - }, - "CdnConfiguration" : { - "shape" : "CdnConfiguration", - "documentation" : "

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.

" - }, - "HlsConfiguration" : { - "shape" : "HlsConfiguration", - "documentation" : "

The configuration for HLS content.

" - }, - "Name" : { - "shape" : "__string", - "documentation" : "

The identifier for the configuration.

" - }, - "PlaybackEndpointPrefix" : { - "shape" : "__string", - "documentation" : "

The URL that the player accesses to get a manifest from AWS Elemental MediaTailor. This session will use server-side reporting.

" - }, - "SessionInitializationEndpointPrefix" : { - "shape" : "__string", - "documentation" : "

The URL that the player uses to initialize a session that uses client-side reporting.

" - }, - "SlateAdUrl" : { - "shape" : "__string", - "documentation" : "

URL for a high-quality video asset to transcode and use to fill in time that's not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID configurations. For VPAID, the slate is required because AWS Elemental MediaTailor provides it in the slots designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.

" - }, - "VideoContentSourceUrl" : { - "shape" : "__string", - "documentation" : "

The URL prefix for the master playlist for the stream, minus the asset ID. The maximum length is 512 characters.

" - } - } - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__listOfPlaybackConfigurations" : { - "type" : "list", - "member": { - "shape" : "PlaybackConfiguration" - } - }, - "__long" : { - "type" : "long" - }, - "__string" : { - "type" : "string" - }, - "__integerMin1Max100" : { - "type": "integer", - "min": 1, - "max": 100 - } - }, - "documentation" : "

Use the AWS Elemental MediaTailor SDK to configure scalable ad insertion for your live and VOD content. With AWS Elemental MediaTailor, you can serve targeted ads to viewers while maintaining broadcast quality in over-the-top (OTT) video applications. For information about using the service, including detailed information about the settings covered in this guide, see the AWS Elemental MediaTailor User Guide.

Through the SDK, you manage AWS Elemental MediaTailor configurations the same as you do through the console. For example, you specify ad insertion behavior and mapping information for the origin server and the ad decision server (ADS).

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/service-2.json deleted file mode 100644 index 87ad4a2a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/meteringmarketplace/2016-01-14/service-2.json +++ /dev/null @@ -1,340 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"meteringmarketplace-2016-01-14", - "apiVersion":"2016-01-14", - "endpointPrefix":"metering.marketplace", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWSMarketplace Metering", - "serviceId":"Marketplace Metering", - "signatureVersion":"v4", - "signingName":"aws-marketplace", - "targetPrefix":"AWSMPMeteringService" - }, - "operations":{ - "BatchMeterUsage":{ - "name":"BatchMeterUsage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchMeterUsageRequest"}, - "output":{"shape":"BatchMeterUsageResult"}, - "errors":[ - {"shape":"InternalServiceErrorException"}, - {"shape":"InvalidProductCodeException"}, - {"shape":"InvalidUsageDimensionException"}, - {"shape":"InvalidCustomerIdentifierException"}, - {"shape":"TimestampOutOfBoundsException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

BatchMeterUsage is called from a SaaS application listed on the AWS Marketplace to post metering records for a set of customers.

For identical requests, the API is idempotent; requests can be retried with the same records or a subset of the input records.

Every request to BatchMeterUsage is for one product. If you need to meter usage for multiple products, you must make multiple calls to BatchMeterUsage.

BatchMeterUsage can process up to 25 UsageRecords at a time.

" - }, - "MeterUsage":{ - "name":"MeterUsage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MeterUsageRequest"}, - "output":{"shape":"MeterUsageResult"}, - "errors":[ - {"shape":"InternalServiceErrorException"}, - {"shape":"InvalidProductCodeException"}, - {"shape":"InvalidUsageDimensionException"}, - {"shape":"InvalidEndpointRegionException"}, - {"shape":"TimestampOutOfBoundsException"}, - {"shape":"DuplicateRequestException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

API to emit metering records. For identical requests, the API is idempotent. It simply returns the metering record ID.

MeterUsage is authenticated on the buyer's AWS account, generally when running from an EC2 instance on the AWS Marketplace.

" - }, - "ResolveCustomer":{ - "name":"ResolveCustomer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResolveCustomerRequest"}, - "output":{"shape":"ResolveCustomerResult"}, - "errors":[ - {"shape":"InvalidTokenException"}, - {"shape":"ExpiredTokenException"}, - {"shape":"ThrottlingException"}, - {"shape":"InternalServiceErrorException"} - ], - "documentation":"

ResolveCustomer is called by a SaaS application during the registration process. When a buyer visits your website during the registration process, the buyer submits a registration token through their browser. The registration token is resolved through this API to obtain a CustomerIdentifier and product code.

" - } - }, - "shapes":{ - "BatchMeterUsageRequest":{ - "type":"structure", - "required":[ - "UsageRecords", - "ProductCode" - ], - "members":{ - "UsageRecords":{ - "shape":"UsageRecordList", - "documentation":"

The set of UsageRecords to submit. BatchMeterUsage accepts up to 25 UsageRecords at a time.

" - }, - "ProductCode":{ - "shape":"ProductCode", - "documentation":"

Product code is used to uniquely identify a product in AWS Marketplace. The product code should be the same as the one used during the publishing of a new product.

" - } - }, - "documentation":"

A BatchMeterUsageRequest contains UsageRecords, which indicate quantities of usage within your application.

" - }, - "BatchMeterUsageResult":{ - "type":"structure", - "members":{ - "Results":{ - "shape":"UsageRecordResultList", - "documentation":"

Contains all UsageRecords processed by BatchMeterUsage. These records were either honored by AWS Marketplace Metering Service or were invalid.

" - }, - "UnprocessedRecords":{ - "shape":"UsageRecordList", - "documentation":"

Contains all UsageRecords that were not processed by BatchMeterUsage. This is a list of UsageRecords. You can retry the failed request by making another BatchMeterUsage call with this list as input in the BatchMeterUsageRequest.

" - } - }, - "documentation":"

Contains the UsageRecords processed by BatchMeterUsage and any records that have failed due to transient error.

" - }, - "Boolean":{"type":"boolean"}, - "CustomerIdentifier":{ - "type":"string", - "max":255, - "min":1 - }, - "DuplicateRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

A metering record has already been emitted by the same EC2 instance for the given {usageDimension, timestamp} with a different usageQuantity.

", - "exception":true - }, - "ExpiredTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The submitted registration token has expired. This can happen if the buyer's browser takes too long to redirect to your page, the buyer has resubmitted the registration token, or your application has held on to the registration token for too long. Your SaaS registration website should redeem this token as soon as it is submitted by the buyer's browser.

", - "exception":true - }, - "InternalServiceErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.

", - "exception":true, - "fault":true - }, - "InvalidCustomerIdentifierException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

You have metered usage for a CustomerIdentifier that does not exist.

", - "exception":true - }, - "InvalidEndpointRegionException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The endpoint being called is in a region different from your EC2 instance. The region of the Metering service endpoint and the region of the EC2 instance must match.

", - "exception":true - }, - "InvalidProductCodeException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The product code passed does not match the product code used for publishing the product.

", - "exception":true - }, - "InvalidTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "exception":true - }, - "InvalidUsageDimensionException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The usage dimension does not match one of the UsageDimensions associated with products.

", - "exception":true - }, - "MeterUsageRequest":{ - "type":"structure", - "required":[ - "ProductCode", - "Timestamp", - "UsageDimension", - "UsageQuantity", - "DryRun" - ], - "members":{ - "ProductCode":{ - "shape":"ProductCode", - "documentation":"

Product code is used to uniquely identify a product in AWS Marketplace. The product code should be the same as the one used during the publishing of a new product.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Timestamp of the hour, recorded in UTC. The seconds and milliseconds portions of the timestamp will be ignored.

" - }, - "UsageDimension":{ - "shape":"UsageDimension", - "documentation":"

It will be one of the fcp dimension name provided during the publishing of the product.

" - }, - "UsageQuantity":{ - "shape":"UsageQuantity", - "documentation":"

Consumption value for the hour.

" - }, - "DryRun":{ - "shape":"Boolean", - "documentation":"

Checks whether you have the permissions required for the action, but does not make the request. If you have the permissions, the request returns DryRunOperation; otherwise, it returns UnauthorizedException.

" - } - } - }, - "MeterUsageResult":{ - "type":"structure", - "members":{ - "MeteringRecordId":{"shape":"String"} - } - }, - "NonEmptyString":{ - "type":"string", - "pattern":"\\S+" - }, - "ProductCode":{ - "type":"string", - "max":255, - "min":1 - }, - "ResolveCustomerRequest":{ - "type":"structure", - "required":["RegistrationToken"], - "members":{ - "RegistrationToken":{ - "shape":"NonEmptyString", - "documentation":"

When a buyer visits your website during the registration process, the buyer submits a registration token through the browser. The registration token is resolved to obtain a CustomerIdentifier and product code.

" - } - }, - "documentation":"

Contains input to the ResolveCustomer operation.

" - }, - "ResolveCustomerResult":{ - "type":"structure", - "members":{ - "CustomerIdentifier":{ - "shape":"CustomerIdentifier", - "documentation":"

The CustomerIdentifier is used to identify an individual customer in your application. Calls to BatchMeterUsage require CustomerIdentifiers for each UsageRecord.

" - }, - "ProductCode":{ - "shape":"ProductCode", - "documentation":"

The product code is returned to confirm that the buyer is registering for your product. Subsequent BatchMeterUsage calls should be made using this product code.

" - } - }, - "documentation":"

The result of the ResolveCustomer operation. Contains the CustomerIdentifier and product code.

" - }, - "String":{"type":"string"}, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The calls to the MeterUsage API are throttled.

", - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "TimestampOutOfBoundsException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The timestamp value passed in the meterUsage() is out of allowed range.

", - "exception":true - }, - "UsageDimension":{ - "type":"string", - "max":255, - "min":1 - }, - "UsageQuantity":{ - "type":"integer", - "max":1000000, - "min":0 - }, - "UsageRecord":{ - "type":"structure", - "required":[ - "Timestamp", - "CustomerIdentifier", - "Dimension", - "Quantity" - ], - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Timestamp of the hour, recorded in UTC. The seconds and milliseconds portions of the timestamp will be ignored.

Your application can meter usage for up to one hour in the past.

" - }, - "CustomerIdentifier":{ - "shape":"CustomerIdentifier", - "documentation":"

The CustomerIdentifier is obtained through the ResolveCustomer operation and represents an individual buyer in your application.

" - }, - "Dimension":{ - "shape":"UsageDimension", - "documentation":"

During the process of registering a product on AWS Marketplace, up to eight dimensions are specified. These represent different units of value in your application.

" - }, - "Quantity":{ - "shape":"UsageQuantity", - "documentation":"

The quantity of usage consumed by the customer for the given dimension and time.

" - } - }, - "documentation":"

A UsageRecord indicates a quantity of usage for a given product, customer, dimension and time.

Multiple requests with the same UsageRecords as input will be deduplicated to prevent double charges.

" - }, - "UsageRecordList":{ - "type":"list", - "member":{"shape":"UsageRecord"}, - "max":25, - "min":0 - }, - "UsageRecordResult":{ - "type":"structure", - "members":{ - "UsageRecord":{ - "shape":"UsageRecord", - "documentation":"

The UsageRecord that was part of the BatchMeterUsage request.

" - }, - "MeteringRecordId":{ - "shape":"String", - "documentation":"

The MeteringRecordId is a unique identifier for this metering event.

" - }, - "Status":{ - "shape":"UsageRecordResultStatus", - "documentation":"

The UsageRecordResult Status indicates the status of an individual UsageRecord processed by BatchMeterUsage.

  • Success- The UsageRecord was accepted and honored by BatchMeterUsage.

  • CustomerNotSubscribed- The CustomerIdentifier specified is not subscribed to your product. The UsageRecord was not honored. Future UsageRecords for this customer will fail until the customer subscribes to your product.

  • DuplicateRecord- Indicates that the UsageRecord was invalid and not honored. A previously metered UsageRecord had the same customer, dimension, and time, but a different quantity.

" - } - }, - "documentation":"

A UsageRecordResult indicates the status of a given UsageRecord processed by BatchMeterUsage.

" - }, - "UsageRecordResultList":{ - "type":"list", - "member":{"shape":"UsageRecordResult"} - }, - "UsageRecordResultStatus":{ - "type":"string", - "enum":[ - "Success", - "CustomerNotSubscribed", - "DuplicateRecord" - ] - }, - "errorMessage":{"type":"string"} - }, - "documentation":"AWS Marketplace Metering Service

This reference provides descriptions of the low-level AWS Marketplace Metering Service API.

AWS Marketplace sellers can use this API to submit usage data for custom usage dimensions.

Submitting Metering Records

  • MeterUsage- Submits the metering record for a Marketplace product. MeterUsage is called from an EC2 instance.

  • BatchMeterUsage- Submits the metering record for a set of customers. BatchMeterUsage is called from a software-as-a-service (SaaS) application.

Accepting New Customers

  • ResolveCustomer- Called by a SaaS application during the registration process. When a buyer visits your website during the registration process, the buyer submits a Registration Token through the browser. The Registration Token is resolved through this API to obtain a CustomerIdentifier and Product Code.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/service-2.json deleted file mode 100644 index 68e2b5a2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mgh/2017-05-31/service-2.json +++ /dev/null @@ -1,1123 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-05-31", - "endpointPrefix":"mgh", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Migration Hub", - "serviceId":"Migration Hub", - "signatureVersion":"v4", - "targetPrefix":"AWSMigrationHub", - "uid":"AWSMigrationHub-2017-05-31" - }, - "operations":{ - "AssociateCreatedArtifact":{ - "name":"AssociateCreatedArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateCreatedArtifactRequest"}, - "output":{"shape":"AssociateCreatedArtifactResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Associates a created artifact of an AWS cloud resource, the target receiving the migration, with the migration task performed by a migration tool. This API has the following traits:

  • Migration tools can call the AssociateCreatedArtifact operation to indicate which AWS artifact is associated with a migration task.

  • The created artifact name must be provided in ARN (Amazon Resource Name) format which will contain information about type and region; for example: arn:aws:ec2:us-east-1:488216288981:image/ami-6d0ba87b.

  • Examples of the AWS resource behind the created artifact are, AMI's, EC2 instance, or DMS endpoint, etc.

" - }, - "AssociateDiscoveredResource":{ - "name":"AssociateDiscoveredResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDiscoveredResourceRequest"}, - "output":{"shape":"AssociateDiscoveredResourceResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Associates a discovered resource ID from Application Discovery Service (ADS) with a migration task.

" - }, - "CreateProgressUpdateStream":{ - "name":"CreateProgressUpdateStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProgressUpdateStreamRequest"}, - "output":{"shape":"CreateProgressUpdateStreamResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Creates a progress update stream which is an AWS resource used for access control as well as a namespace for migration task names that is implicitly linked to your AWS account. It must uniquely identify the migration tool as it is used for all updates made by the tool; however, it does not need to be unique for each AWS account because it is scoped to the AWS account.

" - }, - "DeleteProgressUpdateStream":{ - "name":"DeleteProgressUpdateStream", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProgressUpdateStreamRequest"}, - "output":{"shape":"DeleteProgressUpdateStreamResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a progress update stream, including all of its tasks, which was previously created as an AWS resource used for access control. This API has the following traits:

  • The only parameter needed for DeleteProgressUpdateStream is the stream name (same as a CreateProgressUpdateStream call).

  • The call will return, and a background process will asynchronously delete the stream and all of its resources (tasks, associated resources, resource attributes, created artifacts).

  • If the stream takes time to be deleted, it might still show up on a ListProgressUpdateStreams call.

  • CreateProgressUpdateStream, ImportMigrationTask, NotifyMigrationTaskState, and all Associate[*] APIs realted to the tasks belonging to the stream will throw \"InvalidInputException\" if the stream of the same name is in the process of being deleted.

  • Once the stream and all of its resources are deleted, CreateProgressUpdateStream for a stream of the same name will succeed, and that stream will be an entirely new logical resource (without any resources associated with the old stream).

" - }, - "DescribeApplicationState":{ - "name":"DescribeApplicationState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeApplicationStateRequest"}, - "output":{"shape":"DescribeApplicationStateResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets the migration status of an application.

" - }, - "DescribeMigrationTask":{ - "name":"DescribeMigrationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMigrationTaskRequest"}, - "output":{"shape":"DescribeMigrationTaskResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Retrieves a list of all attributes associated with a specific migration task.

" - }, - "DisassociateCreatedArtifact":{ - "name":"DisassociateCreatedArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateCreatedArtifactRequest"}, - "output":{"shape":"DisassociateCreatedArtifactResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociates a created artifact of an AWS resource with a migration task performed by a migration tool that was previously associated. This API has the following traits:

  • A migration user can call the DisassociateCreatedArtifacts operation to disassociate a created AWS Artifact from a migration task.

  • The created artifact name must be provided in ARN (Amazon Resource Name) format which will contain information about type and region; for example: arn:aws:ec2:us-east-1:488216288981:image/ami-6d0ba87b.

  • Examples of the AWS resource behind the created artifact are, AMI's, EC2 instance, or RDS instance, etc.

" - }, - "DisassociateDiscoveredResource":{ - "name":"DisassociateDiscoveredResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateDiscoveredResourceRequest"}, - "output":{"shape":"DisassociateDiscoveredResourceResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociate an Application Discovery Service (ADS) discovered resource from a migration task.

" - }, - "ImportMigrationTask":{ - "name":"ImportMigrationTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportMigrationTaskRequest"}, - "output":{"shape":"ImportMigrationTaskResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers a new migration task which represents a server, database, etc., being migrated to AWS by a migration tool.

This API is a prerequisite to calling the NotifyMigrationTaskState API as the migration tool must first register the migration task with Migration Hub.

" - }, - "ListCreatedArtifacts":{ - "name":"ListCreatedArtifacts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCreatedArtifactsRequest"}, - "output":{"shape":"ListCreatedArtifactsResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the created artifacts attached to a given migration task in an update stream. This API has the following traits:

  • Gets the list of the created artifacts while migration is taking place.

  • Shows the artifacts created by the migration tool that was associated by the AssociateCreatedArtifact API.

  • Lists created artifacts in a paginated interface.

" - }, - "ListDiscoveredResources":{ - "name":"ListDiscoveredResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDiscoveredResourcesRequest"}, - "output":{"shape":"ListDiscoveredResourcesResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists discovered resources associated with the given MigrationTask.

" - }, - "ListMigrationTasks":{ - "name":"ListMigrationTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListMigrationTasksRequest"}, - "output":{"shape":"ListMigrationTasksResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists all, or filtered by resource name, migration tasks associated with the user account making this call. This API has the following traits:

  • Can show a summary list of the most recent migration tasks.

  • Can show a summary list of migration tasks associated with a given discovered resource.

  • Lists migration tasks in a paginated interface.

" - }, - "ListProgressUpdateStreams":{ - "name":"ListProgressUpdateStreams", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProgressUpdateStreamsRequest"}, - "output":{"shape":"ListProgressUpdateStreamsResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidInputException"} - ], - "documentation":"

Lists progress update streams associated with the user account making this call.

" - }, - "NotifyApplicationState":{ - "name":"NotifyApplicationState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"NotifyApplicationStateRequest"}, - "output":{"shape":"NotifyApplicationStateResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Sets the migration state of an application. For a given application identified by the value passed to ApplicationId, its status is set or updated by passing one of three values to Status: NOT_STARTED | IN_PROGRESS | COMPLETED.

" - }, - "NotifyMigrationTaskState":{ - "name":"NotifyMigrationTaskState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"NotifyMigrationTaskStateRequest"}, - "output":{"shape":"NotifyMigrationTaskStateResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Notifies Migration Hub of the current status, progress, or other detail regarding a migration task. This API has the following traits:

  • Migration tools will call the NotifyMigrationTaskState API to share the latest progress and status.

  • MigrationTaskName is used for addressing updates to the correct target.

  • ProgressUpdateStream is used for access control and to provide a namespace for each migration tool.

" - }, - "PutResourceAttributes":{ - "name":"PutResourceAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutResourceAttributesRequest"}, - "output":{"shape":"PutResourceAttributesResult"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DryRunOperation"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Provides identifying details of the resource being migrated so that it can be associated in the Application Discovery Service (ADS)'s repository. This association occurs asynchronously after PutResourceAttributes returns.

  • Keep in mind that subsequent calls to PutResourceAttributes will override previously stored attributes. For example, if it is first called with a MAC address, but later, it is desired to add an IP address, it will then be required to call it with both the IP and MAC addresses to prevent overiding the MAC address.

  • Note the instructions regarding the special use case of the ResourceAttributeList parameter when specifying any \"VM\" related value.

Because this is an asynchronous call, it will always return 200, whether an association occurs or not. To confirm if an association was found based on the provided details, call ListDiscoveredResources.

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You do not have sufficient access to perform this action.

", - "exception":true - }, - "ApplicationId":{ - "type":"string", - "max":1600, - "min":1 - }, - "ApplicationStatus":{ - "type":"string", - "enum":[ - "NOT_STARTED", - "IN_PROGRESS", - "COMPLETED" - ] - }, - "AssociateCreatedArtifactRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "CreatedArtifact" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "CreatedArtifact":{ - "shape":"CreatedArtifact", - "documentation":"

An ARN of the AWS resource related to the migration (e.g., AMI, EC2 instance, RDS instance, etc.)

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "AssociateCreatedArtifactResult":{ - "type":"structure", - "members":{ - } - }, - "AssociateDiscoveredResourceRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "DiscoveredResource" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

The identifier given to the MigrationTask.

" - }, - "DiscoveredResource":{ - "shape":"DiscoveredResource", - "documentation":"

Object representing a Resource.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "AssociateDiscoveredResourceResult":{ - "type":"structure", - "members":{ - } - }, - "ConfigurationId":{ - "type":"string", - "min":1 - }, - "CreateProgressUpdateStreamRequest":{ - "type":"structure", - "required":["ProgressUpdateStreamName"], - "members":{ - "ProgressUpdateStreamName":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "CreateProgressUpdateStreamResult":{ - "type":"structure", - "members":{ - } - }, - "CreatedArtifact":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"CreatedArtifactName", - "documentation":"

An ARN that uniquely identifies the result of a migration task.

" - }, - "Description":{ - "shape":"CreatedArtifactDescription", - "documentation":"

A description that can be free-form text to record additional detail about the artifact for clarity or for later reference.

" - } - }, - "documentation":"

An ARN of the AWS cloud resource target receiving the migration (e.g., AMI, EC2 instance, RDS instance, etc.).

" - }, - "CreatedArtifactDescription":{ - "type":"string", - "max":500, - "min":0 - }, - "CreatedArtifactList":{ - "type":"list", - "member":{"shape":"CreatedArtifact"} - }, - "CreatedArtifactName":{ - "type":"string", - "max":1600, - "min":1, - "pattern":"arn:[a-z-]+:[a-z0-9-]+:(?:[a-z0-9-]+|):(?:[0-9]{12}|):.*" - }, - "DeleteProgressUpdateStreamRequest":{ - "type":"structure", - "required":["ProgressUpdateStreamName"], - "members":{ - "ProgressUpdateStreamName":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "DeleteProgressUpdateStreamResult":{ - "type":"structure", - "members":{ - } - }, - "DescribeApplicationStateRequest":{ - "type":"structure", - "required":["ApplicationId"], - "members":{ - "ApplicationId":{ - "shape":"ApplicationId", - "documentation":"

The configurationId in ADS that uniquely identifies the grouped application.

" - } - } - }, - "DescribeApplicationStateResult":{ - "type":"structure", - "members":{ - "ApplicationStatus":{ - "shape":"ApplicationStatus", - "documentation":"

Status of the application - Not Started, In-Progress, Complete.

" - }, - "LastUpdatedTime":{ - "shape":"UpdateDateTime", - "documentation":"

The timestamp when the application status was last updated.

" - } - } - }, - "DescribeMigrationTaskRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

The identifier given to the MigrationTask.

" - } - } - }, - "DescribeMigrationTaskResult":{ - "type":"structure", - "members":{ - "MigrationTask":{ - "shape":"MigrationTask", - "documentation":"

Object encapsulating information about the migration task.

" - } - } - }, - "DisassociateCreatedArtifactRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "CreatedArtifactName" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task to be disassociated with the artifact.

" - }, - "CreatedArtifactName":{ - "shape":"CreatedArtifactName", - "documentation":"

An ARN of the AWS resource related to the migration (e.g., AMI, EC2 instance, RDS instance, etc.)

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "DisassociateCreatedArtifactResult":{ - "type":"structure", - "members":{ - } - }, - "DisassociateDiscoveredResourceRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "ConfigurationId" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

The identifier given to the MigrationTask.

" - }, - "ConfigurationId":{ - "shape":"ConfigurationId", - "documentation":"

ConfigurationId of the ADS resource to be disassociated.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "DisassociateDiscoveredResourceResult":{ - "type":"structure", - "members":{ - } - }, - "DiscoveredResource":{ - "type":"structure", - "required":["ConfigurationId"], - "members":{ - "ConfigurationId":{ - "shape":"ConfigurationId", - "documentation":"

The configurationId in ADS that uniquely identifies the on-premise resource.

" - }, - "Description":{ - "shape":"DiscoveredResourceDescription", - "documentation":"

A description that can be free-form text to record additional detail about the discovered resource for clarity or later reference.

" - } - }, - "documentation":"

Object representing the on-premises resource being migrated.

" - }, - "DiscoveredResourceDescription":{ - "type":"string", - "max":500, - "min":0 - }, - "DiscoveredResourceList":{ - "type":"list", - "member":{"shape":"DiscoveredResource"} - }, - "DryRun":{"type":"boolean"}, - "DryRunOperation":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised to indicate a successfully authorized action when the DryRun flag is set to \"true\".

", - "exception":true - }, - "ErrorMessage":{"type":"string"}, - "ImportMigrationTaskRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "ImportMigrationTaskResult":{ - "type":"structure", - "members":{ - } - }, - "InternalServerError":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised when there is an internal, configuration, or dependency error encountered.

", - "exception":true, - "fault":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised when the provided input violates a policy constraint or is entered in the wrong format or data type.

", - "exception":true - }, - "LatestResourceAttributeList":{ - "type":"list", - "member":{"shape":"ResourceAttribute"}, - "max":100, - "min":0 - }, - "ListCreatedArtifactsRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

If a NextToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in NextToken.

" - }, - "MaxResults":{ - "shape":"MaxResultsCreatedArtifacts", - "documentation":"

Maximum number of results to be returned per page.

" - } - } - }, - "ListCreatedArtifactsResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

If there are more created artifacts than the max result, return the next token to be passed to the next call as a bookmark of where to start from.

" - }, - "CreatedArtifactList":{ - "shape":"CreatedArtifactList", - "documentation":"

List of created artifacts up to the maximum number of results specified in the request.

" - } - } - }, - "ListDiscoveredResourcesRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

The name of the MigrationTask.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

If a NextToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in NextToken.

" - }, - "MaxResults":{ - "shape":"MaxResultsResources", - "documentation":"

The maximum number of results returned per page.

" - } - } - }, - "ListDiscoveredResourcesResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

If there are more discovered resources than the max result, return the next token to be passed to the next call as a bookmark of where to start from.

" - }, - "DiscoveredResourceList":{ - "shape":"DiscoveredResourceList", - "documentation":"

Returned list of discovered resources associated with the given MigrationTask.

" - } - } - }, - "ListMigrationTasksRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

If a NextToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in NextToken.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Value to specify how many results are returned per page.

" - }, - "ResourceName":{ - "shape":"ResourceName", - "documentation":"

Filter migration tasks by discovered resource name.

" - } - } - }, - "ListMigrationTasksResult":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

If there are more migration tasks than the max result, return the next token to be passed to the next call as a bookmark of where to start from.

" - }, - "MigrationTaskSummaryList":{ - "shape":"MigrationTaskSummaryList", - "documentation":"

Lists the migration task's summary which includes: MigrationTaskName, ProgressPercent, ProgressUpdateStream, Status, and the UpdateDateTime for each task.

" - } - } - }, - "ListProgressUpdateStreamsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

If a NextToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in NextToken.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Filter to limit the maximum number of results to list per page.

" - } - } - }, - "ListProgressUpdateStreamsResult":{ - "type":"structure", - "members":{ - "ProgressUpdateStreamSummaryList":{ - "shape":"ProgressUpdateStreamSummaryList", - "documentation":"

List of progress update streams up to the max number of results passed in the input.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

If there are more streams created than the max result, return the next token to be passed to the next call as a bookmark of where to start from.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":100, - "min":1 - }, - "MaxResultsCreatedArtifacts":{ - "type":"integer", - "box":true, - "max":10, - "min":1 - }, - "MaxResultsResources":{ - "type":"integer", - "box":true, - "max":10, - "min":1 - }, - "MigrationTask":{ - "type":"structure", - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

A name that identifies the vendor of the migration tool being used.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "Task":{ - "shape":"Task", - "documentation":"

Task object encapsulating task information.

" - }, - "UpdateDateTime":{ - "shape":"UpdateDateTime", - "documentation":"

The timestamp when the task was gathered.

" - }, - "ResourceAttributeList":{ - "shape":"LatestResourceAttributeList", - "documentation":"

" - } - }, - "documentation":"

Represents a migration task in a migration tool.

" - }, - "MigrationTaskName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[^:|]+" - }, - "MigrationTaskSummary":{ - "type":"structure", - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

An AWS resource used for access control. It should uniquely identify the migration tool as it is used for all updates made by the tool.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

Status of the task.

" - }, - "ProgressPercent":{ - "shape":"ProgressPercent", - "documentation":"

" - }, - "StatusDetail":{ - "shape":"StatusDetail", - "documentation":"

Detail information of what is being done within the overall status state.

" - }, - "UpdateDateTime":{ - "shape":"UpdateDateTime", - "documentation":"

The timestamp when the task was gathered.

" - } - }, - "documentation":"

MigrationTaskSummary includes MigrationTaskName, ProgressPercent, ProgressUpdateStream, Status, and UpdateDateTime for each task.

" - }, - "MigrationTaskSummaryList":{ - "type":"list", - "member":{"shape":"MigrationTaskSummary"} - }, - "NextUpdateSeconds":{ - "type":"integer", - "min":0 - }, - "NotifyApplicationStateRequest":{ - "type":"structure", - "required":[ - "ApplicationId", - "Status" - ], - "members":{ - "ApplicationId":{ - "shape":"ApplicationId", - "documentation":"

The configurationId in ADS that uniquely identifies the grouped application.

" - }, - "Status":{ - "shape":"ApplicationStatus", - "documentation":"

Status of the application - Not Started, In-Progress, Complete.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "NotifyApplicationStateResult":{ - "type":"structure", - "members":{ - } - }, - "NotifyMigrationTaskStateRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "Task", - "UpdateDateTime", - "NextUpdateSeconds" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "Task":{ - "shape":"Task", - "documentation":"

Information about the task's progress and status.

" - }, - "UpdateDateTime":{ - "shape":"UpdateDateTime", - "documentation":"

The timestamp when the task was gathered.

" - }, - "NextUpdateSeconds":{ - "shape":"NextUpdateSeconds", - "documentation":"

Number of seconds after the UpdateDateTime within which the Migration Hub can expect an update. If Migration Hub does not receive an update within the specified interval, then the migration task will be considered stale.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "NotifyMigrationTaskStateResult":{ - "type":"structure", - "members":{ - } - }, - "PolicyErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised when there are problems accessing ADS (Application Discovery Service); most likely due to a misconfigured policy or the migrationhub-discovery role is missing or not configured correctly.

", - "exception":true - }, - "ProgressPercent":{ - "type":"integer", - "box":true, - "max":100, - "min":0 - }, - "ProgressUpdateStream":{ - "type":"string", - "max":50, - "min":1, - "pattern":"[^/:|\\000-\\037]+" - }, - "ProgressUpdateStreamSummary":{ - "type":"structure", - "members":{ - "ProgressUpdateStreamName":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - } - }, - "documentation":"

Summary of the AWS resource used for access control that is implicitly linked to your AWS account.

" - }, - "ProgressUpdateStreamSummaryList":{ - "type":"list", - "member":{"shape":"ProgressUpdateStreamSummary"} - }, - "PutResourceAttributesRequest":{ - "type":"structure", - "required":[ - "ProgressUpdateStream", - "MigrationTaskName", - "ResourceAttributeList" - ], - "members":{ - "ProgressUpdateStream":{ - "shape":"ProgressUpdateStream", - "documentation":"

The name of the ProgressUpdateStream.

" - }, - "MigrationTaskName":{ - "shape":"MigrationTaskName", - "documentation":"

Unique identifier that references the migration task.

" - }, - "ResourceAttributeList":{ - "shape":"ResourceAttributeList", - "documentation":"

Information about the resource that is being migrated. This data will be used to map the task to a resource in the Application Discovery Service (ADS)'s repository.

Takes the object array of ResourceAttribute where the Type field is reserved for the following values: IPV4_ADDRESS | IPV6_ADDRESS | MAC_ADDRESS | FQDN | VM_MANAGER_ID | VM_MANAGED_OBJECT_REFERENCE | VM_NAME | VM_PATH | BIOS_ID | MOTHERBOARD_SERIAL_NUMBER where the identifying value can be a string up to 256 characters.

  • If any \"VM\" related value is set for a ResourceAttribute object, it is required that VM_MANAGER_ID, as a minimum, is always set. If VM_MANAGER_ID is not set, then all \"VM\" fields will be discarded and \"VM\" fields will not be used for matching the migration task to a server in Application Discovery Service (ADS)'s repository. See the Example section below for a use case of specifying \"VM\" related values.

  • If a server you are trying to match has multiple IP or MAC addresses, you should provide as many as you know in separate type/value pairs passed to the ResourceAttributeList parameter to maximize the chances of matching.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

" - } - } - }, - "PutResourceAttributesResult":{ - "type":"structure", - "members":{ - } - }, - "ResourceAttribute":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"ResourceAttributeType", - "documentation":"

Type of resource.

" - }, - "Value":{ - "shape":"ResourceAttributeValue", - "documentation":"

Value of the resource type.

" - } - }, - "documentation":"

Attribute associated with a resource.

Note the corresponding format required per type listed below:

IPV4

x.x.x.x

where x is an integer in the range [0,255]

IPV6

y : y : y : y : y : y : y : y

where y is a hexadecimal between 0 and FFFF. [0, FFFF]

MAC_ADDRESS

^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$

FQDN

^[^<>{}\\\\\\\\/?,=\\\\p{Cntrl}]{1,256}$

" - }, - "ResourceAttributeList":{ - "type":"list", - "member":{"shape":"ResourceAttribute"}, - "max":100, - "min":1 - }, - "ResourceAttributeType":{ - "type":"string", - "enum":[ - "IPV4_ADDRESS", - "IPV6_ADDRESS", - "MAC_ADDRESS", - "FQDN", - "VM_MANAGER_ID", - "VM_MANAGED_OBJECT_REFERENCE", - "VM_NAME", - "VM_PATH", - "BIOS_ID", - "MOTHERBOARD_SERIAL_NUMBER" - ] - }, - "ResourceAttributeValue":{ - "type":"string", - "max":256, - "min":1 - }, - "ResourceName":{ - "type":"string", - "max":1600, - "min":1 - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised when the request references a resource (ADS configuration, update stream, migration task, etc.) that does not exist in ADS (Application Discovery Service) or in Migration Hub's repository.

", - "exception":true - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised when there is an internal, configuration, or dependency error encountered.

", - "exception":true, - "fault":true - }, - "Status":{ - "type":"string", - "enum":[ - "NOT_STARTED", - "IN_PROGRESS", - "FAILED", - "COMPLETED" - ] - }, - "StatusDetail":{ - "type":"string", - "max":500, - "min":0 - }, - "Task":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

Status of the task - Not Started, In-Progress, Complete.

" - }, - "StatusDetail":{ - "shape":"StatusDetail", - "documentation":"

Details of task status as notified by a migration tool. A tool might use this field to provide clarifying information about the status that is unique to that tool or that explains an error state.

" - }, - "ProgressPercent":{ - "shape":"ProgressPercent", - "documentation":"

Indication of the percentage completion of the task.

" - } - }, - "documentation":"

Task object encapsulating task information.

" - }, - "Token":{"type":"string"}, - "UnauthorizedOperation":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Exception raised to indicate a request was not authorized when the DryRun flag is set to \"true\".

", - "exception":true - }, - "UpdateDateTime":{"type":"timestamp"} - }, - "documentation":"

The AWS Migration Hub API methods help to obtain server and application migration status and integrate your resource-specific migration tool by providing a programmatic interface to Migration Hub.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/paginators-1.json deleted file mode 100644 index e86bb7d0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "ListBundles": { - "result_key": "bundleList", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - }, - "ListProjects": { - "result_key": "projects", - "output_token": "nextToken", - "input_token": "nextToken", - "limit_key": "maxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/service-2.json deleted file mode 100644 index b588798e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mobile/2017-07-01/service-2.json +++ /dev/null @@ -1,732 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-07-01", - "endpointPrefix":"mobile", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"AWS Mobile", - "serviceId":"Mobile", - "signatureVersion":"v4", - "signingName":"AWSMobileHubService", - "uid":"mobile-2017-07-01" - }, - "operations":{ - "CreateProject":{ - "name":"CreateProject", - "http":{ - "method":"POST", - "requestUri":"/projects" - }, - "input":{"shape":"CreateProjectRequest"}, - "output":{"shape":"CreateProjectResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an AWS Mobile Hub project.

" - }, - "DeleteProject":{ - "name":"DeleteProject", - "http":{ - "method":"DELETE", - "requestUri":"/projects/{projectId}" - }, - "input":{"shape":"DeleteProjectRequest"}, - "output":{"shape":"DeleteProjectResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Delets a project in AWS Mobile Hub.

" - }, - "DescribeBundle":{ - "name":"DescribeBundle", - "http":{ - "method":"GET", - "requestUri":"/bundles/{bundleId}" - }, - "input":{"shape":"DescribeBundleRequest"}, - "output":{"shape":"DescribeBundleResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Get the bundle details for the requested bundle id.

" - }, - "DescribeProject":{ - "name":"DescribeProject", - "http":{ - "method":"GET", - "requestUri":"/project" - }, - "input":{"shape":"DescribeProjectRequest"}, - "output":{"shape":"DescribeProjectResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Gets details about a project in AWS Mobile Hub.

" - }, - "ExportBundle":{ - "name":"ExportBundle", - "http":{ - "method":"POST", - "requestUri":"/bundles/{bundleId}" - }, - "input":{"shape":"ExportBundleRequest"}, - "output":{"shape":"ExportBundleResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Generates customized software development kit (SDK) and or tool packages used to integrate mobile web or mobile app clients with backend AWS resources.

" - }, - "ExportProject":{ - "name":"ExportProject", - "http":{ - "method":"POST", - "requestUri":"/exports/{projectId}" - }, - "input":{"shape":"ExportProjectRequest"}, - "output":{"shape":"ExportProjectResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Exports project configuration to a snapshot which can be downloaded and shared. Note that mobile app push credentials are encrypted in exported projects, so they can only be shared successfully within the same AWS account.

" - }, - "ListBundles":{ - "name":"ListBundles", - "http":{ - "method":"GET", - "requestUri":"/bundles" - }, - "input":{"shape":"ListBundlesRequest"}, - "output":{"shape":"ListBundlesResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

List all available bundles.

" - }, - "ListProjects":{ - "name":"ListProjects", - "http":{ - "method":"GET", - "requestUri":"/projects" - }, - "input":{"shape":"ListProjectsRequest"}, - "output":{"shape":"ListProjectsResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Lists projects in AWS Mobile Hub.

" - }, - "UpdateProject":{ - "name":"UpdateProject", - "http":{ - "method":"POST", - "requestUri":"/update" - }, - "input":{"shape":"UpdateProjectRequest"}, - "output":{"shape":"UpdateProjectResult"}, - "errors":[ - {"shape":"InternalFailureException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"UnauthorizedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"BadRequestException"}, - {"shape":"NotFoundException"}, - {"shape":"AccountActionRequiredException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Update an existing project.

" - } - }, - "shapes":{ - "AccountActionRequiredException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Account Action is required in order to continue the request.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "AttributeKey":{ - "type":"string", - "documentation":"

Key part of key-value attribute pairs.

" - }, - "AttributeValue":{ - "type":"string", - "documentation":"

Value part of key-value attribute pairs.

" - }, - "Attributes":{ - "type":"map", - "key":{"shape":"AttributeKey"}, - "value":{"shape":"AttributeValue"}, - "documentation":"

Key-value attribute pairs.

" - }, - "BadRequestException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request cannot be processed because some parameter is not valid or the project state prevents the operation from being performed.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Boolean":{"type":"boolean"}, - "BundleDescription":{ - "type":"string", - "documentation":"

Description of the download bundle.

" - }, - "BundleDetails":{ - "type":"structure", - "members":{ - "bundleId":{"shape":"BundleId"}, - "title":{"shape":"BundleTitle"}, - "version":{"shape":"BundleVersion"}, - "description":{"shape":"BundleDescription"}, - "iconUrl":{"shape":"IconUrl"}, - "availablePlatforms":{"shape":"Platforms"} - }, - "documentation":"

The details of the bundle.

" - }, - "BundleId":{ - "type":"string", - "documentation":"

Unique bundle identifier.

" - }, - "BundleList":{ - "type":"list", - "member":{"shape":"BundleDetails"}, - "documentation":"

A list of bundles.

" - }, - "BundleTitle":{ - "type":"string", - "documentation":"

Title of the download bundle.

" - }, - "BundleVersion":{ - "type":"string", - "documentation":"

Version of the download bundle.

" - }, - "ConsoleUrl":{"type":"string"}, - "Contents":{ - "type":"blob", - "documentation":"

Binary file data.

" - }, - "CreateProjectRequest":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

Name of the project.

", - "location":"querystring", - "locationName":"name" - }, - "region":{ - "shape":"ProjectRegion", - "documentation":"

Default region where project resources should be created.

", - "location":"querystring", - "locationName":"region" - }, - "contents":{ - "shape":"Contents", - "documentation":"

ZIP or YAML file which contains configuration settings to be used when creating the project. This may be the contents of the file downloaded from the URL provided in an export project operation.

" - }, - "snapshotId":{ - "shape":"SnapshotId", - "documentation":"

Unique identifier for an exported snapshot of project configuration. This snapshot identifier is included in the share URL when a project is exported.

", - "location":"querystring", - "locationName":"snapshotId" - } - }, - "documentation":"

Request structure used to request a project be created.

", - "payload":"contents" - }, - "CreateProjectResult":{ - "type":"structure", - "members":{ - "details":{ - "shape":"ProjectDetails", - "documentation":"

Detailed information about the created AWS Mobile Hub project.

" - } - }, - "documentation":"

Result structure used in response to a request to create a project.

" - }, - "Date":{"type":"timestamp"}, - "DeleteProjectRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

", - "location":"uri", - "locationName":"projectId" - } - }, - "documentation":"

Request structure used to request a project be deleted.

" - }, - "DeleteProjectResult":{ - "type":"structure", - "members":{ - "deletedResources":{ - "shape":"Resources", - "documentation":"

Resources which were deleted.

" - }, - "orphanedResources":{ - "shape":"Resources", - "documentation":"

Resources which were not deleted, due to a risk of losing potentially important data or files.

" - } - }, - "documentation":"

Result structure used in response to request to delete a project.

" - }, - "DescribeBundleRequest":{ - "type":"structure", - "required":["bundleId"], - "members":{ - "bundleId":{ - "shape":"BundleId", - "documentation":"

Unique bundle identifier.

", - "location":"uri", - "locationName":"bundleId" - } - }, - "documentation":"

Request structure to request the details of a specific bundle.

" - }, - "DescribeBundleResult":{ - "type":"structure", - "members":{ - "details":{ - "shape":"BundleDetails", - "documentation":"

The details of the bundle.

" - } - }, - "documentation":"

Result structure contains the details of the bundle.

" - }, - "DescribeProjectRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

", - "location":"querystring", - "locationName":"projectId" - }, - "syncFromResources":{ - "shape":"Boolean", - "documentation":"

If set to true, causes AWS Mobile Hub to synchronize information from other services, e.g., update state of AWS CloudFormation stacks in the AWS Mobile Hub project.

", - "location":"querystring", - "locationName":"syncFromResources" - } - }, - "documentation":"

Request structure used to request details about a project.

" - }, - "DescribeProjectResult":{ - "type":"structure", - "members":{ - "details":{"shape":"ProjectDetails"} - }, - "documentation":"

Result structure used for requests of project details.

" - }, - "DownloadUrl":{ - "type":"string", - "documentation":"

The download Url.

" - }, - "ErrorMessage":{ - "type":"string", - "documentation":"

The Exception Error Message.

" - }, - "ExportBundleRequest":{ - "type":"structure", - "required":["bundleId"], - "members":{ - "bundleId":{ - "shape":"BundleId", - "documentation":"

Unique bundle identifier.

", - "location":"uri", - "locationName":"bundleId" - }, - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

", - "location":"querystring", - "locationName":"projectId" - }, - "platform":{ - "shape":"Platform", - "documentation":"

Developer desktop or target application platform.

", - "location":"querystring", - "locationName":"platform" - } - }, - "documentation":"

Request structure used to request generation of custom SDK and tool packages required to integrate mobile web or app clients with backed AWS resources.

" - }, - "ExportBundleResult":{ - "type":"structure", - "members":{ - "downloadUrl":{ - "shape":"DownloadUrl", - "documentation":"

URL which contains the custom-generated SDK and tool packages used to integrate the client mobile app or web app with the AWS resources created by the AWS Mobile Hub project.

" - } - }, - "documentation":"

Result structure which contains link to download custom-generated SDK and tool packages used to integrate mobile web or app clients with backed AWS resources.

" - }, - "ExportProjectRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

", - "location":"uri", - "locationName":"projectId" - } - }, - "documentation":"

Request structure used in requests to export project configuration details.

" - }, - "ExportProjectResult":{ - "type":"structure", - "members":{ - "downloadUrl":{ - "shape":"DownloadUrl", - "documentation":"

URL which can be used to download the exported project configuation file(s).

" - }, - "shareUrl":{ - "shape":"ShareUrl", - "documentation":"

URL which can be shared to allow other AWS users to create their own project in AWS Mobile Hub with the same configuration as the specified project. This URL pertains to a snapshot in time of the project configuration that is created when this API is called. If you want to share additional changes to your project configuration, then you will need to create and share a new snapshot by calling this method again.

" - }, - "snapshotId":{ - "shape":"SnapshotId", - "documentation":"

Unique identifier for the exported snapshot of the project configuration. This snapshot identifier is included in the share URL.

" - } - }, - "documentation":"

Result structure used for requests to export project configuration details.

" - }, - "Feature":{ - "type":"string", - "documentation":"

Identifies which feature in AWS Mobile Hub is associated with this AWS resource.

" - }, - "IconUrl":{ - "type":"string", - "documentation":"

Icon for the download bundle.

" - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service has encountered an unexpected error condition which prevents it from servicing the request.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"ErrorMessage", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

There are too many AWS Mobile Hub projects in the account or the account has exceeded the maximum number of resources in some AWS service. You should create another sub-account using AWS Organizations or remove some resources and retry your request.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "ListBundlesRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of records to list in a single response.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Pagination token. Set to null to start listing bundles from start. If non-null pagination token is returned in a result, then pass its value in here in another request to list more bundles.

", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Request structure to request all available bundles.

" - }, - "ListBundlesResult":{ - "type":"structure", - "members":{ - "bundleList":{ - "shape":"BundleList", - "documentation":"

A list of bundles.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Pagination token. If non-null pagination token is returned in a result, then pass its value in another request to fetch more entries.

" - } - }, - "documentation":"

Result structure contains a list of all available bundles with details.

" - }, - "ListProjectsRequest":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of records to list in a single response.

", - "location":"querystring", - "locationName":"maxResults" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

Pagination token. Set to null to start listing projects from start. If non-null pagination token is returned in a result, then pass its value in here in another request to list more projects.

", - "location":"querystring", - "locationName":"nextToken" - } - }, - "documentation":"

Request structure used to request projects list in AWS Mobile Hub.

" - }, - "ListProjectsResult":{ - "type":"structure", - "members":{ - "projects":{"shape":"ProjectSummaries"}, - "nextToken":{"shape":"NextToken"} - }, - "documentation":"

Result structure used for requests to list projects in AWS Mobile Hub.

" - }, - "MaxResults":{ - "type":"integer", - "documentation":"

Maximum number of records to list in a single response.

" - }, - "NextToken":{ - "type":"string", - "documentation":"

Pagination token. Set to null to start listing records from start. If non-null pagination token is returned in a result, then pass its value in here in another request to list more entries.

" - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

No entity can be found with the specified identifier.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Platform":{ - "type":"string", - "documentation":"

Developer desktop or target mobile app or website platform.

", - "enum":[ - "OSX", - "WINDOWS", - "LINUX", - "OBJC", - "SWIFT", - "ANDROID", - "JAVASCRIPT" - ] - }, - "Platforms":{ - "type":"list", - "member":{"shape":"Platform"}, - "documentation":"

Developer desktop or mobile app or website platforms.

" - }, - "ProjectDetails":{ - "type":"structure", - "members":{ - "name":{"shape":"ProjectName"}, - "projectId":{"shape":"ProjectId"}, - "region":{"shape":"ProjectRegion"}, - "state":{"shape":"ProjectState"}, - "createdDate":{ - "shape":"Date", - "documentation":"

Date the project was created.

" - }, - "lastUpdatedDate":{ - "shape":"Date", - "documentation":"

Date of the last modification of the project.

" - }, - "consoleUrl":{ - "shape":"ConsoleUrl", - "documentation":"

Website URL for this project in the AWS Mobile Hub console.

" - }, - "resources":{"shape":"Resources"} - }, - "documentation":"

Detailed information about an AWS Mobile Hub project.

" - }, - "ProjectId":{ - "type":"string", - "documentation":"

Unique project identifier.

" - }, - "ProjectName":{ - "type":"string", - "documentation":"

Name of the project.

" - }, - "ProjectRegion":{ - "type":"string", - "documentation":"

Default region to use for AWS resource creation in the AWS Mobile Hub project.

" - }, - "ProjectState":{ - "type":"string", - "documentation":"

Synchronization state for a project.

", - "enum":[ - "NORMAL", - "SYNCING", - "IMPORTING" - ] - }, - "ProjectSummaries":{ - "type":"list", - "member":{"shape":"ProjectSummary"}, - "documentation":"

List of projects.

" - }, - "ProjectSummary":{ - "type":"structure", - "members":{ - "name":{ - "shape":"ProjectName", - "documentation":"

Name of the project.

" - }, - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

" - } - }, - "documentation":"

Summary information about an AWS Mobile Hub project.

" - }, - "Resource":{ - "type":"structure", - "members":{ - "type":{"shape":"ResourceType"}, - "name":{"shape":"ResourceName"}, - "arn":{"shape":"ResourceArn"}, - "feature":{"shape":"Feature"}, - "attributes":{"shape":"Attributes"} - }, - "documentation":"

Information about an instance of an AWS resource associated with a project.

" - }, - "ResourceArn":{ - "type":"string", - "documentation":"

AWS resource name which uniquely identifies the resource in AWS systems.

" - }, - "ResourceName":{ - "type":"string", - "documentation":"

Name of the AWS resource (e.g., for an Amazon S3 bucket this is the name of the bucket).

" - }, - "ResourceType":{ - "type":"string", - "documentation":"

Simplified name for type of AWS resource (e.g., bucket is an Amazon S3 bucket).

" - }, - "Resources":{ - "type":"list", - "member":{"shape":"Resource"}, - "documentation":"

List of AWS resources associated with a project.

" - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"ErrorMessage", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The service is temporarily unavailable. The request should be retried after some time delay.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "ShareUrl":{ - "type":"string", - "documentation":"

URL which can be shared to allow other AWS users to create their own project in AWS Mobile Hub with the same configuration as the specified project. This URL pertains to a snapshot in time of the project configuration that is created when this API is called. If you want to share additional changes to your project configuration, then you will need to create and share a new snapshot by calling this method again.

" - }, - "SnapshotId":{ - "type":"string", - "documentation":"

Unique identifier for the exported snapshot of the project configuration. This snapshot identifier is included in the share URL.

" - }, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "retryAfterSeconds":{ - "shape":"ErrorMessage", - "location":"header", - "locationName":"Retry-After" - }, - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Too many requests have been received for this AWS account in too short a time. The request should be retried after some time delay.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Credentials of the caller are insufficient to authorize the request.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UpdateProjectRequest":{ - "type":"structure", - "required":["projectId"], - "members":{ - "contents":{ - "shape":"Contents", - "documentation":"

ZIP or YAML file which contains project configuration to be updated. This should be the contents of the file downloaded from the URL provided in an export project operation.

" - }, - "projectId":{ - "shape":"ProjectId", - "documentation":"

Unique project identifier.

", - "location":"querystring", - "locationName":"projectId" - } - }, - "documentation":"

Request structure used for requests to update project configuration.

", - "payload":"contents" - }, - "UpdateProjectResult":{ - "type":"structure", - "members":{ - "details":{ - "shape":"ProjectDetails", - "documentation":"

Detailed information about the updated AWS Mobile Hub project.

" - } - }, - "documentation":"

Result structure used for requests to updated project configuration.

" - } - }, - "documentation":"

AWS Mobile Service provides mobile app and website developers with capabilities required to configure AWS resources and bootstrap their developer desktop projects with the necessary SDKs, constants, tools and samples to make use of those resources.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/service-2.json deleted file mode 100644 index 75c419ac..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mq/2017-11-27/service-2.json +++ /dev/null @@ -1,2434 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2017-11-27", - "endpointPrefix" : "mq", - "signingName" : "mq", - "serviceFullName" : "AmazonMQ", - "serviceId" : "mq", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "mq-2017-11-27", - "signatureVersion" : "v4" - }, - "operations" : { - "CreateBroker" : { - "name" : "CreateBroker", - "http" : { - "method" : "POST", - "requestUri" : "/v1/brokers", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateBrokerRequest" - }, - "output" : { - "shape" : "CreateBrokerResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "UnauthorizedException", - "documentation" : "HTTP Status Code 401: Unauthorized request. The provided credentials couldn't be validated." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ConflictException", - "documentation" : "HTTP Status Code 409: Conflict. This Broker name already exists. Retry your request with another name." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Creates a broker. Note: This API is asynchronous." - }, - "CreateConfiguration" : { - "name" : "CreateConfiguration", - "http" : { - "method" : "POST", - "requestUri" : "/v1/configurations", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateConfigurationRequest" - }, - "output" : { - "shape" : "CreateConfigurationResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ConflictException", - "documentation" : "HTTP Status Code 409: Conflict. This configuration name already exists. Retry your request with another configuration name." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your input and then retry your request." - } ], - "documentation" : "Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version)." - }, - "CreateUser" : { - "name" : "CreateUser", - "http" : { - "method" : "POST", - "requestUri" : "/v1/brokers/{broker-id}/users/{username}", - "responseCode" : 200 - }, - "input" : { - "shape" : "CreateUserRequest" - }, - "output" : { - "shape" : "CreateUserResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ConflictException", - "documentation" : "HTTP Status Code 409: Conflict. Retry your request." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Creates an ActiveMQ user." - }, - "DeleteBroker" : { - "name" : "DeleteBroker", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/brokers/{broker-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteBrokerRequest" - }, - "output" : { - "shape" : "DeleteBrokerResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Deletes a broker. Note: This API is asynchronous." - }, - "DeleteUser" : { - "name" : "DeleteUser", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/brokers/{broker-id}/users/{username}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteUserRequest" - }, - "output" : { - "shape" : "DeleteUserResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Deletes an ActiveMQ user." - }, - "DescribeBroker" : { - "name" : "DescribeBroker", - "http" : { - "method" : "GET", - "requestUri" : "/v1/brokers/{broker-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DescribeBrokerRequest" - }, - "output" : { - "shape" : "DescribeBrokerResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns information about the specified broker." - }, - "DescribeConfiguration" : { - "name" : "DescribeConfiguration", - "http" : { - "method" : "GET", - "requestUri" : "/v1/configurations/{configuration-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DescribeConfigurationRequest" - }, - "output" : { - "shape" : "DescribeConfigurationResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns information about the specified configuration." - }, - "DescribeConfigurationRevision" : { - "name" : "DescribeConfigurationRevision", - "http" : { - "method" : "GET", - "requestUri" : "/v1/configurations/{configuration-id}/revisions/{configuration-revision}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DescribeConfigurationRevisionRequest" - }, - "output" : { - "shape" : "DescribeConfigurationRevisionResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns the specified configuration revision for the specified configuration." - }, - "DescribeUser" : { - "name" : "DescribeUser", - "http" : { - "method" : "GET", - "requestUri" : "/v1/brokers/{broker-id}/users/{username}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DescribeUserRequest" - }, - "output" : { - "shape" : "DescribeUserResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns information about an ActiveMQ user." - }, - "ListBrokers" : { - "name" : "ListBrokers", - "http" : { - "method" : "GET", - "requestUri" : "/v1/brokers", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListBrokersRequest" - }, - "output" : { - "shape" : "ListBrokersResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns a list of all brokers." - }, - "ListConfigurationRevisions" : { - "name" : "ListConfigurationRevisions", - "http" : { - "method" : "GET", - "requestUri" : "/v1/configurations/{configuration-id}/revisions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListConfigurationRevisionsRequest" - }, - "output" : { - "shape" : "ListConfigurationRevisionsResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns a list of all revisions for the specified configuration." - }, - "ListConfigurations" : { - "name" : "ListConfigurations", - "http" : { - "method" : "GET", - "requestUri" : "/v1/configurations", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListConfigurationsRequest" - }, - "output" : { - "shape" : "ListConfigurationsResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns a list of all configurations." - }, - "ListUsers" : { - "name" : "ListUsers", - "http" : { - "method" : "GET", - "requestUri" : "/v1/brokers/{broker-id}/users", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListUsersRequest" - }, - "output" : { - "shape" : "ListUsersResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Returns a list of all ActiveMQ users." - }, - "RebootBroker" : { - "name" : "RebootBroker", - "http" : { - "method" : "POST", - "requestUri" : "/v1/brokers/{broker-id}/reboot", - "responseCode" : 200 - }, - "input" : { - "shape" : "RebootBrokerRequest" - }, - "output" : { - "shape" : "RebootBrokerResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Reboots a broker. Note: This API is asynchronous." - }, - "UpdateBroker" : { - "name" : "UpdateBroker", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/brokers/{broker-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateBrokerRequest" - }, - "output" : { - "shape" : "UpdateBrokerResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Adds a pending configuration change to a broker." - }, - "UpdateConfiguration" : { - "name" : "UpdateConfiguration", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/configurations/{configuration-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateConfigurationRequest" - }, - "output" : { - "shape" : "UpdateConfigurationResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ConflictException", - "documentation" : "HTTP Status Code 409: Conflict. This configuration name already exists. Retry your request with another configuration name." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your input and then retry your request." - } ], - "documentation" : "Updates the specified configuration." - }, - "UpdateUser" : { - "name" : "UpdateUser", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/brokers/{broker-id}/users/{username}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateUserRequest" - }, - "output" : { - "shape" : "UpdateUserResponse", - "documentation" : "HTTP Status Code 200: OK." - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "HTTP Status Code 404: Resource not found due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "BadRequestException", - "documentation" : "HTTP Status Code 400: Bad request due to incorrect input. Correct your request and then retry it." - }, { - "shape" : "InternalServerErrorException", - "documentation" : "HTTP Status Code 500: Unexpected internal server error. Retrying your request might resolve the issue." - }, { - "shape" : "ConflictException", - "documentation" : "HTTP Status Code 409: Conflict. Retry your request." - }, { - "shape" : "ForbiddenException", - "documentation" : "HTTP Status Code 403: Access forbidden. Correct your credentials and then retry your request." - } ], - "documentation" : "Updates the information for an ActiveMQ user." - } - }, - "shapes" : { - "BadRequestException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "BrokerInstance" : { - "type" : "structure", - "members" : { - "ConsoleURL" : { - "shape" : "__string", - "locationName" : "consoleURL", - "documentation" : "The URL of the broker's ActiveMQ Web Console." - }, - "Endpoints" : { - "shape" : "__listOf__string", - "locationName" : "endpoints", - "documentation" : "The broker's wire-level protocol endpoints." - }, - "IpAddress" : { - "shape" : "__string", - "locationName" : "ipAddress", - "documentation" : "The IP address of the ENI attached to the broker." - } - }, - "documentation" : "Returns information about all brokers." - }, - "BrokerState" : { - "type" : "string", - "documentation" : "The status of the broker.", - "enum" : [ "CREATION_IN_PROGRESS", "CREATION_FAILED", "DELETION_IN_PROGRESS", "RUNNING", "REBOOT_IN_PROGRESS" ] - }, - "BrokerSummary" : { - "type" : "structure", - "members" : { - "BrokerArn" : { - "shape" : "__string", - "locationName" : "brokerArn", - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "BrokerName" : { - "shape" : "__string", - "locationName" : "brokerName", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "BrokerState" : { - "shape" : "BrokerState", - "locationName" : "brokerState", - "documentation" : "The status of the broker." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "The time when the broker was created." - }, - "DeploymentMode" : { - "shape" : "DeploymentMode", - "locationName" : "deploymentMode", - "documentation" : "Required. The deployment mode of the broker." - }, - "HostInstanceType" : { - "shape" : "__string", - "locationName" : "hostInstanceType", - "documentation" : "The broker's instance type." - } - }, - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "ChangeType" : { - "type" : "string", - "documentation" : "The type of change pending for the ActiveMQ user.", - "enum" : [ "CREATE", "UPDATE", "DELETE" ] - }, - "Configuration" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The ARN of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration revision." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "Required. The description of the configuration." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "Required. The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - }, - "documentation" : "Returns information about all configurations." - }, - "ConfigurationId" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "Revision" : { - "shape" : "__integer", - "locationName" : "revision", - "documentation" : "The revision number of the configuration." - } - }, - "documentation" : "A list of information about the configuration." - }, - "ConfigurationRevision" : { - "type" : "structure", - "members" : { - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration revision." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of the configuration revision." - }, - "Revision" : { - "shape" : "__integer", - "locationName" : "revision", - "documentation" : "Required. The revision number of the configuration." - } - }, - "documentation" : "Returns information about the specified configuration revision." - }, - "Configurations" : { - "type" : "structure", - "members" : { - "Current" : { - "shape" : "ConfigurationId", - "locationName" : "current", - "documentation" : "The current configuration of the broker." - }, - "History" : { - "shape" : "__listOfConfigurationId", - "locationName" : "history", - "documentation" : "The history of configurations applied to the broker." - }, - "Pending" : { - "shape" : "ConfigurationId", - "locationName" : "pending", - "documentation" : "The pending configuration of the broker." - } - }, - "documentation" : "Broker configuration information" - }, - "ConflictException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 409 - } - }, - "CreateBrokerInput" : { - "type" : "structure", - "members" : { - "AutoMinorVersionUpgrade" : { - "shape" : "__boolean", - "locationName" : "autoMinorVersionUpgrade", - "documentation" : "Required. Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions. The automatic upgrades occur during the maintenance window of the broker or after a manual broker reboot." - }, - "BrokerName" : { - "shape" : "__string", - "locationName" : "brokerName", - "documentation" : "Required. The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "A list of information about the configuration." - }, - "CreatorRequestId" : { - "shape" : "__string", - "locationName" : "creatorRequestId", - "documentation" : "The unique ID that the requester receives for the created broker. Amazon MQ passes your ID with the API action. Note: We recommend using a Universally Unique Identifier (UUID) for the creatorRequestId. You may omit the creatorRequestId if your application doesn't require idempotency.", - "idempotencyToken" : true - }, - "DeploymentMode" : { - "shape" : "DeploymentMode", - "locationName" : "deploymentMode", - "documentation" : "Required. The deployment mode of the broker." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "HostInstanceType" : { - "shape" : "__string", - "locationName" : "hostInstanceType", - "documentation" : "Required. The broker's instance type." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "Enables Amazon CloudWatch logging for brokers." - }, - "MaintenanceWindowStartTime" : { - "shape" : "WeeklyStartTime", - "locationName" : "maintenanceWindowStartTime", - "documentation" : "The parameters that determine the WeeklyStartTime." - }, - "PubliclyAccessible" : { - "shape" : "__boolean", - "locationName" : "publiclyAccessible", - "documentation" : "Required. Enables connections from applications outside of the VPC that hosts the broker's subnets." - }, - "SecurityGroups" : { - "shape" : "__listOf__string", - "locationName" : "securityGroups", - "documentation" : "The list of rules (1 minimum, 125 maximum) that authorize connections to brokers." - }, - "SubnetIds" : { - "shape" : "__listOf__string", - "locationName" : "subnetIds", - "documentation" : "The list of groups (2 maximum) that define which subnets and IP ranges the broker can use from different Availability Zones. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets." - }, - "Users" : { - "shape" : "__listOfUser", - "locationName" : "users", - "documentation" : "Required. The list of ActiveMQ users (persons or applications) who can access queues and topics. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Required. The time period during which Amazon MQ applies pending updates or patches to the broker." - }, - "CreateBrokerOutput" : { - "type" : "structure", - "members" : { - "BrokerArn" : { - "shape" : "__string", - "locationName" : "brokerArn", - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - } - }, - "documentation" : "Returns information about the created broker." - }, - "CreateBrokerRequest" : { - "type" : "structure", - "members" : { - "AutoMinorVersionUpgrade" : { - "shape" : "__boolean", - "locationName" : "autoMinorVersionUpgrade", - "documentation" : "Required. Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions. The automatic upgrades occur during the maintenance window of the broker or after a manual broker reboot." - }, - "BrokerName" : { - "shape" : "__string", - "locationName" : "brokerName", - "documentation" : "Required. The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "A list of information about the configuration." - }, - "CreatorRequestId" : { - "shape" : "__string", - "locationName" : "creatorRequestId", - "documentation" : "The unique ID that the requester receives for the created broker. Amazon MQ passes your ID with the API action. Note: We recommend using a Universally Unique Identifier (UUID) for the creatorRequestId. You may omit the creatorRequestId if your application doesn't require idempotency.", - "idempotencyToken" : true - }, - "DeploymentMode" : { - "shape" : "DeploymentMode", - "locationName" : "deploymentMode", - "documentation" : "Required. The deployment mode of the broker." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "HostInstanceType" : { - "shape" : "__string", - "locationName" : "hostInstanceType", - "documentation" : "Required. The broker's instance type." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "Enables Amazon CloudWatch logging for brokers." - }, - "MaintenanceWindowStartTime" : { - "shape" : "WeeklyStartTime", - "locationName" : "maintenanceWindowStartTime", - "documentation" : "The parameters that determine the WeeklyStartTime." - }, - "PubliclyAccessible" : { - "shape" : "__boolean", - "locationName" : "publiclyAccessible", - "documentation" : "Required. Enables connections from applications outside of the VPC that hosts the broker's subnets." - }, - "SecurityGroups" : { - "shape" : "__listOf__string", - "locationName" : "securityGroups", - "documentation" : "The list of rules (1 minimum, 125 maximum) that authorize connections to brokers." - }, - "SubnetIds" : { - "shape" : "__listOf__string", - "locationName" : "subnetIds", - "documentation" : "The list of groups (2 maximum) that define which subnets and IP ranges the broker can use from different Availability Zones. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets." - }, - "Users" : { - "shape" : "__listOfUser", - "locationName" : "users", - "documentation" : "Required. The list of ActiveMQ users (persons or applications) who can access queues and topics. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Creates a broker using the specified properties." - }, - "CreateBrokerResponse" : { - "type" : "structure", - "members" : { - "BrokerArn" : { - "shape" : "__string", - "locationName" : "brokerArn", - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - } - } - }, - "CreateConfigurationInput" : { - "type" : "structure", - "members" : { - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - }, - "documentation" : "Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version)." - }, - "CreateConfigurationOutput" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The Amazon Resource Name (ARN) of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - }, - "documentation" : "Returns information about the created configuration." - }, - "CreateConfigurationRequest" : { - "type" : "structure", - "members" : { - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - }, - "documentation" : "Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version)." - }, - "CreateConfigurationResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The Amazon Resource Name (ARN) of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - } - }, - "CreateUserInput" : { - "type" : "structure", - "members" : { - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Password" : { - "shape" : "__string", - "locationName" : "password", - "documentation" : "Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas." - } - }, - "documentation" : "Creates a new ActiveMQ user." - }, - "CreateUserRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Password" : { - "shape" : "__string", - "locationName" : "password", - "documentation" : "Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas." - }, - "Username" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "username", - "documentation" : "The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Creates a new ActiveMQ user.", - "required" : [ "Username", "BrokerId" ] - }, - "CreateUserResponse" : { - "type" : "structure", - "members" : { } - }, - "DayOfWeek" : { - "type" : "string", - "enum" : [ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ] - }, - "DeleteBrokerOutput" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - } - }, - "documentation" : "Returns information about the deleted broker." - }, - "DeleteBrokerRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - } - }, - "required" : [ "BrokerId" ] - }, - "DeleteBrokerResponse" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - } - } - }, - "DeleteUserRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "Username" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "username", - "documentation" : "The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "required" : [ "Username", "BrokerId" ] - }, - "DeleteUserResponse" : { - "type" : "structure", - "members" : { } - }, - "DeploymentMode" : { - "type" : "string", - "documentation" : "The deployment mode of the broker.", - "enum" : [ "SINGLE_INSTANCE", "ACTIVE_STANDBY_MULTI_AZ" ] - }, - "DescribeBrokerOutput" : { - "type" : "structure", - "members" : { - "AutoMinorVersionUpgrade" : { - "shape" : "__boolean", - "locationName" : "autoMinorVersionUpgrade", - "documentation" : "Required. Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions. The automatic upgrades occur during the maintenance window of the broker or after a manual broker reboot." - }, - "BrokerArn" : { - "shape" : "__string", - "locationName" : "brokerArn", - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "BrokerInstances" : { - "shape" : "__listOfBrokerInstance", - "locationName" : "brokerInstances", - "documentation" : "A list of information about allocated brokers." - }, - "BrokerName" : { - "shape" : "__string", - "locationName" : "brokerName", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "BrokerState" : { - "shape" : "BrokerState", - "locationName" : "brokerState", - "documentation" : "The status of the broker." - }, - "Configurations" : { - "shape" : "Configurations", - "locationName" : "configurations", - "documentation" : "The list of all revisions for the specified configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "The time when the broker was created." - }, - "DeploymentMode" : { - "shape" : "DeploymentMode", - "locationName" : "deploymentMode", - "documentation" : "Required. The deployment mode of the broker." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "HostInstanceType" : { - "shape" : "__string", - "locationName" : "hostInstanceType", - "documentation" : "The broker's instance type." - }, - "Logs" : { - "shape" : "LogsSummary", - "locationName" : "logs", - "documentation" : "The list of information about logs currently enabled and pending to be deployed for the specified broker." - }, - "MaintenanceWindowStartTime" : { - "shape" : "WeeklyStartTime", - "locationName" : "maintenanceWindowStartTime", - "documentation" : "The parameters that determine the WeeklyStartTime." - }, - "PubliclyAccessible" : { - "shape" : "__boolean", - "locationName" : "publiclyAccessible", - "documentation" : "Required. Enables connections from applications outside of the VPC that hosts the broker's subnets." - }, - "SecurityGroups" : { - "shape" : "__listOf__string", - "locationName" : "securityGroups", - "documentation" : "Required. The list of rules (1 minimum, 125 maximum) that authorize connections to brokers." - }, - "SubnetIds" : { - "shape" : "__listOf__string", - "locationName" : "subnetIds", - "documentation" : "The list of groups (2 maximum) that define which subnets and IP ranges the broker can use from different Availability Zones. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets." - }, - "Users" : { - "shape" : "__listOfUserSummary", - "locationName" : "users", - "documentation" : "The list of all ActiveMQ usernames for the specified broker." - } - }, - "documentation" : "The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "DescribeBrokerRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - } - }, - "required" : [ "BrokerId" ] - }, - "DescribeBrokerResponse" : { - "type" : "structure", - "members" : { - "AutoMinorVersionUpgrade" : { - "shape" : "__boolean", - "locationName" : "autoMinorVersionUpgrade", - "documentation" : "Required. Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions. The automatic upgrades occur during the maintenance window of the broker or after a manual broker reboot." - }, - "BrokerArn" : { - "shape" : "__string", - "locationName" : "brokerArn", - "documentation" : "The Amazon Resource Name (ARN) of the broker." - }, - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "BrokerInstances" : { - "shape" : "__listOfBrokerInstance", - "locationName" : "brokerInstances", - "documentation" : "A list of information about allocated brokers." - }, - "BrokerName" : { - "shape" : "__string", - "locationName" : "brokerName", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "BrokerState" : { - "shape" : "BrokerState", - "locationName" : "brokerState", - "documentation" : "The status of the broker." - }, - "Configurations" : { - "shape" : "Configurations", - "locationName" : "configurations", - "documentation" : "The list of all revisions for the specified configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "The time when the broker was created." - }, - "DeploymentMode" : { - "shape" : "DeploymentMode", - "locationName" : "deploymentMode", - "documentation" : "Required. The deployment mode of the broker." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.0." - }, - "HostInstanceType" : { - "shape" : "__string", - "locationName" : "hostInstanceType", - "documentation" : "The broker's instance type." - }, - "Logs" : { - "shape" : "LogsSummary", - "locationName" : "logs", - "documentation" : "The list of information about logs currently enabled and pending to be deployed for the specified broker." - }, - "MaintenanceWindowStartTime" : { - "shape" : "WeeklyStartTime", - "locationName" : "maintenanceWindowStartTime", - "documentation" : "The parameters that determine the WeeklyStartTime." - }, - "PubliclyAccessible" : { - "shape" : "__boolean", - "locationName" : "publiclyAccessible", - "documentation" : "Required. Enables connections from applications outside of the VPC that hosts the broker's subnets." - }, - "SecurityGroups" : { - "shape" : "__listOf__string", - "locationName" : "securityGroups", - "documentation" : "Required. The list of rules (1 minimum, 125 maximum) that authorize connections to brokers." - }, - "SubnetIds" : { - "shape" : "__listOf__string", - "locationName" : "subnetIds", - "documentation" : "The list of groups (2 maximum) that define which subnets and IP ranges the broker can use from different Availability Zones. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets." - }, - "Users" : { - "shape" : "__listOfUserSummary", - "locationName" : "users", - "documentation" : "The list of all ActiveMQ usernames for the specified broker." - } - } - }, - "DescribeConfigurationRequest" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "configuration-id", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - } - }, - "required" : [ "ConfigurationId" ] - }, - "DescribeConfigurationResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The ARN of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration revision." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "Required. The description of the configuration." - }, - "EngineType" : { - "shape" : "EngineType", - "locationName" : "engineType", - "documentation" : "Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ." - }, - "EngineVersion" : { - "shape" : "__string", - "locationName" : "engineVersion", - "documentation" : "Required. The version of the broker engine." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "Required. The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - } - } - }, - "DescribeConfigurationRevisionOutput" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "locationName" : "configurationId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Data" : { - "shape" : "__string", - "locationName" : "data", - "documentation" : "Required. The base64-encoded XML configuration." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of the configuration." - } - }, - "documentation" : "Returns the specified configuration revision for the specified configuration." - }, - "DescribeConfigurationRevisionRequest" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "configuration-id", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - }, - "ConfigurationRevision" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "configuration-revision", - "documentation" : "The revision of the configuration." - } - }, - "required" : [ "ConfigurationRevision", "ConfigurationId" ] - }, - "DescribeConfigurationRevisionResponse" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "locationName" : "configurationId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Data" : { - "shape" : "__string", - "locationName" : "data", - "documentation" : "Required. The base64-encoded XML configuration." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of the configuration." - } - } - }, - "DescribeUserOutput" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Pending" : { - "shape" : "UserPendingChanges", - "locationName" : "pending", - "documentation" : "The status of the changes pending for the ActiveMQ user." - }, - "Username" : { - "shape" : "__string", - "locationName" : "username", - "documentation" : "Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Returns information about an ActiveMQ user." - }, - "DescribeUserRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "Username" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "username", - "documentation" : "The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "required" : [ "Username", "BrokerId" ] - }, - "DescribeUserResponse" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Pending" : { - "shape" : "UserPendingChanges", - "locationName" : "pending", - "documentation" : "The status of the changes pending for the ActiveMQ user." - }, - "Username" : { - "shape" : "__string", - "locationName" : "username", - "documentation" : "Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - } - }, - "EngineType" : { - "type" : "string", - "documentation" : "The type of broker engine. Note: Currently, Amazon MQ supports only ActiveMQ.", - "enum" : [ "ACTIVEMQ" ] - }, - "Error" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error." - }, - "ForbiddenException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 403 - } - }, - "InternalServerErrorException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "ListBrokersOutput" : { - "type" : "structure", - "members" : { - "BrokerSummaries" : { - "shape" : "__listOfBrokerSummary", - "locationName" : "brokerSummaries", - "documentation" : "A list of information about all brokers." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - }, - "documentation" : "A list of information about all brokers." - }, - "ListBrokersRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "The maximum number of brokers that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - } - }, - "ListBrokersResponse" : { - "type" : "structure", - "members" : { - "BrokerSummaries" : { - "shape" : "__listOfBrokerSummary", - "locationName" : "brokerSummaries", - "documentation" : "A list of information about all brokers." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - } - }, - "ListConfigurationRevisionsOutput" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "locationName" : "configurationId", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - }, - "MaxResults" : { - "shape" : "__integer", - "locationName" : "maxResults", - "documentation" : "The maximum number of configuration revisions that can be returned per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - }, - "Revisions" : { - "shape" : "__listOfConfigurationRevision", - "locationName" : "revisions", - "documentation" : "The list of all revisions for the specified configuration." - } - }, - "documentation" : "Returns a list of all revisions for the specified configuration." - }, - "ListConfigurationRevisionsRequest" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "configuration-id", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "The maximum number of configurations that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - }, - "required" : [ "ConfigurationId" ] - }, - "ListConfigurationRevisionsResponse" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "locationName" : "configurationId", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - }, - "MaxResults" : { - "shape" : "__integer", - "locationName" : "maxResults", - "documentation" : "The maximum number of configuration revisions that can be returned per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - }, - "Revisions" : { - "shape" : "__listOfConfigurationRevision", - "locationName" : "revisions", - "documentation" : "The list of all revisions for the specified configuration." - } - } - }, - "ListConfigurationsOutput" : { - "type" : "structure", - "members" : { - "Configurations" : { - "shape" : "__listOfConfiguration", - "locationName" : "configurations", - "documentation" : "The list of all revisions for the specified configuration." - }, - "MaxResults" : { - "shape" : "__integer", - "locationName" : "maxResults", - "documentation" : "The maximum number of configurations that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - }, - "documentation" : "Returns a list of all configurations." - }, - "ListConfigurationsRequest" : { - "type" : "structure", - "members" : { - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "The maximum number of configurations that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - } - }, - "ListConfigurationsResponse" : { - "type" : "structure", - "members" : { - "Configurations" : { - "shape" : "__listOfConfiguration", - "locationName" : "configurations", - "documentation" : "The list of all revisions for the specified configuration." - }, - "MaxResults" : { - "shape" : "__integer", - "locationName" : "maxResults", - "documentation" : "The maximum number of configurations that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - } - }, - "ListUsersOutput" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "MaxResults" : { - "shape" : "__integerMin5Max100", - "locationName" : "maxResults", - "documentation" : "Required. The maximum number of ActiveMQ users that can be returned per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - }, - "Users" : { - "shape" : "__listOfUserSummary", - "locationName" : "users", - "documentation" : "Required. The list of all ActiveMQ usernames for the specified broker." - } - }, - "documentation" : "Returns a list of all ActiveMQ users." - }, - "ListUsersRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "MaxResults" : { - "shape" : "MaxResults", - "location" : "querystring", - "locationName" : "maxResults", - "documentation" : "The maximum number of ActiveMQ users that can be returned per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - } - }, - "required" : [ "BrokerId" ] - }, - "ListUsersResponse" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "MaxResults" : { - "shape" : "__integerMin5Max100", - "locationName" : "maxResults", - "documentation" : "Required. The maximum number of ActiveMQ users that can be returned per page (20 by default). This value must be an integer from 5 to 100." - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty." - }, - "Users" : { - "shape" : "__listOfUserSummary", - "locationName" : "users", - "documentation" : "Required. The list of all ActiveMQ usernames for the specified broker." - } - } - }, - "Logs" : { - "type" : "structure", - "members" : { - "Audit" : { - "shape" : "__boolean", - "locationName" : "audit", - "documentation" : "Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged." - }, - "General" : { - "shape" : "__boolean", - "locationName" : "general", - "documentation" : "Enables general logging." - } - }, - "documentation" : "The list of information about logs to be enabled for the specified broker." - }, - "LogsSummary" : { - "type" : "structure", - "members" : { - "Audit" : { - "shape" : "__boolean", - "locationName" : "audit", - "documentation" : "Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged." - }, - "AuditLogGroup" : { - "shape" : "__string", - "locationName" : "auditLogGroup", - "documentation" : "Location of CloudWatch Log group where audit logs will be sent." - }, - "General" : { - "shape" : "__boolean", - "locationName" : "general", - "documentation" : "Enables general logging." - }, - "GeneralLogGroup" : { - "shape" : "__string", - "locationName" : "generalLogGroup", - "documentation" : "Location of CloudWatch Log group where general logs will be sent." - }, - "Pending" : { - "shape" : "PendingLogs", - "locationName" : "pending", - "documentation" : "The list of information about logs pending to be deployed for the specified broker." - } - }, - "documentation" : "The list of information about logs currently enabled and pending to be deployed for the specified broker." - }, - "MaxResults" : { - "type" : "integer", - "min" : 1, - "max" : 100 - }, - "NotFoundException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 404 - } - }, - "PendingLogs" : { - "type" : "structure", - "members" : { - "Audit" : { - "shape" : "__boolean", - "locationName" : "audit", - "documentation" : "Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged." - }, - "General" : { - "shape" : "__boolean", - "locationName" : "general", - "documentation" : "Enables general logging." - } - }, - "documentation" : "The list of information about logs to be enabled for the specified broker." - }, - "RebootBrokerRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - } - }, - "required" : [ "BrokerId" ] - }, - "RebootBrokerResponse" : { - "type" : "structure", - "members" : { } - }, - "SanitizationWarning" : { - "type" : "structure", - "members" : { - "AttributeName" : { - "shape" : "__string", - "locationName" : "attributeName", - "documentation" : "The name of the XML attribute that has been sanitized." - }, - "ElementName" : { - "shape" : "__string", - "locationName" : "elementName", - "documentation" : "The name of the XML element that has been sanitized." - }, - "Reason" : { - "shape" : "SanitizationWarningReason", - "locationName" : "reason", - "documentation" : "Required. The reason for which the XML elements or attributes were sanitized." - } - }, - "documentation" : "Returns information about the XML element or attribute that was sanitized in the configuration." - }, - "SanitizationWarningReason" : { - "type" : "string", - "documentation" : "The reason for which the XML elements or attributes were sanitized.", - "enum" : [ "DISALLOWED_ELEMENT_REMOVED", "DISALLOWED_ATTRIBUTE_REMOVED", "INVALID_ATTRIBUTE_VALUE_REMOVED" ] - }, - "UnauthorizedException" : { - "type" : "structure", - "members" : { - "ErrorAttribute" : { - "shape" : "__string", - "locationName" : "errorAttribute", - "documentation" : "The attribute which caused the error." - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "The explanation of the error." - } - }, - "documentation" : "Returns information about an error.", - "exception" : true, - "error" : { - "httpStatusCode" : 401 - } - }, - "UpdateBrokerInput" : { - "type" : "structure", - "members" : { - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "A list of information about the configuration." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "Enables Amazon CloudWatch logging for brokers." - } - }, - "documentation" : "Updates the broker using the specified properties." - }, - "UpdateBrokerOutput" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "The ID of the updated configuration." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "The list of information about logs to be enabled for the specified broker." - } - }, - "documentation" : "Returns information about the updated broker." - }, - "UpdateBrokerRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters." - }, - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "A list of information about the configuration." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "Enables Amazon CloudWatch logging for brokers." - } - }, - "documentation" : "Updates the broker using the specified properties.", - "required" : [ "BrokerId" ] - }, - "UpdateBrokerResponse" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "locationName" : "brokerId", - "documentation" : "Required. The unique ID that Amazon MQ generates for the broker." - }, - "Configuration" : { - "shape" : "ConfigurationId", - "locationName" : "configuration", - "documentation" : "The ID of the updated configuration." - }, - "Logs" : { - "shape" : "Logs", - "locationName" : "logs", - "documentation" : "The list of information about logs to be enabled for the specified broker." - } - } - }, - "UpdateConfigurationInput" : { - "type" : "structure", - "members" : { - "Data" : { - "shape" : "__string", - "locationName" : "data", - "documentation" : "Required. The base64-encoded XML configuration." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of the configuration." - } - }, - "documentation" : "Updates the specified configuration." - }, - "UpdateConfigurationOutput" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The Amazon Resource Name (ARN) of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - }, - "Warnings" : { - "shape" : "__listOfSanitizationWarning", - "locationName" : "warnings", - "documentation" : "The list of the first 20 warnings about the configuration XML elements or attributes that were sanitized." - } - }, - "documentation" : "Returns information about the updated configuration." - }, - "UpdateConfigurationRequest" : { - "type" : "structure", - "members" : { - "ConfigurationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "configuration-id", - "documentation" : "The unique ID that Amazon MQ generates for the configuration." - }, - "Data" : { - "shape" : "__string", - "locationName" : "data", - "documentation" : "Required. The base64-encoded XML configuration." - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "The description of the configuration." - } - }, - "documentation" : "Updates the specified configuration.", - "required" : [ "ConfigurationId" ] - }, - "UpdateConfigurationResponse" : { - "type" : "structure", - "members" : { - "Arn" : { - "shape" : "__string", - "locationName" : "arn", - "documentation" : "Required. The Amazon Resource Name (ARN) of the configuration." - }, - "Created" : { - "shape" : "__timestampIso8601", - "locationName" : "created", - "documentation" : "Required. The date and time of the configuration." - }, - "Id" : { - "shape" : "__string", - "locationName" : "id", - "documentation" : "Required. The unique ID that Amazon MQ generates for the configuration." - }, - "LatestRevision" : { - "shape" : "ConfigurationRevision", - "locationName" : "latestRevision", - "documentation" : "The latest revision of the configuration." - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long." - }, - "Warnings" : { - "shape" : "__listOfSanitizationWarning", - "locationName" : "warnings", - "documentation" : "The list of the first 20 warnings about the configuration XML elements or attributes that were sanitized." - } - } - }, - "UpdateUserInput" : { - "type" : "structure", - "members" : { - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Password" : { - "shape" : "__string", - "locationName" : "password", - "documentation" : "The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas." - } - }, - "documentation" : "Updates the information for an ActiveMQ user." - }, - "UpdateUserRequest" : { - "type" : "structure", - "members" : { - "BrokerId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "broker-id", - "documentation" : "The unique ID that Amazon MQ generates for the broker." - }, - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Password" : { - "shape" : "__string", - "locationName" : "password", - "documentation" : "The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas." - }, - "Username" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "username", - "documentation" : "Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Updates the information for an ActiveMQ user.", - "required" : [ "Username", "BrokerId" ] - }, - "UpdateUserResponse" : { - "type" : "structure", - "members" : { } - }, - "User" : { - "type" : "structure", - "members" : { - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "Password" : { - "shape" : "__string", - "locationName" : "password", - "documentation" : "Required. The password of the ActiveMQ user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas." - }, - "Username" : { - "shape" : "__string", - "locationName" : "username", - "documentation" : "Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "An ActiveMQ user associated with the broker." - }, - "UserPendingChanges" : { - "type" : "structure", - "members" : { - "ConsoleAccess" : { - "shape" : "__boolean", - "locationName" : "consoleAccess", - "documentation" : "Enables access to the the ActiveMQ Web Console for the ActiveMQ user." - }, - "Groups" : { - "shape" : "__listOf__string", - "locationName" : "groups", - "documentation" : "The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - }, - "PendingChange" : { - "shape" : "ChangeType", - "locationName" : "pendingChange", - "documentation" : "Required. The type of change pending for the ActiveMQ user." - } - }, - "documentation" : "Returns information about the status of the changes pending for the ActiveMQ user." - }, - "UserSummary" : { - "type" : "structure", - "members" : { - "PendingChange" : { - "shape" : "ChangeType", - "locationName" : "pendingChange", - "documentation" : "The type of change pending for the ActiveMQ user." - }, - "Username" : { - "shape" : "__string", - "locationName" : "username", - "documentation" : "Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long." - } - }, - "documentation" : "Returns a list of all ActiveMQ users." - }, - "WeeklyStartTime" : { - "type" : "structure", - "members" : { - "DayOfWeek" : { - "shape" : "DayOfWeek", - "locationName" : "dayOfWeek", - "documentation" : "Required. The day of the week." - }, - "TimeOfDay" : { - "shape" : "__string", - "locationName" : "timeOfDay", - "documentation" : "Required. The time, in 24-hour format." - }, - "TimeZone" : { - "shape" : "__string", - "locationName" : "timeZone", - "documentation" : "The time zone, UTC by default, in either the Country/City format, or the UTC offset format." - } - }, - "documentation" : "The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker." - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__integerMin5Max100" : { - "type" : "integer", - "min" : 5, - "max" : 100 - }, - "__listOfBrokerInstance" : { - "type" : "list", - "member" : { - "shape" : "BrokerInstance" - } - }, - "__listOfBrokerSummary" : { - "type" : "list", - "member" : { - "shape" : "BrokerSummary" - } - }, - "__listOfConfiguration" : { - "type" : "list", - "member" : { - "shape" : "Configuration" - } - }, - "__listOfConfigurationId" : { - "type" : "list", - "member" : { - "shape" : "ConfigurationId" - } - }, - "__listOfConfigurationRevision" : { - "type" : "list", - "member" : { - "shape" : "ConfigurationRevision" - } - }, - "__listOfSanitizationWarning" : { - "type" : "list", - "member" : { - "shape" : "SanitizationWarning" - } - }, - "__listOfUser" : { - "type" : "list", - "member" : { - "shape" : "User" - } - }, - "__listOfUserSummary" : { - "type" : "list", - "member" : { - "shape" : "UserSummary" - } - }, - "__listOf__string" : { - "type" : "list", - "member" : { - "shape" : "__string" - } - }, - "__long" : { - "type" : "long" - }, - "__string" : { - "type" : "string" - }, - "__timestampIso8601" : { - "type" : "timestamp", - "timestampFormat" : "iso8601" - }, - "__timestampUnix" : { - "type" : "timestamp", - "timestampFormat" : "unixTimestamp" - } - }, - "documentation" : "Amazon MQ is a managed message broker service for Apache ActiveMQ that makes it easy to set up and operate message brokers in the cloud. A message broker allows software applications and components to communicate using various programming languages, operating systems, and formal messaging protocols." -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/paginators-1.json deleted file mode 100644 index ea50cacc..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/paginators-1.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "pagination": { - "ListAssignmentsForHIT": { - "result_key": "Assignments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListQualificationTypes": { - "result_key": "QualificationTypes", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListHITs": { - "result_key": "HITs", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListWorkerBlocks": { - "result_key": "WorkerBlocks", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListReviewableHITs": { - "result_key": "HITs", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListHITsForQualificationType": { - "result_key": "HITs", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListQualificationRequests": { - "result_key": "QualificationRequests", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListWorkersWithQualificationType": { - "result_key": "Qualifications", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListBonusPayments": { - "result_key": "BonusPayments", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/service-2.json deleted file mode 100644 index 77db25a9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/mturk/2017-01-17/service-2.json +++ /dev/null @@ -1,2569 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-01-17", - "endpointPrefix":"mturk-requester", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon MTurk", - "serviceFullName":"Amazon Mechanical Turk", - "serviceId":"MTurk", - "signatureVersion":"v4", - "targetPrefix":"MTurkRequesterServiceV20170117", - "uid":"mturk-requester-2017-01-17" - }, - "operations":{ - "AcceptQualificationRequest":{ - "name":"AcceptQualificationRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptQualificationRequestRequest"}, - "output":{"shape":"AcceptQualificationRequestResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The AcceptQualificationRequest operation approves a Worker's request for a Qualification.

Only the owner of the Qualification type can grant a Qualification request for that type.

A successful request for the AcceptQualificationRequest operation returns with no errors and an empty body.

" - }, - "ApproveAssignment":{ - "name":"ApproveAssignment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ApproveAssignmentRequest"}, - "output":{"shape":"ApproveAssignmentResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ApproveAssignment operation approves the results of a completed assignment.

Approving an assignment initiates two payments from the Requester's Amazon.com account

  • The Worker who submitted the results is paid the reward specified in the HIT.

  • Amazon Mechanical Turk fees are debited.

If the Requester's account does not have adequate funds for these payments, the call to ApproveAssignment returns an exception, and the approval is not processed. You can include an optional feedback message with the approval, which the Worker can see in the Status section of the web site.

You can also call this operation for assignments that were previous rejected and approve them by explicitly overriding the previous rejection. This only works on rejected assignments that were submitted within the previous 30 days and only if the assignment's related HIT has not been deleted.

", - "idempotent":true - }, - "AssociateQualificationWithWorker":{ - "name":"AssociateQualificationWithWorker", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateQualificationWithWorkerRequest"}, - "output":{"shape":"AssociateQualificationWithWorkerResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The AssociateQualificationWithWorker operation gives a Worker a Qualification. AssociateQualificationWithWorker does not require that the Worker submit a Qualification request. It gives the Qualification directly to the Worker.

You can only assign a Qualification of a Qualification type that you created (using the CreateQualificationType operation).

Note: AssociateQualificationWithWorker does not affect any pending Qualification requests for the Qualification by the Worker. If you assign a Qualification to a Worker, then later grant a Qualification request made by the Worker, the granting of the request may modify the Qualification score. To resolve a pending Qualification request without affecting the Qualification the Worker already has, reject the request with the RejectQualificationRequest operation.

" - }, - "CreateAdditionalAssignmentsForHIT":{ - "name":"CreateAdditionalAssignmentsForHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAdditionalAssignmentsForHITRequest"}, - "output":{"shape":"CreateAdditionalAssignmentsForHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateAdditionalAssignmentsForHIT operation increases the maximum number of assignments of an existing HIT.

To extend the maximum number of assignments, specify the number of additional assignments.

  • HITs created with fewer than 10 assignments cannot be extended to have 10 or more assignments. Attempting to add assignments in a way that brings the total number of assignments for a HIT from fewer than 10 assignments to 10 or more assignments will result in an AWS.MechanicalTurk.InvalidMaximumAssignmentsIncrease exception.

  • HITs that were created before July 22, 2015 cannot be extended. Attempting to extend HITs that were created before July 22, 2015 will result in an AWS.MechanicalTurk.HITTooOldForExtension exception.

" - }, - "CreateHIT":{ - "name":"CreateHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHITRequest"}, - "output":{"shape":"CreateHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateHIT operation creates a new Human Intelligence Task (HIT). The new HIT is made available for Workers to find and accept on the Amazon Mechanical Turk website.

This operation allows you to specify a new HIT by passing in values for the properties of the HIT, such as its title, reward amount and number of assignments. When you pass these values to CreateHIT, a new HIT is created for you, with a new HITTypeID. The HITTypeID can be used to create additional HITs in the future without needing to specify common parameters such as the title, description and reward amount each time.

An alternative way to create HITs is to first generate a HITTypeID using the CreateHITType operation and then call the CreateHITWithHITType operation. This is the recommended best practice for Requesters who are creating large numbers of HITs.

CreateHIT also supports several ways to provide question data: by providing a value for the Question parameter that fully specifies the contents of the HIT, or by providing a HitLayoutId and associated HitLayoutParameters.

If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing.

" - }, - "CreateHITType":{ - "name":"CreateHITType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHITTypeRequest"}, - "output":{"shape":"CreateHITTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateHITType operation creates a new HIT type. This operation allows you to define a standard set of HIT properties to use when creating HITs. If you register a HIT type with values that match an existing HIT type, the HIT type ID of the existing type will be returned.

", - "idempotent":true - }, - "CreateHITWithHITType":{ - "name":"CreateHITWithHITType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHITWithHITTypeRequest"}, - "output":{"shape":"CreateHITWithHITTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateHITWithHITType operation creates a new Human Intelligence Task (HIT) using an existing HITTypeID generated by the CreateHITType operation.

This is an alternative way to create HITs from the CreateHIT operation. This is the recommended best practice for Requesters who are creating large numbers of HITs.

CreateHITWithHITType also supports several ways to provide question data: by providing a value for the Question parameter that fully specifies the contents of the HIT, or by providing a HitLayoutId and associated HitLayoutParameters.

If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing.

" - }, - "CreateQualificationType":{ - "name":"CreateQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateQualificationTypeRequest"}, - "output":{"shape":"CreateQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateQualificationType operation creates a new Qualification type, which is represented by a QualificationType data structure.

" - }, - "CreateWorkerBlock":{ - "name":"CreateWorkerBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateWorkerBlockRequest"}, - "output":{"shape":"CreateWorkerBlockResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The CreateWorkerBlock operation allows you to prevent a Worker from working on your HITs. For example, you can block a Worker who is producing poor quality work. You can block up to 100,000 Workers.

" - }, - "DeleteHIT":{ - "name":"DeleteHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHITRequest"}, - "output":{"shape":"DeleteHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The DeleteHIT operation is used to delete HIT that is no longer needed. Only the Requester who created the HIT can delete it.

You can only dispose of HITs that are in the Reviewable state, with all of their submitted assignments already either approved or rejected. If you call the DeleteHIT operation on a HIT that is not in the Reviewable state (for example, that has not expired, or still has active assignments), or on a HIT that is Reviewable but without all of its submitted assignments already approved or rejected, the service will return an error.

  • HITs are automatically disposed of after 120 days.

  • After you dispose of a HIT, you can no longer approve the HIT's rejected assignments.

  • Disposed HITs are not returned in results for the ListHITs operation.

  • Disposing HITs can improve the performance of operations such as ListReviewableHITs and ListHITs.

", - "idempotent":true - }, - "DeleteQualificationType":{ - "name":"DeleteQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteQualificationTypeRequest"}, - "output":{"shape":"DeleteQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The DeleteQualificationType deletes a Qualification type and deletes any HIT types that are associated with the Qualification type.

This operation does not revoke Qualifications already assigned to Workers because the Qualifications might be needed for active HITs. If there are any pending requests for the Qualification type, Amazon Mechanical Turk rejects those requests. After you delete a Qualification type, you can no longer use it to create HITs or HIT types.

DeleteQualificationType must wait for all the HITs that use the deleted Qualification type to be deleted before completing. It may take up to 48 hours before DeleteQualificationType completes and the unique name of the Qualification type is available for reuse with CreateQualificationType.

", - "idempotent":true - }, - "DeleteWorkerBlock":{ - "name":"DeleteWorkerBlock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteWorkerBlockRequest"}, - "output":{"shape":"DeleteWorkerBlockResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The DeleteWorkerBlock operation allows you to reinstate a blocked Worker to work on your HITs. This operation reverses the effects of the CreateWorkerBlock operation. You need the Worker ID to use this operation. If the Worker ID is missing or invalid, this operation fails and returns the message “WorkerId is invalid.” If the specified Worker is not blocked, this operation returns successfully.

", - "idempotent":true - }, - "DisassociateQualificationFromWorker":{ - "name":"DisassociateQualificationFromWorker", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateQualificationFromWorkerRequest"}, - "output":{"shape":"DisassociateQualificationFromWorkerResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The DisassociateQualificationFromWorker revokes a previously granted Qualification from a user.

You can provide a text message explaining why the Qualification was revoked. The user who had the Qualification can see this message.

" - }, - "GetAccountBalance":{ - "name":"GetAccountBalance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAccountBalanceRequest"}, - "output":{"shape":"GetAccountBalanceResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetAccountBalance operation retrieves the amount of money in your Amazon Mechanical Turk account.

", - "idempotent":true - }, - "GetAssignment":{ - "name":"GetAssignment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAssignmentRequest"}, - "output":{"shape":"GetAssignmentResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetAssignment operation retrieves the details of the specified Assignment.

", - "idempotent":true - }, - "GetFileUploadURL":{ - "name":"GetFileUploadURL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetFileUploadURLRequest"}, - "output":{"shape":"GetFileUploadURLResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetFileUploadURL operation generates and returns a temporary URL. You use the temporary URL to retrieve a file uploaded by a Worker as an answer to a FileUploadAnswer question for a HIT. The temporary URL is generated the instant the GetFileUploadURL operation is called, and is valid for 60 seconds. You can get a temporary file upload URL any time until the HIT is disposed. After the HIT is disposed, any uploaded files are deleted, and cannot be retrieved. Pending Deprecation on December 12, 2017. The Answer Specification structure will no longer support the FileUploadAnswer element to be used for the QuestionForm data structure. Instead, we recommend that Requesters who want to create HITs asking Workers to upload files to use Amazon S3.

", - "idempotent":true - }, - "GetHIT":{ - "name":"GetHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetHITRequest"}, - "output":{"shape":"GetHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetHIT operation retrieves the details of the specified HIT.

", - "idempotent":true - }, - "GetQualificationScore":{ - "name":"GetQualificationScore", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQualificationScoreRequest"}, - "output":{"shape":"GetQualificationScoreResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetQualificationScore operation returns the value of a Worker's Qualification for a given Qualification type.

To get a Worker's Qualification, you must know the Worker's ID. The Worker's ID is included in the assignment data returned by the ListAssignmentsForHIT operation.

Only the owner of a Qualification type can query the value of a Worker's Qualification of that type.

", - "idempotent":true - }, - "GetQualificationType":{ - "name":"GetQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQualificationTypeRequest"}, - "output":{"shape":"GetQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The GetQualificationTypeoperation retrieves information about a Qualification type using its ID.

", - "idempotent":true - }, - "ListAssignmentsForHIT":{ - "name":"ListAssignmentsForHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssignmentsForHITRequest"}, - "output":{"shape":"ListAssignmentsForHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListAssignmentsForHIT operation retrieves completed assignments for a HIT. You can use this operation to retrieve the results for a HIT.

You can get assignments for a HIT at any time, even if the HIT is not yet Reviewable. If a HIT requested multiple assignments, and has received some results but has not yet become Reviewable, you can still retrieve the partial results with this operation.

Use the AssignmentStatus parameter to control which set of assignments for a HIT are returned. The ListAssignmentsForHIT operation can return submitted assignments awaiting approval, or it can return assignments that have already been approved or rejected. You can set AssignmentStatus=Approved,Rejected to get assignments that have already been approved and rejected together in one result set.

Only the Requester who created the HIT can retrieve the assignments for that HIT.

Results are sorted and divided into numbered pages and the operation returns a single page of results. You can use the parameters of the operation to control sorting and pagination.

", - "idempotent":true - }, - "ListBonusPayments":{ - "name":"ListBonusPayments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListBonusPaymentsRequest"}, - "output":{"shape":"ListBonusPaymentsResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListBonusPayments operation retrieves the amounts of bonuses you have paid to Workers for a given HIT or assignment.

", - "idempotent":true - }, - "ListHITs":{ - "name":"ListHITs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHITsRequest"}, - "output":{"shape":"ListHITsResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListHITs operation returns all of a Requester's HITs. The operation returns HITs of any status, except for HITs that have been deleted of with the DeleteHIT operation or that have been auto-deleted.

", - "idempotent":true - }, - "ListHITsForQualificationType":{ - "name":"ListHITsForQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHITsForQualificationTypeRequest"}, - "output":{"shape":"ListHITsForQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListHITsForQualificationType operation returns the HITs that use the given Qualification type for a Qualification requirement. The operation returns HITs of any status, except for HITs that have been deleted with the DeleteHIT operation or that have been auto-deleted.

", - "idempotent":true - }, - "ListQualificationRequests":{ - "name":"ListQualificationRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListQualificationRequestsRequest"}, - "output":{"shape":"ListQualificationRequestsResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListQualificationRequests operation retrieves requests for Qualifications of a particular Qualification type. The owner of the Qualification type calls this operation to poll for pending requests, and accepts them using the AcceptQualification operation.

", - "idempotent":true - }, - "ListQualificationTypes":{ - "name":"ListQualificationTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListQualificationTypesRequest"}, - "output":{"shape":"ListQualificationTypesResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListQualificationTypes operation returns a list of Qualification types, filtered by an optional search term.

", - "idempotent":true - }, - "ListReviewPolicyResultsForHIT":{ - "name":"ListReviewPolicyResultsForHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListReviewPolicyResultsForHITRequest"}, - "output":{"shape":"ListReviewPolicyResultsForHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListReviewPolicyResultsForHIT operation retrieves the computed results and the actions taken in the course of executing your Review Policies for a given HIT. For information about how to specify Review Policies when you call CreateHIT, see Review Policies. The ListReviewPolicyResultsForHIT operation can return results for both Assignment-level and HIT-level review results.

", - "idempotent":true - }, - "ListReviewableHITs":{ - "name":"ListReviewableHITs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListReviewableHITsRequest"}, - "output":{"shape":"ListReviewableHITsResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListReviewableHITs operation retrieves the HITs with Status equal to Reviewable or Status equal to Reviewing that belong to the Requester calling the operation.

", - "idempotent":true - }, - "ListWorkerBlocks":{ - "name":"ListWorkerBlocks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWorkerBlocksRequest"}, - "output":{"shape":"ListWorkerBlocksResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListWorkersBlocks operation retrieves a list of Workers who are blocked from working on your HITs.

", - "idempotent":true - }, - "ListWorkersWithQualificationType":{ - "name":"ListWorkersWithQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWorkersWithQualificationTypeRequest"}, - "output":{"shape":"ListWorkersWithQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The ListWorkersWithQualificationType operation returns all of the Workers that have been associated with a given Qualification type.

", - "idempotent":true - }, - "NotifyWorkers":{ - "name":"NotifyWorkers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"NotifyWorkersRequest"}, - "output":{"shape":"NotifyWorkersResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The NotifyWorkers operation sends an email to one or more Workers that you specify with the Worker ID. You can specify up to 100 Worker IDs to send the same message with a single call to the NotifyWorkers operation. The NotifyWorkers operation will send a notification email to a Worker only if you have previously approved or rejected work from the Worker.

" - }, - "RejectAssignment":{ - "name":"RejectAssignment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectAssignmentRequest"}, - "output":{"shape":"RejectAssignmentResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The RejectAssignment operation rejects the results of a completed assignment.

You can include an optional feedback message with the rejection, which the Worker can see in the Status section of the web site. When you include a feedback message with the rejection, it helps the Worker understand why the assignment was rejected, and can improve the quality of the results the Worker submits in the future.

Only the Requester who created the HIT can reject an assignment for the HIT.

", - "idempotent":true - }, - "RejectQualificationRequest":{ - "name":"RejectQualificationRequest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectQualificationRequestRequest"}, - "output":{"shape":"RejectQualificationRequestResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The RejectQualificationRequest operation rejects a user's request for a Qualification.

You can provide a text message explaining why the request was rejected. The Worker who made the request can see this message.

" - }, - "SendBonus":{ - "name":"SendBonus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendBonusRequest"}, - "output":{"shape":"SendBonusResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The SendBonus operation issues a payment of money from your account to a Worker. This payment happens separately from the reward you pay to the Worker when you approve the Worker's assignment. The SendBonus operation requires the Worker's ID and the assignment ID as parameters to initiate payment of the bonus. You must include a message that explains the reason for the bonus payment, as the Worker may not be expecting the payment. Amazon Mechanical Turk collects a fee for bonus payments, similar to the HIT listing fee. This operation fails if your account does not have enough funds to pay for both the bonus and the fees.

" - }, - "SendTestEventNotification":{ - "name":"SendTestEventNotification", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendTestEventNotificationRequest"}, - "output":{"shape":"SendTestEventNotificationResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The SendTestEventNotification operation causes Amazon Mechanical Turk to send a notification message as if a HIT event occurred, according to the provided notification specification. This allows you to test notifications without setting up notifications for a real HIT type and trying to trigger them using the website. When you call this operation, the service attempts to send the test notification immediately.

" - }, - "UpdateExpirationForHIT":{ - "name":"UpdateExpirationForHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateExpirationForHITRequest"}, - "output":{"shape":"UpdateExpirationForHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The UpdateExpirationForHIT operation allows you update the expiration time of a HIT. If you update it to a time in the past, the HIT will be immediately expired.

", - "idempotent":true - }, - "UpdateHITReviewStatus":{ - "name":"UpdateHITReviewStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateHITReviewStatusRequest"}, - "output":{"shape":"UpdateHITReviewStatusResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The UpdateHITReviewStatus operation updates the status of a HIT. If the status is Reviewable, this operation can update the status to Reviewing, or it can revert a Reviewing HIT back to the Reviewable status.

", - "idempotent":true - }, - "UpdateHITTypeOfHIT":{ - "name":"UpdateHITTypeOfHIT", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateHITTypeOfHITRequest"}, - "output":{"shape":"UpdateHITTypeOfHITResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The UpdateHITTypeOfHIT operation allows you to change the HITType properties of a HIT. This operation disassociates the HIT from its old HITType properties and associates it with the new HITType properties. The HIT takes on the properties of the new HITType in place of the old ones.

", - "idempotent":true - }, - "UpdateNotificationSettings":{ - "name":"UpdateNotificationSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNotificationSettingsRequest"}, - "output":{"shape":"UpdateNotificationSettingsResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The UpdateNotificationSettings operation creates, updates, disables or re-enables notifications for a HIT type. If you call the UpdateNotificationSettings operation for a HIT type that already has a notification specification, the operation replaces the old specification with a new one. You can call the UpdateNotificationSettings operation to enable or disable notifications for the HIT type, without having to modify the notification specification itself by providing updates to the Active status without specifying a new notification specification. To change the Active status of a HIT type's notifications, the HIT type must already have a notification specification, or one must be provided in the same call to UpdateNotificationSettings.

", - "idempotent":true - }, - "UpdateQualificationType":{ - "name":"UpdateQualificationType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateQualificationTypeRequest"}, - "output":{"shape":"UpdateQualificationTypeResponse"}, - "errors":[ - {"shape":"ServiceFault"}, - {"shape":"RequestError"} - ], - "documentation":"

The UpdateQualificationType operation modifies the attributes of an existing Qualification type, which is represented by a QualificationType data structure. Only the owner of a Qualification type can modify its attributes.

Most attributes of a Qualification type can be changed after the type has been created. However, the Name and Keywords fields cannot be modified. The RetryDelayInSeconds parameter can be modified or added to change the delay or to enable retries, but RetryDelayInSeconds cannot be used to disable retries.

You can use this operation to update the test for a Qualification type. The test is updated based on the values specified for the Test, TestDurationInSeconds and AnswerKey parameters. All three parameters specify the updated test. If you are updating the test for a type, you must specify the Test and TestDurationInSeconds parameters. The AnswerKey parameter is optional; omitting it specifies that the updated test does not have an answer key.

If you omit the Test parameter, the test for the Qualification type is unchanged. There is no way to remove a test from a Qualification type that has one. If the type already has a test, you cannot update it to be AutoGranted. If the Qualification type does not have a test and one is provided by an update, the type will henceforth have a test.

If you want to update the test duration or answer key for an existing test without changing the questions, you must specify a Test parameter with the original questions, along with the updated values.

If you provide an updated Test but no AnswerKey, the new test will not have an answer key. Requests for such Qualifications must be granted manually.

You can also update the AutoGranted and AutoGrantedValue attributes of the Qualification type.

" - } - }, - "shapes":{ - "AcceptQualificationRequestRequest":{ - "type":"structure", - "required":["QualificationRequestId"], - "members":{ - "QualificationRequestId":{ - "shape":"String", - "documentation":"

The ID of the Qualification request, as returned by the GetQualificationRequests operation.

" - }, - "IntegerValue":{ - "shape":"Integer", - "documentation":"

The value of the Qualification. You can omit this value if you are using the presence or absence of the Qualification as the basis for a HIT requirement.

" - } - } - }, - "AcceptQualificationRequestResponse":{ - "type":"structure", - "members":{ - } - }, - "ApproveAssignmentRequest":{ - "type":"structure", - "required":["AssignmentId"], - "members":{ - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment. The assignment must correspond to a HIT created by the Requester.

" - }, - "RequesterFeedback":{ - "shape":"String", - "documentation":"

A message for the Worker, which the Worker can see in the Status section of the web site.

" - }, - "OverrideRejection":{ - "shape":"Boolean", - "documentation":"

A flag indicating that an assignment should be approved even if it was previously rejected. Defaults to False.

" - } - } - }, - "ApproveAssignmentResponse":{ - "type":"structure", - "members":{ - } - }, - "Assignment":{ - "type":"structure", - "members":{ - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

A unique identifier for the assignment.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker who accepted the HIT.

" - }, - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT.

" - }, - "AssignmentStatus":{ - "shape":"AssignmentStatus", - "documentation":"

The status of the assignment.

" - }, - "AutoApprovalTime":{ - "shape":"Timestamp", - "documentation":"

If results have been submitted, AutoApprovalTime is the date and time the results of the assignment results are considered Approved automatically if they have not already been explicitly approved or rejected by the Requester. This value is derived from the auto-approval delay specified by the Requester in the HIT. This value is omitted from the assignment if the Worker has not yet submitted results.

" - }, - "AcceptTime":{ - "shape":"Timestamp", - "documentation":"

The date and time the Worker accepted the assignment.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

If the Worker has submitted results, SubmitTime is the date and time the assignment was submitted. This value is omitted from the assignment if the Worker has not yet submitted results.

" - }, - "ApprovalTime":{ - "shape":"Timestamp", - "documentation":"

If the Worker has submitted results and the Requester has approved the results, ApprovalTime is the date and time the Requester approved the results. This value is omitted from the assignment if the Requester has not yet approved the results.

" - }, - "RejectionTime":{ - "shape":"Timestamp", - "documentation":"

If the Worker has submitted results and the Requester has rejected the results, RejectionTime is the date and time the Requester rejected the results.

" - }, - "Deadline":{ - "shape":"Timestamp", - "documentation":"

The date and time of the deadline for the assignment. This value is derived from the deadline specification for the HIT and the date and time the Worker accepted the HIT.

" - }, - "Answer":{ - "shape":"String", - "documentation":"

The Worker's answers submitted for the HIT contained in a QuestionFormAnswers document, if the Worker provides an answer. If the Worker does not provide any answers, Answer may contain a QuestionFormAnswers document, or Answer may be empty.

" - }, - "RequesterFeedback":{ - "shape":"String", - "documentation":"

The feedback string included with the call to the ApproveAssignment operation or the RejectAssignment operation, if the Requester approved or rejected the assignment and specified feedback.

" - } - }, - "documentation":"

The Assignment data structure represents a single assignment of a HIT to a Worker. The assignment tracks the Worker's efforts to complete the HIT, and contains the results for later retrieval.

" - }, - "AssignmentList":{ - "type":"list", - "member":{"shape":"Assignment"} - }, - "AssignmentStatus":{ - "type":"string", - "enum":[ - "Submitted", - "Approved", - "Rejected" - ] - }, - "AssignmentStatusList":{ - "type":"list", - "member":{"shape":"AssignmentStatus"} - }, - "AssociateQualificationWithWorkerRequest":{ - "type":"structure", - "required":[ - "QualificationTypeId", - "WorkerId" - ], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type to use for the assigned Qualification.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker to whom the Qualification is being assigned. Worker IDs are included with submitted HIT assignments and Qualification requests.

" - }, - "IntegerValue":{ - "shape":"Integer", - "documentation":"

The value of the Qualification to assign.

" - }, - "SendNotification":{ - "shape":"Boolean", - "documentation":"

Specifies whether to send a notification email message to the Worker saying that the qualification was assigned to the Worker. Note: this is true by default.

" - } - } - }, - "AssociateQualificationWithWorkerResponse":{ - "type":"structure", - "members":{ - } - }, - "BonusPayment":{ - "type":"structure", - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker to whom the bonus was paid.

" - }, - "BonusAmount":{"shape":"CurrencyAmount"}, - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment associated with this bonus payment.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

The Reason text given when the bonus was granted, if any.

" - }, - "GrantTime":{ - "shape":"Timestamp", - "documentation":"

The date and time of when the bonus was granted.

" - } - }, - "documentation":"

An object representing a Bonus payment paid to a Worker.

" - }, - "BonusPaymentList":{ - "type":"list", - "member":{"shape":"BonusPayment"} - }, - "Boolean":{"type":"boolean"}, - "Comparator":{ - "type":"string", - "enum":[ - "LessThan", - "LessThanOrEqualTo", - "GreaterThan", - "GreaterThanOrEqualTo", - "EqualTo", - "NotEqualTo", - "Exists", - "DoesNotExist", - "In", - "NotIn" - ] - }, - "CountryParameters":{ - "type":"string", - "max":2, - "min":2 - }, - "CreateAdditionalAssignmentsForHITRequest":{ - "type":"structure", - "required":[ - "HITId", - "NumberOfAdditionalAssignments" - ], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT to extend.

" - }, - "NumberOfAdditionalAssignments":{ - "shape":"Integer", - "documentation":"

The number of additional assignments to request for this HIT.

" - }, - "UniqueRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier for this request, which allows you to retry the call on error without extending the HIT multiple times. This is useful in cases such as network timeouts where it is unclear whether or not the call succeeded on the server. If the extend HIT already exists in the system from a previous call using the same UniqueRequestToken, subsequent calls will return an error with a message containing the request ID.

" - } - } - }, - "CreateAdditionalAssignmentsForHITResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateHITRequest":{ - "type":"structure", - "required":[ - "LifetimeInSeconds", - "AssignmentDurationInSeconds", - "Reward", - "Title", - "Description" - ], - "members":{ - "MaxAssignments":{ - "shape":"Integer", - "documentation":"

The number of times the HIT can be accepted and completed before the HIT becomes unavailable.

" - }, - "AutoApprovalDelayInSeconds":{ - "shape":"Long", - "documentation":"

The number of seconds after an assignment for the HIT has been submitted, after which the assignment is considered Approved automatically unless the Requester explicitly rejects it.

" - }, - "LifetimeInSeconds":{ - "shape":"Long", - "documentation":"

An amount of time, in seconds, after which the HIT is no longer available for users to accept. After the lifetime of the HIT elapses, the HIT no longer appears in HIT searches, even if not all of the assignments for the HIT have been accepted.

" - }, - "AssignmentDurationInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, that a Worker has to complete the HIT after accepting it. If a Worker does not complete the assignment within the specified duration, the assignment is considered abandoned. If the HIT is still active (that is, its lifetime has not elapsed), the assignment becomes available for other users to find and accept.

" - }, - "Reward":{ - "shape":"CurrencyAmount", - "documentation":"

The amount of money the Requester will pay a Worker for successfully completing the HIT.

" - }, - "Title":{ - "shape":"String", - "documentation":"

The title of the HIT. A title should be short and descriptive about the kind of task the HIT contains. On the Amazon Mechanical Turk web site, the HIT title appears in search results, and everywhere the HIT is mentioned.

" - }, - "Keywords":{ - "shape":"String", - "documentation":"

One or more words or phrases that describe the HIT, separated by commas. These words are used in searches to find HITs.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A general description of the HIT. A description includes detailed information about the kind of task the HIT contains. On the Amazon Mechanical Turk web site, the HIT description appears in the expanded view of search results, and in the HIT and assignment screens. A good description gives the user enough information to evaluate the HIT before accepting it.

" - }, - "Question":{ - "shape":"String", - "documentation":"

The data the person completing the HIT uses to produce the results.

Constraints: Must be a QuestionForm data structure, an ExternalQuestion data structure, or an HTMLQuestion data structure. The XML question data must not be larger than 64 kilobytes (65,535 bytes) in size, including whitespace.

Either a Question parameter or a HITLayoutId parameter must be provided.

" - }, - "RequesterAnnotation":{ - "shape":"String", - "documentation":"

An arbitrary data field. The RequesterAnnotation parameter lets your application attach arbitrary data to the HIT for tracking purposes. For example, this parameter could be an identifier internal to the Requester's application that corresponds with the HIT.

The RequesterAnnotation parameter for a HIT is only visible to the Requester who created the HIT. It is not shown to the Worker, or any other Requester.

The RequesterAnnotation parameter may be different for each HIT you submit. It does not affect how your HITs are grouped.

" - }, - "QualificationRequirements":{ - "shape":"QualificationRequirementList", - "documentation":"

Conditions that a Worker's Qualifications must meet in order to accept the HIT. A HIT can have between zero and ten Qualification requirements. All requirements must be met in order for a Worker to accept the HIT. Additionally, other actions can be restricted using the ActionsGuarded field on each QualificationRequirement structure.

" - }, - "UniqueRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier for this request which allows you to retry the call on error without creating duplicate HITs. This is useful in cases such as network timeouts where it is unclear whether or not the call succeeded on the server. If the HIT already exists in the system from a previous call using the same UniqueRequestToken, subsequent calls will return a AWS.MechanicalTurk.HitAlreadyExists error with a message containing the HITId.

Note: It is your responsibility to ensure uniqueness of the token. The unique token expires after 24 hours. Subsequent calls using the same UniqueRequestToken made after the 24 hour limit could create duplicate HITs.

" - }, - "AssignmentReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The Assignment-level Review Policy applies to the assignments under the HIT. You can specify for Mechanical Turk to take various actions based on the policy.

" - }, - "HITReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The HIT-level Review Policy applies to the HIT. You can specify for Mechanical Turk to take various actions based on the policy.

" - }, - "HITLayoutId":{ - "shape":"EntityId", - "documentation":"

The HITLayoutId allows you to use a pre-existing HIT design with placeholder values and create an additional HIT by providing those values as HITLayoutParameters.

Constraints: Either a Question parameter or a HITLayoutId parameter must be provided.

" - }, - "HITLayoutParameters":{ - "shape":"HITLayoutParameterList", - "documentation":"

If the HITLayoutId is provided, any placeholder values must be filled in with values using the HITLayoutParameter structure. For more information, see HITLayout.

" - } - } - }, - "CreateHITResponse":{ - "type":"structure", - "members":{ - "HIT":{ - "shape":"HIT", - "documentation":"

Contains the newly created HIT data. For a description of the HIT data structure as it appears in responses, see the HIT Data Structure documentation.

" - } - } - }, - "CreateHITTypeRequest":{ - "type":"structure", - "required":[ - "AssignmentDurationInSeconds", - "Reward", - "Title", - "Description" - ], - "members":{ - "AutoApprovalDelayInSeconds":{ - "shape":"Long", - "documentation":"

The number of seconds after an assignment for the HIT has been submitted, after which the assignment is considered Approved automatically unless the Requester explicitly rejects it.

" - }, - "AssignmentDurationInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, that a Worker has to complete the HIT after accepting it. If a Worker does not complete the assignment within the specified duration, the assignment is considered abandoned. If the HIT is still active (that is, its lifetime has not elapsed), the assignment becomes available for other users to find and accept.

" - }, - "Reward":{ - "shape":"CurrencyAmount", - "documentation":"

The amount of money the Requester will pay a Worker for successfully completing the HIT.

" - }, - "Title":{ - "shape":"String", - "documentation":"

The title of the HIT. A title should be short and descriptive about the kind of task the HIT contains. On the Amazon Mechanical Turk web site, the HIT title appears in search results, and everywhere the HIT is mentioned.

" - }, - "Keywords":{ - "shape":"String", - "documentation":"

One or more words or phrases that describe the HIT, separated by commas. These words are used in searches to find HITs.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A general description of the HIT. A description includes detailed information about the kind of task the HIT contains. On the Amazon Mechanical Turk web site, the HIT description appears in the expanded view of search results, and in the HIT and assignment screens. A good description gives the user enough information to evaluate the HIT before accepting it.

" - }, - "QualificationRequirements":{ - "shape":"QualificationRequirementList", - "documentation":"

Conditions that a Worker's Qualifications must meet in order to accept the HIT. A HIT can have between zero and ten Qualification requirements. All requirements must be met in order for a Worker to accept the HIT. Additionally, other actions can be restricted using the ActionsGuarded field on each QualificationRequirement structure.

" - } - } - }, - "CreateHITTypeResponse":{ - "type":"structure", - "members":{ - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the newly registered HIT type.

" - } - } - }, - "CreateHITWithHITTypeRequest":{ - "type":"structure", - "required":[ - "HITTypeId", - "LifetimeInSeconds" - ], - "members":{ - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The HIT type ID you want to create this HIT with.

" - }, - "MaxAssignments":{ - "shape":"Integer", - "documentation":"

The number of times the HIT can be accepted and completed before the HIT becomes unavailable.

" - }, - "LifetimeInSeconds":{ - "shape":"Long", - "documentation":"

An amount of time, in seconds, after which the HIT is no longer available for users to accept. After the lifetime of the HIT elapses, the HIT no longer appears in HIT searches, even if not all of the assignments for the HIT have been accepted.

" - }, - "Question":{ - "shape":"String", - "documentation":"

The data the person completing the HIT uses to produce the results.

Constraints: Must be a QuestionForm data structure, an ExternalQuestion data structure, or an HTMLQuestion data structure. The XML question data must not be larger than 64 kilobytes (65,535 bytes) in size, including whitespace.

Either a Question parameter or a HITLayoutId parameter must be provided.

" - }, - "RequesterAnnotation":{ - "shape":"String", - "documentation":"

An arbitrary data field. The RequesterAnnotation parameter lets your application attach arbitrary data to the HIT for tracking purposes. For example, this parameter could be an identifier internal to the Requester's application that corresponds with the HIT.

The RequesterAnnotation parameter for a HIT is only visible to the Requester who created the HIT. It is not shown to the Worker, or any other Requester.

The RequesterAnnotation parameter may be different for each HIT you submit. It does not affect how your HITs are grouped.

" - }, - "UniqueRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier for this request which allows you to retry the call on error without creating duplicate HITs. This is useful in cases such as network timeouts where it is unclear whether or not the call succeeded on the server. If the HIT already exists in the system from a previous call using the same UniqueRequestToken, subsequent calls will return a AWS.MechanicalTurk.HitAlreadyExists error with a message containing the HITId.

Note: It is your responsibility to ensure uniqueness of the token. The unique token expires after 24 hours. Subsequent calls using the same UniqueRequestToken made after the 24 hour limit could create duplicate HITs.

" - }, - "AssignmentReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The Assignment-level Review Policy applies to the assignments under the HIT. You can specify for Mechanical Turk to take various actions based on the policy.

" - }, - "HITReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The HIT-level Review Policy applies to the HIT. You can specify for Mechanical Turk to take various actions based on the policy.

" - }, - "HITLayoutId":{ - "shape":"EntityId", - "documentation":"

The HITLayoutId allows you to use a pre-existing HIT design with placeholder values and create an additional HIT by providing those values as HITLayoutParameters.

Constraints: Either a Question parameter or a HITLayoutId parameter must be provided.

" - }, - "HITLayoutParameters":{ - "shape":"HITLayoutParameterList", - "documentation":"

If the HITLayoutId is provided, any placeholder values must be filled in with values using the HITLayoutParameter structure. For more information, see HITLayout.

" - } - } - }, - "CreateHITWithHITTypeResponse":{ - "type":"structure", - "members":{ - "HIT":{ - "shape":"HIT", - "documentation":"

Contains the newly created HIT data. For a description of the HIT data structure as it appears in responses, see the HIT Data Structure documentation.

" - } - } - }, - "CreateQualificationTypeRequest":{ - "type":"structure", - "required":[ - "Name", - "Description", - "QualificationTypeStatus" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name you give to the Qualification type. The type name is used to represent the Qualification to Workers, and to find the type using a Qualification type search. It must be unique across all of your Qualification types.

" - }, - "Keywords":{ - "shape":"String", - "documentation":"

One or more words or phrases that describe the Qualification type, separated by commas. The keywords of a type make the type easier to find during a search.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A long description for the Qualification type. On the Amazon Mechanical Turk website, the long description is displayed when a Worker examines a Qualification type.

" - }, - "QualificationTypeStatus":{ - "shape":"QualificationTypeStatus", - "documentation":"

The initial status of the Qualification type.

Constraints: Valid values are: Active | Inactive

" - }, - "RetryDelayInSeconds":{ - "shape":"Long", - "documentation":"

The number of seconds that a Worker must wait after requesting a Qualification of the Qualification type before the worker can retry the Qualification request.

Constraints: None. If not specified, retries are disabled and Workers can request a Qualification of this type only once, even if the Worker has not been granted the Qualification. It is not possible to disable retries for a Qualification type after it has been created with retries enabled. If you want to disable retries, you must delete existing retry-enabled Qualification type and then create a new Qualification type with retries disabled.

" - }, - "Test":{ - "shape":"String", - "documentation":"

The questions for the Qualification test a Worker must answer correctly to obtain a Qualification of this type. If this parameter is specified, TestDurationInSeconds must also be specified.

Constraints: Must not be longer than 65535 bytes. Must be a QuestionForm data structure. This parameter cannot be specified if AutoGranted is true.

Constraints: None. If not specified, the Worker may request the Qualification without answering any questions.

" - }, - "AnswerKey":{ - "shape":"String", - "documentation":"

The answers to the Qualification test specified in the Test parameter, in the form of an AnswerKey data structure.

Constraints: Must not be longer than 65535 bytes.

Constraints: None. If not specified, you must process Qualification requests manually.

" - }, - "TestDurationInSeconds":{ - "shape":"Long", - "documentation":"

The number of seconds the Worker has to complete the Qualification test, starting from the time the Worker requests the Qualification.

" - }, - "AutoGranted":{ - "shape":"Boolean", - "documentation":"

Specifies whether requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test.

Constraints: If the Test parameter is specified, this parameter cannot be true.

" - }, - "AutoGrantedValue":{ - "shape":"Integer", - "documentation":"

The Qualification value to use for automatically granted Qualifications. This parameter is used only if the AutoGranted parameter is true.

" - } - } - }, - "CreateQualificationTypeResponse":{ - "type":"structure", - "members":{ - "QualificationType":{ - "shape":"QualificationType", - "documentation":"

The created Qualification type, returned as a QualificationType data structure.

" - } - } - }, - "CreateWorkerBlockRequest":{ - "type":"structure", - "required":[ - "WorkerId", - "Reason" - ], - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker to block.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A message explaining the reason for blocking the Worker. This parameter enables you to keep track of your Workers. The Worker does not see this message.

" - } - } - }, - "CreateWorkerBlockResponse":{ - "type":"structure", - "members":{ - } - }, - "CurrencyAmount":{ - "type":"string", - "documentation":"

A string representing a currency amount.

", - "pattern":"^[0-9]+(\\.)?[0-9]{0,2}$" - }, - "CustomerId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^A[A-Z0-9]+$" - }, - "CustomerIdList":{ - "type":"list", - "member":{"shape":"CustomerId"} - }, - "DeleteHITRequest":{ - "type":"structure", - "required":["HITId"], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT to be deleted.

" - } - } - }, - "DeleteHITResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteQualificationTypeRequest":{ - "type":"structure", - "required":["QualificationTypeId"], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the QualificationType to dispose.

" - } - } - }, - "DeleteQualificationTypeResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteWorkerBlockRequest":{ - "type":"structure", - "required":["WorkerId"], - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker to unblock.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A message that explains the reason for unblocking the Worker. The Worker does not see this message.

" - } - } - }, - "DeleteWorkerBlockResponse":{ - "type":"structure", - "members":{ - } - }, - "DisassociateQualificationFromWorkerRequest":{ - "type":"structure", - "required":[ - "WorkerId", - "QualificationTypeId" - ], - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker who possesses the Qualification to be revoked.

" - }, - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type of the Qualification to be revoked.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A text message that explains why the Qualification was revoked. The user who had the Qualification sees this message.

" - } - } - }, - "DisassociateQualificationFromWorkerResponse":{ - "type":"structure", - "members":{ - } - }, - "EntityId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[A-Z0-9]+$" - }, - "EventType":{ - "type":"string", - "enum":[ - "AssignmentAccepted", - "AssignmentAbandoned", - "AssignmentReturned", - "AssignmentSubmitted", - "AssignmentRejected", - "AssignmentApproved", - "HITCreated", - "HITExpired", - "HITReviewable", - "HITExtended", - "HITDisposed", - "Ping" - ] - }, - "EventTypeList":{ - "type":"list", - "member":{"shape":"EventType"} - }, - "ExceptionMessage":{"type":"string"}, - "GetAccountBalanceRequest":{ - "type":"structure", - "members":{ - } - }, - "GetAccountBalanceResponse":{ - "type":"structure", - "members":{ - "AvailableBalance":{"shape":"CurrencyAmount"}, - "OnHoldBalance":{"shape":"CurrencyAmount"} - } - }, - "GetAssignmentRequest":{ - "type":"structure", - "required":["AssignmentId"], - "members":{ - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the Assignment to be retrieved.

" - } - } - }, - "GetAssignmentResponse":{ - "type":"structure", - "members":{ - "Assignment":{ - "shape":"Assignment", - "documentation":"

The assignment. The response includes one Assignment element.

" - }, - "HIT":{ - "shape":"HIT", - "documentation":"

The HIT associated with this assignment. The response includes one HIT element.

" - } - } - }, - "GetFileUploadURLRequest":{ - "type":"structure", - "required":[ - "AssignmentId", - "QuestionIdentifier" - ], - "members":{ - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment that contains the question with a FileUploadAnswer.

" - }, - "QuestionIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the question with a FileUploadAnswer, as specified in the QuestionForm of the HIT.

" - } - } - }, - "GetFileUploadURLResponse":{ - "type":"structure", - "members":{ - "FileUploadURL":{ - "shape":"String", - "documentation":"

A temporary URL for the file that the Worker uploaded for the answer.

" - } - } - }, - "GetHITRequest":{ - "type":"structure", - "required":["HITId"], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT to be retrieved.

" - } - } - }, - "GetHITResponse":{ - "type":"structure", - "members":{ - "HIT":{ - "shape":"HIT", - "documentation":"

Contains the requested HIT data.

" - } - } - }, - "GetQualificationScoreRequest":{ - "type":"structure", - "required":[ - "QualificationTypeId", - "WorkerId" - ], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the QualificationType.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker whose Qualification is being updated.

" - } - } - }, - "GetQualificationScoreResponse":{ - "type":"structure", - "members":{ - "Qualification":{ - "shape":"Qualification", - "documentation":"

The Qualification data structure of the Qualification assigned to a user, including the Qualification type and the value (score).

" - } - } - }, - "GetQualificationTypeRequest":{ - "type":"structure", - "required":["QualificationTypeId"], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the QualificationType.

" - } - } - }, - "GetQualificationTypeResponse":{ - "type":"structure", - "members":{ - "QualificationType":{ - "shape":"QualificationType", - "documentation":"

The returned Qualification Type

" - } - } - }, - "HIT":{ - "type":"structure", - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

A unique identifier for the HIT.

" - }, - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT type of this HIT

" - }, - "HITGroupId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT Group of this HIT.

" - }, - "HITLayoutId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT Layout of this HIT.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The date and time the HIT was created.

" - }, - "Title":{ - "shape":"String", - "documentation":"

The title of the HIT.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A general description of the HIT.

" - }, - "Question":{ - "shape":"String", - "documentation":"

The data the Worker completing the HIT uses produce the results. This is either either a QuestionForm, HTMLQuestion or an ExternalQuestion data structure.

" - }, - "Keywords":{ - "shape":"String", - "documentation":"

One or more words or phrases that describe the HIT, separated by commas. Search terms similar to the keywords of a HIT are more likely to have the HIT in the search results.

" - }, - "HITStatus":{ - "shape":"HITStatus", - "documentation":"

The status of the HIT and its assignments. Valid Values are Assignable | Unassignable | Reviewable | Reviewing | Disposed.

" - }, - "MaxAssignments":{ - "shape":"Integer", - "documentation":"

The number of times the HIT can be accepted and completed before the HIT becomes unavailable.

" - }, - "Reward":{"shape":"CurrencyAmount"}, - "AutoApprovalDelayInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, after the Worker submits an assignment for the HIT that the results are automatically approved by Amazon Mechanical Turk. This is the amount of time the Requester has to reject an assignment submitted by a Worker before the assignment is auto-approved and the Worker is paid.

" - }, - "Expiration":{ - "shape":"Timestamp", - "documentation":"

The date and time the HIT expires.

" - }, - "AssignmentDurationInSeconds":{ - "shape":"Long", - "documentation":"

The length of time, in seconds, that a Worker has to complete the HIT after accepting it.

" - }, - "RequesterAnnotation":{ - "shape":"String", - "documentation":"

An arbitrary data field the Requester who created the HIT can use. This field is visible only to the creator of the HIT.

" - }, - "QualificationRequirements":{ - "shape":"QualificationRequirementList", - "documentation":"

Conditions that a Worker's Qualifications must meet in order to accept the HIT. A HIT can have between zero and ten Qualification requirements. All requirements must be met in order for a Worker to accept the HIT. Additionally, other actions can be restricted using the ActionsGuarded field on each QualificationRequirement structure.

" - }, - "HITReviewStatus":{ - "shape":"HITReviewStatus", - "documentation":"

Indicates the review status of the HIT. Valid Values are NotReviewed | MarkedForReview | ReviewedAppropriate | ReviewedInappropriate.

" - }, - "NumberOfAssignmentsPending":{ - "shape":"Integer", - "documentation":"

The number of assignments for this HIT that are being previewed or have been accepted by Workers, but have not yet been submitted, returned, or abandoned.

" - }, - "NumberOfAssignmentsAvailable":{ - "shape":"Integer", - "documentation":"

The number of assignments for this HIT that are available for Workers to accept.

" - }, - "NumberOfAssignmentsCompleted":{ - "shape":"Integer", - "documentation":"

The number of assignments for this HIT that have been approved or rejected.

" - } - }, - "documentation":"

The HIT data structure represents a single HIT, including all the information necessary for a Worker to accept and complete the HIT.

" - }, - "HITAccessActions":{ - "type":"string", - "enum":[ - "Accept", - "PreviewAndAccept", - "DiscoverPreviewAndAccept" - ] - }, - "HITLayoutParameter":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the parameter in the HITLayout.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value substituted for the parameter referenced in the HITLayout.

" - } - }, - "documentation":"

The HITLayoutParameter data structure defines parameter values used with a HITLayout. A HITLayout is a reusable Amazon Mechanical Turk project template used to provide Human Intelligence Task (HIT) question data for CreateHIT.

" - }, - "HITLayoutParameterList":{ - "type":"list", - "member":{"shape":"HITLayoutParameter"} - }, - "HITList":{ - "type":"list", - "member":{"shape":"HIT"} - }, - "HITReviewStatus":{ - "type":"string", - "enum":[ - "NotReviewed", - "MarkedForReview", - "ReviewedAppropriate", - "ReviewedInappropriate" - ] - }, - "HITStatus":{ - "type":"string", - "enum":[ - "Assignable", - "Unassignable", - "Reviewable", - "Reviewing", - "Disposed" - ] - }, - "IdempotencyToken":{ - "type":"string", - "max":64, - "min":1 - }, - "Integer":{"type":"integer"}, - "IntegerList":{ - "type":"list", - "member":{"shape":"Integer"} - }, - "ListAssignmentsForHITRequest":{ - "type":"structure", - "required":["HITId"], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token

" - }, - "MaxResults":{"shape":"ResultSize"}, - "AssignmentStatuses":{ - "shape":"AssignmentStatusList", - "documentation":"

The status of the assignments to return: Submitted | Approved | Rejected

" - } - } - }, - "ListAssignmentsForHITResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of assignments on the page in the filtered results list, equivalent to the number of assignments returned by this call.

" - }, - "Assignments":{ - "shape":"AssignmentList", - "documentation":"

The collection of Assignment data structures returned by this call.

" - } - } - }, - "ListBonusPaymentsRequest":{ - "type":"structure", - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT associated with the bonus payments to retrieve. If not specified, all bonus payments for all assignments for the given HIT are returned. Either the HITId parameter or the AssignmentId parameter must be specified

" - }, - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment associated with the bonus payments to retrieve. If specified, only bonus payments for the given assignment are returned. Either the HITId parameter or the AssignmentId parameter must be specified

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token

" - }, - "MaxResults":{"shape":"ResultSize"} - } - }, - "ListBonusPaymentsResponse":{ - "type":"structure", - "members":{ - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of bonus payments on this page in the filtered results list, equivalent to the number of bonus payments being returned by this call.

" - }, - "NextToken":{"shape":"PaginationToken"}, - "BonusPayments":{ - "shape":"BonusPaymentList", - "documentation":"

A successful request to the ListBonusPayments operation returns a list of BonusPayment objects.

" - } - } - }, - "ListHITsForQualificationTypeRequest":{ - "type":"structure", - "required":["QualificationTypeId"], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type to use when querying HITs.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination Token

" - }, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

Limit the number of results returned.

" - } - } - }, - "ListHITsForQualificationTypeResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of HITs on this page in the filtered results list, equivalent to the number of HITs being returned by this call.

" - }, - "HITs":{ - "shape":"HITList", - "documentation":"

The list of HIT elements returned by the query.

" - } - } - }, - "ListHITsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token

" - }, - "MaxResults":{"shape":"ResultSize"} - } - }, - "ListHITsResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of HITs on this page in the filtered results list, equivalent to the number of HITs being returned by this call.

" - }, - "HITs":{ - "shape":"HITList", - "documentation":"

The list of HIT elements returned by the query.

" - } - } - }, - "ListQualificationRequestsRequest":{ - "type":"structure", - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the QualificationType.

" - }, - "NextToken":{"shape":"PaginationToken"}, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListQualificationRequestsResponse":{ - "type":"structure", - "members":{ - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of Qualification requests on this page in the filtered results list, equivalent to the number of Qualification requests being returned by this call.

" - }, - "NextToken":{"shape":"PaginationToken"}, - "QualificationRequests":{ - "shape":"QualificationRequestList", - "documentation":"

The Qualification request. The response includes one QualificationRequest element for each Qualification request returned by the query.

" - } - } - }, - "ListQualificationTypesRequest":{ - "type":"structure", - "required":["MustBeRequestable"], - "members":{ - "Query":{ - "shape":"String", - "documentation":"

A text query against all of the searchable attributes of Qualification types.

" - }, - "MustBeRequestable":{ - "shape":"Boolean", - "documentation":"

Specifies that only Qualification types that a user can request through the Amazon Mechanical Turk web site, such as by taking a Qualification test, are returned as results of the search. Some Qualification types, such as those assigned automatically by the system, cannot be requested directly by users. If false, all Qualification types, including those managed by the system, are considered. Valid values are True | False.

" - }, - "MustBeOwnedByCaller":{ - "shape":"Boolean", - "documentation":"

Specifies that only Qualification types that the Requester created are returned. If false, the operation returns all Qualification types.

" - }, - "NextToken":{"shape":"PaginationToken"}, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListQualificationTypesResponse":{ - "type":"structure", - "members":{ - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of Qualification types on this page in the filtered results list, equivalent to the number of types this operation returns.

" - }, - "NextToken":{"shape":"PaginationToken"}, - "QualificationTypes":{ - "shape":"QualificationTypeList", - "documentation":"

The list of QualificationType elements returned by the query.

" - } - } - }, - "ListReviewPolicyResultsForHITRequest":{ - "type":"structure", - "required":["HITId"], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The unique identifier of the HIT to retrieve review results for.

" - }, - "PolicyLevels":{ - "shape":"ReviewPolicyLevelList", - "documentation":"

The Policy Level(s) to retrieve review results for - HIT or Assignment. If omitted, the default behavior is to retrieve all data for both policy levels. For a list of all the described policies, see Review Policies.

" - }, - "RetrieveActions":{ - "shape":"Boolean", - "documentation":"

Specify if the operation should retrieve a list of the actions taken executing the Review Policies and their outcomes.

" - }, - "RetrieveResults":{ - "shape":"Boolean", - "documentation":"

Specify if the operation should retrieve a list of the results computed by the Review Policies.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token

" - }, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

Limit the number of results returned.

" - } - } - }, - "ListReviewPolicyResultsForHITResponse":{ - "type":"structure", - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The HITId of the HIT for which results have been returned.

" - }, - "AssignmentReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The name of the Assignment-level Review Policy. This contains only the PolicyName element.

" - }, - "HITReviewPolicy":{ - "shape":"ReviewPolicy", - "documentation":"

The name of the HIT-level Review Policy. This contains only the PolicyName element.

" - }, - "AssignmentReviewReport":{ - "shape":"ReviewReport", - "documentation":"

Contains both ReviewResult and ReviewAction elements for an Assignment.

" - }, - "HITReviewReport":{ - "shape":"ReviewReport", - "documentation":"

Contains both ReviewResult and ReviewAction elements for a particular HIT.

" - }, - "NextToken":{"shape":"PaginationToken"} - } - }, - "ListReviewableHITsRequest":{ - "type":"structure", - "members":{ - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT type of the HITs to consider for the query. If not specified, all HITs for the Reviewer are considered

" - }, - "Status":{ - "shape":"ReviewableHITStatus", - "documentation":"

Can be either Reviewable or Reviewing. Reviewable is the default value.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination Token

" - }, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

Limit the number of results returned.

" - } - } - }, - "ListReviewableHITsResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of HITs on this page in the filtered results list, equivalent to the number of HITs being returned by this call.

" - }, - "HITs":{ - "shape":"HITList", - "documentation":"

The list of HIT elements returned by the query.

" - } - } - }, - "ListWorkerBlocksRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token

" - }, - "MaxResults":{"shape":"ResultSize"} - } - }, - "ListWorkerBlocksResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of assignments on the page in the filtered results list, equivalent to the number of assignments returned by this call.

" - }, - "WorkerBlocks":{ - "shape":"WorkerBlockList", - "documentation":"

The list of WorkerBlocks, containing the collection of Worker IDs and reasons for blocking.

" - } - } - }, - "ListWorkersWithQualificationTypeRequest":{ - "type":"structure", - "required":["QualificationTypeId"], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type of the Qualifications to return.

" - }, - "Status":{ - "shape":"QualificationStatus", - "documentation":"

The status of the Qualifications to return. Can be Granted | Revoked.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination Token

" - }, - "MaxResults":{ - "shape":"ResultSize", - "documentation":"

Limit the number of results returned.

" - } - } - }, - "ListWorkersWithQualificationTypeResponse":{ - "type":"structure", - "members":{ - "NextToken":{"shape":"PaginationToken"}, - "NumResults":{ - "shape":"Integer", - "documentation":"

The number of Qualifications on this page in the filtered results list, equivalent to the number of Qualifications being returned by this call.

" - }, - "Qualifications":{ - "shape":"QualificationList", - "documentation":"

The list of Qualification elements returned by this call.

" - } - } - }, - "Locale":{ - "type":"structure", - "required":["Country"], - "members":{ - "Country":{ - "shape":"CountryParameters", - "documentation":"

The country of the locale. Must be a valid ISO 3166 country code. For example, the code US refers to the United States of America.

" - }, - "Subdivision":{ - "shape":"CountryParameters", - "documentation":"

The state or subdivision of the locale. A valid ISO 3166-2 subdivision code. For example, the code WA refers to the state of Washington.

" - } - }, - "documentation":"

The Locale data structure represents a geographical region or location.

" - }, - "LocaleList":{ - "type":"list", - "member":{"shape":"Locale"} - }, - "Long":{"type":"long"}, - "NotificationSpecification":{ - "type":"structure", - "required":[ - "Destination", - "Transport", - "Version", - "EventTypes" - ], - "members":{ - "Destination":{ - "shape":"String", - "documentation":"

The target for notification messages. The Destination’s format is determined by the specified Transport:

  • When Transport is Email, the Destination is your email address.

  • When Transport is SQS, the Destination is your queue URL.

  • When Transport is SNS, the Destination is the ARN of your topic.

" - }, - "Transport":{ - "shape":"NotificationTransport", - "documentation":"

The method Amazon Mechanical Turk uses to send the notification. Valid Values: Email | SQS | SNS.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The version of the Notification API to use. Valid value is 2006-05-05.

" - }, - "EventTypes":{ - "shape":"EventTypeList", - "documentation":"

The list of events that should cause notifications to be sent. Valid Values: AssignmentAccepted | AssignmentAbandoned | AssignmentReturned | AssignmentSubmitted | AssignmentRejected | AssignmentApproved | HITCreated | HITExtended | HITDisposed | HITReviewable | HITExpired | Ping. The Ping event is only valid for the SendTestEventNotification operation.

" - } - }, - "documentation":"

The NotificationSpecification data structure describes a HIT event notification for a HIT type.

" - }, - "NotificationTransport":{ - "type":"string", - "enum":[ - "Email", - "SQS", - "SNS" - ] - }, - "NotifyWorkersFailureCode":{ - "type":"string", - "enum":[ - "SoftFailure", - "HardFailure" - ] - }, - "NotifyWorkersFailureStatus":{ - "type":"structure", - "members":{ - "NotifyWorkersFailureCode":{ - "shape":"NotifyWorkersFailureCode", - "documentation":"

Encoded value for the failure type.

" - }, - "NotifyWorkersFailureMessage":{ - "shape":"String", - "documentation":"

A message detailing the reason the Worker could not be notified.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker.

" - } - }, - "documentation":"

When MTurk encounters an issue with notifying the Workers you specified, it returns back this object with failure details.

" - }, - "NotifyWorkersFailureStatusList":{ - "type":"list", - "member":{"shape":"NotifyWorkersFailureStatus"} - }, - "NotifyWorkersRequest":{ - "type":"structure", - "required":[ - "Subject", - "MessageText", - "WorkerIds" - ], - "members":{ - "Subject":{ - "shape":"String", - "documentation":"

The subject line of the email message to send. Can include up to 200 characters.

" - }, - "MessageText":{ - "shape":"String", - "documentation":"

The text of the email message to send. Can include up to 4,096 characters

" - }, - "WorkerIds":{ - "shape":"CustomerIdList", - "documentation":"

A list of Worker IDs you wish to notify. You can notify upto 100 Workers at a time.

" - } - } - }, - "NotifyWorkersResponse":{ - "type":"structure", - "members":{ - "NotifyWorkersFailureStatuses":{ - "shape":"NotifyWorkersFailureStatusList", - "documentation":"

When MTurk sends notifications to the list of Workers, it returns back any failures it encounters in this list of NotifyWorkersFailureStatus objects.

" - } - } - }, - "PaginationToken":{ - "type":"string", - "documentation":"

If the previous response was incomplete (because there is more data to retrieve), Amazon Mechanical Turk returns a pagination token in the response. You can use this pagination token to retrieve the next set of results.

", - "max":255, - "min":1 - }, - "ParameterMapEntry":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The QuestionID from the HIT that is used to identify which question requires Mechanical Turk to score as part of the ScoreMyKnownAnswers/2011-09-01 Review Policy.

" - }, - "Values":{ - "shape":"StringList", - "documentation":"

The list of answers to the question specified in the MapEntry Key element. The Worker must match all values in order for the answer to be scored correctly.

" - } - }, - "documentation":"

This data structure is the data type for the AnswerKey parameter of the ScoreMyKnownAnswers/2011-09-01 Review Policy.

" - }, - "ParameterMapEntryList":{ - "type":"list", - "member":{"shape":"ParameterMapEntry"} - }, - "PolicyParameter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

Name of the parameter from the list of Review Polices.

" - }, - "Values":{ - "shape":"StringList", - "documentation":"

The list of values of the Parameter

" - }, - "MapEntries":{ - "shape":"ParameterMapEntryList", - "documentation":"

List of ParameterMapEntry objects.

" - } - }, - "documentation":"

Name of the parameter from the Review policy.

" - }, - "PolicyParameterList":{ - "type":"list", - "member":{"shape":"PolicyParameter"} - }, - "Qualification":{ - "type":"structure", - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type for the Qualification.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker who possesses the Qualification.

" - }, - "GrantTime":{ - "shape":"Timestamp", - "documentation":"

The date and time the Qualification was granted to the Worker. If the Worker's Qualification was revoked, and then re-granted based on a new Qualification request, GrantTime is the date and time of the last call to the AcceptQualificationRequest operation.

" - }, - "IntegerValue":{ - "shape":"Integer", - "documentation":"

The value (score) of the Qualification, if the Qualification has an integer value.

" - }, - "LocaleValue":{"shape":"Locale"}, - "Status":{ - "shape":"QualificationStatus", - "documentation":"

The status of the Qualification. Valid values are Granted | Revoked.

" - } - }, - "documentation":"

The Qualification data structure represents a Qualification assigned to a user, including the Qualification type and the value (score).

" - }, - "QualificationList":{ - "type":"list", - "member":{"shape":"Qualification"} - }, - "QualificationRequest":{ - "type":"structure", - "members":{ - "QualificationRequestId":{ - "shape":"String", - "documentation":"

The ID of the Qualification request, a unique identifier generated when the request was submitted.

" - }, - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type the Worker is requesting, as returned by the CreateQualificationType operation.

" - }, - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker requesting the Qualification.

" - }, - "Test":{ - "shape":"String", - "documentation":"

The contents of the Qualification test that was presented to the Worker, if the type has a test and the Worker has submitted answers. This value is identical to the QuestionForm associated with the Qualification type at the time the Worker requests the Qualification.

" - }, - "Answer":{ - "shape":"String", - "documentation":"

The Worker's answers for the Qualification type's test contained in a QuestionFormAnswers document, if the type has a test and the Worker has submitted answers. If the Worker does not provide any answers, Answer may be empty.

" - }, - "SubmitTime":{ - "shape":"Timestamp", - "documentation":"

The date and time the Qualification request had a status of Submitted. This is either the time the Worker submitted answers for a Qualification test, or the time the Worker requested the Qualification if the Qualification type does not have a test.

" - } - }, - "documentation":"

The QualificationRequest data structure represents a request a Worker has made for a Qualification.

" - }, - "QualificationRequestList":{ - "type":"list", - "member":{"shape":"QualificationRequest"} - }, - "QualificationRequirement":{ - "type":"structure", - "required":[ - "QualificationTypeId", - "Comparator" - ], - "members":{ - "QualificationTypeId":{ - "shape":"String", - "documentation":"

The ID of the Qualification type for the requirement.

" - }, - "Comparator":{ - "shape":"Comparator", - "documentation":"

The kind of comparison to make against a Qualification's value. You can compare a Qualification's value to an IntegerValue to see if it is LessThan, LessThanOrEqualTo, GreaterThan, GreaterThanOrEqualTo, EqualTo, or NotEqualTo the IntegerValue. You can compare it to a LocaleValue to see if it is EqualTo, or NotEqualTo the LocaleValue. You can check to see if the value is In or NotIn a set of IntegerValue or LocaleValue values. Lastly, a Qualification requirement can also test if a Qualification Exists or DoesNotExist in the user's profile, regardless of its value.

" - }, - "IntegerValues":{ - "shape":"IntegerList", - "documentation":"

The integer value to compare against the Qualification's value. IntegerValue must not be present if Comparator is Exists or DoesNotExist. IntegerValue can only be used if the Qualification type has an integer value; it cannot be used with the Worker_Locale QualificationType ID. When performing a set comparison by using the In or the NotIn comparator, you can use up to 15 IntegerValue elements in a QualificationRequirement data structure.

" - }, - "LocaleValues":{ - "shape":"LocaleList", - "documentation":"

The locale value to compare against the Qualification's value. The local value must be a valid ISO 3166 country code or supports ISO 3166-2 subdivisions. LocaleValue can only be used with a Worker_Locale QualificationType ID. LocaleValue can only be used with the EqualTo, NotEqualTo, In, and NotIn comparators. You must only use a single LocaleValue element when using the EqualTo or NotEqualTo comparators. When performing a set comparison by using the In or the NotIn comparator, you can use up to 30 LocaleValue elements in a QualificationRequirement data structure.

" - }, - "RequiredToPreview":{ - "shape":"Boolean", - "documentation":"

DEPRECATED: Use the ActionsGuarded field instead. If RequiredToPreview is true, the question data for the HIT will not be shown when a Worker whose Qualifications do not meet this requirement tries to preview the HIT. That is, a Worker's Qualifications must meet all of the requirements for which RequiredToPreview is true in order to preview the HIT. If a Worker meets all of the requirements where RequiredToPreview is true (or if there are no such requirements), but does not meet all of the requirements for the HIT, the Worker will be allowed to preview the HIT's question data, but will not be allowed to accept and complete the HIT. The default is false. This should not be used in combination with the ActionsGuarded field.

", - "deprecated":true - }, - "ActionsGuarded":{ - "shape":"HITAccessActions", - "documentation":"

Setting this attribute prevents Workers whose Qualifications do not meet this QualificationRequirement from taking the specified action. Valid arguments include \"Accept\" (Worker cannot accept the HIT, but can preview the HIT and see it in their search results), \"PreviewAndAccept\" (Worker cannot accept or preview the HIT, but can see the HIT in their search results), and \"DiscoverPreviewAndAccept\" (Worker cannot accept, preview, or see the HIT in their search results). It's possible for you to create a HIT with multiple QualificationRequirements (which can have different values for the ActionGuarded attribute). In this case, the Worker is only permitted to perform an action when they have met all QualificationRequirements guarding the action. The actions in the order of least restrictive to most restrictive are Discover, Preview and Accept. For example, if a Worker meets all QualificationRequirements that are set to DiscoverPreviewAndAccept, but do not meet all requirements that are set with PreviewAndAccept, then the Worker will be able to Discover, i.e. see the HIT in their search result, but will not be able to Preview or Accept the HIT. ActionsGuarded should not be used in combination with the RequiredToPreview field.

" - } - }, - "documentation":"

The QualificationRequirement data structure describes a Qualification that a Worker must have before the Worker is allowed to accept a HIT. A requirement may optionally state that a Worker must have the Qualification in order to preview the HIT, or see the HIT in search results.

" - }, - "QualificationRequirementList":{ - "type":"list", - "member":{"shape":"QualificationRequirement"} - }, - "QualificationStatus":{ - "type":"string", - "enum":[ - "Granted", - "Revoked" - ] - }, - "QualificationType":{ - "type":"structure", - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

A unique identifier for the Qualification type. A Qualification type is given a Qualification type ID when you call the CreateQualificationType operation.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The date and time the Qualification type was created.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the Qualification type. The type name is used to identify the type, and to find the type using a Qualification type search.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A long description for the Qualification type.

" - }, - "Keywords":{ - "shape":"String", - "documentation":"

One or more words or phrases that describe theQualification type, separated by commas. The Keywords make the type easier to find using a search.

" - }, - "QualificationTypeStatus":{ - "shape":"QualificationTypeStatus", - "documentation":"

The status of the Qualification type. A Qualification type's status determines if users can apply to receive a Qualification of this type, and if HITs can be created with requirements based on this type. Valid values are Active | Inactive.

" - }, - "Test":{ - "shape":"String", - "documentation":"

The questions for a Qualification test associated with this Qualification type that a user can take to obtain a Qualification of this type. This parameter must be specified if AnswerKey is present. A Qualification type cannot have both a specified Test parameter and an AutoGranted value of true.

" - }, - "TestDurationInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, given to a Worker to complete the Qualification test, beginning from the time the Worker requests the Qualification.

" - }, - "AnswerKey":{ - "shape":"String", - "documentation":"

The answers to the Qualification test specified in the Test parameter.

" - }, - "RetryDelayInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, Workers must wait after taking the Qualification test before they can take it again. Workers can take a Qualification test multiple times if they were not granted the Qualification from a previous attempt, or if the test offers a gradient score and they want a better score. If not specified, retries are disabled and Workers can request a Qualification only once.

" - }, - "IsRequestable":{ - "shape":"Boolean", - "documentation":"

Specifies whether the Qualification type is one that a user can request through the Amazon Mechanical Turk web site, such as by taking a Qualification test. This value is False for Qualifications assigned automatically by the system. Valid values are True | False.

" - }, - "AutoGranted":{ - "shape":"Boolean", - "documentation":"

Specifies that requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test. Valid values are True | False.

" - }, - "AutoGrantedValue":{ - "shape":"Integer", - "documentation":"

The Qualification integer value to use for automatically granted Qualifications, if AutoGranted is true. This is 1 by default.

" - } - }, - "documentation":"

The QualificationType data structure represents a Qualification type, a description of a property of a Worker that must match the requirements of a HIT for the Worker to be able to accept the HIT. The type also describes how a Worker can obtain a Qualification of that type, such as through a Qualification test.

" - }, - "QualificationTypeList":{ - "type":"list", - "member":{"shape":"QualificationType"} - }, - "QualificationTypeStatus":{ - "type":"string", - "enum":[ - "Active", - "Inactive" - ] - }, - "RejectAssignmentRequest":{ - "type":"structure", - "required":[ - "AssignmentId", - "RequesterFeedback" - ], - "members":{ - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment. The assignment must correspond to a HIT created by the Requester.

" - }, - "RequesterFeedback":{ - "shape":"String", - "documentation":"

A message for the Worker, which the Worker can see in the Status section of the web site.

" - } - } - }, - "RejectAssignmentResponse":{ - "type":"structure", - "members":{ - } - }, - "RejectQualificationRequestRequest":{ - "type":"structure", - "required":["QualificationRequestId"], - "members":{ - "QualificationRequestId":{ - "shape":"String", - "documentation":"

The ID of the Qualification request, as returned by the ListQualificationRequests operation.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A text message explaining why the request was rejected, to be shown to the Worker who made the request.

" - } - } - }, - "RejectQualificationRequestResponse":{ - "type":"structure", - "members":{ - } - }, - "RequestError":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "TurkErrorCode":{"shape":"TurkErrorCode"} - }, - "documentation":"

Your request is invalid.

", - "exception":true - }, - "ResultSize":{ - "type":"integer", - "max":100, - "min":1 - }, - "ReviewActionDetail":{ - "type":"structure", - "members":{ - "ActionId":{ - "shape":"EntityId", - "documentation":"

The unique identifier for the action.

" - }, - "ActionName":{ - "shape":"String", - "documentation":"

The nature of the action itself. The Review Policy is responsible for examining the HIT and Assignments, emitting results, and deciding which other actions will be necessary.

" - }, - "TargetId":{ - "shape":"EntityId", - "documentation":"

The specific HITId or AssignmentID targeted by the action.

" - }, - "TargetType":{ - "shape":"String", - "documentation":"

The type of object in TargetId.

" - }, - "Status":{ - "shape":"ReviewActionStatus", - "documentation":"

The current disposition of the action: INTENDED, SUCCEEDED, FAILED, or CANCELLED.

" - }, - "CompleteTime":{ - "shape":"Timestamp", - "documentation":"

The date when the action was completed.

" - }, - "Result":{ - "shape":"String", - "documentation":"

A description of the outcome of the review.

" - }, - "ErrorCode":{ - "shape":"String", - "documentation":"

Present only when the Results have a FAILED Status.

" - } - }, - "documentation":"

Both the AssignmentReviewReport and the HITReviewReport elements contains the ReviewActionDetail data structure. This structure is returned multiple times for each action specified in the Review Policy.

" - }, - "ReviewActionDetailList":{ - "type":"list", - "member":{"shape":"ReviewActionDetail"} - }, - "ReviewActionStatus":{ - "type":"string", - "enum":[ - "Intended", - "Succeeded", - "Failed", - "Cancelled" - ] - }, - "ReviewPolicy":{ - "type":"structure", - "required":["PolicyName"], - "members":{ - "PolicyName":{ - "shape":"String", - "documentation":"

Name of a Review Policy: SimplePlurality/2011-09-01 or ScoreMyKnownAnswers/2011-09-01

" - }, - "Parameters":{ - "shape":"PolicyParameterList", - "documentation":"

Name of the parameter from the Review policy.

" - } - }, - "documentation":"

HIT Review Policy data structures represent HIT review policies, which you specify when you create a HIT.

" - }, - "ReviewPolicyLevel":{ - "type":"string", - "enum":[ - "Assignment", - "HIT" - ] - }, - "ReviewPolicyLevelList":{ - "type":"list", - "member":{"shape":"ReviewPolicyLevel"} - }, - "ReviewReport":{ - "type":"structure", - "members":{ - "ReviewResults":{ - "shape":"ReviewResultDetailList", - "documentation":"

A list of ReviewResults objects for each action specified in the Review Policy.

" - }, - "ReviewActions":{ - "shape":"ReviewActionDetailList", - "documentation":"

A list of ReviewAction objects for each action specified in the Review Policy.

" - } - }, - "documentation":"

Contains both ReviewResult and ReviewAction elements for a particular HIT.

" - }, - "ReviewResultDetail":{ - "type":"structure", - "members":{ - "ActionId":{ - "shape":"EntityId", - "documentation":"

A unique identifier of the Review action result.

" - }, - "SubjectId":{ - "shape":"EntityId", - "documentation":"

The HITID or AssignmentId about which this result was taken. Note that HIT-level Review Policies will often emit results about both the HIT itself and its Assignments, while Assignment-level review policies generally only emit results about the Assignment itself.

" - }, - "SubjectType":{ - "shape":"String", - "documentation":"

The type of the object from the SubjectId field.

" - }, - "QuestionId":{ - "shape":"EntityId", - "documentation":"

Specifies the QuestionId the result is describing. Depending on whether the TargetType is a HIT or Assignment this results could specify multiple values. If TargetType is HIT and QuestionId is absent, then the result describes results of the HIT, including the HIT agreement score. If ObjectType is Assignment and QuestionId is absent, then the result describes the Worker's performance on the HIT.

" - }, - "Key":{ - "shape":"String", - "documentation":"

Key identifies the particular piece of reviewed information.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The values of Key provided by the review policies you have selected.

" - } - }, - "documentation":"

This data structure is returned multiple times for each result specified in the Review Policy.

" - }, - "ReviewResultDetailList":{ - "type":"list", - "member":{"shape":"ReviewResultDetail"} - }, - "ReviewableHITStatus":{ - "type":"string", - "enum":[ - "Reviewable", - "Reviewing" - ] - }, - "SendBonusRequest":{ - "type":"structure", - "required":[ - "WorkerId", - "BonusAmount", - "AssignmentId", - "Reason" - ], - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker being paid the bonus.

" - }, - "BonusAmount":{ - "shape":"CurrencyAmount", - "documentation":"

The Bonus amount is a US Dollar amount specified using a string (for example, \"5\" represents $5.00 USD and \"101.42\" represents $101.42 USD). Do not include currency symbols or currency codes.

" - }, - "AssignmentId":{ - "shape":"EntityId", - "documentation":"

The ID of the assignment for which this bonus is paid.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A message that explains the reason for the bonus payment. The Worker receiving the bonus can see this message.

" - }, - "UniqueRequestToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier for this request, which allows you to retry the call on error without granting multiple bonuses. This is useful in cases such as network timeouts where it is unclear whether or not the call succeeded on the server. If the bonus already exists in the system from a previous call using the same UniqueRequestToken, subsequent calls will return an error with a message containing the request ID.

" - } - } - }, - "SendBonusResponse":{ - "type":"structure", - "members":{ - } - }, - "SendTestEventNotificationRequest":{ - "type":"structure", - "required":[ - "Notification", - "TestEventType" - ], - "members":{ - "Notification":{ - "shape":"NotificationSpecification", - "documentation":"

The notification specification to test. This value is identical to the value you would provide to the UpdateNotificationSettings operation when you establish the notification specification for a HIT type.

" - }, - "TestEventType":{ - "shape":"EventType", - "documentation":"

The event to simulate to test the notification specification. This event is included in the test message even if the notification specification does not include the event type. The notification specification does not filter out the test event.

" - } - } - }, - "SendTestEventNotificationResponse":{ - "type":"structure", - "members":{ - } - }, - "ServiceFault":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "TurkErrorCode":{"shape":"TurkErrorCode"} - }, - "documentation":"

Amazon Mechanical Turk is temporarily unable to process your request. Try your call again.

", - "exception":true, - "fault":true - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Timestamp":{"type":"timestamp"}, - "TurkErrorCode":{"type":"string"}, - "UpdateExpirationForHITRequest":{ - "type":"structure", - "required":[ - "HITId", - "ExpireAt" - ], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The HIT to update.

" - }, - "ExpireAt":{ - "shape":"Timestamp", - "documentation":"

The date and time at which you want the HIT to expire

" - } - } - }, - "UpdateExpirationForHITResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateHITReviewStatusRequest":{ - "type":"structure", - "required":["HITId"], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT to update.

" - }, - "Revert":{ - "shape":"Boolean", - "documentation":"

Specifies how to update the HIT status. Default is False.

  • Setting this to false will only transition a HIT from Reviewable to Reviewing

  • Setting this to true will only transition a HIT from Reviewing to Reviewable

" - } - } - }, - "UpdateHITReviewStatusResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateHITTypeOfHITRequest":{ - "type":"structure", - "required":[ - "HITId", - "HITTypeId" - ], - "members":{ - "HITId":{ - "shape":"EntityId", - "documentation":"

The HIT to update.

" - }, - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the new HIT type.

" - } - } - }, - "UpdateHITTypeOfHITResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateNotificationSettingsRequest":{ - "type":"structure", - "required":["HITTypeId"], - "members":{ - "HITTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the HIT type whose notification specification is being updated.

" - }, - "Notification":{ - "shape":"NotificationSpecification", - "documentation":"

The notification specification for the HIT type.

" - }, - "Active":{ - "shape":"Boolean", - "documentation":"

Specifies whether notifications are sent for HITs of this HIT type, according to the notification specification. You must specify either the Notification parameter or the Active parameter for the call to UpdateNotificationSettings to succeed.

" - } - } - }, - "UpdateNotificationSettingsResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateQualificationTypeRequest":{ - "type":"structure", - "required":["QualificationTypeId"], - "members":{ - "QualificationTypeId":{ - "shape":"EntityId", - "documentation":"

The ID of the Qualification type to update.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The new description of the Qualification type.

" - }, - "QualificationTypeStatus":{ - "shape":"QualificationTypeStatus", - "documentation":"

The new status of the Qualification type - Active | Inactive

" - }, - "Test":{ - "shape":"String", - "documentation":"

The questions for the Qualification test a Worker must answer correctly to obtain a Qualification of this type. If this parameter is specified, TestDurationInSeconds must also be specified.

Constraints: Must not be longer than 65535 bytes. Must be a QuestionForm data structure. This parameter cannot be specified if AutoGranted is true.

Constraints: None. If not specified, the Worker may request the Qualification without answering any questions.

" - }, - "AnswerKey":{ - "shape":"String", - "documentation":"

The answers to the Qualification test specified in the Test parameter, in the form of an AnswerKey data structure.

" - }, - "TestDurationInSeconds":{ - "shape":"Long", - "documentation":"

The number of seconds the Worker has to complete the Qualification test, starting from the time the Worker requests the Qualification.

" - }, - "RetryDelayInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time, in seconds, that Workers must wait after requesting a Qualification of the specified Qualification type before they can retry the Qualification request. It is not possible to disable retries for a Qualification type after it has been created with retries enabled. If you want to disable retries, you must dispose of the existing retry-enabled Qualification type using DisposeQualificationType and then create a new Qualification type with retries disabled using CreateQualificationType.

" - }, - "AutoGranted":{ - "shape":"Boolean", - "documentation":"

Specifies whether requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test.

Constraints: If the Test parameter is specified, this parameter cannot be true.

" - }, - "AutoGrantedValue":{ - "shape":"Integer", - "documentation":"

The Qualification value to use for automatically granted Qualifications. This parameter is used only if the AutoGranted parameter is true.

" - } - } - }, - "UpdateQualificationTypeResponse":{ - "type":"structure", - "members":{ - "QualificationType":{ - "shape":"QualificationType", - "documentation":"

Contains a QualificationType data structure.

" - } - } - }, - "WorkerBlock":{ - "type":"structure", - "members":{ - "WorkerId":{ - "shape":"CustomerId", - "documentation":"

The ID of the Worker who accepted the HIT.

" - }, - "Reason":{ - "shape":"String", - "documentation":"

A message explaining the reason the Worker was blocked.

" - } - }, - "documentation":"

The WorkerBlock data structure represents a Worker who has been blocked. It has two elements: the WorkerId and the Reason for the block.

" - }, - "WorkerBlockList":{ - "type":"list", - "member":{"shape":"WorkerBlock"} - } - }, - "documentation":"Amazon Mechanical Turk API Reference" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/paginators-1.json deleted file mode 100644 index f1a247f7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/paginators-1.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "pagination": { - "DescribeDBEngineVersions": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "DBEngineVersions" - }, - "DescribeDBInstances": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "DBInstances" - }, - "DescribeDBParameterGroups": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "DBParameterGroups" - }, - "DescribeDBParameters": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "Parameters" - }, - "DescribeDBSubnetGroups": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "DBSubnetGroups" - }, - "DescribeEngineDefaultParameters": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "EngineDefaults.Marker", - "result_key": "EngineDefaults.Parameters" - }, - "DescribeEventSubscriptions": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "EventSubscriptionsList" - }, - "DescribeEvents": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "Events" - }, - "DescribeOrderableDBInstanceOptions": { - "input_token": "Marker", - "limit_key": "MaxRecords", - "output_token": "Marker", - "result_key": "OrderableDBInstanceOptions" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/service-2.json deleted file mode 100644 index bb7d1563..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/service-2.json +++ /dev/null @@ -1,5513 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-10-31", - "endpointPrefix":"rds", - "protocol":"query", - "serviceAbbreviation":"Amazon Neptune", - "serviceFullName":"Amazon Neptune", - "serviceId":"Neptune", - "signatureVersion":"v4", - "signingName":"rds", - "uid":"neptune-2014-10-31", - "xmlNamespace":"http://rds.amazonaws.com/doc/2014-10-31/" - }, - "operations":{ - "AddRoleToDBCluster":{ - "name":"AddRoleToDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddRoleToDBClusterMessage"}, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterRoleAlreadyExistsFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterRoleQuotaExceededFault"} - ], - "documentation":"

Associates an Identity and Access Management (IAM) role from an Neptune DB cluster.

" - }, - "AddSourceIdentifierToSubscription":{ - "name":"AddSourceIdentifierToSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddSourceIdentifierToSubscriptionMessage"}, - "output":{ - "shape":"AddSourceIdentifierToSubscriptionResult", - "resultWrapper":"AddSourceIdentifierToSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Adds a source identifier to an existing event notification subscription.

" - }, - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceMessage"}, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Adds metadata tags to an Amazon Neptune resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon Neptune resources, or used in a Condition statement in an IAM policy for Amazon Neptune.

" - }, - "ApplyPendingMaintenanceAction":{ - "name":"ApplyPendingMaintenanceAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ApplyPendingMaintenanceActionMessage"}, - "output":{ - "shape":"ApplyPendingMaintenanceActionResult", - "resultWrapper":"ApplyPendingMaintenanceActionResult" - }, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Applies a pending maintenance action to a resource (for example, to a DB instance).

" - }, - "CopyDBClusterParameterGroup":{ - "name":"CopyDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBClusterParameterGroupMessage"}, - "output":{ - "shape":"CopyDBClusterParameterGroupResult", - "resultWrapper":"CopyDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Copies the specified DB cluster parameter group.

" - }, - "CopyDBClusterSnapshot":{ - "name":"CopyDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBClusterSnapshotMessage"}, - "output":{ - "shape":"CopyDBClusterSnapshotResult", - "resultWrapper":"CopyDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Copies a snapshot of a DB cluster.

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.

You can copy an encrypted DB cluster snapshot from another AWS Region. In that case, the AWS Region where you call the CopyDBClusterSnapshot action is the destination AWS Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another AWS Region, you must provide the following values:

  • KmsKeyId - The AWS Key Management System (AWS KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region.

  • PreSignedUrl - A URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot action to be called in the source AWS Region where the DB cluster snapshot is copied from. The pre-signed URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied.

    The pre-signed URL request must contain the following parameter values:

    • KmsKeyId - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

    • DestinationRegion - The name of the AWS Region that the DB cluster snapshot will be created in.

    • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:neptune-cluster1-snapshot-20161115.

    To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

  • TargetDBClusterSnapshotIdentifier - The identifier for the new copy of the DB cluster snapshot in the destination AWS Region.

  • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source AWS Region and is the same value as the SourceDBClusterSnapshotIdentifier in the pre-signed URL.

To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot is in \"copying\" status.

" - }, - "CopyDBParameterGroup":{ - "name":"CopyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBParameterGroupMessage"}, - "output":{ - "shape":"CopyDBParameterGroupResult", - "resultWrapper":"CopyDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"}, - {"shape":"DBParameterGroupQuotaExceededFault"} - ], - "documentation":"

Copies the specified DB parameter group.

" - }, - "CreateDBCluster":{ - "name":"CreateDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterMessage"}, - "output":{ - "shape":"CreateDBClusterResult", - "resultWrapper":"CreateDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"} - ], - "documentation":"

Creates a new Amazon Neptune DB cluster.

You can use the ReplicationSourceIdentifier parameter to create the DB cluster as a Read Replica of another DB cluster or Amazon Neptune DB instance. For cross-region replication where the DB cluster identified by ReplicationSourceIdentifier is encrypted, you must also specify the PreSignedUrl parameter.

" - }, - "CreateDBClusterParameterGroup":{ - "name":"CreateDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterParameterGroupMessage"}, - "output":{ - "shape":"CreateDBClusterParameterGroupResult", - "resultWrapper":"CreateDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Creates a new DB cluster parameter group.

Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.

A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBClusterParameterGroup. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster using ModifyDBCluster. When you associate a new DB cluster parameter group with a running DB cluster, you need to reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

" - }, - "CreateDBClusterSnapshot":{ - "name":"CreateDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterSnapshotMessage"}, - "output":{ - "shape":"CreateDBClusterSnapshotResult", - "resultWrapper":"CreateDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"} - ], - "documentation":"

Creates a snapshot of a DB cluster.

" - }, - "CreateDBInstance":{ - "name":"CreateDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBInstanceMessage"}, - "output":{ - "shape":"CreateDBInstanceResult", - "resultWrapper":"CreateDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DomainNotFoundFault"} - ], - "documentation":"

Creates a new DB instance.

" - }, - "CreateDBParameterGroup":{ - "name":"CreateDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBParameterGroupMessage"}, - "output":{ - "shape":"CreateDBParameterGroupResult", - "resultWrapper":"CreateDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Creates a new DB parameter group.

A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.

After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "CreateDBSubnetGroup":{ - "name":"CreateDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBSubnetGroupMessage"}, - "output":{ - "shape":"CreateDBSubnetGroupResult", - "resultWrapper":"CreateDBSubnetGroupResult" - }, - "errors":[ - {"shape":"DBSubnetGroupAlreadyExistsFault"}, - {"shape":"DBSubnetGroupQuotaExceededFault"}, - {"shape":"DBSubnetQuotaExceededFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

" - }, - "CreateEventSubscription":{ - "name":"CreateEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEventSubscriptionMessage"}, - "output":{ - "shape":"CreateEventSubscriptionResult", - "resultWrapper":"CreateEventSubscriptionResult" - }, - "errors":[ - {"shape":"EventSubscriptionQuotaExceededFault"}, - {"shape":"SubscriptionAlreadyExistFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Creates an event notification subscription. This action requires a topic ARN (Amazon Resource Name) created by either the Neptune console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the type of source (SourceType) you want to be notified of, provide a list of Neptune sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you receive notice of the events for that source type for all your Neptune sources. If you do not specify either the SourceType nor the SourceIdentifier, you are notified of events generated from all Neptune sources belonging to your customer account.

" - }, - "DeleteDBCluster":{ - "name":"DeleteDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterMessage"}, - "output":{ - "shape":"DeleteDBClusterResult", - "resultWrapper":"DeleteDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"} - ], - "documentation":"

The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.

" - }, - "DeleteDBClusterParameterGroup":{ - "name":"DeleteDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

" - }, - "DeleteDBClusterSnapshot":{ - "name":"DeleteDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterSnapshotMessage"}, - "output":{ - "shape":"DeleteDBClusterSnapshotResult", - "resultWrapper":"DeleteDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

The DB cluster snapshot must be in the available state to be deleted.

" - }, - "DeleteDBInstance":{ - "name":"DeleteDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBInstanceMessage"}, - "output":{ - "shape":"DeleteDBInstanceResult", - "resultWrapper":"DeleteDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBSnapshotAlreadyExistsFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

The DeleteDBInstance action deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not deleted.

If you request a final DB snapshot the status of the Amazon Neptune DB instance is deleting until the DB snapshot is created. The API action DescribeDBInstance is used to monitor the status of this operation. The action can't be canceled or reverted once submitted.

Note that when a DB instance is in a failure state and has a status of failed, incompatible-restore, or incompatible-network, you can only delete it when the SkipFinalSnapshot parameter is set to true.

If the specified DB instance is part of a DB cluster, you can't delete the DB instance if both of the following conditions are true:

  • The DB cluster is a Read Replica of another DB cluster.

  • The DB instance is the only instance in the DB cluster.

To delete a DB instance in this case, first call the PromoteReadReplicaDBCluster API action to promote the DB cluster so it's no longer a Read Replica. After the promotion completes, then call the DeleteDBInstance API action to delete the final instance in the DB cluster.

" - }, - "DeleteDBParameterGroup":{ - "name":"DeleteDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Deletes a specified DBParameterGroup. The DBParameterGroup to be deleted can't be associated with any DB instances.

" - }, - "DeleteDBSubnetGroup":{ - "name":"DeleteDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBSubnetGroupMessage"}, - "errors":[ - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidDBSubnetStateFault"}, - {"shape":"DBSubnetGroupNotFoundFault"} - ], - "documentation":"

Deletes a DB subnet group.

The specified database subnet group must not be associated with any DB instances.

" - }, - "DeleteEventSubscription":{ - "name":"DeleteEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEventSubscriptionMessage"}, - "output":{ - "shape":"DeleteEventSubscriptionResult", - "resultWrapper":"DeleteEventSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"InvalidEventSubscriptionStateFault"} - ], - "documentation":"

Deletes an event notification subscription.

" - }, - "DescribeDBClusterParameterGroups":{ - "name":"DescribeDBClusterParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterParameterGroupsMessage"}, - "output":{ - "shape":"DBClusterParameterGroupsMessage", - "resultWrapper":"DescribeDBClusterParameterGroupsResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.

" - }, - "DescribeDBClusterParameters":{ - "name":"DescribeDBClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterParametersMessage"}, - "output":{ - "shape":"DBClusterParameterGroupDetails", - "resultWrapper":"DescribeDBClusterParametersResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns the detailed parameter list for a particular DB cluster parameter group.

" - }, - "DescribeDBClusterSnapshotAttributes":{ - "name":"DescribeDBClusterSnapshotAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterSnapshotAttributesMessage"}, - "output":{ - "shape":"DescribeDBClusterSnapshotAttributesResult", - "resultWrapper":"DescribeDBClusterSnapshotAttributesResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.

When sharing snapshots with other AWS accounts, DescribeDBClusterSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB cluster snapshot. If all is included in the list of values for the restore attribute, then the manual DB cluster snapshot is public and can be copied or restored by all AWS accounts.

To add or remove access for an AWS account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute API action.

" - }, - "DescribeDBClusterSnapshots":{ - "name":"DescribeDBClusterSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterSnapshotsMessage"}, - "output":{ - "shape":"DBClusterSnapshotMessage", - "resultWrapper":"DescribeDBClusterSnapshotsResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Returns information about DB cluster snapshots. This API action supports pagination.

" - }, - "DescribeDBClusters":{ - "name":"DescribeDBClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClustersMessage"}, - "output":{ - "shape":"DBClusterMessage", - "resultWrapper":"DescribeDBClustersResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Returns information about provisioned DB clusters. This API supports pagination.

" - }, - "DescribeDBEngineVersions":{ - "name":"DescribeDBEngineVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBEngineVersionsMessage"}, - "output":{ - "shape":"DBEngineVersionMessage", - "resultWrapper":"DescribeDBEngineVersionsResult" - }, - "documentation":"

Returns a list of the available DB engines.

" - }, - "DescribeDBInstances":{ - "name":"DescribeDBInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBInstancesMessage"}, - "output":{ - "shape":"DBInstanceMessage", - "resultWrapper":"DescribeDBInstancesResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

Returns information about provisioned instances. This API supports pagination.

" - }, - "DescribeDBParameterGroups":{ - "name":"DescribeDBParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBParameterGroupsMessage"}, - "output":{ - "shape":"DBParameterGroupsMessage", - "resultWrapper":"DescribeDBParameterGroupsResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

" - }, - "DescribeDBParameters":{ - "name":"DescribeDBParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBParametersMessage"}, - "output":{ - "shape":"DBParameterGroupDetails", - "resultWrapper":"DescribeDBParametersResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns the detailed parameter list for a particular DB parameter group.

" - }, - "DescribeDBSubnetGroups":{ - "name":"DescribeDBSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBSubnetGroupsMessage"}, - "output":{ - "shape":"DBSubnetGroupMessage", - "resultWrapper":"DescribeDBSubnetGroupsResult" - }, - "errors":[ - {"shape":"DBSubnetGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

" - }, - "DescribeEngineDefaultClusterParameters":{ - "name":"DescribeEngineDefaultClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEngineDefaultClusterParametersMessage"}, - "output":{ - "shape":"DescribeEngineDefaultClusterParametersResult", - "resultWrapper":"DescribeEngineDefaultClusterParametersResult" - }, - "documentation":"

Returns the default engine and system parameter information for the cluster database engine.

" - }, - "DescribeEngineDefaultParameters":{ - "name":"DescribeEngineDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEngineDefaultParametersMessage"}, - "output":{ - "shape":"DescribeEngineDefaultParametersResult", - "resultWrapper":"DescribeEngineDefaultParametersResult" - }, - "documentation":"

Returns the default engine and system parameter information for the specified database engine.

" - }, - "DescribeEventCategories":{ - "name":"DescribeEventCategories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventCategoriesMessage"}, - "output":{ - "shape":"EventCategoriesMessage", - "resultWrapper":"DescribeEventCategoriesResult" - }, - "documentation":"

Displays a list of categories for all event source types, or, if specified, for a specified source type.

" - }, - "DescribeEventSubscriptions":{ - "name":"DescribeEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventSubscriptionsMessage"}, - "output":{ - "shape":"EventSubscriptionsMessage", - "resultWrapper":"DescribeEventSubscriptionsResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"} - ], - "documentation":"

Lists all the subscription descriptions for a customer account. The description for a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

If you specify a SubscriptionName, lists the description for that subscription.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{ - "shape":"EventsMessage", - "resultWrapper":"DescribeEventsResult" - }, - "documentation":"

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

" - }, - "DescribeOrderableDBInstanceOptions":{ - "name":"DescribeOrderableDBInstanceOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrderableDBInstanceOptionsMessage"}, - "output":{ - "shape":"OrderableDBInstanceOptionsMessage", - "resultWrapper":"DescribeOrderableDBInstanceOptionsResult" - }, - "documentation":"

Returns a list of orderable DB instance options for the specified engine.

" - }, - "DescribePendingMaintenanceActions":{ - "name":"DescribePendingMaintenanceActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePendingMaintenanceActionsMessage"}, - "output":{ - "shape":"PendingMaintenanceActionsMessage", - "resultWrapper":"DescribePendingMaintenanceActionsResult" - }, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

" - }, - "DescribeValidDBInstanceModifications":{ - "name":"DescribeValidDBInstanceModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeValidDBInstanceModificationsMessage"}, - "output":{ - "shape":"DescribeValidDBInstanceModificationsResult", - "resultWrapper":"DescribeValidDBInstanceModificationsResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"} - ], - "documentation":"

You can call DescribeValidDBInstanceModifications to learn what modifications you can make to your DB instance. You can use this information when you call ModifyDBInstance.

" - }, - "FailoverDBCluster":{ - "name":"FailoverDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"FailoverDBClusterMessage"}, - "output":{ - "shape":"FailoverDBClusterResult", - "resultWrapper":"FailoverDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBInstanceStateFault"} - ], - "documentation":"

Forces a failover for a DB cluster.

A failover for a DB cluster promotes one of the Read Replicas (read-only instances) in the DB cluster to be the primary instance (the cluster writer).

Amazon Neptune will automatically fail over to a Read Replica, if one exists, when the primary instance fails. You can force a failover when you want to simulate a failure of a primary instance for testing. Because each instance in a DB cluster has its own endpoint address, you will need to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceMessage"}, - "output":{ - "shape":"TagListMessage", - "resultWrapper":"ListTagsForResourceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Lists all tags on an Amazon Neptune resource.

" - }, - "ModifyDBCluster":{ - "name":"ModifyDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterMessage"}, - "output":{ - "shape":"ModifyDBClusterResult", - "resultWrapper":"ModifyDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"DBClusterParameterGroupNotFoundFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBClusterAlreadyExistsFault"} - ], - "documentation":"

Modify a setting for a DB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.

" - }, - "ModifyDBClusterParameterGroup":{ - "name":"ModifyDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterParameterGroupMessage"}, - "output":{ - "shape":"DBClusterParameterGroupNameMessage", - "resultWrapper":"ModifyDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InvalidDBParameterGroupStateFault"} - ], - "documentation":"

Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB cluster associated with the parameter group before the change can take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

" - }, - "ModifyDBClusterSnapshotAttribute":{ - "name":"ModifyDBClusterSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterSnapshotAttributeMessage"}, - "output":{ - "shape":"ModifyDBClusterSnapshotAttributeResult", - "resultWrapper":"ModifyDBClusterSnapshotAttributeResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"SharedSnapshotQuotaExceededFault"} - ], - "documentation":"

Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.

To share a manual DB cluster snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB cluster snapshot. Use the value all to make the manual DB cluster snapshot public, which means that it can be copied or restored by all AWS accounts. Do not add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts. If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

To view which AWS accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot public or private, use the DescribeDBClusterSnapshotAttributes API action.

" - }, - "ModifyDBInstance":{ - "name":"ModifyDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBInstanceMessage"}, - "output":{ - "shape":"ModifyDBInstanceResult", - "resultWrapper":"ModifyDBInstanceResult" - }, - "errors":[ - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"DBUpgradeDependencyFailureFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"CertificateNotFoundFault"}, - {"shape":"DomainNotFoundFault"} - ], - "documentation":"

Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.

" - }, - "ModifyDBParameterGroup":{ - "name":"ModifyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBParameterGroupMessage"}, - "output":{ - "shape":"DBParameterGroupNameMessage", - "resultWrapper":"ModifyDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InvalidDBParameterGroupStateFault"} - ], - "documentation":"

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon Neptune to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "ModifyDBSubnetGroup":{ - "name":"ModifyDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBSubnetGroupMessage"}, - "output":{ - "shape":"ModifyDBSubnetGroupResult", - "resultWrapper":"ModifyDBSubnetGroupResult" - }, - "errors":[ - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetQuotaExceededFault"}, - {"shape":"SubnetAlreadyInUse"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

" - }, - "ModifyEventSubscription":{ - "name":"ModifyEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyEventSubscriptionMessage"}, - "output":{ - "shape":"ModifyEventSubscriptionResult", - "resultWrapper":"ModifyEventSubscriptionResult" - }, - "errors":[ - {"shape":"EventSubscriptionQuotaExceededFault"}, - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"} - ], - "documentation":"

Modifies an existing event notification subscription. Note that you can't modify the source identifiers using this call; to change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

You can see a list of the event categories for a given SourceType by using the DescribeEventCategories action.

" - }, - "PromoteReadReplicaDBCluster":{ - "name":"PromoteReadReplicaDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PromoteReadReplicaDBClusterMessage"}, - "output":{ - "shape":"PromoteReadReplicaDBClusterResult", - "resultWrapper":"PromoteReadReplicaDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Promotes a Read Replica DB cluster to a standalone DB cluster.

" - }, - "RebootDBInstance":{ - "name":"RebootDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootDBInstanceMessage"}, - "output":{ - "shape":"RebootDBInstanceResult", - "resultWrapper":"RebootDBInstanceResult" - }, - "errors":[ - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.

Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.

" - }, - "RemoveRoleFromDBCluster":{ - "name":"RemoveRoleFromDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveRoleFromDBClusterMessage"}, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterRoleNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Disassociates an Identity and Access Management (IAM) role from a DB cluster.

" - }, - "RemoveSourceIdentifierFromSubscription":{ - "name":"RemoveSourceIdentifierFromSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveSourceIdentifierFromSubscriptionMessage"}, - "output":{ - "shape":"RemoveSourceIdentifierFromSubscriptionResult", - "resultWrapper":"RemoveSourceIdentifierFromSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Removes a source identifier from an existing event notification subscription.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceMessage"}, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Removes metadata tags from an Amazon Neptune resource.

" - }, - "ResetDBClusterParameterGroup":{ - "name":"ResetDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetDBClusterParameterGroupMessage"}, - "output":{ - "shape":"DBClusterParameterGroupNameMessage", - "resultWrapper":"ResetDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the entire DB cluster parameter group, specify the DBClusterParameterGroupName and ResetAllParameters parameters.

When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request. You must call RebootDBInstance for every DB instance in your DB cluster that you want the updated static parameter to apply to.

" - }, - "ResetDBParameterGroup":{ - "name":"ResetDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetDBParameterGroupMessage"}, - "output":{ - "shape":"DBParameterGroupNameMessage", - "resultWrapper":"ResetDBParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.

" - }, - "RestoreDBClusterFromSnapshot":{ - "name":"RestoreDBClusterFromSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBClusterFromSnapshotMessage"}, - "output":{ - "shape":"RestoreDBClusterFromSnapshotResult", - "resultWrapper":"RestoreDBClusterFromSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InsufficientDBClusterCapacityFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Creates a new DB cluster from a DB snapshot or DB cluster snapshot.

If a DB snapshot is specified, the target DB cluster is created from the source DB snapshot with a default configuration and default security group.

If a DB cluster snapshot is specified, the target DB cluster is created from the source DB cluster restore point with the same configuration as the original source DB cluster, except that the new DB cluster is created with the default security group.

" - }, - "RestoreDBClusterToPointInTime":{ - "name":"RestoreDBClusterToPointInTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBClusterToPointInTimeMessage"}, - "output":{ - "shape":"RestoreDBClusterToPointInTimeResult", - "resultWrapper":"RestoreDBClusterToPointInTimeResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InsufficientDBClusterCapacityFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"StorageQuotaExceededFault"} - ], - "documentation":"

Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before LatestRestorableTime for up to BackupRetentionPeriod days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group.

This action only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the CreateDBInstance action to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster in DBClusterIdentifier. You can create DB instances only after the RestoreDBClusterToPointInTime action has completed and the DB cluster is available.

" - } - }, - "shapes":{ - "AddRoleToDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "RoleArn" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to associate the IAM role with.

" - }, - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to associate with the Neptune DB cluster, for example arn:aws:iam::123456789012:role/NeptuneAccessRole.

" - } - } - }, - "AddSourceIdentifierToSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event notification subscription you want to add a source identifier to.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source to be added.

Constraints:

  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.

  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.

  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.

  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.

" - } - }, - "documentation":"

" - }, - "AddSourceIdentifierToSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "AddTagsToResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Neptune resource that the tags are added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the Amazon Neptune resource.

" - } - }, - "documentation":"

" - }, - "ApplyMethod":{ - "type":"string", - "enum":[ - "immediate", - "pending-reboot" - ] - }, - "ApplyPendingMaintenanceActionMessage":{ - "type":"structure", - "required":[ - "ResourceIdentifier", - "ApplyAction", - "OptInType" - ], - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the resource that the pending maintenance action applies to. For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

" - }, - "ApplyAction":{ - "shape":"String", - "documentation":"

The pending maintenance action to apply to this resource.

Valid values: system-update, db-upgrade

" - }, - "OptInType":{ - "shape":"String", - "documentation":"

A value that specifies the type of opt-in request, or undoes an opt-in request. An opt-in request of type immediate can't be undone.

Valid values:

  • immediate - Apply the maintenance action immediately.

  • next-maintenance - Apply the maintenance action during the next maintenance window for the resource.

  • undo-opt-in - Cancel any existing next-maintenance opt-in requests.

" - } - }, - "documentation":"

" - }, - "ApplyPendingMaintenanceActionResult":{ - "type":"structure", - "members":{ - "ResourcePendingMaintenanceActions":{"shape":"ResourcePendingMaintenanceActions"} - } - }, - "AttributeValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AttributeValue" - } - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

Neptune may not also be authorized via IAM to perform necessary actions on your behalf.

", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the availability zone.

" - } - }, - "documentation":"

Contains Availability Zone information.

This data type is used as an element in the following data type:

", - "wrapper":true - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"AvailabilityZone" - } - }, - "AvailabilityZones":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AvailabilityZone" - } - }, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "CertificateNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

CertificateIdentifier does not refer to an existing certificate.

", - "error":{ - "code":"CertificateNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "CharacterSet":{ - "type":"structure", - "members":{ - "CharacterSetName":{ - "shape":"String", - "documentation":"

The name of the character set.

" - }, - "CharacterSetDescription":{ - "shape":"String", - "documentation":"

The description of the character set.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "CloudwatchLogsExportConfiguration":{ - "type":"structure", - "members":{ - "EnableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The list of log types to enable.

" - }, - "DisableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The list of log types to disable.

" - } - }, - "documentation":"

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance or DB cluster.

" - }, - "CopyDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "SourceDBClusterParameterGroupIdentifier", - "TargetDBClusterParameterGroupIdentifier", - "TargetDBClusterParameterGroupDescription" - ], - "members":{ - "SourceDBClusterParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or Amazon Resource Name (ARN) for the source DB cluster parameter group. For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid DB cluster parameter group.

  • If the source DB cluster parameter group is in the same AWS Region as the copy, specify a valid DB parameter group identifier, for example my-db-cluster-param-group, or a valid ARN.

  • If the source DB parameter group is in a different AWS Region than the copy, specify a valid DB cluster parameter group ARN, for example arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1.

" - }, - "TargetDBClusterParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied DB cluster parameter group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-cluster-param-group1

" - }, - "TargetDBClusterParameterGroupDescription":{ - "shape":"String", - "documentation":"

A description for the copied DB cluster parameter group.

" - }, - "Tags":{"shape":"TagList"} - } - }, - "CopyDBClusterParameterGroupResult":{ - "type":"structure", - "members":{ - "DBClusterParameterGroup":{"shape":"DBClusterParameterGroup"} - } - }, - "CopyDBClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "SourceDBClusterSnapshotIdentifier", - "TargetDBClusterSnapshotIdentifier" - ], - "members":{ - "SourceDBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.

You can't copy an encrypted, shared DB cluster snapshot from one AWS Region to another.

Constraints:

  • Must specify a valid system snapshot in the \"available\" state.

  • If the source snapshot is in the same AWS Region as the copy, specify a valid DB snapshot identifier.

  • If the source snapshot is in a different AWS Region than the copy, specify a valid DB cluster snapshot ARN.

Example: my-cluster-snapshot1

" - }, - "TargetDBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is not case-sensitive.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster-snapshot2

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an unencrypted DB cluster snapshot and specify a value for the KmsKeyId parameter, Amazon Neptune encrypts the target DB cluster snapshot using the specified KMS encryption key.

If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If you don't specify a value for KmsKeyId, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source DB cluster snapshot.

If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a value for KmsKeyId.

To copy an encrypted DB cluster snapshot to another AWS Region, you must set KmsKeyId to the KMS key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

The URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot API action in the AWS Region that contains the source DB cluster snapshot to copy. The PreSignedUrl parameter must be used when copying an encrypted DB cluster snapshot from another AWS Region.

The pre-signed URL must be a valid request for the CopyDBSClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL request must contain the following parameter values:

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

  • DestinationRegion - The name of the AWS Region that the DB cluster snapshot will be created in.

  • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:neptune-cluster1-snapshot-20161115.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "CopyTags":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot, and otherwise false. The default is false.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "CopyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "SourceDBParameterGroupIdentifier", - "TargetDBParameterGroupIdentifier", - "TargetDBParameterGroupDescription" - ], - "members":{ - "SourceDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or ARN for the source DB parameter group. For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid DB parameter group.

  • Must specify a valid DB parameter group identifier, for example my-db-param-group, or a valid ARN.

" - }, - "TargetDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied DB parameter group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-parameter-group

" - }, - "TargetDBParameterGroupDescription":{ - "shape":"String", - "documentation":"

A description for the copied DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CreateDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "Engine" - ], - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

A list of EC2 Availability Zones that instances in the DB cluster can be created in.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified CharacterSet.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The name for your database of up to 64 alpha-numeric characters. If you do not provide a name, Amazon Neptune will not create a database in the DB cluster you are creating.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1

" - }, - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, the default is used.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with this DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB cluster.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this DB cluster.

Valid Values: neptune

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

Example: 1.0.1

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the instances in the DB cluster accept connections.

Default: 8182

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name of the master user for the DB cluster.

Constraints:

  • Must be 1 to 16 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified option group.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon Neptune User Guide.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon Neptune User Guide.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "ReplicationSourceIdentifier":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a Read Replica.

" - }, - "Tags":{"shape":"TagList"}, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB cluster is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If an encryption key is not specified in KmsKeyId:

  • If ReplicationSourceIdentifier identifies an encrypted source, then Amazon Neptune will use the encryption key used to encrypt the source. Otherwise, Amazon Neptune will use your default encryption key.

  • If the StorageEncrypted parameter is true and ReplicationSourceIdentifier is not specified, then Amazon Neptune will use your default encryption key.

AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

If you create a Read Replica of an encrypted DB cluster in another AWS Region, you must set KmsKeyId to a KMS key ID that is valid in the destination AWS Region. This key is used to encrypt the Read Replica in that AWS Region.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

A URL that contains a Signature Version 4 signed request for the CreateDBCluster action to be called in the source AWS Region where the DB cluster is replicated from. You only need to specify PreSignedUrl when you are performing cross-region replication from an encrypted DB cluster.

The pre-signed URL must be a valid request for the CreateDBCluster API action that can be executed in the source AWS Region that contains the encrypted DB cluster to be copied.

The pre-signed URL request must contain the following parameter values:

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the copy of the DB cluster in the destination AWS Region. This should refer to the same KMS key for both the CreateDBCluster action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

  • DestinationRegion - The name of the AWS Region that Read Replica will be created in.

  • ReplicationSourceIdentifier - The DB cluster identifier for the encrypted DB cluster to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster from the us-west-2 AWS Region, then your ReplicationSourceIdentifier would look like Example: arn:aws:rds:us-west-2:123456789012:cluster:neptune-cluster1.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - } - }, - "documentation":"

" - }, - "CreateDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBClusterParameterGroupName", - "DBParameterGroupFamily", - "Description" - ], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must match the name of an existing DBClusterParameterGroup.

This value is stored as a lowercase string.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the DB cluster parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBClusterParameterGroupResult":{ - "type":"structure", - "members":{ - "DBClusterParameterGroup":{"shape":"DBClusterParameterGroup"} - } - }, - "CreateDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "CreateDBClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "DBClusterSnapshotIdentifier", - "DBClusterIdentifier" - ], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1-snapshot1

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster to create a snapshot for. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

Example: my-cluster1

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the DB cluster snapshot.

" - } - }, - "documentation":"

" - }, - "CreateDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "CreateDBInstanceMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "DBInstanceClass", - "Engine" - ], - "members":{ - "DBName":{ - "shape":"String", - "documentation":"

The database name.

Type: String

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gibibytes) to allocate for the DB instance.

Type: Integer

Not applicable. Neptune cluster volumes automatically grow as the amount of data in your database increases, though you are only charged for the space that you use in a Neptune cluster volume.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this instance.

Valid Values: neptune

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name for the master user. Not used.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Not used.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to associate with this DB instance.

Default: The default DB security group for the database engine.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with this DB instance.

Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: The default EC2 VPC security group for the DB subnet group's VPC.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the DB instance is created in.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same AWS Region as the current endpoint.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB instance.

If there is no DB subnet group, then it is a non-VPC DB instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained.

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: 1

Constraints:

  • Must be a value from 0 to 35

  • Cannot be set to 0 if the DB instance is a source to Read Replicas

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created.

Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Not applicable. The port is managed by the DB cluster. For more information, see CreateDBCluster.

Default: 8182

Type: Integer

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. You can't set the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.

Default: true

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified CharacterSet.

Not applicable. The character set is managed by the DB cluster. For more information, see CreateDBCluster.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is not supported.

", - "deprecated":true - }, - "Tags":{"shape":"TagList"}, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster that the instance will belong to.

For information on creating a DB cluster, see CreateDBCluster.

Type: String

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

Not applicable. Storage is managed by the DB Cluster.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB instance is encrypted.

Not applicable. The encryption for DB instances is managed by the DB cluster. For more information, see CreateDBCluster.

Default: false

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB instance.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB instance with the same AWS account that owns the KMS encryption key used to encrypt the new DB instance, then you can use the KMS key alias instead of the ARN for the KM encryption key.

Not applicable. The KMS key identifier is managed by the DB cluster. For more information, see CreateDBCluster.

If the StorageEncrypted parameter is true, and you do not specify a value for the KmsKeyId parameter, then Amazon Neptune will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

Specify the Active Directory Domain to create the instance in.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits Neptune to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

Specify the name of the IAM role to be used when making API calls to the Directory Service.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which an Read Replica is promoted to the primary instance after a failure of the existing primary instance.

Default: 1

Valid Values: 0 - 15

" - }, - "Timezone":{ - "shape":"String", - "documentation":"

The time zone of the DB instance.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable AWS Identity and Access Management (IAM) authentication for Neptune.

Default: false

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the DB instance, and otherwise false.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of log types that need to be enabled for exporting to CloudWatch Logs.

" - } - }, - "documentation":"

" - }, - "CreateDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "CreateDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "DBParameterGroupFamily", - "Description" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

This value is stored as a lowercase string.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CreateDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "DBSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 letters, numbers, periods, underscores, spaces, or hyphens. Must not be default.

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 Subnet IDs for the DB subnet group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "CreateEventSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SnsTopicArn" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the subscription.

Constraints: The name must be less than 255 characters.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType by using the DescribeEventCategories action.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

The list of identifiers of the event sources for which events are returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it can't end with a hyphen or contain two consecutive hyphens.

Constraints:

  • If SourceIds are supplied, SourceType must also be provided.

  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.

  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.

  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.

  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "DBCluster":{ - "type":"structure", - "members":{ - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

AllocatedStorage always returns 1, because Neptune DB cluster storage size is not fixed, but instead automatically adjusts as needed.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the number of days for which automatic DB snapshots are retained.

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

If present, specifies the name of the character set that this cluster is associated with.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

" - }, - "DBClusterParameterGroup":{ - "shape":"String", - "documentation":"

Specifies the name of the DB cluster parameter group for the DB cluster.

" - }, - "DBSubnetGroup":{ - "shape":"String", - "documentation":"

Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the current state of this DB cluster.

" - }, - "PercentProgress":{ - "shape":"String", - "documentation":"

Specifies the progress of the operation as a percentage.

" - }, - "EarliestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the earliest time to which a database can be restored with point-in-time restore.

" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

Specifies the connection endpoint for the primary instance of the DB cluster.

" - }, - "ReaderEndpoint":{ - "shape":"String", - "documentation":"

The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Read Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Neptune distributes the connection requests among the Read Replicas in the DB cluster. This functionality can help balance your read workload across multiple Read Replicas in your DB cluster.

If a failover occurs, and the Read Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Read Replicas in the cluster, you can then reconnect to the reader endpoint.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster has instances in multiple Availability Zones.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Provides the name of the database engine to be used for this DB cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "LatestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the latest time to which a database can be restored with point-in-time restore.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the port that the database engine is listening on.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Contains the master username for the DB cluster.

" - }, - "DBClusterOptionGroupMemberships":{ - "shape":"DBClusterOptionGroupMemberships", - "documentation":"

Provides the list of option group memberships for this DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

" - }, - "ReplicationSourceIdentifier":{ - "shape":"String", - "documentation":"

Contains the identifier of the source DB cluster if this DB cluster is a Read Replica.

" - }, - "ReadReplicaIdentifiers":{ - "shape":"ReadReplicaIdentifierList", - "documentation":"

Contains one or more identifiers of the Read Replicas associated with this DB cluster.

" - }, - "DBClusterMembers":{ - "shape":"DBClusterMemberList", - "documentation":"

Provides the list of instances that make up the DB cluster.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

Provides a list of VPC security groups that the DB cluster belongs to.

" - }, - "HostedZoneId":{ - "shape":"String", - "documentation":"

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster.

" - }, - "DbClusterResourceId":{ - "shape":"String", - "documentation":"

The AWS Region-unique, immutable identifier for the DB cluster. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS key for the DB cluster is accessed.

" - }, - "DBClusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster.

" - }, - "AssociatedRoles":{ - "shape":"DBClusterRoles", - "documentation":"

Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other AWS services on your behalf.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

" - }, - "CloneGroupId":{ - "shape":"String", - "documentation":"

Identifies the clone group to which the DB cluster is associated.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

" - } - }, - "documentation":"

Contains the details of an Amazon Neptune DB cluster.

This data type is used as a response element in the DescribeDBClusters action.

", - "wrapper":true - }, - "DBClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User already has a DB cluster with the given identifier.

", - "error":{ - "code":"DBClusterAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterList":{ - "type":"list", - "member":{ - "shape":"DBCluster", - "locationName":"DBCluster" - } - }, - "DBClusterMember":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Specifies the instance identifier for this member of the DB cluster.

" - }, - "IsClusterWriter":{ - "shape":"Boolean", - "documentation":"

Value that is true if the cluster member is the primary instance for the DB cluster and false otherwise.

" - }, - "DBClusterParameterGroupStatus":{ - "shape":"String", - "documentation":"

Specifies the status of the DB cluster parameter group for this member of the DB cluster.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which a Read Replica is promoted to the primary instance after a failure of the existing primary instance.

" - } - }, - "documentation":"

Contains information about an instance that is part of a DB cluster.

", - "wrapper":true - }, - "DBClusterMemberList":{ - "type":"list", - "member":{ - "shape":"DBClusterMember", - "locationName":"DBClusterMember" - } - }, - "DBClusterMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeDBClusters request.

" - }, - "DBClusters":{ - "shape":"DBClusterList", - "documentation":"

Contains a list of DB clusters for the user.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBClusters action.

" - }, - "DBClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterIdentifier does not refer to an existing DB cluster.

", - "error":{ - "code":"DBClusterNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterOptionGroupMemberships":{ - "type":"list", - "member":{ - "shape":"DBClusterOptionGroupStatus", - "locationName":"DBClusterOptionGroup" - } - }, - "DBClusterOptionGroupStatus":{ - "type":"structure", - "members":{ - "DBClusterOptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the DB cluster option group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of the DB cluster option group.

" - } - }, - "documentation":"

Contains status information for a DB cluster option group.

" - }, - "DBClusterParameterGroup":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB cluster parameter group.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group family that this DB cluster parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides the customer-specified description for this DB cluster parameter group.

" - }, - "DBClusterParameterGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster parameter group.

" - } - }, - "documentation":"

Contains the details of an Amazon Neptune DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups action.

", - "wrapper":true - }, - "DBClusterParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Provides a list of parameters for the DB cluster parameter group.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Provides details about a DB cluster parameter group including the parameters in the DB cluster parameter group.

" - }, - "DBClusterParameterGroupList":{ - "type":"list", - "member":{ - "shape":"DBClusterParameterGroup", - "locationName":"DBClusterParameterGroup" - } - }, - "DBClusterParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must be 1 to 255 letters or numbers.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

This value is stored as a lowercase string.

" - } - }, - "documentation":"

" - }, - "DBClusterParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterParameterGroupName does not refer to an existing DB Cluster parameter group.

", - "error":{ - "code":"DBClusterParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBClusterParameterGroups":{ - "shape":"DBClusterParameterGroupList", - "documentation":"

A list of DB cluster parameter groups.

" - } - }, - "documentation":"

" - }, - "DBClusterQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.

", - "error":{ - "code":"DBClusterQuotaExceededFault", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "DBClusterRole":{ - "type":"structure", - "members":{ - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that is associated with the DB cluster.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Describes the state of association between the IAM role and the DB cluster. The Status property returns one of the following values:

  • ACTIVE - the IAM role ARN is associated with the DB cluster and can be used to access other AWS services on your behalf.

  • PENDING - the IAM role ARN is being associated with the DB cluster.

  • INVALID - the IAM role ARN is associated with the DB cluster, but the DB cluster is unable to assume the IAM role in order to access other AWS services on your behalf.

" - } - }, - "documentation":"

Describes an AWS Identity and Access Management (IAM) role that is associated with a DB cluster.

" - }, - "DBClusterRoleAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoleNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified IAM role Amazon Resource Name (ARN) is not associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoleQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoles":{ - "type":"list", - "member":{ - "shape":"DBClusterRole", - "locationName":"DBClusterRole" - } - }, - "DBClusterSnapshot":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

" - }, - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier for the DB cluster snapshot.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Specifies the name of the database engine.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size in gibibytes (GiB).

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of this DB cluster snapshot.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the DB cluster was listening on at the time of the snapshot.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VPC ID associated with the DB cluster snapshot.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Provides the master username for the DB cluster snapshot.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Provides the version of the database engine for this DB cluster snapshot.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

Provides the license model information for this DB cluster snapshot.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

Provides the type of the DB cluster snapshot.

" - }, - "PercentProgress":{ - "shape":"Integer", - "documentation":"

Specifies the percentage of the estimated data that has been transferred.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster snapshot is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.

" - }, - "DBClusterSnapshotArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster snapshot.

" - }, - "SourceDBClusterSnapshotArn":{ - "shape":"String", - "documentation":"

If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

" - } - }, - "documentation":"

Contains the details for an Amazon Neptune DB cluster snapshot

This data type is used as a response element in the DescribeDBClusterSnapshots action.

", - "wrapper":true - }, - "DBClusterSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User already has a DB cluster snapshot with the given identifier.

", - "error":{ - "code":"DBClusterSnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterSnapshotAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the manual DB cluster snapshot attribute.

The attribute named restore refers to the list of AWS accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

" - }, - "AttributeValues":{ - "shape":"AttributeValueList", - "documentation":"

The value(s) for the manual DB cluster snapshot attribute.

If the AttributeName field is set to restore, then this element returns a list of IDs of the AWS accounts that are authorized to copy or restore the manual DB cluster snapshot. If a value of all is in the list, then the manual DB cluster snapshot is public and available for any AWS account to copy or restore.

" - } - }, - "documentation":"

Contains the name and values of a manual DB cluster snapshot attribute.

Manual DB cluster snapshot attributes are used to authorize other AWS accounts to restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

" - }, - "DBClusterSnapshotAttributeList":{ - "type":"list", - "member":{ - "shape":"DBClusterSnapshotAttribute", - "locationName":"DBClusterSnapshotAttribute" - } - }, - "DBClusterSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the manual DB cluster snapshot that the attributes apply to.

" - }, - "DBClusterSnapshotAttributes":{ - "shape":"DBClusterSnapshotAttributeList", - "documentation":"

The list of attributes and values for the manual DB cluster snapshot.

" - } - }, - "documentation":"

Contains the results of a successful call to the DescribeDBClusterSnapshotAttributes API action.

Manual DB cluster snapshot attributes are used to authorize other AWS accounts to copy or restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

", - "wrapper":true - }, - "DBClusterSnapshotList":{ - "type":"list", - "member":{ - "shape":"DBClusterSnapshot", - "locationName":"DBClusterSnapshot" - } - }, - "DBClusterSnapshotMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBClusterSnapshots":{ - "shape":"DBClusterSnapshotList", - "documentation":"

Provides a list of DB cluster snapshots for the user.

" - } - }, - "documentation":"

Provides a list of DB cluster snapshots for the user as the result of a call to the DescribeDBClusterSnapshots action.

" - }, - "DBClusterSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterSnapshotIdentifier does not refer to an existing DB cluster snapshot.

", - "error":{ - "code":"DBClusterSnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBEngineVersion":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family for the database engine.

" - }, - "DBEngineDescription":{ - "shape":"String", - "documentation":"

The description of the database engine.

" - }, - "DBEngineVersionDescription":{ - "shape":"String", - "documentation":"

The description of the database engine version.

" - }, - "DefaultCharacterSet":{ - "shape":"CharacterSet", - "documentation":"

The default character set for new instances of this engine version, if the CharacterSetName parameter of the CreateDBInstance API is not specified.

" - }, - "SupportedCharacterSets":{ - "shape":"SupportedCharacterSetsList", - "documentation":"

A list of the character sets supported by this engine for the CharacterSetName parameter of the CreateDBInstance action.

" - }, - "ValidUpgradeTarget":{ - "shape":"ValidUpgradeTargetList", - "documentation":"

A list of engine versions that this database engine version can be upgraded to.

" - }, - "SupportedTimezones":{ - "shape":"SupportedTimezonesList", - "documentation":"

A list of the time zones supported by this engine for the Timezone parameter of the CreateDBInstance action.

" - }, - "ExportableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The types of logs that the database engine has available for export to CloudWatch Logs.

" - }, - "SupportsLogExportsToCloudwatchLogs":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether the engine version supports exporting the log types specified by ExportableLogTypes to CloudWatch Logs.

" - }, - "SupportsReadReplica":{ - "shape":"Boolean", - "documentation":"

Indicates whether the database engine version supports read replicas.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "DBEngineVersionList":{ - "type":"list", - "member":{ - "shape":"DBEngineVersion", - "locationName":"DBEngineVersion" - } - }, - "DBEngineVersionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBEngineVersions":{ - "shape":"DBEngineVersionList", - "documentation":"

A list of DBEngineVersion elements.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBEngineVersions action.

" - }, - "DBInstance":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied database identifier. This identifier is the unique key that identifies a DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the name of the compute and memory capacity class of the DB instance.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Provides the name of the database engine to be used for this DB instance.

" - }, - "DBInstanceStatus":{ - "shape":"String", - "documentation":"

Specifies the current state of this database.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Contains the master username for the DB instance.

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The database name.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

Specifies the connection endpoint.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size specified in gibibytes.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the date and time the DB instance was created.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

" - }, - "BackupRetentionPeriod":{ - "shape":"Integer", - "documentation":"

Specifies the number of days for which automatic DB snapshots are retained.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupMembershipList", - "documentation":"

Provides List of DB security group elements containing only DBSecurityGroup.Name and DBSecurityGroup.Status subelements.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

Provides a list of VPC security group elements that the DB instance belongs to.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupStatusList", - "documentation":"

Provides the list of DB parameter groups applied to this DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Specifies the name of the Availability Zone the DB instance is located in.

" - }, - "DBSubnetGroup":{ - "shape":"DBSubnetGroup", - "documentation":"

Specifies information on the subnet group associated with the DB instance, including the name, description, and subnets in the subnet group.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

" - }, - "PendingModifiedValues":{ - "shape":"PendingModifiedValues", - "documentation":"

Specifies that changes to the DB instance are pending. This element is only included when changes are pending. Specific changes are identified by subelements.

" - }, - "LatestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the latest time to which a database can be restored with point-in-time restore.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that minor version patches are applied automatically.

" - }, - "ReadReplicaSourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the identifier of the source DB instance if this DB instance is a Read Replica.

" - }, - "ReadReplicaDBInstanceIdentifiers":{ - "shape":"ReadReplicaDBInstanceIdentifierList", - "documentation":"

Contains one or more identifiers of the Read Replicas associated with this DB instance.

" - }, - "ReadReplicaDBClusterIdentifiers":{ - "shape":"ReadReplicaDBClusterIdentifierList", - "documentation":"

Contains one or more identifiers of DB clusters that are Read Replicas of this DB instance.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the Provisioned IOPS (I/O operations per second) value.

" - }, - "OptionGroupMemberships":{ - "shape":"OptionGroupMembershipList", - "documentation":"

Provides the list of option group memberships for this DB instance.

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

If present, specifies the name of the character set that this instance is associated with.

" - }, - "SecondaryAvailabilityZone":{ - "shape":"String", - "documentation":"

If present, specifies the name of the secondary Availability Zone for a DB instance with multi-AZ support.

" - }, - "PubliclyAccessible":{ - "shape":"Boolean", - "documentation":"

This parameter is not supported.

", - "deprecated":true - }, - "StatusInfos":{ - "shape":"DBInstanceStatusInfoList", - "documentation":"

The status of a Read Replica. If the instance is not a Read Replica, this is blank.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type associated with DB instance.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which the instance is associated for TDE encryption.

" - }, - "DbInstancePort":{ - "shape":"Integer", - "documentation":"

Specifies the port that the DB instance listens on. If the DB instance is part of a DB cluster, this can be a different port than the DB cluster port.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

If the DB instance is a member of a DB cluster, contains the name of the DB cluster that the DB instance is a member of.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB instance is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB instance.

" - }, - "DbiResourceId":{ - "shape":"String", - "documentation":"

The AWS Region-unique, immutable identifier for the DB instance. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS key for the DB instance is accessed.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the CA certificate for this DB instance.

" - }, - "DomainMemberships":{ - "shape":"DomainMembershipList", - "documentation":"

Not supported

" - }, - "CopyTagsToSnapshot":{ - "shape":"Boolean", - "documentation":"

Specifies whether tags are copied from the DB instance to snapshots of the DB instance.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance.

" - }, - "EnhancedMonitoringResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon CloudWatch Logs log stream that receives the Enhanced Monitoring metrics data for the DB instance.

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits Neptune to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which a Read Replica is promoted to the primary instance after a failure of the existing primary instance.

" - }, - "DBInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB instance.

" - }, - "Timezone":{ - "shape":"String", - "documentation":"

Not supported.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if AWS Identity and Access Management (IAM) authentication is enabled, and otherwise false.

" - }, - "PerformanceInsightsEnabled":{ - "shape":"BooleanOptional", - "documentation":"

True if Performance Insights is enabled for the DB instance, and otherwise false.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "EnabledCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

A list of log types that this DB instance is configured to export to CloudWatch Logs.

" - } - }, - "documentation":"

Contains the details of an Amazon Neptune DB instance.

This data type is used as a response element in the DescribeDBInstances action.

", - "wrapper":true - }, - "DBInstanceAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User already has a DB instance with the given identifier.

", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBInstanceList":{ - "type":"list", - "member":{ - "shape":"DBInstance", - "locationName":"DBInstance" - } - }, - "DBInstanceMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "DBInstances":{ - "shape":"DBInstanceList", - "documentation":"

A list of DBInstance instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBInstances action.

" - }, - "DBInstanceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBInstanceStatusInfo":{ - "type":"structure", - "members":{ - "StatusType":{ - "shape":"String", - "documentation":"

This value is currently \"read replication.\"

" - }, - "Normal":{ - "shape":"Boolean", - "documentation":"

Boolean value that is true if the instance is operating normally, or false if the instance is in an error state.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Status of the DB instance. For a StatusType of read replica, the values can be replicating, error, stopped, or terminated.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Details of the error if there is an error for the instance. If the instance is not in an error state, this value is blank.

" - } - }, - "documentation":"

Provides a list of status information for a DB instance.

" - }, - "DBInstanceStatusInfoList":{ - "type":"list", - "member":{ - "shape":"DBInstanceStatusInfo", - "locationName":"DBInstanceStatusInfo" - } - }, - "DBParameterGroup":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group family that this DB parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides the customer-specified description for this DB parameter group.

" - }, - "DBParameterGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB parameter group.

" - } - }, - "documentation":"

Contains the details of an Amazon Neptune DB parameter group.

This data type is used as a response element in the DescribeDBParameterGroups action.

", - "wrapper":true - }, - "DBParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A DB parameter group with the same name exists.

", - "error":{ - "code":"DBParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter values.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameters action.

" - }, - "DBParameterGroupList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroup", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the ModifyDBParameterGroup or ResetDBParameterGroup action.

" - }, - "DBParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed number of DB parameter groups.

", - "error":{ - "code":"DBParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupStatus":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DP parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - } - }, - "documentation":"

The status of the DB parameter group.

This data type is used as a response element in the following actions:

" - }, - "DBParameterGroupStatusList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroupStatus", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupList", - "documentation":"

A list of DBParameterGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameterGroups action.

" - }, - "DBSecurityGroupMembership":{ - "type":"structure", - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB security group.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "DBSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"DBSecurityGroupMembership", - "locationName":"DBSecurityGroup" - } - }, - "DBSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DBSecurityGroupName" - } - }, - "DBSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

", - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroup":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group.

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

Provides the description of the DB subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VpcId of the DB subnet group.

" - }, - "SubnetGroupStatus":{ - "shape":"String", - "documentation":"

Provides the status of the DB subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Contains a list of Subnet elements.

" - }, - "DBSubnetGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB subnet group.

" - } - }, - "documentation":"

Contains the details of an Amazon Neptune DB subnet group.

This data type is used as a response element in the DescribeDBSubnetGroups action.

", - "wrapper":true - }, - "DBSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSubnetGroupName is already used by an existing DB subnet group.

", - "error":{ - "code":"DBSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupDoesNotCoverEnoughAZs":{ - "type":"structure", - "members":{ - }, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSubnetGroups":{ - "shape":"DBSubnetGroups", - "documentation":"

A list of DBSubnetGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSubnetGroups action.

" - }, - "DBSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed number of DB subnet groups.

", - "error":{ - "code":"DBSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroups":{ - "type":"list", - "member":{ - "shape":"DBSubnetGroup", - "locationName":"DBSubnetGroup" - } - }, - "DBSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed number of subnets in a DB subnet groups.

", - "error":{ - "code":"DBSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBUpgradeDependencyFailureFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB upgrade failed because a resource the DB depends on could not be modified.

", - "error":{ - "code":"DBUpgradeDependencyFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DeleteDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier for the DB cluster to be deleted. This parameter isn't case-sensitive.

Constraints:

  • Must match an existing DBClusterIdentifier.

" - }, - "SkipFinalSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final DB cluster snapshot is created before the DB cluster is deleted. If true is specified, no DB cluster snapshot is created. If false is specified, a DB cluster snapshot is created before the DB cluster is deleted.

You must specify a FinalDBSnapshotIdentifier parameter if SkipFinalSnapshot is false.

Default: false

" - }, - "FinalDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterParameterGroupMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must be the name of an existing DB cluster parameter group.

  • You can't delete a default DB cluster parameter group.

  • Cannot be associated with any DB clusters.

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "DeleteDBClusterSnapshotMessage":{ - "type":"structure", - "required":["DBClusterSnapshotIdentifier"], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "DeleteDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier for the DB instance to be deleted. This parameter isn't case-sensitive.

Constraints:

  • Must match the name of an existing DB instance.

" - }, - "SkipFinalSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted.

Note that when a DB instance is in a failure state and has a status of 'failed', 'incompatible-restore', or 'incompatible-network', it can only be deleted when the SkipFinalSnapshot parameter is set to \"true\".

Specify true when deleting a Read Replica.

The FinalDBSnapshotIdentifier parameter must be specified if SkipFinalSnapshot is false.

Default: false

" - }, - "FinalDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

  • Must be 1 to 255 letters or numbers.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

  • Cannot be specified when deleting a Read Replica.

" - } - }, - "documentation":"

" - }, - "DeleteDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "DeleteDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be the name of an existing DB parameter group

  • You can't delete a default DB parameter group

  • Cannot be associated with any DB instances

" - } - }, - "documentation":"

" - }, - "DeleteDBSubnetGroupMessage":{ - "type":"structure", - "required":["DBSubnetGroupName"], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the database subnet group to delete.

You can't delete the default subnet group.

Constraints:

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event notification subscription you want to delete.

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "DescribeDBClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB cluster parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterParametersMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB cluster parameter group to return parameter details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Source":{ - "shape":"String", - "documentation":"

A value that indicates to return only parameters for a specific source. Parameter sources can be engine, service, or customer.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterSnapshotAttributesMessage":{ - "type":"structure", - "required":["DBClusterSnapshotIdentifier"], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB cluster snapshot to describe the attributes for.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotAttributesResult":{"shape":"DBClusterSnapshotAttributesResult"} - } - }, - "DescribeDBClusterSnapshotsMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The ID of the DB cluster to retrieve the list of DB cluster snapshots for. This parameter can't be used in conjunction with the DBClusterSnapshotIdentifier parameter. This parameter is not case-sensitive.

Constraints:

  • If supplied, must match the identifier of an existing DBCluster.

" - }, - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

A specific DB cluster snapshot identifier to describe. This parameter can't be used in conjunction with the DBClusterIdentifier parameter. This value is stored as a lowercase string.

Constraints:

  • If supplied, must match the identifier of an existing DBClusterSnapshot.

  • If this identifier is for an automated snapshot, the SnapshotType parameter must also be specified.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The type of DB cluster snapshots to be returned. You can specify one of the following values:

  • automated - Return all DB cluster snapshots that have been automatically taken by Amazon Neptune for my AWS account.

  • manual - Return all DB cluster snapshots that have been taken by my AWS account.

  • shared - Return all manual DB cluster snapshots that have been shared to my AWS account.

  • public - Return all DB cluster snapshots that have been marked as public.

If you don't specify a SnapshotType value, then both automated and manual DB cluster snapshots are returned. You can include shared DB cluster snapshots with these results by setting the IncludeShared parameter to true. You can include public DB cluster snapshots with these results by setting the IncludePublic parameter to true.

The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "IncludeShared":{ - "shape":"Boolean", - "documentation":"

True to include shared manual DB cluster snapshots from other AWS accounts that this AWS account has been given permission to copy or restore, and otherwise false. The default is false.

You can give an AWS account permission to restore a manual DB cluster snapshot from another AWS account by the ModifyDBClusterSnapshotAttribute API action.

" - }, - "IncludePublic":{ - "shape":"Boolean", - "documentation":"

True to include manual DB cluster snapshots that are public and can be copied or restored by any AWS account, and otherwise false. The default is false. The default is false.

You can share a manual DB cluster snapshot as public by using the ModifyDBClusterSnapshotAttribute API action.

" - } - }, - "documentation":"

" - }, - "DescribeDBClustersMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied DB cluster identifier. If this parameter is specified, information from only the specific DB cluster is returned. This parameter isn't case-sensitive.

Constraints:

  • If supplied, must match an existing DBClusterIdentifier.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more DB clusters to describe.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB clusters identified by these ARNs.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBEngineVersionsMessage":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The database engine to return.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The database engine version to return.

Example: 5.1.49

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group family to return details for.

Constraints:

  • If supplied, must match an existing DBParameterGroupFamily.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DefaultOnly":{ - "shape":"Boolean", - "documentation":"

Indicates that only the default version of the specified engine or engine and major version combination is returned.

" - }, - "ListSupportedCharacterSets":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is specified and the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.

" - }, - "ListSupportedTimezones":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is specified and the requested engine supports the TimeZone parameter for CreateDBInstance, the response includes a list of supported time zones for each engine version.

" - } - } - }, - "DescribeDBInstancesMessage":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case-sensitive.

Constraints:

  • If supplied, must match the identifier of an existing DBInstance.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more DB instances to describe.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB instances associated with the DB clusters identified by these ARNs.

  • db-instance-id - Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs). The results list will only include information about the DB instances identified by these ARNs.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBParameterGroup.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return.

Default: All parameter types returned

Valid Values: user | system | engine-default

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeDBSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group to return details for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSubnetGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultClusterParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupFamily"], - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group family to return engine parameter information for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEngineDefaultClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultClusterParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "DescribeEngineDefaultParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupFamily"], - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEngineDefaultParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "DescribeEventCategoriesMessage":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event notification subscription you want to describe.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response.

Constraints:

  • If SourceIdentifier is supplied, SourceType must also be provided.

  • If the source type is DBInstance, then a DBInstanceIdentifier must be supplied.

  • If the source type is DBSecurityGroup, a DBSecurityGroupName must be supplied.

  • If the source type is DBParameterGroup, a DBParameterGroupName must be supplied.

  • If the source type is DBSnapshot, a DBSnapshotIdentifier must be supplied.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes to retrieve events for.

Default: 60

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories that trigger notifications for a event notification subscription.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOrderableDBInstanceOptionsMessage":{ - "type":"structure", - "required":["Engine"], - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the engine to retrieve DB instance options for.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.

" - }, - "Vpc":{ - "shape":"BooleanOptional", - "documentation":"

The VPC filter value. Specify this parameter to show only the available VPC or non-VPC offerings.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribePendingMaintenanceActionsMessage":{ - "type":"structure", - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The ARN of a resource to return pending maintenance actions for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more resources to return pending maintenance actions for.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include pending maintenance actions for the DB clusters identified by these ARNs.

  • db-instance-id - Accepts DB instance identifiers and DB instance ARNs. The results list will only include pending maintenance actions for the DB instances identified by these ARNs.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribePendingMaintenanceActions request. If this parameter is specified, the response includes only records beyond the marker, up to a number of records specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - } - }, - "documentation":"

" - }, - "DescribeValidDBInstanceModificationsMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer identifier or the ARN of your DB instance.

" - } - }, - "documentation":"

" - }, - "DescribeValidDBInstanceModificationsResult":{ - "type":"structure", - "members":{ - "ValidDBInstanceModificationsMessage":{"shape":"ValidDBInstanceModificationsMessage"} - } - }, - "DomainMembership":{ - "type":"structure", - "members":{ - "Domain":{ - "shape":"String", - "documentation":"

The identifier of the Active Directory Domain.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB instance's Active Directory Domain membership, such as joined, pending-join, failed etc).

" - }, - "FQDN":{ - "shape":"String", - "documentation":"

The fully qualified domain name of the Active Directory Domain.

" - }, - "IAMRoleName":{ - "shape":"String", - "documentation":"

The name of the IAM role to be used when making API calls to the Directory Service.

" - } - }, - "documentation":"

An Active Directory Domain membership record associated with the DB instance.

" - }, - "DomainMembershipList":{ - "type":"list", - "member":{ - "shape":"DomainMembership", - "locationName":"DomainMembership" - }, - "documentation":"

List of Active Directory Domain membership records associated with a DB instance.

" - }, - "DomainNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Domain does not refer to an existing Active Directory Domain.

", - "error":{ - "code":"DomainNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "Double":{"type":"double"}, - "DoubleOptional":{"type":"double"}, - "DoubleRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Double", - "documentation":"

The minimum value in the range.

" - }, - "To":{ - "shape":"Double", - "documentation":"

The maximum value in the range.

" - } - }, - "documentation":"

A range of double values.

" - }, - "DoubleRangeList":{ - "type":"list", - "member":{ - "shape":"DoubleRange", - "locationName":"DoubleRange" - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

Specifies the DNS address of the DB instance.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the database engine is listening on.

" - }, - "HostedZoneId":{ - "shape":"String", - "documentation":"

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "EngineDefaults":{ - "type":"structure", - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Specifies the name of the DB parameter group family that the engine default parameters apply to.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous EngineDefaults request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Contains a list of engine default parameters.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeEngineDefaultParameters action.

", - "wrapper":true - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

Provides the identifier for the source of the event.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the source type for this event.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Provides the text of this event.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

Specifies the category for the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

Specifies the date and time of the event.

" - }, - "SourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the event.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeEvents action.

" - }, - "EventCategoriesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"EventCategory" - } - }, - "EventCategoriesMap":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The source type that the returned categories belong to

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

The event categories for the specified source type

" - } - }, - "documentation":"

Contains the results of a successful invocation of the DescribeEventCategories action.

", - "wrapper":true - }, - "EventCategoriesMapList":{ - "type":"list", - "member":{ - "shape":"EventCategoriesMap", - "locationName":"EventCategoriesMap" - } - }, - "EventCategoriesMessage":{ - "type":"structure", - "members":{ - "EventCategoriesMapList":{ - "shape":"EventCategoriesMapList", - "documentation":"

A list of EventCategoriesMap data types.

" - } - }, - "documentation":"

Data returned from the DescribeEventCategories action.

" - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventSubscription":{ - "type":"structure", - "members":{ - "CustomerAwsId":{ - "shape":"String", - "documentation":"

The AWS customer account associated with the event notification subscription.

" - }, - "CustSubscriptionId":{ - "shape":"String", - "documentation":"

The event notification subscription Id.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The topic ARN of the event notification subscription.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the event notification subscription.

Constraints:

Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist

The status \"no-permission\" indicates that Neptune no longer has permission to post to the SNS topic. The status \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.

" - }, - "SubscriptionCreationTime":{ - "shape":"String", - "documentation":"

The time the event notification subscription was created.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The source type for the event notification subscription.

" - }, - "SourceIdsList":{ - "shape":"SourceIdsList", - "documentation":"

A list of source IDs for the event notification subscription.

" - }, - "EventCategoriesList":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for the event notification subscription.

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

A Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.

" - }, - "EventSubscriptionArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the event subscription.

" - } - }, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "wrapper":true - }, - "EventSubscriptionQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EventSubscriptionsList":{ - "type":"list", - "member":{ - "shape":"EventSubscription", - "locationName":"EventSubscription" - } - }, - "EventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "EventSubscriptionsList":{ - "shape":"EventSubscriptionsList", - "documentation":"

A list of EventSubscriptions data types.

" - } - }, - "documentation":"

Data returned by the DescribeEventSubscriptions action.

" - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous Events request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of Event instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeEvents action.

" - }, - "FailoverDBClusterMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

A DB cluster identifier to force a failover for. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "TargetDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The name of the instance to promote to the primary instance.

You must specify the instance identifier for an Read Replica in the DB cluster. For example, mydbcluster-replica1.

" - } - }, - "documentation":"

" - }, - "FailoverDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "Filter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

This parameter is not currently supported.

" - }, - "Values":{ - "shape":"FilterValueList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

This type is not currently supported.

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FilterValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Value" - } - }, - "InstanceQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientDBClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB cluster does not have enough capacity for the current operation.

", - "error":{ - "code":"InsufficientDBClusterCapacityFault", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "InsufficientDBInstanceCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientStorageClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is insufficient storage available for the current action. You may be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.

", - "error":{ - "code":"InsufficientStorageClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidDBClusterSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The supplied value is not a valid DB cluster snapshot state.

", - "error":{ - "code":"InvalidDBClusterSnapshotStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBClusterStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB cluster is not in a valid state.

", - "error":{ - "code":"InvalidDBClusterStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBInstanceStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified DB instance is not in the available state.

", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you cannot delete it when the parameter group is in this state.

", - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the DB security group does not allow deletion.

", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the DB snapshot does not allow deletion.

", - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSubnetGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet group cannot be deleted because it is in use.

", - "error":{ - "code":"InvalidDBSubnetGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSubnetStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet is not in the available state.

", - "error":{ - "code":"InvalidDBSubnetStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidEventSubscriptionStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidEventSubscriptionState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidRestoreFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cannot restore from vpc backup to non-vpc DB instance.

", - "error":{ - "code":"InvalidRestoreFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KMSKeyNotAccessibleFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Error accessing KMS key.

", - "error":{ - "code":"KMSKeyNotAccessibleFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceName"], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Neptune resource with tags to be listed. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "LogTypeList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ModifyDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier for the cluster being modified. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "NewDBClusterIdentifier":{ - "shape":"String", - "documentation":"

The new DB cluster identifier for the DB cluster when renaming a DB cluster. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • The first character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-cluster2

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

A value that specifies whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the PreferredMaintenanceWindow setting for the DB cluster. If this parameter is set to false, changes to the DB cluster are applied during the next maintenance window.

The ApplyImmediately parameter only affects the NewDBClusterIdentifier and MasterUserPassword values. If you set the ApplyImmediately parameter value to false, then changes to the NewDBClusterIdentifier and MasterUserPassword values are applied during the next maintenance window. All other changes are applied immediately, regardless of the value of the ApplyImmediately parameter.

Default: false

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

" - }, - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to use for the DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the DB cluster will belong to.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case, and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to which you want to upgrade. Changing this parameter results in an outage. The change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true.

For a list of valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBClusterParameterGroupName", - "Parameters" - ], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to modify.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of parameters in the DB cluster parameter group to modify.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "ModifyDBClusterSnapshotAttributeMessage":{ - "type":"structure", - "required":[ - "DBClusterSnapshotIdentifier", - "AttributeName" - ], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB cluster snapshot to modify the attributes for.

" - }, - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the DB cluster snapshot attribute to modify.

To manage authorization for other AWS accounts to copy or restore a manual DB cluster snapshot, set this value to restore.

" - }, - "ValuesToAdd":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB cluster snapshot attributes to add to the attribute specified by AttributeName.

To authorize other AWS accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more AWS account IDs, or all to make the manual DB cluster snapshot restorable by any AWS account. Do not add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts.

" - }, - "ValuesToRemove":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB cluster snapshot attributes to remove from the attribute specified by AttributeName.

To remove authorization for other AWS accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more AWS account identifiers, or all to remove authorization for any AWS account to copy or restore the DB cluster snapshot. If you specify all, an AWS account whose account ID is explicitly added to the restore attribute can still copy or restore a manual DB cluster snapshot.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotAttributesResult":{"shape":"DBClusterSnapshotAttributesResult"} - } - }, - "ModifyDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The new amount of storage (in gibibytes) to allocate for the DB instance.

Not applicable. Storage is managed by the DB Cluster.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The new compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions.

If you modify the DB instance class, an outage occurs during the change. The change is applied during the next maintenance window, unless ApplyImmediately is specified as true for this request.

Default: Uses existing setting

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The new DB subnet group for the DB instance. You can use this parameter to move your DB instance to a different VPC.

Changing the subnet group causes an outage during the change. The change is applied during the next maintenance window, unless you specify true for the ApplyImmediately parameter.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetGroup

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to authorize on this DB instance. Changing this setting doesn't result in an outage and the change is asynchronously applied as soon as possible.

Constraints:

  • If supplied, must match existing DBSecurityGroups.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to authorize on this DB instance. This change is asynchronously applied as soon as possible.

Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. For more information, see ModifyDBCluster.

Constraints:

  • If supplied, must match existing VpcSecurityGroupIds.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Specifies whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the PreferredMaintenanceWindow setting for the DB instance.

If this parameter is set to false, changes to the DB instance are applied during the next maintenance window. Some parameter changes can cause an outage and are applied on the next call to RebootDBInstance, or the next failure reboot.

Default: false

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Not applicable.

Default: Uses existing setting

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to apply to the DB instance. Changing this setting doesn't result in an outage. The parameter group name itself is changed immediately, but the actual parameter changes are not applied until you reboot the instance without failover. The db instance will NOT be rebooted automatically and the parameter changes will NOT be applied during the next maintenance window.

Default: Uses existing setting

Constraints: The DB parameter group must be in the same DB parameter group family as this DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: Uses existing setting

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled.

Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Constraints:

  • Must be in the format hh24:mi-hh24:mi

  • Must be in Universal Time Coordinated (UTC)

  • Must not conflict with the preferred maintenance window

  • Must be at least 30 minutes

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur, which might result in an outage. Changing this parameter doesn't result in an outage, except in the following situation, and the change is asynchronously applied as soon as possible. If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, then changing this parameter will cause a reboot of the DB instance. If moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure pending changes are applied.

Default: Uses existing setting

Format: ddd:hh24:mi-ddd:hh24:mi

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Must be at least 30 minutes

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. Changing this parameter doesn't result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

For major version upgrades, if a nondefault DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.

" - }, - "AllowMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that major version upgrades are allowed. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible.

Constraints: This parameter must be set to true when specifying a value for the EngineVersion parameter that is a different major version than the DB instance's current version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades are applied automatically to the DB instance during the maintenance window. Changing this parameter doesn't result in an outage except in the following case and the change is asynchronously applied as soon as possible. An outage will result if this parameter is set to true during the maintenance window, and a newer minor version is available, and Neptune has enabled auto patching for that engine version.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for the DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The new Provisioned IOPS (I/O operations per second) value for the instance.

Changing this setting doesn't result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

Default: Uses existing setting

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "NewDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot will occur immediately if you set Apply Immediately to true, or will occur during the next maintenance window if Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • The first character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

If you specify Provisioned IOPS (io1), you must also include a value for the Iops parameter.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance is available for use, but might experience performance degradation. While the migration takes place, nightly backups for the instance are suspended. No other Amazon Neptune operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a Read Replica for the instance, and creating a DB snapshot of the instance.

Valid values: standard | gp2 | io1

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

Indicates the certificate that needs to be associated with the instance.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

Not supported.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

" - }, - "DBPortNumber":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

The value of the DBPortNumber parameter must not match any of the port values specified for options in the option group for the DB instance.

Your database will restart when you change the DBPortNumber value regardless of the value of the ApplyImmediately parameter.

Default: 8182

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

This parameter is not supported.

", - "deprecated":true - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits Neptune to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

Not supported

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which a Read Replica is promoted to the primary instance after a failure of the existing primary instance.

Default: 1

Valid Values: 0 - 15

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines

Not applicable. Mapping AWS IAM accounts to database accounts is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: false

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the DB instance, and otherwise false.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "CloudwatchLogsExportConfiguration":{ - "shape":"CloudwatchLogsExportConfiguration", - "documentation":"

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance or DB cluster.

" - } - }, - "documentation":"

" - }, - "ModifyDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "ModifyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "Parameters" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • If supplied, must match the name of an existing DBParameterGroup.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters can be modified in a single request.

Valid Values (for the application method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when you reboot the DB instance without failover.

" - } - }, - "documentation":"

" - }, - "ModifyDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string. You can't modify the default subnet group.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the DB subnet group.

" - } - }, - "documentation":"

" - }, - "ModifyDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "ModifyEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event notification subscription.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType by using the DescribeEventCategories action.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription.

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "OptionGroupMembership":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group that the instance belongs to.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB instance's option group membership. Valid values are: in-sync, pending-apply, pending-removal, pending-maintenance-apply, pending-maintenance-removal, applying, removing, and failed.

" - } - }, - "documentation":"

Provides information on the option groups the DB instance is a member of.

" - }, - "OptionGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"OptionGroupMembership", - "locationName":"OptionGroupMembership" - } - }, - "OptionGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "OrderableDBInstanceOption":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The engine type of a DB instance.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version of a DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for a DB instance.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for a DB instance.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

A list of Availability Zones for a DB instance.

" - }, - "MultiAZCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance is Multi-AZ capable.

" - }, - "ReadReplicaCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance can have a Read Replica.

" - }, - "Vpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance is in a VPC.

" - }, - "SupportsStorageEncryption":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports encrypted storage.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Indicates the storage type for a DB instance.

" - }, - "SupportsIops":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports provisioned IOPS.

" - }, - "SupportsEnhancedMonitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports Enhanced Monitoring at intervals from 1 to 60 seconds.

" - }, - "SupportsIAMDatabaseAuthentication":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports IAM database authentication.

" - }, - "SupportsPerformanceInsights":{ - "shape":"Boolean", - "documentation":"

True if a DB instance supports Performance Insights, otherwise false.

" - }, - "MinStorageSize":{ - "shape":"IntegerOptional", - "documentation":"

Minimum storage size for a DB instance.

" - }, - "MaxStorageSize":{ - "shape":"IntegerOptional", - "documentation":"

Maximum storage size for a DB instance.

" - }, - "MinIopsPerDbInstance":{ - "shape":"IntegerOptional", - "documentation":"

Minimum total provisioned IOPS for a DB instance.

" - }, - "MaxIopsPerDbInstance":{ - "shape":"IntegerOptional", - "documentation":"

Maximum total provisioned IOPS for a DB instance.

" - }, - "MinIopsPerGib":{ - "shape":"DoubleOptional", - "documentation":"

Minimum provisioned IOPS per GiB for a DB instance.

" - }, - "MaxIopsPerGib":{ - "shape":"DoubleOptional", - "documentation":"

Maximum provisioned IOPS per GiB for a DB instance.

" - } - }, - "documentation":"

Contains a list of available options for a DB instance.

This data type is used as a response element in the DescribeOrderableDBInstanceOptions action.

", - "wrapper":true - }, - "OrderableDBInstanceOptionsList":{ - "type":"list", - "member":{ - "shape":"OrderableDBInstanceOption", - "locationName":"OrderableDBInstanceOption" - } - }, - "OrderableDBInstanceOptionsMessage":{ - "type":"structure", - "members":{ - "OrderableDBInstanceOptions":{ - "shape":"OrderableDBInstanceOptionsList", - "documentation":"

An OrderableDBInstanceOption structure containing information about orderable options for the DB instance.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous OrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeOrderableDBInstanceOptions action.

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

Specifies the name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

Specifies the value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides a description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

Indicates the source of the parameter value.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

Specifies the engine specific parameters type.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

Specifies the valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

Specifies the valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest engine version to which the parameter can apply.

" - }, - "ApplyMethod":{ - "shape":"ApplyMethod", - "documentation":"

Indicates when to apply parameter updates.

" - } - }, - "documentation":"

This data type is used as a request parameter in the ModifyDBParameterGroup and ResetDBParameterGroup actions.

This data type is used as a response element in the DescribeEngineDefaultParameters and DescribeDBParameters actions.

" - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingCloudwatchLogsExports":{ - "type":"structure", - "members":{ - "LogTypesToEnable":{ - "shape":"LogTypeList", - "documentation":"

Log types that are in the process of being deactivated. After they are deactivated, these log types aren't exported to CloudWatch Logs.

" - }, - "LogTypesToDisable":{ - "shape":"LogTypeList", - "documentation":"

Log types that are in the process of being enabled. After they are enabled, these log types are exported to CloudWatch Logs.

" - } - }, - "documentation":"

A list of the log types whose configuration is still pending. In other words, these log types are in the process of being activated or deactivated.

" - }, - "PendingMaintenanceAction":{ - "type":"structure", - "members":{ - "Action":{ - "shape":"String", - "documentation":"

The type of pending maintenance action that is available for the resource.

" - }, - "AutoAppliedAfterDate":{ - "shape":"TStamp", - "documentation":"

The date of the maintenance window when the action is applied. The maintenance action is applied to the resource during its first maintenance window after this date. If this date is specified, any next-maintenance opt-in requests are ignored.

" - }, - "ForcedApplyDate":{ - "shape":"TStamp", - "documentation":"

The date when the maintenance action is automatically applied. The maintenance action is applied to the resource on this date regardless of the maintenance window for the resource. If this date is specified, any immediate opt-in requests are ignored.

" - }, - "OptInStatus":{ - "shape":"String", - "documentation":"

Indicates the type of opt-in request that has been received for the resource.

" - }, - "CurrentApplyDate":{ - "shape":"TStamp", - "documentation":"

The effective date when the pending maintenance action is applied to the resource. This date takes into account opt-in requests received from the ApplyPendingMaintenanceAction API, the AutoAppliedAfterDate, and the ForcedApplyDate. This value is blank if an opt-in request has not been received and nothing has been specified as AutoAppliedAfterDate or ForcedApplyDate.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description providing more detail about the maintenance action.

" - } - }, - "documentation":"

Provides information about a pending maintenance action for a resource.

" - }, - "PendingMaintenanceActionDetails":{ - "type":"list", - "member":{ - "shape":"PendingMaintenanceAction", - "locationName":"PendingMaintenanceAction" - } - }, - "PendingMaintenanceActions":{ - "type":"list", - "member":{ - "shape":"ResourcePendingMaintenanceActions", - "locationName":"ResourcePendingMaintenanceActions" - } - }, - "PendingMaintenanceActionsMessage":{ - "type":"structure", - "members":{ - "PendingMaintenanceActions":{ - "shape":"PendingMaintenanceActions", - "documentation":"

A list of the pending maintenance actions for the resource.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribePendingMaintenanceActions request. If this parameter is specified, the response includes only records beyond the marker, up to a number of records specified by MaxRecords.

" - } - }, - "documentation":"

Data returned from the DescribePendingMaintenanceActions action.

" - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceClass for the DB instance that will be applied or is currently being applied.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

Contains the new AllocatedStorage size for the DB instance that will be applied or is currently being applied.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

Contains the pending or currently-in-progress change of the master credentials for the DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending port for the DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending number of days for which automated backups are retained.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that the Single-AZ DB instance is to change to a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for the DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the new Provisioned IOPS value for the DB instance that will be applied or is currently being applied.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceIdentifier for the DB instance that will be applied or is currently being applied.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier of the CA certificate for the DB instance.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The new DB subnet group for the DB instance.

" - }, - "PendingCloudwatchLogsExports":{"shape":"PendingCloudwatchLogsExports"} - }, - "documentation":"

This data type is used as a response element in the ModifyDBInstance action.

" - }, - "PromoteReadReplicaDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster Read Replica to promote. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster Read Replica.

Example: my-cluster-replica1

" - } - }, - "documentation":"

" - }, - "PromoteReadReplicaDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "ProvisionedIopsNotAvailableInAZFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Range":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The minimum value in the range.

" - }, - "To":{ - "shape":"Integer", - "documentation":"

The maximum value in the range.

" - }, - "Step":{ - "shape":"IntegerOptional", - "documentation":"

The step value for the range. For example, if you have a range of 5,000 to 10,000, with a step value of 1,000, the valid values start at 5,000 and step up by 1,000. Even though 7,500 is within the range, it isn't a valid value for the range. The valid values are 5,000, 6,000, 7,000, 8,000...

" - } - }, - "documentation":"

A range of integer values.

" - }, - "RangeList":{ - "type":"list", - "member":{ - "shape":"Range", - "locationName":"Range" - } - }, - "ReadReplicaDBClusterIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaDBClusterIdentifier" - } - }, - "ReadReplicaDBInstanceIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaDBInstanceIdentifier" - } - }, - "ReadReplicaIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaIdentifier" - } - }, - "RebootDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "ForceFailover":{ - "shape":"BooleanOptional", - "documentation":"

When true, the reboot is conducted through a MultiAZ failover.

Constraint: You can't specify true if the instance is not configured for MultiAZ.

" - } - }, - "documentation":"

" - }, - "RebootDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RemoveRoleFromDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "RoleArn" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to disassociate the IAM role from.

" - }, - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to disassociate from the DB cluster, for example arn:aws:iam::123456789012:role/NeptuneAccessRole.

" - } - } - }, - "RemoveSourceIdentifierFromSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event notification subscription you want to remove a source identifier from.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The source identifier to be removed from the subscription, such as the DB instance identifier for a DB instance or the name of a security group.

" - } - }, - "documentation":"

" - }, - "RemoveSourceIdentifierFromSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "RemoveTagsFromResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Neptune resource that the tags are removed from. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an Amazon Resource Name (ARN).

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

The tag key (name) of the tag to be removed.

" - } - }, - "documentation":"

" - }, - "ResetDBClusterParameterGroupMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to reset.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

A value that is set to true to reset all parameters in the DB cluster parameter group to their default values, and false otherwise. You can't use this parameter if there is a list of parameter names specified for the Parameters parameter.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of parameter names in the DB cluster parameter group to reset to the default values. You can't use this parameter if the ResetAllParameters parameter is set to true.

" - } - }, - "documentation":"

" - }, - "ResetDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must match the name of an existing DBParameterGroup.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) to reset all parameters in the DB parameter group to default values.

Default: true

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Valid Values (for Apply method): pending-reboot

" - } - }, - "documentation":"

" - }, - "ResourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource ID was not found.

", - "error":{ - "code":"ResourceNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ResourcePendingMaintenanceActions":{ - "type":"structure", - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The ARN of the resource that has pending maintenance actions.

" - }, - "PendingMaintenanceActionDetails":{ - "shape":"PendingMaintenanceActionDetails", - "documentation":"

A list that provides details about the pending maintenance actions for the resource.

" - } - }, - "documentation":"

Describes the pending maintenance actions for a resource.

", - "wrapper":true - }, - "RestoreDBClusterFromSnapshotMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "SnapshotIdentifier", - "Engine" - ], - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the restored DB cluster can be created in.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to create from the DB snapshot or DB cluster snapshot. This parameter isn't case-sensitive.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot or DB cluster snapshot to restore from.

You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot.

Constraints:

  • Must match the identifier of an existing Snapshot.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new DB cluster.

Default: The same as source

Constraint: Must be compatible with the engine of the source

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the database engine to use for the new DB cluster.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the new DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The database name for the restored DB cluster.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to use for the restored DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the new DB cluster will belong to.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the restored DB cluster.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier to use when restoring an encrypted DB cluster from a DB snapshot or DB cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

  • If the DB snapshot or DB cluster snapshot in SnapshotIdentifier is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the DB snapshot or DB cluster snapshot.

  • If the DB snapshot or DB cluster snapshot in SnapshotIdentifier is not encrypted, then the restored DB cluster is not encrypted.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - } - }, - "documentation":"

" - }, - "RestoreDBClusterFromSnapshotResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "RestoreDBClusterToPointInTimeMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "SourceDBClusterIdentifier" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the new DB cluster to be created.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "RestoreType":{ - "shape":"String", - "documentation":"

The type of restore to be performed. You can specify one of the following values:

  • full-copy - The new DB cluster is restored as a full copy of the source DB cluster.

  • copy-on-write - The new DB cluster is restored as a clone of the source DB cluster.

Constraints: You can't specify copy-on-write if the engine version of the source DB cluster is earlier than 1.11.

If you don't specify a RestoreType value, then the new DB cluster is restored as a full copy of the source DB cluster.

" - }, - "SourceDBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the source DB cluster from which to restore.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "RestoreToTime":{ - "shape":"TStamp", - "documentation":"

The date and time to restore the DB cluster to.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

  • Must be before the latest restorable time for the DB instance

  • Must be specified if UseLatestRestorableTime parameter is not provided

  • Cannot be specified if UseLatestRestorableTime parameter is true

  • Cannot be specified if RestoreType parameter is copy-on-write

Example: 2015-03-07T23:45:00Z

" - }, - "UseLatestRestorableTime":{ - "shape":"Boolean", - "documentation":"

A value that is set to true to restore the DB cluster to the latest restorable backup time, and false otherwise.

Default: false

Constraints: Cannot be specified if RestoreToTime parameter is provided.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the new DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group for the new DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the new DB cluster belongs to.

" - }, - "Tags":{"shape":"TagList"}, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier to use when restoring an encrypted DB cluster from an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new DB cluster and encrypt the new DB cluster with a KMS key that is different than the KMS key used to encrypt the source DB cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

  • If the DB cluster is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the source DB cluster.

  • If the DB cluster is not encrypted, then the restored DB cluster is not encrypted.

If DBClusterIdentifier refers to a DB cluster that is not encrypted, then the restore request is rejected.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - } - }, - "documentation":"

" - }, - "RestoreDBClusterToPointInTimeResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "SNSInvalidTopicFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSNoAuthorizationFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSTopicArnNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SharedSnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.

", - "error":{ - "code":"SharedSnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed number of DB snapshots.

", - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SourceIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SourceId" - } - }, - "SourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SourceType":{ - "type":"string", - "enum":[ - "db-instance", - "db-parameter-group", - "db-security-group", - "db-snapshot", - "db-cluster", - "db-cluster-snapshot" - ] - }, - "StorageQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "StorageTypeNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier of the subnet.

" - }, - "SubnetAvailabilityZone":{"shape":"AvailabilityZone"}, - "SubnetStatus":{ - "shape":"String", - "documentation":"

Specifies the status of the subnet.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBSubnetGroups action.

" - }, - "SubnetAlreadyInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet is already in use in the Availability Zone.

", - "error":{ - "code":"SubnetAlreadyInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "SubscriptionAlreadyExistFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionAlreadyExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubscriptionCategoryNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SubscriptionNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SupportedCharacterSetsList":{ - "type":"list", - "member":{ - "shape":"CharacterSet", - "locationName":"CharacterSet" - } - }, - "SupportedTimezonesList":{ - "type":"list", - "member":{ - "shape":"Timezone", - "locationName":"Timezone" - } - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with \"aws:\" or \"rds:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - }, - "Value":{ - "shape":"String", - "documentation":"

A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with \"aws:\" or \"rds:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - } - }, - "documentation":"

Metadata assigned to an Amazon Neptune resource consisting of a key-value pair.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - }, - "documentation":"

A list of tags. For more information, see Tagging Amazon Neptune Resources.

" - }, - "TagListMessage":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

List of tags returned by the ListTagsForResource operation.

" - } - }, - "documentation":"

" - }, - "Timezone":{ - "type":"structure", - "members":{ - "TimezoneName":{ - "shape":"String", - "documentation":"

The name of the time zone.

" - } - }, - "documentation":"

A time zone associated with a DBInstance. This data type is an element in the response to the DescribeDBInstances, and the DescribeDBEngineVersions actions.

" - }, - "UpgradeTarget":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the upgrade target database engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the upgrade target database engine.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The version of the database engine that a DB instance can be upgraded to.

" - }, - "AutoUpgrade":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether the target version is applied to any source DB instances that have AutoMinorVersionUpgrade set to true.

" - }, - "IsMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether a database engine is upgraded to a major version.

" - } - }, - "documentation":"

The version of the database engine that a DB instance can be upgraded to.

" - }, - "ValidDBInstanceModificationsMessage":{ - "type":"structure", - "members":{ - "Storage":{ - "shape":"ValidStorageOptionsList", - "documentation":"

Valid storage options for your DB instance.

" - } - }, - "documentation":"

Information about valid modifications that you can make to your DB instance. Contains the result of a successful call to the DescribeValidDBInstanceModifications action. You can use this information when you call ModifyDBInstance.

", - "wrapper":true - }, - "ValidStorageOptions":{ - "type":"structure", - "members":{ - "StorageType":{ - "shape":"String", - "documentation":"

The valid storage types for your DB instance. For example, gp2, io1.

" - }, - "StorageSize":{ - "shape":"RangeList", - "documentation":"

The valid range of storage in gibibytes. For example, 100 to 16384.

" - }, - "ProvisionedIops":{ - "shape":"RangeList", - "documentation":"

The valid range of provisioned IOPS. For example, 1000-20000.

" - }, - "IopsToStorageRatio":{ - "shape":"DoubleRangeList", - "documentation":"

The valid range of Provisioned IOPS to gibibytes of storage multiplier. For example, 3-10, which means that provisioned IOPS can be between 3 and 10 times storage.

" - } - }, - "documentation":"

Information about valid modifications that you can make to your DB instance. Contains the result of a successful call to the DescribeValidDBInstanceModifications action.

" - }, - "ValidStorageOptionsList":{ - "type":"list", - "member":{ - "shape":"ValidStorageOptions", - "locationName":"ValidStorageOptions" - } - }, - "ValidUpgradeTargetList":{ - "type":"list", - "member":{ - "shape":"UpgradeTarget", - "locationName":"UpgradeTarget" - } - }, - "VpcSecurityGroupIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcSecurityGroupId" - } - }, - "VpcSecurityGroupMembership":{ - "type":"structure", - "members":{ - "VpcSecurityGroupId":{ - "shape":"String", - "documentation":"

The name of the VPC security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the VPC security group.

" - } - }, - "documentation":"

This data type is used as a response element for queries on VPC security group membership.

" - }, - "VpcSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"VpcSecurityGroupMembership", - "locationName":"VpcSecurityGroupMembership" - } - } - }, - "documentation":"Amazon Neptune

Amazon Neptune is a fast, reliable, fully-managed graph database service that makes it easy to build and run applications that work with highly connected datasets. The core of Amazon Neptune is a purpose-built, high-performance graph database engine optimized for storing billions of relationships and querying the graph with milliseconds latency. Amazon Neptune supports popular graph models Property Graph and W3C's RDF, and their respective query languages Apache TinkerPop Gremlin and SPARQL, allowing you to easily build queries that efficiently navigate highly connected datasets. Neptune powers graph use cases such as recommendation engines, fraud detection, knowledge graphs, drug discovery, and network security.

This interface reference for Amazon Neptune contains documentation for a programming or command line interface you can use to manage Amazon Neptune. Note that Amazon Neptune is asynchronous, which means that some interfaces might require techniques such as polling or callback functions to determine when a command has been applied. In this reference, the parameter descriptions indicate whether a command is applied immediately, on the next instance reboot, or during the maintenance window. The reference structure is as follows, and we list following some related topics from the user guide.

Amazon Neptune API Reference

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/waiters-2.json deleted file mode 100644 index e75f03b2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/neptune/2014-10-31/waiters-2.json +++ /dev/null @@ -1,90 +0,0 @@ -{ - "version": 2, - "waiters": { - "DBInstanceAvailable": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-restore", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-parameters", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - }, - "DBInstanceDeleted": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "DBInstanceNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "resetting-master-credentials", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/paginators-1.json deleted file mode 100644 index 77936158..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "DescribeEcsClusters": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "EcsClusters" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/service-2.json deleted file mode 100644 index a6f2ba97..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/service-2.json +++ /dev/null @@ -1,4965 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-02-18", - "endpointPrefix":"opsworks", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS OpsWorks", - "serviceId":"OpsWorks", - "signatureVersion":"v4", - "targetPrefix":"OpsWorks_20130218", - "uid":"opsworks-2013-02-18" - }, - "operations":{ - "AssignInstance":{ - "name":"AssignInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Assign a registered instance to a layer.

  • You can assign registered on-premises instances to any layer type.

  • You can assign registered Amazon EC2 instances only to custom layers.

  • You cannot use this action with instances that were created with AWS OpsWorks Stacks.

Required Permissions: To use this action, an AWS Identity and Access Management (IAM) user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "AssignVolume":{ - "name":"AssignVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssignVolumeRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Assigns one of the stack's registered Amazon EBS volumes to a specified instance. The volume must first be registered with the stack by calling RegisterVolume. After you register the volume, you must call UpdateVolume to specify a mount point before calling AssignVolume. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "AssociateElasticIp":{ - "name":"AssociateElasticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateElasticIpRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Associates one of the stack's registered Elastic IP addresses with a specified instance. The address must first be registered with the stack by calling RegisterElasticIp. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "AttachElasticLoadBalancer":{ - "name":"AttachElasticLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachElasticLoadBalancerRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Attaches an Elastic Load Balancing load balancer to a specified layer. AWS OpsWorks Stacks does not support Application Load Balancer. You can only use Classic Load Balancer with AWS OpsWorks Stacks. For more information, see Elastic Load Balancing.

You must create the Elastic Load Balancing instance separately, by using the Elastic Load Balancing console, API, or CLI. For more information, see Elastic Load Balancing Developer Guide.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "CloneStack":{ - "name":"CloneStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CloneStackRequest"}, - "output":{"shape":"CloneStackResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a clone of a specified stack. For more information, see Clone a Stack. By default, all parameters are set to the values used by the parent stack.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "CreateApp":{ - "name":"CreateApp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAppRequest"}, - "output":{"shape":"CreateAppResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates an app for a specified stack. For more information, see Creating Apps.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "CreateDeployment":{ - "name":"CreateDeployment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDeploymentRequest"}, - "output":{"shape":"CreateDeploymentResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Runs deployment or stack commands. For more information, see Deploying Apps and Run Stack Commands.

Required Permissions: To use this action, an IAM user must have a Deploy or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "CreateInstance":{ - "name":"CreateInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateInstanceRequest"}, - "output":{"shape":"CreateInstanceResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates an instance in a specified stack. For more information, see Adding an Instance to a Layer.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "CreateLayer":{ - "name":"CreateLayer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateLayerRequest"}, - "output":{"shape":"CreateLayerResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Creates a layer. For more information, see How to Create a Layer.

You should use CreateLayer for noncustom layer types such as PHP App Server only if the stack does not have an existing layer of that type. A stack can have at most one instance of each noncustom layer; if you attempt to create a second instance, CreateLayer fails. A stack can have an arbitrary number of custom layers, so you can call CreateLayer as many times as you like for that layer type.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "CreateStack":{ - "name":"CreateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStackRequest"}, - "output":{"shape":"CreateStackResult"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Creates a new stack. For more information, see Create a New Stack.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "CreateUserProfile":{ - "name":"CreateUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserProfileRequest"}, - "output":{"shape":"CreateUserProfileResult"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Creates a new user profile.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DeleteApp":{ - "name":"DeleteApp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAppRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a specified app.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeleteInstance":{ - "name":"DeleteInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a specified instance, which terminates the associated Amazon EC2 instance. You must stop an instance before you can delete it.

For more information, see Deleting Instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeleteLayer":{ - "name":"DeleteLayer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteLayerRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a specified layer. You must first stop and then delete all associated instances or unassign registered instances. For more information, see How to Delete a Layer.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeleteStack":{ - "name":"DeleteStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStackRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a specified stack. You must first delete all instances, layers, and apps or deregister registered instances. For more information, see Shut Down a Stack.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeleteUserProfile":{ - "name":"DeleteUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserProfileRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes a user profile.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DeregisterEcsCluster":{ - "name":"DeregisterEcsCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterEcsClusterRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deregisters a specified Amazon ECS cluster from a stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html.

" - }, - "DeregisterElasticIp":{ - "name":"DeregisterElasticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterElasticIpRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deregisters a specified Elastic IP address. The address can then be registered by another stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeregisterInstance":{ - "name":"DeregisterInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deregister a registered Amazon EC2 or on-premises instance. This action removes the instance from the stack and returns it to your control. This action cannot be used with instances that were created with AWS OpsWorks Stacks.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeregisterRdsDbInstance":{ - "name":"DeregisterRdsDbInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterRdsDbInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deregisters an Amazon RDS instance.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DeregisterVolume":{ - "name":"DeregisterVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterVolumeRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deregisters an Amazon EBS volume. The volume can then be registered by another stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DescribeAgentVersions":{ - "name":"DescribeAgentVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAgentVersionsRequest"}, - "output":{"shape":"DescribeAgentVersionsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the available AWS OpsWorks Stacks agent versions. You must specify a stack ID or a configuration manager. DescribeAgentVersions returns a list of available agent versions for the specified stack or configuration manager.

" - }, - "DescribeApps":{ - "name":"DescribeApps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAppsRequest"}, - "output":{"shape":"DescribeAppsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of a specified set of apps.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeCommands":{ - "name":"DescribeCommands", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCommandsRequest"}, - "output":{"shape":"DescribeCommandsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the results of specified commands.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeDeployments":{ - "name":"DescribeDeployments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDeploymentsRequest"}, - "output":{"shape":"DescribeDeploymentsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of a specified set of deployments.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeEcsClusters":{ - "name":"DescribeEcsClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEcsClustersRequest"}, - "output":{"shape":"DescribeEcsClustersResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes Amazon ECS clusters that are registered with a stack. If you specify only a stack ID, you can use the MaxResults and NextToken parameters to paginate the response. However, AWS OpsWorks Stacks currently supports only one cluster per layer, so the result set has a maximum of one element.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack or an attached policy that explicitly grants permission. For more information about user permissions, see Managing User Permissions.

This call accepts only one resource-identifying parameter.

" - }, - "DescribeElasticIps":{ - "name":"DescribeElasticIps", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeElasticIpsRequest"}, - "output":{"shape":"DescribeElasticIpsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes Elastic IP addresses.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeElasticLoadBalancers":{ - "name":"DescribeElasticLoadBalancers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeElasticLoadBalancersRequest"}, - "output":{"shape":"DescribeElasticLoadBalancersResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes a stack's Elastic Load Balancing instances.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeInstances":{ - "name":"DescribeInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancesRequest"}, - "output":{"shape":"DescribeInstancesResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of a set of instances.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeLayers":{ - "name":"DescribeLayers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLayersRequest"}, - "output":{"shape":"DescribeLayersResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of one or more layers in a specified stack.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeLoadBasedAutoScaling":{ - "name":"DescribeLoadBasedAutoScaling", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoadBasedAutoScalingRequest"}, - "output":{"shape":"DescribeLoadBasedAutoScalingResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes load-based auto scaling configurations for specified layers.

You must specify at least one of the parameters.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeMyUserProfile":{ - "name":"DescribeMyUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"DescribeMyUserProfileResult"}, - "documentation":"

Describes a user's SSH information.

Required Permissions: To use this action, an IAM user must have self-management enabled or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeOperatingSystems":{ - "name":"DescribeOperatingSystems", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"DescribeOperatingSystemsResponse"}, - "documentation":"

Describes the operating systems that are supported by AWS OpsWorks Stacks.

" - }, - "DescribePermissions":{ - "name":"DescribePermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePermissionsRequest"}, - "output":{"shape":"DescribePermissionsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the permissions for a specified stack.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DescribeRaidArrays":{ - "name":"DescribeRaidArrays", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRaidArraysRequest"}, - "output":{"shape":"DescribeRaidArraysResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describe an instance's RAID arrays.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeRdsDbInstances":{ - "name":"DescribeRdsDbInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRdsDbInstancesRequest"}, - "output":{"shape":"DescribeRdsDbInstancesResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes Amazon RDS instances.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

This call accepts only one resource-identifying parameter.

" - }, - "DescribeServiceErrors":{ - "name":"DescribeServiceErrors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServiceErrorsRequest"}, - "output":{"shape":"DescribeServiceErrorsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes AWS OpsWorks Stacks service errors.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

This call accepts only one resource-identifying parameter.

" - }, - "DescribeStackProvisioningParameters":{ - "name":"DescribeStackProvisioningParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackProvisioningParametersRequest"}, - "output":{"shape":"DescribeStackProvisioningParametersResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of a stack's provisioning parameters.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeStackSummary":{ - "name":"DescribeStackSummary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStackSummaryRequest"}, - "output":{"shape":"DescribeStackSummaryResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the number of layers and apps in a specified stack, and the number of instances in each state, such as running_setup or online.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeStacks":{ - "name":"DescribeStacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStacksRequest"}, - "output":{"shape":"DescribeStacksResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests a description of one or more stacks.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeTimeBasedAutoScaling":{ - "name":"DescribeTimeBasedAutoScaling", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTimeBasedAutoScalingRequest"}, - "output":{"shape":"DescribeTimeBasedAutoScalingResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes time-based auto scaling configurations for specified instances.

You must specify at least one of the parameters.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeUserProfiles":{ - "name":"DescribeUserProfiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserProfilesRequest"}, - "output":{"shape":"DescribeUserProfilesResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describe specified users.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DescribeVolumes":{ - "name":"DescribeVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVolumesRequest"}, - "output":{"shape":"DescribeVolumesResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes an instance's Amazon EBS volumes.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "DetachElasticLoadBalancer":{ - "name":"DetachElasticLoadBalancer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachElasticLoadBalancerRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Detaches a specified Elastic Load Balancing instance from its layer.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "DisassociateElasticIp":{ - "name":"DisassociateElasticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateElasticIpRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociates an Elastic IP address from its instance. The address remains registered with the stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "GetHostnameSuggestion":{ - "name":"GetHostnameSuggestion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetHostnameSuggestionRequest"}, - "output":{"shape":"GetHostnameSuggestionResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets a generated host name for the specified layer, based on the current host name theme.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "GrantAccess":{ - "name":"GrantAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GrantAccessRequest"}, - "output":{"shape":"GrantAccessResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

This action can be used only with Windows stacks.

Grants RDP access to a Windows instance for a specified time period.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsRequest"}, - "output":{"shape":"ListTagsResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns a list of tags that are applied to the specified stack or layer.

" - }, - "RebootInstance":{ - "name":"RebootInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Reboots a specified instance. For more information, see Starting, Stopping, and Rebooting Instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "RegisterEcsCluster":{ - "name":"RegisterEcsCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterEcsClusterRequest"}, - "output":{"shape":"RegisterEcsClusterResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers a specified Amazon ECS cluster with a stack. You can register only one cluster with a stack. A cluster can be registered with only one stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "RegisterElasticIp":{ - "name":"RegisterElasticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterElasticIpRequest"}, - "output":{"shape":"RegisterElasticIpResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers an Elastic IP address with a specified stack. An address can be registered with only one stack at a time. If the address is already registered, you must first deregister it by calling DeregisterElasticIp. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "RegisterInstance":{ - "name":"RegisterInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterInstanceRequest"}, - "output":{"shape":"RegisterInstanceResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers instances that were created outside of AWS OpsWorks Stacks with a specified stack.

We do not recommend using this action to register instances. The complete registration operation includes two tasks: installing the AWS OpsWorks Stacks agent on the instance, and registering the instance with the stack. RegisterInstance handles only the second step. You should instead use the AWS CLI register command, which performs the entire registration operation. For more information, see Registering an Instance with an AWS OpsWorks Stacks Stack.

Registered instances have the same requirements as instances that are created by using the CreateInstance API. For example, registered instances must be running a supported Linux-based operating system, and they must have a supported instance type. For more information about requirements for instances that you want to register, see Preparing the Instance.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "RegisterRdsDbInstance":{ - "name":"RegisterRdsDbInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterRdsDbInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers an Amazon RDS instance with a stack.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "RegisterVolume":{ - "name":"RegisterVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterVolumeRequest"}, - "output":{"shape":"RegisterVolumeResult"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Registers an Amazon EBS volume with a specified stack. A volume can be registered with only one stack at a time. If the volume is already registered, you must first deregister it by calling DeregisterVolume. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "SetLoadBasedAutoScaling":{ - "name":"SetLoadBasedAutoScaling", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetLoadBasedAutoScalingRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Specify the load-based auto scaling configuration for a specified layer. For more information, see Managing Load with Time-based and Load-based Instances.

To use load-based auto scaling, you must create a set of load-based auto scaling instances. Load-based auto scaling operates only on the instances from that set, so you must ensure that you have created enough instances to handle the maximum anticipated load.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "SetPermission":{ - "name":"SetPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetPermissionRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Specifies a user's permissions. For more information, see Security and Permissions.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "SetTimeBasedAutoScaling":{ - "name":"SetTimeBasedAutoScaling", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetTimeBasedAutoScalingRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Specify the time-based auto scaling configuration for a specified instance. For more information, see Managing Load with Time-based and Load-based Instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "StartInstance":{ - "name":"StartInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Starts a specified instance. For more information, see Starting, Stopping, and Rebooting Instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "StartStack":{ - "name":"StartStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartStackRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Starts a stack's instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "StopInstance":{ - "name":"StopInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Stops a specified instance. When you stop a standard instance, the data disappears and must be reinstalled when you restart the instance. You can stop an Amazon EBS-backed instance without losing data. For more information, see Starting, Stopping, and Rebooting Instances.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "StopStack":{ - "name":"StopStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopStackRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Stops a specified stack.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Apply cost-allocation tags to a specified stack or layer in AWS OpsWorks Stacks. For more information about how tagging works, see Tags in the AWS OpsWorks User Guide.

" - }, - "UnassignInstance":{ - "name":"UnassignInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Unassigns a registered instance from all layers that are using the instance. The instance remains in the stack as an unassigned instance, and can be assigned to another layer as needed. You cannot use this action with instances that were created with AWS OpsWorks Stacks.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "UnassignVolume":{ - "name":"UnassignVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnassignVolumeRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Unassigns an assigned Amazon EBS volume. The volume remains registered with the stack. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes tags from a specified stack or layer.

" - }, - "UpdateApp":{ - "name":"UpdateApp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAppRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a specified app.

Required Permissions: To use this action, an IAM user must have a Deploy or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateElasticIp":{ - "name":"UpdateElasticIp", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateElasticIpRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a registered Elastic IP address's name. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateInstance":{ - "name":"UpdateInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a specified instance.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateLayer":{ - "name":"UpdateLayer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateLayerRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a specified layer.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateMyUserProfile":{ - "name":"UpdateMyUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMyUserProfileRequest"}, - "errors":[ - {"shape":"ValidationException"} - ], - "documentation":"

Updates a user's SSH public key.

Required Permissions: To use this action, an IAM user must have self-management enabled or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "UpdateRdsDbInstance":{ - "name":"UpdateRdsDbInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRdsDbInstanceRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates an Amazon RDS instance.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateStack":{ - "name":"UpdateStack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStackRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a specified stack.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - }, - "UpdateUserProfile":{ - "name":"UpdateUserProfile", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateUserProfileRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates a specified user profile.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

" - }, - "UpdateVolume":{ - "name":"UpdateVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateVolumeRequest"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates an Amazon EBS volume's name or mount point. For more information, see Resource Management.

Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

" - } - }, - "shapes":{ - "AgentVersion":{ - "type":"structure", - "members":{ - "Version":{ - "shape":"String", - "documentation":"

The agent version.

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager.

" - } - }, - "documentation":"

Describes an agent version.

" - }, - "AgentVersions":{ - "type":"list", - "member":{"shape":"AgentVersion"} - }, - "App":{ - "type":"structure", - "members":{ - "AppId":{ - "shape":"String", - "documentation":"

The app ID.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The app stack ID.

" - }, - "Shortname":{ - "shape":"String", - "documentation":"

The app's short name.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The app name.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the app.

" - }, - "DataSources":{ - "shape":"DataSources", - "documentation":"

The app's data sources.

" - }, - "Type":{ - "shape":"AppType", - "documentation":"

The app type.

" - }, - "AppSource":{ - "shape":"Source", - "documentation":"

A Source object that describes the app repository.

" - }, - "Domains":{ - "shape":"Strings", - "documentation":"

The app vhost settings with multiple domains separated by commas. For example: 'www.example.com, example.com'

" - }, - "EnableSsl":{ - "shape":"Boolean", - "documentation":"

Whether to enable SSL for the app.

" - }, - "SslConfiguration":{ - "shape":"SslConfiguration", - "documentation":"

An SslConfiguration object with the SSL configuration.

" - }, - "Attributes":{ - "shape":"AppAttributes", - "documentation":"

The stack attributes.

" - }, - "CreatedAt":{ - "shape":"String", - "documentation":"

When the app was created.

" - }, - "Environment":{ - "shape":"EnvironmentVariables", - "documentation":"

An array of EnvironmentVariable objects that specify environment variables to be associated with the app. After you deploy the app, these variables are defined on the associated app server instances. For more information, see Environment Variables.

There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variable names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases, but if you do exceed it, you will cause an exception (API) with an \"Environment: is too large (maximum is 10KB)\" message.

" - } - }, - "documentation":"

A description of the app.

" - }, - "AppAttributes":{ - "type":"map", - "key":{"shape":"AppAttributesKeys"}, - "value":{"shape":"String"} - }, - "AppAttributesKeys":{ - "type":"string", - "enum":[ - "DocumentRoot", - "RailsEnv", - "AutoBundleOnDeploy", - "AwsFlowRubySettings" - ] - }, - "AppType":{ - "type":"string", - "enum":[ - "aws-flow-ruby", - "java", - "rails", - "php", - "nodejs", - "static", - "other" - ] - }, - "Apps":{ - "type":"list", - "member":{"shape":"App"} - }, - "Architecture":{ - "type":"string", - "enum":[ - "x86_64", - "i386" - ] - }, - "AssignInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "LayerIds" - ], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

The layer ID, which must correspond to a custom layer. You cannot assign a registered instance to a built-in layer.

" - } - } - }, - "AssignVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "AssociateElasticIpRequest":{ - "type":"structure", - "required":["ElasticIp"], - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "AttachElasticLoadBalancerRequest":{ - "type":"structure", - "required":[ - "ElasticLoadBalancerName", - "LayerId" - ], - "members":{ - "ElasticLoadBalancerName":{ - "shape":"String", - "documentation":"

The Elastic Load Balancing instance's name.

" - }, - "LayerId":{ - "shape":"String", - "documentation":"

The ID of the layer to which the Elastic Load Balancing instance is to be attached.

" - } - } - }, - "AutoScalingThresholds":{ - "type":"structure", - "members":{ - "InstanceCount":{ - "shape":"Integer", - "documentation":"

The number of instances to add or remove when the load exceeds a threshold.

" - }, - "ThresholdsWaitTime":{ - "shape":"Minute", - "documentation":"

The amount of time, in minutes, that the load must exceed a threshold before more instances are added or removed.

" - }, - "IgnoreMetricsTime":{ - "shape":"Minute", - "documentation":"

The amount of time (in minutes) after a scaling event occurs that AWS OpsWorks Stacks should ignore metrics and suppress additional scaling events. For example, AWS OpsWorks Stacks adds new instances following an upscaling event but the instances won't start reducing the load until they have been booted and configured. There is no point in raising additional scaling events during that operation, which typically takes several minutes. IgnoreMetricsTime allows you to direct AWS OpsWorks Stacks to suppress scaling events long enough to get the new instances online.

" - }, - "CpuThreshold":{ - "shape":"Double", - "documentation":"

The CPU utilization threshold, as a percent of the available CPU. A value of -1 disables the threshold.

" - }, - "MemoryThreshold":{ - "shape":"Double", - "documentation":"

The memory utilization threshold, as a percent of the available memory. A value of -1 disables the threshold.

" - }, - "LoadThreshold":{ - "shape":"Double", - "documentation":"

The load threshold. A value of -1 disables the threshold. For more information about how load is computed, see Load (computing).

" - }, - "Alarms":{ - "shape":"Strings", - "documentation":"

Custom Cloudwatch auto scaling alarms, to be used as thresholds. This parameter takes a list of up to five alarm names, which are case sensitive and must be in the same region as the stack.

To use custom alarms, you must update your service role to allow cloudwatch:DescribeAlarms. You can either have AWS OpsWorks Stacks update the role for you when you first use this feature or you can edit the role manually. For more information, see Allowing AWS OpsWorks Stacks to Act on Your Behalf.

" - } - }, - "documentation":"

Describes a load-based auto scaling upscaling or downscaling threshold configuration, which specifies when AWS OpsWorks Stacks starts or stops load-based instances.

" - }, - "AutoScalingType":{ - "type":"string", - "enum":[ - "load", - "timer" - ] - }, - "BlockDeviceMapping":{ - "type":"structure", - "members":{ - "DeviceName":{ - "shape":"String", - "documentation":"

The device name that is exposed to the instance, such as /dev/sdh. For the root device, you can use the explicit device name or you can set this parameter to ROOT_DEVICE and AWS OpsWorks Stacks will provide the correct device name.

" - }, - "NoDevice":{ - "shape":"String", - "documentation":"

Suppresses the specified device included in the AMI's block device mapping.

" - }, - "VirtualName":{ - "shape":"String", - "documentation":"

The virtual device name. For more information, see BlockDeviceMapping.

" - }, - "Ebs":{ - "shape":"EbsBlockDevice", - "documentation":"

An EBSBlockDevice that defines how to configure an Amazon EBS volume when the instance is launched.

" - } - }, - "documentation":"

Describes a block device mapping. This data type maps directly to the Amazon EC2 BlockDeviceMapping data type.

" - }, - "BlockDeviceMappings":{ - "type":"list", - "member":{"shape":"BlockDeviceMapping"} - }, - "Boolean":{ - "type":"boolean", - "box":true - }, - "ChefConfiguration":{ - "type":"structure", - "members":{ - "ManageBerkshelf":{ - "shape":"Boolean", - "documentation":"

Whether to enable Berkshelf.

" - }, - "BerkshelfVersion":{ - "shape":"String", - "documentation":"

The Berkshelf version.

" - } - }, - "documentation":"

Describes the Chef configuration.

" - }, - "CloneStackRequest":{ - "type":"structure", - "required":[ - "SourceStackId", - "ServiceRoleArn" - ], - "members":{ - "SourceStackId":{ - "shape":"String", - "documentation":"

The source stack ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The cloned stack name.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The cloned stack AWS region, such as \"ap-northeast-2\". For more information about AWS regions, see Regions and Endpoints.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC that the cloned stack is to be launched into. It must be in the specified region. All instances are launched into this VPC, and you cannot change the ID later.

  • If your account supports EC2 Classic, the default value is no VPC.

  • If your account does not support EC2 Classic, the default value is the default VPC for the specified region.

If the VPC ID corresponds to a default VPC and you have specified either the DefaultAvailabilityZone or the DefaultSubnetId parameter only, AWS OpsWorks Stacks infers the value of the other parameter. If you specify neither parameter, AWS OpsWorks Stacks sets these parameters to the first valid Availability Zone for the specified region and the corresponding default VPC subnet ID, respectively.

If you specify a nondefault VPC ID, note the following:

  • It must belong to a VPC in your account that is in the specified region.

  • You must specify a value for DefaultSubnetId.

For more information about how to use AWS OpsWorks Stacks with a VPC, see Running a Stack in a VPC. For more information about default VPC and EC2 Classic, see Supported Platforms.

" - }, - "Attributes":{ - "shape":"StackAttributes", - "documentation":"

A list of stack attributes and values as key/value pairs to be added to the cloned stack.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

The stack AWS Identity and Access Management (IAM) role, which allows AWS OpsWorks Stacks to work with AWS resources on your behalf. You must set this parameter to the Amazon Resource Name (ARN) for an existing IAM role. If you create a stack by using the AWS OpsWorks Stacks console, it creates the role for you. You can obtain an existing stack's IAM ARN programmatically by calling DescribePermissions. For more information about IAM ARNs, see Using Identifiers.

You must set this parameter to a valid service role ARN or the action will fail; there is no default value. You can specify the source stack's service role ARN, if you prefer, but you must do so explicitly.

" - }, - "DefaultInstanceProfileArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of an IAM profile that is the default profile for all of the stack's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "DefaultOs":{ - "shape":"String", - "documentation":"

The stack's operating system, which must be set to one of the following.

  • A supported Linux operating system: An Amazon Linux version, such as Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.

  • A supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.

  • CentOS Linux 7

  • Red Hat Enterprise Linux 7

  • Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.

  • A custom AMI: Custom. You specify the custom AMI you want to use when you create instances. For more information about how to use custom AMIs with OpsWorks, see Using Custom AMIs.

The default option is the parent stack's operating system. For more information about supported operating systems, see AWS OpsWorks Stacks Operating Systems.

You can specify a different Linux operating system for the cloned stack, but you cannot change from Linux to Windows or Windows to Linux.

" - }, - "HostnameTheme":{ - "shape":"String", - "documentation":"

The stack's host name theme, with spaces are replaced by underscores. The theme is used to generate host names for the stack's instances. By default, HostnameTheme is set to Layer_Dependent, which creates host names by appending integers to the layer's short name. The other themes are:

  • Baked_Goods

  • Clouds

  • Europe_Cities

  • Fruits

  • Greek_Deities

  • Legendary_creatures_from_Japan

  • Planets_and_Moons

  • Roman_Deities

  • Scottish_Islands

  • US_Cities

  • Wild_Cats

To obtain a generated host name, call GetHostNameSuggestion, which returns a host name based on the current theme.

" - }, - "DefaultAvailabilityZone":{ - "shape":"String", - "documentation":"

The cloned stack's default Availability Zone, which must be in the specified region. For more information, see Regions and Endpoints. If you also specify a value for DefaultSubnetId, the subnet must be in the same zone. For more information, see the VpcId parameter description.

" - }, - "DefaultSubnetId":{ - "shape":"String", - "documentation":"

The stack's default VPC subnet ID. This parameter is required if you specify a value for the VpcId parameter. All instances are launched into this subnet unless you specify otherwise when you create the instance. If you also specify a value for DefaultAvailabilityZone, the subnet must be in that zone. For information on default values and when this parameter is required, see the VpcId parameter description.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A string that contains user-defined, custom JSON. It is used to override the corresponding default stack configuration JSON values. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information about custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager. When you clone a stack we recommend that you use the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is currently 12.

" - }, - "ChefConfiguration":{ - "shape":"ChefConfiguration", - "documentation":"

A ChefConfiguration object that specifies whether to enable Berkshelf and the Berkshelf version on Chef 11.10 stacks. For more information, see Create a New Stack.

" - }, - "UseCustomCookbooks":{ - "shape":"Boolean", - "documentation":"

Whether to use custom cookbooks.

" - }, - "UseOpsworksSecurityGroups":{ - "shape":"Boolean", - "documentation":"

Whether to associate the AWS OpsWorks Stacks built-in security groups with the stack's layers.

AWS OpsWorks Stacks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. With UseOpsworksSecurityGroups you can instead provide your own custom security groups. UseOpsworksSecurityGroups has the following settings:

  • True - AWS OpsWorks Stacks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it but you cannot delete the built-in security group.

  • False - AWS OpsWorks Stacks does not associate built-in security groups with layers. You must create appropriate Amazon Elastic Compute Cloud (Amazon EC2) security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on creation; custom security groups are required only for those layers that need custom settings.

For more information, see Create a New Stack.

" - }, - "CustomCookbooksSource":{"shape":"Source"}, - "DefaultSshKeyName":{ - "shape":"String", - "documentation":"

A default Amazon EC2 key pair name. The default value is none. If you specify a key pair name, AWS OpsWorks installs the public key on the instance and you can use the private key with an SSH client to log in to the instance. For more information, see Using SSH to Communicate with an Instance and Managing SSH Access. You can override this setting by specifying a different key pair, or no key pair, when you create an instance.

" - }, - "ClonePermissions":{ - "shape":"Boolean", - "documentation":"

Whether to clone the source stack's permissions.

" - }, - "CloneAppIds":{ - "shape":"Strings", - "documentation":"

A list of source stack app IDs to be included in the cloned stack.

" - }, - "DefaultRootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The default root device type. This value is used by default for all instances in the cloned stack, but you can override it when you create an instance. For more information, see Storage for the Root Device.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The default AWS OpsWorks Stacks agent version. You have the following options:

  • Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically installs new agent versions on the stack's instances as soon as they are available.

  • Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks Stacks then automatically installs that version on the stack's instances.

The default setting is LATEST. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call DescribeAgentVersions. AgentVersion cannot be set to Chef 12.2.

You can also specify an agent version when you create or update an instance, which overrides the stack's default setting.

" - } - } - }, - "CloneStackResult":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The cloned stack ID.

" - } - }, - "documentation":"

Contains the response to a CloneStack request.

" - }, - "CloudWatchLogsConfiguration":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Boolean", - "documentation":"

Whether CloudWatch Logs is enabled for a layer.

" - }, - "LogStreams":{ - "shape":"CloudWatchLogsLogStreams", - "documentation":"

A list of configuration options for CloudWatch Logs.

" - } - }, - "documentation":"

Describes the Amazon CloudWatch logs configuration for a layer.

" - }, - "CloudWatchLogsEncoding":{ - "type":"string", - "documentation":"

Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.

", - "enum":[ - "ascii", - "big5", - "big5hkscs", - "cp037", - "cp424", - "cp437", - "cp500", - "cp720", - "cp737", - "cp775", - "cp850", - "cp852", - "cp855", - "cp856", - "cp857", - "cp858", - "cp860", - "cp861", - "cp862", - "cp863", - "cp864", - "cp865", - "cp866", - "cp869", - "cp874", - "cp875", - "cp932", - "cp949", - "cp950", - "cp1006", - "cp1026", - "cp1140", - "cp1250", - "cp1251", - "cp1252", - "cp1253", - "cp1254", - "cp1255", - "cp1256", - "cp1257", - "cp1258", - "euc_jp", - "euc_jis_2004", - "euc_jisx0213", - "euc_kr", - "gb2312", - "gbk", - "gb18030", - "hz", - "iso2022_jp", - "iso2022_jp_1", - "iso2022_jp_2", - "iso2022_jp_2004", - "iso2022_jp_3", - "iso2022_jp_ext", - "iso2022_kr", - "latin_1", - "iso8859_2", - "iso8859_3", - "iso8859_4", - "iso8859_5", - "iso8859_6", - "iso8859_7", - "iso8859_8", - "iso8859_9", - "iso8859_10", - "iso8859_13", - "iso8859_14", - "iso8859_15", - "iso8859_16", - "johab", - "koi8_r", - "koi8_u", - "mac_cyrillic", - "mac_greek", - "mac_iceland", - "mac_latin2", - "mac_roman", - "mac_turkish", - "ptcp154", - "shift_jis", - "shift_jis_2004", - "shift_jisx0213", - "utf_32", - "utf_32_be", - "utf_32_le", - "utf_16", - "utf_16_be", - "utf_16_le", - "utf_7", - "utf_8", - "utf_8_sig" - ] - }, - "CloudWatchLogsInitialPosition":{ - "type":"string", - "documentation":"

Specifies where to start to read data (start_of_file or end_of_file). The default is start_of_file. It's only used if there is no state persisted for that log stream.

", - "enum":[ - "start_of_file", - "end_of_file" - ] - }, - "CloudWatchLogsLogStream":{ - "type":"structure", - "members":{ - "LogGroupName":{ - "shape":"String", - "documentation":"

Specifies the destination log group. A log group is created automatically if it doesn't already exist. Log group names can be between 1 and 512 characters long. Allowed characters include a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).

" - }, - "DatetimeFormat":{ - "shape":"String", - "documentation":"

Specifies how the time stamp is extracted from logs. For more information, see the CloudWatch Logs Agent Reference.

" - }, - "TimeZone":{ - "shape":"CloudWatchLogsTimeZone", - "documentation":"

Specifies the time zone of log event time stamps.

" - }, - "File":{ - "shape":"String", - "documentation":"

Specifies log files that you want to push to CloudWatch Logs.

File can point to a specific file or multiple files (by using wild card characters such as /var/log/system.log*). Only the latest file is pushed to CloudWatch Logs, based on file modification time. We recommend that you use wild card characters to specify a series of files of the same type, such as access_log.2014-06-01-01, access_log.2014-06-01-02, and so on by using a pattern like access_log.*. Don't use a wildcard to match multiple file types, such as access_log_80 and access_log_443. To specify multiple, different file types, add another log stream entry to the configuration file, so that each log file type is stored in a different log group.

Zipped files are not supported.

" - }, - "FileFingerprintLines":{ - "shape":"String", - "documentation":"

Specifies the range of lines for identifying a file. The valid values are one number, or two dash-delimited numbers, such as '1', '2-5'. The default value is '1', meaning the first line is used to calculate the fingerprint. Fingerprint lines are not sent to CloudWatch Logs unless all specified lines are available.

" - }, - "MultiLineStartPattern":{ - "shape":"String", - "documentation":"

Specifies the pattern for identifying the start of a log message.

" - }, - "InitialPosition":{ - "shape":"CloudWatchLogsInitialPosition", - "documentation":"

Specifies where to start to read data (start_of_file or end_of_file). The default is start_of_file. This setting is only used if there is no state persisted for that log stream.

" - }, - "Encoding":{ - "shape":"CloudWatchLogsEncoding", - "documentation":"

Specifies the encoding of the log file so that the file can be read correctly. The default is utf_8. Encodings supported by Python codecs.decode() can be used here.

" - }, - "BufferDuration":{ - "shape":"Integer", - "documentation":"

Specifies the time duration for the batching of log events. The minimum value is 5000ms and default value is 5000ms.

" - }, - "BatchCount":{ - "shape":"Integer", - "documentation":"

Specifies the max number of log events in a batch, up to 10000. The default value is 1000.

" - }, - "BatchSize":{ - "shape":"Integer", - "documentation":"

Specifies the maximum size of log events in a batch, in bytes, up to 1048576 bytes. The default value is 32768 bytes. This size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.

" - } - }, - "documentation":"

Describes the Amazon CloudWatch logs configuration for a layer. For detailed information about members of this data type, see the CloudWatch Logs Agent Reference.

" - }, - "CloudWatchLogsLogStreams":{ - "type":"list", - "member":{"shape":"CloudWatchLogsLogStream"}, - "documentation":"

Describes the Amazon CloudWatch logs configuration for a layer.

" - }, - "CloudWatchLogsTimeZone":{ - "type":"string", - "documentation":"

The preferred time zone for logs streamed to CloudWatch Logs. Valid values are LOCAL and UTC, for Coordinated Universal Time.

", - "enum":[ - "LOCAL", - "UTC" - ] - }, - "Command":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"String", - "documentation":"

The command ID.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance where the command was executed.

" - }, - "DeploymentId":{ - "shape":"String", - "documentation":"

The command deployment ID.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

Date and time when the command was run.

" - }, - "AcknowledgedAt":{ - "shape":"DateTime", - "documentation":"

Date and time when the command was acknowledged.

" - }, - "CompletedAt":{ - "shape":"DateTime", - "documentation":"

Date when the command completed.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The command status:

  • failed

  • successful

  • skipped

  • pending

" - }, - "ExitCode":{ - "shape":"Integer", - "documentation":"

The command exit code.

" - }, - "LogUrl":{ - "shape":"String", - "documentation":"

The URL of the command log.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The command type:

  • configure

  • deploy

  • execute_recipes

  • install_dependencies

  • restart

  • rollback

  • setup

  • start

  • stop

  • undeploy

  • update_custom_cookbooks

  • update_dependencies

" - } - }, - "documentation":"

Describes a command.

" - }, - "Commands":{ - "type":"list", - "member":{"shape":"Command"} - }, - "CreateAppRequest":{ - "type":"structure", - "required":[ - "StackId", - "Name", - "Type" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "Shortname":{ - "shape":"String", - "documentation":"

The app's short name.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The app name.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the app.

" - }, - "DataSources":{ - "shape":"DataSources", - "documentation":"

The app's data source.

" - }, - "Type":{ - "shape":"AppType", - "documentation":"

The app type. Each supported type is associated with a particular layer. For example, PHP applications are associated with a PHP layer. AWS OpsWorks Stacks deploys an application to those instances that are members of the corresponding layer. If your app isn't one of the standard types, or you prefer to implement your own Deploy recipes, specify other.

" - }, - "AppSource":{ - "shape":"Source", - "documentation":"

A Source object that specifies the app repository.

" - }, - "Domains":{ - "shape":"Strings", - "documentation":"

The app virtual host settings, with multiple domains separated by commas. For example: 'www.example.com, example.com'

" - }, - "EnableSsl":{ - "shape":"Boolean", - "documentation":"

Whether to enable SSL for the app.

" - }, - "SslConfiguration":{ - "shape":"SslConfiguration", - "documentation":"

An SslConfiguration object with the SSL configuration.

" - }, - "Attributes":{ - "shape":"AppAttributes", - "documentation":"

One or more user-defined key/value pairs to be added to the stack attributes.

" - }, - "Environment":{ - "shape":"EnvironmentVariables", - "documentation":"

An array of EnvironmentVariable objects that specify environment variables to be associated with the app. After you deploy the app, these variables are defined on the associated app server instance. For more information, see Environment Variables.

There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variables' names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases. Exceeding it will cause an exception with the message, \"Environment: is too large (maximum is 10KB).\"

This parameter is supported only by Chef 11.10 stacks. If you have specified one or more environment variables, you cannot modify the stack's Chef version.

" - } - } - }, - "CreateAppResult":{ - "type":"structure", - "members":{ - "AppId":{ - "shape":"String", - "documentation":"

The app ID.

" - } - }, - "documentation":"

Contains the response to a CreateApp request.

" - }, - "CreateDeploymentRequest":{ - "type":"structure", - "required":[ - "StackId", - "Command" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "AppId":{ - "shape":"String", - "documentation":"

The app ID. This parameter is required for app deployments, but not for other deployment commands.

" - }, - "InstanceIds":{ - "shape":"Strings", - "documentation":"

The instance IDs for the deployment targets.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

The layer IDs for the deployment targets.

" - }, - "Command":{ - "shape":"DeploymentCommand", - "documentation":"

A DeploymentCommand object that specifies the deployment command and any associated arguments.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A string that contains user-defined, custom JSON. It is used to override the corresponding default stack configuration JSON values. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information about custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes.

" - } - } - }, - "CreateDeploymentResult":{ - "type":"structure", - "members":{ - "DeploymentId":{ - "shape":"String", - "documentation":"

The deployment ID, which can be used with other requests to identify the deployment.

" - } - }, - "documentation":"

Contains the response to a CreateDeployment request.

" - }, - "CreateInstanceRequest":{ - "type":"structure", - "required":[ - "StackId", - "LayerIds", - "InstanceType" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

An array that contains the instance's layer IDs.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type, such as t2.micro. For a list of supported instance types, open the stack in the console, choose Instances, and choose + Instance. The Size list contains the currently supported types. For more information, see Instance Families and Types. The parameter values that you use to specify the various types are in the API Name column of the Available Instance Types table.

" - }, - "AutoScalingType":{ - "shape":"AutoScalingType", - "documentation":"

For load-based or time-based instances, the type. Windows stacks can use only time-based instances.

" - }, - "Hostname":{ - "shape":"String", - "documentation":"

The instance host name.

" - }, - "Os":{ - "shape":"String", - "documentation":"

The instance's operating system, which must be set to one of the following.

  • A supported Linux operating system: An Amazon Linux version, such as Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.

  • A supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.

  • CentOS Linux 7

  • Red Hat Enterprise Linux 7

  • A supported Windows operating system, such as Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.

  • A custom AMI: Custom.

For more information about the supported operating systems, see AWS OpsWorks Stacks Operating Systems.

The default option is the current Amazon Linux version. If you set this parameter to Custom, you must use the CreateInstance action's AmiId parameter to specify the custom AMI that you want to use. Block device mappings are not supported if the value is Custom. For more information about supported operating systems, see Operating SystemsFor more information about how to use custom AMIs with AWS OpsWorks Stacks, see Using Custom AMIs.

" - }, - "AmiId":{ - "shape":"String", - "documentation":"

A custom AMI ID to be used to create the instance. The AMI should be based on one of the supported operating systems. For more information, see Using Custom AMIs.

If you specify a custom AMI, you must set Os to Custom.

" - }, - "SshKeyName":{ - "shape":"String", - "documentation":"

The instance's Amazon EC2 key-pair name.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The instance Availability Zone. For more information, see Regions and Endpoints.

" - }, - "VirtualizationType":{ - "shape":"String", - "documentation":"

The instance's virtualization type, paravirtual or hvm.

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The ID of the instance's subnet. If the stack is running in a VPC, you can use this parameter to override the stack's default subnet ID value and direct AWS OpsWorks Stacks to launch the instance in a different subnet.

" - }, - "Architecture":{ - "shape":"Architecture", - "documentation":"

The instance architecture. The default option is x86_64. Instance types do not necessarily support both architectures. For a list of the architectures that are supported by the different instance types, see Instance Families and Types.

" - }, - "RootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The instance root device type. For more information, see Storage for the Root Device.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappings", - "documentation":"

An array of BlockDeviceMapping objects that specify the instance's block devices. For more information, see Block Device Mapping. Note that block device mappings are not supported for custom AMIs.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. To control when updates are installed, set this value to false. You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or by manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

We strongly recommend using the default value of true to ensure that your instances have the latest security updates.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Whether to create an Amazon EBS-optimized instance.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The default AWS OpsWorks Stacks agent version. You have the following options:

  • INHERIT - Use the stack's default agent version setting.

  • version_number - Use the specified agent version. This value overrides the stack's default setting. To update the agent version, edit the instance configuration and specify a new version. AWS OpsWorks Stacks then automatically installs that version on the instance.

The default setting is INHERIT. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call DescribeAgentVersions. AgentVersion cannot be set to Chef 12.2.

" - }, - "Tenancy":{ - "shape":"String", - "documentation":"

The instance's tenancy option. The default option is no tenancy, or if the instance is running in a VPC, inherit tenancy settings from the VPC. The following are valid values for this parameter: dedicated, default, or host. Because there are costs associated with changes in tenancy options, we recommend that you research tenancy options before choosing them for your instances. For more information about dedicated hosts, see Dedicated Hosts Overview and Amazon EC2 Dedicated Hosts. For more information about dedicated instances, see Dedicated Instances and Amazon EC2 Dedicated Instances.

" - } - } - }, - "CreateInstanceResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - }, - "documentation":"

Contains the response to a CreateInstance request.

" - }, - "CreateLayerRequest":{ - "type":"structure", - "required":[ - "StackId", - "Type", - "Name", - "Shortname" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The layer stack ID.

" - }, - "Type":{ - "shape":"LayerType", - "documentation":"

The layer type. A stack cannot have more than one built-in layer of the same type. It can have any number of custom layers. Built-in layers are not available in Chef 12 stacks.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The layer name, which is used by the console.

" - }, - "Shortname":{ - "shape":"String", - "documentation":"

For custom layers only, use this parameter to specify the layer's short name, which is used internally by AWS OpsWorks Stacks and by Chef recipes. The short name is also used as the name for the directory where your app files are installed. It can have a maximum of 200 characters, which are limited to the alphanumeric characters, '-', '_', and '.'.

The built-in layers' short names are defined by AWS OpsWorks Stacks. For more information, see the Layer Reference.

" - }, - "Attributes":{ - "shape":"LayerAttributes", - "documentation":"

One or more user-defined key-value pairs to be added to the stack attributes.

To create a cluster layer, set the EcsClusterArn attribute to the cluster's ARN.

" - }, - "CloudWatchLogsConfiguration":{ - "shape":"CloudWatchLogsConfiguration", - "documentation":"

Specifies CloudWatch Logs configuration options for the layer. For more information, see CloudWatchLogsLogStream.

" - }, - "CustomInstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of an IAM profile to be used for the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A JSON-formatted string containing custom stack configuration and deployment attributes to be installed on the layer's instances. For more information, see Using Custom JSON. This feature is supported as of version 1.7.42 of the AWS CLI.

" - }, - "CustomSecurityGroupIds":{ - "shape":"Strings", - "documentation":"

An array containing the layer custom security group IDs.

" - }, - "Packages":{ - "shape":"Strings", - "documentation":"

An array of Package objects that describes the layer packages.

" - }, - "VolumeConfigurations":{ - "shape":"VolumeConfigurations", - "documentation":"

A VolumeConfigurations object that describes the layer's Amazon EBS volumes.

" - }, - "EnableAutoHealing":{ - "shape":"Boolean", - "documentation":"

Whether to disable auto healing for the layer.

" - }, - "AutoAssignElasticIps":{ - "shape":"Boolean", - "documentation":"

Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "AutoAssignPublicIps":{ - "shape":"Boolean", - "documentation":"

For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "CustomRecipes":{ - "shape":"Recipes", - "documentation":"

A LayerCustomRecipes object that specifies the layer custom recipes.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. To control when updates are installed, set this value to false. You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or by manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

To ensure that your instances have the latest security updates, we strongly recommend using the default value of true.

" - }, - "UseEbsOptimizedInstances":{ - "shape":"Boolean", - "documentation":"

Whether to use Amazon EBS-optimized instances.

" - }, - "LifecycleEventConfiguration":{ - "shape":"LifecycleEventConfiguration", - "documentation":"

A LifeCycleEventConfiguration object that you can use to configure the Shutdown event to specify an execution timeout and enable or disable Elastic Load Balancer connection draining.

" - } - } - }, - "CreateLayerResult":{ - "type":"structure", - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - } - }, - "documentation":"

Contains the response to a CreateLayer request.

" - }, - "CreateStackRequest":{ - "type":"structure", - "required":[ - "Name", - "Region", - "ServiceRoleArn", - "DefaultInstanceProfileArn" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The stack name.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The stack's AWS region, such as ap-south-1. For more information about Amazon regions, see Regions and Endpoints.

In the AWS CLI, this API maps to the --stack-region parameter. If the --stack-region parameter and the AWS CLI common parameter --region are set to the same value, the stack uses a regional endpoint. If the --stack-region parameter is not set, but the AWS CLI --region parameter is, this also results in a stack with a regional endpoint. However, if the --region parameter is set to us-east-1, and the --stack-region parameter is set to one of the following, then the stack uses a legacy or classic region: us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1, ap-southeast-2. In this case, the actual API endpoint of the stack is in us-east-1. Only the preceding regions are supported as classic regions in the us-east-1 API endpoint. Because it is a best practice to choose the regional endpoint that is closest to where you manage AWS, we recommend that you use regional endpoints for new stacks. The AWS CLI common --region parameter always specifies a regional API endpoint; it cannot be used to specify a classic AWS OpsWorks Stacks region.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The ID of the VPC that the stack is to be launched into. The VPC must be in the stack's region. All instances are launched into this VPC. You cannot change the ID later.

  • If your account supports EC2-Classic, the default value is no VPC.

  • If your account does not support EC2-Classic, the default value is the default VPC for the specified region.

If the VPC ID corresponds to a default VPC and you have specified either the DefaultAvailabilityZone or the DefaultSubnetId parameter only, AWS OpsWorks Stacks infers the value of the other parameter. If you specify neither parameter, AWS OpsWorks Stacks sets these parameters to the first valid Availability Zone for the specified region and the corresponding default VPC subnet ID, respectively.

If you specify a nondefault VPC ID, note the following:

  • It must belong to a VPC in your account that is in the specified region.

  • You must specify a value for DefaultSubnetId.

For more information about how to use AWS OpsWorks Stacks with a VPC, see Running a Stack in a VPC. For more information about default VPC and EC2-Classic, see Supported Platforms.

" - }, - "Attributes":{ - "shape":"StackAttributes", - "documentation":"

One or more user-defined key-value pairs to be added to the stack attributes.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

The stack's AWS Identity and Access Management (IAM) role, which allows AWS OpsWorks Stacks to work with AWS resources on your behalf. You must set this parameter to the Amazon Resource Name (ARN) for an existing IAM role. For more information about IAM ARNs, see Using Identifiers.

" - }, - "DefaultInstanceProfileArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of an IAM profile that is the default profile for all of the stack's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "DefaultOs":{ - "shape":"String", - "documentation":"

The stack's default operating system, which is installed on every instance unless you specify a different operating system when you create the instance. You can specify one of the following.

  • A supported Linux operating system: An Amazon Linux version, such as Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.

  • A supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.

  • CentOS Linux 7

  • Red Hat Enterprise Linux 7

  • A supported Windows operating system, such as Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.

  • A custom AMI: Custom. You specify the custom AMI you want to use when you create instances. For more information, see Using Custom AMIs.

The default option is the current Amazon Linux version. For more information about supported operating systems, see AWS OpsWorks Stacks Operating Systems.

" - }, - "HostnameTheme":{ - "shape":"String", - "documentation":"

The stack's host name theme, with spaces replaced by underscores. The theme is used to generate host names for the stack's instances. By default, HostnameTheme is set to Layer_Dependent, which creates host names by appending integers to the layer's short name. The other themes are:

  • Baked_Goods

  • Clouds

  • Europe_Cities

  • Fruits

  • Greek_Deities

  • Legendary_creatures_from_Japan

  • Planets_and_Moons

  • Roman_Deities

  • Scottish_Islands

  • US_Cities

  • Wild_Cats

To obtain a generated host name, call GetHostNameSuggestion, which returns a host name based on the current theme.

" - }, - "DefaultAvailabilityZone":{ - "shape":"String", - "documentation":"

The stack's default Availability Zone, which must be in the specified region. For more information, see Regions and Endpoints. If you also specify a value for DefaultSubnetId, the subnet must be in the same zone. For more information, see the VpcId parameter description.

" - }, - "DefaultSubnetId":{ - "shape":"String", - "documentation":"

The stack's default VPC subnet ID. This parameter is required if you specify a value for the VpcId parameter. All instances are launched into this subnet unless you specify otherwise when you create the instance. If you also specify a value for DefaultAvailabilityZone, the subnet must be in that zone. For information on default values and when this parameter is required, see the VpcId parameter description.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A string that contains user-defined, custom JSON. It can be used to override the corresponding default stack configuration attribute values or to pass data to recipes. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information about custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes.

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager. When you create a stack we recommend that you use the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is currently 12.

" - }, - "ChefConfiguration":{ - "shape":"ChefConfiguration", - "documentation":"

A ChefConfiguration object that specifies whether to enable Berkshelf and the Berkshelf version on Chef 11.10 stacks. For more information, see Create a New Stack.

" - }, - "UseCustomCookbooks":{ - "shape":"Boolean", - "documentation":"

Whether the stack uses custom cookbooks.

" - }, - "UseOpsworksSecurityGroups":{ - "shape":"Boolean", - "documentation":"

Whether to associate the AWS OpsWorks Stacks built-in security groups with the stack's layers.

AWS OpsWorks Stacks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. With UseOpsworksSecurityGroups you can instead provide your own custom security groups. UseOpsworksSecurityGroups has the following settings:

  • True - AWS OpsWorks Stacks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it, but you cannot delete the built-in security group.

  • False - AWS OpsWorks Stacks does not associate built-in security groups with layers. You must create appropriate EC2 security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on creation; custom security groups are required only for those layers that need custom settings.

For more information, see Create a New Stack.

" - }, - "CustomCookbooksSource":{"shape":"Source"}, - "DefaultSshKeyName":{ - "shape":"String", - "documentation":"

A default Amazon EC2 key pair name. The default value is none. If you specify a key pair name, AWS OpsWorks installs the public key on the instance and you can use the private key with an SSH client to log in to the instance. For more information, see Using SSH to Communicate with an Instance and Managing SSH Access. You can override this setting by specifying a different key pair, or no key pair, when you create an instance.

" - }, - "DefaultRootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The default root device type. This value is the default for all instances in the stack, but you can override it when you create an instance. The default option is instance-store. For more information, see Storage for the Root Device.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The default AWS OpsWorks Stacks agent version. You have the following options:

  • Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically installs new agent versions on the stack's instances as soon as they are available.

  • Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks Stacks then automatically installs that version on the stack's instances.

The default setting is the most recent release of the agent. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call DescribeAgentVersions. AgentVersion cannot be set to Chef 12.2.

You can also specify an agent version when you create or update an instance, which overrides the stack's default setting.

" - } - } - }, - "CreateStackResult":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID, which is an opaque string that you use to identify the stack when performing actions such as DescribeStacks.

" - } - }, - "documentation":"

Contains the response to a CreateStack request.

" - }, - "CreateUserProfileRequest":{ - "type":"structure", - "required":["IamUserArn"], - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN; this can also be a federated user's ARN.

" - }, - "SshUsername":{ - "shape":"String", - "documentation":"

The user's SSH user name. The allowable characters are [a-z], [A-Z], [0-9], '-', and '_'. If the specified name includes other punctuation marks, AWS OpsWorks Stacks removes them. For example, my.name will be changed to myname. If you do not specify an SSH user name, AWS OpsWorks Stacks generates one from the IAM user name.

" - }, - "SshPublicKey":{ - "shape":"String", - "documentation":"

The user's public SSH key.

" - }, - "AllowSelfManagement":{ - "shape":"Boolean", - "documentation":"

Whether users can specify their own SSH public key through the My Settings page. For more information, see Setting an IAM User's Public SSH Key.

" - } - } - }, - "CreateUserProfileResult":{ - "type":"structure", - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN.

" - } - }, - "documentation":"

Contains the response to a CreateUserProfile request.

" - }, - "DailyAutoScalingSchedule":{ - "type":"map", - "key":{"shape":"Hour"}, - "value":{"shape":"Switch"} - }, - "DataSource":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

The data source's type, AutoSelectOpsworksMysqlInstance, OpsworksMysqlInstance, RdsDbInstance, or None.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The data source's ARN.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The database name.

" - } - }, - "documentation":"

Describes an app's data source.

" - }, - "DataSources":{ - "type":"list", - "member":{"shape":"DataSource"} - }, - "DateTime":{"type":"string"}, - "DeleteAppRequest":{ - "type":"structure", - "required":["AppId"], - "members":{ - "AppId":{ - "shape":"String", - "documentation":"

The app ID.

" - } - } - }, - "DeleteInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "DeleteElasticIp":{ - "shape":"Boolean", - "documentation":"

Whether to delete the instance Elastic IP address.

" - }, - "DeleteVolumes":{ - "shape":"Boolean", - "documentation":"

Whether to delete the instance's Amazon EBS volumes.

" - } - } - }, - "DeleteLayerRequest":{ - "type":"structure", - "required":["LayerId"], - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - } - } - }, - "DeleteStackRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "DeleteUserProfileRequest":{ - "type":"structure", - "required":["IamUserArn"], - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN. This can also be a federated user's ARN.

" - } - } - }, - "Deployment":{ - "type":"structure", - "members":{ - "DeploymentId":{ - "shape":"String", - "documentation":"

The deployment ID.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "AppId":{ - "shape":"String", - "documentation":"

The app ID.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

Date when the deployment was created.

" - }, - "CompletedAt":{ - "shape":"DateTime", - "documentation":"

Date when the deployment completed.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The deployment duration.

" - }, - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN.

" - }, - "Comment":{ - "shape":"String", - "documentation":"

A user-defined comment.

" - }, - "Command":{"shape":"DeploymentCommand"}, - "Status":{ - "shape":"String", - "documentation":"

The deployment status:

  • running

  • successful

  • failed

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A string that contains user-defined custom JSON. It can be used to override the corresponding default stack configuration attribute values for stack or to pass data to recipes. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information on custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes.

" - }, - "InstanceIds":{ - "shape":"Strings", - "documentation":"

The IDs of the target instances.

" - } - }, - "documentation":"

Describes a deployment of a stack or app.

" - }, - "DeploymentCommand":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DeploymentCommandName", - "documentation":"

Specifies the operation. You can specify only one command.

For stacks, the following commands are available:

  • execute_recipes: Execute one or more recipes. To specify the recipes, set an Args parameter named recipes to the list of recipes to be executed. For example, to execute phpapp::appsetup, set Args to {\"recipes\":[\"phpapp::appsetup\"]}.

  • install_dependencies: Install the stack's dependencies.

  • update_custom_cookbooks: Update the stack's custom cookbooks.

  • update_dependencies: Update the stack's dependencies.

The update_dependencies and install_dependencies commands are supported only for Linux instances. You can run the commands successfully on Windows instances, but they do nothing.

For apps, the following commands are available:

  • deploy: Deploy an app. Ruby on Rails apps have an optional Args parameter named migrate. Set Args to {\"migrate\":[\"true\"]} to migrate the database. The default setting is {\"migrate\":[\"false\"]}.

  • rollback Roll the app back to the previous version. When you update an app, AWS OpsWorks Stacks stores the previous version, up to a maximum of five versions. You can use this command to roll an app back as many as four versions.

  • start: Start the app's web or application server.

  • stop: Stop the app's web or application server.

  • restart: Restart the app's web or application server.

  • undeploy: Undeploy the app.

" - }, - "Args":{ - "shape":"DeploymentCommandArgs", - "documentation":"

The arguments of those commands that take arguments. It should be set to a JSON object with the following format:

{\"arg_name1\" : [\"value1\", \"value2\", ...], \"arg_name2\" : [\"value1\", \"value2\", ...], ...}

The update_dependencies command takes two arguments:

  • upgrade_os_to - Specifies the desired Amazon Linux version for instances whose OS you want to upgrade, such as Amazon Linux 2016.09. You must also set the allow_reboot argument to true.

  • allow_reboot - Specifies whether to allow AWS OpsWorks Stacks to reboot the instances if necessary, after installing the updates. This argument can be set to either true or false. The default value is false.

For example, to upgrade an instance to Amazon Linux 2016.09, set Args to the following.

{ \"upgrade_os_to\":[\"Amazon Linux 2016.09\"], \"allow_reboot\":[\"true\"] }

" - } - }, - "documentation":"

Used to specify a stack or deployment command.

" - }, - "DeploymentCommandArgs":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"Strings"} - }, - "DeploymentCommandName":{ - "type":"string", - "enum":[ - "install_dependencies", - "update_dependencies", - "update_custom_cookbooks", - "execute_recipes", - "configure", - "setup", - "deploy", - "rollback", - "start", - "stop", - "restart", - "undeploy" - ] - }, - "Deployments":{ - "type":"list", - "member":{"shape":"Deployment"} - }, - "DeregisterEcsClusterRequest":{ - "type":"structure", - "required":["EcsClusterArn"], - "members":{ - "EcsClusterArn":{ - "shape":"String", - "documentation":"

The cluster's Amazon Resource Number (ARN).

" - } - } - }, - "DeregisterElasticIpRequest":{ - "type":"structure", - "required":["ElasticIp"], - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

" - } - } - }, - "DeregisterInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "DeregisterRdsDbInstanceRequest":{ - "type":"structure", - "required":["RdsDbInstanceArn"], - "members":{ - "RdsDbInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon RDS instance's ARN.

" - } - } - }, - "DeregisterVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The AWS OpsWorks Stacks volume ID, which is the GUID that AWS OpsWorks Stacks assigned to the instance when you registered the volume with the stack, not the Amazon EC2 volume ID.

" - } - } - }, - "DescribeAgentVersionsRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager.

" - } - } - }, - "DescribeAgentVersionsResult":{ - "type":"structure", - "members":{ - "AgentVersions":{ - "shape":"AgentVersions", - "documentation":"

The agent versions for the specified stack or configuration manager. Note that this value is the complete version number, not the abbreviated number used by the console.

" - } - }, - "documentation":"

Contains the response to a DescribeAgentVersions request.

" - }, - "DescribeAppsRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The app stack ID. If you use this parameter, DescribeApps returns a description of the apps in the specified stack.

" - }, - "AppIds":{ - "shape":"Strings", - "documentation":"

An array of app IDs for the apps to be described. If you use this parameter, DescribeApps returns a description of the specified apps. Otherwise, it returns a description of every app.

" - } - } - }, - "DescribeAppsResult":{ - "type":"structure", - "members":{ - "Apps":{ - "shape":"Apps", - "documentation":"

An array of App objects that describe the specified apps.

" - } - }, - "documentation":"

Contains the response to a DescribeApps request.

" - }, - "DescribeCommandsRequest":{ - "type":"structure", - "members":{ - "DeploymentId":{ - "shape":"String", - "documentation":"

The deployment ID. If you include this parameter, DescribeCommands returns a description of the commands associated with the specified deployment.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID. If you include this parameter, DescribeCommands returns a description of the commands associated with the specified instance.

" - }, - "CommandIds":{ - "shape":"Strings", - "documentation":"

An array of command IDs. If you include this parameter, DescribeCommands returns a description of the specified commands. Otherwise, it returns a description of every command.

" - } - } - }, - "DescribeCommandsResult":{ - "type":"structure", - "members":{ - "Commands":{ - "shape":"Commands", - "documentation":"

An array of Command objects that describe each of the specified commands.

" - } - }, - "documentation":"

Contains the response to a DescribeCommands request.

" - }, - "DescribeDeploymentsRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID. If you include this parameter, the command returns a description of the commands associated with the specified stack.

" - }, - "AppId":{ - "shape":"String", - "documentation":"

The app ID. If you include this parameter, the command returns a description of the commands associated with the specified app.

" - }, - "DeploymentIds":{ - "shape":"Strings", - "documentation":"

An array of deployment IDs to be described. If you include this parameter, the command returns a description of the specified deployments. Otherwise, it returns a description of every deployment.

" - } - } - }, - "DescribeDeploymentsResult":{ - "type":"structure", - "members":{ - "Deployments":{ - "shape":"Deployments", - "documentation":"

An array of Deployment objects that describe the deployments.

" - } - }, - "documentation":"

Contains the response to a DescribeDeployments request.

" - }, - "DescribeEcsClustersRequest":{ - "type":"structure", - "members":{ - "EcsClusterArns":{ - "shape":"Strings", - "documentation":"

A list of ARNs, one for each cluster to be described.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

A stack ID. DescribeEcsClusters returns a description of the cluster that is registered with the stack.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If the previous paginated request did not return all of the remaining results, the response object'sNextToken parameter value is set to a token. To retrieve the next set of results, call DescribeEcsClusters again and assign that token to the request object's NextToken parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

" - }, - "MaxResults":{ - "shape":"Integer", - "documentation":"

To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "DescribeEcsClustersResult":{ - "type":"structure", - "members":{ - "EcsClusters":{ - "shape":"EcsClusters", - "documentation":"

A list of EcsCluster objects containing the cluster descriptions.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If a paginated request does not return all of the remaining results, this parameter is set to a token that you can assign to the request object's NextToken parameter to retrieve the next set of results. If the previous paginated request returned all of the remaining results, this parameter is set to null.

" - } - }, - "documentation":"

Contains the response to a DescribeEcsClusters request.

" - }, - "DescribeElasticIpsRequest":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID. If you include this parameter, DescribeElasticIps returns a description of the Elastic IP addresses associated with the specified instance.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

A stack ID. If you include this parameter, DescribeElasticIps returns a description of the Elastic IP addresses that are registered with the specified stack.

" - }, - "Ips":{ - "shape":"Strings", - "documentation":"

An array of Elastic IP addresses to be described. If you include this parameter, DescribeElasticIps returns a description of the specified Elastic IP addresses. Otherwise, it returns a description of every Elastic IP address.

" - } - } - }, - "DescribeElasticIpsResult":{ - "type":"structure", - "members":{ - "ElasticIps":{ - "shape":"ElasticIps", - "documentation":"

An ElasticIps object that describes the specified Elastic IP addresses.

" - } - }, - "documentation":"

Contains the response to a DescribeElasticIps request.

" - }, - "DescribeElasticLoadBalancersRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

A stack ID. The action describes the stack's Elastic Load Balancing instances.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

A list of layer IDs. The action describes the Elastic Load Balancing instances for the specified layers.

" - } - } - }, - "DescribeElasticLoadBalancersResult":{ - "type":"structure", - "members":{ - "ElasticLoadBalancers":{ - "shape":"ElasticLoadBalancers", - "documentation":"

A list of ElasticLoadBalancer objects that describe the specified Elastic Load Balancing instances.

" - } - }, - "documentation":"

Contains the response to a DescribeElasticLoadBalancers request.

" - }, - "DescribeInstancesRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

A stack ID. If you use this parameter, DescribeInstances returns descriptions of the instances associated with the specified stack.

" - }, - "LayerId":{ - "shape":"String", - "documentation":"

A layer ID. If you use this parameter, DescribeInstances returns descriptions of the instances associated with the specified layer.

" - }, - "InstanceIds":{ - "shape":"Strings", - "documentation":"

An array of instance IDs to be described. If you use this parameter, DescribeInstances returns a description of the specified instances. Otherwise, it returns a description of every instance.

" - } - } - }, - "DescribeInstancesResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"Instances", - "documentation":"

An array of Instance objects that describe the instances.

" - } - }, - "documentation":"

Contains the response to a DescribeInstances request.

" - }, - "DescribeLayersRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

An array of layer IDs that specify the layers to be described. If you omit this parameter, DescribeLayers returns a description of every layer in the specified stack.

" - } - } - }, - "DescribeLayersResult":{ - "type":"structure", - "members":{ - "Layers":{ - "shape":"Layers", - "documentation":"

An array of Layer objects that describe the layers.

" - } - }, - "documentation":"

Contains the response to a DescribeLayers request.

" - }, - "DescribeLoadBasedAutoScalingRequest":{ - "type":"structure", - "required":["LayerIds"], - "members":{ - "LayerIds":{ - "shape":"Strings", - "documentation":"

An array of layer IDs.

" - } - } - }, - "DescribeLoadBasedAutoScalingResult":{ - "type":"structure", - "members":{ - "LoadBasedAutoScalingConfigurations":{ - "shape":"LoadBasedAutoScalingConfigurations", - "documentation":"

An array of LoadBasedAutoScalingConfiguration objects that describe each layer's configuration.

" - } - }, - "documentation":"

Contains the response to a DescribeLoadBasedAutoScaling request.

" - }, - "DescribeMyUserProfileResult":{ - "type":"structure", - "members":{ - "UserProfile":{ - "shape":"SelfUserProfile", - "documentation":"

A UserProfile object that describes the user's SSH information.

" - } - }, - "documentation":"

Contains the response to a DescribeMyUserProfile request.

" - }, - "DescribeOperatingSystemsResponse":{ - "type":"structure", - "members":{ - "OperatingSystems":{ - "shape":"OperatingSystems", - "documentation":"

Contains information in response to a DescribeOperatingSystems request.

" - } - }, - "documentation":"

The response to a DescribeOperatingSystems request.

" - }, - "DescribePermissionsRequest":{ - "type":"structure", - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN. This can also be a federated user's ARN. For more information about IAM ARNs, see Using Identifiers.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "DescribePermissionsResult":{ - "type":"structure", - "members":{ - "Permissions":{ - "shape":"Permissions", - "documentation":"

An array of Permission objects that describe the stack permissions.

  • If the request object contains only a stack ID, the array contains a Permission object with permissions for each of the stack IAM ARNs.

  • If the request object contains only an IAM ARN, the array contains a Permission object with permissions for each of the user's stack IDs.

  • If the request contains a stack ID and an IAM ARN, the array contains a single Permission object with permissions for the specified stack and IAM ARN.

" - } - }, - "documentation":"

Contains the response to a DescribePermissions request.

" - }, - "DescribeRaidArraysRequest":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID. If you use this parameter, DescribeRaidArrays returns descriptions of the RAID arrays associated with the specified instance.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "RaidArrayIds":{ - "shape":"Strings", - "documentation":"

An array of RAID array IDs. If you use this parameter, DescribeRaidArrays returns descriptions of the specified arrays. Otherwise, it returns a description of every array.

" - } - } - }, - "DescribeRaidArraysResult":{ - "type":"structure", - "members":{ - "RaidArrays":{ - "shape":"RaidArrays", - "documentation":"

A RaidArrays object that describes the specified RAID arrays.

" - } - }, - "documentation":"

Contains the response to a DescribeRaidArrays request.

" - }, - "DescribeRdsDbInstancesRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The ID of the stack with which the instances are registered. The operation returns descriptions of all registered Amazon RDS instances.

" - }, - "RdsDbInstanceArns":{ - "shape":"Strings", - "documentation":"

An array containing the ARNs of the instances to be described.

" - } - } - }, - "DescribeRdsDbInstancesResult":{ - "type":"structure", - "members":{ - "RdsDbInstances":{ - "shape":"RdsDbInstances", - "documentation":"

An a array of RdsDbInstance objects that describe the instances.

" - } - }, - "documentation":"

Contains the response to a DescribeRdsDbInstances request.

" - }, - "DescribeServiceErrorsRequest":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID. If you use this parameter, DescribeServiceErrors returns descriptions of the errors associated with the specified stack.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID. If you use this parameter, DescribeServiceErrors returns descriptions of the errors associated with the specified instance.

" - }, - "ServiceErrorIds":{ - "shape":"Strings", - "documentation":"

An array of service error IDs. If you use this parameter, DescribeServiceErrors returns descriptions of the specified errors. Otherwise, it returns a description of every error.

" - } - } - }, - "DescribeServiceErrorsResult":{ - "type":"structure", - "members":{ - "ServiceErrors":{ - "shape":"ServiceErrors", - "documentation":"

An array of ServiceError objects that describe the specified service errors.

" - } - }, - "documentation":"

Contains the response to a DescribeServiceErrors request.

" - }, - "DescribeStackProvisioningParametersRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "DescribeStackProvisioningParametersResult":{ - "type":"structure", - "members":{ - "AgentInstallerUrl":{ - "shape":"String", - "documentation":"

The AWS OpsWorks Stacks agent installer's URL.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

An embedded object that contains the provisioning parameters.

" - } - }, - "documentation":"

Contains the response to a DescribeStackProvisioningParameters request.

" - }, - "DescribeStackSummaryRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "DescribeStackSummaryResult":{ - "type":"structure", - "members":{ - "StackSummary":{ - "shape":"StackSummary", - "documentation":"

A StackSummary object that contains the results.

" - } - }, - "documentation":"

Contains the response to a DescribeStackSummary request.

" - }, - "DescribeStacksRequest":{ - "type":"structure", - "members":{ - "StackIds":{ - "shape":"Strings", - "documentation":"

An array of stack IDs that specify the stacks to be described. If you omit this parameter, DescribeStacks returns a description of every stack.

" - } - } - }, - "DescribeStacksResult":{ - "type":"structure", - "members":{ - "Stacks":{ - "shape":"Stacks", - "documentation":"

An array of Stack objects that describe the stacks.

" - } - }, - "documentation":"

Contains the response to a DescribeStacks request.

" - }, - "DescribeTimeBasedAutoScalingRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"Strings", - "documentation":"

An array of instance IDs.

" - } - } - }, - "DescribeTimeBasedAutoScalingResult":{ - "type":"structure", - "members":{ - "TimeBasedAutoScalingConfigurations":{ - "shape":"TimeBasedAutoScalingConfigurations", - "documentation":"

An array of TimeBasedAutoScalingConfiguration objects that describe the configuration for the specified instances.

" - } - }, - "documentation":"

Contains the response to a DescribeTimeBasedAutoScaling request.

" - }, - "DescribeUserProfilesRequest":{ - "type":"structure", - "members":{ - "IamUserArns":{ - "shape":"Strings", - "documentation":"

An array of IAM or federated user ARNs that identify the users to be described.

" - } - } - }, - "DescribeUserProfilesResult":{ - "type":"structure", - "members":{ - "UserProfiles":{ - "shape":"UserProfiles", - "documentation":"

A Users object that describes the specified users.

" - } - }, - "documentation":"

Contains the response to a DescribeUserProfiles request.

" - }, - "DescribeVolumesRequest":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID. If you use this parameter, DescribeVolumes returns descriptions of the volumes associated with the specified instance.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

A stack ID. The action describes the stack's registered Amazon EBS volumes.

" - }, - "RaidArrayId":{ - "shape":"String", - "documentation":"

The RAID array ID. If you use this parameter, DescribeVolumes returns descriptions of the volumes associated with the specified RAID array.

" - }, - "VolumeIds":{ - "shape":"Strings", - "documentation":"

Am array of volume IDs. If you use this parameter, DescribeVolumes returns descriptions of the specified volumes. Otherwise, it returns a description of every volume.

" - } - } - }, - "DescribeVolumesResult":{ - "type":"structure", - "members":{ - "Volumes":{ - "shape":"Volumes", - "documentation":"

An array of volume IDs.

" - } - }, - "documentation":"

Contains the response to a DescribeVolumes request.

" - }, - "DetachElasticLoadBalancerRequest":{ - "type":"structure", - "required":[ - "ElasticLoadBalancerName", - "LayerId" - ], - "members":{ - "ElasticLoadBalancerName":{ - "shape":"String", - "documentation":"

The Elastic Load Balancing instance's name.

" - }, - "LayerId":{ - "shape":"String", - "documentation":"

The ID of the layer that the Elastic Load Balancing instance is attached to.

" - } - } - }, - "DisassociateElasticIpRequest":{ - "type":"structure", - "required":["ElasticIp"], - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

" - } - } - }, - "Double":{ - "type":"double", - "box":true - }, - "EbsBlockDevice":{ - "type":"structure", - "members":{ - "SnapshotId":{ - "shape":"String", - "documentation":"

The snapshot ID.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

The number of I/O operations per second (IOPS) that the volume supports. For more information, see EbsBlockDevice.

" - }, - "VolumeSize":{ - "shape":"Integer", - "documentation":"

The volume size, in GiB. For more information, see EbsBlockDevice.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

The volume type. gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, st1 for Throughput Optimized hard disk drives (HDD), sc1 for Cold HDD,and standard for Magnetic volumes.

If you specify the io1 volume type, you must also specify a value for the Iops attribute. The maximum ratio of provisioned IOPS to requested volume size (in GiB) is 50:1. AWS uses the default volume size (in GiB) specified in the AMI attributes to set IOPS to 50 x (volume size).

" - }, - "DeleteOnTermination":{ - "shape":"Boolean", - "documentation":"

Whether the volume is deleted on instance termination.

" - } - }, - "documentation":"

Describes an Amazon EBS volume. This data type maps directly to the Amazon EC2 EbsBlockDevice data type.

" - }, - "EcsCluster":{ - "type":"structure", - "members":{ - "EcsClusterArn":{ - "shape":"String", - "documentation":"

The cluster's ARN.

" - }, - "EcsClusterName":{ - "shape":"String", - "documentation":"

The cluster name.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "RegisteredAt":{ - "shape":"DateTime", - "documentation":"

The time and date that the cluster was registered with the stack.

" - } - }, - "documentation":"

Describes a registered Amazon ECS cluster.

" - }, - "EcsClusters":{ - "type":"list", - "member":{"shape":"EcsCluster"} - }, - "ElasticIp":{ - "type":"structure", - "members":{ - "Ip":{ - "shape":"String", - "documentation":"

The IP address.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

The domain.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The AWS region. For more information, see Regions and Endpoints.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The ID of the instance that the address is attached to.

" - } - }, - "documentation":"

Describes an Elastic IP address.

" - }, - "ElasticIps":{ - "type":"list", - "member":{"shape":"ElasticIp"} - }, - "ElasticLoadBalancer":{ - "type":"structure", - "members":{ - "ElasticLoadBalancerName":{ - "shape":"String", - "documentation":"

The Elastic Load Balancing instance's name.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The instance's AWS region.

" - }, - "DnsName":{ - "shape":"String", - "documentation":"

The instance's public DNS name.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The ID of the stack that the instance is associated with.

" - }, - "LayerId":{ - "shape":"String", - "documentation":"

The ID of the layer that the instance is attached to.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The VPC ID.

" - }, - "AvailabilityZones":{ - "shape":"Strings", - "documentation":"

A list of Availability Zones.

" - }, - "SubnetIds":{ - "shape":"Strings", - "documentation":"

A list of subnet IDs, if the stack is running in a VPC.

" - }, - "Ec2InstanceIds":{ - "shape":"Strings", - "documentation":"

A list of the EC2 instances that the Elastic Load Balancing instance is managing traffic for.

" - } - }, - "documentation":"

Describes an Elastic Load Balancing instance.

" - }, - "ElasticLoadBalancers":{ - "type":"list", - "member":{"shape":"ElasticLoadBalancer"} - }, - "EnvironmentVariable":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"String", - "documentation":"

(Required) The environment variable's name, which can consist of up to 64 characters and must be specified. The name can contain upper- and lowercase letters, numbers, and underscores (_), but it must start with a letter or underscore.

" - }, - "Value":{ - "shape":"String", - "documentation":"

(Optional) The environment variable's value, which can be left empty. If you specify a value, it can contain up to 256 characters, which must all be printable.

" - }, - "Secure":{ - "shape":"Boolean", - "documentation":"

(Optional) Whether the variable's value will be returned by the DescribeApps action. To conceal an environment variable's value, set Secure to true. DescribeApps then returns *****FILTERED***** instead of the actual value. The default value for Secure is false.

" - } - }, - "documentation":"

Represents an app's environment variable.

" - }, - "EnvironmentVariables":{ - "type":"list", - "member":{"shape":"EnvironmentVariable"} - }, - "GetHostnameSuggestionRequest":{ - "type":"structure", - "required":["LayerId"], - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - } - } - }, - "GetHostnameSuggestionResult":{ - "type":"structure", - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - }, - "Hostname":{ - "shape":"String", - "documentation":"

The generated host name.

" - } - }, - "documentation":"

Contains the response to a GetHostnameSuggestion request.

" - }, - "GrantAccessRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance's AWS OpsWorks Stacks ID.

" - }, - "ValidForInMinutes":{ - "shape":"ValidForInMinutes", - "documentation":"

The length of time (in minutes) that the grant is valid. When the grant expires at the end of this period, the user will no longer be able to use the credentials to log in. If the user is logged in at the time, he or she automatically will be logged out.

" - } - } - }, - "GrantAccessResult":{ - "type":"structure", - "members":{ - "TemporaryCredential":{ - "shape":"TemporaryCredential", - "documentation":"

A TemporaryCredential object that contains the data needed to log in to the instance by RDP clients, such as the Microsoft Remote Desktop Connection.

" - } - }, - "documentation":"

Contains the response to a GrantAccess request.

" - }, - "Hour":{"type":"string"}, - "Instance":{ - "type":"structure", - "members":{ - "AgentVersion":{ - "shape":"String", - "documentation":"

The agent version. This parameter is set to INHERIT if the instance inherits the default stack setting or to a a version number for a fixed agent version.

" - }, - "AmiId":{ - "shape":"String", - "documentation":"

A custom AMI ID to be used to create the instance. For more information, see Instances

" - }, - "Architecture":{ - "shape":"Architecture", - "documentation":"

The instance architecture: \"i386\" or \"x86_64\".

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The instance's Amazon Resource Number (ARN).

" - }, - "AutoScalingType":{ - "shape":"AutoScalingType", - "documentation":"

For load-based or time-based instances, the type.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The instance Availability Zone. For more information, see Regions and Endpoints.

" - }, - "BlockDeviceMappings":{ - "shape":"BlockDeviceMappings", - "documentation":"

An array of BlockDeviceMapping objects that specify the instance's block device mappings.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

The time that the instance was created.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

Whether this is an Amazon EBS-optimized instance.

" - }, - "Ec2InstanceId":{ - "shape":"String", - "documentation":"

The ID of the associated Amazon EC2 instance.

" - }, - "EcsClusterArn":{ - "shape":"String", - "documentation":"

For container instances, the Amazon ECS cluster's ARN.

" - }, - "EcsContainerInstanceArn":{ - "shape":"String", - "documentation":"

For container instances, the instance's ARN.

" - }, - "ElasticIp":{ - "shape":"String", - "documentation":"

The instance Elastic IP address .

" - }, - "Hostname":{ - "shape":"String", - "documentation":"

The instance host name.

" - }, - "InfrastructureClass":{ - "shape":"String", - "documentation":"

For registered instances, the infrastructure class: ec2 or on-premises.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. If this value is set to false, you must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or by manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

We strongly recommend using the default value of true, to ensure that your instances have the latest security updates.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "InstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of the instance's IAM profile. For more information about IAM ARNs, see Using Identifiers.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type, such as t2.micro.

" - }, - "LastServiceErrorId":{ - "shape":"String", - "documentation":"

The ID of the last service error. For more information, call DescribeServiceErrors.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

An array containing the instance layer IDs.

" - }, - "Os":{ - "shape":"String", - "documentation":"

The instance's operating system.

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The instance's platform.

" - }, - "PrivateDns":{ - "shape":"String", - "documentation":"

The instance's private DNS name.

" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The instance's private IP address.

" - }, - "PublicDns":{ - "shape":"String", - "documentation":"

The instance public DNS name.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The instance public IP address.

" - }, - "RegisteredBy":{ - "shape":"String", - "documentation":"

For registered instances, who performed the registration.

" - }, - "ReportedAgentVersion":{ - "shape":"String", - "documentation":"

The instance's reported AWS OpsWorks Stacks agent version.

" - }, - "ReportedOs":{ - "shape":"ReportedOs", - "documentation":"

For registered instances, the reported operating system.

" - }, - "RootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The instance's root device type. For more information, see Storage for the Root Device.

" - }, - "RootDeviceVolumeId":{ - "shape":"String", - "documentation":"

The root device volume ID.

" - }, - "SecurityGroupIds":{ - "shape":"Strings", - "documentation":"

An array containing the instance security group IDs.

" - }, - "SshHostDsaKeyFingerprint":{ - "shape":"String", - "documentation":"

The SSH key's Deep Security Agent (DSA) fingerprint.

" - }, - "SshHostRsaKeyFingerprint":{ - "shape":"String", - "documentation":"

The SSH key's RSA fingerprint.

" - }, - "SshKeyName":{ - "shape":"String", - "documentation":"

The instance's Amazon EC2 key-pair name.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The instance status:

  • booting

  • connection_lost

  • online

  • pending

  • rebooting

  • requested

  • running_setup

  • setup_failed

  • shutting_down

  • start_failed

  • stop_failed

  • stopped

  • stopping

  • terminated

  • terminating

" - }, - "SubnetId":{ - "shape":"String", - "documentation":"

The instance's subnet ID; applicable only if the stack is running in a VPC.

" - }, - "Tenancy":{ - "shape":"String", - "documentation":"

The instance's tenancy option, such as dedicated or host.

" - }, - "VirtualizationType":{ - "shape":"VirtualizationType", - "documentation":"

The instance's virtualization type: paravirtual or hvm.

" - } - }, - "documentation":"

Describes an instance.

" - }, - "InstanceIdentity":{ - "type":"structure", - "members":{ - "Document":{ - "shape":"String", - "documentation":"

A JSON document that contains the metadata.

" - }, - "Signature":{ - "shape":"String", - "documentation":"

A signature that can be used to verify the document's accuracy and authenticity.

" - } - }, - "documentation":"

Contains a description of an Amazon EC2 instance from the Amazon EC2 metadata service. For more information, see Instance Metadata and User Data.

" - }, - "Instances":{ - "type":"list", - "member":{"shape":"Instance"} - }, - "InstancesCount":{ - "type":"structure", - "members":{ - "Assigning":{ - "shape":"Integer", - "documentation":"

The number of instances in the Assigning state.

" - }, - "Booting":{ - "shape":"Integer", - "documentation":"

The number of instances with booting status.

" - }, - "ConnectionLost":{ - "shape":"Integer", - "documentation":"

The number of instances with connection_lost status.

" - }, - "Deregistering":{ - "shape":"Integer", - "documentation":"

The number of instances in the Deregistering state.

" - }, - "Online":{ - "shape":"Integer", - "documentation":"

The number of instances with online status.

" - }, - "Pending":{ - "shape":"Integer", - "documentation":"

The number of instances with pending status.

" - }, - "Rebooting":{ - "shape":"Integer", - "documentation":"

The number of instances with rebooting status.

" - }, - "Registered":{ - "shape":"Integer", - "documentation":"

The number of instances in the Registered state.

" - }, - "Registering":{ - "shape":"Integer", - "documentation":"

The number of instances in the Registering state.

" - }, - "Requested":{ - "shape":"Integer", - "documentation":"

The number of instances with requested status.

" - }, - "RunningSetup":{ - "shape":"Integer", - "documentation":"

The number of instances with running_setup status.

" - }, - "SetupFailed":{ - "shape":"Integer", - "documentation":"

The number of instances with setup_failed status.

" - }, - "ShuttingDown":{ - "shape":"Integer", - "documentation":"

The number of instances with shutting_down status.

" - }, - "StartFailed":{ - "shape":"Integer", - "documentation":"

The number of instances with start_failed status.

" - }, - "StopFailed":{ - "shape":"Integer", - "documentation":"

The number of instances with stop_failed status.

" - }, - "Stopped":{ - "shape":"Integer", - "documentation":"

The number of instances with stopped status.

" - }, - "Stopping":{ - "shape":"Integer", - "documentation":"

The number of instances with stopping status.

" - }, - "Terminated":{ - "shape":"Integer", - "documentation":"

The number of instances with terminated status.

" - }, - "Terminating":{ - "shape":"Integer", - "documentation":"

The number of instances with terminating status.

" - }, - "Unassigning":{ - "shape":"Integer", - "documentation":"

The number of instances in the Unassigning state.

" - } - }, - "documentation":"

Describes how many instances a stack has for each status.

" - }, - "Integer":{ - "type":"integer", - "box":true - }, - "Layer":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"String", - "documentation":"

The Amazon Resource Number (ARN) of a layer.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The layer stack ID.

" - }, - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - }, - "Type":{ - "shape":"LayerType", - "documentation":"

The layer type.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The layer name.

" - }, - "Shortname":{ - "shape":"String", - "documentation":"

The layer short name.

" - }, - "Attributes":{ - "shape":"LayerAttributes", - "documentation":"

The layer attributes.

For the HaproxyStatsPassword, MysqlRootPassword, and GangliaPassword attributes, AWS OpsWorks Stacks returns *****FILTERED***** instead of the actual value

For an ECS Cluster layer, AWS OpsWorks Stacks the EcsClusterArn attribute is set to the cluster's ARN.

" - }, - "CloudWatchLogsConfiguration":{ - "shape":"CloudWatchLogsConfiguration", - "documentation":"

The Amazon CloudWatch Logs configuration settings for the layer.

" - }, - "CustomInstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of the default IAM profile to be used for the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A JSON formatted string containing the layer's custom stack configuration and deployment attributes.

" - }, - "CustomSecurityGroupIds":{ - "shape":"Strings", - "documentation":"

An array containing the layer's custom security group IDs.

" - }, - "DefaultSecurityGroupNames":{ - "shape":"Strings", - "documentation":"

An array containing the layer's security group names.

" - }, - "Packages":{ - "shape":"Strings", - "documentation":"

An array of Package objects that describe the layer's packages.

" - }, - "VolumeConfigurations":{ - "shape":"VolumeConfigurations", - "documentation":"

A VolumeConfigurations object that describes the layer's Amazon EBS volumes.

" - }, - "EnableAutoHealing":{ - "shape":"Boolean", - "documentation":"

Whether auto healing is disabled for the layer.

" - }, - "AutoAssignElasticIps":{ - "shape":"Boolean", - "documentation":"

Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "AutoAssignPublicIps":{ - "shape":"Boolean", - "documentation":"

For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "DefaultRecipes":{"shape":"Recipes"}, - "CustomRecipes":{ - "shape":"Recipes", - "documentation":"

A LayerCustomRecipes object that specifies the layer's custom recipes.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

Date when the layer was created.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. If this value is set to false, you must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

We strongly recommend using the default value of true, to ensure that your instances have the latest security updates.

" - }, - "UseEbsOptimizedInstances":{ - "shape":"Boolean", - "documentation":"

Whether the layer uses Amazon EBS-optimized instances.

" - }, - "LifecycleEventConfiguration":{ - "shape":"LifecycleEventConfiguration", - "documentation":"

A LifeCycleEventConfiguration object that specifies the Shutdown event configuration.

" - } - }, - "documentation":"

Describes a layer.

" - }, - "LayerAttributes":{ - "type":"map", - "key":{"shape":"LayerAttributesKeys"}, - "value":{"shape":"String"} - }, - "LayerAttributesKeys":{ - "type":"string", - "enum":[ - "EcsClusterArn", - "EnableHaproxyStats", - "HaproxyStatsUrl", - "HaproxyStatsUser", - "HaproxyStatsPassword", - "HaproxyHealthCheckUrl", - "HaproxyHealthCheckMethod", - "MysqlRootPassword", - "MysqlRootPasswordUbiquitous", - "GangliaUrl", - "GangliaUser", - "GangliaPassword", - "MemcachedMemory", - "NodejsVersion", - "RubyVersion", - "RubygemsVersion", - "ManageBundler", - "BundlerVersion", - "RailsStack", - "PassengerVersion", - "Jvm", - "JvmVersion", - "JvmOptions", - "JavaAppServer", - "JavaAppServerVersion" - ] - }, - "LayerType":{ - "type":"string", - "enum":[ - "aws-flow-ruby", - "ecs-cluster", - "java-app", - "lb", - "web", - "php-app", - "rails-app", - "nodejs-app", - "memcached", - "db-master", - "monitoring-master", - "custom" - ] - }, - "Layers":{ - "type":"list", - "member":{"shape":"Layer"} - }, - "LifecycleEventConfiguration":{ - "type":"structure", - "members":{ - "Shutdown":{ - "shape":"ShutdownEventConfiguration", - "documentation":"

A ShutdownEventConfiguration object that specifies the Shutdown event configuration.

" - } - }, - "documentation":"

Specifies the lifecycle event configuration

" - }, - "ListTagsRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The stack or layer's Amazon Resource Number (ARN).

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Do not use. A validation exception occurs if you add a MaxResults parameter to a ListTagsRequest call.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Do not use. A validation exception occurs if you add a NextToken parameter to a ListTagsRequest call.

" - } - } - }, - "ListTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"Tags", - "documentation":"

A set of key-value pairs that contain tag keys and tag values that are attached to a stack or layer.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If a paginated request does not return all of the remaining results, this parameter is set to a token that you can assign to the request object's NextToken parameter to get the next set of results. If the previous paginated request returned all of the remaining results, this parameter is set to null.

" - } - }, - "documentation":"

Contains the response to a ListTags request.

" - }, - "LoadBasedAutoScalingConfiguration":{ - "type":"structure", - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - }, - "Enable":{ - "shape":"Boolean", - "documentation":"

Whether load-based auto scaling is enabled for the layer.

" - }, - "UpScaling":{ - "shape":"AutoScalingThresholds", - "documentation":"

An AutoScalingThresholds object that describes the upscaling configuration, which defines how and when AWS OpsWorks Stacks increases the number of instances.

" - }, - "DownScaling":{ - "shape":"AutoScalingThresholds", - "documentation":"

An AutoScalingThresholds object that describes the downscaling configuration, which defines how and when AWS OpsWorks Stacks reduces the number of instances.

" - } - }, - "documentation":"

Describes a layer's load-based auto scaling configuration.

" - }, - "LoadBasedAutoScalingConfigurations":{ - "type":"list", - "member":{"shape":"LoadBasedAutoScalingConfiguration"} - }, - "MaxResults":{"type":"integer"}, - "Minute":{ - "type":"integer", - "box":true, - "max":100, - "min":1 - }, - "NextToken":{"type":"string"}, - "OperatingSystem":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the operating system, such as Amazon Linux 2017.09.

" - }, - "Id":{ - "shape":"String", - "documentation":"

The ID of a supported operating system, such as Amazon Linux 2017.09.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of a supported operating system, either Linux or Windows.

" - }, - "ConfigurationManagers":{ - "shape":"OperatingSystemConfigurationManagers", - "documentation":"

Supported configuration manager name and versions for an AWS OpsWorks Stacks operating system.

" - }, - "ReportedName":{ - "shape":"String", - "documentation":"

A short name for the operating system manufacturer.

" - }, - "ReportedVersion":{ - "shape":"String", - "documentation":"

The version of the operating system, including the release and edition, if applicable.

" - }, - "Supported":{ - "shape":"Boolean", - "documentation":"

Indicates that an operating system is not supported for new instances.

" - } - }, - "documentation":"

Describes supported operating systems in AWS OpsWorks Stacks.

" - }, - "OperatingSystemConfigurationManager":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the configuration manager, which is Chef.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The versions of the configuration manager that are supported by an operating system.

" - } - }, - "documentation":"

A block that contains information about the configuration manager (Chef) and the versions of the configuration manager that are supported for an operating system.

" - }, - "OperatingSystemConfigurationManagers":{ - "type":"list", - "member":{"shape":"OperatingSystemConfigurationManager"} - }, - "OperatingSystems":{ - "type":"list", - "member":{"shape":"OperatingSystem"} - }, - "Parameters":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Permission":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

A stack ID.

" - }, - "IamUserArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for an AWS Identity and Access Management (IAM) role. For more information about IAM ARNs, see Using Identifiers.

" - }, - "AllowSsh":{ - "shape":"Boolean", - "documentation":"

Whether the user can use SSH.

" - }, - "AllowSudo":{ - "shape":"Boolean", - "documentation":"

Whether the user can use sudo.

" - }, - "Level":{ - "shape":"String", - "documentation":"

The user's permission level, which must be the following:

  • deny

  • show

  • deploy

  • manage

  • iam_only

For more information on the permissions associated with these levels, see Managing User Permissions

" - } - }, - "documentation":"

Describes stack or user permissions.

" - }, - "Permissions":{ - "type":"list", - "member":{"shape":"Permission"} - }, - "RaidArray":{ - "type":"structure", - "members":{ - "RaidArrayId":{ - "shape":"String", - "documentation":"

The array ID.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The array name.

" - }, - "RaidLevel":{ - "shape":"Integer", - "documentation":"

The RAID level.

" - }, - "NumberOfDisks":{ - "shape":"Integer", - "documentation":"

The number of disks in the array.

" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The array's size.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The array's Linux device. For example /dev/mdadm0.

" - }, - "MountPoint":{ - "shape":"String", - "documentation":"

The array's mount point.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The array's Availability Zone. For more information, see Regions and Endpoints.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

When the RAID array was created.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type, standard or PIOPS.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

For PIOPS volumes, the IOPS per disk.

" - } - }, - "documentation":"

Describes an instance's RAID array.

" - }, - "RaidArrays":{ - "type":"list", - "member":{"shape":"RaidArray"} - }, - "RdsDbInstance":{ - "type":"structure", - "members":{ - "RdsDbInstanceArn":{ - "shape":"String", - "documentation":"

The instance's ARN.

" - }, - "DbInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier.

" - }, - "DbUser":{ - "shape":"String", - "documentation":"

The master user name.

" - }, - "DbPassword":{ - "shape":"String", - "documentation":"

AWS OpsWorks Stacks returns *****FILTERED***** instead of the actual value.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The instance's AWS region.

" - }, - "Address":{ - "shape":"String", - "documentation":"

The instance's address.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The instance's database engine.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The ID of the stack with which the instance is registered.

" - }, - "MissingOnRds":{ - "shape":"Boolean", - "documentation":"

Set to true if AWS OpsWorks Stacks is unable to discover the Amazon RDS instance. AWS OpsWorks Stacks attempts to discover the instance only once. If this value is set to true, you must deregister the instance, and then register it again.

" - } - }, - "documentation":"

Describes an Amazon RDS instance.

" - }, - "RdsDbInstances":{ - "type":"list", - "member":{"shape":"RdsDbInstance"} - }, - "RebootInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "Recipes":{ - "type":"structure", - "members":{ - "Setup":{ - "shape":"Strings", - "documentation":"

An array of custom recipe names to be run following a setup event.

" - }, - "Configure":{ - "shape":"Strings", - "documentation":"

An array of custom recipe names to be run following a configure event.

" - }, - "Deploy":{ - "shape":"Strings", - "documentation":"

An array of custom recipe names to be run following a deploy event.

" - }, - "Undeploy":{ - "shape":"Strings", - "documentation":"

An array of custom recipe names to be run following a undeploy event.

" - }, - "Shutdown":{ - "shape":"Strings", - "documentation":"

An array of custom recipe names to be run following a shutdown event.

" - } - }, - "documentation":"

AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown. For each layer, AWS OpsWorks Stacks runs a set of standard recipes for each event. In addition, you can provide custom recipes for any or all layers and events. AWS OpsWorks Stacks runs custom event recipes after the standard recipes. LayerCustomRecipes specifies the custom recipes for a particular layer to be run in response to each of the five events.

To specify a recipe, use the cookbook's directory name in the repository followed by two colons and the recipe name, which is the recipe's file name without the .rb extension. For example: phpapp2::dbsetup specifies the dbsetup.rb recipe in the repository's phpapp2 folder.

" - }, - "RegisterEcsClusterRequest":{ - "type":"structure", - "required":[ - "EcsClusterArn", - "StackId" - ], - "members":{ - "EcsClusterArn":{ - "shape":"String", - "documentation":"

The cluster's ARN.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "RegisterEcsClusterResult":{ - "type":"structure", - "members":{ - "EcsClusterArn":{ - "shape":"String", - "documentation":"

The cluster's ARN.

" - } - }, - "documentation":"

Contains the response to a RegisterEcsCluster request.

" - }, - "RegisterElasticIpRequest":{ - "type":"structure", - "required":[ - "ElasticIp", - "StackId" - ], - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "RegisterElasticIpResult":{ - "type":"structure", - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP address.

" - } - }, - "documentation":"

Contains the response to a RegisterElasticIp request.

" - }, - "RegisterInstanceRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The ID of the stack that the instance is to be registered with.

" - }, - "Hostname":{ - "shape":"String", - "documentation":"

The instance's hostname.

" - }, - "PublicIp":{ - "shape":"String", - "documentation":"

The instance's public IP address.

" - }, - "PrivateIp":{ - "shape":"String", - "documentation":"

The instance's private IP address.

" - }, - "RsaPublicKey":{ - "shape":"String", - "documentation":"

The instances public RSA key. This key is used to encrypt communication between the instance and the service.

" - }, - "RsaPublicKeyFingerprint":{ - "shape":"String", - "documentation":"

The instances public RSA key fingerprint.

" - }, - "InstanceIdentity":{ - "shape":"InstanceIdentity", - "documentation":"

An InstanceIdentity object that contains the instance's identity.

" - } - } - }, - "RegisterInstanceResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The registered instance's AWS OpsWorks Stacks ID.

" - } - }, - "documentation":"

Contains the response to a RegisterInstanceResult request.

" - }, - "RegisterRdsDbInstanceRequest":{ - "type":"structure", - "required":[ - "StackId", - "RdsDbInstanceArn", - "DbUser", - "DbPassword" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "RdsDbInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon RDS instance's ARN.

" - }, - "DbUser":{ - "shape":"String", - "documentation":"

The database's master user name.

" - }, - "DbPassword":{ - "shape":"String", - "documentation":"

The database password.

" - } - } - }, - "RegisterVolumeRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "Ec2VolumeId":{ - "shape":"String", - "documentation":"

The Amazon EBS volume ID.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "RegisterVolumeResult":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

" - } - }, - "documentation":"

Contains the response to a RegisterVolume request.

" - }, - "ReportedOs":{ - "type":"structure", - "members":{ - "Family":{ - "shape":"String", - "documentation":"

The operating system family.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The operating system name.

" - }, - "Version":{ - "shape":"String", - "documentation":"

The operating system version.

" - } - }, - "documentation":"

A registered instance's reported operating system.

" - }, - "ResourceArn":{"type":"string"}, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The exception message.

" - } - }, - "documentation":"

Indicates that a resource was not found.

", - "exception":true - }, - "RootDeviceType":{ - "type":"string", - "enum":[ - "ebs", - "instance-store" - ] - }, - "SelfUserProfile":{ - "type":"structure", - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The user's name.

" - }, - "SshUsername":{ - "shape":"String", - "documentation":"

The user's SSH user name.

" - }, - "SshPublicKey":{ - "shape":"String", - "documentation":"

The user's SSH public key.

" - } - }, - "documentation":"

Describes a user's SSH information.

" - }, - "ServiceError":{ - "type":"structure", - "members":{ - "ServiceErrorId":{ - "shape":"String", - "documentation":"

The error ID.

" - }, - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The error type.

" - }, - "Message":{ - "shape":"String", - "documentation":"

A message that describes the error.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

When the error occurred.

" - } - }, - "documentation":"

Describes an AWS OpsWorks Stacks service error.

" - }, - "ServiceErrors":{ - "type":"list", - "member":{"shape":"ServiceError"} - }, - "SetLoadBasedAutoScalingRequest":{ - "type":"structure", - "required":["LayerId"], - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - }, - "Enable":{ - "shape":"Boolean", - "documentation":"

Enables load-based auto scaling for the layer.

" - }, - "UpScaling":{ - "shape":"AutoScalingThresholds", - "documentation":"

An AutoScalingThresholds object with the upscaling threshold configuration. If the load exceeds these thresholds for a specified amount of time, AWS OpsWorks Stacks starts a specified number of instances.

" - }, - "DownScaling":{ - "shape":"AutoScalingThresholds", - "documentation":"

An AutoScalingThresholds object with the downscaling threshold configuration. If the load falls below these thresholds for a specified amount of time, AWS OpsWorks Stacks stops a specified number of instances.

" - } - } - }, - "SetPermissionRequest":{ - "type":"structure", - "required":[ - "StackId", - "IamUserArn" - ], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN. This can also be a federated user's ARN.

" - }, - "AllowSsh":{ - "shape":"Boolean", - "documentation":"

The user is allowed to use SSH to communicate with the instance.

" - }, - "AllowSudo":{ - "shape":"Boolean", - "documentation":"

The user is allowed to use sudo to elevate privileges.

" - }, - "Level":{ - "shape":"String", - "documentation":"

The user's permission level, which must be set to one of the following strings. You cannot set your own permissions level.

  • deny

  • show

  • deploy

  • manage

  • iam_only

For more information about the permissions associated with these levels, see Managing User Permissions.

" - } - } - }, - "SetTimeBasedAutoScalingRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "AutoScalingSchedule":{ - "shape":"WeeklyAutoScalingSchedule", - "documentation":"

An AutoScalingSchedule with the instance schedule.

" - } - } - }, - "ShutdownEventConfiguration":{ - "type":"structure", - "members":{ - "ExecutionTimeout":{ - "shape":"Integer", - "documentation":"

The time, in seconds, that AWS OpsWorks Stacks will wait after triggering a Shutdown event before shutting down an instance.

" - }, - "DelayUntilElbConnectionsDrained":{ - "shape":"Boolean", - "documentation":"

Whether to enable Elastic Load Balancing connection draining. For more information, see Connection Draining

" - } - }, - "documentation":"

The Shutdown event configuration.

" - }, - "Source":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"SourceType", - "documentation":"

The repository type.

" - }, - "Url":{ - "shape":"String", - "documentation":"

The source URL. The following is an example of an Amazon S3 source URL: https://s3.amazonaws.com/opsworks-demo-bucket/opsworks_cookbook_demo.tar.gz.

" - }, - "Username":{ - "shape":"String", - "documentation":"

This parameter depends on the repository type.

  • For Amazon S3 bundles, set Username to the appropriate IAM access key ID.

  • For HTTP bundles, Git repositories, and Subversion repositories, set Username to the user name.

" - }, - "Password":{ - "shape":"String", - "documentation":"

When included in a request, the parameter depends on the repository type.

  • For Amazon S3 bundles, set Password to the appropriate IAM secret access key.

  • For HTTP bundles and Subversion repositories, set Password to the password.

For more information on how to safely handle IAM credentials, see http://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html.

In responses, AWS OpsWorks Stacks returns *****FILTERED***** instead of the actual value.

" - }, - "SshKey":{ - "shape":"String", - "documentation":"

In requests, the repository's SSH key.

In responses, AWS OpsWorks Stacks returns *****FILTERED***** instead of the actual value.

" - }, - "Revision":{ - "shape":"String", - "documentation":"

The application's version. AWS OpsWorks Stacks enables you to easily deploy new versions of an application. One of the simplest approaches is to have branches or revisions in your repository that represent different versions that can potentially be deployed.

" - } - }, - "documentation":"

Contains the information required to retrieve an app or cookbook from a repository. For more information, see Creating Apps or Custom Recipes and Cookbooks.

" - }, - "SourceType":{ - "type":"string", - "enum":[ - "git", - "svn", - "archive", - "s3" - ] - }, - "SslConfiguration":{ - "type":"structure", - "required":[ - "Certificate", - "PrivateKey" - ], - "members":{ - "Certificate":{ - "shape":"String", - "documentation":"

The contents of the certificate's domain.crt file.

" - }, - "PrivateKey":{ - "shape":"String", - "documentation":"

The private key; the contents of the certificate's domain.kex file.

" - }, - "Chain":{ - "shape":"String", - "documentation":"

Optional. Can be used to specify an intermediate certificate authority key or client authentication.

" - } - }, - "documentation":"

Describes an app's SSL configuration.

" - }, - "Stack":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The stack name.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The stack's ARN.

" - }, - "Region":{ - "shape":"String", - "documentation":"

The stack AWS region, such as \"ap-northeast-2\". For more information about AWS regions, see Regions and Endpoints.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The VPC ID; applicable only if the stack is running in a VPC.

" - }, - "Attributes":{ - "shape":"StackAttributes", - "documentation":"

The stack's attributes.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

The stack AWS Identity and Access Management (IAM) role.

" - }, - "DefaultInstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of an IAM profile that is the default profile for all of the stack's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "DefaultOs":{ - "shape":"String", - "documentation":"

The stack's default operating system.

" - }, - "HostnameTheme":{ - "shape":"String", - "documentation":"

The stack host name theme, with spaces replaced by underscores.

" - }, - "DefaultAvailabilityZone":{ - "shape":"String", - "documentation":"

The stack's default Availability Zone. For more information, see Regions and Endpoints.

" - }, - "DefaultSubnetId":{ - "shape":"String", - "documentation":"

The default subnet ID; applicable only if the stack is running in a VPC.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A JSON object that contains user-defined attributes to be added to the stack configuration and deployment attributes. You can use custom JSON to override the corresponding default stack configuration attribute values or to pass data to recipes. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information on custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes.

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager.

" - }, - "ChefConfiguration":{ - "shape":"ChefConfiguration", - "documentation":"

A ChefConfiguration object that specifies whether to enable Berkshelf and the Berkshelf version. For more information, see Create a New Stack.

" - }, - "UseCustomCookbooks":{ - "shape":"Boolean", - "documentation":"

Whether the stack uses custom cookbooks.

" - }, - "UseOpsworksSecurityGroups":{ - "shape":"Boolean", - "documentation":"

Whether the stack automatically associates the AWS OpsWorks Stacks built-in security groups with the stack's layers.

" - }, - "CustomCookbooksSource":{"shape":"Source"}, - "DefaultSshKeyName":{ - "shape":"String", - "documentation":"

A default Amazon EC2 key pair for the stack's instances. You can override this value when you create or update an instance.

" - }, - "CreatedAt":{ - "shape":"DateTime", - "documentation":"

The date when the stack was created.

" - }, - "DefaultRootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The default root device type. This value is used by default for all instances in the stack, but you can override it when you create an instance. For more information, see Storage for the Root Device.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The agent version. This parameter is set to LATEST for auto-update. or a version number for a fixed agent version.

" - } - }, - "documentation":"

Describes a stack.

" - }, - "StackAttributes":{ - "type":"map", - "key":{"shape":"StackAttributesKeys"}, - "value":{"shape":"String"} - }, - "StackAttributesKeys":{ - "type":"string", - "enum":["Color"] - }, - "StackConfigurationManager":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name. This parameter must be set to \"Chef\".

" - }, - "Version":{ - "shape":"String", - "documentation":"

The Chef version. This parameter must be set to 12, 11.10, or 11.4 for Linux stacks, and to 12.2 for Windows stacks. The default value for Linux stacks is 11.4.

" - } - }, - "documentation":"

Describes the configuration manager.

" - }, - "StackSummary":{ - "type":"structure", - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The stack name.

" - }, - "Arn":{ - "shape":"String", - "documentation":"

The stack's ARN.

" - }, - "LayersCount":{ - "shape":"Integer", - "documentation":"

The number of layers.

" - }, - "AppsCount":{ - "shape":"Integer", - "documentation":"

The number of apps.

" - }, - "InstancesCount":{ - "shape":"InstancesCount", - "documentation":"

An InstancesCount object with the number of instances in each status.

" - } - }, - "documentation":"

Summarizes the number of layers, instances, and apps in a stack.

" - }, - "Stacks":{ - "type":"list", - "member":{"shape":"Stack"} - }, - "StartInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "StartStackRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "StopInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "Force":{ - "shape":"Boolean", - "documentation":"

Specifies whether to force an instance to stop.

" - } - } - }, - "StopStackRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - } - } - }, - "String":{"type":"string"}, - "Strings":{ - "type":"list", - "member":{"shape":"String"} - }, - "Switch":{"type":"string"}, - "TagKey":{"type":"string"}, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The stack or layer's Amazon Resource Number (ARN).

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

A map that contains tag keys and tag values that are attached to a stack or layer.

  • The key cannot be empty.

  • The key can be a maximum of 127 characters, and can contain only Unicode letters, numbers, or separators, or the following special characters: + - = . _ : /

  • The value can be a maximum 255 characters, and contain only Unicode letters, numbers, or separators, or the following special characters: + - = . _ : /

  • Leading and trailing white spaces are trimmed from both the key and value.

  • A maximum of 40 tags is allowed for any resource.

" - } - } - }, - "TagValue":{"type":"string"}, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"} - }, - "TemporaryCredential":{ - "type":"structure", - "members":{ - "Username":{ - "shape":"String", - "documentation":"

The user name.

" - }, - "Password":{ - "shape":"String", - "documentation":"

The password.

" - }, - "ValidForInMinutes":{ - "shape":"Integer", - "documentation":"

The length of time (in minutes) that the grant is valid. When the grant expires, at the end of this period, the user will no longer be able to use the credentials to log in. If they are logged in at the time, they will be automatically logged out.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance's AWS OpsWorks Stacks ID.

" - } - }, - "documentation":"

Contains the data needed by RDP clients such as the Microsoft Remote Desktop Connection to log in to the instance.

" - }, - "TimeBasedAutoScalingConfiguration":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "AutoScalingSchedule":{ - "shape":"WeeklyAutoScalingSchedule", - "documentation":"

A WeeklyAutoScalingSchedule object with the instance schedule.

" - } - }, - "documentation":"

Describes an instance's time-based auto scaling configuration.

" - }, - "TimeBasedAutoScalingConfigurations":{ - "type":"list", - "member":{"shape":"TimeBasedAutoScalingConfiguration"} - }, - "UnassignInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - } - } - }, - "UnassignVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

" - } - } - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The stack or layer's Amazon Resource Number (ARN).

" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

A list of the keys of tags to be removed from a stack or layer.

" - } - } - }, - "UpdateAppRequest":{ - "type":"structure", - "required":["AppId"], - "members":{ - "AppId":{ - "shape":"String", - "documentation":"

The app ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The app name.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the app.

" - }, - "DataSources":{ - "shape":"DataSources", - "documentation":"

The app's data sources.

" - }, - "Type":{ - "shape":"AppType", - "documentation":"

The app type.

" - }, - "AppSource":{ - "shape":"Source", - "documentation":"

A Source object that specifies the app repository.

" - }, - "Domains":{ - "shape":"Strings", - "documentation":"

The app's virtual host settings, with multiple domains separated by commas. For example: 'www.example.com, example.com'

" - }, - "EnableSsl":{ - "shape":"Boolean", - "documentation":"

Whether SSL is enabled for the app.

" - }, - "SslConfiguration":{ - "shape":"SslConfiguration", - "documentation":"

An SslConfiguration object with the SSL configuration.

" - }, - "Attributes":{ - "shape":"AppAttributes", - "documentation":"

One or more user-defined key/value pairs to be added to the stack attributes.

" - }, - "Environment":{ - "shape":"EnvironmentVariables", - "documentation":"

An array of EnvironmentVariable objects that specify environment variables to be associated with the app. After you deploy the app, these variables are defined on the associated app server instances.For more information, see Environment Variables.

There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variables' names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases. Exceeding it will cause an exception with the message, \"Environment: is too large (maximum is 10KB).\"

This parameter is supported only by Chef 11.10 stacks. If you have specified one or more environment variables, you cannot modify the stack's Chef version.

" - } - } - }, - "UpdateElasticIpRequest":{ - "type":"structure", - "required":["ElasticIp"], - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The IP address for which you want to update the name.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The new name.

" - } - } - }, - "UpdateInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "LayerIds":{ - "shape":"Strings", - "documentation":"

The instance's layer IDs.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type, such as t2.micro. For a list of supported instance types, open the stack in the console, choose Instances, and choose + Instance. The Size list contains the currently supported types. For more information, see Instance Families and Types. The parameter values that you use to specify the various types are in the API Name column of the Available Instance Types table.

" - }, - "AutoScalingType":{ - "shape":"AutoScalingType", - "documentation":"

For load-based or time-based instances, the type. Windows stacks can use only time-based instances.

" - }, - "Hostname":{ - "shape":"String", - "documentation":"

The instance host name.

" - }, - "Os":{ - "shape":"String", - "documentation":"

The instance's operating system, which must be set to one of the following. You cannot update an instance that is using a custom AMI.

  • A supported Linux operating system: An Amazon Linux version, such as Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.

  • A supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.

  • CentOS Linux 7

  • Red Hat Enterprise Linux 7

  • A supported Windows operating system, such as Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.

For more information about supported operating systems, see AWS OpsWorks Stacks Operating Systems.

The default option is the current Amazon Linux version. If you set this parameter to Custom, you must use the AmiId parameter to specify the custom AMI that you want to use. For more information about supported operating systems, see Operating Systems. For more information about how to use custom AMIs with OpsWorks, see Using Custom AMIs.

You can specify a different Linux operating system for the updated stack, but you cannot change from Linux to Windows or Windows to Linux.

" - }, - "AmiId":{ - "shape":"String", - "documentation":"

The ID of the AMI that was used to create the instance. The value of this parameter must be the same AMI ID that the instance is already using. You cannot apply a new AMI to an instance by running UpdateInstance. UpdateInstance does not work on instances that are using custom AMIs.

" - }, - "SshKeyName":{ - "shape":"String", - "documentation":"

The instance's Amazon EC2 key name.

" - }, - "Architecture":{ - "shape":"Architecture", - "documentation":"

The instance architecture. Instance types do not necessarily support both architectures. For a list of the architectures that are supported by the different instance types, see Instance Families and Types.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. To control when updates are installed, set this value to false. You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or by manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

We strongly recommend using the default value of true, to ensure that your instances have the latest security updates.

" - }, - "EbsOptimized":{ - "shape":"Boolean", - "documentation":"

This property cannot be updated.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The default AWS OpsWorks Stacks agent version. You have the following options:

  • INHERIT - Use the stack's default agent version setting.

  • version_number - Use the specified agent version. This value overrides the stack's default setting. To update the agent version, you must edit the instance configuration and specify a new version. AWS OpsWorks Stacks then automatically installs that version on the instance.

The default setting is INHERIT. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call DescribeAgentVersions.

AgentVersion cannot be set to Chef 12.2.

" - } - } - }, - "UpdateLayerRequest":{ - "type":"structure", - "required":["LayerId"], - "members":{ - "LayerId":{ - "shape":"String", - "documentation":"

The layer ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The layer name, which is used by the console.

" - }, - "Shortname":{ - "shape":"String", - "documentation":"

For custom layers only, use this parameter to specify the layer's short name, which is used internally by AWS OpsWorks Stacks and by Chef. The short name is also used as the name for the directory where your app files are installed. It can have a maximum of 200 characters and must be in the following format: /\\A[a-z0-9\\-\\_\\.]+\\Z/.

The built-in layers' short names are defined by AWS OpsWorks Stacks. For more information, see the Layer Reference

" - }, - "Attributes":{ - "shape":"LayerAttributes", - "documentation":"

One or more user-defined key/value pairs to be added to the stack attributes.

" - }, - "CloudWatchLogsConfiguration":{ - "shape":"CloudWatchLogsConfiguration", - "documentation":"

Specifies CloudWatch Logs configuration options for the layer. For more information, see CloudWatchLogsLogStream.

" - }, - "CustomInstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of an IAM profile to be used for all of the layer's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A JSON-formatted string containing custom stack configuration and deployment attributes to be installed on the layer's instances. For more information, see Using Custom JSON.

" - }, - "CustomSecurityGroupIds":{ - "shape":"Strings", - "documentation":"

An array containing the layer's custom security group IDs.

" - }, - "Packages":{ - "shape":"Strings", - "documentation":"

An array of Package objects that describe the layer's packages.

" - }, - "VolumeConfigurations":{ - "shape":"VolumeConfigurations", - "documentation":"

A VolumeConfigurations object that describes the layer's Amazon EBS volumes.

" - }, - "EnableAutoHealing":{ - "shape":"Boolean", - "documentation":"

Whether to disable auto healing for the layer.

" - }, - "AutoAssignElasticIps":{ - "shape":"Boolean", - "documentation":"

Whether to automatically assign an Elastic IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "AutoAssignPublicIps":{ - "shape":"Boolean", - "documentation":"

For stacks that are running in a VPC, whether to automatically assign a public IP address to the layer's instances. For more information, see How to Edit a Layer.

" - }, - "CustomRecipes":{ - "shape":"Recipes", - "documentation":"

A LayerCustomRecipes object that specifies the layer's custom recipes.

" - }, - "InstallUpdatesOnBoot":{ - "shape":"Boolean", - "documentation":"

Whether to install operating system and package updates when the instance boots. The default value is true. To control when updates are installed, set this value to false. You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

We strongly recommend using the default value of true, to ensure that your instances have the latest security updates.

" - }, - "UseEbsOptimizedInstances":{ - "shape":"Boolean", - "documentation":"

Whether to use Amazon EBS-optimized instances.

" - }, - "LifecycleEventConfiguration":{ - "shape":"LifecycleEventConfiguration", - "documentation":"

" - } - } - }, - "UpdateMyUserProfileRequest":{ - "type":"structure", - "members":{ - "SshPublicKey":{ - "shape":"String", - "documentation":"

The user's SSH public key.

" - } - } - }, - "UpdateRdsDbInstanceRequest":{ - "type":"structure", - "required":["RdsDbInstanceArn"], - "members":{ - "RdsDbInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon RDS instance's ARN.

" - }, - "DbUser":{ - "shape":"String", - "documentation":"

The master user name.

" - }, - "DbPassword":{ - "shape":"String", - "documentation":"

The database password.

" - } - } - }, - "UpdateStackRequest":{ - "type":"structure", - "required":["StackId"], - "members":{ - "StackId":{ - "shape":"String", - "documentation":"

The stack ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The stack's new name.

" - }, - "Attributes":{ - "shape":"StackAttributes", - "documentation":"

One or more user-defined key-value pairs to be added to the stack attributes.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

Do not use this parameter. You cannot update a stack's service role.

" - }, - "DefaultInstanceProfileArn":{ - "shape":"String", - "documentation":"

The ARN of an IAM profile that is the default profile for all of the stack's EC2 instances. For more information about IAM ARNs, see Using Identifiers.

" - }, - "DefaultOs":{ - "shape":"String", - "documentation":"

The stack's operating system, which must be set to one of the following:

  • A supported Linux operating system: An Amazon Linux version, such as Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.

  • A supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.

  • CentOS Linux 7

  • Red Hat Enterprise Linux 7

  • A supported Windows operating system, such as Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.

  • A custom AMI: Custom. You specify the custom AMI you want to use when you create instances. For more information about how to use custom AMIs with OpsWorks, see Using Custom AMIs.

The default option is the stack's current operating system. For more information about supported operating systems, see AWS OpsWorks Stacks Operating Systems.

" - }, - "HostnameTheme":{ - "shape":"String", - "documentation":"

The stack's new host name theme, with spaces replaced by underscores. The theme is used to generate host names for the stack's instances. By default, HostnameTheme is set to Layer_Dependent, which creates host names by appending integers to the layer's short name. The other themes are:

  • Baked_Goods

  • Clouds

  • Europe_Cities

  • Fruits

  • Greek_Deities

  • Legendary_creatures_from_Japan

  • Planets_and_Moons

  • Roman_Deities

  • Scottish_Islands

  • US_Cities

  • Wild_Cats

To obtain a generated host name, call GetHostNameSuggestion, which returns a host name based on the current theme.

" - }, - "DefaultAvailabilityZone":{ - "shape":"String", - "documentation":"

The stack's default Availability Zone, which must be in the stack's region. For more information, see Regions and Endpoints. If you also specify a value for DefaultSubnetId, the subnet must be in the same zone. For more information, see CreateStack.

" - }, - "DefaultSubnetId":{ - "shape":"String", - "documentation":"

The stack's default VPC subnet ID. This parameter is required if you specify a value for the VpcId parameter. All instances are launched into this subnet unless you specify otherwise when you create the instance. If you also specify a value for DefaultAvailabilityZone, the subnet must be in that zone. For information on default values and when this parameter is required, see the VpcId parameter description.

" - }, - "CustomJson":{ - "shape":"String", - "documentation":"

A string that contains user-defined, custom JSON. It can be used to override the corresponding default stack configuration JSON values or to pass data to recipes. The string should be in the following format:

\"{\\\"key1\\\": \\\"value1\\\", \\\"key2\\\": \\\"value2\\\",...}\"

For more information about custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes.

" - }, - "ConfigurationManager":{ - "shape":"StackConfigurationManager", - "documentation":"

The configuration manager. When you update a stack, we recommend that you use the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is currently 12.

" - }, - "ChefConfiguration":{ - "shape":"ChefConfiguration", - "documentation":"

A ChefConfiguration object that specifies whether to enable Berkshelf and the Berkshelf version on Chef 11.10 stacks. For more information, see Create a New Stack.

" - }, - "UseCustomCookbooks":{ - "shape":"Boolean", - "documentation":"

Whether the stack uses custom cookbooks.

" - }, - "CustomCookbooksSource":{"shape":"Source"}, - "DefaultSshKeyName":{ - "shape":"String", - "documentation":"

A default Amazon EC2 key-pair name. The default value is none. If you specify a key-pair name, AWS OpsWorks Stacks installs the public key on the instance and you can use the private key with an SSH client to log in to the instance. For more information, see Using SSH to Communicate with an Instance and Managing SSH Access. You can override this setting by specifying a different key pair, or no key pair, when you create an instance.

" - }, - "DefaultRootDeviceType":{ - "shape":"RootDeviceType", - "documentation":"

The default root device type. This value is used by default for all instances in the stack, but you can override it when you create an instance. For more information, see Storage for the Root Device.

" - }, - "UseOpsworksSecurityGroups":{ - "shape":"Boolean", - "documentation":"

Whether to associate the AWS OpsWorks Stacks built-in security groups with the stack's layers.

AWS OpsWorks Stacks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. UseOpsworksSecurityGroups allows you to provide your own custom security groups instead of using the built-in groups. UseOpsworksSecurityGroups has the following settings:

  • True - AWS OpsWorks Stacks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it, but you cannot delete the built-in security group.

  • False - AWS OpsWorks Stacks does not associate built-in security groups with layers. You must create appropriate EC2 security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on. Custom security groups are required only for those layers that need custom settings.

For more information, see Create a New Stack.

" - }, - "AgentVersion":{ - "shape":"String", - "documentation":"

The default AWS OpsWorks Stacks agent version. You have the following options:

  • Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically installs new agent versions on the stack's instances as soon as they are available.

  • Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks Stacks then automatically installs that version on the stack's instances.

The default setting is LATEST. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call DescribeAgentVersions. AgentVersion cannot be set to Chef 12.2.

You can also specify an agent version when you create or update an instance, which overrides the stack's default setting.

" - } - } - }, - "UpdateUserProfileRequest":{ - "type":"structure", - "required":["IamUserArn"], - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user IAM ARN. This can also be a federated user's ARN.

" - }, - "SshUsername":{ - "shape":"String", - "documentation":"

The user's SSH user name. The allowable characters are [a-z], [A-Z], [0-9], '-', and '_'. If the specified name includes other punctuation marks, AWS OpsWorks Stacks removes them. For example, my.name will be changed to myname. If you do not specify an SSH user name, AWS OpsWorks Stacks generates one from the IAM user name.

" - }, - "SshPublicKey":{ - "shape":"String", - "documentation":"

The user's new SSH public key.

" - }, - "AllowSelfManagement":{ - "shape":"Boolean", - "documentation":"

Whether users can specify their own SSH public key through the My Settings page. For more information, see Managing User Permissions.

" - } - } - }, - "UpdateVolumeRequest":{ - "type":"structure", - "required":["VolumeId"], - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The new name.

" - }, - "MountPoint":{ - "shape":"String", - "documentation":"

The new mount point.

" - } - } - }, - "UserProfile":{ - "type":"structure", - "members":{ - "IamUserArn":{ - "shape":"String", - "documentation":"

The user's IAM ARN.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The user's name.

" - }, - "SshUsername":{ - "shape":"String", - "documentation":"

The user's SSH user name.

" - }, - "SshPublicKey":{ - "shape":"String", - "documentation":"

The user's SSH public key.

" - }, - "AllowSelfManagement":{ - "shape":"Boolean", - "documentation":"

Whether users can specify their own SSH public key through the My Settings page. For more information, see Managing User Permissions.

" - } - }, - "documentation":"

Describes a user's SSH information.

" - }, - "UserProfiles":{ - "type":"list", - "member":{"shape":"UserProfile"} - }, - "ValidForInMinutes":{ - "type":"integer", - "box":true, - "max":1440, - "min":60 - }, - "ValidationException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The exception message.

" - } - }, - "documentation":"

Indicates that a request was not valid.

", - "exception":true - }, - "VirtualizationType":{ - "type":"string", - "enum":[ - "paravirtual", - "hvm" - ] - }, - "Volume":{ - "type":"structure", - "members":{ - "VolumeId":{ - "shape":"String", - "documentation":"

The volume ID.

" - }, - "Ec2VolumeId":{ - "shape":"String", - "documentation":"

The Amazon EC2 volume ID.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The volume name.

" - }, - "RaidArrayId":{ - "shape":"String", - "documentation":"

The RAID array ID.

" - }, - "InstanceId":{ - "shape":"String", - "documentation":"

The instance ID.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The value returned by DescribeVolumes.

" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The volume size.

" - }, - "Device":{ - "shape":"String", - "documentation":"

The device name.

" - }, - "MountPoint":{ - "shape":"String", - "documentation":"

The volume mount point. For example, \"/mnt/disk1\".

" - }, - "Region":{ - "shape":"String", - "documentation":"

The AWS region. For more information about AWS regions, see Regions and Endpoints.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The volume Availability Zone. For more information, see Regions and Endpoints.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. For more information, see Amazon EBS Volume Types.

  • standard - Magnetic. Magnetic volumes must have a minimum size of 1 GiB and a maximum size of 1024 GiB.

  • io1 - Provisioned IOPS (SSD). PIOPS volumes must have a minimum size of 4 GiB and a maximum size of 16384 GiB.

  • gp2 - General Purpose (SSD). General purpose volumes must have a minimum size of 1 GiB and a maximum size of 16384 GiB.

  • st1 - Throughput Optimized hard disk drive (HDD). Throughput optimized HDD volumes must have a minimum size of 500 GiB and a maximum size of 16384 GiB.

  • sc1 - Cold HDD. Cold HDD volumes must have a minimum size of 500 GiB and a maximum size of 16384 GiB.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

For PIOPS volumes, the IOPS per disk.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether an Amazon EBS volume is encrypted. For more information, see Amazon EBS Encryption.

" - } - }, - "documentation":"

Describes an instance's Amazon EBS volume.

" - }, - "VolumeConfiguration":{ - "type":"structure", - "required":[ - "MountPoint", - "NumberOfDisks", - "Size" - ], - "members":{ - "MountPoint":{ - "shape":"String", - "documentation":"

The volume mount point. For example \"/dev/sdh\".

" - }, - "RaidLevel":{ - "shape":"Integer", - "documentation":"

The volume RAID level.

" - }, - "NumberOfDisks":{ - "shape":"Integer", - "documentation":"

The number of disks in the volume.

" - }, - "Size":{ - "shape":"Integer", - "documentation":"

The volume size.

" - }, - "VolumeType":{ - "shape":"String", - "documentation":"

The volume type. For more information, see Amazon EBS Volume Types.

  • standard - Magnetic. Magnetic volumes must have a minimum size of 1 GiB and a maximum size of 1024 GiB.

  • io1 - Provisioned IOPS (SSD). PIOPS volumes must have a minimum size of 4 GiB and a maximum size of 16384 GiB.

  • gp2 - General Purpose (SSD). General purpose volumes must have a minimum size of 1 GiB and a maximum size of 16384 GiB.

  • st1 - Throughput Optimized hard disk drive (HDD). Throughput optimized HDD volumes must have a minimum size of 500 GiB and a maximum size of 16384 GiB.

  • sc1 - Cold HDD. Cold HDD volumes must have a minimum size of 500 GiB and a maximum size of 16384 GiB.

" - }, - "Iops":{ - "shape":"Integer", - "documentation":"

For PIOPS volumes, the IOPS per disk.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether an Amazon EBS volume is encrypted. For more information, see Amazon EBS Encryption.

" - } - }, - "documentation":"

Describes an Amazon EBS volume configuration.

" - }, - "VolumeConfigurations":{ - "type":"list", - "member":{"shape":"VolumeConfiguration"} - }, - "VolumeType":{ - "type":"string", - "enum":[ - "gp2", - "io1", - "standard" - ] - }, - "Volumes":{ - "type":"list", - "member":{"shape":"Volume"} - }, - "WeeklyAutoScalingSchedule":{ - "type":"structure", - "members":{ - "Monday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Monday.

" - }, - "Tuesday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Tuesday.

" - }, - "Wednesday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Wednesday.

" - }, - "Thursday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Thursday.

" - }, - "Friday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Friday.

" - }, - "Saturday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Saturday.

" - }, - "Sunday":{ - "shape":"DailyAutoScalingSchedule", - "documentation":"

The schedule for Sunday.

" - } - }, - "documentation":"

Describes a time-based instance's auto scaling schedule. The schedule consists of a set of key-value pairs.

  • The key is the time period (a UTC hour) and must be an integer from 0 - 23.

  • The value indicates whether the instance should be online or offline for the specified period, and must be set to \"on\" or \"off\"

The default setting for all time periods is off, so you use the following parameters primarily to specify the online periods. You don't have to explicitly specify offline periods unless you want to change an online period to an offline period.

The following example specifies that the instance should be online for four hours, from UTC 1200 - 1600. It will be off for the remainder of the day.

{ \"12\":\"on\", \"13\":\"on\", \"14\":\"on\", \"15\":\"on\" }

" - } - }, - "documentation":"AWS OpsWorks

Welcome to the AWS OpsWorks Stacks API Reference. This guide provides descriptions, syntax, and usage examples for AWS OpsWorks Stacks actions and data types, including common parameters and error codes.

AWS OpsWorks Stacks is an application management service that provides an integrated experience for overseeing the complete application lifecycle. For information about this product, go to the AWS OpsWorks details page.

SDKs and CLI

The most common way to use the AWS OpsWorks Stacks API is by using the AWS Command Line Interface (CLI) or by using one of the AWS SDKs to implement applications in your preferred language. For more information, see:

Endpoints

AWS OpsWorks Stacks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created.

  • opsworks.us-east-1.amazonaws.com

  • opsworks.us-east-2.amazonaws.com

  • opsworks.us-west-1.amazonaws.com

  • opsworks.us-west-2.amazonaws.com

  • opsworks.ca-central-1.amazonaws.com (API only; not available in the AWS console)

  • opsworks.eu-west-1.amazonaws.com

  • opsworks.eu-west-2.amazonaws.com

  • opsworks.eu-west-3.amazonaws.com

  • opsworks.eu-central-1.amazonaws.com

  • opsworks.ap-northeast-1.amazonaws.com

  • opsworks.ap-northeast-2.amazonaws.com

  • opsworks.ap-south-1.amazonaws.com

  • opsworks.ap-southeast-1.amazonaws.com

  • opsworks.ap-southeast-2.amazonaws.com

  • opsworks.sa-east-1.amazonaws.com

Chef Versions

When you call CreateStack, CloneStack, or UpdateStack we recommend you use the ConfigurationManager parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see Chef Versions.

You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/waiters-2.json deleted file mode 100644 index 1b9dfaad..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworks/2013-02-18/waiters-2.json +++ /dev/null @@ -1,289 +0,0 @@ -{ - "version": 2, - "waiters": { - "AppExists": { - "delay": 1, - "operation": "DescribeApps", - "maxAttempts": 40, - "acceptors": [ - { - "expected": 200, - "matcher": "status", - "state": "success" - }, - { - "matcher": "status", - "expected": 400, - "state": "failure" - } - ] - }, - "DeploymentSuccessful": { - "delay": 15, - "operation": "DescribeDeployments", - "maxAttempts": 40, - "description": "Wait until a deployment has completed successfully.", - "acceptors": [ - { - "expected": "successful", - "matcher": "pathAll", - "state": "success", - "argument": "Deployments[].Status" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Deployments[].Status" - } - ] - }, - "InstanceOnline": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "description": "Wait until OpsWorks instance is online.", - "acceptors": [ - { - "expected": "online", - "matcher": "pathAll", - "state": "success", - "argument": "Instances[].Status" - }, - { - "expected": "setup_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "shutting_down", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "start_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stopped", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "terminating", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stop_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - } - ] - }, - "InstanceRegistered": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "description": "Wait until OpsWorks instance is registered.", - "acceptors": [ - { - "expected": "registered", - "matcher": "pathAll", - "state": "success", - "argument": "Instances[].Status" - }, - { - "expected": "setup_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "shutting_down", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stopped", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stopping", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "terminating", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "terminated", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stop_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - } - ] - }, - "InstanceStopped": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "description": "Wait until OpsWorks instance is stopped.", - "acceptors": [ - { - "expected": "stopped", - "matcher": "pathAll", - "state": "success", - "argument": "Instances[].Status" - }, - { - "expected": "booting", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "requested", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "running_setup", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "setup_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "start_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "stop_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - } - ] - }, - "InstanceTerminated": { - "delay": 15, - "operation": "DescribeInstances", - "maxAttempts": 40, - "description": "Wait until OpsWorks instance is terminated.", - "acceptors": [ - { - "expected": "terminated", - "matcher": "pathAll", - "state": "success", - "argument": "Instances[].Status" - }, - { - "expected": "ResourceNotFoundException", - "matcher": "error", - "state": "success" - }, - { - "expected": "booting", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "online", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "pending", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "requested", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "running_setup", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "setup_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - }, - { - "expected": "start_failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Instances[].Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/service-2.json deleted file mode 100644 index cbeee334..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/service-2.json +++ /dev/null @@ -1,1147 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-01", - "endpointPrefix":"opsworks-cm", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"OpsWorksCM", - "serviceFullName":"AWS OpsWorks for Chef Automate", - "serviceId":"OpsWorksCM", - "signatureVersion":"v4", - "signingName":"opsworks-cm", - "targetPrefix":"OpsWorksCM_V2016_11_01", - "uid":"opsworkscm-2016-11-01" - }, - "operations":{ - "AssociateNode":{ - "name":"AssociateNode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateNodeRequest"}, - "output":{"shape":"AssociateNodeResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Associates a new node with the server. For more information about how to disassociate a node, see DisassociateNode.

On a Chef server: This command is an alternative to knife bootstrap.

Example (Chef): aws opsworks-cm associate-node --server-name MyServer --node-name MyManagedNode --engine-attributes \"Name=CHEF_ORGANIZATION,Value=default\" \"Name=CHEF_NODE_PUBLIC_KEY,Value=public-key-pem\"

On a Puppet server, this command is an alternative to the puppet cert sign command that signs a Puppet node CSR.

Example (Chef): aws opsworks-cm associate-node --server-name MyServer --node-name MyManagedNode --engine-attributes \"Name=PUPPET_NODE_CSR,Value=csr-pem\"

A node can can only be associated with servers that are in a HEALTHY state. Otherwise, an InvalidStateException is thrown. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid. The AssociateNode API call can be integrated into Auto Scaling configurations, AWS Cloudformation templates, or the user data of a server's instance.

" - }, - "CreateBackup":{ - "name":"CreateBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateBackupRequest"}, - "output":{"shape":"CreateBackupResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Creates an application-level backup of a server. While the server is in the BACKING_UP state, the server cannot be changed, and no additional backup can be created.

Backups can be created for servers in RUNNING, HEALTHY, and UNHEALTHY states. By default, you can create a maximum of 50 manual backups.

This operation is asynchronous.

A LimitExceededException is thrown when the maximum number of manual backups is reached. An InvalidStateException is thrown when the server is not in any of the following states: RUNNING, HEALTHY, or UNHEALTHY. A ResourceNotFoundException is thrown when the server is not found. A ValidationException is thrown when parameters of the request are not valid.

" - }, - "CreateServer":{ - "name":"CreateServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateServerRequest"}, - "output":{"shape":"CreateServerResponse"}, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Creates and immedately starts a new server. The server is ready to use when it is in the HEALTHY state. By default, you can create a maximum of 10 servers.

This operation is asynchronous.

A LimitExceededException is thrown when you have created the maximum number of servers (10). A ResourceAlreadyExistsException is thrown when a server with the same name already exists in the account. A ResourceNotFoundException is thrown when you specify a backup ID that is not valid or is for a backup that does not exist. A ValidationException is thrown when parameters of the request are not valid.

If you do not specify a security group by adding the SecurityGroupIds parameter, AWS OpsWorks creates a new security group.

Chef Automate: The default security group opens the Chef server to the world on TCP port 443. If a KeyName is present, AWS OpsWorks enables SSH access. SSH is also open to the world on TCP port 22.

Puppet Enterprise: The default security group opens TCP ports 22, 443, 4433, 8140, 8142, 8143, and 8170. If a KeyName is present, AWS OpsWorks enables SSH access. SSH is also open to the world on TCP port 22.

By default, your server is accessible from any IP address. We recommend that you update your security group rules to allow access from known IP addresses and address ranges only. To edit security group rules, open Security Groups in the navigation pane of the EC2 management console.

" - }, - "DeleteBackup":{ - "name":"DeleteBackup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBackupRequest"}, - "output":{"shape":"DeleteBackupResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Deletes a backup. You can delete both manual and automated backups. This operation is asynchronous.

An InvalidStateException is thrown when a backup deletion is already in progress. A ResourceNotFoundException is thrown when the backup does not exist. A ValidationException is thrown when parameters of the request are not valid.

" - }, - "DeleteServer":{ - "name":"DeleteServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServerRequest"}, - "output":{"shape":"DeleteServerResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Deletes the server and the underlying AWS CloudFormation stacks (including the server's EC2 instance). When you run this command, the server state is updated to DELETING. After the server is deleted, it is no longer returned by DescribeServer requests. If the AWS CloudFormation stack cannot be deleted, the server cannot be deleted.

This operation is asynchronous.

An InvalidStateException is thrown when a server deletion is already in progress. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesRequest"}, - "output":{"shape":"DescribeAccountAttributesResponse"}, - "documentation":"

Describes your account attributes, and creates requests to increase limits before they are reached or exceeded.

This operation is synchronous.

" - }, - "DescribeBackups":{ - "name":"DescribeBackups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBackupsRequest"}, - "output":{"shape":"DescribeBackupsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Describes backups. The results are ordered by time, with newest backups first. If you do not specify a BackupId or ServerName, the command returns all backups.

This operation is synchronous.

A ResourceNotFoundException is thrown when the backup does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsRequest"}, - "output":{"shape":"DescribeEventsResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes events for a specified server. Results are ordered by time, with newest events first.

This operation is synchronous.

A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "DescribeNodeAssociationStatus":{ - "name":"DescribeNodeAssociationStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNodeAssociationStatusRequest"}, - "output":{"shape":"DescribeNodeAssociationStatusResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Returns the current status of an existing association or disassociation request.

A ResourceNotFoundException is thrown when no recent association or disassociation request with the specified token is found, or when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "DescribeServers":{ - "name":"DescribeServers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServersRequest"}, - "output":{"shape":"DescribeServersResponse"}, - "errors":[ - {"shape":"ValidationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Lists all configuration management servers that are identified with your account. Only the stored results from Amazon DynamoDB are returned. AWS OpsWorks CM does not query other services.

This operation is synchronous.

A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "DisassociateNode":{ - "name":"DisassociateNode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateNodeRequest"}, - "output":{"shape":"DisassociateNodeResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Disassociates a node from an AWS OpsWorks CM server, and removes the node from the server's managed nodes. After a node is disassociated, the node key pair is no longer valid for accessing the configuration manager's API. For more information about how to associate a node, see AssociateNode.

A node can can only be disassociated from a server that is in a HEALTHY state. Otherwise, an InvalidStateException is thrown. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "RestoreServer":{ - "name":"RestoreServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreServerRequest"}, - "output":{"shape":"RestoreServerResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Restores a backup to a server that is in a CONNECTION_LOST, HEALTHY, RUNNING, UNHEALTHY, or TERMINATED state. When you run RestoreServer, the server's EC2 instance is deleted, and a new EC2 instance is configured. RestoreServer maintains the existing server endpoint, so configuration management of the server's client devices (nodes) should continue to work.

This operation is asynchronous.

An InvalidStateException is thrown when the server is not in a valid state. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "StartMaintenance":{ - "name":"StartMaintenance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartMaintenanceRequest"}, - "output":{"shape":"StartMaintenanceResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Manually starts server maintenance. This command can be useful if an earlier maintenance attempt failed, and the underlying cause of maintenance failure has been resolved. The server is in an UNDER_MAINTENANCE state while maintenance is in progress.

Maintenance can only be started on servers in HEALTHY and UNHEALTHY states. Otherwise, an InvalidStateException is thrown. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - }, - "UpdateServer":{ - "name":"UpdateServer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServerRequest"}, - "output":{"shape":"UpdateServerResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Updates settings for a server.

This operation is synchronous.

" - }, - "UpdateServerEngineAttributes":{ - "name":"UpdateServerEngineAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServerEngineAttributesRequest"}, - "output":{"shape":"UpdateServerEngineAttributesResponse"}, - "errors":[ - {"shape":"InvalidStateException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ValidationException"} - ], - "documentation":"

Updates engine-specific attributes on a specified server. The server enters the MODIFYING state when this operation is in progress. Only one update can occur at a time. You can use this command to reset a Chef server's private key (CHEF_PIVOTAL_KEY), a Chef server's admin password (CHEF_DELIVERY_ADMIN_PASSWORD), or a Puppet server's admin password (PUPPET_ADMIN_PASSWORD).

This operation is asynchronous.

This operation can only be called for servers in HEALTHY or UNHEALTHY states. Otherwise, an InvalidStateException is raised. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

" - } - }, - "shapes":{ - "AccountAttribute":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The attribute name. The following are supported attribute names.

  • ServerLimit: The number of current servers/maximum number of servers allowed. By default, you can have a maximum of 10 servers.

  • ManualBackupLimit: The number of current manual backups/maximum number of backups allowed. By default, you can have a maximum of 50 manual backups saved.

" - }, - "Maximum":{ - "shape":"Integer", - "documentation":"

The maximum allowed value.

" - }, - "Used":{ - "shape":"Integer", - "documentation":"

The current usage, such as the current number of servers that are associated with the account.

" - } - }, - "documentation":"

Stores account attributes.

" - }, - "AccountAttributes":{ - "type":"list", - "member":{"shape":"AccountAttribute"}, - "documentation":"

A list of individual account attributes.

" - }, - "AssociateNodeRequest":{ - "type":"structure", - "required":[ - "ServerName", - "NodeName", - "EngineAttributes" - ], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server with which to associate the node.

" - }, - "NodeName":{ - "shape":"NodeName", - "documentation":"

The name of the node.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

Engine attributes used for associating the node.

Attributes accepted in a AssociateNode request for Chef

  • CHEF_ORGANIZATION: The Chef organization with which the node is associated. By default only one organization named default can exist.

  • CHEF_NODE_PUBLIC_KEY: A PEM-formatted public key. This key is required for the chef-client agent to access the Chef API.

Attributes accepted in a AssociateNode request for Puppet

  • PUPPET_NODE_CSR: A PEM-formatted certificate-signing request (CSR) that is created by the node.

" - } - } - }, - "AssociateNodeResponse":{ - "type":"structure", - "members":{ - "NodeAssociationStatusToken":{ - "shape":"NodeAssociationStatusToken", - "documentation":"

Contains a token which can be passed to the DescribeNodeAssociationStatus API call to get the status of the association request.

" - } - } - }, - "AttributeName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[A-Z][A-Z0-9_]*" - }, - "AttributeValue":{"type":"string"}, - "Backup":{ - "type":"structure", - "members":{ - "BackupArn":{ - "shape":"String", - "documentation":"

The ARN of the backup.

" - }, - "BackupId":{ - "shape":"BackupId", - "documentation":"

The generated ID of the backup. Example: myServerName-yyyyMMddHHmmssSSS

" - }, - "BackupType":{ - "shape":"BackupType", - "documentation":"

The backup type. Valid values are automated or manual.

" - }, - "CreatedAt":{ - "shape":"Timestamp", - "documentation":"

The time stamp when the backup was created in the database. Example: 2016-07-29T13:38:47.520Z

" - }, - "Description":{ - "shape":"String", - "documentation":"

A user-provided description for a manual backup. This field is empty for automated backups.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The engine type that is obtained from the server when the backup is created.

" - }, - "EngineModel":{ - "shape":"String", - "documentation":"

The engine model that is obtained from the server when the backup is created.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version that is obtained from the server when the backup is created.

" - }, - "InstanceProfileArn":{ - "shape":"String", - "documentation":"

The EC2 instance profile ARN that is obtained from the server when the backup is created. Because this value is stored, you are not required to provide the InstanceProfileArn again if you restore a backup.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type that is obtained from the server when the backup is created.

" - }, - "KeyPair":{ - "shape":"String", - "documentation":"

The key pair that is obtained from the server when the backup is created.

" - }, - "PreferredBackupWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The preferred backup period that is obtained from the server when the backup is created.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The preferred maintenance period that is obtained from the server when the backup is created.

" - }, - "S3DataSize":{ - "shape":"Integer", - "documentation":"

This field is deprecated and is no longer used.

", - "deprecated":true - }, - "S3DataUrl":{ - "shape":"String", - "documentation":"

This field is deprecated and is no longer used.

", - "deprecated":true - }, - "S3LogUrl":{ - "shape":"String", - "documentation":"

The Amazon S3 URL of the backup's log file.

" - }, - "SecurityGroupIds":{ - "shape":"Strings", - "documentation":"

The security group IDs that are obtained from the server when the backup is created.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server from which the backup was made.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

The service role ARN that is obtained from the server when the backup is created.

" - }, - "Status":{ - "shape":"BackupStatus", - "documentation":"

The status of a backup while in progress.

" - }, - "StatusDescription":{ - "shape":"String", - "documentation":"

An informational message about backup status.

" - }, - "SubnetIds":{ - "shape":"Strings", - "documentation":"

The subnet IDs that are obtained from the server when the backup is created.

" - }, - "ToolsVersion":{ - "shape":"String", - "documentation":"

The version of AWS OpsWorks CM-specific tools that is obtained from the server when the backup is created.

" - }, - "UserArn":{ - "shape":"String", - "documentation":"

The IAM user ARN of the requester for manual backups. This field is empty for automated backups.

" - } - }, - "documentation":"

Describes a single backup.

" - }, - "BackupId":{ - "type":"string", - "max":79 - }, - "BackupRetentionCountDefinition":{ - "type":"integer", - "min":1 - }, - "BackupStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "OK", - "FAILED", - "DELETING" - ] - }, - "BackupType":{ - "type":"string", - "enum":[ - "AUTOMATED", - "MANUAL" - ] - }, - "Backups":{ - "type":"list", - "member":{"shape":"Backup"} - }, - "Boolean":{"type":"boolean"}, - "CreateBackupRequest":{ - "type":"structure", - "required":["ServerName"], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server that you want to back up.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A user-defined description of the backup.

" - } - } - }, - "CreateBackupResponse":{ - "type":"structure", - "members":{ - "Backup":{ - "shape":"Backup", - "documentation":"

Backup created by request.

" - } - } - }, - "CreateServerRequest":{ - "type":"structure", - "required":[ - "ServerName", - "InstanceProfileArn", - "InstanceType", - "ServiceRoleArn" - ], - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Associate a public IP address with a server that you are launching. Valid values are true or false. The default value is true.

" - }, - "DisableAutomatedBackup":{ - "shape":"Boolean", - "documentation":"

Enable or disable scheduled backups. Valid values are true or false. The default value is true.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The configuration management engine to use. Valid values include Chef and Puppet.

" - }, - "EngineModel":{ - "shape":"String", - "documentation":"

The engine model of the server. Valid values in this release include Monolithic for Puppet and Single for Chef.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The major release version of the engine that you want to use. For a Chef server, the valid value for EngineVersion is currently 12. For a Puppet server, the valid value is 2017.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

Optional engine attributes on a specified server.

Attributes accepted in a Chef createServer request:

  • CHEF_PIVOTAL_KEY: A base64-encoded RSA private key that is not stored by AWS OpsWorks for Chef Automate. This private key is required to access the Chef API. When no CHEF_PIVOTAL_KEY is set, one is generated and returned in the response.

  • CHEF_DELIVERY_ADMIN_PASSWORD: The password for the administrative user in the Chef Automate GUI. The password length is a minimum of eight characters, and a maximum of 32. The password can contain letters, numbers, and special characters (!/@#$%^&+=_). The password must contain at least one lower case letter, one upper case letter, one number, and one special character. When no CHEF_DELIVERY_ADMIN_PASSWORD is set, one is generated and returned in the response.

Attributes accepted in a Puppet createServer request:

  • PUPPET_ADMIN_PASSWORD: To work with the Puppet Enterprise console, a password must use ASCII characters.

" - }, - "BackupRetentionCount":{ - "shape":"BackupRetentionCountDefinition", - "documentation":"

The number of automated backups that you want to keep. Whenever a new backup is created, AWS OpsWorks CM deletes the oldest backups if this number is exceeded. The default value is 1.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server. The server name must be unique within your AWS account, within each region. Server names must start with a letter; then letters, numbers, or hyphens (-) are allowed, up to a maximum of 40 characters.

" - }, - "InstanceProfileArn":{ - "shape":"InstanceProfileArn", - "documentation":"

The ARN of the instance profile that your Amazon EC2 instances use. Although the AWS OpsWorks console typically creates the instance profile for you, if you are using API commands instead, run the service-role-creation.yaml AWS CloudFormation template, located at https://s3.amazonaws.com/opsworks-cm-us-east-1-prod-default-assets/misc/opsworks-cm-roles.yaml. This template creates a CloudFormation stack that includes the instance profile you need.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The Amazon EC2 instance type to use. For example, m4.large. Recommended instance types include t2.medium and greater, m4.*, or c4.xlarge and greater.

" - }, - "KeyPair":{ - "shape":"KeyPair", - "documentation":"

The Amazon EC2 key pair to set for the instance. This parameter is optional; if desired, you may specify this parameter to connect to your instances by using SSH.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The start time for a one-hour period each week during which AWS OpsWorks CM performs maintenance on the instance. Valid values must be specified in the following format: DDD:HH:MM. The specified time is in coordinated universal time (UTC). The default value is a random one-hour period on Tuesday, Wednesday, or Friday. See TimeWindowDefinition for more information.

Example: Mon:08:00, which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)

" - }, - "PreferredBackupWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The start time for a one-hour period during which AWS OpsWorks CM backs up application-level data on your server if automated backups are enabled. Valid values must be specified in one of the following formats:

  • HH:MM for daily backups

  • DDD:HH:MM for weekly backups

The specified time is in coordinated universal time (UTC). The default value is a random, daily start time.

Example: 08:00, which represents a daily start time of 08:00 UTC.

Example: Mon:08:00, which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)

" - }, - "SecurityGroupIds":{ - "shape":"Strings", - "documentation":"

A list of security group IDs to attach to the Amazon EC2 instance. If you add this parameter, the specified security groups must be within the VPC that is specified by SubnetIds.

If you do not specify this parameter, AWS OpsWorks CM creates one new security group that uses TCP ports 22 and 443, open to 0.0.0.0/0 (everyone).

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRoleArn", - "documentation":"

The service role that the AWS OpsWorks CM service backend uses to work with your account. Although the AWS OpsWorks management console typically creates the service role for you, if you are using the AWS CLI or API commands, run the service-role-creation.yaml AWS CloudFormation template, located at https://s3.amazonaws.com/opsworks-cm-us-east-1-prod-default-assets/misc/opsworks-cm-roles.yaml. This template creates a CloudFormation stack that includes the service role and instance profile that you need.

" - }, - "SubnetIds":{ - "shape":"Strings", - "documentation":"

The IDs of subnets in which to launch the server EC2 instance.

Amazon EC2-Classic customers: This field is required. All servers must run within a VPC. The VPC must have \"Auto Assign Public IP\" enabled.

EC2-VPC customers: This field is optional. If you do not specify subnet IDs, your EC2 instances are created in a default subnet that is selected by Amazon EC2. If you specify subnet IDs, the VPC must have \"Auto Assign Public IP\" enabled.

For more information about supported Amazon EC2 platforms, see Supported Platforms.

" - }, - "BackupId":{ - "shape":"BackupId", - "documentation":"

If you specify this field, AWS OpsWorks CM creates the server by using the backup represented by BackupId.

" - } - } - }, - "CreateServerResponse":{ - "type":"structure", - "members":{ - "Server":{ - "shape":"Server", - "documentation":"

The server that is created by the request.

" - } - } - }, - "DeleteBackupRequest":{ - "type":"structure", - "required":["BackupId"], - "members":{ - "BackupId":{ - "shape":"BackupId", - "documentation":"

The ID of the backup to delete. Run the DescribeBackups command to get a list of backup IDs. Backup IDs are in the format ServerName-yyyyMMddHHmmssSSS.

" - } - } - }, - "DeleteBackupResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteServerRequest":{ - "type":"structure", - "required":["ServerName"], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The ID of the server to delete.

" - } - } - }, - "DeleteServerResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeAccountAttributesRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeAccountAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AccountAttributes", - "documentation":"

The attributes that are currently set for the account.

" - } - } - }, - "DescribeBackupsRequest":{ - "type":"structure", - "members":{ - "BackupId":{ - "shape":"BackupId", - "documentation":"

Describes a single backup.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

Returns backups for the server with the specified ServerName.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeBackups again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "DescribeBackupsResponse":{ - "type":"structure", - "members":{ - "Backups":{ - "shape":"Backups", - "documentation":"

Contains the response to a DescribeBackups request.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeBackups again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - } - } - }, - "DescribeEventsRequest":{ - "type":"structure", - "required":["ServerName"], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server for which you want to view events.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "DescribeEventsResponse":{ - "type":"structure", - "members":{ - "ServerEvents":{ - "shape":"ServerEvents", - "documentation":"

Contains the response to a DescribeEvents request.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - } - } - }, - "DescribeNodeAssociationStatusRequest":{ - "type":"structure", - "required":[ - "NodeAssociationStatusToken", - "ServerName" - ], - "members":{ - "NodeAssociationStatusToken":{ - "shape":"NodeAssociationStatusToken", - "documentation":"

The token returned in either the AssociateNodeResponse or the DisassociateNodeResponse.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server from which to disassociate the node.

" - } - } - }, - "DescribeNodeAssociationStatusResponse":{ - "type":"structure", - "members":{ - "NodeAssociationStatus":{ - "shape":"NodeAssociationStatus", - "documentation":"

The status of the association or disassociation request.

Possible values:

  • SUCCESS: The association or disassociation succeeded.

  • FAILED: The association or disassociation failed.

  • IN_PROGRESS: The association or disassociation is still in progress.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

Attributes specific to the node association. In Puppet, the attibute PUPPET_NODE_CERT contains the signed certificate (the result of the CSR).

" - } - } - }, - "DescribeServersRequest":{ - "type":"structure", - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

Describes the server with the specified ServerName.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeServers again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

" - } - } - }, - "DescribeServersResponse":{ - "type":"structure", - "members":{ - "Servers":{ - "shape":"Servers", - "documentation":"

Contains the response to a DescribeServers request.

For Puppet Server: DescribeServersResponse$Servers$EngineAttributes contains PUPPET_API_CA_CERT. This is the PEM-encoded CA certificate that is used by the Puppet API over TCP port number 8140. The CA certificate is also used to sign node certificates.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeServers again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

" - } - } - }, - "DisassociateNodeRequest":{ - "type":"structure", - "required":[ - "ServerName", - "NodeName" - ], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server from which to disassociate the node.

" - }, - "NodeName":{ - "shape":"NodeName", - "documentation":"

The name of the client node.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

Engine attributes that are used for disassociating the node. No attributes are required for Puppet.

Attributes required in a DisassociateNode request for Chef

  • CHEF_ORGANIZATION: The Chef organization with which the node was associated. By default only one organization named default can exist.

" - } - } - }, - "DisassociateNodeResponse":{ - "type":"structure", - "members":{ - "NodeAssociationStatusToken":{ - "shape":"NodeAssociationStatusToken", - "documentation":"

Contains a token which can be passed to the DescribeNodeAssociationStatus API call to get the status of the disassociation request.

" - } - } - }, - "EngineAttribute":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"EngineAttributeName", - "documentation":"

The name of the engine attribute.

" - }, - "Value":{ - "shape":"EngineAttributeValue", - "documentation":"

The value of the engine attribute.

" - } - }, - "documentation":"

A name and value pair that is specific to the engine of the server.

" - }, - "EngineAttributeName":{"type":"string"}, - "EngineAttributeValue":{ - "type":"string", - "sensitive":true - }, - "EngineAttributes":{ - "type":"list", - "member":{"shape":"EngineAttribute"} - }, - "InstanceProfileArn":{ - "type":"string", - "pattern":"arn:aws:iam::[0-9]{12}:instance-profile/.*" - }, - "Integer":{"type":"integer"}, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message that can contain more detail about a nextToken failure.

" - } - }, - "documentation":"

This occurs when the provided nextToken is not valid.

", - "exception":true - }, - "InvalidStateException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message that provides more detail if a resource is in a state that is not valid for performing a specified action.

" - } - }, - "documentation":"

The resource is in a state that does not allow you to perform a specified action.

", - "exception":true - }, - "KeyPair":{"type":"string"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message that the maximum allowed number of servers or backups has been exceeded.

" - } - }, - "documentation":"

The limit of servers or backups has been reached.

", - "exception":true - }, - "MaintenanceStatus":{ - "type":"string", - "enum":[ - "SUCCESS", - "FAILED" - ] - }, - "MaxResults":{ - "type":"integer", - "min":1 - }, - "NextToken":{"type":"string"}, - "NodeAssociationStatus":{ - "type":"string", - "documentation":"

The status of the association or disassociation request.

Possible values:

  • SUCCESS: The association or disassociation succeeded.

  • FAILED: The association or disassociation failed.

  • IN_PROGRESS: The association or disassociation is still in progress.

", - "enum":[ - "SUCCESS", - "FAILED", - "IN_PROGRESS" - ] - }, - "NodeAssociationStatusToken":{"type":"string"}, - "NodeName":{ - "type":"string", - "documentation":"

The node name that is used by chef-client or puppet-agentfor a new node. We recommend to use a unique FQDN as hostname. For more information, see the Chef or Puppet documentation.

", - "pattern":"^[\\-\\p{Alnum}_:.]+$" - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message in response to a CreateServer request that a resource cannot be created because it already exists.

" - } - }, - "documentation":"

The requested resource cannot be created because it already exists.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message that can contain more detail about problems locating or accessing a resource.

" - } - }, - "documentation":"

The requested resource does not exist, or access was denied.

", - "exception":true - }, - "RestoreServerRequest":{ - "type":"structure", - "required":[ - "BackupId", - "ServerName" - ], - "members":{ - "BackupId":{ - "shape":"BackupId", - "documentation":"

The ID of the backup that you want to use to restore a server.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server that you want to restore.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The type of the instance to create. Valid values must be specified in the following format: ^([cm][34]|t2).* For example, m4.large. Valid values are t2.medium, m4.large, and m4.2xlarge. If you do not specify this parameter, RestoreServer uses the instance type from the specified backup.

" - }, - "KeyPair":{ - "shape":"KeyPair", - "documentation":"

The name of the key pair to set on the new EC2 instance. This can be helpful if the administrator no longer has the SSH key.

" - } - } - }, - "RestoreServerResponse":{ - "type":"structure", - "members":{ - } - }, - "Server":{ - "type":"structure", - "members":{ - "AssociatePublicIpAddress":{ - "shape":"Boolean", - "documentation":"

Associate a public IP address with a server that you are launching.

" - }, - "BackupRetentionCount":{ - "shape":"Integer", - "documentation":"

The number of automated backups to keep.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server.

" - }, - "CreatedAt":{ - "shape":"Timestamp", - "documentation":"

Time stamp of server creation. Example 2016-07-29T13:38:47.520Z

" - }, - "CloudFormationStackArn":{ - "shape":"String", - "documentation":"

The ARN of the CloudFormation stack that was used to create the server.

" - }, - "DisableAutomatedBackup":{ - "shape":"Boolean", - "documentation":"

Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.

" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

A DNS name that can be used to access the engine. Example: myserver-asdfghjkl.us-east-1.opsworks.io

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The engine type of the server. Valid values in this release include Chef and Puppet.

" - }, - "EngineModel":{ - "shape":"String", - "documentation":"

The engine model of the server. Valid values in this release include Monolithic for Puppet and Single for Chef.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

The response of a createServer() request returns the master credential to access the server in EngineAttributes. These credentials are not stored by AWS OpsWorks CM; they are returned only as part of the result of createServer().

Attributes returned in a createServer response for Chef

  • CHEF_PIVOTAL_KEY: A base64-encoded RSA private key that is generated by AWS OpsWorks for Chef Automate. This private key is required to access the Chef API.

  • CHEF_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Chef starter kit, which includes a README, a configuration file, and the required RSA private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents. From this directory, you can run Knife commands.

Attributes returned in a createServer response for Puppet

  • PUPPET_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Puppet starter kit, including a README and a required private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents.

  • PUPPET_ADMIN_PASSWORD: An administrator password that you can use to sign in to the Puppet Enterprise console after the server is online.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version of the server. For a Chef server, the valid value for EngineVersion is currently 12. For a Puppet server, the valid value is 2017.

" - }, - "InstanceProfileArn":{ - "shape":"String", - "documentation":"

The instance profile ARN of the server.

" - }, - "InstanceType":{ - "shape":"String", - "documentation":"

The instance type for the server, as specified in the CloudFormation stack. This might not be the same instance type that is shown in the EC2 console.

" - }, - "KeyPair":{ - "shape":"String", - "documentation":"

The key pair associated with the server.

" - }, - "MaintenanceStatus":{ - "shape":"MaintenanceStatus", - "documentation":"

The status of the most recent server maintenance run. Shows SUCCESS or FAILED.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The preferred maintenance period specified for the server.

" - }, - "PreferredBackupWindow":{ - "shape":"TimeWindowDefinition", - "documentation":"

The preferred backup period specified for the server.

" - }, - "SecurityGroupIds":{ - "shape":"Strings", - "documentation":"

The security group IDs for the server, as specified in the CloudFormation stack. These might not be the same security groups that are shown in the EC2 console.

" - }, - "ServiceRoleArn":{ - "shape":"String", - "documentation":"

The service role ARN used to create the server.

" - }, - "Status":{ - "shape":"ServerStatus", - "documentation":"

The server's status. This field displays the states of actions in progress, such as creating, running, or backing up the server, as well as the server's health state.

" - }, - "StatusReason":{ - "shape":"String", - "documentation":"

Depending on the server status, this field has either a human-readable message (such as a create or backup error), or an escaped block of JSON (used for health check results).

" - }, - "SubnetIds":{ - "shape":"Strings", - "documentation":"

The subnet IDs specified in a CreateServer request.

" - }, - "ServerArn":{ - "shape":"String", - "documentation":"

The ARN of the server.

" - } - }, - "documentation":"

Describes a configuration management server.

" - }, - "ServerEvent":{ - "type":"structure", - "members":{ - "CreatedAt":{ - "shape":"Timestamp", - "documentation":"

The time when the event occurred.

" - }, - "ServerName":{ - "shape":"String", - "documentation":"

The name of the server on or for which the event occurred.

" - }, - "Message":{ - "shape":"String", - "documentation":"

A human-readable informational or status message.

" - }, - "LogUrl":{ - "shape":"String", - "documentation":"

The Amazon S3 URL of the event's log file.

" - } - }, - "documentation":"

An event that is related to the server, such as the start of maintenance or backup.

" - }, - "ServerEvents":{ - "type":"list", - "member":{"shape":"ServerEvent"} - }, - "ServerName":{ - "type":"string", - "max":40, - "min":1, - "pattern":"[a-zA-Z][a-zA-Z0-9\\-]*" - }, - "ServerStatus":{ - "type":"string", - "enum":[ - "BACKING_UP", - "CONNECTION_LOST", - "CREATING", - "DELETING", - "MODIFYING", - "FAILED", - "HEALTHY", - "RUNNING", - "RESTORING", - "SETUP", - "UNDER_MAINTENANCE", - "UNHEALTHY", - "TERMINATED" - ] - }, - "Servers":{ - "type":"list", - "member":{"shape":"Server"} - }, - "ServiceRoleArn":{ - "type":"string", - "pattern":"arn:aws:iam::[0-9]{12}:role/.*" - }, - "StartMaintenanceRequest":{ - "type":"structure", - "required":["ServerName"], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server on which to run maintenance.

" - }, - "EngineAttributes":{ - "shape":"EngineAttributes", - "documentation":"

Engine attributes that are specific to the server on which you want to run maintenance.

" - } - } - }, - "StartMaintenanceResponse":{ - "type":"structure", - "members":{ - "Server":{ - "shape":"Server", - "documentation":"

Contains the response to a StartMaintenance request.

" - } - } - }, - "String":{"type":"string"}, - "Strings":{ - "type":"list", - "member":{"shape":"String"} - }, - "TimeWindowDefinition":{ - "type":"string", - "documentation":"

DDD:HH:MM (weekly start time) or HH:MM (daily start time).

Time windows always use coordinated universal time (UTC). Valid strings for day of week (DDD) are: Mon, Tue, Wed, Thr, Fri, Sat, or Sun.

", - "pattern":"^((Mon|Tue|Wed|Thu|Fri|Sat|Sun):)?([0-1][0-9]|2[0-3]):[0-5][0-9]$" - }, - "Timestamp":{"type":"timestamp"}, - "UpdateServerEngineAttributesRequest":{ - "type":"structure", - "required":[ - "ServerName", - "AttributeName" - ], - "members":{ - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server to update.

" - }, - "AttributeName":{ - "shape":"AttributeName", - "documentation":"

The name of the engine attribute to update.

" - }, - "AttributeValue":{ - "shape":"AttributeValue", - "documentation":"

The value to set for the attribute.

" - } - } - }, - "UpdateServerEngineAttributesResponse":{ - "type":"structure", - "members":{ - "Server":{ - "shape":"Server", - "documentation":"

Contains the response to an UpdateServerEngineAttributes request.

" - } - } - }, - "UpdateServerRequest":{ - "type":"structure", - "required":["ServerName"], - "members":{ - "DisableAutomatedBackup":{ - "shape":"Boolean", - "documentation":"

Setting DisableAutomatedBackup to true disables automated or scheduled backups. Automated backups are enabled by default.

" - }, - "BackupRetentionCount":{ - "shape":"Integer", - "documentation":"

Sets the number of automated backups that you want to keep.

" - }, - "ServerName":{ - "shape":"ServerName", - "documentation":"

The name of the server to update.

" - }, - "PreferredMaintenanceWindow":{"shape":"TimeWindowDefinition"}, - "PreferredBackupWindow":{"shape":"TimeWindowDefinition"} - } - }, - "UpdateServerResponse":{ - "type":"structure", - "members":{ - "Server":{ - "shape":"Server", - "documentation":"

Contains the response to a UpdateServer request.

" - } - } - }, - "ValidationException":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

Error or informational message that can contain more detail about a validation failure.

" - } - }, - "documentation":"

One or more of the provided request parameters are not valid.

", - "exception":true - } - }, - "documentation":"AWS OpsWorks CM

AWS OpsWorks for configuration management (CM) is a service that runs and manages configuration management servers.

Glossary of terms

  • Server: A configuration management server that can be highly-available. The configuration management server runs on an Amazon Elastic Compute Cloud (EC2) instance, and may use various other AWS services, such as Amazon Relational Database Service (RDS) and Elastic Load Balancing. A server is a generic abstraction over the configuration manager that you want to use, much like Amazon RDS. In AWS OpsWorks CM, you do not start or stop servers. After you create servers, they continue to run until they are deleted.

  • Engine: The engine is the specific configuration manager that you want to use. Valid values in this release include Chef and Puppet.

  • Backup: This is an application-level backup of the data that the configuration manager stores. AWS OpsWorks CM creates an S3 bucket for backups when you launch the first server. A backup maintains a snapshot of a server's configuration-related attributes at the time the backup starts.

  • Events: Events are always related to a server. Events are written during server creation, when health checks run, when backups are created, when system maintenance is performed, etc. When you delete a server, the server's events are also deleted.

  • Account attributes: Every account has attributes that are assigned in the AWS OpsWorks CM database. These attributes store information about configuration limits (servers, backups, etc.) and your customer account.

Endpoints

AWS OpsWorks CM supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Your servers can only be accessed or managed within the endpoint in which they are created.

  • opsworks-cm.us-east-1.amazonaws.com

  • opsworks-cm.us-west-2.amazonaws.com

  • opsworks-cm.eu-west-1.amazonaws.com

Throttling limits

All API operations allow for five requests per second with a burst of 10 requests per second.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/waiters-2.json deleted file mode 100644 index f37dd040..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/opsworkscm/2016-11-01/waiters-2.json +++ /dev/null @@ -1,25 +0,0 @@ -{ - "version": 2, - "waiters": { - "NodeAssociated": { - "delay": 15, - "maxAttempts": 15, - "operation": "DescribeNodeAssociationStatus", - "description": "Wait until node is associated or disassociated.", - "acceptors": [ - { - "expected": "SUCCESS", - "state": "success", - "matcher": "path", - "argument": "NodeAssociationStatus" - }, - { - "expected": "FAILED", - "state": "failure", - "matcher": "path", - "argument": "NodeAssociationStatus" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/paginators-1.json deleted file mode 100644 index 1c8f978b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/paginators-1.json +++ /dev/null @@ -1,82 +0,0 @@ -{ - "pagination": { - "ListAccounts": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Accounts" - }, - "ListAccountsForParent": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Accounts" - }, - "ListChildren": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Children" - }, - "ListCreateAccountStatus": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "CreateAccountStatuses" - }, - "ListHandshakesForAccount": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Handshakes" - }, - "ListHandshakesForOrganization": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Handshakes" - }, - "ListOrganizationalUnitsForParent": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "OrganizationalUnits" - }, - "ListParents": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Parents" - }, - "ListPolicies": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Policies" - }, - "ListPoliciesForTarget": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Policies" - }, - "ListRoots": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Roots" - }, - "ListTargetsForPolicy": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Targets" - }, - "ListAWSServiceAccessForOrganization": { - "result_key": "EnabledServicePrincipals", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/service-2.json deleted file mode 100644 index 9adbd76f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/organizations/2016-11-28/service-2.json +++ /dev/null @@ -1,2791 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-28", - "endpointPrefix":"organizations", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Organizations", - "serviceFullName":"AWS Organizations", - "serviceId":"Organizations", - "signatureVersion":"v4", - "targetPrefix":"AWSOrganizationsV20161128", - "timestampFormat":"unixTimestamp", - "uid":"organizations-2016-11-28" - }, - "operations":{ - "AcceptHandshake":{ - "name":"AcceptHandshake", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptHandshakeRequest"}, - "output":{"shape":"AcceptHandshakeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"HandshakeConstraintViolationException"}, - {"shape":"HandshakeNotFoundException"}, - {"shape":"InvalidHandshakeTransitionException"}, - {"shape":"HandshakeAlreadyInStateException"}, - {"shape":"InvalidInputException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"AccessDeniedForDependencyException"} - ], - "documentation":"

Sends a response to the originator of a handshake agreeing to the action proposed by the handshake request.

This operation can be called only by the following principals when they also have the relevant IAM permissions:

  • Invitation to join or Approve all features request handshakes: only a principal from the member account.

    The user who calls the API for an invitation to join must have the organizations:AcceptHandshake permission. If you enabled all features in the organization, then the user must also have the iam:CreateServiceLinkedRole permission so that Organizations can create the required service-linked role named OrgsServiceLinkedRoleName. For more information, see AWS Organizations and Service-Linked Roles in the AWS Organizations User Guide.

  • Enable all features final confirmation handshake: only a principal from the master account.

    For more information about invitations, see Inviting an AWS Account to Join Your Organization in the AWS Organizations User Guide. For more information about requests to enable all features in the organization, see Enabling All Features in Your Organization in the AWS Organizations User Guide.

After you accept a handshake, it continues to appear in the results of relevant APIs for only 30 days. After that it is deleted.

" - }, - "AttachPolicy":{ - "name":"AttachPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AttachPolicyRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"DuplicatePolicyAttachmentException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"PolicyTypeNotEnabledException"}, - {"shape":"ServiceException"}, - {"shape":"TargetNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Attaches a policy to a root, an organizational unit (OU), or an individual account. How the policy affects accounts depends on the type of policy:

  • Service control policy (SCP) - An SCP specifies what permissions can be delegated to users in affected member accounts. The scope of influence for a policy depends on what you attach the policy to:

    • If you attach an SCP to a root, it affects all accounts in the organization.

    • If you attach an SCP to an OU, it affects all accounts in that OU and in any child OUs.

    • If you attach the policy directly to an account, then it affects only that account.

    SCPs essentially are permission \"filters\". When you attach one SCP to a higher level root or OU, and you also attach a different SCP to a child OU or to an account, the child policy can further restrict only the permissions that pass through the parent filter and are available to the child. An SCP that is attached to a child cannot grant a permission that is not already granted by the parent. For example, imagine that the parent SCP allows permissions A, B, C, D, and E. The child SCP allows C, D, E, F, and G. The result is that the accounts affected by the child SCP are allowed to use only C, D, and E. They cannot use A or B because they were filtered out by the child OU. They also cannot use F and G because they were filtered out by the parent OU. They cannot be granted back by the child SCP; child SCPs can only filter the permissions they receive from the parent SCP.

    AWS Organizations attaches a default SCP named \"FullAWSAccess to every root, OU, and account. This default SCP allows all services and actions, enabling any new child OU or account to inherit the permissions of the parent root or OU. If you detach the default policy, you must replace it with a policy that specifies the permissions that you want to allow in that OU or account.

    For more information about how Organizations policies permissions work, see Using Service Control Policies in the AWS Organizations User Guide.

This operation can be called only from the organization's master account.

" - }, - "CancelHandshake":{ - "name":"CancelHandshake", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelHandshakeRequest"}, - "output":{"shape":"CancelHandshakeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"HandshakeNotFoundException"}, - {"shape":"InvalidHandshakeTransitionException"}, - {"shape":"HandshakeAlreadyInStateException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Cancels a handshake. Canceling a handshake sets the handshake state to CANCELED.

This operation can be called only from the account that originated the handshake. The recipient of the handshake can't cancel it, but can use DeclineHandshake instead. After a handshake is canceled, the recipient can no longer respond to that handshake.

After you cancel a handshake, it continues to appear in the results of relevant APIs for only 30 days. After that it is deleted.

" - }, - "CreateAccount":{ - "name":"CreateAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAccountRequest"}, - "output":{"shape":"CreateAccountResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"FinalizingOrganizationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates an AWS account that is automatically a member of the organization whose credentials made the request. This is an asynchronous request that AWS performs in the background. If you want to check the status of the request later, you need the OperationId response element from this operation to provide as a parameter to the DescribeCreateAccountStatus operation.

The user who calls the API for an invitation to join must have the organizations:CreateAccount permission. If you enabled all features in the organization, then the user must also have the iam:CreateServiceLinkedRole permission so that Organizations can create the required service-linked role named OrgsServiceLinkedRoleName. For more information, see AWS Organizations and Service-Linked Roles in the AWS Organizations User Guide.

The user in the master account who calls this API must also have the iam:CreateRole permission because AWS Organizations preconfigures the new member account with a role (named OrganizationAccountAccessRole by default) that grants users in the master account administrator permissions in the new member account. Principals in the master account can assume the role. AWS Organizations clones the company name and address information for the new account from the organization's master account.

This operation can be called only from the organization's master account.

For more information about creating accounts, see Creating an AWS Account in Your Organization in the AWS Organizations User Guide.

  • When you create an account in an organization using the AWS Organizations console, API, or CLI commands, the information required for the account to operate as a standalone account, such as a payment method and signing the End User Licence Agreement (EULA) is not automatically collected. If you must remove an account from your organization later, you can do so only after you provide the missing information. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • If you get an exception that indicates that you exceeded your account limits for the organization or that the operation failed because your organization is still initializing, wait one hour and then try again. If the error persists after an hour, then contact AWS Customer Support.

  • Because CreateAccount operates asynchronously, it can return a successful completion message even though account initialization might still be in progress. You might need to wait a few minutes before you can successfully access the account.

When you create a member account with this operation, you can choose whether to create the account with the IAM User and Role Access to Billing Information switch enabled. If you enable it, IAM users and roles that have appropriate permissions can view billing information for the account. If you disable this, then only the account root user can access billing information. For information about how to disable this for an account, see Granting Access to Your Billing Information and Tools.

" - }, - "CreateOrganization":{ - "name":"CreateOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateOrganizationRequest"}, - "output":{"shape":"CreateOrganizationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AlreadyInOrganizationException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"AccessDeniedForDependencyException"} - ], - "documentation":"

Creates an AWS organization. The account whose user is calling the CreateOrganization operation automatically becomes the master account of the new organization.

This operation must be called using credentials from the account that is to become the new organization's master account. The principal must also have the relevant IAM permissions.

By default (or if you set the FeatureSet parameter to ALL), the new organization is created with all features enabled and service control policies automatically enabled in the root. If you instead choose to create the organization supporting only the consolidated billing features by setting the FeatureSet parameter to CONSOLIDATED_BILLING\", then no policy types are enabled by default and you cannot use organization policies.

" - }, - "CreateOrganizationalUnit":{ - "name":"CreateOrganizationalUnit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateOrganizationalUnitRequest"}, - "output":{"shape":"CreateOrganizationalUnitResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"DuplicateOrganizationalUnitException"}, - {"shape":"InvalidInputException"}, - {"shape":"ParentNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates an organizational unit (OU) within a root or parent OU. An OU is a container for accounts that enables you to organize your accounts to apply policies according to your business requirements. The number of levels deep that you can nest OUs is dependent upon the policy types enabled for that root. For service control policies, the limit is five.

For more information about OUs, see Managing Organizational Units in the AWS Organizations User Guide.

This operation can be called only from the organization's master account.

" - }, - "CreatePolicy":{ - "name":"CreatePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePolicyRequest"}, - "output":{"shape":"CreatePolicyResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"DuplicatePolicyException"}, - {"shape":"InvalidInputException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PolicyTypeNotAvailableForOrganizationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Creates a policy of a specified type that you can attach to a root, an organizational unit (OU), or an individual AWS account.

For more information about policies and their use, see Managing Organization Policies.

This operation can be called only from the organization's master account.

" - }, - "DeclineHandshake":{ - "name":"DeclineHandshake", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeclineHandshakeRequest"}, - "output":{"shape":"DeclineHandshakeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"HandshakeNotFoundException"}, - {"shape":"InvalidHandshakeTransitionException"}, - {"shape":"HandshakeAlreadyInStateException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Declines a handshake request. This sets the handshake state to DECLINED and effectively deactivates the request.

This operation can be called only from the account that received the handshake. The originator of the handshake can use CancelHandshake instead. The originator can't reactivate a declined request, but can re-initiate the process with a new handshake request.

After you decline a handshake, it continues to appear in the results of relevant APIs for only 30 days. After that it is deleted.

" - }, - "DeleteOrganization":{ - "name":"DeleteOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidInputException"}, - {"shape":"OrganizationNotEmptyException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the organization. You can delete an organization only by using credentials from the master account. The organization must be empty of member accounts, organizational units (OUs), and policies.

" - }, - "DeleteOrganizationalUnit":{ - "name":"DeleteOrganizationalUnit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteOrganizationalUnitRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidInputException"}, - {"shape":"OrganizationalUnitNotEmptyException"}, - {"shape":"OrganizationalUnitNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes an organizational unit (OU) from a root or another OU. You must first remove all accounts and child OUs from the OU that you want to delete.

This operation can be called only from the organization's master account.

" - }, - "DeletePolicy":{ - "name":"DeletePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePolicyRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyInUseException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Deletes the specified policy from your organization. Before you perform this operation, you must first detach the policy from all organizational units (OUs), roots, and accounts.

This operation can be called only from the organization's master account.

" - }, - "DescribeAccount":{ - "name":"DescribeAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountRequest"}, - "output":{"shape":"DescribeAccountResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AccountNotFoundException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves Organizations-related information about the specified account.

This operation can be called only from the organization's master account.

" - }, - "DescribeCreateAccountStatus":{ - "name":"DescribeCreateAccountStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCreateAccountStatusRequest"}, - "output":{"shape":"DescribeCreateAccountStatusResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"CreateAccountStatusNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves the current status of an asynchronous request to create an account.

This operation can be called only from the organization's master account.

" - }, - "DescribeHandshake":{ - "name":"DescribeHandshake", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHandshakeRequest"}, - "output":{"shape":"DescribeHandshakeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"HandshakeNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves information about a previously requested handshake. The handshake ID comes from the response to the original InviteAccountToOrganization operation that generated the handshake.

You can access handshakes that are ACCEPTED, DECLINED, or CANCELED for only 30 days after they change to that state. They are then deleted and no longer accessible.

This operation can be called from any account in the organization.

" - }, - "DescribeOrganization":{ - "name":"DescribeOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{"shape":"DescribeOrganizationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves information about the organization that the user's account belongs to.

This operation can be called from any account in the organization.

Even if a policy type is shown as available in the organization, it can be disabled separately at the root level with DisablePolicyType. Use ListRoots to see the status of policy types for a specified root.

" - }, - "DescribeOrganizationalUnit":{ - "name":"DescribeOrganizationalUnit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrganizationalUnitRequest"}, - "output":{"shape":"DescribeOrganizationalUnitResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"OrganizationalUnitNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves information about an organizational unit (OU).

This operation can be called only from the organization's master account.

" - }, - "DescribePolicy":{ - "name":"DescribePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePolicyRequest"}, - "output":{"shape":"DescribePolicyResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves information about a policy.

This operation can be called only from the organization's master account.

" - }, - "DetachPolicy":{ - "name":"DetachPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetachPolicyRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotAttachedException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TargetNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Detaches a policy from a target root, organizational unit (OU), or account. If the policy being detached is a service control policy (SCP), the changes to permissions for IAM users and roles in affected accounts are immediate.

Note: Every root, OU, and account must have at least one SCP attached. If you want to replace the default FullAWSAccess policy with one that limits the permissions that can be delegated, then you must attach the replacement policy before you can remove the default one. This is the authorization strategy of whitelisting. If you instead attach a second SCP and leave the FullAWSAccess SCP still attached, and specify \"Effect\": \"Deny\" in the second SCP to override the \"Effect\": \"Allow\" in the FullAWSAccess policy (or any other attached SCP), then you are using the authorization strategy of blacklisting.

This operation can be called only from the organization's master account.

" - }, - "DisableAWSServiceAccess":{ - "name":"DisableAWSServiceAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableAWSServiceAccessRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Disables the integration of an AWS service (the service that is specified by ServicePrincipal) with AWS Organizations. When you disable integration, the specified service no longer can create a service-linked role in new accounts in your organization. This means the service can't perform operations on your behalf on any new accounts in your organization. The service can still perform operations in older accounts until the service completes its clean-up from AWS Organizations.

We recommend that you disable integration between AWS Organizations and the specified AWS service by using the console or commands that are provided by the specified service. Doing so ensures that the other service is aware that it can clean up any resources that are required only for the integration. How the service cleans up its resources in the organization's accounts depends on that service. For more information, see the documentation for the other AWS service.

After you perform the DisableAWSServiceAccess operation, the specified service can no longer perform operations in your organization's accounts unless the operations are explicitly permitted by the IAM policies that are attached to your roles.

For more information about integrating other services with AWS Organizations, including the list of services that work with Organizations, see Integrating AWS Organizations with Other AWS Services in the AWS Organizations User Guide.

This operation can be called only from the organization's master account.

" - }, - "DisablePolicyType":{ - "name":"DisablePolicyType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisablePolicyTypeRequest"}, - "output":{"shape":"DisablePolicyTypeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyTypeNotEnabledException"}, - {"shape":"RootNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Disables an organizational control policy type in a root. A policy of a certain type can be attached to entities in a root only if that type is enabled in the root. After you perform this operation, you no longer can attach policies of the specified type to that root or to any organizational unit (OU) or account in that root. You can undo this by using the EnablePolicyType operation.

This operation can be called only from the organization's master account.

If you disable a policy type for a root, it still shows as enabled for the organization if all features are enabled in that organization. Use ListRoots to see the status of policy types for a specified root. Use DescribeOrganization to see the status of policy types in the organization.

" - }, - "EnableAWSServiceAccess":{ - "name":"EnableAWSServiceAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableAWSServiceAccessRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Enables the integration of an AWS service (the service that is specified by ServicePrincipal) with AWS Organizations. When you enable integration, you allow the specified service to create a service-linked role in all the accounts in your organization. This allows the service to perform operations on your behalf in your organization and its accounts.

We recommend that you enable integration between AWS Organizations and the specified AWS service by using the console or commands that are provided by the specified service. Doing so ensures that the service is aware that it can create the resources that are required for the integration. How the service creates those resources in the organization's accounts depends on that service. For more information, see the documentation for the other AWS service.

For more information about enabling services to integrate with AWS Organizations, see Integrating AWS Organizations with Other AWS Services in the AWS Organizations User Guide.

This operation can be called only from the organization's master account and only if the organization has enabled all features.

" - }, - "EnableAllFeatures":{ - "name":"EnableAllFeatures", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableAllFeaturesRequest"}, - "output":{"shape":"EnableAllFeaturesResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"HandshakeConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Enables all features in an organization. This enables the use of organization policies that can restrict the services and actions that can be called in each account. Until you enable all features, you have access only to consolidated billing, and you can't use any of the advanced account administration features that AWS Organizations supports. For more information, see Enabling All Features in Your Organization in the AWS Organizations User Guide.

This operation is required only for organizations that were created explicitly with only the consolidated billing features enabled. Calling this operation sends a handshake to every invited account in the organization. The feature set change can be finalized and the additional features enabled only after all administrators in the invited accounts approve the change by accepting the handshake.

After you enable all features, you can separately enable or disable individual policy types in a root using EnablePolicyType and DisablePolicyType. To see the status of policy types in a root, use ListRoots.

After all invited member accounts accept the handshake, you finalize the feature set change by accepting the handshake that contains \"Action\": \"ENABLE_ALL_FEATURES\". This completes the change.

After you enable all features in your organization, the master account in the organization can apply policies on all member accounts. These policies can restrict what users and even administrators in those accounts can do. The master account can apply policies that prevent accounts from leaving the organization. Ensure that your account administrators are aware of this.

This operation can be called only from the organization's master account.

" - }, - "EnablePolicyType":{ - "name":"EnablePolicyType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnablePolicyTypeRequest"}, - "output":{"shape":"EnablePolicyTypeResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyTypeAlreadyEnabledException"}, - {"shape":"RootNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"PolicyTypeNotAvailableForOrganizationException"} - ], - "documentation":"

Enables a policy type in a root. After you enable a policy type in a root, you can attach policies of that type to the root, any organizational unit (OU), or account in that root. You can undo this by using the DisablePolicyType operation.

This operation can be called only from the organization's master account.

You can enable a policy type in a root only if that policy type is available in the organization. Use DescribeOrganization to view the status of available policy types in the organization.

To view the status of policy type in a root, use ListRoots.

" - }, - "InviteAccountToOrganization":{ - "name":"InviteAccountToOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"InviteAccountToOrganizationRequest"}, - "output":{"shape":"InviteAccountToOrganizationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"HandshakeConstraintViolationException"}, - {"shape":"DuplicateHandshakeException"}, - {"shape":"InvalidInputException"}, - {"shape":"FinalizingOrganizationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Sends an invitation to another account to join your organization as a member account. Organizations sends email on your behalf to the email address that is associated with the other account's owner. The invitation is implemented as a Handshake whose details are in the response.

  • You can invite AWS accounts only from the same seller as the master account. For example, if your organization's master account was created by Amazon Internet Services Pvt. Ltd (AISPL), an AWS seller in India, then you can only invite other AISPL accounts to your organization. You can't combine accounts from AISPL and AWS, or any other AWS seller. For more information, see Consolidated Billing in India.

  • If you receive an exception that indicates that you exceeded your account limits for the organization or that the operation failed because your organization is still initializing, wait one hour and then try again. If the error persists after an hour, then contact AWS Customer Support.

This operation can be called only from the organization's master account.

" - }, - "LeaveOrganization":{ - "name":"LeaveOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AccountNotFoundException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"MasterCannotLeaveOrganizationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Removes a member account from its parent organization. This version of the operation is performed by the account that wants to leave. To remove a member account as a user in the master account, use RemoveAccountFromOrganization instead.

This operation can be called only from a member account in the organization.

  • The master account in an organization with all features enabled can set service control policies (SCPs) that can restrict what administrators of member accounts can do, including preventing them from successfully calling LeaveOrganization and leaving the organization.

  • You can leave an organization as a member account only if the account is configured with the information required to operate as a standalone account. When you create an account in an organization using the AWS Organizations console, API, or CLI commands, the information required of standalone accounts is not automatically collected. For each account that you want to make standalone, you must accept the End User License Agreement (EULA), choose a support plan, provide and verify the required contact information, and provide a current payment method. AWS uses the payment method to charge for any billable (not free tier) AWS activity that occurs while the account is not attached to an organization. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • You can leave an organization only after you enable IAM user access to billing in your account. For more information, see Activating Access to the Billing and Cost Management Console in the AWS Billing and Cost Management User Guide.

" - }, - "ListAWSServiceAccessForOrganization":{ - "name":"ListAWSServiceAccessForOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAWSServiceAccessForOrganizationRequest"}, - "output":{"shape":"ListAWSServiceAccessForOrganizationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Returns a list of the AWS services that you enabled to integrate with your organization. After a service on this list creates the resources that it requires for the integration, it can perform operations on your organization and its accounts.

For more information about integrating other services with AWS Organizations, including the list of services that currently work with Organizations, see Integrating AWS Organizations with Other AWS Services in the AWS Organizations User Guide.

This operation can be called only from the organization's master account.

" - }, - "ListAccounts":{ - "name":"ListAccounts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAccountsRequest"}, - "output":{"shape":"ListAccountsResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists all the accounts in the organization. To request only the accounts in a specified root or organizational unit (OU), use the ListAccountsForParent operation instead.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListAccountsForParent":{ - "name":"ListAccountsForParent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAccountsForParentRequest"}, - "output":{"shape":"ListAccountsForParentResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ParentNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the accounts in an organization that are contained by the specified target root or organizational unit (OU). If you specify the root, you get a list of all the accounts that are not in any OU. If you specify an OU, you get a list of all the accounts in only that OU, and not in any child OUs. To get a list of all accounts in the organization, use the ListAccounts operation.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListChildren":{ - "name":"ListChildren", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListChildrenRequest"}, - "output":{"shape":"ListChildrenResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ParentNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists all of the organizational units (OUs) or accounts that are contained in the specified parent OU or root. This operation, along with ListParents enables you to traverse the tree structure that makes up this root.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListCreateAccountStatus":{ - "name":"ListCreateAccountStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCreateAccountStatusRequest"}, - "output":{"shape":"ListCreateAccountStatusResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the account creation requests that match the specified status that is currently being tracked for the organization.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListHandshakesForAccount":{ - "name":"ListHandshakesForAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHandshakesForAccountRequest"}, - "output":{"shape":"ListHandshakesForAccountResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the current handshakes that are associated with the account of the requesting user.

Handshakes that are ACCEPTED, DECLINED, or CANCELED appear in the results of this API for only 30 days after changing to that state. After that they are deleted and no longer accessible.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called from any account in the organization.

" - }, - "ListHandshakesForOrganization":{ - "name":"ListHandshakesForOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHandshakesForOrganizationRequest"}, - "output":{"shape":"ListHandshakesForOrganizationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the handshakes that are associated with the organization that the requesting user is part of. The ListHandshakesForOrganization operation returns a list of handshake structures. Each structure contains details and status about a handshake.

Handshakes that are ACCEPTED, DECLINED, or CANCELED appear in the results of this API for only 30 days after changing to that state. After that they are deleted and no longer accessible.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListOrganizationalUnitsForParent":{ - "name":"ListOrganizationalUnitsForParent", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOrganizationalUnitsForParentRequest"}, - "output":{"shape":"ListOrganizationalUnitsForParentResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ParentNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the organizational units (OUs) in a parent organizational unit or root.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListParents":{ - "name":"ListParents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListParentsRequest"}, - "output":{"shape":"ListParentsResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ChildNotFoundException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the root or organizational units (OUs) that serve as the immediate parent of the specified child OU or account. This operation, along with ListChildren enables you to traverse the tree structure that makes up this root.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

In the current release, a child can have only a single parent.

" - }, - "ListPolicies":{ - "name":"ListPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPoliciesRequest"}, - "output":{"shape":"ListPoliciesResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Retrieves the list of all policies in an organization of a specified type.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListPoliciesForTarget":{ - "name":"ListPoliciesForTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPoliciesForTargetRequest"}, - "output":{"shape":"ListPoliciesForTargetResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TargetNotFoundException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the policies that are directly attached to the specified target root, organizational unit (OU), or account. You must specify the policy type that you want included in the returned list.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "ListRoots":{ - "name":"ListRoots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRootsRequest"}, - "output":{"shape":"ListRootsResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists the roots that are defined in the current organization.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

Policy types can be enabled and disabled in roots. This is distinct from whether they are available in the organization. When you enable all features, you make policy types available for use in that organization. Individual policy types can then be enabled and disabled in a root. To see the availability of a policy type in an organization, use DescribeOrganization.

" - }, - "ListTargetsForPolicy":{ - "name":"ListTargetsForPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTargetsForPolicyRequest"}, - "output":{"shape":"ListTargetsForPolicyResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"InvalidInputException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Lists all the roots, organizaitonal units (OUs), and accounts to which the specified policy is attached.

Always check the NextToken response parameter for a null value when calling a List* operation. These operations can occasionally return an empty set of results even when there are more results available. The NextToken response parameter value is null only when there are no more results to display.

This operation can be called only from the organization's master account.

" - }, - "MoveAccount":{ - "name":"MoveAccount", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"MoveAccountRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InvalidInputException"}, - {"shape":"SourceParentNotFoundException"}, - {"shape":"DestinationParentNotFoundException"}, - {"shape":"DuplicateAccountException"}, - {"shape":"AccountNotFoundException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ServiceException"} - ], - "documentation":"

Moves an account from its current source parent root or organizational unit (OU) to the specified destination parent root or OU.

This operation can be called only from the organization's master account.

" - }, - "RemoveAccountFromOrganization":{ - "name":"RemoveAccountFromOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveAccountFromOrganizationRequest"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AccountNotFoundException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"InvalidInputException"}, - {"shape":"MasterCannotLeaveOrganizationException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Removes the specified account from the organization.

The removed account becomes a stand-alone account that is not a member of any organization. It is no longer subject to any policies and is responsible for its own bill payments. The organization's master account is no longer charged for any expenses accrued by the member account after it is removed from the organization.

This operation can be called only from the organization's master account. Member accounts can remove themselves with LeaveOrganization instead.

You can remove an account from your organization only if the account is configured with the information required to operate as a standalone account. When you create an account in an organization using the AWS Organizations console, API, or CLI commands, the information required of standalone accounts is not automatically collected. For an account that you want to make standalone, you must accept the End User License Agreement (EULA), choose a support plan, provide and verify the required contact information, and provide a current payment method. AWS uses the payment method to charge for any billable (not free tier) AWS activity that occurs while the account is not attached to an organization. To remove an account that does not yet have this information, you must sign in as the member account and follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

" - }, - "UpdateOrganizationalUnit":{ - "name":"UpdateOrganizationalUnit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateOrganizationalUnitRequest"}, - "output":{"shape":"UpdateOrganizationalUnitResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"DuplicateOrganizationalUnitException"}, - {"shape":"InvalidInputException"}, - {"shape":"OrganizationalUnitNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Renames the specified organizational unit (OU). The ID and ARN do not change. The child OUs and accounts remain in place, and any attached policies of the OU remain attached.

This operation can be called only from the organization's master account.

" - }, - "UpdatePolicy":{ - "name":"UpdatePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePolicyRequest"}, - "output":{"shape":"UpdatePolicyResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"AWSOrganizationsNotInUseException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"ConstraintViolationException"}, - {"shape":"DuplicatePolicyException"}, - {"shape":"InvalidInputException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PolicyNotFoundException"}, - {"shape":"ServiceException"}, - {"shape":"TooManyRequestsException"} - ], - "documentation":"

Updates an existing policy with a new name, description, or content. If any parameter is not supplied, that value remains unchanged. Note that you cannot change a policy's type.

This operation can be called only from the organization's master account.

" - } - }, - "shapes":{ - "AWSOrganizationsNotInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

Your account is not a member of an organization. To make this request, you must use the credentials of an account that belongs to an organization.

", - "exception":true - }, - "AcceptHandshakeRequest":{ - "type":"structure", - "required":["HandshakeId"], - "members":{ - "HandshakeId":{ - "shape":"HandshakeId", - "documentation":"

The unique identifier (ID) of the handshake that you want to accept.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - } - } - }, - "AcceptHandshakeResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains details about the accepted handshake.

" - } - } - }, - "AccessDeniedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.

", - "exception":true - }, - "AccessDeniedForDependencyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "Reason":{"shape":"AccessDeniedForDependencyExceptionReason"} - }, - "documentation":"

The operation you attempted requires you to have the iam:CreateServiceLinkedRole so that Organizations can create the required service-linked role. You do not have that permission.

", - "exception":true - }, - "AccessDeniedForDependencyExceptionReason":{ - "type":"string", - "enum":["ACCESS_DENIED_DURING_CREATE_SERVICE_LINKED_ROLE"] - }, - "Account":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"AccountId", - "documentation":"

The unique identifier (ID) of the account.

The regex pattern for an account ID string requires exactly 12 digits.

" - }, - "Arn":{ - "shape":"AccountArn", - "documentation":"

The Amazon Resource Name (ARN) of the account.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Email":{ - "shape":"Email", - "documentation":"

The email address associated with the AWS account.

The regex pattern for this parameter is a string of characters that represents a standard Internet email address.

" - }, - "Name":{ - "shape":"AccountName", - "documentation":"

The friendly name of the account.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "Status":{ - "shape":"AccountStatus", - "documentation":"

The status of the account in the organization.

" - }, - "JoinedMethod":{ - "shape":"AccountJoinedMethod", - "documentation":"

The method by which the account joined the organization.

" - }, - "JoinedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date the account became a part of the organization.

" - } - }, - "documentation":"

Contains information about an AWS account that is a member of an organization.

" - }, - "AccountArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::\\d{12}:account\\/o-[a-z0-9]{10,32}\\/\\d{12}" - }, - "AccountId":{ - "type":"string", - "pattern":"^\\d{12}$" - }, - "AccountJoinedMethod":{ - "type":"string", - "enum":[ - "INVITED", - "CREATED" - ] - }, - "AccountName":{ - "type":"string", - "max":50, - "min":1, - "sensitive":true - }, - "AccountNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find an AWS account with the AccountId that you specified, or the account whose credentials you used to make this request is not a member of an organization.

", - "exception":true - }, - "AccountStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "SUSPENDED" - ] - }, - "Accounts":{ - "type":"list", - "member":{"shape":"Account"} - }, - "ActionType":{ - "type":"string", - "enum":[ - "INVITE", - "ENABLE_ALL_FEATURES", - "APPROVE_ALL_FEATURES", - "ADD_ORGANIZATIONS_SERVICE_LINKED_ROLE" - ] - }, - "AlreadyInOrganizationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

This account is already a member of an organization. An account can belong to only one organization at a time.

", - "exception":true - }, - "AttachPolicyRequest":{ - "type":"structure", - "required":[ - "PolicyId", - "TargetId" - ], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy that you want to attach to the target. You can get the ID for the policy by calling the ListPolicies operation.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - }, - "TargetId":{ - "shape":"PolicyTargetId", - "documentation":"

The unique identifier (ID) of the root, OU, or account that you want to attach the policy to. You can get the ID by calling the ListRoots, ListOrganizationalUnitsForParent, or ListAccounts operations.

The regex pattern for a target ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - } - } - }, - "AwsManagedPolicy":{"type":"boolean"}, - "CancelHandshakeRequest":{ - "type":"structure", - "required":["HandshakeId"], - "members":{ - "HandshakeId":{ - "shape":"HandshakeId", - "documentation":"

The unique identifier (ID) of the handshake that you want to cancel. You can get the ID from the ListHandshakesForOrganization operation.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - } - } - }, - "CancelHandshakeResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains details about the handshake that you canceled.

" - } - } - }, - "Child":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ChildId", - "documentation":"

The unique identifier (ID) of this child entity.

The regex pattern for a child ID string requires one of the following:

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Type":{ - "shape":"ChildType", - "documentation":"

The type of this child entity.

" - } - }, - "documentation":"

Contains a list of child entities, either OUs or accounts.

" - }, - "ChildId":{ - "type":"string", - "pattern":"^(\\d{12})|(ou-[0-9a-z]{4,32}-[a-z0-9]{8,32})$" - }, - "ChildNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find an organizational unit (OU) or AWS account with the ChildId that you specified.

", - "exception":true - }, - "ChildType":{ - "type":"string", - "enum":[ - "ACCOUNT", - "ORGANIZATIONAL_UNIT" - ] - }, - "Children":{ - "type":"list", - "member":{"shape":"Child"} - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The target of the operation is currently being modified by a different request. Try again later.

", - "exception":true - }, - "ConstraintViolationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "Reason":{"shape":"ConstraintViolationExceptionReason"} - }, - "documentation":"

Performing this operation violates a minimum or maximum value limit. For example, attempting to removing the last SCP from an OU or root, inviting or creating too many accounts to the organization, or attaching too many policies to an account, OU, or root. This exception includes a reason that contains additional information about the violated limit:

Some of the reasons in the following list might not be applicable to this specific API or operation:

  • ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number of accounts in an organization. If you need more accounts, contact AWS Support to request an increase in your limit.

    Or, The number of invitations that you tried to send would cause you to exceed the limit of accounts in your organization. Send fewer invitations, or contact AWS Support to request an increase in the number of accounts.

    Note: deleted and closed accounts still count toward your limit.

    If you get receive this exception when running a command immediately after creating the organization, wait one hour and try again. If after an hour it continues to fail with this error, contact AWS Customer Support.

  • HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of handshakes you can send in one day.

  • OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational units you can have in an organization.

  • OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit tree that is too many levels deep.

  • ORGANIZATION_NOT_IN_ALL_FEATURES_MODE: You attempted to perform an operation that requires the organization to be configured to support all features. An organization that supports consolidated billing features only cannot perform this operation.

  • POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of policies that you can have in an organization.

  • MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the number of policies of a certain type that can be attached to an entity at one time.

  • MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a policy from an entity that would cause the entity to have fewer than the minimum number of policies of a certain type required.

  • ACCOUNT_CANNOT_LEAVE_WITHOUT_EULA: You attempted to remove an account from the organization that does not yet have enough information to exist as a stand-alone account. This account requires you to first agree to the AWS Customer Agreement. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • ACCOUNT_CANNOT_LEAVE_WITHOUT_PHONE_VERIFICATION: You attempted to remove an account from the organization that does not yet have enough information to exist as a stand-alone account. This account requires you to first complete phone verification. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization with this account, you first must associate a payment instrument, such as a credit card, with the account. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation with this member account, you first must associate a payment instrument, such as a credit card, with the account. Follow the steps at To leave an organization when all required account information has not yet been provided in the AWS Organizations User Guide.

  • ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of accounts that you can create in one day.

  • MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account in this organization, you first must migrate the organization's master account to the marketplace that corresponds to the master account's address. For example, accounts with India addresses must be associated with the AISPL marketplace. All accounts in an organization must be associated with the same marketplace.

  • MASTER_ACCOUNT_MISSING_CONTACT_INFO: To complete this operation, you must first provide contact a valid address and phone number for the master account. Then try the operation again.

", - "exception":true - }, - "ConstraintViolationExceptionReason":{ - "type":"string", - "enum":[ - "ACCOUNT_NUMBER_LIMIT_EXCEEDED", - "HANDSHAKE_RATE_LIMIT_EXCEEDED", - "OU_NUMBER_LIMIT_EXCEEDED", - "OU_DEPTH_LIMIT_EXCEEDED", - "POLICY_NUMBER_LIMIT_EXCEEDED", - "MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED", - "MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED", - "ACCOUNT_CANNOT_LEAVE_ORGANIZATION", - "ACCOUNT_CANNOT_LEAVE_WITHOUT_EULA", - "ACCOUNT_CANNOT_LEAVE_WITHOUT_PHONE_VERIFICATION", - "MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED", - "MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED", - "ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED", - "MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE", - "MASTER_ACCOUNT_MISSING_CONTACT_INFO", - "ORGANIZATION_NOT_IN_ALL_FEATURES_MODE" - ] - }, - "CreateAccountFailureReason":{ - "type":"string", - "enum":[ - "ACCOUNT_LIMIT_EXCEEDED", - "EMAIL_ALREADY_EXISTS", - "INVALID_ADDRESS", - "INVALID_EMAIL", - "CONCURRENT_ACCOUNT_MODIFICATION", - "INTERNAL_FAILURE" - ] - }, - "CreateAccountRequest":{ - "type":"structure", - "required":[ - "Email", - "AccountName" - ], - "members":{ - "Email":{ - "shape":"Email", - "documentation":"

The email address of the owner to assign to the new member account. This email address must not already be associated with another AWS account. You must use a valid email address to complete account creation. You cannot access the root user of the account or remove an account that was created with an invalid email address.

" - }, - "AccountName":{ - "shape":"AccountName", - "documentation":"

The friendly name of the member account.

" - }, - "RoleName":{ - "shape":"RoleName", - "documentation":"

(Optional)

The name of an IAM role that Organizations automatically preconfigures in the new member account. This role trusts the master account, allowing users in the master account to assume the role, as permitted by the master account administrator. The role has administrator permissions in the new member account.

If you do not specify this parameter, the role name defaults to OrganizationAccountAccessRole.

For more information about how to use this role to access the member account, see Accessing and Administering the Member Accounts in Your Organization in the AWS Organizations User Guide, and steps 2 and 3 in Tutorial: Delegate Access Across AWS Accounts Using IAM Roles in the IAM User Guide.

The regex pattern that is used to validate this parameter is a string of characters that can consist of uppercase letters, lowercase letters, digits with no spaces, and any of the following characters: =,.@-

" - }, - "IamUserAccessToBilling":{ - "shape":"IAMUserAccessToBilling", - "documentation":"

If set to ALLOW, the new account enables IAM users to access account billing information if they have the required permissions. If set to DENY, then only the root user of the new account can access account billing information. For more information, see Activating Access to the Billing and Cost Management Console in the AWS Billing and Cost Management User Guide.

If you do not specify this parameter, the value defaults to ALLOW, and IAM users and roles with the required permissions can access billing information for the new account.

" - } - } - }, - "CreateAccountRequestId":{ - "type":"string", - "pattern":"^car-[a-z0-9]{8,32}$" - }, - "CreateAccountResponse":{ - "type":"structure", - "members":{ - "CreateAccountStatus":{ - "shape":"CreateAccountStatus", - "documentation":"

A structure that contains details about the request to create an account. This response structure might not be fully populated when you first receive it because account creation is an asynchronous process. You can pass the returned CreateAccountStatus ID as a parameter to DescribeCreateAccountStatus to get status about the progress of the request at later times.

" - } - } - }, - "CreateAccountState":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "SUCCEEDED", - "FAILED" - ] - }, - "CreateAccountStates":{ - "type":"list", - "member":{"shape":"CreateAccountState"} - }, - "CreateAccountStatus":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"CreateAccountRequestId", - "documentation":"

The unique identifier (ID) that references this request. You get this value from the response of the initial CreateAccount request to create the account.

The regex pattern for an create account request ID string requires \"car-\" followed by from 8 to 32 lower-case letters or digits.

" - }, - "AccountName":{ - "shape":"AccountName", - "documentation":"

The account name given to the account when it was created.

" - }, - "State":{ - "shape":"CreateAccountState", - "documentation":"

The status of the request.

" - }, - "RequestedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the request was made for the account creation.

" - }, - "CompletedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the account was created and the request completed.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

If the account was created successfully, the unique identifier (ID) of the new account.

The regex pattern for an account ID string requires exactly 12 digits.

" - }, - "FailureReason":{ - "shape":"CreateAccountFailureReason", - "documentation":"

If the request failed, a description of the reason for the failure.

  • ACCOUNT_LIMIT_EXCEEDED: The account could not be created because you have reached the limit on the number of accounts in your organization.

  • EMAIL_ALREADY_EXISTS: The account could not be created because another AWS account with that email address already exists.

  • INVALID_ADDRESS: The account could not be created because the address you provided is not valid.

  • INVALID_EMAIL: The account could not be created because the email address you provided is not valid.

  • INTERNAL_FAILURE: The account could not be created because of an internal failure. Try again later. If the problem persists, contact Customer Support.

" - } - }, - "documentation":"

Contains the status about a CreateAccount request to create an AWS account in an organization.

" - }, - "CreateAccountStatusNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find an create account request with the CreateAccountRequestId that you specified.

", - "exception":true - }, - "CreateAccountStatuses":{ - "type":"list", - "member":{"shape":"CreateAccountStatus"} - }, - "CreateOrganizationRequest":{ - "type":"structure", - "members":{ - "FeatureSet":{ - "shape":"OrganizationFeatureSet", - "documentation":"

Specifies the feature set supported by the new organization. Each feature set supports different levels of functionality.

  • CONSOLIDATED_BILLING: All member accounts have their bills consolidated to and paid by the master account. For more information, see Consolidated Billing in the AWS Organizations User Guide.

  • ALL: In addition to all the features supported by the consolidated billing feature set, the master account can also apply any type of policy to any member account in the organization. For more information, see All features in the AWS Organizations User Guide.

" - } - } - }, - "CreateOrganizationResponse":{ - "type":"structure", - "members":{ - "Organization":{ - "shape":"Organization", - "documentation":"

A structure that contains details about the newly created organization.

" - } - } - }, - "CreateOrganizationalUnitRequest":{ - "type":"structure", - "required":[ - "ParentId", - "Name" - ], - "members":{ - "ParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) of the parent root or OU in which you want to create the new OU.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Name":{ - "shape":"OrganizationalUnitName", - "documentation":"

The friendly name to assign to the new OU.

" - } - } - }, - "CreateOrganizationalUnitResponse":{ - "type":"structure", - "members":{ - "OrganizationalUnit":{ - "shape":"OrganizationalUnit", - "documentation":"

A structure that contains details about the newly created OU.

" - } - } - }, - "CreatePolicyRequest":{ - "type":"structure", - "required":[ - "Content", - "Description", - "Name", - "Type" - ], - "members":{ - "Content":{ - "shape":"PolicyContent", - "documentation":"

The policy content to add to the new policy. For example, if you create a service control policy (SCP), this string must be JSON text that specifies the permissions that admins in attached accounts can delegate to their users, groups, and roles. For more information about the SCP syntax, see Service Control Policy Syntax in the AWS Organizations User Guide.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

An optional description to assign to the policy.

" - }, - "Name":{ - "shape":"PolicyName", - "documentation":"

The friendly name to assign to the policy.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "Type":{ - "shape":"PolicyType", - "documentation":"

The type of policy to create.

In the current release, the only type of policy that you can create is a service control policy (SCP).

" - } - } - }, - "CreatePolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

A structure that contains details about the newly created policy.

" - } - } - }, - "DeclineHandshakeRequest":{ - "type":"structure", - "required":["HandshakeId"], - "members":{ - "HandshakeId":{ - "shape":"HandshakeId", - "documentation":"

The unique identifier (ID) of the handshake that you want to decline. You can get the ID from the ListHandshakesForAccount operation.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - } - } - }, - "DeclineHandshakeResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains details about the declined handshake. The state is updated to show the value DECLINED.

" - } - } - }, - "DeleteOrganizationalUnitRequest":{ - "type":"structure", - "required":["OrganizationalUnitId"], - "members":{ - "OrganizationalUnitId":{ - "shape":"OrganizationalUnitId", - "documentation":"

The unique identifier (ID) of the organizational unit that you want to delete. You can get the ID from the ListOrganizationalUnitsForParent operation.

The regex pattern for an organizational unit ID string requires \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - } - } - }, - "DeletePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy that you want to delete. You can get the ID from the ListPolicies or ListPoliciesForTarget operations.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - } - } - }, - "DescribeAccountRequest":{ - "type":"structure", - "required":["AccountId"], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The unique identifier (ID) of the AWS account that you want information about. You can get the ID from the ListAccounts or ListAccountsForParent operations.

The regex pattern for an account ID string requires exactly 12 digits.

" - } - } - }, - "DescribeAccountResponse":{ - "type":"structure", - "members":{ - "Account":{ - "shape":"Account", - "documentation":"

A structure that contains information about the requested account.

" - } - } - }, - "DescribeCreateAccountStatusRequest":{ - "type":"structure", - "required":["CreateAccountRequestId"], - "members":{ - "CreateAccountRequestId":{ - "shape":"CreateAccountRequestId", - "documentation":"

Specifies the operationId that uniquely identifies the request. You can get the ID from the response to an earlier CreateAccount request, or from the ListCreateAccountStatus operation.

The regex pattern for an create account request ID string requires \"car-\" followed by from 8 to 32 lower-case letters or digits.

" - } - } - }, - "DescribeCreateAccountStatusResponse":{ - "type":"structure", - "members":{ - "CreateAccountStatus":{ - "shape":"CreateAccountStatus", - "documentation":"

A structure that contains the current status of an account creation request.

" - } - } - }, - "DescribeHandshakeRequest":{ - "type":"structure", - "required":["HandshakeId"], - "members":{ - "HandshakeId":{ - "shape":"HandshakeId", - "documentation":"

The unique identifier (ID) of the handshake that you want information about. You can get the ID from the original call to InviteAccountToOrganization, or from a call to ListHandshakesForAccount or ListHandshakesForOrganization.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - } - } - }, - "DescribeHandshakeResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains information about the specified handshake.

" - } - } - }, - "DescribeOrganizationResponse":{ - "type":"structure", - "members":{ - "Organization":{ - "shape":"Organization", - "documentation":"

A structure that contains information about the organization.

" - } - } - }, - "DescribeOrganizationalUnitRequest":{ - "type":"structure", - "required":["OrganizationalUnitId"], - "members":{ - "OrganizationalUnitId":{ - "shape":"OrganizationalUnitId", - "documentation":"

The unique identifier (ID) of the organizational unit that you want details about. You can get the ID from the ListOrganizationalUnitsForParent operation.

The regex pattern for an organizational unit ID string requires \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - } - } - }, - "DescribeOrganizationalUnitResponse":{ - "type":"structure", - "members":{ - "OrganizationalUnit":{ - "shape":"OrganizationalUnit", - "documentation":"

A structure that contains details about the specified OU.

" - } - } - }, - "DescribePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy that you want details about. You can get the ID from the ListPolicies or ListPoliciesForTarget operations.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - } - } - }, - "DescribePolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

A structure that contains details about the specified policy.

" - } - } - }, - "DestinationParentNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find the destination container (a root or OU) with the ParentId that you specified.

", - "exception":true - }, - "DetachPolicyRequest":{ - "type":"structure", - "required":[ - "PolicyId", - "TargetId" - ], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy you want to detach. You can get the ID from the ListPolicies or ListPoliciesForTarget operations.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - }, - "TargetId":{ - "shape":"PolicyTargetId", - "documentation":"

The unique identifier (ID) of the root, OU, or account from which you want to detach the policy. You can get the ID from the ListRoots, ListOrganizationalUnitsForParent, or ListAccounts operations.

The regex pattern for a target ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - } - } - }, - "DisableAWSServiceAccessRequest":{ - "type":"structure", - "required":["ServicePrincipal"], - "members":{ - "ServicePrincipal":{ - "shape":"ServicePrincipal", - "documentation":"

The service principal name of the AWS service for which you want to disable integration with your organization. This is typically in the form of a URL, such as service-abbreviation.amazonaws.com.

" - } - } - }, - "DisablePolicyTypeRequest":{ - "type":"structure", - "required":[ - "RootId", - "PolicyType" - ], - "members":{ - "RootId":{ - "shape":"RootId", - "documentation":"

The unique identifier (ID) of the root in which you want to disable a policy type. You can get the ID from the ListRoots operation.

The regex pattern for a root ID string requires \"r-\" followed by from 4 to 32 lower-case letters or digits.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The policy type that you want to disable in this root.

" - } - } - }, - "DisablePolicyTypeResponse":{ - "type":"structure", - "members":{ - "Root":{ - "shape":"Root", - "documentation":"

A structure that shows the root with the updated list of enabled policy types.

" - } - } - }, - "DuplicateAccountException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

That account is already present in the specified destination.

", - "exception":true - }, - "DuplicateHandshakeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A handshake with the same action and target already exists. For example, if you invited an account to join your organization, the invited account might already have a pending invitation from this organization. If you intend to resend an invitation to an account, ensure that existing handshakes that might be considered duplicates are canceled or declined.

", - "exception":true - }, - "DuplicateOrganizationalUnitException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

An organizational unit (OU) with the same name already exists.

", - "exception":true - }, - "DuplicatePolicyAttachmentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The selected policy is already attached to the specified target.

", - "exception":true - }, - "DuplicatePolicyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A policy with the same name already exists.

", - "exception":true - }, - "Email":{ - "type":"string", - "max":64, - "min":6, - "pattern":"[^\\s@]+@[^\\s@]+\\.[^\\s@]+", - "sensitive":true - }, - "EnableAWSServiceAccessRequest":{ - "type":"structure", - "required":["ServicePrincipal"], - "members":{ - "ServicePrincipal":{ - "shape":"ServicePrincipal", - "documentation":"

The service principal name of the AWS service for which you want to enable integration with your organization. This is typically in the form of a URL, such as service-abbreviation.amazonaws.com.

" - } - } - }, - "EnableAllFeaturesRequest":{ - "type":"structure", - "members":{ - } - }, - "EnableAllFeaturesResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains details about the handshake created to support this request to enable all features in the organization.

" - } - } - }, - "EnablePolicyTypeRequest":{ - "type":"structure", - "required":[ - "RootId", - "PolicyType" - ], - "members":{ - "RootId":{ - "shape":"RootId", - "documentation":"

The unique identifier (ID) of the root in which you want to enable a policy type. You can get the ID from the ListRoots operation.

The regex pattern for a root ID string requires \"r-\" followed by from 4 to 32 lower-case letters or digits.

" - }, - "PolicyType":{ - "shape":"PolicyType", - "documentation":"

The policy type that you want to enable.

" - } - } - }, - "EnablePolicyTypeResponse":{ - "type":"structure", - "members":{ - "Root":{ - "shape":"Root", - "documentation":"

A structure that shows the root with the updated list of enabled policy types.

" - } - } - }, - "EnabledServicePrincipal":{ - "type":"structure", - "members":{ - "ServicePrincipal":{ - "shape":"ServicePrincipal", - "documentation":"

The name of the service principal. This is typically in the form of a URL, such as: servicename.amazonaws.com.

" - }, - "DateEnabled":{ - "shape":"Timestamp", - "documentation":"

The date that the service principal was enabled for integration with AWS Organizations.

" - } - }, - "documentation":"

A structure that contains details of a service principal that is enabled to integrate with AWS Organizations.

" - }, - "EnabledServicePrincipals":{ - "type":"list", - "member":{"shape":"EnabledServicePrincipal"} - }, - "ExceptionMessage":{"type":"string"}, - "ExceptionType":{"type":"string"}, - "FinalizingOrganizationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

AWS Organizations could not perform the operation because your organization has not finished initializing. This can take up to an hour. Try again later. If after one hour you continue to receive this error, contact AWS Customer Support.

", - "exception":true - }, - "GenericArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::.+:.+" - }, - "Handshake":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"HandshakeId", - "documentation":"

The unique identifier (ID) of a handshake. The originating account creates the ID when it initiates the handshake.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - }, - "Arn":{ - "shape":"HandshakeArn", - "documentation":"

The Amazon Resource Name (ARN) of a handshake.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Parties":{ - "shape":"HandshakeParties", - "documentation":"

Information about the two accounts that are participating in the handshake.

" - }, - "State":{ - "shape":"HandshakeState", - "documentation":"

The current state of the handshake. Use the state to trace the flow of the handshake through the process from its creation to its acceptance. The meaning of each of the valid values is as follows:

  • REQUESTED: This handshake was sent to multiple recipients (applicable to only some handshake types) and not all recipients have responded yet. The request stays in this state until all recipients respond.

  • OPEN: This handshake was sent to multiple recipients (applicable to only some policy types) and all recipients have responded, allowing the originator to complete the handshake action.

  • CANCELED: This handshake is no longer active because it was canceled by the originating account.

  • ACCEPTED: This handshake is complete because it has been accepted by the recipient.

  • DECLINED: This handshake is no longer active because it was declined by the recipient account.

  • EXPIRED: This handshake is no longer active because the originator did not receive a response of any kind from the recipient before the expiration time (15 days).

" - }, - "RequestedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the handshake request was made.

" - }, - "ExpirationTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time that the handshake expires. If the recipient of the handshake request fails to respond before the specified date and time, the handshake becomes inactive and is no longer valid.

" - }, - "Action":{ - "shape":"ActionType", - "documentation":"

The type of handshake, indicating what action occurs when the recipient accepts the handshake. The following handshake types are supported:

  • INVITE: This type of handshake represents a request to join an organization. It is always sent from the master account to only non-member accounts.

  • ENABLE_ALL_FEATURES: This type of handshake represents a request to enable all features in an organization. It is always sent from the master account to only invited member accounts. Created accounts do not receive this because those accounts were created by the organization's master account and approval is inferred.

  • APPROVE_ALL_FEATURES: This type of handshake is sent from the Organizations service when all member accounts have approved the ENABLE_ALL_FEATURES invitation. It is sent only to the master account and signals the master that it can finalize the process to enable all features.

" - }, - "Resources":{ - "shape":"HandshakeResources", - "documentation":"

Additional information that is needed to process the handshake.

" - } - }, - "documentation":"

Contains information that must be exchanged to securely establish a relationship between two accounts (an originator and a recipient). For example, when a master account (the originator) invites another account (the recipient) to join its organization, the two accounts exchange information as a series of handshake requests and responses.

Note: Handshakes that are CANCELED, ACCEPTED, or DECLINED show up in lists for only 30 days after entering that state After that they are deleted.

" - }, - "HandshakeAlreadyInStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified handshake is already in the requested state. For example, you can't accept a handshake that was already accepted.

", - "exception":true - }, - "HandshakeArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::\\d{12}:handshake\\/o-[a-z0-9]{10,32}\\/[a-z_]{1,32}\\/h-[0-9a-z]{8,32}" - }, - "HandshakeConstraintViolationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "Reason":{"shape":"HandshakeConstraintViolationExceptionReason"} - }, - "documentation":"

The requested operation would violate the constraint identified in the reason code.

Some of the reasons in the following list might not be applicable to this specific API or operation:

  • ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number of accounts in an organization. Note: deleted and closed accounts still count toward your limit.

    If you get this exception immediately after creating the organization, wait one hour and try again. If after an hour it continues to fail with this error, contact AWS Customer Support.

  • HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of handshakes you can send in one day.

  • ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because the invited account is already a member of an organization.

  • ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid because the organization has already enabled all features.

  • INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations to join an organization while it is in the process of enabling all features. You can resume inviting accounts after you finalize the process when all accounts have agreed to the change.

  • PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with an account that does not have a payment instrument, such as a credit card, associated with it.

  • ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because the account is from a different marketplace than the accounts in the organization. For example, accounts with India addresses must be associated with the AISPL marketplace. All accounts in an organization must be from the same marketplace.

  • ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to change the membership of an account too quickly after its previous change.

", - "exception":true - }, - "HandshakeConstraintViolationExceptionReason":{ - "type":"string", - "enum":[ - "ACCOUNT_NUMBER_LIMIT_EXCEEDED", - "HANDSHAKE_RATE_LIMIT_EXCEEDED", - "ALREADY_IN_AN_ORGANIZATION", - "ORGANIZATION_ALREADY_HAS_ALL_FEATURES", - "INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES", - "PAYMENT_INSTRUMENT_REQUIRED", - "ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD", - "ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED" - ] - }, - "HandshakeFilter":{ - "type":"structure", - "members":{ - "ActionType":{ - "shape":"ActionType", - "documentation":"

Specifies the type of handshake action.

If you specify ActionType, you cannot also specify ParentHandshakeId.

" - }, - "ParentHandshakeId":{ - "shape":"HandshakeId", - "documentation":"

Specifies the parent handshake. Only used for handshake types that are a child of another type.

If you specify ParentHandshakeId, you cannot also specify ActionType.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - } - }, - "documentation":"

Specifies the criteria that are used to select the handshakes for the operation.

" - }, - "HandshakeId":{ - "type":"string", - "pattern":"^h-[0-9a-z]{8,32}$" - }, - "HandshakeNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a handshake with the HandshakeId that you specified.

", - "exception":true - }, - "HandshakeNotes":{ - "type":"string", - "max":1024, - "sensitive":true - }, - "HandshakeParties":{ - "type":"list", - "member":{"shape":"HandshakeParty"} - }, - "HandshakeParty":{ - "type":"structure", - "required":[ - "Id", - "Type" - ], - "members":{ - "Id":{ - "shape":"HandshakePartyId", - "documentation":"

The unique identifier (ID) for the party.

The regex pattern for handshake ID string requires \"h-\" followed by from 8 to 32 lower-case letters or digits.

" - }, - "Type":{ - "shape":"HandshakePartyType", - "documentation":"

The type of party.

" - } - }, - "documentation":"

Identifies a participant in a handshake.

" - }, - "HandshakePartyId":{ - "type":"string", - "max":64, - "min":1, - "sensitive":true - }, - "HandshakePartyType":{ - "type":"string", - "enum":[ - "ACCOUNT", - "ORGANIZATION", - "EMAIL" - ] - }, - "HandshakeResource":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"HandshakeResourceValue", - "documentation":"

The information that is passed to the other party in the handshake. The format of the value string must match the requirements of the specified type.

" - }, - "Type":{ - "shape":"HandshakeResourceType", - "documentation":"

The type of information being passed, specifying how the value is to be interpreted by the other party:

  • ACCOUNT - Specifies an AWS account ID number.

  • ORGANIZATION - Specifies an organization ID number.

  • EMAIL - Specifies the email address that is associated with the account that receives the handshake.

  • OWNER_EMAIL - Specifies the email address associated with the master account. Included as information about an organization.

  • OWNER_NAME - Specifies the name associated with the master account. Included as information about an organization.

  • NOTES - Additional text provided by the handshake initiator and intended for the recipient to read.

" - }, - "Resources":{ - "shape":"HandshakeResources", - "documentation":"

When needed, contains an additional array of HandshakeResource objects.

" - } - }, - "documentation":"

Contains additional data that is needed to process a handshake.

" - }, - "HandshakeResourceType":{ - "type":"string", - "enum":[ - "ACCOUNT", - "ORGANIZATION", - "ORGANIZATION_FEATURE_SET", - "EMAIL", - "MASTER_EMAIL", - "MASTER_NAME", - "NOTES", - "PARENT_HANDSHAKE" - ] - }, - "HandshakeResourceValue":{ - "type":"string", - "sensitive":true - }, - "HandshakeResources":{ - "type":"list", - "member":{"shape":"HandshakeResource"} - }, - "HandshakeState":{ - "type":"string", - "enum":[ - "REQUESTED", - "OPEN", - "CANCELED", - "ACCEPTED", - "DECLINED", - "EXPIRED" - ] - }, - "Handshakes":{ - "type":"list", - "member":{"shape":"Handshake"} - }, - "IAMUserAccessToBilling":{ - "type":"string", - "enum":[ - "ALLOW", - "DENY" - ] - }, - "InvalidHandshakeTransitionException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

You can't perform the operation on the handshake in its current state. For example, you can't cancel a handshake that was already accepted, or accept a handshake that was already declined.

", - "exception":true - }, - "InvalidInputException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"}, - "Reason":{"shape":"InvalidInputExceptionReason"} - }, - "documentation":"

The requested operation failed because you provided invalid values for one or more of the request parameters. This exception includes a reason that contains additional information about the violated limit:

Some of the reasons in the following list might not be applicable to this specific API or operation:

  • IMMUTABLE_POLICY: You specified a policy that is managed by AWS and cannot be modified.

  • INPUT_REQUIRED: You must include a value for all required parameters.

  • INVALID_ENUM: You specified a value that is not valid for that parameter.

  • INVALID_FULL_NAME_TARGET: You specified a full name that contains invalid characters.

  • INVALID_LIST_MEMBER: You provided a list to a parameter that contains at least one invalid value.

  • INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, organization, or email) as a party.

  • INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter from the response to a previous call of the operation.

  • INVALID_PATTERN: You provided a value that doesn't match the required pattern.

  • INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't match the required pattern.

  • INVALID_ROLE_NAME: You provided a role name that is not valid. A role name can’t begin with the reserved prefix 'AWSServiceRoleFor'.

  • INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the organization.

  • INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID.

  • MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter for the operation.

  • MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer than allowed.

  • MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger value than allowed.

  • MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter than allowed.

  • MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller value than allowed.

  • MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only between entities in the same root.

", - "exception":true - }, - "InvalidInputExceptionReason":{ - "type":"string", - "enum":[ - "INVALID_PARTY_TYPE_TARGET", - "INVALID_SYNTAX_ORGANIZATION_ARN", - "INVALID_SYNTAX_POLICY_ID", - "INVALID_ENUM", - "INVALID_LIST_MEMBER", - "MAX_LENGTH_EXCEEDED", - "MAX_VALUE_EXCEEDED", - "MIN_LENGTH_EXCEEDED", - "MIN_VALUE_EXCEEDED", - "IMMUTABLE_POLICY", - "INVALID_PATTERN", - "INVALID_PATTERN_TARGET_ID", - "INPUT_REQUIRED", - "INVALID_NEXT_TOKEN", - "MAX_LIMIT_EXCEEDED_FILTER", - "MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS", - "INVALID_FULL_NAME_TARGET", - "UNRECOGNIZED_SERVICE_PRINCIPAL", - "INVALID_ROLE_NAME" - ] - }, - "InviteAccountToOrganizationRequest":{ - "type":"structure", - "required":["Target"], - "members":{ - "Target":{ - "shape":"HandshakeParty", - "documentation":"

The identifier (ID) of the AWS account that you want to invite to join your organization. This is a JSON object that contains the following elements:

{ \"Type\": \"ACCOUNT\", \"Id\": \"< account id number >\" }

If you use the AWS CLI, you can submit this as a single string, similar to the following example:

--target Id=123456789012,Type=ACCOUNT

If you specify \"Type\": \"ACCOUNT\", then you must provide the AWS account ID number as the Id. If you specify \"Type\": \"EMAIL\", then you must specify the email address that is associated with the account.

--target Id=bill@example.com,Type=EMAIL

" - }, - "Notes":{ - "shape":"HandshakeNotes", - "documentation":"

Additional information that you want to include in the generated email to the recipient account owner.

" - } - } - }, - "InviteAccountToOrganizationResponse":{ - "type":"structure", - "members":{ - "Handshake":{ - "shape":"Handshake", - "documentation":"

A structure that contains details about the handshake that is created to support this invitation request.

" - } - } - }, - "ListAWSServiceAccessForOrganizationRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListAWSServiceAccessForOrganizationResponse":{ - "type":"structure", - "members":{ - "EnabledServicePrincipals":{ - "shape":"EnabledServicePrincipals", - "documentation":"

A list of the service principals for the services that are enabled to integrate with your organization. Each principal is a structure that includes the name and the date that it was enabled for integration with AWS Organizations.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListAccountsForParentRequest":{ - "type":"structure", - "required":["ParentId"], - "members":{ - "ParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) for the parent root or organization unit (OU) whose accounts you want to list.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListAccountsForParentResponse":{ - "type":"structure", - "members":{ - "Accounts":{ - "shape":"Accounts", - "documentation":"

A list of the accounts in the specified root or OU.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListAccountsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListAccountsResponse":{ - "type":"structure", - "members":{ - "Accounts":{ - "shape":"Accounts", - "documentation":"

A list of objects in the organization.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListChildrenRequest":{ - "type":"structure", - "required":[ - "ParentId", - "ChildType" - ], - "members":{ - "ParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) for the parent root or OU whose children you want to list.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "ChildType":{ - "shape":"ChildType", - "documentation":"

Filters the output to include only the specified child type.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListChildrenResponse":{ - "type":"structure", - "members":{ - "Children":{ - "shape":"Children", - "documentation":"

The list of children of the specified parent container.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListCreateAccountStatusRequest":{ - "type":"structure", - "members":{ - "States":{ - "shape":"CreateAccountStates", - "documentation":"

A list of one or more states that you want included in the response. If this parameter is not present, then all requests are included in the response.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListCreateAccountStatusResponse":{ - "type":"structure", - "members":{ - "CreateAccountStatuses":{ - "shape":"CreateAccountStatuses", - "documentation":"

A list of objects with details about the requests. Certain elements, such as the accountId number, are present in the output only after the account has been successfully created.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListHandshakesForAccountRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"HandshakeFilter", - "documentation":"

Filters the handshakes that you want included in the response. The default is all types. Use the ActionType element to limit the output to only a specified type, such as INVITE, ENABLE-FULL-CONTROL, or APPROVE-FULL-CONTROL. Alternatively, for the ENABLE-FULL-CONTROL handshake that generates a separate child handshake for each member account, you can specify ParentHandshakeId to see only the handshakes that were generated by that parent request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListHandshakesForAccountResponse":{ - "type":"structure", - "members":{ - "Handshakes":{ - "shape":"Handshakes", - "documentation":"

A list of Handshake objects with details about each of the handshakes that is associated with the specified account.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListHandshakesForOrganizationRequest":{ - "type":"structure", - "members":{ - "Filter":{ - "shape":"HandshakeFilter", - "documentation":"

A filter of the handshakes that you want included in the response. The default is all types. Use the ActionType element to limit the output to only a specified type, such as INVITE, ENABLE-ALL-FEATURES, or APPROVE-ALL-FEATURES. Alternatively, for the ENABLE-ALL-FEATURES handshake that generates a separate child handshake for each member account, you can specify the ParentHandshakeId to see only the handshakes that were generated by that parent request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListHandshakesForOrganizationResponse":{ - "type":"structure", - "members":{ - "Handshakes":{ - "shape":"Handshakes", - "documentation":"

A list of Handshake objects with details about each of the handshakes that are associated with an organization.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListOrganizationalUnitsForParentRequest":{ - "type":"structure", - "required":["ParentId"], - "members":{ - "ParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) of the root or OU whose child OUs you want to list.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListOrganizationalUnitsForParentResponse":{ - "type":"structure", - "members":{ - "OrganizationalUnits":{ - "shape":"OrganizationalUnits", - "documentation":"

A list of the OUs in the specified root or parent OU.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListParentsRequest":{ - "type":"structure", - "required":["ChildId"], - "members":{ - "ChildId":{ - "shape":"ChildId", - "documentation":"

The unique identifier (ID) of the OU or account whose parent containers you want to list. Do not specify a root.

The regex pattern for a child ID string requires one of the following:

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListParentsResponse":{ - "type":"structure", - "members":{ - "Parents":{ - "shape":"Parents", - "documentation":"

A list of parents for the specified child account or OU.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListPoliciesForTargetRequest":{ - "type":"structure", - "required":[ - "TargetId", - "Filter" - ], - "members":{ - "TargetId":{ - "shape":"PolicyTargetId", - "documentation":"

The unique identifier (ID) of the root, organizational unit, or account whose policies you want to list.

The regex pattern for a target ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Filter":{ - "shape":"PolicyType", - "documentation":"

The type of policy that you want to include in the returned list.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListPoliciesForTargetResponse":{ - "type":"structure", - "members":{ - "Policies":{ - "shape":"Policies", - "documentation":"

The list of policies that match the criteria in the request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListPoliciesRequest":{ - "type":"structure", - "required":["Filter"], - "members":{ - "Filter":{ - "shape":"PolicyType", - "documentation":"

Specifies the type of policy that you want to include in the response.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListPoliciesResponse":{ - "type":"structure", - "members":{ - "Policies":{ - "shape":"Policies", - "documentation":"

A list of policies that match the filter criteria in the request. The output list does not include the policy contents. To see the content for a policy, see DescribePolicy.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListRootsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListRootsResponse":{ - "type":"structure", - "members":{ - "Roots":{ - "shape":"Roots", - "documentation":"

A list of roots that are defined in an organization.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "ListTargetsForPolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy for which you want to know its attachments.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

Use this parameter if you receive a NextToken response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

" - } - } - }, - "ListTargetsForPolicyResponse":{ - "type":"structure", - "members":{ - "Targets":{ - "shape":"PolicyTargets", - "documentation":"

A list of structures, each of which contains details about one of the entities to which the specified policy is attached.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null.

" - } - } - }, - "MalformedPolicyDocumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The provided policy document does not meet the requirements of the specified policy type. For example, the syntax might be incorrect. For details about service control policy syntax, see Service Control Policy Syntax in the AWS Organizations User Guide.

", - "exception":true - }, - "MasterCannotLeaveOrganizationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

You can't remove a master account from an organization. If you want the master account to become a member account in another organization, you must first delete the current organization of the master account.

", - "exception":true - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":20, - "min":1 - }, - "MoveAccountRequest":{ - "type":"structure", - "required":[ - "AccountId", - "SourceParentId", - "DestinationParentId" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The unique identifier (ID) of the account that you want to move.

The regex pattern for an account ID string requires exactly 12 digits.

" - }, - "SourceParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) of the root or organizational unit that you want to move the account from.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "DestinationParentId":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) of the root or organizational unit that you want to move the account to.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - } - } - }, - "NextToken":{"type":"string"}, - "Organization":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"OrganizationId", - "documentation":"

The unique identifier (ID) of an organization.

The regex pattern for an organization ID string requires \"o-\" followed by from 10 to 32 lower-case letters or digits.

" - }, - "Arn":{ - "shape":"OrganizationArn", - "documentation":"

The Amazon Resource Name (ARN) of an organization.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "FeatureSet":{ - "shape":"OrganizationFeatureSet", - "documentation":"

Specifies the functionality that currently is available to the organization. If set to \"ALL\", then all features are enabled and policies can be applied to accounts in the organization. If set to \"CONSOLIDATED_BILLING\", then only consolidated billing functionality is available. For more information, see Enabling All Features in Your Organization in the AWS Organizations User Guide.

" - }, - "MasterAccountArn":{ - "shape":"AccountArn", - "documentation":"

The Amazon Resource Name (ARN) of the account that is designated as the master account for the organization.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "MasterAccountId":{ - "shape":"AccountId", - "documentation":"

The unique identifier (ID) of the master account of an organization.

The regex pattern for an account ID string requires exactly 12 digits.

" - }, - "MasterAccountEmail":{ - "shape":"Email", - "documentation":"

The email address that is associated with the AWS account that is designated as the master account for the organization.

" - }, - "AvailablePolicyTypes":{ - "shape":"PolicyTypes", - "documentation":"

A list of policy types that are enabled for this organization. For example, if your organization has all features enabled, then service control policies (SCPs) are included in the list.

Even if a policy type is shown as available in the organization, you can separately enable and disable them at the root level by using EnablePolicyType and DisablePolicyType. Use ListRoots to see the status of a policy type in that root.

" - } - }, - "documentation":"

Contains details about an organization. An organization is a collection of accounts that are centrally managed together using consolidated billing, organized hierarchically with organizational units (OUs), and controlled with policies .

" - }, - "OrganizationArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::\\d{12}:organization\\/o-[a-z0-9]{10,32}" - }, - "OrganizationFeatureSet":{ - "type":"string", - "enum":[ - "ALL", - "CONSOLIDATED_BILLING" - ] - }, - "OrganizationId":{ - "type":"string", - "pattern":"^o-[a-z0-9]{10,32}$" - }, - "OrganizationNotEmptyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The organization isn't empty. To delete an organization, you must first remove all accounts except the master account, delete all organizational units (OUs), and delete all policies.

", - "exception":true - }, - "OrganizationalUnit":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"OrganizationalUnitId", - "documentation":"

The unique identifier (ID) associated with this OU.

The regex pattern for an organizational unit ID string requires \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Arn":{ - "shape":"OrganizationalUnitArn", - "documentation":"

The Amazon Resource Name (ARN) of this OU.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Name":{ - "shape":"OrganizationalUnitName", - "documentation":"

The friendly name of this OU.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - } - }, - "documentation":"

Contains details about an organizational unit (OU). An OU is a container of AWS accounts within a root of an organization. Policies that are attached to an OU apply to all accounts contained in that OU and in any child OUs.

" - }, - "OrganizationalUnitArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::\\d{12}:ou\\/o-[a-z0-9]{10,32}\\/ou-[0-9a-z]{4,32}-[0-9a-z]{8,32}" - }, - "OrganizationalUnitId":{ - "type":"string", - "pattern":"^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$" - }, - "OrganizationalUnitName":{ - "type":"string", - "max":128, - "min":1 - }, - "OrganizationalUnitNotEmptyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified organizational unit (OU) is not empty. Move all accounts to another root or to other OUs, remove all child OUs, and then try the operation again.

", - "exception":true - }, - "OrganizationalUnitNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find an organizational unit (OU) with the OrganizationalUnitId that you specified.

", - "exception":true - }, - "OrganizationalUnits":{ - "type":"list", - "member":{"shape":"OrganizationalUnit"} - }, - "Parent":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ParentId", - "documentation":"

The unique identifier (ID) of the parent entity.

The regex pattern for a parent ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Type":{ - "shape":"ParentType", - "documentation":"

The type of the parent entity.

" - } - }, - "documentation":"

Contains information about either a root or an organizational unit (OU) that can contain OUs or accounts in an organization.

" - }, - "ParentId":{ - "type":"string", - "pattern":"^(r-[0-9a-z]{4,32})|(ou-[0-9a-z]{4,32}-[a-z0-9]{8,32})$" - }, - "ParentNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a root or organizational unit (OU) with the ParentId that you specified.

", - "exception":true - }, - "ParentType":{ - "type":"string", - "enum":[ - "ROOT", - "ORGANIZATIONAL_UNIT" - ] - }, - "Parents":{ - "type":"list", - "member":{"shape":"Parent"} - }, - "Policies":{ - "type":"list", - "member":{"shape":"PolicySummary"} - }, - "Policy":{ - "type":"structure", - "members":{ - "PolicySummary":{ - "shape":"PolicySummary", - "documentation":"

A structure that contains additional details about the policy.

" - }, - "Content":{ - "shape":"PolicyContent", - "documentation":"

The text content of the policy.

" - } - }, - "documentation":"

Contains rules to be applied to the affected accounts. Policies can be attached directly to accounts, or to roots and OUs to affect all accounts in those hierarchies.

" - }, - "PolicyArn":{ - "type":"string", - "pattern":"^(arn:aws:organizations::\\d{12}:policy\\/o-[a-z0-9]{10,32}\\/[0-9a-z_]+\\/p-[0-9a-z]{10,32})|(arn:aws:organizations::aws:policy\\/[0-9a-z_]+\\/p-[0-9a-zA-Z_]{10,128})" - }, - "PolicyContent":{ - "type":"string", - "max":1000000, - "min":1 - }, - "PolicyDescription":{ - "type":"string", - "max":512 - }, - "PolicyId":{ - "type":"string", - "pattern":"^p-[0-9a-zA-Z_]{8,128}$" - }, - "PolicyInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The policy is attached to one or more entities. You must detach it from all roots, organizational units (OUs), and accounts before performing this operation.

", - "exception":true - }, - "PolicyName":{ - "type":"string", - "max":128, - "min":1 - }, - "PolicyNotAttachedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The policy isn't attached to the specified target in the specified root.

", - "exception":true - }, - "PolicyNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a policy with the PolicyId that you specified.

", - "exception":true - }, - "PolicySummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - }, - "Arn":{ - "shape":"PolicyArn", - "documentation":"

The Amazon Resource Name (ARN) of the policy.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Name":{ - "shape":"PolicyName", - "documentation":"

The friendly name of the policy.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

The description of the policy.

" - }, - "Type":{ - "shape":"PolicyType", - "documentation":"

The type of policy.

" - }, - "AwsManaged":{ - "shape":"AwsManagedPolicy", - "documentation":"

A boolean value that indicates whether the specified policy is an AWS managed policy. If true, then you can attach the policy to roots, OUs, or accounts, but you cannot edit it.

" - } - }, - "documentation":"

Contains information about a policy, but does not include the content. To see the content of a policy, see DescribePolicy.

" - }, - "PolicyTargetId":{ - "type":"string", - "pattern":"^(r-[0-9a-z]{4,32})|(\\d{12})|(ou-[0-9a-z]{4,32}-[a-z0-9]{8,32})$" - }, - "PolicyTargetSummary":{ - "type":"structure", - "members":{ - "TargetId":{ - "shape":"PolicyTargetId", - "documentation":"

The unique identifier (ID) of the policy target.

The regex pattern for a target ID string requires one of the following:

  • Root: a string that begins with \"r-\" followed by from 4 to 32 lower-case letters or digits.

  • Account: a string that consists of exactly 12 digits.

  • Organizational unit (OU): a string that begins with \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Arn":{ - "shape":"GenericArn", - "documentation":"

The Amazon Resource Name (ARN) of the policy target.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Name":{ - "shape":"TargetName", - "documentation":"

The friendly name of the policy target.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "Type":{ - "shape":"TargetType", - "documentation":"

The type of the policy target.

" - } - }, - "documentation":"

Contains information about a root, OU, or account that a policy is attached to.

" - }, - "PolicyTargets":{ - "type":"list", - "member":{"shape":"PolicyTargetSummary"} - }, - "PolicyType":{ - "type":"string", - "enum":["SERVICE_CONTROL_POLICY"] - }, - "PolicyTypeAlreadyEnabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified policy type is already enabled in the specified root.

", - "exception":true - }, - "PolicyTypeNotAvailableForOrganizationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

You can't use the specified policy type with the feature set currently enabled for this organization. For example, you can enable service control policies (SCPs) only after you enable all features in the organization. For more information, see Enabling and Disabling a Policy Type on a Root in the AWS Organizations User Guide.

", - "exception":true - }, - "PolicyTypeNotEnabledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified policy type is not currently enabled in this root. You cannot attach policies of the specified type to entities in a root until you enable that type in the root. For more information, see Enabling All Features in Your Organization in the AWS Organizations User Guide.

", - "exception":true - }, - "PolicyTypeStatus":{ - "type":"string", - "enum":[ - "ENABLED", - "PENDING_ENABLE", - "PENDING_DISABLE" - ] - }, - "PolicyTypeSummary":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"PolicyType", - "documentation":"

The name of the policy type.

" - }, - "Status":{ - "shape":"PolicyTypeStatus", - "documentation":"

The status of the policy type as it relates to the associated root. To attach a policy of the specified type to a root or to an OU or account in that root, it must be available in the organization and enabled for that root.

" - } - }, - "documentation":"

Contains information about a policy type and its status in the associated root.

" - }, - "PolicyTypes":{ - "type":"list", - "member":{"shape":"PolicyTypeSummary"} - }, - "RemoveAccountFromOrganizationRequest":{ - "type":"structure", - "required":["AccountId"], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The unique identifier (ID) of the member account that you want to remove from the organization.

The regex pattern for an account ID string requires exactly 12 digits.

" - } - } - }, - "RoleName":{ - "type":"string", - "pattern":"[\\w+=,.@-]{1,64}" - }, - "Root":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"RootId", - "documentation":"

The unique identifier (ID) for the root.

The regex pattern for a root ID string requires \"r-\" followed by from 4 to 32 lower-case letters or digits.

" - }, - "Arn":{ - "shape":"RootArn", - "documentation":"

The Amazon Resource Name (ARN) of the root.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the AWS Organizations User Guide.

" - }, - "Name":{ - "shape":"RootName", - "documentation":"

The friendly name of the root.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "PolicyTypes":{ - "shape":"PolicyTypes", - "documentation":"

The types of policies that are currently enabled for the root and therefore can be attached to the root or to its OUs or accounts.

Even if a policy type is shown as available in the organization, you can separately enable and disable them at the root level by using EnablePolicyType and DisablePolicyType. Use DescribeOrganization to see the availability of the policy types in that organization.

" - } - }, - "documentation":"

Contains details about a root. A root is a top-level parent node in the hierarchy of an organization that can contain organizational units (OUs) and accounts. Every root contains every AWS account in the organization. Each root enables the accounts to be organized in a different way and to have different policy types enabled for use in that root.

" - }, - "RootArn":{ - "type":"string", - "pattern":"^arn:aws:organizations::\\d{12}:root\\/o-[a-z0-9]{10,32}\\/r-[0-9a-z]{4,32}" - }, - "RootId":{ - "type":"string", - "pattern":"^r-[0-9a-z]{4,32}$" - }, - "RootName":{ - "type":"string", - "max":128, - "min":1 - }, - "RootNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a root with the RootId that you specified.

", - "exception":true - }, - "Roots":{ - "type":"list", - "member":{"shape":"Root"} - }, - "ServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

AWS Organizations can't complete your request because of an internal service error. Try again later.

", - "exception":true - }, - "ServicePrincipal":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+=,.@-]*" - }, - "SourceParentNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a source root or OU with the ParentId that you specified.

", - "exception":true - }, - "TargetName":{ - "type":"string", - "max":128, - "min":1 - }, - "TargetNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

We can't find a root, OU, or account with the TargetId that you specified.

", - "exception":true - }, - "TargetType":{ - "type":"string", - "enum":[ - "ACCOUNT", - "ORGANIZATIONAL_UNIT", - "ROOT" - ] - }, - "Timestamp":{"type":"timestamp"}, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "Type":{"shape":"ExceptionType"}, - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

You've sent too many requests in too short a period of time. The limit helps protect against denial-of-service attacks. Try again later.

", - "exception":true - }, - "UpdateOrganizationalUnitRequest":{ - "type":"structure", - "required":["OrganizationalUnitId"], - "members":{ - "OrganizationalUnitId":{ - "shape":"OrganizationalUnitId", - "documentation":"

The unique identifier (ID) of the OU that you want to rename. You can get the ID from the ListOrganizationalUnitsForParent operation.

The regex pattern for an organizational unit ID string requires \"ou-\" followed by from 4 to 32 lower-case letters or digits (the ID of the root that contains the OU) followed by a second \"-\" dash and from 8 to 32 additional lower-case letters or digits.

" - }, - "Name":{ - "shape":"OrganizationalUnitName", - "documentation":"

The new name that you want to assign to the OU.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - } - } - }, - "UpdateOrganizationalUnitResponse":{ - "type":"structure", - "members":{ - "OrganizationalUnit":{ - "shape":"OrganizationalUnit", - "documentation":"

A structure that contains the details about the specified OU, including its new name.

" - } - } - }, - "UpdatePolicyRequest":{ - "type":"structure", - "required":["PolicyId"], - "members":{ - "PolicyId":{ - "shape":"PolicyId", - "documentation":"

The unique identifier (ID) of the policy that you want to update.

The regex pattern for a policy ID string requires \"p-\" followed by from 8 to 128 lower-case letters or digits.

" - }, - "Name":{ - "shape":"PolicyName", - "documentation":"

If provided, the new name for the policy.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

" - }, - "Description":{ - "shape":"PolicyDescription", - "documentation":"

If provided, the new description for the policy.

" - }, - "Content":{ - "shape":"PolicyContent", - "documentation":"

If provided, the new content for the policy. The text must be correctly formatted JSON that complies with the syntax for the policy's type. For more information, see Service Control Policy Syntax in the AWS Organizations User Guide.

" - } - } - }, - "UpdatePolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

A structure that contains details about the updated policy, showing the requested changes.

" - } - } - } - }, - "documentation":"AWS Organizations API Reference

AWS Organizations is a web service that enables you to consolidate your multiple AWS accounts into an organization and centrally manage your accounts and their resources.

This guide provides descriptions of the Organizations API. For more information about using this service, see the AWS Organizations User Guide.

API Version

This version of the Organizations API Reference documents the Organizations API version 2016-11-28.

As an alternative to using the API directly, you can use one of the AWS SDKs, which consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .NET, iOS, Android, and more). The SDKs provide a convenient way to create programmatic access to AWS Organizations. For example, the SDKs take care of cryptographically signing requests, managing errors, and retrying requests automatically. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.

We recommend that you use the AWS SDKs to make programmatic API calls to Organizations. However, you also can use the Organizations Query API to make direct calls to the Organizations web service. To learn more about the Organizations Query API, see Making Query Requests in the AWS Organizations User Guide. Organizations supports GET and POST requests for all actions. That is, the API does not require you to use GET for some actions and POST for others. However, GET requests are subject to the limitation size of a URL. Therefore, for operations that require larger sizes, use a POST request.

Signing Requests

When you send HTTP requests to AWS, you must sign the requests so that AWS can identify who sent them. You sign requests with your AWS access key, which consists of an access key ID and a secret access key. We strongly recommend that you do not create an access key for your root account. Anyone who has the access key for your root account has unrestricted access to all the resources in your account. Instead, create an access key for an IAM user account that has administrative privileges. As another option, use AWS Security Token Service to generate temporary security credentials, and use those credentials to sign requests.

To sign requests, we recommend that you use Signature Version 4. If you have an existing application that uses Signature Version 2, you do not have to update it to use Signature Version 4. However, some operations now require Signature Version 4. The documentation for operations that require version 4 indicate this requirement.

When you use the AWS Command Line Interface (AWS CLI) or one of the AWS SDKs to make requests to AWS, these tools automatically sign the requests for you with the access key that you specify when you configure the tools.

In this release, each organization can have only one root. In a future release, a single organization will support multiple roots.

Support and Feedback for AWS Organizations

We welcome your feedback. Send your comments to feedback-awsorganizations@amazon.com or post your feedback and questions in the AWS Organizations support forum. For more information about the AWS support forums, see Forums Help.

Endpoint to Call When Using the CLI or the AWS API

For the current release of Organizations, you must specify the us-east-1 region for all AWS API and CLI calls. You can do this in the CLI by using these parameters and commands:

  • Use the following parameter with each command to specify both the endpoint and its region:

    --endpoint-url https://organizations.us-east-1.amazonaws.com

  • Use the default endpoint, but configure your default region with this command:

    aws configure set default.region us-east-1

  • Use the following parameter with each command to specify the endpoint:

    --region us-east-1

For the various SDKs used to call the APIs, see the documentation for the SDK of interest to learn how to direct the requests to a specific endpoint. For more information, see Regions and Endpoints in the AWS General Reference.

How examples are presented

The JSON returned by the AWS Organizations service as response to your requests is returned as a single long string without line breaks or formatting whitespace. Both line breaks and whitespace are included in the examples in this guide to improve readability. When example input parameters also would result in long strings that would extend beyond the screen, we insert line breaks to enhance readability. You should always submit the input as a single JSON text string.

Recording API Requests

AWS Organizations supports AWS CloudTrail, a service that records AWS API calls for your AWS account and delivers log files to an Amazon S3 bucket. By using information collected by AWS CloudTrail, you can determine which requests were successfully made to Organizations, who made the request, when it was made, and so on. For more about AWS Organizations and its support for AWS CloudTrail, see Logging AWS Organizations Events with AWS CloudTrail in the AWS Organizations User Guide. To learn more about CloudTrail, including how to turn it on and find your log files, see the AWS CloudTrail User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/service-2.json deleted file mode 100644 index 3253917f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pi/2018-02-27/service-2.json +++ /dev/null @@ -1,401 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2018-02-27", - "endpointPrefix":"pi", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWS PI", - "serviceFullName":"AWS Performance Insights", - "serviceId":"PI", - "signatureVersion":"v4", - "signingName":"pi", - "targetPrefix":"PerformanceInsightsv20180227", - "uid":"pi-2018-02-27" - }, - "operations":{ - "DescribeDimensionKeys":{ - "name":"DescribeDimensionKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDimensionKeysRequest"}, - "output":{"shape":"DescribeDimensionKeysResponse"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"InternalServiceError"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

For a specific time period, retrieve the top N dimension keys for a metric.

" - }, - "GetResourceMetrics":{ - "name":"GetResourceMetrics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetResourceMetricsRequest"}, - "output":{"shape":"GetResourceMetricsResponse"}, - "errors":[ - {"shape":"InvalidArgumentException"}, - {"shape":"InternalServiceError"}, - {"shape":"NotAuthorizedException"} - ], - "documentation":"

Retrieve Performance Insights metrics for a set of data sources, over a time period. You can provide specific dimension groups and dimensions, and provide aggregation and filtering criteria for each group.

" - } - }, - "shapes":{ - "DataPoint":{ - "type":"structure", - "required":[ - "Timestamp", - "Value" - ], - "members":{ - "Timestamp":{ - "shape":"ISOTimestamp", - "documentation":"

The time, in epoch format, associated with a particular Value.

" - }, - "Value":{ - "shape":"Double", - "documentation":"

The actual value associated with a particular Timestamp.

" - } - }, - "documentation":"

A timestamp, and a single numerical value, which together represent a measurement at a particular point in time.

" - }, - "DataPointsList":{ - "type":"list", - "member":{"shape":"DataPoint"} - }, - "DescribeDimensionKeysRequest":{ - "type":"structure", - "required":[ - "ServiceType", - "Identifier", - "StartTime", - "EndTime", - "Metric", - "GroupBy" - ], - "members":{ - "ServiceType":{ - "shape":"ServiceType", - "documentation":"

The AWS service for which Performance Insights will return metrics. The only valid value for ServiceType is: RDS

" - }, - "Identifier":{ - "shape":"String", - "documentation":"

An immutable, AWS Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use an Amazon RDS instance as a data source, you specify its DbiResourceId value - for example: db-FAIHNTYBKTGAUSUZQYPDS2GW4A

" - }, - "StartTime":{ - "shape":"ISOTimestamp", - "documentation":"

The date and time specifying the beginning of the requested time series data. You can't specify a StartTime that's earlier than 7 days ago. The value specified is inclusive - data points equal to or greater than StartTime will be returned.

The value for StartTime must be earlier than the value for EndTime.

" - }, - "EndTime":{ - "shape":"ISOTimestamp", - "documentation":"

The date and time specifying the end of the requested time series data. The value specified is exclusive - data points less than (but not equal to) EndTime will be returned.

The value for EndTime must be later than the value for StartTime.

" - }, - "Metric":{ - "shape":"String", - "documentation":"

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

  • db.load.avg - a scaled representation of the number of active sessions for the database engine.

  • db.sampledload.avg - the raw number of active sessions for the database engine.

" - }, - "PeriodInSeconds":{ - "shape":"Integer", - "documentation":"

The granularity, in seconds, of the data points returned from Performance Insights. A period can be as short as one second, or as long as one day (86400 seconds). Valid values are:

  • 1 (one second)

  • 60 (one minute)

  • 300 (five minutes)

  • 3600 (one hour)

  • 86400 (twenty-four hours)

If you don't specify PeriodInSeconds, then Performance Insights will choose a value for you, with a goal of returning roughly 100-200 data points in the response.

" - }, - "GroupBy":{ - "shape":"DimensionGroup", - "documentation":"

A specification for how to aggregate the data points from a query result. You must specify a valid dimension group. Performance Insights will return all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.

" - }, - "PartitionBy":{ - "shape":"DimensionGroup", - "documentation":"

For each dimension specified in GroupBy, specify a secondary dimension to further subdivide the partition keys in the response.

" - }, - "Filter":{ - "shape":"MetricQueryFilterMap", - "documentation":"

One or more filters to apply in the request. Restrictions:

  • Any number of filters by the same dimension, as specified in the GroupBy or Partition parameters.

  • A single filter for any other dimension in this dimension group.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return in the response. If more items exist than the specified MaxRecords value, a pagination token is included in the response so that the remaining results can be retrieved.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeDimensionKeysResponse":{ - "type":"structure", - "members":{ - "AlignedStartTime":{ - "shape":"ISOTimestamp", - "documentation":"

The start time for the returned dimension keys, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedStartTime will be less than or equal to the value of the user-specified StartTime.

" - }, - "AlignedEndTime":{ - "shape":"ISOTimestamp", - "documentation":"

The end time for the returned dimension keys, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedEndTime will be greater than or equal to the value of the user-specified Endtime.

" - }, - "PartitionKeys":{ - "shape":"ResponsePartitionKeyList", - "documentation":"

If PartitionBy was present in the request, PartitionKeys contains the breakdown of dimension keys by the specified partitions.

" - }, - "Keys":{ - "shape":"DimensionKeyDescriptionList", - "documentation":"

The dimension keys that were requested.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords.

" - } - } - }, - "DimensionGroup":{ - "type":"structure", - "required":["Group"], - "members":{ - "Group":{ - "shape":"String", - "documentation":"

The name of the dimension group. Valid values are:

  • db.user

  • db.host

  • db.sql

  • db.sql_tokenized

  • db.wait_event

  • db.wait_event_type

" - }, - "Dimensions":{ - "shape":"StringList", - "documentation":"

A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.

Valid values for elements in the Dimensions array are:

  • db.user.id

  • db.user.name

  • db.host.id

  • db.host.name

  • db.sql.id

  • db.sql.db_id

  • db.sql.statement

  • db.sql.tokenized_id

  • db.sql_tokenized.id

  • db.sql_tokenized.db_id

  • db.sql_tokenized.statement

  • db.wait_event.name

  • db.wait_event.type

  • db.wait_event_type.name

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of items to fetch for this dimension group.

" - } - }, - "documentation":"

A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql dimension group consists of the following dimensions: db.sql.id, db.sql.db_id, db.sql.statement, and db.sql.tokenized_id.

" - }, - "DimensionKeyDescription":{ - "type":"structure", - "members":{ - "Dimensions":{ - "shape":"DimensionMap", - "documentation":"

A map of name-value pairs for the dimensions in the group.

" - }, - "Total":{ - "shape":"Double", - "documentation":"

The aggregated metric value for the dimension(s), over the requested time range.

" - }, - "Partitions":{ - "shape":"MetricValuesList", - "documentation":"

If PartitionBy was specified, PartitionKeys contains the dimensions that were.

" - } - }, - "documentation":"

An array of descriptions and aggregated values for each dimension within a dimension group.

" - }, - "DimensionKeyDescriptionList":{ - "type":"list", - "member":{"shape":"DimensionKeyDescription"} - }, - "DimensionMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "Double":{"type":"double"}, - "GetResourceMetricsRequest":{ - "type":"structure", - "required":[ - "ServiceType", - "Identifier", - "MetricQueries", - "StartTime", - "EndTime" - ], - "members":{ - "ServiceType":{ - "shape":"ServiceType", - "documentation":"

The AWS service for which Performance Insights will return metrics. The only valid value for ServiceType is: RDS

" - }, - "Identifier":{ - "shape":"String", - "documentation":"

An immutable, AWS Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use an Amazon RDS instance as a data source, you specify its DbiResourceId value - for example: db-FAIHNTYBKTGAUSUZQYPDS2GW4A

" - }, - "MetricQueries":{ - "shape":"MetricQueryList", - "documentation":"

An array of one or more queries to perform. Each query must specify a Performance Insights metric, and can optionally specify aggregation and filtering criteria.

" - }, - "StartTime":{ - "shape":"ISOTimestamp", - "documentation":"

The date and time specifying the beginning of the requested time series data. You can't specify a StartTime that's earlier than 7 days ago. The value specified is inclusive - data points equal to or greater than StartTime will be returned.

The value for StartTime must be earlier than the value for EndTime.

" - }, - "EndTime":{ - "shape":"ISOTimestamp", - "documentation":"

The date and time specifiying the end of the requested time series data. The value specified is exclusive - data points less than (but not equal to) EndTime will be returned.

The value for EndTime must be later than the value for StartTime.

" - }, - "PeriodInSeconds":{ - "shape":"Integer", - "documentation":"

The granularity, in seconds, of the data points returned from Performance Insights. A period can be as short as one second, or as long as one day (86400 seconds). Valid values are:

  • 1 (one second)

  • 60 (one minute)

  • 300 (five minutes)

  • 3600 (one hour)

  • 86400 (twenty-four hours)

If you don't specify PeriodInSeconds, then Performance Insights will choose a value for you, with a goal of returning roughly 100-200 data points in the response.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return in the response. If more items exist than the specified MaxRecords value, a pagination token is included in the response so that the remaining results can be retrieved.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords.

" - } - } - }, - "GetResourceMetricsResponse":{ - "type":"structure", - "members":{ - "AlignedStartTime":{ - "shape":"ISOTimestamp", - "documentation":"

The start time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedStartTime will be less than or equal to the value of the user-specified StartTime.

" - }, - "AlignedEndTime":{ - "shape":"ISOTimestamp", - "documentation":"

The end time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedEndTime will be greater than or equal to the value of the user-specified Endtime.

" - }, - "Identifier":{ - "shape":"String", - "documentation":"

An immutable, AWS Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use an Amazon RDS instance as a data source, you specify its DbiResourceId value - for example: db-FAIHNTYBKTGAUSUZQYPDS2GW4A

" - }, - "MetricList":{ - "shape":"MetricKeyDataPointsList", - "documentation":"

An array of metric results,, where each array element contains all of the data points for a particular dimension.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords.

" - } - } - }, - "ISOTimestamp":{"type":"timestamp"}, - "Integer":{"type":"integer"}, - "InternalServiceError":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The request failed due to an unknown error.

", - "exception":true, - "fault":true - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

One of the arguments provided is invalid for this request.

", - "exception":true - }, - "Limit":{ - "type":"integer", - "max":10, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "max":20, - "min":0 - }, - "MetricKeyDataPoints":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"ResponseResourceMetricKey", - "documentation":"

The dimension(s) to which the data points apply.

" - }, - "DataPoints":{ - "shape":"DataPointsList", - "documentation":"

An array of timestamp-value pairs, representing measurements over a period of time.

" - } - }, - "documentation":"

A time-ordered series of data points, correpsonding to a dimension of a Performance Insights metric.

" - }, - "MetricKeyDataPointsList":{ - "type":"list", - "member":{"shape":"MetricKeyDataPoints"} - }, - "MetricQuery":{ - "type":"structure", - "required":["Metric"], - "members":{ - "Metric":{ - "shape":"String", - "documentation":"

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

  • db.load.avg - a scaled representation of the number of active sessions for the database engine.

  • db.sampledload.avg - the raw number of active sessions for the database engine.

" - }, - "GroupBy":{ - "shape":"DimensionGroup", - "documentation":"

A specification for how to aggregate the data points from a query result. You must specify a valid dimension group. Performance Insights will return all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.

" - }, - "Filter":{ - "shape":"MetricQueryFilterMap", - "documentation":"

One or more filters to apply in the request. Restrictions:

  • Any number of filters by the same dimension, as specified in the GroupBy parameter.

  • A single filter for any other dimension in this dimension group.

" - } - }, - "documentation":"

A single query to be processed. You must provide the metric to query. If no other parameters are specified, Performance Insights returns all of the data points for that metric. You can optionally request that the data points be aggregated by dimension group ( GroupBy), and return only those data points that match your criteria (Filter).

" - }, - "MetricQueryFilterMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "MetricQueryList":{ - "type":"list", - "member":{"shape":"MetricQuery"}, - "max":15, - "min":1 - }, - "MetricValuesList":{ - "type":"list", - "member":{"shape":"Double"} - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The user is not authorized to perform this request.

", - "exception":true - }, - "ResponsePartitionKey":{ - "type":"structure", - "required":["Dimensions"], - "members":{ - "Dimensions":{ - "shape":"DimensionMap", - "documentation":"

A dimension map that contains the dimension(s) for this partition.

" - } - }, - "documentation":"

If PartitionBy was specified in a DescribeDimensionKeys request, the dimensions are returned in an array. Each element in the array specifies one dimension.

" - }, - "ResponsePartitionKeyList":{ - "type":"list", - "member":{"shape":"ResponsePartitionKey"} - }, - "ResponseResourceMetricKey":{ - "type":"structure", - "required":["Metric"], - "members":{ - "Metric":{ - "shape":"String", - "documentation":"

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

  • db.load.avg - a scaled representation of the number of active sessions for the database engine.

  • db.sampledload.avg - the raw number of active sessions for the database engine.

" - }, - "Dimensions":{ - "shape":"DimensionMap", - "documentation":"

The valid dimensions for the metric.

" - } - }, - "documentation":"

An object describing a Performance Insights metric and one or more dimensions for that metric.

" - }, - "ServiceType":{ - "type":"string", - "enum":["RDS"] - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"}, - "max":10, - "min":1 - } - }, - "documentation":"

AWS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running RDS instance. The guide provides detailed information about Performance Insights data types, parameters and errors. For more information about Performance Insights capabilities see Using Amazon RDS Performance Insights in the Amazon RDS User Guide.

The AWS Performance Insights API provides visibility into the performance of your RDS instance, when Performance Insights is enabled for supported engine types. While Amazon CloudWatch provides the authoritative source for AWS service vended monitoring metrics, AWS Performance Insights offers a domain-specific view of database load measured as Average Active Sessions and provided to API consumers as a 2-dimensional time-series dataset. The time dimension of the data provides DB load data for each time point in the queried time range, and each time point decomposes overall load in relation to the requested dimensions, such as SQL, Wait-event, User or Host, measured at that time point.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/service-2.json deleted file mode 100644 index 31192a3c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pinpoint/2016-12-01/service-2.json +++ /dev/null @@ -1,8069 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2016-12-01", - "endpointPrefix" : "pinpoint", - "signingName" : "mobiletargeting", - "serviceFullName" : "Amazon Pinpoint", - "serviceId" : "Pinpoint", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "pinpoint-2016-12-01", - "signatureVersion" : "v4" - }, - "documentation" : "Amazon Pinpoint", - "operations" : { - "CreateApp" : { - "name" : "CreateApp", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateAppRequest" - }, - "output" : { - "shape" : "CreateAppResponse", - "documentation" : "201 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Creates or updates an app." - }, - "CreateCampaign" : { - "name" : "CreateCampaign", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/campaigns", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateCampaignRequest" - }, - "output" : { - "shape" : "CreateCampaignResponse", - "documentation" : "201 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Creates or updates a campaign." - }, - "CreateExportJob" : { - "name" : "CreateExportJob", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/jobs/export", - "responseCode" : 202 - }, - "input" : { - "shape" : "CreateExportJobRequest" - }, - "output" : { - "shape" : "CreateExportJobResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Creates an export job." - }, - "CreateImportJob" : { - "name" : "CreateImportJob", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/jobs/import", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateImportJobRequest" - }, - "output" : { - "shape" : "CreateImportJobResponse", - "documentation" : "201 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Creates or updates an import job." - }, - "CreateSegment" : { - "name" : "CreateSegment", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/segments", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateSegmentRequest" - }, - "output" : { - "shape" : "CreateSegmentResponse", - "documentation" : "201 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to create or update a segment." - }, - "DeleteAdmChannel" : { - "name" : "DeleteAdmChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/adm", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteAdmChannelRequest" - }, - "output" : { - "shape" : "DeleteAdmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an ADM channel." - }, - "DeleteApnsChannel" : { - "name" : "DeleteApnsChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/apns", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteApnsChannelRequest" - }, - "output" : { - "shape" : "DeleteApnsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes the APNs channel for an app." - }, - "DeleteApnsSandboxChannel" : { - "name" : "DeleteApnsSandboxChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/apns_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteApnsSandboxChannelRequest" - }, - "output" : { - "shape" : "DeleteApnsSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an APNS sandbox channel." - }, - "DeleteApnsVoipChannel" : { - "name" : "DeleteApnsVoipChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteApnsVoipChannelRequest" - }, - "output" : { - "shape" : "DeleteApnsVoipChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an APNS VoIP channel" - }, - "DeleteApnsVoipSandboxChannel" : { - "name" : "DeleteApnsVoipSandboxChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteApnsVoipSandboxChannelRequest" - }, - "output" : { - "shape" : "DeleteApnsVoipSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an APNS VoIP sandbox channel" - }, - "DeleteApp" : { - "name" : "DeleteApp", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteAppRequest" - }, - "output" : { - "shape" : "DeleteAppResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes an app." - }, - "DeleteBaiduChannel" : { - "name" : "DeleteBaiduChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/baidu", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteBaiduChannelRequest" - }, - "output" : { - "shape" : "DeleteBaiduChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete a BAIDU GCM channel" - }, - "DeleteCampaign" : { - "name" : "DeleteCampaign", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteCampaignRequest" - }, - "output" : { - "shape" : "DeleteCampaignResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes a campaign." - }, - "DeleteEmailChannel" : { - "name" : "DeleteEmailChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/email", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteEmailChannelRequest" - }, - "output" : { - "shape" : "DeleteEmailChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an email channel." - }, - "DeleteEndpoint" : { - "name" : "DeleteEndpoint", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/endpoints/{endpoint-id}", - "responseCode" : 202 - }, - "input" : { - "shape" : "DeleteEndpointRequest" - }, - "output" : { - "shape" : "DeleteEndpointResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes an endpoint." - }, - "DeleteEventStream" : { - "name" : "DeleteEventStream", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/eventstream", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteEventStreamRequest" - }, - "output" : { - "shape" : "DeleteEventStreamResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes the event stream for an app." - }, - "DeleteGcmChannel" : { - "name" : "DeleteGcmChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/gcm", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteGcmChannelRequest" - }, - "output" : { - "shape" : "DeleteGcmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes the GCM channel for an app." - }, - "DeleteSegment" : { - "name" : "DeleteSegment", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteSegmentRequest" - }, - "output" : { - "shape" : "DeleteSegmentResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes a segment." - }, - "DeleteSmsChannel" : { - "name" : "DeleteSmsChannel", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/channels/sms", - "responseCode" : 200 - }, - "input" : { - "shape" : "DeleteSmsChannelRequest" - }, - "output" : { - "shape" : "DeleteSmsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Delete an SMS channel." - }, - "DeleteUserEndpoints" : { - "name" : "DeleteUserEndpoints", - "http" : { - "method" : "DELETE", - "requestUri" : "/v1/apps/{application-id}/users/{user-id}", - "responseCode" : 202 - }, - "input" : { - "shape" : "DeleteUserEndpointsRequest" - }, - "output" : { - "shape" : "DeleteUserEndpointsResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Deletes endpoints that are associated with a User ID." - }, - "GetAdmChannel" : { - "name" : "GetAdmChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/adm", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetAdmChannelRequest" - }, - "output" : { - "shape" : "GetAdmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an ADM channel." - }, - "GetApnsChannel" : { - "name" : "GetApnsChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/apns", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApnsChannelRequest" - }, - "output" : { - "shape" : "GetApnsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about the APNs channel for an app." - }, - "GetApnsSandboxChannel" : { - "name" : "GetApnsSandboxChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/apns_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApnsSandboxChannelRequest" - }, - "output" : { - "shape" : "GetApnsSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an APNS sandbox channel." - }, - "GetApnsVoipChannel" : { - "name" : "GetApnsVoipChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApnsVoipChannelRequest" - }, - "output" : { - "shape" : "GetApnsVoipChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an APNS VoIP channel" - }, - "GetApnsVoipSandboxChannel" : { - "name" : "GetApnsVoipSandboxChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApnsVoipSandboxChannelRequest" - }, - "output" : { - "shape" : "GetApnsVoipSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an APNS VoIPSandbox channel" - }, - "GetApp" : { - "name" : "GetApp", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetAppRequest" - }, - "output" : { - "shape" : "GetAppResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about an app." - }, - "GetApplicationSettings" : { - "name" : "GetApplicationSettings", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/settings", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApplicationSettingsRequest" - }, - "output" : { - "shape" : "GetApplicationSettingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to request the settings for an app." - }, - "GetApps" : { - "name" : "GetApps", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetAppsRequest" - }, - "output" : { - "shape" : "GetAppsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your apps." - }, - "GetBaiduChannel" : { - "name" : "GetBaiduChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/baidu", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetBaiduChannelRequest" - }, - "output" : { - "shape" : "GetBaiduChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get a BAIDU GCM channel" - }, - "GetCampaign" : { - "name" : "GetCampaign", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCampaignRequest" - }, - "output" : { - "shape" : "GetCampaignResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about a campaign." - }, - "GetCampaignActivities" : { - "name" : "GetCampaignActivities", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}/activities", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCampaignActivitiesRequest" - }, - "output" : { - "shape" : "GetCampaignActivitiesResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about the activity performed by a campaign." - }, - "GetCampaignVersion" : { - "name" : "GetCampaignVersion", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}/versions/{version}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCampaignVersionRequest" - }, - "output" : { - "shape" : "GetCampaignVersionResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about a specific version of a campaign." - }, - "GetCampaignVersions" : { - "name" : "GetCampaignVersions", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCampaignVersionsRequest" - }, - "output" : { - "shape" : "GetCampaignVersionsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your campaign versions." - }, - "GetCampaigns" : { - "name" : "GetCampaigns", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/campaigns", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetCampaignsRequest" - }, - "output" : { - "shape" : "GetCampaignsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your campaigns." - }, - "GetChannels" : { - "name" : "GetChannels", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetChannelsRequest" - }, - "output" : { - "shape" : "GetChannelsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get all channels." - }, - "GetEmailChannel" : { - "name" : "GetEmailChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/email", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetEmailChannelRequest" - }, - "output" : { - "shape" : "GetEmailChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an email channel." - }, - "GetEndpoint" : { - "name" : "GetEndpoint", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/endpoints/{endpoint-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetEndpointRequest" - }, - "output" : { - "shape" : "GetEndpointResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about an endpoint." - }, - "GetEventStream" : { - "name" : "GetEventStream", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/eventstream", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetEventStreamRequest" - }, - "output" : { - "shape" : "GetEventStreamResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns the event stream for an app." - }, - "GetExportJob" : { - "name" : "GetExportJob", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/jobs/export/{job-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetExportJobRequest" - }, - "output" : { - "shape" : "GetExportJobResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about an export job." - }, - "GetExportJobs" : { - "name" : "GetExportJobs", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/jobs/export", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetExportJobsRequest" - }, - "output" : { - "shape" : "GetExportJobsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your export jobs." - }, - "GetGcmChannel" : { - "name" : "GetGcmChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/gcm", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetGcmChannelRequest" - }, - "output" : { - "shape" : "GetGcmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about the GCM channel for an app." - }, - "GetImportJob" : { - "name" : "GetImportJob", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/jobs/import/{job-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetImportJobRequest" - }, - "output" : { - "shape" : "GetImportJobResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about an import job." - }, - "GetImportJobs" : { - "name" : "GetImportJobs", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/jobs/import", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetImportJobsRequest" - }, - "output" : { - "shape" : "GetImportJobsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your import jobs." - }, - "GetSegment" : { - "name" : "GetSegment", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentRequest" - }, - "output" : { - "shape" : "GetSegmentResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about a segment." - }, - "GetSegmentExportJobs" : { - "name" : "GetSegmentExportJobs", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}/jobs/export", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentExportJobsRequest" - }, - "output" : { - "shape" : "GetSegmentExportJobsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns a list of export jobs for a specific segment." - }, - "GetSegmentImportJobs" : { - "name" : "GetSegmentImportJobs", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}/jobs/import", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentImportJobsRequest" - }, - "output" : { - "shape" : "GetSegmentImportJobsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns a list of import jobs for a specific segment." - }, - "GetSegmentVersion" : { - "name" : "GetSegmentVersion", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}/versions/{version}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentVersionRequest" - }, - "output" : { - "shape" : "GetSegmentVersionResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about a segment version." - }, - "GetSegmentVersions" : { - "name" : "GetSegmentVersions", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentVersionsRequest" - }, - "output" : { - "shape" : "GetSegmentVersionsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about your segment versions." - }, - "GetSegments" : { - "name" : "GetSegments", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/segments", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSegmentsRequest" - }, - "output" : { - "shape" : "GetSegmentsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to get information about your segments." - }, - "GetSmsChannel" : { - "name" : "GetSmsChannel", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/channels/sms", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetSmsChannelRequest" - }, - "output" : { - "shape" : "GetSmsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Get an SMS channel." - }, - "GetUserEndpoints" : { - "name" : "GetUserEndpoints", - "http" : { - "method" : "GET", - "requestUri" : "/v1/apps/{application-id}/users/{user-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetUserEndpointsRequest" - }, - "output" : { - "shape" : "GetUserEndpointsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about the endpoints that are associated with a User ID." - }, - "PhoneNumberValidate" : { - "name" : "PhoneNumberValidate", - "http" : { - "method" : "POST", - "requestUri" : "/v1/phone/number/validate", - "responseCode" : 200 - }, - "input" : { - "shape" : "PhoneNumberValidateRequest" - }, - "output" : { - "shape" : "PhoneNumberValidateResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Returns information about the specified phone number." - }, - "PutEventStream" : { - "name" : "PutEventStream", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/eventstream", - "responseCode" : 200 - }, - "input" : { - "shape" : "PutEventStreamRequest" - }, - "output" : { - "shape" : "PutEventStreamResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to create or update the event stream for an app." - }, - "PutEvents" : { - "name" : "PutEvents", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/events", - "responseCode" : 202 - }, - "input" : { - "shape" : "PutEventsRequest" - }, - "output" : { - "shape" : "PutEventsResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to record events for endpoints. This method creates events and creates or updates the endpoints that those events are associated with." - }, - "RemoveAttributes" : { - "name" : "RemoveAttributes", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/attributes/{attribute-type}", - "responseCode" : 200 - }, - "input" : { - "shape" : "RemoveAttributesRequest" - }, - "output" : { - "shape" : "RemoveAttributesResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to remove the attributes for an app" - }, - "SendMessages" : { - "name" : "SendMessages", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/messages", - "responseCode" : 200 - }, - "input" : { - "shape" : "SendMessagesRequest" - }, - "output" : { - "shape" : "SendMessagesResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to send a direct message." - }, - "SendUsersMessages" : { - "name" : "SendUsersMessages", - "http" : { - "method" : "POST", - "requestUri" : "/v1/apps/{application-id}/users-messages", - "responseCode" : 200 - }, - "input" : { - "shape" : "SendUsersMessagesRequest" - }, - "output" : { - "shape" : "SendUsersMessagesResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to send a message to a list of users." - }, - "UpdateAdmChannel" : { - "name" : "UpdateAdmChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/adm", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateAdmChannelRequest" - }, - "output" : { - "shape" : "UpdateAdmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an ADM channel." - }, - "UpdateApnsChannel" : { - "name" : "UpdateApnsChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/apns", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApnsChannelRequest" - }, - "output" : { - "shape" : "UpdateApnsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to update the APNs channel for an app." - }, - "UpdateApnsSandboxChannel" : { - "name" : "UpdateApnsSandboxChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/apns_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApnsSandboxChannelRequest" - }, - "output" : { - "shape" : "UpdateApnsSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an APNS sandbox channel." - }, - "UpdateApnsVoipChannel" : { - "name" : "UpdateApnsVoipChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApnsVoipChannelRequest" - }, - "output" : { - "shape" : "UpdateApnsVoipChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an APNS VoIP channel" - }, - "UpdateApnsVoipSandboxChannel" : { - "name" : "UpdateApnsVoipSandboxChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/apns_voip_sandbox", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApnsVoipSandboxChannelRequest" - }, - "output" : { - "shape" : "UpdateApnsVoipSandboxChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an APNS VoIP sandbox channel" - }, - "UpdateApplicationSettings" : { - "name" : "UpdateApplicationSettings", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/settings", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApplicationSettingsRequest" - }, - "output" : { - "shape" : "UpdateApplicationSettingsResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to update the settings for an app." - }, - "UpdateBaiduChannel" : { - "name" : "UpdateBaiduChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/baidu", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateBaiduChannelRequest" - }, - "output" : { - "shape" : "UpdateBaiduChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update a BAIDU GCM channel" - }, - "UpdateCampaign" : { - "name" : "UpdateCampaign", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/campaigns/{campaign-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateCampaignRequest" - }, - "output" : { - "shape" : "UpdateCampaignResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to update a campaign." - }, - "UpdateEmailChannel" : { - "name" : "UpdateEmailChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/email", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateEmailChannelRequest" - }, - "output" : { - "shape" : "UpdateEmailChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an email channel." - }, - "UpdateEndpoint" : { - "name" : "UpdateEndpoint", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/endpoints/{endpoint-id}", - "responseCode" : 202 - }, - "input" : { - "shape" : "UpdateEndpointRequest" - }, - "output" : { - "shape" : "UpdateEndpointResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Creates or updates an endpoint." - }, - "UpdateEndpointsBatch" : { - "name" : "UpdateEndpointsBatch", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/endpoints", - "responseCode" : 202 - }, - "input" : { - "shape" : "UpdateEndpointsBatchRequest" - }, - "output" : { - "shape" : "UpdateEndpointsBatchResponse", - "documentation" : "202 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to update a batch of endpoints." - }, - "UpdateGcmChannel" : { - "name" : "UpdateGcmChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/gcm", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateGcmChannelRequest" - }, - "output" : { - "shape" : "UpdateGcmChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Use to update the GCM channel for an app." - }, - "UpdateSegment" : { - "name" : "UpdateSegment", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/segments/{segment-id}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateSegmentRequest" - }, - "output" : { - "shape" : "UpdateSegmentResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Used to update a segment." - }, - "UpdateSmsChannel" : { - "name" : "UpdateSmsChannel", - "http" : { - "method" : "PUT", - "requestUri" : "/v1/apps/{application-id}/channels/sms", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateSmsChannelRequest" - }, - "output" : { - "shape" : "UpdateSmsChannelResponse", - "documentation" : "200 response" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "400 response" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "500 response" - }, { - "shape" : "ForbiddenException", - "documentation" : "403 response" - }, { - "shape" : "NotFoundException", - "documentation" : "404 response" - }, { - "shape" : "MethodNotAllowedException", - "documentation" : "405 response" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "429 response" - } ], - "documentation" : "Update an SMS channel." - } - }, - "shapes" : { - "ADMChannelRequest" : { - "type" : "structure", - "members" : { - "ClientId" : { - "shape" : "__string", - "documentation" : "The Client ID that you obtained from the Amazon App Distribution Portal." - }, - "ClientSecret" : { - "shape" : "__string", - "documentation" : "The Client Secret that you obtained from the Amazon App Distribution Portal." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "Indicates whether or not the channel is enabled for sending messages." - } - }, - "documentation" : "Amazon Device Messaging channel definition.", - "required" : [ ] - }, - "ADMChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application to which the channel applies." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date and time when this channel was created." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "Indicates whether or not the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "(Deprecated) An identifier for the channel. Retained for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Indicates whether or not the channel is archived." - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "The user who last updated this channel." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date and time when this channel was last modified." - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. For this channel, the value is always \"ADM.\"" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "The channel version." - } - }, - "documentation" : "Amazon Device Messaging channel definition.", - "required" : [ ] - }, - "ADMMessage" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign: OPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action. DEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app. URL - The default mobile browser on the user's device launches and opens a web page at the URL you specify. Possible values include: OPEN_APP | DEEP_LINK | URL" - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification." - }, - "ConsolidationKey" : { - "shape" : "__string", - "documentation" : "Optional. Arbitrary string used to indicate multiple messages are logically the same and that ADM is allowed to drop previously enqueued messages in favor of this one." - }, - "Data" : { - "shape" : "MapOf__string", - "documentation" : "The data payload used for a silent push. This payload is added to the notifications' data.pinpoint.jsonBody' object" - }, - "ExpiresAfter" : { - "shape" : "__string", - "documentation" : "Optional. Number of seconds ADM should retain the message if the device is offline" - }, - "IconReference" : { - "shape" : "__string", - "documentation" : "The icon image name of the asset saved in your application." - }, - "ImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the large icon to the notification content view." - }, - "ImageUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used in the push notification." - }, - "MD5" : { - "shape" : "__string", - "documentation" : "Optional. Base-64-encoded MD5 checksum of the data parameter. Used to verify data integrity" - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device. Silent pushes can be used for Remote Configuration and Phone Home use cases." - }, - "SmallImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the small icon for the notification which will be used to represent the notification in the status bar and content view" - }, - "Sound" : { - "shape" : "__string", - "documentation" : "Indicates a sound to play when the device receives the notification. Supports default, or the filename of a sound resource bundled in the app. Android sound files must reside in /res/raw/" - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "ADM Message." - }, - "APNSChannelRequest" : { - "type" : "structure", - "members" : { - "BundleId" : { - "shape" : "__string", - "documentation" : "The bundle id used for APNs Tokens." - }, - "Certificate" : { - "shape" : "__string", - "documentation" : "The distribution certificate from Apple." - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "PrivateKey" : { - "shape" : "__string", - "documentation" : "The certificate private key." - }, - "TeamId" : { - "shape" : "__string", - "documentation" : "The team id used for APNs Tokens." - }, - "TokenKey" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - }, - "TokenKeyId" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - } - }, - "documentation" : "Apple Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application that the channel applies to." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date and time when this channel was created." - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "HasTokenKey" : { - "shape" : "__boolean", - "documentation" : "Indicates whether the channel is configured with a key for APNs token authentication. Provide a token key by setting the TokenKey attribute." - }, - "Id" : { - "shape" : "__string", - "documentation" : "(Deprecated) An identifier for the channel. Retained for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Indicates whether or not the channel is archived." - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "The user who last updated this channel." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date and time when this channel was last modified." - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. For this channel, the value is always \"ADM.\"" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "The channel version." - } - }, - "documentation" : "Apple Distribution Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSMessage" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign: OPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action. DEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app. URL - The default mobile browser on the user's device launches and opens a web page at the URL you specify. Possible values include: OPEN_APP | DEEP_LINK | URL" - }, - "Badge" : { - "shape" : "__integer", - "documentation" : "Include this key when you want the system to modify the badge of your app icon. If this key is not included in the dictionary, the badge is not changed. To remove the badge, set the value of this key to 0." - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification." - }, - "Category" : { - "shape" : "__string", - "documentation" : "Provide this key with a string value that represents the notification's type. This value corresponds to the value in the identifier property of one of your app's registered categories." - }, - "CollapseId" : { - "shape" : "__string", - "documentation" : "An ID that, if assigned to multiple messages, causes APNs to coalesce the messages into a single push notification instead of delivering each message individually. The value must not exceed 64 bytes. Amazon Pinpoint uses this value to set the apns-collapse-id request header when it sends the message to APNs." - }, - "Data" : { - "shape" : "MapOf__string", - "documentation" : "The data payload used for a silent push. This payload is added to the notifications' data.pinpoint.jsonBody' object" - }, - "MediaUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to a video used in the push notification." - }, - "PreferredAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The preferred authentication method, either \"CERTIFICATE\" or \"TOKEN\"" - }, - "Priority" : { - "shape" : "__string", - "documentation" : "The message priority. Amazon Pinpoint uses this value to set the apns-priority request header when it sends the message to APNs. Accepts the following values:\n\n\"5\" - Low priority. Messages might be delayed, delivered in groups, and throttled.\n\n\"10\" - High priority. Messages are sent immediately. High priority messages must cause an alert, sound, or badge on the receiving device.\n\nThe default value is \"10\".\n\nThe equivalent values for FCM or GCM messages are \"normal\" and \"high\". Amazon Pinpoint accepts these values for APNs messages and converts them.\n\nFor more information about the apns-priority parameter, see Communicating with APNs in the APNs Local and Remote Notification Programming Guide." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device. Silent pushes can be used for Remote Configuration and Phone Home use cases." - }, - "Sound" : { - "shape" : "__string", - "documentation" : "Include this key when you want the system to play a sound. The value of this key is the name of a sound file in your app's main bundle or in the Library/Sounds folder of your app's data container. If the sound file cannot be found, or if you specify defaultfor the value, the system plays the default alert sound." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - }, - "ThreadId" : { - "shape" : "__string", - "documentation" : "Provide this key with a string value that represents the app-specific identifier for grouping notifications. If you provide a Notification Content app extension, you can use this value to group your notifications together." - }, - "TimeToLive" : { - "shape" : "__integer", - "documentation" : "The length of time (in seconds) that APNs stores and attempts to deliver the message. If the value is 0, APNs does not store the message or attempt to deliver it more than once. Amazon Pinpoint uses this value to set the apns-expiration request header when it sends the message to APNs." - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "APNS Message." - }, - "APNSSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "BundleId" : { - "shape" : "__string", - "documentation" : "The bundle id used for APNs Tokens." - }, - "Certificate" : { - "shape" : "__string", - "documentation" : "The distribution certificate from Apple." - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "PrivateKey" : { - "shape" : "__string", - "documentation" : "The certificate private key." - }, - "TeamId" : { - "shape" : "__string", - "documentation" : "The team id used for APNs Tokens." - }, - "TokenKey" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - }, - "TokenKeyId" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - } - }, - "documentation" : "Apple Development Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application to which the channel applies." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "HasTokenKey" : { - "shape" : "__boolean", - "documentation" : "Indicates whether the channel is configured with a key for APNs token authentication. Provide a token key by setting the TokenKey attribute." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who last updated this entry" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. Will be APNS_SANDBOX." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Apple Development Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSVoipChannelRequest" : { - "type" : "structure", - "members" : { - "BundleId" : { - "shape" : "__string", - "documentation" : "The bundle id used for APNs Tokens." - }, - "Certificate" : { - "shape" : "__string", - "documentation" : "The distribution certificate from Apple." - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "PrivateKey" : { - "shape" : "__string", - "documentation" : "The certificate private key." - }, - "TeamId" : { - "shape" : "__string", - "documentation" : "The team id used for APNs Tokens." - }, - "TokenKey" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - }, - "TokenKeyId" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - } - }, - "documentation" : "Apple VoIP Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSVoipChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "Application id" - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "HasTokenKey" : { - "shape" : "__boolean", - "documentation" : "If the channel is registered with a token key for authentication." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who made the last change" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. Will be APNS." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Apple VoIP Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSVoipSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "BundleId" : { - "shape" : "__string", - "documentation" : "The bundle id used for APNs Tokens." - }, - "Certificate" : { - "shape" : "__string", - "documentation" : "The distribution certificate from Apple." - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "PrivateKey" : { - "shape" : "__string", - "documentation" : "The certificate private key." - }, - "TeamId" : { - "shape" : "__string", - "documentation" : "The team id used for APNs Tokens." - }, - "TokenKey" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - }, - "TokenKeyId" : { - "shape" : "__string", - "documentation" : "The token key used for APNs Tokens." - } - }, - "documentation" : "Apple VoIP Developer Push Notification Service channel definition.", - "required" : [ ] - }, - "APNSVoipSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "Application id" - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "DefaultAuthenticationMethod" : { - "shape" : "__string", - "documentation" : "The default authentication method used for APNs." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "HasTokenKey" : { - "shape" : "__boolean", - "documentation" : "If the channel is registered with a token key for authentication." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who made the last change" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. Will be APNS." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Apple VoIP Developer Push Notification Service channel definition.", - "required" : [ ] - }, - "Action" : { - "type" : "string", - "enum" : [ "OPEN_APP", "DEEP_LINK", "URL" ] - }, - "ActivitiesResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfActivityResponse", - "documentation" : "List of campaign activities" - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The string that you use in a subsequent request to get the next page of results in a paginated response." - } - }, - "documentation" : "Activities for campaign.", - "required" : [ ] - }, - "ActivityResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application to which the campaign applies." - }, - "CampaignId" : { - "shape" : "__string", - "documentation" : "The ID of the campaign to which the activity applies." - }, - "End" : { - "shape" : "__string", - "documentation" : "The actual time the activity was marked CANCELLED or COMPLETED. Provided in ISO 8601 format." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique activity ID." - }, - "Result" : { - "shape" : "__string", - "documentation" : "Indicates whether the activity succeeded.\n\nValid values: SUCCESS, FAIL" - }, - "ScheduledStart" : { - "shape" : "__string", - "documentation" : "The scheduled start time for the activity in ISO 8601 format." - }, - "Start" : { - "shape" : "__string", - "documentation" : "The actual start time of the activity in ISO 8601 format." - }, - "State" : { - "shape" : "__string", - "documentation" : "The state of the activity.\n\nValid values: PENDING, INITIALIZING, RUNNING, PAUSED, CANCELLED, COMPLETED" - }, - "SuccessfulEndpointCount" : { - "shape" : "__integer", - "documentation" : "The total number of endpoints to which the campaign successfully delivered messages." - }, - "TimezonesCompletedCount" : { - "shape" : "__integer", - "documentation" : "The total number of timezones completed." - }, - "TimezonesTotalCount" : { - "shape" : "__integer", - "documentation" : "The total number of unique timezones present in the segment." - }, - "TotalEndpointCount" : { - "shape" : "__integer", - "documentation" : "The total number of endpoints to which the campaign attempts to deliver messages." - }, - "TreatmentId" : { - "shape" : "__string", - "documentation" : "The ID of a variation of the campaign used for A/B testing." - } - }, - "documentation" : "Activity definition", - "required" : [ ] - }, - "AddressConfiguration" : { - "type" : "structure", - "members" : { - "BodyOverride" : { - "shape" : "__string", - "documentation" : "Body override. If specified will override default body." - }, - "ChannelType" : { - "shape" : "ChannelType", - "documentation" : "The channel type.\n\nValid values: GCM | APNS | APNS_SANDBOX | APNS_VOIP | APNS_VOIP_SANDBOX | ADM | SMS | EMAIL | BAIDU" - }, - "Context" : { - "shape" : "MapOf__string", - "documentation" : "A map of custom attributes to attributes to be attached to the message for this address. This payload is added to the push notification's 'data.pinpoint' object or added to the email/sms delivery receipt event attributes." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "A map of substitution values for the message to be merged with the DefaultMessage's substitutions. Substitutions on this map take precedence over the all other substitutions." - }, - "TitleOverride" : { - "shape" : "__string", - "documentation" : "Title override. If specified will override default title if applicable." - } - }, - "documentation" : "Address configuration." - }, - "ApplicationResponse" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "documentation" : "The unique application ID." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The display name of the application." - } - }, - "documentation" : "Application Response.", - "required" : [ ] - }, - "ApplicationSettingsResource" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID for the application." - }, - "CampaignHook" : { - "shape" : "CampaignHook", - "documentation" : "Default campaign hook." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date that the settings were last updated in ISO 8601 format." - }, - "Limits" : { - "shape" : "CampaignLimits", - "documentation" : "The default campaign limits for the app. These limits apply to each campaign for the app, unless the campaign overrides the default with limits of its own." - }, - "QuietTime" : { - "shape" : "QuietTime", - "documentation" : "The default quiet time for the app. Each campaign for this app sends no messages during this time unless the campaign overrides the default with a quiet time of its own." - } - }, - "documentation" : "Application settings.", - "required" : [ ] - }, - "ApplicationsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfApplicationResponse", - "documentation" : "List of applications returned in this page." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The string that you use in a subsequent request to get the next page of results in a paginated response." - } - }, - "documentation" : "Get Applications Result." - }, - "AttributeDimension" : { - "type" : "structure", - "members" : { - "AttributeType" : { - "shape" : "AttributeType", - "documentation" : "The type of dimension:\nINCLUSIVE - Endpoints that match the criteria are included in the segment.\nEXCLUSIVE - Endpoints that match the criteria are excluded from the segment." - }, - "Values" : { - "shape" : "ListOf__string", - "documentation" : "The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type." - } - }, - "documentation" : "Custom attibute dimension", - "required" : [ ] - }, - "AttributeType" : { - "type" : "string", - "enum" : [ "INCLUSIVE", "EXCLUSIVE" ] - }, - "AttributesResource" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID for the application." - }, - "AttributeType" : { - "shape" : "__string", - "documentation" : "The attribute type for the application." - }, - "Attributes" : { - "shape" : "ListOf__string", - "documentation" : "The attributes for the application." - } - }, - "documentation" : "Attributes.", - "required" : [ ] - }, - "BadRequestException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "BaiduChannelRequest" : { - "type" : "structure", - "members" : { - "ApiKey" : { - "shape" : "__string", - "documentation" : "Platform credential API key from Baidu." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "SecretKey" : { - "shape" : "__string", - "documentation" : "Platform credential Secret key from Baidu." - } - }, - "documentation" : "Baidu Cloud Push credentials", - "required" : [ ] - }, - "BaiduChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "Application id" - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "Credential" : { - "shape" : "__string", - "documentation" : "The Baidu API key from Baidu." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who made the last change" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. Will be BAIDU" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Baidu Cloud Messaging channel definition", - "required" : [ ] - }, - "BaiduMessage" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign: OPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action. DEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app. URL - The default mobile browser on the user's device launches and opens a web page at the URL you specify. Possible values include: OPEN_APP | DEEP_LINK | URL" - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification." - }, - "Data" : { - "shape" : "MapOf__string", - "documentation" : "The data payload used for a silent push. This payload is added to the notifications' data.pinpoint.jsonBody' object" - }, - "IconReference" : { - "shape" : "__string", - "documentation" : "The icon image name of the asset saved in your application." - }, - "ImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the large icon to the notification content view." - }, - "ImageUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used in the push notification." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device. Silent pushes can be used for Remote Configuration and Phone Home use cases." - }, - "SmallImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the small icon for the notification which will be used to represent the notification in the status bar and content view" - }, - "Sound" : { - "shape" : "__string", - "documentation" : "Indicates a sound to play when the device receives the notification. Supports default, or the filename of a sound resource bundled in the app. Android sound files must reside in /res/raw/" - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - }, - "TimeToLive" : { - "shape" : "__integer", - "documentation" : "This parameter specifies how long (in seconds) the message should be kept in Baidu storage if the device is offline. The and the default value and the maximum time to live supported is 7 days (604800 seconds)" - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "Baidu Message." - }, - "CampaignEmailMessage" : { - "type" : "structure", - "members" : { - "Body" : { - "shape" : "__string", - "documentation" : "The email text body." - }, - "FromAddress" : { - "shape" : "__string", - "documentation" : "The email address used to send the email from. Defaults to use FromAddress specified in the Email Channel." - }, - "HtmlBody" : { - "shape" : "__string", - "documentation" : "The email html body." - }, - "Title" : { - "shape" : "__string", - "documentation" : "The email title (Or subject)." - } - }, - "documentation" : "The email message configuration.", - "required" : [ ] - }, - "CampaignHook" : { - "type" : "structure", - "members" : { - "LambdaFunctionName" : { - "shape" : "__string", - "documentation" : "Lambda function name or arn to be called for delivery" - }, - "Mode" : { - "shape" : "Mode", - "documentation" : "What mode Lambda should be invoked in." - }, - "WebUrl" : { - "shape" : "__string", - "documentation" : "Web URL to call for hook. If the URL has authentication specified it will be added as authentication to the request" - } - }, - "documentation" : "Campaign hook information." - }, - "CampaignLimits" : { - "type" : "structure", - "members" : { - "Daily" : { - "shape" : "__integer", - "documentation" : "The maximum number of messages that the campaign can send daily." - }, - "MaximumDuration" : { - "shape" : "__integer", - "documentation" : "The length of time (in seconds) that the campaign can run before it ends and message deliveries stop. This duration begins at the scheduled start time for the campaign. The minimum value is 60." - }, - "MessagesPerSecond" : { - "shape" : "__integer", - "documentation" : "The number of messages that the campaign can send per second. The minimum value is 50, and the maximum is 20000." - }, - "Total" : { - "shape" : "__integer", - "documentation" : "The maximum total number of messages that the campaign can send." - } - }, - "documentation" : "Campaign Limits are used to limit the number of messages that can be sent to a user." - }, - "CampaignResponse" : { - "type" : "structure", - "members" : { - "AdditionalTreatments" : { - "shape" : "ListOfTreatmentResource", - "documentation" : "Treatments that are defined in addition to the default treatment." - }, - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application to which the campaign applies." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date the campaign was created in ISO 8601 format." - }, - "DefaultState" : { - "shape" : "CampaignState", - "documentation" : "The status of the campaign's default treatment. Only present for A/B test campaigns." - }, - "Description" : { - "shape" : "__string", - "documentation" : "A description of the campaign." - }, - "HoldoutPercent" : { - "shape" : "__integer", - "documentation" : "The allocated percentage of end users who will not receive messages from this campaign." - }, - "Hook" : { - "shape" : "CampaignHook", - "documentation" : "Campaign hook information." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique campaign ID." - }, - "IsPaused" : { - "shape" : "__boolean", - "documentation" : "Indicates whether the campaign is paused. A paused campaign does not send messages unless you resume it by setting IsPaused to false." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date the campaign was last updated in ISO 8601 format.\t" - }, - "Limits" : { - "shape" : "CampaignLimits", - "documentation" : "The campaign limits settings." - }, - "MessageConfiguration" : { - "shape" : "MessageConfiguration", - "documentation" : "The message configuration settings." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The custom name of the campaign." - }, - "Schedule" : { - "shape" : "Schedule", - "documentation" : "The campaign schedule." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to which the campaign sends messages." - }, - "SegmentVersion" : { - "shape" : "__integer", - "documentation" : "The version of the segment to which the campaign sends messages." - }, - "State" : { - "shape" : "CampaignState", - "documentation" : "The campaign status.\n\nAn A/B test campaign will have a status of COMPLETED only when all treatments have a status of COMPLETED." - }, - "TreatmentDescription" : { - "shape" : "__string", - "documentation" : "A custom description for the treatment." - }, - "TreatmentName" : { - "shape" : "__string", - "documentation" : "The custom name of a variation of the campaign used for A/B testing." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "The campaign version number." - } - }, - "documentation" : "Campaign definition", - "required" : [ ] - }, - "CampaignSmsMessage" : { - "type" : "structure", - "members" : { - "Body" : { - "shape" : "__string", - "documentation" : "The SMS text body." - }, - "MessageType" : { - "shape" : "MessageType", - "documentation" : "Is this is a transactional SMS message, otherwise a promotional message." - }, - "SenderId" : { - "shape" : "__string", - "documentation" : "Sender ID of sent message." - } - }, - "documentation" : "SMS message configuration." - }, - "CampaignState" : { - "type" : "structure", - "members" : { - "CampaignStatus" : { - "shape" : "CampaignStatus", - "documentation" : "The status of the campaign, or the status of a treatment that belongs to an A/B test campaign.\n\nValid values: SCHEDULED, EXECUTING, PENDING_NEXT_RUN, COMPLETED, PAUSED" - } - }, - "documentation" : "State of the Campaign" - }, - "CampaignStatus" : { - "type" : "string", - "enum" : [ "SCHEDULED", "EXECUTING", "PENDING_NEXT_RUN", "COMPLETED", "PAUSED", "DELETED" ] - }, - "CampaignsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfCampaignResponse", - "documentation" : "A list of campaigns." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The string that you use in a subsequent request to get the next page of results in a paginated response." - } - }, - "documentation" : "List of available campaigns.", - "required" : [ ] - }, - "ChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "Application id" - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who made the last change" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Base definition for channel response." - }, - "ChannelType" : { - "type" : "string", - "enum" : [ "GCM", "APNS", "APNS_SANDBOX", "APNS_VOIP", "APNS_VOIP_SANDBOX", "ADM", "SMS", "EMAIL", "BAIDU", "CUSTOM" ] - }, - "ChannelsResponse" : { - "type" : "structure", - "members" : { - "Channels" : { - "shape" : "MapOfChannelResponse", - "documentation" : "A map of channels, with the ChannelType as the key and the Channel as the value." - } - }, - "documentation" : "Get channels definition", - "required" : [ ] - }, - "CreateAppRequest" : { - "type" : "structure", - "members" : { - "CreateApplicationRequest" : { - "shape" : "CreateApplicationRequest" - } - }, - "required" : [ "CreateApplicationRequest" ], - "payload" : "CreateApplicationRequest" - }, - "CreateAppResponse" : { - "type" : "structure", - "members" : { - "ApplicationResponse" : { - "shape" : "ApplicationResponse" - } - }, - "required" : [ "ApplicationResponse" ], - "payload" : "ApplicationResponse" - }, - "CreateApplicationRequest" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "documentation" : "The display name of the application. Used in the Amazon Pinpoint console." - } - }, - "documentation" : "Application Request.", - "required" : [ ] - }, - "CreateCampaignRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "WriteCampaignRequest" : { - "shape" : "WriteCampaignRequest" - } - }, - "required" : [ "ApplicationId", "WriteCampaignRequest" ], - "payload" : "WriteCampaignRequest" - }, - "CreateCampaignResponse" : { - "type" : "structure", - "members" : { - "CampaignResponse" : { - "shape" : "CampaignResponse" - } - }, - "required" : [ "CampaignResponse" ], - "payload" : "CampaignResponse" - }, - "CreateExportJobRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "ExportJobRequest" : { - "shape" : "ExportJobRequest" - } - }, - "required" : [ "ApplicationId", "ExportJobRequest" ], - "payload" : "ExportJobRequest" - }, - "CreateExportJobResponse" : { - "type" : "structure", - "members" : { - "ExportJobResponse" : { - "shape" : "ExportJobResponse" - } - }, - "required" : [ "ExportJobResponse" ], - "payload" : "ExportJobResponse" - }, - "CreateImportJobRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "ImportJobRequest" : { - "shape" : "ImportJobRequest" - } - }, - "required" : [ "ApplicationId", "ImportJobRequest" ], - "payload" : "ImportJobRequest" - }, - "CreateImportJobResponse" : { - "type" : "structure", - "members" : { - "ImportJobResponse" : { - "shape" : "ImportJobResponse" - } - }, - "required" : [ "ImportJobResponse" ], - "payload" : "ImportJobResponse" - }, - "CreateSegmentRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "WriteSegmentRequest" : { - "shape" : "WriteSegmentRequest" - } - }, - "required" : [ "ApplicationId", "WriteSegmentRequest" ], - "payload" : "WriteSegmentRequest" - }, - "CreateSegmentResponse" : { - "type" : "structure", - "members" : { - "SegmentResponse" : { - "shape" : "SegmentResponse" - } - }, - "required" : [ "SegmentResponse" ], - "payload" : "SegmentResponse" - }, - "DefaultMessage" : { - "type" : "structure", - "members" : { - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification, the email body or the text message." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - } - }, - "documentation" : "The default message to use across all channels." - }, - "DefaultPushNotificationMessage" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign: OPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action. DEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app. URL - The default mobile browser on the user's device launches and opens a web page at the URL you specify. Possible values include: OPEN_APP | DEEP_LINK | URL" - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification." - }, - "Data" : { - "shape" : "MapOf__string", - "documentation" : "The data payload used for a silent push. This payload is added to the notifications' data.pinpoint.jsonBody' object" - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device. Silent pushes can be used for Remote Configuration and Phone Home use cases." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "Default Push Notification Message." - }, - "DeleteAdmChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteAdmChannelResponse" : { - "type" : "structure", - "members" : { - "ADMChannelResponse" : { - "shape" : "ADMChannelResponse" - } - }, - "required" : [ "ADMChannelResponse" ], - "payload" : "ADMChannelResponse" - }, - "DeleteApnsChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteApnsChannelResponse" : { - "type" : "structure", - "members" : { - "APNSChannelResponse" : { - "shape" : "APNSChannelResponse" - } - }, - "required" : [ "APNSChannelResponse" ], - "payload" : "APNSChannelResponse" - }, - "DeleteApnsSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteApnsSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSSandboxChannelResponse" : { - "shape" : "APNSSandboxChannelResponse" - } - }, - "required" : [ "APNSSandboxChannelResponse" ], - "payload" : "APNSSandboxChannelResponse" - }, - "DeleteApnsVoipChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteApnsVoipChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipChannelResponse" : { - "shape" : "APNSVoipChannelResponse" - } - }, - "required" : [ "APNSVoipChannelResponse" ], - "payload" : "APNSVoipChannelResponse" - }, - "DeleteApnsVoipSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteApnsVoipSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipSandboxChannelResponse" : { - "shape" : "APNSVoipSandboxChannelResponse" - } - }, - "required" : [ "APNSVoipSandboxChannelResponse" ], - "payload" : "APNSVoipSandboxChannelResponse" - }, - "DeleteAppRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteAppResponse" : { - "type" : "structure", - "members" : { - "ApplicationResponse" : { - "shape" : "ApplicationResponse" - } - }, - "required" : [ "ApplicationResponse" ], - "payload" : "ApplicationResponse" - }, - "DeleteBaiduChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteBaiduChannelResponse" : { - "type" : "structure", - "members" : { - "BaiduChannelResponse" : { - "shape" : "BaiduChannelResponse" - } - }, - "required" : [ "BaiduChannelResponse" ], - "payload" : "BaiduChannelResponse" - }, - "DeleteCampaignRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - } - }, - "required" : [ "CampaignId", "ApplicationId" ] - }, - "DeleteCampaignResponse" : { - "type" : "structure", - "members" : { - "CampaignResponse" : { - "shape" : "CampaignResponse" - } - }, - "required" : [ "CampaignResponse" ], - "payload" : "CampaignResponse" - }, - "DeleteEmailChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteEmailChannelResponse" : { - "type" : "structure", - "members" : { - "EmailChannelResponse" : { - "shape" : "EmailChannelResponse" - } - }, - "required" : [ "EmailChannelResponse" ], - "payload" : "EmailChannelResponse" - }, - "DeleteEndpointRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EndpointId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "endpoint-id", - "documentation" : "The unique ID of the endpoint." - } - }, - "required" : [ "ApplicationId", "EndpointId" ] - }, - "DeleteEndpointResponse" : { - "type" : "structure", - "members" : { - "EndpointResponse" : { - "shape" : "EndpointResponse" - } - }, - "required" : [ "EndpointResponse" ], - "payload" : "EndpointResponse" - }, - "DeleteEventStreamRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteEventStreamResponse" : { - "type" : "structure", - "members" : { - "EventStream" : { - "shape" : "EventStream" - } - }, - "required" : [ "EventStream" ], - "payload" : "EventStream" - }, - "DeleteGcmChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteGcmChannelResponse" : { - "type" : "structure", - "members" : { - "GCMChannelResponse" : { - "shape" : "GCMChannelResponse" - } - }, - "required" : [ "GCMChannelResponse" ], - "payload" : "GCMChannelResponse" - }, - "DeleteSegmentRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - } - }, - "required" : [ "SegmentId", "ApplicationId" ] - }, - "DeleteSegmentResponse" : { - "type" : "structure", - "members" : { - "SegmentResponse" : { - "shape" : "SegmentResponse" - } - }, - "required" : [ "SegmentResponse" ], - "payload" : "SegmentResponse" - }, - "DeleteSmsChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "DeleteSmsChannelResponse" : { - "type" : "structure", - "members" : { - "SMSChannelResponse" : { - "shape" : "SMSChannelResponse" - } - }, - "required" : [ "SMSChannelResponse" ], - "payload" : "SMSChannelResponse" - }, - "DeleteUserEndpointsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "UserId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "user-id", - "documentation" : "The unique ID of the user." - } - }, - "required" : [ "ApplicationId", "UserId" ] - }, - "DeleteUserEndpointsResponse" : { - "type" : "structure", - "members" : { - "EndpointsResponse" : { - "shape" : "EndpointsResponse" - } - }, - "required" : [ "EndpointsResponse" ], - "payload" : "EndpointsResponse" - }, - "DeliveryStatus" : { - "type" : "string", - "enum" : [ "SUCCESSFUL", "THROTTLED", "TEMPORARY_FAILURE", "PERMANENT_FAILURE", "UNKNOWN_FAILURE", "OPT_OUT", "DUPLICATE" ] - }, - "DimensionType" : { - "type" : "string", - "enum" : [ "INCLUSIVE", "EXCLUSIVE" ] - }, - "DirectMessageConfiguration" : { - "type" : "structure", - "members" : { - "ADMMessage" : { - "shape" : "ADMMessage", - "documentation" : "The message to ADM channels. Overrides the default push notification message." - }, - "APNSMessage" : { - "shape" : "APNSMessage", - "documentation" : "The message to APNS channels. Overrides the default push notification message." - }, - "BaiduMessage" : { - "shape" : "BaiduMessage", - "documentation" : "The message to Baidu GCM channels. Overrides the default push notification message." - }, - "DefaultMessage" : { - "shape" : "DefaultMessage", - "documentation" : "The default message for all channels." - }, - "DefaultPushNotificationMessage" : { - "shape" : "DefaultPushNotificationMessage", - "documentation" : "The default push notification message for all push channels." - }, - "GCMMessage" : { - "shape" : "GCMMessage", - "documentation" : "The message to GCM channels. Overrides the default push notification message." - }, - "SMSMessage" : { - "shape" : "SMSMessage", - "documentation" : "The message to SMS channels. Overrides the default message." - } - }, - "documentation" : "Message definitions for the default message and any messages that are tailored for specific channels.", - "required" : [ ] - }, - "Duration" : { - "type" : "string", - "enum" : [ "HR_24", "DAY_7", "DAY_14", "DAY_30" ] - }, - "EmailChannelRequest" : { - "type" : "structure", - "members" : { - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "FromAddress" : { - "shape" : "__string", - "documentation" : "The email address used to send emails from." - }, - "Identity" : { - "shape" : "__string", - "documentation" : "The ARN of an identity verified with SES." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of an IAM Role used to submit events to Mobile Analytics' event ingestion service" - } - }, - "documentation" : "Email Channel Request", - "required" : [ ] - }, - "EmailChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID of the application to which the email channel belongs." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date that the settings were last updated in ISO 8601 format." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "FromAddress" : { - "shape" : "__string", - "documentation" : "The email address used to send emails from." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "Identity" : { - "shape" : "__string", - "documentation" : "The ARN of an identity verified with SES." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who last updated this entry" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "MessagesPerSecond" : { - "shape" : "__integer", - "documentation" : "Messages per second that can be sent" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "Platform type. Will be \"EMAIL\"" - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The ARN of an IAM Role used to submit events to Mobile Analytics' event ingestion service" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Email Channel Response.", - "required" : [ ] - }, - "EndpointBatchItem" : { - "type" : "structure", - "members" : { - "Address" : { - "shape" : "__string", - "documentation" : "The destination for messages that you send to this endpoint. The address varies by channel. For mobile push channels, use the token provided by the push notification service, such as the APNs device token or the FCM registration token. For the SMS channel, use a phone number in E.164 format, such as +12065550100. For the email channel, use an email address." - }, - "Attributes" : { - "shape" : "MapOfListOf__string", - "documentation" : "Custom attributes that describe the endpoint by associating a name with an array of values. For example, an attribute named \"interests\" might have the values [\"science\", \"politics\", \"travel\"]. You can use these attributes as selection criteria when you create a segment of users to engage with a messaging campaign.\n\nThe following characters are not recommended in attribute names: # : ? \\ /. The Amazon Pinpoint console does not display attributes that include these characters in the name. This limitation does not apply to attribute values." - }, - "ChannelType" : { - "shape" : "ChannelType", - "documentation" : "The channel type.\n\nValid values: GCM | APNS | APNS_SANDBOX | APNS_VOIP | APNS_VOIP_SANDBOX | ADM | SMS | EMAIL | BAIDU" - }, - "Demographic" : { - "shape" : "EndpointDemographic", - "documentation" : "The endpoint demographic attributes." - }, - "EffectiveDate" : { - "shape" : "__string", - "documentation" : "The last time the endpoint was updated. Provided in ISO 8601 format." - }, - "EndpointStatus" : { - "shape" : "__string", - "documentation" : "Unused." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique Id for the Endpoint in the batch." - }, - "Location" : { - "shape" : "EndpointLocation", - "documentation" : "The endpoint location attributes." - }, - "Metrics" : { - "shape" : "MapOf__double", - "documentation" : "Custom metrics that your app reports to Amazon Pinpoint." - }, - "OptOut" : { - "shape" : "__string", - "documentation" : "Indicates whether a user has opted out of receiving messages with one of the following values:\n\nALL - User has opted out of all messages.\n\nNONE - Users has not opted out and receives all messages." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "The unique ID for the most recent request to update the endpoint." - }, - "User" : { - "shape" : "EndpointUser", - "documentation" : "Custom user-specific attributes that your app reports to Amazon Pinpoint." - } - }, - "documentation" : "Endpoint update request" - }, - "EndpointBatchRequest" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfEndpointBatchItem", - "documentation" : "List of items to update. Maximum 100 items" - } - }, - "documentation" : "Endpoint batch update request.", - "required" : [ ] - }, - "EndpointDemographic" : { - "type" : "structure", - "members" : { - "AppVersion" : { - "shape" : "__string", - "documentation" : "The version of the application associated with the endpoint." - }, - "Locale" : { - "shape" : "__string", - "documentation" : "The endpoint locale in the following format: The ISO 639-1 alpha-2 code, followed by an underscore, followed by an ISO 3166-1 alpha-2 value.\n" - }, - "Make" : { - "shape" : "__string", - "documentation" : "The manufacturer of the endpoint device, such as Apple or Samsung." - }, - "Model" : { - "shape" : "__string", - "documentation" : "The model name or number of the endpoint device, such as iPhone." - }, - "ModelVersion" : { - "shape" : "__string", - "documentation" : "The model version of the endpoint device." - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform of the endpoint device, such as iOS or Android." - }, - "PlatformVersion" : { - "shape" : "__string", - "documentation" : "The platform version of the endpoint device." - }, - "Timezone" : { - "shape" : "__string", - "documentation" : "The timezone of the endpoint. Specified as a tz database value, such as Americas/Los_Angeles." - } - }, - "documentation" : "Demographic information about the endpoint." - }, - "EndpointItemResponse" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "A custom message associated with the registration of an endpoint when issuing a response." - }, - "StatusCode" : { - "shape" : "__integer", - "documentation" : "The status code to respond with for a particular endpoint id after endpoint registration" - } - }, - "documentation" : "The responses that are returned after you create or update an endpoint and record an event." - }, - "EndpointLocation" : { - "type" : "structure", - "members" : { - "City" : { - "shape" : "__string", - "documentation" : "The city where the endpoint is located." - }, - "Country" : { - "shape" : "__string", - "documentation" : "The two-letter code for the country or region of the endpoint. Specified as an ISO 3166-1 Alpha-2 code, such as \"US\" for the United States." - }, - "Latitude" : { - "shape" : "__double", - "documentation" : "The latitude of the endpoint location, rounded to one decimal place." - }, - "Longitude" : { - "shape" : "__double", - "documentation" : "The longitude of the endpoint location, rounded to one decimal place." - }, - "PostalCode" : { - "shape" : "__string", - "documentation" : "The postal code or zip code of the endpoint." - }, - "Region" : { - "shape" : "__string", - "documentation" : "The region of the endpoint location. For example, in the United States, this corresponds to a state." - } - }, - "documentation" : "Location data for the endpoint." - }, - "EndpointMessageResult" : { - "type" : "structure", - "members" : { - "Address" : { - "shape" : "__string", - "documentation" : "Address that endpoint message was delivered to." - }, - "DeliveryStatus" : { - "shape" : "DeliveryStatus", - "documentation" : "The delivery status of the message. Possible values:\n\nSUCCESS - The message was successfully delivered to the endpoint.\n\nTRANSIENT_FAILURE - A temporary error occurred. Amazon Pinpoint will attempt to deliver the message again later.\n\nFAILURE_PERMANENT - An error occurred when delivering the message to the endpoint. Amazon Pinpoint won't attempt to send the message again.\n\nTIMEOUT - The message couldn't be sent within the timeout period.\n\nQUIET_TIME - The local time for the endpoint was within the Quiet Hours for the campaign.\n\nDAILY_CAP - The endpoint has received the maximum number of messages it can receive within a 24-hour period.\n\nHOLDOUT - The endpoint was in a hold out treatment for the campaign.\n\nTHROTTLED - Amazon Pinpoint throttled sending to this endpoint.\n\nEXPIRED - The endpoint address is expired.\n\nCAMPAIGN_CAP - The endpoint received the maximum number of messages allowed by the campaign.\n\nSERVICE_FAILURE - A service-level failure prevented Amazon Pinpoint from delivering the message.\n\nUNKNOWN - An unknown error occurred." - }, - "MessageId" : { - "shape" : "__string", - "documentation" : "Unique message identifier associated with the message that was sent." - }, - "StatusCode" : { - "shape" : "__integer", - "documentation" : "Downstream service status code." - }, - "StatusMessage" : { - "shape" : "__string", - "documentation" : "Status message for message delivery." - }, - "UpdatedToken" : { - "shape" : "__string", - "documentation" : "If token was updated as part of delivery. (This is GCM Specific)" - } - }, - "documentation" : "The result from sending a message to an endpoint.", - "required" : [ ] - }, - "EndpointRequest" : { - "type" : "structure", - "members" : { - "Address" : { - "shape" : "__string", - "documentation" : "The destination for messages that you send to this endpoint. The address varies by channel. For mobile push channels, use the token provided by the push notification service, such as the APNs device token or the FCM registration token. For the SMS channel, use a phone number in E.164 format, such as +12065550100. For the email channel, use an email address." - }, - "Attributes" : { - "shape" : "MapOfListOf__string", - "documentation" : "Custom attributes that describe the endpoint by associating a name with an array of values. For example, an attribute named \"interests\" might have the values [\"science\", \"politics\", \"travel\"]. You can use these attributes as selection criteria when you create a segment of users to engage with a messaging campaign.\n\nThe following characters are not recommended in attribute names: # : ? \\ /. The Amazon Pinpoint console does not display attributes that include these characters in the name. This limitation does not apply to attribute values." - }, - "ChannelType" : { - "shape" : "ChannelType", - "documentation" : "The channel type.\n\nValid values: GCM | APNS | APNS_SANDBOX | APNS_VOIP | APNS_VOIP_SANDBOX | ADM | SMS | EMAIL | BAIDU" - }, - "Demographic" : { - "shape" : "EndpointDemographic", - "documentation" : "Demographic attributes for the endpoint." - }, - "EffectiveDate" : { - "shape" : "__string", - "documentation" : "The date and time when the endpoint was updated, shown in ISO 8601 format." - }, - "EndpointStatus" : { - "shape" : "__string", - "documentation" : "Unused." - }, - "Location" : { - "shape" : "EndpointLocation", - "documentation" : "The endpoint location attributes." - }, - "Metrics" : { - "shape" : "MapOf__double", - "documentation" : "Custom metrics that your app reports to Amazon Pinpoint." - }, - "OptOut" : { - "shape" : "__string", - "documentation" : "Indicates whether a user has opted out of receiving messages with one of the following values:\n\nALL - User has opted out of all messages.\n\nNONE - Users has not opted out and receives all messages." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "The unique ID for the most recent request to update the endpoint." - }, - "User" : { - "shape" : "EndpointUser", - "documentation" : "Custom user-specific attributes that your app reports to Amazon Pinpoint." - } - }, - "documentation" : "Endpoint update request" - }, - "EndpointResponse" : { - "type" : "structure", - "members" : { - "Address" : { - "shape" : "__string", - "documentation" : "The address of the endpoint as provided by your push provider. For example, the DeviceToken or RegistrationId." - }, - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application that is associated with the endpoint." - }, - "Attributes" : { - "shape" : "MapOfListOf__string", - "documentation" : "Custom attributes that describe the endpoint by associating a name with an array of values. For example, an attribute named \"interests\" might have the following values: [\"science\", \"politics\", \"travel\"]. You can use these attributes as selection criteria when you create segments.\n\nThe Amazon Pinpoint console can't display attribute names that include the following characters: hash/pound sign (#), colon (:), question mark (?), backslash (\\), and forward slash (/). For this reason, you should avoid using these characters in the names of custom attributes." - }, - "ChannelType" : { - "shape" : "ChannelType", - "documentation" : "The channel type.\n\nValid values: GCM | APNS | APNS_SANDBOX | APNS_VOIP | APNS_VOIP_SANDBOX | ADM | SMS | EMAIL | BAIDU" - }, - "CohortId" : { - "shape" : "__string", - "documentation" : "A number from 0-99 that represents the cohort the endpoint is assigned to. Endpoints are grouped into cohorts randomly, and each cohort contains approximately 1 percent of the endpoints for an app. Amazon Pinpoint assigns cohorts to the holdout or treatment allocations for a campaign." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date and time when the endpoint was created, shown in ISO 8601 format." - }, - "Demographic" : { - "shape" : "EndpointDemographic", - "documentation" : "The endpoint demographic attributes." - }, - "EffectiveDate" : { - "shape" : "__string", - "documentation" : "The date and time when the endpoint was last updated, shown in ISO 8601 format." - }, - "EndpointStatus" : { - "shape" : "__string", - "documentation" : "Unused." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique ID that you assigned to the endpoint. The ID should be a globally unique identifier (GUID) to ensure that it doesn't conflict with other endpoint IDs associated with the application." - }, - "Location" : { - "shape" : "EndpointLocation", - "documentation" : "The endpoint location attributes." - }, - "Metrics" : { - "shape" : "MapOf__double", - "documentation" : "Custom metrics that your app reports to Amazon Pinpoint." - }, - "OptOut" : { - "shape" : "__string", - "documentation" : "Indicates whether a user has opted out of receiving messages with one of the following values:\n\nALL - User has opted out of all messages.\n\nNONE - Users has not opted out and receives all messages." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "The unique ID for the most recent request to update the endpoint." - }, - "User" : { - "shape" : "EndpointUser", - "documentation" : "Custom user-specific attributes that your app reports to Amazon Pinpoint." - } - }, - "documentation" : "Endpoint response" - }, - "EndpointSendConfiguration" : { - "type" : "structure", - "members" : { - "BodyOverride" : { - "shape" : "__string", - "documentation" : "Body override. If specified will override default body." - }, - "Context" : { - "shape" : "MapOf__string", - "documentation" : "A map of custom attributes to attributes to be attached to the message for this address. This payload is added to the push notification's 'data.pinpoint' object or added to the email/sms delivery receipt event attributes." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "A map of substitution values for the message to be merged with the DefaultMessage's substitutions. Substitutions on this map take precedence over the all other substitutions." - }, - "TitleOverride" : { - "shape" : "__string", - "documentation" : "Title override. If specified will override default title if applicable." - } - }, - "documentation" : "Endpoint send configuration." - }, - "EndpointUser" : { - "type" : "structure", - "members" : { - "UserAttributes" : { - "shape" : "MapOfListOf__string", - "documentation" : "Custom attributes that describe the user by associating a name with an array of values. For example, an attribute named \"interests\" might have the following values: [\"science\", \"politics\", \"travel\"]. You can use these attributes as selection criteria when you create segments.\n\nThe Amazon Pinpoint console can't display attribute names that include the following characters: hash/pound sign (#), colon (:), question mark (?), backslash (\\), and forward slash (/). For this reason, you should avoid using these characters in the names of custom attributes." - }, - "UserId" : { - "shape" : "__string", - "documentation" : "The unique ID of the user." - } - }, - "documentation" : "Endpoint user specific custom userAttributes" - }, - "EndpointsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfEndpointResponse", - "documentation" : "The list of endpoints." - } - }, - "documentation" : "List of endpoints", - "required" : [ ] - }, - "Event" : { - "type" : "structure", - "members" : { - "Attributes" : { - "shape" : "MapOf__string", - "documentation" : "Custom attributes that are associated with the event you're adding or updating." - }, - "ClientSdkVersion" : { - "shape" : "__string", - "documentation" : "The version of the SDK that's running on the client device." - }, - "EventType" : { - "shape" : "__string", - "documentation" : "The name of the custom event that you're recording." - }, - "Metrics" : { - "shape" : "MapOf__double", - "documentation" : "Event metrics" - }, - "Session" : { - "shape" : "Session", - "documentation" : "The session" - }, - "Timestamp" : { - "shape" : "__string", - "documentation" : "The date and time when the event occurred, in ISO 8601 format." - } - }, - "documentation" : "Model for creating or updating events.", - "required" : [ ] - }, - "EventItemResponse" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "A custom message that is associated with the processing of an event." - }, - "StatusCode" : { - "shape" : "__integer", - "documentation" : "The status code to respond with for a particular event id" - } - }, - "documentation" : "The responses that are returned after you record an event." - }, - "EventStream" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application from which events should be published." - }, - "DestinationStreamArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of the Amazon Kinesis stream or Firehose delivery stream to which you want to publish events.\n Firehose ARN: arn:aws:firehose:REGION:ACCOUNT_ID:deliverystream/STREAM_NAME\n Kinesis ARN: arn:aws:kinesis:REGION:ACCOUNT_ID:stream/STREAM_NAME" - }, - "ExternalId" : { - "shape" : "__string", - "documentation" : "(Deprecated) Your AWS account ID, which you assigned to the ExternalID key in an IAM trust policy. Used by Amazon Pinpoint to assume an IAM role. This requirement is removed, and external IDs are not recommended for IAM roles assumed by Amazon Pinpoint." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date the event stream was last updated in ISO 8601 format." - }, - "LastUpdatedBy" : { - "shape" : "__string", - "documentation" : "The IAM user who last modified the event stream." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The IAM role that authorizes Amazon Pinpoint to publish events to the stream in your account." - } - }, - "documentation" : "Model for an event publishing subscription export.", - "required" : [ ] - }, - "EventsBatch" : { - "type" : "structure", - "members" : { - "Endpoint" : { - "shape" : "PublicEndpoint", - "documentation" : "Endpoint information" - }, - "Events" : { - "shape" : "MapOfEvent", - "documentation" : "Events" - } - }, - "documentation" : "Events batch definition", - "required" : [ ] - }, - "EventsRequest" : { - "type" : "structure", - "members" : { - "BatchItem" : { - "shape" : "MapOfEventsBatch", - "documentation" : "Batch of events with endpoint id as the key and an object of EventsBatch as value. The EventsBatch object has the PublicEndpoint and a map of event Id's to events" - } - }, - "documentation" : "Put Events request", - "required" : [ ] - }, - "EventsResponse" : { - "type" : "structure", - "members" : { - "Results" : { - "shape" : "MapOfItemResponse", - "documentation" : "A map containing a multi part response for each endpoint, with the endpoint id as the key and item response as the value" - } - }, - "documentation" : "The results from processing a put events request" - }, - "ExportJobRequest" : { - "type" : "structure", - "members" : { - "RoleArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the Amazon S3 location that endpoints will be exported to." - }, - "S3UrlPrefix" : { - "shape" : "__string", - "documentation" : "A URL that points to the location within an Amazon S3 bucket that will receive the export. The location is typically a folder with multiple files.\n\nThe URL should follow this format: s3://bucket-name/folder-name/\n\nAmazon Pinpoint will export endpoints to this location." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to export endpoints from. If not present, Amazon Pinpoint exports all of the endpoints that belong to the application." - }, - "SegmentVersion" : { - "shape" : "__integer", - "documentation" : "The version of the segment to export if specified." - } - }, - "documentation" : "Export job request.", - "required" : [ ] - }, - "ExportJobResource" : { - "type" : "structure", - "members" : { - "RoleArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the Amazon S3 location that endpoints will be exported to." - }, - "S3UrlPrefix" : { - "shape" : "__string", - "documentation" : "A URL that points to the location within an Amazon S3 bucket that will receive the export. The location is typically a folder with multiple files.\n\nThe URL should follow this format: s3://bucket-name/folder-name/\n\nAmazon Pinpoint will export endpoints to this location." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to export endpoints from. If not present, Amazon Pinpoint exports all of the endpoints that belong to the application." - }, - "SegmentVersion" : { - "shape" : "__integer", - "documentation" : "The version of the segment to export if specified." - } - }, - "documentation" : "Export job resource.", - "required" : [ ] - }, - "ExportJobResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID of the application associated with the export job." - }, - "CompletedPieces" : { - "shape" : "__integer", - "documentation" : "The number of pieces that have successfully completed as of the time of the request." - }, - "CompletionDate" : { - "shape" : "__string", - "documentation" : "The date the job completed in ISO 8601 format." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date the job was created in ISO 8601 format." - }, - "Definition" : { - "shape" : "ExportJobResource", - "documentation" : "The export job settings." - }, - "FailedPieces" : { - "shape" : "__integer", - "documentation" : "The number of pieces that failed to be processed as of the time of the request." - }, - "Failures" : { - "shape" : "ListOf__string", - "documentation" : "Provides up to 100 of the first failed entries for the job, if any exist." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique ID of the job." - }, - "JobStatus" : { - "shape" : "JobStatus", - "documentation" : "The status of the job.\nValid values: CREATED, INITIALIZING, PROCESSING, COMPLETING, COMPLETED, FAILING, FAILED\n\nThe job status is FAILED if one or more pieces failed." - }, - "TotalFailures" : { - "shape" : "__integer", - "documentation" : "The number of endpoints that were not processed; for example, because of syntax errors." - }, - "TotalPieces" : { - "shape" : "__integer", - "documentation" : "The total number of pieces that must be processed to finish the job. Each piece is an approximately equal portion of the endpoints." - }, - "TotalProcessed" : { - "shape" : "__integer", - "documentation" : "The number of endpoints that were processed by the job." - }, - "Type" : { - "shape" : "__string", - "documentation" : "The job type. Will be 'EXPORT'." - } - }, - "documentation" : "Export job response.", - "required" : [ ] - }, - "ExportJobsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfExportJobResponse", - "documentation" : "A list of export jobs for the application." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The string that you use in a subsequent request to get the next page of results in a paginated response." - } - }, - "documentation" : "Export job list.", - "required" : [ ] - }, - "ForbiddenException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 403 - } - }, - "Format" : { - "type" : "string", - "enum" : [ "CSV", "JSON" ] - }, - "Frequency" : { - "type" : "string", - "enum" : [ "ONCE", "HOURLY", "DAILY", "WEEKLY", "MONTHLY" ] - }, - "GCMChannelRequest" : { - "type" : "structure", - "members" : { - "ApiKey" : { - "shape" : "__string", - "documentation" : "Platform credential API key from Google." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - } - }, - "documentation" : "Google Cloud Messaging credentials", - "required" : [ ] - }, - "GCMChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application to which the channel applies." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "When was this segment created" - }, - "Credential" : { - "shape" : "__string", - "documentation" : "The GCM API key from Google." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used. Present only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who last updated this entry" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "The platform type. Will be GCM" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "Google Cloud Messaging channel definition", - "required" : [ ] - }, - "GCMMessage" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign: OPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action. DEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app. URL - The default mobile browser on the user's device launches and opens a web page at the URL you specify. Possible values include: OPEN_APP | DEEP_LINK | URL" - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body of the notification." - }, - "CollapseKey" : { - "shape" : "__string", - "documentation" : "This parameter identifies a group of messages (e.g., with collapse_key: \"Updates Available\") that can be collapsed, so that only the last message gets sent when delivery can be resumed. This is intended to avoid sending too many of the same messages when the device comes back online or becomes active." - }, - "Data" : { - "shape" : "MapOf__string", - "documentation" : "The data payload used for a silent push. This payload is added to the notifications' data.pinpoint.jsonBody' object" - }, - "IconReference" : { - "shape" : "__string", - "documentation" : "The icon image name of the asset saved in your application." - }, - "ImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the large icon to the notification content view." - }, - "ImageUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used in the push notification." - }, - "Priority" : { - "shape" : "__string", - "documentation" : "The message priority. Amazon Pinpoint uses this value to set the FCM or GCM priority parameter when it sends the message. Accepts the following values:\n\n\"Normal\" - Messages might be delayed. Delivery is optimized for battery usage on the receiving device. Use normal priority unless immediate delivery is required.\n\n\"High\" - Messages are sent immediately and might wake a sleeping device.\n\nThe equivalent values for APNs messages are \"5\" and \"10\". Amazon Pinpoint accepts these values here and converts them.\n\nFor more information, see About FCM Messages in the Firebase documentation." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "RestrictedPackageName" : { - "shape" : "__string", - "documentation" : "This parameter specifies the package name of the application where the registration tokens must match in order to receive the message." - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device. Silent pushes can be used for Remote Configuration and Phone Home use cases." - }, - "SmallImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used as the small icon for the notification which will be used to represent the notification in the status bar and content view" - }, - "Sound" : { - "shape" : "__string", - "documentation" : "Indicates a sound to play when the device receives the notification. Supports default, or the filename of a sound resource bundled in the app. Android sound files must reside in /res/raw/" - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - }, - "TimeToLive" : { - "shape" : "__integer", - "documentation" : "The length of time (in seconds) that FCM or GCM stores and attempts to deliver the message. If unspecified, the value defaults to the maximum, which is 2,419,200 seconds (28 days). Amazon Pinpoint uses this value to set the FCM or GCM time_to_live parameter." - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "GCM Message." - }, - "GPSCoordinates" : { - "type" : "structure", - "members" : { - "Latitude" : { - "shape" : "__double", - "documentation" : "Latitude" - }, - "Longitude" : { - "shape" : "__double", - "documentation" : "Longitude" - } - }, - "documentation" : "GPS coordinates", - "required" : [ ] - }, - "GPSPointDimension" : { - "type" : "structure", - "members" : { - "Coordinates" : { - "shape" : "GPSCoordinates", - "documentation" : "Coordinate to measure distance from." - }, - "RangeInKilometers" : { - "shape" : "__double", - "documentation" : "Range in kilometers from the coordinate." - } - }, - "documentation" : "GPS point location dimension", - "required" : [ ] - }, - "GetAdmChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetAdmChannelResponse" : { - "type" : "structure", - "members" : { - "ADMChannelResponse" : { - "shape" : "ADMChannelResponse" - } - }, - "required" : [ "ADMChannelResponse" ], - "payload" : "ADMChannelResponse" - }, - "GetApnsChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApnsChannelResponse" : { - "type" : "structure", - "members" : { - "APNSChannelResponse" : { - "shape" : "APNSChannelResponse" - } - }, - "required" : [ "APNSChannelResponse" ], - "payload" : "APNSChannelResponse" - }, - "GetApnsSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApnsSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSSandboxChannelResponse" : { - "shape" : "APNSSandboxChannelResponse" - } - }, - "required" : [ "APNSSandboxChannelResponse" ], - "payload" : "APNSSandboxChannelResponse" - }, - "GetApnsVoipChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApnsVoipChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipChannelResponse" : { - "shape" : "APNSVoipChannelResponse" - } - }, - "required" : [ "APNSVoipChannelResponse" ], - "payload" : "APNSVoipChannelResponse" - }, - "GetApnsVoipSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApnsVoipSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipSandboxChannelResponse" : { - "shape" : "APNSVoipSandboxChannelResponse" - } - }, - "required" : [ "APNSVoipSandboxChannelResponse" ], - "payload" : "APNSVoipSandboxChannelResponse" - }, - "GetAppRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetAppResponse" : { - "type" : "structure", - "members" : { - "ApplicationResponse" : { - "shape" : "ApplicationResponse" - } - }, - "required" : [ "ApplicationResponse" ], - "payload" : "ApplicationResponse" - }, - "GetApplicationSettingsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApplicationSettingsResponse" : { - "type" : "structure", - "members" : { - "ApplicationSettingsResource" : { - "shape" : "ApplicationSettingsResource" - } - }, - "required" : [ "ApplicationSettingsResource" ], - "payload" : "ApplicationSettingsResource" - }, - "GetAppsRequest" : { - "type" : "structure", - "members" : { - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - } - }, - "GetAppsResponse" : { - "type" : "structure", - "members" : { - "ApplicationsResponse" : { - "shape" : "ApplicationsResponse" - } - }, - "required" : [ "ApplicationsResponse" ], - "payload" : "ApplicationsResponse" - }, - "GetBaiduChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetBaiduChannelResponse" : { - "type" : "structure", - "members" : { - "BaiduChannelResponse" : { - "shape" : "BaiduChannelResponse" - } - }, - "required" : [ "BaiduChannelResponse" ], - "payload" : "BaiduChannelResponse" - }, - "GetCampaignActivitiesRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId", "CampaignId" ] - }, - "GetCampaignActivitiesResponse" : { - "type" : "structure", - "members" : { - "ActivitiesResponse" : { - "shape" : "ActivitiesResponse" - } - }, - "required" : [ "ActivitiesResponse" ], - "payload" : "ActivitiesResponse" - }, - "GetCampaignRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - } - }, - "required" : [ "CampaignId", "ApplicationId" ] - }, - "GetCampaignResponse" : { - "type" : "structure", - "members" : { - "CampaignResponse" : { - "shape" : "CampaignResponse" - } - }, - "required" : [ "CampaignResponse" ], - "payload" : "CampaignResponse" - }, - "GetCampaignVersionRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - }, - "Version" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "version", - "documentation" : "The version of the campaign." - } - }, - "required" : [ "Version", "ApplicationId", "CampaignId" ] - }, - "GetCampaignVersionResponse" : { - "type" : "structure", - "members" : { - "CampaignResponse" : { - "shape" : "CampaignResponse" - } - }, - "required" : [ "CampaignResponse" ], - "payload" : "CampaignResponse" - }, - "GetCampaignVersionsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId", "CampaignId" ] - }, - "GetCampaignVersionsResponse" : { - "type" : "structure", - "members" : { - "CampaignsResponse" : { - "shape" : "CampaignsResponse" - } - }, - "required" : [ "CampaignsResponse" ], - "payload" : "CampaignsResponse" - }, - "GetCampaignsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetCampaignsResponse" : { - "type" : "structure", - "members" : { - "CampaignsResponse" : { - "shape" : "CampaignsResponse" - } - }, - "required" : [ "CampaignsResponse" ], - "payload" : "CampaignsResponse" - }, - "GetChannelsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetChannelsResponse" : { - "type" : "structure", - "members" : { - "ChannelsResponse" : { - "shape" : "ChannelsResponse" - } - }, - "required" : [ "ChannelsResponse" ], - "payload" : "ChannelsResponse" - }, - "GetEmailChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetEmailChannelResponse" : { - "type" : "structure", - "members" : { - "EmailChannelResponse" : { - "shape" : "EmailChannelResponse" - } - }, - "required" : [ "EmailChannelResponse" ], - "payload" : "EmailChannelResponse" - }, - "GetEndpointRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EndpointId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "endpoint-id", - "documentation" : "The unique ID of the endpoint." - } - }, - "required" : [ "ApplicationId", "EndpointId" ] - }, - "GetEndpointResponse" : { - "type" : "structure", - "members" : { - "EndpointResponse" : { - "shape" : "EndpointResponse" - } - }, - "required" : [ "EndpointResponse" ], - "payload" : "EndpointResponse" - }, - "GetEventStreamRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetEventStreamResponse" : { - "type" : "structure", - "members" : { - "EventStream" : { - "shape" : "EventStream" - } - }, - "required" : [ "EventStream" ], - "payload" : "EventStream" - }, - "GetExportJobRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "JobId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "job-id", - "documentation" : "The unique ID of the job." - } - }, - "required" : [ "ApplicationId", "JobId" ] - }, - "GetExportJobResponse" : { - "type" : "structure", - "members" : { - "ExportJobResponse" : { - "shape" : "ExportJobResponse" - } - }, - "required" : [ "ExportJobResponse" ], - "payload" : "ExportJobResponse" - }, - "GetExportJobsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetExportJobsResponse" : { - "type" : "structure", - "members" : { - "ExportJobsResponse" : { - "shape" : "ExportJobsResponse" - } - }, - "required" : [ "ExportJobsResponse" ], - "payload" : "ExportJobsResponse" - }, - "GetGcmChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetGcmChannelResponse" : { - "type" : "structure", - "members" : { - "GCMChannelResponse" : { - "shape" : "GCMChannelResponse" - } - }, - "required" : [ "GCMChannelResponse" ], - "payload" : "GCMChannelResponse" - }, - "GetImportJobRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "JobId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "job-id", - "documentation" : "The unique ID of the job." - } - }, - "required" : [ "ApplicationId", "JobId" ] - }, - "GetImportJobResponse" : { - "type" : "structure", - "members" : { - "ImportJobResponse" : { - "shape" : "ImportJobResponse" - } - }, - "required" : [ "ImportJobResponse" ], - "payload" : "ImportJobResponse" - }, - "GetImportJobsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetImportJobsResponse" : { - "type" : "structure", - "members" : { - "ImportJobsResponse" : { - "shape" : "ImportJobsResponse" - } - }, - "required" : [ "ImportJobsResponse" ], - "payload" : "ImportJobsResponse" - }, - "GetSegmentExportJobsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "SegmentId", "ApplicationId" ] - }, - "GetSegmentExportJobsResponse" : { - "type" : "structure", - "members" : { - "ExportJobsResponse" : { - "shape" : "ExportJobsResponse" - } - }, - "required" : [ "ExportJobsResponse" ], - "payload" : "ExportJobsResponse" - }, - "GetSegmentImportJobsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "SegmentId", "ApplicationId" ] - }, - "GetSegmentImportJobsResponse" : { - "type" : "structure", - "members" : { - "ImportJobsResponse" : { - "shape" : "ImportJobsResponse" - } - }, - "required" : [ "ImportJobsResponse" ], - "payload" : "ImportJobsResponse" - }, - "GetSegmentRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - } - }, - "required" : [ "SegmentId", "ApplicationId" ] - }, - "GetSegmentResponse" : { - "type" : "structure", - "members" : { - "SegmentResponse" : { - "shape" : "SegmentResponse" - } - }, - "required" : [ "SegmentResponse" ], - "payload" : "SegmentResponse" - }, - "GetSegmentVersionRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - }, - "Version" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "version", - "documentation" : "The segment version." - } - }, - "required" : [ "SegmentId", "Version", "ApplicationId" ] - }, - "GetSegmentVersionResponse" : { - "type" : "structure", - "members" : { - "SegmentResponse" : { - "shape" : "SegmentResponse" - } - }, - "required" : [ "SegmentResponse" ], - "payload" : "SegmentResponse" - }, - "GetSegmentVersionsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "SegmentId", "ApplicationId" ] - }, - "GetSegmentVersionsResponse" : { - "type" : "structure", - "members" : { - "SegmentsResponse" : { - "shape" : "SegmentsResponse" - } - }, - "required" : [ "SegmentsResponse" ], - "payload" : "SegmentsResponse" - }, - "GetSegmentsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "PageSize" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "page-size", - "documentation" : "The number of entries you want on each page in the response." - }, - "Token" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "token", - "documentation" : "The NextToken string returned on a previous page that you use to get the next page of results in a paginated response." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetSegmentsResponse" : { - "type" : "structure", - "members" : { - "SegmentsResponse" : { - "shape" : "SegmentsResponse" - } - }, - "required" : [ "SegmentsResponse" ], - "payload" : "SegmentsResponse" - }, - "GetSmsChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId" ] - }, - "GetSmsChannelResponse" : { - "type" : "structure", - "members" : { - "SMSChannelResponse" : { - "shape" : "SMSChannelResponse" - } - }, - "required" : [ "SMSChannelResponse" ], - "payload" : "SMSChannelResponse" - }, - "GetUserEndpointsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "UserId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "user-id", - "documentation" : "The unique ID of the user." - } - }, - "required" : [ "ApplicationId", "UserId" ] - }, - "GetUserEndpointsResponse" : { - "type" : "structure", - "members" : { - "EndpointsResponse" : { - "shape" : "EndpointsResponse" - } - }, - "required" : [ "EndpointsResponse" ], - "payload" : "EndpointsResponse" - }, - "ImportJobRequest" : { - "type" : "structure", - "members" : { - "DefineSegment" : { - "shape" : "__boolean", - "documentation" : "Sets whether the endpoints create a segment when they are imported." - }, - "ExternalId" : { - "shape" : "__string", - "documentation" : "(Deprecated) Your AWS account ID, which you assigned to the ExternalID key in an IAM trust policy. Used by Amazon Pinpoint to assume an IAM role. This requirement is removed, and external IDs are not recommended for IAM roles assumed by Amazon Pinpoint." - }, - "Format" : { - "shape" : "Format", - "documentation" : "The format of the files that contain the endpoint definitions.\nValid values: CSV, JSON" - }, - "RegisterEndpoints" : { - "shape" : "__boolean", - "documentation" : "Sets whether the endpoints are registered with Amazon Pinpoint when they are imported." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the Amazon S3 location that contains the endpoints to import." - }, - "S3Url" : { - "shape" : "__string", - "documentation" : "The URL of the S3 bucket that contains the segment information to import. The location can be a folder or a single file. The URL should use the following format: s3://bucket-name/folder-name/file-name\n\nAmazon Pinpoint imports endpoints from this location and any subfolders it contains." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to update if the import job is meant to update an existing segment." - }, - "SegmentName" : { - "shape" : "__string", - "documentation" : "A custom name for the segment created by the import job. Use if DefineSegment is true." - } - }, - "documentation" : "Import job request.", - "required" : [ ] - }, - "ImportJobResource" : { - "type" : "structure", - "members" : { - "DefineSegment" : { - "shape" : "__boolean", - "documentation" : "Sets whether the endpoints create a segment when they are imported." - }, - "ExternalId" : { - "shape" : "__string", - "documentation" : "(Deprecated) Your AWS account ID, which you assigned to the ExternalID key in an IAM trust policy. Used by Amazon Pinpoint to assume an IAM role. This requirement is removed, and external IDs are not recommended for IAM roles assumed by Amazon Pinpoint." - }, - "Format" : { - "shape" : "Format", - "documentation" : "The format of the files that contain the endpoint definitions.\nValid values: CSV, JSON" - }, - "RegisterEndpoints" : { - "shape" : "__boolean", - "documentation" : "Sets whether the endpoints are registered with Amazon Pinpoint when they are imported." - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the Amazon S3 location that contains the endpoints to import." - }, - "S3Url" : { - "shape" : "__string", - "documentation" : "The URL of the S3 bucket that contains the segment information to import. The location can be a folder or a single file. The URL should use the following format: s3://bucket-name/folder-name/file-name\n\nAmazon Pinpoint imports endpoints from this location and any subfolders it contains." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to update if the import job is meant to update an existing segment." - }, - "SegmentName" : { - "shape" : "__string", - "documentation" : "A custom name for the segment created by the import job. Use if DefineSegment is true." - } - }, - "documentation" : "Import job resource", - "required" : [ ] - }, - "ImportJobResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID of the application to which the import job applies." - }, - "CompletedPieces" : { - "shape" : "__integer", - "documentation" : "The number of pieces that have successfully imported as of the time of the request." - }, - "CompletionDate" : { - "shape" : "__string", - "documentation" : "The date the import job completed in ISO 8601 format." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date the import job was created in ISO 8601 format." - }, - "Definition" : { - "shape" : "ImportJobResource", - "documentation" : "The import job settings." - }, - "FailedPieces" : { - "shape" : "__integer", - "documentation" : "The number of pieces that have failed to import as of the time of the request." - }, - "Failures" : { - "shape" : "ListOf__string", - "documentation" : "Provides up to 100 of the first failed entries for the job, if any exist." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique ID of the import job." - }, - "JobStatus" : { - "shape" : "JobStatus", - "documentation" : "The status of the import job.\nValid values: CREATED, INITIALIZING, PROCESSING, COMPLETING, COMPLETED, FAILING, FAILED\n\nThe job status is FAILED if one or more pieces failed to import." - }, - "TotalFailures" : { - "shape" : "__integer", - "documentation" : "The number of endpoints that failed to import; for example, because of syntax errors." - }, - "TotalPieces" : { - "shape" : "__integer", - "documentation" : "The total number of pieces that must be imported to finish the job. Each piece is an approximately equal portion of the endpoints to import." - }, - "TotalProcessed" : { - "shape" : "__integer", - "documentation" : "The number of endpoints that were processed by the import job." - }, - "Type" : { - "shape" : "__string", - "documentation" : "The job type. Will be Import." - } - }, - "documentation" : "Import job response.", - "required" : [ ] - }, - "ImportJobsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfImportJobResponse", - "documentation" : "A list of import jobs for the application." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "The string that you use in a subsequent request to get the next page of results in a paginated response." - } - }, - "documentation" : "Import job list.", - "required" : [ ] - }, - "Include" : { - "type" : "string", - "enum" : [ "ALL", "ANY", "NONE" ] - }, - "InternalServerErrorException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "ItemResponse" : { - "type" : "structure", - "members" : { - "EndpointItemResponse" : { - "shape" : "EndpointItemResponse", - "documentation" : "Endpoint item response after endpoint registration" - }, - "EventsItemResponse" : { - "shape" : "MapOfEventItemResponse", - "documentation" : "Events item response is a multipart response object per event Id, with eventId as the key and EventItemResponse object as the value" - } - }, - "documentation" : "The endpoint and events combined response definition" - }, - "JobStatus" : { - "type" : "string", - "enum" : [ "CREATED", "INITIALIZING", "PROCESSING", "COMPLETING", "COMPLETED", "FAILING", "FAILED" ] - }, - "Message" : { - "type" : "structure", - "members" : { - "Action" : { - "shape" : "Action", - "documentation" : "The action that occurs if the user taps a push notification delivered by the campaign:\nOPEN_APP - Your app launches, or it becomes the foreground app if it has been sent to the background. This is the default action.\n\nDEEP_LINK - Uses deep linking features in iOS and Android to open your app and display a designated user interface within the app.\n\nURL - The default mobile browser on the user's device launches and opens a web page at the URL you specify." - }, - "Body" : { - "shape" : "__string", - "documentation" : "The message body. Can include up to 140 characters." - }, - "ImageIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to the icon image for the push notification icon, for example, the app icon." - }, - "ImageSmallIconUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to the small icon image for the push notification icon, for example, the app icon." - }, - "ImageUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to an image used in the push notification." - }, - "JsonBody" : { - "shape" : "__string", - "documentation" : "The JSON payload used for a silent push." - }, - "MediaUrl" : { - "shape" : "__string", - "documentation" : "The URL that points to the media resource, for example a .mp4 or .gif file." - }, - "RawContent" : { - "shape" : "__string", - "documentation" : "The Raw JSON formatted string to be used as the payload. This value overrides the message." - }, - "SilentPush" : { - "shape" : "__boolean", - "documentation" : "Indicates if the message should display on the users device.\n\nSilent pushes can be used for Remote Configuration and Phone Home use cases. " - }, - "TimeToLive" : { - "shape" : "__integer", - "documentation" : "This parameter specifies how long (in seconds) the message should be kept if the service is unable to deliver the notification the first time. If the value is 0, it treats the notification as if it expires immediately and does not store the notification or attempt to redeliver it. This value is converted to the expiration field when sent to the service. It only applies to APNs and GCM" - }, - "Title" : { - "shape" : "__string", - "documentation" : "The message title that displays above the message on the user's device." - }, - "Url" : { - "shape" : "__string", - "documentation" : "The URL to open in the user's mobile browser. Used if the value for Action is URL." - } - }, - "documentation" : "Message to send", - "required" : [ ] - }, - "MessageBody" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object." - }, - "MessageConfiguration" : { - "type" : "structure", - "members" : { - "ADMMessage" : { - "shape" : "Message", - "documentation" : "The message that the campaign delivers to ADM channels. Overrides the default message." - }, - "APNSMessage" : { - "shape" : "Message", - "documentation" : "The message that the campaign delivers to APNS channels. Overrides the default message." - }, - "BaiduMessage" : { - "shape" : "Message", - "documentation" : "The message that the campaign delivers to Baidu channels. Overrides the default message." - }, - "DefaultMessage" : { - "shape" : "Message", - "documentation" : "The default message for all channels." - }, - "EmailMessage" : { - "shape" : "CampaignEmailMessage", - "documentation" : "The email message configuration." - }, - "GCMMessage" : { - "shape" : "Message", - "documentation" : "The message that the campaign delivers to GCM channels. Overrides the default message." - }, - "SMSMessage" : { - "shape" : "CampaignSmsMessage", - "documentation" : "The SMS message configuration." - } - }, - "documentation" : "Message configuration for a campaign." - }, - "MessageRequest" : { - "type" : "structure", - "members" : { - "Addresses" : { - "shape" : "MapOfAddressConfiguration", - "documentation" : "A map of key-value pairs, where each key is an address and each value is an AddressConfiguration object. An address can be a push notification token, a phone number, or an email address." - }, - "Context" : { - "shape" : "MapOf__string", - "documentation" : "A map of custom attributes to attributes to be attached to the message. This payload is added to the push notification's 'data.pinpoint' object or added to the email/sms delivery receipt event attributes." - }, - "Endpoints" : { - "shape" : "MapOfEndpointSendConfiguration", - "documentation" : "A map of key-value pairs, where each key is an endpoint ID and each value is an EndpointSendConfiguration object. Within an EndpointSendConfiguration object, you can tailor the message for an endpoint by specifying message overrides or substitutions." - }, - "MessageConfiguration" : { - "shape" : "DirectMessageConfiguration", - "documentation" : "Message configuration." - }, - "TraceId" : { - "shape" : "__string", - "documentation" : "A unique ID that you can use to trace a message. This ID is visible to recipients." - } - }, - "documentation" : "Send message request.", - "required" : [ ] - }, - "MessageResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "Application id of the message." - }, - "EndpointResult" : { - "shape" : "MapOfEndpointMessageResult", - "documentation" : "A map containing a multi part response for each address, with the endpointId as the key and the result as the value." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "Original request Id for which this message was delivered." - }, - "Result" : { - "shape" : "MapOfMessageResult", - "documentation" : "A map containing a multi part response for each address, with the address as the key(Email address, phone number or push token) and the result as the value." - } - }, - "documentation" : "Send message response.", - "required" : [ ] - }, - "MessageResult" : { - "type" : "structure", - "members" : { - "DeliveryStatus" : { - "shape" : "DeliveryStatus", - "documentation" : "The delivery status of the message. Possible values:\n\nSUCCESS - The message was successfully delivered to the endpoint.\n\nTRANSIENT_FAILURE - A temporary error occurred. Amazon Pinpoint will attempt to deliver the message again later.\n\nFAILURE_PERMANENT - An error occurred when delivering the message to the endpoint. Amazon Pinpoint won't attempt to send the message again.\n\nTIMEOUT - The message couldn't be sent within the timeout period.\n\nQUIET_TIME - The local time for the endpoint was within the Quiet Hours for the campaign.\n\nDAILY_CAP - The endpoint has received the maximum number of messages it can receive within a 24-hour period.\n\nHOLDOUT - The endpoint was in a hold out treatment for the campaign.\n\nTHROTTLED - Amazon Pinpoint throttled sending to this endpoint.\n\nEXPIRED - The endpoint address is expired.\n\nCAMPAIGN_CAP - The endpoint received the maximum number of messages allowed by the campaign.\n\nSERVICE_FAILURE - A service-level failure prevented Amazon Pinpoint from delivering the message.\n\nUNKNOWN - An unknown error occurred." - }, - "MessageId" : { - "shape" : "__string", - "documentation" : "Unique message identifier associated with the message that was sent." - }, - "StatusCode" : { - "shape" : "__integer", - "documentation" : "Downstream service status code." - }, - "StatusMessage" : { - "shape" : "__string", - "documentation" : "Status message for message delivery." - }, - "UpdatedToken" : { - "shape" : "__string", - "documentation" : "If token was updated as part of delivery. (This is GCM Specific)" - } - }, - "documentation" : "The result from sending a message to an address.", - "required" : [ ] - }, - "MessageType" : { - "type" : "string", - "enum" : [ "TRANSACTIONAL", "PROMOTIONAL" ] - }, - "MethodNotAllowedException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 405 - } - }, - "MetricDimension" : { - "type" : "structure", - "members" : { - "ComparisonOperator" : { - "shape" : "__string", - "documentation" : "GREATER_THAN | LESS_THAN | GREATER_THAN_OR_EQUAL | LESS_THAN_OR_EQUAL | EQUAL" - }, - "Value" : { - "shape" : "__double", - "documentation" : "Value to be compared." - } - }, - "documentation" : "Custom metric dimension" - }, - "Mode" : { - "type" : "string", - "enum" : [ "DELIVERY", "FILTER" ] - }, - "NotFoundException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 404 - } - }, - "NumberValidateRequest" : { - "type" : "structure", - "members" : { - "IsoCountryCode" : { - "shape" : "__string", - "documentation" : "(Optional) The two-character ISO country code for the country or region where the phone number was originally registered." - }, - "PhoneNumber" : { - "shape" : "__string", - "documentation" : "The phone number to get information about. The phone number that you provide should include a country code. If the number doesn't include a valid country code, the operation might result in an error." - } - }, - "documentation" : "Phone Number Information request." - }, - "NumberValidateResponse" : { - "type" : "structure", - "members" : { - "Carrier" : { - "shape" : "__string", - "documentation" : "The carrier or servive provider that the phone number is currently registered with." - }, - "City" : { - "shape" : "__string", - "documentation" : "The city where the phone number was originally registered." - }, - "CleansedPhoneNumberE164" : { - "shape" : "__string", - "documentation" : "The cleansed phone number, shown in E.164 format." - }, - "CleansedPhoneNumberNational" : { - "shape" : "__string", - "documentation" : "The cleansed phone number, shown in the local phone number format." - }, - "Country" : { - "shape" : "__string", - "documentation" : "The country or region where the phone number was originally registered." - }, - "CountryCodeIso2" : { - "shape" : "__string", - "documentation" : "The two-character ISO code for the country or region where the phone number was originally registered." - }, - "CountryCodeNumeric" : { - "shape" : "__string", - "documentation" : "The numeric code for the country or region where the phone number was originally registered." - }, - "County" : { - "shape" : "__string", - "documentation" : "The county where the phone number was originally registered." - }, - "OriginalCountryCodeIso2" : { - "shape" : "__string", - "documentation" : "The two-character ISO code for the country or region that you included in the request body." - }, - "OriginalPhoneNumber" : { - "shape" : "__string", - "documentation" : "The phone number that you included in the request body." - }, - "PhoneType" : { - "shape" : "__string", - "documentation" : "A description of the phone type. Possible values are MOBILE, LANDLINE, VOIP, INVALID, PREPAID, and OTHER." - }, - "PhoneTypeCode" : { - "shape" : "__integer", - "documentation" : "The phone type, represented by an integer. Possible values include 0 (MOBILE), 1 (LANDLINE), 2 (VOIP), 3 (INVALID), 4 (OTHER), and 5 (PREPAID)." - }, - "Timezone" : { - "shape" : "__string", - "documentation" : "The time zone for the location where the phone number was originally registered." - }, - "ZipCode" : { - "shape" : "__string", - "documentation" : "The postal code for the location where the phone number was originally registered." - } - }, - "documentation" : "Phone Number Information response." - }, - "PhoneNumberValidateRequest" : { - "type" : "structure", - "members" : { - "NumberValidateRequest" : { - "shape" : "NumberValidateRequest" - } - }, - "required" : [ "NumberValidateRequest" ], - "payload" : "NumberValidateRequest" - }, - "PhoneNumberValidateResponse" : { - "type" : "structure", - "members" : { - "NumberValidateResponse" : { - "shape" : "NumberValidateResponse" - } - }, - "required" : [ "NumberValidateResponse" ], - "payload" : "NumberValidateResponse" - }, - "PublicEndpoint" : { - "type" : "structure", - "members" : { - "Address" : { - "shape" : "__string", - "documentation" : "The unique identifier for the recipient. For example, an address could be a device token or an endpoint ID." - }, - "Attributes" : { - "shape" : "MapOfListOf__string", - "documentation" : "Custom attributes that your app reports to Amazon Pinpoint. You can use these attributes as selection criteria when you create a segment." - }, - "ChannelType" : { - "shape" : "ChannelType", - "documentation" : "The channel type.\n\nValid values: APNS, GCM" - }, - "Demographic" : { - "shape" : "EndpointDemographic", - "documentation" : "The endpoint demographic attributes." - }, - "EffectiveDate" : { - "shape" : "__string", - "documentation" : "The date and time when the endpoint was last updated." - }, - "EndpointStatus" : { - "shape" : "__string", - "documentation" : "The status of the endpoint. If the update fails, the value is INACTIVE. If the endpoint is updated successfully, the value is ACTIVE." - }, - "Location" : { - "shape" : "EndpointLocation", - "documentation" : "The endpoint location attributes." - }, - "Metrics" : { - "shape" : "MapOf__double", - "documentation" : "Custom metrics that your app reports to Amazon Pinpoint." - }, - "OptOut" : { - "shape" : "__string", - "documentation" : "Indicates whether a user has opted out of receiving messages with one of the following values:\n\nALL - User has opted out of all messages.\n\nNONE - Users has not opted out and receives all messages." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "A unique identifier that is generated each time the endpoint is updated." - }, - "User" : { - "shape" : "EndpointUser", - "documentation" : "Custom user-specific attributes that your app reports to Amazon Pinpoint." - } - }, - "documentation" : "Public endpoint attributes." - }, - "PutEventStreamRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "WriteEventStream" : { - "shape" : "WriteEventStream" - } - }, - "required" : [ "ApplicationId", "WriteEventStream" ], - "payload" : "WriteEventStream" - }, - "PutEventStreamResponse" : { - "type" : "structure", - "members" : { - "EventStream" : { - "shape" : "EventStream" - } - }, - "required" : [ "EventStream" ], - "payload" : "EventStream" - }, - "PutEventsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EventsRequest" : { - "shape" : "EventsRequest" - } - }, - "required" : [ "ApplicationId", "EventsRequest" ], - "payload" : "EventsRequest" - }, - "PutEventsResponse" : { - "type" : "structure", - "members" : { - "EventsResponse" : { - "shape" : "EventsResponse" - } - }, - "required" : [ "EventsResponse" ], - "payload" : "EventsResponse" - }, - "QuietTime" : { - "type" : "structure", - "members" : { - "End" : { - "shape" : "__string", - "documentation" : "The default end time for quiet time in ISO 8601 format." - }, - "Start" : { - "shape" : "__string", - "documentation" : "The default start time for quiet time in ISO 8601 format." - } - }, - "documentation" : "Quiet Time" - }, - "RecencyDimension" : { - "type" : "structure", - "members" : { - "Duration" : { - "shape" : "Duration", - "documentation" : "The length of time during which users have been active or inactive with your app.\nValid values: HR_24, DAY_7, DAY_14, DAY_30" - }, - "RecencyType" : { - "shape" : "RecencyType", - "documentation" : "The recency dimension type:\nACTIVE - Users who have used your app within the specified duration are included in the segment.\nINACTIVE - Users who have not used your app within the specified duration are included in the segment." - } - }, - "documentation" : "Define how a segment based on recency of use.", - "required" : [ ] - }, - "RecencyType" : { - "type" : "string", - "enum" : [ "ACTIVE", "INACTIVE" ] - }, - "RemoveAttributesRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "AttributeType" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "attribute-type", - "documentation" : "Type of attribute. Can be endpoint-custom-attributes, endpoint-custom-metrics, endpoint-user-attributes." - }, - "UpdateAttributesRequest" : { - "shape" : "UpdateAttributesRequest" - } - }, - "required" : [ "AttributeType", "ApplicationId", "UpdateAttributesRequest" ], - "payload" : "UpdateAttributesRequest" - }, - "RemoveAttributesResponse" : { - "type" : "structure", - "members" : { - "AttributesResource" : { - "shape" : "AttributesResource" - } - }, - "required" : [ "AttributesResource" ], - "payload" : "AttributesResource" - }, - "SMSChannelRequest" : { - "type" : "structure", - "members" : { - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "SenderId" : { - "shape" : "__string", - "documentation" : "Sender identifier of your messages." - }, - "ShortCode" : { - "shape" : "__string", - "documentation" : "ShortCode registered with phone provider." - } - }, - "documentation" : "SMS Channel Request", - "required" : [ ] - }, - "SMSChannelResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID of the application to which the SMS channel belongs." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date that the settings were last updated in ISO 8601 format." - }, - "Enabled" : { - "shape" : "__boolean", - "documentation" : "If the channel is enabled for sending messages." - }, - "HasCredential" : { - "shape" : "__boolean", - "documentation" : "Not used. Retained for backwards compatibility." - }, - "Id" : { - "shape" : "__string", - "documentation" : "Channel ID. Not used, only for backwards compatibility." - }, - "IsArchived" : { - "shape" : "__boolean", - "documentation" : "Is this channel archived" - }, - "LastModifiedBy" : { - "shape" : "__string", - "documentation" : "Who last updated this entry" - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "Last date this was updated" - }, - "Platform" : { - "shape" : "__string", - "documentation" : "Platform type. Will be \"SMS\"" - }, - "PromotionalMessagesPerSecond" : { - "shape" : "__integer", - "documentation" : "Promotional messages per second that can be sent" - }, - "SenderId" : { - "shape" : "__string", - "documentation" : "Sender identifier of your messages." - }, - "ShortCode" : { - "shape" : "__string", - "documentation" : "The short code registered with the phone provider." - }, - "TransactionalMessagesPerSecond" : { - "shape" : "__integer", - "documentation" : "Transactional messages per second that can be sent" - }, - "Version" : { - "shape" : "__integer", - "documentation" : "Version of channel" - } - }, - "documentation" : "SMS Channel Response.", - "required" : [ ] - }, - "SMSMessage" : { - "type" : "structure", - "members" : { - "Body" : { - "shape" : "__string", - "documentation" : "The body of the SMS message." - }, - "Keyword" : { - "shape" : "__string", - "documentation" : "The SMS program name that you provided to AWS Support when you requested your dedicated number." - }, - "MessageType" : { - "shape" : "MessageType", - "documentation" : "Is this a transaction priority message or lower priority." - }, - "OriginationNumber" : { - "shape" : "__string", - "documentation" : "The phone number that the SMS message originates from. Specify one of the dedicated long codes or short codes that you requested from AWS Support and that is assigned to your account. If this attribute is not specified, Amazon Pinpoint randomly assigns a long code." - }, - "SenderId" : { - "shape" : "__string", - "documentation" : "The sender ID that is shown as the message sender on the recipient's device. Support for sender IDs varies by country or region." - }, - "Substitutions" : { - "shape" : "MapOfListOf__string", - "documentation" : "Default message substitutions. Can be overridden by individual address substitutions." - } - }, - "documentation" : "SMS Message." - }, - "Schedule" : { - "type" : "structure", - "members" : { - "EndTime" : { - "shape" : "__string", - "documentation" : "The scheduled time that the campaign ends in ISO 8601 format." - }, - "Frequency" : { - "shape" : "Frequency", - "documentation" : "How often the campaign delivers messages.\n\nValid values: ONCE, HOURLY, DAILY, WEEKLY, MONTHLY" - }, - "IsLocalTime" : { - "shape" : "__boolean", - "documentation" : "Indicates whether the campaign schedule takes effect according to each user's local time." - }, - "QuietTime" : { - "shape" : "QuietTime", - "documentation" : "The time during which the campaign sends no messages." - }, - "StartTime" : { - "shape" : "__string", - "documentation" : "The scheduled time that the campaign begins in ISO 8601 format." - }, - "Timezone" : { - "shape" : "__string", - "documentation" : "The starting UTC offset for the schedule if the value for isLocalTime is true\n\nValid values: \nUTC\nUTC+01\nUTC+02\nUTC+03\nUTC+03:30\nUTC+04\nUTC+04:30\nUTC+05\nUTC+05:30\nUTC+05:45\nUTC+06\nUTC+06:30\nUTC+07\nUTC+08\nUTC+09\nUTC+09:30\nUTC+10\nUTC+10:30\nUTC+11\nUTC+12\nUTC+13\nUTC-02\nUTC-03\nUTC-04\nUTC-05\nUTC-06\nUTC-07\nUTC-08\nUTC-09\nUTC-10\nUTC-11" - } - }, - "documentation" : "Shcedule that defines when a campaign is run.", - "required" : [ ] - }, - "SegmentBehaviors" : { - "type" : "structure", - "members" : { - "Recency" : { - "shape" : "RecencyDimension", - "documentation" : "The recency of use." - } - }, - "documentation" : "Segment behavior dimensions" - }, - "SegmentDemographics" : { - "type" : "structure", - "members" : { - "AppVersion" : { - "shape" : "SetDimension", - "documentation" : "The app version criteria for the segment." - }, - "Channel" : { - "shape" : "SetDimension", - "documentation" : "The channel criteria for the segment." - }, - "DeviceType" : { - "shape" : "SetDimension", - "documentation" : "The device type criteria for the segment." - }, - "Make" : { - "shape" : "SetDimension", - "documentation" : "The device make criteria for the segment." - }, - "Model" : { - "shape" : "SetDimension", - "documentation" : "The device model criteria for the segment." - }, - "Platform" : { - "shape" : "SetDimension", - "documentation" : "The device platform criteria for the segment." - } - }, - "documentation" : "Segment demographic dimensions" - }, - "SegmentDimensions" : { - "type" : "structure", - "members" : { - "Attributes" : { - "shape" : "MapOfAttributeDimension", - "documentation" : "Custom segment attributes." - }, - "Behavior" : { - "shape" : "SegmentBehaviors", - "documentation" : "The segment behaviors attributes." - }, - "Demographic" : { - "shape" : "SegmentDemographics", - "documentation" : "The segment demographics attributes." - }, - "Location" : { - "shape" : "SegmentLocation", - "documentation" : "The segment location attributes." - }, - "Metrics" : { - "shape" : "MapOfMetricDimension", - "documentation" : "Custom segment metrics." - }, - "UserAttributes" : { - "shape" : "MapOfAttributeDimension", - "documentation" : "Custom segment user attributes." - } - }, - "documentation" : "Segment dimensions" - }, - "SegmentGroup" : { - "type" : "structure", - "members" : { - "Dimensions" : { - "shape" : "ListOfSegmentDimensions", - "documentation" : "List of dimensions to include or exclude." - }, - "SourceSegments" : { - "shape" : "ListOfSegmentReference", - "documentation" : "The base segment that you build your segment on. The source segment defines the starting \"universe\" of endpoints. When you add dimensions to the segment, it filters the source segment based on the dimensions that you specify. You can specify more than one dimensional segment. You can only specify one imported segment." - }, - "SourceType" : { - "shape" : "SourceType", - "documentation" : "Specify how to handle multiple source segments. For example, if you specify three source segments, should the resulting segment be based on any or all of the segments? Acceptable values: ANY or ALL." - }, - "Type" : { - "shape" : "Type", - "documentation" : "Specify how to handle multiple segment dimensions. For example, if you specify three dimensions, should the resulting segment include endpoints that are matched by all, any, or none of the dimensions? Acceptable values: ALL, ANY, or NONE." - } - }, - "documentation" : "Segment group definition.", - "required" : [ ] - }, - "SegmentGroupList" : { - "type" : "structure", - "members" : { - "Groups" : { - "shape" : "ListOfSegmentGroup", - "documentation" : "A set of segment criteria to evaluate." - }, - "Include" : { - "shape" : "Include", - "documentation" : "Specify how to handle multiple segment groups. For example, if the segment includes three segment groups, should the resulting segment include endpoints that are matched by all, any, or none of the segment groups you created. Acceptable values: ALL, ANY, or NONE." - } - }, - "documentation" : "Segment group definition.", - "required" : [ ] - }, - "SegmentImportResource" : { - "type" : "structure", - "members" : { - "ChannelCounts" : { - "shape" : "MapOf__integer", - "documentation" : "The number of channel types in the imported segment." - }, - "ExternalId" : { - "shape" : "__string", - "documentation" : "(Deprecated) Your AWS account ID, which you assigned to the ExternalID key in an IAM trust policy. Used by Amazon Pinpoint to assume an IAM role. This requirement is removed, and external IDs are not recommended for IAM roles assumed by Amazon Pinpoint." - }, - "Format" : { - "shape" : "Format", - "documentation" : "The format of the endpoint files that were imported to create this segment.\nValid values: CSV, JSON" - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of an IAM role that grants Amazon Pinpoint access to the endpoints in Amazon S3." - }, - "S3Url" : { - "shape" : "__string", - "documentation" : "The URL of the S3 bucket that the segment was imported from." - }, - "Size" : { - "shape" : "__integer", - "documentation" : "The number of endpoints that were successfully imported to create this segment." - } - }, - "documentation" : "Segment import definition.", - "required" : [ ] - }, - "SegmentLocation" : { - "type" : "structure", - "members" : { - "Country" : { - "shape" : "SetDimension", - "documentation" : "The country filter according to ISO 3166-1 Alpha-2 codes." - }, - "GPSPoint" : { - "shape" : "GPSPointDimension", - "documentation" : "The GPS Point dimension." - } - }, - "documentation" : "Segment location dimensions" - }, - "SegmentReference" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "documentation" : "A unique identifier for the segment." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "If specified contains a specific version of the segment included." - } - }, - "documentation" : "Segment reference." - }, - "SegmentResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The ID of the application that the segment applies to." - }, - "CreationDate" : { - "shape" : "__string", - "documentation" : "The date and time when the segment was created." - }, - "Dimensions" : { - "shape" : "SegmentDimensions", - "documentation" : "The segment dimensions attributes." - }, - "Id" : { - "shape" : "__string", - "documentation" : "The unique segment ID." - }, - "ImportDefinition" : { - "shape" : "SegmentImportResource", - "documentation" : "The import job settings." - }, - "LastModifiedDate" : { - "shape" : "__string", - "documentation" : "The date and time when the segment was last modified." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of the segment." - }, - "SegmentGroups" : { - "shape" : "SegmentGroupList", - "documentation" : "A segment group, which consists of zero or more source segments, plus dimensions that are applied to those source segments." - }, - "SegmentType" : { - "shape" : "SegmentType", - "documentation" : "The segment type:\nDIMENSIONAL - A dynamic segment built from selection criteria based on endpoint data reported by your app. You create this type of segment by using the segment builder in the Amazon Pinpoint console or by making a POST request to the segments resource.\nIMPORT - A static segment built from an imported set of endpoint definitions. You create this type of segment by importing a segment in the Amazon Pinpoint console or by making a POST request to the jobs/import resource." - }, - "Version" : { - "shape" : "__integer", - "documentation" : "The segment version number." - } - }, - "documentation" : "Segment definition.", - "required" : [ ] - }, - "SegmentType" : { - "type" : "string", - "enum" : [ "DIMENSIONAL", "IMPORT" ] - }, - "SegmentsResponse" : { - "type" : "structure", - "members" : { - "Item" : { - "shape" : "ListOfSegmentResponse", - "documentation" : "The list of segments." - }, - "NextToken" : { - "shape" : "__string", - "documentation" : "An identifier used to retrieve the next page of results. The token is null if no additional pages exist." - } - }, - "documentation" : "Segments in your account.", - "required" : [ ] - }, - "SendMessagesRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "MessageRequest" : { - "shape" : "MessageRequest" - } - }, - "required" : [ "ApplicationId", "MessageRequest" ], - "payload" : "MessageRequest" - }, - "SendMessagesResponse" : { - "type" : "structure", - "members" : { - "MessageResponse" : { - "shape" : "MessageResponse" - } - }, - "required" : [ "MessageResponse" ], - "payload" : "MessageResponse" - }, - "SendUsersMessageRequest" : { - "type" : "structure", - "members" : { - "Context" : { - "shape" : "MapOf__string", - "documentation" : "A map of custom attribute-value pairs. Amazon Pinpoint adds these attributes to the data.pinpoint object in the body of the push notification payload. Amazon Pinpoint also provides these attributes in the events that it generates for users-messages deliveries." - }, - "MessageConfiguration" : { - "shape" : "DirectMessageConfiguration", - "documentation" : "Message definitions for the default message and any messages that are tailored for specific channels." - }, - "TraceId" : { - "shape" : "__string", - "documentation" : "A unique ID that you can use to trace a message. This ID is visible to recipients." - }, - "Users" : { - "shape" : "MapOfEndpointSendConfiguration", - "documentation" : "A map that associates user IDs with EndpointSendConfiguration objects. Within an EndpointSendConfiguration object, you can tailor the message for a user by specifying message overrides or substitutions." - } - }, - "documentation" : "Send message request.", - "required" : [ ] - }, - "SendUsersMessageResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "documentation" : "The unique ID of the Amazon Pinpoint project used to send the message." - }, - "RequestId" : { - "shape" : "__string", - "documentation" : "The unique ID assigned to the users-messages request." - }, - "Result" : { - "shape" : "MapOfMapOfEndpointMessageResult", - "documentation" : "An object that shows the endpoints that were messaged for each user. The object provides a list of user IDs. For each user ID, it provides the endpoint IDs that were messaged. For each endpoint ID, it provides an EndpointMessageResult object." - } - }, - "documentation" : "User send message response.", - "required" : [ ] - }, - "SendUsersMessagesRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SendUsersMessageRequest" : { - "shape" : "SendUsersMessageRequest" - } - }, - "required" : [ "ApplicationId", "SendUsersMessageRequest" ], - "payload" : "SendUsersMessageRequest" - }, - "SendUsersMessagesResponse" : { - "type" : "structure", - "members" : { - "SendUsersMessageResponse" : { - "shape" : "SendUsersMessageResponse" - } - }, - "required" : [ "SendUsersMessageResponse" ], - "payload" : "SendUsersMessageResponse" - }, - "Session" : { - "type" : "structure", - "members" : { - "Duration" : { - "shape" : "__integer", - "documentation" : "Session duration in millis" - }, - "Id" : { - "shape" : "__string", - "documentation" : "A unique identifier for the session." - }, - "StartTimestamp" : { - "shape" : "__string", - "documentation" : "The date and time when the session began." - }, - "StopTimestamp" : { - "shape" : "__string", - "documentation" : "The date and time when the session ended." - } - }, - "documentation" : "Information about a session.", - "required" : [ ] - }, - "SetDimension" : { - "type" : "structure", - "members" : { - "DimensionType" : { - "shape" : "DimensionType", - "documentation" : "The type of dimension:\nINCLUSIVE - Endpoints that match the criteria are included in the segment.\nEXCLUSIVE - Endpoints that match the criteria are excluded from the segment." - }, - "Values" : { - "shape" : "ListOf__string", - "documentation" : "The criteria values for the segment dimension. Endpoints with matching attribute values are included or excluded from the segment, depending on the setting for Type." - } - }, - "documentation" : "Dimension specification of a segment.", - "required" : [ ] - }, - "SourceType" : { - "type" : "string", - "enum" : [ "ALL", "ANY", "NONE" ] - }, - "TooManyRequestsException" : { - "type" : "structure", - "members" : { - "Message" : { - "shape" : "__string", - "documentation" : "The error message that's returned from the API." - }, - "RequestID" : { - "shape" : "__string", - "documentation" : "The unique message body ID." - } - }, - "documentation" : "Simple message object.", - "exception" : true, - "error" : { - "httpStatusCode" : 429 - } - }, - "TreatmentResource" : { - "type" : "structure", - "members" : { - "Id" : { - "shape" : "__string", - "documentation" : "The unique treatment ID." - }, - "MessageConfiguration" : { - "shape" : "MessageConfiguration", - "documentation" : "The message configuration settings." - }, - "Schedule" : { - "shape" : "Schedule", - "documentation" : "The campaign schedule." - }, - "SizePercent" : { - "shape" : "__integer", - "documentation" : "The allocated percentage of users for this treatment." - }, - "State" : { - "shape" : "CampaignState", - "documentation" : "The treatment status." - }, - "TreatmentDescription" : { - "shape" : "__string", - "documentation" : "A custom description for the treatment." - }, - "TreatmentName" : { - "shape" : "__string", - "documentation" : "The custom name of a variation of the campaign used for A/B testing." - } - }, - "documentation" : "Treatment resource", - "required" : [ ] - }, - "Type" : { - "type" : "string", - "enum" : [ "ALL", "ANY", "NONE" ] - }, - "UpdateAdmChannelRequest" : { - "type" : "structure", - "members" : { - "ADMChannelRequest" : { - "shape" : "ADMChannelRequest" - }, - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId", "ADMChannelRequest" ], - "payload" : "ADMChannelRequest" - }, - "UpdateAdmChannelResponse" : { - "type" : "structure", - "members" : { - "ADMChannelResponse" : { - "shape" : "ADMChannelResponse" - } - }, - "required" : [ "ADMChannelResponse" ], - "payload" : "ADMChannelResponse" - }, - "UpdateApnsChannelRequest" : { - "type" : "structure", - "members" : { - "APNSChannelRequest" : { - "shape" : "APNSChannelRequest" - }, - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId", "APNSChannelRequest" ], - "payload" : "APNSChannelRequest" - }, - "UpdateApnsChannelResponse" : { - "type" : "structure", - "members" : { - "APNSChannelResponse" : { - "shape" : "APNSChannelResponse" - } - }, - "required" : [ "APNSChannelResponse" ], - "payload" : "APNSChannelResponse" - }, - "UpdateApnsSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "APNSSandboxChannelRequest" : { - "shape" : "APNSSandboxChannelRequest" - }, - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId", "APNSSandboxChannelRequest" ], - "payload" : "APNSSandboxChannelRequest" - }, - "UpdateApnsSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSSandboxChannelResponse" : { - "shape" : "APNSSandboxChannelResponse" - } - }, - "required" : [ "APNSSandboxChannelResponse" ], - "payload" : "APNSSandboxChannelResponse" - }, - "UpdateApnsVoipChannelRequest" : { - "type" : "structure", - "members" : { - "APNSVoipChannelRequest" : { - "shape" : "APNSVoipChannelRequest" - }, - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId", "APNSVoipChannelRequest" ], - "payload" : "APNSVoipChannelRequest" - }, - "UpdateApnsVoipChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipChannelResponse" : { - "shape" : "APNSVoipChannelResponse" - } - }, - "required" : [ "APNSVoipChannelResponse" ], - "payload" : "APNSVoipChannelResponse" - }, - "UpdateApnsVoipSandboxChannelRequest" : { - "type" : "structure", - "members" : { - "APNSVoipSandboxChannelRequest" : { - "shape" : "APNSVoipSandboxChannelRequest" - }, - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - } - }, - "required" : [ "ApplicationId", "APNSVoipSandboxChannelRequest" ], - "payload" : "APNSVoipSandboxChannelRequest" - }, - "UpdateApnsVoipSandboxChannelResponse" : { - "type" : "structure", - "members" : { - "APNSVoipSandboxChannelResponse" : { - "shape" : "APNSVoipSandboxChannelResponse" - } - }, - "required" : [ "APNSVoipSandboxChannelResponse" ], - "payload" : "APNSVoipSandboxChannelResponse" - }, - "UpdateApplicationSettingsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "WriteApplicationSettingsRequest" : { - "shape" : "WriteApplicationSettingsRequest" - } - }, - "required" : [ "ApplicationId", "WriteApplicationSettingsRequest" ], - "payload" : "WriteApplicationSettingsRequest" - }, - "UpdateApplicationSettingsResponse" : { - "type" : "structure", - "members" : { - "ApplicationSettingsResource" : { - "shape" : "ApplicationSettingsResource" - } - }, - "required" : [ "ApplicationSettingsResource" ], - "payload" : "ApplicationSettingsResource" - }, - "UpdateAttributesRequest" : { - "type" : "structure", - "members" : { - "Blacklist" : { - "shape" : "ListOf__string", - "documentation" : "The GLOB wildcard for removing the attributes in the application" - } - }, - "documentation" : "Update attributes request" - }, - "UpdateBaiduChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "BaiduChannelRequest" : { - "shape" : "BaiduChannelRequest" - } - }, - "required" : [ "ApplicationId", "BaiduChannelRequest" ], - "payload" : "BaiduChannelRequest" - }, - "UpdateBaiduChannelResponse" : { - "type" : "structure", - "members" : { - "BaiduChannelResponse" : { - "shape" : "BaiduChannelResponse" - } - }, - "required" : [ "BaiduChannelResponse" ], - "payload" : "BaiduChannelResponse" - }, - "UpdateCampaignRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "CampaignId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "campaign-id", - "documentation" : "The unique ID of the campaign." - }, - "WriteCampaignRequest" : { - "shape" : "WriteCampaignRequest" - } - }, - "required" : [ "CampaignId", "ApplicationId", "WriteCampaignRequest" ], - "payload" : "WriteCampaignRequest" - }, - "UpdateCampaignResponse" : { - "type" : "structure", - "members" : { - "CampaignResponse" : { - "shape" : "CampaignResponse" - } - }, - "required" : [ "CampaignResponse" ], - "payload" : "CampaignResponse" - }, - "UpdateEmailChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EmailChannelRequest" : { - "shape" : "EmailChannelRequest" - } - }, - "required" : [ "ApplicationId", "EmailChannelRequest" ], - "payload" : "EmailChannelRequest" - }, - "UpdateEmailChannelResponse" : { - "type" : "structure", - "members" : { - "EmailChannelResponse" : { - "shape" : "EmailChannelResponse" - } - }, - "required" : [ "EmailChannelResponse" ], - "payload" : "EmailChannelResponse" - }, - "UpdateEndpointRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EndpointId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "endpoint-id", - "documentation" : "The unique ID of the endpoint." - }, - "EndpointRequest" : { - "shape" : "EndpointRequest" - } - }, - "required" : [ "ApplicationId", "EndpointId", "EndpointRequest" ], - "payload" : "EndpointRequest" - }, - "UpdateEndpointResponse" : { - "type" : "structure", - "members" : { - "MessageBody" : { - "shape" : "MessageBody" - } - }, - "required" : [ "MessageBody" ], - "payload" : "MessageBody" - }, - "UpdateEndpointsBatchRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "EndpointBatchRequest" : { - "shape" : "EndpointBatchRequest" - } - }, - "required" : [ "ApplicationId", "EndpointBatchRequest" ], - "payload" : "EndpointBatchRequest" - }, - "UpdateEndpointsBatchResponse" : { - "type" : "structure", - "members" : { - "MessageBody" : { - "shape" : "MessageBody" - } - }, - "required" : [ "MessageBody" ], - "payload" : "MessageBody" - }, - "UpdateGcmChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "GCMChannelRequest" : { - "shape" : "GCMChannelRequest" - } - }, - "required" : [ "ApplicationId", "GCMChannelRequest" ], - "payload" : "GCMChannelRequest" - }, - "UpdateGcmChannelResponse" : { - "type" : "structure", - "members" : { - "GCMChannelResponse" : { - "shape" : "GCMChannelResponse" - } - }, - "required" : [ "GCMChannelResponse" ], - "payload" : "GCMChannelResponse" - }, - "UpdateSegmentRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SegmentId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "segment-id", - "documentation" : "The unique ID of the segment." - }, - "WriteSegmentRequest" : { - "shape" : "WriteSegmentRequest" - } - }, - "required" : [ "SegmentId", "ApplicationId", "WriteSegmentRequest" ], - "payload" : "WriteSegmentRequest" - }, - "UpdateSegmentResponse" : { - "type" : "structure", - "members" : { - "SegmentResponse" : { - "shape" : "SegmentResponse" - } - }, - "required" : [ "SegmentResponse" ], - "payload" : "SegmentResponse" - }, - "UpdateSmsChannelRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "application-id", - "documentation" : "The unique ID of your Amazon Pinpoint application." - }, - "SMSChannelRequest" : { - "shape" : "SMSChannelRequest" - } - }, - "required" : [ "ApplicationId", "SMSChannelRequest" ], - "payload" : "SMSChannelRequest" - }, - "UpdateSmsChannelResponse" : { - "type" : "structure", - "members" : { - "SMSChannelResponse" : { - "shape" : "SMSChannelResponse" - } - }, - "required" : [ "SMSChannelResponse" ], - "payload" : "SMSChannelResponse" - }, - "WriteApplicationSettingsRequest" : { - "type" : "structure", - "members" : { - "CampaignHook" : { - "shape" : "CampaignHook", - "documentation" : "Default campaign hook information." - }, - "CloudWatchMetricsEnabled" : { - "shape" : "__boolean", - "documentation" : "The CloudWatchMetrics settings for the app." - }, - "Limits" : { - "shape" : "CampaignLimits", - "documentation" : "The default campaign limits for the app. These limits apply to each campaign for the app, unless the campaign overrides the default with limits of its own." - }, - "QuietTime" : { - "shape" : "QuietTime", - "documentation" : "The default quiet time for the app. Each campaign for this app sends no messages during this time unless the campaign overrides the default with a quiet time of its own." - } - }, - "documentation" : "Creating application setting request" - }, - "WriteCampaignRequest" : { - "type" : "structure", - "members" : { - "AdditionalTreatments" : { - "shape" : "ListOfWriteTreatmentResource", - "documentation" : "Treatments that are defined in addition to the default treatment." - }, - "Description" : { - "shape" : "__string", - "documentation" : "A description of the campaign." - }, - "HoldoutPercent" : { - "shape" : "__integer", - "documentation" : "The allocated percentage of end users who will not receive messages from this campaign." - }, - "Hook" : { - "shape" : "CampaignHook", - "documentation" : "Campaign hook information." - }, - "IsPaused" : { - "shape" : "__boolean", - "documentation" : "Indicates whether the campaign is paused. A paused campaign does not send messages unless you resume it by setting IsPaused to false." - }, - "Limits" : { - "shape" : "CampaignLimits", - "documentation" : "The campaign limits settings." - }, - "MessageConfiguration" : { - "shape" : "MessageConfiguration", - "documentation" : "The message configuration settings." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The custom name of the campaign." - }, - "Schedule" : { - "shape" : "Schedule", - "documentation" : "The campaign schedule." - }, - "SegmentId" : { - "shape" : "__string", - "documentation" : "The ID of the segment to which the campaign sends messages." - }, - "SegmentVersion" : { - "shape" : "__integer", - "documentation" : "The version of the segment to which the campaign sends messages." - }, - "TreatmentDescription" : { - "shape" : "__string", - "documentation" : "A custom description for the treatment." - }, - "TreatmentName" : { - "shape" : "__string", - "documentation" : "The custom name of a variation of the campaign used for A/B testing." - } - }, - "documentation" : "Used to create a campaign." - }, - "WriteEventStream" : { - "type" : "structure", - "members" : { - "DestinationStreamArn" : { - "shape" : "__string", - "documentation" : "The Amazon Resource Name (ARN) of the Amazon Kinesis stream or Firehose delivery stream to which you want to publish events.\n Firehose ARN: arn:aws:firehose:REGION:ACCOUNT_ID:deliverystream/STREAM_NAME\n Kinesis ARN: arn:aws:kinesis:REGION:ACCOUNT_ID:stream/STREAM_NAME" - }, - "RoleArn" : { - "shape" : "__string", - "documentation" : "The IAM role that authorizes Amazon Pinpoint to publish events to the stream in your account." - } - }, - "documentation" : "Request to save an EventStream.", - "required" : [ ] - }, - "WriteSegmentRequest" : { - "type" : "structure", - "members" : { - "Dimensions" : { - "shape" : "SegmentDimensions", - "documentation" : "The segment dimensions attributes." - }, - "Name" : { - "shape" : "__string", - "documentation" : "The name of segment" - }, - "SegmentGroups" : { - "shape" : "SegmentGroupList", - "documentation" : "A segment group, which consists of zero or more source segments, plus dimensions that are applied to those source segments. Your request can only include one segment group. Your request can include either a SegmentGroups object or a Dimensions object, but not both." - } - }, - "documentation" : "Segment definition.", - "required" : [ ] - }, - "WriteTreatmentResource" : { - "type" : "structure", - "members" : { - "MessageConfiguration" : { - "shape" : "MessageConfiguration", - "documentation" : "The message configuration settings." - }, - "Schedule" : { - "shape" : "Schedule", - "documentation" : "The campaign schedule." - }, - "SizePercent" : { - "shape" : "__integer", - "documentation" : "The allocated percentage of users for this treatment." - }, - "TreatmentDescription" : { - "shape" : "__string", - "documentation" : "A custom description for the treatment." - }, - "TreatmentName" : { - "shape" : "__string", - "documentation" : "The custom name of a variation of the campaign used for A/B testing." - } - }, - "documentation" : "Used to create a campaign treatment.", - "required" : [ ] - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "ListOfActivityResponse" : { - "type" : "list", - "member" : { - "shape" : "ActivityResponse" - } - }, - "ListOfApplicationResponse" : { - "type" : "list", - "member" : { - "shape" : "ApplicationResponse" - } - }, - "ListOfCampaignResponse" : { - "type" : "list", - "member" : { - "shape" : "CampaignResponse" - } - }, - "ListOfEndpointBatchItem" : { - "type" : "list", - "member" : { - "shape" : "EndpointBatchItem" - } - }, - "ListOfEndpointResponse" : { - "type" : "list", - "member" : { - "shape" : "EndpointResponse" - } - }, - "ListOfExportJobResponse" : { - "type" : "list", - "member" : { - "shape" : "ExportJobResponse" - } - }, - "ListOfImportJobResponse" : { - "type" : "list", - "member" : { - "shape" : "ImportJobResponse" - } - }, - "ListOfSegmentDimensions" : { - "type" : "list", - "member" : { - "shape" : "SegmentDimensions" - } - }, - "ListOfSegmentGroup" : { - "type" : "list", - "member" : { - "shape" : "SegmentGroup" - } - }, - "ListOfSegmentReference" : { - "type" : "list", - "member" : { - "shape" : "SegmentReference" - } - }, - "ListOfSegmentResponse" : { - "type" : "list", - "member" : { - "shape" : "SegmentResponse" - } - }, - "ListOfTreatmentResource" : { - "type" : "list", - "member" : { - "shape" : "TreatmentResource" - } - }, - "ListOfWriteTreatmentResource" : { - "type" : "list", - "member" : { - "shape" : "WriteTreatmentResource" - } - }, - "ListOf__string" : { - "type" : "list", - "member" : { - "shape" : "__string" - } - }, - "__long" : { - "type" : "long" - }, - "MapOfAddressConfiguration" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "AddressConfiguration" - } - }, - "MapOfAttributeDimension" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "AttributeDimension" - } - }, - "MapOfChannelResponse" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "ChannelResponse" - } - }, - "MapOfEndpointMessageResult" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "EndpointMessageResult" - } - }, - "MapOfEndpointSendConfiguration" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "EndpointSendConfiguration" - } - }, - "MapOfEvent" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "Event" - } - }, - "MapOfEventItemResponse" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "EventItemResponse" - } - }, - "MapOfEventsBatch" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "EventsBatch" - } - }, - "MapOfItemResponse" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "ItemResponse" - } - }, - "MapOfMessageResult" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "MessageResult" - } - }, - "MapOfMetricDimension" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "MetricDimension" - } - }, - "MapOf__double" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "__double" - } - }, - "MapOf__integer" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "__integer" - } - }, - "MapOfListOf__string" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "ListOf__string" - } - }, - "MapOfMapOfEndpointMessageResult" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "MapOfEndpointMessageResult" - } - }, - "MapOf__string" : { - "type" : "map", - "key" : { - "shape" : "__string" - }, - "value" : { - "shape" : "__string" - } - }, - "__string" : { - "type" : "string" - }, - "__timestampIso8601" : { - "type" : "timestamp", - "timestampFormat" : "iso8601" - }, - "__timestampUnix" : { - "type" : "timestamp", - "timestampFormat" : "unixTimestamp" - } - } -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/examples-1.json deleted file mode 100644 index 38205dbe..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/examples-1.json +++ /dev/null @@ -1,171 +0,0 @@ -{ - "version": "1.0", - "examples": { - "DeleteLexicon": [ - { - "input": { - "Name": "example" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes a specified pronunciation lexicon stored in an AWS Region.", - "id": "to-delete-a-lexicon-1481922498332", - "title": "To delete a lexicon" - } - ], - "DescribeVoices": [ - { - "input": { - "LanguageCode": "en-GB" - }, - "output": { - "Voices": [ - { - "Gender": "Female", - "Id": "Emma", - "LanguageCode": "en-GB", - "LanguageName": "British English", - "Name": "Emma" - }, - { - "Gender": "Male", - "Id": "Brian", - "LanguageCode": "en-GB", - "LanguageName": "British English", - "Name": "Brian" - }, - { - "Gender": "Female", - "Id": "Amy", - "LanguageCode": "en-GB", - "LanguageName": "British English", - "Name": "Amy" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns the list of voices that are available for use when requesting speech synthesis. Displayed languages are those within the specified language code. If no language code is specified, voices for all available languages are displayed.", - "id": "to-describe-available-voices-1482180557753", - "title": "To describe available voices" - } - ], - "GetLexicon": [ - { - "input": { - "Name": "" - }, - "output": { - "Lexicon": { - "Content": "\r\n\r\n \r\n W3C\r\n World Wide Web Consortium\r\n \r\n", - "Name": "example" - }, - "LexiconAttributes": { - "Alphabet": "ipa", - "LanguageCode": "en-US", - "LastModified": 1478542980.117, - "LexemesCount": 1, - "LexiconArn": "arn:aws:polly:us-east-1:123456789012:lexicon/example", - "Size": 503 - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns the content of the specified pronunciation lexicon stored in an AWS Region.", - "id": "to-retrieve-a-lexicon-1481912870836", - "title": "To retrieve a lexicon" - } - ], - "ListLexicons": [ - { - "input": { - }, - "output": { - "Lexicons": [ - { - "Attributes": { - "Alphabet": "ipa", - "LanguageCode": "en-US", - "LastModified": 1478542980.117, - "LexemesCount": 1, - "LexiconArn": "arn:aws:polly:us-east-1:123456789012:lexicon/example", - "Size": 503 - }, - "Name": "example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a list of pronunciation lexicons stored in an AWS Region.", - "id": "to-list-all-lexicons-in-a-region-1481842106487", - "title": "To list all lexicons in a region" - } - ], - "PutLexicon": [ - { - "input": { - "Content": "file://example.pls", - "Name": "W3C" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Stores a pronunciation lexicon in an AWS Region.", - "id": "to-save-a-lexicon-1482272584088", - "title": "To save a lexicon" - } - ], - "SynthesizeSpeech": [ - { - "input": { - "LexiconNames": [ - "example" - ], - "OutputFormat": "mp3", - "SampleRate": "8000", - "Text": "All Gaul is divided into three parts", - "TextType": "text", - "VoiceId": "Joanna" - }, - "output": { - "AudioStream": "TEXT", - "ContentType": "audio/mpeg", - "RequestCharacters": 37 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Synthesizes plain text or SSML into a file of human-like speech.", - "id": "to-synthesize-speech-1482186064046", - "title": "To synthesize speech" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/paginators-1.json deleted file mode 100644 index c24ff035..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/paginators-1.json +++ /dev/null @@ -1,9 +0,0 @@ -{ - "pagination": { - "DescribeVoices": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Voices" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/service-2.json deleted file mode 100644 index 8d78aed4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/polly/2016-06-10/service-2.json +++ /dev/null @@ -1,1020 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-06-10", - "endpointPrefix":"polly", - "protocol":"rest-json", - "serviceFullName":"Amazon Polly", - "serviceId":"Polly", - "signatureVersion":"v4", - "uid":"polly-2016-06-10" - }, - "operations":{ - "DeleteLexicon":{ - "name":"DeleteLexicon", - "http":{ - "method":"DELETE", - "requestUri":"/v1/lexicons/{LexiconName}", - "responseCode":200 - }, - "input":{"shape":"DeleteLexiconInput"}, - "output":{"shape":"DeleteLexiconOutput"}, - "errors":[ - {"shape":"LexiconNotFoundException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Deletes the specified pronunciation lexicon stored in an AWS Region. A lexicon which has been deleted is not available for speech synthesis, nor is it possible to retrieve it using either the GetLexicon or ListLexicon APIs.

For more information, see Managing Lexicons.

" - }, - "DescribeVoices":{ - "name":"DescribeVoices", - "http":{ - "method":"GET", - "requestUri":"/v1/voices", - "responseCode":200 - }, - "input":{"shape":"DescribeVoicesInput"}, - "output":{"shape":"DescribeVoicesOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns the list of voices that are available for use when requesting speech synthesis. Each voice speaks a specified language, is either male or female, and is identified by an ID, which is the ASCII version of the voice name.

When synthesizing speech ( SynthesizeSpeech ), you provide the voice ID for the voice you want from the list of voices returned by DescribeVoices.

For example, you want your news reader application to read news in a specific language, but giving a user the option to choose the voice. Using the DescribeVoices operation you can provide the user with a list of available voices to select from.

You can optionally specify a language code to filter the available voices. For example, if you specify en-US, the operation returns a list of all available US English voices.

This operation requires permissions to perform the polly:DescribeVoices action.

" - }, - "GetLexicon":{ - "name":"GetLexicon", - "http":{ - "method":"GET", - "requestUri":"/v1/lexicons/{LexiconName}", - "responseCode":200 - }, - "input":{"shape":"GetLexiconInput"}, - "output":{"shape":"GetLexiconOutput"}, - "errors":[ - {"shape":"LexiconNotFoundException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns the content of the specified pronunciation lexicon stored in an AWS Region. For more information, see Managing Lexicons.

" - }, - "GetSpeechSynthesisTask":{ - "name":"GetSpeechSynthesisTask", - "http":{ - "method":"GET", - "requestUri":"/v1/synthesisTasks/{TaskId}", - "responseCode":200 - }, - "input":{"shape":"GetSpeechSynthesisTaskInput"}, - "output":{"shape":"GetSpeechSynthesisTaskOutput"}, - "errors":[ - {"shape":"InvalidTaskIdException"}, - {"shape":"ServiceFailureException"}, - {"shape":"SynthesisTaskNotFoundException"} - ], - "documentation":"

Retrieves a specific SpeechSynthesisTask object based on its TaskID. This object contains information about the given speech synthesis task, including the status of the task, and a link to the S3 bucket containing the output of the task.

" - }, - "ListLexicons":{ - "name":"ListLexicons", - "http":{ - "method":"GET", - "requestUri":"/v1/lexicons", - "responseCode":200 - }, - "input":{"shape":"ListLexiconsInput"}, - "output":{"shape":"ListLexiconsOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns a list of pronunciation lexicons stored in an AWS Region. For more information, see Managing Lexicons.

" - }, - "ListSpeechSynthesisTasks":{ - "name":"ListSpeechSynthesisTasks", - "http":{ - "method":"GET", - "requestUri":"/v1/synthesisTasks", - "responseCode":200 - }, - "input":{"shape":"ListSpeechSynthesisTasksInput"}, - "output":{"shape":"ListSpeechSynthesisTasksOutput"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Returns a list of SpeechSynthesisTask objects ordered by their creation date. This operation can filter the tasks by their status, for example, allowing users to list only tasks that are completed.

" - }, - "PutLexicon":{ - "name":"PutLexicon", - "http":{ - "method":"PUT", - "requestUri":"/v1/lexicons/{LexiconName}", - "responseCode":200 - }, - "input":{"shape":"PutLexiconInput"}, - "output":{"shape":"PutLexiconOutput"}, - "errors":[ - {"shape":"InvalidLexiconException"}, - {"shape":"UnsupportedPlsAlphabetException"}, - {"shape":"UnsupportedPlsLanguageException"}, - {"shape":"LexiconSizeExceededException"}, - {"shape":"MaxLexemeLengthExceededException"}, - {"shape":"MaxLexiconsNumberExceededException"}, - {"shape":"ServiceFailureException"} - ], - "documentation":"

Stores a pronunciation lexicon in an AWS Region. If a lexicon with the same name already exists in the region, it is overwritten by the new lexicon. Lexicon operations have eventual consistency, therefore, it might take some time before the lexicon is available to the SynthesizeSpeech operation.

For more information, see Managing Lexicons.

" - }, - "StartSpeechSynthesisTask":{ - "name":"StartSpeechSynthesisTask", - "http":{ - "method":"POST", - "requestUri":"/v1/synthesisTasks", - "responseCode":200 - }, - "input":{"shape":"StartSpeechSynthesisTaskInput"}, - "output":{"shape":"StartSpeechSynthesisTaskOutput"}, - "errors":[ - {"shape":"TextLengthExceededException"}, - {"shape":"InvalidS3BucketException"}, - {"shape":"InvalidS3KeyException"}, - {"shape":"InvalidSampleRateException"}, - {"shape":"InvalidSnsTopicArnException"}, - {"shape":"InvalidSsmlException"}, - {"shape":"LexiconNotFoundException"}, - {"shape":"ServiceFailureException"}, - {"shape":"MarksNotSupportedForFormatException"}, - {"shape":"SsmlMarksNotSupportedForTextTypeException"}, - {"shape":"LanguageNotSupportedException"} - ], - "documentation":"

Allows the creation of an asynchronous synthesis task, by starting a new SpeechSynthesisTask. This operation requires all the standard information needed for speech synthesis, plus the name of an Amazon S3 bucket for the service to store the output of the synthesis task and two optional parameters (OutputS3KeyPrefix and SnsTopicArn). Once the synthesis task is created, this operation will return a SpeechSynthesisTask object, which will include an identifier of this task as well as the current status.

" - }, - "SynthesizeSpeech":{ - "name":"SynthesizeSpeech", - "http":{ - "method":"POST", - "requestUri":"/v1/speech", - "responseCode":200 - }, - "input":{"shape":"SynthesizeSpeechInput"}, - "output":{"shape":"SynthesizeSpeechOutput"}, - "errors":[ - {"shape":"TextLengthExceededException"}, - {"shape":"InvalidSampleRateException"}, - {"shape":"InvalidSsmlException"}, - {"shape":"LexiconNotFoundException"}, - {"shape":"ServiceFailureException"}, - {"shape":"MarksNotSupportedForFormatException"}, - {"shape":"SsmlMarksNotSupportedForTextTypeException"}, - {"shape":"LanguageNotSupportedException"} - ], - "documentation":"

Synthesizes UTF-8 input, plain text or SSML, to a stream of bytes. SSML input must be valid, well-formed SSML. Some alphabets might not be available with all the voices (for example, Cyrillic might not be read at all by English voices) unless phoneme mapping is used. For more information, see How it Works.

" - } - }, - "shapes":{ - "Alphabet":{"type":"string"}, - "AudioStream":{ - "type":"blob", - "streaming":true - }, - "ContentType":{"type":"string"}, - "DateTime":{"type":"timestamp"}, - "DeleteLexiconInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"LexiconName", - "documentation":"

The name of the lexicon to delete. Must be an existing lexicon in the region.

", - "location":"uri", - "locationName":"LexiconName" - } - } - }, - "DeleteLexiconOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeVoicesInput":{ - "type":"structure", - "members":{ - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language identification tag (ISO 639 code for the language name-ISO 3166 country code) for filtering the list of voices returned. If you don't specify this optional parameter, all available voices are returned.

", - "location":"querystring", - "locationName":"LanguageCode" - }, - "IncludeAdditionalLanguageCodes":{ - "shape":"IncludeAdditionalLanguageCodes", - "documentation":"

Boolean value indicating whether to return any bilingual voices that use the specified language as an additional language. For instance, if you request all languages that use US English (es-US), and there is an Italian voice that speaks both Italian (it-IT) and US English, that voice will be included if you specify yes but not if you specify no.

", - "location":"querystring", - "locationName":"IncludeAdditionalLanguageCodes" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque pagination token returned from the previous DescribeVoices operation. If present, this indicates where to continue the listing.

", - "location":"querystring", - "locationName":"NextToken" - } - } - }, - "DescribeVoicesOutput":{ - "type":"structure", - "members":{ - "Voices":{ - "shape":"VoiceList", - "documentation":"

A list of voices with their properties.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token to use in the next request to continue the listing of voices. NextToken is returned only if the response is truncated.

" - } - } - }, - "ErrorMessage":{"type":"string"}, - "Gender":{ - "type":"string", - "enum":[ - "Female", - "Male" - ] - }, - "GetLexiconInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"LexiconName", - "documentation":"

Name of the lexicon.

", - "location":"uri", - "locationName":"LexiconName" - } - } - }, - "GetLexiconOutput":{ - "type":"structure", - "members":{ - "Lexicon":{ - "shape":"Lexicon", - "documentation":"

Lexicon object that provides name and the string content of the lexicon.

" - }, - "LexiconAttributes":{ - "shape":"LexiconAttributes", - "documentation":"

Metadata of the lexicon, including phonetic alphabetic used, language code, lexicon ARN, number of lexemes defined in the lexicon, and size of lexicon in bytes.

" - } - } - }, - "GetSpeechSynthesisTaskInput":{ - "type":"structure", - "required":["TaskId"], - "members":{ - "TaskId":{ - "shape":"TaskId", - "documentation":"

The Amazon Polly generated identifier for a speech synthesis task.

", - "location":"uri", - "locationName":"TaskId" - } - } - }, - "GetSpeechSynthesisTaskOutput":{ - "type":"structure", - "members":{ - "SynthesisTask":{ - "shape":"SynthesisTask", - "documentation":"

SynthesisTask object that provides information from the requested task, including output format, creation time, task status, and so on.

" - } - } - }, - "IncludeAdditionalLanguageCodes":{"type":"boolean"}, - "InvalidLexiconException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Amazon Polly can't find the specified lexicon. Verify that the lexicon's name is spelled correctly, and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The NextToken is invalid. Verify that it's spelled correctly, and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidS3BucketException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided Amazon S3 bucket name is invalid. Please check your input with S3 bucket naming requirements and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidS3KeyException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided Amazon S3 key prefix is invalid. Please provide a valid S3 object key name.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidSampleRateException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified sample rate is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidSnsTopicArnException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided SNS topic ARN is invalid. Please provide a valid SNS topic ARN and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidSsmlException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The SSML you provided is invalid. Verify the SSML syntax, spelling of tags and values, and then try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTaskIdException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided Task ID is not valid. Please provide a valid Task ID and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LanguageCode":{ - "type":"string", - "enum":[ - "cy-GB", - "da-DK", - "de-DE", - "en-AU", - "en-GB", - "en-GB-WLS", - "en-IN", - "en-US", - "es-ES", - "es-US", - "fr-CA", - "fr-FR", - "is-IS", - "it-IT", - "ja-JP", - "hi-IN", - "ko-KR", - "nb-NO", - "nl-NL", - "pl-PL", - "pt-BR", - "pt-PT", - "ro-RO", - "ru-RU", - "sv-SE", - "tr-TR" - ] - }, - "LanguageCodeList":{ - "type":"list", - "member":{"shape":"LanguageCode"} - }, - "LanguageName":{"type":"string"}, - "LanguageNotSupportedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The language specified is not currently supported by Amazon Polly in this capacity.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LastModified":{"type":"timestamp"}, - "LexemesCount":{"type":"integer"}, - "Lexicon":{ - "type":"structure", - "members":{ - "Content":{ - "shape":"LexiconContent", - "documentation":"

Lexicon content in string format. The content of a lexicon must be in PLS format.

" - }, - "Name":{ - "shape":"LexiconName", - "documentation":"

Name of the lexicon.

" - } - }, - "documentation":"

Provides lexicon name and lexicon content in string format. For more information, see Pronunciation Lexicon Specification (PLS) Version 1.0.

" - }, - "LexiconArn":{"type":"string"}, - "LexiconAttributes":{ - "type":"structure", - "members":{ - "Alphabet":{ - "shape":"Alphabet", - "documentation":"

Phonetic alphabet used in the lexicon. Valid values are ipa and x-sampa.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

Language code that the lexicon applies to. A lexicon with a language code such as \"en\" would be applied to all English languages (en-GB, en-US, en-AUS, en-WLS, and so on.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Date lexicon was last modified (a timestamp value).

" - }, - "LexiconArn":{ - "shape":"LexiconArn", - "documentation":"

Amazon Resource Name (ARN) of the lexicon.

" - }, - "LexemesCount":{ - "shape":"LexemesCount", - "documentation":"

Number of lexemes in the lexicon.

" - }, - "Size":{ - "shape":"Size", - "documentation":"

Total size of the lexicon, in characters.

" - } - }, - "documentation":"

Contains metadata describing the lexicon such as the number of lexemes, language code, and so on. For more information, see Managing Lexicons.

" - }, - "LexiconContent":{"type":"string"}, - "LexiconDescription":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"LexiconName", - "documentation":"

Name of the lexicon.

" - }, - "Attributes":{ - "shape":"LexiconAttributes", - "documentation":"

Provides lexicon metadata.

" - } - }, - "documentation":"

Describes the content of the lexicon.

" - }, - "LexiconDescriptionList":{ - "type":"list", - "member":{"shape":"LexiconDescription"} - }, - "LexiconName":{ - "type":"string", - "pattern":"[0-9A-Za-z]{1,20}", - "sensitive":true - }, - "LexiconNameList":{ - "type":"list", - "member":{"shape":"LexiconName"}, - "max":5 - }, - "LexiconNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Amazon Polly can't find the specified lexicon. This could be caused by a lexicon that is missing, its name is misspelled or specifying a lexicon that is in a different region.

Verify that the lexicon exists, is in the region (see ListLexicons) and that you spelled its name is spelled correctly. Then try again.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "LexiconSizeExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum size of the specified lexicon would be exceeded by this operation.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ListLexiconsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque pagination token returned from previous ListLexicons operation. If present, indicates where to continue the list of lexicons.

", - "location":"querystring", - "locationName":"NextToken" - } - } - }, - "ListLexiconsOutput":{ - "type":"structure", - "members":{ - "Lexicons":{ - "shape":"LexiconDescriptionList", - "documentation":"

A list of lexicon names and attributes.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token to use in the next request to continue the listing of lexicons. NextToken is returned only if the response is truncated.

" - } - } - }, - "ListSpeechSynthesisTasksInput":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of speech synthesis tasks returned in a List operation.

", - "location":"querystring", - "locationName":"MaxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The pagination token to use in the next request to continue the listing of speech synthesis tasks.

", - "location":"querystring", - "locationName":"NextToken" - }, - "Status":{ - "shape":"TaskStatus", - "documentation":"

Status of the speech synthesis tasks returned in a List operation

", - "location":"querystring", - "locationName":"Status" - } - } - }, - "ListSpeechSynthesisTasksOutput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An opaque pagination token returned from the previous List operation in this request. If present, this indicates where to continue the listing.

" - }, - "SynthesisTasks":{ - "shape":"SynthesisTasks", - "documentation":"

List of SynthesisTask objects that provides information from the specified task in the list request, including output format, creation time, task status, and so on.

" - } - } - }, - "MarksNotSupportedForFormatException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Speech marks are not supported for the OutputFormat selected. Speech marks are only available for content in json format.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "MaxLexemeLengthExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum size of the lexeme would be exceeded by this operation.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "MaxLexiconsNumberExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum number of lexicons would be exceeded by this operation.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "NextToken":{"type":"string"}, - "OutputFormat":{ - "type":"string", - "enum":[ - "json", - "mp3", - "ogg_vorbis", - "pcm" - ] - }, - "OutputS3BucketName":{ - "type":"string", - "pattern":"^[a-z0-9][\\.\\-a-z0-9]{1,61}[a-z0-9]$" - }, - "OutputS3KeyPrefix":{ - "type":"string", - "pattern":"^[0-9a-zA-Z\\/\\!\\-_\\.\\*\\'\\(\\)]{0,800}$" - }, - "OutputUri":{"type":"string"}, - "PutLexiconInput":{ - "type":"structure", - "required":[ - "Name", - "Content" - ], - "members":{ - "Name":{ - "shape":"LexiconName", - "documentation":"

Name of the lexicon. The name must follow the regular express format [0-9A-Za-z]{1,20}. That is, the name is a case-sensitive alphanumeric string up to 20 characters long.

", - "location":"uri", - "locationName":"LexiconName" - }, - "Content":{ - "shape":"LexiconContent", - "documentation":"

Content of the PLS lexicon as string data.

" - } - } - }, - "PutLexiconOutput":{ - "type":"structure", - "members":{ - } - }, - "RequestCharacters":{"type":"integer"}, - "SampleRate":{"type":"string"}, - "ServiceFailureException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

An unknown condition has caused a service failure.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "Size":{"type":"integer"}, - "SnsTopicArn":{ - "type":"string", - "pattern":"^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:.*:\\w{12}:.+$" - }, - "SpeechMarkType":{ - "type":"string", - "enum":[ - "sentence", - "ssml", - "viseme", - "word" - ] - }, - "SpeechMarkTypeList":{ - "type":"list", - "member":{"shape":"SpeechMarkType"}, - "max":4 - }, - "SsmlMarksNotSupportedForTextTypeException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

SSML speech marks are not supported for plain text-type input.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "StartSpeechSynthesisTaskInput":{ - "type":"structure", - "required":[ - "OutputFormat", - "OutputS3BucketName", - "Text", - "VoiceId" - ], - "members":{ - "LexiconNames":{ - "shape":"LexiconNameList", - "documentation":"

List of one or more pronunciation lexicon names you want the service to apply during synthesis. Lexicons are applied only if the language of the lexicon is the same as the language of the voice.

" - }, - "OutputFormat":{ - "shape":"OutputFormat", - "documentation":"

The format in which the returned output will be encoded. For audio stream, this will be mp3, ogg_vorbis, or pcm. For speech marks, this will be json.

" - }, - "OutputS3BucketName":{ - "shape":"OutputS3BucketName", - "documentation":"

Amazon S3 bucket name to which the output file will be saved.

" - }, - "OutputS3KeyPrefix":{ - "shape":"OutputS3KeyPrefix", - "documentation":"

The Amazon S3 key prefix for the output speech file.

" - }, - "SampleRate":{ - "shape":"SampleRate", - "documentation":"

The audio frequency specified in Hz.

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", and \"22050\". The default value is \"22050\".

Valid values for pcm are \"8000\" and \"16000\" The default value is \"16000\".

" - }, - "SnsTopicArn":{ - "shape":"SnsTopicArn", - "documentation":"

ARN for the SNS topic optionally used for providing status notification for a speech synthesis task.

" - }, - "SpeechMarkTypes":{ - "shape":"SpeechMarkTypeList", - "documentation":"

The type of speech marks returned for the input text.

" - }, - "Text":{ - "shape":"Text", - "documentation":"

The input text to synthesize. If you specify ssml as the TextType, follow the SSML format for the input text.

" - }, - "TextType":{ - "shape":"TextType", - "documentation":"

Specifies whether the input text is plain text or SSML. The default value is plain text.

" - }, - "VoiceId":{ - "shape":"VoiceId", - "documentation":"

Voice ID to use for the synthesis.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

Optional language code for the Speech Synthesis request. This is only necessary if using a bilingual voice, such as Aditi, which can be used for either Indian English (en-IN) or Hindi (hi-IN).

If a bilingual voice is used and no language code is specified, Amazon Polly will use the default language of the bilingual voice. The default language for any voice is the one returned by the DescribeVoices operation for the LanguageCode parameter. For example, if no language code is specified, Aditi will use Indian English rather than Hindi.

" - } - } - }, - "StartSpeechSynthesisTaskOutput":{ - "type":"structure", - "members":{ - "SynthesisTask":{ - "shape":"SynthesisTask", - "documentation":"

SynthesisTask object that provides information and attributes about a newly submitted speech synthesis task.

" - } - } - }, - "SynthesisTask":{ - "type":"structure", - "members":{ - "TaskId":{ - "shape":"TaskId", - "documentation":"

The Amazon Polly generated identifier for a speech synthesis task.

" - }, - "TaskStatus":{ - "shape":"TaskStatus", - "documentation":"

Current status of the individual speech synthesis task.

" - }, - "TaskStatusReason":{ - "shape":"TaskStatusReason", - "documentation":"

Reason for the current status of a specific speech synthesis task, including errors if the task has failed.

" - }, - "OutputUri":{ - "shape":"OutputUri", - "documentation":"

Pathway for the output speech file.

" - }, - "CreationTime":{ - "shape":"DateTime", - "documentation":"

Timestamp for the time the synthesis task was started.

" - }, - "RequestCharacters":{ - "shape":"RequestCharacters", - "documentation":"

Number of billable characters synthesized.

" - }, - "SnsTopicArn":{ - "shape":"SnsTopicArn", - "documentation":"

ARN for the SNS topic optionally used for providing status notification for a speech synthesis task.

" - }, - "LexiconNames":{ - "shape":"LexiconNameList", - "documentation":"

List of one or more pronunciation lexicon names you want the service to apply during synthesis. Lexicons are applied only if the language of the lexicon is the same as the language of the voice.

" - }, - "OutputFormat":{ - "shape":"OutputFormat", - "documentation":"

The format in which the returned output will be encoded. For audio stream, this will be mp3, ogg_vorbis, or pcm. For speech marks, this will be json.

" - }, - "SampleRate":{ - "shape":"SampleRate", - "documentation":"

The audio frequency specified in Hz.

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", and \"22050\". The default value is \"22050\".

Valid values for pcm are \"8000\" and \"16000\" The default value is \"16000\".

" - }, - "SpeechMarkTypes":{ - "shape":"SpeechMarkTypeList", - "documentation":"

The type of speech marks returned for the input text.

" - }, - "TextType":{ - "shape":"TextType", - "documentation":"

Specifies whether the input text is plain text or SSML. The default value is plain text.

" - }, - "VoiceId":{ - "shape":"VoiceId", - "documentation":"

Voice ID to use for the synthesis.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

Optional language code for a synthesis task. This is only necessary if using a bilingual voice, such as Aditi, which can be used for either Indian English (en-IN) or Hindi (hi-IN).

If a bilingual voice is used and no language code is specified, Amazon Polly will use the default language of the bilingual voice. The default language for any voice is the one returned by the DescribeVoices operation for the LanguageCode parameter. For example, if no language code is specified, Aditi will use Indian English rather than Hindi.

" - } - }, - "documentation":"

SynthesisTask object that provides information about a speech synthesis task.

" - }, - "SynthesisTaskNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The Speech Synthesis task with requested Task ID cannot be found.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "SynthesisTasks":{ - "type":"list", - "member":{"shape":"SynthesisTask"} - }, - "SynthesizeSpeechInput":{ - "type":"structure", - "required":[ - "OutputFormat", - "Text", - "VoiceId" - ], - "members":{ - "LexiconNames":{ - "shape":"LexiconNameList", - "documentation":"

List of one or more pronunciation lexicon names you want the service to apply during synthesis. Lexicons are applied only if the language of the lexicon is the same as the language of the voice. For information about storing lexicons, see PutLexicon.

" - }, - "OutputFormat":{ - "shape":"OutputFormat", - "documentation":"

The format in which the returned output will be encoded. For audio stream, this will be mp3, ogg_vorbis, or pcm. For speech marks, this will be json.

" - }, - "SampleRate":{ - "shape":"SampleRate", - "documentation":"

The audio frequency specified in Hz.

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", and \"22050\". The default value is \"22050\".

Valid values for pcm are \"8000\" and \"16000\" The default value is \"16000\".

" - }, - "SpeechMarkTypes":{ - "shape":"SpeechMarkTypeList", - "documentation":"

The type of speech marks returned for the input text.

" - }, - "Text":{ - "shape":"Text", - "documentation":"

Input text to synthesize. If you specify ssml as the TextType, follow the SSML format for the input text.

" - }, - "TextType":{ - "shape":"TextType", - "documentation":"

Specifies whether the input text is plain text or SSML. The default value is plain text. For more information, see Using SSML.

" - }, - "VoiceId":{ - "shape":"VoiceId", - "documentation":"

Voice ID to use for the synthesis. You can get a list of available voice IDs by calling the DescribeVoices operation.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

Optional language code for the Synthesize Speech request. This is only necessary if using a bilingual voice, such as Aditi, which can be used for either Indian English (en-IN) or Hindi (hi-IN).

If a bilingual voice is used and no language code is specified, Amazon Polly will use the default language of the bilingual voice. The default language for any voice is the one returned by the DescribeVoices operation for the LanguageCode parameter. For example, if no language code is specified, Aditi will use Indian English rather than Hindi.

" - } - } - }, - "SynthesizeSpeechOutput":{ - "type":"structure", - "members":{ - "AudioStream":{ - "shape":"AudioStream", - "documentation":"

Stream containing the synthesized speech.

" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

Specifies the type audio stream. This should reflect the OutputFormat parameter in your request.

  • If you request mp3 as the OutputFormat, the ContentType returned is audio/mpeg.

  • If you request ogg_vorbis as the OutputFormat, the ContentType returned is audio/ogg.

  • If you request pcm as the OutputFormat, the ContentType returned is audio/pcm in a signed 16-bit, 1 channel (mono), little-endian format.

  • If you request json as the OutputFormat, the ContentType returned is audio/json.

", - "location":"header", - "locationName":"Content-Type" - }, - "RequestCharacters":{ - "shape":"RequestCharacters", - "documentation":"

Number of characters synthesized.

", - "location":"header", - "locationName":"x-amzn-RequestCharacters" - } - }, - "payload":"AudioStream" - }, - "TaskId":{ - "type":"string", - "max":128, - "min":1 - }, - "TaskStatus":{ - "type":"string", - "enum":[ - "scheduled", - "inProgress", - "completed", - "failed" - ] - }, - "TaskStatusReason":{"type":"string"}, - "Text":{"type":"string"}, - "TextLengthExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The value of the \"Text\" parameter is longer than the accepted limits. For the SynthesizeSpeech API, the limit for input text is a maximum of 6000 characters total, of which no more than 3000 can be billed characters. For the StartSpeechSynthesisTask API, the maximum is 200,000 characters, of which no more than 100,000 can be billed characters. SSML tags are not counted as billed characters.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TextType":{ - "type":"string", - "enum":[ - "ssml", - "text" - ] - }, - "UnsupportedPlsAlphabetException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The alphabet specified by the lexicon is not a supported alphabet. Valid values are x-sampa and ipa.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "UnsupportedPlsLanguageException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The language specified in the lexicon is unsupported. For a list of supported languages, see Lexicon Attributes.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Voice":{ - "type":"structure", - "members":{ - "Gender":{ - "shape":"Gender", - "documentation":"

Gender of the voice.

" - }, - "Id":{ - "shape":"VoiceId", - "documentation":"

Amazon Polly assigned voice ID. This is the ID that you specify when calling the SynthesizeSpeech operation.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

Language code of the voice.

" - }, - "LanguageName":{ - "shape":"LanguageName", - "documentation":"

Human readable name of the language in English.

" - }, - "Name":{ - "shape":"VoiceName", - "documentation":"

Name of the voice (for example, Salli, Kendra, etc.). This provides a human readable voice name that you might display in your application.

" - }, - "AdditionalLanguageCodes":{ - "shape":"LanguageCodeList", - "documentation":"

Additional codes for languages available for the specified voice in addition to its default language.

For example, the default language for Aditi is Indian English (en-IN) because it was first used for that language. Since Aditi is bilingual and fluent in both Indian English and Hindi, this parameter would show the code hi-IN.

" - } - }, - "documentation":"

Description of the voice.

" - }, - "VoiceId":{ - "type":"string", - "enum":[ - "Geraint", - "Gwyneth", - "Mads", - "Naja", - "Hans", - "Marlene", - "Nicole", - "Russell", - "Amy", - "Brian", - "Emma", - "Raveena", - "Ivy", - "Joanna", - "Joey", - "Justin", - "Kendra", - "Kimberly", - "Matthew", - "Salli", - "Conchita", - "Enrique", - "Miguel", - "Penelope", - "Chantal", - "Celine", - "Lea", - "Mathieu", - "Dora", - "Karl", - "Carla", - "Giorgio", - "Mizuki", - "Liv", - "Lotte", - "Ruben", - "Ewa", - "Jacek", - "Jan", - "Maja", - "Ricardo", - "Vitoria", - "Cristiano", - "Ines", - "Carmen", - "Maxim", - "Tatyana", - "Astrid", - "Filiz", - "Vicki", - "Takumi", - "Seoyeon", - "Aditi" - ] - }, - "VoiceList":{ - "type":"list", - "member":{"shape":"Voice"} - }, - "VoiceName":{"type":"string"} - }, - "documentation":"

Amazon Polly is a web service that makes it easy to synthesize speech from text.

The Amazon Polly service provides API operations for synthesizing high-quality speech from plain text and Speech Synthesis Markup Language (SSML), along with managing pronunciations lexicons that enable you to get the best results for your application domain.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/paginators-1.json deleted file mode 100644 index c113c43f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/paginators-1.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "pagination": { - "DescribeServices": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Services", - "non_aggregate_keys": ["FormatVersion"] - }, - "GetAttributeValues": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "AttributeValues" - }, - "GetProducts": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "PriceList", - "non_aggregate_keys": ["FormatVersion"] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/service-2.json deleted file mode 100644 index bc77bc67..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/pricing/2017-10-15/service-2.json +++ /dev/null @@ -1,315 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-15", - "endpointPrefix":"api.pricing", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWS Pricing", - "serviceFullName":"AWS Price List Service", - "serviceId":"Pricing", - "signatureVersion":"v4", - "signingName":"pricing", - "targetPrefix":"AWSPriceListService", - "uid":"pricing-2017-10-15" - }, - "operations":{ - "DescribeServices":{ - "name":"DescribeServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServicesRequest"}, - "output":{"shape":"DescribeServicesResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Returns the metadata for one service or a list of the metadata for all services. Use this without a service code to get the service codes for all services. Use it with a service code, such as AmazonEC2, to get information specific to that service, such as the attribute names available for that service. For example, some of the attribute names available for EC2 are volumeType, maxIopsVolume, operation, locationType, and instanceCapacity10xlarge.

" - }, - "GetAttributeValues":{ - "name":"GetAttributeValues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAttributeValuesRequest"}, - "output":{"shape":"GetAttributeValuesResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Returns a list of attribute values. Attibutes are similar to the details in a Price List API offer file. For a list of available attributes, see Offer File Definitions in the AWS Billing and Cost Management User Guide.

" - }, - "GetProducts":{ - "name":"GetProducts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetProductsRequest"}, - "output":{"shape":"GetProductsResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"ExpiredNextTokenException"} - ], - "documentation":"

Returns a list of all products that match the filter criteria.

" - } - }, - "shapes":{ - "AttributeNameList":{ - "type":"list", - "member":{"shape":"String"} - }, - "AttributeValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"String", - "documentation":"

The specific value of an attributeName.

" - } - }, - "documentation":"

The values of a given attribute, such as Throughput Optimized HDD or Provisioned IOPS for the Amazon EC2 volumeType attribute.

" - }, - "AttributeValueList":{ - "type":"list", - "member":{"shape":"AttributeValue"} - }, - "BoxedInteger":{ - "type":"integer", - "max":100, - "min":1 - }, - "DescribeServicesRequest":{ - "type":"structure", - "members":{ - "ServiceCode":{ - "shape":"String", - "documentation":"

The code for the service whose information you want to retrieve, such as AmazonEC2. You can use the ServiceCode to filter the results in a GetProducts call. To retrieve a list of all services, leave this blank.

" - }, - "FormatVersion":{ - "shape":"String", - "documentation":"

The format version that you want the response to be in.

Valid values are: aws_v1

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token that indicates the next set of results that you want to retrieve.

" - }, - "MaxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of results that you want returned in the response.

", - "box":true - } - } - }, - "DescribeServicesResponse":{ - "type":"structure", - "members":{ - "Services":{ - "shape":"ServiceList", - "documentation":"

The service metadata for the service or services in the response.

" - }, - "FormatVersion":{ - "shape":"String", - "documentation":"

The format version of the response. For example, aws_v1.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token for the next set of retreivable results.

" - } - } - }, - "ExpiredNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The pagination token expired. Try again without a pagination token.

", - "exception":true - }, - "Filter":{ - "type":"structure", - "required":[ - "Type", - "Field", - "Value" - ], - "members":{ - "Type":{ - "shape":"FilterType", - "documentation":"

The type of filter that you want to use.

Valid values are: TERM_MATCH. TERM_MATCH returns only products that match both the given filter field and the given value.

" - }, - "Field":{ - "shape":"String", - "documentation":"

The product metadata field that you want to filter on. You can filter by just the service code to see all products for a specific service, filter by just the attribute name to see a specific attribute for multiple services, or use both a service code and an attribute name to retrieve only products that match both fields.

Valid values include: ServiceCode, and all attribute names

For example, you can filter by the AmazonEC2 service code and the volumeType attribute name to get the prices for only Amazon EC2 volumes.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The service code or attribute value that you want to filter by. If you are filtering by service code this is the actual service code, such as AmazonEC2. If you are filtering by attribute name, this is the attribute value that you want the returned products to match, such as a Provisioned IOPS volume.

" - } - }, - "documentation":"

The constraints that you want all returned products to match.

" - }, - "FilterType":{ - "type":"string", - "enum":["TERM_MATCH"] - }, - "Filters":{ - "type":"list", - "member":{"shape":"Filter"} - }, - "GetAttributeValuesRequest":{ - "type":"structure", - "required":[ - "ServiceCode", - "AttributeName" - ], - "members":{ - "ServiceCode":{ - "shape":"String", - "documentation":"

The service code for the service whose attributes you want to retrieve. For example, if you want the retrieve an EC2 attribute, use AmazonEC2.

" - }, - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the attribute that you want to retrieve the values for, such as volumeType.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token that indicates the next set of results that you want to retrieve.

" - }, - "MaxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of results to return in response.

", - "box":true - } - } - }, - "GetAttributeValuesResponse":{ - "type":"structure", - "members":{ - "AttributeValues":{ - "shape":"AttributeValueList", - "documentation":"

The list of values for an attribute. For example, Throughput Optimized HDD and Provisioned IOPS are two available values for the AmazonEC2 volumeType.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - } - }, - "GetProductsRequest":{ - "type":"structure", - "members":{ - "ServiceCode":{ - "shape":"String", - "documentation":"

The code for the service whose products you want to retrieve.

" - }, - "Filters":{ - "shape":"Filters", - "documentation":"

The list of filters that limit the returned products. only products that match all filters are returned.

" - }, - "FormatVersion":{ - "shape":"String", - "documentation":"

The format version that you want the response to be in.

Valid values are: aws_v1

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token that indicates the next set of results that you want to retrieve.

" - }, - "MaxResults":{ - "shape":"BoxedInteger", - "documentation":"

The maximum number of results to return in the response.

", - "box":true - } - } - }, - "GetProductsResponse":{ - "type":"structure", - "members":{ - "FormatVersion":{ - "shape":"String", - "documentation":"

The format version of the response. For example, aws_v1.

" - }, - "PriceList":{ - "shape":"PriceList", - "documentation":"

The list of products that match your filters. The list contains both the product metadata and the price information.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

The pagination token that indicates the next set of results to retrieve.

" - } - } - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

An error on the server occurred during the processing of your request. Try again later.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The pagination token is invalid. Try again without a pagination token.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

One or more parameters had an invalid value.

", - "exception":true - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"errorMessage"} - }, - "documentation":"

The requested resource can't be found.

", - "exception":true - }, - "PriceList":{ - "type":"list", - "member":{ - "shape":"PriceListItemJSON", - "jsonvalue":true - } - }, - "PriceListItemJSON":{"type":"string"}, - "Service":{ - "type":"structure", - "members":{ - "ServiceCode":{ - "shape":"String", - "documentation":"

The code for the AWS service.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

The attributes that are available for this service.

" - } - }, - "documentation":"

The metadata for a service, such as the service code and available attribute names.

" - }, - "ServiceList":{ - "type":"list", - "member":{"shape":"Service"} - }, - "String":{"type":"string"}, - "errorMessage":{"type":"string"} - }, - "documentation":"

AWS Price List Service API (AWS Price List Service) is a centralized and convenient way to programmatically query Amazon Web Services for services, products, and pricing information. The AWS Price List Service uses standardized product attributes such as Location, Storage Class, and Operating System, and provides prices at the SKU level. You can use the AWS Price List Service to build cost control and scenario planning tools, reconcile billing data, forecast future spend for budgeting purposes, and provide cost benefit analysis that compare your internal workloads with AWS.

Use GetServices without a service code to retrieve the service codes for all AWS services, then GetServices with a service code to retreive the attribute names for that service. After you have the service code and attribute names, you can use GetAttributeValues to see what values are available for an attribute. With the service code and an attribute name and value, you can use GetProducts to find specific products that you're interested in, such as an AmazonEC2 instance, with a Provisioned IOPS volumeType.

Service Endpoint

AWS Price List Service API provides the following two endpoints:

  • https://api.pricing.us-east-1.amazonaws.com

  • https://api.pricing.ap-south-1.amazonaws.com

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/paginators-1.json deleted file mode 100644 index 76c4f3a1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/paginators-1.json +++ /dev/null @@ -1,107 +0,0 @@ -{ - "pagination": { - "DescribeDBEngineVersions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBEngineVersions" - }, - "DescribeDBInstances": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBInstances" - }, - "DescribeDBLogFiles": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DescribeDBLogFiles" - }, - "DescribeDBParameterGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBParameterGroups" - }, - "DescribeDBParameters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Parameters" - }, - "DescribeDBSecurityGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSecurityGroups" - }, - "DescribeDBSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSnapshots" - }, - "DescribeDBSubnetGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSubnetGroups" - }, - "DescribeEngineDefaultParameters": { - "input_token": "Marker", - "output_token": "EngineDefaults.Marker", - "limit_key": "MaxRecords", - "result_key": "EngineDefaults.Parameters" - }, - "DescribeEventSubscriptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "EventSubscriptionsList" - }, - "DescribeEvents": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Events" - }, - "DescribeOptionGroupOptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OptionGroupOptions" - }, - "DescribeOptionGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OptionGroupsList" - }, - "DescribeOrderableDBInstanceOptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OrderableDBInstanceOptions" - }, - "DescribeReservedDBInstances": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedDBInstances" - }, - "DescribeReservedDBInstancesOfferings": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedDBInstancesOfferings" - }, - "DownloadDBLogFilePortion": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "NumberOfLines", - "more_results": "AdditionalDataPending", - "result_key": "LogFileData" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/service-2.json deleted file mode 100644 index ef321ed6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/service-2.json +++ /dev/null @@ -1,6943 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-09-01", - "endpointPrefix":"rds", - "serviceAbbreviation":"Amazon RDS", - "serviceFullName":"Amazon Relational Database Service", - "signatureVersion":"v4", - "xmlNamespace":"http://rds.amazonaws.com/doc/2014-09-01/", - "protocol":"query" - }, - "documentation":"Amazon Relational Database Service

Amazon Relational Database Service (Amazon RDS) is a web service that makes it easier to set up, operate, and scale a relational database in the cloud. It provides cost-efficient, resizable capacity for an industry-standard relational database and manages common database administration tasks, freeing up developers to focus on what makes their applications and businesses unique.

Amazon RDS gives you access to the capabilities of a MySQL, PostgreSQL, Microsoft SQL Server, or Oracle database server. This means the code, applications, and tools you already use today with your existing databases work with Amazon RDS without modification. Amazon RDS automatically backs up your database and maintains the database software that powers your DB instance. Amazon RDS is flexible: you can scale your database instance's compute resources and storage capacity to meet your application's demand. As with all Amazon Web Services, there are no up-front investments, and you pay only for the resources you use.

This is an interface reference for Amazon RDS. It contains documentation for a programming or command line interface you can use to manage Amazon RDS. Note that Amazon RDS is asynchronous, which means that some interfaces may require techniques such as polling or callback functions to determine when a command has been applied. In this reference, the parameter descriptions indicate whether a command is applied immediately, on the next instance reboot, or during the maintenance window. For a summary of the Amazon RDS interfaces, go to Available RDS Interfaces.

", - "operations":{ - "AddSourceIdentifierToSubscription":{ - "name":"AddSourceIdentifierToSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"AddSourceIdentifierToSubscriptionMessage", - "documentation":"

" - }, - "output":{ - "shape":"AddSourceIdentifierToSubscriptionResult", - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "resultWrapper":"AddSourceIdentifierToSubscriptionResult" - }, - "errors":[ - { - "shape":"SubscriptionNotFoundFault", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - }, - { - "shape":"SourceNotFoundFault", - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested source could not be found.

" - } - ], - "documentation":"

Adds a source identifier to an existing RDS event notification subscription.

" - }, - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"AddTagsToResourceMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - } - ], - "documentation":"

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in Condition statement in IAM policy for Amazon RDS.

For an overview on tagging Amazon RDS resources, see Tagging Amazon RDS Resources.

" - }, - "AuthorizeDBSecurityGroupIngress":{ - "name":"AuthorizeDBSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"AuthorizeDBSecurityGroupIngressMessage", - "documentation":"

" - }, - "output":{ - "shape":"AuthorizeDBSecurityGroupIngressResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSecurityGroups action.

", - "resultWrapper":"AuthorizeDBSecurityGroupIngressResult" - }, - "errors":[ - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - { - "shape":"InvalidDBSecurityGroupStateFault", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB security group does not allow deletion.

" - }, - { - "shape":"AuthorizationAlreadyExistsFault", - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified CIDRIP or EC2 security group is already authorized for the specified DB security group.

" - }, - { - "shape":"AuthorizationQuotaExceededFault", - "error":{ - "code":"AuthorizationQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB security group authorization quota has been reached.

" - } - ], - "documentation":"

Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the Internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).

You cannot authorize ingress from an EC2 security group in one Region to an Amazon RDS DB instance in another. You cannot authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

" - }, - "CopyDBParameterGroup":{ - "name":"CopyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CopyDBParameterGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CopyDBParameterGroupResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the CreateDBParameterGroup action.

This data type is used as a request parameter in the DeleteDBParameterGroup action, and as a response element in the DescribeDBParameterGroups action.

", - "resultWrapper":"CopyDBParameterGroupResult" - }, - "errors":[ - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - { - "shape":"DBParameterGroupAlreadyExistsFault", - "error":{ - "code":"DBParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB parameter group with the same name exists.

" - }, - { - "shape":"DBParameterGroupQuotaExceededFault", - "error":{ - "code":"DBParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB parameter groups.

" - } - ], - "documentation":"

Copies the specified DB parameter group.

" - }, - "CopyDBSnapshot":{ - "name":"CopyDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CopyDBSnapshotMessage", - "documentation":"

" - }, - "output":{ - "shape":"CopyDBSnapshotResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSnapshots action.

", - "resultWrapper":"CopyDBSnapshotResult" - }, - "errors":[ - { - "shape":"DBSnapshotAlreadyExistsFault", - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - }, - { - "shape":"InvalidDBSnapshotStateFault", - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB snapshot does not allow deletion.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB snapshots.

" - } - ], - "documentation":"

Copies the specified DBSnapshot. The source DBSnapshot must be in the \"available\" state.

" - }, - "CopyOptionGroup":{ - "name":"CopyOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CopyOptionGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CopyOptionGroupResult", - "wrapper":true, - "documentation":"

", - "resultWrapper":"CopyOptionGroupResult" - }, - "errors":[ - { - "shape":"OptionGroupAlreadyExistsFault", - "error":{ - "code":"OptionGroupAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group you are trying to create already exists.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"OptionGroupQuotaExceededFault", - "error":{ - "code":"OptionGroupQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The quota of 20 option groups was exceeded for this AWS account.

" - } - ], - "documentation":"

Copies the specified option group.

" - }, - "CreateDBInstance":{ - "name":"CreateDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDBInstanceMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateDBInstanceResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"CreateDBInstanceResult" - }, - "errors":[ - { - "shape":"DBInstanceAlreadyExistsFault", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - { - "shape":"InsufficientDBInstanceCapacityFault", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - { - "shape":"InstanceQuotaExceededFault", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

" - }, - { - "shape":"StorageQuotaExceededFault", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - { - "shape":"ProvisionedIopsNotAvailableInAZFault", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"StorageTypeNotSupportedFault", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - } - ], - "documentation":"

Creates a new DB instance.

" - }, - "CreateDBInstanceReadReplica":{ - "name":"CreateDBInstanceReadReplica", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBInstanceReadReplicaMessage"}, - "output":{ - "shape":"CreateDBInstanceReadReplicaResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"CreateDBInstanceReadReplicaResult" - }, - "errors":[ - { - "shape":"DBInstanceAlreadyExistsFault", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - { - "shape":"InsufficientDBInstanceCapacityFault", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - { - "shape":"InstanceQuotaExceededFault", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

" - }, - { - "shape":"StorageQuotaExceededFault", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - { - "shape":"ProvisionedIopsNotAvailableInAZFault", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"DBSubnetGroupNotAllowedFault", - "error":{ - "code":"DBSubnetGroupNotAllowedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Indicates that the DBSubnetGroup should not be specified while creating read replicas that lie in the same region as the source instance.

" - }, - { - "shape":"InvalidDBSubnetGroupFault", - "error":{ - "code":"InvalidDBSubnetGroupFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Indicates the DBSubnetGroup does not belong to the same VPC as that of an existing cross region read replica of the same source instance.

" - }, - { - "shape":"StorageTypeNotSupportedFault", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - } - ], - "documentation":"

Creates a DB instance that acts as a Read Replica of a source DB instance.

All Read Replica DB instances are created as Single-AZ deployments with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified below.

The source DB instance must have backup retention enabled.

" - }, - "CreateDBParameterGroup":{ - "name":"CreateDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDBParameterGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateDBParameterGroupResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the CreateDBParameterGroup action.

This data type is used as a request parameter in the DeleteDBParameterGroup action, and as a response element in the DescribeDBParameterGroups action.

", - "resultWrapper":"CreateDBParameterGroupResult" - }, - "errors":[ - { - "shape":"DBParameterGroupQuotaExceededFault", - "error":{ - "code":"DBParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB parameter groups.

" - }, - { - "shape":"DBParameterGroupAlreadyExistsFault", - "error":{ - "code":"DBParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB parameter group with the same name exists.

" - } - ], - "documentation":"

Creates a new DB parameter group.

A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.

After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "CreateDBSecurityGroup":{ - "name":"CreateDBSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDBSecurityGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateDBSecurityGroupResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSecurityGroups action.

", - "resultWrapper":"CreateDBSecurityGroupResult" - }, - "errors":[ - { - "shape":"DBSecurityGroupAlreadyExistsFault", - "error":{ - "code":"DBSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB security group with the name specified in DBSecurityGroupName already exists.

" - }, - { - "shape":"DBSecurityGroupQuotaExceededFault", - "error":{ - "code":"QuotaExceeded.DBSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB security groups.

" - }, - { - "shape":"DBSecurityGroupNotSupportedFault", - "error":{ - "code":"DBSecurityGroupNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB security group is not allowed for this action.

" - } - ], - "documentation":"

Creates a new DB security group. DB security groups control access to a DB instance.

" - }, - "CreateDBSnapshot":{ - "name":"CreateDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDBSnapshotMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateDBSnapshotResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSnapshots action.

", - "resultWrapper":"CreateDBSnapshotResult" - }, - "errors":[ - { - "shape":"DBSnapshotAlreadyExistsFault", - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

" - }, - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB snapshots.

" - } - ], - "documentation":"

Creates a DBSnapshot. The source DBInstance must be in \"available\" state.

" - }, - "CreateDBSubnetGroup":{ - "name":"CreateDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateDBSubnetGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateDBSubnetGroupResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSubnetGroups action.

", - "resultWrapper":"CreateDBSubnetGroupResult" - }, - "errors":[ - { - "shape":"DBSubnetGroupAlreadyExistsFault", - "error":{ - "code":"DBSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName is already used by an existing DB subnet group.

" - }, - { - "shape":"DBSubnetGroupQuotaExceededFault", - "error":{ - "code":"DBSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB subnet groups.

" - }, - { - "shape":"DBSubnetQuotaExceededFault", - "error":{ - "code":"DBSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of subnets in a DB subnet groups.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - } - ], - "documentation":"

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the region.

" - }, - "CreateEventSubscription":{ - "name":"CreateEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateEventSubscriptionMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateEventSubscriptionResult", - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "resultWrapper":"CreateEventSubscriptionResult" - }, - "errors":[ - { - "shape":"EventSubscriptionQuotaExceededFault", - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You have reached the maximum number of event subscriptions.

" - }, - { - "shape":"SubscriptionAlreadyExistFault", - "error":{ - "code":"SubscriptionAlreadyExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The supplied subscription name already exists.

" - }, - { - "shape":"SNSInvalidTopicFault", - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

SNS has responded that there is a problem with the SND topic specified.

" - }, - { - "shape":"SNSNoAuthorizationFault", - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You do not have permission to publish to the SNS topic ARN.

" - }, - { - "shape":"SNSTopicArnNotFoundFault", - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The SNS topic ARN does not exist.

" - }, - { - "shape":"SubscriptionCategoryNotFoundFault", - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The supplied category does not exist.

" - }, - { - "shape":"SourceNotFoundFault", - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested source could not be found.

" - } - ], - "documentation":"

Creates an RDS event notification subscription. This action requires a topic ARN (Amazon Resource Name) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the type of source (SourceType) you want to be notified of, provide a list of RDS sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and SourceIdentifier = myDBInstance1, you will be notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you will receive notice of the events for that source type for all your RDS sources. If you do not specify either the SourceType nor the SourceIdentifier, you will be notified of events generated from all RDS sources belonging to your customer account.

" - }, - "CreateOptionGroup":{ - "name":"CreateOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"CreateOptionGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"CreateOptionGroupResult", - "wrapper":true, - "documentation":"

", - "resultWrapper":"CreateOptionGroupResult" - }, - "errors":[ - { - "shape":"OptionGroupAlreadyExistsFault", - "error":{ - "code":"OptionGroupAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group you are trying to create already exists.

" - }, - { - "shape":"OptionGroupQuotaExceededFault", - "error":{ - "code":"OptionGroupQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The quota of 20 option groups was exceeded for this AWS account.

" - } - ], - "documentation":"

Creates a new option group. You can create up to 20 option groups.

" - }, - "DeleteDBInstance":{ - "name":"DeleteDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDBInstanceMessage", - "documentation":"

" - }, - "output":{ - "shape":"DeleteDBInstanceResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"DeleteDBInstanceResult" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"DBSnapshotAlreadyExistsFault", - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

" - }, - { - "shape":"SnapshotQuotaExceededFault", - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB snapshots.

" - } - ], - "documentation":"

The DeleteDBInstance action deletes a previously provisioned DB instance. A successful response from the web service indicates the request was received correctly. When you delete a DB instance, all automated backups for that instance are deleted and cannot be recovered. Manual DB snapshots of the DB instance to be deleted are not deleted.

If a final DB snapshot is requested the status of the RDS instance will be \"deleting\" until the DB snapshot is created. The API action DescribeDBInstance is used to monitor the status of this operation. The action cannot be canceled or reverted once submitted.

" - }, - "DeleteDBParameterGroup":{ - "name":"DeleteDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDBParameterGroupMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"InvalidDBParameterGroupStateFault", - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB parameter group cannot be deleted because it is in use.

" - }, - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - } - ], - "documentation":"

Deletes a specified DBParameterGroup. The DBParameterGroup to be deleted cannot be associated with any DB instances.

The specified DB parameter group cannot be associated with any DB instances. " - }, - "DeleteDBSecurityGroup":{ - "name":"DeleteDBSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDBSecurityGroupMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"InvalidDBSecurityGroupStateFault", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB security group does not allow deletion.

" - }, - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - } - ], - "documentation":"

Deletes a DB security group.

The specified DB security group must not be associated with any DB instances." - }, - "DeleteDBSnapshot":{ - "name":"DeleteDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDBSnapshotMessage", - "documentation":"

" - }, - "output":{ - "shape":"DeleteDBSnapshotResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSnapshots action.

", - "resultWrapper":"DeleteDBSnapshotResult" - }, - "errors":[ - { - "shape":"InvalidDBSnapshotStateFault", - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB snapshot does not allow deletion.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - } - ], - "documentation":"

Deletes a DBSnapshot. If the snapshot is being copied, the copy operation is terminated.

The DBSnapshot must be in the available state to be deleted." - }, - "DeleteDBSubnetGroup":{ - "name":"DeleteDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteDBSubnetGroupMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"InvalidDBSubnetGroupStateFault", - "error":{ - "code":"InvalidDBSubnetGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet group cannot be deleted because it is in use.

" - }, - { - "shape":"InvalidDBSubnetStateFault", - "error":{ - "code":"InvalidDBSubnetStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet is not in the available state.

" - }, - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - } - ], - "documentation":"

Deletes a DB subnet group.

The specified database subnet group must not be associated with any DB instances." - }, - "DeleteEventSubscription":{ - "name":"DeleteEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteEventSubscriptionMessage", - "documentation":"

" - }, - "output":{ - "shape":"DeleteEventSubscriptionResult", - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "resultWrapper":"DeleteEventSubscriptionResult" - }, - "errors":[ - { - "shape":"SubscriptionNotFoundFault", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - }, - { - "shape":"InvalidEventSubscriptionStateFault", - "error":{ - "code":"InvalidEventSubscriptionState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

This error can occur if someone else is modifying a subscription. You should retry the action.

" - } - ], - "documentation":"

Deletes an RDS event notification subscription.

" - }, - "DeleteOptionGroup":{ - "name":"DeleteOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DeleteOptionGroupMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"InvalidOptionGroupStateFault", - "error":{ - "code":"InvalidOptionGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group is not in the available state.

" - } - ], - "documentation":"

Deletes an existing option group.

" - }, - "DescribeDBEngineVersions":{ - "name":"DescribeDBEngineVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBEngineVersionsMessage"}, - "output":{ - "shape":"DBEngineVersionMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBEngineVersions action.

", - "resultWrapper":"DescribeDBEngineVersionsResult" - }, - "documentation":"

Returns a list of the available DB engines.

" - }, - "DescribeDBInstances":{ - "name":"DescribeDBInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBInstancesMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBInstanceMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBInstances action.

", - "resultWrapper":"DescribeDBInstancesResult" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - } - ], - "documentation":"

Returns information about provisioned RDS instances. This API supports pagination.

" - }, - "DescribeDBLogFiles":{ - "name":"DescribeDBLogFiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBLogFilesMessage", - "documentation":"

" - }, - "output":{ - "shape":"DescribeDBLogFilesResponse", - "documentation":"

The response from a call to DescribeDBLogFiles.

", - "resultWrapper":"DescribeDBLogFilesResult" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - } - ], - "documentation":"

Returns a list of DB log files for the DB instance.

" - }, - "DescribeDBParameterGroups":{ - "name":"DescribeDBParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBParameterGroupsMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBParameterGroupsMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameterGroups action.

", - "resultWrapper":"DescribeDBParameterGroupsResult" - }, - "errors":[ - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - } - ], - "documentation":"

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

" - }, - "DescribeDBParameters":{ - "name":"DescribeDBParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBParametersMessage"}, - "output":{ - "shape":"DBParameterGroupDetails", - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameters action.

", - "resultWrapper":"DescribeDBParametersResult" - }, - "errors":[ - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - } - ], - "documentation":"

Returns the detailed parameter list for a particular DB parameter group.

" - }, - "DescribeDBSecurityGroups":{ - "name":"DescribeDBSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBSecurityGroupsMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBSecurityGroupMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBSecurityGroups action.

", - "resultWrapper":"DescribeDBSecurityGroupsResult" - }, - "errors":[ - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - } - ], - "documentation":"

Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.

" - }, - "DescribeDBSnapshots":{ - "name":"DescribeDBSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBSnapshotsMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBSnapshotMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBSnapshots action.

", - "resultWrapper":"DescribeDBSnapshotsResult" - }, - "errors":[ - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - } - ], - "documentation":"

Returns information about DB snapshots. This API supports pagination.

" - }, - "DescribeDBSubnetGroups":{ - "name":"DescribeDBSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeDBSubnetGroupsMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBSubnetGroupMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeDBSubnetGroups action.

", - "resultWrapper":"DescribeDBSubnetGroupsResult" - }, - "errors":[ - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - } - ], - "documentation":"

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

" - }, - "DescribeEngineDefaultParameters":{ - "name":"DescribeEngineDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEngineDefaultParametersMessage", - "documentation":"

" - }, - "output":{ - "shape":"DescribeEngineDefaultParametersResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the DescribeEngineDefaultParameters action.

", - "resultWrapper":"DescribeEngineDefaultParametersResult" - }, - "documentation":"

Returns the default engine and system parameter information for the specified database engine.

" - }, - "DescribeEventCategories":{ - "name":"DescribeEventCategories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEventCategoriesMessage", - "documentation":"

" - }, - "output":{ - "shape":"EventCategoriesMessage", - "documentation":"

Data returned from the DescribeEventCategories action.

", - "resultWrapper":"DescribeEventCategoriesResult" - }, - "documentation":"

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in the Events topic in the Amazon RDS User Guide.

" - }, - "DescribeEventSubscriptions":{ - "name":"DescribeEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEventSubscriptionsMessage", - "documentation":"

" - }, - "output":{ - "shape":"EventSubscriptionsMessage", - "documentation":"

Data returned by the DescribeEventSubscriptions action.

", - "resultWrapper":"DescribeEventSubscriptionsResult" - }, - "errors":[ - { - "shape":"SubscriptionNotFoundFault", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - } - ], - "documentation":"

Lists all the subscription descriptions for a customer account. The description for a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

If you specify a SubscriptionName, lists the description for that subscription.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeEventsMessage", - "documentation":"

" - }, - "output":{ - "shape":"EventsMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeEvents action.

", - "resultWrapper":"DescribeEventsResult" - }, - "documentation":"

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

" - }, - "DescribeOptionGroupOptions":{ - "name":"DescribeOptionGroupOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeOptionGroupOptionsMessage", - "documentation":"

" - }, - "output":{ - "shape":"OptionGroupOptionsMessage", - "documentation":"

", - "resultWrapper":"DescribeOptionGroupOptionsResult" - }, - "documentation":"

Describes all available options.

" - }, - "DescribeOptionGroups":{ - "name":"DescribeOptionGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeOptionGroupsMessage", - "documentation":"

" - }, - "output":{ - "shape":"OptionGroups", - "documentation":"

List of option groups.

", - "resultWrapper":"DescribeOptionGroupsResult" - }, - "errors":[ - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - } - ], - "documentation":"

Describes the available option groups.

" - }, - "DescribeOrderableDBInstanceOptions":{ - "name":"DescribeOrderableDBInstanceOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeOrderableDBInstanceOptionsMessage", - "documentation":"

" - }, - "output":{ - "shape":"OrderableDBInstanceOptionsMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeOrderableDBInstanceOptions action.

", - "resultWrapper":"DescribeOrderableDBInstanceOptionsResult" - }, - "documentation":"

Returns a list of orderable DB instance options for the specified engine.

" - }, - "DescribeReservedDBInstances":{ - "name":"DescribeReservedDBInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeReservedDBInstancesMessage", - "documentation":"

" - }, - "output":{ - "shape":"ReservedDBInstanceMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstances action.

", - "resultWrapper":"DescribeReservedDBInstancesResult" - }, - "errors":[ - { - "shape":"ReservedDBInstanceNotFoundFault", - "error":{ - "code":"ReservedDBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified reserved DB Instance not found.

" - } - ], - "documentation":"

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

" - }, - "DescribeReservedDBInstancesOfferings":{ - "name":"DescribeReservedDBInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DescribeReservedDBInstancesOfferingsMessage", - "documentation":"

" - }, - "output":{ - "shape":"ReservedDBInstancesOfferingMessage", - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstancesOfferings action.

", - "resultWrapper":"DescribeReservedDBInstancesOfferingsResult" - }, - "errors":[ - { - "shape":"ReservedDBInstancesOfferingNotFoundFault", - "error":{ - "code":"ReservedDBInstancesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified offering does not exist.

" - } - ], - "documentation":"

Lists available reserved DB instance offerings.

" - }, - "DownloadDBLogFilePortion":{ - "name":"DownloadDBLogFilePortion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"DownloadDBLogFilePortionMessage", - "documentation":"

" - }, - "output":{ - "shape":"DownloadDBLogFilePortionDetails", - "documentation":"

This data type is used as a response element to DownloadDBLogFilePortion.

", - "resultWrapper":"DownloadDBLogFilePortionResult" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - } - ], - "documentation":"

Downloads all or a portion of the specified log file.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ListTagsForResourceMessage", - "documentation":"

" - }, - "output":{ - "shape":"TagListMessage", - "documentation":"

", - "resultWrapper":"ListTagsForResourceResult" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - } - ], - "documentation":"

Lists all tags on an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources.

" - }, - "ModifyDBInstance":{ - "name":"ModifyDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyDBInstanceMessage", - "documentation":"

" - }, - "output":{ - "shape":"ModifyDBInstanceResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"ModifyDBInstanceResult" - }, - "errors":[ - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"InvalidDBSecurityGroupStateFault", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB security group does not allow deletion.

" - }, - { - "shape":"DBInstanceAlreadyExistsFault", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - { - "shape":"InsufficientDBInstanceCapacityFault", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - { - "shape":"StorageQuotaExceededFault", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - { - "shape":"ProvisionedIopsNotAvailableInAZFault", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"DBUpgradeDependencyFailureFault", - "error":{ - "code":"DBUpgradeDependencyFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB upgrade failed because a resource the DB depends on could not be modified.

" - }, - { - "shape":"StorageTypeNotSupportedFault", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - } - ], - "documentation":"

Modify settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.

" - }, - "ModifyDBParameterGroup":{ - "name":"ModifyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyDBParameterGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBParameterGroupNameMessage", - "documentation":"

Contains the result of a successful invocation of the ModifyDBParameterGroup or ResetDBParameterGroup action.

", - "resultWrapper":"ModifyDBParameterGroupResult" - }, - "errors":[ - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - { - "shape":"InvalidDBParameterGroupStateFault", - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB parameter group cannot be deleted because it is in use.

" - } - ], - "documentation":"

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "ModifyDBSubnetGroup":{ - "name":"ModifyDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyDBSubnetGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"ModifyDBSubnetGroupResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSubnetGroups action.

", - "resultWrapper":"ModifyDBSubnetGroupResult" - }, - "errors":[ - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - { - "shape":"DBSubnetQuotaExceededFault", - "error":{ - "code":"DBSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of subnets in a DB subnet groups.

" - }, - { - "shape":"SubnetAlreadyInUse", - "error":{ - "code":"SubnetAlreadyInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet is already in use in the Availability Zone.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - } - ], - "documentation":"

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the region.

" - }, - "ModifyEventSubscription":{ - "name":"ModifyEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyEventSubscriptionMessage", - "documentation":"

" - }, - "output":{ - "shape":"ModifyEventSubscriptionResult", - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "resultWrapper":"ModifyEventSubscriptionResult" - }, - "errors":[ - { - "shape":"EventSubscriptionQuotaExceededFault", - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You have reached the maximum number of event subscriptions.

" - }, - { - "shape":"SubscriptionNotFoundFault", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - }, - { - "shape":"SNSInvalidTopicFault", - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

SNS has responded that there is a problem with the SND topic specified.

" - }, - { - "shape":"SNSNoAuthorizationFault", - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You do not have permission to publish to the SNS topic ARN.

" - }, - { - "shape":"SNSTopicArnNotFoundFault", - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The SNS topic ARN does not exist.

" - }, - { - "shape":"SubscriptionCategoryNotFoundFault", - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The supplied category does not exist.

" - } - ], - "documentation":"

Modifies an existing RDS event notification subscription. Note that you cannot modify the source identifiers using this call; to change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

You can see a list of the event categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "ModifyOptionGroup":{ - "name":"ModifyOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ModifyOptionGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"ModifyOptionGroupResult", - "wrapper":true, - "documentation":"

", - "resultWrapper":"ModifyOptionGroupResult" - }, - "errors":[ - { - "shape":"InvalidOptionGroupStateFault", - "error":{ - "code":"InvalidOptionGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group is not in the available state.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - } - ], - "documentation":"

Modifies an existing option group.

" - }, - "PromoteReadReplica":{ - "name":"PromoteReadReplica", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PromoteReadReplicaMessage", - "documentation":"

" - }, - "output":{ - "shape":"PromoteReadReplicaResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"PromoteReadReplicaResult" - }, - "errors":[ - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - } - ], - "documentation":"

Promotes a Read Replica DB instance to a standalone DB instance.

We recommend that you enable automated backups on your Read Replica before promoting the Read Replica. This ensures that no backup is taken during the promotion process. Once the instance is promoted to a primary instance, backups are taken based on your backup settings.

" - }, - "PurchaseReservedDBInstancesOffering":{ - "name":"PurchaseReservedDBInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"PurchaseReservedDBInstancesOfferingMessage", - "documentation":"

" - }, - "output":{ - "shape":"PurchaseReservedDBInstancesOfferingResult", - "wrapper":true, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstances and PurchaseReservedDBInstancesOffering actions.

", - "resultWrapper":"PurchaseReservedDBInstancesOfferingResult" - }, - "errors":[ - { - "shape":"ReservedDBInstancesOfferingNotFoundFault", - "error":{ - "code":"ReservedDBInstancesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified offering does not exist.

" - }, - { - "shape":"ReservedDBInstanceAlreadyExistsFault", - "error":{ - "code":"ReservedDBInstanceAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a reservation with the given identifier.

" - }, - { - "shape":"ReservedDBInstanceQuotaExceededFault", - "error":{ - "code":"ReservedDBInstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would exceed the user's DB Instance quota.

" - } - ], - "documentation":"

Purchases a reserved DB instance offering.

" - }, - "RebootDBInstance":{ - "name":"RebootDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RebootDBInstanceMessage", - "documentation":"

" - }, - "output":{ - "shape":"RebootDBInstanceResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"RebootDBInstanceResult" - }, - "errors":[ - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - } - ], - "documentation":"

Rebooting a DB instance restarts the database engine service. A reboot also applies to the DB instance any modifications to the associated DB parameter group that were pending. Rebooting a DB instance results in a momentary outage of the instance, during which the DB instance status is set to rebooting. If the RDS instance is configured for MultiAZ, it is possible that the reboot will be conducted through a failover. An Amazon RDS event is created when the reboot is completed.

If your DB instance is deployed in multiple Availability Zones, you can force a failover from one AZ to the other during the reboot. You might force a failover to test the availability of your DB instance deployment or to restore operations to the original AZ after a failover occurs.

The time required to reboot is a function of the specific database engine's crash recovery process. To improve the reboot time, we recommend that you reduce database activities as much as possible during the reboot process to reduce rollback activity for in-transit transactions.

" - }, - "RemoveSourceIdentifierFromSubscription":{ - "name":"RemoveSourceIdentifierFromSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RemoveSourceIdentifierFromSubscriptionMessage", - "documentation":"

" - }, - "output":{ - "shape":"RemoveSourceIdentifierFromSubscriptionResult", - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "resultWrapper":"RemoveSourceIdentifierFromSubscriptionResult" - }, - "errors":[ - { - "shape":"SubscriptionNotFoundFault", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - }, - { - "shape":"SourceNotFoundFault", - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested source could not be found.

" - } - ], - "documentation":"

Removes a source identifier from an existing RDS event notification subscription.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RemoveTagsFromResourceMessage", - "documentation":"

" - }, - "errors":[ - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - } - ], - "documentation":"

Removes metadata tags from an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources.

" - }, - "ResetDBParameterGroup":{ - "name":"ResetDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"ResetDBParameterGroupMessage", - "documentation":"

" - }, - "output":{ - "shape":"DBParameterGroupNameMessage", - "documentation":"

Contains the result of a successful invocation of the ModifyDBParameterGroup or ResetDBParameterGroup action.

", - "resultWrapper":"ResetDBParameterGroupResult" - }, - "errors":[ - { - "shape":"InvalidDBParameterGroupStateFault", - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB parameter group cannot be deleted because it is in use.

" - }, - { - "shape":"DBParameterGroupNotFoundFault", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - } - ], - "documentation":"

Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.

" - }, - "RestoreDBInstanceFromDBSnapshot":{ - "name":"RestoreDBInstanceFromDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RestoreDBInstanceFromDBSnapshotMessage", - "documentation":"

" - }, - "output":{ - "shape":"RestoreDBInstanceFromDBSnapshotResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"RestoreDBInstanceFromDBSnapshotResult" - }, - "errors":[ - { - "shape":"DBInstanceAlreadyExistsFault", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - { - "shape":"DBSnapshotNotFoundFault", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - }, - { - "shape":"InstanceQuotaExceededFault", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

" - }, - { - "shape":"InsufficientDBInstanceCapacityFault", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - { - "shape":"InvalidDBSnapshotStateFault", - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB snapshot does not allow deletion.

" - }, - { - "shape":"StorageQuotaExceededFault", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - { - "shape":"InvalidRestoreFault", - "error":{ - "code":"InvalidRestoreFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Cannot restore from vpc backup to non-vpc DB instance.

" - }, - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - }, - { - "shape":"ProvisionedIopsNotAvailableInAZFault", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"StorageTypeNotSupportedFault", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - } - ], - "documentation":"

Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with the same configuration as the original source database, except that the new RDS instance is created with the default security group.

If your intent is to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the RestoreDBInstanceFromDBSnapshot action. RDS does not allow two DB instances with the same name. Once you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as the DBInstanceIdentifier in the call to the RestoreDBInstanceFromDBSnapshot action. The result is that you will replace the original DB instance with the DB instance created from the snapshot.

" - }, - "RestoreDBInstanceToPointInTime":{ - "name":"RestoreDBInstanceToPointInTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RestoreDBInstanceToPointInTimeMessage", - "documentation":"

" - }, - "output":{ - "shape":"RestoreDBInstanceToPointInTimeResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

", - "resultWrapper":"RestoreDBInstanceToPointInTimeResult" - }, - "errors":[ - { - "shape":"DBInstanceAlreadyExistsFault", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - { - "shape":"DBInstanceNotFoundFault", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - { - "shape":"InstanceQuotaExceededFault", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

" - }, - { - "shape":"InsufficientDBInstanceCapacityFault", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - { - "shape":"InvalidDBInstanceStateFault", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - { - "shape":"PointInTimeRestoreNotEnabledFault", - "error":{ - "code":"PointInTimeRestoreNotEnabled", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

SourceDBInstanceIdentifier refers to a DB instance with BackupRetentionPeriod equal to 0.

" - }, - { - "shape":"StorageQuotaExceededFault", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - { - "shape":"InvalidVPCNetworkStateFault", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - { - "shape":"InvalidRestoreFault", - "error":{ - "code":"InvalidRestoreFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Cannot restore from vpc backup to non-vpc DB instance.

" - }, - { - "shape":"DBSubnetGroupNotFoundFault", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - { - "shape":"DBSubnetGroupDoesNotCoverEnoughAZs", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - { - "shape":"InvalidSubnet", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - }, - { - "shape":"ProvisionedIopsNotAvailableInAZFault", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - { - "shape":"OptionGroupNotFoundFault", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - { - "shape":"StorageTypeNotSupportedFault", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - } - ], - "documentation":"

Restores a DB instance to an arbitrary point-in-time. Users can restore to any point in time before the LatestRestorableTime for up to BackupRetentionPeriod days. The target database is created from the source database with the same configuration as the original database except that the DB instance is created with the default DB security group.

" - }, - "RevokeDBSecurityGroupIngress":{ - "name":"RevokeDBSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{ - "shape":"RevokeDBSecurityGroupIngressMessage", - "documentation":"

" - }, - "output":{ - "shape":"RevokeDBSecurityGroupIngressResult", - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSecurityGroups action.

", - "resultWrapper":"RevokeDBSecurityGroupIngressResult" - }, - "errors":[ - { - "shape":"DBSecurityGroupNotFoundFault", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - { - "shape":"AuthorizationNotFoundFault", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - }, - { - "shape":"InvalidDBSecurityGroupStateFault", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB security group does not allow deletion.

" - } - ], - "documentation":"

Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC Security Groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).

" - } - }, - "shapes":{ - "AddSourceIdentifierToSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to add a source identifier to.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source to be added. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.

Constraints:

  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.
  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.
  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.
  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.
" - } - }, - "documentation":"

" - }, - "AddTagsToResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource the tags will be added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the Amazon RDS resource.

" - } - }, - "documentation":"

" - }, - "ApplyMethod":{ - "type":"string", - "enum":[ - "immediate", - "pending-reboot" - ] - }, - "AuthorizationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified CIDRIP or EC2 security group is already authorized for the specified DB security group.

" - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified CIDRIP or EC2 security group is not authorized for the specified DB security group.

RDS may not also be authorized via IAM to perform necessary actions on your behalf.

" - }, - "AuthorizationQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"AuthorizationQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB security group authorization quota has been reached.

" - }, - "AuthorizeDBSecurityGroupIngressMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to add authorization to.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range to authorize.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

Name of the EC2 security group to authorize. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

Id of the EC2 security group to authorize. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

AWS Account Number of the owner of the EC2 security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - } - }, - "documentation":"

" - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the availability zone.

" - } - }, - "wrapper":true, - "documentation":"

Contains Availability Zone information.

This data type is used as an element in the following data type:

" - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"AvailabilityZone" - } - }, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "CharacterSet":{ - "type":"structure", - "members":{ - "CharacterSetName":{ - "shape":"String", - "documentation":"

The name of the character set.

" - }, - "CharacterSetDescription":{ - "shape":"String", - "documentation":"

The description of the character set.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "CopyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "SourceDBParameterGroupIdentifier", - "TargetDBParameterGroupIdentifier", - "TargetDBParameterGroupDescription" - ], - "members":{ - "SourceDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or ARN for the source DB parameter group.

Constraints:

  • Must specify a valid DB parameter group.
  • If the source DB parameter group is in the same region as the copy, specify a valid DB parameter group identifier, for example my-db-param-group, or a valid ARN.
  • If the source DB parameter group is in a different region than the copy, specify a valid DB parameter group ARN, for example arn:aws:rds:us-west-2:123456789012:pg:special-parameters.
" - }, - "TargetDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied DB parameter group.

Constraints:

  • Cannot be null, empty, or blank
  • Must contain from 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-parameter-group

" - }, - "TargetDBParameterGroupDescription":{ - "shape":"String", - "documentation":"

A description for the copied DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyDBSnapshotMessage":{ - "type":"structure", - "required":[ - "SourceDBSnapshotIdentifier", - "TargetDBSnapshotIdentifier" - ], - "members":{ - "SourceDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source DB snapshot.

Constraints:

  • Must specify a valid system snapshot in the \"available\" state.
  • If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
  • If the source snapshot is in a different region than the copy, specify a valid DB snapshot ARN. For more information, go to Copying a DB Snapshot.

Example: rds:mydb-2012-04-02-00-01

Example: arn:aws:rds:rr-regn-1:123456789012:snapshot:mysql-instance1-snapshot-20130805

" - }, - "TargetDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied snapshot.

Constraints:

  • Cannot be null, empty, or blank
  • Must contain from 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-snapshot

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyOptionGroupMessage":{ - "type":"structure", - "required":[ - "SourceOptionGroupIdentifier", - "TargetOptionGroupIdentifier", - "TargetOptionGroupDescription" - ], - "members":{ - "SourceOptionGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or ARN for the source option group.

Constraints:

  • Must specify a valid option group.
  • If the source option group is in the same region as the copy, specify a valid option group identifier, for example my-option-group, or a valid ARN.
  • If the source option group is in a different region than the copy, specify a valid option group ARN, for example arn:aws:rds:us-west-2:123456789012:og:special-options.
" - }, - "TargetOptionGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied option group.

Constraints:

  • Cannot be null, empty, or blank
  • Must contain from 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-option-group

" - }, - "TargetOptionGroupDescription":{ - "shape":"String", - "documentation":"

The description for the copied option group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBInstanceMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "AllocatedStorage", - "DBInstanceClass", - "Engine", - "MasterUsername", - "MasterUserPassword" - ], - "members":{ - "DBName":{ - "shape":"String", - "documentation":"

The meaning of this parameter differs according to the database engine you use.

Type: String

MySQL

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

  • Must contain 1 to 64 alphanumeric characters
  • Cannot be a word reserved by the specified database engine

PostgreSQL

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

  • Must contain 1 to 63 alphanumeric characters
  • Must begin with a letter or an underscore. Subsequent characters can be letters, underscores, or digits (0-9).
  • Cannot be a word reserved by the specified database engine

Oracle

The Oracle System ID (SID) of the created DB instance.

Default: ORCL

Constraints:

  • Cannot be longer than 8 characters

SQL Server

Not applicable. Must be null.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens (1 to 15 for SQL Server).
  • First character must be a letter.
  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gigabytes) to be initially allocated for the database instance.

Type: Integer

MySQL

Constraints: Must be an integer from 5 to 3072.

PostgreSQL

Constraints: Must be an integer from 5 to 3072.

Oracle

Constraints: Must be an integer from 10 to 3072.

SQL Server

Constraints: Must be an integer from 200 to 1024 (Standard Edition and Enterprise Edition) or from 20 to 1024 (Express Edition and Web Edition)

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the DB instance.

Valid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge | db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this instance.

Valid Values: MySQL | oracle-se1 | oracle-se | oracle-ee | sqlserver-ee | sqlserver-se | sqlserver-ex | sqlserver-web | postgres

Not every database engine is available for every AWS region.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name of master user for the client DB instance.

MySQL

Constraints:

  • Must be 1 to 16 alphanumeric characters.
  • First character must be a letter.
  • Cannot be a reserved word for the chosen database engine.

Type: String

Oracle

Constraints:

  • Must be 1 to 30 alphanumeric characters.
  • First character must be a letter.
  • Cannot be a reserved word for the chosen database engine.

SQL Server

Constraints:

  • Must be 1 to 128 alphanumeric characters.
  • First character must be a letter.
  • Cannot be a reserved word for the chosen database engine.
" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master database user. Can be any printable ASCII character except \"/\", \"\"\", or \"@\".

Type: String

MySQL

Constraints: Must contain from 8 to 41 characters.

Oracle

Constraints: Must contain from 8 to 30 characters.

SQL Server

Constraints: Must contain from 8 to 128 characters.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to associate with this DB instance.

Default: The default DB security group for the database engine.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with this DB instance.

Default: The default EC2 VPC security group for the DB subnet group's VPC.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the database instance will be created in. For information on regions and Availability Zones, see Regions and Availability Zones.

Default: A random, system-chosen Availability Zone in the endpoint's region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter cannot be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same region as the current endpoint.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB instance.

If there is no DB subnet group, then it is a non-VPC DB instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur. For more information, see DB Instance Maintenance.

Format: ddd:hh24:mi-ddd:hh24:mi

Default: A 30-minute window selected at random from an 8-hour block of time per region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine will be used.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Default: 1

Constraints:

  • Must be a value from 0 to 35
  • Cannot be set to 0 if the DB instance is a source to Read Replicas
" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. For more information, see DB Instance Backups.

Default: A 30-minute window selected at random from an 8-hour block of time per region. See the Amazon RDS User Guide for the time blocks for each region from which the default backup windows are assigned.

Constraints: Must be in the format hh24:mi-hh24:mi. Times should be Universal Time Coordinated (UTC). Must not conflict with the preferred maintenance window. Must be at least 30 minutes.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

MySQL

Default: 3306

Valid Values: 1150-65535

Type: Integer

PostgreSQL

Default: 5432

Valid Values: 1150-65535

Type: Integer

Oracle

Default: 1521

Valid Values: 1150-65535

SQL Server

Default: 1433

Valid Values: 1150-65535 except for 1434, 3389, 47001, 49152, and 49152 through 49156.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

The following are the database engines and major and minor versions that are available with Amazon RDS. Not every database engine is available for every AWS region.

MySQL

  • Version 5.1: 5.1.45 | 5.1.49 | 5.1.50 | 5.1.57 | 5.1.61 | 5.1.62 | 5.1.63 | 5.1.69 | 5.1.71 | 5.1.73
  • Version 5.5: 5.5.12 | 5.5.20 | 5.5.23 | 5.5.25a | 5.5.27 | 5.5.31 | 5.5.33 | 5.5.37 | 5.5.38 | 5.5.8
  • Version 5.6: 5.6.12 | 5.6.13 | 5.6.17 | 5.6.19 | 5.6.21

Oracle Database Enterprise Edition (oracle-ee)

  • Version 11.2: 11.2.0.2.v3 | 11.2.0.2.v4 | 11.2.0.2.v5 | 11.2.0.2.v6 | 11.2.0.2.v7 | 11.2.0.3.v1 | 11.2.0.4.v1

Oracle Database Standard Edition (oracle-se)

  • Version 11.2: 11.2.0.2.v3 | 11.2.0.2.v4 | 11.2.0.2.v5 | 11.2.0.2.v6 | 11.2.0.2.v7 | 11.2.0.3.v1 | 11.2.0.4.v1

Oracle Database Standard Edition One (oracle-se1)

  • Version 11.2: 11.2.0.2.v3 | 11.2.0.2.v4 | 11.2.0.2.v5 | 11.2.0.2.v6 | 11.2.0.2.v7 | 11.2.0.3.v1 | 11.2.0.4.v1

PostgreSQL

  • Version 9.3: 9.3.1 | 9.3.2 | 9.3.3

Microsoft SQL Server Enterprise Edition (sqlserver-ee)

  • Version 10.5: 10.50.2789.0.v1
  • Version 11.0: 11.00.2100.60.v1

Microsoft SQL Server Express Edition (sqlserver-ex)

  • Version 10.5: 10.50.2789.0.v1
  • Version 11.0: 11.00.2100.60.v1

Microsoft SQL Server Standard Edition (sqlserver-se)

  • Version 10.5: 10.50.2789.0.v1
  • Version 11.0: 11.00.2100.60.v1

Microsoft SQL Server Web Edition (sqlserver-web)

  • Version 10.5: 10.50.2789.0.v1
  • Version 11.0: 11.00.2100.60.v1
" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window.

Default: true

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

Constraints: To use PIOPS, this value must be an integer greater than 1000.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, cannot be removed from an option group, and that option group cannot be removed from a DB instance once it is associated with a DB instance

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

For supported engines, indicates that the DB instance should be associated with the specified CharacterSet.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether a VPC has been requested or not. The following list shows the default behavior in each case.

  • Default VPC:true
  • VPC:false

If no DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be publicly accessible. If a specific DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be private.

" - }, - "Tags":{"shape":"TagList"}, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB Instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the Key Store in order to access the device.

" - } - }, - "documentation":"

" - }, - "CreateDBInstanceReadReplicaMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "SourceDBInstanceIdentifier" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier of the Read Replica. This is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.

" - }, - "SourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB instance that will act as the source for the Read Replica. Each DB instance can have up to five Read Replicas.

Constraints:

  • Must be the identifier of an existing DB instance.
  • Can specify a DB instance that is a MySQL Read Replica only if the source is running MySQL 5.6.
  • Can specify a DB instance that is a PostgreSQL Read Replica only if the source is running PostgreSQL 9.3.5.
  • The specified DB instance must have automatic backups enabled, its backup retention period must be greater than 0.
  • If the source DB instance is in the same region as the Read Replica, specify a valid DB instance identifier.
  • If the source DB instance is in a different region than the Read Replica, specify a valid DB instance ARN. For more information, go to Constructing a Amazon RDS Amazon Resource Name (ARN).
" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Read Replica.

Valid Values: db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge | db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium

Default: Inherits from the source DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Amazon EC2 Availability Zone that the Read Replica will be created in.

Default: A random, system-chosen Availability Zone in the endpoint's region.

Example: us-east-1d

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number that the DB instance uses for connections.

Default: Inherits from the source DB instance

Valid Values: 1150-65535

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades will be applied automatically to the Read Replica during the maintenance window.

Default: Inherits from the source DB instance

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The option group the DB instance will be associated with. If omitted, the default option group for the engine specified will be used.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether a VPC has been requested or not. The following list shows the default behavior in each case.

  • Default VPC:true
  • VPC:false

If no DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be publicly accessible. If a specific DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be private.

" - }, - "Tags":{"shape":"TagList"}, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

Specifies a DB subnet group for the DB instance. The new DB instance will be created in the VPC associated with the DB subnet group. If no DB subnet group is specified, then the new DB instance is not created in a VPC.

Constraints:

  • Can only be specified if the source DB instance identifier specifies a DB instance in another region.
  • The specified DB subnet group must be in the same region in which the operation is running.
  • All Read Replicas in one region that are created from the same source DB instance must either:
    • Specify DB subnet groups from the same VPC. All these Read Replicas will be created in the same VPC.
    • Not specify a DB subnet group. All these Read Replicas will be created outside of any VPC.
" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB Instance Read Replica.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - } - } - }, - "CreateDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "DBParameterGroupFamily", - "Description" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
This value is stored as a lower-case string." - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSecurityGroupMessage":{ - "type":"structure", - "required":[ - "DBSecurityGroupName", - "DBSecurityGroupDescription" - ], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name for the DB security group. This value is stored as a lowercase string.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
  • Must not be \"Default\"
  • May not contain spaces

Example: mysecuritygroup

" - }, - "DBSecurityGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB security group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSnapshotMessage":{ - "type":"structure", - "required":[ - "DBSnapshotIdentifier", - "DBInstanceIdentifier" - ], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot.

Constraints:

  • Cannot be null, empty, or blank
  • Must contain from 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This is the unique key that identifies a DB instance.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "DBSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be \"Default\".

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 Subnet IDs for the DB subnet group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateEventSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SnsTopicArn" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the subscription.

Constraints: The name must be less than 255 characters.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

The list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.

Constraints:

  • If SourceIds are supplied, SourceType must also be provided.
  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.
  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.
  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.
  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.
" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateOptionGroupMessage":{ - "type":"structure", - "required":[ - "OptionGroupName", - "EngineName", - "MajorEngineVersion", - "OptionGroupDescription" - ], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the option group to be created.

Constraints:

  • Must be 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: myoptiongroup

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Specifies the name of the engine that this option group should be associated with.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Specifies the major version of the engine that this option group should be associated with.

" - }, - "OptionGroupDescription":{ - "shape":"String", - "documentation":"

The description of the option group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "DBEngineVersion":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family for the database engine.

" - }, - "DBEngineDescription":{ - "shape":"String", - "documentation":"

The description of the database engine.

" - }, - "DBEngineVersionDescription":{ - "shape":"String", - "documentation":"

The description of the database engine version.

" - }, - "DefaultCharacterSet":{ - "shape":"CharacterSet", - "documentation":"

The default character set for new instances of this engine version, if the CharacterSetName parameter of the CreateDBInstance API is not specified.

" - }, - "SupportedCharacterSets":{ - "shape":"SupportedCharacterSetsList", - "documentation":"

A list of the character sets supported by this engine for the CharacterSetName parameter of the CreateDBInstance API.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "DBEngineVersionList":{ - "type":"list", - "member":{ - "shape":"DBEngineVersion", - "locationName":"DBEngineVersion" - } - }, - "DBEngineVersionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBEngineVersions":{ - "shape":"DBEngineVersionList", - "documentation":"

A list of DBEngineVersion elements.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBEngineVersions action.

" - }, - "DBInstance":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied database identifier. This is the unique key that identifies a DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the name of the compute and memory capacity class of the DB instance.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Provides the name of the database engine to be used for this DB instance.

" - }, - "DBInstanceStatus":{ - "shape":"String", - "documentation":"

Specifies the current state of this database.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Contains the master username for the DB instance.

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The meaning of this parameter differs according to the database engine you use. For example, this value returns either MySQL or PostgreSQL information when returning values from CreateDBInstanceReadReplica since Read Replicas are only supported for MySQL and PostgreSQL.

MySQL, SQL Server, PostgreSQL

Contains the name of the initial database of this instance that was provided at create time, if one was specified when the DB instance was created. This same name is returned for the life of the DB instance.

Type: String

Oracle

Contains the Oracle System ID (SID) of the created DB instance. Not shown when the returned parameters do not apply to an Oracle DB instance.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

Specifies the connection endpoint.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size specified in gigabytes.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the date and time the DB instance was created.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

" - }, - "BackupRetentionPeriod":{ - "shape":"Integer", - "documentation":"

Specifies the number of days for which automatic DB snapshots are retained.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupMembershipList", - "documentation":"

Provides List of DB security group elements containing only DBSecurityGroup.Name and DBSecurityGroup.Status subelements.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

Provides List of VPC security group elements that the DB instance belongs to.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupStatusList", - "documentation":"

Provides the list of DB parameter groups applied to this DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Specifies the name of the Availability Zone the DB instance is located in.

" - }, - "DBSubnetGroup":{ - "shape":"DBSubnetGroup", - "documentation":"

Specifies information on the subnet group associated with the DB instance, including the name, description, and subnets in the subnet group.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range (in UTC) during which system maintenance can occur.

" - }, - "PendingModifiedValues":{ - "shape":"PendingModifiedValues", - "documentation":"

Specifies that changes to the DB instance are pending. This element is only included when changes are pending. Specific changes are identified by subelements.

" - }, - "LatestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the latest time to which a database can be restored with point-in-time restore.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that minor version patches are applied automatically.

" - }, - "ReadReplicaSourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the identifier of the source DB instance if this DB instance is a Read Replica.

" - }, - "ReadReplicaDBInstanceIdentifiers":{ - "shape":"ReadReplicaDBInstanceIdentifierList", - "documentation":"

Contains one or more identifiers of the Read Replicas associated with this DB instance.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the Provisioned IOPS (I/O operations per second) value.

" - }, - "OptionGroupMemberships":{ - "shape":"OptionGroupMembershipList", - "documentation":"

Provides the list of option group memberships for this DB instance.

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

If present, specifies the name of the character set that this instance is associated with.

" - }, - "SecondaryAvailabilityZone":{ - "shape":"String", - "documentation":"

If present, specifies the name of the secondary Availability Zone for a DB instance with multi-AZ support.

" - }, - "PubliclyAccessible":{ - "shape":"Boolean", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether a VPC has been requested or not. The following list shows the default behavior in each case.

  • Default VPC:true
  • VPC:false

If no DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be publicly accessible. If a specific DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be private.

" - }, - "StatusInfos":{ - "shape":"DBInstanceStatusInfoList", - "documentation":"

The status of a Read Replica. If the instance is not a Read Replica, this will be blank.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type associated with DB Instance.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which the instance is associated for TDE encryption.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBInstances action.

" - }, - "DBInstanceAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a DB instance with the given identifier.

" - }, - "DBInstanceList":{ - "type":"list", - "member":{ - "shape":"DBInstance", - "locationName":"DBInstance" - } - }, - "DBInstanceMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "DBInstances":{ - "shape":"DBInstanceList", - "documentation":"

A list of DBInstance instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBInstances action.

" - }, - "DBInstanceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBInstanceIdentifier does not refer to an existing DB instance.

" - }, - "DBInstanceStatusInfo":{ - "type":"structure", - "members":{ - "StatusType":{ - "shape":"String", - "documentation":"

This value is currently \"read replication.\"

" - }, - "Normal":{ - "shape":"Boolean", - "documentation":"

Boolean value that is true if the instance is operating normally, or false if the instance is in an error state.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Status of the DB instance. For a StatusType of read replica, the values can be replicating, error, stopped, or terminated.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Details of the error if there is an error for the instance. If the instance is not in an error state, this value is blank.

" - } - }, - "documentation":"

Provides a list of status information for a DB instance.

" - }, - "DBInstanceStatusInfoList":{ - "type":"list", - "member":{ - "shape":"DBInstanceStatusInfo", - "locationName":"DBInstanceStatusInfo" - } - }, - "DBParameterGroup":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group family that this DB parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides the customer-specified description for this DB parameter group.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the CreateDBParameterGroup action.

This data type is used as a request parameter in the DeleteDBParameterGroup action, and as a response element in the DescribeDBParameterGroups action.

" - }, - "DBParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB parameter group with the same name exists.

" - }, - "DBParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter values.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameters action.

" - }, - "DBParameterGroupList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroup", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the ModifyDBParameterGroup or ResetDBParameterGroup action.

" - }, - "DBParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBParameterGroupName does not refer to an existing DB parameter group.

" - }, - "DBParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB parameter groups.

" - }, - "DBParameterGroupStatus":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DP parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - } - }, - "documentation":"

The status of the DB parameter group.

This data type is used as a response element in the following actions:

" - }, - "DBParameterGroupStatusList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroupStatus", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupList", - "documentation":"

A list of DBParameterGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameterGroups action.

" - }, - "DBSecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

Provides the AWS ID of the owner of a specific DB security group.

" - }, - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the DB security group.

" - }, - "DBSecurityGroupDescription":{ - "shape":"String", - "documentation":"

Provides the description of the DB security group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VpcId of the DB security group.

" - }, - "EC2SecurityGroups":{ - "shape":"EC2SecurityGroupList", - "documentation":"

Contains a list of EC2SecurityGroup elements.

" - }, - "IPRanges":{ - "shape":"IPRangeList", - "documentation":"

Contains a list of IPRange elements.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSecurityGroups action.

" - }, - "DBSecurityGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB security group with the name specified in DBSecurityGroupName already exists.

" - }, - "DBSecurityGroupMembership":{ - "type":"structure", - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB security group.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "DBSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"DBSecurityGroupMembership", - "locationName":"DBSecurityGroup" - } - }, - "DBSecurityGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroups", - "documentation":"

A list of DBSecurityGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSecurityGroups action.

" - }, - "DBSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DBSecurityGroupName" - } - }, - "DBSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSecurityGroupName does not refer to an existing DB security group.

" - }, - "DBSecurityGroupNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSecurityGroupNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

A DB security group is not allowed for this action.

" - }, - "DBSecurityGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"QuotaExceeded.DBSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB security groups.

" - }, - "DBSecurityGroups":{ - "type":"list", - "member":{ - "shape":"DBSecurityGroup", - "locationName":"DBSecurityGroup" - } - }, - "DBSnapshot":{ - "type":"structure", - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier for the DB snapshot.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Specifies the DB instance identifier of the DB instance this DB snapshot was created from.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the time (UTC) when the snapshot was taken.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Specifies the name of the database engine.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size in gigabytes (GB).

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of this DB snapshot.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the database engine was listening on at the time of the snapshot.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Specifies the name of the Availability Zone the DB instance was located in at the time of the DB snapshot.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the Vpc Id associated with the DB snapshot.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time (UTC) when the snapshot was taken.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Provides the master username for the DB snapshot.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Specifies the version of the database engine.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

Provides the type of the DB snapshot.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Provides the option group name for the DB snapshot.

" - }, - "PercentProgress":{ - "shape":"Integer", - "documentation":"

The percentage of the estimated data that has been transferred.

" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The region that the DB snapshot was created in or copied from.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type associated with DB Snapshot.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which to associate the instance for TDE encryption.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSnapshots action.

" - }, - "DBSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

" - }, - "DBSnapshotList":{ - "type":"list", - "member":{ - "shape":"DBSnapshot", - "locationName":"DBSnapshot" - } - }, - "DBSnapshotMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSnapshots":{ - "shape":"DBSnapshotList", - "documentation":"

A list of DBSnapshot instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSnapshots action.

" - }, - "DBSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSnapshotIdentifier does not refer to an existing DB snapshot.

" - }, - "DBSubnetGroup":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the DB subnet group.

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

Provides the description of the DB subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VpcId of the DB subnet group.

" - }, - "SubnetGroupStatus":{ - "shape":"String", - "documentation":"

Provides the status of the DB subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Contains a list of Subnet elements.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSubnetGroups action.

" - }, - "DBSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName is already used by an existing DB subnet group.

" - }, - "DBSubnetGroupDoesNotCoverEnoughAZs":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

" - }, - "DBSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSubnetGroups":{ - "shape":"DBSubnetGroups", - "documentation":"

A list of DBSubnetGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSubnetGroups action.

" - }, - "DBSubnetGroupNotAllowedFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetGroupNotAllowedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Indicates that the DBSubnetGroup should not be specified while creating read replicas that lie in the same region as the source instance.

" - }, - "DBSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

DBSubnetGroupName does not refer to an existing DB subnet group.

" - }, - "DBSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB subnet groups.

" - }, - "DBSubnetGroups":{ - "type":"list", - "member":{ - "shape":"DBSubnetGroup", - "locationName":"DBSubnetGroup" - } - }, - "DBSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of subnets in a DB subnet groups.

" - }, - "DBUpgradeDependencyFailureFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"DBUpgradeDependencyFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB upgrade failed because a resource the DB depends on could not be modified.

" - }, - "DeleteDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier for the DB instance to be deleted. This parameter isn't case sensitive.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "SkipFinalSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted.

Specify true when deleting a Read Replica.

The FinalDBSnapshotIdentifier parameter must be specified if SkipFinalSnapshot is false.

Default: false

" - }, - "FinalDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
  • Cannot be specified when deleting a Read Replica.
" - } - }, - "documentation":"

" - }, - "DeleteDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be the name of an existing DB parameter group
  • You cannot delete a default DB parameter group
  • Cannot be associated with any DB instances
" - } - }, - "documentation":"

" - }, - "DeleteDBSecurityGroupMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to delete.

You cannot delete the default DB security group.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
  • Must not be \"Default\"
  • May not contain spaces
" - } - }, - "documentation":"

" - }, - "DeleteDBSnapshotMessage":{ - "type":"structure", - "required":["DBSnapshotIdentifier"], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DBSnapshot identifier.

Constraints: Must be the name of an existing DB snapshot in the available state.

" - } - }, - "documentation":"

" - }, - "DeleteDBSubnetGroupMessage":{ - "type":"structure", - "required":["DBSubnetGroupName"], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the database subnet group to delete.

You cannot delete the default subnet group.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to delete.

" - } - }, - "documentation":"

" - }, - "DeleteOptionGroupMessage":{ - "type":"structure", - "required":["OptionGroupName"], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be deleted.

You cannot delete default option groups." - } - }, - "documentation":"

" - }, - "DescribeDBEngineVersionsMessage":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The database engine to return.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The database engine version to return.

Example: 5.1.49

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group family to return details for.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DefaultOnly":{ - "shape":"Boolean", - "documentation":"

Indicates that only the default version of the specified engine or engine and major version combination is returned.

" - }, - "ListSupportedCharacterSets":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is specified, and if the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.

" - } - } - }, - "DescribeDBInstancesMessage":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case sensitive.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribeDBLogFilesDetails":{ - "type":"structure", - "members":{ - "LogFileName":{ - "shape":"String", - "documentation":"

The name of the log file for the specified DB instance.

" - }, - "LastWritten":{ - "shape":"Long", - "documentation":"

A POSIX timestamp when the last log entry was written.

" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size, in bytes, of the log file for the specified DB instance.

" - } - }, - "documentation":"

This data type is used as a response element to DescribeDBLogFiles.

" - }, - "DescribeDBLogFilesList":{ - "type":"list", - "member":{ - "shape":"DescribeDBLogFilesDetails", - "locationName":"DescribeDBLogFilesDetails" - } - }, - "DescribeDBLogFilesMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the DB instance that contains the log files you want to list.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "FilenameContains":{ - "shape":"String", - "documentation":"

Filters the available log files for log file names that contain the specified string.

" - }, - "FileLastWritten":{ - "shape":"Long", - "documentation":"

Filters the available log files for files written since the specified date, in POSIX timestamp format.

" - }, - "FileSize":{ - "shape":"Long", - "documentation":"

Filters the available log files for files larger than the specified size.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBLogFilesResponse":{ - "type":"structure", - "members":{ - "DescribeDBLogFiles":{ - "shape":"DescribeDBLogFilesList", - "documentation":"

The DB log files returned.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeDBLogFiles request.

" - } - }, - "documentation":"

The response from a call to DescribeDBLogFiles.

" - }, - "DescribeDBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return.

Default: All parameter types returned

Valid Values: user | system | engine-default

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeDBSecurityGroupsMessage":{ - "type":"structure", - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to return details for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSecurityGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBSnapshotsMessage":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

A DB instance identifier to retrieve the list of DB snapshots for. Cannot be used in conjunction with DBSnapshotIdentifier. This parameter is not case sensitive.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

A specific DB snapshot identifier to describe. Cannot be used in conjunction with DBInstanceIdentifier. This value is stored as a lowercase string.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
  • If this is the identifier of an automated snapshot, the SnapshotType parameter must also be specified.
" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The type of snapshots that will be returned. Values can be \"automated\" or \"manual.\" If not specified, the returned results will include all snapshots types.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group to return details for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSubnetGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupFamily"], - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

Not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEngineDefaultParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEventCategoriesMessage":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that will be generating the events.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to describe.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.

Constraints:

  • If SourceIdentifier is supplied, SourceType must also be provided.
  • If the source type is DBInstance, then a DBInstanceIdentifier must be supplied.
  • If the source type is DBSecurityGroup, a DBSecurityGroupName must be supplied.
  • If the source type is DBParameterGroup, a DBParameterGroupName must be supplied.
  • If the source type is DBSnapshot, a DBSnapshotIdentifier must be supplied.
  • Cannot end with a hyphen or contain two consecutive hyphens.
" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes to retrieve events for.

Default: 60

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories that trigger notifications for a event notification subscription.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results may be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOptionGroupOptionsMessage":{ - "type":"structure", - "required":["EngineName"], - "members":{ - "EngineName":{ - "shape":"String", - "documentation":"

A required parameter. Options available for the given Engine name will be described.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

If specified, filters the results to include only options for the specified major engine version.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOptionGroupsMessage":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to describe. Cannot be supplied together with EngineName or MajorEngineVersion.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOptionGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Filters the list of option groups to only include groups associated with a specific database engine.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Filters the list of option groups to only include groups associated with a specific database engine version. If specified, then EngineName must also be specified.

" - } - }, - "documentation":"

" - }, - "DescribeOrderableDBInstanceOptionsMessage":{ - "type":"structure", - "required":["Engine"], - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the engine to retrieve DB instance options for.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.

" - }, - "Vpc":{ - "shape":"BooleanOptional", - "documentation":"

The VPC filter value. Specify this parameter to show only the available VPC or non-VPC offerings.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribeReservedDBInstancesMessage":{ - "type":"structure", - "members":{ - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

The reserved DB instance identifier filter value. Specify this parameter to show only the reservation that matches the specified reservation ID.

" - }, - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Specify this parameter to show only purchased reservations matching the specified offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only those reservations matching the specified DB instances class.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

The duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Specify this parameter to show only those reservations matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

The Multi-AZ filter value. Specify this parameter to show only those reservations matching the specified Multi-AZ parameter.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReservedDBInstancesOfferingsMessage":{ - "type":"structure", - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Specify this parameter to show only the available offering that matches the specified reservation identifier.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

Duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

Product description filter value. Specify this parameter to show only the available offerings matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

The Multi-AZ filter value. Specify this parameter to show only the available offerings matching the specified Multi-AZ parameter.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: minimum 20, maximum 100

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "Double":{"type":"double"}, - "DownloadDBLogFilePortionDetails":{ - "type":"structure", - "members":{ - "LogFileData":{ - "shape":"String", - "documentation":"

Entries from the specified log file.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DownloadDBLogFilePortion request.

" - }, - "AdditionalDataPending":{ - "shape":"Boolean", - "documentation":"

Boolean value that if true, indicates there is more data to be downloaded.

" - } - }, - "documentation":"

This data type is used as a response element to DownloadDBLogFilePortion.

" - }, - "DownloadDBLogFilePortionMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "LogFileName" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the DB instance that contains the log files you want to list.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "LogFileName":{ - "shape":"String", - "documentation":"

The name of the log file to be downloaded.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

The pagination token provided in the previous request or \"0\". If the Marker parameter is specified the response includes only records beyond the marker until the end of the file or up to NumberOfLines.

" - }, - "NumberOfLines":{ - "shape":"Integer", - "documentation":"

The number of lines to download.

If the NumberOfLines parameter is specified, then the block of lines returned can be from the beginning or the end of the log file, depending on the value of the Marker parameter.

  • If neither Marker or NumberOfLines are specified, the entire log file is returned.

  • If NumberOfLines is specified and Marker is not specified, then the most recent lines from the end of the log file are returned.

  • If Marker is specified as \"0\", then the specified number of lines from the beginning of the log file are returned.

  • You can download the log file in blocks of lines by specifying the size of the block using the NumberOfLines parameter, and by specifying a value of \"0\" for the Marker parameter in your first request. Include the Marker value returned in the response as the Marker value for the next request, continuing until the AdditionalDataPending response element returns false.

" - } - }, - "documentation":"

" - }, - "EC2SecurityGroup":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

Provides the status of the EC2 security group. Status can be \"authorizing\", \"authorized\", \"revoking\", and \"revoked\".

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the EC2 security group.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

Specifies the id of the EC2 security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

Specifies the AWS ID of the owner of the EC2 security group specified in the EC2SecurityGroupName field.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "EC2SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"EC2SecurityGroup", - "locationName":"EC2SecurityGroup" - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

Specifies the DNS address of the DB instance.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the database engine is listening on.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "EngineDefaults":{ - "type":"structure", - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Specifies the name of the DB parameter group family which the engine default parameters apply to.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous EngineDefaults request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Contains a list of engine default parameters.

" - } - }, - "wrapper":true, - "documentation":"

Contains the result of a successful invocation of the DescribeEngineDefaultParameters action.

" - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

Provides the identifier for the source of the event.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the source type for this event.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Provides the text of this event.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

Specifies the category for the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

Specifies the date and time of the event.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeEvents action.

" - }, - "EventCategoriesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"EventCategory" - } - }, - "EventCategoriesMap":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The source type that the returned categories belong to

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

The event categories for the specified source type

" - } - }, - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventCategories action.

" - }, - "EventCategoriesMapList":{ - "type":"list", - "member":{ - "shape":"EventCategoriesMap", - "locationName":"EventCategoriesMap" - } - }, - "EventCategoriesMessage":{ - "type":"structure", - "members":{ - "EventCategoriesMapList":{ - "shape":"EventCategoriesMapList", - "documentation":"

A list of EventCategoriesMap data types.

" - } - }, - "documentation":"

Data returned from the DescribeEventCategories action.

" - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventSubscription":{ - "type":"structure", - "members":{ - "CustomerAwsId":{ - "shape":"String", - "documentation":"

The AWS customer account associated with the RDS event notification subscription.

" - }, - "CustSubscriptionId":{ - "shape":"String", - "documentation":"

The RDS event notification subscription Id.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The topic ARN of the RDS event notification subscription.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the RDS event notification subscription.

Constraints:

Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist

The status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.

" - }, - "SubscriptionCreationTime":{ - "shape":"String", - "documentation":"

The time the RDS event notification subscription was created.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The source type for the RDS event notification subscription.

" - }, - "SourceIdsList":{ - "shape":"SourceIdsList", - "documentation":"

A list of source IDs for the RDS event notification subscription.

" - }, - "EventCategoriesList":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for the RDS event notification subscription.

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

A Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.

" - } - }, - "wrapper":true, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

" - }, - "EventSubscriptionQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You have reached the maximum number of event subscriptions.

" - }, - "EventSubscriptionsList":{ - "type":"list", - "member":{ - "shape":"EventSubscription", - "locationName":"EventSubscription" - } - }, - "EventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "EventSubscriptionsList":{ - "shape":"EventSubscriptionsList", - "documentation":"

A list of EventSubscriptions data types.

" - } - }, - "documentation":"

Data returned by the DescribeEventSubscriptions action.

" - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous Events request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of Event instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeEvents action.

" - }, - "Filter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

This parameter is not currently supported.

" - }, - "Values":{ - "shape":"FilterValueList", - "documentation":"

This parameter is not currently supported.

" - } - } - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FilterValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Value" - } - }, - "IPRange":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of the IP range. Status can be \"authorizing\", \"authorized\", \"revoking\", and \"revoked\".

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

Specifies the IP range.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBSecurityGroups action.

" - }, - "IPRangeList":{ - "type":"list", - "member":{ - "shape":"IPRange", - "locationName":"IPRange" - } - }, - "InstanceQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB instances.

" - }, - "InsufficientDBInstanceCapacityFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified DB instance class is not available in the specified Availability Zone.

" - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidDBInstanceStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified DB instance is not in the available state.

" - }, - "InvalidDBParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB parameter group cannot be deleted because it is in use.

" - }, - "InvalidDBSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB security group does not allow deletion.

" - }, - "InvalidDBSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The state of the DB snapshot does not allow deletion.

" - }, - "InvalidDBSubnetGroupFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBSubnetGroupFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Indicates the DBSubnetGroup does not belong to the same VPC as that of an existing cross region read replica of the same source instance.

" - }, - "InvalidDBSubnetGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBSubnetGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet group cannot be deleted because it is in use.

" - }, - "InvalidDBSubnetStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidDBSubnetStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet is not in the available state.

" - }, - "InvalidEventSubscriptionStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidEventSubscriptionState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

This error can occur if someone else is modifying a subscription. You should retry the action.

" - }, - "InvalidOptionGroupStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidOptionGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group is not in the available state.

" - }, - "InvalidRestoreFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidRestoreFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Cannot restore from vpc backup to non-vpc DB instance.

" - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

" - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

DB subnet group does not cover all Availability Zones after it is created because users' change.

" - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceName"], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource with tags to be listed. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "Long":{"type":"long"}, - "ModifyDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

  • Must be the identifier for an existing DB instance
  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The new storage capacity of the RDS instance. Changing this setting does not result in an outage and the change is applied during the next maintenance window unless ApplyImmediately is set to true for this request.

MySQL

Default: Uses existing setting

Valid Values: 5-3072

Constraints: Value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

Type: Integer

PostgreSQL

Default: Uses existing setting

Valid Values: 5-3072

Constraints: Value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

Type: Integer

Oracle

Default: Uses existing setting

Valid Values: 10-3072

Constraints: Value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

SQL Server

Cannot be modified.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance will be available for use, but may experience performance degradation. While the migration takes place, nightly backups for the instance will be suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a read replica for the instance, and creating a DB snapshot of the instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The new compute and memory capacity of the DB instance. To determine the instance classes that are available for a particular DB engine, use the DescribeOrderableDBInstanceOptions action.

Passing a value for this setting causes an outage during the change and is applied during the next maintenance window, unless ApplyImmediately is specified as true for this request.

Default: Uses existing setting

Valid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge | db.m2.2xlarge | db.m2.4xlarge | db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to authorize on this DB instance. Changing this setting does not result in an outage and the change is asynchronously applied as soon as possible.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to authorize on this DB instance. This change is asynchronously applied as soon as possible.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Specifies whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the PreferredMaintenanceWindow setting for the DB instance.

If this parameter is set to false, changes to the DB instance are applied during the next maintenance window. Some parameter changes can cause an outage and will be applied on the next call to RebootDBInstance, or the next failure reboot. Review the table of parameters in Modifying a DB Instance and Using the Apply Immediately Parameter to see the impact that setting ApplyImmediately to true or false has for each modified parameter and to determine when the changes will be applied.

Default: false

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the DB instance master user. Can be any printable ASCII character except \"/\", \"\"\", or \"@\".

Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible. Between the time of the request and the completion of the request, the MasterUserPassword element exists in the PendingModifiedValues element of the operation response.

Default: Uses existing setting

Constraints: Must be 8 to 41 alphanumeric characters (MySQL), 8 to 30 alphanumeric characters (Oracle), or 8 to 128 alphanumeric characters (SQL Server).

Amazon RDS API actions never return the password, so this action provides a way to regain access to a master instance user if the password is lost. This includes restoring privileges that may have been accidentally revoked. " - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to apply to the DB instance. Changing this setting does not result in an outage. The parameter group name itself is changed immediately, but the actual parameter changes are not applied until you reboot the instance without failover. The db instance will NOT be rebooted automatically and the parameter changes will NOT be applied during the next maintenance window.

Default: Uses existing setting

Constraints: The DB parameter group must be in the same DB parameter group family as this DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Changing this parameter can result in an outage if you change from 0 to a non-zero value or from a non-zero value to 0. These changes are applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you change the parameter from one non-zero value to another non-zero value, the change is asynchronously applied as soon as possible.

Default: Uses existing setting

Constraints:

  • Must be a value from 0 to 35
  • Can be specified for a MySQL Read Replica only if the source is running MySQL 5.6
  • Can be specified for a PostgreSQL Read Replica only if the source is running PostgreSQL 9.3.5
  • Cannot be set to 0 if the DB instance is a source to Read Replicas
" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

Constraints:

  • Must be in the format hh24:mi-hh24:mi
  • Times should be Universal Time Coordinated (UTC)
  • Must not conflict with the preferred maintenance window
  • Must be at least 30 minutes
" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur, which may result in an outage. Changing this parameter does not result in an outage, except in the following situation, and the change is asynchronously applied as soon as possible. If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, then changing this parameter will cause a reboot of the DB instance. If moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure pending changes are applied.

Default: Uses existing setting

Format: ddd:hh24:mi-ddd:hh24:mi

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Must be at least 30 minutes

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. Changing this parameter does not result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

Constraints: Cannot be specified if the DB instance is a Read Replica.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

For major version upgrades, if a non-default DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.

For a list of valid engine versions, see CreateDBInstance.

" - }, - "AllowMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that major version upgrades are allowed. Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.

Constraints: This parameter must be set to true when specifying a value for the EngineVersion parameter that is a different major version than the DB instance's current version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades will be applied automatically to the DB instance during the maintenance window. Changing this parameter does not result in an outage except in the following case and the change is asynchronously applied as soon as possible. An outage will result if this parameter is set to true during the maintenance window, and a newer minor version is available, and RDS has enabled auto patching for that engine version.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The new Provisioned IOPS (I/O operations per second) value for the RDS instance. Changing this setting does not result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

Default: Uses existing setting

Constraints: Value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value. If you are migrating from Provisioned IOPS to standard storage, set this value to 0. The DB instance will require a reboot for the change in storage type to take effect.

SQL Server

Setting the IOPS value for the SQL Server database engine is not supported.

Type: Integer

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance will be available for use, but may experience performance degradation. While the migration takes place, nightly backups for the instance will be suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a read replica for the instance, and creating a DB snapshot of the instance.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group. Changing this parameter does not result in an outage except in the following case and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, cannot be removed from an option group, and that option group cannot be removed from a DB instance once it is associated with a DB instance

" - }, - "NewDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot will occur immediately if you set Apply Immediately to true, or will occur during the next maintenance window if Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB Instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the Key Store in order to access the device.

" - } - }, - "documentation":"

" - }, - "ModifyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "Parameters" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be the name of an existing DB parameter group
  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters may be modified in a single request.

Valid Values (for the application method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when you reboot the DB instance without failover. " - } - }, - "documentation":"

" - }, - "ModifyDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be \"Default\".

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the DB subnet group.

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription.

" - } - }, - "documentation":"

" - }, - "ModifyOptionGroupMessage":{ - "type":"structure", - "required":["OptionGroupName"], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be modified.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, cannot be removed from an option group, and that option group cannot be removed from a DB instance once it is associated with a DB instance

" - }, - "OptionsToInclude":{ - "shape":"OptionConfigurationList", - "documentation":"

Options in this list are added to the option group or, if already present, the specified configuration is used to update the existing configuration.

" - }, - "OptionsToRemove":{ - "shape":"OptionNamesList", - "documentation":"

Options in this list are removed from the option group.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Indicates whether the changes should be applied immediately, or during the next maintenance window for each instance associated with the option group.

" - } - }, - "documentation":"

" - }, - "Option":{ - "type":"structure", - "members":{ - "OptionName":{ - "shape":"String", - "documentation":"

The name of the option.

" - }, - "OptionDescription":{ - "shape":"String", - "documentation":"

The description of the option.

" - }, - "Persistent":{ - "shape":"Boolean", - "documentation":"

Indicate if this option is persistent.

" - }, - "Permanent":{ - "shape":"Boolean", - "documentation":"

Indicate if this option is permanent.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

If required, the port configured for this option to use.

" - }, - "OptionSettings":{ - "shape":"OptionSettingConfigurationList", - "documentation":"

The option settings for this option.

" - }, - "DBSecurityGroupMemberships":{ - "shape":"DBSecurityGroupMembershipList", - "documentation":"

If the option requires access to a port, then this DB security group allows access to the port.

" - }, - "VpcSecurityGroupMemberships":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

If the option requires access to a port, then this VPC security group allows access to the port.

" - } - }, - "documentation":"

Option details.

" - }, - "OptionConfiguration":{ - "type":"structure", - "required":["OptionName"], - "members":{ - "OptionName":{ - "shape":"String", - "documentation":"

The configuration of options to include in a group.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The optional port for the option.

" - }, - "DBSecurityGroupMemberships":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DBSecurityGroupMemebrship name strings used for this option.

" - }, - "VpcSecurityGroupMemberships":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VpcSecurityGroupMemebrship name strings used for this option.

" - }, - "OptionSettings":{ - "shape":"OptionSettingsList", - "documentation":"

The option settings to include in an option group.

" - } - }, - "documentation":"

A list of all available options

" - }, - "OptionConfigurationList":{ - "type":"list", - "member":{ - "shape":"OptionConfiguration", - "locationName":"OptionConfiguration" - } - }, - "OptionGroup":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the option group.

" - }, - "OptionGroupDescription":{ - "shape":"String", - "documentation":"

Provides a description of the option group.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Engine name that this option group can be applied to.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Indicates the major engine version associated with this option group.

" - }, - "Options":{ - "shape":"OptionsList", - "documentation":"

Indicates what options are available in the option group.

" - }, - "AllowsVpcAndNonVpcInstanceMemberships":{ - "shape":"Boolean", - "documentation":"

Indicates whether this option group can be applied to both VPC and non-VPC instances. The value true indicates the option group can be applied to both VPC and non-VPC instances.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

If AllowsVpcAndNonVpcInstanceMemberships is false, this field is blank. If AllowsVpcAndNonVpcInstanceMemberships is true and this field is blank, then this option group can be applied to both VPC and non-VPC instances. If this field contains a value, then this option group can only be applied to instances that are in the VPC indicated by this field.

" - } - }, - "wrapper":true, - "documentation":"

" - }, - "OptionGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"OptionGroupAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The option group you are trying to create already exists.

" - }, - "OptionGroupMembership":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group that the instance belongs to.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).

" - } - }, - "documentation":"

Provides information on the option groups the DB instance is a member of.

" - }, - "OptionGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"OptionGroupMembership", - "locationName":"OptionGroupMembership" - } - }, - "OptionGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified option group could not be found.

" - }, - "OptionGroupOption":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the option.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the option.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

The name of the engine that this option can be applied to.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Indicates the major engine version that the option is available for.

" - }, - "MinimumRequiredMinorEngineVersion":{ - "shape":"String", - "documentation":"

The minimum required engine version for the option to be applied.

" - }, - "PortRequired":{ - "shape":"Boolean", - "documentation":"

Specifies whether the option requires a port.

" - }, - "DefaultPort":{ - "shape":"IntegerOptional", - "documentation":"

If the option requires a port, specifies the default port for the option.

" - }, - "OptionsDependedOn":{ - "shape":"OptionsDependedOn", - "documentation":"

List of all options that are prerequisites for this option.

" - }, - "Persistent":{ - "shape":"Boolean", - "documentation":"

A persistent option cannot be removed from the option group once the option group is used, but this option can be removed from the db instance while modifying the related data and assigning another option group without this option.

" - }, - "Permanent":{ - "shape":"Boolean", - "documentation":"

A permanent option cannot be removed from the option group once the option group is used, and it cannot be removed from the db instance after assigning an option group with this permanent option.

" - }, - "OptionGroupOptionSettings":{ - "shape":"OptionGroupOptionSettingsList", - "documentation":"

Specifies the option settings that are available (and the default value) for each option in an option group.

" - } - }, - "documentation":"

Available option.

" - }, - "OptionGroupOptionSetting":{ - "type":"structure", - "members":{ - "SettingName":{ - "shape":"String", - "documentation":"

The name of the option group option.

" - }, - "SettingDescription":{ - "shape":"String", - "documentation":"

The description of the option group option.

" - }, - "DefaultValue":{ - "shape":"String", - "documentation":"

The default value for the option group option.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

The DB engine specific parameter type for the option group option.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

Indicates the acceptable values for the option group option.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Boolean value where true indicates that this option group option can be changed from the default value.

" - } - }, - "documentation":"

Option group option settings are used to display settings available for each option with their default values and other information. These values are used with the DescribeOptionGroupOptions action.

" - }, - "OptionGroupOptionSettingsList":{ - "type":"list", - "member":{ - "shape":"OptionGroupOptionSetting", - "locationName":"OptionGroupOptionSetting" - } - }, - "OptionGroupOptionsList":{ - "type":"list", - "member":{ - "shape":"OptionGroupOption", - "locationName":"OptionGroupOption" - }, - "documentation":"

List of available option group options.

" - }, - "OptionGroupOptionsMessage":{ - "type":"structure", - "members":{ - "OptionGroupOptions":{"shape":"OptionGroupOptionsList"}, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "OptionGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"OptionGroupQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The quota of 20 option groups was exceeded for this AWS account.

" - }, - "OptionGroups":{ - "type":"structure", - "members":{ - "OptionGroupsList":{ - "shape":"OptionGroupsList", - "documentation":"

List of option groups.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

List of option groups.

" - }, - "OptionGroupsList":{ - "type":"list", - "member":{ - "shape":"OptionGroup", - "locationName":"OptionGroup" - } - }, - "OptionNamesList":{ - "type":"list", - "member":{"shape":"String"} - }, - "OptionSetting":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the option that has settings that you can set.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The current value of the option setting.

" - }, - "DefaultValue":{ - "shape":"String", - "documentation":"

The default value of the option setting.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the option setting.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

The DB engine specific parameter type.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The data type of the option setting.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The allowed values of the option setting.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

A Boolean value that, when true, indicates the option setting can be modified from the default.

" - }, - "IsCollection":{ - "shape":"Boolean", - "documentation":"

Indicates if the option setting is part of a collection.

" - } - }, - "documentation":"

Option settings are the actual settings being applied or configured for that option. It is used when you modify an option group or describe option groups. For example, the NATIVE_NETWORK_ENCRYPTION option has a setting called SQLNET.ENCRYPTION_SERVER that can have several different values.

" - }, - "OptionSettingConfigurationList":{ - "type":"list", - "member":{ - "shape":"OptionSetting", - "locationName":"OptionSetting" - } - }, - "OptionSettingsList":{ - "type":"list", - "member":{ - "shape":"OptionSetting", - "locationName":"OptionSetting" - } - }, - "OptionsDependedOn":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"OptionName" - } - }, - "OptionsList":{ - "type":"list", - "member":{ - "shape":"Option", - "locationName":"Option" - } - }, - "OrderableDBInstanceOption":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The engine type of the orderable DB instance.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version of the orderable DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance Class for the orderable DB instance

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for the orderable DB instance.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

A list of availability zones for the orderable DB instance.

" - }, - "MultiAZCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether this orderable DB instance is multi-AZ capable.

" - }, - "ReadReplicaCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether this orderable DB instance can have a Read Replica.

" - }, - "Vpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether this is a VPC orderable DB instance.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

The storage type for this orderable DB instance.

" - }, - "SupportsIops":{ - "shape":"Boolean", - "documentation":"

Indicates whether this orderable DB instance supports provisioned IOPS.

" - } - }, - "wrapper":true, - "documentation":"

Contains a list of available options for a DB instance

This data type is used as a response element in the DescribeOrderableDBInstanceOptions action.

" - }, - "OrderableDBInstanceOptionsList":{ - "type":"list", - "member":{ - "shape":"OrderableDBInstanceOption", - "locationName":"OrderableDBInstanceOption" - } - }, - "OrderableDBInstanceOptionsMessage":{ - "type":"structure", - "members":{ - "OrderableDBInstanceOptions":{ - "shape":"OrderableDBInstanceOptionsList", - "documentation":"

An OrderableDBInstanceOption structure containing information about orderable options for the DB instance.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous OrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeOrderableDBInstanceOptions action.

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

Specifies the name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

Specifies the value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides a description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

Indicates the source of the parameter value.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

Specifies the engine specific parameters type.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

Specifies the valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

Specifies the valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest engine version to which the parameter can apply.

" - }, - "ApplyMethod":{ - "shape":"ApplyMethod", - "documentation":"

Indicates when to apply parameter updates.

" - } - }, - "documentation":"

This data type is used as a request parameter in the ModifyDBParameterGroup and ResetDBParameterGroup actions.

This data type is used as a response element in the DescribeEngineDefaultParameters and DescribeDBParameters actions.

" - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceClass for the DB instance that will be applied or is in progress.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

Contains the new AllocatedStorage size for the DB instance that will be applied or is in progress.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

Contains the pending or in-progress change of the master credentials for the DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending port for the DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending number of days for which automated backups are retained.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that the Single-AZ DB instance is to change to a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the new Provisioned IOPS value for the DB instance that will be applied or is being applied.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceIdentifier for the DB instance that will be applied or is in progress.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB instance.

" - } - }, - "documentation":"

This data type is used as a response element in the ModifyDBInstance action.

" - }, - "PointInTimeRestoreNotEnabledFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"PointInTimeRestoreNotEnabled", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

SourceDBInstanceIdentifier refers to a DB instance with BackupRetentionPeriod equal to 0.

" - }, - "PromoteReadReplicaMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

  • Must be the identifier for an existing Read Replica DB instance
  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: mydbinstance

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Default: 1

Constraints:

  • Must be a value from 0 to 8
" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

Default: A 30-minute window selected at random from an 8-hour block of time per region. See the Amazon RDS User Guide for the time blocks for each region from which the default backup windows are assigned.

Constraints: Must be in the format hh24:mi-hh24:mi. Times should be Universal Time Coordinated (UTC). Must not conflict with the preferred maintenance window. Must be at least 30 minutes.

" - } - }, - "documentation":"

" - }, - "ProvisionedIopsNotAvailableInAZFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

" - }, - "PurchaseReservedDBInstancesOfferingMessage":{ - "type":"structure", - "required":["ReservedDBInstancesOfferingId"], - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved DB instance offering to purchase.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

Customer-specified identifier to track this reservation.

Example: myreservationID

" - }, - "DBInstanceCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of instances to reserve.

Default: 1

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "ReadReplicaDBInstanceIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaDBInstanceIdentifier" - } - }, - "RebootDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "ForceFailover":{ - "shape":"BooleanOptional", - "documentation":"

When true, the reboot will be conducted through a MultiAZ failover.

Constraint: You cannot specify true if the instance is not configured for MultiAZ.

" - } - }, - "documentation":"

" - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency of the recurring charge.

" - } - }, - "wrapper":true, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstances and DescribeReservedDBInstancesOfferings actions.

" - }, - "RecurringChargeList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"RecurringCharge" - } - }, - "RemoveSourceIdentifierFromSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to remove a source identifier from.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The source identifier to be removed from the subscription, such as the DB instance identifier for a DB instance or the name of a security group.

" - } - }, - "documentation":"

" - }, - "RemoveTagsFromResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource the tags will be removed from. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

The tag key (name) of the tag to be removed.

" - } - }, - "documentation":"

" - }, - "ReservedDBInstance":{ - "type":"structure", - "members":{ - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for the reserved DB instance.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The time the reservation started.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this reserved DB instance.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this reserved DB instance.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved DB instance.

" - }, - "DBInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reserved DB instances.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The description of the reserved DB instance.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type of this reserved DB instance.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Indicates if the reservation applies to Multi-AZ deployments.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved DB instance.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved DB instance.

" - } - }, - "wrapper":true, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstances and PurchaseReservedDBInstancesOffering actions.

" - }, - "ReservedDBInstanceAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedDBInstanceAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

User already has a reservation with the given identifier.

" - }, - "ReservedDBInstanceList":{ - "type":"list", - "member":{ - "shape":"ReservedDBInstance", - "locationName":"ReservedDBInstance" - } - }, - "ReservedDBInstanceMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReservedDBInstances":{ - "shape":"ReservedDBInstanceList", - "documentation":"

A list of reserved DB instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstances action.

" - }, - "ReservedDBInstanceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedDBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified reserved DB Instance not found.

" - }, - "ReservedDBInstanceQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedDBInstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would exceed the user's DB Instance quota.

" - }, - "ReservedDBInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for the reserved DB instance.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this offering.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved DB instance offering.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The database engine used by the offering.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Indicates if the offering applies to Multi-AZ deployments.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved DB instance.

" - } - }, - "wrapper":true, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstancesOfferings action.

" - }, - "ReservedDBInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedDBInstancesOffering", - "locationName":"ReservedDBInstancesOffering" - } - }, - "ReservedDBInstancesOfferingMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReservedDBInstancesOfferings":{ - "shape":"ReservedDBInstancesOfferingList", - "documentation":"

A list of reserved DB instance offerings.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstancesOfferings action.

" - }, - "ReservedDBInstancesOfferingNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"ReservedDBInstancesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

Specified offering does not exist.

" - }, - "ResetDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) to reset all parameters in the DB parameter group to default values.

Default: true

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters may be modified in a single request.

MySQL

Valid Values (for Apply method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when DB instance reboots.

Oracle

Valid Values (for Apply method): pending-reboot

" - } - }, - "documentation":"

" - }, - "RestoreDBInstanceFromDBSnapshotMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "DBSnapshotIdentifier" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Name of the DB instance to create from the DB snapshot. This parameter isn't case sensitive.

Constraints:

  • Must contain from 1 to 255 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot to restore from.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Amazon RDS DB instance.

Valid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge | db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Default: The same port as the original DB instance

Constraints: Value must be 1150-65535

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the database instance will be created in.

Default: A random, system-chosen Availability Zone.

Constraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new instance.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

Constraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether a VPC has been requested or not. The following list shows the default behavior in each case.

  • Default VPC:true
  • VPC:false

If no DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be publicly accessible. If a specific DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be private.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades will be applied automatically to the DB instance during the maintenance window.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

Default: Same as source.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The database name for the restored DB instance.

This parameter doesn't apply to the MySQL engine.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new instance.

Default: The same as source

Constraint: Must be compatible with the engine of the source

Valid Values: MySQL | oracle-se1 | oracle-se | oracle-ee | sqlserver-ee | sqlserver-se | sqlserver-ex | sqlserver-web | postgres

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the amount of provisioned IOPS for the DB instance, expressed in I/O operations per second. If this parameter is not specified, the IOPS value will be taken from the backup. If this parameter is set to 0, the new instance will be converted to a non-PIOPS instance, which will take additional time, though your DB instance will be available for connections before the conversion starts.

Constraints: Must be an integer greater than 1000.

SQL Server

Setting the IOPS value for the SQL Server database engine is not supported.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be used for the restored DB instance.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, cannot be removed from an option group, and that option group cannot be removed from a DB instance once it is associated with a DB instance

" - }, - "Tags":{"shape":"TagList"}, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB Instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the Key Store in order to access the device.

" - } - }, - "documentation":"

" - }, - "RestoreDBInstanceToPointInTimeMessage":{ - "type":"structure", - "required":[ - "SourceDBInstanceIdentifier", - "TargetDBInstanceIdentifier" - ], - "members":{ - "SourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the source DB instance from which to restore.

Constraints:

  • Must be the identifier of an existing database instance
  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "TargetDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The name of the new database instance to be created.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
" - }, - "RestoreTime":{ - "shape":"TStamp", - "documentation":"

The date and time to restore from.

Valid Values: Value must be a UTC time

Constraints:

  • Must be before the latest restorable time for the DB instance
  • Cannot be specified if UseLatestRestorableTime parameter is true

Example: 2009-09-07T23:45:00Z

" - }, - "UseLatestRestorableTime":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) the DB instance is restored from the latest backup time.

Default: false

Constraints: Cannot be specified if RestoreTime parameter is provided.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Amazon RDS DB instance.

Valid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge | db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium

Default: The same DBInstanceClass as the original DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the database instance will be created in.

Default: A random, system-chosen Availability Zone.

Constraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new instance.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

Constraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether a VPC has been requested or not. The following list shows the default behavior in each case.

  • Default VPC:true
  • VPC:false

If no DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be publicly accessible. If a specific DB subnet group has been specified as part of the request and the PubliclyAccessible value has not been set, the DB instance will be private.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades will be applied automatically to the DB instance during the maintenance window.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

Default: Same as source.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The database name for the restored DB instance.

This parameter is not used for the MySQL engine.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new instance.

Default: The same as source

Constraint: Must be compatible with the engine of the source

Valid Values: MySQL | oracle-se1 | oracle-se | oracle-ee | sqlserver-ee | sqlserver-se | sqlserver-ex | sqlserver-web | postgres

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

Constraints: Must be an integer greater than 1000.

SQL Server

Setting the IOPS value for the SQL Server database engine is not supported.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be used for the restored DB instance.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, cannot be removed from an option group, and that option group cannot be removed from a DB instance once it is associated with a DB instance

" - }, - "Tags":{"shape":"TagList"}, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies storage type to be associated with the DB Instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the Key Store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the Key Store in order to access the device.

" - } - }, - "documentation":"

" - }, - "RevokeDBSecurityGroupIngressMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to revoke ingress from.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range to revoke access from. Must be a valid CIDR range. If CIDRIP is specified, EC2SecurityGroupName, EC2SecurityGroupId and EC2SecurityGroupOwnerId cannot be provided.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the EC2 security group to revoke access from. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

The id of the EC2 security group to revoke access from. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS Account Number of the owner of the EC2 security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - } - }, - "documentation":"

" - }, - "SNSInvalidTopicFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

SNS has responded that there is a problem with the SND topic specified.

" - }, - "SNSNoAuthorizationFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

You do not have permission to publish to the SNS topic ARN.

" - }, - "SNSTopicArnNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The SNS topic ARN does not exist.

" - }, - "SnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed number of DB snapshots.

" - }, - "SourceIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SourceId" - } - }, - "SourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The requested source could not be found.

" - }, - "SourceType":{ - "type":"string", - "enum":[ - "db-instance", - "db-parameter-group", - "db-security-group", - "db-snapshot" - ] - }, - "StorageQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Request would result in user exceeding the allowed amount of storage available across all DB instances.

" - }, - "StorageTypeNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

StorageType specified cannot be associated with the DB Instance.

" - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier of the subnet.

" - }, - "SubnetAvailabilityZone":{"shape":"AvailabilityZone"}, - "SubnetStatus":{ - "shape":"String", - "documentation":"

Specifies the status of the subnet.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBSubnetGroups action.

" - }, - "SubnetAlreadyInUse":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubnetAlreadyInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The DB subnet is already in use in the Availability Zone.

" - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "SubscriptionAlreadyExistFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionAlreadyExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The supplied subscription name already exists.

" - }, - "SubscriptionCategoryNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The supplied category does not exist.

" - }, - "SubscriptionNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The subscription name does not exist.

" - }, - "SupportedCharacterSetsList":{ - "type":"list", - "member":{ - "shape":"CharacterSet", - "locationName":"CharacterSet" - } - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with \"aws:\" or \"rds:\". The string may only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - }, - "Value":{ - "shape":"String", - "documentation":"

A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with \"aws:\" or \"rds:\". The string may only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - } - }, - "documentation":"

Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - }, - "documentation":"

A list of tags.

" - }, - "TagListMessage":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

List of tags returned by the ListTagsForResource operation.

" - } - }, - "documentation":"

" - }, - "VpcSecurityGroupIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcSecurityGroupId" - } - }, - "VpcSecurityGroupMembership":{ - "type":"structure", - "members":{ - "VpcSecurityGroupId":{ - "shape":"String", - "documentation":"

The name of the VPC security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the VPC security group.

" - } - }, - "documentation":"

This data type is used as a response element for queries on VPC security group membership.

" - }, - "VpcSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"VpcSecurityGroupMembership", - "locationName":"VpcSecurityGroupMembership" - } - }, - "AddSourceIdentifierToSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "AuthorizeDBSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - }, - "CopyDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CopyDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "CopyOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "CreateDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "CreateDBInstanceReadReplicaResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "CreateDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CreateDBSecurityGroupResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - }, - "CreateDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "CreateDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "CreateEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "CreateOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "DeleteDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "DeleteDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "DeleteEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "DescribeEngineDefaultParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "ModifyDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "ModifyDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "ModifyEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "ModifyOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "PromoteReadReplicaResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "PurchaseReservedDBInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedDBInstance":{"shape":"ReservedDBInstance"} - } - }, - "RebootDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RemoveSourceIdentifierFromSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "RestoreDBInstanceFromDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RestoreDBInstanceToPointInTimeResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RevokeDBSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/waiters-2.json deleted file mode 100644 index b0150079..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-09-01/waiters-2.json +++ /dev/null @@ -1,97 +0,0 @@ -{ - "version": 2, - "waiters": { - "DBInstanceAvailable": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-restore", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-parameters", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-parameters", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-restore", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - }, - "DBInstanceDeleted": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "resetting-master-credentials", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/examples-1.json deleted file mode 100644 index 4bb4a5a9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/examples-1.json +++ /dev/null @@ -1,1658 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AddSourceIdentifierToSubscription": [ - { - "input": { - "SourceIdentifier": "mymysqlinstance", - "SubscriptionName": "mymysqleventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example add a source identifier to an event notification subscription.", - "id": "add-source-identifier-to-subscription-93fb6a15-0a59-4577-a7b5-e12db9752c14", - "title": "To add a source identifier to an event notification subscription" - } - ], - "AddTagsToResource": [ - { - "input": { - "ResourceName": "arn:aws:rds:us-east-1:992648334831:og:mymysqloptiongroup", - "Tags": [ - { - "Key": "Staging", - "Value": "LocationDB" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds a tag to an option group.", - "id": "add-tags-to-resource-fa99ef50-228b-449d-b893-ca4d4e9768ab", - "title": "To add tags to a resource" - } - ], - "ApplyPendingMaintenanceAction": [ - { - "input": { - "ApplyAction": "system-update", - "OptInType": "immediate", - "ResourceIdentifier": "arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example immediately applies a pending system update to a DB instance.", - "id": "apply-pending-maintenance-action-2a026047-8bbb-47fc-b695-abad9f308c24", - "title": "To apply a pending maintenance action" - } - ], - "AuthorizeDBSecurityGroupIngress": [ - { - "input": { - "CIDRIP": "203.0.113.5/32", - "DBSecurityGroupName": "mydbsecuritygroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example authorizes access to the specified security group by the specified CIDR block.", - "id": "authorize-db-security-group-ingress-ebf9ab91-8912-4b07-a32e-ca150668164f", - "title": "To authorize DB security group integress" - } - ], - "CopyDBClusterParameterGroup": [ - { - "input": { - "SourceDBClusterParameterGroupIdentifier": "mydbclusterparametergroup", - "TargetDBClusterParameterGroupDescription": "My DB cluster parameter group copy", - "TargetDBClusterParameterGroupIdentifier": "mydbclusterparametergroup-copy" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies a DB cluster parameter group.", - "id": "copy-db-cluster-parameter-group-6fefaffe-cde9-4dba-9f0b-d3f593572fe4", - "title": "To copy a DB cluster parameter group" - } - ], - "CopyDBClusterSnapshot": [ - { - "input": { - "SourceDBClusterSnapshotIdentifier": "rds:sample-cluster-2016-09-14-10-38", - "TargetDBClusterSnapshotIdentifier": "cluster-snapshot-copy-1" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example copies an automated snapshot of a DB cluster to a new DB cluster snapshot.", - "id": "to-copy-a-db-cluster-snapshot-1473879770564", - "title": "To copy a DB cluster snapshot" - } - ], - "CopyDBParameterGroup": [ - { - "input": { - "SourceDBParameterGroupIdentifier": "mymysqlparametergroup", - "TargetDBParameterGroupDescription": "My MySQL parameter group copy", - "TargetDBParameterGroupIdentifier": "mymysqlparametergroup-copy" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies a DB parameter group.", - "id": "copy-db-parameter-group-610d4dba-2c87-467f-ae5d-edd7f8e47349", - "title": "To copy a DB parameter group" - } - ], - "CopyDBSnapshot": [ - { - "input": { - "SourceDBSnapshotIdentifier": "mydbsnapshot", - "TargetDBSnapshotIdentifier": "mydbsnapshot-copy" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies a DB snapshot.", - "id": "copy-db-snapshot-1b2f0210-bc67-415d-9822-6eecf447dc86", - "title": "To copy a DB snapshot" - } - ], - "CopyOptionGroup": [ - { - "input": { - "SourceOptionGroupIdentifier": "mymysqloptiongroup", - "TargetOptionGroupDescription": "My MySQL option group copy", - "TargetOptionGroupIdentifier": "mymysqloptiongroup-copy" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example copies an option group.", - "id": "copy-option-group-8d5c01c3-8846-4e9c-a4b0-1b7237f7d0ec", - "title": "To copy an option group" - } - ], - "CreateDBCluster": [ - { - "input": { - "AvailabilityZones": [ - "us-east-1a" - ], - "BackupRetentionPeriod": 1, - "DBClusterIdentifier": "mydbcluster", - "DBClusterParameterGroupName": "mydbclusterparametergroup", - "DatabaseName": "myauroradb", - "Engine": "aurora", - "EngineVersion": "5.6.10a", - "MasterUserPassword": "mypassword", - "MasterUsername": "myuser", - "Port": 3306, - "StorageEncrypted": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB cluster.", - "id": "create-db-cluster-423b998d-eba9-40dd-8e19-96c5b6e5f31d", - "title": "To create a DB cluster" - } - ], - "CreateDBClusterParameterGroup": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup", - "DBParameterGroupFamily": "aurora5.6", - "Description": "My DB cluster parameter group" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB cluster parameter group.", - "id": "create-db-cluster-parameter-group-8eb1c3ae-1965-4262-afe3-ee134c4430b1", - "title": "To create a DB cluster parameter group" - } - ], - "CreateDBClusterSnapshot": [ - { - "input": { - "DBClusterIdentifier": "mydbcluster", - "DBClusterSnapshotIdentifier": "mydbclustersnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB cluster snapshot.", - "id": "create-db-cluster-snapshot-", - "title": "To create a DB cluster snapshot" - } - ], - "CreateDBInstance": [ - { - "input": { - "AllocatedStorage": 5, - "DBInstanceClass": "db.t2.micro", - "DBInstanceIdentifier": "mymysqlinstance", - "Engine": "MySQL", - "MasterUserPassword": "MyPassword", - "MasterUsername": "MyUser" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB instance.", - "id": "create-db-instance-57eb5d16-8bf8-4c84-9709-1700322b37b9", - "title": "To create a DB instance." - } - ], - "CreateDBInstanceReadReplica": [ - { - "input": { - "AvailabilityZone": "us-east-1a", - "CopyTagsToSnapshot": true, - "DBInstanceClass": "db.t2.micro", - "DBInstanceIdentifier": "mydbreadreplica", - "PubliclyAccessible": true, - "SourceDBInstanceIdentifier": "mymysqlinstance", - "StorageType": "gp2", - "Tags": [ - { - "Key": "mydbreadreplicakey", - "Value": "mydbreadreplicavalue" - } - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB instance read replica.", - "id": "create-db-instance-read-replica-81b41cd5-2871-4dae-bc59-3e264449d5fe", - "title": "To create a DB instance read replica." - } - ], - "CreateDBParameterGroup": [ - { - "input": { - "DBParameterGroupFamily": "mysql5.6", - "DBParameterGroupName": "mymysqlparametergroup", - "Description": "My MySQL parameter group" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB parameter group.", - "id": "create-db-parameter-group-42afcc37-12e9-4b6a-a55c-b8a141246e87", - "title": "To create a DB parameter group." - } - ], - "CreateDBSecurityGroup": [ - { - "input": { - "DBSecurityGroupDescription": "My DB security group", - "DBSecurityGroupName": "mydbsecuritygroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB security group.", - "id": "create-db-security-group-41b6786a-539e-42a5-a645-a8bc3cf99353", - "title": "To create a DB security group." - } - ], - "CreateDBSnapshot": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "DBSnapshotIdentifier": "mydbsnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB snapshot.", - "id": "create-db-snapshot-e10e0e2c-9ac4-426d-9b17-6b6a3e382ce2", - "title": "To create a DB snapshot." - } - ], - "CreateDBSubnetGroup": [ - { - "input": { - "DBSubnetGroupDescription": "My DB subnet group", - "DBSubnetGroupName": "mydbsubnetgroup", - "SubnetIds": [ - "subnet-1fab8a69", - "subnet-d43a468c" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates a DB subnet group.", - "id": "create-db-subnet-group-c3d162c2-0ec4-4955-ba89-18967615fdb8", - "title": "To create a DB subnet group." - } - ], - "CreateEventSubscription": [ - { - "input": { - "Enabled": true, - "EventCategories": [ - "availability" - ], - "SnsTopicArn": "arn:aws:sns:us-east-1:992648334831:MyDemoSNSTopic", - "SourceIds": [ - "mymysqlinstance" - ], - "SourceType": "db-instance", - "SubscriptionName": "mymysqleventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an event notification subscription.", - "id": "create-event-subscription-00dd0ee6-0e0f-4a38-ae83-e5f2ded5f69a", - "title": "To create an event notification subscription" - } - ], - "CreateOptionGroup": [ - { - "input": { - "EngineName": "MySQL", - "MajorEngineVersion": "5.6", - "OptionGroupDescription": "My MySQL 5.6 option group", - "OptionGroupName": "mymysqloptiongroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example creates an option group.", - "id": "create-option-group-a7708c87-1b79-4a5e-a762-21cf8fc62b78", - "title": "To create an option group" - } - ], - "DeleteDBCluster": [ - { - "input": { - "DBClusterIdentifier": "mydbcluster", - "SkipFinalSnapshot": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB cluster.", - "id": "delete-db-cluster-927fc2c8-6c67-4075-b1ba-75490be0f7d6", - "title": "To delete a DB cluster." - } - ], - "DeleteDBClusterParameterGroup": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB cluster parameter group.", - "id": "delete-db-cluster-parameter-group-364f5555-ba0a-4cc8-979c-e769098924fc", - "title": "To delete a DB cluster parameter group." - } - ], - "DeleteDBClusterSnapshot": [ - { - "input": { - "DBClusterSnapshotIdentifier": "mydbclustersnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB cluster snapshot.", - "id": "delete-db-cluster-snapshot-c67e0d95-670e-4fb5-af90-6d9a70a91b07", - "title": "To delete a DB cluster snapshot." - } - ], - "DeleteDBInstance": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "SkipFinalSnapshot": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB instance.", - "id": "delete-db-instance-4412e650-949c-488a-b32a-7d3038ebccc4", - "title": "To delete a DB instance." - } - ], - "DeleteDBParameterGroup": [ - { - "input": { - "DBParameterGroupName": "mydbparamgroup3" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a DB parameter group.", - "id": "to-delete-a-db-parameter-group-1473888796509", - "title": "To delete a DB parameter group" - } - ], - "DeleteDBSecurityGroup": [ - { - "input": { - "DBSecurityGroupName": "mysecgroup" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a DB security group.", - "id": "to-delete-a-db-security-group-1473960141889", - "title": "To delete a DB security group" - } - ], - "DeleteDBSnapshot": [ - { - "input": { - "DBSnapshotIdentifier": "mydbsnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB snapshot.", - "id": "delete-db-snapshot-505d6b4e-8ced-479c-856a-c460a33fe07b", - "title": "To delete a DB cluster snapshot." - } - ], - "DeleteDBSubnetGroup": [ - { - "input": { - "DBSubnetGroupName": "mydbsubnetgroup" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB subnetgroup.", - "id": "delete-db-subnet-group-4ae00375-511e-443d-a01d-4b9f552244aa", - "title": "To delete a DB subnet group." - } - ], - "DeleteEventSubscription": [ - { - "input": { - "SubscriptionName": "myeventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified DB event subscription.", - "id": "delete-db-event-subscription-d33567e3-1d5d-48ff-873f-0270453f4a75", - "title": "To delete a DB event subscription." - } - ], - "DeleteOptionGroup": [ - { - "input": { - "OptionGroupName": "mydboptiongroup" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified option group.", - "id": "delete-db-option-group-578be2be-3095-431a-9ea4-9a3c3b0daef4", - "title": "To delete an option group." - } - ], - "DescribeAccountAttributes": [ - { - "input": { - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists account attributes.", - "id": "describe-account-attributes-683d3ff7-5524-421a-8da5-e88f1ea2222b", - "title": "To list account attributes" - } - ], - "DescribeCertificates": [ - { - "input": { - "CertificateIdentifier": "rds-ca-2015", - "MaxRecords": 20 - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists up to 20 certificates for the specified certificate identifier.", - "id": "describe-certificates-9d71a70d-7908-4444-b43f-321d842c62dc", - "title": "To list certificates" - } - ], - "DescribeDBClusterParameterGroups": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified DB cluster parameter group.", - "id": "describe-db-cluster-parameter-groups-cf9c6e66-664e-4f57-8e29-a9080abfc013", - "title": "To list DB cluster parameter group settings" - } - ], - "DescribeDBClusterParameters": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup", - "Source": "system" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists system parameters for the specified DB cluster parameter group.", - "id": "describe-db-cluster-parameters-98043c28-e489-41a7-b118-bfd96dc779a1", - "title": "To list DB cluster parameters" - } - ], - "DescribeDBClusterSnapshotAttributes": [ - { - "input": { - "DBClusterSnapshotIdentifier": "mydbclustersnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists attributes for the specified DB cluster snapshot.", - "id": "describe-db-cluster-snapshot-attributes-6752ade3-0c7b-4b06-a8e4-b76bf4e2d3571", - "title": "To list DB cluster snapshot attributes" - } - ], - "DescribeDBClusterSnapshots": [ - { - "input": { - "DBClusterSnapshotIdentifier": "mydbclustersnapshot", - "SnapshotType": "manual" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified, manually-created cluster snapshot.", - "id": "describe-db-cluster-snapshots-52f38af1-3431-4a51-9a6a-e6bb8c961b32", - "title": "To list DB cluster snapshots" - } - ], - "DescribeDBClusters": [ - { - "input": { - "DBClusterIdentifier": "mynewdbcluster" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified DB cluster.", - "id": "describe-db-clusters-7aae8861-cb95-4b3b-9042-f62df7698635", - "title": "To list DB clusters" - } - ], - "DescribeDBEngineVersions": [ - { - "input": { - "DBParameterGroupFamily": "mysql5.6", - "DefaultOnly": true, - "Engine": "mysql", - "EngineVersion": "5.6", - "ListSupportedCharacterSets": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified DB engine version.", - "id": "describe-db-engine-versions-8e698cf2-2162-425a-a854-111cdaceb52b", - "title": "To list DB engine version settings" - } - ], - "DescribeDBInstances": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified DB instance.", - "id": "describe-db-instances-0e11a8c5-4ec3-4463-8cbf-f7254d04c4fc", - "title": "To list DB instance settings" - } - ], - "DescribeDBLogFiles": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "FileLastWritten": 1470873600000, - "FileSize": 0, - "FilenameContains": "error" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists matching log file names for the specified DB instance, file name pattern, last write date in POSIX time with milleseconds, and minimum file size.", - "id": "describe-db-log-files-5f002d8d-5c1d-44c2-b5f4-bd284c0f1285", - "title": "To list DB log file names" - } - ], - "DescribeDBParameterGroups": [ - { - "input": { - "DBParameterGroupName": "mymysqlparametergroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information about the specified DB parameter group.", - "id": "describe-db-parameter-groups-", - "title": "To list information about DB parameter groups" - } - ], - "DescribeDBParameters": [ - { - "input": { - "DBParameterGroupName": "mymysqlparametergroup", - "MaxRecords": 20, - "Source": "system" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for up to the first 20 system parameters for the specified DB parameter group.", - "id": "describe-db-parameters-09db4201-ef4f-4d97-a4b5-d71c0715b901", - "title": "To list information about DB parameters" - } - ], - "DescribeDBSecurityGroups": [ - { - "input": { - "DBSecurityGroupName": "mydbsecuritygroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists settings for the specified security group.", - "id": "describe-db-security-groups-66fe9ea1-17dd-4275-b82e-f771cee0c849", - "title": "To list DB security group settings" - } - ], - "DescribeDBSnapshotAttributes": [ - { - "input": { - "DBSnapshotIdentifier": "mydbsnapshot" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists attributes for the specified DB snapshot.", - "id": "describe-db-snapshot-attributes-1d4fb750-34f6-4e43-8b3d-b2751d796a95", - "title": "To list DB snapshot attributes" - } - ], - "DescribeDBSnapshots": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "IncludePublic": false, - "IncludeShared": true, - "SnapshotType": "manual" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all manually-created, shared snapshots for the specified DB instance.", - "id": "describe-db-snapshots-2c935989-a1ef-4c85-aea4-1d0f45f17f26", - "title": "To list DB snapshot attributes" - } - ], - "DescribeDBSubnetGroups": [ - { - "input": { - "DBSubnetGroupName": "mydbsubnetgroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information about the specified DB subnet group.", - "id": "describe-db-subnet-groups-1d97b340-682f-4dd6-9653-8ed72a8d1221", - "title": "To list information about DB subnet groups" - } - ], - "DescribeEngineDefaultClusterParameters": [ - { - "input": { - "DBParameterGroupFamily": "aurora5.6" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists default parameters for the specified DB cluster engine.", - "id": "describe-engine-default-cluster-parameters-f130374a-7bee-434b-b51d-da20b6e000e0", - "title": "To list default parameters for a DB cluster engine" - } - ], - "DescribeEngineDefaultParameters": [ - { - "input": { - "DBParameterGroupFamily": "mysql5.6" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists default parameters for the specified DB engine.", - "id": "describe-engine-default-parameters-35d5108e-1d44-4fac-8aeb-04b8fdfface1", - "title": "To list default parameters for a DB engine" - } - ], - "DescribeEventCategories": [ - { - "input": { - "SourceType": "db-instance" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists all DB instance event categories.", - "id": "describe-event-categories-97bd4c77-12da-4be6-b42f-edf77771428b", - "title": "To list event categories." - } - ], - "DescribeEventSubscriptions": [ - { - "input": { - "SubscriptionName": "mymysqleventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for the specified DB event notification subscription.", - "id": "describe-event-subscriptions-11184a82-e58a-4d0c-b558-f3a7489e0850", - "title": "To list information about DB event notification subscriptions" - } - ], - "DescribeEvents": [ - { - "input": { - "Duration": 10080, - "EventCategories": [ - "backup" - ], - "SourceIdentifier": "mymysqlinstance", - "SourceType": "db-instance" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all backup-related events for the specified DB instance for the past 7 days (7 days * 24 hours * 60 minutes = 10,080 minutes).", - "id": "describe-events-3836e5ed-3913-4f76-8452-c77fcad5016b", - "title": "To list information about events" - } - ], - "DescribeOptionGroupOptions": [ - { - "input": { - "EngineName": "mysql", - "MajorEngineVersion": "5.6" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all option group options for the specified DB engine.", - "id": "describe-option-group-options-30d735a4-81f1-49e4-b3f2-5dc45d50c8ed", - "title": "To list information about DB option group options" - } - ], - "DescribeOptionGroups": [ - { - "input": { - "EngineName": "mysql", - "MajorEngineVersion": "5.6" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all option groups for the specified DB engine.", - "id": "describe-option-groups-4ef478a1-66d5-45f2-bec3-e608720418a4", - "title": "To list information about DB option groups" - } - ], - "DescribeOrderableDBInstanceOptions": [ - { - "input": { - "DBInstanceClass": "db.t2.micro", - "Engine": "mysql", - "EngineVersion": "5.6.27", - "LicenseModel": "general-public-license", - "Vpc": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all orderable DB instance options for the specified DB engine, engine version, DB instance class, license model, and VPC settings.", - "id": "describe-orderable-db-instance-options-7444d3ed-82eb-42b9-9ed9-896b8c27a782", - "title": "To list information about orderable DB instance options" - } - ], - "DescribePendingMaintenanceActions": [ - { - "input": { - "ResourceIdentifier": "arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all pending maintenance actions for the specified DB instance.", - "id": "describe-pending-maintenance-actions-e6021f7e-58ae-49cc-b874-11996176835c", - "title": "To list information about pending maintenance actions" - } - ], - "DescribeReservedDBInstances": [ - { - "input": { - "DBInstanceClass": "db.t2.micro", - "Duration": "1y", - "MultiAZ": false, - "OfferingType": "No Upfront", - "ProductDescription": "mysql" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all reserved DB instances for the specified DB instance class, duration, product, offering type, and availability zone settings.", - "id": "describe-reserved-db-instances-d45adaca-2e30-407c-a0f3-aa7b98bea17f", - "title": "To list information about reserved DB instances" - } - ], - "DescribeReservedDBInstancesOfferings": [ - { - "input": { - "DBInstanceClass": "db.t2.micro", - "Duration": "1y", - "MultiAZ": false, - "OfferingType": "No Upfront", - "ProductDescription": "mysql" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for all reserved DB instance offerings for the specified DB instance class, duration, product, offering type, and availability zone settings.", - "id": "describe-reserved-db-instances-offerings-9de7d1fd-d6a6-4a72-84ae-b2ef58d47d8d", - "title": "To list information about reserved DB instance offerings" - } - ], - "DescribeSourceRegions": [ - { - "input": { - }, - "output": { - "SourceRegions": [ - { - "Endpoint": "https://rds.ap-northeast-1.amazonaws.com", - "RegionName": "ap-northeast-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.ap-northeast-2.amazonaws.com", - "RegionName": "ap-northeast-2", - "Status": "available" - }, - { - "Endpoint": "https://rds.ap-south-1.amazonaws.com", - "RegionName": "ap-south-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.ap-southeast-1.amazonaws.com", - "RegionName": "ap-southeast-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.ap-southeast-2.amazonaws.com", - "RegionName": "ap-southeast-2", - "Status": "available" - }, - { - "Endpoint": "https://rds.eu-central-1.amazonaws.com", - "RegionName": "eu-central-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.eu-west-1.amazonaws.com", - "RegionName": "eu-west-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.sa-east-1.amazonaws.com", - "RegionName": "sa-east-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.us-west-1.amazonaws.com", - "RegionName": "us-west-1", - "Status": "available" - }, - { - "Endpoint": "https://rds.us-west-2.amazonaws.com", - "RegionName": "us-west-2", - "Status": "available" - } - ] - }, - "comments": { - }, - "description": "To list the AWS regions where a Read Replica can be created.", - "id": "to-describe-source-regions-1473457722410", - "title": "To describe source regions" - } - ], - "DownloadDBLogFilePortion": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "LogFileName": "mysqlUpgrade" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information for the specified log file for the specified DB instance.", - "id": "download-db-log-file-portion-54a82731-a441-4fc7-a010-8eccae6fa202", - "title": "To list information about DB log files" - } - ], - "FailoverDBCluster": [ - { - "input": { - "DBClusterIdentifier": "myaurorainstance-cluster", - "TargetDBInstanceIdentifier": "myaurorareplica" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example performs a failover for the specified DB cluster to the specified DB instance.", - "id": "failover-db-cluster-9e7f2f93-d98c-42c7-bb0e-d6c485c096d6", - "title": "To perform a failover for a DB cluster" - } - ], - "ListTagsForResource": [ - { - "input": { - "ResourceName": "arn:aws:rds:us-east-1:992648334831:og:mymysqloptiongroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example lists information about all tags associated with the specified DB option group.", - "id": "list-tags-for-resource-8401f3c2-77cd-4f90-bfd5-b523f0adcc2f", - "title": "To list information about tags associated with a resource" - } - ], - "ModifyDBCluster": [ - { - "input": { - "ApplyImmediately": true, - "DBClusterIdentifier": "mydbcluster", - "MasterUserPassword": "mynewpassword", - "NewDBClusterIdentifier": "mynewdbcluster", - "PreferredBackupWindow": "04:00-04:30", - "PreferredMaintenanceWindow": "Tue:05:00-Tue:05:30" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the specified settings for the specified DB cluster.", - "id": "modify-db-cluster-a370ee1b-768d-450a-853b-707cb1ab663d", - "title": "To change DB cluster settings" - } - ], - "ModifyDBClusterParameterGroup": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup", - "Parameters": [ - { - "ApplyMethod": "immediate", - "ParameterName": "time_zone", - "ParameterValue": "America/Phoenix" - } - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example immediately changes the specified setting for the specified DB cluster parameter group.", - "id": "modify-db-cluster-parameter-group-f9156bc9-082a-442e-8d12-239542c1a113", - "title": "To change DB cluster parameter group settings" - } - ], - "ModifyDBClusterSnapshotAttribute": [ - { - "input": { - "AttributeName": "restore", - "DBClusterSnapshotIdentifier": "manual-cluster-snapshot1", - "ValuesToAdd": [ - "123451234512", - "123456789012" - ], - "ValuesToRemove": [ - "all" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example gives two AWS accounts access to a manual DB cluster snapshot and ensures that the DB cluster snapshot is private by removing the value \"all\".", - "id": "to-add-or-remove-access-to-a-manual-db-cluster-snapshot-1473889426431", - "title": "To add or remove access to a manual DB cluster snapshot" - } - ], - "ModifyDBInstance": [ - { - "input": { - "AllocatedStorage": 10, - "ApplyImmediately": true, - "BackupRetentionPeriod": 1, - "DBInstanceClass": "db.t2.small", - "DBInstanceIdentifier": "mymysqlinstance", - "MasterUserPassword": "mynewpassword", - "PreferredBackupWindow": "04:00-04:30", - "PreferredMaintenanceWindow": "Tue:05:00-Tue:05:30" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example immediately changes the specified settings for the specified DB instance.", - "id": "modify-db-instance-6979a368-6254-467b-8a8d-61103f4fcde9", - "title": "To change DB instance settings" - } - ], - "ModifyDBParameterGroup": [ - { - "input": { - "DBParameterGroupName": "mymysqlparametergroup", - "Parameters": [ - { - "ApplyMethod": "immediate", - "ParameterName": "time_zone", - "ParameterValue": "America/Phoenix" - } - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example immediately changes the specified setting for the specified DB parameter group.", - "id": "modify-db-parameter-group-f3a4e52a-68e4-4b88-b559-f912d34c457a", - "title": "To change DB parameter group settings" - } - ], - "ModifyDBSnapshotAttribute": [ - { - "input": { - "AttributeName": "restore", - "DBSnapshotIdentifier": "mydbsnapshot", - "ValuesToAdd": [ - "all" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds the specified attribute for the specified DB snapshot.", - "id": "modify-db-snapshot-attribute-2e66f120-2b21-4a7c-890b-4474da88bde6", - "title": "To change DB snapshot attributes" - } - ], - "ModifyDBSubnetGroup": [ - { - "input": { - "DBSubnetGroupName": "mydbsubnetgroup", - "SubnetIds": [ - "subnet-70e1975a", - "subnet-747a5c49" - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the specified setting for the specified DB subnet group.", - "id": "modify-db-subnet-group-e34a97d9-8fe6-4239-a4ed-ad6e73a956b0", - "title": "To change DB subnet group settings" - } - ], - "ModifyEventSubscription": [ - { - "input": { - "Enabled": true, - "EventCategories": [ - "deletion", - "low storage" - ], - "SourceType": "db-instance", - "SubscriptionName": "mymysqleventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example changes the specified setting for the specified event notification subscription.", - "id": "modify-event-subscription-405ac869-1f02-42cd-b8f4-6950a435f30e", - "title": "To change event notification subscription settings" - } - ], - "ModifyOptionGroup": [ - { - "input": { - "ApplyImmediately": true, - "OptionGroupName": "myawsuser-og02", - "OptionsToInclude": [ - { - "DBSecurityGroupMemberships": [ - "default" - ], - "OptionName": "MEMCACHED" - } - ] - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example adds an option to an option group.", - "id": "to-modify-an-option-group-1473890247875", - "title": "To modify an option group" - } - ], - "PromoteReadReplica": [ - { - "input": { - "BackupRetentionPeriod": 1, - "DBInstanceIdentifier": "mydbreadreplica", - "PreferredBackupWindow": "03:30-04:00" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example promotes the specified read replica and sets its backup retention period and preferred backup window.", - "id": "promote-read-replica-cc580039-c55d-4035-838a-def4a1ae4181", - "title": "To promote a read replica" - } - ], - "PurchaseReservedDBInstancesOffering": [ - { - "input": { - "ReservedDBInstanceId": "myreservationid", - "ReservedDBInstancesOfferingId": "fb29428a-646d-4390-850e-5fe89926e727" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example purchases a reserved DB instance offering that matches the specified settings.", - "id": "purchase-reserved-db-instances-offfering-f423c736-8413-429b-ba13-850fd4fa4dcd", - "title": "To purchase a reserved DB instance offering" - } - ], - "RebootDBInstance": [ - { - "input": { - "DBInstanceIdentifier": "mymysqlinstance", - "ForceFailover": false - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example reboots the specified DB instance without forcing a failover.", - "id": "reboot-db-instance-b9ce8a0a-2920-451d-a1f3-01d288aa7366", - "title": "To reboot a DB instance" - } - ], - "RemoveSourceIdentifierFromSubscription": [ - { - "input": { - "SourceIdentifier": "mymysqlinstance", - "SubscriptionName": "myeventsubscription" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example removes the specified source identifier from the specified DB event subscription.", - "id": "remove-source-identifier-from-subscription-30d25493-c19d-4cf7-b4e5-68371d0d8770", - "title": "To remove a source identifier from a DB event subscription" - } - ], - "RemoveTagsFromResource": [ - { - "input": { - "ResourceName": "arn:aws:rds:us-east-1:992648334831:og:mydboptiongroup", - "TagKeys": [ - "MyKey" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example removes the specified tag associated with the specified DB option group.", - "id": "remove-tags-from-resource-49f00574-38f6-4d01-ac89-d3c668449ce3", - "title": "To remove tags from a resource" - } - ], - "ResetDBClusterParameterGroup": [ - { - "input": { - "DBClusterParameterGroupName": "mydbclusterparametergroup", - "ResetAllParameters": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example resets all parameters for the specified DB cluster parameter group to their default values.", - "id": "reset-db-cluster-parameter-group-b04aeaf7-7f73-49e1-9bb4-857573ea3ee4", - "title": "To reset the values of a DB cluster parameter group" - } - ], - "ResetDBParameterGroup": [ - { - "input": { - "DBParameterGroupName": "mydbparametergroup", - "ResetAllParameters": true - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example resets all parameters for the specified DB parameter group to their default values.", - "id": "reset-db-parameter-group-ed2ed723-de0d-4824-8af5-3c65fa130abf", - "title": "To reset the values of a DB parameter group" - } - ], - "RestoreDBClusterFromSnapshot": [ - { - "input": { - "DBClusterIdentifier": "restored-cluster1", - "Engine": "aurora", - "SnapshotIdentifier": "sample-cluster-snapshot1" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example restores an Amazon Aurora DB cluster from a DB cluster snapshot.", - "id": "to-restore-an-amazon-aurora-db-cluster-from-a-db-cluster-snapshot-1473958144325", - "title": "To restore an Amazon Aurora DB cluster from a DB cluster snapshot" - } - ], - "RestoreDBClusterToPointInTime": [ - { - "input": { - "DBClusterIdentifier": "sample-restored-cluster1", - "RestoreToTime": "2016-09-13T18:45:00Z", - "SourceDBClusterIdentifier": "sample-cluster1" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example restores a DB cluster to a new DB cluster at a point in time from the source DB cluster.", - "id": "to-restore-a-db-cluster-to-a-point-in-time-1473962082214", - "title": "To restore a DB cluster to a point in time." - } - ], - "RevokeDBSecurityGroupIngress": [ - { - "input": { - "CIDRIP": "203.0.113.5/32", - "DBSecurityGroupName": "mydbsecuritygroup" - }, - "output": { - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example revokes ingress for the specified CIDR block associated with the specified DB security group.", - "id": "revoke-db-security-group-ingress-ce5b2c1c-bd4e-4809-b04a-6d78ec448813", - "title": "To revoke ingress for a DB security group" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/paginators-1.json deleted file mode 100644 index fdae7c73..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/paginators-1.json +++ /dev/null @@ -1,113 +0,0 @@ -{ - "pagination": { - "DescribeDBClusterSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBClusterSnapshots" - }, - "DescribeDBEngineVersions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBEngineVersions" - }, - "DescribeDBInstances": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBInstances" - }, - "DescribeDBLogFiles": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DescribeDBLogFiles" - }, - "DescribeDBParameterGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBParameterGroups" - }, - "DescribeDBParameters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Parameters" - }, - "DescribeDBSecurityGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSecurityGroups" - }, - "DescribeDBSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSnapshots" - }, - "DescribeDBSubnetGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "DBSubnetGroups" - }, - "DescribeEngineDefaultParameters": { - "input_token": "Marker", - "output_token": "EngineDefaults.Marker", - "limit_key": "MaxRecords", - "result_key": "EngineDefaults.Parameters" - }, - "DescribeEventSubscriptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "EventSubscriptionsList" - }, - "DescribeEvents": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Events" - }, - "DescribeOptionGroupOptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OptionGroupOptions" - }, - "DescribeOptionGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OptionGroupsList" - }, - "DescribeOrderableDBInstanceOptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OrderableDBInstanceOptions" - }, - "DescribeReservedDBInstances": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedDBInstances" - }, - "DescribeReservedDBInstancesOfferings": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedDBInstancesOfferings" - }, - "DownloadDBLogFilePortion": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "NumberOfLines", - "more_results": "AdditionalDataPending", - "result_key": "LogFileData" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.json deleted file mode 100644 index 66e98966..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.json +++ /dev/null @@ -1,9275 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-10-31", - "endpointPrefix":"rds", - "protocol":"query", - "serviceAbbreviation":"Amazon RDS", - "serviceFullName":"Amazon Relational Database Service", - "serviceId":"RDS", - "signatureVersion":"v4", - "uid":"rds-2014-10-31", - "xmlNamespace":"http://rds.amazonaws.com/doc/2014-10-31/" - }, - "operations":{ - "AddRoleToDBCluster":{ - "name":"AddRoleToDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddRoleToDBClusterMessage"}, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterRoleAlreadyExistsFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterRoleQuotaExceededFault"} - ], - "documentation":"

Associates an Identity and Access Management (IAM) role from an Aurora DB cluster. For more information, see Authorizing Amazon Aurora to Access Other AWS Services On Your Behalf.

" - }, - "AddSourceIdentifierToSubscription":{ - "name":"AddSourceIdentifierToSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddSourceIdentifierToSubscriptionMessage"}, - "output":{ - "shape":"AddSourceIdentifierToSubscriptionResult", - "resultWrapper":"AddSourceIdentifierToSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Adds a source identifier to an existing RDS event notification subscription.

" - }, - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceMessage"}, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.

For an overview on tagging Amazon RDS resources, see Tagging Amazon RDS Resources.

" - }, - "ApplyPendingMaintenanceAction":{ - "name":"ApplyPendingMaintenanceAction", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ApplyPendingMaintenanceActionMessage"}, - "output":{ - "shape":"ApplyPendingMaintenanceActionResult", - "resultWrapper":"ApplyPendingMaintenanceActionResult" - }, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Applies a pending maintenance action to a resource (for example, to a DB instance).

" - }, - "AuthorizeDBSecurityGroupIngress":{ - "name":"AuthorizeDBSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeDBSecurityGroupIngressMessage"}, - "output":{ - "shape":"AuthorizeDBSecurityGroupIngressResult", - "resultWrapper":"AuthorizeDBSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"AuthorizationAlreadyExistsFault"}, - {"shape":"AuthorizationQuotaExceededFault"} - ], - "documentation":"

Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the Internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).

You can't authorize ingress from an EC2 security group in one AWS Region to an Amazon RDS DB instance in another. You can't authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

" - }, - "BacktrackDBCluster":{ - "name":"BacktrackDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BacktrackDBClusterMessage"}, - "output":{ - "shape":"DBClusterBacktrack", - "resultWrapper":"BacktrackDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Backtracks a DB cluster to a specific time, without creating a new DB cluster.

For more information on backtracking, see Backtracking an Aurora DB Cluster in the Amazon RDS User Guide.

" - }, - "CopyDBClusterParameterGroup":{ - "name":"CopyDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBClusterParameterGroupMessage"}, - "output":{ - "shape":"CopyDBClusterParameterGroupResult", - "resultWrapper":"CopyDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Copies the specified DB cluster parameter group.

" - }, - "CopyDBClusterSnapshot":{ - "name":"CopyDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBClusterSnapshotMessage"}, - "output":{ - "shape":"CopyDBClusterSnapshotResult", - "resultWrapper":"CopyDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Copies a snapshot of a DB cluster.

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.

You can copy an encrypted DB cluster snapshot from another AWS Region. In that case, the AWS Region where you call the CopyDBClusterSnapshot action is the destination AWS Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another AWS Region, you must provide the following values:

  • KmsKeyId - The AWS Key Management System (AWS KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region.

  • PreSignedUrl - A URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot action to be called in the source AWS Region where the DB cluster snapshot is copied from. The pre-signed URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied.

    The pre-signed URL request must contain the following parameter values:

    • KmsKeyId - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

    • DestinationRegion - The name of the AWS Region that the DB cluster snapshot will be created in.

    • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.

    To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

  • TargetDBClusterSnapshotIdentifier - The identifier for the new copy of the DB cluster snapshot in the destination AWS Region.

  • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source AWS Region and is the same value as the SourceDBClusterSnapshotIdentifier in the pre-signed URL.

To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot is in \"copying\" status.

For more information on copying encrypted DB cluster snapshots from one AWS Region to another, see Copying a DB Cluster Snapshot in the Same Account, Either in the Same Region or Across Regions in the Amazon RDS User Guide.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "CopyDBParameterGroup":{ - "name":"CopyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBParameterGroupMessage"}, - "output":{ - "shape":"CopyDBParameterGroupResult", - "resultWrapper":"CopyDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"}, - {"shape":"DBParameterGroupQuotaExceededFault"} - ], - "documentation":"

Copies the specified DB parameter group.

" - }, - "CopyDBSnapshot":{ - "name":"CopyDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyDBSnapshotMessage"}, - "output":{ - "shape":"CopyDBSnapshotResult", - "resultWrapper":"CopyDBSnapshotResult" - }, - "errors":[ - {"shape":"DBSnapshotAlreadyExistsFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Copies the specified DB snapshot. The source DB snapshot must be in the \"available\" state.

You can copy a snapshot from one AWS Region to another. In that case, the AWS Region where you call the CopyDBSnapshot action is the destination AWS Region for the DB snapshot copy.

For more information about copying snapshots, see Copying a DB Snapshot in the Amazon RDS User Guide.

" - }, - "CopyOptionGroup":{ - "name":"CopyOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyOptionGroupMessage"}, - "output":{ - "shape":"CopyOptionGroupResult", - "resultWrapper":"CopyOptionGroupResult" - }, - "errors":[ - {"shape":"OptionGroupAlreadyExistsFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"OptionGroupQuotaExceededFault"} - ], - "documentation":"

Copies the specified option group.

" - }, - "CreateDBCluster":{ - "name":"CreateDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterMessage"}, - "output":{ - "shape":"CreateDBClusterResult", - "resultWrapper":"CreateDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"} - ], - "documentation":"

Creates a new Amazon Aurora DB cluster.

You can use the ReplicationSourceIdentifier parameter to create the DB cluster as a Read Replica of another DB cluster or Amazon RDS MySQL DB instance. For cross-region replication where the DB cluster identified by ReplicationSourceIdentifier is encrypted, you must also specify the PreSignedUrl parameter.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "CreateDBClusterParameterGroup":{ - "name":"CreateDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterParameterGroupMessage"}, - "output":{ - "shape":"CreateDBClusterParameterGroupResult", - "resultWrapper":"CreateDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Creates a new DB cluster parameter group.

Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.

A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBClusterParameterGroup. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster using ModifyDBCluster. When you associate a new DB cluster parameter group with a running DB cluster, you need to reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "CreateDBClusterSnapshot":{ - "name":"CreateDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBClusterSnapshotMessage"}, - "output":{ - "shape":"CreateDBClusterSnapshotResult", - "resultWrapper":"CreateDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"} - ], - "documentation":"

Creates a snapshot of a DB cluster. For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "CreateDBInstance":{ - "name":"CreateDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBInstanceMessage"}, - "output":{ - "shape":"CreateDBInstanceResult", - "resultWrapper":"CreateDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DomainNotFoundFault"}, - {"shape":"BackupPolicyNotFoundFault"} - ], - "documentation":"

Creates a new DB instance.

" - }, - "CreateDBInstanceReadReplica":{ - "name":"CreateDBInstanceReadReplica", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBInstanceReadReplicaMessage"}, - "output":{ - "shape":"CreateDBInstanceReadReplicaResult", - "resultWrapper":"CreateDBInstanceReadReplicaResult" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"DBSubnetGroupNotAllowedFault"}, - {"shape":"InvalidDBSubnetGroupFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Creates a new DB instance that acts as a Read Replica for an existing source DB instance. You can create a Read Replica for a DB instance running MySQL, MariaDB, or PostgreSQL. For more information, see Working with PostgreSQL, MySQL, and MariaDB Read Replicas.

Amazon Aurora doesn't support this action. You must call the CreateDBInstance action to create a DB instance for an Aurora DB cluster.

All Read Replica DB instances are created with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified following.

Your source DB instance must have backup retention enabled.

" - }, - "CreateDBParameterGroup":{ - "name":"CreateDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBParameterGroupMessage"}, - "output":{ - "shape":"CreateDBParameterGroupResult", - "resultWrapper":"CreateDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupQuotaExceededFault"}, - {"shape":"DBParameterGroupAlreadyExistsFault"} - ], - "documentation":"

Creates a new DB parameter group.

A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.

After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "CreateDBSecurityGroup":{ - "name":"CreateDBSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBSecurityGroupMessage"}, - "output":{ - "shape":"CreateDBSecurityGroupResult", - "resultWrapper":"CreateDBSecurityGroupResult" - }, - "errors":[ - {"shape":"DBSecurityGroupAlreadyExistsFault"}, - {"shape":"DBSecurityGroupQuotaExceededFault"}, - {"shape":"DBSecurityGroupNotSupportedFault"} - ], - "documentation":"

Creates a new DB security group. DB security groups control access to a DB instance.

A DB security group controls access to EC2-Classic DB instances that are not in a VPC.

" - }, - "CreateDBSnapshot":{ - "name":"CreateDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBSnapshotMessage"}, - "output":{ - "shape":"CreateDBSnapshotResult", - "resultWrapper":"CreateDBSnapshotResult" - }, - "errors":[ - {"shape":"DBSnapshotAlreadyExistsFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"SnapshotQuotaExceededFault"} - ], - "documentation":"

Creates a DBSnapshot. The source DBInstance must be in \"available\" state.

" - }, - "CreateDBSubnetGroup":{ - "name":"CreateDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDBSubnetGroupMessage"}, - "output":{ - "shape":"CreateDBSubnetGroupResult", - "resultWrapper":"CreateDBSubnetGroupResult" - }, - "errors":[ - {"shape":"DBSubnetGroupAlreadyExistsFault"}, - {"shape":"DBSubnetGroupQuotaExceededFault"}, - {"shape":"DBSubnetQuotaExceededFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

" - }, - "CreateEventSubscription":{ - "name":"CreateEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEventSubscriptionMessage"}, - "output":{ - "shape":"CreateEventSubscriptionResult", - "resultWrapper":"CreateEventSubscriptionResult" - }, - "errors":[ - {"shape":"EventSubscriptionQuotaExceededFault"}, - {"shape":"SubscriptionAlreadyExistFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Creates an RDS event notification subscription. This action requires a topic ARN (Amazon Resource Name) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the type of source (SourceType) you want to be notified of, provide a list of RDS sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you receive notice of the events for that source type for all your RDS sources. If you do not specify either the SourceType nor the SourceIdentifier, you are notified of events generated from all RDS sources belonging to your customer account.

" - }, - "CreateOptionGroup":{ - "name":"CreateOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateOptionGroupMessage"}, - "output":{ - "shape":"CreateOptionGroupResult", - "resultWrapper":"CreateOptionGroupResult" - }, - "errors":[ - {"shape":"OptionGroupAlreadyExistsFault"}, - {"shape":"OptionGroupQuotaExceededFault"} - ], - "documentation":"

Creates a new option group. You can create up to 20 option groups.

" - }, - "DeleteDBCluster":{ - "name":"DeleteDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterMessage"}, - "output":{ - "shape":"DeleteDBClusterResult", - "resultWrapper":"DeleteDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"DBClusterSnapshotAlreadyExistsFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"} - ], - "documentation":"

The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DeleteDBClusterParameterGroup":{ - "name":"DeleteDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DeleteDBClusterSnapshot":{ - "name":"DeleteDBClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBClusterSnapshotMessage"}, - "output":{ - "shape":"DeleteDBClusterSnapshotResult", - "resultWrapper":"DeleteDBClusterSnapshotResult" - }, - "errors":[ - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

The DB cluster snapshot must be in the available state to be deleted.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DeleteDBInstance":{ - "name":"DeleteDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBInstanceMessage"}, - "output":{ - "shape":"DeleteDBInstanceResult", - "resultWrapper":"DeleteDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBSnapshotAlreadyExistsFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

The DeleteDBInstance action deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not deleted.

If you request a final DB snapshot the status of the Amazon RDS DB instance is deleting until the DB snapshot is created. The API action DescribeDBInstance is used to monitor the status of this operation. The action can't be canceled or reverted once submitted.

Note that when a DB instance is in a failure state and has a status of failed, incompatible-restore, or incompatible-network, you can only delete it when the SkipFinalSnapshot parameter is set to true.

If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following conditions are true:

  • The DB cluster is a Read Replica of another Amazon Aurora DB cluster.

  • The DB instance is the only instance in the DB cluster.

To delete a DB instance in this case, first call the PromoteReadReplicaDBCluster API action to promote the DB cluster so it's no longer a Read Replica. After the promotion completes, then call the DeleteDBInstance API action to delete the final instance in the DB cluster.

" - }, - "DeleteDBParameterGroup":{ - "name":"DeleteDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Deletes a specified DBParameterGroup. The DBParameterGroup to be deleted can't be associated with any DB instances.

" - }, - "DeleteDBSecurityGroup":{ - "name":"DeleteDBSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBSecurityGroupMessage"}, - "errors":[ - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"DBSecurityGroupNotFoundFault"} - ], - "documentation":"

Deletes a DB security group.

The specified DB security group must not be associated with any DB instances.

" - }, - "DeleteDBSnapshot":{ - "name":"DeleteDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBSnapshotMessage"}, - "output":{ - "shape":"DeleteDBSnapshotResult", - "resultWrapper":"DeleteDBSnapshotResult" - }, - "errors":[ - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"DBSnapshotNotFoundFault"} - ], - "documentation":"

Deletes a DBSnapshot. If the snapshot is being copied, the copy operation is terminated.

The DBSnapshot must be in the available state to be deleted.

" - }, - "DeleteDBSubnetGroup":{ - "name":"DeleteDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDBSubnetGroupMessage"}, - "errors":[ - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidDBSubnetStateFault"}, - {"shape":"DBSubnetGroupNotFoundFault"} - ], - "documentation":"

Deletes a DB subnet group.

The specified database subnet group must not be associated with any DB instances.

" - }, - "DeleteEventSubscription":{ - "name":"DeleteEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEventSubscriptionMessage"}, - "output":{ - "shape":"DeleteEventSubscriptionResult", - "resultWrapper":"DeleteEventSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"InvalidEventSubscriptionStateFault"} - ], - "documentation":"

Deletes an RDS event notification subscription.

" - }, - "DeleteOptionGroup":{ - "name":"DeleteOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteOptionGroupMessage"}, - "errors":[ - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"InvalidOptionGroupStateFault"} - ], - "documentation":"

Deletes an existing option group.

" - }, - "DescribeAccountAttributes":{ - "name":"DescribeAccountAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAccountAttributesMessage"}, - "output":{ - "shape":"AccountAttributesMessage", - "resultWrapper":"DescribeAccountAttributesResult" - }, - "documentation":"

Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

This command doesn't take any parameters.

" - }, - "DescribeCertificates":{ - "name":"DescribeCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCertificatesMessage"}, - "output":{ - "shape":"CertificateMessage", - "resultWrapper":"DescribeCertificatesResult" - }, - "errors":[ - {"shape":"CertificateNotFoundFault"} - ], - "documentation":"

Lists the set of CA certificates provided by Amazon RDS for this AWS account.

" - }, - "DescribeDBClusterBacktracks":{ - "name":"DescribeDBClusterBacktracks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterBacktracksMessage"}, - "output":{ - "shape":"DBClusterBacktrackMessage", - "resultWrapper":"DescribeDBClusterBacktracksResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterBacktrackNotFoundFault"} - ], - "documentation":"

Returns information about backtracks for a DB cluster.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeDBClusterParameterGroups":{ - "name":"DescribeDBClusterParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterParameterGroupsMessage"}, - "output":{ - "shape":"DBClusterParameterGroupsMessage", - "resultWrapper":"DescribeDBClusterParameterGroupsResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeDBClusterParameters":{ - "name":"DescribeDBClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterParametersMessage"}, - "output":{ - "shape":"DBClusterParameterGroupDetails", - "resultWrapper":"DescribeDBClusterParametersResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns the detailed parameter list for a particular DB cluster parameter group.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeDBClusterSnapshotAttributes":{ - "name":"DescribeDBClusterSnapshotAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterSnapshotAttributesMessage"}, - "output":{ - "shape":"DescribeDBClusterSnapshotAttributesResult", - "resultWrapper":"DescribeDBClusterSnapshotAttributesResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.

When sharing snapshots with other AWS accounts, DescribeDBClusterSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB cluster snapshot. If all is included in the list of values for the restore attribute, then the manual DB cluster snapshot is public and can be copied or restored by all AWS accounts.

To add or remove access for an AWS account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute API action.

" - }, - "DescribeDBClusterSnapshots":{ - "name":"DescribeDBClusterSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClusterSnapshotsMessage"}, - "output":{ - "shape":"DBClusterSnapshotMessage", - "resultWrapper":"DescribeDBClusterSnapshotsResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"} - ], - "documentation":"

Returns information about DB cluster snapshots. This API action supports pagination.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeDBClusters":{ - "name":"DescribeDBClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBClustersMessage"}, - "output":{ - "shape":"DBClusterMessage", - "resultWrapper":"DescribeDBClustersResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Returns information about provisioned Aurora DB clusters. This API supports pagination.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeDBEngineVersions":{ - "name":"DescribeDBEngineVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBEngineVersionsMessage"}, - "output":{ - "shape":"DBEngineVersionMessage", - "resultWrapper":"DescribeDBEngineVersionsResult" - }, - "documentation":"

Returns a list of the available DB engines.

" - }, - "DescribeDBInstances":{ - "name":"DescribeDBInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBInstancesMessage"}, - "output":{ - "shape":"DBInstanceMessage", - "resultWrapper":"DescribeDBInstancesResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

Returns information about provisioned RDS instances. This API supports pagination.

" - }, - "DescribeDBLogFiles":{ - "name":"DescribeDBLogFiles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBLogFilesMessage"}, - "output":{ - "shape":"DescribeDBLogFilesResponse", - "resultWrapper":"DescribeDBLogFilesResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

Returns a list of DB log files for the DB instance.

" - }, - "DescribeDBParameterGroups":{ - "name":"DescribeDBParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBParameterGroupsMessage"}, - "output":{ - "shape":"DBParameterGroupsMessage", - "resultWrapper":"DescribeDBParameterGroupsResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

" - }, - "DescribeDBParameters":{ - "name":"DescribeDBParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBParametersMessage"}, - "output":{ - "shape":"DBParameterGroupDetails", - "resultWrapper":"DescribeDBParametersResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Returns the detailed parameter list for a particular DB parameter group.

" - }, - "DescribeDBSecurityGroups":{ - "name":"DescribeDBSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBSecurityGroupsMessage"}, - "output":{ - "shape":"DBSecurityGroupMessage", - "resultWrapper":"DescribeDBSecurityGroupsResult" - }, - "errors":[ - {"shape":"DBSecurityGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.

" - }, - "DescribeDBSnapshotAttributes":{ - "name":"DescribeDBSnapshotAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBSnapshotAttributesMessage"}, - "output":{ - "shape":"DescribeDBSnapshotAttributesResult", - "resultWrapper":"DescribeDBSnapshotAttributesResult" - }, - "errors":[ - {"shape":"DBSnapshotNotFoundFault"} - ], - "documentation":"

Returns a list of DB snapshot attribute names and values for a manual DB snapshot.

When sharing snapshots with other AWS accounts, DescribeDBSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB snapshot. If all is included in the list of values for the restore attribute, then the manual DB snapshot is public and can be copied or restored by all AWS accounts.

To add or remove access for an AWS account to copy or restore a manual DB snapshot, or to make the manual DB snapshot public or private, use the ModifyDBSnapshotAttribute API action.

" - }, - "DescribeDBSnapshots":{ - "name":"DescribeDBSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBSnapshotsMessage"}, - "output":{ - "shape":"DBSnapshotMessage", - "resultWrapper":"DescribeDBSnapshotsResult" - }, - "errors":[ - {"shape":"DBSnapshotNotFoundFault"} - ], - "documentation":"

Returns information about DB snapshots. This API action supports pagination.

" - }, - "DescribeDBSubnetGroups":{ - "name":"DescribeDBSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDBSubnetGroupsMessage"}, - "output":{ - "shape":"DBSubnetGroupMessage", - "resultWrapper":"DescribeDBSubnetGroupsResult" - }, - "errors":[ - {"shape":"DBSubnetGroupNotFoundFault"} - ], - "documentation":"

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

" - }, - "DescribeEngineDefaultClusterParameters":{ - "name":"DescribeEngineDefaultClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEngineDefaultClusterParametersMessage"}, - "output":{ - "shape":"DescribeEngineDefaultClusterParametersResult", - "resultWrapper":"DescribeEngineDefaultClusterParametersResult" - }, - "documentation":"

Returns the default engine and system parameter information for the cluster database engine.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "DescribeEngineDefaultParameters":{ - "name":"DescribeEngineDefaultParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEngineDefaultParametersMessage"}, - "output":{ - "shape":"DescribeEngineDefaultParametersResult", - "resultWrapper":"DescribeEngineDefaultParametersResult" - }, - "documentation":"

Returns the default engine and system parameter information for the specified database engine.

" - }, - "DescribeEventCategories":{ - "name":"DescribeEventCategories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventCategoriesMessage"}, - "output":{ - "shape":"EventCategoriesMessage", - "resultWrapper":"DescribeEventCategoriesResult" - }, - "documentation":"

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in the Events topic in the Amazon RDS User Guide.

" - }, - "DescribeEventSubscriptions":{ - "name":"DescribeEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventSubscriptionsMessage"}, - "output":{ - "shape":"EventSubscriptionsMessage", - "resultWrapper":"DescribeEventSubscriptionsResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"} - ], - "documentation":"

Lists all the subscription descriptions for a customer account. The description for a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

If you specify a SubscriptionName, lists the description for that subscription.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{ - "shape":"EventsMessage", - "resultWrapper":"DescribeEventsResult" - }, - "documentation":"

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

" - }, - "DescribeOptionGroupOptions":{ - "name":"DescribeOptionGroupOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOptionGroupOptionsMessage"}, - "output":{ - "shape":"OptionGroupOptionsMessage", - "resultWrapper":"DescribeOptionGroupOptionsResult" - }, - "documentation":"

Describes all available options.

" - }, - "DescribeOptionGroups":{ - "name":"DescribeOptionGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOptionGroupsMessage"}, - "output":{ - "shape":"OptionGroups", - "resultWrapper":"DescribeOptionGroupsResult" - }, - "errors":[ - {"shape":"OptionGroupNotFoundFault"} - ], - "documentation":"

Describes the available option groups.

" - }, - "DescribeOrderableDBInstanceOptions":{ - "name":"DescribeOrderableDBInstanceOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrderableDBInstanceOptionsMessage"}, - "output":{ - "shape":"OrderableDBInstanceOptionsMessage", - "resultWrapper":"DescribeOrderableDBInstanceOptionsResult" - }, - "documentation":"

Returns a list of orderable DB instance options for the specified engine.

" - }, - "DescribePendingMaintenanceActions":{ - "name":"DescribePendingMaintenanceActions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePendingMaintenanceActionsMessage"}, - "output":{ - "shape":"PendingMaintenanceActionsMessage", - "resultWrapper":"DescribePendingMaintenanceActionsResult" - }, - "errors":[ - {"shape":"ResourceNotFoundFault"} - ], - "documentation":"

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

" - }, - "DescribeReservedDBInstances":{ - "name":"DescribeReservedDBInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedDBInstancesMessage"}, - "output":{ - "shape":"ReservedDBInstanceMessage", - "resultWrapper":"DescribeReservedDBInstancesResult" - }, - "errors":[ - {"shape":"ReservedDBInstanceNotFoundFault"} - ], - "documentation":"

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

" - }, - "DescribeReservedDBInstancesOfferings":{ - "name":"DescribeReservedDBInstancesOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedDBInstancesOfferingsMessage"}, - "output":{ - "shape":"ReservedDBInstancesOfferingMessage", - "resultWrapper":"DescribeReservedDBInstancesOfferingsResult" - }, - "errors":[ - {"shape":"ReservedDBInstancesOfferingNotFoundFault"} - ], - "documentation":"

Lists available reserved DB instance offerings.

" - }, - "DescribeSourceRegions":{ - "name":"DescribeSourceRegions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSourceRegionsMessage"}, - "output":{ - "shape":"SourceRegionMessage", - "resultWrapper":"DescribeSourceRegionsResult" - }, - "documentation":"

Returns a list of the source AWS Regions where the current AWS Region can create a Read Replica or copy a DB snapshot from. This API action supports pagination.

" - }, - "DescribeValidDBInstanceModifications":{ - "name":"DescribeValidDBInstanceModifications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeValidDBInstanceModificationsMessage"}, - "output":{ - "shape":"DescribeValidDBInstanceModificationsResult", - "resultWrapper":"DescribeValidDBInstanceModificationsResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"} - ], - "documentation":"

You can call DescribeValidDBInstanceModifications to learn what modifications you can make to your DB instance. You can use this information when you call ModifyDBInstance.

" - }, - "DownloadDBLogFilePortion":{ - "name":"DownloadDBLogFilePortion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DownloadDBLogFilePortionMessage"}, - "output":{ - "shape":"DownloadDBLogFilePortionDetails", - "resultWrapper":"DownloadDBLogFilePortionResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBLogFileNotFoundFault"} - ], - "documentation":"

Downloads all or a portion of the specified log file, up to 1 MB in size.

" - }, - "FailoverDBCluster":{ - "name":"FailoverDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"FailoverDBClusterMessage"}, - "output":{ - "shape":"FailoverDBClusterResult", - "resultWrapper":"FailoverDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBInstanceStateFault"} - ], - "documentation":"

Forces a failover for a DB cluster.

A failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary instance (the cluster writer).

Amazon Aurora will automatically fail over to an Aurora Replica, if one exists, when the primary instance fails. You can force a failover when you want to simulate a failure of a primary instance for testing. Because each instance in a DB cluster has its own endpoint address, you will need to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceMessage"}, - "output":{ - "shape":"TagListMessage", - "resultWrapper":"ListTagsForResourceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Lists all tags on an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources.

" - }, - "ModifyCurrentDBClusterCapacity":{ - "name":"ModifyCurrentDBClusterCapacity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyCurrentDBClusterCapacityMessage"}, - "output":{ - "shape":"DBClusterCapacityInfo", - "resultWrapper":"ModifyCurrentDBClusterCapacityResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBClusterCapacityFault"} - ], - "documentation":"

Set the capacity of an Aurora Serverless DB cluster to a specific value.

Aurora Serverless scales seamlessly based on the workload on the DB cluster. In some cases, the capacity might not scale fast enough to meet a sudden change in workload, such as a large number of new transactions. Call ModifyCurrentDBClusterCapacity to set the capacity explicitly.

After this call sets the DB cluster capacity, Aurora Serverless can automatically scale the DB cluster based on the cooldown period for scaling up and the cooldown period for scaling down.

For more information about Aurora Serverless, see Using Amazon Aurora Serverless in the Amazon RDS User Guide.

If you call ModifyCurrentDBClusterCapacity with the default TimeoutAction, connections that prevent Aurora Serverless from finding a scaling point might be dropped. For more information about scaling points, see Autoscaling for Aurora Serverless in the Amazon RDS User Guide.

" - }, - "ModifyDBCluster":{ - "name":"ModifyDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterMessage"}, - "output":{ - "shape":"ModifyDBClusterResult", - "resultWrapper":"ModifyDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"DBClusterParameterGroupNotFoundFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBClusterAlreadyExistsFault"} - ], - "documentation":"

Modify a setting for an Amazon Aurora DB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "ModifyDBClusterParameterGroup":{ - "name":"ModifyDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterParameterGroupMessage"}, - "output":{ - "shape":"DBClusterParameterGroupNameMessage", - "resultWrapper":"ModifyDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InvalidDBParameterGroupStateFault"} - ], - "documentation":"

Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB cluster associated with the parameter group before the change can take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

" - }, - "ModifyDBClusterSnapshotAttribute":{ - "name":"ModifyDBClusterSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBClusterSnapshotAttributeMessage"}, - "output":{ - "shape":"ModifyDBClusterSnapshotAttributeResult", - "resultWrapper":"ModifyDBClusterSnapshotAttributeResult" - }, - "errors":[ - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"SharedSnapshotQuotaExceededFault"} - ], - "documentation":"

Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.

To share a manual DB cluster snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB cluster snapshot. Use the value all to make the manual DB cluster snapshot public, which means that it can be copied or restored by all AWS accounts. Do not add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts. If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

To view which AWS accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot public or private, use the DescribeDBClusterSnapshotAttributes API action.

" - }, - "ModifyDBInstance":{ - "name":"ModifyDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBInstanceMessage"}, - "output":{ - "shape":"ModifyDBInstanceResult", - "resultWrapper":"ModifyDBInstanceResult" - }, - "errors":[ - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"}, - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"DBUpgradeDependencyFailureFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"CertificateNotFoundFault"}, - {"shape":"DomainNotFoundFault"}, - {"shape":"BackupPolicyNotFoundFault"} - ], - "documentation":"

Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.

" - }, - "ModifyDBParameterGroup":{ - "name":"ModifyDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBParameterGroupMessage"}, - "output":{ - "shape":"DBParameterGroupNameMessage", - "resultWrapper":"ModifyDBParameterGroupResult" - }, - "errors":[ - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"InvalidDBParameterGroupStateFault"} - ], - "documentation":"

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

" - }, - "ModifyDBSnapshot":{ - "name":"ModifyDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBSnapshotMessage"}, - "output":{ - "shape":"ModifyDBSnapshotResult", - "resultWrapper":"ModifyDBSnapshotResult" - }, - "errors":[ - {"shape":"DBSnapshotNotFoundFault"} - ], - "documentation":"

Updates a manual DB snapshot, which can be encrypted or not encrypted, with a new engine version.

Amazon RDS supports upgrading DB snapshots for MySQL and Oracle.

" - }, - "ModifyDBSnapshotAttribute":{ - "name":"ModifyDBSnapshotAttribute", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBSnapshotAttributeMessage"}, - "output":{ - "shape":"ModifyDBSnapshotAttributeResult", - "resultWrapper":"ModifyDBSnapshotAttributeResult" - }, - "errors":[ - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"SharedSnapshotQuotaExceededFault"} - ], - "documentation":"

Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.

To share a manual DB snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB snapshot. Uses the value all to make the manual DB snapshot public, which means it can be copied or restored by all AWS accounts. Do not add the all value for any manual DB snapshots that contain private information that you don't want available to all AWS accounts. If the manual DB snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

To view which AWS accounts have access to copy or restore a manual DB snapshot, or whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API action.

" - }, - "ModifyDBSubnetGroup":{ - "name":"ModifyDBSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDBSubnetGroupMessage"}, - "output":{ - "shape":"ModifyDBSubnetGroupResult", - "resultWrapper":"ModifyDBSubnetGroupResult" - }, - "errors":[ - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetQuotaExceededFault"}, - {"shape":"SubnetAlreadyInUse"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"} - ], - "documentation":"

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

" - }, - "ModifyEventSubscription":{ - "name":"ModifyEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyEventSubscriptionMessage"}, - "output":{ - "shape":"ModifyEventSubscriptionResult", - "resultWrapper":"ModifyEventSubscriptionResult" - }, - "errors":[ - {"shape":"EventSubscriptionQuotaExceededFault"}, - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"} - ], - "documentation":"

Modifies an existing RDS event notification subscription. Note that you can't modify the source identifiers using this call; to change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

You can see a list of the event categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "ModifyOptionGroup":{ - "name":"ModifyOptionGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyOptionGroupMessage"}, - "output":{ - "shape":"ModifyOptionGroupResult", - "resultWrapper":"ModifyOptionGroupResult" - }, - "errors":[ - {"shape":"InvalidOptionGroupStateFault"}, - {"shape":"OptionGroupNotFoundFault"} - ], - "documentation":"

Modifies an existing option group.

" - }, - "PromoteReadReplica":{ - "name":"PromoteReadReplica", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PromoteReadReplicaMessage"}, - "output":{ - "shape":"PromoteReadReplicaResult", - "resultWrapper":"PromoteReadReplicaResult" - }, - "errors":[ - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

Promotes a Read Replica DB instance to a standalone DB instance.

  • Backup duration is a function of the amount of changes to the database since the previous backup. If you plan to promote a Read Replica to a standalone instance, we recommend that you enable backups and complete at least one backup prior to promotion. In addition, a Read Replica cannot be promoted to a standalone instance when it is in the backing-up status. If you have enabled backups on your Read Replica, configure the automated backup window so that daily backups do not interfere with Read Replica promotion.

  • This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.

" - }, - "PromoteReadReplicaDBCluster":{ - "name":"PromoteReadReplicaDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PromoteReadReplicaDBClusterMessage"}, - "output":{ - "shape":"PromoteReadReplicaDBClusterResult", - "resultWrapper":"PromoteReadReplicaDBClusterResult" - }, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Promotes a Read Replica DB cluster to a standalone DB cluster.

" - }, - "PurchaseReservedDBInstancesOffering":{ - "name":"PurchaseReservedDBInstancesOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedDBInstancesOfferingMessage"}, - "output":{ - "shape":"PurchaseReservedDBInstancesOfferingResult", - "resultWrapper":"PurchaseReservedDBInstancesOfferingResult" - }, - "errors":[ - {"shape":"ReservedDBInstancesOfferingNotFoundFault"}, - {"shape":"ReservedDBInstanceAlreadyExistsFault"}, - {"shape":"ReservedDBInstanceQuotaExceededFault"} - ], - "documentation":"

Purchases a reserved DB instance offering.

" - }, - "RebootDBInstance":{ - "name":"RebootDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootDBInstanceMessage"}, - "output":{ - "shape":"RebootDBInstanceResult", - "resultWrapper":"RebootDBInstanceResult" - }, - "errors":[ - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBInstanceNotFoundFault"} - ], - "documentation":"

You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.

Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.

For more information about rebooting, see Rebooting a DB Instance.

" - }, - "RemoveRoleFromDBCluster":{ - "name":"RemoveRoleFromDBCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveRoleFromDBClusterMessage"}, - "errors":[ - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterRoleNotFoundFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Disassociates an Identity and Access Management (IAM) role from an Aurora DB cluster. For more information, see Authorizing Amazon Aurora to Access Other AWS Services On Your Behalf.

" - }, - "RemoveSourceIdentifierFromSubscription":{ - "name":"RemoveSourceIdentifierFromSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveSourceIdentifierFromSubscriptionMessage"}, - "output":{ - "shape":"RemoveSourceIdentifierFromSubscriptionResult", - "resultWrapper":"RemoveSourceIdentifierFromSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SourceNotFoundFault"} - ], - "documentation":"

Removes a source identifier from an existing RDS event notification subscription.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceMessage"}, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterNotFoundFault"} - ], - "documentation":"

Removes metadata tags from an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources.

" - }, - "ResetDBClusterParameterGroup":{ - "name":"ResetDBClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetDBClusterParameterGroupMessage"}, - "output":{ - "shape":"DBClusterParameterGroupNameMessage", - "resultWrapper":"ResetDBClusterParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the entire DB cluster parameter group, specify the DBClusterParameterGroupName and ResetAllParameters parameters.

When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request. You must call RebootDBInstance for every DB instance in your DB cluster that you want the updated static parameter to apply to.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "ResetDBParameterGroup":{ - "name":"ResetDBParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetDBParameterGroupMessage"}, - "output":{ - "shape":"DBParameterGroupNameMessage", - "resultWrapper":"ResetDBParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidDBParameterGroupStateFault"}, - {"shape":"DBParameterGroupNotFoundFault"} - ], - "documentation":"

Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.

" - }, - "RestoreDBClusterFromS3":{ - "name":"RestoreDBClusterFromS3", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBClusterFromS3Message"}, - "output":{ - "shape":"RestoreDBClusterFromS3Result", - "resultWrapper":"RestoreDBClusterFromS3Result" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidS3BucketFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"} - ], - "documentation":"

Creates an Amazon Aurora DB cluster from data stored in an Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be created using the Percona XtraBackup utility as described in Migrating Data from MySQL by Using an Amazon S3 Bucket.

" - }, - "RestoreDBClusterFromSnapshot":{ - "name":"RestoreDBClusterFromSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBClusterFromSnapshotMessage"}, - "output":{ - "shape":"RestoreDBClusterFromSnapshotResult", - "resultWrapper":"RestoreDBClusterFromSnapshotResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"InsufficientDBClusterCapacityFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"} - ], - "documentation":"

Creates a new DB cluster from a DB snapshot or DB cluster snapshot.

If a DB snapshot is specified, the target DB cluster is created from the source DB snapshot with a default configuration and default security group.

If a DB cluster snapshot is specified, the target DB cluster is created from the source DB cluster restore point with the same configuration as the original source DB cluster, except that the new DB cluster is created with the default security group.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "RestoreDBClusterToPointInTime":{ - "name":"RestoreDBClusterToPointInTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBClusterToPointInTimeMessage"}, - "output":{ - "shape":"RestoreDBClusterToPointInTimeResult", - "resultWrapper":"RestoreDBClusterToPointInTimeResult" - }, - "errors":[ - {"shape":"DBClusterAlreadyExistsFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"DBClusterQuotaExceededFault"}, - {"shape":"DBClusterSnapshotNotFoundFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"InsufficientDBClusterCapacityFault"}, - {"shape":"InsufficientStorageClusterCapacityFault"}, - {"shape":"InvalidDBClusterSnapshotStateFault"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBClusterParameterGroupNotFoundFault"} - ], - "documentation":"

Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before LatestRestorableTime for up to BackupRetentionPeriod days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group.

This action only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the CreateDBInstance action to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster in DBClusterIdentifier. You can create DB instances only after the RestoreDBClusterToPointInTime action has completed and the DB cluster is available.

For more information on Amazon Aurora, see Aurora on Amazon RDS in the Amazon RDS User Guide.

" - }, - "RestoreDBInstanceFromDBSnapshot":{ - "name":"RestoreDBInstanceFromDBSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBInstanceFromDBSnapshotMessage"}, - "output":{ - "shape":"RestoreDBInstanceFromDBSnapshotResult", - "resultWrapper":"RestoreDBInstanceFromDBSnapshotResult" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"DBSnapshotNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"InvalidDBSnapshotStateFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"DomainNotFoundFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"BackupPolicyNotFoundFault"} - ], - "documentation":"

Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with the most of original configuration with the default security group and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored AZ deployment and not a single-AZ deployment.

If your intent is to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the RestoreDBInstanceFromDBSnapshot action. RDS doesn't allow two DB instances with the same name. Once you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as the DBInstanceIdentifier in the call to the RestoreDBInstanceFromDBSnapshot action. The result is that you will replace the original DB instance with the DB instance created from the snapshot.

If you are restoring from a shared manual DB snapshot, the DBSnapshotIdentifier must be the ARN of the shared DB snapshot.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use RestoreDBClusterFromSnapshot.

" - }, - "RestoreDBInstanceFromS3":{ - "name":"RestoreDBInstanceFromS3", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBInstanceFromS3Message"}, - "output":{ - "shape":"RestoreDBInstanceFromS3Result", - "resultWrapper":"RestoreDBInstanceFromS3Result" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidS3BucketFault"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"BackupPolicyNotFoundFault"} - ], - "documentation":"

Amazon Relational Database Service (Amazon RDS) supports importing MySQL databases by using backup files. You can create a backup of your on-premises database, store it on Amazon Simple Storage Service (Amazon S3), and then restore the backup file onto a new Amazon RDS DB instance running MySQL. For more information, see Importing Data into an Amazon RDS MySQL DB Instance.

" - }, - "RestoreDBInstanceToPointInTime":{ - "name":"RestoreDBInstanceToPointInTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreDBInstanceToPointInTimeMessage"}, - "output":{ - "shape":"RestoreDBInstanceToPointInTimeResult", - "resultWrapper":"RestoreDBInstanceToPointInTimeResult" - }, - "errors":[ - {"shape":"DBInstanceAlreadyExistsFault"}, - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InstanceQuotaExceededFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"PointInTimeRestoreNotEnabledFault"}, - {"shape":"StorageQuotaExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidSubnet"}, - {"shape":"ProvisionedIopsNotAvailableInAZFault"}, - {"shape":"OptionGroupNotFoundFault"}, - {"shape":"StorageTypeNotSupportedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"}, - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"DomainNotFoundFault"}, - {"shape":"DBParameterGroupNotFoundFault"}, - {"shape":"BackupPolicyNotFoundFault"} - ], - "documentation":"

Restores a DB instance to an arbitrary point in time. You can restore to any point in time before the time identified by the LatestRestorableTime property. You can restore to a point up to the number of days specified by the BackupRetentionPeriod property.

The target database is created with most of the original configuration, but in a system-selected Availability Zone, with the default security group, the default subnet group, and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored deployment and not a single-AZ deployment.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use RestoreDBClusterToPointInTime.

" - }, - "RevokeDBSecurityGroupIngress":{ - "name":"RevokeDBSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeDBSecurityGroupIngressMessage"}, - "output":{ - "shape":"RevokeDBSecurityGroupIngressResult", - "resultWrapper":"RevokeDBSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"DBSecurityGroupNotFoundFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"InvalidDBSecurityGroupStateFault"} - ], - "documentation":"

Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC Security Groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).

" - }, - "StartDBInstance":{ - "name":"StartDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartDBInstanceMessage"}, - "output":{ - "shape":"StartDBInstanceResult", - "resultWrapper":"StartDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"InsufficientDBInstanceCapacityFault"}, - {"shape":"DBSubnetGroupNotFoundFault"}, - {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, - {"shape":"InvalidDBClusterStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"DBClusterNotFoundFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"KMSKeyNotAccessibleFault"} - ], - "documentation":"

Starts a DB instance that was stopped using the AWS console, the stop-db-instance AWS CLI command, or the StopDBInstance action. For more information, see Stopping and Starting a DB instance in the AWS RDS user guide.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.

" - }, - "StopDBInstance":{ - "name":"StopDBInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopDBInstanceMessage"}, - "output":{ - "shape":"StopDBInstanceResult", - "resultWrapper":"StopDBInstanceResult" - }, - "errors":[ - {"shape":"DBInstanceNotFoundFault"}, - {"shape":"InvalidDBInstanceStateFault"}, - {"shape":"DBSnapshotAlreadyExistsFault"}, - {"shape":"SnapshotQuotaExceededFault"}, - {"shape":"InvalidDBClusterStateFault"} - ], - "documentation":"

Stops a DB instance. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if necessary. For more information, see Stopping and Starting a DB instance in the AWS RDS user guide.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.

" - } - }, - "shapes":{ - "AccountAttributesMessage":{ - "type":"structure", - "members":{ - "AccountQuotas":{ - "shape":"AccountQuotaList", - "documentation":"

A list of AccountQuota objects. Within this list, each quota has a name, a count of usage toward the quota maximum, and a maximum value for the quota.

" - } - }, - "documentation":"

Data returned by the DescribeAccountAttributes action.

" - }, - "AccountQuota":{ - "type":"structure", - "members":{ - "AccountQuotaName":{ - "shape":"String", - "documentation":"

The name of the Amazon RDS quota for this AWS account.

" - }, - "Used":{ - "shape":"Long", - "documentation":"

The amount currently used toward the quota maximum.

" - }, - "Max":{ - "shape":"Long", - "documentation":"

The maximum allowed value for the quota.

" - } - }, - "documentation":"

Describes a quota for an AWS account, for example, the number of DB instances allowed.

", - "wrapper":true - }, - "AccountQuotaList":{ - "type":"list", - "member":{ - "shape":"AccountQuota", - "locationName":"AccountQuota" - } - }, - "AddRoleToDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "RoleArn" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to associate the IAM role with.

" - }, - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to associate with the Aurora DB cluster, for example arn:aws:iam::123456789012:role/AuroraAccessRole.

" - } - } - }, - "AddSourceIdentifierToSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to add a source identifier to.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source to be added.

Constraints:

  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.

  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.

  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.

  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.

" - } - }, - "documentation":"

" - }, - "AddSourceIdentifierToSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "AddTagsToResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource that the tags are added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the Amazon RDS resource.

" - } - }, - "documentation":"

" - }, - "ApplyMethod":{ - "type":"string", - "enum":[ - "immediate", - "pending-reboot" - ] - }, - "ApplyPendingMaintenanceActionMessage":{ - "type":"structure", - "required":[ - "ResourceIdentifier", - "ApplyAction", - "OptInType" - ], - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The RDS Amazon Resource Name (ARN) of the resource that the pending maintenance action applies to. For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "ApplyAction":{ - "shape":"String", - "documentation":"

The pending maintenance action to apply to this resource.

Valid values: system-update, db-upgrade

" - }, - "OptInType":{ - "shape":"String", - "documentation":"

A value that specifies the type of opt-in request, or undoes an opt-in request. An opt-in request of type immediate can't be undone.

Valid values:

  • immediate - Apply the maintenance action immediately.

  • next-maintenance - Apply the maintenance action during the next maintenance window for the resource.

  • undo-opt-in - Cancel any existing next-maintenance opt-in requests.

" - } - }, - "documentation":"

" - }, - "ApplyPendingMaintenanceActionResult":{ - "type":"structure", - "members":{ - "ResourcePendingMaintenanceActions":{"shape":"ResourcePendingMaintenanceActions"} - } - }, - "AttributeValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AttributeValue" - } - }, - "AuthorizationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified CIDRIP or Amazon EC2 security group is already authorized for the specified DB security group.

", - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified CIDRIP or Amazon EC2 security group isn't authorized for the specified DB security group.

RDS also may not be authorized by using IAM to perform necessary actions on your behalf.

", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "AuthorizationQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB security group authorization quota has been reached.

", - "error":{ - "code":"AuthorizationQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthorizeDBSecurityGroupIngressMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to add authorization to.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range to authorize.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

Name of the EC2 security group to authorize. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

Id of the EC2 security group to authorize. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

AWS account number of the owner of the EC2 security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - } - }, - "documentation":"

" - }, - "AuthorizeDBSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the Availability Zone.

" - } - }, - "documentation":"

Contains Availability Zone information.

This data type is used as an element in the following data type:

", - "wrapper":true - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"AvailabilityZone" - } - }, - "AvailabilityZones":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AvailabilityZone" - } - }, - "AvailableProcessorFeature":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the processor feature. Valid names are coreCount and threadsPerCore.

" - }, - "DefaultValue":{ - "shape":"String", - "documentation":"

The default value for the processor feature of the DB instance class.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The allowed values for the processor feature of the DB instance class.

" - } - }, - "documentation":"

Contains the available processor feature information for the DB instance class of a DB instance.

For more information, see Configuring the Processor of the DB Instance Class in the Amazon RDS User Guide.

" - }, - "AvailableProcessorFeatureList":{ - "type":"list", - "member":{ - "shape":"AvailableProcessorFeature", - "locationName":"AvailableProcessorFeature" - } - }, - "BacktrackDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "BacktrackTo" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier of the DB cluster to be backtracked. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1

" - }, - "BacktrackTo":{ - "shape":"TStamp", - "documentation":"

The timestamp of the time to backtrack the DB cluster to, specified in ISO 8601 format. For more information about ISO 8601, see the ISO8601 Wikipedia page.

If the specified time is not a consistent time for the DB cluster, Aurora automatically chooses the nearest possible consistent time for the DB cluster.

Constraints:

  • Must contain a valid ISO 8601 timestamp.

  • Cannot contain a timestamp set in the future.

Example: 2017-07-08T18:00Z

" - }, - "Force":{ - "shape":"BooleanOptional", - "documentation":"

A value that, if specified, forces the DB cluster to backtrack when binary logging is enabled. Otherwise, an error occurs when binary logging is enabled.

" - }, - "UseEarliestTimeOnPointInTimeUnavailable":{ - "shape":"BooleanOptional", - "documentation":"

If BacktrackTo is set to a timestamp earlier than the earliest backtrack time, this value backtracks the DB cluster to the earliest possible backtrack time. Otherwise, an error occurs.

" - } - }, - "documentation":"

" - }, - "BackupPolicyNotFoundFault":{ - "type":"structure", - "members":{ - }, - "error":{ - "code":"BackupPolicyNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "Certificate":{ - "type":"structure", - "members":{ - "CertificateIdentifier":{ - "shape":"String", - "documentation":"

The unique key that identifies a certificate.

" - }, - "CertificateType":{ - "shape":"String", - "documentation":"

The type of the certificate.

" - }, - "Thumbprint":{ - "shape":"String", - "documentation":"

The thumbprint of the certificate.

" - }, - "ValidFrom":{ - "shape":"TStamp", - "documentation":"

The starting date from which the certificate is valid.

" - }, - "ValidTill":{ - "shape":"TStamp", - "documentation":"

The final date that the certificate continues to be valid.

" - }, - "CertificateArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the certificate.

" - } - }, - "documentation":"

A CA certificate for an AWS account.

", - "wrapper":true - }, - "CertificateList":{ - "type":"list", - "member":{ - "shape":"Certificate", - "locationName":"Certificate" - } - }, - "CertificateMessage":{ - "type":"structure", - "members":{ - "Certificates":{ - "shape":"CertificateList", - "documentation":"

The list of Certificate objects for the AWS account.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeCertificates request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Data returned by the DescribeCertificates action.

" - }, - "CertificateNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

CertificateIdentifier doesn't refer to an existing certificate.

", - "error":{ - "code":"CertificateNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "CharacterSet":{ - "type":"structure", - "members":{ - "CharacterSetName":{ - "shape":"String", - "documentation":"

The name of the character set.

" - }, - "CharacterSetDescription":{ - "shape":"String", - "documentation":"

The description of the character set.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "CloudwatchLogsExportConfiguration":{ - "type":"structure", - "members":{ - "EnableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The list of log types to enable.

" - }, - "DisableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The list of log types to disable.

" - } - }, - "documentation":"

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance or DB cluster.

The EnableLogTypes and DisableLogTypes arrays determine which logs will be exported (or not exported) to CloudWatch Logs. The values within these arrays depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "CopyDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "SourceDBClusterParameterGroupIdentifier", - "TargetDBClusterParameterGroupIdentifier", - "TargetDBClusterParameterGroupDescription" - ], - "members":{ - "SourceDBClusterParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or Amazon Resource Name (ARN) for the source DB cluster parameter group. For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid DB cluster parameter group.

  • If the source DB cluster parameter group is in the same AWS Region as the copy, specify a valid DB parameter group identifier, for example my-db-cluster-param-group, or a valid ARN.

  • If the source DB parameter group is in a different AWS Region than the copy, specify a valid DB cluster parameter group ARN, for example arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1.

" - }, - "TargetDBClusterParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied DB cluster parameter group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-cluster-param-group1

" - }, - "TargetDBClusterParameterGroupDescription":{ - "shape":"String", - "documentation":"

A description for the copied DB cluster parameter group.

" - }, - "Tags":{"shape":"TagList"} - } - }, - "CopyDBClusterParameterGroupResult":{ - "type":"structure", - "members":{ - "DBClusterParameterGroup":{"shape":"DBClusterParameterGroup"} - } - }, - "CopyDBClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "SourceDBClusterSnapshotIdentifier", - "TargetDBClusterSnapshotIdentifier" - ], - "members":{ - "SourceDBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.

You can't copy an encrypted, shared DB cluster snapshot from one AWS Region to another.

Constraints:

  • Must specify a valid system snapshot in the \"available\" state.

  • If the source snapshot is in the same AWS Region as the copy, specify a valid DB snapshot identifier.

  • If the source snapshot is in a different AWS Region than the copy, specify a valid DB cluster snapshot ARN. For more information, go to Copying a DB Snapshot or DB Cluster Snapshot.

Example: my-cluster-snapshot1

" - }, - "TargetDBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is not case-sensitive.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster-snapshot2

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If you don't specify a value for KmsKeyId, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source DB cluster snapshot.

If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a value for KmsKeyId.

To copy an encrypted DB cluster snapshot to another AWS Region, you must set KmsKeyId to the KMS key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

If you copy an unencrypted DB cluster snapshot and specify a value for the KmsKeyId parameter, an error is returned.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

The URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot API action in the AWS Region that contains the source DB cluster snapshot to copy. The PreSignedUrl parameter must be used when copying an encrypted DB cluster snapshot from another AWS Region.

The pre-signed URL must be a valid request for the CopyDBSClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL request must contain the following parameter values:

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

  • DestinationRegion - The name of the AWS Region that the DB cluster snapshot will be created in.

  • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "CopyTags":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot, and otherwise false. The default is false.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "CopyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "SourceDBParameterGroupIdentifier", - "TargetDBParameterGroupIdentifier", - "TargetDBParameterGroupDescription" - ], - "members":{ - "SourceDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or ARN for the source DB parameter group. For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid DB parameter group.

  • Must specify a valid DB parameter group identifier, for example my-db-param-group, or a valid ARN.

" - }, - "TargetDBParameterGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied DB parameter group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-parameter-group

" - }, - "TargetDBParameterGroupDescription":{ - "shape":"String", - "documentation":"

A description for the copied DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CopyDBSnapshotMessage":{ - "type":"structure", - "required":[ - "SourceDBSnapshotIdentifier", - "TargetDBSnapshotIdentifier" - ], - "members":{ - "SourceDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source DB snapshot.

If the source snapshot is in the same AWS Region as the copy, specify a valid DB snapshot identifier. For example, you might specify rds:mysql-instance1-snapshot-20130805.

If the source snapshot is in a different AWS Region than the copy, specify a valid DB snapshot ARN. For example, you might specify arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805.

If you are copying from a shared manual DB snapshot, this parameter must be the Amazon Resource Name (ARN) of the shared DB snapshot.

If you are copying an encrypted snapshot this parameter must be in the ARN format for the source AWS Region, and must match the SourceDBSnapshotIdentifier in the PreSignedUrl parameter.

Constraints:

  • Must specify a valid system snapshot in the \"available\" state.

Example: rds:mydb-2012-04-02-00-01

Example: arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805

" - }, - "TargetDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copy of the snapshot.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-db-snapshot

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key ID for an encrypted DB snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted DB snapshot from your AWS account, you can specify a value for this parameter to encrypt the copy with a new KMS encryption key. If you don't specify a value for this parameter, then the copy of the DB snapshot is encrypted with the same KMS key as the source DB snapshot.

If you copy an encrypted DB snapshot that is shared from another AWS account, then you must specify a value for this parameter.

If you specify this parameter when you copy an unencrypted snapshot, the copy is encrypted.

If you copy an encrypted snapshot to a different AWS Region, then you must specify a KMS key for the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

" - }, - "Tags":{"shape":"TagList"}, - "CopyTags":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the source DB snapshot to the target DB snapshot, and otherwise false. The default is false.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

The URL that contains a Signature Version 4 signed request for the CopyDBSnapshot API action in the source AWS Region that contains the source DB snapshot to copy.

You must specify this parameter when you copy an encrypted DB snapshot from another AWS Region by using the Amazon RDS API. You can specify the --source-region option instead of this parameter when you copy an encrypted DB snapshot from another AWS Region by using the AWS CLI.

The presigned URL must be a valid request for the CopyDBSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB snapshot to be copied. The presigned URL request must contain the following parameter values:

  • DestinationRegion - The AWS Region that the encrypted DB snapshot is copied to. This AWS Region is the same one where the CopyDBSnapshot action is called that contains this presigned URL.

    For example, if you copy an encrypted DB snapshot from the us-west-2 AWS Region to the us-east-1 AWS Region, then you call the CopyDBSnapshot action in the us-east-1 AWS Region and provide a presigned URL that contains a call to the CopyDBSnapshot action in the us-west-2 AWS Region. For this example, the DestinationRegion in the presigned URL must be set to the us-east-1 AWS Region.

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the copy of the DB snapshot in the destination AWS Region. This is the same identifier for both the CopyDBSnapshot action that is called in the destination AWS Region, and the action contained in the presigned URL.

  • SourceDBSnapshotIdentifier - The DB snapshot identifier for the encrypted snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB snapshot from the us-west-2 AWS Region, then your SourceDBSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20161115.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of an option group to associate with the copy of the snapshot.

Specify this option if you are copying a snapshot from one AWS Region to another, and your DB instance uses a nondefault option group. If your source DB instance uses Transparent Data Encryption for Oracle or Microsoft SQL Server, you must specify this option when copying across AWS Regions. For more information, see Option Group Considerations.

" - } - }, - "documentation":"

" - }, - "CopyDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "CopyOptionGroupMessage":{ - "type":"structure", - "required":[ - "SourceOptionGroupIdentifier", - "TargetOptionGroupIdentifier", - "TargetOptionGroupDescription" - ], - "members":{ - "SourceOptionGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier or ARN for the source option group. For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

Constraints:

  • Must specify a valid option group.

  • If the source option group is in the same AWS Region as the copy, specify a valid option group identifier, for example my-option-group, or a valid ARN.

  • If the source option group is in a different AWS Region than the copy, specify a valid option group ARN, for example arn:aws:rds:us-west-2:123456789012:og:special-options.

" - }, - "TargetOptionGroupIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the copied option group.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-option-group

" - }, - "TargetOptionGroupDescription":{ - "shape":"String", - "documentation":"

The description for the copied option group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CopyOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "CreateDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "Engine" - ], - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

A list of EC2 Availability Zones that instances in the DB cluster can be created in. For information on AWS Regions and Availability Zones, see Regions and Availability Zones.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified CharacterSet.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The name for your database of up to 64 alpha-numeric characters. If you do not provide a name, Amazon RDS will not create a database in the DB cluster you are creating.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1

" - }, - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, default.aurora5.6 is used.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with this DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB cluster.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this DB cluster.

Valid Values: aurora (for MySQL 5.6-compatible Aurora), aurora-mysql (for MySQL 5.7-compatible Aurora), and aurora-postgresql

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

Aurora MySQL

Example: 5.6.10a, 5.7.12

Aurora PostgreSQL

Example: 9.6.3

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the instances in the DB cluster accept connections.

Default: 3306 if engine is set as aurora or 5432 if set to aurora-postgresql.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name of the master user for the DB cluster.

Constraints:

  • Must be 1 to 16 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified option group.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "ReplicationSourceIdentifier":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a Read Replica.

" - }, - "Tags":{"shape":"TagList"}, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB cluster is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If an encryption key is not specified in KmsKeyId:

  • If ReplicationSourceIdentifier identifies an encrypted source, then Amazon RDS will use the encryption key used to encrypt the source. Otherwise, Amazon RDS will use your default encryption key.

  • If the StorageEncrypted parameter is true and ReplicationSourceIdentifier is not specified, then Amazon RDS will use your default encryption key.

AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

If you create a Read Replica of an encrypted DB cluster in another AWS Region, you must set KmsKeyId to a KMS key ID that is valid in the destination AWS Region. This key is used to encrypt the Read Replica in that AWS Region.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

A URL that contains a Signature Version 4 signed request for the CreateDBCluster action to be called in the source AWS Region where the DB cluster is replicated from. You only need to specify PreSignedUrl when you are performing cross-region replication from an encrypted DB cluster.

The pre-signed URL must be a valid request for the CreateDBCluster API action that can be executed in the source AWS Region that contains the encrypted DB cluster to be copied.

The pre-signed URL request must contain the following parameter values:

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the copy of the DB cluster in the destination AWS Region. This should refer to the same KMS key for both the CreateDBCluster action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

  • DestinationRegion - The name of the AWS Region that Aurora Read Replica will be created in.

  • ReplicationSourceIdentifier - The DB cluster identifier for the encrypted DB cluster to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster from the us-west-2 AWS Region, then your ReplicationSourceIdentifier would look like Example: arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "EngineMode":{ - "shape":"String", - "documentation":"

The DB engine mode of the DB cluster, either provisioned or serverless.

" - }, - "ScalingConfiguration":{ - "shape":"ScalingConfiguration", - "documentation":"

For DB clusters in serverless DB engine mode, the scaling properties of the DB cluster.

" - } - }, - "documentation":"

" - }, - "CreateDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBClusterParameterGroupName", - "DBParameterGroupFamily", - "Description" - ], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must match the name of an existing DBClusterParameterGroup.

This value is stored as a lowercase string.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.

Aurora MySQL

Example: aurora5.6, aurora-mysql5.7

Aurora PostgreSQL

Example: aurora-postgresql9.6

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the DB cluster parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBClusterParameterGroupResult":{ - "type":"structure", - "members":{ - "DBClusterParameterGroup":{"shape":"DBClusterParameterGroup"} - } - }, - "CreateDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "CreateDBClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "DBClusterSnapshotIdentifier", - "DBClusterIdentifier" - ], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1-snapshot1

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster to create a snapshot for. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

Example: my-cluster1

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the DB cluster snapshot.

" - } - }, - "documentation":"

" - }, - "CreateDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "CreateDBInstanceMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "DBInstanceClass", - "Engine" - ], - "members":{ - "DBName":{ - "shape":"String", - "documentation":"

The meaning of this parameter differs according to the database engine you use.

Type: String

MySQL

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

  • Must contain 1 to 64 letters or numbers.

  • Cannot be a word reserved by the specified database engine

MariaDB

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

  • Must contain 1 to 64 letters or numbers.

  • Cannot be a word reserved by the specified database engine

PostgreSQL

The name of the database to create when the DB instance is created. If this parameter is not specified, the default \"postgres\" database is created in the DB instance.

Constraints:

  • Must contain 1 to 63 letters, numbers, or underscores.

  • Must begin with a letter or an underscore. Subsequent characters can be letters, underscores, or digits (0-9).

  • Cannot be a word reserved by the specified database engine

Oracle

The Oracle System ID (SID) of the created DB instance. If you specify null, the default value ORCL is used. You can't specify the string NULL, or any other reserved word, for DBName.

Default: ORCL

Constraints:

  • Cannot be longer than 8 characters

SQL Server

Not applicable. Must be null.

Amazon Aurora

The name of the database to create when the primary instance of the DB cluster is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

  • Must contain 1 to 64 letters or numbers.

  • Cannot be a word reserved by the specified database engine

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gibibytes) to allocate for the DB instance.

Type: Integer

Amazon Aurora

Not applicable. Aurora cluster volumes automatically grow as the amount of data in your database increases, though you are only charged for the space that you use in an Aurora cluster volume.

MySQL

Constraints to the amount of storage for each storage type are the following:

  • General Purpose (SSD) storage (gp2): Must be an integer from 20 to 16384.

  • Provisioned IOPS storage (io1): Must be an integer from 100 to 16384.

  • Magnetic storage (standard): Must be an integer from 5 to 3072.

MariaDB

Constraints to the amount of storage for each storage type are the following:

  • General Purpose (SSD) storage (gp2): Must be an integer from 20 to 16384.

  • Provisioned IOPS storage (io1): Must be an integer from 100 to 16384.

  • Magnetic storage (standard): Must be an integer from 5 to 3072.

PostgreSQL

Constraints to the amount of storage for each storage type are the following:

  • General Purpose (SSD) storage (gp2): Must be an integer from 20 to 16384.

  • Provisioned IOPS storage (io1): Must be an integer from 100 to 16384.

  • Magnetic storage (standard): Must be an integer from 5 to 3072.

Oracle

Constraints to the amount of storage for each storage type are the following:

  • General Purpose (SSD) storage (gp2): Must be an integer from 20 to 16384.

  • Provisioned IOPS storage (io1): Must be an integer from 100 to 16384.

  • Magnetic storage (standard): Must be an integer from 10 to 3072.

SQL Server

Constraints to the amount of storage for each storage type are the following:

  • General Purpose (SSD) storage (gp2):

    • Enterprise and Standard editions: Must be an integer from 200 to 16384.

    • Web and Express editions: Must be an integer from 20 to 16384.

  • Provisioned IOPS storage (io1):

    • Enterprise and Standard editions: Must be an integer from 200 to 16384.

    • Web and Express editions: Must be an integer from 100 to 16384.

  • Magnetic storage (standard):

    • Enterprise and Standard editions: Must be an integer from 200 to 1024.

    • Web and Express editions: Must be an integer from 20 to 1024.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this instance.

Not every database engine is available for every AWS Region.

Valid Values:

  • aurora (for MySQL 5.6-compatible Aurora)

  • aurora-mysql (for MySQL 5.7-compatible Aurora)

  • aurora-postgresql

  • mariadb

  • mysql

  • oracle-ee

  • oracle-se2

  • oracle-se1

  • oracle-se

  • postgres

  • sqlserver-ee

  • sqlserver-se

  • sqlserver-ex

  • sqlserver-web

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name for the master user.

Amazon Aurora

Not applicable. The name for the master user is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

Constraints:

  • Required for MariaDB.

  • Must be 1 to 16 letters or numbers.

  • Cannot be a reserved word for the chosen database engine.

Microsoft SQL Server

Constraints:

  • Required for SQL Server.

  • Must be 1 to 128 letters or numbers.

  • The first character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

MySQL

Constraints:

  • Required for MySQL.

  • Must be 1 to 16 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

Oracle

Constraints:

  • Required for Oracle.

  • Must be 1 to 30 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

PostgreSQL

Constraints:

  • Required for PostgreSQL.

  • Must be 1 to 63 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Amazon Aurora

Not applicable. The password for the master user is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

Constraints: Must contain from 8 to 41 characters.

Microsoft SQL Server

Constraints: Must contain from 8 to 128 characters.

MySQL

Constraints: Must contain from 8 to 41 characters.

Oracle

Constraints: Must contain from 8 to 30 characters.

PostgreSQL

Constraints: Must contain from 8 to 128 characters.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to associate with this DB instance.

Default: The default DB security group for the database engine.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with this DB instance.

Amazon Aurora

Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: The default EC2 VPC security group for the DB subnet group's VPC.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the DB instance is created in. For information on AWS Regions and Availability Zones, see Regions and Availability Zones.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same AWS Region as the current endpoint.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB instance.

If there is no DB subnet group, then it is a non-VPC DB instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC). For more information, see Amazon RDS Maintenance Window.

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: 1

Constraints:

  • Must be a value from 0 to 35

  • Cannot be set to 0 if the DB instance is a source to Read Replicas

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. For more information, see The Backup Window.

Amazon Aurora

Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred DB Instance Maintenance Window.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

MySQL

Default: 3306

Valid Values: 1150-65535

Type: Integer

MariaDB

Default: 3306

Valid Values: 1150-65535

Type: Integer

PostgreSQL

Default: 5432

Valid Values: 1150-65535

Type: Integer

Oracle

Default: 1521

Valid Values: 1150-65535

SQL Server

Default: 1433

Valid Values: 1150-65535 except for 1434, 3389, 47001, 49152, and 49152 through 49156.

Amazon Aurora

Default: 3306

Valid Values: 1150-65535

Type: Integer

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. You can't set the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

For a list of valid engine versions, call DescribeDBEngineVersions.

The following are the database engines and links to information about the major and minor versions that are available with Amazon RDS. Not every database engine is available for every AWS Region.

Amazon Aurora

Not applicable. The version number of the database engine to be used by the DB instance is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

See MariaDB on Amazon RDS Versions in the Amazon RDS User Guide.

Microsoft SQL Server

See Version and Feature Support on Amazon RDS in the Amazon RDS User Guide.

MySQL

See MySQL on Amazon RDS Versions in the Amazon RDS User Guide.

Oracle

See Oracle Database Engine Release Notes in the Amazon RDS User Guide.

PostgreSQL

See Supported PostgreSQL Database Versions in the Amazon RDS User Guide.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.

Default: true

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance. For information about valid Iops values, see see Amazon RDS Provisioned IOPS Storage to Improve Performance.

Constraints: Must be a multiple between 1 and 50 of the storage amount for the DB instance. Must also be an integer multiple of 1000. For example, if the size of your DB instance is 500 GiB, then your Iops value can be 2000, 3000, 4000, or 5000.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

For supported engines, indicates that the DB instance should be associated with the specified CharacterSet.

Amazon Aurora

Not applicable. The character set is managed by the DB cluster. For more information, see CreateDBCluster.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName is not specified, and PubliclyAccessible is not specified, the following applies:

  • If the default VPC in the target region doesn’t have an Internet gateway attached to it, the DB instance is private.

  • If the default VPC in the target region has an Internet gateway attached to it, the DB instance is public.

If DBSubnetGroupName is specified, and PubliclyAccessible is not specified, the following applies:

  • If the subnets are part of a VPC that doesn’t have an Internet gateway attached to it, the DB instance is private.

  • If the subnets are part of a VPC that has an Internet gateway attached to it, the DB instance is public.

" - }, - "Tags":{"shape":"TagList"}, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster that the instance will belong to.

For information on creating a DB cluster, see CreateDBCluster.

Type: String

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB instance is encrypted.

Amazon Aurora

Not applicable. The encryption for DB instances is managed by the DB cluster. For more information, see CreateDBCluster.

Default: false

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB instance.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB instance with the same AWS account that owns the KMS encryption key used to encrypt the new DB instance, then you can use the KMS key alias instead of the ARN for the KM encryption key.

Amazon Aurora

Not applicable. The KMS key identifier is managed by the DB cluster. For more information, see CreateDBCluster.

If the StorageEncrypted parameter is true, and you do not specify a value for the KmsKeyId parameter, then Amazon RDS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

Specify the Active Directory Domain to create the instance in.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess. For information on creating a monitoring role, go to Setting Up and Enabling Enhanced Monitoring.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

Specify the name of the IAM role to be used when making API calls to the Directory Service.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance. For more information, see Fault Tolerance for an Aurora DB Cluster.

Default: 1

Valid Values: 0 - 15

" - }, - "Timezone":{ - "shape":"String", - "documentation":"

The time zone of the DB instance. The time zone parameter is currently supported only by Microsoft SQL Server.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines:

Amazon Aurora

Not applicable. Mapping AWS IAM accounts to database accounts is managed by the DB cluster. For more information, see CreateDBCluster.

MySQL

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

Default: false

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the DB instance, and otherwise false.

For more information, see Using Amazon Performance Insights in the Amazon Relational Database Service User Guide.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "PerformanceInsightsRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - } - }, - "documentation":"

" - }, - "CreateDBInstanceReadReplicaMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "SourceDBInstanceIdentifier" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier of the Read Replica. This identifier is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.

" - }, - "SourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB instance that will act as the source for the Read Replica. Each DB instance can have up to five Read Replicas.

Constraints:

  • Must be the identifier of an existing MySQL, MariaDB, or PostgreSQL DB instance.

  • Can specify a DB instance that is a MySQL Read Replica only if the source is running MySQL 5.6.

  • Can specify a DB instance that is a PostgreSQL DB instance only if the source is running PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-region replication).

  • The specified DB instance must have automatic backups enabled, its backup retention period must be greater than 0.

  • If the source DB instance is in the same AWS Region as the Read Replica, specify a valid DB instance identifier.

  • If the source DB instance is in a different AWS Region than the Read Replica, specify a valid DB instance ARN. For more information, go to Constructing a Amazon RDS Amazon Resource Name (ARN).

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Read Replica, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Default: Inherits from the source DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Amazon EC2 Availability Zone that the Read Replica is created in.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number that the DB instance uses for connections.

Default: Inherits from the source DB instance

Valid Values: 1150-65535

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the Read Replica is in a Multi-AZ deployment.

You can create a Read Replica as a Multi-AZ DB instance. RDS creates a standby of your replica in another Availability Zone for failover support for the replica. Creating your Read Replica as a Multi-AZ DB instance is independent of whether the source database is a Multi-AZ DB instance.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor engine upgrades are applied automatically to the Read Replica during the maintenance window.

Default: Inherits from the source DB instance

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The option group the DB instance is associated with. If omitted, the default option group for the engine specified is used.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address. For more information, see CreateDBInstance.

" - }, - "Tags":{"shape":"TagList"}, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

Specifies a DB subnet group for the DB instance. The new DB instance is created in the VPC associated with the DB subnet group. If no DB subnet group is specified, then the new DB instance is not created in a VPC.

Constraints:

  • Can only be specified if the source DB instance identifier specifies a DB instance in another AWS Region.

  • If supplied, must match the name of an existing DBSubnetGroup.

  • The specified DB subnet group must be in the same AWS Region in which the operation is running.

  • All Read Replicas in one AWS Region that are created from the same source DB instance must either:>

    • Specify DB subnet groups from the same VPC. All these Read Replicas are created in the same VPC.

    • Not specify a DB subnet group. All these Read Replicas are created outside of any VPC.

Example: mySubnetgroup

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the Read Replica.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the Read Replica to snapshots of the Read Replica, and otherwise false. The default is false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the Read Replica. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess. For information on creating a monitoring role, go to To create an IAM role for Amazon RDS Enhanced Monitoring.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key ID for an encrypted Read Replica. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you specify this parameter when you create a Read Replica from an unencrypted DB instance, the Read Replica is encrypted.

If you create an encrypted Read Replica in the same AWS Region as the source DB instance, then you do not have to specify a value for this parameter. The Read Replica is encrypted with the same KMS key as the source DB instance.

If you create an encrypted Read Replica in a different AWS Region, then you must specify a KMS key for the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

" - }, - "PreSignedUrl":{ - "shape":"String", - "documentation":"

The URL that contains a Signature Version 4 signed request for the CreateDBInstanceReadReplica API action in the source AWS Region that contains the source DB instance.

You must specify this parameter when you create an encrypted Read Replica from another AWS Region by using the Amazon RDS API. You can specify the --source-region option instead of this parameter when you create an encrypted Read Replica from another AWS Region by using the AWS CLI.

The presigned URL must be a valid request for the CreateDBInstanceReadReplica API action that can be executed in the source AWS Region that contains the encrypted source DB instance. The presigned URL request must contain the following parameter values:

  • DestinationRegion - The AWS Region that the encrypted Read Replica is created in. This AWS Region is the same one where the CreateDBInstanceReadReplica action is called that contains this presigned URL.

    For example, if you create an encrypted DB instance in the us-west-1 AWS Region, from a source DB instance in the us-east-2 AWS Region, then you call the CreateDBInstanceReadReplica action in the us-east-1 AWS Region and provide a presigned URL that contains a call to the CreateDBInstanceReadReplica action in the us-west-2 AWS Region. For this example, the DestinationRegion in the presigned URL must be set to the us-east-1 AWS Region.

  • KmsKeyId - The AWS KMS key identifier for the key to use to encrypt the Read Replica in the destination AWS Region. This is the same identifier for both the CreateDBInstanceReadReplica action that is called in the destination AWS Region, and the action contained in the presigned URL.

  • SourceDBInstanceIdentifier - The DB instance identifier for the encrypted DB instance to be replicated. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are creating an encrypted Read Replica from a DB instance in the us-west-2 AWS Region, then your SourceDBInstanceIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115.

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

  • Aurora 5.6 or higher.

Default: false

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the read replica, and otherwise false.

For more information, see Using Amazon Performance Insights in the Amazon Relational Database Service User Guide.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "PerformanceInsightsRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the new DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - }, - "UseDefaultProcessorFeatures":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies that the DB instance class of the DB instance uses its default processor features.

" - } - } - }, - "CreateDBInstanceReadReplicaResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "CreateDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "CreateDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "DBParameterGroupFamily", - "Description" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

This value is stored as a lowercase string.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.

To list all of the available parameter group families, use the following command:

aws rds describe-db-engine-versions --query \"DBEngineVersions[].DBParameterGroupFamily\"

The output contains duplicates.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description for the DB parameter group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBParameterGroupResult":{ - "type":"structure", - "members":{ - "DBParameterGroup":{"shape":"DBParameterGroup"} - } - }, - "CreateDBSecurityGroupMessage":{ - "type":"structure", - "required":[ - "DBSecurityGroupName", - "DBSecurityGroupDescription" - ], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name for the DB security group. This value is stored as a lowercase string.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

  • Must not be \"Default\"

Example: mysecuritygroup

" - }, - "DBSecurityGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB security group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSecurityGroupResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - }, - "CreateDBSnapshotMessage":{ - "type":"structure", - "required":[ - "DBSnapshotIdentifier", - "DBInstanceIdentifier" - ], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB instance that you want to create the snapshot of.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "CreateDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "DBSubnetGroupDescription", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 letters, numbers, periods, underscores, spaces, or hyphens. Must not be default.

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 Subnet IDs for the DB subnet group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "CreateEventSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SnsTopicArn" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the subscription.

Constraints: The name must be less than 255 characters.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

The list of identifiers of the event sources for which events are returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it can't end with a hyphen or contain two consecutive hyphens.

Constraints:

  • If SourceIds are supplied, SourceType must also be provided.

  • If the source type is a DB instance, then a DBInstanceIdentifier must be supplied.

  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.

  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.

  • If the source type is a DB snapshot, a DBSnapshotIdentifier must be supplied.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "CreateOptionGroupMessage":{ - "type":"structure", - "required":[ - "OptionGroupName", - "EngineName", - "MajorEngineVersion", - "OptionGroupDescription" - ], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the option group to be created.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: myoptiongroup

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Specifies the name of the engine that this option group should be associated with.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Specifies the major version of the engine that this option group should be associated with.

" - }, - "OptionGroupDescription":{ - "shape":"String", - "documentation":"

The description of the option group.

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "CreateOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "DBCluster":{ - "type":"structure", - "members":{ - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

For all database engines except Amazon Aurora, AllocatedStorage specifies the allocated storage size in gibibytes (GiB). For Aurora, AllocatedStorage always returns 1, because Aurora DB cluster storage size is not fixed, but instead automatically adjusts as needed.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the number of days for which automatic DB snapshots are retained.

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

If present, specifies the name of the character set that this cluster is associated with.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

" - }, - "DBClusterParameterGroup":{ - "shape":"String", - "documentation":"

Specifies the name of the DB cluster parameter group for the DB cluster.

" - }, - "DBSubnetGroup":{ - "shape":"String", - "documentation":"

Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the current state of this DB cluster.

" - }, - "PercentProgress":{ - "shape":"String", - "documentation":"

Specifies the progress of the operation as a percentage.

" - }, - "EarliestRestorableTime":{ - "shape":"TStamp", - "documentation":"

The earliest time to which a database can be restored with point-in-time restore.

" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

Specifies the connection endpoint for the primary instance of the DB cluster.

" - }, - "ReaderEndpoint":{ - "shape":"String", - "documentation":"

The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Aurora Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Aurora distributes the connection requests among the Aurora Replicas in the DB cluster. This functionality can help balance your read workload across multiple Aurora Replicas in your DB cluster.

If a failover occurs, and the Aurora Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Aurora Replicas in the cluster, you can then reconnect to the reader endpoint.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster has instances in multiple Availability Zones.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Provides the name of the database engine to be used for this DB cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "LatestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the latest time to which a database can be restored with point-in-time restore.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the port that the database engine is listening on.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Contains the master username for the DB cluster.

" - }, - "DBClusterOptionGroupMemberships":{ - "shape":"DBClusterOptionGroupMemberships", - "documentation":"

Provides the list of option group memberships for this DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

" - }, - "ReplicationSourceIdentifier":{ - "shape":"String", - "documentation":"

Contains the identifier of the source DB cluster if this DB cluster is a Read Replica.

" - }, - "ReadReplicaIdentifiers":{ - "shape":"ReadReplicaIdentifierList", - "documentation":"

Contains one or more identifiers of the Read Replicas associated with this DB cluster.

" - }, - "DBClusterMembers":{ - "shape":"DBClusterMemberList", - "documentation":"

Provides the list of instances that make up the DB cluster.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

Provides a list of VPC security groups that the DB cluster belongs to.

" - }, - "HostedZoneId":{ - "shape":"String", - "documentation":"

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster.

" - }, - "DbClusterResourceId":{ - "shape":"String", - "documentation":"

The AWS Region-unique, immutable identifier for the DB cluster. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS key for the DB cluster is accessed.

" - }, - "DBClusterArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster.

" - }, - "AssociatedRoles":{ - "shape":"DBClusterRoles", - "documentation":"

Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other AWS services on your behalf.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

" - }, - "CloneGroupId":{ - "shape":"String", - "documentation":"

Identifies the clone group to which the DB cluster is associated.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

" - }, - "EarliestBacktrackTime":{ - "shape":"TStamp", - "documentation":"

The earliest time to which a DB cluster can be backtracked.

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. If this value is set to 0, backtracking is disabled for the DB cluster. Otherwise, backtracking is enabled.

" - }, - "BacktrackConsumedChangeRecords":{ - "shape":"LongOptional", - "documentation":"

The number of change records stored for Backtrack.

" - }, - "EnabledCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

A list of log types that this DB cluster is configured to export to CloudWatch Logs.

Log types vary by DB engine. For information about the log types for each DB engine, see Amazon RDS Database Log Files in the Amazon RDS User Guide.

" - }, - "Capacity":{"shape":"IntegerOptional"}, - "EngineMode":{ - "shape":"String", - "documentation":"

The DB engine mode of the DB cluster, either provisioned or serverless.

" - }, - "ScalingConfigurationInfo":{"shape":"ScalingConfigurationInfo"} - }, - "documentation":"

Contains the details of an Amazon RDS DB cluster.

This data type is used as a response element in the DescribeDBClusters action.

", - "wrapper":true - }, - "DBClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The user already has a DB cluster with the given identifier.

", - "error":{ - "code":"DBClusterAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterBacktrack":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

" - }, - "BacktrackIdentifier":{ - "shape":"String", - "documentation":"

Contains the backtrack identifier.

" - }, - "BacktrackTo":{ - "shape":"TStamp", - "documentation":"

The timestamp of the time to which the DB cluster was backtracked.

" - }, - "BacktrackedFrom":{ - "shape":"TStamp", - "documentation":"

The timestamp of the time from which the DB cluster was backtracked.

" - }, - "BacktrackRequestCreationTime":{ - "shape":"TStamp", - "documentation":"

The timestamp of the time at which the backtrack was requested.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the backtrack. This property returns one of the following values:

  • applying - The backtrack is currently being applied to or rolled back from the DB cluster.

  • completed - The backtrack has successfully been applied to or rolled back from the DB cluster.

  • failed - An error occurred while the backtrack was applied to or rolled back from the DB cluster.

  • pending - The backtrack is currently pending application to or rollback from the DB cluster.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBClusterBacktracks action.

" - }, - "DBClusterBacktrackList":{ - "type":"list", - "member":{ - "shape":"DBClusterBacktrack", - "locationName":"DBClusterBacktrack" - } - }, - "DBClusterBacktrackMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeDBClusterBacktracks request.

" - }, - "DBClusterBacktracks":{ - "shape":"DBClusterBacktrackList", - "documentation":"

Contains a list of backtracks for the user.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBClusterBacktracks action.

" - }, - "DBClusterBacktrackNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

BacktrackIdentifier doesn't refer to an existing backtrack.

", - "error":{ - "code":"DBClusterBacktrackNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterCapacityInfo":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

A user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

" - }, - "PendingCapacity":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the capacity that the DB cluster scales to next.

" - }, - "CurrentCapacity":{ - "shape":"IntegerOptional", - "documentation":"

The current capacity of the DB cluster.

" - }, - "SecondsBeforeTimeout":{ - "shape":"IntegerOptional", - "documentation":"

The number of seconds before a call to ModifyCurrentDBClusterCapacity times out.

" - }, - "TimeoutAction":{ - "shape":"String", - "documentation":"

The timeout action of a call to ModifyCurrentDBClusterCapacity, either ForceApplyCapacityChange or RollbackCapacityChange.

" - } - } - }, - "DBClusterList":{ - "type":"list", - "member":{ - "shape":"DBCluster", - "locationName":"DBCluster" - } - }, - "DBClusterMember":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Specifies the instance identifier for this member of the DB cluster.

" - }, - "IsClusterWriter":{ - "shape":"Boolean", - "documentation":"

Value that is true if the cluster member is the primary instance for the DB cluster and false otherwise.

" - }, - "DBClusterParameterGroupStatus":{ - "shape":"String", - "documentation":"

Specifies the status of the DB cluster parameter group for this member of the DB cluster.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance. For more information, see Fault Tolerance for an Aurora DB Cluster.

" - } - }, - "documentation":"

Contains information about an instance that is part of a DB cluster.

", - "wrapper":true - }, - "DBClusterMemberList":{ - "type":"list", - "member":{ - "shape":"DBClusterMember", - "locationName":"DBClusterMember" - } - }, - "DBClusterMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeDBClusters request.

" - }, - "DBClusters":{ - "shape":"DBClusterList", - "documentation":"

Contains a list of DB clusters for the user.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBClusters action.

" - }, - "DBClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterIdentifier doesn't refer to an existing DB cluster.

", - "error":{ - "code":"DBClusterNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterOptionGroupMemberships":{ - "type":"list", - "member":{ - "shape":"DBClusterOptionGroupStatus", - "locationName":"DBClusterOptionGroup" - } - }, - "DBClusterOptionGroupStatus":{ - "type":"structure", - "members":{ - "DBClusterOptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the DB cluster option group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of the DB cluster option group.

" - } - }, - "documentation":"

Contains status information for a DB cluster option group.

" - }, - "DBClusterParameterGroup":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB cluster parameter group.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group family that this DB cluster parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides the customer-specified description for this DB cluster parameter group.

" - }, - "DBClusterParameterGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster parameter group.

" - } - }, - "documentation":"

Contains the details of an Amazon RDS DB cluster parameter group.

This data type is used as a response element in the DescribeDBClusterParameterGroups action.

", - "wrapper":true - }, - "DBClusterParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Provides a list of parameters for the DB cluster parameter group.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Provides details about a DB cluster parameter group including the parameters in the DB cluster parameter group.

" - }, - "DBClusterParameterGroupList":{ - "type":"list", - "member":{ - "shape":"DBClusterParameterGroup", - "locationName":"DBClusterParameterGroup" - } - }, - "DBClusterParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must be 1 to 255 letters or numbers.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

This value is stored as a lowercase string.

" - } - }, - "documentation":"

" - }, - "DBClusterParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.

", - "error":{ - "code":"DBClusterParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBClusterParameterGroups":{ - "shape":"DBClusterParameterGroupList", - "documentation":"

A list of DB cluster parameter groups.

" - } - }, - "documentation":"

" - }, - "DBClusterQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.

", - "error":{ - "code":"DBClusterQuotaExceededFault", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "DBClusterRole":{ - "type":"structure", - "members":{ - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that is associated with the DB cluster.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Describes the state of association between the IAM role and the DB cluster. The Status property returns one of the following values:

  • ACTIVE - the IAM role ARN is associated with the DB cluster and can be used to access other AWS services on your behalf.

  • PENDING - the IAM role ARN is being associated with the DB cluster.

  • INVALID - the IAM role ARN is associated with the DB cluster, but the DB cluster is unable to assume the IAM role in order to access other AWS services on your behalf.

" - }, - "FeatureName":{"shape":"String"} - }, - "documentation":"

Describes an AWS Identity and Access Management (IAM) role that is associated with a DB cluster.

" - }, - "DBClusterRoleAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoleNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified IAM role Amazon Resource Name (ARN) isn't associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoleQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.

", - "error":{ - "code":"DBClusterRoleQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterRoles":{ - "type":"list", - "member":{ - "shape":"DBClusterRole", - "locationName":"DBClusterRole" - } - }, - "DBClusterSnapshot":{ - "type":"structure", - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

" - }, - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier for the DB cluster snapshot.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Specifies the name of the database engine.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size in gibibytes (GiB).

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of this DB cluster snapshot.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the DB cluster was listening on at the time of the snapshot.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VPC ID associated with the DB cluster snapshot.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Provides the master username for the DB cluster snapshot.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Provides the version of the database engine for this DB cluster snapshot.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

Provides the license model information for this DB cluster snapshot.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

Provides the type of the DB cluster snapshot.

" - }, - "PercentProgress":{ - "shape":"Integer", - "documentation":"

Specifies the percentage of the estimated data that has been transferred.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB cluster snapshot is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster snapshot.

" - }, - "DBClusterSnapshotArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB cluster snapshot.

" - }, - "SourceDBClusterSnapshotArn":{ - "shape":"String", - "documentation":"

If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

" - } - }, - "documentation":"

Contains the details for an Amazon RDS DB cluster snapshot

This data type is used as a response element in the DescribeDBClusterSnapshots action.

", - "wrapper":true - }, - "DBClusterSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The user already has a DB cluster snapshot with the given identifier.

", - "error":{ - "code":"DBClusterSnapshotAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBClusterSnapshotAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the manual DB cluster snapshot attribute.

The attribute named restore refers to the list of AWS accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

" - }, - "AttributeValues":{ - "shape":"AttributeValueList", - "documentation":"

The value(s) for the manual DB cluster snapshot attribute.

If the AttributeName field is set to restore, then this element returns a list of IDs of the AWS accounts that are authorized to copy or restore the manual DB cluster snapshot. If a value of all is in the list, then the manual DB cluster snapshot is public and available for any AWS account to copy or restore.

" - } - }, - "documentation":"

Contains the name and values of a manual DB cluster snapshot attribute.

Manual DB cluster snapshot attributes are used to authorize other AWS accounts to restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

" - }, - "DBClusterSnapshotAttributeList":{ - "type":"list", - "member":{ - "shape":"DBClusterSnapshotAttribute", - "locationName":"DBClusterSnapshotAttribute" - } - }, - "DBClusterSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the manual DB cluster snapshot that the attributes apply to.

" - }, - "DBClusterSnapshotAttributes":{ - "shape":"DBClusterSnapshotAttributeList", - "documentation":"

The list of attributes and values for the manual DB cluster snapshot.

" - } - }, - "documentation":"

Contains the results of a successful call to the DescribeDBClusterSnapshotAttributes API action.

Manual DB cluster snapshot attributes are used to authorize other AWS accounts to copy or restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute API action.

", - "wrapper":true - }, - "DBClusterSnapshotList":{ - "type":"list", - "member":{ - "shape":"DBClusterSnapshot", - "locationName":"DBClusterSnapshot" - } - }, - "DBClusterSnapshotMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBClusterSnapshots":{ - "shape":"DBClusterSnapshotList", - "documentation":"

Provides a list of DB cluster snapshots for the user.

" - } - }, - "documentation":"

Provides a list of DB cluster snapshots for the user as the result of a call to the DescribeDBClusterSnapshots action.

" - }, - "DBClusterSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

", - "error":{ - "code":"DBClusterSnapshotNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBEngineVersion":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family for the database engine.

" - }, - "DBEngineDescription":{ - "shape":"String", - "documentation":"

The description of the database engine.

" - }, - "DBEngineVersionDescription":{ - "shape":"String", - "documentation":"

The description of the database engine version.

" - }, - "DefaultCharacterSet":{ - "shape":"CharacterSet", - "documentation":"

The default character set for new instances of this engine version, if the CharacterSetName parameter of the CreateDBInstance API is not specified.

" - }, - "SupportedCharacterSets":{ - "shape":"SupportedCharacterSetsList", - "documentation":"

A list of the character sets supported by this engine for the CharacterSetName parameter of the CreateDBInstance action.

" - }, - "ValidUpgradeTarget":{ - "shape":"ValidUpgradeTargetList", - "documentation":"

A list of engine versions that this database engine version can be upgraded to.

" - }, - "SupportedTimezones":{ - "shape":"SupportedTimezonesList", - "documentation":"

A list of the time zones supported by this engine for the Timezone parameter of the CreateDBInstance action.

" - }, - "ExportableLogTypes":{ - "shape":"LogTypeList", - "documentation":"

The types of logs that the database engine has available for export to CloudWatch Logs.

" - }, - "SupportsLogExportsToCloudwatchLogs":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether the engine version supports exporting the log types specified by ExportableLogTypes to CloudWatch Logs.

" - }, - "SupportsReadReplica":{ - "shape":"Boolean", - "documentation":"

Indicates whether the database engine version supports read replicas.

" - }, - "SupportedEngineModes":{ - "shape":"EngineModeList", - "documentation":"

A list of the supported DB engine modes.

" - } - }, - "documentation":"

This data type is used as a response element in the action DescribeDBEngineVersions.

" - }, - "DBEngineVersionList":{ - "type":"list", - "member":{ - "shape":"DBEngineVersion", - "locationName":"DBEngineVersion" - } - }, - "DBEngineVersionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBEngineVersions":{ - "shape":"DBEngineVersionList", - "documentation":"

A list of DBEngineVersion elements.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBEngineVersions action.

" - }, - "DBInstance":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains a user-supplied database identifier. This identifier is the unique key that identifies a DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the name of the compute and memory capacity class of the DB instance.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Provides the name of the database engine to be used for this DB instance.

" - }, - "DBInstanceStatus":{ - "shape":"String", - "documentation":"

Specifies the current state of this database.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Contains the master username for the DB instance.

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The meaning of this parameter differs according to the database engine you use. For example, this value returns MySQL, MariaDB, or PostgreSQL information when returning values from CreateDBInstanceReadReplica since Read Replicas are only supported for these engines.

MySQL, MariaDB, SQL Server, PostgreSQL

Contains the name of the initial database of this instance that was provided at create time, if one was specified when the DB instance was created. This same name is returned for the life of the DB instance.

Type: String

Oracle

Contains the Oracle System ID (SID) of the created DB instance. Not shown when the returned parameters do not apply to an Oracle DB instance.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

Specifies the connection endpoint.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size specified in gibibytes.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the date and time the DB instance was created.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

" - }, - "BackupRetentionPeriod":{ - "shape":"Integer", - "documentation":"

Specifies the number of days for which automatic DB snapshots are retained.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupMembershipList", - "documentation":"

Provides List of DB security group elements containing only DBSecurityGroup.Name and DBSecurityGroup.Status subelements.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

Provides a list of VPC security group elements that the DB instance belongs to.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupStatusList", - "documentation":"

Provides the list of DB parameter groups applied to this DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Specifies the name of the Availability Zone the DB instance is located in.

" - }, - "DBSubnetGroup":{ - "shape":"DBSubnetGroup", - "documentation":"

Specifies information on the subnet group associated with the DB instance, including the name, description, and subnets in the subnet group.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

" - }, - "PendingModifiedValues":{ - "shape":"PendingModifiedValues", - "documentation":"

Specifies that changes to the DB instance are pending. This element is only included when changes are pending. Specific changes are identified by subelements.

" - }, - "LatestRestorableTime":{ - "shape":"TStamp", - "documentation":"

Specifies the latest time to which a database can be restored with point-in-time restore.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that minor version patches are applied automatically.

" - }, - "ReadReplicaSourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the identifier of the source DB instance if this DB instance is a Read Replica.

" - }, - "ReadReplicaDBInstanceIdentifiers":{ - "shape":"ReadReplicaDBInstanceIdentifierList", - "documentation":"

Contains one or more identifiers of the Read Replicas associated with this DB instance.

" - }, - "ReadReplicaDBClusterIdentifiers":{ - "shape":"ReadReplicaDBClusterIdentifierList", - "documentation":"

Contains one or more identifiers of Aurora DB clusters that are Read Replicas of this DB instance.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for this DB instance.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the Provisioned IOPS (I/O operations per second) value.

" - }, - "OptionGroupMemberships":{ - "shape":"OptionGroupMembershipList", - "documentation":"

Provides the list of option group memberships for this DB instance.

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

If present, specifies the name of the character set that this instance is associated with.

" - }, - "SecondaryAvailabilityZone":{ - "shape":"String", - "documentation":"

If present, specifies the name of the secondary Availability Zone for a DB instance with multi-AZ support.

" - }, - "PubliclyAccessible":{ - "shape":"Boolean", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address.

" - }, - "StatusInfos":{ - "shape":"DBInstanceStatusInfoList", - "documentation":"

The status of a Read Replica. If the instance is not a Read Replica, this is blank.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type associated with DB instance.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which the instance is associated for TDE encryption.

" - }, - "DbInstancePort":{ - "shape":"Integer", - "documentation":"

Specifies the port that the DB instance listens on. If the DB instance is part of a DB cluster, this can be a different port than the DB cluster port.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

If the DB instance is a member of a DB cluster, contains the name of the DB cluster that the DB instance is a member of.

" - }, - "StorageEncrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB instance is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB instance.

" - }, - "DbiResourceId":{ - "shape":"String", - "documentation":"

The AWS Region-unique, immutable identifier for the DB instance. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS key for the DB instance is accessed.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the CA certificate for this DB instance.

" - }, - "DomainMemberships":{ - "shape":"DomainMembershipList", - "documentation":"

The Active Directory Domain membership records associated with the DB instance.

" - }, - "CopyTagsToSnapshot":{ - "shape":"Boolean", - "documentation":"

Specifies whether tags are copied from the DB instance to snapshots of the DB instance.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance.

" - }, - "EnhancedMonitoringResourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon CloudWatch Logs log stream that receives the Enhanced Monitoring metrics data for the DB instance.

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance. For more information, see Fault Tolerance for an Aurora DB Cluster.

" - }, - "DBInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB instance.

" - }, - "Timezone":{ - "shape":"String", - "documentation":"

The time zone of the DB instance. In most cases, the Timezone element is empty. Timezone content appears only for Microsoft SQL Server DB instances that were created with a time zone specified.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

IAM database authentication can be enabled for the following database engines

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

  • Aurora 5.6 or higher. To enable IAM database authentication for Aurora, see DBCluster Type.

" - }, - "PerformanceInsightsEnabled":{ - "shape":"BooleanOptional", - "documentation":"

True if Performance Insights is enabled for the DB instance, and otherwise false.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "PerformanceInsightsRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

" - }, - "EnabledCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

A list of log types that this DB instance is configured to export to CloudWatch Logs.

Log types vary by DB engine. For information about the log types for each DB engine, see Amazon RDS Database Log Files in the Amazon RDS User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - } - }, - "documentation":"

Contains the details of an Amazon RDS DB instance.

This data type is used as a response element in the DescribeDBInstances action.

", - "wrapper":true - }, - "DBInstanceAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The user already has a DB instance with the given identifier.

", - "error":{ - "code":"DBInstanceAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBInstanceList":{ - "type":"list", - "member":{ - "shape":"DBInstance", - "locationName":"DBInstance" - } - }, - "DBInstanceMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "DBInstances":{ - "shape":"DBInstanceList", - "documentation":"

A list of DBInstance instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBInstances action.

" - }, - "DBInstanceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBInstanceIdentifier doesn't refer to an existing DB instance.

", - "error":{ - "code":"DBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBInstanceStatusInfo":{ - "type":"structure", - "members":{ - "StatusType":{ - "shape":"String", - "documentation":"

This value is currently \"read replication.\"

" - }, - "Normal":{ - "shape":"Boolean", - "documentation":"

Boolean value that is true if the instance is operating normally, or false if the instance is in an error state.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Status of the DB instance. For a StatusType of read replica, the values can be replicating, replication stop point set, replication stop point reached, error, stopped, or terminated.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Details of the error if there is an error for the instance. If the instance is not in an error state, this value is blank.

" - } - }, - "documentation":"

Provides a list of status information for a DB instance.

" - }, - "DBInstanceStatusInfoList":{ - "type":"list", - "member":{ - "shape":"DBInstanceStatusInfo", - "locationName":"DBInstanceStatusInfo" - } - }, - "DBLogFileNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

LogFileName doesn't refer to an existing DB log file.

", - "error":{ - "code":"DBLogFileNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroup":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group.

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group family that this DB parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides the customer-specified description for this DB parameter group.

" - }, - "DBParameterGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB parameter group.

" - } - }, - "documentation":"

Contains the details of an Amazon RDS DB parameter group.

This data type is used as a response element in the DescribeDBParameterGroups action.

", - "wrapper":true - }, - "DBParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A DB parameter group with the same name exists.

", - "error":{ - "code":"DBParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter values.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameters action.

" - }, - "DBParameterGroupList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroup", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

Provides the name of the DB parameter group.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the ModifyDBParameterGroup or ResetDBParameterGroup action.

" - }, - "DBParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBParameterGroupName doesn't refer to an existing DB parameter group.

", - "error":{ - "code":"DBParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of DB parameter groups.

", - "error":{ - "code":"DBParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBParameterGroupStatus":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DP parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - } - }, - "documentation":"

The status of the DB parameter group.

This data type is used as a response element in the following actions:

" - }, - "DBParameterGroupStatusList":{ - "type":"list", - "member":{ - "shape":"DBParameterGroupStatus", - "locationName":"DBParameterGroup" - } - }, - "DBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBParameterGroups":{ - "shape":"DBParameterGroupList", - "documentation":"

A list of DBParameterGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBParameterGroups action.

" - }, - "DBSecurityGroup":{ - "type":"structure", - "members":{ - "OwnerId":{ - "shape":"String", - "documentation":"

Provides the AWS ID of the owner of a specific DB security group.

" - }, - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the DB security group.

" - }, - "DBSecurityGroupDescription":{ - "shape":"String", - "documentation":"

Provides the description of the DB security group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VpcId of the DB security group.

" - }, - "EC2SecurityGroups":{ - "shape":"EC2SecurityGroupList", - "documentation":"

Contains a list of EC2SecurityGroup elements.

" - }, - "IPRanges":{ - "shape":"IPRangeList", - "documentation":"

Contains a list of IPRange elements.

" - }, - "DBSecurityGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB security group.

" - } - }, - "documentation":"

Contains the details for an Amazon RDS DB security group.

This data type is used as a response element in the DescribeDBSecurityGroups action.

", - "wrapper":true - }, - "DBSecurityGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A DB security group with the name specified in DBSecurityGroupName already exists.

", - "error":{ - "code":"DBSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSecurityGroupMembership":{ - "type":"structure", - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB security group.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "DBSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"DBSecurityGroupMembership", - "locationName":"DBSecurityGroup" - } - }, - "DBSecurityGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroups", - "documentation":"

A list of DBSecurityGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSecurityGroups action.

" - }, - "DBSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DBSecurityGroupName" - } - }, - "DBSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSecurityGroupName doesn't refer to an existing DB security group.

", - "error":{ - "code":"DBSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSecurityGroupNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A DB security group isn't allowed for this action.

", - "error":{ - "code":"DBSecurityGroupNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSecurityGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of DB security groups.

", - "error":{ - "code":"QuotaExceeded.DBSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSecurityGroups":{ - "type":"list", - "member":{ - "shape":"DBSecurityGroup", - "locationName":"DBSecurityGroup" - } - }, - "DBSnapshot":{ - "type":"structure", - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier for the DB snapshot.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Specifies the DB instance identifier of the DB instance this DB snapshot was created from.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).

" - }, - "Engine":{ - "shape":"String", - "documentation":"

Specifies the name of the database engine.

" - }, - "AllocatedStorage":{ - "shape":"Integer", - "documentation":"

Specifies the allocated storage size in gibibytes (GiB).

" - }, - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of this DB snapshot.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the database engine was listening on at the time of the snapshot.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

Specifies the name of the Availability Zone the DB instance was located in at the time of the DB snapshot.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VPC ID associated with the DB snapshot.

" - }, - "InstanceCreateTime":{ - "shape":"TStamp", - "documentation":"

Specifies the time when the snapshot was taken, in Universal Coordinated Time (UTC).

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

Provides the master username for the DB snapshot.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Specifies the version of the database engine.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

Provides the type of the DB snapshot.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the Provisioned IOPS (I/O operations per second) value of the DB instance at the time of the snapshot.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Provides the option group name for the DB snapshot.

" - }, - "PercentProgress":{ - "shape":"Integer", - "documentation":"

The percentage of the estimated data that has been transferred.

" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The AWS Region that the DB snapshot was created in or copied from.

" - }, - "SourceDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DB snapshot Amazon Resource Name (ARN) that the DB snapshot was copied from. It only has value in case of cross-customer or cross-region copy.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type associated with DB snapshot.

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

Specifies whether the DB snapshot is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

If Encrypted is true, the AWS KMS key identifier for the encrypted DB snapshot.

" - }, - "DBSnapshotArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB snapshot.

" - }, - "Timezone":{ - "shape":"String", - "documentation":"

The time zone of the DB snapshot. In most cases, the Timezone element is empty. Timezone content appears only for snapshots taken from Microsoft SQL Server DB instances that were created with a time zone specified.

" - }, - "IAMDatabaseAuthenticationEnabled":{ - "shape":"Boolean", - "documentation":"

True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance when the DB snapshot was created.

" - } - }, - "documentation":"

Contains the details of an Amazon RDS DB snapshot.

This data type is used as a response element in the DescribeDBSnapshots action.

", - "wrapper":true - }, - "DBSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSnapshotIdentifier is already used by an existing snapshot.

", - "error":{ - "code":"DBSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSnapshotAttribute":{ - "type":"structure", - "members":{ - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the manual DB snapshot attribute.

The attribute named restore refers to the list of AWS accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the ModifyDBSnapshotAttribute API action.

" - }, - "AttributeValues":{ - "shape":"AttributeValueList", - "documentation":"

The value or values for the manual DB snapshot attribute.

If the AttributeName field is set to restore, then this element returns a list of IDs of the AWS accounts that are authorized to copy or restore the manual DB snapshot. If a value of all is in the list, then the manual DB snapshot is public and available for any AWS account to copy or restore.

" - } - }, - "documentation":"

Contains the name and values of a manual DB snapshot attribute

Manual DB snapshot attributes are used to authorize other AWS accounts to restore a manual DB snapshot. For more information, see the ModifyDBSnapshotAttribute API.

", - "wrapper":true - }, - "DBSnapshotAttributeList":{ - "type":"list", - "member":{ - "shape":"DBSnapshotAttribute", - "locationName":"DBSnapshotAttribute" - } - }, - "DBSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the manual DB snapshot that the attributes apply to.

" - }, - "DBSnapshotAttributes":{ - "shape":"DBSnapshotAttributeList", - "documentation":"

The list of attributes and values for the manual DB snapshot.

" - } - }, - "documentation":"

Contains the results of a successful call to the DescribeDBSnapshotAttributes API action.

Manual DB snapshot attributes are used to authorize other AWS accounts to copy or restore a manual DB snapshot. For more information, see the ModifyDBSnapshotAttribute API action.

", - "wrapper":true - }, - "DBSnapshotList":{ - "type":"list", - "member":{ - "shape":"DBSnapshot", - "locationName":"DBSnapshot" - } - }, - "DBSnapshotMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSnapshots":{ - "shape":"DBSnapshotList", - "documentation":"

A list of DBSnapshot instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSnapshots action.

" - }, - "DBSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

", - "error":{ - "code":"DBSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroup":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group.

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

Provides the description of the DB subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

Provides the VpcId of the DB subnet group.

" - }, - "SubnetGroupStatus":{ - "shape":"String", - "documentation":"

Provides the status of the DB subnet group.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

Contains a list of Subnet elements.

" - }, - "DBSubnetGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the DB subnet group.

" - } - }, - "documentation":"

Contains the details of an Amazon RDS DB subnet group.

This data type is used as a response element in the DescribeDBSubnetGroups action.

", - "wrapper":true - }, - "DBSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSubnetGroupName is already used by an existing DB subnet group.

", - "error":{ - "code":"DBSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupDoesNotCoverEnoughAZs":{ - "type":"structure", - "members":{ - }, - "documentation":"

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

", - "error":{ - "code":"DBSubnetGroupDoesNotCoverEnoughAZs", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DBSubnetGroups":{ - "shape":"DBSubnetGroups", - "documentation":"

A list of DBSubnetGroup instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeDBSubnetGroups action.

" - }, - "DBSubnetGroupNotAllowedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DBSubnetGroup shouldn't be specified while creating read replicas that lie in the same region as the source instance.

", - "error":{ - "code":"DBSubnetGroupNotAllowedFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

DBSubnetGroupName doesn't refer to an existing DB subnet group.

", - "error":{ - "code":"DBSubnetGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of DB subnet groups.

", - "error":{ - "code":"DBSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBSubnetGroups":{ - "type":"list", - "member":{ - "shape":"DBSubnetGroup", - "locationName":"DBSubnetGroup" - } - }, - "DBSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.

", - "error":{ - "code":"DBSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DBUpgradeDependencyFailureFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB upgrade failed because a resource the DB depends on can't be modified.

", - "error":{ - "code":"DBUpgradeDependencyFailure", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DeleteDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier for the DB cluster to be deleted. This parameter isn't case-sensitive.

Constraints:

  • Must match an existing DBClusterIdentifier.

" - }, - "SkipFinalSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final DB cluster snapshot is created before the DB cluster is deleted. If true is specified, no DB cluster snapshot is created. If false is specified, a DB cluster snapshot is created before the DB cluster is deleted.

You must specify a FinalDBSnapshotIdentifier parameter if SkipFinalSnapshot is false.

Default: false

" - }, - "FinalDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterParameterGroupMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group.

Constraints:

  • Must be the name of an existing DB cluster parameter group.

  • You can't delete a default DB cluster parameter group.

  • Cannot be associated with any DB clusters.

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "DeleteDBClusterSnapshotMessage":{ - "type":"structure", - "required":["DBClusterSnapshotIdentifier"], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

" - } - }, - "documentation":"

" - }, - "DeleteDBClusterSnapshotResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshot":{"shape":"DBClusterSnapshot"} - } - }, - "DeleteDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier for the DB instance to be deleted. This parameter isn't case-sensitive.

Constraints:

  • Must match the name of an existing DB instance.

" - }, - "SkipFinalSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final DB snapshot is created before the DB instance is deleted. If true is specified, no DBSnapshot is created. If false is specified, a DB snapshot is created before the DB instance is deleted.

Note that when a DB instance is in a failure state and has a status of 'failed', 'incompatible-restore', or 'incompatible-network', it can only be deleted when the SkipFinalSnapshot parameter is set to \"true\".

Specify true when deleting a Read Replica.

The FinalDBSnapshotIdentifier parameter must be specified if SkipFinalSnapshot is false.

Default: false

" - }, - "FinalDBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

  • Must be 1 to 255 letters or numbers.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

  • Cannot be specified when deleting a Read Replica.

" - } - }, - "documentation":"

" - }, - "DeleteDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "DeleteDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must be the name of an existing DB parameter group

  • You can't delete a default DB parameter group

  • Cannot be associated with any DB instances

" - } - }, - "documentation":"

" - }, - "DeleteDBSecurityGroupMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to delete.

You can't delete the default DB security group.

Constraints:

  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

  • Must not be \"Default\"

" - } - }, - "documentation":"

" - }, - "DeleteDBSnapshotMessage":{ - "type":"structure", - "required":["DBSnapshotIdentifier"], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The DBSnapshot identifier.

Constraints: Must be the name of an existing DB snapshot in the available state.

" - } - }, - "documentation":"

" - }, - "DeleteDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "DeleteDBSubnetGroupMessage":{ - "type":"structure", - "required":["DBSubnetGroupName"], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the database subnet group to delete.

You can't delete the default subnet group.

Constraints:

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to delete.

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "DeleteOptionGroupMessage":{ - "type":"structure", - "required":["OptionGroupName"], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be deleted.

You can't delete default option groups.

" - } - }, - "documentation":"

" - }, - "DescribeAccountAttributesMessage":{ - "type":"structure", - "members":{ - }, - "documentation":"

" - }, - "DescribeCertificatesMessage":{ - "type":"structure", - "members":{ - "CertificateIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied certificate identifier. If this parameter is specified, information for only the identified certificate is returned. This parameter isn't case-sensitive.

Constraints:

  • Must match an existing CertificateIdentifier.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeCertificates request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterBacktracksMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier of the DB cluster to be described. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1

" - }, - "BacktrackIdentifier":{ - "shape":"String", - "documentation":"

If specified, this value is the backtrack identifier of the backtrack to be described.

Constraints:

Example: 123e4567-e89b-12d3-a456-426655440000

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more DB clusters to describe. Supported filters include the following:

  • db-cluster-backtrack-id - Accepts backtrack identifiers. The results list includes information about only the backtracks identified by these identifiers.

  • db-cluster-backtrack-status - Accepts any of the following backtrack status values:

    • applying

    • completed

    • failed

    • pending

    The results list includes information about only the backtracks identified by these values. For more information about backtrack status values, see DBClusterBacktrack.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterBacktracks request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB cluster parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterParametersMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB cluster parameter group to return parameter details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Source":{ - "shape":"String", - "documentation":"

A value that indicates to return only parameters for a specific source. Parameter sources can be engine, service, or customer.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterSnapshotAttributesMessage":{ - "type":"structure", - "required":["DBClusterSnapshotIdentifier"], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB cluster snapshot to describe the attributes for.

" - } - }, - "documentation":"

" - }, - "DescribeDBClusterSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotAttributesResult":{"shape":"DBClusterSnapshotAttributesResult"} - } - }, - "DescribeDBClusterSnapshotsMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The ID of the DB cluster to retrieve the list of DB cluster snapshots for. This parameter can't be used in conjunction with the DBClusterSnapshotIdentifier parameter. This parameter is not case-sensitive.

Constraints:

  • If supplied, must match the identifier of an existing DBCluster.

" - }, - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

A specific DB cluster snapshot identifier to describe. This parameter can't be used in conjunction with the DBClusterIdentifier parameter. This value is stored as a lowercase string.

Constraints:

  • If supplied, must match the identifier of an existing DBClusterSnapshot.

  • If this identifier is for an automated snapshot, the SnapshotType parameter must also be specified.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The type of DB cluster snapshots to be returned. You can specify one of the following values:

  • automated - Return all DB cluster snapshots that have been automatically taken by Amazon RDS for my AWS account.

  • manual - Return all DB cluster snapshots that have been taken by my AWS account.

  • shared - Return all manual DB cluster snapshots that have been shared to my AWS account.

  • public - Return all DB cluster snapshots that have been marked as public.

If you don't specify a SnapshotType value, then both automated and manual DB cluster snapshots are returned. You can include shared DB cluster snapshots with these results by setting the IncludeShared parameter to true. You can include public DB cluster snapshots with these results by setting the IncludePublic parameter to true.

The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusterSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "IncludeShared":{ - "shape":"Boolean", - "documentation":"

True to include shared manual DB cluster snapshots from other AWS accounts that this AWS account has been given permission to copy or restore, and otherwise false. The default is false.

You can give an AWS account permission to restore a manual DB cluster snapshot from another AWS account by the ModifyDBClusterSnapshotAttribute API action.

" - }, - "IncludePublic":{ - "shape":"Boolean", - "documentation":"

True to include manual DB cluster snapshots that are public and can be copied or restored by any AWS account, and otherwise false. The default is false. The default is false.

You can share a manual DB cluster snapshot as public by using the ModifyDBClusterSnapshotAttribute API action.

" - } - }, - "documentation":"

" - }, - "DescribeDBClustersMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied DB cluster identifier. If this parameter is specified, information from only the specific DB cluster is returned. This parameter isn't case-sensitive.

Constraints:

  • If supplied, must match an existing DBClusterIdentifier.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more DB clusters to describe.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB clusters identified by these ARNs.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBClusters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBEngineVersionsMessage":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The database engine to return.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The database engine version to return.

Example: 5.1.49

" - }, - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group family to return details for.

Constraints:

  • If supplied, must match an existing DBParameterGroupFamily.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "DefaultOnly":{ - "shape":"Boolean", - "documentation":"

Indicates that only the default version of the specified engine or engine and major version combination is returned.

" - }, - "ListSupportedCharacterSets":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is specified and the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.

" - }, - "ListSupportedTimezones":{ - "shape":"BooleanOptional", - "documentation":"

If this parameter is specified and the requested engine supports the TimeZone parameter for CreateDBInstance, the response includes a list of supported time zones for each engine version.

" - } - } - }, - "DescribeDBInstancesMessage":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case-sensitive.

Constraints:

  • If supplied, must match the identifier of an existing DBInstance.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more DB instances to describe.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB instances associated with the DB clusters identified by these ARNs.

  • db-instance-id - Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs). The results list will only include information about the DB instances identified by these ARNs.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBLogFilesDetails":{ - "type":"structure", - "members":{ - "LogFileName":{ - "shape":"String", - "documentation":"

The name of the log file for the specified DB instance.

" - }, - "LastWritten":{ - "shape":"Long", - "documentation":"

A POSIX timestamp when the last log entry was written.

" - }, - "Size":{ - "shape":"Long", - "documentation":"

The size, in bytes, of the log file for the specified DB instance.

" - } - }, - "documentation":"

This data type is used as a response element to DescribeDBLogFiles.

" - }, - "DescribeDBLogFilesList":{ - "type":"list", - "member":{ - "shape":"DescribeDBLogFilesDetails", - "locationName":"DescribeDBLogFilesDetails" - } - }, - "DescribeDBLogFilesMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the DB instance that contains the log files you want to list.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "FilenameContains":{ - "shape":"String", - "documentation":"

Filters the available log files for log file names that contain the specified string.

" - }, - "FileLastWritten":{ - "shape":"Long", - "documentation":"

Filters the available log files for files written since the specified date, in POSIX timestamp format with milliseconds.

" - }, - "FileSize":{ - "shape":"Long", - "documentation":"

Filters the available log files for files larger than the specified size.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBLogFilesResponse":{ - "type":"structure", - "members":{ - "DescribeDBLogFiles":{ - "shape":"DescribeDBLogFilesList", - "documentation":"

The DB log files returned.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeDBLogFiles request.

" - } - }, - "documentation":"

The response from a call to DescribeDBLogFiles.

" - }, - "DescribeDBParameterGroupsMessage":{ - "type":"structure", - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific DB parameter group to return details for.

Constraints:

  • If supplied, must match the name of an existing DBParameterGroup.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return.

Default: All parameter types returned

Valid Values: user | system | engine-default

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - } - }, - "DescribeDBSecurityGroupsMessage":{ - "type":"structure", - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to return details for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSecurityGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeDBSnapshotAttributesMessage":{ - "type":"structure", - "required":["DBSnapshotIdentifier"], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot to describe the attributes for.

" - } - }, - "documentation":"

" - }, - "DescribeDBSnapshotAttributesResult":{ - "type":"structure", - "members":{ - "DBSnapshotAttributesResult":{"shape":"DBSnapshotAttributesResult"} - } - }, - "DescribeDBSnapshotsMessage":{ - "type":"structure", - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The ID of the DB instance to retrieve the list of DB snapshots for. This parameter can't be used in conjunction with DBSnapshotIdentifier. This parameter is not case-sensitive.

Constraints:

  • If supplied, must match the identifier of an existing DBInstance.

" - }, - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

A specific DB snapshot identifier to describe. This parameter can't be used in conjunction with DBInstanceIdentifier. This value is stored as a lowercase string.

Constraints:

  • If supplied, must match the identifier of an existing DBSnapshot.

  • If this identifier is for an automated snapshot, the SnapshotType parameter must also be specified.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The type of snapshots to be returned. You can specify one of the following values:

  • automated - Return all DB snapshots that have been automatically taken by Amazon RDS for my AWS account.

  • manual - Return all DB snapshots that have been taken by my AWS account.

  • shared - Return all manual DB snapshots that have been shared to my AWS account.

  • public - Return all DB snapshots that have been marked as public.

If you don't specify a SnapshotType value, then both automated and manual snapshots are returned. Shared and public DB snapshots are not included in the returned results by default. You can include shared snapshots with these results by setting the IncludeShared parameter to true. You can include public snapshots with these results by setting the IncludePublic parameter to true.

The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSnapshots request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "IncludeShared":{ - "shape":"Boolean", - "documentation":"

True to include shared manual DB snapshots from other AWS accounts that this AWS account has been given permission to copy or restore, and otherwise false. The default is false.

You can give an AWS account permission to restore a manual DB snapshot from another AWS account by using the ModifyDBSnapshotAttribute API action.

" - }, - "IncludePublic":{ - "shape":"Boolean", - "documentation":"

True to include manual DB snapshots that are public and can be copied or restored by any AWS account, and otherwise false. The default is false.

You can share a manual DB snapshot as public by using the ModifyDBSnapshotAttribute API.

" - } - }, - "documentation":"

" - }, - "DescribeDBSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group to return details for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeDBSubnetGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultClusterParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupFamily"], - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group family to return engine parameter information for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEngineDefaultClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultClusterParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "DescribeEngineDefaultParametersMessage":{ - "type":"structure", - "required":["DBParameterGroupFamily"], - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the DB parameter group family.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEngineDefaultParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeEngineDefaultParametersResult":{ - "type":"structure", - "members":{ - "EngineDefaults":{"shape":"EngineDefaults"} - } - }, - "DescribeEventCategoriesMessage":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to describe.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response.

Constraints:

  • If SourceIdentifier is supplied, SourceType must also be provided.

  • If the source type is DBInstance, then a DBInstanceIdentifier must be supplied.

  • If the source type is DBSecurityGroup, a DBSecurityGroupName must be supplied.

  • If the source type is DBParameterGroup, a DBParameterGroupName must be supplied.

  • If the source type is DBSnapshot, a DBSnapshotIdentifier must be supplied.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes to retrieve events for.

Default: 60

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories that trigger notifications for a event notification subscription.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOptionGroupOptionsMessage":{ - "type":"structure", - "required":["EngineName"], - "members":{ - "EngineName":{ - "shape":"String", - "documentation":"

A required parameter. Options available for the given engine name are described.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

If specified, filters the results to include only options for the specified major engine version.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeOptionGroupsMessage":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to describe. Cannot be supplied together with EngineName or MajorEngineVersion.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOptionGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Filters the list of option groups to only include groups associated with a specific database engine.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Filters the list of option groups to only include groups associated with a specific database engine version. If specified, then EngineName must also be specified.

" - } - }, - "documentation":"

" - }, - "DescribeOrderableDBInstanceOptionsMessage":{ - "type":"structure", - "required":["Engine"], - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the engine to retrieve DB instance options for.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.

" - }, - "Vpc":{ - "shape":"BooleanOptional", - "documentation":"

The VPC filter value. Specify this parameter to show only the available VPC or non-VPC offerings.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

" - }, - "DescribePendingMaintenanceActionsMessage":{ - "type":"structure", - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The ARN of a resource to return pending maintenance actions for.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

A filter that specifies one or more resources to return pending maintenance actions for.

Supported filters:

  • db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include pending maintenance actions for the DB clusters identified by these ARNs.

  • db-instance-id - Accepts DB instance identifiers and DB instance ARNs. The results list will only include pending maintenance actions for the DB instances identified by these ARNs.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribePendingMaintenanceActions request. If this parameter is specified, the response includes only records beyond the marker, up to a number of records specified by MaxRecords.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - } - }, - "documentation":"

" - }, - "DescribeReservedDBInstancesMessage":{ - "type":"structure", - "members":{ - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

The reserved DB instance identifier filter value. Specify this parameter to show only the reservation that matches the specified reservation ID.

" - }, - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Specify this parameter to show only purchased reservations matching the specified offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only those reservations matching the specified DB instances class.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

The duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The product description filter value. Specify this parameter to show only those reservations matching the specified product description.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Partial Upfront\" | \"All Upfront\" | \"No Upfront\"

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

The Multi-AZ filter value. Specify this parameter to show only those reservations matching the specified Multi-AZ parameter.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeReservedDBInstancesOfferingsMessage":{ - "type":"structure", - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier filter value. Specify this parameter to show only the available offering that matches the specified reservation identifier.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

" - }, - "Duration":{ - "shape":"String", - "documentation":"

Duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.

Valid Values: 1 | 3 | 31536000 | 94608000

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

Product description filter value. Specify this parameter to show only the available offerings that contain the specified product description.

The results show offerings that partially match the filter value.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.

Valid Values: \"Partial Upfront\" | \"All Upfront\" | \"No Upfront\"

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

The Multi-AZ filter value. Specify this parameter to show only the available offerings matching the specified Multi-AZ parameter.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "DescribeSourceRegionsMessage":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The source AWS Region name. For example, us-east-1.

Constraints:

  • Must specify a valid AWS Region name.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeSourceRegions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "DescribeValidDBInstanceModificationsMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer identifier or the ARN of your DB instance.

" - } - }, - "documentation":"

" - }, - "DescribeValidDBInstanceModificationsResult":{ - "type":"structure", - "members":{ - "ValidDBInstanceModificationsMessage":{"shape":"ValidDBInstanceModificationsMessage"} - } - }, - "DomainMembership":{ - "type":"structure", - "members":{ - "Domain":{ - "shape":"String", - "documentation":"

The identifier of the Active Directory Domain.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB instance's Active Directory Domain membership, such as joined, pending-join, failed etc).

" - }, - "FQDN":{ - "shape":"String", - "documentation":"

The fully qualified domain name of the Active Directory Domain.

" - }, - "IAMRoleName":{ - "shape":"String", - "documentation":"

The name of the IAM role to be used when making API calls to the Directory Service.

" - } - }, - "documentation":"

An Active Directory Domain membership record associated with the DB instance.

" - }, - "DomainMembershipList":{ - "type":"list", - "member":{ - "shape":"DomainMembership", - "locationName":"DomainMembership" - }, - "documentation":"

List of Active Directory Domain membership records associated with a DB instance.

" - }, - "DomainNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Domain doesn't refer to an existing Active Directory domain.

", - "error":{ - "code":"DomainNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "Double":{"type":"double"}, - "DoubleOptional":{"type":"double"}, - "DoubleRange":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Double", - "documentation":"

The minimum value in the range.

" - }, - "To":{ - "shape":"Double", - "documentation":"

The maximum value in the range.

" - } - }, - "documentation":"

A range of double values.

" - }, - "DoubleRangeList":{ - "type":"list", - "member":{ - "shape":"DoubleRange", - "locationName":"DoubleRange" - } - }, - "DownloadDBLogFilePortionDetails":{ - "type":"structure", - "members":{ - "LogFileData":{ - "shape":"String", - "documentation":"

Entries from the specified log file.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DownloadDBLogFilePortion request.

" - }, - "AdditionalDataPending":{ - "shape":"Boolean", - "documentation":"

Boolean value that if true, indicates there is more data to be downloaded.

" - } - }, - "documentation":"

This data type is used as a response element to DownloadDBLogFilePortion.

" - }, - "DownloadDBLogFilePortionMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "LogFileName" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The customer-assigned name of the DB instance that contains the log files you want to list.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "LogFileName":{ - "shape":"String", - "documentation":"

The name of the log file to be downloaded.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

The pagination token provided in the previous request or \"0\". If the Marker parameter is specified the response includes only records beyond the marker until the end of the file or up to NumberOfLines.

" - }, - "NumberOfLines":{ - "shape":"Integer", - "documentation":"

The number of lines to download. If the number of lines specified results in a file over 1 MB in size, the file is truncated at 1 MB in size.

If the NumberOfLines parameter is specified, then the block of lines returned can be from the beginning or the end of the log file, depending on the value of the Marker parameter.

  • If neither Marker or NumberOfLines are specified, the entire log file is returned up to a maximum of 10000 lines, starting with the most recent log entries first.

  • If NumberOfLines is specified and Marker is not specified, then the most recent lines from the end of the log file are returned.

  • If Marker is specified as \"0\", then the specified number of lines from the beginning of the log file are returned.

  • You can download the log file in blocks of lines by specifying the size of the block using the NumberOfLines parameter, and by specifying a value of \"0\" for the Marker parameter in your first request. Include the Marker value returned in the response as the Marker value for the next request, continuing until the AdditionalDataPending response element returns false.

" - } - }, - "documentation":"

" - }, - "EC2SecurityGroup":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

Provides the status of the EC2 security group. Status can be \"authorizing\", \"authorized\", \"revoking\", and \"revoked\".

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the EC2 security group.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

Specifies the id of the EC2 security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

Specifies the AWS ID of the owner of the EC2 security group specified in the EC2SecurityGroupName field.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "EC2SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"EC2SecurityGroup", - "locationName":"EC2SecurityGroup" - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

Specifies the DNS address of the DB instance.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

Specifies the port that the database engine is listening on.

" - }, - "HostedZoneId":{ - "shape":"String", - "documentation":"

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

" - } - }, - "documentation":"

This data type is used as a response element in the following actions:

" - }, - "EngineDefaults":{ - "type":"structure", - "members":{ - "DBParameterGroupFamily":{ - "shape":"String", - "documentation":"

Specifies the name of the DB parameter group family that the engine default parameters apply to.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous EngineDefaults request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

Contains a list of engine default parameters.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeEngineDefaultParameters action.

", - "wrapper":true - }, - "EngineModeList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

Provides the identifier for the source of the event.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

Specifies the source type for this event.

" - }, - "Message":{ - "shape":"String", - "documentation":"

Provides the text of this event.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

Specifies the category for the event.

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

Specifies the date and time of the event.

" - }, - "SourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the event.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeEvents action.

" - }, - "EventCategoriesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"EventCategory" - } - }, - "EventCategoriesMap":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The source type that the returned categories belong to

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

The event categories for the specified source type

" - } - }, - "documentation":"

Contains the results of a successful invocation of the DescribeEventCategories action.

", - "wrapper":true - }, - "EventCategoriesMapList":{ - "type":"list", - "member":{ - "shape":"EventCategoriesMap", - "locationName":"EventCategoriesMap" - } - }, - "EventCategoriesMessage":{ - "type":"structure", - "members":{ - "EventCategoriesMapList":{ - "shape":"EventCategoriesMapList", - "documentation":"

A list of EventCategoriesMap data types.

" - } - }, - "documentation":"

Data returned from the DescribeEventCategories action.

" - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventSubscription":{ - "type":"structure", - "members":{ - "CustomerAwsId":{ - "shape":"String", - "documentation":"

The AWS customer account associated with the RDS event notification subscription.

" - }, - "CustSubscriptionId":{ - "shape":"String", - "documentation":"

The RDS event notification subscription Id.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The topic ARN of the RDS event notification subscription.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the RDS event notification subscription.

Constraints:

Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist

The status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.

" - }, - "SubscriptionCreationTime":{ - "shape":"String", - "documentation":"

The time the RDS event notification subscription was created.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The source type for the RDS event notification subscription.

" - }, - "SourceIdsList":{ - "shape":"SourceIdsList", - "documentation":"

A list of source IDs for the RDS event notification subscription.

" - }, - "EventCategoriesList":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for the RDS event notification subscription.

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

A Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.

" - }, - "EventSubscriptionArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the event subscription.

" - } - }, - "documentation":"

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

", - "wrapper":true - }, - "EventSubscriptionQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have reached the maximum number of event subscriptions.

", - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EventSubscriptionsList":{ - "type":"list", - "member":{ - "shape":"EventSubscription", - "locationName":"EventSubscription" - } - }, - "EventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "EventSubscriptionsList":{ - "shape":"EventSubscriptionsList", - "documentation":"

A list of EventSubscriptions data types.

" - } - }, - "documentation":"

Data returned by the DescribeEventSubscriptions action.

" - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous Events request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of Event instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeEvents action.

" - }, - "FailoverDBClusterMessage":{ - "type":"structure", - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

A DB cluster identifier to force a failover for. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "TargetDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The name of the instance to promote to the primary instance.

You must specify the instance identifier for an Aurora Replica in the DB cluster. For example, mydbcluster-replica1.

" - } - }, - "documentation":"

" - }, - "FailoverDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "Filter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"FilterValueList", - "documentation":"

One or more filter values. Filter values are case-sensitive.

" - } - }, - "documentation":"

A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as IDs. The filters supported by a describe operation are documented with the describe operation.

Currently, wildcards are not supported in filters.

The following actions can be filtered:

" - }, - "FilterList":{ - "type":"list", - "member":{ - "shape":"Filter", - "locationName":"Filter" - } - }, - "FilterValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"Value" - } - }, - "IPRange":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

Specifies the status of the IP range. Status can be \"authorizing\", \"authorized\", \"revoking\", and \"revoked\".

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

Specifies the IP range.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBSecurityGroups action.

" - }, - "IPRangeList":{ - "type":"list", - "member":{ - "shape":"IPRange", - "locationName":"IPRange" - } - }, - "InstanceQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of DB instances.

", - "error":{ - "code":"InstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientDBClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB cluster doesn't have enough capacity for the current operation.

", - "error":{ - "code":"InsufficientDBClusterCapacityFault", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "InsufficientDBInstanceCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified DB instance class isn't available in the specified Availability Zone.

", - "error":{ - "code":"InsufficientDBInstanceCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientStorageClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.

", - "error":{ - "code":"InsufficientStorageClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidDBClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Capacity isn't a valid Aurora Serverless DB cluster capacity. Valid capacity values are 2, 4, 8, 16, 32, 64, 128, and 256.

", - "error":{ - "code":"InvalidDBClusterCapacityFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBClusterSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The supplied value isn't a valid DB cluster snapshot state.

", - "error":{ - "code":"InvalidDBClusterSnapshotStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBClusterStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB cluster isn't in a valid state.

", - "error":{ - "code":"InvalidDBClusterStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBInstanceStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified DB instance isn't in the available state.

", - "error":{ - "code":"InvalidDBInstanceState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.

", - "error":{ - "code":"InvalidDBParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the DB security group doesn't allow deletion.

", - "error":{ - "code":"InvalidDBSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the DB snapshot doesn't allow deletion.

", - "error":{ - "code":"InvalidDBSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSubnetGroupFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.

", - "error":{ - "code":"InvalidDBSubnetGroupFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSubnetGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet group cannot be deleted because it's in use.

", - "error":{ - "code":"InvalidDBSubnetGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidDBSubnetStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet isn't in the available state.

", - "error":{ - "code":"InvalidDBSubnetStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidEventSubscriptionStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

This error can occur if someone else is modifying a subscription. You should retry the action.

", - "error":{ - "code":"InvalidEventSubscriptionState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidOptionGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The option group isn't in the available state.

", - "error":{ - "code":"InvalidOptionGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidRestoreFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cannot restore from VPC backup to non-VPC DB instance.

", - "error":{ - "code":"InvalidRestoreFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidS3BucketFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.

", - "error":{ - "code":"InvalidS3BucketFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KMSKeyNotAccessibleFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

An error occurred accessing an AWS KMS key.

", - "error":{ - "code":"KMSKeyNotAccessibleFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "KeyList":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListTagsForResourceMessage":{ - "type":"structure", - "required":["ResourceName"], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource with tags to be listed. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "Filters":{ - "shape":"FilterList", - "documentation":"

This parameter is not currently supported.

" - } - }, - "documentation":"

" - }, - "LogTypeList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Long":{"type":"long"}, - "LongOptional":{"type":"long"}, - "ModifyCurrentDBClusterCapacityMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier for the cluster being modified. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DB cluster.

" - }, - "Capacity":{ - "shape":"IntegerOptional", - "documentation":"

The DB cluster capacity.

Constraints:

  • Value must be 2, 4, 8, 16, 32, 64, 128, or 256.

" - }, - "SecondsBeforeTimeout":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in seconds, that Aurora Serverless tries to find a scaling point to perform seamless scaling before enforcing the timeout action. The default is 300.

  • Value must be from 10 through 600.

" - }, - "TimeoutAction":{ - "shape":"String", - "documentation":"

The action to take when the timeout is reached, either ForceApplyCapacityChange or RollbackCapacityChange.

ForceApplyCapacityChange, the default, sets the capacity to the specified value as soon as possible.

RollbackCapacityChange ignores the capacity change if a scaling point is not found in the timeout period.

" - } - } - }, - "ModifyDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The DB cluster identifier for the cluster being modified. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "NewDBClusterIdentifier":{ - "shape":"String", - "documentation":"

The new DB cluster identifier for the DB cluster when renaming a DB cluster. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • The first character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-cluster2

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

A value that specifies whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the PreferredMaintenanceWindow setting for the DB cluster. If this parameter is set to false, changes to the DB cluster are applied during the next maintenance window.

The ApplyImmediately parameter only affects the NewDBClusterIdentifier and MasterUserPassword values. If you set the ApplyImmediately parameter value to false, then changes to the NewDBClusterIdentifier and MasterUserPassword values are applied during the next maintenance window. All other changes are applied immediately, regardless of the value of the ApplyImmediately parameter.

Default: false

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

" - }, - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to use for the DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the DB cluster will belong to.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

A value that indicates that the DB cluster should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case, and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

" - }, - "CloudwatchLogsExportConfiguration":{ - "shape":"CloudwatchLogsExportConfiguration", - "documentation":"

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB cluster.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to which you want to upgrade. Changing this parameter results in an outage. The change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true.

For a list of valid engine versions, see CreateDBCluster, or call DescribeDBEngineVersions.

" - }, - "ScalingConfiguration":{ - "shape":"ScalingConfiguration", - "documentation":"

The scaling properties of the DB cluster. You can only modify scaling properties for DB clusters in serverless DB engine mode.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBClusterParameterGroupName", - "Parameters" - ], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to modify.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of parameters in the DB cluster parameter group to modify.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "ModifyDBClusterSnapshotAttributeMessage":{ - "type":"structure", - "required":[ - "DBClusterSnapshotIdentifier", - "AttributeName" - ], - "members":{ - "DBClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB cluster snapshot to modify the attributes for.

" - }, - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the DB cluster snapshot attribute to modify.

To manage authorization for other AWS accounts to copy or restore a manual DB cluster snapshot, set this value to restore.

" - }, - "ValuesToAdd":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB cluster snapshot attributes to add to the attribute specified by AttributeName.

To authorize other AWS accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more AWS account IDs, or all to make the manual DB cluster snapshot restorable by any AWS account. Do not add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts.

" - }, - "ValuesToRemove":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB cluster snapshot attributes to remove from the attribute specified by AttributeName.

To remove authorization for other AWS accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more AWS account identifiers, or all to remove authorization for any AWS account to copy or restore the DB cluster snapshot. If you specify all, an AWS account whose account ID is explicitly added to the restore attribute can still copy or restore a manual DB cluster snapshot.

" - } - }, - "documentation":"

" - }, - "ModifyDBClusterSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "DBClusterSnapshotAttributesResult":{"shape":"DBClusterSnapshotAttributesResult"} - } - }, - "ModifyDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The new amount of storage (in gibibytes) to allocate for the DB instance.

For MariaDB, MySQL, Oracle, and PostgreSQL, the value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

For the valid values for allocated storage for each engine, see CreateDBInstance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The new compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

If you modify the DB instance class, an outage occurs during the change. The change is applied during the next maintenance window, unless ApplyImmediately is specified as true for this request.

Default: Uses existing setting

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The new DB subnet group for the DB instance. You can use this parameter to move your DB instance to a different VPC. If your DB instance is not in a VPC, you can also use this parameter to move your DB instance into a VPC. For more information, see Updating the VPC for a DB Instance.

Changing the subnet group causes an outage during the change. The change is applied during the next maintenance window, unless you specify true for the ApplyImmediately parameter.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetGroup

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to authorize on this DB instance. Changing this setting doesn't result in an outage and the change is asynchronously applied as soon as possible.

Constraints:

  • If supplied, must match existing DBSecurityGroups.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to authorize on this DB instance. This change is asynchronously applied as soon as possible.

Amazon Aurora

Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. For more information, see ModifyDBCluster.

Constraints:

  • If supplied, must match existing VpcSecurityGroupIds.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Specifies whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the PreferredMaintenanceWindow setting for the DB instance.

If this parameter is set to false, changes to the DB instance are applied during the next maintenance window. Some parameter changes can cause an outage and are applied on the next call to RebootDBInstance, or the next failure reboot. Review the table of parameters in Modifying a DB Instance and Using the Apply Immediately Parameter to see the impact that setting ApplyImmediately to true or false has for each modified parameter and to determine when the changes are applied.

Default: false

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible. Between the time of the request and the completion of the request, the MasterUserPassword element exists in the PendingModifiedValues element of the operation response.

Amazon Aurora

Not applicable. The password for the master user is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: Uses existing setting

MariaDB

Constraints: Must contain from 8 to 41 characters.

Microsoft SQL Server

Constraints: Must contain from 8 to 128 characters.

MySQL

Constraints: Must contain from 8 to 41 characters.

Oracle

Constraints: Must contain from 8 to 30 characters.

PostgreSQL

Constraints: Must contain from 8 to 128 characters.

Amazon RDS API actions never return the password, so this action provides a way to regain access to a primary instance user if the password is lost. This includes restoring privileges that might have been accidentally revoked.

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to apply to the DB instance. Changing this setting doesn't result in an outage. The parameter group name itself is changed immediately, but the actual parameter changes are not applied until you reboot the instance without failover. The db instance will NOT be rebooted automatically and the parameter changes will NOT be applied during the next maintenance window.

Default: Uses existing setting

Constraints: The DB parameter group must be in the same DB parameter group family as this DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Changing this parameter can result in an outage if you change from 0 to a non-zero value or from a non-zero value to 0. These changes are applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you change the parameter from one non-zero value to another non-zero value, the change is asynchronously applied as soon as possible.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: Uses existing setting

Constraints:

  • Must be a value from 0 to 35

  • Can be specified for a MySQL Read Replica only if the source is running MySQL 5.6

  • Can be specified for a PostgreSQL Read Replica only if the source is running PostgreSQL 9.3.5

  • Cannot be set to 0 if the DB instance is a source to Read Replicas

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod parameter. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible.

Amazon Aurora

Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Constraints:

  • Must be in the format hh24:mi-hh24:mi

  • Must be in Universal Time Coordinated (UTC)

  • Must not conflict with the preferred maintenance window

  • Must be at least 30 minutes

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur, which might result in an outage. Changing this parameter doesn't result in an outage, except in the following situation, and the change is asynchronously applied as soon as possible. If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, then changing this parameter will cause a reboot of the DB instance. If moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure pending changes are applied.

Default: Uses existing setting

Format: ddd:hh24:mi-ddd:hh24:mi

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Must be at least 30 minutes

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment. Changing this parameter doesn't result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

For major version upgrades, if a nondefault DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.

For information about valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.

" - }, - "AllowMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

Indicates that major version upgrades are allowed. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible.

Constraints: This parameter must be set to true when specifying a value for the EngineVersion parameter that is a different major version than the DB instance's current version.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades are applied automatically to the DB instance during the maintenance window. Changing this parameter doesn't result in an outage except in the following case and the change is asynchronously applied as soon as possible. An outage will result if this parameter is set to true during the maintenance window, and a newer minor version is available, and RDS has enabled auto patching for that engine version.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for the DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The new Provisioned IOPS (I/O operations per second) value for the RDS instance.

Changing this setting doesn't result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you are migrating from Provisioned IOPS to standard storage, set this value to 0. The DB instance will require a reboot for the change in storage type to take effect.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance is available for use, but might experience performance degradation. While the migration takes place, nightly backups for the instance are suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a Read Replica for the instance, and creating a DB snapshot of the instance.

Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL, the value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

Default: Uses existing setting

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

Indicates that the DB instance should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "NewDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot will occur immediately if you set Apply Immediately to true, or will occur during the next maintenance window if Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • The first character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

If you specify Provisioned IOPS (io1), you must also include a value for the Iops parameter.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance is available for use, but might experience performance degradation. While the migration takes place, nightly backups for the instance are suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a Read Replica for the instance, and creating a DB snapshot of the instance.

Valid values: standard | gp2 | io1

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

Indicates the certificate that needs to be associated with the instance.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

The Active Directory Domain to move the instance to. Specify none to remove the instance from its current domain. The domain must be created prior to this operation. Currently only a Microsoft SQL Server instance can be created in a Active Directory Domain.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

" - }, - "DBPortNumber":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

The value of the DBPortNumber parameter must not match any of the port values specified for options in the option group for the DB instance.

Your database will restart when you change the DBPortNumber value regardless of the value of the ApplyImmediately parameter.

MySQL

Default: 3306

Valid Values: 1150-65535

MariaDB

Default: 3306

Valid Values: 1150-65535

PostgreSQL

Default: 5432

Valid Values: 1150-65535

Type: Integer

Oracle

Default: 1521

Valid Values: 1150-65535

SQL Server

Default: 1433

Valid Values: 1150-65535 except for 1434, 3389, 47001, 49152, and 49152 through 49156.

Amazon Aurora

Default: 3306

Valid Values: 1150-65535

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Boolean value that indicates if the DB instance has a publicly resolvable DNS name. Set to True to make the DB instance Internet-facing with a publicly resolvable DNS name, which resolves to a public IP address. Set to False to make the DB instance internal with a DNS name that resolves to a private IP address.

PubliclyAccessible only applies to DB instances in a VPC. The DB instance must be part of a public subnet and PubliclyAccessible must be true in order for it to be publicly accessible.

Changes to the PubliclyAccessible parameter are applied immediately regardless of the value of the ApplyImmediately parameter.

Default: false

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess. For information on creating a monitoring role, go to To create an IAM role for Amazon RDS Enhanced Monitoring.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

The name of the IAM role to use when making API calls to the Directory Service.

" - }, - "PromotionTier":{ - "shape":"IntegerOptional", - "documentation":"

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance. For more information, see Fault Tolerance for an Aurora DB Cluster.

Default: 1

Valid Values: 0 - 15

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines

Amazon Aurora

Not applicable. Mapping AWS IAM accounts to database accounts is managed by the DB cluster. For more information, see ModifyDBCluster.

MySQL

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

Default: false

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the DB instance, and otherwise false.

For more information, see Using Amazon Performance Insights in the Amazon Relational Database Service User Guide.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "PerformanceInsightsRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

" - }, - "CloudwatchLogsExportConfiguration":{ - "shape":"CloudwatchLogsExportConfiguration", - "documentation":"

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - }, - "UseDefaultProcessorFeatures":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies that the DB instance class of the DB instance uses its default processor features.

" - } - }, - "documentation":"

" - }, - "ModifyDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "ModifyDBParameterGroupMessage":{ - "type":"structure", - "required":[ - "DBParameterGroupName", - "Parameters" - ], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • If supplied, must match the name of an existing DBParameterGroup.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters can be modified in a single request.

Valid Values (for the application method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when you reboot the DB instance without failover.

" - } - }, - "documentation":"

" - }, - "ModifyDBSnapshotAttributeMessage":{ - "type":"structure", - "required":[ - "DBSnapshotIdentifier", - "AttributeName" - ], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot to modify the attributes for.

" - }, - "AttributeName":{ - "shape":"String", - "documentation":"

The name of the DB snapshot attribute to modify.

To manage authorization for other AWS accounts to copy or restore a manual DB snapshot, set this value to restore.

" - }, - "ValuesToAdd":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB snapshot attributes to add to the attribute specified by AttributeName.

To authorize other AWS accounts to copy or restore a manual snapshot, set this list to include one or more AWS account IDs, or all to make the manual DB snapshot restorable by any AWS account. Do not add the all value for any manual DB snapshots that contain private information that you don't want available to all AWS accounts.

" - }, - "ValuesToRemove":{ - "shape":"AttributeValueList", - "documentation":"

A list of DB snapshot attributes to remove from the attribute specified by AttributeName.

To remove authorization for other AWS accounts to copy or restore a manual snapshot, set this list to include one or more AWS account identifiers, or all to remove authorization for any AWS account to copy or restore the DB snapshot. If you specify all, an AWS account whose account ID is explicitly added to the restore attribute can still copy or restore the manual DB snapshot.

" - } - }, - "documentation":"

" - }, - "ModifyDBSnapshotAttributeResult":{ - "type":"structure", - "members":{ - "DBSnapshotAttributesResult":{"shape":"DBSnapshotAttributesResult"} - } - }, - "ModifyDBSnapshotMessage":{ - "type":"structure", - "required":["DBSnapshotIdentifier"], - "members":{ - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB snapshot to modify.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version to upgrade the DB snapshot to.

The following are the database engines and engine versions that are available when you upgrade a DB snapshot.

MySQL

  • 5.5.46 (supported for 5.1 DB snapshots)

Oracle

  • 12.1.0.2.v8 (supported for 12.1.0.1 DB snapshots)

  • 11.2.0.4.v12 (supported for 11.2.0.2 DB snapshots)

  • 11.2.0.4.v11 (supported for 11.2.0.3 DB snapshots)

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The option group to identify with the upgraded DB snapshot.

You can specify this parameter when you upgrade an Oracle DB snapshot. The same option group considerations apply when upgrading a DB snapshot as when upgrading a DB instance. For more information, see Option Group Considerations.

" - } - } - }, - "ModifyDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBSnapshot":{"shape":"DBSnapshot"} - } - }, - "ModifyDBSubnetGroupMessage":{ - "type":"structure", - "required":[ - "DBSubnetGroupName", - "SubnetIds" - ], - "members":{ - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the DB subnet group. This value is stored as a lowercase string. You can't modify the default subnet group.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

" - }, - "DBSubnetGroupDescription":{ - "shape":"String", - "documentation":"

The description for the DB subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

The EC2 subnet IDs for the DB subnet group.

" - } - }, - "documentation":"

" - }, - "ModifyDBSubnetGroupResult":{ - "type":"structure", - "members":{ - "DBSubnetGroup":{"shape":"DBSubnetGroup"} - } - }, - "ModifyEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription.

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "ModifyOptionGroupMessage":{ - "type":"structure", - "required":["OptionGroupName"], - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be modified.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "OptionsToInclude":{ - "shape":"OptionConfigurationList", - "documentation":"

Options in this list are added to the option group or, if already present, the specified configuration is used to update the existing configuration.

" - }, - "OptionsToRemove":{ - "shape":"OptionNamesList", - "documentation":"

Options in this list are removed from the option group.

" - }, - "ApplyImmediately":{ - "shape":"Boolean", - "documentation":"

Indicates whether the changes should be applied immediately, or during the next maintenance window for each instance associated with the option group.

" - } - }, - "documentation":"

" - }, - "ModifyOptionGroupResult":{ - "type":"structure", - "members":{ - "OptionGroup":{"shape":"OptionGroup"} - } - }, - "Option":{ - "type":"structure", - "members":{ - "OptionName":{ - "shape":"String", - "documentation":"

The name of the option.

" - }, - "OptionDescription":{ - "shape":"String", - "documentation":"

The description of the option.

" - }, - "Persistent":{ - "shape":"Boolean", - "documentation":"

Indicate if this option is persistent.

" - }, - "Permanent":{ - "shape":"Boolean", - "documentation":"

Indicate if this option is permanent.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

If required, the port configured for this option to use.

" - }, - "OptionVersion":{ - "shape":"String", - "documentation":"

The version of the option.

" - }, - "OptionSettings":{ - "shape":"OptionSettingConfigurationList", - "documentation":"

The option settings for this option.

" - }, - "DBSecurityGroupMemberships":{ - "shape":"DBSecurityGroupMembershipList", - "documentation":"

If the option requires access to a port, then this DB security group allows access to the port.

" - }, - "VpcSecurityGroupMemberships":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

If the option requires access to a port, then this VPC security group allows access to the port.

" - } - }, - "documentation":"

Option details.

" - }, - "OptionConfiguration":{ - "type":"structure", - "required":["OptionName"], - "members":{ - "OptionName":{ - "shape":"String", - "documentation":"

The configuration of options to include in a group.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The optional port for the option.

" - }, - "OptionVersion":{ - "shape":"String", - "documentation":"

The version for the option.

" - }, - "DBSecurityGroupMemberships":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DBSecurityGroupMemebrship name strings used for this option.

" - }, - "VpcSecurityGroupMemberships":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VpcSecurityGroupMemebrship name strings used for this option.

" - }, - "OptionSettings":{ - "shape":"OptionSettingsList", - "documentation":"

The option settings to include in an option group.

" - } - }, - "documentation":"

A list of all available options

" - }, - "OptionConfigurationList":{ - "type":"list", - "member":{ - "shape":"OptionConfiguration", - "locationName":"OptionConfiguration" - } - }, - "OptionGroup":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

Specifies the name of the option group.

" - }, - "OptionGroupDescription":{ - "shape":"String", - "documentation":"

Provides a description of the option group.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

Indicates the name of the engine that this option group can be applied to.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Indicates the major engine version associated with this option group.

" - }, - "Options":{ - "shape":"OptionsList", - "documentation":"

Indicates what options are available in the option group.

" - }, - "AllowsVpcAndNonVpcInstanceMemberships":{ - "shape":"Boolean", - "documentation":"

Indicates whether this option group can be applied to both VPC and non-VPC instances. The value true indicates the option group can be applied to both VPC and non-VPC instances.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

If AllowsVpcAndNonVpcInstanceMemberships is false, this field is blank. If AllowsVpcAndNonVpcInstanceMemberships is true and this field is blank, then this option group can be applied to both VPC and non-VPC instances. If this field contains a value, then this option group can only be applied to instances that are in the VPC indicated by this field.

" - }, - "OptionGroupArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the option group.

" - } - }, - "documentation":"

", - "wrapper":true - }, - "OptionGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The option group you are trying to create already exists.

", - "error":{ - "code":"OptionGroupAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "OptionGroupMembership":{ - "type":"structure", - "members":{ - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group that the instance belongs to.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the DB instance's option group membership. Valid values are: in-sync, pending-apply, pending-removal, pending-maintenance-apply, pending-maintenance-removal, applying, removing, and failed.

" - } - }, - "documentation":"

Provides information on the option groups the DB instance is a member of.

" - }, - "OptionGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"OptionGroupMembership", - "locationName":"OptionGroupMembership" - } - }, - "OptionGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified option group could not be found.

", - "error":{ - "code":"OptionGroupNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "OptionGroupOption":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the option.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the option.

" - }, - "EngineName":{ - "shape":"String", - "documentation":"

The name of the engine that this option can be applied to.

" - }, - "MajorEngineVersion":{ - "shape":"String", - "documentation":"

Indicates the major engine version that the option is available for.

" - }, - "MinimumRequiredMinorEngineVersion":{ - "shape":"String", - "documentation":"

The minimum required engine version for the option to be applied.

" - }, - "PortRequired":{ - "shape":"Boolean", - "documentation":"

Specifies whether the option requires a port.

" - }, - "DefaultPort":{ - "shape":"IntegerOptional", - "documentation":"

If the option requires a port, specifies the default port for the option.

" - }, - "OptionsDependedOn":{ - "shape":"OptionsDependedOn", - "documentation":"

The options that are prerequisites for this option.

" - }, - "OptionsConflictsWith":{ - "shape":"OptionsConflictsWith", - "documentation":"

The options that conflict with this option.

" - }, - "Persistent":{ - "shape":"Boolean", - "documentation":"

Persistent options can't be removed from an option group while DB instances are associated with the option group. If you disassociate all DB instances from the option group, your can remove the persistent option from the option group.

" - }, - "Permanent":{ - "shape":"Boolean", - "documentation":"

Permanent options can never be removed from an option group. An option group containing a permanent option can't be removed from a DB instance.

" - }, - "RequiresAutoMinorEngineVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

If true, you must enable the Auto Minor Version Upgrade setting for your DB instance before you can use this option. You can enable Auto Minor Version Upgrade when you first create your DB instance, or by modifying your DB instance later.

" - }, - "VpcOnly":{ - "shape":"Boolean", - "documentation":"

If true, you can only use this option with a DB instance that is in a VPC.

" - }, - "SupportsOptionVersionDowngrade":{ - "shape":"BooleanOptional", - "documentation":"

If true, you can change the option to an earlier version of the option. This only applies to options that have different versions available.

" - }, - "OptionGroupOptionSettings":{ - "shape":"OptionGroupOptionSettingsList", - "documentation":"

The option settings that are available (and the default value) for each option in an option group.

" - }, - "OptionGroupOptionVersions":{ - "shape":"OptionGroupOptionVersionsList", - "documentation":"

The versions that are available for the option.

" - } - }, - "documentation":"

Available option.

" - }, - "OptionGroupOptionSetting":{ - "type":"structure", - "members":{ - "SettingName":{ - "shape":"String", - "documentation":"

The name of the option group option.

" - }, - "SettingDescription":{ - "shape":"String", - "documentation":"

The description of the option group option.

" - }, - "DefaultValue":{ - "shape":"String", - "documentation":"

The default value for the option group option.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

The DB engine specific parameter type for the option group option.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

Indicates the acceptable values for the option group option.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Boolean value where true indicates that this option group option can be changed from the default value.

" - } - }, - "documentation":"

Option group option settings are used to display settings available for each option with their default values and other information. These values are used with the DescribeOptionGroupOptions action.

" - }, - "OptionGroupOptionSettingsList":{ - "type":"list", - "member":{ - "shape":"OptionGroupOptionSetting", - "locationName":"OptionGroupOptionSetting" - } - }, - "OptionGroupOptionVersionsList":{ - "type":"list", - "member":{ - "shape":"OptionVersion", - "locationName":"OptionVersion" - } - }, - "OptionGroupOptionsList":{ - "type":"list", - "member":{ - "shape":"OptionGroupOption", - "locationName":"OptionGroupOption" - }, - "documentation":"

List of available option group options.

" - }, - "OptionGroupOptionsMessage":{ - "type":"structure", - "members":{ - "OptionGroupOptions":{"shape":"OptionGroupOptionsList"}, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

" - }, - "OptionGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota of 20 option groups was exceeded for this AWS account.

", - "error":{ - "code":"OptionGroupQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "OptionGroups":{ - "type":"structure", - "members":{ - "OptionGroupsList":{ - "shape":"OptionGroupsList", - "documentation":"

List of option groups.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - } - }, - "documentation":"

List of option groups.

" - }, - "OptionGroupsList":{ - "type":"list", - "member":{ - "shape":"OptionGroup", - "locationName":"OptionGroup" - } - }, - "OptionNamesList":{ - "type":"list", - "member":{"shape":"String"} - }, - "OptionSetting":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the option that has settings that you can set.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The current value of the option setting.

" - }, - "DefaultValue":{ - "shape":"String", - "documentation":"

The default value of the option setting.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the option setting.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

The DB engine specific parameter type.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The data type of the option setting.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The allowed values of the option setting.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

A Boolean value that, when true, indicates the option setting can be modified from the default.

" - }, - "IsCollection":{ - "shape":"Boolean", - "documentation":"

Indicates if the option setting is part of a collection.

" - } - }, - "documentation":"

Option settings are the actual settings being applied or configured for that option. It is used when you modify an option group or describe option groups. For example, the NATIVE_NETWORK_ENCRYPTION option has a setting called SQLNET.ENCRYPTION_SERVER that can have several different values.

" - }, - "OptionSettingConfigurationList":{ - "type":"list", - "member":{ - "shape":"OptionSetting", - "locationName":"OptionSetting" - } - }, - "OptionSettingsList":{ - "type":"list", - "member":{ - "shape":"OptionSetting", - "locationName":"OptionSetting" - } - }, - "OptionVersion":{ - "type":"structure", - "members":{ - "Version":{ - "shape":"String", - "documentation":"

The version of the option.

" - }, - "IsDefault":{ - "shape":"Boolean", - "documentation":"

True if the version is the default version of the option, and otherwise false.

" - } - }, - "documentation":"

The version for an option. Option group option versions are returned by the DescribeOptionGroupOptions action.

" - }, - "OptionsConflictsWith":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"OptionConflictName" - } - }, - "OptionsDependedOn":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"OptionName" - } - }, - "OptionsList":{ - "type":"list", - "member":{ - "shape":"Option", - "locationName":"Option" - } - }, - "OrderableDBInstanceOption":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The engine type of a DB instance.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The engine version of a DB instance.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for a DB instance.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for a DB instance.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

A list of Availability Zones for a DB instance.

" - }, - "MultiAZCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance is Multi-AZ capable.

" - }, - "ReadReplicaCapable":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance can have a Read Replica.

" - }, - "Vpc":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance is in a VPC.

" - }, - "SupportsStorageEncryption":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports encrypted storage.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Indicates the storage type for a DB instance.

" - }, - "SupportsIops":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports provisioned IOPS.

" - }, - "SupportsEnhancedMonitoring":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports Enhanced Monitoring at intervals from 1 to 60 seconds.

" - }, - "SupportsIAMDatabaseAuthentication":{ - "shape":"Boolean", - "documentation":"

Indicates whether a DB instance supports IAM database authentication.

" - }, - "SupportsPerformanceInsights":{ - "shape":"Boolean", - "documentation":"

True if a DB instance supports Performance Insights, otherwise false.

" - }, - "MinStorageSize":{ - "shape":"IntegerOptional", - "documentation":"

Minimum storage size for a DB instance.

" - }, - "MaxStorageSize":{ - "shape":"IntegerOptional", - "documentation":"

Maximum storage size for a DB instance.

" - }, - "MinIopsPerDbInstance":{ - "shape":"IntegerOptional", - "documentation":"

Minimum total provisioned IOPS for a DB instance.

" - }, - "MaxIopsPerDbInstance":{ - "shape":"IntegerOptional", - "documentation":"

Maximum total provisioned IOPS for a DB instance.

" - }, - "MinIopsPerGib":{ - "shape":"DoubleOptional", - "documentation":"

Minimum provisioned IOPS per GiB for a DB instance.

" - }, - "MaxIopsPerGib":{ - "shape":"DoubleOptional", - "documentation":"

Maximum provisioned IOPS per GiB for a DB instance.

" - }, - "AvailableProcessorFeatures":{ - "shape":"AvailableProcessorFeatureList", - "documentation":"

A list of the available processor features for the DB instance class of a DB instance.

" - }, - "SupportedEngineModes":{ - "shape":"EngineModeList", - "documentation":"

A list of the supported DB engine modes.

" - } - }, - "documentation":"

Contains a list of available options for a DB instance.

This data type is used as a response element in the DescribeOrderableDBInstanceOptions action.

", - "wrapper":true - }, - "OrderableDBInstanceOptionsList":{ - "type":"list", - "member":{ - "shape":"OrderableDBInstanceOption", - "locationName":"OrderableDBInstanceOption" - } - }, - "OrderableDBInstanceOptionsMessage":{ - "type":"structure", - "members":{ - "OrderableDBInstanceOptions":{ - "shape":"OrderableDBInstanceOptionsList", - "documentation":"

An OrderableDBInstanceOption structure containing information about orderable options for the DB instance.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous OrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeOrderableDBInstanceOptions action.

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

Specifies the name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

Specifies the value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Provides a description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

Indicates the source of the parameter value.

" - }, - "ApplyType":{ - "shape":"String", - "documentation":"

Specifies the engine specific parameters type.

" - }, - "DataType":{ - "shape":"String", - "documentation":"

Specifies the valid data type for the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

Specifies the valid range of values for the parameter.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

Indicates whether (true) or not (false) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest engine version to which the parameter can apply.

" - }, - "ApplyMethod":{ - "shape":"ApplyMethod", - "documentation":"

Indicates when to apply parameter updates.

" - }, - "SupportedEngineModes":{ - "shape":"EngineModeList", - "documentation":"

The valid DB engine modes.

" - } - }, - "documentation":"

This data type is used as a request parameter in the ModifyDBParameterGroup and ResetDBParameterGroup actions.

This data type is used as a response element in the DescribeEngineDefaultParameters and DescribeDBParameters actions.

" - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingCloudwatchLogsExports":{ - "type":"structure", - "members":{ - "LogTypesToEnable":{ - "shape":"LogTypeList", - "documentation":"

Log types that are in the process of being deactivated. After they are deactivated, these log types aren't exported to CloudWatch Logs.

" - }, - "LogTypesToDisable":{ - "shape":"LogTypeList", - "documentation":"

Log types that are in the process of being enabled. After they are enabled, these log types are exported to CloudWatch Logs.

" - } - }, - "documentation":"

A list of the log types whose configuration is still pending. In other words, these log types are in the process of being activated or deactivated.

" - }, - "PendingMaintenanceAction":{ - "type":"structure", - "members":{ - "Action":{ - "shape":"String", - "documentation":"

The type of pending maintenance action that is available for the resource.

" - }, - "AutoAppliedAfterDate":{ - "shape":"TStamp", - "documentation":"

The date of the maintenance window when the action is applied. The maintenance action is applied to the resource during its first maintenance window after this date. If this date is specified, any next-maintenance opt-in requests are ignored.

" - }, - "ForcedApplyDate":{ - "shape":"TStamp", - "documentation":"

The date when the maintenance action is automatically applied. The maintenance action is applied to the resource on this date regardless of the maintenance window for the resource. If this date is specified, any immediate opt-in requests are ignored.

" - }, - "OptInStatus":{ - "shape":"String", - "documentation":"

Indicates the type of opt-in request that has been received for the resource.

" - }, - "CurrentApplyDate":{ - "shape":"TStamp", - "documentation":"

The effective date when the pending maintenance action is applied to the resource. This date takes into account opt-in requests received from the ApplyPendingMaintenanceAction API, the AutoAppliedAfterDate, and the ForcedApplyDate. This value is blank if an opt-in request has not been received and nothing has been specified as AutoAppliedAfterDate or ForcedApplyDate.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description providing more detail about the maintenance action.

" - } - }, - "documentation":"

Provides information about a pending maintenance action for a resource.

" - }, - "PendingMaintenanceActionDetails":{ - "type":"list", - "member":{ - "shape":"PendingMaintenanceAction", - "locationName":"PendingMaintenanceAction" - } - }, - "PendingMaintenanceActions":{ - "type":"list", - "member":{ - "shape":"ResourcePendingMaintenanceActions", - "locationName":"ResourcePendingMaintenanceActions" - } - }, - "PendingMaintenanceActionsMessage":{ - "type":"structure", - "members":{ - "PendingMaintenanceActions":{ - "shape":"PendingMaintenanceActions", - "documentation":"

A list of the pending maintenance actions for the resource.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribePendingMaintenanceActions request. If this parameter is specified, the response includes only records beyond the marker, up to a number of records specified by MaxRecords.

" - } - }, - "documentation":"

Data returned from the DescribePendingMaintenanceActions action.

" - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "DBInstanceClass":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceClass for the DB instance that will be applied or is currently being applied.

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

Contains the new AllocatedStorage size for the DB instance that will be applied or is currently being applied.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

Contains the pending or currently-in-progress change of the master credentials for the DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending port for the DB instance.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the pending number of days for which automated backups are retained.

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that the Single-AZ DB instance is to change to a Multi-AZ deployment.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

Indicates the database engine version.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for the DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the new Provisioned IOPS value for the DB instance that will be applied or is currently being applied.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Contains the new DBInstanceIdentifier for the DB instance that will be applied or is currently being applied.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

" - }, - "CACertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier of the CA certificate for the DB instance.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The new DB subnet group for the DB instance.

" - }, - "PendingCloudwatchLogsExports":{"shape":"PendingCloudwatchLogsExports"}, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - } - }, - "documentation":"

This data type is used as a response element in the ModifyDBInstance action.

" - }, - "PointInTimeRestoreNotEnabledFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

SourceDBInstanceIdentifier refers to a DB instance with BackupRetentionPeriod equal to 0.

", - "error":{ - "code":"PointInTimeRestoreNotEnabled", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ProcessorFeature":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the processor feature. Valid names are coreCount and threadsPerCore.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of a processor feature name.

" - } - }, - "documentation":"

Contains the processor features of a DB instance class.

To specify the number of CPU cores, use the coreCount feature name for the Name parameter. To specify the number of threads per core, use the threadsPerCore feature name for the Name parameter.

You can set the processor features of the DB instance class for a DB instance when you call one of the following actions:

You can view the valid processor values for a particular instance class by calling the DescribeOrderableDBInstanceOptions action and specifying the instance class for the DBInstanceClass parameter.

In addition, you can use the following actions for DB instance class processor information:

For more information, see Configuring the Processor of the DB Instance Class in the Amazon RDS User Guide.

" - }, - "ProcessorFeatureList":{ - "type":"list", - "member":{ - "shape":"ProcessorFeature", - "locationName":"ProcessorFeature" - } - }, - "PromoteReadReplicaDBClusterMessage":{ - "type":"structure", - "required":["DBClusterIdentifier"], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the DB cluster Read Replica to promote. This parameter is not case-sensitive.

Constraints:

  • Must match the identifier of an existing DBCluster Read Replica.

Example: my-cluster-replica1

" - } - }, - "documentation":"

" - }, - "PromoteReadReplicaDBClusterResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "PromoteReadReplicaMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing Read Replica DB instance.

Example: mydbinstance

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Default: 1

Constraints:

  • Must be a value from 0 to 8

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - } - }, - "documentation":"

" - }, - "PromoteReadReplicaResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "ProvisionedIopsNotAvailableInAZFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Provisioned IOPS not available in the specified Availability Zone.

", - "error":{ - "code":"ProvisionedIopsNotAvailableInAZFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PurchaseReservedDBInstancesOfferingMessage":{ - "type":"structure", - "required":["ReservedDBInstancesOfferingId"], - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The ID of the Reserved DB instance offering to purchase.

Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706

" - }, - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

Customer-specified identifier to track this reservation.

Example: myreservationID

" - }, - "DBInstanceCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of instances to reserve.

Default: 1

" - }, - "Tags":{"shape":"TagList"} - }, - "documentation":"

" - }, - "PurchaseReservedDBInstancesOfferingResult":{ - "type":"structure", - "members":{ - "ReservedDBInstance":{"shape":"ReservedDBInstance"} - } - }, - "Range":{ - "type":"structure", - "members":{ - "From":{ - "shape":"Integer", - "documentation":"

The minimum value in the range.

" - }, - "To":{ - "shape":"Integer", - "documentation":"

The maximum value in the range.

" - }, - "Step":{ - "shape":"IntegerOptional", - "documentation":"

The step value for the range. For example, if you have a range of 5,000 to 10,000, with a step value of 1,000, the valid values start at 5,000 and step up by 1,000. Even though 7,500 is within the range, it isn't a valid value for the range. The valid values are 5,000, 6,000, 7,000, 8,000...

" - } - }, - "documentation":"

A range of integer values.

" - }, - "RangeList":{ - "type":"list", - "member":{ - "shape":"Range", - "locationName":"Range" - } - }, - "ReadReplicaDBClusterIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaDBClusterIdentifier" - } - }, - "ReadReplicaDBInstanceIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaDBInstanceIdentifier" - } - }, - "ReadReplicaIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ReadReplicaIdentifier" - } - }, - "RebootDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBInstance.

" - }, - "ForceFailover":{ - "shape":"BooleanOptional", - "documentation":"

When true, the reboot is conducted through a MultiAZ failover.

Constraint: You can't specify true if the instance is not configured for MultiAZ.

" - } - }, - "documentation":"

" - }, - "RebootDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The amount of the recurring charge.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency of the recurring charge.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstances and DescribeReservedDBInstancesOfferings actions.

", - "wrapper":true - }, - "RecurringChargeList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"RecurringCharge" - } - }, - "RemoveRoleFromDBClusterMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "RoleArn" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to disassociate the IAM role from.

" - }, - "RoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to disassociate from the Aurora DB cluster, for example arn:aws:iam::123456789012:role/AuroraAccessRole.

" - } - } - }, - "RemoveSourceIdentifierFromSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SourceIdentifier" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the RDS event notification subscription you want to remove a source identifier from.

" - }, - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The source identifier to be removed from the subscription, such as the DB instance identifier for a DB instance or the name of a security group.

" - } - }, - "documentation":"

" - }, - "RemoveSourceIdentifierFromSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "RemoveTagsFromResourceMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon RDS resource that the tags are removed from. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

The tag key (name) of the tag to be removed.

" - } - }, - "documentation":"

" - }, - "ReservedDBInstance":{ - "type":"structure", - "members":{ - "ReservedDBInstanceId":{ - "shape":"String", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for the reserved DB instance.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The time the reservation started.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the reservation in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this reserved DB instance.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this reserved DB instance.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved DB instance.

" - }, - "DBInstanceCount":{ - "shape":"Integer", - "documentation":"

The number of reserved DB instances.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The description of the reserved DB instance.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type of this reserved DB instance.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Indicates if the reservation applies to Multi-AZ deployments.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved DB instance.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved DB instance.

" - }, - "ReservedDBInstanceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the reserved DB instance.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstances and PurchaseReservedDBInstancesOffering actions.

", - "wrapper":true - }, - "ReservedDBInstanceAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User already has a reservation with the given identifier.

", - "error":{ - "code":"ReservedDBInstanceAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedDBInstanceList":{ - "type":"list", - "member":{ - "shape":"ReservedDBInstance", - "locationName":"ReservedDBInstance" - } - }, - "ReservedDBInstanceMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReservedDBInstances":{ - "shape":"ReservedDBInstanceList", - "documentation":"

A list of reserved DB instances.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstances action.

" - }, - "ReservedDBInstanceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reserved DB Instance not found.

", - "error":{ - "code":"ReservedDBInstanceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedDBInstanceQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would exceed the user's DB Instance quota.

", - "error":{ - "code":"ReservedDBInstanceQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ReservedDBInstancesOffering":{ - "type":"structure", - "members":{ - "ReservedDBInstancesOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The DB instance class for the reserved DB instance.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the offering in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed price charged for this offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly price charged for this offering.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved DB instance offering.

" - }, - "ProductDescription":{ - "shape":"String", - "documentation":"

The database engine used by the offering.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The offering type.

" - }, - "MultiAZ":{ - "shape":"Boolean", - "documentation":"

Indicates if the offering applies to Multi-AZ deployments.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring price charged to run this reserved DB instance.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeReservedDBInstancesOfferings action.

", - "wrapper":true - }, - "ReservedDBInstancesOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedDBInstancesOffering", - "locationName":"ReservedDBInstancesOffering" - } - }, - "ReservedDBInstancesOfferingMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "ReservedDBInstancesOfferings":{ - "shape":"ReservedDBInstancesOfferingList", - "documentation":"

A list of reserved DB instance offerings.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeReservedDBInstancesOfferings action.

" - }, - "ReservedDBInstancesOfferingNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Specified offering does not exist.

", - "error":{ - "code":"ReservedDBInstancesOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ResetDBClusterParameterGroupMessage":{ - "type":"structure", - "required":["DBClusterParameterGroupName"], - "members":{ - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to reset.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

A value that is set to true to reset all parameters in the DB cluster parameter group to their default values, and false otherwise. You can't use this parameter if there is a list of parameter names specified for the Parameters parameter.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of parameter names in the DB cluster parameter group to reset to the default values. You can't use this parameter if the ResetAllParameters parameter is set to true.

" - } - }, - "documentation":"

" - }, - "ResetDBParameterGroupMessage":{ - "type":"structure", - "required":["DBParameterGroupName"], - "members":{ - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group.

Constraints:

  • Must match the name of an existing DBParameterGroup.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) to reset all parameters in the DB parameter group to default values.

Default: true

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

MySQL

Valid Values (for Apply method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when DB instance reboots.

MariaDB

Valid Values (for Apply method): immediate | pending-reboot

You can use the immediate value with dynamic parameters only. You can use the pending-reboot value for both dynamic and static parameters, and changes are applied when DB instance reboots.

Oracle

Valid Values (for Apply method): pending-reboot

" - } - }, - "documentation":"

" - }, - "ResourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource ID was not found.

", - "error":{ - "code":"ResourceNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ResourcePendingMaintenanceActions":{ - "type":"structure", - "members":{ - "ResourceIdentifier":{ - "shape":"String", - "documentation":"

The ARN of the resource that has pending maintenance actions.

" - }, - "PendingMaintenanceActionDetails":{ - "shape":"PendingMaintenanceActionDetails", - "documentation":"

A list that provides details about the pending maintenance actions for the resource.

" - } - }, - "documentation":"

Describes the pending maintenance actions for a resource.

", - "wrapper":true - }, - "RestoreDBClusterFromS3Message":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "Engine", - "MasterUsername", - "MasterUserPassword", - "SourceEngine", - "SourceEngineVersion", - "S3BucketName", - "S3IngestionRoleArn" - ], - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

A list of EC2 Availability Zones that instances in the restored DB cluster can be created in.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups of the restored DB cluster are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

" - }, - "CharacterSetName":{ - "shape":"String", - "documentation":"

A value that indicates that the restored DB cluster should be associated with the specified CharacterSet.

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The database name for the restored DB cluster.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to create from the source data in the Amazon S3 bucket. This parameter is isn't case-sensitive.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: my-cluster1

" - }, - "DBClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB cluster parameter group to associate with the restored DB cluster. If this argument is omitted, default.aurora5.6 is used.

Constraints:

  • If supplied, must match the name of an existing DBClusterParameterGroup.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of EC2 VPC security groups to associate with the restored DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with the restored DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for the restored DB cluster.

Valid Values: aurora, aurora-postgresql

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use.

Aurora MySQL

Example: 5.6.10a

Aurora PostgreSQL

Example: 9.6.3

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the instances in the restored DB cluster accept connections.

Default: 3306

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name of the master user for the restored DB cluster.

Constraints:

  • Must be 1 to 16 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

A value that indicates that the restored DB cluster should be associated with the specified option group.

Permanent options can't be removed from an option group. An option group can't be removed from a DB cluster once it is associated with a DB cluster.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

" - }, - "Tags":{"shape":"TagList"}, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the restored DB cluster is encrypted.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KM encryption key.

If the StorageEncrypted parameter is true, and you do not specify a value for the KmsKeyId parameter, then Amazon RDS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "SourceEngine":{ - "shape":"String", - "documentation":"

The identifier for the database engine that was backed up to create the files stored in the Amazon S3 bucket.

Valid values: mysql

" - }, - "SourceEngineVersion":{ - "shape":"String", - "documentation":"

The version of the database that the backup files were created from.

MySQL version 5.5 and 5.6 are supported.

Example: 5.6.22

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

The name of the Amazon S3 bucket that contains the data used to create the Amazon Aurora DB cluster.

" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The prefix for all of the file names that contain the data used to create the Amazon Aurora DB cluster. If you do not specify a SourceS3Prefix value, then the Amazon Aurora DB cluster is created by using all of the files in the Amazon S3 bucket.

" - }, - "S3IngestionRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that authorizes Amazon RDS to access the Amazon S3 bucket on your behalf.

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - } - } - }, - "RestoreDBClusterFromS3Result":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "RestoreDBClusterFromSnapshotMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "SnapshotIdentifier", - "Engine" - ], - "members":{ - "AvailabilityZones":{ - "shape":"AvailabilityZones", - "documentation":"

Provides the list of EC2 Availability Zones that instances in the restored DB cluster can be created in.

" - }, - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the DB cluster to create from the DB snapshot or DB cluster snapshot. This parameter isn't case-sensitive.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot or DB cluster snapshot to restore from.

You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot.

Constraints:

  • Must match the identifier of an existing Snapshot.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new DB cluster.

Default: The same as source

Constraint: Must be compatible with the engine of the source

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version of the database engine to use for the new DB cluster.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the new DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the DB subnet group to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "DatabaseName":{ - "shape":"String", - "documentation":"

The database name for the restored DB cluster.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to use for the restored DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the new DB cluster will belong to.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags to be assigned to the restored DB cluster.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier to use when restoring an encrypted DB cluster from a DB snapshot or DB cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

  • If the DB snapshot or DB cluster snapshot in SnapshotIdentifier is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the DB snapshot or DB cluster snapshot.

  • If the DB snapshot or DB cluster snapshot in SnapshotIdentifier is not encrypted, then the restored DB cluster is not encrypted.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "EngineMode":{ - "shape":"String", - "documentation":"

The DB engine mode of the DB cluster, either provisioned or serverless.

" - }, - "ScalingConfiguration":{ - "shape":"ScalingConfiguration", - "documentation":"

For DB clusters in serverless DB engine mode, the scaling properties of the DB cluster.

" - } - }, - "documentation":"

" - }, - "RestoreDBClusterFromSnapshotResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "RestoreDBClusterToPointInTimeMessage":{ - "type":"structure", - "required":[ - "DBClusterIdentifier", - "SourceDBClusterIdentifier" - ], - "members":{ - "DBClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the new DB cluster to be created.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "RestoreType":{ - "shape":"String", - "documentation":"

The type of restore to be performed. You can specify one of the following values:

  • full-copy - The new DB cluster is restored as a full copy of the source DB cluster.

  • copy-on-write - The new DB cluster is restored as a clone of the source DB cluster.

Constraints: You can't specify copy-on-write if the engine version of the source DB cluster is earlier than 1.11.

If you don't specify a RestoreType value, then the new DB cluster is restored as a full copy of the source DB cluster.

" - }, - "SourceDBClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the source DB cluster from which to restore.

Constraints:

  • Must match the identifier of an existing DBCluster.

" - }, - "RestoreToTime":{ - "shape":"TStamp", - "documentation":"

The date and time to restore the DB cluster to.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

  • Must be before the latest restorable time for the DB instance

  • Must be specified if UseLatestRestorableTime parameter is not provided

  • Cannot be specified if UseLatestRestorableTime parameter is true

  • Cannot be specified if RestoreType parameter is copy-on-write

Example: 2015-03-07T23:45:00Z

" - }, - "UseLatestRestorableTime":{ - "shape":"Boolean", - "documentation":"

A value that is set to true to restore the DB cluster to the latest restorable backup time, and false otherwise.

Default: false

Constraints: Cannot be specified if RestoreToTime parameter is provided.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the new DB cluster accepts connections.

Constraints: A value from 1150-65535.

Default: The default port for the engine.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group for the new DB cluster.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups that the new DB cluster belongs to.

" - }, - "Tags":{"shape":"TagList"}, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier to use when restoring an encrypted DB cluster from an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new DB cluster and encrypt the new DB cluster with a KMS key that is different than the KMS key used to encrypt the source DB cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

  • If the DB cluster is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the source DB cluster.

  • If the DB cluster is not encrypted, then the restored DB cluster is not encrypted.

If DBClusterIdentifier refers to a DB cluster that is not encrypted, then the restore request is rejected.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "BacktrackWindow":{ - "shape":"LongOptional", - "documentation":"

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - } - }, - "documentation":"

" - }, - "RestoreDBClusterToPointInTimeResult":{ - "type":"structure", - "members":{ - "DBCluster":{"shape":"DBCluster"} - } - }, - "RestoreDBInstanceFromDBSnapshotMessage":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "DBSnapshotIdentifier" - ], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

Name of the DB instance to create from the DB snapshot. This parameter isn't case-sensitive.

Constraints:

  • Must contain from 1 to 63 numbers, letters, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the DB snapshot to restore from.

Constraints:

  • Must match the identifier of an existing DBSnapshot.

  • If you are restoring from a shared manual DB snapshot, the DBSnapshotIdentifier must be the ARN of the shared DB snapshot.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Amazon RDS DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Default: The same DBInstanceClass as the original DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Default: The same port as the original DB instance

Constraints: Value must be 1150-65535

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the DB instance is created in.

Default: A random, system-chosen Availability Zone.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new instance.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address. For more information, see CreateDBInstance.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades are applied automatically to the DB instance during the maintenance window.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

Default: Same as source.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The database name for the restored DB instance.

This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB engines.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new instance.

Default: The same as source

Constraint: Must be compatible with the engine of the source. For example, you can restore a MariaDB 10.1 DB instance from a MySQL 5.6 snapshot.

Valid Values:

  • mariadb

  • mysql

  • oracle-ee

  • oracle-se2

  • oracle-se1

  • oracle-se

  • postgres

  • sqlserver-ee

  • sqlserver-se

  • sqlserver-ex

  • sqlserver-web

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

Specifies the amount of provisioned IOPS for the DB instance, expressed in I/O operations per second. If this parameter is not specified, the IOPS value is taken from the backup. If this parameter is set to 0, the new instance is converted to a non-PIOPS instance. The conversion takes additional time, though your DB instance is available for connections before the conversion starts.

The provisioned IOPS value must follow the requirements for your database engine. For more information, see Amazon RDS Provisioned IOPS Storage to Improve Performance.

Constraints: Must be an integer greater than 1000.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be used for the restored DB instance.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "Tags":{"shape":"TagList"}, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

Specify the Active Directory Domain to restore the instance in.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the restored DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

Specify the name of the IAM role to be used when making API calls to the Directory Service.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

Default: false

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - }, - "UseDefaultProcessorFeatures":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies that the DB instance class of the DB instance uses its default processor features.

" - } - }, - "documentation":"

" - }, - "RestoreDBInstanceFromDBSnapshotResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RestoreDBInstanceFromS3Message":{ - "type":"structure", - "required":[ - "DBInstanceIdentifier", - "DBInstanceClass", - "Engine", - "SourceEngine", - "SourceEngineVersion", - "S3BucketName", - "S3IngestionRoleArn" - ], - "members":{ - "DBName":{ - "shape":"String", - "documentation":"

The name of the database to create when the DB instance is created. Follow the naming rules specified in CreateDBInstance.

" - }, - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

Example: mydbinstance

" - }, - "AllocatedStorage":{ - "shape":"IntegerOptional", - "documentation":"

The amount of storage (in gigabytes) to allocate initially for the DB instance. Follow the allocation rules specified in CreateDBInstance.

Be sure to allocate enough memory for your new DB instance so that the restore operation can succeed. You can also allocate additional memory for future growth.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Importing from Amazon S3 is not supported on the db.t2.micro DB instance class.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The name of the database engine to be used for this instance.

Valid Values: mysql

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The name for the master user.

Constraints:

  • Must be 1 to 16 letters or numbers.

  • First character must be a letter.

  • Cannot be a reserved word for the chosen database engine.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

" - }, - "DBSecurityGroups":{ - "shape":"DBSecurityGroupNameList", - "documentation":"

A list of DB security groups to associate with this DB instance.

Default: The default DB security group for the database engine.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of VPC security groups to associate with this DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone that the DB instance is created in. For information about AWS Regions and Availability Zones, see Regions and Availability Zones.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same AWS Region as the current endpoint.

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

A DB subnet group to associate with this DB instance.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC). For more information, see Amazon RDS Maintenance Window.

Constraints:

  • Must be in the format ddd:hh24:mi-ddd:hh24:mi.

  • Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred backup window.

  • Must be at least 30 minutes.

" - }, - "DBParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default parameter group for the specified engine is used.

" - }, - "BackupRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. For more information, see CreateDBInstance.

" - }, - "PreferredBackupWindow":{ - "shape":"String", - "documentation":"

The time range each day during which automated backups are created if automated backups are enabled. For more information, see The Backup Window.

Constraints:

  • Must be in the format hh24:mi-hh24:mi.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Type: Integer

Valid Values: 1150-65535

Default: 3306

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the DB instance is a Multi-AZ deployment. If MultiAZ is set to true, you can't set the AvailabilityZone parameter.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the database engine to use. Choose the latest minor version of your database engine. For information about engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

True to indicate that minor engine upgrades are applied automatically to the DB instance during the maintenance window, and otherwise false.

Default: true

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

The license model for this DB instance. Use general-public-license.

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to allocate initially for the DB instance. For information about valid Iops values, see see Amazon RDS Provisioned IOPS Storage to Improve Performance.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to associate with this DB instance. If this argument is omitted, the default option group for the specified engine is used.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address. For more information, see CreateDBInstance.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags to associate with this DB instance. For more information, see Tagging Amazon RDS Resources.

" - }, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified; otherwise standard

" - }, - "StorageEncrypted":{ - "shape":"BooleanOptional", - "documentation":"

Specifies whether the new DB instance is encrypted or not.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for an encrypted DB instance.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB instance with the same AWS account that owns the KMS encryption key used to encrypt the new DB instance, then you can use the KMS key alias instead of the ARN for the KM encryption key.

If the StorageEncrypted parameter is true, and you do not specify a value for the KmsKeyId parameter, then Amazon RDS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false.

Default: false.

" - }, - "MonitoringInterval":{ - "shape":"IntegerOptional", - "documentation":"

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

Default: 0

" - }, - "MonitoringRoleArn":{ - "shape":"String", - "documentation":"

The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess. For information on creating a monitoring role, see Setting Up and Enabling Enhanced Monitoring.

If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

Default: false

" - }, - "SourceEngine":{ - "shape":"String", - "documentation":"

The name of the engine of your source database.

Valid Values: mysql

" - }, - "SourceEngineVersion":{ - "shape":"String", - "documentation":"

The engine version of your source database.

Valid Values: 5.6

" - }, - "S3BucketName":{ - "shape":"String", - "documentation":"

The name of your Amazon S3 bucket that contains your database backup file.

" - }, - "S3Prefix":{ - "shape":"String", - "documentation":"

The prefix of your Amazon S3 bucket.

" - }, - "S3IngestionRoleArn":{ - "shape":"String", - "documentation":"

An AWS Identity and Access Management (IAM) role to allow Amazon RDS to access your Amazon S3 bucket.

" - }, - "EnablePerformanceInsights":{ - "shape":"BooleanOptional", - "documentation":"

True to enable Performance Insights for the DB instance, and otherwise false.

For more information, see Using Amazon Performance Insights in the Amazon Relational Database Service User Guide.

" - }, - "PerformanceInsightsKMSKeyId":{ - "shape":"String", - "documentation":"

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), the KMS key identifier, or the KMS key alias for the KMS encryption key.

" - }, - "PerformanceInsightsRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - }, - "UseDefaultProcessorFeatures":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies that the DB instance class of the DB instance uses its default processor features.

" - } - } - }, - "RestoreDBInstanceFromS3Result":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RestoreDBInstanceToPointInTimeMessage":{ - "type":"structure", - "required":[ - "SourceDBInstanceIdentifier", - "TargetDBInstanceIdentifier" - ], - "members":{ - "SourceDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the source DB instance from which to restore.

Constraints:

  • Must match the identifier of an existing DB instance.

" - }, - "TargetDBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The name of the new DB instance to be created.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "RestoreTime":{ - "shape":"TStamp", - "documentation":"

The date and time to restore from.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

  • Must be before the latest restorable time for the DB instance

  • Cannot be specified if UseLatestRestorableTime parameter is true

Example: 2009-09-07T23:45:00Z

" - }, - "UseLatestRestorableTime":{ - "shape":"Boolean", - "documentation":"

Specifies whether (true) or not (false) the DB instance is restored from the latest backup time.

Default: false

Constraints: Cannot be specified if RestoreTime parameter is provided.

" - }, - "DBInstanceClass":{ - "shape":"String", - "documentation":"

The compute and memory capacity of the Amazon RDS DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Default: The same DBInstanceClass as the original DB instance.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the database accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB instance.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone that the DB instance is created in.

Default: A random, system-chosen Availability Zone.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

" - }, - "DBSubnetGroupName":{ - "shape":"String", - "documentation":"

The DB subnet group name to use for the new instance.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

" - }, - "MultiAZ":{ - "shape":"BooleanOptional", - "documentation":"

Specifies if the DB instance is a Multi-AZ deployment.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

Specifies the accessibility options for the DB instance. A value of true specifies an Internet-facing instance with a publicly resolvable DNS name, which resolves to a public IP address. A value of false specifies an internal instance with a DNS name that resolves to a private IP address. For more information, see CreateDBInstance.

" - }, - "AutoMinorVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

Indicates that minor version upgrades are applied automatically to the DB instance during the maintenance window.

" - }, - "LicenseModel":{ - "shape":"String", - "documentation":"

License model information for the restored DB instance.

Default: Same as source.

Valid values: license-included | bring-your-own-license | general-public-license

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The database name for the restored DB instance.

This parameter is not used for the MySQL or MariaDB engines.

" - }, - "Engine":{ - "shape":"String", - "documentation":"

The database engine to use for the new instance.

Default: The same as source

Constraint: Must be compatible with the engine of the source

Valid Values:

  • mariadb

  • mysql

  • oracle-ee

  • oracle-se2

  • oracle-se1

  • oracle-se

  • postgres

  • sqlserver-ee

  • sqlserver-se

  • sqlserver-ex

  • sqlserver-web

" - }, - "Iops":{ - "shape":"IntegerOptional", - "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

Constraints: Must be an integer greater than 1000.

SQL Server

Setting the IOPS value for the SQL Server database engine is not supported.

" - }, - "OptionGroupName":{ - "shape":"String", - "documentation":"

The name of the option group to be used for the restored DB instance.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

" - }, - "CopyTagsToSnapshot":{ - "shape":"BooleanOptional", - "documentation":"

True to copy all tags from the restored DB instance to snapshots of the DB instance, and otherwise false. The default is false.

" - }, - "Tags":{"shape":"TagList"}, - "StorageType":{ - "shape":"String", - "documentation":"

Specifies the storage type to be associated with the DB instance.

Valid values: standard | gp2 | io1

If you specify io1, you must also include a value for the Iops parameter.

Default: io1 if the Iops parameter is specified, otherwise standard

" - }, - "TdeCredentialArn":{ - "shape":"String", - "documentation":"

The ARN from the key store with which to associate the instance for TDE encryption.

" - }, - "TdeCredentialPassword":{ - "shape":"String", - "documentation":"

The password for the given ARN from the key store in order to access the device.

" - }, - "Domain":{ - "shape":"String", - "documentation":"

Specify the Active Directory Domain to restore the instance in.

" - }, - "DomainIAMRoleName":{ - "shape":"String", - "documentation":"

Specify the name of the IAM role to be used when making API calls to the Directory Service.

" - }, - "EnableIAMDatabaseAuthentication":{ - "shape":"BooleanOptional", - "documentation":"

True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false.

You can enable IAM database authentication for the following database engines

  • For MySQL 5.6, minor version 5.6.34 or higher

  • For MySQL 5.7, minor version 5.7.16 or higher

Default: false

" - }, - "EnableCloudwatchLogsExports":{ - "shape":"LogTypeList", - "documentation":"

The list of logs that the restored DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Relational Database Service User Guide.

" - }, - "ProcessorFeatures":{ - "shape":"ProcessorFeatureList", - "documentation":"

The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.

" - }, - "UseDefaultProcessorFeatures":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies that the DB instance class of the DB instance uses its default processor features.

" - } - }, - "documentation":"

" - }, - "RestoreDBInstanceToPointInTimeResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "RevokeDBSecurityGroupIngressMessage":{ - "type":"structure", - "required":["DBSecurityGroupName"], - "members":{ - "DBSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the DB security group to revoke ingress from.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range to revoke access from. Must be a valid CIDR range. If CIDRIP is specified, EC2SecurityGroupName, EC2SecurityGroupId and EC2SecurityGroupOwnerId can't be provided.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the EC2 security group to revoke access from. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupId":{ - "shape":"String", - "documentation":"

The id of the EC2 security group to revoke access from. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS Account Number of the owner of the EC2 security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

" - } - }, - "documentation":"

" - }, - "RevokeDBSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "DBSecurityGroup":{"shape":"DBSecurityGroup"} - } - }, - "SNSInvalidTopicFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

SNS has responded that there is a problem with the SND topic specified.

", - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSNoAuthorizationFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You do not have permission to publish to the SNS topic ARN.

", - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSTopicArnNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The SNS topic ARN does not exist.

", - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ScalingConfiguration":{ - "type":"structure", - "members":{ - "MinCapacity":{ - "shape":"IntegerOptional", - "documentation":"

The minimum capacity for an Aurora DB cluster in serverless DB engine mode.

Valid capacity values are 2, 4, 8, 16, 32, 64, 128, and 256.

The minimum capacity must be less than or equal to the maximum capacity.

" - }, - "MaxCapacity":{ - "shape":"IntegerOptional", - "documentation":"

The maximum capacity for an Aurora DB cluster in serverless DB engine mode.

Valid capacity values are 2, 4, 8, 16, 32, 64, 128, and 256.

The maximum capacity must be greater than or equal to the minimum capacity.

" - }, - "AutoPause":{ - "shape":"BooleanOptional", - "documentation":"

A value that specifies whether to allow or disallow automatic pause for an Aurora DB cluster in serverless DB engine mode. A DB cluster can be paused only when it's idle (it has no connections).

If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it.

" - }, - "SecondsUntilAutoPause":{ - "shape":"IntegerOptional", - "documentation":"

The time, in seconds, before an Aurora DB cluster in serverless mode is paused.

" - } - }, - "documentation":"

Contains the scaling configuration of an Aurora Serverless DB cluster.

For more information, see Using Amazon Aurora Serverless in the Amazon RDS User Guide.

" - }, - "ScalingConfigurationInfo":{ - "type":"structure", - "members":{ - "MinCapacity":{ - "shape":"IntegerOptional", - "documentation":"

The maximum capacity for the Aurora DB cluster in serverless DB engine mode.

" - }, - "MaxCapacity":{ - "shape":"IntegerOptional", - "documentation":"

The maximum capacity for an Aurora DB cluster in serverless DB engine mode.

" - }, - "AutoPause":{ - "shape":"BooleanOptional", - "documentation":"

A value that indicates whether automatic pause is allowed for the Aurora DB cluster in serverless DB engine mode.

" - }, - "SecondsUntilAutoPause":{ - "shape":"IntegerOptional", - "documentation":"

The remaining amount of time, in seconds, before the Aurora DB cluster in serverless mode is paused. A DB cluster can be paused only when it's idle (it has no connections).

" - } - }, - "documentation":"

Shows the scaling configuration for an Aurora DB cluster in serverless DB engine mode.

For more information, see Using Amazon Aurora Serverless in the Amazon RDS User Guide.

" - }, - "SharedSnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.

", - "error":{ - "code":"SharedSnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of DB snapshots.

", - "error":{ - "code":"SnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SourceIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SourceId" - } - }, - "SourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested source could not be found.

", - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SourceRegion":{ - "type":"structure", - "members":{ - "RegionName":{ - "shape":"String", - "documentation":"

The name of the source AWS Region.

" - }, - "Endpoint":{ - "shape":"String", - "documentation":"

The endpoint for the source AWS Region endpoint.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the source AWS Region.

" - } - }, - "documentation":"

Contains an AWS Region name as the result of a successful call to the DescribeSourceRegions action.

" - }, - "SourceRegionList":{ - "type":"list", - "member":{ - "shape":"SourceRegion", - "locationName":"SourceRegion" - } - }, - "SourceRegionMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

" - }, - "SourceRegions":{ - "shape":"SourceRegionList", - "documentation":"

A list of SourceRegion instances that contains each source AWS Region that the current AWS Region can get a Read Replica or a DB snapshot from.

" - } - }, - "documentation":"

Contains the result of a successful invocation of the DescribeSourceRegions action.

" - }, - "SourceType":{ - "type":"string", - "enum":[ - "db-instance", - "db-parameter-group", - "db-security-group", - "db-snapshot", - "db-cluster", - "db-cluster-snapshot" - ] - }, - "StartDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier.

" - } - } - }, - "StartDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "StopDBInstanceMessage":{ - "type":"structure", - "required":["DBInstanceIdentifier"], - "members":{ - "DBInstanceIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier.

" - }, - "DBSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The user-supplied instance identifier of the DB Snapshot created immediately before the DB instance is stopped.

" - } - } - }, - "StopDBInstanceResult":{ - "type":"structure", - "members":{ - "DBInstance":{"shape":"DBInstance"} - } - }, - "StorageQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed amount of storage available across all DB instances.

", - "error":{ - "code":"StorageQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "StorageTypeNotSupportedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Storage of the StorageType specified can't be associated with the DB instance.

", - "error":{ - "code":"StorageTypeNotSupported", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

Specifies the identifier of the subnet.

" - }, - "SubnetAvailabilityZone":{"shape":"AvailabilityZone"}, - "SubnetStatus":{ - "shape":"String", - "documentation":"

Specifies the status of the subnet.

" - } - }, - "documentation":"

This data type is used as a response element in the DescribeDBSubnetGroups action.

" - }, - "SubnetAlreadyInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The DB subnet is already in use in the Availability Zone.

", - "error":{ - "code":"SubnetAlreadyInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "SubscriptionAlreadyExistFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The supplied subscription name already exists.

", - "error":{ - "code":"SubscriptionAlreadyExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubscriptionCategoryNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The supplied category does not exist.

", - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SubscriptionNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The subscription name does not exist.

", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SupportedCharacterSetsList":{ - "type":"list", - "member":{ - "shape":"CharacterSet", - "locationName":"CharacterSet" - } - }, - "SupportedTimezonesList":{ - "type":"list", - "member":{ - "shape":"Timezone", - "locationName":"Timezone" - } - }, - "TStamp":{"type":"timestamp"}, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with \"aws:\" or \"rds:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - }, - "Value":{ - "shape":"String", - "documentation":"

A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with \"aws:\" or \"rds:\". The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").

" - } - }, - "documentation":"

Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

" - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - }, - "documentation":"

A list of tags. For more information, see Tagging Amazon RDS Resources.

" - }, - "TagListMessage":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

List of tags returned by the ListTagsForResource operation.

" - } - }, - "documentation":"

" - }, - "Timezone":{ - "type":"structure", - "members":{ - "TimezoneName":{ - "shape":"String", - "documentation":"

The name of the time zone.

" - } - }, - "documentation":"

A time zone associated with a DBInstance or a DBSnapshot. This data type is an element in the response to the DescribeDBInstances, the DescribeDBSnapshots, and the DescribeDBEngineVersions actions.

" - }, - "UpgradeTarget":{ - "type":"structure", - "members":{ - "Engine":{ - "shape":"String", - "documentation":"

The name of the upgrade target database engine.

" - }, - "EngineVersion":{ - "shape":"String", - "documentation":"

The version number of the upgrade target database engine.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The version of the database engine that a DB instance can be upgraded to.

" - }, - "AutoUpgrade":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether the target version is applied to any source DB instances that have AutoMinorVersionUpgrade set to true.

" - }, - "IsMajorVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

A value that indicates whether a database engine is upgraded to a major version.

" - } - }, - "documentation":"

The version of the database engine that a DB instance can be upgraded to.

" - }, - "ValidDBInstanceModificationsMessage":{ - "type":"structure", - "members":{ - "Storage":{ - "shape":"ValidStorageOptionsList", - "documentation":"

Valid storage options for your DB instance.

" - }, - "ValidProcessorFeatures":{ - "shape":"AvailableProcessorFeatureList", - "documentation":"

Valid processor features for your DB instance.

" - } - }, - "documentation":"

Information about valid modifications that you can make to your DB instance. Contains the result of a successful call to the DescribeValidDBInstanceModifications action. You can use this information when you call ModifyDBInstance.

", - "wrapper":true - }, - "ValidStorageOptions":{ - "type":"structure", - "members":{ - "StorageType":{ - "shape":"String", - "documentation":"

The valid storage types for your DB instance. For example, gp2, io1.

" - }, - "StorageSize":{ - "shape":"RangeList", - "documentation":"

The valid range of storage in gibibytes. For example, 100 to 16384.

" - }, - "ProvisionedIops":{ - "shape":"RangeList", - "documentation":"

The valid range of provisioned IOPS. For example, 1000-20000.

" - }, - "IopsToStorageRatio":{ - "shape":"DoubleRangeList", - "documentation":"

The valid range of Provisioned IOPS to gibibytes of storage multiplier. For example, 3-10, which means that provisioned IOPS can be between 3 and 10 times storage.

" - } - }, - "documentation":"

Information about valid modifications that you can make to your DB instance. Contains the result of a successful call to the DescribeValidDBInstanceModifications action.

" - }, - "ValidStorageOptionsList":{ - "type":"list", - "member":{ - "shape":"ValidStorageOptions", - "locationName":"ValidStorageOptions" - } - }, - "ValidUpgradeTargetList":{ - "type":"list", - "member":{ - "shape":"UpgradeTarget", - "locationName":"UpgradeTarget" - } - }, - "VpcSecurityGroupIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcSecurityGroupId" - } - }, - "VpcSecurityGroupMembership":{ - "type":"structure", - "members":{ - "VpcSecurityGroupId":{ - "shape":"String", - "documentation":"

The name of the VPC security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the VPC security group.

" - } - }, - "documentation":"

This data type is used as a response element for queries on VPC security group membership.

" - }, - "VpcSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"VpcSecurityGroupMembership", - "locationName":"VpcSecurityGroupMembership" - } - } - }, - "documentation":"Amazon Relational Database Service

Amazon Relational Database Service (Amazon RDS) is a web service that makes it easier to set up, operate, and scale a relational database in the cloud. It provides cost-efficient, resizable capacity for an industry-standard relational database and manages common database administration tasks, freeing up developers to focus on what makes their applications and businesses unique.

Amazon RDS gives you access to the capabilities of a MySQL, MariaDB, PostgreSQL, Microsoft SQL Server, Oracle, or Amazon Aurora database server. These capabilities mean that the code, applications, and tools you already use today with your existing databases work with Amazon RDS without modification. Amazon RDS automatically backs up your database and maintains the database software that powers your DB instance. Amazon RDS is flexible: you can scale your DB instance's compute resources and storage capacity to meet your application's demand. As with all Amazon Web Services, there are no up-front investments, and you pay only for the resources you use.

This interface reference for Amazon RDS contains documentation for a programming or command line interface you can use to manage Amazon RDS. Note that Amazon RDS is asynchronous, which means that some interfaces might require techniques such as polling or callback functions to determine when a command has been applied. In this reference, the parameter descriptions indicate whether a command is applied immediately, on the next instance reboot, or during the maintenance window. The reference structure is as follows, and we list following some related topics from the user guide.

Amazon RDS API Reference

Amazon RDS User Guide

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.sdk-extras.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.sdk-extras.json deleted file mode 100644 index ab6bfcd3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/service-2.sdk-extras.json +++ /dev/null @@ -1,39 +0,0 @@ - { - "version": 1.0, - "merge": { - "shapes": { - "CopyDBClusterSnapshotMessage": { - "members": { - "SourceRegion": { - "shape": "String", - "documentation": "

The ID of the region that contains the snapshot to be copied.

" - } - } - }, - "CreateDBClusterMessage": { - "members": { - "SourceRegion": { - "shape": "String", - "documentation": "

The ID of the region that contains the source for the db cluster.

" - } - } - }, - "CopyDBSnapshotMessage": { - "members": { - "SourceRegion": { - "shape": "String", - "documentation": "

The ID of the region that contains the snapshot to be copied.

" - } - } - }, - "CreateDBInstanceReadReplicaMessage": { - "members": { - "SourceRegion": { - "shape": "String", - "documentation": "

The ID of the region that contains the source for the read replica.

" - } - } - } - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/waiters-2.json deleted file mode 100644 index c698be52..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rds/2014-10-31/waiters-2.json +++ /dev/null @@ -1,193 +0,0 @@ -{ - "version": 2, - "waiters": { - "DBInstanceAvailable": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-restore", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "incompatible-parameters", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - }, - "DBInstanceDeleted": { - "delay": 30, - "operation": "DescribeDBInstances", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "DBInstanceNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - }, - { - "expected": "resetting-master-credentials", - "matcher": "pathAny", - "state": "failure", - "argument": "DBInstances[].DBInstanceStatus" - } - ] - }, - "DBSnapshotAvailable": { - "delay": 30, - "operation": "DescribeDBSnapshots", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "incompatible-restore", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "incompatible-parameters", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - } - ] - }, - "DBSnapshotDeleted": { - "delay": 30, - "operation": "DescribeDBSnapshots", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "deleted", - "matcher": "pathAll", - "state": "success", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "DBSnapshotNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "rebooting", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - }, - { - "expected": "resetting-master-credentials", - "matcher": "pathAny", - "state": "failure", - "argument": "DBSnapshots[].Status" - } - ] - }, - "DBSnapshotCompleted": { - "delay": 15, - "operation": "DescribeDBSnapshots", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "DBSnapshotNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "DBSnapshots[].Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/paginators-1.json deleted file mode 100644 index 03027de3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/paginators-1.json +++ /dev/null @@ -1,94 +0,0 @@ -{ - "pagination": { - "DescribeClusterParameterGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ParameterGroups" - }, - "DescribeClusterParameters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Parameters" - }, - "DescribeClusterSecurityGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ClusterSecurityGroups" - }, - "DescribeClusterSnapshots": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Snapshots" - }, - "DescribeClusterSubnetGroups": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ClusterSubnetGroups" - }, - "DescribeClusterVersions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ClusterVersions" - }, - "DescribeClusters": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Clusters" - }, - "DescribeDefaultClusterParameters": { - "input_token": "Marker", - "output_token": "DefaultClusterParameters.Marker", - "limit_key": "MaxRecords", - "result_key": "DefaultClusterParameters.Parameters" - }, - "DescribeEventSubscriptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "EventSubscriptionsList" - }, - "DescribeEvents": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "Events" - }, - "DescribeHsmClientCertificates": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "HsmClientCertificates" - }, - "DescribeHsmConfigurations": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "HsmConfigurations" - }, - "DescribeOrderableClusterOptions": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "OrderableClusterOptions" - }, - "DescribeReservedNodeOfferings": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedNodeOfferings" - }, - "DescribeReservedNodes": { - "input_token": "Marker", - "output_token": "Marker", - "limit_key": "MaxRecords", - "result_key": "ReservedNodes" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/service-2.json deleted file mode 100644 index 015ba380..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/service-2.json +++ /dev/null @@ -1,6236 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-12-01", - "endpointPrefix":"redshift", - "protocol":"query", - "serviceFullName":"Amazon Redshift", - "serviceId":"Redshift", - "signatureVersion":"v4", - "uid":"redshift-2012-12-01", - "xmlNamespace":"http://redshift.amazonaws.com/doc/2012-12-01/" - }, - "operations":{ - "AcceptReservedNodeExchange":{ - "name":"AcceptReservedNodeExchange", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptReservedNodeExchangeInputMessage"}, - "output":{ - "shape":"AcceptReservedNodeExchangeOutputMessage", - "resultWrapper":"AcceptReservedNodeExchangeResult" - }, - "errors":[ - {"shape":"ReservedNodeNotFoundFault"}, - {"shape":"InvalidReservedNodeStateFault"}, - {"shape":"ReservedNodeAlreadyMigratedFault"}, - {"shape":"ReservedNodeOfferingNotFoundFault"}, - {"shape":"UnsupportedOperationFault"}, - {"shape":"DependentServiceUnavailableFault"}, - {"shape":"ReservedNodeAlreadyExistsFault"} - ], - "documentation":"

Exchanges a DC1 Reserved Node for a DC2 Reserved Node with no changes to the configuration (term, payment type, or number of nodes) and no additional costs.

" - }, - "AuthorizeClusterSecurityGroupIngress":{ - "name":"AuthorizeClusterSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeClusterSecurityGroupIngressMessage"}, - "output":{ - "shape":"AuthorizeClusterSecurityGroupIngressResult", - "resultWrapper":"AuthorizeClusterSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"InvalidClusterSecurityGroupStateFault"}, - {"shape":"AuthorizationAlreadyExistsFault"}, - {"shape":"AuthorizationQuotaExceededFault"} - ], - "documentation":"

Adds an inbound (ingress) rule to an Amazon Redshift security group. Depending on whether the application accessing your cluster is running on the Internet or an Amazon EC2 instance, you can authorize inbound access to either a Classless Interdomain Routing (CIDR)/Internet Protocol (IP) range or to an Amazon EC2 security group. You can add as many as 20 ingress rules to an Amazon Redshift security group.

If you authorize access to an Amazon EC2 security group, specify EC2SecurityGroupName and EC2SecurityGroupOwnerId. The Amazon EC2 security group and Amazon Redshift cluster must be in the same AWS region.

If you authorize access to a CIDR/IP address range, specify CIDRIP. For an overview of CIDR blocks, see the Wikipedia article on Classless Inter-Domain Routing.

You must also associate the security group with a cluster so that clients running on these IP addresses or the EC2 instance are authorized to connect to the cluster. For information about managing security groups, go to Working with Security Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "AuthorizeSnapshotAccess":{ - "name":"AuthorizeSnapshotAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeSnapshotAccessMessage"}, - "output":{ - "shape":"AuthorizeSnapshotAccessResult", - "resultWrapper":"AuthorizeSnapshotAccessResult" - }, - "errors":[ - {"shape":"ClusterSnapshotNotFoundFault"}, - {"shape":"AuthorizationAlreadyExistsFault"}, - {"shape":"AuthorizationQuotaExceededFault"}, - {"shape":"DependentServiceRequestThrottlingFault"}, - {"shape":"InvalidClusterSnapshotStateFault"}, - {"shape":"LimitExceededFault"} - ], - "documentation":"

Authorizes the specified AWS customer account to restore the specified snapshot.

For more information about working with snapshots, go to Amazon Redshift Snapshots in the Amazon Redshift Cluster Management Guide.

" - }, - "CopyClusterSnapshot":{ - "name":"CopyClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyClusterSnapshotMessage"}, - "output":{ - "shape":"CopyClusterSnapshotResult", - "resultWrapper":"CopyClusterSnapshotResult" - }, - "errors":[ - {"shape":"ClusterSnapshotAlreadyExistsFault"}, - {"shape":"ClusterSnapshotNotFoundFault"}, - {"shape":"InvalidClusterSnapshotStateFault"}, - {"shape":"ClusterSnapshotQuotaExceededFault"} - ], - "documentation":"

Copies the specified automated cluster snapshot to a new manual cluster snapshot. The source must be an automated snapshot and it must be in the available state.

When you delete a cluster, Amazon Redshift deletes any automated snapshots of the cluster. Also, when the retention period of the snapshot expires, Amazon Redshift automatically deletes it. If you want to keep an automated snapshot for a longer period, you can make a manual copy of the snapshot. Manual snapshots are retained until you delete them.

For more information about working with snapshots, go to Amazon Redshift Snapshots in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterMessage"}, - "output":{ - "shape":"CreateClusterResult", - "resultWrapper":"CreateClusterResult" - }, - "errors":[ - {"shape":"ClusterAlreadyExistsFault"}, - {"shape":"InsufficientClusterCapacityFault"}, - {"shape":"ClusterParameterGroupNotFoundFault"}, - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"ClusterQuotaExceededFault"}, - {"shape":"NumberOfNodesQuotaExceededFault"}, - {"shape":"NumberOfNodesPerClusterLimitExceededFault"}, - {"shape":"ClusterSubnetGroupNotFoundFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidClusterSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"HsmClientCertificateNotFoundFault"}, - {"shape":"HsmConfigurationNotFoundFault"}, - {"shape":"InvalidElasticIpFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"DependentServiceRequestThrottlingFault"}, - {"shape":"InvalidClusterTrackFault"} - ], - "documentation":"

Creates a new cluster.

To create a cluster in Virtual Private Cloud (VPC), you must provide a cluster subnet group name. The cluster subnet group identifies the subnets of your VPC that Amazon Redshift uses when creating the cluster. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateClusterParameterGroup":{ - "name":"CreateClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterParameterGroupMessage"}, - "output":{ - "shape":"CreateClusterParameterGroupResult", - "resultWrapper":"CreateClusterParameterGroupResult" - }, - "errors":[ - {"shape":"ClusterParameterGroupQuotaExceededFault"}, - {"shape":"ClusterParameterGroupAlreadyExistsFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates an Amazon Redshift parameter group.

Creating parameter groups is independent of creating clusters. You can associate a cluster with a parameter group when you create the cluster. You can also associate an existing cluster with a parameter group after the cluster is created by using ModifyCluster.

Parameters in the parameter group define specific behavior that applies to the databases you create on the cluster. For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateClusterSecurityGroup":{ - "name":"CreateClusterSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterSecurityGroupMessage"}, - "output":{ - "shape":"CreateClusterSecurityGroupResult", - "resultWrapper":"CreateClusterSecurityGroupResult" - }, - "errors":[ - {"shape":"ClusterSecurityGroupAlreadyExistsFault"}, - {"shape":"ClusterSecurityGroupQuotaExceededFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates a new Amazon Redshift security group. You use security groups to control access to non-VPC clusters.

For information about managing security groups, go to Amazon Redshift Cluster Security Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateClusterSnapshot":{ - "name":"CreateClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterSnapshotMessage"}, - "output":{ - "shape":"CreateClusterSnapshotResult", - "resultWrapper":"CreateClusterSnapshotResult" - }, - "errors":[ - {"shape":"ClusterSnapshotAlreadyExistsFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterNotFoundFault"}, - {"shape":"ClusterSnapshotQuotaExceededFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates a manual snapshot of the specified cluster. The cluster must be in the available state.

For more information about working with snapshots, go to Amazon Redshift Snapshots in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateClusterSubnetGroup":{ - "name":"CreateClusterSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterSubnetGroupMessage"}, - "output":{ - "shape":"CreateClusterSubnetGroupResult", - "resultWrapper":"CreateClusterSubnetGroupResult" - }, - "errors":[ - {"shape":"ClusterSubnetGroupAlreadyExistsFault"}, - {"shape":"ClusterSubnetGroupQuotaExceededFault"}, - {"shape":"ClusterSubnetQuotaExceededFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"}, - {"shape":"DependentServiceRequestThrottlingFault"} - ], - "documentation":"

Creates a new Amazon Redshift subnet group. You must provide a list of one or more subnets in your existing Amazon Virtual Private Cloud (Amazon VPC) when creating Amazon Redshift subnet group.

For information about subnet groups, go to Amazon Redshift Cluster Subnet Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateEventSubscription":{ - "name":"CreateEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEventSubscriptionMessage"}, - "output":{ - "shape":"CreateEventSubscriptionResult", - "resultWrapper":"CreateEventSubscriptionResult" - }, - "errors":[ - {"shape":"EventSubscriptionQuotaExceededFault"}, - {"shape":"SubscriptionAlreadyExistFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionEventIdNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"}, - {"shape":"SubscriptionSeverityNotFoundFault"}, - {"shape":"SourceNotFoundFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates an Amazon Redshift event notification subscription. This action requires an ARN (Amazon Resource Name) of an Amazon SNS topic created by either the Amazon Redshift console, the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the source type, and lists of Amazon Redshift source IDs, event categories, and event severities. Notifications will be sent for all events you want that match those criteria. For example, you can specify source type = cluster, source ID = my-cluster-1 and mycluster2, event categories = Availability, Backup, and severity = ERROR. The subscription will only send notifications for those ERROR events in the Availability and Backup categories for the specified clusters.

If you specify both the source type and source IDs, such as source type = cluster and source identifier = my-cluster-1, notifications will be sent for all the cluster events for my-cluster-1. If you specify a source type but do not specify a source identifier, you will receive notice of the events for the objects of that type in your AWS account. If you do not specify either the SourceType nor the SourceIdentifier, you will be notified of events generated from all Amazon Redshift sources belonging to your AWS account. You must specify a source type if you specify a source ID.

" - }, - "CreateHsmClientCertificate":{ - "name":"CreateHsmClientCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHsmClientCertificateMessage"}, - "output":{ - "shape":"CreateHsmClientCertificateResult", - "resultWrapper":"CreateHsmClientCertificateResult" - }, - "errors":[ - {"shape":"HsmClientCertificateAlreadyExistsFault"}, - {"shape":"HsmClientCertificateQuotaExceededFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates an HSM client certificate that an Amazon Redshift cluster will use to connect to the client's HSM in order to store and retrieve the keys used to encrypt the cluster databases.

The command returns a public key, which you must store in the HSM. In addition to creating the HSM certificate, you must create an Amazon Redshift HSM configuration that provides a cluster the information needed to store and use encryption keys in the HSM. For more information, go to Hardware Security Modules in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateHsmConfiguration":{ - "name":"CreateHsmConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHsmConfigurationMessage"}, - "output":{ - "shape":"CreateHsmConfigurationResult", - "resultWrapper":"CreateHsmConfigurationResult" - }, - "errors":[ - {"shape":"HsmConfigurationAlreadyExistsFault"}, - {"shape":"HsmConfigurationQuotaExceededFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Creates an HSM configuration that contains the information required by an Amazon Redshift cluster to store and use database encryption keys in a Hardware Security Module (HSM). After creating the HSM configuration, you can specify it as a parameter when creating a cluster. The cluster will then store its encryption keys in the HSM.

In addition to creating an HSM configuration, you must also create an HSM client certificate. For more information, go to Hardware Security Modules in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateSnapshotCopyGrant":{ - "name":"CreateSnapshotCopyGrant", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotCopyGrantMessage"}, - "output":{ - "shape":"CreateSnapshotCopyGrantResult", - "resultWrapper":"CreateSnapshotCopyGrantResult" - }, - "errors":[ - {"shape":"SnapshotCopyGrantAlreadyExistsFault"}, - {"shape":"SnapshotCopyGrantQuotaExceededFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"TagLimitExceededFault"}, - {"shape":"InvalidTagFault"}, - {"shape":"DependentServiceRequestThrottlingFault"} - ], - "documentation":"

Creates a snapshot copy grant that permits Amazon Redshift to use a customer master key (CMK) from AWS Key Management Service (AWS KMS) to encrypt copied snapshots in a destination region.

For more information about managing snapshot copy grants, go to Amazon Redshift Database Encryption in the Amazon Redshift Cluster Management Guide.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsMessage"}, - "errors":[ - {"shape":"TagLimitExceededFault"}, - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Adds one or more tags to a specified resource.

A resource can have up to 50 tags. If you try to create more than 50 tags for a resource, you will receive an error and the attempt will fail.

If you specify a key that already exists for the resource, the value for that key will be updated with the new value.

" - }, - "DeleteCluster":{ - "name":"DeleteCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterMessage"}, - "output":{ - "shape":"DeleteClusterResult", - "resultWrapper":"DeleteClusterResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterSnapshotAlreadyExistsFault"}, - {"shape":"ClusterSnapshotQuotaExceededFault"} - ], - "documentation":"

Deletes a previously provisioned cluster. A successful response from the web service indicates that the request was received correctly. Use DescribeClusters to monitor the status of the deletion. The delete operation cannot be canceled or reverted once submitted. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

If you want to shut down the cluster and retain it for future use, set SkipFinalClusterSnapshot to false and specify a name for FinalClusterSnapshotIdentifier. You can later restore this snapshot to resume using the cluster. If a final cluster snapshot is requested, the status of the cluster will be \"final-snapshot\" while the snapshot is being taken, then it's \"deleting\" once Amazon Redshift begins deleting the cluster.

For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

" - }, - "DeleteClusterParameterGroup":{ - "name":"DeleteClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterParameterGroupMessage"}, - "errors":[ - {"shape":"InvalidClusterParameterGroupStateFault"}, - {"shape":"ClusterParameterGroupNotFoundFault"} - ], - "documentation":"

Deletes a specified Amazon Redshift parameter group.

You cannot delete a parameter group if it is associated with a cluster.

" - }, - "DeleteClusterSecurityGroup":{ - "name":"DeleteClusterSecurityGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterSecurityGroupMessage"}, - "errors":[ - {"shape":"InvalidClusterSecurityGroupStateFault"}, - {"shape":"ClusterSecurityGroupNotFoundFault"} - ], - "documentation":"

Deletes an Amazon Redshift security group.

You cannot delete a security group that is associated with any clusters. You cannot delete the default security group.

For information about managing security groups, go to Amazon Redshift Cluster Security Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "DeleteClusterSnapshot":{ - "name":"DeleteClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterSnapshotMessage"}, - "output":{ - "shape":"DeleteClusterSnapshotResult", - "resultWrapper":"DeleteClusterSnapshotResult" - }, - "errors":[ - {"shape":"InvalidClusterSnapshotStateFault"}, - {"shape":"ClusterSnapshotNotFoundFault"} - ], - "documentation":"

Deletes the specified manual snapshot. The snapshot must be in the available state, with no other users authorized to access the snapshot.

Unlike automated snapshots, manual snapshots are retained even after you delete your cluster. Amazon Redshift does not delete your manual snapshots. You must delete manual snapshot explicitly to avoid getting charged. If other accounts are authorized to access the snapshot, you must revoke all of the authorizations before you can delete the snapshot.

" - }, - "DeleteClusterSubnetGroup":{ - "name":"DeleteClusterSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteClusterSubnetGroupMessage"}, - "errors":[ - {"shape":"InvalidClusterSubnetGroupStateFault"}, - {"shape":"InvalidClusterSubnetStateFault"}, - {"shape":"ClusterSubnetGroupNotFoundFault"} - ], - "documentation":"

Deletes the specified cluster subnet group.

" - }, - "DeleteEventSubscription":{ - "name":"DeleteEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEventSubscriptionMessage"}, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"InvalidSubscriptionStateFault"} - ], - "documentation":"

Deletes an Amazon Redshift event notification subscription.

" - }, - "DeleteHsmClientCertificate":{ - "name":"DeleteHsmClientCertificate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHsmClientCertificateMessage"}, - "errors":[ - {"shape":"InvalidHsmClientCertificateStateFault"}, - {"shape":"HsmClientCertificateNotFoundFault"} - ], - "documentation":"

Deletes the specified HSM client certificate.

" - }, - "DeleteHsmConfiguration":{ - "name":"DeleteHsmConfiguration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteHsmConfigurationMessage"}, - "errors":[ - {"shape":"InvalidHsmConfigurationStateFault"}, - {"shape":"HsmConfigurationNotFoundFault"} - ], - "documentation":"

Deletes the specified Amazon Redshift HSM configuration.

" - }, - "DeleteSnapshotCopyGrant":{ - "name":"DeleteSnapshotCopyGrant", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotCopyGrantMessage"}, - "errors":[ - {"shape":"InvalidSnapshotCopyGrantStateFault"}, - {"shape":"SnapshotCopyGrantNotFoundFault"} - ], - "documentation":"

Deletes the specified snapshot copy grant.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsMessage"}, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Deletes a tag or tags from a resource. You must provide the ARN of the resource from which you want to delete the tag or tags.

" - }, - "DescribeClusterDbRevisions":{ - "name":"DescribeClusterDbRevisions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterDbRevisionsMessage"}, - "output":{ - "shape":"ClusterDbRevisionsMessage", - "resultWrapper":"DescribeClusterDbRevisionsResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Returns an array of ClusterDbRevision objects.

" - }, - "DescribeClusterParameterGroups":{ - "name":"DescribeClusterParameterGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterParameterGroupsMessage"}, - "output":{ - "shape":"ClusterParameterGroupsMessage", - "resultWrapper":"DescribeClusterParameterGroupsResult" - }, - "errors":[ - {"shape":"ClusterParameterGroupNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns a list of Amazon Redshift parameter groups, including parameter groups you created and the default parameter group. For each parameter group, the response includes the parameter group name, description, and parameter group family name. You can optionally specify a name to retrieve the description of a specific parameter group.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all parameter groups that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all parameter groups that have any combination of those values are returned.

If both tag keys and values are omitted from the request, parameter groups are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeClusterParameters":{ - "name":"DescribeClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterParametersMessage"}, - "output":{ - "shape":"ClusterParameterGroupDetails", - "resultWrapper":"DescribeClusterParametersResult" - }, - "errors":[ - {"shape":"ClusterParameterGroupNotFoundFault"} - ], - "documentation":"

Returns a detailed list of parameters contained within the specified Amazon Redshift parameter group. For each parameter the response includes information such as parameter name, description, data type, value, whether the parameter value is modifiable, and so on.

You can specify source filter to retrieve parameters of only specific type. For example, to retrieve parameters that were modified by a user action such as from ModifyClusterParameterGroup, you can specify source equal to user.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeClusterSecurityGroups":{ - "name":"DescribeClusterSecurityGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterSecurityGroupsMessage"}, - "output":{ - "shape":"ClusterSecurityGroupMessage", - "resultWrapper":"DescribeClusterSecurityGroupsResult" - }, - "errors":[ - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns information about Amazon Redshift security groups. If the name of a security group is specified, the response will contain only information about only that security group.

For information about managing security groups, go to Amazon Redshift Cluster Security Groups in the Amazon Redshift Cluster Management Guide.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all security groups that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all security groups that have any combination of those values are returned.

If both tag keys and values are omitted from the request, security groups are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeClusterSnapshots":{ - "name":"DescribeClusterSnapshots", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterSnapshotsMessage"}, - "output":{ - "shape":"SnapshotMessage", - "resultWrapper":"DescribeClusterSnapshotsResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"ClusterSnapshotNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns one or more snapshot objects, which contain metadata about your cluster snapshots. By default, this operation returns information about all snapshots of all clusters that are owned by you AWS customer account. No information is returned for snapshots owned by inactive AWS customer accounts.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all snapshots that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all snapshots that have any combination of those values are returned. Only snapshots that you own are returned in the response; shared snapshots are not returned with the tag key and tag value request parameters.

If both tag keys and values are omitted from the request, snapshots are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeClusterSubnetGroups":{ - "name":"DescribeClusterSubnetGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterSubnetGroupsMessage"}, - "output":{ - "shape":"ClusterSubnetGroupMessage", - "resultWrapper":"DescribeClusterSubnetGroupsResult" - }, - "errors":[ - {"shape":"ClusterSubnetGroupNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns one or more cluster subnet group objects, which contain metadata about your cluster subnet groups. By default, this operation returns information about all cluster subnet groups that are defined in you AWS account.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all subnet groups that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all subnet groups that have any combination of those values are returned.

If both tag keys and values are omitted from the request, subnet groups are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeClusterTracks":{ - "name":"DescribeClusterTracks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterTracksMessage"}, - "output":{ - "shape":"TrackListMessage", - "resultWrapper":"DescribeClusterTracksResult" - }, - "errors":[ - {"shape":"InvalidClusterTrackFault"}, - {"shape":"UnauthorizedOperation"} - ], - "documentation":"

Returns a list of all the available maintenance tracks.

" - }, - "DescribeClusterVersions":{ - "name":"DescribeClusterVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterVersionsMessage"}, - "output":{ - "shape":"ClusterVersionsMessage", - "resultWrapper":"DescribeClusterVersionsResult" - }, - "documentation":"

Returns descriptions of the available Amazon Redshift cluster versions. You can call this operation even before creating any clusters to learn more about the Amazon Redshift versions. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeClusters":{ - "name":"DescribeClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClustersMessage"}, - "output":{ - "shape":"ClustersMessage", - "resultWrapper":"DescribeClustersResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns properties of provisioned clusters including general cluster properties, cluster database properties, maintenance and backup properties, and security and access properties. This operation supports pagination. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all clusters that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all clusters that have any combination of those values are returned.

If both tag keys and values are omitted from the request, clusters are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeDefaultClusterParameters":{ - "name":"DescribeDefaultClusterParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDefaultClusterParametersMessage"}, - "output":{ - "shape":"DescribeDefaultClusterParametersResult", - "resultWrapper":"DescribeDefaultClusterParametersResult" - }, - "documentation":"

Returns a list of parameter settings for the specified parameter group family.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeEventCategories":{ - "name":"DescribeEventCategories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventCategoriesMessage"}, - "output":{ - "shape":"EventCategoriesMessage", - "resultWrapper":"DescribeEventCategoriesResult" - }, - "documentation":"

Displays a list of event categories for all event source types, or for a specified source type. For a list of the event categories and source types, go to Amazon Redshift Event Notifications.

" - }, - "DescribeEventSubscriptions":{ - "name":"DescribeEventSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventSubscriptionsMessage"}, - "output":{ - "shape":"EventSubscriptionsMessage", - "resultWrapper":"DescribeEventSubscriptionsResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Lists descriptions of all the Amazon Redshift event notification subscriptions for a customer account. If you specify a subscription name, lists the description for that subscription.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all event notification subscriptions that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all subscriptions that have any combination of those values are returned.

If both tag keys and values are omitted from the request, subscriptions are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeEvents":{ - "name":"DescribeEvents", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEventsMessage"}, - "output":{ - "shape":"EventsMessage", - "resultWrapper":"DescribeEventsResult" - }, - "documentation":"

Returns events related to clusters, security groups, snapshots, and parameter groups for the past 14 days. Events specific to a particular cluster, security group, snapshot or parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

" - }, - "DescribeHsmClientCertificates":{ - "name":"DescribeHsmClientCertificates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHsmClientCertificatesMessage"}, - "output":{ - "shape":"HsmClientCertificateMessage", - "resultWrapper":"DescribeHsmClientCertificatesResult" - }, - "errors":[ - {"shape":"HsmClientCertificateNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns information about the specified HSM client certificate. If no certificate ID is specified, returns information about all the HSM certificates owned by your AWS customer account.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all HSM client certificates that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all HSM client certificates that have any combination of those values are returned.

If both tag keys and values are omitted from the request, HSM client certificates are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeHsmConfigurations":{ - "name":"DescribeHsmConfigurations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHsmConfigurationsMessage"}, - "output":{ - "shape":"HsmConfigurationMessage", - "resultWrapper":"DescribeHsmConfigurationsResult" - }, - "errors":[ - {"shape":"HsmConfigurationNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns information about the specified Amazon Redshift HSM configuration. If no configuration ID is specified, returns information about all the HSM configurations owned by your AWS customer account.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all HSM connections that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all HSM connections that have any combination of those values are returned.

If both tag keys and values are omitted from the request, HSM connections are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DescribeLoggingStatus":{ - "name":"DescribeLoggingStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeLoggingStatusMessage"}, - "output":{ - "shape":"LoggingStatus", - "resultWrapper":"DescribeLoggingStatusResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Describes whether information, such as queries and connection attempts, is being logged for the specified Amazon Redshift cluster.

" - }, - "DescribeOrderableClusterOptions":{ - "name":"DescribeOrderableClusterOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrderableClusterOptionsMessage"}, - "output":{ - "shape":"OrderableClusterOptionsMessage", - "resultWrapper":"DescribeOrderableClusterOptionsResult" - }, - "documentation":"

Returns a list of orderable cluster options. Before you create a new cluster you can use this operation to find what options are available, such as the EC2 Availability Zones (AZ) in the specific AWS region that you can specify, and the node types you can request. The node types differ by available storage, memory, CPU and price. With the cost involved you might want to obtain a list of cluster options in the specific region and specify values when creating a cluster. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeReservedNodeOfferings":{ - "name":"DescribeReservedNodeOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedNodeOfferingsMessage"}, - "output":{ - "shape":"ReservedNodeOfferingsMessage", - "resultWrapper":"DescribeReservedNodeOfferingsResult" - }, - "errors":[ - {"shape":"ReservedNodeOfferingNotFoundFault"}, - {"shape":"UnsupportedOperationFault"}, - {"shape":"DependentServiceUnavailableFault"} - ], - "documentation":"

Returns a list of the available reserved node offerings by Amazon Redshift with their descriptions including the node type, the fixed and recurring costs of reserving the node and duration the node will be reserved for you. These descriptions help you determine which reserve node offering you want to purchase. You then use the unique offering ID in you call to PurchaseReservedNodeOffering to reserve one or more nodes for your Amazon Redshift cluster.

For more information about reserved node offerings, go to Purchasing Reserved Nodes in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeReservedNodes":{ - "name":"DescribeReservedNodes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReservedNodesMessage"}, - "output":{ - "shape":"ReservedNodesMessage", - "resultWrapper":"DescribeReservedNodesResult" - }, - "errors":[ - {"shape":"ReservedNodeNotFoundFault"}, - {"shape":"DependentServiceUnavailableFault"} - ], - "documentation":"

Returns the descriptions of the reserved nodes.

" - }, - "DescribeResize":{ - "name":"DescribeResize", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResizeMessage"}, - "output":{ - "shape":"ResizeProgressMessage", - "resultWrapper":"DescribeResizeResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"ResizeNotFoundFault"} - ], - "documentation":"

Returns information about the last resize operation for the specified cluster. If no resize operation has ever been initiated for the specified cluster, a HTTP 404 error is returned. If a resize operation was initiated and completed, the status of the resize remains as SUCCEEDED until the next resize.

A resize operation can be requested using ModifyCluster and specifying a different number or type of nodes for the cluster.

" - }, - "DescribeSnapshotCopyGrants":{ - "name":"DescribeSnapshotCopyGrants", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotCopyGrantsMessage"}, - "output":{ - "shape":"SnapshotCopyGrantMessage", - "resultWrapper":"DescribeSnapshotCopyGrantsResult" - }, - "errors":[ - {"shape":"SnapshotCopyGrantNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns a list of snapshot copy grants owned by the AWS account in the destination region.

For more information about managing snapshot copy grants, go to Amazon Redshift Database Encryption in the Amazon Redshift Cluster Management Guide.

" - }, - "DescribeTableRestoreStatus":{ - "name":"DescribeTableRestoreStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTableRestoreStatusMessage"}, - "output":{ - "shape":"TableRestoreStatusMessage", - "resultWrapper":"DescribeTableRestoreStatusResult" - }, - "errors":[ - {"shape":"TableRestoreNotFoundFault"}, - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Lists the status of one or more table restore requests made using the RestoreTableFromClusterSnapshot API action. If you don't specify a value for the TableRestoreRequestId parameter, then DescribeTableRestoreStatus returns the status of all table restore requests ordered by the date and time of the request in ascending order. Otherwise DescribeTableRestoreStatus returns the status of the table specified by TableRestoreRequestId.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsMessage"}, - "output":{ - "shape":"TaggedResourceListMessage", - "resultWrapper":"DescribeTagsResult" - }, - "errors":[ - {"shape":"ResourceNotFoundFault"}, - {"shape":"InvalidTagFault"} - ], - "documentation":"

Returns a list of tags. You can return tags from a specific resource by specifying an ARN, or you can return all tags for a given type of resource, such as clusters, snapshots, and so on.

The following are limitations for DescribeTags:

  • You cannot specify an ARN and a resource-type value together in the same request.

  • You cannot use the MaxRecords and Marker parameters together with the ARN parameter.

  • The MaxRecords parameter can be a range from 10 to 50 results to return in a request.

If you specify both tag keys and tag values in the same request, Amazon Redshift returns all resources that match any combination of the specified keys and values. For example, if you have owner and environment for tag keys, and admin and test for tag values, all resources that have any combination of those values are returned.

If both tag keys and values are omitted from the request, resources are returned regardless of whether they have tag keys or values associated with them.

" - }, - "DisableLogging":{ - "name":"DisableLogging", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableLoggingMessage"}, - "output":{ - "shape":"LoggingStatus", - "resultWrapper":"DisableLoggingResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Stops logging information, such as queries and connection attempts, for the specified Amazon Redshift cluster.

" - }, - "DisableSnapshotCopy":{ - "name":"DisableSnapshotCopy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableSnapshotCopyMessage"}, - "output":{ - "shape":"DisableSnapshotCopyResult", - "resultWrapper":"DisableSnapshotCopyResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"SnapshotCopyAlreadyDisabledFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"UnauthorizedOperation"} - ], - "documentation":"

Disables the automatic copying of snapshots from one region to another region for a specified cluster.

If your cluster and its snapshots are encrypted using a customer master key (CMK) from AWS KMS, use DeleteSnapshotCopyGrant to delete the grant that grants Amazon Redshift permission to the CMK in the destination region.

" - }, - "EnableLogging":{ - "name":"EnableLogging", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableLoggingMessage"}, - "output":{ - "shape":"LoggingStatus", - "resultWrapper":"EnableLoggingResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"BucketNotFoundFault"}, - {"shape":"InsufficientS3BucketPolicyFault"}, - {"shape":"InvalidS3KeyPrefixFault"}, - {"shape":"InvalidS3BucketNameFault"} - ], - "documentation":"

Starts logging information, such as queries and connection attempts, for the specified Amazon Redshift cluster.

" - }, - "EnableSnapshotCopy":{ - "name":"EnableSnapshotCopy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableSnapshotCopyMessage"}, - "output":{ - "shape":"EnableSnapshotCopyResult", - "resultWrapper":"EnableSnapshotCopyResult" - }, - "errors":[ - {"shape":"IncompatibleOrderableOptions"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterNotFoundFault"}, - {"shape":"CopyToRegionDisabledFault"}, - {"shape":"SnapshotCopyAlreadyEnabledFault"}, - {"shape":"UnknownSnapshotCopyRegionFault"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"SnapshotCopyGrantNotFoundFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"DependentServiceRequestThrottlingFault"} - ], - "documentation":"

Enables the automatic copy of snapshots from one region to another region for a specified cluster.

" - }, - "GetClusterCredentials":{ - "name":"GetClusterCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetClusterCredentialsMessage"}, - "output":{ - "shape":"ClusterCredentials", - "resultWrapper":"GetClusterCredentialsResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"UnsupportedOperationFault"} - ], - "documentation":"

Returns a database user name and temporary password with temporary authorization to log on to an Amazon Redshift database. The action returns the database user name prefixed with IAM: if AutoCreate is False or IAMA: if AutoCreate is True. You can optionally specify one or more database user groups that the user will join at log on. By default, the temporary credentials expire in 900 seconds. You can optionally specify a duration between 900 seconds (15 minutes) and 3600 seconds (60 minutes). For more information, see Using IAM Authentication to Generate Database User Credentials in the Amazon Redshift Cluster Management Guide.

The AWS Identity and Access Management (IAM)user or role that executes GetClusterCredentials must have an IAM policy attached that allows access to all necessary actions and resources. For more information about permissions, see Resource Policies for GetClusterCredentials in the Amazon Redshift Cluster Management Guide.

If the DbGroups parameter is specified, the IAM policy must allow the redshift:JoinGroup action with access to the listed dbgroups.

In addition, if the AutoCreate parameter is set to True, then the policy must include the redshift:CreateClusterUser privilege.

If the DbName parameter is specified, the IAM policy must allow access to the resource dbname for the specified database name.

" - }, - "GetReservedNodeExchangeOfferings":{ - "name":"GetReservedNodeExchangeOfferings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReservedNodeExchangeOfferingsInputMessage"}, - "output":{ - "shape":"GetReservedNodeExchangeOfferingsOutputMessage", - "resultWrapper":"GetReservedNodeExchangeOfferingsResult" - }, - "errors":[ - {"shape":"ReservedNodeNotFoundFault"}, - {"shape":"InvalidReservedNodeStateFault"}, - {"shape":"ReservedNodeAlreadyMigratedFault"}, - {"shape":"ReservedNodeOfferingNotFoundFault"}, - {"shape":"UnsupportedOperationFault"}, - {"shape":"DependentServiceUnavailableFault"} - ], - "documentation":"

Returns an array of DC2 ReservedNodeOfferings that matches the payment type, term, and usage price of the given DC1 reserved node.

" - }, - "ModifyCluster":{ - "name":"ModifyCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyClusterMessage"}, - "output":{ - "shape":"ModifyClusterResult", - "resultWrapper":"ModifyClusterResult" - }, - "errors":[ - {"shape":"InvalidClusterStateFault"}, - {"shape":"InvalidClusterSecurityGroupStateFault"}, - {"shape":"ClusterNotFoundFault"}, - {"shape":"NumberOfNodesQuotaExceededFault"}, - {"shape":"NumberOfNodesPerClusterLimitExceededFault"}, - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"ClusterParameterGroupNotFoundFault"}, - {"shape":"InsufficientClusterCapacityFault"}, - {"shape":"UnsupportedOptionFault"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"HsmClientCertificateNotFoundFault"}, - {"shape":"HsmConfigurationNotFoundFault"}, - {"shape":"ClusterAlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"DependentServiceRequestThrottlingFault"}, - {"shape":"InvalidElasticIpFault"}, - {"shape":"TableLimitExceededFault"}, - {"shape":"InvalidClusterTrackFault"} - ], - "documentation":"

Modifies the settings for a cluster. For example, you can add another security or parameter group, update the preferred maintenance window, or change the master user password. Resetting a cluster password or modifying the security groups associated with a cluster do not need a reboot. However, modifying a parameter group requires a reboot for parameters to take effect. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

You can also change node type and the number of nodes to scale up or down the cluster. When resizing a cluster, you must specify both the number of nodes and the node type even if one of the parameters does not change.

" - }, - "ModifyClusterDbRevision":{ - "name":"ModifyClusterDbRevision", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyClusterDbRevisionMessage"}, - "output":{ - "shape":"ModifyClusterDbRevisionResult", - "resultWrapper":"ModifyClusterDbRevisionResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"ClusterOnLatestRevisionFault"}, - {"shape":"InvalidClusterStateFault"} - ], - "documentation":"

Modifies the database revision of a cluster. The database revision is a unique revision of the database running in a cluster.

" - }, - "ModifyClusterIamRoles":{ - "name":"ModifyClusterIamRoles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyClusterIamRolesMessage"}, - "output":{ - "shape":"ModifyClusterIamRolesResult", - "resultWrapper":"ModifyClusterIamRolesResult" - }, - "errors":[ - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Modifies the list of AWS Identity and Access Management (IAM) roles that can be used by the cluster to access other AWS services.

A cluster can have up to 10 IAM roles associated at any time.

" - }, - "ModifyClusterParameterGroup":{ - "name":"ModifyClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyClusterParameterGroupMessage"}, - "output":{ - "shape":"ClusterParameterGroupNameMessage", - "resultWrapper":"ModifyClusterParameterGroupResult" - }, - "errors":[ - {"shape":"ClusterParameterGroupNotFoundFault"}, - {"shape":"InvalidClusterParameterGroupStateFault"} - ], - "documentation":"

Modifies the parameters of a parameter group.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "ModifyClusterSubnetGroup":{ - "name":"ModifyClusterSubnetGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyClusterSubnetGroupMessage"}, - "output":{ - "shape":"ModifyClusterSubnetGroupResult", - "resultWrapper":"ModifyClusterSubnetGroupResult" - }, - "errors":[ - {"shape":"ClusterSubnetGroupNotFoundFault"}, - {"shape":"ClusterSubnetQuotaExceededFault"}, - {"shape":"SubnetAlreadyInUse"}, - {"shape":"InvalidSubnet"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"DependentServiceRequestThrottlingFault"} - ], - "documentation":"

Modifies a cluster subnet group to include the specified list of VPC subnets. The operation replaces the existing list of subnets with the new list of subnets.

" - }, - "ModifyEventSubscription":{ - "name":"ModifyEventSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyEventSubscriptionMessage"}, - "output":{ - "shape":"ModifyEventSubscriptionResult", - "resultWrapper":"ModifyEventSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionNotFoundFault"}, - {"shape":"SNSInvalidTopicFault"}, - {"shape":"SNSNoAuthorizationFault"}, - {"shape":"SNSTopicArnNotFoundFault"}, - {"shape":"SubscriptionEventIdNotFoundFault"}, - {"shape":"SubscriptionCategoryNotFoundFault"}, - {"shape":"SubscriptionSeverityNotFoundFault"}, - {"shape":"SourceNotFoundFault"}, - {"shape":"InvalidSubscriptionStateFault"} - ], - "documentation":"

Modifies an existing Amazon Redshift event notification subscription.

" - }, - "ModifySnapshotCopyRetentionPeriod":{ - "name":"ModifySnapshotCopyRetentionPeriod", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifySnapshotCopyRetentionPeriodMessage"}, - "output":{ - "shape":"ModifySnapshotCopyRetentionPeriodResult", - "resultWrapper":"ModifySnapshotCopyRetentionPeriodResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"SnapshotCopyDisabledFault"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"InvalidClusterStateFault"} - ], - "documentation":"

Modifies the number of days to retain automated snapshots in the destination region after they are copied from the source region.

" - }, - "PurchaseReservedNodeOffering":{ - "name":"PurchaseReservedNodeOffering", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurchaseReservedNodeOfferingMessage"}, - "output":{ - "shape":"PurchaseReservedNodeOfferingResult", - "resultWrapper":"PurchaseReservedNodeOfferingResult" - }, - "errors":[ - {"shape":"ReservedNodeOfferingNotFoundFault"}, - {"shape":"ReservedNodeAlreadyExistsFault"}, - {"shape":"ReservedNodeQuotaExceededFault"}, - {"shape":"UnsupportedOperationFault"} - ], - "documentation":"

Allows you to purchase reserved nodes. Amazon Redshift offers a predefined set of reserved node offerings. You can purchase one or more of the offerings. You can call the DescribeReservedNodeOfferings API to obtain the available reserved node offerings. You can call this API by providing a specific reserved node offering and the number of nodes you want to reserve.

For more information about reserved node offerings, go to Purchasing Reserved Nodes in the Amazon Redshift Cluster Management Guide.

" - }, - "RebootCluster":{ - "name":"RebootCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootClusterMessage"}, - "output":{ - "shape":"RebootClusterResult", - "resultWrapper":"RebootClusterResult" - }, - "errors":[ - {"shape":"InvalidClusterStateFault"}, - {"shape":"ClusterNotFoundFault"} - ], - "documentation":"

Reboots a cluster. This action is taken as soon as possible. It results in a momentary outage to the cluster, during which the cluster status is set to rebooting. A cluster event is created when the reboot is completed. Any pending cluster modifications (see ModifyCluster) are applied at this reboot. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

" - }, - "ResetClusterParameterGroup":{ - "name":"ResetClusterParameterGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetClusterParameterGroupMessage"}, - "output":{ - "shape":"ClusterParameterGroupNameMessage", - "resultWrapper":"ResetClusterParameterGroupResult" - }, - "errors":[ - {"shape":"InvalidClusterParameterGroupStateFault"}, - {"shape":"ClusterParameterGroupNotFoundFault"} - ], - "documentation":"

Sets one or more parameters of the specified parameter group to their default values and sets the source values of the parameters to \"engine-default\". To reset the entire parameter group specify the ResetAllParameters parameter. For parameter changes to take effect you must reboot any associated clusters.

" - }, - "RestoreFromClusterSnapshot":{ - "name":"RestoreFromClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreFromClusterSnapshotMessage"}, - "output":{ - "shape":"RestoreFromClusterSnapshotResult", - "resultWrapper":"RestoreFromClusterSnapshotResult" - }, - "errors":[ - {"shape":"AccessToSnapshotDeniedFault"}, - {"shape":"ClusterAlreadyExistsFault"}, - {"shape":"ClusterSnapshotNotFoundFault"}, - {"shape":"ClusterQuotaExceededFault"}, - {"shape":"InsufficientClusterCapacityFault"}, - {"shape":"InvalidClusterSnapshotStateFault"}, - {"shape":"InvalidRestoreFault"}, - {"shape":"NumberOfNodesQuotaExceededFault"}, - {"shape":"NumberOfNodesPerClusterLimitExceededFault"}, - {"shape":"InvalidVPCNetworkStateFault"}, - {"shape":"InvalidClusterSubnetGroupStateFault"}, - {"shape":"InvalidSubnet"}, - {"shape":"ClusterSubnetGroupNotFoundFault"}, - {"shape":"UnauthorizedOperation"}, - {"shape":"HsmClientCertificateNotFoundFault"}, - {"shape":"HsmConfigurationNotFoundFault"}, - {"shape":"InvalidElasticIpFault"}, - {"shape":"ClusterParameterGroupNotFoundFault"}, - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"DependentServiceRequestThrottlingFault"}, - {"shape":"InvalidClusterTrackFault"} - ], - "documentation":"

Creates a new cluster from a snapshot. By default, Amazon Redshift creates the resulting cluster with the same configuration as the original cluster from which the snapshot was created, except that the new cluster is created with the default cluster security and parameter groups. After Amazon Redshift creates the cluster, you can use the ModifyCluster API to associate a different security group and different parameter group with the restored cluster. If you are using a DS node type, you can also choose to change to another DS node type of the same size during restore.

If you restore a cluster into a VPC, you must provide a cluster subnet group where you want the cluster restored.

For more information about working with snapshots, go to Amazon Redshift Snapshots in the Amazon Redshift Cluster Management Guide.

" - }, - "RestoreTableFromClusterSnapshot":{ - "name":"RestoreTableFromClusterSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreTableFromClusterSnapshotMessage"}, - "output":{ - "shape":"RestoreTableFromClusterSnapshotResult", - "resultWrapper":"RestoreTableFromClusterSnapshotResult" - }, - "errors":[ - {"shape":"ClusterSnapshotNotFoundFault"}, - {"shape":"InProgressTableRestoreQuotaExceededFault"}, - {"shape":"InvalidClusterSnapshotStateFault"}, - {"shape":"InvalidTableRestoreArgumentFault"}, - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"UnsupportedOperationFault"} - ], - "documentation":"

Creates a new table from a table in an Amazon Redshift cluster snapshot. You must create the new table within the Amazon Redshift cluster that the snapshot was taken from.

You cannot use RestoreTableFromClusterSnapshot to restore a table with the same name as an existing table in an Amazon Redshift cluster. That is, you cannot overwrite an existing table in a cluster with a restored table. If you want to replace your original table with a new, restored table, then rename or drop your original table before you call RestoreTableFromClusterSnapshot. When you have renamed your original table, then you can pass the original name of the table as the NewTableName parameter value in the call to RestoreTableFromClusterSnapshot. This way, you can replace the original table with the table created from the snapshot.

" - }, - "RevokeClusterSecurityGroupIngress":{ - "name":"RevokeClusterSecurityGroupIngress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeClusterSecurityGroupIngressMessage"}, - "output":{ - "shape":"RevokeClusterSecurityGroupIngressResult", - "resultWrapper":"RevokeClusterSecurityGroupIngressResult" - }, - "errors":[ - {"shape":"ClusterSecurityGroupNotFoundFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"InvalidClusterSecurityGroupStateFault"} - ], - "documentation":"

Revokes an ingress rule in an Amazon Redshift security group for a previously authorized IP range or Amazon EC2 security group. To add an ingress rule, see AuthorizeClusterSecurityGroupIngress. For information about managing security groups, go to Amazon Redshift Cluster Security Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "RevokeSnapshotAccess":{ - "name":"RevokeSnapshotAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeSnapshotAccessMessage"}, - "output":{ - "shape":"RevokeSnapshotAccessResult", - "resultWrapper":"RevokeSnapshotAccessResult" - }, - "errors":[ - {"shape":"AccessToSnapshotDeniedFault"}, - {"shape":"AuthorizationNotFoundFault"}, - {"shape":"ClusterSnapshotNotFoundFault"} - ], - "documentation":"

Removes the ability of the specified AWS customer account to restore the specified snapshot. If the account is currently restoring the snapshot, the restore will run to completion.

For more information about working with snapshots, go to Amazon Redshift Snapshots in the Amazon Redshift Cluster Management Guide.

" - }, - "RotateEncryptionKey":{ - "name":"RotateEncryptionKey", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RotateEncryptionKeyMessage"}, - "output":{ - "shape":"RotateEncryptionKeyResult", - "resultWrapper":"RotateEncryptionKeyResult" - }, - "errors":[ - {"shape":"ClusterNotFoundFault"}, - {"shape":"InvalidClusterStateFault"}, - {"shape":"DependentServiceRequestThrottlingFault"} - ], - "documentation":"

Rotates the encryption keys for a cluster.

" - } - }, - "shapes":{ - "AcceptReservedNodeExchangeInputMessage":{ - "type":"structure", - "required":[ - "ReservedNodeId", - "TargetReservedNodeOfferingId" - ], - "members":{ - "ReservedNodeId":{ - "shape":"String", - "documentation":"

A string representing the node identifier of the DC1 Reserved Node to be exchanged.

" - }, - "TargetReservedNodeOfferingId":{ - "shape":"String", - "documentation":"

The unique identifier of the DC2 Reserved Node offering to be used for the exchange. You can obtain the value for the parameter by calling GetReservedNodeExchangeOfferings

" - } - } - }, - "AcceptReservedNodeExchangeOutputMessage":{ - "type":"structure", - "members":{ - "ExchangedReservedNode":{"shape":"ReservedNode"} - } - }, - "AccessToSnapshotDeniedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The owner of the specified snapshot has not authorized your account to access the snapshot.

", - "error":{ - "code":"AccessToSnapshotDenied", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AccountWithRestoreAccess":{ - "type":"structure", - "members":{ - "AccountId":{ - "shape":"String", - "documentation":"

The identifier of an AWS customer account authorized to restore a snapshot.

" - }, - "AccountAlias":{ - "shape":"String", - "documentation":"

The identifier of an AWS support account authorized to restore a snapshot. For AWS support, the identifier is amazon-redshift-support.

" - } - }, - "documentation":"

Describes an AWS customer account authorized to restore a snapshot.

" - }, - "AccountsWithRestoreAccessList":{ - "type":"list", - "member":{ - "shape":"AccountWithRestoreAccess", - "locationName":"AccountWithRestoreAccess" - } - }, - "AuthorizationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified CIDR block or EC2 security group is already authorized for the specified cluster security group.

", - "error":{ - "code":"AuthorizationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthorizationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified CIDR IP range or EC2 security group is not authorized for the specified cluster security group.

", - "error":{ - "code":"AuthorizationNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "AuthorizationQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The authorization quota for the cluster security group has been reached.

", - "error":{ - "code":"AuthorizationQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AuthorizeClusterSecurityGroupIngressMessage":{ - "type":"structure", - "required":["ClusterSecurityGroupName"], - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the security group to which the ingress rule is added.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range to be added the Amazon Redshift security group.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The EC2 security group to be added the Amazon Redshift security group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the owner of the security group specified by the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value.

Example: 111122223333

" - } - }, - "documentation":"

" - }, - "AuthorizeClusterSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "ClusterSecurityGroup":{"shape":"ClusterSecurityGroup"} - } - }, - "AuthorizeSnapshotAccessMessage":{ - "type":"structure", - "required":[ - "SnapshotIdentifier", - "AccountWithRestoreAccess" - ], - "members":{ - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the snapshot the account is authorized to restore.

" - }, - "SnapshotClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster the snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

" - }, - "AccountWithRestoreAccess":{ - "shape":"String", - "documentation":"

The identifier of the AWS customer account authorized to restore the specified snapshot.

To share a snapshot with AWS support, specify amazon-redshift-support.

" - } - }, - "documentation":"

" - }, - "AuthorizeSnapshotAccessResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "AvailabilityZone":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the availability zone.

" - }, - "SupportedPlatforms":{"shape":"SupportedPlatformsList"} - }, - "documentation":"

Describes an availability zone.

", - "wrapper":true - }, - "AvailabilityZoneList":{ - "type":"list", - "member":{ - "shape":"AvailabilityZone", - "locationName":"AvailabilityZone" - } - }, - "Boolean":{"type":"boolean"}, - "BooleanOptional":{"type":"boolean"}, - "BucketNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Could not find the specified S3 bucket.

", - "error":{ - "code":"BucketNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Cluster":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type for the nodes in the cluster.

" - }, - "ClusterStatus":{ - "shape":"String", - "documentation":"

The current state of the cluster. Possible values are the following:

  • available

  • creating

  • deleting

  • final-snapshot

  • hardware-failure

  • incompatible-hsm

  • incompatible-network

  • incompatible-parameters

  • incompatible-restore

  • modifying

  • rebooting

  • renaming

  • resizing

  • rotating-keys

  • storage-full

  • updating-hsm

" - }, - "ModifyStatus":{ - "shape":"String", - "documentation":"

The status of a modify operation, if any, initiated for the cluster.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The master user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The name of the initial database that was created when the cluster was created. This same name is returned for the life of the cluster. If an initial database was not specified, a database named devdev was created by default.

" - }, - "Endpoint":{ - "shape":"Endpoint", - "documentation":"

The connection endpoint.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The date and time that the cluster was created.

" - }, - "AutomatedSnapshotRetentionPeriod":{ - "shape":"Integer", - "documentation":"

The number of days that automatic cluster snapshots are retained.

" - }, - "ClusterSecurityGroups":{ - "shape":"ClusterSecurityGroupMembershipList", - "documentation":"

A list of cluster security group that are associated with the cluster. Each security group is represented by an element that contains ClusterSecurityGroup.Name and ClusterSecurityGroup.Status subelements.

Cluster security groups are used when the cluster is not created in an Amazon Virtual Private Cloud (VPC). Clusters that are created in a VPC use VPC security groups, which are listed by the VpcSecurityGroups parameter.

" - }, - "VpcSecurityGroups":{ - "shape":"VpcSecurityGroupMembershipList", - "documentation":"

A list of Amazon Virtual Private Cloud (Amazon VPC) security groups that are associated with the cluster. This parameter is returned only if the cluster is in a VPC.

" - }, - "ClusterParameterGroups":{ - "shape":"ClusterParameterGroupStatusList", - "documentation":"

The list of cluster parameter groups that are associated with this cluster. Each parameter group in the list is returned with its status.

" - }, - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group that is associated with the cluster. This parameter is valid only when the cluster is in a VPC.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The identifier of the VPC the cluster is in, if the cluster is in a VPC.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The name of the Availability Zone in which the cluster is located.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.

" - }, - "PendingModifiedValues":{ - "shape":"PendingModifiedValues", - "documentation":"

A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.

" - }, - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version ID of the Amazon Redshift engine that is running on the cluster.

" - }, - "AllowVersionUpgrade":{ - "shape":"Boolean", - "documentation":"

A Boolean value that, if true, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.

" - }, - "NumberOfNodes":{ - "shape":"Integer", - "documentation":"

The number of compute nodes in the cluster.

" - }, - "PubliclyAccessible":{ - "shape":"Boolean", - "documentation":"

A Boolean value that, if true, indicates that the cluster can be accessed from a public network.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

A Boolean value that, if true, indicates that data in the cluster is encrypted at rest.

" - }, - "RestoreStatus":{ - "shape":"RestoreStatus", - "documentation":"

A value that describes the status of a cluster restore action. This parameter returns null if the cluster was not created by restoring a snapshot.

" - }, - "HsmStatus":{ - "shape":"HsmStatus", - "documentation":"

A value that reports whether the Amazon Redshift cluster has finished applying any hardware security module (HSM) settings changes specified in a modify cluster command.

Values: active, applying

" - }, - "ClusterSnapshotCopyStatus":{ - "shape":"ClusterSnapshotCopyStatus", - "documentation":"

A value that returns the destination region and retention period that are configured for cross-region snapshot copy.

" - }, - "ClusterPublicKey":{ - "shape":"String", - "documentation":"

The public key for the cluster.

" - }, - "ClusterNodes":{ - "shape":"ClusterNodesList", - "documentation":"

The nodes in the cluster.

" - }, - "ElasticIpStatus":{ - "shape":"ElasticIpStatus", - "documentation":"

The status of the elastic IP (EIP) address.

" - }, - "ClusterRevisionNumber":{ - "shape":"String", - "documentation":"

The specific revision number of the database in the cluster.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the cluster.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS Key Management Service (AWS KMS) key ID of the encryption key used to encrypt data in the cluster.

" - }, - "EnhancedVpcRouting":{ - "shape":"Boolean", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "IamRoles":{ - "shape":"ClusterIamRoleList", - "documentation":"

A list of AWS Identity and Access Management (IAM) roles that can be used by the cluster to access other AWS services.

" - }, - "PendingActions":{ - "shape":"PendingActionsList", - "documentation":"

Cluster operations that are waiting to be started.

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track for the cluster.

" - } - }, - "documentation":"

Describes a cluster.

", - "wrapper":true - }, - "ClusterAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The account already has a cluster with the given identifier.

", - "error":{ - "code":"ClusterAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterCredentials":{ - "type":"structure", - "members":{ - "DbUser":{ - "shape":"String", - "documentation":"

A database user name that is authorized to log on to the database DbName using the password DbPassword. If the specified DbUser exists in the database, the new user name has the same database privileges as the the user named in DbUser. By default, the user is added to PUBLIC. If the DbGroups parameter is specifed, DbUser is added to the listed groups for any sessions created using these credentials.

" - }, - "DbPassword":{ - "shape":"SensitiveString", - "documentation":"

A temporary password that authorizes the user name returned by DbUser to log on to the database DbName.

" - }, - "Expiration":{ - "shape":"TStamp", - "documentation":"

The date and time the password in DbPassword expires.

" - } - }, - "documentation":"

Temporary credentials with authorization to log on to an Amazon Redshift database.

" - }, - "ClusterDbRevision":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster.

" - }, - "CurrentDatabaseRevision":{ - "shape":"String", - "documentation":"

A string representing the current cluster version.

" - }, - "DatabaseRevisionReleaseDate":{ - "shape":"TStamp", - "documentation":"

The date on which the database revision was released.

" - }, - "RevisionTargets":{ - "shape":"RevisionTargetsList", - "documentation":"

A list of RevisionTarget objects, where each object describes the database revision that a cluster can be updated to.

" - } - }, - "documentation":"

Describes a ClusterDbRevision.

" - }, - "ClusterDbRevisionsList":{ - "type":"list", - "member":{ - "shape":"ClusterDbRevision", - "locationName":"ClusterDbRevision" - } - }, - "ClusterDbRevisionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A string representing the starting point for the next set of revisions. If a value is returned in a response, you can retrieve the next set of revisions by providing the value in the marker parameter and retrying the command. If the marker field is empty, all revisions have already been returned.

" - }, - "ClusterDbRevisions":{ - "shape":"ClusterDbRevisionsList", - "documentation":"

A list of revisions.

" - } - } - }, - "ClusterIamRole":{ - "type":"structure", - "members":{ - "IamRoleArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role, for example, arn:aws:iam::123456789012:role/RedshiftCopyUnload.

" - }, - "ApplyStatus":{ - "shape":"String", - "documentation":"

A value that describes the status of the IAM role's association with an Amazon Redshift cluster.

The following are possible statuses and descriptions.

  • in-sync: The role is available for use by the cluster.

  • adding: The role is in the process of being associated with the cluster.

  • removing: The role is in the process of being disassociated with the cluster.

" - } - }, - "documentation":"

An AWS Identity and Access Management (IAM) role that can be used by the associated Amazon Redshift cluster to access other AWS services.

" - }, - "ClusterIamRoleList":{ - "type":"list", - "member":{ - "shape":"ClusterIamRole", - "locationName":"ClusterIamRole" - } - }, - "ClusterList":{ - "type":"list", - "member":{ - "shape":"Cluster", - "locationName":"Cluster" - } - }, - "ClusterNode":{ - "type":"structure", - "members":{ - "NodeRole":{ - "shape":"String", - "documentation":"

Whether the node is a leader node or a compute node.

" - }, - "PrivateIPAddress":{ - "shape":"String", - "documentation":"

The private IP address of a node within a cluster.

" - }, - "PublicIPAddress":{ - "shape":"String", - "documentation":"

The public IP address of a node within a cluster.

" - } - }, - "documentation":"

The identifier of a node in a cluster.

" - }, - "ClusterNodesList":{ - "type":"list", - "member":{"shape":"ClusterNode"} - }, - "ClusterNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The ClusterIdentifier parameter does not refer to an existing cluster.

", - "error":{ - "code":"ClusterNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ClusterOnLatestRevisionFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cluster is already on the latest database revision.

", - "error":{ - "code":"ClusterOnLatestRevision", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterParameterGroup":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group.

" - }, - "ParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group family that this cluster parameter group is compatible with.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the parameter group.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the cluster parameter group.

" - } - }, - "documentation":"

Describes a parameter group.

", - "wrapper":true - }, - "ClusterParameterGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A cluster parameter group with the same name already exists.

", - "error":{ - "code":"ClusterParameterGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterParameterGroupDetails":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParametersList", - "documentation":"

A list of Parameter instances. Each instance lists the parameters of one cluster parameter group.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - } - }, - "documentation":"

Contains the output from the DescribeClusterParameters action.

" - }, - "ClusterParameterGroupNameMessage":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group.

" - }, - "ParameterGroupStatus":{ - "shape":"String", - "documentation":"

The status of the parameter group. For example, if you made a change to a parameter group name-value pair, then the change could be pending a reboot of an associated cluster.

" - } - }, - "documentation":"

" - }, - "ClusterParameterGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The parameter group name does not refer to an existing parameter group.

", - "error":{ - "code":"ClusterParameterGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ClusterParameterGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of cluster parameter groups. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"ClusterParameterGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterParameterGroupStatus":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of parameter updates.

" - }, - "ClusterParameterStatusList":{ - "shape":"ClusterParameterStatusList", - "documentation":"

The list of parameter statuses.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - } - }, - "documentation":"

Describes the status of a parameter group.

" - }, - "ClusterParameterGroupStatusList":{ - "type":"list", - "member":{ - "shape":"ClusterParameterGroupStatus", - "locationName":"ClusterParameterGroup" - } - }, - "ClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ParameterGroups":{ - "shape":"ParameterGroupList", - "documentation":"

A list of ClusterParameterGroup instances. Each instance describes one cluster parameter group.

" - } - }, - "documentation":"

Contains the output from the DescribeClusterParameterGroups action.

" - }, - "ClusterParameterStatus":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterApplyStatus":{ - "shape":"String", - "documentation":"

The status of the parameter that indicates whether the parameter is in sync with the database, waiting for a cluster reboot, or encountered an error when being applied.

The following are possible statuses and descriptions.

  • in-sync: The parameter value is in sync with the database.

  • pending-reboot: The parameter value will be applied after the cluster reboots.

  • applying: The parameter value is being applied to the database.

  • invalid-parameter: Cannot apply the parameter value because it has an invalid value or syntax.

  • apply-deferred: The parameter contains static property changes. The changes are deferred until the cluster reboots.

  • apply-error: Cannot connect to the cluster. The parameter change will be applied after the cluster reboots.

  • unknown-error: Cannot apply the parameter change right now. The change will be applied after the cluster reboots.

" - }, - "ParameterApplyErrorDescription":{ - "shape":"String", - "documentation":"

The error that prevented the parameter from being applied to the database.

" - } - }, - "documentation":"

Describes the status of a parameter group.

" - }, - "ClusterParameterStatusList":{ - "type":"list", - "member":{"shape":"ClusterParameterStatus"} - }, - "ClusterQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would exceed the allowed number of cluster instances for this account. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"ClusterQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSecurityGroup":{ - "type":"structure", - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster security group to which the operation was applied.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the security group.

" - }, - "EC2SecurityGroups":{ - "shape":"EC2SecurityGroupList", - "documentation":"

A list of EC2 security groups that are permitted to access clusters associated with this cluster security group.

" - }, - "IPRanges":{ - "shape":"IPRangeList", - "documentation":"

A list of IP ranges (CIDR blocks) that are permitted to access clusters associated with this cluster security group.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the cluster security group.

" - } - }, - "documentation":"

Describes a security group.

", - "wrapper":true - }, - "ClusterSecurityGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A cluster security group with the same name already exists.

", - "error":{ - "code":"ClusterSecurityGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSecurityGroupMembership":{ - "type":"structure", - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the cluster security group.

" - } - }, - "documentation":"

Describes a cluster security group.

" - }, - "ClusterSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"ClusterSecurityGroupMembership", - "locationName":"ClusterSecurityGroup" - } - }, - "ClusterSecurityGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ClusterSecurityGroups":{ - "shape":"ClusterSecurityGroups", - "documentation":"

A list of ClusterSecurityGroup instances.

" - } - }, - "documentation":"

" - }, - "ClusterSecurityGroupNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ClusterSecurityGroupName" - } - }, - "ClusterSecurityGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster security group name does not refer to an existing cluster security group.

", - "error":{ - "code":"ClusterSecurityGroupNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ClusterSecurityGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of cluster security groups. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"QuotaExceeded.ClusterSecurityGroup", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSecurityGroups":{ - "type":"list", - "member":{ - "shape":"ClusterSecurityGroup", - "locationName":"ClusterSecurityGroup" - } - }, - "ClusterSnapshotAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The value specified as a snapshot identifier is already used by an existing snapshot.

", - "error":{ - "code":"ClusterSnapshotAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSnapshotCopyStatus":{ - "type":"structure", - "members":{ - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region that snapshots are automatically copied to when cross-region snapshot copy is enabled.

" - }, - "RetentionPeriod":{ - "shape":"Long", - "documentation":"

The number of days that automated snapshots are retained in the destination region after they are copied from a source region.

" - }, - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant.

" - } - }, - "documentation":"

Returns the destination region and retention period that are configured for cross-region snapshot copy.

" - }, - "ClusterSnapshotNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The snapshot identifier does not refer to an existing cluster snapshot.

", - "error":{ - "code":"ClusterSnapshotNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ClusterSnapshotQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in the user exceeding the allowed number of cluster snapshots.

", - "error":{ - "code":"ClusterSnapshotQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSubnetGroup":{ - "type":"structure", - "members":{ - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster subnet group.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the cluster subnet group.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The VPC ID of the cluster subnet group.

" - }, - "SubnetGroupStatus":{ - "shape":"String", - "documentation":"

The status of the cluster subnet group. Possible values are Complete, Incomplete and Invalid.

" - }, - "Subnets":{ - "shape":"SubnetList", - "documentation":"

A list of the VPC Subnet elements.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the cluster subnet group.

" - } - }, - "documentation":"

Describes a subnet group.

", - "wrapper":true - }, - "ClusterSubnetGroupAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A ClusterSubnetGroupName is already used by an existing cluster subnet group.

", - "error":{ - "code":"ClusterSubnetGroupAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSubnetGroupMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ClusterSubnetGroups":{ - "shape":"ClusterSubnetGroups", - "documentation":"

A list of ClusterSubnetGroup instances.

" - } - }, - "documentation":"

Contains the output from the DescribeClusterSubnetGroups action.

" - }, - "ClusterSubnetGroupNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster subnet group name does not refer to an existing cluster subnet group.

", - "error":{ - "code":"ClusterSubnetGroupNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSubnetGroupQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in user exceeding the allowed number of cluster subnet groups. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"ClusterSubnetGroupQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterSubnetGroups":{ - "type":"list", - "member":{ - "shape":"ClusterSubnetGroup", - "locationName":"ClusterSubnetGroup" - } - }, - "ClusterSubnetQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would result in user exceeding the allowed number of subnets in a cluster subnet groups. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"ClusterSubnetQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ClusterVersion":{ - "type":"structure", - "members":{ - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version number used by the cluster.

" - }, - "ClusterParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group family for the cluster.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the cluster version.

" - } - }, - "documentation":"

Describes a cluster version, including the parameter group family and description of the version.

" - }, - "ClusterVersionList":{ - "type":"list", - "member":{ - "shape":"ClusterVersion", - "locationName":"ClusterVersion" - } - }, - "ClusterVersionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ClusterVersions":{ - "shape":"ClusterVersionList", - "documentation":"

A list of Version elements.

" - } - }, - "documentation":"

Contains the output from the DescribeClusterVersions action.

" - }, - "ClustersMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "Clusters":{ - "shape":"ClusterList", - "documentation":"

A list of Cluster objects, where each object describes one cluster.

" - } - }, - "documentation":"

Contains the output from the DescribeClusters action.

" - }, - "CopyClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "SourceSnapshotIdentifier", - "TargetSnapshotIdentifier" - ], - "members":{ - "SourceSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source snapshot.

Constraints:

  • Must be the identifier for a valid automated snapshot whose state is available.

" - }, - "SourceSnapshotClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster the source snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

Constraints:

  • Must be the identifier for a valid cluster.

" - }, - "TargetSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier given to the new manual snapshot.

Constraints:

  • Cannot be null, empty, or blank.

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique for the AWS account that is making the request.

" - } - }, - "documentation":"

" - }, - "CopyClusterSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "CopyToRegionDisabledFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cross-region snapshot copy was temporarily disabled. Try your request again.

", - "error":{ - "code":"CopyToRegionDisabledFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CreateClusterMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "NodeType", - "MasterUsername", - "MasterUserPassword" - ], - "members":{ - "DBName":{ - "shape":"String", - "documentation":"

The name of the first database to be created when the cluster is created.

To create additional databases after the cluster is created, connect to the cluster with a SQL client and use SQL commands to create a database. For more information, go to Create a Database in the Amazon Redshift Database Developer Guide.

Default: dev

Constraints:

  • Must contain 1 to 64 alphanumeric characters.

  • Must contain only lowercase letters.

  • Cannot be a word that is reserved by the service. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

A unique identifier for the cluster. You use this identifier to refer to the cluster for any subsequent cluster operations such as deleting or modifying. The identifier also appears in the Amazon Redshift console.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • Alphabetic characters must be lowercase.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique for all clusters within an AWS account.

Example: myexamplecluster

" - }, - "ClusterType":{ - "shape":"String", - "documentation":"

The type of the cluster. When cluster type is specified as

  • single-node, the NumberOfNodes parameter is not required.

  • multi-node, the NumberOfNodes parameter is required.

Valid Values: multi-node | single-node

Default: multi-node

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type to be provisioned for the cluster. For information about node types, go to Working with Clusters in the Amazon Redshift Cluster Management Guide.

Valid Values: ds2.xlarge | ds2.8xlarge | ds2.xlarge | ds2.8xlarge | dc1.large | dc1.8xlarge | dc2.large | dc2.8xlarge

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The user name associated with the master user account for the cluster that is being created.

Constraints:

  • Must be 1 - 128 alphanumeric characters. The user name can't be PUBLIC.

  • First character must be a letter.

  • Cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The password associated with the master user account for the cluster that is being created.

Constraints:

  • Must be between 8 and 64 characters in length.

  • Must contain at least one uppercase letter.

  • Must contain at least one lowercase letter.

  • Must contain one number.

  • Can be any printable ASCII character (ASCII code 33 to 126) except ' (single quote), \" (double quote), \\, /, @, or space.

" - }, - "ClusterSecurityGroups":{ - "shape":"ClusterSecurityGroupNameList", - "documentation":"

A list of security groups to be associated with this cluster.

Default: The default cluster security group for Amazon Redshift.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.

Default: The default VPC security group is associated with the cluster.

" - }, - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of a cluster subnet group to be associated with this cluster.

If this parameter is not provided the resulting cluster will be deployed outside virtual private cloud (VPC).

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The EC2 Availability Zone (AZ) in which you want Amazon Redshift to provision the cluster. For example, if you have several EC2 instances running in a specific Availability Zone, then you might want the cluster to be provisioned in the same zone in order to decrease network latency.

Default: A random, system-chosen Availability Zone in the region that is specified by the endpoint.

Example: us-east-1d

Constraint: The specified Availability Zone must be in the same region as the current endpoint.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which automated cluster maintenance can occur.

Format: ddd:hh24:mi-ddd:hh24:mi

Default: A 30-minute window selected at random from an 8-hour block of time per region, occurring on a random day of the week. For more information about the time blocks for each region, see Maintenance Windows in Amazon Redshift Cluster Management Guide.

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Minimum 30-minute window.

" - }, - "ClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to be associated with this cluster.

Default: The default Amazon Redshift cluster parameter group. For information about the default parameter group, go to Working with Amazon Redshift Parameter Groups

Constraints:

  • Must be 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "AutomatedSnapshotRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with CreateClusterSnapshot.

Default: 1

Constraints: Must be a value from 0 to 35.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the cluster accepts incoming connections.

The cluster is accessible only via the JDBC and ODBC connection strings. Part of the connection string requires the port on which the cluster will listen for incoming connections.

Default: 5439

Valid Values: 1150-65535

" - }, - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version of the Amazon Redshift engine software that you want to deploy on the cluster.

The version selected runs on all the nodes in the cluster.

Constraints: Only version 1.0 is currently available.

Example: 1.0

" - }, - "AllowVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

If true, major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster.

When a new major version of the Amazon Redshift engine is released, you can request that the service automatically apply upgrades during the maintenance window to the Amazon Redshift engine that is running on your cluster.

Default: true

" - }, - "NumberOfNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of compute nodes in the cluster. This parameter is required when the ClusterType parameter is specified as multi-node.

For information about determining how many nodes you need, go to Working with Clusters in the Amazon Redshift Cluster Management Guide.

If you don't specify this parameter, you get a single-node cluster. When requesting a multi-node cluster, you must specify the number of nodes that you want in the cluster.

Default: 1

Constraints: Value must be at least 1 and no more than 100.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

If true, the cluster can be accessed from a public network.

" - }, - "Encrypted":{ - "shape":"BooleanOptional", - "documentation":"

If true, the data in the cluster is encrypted at rest.

Default: false

" - }, - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM client certificate the Amazon Redshift cluster uses to retrieve the data encryption keys stored in an HSM.

" - }, - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM configuration that contains the information the Amazon Redshift cluster can use to retrieve and store keys in an HSM.

" - }, - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP (EIP) address for the cluster.

Constraints: The cluster must be provisioned in EC2-VPC and publicly-accessible through an Internet gateway. For more information about provisioning clusters in EC2-VPC, go to Supported Platforms to Launch Your Cluster in the Amazon Redshift Cluster Management Guide.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS Key Management Service (KMS) key ID of the encryption key that you want to use to encrypt data in the cluster.

" - }, - "EnhancedVpcRouting":{ - "shape":"BooleanOptional", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

" - }, - "IamRoles":{ - "shape":"IamRoleArnList", - "documentation":"

A list of AWS Identity and Access Management (IAM) roles that can be used by the cluster to access other AWS services. You must supply the IAM roles in their Amazon Resource Name (ARN) format. You can supply up to 10 IAM roles in a single request.

A cluster can have up to 10 IAM roles associated with it at any time.

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

An optional parameter for the name of the maintenance track for the cluster. If you don't provide a maintenance track name, the cluster is assigned to the current track.

" - } - }, - "documentation":"

" - }, - "CreateClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "ParameterGroupName", - "ParameterGroupFamily", - "Description" - ], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group.

Constraints:

  • Must be 1 to 255 alphanumeric characters or hyphens

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique withing your AWS account.

This value is stored as a lower-case string.

" - }, - "ParameterGroupFamily":{ - "shape":"String", - "documentation":"

The Amazon Redshift engine version to which the cluster parameter group applies. The cluster engine version determines the set of parameters.

To get a list of valid parameter group family names, you can call DescribeClusterParameterGroups. By default, Amazon Redshift returns a list of all the parameter groups that are owned by your AWS account, including the default parameter groups for each Amazon Redshift engine version. The parameter group family names associated with the default parameter groups provide you the valid values. For example, a valid family name is \"redshift-1.0\".

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter group.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateClusterParameterGroupResult":{ - "type":"structure", - "members":{ - "ClusterParameterGroup":{"shape":"ClusterParameterGroup"} - } - }, - "CreateClusterResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "CreateClusterSecurityGroupMessage":{ - "type":"structure", - "required":[ - "ClusterSecurityGroupName", - "Description" - ], - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name for the security group. Amazon Redshift stores the value as a lowercase string.

Constraints:

  • Must contain no more than 255 alphanumeric characters or hyphens.

  • Must not be \"Default\".

  • Must be unique for all security groups that are created by your AWS account.

Example: examplesecuritygroup

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the security group.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateClusterSecurityGroupResult":{ - "type":"structure", - "members":{ - "ClusterSecurityGroup":{"shape":"ClusterSecurityGroup"} - } - }, - "CreateClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "SnapshotIdentifier", - "ClusterIdentifier" - ], - "members":{ - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

A unique identifier for the snapshot that you are requesting. This identifier must be unique for all snapshots within the AWS account.

Constraints:

  • Cannot be null, empty, or blank

  • Must contain from 1 to 255 alphanumeric characters or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

Example: my-snapshot-id

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The cluster identifier for which you want a snapshot.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateClusterSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "CreateClusterSubnetGroupMessage":{ - "type":"structure", - "required":[ - "ClusterSubnetGroupName", - "Description", - "SubnetIds" - ], - "members":{ - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name for the subnet group. Amazon Redshift stores the value as a lowercase string.

Constraints:

  • Must contain no more than 255 alphanumeric characters or hyphens.

  • Must not be \"Default\".

  • Must be unique for all subnet groups that are created by your AWS account.

Example: examplesubnetgroup

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description for the subnet group.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

An array of VPC subnet IDs. A maximum of 20 subnets can be modified in a single request.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateClusterSubnetGroupResult":{ - "type":"structure", - "members":{ - "ClusterSubnetGroup":{"shape":"ClusterSubnetGroup"} - } - }, - "CreateEventSubscriptionMessage":{ - "type":"structure", - "required":[ - "SubscriptionName", - "SnsTopicArn" - ], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the event subscription to be created.

Constraints:

  • Cannot be null, empty, or blank.

  • Must contain from 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic used to transmit the event notifications. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that will be generating the events. For example, if you want to be notified of events generated by a cluster, you would set this parameter to cluster. If this value is not specified, events are returned for all Amazon Redshift objects in your AWS account. You must specify a source type in order to specify source IDs.

Valid values: cluster, cluster-parameter-group, cluster-security-group, and cluster-snapshot.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

A list of one or more identifiers of Amazon Redshift source objects. All of the objects must be of the same type as was specified in the source type parameter. The event subscription will return only events generated by the specified objects. If not specified, then events are returned for all objects within the source type specified.

Example: my-cluster-1, my-cluster-2

Example: my-snapshot-20131010

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

Specifies the Amazon Redshift event categories to be published by the event notification subscription.

Values: Configuration, Management, Monitoring, Security

" - }, - "Severity":{ - "shape":"String", - "documentation":"

Specifies the Amazon Redshift event severity to be published by the event notification subscription.

Values: ERROR, INFO

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "CreateHsmClientCertificateMessage":{ - "type":"structure", - "required":["HsmClientCertificateIdentifier"], - "members":{ - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier to be assigned to the new HSM client certificate that the cluster will use to connect to the HSM to use the database encryption keys.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateHsmClientCertificateResult":{ - "type":"structure", - "members":{ - "HsmClientCertificate":{"shape":"HsmClientCertificate"} - } - }, - "CreateHsmConfigurationMessage":{ - "type":"structure", - "required":[ - "HsmConfigurationIdentifier", - "Description", - "HsmIpAddress", - "HsmPartitionName", - "HsmPartitionPassword", - "HsmServerPublicCertificate" - ], - "members":{ - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

The identifier to be assigned to the new Amazon Redshift HSM configuration.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A text description of the HSM configuration to be created.

" - }, - "HsmIpAddress":{ - "shape":"String", - "documentation":"

The IP address that the Amazon Redshift cluster must use to access the HSM.

" - }, - "HsmPartitionName":{ - "shape":"String", - "documentation":"

The name of the partition in the HSM where the Amazon Redshift clusters will store their database encryption keys.

" - }, - "HsmPartitionPassword":{ - "shape":"String", - "documentation":"

The password required to access the HSM partition.

" - }, - "HsmServerPublicCertificate":{ - "shape":"String", - "documentation":"

The HSMs public certificate file. When using Cloud HSM, the file name is server.pem.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

" - }, - "CreateHsmConfigurationResult":{ - "type":"structure", - "members":{ - "HsmConfiguration":{"shape":"HsmConfiguration"} - } - }, - "CreateSnapshotCopyGrantMessage":{ - "type":"structure", - "required":["SnapshotCopyGrantName"], - "members":{ - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant. This name must be unique in the region for the AWS account.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • Alphabetic characters must be lowercase.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique for all clusters within an AWS account.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The unique identifier of the customer master key (CMK) to which to grant Amazon Redshift permission. If no key is specified, the default key is used.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

The result of the CreateSnapshotCopyGrant action.

" - }, - "CreateSnapshotCopyGrantResult":{ - "type":"structure", - "members":{ - "SnapshotCopyGrant":{"shape":"SnapshotCopyGrant"} - } - }, - "CreateTagsMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "Tags" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) to which you want to add the tag or tags. For example, arn:aws:redshift:us-east-1:123456789:cluster:t1.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more name/value pairs to add as tags to the specified resource. Each tag name is passed in with the parameter Key and the corresponding value is passed in with the parameter Value. The Key and Value parameters are separated by a comma (,). Separate multiple tags with a space. For example, --tags \"Key\"=\"owner\",\"Value\"=\"admin\" \"Key\"=\"environment\",\"Value\"=\"test\" \"Key\"=\"version\",\"Value\"=\"1.0\".

" - } - }, - "documentation":"

Contains the output from the CreateTags action.

" - }, - "DbGroupList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DbGroup" - } - }, - "DefaultClusterParameters":{ - "type":"structure", - "members":{ - "ParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group family to which the engine default parameters apply.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

The list of cluster default parameters.

" - } - }, - "documentation":"

Describes the default cluster parameters for a parameter group family.

", - "wrapper":true - }, - "DeleteClusterMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster to be deleted.

Constraints:

  • Must contain lowercase characters.

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "SkipFinalClusterSnapshot":{ - "shape":"Boolean", - "documentation":"

Determines whether a final snapshot of the cluster is created before Amazon Redshift deletes the cluster. If true, a final cluster snapshot is not created. If false, a final cluster snapshot is created before the cluster is deleted.

The FinalClusterSnapshotIdentifier parameter must be specified if SkipFinalClusterSnapshot is false.

Default: false

" - }, - "FinalClusterSnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the final snapshot that is to be created immediately before deleting the cluster. If this parameter is provided, SkipFinalClusterSnapshot must be false.

Constraints:

  • Must be 1 to 255 alphanumeric characters.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - } - }, - "documentation":"

" - }, - "DeleteClusterParameterGroupMessage":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to be deleted.

Constraints:

  • Must be the name of an existing cluster parameter group.

  • Cannot delete a default cluster parameter group.

" - } - }, - "documentation":"

" - }, - "DeleteClusterResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "DeleteClusterSecurityGroupMessage":{ - "type":"structure", - "required":["ClusterSecurityGroupName"], - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster security group to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteClusterSnapshotMessage":{ - "type":"structure", - "required":["SnapshotIdentifier"], - "members":{ - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the manual snapshot to be deleted.

Constraints: Must be the name of an existing snapshot that is in the available state.

" - }, - "SnapshotClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster the snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

Constraints: Must be the name of valid cluster.

" - } - }, - "documentation":"

" - }, - "DeleteClusterSnapshotResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "DeleteClusterSubnetGroupMessage":{ - "type":"structure", - "required":["ClusterSubnetGroupName"], - "members":{ - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster subnet group name to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the Amazon Redshift event notification subscription to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteHsmClientCertificateMessage":{ - "type":"structure", - "required":["HsmClientCertificateIdentifier"], - "members":{ - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the HSM client certificate to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteHsmConfigurationMessage":{ - "type":"structure", - "required":["HsmConfigurationIdentifier"], - "members":{ - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the Amazon Redshift HSM configuration to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteSnapshotCopyGrantMessage":{ - "type":"structure", - "required":["SnapshotCopyGrantName"], - "members":{ - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant to delete.

" - } - }, - "documentation":"

The result of the DeleteSnapshotCopyGrant action.

" - }, - "DeleteTagsMessage":{ - "type":"structure", - "required":[ - "ResourceName", - "TagKeys" - ], - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) from which you want to remove the tag or tags. For example, arn:aws:redshift:us-east-1:123456789:cluster:t1.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The tag key that you want to delete.

" - } - }, - "documentation":"

Contains the output from the DeleteTags action.

" - }, - "DependentServiceRequestThrottlingFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request cannot be completed because a dependent service is throttling requests made by Amazon Redshift on your behalf. Wait and retry the request.

", - "error":{ - "code":"DependentServiceRequestThrottlingFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DependentServiceUnavailableFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Your request cannot be completed because a dependent internal service is temporarily unavailable. Wait 30 to 60 seconds and try again.

", - "error":{ - "code":"DependentServiceUnavailableFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "DescribeClusterDbRevisionsMessage":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

A unique identifier for a cluster whose ClusterDbRevisions you are requesting. This parameter is case sensitive. All clusters defined for an account are returned by default.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in the marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the marker parameter and retrying the request.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point for returning a set of response records. When the results of a DescribeClusterDbRevisions request exceed the value specified in MaxRecords, Amazon Redshift returns a value in the marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the marker parameter and retrying the request.

Constraints: You can specify either the ClusterIdentifier parameter, or the marker parameter, but not both.

" - } - } - }, - "DescribeClusterParameterGroupsMessage":{ - "type":"structure", - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a specific parameter group for which to return details. By default, details about all parameter groups and the default parameter group are returned.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterParameterGroups request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching cluster parameter groups that are associated with the specified key or keys. For example, suppose that you have parameter groups that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the parameter groups that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching cluster parameter groups that are associated with the specified tag value or values. For example, suppose that you have parameter groups that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the parameter groups that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeClusterParametersMessage":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of a cluster parameter group for which to return details.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The parameter types to return. Specify user to show parameters that are different form the default. Similarly, specify engine-default to show parameters that are the same as the default parameter group.

Default: All parameter types returned.

Valid Values: user | engine-default

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterParameters request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeClusterSecurityGroupsMessage":{ - "type":"structure", - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of a cluster security group for which you are requesting details. You can specify either the Marker parameter or a ClusterSecurityGroupName parameter, but not both.

Example: securitygroup1

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterSecurityGroups request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

Constraints: You can specify either the ClusterSecurityGroupName parameter or the Marker parameter, but not both.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching cluster security groups that are associated with the specified key or keys. For example, suppose that you have security groups that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the security groups that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching cluster security groups that are associated with the specified tag value or values. For example, suppose that you have security groups that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the security groups that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeClusterSnapshotsMessage":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster for which information about snapshots is requested.

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The snapshot identifier of the snapshot about which to return information.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The type of snapshots for which you are requesting information. By default, snapshots of all types are returned.

Valid Values: automated | manual

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

A value that requests only snapshots created at or after the specified time. The time value is specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2012-07-16T18:00:00Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

A time value that requests only snapshots created at or before the specified time. The time value is specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2012-07-16T18:00:00Z

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterSnapshots request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "OwnerAccount":{ - "shape":"String", - "documentation":"

The AWS customer account used to create or copy the snapshot. Use this field to filter the results to snapshots owned by a particular account. To describe snapshots you own, either specify your AWS customer account, or do not specify the parameter.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching cluster snapshots that are associated with the specified key or keys. For example, suppose that you have snapshots that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the snapshots that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching cluster snapshots that are associated with the specified tag value or values. For example, suppose that you have snapshots that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the snapshots that have either or both of these tag values associated with them.

" - }, - "ClusterExists":{ - "shape":"BooleanOptional", - "documentation":"

A value that indicates whether to return snapshots only for an existing cluster. Table-level restore can be performed only using a snapshot of an existing cluster, that is, a cluster that has not been deleted. If ClusterExists is set to true, ClusterIdentifier is required.

" - } - }, - "documentation":"

" - }, - "DescribeClusterSubnetGroupsMessage":{ - "type":"structure", - "members":{ - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster subnet group for which information is requested.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterSubnetGroups request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching cluster subnet groups that are associated with the specified key or keys. For example, suppose that you have subnet groups that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the subnet groups that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching cluster subnet groups that are associated with the specified tag value or values. For example, suppose that you have subnet groups that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the subnet groups that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeClusterTracksMessage":{ - "type":"structure", - "members":{ - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

An integer value for the maximum number of maintenance tracks to return.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterTracks request exceed the value specified in MaxRecords, Amazon Redshift returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - } - }, - "DescribeClusterVersionsMessage":{ - "type":"structure", - "members":{ - "ClusterVersion":{ - "shape":"String", - "documentation":"

The specific cluster version to return.

Example: 1.0

" - }, - "ClusterParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of a specific cluster parameter group family to return details for.

Constraints:

  • Must be 1 to 255 alphanumeric characters

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterVersions request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeClustersMessage":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of a cluster whose properties you are requesting. This parameter is case sensitive.

The default is that all clusters defined for an account are returned.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusters request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

Constraints: You can specify either the ClusterIdentifier parameter or the Marker parameter, but not both.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching clusters that are associated with the specified key or keys. For example, suppose that you have clusters that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the clusters that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching clusters that are associated with the specified tag value or values. For example, suppose that you have clusters that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the clusters that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeDefaultClusterParametersMessage":{ - "type":"structure", - "required":["ParameterGroupFamily"], - "members":{ - "ParameterGroupFamily":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group family.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeDefaultClusterParameters request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeDefaultClusterParametersResult":{ - "type":"structure", - "members":{ - "DefaultClusterParameters":{"shape":"DefaultClusterParameters"} - } - }, - "DescribeEventCategoriesMessage":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The source type, such as cluster or parameter group, to which the described event categories apply.

Valid values: cluster, cluster-snapshot, cluster-parameter-group, and cluster-security-group.

" - } - }, - "documentation":"

" - }, - "DescribeEventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the Amazon Redshift event notification subscription to be described.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeEventSubscriptions request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching event notification subscriptions that are associated with the specified key or keys. For example, suppose that you have subscriptions that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the subscriptions that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching event notification subscriptions that are associated with the specified tag value or values. For example, suppose that you have subscriptions that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the subscriptions that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeEventsMessage":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the event source for which events will be returned. If this parameter is not specified, then all sources are included in the response.

Constraints:

If SourceIdentifier is supplied, SourceType must also be provided.

  • Specify a cluster identifier when SourceType is cluster.

  • Specify a cluster security group name when SourceType is cluster-security-group.

  • Specify a cluster parameter group name when SourceType is cluster-parameter-group.

  • Specify a cluster snapshot identifier when SourceType is cluster-snapshot.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The event source to retrieve events for. If no value is specified, all events are returned.

Constraints:

If SourceType is supplied, SourceIdentifier must also be provided.

  • Specify cluster when SourceIdentifier is a cluster identifier.

  • Specify cluster-security-group when SourceIdentifier is a cluster security group name.

  • Specify cluster-parameter-group when SourceIdentifier is a cluster parameter group name.

  • Specify cluster-snapshot when SourceIdentifier is a cluster snapshot identifier.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The beginning of the time interval to retrieve events for, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "EndTime":{ - "shape":"TStamp", - "documentation":"

The end of the time interval for which to retrieve events, specified in ISO 8601 format. For more information about ISO 8601, go to the ISO8601 Wikipedia page.

Example: 2009-07-08T18:00Z

" - }, - "Duration":{ - "shape":"IntegerOptional", - "documentation":"

The number of minutes prior to the time of the request for which to retrieve events. For example, if the request is sent at 18:00 and you specify a duration of 60, then only events which have occurred after 17:00 will be returned.

Default: 60

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeEvents request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeHsmClientCertificatesMessage":{ - "type":"structure", - "members":{ - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier of a specific HSM client certificate for which you want information. If no identifier is specified, information is returned for all HSM client certificates owned by your AWS customer account.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeHsmClientCertificates request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching HSM client certificates that are associated with the specified key or keys. For example, suppose that you have HSM client certificates that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the HSM client certificates that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching HSM client certificates that are associated with the specified tag value or values. For example, suppose that you have HSM client certificates that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the HSM client certificates that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeHsmConfigurationsMessage":{ - "type":"structure", - "members":{ - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

The identifier of a specific Amazon Redshift HSM configuration to be described. If no identifier is specified, information is returned for all HSM configurations owned by your AWS customer account.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeHsmConfigurations request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching HSM configurations that are associated with the specified key or keys. For example, suppose that you have HSM configurations that are tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with the HSM configurations that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching HSM configurations that are associated with the specified tag value or values. For example, suppose that you have HSM configurations that are tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with the HSM configurations that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DescribeLoggingStatusMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster from which to get the logging status.

Example: examplecluster

" - } - }, - "documentation":"

" - }, - "DescribeOrderableClusterOptionsMessage":{ - "type":"structure", - "members":{ - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version filter value. Specify this parameter to show only the available offerings matching the specified version.

Default: All versions.

Constraints: Must be one of the version returned from DescribeClusterVersions.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type filter value. Specify this parameter to show only the available offerings matching the specified node type.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeOrderableClusterOptions request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeReservedNodeOfferingsMessage":{ - "type":"structure", - "members":{ - "ReservedNodeOfferingId":{ - "shape":"String", - "documentation":"

The unique identifier for the offering.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeReservedNodeOfferings request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeReservedNodesMessage":{ - "type":"structure", - "members":{ - "ReservedNodeId":{ - "shape":"String", - "documentation":"

Identifier for the node reservation.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeReservedNodes request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - }, - "documentation":"

" - }, - "DescribeResizeMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of a cluster whose resize progress you are requesting. This parameter is case-sensitive.

By default, resize operations for all clusters defined for an AWS account are returned.

" - } - }, - "documentation":"

" - }, - "DescribeSnapshotCopyGrantsMessage":{ - "type":"structure", - "members":{ - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeSnapshotCopyGrant request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

Constraints: You can specify either the SnapshotCopyGrantName parameter or the Marker parameter, but not both.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching resources that are associated with the specified key or keys. For example, suppose that you have resources tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with all resources that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching resources that are associated with the specified value or values. For example, suppose that you have resources tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with all resources that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

The result of the DescribeSnapshotCopyGrants action.

" - }, - "DescribeTableRestoreStatusMessage":{ - "type":"structure", - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The Amazon Redshift cluster that the table is being restored to.

" - }, - "TableRestoreRequestId":{ - "shape":"String", - "documentation":"

The identifier of the table restore request to return status for. If you don't specify a TableRestoreRequestId value, then DescribeTableRestoreStatus returns the status of all in-progress table restore requests.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

An optional pagination token provided by a previous DescribeTableRestoreStatus request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by the MaxRecords parameter.

" - } - }, - "documentation":"

" - }, - "DescribeTagsMessage":{ - "type":"structure", - "members":{ - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for which you want to describe the tag or tags. For example, arn:aws:redshift:us-east-1:123456789:cluster:t1.

" - }, - "ResourceType":{ - "shape":"String", - "documentation":"

The type of resource with which you want to view tags. Valid resource types are:

  • Cluster

  • CIDR/IP

  • EC2 security group

  • Snapshot

  • Cluster security group

  • Subnet group

  • HSM connection

  • HSM certificate

  • Parameter group

  • Snapshot copy grant

For more information about Amazon Redshift resource types and constructing ARNs, go to Specifying Policy Elements: Actions, Effects, Resources, and Principals in the Amazon Redshift Cluster Management Guide.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

The maximum number or response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the marker parameter and retrying the command. If the marker field is empty, all response records have been retrieved for the request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A tag key or keys for which you want to return all matching resources that are associated with the specified key or keys. For example, suppose that you have resources tagged with keys called owner and environment. If you specify both of these tag keys in the request, Amazon Redshift returns a response with all resources that have either or both of these tag keys associated with them.

" - }, - "TagValues":{ - "shape":"TagValueList", - "documentation":"

A tag value or values for which you want to return all matching resources that are associated with the specified value or values. For example, suppose that you have resources tagged with values called admin and test. If you specify both of these tag values in the request, Amazon Redshift returns a response with all resources that have either or both of these tag values associated with them.

" - } - }, - "documentation":"

" - }, - "DisableLoggingMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster on which logging is to be stopped.

Example: examplecluster

" - } - }, - "documentation":"

" - }, - "DisableSnapshotCopyMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the source cluster that you want to disable copying of snapshots to a destination region.

Constraints: Must be the valid name of an existing cluster that has cross-region snapshot copy enabled.

" - } - }, - "documentation":"

" - }, - "DisableSnapshotCopyResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "Double":{"type":"double"}, - "DoubleOptional":{"type":"double"}, - "EC2SecurityGroup":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the EC2 security group.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the EC2 Security Group.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS ID of the owner of the EC2 security group specified in the EC2SecurityGroupName field.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the EC2 security group.

" - } - }, - "documentation":"

Describes an Amazon EC2 security group.

" - }, - "EC2SecurityGroupList":{ - "type":"list", - "member":{ - "shape":"EC2SecurityGroup", - "locationName":"EC2SecurityGroup" - } - }, - "ElasticIpStatus":{ - "type":"structure", - "members":{ - "ElasticIp":{ - "shape":"String", - "documentation":"

The elastic IP (EIP) address for the cluster.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the elastic IP (EIP) address.

" - } - }, - "documentation":"

Describes the status of the elastic IP (EIP) address.

" - }, - "EligibleTracksToUpdateList":{ - "type":"list", - "member":{ - "shape":"UpdateTarget", - "locationName":"UpdateTarget" - } - }, - "EnableLoggingMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "BucketName" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster on which logging is to be started.

Example: examplecluster

" - }, - "BucketName":{ - "shape":"String", - "documentation":"

The name of an existing S3 bucket where the log files are to be stored.

Constraints:

  • Must be in the same region as the cluster

  • The cluster must have read bucket and put object permissions

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

The prefix applied to the log file names.

Constraints:

  • Cannot exceed 512 characters

  • Cannot contain spaces( ), double quotes (\"), single quotes ('), a backslash (\\), or control characters. The hexadecimal codes for invalid characters are:

    • x00 to x20

    • x22

    • x27

    • x5c

    • x7f or larger

" - } - }, - "documentation":"

" - }, - "EnableSnapshotCopyMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "DestinationRegion" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the source cluster to copy snapshots from.

Constraints: Must be the valid name of an existing cluster that does not already have cross-region snapshot copy enabled.

" - }, - "DestinationRegion":{ - "shape":"String", - "documentation":"

The destination region that you want to copy snapshots to.

Constraints: Must be the name of a valid region. For more information, see Regions and Endpoints in the Amazon Web Services General Reference.

" - }, - "RetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days to retain automated snapshots in the destination region after they are copied from the source region.

Default: 7.

Constraints: Must be at least 1 and no more than 35.

" - }, - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.

" - } - }, - "documentation":"

" - }, - "EnableSnapshotCopyResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"String", - "documentation":"

The DNS address of the Cluster.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port that the database engine is listening on.

" - } - }, - "documentation":"

Describes a connection endpoint.

" - }, - "Event":{ - "type":"structure", - "members":{ - "SourceIdentifier":{ - "shape":"String", - "documentation":"

The identifier for the source of the event.

" - }, - "SourceType":{ - "shape":"SourceType", - "documentation":"

The source type for this event.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The text of this event.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

A list of the event categories.

Values: Configuration, Management, Monitoring, Security

" - }, - "Severity":{ - "shape":"String", - "documentation":"

The severity of the event.

Values: ERROR, INFO

" - }, - "Date":{ - "shape":"TStamp", - "documentation":"

The date and time of the event.

" - }, - "EventId":{ - "shape":"String", - "documentation":"

The identifier of the event.

" - } - }, - "documentation":"

Describes an event.

" - }, - "EventCategoriesList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"EventCategory" - } - }, - "EventCategoriesMap":{ - "type":"structure", - "members":{ - "SourceType":{ - "shape":"String", - "documentation":"

The source type, such as cluster or cluster-snapshot, that the returned categories belong to.

" - }, - "Events":{ - "shape":"EventInfoMapList", - "documentation":"

The events in the event category.

" - } - }, - "documentation":"

Describes event categories.

", - "wrapper":true - }, - "EventCategoriesMapList":{ - "type":"list", - "member":{ - "shape":"EventCategoriesMap", - "locationName":"EventCategoriesMap" - } - }, - "EventCategoriesMessage":{ - "type":"structure", - "members":{ - "EventCategoriesMapList":{ - "shape":"EventCategoriesMapList", - "documentation":"

A list of event categories descriptions.

" - } - }, - "documentation":"

" - }, - "EventInfoMap":{ - "type":"structure", - "members":{ - "EventId":{ - "shape":"String", - "documentation":"

The identifier of an Amazon Redshift event.

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

The category of an Amazon Redshift event.

" - }, - "EventDescription":{ - "shape":"String", - "documentation":"

The description of an Amazon Redshift event.

" - }, - "Severity":{ - "shape":"String", - "documentation":"

The severity of the event.

Values: ERROR, INFO

" - } - }, - "documentation":"

Describes event information.

", - "wrapper":true - }, - "EventInfoMapList":{ - "type":"list", - "member":{ - "shape":"EventInfoMap", - "locationName":"EventInfoMap" - } - }, - "EventList":{ - "type":"list", - "member":{ - "shape":"Event", - "locationName":"Event" - } - }, - "EventSubscription":{ - "type":"structure", - "members":{ - "CustomerAwsId":{ - "shape":"String", - "documentation":"

The AWS customer account associated with the Amazon Redshift event notification subscription.

" - }, - "CustSubscriptionId":{ - "shape":"String", - "documentation":"

The name of the Amazon Redshift event notification subscription.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic used by the event notification subscription.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the Amazon Redshift event notification subscription.

Constraints:

  • Can be one of the following: active | no-permission | topic-not-exist

  • The status \"no-permission\" indicates that Amazon Redshift no longer has permission to post to the Amazon SNS topic. The status \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.

" - }, - "SubscriptionCreationTime":{ - "shape":"TStamp", - "documentation":"

The date and time the Amazon Redshift event notification subscription was created.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The source type of the events returned the Amazon Redshift event notification, such as cluster, or cluster-snapshot.

" - }, - "SourceIdsList":{ - "shape":"SourceIdsList", - "documentation":"

A list of the sources that publish events to the Amazon Redshift event notification subscription.

" - }, - "EventCategoriesList":{ - "shape":"EventCategoriesList", - "documentation":"

The list of Amazon Redshift event categories specified in the event notification subscription.

Values: Configuration, Management, Monitoring, Security

" - }, - "Severity":{ - "shape":"String", - "documentation":"

The event severity specified in the Amazon Redshift event notification subscription.

Values: ERROR, INFO

" - }, - "Enabled":{ - "shape":"Boolean", - "documentation":"

A Boolean value indicating whether the subscription is enabled. true indicates the subscription is enabled.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the event subscription.

" - } - }, - "documentation":"

Describes event subscriptions.

", - "wrapper":true - }, - "EventSubscriptionQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The request would exceed the allowed number of event subscriptions for this account. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"EventSubscriptionQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EventSubscriptionsList":{ - "type":"list", - "member":{ - "shape":"EventSubscription", - "locationName":"EventSubscription" - } - }, - "EventSubscriptionsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "EventSubscriptionsList":{ - "shape":"EventSubscriptionsList", - "documentation":"

A list of event subscriptions.

" - } - }, - "documentation":"

" - }, - "EventsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "Events":{ - "shape":"EventList", - "documentation":"

A list of Event instances.

" - } - }, - "documentation":"

" - }, - "GetClusterCredentialsMessage":{ - "type":"structure", - "required":[ - "DbUser", - "ClusterIdentifier" - ], - "members":{ - "DbUser":{ - "shape":"String", - "documentation":"

The name of a database user. If a user name matching DbUser exists in the database, the temporary user credentials have the same permissions as the existing user. If DbUser doesn't exist in the database and Autocreate is True, a new user is created using the value for DbUser with PUBLIC permissions. If a database user matching the value for DbUser doesn't exist and Autocreate is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.

For more information, see CREATE USER in the Amazon Redshift Database Developer Guide.

Constraints:

  • Must be 1 to 64 alphanumeric characters or hyphens. The user name can't be PUBLIC.

  • Must contain only lowercase letters, numbers, underscore, plus sign, period (dot), at symbol (@), or hyphen.

  • First character must be a letter.

  • Must not contain a colon ( : ) or slash ( / ).

  • Cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

" - }, - "DbName":{ - "shape":"String", - "documentation":"

The name of a database that DbUser is authorized to log on to. If DbName is not specified, DbUser can log on to any existing database.

Constraints:

  • Must be 1 to 64 alphanumeric characters or hyphens

  • Must contain only lowercase letters, numbers, underscore, plus sign, period (dot), at symbol (@), or hyphen.

  • First character must be a letter.

  • Must not contain a colon ( : ) or slash ( / ).

  • Cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster that contains the database for which your are requesting credentials. This parameter is case sensitive.

" - }, - "DurationSeconds":{ - "shape":"IntegerOptional", - "documentation":"

The number of seconds until the returned temporary password expires.

Constraint: minimum 900, maximum 3600.

Default: 900

" - }, - "AutoCreate":{ - "shape":"BooleanOptional", - "documentation":"

Create a database user with the name specified for the user named in DbUser if one does not exist.

" - }, - "DbGroups":{ - "shape":"DbGroupList", - "documentation":"

A list of the names of existing database groups that the user named in DbUser will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.

Database group name constraints

  • Must be 1 to 64 alphanumeric characters or hyphens

  • Must contain only lowercase letters, numbers, underscore, plus sign, period (dot), at symbol (@), or hyphen.

  • First character must be a letter.

  • Must not contain a colon ( : ) or slash ( / ).

  • Cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

" - } - }, - "documentation":"

The request parameters to get cluster credentials.

" - }, - "GetReservedNodeExchangeOfferingsInputMessage":{ - "type":"structure", - "required":["ReservedNodeId"], - "members":{ - "ReservedNodeId":{ - "shape":"String", - "documentation":"

A string representing the node identifier for the DC1 Reserved Node to be exchanged.

" - }, - "MaxRecords":{ - "shape":"IntegerOptional", - "documentation":"

An integer setting the maximum number of ReservedNodeOfferings to retrieve.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of ReservedNodeOfferings.

" - } - }, - "documentation":"

" - }, - "GetReservedNodeExchangeOfferingsOutputMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point for returning a set of response records. When the results of a GetReservedNodeExchangeOfferings request exceed the value specified in MaxRecords, Amazon Redshift returns a value in the marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the marker parameter and retrying the request.

" - }, - "ReservedNodeOfferings":{ - "shape":"ReservedNodeOfferingList", - "documentation":"

Returns an array of ReservedNodeOffering objects.

" - } - } - }, - "HsmClientCertificate":{ - "type":"structure", - "members":{ - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the HSM client certificate.

" - }, - "HsmClientCertificatePublicKey":{ - "shape":"String", - "documentation":"

The public key that the Amazon Redshift cluster will use to connect to the HSM. You must register the public key in the HSM.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the HSM client certificate.

" - } - }, - "documentation":"

Returns information about an HSM client certificate. The certificate is stored in a secure Hardware Storage Module (HSM), and used by the Amazon Redshift cluster to encrypt data files.

", - "wrapper":true - }, - "HsmClientCertificateAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is already an existing Amazon Redshift HSM client certificate with the specified identifier.

", - "error":{ - "code":"HsmClientCertificateAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmClientCertificateList":{ - "type":"list", - "member":{ - "shape":"HsmClientCertificate", - "locationName":"HsmClientCertificate" - } - }, - "HsmClientCertificateMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "HsmClientCertificates":{ - "shape":"HsmClientCertificateList", - "documentation":"

A list of the identifiers for one or more HSM client certificates used by Amazon Redshift clusters to store and retrieve database encryption keys in an HSM.

" - } - }, - "documentation":"

" - }, - "HsmClientCertificateNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is no Amazon Redshift HSM client certificate with the specified identifier.

", - "error":{ - "code":"HsmClientCertificateNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmClientCertificateQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for HSM client certificates has been reached. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"HsmClientCertificateQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmConfiguration":{ - "type":"structure", - "members":{ - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

The name of the Amazon Redshift HSM configuration.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A text description of the HSM configuration.

" - }, - "HsmIpAddress":{ - "shape":"String", - "documentation":"

The IP address that the Amazon Redshift cluster must use to access the HSM.

" - }, - "HsmPartitionName":{ - "shape":"String", - "documentation":"

The name of the partition in the HSM where the Amazon Redshift clusters will store their database encryption keys.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the HSM configuration.

" - } - }, - "documentation":"

Returns information about an HSM configuration, which is an object that describes to Amazon Redshift clusters the information they require to connect to an HSM where they can store database encryption keys.

", - "wrapper":true - }, - "HsmConfigurationAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is already an existing Amazon Redshift HSM configuration with the specified identifier.

", - "error":{ - "code":"HsmConfigurationAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmConfigurationList":{ - "type":"list", - "member":{ - "shape":"HsmConfiguration", - "locationName":"HsmConfiguration" - } - }, - "HsmConfigurationMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "HsmConfigurations":{ - "shape":"HsmConfigurationList", - "documentation":"

A list of HsmConfiguration objects.

" - } - }, - "documentation":"

" - }, - "HsmConfigurationNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is no Amazon Redshift HSM configuration with the specified identifier.

", - "error":{ - "code":"HsmConfigurationNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmConfigurationQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The quota for HSM configurations has been reached. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"HsmConfigurationQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "HsmStatus":{ - "type":"structure", - "members":{ - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM client certificate the Amazon Redshift cluster uses to retrieve the data encryption keys stored in an HSM.

" - }, - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM configuration that contains the information the Amazon Redshift cluster can use to retrieve and store keys in an HSM.

" - }, - "Status":{ - "shape":"String", - "documentation":"

Reports whether the Amazon Redshift cluster has finished applying any HSM settings changes specified in a modify cluster command.

Values: active, applying

" - } - }, - "documentation":"

Describes the status of changes to HSM settings.

" - }, - "IPRange":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the IP range, for example, \"authorized\".

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range in Classless Inter-Domain Routing (CIDR) notation.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the IP range.

" - } - }, - "documentation":"

Describes an IP range used in a security group.

" - }, - "IPRangeList":{ - "type":"list", - "member":{ - "shape":"IPRange", - "locationName":"IPRange" - } - }, - "IamRoleArnList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"IamRoleArn" - } - }, - "ImportTablesCompleted":{ - "type":"list", - "member":{"shape":"String"} - }, - "ImportTablesInProgress":{ - "type":"list", - "member":{"shape":"String"} - }, - "ImportTablesNotStarted":{ - "type":"list", - "member":{"shape":"String"} - }, - "InProgressTableRestoreQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You have exceeded the allowed number of table restore requests. Wait for your current table restore requests to complete before making a new request.

", - "error":{ - "code":"InProgressTableRestoreQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "IncompatibleOrderableOptions":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified options are incompatible.

", - "error":{ - "code":"IncompatibleOrderableOptions", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientClusterCapacityFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of nodes specified exceeds the allotted capacity of the cluster.

", - "error":{ - "code":"InsufficientClusterCapacity", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InsufficientS3BucketPolicyFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster does not have read bucket or put object permissions on the S3 bucket specified when enabling logging.

", - "error":{ - "code":"InsufficientS3BucketPolicyFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Integer":{"type":"integer"}, - "IntegerOptional":{"type":"integer"}, - "InvalidClusterParameterGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster parameter group action can not be completed because another task is in progress that involves the parameter group. Wait a few moments and try the operation again.

", - "error":{ - "code":"InvalidClusterParameterGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterSecurityGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the cluster security group is not available.

", - "error":{ - "code":"InvalidClusterSecurityGroupState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterSnapshotStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified cluster snapshot is not in the available state, or other accounts are authorized to access the snapshot.

", - "error":{ - "code":"InvalidClusterSnapshotState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified cluster is not in the available state.

", - "error":{ - "code":"InvalidClusterState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterSubnetGroupStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster subnet group cannot be deleted because it is in use.

", - "error":{ - "code":"InvalidClusterSubnetGroupStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterSubnetStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The state of the subnet is invalid.

", - "error":{ - "code":"InvalidClusterSubnetStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidClusterTrackFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The provided cluster track name is not valid.

", - "error":{ - "code":"InvalidClusterTrack", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidElasticIpFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Elastic IP (EIP) is invalid or cannot be found.

", - "error":{ - "code":"InvalidElasticIpFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidHsmClientCertificateStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified HSM client certificate is not in the available state, or it is still in use by one or more Amazon Redshift clusters.

", - "error":{ - "code":"InvalidHsmClientCertificateStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidHsmConfigurationStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified HSM configuration is not in the available state, or it is still in use by one or more Amazon Redshift clusters.

", - "error":{ - "code":"InvalidHsmConfigurationStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidReservedNodeStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the Reserved Node being exchanged is not in an active state.

", - "error":{ - "code":"InvalidReservedNodeState", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidRestoreFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The restore is invalid.

", - "error":{ - "code":"InvalidRestore", - "httpStatusCode":406, - "senderFault":true - }, - "exception":true - }, - "InvalidS3BucketNameFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The S3 bucket name is invalid. For more information about naming rules, go to Bucket Restrictions and Limitations in the Amazon Simple Storage Service (S3) Developer Guide.

", - "error":{ - "code":"InvalidS3BucketNameFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidS3KeyPrefixFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The string specified for the logging S3 key prefix does not comply with the documented constraints.

", - "error":{ - "code":"InvalidS3KeyPrefixFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSnapshotCopyGrantStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The snapshot copy grant can't be deleted because it is used by one or more clusters.

", - "error":{ - "code":"InvalidSnapshotCopyGrantStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubnet":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested subnet is not valid, or not all of the subnets are in the same VPC.

", - "error":{ - "code":"InvalidSubnet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSubscriptionStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The subscription request is invalid because it is a duplicate request. This subscription request is already in progress.

", - "error":{ - "code":"InvalidSubscriptionStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidTableRestoreArgumentFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The value specified for the sourceDatabaseName, sourceSchemaName, or sourceTableName parameter, or a combination of these, doesn't exist in the snapshot.

", - "error":{ - "code":"InvalidTableRestoreArgument", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidTagFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The tag is invalid.

", - "error":{ - "code":"InvalidTagFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidVPCNetworkStateFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster subnet group does not cover all Availability Zones.

", - "error":{ - "code":"InvalidVPCNetworkStateFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LimitExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The encryption key has exceeded its grant limit in AWS KMS.

", - "error":{ - "code":"LimitExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "LoggingStatus":{ - "type":"structure", - "members":{ - "LoggingEnabled":{ - "shape":"Boolean", - "documentation":"

true if logging is on, false if logging is off.

" - }, - "BucketName":{ - "shape":"String", - "documentation":"

The name of the S3 bucket where the log files are stored.

" - }, - "S3KeyPrefix":{ - "shape":"String", - "documentation":"

The prefix applied to the log file names.

" - }, - "LastSuccessfulDeliveryTime":{ - "shape":"TStamp", - "documentation":"

The last time that logs were delivered.

" - }, - "LastFailureTime":{ - "shape":"TStamp", - "documentation":"

The last time when logs failed to be delivered.

" - }, - "LastFailureMessage":{ - "shape":"String", - "documentation":"

The message indicating that logs failed to be delivered.

" - } - }, - "documentation":"

Describes the status of logging for a cluster.

" - }, - "Long":{"type":"long"}, - "LongOptional":{"type":"long"}, - "MaintenanceTrack":{ - "type":"structure", - "members":{ - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track. Possible values are current and trailing.

" - }, - "DatabaseVersion":{ - "shape":"String", - "documentation":"

The version number for the cluster release.

" - }, - "UpdateTargets":{ - "shape":"EligibleTracksToUpdateList", - "documentation":"

An array of UpdateTarget objects to update with the maintenance track.

" - } - }, - "documentation":"

Defines a maintenance track that determines which Amazon Redshift version to apply during a maintenance window. If the value for MaintenanceTrack is current, the cluster is updated to the most recently certified maintenance release. If the value is trailing, the cluster is updated to the previously certified maintenance release.

" - }, - "ModifyClusterDbRevisionMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "RevisionTarget" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of a cluster whose database revision you want to modify.

Example: examplecluster

" - }, - "RevisionTarget":{ - "shape":"String", - "documentation":"

The identifier of the database revision. You can retrieve this value from the response to the DescribeClusterDbRevisions request.

" - } - } - }, - "ModifyClusterDbRevisionResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "ModifyClusterIamRolesMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster for which you want to associate or disassociate IAM roles.

" - }, - "AddIamRoles":{ - "shape":"IamRoleArnList", - "documentation":"

Zero or more IAM roles to associate with the cluster. The roles must be in their Amazon Resource Name (ARN) format. You can associate up to 10 IAM roles with a single cluster in a single request.

" - }, - "RemoveIamRoles":{ - "shape":"IamRoleArnList", - "documentation":"

Zero or more IAM roles in ARN format to disassociate from the cluster. You can disassociate up to 10 IAM roles from a single cluster in a single request.

" - } - }, - "documentation":"

" - }, - "ModifyClusterIamRolesResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "ModifyClusterMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster to be modified.

Example: examplecluster

" - }, - "ClusterType":{ - "shape":"String", - "documentation":"

The new cluster type.

When you submit your cluster resize request, your existing cluster goes into a read-only mode. After Amazon Redshift provisions a new cluster based on your resize requirements, there will be outage for a period while the old cluster is deleted and your connection is switched to the new cluster. You can use DescribeResize to track the progress of the resize request.

Valid Values: multi-node | single-node

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The new node type of the cluster. If you specify a new node type, you must also specify the number of nodes parameter.

When you submit your request to resize a cluster, Amazon Redshift sets access permissions for the cluster to read-only. After Amazon Redshift provisions a new cluster according to your resize requirements, there will be a temporary outage while the old cluster is deleted and your connection is switched to the new cluster. When the new connection is complete, the original access permissions for the cluster are restored. You can use DescribeResize to track the progress of the resize request.

Valid Values: ds2.xlarge | ds2.8xlarge | dc1.large | dc1.8xlarge | dc2.large | dc2.8xlarge

" - }, - "NumberOfNodes":{ - "shape":"IntegerOptional", - "documentation":"

The new number of nodes of the cluster. If you specify a new number of nodes, you must also specify the node type parameter.

When you submit your request to resize a cluster, Amazon Redshift sets access permissions for the cluster to read-only. After Amazon Redshift provisions a new cluster according to your resize requirements, there will be a temporary outage while the old cluster is deleted and your connection is switched to the new cluster. When the new connection is complete, the original access permissions for the cluster are restored. You can use DescribeResize to track the progress of the resize request.

Valid Values: Integer greater than 0.

" - }, - "ClusterSecurityGroups":{ - "shape":"ClusterSecurityGroupNameList", - "documentation":"

A list of cluster security groups to be authorized on this cluster. This change is asynchronously applied as soon as possible.

Security groups currently associated with the cluster, and not in the list of groups to apply, will be revoked from the cluster.

Constraints:

  • Must be 1 to 255 alphanumeric characters or hyphens

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of virtual private cloud (VPC) security groups to be associated with the cluster. This change is asynchronously applied as soon as possible.

" - }, - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The new password for the cluster master user. This change is asynchronously applied as soon as possible. Between the time of the request and the completion of the request, the MasterUserPassword element exists in the PendingModifiedValues element of the operation response.

Operations never return the password, so this operation provides a way to regain access to the master user account for a cluster if the password is lost.

Default: Uses existing setting.

Constraints:

  • Must be between 8 and 64 characters in length.

  • Must contain at least one uppercase letter.

  • Must contain at least one lowercase letter.

  • Must contain one number.

  • Can be any printable ASCII character (ASCII code 33 to 126) except ' (single quote), \" (double quote), \\, /, @, or space.

" - }, - "ClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group to apply to this cluster. This change is applied only after the cluster is rebooted. To reboot a cluster use RebootCluster.

Default: Uses existing setting.

Constraints: The cluster parameter group must be in the same parameter group family that matches the cluster version.

" - }, - "AutomatedSnapshotRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with CreateClusterSnapshot.

If you decrease the automated snapshot retention period from its current value, existing automated snapshots that fall outside of the new retention period will be immediately deleted.

Default: Uses existing setting.

Constraints: Must be a value from 0 to 35.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which system maintenance can occur, if necessary. If system maintenance is necessary during the window, it may result in an outage.

This maintenance window change is made immediately. If the new maintenance window indicates the current time, there must be at least 120 minutes between the current time and end of the window in order to ensure that pending changes are applied.

Default: Uses existing setting.

Format: ddd:hh24:mi-ddd:hh24:mi, for example wed:07:30-wed:08:00.

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Must be at least 30 minutes.

" - }, - "ClusterVersion":{ - "shape":"String", - "documentation":"

The new version number of the Amazon Redshift engine to upgrade to.

For major version upgrades, if a non-default cluster parameter group is currently in use, a new cluster parameter group in the cluster parameter group family for the new version must be specified. The new cluster parameter group can be the default for that cluster parameter group family. For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

Example: 1.0

" - }, - "AllowVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

If true, major version upgrades will be applied automatically to the cluster during the maintenance window.

Default: false

" - }, - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM client certificate the Amazon Redshift cluster uses to retrieve the data encryption keys stored in an HSM.

" - }, - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM configuration that contains the information the Amazon Redshift cluster can use to retrieve and store keys in an HSM.

" - }, - "NewClusterIdentifier":{ - "shape":"String", - "documentation":"

The new identifier for the cluster.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • Alphabetic characters must be lowercase.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique for all clusters within an AWS account.

Example: examplecluster

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

If true, the cluster can be accessed from a public network. Only clusters in VPCs can be set to be publicly available.

" - }, - "ElasticIp":{ - "shape":"String", - "documentation":"

The Elastic IP (EIP) address for the cluster.

Constraints: The cluster must be provisioned in EC2-VPC and publicly-accessible through an Internet gateway. For more information about provisioning clusters in EC2-VPC, go to Supported Platforms to Launch Your Cluster in the Amazon Redshift Cluster Management Guide.

" - }, - "EnhancedVpcRouting":{ - "shape":"BooleanOptional", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name for the maintenance track that you want to assign for the cluster. This name change is asynchronous. The new track name stays in the PendingModifiedValues for the cluster until the next maintenance window. When the maintenance track changes, the cluster is switched to the latest cluster release available for the maintenance track. At this point, the maintenance track name is applied.

" - } - }, - "documentation":"

" - }, - "ModifyClusterParameterGroupMessage":{ - "type":"structure", - "required":[ - "ParameterGroupName", - "Parameters" - ], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to be modified.

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of parameters to be modified. A maximum of 20 parameters can be modified in a single request.

For each parameter to be modified, you must supply at least the parameter name and parameter value; other name-value pairs of the parameter are optional.

For the workload management (WLM) configuration, you must supply all the name-value pairs in the wlm_json_configuration parameter.

" - } - }, - "documentation":"

" - }, - "ModifyClusterResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "ModifyClusterSubnetGroupMessage":{ - "type":"structure", - "required":[ - "ClusterSubnetGroupName", - "SubnetIds" - ], - "members":{ - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group to be modified.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A text description of the subnet group to be modified.

" - }, - "SubnetIds":{ - "shape":"SubnetIdentifierList", - "documentation":"

An array of VPC subnet IDs. A maximum of 20 subnets can be modified in a single request.

" - } - }, - "documentation":"

" - }, - "ModifyClusterSubnetGroupResult":{ - "type":"structure", - "members":{ - "ClusterSubnetGroup":{"shape":"ClusterSubnetGroup"} - } - }, - "ModifyEventSubscriptionMessage":{ - "type":"structure", - "required":["SubscriptionName"], - "members":{ - "SubscriptionName":{ - "shape":"String", - "documentation":"

The name of the modified Amazon Redshift event notification subscription.

" - }, - "SnsTopicArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic to be used by the event notification subscription.

" - }, - "SourceType":{ - "shape":"String", - "documentation":"

The type of source that will be generating the events. For example, if you want to be notified of events generated by a cluster, you would set this parameter to cluster. If this value is not specified, events are returned for all Amazon Redshift objects in your AWS account. You must specify a source type in order to specify source IDs.

Valid values: cluster, cluster-parameter-group, cluster-security-group, and cluster-snapshot.

" - }, - "SourceIds":{ - "shape":"SourceIdsList", - "documentation":"

A list of one or more identifiers of Amazon Redshift source objects. All of the objects must be of the same type as was specified in the source type parameter. The event subscription will return only events generated by the specified objects. If not specified, then events are returned for all objects within the source type specified.

Example: my-cluster-1, my-cluster-2

Example: my-snapshot-20131010

" - }, - "EventCategories":{ - "shape":"EventCategoriesList", - "documentation":"

Specifies the Amazon Redshift event categories to be published by the event notification subscription.

Values: Configuration, Management, Monitoring, Security

" - }, - "Severity":{ - "shape":"String", - "documentation":"

Specifies the Amazon Redshift event severity to be published by the event notification subscription.

Values: ERROR, INFO

" - }, - "Enabled":{ - "shape":"BooleanOptional", - "documentation":"

A Boolean value indicating if the subscription is enabled. true indicates the subscription is enabled

" - } - }, - "documentation":"

" - }, - "ModifyEventSubscriptionResult":{ - "type":"structure", - "members":{ - "EventSubscription":{"shape":"EventSubscription"} - } - }, - "ModifySnapshotCopyRetentionPeriodMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "RetentionPeriod" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster for which you want to change the retention period for automated snapshots that are copied to a destination region.

Constraints: Must be the valid name of an existing cluster that has cross-region snapshot copy enabled.

" - }, - "RetentionPeriod":{ - "shape":"Integer", - "documentation":"

The number of days to retain automated snapshots in the destination region after they are copied from the source region.

If you decrease the retention period for automated snapshots that are copied to a destination region, Amazon Redshift will delete any existing automated snapshots that were copied to the destination region and that fall outside of the new retention period.

Constraints: Must be at least 1 and no more than 35.

" - } - }, - "documentation":"

" - }, - "ModifySnapshotCopyRetentionPeriodResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "NumberOfNodesPerClusterLimitExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation would exceed the number of nodes allowed for a cluster.

", - "error":{ - "code":"NumberOfNodesPerClusterLimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NumberOfNodesQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation would exceed the number of nodes allotted to the account. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"NumberOfNodesQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "OrderableClusterOption":{ - "type":"structure", - "members":{ - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version of the orderable cluster.

" - }, - "ClusterType":{ - "shape":"String", - "documentation":"

The cluster type, for example multi-node.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type for the orderable cluster.

" - }, - "AvailabilityZones":{ - "shape":"AvailabilityZoneList", - "documentation":"

A list of availability zones for the orderable cluster.

" - } - }, - "documentation":"

Describes an orderable cluster option.

", - "wrapper":true - }, - "OrderableClusterOptionsList":{ - "type":"list", - "member":{ - "shape":"OrderableClusterOption", - "locationName":"OrderableClusterOption" - } - }, - "OrderableClusterOptionsMessage":{ - "type":"structure", - "members":{ - "OrderableClusterOptions":{ - "shape":"OrderableClusterOptionsList", - "documentation":"

An OrderableClusterOption structure containing information about orderable options for the cluster.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - } - }, - "documentation":"

Contains the output from the DescribeOrderableClusterOptions action.

" - }, - "Parameter":{ - "type":"structure", - "members":{ - "ParameterName":{ - "shape":"String", - "documentation":"

The name of the parameter.

" - }, - "ParameterValue":{ - "shape":"String", - "documentation":"

The value of the parameter.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A description of the parameter.

" - }, - "Source":{ - "shape":"String", - "documentation":"

The source of the parameter value, such as \"engine-default\" or \"user\".

" - }, - "DataType":{ - "shape":"String", - "documentation":"

The data type of the parameter.

" - }, - "AllowedValues":{ - "shape":"String", - "documentation":"

The valid range of values for the parameter.

" - }, - "ApplyType":{ - "shape":"ParameterApplyType", - "documentation":"

Specifies how to apply the WLM configuration parameter. Some properties can be applied dynamically, while other properties require that any associated clusters be rebooted for the configuration changes to be applied. For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

" - }, - "IsModifiable":{ - "shape":"Boolean", - "documentation":"

If true, the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.

" - }, - "MinimumEngineVersion":{ - "shape":"String", - "documentation":"

The earliest engine version to which the parameter can apply.

" - } - }, - "documentation":"

Describes a parameter in a cluster parameter group.

" - }, - "ParameterApplyType":{ - "type":"string", - "enum":[ - "static", - "dynamic" - ] - }, - "ParameterGroupList":{ - "type":"list", - "member":{ - "shape":"ClusterParameterGroup", - "locationName":"ClusterParameterGroup" - } - }, - "ParametersList":{ - "type":"list", - "member":{ - "shape":"Parameter", - "locationName":"Parameter" - } - }, - "PendingActionsList":{ - "type":"list", - "member":{"shape":"String"} - }, - "PendingModifiedValues":{ - "type":"structure", - "members":{ - "MasterUserPassword":{ - "shape":"String", - "documentation":"

The pending or in-progress change of the master user password for the cluster.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The pending or in-progress change of the cluster's node type.

" - }, - "NumberOfNodes":{ - "shape":"IntegerOptional", - "documentation":"

The pending or in-progress change of the number of nodes in the cluster.

" - }, - "ClusterType":{ - "shape":"String", - "documentation":"

The pending or in-progress change of the cluster type.

" - }, - "ClusterVersion":{ - "shape":"String", - "documentation":"

The pending or in-progress change of the service version.

" - }, - "AutomatedSnapshotRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The pending or in-progress change of the automated snapshot retention period.

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The pending or in-progress change of the new identifier for the cluster.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

The pending or in-progress change of the ability to connect to the cluster from the public network.

" - }, - "EnhancedVpcRouting":{ - "shape":"BooleanOptional", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track that the cluster will change to during the next maintenance window.

" - } - }, - "documentation":"

Describes cluster attributes that are in a pending state. A change to one or more the attributes was requested and is in progress or will be applied.

" - }, - "PurchaseReservedNodeOfferingMessage":{ - "type":"structure", - "required":["ReservedNodeOfferingId"], - "members":{ - "ReservedNodeOfferingId":{ - "shape":"String", - "documentation":"

The unique identifier of the reserved node offering you want to purchase.

" - }, - "NodeCount":{ - "shape":"IntegerOptional", - "documentation":"

The number of reserved nodes that you want to purchase.

Default: 1

" - } - }, - "documentation":"

" - }, - "PurchaseReservedNodeOfferingResult":{ - "type":"structure", - "members":{ - "ReservedNode":{"shape":"ReservedNode"} - } - }, - "RebootClusterMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The cluster identifier.

" - } - }, - "documentation":"

" - }, - "RebootClusterResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "RecurringCharge":{ - "type":"structure", - "members":{ - "RecurringChargeAmount":{ - "shape":"Double", - "documentation":"

The amount charged per the period of time specified by the recurring charge frequency.

" - }, - "RecurringChargeFrequency":{ - "shape":"String", - "documentation":"

The frequency at which the recurring charge amount is applied.

" - } - }, - "documentation":"

Describes a recurring charge.

", - "wrapper":true - }, - "RecurringChargeList":{ - "type":"list", - "member":{ - "shape":"RecurringCharge", - "locationName":"RecurringCharge" - } - }, - "ReservedNode":{ - "type":"structure", - "members":{ - "ReservedNodeId":{ - "shape":"String", - "documentation":"

The unique identifier for the reservation.

" - }, - "ReservedNodeOfferingId":{ - "shape":"String", - "documentation":"

The identifier for the reserved node offering.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type of the reserved node.

" - }, - "StartTime":{ - "shape":"TStamp", - "documentation":"

The time the reservation started. You purchase a reserved node offering for a duration. This is the start time of that duration.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration of the node reservation in seconds.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The fixed cost Amazon Redshift charges you for this reserved node.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The hourly rate Amazon Redshift charges you for this reserved node.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the reserved cluster.

" - }, - "NodeCount":{ - "shape":"Integer", - "documentation":"

The number of reserved compute nodes.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of the reserved compute node.

Possible Values:

  • pending-payment-This reserved node has recently been purchased, and the sale has been approved, but payment has not yet been confirmed.

  • active-This reserved node is owned by the caller and is available for use.

  • payment-failed-Payment failed for the purchase attempt.

  • retired-The reserved node is no longer available.

  • exchanging-The owner is exchanging the reserved node for another reserved node.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The anticipated utilization of the reserved node, as defined in the reserved node offering.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The recurring charges for the reserved node.

" - }, - "ReservedNodeOfferingType":{"shape":"ReservedNodeOfferingType"} - }, - "documentation":"

Describes a reserved node. You can call the DescribeReservedNodeOfferings API to obtain the available reserved node offerings.

", - "wrapper":true - }, - "ReservedNodeAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

User already has a reservation with the given identifier.

", - "error":{ - "code":"ReservedNodeAlreadyExists", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedNodeAlreadyMigratedFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the reserved node has already been exchanged.

", - "error":{ - "code":"ReservedNodeAlreadyMigrated", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ReservedNodeList":{ - "type":"list", - "member":{ - "shape":"ReservedNode", - "locationName":"ReservedNode" - } - }, - "ReservedNodeNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified reserved compute node not found.

", - "error":{ - "code":"ReservedNodeNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedNodeOffering":{ - "type":"structure", - "members":{ - "ReservedNodeOfferingId":{ - "shape":"String", - "documentation":"

The offering identifier.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type offered by the reserved node offering.

" - }, - "Duration":{ - "shape":"Integer", - "documentation":"

The duration, in seconds, for which the offering will reserve the node.

" - }, - "FixedPrice":{ - "shape":"Double", - "documentation":"

The upfront fixed charge you will pay to purchase the specific reserved node offering.

" - }, - "UsagePrice":{ - "shape":"Double", - "documentation":"

The rate you are charged for each hour the cluster that is using the offering is running.

" - }, - "CurrencyCode":{ - "shape":"String", - "documentation":"

The currency code for the compute nodes offering.

" - }, - "OfferingType":{ - "shape":"String", - "documentation":"

The anticipated utilization of the reserved node, as defined in the reserved node offering.

" - }, - "RecurringCharges":{ - "shape":"RecurringChargeList", - "documentation":"

The charge to your account regardless of whether you are creating any clusters using the node offering. Recurring charges are only in effect for heavy-utilization reserved nodes.

" - }, - "ReservedNodeOfferingType":{"shape":"ReservedNodeOfferingType"} - }, - "documentation":"

Describes a reserved node offering.

", - "wrapper":true - }, - "ReservedNodeOfferingList":{ - "type":"list", - "member":{ - "shape":"ReservedNodeOffering", - "locationName":"ReservedNodeOffering" - } - }, - "ReservedNodeOfferingNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Specified offering does not exist.

", - "error":{ - "code":"ReservedNodeOfferingNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ReservedNodeOfferingType":{ - "type":"string", - "enum":[ - "Regular", - "Upgradable" - ] - }, - "ReservedNodeOfferingsMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ReservedNodeOfferings":{ - "shape":"ReservedNodeOfferingList", - "documentation":"

A list of ReservedNodeOffering objects.

" - } - }, - "documentation":"

" - }, - "ReservedNodeQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request would exceed the user's compute node quota. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

", - "error":{ - "code":"ReservedNodeQuotaExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ReservedNodesMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "ReservedNodes":{ - "shape":"ReservedNodeList", - "documentation":"

The list of ReservedNode objects.

" - } - }, - "documentation":"

" - }, - "ResetClusterParameterGroupMessage":{ - "type":"structure", - "required":["ParameterGroupName"], - "members":{ - "ParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the cluster parameter group to be reset.

" - }, - "ResetAllParameters":{ - "shape":"Boolean", - "documentation":"

If true, all parameters in the specified parameter group will be reset to their default values.

Default: true

" - }, - "Parameters":{ - "shape":"ParametersList", - "documentation":"

An array of names of parameters to be reset. If ResetAllParameters option is not used, then at least one parameter name must be supplied.

Constraints: A maximum of 20 parameters can be reset in a single request.

" - } - }, - "documentation":"

" - }, - "ResizeNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A resize operation for the specified cluster is not found.

", - "error":{ - "code":"ResizeNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "ResizeProgressMessage":{ - "type":"structure", - "members":{ - "TargetNodeType":{ - "shape":"String", - "documentation":"

The node type that the cluster will have after the resize operation is complete.

" - }, - "TargetNumberOfNodes":{ - "shape":"IntegerOptional", - "documentation":"

The number of nodes that the cluster will have after the resize operation is complete.

" - }, - "TargetClusterType":{ - "shape":"String", - "documentation":"

The cluster type after the resize operation is complete.

Valid Values: multi-node | single-node

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the resize operation.

Valid Values: NONE | IN_PROGRESS | FAILED | SUCCEEDED

" - }, - "ImportTablesCompleted":{ - "shape":"ImportTablesCompleted", - "documentation":"

The names of tables that have been completely imported .

Valid Values: List of table names.

" - }, - "ImportTablesInProgress":{ - "shape":"ImportTablesInProgress", - "documentation":"

The names of tables that are being currently imported.

Valid Values: List of table names.

" - }, - "ImportTablesNotStarted":{ - "shape":"ImportTablesNotStarted", - "documentation":"

The names of tables that have not been yet imported.

Valid Values: List of table names

" - }, - "AvgResizeRateInMegaBytesPerSecond":{ - "shape":"DoubleOptional", - "documentation":"

The average rate of the resize operation over the last few minutes, measured in megabytes per second. After the resize operation completes, this value shows the average rate of the entire resize operation.

" - }, - "TotalResizeDataInMegaBytes":{ - "shape":"LongOptional", - "documentation":"

The estimated total amount of data, in megabytes, on the cluster before the resize operation began.

" - }, - "ProgressInMegaBytes":{ - "shape":"LongOptional", - "documentation":"

While the resize operation is in progress, this value shows the current amount of data, in megabytes, that has been processed so far. When the resize operation is complete, this value shows the total amount of data, in megabytes, on the cluster, which may be more or less than TotalResizeDataInMegaBytes (the estimated total amount of data before resize).

" - }, - "ElapsedTimeInSeconds":{ - "shape":"LongOptional", - "documentation":"

The amount of seconds that have elapsed since the resize operation began. After the resize operation completes, this value shows the total actual time, in seconds, for the resize operation.

" - }, - "EstimatedTimeToCompletionInSeconds":{ - "shape":"LongOptional", - "documentation":"

The estimated time remaining, in seconds, until the resize operation is complete. This value is calculated based on the average resize rate and the estimated amount of data remaining to be processed. Once the resize operation is complete, this value will be 0.

" - } - }, - "documentation":"

Describes the result of a cluster resize operation.

" - }, - "ResourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The resource could not be found.

", - "error":{ - "code":"ResourceNotFoundFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "RestorableNodeTypeList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"NodeType" - } - }, - "RestoreFromClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "SnapshotIdentifier" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster that will be created from restoring the snapshot.

Constraints:

  • Must contain from 1 to 63 alphanumeric characters or hyphens.

  • Alphabetic characters must be lowercase.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

  • Must be unique for all clusters within an AWS account.

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The name of the snapshot from which to create the new cluster. This parameter isn't case sensitive.

Example: my-snapshot-id

" - }, - "SnapshotClusterIdentifier":{ - "shape":"String", - "documentation":"

The name of the cluster the source snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

" - }, - "Port":{ - "shape":"IntegerOptional", - "documentation":"

The port number on which the cluster accepts connections.

Default: The same port as the original cluster.

Constraints: Must be between 1115 and 65535.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Amazon EC2 Availability Zone in which to restore the cluster.

Default: A random, system-chosen Availability Zone.

Example: us-east-1a

" - }, - "AllowVersionUpgrade":{ - "shape":"BooleanOptional", - "documentation":"

If true, major version upgrades can be applied during the maintenance window to the Amazon Redshift engine that is running on the cluster.

Default: true

" - }, - "ClusterSubnetGroupName":{ - "shape":"String", - "documentation":"

The name of the subnet group where you want to cluster restored.

A snapshot of cluster in VPC can be restored only in VPC. Therefore, you must provide subnet group name where you want the cluster restored.

" - }, - "PubliclyAccessible":{ - "shape":"BooleanOptional", - "documentation":"

If true, the cluster can be accessed from a public network.

" - }, - "OwnerAccount":{ - "shape":"String", - "documentation":"

The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.

" - }, - "HsmClientCertificateIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM client certificate the Amazon Redshift cluster uses to retrieve the data encryption keys stored in an HSM.

" - }, - "HsmConfigurationIdentifier":{ - "shape":"String", - "documentation":"

Specifies the name of the HSM configuration that contains the information the Amazon Redshift cluster can use to retrieve and store keys in an HSM.

" - }, - "ElasticIp":{ - "shape":"String", - "documentation":"

The elastic IP (EIP) address for the cluster.

" - }, - "ClusterParameterGroupName":{ - "shape":"String", - "documentation":"

The name of the parameter group to be associated with this cluster.

Default: The default Amazon Redshift cluster parameter group. For information about the default parameter group, go to Working with Amazon Redshift Parameter Groups.

Constraints:

  • Must be 1 to 255 alphanumeric characters or hyphens.

  • First character must be a letter.

  • Cannot end with a hyphen or contain two consecutive hyphens.

" - }, - "ClusterSecurityGroups":{ - "shape":"ClusterSecurityGroupNameList", - "documentation":"

A list of security groups to be associated with this cluster.

Default: The default cluster security group for Amazon Redshift.

Cluster security groups only apply to clusters outside of VPCs.

" - }, - "VpcSecurityGroupIds":{ - "shape":"VpcSecurityGroupIdList", - "documentation":"

A list of Virtual Private Cloud (VPC) security groups to be associated with the cluster.

Default: The default VPC security group is associated with the cluster.

VPC security groups only apply to clusters in VPCs.

" - }, - "PreferredMaintenanceWindow":{ - "shape":"String", - "documentation":"

The weekly time range (in UTC) during which automated cluster maintenance can occur.

Format: ddd:hh24:mi-ddd:hh24:mi

Default: The value selected for the cluster from which the snapshot was taken. For more information about the time blocks for each region, see Maintenance Windows in Amazon Redshift Cluster Management Guide.

Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun

Constraints: Minimum 30-minute window.

" - }, - "AutomatedSnapshotRetentionPeriod":{ - "shape":"IntegerOptional", - "documentation":"

The number of days that automated snapshots are retained. If the value is 0, automated snapshots are disabled. Even if automated snapshots are disabled, you can still create manual snapshots when you want with CreateClusterSnapshot.

Default: The value selected for the cluster from which the snapshot was taken.

Constraints: Must be a value from 0 to 35.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS Key Management Service (KMS) key ID of the encryption key that you want to use to encrypt data in the cluster that you restore from a shared snapshot.

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type that the restored cluster will be provisioned with.

Default: The node type of the cluster from which the snapshot was taken. You can modify this if you are using any DS node type. In that case, you can choose to restore into another DS node type of the same size. For example, you can restore ds1.8xlarge into ds2.8xlarge, or ds1.xlarge into ds2.xlarge. If you have a DC instance type, you must restore into that same instance type and size. In other words, you can only restore a dc1.large instance type into another dc1.large instance type or dc2.large instance type. You can't restore dc1.8xlarge to dc2.8xlarge. First restore to a dc1.8xlareg cluster, then resize to a dc2.8large cluster. For more information about node types, see About Clusters and Nodes in the Amazon Redshift Cluster Management Guide.

" - }, - "EnhancedVpcRouting":{ - "shape":"BooleanOptional", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "AdditionalInfo":{ - "shape":"String", - "documentation":"

Reserved.

" - }, - "IamRoles":{ - "shape":"IamRoleArnList", - "documentation":"

A list of AWS Identity and Access Management (IAM) roles that can be used by the cluster to access other AWS services. You must supply the IAM roles in their Amazon Resource Name (ARN) format. You can supply up to 10 IAM roles in a single request.

A cluster can have up to 10 IAM roles associated at any time.

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track for the restored cluster. When you take a snapshot, the snapshot inherits the MaintenanceTrack value from the cluster. The snapshot might be on a different track than the cluster that was the source for the snapshot. For example, suppose that you take a snapshot of a cluster that is on the current track and then change the cluster to be on the trailing track. In this case, the snapshot and the source cluster are on different tracks.

" - } - }, - "documentation":"

" - }, - "RestoreFromClusterSnapshotResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "RestoreStatus":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

The status of the restore action. Returns starting, restoring, completed, or failed.

" - }, - "CurrentRestoreRateInMegaBytesPerSecond":{ - "shape":"Double", - "documentation":"

The number of megabytes per second being transferred from the backup storage. Returns the average rate for a completed backup.

" - }, - "SnapshotSizeInMegaBytes":{ - "shape":"Long", - "documentation":"

The size of the set of snapshot data used to restore the cluster.

" - }, - "ProgressInMegaBytes":{ - "shape":"Long", - "documentation":"

The number of megabytes that have been transferred from snapshot storage.

" - }, - "ElapsedTimeInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time an in-progress restore has been running, or the amount of time it took a completed restore to finish.

" - }, - "EstimatedTimeToCompletionInSeconds":{ - "shape":"Long", - "documentation":"

The estimate of the time remaining before the restore will complete. Returns 0 for a completed restore.

" - } - }, - "documentation":"

Describes the status of a cluster restore action. Returns null if the cluster was not created by restoring a snapshot.

" - }, - "RestoreTableFromClusterSnapshotMessage":{ - "type":"structure", - "required":[ - "ClusterIdentifier", - "SnapshotIdentifier", - "SourceDatabaseName", - "SourceTableName", - "NewTableName" - ], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the Amazon Redshift cluster to restore the table to.

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the snapshot to restore the table from. This snapshot must have been created from the Amazon Redshift cluster specified by the ClusterIdentifier parameter.

" - }, - "SourceDatabaseName":{ - "shape":"String", - "documentation":"

The name of the source database that contains the table to restore from.

" - }, - "SourceSchemaName":{ - "shape":"String", - "documentation":"

The name of the source schema that contains the table to restore from. If you do not specify a SourceSchemaName value, the default is public.

" - }, - "SourceTableName":{ - "shape":"String", - "documentation":"

The name of the source table to restore from.

" - }, - "TargetDatabaseName":{ - "shape":"String", - "documentation":"

The name of the database to restore the table to.

" - }, - "TargetSchemaName":{ - "shape":"String", - "documentation":"

The name of the schema to restore the table to.

" - }, - "NewTableName":{ - "shape":"String", - "documentation":"

The name of the table to create as a result of the current request.

" - } - }, - "documentation":"

" - }, - "RestoreTableFromClusterSnapshotResult":{ - "type":"structure", - "members":{ - "TableRestoreStatus":{"shape":"TableRestoreStatus"} - } - }, - "RevisionTarget":{ - "type":"structure", - "members":{ - "DatabaseRevision":{ - "shape":"String", - "documentation":"

A unique string that identifies the version to update the cluster to. You can use this value in ModifyClusterDbRevision.

" - }, - "Description":{ - "shape":"String", - "documentation":"

A string that describes the changes and features that will be applied to the cluster when it is updated to the corresponding ClusterDbRevision.

" - }, - "DatabaseRevisionReleaseDate":{ - "shape":"TStamp", - "documentation":"

The date on which the database revision was released.

" - } - }, - "documentation":"

Describes a RevisionTarget.

" - }, - "RevisionTargetsList":{ - "type":"list", - "member":{ - "shape":"RevisionTarget", - "locationName":"RevisionTarget" - } - }, - "RevokeClusterSecurityGroupIngressMessage":{ - "type":"structure", - "required":["ClusterSecurityGroupName"], - "members":{ - "ClusterSecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the security Group from which to revoke the ingress rule.

" - }, - "CIDRIP":{ - "shape":"String", - "documentation":"

The IP range for which to revoke access. This range must be a valid Classless Inter-Domain Routing (CIDR) block of IP addresses. If CIDRIP is specified, EC2SecurityGroupName and EC2SecurityGroupOwnerId cannot be provided.

" - }, - "EC2SecurityGroupName":{ - "shape":"String", - "documentation":"

The name of the EC2 Security Group whose access is to be revoked. If EC2SecurityGroupName is specified, EC2SecurityGroupOwnerId must also be provided and CIDRIP cannot be provided.

" - }, - "EC2SecurityGroupOwnerId":{ - "shape":"String", - "documentation":"

The AWS account number of the owner of the security group specified in the EC2SecurityGroupName parameter. The AWS access key ID is not an acceptable value. If EC2SecurityGroupOwnerId is specified, EC2SecurityGroupName must also be provided. and CIDRIP cannot be provided.

Example: 111122223333

" - } - }, - "documentation":"

" - }, - "RevokeClusterSecurityGroupIngressResult":{ - "type":"structure", - "members":{ - "ClusterSecurityGroup":{"shape":"ClusterSecurityGroup"} - } - }, - "RevokeSnapshotAccessMessage":{ - "type":"structure", - "required":[ - "SnapshotIdentifier", - "AccountWithRestoreAccess" - ], - "members":{ - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the snapshot that the account can no longer access.

" - }, - "SnapshotClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster the snapshot was created from. This parameter is required if your IAM user has a policy containing a snapshot resource element that specifies anything other than * for the cluster name.

" - }, - "AccountWithRestoreAccess":{ - "shape":"String", - "documentation":"

The identifier of the AWS customer account that can no longer restore the specified snapshot.

" - } - }, - "documentation":"

" - }, - "RevokeSnapshotAccessResult":{ - "type":"structure", - "members":{ - "Snapshot":{"shape":"Snapshot"} - } - }, - "RotateEncryptionKeyMessage":{ - "type":"structure", - "required":["ClusterIdentifier"], - "members":{ - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The unique identifier of the cluster that you want to rotate the encryption keys for.

Constraints: Must be the name of valid cluster that has encryption enabled.

" - } - }, - "documentation":"

" - }, - "RotateEncryptionKeyResult":{ - "type":"structure", - "members":{ - "Cluster":{"shape":"Cluster"} - } - }, - "SNSInvalidTopicFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Amazon SNS has responded that there is a problem with the specified Amazon SNS topic.

", - "error":{ - "code":"SNSInvalidTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSNoAuthorizationFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

You do not have permission to publish to the specified Amazon SNS topic.

", - "error":{ - "code":"SNSNoAuthorization", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SNSTopicArnNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

An Amazon SNS topic with the specified Amazon Resource Name (ARN) does not exist.

", - "error":{ - "code":"SNSTopicArnNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SensitiveString":{ - "type":"string", - "sensitive":true - }, - "Snapshot":{ - "type":"structure", - "members":{ - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The snapshot identifier that is provided in the request.

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the cluster for which the snapshot was taken.

" - }, - "SnapshotCreateTime":{ - "shape":"TStamp", - "documentation":"

The time (UTC) when Amazon Redshift began the snapshot. A snapshot contains a copy of the cluster data as of this exact time.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The snapshot status. The value of the status depends on the API operation used.

" - }, - "Port":{ - "shape":"Integer", - "documentation":"

The port that the cluster is listening on.

" - }, - "AvailabilityZone":{ - "shape":"String", - "documentation":"

The Availability Zone in which the cluster was created.

" - }, - "ClusterCreateTime":{ - "shape":"TStamp", - "documentation":"

The time (UTC) when the cluster was originally created.

" - }, - "MasterUsername":{ - "shape":"String", - "documentation":"

The master user name for the cluster.

" - }, - "ClusterVersion":{ - "shape":"String", - "documentation":"

The version ID of the Amazon Redshift engine that is running on the cluster.

" - }, - "SnapshotType":{ - "shape":"String", - "documentation":"

The snapshot type. Snapshots created using CreateClusterSnapshot and CopyClusterSnapshot will be of type \"manual\".

" - }, - "NodeType":{ - "shape":"String", - "documentation":"

The node type of the nodes in the cluster.

" - }, - "NumberOfNodes":{ - "shape":"Integer", - "documentation":"

The number of nodes in the cluster.

" - }, - "DBName":{ - "shape":"String", - "documentation":"

The name of the database that was created when the cluster was created.

" - }, - "VpcId":{ - "shape":"String", - "documentation":"

The VPC identifier of the cluster if the snapshot is from a cluster in a VPC. Otherwise, this field is not in the output.

" - }, - "Encrypted":{ - "shape":"Boolean", - "documentation":"

If true, the data in the snapshot is encrypted at rest.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The AWS Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.

" - }, - "EncryptedWithHSM":{ - "shape":"Boolean", - "documentation":"

A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster. true indicates that the data is encrypted using HSM keys.

" - }, - "AccountsWithRestoreAccess":{ - "shape":"AccountsWithRestoreAccessList", - "documentation":"

A list of the AWS customer accounts authorized to restore the snapshot. Returns null if no accounts are authorized. Visible only to the snapshot owner.

" - }, - "OwnerAccount":{ - "shape":"String", - "documentation":"

For manual snapshots, the AWS customer account used to create or copy the snapshot. For automatic snapshots, the owner of the cluster. The owner can perform all snapshot actions, such as sharing a manual snapshot.

" - }, - "TotalBackupSizeInMegaBytes":{ - "shape":"Double", - "documentation":"

The size of the complete set of backup data that would be used to restore the cluster.

" - }, - "ActualIncrementalBackupSizeInMegaBytes":{ - "shape":"Double", - "documentation":"

The size of the incremental backup.

" - }, - "BackupProgressInMegaBytes":{ - "shape":"Double", - "documentation":"

The number of megabytes that have been transferred to the snapshot backup.

" - }, - "CurrentBackupRateInMegaBytesPerSecond":{ - "shape":"Double", - "documentation":"

The number of megabytes per second being transferred to the snapshot backup. Returns 0 for a completed backup.

" - }, - "EstimatedSecondsToCompletion":{ - "shape":"Long", - "documentation":"

The estimate of the time remaining before the snapshot backup will complete. Returns 0 for a completed backup.

" - }, - "ElapsedTimeInSeconds":{ - "shape":"Long", - "documentation":"

The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.

" - }, - "SourceRegion":{ - "shape":"String", - "documentation":"

The source region from which the snapshot was copied.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The list of tags for the cluster snapshot.

" - }, - "RestorableNodeTypes":{ - "shape":"RestorableNodeTypeList", - "documentation":"

The list of node types that this cluster snapshot is able to restore into.

" - }, - "EnhancedVpcRouting":{ - "shape":"Boolean", - "documentation":"

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

" - }, - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the maintenance track for the snapshot.

" - } - }, - "documentation":"

Describes a snapshot.

", - "wrapper":true - }, - "SnapshotCopyAlreadyDisabledFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster already has cross-region snapshot copy disabled.

", - "error":{ - "code":"SnapshotCopyAlreadyDisabledFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotCopyAlreadyEnabledFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The cluster already has cross-region snapshot copy enabled.

", - "error":{ - "code":"SnapshotCopyAlreadyEnabledFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotCopyDisabledFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

Cross-region snapshot copy was temporarily disabled. Try your request again.

", - "error":{ - "code":"SnapshotCopyDisabledFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotCopyGrant":{ - "type":"structure", - "members":{ - "SnapshotCopyGrantName":{ - "shape":"String", - "documentation":"

The name of the snapshot copy grant.

" - }, - "KmsKeyId":{ - "shape":"String", - "documentation":"

The unique identifier of the customer master key (CMK) in AWS KMS to which Amazon Redshift is granted permission.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tag instances.

" - } - }, - "documentation":"

The snapshot copy grant that grants Amazon Redshift permission to encrypt copied snapshots with the specified customer master key (CMK) from AWS KMS in the destination region.

For more information about managing snapshot copy grants, go to Amazon Redshift Database Encryption in the Amazon Redshift Cluster Management Guide.

", - "wrapper":true - }, - "SnapshotCopyGrantAlreadyExistsFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The snapshot copy grant can't be created because a grant with the same name already exists.

", - "error":{ - "code":"SnapshotCopyGrantAlreadyExistsFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotCopyGrantList":{ - "type":"list", - "member":{ - "shape":"SnapshotCopyGrant", - "locationName":"SnapshotCopyGrant" - } - }, - "SnapshotCopyGrantMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeSnapshotCopyGrant request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

Constraints: You can specify either the SnapshotCopyGrantName parameter or the Marker parameter, but not both.

" - }, - "SnapshotCopyGrants":{ - "shape":"SnapshotCopyGrantList", - "documentation":"

The list of SnapshotCopyGrant objects.

" - } - }, - "documentation":"

" - }, - "SnapshotCopyGrantNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified snapshot copy grant can't be found. Make sure that the name is typed correctly and that the grant exists in the destination region.

", - "error":{ - "code":"SnapshotCopyGrantNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotCopyGrantQuotaExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The AWS account has exceeded the maximum number of snapshot copy grants in this region.

", - "error":{ - "code":"SnapshotCopyGrantQuotaExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SnapshotList":{ - "type":"list", - "member":{ - "shape":"Snapshot", - "locationName":"Snapshot" - } - }, - "SnapshotMessage":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - }, - "Snapshots":{ - "shape":"SnapshotList", - "documentation":"

A list of Snapshot instances.

" - } - }, - "documentation":"

Contains the output from the DescribeClusterSnapshots action.

" - }, - "SourceIdsList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SourceId" - } - }, - "SourceNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified Amazon Redshift event source could not be found.

", - "error":{ - "code":"SourceNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SourceType":{ - "type":"string", - "enum":[ - "cluster", - "cluster-parameter-group", - "cluster-security-group", - "cluster-snapshot" - ] - }, - "String":{"type":"string"}, - "Subnet":{ - "type":"structure", - "members":{ - "SubnetIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the subnet.

" - }, - "SubnetAvailabilityZone":{"shape":"AvailabilityZone"}, - "SubnetStatus":{ - "shape":"String", - "documentation":"

The status of the subnet.

" - } - }, - "documentation":"

Describes a subnet.

" - }, - "SubnetAlreadyInUse":{ - "type":"structure", - "members":{ - }, - "documentation":"

A specified subnet is already in use by another cluster.

", - "error":{ - "code":"SubnetAlreadyInUse", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubnetIdentifierList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"SubnetIdentifier" - } - }, - "SubnetList":{ - "type":"list", - "member":{ - "shape":"Subnet", - "locationName":"Subnet" - } - }, - "SubscriptionAlreadyExistFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

There is already an existing event notification subscription with the specified name.

", - "error":{ - "code":"SubscriptionAlreadyExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "SubscriptionCategoryNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The value specified for the event category was not one of the allowed values, or it specified a category that does not apply to the specified source type. The allowed values are Configuration, Management, Monitoring, and Security.

", - "error":{ - "code":"SubscriptionCategoryNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SubscriptionEventIdNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

An Amazon Redshift event with the specified event ID does not exist.

", - "error":{ - "code":"SubscriptionEventIdNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SubscriptionNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

An Amazon Redshift event notification subscription with the specified name does not exist.

", - "error":{ - "code":"SubscriptionNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SubscriptionSeverityNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The value specified for the event severity was not one of the allowed values, or it specified a severity that does not apply to the specified source type. The allowed values are ERROR and INFO.

", - "error":{ - "code":"SubscriptionSeverityNotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "SupportedPlatform":{ - "type":"structure", - "members":{ - "Name":{"shape":"String"} - }, - "documentation":"

A list of supported platforms for orderable clusters.

", - "wrapper":true - }, - "SupportedPlatformsList":{ - "type":"list", - "member":{ - "shape":"SupportedPlatform", - "locationName":"SupportedPlatform" - } - }, - "TStamp":{"type":"timestamp"}, - "TableLimitExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of tables in the cluster exceeds the limit for the requested new cluster node type.

", - "error":{ - "code":"TableLimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TableRestoreNotFoundFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified TableRestoreRequestId value was not found.

", - "error":{ - "code":"TableRestoreNotFoundFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TableRestoreStatus":{ - "type":"structure", - "members":{ - "TableRestoreRequestId":{ - "shape":"String", - "documentation":"

The unique identifier for the table restore request.

" - }, - "Status":{ - "shape":"TableRestoreStatusType", - "documentation":"

A value that describes the current state of the table restore request.

Valid Values: SUCCEEDED, FAILED, CANCELED, PENDING, IN_PROGRESS

" - }, - "Message":{ - "shape":"String", - "documentation":"

A description of the status of the table restore request. Status values include SUCCEEDED, FAILED, CANCELED, PENDING, IN_PROGRESS.

" - }, - "RequestTime":{ - "shape":"TStamp", - "documentation":"

The time that the table restore request was made, in Universal Coordinated Time (UTC).

" - }, - "ProgressInMegaBytes":{ - "shape":"LongOptional", - "documentation":"

The amount of data restored to the new table so far, in megabytes (MB).

" - }, - "TotalDataInMegaBytes":{ - "shape":"LongOptional", - "documentation":"

The total amount of data to restore to the new table, in megabytes (MB).

" - }, - "ClusterIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the Amazon Redshift cluster that the table is being restored to.

" - }, - "SnapshotIdentifier":{ - "shape":"String", - "documentation":"

The identifier of the snapshot that the table is being restored from.

" - }, - "SourceDatabaseName":{ - "shape":"String", - "documentation":"

The name of the source database that contains the table being restored.

" - }, - "SourceSchemaName":{ - "shape":"String", - "documentation":"

The name of the source schema that contains the table being restored.

" - }, - "SourceTableName":{ - "shape":"String", - "documentation":"

The name of the source table being restored.

" - }, - "TargetDatabaseName":{ - "shape":"String", - "documentation":"

The name of the database to restore the table to.

" - }, - "TargetSchemaName":{ - "shape":"String", - "documentation":"

The name of the schema to restore the table to.

" - }, - "NewTableName":{ - "shape":"String", - "documentation":"

The name of the table to create as a result of the table restore request.

" - } - }, - "documentation":"

Describes the status of a RestoreTableFromClusterSnapshot operation.

", - "wrapper":true - }, - "TableRestoreStatusList":{ - "type":"list", - "member":{ - "shape":"TableRestoreStatus", - "locationName":"TableRestoreStatus" - } - }, - "TableRestoreStatusMessage":{ - "type":"structure", - "members":{ - "TableRestoreStatusDetails":{ - "shape":"TableRestoreStatusList", - "documentation":"

A list of status details for one or more table restore requests.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A pagination token that can be used in a subsequent DescribeTableRestoreStatus request.

" - } - }, - "documentation":"

" - }, - "TableRestoreStatusType":{ - "type":"string", - "enum":[ - "PENDING", - "IN_PROGRESS", - "SUCCEEDED", - "FAILED", - "CANCELED" - ] - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"String", - "documentation":"

The key, or name, for the resource tag.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value for the resource tag.

" - } - }, - "documentation":"

A tag consisting of a name/value pair for a resource.

" - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"TagKey" - } - }, - "TagLimitExceededFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of tables in your source cluster exceeds the limit for the target cluster. Resize to a larger cluster node type.

", - "error":{ - "code":"TagLimitExceededFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "TagValueList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"TagValue" - } - }, - "TaggedResource":{ - "type":"structure", - "members":{ - "Tag":{ - "shape":"Tag", - "documentation":"

The tag for the resource.

" - }, - "ResourceName":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) with which the tag is associated. For example, arn:aws:redshift:us-east-1:123456789:cluster:t1.

" - }, - "ResourceType":{ - "shape":"String", - "documentation":"

The type of resource with which the tag is associated. Valid resource types are:

  • Cluster

  • CIDR/IP

  • EC2 security group

  • Snapshot

  • Cluster security group

  • Subnet group

  • HSM connection

  • HSM certificate

  • Parameter group

For more information about Amazon Redshift resource types and constructing ARNs, go to Constructing an Amazon Redshift Amazon Resource Name (ARN) in the Amazon Redshift Cluster Management Guide.

" - } - }, - "documentation":"

A tag and its associated resource.

" - }, - "TaggedResourceList":{ - "type":"list", - "member":{ - "shape":"TaggedResource", - "locationName":"TaggedResource" - } - }, - "TaggedResourceListMessage":{ - "type":"structure", - "members":{ - "TaggedResources":{ - "shape":"TaggedResourceList", - "documentation":"

A list of tags with their associated resources.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

" - } - }, - "documentation":"

" - }, - "TrackList":{ - "type":"list", - "member":{ - "shape":"MaintenanceTrack", - "locationName":"MaintenanceTrack" - } - }, - "TrackListMessage":{ - "type":"structure", - "members":{ - "MaintenanceTracks":{ - "shape":"TrackList", - "documentation":"

A list of maintenance tracks output by the DescribeClusterTracks operation.

" - }, - "Marker":{ - "shape":"String", - "documentation":"

The starting point to return a set of response tracklist records. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

" - } - } - }, - "UnauthorizedOperation":{ - "type":"structure", - "members":{ - }, - "documentation":"

Your account is not authorized to perform the requested operation.

", - "error":{ - "code":"UnauthorizedOperation", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnknownSnapshotCopyRegionFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified region is incorrect or does not exist.

", - "error":{ - "code":"UnknownSnapshotCopyRegionFault", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "UnsupportedOperationFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested operation isn't supported.

", - "error":{ - "code":"UnsupportedOperation", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnsupportedOptionFault":{ - "type":"structure", - "members":{ - }, - "documentation":"

A request option was specified that is not supported.

", - "error":{ - "code":"UnsupportedOptionFault", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UpdateTarget":{ - "type":"structure", - "members":{ - "MaintenanceTrackName":{ - "shape":"String", - "documentation":"

The name of the new maintenance track.

" - }, - "DatabaseVersion":{ - "shape":"String", - "documentation":"

The cluster version for the new maintenance track.

" - } - }, - "documentation":"

A maintenance track that you can switch the current track to.

" - }, - "VpcSecurityGroupIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"VpcSecurityGroupId" - } - }, - "VpcSecurityGroupMembership":{ - "type":"structure", - "members":{ - "VpcSecurityGroupId":{ - "shape":"String", - "documentation":"

The identifier of the VPC security group.

" - }, - "Status":{ - "shape":"String", - "documentation":"

The status of the VPC security group.

" - } - }, - "documentation":"

Describes the members of a VPC security group.

" - }, - "VpcSecurityGroupMembershipList":{ - "type":"list", - "member":{ - "shape":"VpcSecurityGroupMembership", - "locationName":"VpcSecurityGroup" - } - } - }, - "documentation":"Amazon Redshift

Overview

This is an interface reference for Amazon Redshift. It contains documentation for one of the programming or command line interfaces you can use to manage Amazon Redshift clusters. Note that Amazon Redshift is asynchronous, which means that some interfaces may require techniques, such as polling or asynchronous callback handlers, to determine when a command has been applied. In this reference, the parameter descriptions indicate whether a change is applied immediately, on the next instance reboot, or during the next maintenance window. For a summary of the Amazon Redshift cluster management interfaces, go to Using the Amazon Redshift Management Interfaces.

Amazon Redshift manages all the work of setting up, operating, and scaling a data warehouse: provisioning capacity, monitoring and backing up the cluster, and applying patches and upgrades to the Amazon Redshift engine. You can focus on using your data to acquire new insights for your business and customers.

If you are a first-time user of Amazon Redshift, we recommend that you begin by reading the Amazon Redshift Getting Started Guide.

If you are a database developer, the Amazon Redshift Database Developer Guide explains how to design, build, query, and maintain the databases that make up your data warehouse.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/waiters-2.json deleted file mode 100644 index 164e9b0d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/redshift/2012-12-01/waiters-2.json +++ /dev/null @@ -1,97 +0,0 @@ -{ - "version": 2, - "waiters": { - "ClusterAvailable": { - "delay": 60, - "operation": "DescribeClusters", - "maxAttempts": 30, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Clusters[].ClusterStatus" - }, - { - "expected": "deleting", - "matcher": "pathAny", - "state": "failure", - "argument": "Clusters[].ClusterStatus" - }, - { - "expected": "ClusterNotFound", - "matcher": "error", - "state": "retry" - } - ] - }, - "ClusterDeleted": { - "delay": 60, - "operation": "DescribeClusters", - "maxAttempts": 30, - "acceptors": [ - { - "expected": "ClusterNotFound", - "matcher": "error", - "state": "success" - }, - { - "expected": "creating", - "matcher": "pathAny", - "state": "failure", - "argument": "Clusters[].ClusterStatus" - }, - { - "expected": "modifying", - "matcher": "pathAny", - "state": "failure", - "argument": "Clusters[].ClusterStatus" - } - ] - }, - "ClusterRestored": { - "operation": "DescribeClusters", - "maxAttempts": 30, - "delay": 60, - "acceptors": [ - { - "state": "success", - "matcher": "pathAll", - "argument": "Clusters[].RestoreStatus.Status", - "expected": "completed" - }, - { - "state": "failure", - "matcher": "pathAny", - "argument": "Clusters[].ClusterStatus", - "expected": "deleting" - } - ] - }, - "SnapshotAvailable": { - "delay": 15, - "operation": "DescribeClusterSnapshots", - "maxAttempts": 20, - "acceptors": [ - { - "expected": "available", - "matcher": "pathAll", - "state": "success", - "argument": "Snapshots[].Status" - }, - { - "expected": "failed", - "matcher": "pathAny", - "state": "failure", - "argument": "Snapshots[].Status" - }, - { - "expected": "deleted", - "matcher": "pathAny", - "state": "failure", - "argument": "Snapshots[].Status" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/examples-1.json deleted file mode 100644 index 20b03280..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/examples-1.json +++ /dev/null @@ -1,651 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CompareFaces": [ - { - "input": { - "SimilarityThreshold": 90, - "SourceImage": { - "S3Object": { - "Bucket": "mybucket", - "Name": "mysourceimage" - } - }, - "TargetImage": { - "S3Object": { - "Bucket": "mybucket", - "Name": "mytargetimage" - } - } - }, - "output": { - "FaceMatches": [ - { - "Face": { - "BoundingBox": { - "Height": 0.33481481671333313, - "Left": 0.31888890266418457, - "Top": 0.4933333396911621, - "Width": 0.25 - }, - "Confidence": 99.9991226196289 - }, - "Similarity": 100 - } - ], - "SourceImageFace": { - "BoundingBox": { - "Height": 0.33481481671333313, - "Left": 0.31888890266418457, - "Top": 0.4933333396911621, - "Width": 0.25 - }, - "Confidence": 99.9991226196289 - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation compares the largest face detected in the source image with each face detected in the target image.", - "id": "to-compare-two-images-1482181985581", - "title": "To compare two images" - } - ], - "CreateCollection": [ - { - "input": { - "CollectionId": "myphotos" - }, - "output": { - "CollectionArn": "aws:rekognition:us-west-2:123456789012:collection/myphotos", - "StatusCode": 200 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation creates a Rekognition collection for storing image data.", - "id": "to-create-a-collection-1481833313674", - "title": "To create a collection" - } - ], - "DeleteCollection": [ - { - "input": { - "CollectionId": "myphotos" - }, - "output": { - "StatusCode": 200 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes a Rekognition collection.", - "id": "to-delete-a-collection-1481838179973", - "title": "To delete a collection" - } - ], - "DeleteFaces": [ - { - "input": { - "CollectionId": "myphotos", - "FaceIds": [ - "ff43d742-0c13-5d16-a3e8-03d3f58e980b" - ] - }, - "output": { - "DeletedFaces": [ - "ff43d742-0c13-5d16-a3e8-03d3f58e980b" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes one or more faces from a Rekognition collection.", - "id": "to-delete-a-face-1482182799377", - "title": "To delete a face" - } - ], - "DetectFaces": [ - { - "input": { - "Image": { - "S3Object": { - "Bucket": "mybucket", - "Name": "myphoto" - } - } - }, - "output": { - "FaceDetails": [ - { - "BoundingBox": { - "Height": 0.18000000715255737, - "Left": 0.5555555820465088, - "Top": 0.33666667342185974, - "Width": 0.23999999463558197 - }, - "Confidence": 100, - "Landmarks": [ - { - "Type": "EYE_LEFT", - "X": 0.6394737362861633, - "Y": 0.40819624066352844 - }, - { - "Type": "EYE_RIGHT", - "X": 0.7266660928726196, - "Y": 0.41039225459098816 - }, - { - "Type": "NOSE_LEFT", - "X": 0.6912462115287781, - "Y": 0.44240960478782654 - }, - { - "Type": "MOUTH_DOWN", - "X": 0.6306198239326477, - "Y": 0.46700039505958557 - }, - { - "Type": "MOUTH_UP", - "X": 0.7215608954429626, - "Y": 0.47114261984825134 - } - ], - "Pose": { - "Pitch": 4.050806522369385, - "Roll": 0.9950747489929199, - "Yaw": 13.693790435791016 - }, - "Quality": { - "Brightness": 37.60169982910156, - "Sharpness": 80 - } - } - ], - "OrientationCorrection": "ROTATE_0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation detects faces in an image stored in an AWS S3 bucket.", - "id": "to-detect-faces-in-an-image-1481841782793", - "title": "To detect faces in an image" - } - ], - "DetectLabels": [ - { - "input": { - "Image": { - "S3Object": { - "Bucket": "mybucket", - "Name": "myphoto" - } - }, - "MaxLabels": 123, - "MinConfidence": 70 - }, - "output": { - "Labels": [ - { - "Confidence": 99.25072479248047, - "Name": "People" - }, - { - "Confidence": 99.25074005126953, - "Name": "Person" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation detects labels in the supplied image", - "id": "to-detect-labels-1481834255770", - "title": "To detect labels" - } - ], - "IndexFaces": [ - { - "input": { - "CollectionId": "myphotos", - "DetectionAttributes": [ - - ], - "ExternalImageId": "myphotoid", - "Image": { - "S3Object": { - "Bucket": "mybucket", - "Name": "myphoto" - } - } - }, - "output": { - "FaceRecords": [ - { - "Face": { - "BoundingBox": { - "Height": 0.33481481671333313, - "Left": 0.31888890266418457, - "Top": 0.4933333396911621, - "Width": 0.25 - }, - "Confidence": 99.9991226196289, - "FaceId": "ff43d742-0c13-5d16-a3e8-03d3f58e980b", - "ImageId": "465f4e93-763e-51d0-b030-b9667a2d94b1" - }, - "FaceDetail": { - "BoundingBox": { - "Height": 0.33481481671333313, - "Left": 0.31888890266418457, - "Top": 0.4933333396911621, - "Width": 0.25 - }, - "Confidence": 99.9991226196289, - "Landmarks": [ - { - "Type": "EYE_LEFT", - "X": 0.3976764678955078, - "Y": 0.6248345971107483 - }, - { - "Type": "EYE_RIGHT", - "X": 0.4810936450958252, - "Y": 0.6317117214202881 - }, - { - "Type": "NOSE_LEFT", - "X": 0.41986238956451416, - "Y": 0.7111940383911133 - }, - { - "Type": "MOUTH_DOWN", - "X": 0.40525302290916443, - "Y": 0.7497701048851013 - }, - { - "Type": "MOUTH_UP", - "X": 0.4753248989582062, - "Y": 0.7558549642562866 - } - ], - "Pose": { - "Pitch": -9.713645935058594, - "Roll": 4.707281112670898, - "Yaw": -24.438663482666016 - }, - "Quality": { - "Brightness": 29.23358917236328, - "Sharpness": 80 - } - } - }, - { - "Face": { - "BoundingBox": { - "Height": 0.32592591643333435, - "Left": 0.5144444704055786, - "Top": 0.15111111104488373, - "Width": 0.24444444477558136 - }, - "Confidence": 99.99950408935547, - "FaceId": "8be04dba-4e58-520d-850e-9eae4af70eb2", - "ImageId": "465f4e93-763e-51d0-b030-b9667a2d94b1" - }, - "FaceDetail": { - "BoundingBox": { - "Height": 0.32592591643333435, - "Left": 0.5144444704055786, - "Top": 0.15111111104488373, - "Width": 0.24444444477558136 - }, - "Confidence": 99.99950408935547, - "Landmarks": [ - { - "Type": "EYE_LEFT", - "X": 0.6006892323493958, - "Y": 0.290842205286026 - }, - { - "Type": "EYE_RIGHT", - "X": 0.6808141469955444, - "Y": 0.29609042406082153 - }, - { - "Type": "NOSE_LEFT", - "X": 0.6395332217216492, - "Y": 0.3522595763206482 - }, - { - "Type": "MOUTH_DOWN", - "X": 0.5892083048820496, - "Y": 0.38689887523651123 - }, - { - "Type": "MOUTH_UP", - "X": 0.674560010433197, - "Y": 0.394125759601593 - } - ], - "Pose": { - "Pitch": -4.683138370513916, - "Roll": 2.1029529571533203, - "Yaw": 6.716655254364014 - }, - "Quality": { - "Brightness": 34.951698303222656, - "Sharpness": 160 - } - } - } - ], - "OrientationCorrection": "ROTATE_0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation detects faces in an image and adds them to the specified Rekognition collection.", - "id": "to-add-a-face-to-a-collection-1482179542923", - "title": "To add a face to a collection" - } - ], - "ListCollections": [ - { - "input": { - }, - "output": { - "CollectionIds": [ - "myphotos" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation returns a list of Rekognition collections.", - "id": "to-list-the-collections-1482179199088", - "title": "To list the collections" - } - ], - "ListFaces": [ - { - "input": { - "CollectionId": "myphotos", - "MaxResults": 20 - }, - "output": { - "Faces": [ - { - "BoundingBox": { - "Height": 0.18000000715255737, - "Left": 0.5555559992790222, - "Top": 0.336667001247406, - "Width": 0.23999999463558197 - }, - "Confidence": 100, - "FaceId": "1c62e8b5-69a7-5b7d-b3cd-db4338a8a7e7", - "ImageId": "147fdf82-7a71-52cf-819b-e786c7b9746e" - }, - { - "BoundingBox": { - "Height": 0.16555599868297577, - "Left": 0.30963000655174255, - "Top": 0.7066670060157776, - "Width": 0.22074100375175476 - }, - "Confidence": 100, - "FaceId": "29a75abe-397b-5101-ba4f-706783b2246c", - "ImageId": "147fdf82-7a71-52cf-819b-e786c7b9746e" - }, - { - "BoundingBox": { - "Height": 0.3234420120716095, - "Left": 0.3233329951763153, - "Top": 0.5, - "Width": 0.24222199618816376 - }, - "Confidence": 99.99829864501953, - "FaceId": "38271d79-7bc2-5efb-b752-398a8d575b85", - "ImageId": "d5631190-d039-54e4-b267-abd22c8647c5" - }, - { - "BoundingBox": { - "Height": 0.03555560111999512, - "Left": 0.37388700246810913, - "Top": 0.2477779984474182, - "Width": 0.04747769981622696 - }, - "Confidence": 99.99210357666016, - "FaceId": "3b01bef0-c883-5654-ba42-d5ad28b720b3", - "ImageId": "812d9f04-86f9-54fc-9275-8d0dcbcb6784" - }, - { - "BoundingBox": { - "Height": 0.05333330109715462, - "Left": 0.2937690019607544, - "Top": 0.35666701197624207, - "Width": 0.07121659815311432 - }, - "Confidence": 99.99919891357422, - "FaceId": "4839a608-49d0-566c-8301-509d71b534d1", - "ImageId": "812d9f04-86f9-54fc-9275-8d0dcbcb6784" - }, - { - "BoundingBox": { - "Height": 0.3249259889125824, - "Left": 0.5155559778213501, - "Top": 0.1513350009918213, - "Width": 0.24333299696445465 - }, - "Confidence": 99.99949645996094, - "FaceId": "70008e50-75e4-55d0-8e80-363fb73b3a14", - "ImageId": "d5631190-d039-54e4-b267-abd22c8647c5" - }, - { - "BoundingBox": { - "Height": 0.03777780011296272, - "Left": 0.7002969980239868, - "Top": 0.18777799606323242, - "Width": 0.05044509842991829 - }, - "Confidence": 99.92639923095703, - "FaceId": "7f5f88ed-d684-5a88-b0df-01e4a521552b", - "ImageId": "812d9f04-86f9-54fc-9275-8d0dcbcb6784" - }, - { - "BoundingBox": { - "Height": 0.05555560067296028, - "Left": 0.13946600258350372, - "Top": 0.46333301067352295, - "Width": 0.07270029932260513 - }, - "Confidence": 99.99469757080078, - "FaceId": "895b4e2c-81de-5902-a4bd-d1792bda00b2", - "ImageId": "812d9f04-86f9-54fc-9275-8d0dcbcb6784" - }, - { - "BoundingBox": { - "Height": 0.3259260058403015, - "Left": 0.5144439935684204, - "Top": 0.15111100673675537, - "Width": 0.24444399774074554 - }, - "Confidence": 99.99949645996094, - "FaceId": "8be04dba-4e58-520d-850e-9eae4af70eb2", - "ImageId": "465f4e93-763e-51d0-b030-b9667a2d94b1" - }, - { - "BoundingBox": { - "Height": 0.18888899683952332, - "Left": 0.3783380091190338, - "Top": 0.2355560064315796, - "Width": 0.25222599506378174 - }, - "Confidence": 99.9999008178711, - "FaceId": "908544ad-edc3-59df-8faf-6a87cc256cf5", - "ImageId": "3c731605-d772-541a-a5e7-0375dbc68a07" - }, - { - "BoundingBox": { - "Height": 0.33481499552726746, - "Left": 0.31888899207115173, - "Top": 0.49333301186561584, - "Width": 0.25 - }, - "Confidence": 99.99909973144531, - "FaceId": "ff43d742-0c13-5d16-a3e8-03d3f58e980b", - "ImageId": "465f4e93-763e-51d0-b030-b9667a2d94b1" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation lists the faces in a Rekognition collection.", - "id": "to-list-the-faces-in-a-collection-1482181416530", - "title": "To list the faces in a collection" - } - ], - "SearchFaces": [ - { - "input": { - "CollectionId": "myphotos", - "FaceId": "70008e50-75e4-55d0-8e80-363fb73b3a14", - "FaceMatchThreshold": 90, - "MaxFaces": 10 - }, - "output": { - "FaceMatches": [ - { - "Face": { - "BoundingBox": { - "Height": 0.3259260058403015, - "Left": 0.5144439935684204, - "Top": 0.15111100673675537, - "Width": 0.24444399774074554 - }, - "Confidence": 99.99949645996094, - "FaceId": "8be04dba-4e58-520d-850e-9eae4af70eb2", - "ImageId": "465f4e93-763e-51d0-b030-b9667a2d94b1" - }, - "Similarity": 99.97222137451172 - }, - { - "Face": { - "BoundingBox": { - "Height": 0.16555599868297577, - "Left": 0.30963000655174255, - "Top": 0.7066670060157776, - "Width": 0.22074100375175476 - }, - "Confidence": 100, - "FaceId": "29a75abe-397b-5101-ba4f-706783b2246c", - "ImageId": "147fdf82-7a71-52cf-819b-e786c7b9746e" - }, - "Similarity": 97.04154968261719 - }, - { - "Face": { - "BoundingBox": { - "Height": 0.18888899683952332, - "Left": 0.3783380091190338, - "Top": 0.2355560064315796, - "Width": 0.25222599506378174 - }, - "Confidence": 99.9999008178711, - "FaceId": "908544ad-edc3-59df-8faf-6a87cc256cf5", - "ImageId": "3c731605-d772-541a-a5e7-0375dbc68a07" - }, - "Similarity": 95.94520568847656 - } - ], - "SearchedFaceId": "70008e50-75e4-55d0-8e80-363fb73b3a14" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation searches for matching faces in the collection the supplied face belongs to.", - "id": "to-delete-a-face-1482182799377", - "title": "To delete a face" - } - ], - "SearchFacesByImage": [ - { - "input": { - "CollectionId": "myphotos", - "FaceMatchThreshold": 95, - "Image": { - "S3Object": { - "Bucket": "mybucket", - "Name": "myphoto" - } - }, - "MaxFaces": 5 - }, - "output": { - "FaceMatches": [ - { - "Face": { - "BoundingBox": { - "Height": 0.3234420120716095, - "Left": 0.3233329951763153, - "Top": 0.5, - "Width": 0.24222199618816376 - }, - "Confidence": 99.99829864501953, - "FaceId": "38271d79-7bc2-5efb-b752-398a8d575b85", - "ImageId": "d5631190-d039-54e4-b267-abd22c8647c5" - }, - "Similarity": 99.97036743164062 - } - ], - "SearchedFaceBoundingBox": { - "Height": 0.33481481671333313, - "Left": 0.31888890266418457, - "Top": 0.4933333396911621, - "Width": 0.25 - }, - "SearchedFaceConfidence": 99.9991226196289 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation searches for faces in a Rekognition collection that match the largest face in an S3 bucket stored image.", - "id": "to-search-for-faces-matching-a-supplied-image-1482175994491", - "title": "To search for faces matching a supplied image" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/paginators-1.json deleted file mode 100644 index ea009a1b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "ListCollections": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": [ - "CollectionIds", - "FaceModelVersions" - ] - }, - "ListFaces": { - "input_token": "NextToken", - "limit_key": "MaxResults", - "output_token": "NextToken", - "result_key": "Faces", - "non_aggregate_keys": [ - "FaceModelVersion" - ] - }, - "ListStreamProcessors": { - "result_key": "StreamProcessors", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/service-2.json deleted file mode 100644 index b8cf7c67..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/rekognition/2016-06-27/service-2.json +++ /dev/null @@ -1,3071 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-06-27", - "endpointPrefix":"rekognition", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Rekognition", - "serviceId":"Rekognition", - "signatureVersion":"v4", - "targetPrefix":"RekognitionService", - "uid":"rekognition-2016-06-27" - }, - "operations":{ - "CompareFaces":{ - "name":"CompareFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CompareFacesRequest"}, - "output":{"shape":"CompareFacesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Compares a face in the source input image with each of the 100 largest faces detected in the target input image.

If the source image contains multiple faces, the service detects the largest face and compares it with each face detected in the target image.

You pass the input and target images either as base64-encoded image bytes or as a references to images in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

In response, the operation returns an array of face matches ordered by similarity score in descending order. For each face match, the response provides a bounding box of the face, facial landmarks, pose details (pitch, role, and yaw), quality (brightness and sharpness), and confidence value (indicating the level of confidence that the bounding box contains a face). The response also provides a similarity score, which indicates how closely the faces match.

By default, only faces with a similarity score of greater than or equal to 80% are returned in the response. You can change this value by specifying the SimilarityThreshold parameter.

CompareFaces also returns an array of faces that don't match the source image. For each face, it returns a bounding box, confidence value, landmarks, pose details, and quality. The response also returns information about the face in the source image, including the bounding box of the face and confidence value.

If the image doesn't contain Exif metadata, CompareFaces returns orientation information for the source and target images. Use these values to display the images with the correct image orientation.

If no faces are detected in the source or target images, CompareFaces returns an InvalidParameterException error.

This is a stateless API operation. That is, data returned by this operation doesn't persist.

For an example, see Comparing Faces in Images in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:CompareFaces action.

" - }, - "CreateCollection":{ - "name":"CreateCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCollectionRequest"}, - "output":{"shape":"CreateCollectionResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceAlreadyExistsException"} - ], - "documentation":"

Creates a collection in an AWS Region. You can add faces to the collection using the operation.

For example, you might create collections, one for each of your application users. A user can then index faces using the IndexFaces operation and persist results in a specific collection. Then, a user can search the collection for faces in the user-specific container.

Collection names are case-sensitive.

This operation requires permissions to perform the rekognition:CreateCollection action.

" - }, - "CreateStreamProcessor":{ - "name":"CreateStreamProcessor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStreamProcessorRequest"}, - "output":{"shape":"CreateStreamProcessorResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces in a streaming video.

Amazon Rekognition Video is a consumer of live video from Amazon Kinesis Video Streams. Amazon Rekognition Video sends analysis results to Amazon Kinesis Data Streams.

You provide as input a Kinesis video stream (Input) and a Kinesis data stream (Output) stream. You also specify the face recognition criteria in Settings. For example, the collection containing faces that you want to recognize. Use Name to assign an identifier for the stream processor. You use Name to manage the stream processor. For example, you can start processing the source video by calling with the Name field.

After you have finished analyzing a streaming video, use to stop processing. You can delete the stream processor by calling .

" - }, - "DeleteCollection":{ - "name":"DeleteCollection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCollectionRequest"}, - "output":{"shape":"DeleteCollectionResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes the specified collection. Note that this operation removes all faces in the collection. For an example, see delete-collection-procedure.

This operation requires permissions to perform the rekognition:DeleteCollection action.

" - }, - "DeleteFaces":{ - "name":"DeleteFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFacesRequest"}, - "output":{"shape":"DeleteFacesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes faces from a collection. You specify a collection ID and an array of face IDs to remove from the collection.

This operation requires permissions to perform the rekognition:DeleteFaces action.

" - }, - "DeleteStreamProcessor":{ - "name":"DeleteStreamProcessor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStreamProcessorRequest"}, - "output":{"shape":"DeleteStreamProcessorResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Deletes the stream processor identified by Name. You assign the value for Name when you create the stream processor with . You might not be able to use the same name for a stream processor for a few seconds after calling DeleteStreamProcessor.

" - }, - "DescribeStreamProcessor":{ - "name":"DescribeStreamProcessor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStreamProcessorRequest"}, - "output":{"shape":"DescribeStreamProcessorResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Provides information about a stream processor created by . You can get information about the input and output streams, the input parameters for the face recognition being performed, and the current status of the stream processor.

" - }, - "DetectFaces":{ - "name":"DetectFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectFacesRequest"}, - "output":{"shape":"DetectFacesResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Detects faces within an image that is provided as input.

DetectFaces detects the 100 largest faces in the image. For each face detected, the operation returns face details including a bounding box of the face, a confidence value (that the bounding box contains a face), and a fixed set of attributes such as facial landmarks (for example, coordinates of eye and mouth), gender, presence of beard, sunglasses, etc.

The face-detection algorithm is most effective on frontal faces. For non-frontal or obscured faces, the algorithm may not detect the faces or might detect faces with lower confidence.

You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

This is a stateless API operation. That is, the operation does not persist any data.

This operation requires permissions to perform the rekognition:DetectFaces action.

" - }, - "DetectLabels":{ - "name":"DetectLabels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectLabelsRequest"}, - "output":{"shape":"DetectLabelsResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Detects instances of real-world entities within an image (JPEG or PNG) provided as input. This includes objects like flower, tree, and table; events like wedding, graduation, and birthday party; and concepts like landscape, evening, and nature.

For an example, see Analyzing Images Stored in an Amazon S3 Bucket in the Amazon Rekognition Developer Guide.

DetectLabels does not support the detection of activities. However, activity detection is supported for label detection in videos. For more information, see StartLabelDetection in the Amazon Rekognition Developer Guide.

You pass the input image as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

For each object, scene, and concept the API returns one or more labels. Each label provides the object name, and the level of confidence that the image contains the object. For example, suppose the input image has a lighthouse, the sea, and a rock. The response will include all three labels, one for each object.

{Name: lighthouse, Confidence: 98.4629}

{Name: rock,Confidence: 79.2097}

{Name: sea,Confidence: 75.061}

In the preceding example, the operation returns one label for each of the three objects. The operation can also return multiple labels for the same object in the image. For example, if the input image shows a flower (for example, a tulip), the operation might return the following three labels.

{Name: flower,Confidence: 99.0562}

{Name: plant,Confidence: 99.0562}

{Name: tulip,Confidence: 99.0562}

In this example, the detection algorithm more precisely identifies the flower as a tulip.

In response, the API returns an array of labels. In addition, the response also includes the orientation correction. Optionally, you can specify MinConfidence to control the confidence threshold for the labels returned. The default is 50%. You can also add the MaxLabels parameter to limit the number of labels returned.

If the object detected is a person, the operation doesn't provide the same facial details that the DetectFaces operation provides.

This is a stateless API operation. That is, the operation does not persist any data.

This operation requires permissions to perform the rekognition:DetectLabels action.

" - }, - "DetectModerationLabels":{ - "name":"DetectModerationLabels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectModerationLabelsRequest"}, - "output":{"shape":"DetectModerationLabelsResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Detects explicit or suggestive adult content in a specified JPEG or PNG format image. Use DetectModerationLabels to moderate images depending on your requirements. For example, you might want to filter images that contain nudity, but not images containing suggestive content.

To filter images, use the labels returned by DetectModerationLabels to determine which types of content are appropriate.

For information about moderation labels, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

" - }, - "DetectText":{ - "name":"DetectText", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DetectTextRequest"}, - "output":{"shape":"DetectTextResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Detects text in the input image and converts it into machine-readable text.

Pass the input image as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, you must pass it as a reference to an image in an Amazon S3 bucket. For the AWS CLI, passing image bytes is not supported. The image must be either a .png or .jpeg formatted file.

The DetectText operation returns text in an array of elements, TextDetections. Each TextDetection element provides information about a single word or line of text that was detected in the image.

A word is one or more ISO basic latin script characters that are not separated by spaces. DetectText can detect up to 50 words in an image.

A line is a string of equally spaced words. A line isn't necessarily a complete sentence. For example, a driver's license number is detected as a line. A line ends when there is no aligned text after it. Also, a line ends when there is a large gap between words, relative to the length of the words. This means, depending on the gap between words, Amazon Rekognition may detect multiple lines in text aligned in the same direction. Periods don't represent the end of a line. If a sentence spans multiple lines, the DetectText operation returns multiple lines.

To determine whether a TextDetection element is a line of text or a word, use the TextDetection object Type field.

To be detected, text must be within +/- 30 degrees orientation of the horizontal axis.

For more information, see DetectText in the Amazon Rekognition Developer Guide.

" - }, - "GetCelebrityInfo":{ - "name":"GetCelebrityInfo", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCelebrityInfoRequest"}, - "output":{"shape":"GetCelebrityInfoResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets the name and additional information about a celebrity based on his or her Rekognition ID. The additional information is returned as an array of URLs. If there is no additional information about the celebrity, this list is empty.

For more information, see Recognizing Celebrities in an Image in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:GetCelebrityInfo action.

" - }, - "GetCelebrityRecognition":{ - "name":"GetCelebrityRecognition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCelebrityRecognitionRequest"}, - "output":{"shape":"GetCelebrityRecognitionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets the celebrity recognition results for a Amazon Rekognition Video analysis started by .

Celebrity recognition in a video is an asynchronous operation. Analysis is started by a call to which returns a job identifier (JobId). When the celebrity recognition operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartCelebrityRecognition. To get the results of the celebrity recognition analysis, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call GetCelebrityDetection and pass the job identifier (JobId) from the initial call to StartCelebrityDetection.

For more information, see Working With Stored Videos in the Amazon Rekognition Developer Guide.

GetCelebrityRecognition returns detected celebrities and the time(s) they are detected in an array (Celebrities) of objects. Each CelebrityRecognition contains information about the celebrity in a object and the time, Timestamp, the celebrity was detected.

GetCelebrityRecognition only returns the default facial attributes (BoundingBox, Confidence, Landmarks, Pose, and Quality). The other facial attributes listed in the Face object of the following response syntax are not returned. For more information, see FaceDetail in the Amazon Rekognition Developer Guide.

By default, the Celebrities array is sorted by time (milliseconds from the start of the video). You can also sort the array by celebrity by specifying the value ID in the SortBy input parameter.

The CelebrityDetail object includes the celebrity identifer and additional information urls. If you don't store the additional information urls, you can get them later by calling with the celebrity identifer.

No information is returned for faces not recognized as celebrities.

Use MaxResults parameter to limit the number of labels returned. If there are more results than specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set of results. To get the next page of results, call GetCelebrityDetection and populate the NextToken request parameter with the token value returned from the previous call to GetCelebrityRecognition.

" - }, - "GetContentModeration":{ - "name":"GetContentModeration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContentModerationRequest"}, - "output":{"shape":"GetContentModerationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets the content moderation analysis results for a Amazon Rekognition Video analysis started by .

Content moderation analysis of a video is an asynchronous operation. You start analysis by calling . which returns a job identifier (JobId). When analysis finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartContentModeration. To get the results of the content moderation analysis, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call GetCelebrityDetection and pass the job identifier (JobId) from the initial call to StartCelebrityDetection.

For more information, see Working with Stored Videos in the Amazon Rekognition Devlopers Guide.

GetContentModeration returns detected content moderation labels, and the time they are detected, in an array, ModerationLabels, of objects.

By default, the moderated labels are returned sorted by time, in milliseconds from the start of the video. You can also sort them by moderated label by specifying NAME for the SortBy input parameter.

Since video analysis can return a large number of results, use the MaxResults parameter to limit the number of labels returned in a single call to GetContentModeration. If there are more results than specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set of results. To get the next page of results, call GetContentModeration and populate the NextToken request parameter with the value of NextToken returned from the previous call to GetContentModeration.

For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

" - }, - "GetFaceDetection":{ - "name":"GetFaceDetection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetFaceDetectionRequest"}, - "output":{"shape":"GetFaceDetectionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets face detection results for a Amazon Rekognition Video analysis started by .

Face detection with Amazon Rekognition Video is an asynchronous operation. You start face detection by calling which returns a job identifier (JobId). When the face detection operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartFaceDetection. To get the results of the face detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartFaceDetection.

GetFaceDetection returns an array of detected faces (Faces) sorted by the time the faces were detected.

Use MaxResults parameter to limit the number of labels returned. If there are more results than specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set of results. To get the next page of results, call GetFaceDetection and populate the NextToken request parameter with the token value returned from the previous call to GetFaceDetection.

" - }, - "GetFaceSearch":{ - "name":"GetFaceSearch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetFaceSearchRequest"}, - "output":{"shape":"GetFaceSearchResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets the face search results for Amazon Rekognition Video face search started by . The search returns faces in a collection that match the faces of persons detected in a video. It also includes the time(s) that faces are matched in the video.

Face search in a video is an asynchronous operation. You start face search by calling to which returns a job identifier (JobId). When the search operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartFaceSearch. To get the search results, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call GetFaceSearch and pass the job identifier (JobId) from the initial call to StartFaceSearch.

For more information, see Searching Faces in a Collection in the Amazon Rekognition Developer Guide.

The search results are retured in an array, Persons, of objects. EachPersonMatch element contains details about the matching faces in the input collection, person information (facial attributes, bounding boxes, and person identifer) for the matched person, and the time the person was matched in the video.

GetFaceSearch only returns the default facial attributes (BoundingBox, Confidence, Landmarks, Pose, and Quality). The other facial attributes listed in the Face object of the following response syntax are not returned. For more information, see FaceDetail in the Amazon Rekognition Developer Guide.

By default, the Persons array is sorted by the time, in milliseconds from the start of the video, persons are matched. You can also sort by persons by specifying INDEX for the SORTBY input parameter.

" - }, - "GetLabelDetection":{ - "name":"GetLabelDetection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetLabelDetectionRequest"}, - "output":{"shape":"GetLabelDetectionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets the label detection results of a Amazon Rekognition Video analysis started by .

The label detection operation is started by a call to which returns a job identifier (JobId). When the label detection operation finishes, Amazon Rekognition publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartlabelDetection. To get the results of the label detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartLabelDetection.

GetLabelDetection returns an array of detected labels (Labels) sorted by the time the labels were detected. You can also sort by the label name by specifying NAME for the SortBy input parameter.

The labels returned include the label name, the percentage confidence in the accuracy of the detected label, and the time the label was detected in the video.

Use MaxResults parameter to limit the number of labels returned. If there are more results than specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set of results. To get the next page of results, call GetlabelDetection and populate the NextToken request parameter with the token value returned from the previous call to GetLabelDetection.

" - }, - "GetPersonTracking":{ - "name":"GetPersonTracking", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPersonTrackingRequest"}, - "output":{"shape":"GetPersonTrackingResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Gets the person tracking results of a Amazon Rekognition Video analysis started by .

The person detection operation is started by a call to StartPersonTracking which returns a job identifier (JobId). When the person detection operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic registered in the initial call to StartPersonTracking.

To get the results of the person tracking operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartPersonTracking.

GetPersonTracking returns an array, Persons, of tracked persons and the time(s) they were tracked in the video.

GetPersonTracking only returns the default facial attributes (BoundingBox, Confidence, Landmarks, Pose, and Quality). The other facial attributes listed in the Face object of the following response syntax are not returned.

For more information, see FaceDetail in the Amazon Rekognition Developer Guide.

By default, the array is sorted by the time(s) a person is tracked in the video. You can sort by tracked persons by specifying INDEX for the SortBy input parameter.

Use the MaxResults parameter to limit the number of items returned. If there are more results than specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set of results. To get the next page of results, call GetPersonTracking and populate the NextToken request parameter with the token value returned from the previous call to GetPersonTracking.

" - }, - "IndexFaces":{ - "name":"IndexFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"IndexFacesRequest"}, - "output":{"shape":"IndexFacesResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Detects faces in the input image and adds them to the specified collection.

Amazon Rekognition does not save the actual faces detected. Instead, the underlying detection algorithm first detects the faces in the input image, and for each face extracts facial features into a feature vector, and stores it in the back-end database. Amazon Rekognition uses feature vectors when performing face match and search operations using the and operations.

If you are using version 1.0 of the face detection model, IndexFaces indexes the 15 largest faces in the input image. Later versions of the face detection model index the 100 largest faces in the input image. To determine which version of the model you are using, check the the value of FaceModelVersion in the response from IndexFaces.

For more information, see Model Versioning in the Amazon Rekognition Developer Guide.

If you provide the optional ExternalImageID for the input image you provided, Amazon Rekognition associates this ID with all faces that it detects. When you call the operation, the response returns the external ID. You can use this external image ID to create a client-side index to associate the faces with each image. You can then use the index to find all faces in an image.

In response, the operation returns an array of metadata for all detected faces. This includes, the bounding box of the detected face, confidence value (indicating the bounding box contains a face), a face ID assigned by the service for each face that is detected and stored, and an image ID assigned by the service for the input image. If you request all facial attributes (using the detectionAttributes parameter, Amazon Rekognition returns detailed facial attributes such as facial landmarks (for example, location of eye and mount) and other facial attributes such gender. If you provide the same image, specify the same collection, and use the same external ID in the IndexFaces operation, Amazon Rekognition doesn't save duplicate face metadata.

For more information, see Adding Faces to a Collection in the Amazon Rekognition Developer Guide.

The input image is passed either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

This operation requires permissions to perform the rekognition:IndexFaces action.

" - }, - "ListCollections":{ - "name":"ListCollections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCollectionsRequest"}, - "output":{"shape":"ListCollectionsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns list of collection IDs in your account. If the result is truncated, the response also provides a NextToken that you can use in the subsequent request to fetch the next set of collection IDs.

For an example, see Listing Collections in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:ListCollections action.

" - }, - "ListFaces":{ - "name":"ListFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListFacesRequest"}, - "output":{"shape":"ListFacesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns metadata for faces in the specified collection. This metadata includes information such as the bounding box coordinates, the confidence (that the bounding box contains a face), and face ID. For an example, see Listing Faces in a Collection in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:ListFaces action.

" - }, - "ListStreamProcessors":{ - "name":"ListStreamProcessors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStreamProcessorsRequest"}, - "output":{"shape":"ListStreamProcessorsResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPaginationTokenException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Gets a list of stream processors that you have created with .

" - }, - "RecognizeCelebrities":{ - "name":"RecognizeCelebrities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RecognizeCelebritiesRequest"}, - "output":{"shape":"RecognizeCelebritiesResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidImageFormatException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

Returns an array of celebrities recognized in the input image. For more information, see Recognizing Celebrities in the Amazon Rekognition Developer Guide.

RecognizeCelebrities returns the 100 largest faces in the image. It lists recognized celebrities in the CelebrityFaces array and unrecognized faces in the UnrecognizedFaces array. RecognizeCelebrities doesn't return celebrities whose faces are not amongst the largest 100 faces in the image.

For each celebrity recognized, the RecognizeCelebrities returns a Celebrity object. The Celebrity object contains the celebrity name, ID, URL links to additional information, match confidence, and a ComparedFace object that you can use to locate the celebrity's face on the image.

Rekognition does not retain information about which images a celebrity has been recognized in. Your application must store this information and use the Celebrity ID property as a unique identifier for the celebrity. If you don't store the celebrity name or additional information URLs returned by RecognizeCelebrities, you will need the ID to identify the celebrity in a call to the operation.

You pass the imput image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

For an example, see Recognizing Celebrities in an Image in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:RecognizeCelebrities operation.

" - }, - "SearchFaces":{ - "name":"SearchFaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchFacesRequest"}, - "output":{"shape":"SearchFacesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

For a given input face ID, searches for matching faces in the collection the face belongs to. You get a face ID when you add a face to the collection using the IndexFaces operation. The operation compares the features of the input face with faces in the specified collection.

You can also search faces without indexing faces by using the SearchFacesByImage operation.

The operation response returns an array of faces that match, ordered by similarity score with the highest similarity first. More specifically, it is an array of metadata for each face match that is found. Along with the metadata, the response also includes a confidence value for each face match, indicating the confidence that the specific face matches the input face.

For an example, see Searching for a Face Using Its Face ID in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:SearchFaces action.

" - }, - "SearchFacesByImage":{ - "name":"SearchFacesByImage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchFacesByImageRequest"}, - "output":{"shape":"SearchFacesByImageResponse"}, - "errors":[ - {"shape":"InvalidS3ObjectException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ImageTooLargeException"}, - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidImageFormatException"} - ], - "documentation":"

For a given input image, first detects the largest face in the image, and then searches the specified collection for matching faces. The operation compares the features of the input face with faces in the specified collection.

To search for all faces in an input image, you might first call the operation, and then use the face IDs returned in subsequent calls to the operation.

You can also call the DetectFaces operation and use the bounding boxes in the response to make face crops, which then you can pass in to the SearchFacesByImage operation.

You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file.

The response returns an array of faces that match, ordered by similarity score with the highest similarity first. More specifically, it is an array of metadata for each face match found. Along with the metadata, the response also includes a similarity indicating how similar the face is to the input face. In the response, the operation also returns the bounding box (and a confidence level that the bounding box contains a face) of the face that Amazon Rekognition used for the input image.

For an example, Searching for a Face Using an Image in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:SearchFacesByImage action.

" - }, - "StartCelebrityRecognition":{ - "name":"StartCelebrityRecognition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartCelebrityRecognitionRequest"}, - "output":{"shape":"StartCelebrityRecognitionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts asynchronous recognition of celebrities in a stored video.

Amazon Rekognition Video can detect celebrities in a video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartCelebrityRecognition returns a job identifier (JobId) which you use to get the results of the analysis. When celebrity recognition analysis is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel. To get the results of the celebrity recognition analysis, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartCelebrityRecognition.

For more information, see Recognizing Celebrities in the Amazon Rekognition Developer Guide.

", - "idempotent":true - }, - "StartContentModeration":{ - "name":"StartContentModeration", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartContentModerationRequest"}, - "output":{"shape":"StartContentModerationResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts asynchronous detection of explicit or suggestive adult content in a stored video.

Amazon Rekognition Video can moderate content in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartContentModeration returns a job identifier (JobId) which you use to get the results of the analysis. When content moderation analysis is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

To get the results of the content moderation analysis, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartContentModeration.

For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

", - "idempotent":true - }, - "StartFaceDetection":{ - "name":"StartFaceDetection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartFaceDetectionRequest"}, - "output":{"shape":"StartFaceDetectionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts asynchronous detection of faces in a stored video.

Amazon Rekognition Video can detect faces in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartFaceDetection returns a job identifier (JobId) that you use to get the results of the operation. When face detection is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel. To get the results of the label detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartFaceDetection.

For more information, see Detecting Faces in a Stored Video in the Amazon Rekognition Developer Guide.

", - "idempotent":true - }, - "StartFaceSearch":{ - "name":"StartFaceSearch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartFaceSearchRequest"}, - "output":{"shape":"StartFaceSearchResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts the asynchronous search for faces in a collection that match the faces of persons detected in a stored video.

The video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartFaceSearch returns a job identifier (JobId) which you use to get the search results once the search has completed. When searching is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel. To get the search results, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartFaceSearch. For more information, see collections-search-person.

", - "idempotent":true - }, - "StartLabelDetection":{ - "name":"StartLabelDetection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartLabelDetectionRequest"}, - "output":{"shape":"StartLabelDetectionResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts asynchronous detection of labels in a stored video.

Amazon Rekognition Video can detect labels in a video. Labels are instances of real-world entities. This includes objects like flower, tree, and table; events like wedding, graduation, and birthday party; concepts like landscape, evening, and nature; and activities like a person getting out of a car or a person skiing.

The video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartLabelDetection returns a job identifier (JobId) which you use to get the results of the operation. When label detection is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

To get the results of the label detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartLabelDetection.

", - "idempotent":true - }, - "StartPersonTracking":{ - "name":"StartPersonTracking", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartPersonTrackingRequest"}, - "output":{"shape":"StartPersonTrackingResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"IdempotentParameterMismatchException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidS3ObjectException"}, - {"shape":"InternalServerError"}, - {"shape":"VideoTooLargeException"}, - {"shape":"ProvisionedThroughputExceededException"}, - {"shape":"LimitExceededException"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Starts the asynchronous tracking of persons in a stored video.

Amazon Rekognition Video can track persons in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartPersonTracking returns a job identifier (JobId) which you use to get the results of the operation. When label detection is finished, Amazon Rekognition publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

To get the results of the person detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartPersonTracking.

", - "idempotent":true - }, - "StartStreamProcessor":{ - "name":"StartStreamProcessor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartStreamProcessorRequest"}, - "output":{"shape":"StartStreamProcessorResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Starts processing a stream processor. You create a stream processor by calling . To tell StartStreamProcessor which stream processor to start, use the value of the Name field specified in the call to CreateStreamProcessor.

" - }, - "StopStreamProcessor":{ - "name":"StopStreamProcessor", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopStreamProcessorRequest"}, - "output":{"shape":"StopStreamProcessorResponse"}, - "errors":[ - {"shape":"AccessDeniedException"}, - {"shape":"InternalServerError"}, - {"shape":"ThrottlingException"}, - {"shape":"InvalidParameterException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ProvisionedThroughputExceededException"} - ], - "documentation":"

Stops a running stream processor that was created by .

" - } - }, - "shapes":{ - "AccessDeniedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

You are not authorized to perform the action.

", - "exception":true - }, - "AgeRange":{ - "type":"structure", - "members":{ - "Low":{ - "shape":"UInteger", - "documentation":"

The lowest estimated age.

" - }, - "High":{ - "shape":"UInteger", - "documentation":"

The highest estimated age.

" - } - }, - "documentation":"

Structure containing the estimated age range, in years, for a face.

Rekognition estimates an age-range for faces detected in the input image. Estimated age ranges can overlap; a face of a 5 year old may have an estimated range of 4-6 whilst the face of a 6 year old may have an estimated range of 4-8.

" - }, - "Attribute":{ - "type":"string", - "enum":[ - "DEFAULT", - "ALL" - ] - }, - "Attributes":{ - "type":"list", - "member":{"shape":"Attribute"} - }, - "Beard":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the face has beard or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the face has a beard, and the confidence level in the determination.

" - }, - "Boolean":{"type":"boolean"}, - "BoundingBox":{ - "type":"structure", - "members":{ - "Width":{ - "shape":"Float", - "documentation":"

Width of the bounding box as a ratio of the overall image width.

" - }, - "Height":{ - "shape":"Float", - "documentation":"

Height of the bounding box as a ratio of the overall image height.

" - }, - "Left":{ - "shape":"Float", - "documentation":"

Left coordinate of the bounding box as a ratio of overall image width.

" - }, - "Top":{ - "shape":"Float", - "documentation":"

Top coordinate of the bounding box as a ratio of overall image height.

" - } - }, - "documentation":"

Identifies the bounding box around the object, face or text. The left (x-coordinate) and top (y-coordinate) are coordinates representing the top and left sides of the bounding box. Note that the upper-left corner of the image is the origin (0,0).

The top and left values returned are ratios of the overall image size. For example, if the input image is 700x200 pixels, and the top-left coordinate of the bounding box is 350x50 pixels, the API returns a left value of 0.5 (350/700) and a top value of 0.25 (50/200).

The width and height values represent the dimensions of the bounding box as a ratio of the overall image dimension. For example, if the input image is 700x200 pixels, and the bounding box width is 70 pixels, the width returned is 0.1.

The bounding box coordinates can have negative values. For example, if Amazon Rekognition is able to detect a face that is at the image edge and is only partially visible, the service can return coordinates that are outside the image bounds and, depending on the image edge, you might get negative values or values greater than 1 for the left or top values.

" - }, - "Celebrity":{ - "type":"structure", - "members":{ - "Urls":{ - "shape":"Urls", - "documentation":"

An array of URLs pointing to additional information about the celebrity. If there is no additional information about the celebrity, this list is empty.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the celebrity.

" - }, - "Id":{ - "shape":"RekognitionUniqueId", - "documentation":"

A unique identifier for the celebrity.

" - }, - "Face":{ - "shape":"ComparedFace", - "documentation":"

Provides information about the celebrity's face, such as its location on the image.

" - }, - "MatchConfidence":{ - "shape":"Percent", - "documentation":"

The confidence, in percentage, that Rekognition has that the recognized face is the celebrity.

" - } - }, - "documentation":"

Provides information about a celebrity recognized by the operation.

" - }, - "CelebrityDetail":{ - "type":"structure", - "members":{ - "Urls":{ - "shape":"Urls", - "documentation":"

An array of URLs pointing to additional celebrity information.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the celebrity.

" - }, - "Id":{ - "shape":"RekognitionUniqueId", - "documentation":"

The unique identifier for the celebrity.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

The confidence, in percentage, that Amazon Rekognition has that the recognized face is the celebrity.

" - }, - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box around the body of a celebrity.

" - }, - "Face":{ - "shape":"FaceDetail", - "documentation":"

Face details for the recognized celebrity.

" - } - }, - "documentation":"

Information about a recognized celebrity.

" - }, - "CelebrityList":{ - "type":"list", - "member":{"shape":"Celebrity"} - }, - "CelebrityRecognition":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time, in milliseconds from the start of the video, that the celebrity was recognized.

" - }, - "Celebrity":{ - "shape":"CelebrityDetail", - "documentation":"

Information about a recognized celebrity.

" - } - }, - "documentation":"

Information about a detected celebrity and the time the celebrity was detected in a stored video. For more information, see GetCelebrityRecognition in the Amazon Rekognition Developer Guide.

" - }, - "CelebrityRecognitionSortBy":{ - "type":"string", - "enum":[ - "ID", - "TIMESTAMP" - ] - }, - "CelebrityRecognitions":{ - "type":"list", - "member":{"shape":"CelebrityRecognition"} - }, - "ClientRequestToken":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9-_]+$" - }, - "CollectionId":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[a-zA-Z0-9_.\\-]+" - }, - "CollectionIdList":{ - "type":"list", - "member":{"shape":"CollectionId"} - }, - "CompareFacesMatch":{ - "type":"structure", - "members":{ - "Similarity":{ - "shape":"Percent", - "documentation":"

Level of confidence that the faces match.

" - }, - "Face":{ - "shape":"ComparedFace", - "documentation":"

Provides face metadata (bounding box and confidence that the bounding box actually contains a face).

" - } - }, - "documentation":"

Provides information about a face in a target image that matches the source image face analysed by CompareFaces. The Face property contains the bounding box of the face in the target image. The Similarity property is the confidence that the source image face matches the face in the bounding box.

" - }, - "CompareFacesMatchList":{ - "type":"list", - "member":{"shape":"CompareFacesMatch"} - }, - "CompareFacesRequest":{ - "type":"structure", - "required":[ - "SourceImage", - "TargetImage" - ], - "members":{ - "SourceImage":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "TargetImage":{ - "shape":"Image", - "documentation":"

The target image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "SimilarityThreshold":{ - "shape":"Percent", - "documentation":"

The minimum level of confidence in the face matches that a match must meet to be included in the FaceMatches array.

" - } - } - }, - "CompareFacesResponse":{ - "type":"structure", - "members":{ - "SourceImageFace":{ - "shape":"ComparedSourceImageFace", - "documentation":"

The face in the source image that was used for comparison.

" - }, - "FaceMatches":{ - "shape":"CompareFacesMatchList", - "documentation":"

An array of faces in the target image that match the source image face. Each CompareFacesMatch object provides the bounding box, the confidence level that the bounding box contains a face, and the similarity score for the face in the bounding box and the face in the source image.

" - }, - "UnmatchedFaces":{ - "shape":"CompareFacesUnmatchList", - "documentation":"

An array of faces in the target image that did not match the source image face.

" - }, - "SourceImageOrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the source image (counterclockwise direction). If your application displays the source image, you can use this value to correct image orientation. The bounding box coordinates returned in SourceImageFace represent the location of the face before the image orientation is corrected.

If the source image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If the Exif metadata for the source image populates the orientation field, the value of OrientationCorrection is null and the SourceImageFace bounding box coordinates represent the location of the face after Exif metadata is used to correct the orientation. Images in .png format don't contain Exif metadata.

" - }, - "TargetImageOrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the target image (in counterclockwise direction). If your application displays the target image, you can use this value to correct the orientation of the image. The bounding box coordinates returned in FaceMatches and UnmatchedFaces represent face locations before the image orientation is corrected.

If the target image is in .jpg format, it might contain Exif metadata that includes the orientation of the image. If the Exif metadata for the target image populates the orientation field, the value of OrientationCorrection is null and the bounding box coordinates in FaceMatches and UnmatchedFaces represent the location of the face after Exif metadata is used to correct the orientation. Images in .png format don't contain Exif metadata.

" - } - } - }, - "CompareFacesUnmatchList":{ - "type":"list", - "member":{"shape":"ComparedFace"} - }, - "ComparedFace":{ - "type":"structure", - "members":{ - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box of the face.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence that what the bounding box contains is a face.

" - }, - "Landmarks":{ - "shape":"Landmarks", - "documentation":"

An array of facial landmarks.

" - }, - "Pose":{ - "shape":"Pose", - "documentation":"

Indicates the pose of the face as determined by its pitch, roll, and yaw.

" - }, - "Quality":{ - "shape":"ImageQuality", - "documentation":"

Identifies face image brightness and sharpness.

" - } - }, - "documentation":"

Provides face metadata for target image faces that are analysed by CompareFaces and RecognizeCelebrities.

" - }, - "ComparedFaceList":{ - "type":"list", - "member":{"shape":"ComparedFace"} - }, - "ComparedSourceImageFace":{ - "type":"structure", - "members":{ - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box of the face.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Confidence level that the selected bounding box contains a face.

" - } - }, - "documentation":"

Type that describes the face Amazon Rekognition chose to compare with the faces in the target. This contains a bounding box for the selected face and confidence level that the bounding box contains a face. Note that Amazon Rekognition selects the largest face in the source image for this comparison.

" - }, - "ContentModerationDetection":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time, in milliseconds from the beginning of the video, that the moderation label was detected.

" - }, - "ModerationLabel":{ - "shape":"ModerationLabel", - "documentation":"

The moderation label detected by in the stored video.

" - } - }, - "documentation":"

Information about a moderation label detection in a stored video.

" - }, - "ContentModerationDetections":{ - "type":"list", - "member":{"shape":"ContentModerationDetection"} - }, - "ContentModerationSortBy":{ - "type":"string", - "enum":[ - "NAME", - "TIMESTAMP" - ] - }, - "CreateCollectionRequest":{ - "type":"structure", - "required":["CollectionId"], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID for the collection that you are creating.

" - } - } - }, - "CreateCollectionResponse":{ - "type":"structure", - "members":{ - "StatusCode":{ - "shape":"UInteger", - "documentation":"

HTTP status code indicating the result of the operation.

" - }, - "CollectionArn":{ - "shape":"String", - "documentation":"

Amazon Resource Name (ARN) of the collection. You can use this to manage permissions on your resources.

" - }, - "FaceModelVersion":{ - "shape":"String", - "documentation":"

Version number of the face detection model associated with the collection you are creating.

" - } - } - }, - "CreateStreamProcessorRequest":{ - "type":"structure", - "required":[ - "Input", - "Output", - "Name", - "Settings", - "RoleArn" - ], - "members":{ - "Input":{ - "shape":"StreamProcessorInput", - "documentation":"

Kinesis video stream stream that provides the source streaming video. If you are using the AWS CLI, the parameter name is StreamProcessorInput.

" - }, - "Output":{ - "shape":"StreamProcessorOutput", - "documentation":"

Kinesis data stream stream to which Amazon Rekognition Video puts the analysis results. If you are using the AWS CLI, the parameter name is StreamProcessorOutput.

" - }, - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

An identifier you assign to the stream processor. You can use Name to manage the stream processor. For example, you can get the current status of the stream processor by calling . Name is idempotent.

" - }, - "Settings":{ - "shape":"StreamProcessorSettings", - "documentation":"

Face recognition input parameters to be used by the stream processor. Includes the collection to use for face recognition and the face attributes to detect.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

ARN of the IAM role that allows access to the stream processor.

" - } - } - }, - "CreateStreamProcessorResponse":{ - "type":"structure", - "members":{ - "StreamProcessorArn":{ - "shape":"StreamProcessorArn", - "documentation":"

ARN for the newly create stream processor.

" - } - } - }, - "DateTime":{"type":"timestamp"}, - "Degree":{ - "type":"float", - "max":180, - "min":-180 - }, - "DeleteCollectionRequest":{ - "type":"structure", - "required":["CollectionId"], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID of the collection to delete.

" - } - } - }, - "DeleteCollectionResponse":{ - "type":"structure", - "members":{ - "StatusCode":{ - "shape":"UInteger", - "documentation":"

HTTP status code that indicates the result of the operation.

" - } - } - }, - "DeleteFacesRequest":{ - "type":"structure", - "required":[ - "CollectionId", - "FaceIds" - ], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

Collection from which to remove the specific faces.

" - }, - "FaceIds":{ - "shape":"FaceIdList", - "documentation":"

An array of face IDs to delete.

" - } - } - }, - "DeleteFacesResponse":{ - "type":"structure", - "members":{ - "DeletedFaces":{ - "shape":"FaceIdList", - "documentation":"

An array of strings (face IDs) of the faces that were deleted.

" - } - } - }, - "DeleteStreamProcessorRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

The name of the stream processor you want to delete.

" - } - } - }, - "DeleteStreamProcessorResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeStreamProcessorRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

Name of the stream processor for which you want information.

" - } - } - }, - "DescribeStreamProcessorResponse":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

Name of the stream processor.

" - }, - "StreamProcessorArn":{ - "shape":"StreamProcessorArn", - "documentation":"

ARN of the stream processor.

" - }, - "Status":{ - "shape":"StreamProcessorStatus", - "documentation":"

Current status of the stream processor.

" - }, - "StatusMessage":{ - "shape":"String", - "documentation":"

Detailed status message about the stream processor.

" - }, - "CreationTimestamp":{ - "shape":"DateTime", - "documentation":"

Date and time the stream processor was created

" - }, - "LastUpdateTimestamp":{ - "shape":"DateTime", - "documentation":"

The time, in Unix format, the stream processor was last updated. For example, when the stream processor moves from a running state to a failed state, or when the user starts or stops the stream processor.

" - }, - "Input":{ - "shape":"StreamProcessorInput", - "documentation":"

Kinesis video stream that provides the source streaming video.

" - }, - "Output":{ - "shape":"StreamProcessorOutput", - "documentation":"

Kinesis data stream to which Amazon Rekognition Video puts the analysis results.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

ARN of the IAM role that allows access to the stream processor.

" - }, - "Settings":{ - "shape":"StreamProcessorSettings", - "documentation":"

Face recognition input parameters that are being used by the stream processor. Includes the collection to use for face recognition and the face attributes to detect.

" - } - } - }, - "DetectFacesRequest":{ - "type":"structure", - "required":["Image"], - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

An array of facial attributes you want to be returned. This can be the default list of attributes or all attributes. If you don't specify a value for Attributes or if you specify [\"DEFAULT\"], the API returns the following subset of facial attributes: BoundingBox, Confidence, Pose, Quality and Landmarks. If you provide [\"ALL\"], all facial attributes are returned but the operation will take longer to complete.

If you provide both, [\"ALL\", \"DEFAULT\"], the service uses a logical AND operator to determine which attributes to return (in this case, all attributes).

" - } - } - }, - "DetectFacesResponse":{ - "type":"structure", - "members":{ - "FaceDetails":{ - "shape":"FaceDetailList", - "documentation":"

Details of each face found in the image.

" - }, - "OrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the input image (counter-clockwise direction). If your application displays the image, you can use this value to correct image orientation. The bounding box coordinates returned in FaceDetails represent face locations before the image orientation is corrected.

If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null and the FaceDetails bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

" - } - } - }, - "DetectLabelsRequest":{ - "type":"structure", - "required":["Image"], - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "MaxLabels":{ - "shape":"UInteger", - "documentation":"

Maximum number of labels you want the service to return in the response. The service returns the specified number of highest confidence labels.

" - }, - "MinConfidence":{ - "shape":"Percent", - "documentation":"

Specifies the minimum confidence level for the labels to return. Amazon Rekognition doesn't return any labels with confidence lower than this specified value.

If MinConfidence is not specified, the operation returns labels with a confidence values greater than or equal to 50 percent.

" - } - } - }, - "DetectLabelsResponse":{ - "type":"structure", - "members":{ - "Labels":{ - "shape":"Labels", - "documentation":"

An array of labels for the real-world objects detected.

" - }, - "OrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the input image (counter-clockwise direction). If your application displays the image, you can use this value to correct the orientation. If Amazon Rekognition detects that the input image was rotated (for example, by 90 degrees), it first corrects the orientation before detecting the labels.

If the input image Exif metadata populates the orientation field, Amazon Rekognition does not perform orientation correction and the value of OrientationCorrection will be null.

" - } - } - }, - "DetectModerationLabelsRequest":{ - "type":"structure", - "required":["Image"], - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "MinConfidence":{ - "shape":"Percent", - "documentation":"

Specifies the minimum confidence level for the labels to return. Amazon Rekognition doesn't return any labels with a confidence level lower than this specified value.

If you don't specify MinConfidence, the operation returns labels with confidence values greater than or equal to 50 percent.

" - } - } - }, - "DetectModerationLabelsResponse":{ - "type":"structure", - "members":{ - "ModerationLabels":{ - "shape":"ModerationLabels", - "documentation":"

Array of detected Moderation labels and the time, in millseconds from the start of the video, they were detected.

" - } - } - }, - "DetectTextRequest":{ - "type":"structure", - "required":["Image"], - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an Amazon S3 object. If you use the AWS CLI to call Amazon Rekognition operations, you can't pass image bytes.

" - } - } - }, - "DetectTextResponse":{ - "type":"structure", - "members":{ - "TextDetections":{ - "shape":"TextDetectionList", - "documentation":"

An array of text that was detected in the input image.

" - } - } - }, - "Emotion":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"EmotionName", - "documentation":"

Type of emotion detected.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

The emotions detected on the face, and the confidence level in the determination. For example, HAPPY, SAD, and ANGRY.

" - }, - "EmotionName":{ - "type":"string", - "enum":[ - "HAPPY", - "SAD", - "ANGRY", - "CONFUSED", - "DISGUSTED", - "SURPRISED", - "CALM", - "UNKNOWN" - ] - }, - "Emotions":{ - "type":"list", - "member":{"shape":"Emotion"} - }, - "ExternalImageId":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[a-zA-Z0-9_.\\-:]+" - }, - "EyeOpen":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the eyes on the face are open.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the eyes on the face are open, and the confidence level in the determination.

" - }, - "Eyeglasses":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the face is wearing eye glasses or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the face is wearing eye glasses, and the confidence level in the determination.

" - }, - "Face":{ - "type":"structure", - "members":{ - "FaceId":{ - "shape":"FaceId", - "documentation":"

Unique identifier that Amazon Rekognition assigns to the face.

" - }, - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box of the face.

" - }, - "ImageId":{ - "shape":"ImageId", - "documentation":"

Unique identifier that Amazon Rekognition assigns to the input image.

" - }, - "ExternalImageId":{ - "shape":"ExternalImageId", - "documentation":"

Identifier that you assign to all the faces in the input image.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Confidence level that the bounding box contains a face (and not a different object such as a tree).

" - } - }, - "documentation":"

Describes the face properties such as the bounding box, face ID, image ID of the input image, and external image ID that you assigned.

" - }, - "FaceAttributes":{ - "type":"string", - "enum":[ - "DEFAULT", - "ALL" - ] - }, - "FaceDetail":{ - "type":"structure", - "members":{ - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box of the face. Default attribute.

" - }, - "AgeRange":{ - "shape":"AgeRange", - "documentation":"

The estimated age range, in years, for the face. Low represents the lowest estimated age and High represents the highest estimated age.

" - }, - "Smile":{ - "shape":"Smile", - "documentation":"

Indicates whether or not the face is smiling, and the confidence level in the determination.

" - }, - "Eyeglasses":{ - "shape":"Eyeglasses", - "documentation":"

Indicates whether or not the face is wearing eye glasses, and the confidence level in the determination.

" - }, - "Sunglasses":{ - "shape":"Sunglasses", - "documentation":"

Indicates whether or not the face is wearing sunglasses, and the confidence level in the determination.

" - }, - "Gender":{ - "shape":"Gender", - "documentation":"

Gender of the face and the confidence level in the determination.

" - }, - "Beard":{ - "shape":"Beard", - "documentation":"

Indicates whether or not the face has a beard, and the confidence level in the determination.

" - }, - "Mustache":{ - "shape":"Mustache", - "documentation":"

Indicates whether or not the face has a mustache, and the confidence level in the determination.

" - }, - "EyesOpen":{ - "shape":"EyeOpen", - "documentation":"

Indicates whether or not the eyes on the face are open, and the confidence level in the determination.

" - }, - "MouthOpen":{ - "shape":"MouthOpen", - "documentation":"

Indicates whether or not the mouth on the face is open, and the confidence level in the determination.

" - }, - "Emotions":{ - "shape":"Emotions", - "documentation":"

The emotions detected on the face, and the confidence level in the determination. For example, HAPPY, SAD, and ANGRY.

" - }, - "Landmarks":{ - "shape":"Landmarks", - "documentation":"

Indicates the location of landmarks on the face. Default attribute.

" - }, - "Pose":{ - "shape":"Pose", - "documentation":"

Indicates the pose of the face as determined by its pitch, roll, and yaw. Default attribute.

" - }, - "Quality":{ - "shape":"ImageQuality", - "documentation":"

Identifies image brightness and sharpness. Default attribute.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Confidence level that the bounding box contains a face (and not a different object such as a tree). Default attribute.

" - } - }, - "documentation":"

Structure containing attributes of the face that the algorithm detected.

A FaceDetail object contains either the default facial attributes or all facial attributes. The default attributes are BoundingBox, Confidence, Landmarks, Pose, and Quality.

is the only Amazon Rekognition Video stored video operation that can return a FaceDetail object with all attributes. To specify which attributes to return, use the FaceAttributes input parameter for . The following Amazon Rekognition Video operations return only the default attributes. The corresponding Start operations don't have a FaceAttributes input parameter.

  • GetCelebrityRecognition

  • GetPersonTracking

  • GetFaceSearch

The Amazon Rekognition Image and operations can return all facial attributes. To specify which attributes to return, use the Attributes input parameter for DetectFaces. For IndexFaces, use the DetectAttributes input parameter.

" - }, - "FaceDetailList":{ - "type":"list", - "member":{"shape":"FaceDetail"} - }, - "FaceDetection":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time, in milliseconds from the start of the video, that the face was detected.

" - }, - "Face":{ - "shape":"FaceDetail", - "documentation":"

The face properties for the detected face.

" - } - }, - "documentation":"

Information about a face detected in a video analysis request and the time the face was detected in the video.

" - }, - "FaceDetections":{ - "type":"list", - "member":{"shape":"FaceDetection"} - }, - "FaceId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "FaceIdList":{ - "type":"list", - "member":{"shape":"FaceId"}, - "max":4096, - "min":1 - }, - "FaceList":{ - "type":"list", - "member":{"shape":"Face"} - }, - "FaceMatch":{ - "type":"structure", - "members":{ - "Similarity":{ - "shape":"Percent", - "documentation":"

Confidence in the match of this face with the input face.

" - }, - "Face":{ - "shape":"Face", - "documentation":"

Describes the face properties such as the bounding box, face ID, image ID of the source image, and external image ID that you assigned.

" - } - }, - "documentation":"

Provides face metadata. In addition, it also provides the confidence in the match of this face with the input face.

" - }, - "FaceMatchList":{ - "type":"list", - "member":{"shape":"FaceMatch"} - }, - "FaceModelVersionList":{ - "type":"list", - "member":{"shape":"String"} - }, - "FaceRecord":{ - "type":"structure", - "members":{ - "Face":{ - "shape":"Face", - "documentation":"

Describes the face properties such as the bounding box, face ID, image ID of the input image, and external image ID that you assigned.

" - }, - "FaceDetail":{ - "shape":"FaceDetail", - "documentation":"

Structure containing attributes of the face that the algorithm detected.

" - } - }, - "documentation":"

Object containing both the face metadata (stored in the back-end database) and facial attributes that are detected but aren't stored in the database.

" - }, - "FaceRecordList":{ - "type":"list", - "member":{"shape":"FaceRecord"} - }, - "FaceSearchSettings":{ - "type":"structure", - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

The ID of a collection that contains faces that you want to search for.

" - }, - "FaceMatchThreshold":{ - "shape":"Percent", - "documentation":"

Minimum face match confidence score that must be met to return a result for a recognized face. Default is 70. 0 is the lowest confidence. 100 is the highest confidence.

" - } - }, - "documentation":"

Input face recognition parameters for an Amazon Rekognition stream processor. FaceRecognitionSettings is a request parameter for .

" - }, - "FaceSearchSortBy":{ - "type":"string", - "enum":[ - "INDEX", - "TIMESTAMP" - ] - }, - "Float":{"type":"float"}, - "Gender":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"GenderType", - "documentation":"

Gender of the face.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Gender of the face and the confidence level in the determination.

" - }, - "GenderType":{ - "type":"string", - "enum":[ - "Male", - "Female" - ] - }, - "Geometry":{ - "type":"structure", - "members":{ - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

An axis-aligned coarse representation of the detected text's location on the image.

" - }, - "Polygon":{ - "shape":"Polygon", - "documentation":"

Within the bounding box, a fine-grained polygon around the detected text.

" - } - }, - "documentation":"

Information about where text detected by is located on an image.

" - }, - "GetCelebrityInfoRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"RekognitionUniqueId", - "documentation":"

The ID for the celebrity. You get the celebrity ID from a call to the operation, which recognizes celebrities in an image.

" - } - } - }, - "GetCelebrityInfoResponse":{ - "type":"structure", - "members":{ - "Urls":{ - "shape":"Urls", - "documentation":"

An array of URLs pointing to additional celebrity information.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the celebrity.

" - } - } - }, - "GetCelebrityRecognitionRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

Job identifier for the required celebrity recognition analysis. You can get the job identifer from a call to StartCelebrityRecognition.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there is more recognized celebrities to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of celebrities.

" - }, - "SortBy":{ - "shape":"CelebrityRecognitionSortBy", - "documentation":"

Sort to use for celebrities returned in Celebrities field. Specify ID to sort by the celebrity identifier, specify TIMESTAMP to sort by the time the celebrity was recognized.

" - } - } - }, - "GetCelebrityRecognitionResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the celebrity recognition job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition Video analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition Video operation.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of celebrities.

" - }, - "Celebrities":{ - "shape":"CelebrityRecognitions", - "documentation":"

Array of celebrities recognized in the video.

" - } - } - }, - "GetContentModerationRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the content moderation job. Use JobId to identify the job in a subsequent call to GetContentModeration.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there is more data to retrieve), Amazon Rekognition returns a pagination token in the response. You can use this pagination token to retrieve the next set of content moderation labels.

" - }, - "SortBy":{ - "shape":"ContentModerationSortBy", - "documentation":"

Sort to use for elements in the ModerationLabelDetections array. Use TIMESTAMP to sort array elements by the time labels are detected. Use NAME to alphabetically group elements for a label together. Within each label group, the array element are sorted by detection confidence. The default sort is by TIMESTAMP.

" - } - } - }, - "GetContentModerationResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the content moderation job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition analyzed. Videometadata is returned in every page of paginated responses from GetContentModeration.

" - }, - "ModerationLabels":{ - "shape":"ContentModerationDetections", - "documentation":"

The detected moderation labels and the time(s) they were detected.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of moderation labels.

" - } - } - }, - "GetFaceDetectionRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

Unique identifier for the face detection job. The JobId is returned from StartFaceDetection.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there are more faces to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of faces.

" - } - } - }, - "GetFaceDetectionResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the face detection job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition Video analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition video operation.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition returns this token that you can use in the subsequent request to retrieve the next set of faces.

" - }, - "Faces":{ - "shape":"FaceDetections", - "documentation":"

An array of faces detected in the video. Each element contains a detected face's details and the time, in milliseconds from the start of the video, the face was detected.

" - } - } - }, - "GetFaceSearchRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The job identifer for the search request. You get the job identifier from an initial call to StartFaceSearch.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there is more search results to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of search results.

" - }, - "SortBy":{ - "shape":"FaceSearchSortBy", - "documentation":"

Sort to use for grouping faces in the response. Use TIMESTAMP to group faces by the time that they are recognized. Use INDEX to sort by recognized faces.

" - } - } - }, - "GetFaceSearchResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the face search job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of search results.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition Video operation.

" - }, - "Persons":{ - "shape":"PersonMatches", - "documentation":"

An array of persons, , in the video whose face(s) match the face(s) in an Amazon Rekognition collection. It also includes time information for when persons are matched in the video. You specify the input collection in an initial call to StartFaceSearch. Each Persons element includes a time the person was matched, face match details (FaceMatches) for matching faces in the collection, and person information (Person) for the matched person.

" - } - } - }, - "GetLabelDetectionRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

Job identifier for the label detection operation for which you want results returned. You get the job identifer from an initial call to StartlabelDetection.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there are more labels to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of labels.

" - }, - "SortBy":{ - "shape":"LabelDetectionSortBy", - "documentation":"

Sort to use for elements in the Labels array. Use TIMESTAMP to sort array elements by the time labels are detected. Use NAME to alphabetically group elements for a label together. Within each label group, the array element are sorted by detection confidence. The default sort is by TIMESTAMP.

" - } - } - }, - "GetLabelDetectionResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the label detection job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition Video analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition video operation.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of labels.

" - }, - "Labels":{ - "shape":"LabelDetections", - "documentation":"

An array of labels detected in the video. Each element contains the detected label and the time, in milliseconds from the start of the video, that the label was detected.

" - } - } - }, - "GetPersonTrackingRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for a job that tracks persons in a video. You get the JobId from a call to StartPersonTracking.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there are more persons to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of persons.

" - }, - "SortBy":{ - "shape":"PersonTrackingSortBy", - "documentation":"

Sort to use for elements in the Persons array. Use TIMESTAMP to sort array elements by the time persons are detected. Use INDEX to sort by the tracked persons. If you sort by INDEX, the array elements for each person are sorted by detection confidence. The default sort is by TIMESTAMP.

" - } - } - }, - "GetPersonTrackingResponse":{ - "type":"structure", - "members":{ - "JobStatus":{ - "shape":"VideoJobStatus", - "documentation":"

The current status of the person tracking job.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

If the job fails, StatusMessage provides a descriptive error message.

" - }, - "VideoMetadata":{ - "shape":"VideoMetadata", - "documentation":"

Information about a video that Amazon Rekognition Video analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition Video operation.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of persons.

" - }, - "Persons":{ - "shape":"PersonDetections", - "documentation":"

An array of the persons detected in the video and the times they are tracked throughout the video. An array element will exist for each time the person is tracked.

" - } - } - }, - "IdempotentParameterMismatchException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A ClientRequestToken input parameter was reused with an operation, but at least one of the other input parameters is different from the previous call to the operation.

", - "exception":true - }, - "Image":{ - "type":"structure", - "members":{ - "Bytes":{ - "shape":"ImageBlob", - "documentation":"

Blob of image bytes up to 5 MBs.

" - }, - "S3Object":{ - "shape":"S3Object", - "documentation":"

Identifies an S3 object as the image source.

" - } - }, - "documentation":"

Provides the input image either as bytes or an S3 object.

You pass image bytes to a Rekognition API operation by using the Bytes property. For example, you would use the Bytes property to pass an image loaded from a local file system. Image bytes passed by using the Bytes property must be base64-encoded. Your code may not need to encode image bytes if you are using an AWS SDK to call Rekognition API operations.

For more information, see Analyzing an Image Loaded from a Local File System in the Amazon Rekognition Developer Guide.

You pass images stored in an S3 bucket to a Rekognition API operation by using the S3Object property. Images stored in an S3 bucket do not need to be base64-encoded.

The region for the S3 bucket containing the S3 object must match the region you use for Amazon Rekognition operations.

If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes using the Bytes property is not supported. You must first upload the image to an Amazon S3 bucket and then call the operation using the S3Object property.

For Amazon Rekognition to process an S3 object, the user must have permission to access the S3 object. For more information, see Resource Based Policies in the Amazon Rekognition Developer Guide.

" - }, - "ImageBlob":{ - "type":"blob", - "max":5242880, - "min":1 - }, - "ImageId":{ - "type":"string", - "pattern":"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "ImageQuality":{ - "type":"structure", - "members":{ - "Brightness":{ - "shape":"Float", - "documentation":"

Value representing brightness of the face. The service returns a value between 0 and 100 (inclusive). A higher value indicates a brighter face image.

" - }, - "Sharpness":{ - "shape":"Float", - "documentation":"

Value representing sharpness of the face. The service returns a value between 0 and 100 (inclusive). A higher value indicates a sharper face image.

" - } - }, - "documentation":"

Identifies face image brightness and sharpness.

" - }, - "ImageTooLargeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The input image size exceeds the allowed limit. For more information, see Limits in Amazon Rekognition in the Amazon Rekognition Developer Guide.

", - "exception":true - }, - "IndexFacesRequest":{ - "type":"structure", - "required":[ - "CollectionId", - "Image" - ], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

The ID of an existing collection to which you want to add the faces that are detected in the input images.

" - }, - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "ExternalImageId":{ - "shape":"ExternalImageId", - "documentation":"

ID you want to assign to all the faces detected in the image.

" - }, - "DetectionAttributes":{ - "shape":"Attributes", - "documentation":"

An array of facial attributes that you want to be returned. This can be the default list of attributes or all attributes. If you don't specify a value for Attributes or if you specify [\"DEFAULT\"], the API returns the following subset of facial attributes: BoundingBox, Confidence, Pose, Quality and Landmarks. If you provide [\"ALL\"], all facial attributes are returned but the operation will take longer to complete.

If you provide both, [\"ALL\", \"DEFAULT\"], the service uses a logical AND operator to determine which attributes to return (in this case, all attributes).

" - } - } - }, - "IndexFacesResponse":{ - "type":"structure", - "members":{ - "FaceRecords":{ - "shape":"FaceRecordList", - "documentation":"

An array of faces detected and added to the collection. For more information, see Searching Faces in a Collection in the Amazon Rekognition Developer Guide.

" - }, - "OrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct image orientation. The bounding box coordinates returned in FaceRecords represent face locations before the image orientation is corrected.

If the input image is in jpeg format, it might contain exchangeable image (Exif) metadata. If so, and the Exif metadata populates the orientation field, the value of OrientationCorrection is null and the bounding box coordinates in FaceRecords represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

" - }, - "FaceModelVersion":{ - "shape":"String", - "documentation":"

Version number of the face detection model associated with the input collection (CollectionId).

" - } - } - }, - "InternalServerError":{ - "type":"structure", - "members":{ - }, - "documentation":"

Amazon Rekognition experienced a service issue. Try your call again.

", - "exception":true, - "fault":true - }, - "InvalidImageFormatException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The provided image format is not supported.

", - "exception":true - }, - "InvalidPaginationTokenException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Pagination token in the request is not valid.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Input parameter violated a constraint. Validate your parameter before calling the API operation again.

", - "exception":true - }, - "InvalidS3ObjectException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Amazon Rekognition is unable to access the S3 object specified in the request.

", - "exception":true - }, - "JobId":{ - "type":"string", - "max":64, - "min":1, - "pattern":"^[a-zA-Z0-9-_]+$" - }, - "JobTag":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9_.\\-:]+" - }, - "KinesisDataArn":{ - "type":"string", - "pattern":"(^arn:([a-z\\d-]+):kinesis:([a-z\\d-]+):\\d{12}:.+$)" - }, - "KinesisDataStream":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"KinesisDataArn", - "documentation":"

ARN of the output Amazon Kinesis Data Streams stream.

" - } - }, - "documentation":"

The Kinesis data stream Amazon Rekognition to which the analysis results of a Amazon Rekognition stream processor are streamed. For more information, see CreateStreamProcessor in the Amazon Rekognition Developer Guide.

" - }, - "KinesisVideoArn":{ - "type":"string", - "pattern":"(^arn:([a-z\\d-]+):kinesisvideo:([a-z\\d-]+):\\d{12}:.+$)" - }, - "KinesisVideoStream":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"KinesisVideoArn", - "documentation":"

ARN of the Kinesis video stream stream that streams the source video.

" - } - }, - "documentation":"

Kinesis video stream stream that provides the source streaming video for a Amazon Rekognition Video stream processor. For more information, see CreateStreamProcessor in the Amazon Rekognition Developer Guide.

" - }, - "Label":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name (label) of the object.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence.

" - } - }, - "documentation":"

Structure containing details about the detected label, including name, and level of confidence.

" - }, - "LabelDetection":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time, in milliseconds from the start of the video, that the label was detected.

" - }, - "Label":{ - "shape":"Label", - "documentation":"

Details about the detected label.

" - } - }, - "documentation":"

Information about a label detected in a video analysis request and the time the label was detected in the video.

" - }, - "LabelDetectionSortBy":{ - "type":"string", - "enum":[ - "NAME", - "TIMESTAMP" - ] - }, - "LabelDetections":{ - "type":"list", - "member":{"shape":"LabelDetection"} - }, - "Labels":{ - "type":"list", - "member":{"shape":"Label"} - }, - "Landmark":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"LandmarkType", - "documentation":"

Type of the landmark.

" - }, - "X":{ - "shape":"Float", - "documentation":"

x-coordinate from the top left of the landmark expressed as the ratio of the width of the image. For example, if the images is 700x200 and the x-coordinate of the landmark is at 350 pixels, this value is 0.5.

" - }, - "Y":{ - "shape":"Float", - "documentation":"

y-coordinate from the top left of the landmark expressed as the ratio of the height of the image. For example, if the images is 700x200 and the y-coordinate of the landmark is at 100 pixels, this value is 0.5.

" - } - }, - "documentation":"

Indicates the location of the landmark on the face.

" - }, - "LandmarkType":{ - "type":"string", - "enum":[ - "eyeLeft", - "eyeRight", - "nose", - "mouthLeft", - "mouthRight", - "leftEyeBrowLeft", - "leftEyeBrowRight", - "leftEyeBrowUp", - "rightEyeBrowLeft", - "rightEyeBrowRight", - "rightEyeBrowUp", - "leftEyeLeft", - "leftEyeRight", - "leftEyeUp", - "leftEyeDown", - "rightEyeLeft", - "rightEyeRight", - "rightEyeUp", - "rightEyeDown", - "noseLeft", - "noseRight", - "mouthUp", - "mouthDown", - "leftPupil", - "rightPupil" - ] - }, - "Landmarks":{ - "type":"list", - "member":{"shape":"Landmark"} - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An Amazon Rekognition service limit was exceeded. For example, if you start too many Amazon Rekognition Video jobs concurrently, calls to start operations (StartLabelDetection, for example) will raise a LimitExceededException exception (HTTP status code: 400) until the number of concurrently running jobs is below the Amazon Rekognition service limit.

", - "exception":true - }, - "ListCollectionsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Pagination token from the previous response.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

Maximum number of collection IDs to return.

" - } - } - }, - "ListCollectionsResponse":{ - "type":"structure", - "members":{ - "CollectionIds":{ - "shape":"CollectionIdList", - "documentation":"

An array of collection IDs.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the result is truncated, the response provides a NextToken that you can use in the subsequent request to fetch the next set of collection IDs.

" - }, - "FaceModelVersions":{ - "shape":"FaceModelVersionList", - "documentation":"

Version numbers of the face detection models associated with the collections in the array CollectionIds. For example, the value of FaceModelVersions[2] is the version number for the face detection model used by the collection in CollectionId[2].

" - } - } - }, - "ListFacesRequest":{ - "type":"structure", - "required":["CollectionId"], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID of the collection from which to list the faces.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there is more data to retrieve), Amazon Rekognition returns a pagination token in the response. You can use this pagination token to retrieve the next set of faces.

" - }, - "MaxResults":{ - "shape":"PageSize", - "documentation":"

Maximum number of faces to return.

" - } - } - }, - "ListFacesResponse":{ - "type":"structure", - "members":{ - "Faces":{ - "shape":"FaceList", - "documentation":"

An array of Face objects.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If the response is truncated, Amazon Rekognition returns this token that you can use in the subsequent request to retrieve the next set of faces.

" - }, - "FaceModelVersion":{ - "shape":"String", - "documentation":"

Version number of the face detection model associated with the input collection (CollectionId).

" - } - } - }, - "ListStreamProcessorsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the previous response was incomplete (because there are more stream processors to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of stream processors.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Maximum number of stream processors you want Amazon Rekognition Video to return in the response. The default is 1000.

" - } - } - }, - "ListStreamProcessorsResponse":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon Rekognition Video returns this token that you can use in the subsequent request to retrieve the next set of stream processors.

" - }, - "StreamProcessors":{ - "shape":"StreamProcessorList", - "documentation":"

List of stream processors that you have created.

" - } - } - }, - "MaxFaces":{ - "type":"integer", - "max":4096, - "min":1 - }, - "MaxResults":{ - "type":"integer", - "min":1 - }, - "ModerationLabel":{ - "type":"structure", - "members":{ - "Confidence":{ - "shape":"Percent", - "documentation":"

Specifies the confidence that Amazon Rekognition has that the label has been correctly identified.

If you don't specify the MinConfidence parameter in the call to DetectModerationLabels, the operation returns labels with a confidence value greater than or equal to 50 percent.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The label name for the type of content detected in the image.

" - }, - "ParentName":{ - "shape":"String", - "documentation":"

The name for the parent label. Labels at the top-level of the hierarchy have the parent label \"\".

" - } - }, - "documentation":"

Provides information about a single type of moderated content found in an image or video. Each type of moderated content has a label within a hierarchical taxonomy. For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

" - }, - "ModerationLabels":{ - "type":"list", - "member":{"shape":"ModerationLabel"} - }, - "MouthOpen":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the mouth on the face is open or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the mouth on the face is open, and the confidence level in the determination.

" - }, - "Mustache":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the face has mustache or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the face has a mustache, and the confidence level in the determination.

" - }, - "NotificationChannel":{ - "type":"structure", - "required":[ - "SNSTopicArn", - "RoleArn" - ], - "members":{ - "SNSTopicArn":{ - "shape":"SNSTopicArn", - "documentation":"

The Amazon SNS topic to which Amazon Rekognition to posts the completion status.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The ARN of an IAM role that gives Amazon Rekognition publishing permissions to the Amazon SNS topic.

" - } - }, - "documentation":"

The Amazon Simple Notification Service topic to which Amazon Rekognition publishes the completion status of a video analysis operation. For more information, see api-video.

" - }, - "OrientationCorrection":{ - "type":"string", - "enum":[ - "ROTATE_0", - "ROTATE_90", - "ROTATE_180", - "ROTATE_270" - ] - }, - "PageSize":{ - "type":"integer", - "max":4096, - "min":0 - }, - "PaginationToken":{ - "type":"string", - "max":255 - }, - "Percent":{ - "type":"float", - "max":100, - "min":0 - }, - "PersonDetail":{ - "type":"structure", - "members":{ - "Index":{ - "shape":"PersonIndex", - "documentation":"

Identifier for the person detected person within a video. Use to keep track of the person throughout the video. The identifier is not stored by Amazon Rekognition.

" - }, - "BoundingBox":{ - "shape":"BoundingBox", - "documentation":"

Bounding box around the detected person.

" - }, - "Face":{ - "shape":"FaceDetail", - "documentation":"

Face details for the detected person.

" - } - }, - "documentation":"

Details about a person detected in a video analysis request.

" - }, - "PersonDetection":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time, in milliseconds from the start of the video, that the person was tracked.

" - }, - "Person":{ - "shape":"PersonDetail", - "documentation":"

Details about a person tracked in a video.

" - } - }, - "documentation":"

Details and tracking information for a single time a person is tracked in a video. Amazon Rekognition operations that track persons return an array of PersonDetection objects with elements for each time a person is tracked in a video.

For more information, see API_GetPersonTracking in the Amazon Rekognition Developer Guide.

" - }, - "PersonDetections":{ - "type":"list", - "member":{"shape":"PersonDetection"} - }, - "PersonIndex":{"type":"long"}, - "PersonMatch":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time, in milliseconds from the beginning of the video, that the person was matched in the video.

" - }, - "Person":{ - "shape":"PersonDetail", - "documentation":"

Information about the matched person.

" - }, - "FaceMatches":{ - "shape":"FaceMatchList", - "documentation":"

Information about the faces in the input collection that match the face of a person in the video.

" - } - }, - "documentation":"

Information about a person whose face matches a face(s) in a Amazon Rekognition collection. Includes information about the faces in the Amazon Rekognition collection (, information about the person (PersonDetail) and the timestamp for when the person was detected in a video. An array of PersonMatch objects is returned by .

" - }, - "PersonMatches":{ - "type":"list", - "member":{"shape":"PersonMatch"} - }, - "PersonTrackingSortBy":{ - "type":"string", - "enum":[ - "INDEX", - "TIMESTAMP" - ] - }, - "Point":{ - "type":"structure", - "members":{ - "X":{ - "shape":"Float", - "documentation":"

The value of the X coordinate for a point on a Polygon.

" - }, - "Y":{ - "shape":"Float", - "documentation":"

The value of the Y coordinate for a point on a Polygon.

" - } - }, - "documentation":"

The X and Y coordinates of a point on an image. The X and Y values returned are ratios of the overall image size. For example, if the input image is 700x200 and the operation returns X=0.5 and Y=0.25, then the point is at the (350,50) pixel coordinate on the image.

An array of Point objects, Polygon, is returned by . Polygon represents a fine-grained polygon around detected text. For more information, see Geometry in the Amazon Rekognition Developer Guide.

" - }, - "Polygon":{ - "type":"list", - "member":{"shape":"Point"} - }, - "Pose":{ - "type":"structure", - "members":{ - "Roll":{ - "shape":"Degree", - "documentation":"

Value representing the face rotation on the roll axis.

" - }, - "Yaw":{ - "shape":"Degree", - "documentation":"

Value representing the face rotation on the yaw axis.

" - }, - "Pitch":{ - "shape":"Degree", - "documentation":"

Value representing the face rotation on the pitch axis.

" - } - }, - "documentation":"

Indicates the pose of the face as determined by its pitch, roll, and yaw.

" - }, - "ProvisionedThroughputExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition.

", - "exception":true - }, - "RecognizeCelebritiesRequest":{ - "type":"structure", - "required":["Image"], - "members":{ - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - } - } - }, - "RecognizeCelebritiesResponse":{ - "type":"structure", - "members":{ - "CelebrityFaces":{ - "shape":"CelebrityList", - "documentation":"

Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 15 celebrities in an image.

" - }, - "UnrecognizedFaces":{ - "shape":"ComparedFaceList", - "documentation":"

Details about each unrecognized face in the image.

" - }, - "OrientationCorrection":{ - "shape":"OrientationCorrection", - "documentation":"

The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected.

If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null and the CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

" - } - } - }, - "RekognitionUniqueId":{ - "type":"string", - "pattern":"[0-9A-Za-z]*" - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A collection with the specified ID already exists.

", - "exception":true - }, - "ResourceInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The collection specified in the request cannot be found.

", - "exception":true - }, - "RoleArn":{ - "type":"string", - "pattern":"arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - }, - "S3Bucket":{ - "type":"string", - "max":255, - "min":3, - "pattern":"[0-9A-Za-z\\.\\-_]*" - }, - "S3Object":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"S3Bucket", - "documentation":"

Name of the S3 bucket.

" - }, - "Name":{ - "shape":"S3ObjectName", - "documentation":"

S3 object key name.

" - }, - "Version":{ - "shape":"S3ObjectVersion", - "documentation":"

If the bucket is versioning enabled, you can specify the object version.

" - } - }, - "documentation":"

Provides the S3 bucket name and object name.

The region for the S3 bucket containing the S3 object must match the region you use for Amazon Rekognition operations.

For Amazon Rekognition to process an S3 object, the user must have permission to access the S3 object. For more information, see Resource Based Policies in the Amazon Rekognition Developer Guide.

" - }, - "S3ObjectName":{ - "type":"string", - "max":1024, - "min":1 - }, - "S3ObjectVersion":{ - "type":"string", - "max":1024, - "min":1 - }, - "SNSTopicArn":{ - "type":"string", - "pattern":"(^arn:aws:sns:.*:\\w{12}:.+$)" - }, - "SearchFacesByImageRequest":{ - "type":"structure", - "required":[ - "CollectionId", - "Image" - ], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID of the collection to search.

" - }, - "Image":{ - "shape":"Image", - "documentation":"

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

" - }, - "MaxFaces":{ - "shape":"MaxFaces", - "documentation":"

Maximum number of faces to return. The operation returns the maximum number of faces with the highest confidence in the match.

" - }, - "FaceMatchThreshold":{ - "shape":"Percent", - "documentation":"

(Optional) Specifies the minimum confidence in the face match to return. For example, don't return any matches where confidence in matches is less than 70%.

" - } - } - }, - "SearchFacesByImageResponse":{ - "type":"structure", - "members":{ - "SearchedFaceBoundingBox":{ - "shape":"BoundingBox", - "documentation":"

The bounding box around the face in the input image that Amazon Rekognition used for the search.

" - }, - "SearchedFaceConfidence":{ - "shape":"Percent", - "documentation":"

The level of confidence that the searchedFaceBoundingBox, contains a face.

" - }, - "FaceMatches":{ - "shape":"FaceMatchList", - "documentation":"

An array of faces that match the input face, along with the confidence in the match.

" - }, - "FaceModelVersion":{ - "shape":"String", - "documentation":"

Version number of the face detection model associated with the input collection (CollectionId).

" - } - } - }, - "SearchFacesRequest":{ - "type":"structure", - "required":[ - "CollectionId", - "FaceId" - ], - "members":{ - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID of the collection the face belongs to.

" - }, - "FaceId":{ - "shape":"FaceId", - "documentation":"

ID of a face to find matches for in the collection.

" - }, - "MaxFaces":{ - "shape":"MaxFaces", - "documentation":"

Maximum number of faces to return. The operation returns the maximum number of faces with the highest confidence in the match.

" - }, - "FaceMatchThreshold":{ - "shape":"Percent", - "documentation":"

Optional value specifying the minimum confidence in the face match to return. For example, don't return any matches where confidence in matches is less than 70%.

" - } - } - }, - "SearchFacesResponse":{ - "type":"structure", - "members":{ - "SearchedFaceId":{ - "shape":"FaceId", - "documentation":"

ID of the face that was searched for matches in a collection.

" - }, - "FaceMatches":{ - "shape":"FaceMatchList", - "documentation":"

An array of faces that matched the input face, along with the confidence in the match.

" - }, - "FaceModelVersion":{ - "shape":"String", - "documentation":"

Version number of the face detection model associated with the input collection (CollectionId).

" - } - } - }, - "Smile":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the face is smiling or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the face is smiling, and the confidence level in the determination.

" - }, - "StartCelebrityRecognitionRequest":{ - "type":"structure", - "required":["Video"], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video in which you want to recognize celebrities. The video must be stored in an Amazon S3 bucket.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartCelebrityRecognition requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The Amazon SNS topic ARN that you want Amazon Rekognition Video to publish the completion status of the celebrity recognition analysis to.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartCelebrityRecognitionResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the celebrity recognition analysis job. Use JobId to identify the job in a subsequent call to GetCelebrityRecognition.

" - } - } - }, - "StartContentModerationRequest":{ - "type":"structure", - "required":["Video"], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video in which you want to moderate content. The video must be stored in an Amazon S3 bucket.

" - }, - "MinConfidence":{ - "shape":"Percent", - "documentation":"

Specifies the minimum confidence that Amazon Rekognition must have in order to return a moderated content label. Confidence represents how certain Amazon Rekognition is that the moderated content is correctly identified. 0 is the lowest confidence. 100 is the highest confidence. Amazon Rekognition doesn't return any moderated content labels with a confidence level lower than this specified value.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartContentModeration requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The Amazon SNS topic ARN that you want Amazon Rekognition Video to publish the completion status of the content moderation analysis to.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartContentModerationResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the content moderation analysis job. Use JobId to identify the job in a subsequent call to GetContentModeration.

" - } - } - }, - "StartFaceDetectionRequest":{ - "type":"structure", - "required":["Video"], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video in which you want to detect faces. The video must be stored in an Amazon S3 bucket.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartFaceDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the face detection operation.

" - }, - "FaceAttributes":{ - "shape":"FaceAttributes", - "documentation":"

The face attributes you want returned.

DEFAULT - The following subset of facial attributes are returned: BoundingBox, Confidence, Pose, Quality and Landmarks.

ALL - All facial attributes are returned.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartFaceDetectionResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the face detection job. Use JobId to identify the job in a subsequent call to GetFaceDetection.

" - } - } - }, - "StartFaceSearchRequest":{ - "type":"structure", - "required":[ - "Video", - "CollectionId" - ], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video you want to search. The video must be stored in an Amazon S3 bucket.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "FaceMatchThreshold":{ - "shape":"Percent", - "documentation":"

The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.

" - }, - "CollectionId":{ - "shape":"CollectionId", - "documentation":"

ID of the collection that contains the faces you want to search for.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartFaceSearchResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the search job. Use JobId to identify the job in a subsequent call to GetFaceSearch.

" - } - } - }, - "StartLabelDetectionRequest":{ - "type":"structure", - "required":["Video"], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video in which you want to detect labels. The video must be stored in an Amazon S3 bucket.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartLabelDetection requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "MinConfidence":{ - "shape":"Percent", - "documentation":"

Specifies the minimum confidence that Amazon Rekognition Video must have in order to return a detected label. Confidence represents how certain Amazon Rekognition is that a label is correctly identified.0 is the lowest confidence. 100 is the highest confidence. Amazon Rekognition Video doesn't return any labels with a confidence level lower than this specified value.

If you don't specify MinConfidence, the operation returns labels with confidence values greater than or equal to 50 percent.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the label detection operation to.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartLabelDetectionResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the label detection job. Use JobId to identify the job in a subsequent call to GetLabelDetection.

" - } - } - }, - "StartPersonTrackingRequest":{ - "type":"structure", - "required":["Video"], - "members":{ - "Video":{ - "shape":"Video", - "documentation":"

The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestToken", - "documentation":"

Idempotent token used to identify the start request. If you use the same token with multiple StartPersonTracking requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

" - }, - "NotificationChannel":{ - "shape":"NotificationChannel", - "documentation":"

The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.

" - }, - "JobTag":{ - "shape":"JobTag", - "documentation":"

Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.

" - } - } - }, - "StartPersonTrackingResponse":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The identifier for the person detection job. Use JobId to identify the job in a subsequent call to GetPersonTracking.

" - } - } - }, - "StartStreamProcessorRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

The name of the stream processor to start processing.

" - } - } - }, - "StartStreamProcessorResponse":{ - "type":"structure", - "members":{ - } - }, - "StatusMessage":{"type":"string"}, - "StopStreamProcessorRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

The name of a stream processor created by .

" - } - } - }, - "StopStreamProcessorResponse":{ - "type":"structure", - "members":{ - } - }, - "StreamProcessor":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"StreamProcessorName", - "documentation":"

Name of the Amazon Rekognition stream processor.

" - }, - "Status":{ - "shape":"StreamProcessorStatus", - "documentation":"

Current status of the Amazon Rekognition stream processor.

" - } - }, - "documentation":"

An object that recognizes faces in a streaming video. An Amazon Rekognition stream processor is created by a call to . The request parameters for CreateStreamProcessor describe the Kinesis video stream source for the streaming video, face recognition parameters, and where to stream the analysis resullts.

" - }, - "StreamProcessorArn":{ - "type":"string", - "pattern":"(^arn:[a-z\\d-]+:rekognition:[a-z\\d-]+:\\d{12}:streamprocessor\\/.+$)" - }, - "StreamProcessorInput":{ - "type":"structure", - "members":{ - "KinesisVideoStream":{ - "shape":"KinesisVideoStream", - "documentation":"

The Kinesis video stream input stream for the source streaming video.

" - } - }, - "documentation":"

Information about the source streaming video.

" - }, - "StreamProcessorList":{ - "type":"list", - "member":{"shape":"StreamProcessor"} - }, - "StreamProcessorName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_.\\-]+" - }, - "StreamProcessorOutput":{ - "type":"structure", - "members":{ - "KinesisDataStream":{ - "shape":"KinesisDataStream", - "documentation":"

The Amazon Kinesis Data Streams stream to which the Amazon Rekognition stream processor streams the analysis results.

" - } - }, - "documentation":"

Information about the Amazon Kinesis Data Streams stream to which a Amazon Rekognition Video stream processor streams the results of a video analysis. For more information, see CreateStreamProcessor in the Amazon Rekognition Developer Guide.

" - }, - "StreamProcessorSettings":{ - "type":"structure", - "members":{ - "FaceSearch":{ - "shape":"FaceSearchSettings", - "documentation":"

Face search settings to use on a streaming video.

" - } - }, - "documentation":"

Input parameters used to recognize faces in a streaming video analyzed by a Amazon Rekognition stream processor.

" - }, - "StreamProcessorStatus":{ - "type":"string", - "enum":[ - "STOPPED", - "STARTING", - "RUNNING", - "FAILED", - "STOPPING" - ] - }, - "String":{"type":"string"}, - "Sunglasses":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Boolean", - "documentation":"

Boolean value that indicates whether the face is wearing sunglasses or not.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

Level of confidence in the determination.

" - } - }, - "documentation":"

Indicates whether or not the face is wearing sunglasses, and the confidence level in the determination.

" - }, - "TextDetection":{ - "type":"structure", - "members":{ - "DetectedText":{ - "shape":"String", - "documentation":"

The word or line of text recognized by Amazon Rekognition.

" - }, - "Type":{ - "shape":"TextTypes", - "documentation":"

The type of text that was detected.

" - }, - "Id":{ - "shape":"UInteger", - "documentation":"

The identifier for the detected text. The identifier is only unique for a single call to DetectText.

" - }, - "ParentId":{ - "shape":"UInteger", - "documentation":"

The Parent identifier for the detected text identified by the value of ID. If the type of detected text is LINE, the value of ParentId is Null.

" - }, - "Confidence":{ - "shape":"Percent", - "documentation":"

The confidence that Amazon Rekognition has in the accuracy of the detected text and the accuracy of the geometry points around the detected text.

" - }, - "Geometry":{ - "shape":"Geometry", - "documentation":"

The location of the detected text on the image. Includes an axis aligned coarse bounding box surrounding the text and a finer grain polygon for more accurate spatial information.

" - } - }, - "documentation":"

Information about a word or line of text detected by .

The DetectedText field contains the text that Amazon Rekognition detected in the image.

Every word and line has an identifier (Id). Each word belongs to a line and has a parent identifier (ParentId) that identifies the line of text in which the word appears. The word Id is also an index for the word within a line of words.

For more information, see Detecting Text in the Amazon Rekognition Developer Guide.

" - }, - "TextDetectionList":{ - "type":"list", - "member":{"shape":"TextDetection"} - }, - "TextTypes":{ - "type":"string", - "enum":[ - "LINE", - "WORD" - ] - }, - "ThrottlingException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Amazon Rekognition is temporarily unable to process the request. Try your call again.

", - "exception":true, - "fault":true - }, - "Timestamp":{"type":"long"}, - "UInteger":{ - "type":"integer", - "min":0 - }, - "ULong":{ - "type":"long", - "min":0 - }, - "Url":{"type":"string"}, - "Urls":{ - "type":"list", - "member":{"shape":"Url"} - }, - "Video":{ - "type":"structure", - "members":{ - "S3Object":{ - "shape":"S3Object", - "documentation":"

The Amazon S3 bucket name and file name for the video.

" - } - }, - "documentation":"

Video file stored in an Amazon S3 bucket. Amazon Rekognition video start operations such as use Video to specify a video for analysis. The supported file formats are .mp4, .mov and .avi.

" - }, - "VideoJobStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "SUCCEEDED", - "FAILED" - ] - }, - "VideoMetadata":{ - "type":"structure", - "members":{ - "Codec":{ - "shape":"String", - "documentation":"

Type of compression used in the analyzed video.

" - }, - "DurationMillis":{ - "shape":"ULong", - "documentation":"

Length of the video in milliseconds.

" - }, - "Format":{ - "shape":"String", - "documentation":"

Format of the analyzed video. Possible values are MP4, MOV and AVI.

" - }, - "FrameRate":{ - "shape":"Float", - "documentation":"

Number of frames per second in the video.

" - }, - "FrameHeight":{ - "shape":"ULong", - "documentation":"

Vertical pixel dimension of the video.

" - }, - "FrameWidth":{ - "shape":"ULong", - "documentation":"

Horizontal pixel dimension of the video.

" - } - }, - "documentation":"

Information about a video that Amazon Rekognition analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition video operation.

" - }, - "VideoTooLargeException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The file size or duration of the supplied media is too large. The maximum file size is 8GB. The maximum duration is 2 hours.

", - "exception":true - } - }, - "documentation":"

This is the Amazon Rekognition API reference.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/paginators-1.json deleted file mode 100644 index a0ddf9b4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/paginators-1.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "pagination": { - "ListGroups": { - "result_key": "Groups", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "SearchResources": { - "result_key": "ResourceIdentifiers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListGroupResources": { - "result_key": "ResourceIdentifiers", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/service-2.json deleted file mode 100644 index 7551439c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resource-groups/2017-11-27/service-2.json +++ /dev/null @@ -1,827 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-11-27", - "endpointPrefix":"resource-groups", - "protocol":"rest-json", - "serviceAbbreviation":"Resource Groups", - "serviceFullName":"AWS Resource Groups", - "serviceId":"Resource Groups", - "signatureVersion":"v4", - "signingName":"resource-groups", - "uid":"resource-groups-2017-11-27" - }, - "operations":{ - "CreateGroup":{ - "name":"CreateGroup", - "http":{ - "method":"POST", - "requestUri":"/groups" - }, - "input":{"shape":"CreateGroupInput"}, - "output":{"shape":"CreateGroupOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Creates a group with a specified name, description, and resource query.

" - }, - "DeleteGroup":{ - "name":"DeleteGroup", - "http":{ - "method":"DELETE", - "requestUri":"/groups/{GroupName}" - }, - "input":{"shape":"DeleteGroupInput"}, - "output":{"shape":"DeleteGroupOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Deletes a specified resource group. Deleting a resource group does not delete resources that are members of the group; it only deletes the group structure.

" - }, - "GetGroup":{ - "name":"GetGroup", - "http":{ - "method":"GET", - "requestUri":"/groups/{GroupName}" - }, - "input":{"shape":"GetGroupInput"}, - "output":{"shape":"GetGroupOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns information about a specified resource group.

" - }, - "GetGroupQuery":{ - "name":"GetGroupQuery", - "http":{ - "method":"GET", - "requestUri":"/groups/{GroupName}/query" - }, - "input":{"shape":"GetGroupQueryInput"}, - "output":{"shape":"GetGroupQueryOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns the resource query associated with the specified resource group.

" - }, - "GetTags":{ - "name":"GetTags", - "http":{ - "method":"GET", - "requestUri":"/resources/{Arn}/tags" - }, - "input":{"shape":"GetTagsInput"}, - "output":{"shape":"GetTagsOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns a list of tags that are associated with a resource, specified by an ARN.

" - }, - "ListGroupResources":{ - "name":"ListGroupResources", - "http":{ - "method":"POST", - "requestUri":"/groups/{GroupName}/resource-identifiers-list" - }, - "input":{"shape":"ListGroupResourcesInput"}, - "output":{"shape":"ListGroupResourcesOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns a list of ARNs of resources that are members of a specified resource group.

" - }, - "ListGroups":{ - "name":"ListGroups", - "http":{ - "method":"POST", - "requestUri":"/groups-list" - }, - "input":{"shape":"ListGroupsInput"}, - "output":{"shape":"ListGroupsOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns a list of existing resource groups in your account.

" - }, - "SearchResources":{ - "name":"SearchResources", - "http":{ - "method":"POST", - "requestUri":"/resources/search" - }, - "input":{"shape":"SearchResourcesInput"}, - "output":{"shape":"SearchResourcesOutput"}, - "errors":[ - {"shape":"UnauthorizedException"}, - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Returns a list of AWS resource identifiers that matches a specified query. The query uses the same format as a resource query in a CreateGroup or UpdateGroupQuery operation.

" - }, - "Tag":{ - "name":"Tag", - "http":{ - "method":"PUT", - "requestUri":"/resources/{Arn}/tags" - }, - "input":{"shape":"TagInput"}, - "output":{"shape":"TagOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if they are not specified in the request parameters.

" - }, - "Untag":{ - "name":"Untag", - "http":{ - "method":"PATCH", - "requestUri":"/resources/{Arn}/tags" - }, - "input":{"shape":"UntagInput"}, - "output":{"shape":"UntagOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Deletes specified tags from a specified resource.

" - }, - "UpdateGroup":{ - "name":"UpdateGroup", - "http":{ - "method":"PUT", - "requestUri":"/groups/{GroupName}" - }, - "input":{"shape":"UpdateGroupInput"}, - "output":{"shape":"UpdateGroupOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Updates an existing group with a new or changed description. You cannot update the name of a resource group.

" - }, - "UpdateGroupQuery":{ - "name":"UpdateGroupQuery", - "http":{ - "method":"PUT", - "requestUri":"/groups/{GroupName}/query" - }, - "input":{"shape":"UpdateGroupQueryInput"}, - "output":{"shape":"UpdateGroupQueryOutput"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"ForbiddenException"}, - {"shape":"NotFoundException"}, - {"shape":"MethodNotAllowedException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"InternalServerErrorException"} - ], - "documentation":"

Updates the resource query of a group.

" - } - }, - "shapes":{ - "BadRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request does not comply with validation rules that are defined for the request parameters.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "CreateGroupInput":{ - "type":"structure", - "required":[ - "Name", - "ResourceQuery" - ], - "members":{ - "Name":{ - "shape":"GroupName", - "documentation":"

The name of the group, which is the identifier of the group in other operations. A resource group name cannot be updated after it is created. A resource group name can have a maximum of 128 characters, including letters, numbers, hyphens, dots, and underscores. The name cannot start with AWS or aws; these are reserved. A resource group name must be unique within your account.

" - }, - "Description":{ - "shape":"GroupDescription", - "documentation":"

The description of the resource group. Descriptions can have a maximum of 511 characters, including letters, numbers, hyphens, underscores, punctuation, and spaces.

" - }, - "ResourceQuery":{ - "shape":"ResourceQuery", - "documentation":"

The resource query that determines which AWS resources are members of this group.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags to add to the group. A tag is a string-to-string map of key-value pairs. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

" - } - } - }, - "CreateGroupOutput":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

A full description of the resource group after it is created.

" - }, - "ResourceQuery":{ - "shape":"ResourceQuery", - "documentation":"

The resource query associated with the group.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags associated with the group.

" - } - } - }, - "DeleteGroupInput":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group to delete.

", - "location":"uri", - "locationName":"GroupName" - } - } - }, - "DeleteGroupOutput":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

A full description of the deleted resource group.

" - } - } - }, - "ErrorMessage":{ - "type":"string", - "max":1024, - "min":1 - }, - "ForbiddenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The caller is not authorized to make the request.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "GetGroupInput":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group.

", - "location":"uri", - "locationName":"GroupName" - } - } - }, - "GetGroupOutput":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

A full description of the resource group.

" - } - } - }, - "GetGroupQueryInput":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group.

", - "location":"uri", - "locationName":"GroupName" - } - } - }, - "GetGroupQueryOutput":{ - "type":"structure", - "members":{ - "GroupQuery":{ - "shape":"GroupQuery", - "documentation":"

The resource query associated with the specified group.

" - } - } - }, - "GetTagsInput":{ - "type":"structure", - "required":["Arn"], - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the resource for which you want a list of tags. The resource must exist within the account you are using.

", - "location":"uri", - "locationName":"Arn" - } - } - }, - "GetTagsOutput":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the tagged resource.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags associated with the specified resource.

" - } - } - }, - "Group":{ - "type":"structure", - "required":[ - "GroupArn", - "Name" - ], - "members":{ - "GroupArn":{ - "shape":"GroupArn", - "documentation":"

The ARN of a resource group.

" - }, - "Name":{ - "shape":"GroupName", - "documentation":"

The name of a resource group.

" - }, - "Description":{ - "shape":"GroupDescription", - "documentation":"

The description of the resource group.

" - } - }, - "documentation":"

A resource group.

" - }, - "GroupArn":{ - "type":"string", - "pattern":"arn:aws:resource-groups:[a-z]{2}-[a-z]+-\\d{1}:[0-9]{12}:group/[a-zA-Z0-9_\\.-]{1,128}" - }, - "GroupDescription":{ - "type":"string", - "max":512, - "pattern":"[\\sa-zA-Z0-9_\\.-]*" - }, - "GroupList":{ - "type":"list", - "member":{"shape":"Group"} - }, - "GroupName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9_\\.-]+" - }, - "GroupQuery":{ - "type":"structure", - "required":[ - "GroupName", - "ResourceQuery" - ], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of a resource group that is associated with a specific resource query.

" - }, - "ResourceQuery":{ - "shape":"ResourceQuery", - "documentation":"

The resource query which determines which AWS resources are members of the associated resource group.

" - } - }, - "documentation":"

The underlying resource query of a resource group. Resources that match query results are part of the group.

" - }, - "InternalServerErrorException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An internal error occurred while processing the request.

", - "error":{"httpStatusCode":500}, - "exception":true - }, - "ListGroupResourcesInput":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group.

", - "location":"uri", - "locationName":"GroupName" - }, - "Filters":{ - "shape":"ResourceFilterList", - "documentation":"

Filters, formatted as ResourceFilter objects, that you want to apply to a ListGroupResources operation.

  • resource-type - Filter resources by their type. Specify up to five resource types in the format AWS::ServiceCode::ResourceType. For example, AWS::EC2::Instance, or AWS::S3::Bucket.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of group member ARNs that are returned in a single call by ListGroupResources, in paginated output. By default, this number is 50.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that is returned in a paginated ListGroupResources request. To get the next page of results, run the call again, add the NextToken parameter, and specify the NextToken value.

", - "location":"querystring", - "locationName":"nextToken" - } - } - }, - "ListGroupResourcesOutput":{ - "type":"structure", - "members":{ - "ResourceIdentifiers":{ - "shape":"ResourceIdentifierList", - "documentation":"

The ARNs and resource types of resources that are members of the group that you specified.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value to include in a subsequent ListGroupResources request, to get more results.

" - } - } - }, - "ListGroupsInput":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of resource group results that are returned by ListGroups in paginated output. By default, this number is 50.

", - "location":"querystring", - "locationName":"maxResults" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that is returned in a paginated ListGroups request. To get the next page of results, run the call again, add the NextToken parameter, and specify the NextToken value.

", - "location":"querystring", - "locationName":"nextToken" - } - } - }, - "ListGroupsOutput":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupList", - "documentation":"

A list of resource groups.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value to include in a subsequent ListGroups request, to get more results.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":50, - "min":1 - }, - "MethodNotAllowedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request uses an HTTP method which is not allowed for the specified resource.

", - "error":{"httpStatusCode":405}, - "exception":true - }, - "NextToken":{"type":"string"}, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

One or more resources specified in the request do not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Query":{ - "type":"string", - "max":2048 - }, - "QueryType":{ - "type":"string", - "enum":["TAG_FILTERS_1_0"] - }, - "ResourceArn":{ - "type":"string", - "pattern":"arn:aws:[a-z0-9\\-]*:([a-z]{2}-[a-z]+-\\d{1})?:([0-9]{12})?:.+" - }, - "ResourceFilter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"ResourceFilterName", - "documentation":"

The name of the filter. Filter names are case-sensitive.

" - }, - "Values":{ - "shape":"ResourceFilterValues", - "documentation":"

One or more filter values. Allowed filter values vary by resource filter name, and are case-sensitive.

" - } - }, - "documentation":"

A filter name and value pair that is used to obtain more specific results from a list of resources.

" - }, - "ResourceFilterList":{ - "type":"list", - "member":{"shape":"ResourceFilter"} - }, - "ResourceFilterName":{ - "type":"string", - "enum":["resource-type"] - }, - "ResourceFilterValue":{ - "type":"string", - "max":128, - "min":1, - "pattern":"AWS::[a-zA-Z0-9]+::[a-zA-Z0-9]+" - }, - "ResourceFilterValues":{ - "type":"list", - "member":{"shape":"ResourceFilterValue"}, - "max":5, - "min":1 - }, - "ResourceIdentifier":{ - "type":"structure", - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN of a resource.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type of a resource, such as AWS::EC2::Instance.

" - } - }, - "documentation":"

The ARN of a resource, and its resource type.

" - }, - "ResourceIdentifierList":{ - "type":"list", - "member":{"shape":"ResourceIdentifier"} - }, - "ResourceQuery":{ - "type":"structure", - "required":[ - "Type", - "Query" - ], - "members":{ - "Type":{ - "shape":"QueryType", - "documentation":"

The type of the query. The valid value in this release is TAG_FILTERS_1_0.

TAG_FILTERS_1_0: A JSON syntax that lets you specify a collection of simple tag filters for resource types and tags, as supported by the AWS Tagging API GetResources operation. When more than one element is present, only resources that match all filters are part of the result. If a filter specifies more than one value for a key, a resource matches the filter if its tag value matches any of the specified values.

" - }, - "Query":{ - "shape":"Query", - "documentation":"

The query that defines a group or a search.

" - } - }, - "documentation":"

The query that is used to define a resource group or a search for resources.

" - }, - "ResourceType":{ - "type":"string", - "pattern":"AWS::[a-zA-Z0-9]+::\\w+" - }, - "SearchResourcesInput":{ - "type":"structure", - "required":["ResourceQuery"], - "members":{ - "ResourceQuery":{ - "shape":"ResourceQuery", - "documentation":"

The search query, using the same formats that are supported for resource group definition.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of group member ARNs returned by SearchResources in paginated output. By default, this number is 50.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value that is returned in a paginated SearchResources request. To get the next page of results, run the call again, add the NextToken parameter, and specify the NextToken value.

" - } - } - }, - "SearchResourcesOutput":{ - "type":"structure", - "members":{ - "ResourceIdentifiers":{ - "shape":"ResourceIdentifierList", - "documentation":"

The ARNs and resource types of resources that are members of the group that you specified.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The NextToken value to include in a subsequent SearchResources request, to get more results.

" - } - } - }, - "TagInput":{ - "type":"structure", - "required":[ - "Arn", - "Tags" - ], - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the resource to which to add tags.

", - "location":"uri", - "locationName":"Arn" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags to add to the specified resource. A tag is a string-to-string map of key-value pairs. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

" - } - } - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagOutput":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the tagged resource.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags that have been added to the specified resource.

" - } - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"} - }, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The caller has exceeded throttling limits.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UnauthorizedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request has not been applied because it lacks valid authentication credentials for the target resource.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "UntagInput":{ - "type":"structure", - "required":[ - "Arn", - "Keys" - ], - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the resource from which to remove tags.

", - "location":"uri", - "locationName":"Arn" - }, - "Keys":{ - "shape":"TagKeyList", - "documentation":"

The keys of the tags to be removed.

" - } - } - }, - "UntagOutput":{ - "type":"structure", - "members":{ - "Arn":{ - "shape":"GroupArn", - "documentation":"

The ARN of the resource from which tags have been removed.

" - }, - "Keys":{ - "shape":"TagKeyList", - "documentation":"

The keys of tags that have been removed.

" - } - } - }, - "UpdateGroupInput":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group for which you want to update its description.

", - "location":"uri", - "locationName":"GroupName" - }, - "Description":{ - "shape":"GroupDescription", - "documentation":"

The description of the resource group. Descriptions can have a maximum of 511 characters, including letters, numbers, hyphens, underscores, punctuation, and spaces.

" - } - } - }, - "UpdateGroupOutput":{ - "type":"structure", - "members":{ - "Group":{ - "shape":"Group", - "documentation":"

The full description of the resource group after it has been updated.

" - } - } - }, - "UpdateGroupQueryInput":{ - "type":"structure", - "required":[ - "GroupName", - "ResourceQuery" - ], - "members":{ - "GroupName":{ - "shape":"GroupName", - "documentation":"

The name of the resource group for which you want to edit the query.

", - "location":"uri", - "locationName":"GroupName" - }, - "ResourceQuery":{ - "shape":"ResourceQuery", - "documentation":"

The resource query that determines which AWS resources are members of the resource group.

" - } - } - }, - "UpdateGroupQueryOutput":{ - "type":"structure", - "members":{ - "GroupQuery":{ - "shape":"GroupQuery", - "documentation":"

The resource query associated with the resource group after the update.

" - } - } - } - }, - "documentation":"AWS Resource Groups

AWS Resource Groups lets you organize AWS resources such as Amazon EC2 instances, Amazon Relational Database Service databases, and Amazon S3 buckets into groups using criteria that you define as tags. A resource group is a collection of resources that match the resource types specified in a query, and share one or more tags or portions of tags. You can create a group of resources based on their roles in your cloud infrastructure, lifecycle stages, regions, application layers, or virtually any criteria. Resource groups enable you to automate management tasks, such as those in AWS Systems Manager Automation documents, on tag-related resources in AWS Systems Manager. Groups of tagged resources also let you quickly view a custom console in AWS Systems Manager that shows AWS Config compliance and other monitoring data about member resources.

To create a resource group, build a resource query, and specify tags that identify the criteria that members of the group have in common. Tags are key-value pairs.

For more information about Resource Groups, see the AWS Resource Groups User Guide.

AWS Resource Groups uses a REST-compliant API that you can use to perform the following types of operations.

  • Create, Read, Update, and Delete (CRUD) operations on resource groups and resource query entities

  • Applying, editing, and removing tags from resource groups

  • Resolving resource group member ARNs so they can be returned as search results

  • Getting data about resources that are members of a group

  • Searching AWS resources based on a resource query

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/paginators-1.json deleted file mode 100644 index 7c8ba892..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/paginators-1.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "pagination": { - "GetResources": { - "input_token": "PaginationToken", - "limit_key": "ResourcesPerPage", - "output_token": "PaginationToken", - "result_key": "ResourceTagMappingList" - }, - "GetTagKeys": { - "input_token": "PaginationToken", - "output_token": "PaginationToken", - "result_key": "TagKeys" - }, - "GetTagValues": { - "input_token": "PaginationToken", - "output_token": "PaginationToken", - "result_key": "TagValues" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/service-2.json deleted file mode 100644 index 7c0b518a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/resourcegroupstaggingapi/2017-01-26/service-2.json +++ /dev/null @@ -1,430 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-01-26", - "endpointPrefix":"tagging", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Resource Groups Tagging API", - "serviceId":"Resource Groups Tagging API", - "signatureVersion":"v4", - "targetPrefix":"ResourceGroupsTaggingAPI_20170126", - "uid":"resourcegroupstaggingapi-2017-01-26" - }, - "operations":{ - "GetResources":{ - "name":"GetResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetResourcesInput"}, - "output":{"shape":"GetResourcesOutput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalServiceException"}, - {"shape":"PaginationTokenExpiredException"} - ], - "documentation":"

Returns all the tagged resources that are associated with the specified tags (keys and values) located in the specified region for the AWS account. The tags and the resource types that you specify in the request are known as filters. The response includes all tags that are associated with the requested resources. If no filter is provided, this action returns a paginated resource list with the associated tags.

" - }, - "GetTagKeys":{ - "name":"GetTagKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTagKeysInput"}, - "output":{"shape":"GetTagKeysOutput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalServiceException"}, - {"shape":"PaginationTokenExpiredException"} - ], - "documentation":"

Returns all tag keys in the specified region for the AWS account.

" - }, - "GetTagValues":{ - "name":"GetTagValues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTagValuesInput"}, - "output":{"shape":"GetTagValuesOutput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalServiceException"}, - {"shape":"PaginationTokenExpiredException"} - ], - "documentation":"

Returns all tag values for the specified key in the specified region for the AWS account.

" - }, - "TagResources":{ - "name":"TagResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourcesInput"}, - "output":{"shape":"TagResourcesOutput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Applies one or more tags to the specified resources. Note the following:

  • Not all resources can have tags. For a list of resources that support tagging, see Supported Resources in the AWS Resource Groups and Tag Editor User Guide.

  • Each resource can have up to 50 tags. For other limits, see Tag Restrictions in the Amazon EC2 User Guide for Linux Instances.

  • You can only tag resources that are located in the specified region for the AWS account.

  • To add tags to a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for adding tags. For more information, see Obtaining Permissions for Tagging in the AWS Resource Groups and Tag Editor User Guide.

" - }, - "UntagResources":{ - "name":"UntagResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourcesInput"}, - "output":{"shape":"UntagResourcesOutput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalServiceException"} - ], - "documentation":"

Removes the specified tags from the specified resources. When you specify a tag key, the action removes both that key and its associated value. The operation succeeds even if you attempt to remove tags from a resource that were already removed. Note the following:

  • To remove tags from a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for removing tags. For more information, see Obtaining Permissions for Tagging in the AWS Resource Groups and Tag Editor User Guide.

  • You can only tag resources that are located in the specified region for the AWS account.

" - } - }, - "shapes":{ - "AmazonResourceType":{ - "type":"string", - "max":256, - "min":0 - }, - "ErrorCode":{ - "type":"string", - "enum":[ - "InternalServiceException", - "InvalidParameterException" - ] - }, - "ErrorMessage":{"type":"string"}, - "ExceptionMessage":{ - "type":"string", - "max":2048, - "min":0 - }, - "FailedResourcesMap":{ - "type":"map", - "key":{"shape":"ResourceARN"}, - "value":{"shape":"FailureInfo"} - }, - "FailureInfo":{ - "type":"structure", - "members":{ - "StatusCode":{ - "shape":"StatusCode", - "documentation":"

The HTTP status code of the common error.

" - }, - "ErrorCode":{ - "shape":"ErrorCode", - "documentation":"

The code of the common error. Valid values include InternalServiceException, InvalidParameterException, and any valid error code returned by the AWS service that hosts the resource that you want to tag.

" - }, - "ErrorMessage":{ - "shape":"ErrorMessage", - "documentation":"

The message of the common error.

" - } - }, - "documentation":"

Details of the common errors that all actions return.

" - }, - "GetResourcesInput":{ - "type":"structure", - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that additional data is available. Leave this value empty for your initial request. If the response includes a PaginationToken, use that string for this value to request an additional page of data.

" - }, - "TagFilters":{ - "shape":"TagFilterList", - "documentation":"

A list of tags (keys and values). A request can include up to 50 keys, and each key can include up to 20 values.

If you specify multiple filters connected by an AND operator in a single request, the response returns only those resources that are associated with every specified filter.

If you specify multiple filters connected by an OR operator in a single request, the response returns all resources that are associated with at least one or possibly more of the specified filters.

" - }, - "ResourcesPerPage":{ - "shape":"ResourcesPerPage", - "documentation":"

A limit that restricts the number of resources returned by GetResources in paginated output. You can set ResourcesPerPage to a minimum of 1 item and the maximum of 50 items.

" - }, - "TagsPerPage":{ - "shape":"TagsPerPage", - "documentation":"

A limit that restricts the number of tags (key and value pairs) returned by GetResources in paginated output. A resource with no tags is counted as having one tag (one key and value pair).

GetResources does not split a resource and its associated tags across pages. If the specified TagsPerPage would cause such a break, a PaginationToken is returned in place of the affected resource and its tags. Use that token in another request to get the remaining data. For example, if you specify a TagsPerPage of 100 and the account has 22 resources with 10 tags each (meaning that each resource has 10 key and value pairs), the output will consist of 3 pages, with the first page displaying the first 10 resources, each with its 10 tags, the second page displaying the next 10 resources each with its 10 tags, and the third page displaying the remaining 2 resources, each with its 10 tags.

You can set TagsPerPage to a minimum of 100 items and the maximum of 500 items.

" - }, - "ResourceTypeFilters":{ - "shape":"ResourceTypeFilterList", - "documentation":"

The constraints on the resources that you want returned. The format of each resource type is service[:resourceType]. For example, specifying a resource type of ec2 returns all tagged Amazon EC2 resources (which includes tagged EC2 instances). Specifying a resource type of ec2:instance returns only EC2 instances.

The string for each service name and resource type is the same as that embedded in a resource's Amazon Resource Name (ARN). Consult the AWS General Reference for the following:

" - } - } - }, - "GetResourcesOutput":{ - "type":"structure", - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that the response contains more data than can be returned in a single response. To receive additional data, specify this string for the PaginationToken value in a subsequent request.

" - }, - "ResourceTagMappingList":{ - "shape":"ResourceTagMappingList", - "documentation":"

A list of resource ARNs and the tags (keys and values) associated with each.

" - } - } - }, - "GetTagKeysInput":{ - "type":"structure", - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that additional data is available. Leave this value empty for your initial request. If the response includes a PaginationToken, use that string for this value to request an additional page of data.

" - } - } - }, - "GetTagKeysOutput":{ - "type":"structure", - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that the response contains more data than can be returned in a single response. To receive additional data, specify this string for the PaginationToken value in a subsequent request.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

A list of all tag keys in the AWS account.

" - } - } - }, - "GetTagValuesInput":{ - "type":"structure", - "required":["Key"], - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that additional data is available. Leave this value empty for your initial request. If the response includes a PaginationToken, use that string for this value to request an additional page of data.

" - }, - "Key":{ - "shape":"TagKey", - "documentation":"

The key for which you want to list all existing values in the specified region for the AWS account.

" - } - } - }, - "GetTagValuesOutput":{ - "type":"structure", - "members":{ - "PaginationToken":{ - "shape":"PaginationToken", - "documentation":"

A string that indicates that the response contains more data than can be returned in a single response. To receive additional data, specify this string for the PaginationToken value in a subsequent request.

" - }, - "TagValues":{ - "shape":"TagValuesOutputList", - "documentation":"

A list of all tag values for the specified key in the AWS account.

" - } - } - }, - "InternalServiceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The request processing failed because of an unknown error, exception, or failure. You can retry the request.

", - "exception":true, - "fault":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A parameter is missing or a malformed string or invalid or out-of-range value was supplied for the request parameter.

", - "exception":true - }, - "PaginationToken":{ - "type":"string", - "max":2048, - "min":0 - }, - "PaginationTokenExpiredException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

A PaginationToken is valid for a maximum of 15 minutes. Your request was denied because the specified PaginationToken has expired.

", - "exception":true - }, - "ResourceARN":{ - "type":"string", - "max":1600, - "min":1 - }, - "ResourceARNList":{ - "type":"list", - "member":{"shape":"ResourceARN"}, - "max":20, - "min":1 - }, - "ResourceTagMapping":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

An array of resource ARN(s).

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags that have been applied to one or more AWS resources.

" - } - }, - "documentation":"

A list of resource ARNs and the tags (keys and values) that are associated with each.

" - }, - "ResourceTagMappingList":{ - "type":"list", - "member":{"shape":"ResourceTagMapping"} - }, - "ResourceTypeFilterList":{ - "type":"list", - "member":{"shape":"AmazonResourceType"} - }, - "ResourcesPerPage":{"type":"integer"}, - "StatusCode":{"type":"integer"}, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).

" - } - }, - "documentation":"

The metadata that you apply to AWS resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. For more information, see Tag Basics in the Amazon EC2 User Guide for Linux Instances.

" - }, - "TagFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.

" - }, - "Values":{ - "shape":"TagValueList", - "documentation":"

The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).

" - } - }, - "documentation":"

A list of tags (keys and values) that are used to specify the associated resources.

" - }, - "TagFilterList":{ - "type":"list", - "member":{"shape":"TagFilter"}, - "max":50, - "min":0 - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagKeyListForUntag":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagMap":{ - "type":"map", - "key":{"shape":"TagKey"}, - "value":{"shape":"TagValue"}, - "max":50, - "min":1 - }, - "TagResourcesInput":{ - "type":"structure", - "required":[ - "ResourceARNList", - "Tags" - ], - "members":{ - "ResourceARNList":{ - "shape":"ResourceARNList", - "documentation":"

A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to tag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "Tags":{ - "shape":"TagMap", - "documentation":"

The tags that you want to add to the specified resources. A tag consists of a key and a value that you define.

" - } - } - }, - "TagResourcesOutput":{ - "type":"structure", - "members":{ - "FailedResourcesMap":{ - "shape":"FailedResourcesMap", - "documentation":"

Details of resources that could not be tagged. An error code, status code, and error message are returned for each failed item.

" - } - } - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0 - }, - "TagValueList":{ - "type":"list", - "member":{"shape":"TagValue"}, - "max":20, - "min":0 - }, - "TagValuesOutputList":{ - "type":"list", - "member":{"shape":"TagValue"} - }, - "TagsPerPage":{"type":"integer"}, - "ThrottledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The request was denied to limit the frequency of submitted requests.

", - "exception":true - }, - "UntagResourcesInput":{ - "type":"structure", - "required":[ - "ResourceARNList", - "TagKeys" - ], - "members":{ - "ResourceARNList":{ - "shape":"ResourceARNList", - "documentation":"

A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to untag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.

" - }, - "TagKeys":{ - "shape":"TagKeyListForUntag", - "documentation":"

A list of the tag keys that you want to remove from the specified resources.

" - } - } - }, - "UntagResourcesOutput":{ - "type":"structure", - "members":{ - "FailedResourcesMap":{ - "shape":"FailedResourcesMap", - "documentation":"

Details of resources that could not be untagged. An error code, status code, and error message are returned for each failed item.

" - } - } - } - }, - "documentation":"Resource Groups Tagging API

This guide describes the API operations for the resource groups tagging.

A tag is a label that you assign to an AWS resource. A tag consists of a key and a value, both of which you define. For example, if you have two Amazon EC2 instances, you might assign both a tag key of \"Stack.\" But the value of \"Stack\" might be \"Testing\" for one and \"Production\" for the other.

Tagging can help you organize your resources and enables you to simplify resource management, access management and cost allocation. For more information about tagging, see Working with Tag Editor and Working with Resource Groups. For more information about permissions you need to use the resource groups tagging APIs, see Obtaining Permissions for Resource Groups and Obtaining Permissions for Tagging .

You can use the resource groups tagging APIs to complete the following tasks:

  • Tag and untag supported resources located in the specified region for the AWS account

  • Use tag-based filters to search for resources located in the specified region for the AWS account

  • List all existing tag keys in the specified region for the AWS account

  • List all existing values for the specified key in the specified region for the AWS account

Not all resources can have tags. For a lists of resources that you can tag, see Supported Resources in the AWS Resource Groups and Tag Editor User Guide.

To make full use of the resource groups tagging APIs, you might need additional IAM permissions, including permission to access the resources of individual services as well as permission to view and apply tags to those resources. For more information, see Obtaining Permissions for Tagging in the AWS Resource Groups and Tag Editor User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/paginators-1.json deleted file mode 100644 index d472f47a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/paginators-1.json +++ /dev/null @@ -1,33 +0,0 @@ -{ - "pagination": { - "ListHealthChecks": { - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "IsTruncated", - "limit_key": "MaxItems", - "result_key": "HealthChecks" - }, - "ListHostedZones": { - "input_token": "Marker", - "output_token": "NextMarker", - "more_results": "IsTruncated", - "limit_key": "MaxItems", - "result_key": "HostedZones" - }, - "ListResourceRecordSets": { - "more_results": "IsTruncated", - "limit_key": "MaxItems", - "result_key": "ResourceRecordSets", - "input_token": [ - "StartRecordName", - "StartRecordType", - "StartRecordIdentifier" - ], - "output_token": [ - "NextRecordName", - "NextRecordType", - "NextRecordIdentifier" - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/service-2.json deleted file mode 100644 index 030d45dd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/service-2.json +++ /dev/null @@ -1,5064 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-04-01", - "endpointPrefix":"route53", - "globalEndpoint":"route53.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"Route 53", - "serviceFullName":"Amazon Route 53", - "serviceId":"Route 53", - "signatureVersion":"v4", - "uid":"route53-2013-04-01" - }, - "operations":{ - "AssociateVPCWithHostedZone":{ - "name":"AssociateVPCWithHostedZone", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}/associatevpc" - }, - "input":{ - "shape":"AssociateVPCWithHostedZoneRequest", - "locationName":"AssociateVPCWithHostedZoneRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"AssociateVPCWithHostedZoneResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"NotAuthorizedException"}, - {"shape":"InvalidVPCId"}, - {"shape":"InvalidInput"}, - {"shape":"PublicZoneVPCAssociation"}, - {"shape":"ConflictingDomainExists"}, - {"shape":"LimitsExceeded"} - ], - "documentation":"

Associates an Amazon VPC with a private hosted zone.

To perform the association, the VPC and the private hosted zone must already exist. You can't convert a public hosted zone into a private hosted zone.

If you want to associate a VPC that was created by using one AWS account with a private hosted zone that was created by using a different account, the AWS account that created the private hosted zone must first submit a CreateVPCAssociationAuthorization request. Then the account that created the VPC must submit an AssociateVPCWithHostedZone request.

" - }, - "ChangeResourceRecordSets":{ - "name":"ChangeResourceRecordSets", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}/rrset/" - }, - "input":{ - "shape":"ChangeResourceRecordSetsRequest", - "locationName":"ChangeResourceRecordSetsRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"ChangeResourceRecordSetsResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"NoSuchHealthCheck"}, - {"shape":"InvalidChangeBatch"}, - {"shape":"InvalidInput"}, - {"shape":"PriorRequestNotComplete"} - ], - "documentation":"

Creates, changes, or deletes a resource record set, which contains authoritative DNS information for a specified domain name or subdomain name. For example, you can use ChangeResourceRecordSets to create a resource record set that routes traffic for test.example.com to a web server that has an IP address of 192.0.2.44.

Change Batches and Transactional Changes

The request body must include a document with a ChangeResourceRecordSetsRequest element. The request body contains a list of change items, known as a change batch. Change batches are considered transactional changes. When using the Amazon Route 53 API to change resource record sets, Amazon Route 53 either makes all or none of the changes in a change batch request. This ensures that Amazon Route 53 never partially implements the intended changes to the resource record sets in a hosted zone.

For example, a change batch request that deletes the CNAME record for www.example.com and creates an alias resource record set for www.example.com. Amazon Route 53 deletes the first resource record set and creates the second resource record set in a single operation. If either the DELETE or the CREATE action fails, then both changes (plus any other changes in the batch) fail, and the original CNAME record continues to exist.

Due to the nature of transactional changes, you can't delete the same resource record set more than once in a single change batch. If you attempt to delete the same change batch more than once, Amazon Route 53 returns an InvalidChangeBatch error.

Traffic Flow

To create resource record sets for complex routing configurations, use either the traffic flow visual editor in the Amazon Route 53 console or the API actions for traffic policies and traffic policy instances. Save the configuration as a traffic policy, then associate the traffic policy with one or more domain names (such as example.com) or subdomain names (such as www.example.com), in the same hosted zone or in multiple hosted zones. You can roll back the updates if the new configuration isn't performing as expected. For more information, see Using Traffic Flow to Route DNS Traffic in the Amazon Route 53 Developer Guide.

Create, Delete, and Upsert

Use ChangeResourceRecordsSetsRequest to perform the following actions:

  • CREATE: Creates a resource record set that has the specified values.

  • DELETE: Deletes an existing resource record set that has the specified values.

  • UPSERT: If a resource record set does not already exist, AWS creates it. If a resource set does exist, Amazon Route 53 updates it with the values in the request.

Syntaxes for Creating, Updating, and Deleting Resource Record Sets

The syntax for a request depends on the type of resource record set that you want to create, delete, or update, such as weighted, alias, or failover. The XML elements in your request must appear in the order listed in the syntax.

For an example for each type of resource record set, see \"Examples.\"

Don't refer to the syntax in the \"Parameter Syntax\" section, which includes all of the elements for every kind of resource record set that you can create, delete, or update by using ChangeResourceRecordSets.

Change Propagation to Amazon Route 53 DNS Servers

When you submit a ChangeResourceRecordSets request, Amazon Route 53 propagates your changes to all of the Amazon Route 53 authoritative DNS servers. While your changes are propagating, GetChange returns a status of PENDING. When propagation is complete, GetChange returns a status of INSYNC. Changes generally propagate to all Amazon Route 53 name servers within 60 seconds. For more information, see GetChange.

Limits on ChangeResourceRecordSets Requests

For information about the limits on a ChangeResourceRecordSets request, see Limits in the Amazon Route 53 Developer Guide.

" - }, - "ChangeTagsForResource":{ - "name":"ChangeTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/tags/{ResourceType}/{ResourceId}" - }, - "input":{ - "shape":"ChangeTagsForResourceRequest", - "locationName":"ChangeTagsForResourceRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"ChangeTagsForResourceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchHealthCheck"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"PriorRequestNotComplete"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Adds, edits, or deletes tags for a health check or a hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "CreateHealthCheck":{ - "name":"CreateHealthCheck", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/healthcheck", - "responseCode":201 - }, - "input":{ - "shape":"CreateHealthCheckRequest", - "locationName":"CreateHealthCheckRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateHealthCheckResponse"}, - "errors":[ - {"shape":"TooManyHealthChecks"}, - {"shape":"HealthCheckAlreadyExists"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Creates a new health check.

For information about adding health checks to resource record sets, see ResourceRecordSet$HealthCheckId in ChangeResourceRecordSets.

ELB Load Balancers

If you're registering EC2 instances with an Elastic Load Balancing (ELB) load balancer, do not create Amazon Route 53 health checks for the EC2 instances. When you register an EC2 instance with a load balancer, you configure settings for an ELB health check, which performs a similar function to an Amazon Route 53 health check.

Private Hosted Zones

You can associate health checks with failover resource record sets in a private hosted zone. Note the following:

  • Amazon Route 53 health checkers are outside the VPC. To check the health of an endpoint within a VPC by IP address, you must assign a public IP address to the instance in the VPC.

  • You can configure a health checker to check the health of an external resource that the instance relies on, such as a database server.

  • You can create a CloudWatch metric, associate an alarm with the metric, and then create a health check that is based on the state of the alarm. For example, you might create a CloudWatch metric that checks the status of the Amazon EC2 StatusCheckFailed metric, add an alarm to the metric, and then create a health check that is based on the state of the alarm. For information about creating CloudWatch metrics and alarms by using the CloudWatch console, see the Amazon CloudWatch User Guide.

" - }, - "CreateHostedZone":{ - "name":"CreateHostedZone", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone", - "responseCode":201 - }, - "input":{ - "shape":"CreateHostedZoneRequest", - "locationName":"CreateHostedZoneRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateHostedZoneResponse"}, - "errors":[ - {"shape":"InvalidDomainName"}, - {"shape":"HostedZoneAlreadyExists"}, - {"shape":"TooManyHostedZones"}, - {"shape":"InvalidVPCId"}, - {"shape":"InvalidInput"}, - {"shape":"DelegationSetNotAvailable"}, - {"shape":"ConflictingDomainExists"}, - {"shape":"NoSuchDelegationSet"}, - {"shape":"DelegationSetNotReusable"} - ], - "documentation":"

Creates a new public hosted zone, which you use to specify how the Domain Name System (DNS) routes traffic on the Internet for a domain, such as example.com, and its subdomains.

You can't convert a public hosted zones to a private hosted zone or vice versa. Instead, you must create a new hosted zone with the same name and create new resource record sets.

For more information about charges for hosted zones, see Amazon Route 53 Pricing.

Note the following:

  • You can't create a hosted zone for a top-level domain (TLD).

  • Amazon Route 53 automatically creates a default SOA record and four NS records for the zone. For more information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide.

    If you want to use the same name servers for multiple hosted zones, you can optionally associate a reusable delegation set with the hosted zone. See the DelegationSetId element.

  • If your domain is registered with a registrar other than Amazon Route 53, you must update the name servers with your registrar to make Amazon Route 53 your DNS service. For more information, see Configuring Amazon Route 53 as your DNS Service in the Amazon Route 53 Developer Guide.

When you submit a CreateHostedZone request, the initial status of the hosted zone is PENDING. This means that the NS and SOA records are not yet available on all Amazon Route 53 DNS servers. When the NS and SOA records are available, the status of the zone changes to INSYNC.

" - }, - "CreateQueryLoggingConfig":{ - "name":"CreateQueryLoggingConfig", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/queryloggingconfig", - "responseCode":201 - }, - "input":{ - "shape":"CreateQueryLoggingConfigRequest", - "locationName":"CreateQueryLoggingConfigRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateQueryLoggingConfigResponse"}, - "errors":[ - {"shape":"ConcurrentModification"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"NoSuchCloudWatchLogsLogGroup"}, - {"shape":"InvalidInput"}, - {"shape":"QueryLoggingConfigAlreadyExists"}, - {"shape":"InsufficientCloudWatchLogsResourcePolicy"} - ], - "documentation":"

Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group.

DNS query logs contain information about the queries that Amazon Route 53 receives for a specified public hosted zone, such as the following:

  • Amazon Route 53 edge location that responded to the DNS query

  • Domain or subdomain that was requested

  • DNS record type, such as A or AAAA

  • DNS response code, such as NoError or ServFail

Log Group and Resource Policy

Before you create a query logging configuration, perform the following operations.

If you create a query logging configuration using the Amazon Route 53 console, Amazon Route 53 performs these operations automatically.

  1. Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following:

    • You must create the log group in the us-east-1 region.

    • You must use the same AWS account to create the log group and the hosted zone that you want to configure query logging for.

    • When you create log groups for query logging, we recommend that you use a consistent prefix, for example:

      /aws/route53/hosted zone name

      In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated AWS resources, such as Amazon Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging.

  2. Create a CloudWatch Logs resource policy, and give it the permissions that Amazon Route 53 needs to create log streams and to send query logs to log streams. For the value of Resource, specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with *, for example:

    arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*

    You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the AWS SDKs, or the AWS CLI.

Log Streams and Edge Locations

When Amazon Route 53 finishes creating the configuration for DNS query logging, it does the following:

  • Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Amazon Route 53 responds to for that edge location.

  • Begins to send query logs to the applicable log stream.

The name of each log stream is in the following format:

hosted zone ID/edge location code

The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see \"The Amazon Route 53 Global Network\" on the Amazon Route 53 Product Details page.

Queries That Are Logged

Query logs contain only the queries that DNS resolvers forward to Amazon Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Amazon Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see Routing Internet Traffic to Your Website or Web Application in the Amazon Route 53 Developer Guide.

Log File Format

For a list of the values in each query log and the format of each value, see Logging DNS Queries in the Amazon Route 53 Developer Guide.

Pricing

For information about charges for query logs, see Amazon CloudWatch Pricing.

How to Stop Logging

If you want Amazon Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see DeleteQueryLoggingConfig.

" - }, - "CreateReusableDelegationSet":{ - "name":"CreateReusableDelegationSet", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/delegationset", - "responseCode":201 - }, - "input":{ - "shape":"CreateReusableDelegationSetRequest", - "locationName":"CreateReusableDelegationSetRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateReusableDelegationSetResponse"}, - "errors":[ - {"shape":"DelegationSetAlreadyCreated"}, - {"shape":"LimitsExceeded"}, - {"shape":"HostedZoneNotFound"}, - {"shape":"InvalidArgument"}, - {"shape":"InvalidInput"}, - {"shape":"DelegationSetNotAvailable"}, - {"shape":"DelegationSetAlreadyReusable"} - ], - "documentation":"

Creates a delegation set (a group of four name servers) that can be reused by multiple hosted zones. If a hosted zoned ID is specified, CreateReusableDelegationSet marks the delegation set associated with that zone as reusable.

You can't associate a reusable delegation set with a private hosted zone.

For information about using a reusable delegation set to configure white label name servers, see Configuring White Label Name Servers.

The process for migrating existing hosted zones to use a reusable delegation set is comparable to the process for configuring white label name servers. You need to perform the following steps:

  1. Create a reusable delegation set.

  2. Recreate hosted zones, and reduce the TTL to 60 seconds or less.

  3. Recreate resource record sets in the new hosted zones.

  4. Change the registrar's name servers to use the name servers for the new hosted zones.

  5. Monitor traffic for the website or application.

  6. Change TTLs back to their original values.

If you want to migrate existing hosted zones to use a reusable delegation set, the existing hosted zones can't use any of the name servers that are assigned to the reusable delegation set. If one or more hosted zones do use one or more name servers that are assigned to the reusable delegation set, you can do one of the following:

  • For small numbers of hosted zones—up to a few hundred—it's relatively easy to create reusable delegation sets until you get one that has four name servers that don't overlap with any of the name servers in your hosted zones.

  • For larger numbers of hosted zones, the easiest solution is to use more than one reusable delegation set.

  • For larger numbers of hosted zones, you can also migrate hosted zones that have overlapping name servers to hosted zones that don't have overlapping name servers, then migrate the hosted zones again to use the reusable delegation set.

" - }, - "CreateTrafficPolicy":{ - "name":"CreateTrafficPolicy", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/trafficpolicy", - "responseCode":201 - }, - "input":{ - "shape":"CreateTrafficPolicyRequest", - "locationName":"CreateTrafficPolicyRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateTrafficPolicyResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"TooManyTrafficPolicies"}, - {"shape":"TrafficPolicyAlreadyExists"}, - {"shape":"InvalidTrafficPolicyDocument"} - ], - "documentation":"

Creates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com).

" - }, - "CreateTrafficPolicyInstance":{ - "name":"CreateTrafficPolicyInstance", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/trafficpolicyinstance", - "responseCode":201 - }, - "input":{ - "shape":"CreateTrafficPolicyInstanceRequest", - "locationName":"CreateTrafficPolicyInstanceRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateTrafficPolicyInstanceResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"}, - {"shape":"TooManyTrafficPolicyInstances"}, - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"TrafficPolicyInstanceAlreadyExists"} - ], - "documentation":"

Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. In addition, CreateTrafficPolicyInstance associates the resource record sets with a specified domain name (such as example.com) or subdomain name (such as www.example.com). Amazon Route 53 responds to DNS queries for the domain or subdomain name by using the resource record sets that CreateTrafficPolicyInstance created.

" - }, - "CreateTrafficPolicyVersion":{ - "name":"CreateTrafficPolicyVersion", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/trafficpolicy/{Id}", - "responseCode":201 - }, - "input":{ - "shape":"CreateTrafficPolicyVersionRequest", - "locationName":"CreateTrafficPolicyVersionRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateTrafficPolicyVersionResponse"}, - "errors":[ - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"InvalidInput"}, - {"shape":"TooManyTrafficPolicyVersionsForCurrentPolicy"}, - {"shape":"ConcurrentModification"}, - {"shape":"InvalidTrafficPolicyDocument"} - ], - "documentation":"

Creates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic policy.

" - }, - "CreateVPCAssociationAuthorization":{ - "name":"CreateVPCAssociationAuthorization", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}/authorizevpcassociation" - }, - "input":{ - "shape":"CreateVPCAssociationAuthorizationRequest", - "locationName":"CreateVPCAssociationAuthorizationRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"CreateVPCAssociationAuthorizationResponse"}, - "errors":[ - {"shape":"ConcurrentModification"}, - {"shape":"TooManyVPCAssociationAuthorizations"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidVPCId"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Authorizes the AWS account that created a specified VPC to submit an AssociateVPCWithHostedZone request to associate the VPC with a specified hosted zone that was created by a different account. To submit a CreateVPCAssociationAuthorization request, you must use the account that created the hosted zone. After you authorize the association, use the account that created the VPC to submit an AssociateVPCWithHostedZone request.

If you want to associate multiple VPCs that you created by using one account with a hosted zone that you created by using a different account, you must submit one authorization request for each VPC.

" - }, - "DeleteHealthCheck":{ - "name":"DeleteHealthCheck", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/healthcheck/{HealthCheckId}" - }, - "input":{"shape":"DeleteHealthCheckRequest"}, - "output":{"shape":"DeleteHealthCheckResponse"}, - "errors":[ - {"shape":"NoSuchHealthCheck"}, - {"shape":"HealthCheckInUse"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Deletes a health check.

Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one or more resource record sets. If you delete a health check and you don't update the associated resource record sets, the future status of the health check can't be predicted and may change. This will affect the routing of DNS queries for your DNS failover configuration. For more information, see Replacing and Deleting Health Checks in the Amazon Route 53 Developer Guide.

" - }, - "DeleteHostedZone":{ - "name":"DeleteHostedZone", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/hostedzone/{Id}" - }, - "input":{"shape":"DeleteHostedZoneRequest"}, - "output":{"shape":"DeleteHostedZoneResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"HostedZoneNotEmpty"}, - {"shape":"PriorRequestNotComplete"}, - {"shape":"InvalidInput"}, - {"shape":"InvalidDomainName"} - ], - "documentation":"

Deletes a hosted zone.

If the name servers for the hosted zone are associated with a domain and if you want to make the domain unavailable on the Internet, we recommend that you delete the name servers from the domain to prevent future DNS queries from possibly being misrouted. If the domain is registered with Amazon Route 53, see UpdateDomainNameservers. If the domain is registered with another registrar, use the method provided by the registrar to delete name servers for the domain.

Some domain registries don't allow you to remove all of the name servers for a domain. If the registry for your domain requires one or more name servers, we recommend that you delete the hosted zone only if you transfer DNS service to another service provider, and you replace the name servers for the domain with name servers from the new provider.

You can delete a hosted zone only if it contains only the default SOA record and NS resource record sets. If the hosted zone contains other resource record sets, you must delete them before you can delete the hosted zone. If you try to delete a hosted zone that contains other resource record sets, the request fails, and Amazon Route 53 returns a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.

To verify that the hosted zone has been deleted, do one of the following:

  • Use the GetHostedZone action to request information about the hosted zone.

  • Use the ListHostedZones action to get a list of the hosted zones associated with the current AWS account.

" - }, - "DeleteQueryLoggingConfig":{ - "name":"DeleteQueryLoggingConfig", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/queryloggingconfig/{Id}" - }, - "input":{"shape":"DeleteQueryLoggingConfigRequest"}, - "output":{"shape":"DeleteQueryLoggingConfigResponse"}, - "errors":[ - {"shape":"ConcurrentModification"}, - {"shape":"NoSuchQueryLoggingConfig"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Deletes a configuration for DNS query logging. If you delete a configuration, Amazon Route 53 stops sending query logs to CloudWatch Logs. Amazon Route 53 doesn't delete any logs that are already in CloudWatch Logs.

For more information about DNS query logs, see CreateQueryLoggingConfig.

" - }, - "DeleteReusableDelegationSet":{ - "name":"DeleteReusableDelegationSet", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/delegationset/{Id}" - }, - "input":{"shape":"DeleteReusableDelegationSetRequest"}, - "output":{"shape":"DeleteReusableDelegationSetResponse"}, - "errors":[ - {"shape":"NoSuchDelegationSet"}, - {"shape":"DelegationSetInUse"}, - {"shape":"DelegationSetNotReusable"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Deletes a reusable delegation set.

You can delete a reusable delegation set only if it isn't associated with any hosted zones.

To verify that the reusable delegation set is not associated with any hosted zones, submit a GetReusableDelegationSet request and specify the ID of the reusable delegation set that you want to delete.

" - }, - "DeleteTrafficPolicy":{ - "name":"DeleteTrafficPolicy", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/trafficpolicy/{Id}/{Version}" - }, - "input":{"shape":"DeleteTrafficPolicyRequest"}, - "output":{"shape":"DeleteTrafficPolicyResponse"}, - "errors":[ - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"InvalidInput"}, - {"shape":"TrafficPolicyInUse"}, - {"shape":"ConcurrentModification"} - ], - "documentation":"

Deletes a traffic policy.

" - }, - "DeleteTrafficPolicyInstance":{ - "name":"DeleteTrafficPolicyInstance", - "http":{ - "method":"DELETE", - "requestUri":"/2013-04-01/trafficpolicyinstance/{Id}" - }, - "input":{"shape":"DeleteTrafficPolicyInstanceRequest"}, - "output":{"shape":"DeleteTrafficPolicyInstanceResponse"}, - "errors":[ - {"shape":"NoSuchTrafficPolicyInstance"}, - {"shape":"InvalidInput"}, - {"shape":"PriorRequestNotComplete"} - ], - "documentation":"

Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.

In the Amazon Route 53 console, traffic policy instances are known as policy records.

" - }, - "DeleteVPCAssociationAuthorization":{ - "name":"DeleteVPCAssociationAuthorization", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}/deauthorizevpcassociation" - }, - "input":{ - "shape":"DeleteVPCAssociationAuthorizationRequest", - "locationName":"DeleteVPCAssociationAuthorizationRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"DeleteVPCAssociationAuthorizationResponse"}, - "errors":[ - {"shape":"ConcurrentModification"}, - {"shape":"VPCAssociationAuthorizationNotFound"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidVPCId"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Removes authorization to submit an AssociateVPCWithHostedZone request to associate a specified VPC with a hosted zone that was created by a different account. You must use the account that created the hosted zone to submit a DeleteVPCAssociationAuthorization request.

Sending this request only prevents the AWS account that created the VPC from associating the VPC with the Amazon Route 53 hosted zone in the future. If the VPC is already associated with the hosted zone, DeleteVPCAssociationAuthorization won't disassociate the VPC from the hosted zone. If you want to delete an existing association, use DisassociateVPCFromHostedZone.

" - }, - "DisassociateVPCFromHostedZone":{ - "name":"DisassociateVPCFromHostedZone", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}/disassociatevpc" - }, - "input":{ - "shape":"DisassociateVPCFromHostedZoneRequest", - "locationName":"DisassociateVPCFromHostedZoneRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"DisassociateVPCFromHostedZoneResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidVPCId"}, - {"shape":"VPCAssociationNotFound"}, - {"shape":"LastVPCAssociation"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Disassociates a VPC from a Amazon Route 53 private hosted zone.

You can't disassociate the last VPC from a private hosted zone.

You can't disassociate a VPC from a private hosted zone when only one VPC is associated with the hosted zone. You also can't convert a private hosted zone into a public hosted zone.

" - }, - "GetAccountLimit":{ - "name":"GetAccountLimit", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/accountlimit/{Type}" - }, - "input":{"shape":"GetAccountLimitRequest"}, - "output":{"shape":"GetAccountLimitResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Gets the specified limit for the current account, for example, the maximum number of health checks that you can create using the account.

For the default limit, see Limits in the Amazon Route 53 Developer Guide. To request a higher limit, open a case.

" - }, - "GetChange":{ - "name":"GetChange", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/change/{Id}" - }, - "input":{"shape":"GetChangeRequest"}, - "output":{"shape":"GetChangeResponse"}, - "errors":[ - {"shape":"NoSuchChange"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Returns the current status of a change batch request. The status is one of the following values:

  • PENDING indicates that the changes in this request have not propagated to all Amazon Route 53 DNS servers. This is the initial status of all change batch requests.

  • INSYNC indicates that the changes have propagated to all Amazon Route 53 DNS servers.

" - }, - "GetCheckerIpRanges":{ - "name":"GetCheckerIpRanges", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/checkeripranges" - }, - "input":{"shape":"GetCheckerIpRangesRequest"}, - "output":{"shape":"GetCheckerIpRangesResponse"}, - "documentation":"

GetCheckerIpRanges still works, but we recommend that you download ip-ranges.json, which includes IP address ranges for all AWS services. For more information, see IP Address Ranges of Amazon Route 53 Servers in the Amazon Route 53 Developer Guide.

" - }, - "GetGeoLocation":{ - "name":"GetGeoLocation", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/geolocation" - }, - "input":{"shape":"GetGeoLocationRequest"}, - "output":{"shape":"GetGeoLocationResponse"}, - "errors":[ - {"shape":"NoSuchGeoLocation"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about whether a specified geographic location is supported for Amazon Route 53 geolocation resource record sets.

Use the following syntax to determine whether a continent is supported for geolocation:

GET /2013-04-01/geolocation?ContinentCode=two-letter abbreviation for a continent

Use the following syntax to determine whether a country is supported for geolocation:

GET /2013-04-01/geolocation?CountryCode=two-character country code

Use the following syntax to determine whether a subdivision of a country is supported for geolocation:

GET /2013-04-01/geolocation?CountryCode=two-character country code&SubdivisionCode=subdivision code

" - }, - "GetHealthCheck":{ - "name":"GetHealthCheck", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/healthcheck/{HealthCheckId}" - }, - "input":{"shape":"GetHealthCheckRequest"}, - "output":{"shape":"GetHealthCheckResponse"}, - "errors":[ - {"shape":"NoSuchHealthCheck"}, - {"shape":"InvalidInput"}, - {"shape":"IncompatibleVersion"} - ], - "documentation":"

Gets information about a specified health check.

" - }, - "GetHealthCheckCount":{ - "name":"GetHealthCheckCount", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/healthcheckcount" - }, - "input":{"shape":"GetHealthCheckCountRequest"}, - "output":{"shape":"GetHealthCheckCountResponse"}, - "documentation":"

Retrieves the number of health checks that are associated with the current AWS account.

" - }, - "GetHealthCheckLastFailureReason":{ - "name":"GetHealthCheckLastFailureReason", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/healthcheck/{HealthCheckId}/lastfailurereason" - }, - "input":{"shape":"GetHealthCheckLastFailureReasonRequest"}, - "output":{"shape":"GetHealthCheckLastFailureReasonResponse"}, - "errors":[ - {"shape":"NoSuchHealthCheck"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets the reason that a specified health check failed most recently.

" - }, - "GetHealthCheckStatus":{ - "name":"GetHealthCheckStatus", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/healthcheck/{HealthCheckId}/status" - }, - "input":{"shape":"GetHealthCheckStatusRequest"}, - "output":{"shape":"GetHealthCheckStatusResponse"}, - "errors":[ - {"shape":"NoSuchHealthCheck"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets status of a specified health check.

" - }, - "GetHostedZone":{ - "name":"GetHostedZone", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzone/{Id}" - }, - "input":{"shape":"GetHostedZoneRequest"}, - "output":{"shape":"GetHostedZoneResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about a specified hosted zone including the four name servers assigned to the hosted zone.

" - }, - "GetHostedZoneCount":{ - "name":"GetHostedZoneCount", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzonecount" - }, - "input":{"shape":"GetHostedZoneCountRequest"}, - "output":{"shape":"GetHostedZoneCountResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Retrieves the number of hosted zones that are associated with the current AWS account.

" - }, - "GetHostedZoneLimit":{ - "name":"GetHostedZoneLimit", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzonelimit/{Id}/{Type}" - }, - "input":{"shape":"GetHostedZoneLimitRequest"}, - "output":{"shape":"GetHostedZoneLimitResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"}, - {"shape":"HostedZoneNotPrivate"} - ], - "documentation":"

Gets the specified limit for a specified hosted zone, for example, the maximum number of records that you can create in the hosted zone.

For the default limit, see Limits in the Amazon Route 53 Developer Guide. To request a higher limit, open a case.

" - }, - "GetQueryLoggingConfig":{ - "name":"GetQueryLoggingConfig", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/queryloggingconfig/{Id}" - }, - "input":{"shape":"GetQueryLoggingConfigRequest"}, - "output":{"shape":"GetQueryLoggingConfigResponse"}, - "errors":[ - {"shape":"NoSuchQueryLoggingConfig"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about a specified configuration for DNS query logging.

For more information about DNS query logs, see CreateQueryLoggingConfig and Logging DNS Queries.

" - }, - "GetReusableDelegationSet":{ - "name":"GetReusableDelegationSet", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/delegationset/{Id}" - }, - "input":{"shape":"GetReusableDelegationSetRequest"}, - "output":{"shape":"GetReusableDelegationSetResponse"}, - "errors":[ - {"shape":"NoSuchDelegationSet"}, - {"shape":"DelegationSetNotReusable"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Retrieves information about a specified reusable delegation set, including the four name servers that are assigned to the delegation set.

" - }, - "GetReusableDelegationSetLimit":{ - "name":"GetReusableDelegationSetLimit", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/reusabledelegationsetlimit/{Id}/{Type}" - }, - "input":{"shape":"GetReusableDelegationSetLimitRequest"}, - "output":{"shape":"GetReusableDelegationSetLimitResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchDelegationSet"} - ], - "documentation":"

Gets the maximum number of hosted zones that you can associate with the specified reusable delegation set.

For the default limit, see Limits in the Amazon Route 53 Developer Guide. To request a higher limit, open a case.

" - }, - "GetTrafficPolicy":{ - "name":"GetTrafficPolicy", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicy/{Id}/{Version}" - }, - "input":{"shape":"GetTrafficPolicyRequest"}, - "output":{"shape":"GetTrafficPolicyResponse"}, - "errors":[ - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about a specific traffic policy version.

" - }, - "GetTrafficPolicyInstance":{ - "name":"GetTrafficPolicyInstance", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicyinstance/{Id}" - }, - "input":{"shape":"GetTrafficPolicyInstanceRequest"}, - "output":{"shape":"GetTrafficPolicyInstanceResponse"}, - "errors":[ - {"shape":"NoSuchTrafficPolicyInstance"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about a specified traffic policy instance.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

In the Amazon Route 53 console, traffic policy instances are known as policy records.

" - }, - "GetTrafficPolicyInstanceCount":{ - "name":"GetTrafficPolicyInstanceCount", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicyinstancecount" - }, - "input":{"shape":"GetTrafficPolicyInstanceCountRequest"}, - "output":{"shape":"GetTrafficPolicyInstanceCountResponse"}, - "documentation":"

Gets the number of traffic policy instances that are associated with the current AWS account.

" - }, - "ListGeoLocations":{ - "name":"ListGeoLocations", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/geolocations" - }, - "input":{"shape":"ListGeoLocationsRequest"}, - "output":{"shape":"ListGeoLocationsResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Retrieves a list of supported geo locations.

Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a country (for example, states or provinces), the subdivisions for that country are listed in alphabetical order immediately after the corresponding country.

" - }, - "ListHealthChecks":{ - "name":"ListHealthChecks", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/healthcheck" - }, - "input":{"shape":"ListHealthChecksRequest"}, - "output":{"shape":"ListHealthChecksResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"IncompatibleVersion"} - ], - "documentation":"

Retrieve a list of the health checks that are associated with the current AWS account.

" - }, - "ListHostedZones":{ - "name":"ListHostedZones", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzone" - }, - "input":{"shape":"ListHostedZonesRequest"}, - "output":{"shape":"ListHostedZonesResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchDelegationSet"}, - {"shape":"DelegationSetNotReusable"} - ], - "documentation":"

Retrieves a list of the public and private hosted zones that are associated with the current AWS account. The response includes a HostedZones child element for each hosted zone.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of hosted zones, you can use the maxitems parameter to list them in groups of up to 100.

" - }, - "ListHostedZonesByName":{ - "name":"ListHostedZonesByName", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzonesbyname" - }, - "input":{"shape":"ListHostedZonesByNameRequest"}, - "output":{"shape":"ListHostedZonesByNameResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"InvalidDomainName"} - ], - "documentation":"

Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones child element for each hosted zone created by the current AWS account.

ListHostedZonesByName sorts hosted zones by name with the labels reversed. For example:

com.example.www.

Note the trailing dot, which can change the sort order in some circumstances.

If the domain name includes escape characters or Punycode, ListHostedZonesByName alphabetizes the domain name using the escaped or Punycoded value, which is the format that Amazon Route 53 saves in its database. For example, to create a hosted zone for exämple.com, you specify ex\\344mple.com for the domain name. ListHostedZonesByName alphabetizes it as:

com.ex\\344mple.

The labels are reversed and alphabetized using the escaped value. For more information about valid domain name formats, including internationalized domain names, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.

Amazon Route 53 returns up to 100 items in each response. If you have a lot of hosted zones, use the MaxItems parameter to list them in groups of up to 100. The response includes values that help navigate from one group of MaxItems hosted zones to the next:

  • The DNSName and HostedZoneId elements in the response contain the values, if any, specified for the dnsname and hostedzoneid parameters in the request that produced the current response.

  • The MaxItems element in the response contains the value, if any, that you specified for the maxitems parameter in the request that produced the current response.

  • If the value of IsTruncated in the response is true, there are more hosted zones associated with the current AWS account.

    If IsTruncated is false, this response includes the last hosted zone that is associated with the current account. The NextDNSName element and NextHostedZoneId elements are omitted from the response.

  • The NextDNSName and NextHostedZoneId elements in the response contain the domain name and the hosted zone ID of the next hosted zone that is associated with the current AWS account. If you want to list more hosted zones, make another call to ListHostedZonesByName, and specify the value of NextDNSName and NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

" - }, - "ListQueryLoggingConfigs":{ - "name":"ListQueryLoggingConfigs", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/queryloggingconfig" - }, - "input":{"shape":"ListQueryLoggingConfigsRequest"}, - "output":{"shape":"ListQueryLoggingConfigsResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"InvalidPaginationToken"}, - {"shape":"NoSuchHostedZone"} - ], - "documentation":"

Lists the configurations for DNS query logging that are associated with the current AWS account or the configuration that is associated with a specified hosted zone.

For more information about DNS query logs, see CreateQueryLoggingConfig. Additional information, including the format of DNS query logs, appears in Logging DNS Queries in the Amazon Route 53 Developer Guide.

" - }, - "ListResourceRecordSets":{ - "name":"ListResourceRecordSets", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzone/{Id}/rrset" - }, - "input":{"shape":"ListResourceRecordSetsRequest"}, - "output":{"shape":"ListResourceRecordSetsResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Lists the resource record sets in a specified hosted zone.

ListResourceRecordSets returns up to 100 resource record sets at a time in ASCII order, beginning at a position specified by the name and type elements. The action sorts results first by DNS name with the labels reversed, for example:

com.example.www.

Note the trailing dot, which can change the sort order in some circumstances.

When multiple records have the same DNS name, the action sorts results by the record type.

You can use the name and type elements to adjust the beginning position of the list of resource record sets returned:

If you do not specify Name or Type

The results begin with the first resource record set that the hosted zone contains.

If you specify Name but not Type

The results begin with the first resource record set in the list whose name is greater than or equal to Name.

If you specify Type but not Name

Amazon Route 53 returns the InvalidInput error.

If you specify both Name and Type

The results begin with the first resource record set in the list whose name is greater than or equal to Name, and whose type is greater than or equal to Type.

This action returns the most current version of the records. This includes records that are PENDING, and that are not yet available on all Amazon Route 53 DNS servers.

To ensure that you get an accurate listing of the resource record sets for a hosted zone at a point in time, do not submit a ChangeResourceRecordSets request while you're paging through the results of a ListResourceRecordSets request. If you do, some pages may display results without the latest changes while other pages display results with the latest changes.

" - }, - "ListReusableDelegationSets":{ - "name":"ListReusableDelegationSets", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/delegationset" - }, - "input":{"shape":"ListReusableDelegationSetsRequest"}, - "output":{"shape":"ListReusableDelegationSetsResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Retrieves a list of the reusable delegation sets that are associated with the current AWS account.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/tags/{ResourceType}/{ResourceId}" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchHealthCheck"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"PriorRequestNotComplete"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Lists tags for one health check or hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "ListTagsForResources":{ - "name":"ListTagsForResources", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/tags/{ResourceType}" - }, - "input":{ - "shape":"ListTagsForResourcesRequest", - "locationName":"ListTagsForResourcesRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"ListTagsForResourcesResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchHealthCheck"}, - {"shape":"NoSuchHostedZone"}, - {"shape":"PriorRequestNotComplete"}, - {"shape":"ThrottlingException"} - ], - "documentation":"

Lists tags for up to 10 health checks or hosted zones.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "ListTrafficPolicies":{ - "name":"ListTrafficPolicies", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicies" - }, - "input":{"shape":"ListTrafficPoliciesRequest"}, - "output":{"shape":"ListTrafficPoliciesResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Gets information about the latest version for every traffic policy that is associated with the current AWS account. Policies are listed in the order in which they were created.

" - }, - "ListTrafficPolicyInstances":{ - "name":"ListTrafficPolicyInstances", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicyinstances" - }, - "input":{"shape":"ListTrafficPolicyInstancesRequest"}, - "output":{"shape":"ListTrafficPolicyInstancesResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicyInstance"} - ], - "documentation":"

Gets information about the traffic policy instances that you created by using the current AWS account.

After you submit an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

" - }, - "ListTrafficPolicyInstancesByHostedZone":{ - "name":"ListTrafficPolicyInstancesByHostedZone", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicyinstances/hostedzone" - }, - "input":{"shape":"ListTrafficPolicyInstancesByHostedZoneRequest"}, - "output":{"shape":"ListTrafficPolicyInstancesByHostedZoneResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicyInstance"}, - {"shape":"NoSuchHostedZone"} - ], - "documentation":"

Gets information about the traffic policy instances that you created in a specified hosted zone.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

" - }, - "ListTrafficPolicyInstancesByPolicy":{ - "name":"ListTrafficPolicyInstancesByPolicy", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicyinstances/trafficpolicy" - }, - "input":{"shape":"ListTrafficPolicyInstancesByPolicyRequest"}, - "output":{"shape":"ListTrafficPolicyInstancesByPolicyResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicyInstance"}, - {"shape":"NoSuchTrafficPolicy"} - ], - "documentation":"

Gets information about the traffic policy instances that you created by using a specify traffic policy version.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

" - }, - "ListTrafficPolicyVersions":{ - "name":"ListTrafficPolicyVersions", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/trafficpolicies/{Id}/versions" - }, - "input":{"shape":"ListTrafficPolicyVersionsRequest"}, - "output":{"shape":"ListTrafficPolicyVersionsResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicy"} - ], - "documentation":"

Gets information about all of the versions for a specified traffic policy.

Traffic policy versions are listed in numerical order by VersionNumber.

" - }, - "ListVPCAssociationAuthorizations":{ - "name":"ListVPCAssociationAuthorizations", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/hostedzone/{Id}/authorizevpcassociation" - }, - "input":{"shape":"ListVPCAssociationAuthorizationsRequest"}, - "output":{"shape":"ListVPCAssociationAuthorizationsResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"}, - {"shape":"InvalidPaginationToken"} - ], - "documentation":"

Gets a list of the VPCs that were created by other accounts and that can be associated with a specified hosted zone because you've submitted one or more CreateVPCAssociationAuthorization requests.

The response includes a VPCs element with a VPC child element for each VPC that can be associated with the hosted zone.

" - }, - "TestDNSAnswer":{ - "name":"TestDNSAnswer", - "http":{ - "method":"GET", - "requestUri":"/2013-04-01/testdnsanswer" - }, - "input":{"shape":"TestDNSAnswerRequest"}, - "output":{"shape":"TestDNSAnswerResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet mask.

" - }, - "UpdateHealthCheck":{ - "name":"UpdateHealthCheck", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/healthcheck/{HealthCheckId}" - }, - "input":{ - "shape":"UpdateHealthCheckRequest", - "locationName":"UpdateHealthCheckRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"UpdateHealthCheckResponse"}, - "errors":[ - {"shape":"NoSuchHealthCheck"}, - {"shape":"InvalidInput"}, - {"shape":"HealthCheckVersionMismatch"} - ], - "documentation":"

Updates an existing health check. Note that some values can't be updated.

For more information about updating health checks, see Creating, Updating, and Deleting Health Checks in the Amazon Route 53 Developer Guide.

" - }, - "UpdateHostedZoneComment":{ - "name":"UpdateHostedZoneComment", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/hostedzone/{Id}" - }, - "input":{ - "shape":"UpdateHostedZoneCommentRequest", - "locationName":"UpdateHostedZoneCommentRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"UpdateHostedZoneCommentResponse"}, - "errors":[ - {"shape":"NoSuchHostedZone"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Updates the comment for a specified hosted zone.

" - }, - "UpdateTrafficPolicyComment":{ - "name":"UpdateTrafficPolicyComment", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/trafficpolicy/{Id}/{Version}" - }, - "input":{ - "shape":"UpdateTrafficPolicyCommentRequest", - "locationName":"UpdateTrafficPolicyCommentRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"UpdateTrafficPolicyCommentResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"ConcurrentModification"} - ], - "documentation":"

Updates the comment for a specified traffic policy version.

" - }, - "UpdateTrafficPolicyInstance":{ - "name":"UpdateTrafficPolicyInstance", - "http":{ - "method":"POST", - "requestUri":"/2013-04-01/trafficpolicyinstance/{Id}" - }, - "input":{ - "shape":"UpdateTrafficPolicyInstanceRequest", - "locationName":"UpdateTrafficPolicyInstanceRequest", - "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} - }, - "output":{"shape":"UpdateTrafficPolicyInstanceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NoSuchTrafficPolicy"}, - {"shape":"NoSuchTrafficPolicyInstance"}, - {"shape":"PriorRequestNotComplete"}, - {"shape":"ConflictingTypes"} - ], - "documentation":"

Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

When you update a traffic policy instance, Amazon Route 53 continues to respond to DNS queries for the root resource record set name (such as example.com) while it replaces one group of resource record sets with another. Amazon Route 53 performs the following operations:

  1. Amazon Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true regardless of how significant the differences are between the existing resource record sets and the new resource record sets.

  2. When all of the new resource record sets have been created, Amazon Route 53 starts to respond to DNS queries for the root resource record set name (such as example.com) by using the new resource record sets.

  3. Amazon Route 53 deletes the old group of resource record sets that are associated with the root resource record set name.

" - } - }, - "shapes":{ - "AccountLimit":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"AccountLimitType", - "documentation":"

The limit that you requested. Valid values include the following:

  • MAX_HEALTH_CHECKS_BY_OWNER: The maximum number of health checks that you can create using the current account.

  • MAX_HOSTED_ZONES_BY_OWNER: The maximum number of hosted zones that you can create using the current account.

  • MAX_REUSABLE_DELEGATION_SETS_BY_OWNER: The maximum number of reusable delegation sets that you can create using the current account.

  • MAX_TRAFFIC_POLICIES_BY_OWNER: The maximum number of traffic policies that you can create using the current account.

  • MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER: The maximum number of traffic policy instances that you can create using the current account. (Traffic policy instances are referred to as traffic flow policy records in the Amazon Route 53 console.)

" - }, - "Value":{ - "shape":"LimitValue", - "documentation":"

The current value for the limit that is specified by AccountLimit$Type.

" - } - }, - "documentation":"

A complex type that contains the type of limit that you specified in the request and the current value for that limit.

" - }, - "AccountLimitType":{ - "type":"string", - "enum":[ - "MAX_HEALTH_CHECKS_BY_OWNER", - "MAX_HOSTED_ZONES_BY_OWNER", - "MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER", - "MAX_REUSABLE_DELEGATION_SETS_BY_OWNER", - "MAX_TRAFFIC_POLICIES_BY_OWNER" - ] - }, - "AlarmIdentifier":{ - "type":"structure", - "required":[ - "Region", - "Name" - ], - "members":{ - "Region":{ - "shape":"CloudWatchRegion", - "documentation":"

A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

For the current list of CloudWatch regions, see Amazon CloudWatch in the AWS Regions and Endpoints chapter of the Amazon Web Services General Reference.

" - }, - "Name":{ - "shape":"AlarmName", - "documentation":"

The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

" - } - }, - "documentation":"

A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

" - }, - "AlarmName":{ - "type":"string", - "max":256, - "min":1 - }, - "AliasHealthEnabled":{"type":"boolean"}, - "AliasTarget":{ - "type":"structure", - "required":[ - "HostedZoneId", - "DNSName", - "EvaluateTargetHealth" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

Alias resource records sets only: The value used depends on where you want to route traffic:

CloudFront distribution

Specify Z2FDTNDATAQYW2.

Alias resource record sets for CloudFront can't be created in a private zone.

Elastic Beanstalk environment

Specify the hosted zone ID for the region in which you created the environment. The environment must have a regionalized subdomain. For a list of regions and the corresponding hosted zone IDs, see AWS Elastic Beanstalk in the \"AWS Regions and Endpoints\" chapter of the Amazon Web Services General Reference.

ELB load balancer

Specify the value of the hosted zone ID for the load balancer. Use the following methods to get the hosted zone ID:

  • Elastic Load Balancing table in the \"AWS Regions and Endpoints\" chapter of the Amazon Web Services General Reference: Use the value that corresponds with the region that you created your load balancer in. Note that there are separate columns for Application and Classic Load Balancers and for Network Load Balancers.

  • AWS Management Console: Go to the Amazon EC2 page, choose Load Balancers in the navigation pane, select the load balancer, and get the value of the Hosted zone field on the Description tab.

  • Elastic Load Balancing API: Use DescribeLoadBalancers to get the applicable value. For more information, see the applicable guide:

  • AWS CLI: Use describe-load-balancers to get the applicable value. For more information, see the applicable guide:

An Amazon S3 bucket configured as a static website

Specify the hosted zone ID for the region that you created the bucket in. For more information about valid values, see the Amazon Simple Storage Service Website Endpoints table in the \"AWS Regions and Endpoints\" chapter of the Amazon Web Services General Reference.

Another Amazon Route 53 resource record set in your hosted zone

Specify the hosted zone ID of your hosted zone. (An alias resource record set can't reference a resource record set in a different hosted zone.)

" - }, - "DNSName":{ - "shape":"DNSName", - "documentation":"

Alias resource record sets only: The value that you specify depends on where you want to route queries:

CloudFront distribution

Specify the domain name that CloudFront assigned when you created your distribution.

Your CloudFront distribution must include an alternate domain name that matches the name of the resource record set. For example, if the name of the resource record set is acme.example.com, your CloudFront distribution must include acme.example.com as one of the alternate domain names. For more information, see Using Alternate Domain Names (CNAMEs) in the Amazon CloudFront Developer Guide.

Elastic Beanstalk environment

Specify the CNAME attribute for the environment. (The environment must have a regionalized domain name.) You can use the following methods to get the value of the CNAME attribute:

  • AWS Management Console: For information about how to get the value by using the console, see Using Custom Domains with AWS Elastic Beanstalk in the AWS Elastic Beanstalk Developer Guide.

  • Elastic Beanstalk API: Use the DescribeEnvironments action to get the value of the CNAME attribute. For more information, see DescribeEnvironments in the AWS Elastic Beanstalk API Reference.

  • AWS CLI: Use the describe-environments command to get the value of the CNAME attribute. For more information, see describe-environments in the AWS Command Line Interface Reference.

ELB load balancer

Specify the DNS name that is associated with the load balancer. Get the DNS name by using the AWS Management Console, the ELB API, or the AWS CLI.

  • AWS Management Console: Go to the EC2 page, choose Load Balancers in the navigation pane, choose the load balancer, choose the Description tab, and get the value of the DNS name field. (If you're routing traffic to a Classic Load Balancer, get the value that begins with dualstack.)

  • Elastic Load Balancing API: Use DescribeLoadBalancers to get the value of DNSName. For more information, see the applicable guide:

  • AWS CLI: Use describe-load-balancers to get the value of DNSName. For more information, see the applicable guide:

Amazon S3 bucket that is configured as a static website

Specify the domain name of the Amazon S3 website endpoint in which you created the bucket, for example, s3-website-us-east-2.amazonaws.com. For more information about valid values, see the table Amazon Simple Storage Service (S3) Website Endpoints in the Amazon Web Services General Reference. For more information about using S3 buckets for websites, see Getting Started with Amazon Route 53 in the Amazon Route 53 Developer Guide.

Another Amazon Route 53 resource record set

Specify the value of the Name element for a resource record set in the current hosted zone.

" - }, - "EvaluateTargetHealth":{ - "shape":"AliasHealthEnabled", - "documentation":"

Applies only to alias, failover alias, geolocation alias, latency alias, and weighted alias resource record sets: When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer, or the referenced resource record set.

Note the following:

  • You can't set EvaluateTargetHealth to true when the alias target is a CloudFront distribution.

  • If the AWS resource that you specify in AliasTarget is a resource record set or a group of resource record sets (for example, a group of weighted resource record sets), but it is not another alias resource record set, we recommend that you associate a health check with all of the resource record sets in the alias target. For more information, see What Happens When You Omit Health Checks? in the Amazon Route 53 Developer Guide.

  • If you specify an Elastic Beanstalk environment in HostedZoneId and DNSName, and if the environment contains an ELB load balancer, Elastic Load Balancing routes queries only to the healthy Amazon EC2 instances that are registered with the load balancer. (An environment automatically contains an ELB load balancer if it includes more than one EC2 instance.) If you set EvaluateTargetHealth to true and either no EC2 instances are healthy or the load balancer itself is unhealthy, Amazon Route 53 routes queries to other available resources that are healthy, if any.

    If the environment contains a single EC2 instance, there are no special requirements.

  • If you specify an ELB load balancer in AliasTarget , ELB routes queries only to the healthy EC2 instances that are registered with the load balancer. If no EC2 instances are healthy or if the load balancer itself is unhealthy, and if EvaluateTargetHealth is true for the corresponding alias resource record set, Amazon Route 53 routes queries to other resources. When you create a load balancer, you configure settings for ELB health checks; they're not Amazon Route 53 health checks, but they perform a similar function. Do not create Amazon Route 53 health checks for the EC2 instances that you register with an ELB load balancer.

    For more information, see How Health Checks Work in More Complex Amazon Route 53 Configurations in the Amazon Route 53 Developer Guide.

  • We recommend that you set EvaluateTargetHealth to true only when you have enough idle capacity to handle the failure of one or more endpoints.

For more information and examples, see Amazon Route 53 Health Checks and DNS Failover in the Amazon Route 53 Developer Guide.

" - } - }, - "documentation":"

Alias resource record sets only: Information about the CloudFront distribution, Elastic Beanstalk environment, ELB load balancer, Amazon S3 bucket, or Amazon Route 53 resource record set that you're redirecting queries to. An Elastic Beanstalk environment must have a regionalized subdomain.

When creating resource record sets for a private hosted zone, note the following:

  • Resource record sets can't be created for CloudFront distributions in a private hosted zone.

  • Creating geolocation alias resource record sets or latency alias resource record sets in a private hosted zone is unsupported.

  • For information about creating failover resource record sets in a private hosted zone, see Configuring Failover in a Private Hosted Zone.

" - }, - "AssociateVPCComment":{"type":"string"}, - "AssociateVPCWithHostedZoneRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPC" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the private hosted zone that you want to associate an Amazon VPC with.

Note that you can't associate a VPC with a hosted zone that doesn't have an existing VPC association.

", - "location":"uri", - "locationName":"Id" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

A complex type that contains information about the VPC that you want to associate with a private hosted zone.

" - }, - "Comment":{ - "shape":"AssociateVPCComment", - "documentation":"

Optional: A comment about the association request.

" - } - }, - "documentation":"

A complex type that contains information about the request to associate a VPC with a private hosted zone.

" - }, - "AssociateVPCWithHostedZoneResponse":{ - "type":"structure", - "required":["ChangeInfo"], - "members":{ - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that describes the changes made to your hosted zone.

" - } - }, - "documentation":"

A complex type that contains the response information for the AssociateVPCWithHostedZone request.

" - }, - "Change":{ - "type":"structure", - "required":[ - "Action", - "ResourceRecordSet" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

The action to perform:

  • CREATE: Creates a resource record set that has the specified values.

  • DELETE: Deletes a existing resource record set.

    To delete the resource record set that is associated with a traffic policy instance, use DeleteTrafficPolicyInstance . Amazon Route 53 will delete the resource record set automatically. If you delete the resource record set by using ChangeResourceRecordSets, Amazon Route 53 doesn't automatically delete the traffic policy instance, and you'll continue to be charged for it even though it's no longer in use.

  • UPSERT: If a resource record set doesn't already exist, Amazon Route 53 creates it. If a resource record set does exist, Amazon Route 53 updates it with the values in the request.

" - }, - "ResourceRecordSet":{ - "shape":"ResourceRecordSet", - "documentation":"

Information about the resource record set to create, delete, or update.

" - } - }, - "documentation":"

The information for each resource record set that you want to change.

" - }, - "ChangeAction":{ - "type":"string", - "enum":[ - "CREATE", - "DELETE", - "UPSERT" - ] - }, - "ChangeBatch":{ - "type":"structure", - "required":["Changes"], - "members":{ - "Comment":{ - "shape":"ResourceDescription", - "documentation":"

Optional: Any comments you want to include about a change batch request.

" - }, - "Changes":{ - "shape":"Changes", - "documentation":"

Information about the changes to make to the record sets.

" - } - }, - "documentation":"

The information for a change request.

" - }, - "ChangeInfo":{ - "type":"structure", - "required":[ - "Id", - "Status", - "SubmittedAt" - ], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the request.

" - }, - "Status":{ - "shape":"ChangeStatus", - "documentation":"

The current state of the request. PENDING indicates that this request has not yet been applied to all Amazon Route 53 DNS servers.

" - }, - "SubmittedAt":{ - "shape":"TimeStamp", - "documentation":"

The date and time that the change request was submitted in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2017-03-27T17:48:16.751Z represents March 27, 2017 at 17:48:16.751 UTC.

" - }, - "Comment":{ - "shape":"ResourceDescription", - "documentation":"

A complex type that describes change information about changes made to your hosted zone.

This element contains an ID that you use when performing a GetChange action to get detailed information about the change.

" - } - }, - "documentation":"

A complex type that describes change information about changes made to your hosted zone.

" - }, - "ChangeResourceRecordSetsRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "ChangeBatch" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that contains the resource record sets that you want to change.

", - "location":"uri", - "locationName":"Id" - }, - "ChangeBatch":{ - "shape":"ChangeBatch", - "documentation":"

A complex type that contains an optional comment and the Changes element.

" - } - }, - "documentation":"

A complex type that contains change information for the resource record set.

" - }, - "ChangeResourceRecordSetsResponse":{ - "type":"structure", - "required":["ChangeInfo"], - "members":{ - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that contains information about changes made to your hosted zone.

This element contains an ID that you use when performing a GetChange action to get detailed information about the change.

" - } - }, - "documentation":"

A complex type containing the response for the request.

" - }, - "ChangeStatus":{ - "type":"string", - "enum":[ - "PENDING", - "INSYNC" - ] - }, - "ChangeTagsForResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId" - ], - "members":{ - "ResourceType":{ - "shape":"TagResourceType", - "documentation":"

The type of the resource.

  • The resource type for health checks is healthcheck.

  • The resource type for hosted zones is hostedzone.

", - "location":"uri", - "locationName":"ResourceType" - }, - "ResourceId":{ - "shape":"TagResourceId", - "documentation":"

The ID of the resource for which you want to add, change, or delete tags.

", - "location":"uri", - "locationName":"ResourceId" - }, - "AddTags":{ - "shape":"TagList", - "documentation":"

A complex type that contains a list of the tags that you want to add to the specified health check or hosted zone and/or the tags that you want to edit Value for.

You can add a maximum of 10 tags to a health check or a hosted zone.

" - }, - "RemoveTagKeys":{ - "shape":"TagKeyList", - "documentation":"

A complex type that contains a list of the tags that you want to delete from the specified health check or hosted zone. You can specify up to 10 keys.

" - } - }, - "documentation":"

A complex type that contains information about the tags that you want to add, edit, or delete.

" - }, - "ChangeTagsForResourceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Empty response for the request.

" - }, - "Changes":{ - "type":"list", - "member":{ - "shape":"Change", - "locationName":"Change" - }, - "min":1 - }, - "CheckerIpRanges":{ - "type":"list", - "member":{"shape":"IPAddressCidr"} - }, - "ChildHealthCheckList":{ - "type":"list", - "member":{ - "shape":"HealthCheckId", - "locationName":"ChildHealthCheck" - }, - "max":256 - }, - "CloudWatchAlarmConfiguration":{ - "type":"structure", - "required":[ - "EvaluationPeriods", - "Threshold", - "ComparisonOperator", - "Period", - "MetricName", - "Namespace", - "Statistic" - ], - "members":{ - "EvaluationPeriods":{ - "shape":"EvaluationPeriods", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

" - }, - "Threshold":{ - "shape":"Threshold", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

" - }, - "Period":{ - "shape":"Period", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the CloudWatch metric that the alarm is associated with.

" - }, - "Namespace":{ - "shape":"Namespace", - "documentation":"

The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

" - }, - "Statistic":{ - "shape":"Statistic", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

" - }, - "Dimensions":{ - "shape":"DimensionList", - "documentation":"

For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

" - } - }, - "documentation":"

A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

" - }, - "CloudWatchLogsLogGroupArn":{"type":"string"}, - "CloudWatchRegion":{ - "type":"string", - "enum":[ - "us-east-1", - "us-east-2", - "us-west-1", - "us-west-2", - "ca-central-1", - "eu-central-1", - "eu-west-1", - "eu-west-2", - "eu-west-3", - "ap-south-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1", - "ap-northeast-2", - "ap-northeast-3", - "sa-east-1" - ], - "max":64, - "min":1 - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "GreaterThanOrEqualToThreshold", - "GreaterThanThreshold", - "LessThanThreshold", - "LessThanOrEqualToThreshold" - ] - }, - "ConcurrentModification":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "ConflictingDomainExists":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The cause of this error depends on whether you're trying to create a public or a private hosted zone:

  • Public hosted zone: Two hosted zones that have the same name or that have a parent/child relationship (example.com and test.example.com) can't have any common name servers. You tried to create a hosted zone that has the same name as an existing hosted zone or that's the parent or child of an existing hosted zone, and you specified a delegation set that shares one or more name servers with the existing hosted zone. For more information, see CreateReusableDelegationSet.

  • Private hosted zone: You specified an Amazon VPC that you're already using for another hosted zone, and the domain that you specified for one of the hosted zones is a subdomain of the domain that you specified for the other hosted zone. For example, you can't use the same Amazon VPC for the hosted zones for example.com and test.example.com.

", - "exception":true - }, - "ConflictingTypes":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

You tried to update a traffic policy instance by using a traffic policy version that has a different DNS type than the current type for the instance. You specified the type in the JSON document in the CreateTrafficPolicy or CreateTrafficPolicyVersionrequest.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "CreateHealthCheckRequest":{ - "type":"structure", - "required":[ - "CallerReference", - "HealthCheckConfig" - ], - "members":{ - "CallerReference":{ - "shape":"HealthCheckNonce", - "documentation":"

A unique string that identifies the request and that allows you to retry a failed CreateHealthCheck request without the risk of creating two identical health checks:

  • If you send a CreateHealthCheck request with the same CallerReference and settings as a previous request, and if the health check doesn't exist, Amazon Route 53 creates the health check. If the health check does exist, Amazon Route 53 returns the settings for the existing health check.

  • If you send a CreateHealthCheck request with the same CallerReference as a deleted health check, regardless of the settings, Amazon Route 53 returns a HealthCheckAlreadyExists error.

  • If you send a CreateHealthCheck request with the same CallerReference as an existing health check but with different settings, Amazon Route 53 returns a HealthCheckAlreadyExists error.

  • If you send a CreateHealthCheck request with a unique CallerReference but settings identical to an existing health check, Amazon Route 53 creates the health check.

" - }, - "HealthCheckConfig":{ - "shape":"HealthCheckConfig", - "documentation":"

A complex type that contains the response to a CreateHealthCheck request.

" - } - }, - "documentation":"

A complex type that contains the health check request information.

" - }, - "CreateHealthCheckResponse":{ - "type":"structure", - "required":[ - "HealthCheck", - "Location" - ], - "members":{ - "HealthCheck":{ - "shape":"HealthCheck", - "documentation":"

A complex type that contains identifying information about the health check.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

The unique URL representing the new health check.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

A complex type containing the response information for the new health check.

" - }, - "CreateHostedZoneRequest":{ - "type":"structure", - "required":[ - "Name", - "CallerReference" - ], - "members":{ - "Name":{ - "shape":"DNSName", - "documentation":"

The name of the domain. For resource record types that include a domain name, specify a fully qualified domain name, for example, www.example.com. The trailing dot is optional; Amazon Route 53 assumes that the domain name is fully qualified. This means that Amazon Route 53 treats www.example.com (without a trailing dot) and www.example.com. (with a trailing dot) as identical.

If you're creating a public hosted zone, this is the name you have registered with your DNS registrar. If your domain name is registered with a registrar other than Amazon Route 53, change the name servers for your domain to the set of NameServers that CreateHostedZone returns in DelegationSet.

" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

(Private hosted zones only) A complex type that contains information about the Amazon VPC that you're associating with this hosted zone.

You can specify only one Amazon VPC when you create a private hosted zone. To associate additional Amazon VPCs with the hosted zone, use AssociateVPCWithHostedZone after you create a hosted zone.

" - }, - "CallerReference":{ - "shape":"Nonce", - "documentation":"

A unique string that identifies the request and that allows failed CreateHostedZone requests to be retried without the risk of executing the operation twice. You must use a unique CallerReference string every time you submit a CreateHostedZone request. CallerReference can be any unique string, for example, a date/time stamp.

" - }, - "HostedZoneConfig":{ - "shape":"HostedZoneConfig", - "documentation":"

(Optional) A complex type that contains the following optional values:

  • For public and private hosted zones, an optional comment

  • For private hosted zones, an optional PrivateZone element

If you don't specify a comment or the PrivateZone element, omit HostedZoneConfig and the other elements.

" - }, - "DelegationSetId":{ - "shape":"ResourceId", - "documentation":"

If you want to associate a reusable delegation set with this hosted zone, the ID that Amazon Route 53 assigned to the reusable delegation set when you created it. For more information about reusable delegation sets, see CreateReusableDelegationSet.

" - } - }, - "documentation":"

A complex type that contains information about the request to create a hosted zone.

" - }, - "CreateHostedZoneResponse":{ - "type":"structure", - "required":[ - "HostedZone", - "ChangeInfo", - "DelegationSet", - "Location" - ], - "members":{ - "HostedZone":{ - "shape":"HostedZone", - "documentation":"

A complex type that contains general information about the hosted zone.

" - }, - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that contains information about the CreateHostedZone request.

" - }, - "DelegationSet":{ - "shape":"DelegationSet", - "documentation":"

A complex type that describes the name servers for this hosted zone.

" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

A complex type that contains information about an Amazon VPC that you associated with this hosted zone.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

The unique URL representing the new hosted zone.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

A complex type containing the response information for the hosted zone.

" - }, - "CreateQueryLoggingConfigRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "CloudWatchLogsLogGroupArn" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you want to log queries for. You can log queries only for public hosted zones.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"CloudWatchLogsLogGroupArn", - "documentation":"

The Amazon Resource Name (ARN) for the log group that you want to Amazon Route 53 to send query logs to. This is the format of the ARN:

arn:aws:logs:region:account-id:log-group:log_group_name

To get the ARN for a log group, you can use the CloudWatch console, the DescribeLogGroups API action, the describe-log-groups command, or the applicable command in one of the AWS SDKs.

" - } - } - }, - "CreateQueryLoggingConfigResponse":{ - "type":"structure", - "required":[ - "QueryLoggingConfig", - "Location" - ], - "members":{ - "QueryLoggingConfig":{ - "shape":"QueryLoggingConfig", - "documentation":"

A complex type that contains the ID for a query logging configuration, the ID of the hosted zone that you want to log queries for, and the ARN for the log group that you want Amazon Route 53 to send query logs to.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

The unique URL representing the new query logging configuration.

", - "location":"header", - "locationName":"Location" - } - } - }, - "CreateReusableDelegationSetRequest":{ - "type":"structure", - "required":["CallerReference"], - "members":{ - "CallerReference":{ - "shape":"Nonce", - "documentation":"

A unique string that identifies the request, and that allows you to retry failed CreateReusableDelegationSet requests without the risk of executing the operation twice. You must use a unique CallerReference string every time you submit a CreateReusableDelegationSet request. CallerReference can be any unique string, for example a date/time stamp.

" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

If you want to mark the delegation set for an existing hosted zone as reusable, the ID for that hosted zone.

" - } - } - }, - "CreateReusableDelegationSetResponse":{ - "type":"structure", - "required":[ - "DelegationSet", - "Location" - ], - "members":{ - "DelegationSet":{ - "shape":"DelegationSet", - "documentation":"

A complex type that contains name server information.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

The unique URL representing the new reusable delegation set.

", - "location":"header", - "locationName":"Location" - } - } - }, - "CreateTrafficPolicyInstanceRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "Name", - "TTL", - "TrafficPolicyId", - "TrafficPolicyVersion" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone in which you want Amazon Route 53 to create resource record sets by using the configuration in a traffic policy.

" - }, - "Name":{ - "shape":"DNSName", - "documentation":"

The domain name (such as example.com) or subdomain name (such as www.example.com) for which Amazon Route 53 responds to DNS queries by using the resource record sets that Amazon Route 53 creates for this traffic policy instance.

" - }, - "TTL":{ - "shape":"TTL", - "documentation":"

(Optional) The TTL that you want Amazon Route 53 to assign to all of the resource record sets that it creates in the specified hosted zone.

" - }, - "TrafficPolicyId":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy that you want to use to create resource record sets in the specified hosted zone.

" - }, - "TrafficPolicyVersion":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version of the traffic policy that you want to use to create resource record sets in the specified hosted zone.

" - } - }, - "documentation":"

A complex type that contains information about the resource record sets that you want to create based on a specified traffic policy.

" - }, - "CreateTrafficPolicyInstanceResponse":{ - "type":"structure", - "required":[ - "TrafficPolicyInstance", - "Location" - ], - "members":{ - "TrafficPolicyInstance":{ - "shape":"TrafficPolicyInstance", - "documentation":"

A complex type that contains settings for the new traffic policy instance.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

A unique URL that represents a new traffic policy instance.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

A complex type that contains the response information for the CreateTrafficPolicyInstance request.

" - }, - "CreateTrafficPolicyRequest":{ - "type":"structure", - "required":[ - "Name", - "Document" - ], - "members":{ - "Name":{ - "shape":"TrafficPolicyName", - "documentation":"

The name of the traffic policy.

" - }, - "Document":{ - "shape":"TrafficPolicyDocument", - "documentation":"

The definition of this traffic policy in JSON format. For more information, see Traffic Policy Document Format.

" - }, - "Comment":{ - "shape":"TrafficPolicyComment", - "documentation":"

(Optional) Any comments that you want to include about the traffic policy.

" - } - }, - "documentation":"

A complex type that contains information about the traffic policy that you want to create.

" - }, - "CreateTrafficPolicyResponse":{ - "type":"structure", - "required":[ - "TrafficPolicy", - "Location" - ], - "members":{ - "TrafficPolicy":{ - "shape":"TrafficPolicy", - "documentation":"

A complex type that contains settings for the new traffic policy.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

A unique URL that represents a new traffic policy.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

A complex type that contains the response information for the CreateTrafficPolicy request.

" - }, - "CreateTrafficPolicyVersionRequest":{ - "type":"structure", - "required":[ - "Id", - "Document" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy for which you want to create a new version.

", - "location":"uri", - "locationName":"Id" - }, - "Document":{ - "shape":"TrafficPolicyDocument", - "documentation":"

The definition of this version of the traffic policy, in JSON format. You specified the JSON in the CreateTrafficPolicyVersion request. For more information about the JSON format, see CreateTrafficPolicy.

" - }, - "Comment":{ - "shape":"TrafficPolicyComment", - "documentation":"

The comment that you specified in the CreateTrafficPolicyVersion request, if any.

" - } - }, - "documentation":"

A complex type that contains information about the traffic policy that you want to create a new version for.

" - }, - "CreateTrafficPolicyVersionResponse":{ - "type":"structure", - "required":[ - "TrafficPolicy", - "Location" - ], - "members":{ - "TrafficPolicy":{ - "shape":"TrafficPolicy", - "documentation":"

A complex type that contains settings for the new version of the traffic policy.

" - }, - "Location":{ - "shape":"ResourceURI", - "documentation":"

A unique URL that represents a new traffic policy version.

", - "location":"header", - "locationName":"Location" - } - }, - "documentation":"

A complex type that contains the response information for the CreateTrafficPolicyVersion request.

" - }, - "CreateVPCAssociationAuthorizationRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPC" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the private hosted zone that you want to authorize associating a VPC with.

", - "location":"uri", - "locationName":"Id" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

A complex type that contains the VPC ID and region for the VPC that you want to authorize associating with your hosted zone.

" - } - }, - "documentation":"

A complex type that contains information about the request to authorize associating a VPC with your private hosted zone. Authorization is only required when a private hosted zone and a VPC were created by using different accounts.

" - }, - "CreateVPCAssociationAuthorizationResponse":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPC" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you authorized associating a VPC with.

" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

The VPC that you authorized associating with a hosted zone.

" - } - }, - "documentation":"

A complex type that contains the response information from a CreateVPCAssociationAuthorization request.

" - }, - "DNSName":{ - "type":"string", - "max":1024 - }, - "DNSRCode":{"type":"string"}, - "DelegationSet":{ - "type":"structure", - "required":["NameServers"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID that Amazon Route 53 assigns to a reusable delegation set.

" - }, - "CallerReference":{ - "shape":"Nonce", - "documentation":"

The value that you specified for CallerReference when you created the reusable delegation set.

" - }, - "NameServers":{ - "shape":"DelegationSetNameServers", - "documentation":"

A complex type that contains a list of the authoritative name servers for a hosted zone or for a reusable delegation set.

" - } - }, - "documentation":"

A complex type that lists the name servers in a delegation set, as well as the CallerReference and the ID for the delegation set.

" - }, - "DelegationSetAlreadyCreated":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

A delegation set with the same owner and caller reference combination has already been created.

", - "exception":true - }, - "DelegationSetAlreadyReusable":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified delegation set has already been marked as reusable.

", - "exception":true - }, - "DelegationSetInUse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified delegation contains associated hosted zones which must be deleted before the reusable delegation set can be deleted.

", - "exception":true - }, - "DelegationSetNameServers":{ - "type":"list", - "member":{ - "shape":"DNSName", - "locationName":"NameServer" - }, - "min":1 - }, - "DelegationSetNotAvailable":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

You can create a hosted zone that has the same name as an existing hosted zone (example.com is common), but there is a limit to the number of hosted zones that have the same name. If you get this error, Amazon Route 53 has reached that limit. If you own the domain name and Amazon Route 53 generates this error, contact Customer Support.

", - "exception":true - }, - "DelegationSetNotReusable":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

A reusable delegation set with the specified ID does not exist.

", - "exception":true - }, - "DelegationSets":{ - "type":"list", - "member":{ - "shape":"DelegationSet", - "locationName":"DelegationSet" - } - }, - "DeleteHealthCheckRequest":{ - "type":"structure", - "required":["HealthCheckId"], - "members":{ - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

The ID of the health check that you want to delete.

", - "location":"uri", - "locationName":"HealthCheckId" - } - }, - "documentation":"

This action deletes a health check.

" - }, - "DeleteHealthCheckResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element.

" - }, - "DeleteHostedZoneRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone you want to delete.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A request to delete a hosted zone.

" - }, - "DeleteHostedZoneResponse":{ - "type":"structure", - "required":["ChangeInfo"], - "members":{ - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that contains the ID, the status, and the date and time of a request to delete a hosted zone.

" - } - }, - "documentation":"

A complex type that contains the response to a DeleteHostedZone request.

" - }, - "DeleteQueryLoggingConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"QueryLoggingConfigId", - "documentation":"

The ID of the configuration that you want to delete.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "DeleteQueryLoggingConfigResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteReusableDelegationSetRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the reusable delegation set that you want to delete.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A request to delete a reusable delegation set.

" - }, - "DeleteReusableDelegationSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element.

" - }, - "DeleteTrafficPolicyInstanceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TrafficPolicyInstanceId", - "documentation":"

The ID of the traffic policy instance that you want to delete.

When you delete a traffic policy instance, Amazon Route 53 also deletes all of the resource record sets that were created when you created the traffic policy instance.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A request to delete a specified traffic policy instance.

" - }, - "DeleteTrafficPolicyInstanceResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element.

" - }, - "DeleteTrafficPolicyRequest":{ - "type":"structure", - "required":[ - "Id", - "Version" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy that you want to delete.

", - "location":"uri", - "locationName":"Id" - }, - "Version":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version number of the traffic policy that you want to delete.

", - "location":"uri", - "locationName":"Version" - } - }, - "documentation":"

A request to delete a specified traffic policy version.

" - }, - "DeleteTrafficPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element.

" - }, - "DeleteVPCAssociationAuthorizationRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPC" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

When removing authorization to associate a VPC that was created by one AWS account with a hosted zone that was created with a different AWS account, the ID of the hosted zone.

", - "location":"uri", - "locationName":"Id" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

When removing authorization to associate a VPC that was created by one AWS account with a hosted zone that was created with a different AWS account, a complex type that includes the ID and region of the VPC.

" - } - }, - "documentation":"

A complex type that contains information about the request to remove authorization to associate a VPC that was created by one AWS account with a hosted zone that was created with a different AWS account.

" - }, - "DeleteVPCAssociationAuthorizationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

Empty response for the request.

" - }, - "Dimension":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"DimensionField", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the name of one dimension.

" - }, - "Value":{ - "shape":"DimensionField", - "documentation":"

For the metric that the CloudWatch alarm is associated with, the value of one dimension.

" - } - }, - "documentation":"

For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

" - }, - "DimensionField":{ - "type":"string", - "max":255, - "min":1 - }, - "DimensionList":{ - "type":"list", - "member":{ - "shape":"Dimension", - "locationName":"Dimension" - }, - "max":10 - }, - "DisassociateVPCComment":{"type":"string"}, - "DisassociateVPCFromHostedZoneRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPC" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the private hosted zone that you want to disassociate a VPC from.

", - "location":"uri", - "locationName":"Id" - }, - "VPC":{ - "shape":"VPC", - "documentation":"

A complex type that contains information about the VPC that you're disassociating from the specified hosted zone.

" - }, - "Comment":{ - "shape":"DisassociateVPCComment", - "documentation":"

Optional: A comment about the disassociation request.

" - } - }, - "documentation":"

A complex type that contains information about the VPC that you want to disassociate from a specified private hosted zone.

" - }, - "DisassociateVPCFromHostedZoneResponse":{ - "type":"structure", - "required":["ChangeInfo"], - "members":{ - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that describes the changes made to the specified private hosted zone.

" - } - }, - "documentation":"

A complex type that contains the response information for the disassociate request.

" - }, - "EnableSNI":{"type":"boolean"}, - "ErrorMessage":{"type":"string"}, - "ErrorMessages":{ - "type":"list", - "member":{ - "shape":"ErrorMessage", - "locationName":"Message" - } - }, - "EvaluationPeriods":{ - "type":"integer", - "min":1 - }, - "FailureThreshold":{ - "type":"integer", - "max":10, - "min":1 - }, - "FullyQualifiedDomainName":{ - "type":"string", - "max":255 - }, - "GeoLocation":{ - "type":"structure", - "members":{ - "ContinentCode":{ - "shape":"GeoLocationContinentCode", - "documentation":"

The two-letter code for the continent.

Valid values: AF | AN | AS | EU | OC | NA | SA

Constraint: Specifying ContinentCode with either CountryCode or SubdivisionCode returns an InvalidInput error.

" - }, - "CountryCode":{ - "shape":"GeoLocationCountryCode", - "documentation":"

The two-letter code for the country.

" - }, - "SubdivisionCode":{ - "shape":"GeoLocationSubdivisionCode", - "documentation":"

The code for the subdivision, for example, a state in the United States or a province in Canada.

" - } - }, - "documentation":"

A complex type that contains information about a geo location.

" - }, - "GeoLocationContinentCode":{ - "type":"string", - "max":2, - "min":2 - }, - "GeoLocationContinentName":{ - "type":"string", - "max":32, - "min":1 - }, - "GeoLocationCountryCode":{ - "type":"string", - "max":2, - "min":1 - }, - "GeoLocationCountryName":{ - "type":"string", - "max":64, - "min":1 - }, - "GeoLocationDetails":{ - "type":"structure", - "members":{ - "ContinentCode":{ - "shape":"GeoLocationContinentCode", - "documentation":"

The two-letter code for the continent.

" - }, - "ContinentName":{ - "shape":"GeoLocationContinentName", - "documentation":"

The full name of the continent.

" - }, - "CountryCode":{ - "shape":"GeoLocationCountryCode", - "documentation":"

The two-letter code for the country.

" - }, - "CountryName":{ - "shape":"GeoLocationCountryName", - "documentation":"

The name of the country.

" - }, - "SubdivisionCode":{ - "shape":"GeoLocationSubdivisionCode", - "documentation":"

The code for the subdivision, for example, a state in the United States or a province in Canada.

" - }, - "SubdivisionName":{ - "shape":"GeoLocationSubdivisionName", - "documentation":"

The full name of the subdivision, for example, a state in the United States or a province in Canada.

" - } - }, - "documentation":"

A complex type that contains the codes and full continent, country, and subdivision names for the specified geolocation code.

" - }, - "GeoLocationDetailsList":{ - "type":"list", - "member":{ - "shape":"GeoLocationDetails", - "locationName":"GeoLocationDetails" - } - }, - "GeoLocationSubdivisionCode":{ - "type":"string", - "max":3, - "min":1 - }, - "GeoLocationSubdivisionName":{ - "type":"string", - "max":64, - "min":1 - }, - "GetAccountLimitRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"AccountLimitType", - "documentation":"

The limit that you want to get. Valid values include the following:

  • MAX_HEALTH_CHECKS_BY_OWNER: The maximum number of health checks that you can create using the current account.

  • MAX_HOSTED_ZONES_BY_OWNER: The maximum number of hosted zones that you can create using the current account.

  • MAX_REUSABLE_DELEGATION_SETS_BY_OWNER: The maximum number of reusable delegation sets that you can create using the current account.

  • MAX_TRAFFIC_POLICIES_BY_OWNER: The maximum number of traffic policies that you can create using the current account.

  • MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER: The maximum number of traffic policy instances that you can create using the current account. (Traffic policy instances are referred to as traffic flow policy records in the Amazon Route 53 console.)

", - "location":"uri", - "locationName":"Type" - } - }, - "documentation":"

A complex type that contains information about the request to create a hosted zone.

" - }, - "GetAccountLimitResponse":{ - "type":"structure", - "required":[ - "Limit", - "Count" - ], - "members":{ - "Limit":{ - "shape":"AccountLimit", - "documentation":"

The current setting for the specified limit. For example, if you specified MAX_HEALTH_CHECKS_BY_OWNER for the value of Type in the request, the value of Limit is the maximum number of health checks that you can create using the current account.

" - }, - "Count":{ - "shape":"UsageCount", - "documentation":"

The current number of entities that you have created of the specified type. For example, if you specified MAX_HEALTH_CHECKS_BY_OWNER for the value of Type in the request, the value of Count is the current number of health checks that you have created using the current account.

" - } - }, - "documentation":"

A complex type that contains the requested limit.

" - }, - "GetChangeRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the change batch request. The value that you specify here is the value that ChangeResourceRecordSets returned in the Id element when you submitted the request.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

The input for a GetChange request.

" - }, - "GetChangeResponse":{ - "type":"structure", - "required":["ChangeInfo"], - "members":{ - "ChangeInfo":{ - "shape":"ChangeInfo", - "documentation":"

A complex type that contains information about the specified change batch.

" - } - }, - "documentation":"

A complex type that contains the ChangeInfo element.

" - }, - "GetCheckerIpRangesRequest":{ - "type":"structure", - "members":{ - } - }, - "GetCheckerIpRangesResponse":{ - "type":"structure", - "required":["CheckerIpRanges"], - "members":{ - "CheckerIpRanges":{"shape":"CheckerIpRanges"} - } - }, - "GetGeoLocationRequest":{ - "type":"structure", - "members":{ - "ContinentCode":{ - "shape":"GeoLocationContinentCode", - "documentation":"

Amazon Route 53 supports the following continent codes:

  • AF: Africa

  • AN: Antarctica

  • AS: Asia

  • EU: Europe

  • OC: Oceania

  • NA: North America

  • SA: South America

", - "location":"querystring", - "locationName":"continentcode" - }, - "CountryCode":{ - "shape":"GeoLocationCountryCode", - "documentation":"

Amazon Route 53 uses the two-letter country codes that are specified in ISO standard 3166-1 alpha-2.

", - "location":"querystring", - "locationName":"countrycode" - }, - "SubdivisionCode":{ - "shape":"GeoLocationSubdivisionCode", - "documentation":"

Amazon Route 53 uses the one- to three-letter subdivision codes that are specified in ISO standard 3166-1 alpha-2. Amazon Route 53 doesn't support subdivision codes for all countries. If you specify SubdivisionCode, you must also specify CountryCode.

", - "location":"querystring", - "locationName":"subdivisioncode" - } - }, - "documentation":"

A request for information about whether a specified geographic location is supported for Amazon Route 53 geolocation resource record sets.

" - }, - "GetGeoLocationResponse":{ - "type":"structure", - "required":["GeoLocationDetails"], - "members":{ - "GeoLocationDetails":{ - "shape":"GeoLocationDetails", - "documentation":"

A complex type that contains the codes and full continent, country, and subdivision names for the specified geolocation code.

" - } - }, - "documentation":"

A complex type that contains the response information for the specified geolocation code.

" - }, - "GetHealthCheckCountRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

A request for the number of health checks that are associated with the current AWS account.

" - }, - "GetHealthCheckCountResponse":{ - "type":"structure", - "required":["HealthCheckCount"], - "members":{ - "HealthCheckCount":{ - "shape":"HealthCheckCount", - "documentation":"

The number of health checks associated with the current AWS account.

" - } - }, - "documentation":"

A complex type that contains the response to a GetHealthCheckCount request.

" - }, - "GetHealthCheckLastFailureReasonRequest":{ - "type":"structure", - "required":["HealthCheckId"], - "members":{ - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

The ID for the health check for which you want the last failure reason. When you created the health check, CreateHealthCheck returned the ID in the response, in the HealthCheckId element.

If you want to get the last failure reason for a calculated health check, you must use the Amazon Route 53 console or the CloudWatch console. You can't use GetHealthCheckLastFailureReason for a calculated health check.

", - "location":"uri", - "locationName":"HealthCheckId" - } - }, - "documentation":"

A request for the reason that a health check failed most recently.

" - }, - "GetHealthCheckLastFailureReasonResponse":{ - "type":"structure", - "required":["HealthCheckObservations"], - "members":{ - "HealthCheckObservations":{ - "shape":"HealthCheckObservations", - "documentation":"

A list that contains one Observation element for each Amazon Route 53 health checker that is reporting a last failure reason.

" - } - }, - "documentation":"

A complex type that contains the response to a GetHealthCheckLastFailureReason request.

" - }, - "GetHealthCheckRequest":{ - "type":"structure", - "required":["HealthCheckId"], - "members":{ - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

", - "location":"uri", - "locationName":"HealthCheckId" - } - }, - "documentation":"

A request to get information about a specified health check.

" - }, - "GetHealthCheckResponse":{ - "type":"structure", - "required":["HealthCheck"], - "members":{ - "HealthCheck":{ - "shape":"HealthCheck", - "documentation":"

A complex type that contains information about one health check that is associated with the current AWS account.

" - } - }, - "documentation":"

A complex type that contains the response to a GetHealthCheck request.

" - }, - "GetHealthCheckStatusRequest":{ - "type":"structure", - "required":["HealthCheckId"], - "members":{ - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

The ID for the health check that you want the current status for. When you created the health check, CreateHealthCheck returned the ID in the response, in the HealthCheckId element.

If you want to check the status of a calculated health check, you must use the Amazon Route 53 console or the CloudWatch console. You can't use GetHealthCheckStatus to get the status of a calculated health check.

", - "location":"uri", - "locationName":"HealthCheckId" - } - }, - "documentation":"

A request to get the status for a health check.

" - }, - "GetHealthCheckStatusResponse":{ - "type":"structure", - "required":["HealthCheckObservations"], - "members":{ - "HealthCheckObservations":{ - "shape":"HealthCheckObservations", - "documentation":"

A list that contains one HealthCheckObservation element for each Amazon Route 53 health checker that is reporting a status about the health check endpoint.

" - } - }, - "documentation":"

A complex type that contains the response to a GetHealthCheck request.

" - }, - "GetHostedZoneCountRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

A request to retrieve a count of all the hosted zones that are associated with the current AWS account.

" - }, - "GetHostedZoneCountResponse":{ - "type":"structure", - "required":["HostedZoneCount"], - "members":{ - "HostedZoneCount":{ - "shape":"HostedZoneCount", - "documentation":"

The total number of public and private hosted zones that are associated with the current AWS account.

" - } - }, - "documentation":"

A complex type that contains the response to a GetHostedZoneCount request.

" - }, - "GetHostedZoneLimitRequest":{ - "type":"structure", - "required":[ - "Type", - "HostedZoneId" - ], - "members":{ - "Type":{ - "shape":"HostedZoneLimitType", - "documentation":"

The limit that you want to get. Valid values include the following:

  • MAX_RRSETS_BY_ZONE: The maximum number of records that you can create in the specified hosted zone.

  • MAX_VPCS_ASSOCIATED_BY_ZONE: The maximum number of Amazon VPCs that you can associate with the specified private hosted zone.

", - "location":"uri", - "locationName":"Type" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you want to get a limit for.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A complex type that contains information about the request to create a hosted zone.

" - }, - "GetHostedZoneLimitResponse":{ - "type":"structure", - "required":[ - "Limit", - "Count" - ], - "members":{ - "Limit":{ - "shape":"HostedZoneLimit", - "documentation":"

The current setting for the specified limit. For example, if you specified MAX_RRSETS_BY_ZONE for the value of Type in the request, the value of Limit is the maximum number of records that you can create in the specified hosted zone.

" - }, - "Count":{ - "shape":"UsageCount", - "documentation":"

The current number of entities that you have created of the specified type. For example, if you specified MAX_RRSETS_BY_ZONE for the value of Type in the request, the value of Count is the current number of records that you have created in the specified hosted zone.

" - } - }, - "documentation":"

A complex type that contains the requested limit.

" - }, - "GetHostedZoneRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you want to get information about.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A request to get information about a specified hosted zone.

" - }, - "GetHostedZoneResponse":{ - "type":"structure", - "required":["HostedZone"], - "members":{ - "HostedZone":{ - "shape":"HostedZone", - "documentation":"

A complex type that contains general information about the specified hosted zone.

" - }, - "DelegationSet":{ - "shape":"DelegationSet", - "documentation":"

A complex type that lists the Amazon Route 53 name servers for the specified hosted zone.

" - }, - "VPCs":{ - "shape":"VPCs", - "documentation":"

A complex type that contains information about the VPCs that are associated with the specified hosted zone.

" - } - }, - "documentation":"

A complex type that contain the response to a GetHostedZone request.

" - }, - "GetQueryLoggingConfigRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"QueryLoggingConfigId", - "documentation":"

The ID of the configuration for DNS query logging that you want to get information about.

", - "location":"uri", - "locationName":"Id" - } - } - }, - "GetQueryLoggingConfigResponse":{ - "type":"structure", - "required":["QueryLoggingConfig"], - "members":{ - "QueryLoggingConfig":{ - "shape":"QueryLoggingConfig", - "documentation":"

A complex type that contains information about the query logging configuration that you specified in a GetQueryLoggingConfig request.

" - } - } - }, - "GetReusableDelegationSetLimitRequest":{ - "type":"structure", - "required":[ - "Type", - "DelegationSetId" - ], - "members":{ - "Type":{ - "shape":"ReusableDelegationSetLimitType", - "documentation":"

Specify MAX_ZONES_BY_REUSABLE_DELEGATION_SET to get the maximum number of hosted zones that you can associate with the specified reusable delegation set.

", - "location":"uri", - "locationName":"Type" - }, - "DelegationSetId":{ - "shape":"ResourceId", - "documentation":"

The ID of the delegation set that you want to get the limit for.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A complex type that contains information about the request to create a hosted zone.

" - }, - "GetReusableDelegationSetLimitResponse":{ - "type":"structure", - "required":[ - "Limit", - "Count" - ], - "members":{ - "Limit":{ - "shape":"ReusableDelegationSetLimit", - "documentation":"

The current setting for the limit on hosted zones that you can associate with the specified reusable delegation set.

" - }, - "Count":{ - "shape":"UsageCount", - "documentation":"

The current number of hosted zones that you can associate with the specified reusable delegation set.

" - } - }, - "documentation":"

A complex type that contains the requested limit.

" - }, - "GetReusableDelegationSetRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the reusable delegation set that you want to get a list of name servers for.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

A request to get information about a specified reusable delegation set.

" - }, - "GetReusableDelegationSetResponse":{ - "type":"structure", - "required":["DelegationSet"], - "members":{ - "DelegationSet":{ - "shape":"DelegationSet", - "documentation":"

A complex type that contains information about the reusable delegation set.

" - } - }, - "documentation":"

A complex type that contains the response to the GetReusableDelegationSet request.

" - }, - "GetTrafficPolicyInstanceCountRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Request to get the number of traffic policy instances that are associated with the current AWS account.

" - }, - "GetTrafficPolicyInstanceCountResponse":{ - "type":"structure", - "required":["TrafficPolicyInstanceCount"], - "members":{ - "TrafficPolicyInstanceCount":{ - "shape":"TrafficPolicyInstanceCount", - "documentation":"

The number of traffic policy instances that are associated with the current AWS account.

" - } - }, - "documentation":"

A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.

" - }, - "GetTrafficPolicyInstanceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TrafficPolicyInstanceId", - "documentation":"

The ID of the traffic policy instance that you want to get information about.

", - "location":"uri", - "locationName":"Id" - } - }, - "documentation":"

Gets information about a specified traffic policy instance.

" - }, - "GetTrafficPolicyInstanceResponse":{ - "type":"structure", - "required":["TrafficPolicyInstance"], - "members":{ - "TrafficPolicyInstance":{ - "shape":"TrafficPolicyInstance", - "documentation":"

A complex type that contains settings for the traffic policy instance.

" - } - }, - "documentation":"

A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.

" - }, - "GetTrafficPolicyRequest":{ - "type":"structure", - "required":[ - "Id", - "Version" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy that you want to get information about.

", - "location":"uri", - "locationName":"Id" - }, - "Version":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version number of the traffic policy that you want to get information about.

", - "location":"uri", - "locationName":"Version" - } - }, - "documentation":"

Gets information about a specific traffic policy version.

" - }, - "GetTrafficPolicyResponse":{ - "type":"structure", - "required":["TrafficPolicy"], - "members":{ - "TrafficPolicy":{ - "shape":"TrafficPolicy", - "documentation":"

A complex type that contains settings for the specified traffic policy.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "HealthCheck":{ - "type":"structure", - "required":[ - "Id", - "CallerReference", - "HealthCheckConfig", - "HealthCheckVersion" - ], - "members":{ - "Id":{ - "shape":"HealthCheckId", - "documentation":"

The identifier that Amazon Route 53assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

" - }, - "CallerReference":{ - "shape":"HealthCheckNonce", - "documentation":"

A unique string that you specified when you created the health check.

" - }, - "LinkedService":{ - "shape":"LinkedService", - "documentation":"

If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

" - }, - "HealthCheckConfig":{ - "shape":"HealthCheckConfig", - "documentation":"

A complex type that contains detailed information about one health check.

" - }, - "HealthCheckVersion":{ - "shape":"HealthCheckVersion", - "documentation":"

The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

" - }, - "CloudWatchAlarmConfiguration":{ - "shape":"CloudWatchAlarmConfiguration", - "documentation":"

A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

" - } - }, - "documentation":"

A complex type that contains information about one health check that is associated with the current AWS account.

" - }, - "HealthCheckAlreadyExists":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The health check you're attempting to create already exists. Amazon Route 53 returns this error when you submit a request that has the following values:

  • The same value for CallerReference as an existing health check, and one or more values that differ from the existing health check that has the same caller reference.

  • The same value for CallerReference as a health check that you created and later deleted, regardless of the other settings in the request.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "HealthCheckConfig":{ - "type":"structure", - "required":["Type"], - "members":{ - "IPAddress":{ - "shape":"IPAddress", - "documentation":"

The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Amazon Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Amazon Route 53 then checks the health of the endpoint.

Use one of the following formats for the value of IPAddress:

  • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

  • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

If the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

For more information, see HealthCheckConfig$FullyQualifiedDomainName.

Constraints: Amazon Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create health checks, see the following documents:

When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on the endpoint on which you want Amazon Route 53 to perform health checks. Specify a value for Port only when you specify a value for IPAddress.

" - }, - "Type":{ - "shape":"HealthCheckType", - "documentation":"

The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

You can't change the value of Type after you create a health check.

You can create the following types of health checks:

  • HTTP: Amazon Route 53 tries to establish a TCP connection. If successful, Amazon Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

  • HTTPS: Amazon Route 53 tries to establish a TCP connection. If successful, Amazon Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

    If you specify HTTPS for the value of Type, the endpoint must support TLS v1.0 or later.

  • HTTP_STR_MATCH: Amazon Route 53 tries to establish a TCP connection. If successful, Amazon Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

  • HTTPS_STR_MATCH: Amazon Route 53 tries to establish a TCP connection. If successful, Amazon Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

  • TCP: Amazon Route 53 tries to establish a TCP connection.

  • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

  • CALCULATED: For health checks that monitor the status of other health checks, Amazon Route 53 adds up the number of health checks that Amazon Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

" - }, - "ResourcePath":{ - "shape":"ResourcePath", - "documentation":"

The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html.

" - }, - "FullyQualifiedDomainName":{ - "shape":"FullyQualifiedDomainName", - "documentation":"

Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

If you specify a value for IPAddress:

Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Amazon Route 53 to perform health checks.

When Amazon Route 53 checks the health of an endpoint, here is how it constructs the Host header:

  • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Amazon Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Amazon Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify another value for Port and any value except TCP for Type, Amazon Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

If you don't specify a value for FullyQualifiedDomainName, Amazon Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

If you don't specify a value for IPAddress :

Amazon Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Amazon Route 53 then checks the health of the endpoint.

If you don't specify a value for IPAddress, Amazon Route 53 uses only IPv4 to send health checks to the endpoint. If there's no resource record set with a type of A for the name that you specify for FullyQualifiedDomainName, the health check fails with a \"DNS resolution failed\" error.

If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

In this configuration, if you create a health check for which the value of FullyQualifiedDomainName matches the name of the resource record sets and you then associate the health check with those resource record sets, health check results will be unpredictable.

In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Amazon Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Amazon Route 53 doesn't pass a Host header.

" - }, - "SearchString":{ - "shape":"SearchString", - "documentation":"

If the value of Type is HTTP_STR_MATCH or HTTP_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Amazon Route 53 considers the resource healthy.

Amazon Route 53 considers case when searching for SearchString in the response body.

" - }, - "RequestInterval":{ - "shape":"RequestInterval", - "documentation":"

The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Amazon Route 53 health checker makes requests at this interval.

You can't change the value of RequestInterval after you create a health check.

If you don't specify a value for RequestInterval, the default value is 30 seconds.

" - }, - "FailureThreshold":{ - "shape":"FailureThreshold", - "documentation":"

The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

If you don't specify a value for FailureThreshold, the default value is three health checks.

" - }, - "MeasureLatency":{ - "shape":"MeasureLatency", - "documentation":"

Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Amazon Route 53 console.

You can't change the value of MeasureLatency after you create a health check.

" - }, - "Inverted":{ - "shape":"Inverted", - "documentation":"

Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

" - }, - "HealthThreshold":{ - "shape":"HealthThreshold", - "documentation":"

The number of child health checks that are associated with a CALCULATED health that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the HealthCheckConfig$ChildHealthChecks and HealthCheckConfig$ChildHealthChecks elements.

Note the following:

  • If you specify a number greater than the number of child health checks, Amazon Route 53 always considers this health check to be unhealthy.

  • If you specify 0, Amazon Route 53 always considers this health check to be healthy.

" - }, - "ChildHealthChecks":{ - "shape":"ChildHealthCheckList", - "documentation":"

(CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

" - }, - "EnableSNI":{ - "shape":"EnableSNI", - "documentation":"

Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

" - }, - "Regions":{ - "shape":"HealthCheckRegionList", - "documentation":"

A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

If you don't specify any regions, Amazon Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

If you update a health check to remove a region that has been performing health checks, Amazon Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

" - }, - "AlarmIdentifier":{ - "shape":"AlarmIdentifier", - "documentation":"

A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

" - }, - "InsufficientDataHealthStatus":{ - "shape":"InsufficientDataHealthStatus", - "documentation":"

When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

  • Healthy: Amazon Route 53 considers the health check to be healthy.

  • Unhealthy: Amazon Route 53 considers the health check to be unhealthy.

  • LastKnownStatus: Amazon Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

" - } - }, - "documentation":"

A complex type that contains information about the health check.

" - }, - "HealthCheckCount":{"type":"long"}, - "HealthCheckId":{ - "type":"string", - "max":64 - }, - "HealthCheckInUse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This error code is not in use.

", - "deprecated":true, - "error":{"httpStatusCode":400}, - "exception":true - }, - "HealthCheckNonce":{ - "type":"string", - "max":64, - "min":1 - }, - "HealthCheckObservation":{ - "type":"structure", - "members":{ - "Region":{ - "shape":"HealthCheckRegion", - "documentation":"

The region of the Amazon Route 53 health checker that provided the status in StatusReport.

" - }, - "IPAddress":{ - "shape":"IPAddress", - "documentation":"

The IP address of the Amazon Route 53 health checker that provided the failure reason in StatusReport.

" - }, - "StatusReport":{ - "shape":"StatusReport", - "documentation":"

A complex type that contains the last failure reason as reported by one Amazon Route 53 health checker and the time of the failed health check.

" - } - }, - "documentation":"

A complex type that contains the last failure reason as reported by one Amazon Route 53 health checker.

" - }, - "HealthCheckObservations":{ - "type":"list", - "member":{ - "shape":"HealthCheckObservation", - "locationName":"HealthCheckObservation" - } - }, - "HealthCheckRegion":{ - "type":"string", - "enum":[ - "us-east-1", - "us-west-1", - "us-west-2", - "eu-west-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1", - "sa-east-1" - ], - "max":64, - "min":1 - }, - "HealthCheckRegionList":{ - "type":"list", - "member":{ - "shape":"HealthCheckRegion", - "locationName":"Region" - }, - "max":64, - "min":3 - }, - "HealthCheckType":{ - "type":"string", - "enum":[ - "HTTP", - "HTTPS", - "HTTP_STR_MATCH", - "HTTPS_STR_MATCH", - "TCP", - "CALCULATED", - "CLOUDWATCH_METRIC" - ] - }, - "HealthCheckVersion":{ - "type":"long", - "min":1 - }, - "HealthCheckVersionMismatch":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The value of HealthCheckVersion in the request doesn't match the value of HealthCheckVersion in the health check.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "HealthChecks":{ - "type":"list", - "member":{ - "shape":"HealthCheck", - "locationName":"HealthCheck" - } - }, - "HealthThreshold":{ - "type":"integer", - "max":256, - "min":0 - }, - "HostedZone":{ - "type":"structure", - "required":[ - "Id", - "Name", - "CallerReference" - ], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID that Amazon Route 53 assigned to the hosted zone when you created it.

" - }, - "Name":{ - "shape":"DNSName", - "documentation":"

The name of the domain. For public hosted zones, this is the name that you have registered with your DNS registrar.

For information about how to specify characters other than a-z, 0-9, and - (hyphen) and how to specify internationalized domain names, see CreateHostedZone.

" - }, - "CallerReference":{ - "shape":"Nonce", - "documentation":"

The value that you specified for CallerReference when you created the hosted zone.

" - }, - "Config":{ - "shape":"HostedZoneConfig", - "documentation":"

A complex type that includes the Comment and PrivateZone elements. If you omitted the HostedZoneConfig and Comment elements from the request, the Config and Comment elements don't appear in the response.

" - }, - "ResourceRecordSetCount":{ - "shape":"HostedZoneRRSetCount", - "documentation":"

The number of resource record sets in the hosted zone.

" - }, - "LinkedService":{ - "shape":"LinkedService", - "documentation":"

If the hosted zone was created by another service, the service that created the hosted zone. When a hosted zone is created by another service, you can't edit or delete it using Amazon Route 53.

" - } - }, - "documentation":"

A complex type that contains general information about the hosted zone.

" - }, - "HostedZoneAlreadyExists":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The hosted zone you're trying to create already exists. Amazon Route 53 returns this error when a hosted zone has already been created with the specified CallerReference.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "HostedZoneConfig":{ - "type":"structure", - "members":{ - "Comment":{ - "shape":"ResourceDescription", - "documentation":"

Any comments that you want to include about the hosted zone.

" - }, - "PrivateZone":{ - "shape":"IsPrivateZone", - "documentation":"

A value that indicates whether this is a private hosted zone.

" - } - }, - "documentation":"

A complex type that contains an optional comment about your hosted zone. If you don't want to specify a comment, omit both the HostedZoneConfig and Comment elements.

" - }, - "HostedZoneCount":{"type":"long"}, - "HostedZoneLimit":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"HostedZoneLimitType", - "documentation":"

The limit that you requested. Valid values include the following:

  • MAX_RRSETS_BY_ZONE: The maximum number of records that you can create in the specified hosted zone.

  • MAX_VPCS_ASSOCIATED_BY_ZONE: The maximum number of Amazon VPCs that you can associate with the specified private hosted zone.

" - }, - "Value":{ - "shape":"LimitValue", - "documentation":"

The current value for the limit that is specified by Type.

" - } - }, - "documentation":"

A complex type that contains the type of limit that you specified in the request and the current value for that limit.

" - }, - "HostedZoneLimitType":{ - "type":"string", - "enum":[ - "MAX_RRSETS_BY_ZONE", - "MAX_VPCS_ASSOCIATED_BY_ZONE" - ] - }, - "HostedZoneNotEmpty":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The hosted zone contains resource records that are not SOA or NS records.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "HostedZoneNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified HostedZone can't be found.

", - "exception":true - }, - "HostedZoneNotPrivate":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified hosted zone is a public hosted zone, not a private hosted zone.

", - "exception":true - }, - "HostedZoneRRSetCount":{"type":"long"}, - "HostedZones":{ - "type":"list", - "member":{ - "shape":"HostedZone", - "locationName":"HostedZone" - } - }, - "IPAddress":{ - "type":"string", - "max":45, - "pattern":"(^((([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]))$|^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$)" - }, - "IPAddressCidr":{"type":"string"}, - "IncompatibleVersion":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The resource you're trying to access is unsupported on this Amazon Route 53 endpoint.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InsufficientCloudWatchLogsResourcePolicy":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Amazon Route 53 doesn't have the permissions required to create log streams and send query logs to log streams. Possible causes include the following:

  • There is no resource policy that specifies the log group ARN in the value for Resource.

  • The resource policy that includes the log group ARN in the value for Resource doesn't have the necessary permissions.

  • The resource policy hasn't finished propagating yet.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InsufficientDataHealthStatus":{ - "type":"string", - "enum":[ - "Healthy", - "Unhealthy", - "LastKnownStatus" - ] - }, - "InvalidArgument":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

Parameter name is invalid.

", - "exception":true - }, - "InvalidChangeBatch":{ - "type":"structure", - "members":{ - "messages":{ - "shape":"ErrorMessages", - "documentation":"

Descriptive message for the error response.

" - }, - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

This exception contains a list of messages that might contain one or more error messages. Each error message indicates one error in the change batch.

", - "exception":true - }, - "InvalidDomainName":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified domain name is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidInput":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The input is not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidPaginationToken":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The value that you specified to get the second or subsequent page of results is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidTrafficPolicyDocument":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The format of the traffic policy document that you specified in the Document element is invalid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidVPCId":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access this VPC.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "Inverted":{"type":"boolean"}, - "IsPrivateZone":{"type":"boolean"}, - "LastVPCAssociation":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The VPC that you're trying to disassociate from the private hosted zone is the last VPC that is associated with the hosted zone. Amazon Route 53 doesn't support disassociating the last VPC from a hosted zone.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "LimitValue":{ - "type":"long", - "min":1 - }, - "LimitsExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This operation can't be completed either because the current account has reached the limit on reusable delegation sets that it can create or because you've reached the limit on the number of Amazon VPCs that you can associate with a private hosted zone. To get the current limit on the number of reusable delegation sets, see GetAccountLimit. To get the current limit on the number of Amazon VPCs that you can associate with a private hosted zone, see GetHostedZoneLimit. To request a higher limit, create a case with the AWS Support Center.

", - "exception":true - }, - "LinkedService":{ - "type":"structure", - "members":{ - "ServicePrincipal":{ - "shape":"ServicePrincipal", - "documentation":"

If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

" - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

" - } - }, - "documentation":"

If a health check or hosted zone was created by another service, LinkedService is a complex type that describes the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

" - }, - "ListGeoLocationsRequest":{ - "type":"structure", - "members":{ - "StartContinentCode":{ - "shape":"GeoLocationContinentCode", - "documentation":"

The code for the continent with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Amazon Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextContinentCode from the previous response has a value, enter that value in StartContinentCode to return the next page of results.

Include StartContinentCode only if you want to list continents. Don't include StartContinentCode when you're listing countries or countries with their subdivisions.

", - "location":"querystring", - "locationName":"startcontinentcode" - }, - "StartCountryCode":{ - "shape":"GeoLocationCountryCode", - "documentation":"

The code for the country with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Amazon Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextCountryCode from the previous response has a value, enter that value in StartCountryCode to return the next page of results.

Amazon Route 53 uses the two-letter country codes that are specified in ISO standard 3166-1 alpha-2.

", - "location":"querystring", - "locationName":"startcountrycode" - }, - "StartSubdivisionCode":{ - "shape":"GeoLocationSubdivisionCode", - "documentation":"

The code for the subdivision (for example, state or province) with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Amazon Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextSubdivisionCode from the previous response has a value, enter that value in StartSubdivisionCode to return the next page of results.

To list subdivisions of a country, you must include both StartCountryCode and StartSubdivisionCode.

", - "location":"querystring", - "locationName":"startsubdivisioncode" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

(Optional) The maximum number of geolocations to be included in the response body for this request. If more than MaxItems geolocations remain to be listed, then the value of the IsTruncated element in the response is true.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request to get a list of geographic locations that Amazon Route 53 supports for geolocation resource record sets.

" - }, - "ListGeoLocationsResponse":{ - "type":"structure", - "required":[ - "GeoLocationDetailsList", - "IsTruncated", - "MaxItems" - ], - "members":{ - "GeoLocationDetailsList":{ - "shape":"GeoLocationDetailsList", - "documentation":"

A complex type that contains one GeoLocationDetails element for each location that Amazon Route 53 supports for geolocation.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A value that indicates whether more locations remain to be listed after the last location in this response. If so, the value of IsTruncated is true. To get more values, submit another request and include the values of NextContinentCode, NextCountryCode, and NextSubdivisionCode in the StartContinentCode, StartCountryCode, and StartSubdivisionCode, as applicable.

" - }, - "NextContinentCode":{ - "shape":"GeoLocationContinentCode", - "documentation":"

If IsTruncated is true, you can make a follow-up request to display more locations. Enter the value of NextContinentCode in the StartContinentCode parameter in another ListGeoLocations request.

" - }, - "NextCountryCode":{ - "shape":"GeoLocationCountryCode", - "documentation":"

If IsTruncated is true, you can make a follow-up request to display more locations. Enter the value of NextCountryCode in the StartCountryCode parameter in another ListGeoLocations request.

" - }, - "NextSubdivisionCode":{ - "shape":"GeoLocationSubdivisionCode", - "documentation":"

If IsTruncated is true, you can make a follow-up request to display more locations. Enter the value of NextSubdivisionCode in the StartSubdivisionCode parameter in another ListGeoLocations request.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for MaxItems in the request.

" - } - }, - "documentation":"

A complex type containing the response information for the request.

" - }, - "ListHealthChecksRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"PageMarker", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more health checks. To get another group, submit another ListHealthChecks request.

For the value of marker, specify the value of NextMarker from the previous response, which is the ID of the first health check that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more health checks to get.

", - "location":"querystring", - "locationName":"marker" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of health checks that you want ListHealthChecks to return in response to the current request. Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100 health checks.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request to retrieve a list of the health checks that are associated with the current AWS account.

" - }, - "ListHealthChecksResponse":{ - "type":"structure", - "required":[ - "HealthChecks", - "Marker", - "IsTruncated", - "MaxItems" - ], - "members":{ - "HealthChecks":{ - "shape":"HealthChecks", - "documentation":"

A complex type that contains one HealthCheck element for each health check that is associated with the current AWS account.

" - }, - "Marker":{ - "shape":"PageMarker", - "documentation":"

For the second and subsequent calls to ListHealthChecks, Marker is the value that you specified for the marker parameter in the previous request.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more health checks to be listed. If the response was truncated, you can get the next group of health checks by submitting another ListHealthChecks request and specifying the value of NextMarker in the marker parameter.

" - }, - "NextMarker":{ - "shape":"PageMarker", - "documentation":"

If IsTruncated is true, the value of NextMarker identifies the first health check that Amazon Route 53 returns if you submit another ListHealthChecks request and specify the value of NextMarker in the marker parameter.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the maxitems parameter in the call to ListHealthChecks that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response to a ListHealthChecks request.

" - }, - "ListHostedZonesByNameRequest":{ - "type":"structure", - "members":{ - "DNSName":{ - "shape":"DNSName", - "documentation":"

(Optional) For your first request to ListHostedZonesByName, include the dnsname parameter only if you want to specify the name of the first hosted zone in the response. If you don't include the dnsname parameter, Amazon Route 53 returns all of the hosted zones that were created by the current AWS account, in ASCII order. For subsequent requests, include both dnsname and hostedzoneid parameters. For dnsname, specify the value of NextDNSName from the previous response.

", - "location":"querystring", - "locationName":"dnsname" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

(Optional) For your first request to ListHostedZonesByName, do not include the hostedzoneid parameter.

If you have more hosted zones than the value of maxitems, ListHostedZonesByName returns only the first maxitems hosted zones. To get the next group of maxitems hosted zones, submit another request to ListHostedZonesByName and include both dnsname and hostedzoneid parameters. For the value of hostedzoneid, specify the value of the NextHostedZoneId element from the previous response.

", - "location":"querystring", - "locationName":"hostedzoneid" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of hosted zones to be included in the response body for this request. If you have more than maxitems hosted zones, then the value of the IsTruncated element in the response is true, and the values of NextDNSName and NextHostedZoneId specify the first hosted zone in the next group of maxitems hosted zones.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

Retrieves a list of the public and private hosted zones that are associated with the current AWS account in ASCII order by domain name.

" - }, - "ListHostedZonesByNameResponse":{ - "type":"structure", - "required":[ - "HostedZones", - "IsTruncated", - "MaxItems" - ], - "members":{ - "HostedZones":{ - "shape":"HostedZones", - "documentation":"

A complex type that contains general information about the hosted zone.

" - }, - "DNSName":{ - "shape":"DNSName", - "documentation":"

For the second and subsequent calls to ListHostedZonesByName, DNSName is the value that you specified for the dnsname parameter in the request that produced the current response.

" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID that Amazon Route 53 assigned to the hosted zone when you created it.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more hosted zones to be listed. If the response was truncated, you can get the next group of maxitems hosted zones by calling ListHostedZonesByName again and specifying the values of NextDNSName and NextHostedZoneId elements in the dnsname and hostedzoneid parameters.

" - }, - "NextDNSName":{ - "shape":"DNSName", - "documentation":"

If IsTruncated is true, the value of NextDNSName is the name of the first hosted zone in the next group of maxitems hosted zones. Call ListHostedZonesByName again and specify the value of NextDNSName and NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

This element is present only if IsTruncated is true.

" - }, - "NextHostedZoneId":{ - "shape":"ResourceId", - "documentation":"

If IsTruncated is true, the value of NextHostedZoneId identifies the first hosted zone in the next group of maxitems hosted zones. Call ListHostedZonesByName again and specify the value of NextDNSName and NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

This element is present only if IsTruncated is true.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the maxitems parameter in the call to ListHostedZonesByName that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListHostedZonesRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"PageMarker", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more hosted zones. To get more hosted zones, submit another ListHostedZones request.

For the value of marker, specify the value of NextMarker from the previous response, which is the ID of the first hosted zone that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more hosted zones to get.

", - "location":"querystring", - "locationName":"marker" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

(Optional) The maximum number of hosted zones that you want Amazon Route 53 to return. If you have more than maxitems hosted zones, the value of IsTruncated in the response is true, and the value of NextMarker is the hosted zone ID of the first hosted zone that Amazon Route 53 will return if you submit another request.

", - "location":"querystring", - "locationName":"maxitems" - }, - "DelegationSetId":{ - "shape":"ResourceId", - "documentation":"

If you're using reusable delegation sets and you want to list all of the hosted zones that are associated with a reusable delegation set, specify the ID of that reusable delegation set.

", - "location":"querystring", - "locationName":"delegationsetid" - } - }, - "documentation":"

A request to retrieve a list of the public and private hosted zones that are associated with the current AWS account.

" - }, - "ListHostedZonesResponse":{ - "type":"structure", - "required":[ - "HostedZones", - "Marker", - "IsTruncated", - "MaxItems" - ], - "members":{ - "HostedZones":{ - "shape":"HostedZones", - "documentation":"

A complex type that contains general information about the hosted zone.

" - }, - "Marker":{ - "shape":"PageMarker", - "documentation":"

For the second and subsequent calls to ListHostedZones, Marker is the value that you specified for the marker parameter in the request that produced the current response.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag indicating whether there are more hosted zones to be listed. If the response was truncated, you can get more hosted zones by submitting another ListHostedZones request and specifying the value of NextMarker in the marker parameter.

" - }, - "NextMarker":{ - "shape":"PageMarker", - "documentation":"

If IsTruncated is true, the value of NextMarker identifies the first hosted zone in the next group of hosted zones. Submit another ListHostedZones request, and specify the value of NextMarker from the response in the marker parameter.

This element is present only if IsTruncated is true.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the maxitems parameter in the call to ListHostedZones that produced the current response.

" - } - } - }, - "ListQueryLoggingConfigsRequest":{ - "type":"structure", - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

(Optional) If you want to list the query logging configuration that is associated with a hosted zone, specify the ID in HostedZoneId.

If you don't specify a hosted zone ID, ListQueryLoggingConfigs returns all of the configurations that are associated with the current AWS account.

", - "location":"querystring", - "locationName":"hostedzoneid" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

(Optional) If the current AWS account has more than MaxResults query logging configurations, use NextToken to get the second and subsequent pages of results.

For the first ListQueryLoggingConfigs request, omit this value.

For the second and subsequent requests, get the value of NextToken from the previous response and specify that value for NextToken in the request.

", - "location":"querystring", - "locationName":"nexttoken" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

(Optional) The maximum number of query logging configurations that you want Amazon Route 53 to return in response to the current request. If the current AWS account has more than MaxResults configurations, use the value of ListQueryLoggingConfigsResponse$NextToken in the response to get the next page of results.

If you don't specify a value for MaxResults, Amazon Route 53 returns up to 100 configurations.

", - "location":"querystring", - "locationName":"maxresults" - } - } - }, - "ListQueryLoggingConfigsResponse":{ - "type":"structure", - "required":["QueryLoggingConfigs"], - "members":{ - "QueryLoggingConfigs":{ - "shape":"QueryLoggingConfigs", - "documentation":"

An array that contains one QueryLoggingConfig element for each configuration for DNS query logging that is associated with the current AWS account.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If a response includes the last of the query logging configurations that are associated with the current AWS account, NextToken doesn't appear in the response.

If a response doesn't include the last of the configurations, you can get more configurations by submitting another ListQueryLoggingConfigs request. Get the value of NextToken that Amazon Route 53 returned in the previous response and include it in NextToken in the next request.

" - } - } - }, - "ListResourceRecordSetsRequest":{ - "type":"structure", - "required":["HostedZoneId"], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that contains the resource record sets that you want to list.

", - "location":"uri", - "locationName":"Id" - }, - "StartRecordName":{ - "shape":"DNSName", - "documentation":"

The first name in the lexicographic ordering of resource record sets that you want to list.

", - "location":"querystring", - "locationName":"name" - }, - "StartRecordType":{ - "shape":"RRType", - "documentation":"

The type of resource record set to begin the record listing from.

Valid values for basic resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | NS | PTR | SOA | SPF | SRV | TXT

Values for weighted, latency, geo, and failover resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT

Values for alias resource record sets:

  • CloudFront distribution: A or AAAA

  • Elastic Beanstalk environment that has a regionalized subdomain: A

  • ELB load balancer: A | AAAA

  • Amazon S3 bucket: A

  • Another resource record set in this hosted zone: The type of the resource record set that the alias references.

Constraint: Specifying type without specifying name returns an InvalidInput error.

", - "location":"querystring", - "locationName":"type" - }, - "StartRecordIdentifier":{ - "shape":"ResourceRecordSetIdentifier", - "documentation":"

Weighted resource record sets only: If results were truncated for a given DNS name and type, specify the value of NextRecordIdentifier from the previous response to get the next resource record set that has the current DNS name and type.

", - "location":"querystring", - "locationName":"identifier" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

(Optional) The maximum number of resource records sets to include in the response body for this request. If the response includes more than maxitems resource record sets, the value of the IsTruncated element in the response is true, and the values of the NextRecordName and NextRecordType elements in the response identify the first resource record set in the next group of maxitems resource record sets.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request for the resource record sets that are associated with a specified hosted zone.

" - }, - "ListResourceRecordSetsResponse":{ - "type":"structure", - "required":[ - "ResourceRecordSets", - "IsTruncated", - "MaxItems" - ], - "members":{ - "ResourceRecordSets":{ - "shape":"ResourceRecordSets", - "documentation":"

Information about multiple resource record sets.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether more resource record sets remain to be listed. If your results were truncated, you can make a follow-up pagination request by using the NextRecordName element.

" - }, - "NextRecordName":{ - "shape":"DNSName", - "documentation":"

If the results were truncated, the name of the next record in the list.

This element is present only if IsTruncated is true.

" - }, - "NextRecordType":{ - "shape":"RRType", - "documentation":"

If the results were truncated, the type of the next record in the list.

This element is present only if IsTruncated is true.

" - }, - "NextRecordIdentifier":{ - "shape":"ResourceRecordSetIdentifier", - "documentation":"

Weighted, latency, geolocation, and failover resource record sets only: If results were truncated for a given DNS name and type, the value of SetIdentifier for the next resource record set that has the current DNS name and type.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of records you requested.

" - } - }, - "documentation":"

A complex type that contains list information for the resource record set.

" - }, - "ListReusableDelegationSetsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"PageMarker", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more reusable delegation sets. To get another group, submit another ListReusableDelegationSets request.

For the value of marker, specify the value of NextMarker from the previous response, which is the ID of the first reusable delegation set that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more reusable delegation sets to get.

", - "location":"querystring", - "locationName":"marker" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The number of reusable delegation sets that you want Amazon Route 53 to return in the response to this request. If you specify a value greater than 100, Amazon Route 53 returns only the first 100 reusable delegation sets.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request to get a list of the reusable delegation sets that are associated with the current AWS account.

" - }, - "ListReusableDelegationSetsResponse":{ - "type":"structure", - "required":[ - "DelegationSets", - "Marker", - "IsTruncated", - "MaxItems" - ], - "members":{ - "DelegationSets":{ - "shape":"DelegationSets", - "documentation":"

A complex type that contains one DelegationSet element for each reusable delegation set that was created by the current AWS account.

" - }, - "Marker":{ - "shape":"PageMarker", - "documentation":"

For the second and subsequent calls to ListReusableDelegationSets, Marker is the value that you specified for the marker parameter in the request that produced the current response.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more reusable delegation sets to be listed.

" - }, - "NextMarker":{ - "shape":"PageMarker", - "documentation":"

If IsTruncated is true, the value of NextMarker identifies the next reusable delegation set that Amazon Route 53 will return if you submit another ListReusableDelegationSets request and specify the value of NextMarker in the marker parameter.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the maxitems parameter in the call to ListReusableDelegationSets that produced the current response.

" - } - }, - "documentation":"

A complex type that contains information about the reusable delegation sets that are associated with the current AWS account.

" - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId" - ], - "members":{ - "ResourceType":{ - "shape":"TagResourceType", - "documentation":"

The type of the resource.

  • The resource type for health checks is healthcheck.

  • The resource type for hosted zones is hostedzone.

", - "location":"uri", - "locationName":"ResourceType" - }, - "ResourceId":{ - "shape":"TagResourceId", - "documentation":"

The ID of the resource for which you want to retrieve tags.

", - "location":"uri", - "locationName":"ResourceId" - } - }, - "documentation":"

A complex type containing information about a request for a list of the tags that are associated with an individual resource.

" - }, - "ListTagsForResourceResponse":{ - "type":"structure", - "required":["ResourceTagSet"], - "members":{ - "ResourceTagSet":{ - "shape":"ResourceTagSet", - "documentation":"

A ResourceTagSet containing tags associated with the specified resource.

" - } - }, - "documentation":"

A complex type that contains information about the health checks or hosted zones for which you want to list tags.

" - }, - "ListTagsForResourcesRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceIds" - ], - "members":{ - "ResourceType":{ - "shape":"TagResourceType", - "documentation":"

The type of the resources.

  • The resource type for health checks is healthcheck.

  • The resource type for hosted zones is hostedzone.

", - "location":"uri", - "locationName":"ResourceType" - }, - "ResourceIds":{ - "shape":"TagResourceIdList", - "documentation":"

A complex type that contains the ResourceId element for each resource for which you want to get a list of tags.

" - } - }, - "documentation":"

A complex type that contains information about the health checks or hosted zones for which you want to list tags.

" - }, - "ListTagsForResourcesResponse":{ - "type":"structure", - "required":["ResourceTagSets"], - "members":{ - "ResourceTagSets":{ - "shape":"ResourceTagSetList", - "documentation":"

A list of ResourceTagSets containing tags associated with the specified resources.

" - } - }, - "documentation":"

A complex type containing tags for the specified resources.

" - }, - "ListTrafficPoliciesRequest":{ - "type":"structure", - "members":{ - "TrafficPolicyIdMarker":{ - "shape":"TrafficPolicyId", - "documentation":"

(Conditional) For your first request to ListTrafficPolicies, don't include the TrafficPolicyIdMarker parameter.

If you have more traffic policies than the value of MaxItems, ListTrafficPolicies returns only the first MaxItems traffic policies. To get the next group of policies, submit another request to ListTrafficPolicies. For the value of TrafficPolicyIdMarker, specify the value of TrafficPolicyIdMarker that was returned in the previous response.

", - "location":"querystring", - "locationName":"trafficpolicyid" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

(Optional) The maximum number of traffic policies that you want Amazon Route 53 to return in response to this request. If you have more than MaxItems traffic policies, the value of IsTruncated in the response is true, and the value of TrafficPolicyIdMarker is the ID of the first traffic policy that Amazon Route 53 will return if you submit another request.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A complex type that contains the information about the request to list the traffic policies that are associated with the current AWS account.

" - }, - "ListTrafficPoliciesResponse":{ - "type":"structure", - "required":[ - "TrafficPolicySummaries", - "IsTruncated", - "TrafficPolicyIdMarker", - "MaxItems" - ], - "members":{ - "TrafficPolicySummaries":{ - "shape":"TrafficPolicySummaries", - "documentation":"

A list that contains one TrafficPolicySummary element for each traffic policy that was created by the current AWS account.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more traffic policies to be listed. If the response was truncated, you can get the next group of traffic policies by submitting another ListTrafficPolicies request and specifying the value of TrafficPolicyIdMarker in the TrafficPolicyIdMarker request parameter.

" - }, - "TrafficPolicyIdMarker":{ - "shape":"TrafficPolicyId", - "documentation":"

If the value of IsTruncated is true, TrafficPolicyIdMarker is the ID of the first traffic policy in the next group of MaxItems traffic policies.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the MaxItems parameter in the ListTrafficPolicies request that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListTrafficPolicyInstancesByHostedZoneRequest":{ - "type":"structure", - "required":["HostedZoneId"], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you want to list traffic policy instances for.

", - "location":"querystring", - "locationName":"id" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If the value of IsTruncated in the previous response is true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstances request. For the value of trafficpolicyinstancename, specify the value of TrafficPolicyInstanceNameMarker from the previous response, which is the name of the first traffic policy instance in the next group of traffic policy instances.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancename" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If the value of IsTruncated in the previous response is true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstances request. For the value of trafficpolicyinstancetype, specify the value of TrafficPolicyInstanceTypeMarker from the previous response, which is the type of the first traffic policy instance in the next group of traffic policy instances.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancetype" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems traffic policy instances, the value of the IsTruncated element in the response is true, and the values of HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker represent the first traffic policy instance that Amazon Route 53 will return if you submit another request.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request for the traffic policy instances that you created in a specified hosted zone.

" - }, - "ListTrafficPolicyInstancesByHostedZoneResponse":{ - "type":"structure", - "required":[ - "TrafficPolicyInstances", - "IsTruncated", - "MaxItems" - ], - "members":{ - "TrafficPolicyInstances":{ - "shape":"TrafficPolicyInstances", - "documentation":"

A list that contains one TrafficPolicyInstance element for each traffic policy instance that matches the elements in the request.

" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of traffic policy instances.

" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceTypeMarker is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of traffic policy instances.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of traffic policy instances by submitting another ListTrafficPolicyInstancesByHostedZone request and specifying the values of HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker in the corresponding request parameters.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the MaxItems parameter in the ListTrafficPolicyInstancesByHostedZone request that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListTrafficPolicyInstancesByPolicyRequest":{ - "type":"structure", - "required":[ - "TrafficPolicyId", - "TrafficPolicyVersion" - ], - "members":{ - "TrafficPolicyId":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy for which you want to list traffic policy instances.

", - "location":"querystring", - "locationName":"id" - }, - "TrafficPolicyVersion":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version of the traffic policy for which you want to list traffic policy instances. The version must be associated with the traffic policy that is specified by TrafficPolicyId.

", - "location":"querystring", - "locationName":"version" - }, - "HostedZoneIdMarker":{ - "shape":"ResourceId", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstancesByPolicy request.

For the value of hostedzoneid, specify the value of HostedZoneIdMarker from the previous response, which is the hosted zone ID of the first traffic policy instance that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"hostedzoneid" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstancesByPolicy request.

For the value of trafficpolicyinstancename, specify the value of TrafficPolicyInstanceNameMarker from the previous response, which is the name of the first traffic policy instance that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancename" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstancesByPolicy request.

For the value of trafficpolicyinstancetype, specify the value of TrafficPolicyInstanceTypeMarker from the previous response, which is the name of the first traffic policy instance that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancetype" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems traffic policy instances, the value of the IsTruncated element in the response is true, and the values of HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker represent the first traffic policy instance that Amazon Route 53 will return if you submit another request.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A complex type that contains the information about the request to list your traffic policy instances.

" - }, - "ListTrafficPolicyInstancesByPolicyResponse":{ - "type":"structure", - "required":[ - "TrafficPolicyInstances", - "IsTruncated", - "MaxItems" - ], - "members":{ - "TrafficPolicyInstances":{ - "shape":"TrafficPolicyInstances", - "documentation":"

A list that contains one TrafficPolicyInstance element for each traffic policy instance that matches the elements in the request.

" - }, - "HostedZoneIdMarker":{ - "shape":"ResourceId", - "documentation":"

If IsTruncated is true, HostedZoneIdMarker is the ID of the hosted zone of the first traffic policy instance in the next group of traffic policy instances.

" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of MaxItems traffic policy instances.

" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceTypeMarker is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems traffic policy instances.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of traffic policy instances by calling ListTrafficPolicyInstancesByPolicy again and specifying the values of the HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker elements in the corresponding request parameters.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the MaxItems parameter in the call to ListTrafficPolicyInstancesByPolicy that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListTrafficPolicyInstancesRequest":{ - "type":"structure", - "members":{ - "HostedZoneIdMarker":{ - "shape":"ResourceId", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstances request. For the value of HostedZoneId, specify the value of HostedZoneIdMarker from the previous response, which is the hosted zone ID of the first traffic policy instance in the next group of traffic policy instances.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"hostedzoneid" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstances request. For the value of trafficpolicyinstancename, specify the value of TrafficPolicyInstanceNameMarker from the previous response, which is the name of the first traffic policy instance in the next group of traffic policy instances.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancename" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If the value of IsTruncated in the previous response was true, you have more traffic policy instances. To get more traffic policy instances, submit another ListTrafficPolicyInstances request. For the value of trafficpolicyinstancetype, specify the value of TrafficPolicyInstanceTypeMarker from the previous response, which is the type of the first traffic policy instance in the next group of traffic policy instances.

If the value of IsTruncated in the previous response was false, there are no more traffic policy instances to get.

", - "location":"querystring", - "locationName":"trafficpolicyinstancetype" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of traffic policy instances that you want Amazon Route 53 to return in response to a ListTrafficPolicyInstances request. If you have more than MaxItems traffic policy instances, the value of the IsTruncated element in the response is true, and the values of HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker represent the first traffic policy instance in the next group of MaxItems traffic policy instances.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A request to get information about the traffic policy instances that you created by using the current AWS account.

" - }, - "ListTrafficPolicyInstancesResponse":{ - "type":"structure", - "required":[ - "TrafficPolicyInstances", - "IsTruncated", - "MaxItems" - ], - "members":{ - "TrafficPolicyInstances":{ - "shape":"TrafficPolicyInstances", - "documentation":"

A list that contains one TrafficPolicyInstance element for each traffic policy instance that matches the elements in the request.

" - }, - "HostedZoneIdMarker":{ - "shape":"ResourceId", - "documentation":"

If IsTruncated is true, HostedZoneIdMarker is the ID of the hosted zone of the first traffic policy instance that Amazon Route 53 will return if you submit another ListTrafficPolicyInstances request.

" - }, - "TrafficPolicyInstanceNameMarker":{ - "shape":"DNSName", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance that Amazon Route 53 will return if you submit another ListTrafficPolicyInstances request.

" - }, - "TrafficPolicyInstanceTypeMarker":{ - "shape":"RRType", - "documentation":"

If IsTruncated is true, TrafficPolicyInstanceTypeMarker is the DNS type of the resource record sets that are associated with the first traffic policy instance that Amazon Route 53 will return if you submit another ListTrafficPolicyInstances request.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get more traffic policy instances by calling ListTrafficPolicyInstances again and specifying the values of the HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker in the corresponding request parameters.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the MaxItems parameter in the call to ListTrafficPolicyInstances that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListTrafficPolicyVersionsRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

Specify the value of Id of the traffic policy for which you want to list all versions.

", - "location":"uri", - "locationName":"Id" - }, - "TrafficPolicyVersionMarker":{ - "shape":"TrafficPolicyVersionMarker", - "documentation":"

For your first request to ListTrafficPolicyVersions, don't include the TrafficPolicyVersionMarker parameter.

If you have more traffic policy versions than the value of MaxItems, ListTrafficPolicyVersions returns only the first group of MaxItems versions. To get more traffic policy versions, submit another ListTrafficPolicyVersions request. For the value of TrafficPolicyVersionMarker, specify the value of TrafficPolicyVersionMarker in the previous response.

", - "location":"querystring", - "locationName":"trafficpolicyversion" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The maximum number of traffic policy versions that you want Amazon Route 53 to include in the response body for this request. If the specified traffic policy has more than MaxItems versions, the value of IsTruncated in the response is true, and the value of the TrafficPolicyVersionMarker element is the ID of the first version that Amazon Route 53 will return if you submit another request.

", - "location":"querystring", - "locationName":"maxitems" - } - }, - "documentation":"

A complex type that contains the information about the request to list your traffic policies.

" - }, - "ListTrafficPolicyVersionsResponse":{ - "type":"structure", - "required":[ - "TrafficPolicies", - "IsTruncated", - "TrafficPolicyVersionMarker", - "MaxItems" - ], - "members":{ - "TrafficPolicies":{ - "shape":"TrafficPolicies", - "documentation":"

A list that contains one TrafficPolicy element for each traffic policy version that is associated with the specified traffic policy.

" - }, - "IsTruncated":{ - "shape":"PageTruncated", - "documentation":"

A flag that indicates whether there are more traffic policies to be listed. If the response was truncated, you can get the next group of traffic policies by submitting another ListTrafficPolicyVersions request and specifying the value of NextMarker in the marker parameter.

" - }, - "TrafficPolicyVersionMarker":{ - "shape":"TrafficPolicyVersionMarker", - "documentation":"

If IsTruncated is true, the value of TrafficPolicyVersionMarker identifies the first traffic policy that Amazon Route 53 will return if you submit another request. Call ListTrafficPolicyVersions again and specify the value of TrafficPolicyVersionMarker in the TrafficPolicyVersionMarker request parameter.

This element is present only if IsTruncated is true.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The value that you specified for the maxitems parameter in the ListTrafficPolicyVersions request that produced the current response.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "ListVPCAssociationAuthorizationsRequest":{ - "type":"structure", - "required":["HostedZoneId"], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone for which you want a list of VPCs that can be associated with the hosted zone.

", - "location":"uri", - "locationName":"Id" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

Optional: If a response includes a NextToken element, there are more VPCs that can be associated with the specified hosted zone. To get the next page of results, submit another request, and include the value of NextToken from the response in the nexttoken parameter in another ListVPCAssociationAuthorizations request.

", - "location":"querystring", - "locationName":"nexttoken" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

Optional: An integer that specifies the maximum number of VPCs that you want Amazon Route 53 to return. If you don't specify a value for MaxResults, Amazon Route 53 returns up to 50 VPCs per page.

", - "location":"querystring", - "locationName":"maxresults" - } - }, - "documentation":"

A complex type that contains information about that can be associated with your hosted zone.

" - }, - "ListVPCAssociationAuthorizationsResponse":{ - "type":"structure", - "required":[ - "HostedZoneId", - "VPCs" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you can associate the listed VPCs with.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

When the response includes a NextToken element, there are more VPCs that can be associated with the specified hosted zone. To get the next page of VPCs, submit another ListVPCAssociationAuthorizations request, and include the value of the NextToken element from the response in the nexttoken request parameter.

" - }, - "VPCs":{ - "shape":"VPCs", - "documentation":"

The list of VPCs that are authorized to be associated with the specified hosted zone.

" - } - }, - "documentation":"

A complex type that contains the response information for the request.

" - }, - "MaxResults":{"type":"string"}, - "MeasureLatency":{"type":"boolean"}, - "Message":{ - "type":"string", - "max":1024 - }, - "MetricName":{ - "type":"string", - "max":255, - "min":1 - }, - "Nameserver":{ - "type":"string", - "max":255, - "min":0 - }, - "Namespace":{ - "type":"string", - "max":255, - "min":1 - }, - "NoSuchChange":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

A change with the specified change ID does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchCloudWatchLogsLogGroup":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

There is no CloudWatch Logs log group with the specified ARN.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchDelegationSet":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

A reusable delegation set with the specified ID does not exist.

", - "exception":true - }, - "NoSuchGeoLocation":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

Amazon Route 53 doesn't support the specified geolocation.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchHealthCheck":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

No health check exists with the ID that you specified in the DeleteHealthCheck request.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchHostedZone":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

No hosted zone exists with the ID that you specified.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchQueryLoggingConfig":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

There is no DNS query logging configuration with the specified ID.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchTrafficPolicy":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

No traffic policy exists with the specified ID.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "NoSuchTrafficPolicyInstance":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

No traffic policy instance exists with the specified ID.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "Nonce":{ - "type":"string", - "max":128, - "min":1 - }, - "NotAuthorizedException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

Associating the specified VPC with the specified hosted zone has not been authorized.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "PageMarker":{ - "type":"string", - "max":64 - }, - "PageMaxItems":{"type":"string"}, - "PageTruncated":{"type":"boolean"}, - "PaginationToken":{ - "type":"string", - "max":256 - }, - "Period":{ - "type":"integer", - "min":60 - }, - "Port":{ - "type":"integer", - "max":65535, - "min":1 - }, - "PriorRequestNotComplete":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Amazon Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "PublicZoneVPCAssociation":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

You're trying to associate a VPC with a public hosted zone. Amazon Route 53 doesn't support associating a VPC with a public hosted zone.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "QueryLoggingConfig":{ - "type":"structure", - "required":[ - "Id", - "HostedZoneId", - "CloudWatchLogsLogGroupArn" - ], - "members":{ - "Id":{ - "shape":"QueryLoggingConfigId", - "documentation":"

The ID for a configuration for DNS query logging.

" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that CloudWatch Logs is logging queries for.

" - }, - "CloudWatchLogsLogGroupArn":{ - "shape":"CloudWatchLogsLogGroupArn", - "documentation":"

The Amazon Resource Name (ARN) of the CloudWatch Logs log group that Amazon Route 53 is publishing logs to.

" - } - }, - "documentation":"

A complex type that contains information about a configuration for DNS query logging.

" - }, - "QueryLoggingConfigAlreadyExists":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

You can create only one query logging configuration for a hosted zone, and a query logging configuration already exists for this hosted zone.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "QueryLoggingConfigId":{ - "type":"string", - "max":36, - "min":1 - }, - "QueryLoggingConfigs":{ - "type":"list", - "member":{ - "shape":"QueryLoggingConfig", - "locationName":"QueryLoggingConfig" - } - }, - "RData":{ - "type":"string", - "max":4000 - }, - "RRType":{ - "type":"string", - "enum":[ - "SOA", - "A", - "TXT", - "NS", - "CNAME", - "MX", - "NAPTR", - "PTR", - "SRV", - "SPF", - "AAAA", - "CAA" - ] - }, - "RecordData":{ - "type":"list", - "member":{ - "shape":"RecordDataEntry", - "locationName":"RecordDataEntry" - } - }, - "RecordDataEntry":{ - "type":"string", - "documentation":"

A value that Amazon Route 53 returned for this resource record set. A RecordDataEntry element is one of the following:

  • For non-alias resource record sets, a RecordDataEntry element contains one value in the resource record set. If the resource record set contains multiple values, the response includes one RecordDataEntry element for each value.

  • For multiple resource record sets that have the same name and type, which includes weighted, latency, geolocation, and failover, a RecordDataEntry element contains the value from the appropriate resource record set based on the request.

  • For alias resource record sets that refer to AWS resources other than another resource record set, the RecordDataEntry element contains an IP address or a domain name for the AWS resource, depending on the type of resource.

  • For alias resource record sets that refer to other resource record sets, a RecordDataEntry element contains one value from the referenced resource record set. If the referenced resource record set contains multiple values, the response includes one RecordDataEntry element for each value.

", - "max":512, - "min":0 - }, - "RequestInterval":{ - "type":"integer", - "max":30, - "min":10 - }, - "ResettableElementName":{ - "type":"string", - "enum":[ - "FullyQualifiedDomainName", - "Regions", - "ResourcePath", - "ChildHealthChecks" - ], - "max":64, - "min":1 - }, - "ResettableElementNameList":{ - "type":"list", - "member":{ - "shape":"ResettableElementName", - "locationName":"ResettableElementName" - }, - "max":64 - }, - "ResourceDescription":{ - "type":"string", - "max":256 - }, - "ResourceId":{ - "type":"string", - "max":32 - }, - "ResourcePath":{ - "type":"string", - "max":255 - }, - "ResourceRecord":{ - "type":"structure", - "required":["Value"], - "members":{ - "Value":{ - "shape":"RData", - "documentation":"

The current or new DNS record value, not to exceed 4,000 characters. In the case of a DELETE action, if the current value does not match the actual value, an error is returned. For descriptions about how to format Value for different record types, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.

You can specify more than one value for all record types except CNAME and SOA.

If you're creating an alias resource record set, omit Value.

" - } - }, - "documentation":"

Information specific to the resource record.

If you're creating an alias resource record set, omit ResourceRecord.

" - }, - "ResourceRecordSet":{ - "type":"structure", - "required":[ - "Name", - "Type" - ], - "members":{ - "Name":{ - "shape":"DNSName", - "documentation":"

The name of the domain you want to perform the action on.

Enter a fully qualified domain name, for example, www.example.com. You can optionally include a trailing dot. If you omit the trailing dot, Amazon Route 53 still assumes that the domain name that you specify is fully qualified. This means that Amazon Route 53 treats www.example.com (without a trailing dot) and www.example.com. (with a trailing dot) as identical.

For information about how to specify characters other than a-z, 0-9, and - (hyphen) and how to specify internationalized domain names, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.

You can use the asterisk (*) wildcard to replace the leftmost label in a domain name, for example, *.example.com. Note the following:

  • The * must replace the entire label. For example, you can't specify *prod.example.com or prod*.example.com.

  • The * can't replace any of the middle labels, for example, marketing.*.example.com.

  • If you include * in any position other than the leftmost label in a domain name, DNS treats it as an * character (ASCII 42), not as a wildcard.

    You can't use the * wildcard for resource records sets that have a type of NS.

You can use the * wildcard as the leftmost label in a domain name, for example, *.example.com. You can't use an * for one of the middle labels, for example, marketing.*.example.com. In addition, the * must replace the entire label; for example, you can't specify prod*.example.com.

" - }, - "Type":{ - "shape":"RRType", - "documentation":"

The DNS record type. For information about different record types and how data is encoded for them, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.

Valid values for basic resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | NS | PTR | SOA | SPF | SRV | TXT

Values for weighted, latency, geolocation, and failover resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT. When creating a group of weighted, latency, geolocation, or failover resource record sets, specify the same value for all of the resource record sets in the group.

Valid values for multivalue answer resource record sets: A | AAAA | MX | NAPTR | PTR | SPF | SRV | TXT

SPF records were formerly used to verify the identity of the sender of email messages. However, we no longer recommend that you create resource record sets for which the value of Type is SPF. RFC 7208, Sender Policy Framework (SPF) for Authorizing Use of Domains in Email, Version 1, has been updated to say, \"...[I]ts existence and mechanism defined in [RFC4408] have led to some interoperability issues. Accordingly, its use is no longer appropriate for SPF version 1; implementations are not to use it.\" In RFC 7208, see section 14.1, The SPF DNS Record Type.

Values for alias resource record sets:

  • CloudFront distributions: A

    If IPv6 is enabled for the distribution, create two resource record sets to route traffic to your distribution, one with a value of A and one with a value of AAAA.

  • AWS Elastic Beanstalk environment that has a regionalized subdomain: A

  • ELB load balancers: A | AAAA

  • Amazon S3 buckets: A

  • Another resource record set in this hosted zone: Specify the type of the resource record set that you're creating the alias for. All values are supported except NS and SOA.

" - }, - "SetIdentifier":{ - "shape":"ResourceRecordSetIdentifier", - "documentation":"

Weighted, Latency, Geo, and Failover resource record sets only: An identifier that differentiates among multiple resource record sets that have the same combination of DNS name and type. The value of SetIdentifier must be unique for each resource record set that has the same combination of DNS name and type. Omit SetIdentifier for any other types of record sets.

" - }, - "Weight":{ - "shape":"ResourceRecordSetWeight", - "documentation":"

Weighted resource record sets only: Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Amazon Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Amazon Route 53 then responds to queries based on the ratio of a resource's weight to the total. Note the following:

  • You must specify a value for the Weight element for every weighted resource record set.

  • You can only specify one ResourceRecord per weighted resource record set.

  • You can't create latency, failover, or geolocation resource record sets that have the same values for the Name and Type elements as weighted resource record sets.

  • You can create a maximum of 100 weighted resource record sets that have the same values for the Name and Type elements.

  • For weighted (but not weighted alias) resource record sets, if you set Weight to 0 for a resource record set, Amazon Route 53 never responds to queries with the applicable value for that resource record set. However, if you set Weight to 0 for all resource record sets that have the same combination of DNS name and type, traffic is routed to all resources with equal probability.

    The effect of setting Weight to 0 is different when you associate health checks with weighted resource record sets. For more information, see Options for Configuring Amazon Route 53 Active-Active and Active-Passive Failover in the Amazon Route 53 Developer Guide.

" - }, - "Region":{ - "shape":"ResourceRecordSetRegion", - "documentation":"

Latency-based resource record sets only: The Amazon EC2 Region where you created the resource that this resource record set refers to. The resource typically is an AWS resource, such as an EC2 instance or an ELB load balancer, and is referred to by an IP address or a DNS domain name, depending on the record type.

Creating latency and latency alias resource record sets in private hosted zones is not supported.

When Amazon Route 53 receives a DNS query for a domain name and type for which you have created latency resource record sets, Amazon Route 53 selects the latency resource record set that has the lowest latency between the end user and the associated Amazon EC2 Region. Amazon Route 53 then returns the value that is associated with the selected resource record set.

Note the following:

  • You can only specify one ResourceRecord per latency resource record set.

  • You can only create one latency resource record set for each Amazon EC2 Region.

  • You aren't required to create latency resource record sets for all Amazon EC2 Regions. Amazon Route 53 will choose the region with the best latency from among the regions that you create latency resource record sets for.

  • You can't create non-latency resource record sets that have the same values for the Name and Type elements as latency resource record sets.

" - }, - "GeoLocation":{ - "shape":"GeoLocation", - "documentation":"

Geo location resource record sets only: A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query. For example, if you want all queries from Africa to be routed to a web server with an IP address of 192.0.2.111, create a resource record set with a Type of A and a ContinentCode of AF.

Creating geolocation and geolocation alias resource record sets in private hosted zones is not supported.

If you create separate resource record sets for overlapping geographic regions (for example, one resource record set for a continent and one for a country on the same continent), priority goes to the smallest geographic region. This allows you to route most queries for a continent to one resource and to route queries for a country on that continent to a different resource.

You can't create two geolocation resource record sets that specify the same geographic location.

The value * in the CountryCode element matches all geographic locations that aren't specified in other geolocation resource record sets that have the same values for the Name and Type elements.

Geolocation works by mapping IP addresses to locations. However, some IP addresses aren't mapped to geographic locations, so even if you create geolocation resource record sets that cover all seven continents, Amazon Route 53 will receive some DNS queries from locations that it can't identify. We recommend that you create a resource record set for which the value of CountryCode is *, which handles both queries that come from locations for which you haven't created geolocation resource record sets and queries from IP addresses that aren't mapped to a location. If you don't create a * resource record set, Amazon Route 53 returns a \"no answer\" response for queries from those locations.

You can't create non-geolocation resource record sets that have the same values for the Name and Type elements as geolocation resource record sets.

" - }, - "Failover":{ - "shape":"ResourceRecordSetFailover", - "documentation":"

Failover resource record sets only: To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.

Except where noted, the following failover behaviors assume that you have included the HealthCheckId element in both resource record sets:

  • When the primary resource record set is healthy, Amazon Route 53 responds to DNS queries with the applicable value from the primary resource record set regardless of the health of the secondary resource record set.

  • When the primary resource record set is unhealthy and the secondary resource record set is healthy, Amazon Route 53 responds to DNS queries with the applicable value from the secondary resource record set.

  • When the secondary resource record set is unhealthy, Amazon Route 53 responds to DNS queries with the applicable value from the primary resource record set regardless of the health of the primary resource record set.

  • If you omit the HealthCheckId element for the secondary resource record set, and if the primary resource record set is unhealthy, Amazon Route 53 always responds to DNS queries with the applicable value from the secondary resource record set. This is true regardless of the health of the associated endpoint.

You can't create non-failover resource record sets that have the same values for the Name and Type elements as failover resource record sets.

For failover alias resource record sets, you must also include the EvaluateTargetHealth element and set the value to true.

For more information about configuring failover for Amazon Route 53, see the following topics in the Amazon Route 53 Developer Guide:

" - }, - "MultiValueAnswer":{ - "shape":"ResourceRecordSetMultiValueAnswer", - "documentation":"

Multivalue answer resource record sets only: To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer. Note the following:

  • If you associate a health check with a multivalue answer resource record set, Amazon Route 53 responds to DNS queries with the corresponding IP address only when the health check is healthy.

  • If you don't associate a health check with a multivalue answer record, Amazon Route 53 always considers the record to be healthy.

  • Amazon Route 53 responds to DNS queries with up to eight healthy records; if you have eight or fewer healthy records, Amazon Route 53 responds to all DNS queries with all the healthy records.

  • If you have more than eight healthy records, Amazon Route 53 responds to different DNS resolvers with different combinations of healthy records.

  • When all records are unhealthy, Amazon Route 53 responds to DNS queries with up to eight unhealthy records.

  • If a resource becomes unavailable after a resolver caches a response, client software typically tries another of the IP addresses in the response.

You can't create multivalue answer alias records.

" - }, - "TTL":{ - "shape":"TTL", - "documentation":"

The resource record cache time to live (TTL), in seconds. Note the following:

  • If you're creating or updating an alias resource record set, omit TTL. Amazon Route 53 uses the value of TTL for the alias target.

  • If you're associating this resource record set with a health check (if you're adding a HealthCheckId element), we recommend that you specify a TTL of 60 seconds or less so clients respond quickly to changes in health status.

  • All of the resource record sets in a group of weighted resource record sets must have the same value for TTL.

  • If a group of weighted resource record sets includes one or more weighted alias resource record sets for which the alias target is an ELB load balancer, we recommend that you specify a TTL of 60 seconds for all of the non-alias weighted resource record sets that have the same name and type. Values other than 60 seconds (the TTL for load balancers) will change the effect of the values that you specify for Weight.

" - }, - "ResourceRecords":{ - "shape":"ResourceRecords", - "documentation":"

Information about the resource records to act upon.

If you're creating an alias resource record set, omit ResourceRecords.

" - }, - "AliasTarget":{ - "shape":"AliasTarget", - "documentation":"

Alias resource record sets only: Information about the CloudFront distribution, AWS Elastic Beanstalk environment, ELB load balancer, Amazon S3 bucket, or Amazon Route 53 resource record set to which you're redirecting queries. The AWS Elastic Beanstalk environment must have a regionalized subdomain.

If you're creating resource records sets for a private hosted zone, note the following:

  • You can't create alias resource record sets for CloudFront distributions in a private hosted zone.

  • Creating geolocation alias resource record sets or latency alias resource record sets in a private hosted zone is unsupported.

  • For information about creating failover resource record sets in a private hosted zone, see Configuring Failover in a Private Hosted Zone in the Amazon Route 53 Developer Guide.

" - }, - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

If you want Amazon Route 53 to return this resource record set in response to a DNS query only when a health check is passing, include the HealthCheckId element and specify the ID of the applicable health check.

Amazon Route 53 determines whether a resource record set is healthy based on one of the following:

  • By periodically sending a request to the endpoint that is specified in the health check

  • By aggregating the status of a specified group of health checks (calculated health checks)

  • By determining the current state of a CloudWatch alarm (CloudWatch metric health checks)

For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy.

The HealthCheckId element is only useful when Amazon Route 53 is choosing between two or more resource record sets to respond to a DNS query, and you want Amazon Route 53 to base the choice in part on the status of a health check. Configuring health checks only makes sense in the following configurations:

  • You're checking the health of the resource record sets in a group of weighted, latency, geolocation, or failover resource record sets, and you specify health check IDs for all of the resource record sets. If the health check for one resource record set specifies an endpoint that is not healthy, Amazon Route 53 stops responding to queries using the value for that resource record set.

  • You set EvaluateTargetHealth to true for the resource record sets in a group of alias, weighted alias, latency alias, geolocation alias, or failover alias resource record sets, and you specify health check IDs for all of the resource record sets that are referenced by the alias resource record sets.

Amazon Route 53 doesn't check the health of the endpoint specified in the resource record set, for example, the endpoint specified by the IP address in the Value element. When you add a HealthCheckId element to a resource record set, Amazon Route 53 checks the health of the endpoint that you specified in the health check.

For geolocation resource record sets, if an endpoint is unhealthy, Amazon Route 53 looks for a resource record set for the larger, associated geographic region. For example, suppose you have resource record sets for a state in the United States, for the United States, for North America, and for all locations. If the endpoint for the state resource record set is unhealthy, Amazon Route 53 checks the resource record sets for the United States, for North America, and for all locations (a resource record set for which the value of CountryCode is *), in that order, until it finds a resource record set for which the endpoint is healthy.

If your health checks specify the endpoint only by domain name, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (example.com).

n this configuration, if you create a health check for which the value of FullyQualifiedDomainName matches the name of the resource record sets and then associate the health check with those resource record sets, health check results will be unpredictable.

For more information, see the following topics in the Amazon Route 53 Developer Guide:

" - }, - "TrafficPolicyInstanceId":{ - "shape":"TrafficPolicyInstanceId", - "documentation":"

When you create a traffic policy instance, Amazon Route 53 automatically creates a resource record set. TrafficPolicyInstanceId is the ID of the traffic policy instance that Amazon Route 53 created this resource record set for.

To delete the resource record set that is associated with a traffic policy instance, use DeleteTrafficPolicyInstance. Amazon Route 53 will delete the resource record set automatically. If you delete the resource record set by using ChangeResourceRecordSets, Amazon Route 53 doesn't automatically delete the traffic policy instance, and you'll continue to be charged for it even though it's no longer in use.

" - } - }, - "documentation":"

Information about the resource record set to create or delete.

" - }, - "ResourceRecordSetFailover":{ - "type":"string", - "enum":[ - "PRIMARY", - "SECONDARY" - ] - }, - "ResourceRecordSetIdentifier":{ - "type":"string", - "max":128, - "min":1 - }, - "ResourceRecordSetMultiValueAnswer":{"type":"boolean"}, - "ResourceRecordSetRegion":{ - "type":"string", - "enum":[ - "us-east-1", - "us-east-2", - "us-west-1", - "us-west-2", - "ca-central-1", - "eu-west-1", - "eu-west-2", - "eu-west-3", - "eu-central-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1", - "ap-northeast-2", - "ap-northeast-3", - "sa-east-1", - "cn-north-1", - "cn-northwest-1", - "ap-south-1" - ], - "max":64, - "min":1 - }, - "ResourceRecordSetWeight":{ - "type":"long", - "max":255, - "min":0 - }, - "ResourceRecordSets":{ - "type":"list", - "member":{ - "shape":"ResourceRecordSet", - "locationName":"ResourceRecordSet" - } - }, - "ResourceRecords":{ - "type":"list", - "member":{ - "shape":"ResourceRecord", - "locationName":"ResourceRecord" - }, - "min":1 - }, - "ResourceTagSet":{ - "type":"structure", - "members":{ - "ResourceType":{ - "shape":"TagResourceType", - "documentation":"

The type of the resource.

  • The resource type for health checks is healthcheck.

  • The resource type for hosted zones is hostedzone.

" - }, - "ResourceId":{ - "shape":"TagResourceId", - "documentation":"

The ID for the specified resource.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags associated with the specified resource.

" - } - }, - "documentation":"

A complex type containing a resource and its associated tags.

" - }, - "ResourceTagSetList":{ - "type":"list", - "member":{ - "shape":"ResourceTagSet", - "locationName":"ResourceTagSet" - } - }, - "ResourceURI":{ - "type":"string", - "max":1024 - }, - "ReusableDelegationSetLimit":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"ReusableDelegationSetLimitType", - "documentation":"

The limit that you requested: MAX_ZONES_BY_REUSABLE_DELEGATION_SET, the maximum number of hosted zones that you can associate with the specified reusable delegation set.

" - }, - "Value":{ - "shape":"LimitValue", - "documentation":"

The current value for the MAX_ZONES_BY_REUSABLE_DELEGATION_SET limit.

" - } - }, - "documentation":"

A complex type that contains the type of limit that you specified in the request and the current value for that limit.

" - }, - "ReusableDelegationSetLimitType":{ - "type":"string", - "enum":["MAX_ZONES_BY_REUSABLE_DELEGATION_SET"] - }, - "SearchString":{ - "type":"string", - "max":255 - }, - "ServicePrincipal":{ - "type":"string", - "max":128 - }, - "Statistic":{ - "type":"string", - "enum":[ - "Average", - "Sum", - "SampleCount", - "Maximum", - "Minimum" - ] - }, - "Status":{"type":"string"}, - "StatusReport":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"Status", - "documentation":"

A description of the status of the health check endpoint as reported by one of the Amazon Route 53 health checkers.

" - }, - "CheckedTime":{ - "shape":"TimeStamp", - "documentation":"

The date and time that the health checker performed the health check in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2017-03-27T17:48:16.751Z represents March 27, 2017 at 17:48:16.751 UTC.

" - } - }, - "documentation":"

A complex type that contains the status that one Amazon Route 53 health checker reports and the time of the health check.

" - }, - "SubnetMask":{ - "type":"string", - "max":3, - "min":0 - }, - "TTL":{ - "type":"long", - "max":2147483647, - "min":0 - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The value of Key depends on the operation that you want to perform:

  • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

  • Edit a tag: Key is the name of the tag that you want to change the Value for.

  • Delete a key: Key is the name of the tag you want to remove.

  • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you've given to each health check.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of Value depends on the operation that you want to perform:

  • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

  • Edit a tag: Value is the new value that you want to assign the tag.

" - } - }, - "documentation":"

A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

" - }, - "TagKey":{ - "type":"string", - "max":128 - }, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"Key" - }, - "max":10, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - }, - "max":10, - "min":1 - }, - "TagResourceId":{ - "type":"string", - "max":64 - }, - "TagResourceIdList":{ - "type":"list", - "member":{ - "shape":"TagResourceId", - "locationName":"ResourceId" - }, - "max":10, - "min":1 - }, - "TagResourceType":{ - "type":"string", - "enum":[ - "healthcheck", - "hostedzone" - ] - }, - "TagValue":{ - "type":"string", - "max":256 - }, - "TestDNSAnswerRequest":{ - "type":"structure", - "required":[ - "HostedZoneId", - "RecordName", - "RecordType" - ], - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that you want Amazon Route 53 to simulate a query for.

", - "location":"querystring", - "locationName":"hostedzoneid" - }, - "RecordName":{ - "shape":"DNSName", - "documentation":"

The name of the resource record set that you want Amazon Route 53 to simulate a query for.

", - "location":"querystring", - "locationName":"recordname" - }, - "RecordType":{ - "shape":"RRType", - "documentation":"

The type of the resource record set.

", - "location":"querystring", - "locationName":"recordtype" - }, - "ResolverIP":{ - "shape":"IPAddress", - "documentation":"

If you want to simulate a request from a specific DNS resolver, specify the IP address for that resolver. If you omit this value, TestDnsAnswer uses the IP address of a DNS resolver in the AWS US East (N. Virginia) Region (us-east-1).

", - "location":"querystring", - "locationName":"resolverip" - }, - "EDNS0ClientSubnetIP":{ - "shape":"IPAddress", - "documentation":"

If the resolver that you specified for resolverip supports EDNS0, specify the IPv4 or IPv6 address of a client in the applicable location, for example, 192.0.2.44 or 2001:db8:85a3::8a2e:370:7334.

", - "location":"querystring", - "locationName":"edns0clientsubnetip" - }, - "EDNS0ClientSubnetMask":{ - "shape":"SubnetMask", - "documentation":"

If you specify an IP address for edns0clientsubnetip, you can optionally specify the number of bits of the IP address that you want the checking tool to include in the DNS query. For example, if you specify 192.0.2.44 for edns0clientsubnetip and 24 for edns0clientsubnetmask, the checking tool will simulate a request from 192.0.2.0/24. The default value is 24 bits for IPv4 addresses and 64 bits for IPv6 addresses.

", - "location":"querystring", - "locationName":"edns0clientsubnetmask" - } - }, - "documentation":"

Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet mask.

" - }, - "TestDNSAnswerResponse":{ - "type":"structure", - "required":[ - "Nameserver", - "RecordName", - "RecordType", - "RecordData", - "ResponseCode", - "Protocol" - ], - "members":{ - "Nameserver":{ - "shape":"Nameserver", - "documentation":"

The Amazon Route 53 name server used to respond to the request.

" - }, - "RecordName":{ - "shape":"DNSName", - "documentation":"

The name of the resource record set that you submitted a request for.

" - }, - "RecordType":{ - "shape":"RRType", - "documentation":"

The type of the resource record set that you submitted a request for.

" - }, - "RecordData":{ - "shape":"RecordData", - "documentation":"

A list that contains values that Amazon Route 53 returned for this resource record set.

" - }, - "ResponseCode":{ - "shape":"DNSRCode", - "documentation":"

A code that indicates whether the request is valid or not. The most common response code is NOERROR, meaning that the request is valid. If the response is not valid, Amazon Route 53 returns a response code that describes the error. For a list of possible response codes, see DNS RCODES on the IANA website.

" - }, - "Protocol":{ - "shape":"TransportProtocol", - "documentation":"

The protocol that Amazon Route 53 used to respond to the request, either UDP or TCP.

" - } - }, - "documentation":"

A complex type that contains the response to a TestDNSAnswer request.

" - }, - "Threshold":{"type":"double"}, - "ThrottlingException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The limit on the number of requests per second was exceeded.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TimeStamp":{"type":"timestamp"}, - "TooManyHealthChecks":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

This health check can't be created because the current account has reached the limit on the number of active health checks.

For information about default limits, see Limits in the Amazon Route 53 Developer Guide.

For information about how to get the current limit for an account, see GetAccountLimit. To request a higher limit, create a case with the AWS Support Center.

You have reached the maximum number of active health checks for an AWS account. To request a higher limit, create a case with the AWS Support Center.

", - "exception":true - }, - "TooManyHostedZones":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This operation can't be completed either because the current account has reached the limit on the number of hosted zones or because you've reached the limit on the number of hosted zones that can be associated with a reusable delegation set.

For information about default limits, see Limits in the Amazon Route 53 Developer Guide.

To get the current limit on hosted zones that can be created by an account, see GetAccountLimit.

To get the current limit on hosted zones that can be associated with a reusable delegation set, see GetReusableDelegationSetLimit.

To request a higher limit, create a case with the AWS Support Center.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrafficPolicies":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This traffic policy can't be created because the current account has reached the limit on the number of traffic policies.

For information about default limits, see Limits in the Amazon Route 53 Developer Guide.

To get the current limit for an account, see GetAccountLimit.

To request a higher limit, create a case with the AWS Support Center.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrafficPolicyInstances":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This traffic policy instance can't be created because the current account has reached the limit on the number of traffic policy instances.

For information about default limits, see Limits in the Amazon Route 53 Developer Guide.

For information about how to get the current limit for an account, see GetAccountLimit.

To request a higher limit, create a case with the AWS Support Center.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyTrafficPolicyVersionsForCurrentPolicy":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

This traffic policy version can't be created because you've reached the limit of 1000 on the number of versions that you can create for the current traffic policy.

To create more traffic policy versions, you can use GetTrafficPolicy to get the traffic policy document for a specified traffic policy version, and then use CreateTrafficPolicy to create a new traffic policy using the traffic policy document.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TooManyVPCAssociationAuthorizations":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

You've created the maximum number of authorizations that can be created for the specified hosted zone. To authorize another VPC to be associated with the hosted zone, submit a DeleteVPCAssociationAuthorization request to remove an existing authorization. To get a list of existing authorizations, submit a ListVPCAssociationAuthorizations request.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrafficPolicies":{ - "type":"list", - "member":{ - "shape":"TrafficPolicy", - "locationName":"TrafficPolicy" - } - }, - "TrafficPolicy":{ - "type":"structure", - "required":[ - "Id", - "Version", - "Name", - "Type", - "Document" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID that Amazon Route 53 assigned to a traffic policy when you created it.

" - }, - "Version":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version number that Amazon Route 53 assigns to a traffic policy. For a new traffic policy, the value of Version is always 1.

" - }, - "Name":{ - "shape":"TrafficPolicyName", - "documentation":"

The name that you specified when you created the traffic policy.

" - }, - "Type":{ - "shape":"RRType", - "documentation":"

The DNS type of the resource record sets that Amazon Route 53 creates when you use a traffic policy to create a traffic policy instance.

" - }, - "Document":{ - "shape":"TrafficPolicyDocument", - "documentation":"

The definition of a traffic policy in JSON format. You specify the JSON document to use for a new traffic policy in the CreateTrafficPolicy request. For more information about the JSON format, see Traffic Policy Document Format.

" - }, - "Comment":{ - "shape":"TrafficPolicyComment", - "documentation":"

The comment that you specify in the CreateTrafficPolicy request, if any.

" - } - }, - "documentation":"

A complex type that contains settings for a traffic policy.

" - }, - "TrafficPolicyAlreadyExists":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

A traffic policy that has the same value for Name already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "TrafficPolicyComment":{ - "type":"string", - "max":1024 - }, - "TrafficPolicyDocument":{ - "type":"string", - "max":102400 - }, - "TrafficPolicyId":{ - "type":"string", - "max":36, - "min":1 - }, - "TrafficPolicyInUse":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

One or more traffic policy instances were created by using the specified traffic policy.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "TrafficPolicyInstance":{ - "type":"structure", - "required":[ - "Id", - "HostedZoneId", - "Name", - "TTL", - "State", - "Message", - "TrafficPolicyId", - "TrafficPolicyVersion", - "TrafficPolicyType" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyInstanceId", - "documentation":"

The ID that Amazon Route 53 assigned to the new traffic policy instance.

" - }, - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID of the hosted zone that Amazon Route 53 created resource record sets in.

" - }, - "Name":{ - "shape":"DNSName", - "documentation":"

The DNS name, such as www.example.com, for which Amazon Route 53 responds to queries by using the resource record sets that are associated with this traffic policy instance.

" - }, - "TTL":{ - "shape":"TTL", - "documentation":"

The TTL that Amazon Route 53 assigned to all of the resource record sets that it created in the specified hosted zone.

" - }, - "State":{ - "shape":"TrafficPolicyInstanceState", - "documentation":"

The value of State is one of the following values:

Applied

Amazon Route 53 has finished creating resource record sets, and changes have propagated to all Amazon Route 53 edge locations.

Creating

Amazon Route 53 is creating the resource record sets. Use GetTrafficPolicyInstance to confirm that the CreateTrafficPolicyInstance request completed successfully.

Failed

Amazon Route 53 wasn't able to create or update the resource record sets. When the value of State is Failed, see Message for an explanation of what caused the request to fail.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

If State is Failed, an explanation of the reason for the failure. If State is another value, Message is empty.

" - }, - "TrafficPolicyId":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy that Amazon Route 53 used to create resource record sets in the specified hosted zone.

" - }, - "TrafficPolicyVersion":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version of the traffic policy that Amazon Route 53 used to create resource record sets in the specified hosted zone.

" - }, - "TrafficPolicyType":{ - "shape":"RRType", - "documentation":"

The DNS type that Amazon Route 53 assigned to all of the resource record sets that it created for this traffic policy instance.

" - } - }, - "documentation":"

A complex type that contains settings for the new traffic policy instance.

" - }, - "TrafficPolicyInstanceAlreadyExists":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

There is already a traffic policy instance with the specified ID.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "TrafficPolicyInstanceCount":{"type":"integer"}, - "TrafficPolicyInstanceId":{ - "type":"string", - "max":36, - "min":1 - }, - "TrafficPolicyInstanceState":{"type":"string"}, - "TrafficPolicyInstances":{ - "type":"list", - "member":{ - "shape":"TrafficPolicyInstance", - "locationName":"TrafficPolicyInstance" - } - }, - "TrafficPolicyName":{ - "type":"string", - "max":512 - }, - "TrafficPolicySummaries":{ - "type":"list", - "member":{ - "shape":"TrafficPolicySummary", - "locationName":"TrafficPolicySummary" - } - }, - "TrafficPolicySummary":{ - "type":"structure", - "required":[ - "Id", - "Name", - "Type", - "LatestVersion", - "TrafficPolicyCount" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID that Amazon Route 53 assigned to the traffic policy when you created it.

" - }, - "Name":{ - "shape":"TrafficPolicyName", - "documentation":"

The name that you specified for the traffic policy when you created it.

" - }, - "Type":{ - "shape":"RRType", - "documentation":"

The DNS type of the resource record sets that Amazon Route 53 creates when you use a traffic policy to create a traffic policy instance.

" - }, - "LatestVersion":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version number of the latest version of the traffic policy.

" - }, - "TrafficPolicyCount":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The number of traffic policies that are associated with the current AWS account.

" - } - }, - "documentation":"

A complex type that contains information about the latest version of one traffic policy that is associated with the current AWS account.

" - }, - "TrafficPolicyVersion":{ - "type":"integer", - "max":1000, - "min":1 - }, - "TrafficPolicyVersionMarker":{ - "type":"string", - "max":4 - }, - "TransportProtocol":{"type":"string"}, - "UpdateHealthCheckRequest":{ - "type":"structure", - "required":["HealthCheckId"], - "members":{ - "HealthCheckId":{ - "shape":"HealthCheckId", - "documentation":"

The ID for the health check for which you want detailed information. When you created the health check, CreateHealthCheck returned the ID in the response, in the HealthCheckId element.

", - "location":"uri", - "locationName":"HealthCheckId" - }, - "HealthCheckVersion":{ - "shape":"HealthCheckVersion", - "documentation":"

A sequential counter that Amazon Route 53 sets to 1 when you create a health check and increments by 1 each time you update settings for the health check.

We recommend that you use GetHealthCheck or ListHealthChecks to get the current value of HealthCheckVersion for the health check that you want to update, and that you include that value in your UpdateHealthCheck request. This prevents Amazon Route 53 from overwriting an intervening update:

  • If the value in the UpdateHealthCheck request matches the value of HealthCheckVersion in the health check, Amazon Route 53 updates the health check with the new settings.

  • If the value of HealthCheckVersion in the health check is greater, the health check was changed after you got the version number. Amazon Route 53 does not update the health check, and it returns a HealthCheckVersionMismatch error.

" - }, - "IPAddress":{ - "shape":"IPAddress", - "documentation":"

The IPv4 or IPv6 IP address for the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Amazon Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address that is returned by DNS, Amazon Route 53 then checks the health of the endpoint.

Use one of the following formats for the value of IPAddress:

  • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

  • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

If the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance never changes. For more information, see the applicable documentation:

If a health check already has a value for IPAddress, you can change the value. However, you can't update an existing health check to add or remove the value of IPAddress.

For more information, see UpdateHealthCheckRequest$FullyQualifiedDomainName.

Constraints: Amazon Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create health checks, see the following documents:

" - }, - "Port":{ - "shape":"Port", - "documentation":"

The port on the endpoint on which you want Amazon Route 53 to perform health checks.

" - }, - "ResourcePath":{ - "shape":"ResourcePath", - "documentation":"

The path that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example the file /docs/route53-health-check.html.

Specify this value only if you want to change it.

" - }, - "FullyQualifiedDomainName":{ - "shape":"FullyQualifiedDomainName", - "documentation":"

Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

If a health check already has a value for IPAddress, you can change the value. However, you can't update an existing health check to add or remove the value of IPAddress.

If you specify a value for IPAddress:

Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Amazon Route 53 to perform health checks.

When Amazon Route 53 checks the health of an endpoint, here is how it constructs the Host header:

  • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Amazon Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Amazon Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify another value for Port and any value except TCP for Type, Amazon Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

If you don't specify a value for FullyQualifiedDomainName, Amazon Route 53 substitutes the value of IPAddress in the Host header in each of the above cases.

If you don't specify a value for IPAddress:

If you don't specify a value for IPAddress, Amazon Route 53 sends a DNS request to the domain that you specify in FullyQualifiedDomainName at the interval you specify in RequestInterval. Using an IPv4 address that is returned by DNS, Amazon Route 53 then checks the health of the endpoint.

If you don't specify a value for IPAddress, Amazon Route 53 uses only IPv4 to send health checks to the endpoint. If there's no resource record set with a type of A for the name that you specify for FullyQualifiedDomainName, the health check fails with a \"DNS resolution failed\" error.

If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

In this configuration, if the value of FullyQualifiedDomainName matches the name of the resource record sets and you then associate the health check with those resource record sets, health check results will be unpredictable.

In addition, if the value of Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Amazon Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Amazon Route 53 doesn't pass a Host header.

" - }, - "SearchString":{ - "shape":"SearchString", - "documentation":"

If the value of Type is HTTP_STR_MATCH or HTTP_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Amazon Route 53 considers the resource healthy. (You can't change the value of Type when you update a health check.)

" - }, - "FailureThreshold":{ - "shape":"FailureThreshold", - "documentation":"

The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

If you don't specify a value for FailureThreshold, the default value is three health checks.

" - }, - "Inverted":{ - "shape":"Inverted", - "documentation":"

Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

" - }, - "HealthThreshold":{ - "shape":"HealthThreshold", - "documentation":"

The number of child health checks that are associated with a CALCULATED health that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks and ChildHealthCheck elements.

Note the following:

  • If you specify a number greater than the number of child health checks, Amazon Route 53 always considers this health check to be unhealthy.

  • If you specify 0, Amazon Route 53 always considers this health check to be healthy.

" - }, - "ChildHealthChecks":{ - "shape":"ChildHealthCheckList", - "documentation":"

A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

" - }, - "EnableSNI":{ - "shape":"EnableSNI", - "documentation":"

Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

" - }, - "Regions":{ - "shape":"HealthCheckRegionList", - "documentation":"

A complex type that contains one Region element for each region that you want Amazon Route 53 health checkers to check the specified endpoint from.

" - }, - "AlarmIdentifier":{"shape":"AlarmIdentifier"}, - "InsufficientDataHealthStatus":{ - "shape":"InsufficientDataHealthStatus", - "documentation":"

When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

  • Healthy: Amazon Route 53 considers the health check to be healthy.

  • Unhealthy: Amazon Route 53 considers the health check to be unhealthy.

  • LastKnownStatus: Amazon Route 53 uses the status of the health check from the last time CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

" - }, - "ResetElements":{ - "shape":"ResettableElementNameList", - "documentation":"

A complex type that contains one ResettableElementName element for each element that you want to reset to the default value. Valid values for ResettableElementName include the following:

" - } - }, - "documentation":"

A complex type that contains information about a request to update a health check.

" - }, - "UpdateHealthCheckResponse":{ - "type":"structure", - "required":["HealthCheck"], - "members":{ - "HealthCheck":{"shape":"HealthCheck"} - } - }, - "UpdateHostedZoneCommentRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID for the hosted zone that you want to update the comment for.

", - "location":"uri", - "locationName":"Id" - }, - "Comment":{ - "shape":"ResourceDescription", - "documentation":"

The new comment for the hosted zone. If you don't specify a value for Comment, Amazon Route 53 deletes the existing value of the Comment element, if any.

" - } - }, - "documentation":"

A request to update the comment for a hosted zone.

" - }, - "UpdateHostedZoneCommentResponse":{ - "type":"structure", - "required":["HostedZone"], - "members":{ - "HostedZone":{"shape":"HostedZone"} - }, - "documentation":"

A complex type that contains the response to the UpdateHostedZoneComment request.

" - }, - "UpdateTrafficPolicyCommentRequest":{ - "type":"structure", - "required":[ - "Id", - "Version", - "Comment" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyId", - "documentation":"

The value of Id for the traffic policy that you want to update the comment for.

", - "location":"uri", - "locationName":"Id" - }, - "Version":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The value of Version for the traffic policy that you want to update the comment for.

", - "location":"uri", - "locationName":"Version" - }, - "Comment":{ - "shape":"TrafficPolicyComment", - "documentation":"

The new comment for the specified traffic policy and version.

" - } - }, - "documentation":"

A complex type that contains information about the traffic policy that you want to update the comment for.

" - }, - "UpdateTrafficPolicyCommentResponse":{ - "type":"structure", - "required":["TrafficPolicy"], - "members":{ - "TrafficPolicy":{ - "shape":"TrafficPolicy", - "documentation":"

A complex type that contains settings for the specified traffic policy.

" - } - }, - "documentation":"

A complex type that contains the response information for the traffic policy.

" - }, - "UpdateTrafficPolicyInstanceRequest":{ - "type":"structure", - "required":[ - "Id", - "TTL", - "TrafficPolicyId", - "TrafficPolicyVersion" - ], - "members":{ - "Id":{ - "shape":"TrafficPolicyInstanceId", - "documentation":"

The ID of the traffic policy instance that you want to update.

", - "location":"uri", - "locationName":"Id" - }, - "TTL":{ - "shape":"TTL", - "documentation":"

The TTL that you want Amazon Route 53 to assign to all of the updated resource record sets.

" - }, - "TrafficPolicyId":{ - "shape":"TrafficPolicyId", - "documentation":"

The ID of the traffic policy that you want Amazon Route 53 to use to update resource record sets for the specified traffic policy instance.

" - }, - "TrafficPolicyVersion":{ - "shape":"TrafficPolicyVersion", - "documentation":"

The version of the traffic policy that you want Amazon Route 53 to use to update resource record sets for the specified traffic policy instance.

" - } - }, - "documentation":"

A complex type that contains information about the resource record sets that you want to update based on a specified traffic policy instance.

" - }, - "UpdateTrafficPolicyInstanceResponse":{ - "type":"structure", - "required":["TrafficPolicyInstance"], - "members":{ - "TrafficPolicyInstance":{ - "shape":"TrafficPolicyInstance", - "documentation":"

A complex type that contains settings for the updated traffic policy instance.

" - } - }, - "documentation":"

A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.

" - }, - "UsageCount":{ - "type":"long", - "min":0 - }, - "VPC":{ - "type":"structure", - "members":{ - "VPCRegion":{ - "shape":"VPCRegion", - "documentation":"

(Private hosted zones only) The region in which you created an Amazon VPC.

" - }, - "VPCId":{"shape":"VPCId"} - }, - "documentation":"

(Private hosted zones only) A complex type that contains information about an Amazon VPC.

" - }, - "VPCAssociationAuthorizationNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The VPC that you specified is not authorized to be associated with the hosted zone.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "VPCAssociationNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Descriptive message for the error response.

" - } - }, - "documentation":"

The specified VPC and hosted zone are not currently associated.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "VPCId":{ - "type":"string", - "documentation":"

(Private hosted zones only) The ID of an Amazon VPC.

", - "max":1024 - }, - "VPCRegion":{ - "type":"string", - "enum":[ - "us-east-1", - "us-east-2", - "us-west-1", - "us-west-2", - "eu-west-1", - "eu-west-2", - "eu-west-3", - "eu-central-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-south-1", - "ap-northeast-1", - "ap-northeast-2", - "ap-northeast-3", - "sa-east-1", - "ca-central-1", - "cn-north-1" - ], - "max":64, - "min":1 - }, - "VPCs":{ - "type":"list", - "member":{ - "shape":"VPC", - "locationName":"VPC" - }, - "documentation":"

(Private hosted zones only) A list of VPC elements.

", - "min":1 - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/waiters-2.json deleted file mode 100644 index 94aad399..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53/2013-04-01/waiters-2.json +++ /dev/null @@ -1,18 +0,0 @@ -{ - "version": 2, - "waiters": { - "ResourceRecordSetsChanged": { - "delay": 30, - "maxAttempts": 60, - "operation": "GetChange", - "acceptors": [ - { - "matcher": "path", - "expected": "INSYNC", - "argument": "ChangeInfo.Status", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/paginators-1.json deleted file mode 100644 index 8d1a73ab..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/paginators-1.json +++ /dev/null @@ -1,17 +0,0 @@ -{ - "version": "1.0", - "pagination": { - "ListDomains": { - "limit_key": "MaxItems", - "input_token": "Marker", - "output_token": "NextPageMarker", - "result_key": "Domains" - }, - "ListOperations": { - "limit_key": "MaxItems", - "input_token": "Marker", - "output_token": "NextPageMarker", - "result_key": "Operations" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/service-2.json deleted file mode 100644 index 4a7dfc94..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/route53domains/2014-05-15/service-2.json +++ /dev/null @@ -1,1931 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-05-15", - "endpointPrefix":"route53domains", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Route 53 Domains", - "serviceId":"Route 53 Domains", - "signatureVersion":"v4", - "targetPrefix":"Route53Domains_v20140515", - "uid":"route53domains-2014-05-15" - }, - "operations":{ - "CheckDomainAvailability":{ - "name":"CheckDomainAvailability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CheckDomainAvailabilityRequest"}, - "output":{"shape":"CheckDomainAvailabilityResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation checks the availability of one domain name. Note that if the availability status of a domain is pending, you must submit another request to determine the availability of the domain name.

" - }, - "CheckDomainTransferability":{ - "name":"CheckDomainTransferability", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CheckDomainTransferabilityRequest"}, - "output":{"shape":"CheckDomainTransferabilityResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

Checks whether a domain name can be transferred to Amazon Route 53.

" - }, - "DeleteTagsForDomain":{ - "name":"DeleteTagsForDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsForDomainRequest"}, - "output":{"shape":"DeleteTagsForDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation deletes the specified tags for a domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

" - }, - "DisableDomainAutoRenew":{ - "name":"DisableDomainAutoRenew", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableDomainAutoRenewRequest"}, - "output":{"shape":"DisableDomainAutoRenewResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation disables automatic renewal of domain registration for the specified domain.

" - }, - "DisableDomainTransferLock":{ - "name":"DisableDomainTransferLock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableDomainTransferLockRequest"}, - "output":{"shape":"DisableDomainTransferLockResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation removes the transfer lock on the domain (specifically the clientTransferProhibited status) to allow domain transfers. We recommend you refrain from performing this action unless you intend to transfer the domain to a different registrar. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

" - }, - "EnableDomainAutoRenew":{ - "name":"EnableDomainAutoRenew", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableDomainAutoRenewRequest"}, - "output":{"shape":"EnableDomainAutoRenewResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"}, - {"shape":"TLDRulesViolation"} - ], - "documentation":"

This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires. The cost of renewing your domain registration is billed to your AWS account.

The period during which you can renew a domain name varies by TLD. For a list of TLDs and their renewal policies, see \"Renewal, restoration, and deletion times\" on the website for our registrar associate, Gandi. Amazon Route 53 requires that you renew before the end of the renewal period that is listed on the Gandi website so we can complete processing before the deadline.

" - }, - "EnableDomainTransferLock":{ - "name":"EnableDomainTransferLock", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"EnableDomainTransferLockRequest"}, - "output":{"shape":"EnableDomainTransferLockResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation sets the transfer lock on the domain (specifically the clientTransferProhibited status) to prevent domain transfers. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

" - }, - "GetContactReachabilityStatus":{ - "name":"GetContactReachabilityStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetContactReachabilityStatusRequest"}, - "output":{"shape":"GetContactReachabilityStatusResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation returns information about whether the registrant contact has responded.

If you want us to resend the email, use the ResendContactReachabilityEmail operation.

" - }, - "GetDomainDetail":{ - "name":"GetDomainDetail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDomainDetailRequest"}, - "output":{"shape":"GetDomainDetailResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation returns detailed information about a specified domain that is associated with the current AWS account. Contact information for the domain is also returned as part of the output.

" - }, - "GetDomainSuggestions":{ - "name":"GetDomainSuggestions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDomainSuggestionsRequest"}, - "output":{"shape":"GetDomainSuggestionsResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

The GetDomainSuggestions operation returns a list of suggested domain names given a string, which can either be a domain name or simply a word or phrase (without spaces).

" - }, - "GetOperationDetail":{ - "name":"GetOperationDetail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOperationDetailRequest"}, - "output":{"shape":"GetOperationDetailResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

This operation returns the current status of an operation that is not completed.

" - }, - "ListDomains":{ - "name":"ListDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDomainsRequest"}, - "output":{"shape":"ListDomainsResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

This operation returns all the domain names registered with Amazon Route 53 for the current AWS account.

" - }, - "ListOperations":{ - "name":"ListOperations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOperationsRequest"}, - "output":{"shape":"ListOperationsResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

This operation returns the operation IDs of operations that are not yet complete.

" - }, - "ListTagsForDomain":{ - "name":"ListTagsForDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForDomainRequest"}, - "output":{"shape":"ListTagsForDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation returns all of the tags that are associated with the specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

" - }, - "RegisterDomain":{ - "name":"RegisterDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterDomainRequest"}, - "output":{"shape":"RegisterDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"DomainLimitExceeded"}, - {"shape":"OperationLimitExceeded"} - ], - "documentation":"

This operation registers a domain. Domains are registered either by Amazon Registrar (for .com, .net, and .org domains) or by our registrar associate, Gandi (for all other domains). For some top-level domains (TLDs), this operation requires extra parameters.

When you register a domain, Amazon Route 53 does the following:

  • Creates a Amazon Route 53 hosted zone that has the same name as the domain. Amazon Route 53 assigns four name servers to your hosted zone and automatically updates your domain registration with the names of these name servers.

  • Enables autorenew, so your domain registration will renew automatically each year. We'll notify you in advance of the renewal date so you can choose whether to renew the registration.

  • Optionally enables privacy protection, so WHOIS queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you don't enable privacy protection, WHOIS queries return the information that you entered for the registrant, admin, and tech contacts.

  • If registration is successful, returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant is notified by email.

  • Charges your AWS account an amount based on the top-level domain. For more information, see Amazon Route 53 Pricing.

" - }, - "RenewDomain":{ - "name":"RenewDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RenewDomainRequest"}, - "output":{"shape":"RenewDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"} - ], - "documentation":"

This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your AWS account.

We recommend that you renew your domain several weeks before the expiration date. Some TLD registries delete domains before the expiration date if you haven't renewed far enough in advance. For more information about renewing domain registration, see Renewing Registration for a Domain in the Amazon Route 53 Developer Guide.

" - }, - "ResendContactReachabilityEmail":{ - "name":"ResendContactReachabilityEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResendContactReachabilityEmailRequest"}, - "output":{"shape":"ResendContactReachabilityEmailResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation resends the confirmation email to the current email address for the registrant contact.

" - }, - "RetrieveDomainAuthCode":{ - "name":"RetrieveDomainAuthCode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetrieveDomainAuthCodeRequest"}, - "output":{"shape":"RetrieveDomainAuthCodeResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation returns the AuthCode for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.

" - }, - "TransferDomain":{ - "name":"TransferDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TransferDomainRequest"}, - "output":{"shape":"TransferDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"UnsupportedTLD"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"DomainLimitExceeded"}, - {"shape":"OperationLimitExceeded"} - ], - "documentation":"

This operation transfers a domain from another registrar to Amazon Route 53. When the transfer is complete, the domain is registered either with Amazon Registrar (for .com, .net, and .org domains) or with our registrar associate, Gandi (for all other TLDs).

For transfer requirements, a detailed procedure, and information about viewing the status of a domain transfer, see Transferring Registration for a Domain to Amazon Route 53 in the Amazon Route 53 Developer Guide.

If the registrar for your domain is also the DNS service provider for the domain, we highly recommend that you consider transferring your DNS service to Amazon Route 53 or to another DNS service provider before you transfer your registration. Some registrars provide free DNS service when you purchase a domain registration. When you transfer the registration, the previous registrar will not renew your domain registration and could end your DNS service at any time.

If the registrar for your domain is also the DNS service provider for the domain and you don't transfer DNS service to another provider, your website, email, and the web applications associated with the domain might become unavailable.

If the transfer is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the transfer doesn't complete successfully, the domain registrant will be notified by email.

" - }, - "UpdateDomainContact":{ - "name":"UpdateDomainContact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDomainContactRequest"}, - "output":{"shape":"UpdateDomainContactResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation updates the contact information for a particular domain. You must specify information for at least one contact: registrant, administrator, or technical.

If the update is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

" - }, - "UpdateDomainContactPrivacy":{ - "name":"UpdateDomainContactPrivacy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDomainContactPrivacyRequest"}, - "output":{"shape":"UpdateDomainContactPrivacyResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, contact information such as email address is replaced either with contact information for Amazon Registrar (for .com, .net, and .org domains) or with contact information for our registrar associate, Gandi.

This operation affects only the contact information for the specified contact type (registrant, administrator, or tech). If the request succeeds, Amazon Route 53 returns an operation ID that you can use with GetOperationDetail to track the progress and completion of the action. If the request doesn't complete successfully, the domain registrant will be notified by email.

" - }, - "UpdateDomainNameservers":{ - "name":"UpdateDomainNameservers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDomainNameserversRequest"}, - "output":{"shape":"UpdateDomainNameserversResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"DuplicateRequest"}, - {"shape":"TLDRulesViolation"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation replaces the current set of name servers for the domain with the specified set of name servers. If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.

If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

" - }, - "UpdateTagsForDomain":{ - "name":"UpdateTagsForDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTagsForDomainRequest"}, - "output":{"shape":"UpdateTagsForDomainResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"OperationLimitExceeded"}, - {"shape":"UnsupportedTLD"} - ], - "documentation":"

This operation adds or updates tags for a specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

" - }, - "ViewBilling":{ - "name":"ViewBilling", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ViewBillingRequest"}, - "output":{"shape":"ViewBillingResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Returns all the domain-related billing records for the current AWS account for a specified period

" - } - }, - "shapes":{ - "AddressLine":{ - "type":"string", - "max":255 - }, - "BillingRecord":{ - "type":"structure", - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that the billing record applies to. If the domain name contains characters other than a-z, 0-9, and - (hyphen), such as an internationalized domain name, then this value is in Punycode. For more information, see DNS Domain Name Format in the Amazon Route 53 Developer Guidezzz.

" - }, - "Operation":{ - "shape":"OperationType", - "documentation":"

The operation that you were charged for.

" - }, - "InvoiceId":{ - "shape":"InvoiceId", - "documentation":"

The ID of the invoice that is associated with the billing record.

" - }, - "BillDate":{ - "shape":"Timestamp", - "documentation":"

The date that the operation was billed, in Unix format.

" - }, - "Price":{ - "shape":"Price", - "documentation":"

The price that you were charged for the operation, in US dollars.

Example value: 12.0

" - } - }, - "documentation":"

Information for one billing record.

" - }, - "BillingRecords":{ - "type":"list", - "member":{"shape":"BillingRecord"} - }, - "Boolean":{"type":"boolean"}, - "CheckDomainAvailabilityRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to get availability for.

Constraints: The domain name can contain only the letters a through z, the numbers 0 through 9, and hyphen (-). Internationalized Domain Names are not supported.

" - }, - "IdnLangCode":{ - "shape":"LangCode", - "documentation":"

Reserved for future use.

" - } - }, - "documentation":"

The CheckDomainAvailability request contains the following elements.

" - }, - "CheckDomainAvailabilityResponse":{ - "type":"structure", - "required":["Availability"], - "members":{ - "Availability":{ - "shape":"DomainAvailability", - "documentation":"

Whether the domain name is available for registering.

You can register only domains designated as AVAILABLE.

Valid values:

AVAILABLE

The domain name is available.

AVAILABLE_RESERVED

The domain name is reserved under specific conditions.

AVAILABLE_PREORDER

The domain name is available and can be preordered.

DONT_KNOW

The TLD registry didn't reply with a definitive answer about whether the domain name is available. Amazon Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.

PENDING

The TLD registry didn't return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.

RESERVED

The domain name has been reserved for another person or organization.

UNAVAILABLE

The domain name is not available.

UNAVAILABLE_PREMIUM

The domain name is not available.

UNAVAILABLE_RESTRICTED

The domain name is forbidden.

" - } - }, - "documentation":"

The CheckDomainAvailability response includes the following elements.

" - }, - "CheckDomainTransferabilityRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to transfer to Amazon Route 53.

Constraints: The domain name can contain only the letters a through z, the numbers 0 through 9, and hyphen (-). Internationalized Domain Names are not supported.

" - }, - "AuthCode":{ - "shape":"DomainAuthCode", - "documentation":"

If the registrar for the top-level domain (TLD) requires an authorization code to transfer the domain, the code that you got from the current registrar for the domain.

" - } - }, - "documentation":"

The CheckDomainTransferability request contains the following elements.

" - }, - "CheckDomainTransferabilityResponse":{ - "type":"structure", - "required":["Transferability"], - "members":{ - "Transferability":{ - "shape":"DomainTransferability", - "documentation":"

A complex type that contains information about whether the specified domain can be transferred to Amazon Route 53.

" - } - }, - "documentation":"

The CheckDomainTransferability response includes the following elements.

" - }, - "City":{ - "type":"string", - "max":255 - }, - "ContactDetail":{ - "type":"structure", - "members":{ - "FirstName":{ - "shape":"ContactName", - "documentation":"

First name of contact.

" - }, - "LastName":{ - "shape":"ContactName", - "documentation":"

Last name of contact.

" - }, - "ContactType":{ - "shape":"ContactType", - "documentation":"

Indicates whether the contact is a person, company, association, or public organization. If you choose an option other than PERSON, you must enter an organization name, and you can't enable privacy protection for the contact.

" - }, - "OrganizationName":{ - "shape":"ContactName", - "documentation":"

Name of the organization for contact types other than PERSON.

" - }, - "AddressLine1":{ - "shape":"AddressLine", - "documentation":"

First line of the contact's address.

" - }, - "AddressLine2":{ - "shape":"AddressLine", - "documentation":"

Second line of contact's address, if any.

" - }, - "City":{ - "shape":"City", - "documentation":"

The city of the contact's address.

" - }, - "State":{ - "shape":"State", - "documentation":"

The state or province of the contact's city.

" - }, - "CountryCode":{ - "shape":"CountryCode", - "documentation":"

Code for the country of the contact's address.

" - }, - "ZipCode":{ - "shape":"ZipCode", - "documentation":"

The zip or postal code of the contact's address.

" - }, - "PhoneNumber":{ - "shape":"ContactNumber", - "documentation":"

The phone number of the contact.

Constraints: Phone number must be specified in the format \"+[country dialing code].[number including any area code>]\". For example, a US phone number might appear as \"+1.1234567890\".

" - }, - "Email":{ - "shape":"Email", - "documentation":"

Email address of the contact.

" - }, - "Fax":{ - "shape":"ContactNumber", - "documentation":"

Fax number of the contact.

Constraints: Phone number must be specified in the format \"+[country dialing code].[number including any area code]\". For example, a US phone number might appear as \"+1.1234567890\".

" - }, - "ExtraParams":{ - "shape":"ExtraParamList", - "documentation":"

A list of name-value pairs for parameters required by certain top-level domains.

" - } - }, - "documentation":"

ContactDetail includes the following elements.

", - "sensitive":true - }, - "ContactName":{ - "type":"string", - "max":255 - }, - "ContactNumber":{ - "type":"string", - "max":30 - }, - "ContactType":{ - "type":"string", - "enum":[ - "PERSON", - "COMPANY", - "ASSOCIATION", - "PUBLIC_BODY", - "RESELLER" - ] - }, - "CountryCode":{ - "type":"string", - "enum":[ - "AD", - "AE", - "AF", - "AG", - "AI", - "AL", - "AM", - "AN", - "AO", - "AQ", - "AR", - "AS", - "AT", - "AU", - "AW", - "AZ", - "BA", - "BB", - "BD", - "BE", - "BF", - "BG", - "BH", - "BI", - "BJ", - "BL", - "BM", - "BN", - "BO", - "BR", - "BS", - "BT", - "BW", - "BY", - "BZ", - "CA", - "CC", - "CD", - "CF", - "CG", - "CH", - "CI", - "CK", - "CL", - "CM", - "CN", - "CO", - "CR", - "CU", - "CV", - "CX", - "CY", - "CZ", - "DE", - "DJ", - "DK", - "DM", - "DO", - "DZ", - "EC", - "EE", - "EG", - "ER", - "ES", - "ET", - "FI", - "FJ", - "FK", - "FM", - "FO", - "FR", - "GA", - "GB", - "GD", - "GE", - "GH", - "GI", - "GL", - "GM", - "GN", - "GQ", - "GR", - "GT", - "GU", - "GW", - "GY", - "HK", - "HN", - "HR", - "HT", - "HU", - "ID", - "IE", - "IL", - "IM", - "IN", - "IQ", - "IR", - "IS", - "IT", - "JM", - "JO", - "JP", - "KE", - "KG", - "KH", - "KI", - "KM", - "KN", - "KP", - "KR", - "KW", - "KY", - "KZ", - "LA", - "LB", - "LC", - "LI", - "LK", - "LR", - "LS", - "LT", - "LU", - "LV", - "LY", - "MA", - "MC", - "MD", - "ME", - "MF", - "MG", - "MH", - "MK", - "ML", - "MM", - "MN", - "MO", - "MP", - "MR", - "MS", - "MT", - "MU", - "MV", - "MW", - "MX", - "MY", - "MZ", - "NA", - "NC", - "NE", - "NG", - "NI", - "NL", - "NO", - "NP", - "NR", - "NU", - "NZ", - "OM", - "PA", - "PE", - "PF", - "PG", - "PH", - "PK", - "PL", - "PM", - "PN", - "PR", - "PT", - "PW", - "PY", - "QA", - "RO", - "RS", - "RU", - "RW", - "SA", - "SB", - "SC", - "SD", - "SE", - "SG", - "SH", - "SI", - "SK", - "SL", - "SM", - "SN", - "SO", - "SR", - "ST", - "SV", - "SY", - "SZ", - "TC", - "TD", - "TG", - "TH", - "TJ", - "TK", - "TL", - "TM", - "TN", - "TO", - "TR", - "TT", - "TV", - "TW", - "TZ", - "UA", - "UG", - "US", - "UY", - "UZ", - "VA", - "VC", - "VE", - "VG", - "VI", - "VN", - "VU", - "WF", - "WS", - "YE", - "YT", - "ZA", - "ZM", - "ZW" - ] - }, - "CurrentExpiryYear":{"type":"integer"}, - "DNSSec":{"type":"string"}, - "DeleteTagsForDomainRequest":{ - "type":"structure", - "required":[ - "DomainName", - "TagsToDelete" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The domain for which you want to delete one or more tags.

" - }, - "TagsToDelete":{ - "shape":"TagKeyList", - "documentation":"

A list of tag keys to delete.

" - } - }, - "documentation":"

The DeleteTagsForDomainRequest includes the following elements.

" - }, - "DeleteTagsForDomainResponse":{ - "type":"structure", - "members":{ - } - }, - "DisableDomainAutoRenewRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to disable automatic renewal for.

" - } - } - }, - "DisableDomainAutoRenewResponse":{ - "type":"structure", - "members":{ - } - }, - "DisableDomainTransferLockRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to remove the transfer lock for.

" - } - }, - "documentation":"

The DisableDomainTransferLock request includes the following element.

" - }, - "DisableDomainTransferLockResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The DisableDomainTransferLock response includes the following element.

" - }, - "DomainAuthCode":{ - "type":"string", - "max":1024, - "sensitive":true - }, - "DomainAvailability":{ - "type":"string", - "enum":[ - "AVAILABLE", - "AVAILABLE_RESERVED", - "AVAILABLE_PREORDER", - "UNAVAILABLE", - "UNAVAILABLE_PREMIUM", - "UNAVAILABLE_RESTRICTED", - "RESERVED", - "DONT_KNOW" - ] - }, - "DomainLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The number of domains has exceeded the allowed threshold for the account.

" - } - }, - "documentation":"

The number of domains has exceeded the allowed threshold for the account.

", - "exception":true - }, - "DomainName":{ - "type":"string", - "max":255 - }, - "DomainStatus":{"type":"string"}, - "DomainStatusList":{ - "type":"list", - "member":{"shape":"DomainStatus"} - }, - "DomainSuggestion":{ - "type":"structure", - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

A suggested domain name.

" - }, - "Availability":{ - "shape":"String", - "documentation":"

Whether the domain name is available for registering.

You can register only the domains that are designated as AVAILABLE.

Valid values:

AVAILABLE

The domain name is available.

AVAILABLE_RESERVED

The domain name is reserved under specific conditions.

AVAILABLE_PREORDER

The domain name is available and can be preordered.

DONT_KNOW

The TLD registry didn't reply with a definitive answer about whether the domain name is available. Amazon Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.

PENDING

The TLD registry didn't return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.

RESERVED

The domain name has been reserved for another person or organization.

UNAVAILABLE

The domain name is not available.

UNAVAILABLE_PREMIUM

The domain name is not available.

UNAVAILABLE_RESTRICTED

The domain name is forbidden.

" - } - }, - "documentation":"

Information about one suggested domain name.

" - }, - "DomainSuggestionsList":{ - "type":"list", - "member":{"shape":"DomainSuggestion"} - }, - "DomainSummary":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that the summary information applies to.

" - }, - "AutoRenew":{ - "shape":"Boolean", - "documentation":"

Indicates whether the domain is automatically renewed upon expiration.

" - }, - "TransferLock":{ - "shape":"Boolean", - "documentation":"

Indicates whether a domain is locked from unauthorized transfer to another party.

" - }, - "Expiry":{ - "shape":"Timestamp", - "documentation":"

Expiration date of the domain in Coordinated Universal Time (UTC).

" - } - }, - "documentation":"

Summary information about one domain.

" - }, - "DomainSummaryList":{ - "type":"list", - "member":{"shape":"DomainSummary"} - }, - "DomainTransferability":{ - "type":"structure", - "members":{ - "Transferable":{"shape":"Transferable"} - }, - "documentation":"

A complex type that contains information about whether the specified domain can be transferred to Amazon Route 53.

" - }, - "DuplicateRequest":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The request is already in progress for the domain.

" - } - }, - "documentation":"

The request is already in progress for the domain.

", - "exception":true - }, - "DurationInYears":{ - "type":"integer", - "max":10, - "min":1 - }, - "Email":{ - "type":"string", - "max":254 - }, - "EnableDomainAutoRenewRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to enable automatic renewal for.

" - } - } - }, - "EnableDomainAutoRenewResponse":{ - "type":"structure", - "members":{ - } - }, - "EnableDomainTransferLockRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to set the transfer lock for.

" - } - }, - "documentation":"

A request to set the transfer lock for the specified domain.

" - }, - "EnableDomainTransferLockResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The EnableDomainTransferLock response includes the following elements.

" - }, - "ErrorMessage":{"type":"string"}, - "ExtraParam":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"ExtraParamName", - "documentation":"

Name of the additional parameter required by the top-level domain. Here are the top-level domains that require additional parameters and which parameters they require:

  • .com.au and .net.au: AU_ID_NUMBER and AU_ID_TYPE

  • .ca: BRAND_NUMBER, CA_LEGAL_TYPE, and CA_BUSINESS_ENTITY_TYPE

  • .es: ES_IDENTIFICATION, ES_IDENTIFICATION_TYPE, and ES_LEGAL_FORM

  • .fi: BIRTH_DATE_IN_YYYY_MM_DD, FI_BUSINESS_NUMBER, FI_ID_NUMBER, FI_NATIONALITY, and FI_ORGANIZATION_TYPE

  • .fr: BRAND_NUMBER, BIRTH_DEPARTMENT, BIRTH_DATE_IN_YYYY_MM_DD, BIRTH_COUNTRY, and BIRTH_CITY

  • .it: BIRTH_COUNTRY, IT_PIN, and IT_REGISTRANT_ENTITY_TYPE

  • .ru: BIRTH_DATE_IN_YYYY_MM_DD and RU_PASSPORT_DATA

  • .se: BIRTH_COUNTRY and SE_ID_NUMBER

  • .sg: SG_ID_NUMBER

  • .co.uk, .me.uk, and .org.uk: UK_CONTACT_TYPE and UK_COMPANY_NUMBER

In addition, many TLDs require VAT_NUMBER.

" - }, - "Value":{ - "shape":"ExtraParamValue", - "documentation":"

Values corresponding to the additional parameter names required by some top-level domains.

" - } - }, - "documentation":"

ExtraParam includes the following elements.

" - }, - "ExtraParamList":{ - "type":"list", - "member":{"shape":"ExtraParam"} - }, - "ExtraParamName":{ - "type":"string", - "enum":[ - "DUNS_NUMBER", - "BRAND_NUMBER", - "BIRTH_DEPARTMENT", - "BIRTH_DATE_IN_YYYY_MM_DD", - "BIRTH_COUNTRY", - "BIRTH_CITY", - "DOCUMENT_NUMBER", - "AU_ID_NUMBER", - "AU_ID_TYPE", - "CA_LEGAL_TYPE", - "CA_BUSINESS_ENTITY_TYPE", - "ES_IDENTIFICATION", - "ES_IDENTIFICATION_TYPE", - "ES_LEGAL_FORM", - "FI_BUSINESS_NUMBER", - "FI_ID_NUMBER", - "FI_NATIONALITY", - "FI_ORGANIZATION_TYPE", - "IT_PIN", - "IT_REGISTRANT_ENTITY_TYPE", - "RU_PASSPORT_DATA", - "SE_ID_NUMBER", - "SG_ID_NUMBER", - "VAT_NUMBER", - "UK_CONTACT_TYPE", - "UK_COMPANY_NUMBER" - ] - }, - "ExtraParamValue":{ - "type":"string", - "max":2048 - }, - "FIAuthKey":{"type":"string"}, - "GetContactReachabilityStatusRequest":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain for which you want to know whether the registrant contact has confirmed that the email address is valid.

" - } - } - }, - "GetContactReachabilityStatusResponse":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name for which you requested the reachability status.

" - }, - "status":{ - "shape":"ReachabilityStatus", - "documentation":"

Whether the registrant contact has responded. Values include the following:

PENDING

We sent the confirmation email and haven't received a response yet.

DONE

We sent the email and got confirmation from the registrant contact.

EXPIRED

The time limit expired before the registrant contact responded.

" - } - } - }, - "GetDomainDetailRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to get detailed information about.

" - } - }, - "documentation":"

The GetDomainDetail request includes the following element.

" - }, - "GetDomainDetailResponse":{ - "type":"structure", - "required":[ - "DomainName", - "Nameservers", - "AdminContact", - "RegistrantContact", - "TechContact" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of a domain.

" - }, - "Nameservers":{ - "shape":"NameserverList", - "documentation":"

The name of the domain.

" - }, - "AutoRenew":{ - "shape":"Boolean", - "documentation":"

Specifies whether the domain registration is set to renew automatically.

" - }, - "AdminContact":{ - "shape":"ContactDetail", - "documentation":"

Provides details about the domain administrative contact.

" - }, - "RegistrantContact":{ - "shape":"ContactDetail", - "documentation":"

Provides details about the domain registrant.

" - }, - "TechContact":{ - "shape":"ContactDetail", - "documentation":"

Provides details about the domain technical contact.

" - }, - "AdminPrivacy":{ - "shape":"Boolean", - "documentation":"

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the admin contact.

" - }, - "RegistrantPrivacy":{ - "shape":"Boolean", - "documentation":"

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

" - }, - "TechPrivacy":{ - "shape":"Boolean", - "documentation":"

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the technical contact.

" - }, - "RegistrarName":{ - "shape":"RegistrarName", - "documentation":"

Name of the registrar of the domain as identified in the registry. Domains with a .com, .net, or .org TLD are registered by Amazon Registrar. All other domains are registered by our registrar associate, Gandi. The value for domains that are registered by Gandi is \"GANDI SAS\".

" - }, - "WhoIsServer":{ - "shape":"RegistrarWhoIsServer", - "documentation":"

The fully qualified name of the WHOIS server that can answer the WHOIS query for the domain.

" - }, - "RegistrarUrl":{ - "shape":"RegistrarUrl", - "documentation":"

Web address of the registrar.

" - }, - "AbuseContactEmail":{ - "shape":"Email", - "documentation":"

Email address to contact to report incorrect contact information for a domain, to report that the domain is being used to send spam, to report that someone is cybersquatting on a domain name, or report some other type of abuse.

" - }, - "AbuseContactPhone":{ - "shape":"ContactNumber", - "documentation":"

Phone number for reporting abuse.

" - }, - "RegistryDomainId":{ - "shape":"RegistryDomainId", - "documentation":"

Reserved for future use.

" - }, - "CreationDate":{ - "shape":"Timestamp", - "documentation":"

The date when the domain was created as found in the response to a WHOIS query. The date and time is in Coordinated Universal time (UTC).

" - }, - "UpdatedDate":{ - "shape":"Timestamp", - "documentation":"

The last updated date of the domain as found in the response to a WHOIS query. The date and time is in Coordinated Universal time (UTC).

" - }, - "ExpirationDate":{ - "shape":"Timestamp", - "documentation":"

The date when the registration for the domain is set to expire. The date and time is in Coordinated Universal time (UTC).

" - }, - "Reseller":{ - "shape":"Reseller", - "documentation":"

Reseller of the domain. Domains registered or transferred using Amazon Route 53 domains will have \"Amazon\" as the reseller.

" - }, - "DnsSec":{ - "shape":"DNSSec", - "documentation":"

Reserved for future use.

" - }, - "StatusList":{ - "shape":"DomainStatusList", - "documentation":"

An array of domain name status codes, also known as Extensible Provisioning Protocol (EPP) status codes.

ICANN, the organization that maintains a central database of domain names, has developed a set of domain name status codes that tell you the status of a variety of operations on a domain name, for example, registering a domain name, transferring a domain name to another registrar, renewing the registration for a domain name, and so on. All registrars use this same set of status codes.

For a current list of domain name status codes and an explanation of what each code means, go to the ICANN website and search for epp status codes. (Search on the ICANN website; web searches sometimes return an old version of the document.)

" - } - }, - "documentation":"

The GetDomainDetail response includes the following elements.

" - }, - "GetDomainSuggestionsRequest":{ - "type":"structure", - "required":[ - "DomainName", - "SuggestionCount", - "OnlyAvailable" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

A domain name that you want to use as the basis for a list of possible domain names. The domain name must contain a top-level domain (TLD), such as .com, that Amazon Route 53 supports. For a list of TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

" - }, - "SuggestionCount":{ - "shape":"Integer", - "documentation":"

The number of suggested domain names that you want Amazon Route 53 to return.

" - }, - "OnlyAvailable":{ - "shape":"Boolean", - "documentation":"

If OnlyAvailable is true, Amazon Route 53 returns only domain names that are available. If OnlyAvailable is false, Amazon Route 53 returns domain names without checking whether they're available to be registered. To determine whether the domain is available, you can call checkDomainAvailability for each suggestion.

" - } - } - }, - "GetDomainSuggestionsResponse":{ - "type":"structure", - "members":{ - "SuggestionsList":{ - "shape":"DomainSuggestionsList", - "documentation":"

A list of possible domain names. If you specified true for OnlyAvailable in the request, the list contains only domains that are available for registration.

" - } - } - }, - "GetOperationDetailRequest":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

The identifier for the operation for which you want to get the status. Amazon Route 53 returned the identifier in the response to the original request.

" - } - }, - "documentation":"

The GetOperationDetail request includes the following element.

" - }, - "GetOperationDetailResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

The identifier for the operation.

" - }, - "Status":{ - "shape":"OperationStatus", - "documentation":"

The current status of the requested operation in the system.

" - }, - "Message":{ - "shape":"ErrorMessage", - "documentation":"

Detailed information on the status including possible errors.

" - }, - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of a domain.

" - }, - "Type":{ - "shape":"OperationType", - "documentation":"

The type of operation that was requested.

" - }, - "SubmittedDate":{ - "shape":"Timestamp", - "documentation":"

The date when the request was submitted.

" - } - }, - "documentation":"

The GetOperationDetail response includes the following elements.

" - }, - "GlueIp":{ - "type":"string", - "max":45 - }, - "GlueIpList":{ - "type":"list", - "member":{"shape":"GlueIp"} - }, - "HostName":{ - "type":"string", - "max":255, - "pattern":"[a-zA-Z0-9_\\-.]*" - }, - "Integer":{"type":"integer"}, - "InvalidInput":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

" - } - }, - "documentation":"

The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

", - "exception":true - }, - "InvoiceId":{"type":"string"}, - "LangCode":{ - "type":"string", - "max":3 - }, - "ListDomainsRequest":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"PageMarker", - "documentation":"

For an initial request for a list of domains, omit this element. If the number of domains that are associated with the current AWS account is greater than the value that you specified for MaxItems, you can use Marker to return additional domains. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

Constraints: The marker must match the value specified in the previous request.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

Number of domains to be returned.

Default: 20

" - } - }, - "documentation":"

The ListDomains request includes the following elements.

" - }, - "ListDomainsResponse":{ - "type":"structure", - "required":["Domains"], - "members":{ - "Domains":{ - "shape":"DomainSummaryList", - "documentation":"

A summary of domains.

" - }, - "NextPageMarker":{ - "shape":"PageMarker", - "documentation":"

If there are more domains than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

" - } - }, - "documentation":"

The ListDomains response includes the following elements.

" - }, - "ListOperationsRequest":{ - "type":"structure", - "members":{ - "SubmittedSince":{ - "shape":"Timestamp", - "documentation":"

An optional parameter that lets you get information about all the operations that you submitted after a specified date and time. Specify the date and time in Coordinated Universal time (UTC).

" - }, - "Marker":{ - "shape":"PageMarker", - "documentation":"

For an initial request for a list of operations, omit this element. If the number of operations that are not yet complete is greater than the value that you specified for MaxItems, you can use Marker to return additional operations. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

Number of domains to be returned.

Default: 20

" - } - }, - "documentation":"

The ListOperations request includes the following elements.

" - }, - "ListOperationsResponse":{ - "type":"structure", - "required":["Operations"], - "members":{ - "Operations":{ - "shape":"OperationSummaryList", - "documentation":"

Lists summaries of the operations.

" - }, - "NextPageMarker":{ - "shape":"PageMarker", - "documentation":"

If there are more operations than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

" - } - }, - "documentation":"

The ListOperations response includes the following elements.

" - }, - "ListTagsForDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The domain for which you want to get a list of tags.

" - } - }, - "documentation":"

The ListTagsForDomainRequest includes the following elements.

" - }, - "ListTagsForDomainResponse":{ - "type":"structure", - "required":["TagList"], - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

A list of the tags that are associated with the specified domain.

" - } - }, - "documentation":"

The ListTagsForDomain response includes the following elements.

" - }, - "Nameserver":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"HostName", - "documentation":"

The fully qualified host name of the name server.

Constraint: Maximum 255 characters

" - }, - "GlueIps":{ - "shape":"GlueIpList", - "documentation":"

Glue IP address of a name server entry. Glue IP addresses are required only when the name of the name server is a subdomain of the domain. For example, if your domain is example.com and the name server for the domain is ns.example.com, you need to specify the IP address for ns.example.com.

Constraints: The list can contain only one IPv4 and one IPv6 address.

" - } - }, - "documentation":"

Nameserver includes the following elements.

" - }, - "NameserverList":{ - "type":"list", - "member":{"shape":"Nameserver"} - }, - "OperationId":{ - "type":"string", - "max":255 - }, - "OperationLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The number of operations or jobs running exceeded the allowed threshold for the account.

" - } - }, - "documentation":"

The number of operations or jobs running exceeded the allowed threshold for the account.

", - "exception":true - }, - "OperationStatus":{ - "type":"string", - "enum":[ - "SUBMITTED", - "IN_PROGRESS", - "ERROR", - "SUCCESSFUL", - "FAILED" - ] - }, - "OperationSummary":{ - "type":"structure", - "required":[ - "OperationId", - "Status", - "Type", - "SubmittedDate" - ], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier returned to track the requested action.

" - }, - "Status":{ - "shape":"OperationStatus", - "documentation":"

The current status of the requested operation in the system.

" - }, - "Type":{ - "shape":"OperationType", - "documentation":"

Type of the action requested.

" - }, - "SubmittedDate":{ - "shape":"Timestamp", - "documentation":"

The date when the request was submitted.

" - } - }, - "documentation":"

OperationSummary includes the following elements.

" - }, - "OperationSummaryList":{ - "type":"list", - "member":{"shape":"OperationSummary"} - }, - "OperationType":{ - "type":"string", - "enum":[ - "REGISTER_DOMAIN", - "DELETE_DOMAIN", - "TRANSFER_IN_DOMAIN", - "UPDATE_DOMAIN_CONTACT", - "UPDATE_NAMESERVER", - "CHANGE_PRIVACY_PROTECTION", - "DOMAIN_LOCK", - "ENABLE_AUTORENEW", - "DISABLE_AUTORENEW", - "ADD_DNSSEC", - "REMOVE_DNSSEC", - "EXPIRE_DOMAIN", - "TRANSFER_OUT_DOMAIN", - "CHANGE_DOMAIN_OWNER", - "RENEW_DOMAIN", - "PUSH_DOMAIN" - ] - }, - "PageMarker":{ - "type":"string", - "max":4096 - }, - "PageMaxItems":{ - "type":"integer", - "max":100 - }, - "Price":{"type":"double"}, - "ReachabilityStatus":{ - "type":"string", - "enum":[ - "PENDING", - "DONE", - "EXPIRED" - ] - }, - "RegisterDomainRequest":{ - "type":"structure", - "required":[ - "DomainName", - "DurationInYears", - "AdminContact", - "RegistrantContact", - "TechContact" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The domain name that you want to register.

Constraints: The domain name can contain only the letters a through z, the numbers 0 through 9, and hyphen (-). Internationalized Domain Names are not supported.

" - }, - "IdnLangCode":{ - "shape":"LangCode", - "documentation":"

Reserved for future use.

" - }, - "DurationInYears":{ - "shape":"DurationInYears", - "documentation":"

The number of years that you want to register the domain for. Domains are registered for a minimum of one year. The maximum period depends on the top-level domain. For the range of valid values for your domain, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

Default: 1

" - }, - "AutoRenew":{ - "shape":"Boolean", - "documentation":"

Indicates whether the domain will be automatically renewed (true) or not (false). Autorenewal only takes effect after the account is charged.

Default: true

" - }, - "AdminContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "RegistrantContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "TechContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "PrivacyProtectAdminContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

Default: true

" - }, - "PrivacyProtectRegistrantContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (the domain owner).

Default: true

" - }, - "PrivacyProtectTechContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

Default: true

" - } - }, - "documentation":"

The RegisterDomain request includes the following elements.

" - }, - "RegisterDomainResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The RegisterDomain response includes the following element.

" - }, - "RegistrarName":{"type":"string"}, - "RegistrarUrl":{"type":"string"}, - "RegistrarWhoIsServer":{"type":"string"}, - "RegistryDomainId":{"type":"string"}, - "RenewDomainRequest":{ - "type":"structure", - "required":[ - "DomainName", - "CurrentExpiryYear" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to renew.

" - }, - "DurationInYears":{ - "shape":"DurationInYears", - "documentation":"

The number of years that you want to renew the domain for. The maximum number of years depends on the top-level domain. For the range of valid values for your domain, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

Default: 1

" - }, - "CurrentExpiryYear":{ - "shape":"CurrentExpiryYear", - "documentation":"

The year when the registration for the domain is set to expire. This value must match the current expiration date for the domain.

" - } - }, - "documentation":"

A RenewDomain request includes the number of years that you want to renew for and the current expiration year.

" - }, - "RenewDomainResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

The identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - } - }, - "Reseller":{"type":"string"}, - "ResendContactReachabilityEmailRequest":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain for which you want Amazon Route 53 to resend a confirmation email to the registrant contact.

" - } - } - }, - "ResendContactReachabilityEmailResponse":{ - "type":"structure", - "members":{ - "domainName":{ - "shape":"DomainName", - "documentation":"

The domain name for which you requested a confirmation email.

" - }, - "emailAddress":{ - "shape":"Email", - "documentation":"

The email address for the registrant contact at the time that we sent the verification email.

" - }, - "isAlreadyVerified":{ - "shape":"Boolean", - "documentation":"

True if the email address for the registrant contact has already been verified, and false otherwise. If the email address has already been verified, we don't send another confirmation email.

" - } - } - }, - "RetrieveDomainAuthCodeRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to get an authorization code for.

" - } - }, - "documentation":"

A request for the authorization code for the specified domain. To transfer a domain to another registrar, you provide this value to the new registrar.

" - }, - "RetrieveDomainAuthCodeResponse":{ - "type":"structure", - "required":["AuthCode"], - "members":{ - "AuthCode":{ - "shape":"DomainAuthCode", - "documentation":"

The authorization code for the domain.

" - } - }, - "documentation":"

The RetrieveDomainAuthCode response includes the following element.

" - }, - "State":{ - "type":"string", - "max":255 - }, - "String":{"type":"string"}, - "TLDRulesViolation":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The top-level domain does not support this operation.

" - } - }, - "documentation":"

The top-level domain does not support this operation.

", - "exception":true - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key (name) of a tag.

Valid values: A-Z, a-z, 0-9, space, \".:/=+\\-@\"

Constraints: Each key can be 1-128 characters long.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of a tag.

Valid values: A-Z, a-z, 0-9, space, \".:/=+\\-@\"

Constraints: Each value can be 0-256 characters long.

" - } - }, - "documentation":"

Each tag includes the following elements.

" - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{"type":"string"}, - "Timestamp":{"type":"timestamp"}, - "TransferDomainRequest":{ - "type":"structure", - "required":[ - "DomainName", - "DurationInYears", - "AdminContact", - "RegistrantContact", - "TechContact" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to transfer to Amazon Route 53.

Constraints: The domain name can contain only the letters a through z, the numbers 0 through 9, and hyphen (-). Internationalized Domain Names are not supported.

" - }, - "IdnLangCode":{ - "shape":"LangCode", - "documentation":"

Reserved for future use.

" - }, - "DurationInYears":{ - "shape":"DurationInYears", - "documentation":"

The number of years that you want to register the domain for. Domains are registered for a minimum of one year. The maximum period depends on the top-level domain.

Default: 1

" - }, - "Nameservers":{ - "shape":"NameserverList", - "documentation":"

Contains details for the host and glue IP addresses.

" - }, - "AuthCode":{ - "shape":"DomainAuthCode", - "documentation":"

The authorization code for the domain. You get this value from the current registrar.

" - }, - "AutoRenew":{ - "shape":"Boolean", - "documentation":"

Indicates whether the domain will be automatically renewed (true) or not (false). Autorenewal only takes effect after the account is charged.

Default: true

" - }, - "AdminContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "RegistrantContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "TechContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "PrivacyProtectAdminContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

Default: true

" - }, - "PrivacyProtectRegistrantContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

Default: true

" - }, - "PrivacyProtectTechContact":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

Default: true

" - } - }, - "documentation":"

The TransferDomain request includes the following elements.

" - }, - "TransferDomainResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The TranserDomain response includes the following element.

" - }, - "Transferable":{ - "type":"string", - "documentation":"

Whether the domain name can be transferred to Amazon Route 53.

You can transfer only domains that have a value of TRANSFERABLE for Transferable.

Valid values:

TRANSFERABLE

The domain name can be transferred to Amazon Route 53.

UNTRANSFERRABLE

The domain name can't be transferred to Amazon Route 53.

DONT_KNOW

Reserved for future use.

", - "enum":[ - "TRANSFERABLE", - "UNTRANSFERABLE", - "DONT_KNOW" - ] - }, - "UnsupportedTLD":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

Amazon Route 53 does not support this top-level domain (TLD).

" - } - }, - "documentation":"

Amazon Route 53 does not support this top-level domain (TLD).

", - "exception":true - }, - "UpdateDomainContactPrivacyRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to update the privacy setting for.

" - }, - "AdminPrivacy":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

" - }, - "RegistrantPrivacy":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

" - }, - "TechPrivacy":{ - "shape":"Boolean", - "documentation":"

Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (\"who is\") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

" - } - }, - "documentation":"

The UpdateDomainContactPrivacy request includes the following elements.

" - }, - "UpdateDomainContactPrivacyResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The UpdateDomainContactPrivacy response includes the following element.

" - }, - "UpdateDomainContactRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to update contact information for.

" - }, - "AdminContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "RegistrantContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - }, - "TechContact":{ - "shape":"ContactDetail", - "documentation":"

Provides detailed contact information.

" - } - }, - "documentation":"

The UpdateDomainContact request includes the following elements.

" - }, - "UpdateDomainContactResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The UpdateDomainContact response includes the following element.

" - }, - "UpdateDomainNameserversRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Nameservers" - ], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want to change name servers for.

" - }, - "FIAuthKey":{ - "shape":"FIAuthKey", - "documentation":"

The authorization key for .fi domains

", - "deprecated":true - }, - "Nameservers":{ - "shape":"NameserverList", - "documentation":"

A list of new name servers for the domain.

" - } - }, - "documentation":"

Replaces the current set of name servers for the domain with the specified set of name servers. If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.

If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

" - }, - "UpdateDomainNameserversResponse":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

" - } - }, - "documentation":"

The UpdateDomainNameservers response includes the following element.

" - }, - "UpdateTagsForDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"DomainName", - "documentation":"

The domain for which you want to add or update tags.

" - }, - "TagsToUpdate":{ - "shape":"TagList", - "documentation":"

A list of the tag keys and values that you want to add or update. If you specify a key that already exists, the corresponding value will be replaced.

" - } - }, - "documentation":"

The UpdateTagsForDomainRequest includes the following elements.

" - }, - "UpdateTagsForDomainResponse":{ - "type":"structure", - "members":{ - } - }, - "ViewBillingRequest":{ - "type":"structure", - "members":{ - "Start":{ - "shape":"Timestamp", - "documentation":"

The beginning date and time for the time period for which you want a list of billing records. Specify the date and time in Coordinated Universal time (UTC).

" - }, - "End":{ - "shape":"Timestamp", - "documentation":"

The end date and time for the time period for which you want a list of billing records. Specify the date and time in Coordinated Universal time (UTC).

" - }, - "Marker":{ - "shape":"PageMarker", - "documentation":"

For an initial request for a list of billing records, omit this element. If the number of billing records that are associated with the current AWS account during the specified period is greater than the value that you specified for MaxItems, you can use Marker to return additional billing records. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

Constraints: The marker must match the value of NextPageMarker that was returned in the previous response.

" - }, - "MaxItems":{ - "shape":"PageMaxItems", - "documentation":"

The number of billing records to be returned.

Default: 20

" - } - }, - "documentation":"

The ViewBilling request includes the following elements.

" - }, - "ViewBillingResponse":{ - "type":"structure", - "members":{ - "NextPageMarker":{ - "shape":"PageMarker", - "documentation":"

If there are more billing records than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

" - }, - "BillingRecords":{ - "shape":"BillingRecords", - "documentation":"

A summary of billing records.

" - } - }, - "documentation":"

The ViewBilling response includes the following elements.

" - }, - "ZipCode":{ - "type":"string", - "max":255 - } - }, - "documentation":"

Amazon Route 53 API actions let you register domain names and perform related operations.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/paginators-1.json deleted file mode 100644 index d6c97ba4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/paginators-1.json +++ /dev/null @@ -1,69 +0,0 @@ -{ - "pagination": { - "ListMultipartUploads": { - "limit_key": "MaxUploads", - "more_results": "IsTruncated", - "output_token": [ - "NextKeyMarker", - "NextUploadIdMarker" - ], - "input_token": [ - "KeyMarker", - "UploadIdMarker" - ], - "result_key": [ - "Uploads", - "CommonPrefixes" - ] - }, - "ListObjectVersions": { - "more_results": "IsTruncated", - "limit_key": "MaxKeys", - "output_token": [ - "NextKeyMarker", - "NextVersionIdMarker" - ], - "input_token": [ - "KeyMarker", - "VersionIdMarker" - ], - "result_key": [ - "Versions", - "DeleteMarkers", - "CommonPrefixes" - ] - }, - "ListObjects": { - "more_results": "IsTruncated", - "limit_key": "MaxKeys", - "output_token": "NextMarker || Contents[-1].Key", - "input_token": "Marker", - "result_key": [ - "Contents", - "CommonPrefixes" - ] - }, - "ListObjectsV2": { - "more_results": "IsTruncated", - "limit_key": "MaxKeys", - "output_token": "NextContinuationToken", - "input_token": "ContinuationToken", - "result_key": [ - "Contents", - "CommonPrefixes" - ] - }, - "ListParts": { - "more_results": "IsTruncated", - "limit_key": "MaxParts", - "output_token": "NextPartNumberMarker", - "input_token": "PartNumberMarker", - "result_key": "Parts", - "non_aggregate_keys": [ - "Initiator", - "Owner", - "StorageClass" - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/service-2.json deleted file mode 100644 index 6ac6bf10..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/service-2.json +++ /dev/null @@ -1,7090 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2006-03-01", - "checksumFormat":"md5", - "endpointPrefix":"s3", - "globalEndpoint":"s3.amazonaws.com", - "protocol":"rest-xml", - "serviceAbbreviation":"Amazon S3", - "serviceFullName":"Amazon Simple Storage Service", - "serviceId":"S3", - "signatureVersion":"s3", - "timestampFormat":"rfc822", - "uid":"s3-2006-03-01" - }, - "operations":{ - "AbortMultipartUpload":{ - "name":"AbortMultipartUpload", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"AbortMultipartUploadRequest"}, - "output":{"shape":"AbortMultipartUploadOutput"}, - "errors":[ - {"shape":"NoSuchUpload"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadAbort.html", - "documentation":"

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

" - }, - "CompleteMultipartUpload":{ - "name":"CompleteMultipartUpload", - "http":{ - "method":"POST", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"CompleteMultipartUploadRequest"}, - "output":{"shape":"CompleteMultipartUploadOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadComplete.html", - "documentation":"

Completes a multipart upload by assembling previously uploaded parts.

" - }, - "CopyObject":{ - "name":"CopyObject", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"CopyObjectRequest"}, - "output":{"shape":"CopyObjectOutput"}, - "errors":[ - {"shape":"ObjectNotInActiveTierError"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectCOPY.html", - "documentation":"

Creates a copy of an object that is already stored in Amazon S3.

", - "alias":"PutObjectCopy" - }, - "CreateBucket":{ - "name":"CreateBucket", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}" - }, - "input":{"shape":"CreateBucketRequest"}, - "output":{"shape":"CreateBucketOutput"}, - "errors":[ - {"shape":"BucketAlreadyExists"}, - {"shape":"BucketAlreadyOwnedByYou"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUT.html", - "documentation":"

Creates a new bucket.

", - "alias":"PutBucket" - }, - "CreateMultipartUpload":{ - "name":"CreateMultipartUpload", - "http":{ - "method":"POST", - "requestUri":"/{Bucket}/{Key+}?uploads" - }, - "input":{"shape":"CreateMultipartUploadRequest"}, - "output":{"shape":"CreateMultipartUploadOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadInitiate.html", - "documentation":"

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

", - "alias":"InitiateMultipartUpload" - }, - "DeleteBucket":{ - "name":"DeleteBucket", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}" - }, - "input":{"shape":"DeleteBucketRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETE.html", - "documentation":"

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

" - }, - "DeleteBucketAnalyticsConfiguration":{ - "name":"DeleteBucketAnalyticsConfiguration", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?analytics" - }, - "input":{"shape":"DeleteBucketAnalyticsConfigurationRequest"}, - "documentation":"

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

" - }, - "DeleteBucketCors":{ - "name":"DeleteBucketCors", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?cors" - }, - "input":{"shape":"DeleteBucketCorsRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEcors.html", - "documentation":"

Deletes the cors configuration information set for the bucket.

" - }, - "DeleteBucketEncryption":{ - "name":"DeleteBucketEncryption", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?encryption" - }, - "input":{"shape":"DeleteBucketEncryptionRequest"}, - "documentation":"

Deletes the server-side encryption configuration from the bucket.

" - }, - "DeleteBucketInventoryConfiguration":{ - "name":"DeleteBucketInventoryConfiguration", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?inventory" - }, - "input":{"shape":"DeleteBucketInventoryConfigurationRequest"}, - "documentation":"

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

" - }, - "DeleteBucketLifecycle":{ - "name":"DeleteBucketLifecycle", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?lifecycle" - }, - "input":{"shape":"DeleteBucketLifecycleRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETElifecycle.html", - "documentation":"

Deletes the lifecycle configuration from the bucket.

" - }, - "DeleteBucketMetricsConfiguration":{ - "name":"DeleteBucketMetricsConfiguration", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?metrics" - }, - "input":{"shape":"DeleteBucketMetricsConfigurationRequest"}, - "documentation":"

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

" - }, - "DeleteBucketPolicy":{ - "name":"DeleteBucketPolicy", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?policy" - }, - "input":{"shape":"DeleteBucketPolicyRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEpolicy.html", - "documentation":"

Deletes the policy from the bucket.

" - }, - "DeleteBucketReplication":{ - "name":"DeleteBucketReplication", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?replication" - }, - "input":{"shape":"DeleteBucketReplicationRequest"}, - "documentation":"

Deletes the replication configuration from the bucket.

" - }, - "DeleteBucketTagging":{ - "name":"DeleteBucketTagging", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?tagging" - }, - "input":{"shape":"DeleteBucketTaggingRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEtagging.html", - "documentation":"

Deletes the tags from the bucket.

" - }, - "DeleteBucketWebsite":{ - "name":"DeleteBucketWebsite", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}?website" - }, - "input":{"shape":"DeleteBucketWebsiteRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEwebsite.html", - "documentation":"

This operation removes the website configuration from the bucket.

" - }, - "DeleteObject":{ - "name":"DeleteObject", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"DeleteObjectRequest"}, - "output":{"shape":"DeleteObjectOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectDELETE.html", - "documentation":"

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

" - }, - "DeleteObjectTagging":{ - "name":"DeleteObjectTagging", - "http":{ - "method":"DELETE", - "requestUri":"/{Bucket}/{Key+}?tagging" - }, - "input":{"shape":"DeleteObjectTaggingRequest"}, - "output":{"shape":"DeleteObjectTaggingOutput"}, - "documentation":"

Removes the tag-set from an existing object.

" - }, - "DeleteObjects":{ - "name":"DeleteObjects", - "http":{ - "method":"POST", - "requestUri":"/{Bucket}?delete" - }, - "input":{"shape":"DeleteObjectsRequest"}, - "output":{"shape":"DeleteObjectsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/multiobjectdeleteapi.html", - "documentation":"

This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.

", - "alias":"DeleteMultipleObjects" - }, - "GetBucketAccelerateConfiguration":{ - "name":"GetBucketAccelerateConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?accelerate" - }, - "input":{"shape":"GetBucketAccelerateConfigurationRequest"}, - "output":{"shape":"GetBucketAccelerateConfigurationOutput"}, - "documentation":"

Returns the accelerate configuration of a bucket.

" - }, - "GetBucketAcl":{ - "name":"GetBucketAcl", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?acl" - }, - "input":{"shape":"GetBucketAclRequest"}, - "output":{"shape":"GetBucketAclOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETacl.html", - "documentation":"

Gets the access control policy for the bucket.

" - }, - "GetBucketAnalyticsConfiguration":{ - "name":"GetBucketAnalyticsConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?analytics" - }, - "input":{"shape":"GetBucketAnalyticsConfigurationRequest"}, - "output":{"shape":"GetBucketAnalyticsConfigurationOutput"}, - "documentation":"

Gets an analytics configuration for the bucket (specified by the analytics configuration ID).

" - }, - "GetBucketCors":{ - "name":"GetBucketCors", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?cors" - }, - "input":{"shape":"GetBucketCorsRequest"}, - "output":{"shape":"GetBucketCorsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETcors.html", - "documentation":"

Returns the cors configuration for the bucket.

" - }, - "GetBucketEncryption":{ - "name":"GetBucketEncryption", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?encryption" - }, - "input":{"shape":"GetBucketEncryptionRequest"}, - "output":{"shape":"GetBucketEncryptionOutput"}, - "documentation":"

Returns the server-side encryption configuration of a bucket.

" - }, - "GetBucketInventoryConfiguration":{ - "name":"GetBucketInventoryConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?inventory" - }, - "input":{"shape":"GetBucketInventoryConfigurationRequest"}, - "output":{"shape":"GetBucketInventoryConfigurationOutput"}, - "documentation":"

Returns an inventory configuration (identified by the inventory ID) from the bucket.

" - }, - "GetBucketLifecycle":{ - "name":"GetBucketLifecycle", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?lifecycle" - }, - "input":{"shape":"GetBucketLifecycleRequest"}, - "output":{"shape":"GetBucketLifecycleOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlifecycle.html", - "documentation":"

Deprecated, see the GetBucketLifecycleConfiguration operation.

", - "deprecated":true - }, - "GetBucketLifecycleConfiguration":{ - "name":"GetBucketLifecycleConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?lifecycle" - }, - "input":{"shape":"GetBucketLifecycleConfigurationRequest"}, - "output":{"shape":"GetBucketLifecycleConfigurationOutput"}, - "documentation":"

Returns the lifecycle configuration information set on the bucket.

" - }, - "GetBucketLocation":{ - "name":"GetBucketLocation", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?location" - }, - "input":{"shape":"GetBucketLocationRequest"}, - "output":{"shape":"GetBucketLocationOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlocation.html", - "documentation":"

Returns the region the bucket resides in.

" - }, - "GetBucketLogging":{ - "name":"GetBucketLogging", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?logging" - }, - "input":{"shape":"GetBucketLoggingRequest"}, - "output":{"shape":"GetBucketLoggingOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlogging.html", - "documentation":"

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

" - }, - "GetBucketMetricsConfiguration":{ - "name":"GetBucketMetricsConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?metrics" - }, - "input":{"shape":"GetBucketMetricsConfigurationRequest"}, - "output":{"shape":"GetBucketMetricsConfigurationOutput"}, - "documentation":"

Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.

" - }, - "GetBucketNotification":{ - "name":"GetBucketNotification", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?notification" - }, - "input":{"shape":"GetBucketNotificationConfigurationRequest"}, - "output":{"shape":"NotificationConfigurationDeprecated"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETnotification.html", - "documentation":"

Deprecated, see the GetBucketNotificationConfiguration operation.

", - "deprecated":true - }, - "GetBucketNotificationConfiguration":{ - "name":"GetBucketNotificationConfiguration", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?notification" - }, - "input":{"shape":"GetBucketNotificationConfigurationRequest"}, - "output":{"shape":"NotificationConfiguration"}, - "documentation":"

Returns the notification configuration of a bucket.

" - }, - "GetBucketPolicy":{ - "name":"GetBucketPolicy", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?policy" - }, - "input":{"shape":"GetBucketPolicyRequest"}, - "output":{"shape":"GetBucketPolicyOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETpolicy.html", - "documentation":"

Returns the policy of a specified bucket.

" - }, - "GetBucketReplication":{ - "name":"GetBucketReplication", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?replication" - }, - "input":{"shape":"GetBucketReplicationRequest"}, - "output":{"shape":"GetBucketReplicationOutput"}, - "documentation":"

Returns the replication configuration of a bucket.

" - }, - "GetBucketRequestPayment":{ - "name":"GetBucketRequestPayment", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?requestPayment" - }, - "input":{"shape":"GetBucketRequestPaymentRequest"}, - "output":{"shape":"GetBucketRequestPaymentOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentGET.html", - "documentation":"

Returns the request payment configuration of a bucket.

" - }, - "GetBucketTagging":{ - "name":"GetBucketTagging", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?tagging" - }, - "input":{"shape":"GetBucketTaggingRequest"}, - "output":{"shape":"GetBucketTaggingOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETtagging.html", - "documentation":"

Returns the tag set associated with the bucket.

" - }, - "GetBucketVersioning":{ - "name":"GetBucketVersioning", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?versioning" - }, - "input":{"shape":"GetBucketVersioningRequest"}, - "output":{"shape":"GetBucketVersioningOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETversioningStatus.html", - "documentation":"

Returns the versioning state of a bucket.

" - }, - "GetBucketWebsite":{ - "name":"GetBucketWebsite", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?website" - }, - "input":{"shape":"GetBucketWebsiteRequest"}, - "output":{"shape":"GetBucketWebsiteOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETwebsite.html", - "documentation":"

Returns the website configuration for a bucket.

" - }, - "GetObject":{ - "name":"GetObject", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"GetObjectRequest"}, - "output":{"shape":"GetObjectOutput"}, - "errors":[ - {"shape":"NoSuchKey"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGET.html", - "documentation":"

Retrieves objects from Amazon S3.

" - }, - "GetObjectAcl":{ - "name":"GetObjectAcl", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}/{Key+}?acl" - }, - "input":{"shape":"GetObjectAclRequest"}, - "output":{"shape":"GetObjectAclOutput"}, - "errors":[ - {"shape":"NoSuchKey"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGETacl.html", - "documentation":"

Returns the access control list (ACL) of an object.

" - }, - "GetObjectTagging":{ - "name":"GetObjectTagging", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}/{Key+}?tagging" - }, - "input":{"shape":"GetObjectTaggingRequest"}, - "output":{"shape":"GetObjectTaggingOutput"}, - "documentation":"

Returns the tag-set of an object.

" - }, - "GetObjectTorrent":{ - "name":"GetObjectTorrent", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}/{Key+}?torrent" - }, - "input":{"shape":"GetObjectTorrentRequest"}, - "output":{"shape":"GetObjectTorrentOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGETtorrent.html", - "documentation":"

Return torrent files from a bucket.

" - }, - "HeadBucket":{ - "name":"HeadBucket", - "http":{ - "method":"HEAD", - "requestUri":"/{Bucket}" - }, - "input":{"shape":"HeadBucketRequest"}, - "errors":[ - {"shape":"NoSuchBucket"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketHEAD.html", - "documentation":"

This operation is useful to determine if a bucket exists and you have permission to access it.

" - }, - "HeadObject":{ - "name":"HeadObject", - "http":{ - "method":"HEAD", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"HeadObjectRequest"}, - "output":{"shape":"HeadObjectOutput"}, - "errors":[ - {"shape":"NoSuchKey"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectHEAD.html", - "documentation":"

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

" - }, - "ListBucketAnalyticsConfigurations":{ - "name":"ListBucketAnalyticsConfigurations", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?analytics" - }, - "input":{"shape":"ListBucketAnalyticsConfigurationsRequest"}, - "output":{"shape":"ListBucketAnalyticsConfigurationsOutput"}, - "documentation":"

Lists the analytics configurations for the bucket.

" - }, - "ListBucketInventoryConfigurations":{ - "name":"ListBucketInventoryConfigurations", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?inventory" - }, - "input":{"shape":"ListBucketInventoryConfigurationsRequest"}, - "output":{"shape":"ListBucketInventoryConfigurationsOutput"}, - "documentation":"

Returns a list of inventory configurations for the bucket.

" - }, - "ListBucketMetricsConfigurations":{ - "name":"ListBucketMetricsConfigurations", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?metrics" - }, - "input":{"shape":"ListBucketMetricsConfigurationsRequest"}, - "output":{"shape":"ListBucketMetricsConfigurationsOutput"}, - "documentation":"

Lists the metrics configurations for the bucket.

" - }, - "ListBuckets":{ - "name":"ListBuckets", - "http":{ - "method":"GET", - "requestUri":"/" - }, - "output":{"shape":"ListBucketsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTServiceGET.html", - "documentation":"

Returns a list of all buckets owned by the authenticated sender of the request.

", - "alias":"GetService" - }, - "ListMultipartUploads":{ - "name":"ListMultipartUploads", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?uploads" - }, - "input":{"shape":"ListMultipartUploadsRequest"}, - "output":{"shape":"ListMultipartUploadsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListMPUpload.html", - "documentation":"

This operation lists in-progress multipart uploads.

" - }, - "ListObjectVersions":{ - "name":"ListObjectVersions", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?versions" - }, - "input":{"shape":"ListObjectVersionsRequest"}, - "output":{"shape":"ListObjectVersionsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETVersion.html", - "documentation":"

Returns metadata about all of the versions of objects in a bucket.

", - "alias":"GetBucketObjectVersions" - }, - "ListObjects":{ - "name":"ListObjects", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}" - }, - "input":{"shape":"ListObjectsRequest"}, - "output":{"shape":"ListObjectsOutput"}, - "errors":[ - {"shape":"NoSuchBucket"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGET.html", - "documentation":"

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

", - "alias":"GetBucket" - }, - "ListObjectsV2":{ - "name":"ListObjectsV2", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}?list-type=2" - }, - "input":{"shape":"ListObjectsV2Request"}, - "output":{"shape":"ListObjectsV2Output"}, - "errors":[ - {"shape":"NoSuchBucket"} - ], - "documentation":"

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.

" - }, - "ListParts":{ - "name":"ListParts", - "http":{ - "method":"GET", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"ListPartsRequest"}, - "output":{"shape":"ListPartsOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListParts.html", - "documentation":"

Lists the parts that have been uploaded for a specific multipart upload.

" - }, - "PutBucketAccelerateConfiguration":{ - "name":"PutBucketAccelerateConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?accelerate" - }, - "input":{"shape":"PutBucketAccelerateConfigurationRequest"}, - "documentation":"

Sets the accelerate configuration of an existing bucket.

" - }, - "PutBucketAcl":{ - "name":"PutBucketAcl", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?acl" - }, - "input":{"shape":"PutBucketAclRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTacl.html", - "documentation":"

Sets the permissions on a bucket using access control lists (ACL).

" - }, - "PutBucketAnalyticsConfiguration":{ - "name":"PutBucketAnalyticsConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?analytics" - }, - "input":{"shape":"PutBucketAnalyticsConfigurationRequest"}, - "documentation":"

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

" - }, - "PutBucketCors":{ - "name":"PutBucketCors", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?cors" - }, - "input":{"shape":"PutBucketCorsRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTcors.html", - "documentation":"

Sets the cors configuration for a bucket.

" - }, - "PutBucketEncryption":{ - "name":"PutBucketEncryption", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?encryption" - }, - "input":{"shape":"PutBucketEncryptionRequest"}, - "documentation":"

Creates a new server-side encryption configuration (or replaces an existing one, if present).

" - }, - "PutBucketInventoryConfiguration":{ - "name":"PutBucketInventoryConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?inventory" - }, - "input":{"shape":"PutBucketInventoryConfigurationRequest"}, - "documentation":"

Adds an inventory configuration (identified by the inventory ID) from the bucket.

" - }, - "PutBucketLifecycle":{ - "name":"PutBucketLifecycle", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?lifecycle" - }, - "input":{"shape":"PutBucketLifecycleRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html", - "documentation":"

Deprecated, see the PutBucketLifecycleConfiguration operation.

", - "deprecated":true - }, - "PutBucketLifecycleConfiguration":{ - "name":"PutBucketLifecycleConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?lifecycle" - }, - "input":{"shape":"PutBucketLifecycleConfigurationRequest"}, - "documentation":"

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

" - }, - "PutBucketLogging":{ - "name":"PutBucketLogging", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?logging" - }, - "input":{"shape":"PutBucketLoggingRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTlogging.html", - "documentation":"

Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.

" - }, - "PutBucketMetricsConfiguration":{ - "name":"PutBucketMetricsConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?metrics" - }, - "input":{"shape":"PutBucketMetricsConfigurationRequest"}, - "documentation":"

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

" - }, - "PutBucketNotification":{ - "name":"PutBucketNotification", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?notification" - }, - "input":{"shape":"PutBucketNotificationRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTnotification.html", - "documentation":"

Deprecated, see the PutBucketNotificationConfiguraiton operation.

", - "deprecated":true - }, - "PutBucketNotificationConfiguration":{ - "name":"PutBucketNotificationConfiguration", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?notification" - }, - "input":{"shape":"PutBucketNotificationConfigurationRequest"}, - "documentation":"

Enables notifications of specified events for a bucket.

" - }, - "PutBucketPolicy":{ - "name":"PutBucketPolicy", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?policy" - }, - "input":{"shape":"PutBucketPolicyRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTpolicy.html", - "documentation":"

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

" - }, - "PutBucketReplication":{ - "name":"PutBucketReplication", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?replication" - }, - "input":{"shape":"PutBucketReplicationRequest"}, - "documentation":"

Creates a new replication configuration (or replaces an existing one, if present).

" - }, - "PutBucketRequestPayment":{ - "name":"PutBucketRequestPayment", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?requestPayment" - }, - "input":{"shape":"PutBucketRequestPaymentRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTrequestPaymentPUT.html", - "documentation":"

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

" - }, - "PutBucketTagging":{ - "name":"PutBucketTagging", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?tagging" - }, - "input":{"shape":"PutBucketTaggingRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTtagging.html", - "documentation":"

Sets the tags for a bucket.

" - }, - "PutBucketVersioning":{ - "name":"PutBucketVersioning", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?versioning" - }, - "input":{"shape":"PutBucketVersioningRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html", - "documentation":"

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

" - }, - "PutBucketWebsite":{ - "name":"PutBucketWebsite", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}?website" - }, - "input":{"shape":"PutBucketWebsiteRequest"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html", - "documentation":"

Set the website configuration for a bucket.

" - }, - "PutObject":{ - "name":"PutObject", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"PutObjectRequest"}, - "output":{"shape":"PutObjectOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUT.html", - "documentation":"

Adds an object to a bucket.

" - }, - "PutObjectAcl":{ - "name":"PutObjectAcl", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}?acl" - }, - "input":{"shape":"PutObjectAclRequest"}, - "output":{"shape":"PutObjectAclOutput"}, - "errors":[ - {"shape":"NoSuchKey"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUTacl.html", - "documentation":"

uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket

" - }, - "PutObjectTagging":{ - "name":"PutObjectTagging", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}?tagging" - }, - "input":{"shape":"PutObjectTaggingRequest"}, - "output":{"shape":"PutObjectTaggingOutput"}, - "documentation":"

Sets the supplied tag-set to an object that already exists in a bucket

" - }, - "RestoreObject":{ - "name":"RestoreObject", - "http":{ - "method":"POST", - "requestUri":"/{Bucket}/{Key+}?restore" - }, - "input":{"shape":"RestoreObjectRequest"}, - "output":{"shape":"RestoreObjectOutput"}, - "errors":[ - {"shape":"ObjectAlreadyInActiveTierError"} - ], - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectRestore.html", - "documentation":"

Restores an archived copy of an object back into Amazon S3

", - "alias":"PostObjectRestore" - }, - "SelectObjectContent":{ - "name":"SelectObjectContent", - "http":{ - "method":"POST", - "requestUri":"/{Bucket}/{Key+}?select&select-type=2" - }, - "input":{ - "shape":"SelectObjectContentRequest", - "locationName":"SelectObjectContentRequest", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "output":{"shape":"SelectObjectContentOutput"}, - "documentation":"

This operation filters the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response.

" - }, - "UploadPart":{ - "name":"UploadPart", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"UploadPartRequest"}, - "output":{"shape":"UploadPartOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPart.html", - "documentation":"

Uploads a part in a multipart upload.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

" - }, - "UploadPartCopy":{ - "name":"UploadPartCopy", - "http":{ - "method":"PUT", - "requestUri":"/{Bucket}/{Key+}" - }, - "input":{"shape":"UploadPartCopyRequest"}, - "output":{"shape":"UploadPartCopyOutput"}, - "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPartCopy.html", - "documentation":"

Uploads a part by copying data from an existing object as data source.

" - } - }, - "shapes":{ - "AbortDate":{"type":"timestamp"}, - "AbortIncompleteMultipartUpload":{ - "type":"structure", - "members":{ - "DaysAfterInitiation":{ - "shape":"DaysAfterInitiation", - "documentation":"

Indicates the number of days that must pass since initiation for Lifecycle to abort an Incomplete Multipart Upload.

" - } - }, - "documentation":"

Specifies the days since the initiation of an Incomplete Multipart Upload that Lifecycle will wait before permanently removing all parts of the upload.

" - }, - "AbortMultipartUploadOutput":{ - "type":"structure", - "members":{ - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "AbortMultipartUploadRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "UploadId" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "location":"querystring", - "locationName":"uploadId" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "AbortRuleId":{"type":"string"}, - "AccelerateConfiguration":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"BucketAccelerateStatus", - "documentation":"

The accelerate configuration of the bucket.

" - } - } - }, - "AcceptRanges":{"type":"string"}, - "AccessControlPolicy":{ - "type":"structure", - "members":{ - "Grants":{ - "shape":"Grants", - "documentation":"

A list of grants.

", - "locationName":"AccessControlList" - }, - "Owner":{"shape":"Owner"} - } - }, - "AccessControlTranslation":{ - "type":"structure", - "required":["Owner"], - "members":{ - "Owner":{ - "shape":"OwnerOverride", - "documentation":"

The override value for the owner of the replica object.

" - } - }, - "documentation":"

Container for information regarding the access control for replicas.

" - }, - "AccountId":{"type":"string"}, - "AllowQuotedRecordDelimiter":{"type":"boolean"}, - "AllowedHeader":{"type":"string"}, - "AllowedHeaders":{ - "type":"list", - "member":{"shape":"AllowedHeader"}, - "flattened":true - }, - "AllowedMethod":{"type":"string"}, - "AllowedMethods":{ - "type":"list", - "member":{"shape":"AllowedMethod"}, - "flattened":true - }, - "AllowedOrigin":{"type":"string"}, - "AllowedOrigins":{ - "type":"list", - "member":{"shape":"AllowedOrigin"}, - "flattened":true - }, - "AnalyticsAndOperator":{ - "type":"structure", - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix to use when evaluating an AND predicate.

" - }, - "Tags":{ - "shape":"TagSet", - "documentation":"

The list of tags to use when evaluating an AND predicate.

", - "flattened":true, - "locationName":"Tag" - } - } - }, - "AnalyticsConfiguration":{ - "type":"structure", - "required":[ - "Id", - "StorageClassAnalysis" - ], - "members":{ - "Id":{ - "shape":"AnalyticsId", - "documentation":"

The identifier used to represent an analytics configuration.

" - }, - "Filter":{ - "shape":"AnalyticsFilter", - "documentation":"

The filter used to describe a set of objects for analyses. A filter must have exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator). If no filter is provided, all objects will be considered in any analysis.

" - }, - "StorageClassAnalysis":{ - "shape":"StorageClassAnalysis", - "documentation":"

If present, it indicates that data related to access patterns will be collected and made available to analyze the tradeoffs between different storage classes.

" - } - } - }, - "AnalyticsConfigurationList":{ - "type":"list", - "member":{"shape":"AnalyticsConfiguration"}, - "flattened":true - }, - "AnalyticsExportDestination":{ - "type":"structure", - "required":["S3BucketDestination"], - "members":{ - "S3BucketDestination":{ - "shape":"AnalyticsS3BucketDestination", - "documentation":"

A destination signifying output to an S3 bucket.

" - } - } - }, - "AnalyticsFilter":{ - "type":"structure", - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix to use when evaluating an analytics filter.

" - }, - "Tag":{ - "shape":"Tag", - "documentation":"

The tag to use when evaluating an analytics filter.

" - }, - "And":{ - "shape":"AnalyticsAndOperator", - "documentation":"

A conjunction (logical AND) of predicates, which is used in evaluating an analytics filter. The operator must have at least two predicates.

" - } - } - }, - "AnalyticsId":{"type":"string"}, - "AnalyticsS3BucketDestination":{ - "type":"structure", - "required":[ - "Format", - "Bucket" - ], - "members":{ - "Format":{ - "shape":"AnalyticsS3ExportFileFormat", - "documentation":"

The file format used when exporting data to Amazon S3.

" - }, - "BucketAccountId":{ - "shape":"AccountId", - "documentation":"

The account ID that owns the destination bucket. If no account ID is provided, the owner will not be validated prior to exporting data.

" - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

The Amazon resource name (ARN) of the bucket to which data is exported.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix to use when exporting data. The exported data begins with this prefix.

" - } - } - }, - "AnalyticsS3ExportFileFormat":{ - "type":"string", - "enum":["CSV"] - }, - "Body":{"type":"blob"}, - "Bucket":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"BucketName", - "documentation":"

The name of the bucket.

" - }, - "CreationDate":{ - "shape":"CreationDate", - "documentation":"

Date the bucket was created.

" - } - } - }, - "BucketAccelerateStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Suspended" - ] - }, - "BucketAlreadyExists":{ - "type":"structure", - "members":{ - }, - "documentation":"

The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.

", - "exception":true - }, - "BucketAlreadyOwnedByYou":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "BucketCannedACL":{ - "type":"string", - "enum":[ - "private", - "public-read", - "public-read-write", - "authenticated-read" - ] - }, - "BucketLifecycleConfiguration":{ - "type":"structure", - "required":["Rules"], - "members":{ - "Rules":{ - "shape":"LifecycleRules", - "locationName":"Rule" - } - } - }, - "BucketLocationConstraint":{ - "type":"string", - "enum":[ - "EU", - "eu-west-1", - "us-west-1", - "us-west-2", - "ap-south-1", - "ap-southeast-1", - "ap-southeast-2", - "ap-northeast-1", - "sa-east-1", - "cn-north-1", - "eu-central-1" - ] - }, - "BucketLoggingStatus":{ - "type":"structure", - "members":{ - "LoggingEnabled":{"shape":"LoggingEnabled"} - } - }, - "BucketLogsPermission":{ - "type":"string", - "enum":[ - "FULL_CONTROL", - "READ", - "WRITE" - ] - }, - "BucketName":{"type":"string"}, - "BucketVersioningStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Suspended" - ] - }, - "Buckets":{ - "type":"list", - "member":{ - "shape":"Bucket", - "locationName":"Bucket" - } - }, - "BytesProcessed":{"type":"long"}, - "BytesReturned":{"type":"long"}, - "BytesScanned":{"type":"long"}, - "CORSConfiguration":{ - "type":"structure", - "required":["CORSRules"], - "members":{ - "CORSRules":{ - "shape":"CORSRules", - "locationName":"CORSRule" - } - } - }, - "CORSRule":{ - "type":"structure", - "required":[ - "AllowedMethods", - "AllowedOrigins" - ], - "members":{ - "AllowedHeaders":{ - "shape":"AllowedHeaders", - "documentation":"

Specifies which headers are allowed in a pre-flight OPTIONS request.

", - "locationName":"AllowedHeader" - }, - "AllowedMethods":{ - "shape":"AllowedMethods", - "documentation":"

Identifies HTTP methods that the domain/origin specified in the rule is allowed to execute.

", - "locationName":"AllowedMethod" - }, - "AllowedOrigins":{ - "shape":"AllowedOrigins", - "documentation":"

One or more origins you want customers to be able to access the bucket from.

", - "locationName":"AllowedOrigin" - }, - "ExposeHeaders":{ - "shape":"ExposeHeaders", - "documentation":"

One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequest object).

", - "locationName":"ExposeHeader" - }, - "MaxAgeSeconds":{ - "shape":"MaxAgeSeconds", - "documentation":"

The time in seconds that your browser is to cache the preflight response for the specified resource.

" - } - } - }, - "CORSRules":{ - "type":"list", - "member":{"shape":"CORSRule"}, - "flattened":true - }, - "CSVInput":{ - "type":"structure", - "members":{ - "FileHeaderInfo":{ - "shape":"FileHeaderInfo", - "documentation":"

Describes the first line of input. Valid values: None, Ignore, Use.

" - }, - "Comments":{ - "shape":"Comments", - "documentation":"

Single character used to indicate a row should be ignored when present at the start of a row.

" - }, - "QuoteEscapeCharacter":{ - "shape":"QuoteEscapeCharacter", - "documentation":"

Single character used for escaping the quote character inside an already escaped value.

" - }, - "RecordDelimiter":{ - "shape":"RecordDelimiter", - "documentation":"

Value used to separate individual records.

" - }, - "FieldDelimiter":{ - "shape":"FieldDelimiter", - "documentation":"

Value used to separate individual fields in a record.

" - }, - "QuoteCharacter":{ - "shape":"QuoteCharacter", - "documentation":"

Value used for escaping where the field delimiter is part of the value.

" - }, - "AllowQuotedRecordDelimiter":{ - "shape":"AllowQuotedRecordDelimiter", - "documentation":"

Specifies that CSV field values may contain quoted record delimiters and such records should be allowed. Default value is FALSE. Setting this value to TRUE may lower performance.

" - } - }, - "documentation":"

Describes how a CSV-formatted input object is formatted.

" - }, - "CSVOutput":{ - "type":"structure", - "members":{ - "QuoteFields":{ - "shape":"QuoteFields", - "documentation":"

Indicates whether or not all output fields should be quoted.

" - }, - "QuoteEscapeCharacter":{ - "shape":"QuoteEscapeCharacter", - "documentation":"

Single character used for escaping the quote character inside an already escaped value.

" - }, - "RecordDelimiter":{ - "shape":"RecordDelimiter", - "documentation":"

Value used to separate individual records.

" - }, - "FieldDelimiter":{ - "shape":"FieldDelimiter", - "documentation":"

Value used to separate individual fields in a record.

" - }, - "QuoteCharacter":{ - "shape":"QuoteCharacter", - "documentation":"

Value used for escaping where the field delimiter is part of the value.

" - } - }, - "documentation":"

Describes how CSV-formatted results are formatted.

" - }, - "CacheControl":{"type":"string"}, - "CloudFunction":{"type":"string"}, - "CloudFunctionConfiguration":{ - "type":"structure", - "members":{ - "Id":{"shape":"NotificationId"}, - "Event":{ - "shape":"Event", - "deprecated":true - }, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "CloudFunction":{"shape":"CloudFunction"}, - "InvocationRole":{"shape":"CloudFunctionInvocationRole"} - } - }, - "CloudFunctionInvocationRole":{"type":"string"}, - "Code":{"type":"string"}, - "Comments":{"type":"string"}, - "CommonPrefix":{ - "type":"structure", - "members":{ - "Prefix":{"shape":"Prefix"} - } - }, - "CommonPrefixList":{ - "type":"list", - "member":{"shape":"CommonPrefix"}, - "flattened":true - }, - "CompleteMultipartUploadOutput":{ - "type":"structure", - "members":{ - "Location":{"shape":"Location"}, - "Bucket":{"shape":"BucketName"}, - "Key":{"shape":"ObjectKey"}, - "Expiration":{ - "shape":"Expiration", - "documentation":"

If the object expiration is configured, this will contain the expiration date (expiry-date) and rule ID (rule-id). The value of rule-id is URL encoded.

", - "location":"header", - "locationName":"x-amz-expiration" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag of the object.

" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version of the object.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "CompleteMultipartUploadRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "UploadId" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "MultipartUpload":{ - "shape":"CompletedMultipartUpload", - "locationName":"CompleteMultipartUpload", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "UploadId":{ - "shape":"MultipartUploadId", - "location":"querystring", - "locationName":"uploadId" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - }, - "payload":"MultipartUpload" - }, - "CompletedMultipartUpload":{ - "type":"structure", - "members":{ - "Parts":{ - "shape":"CompletedPartList", - "locationName":"Part" - } - } - }, - "CompletedPart":{ - "type":"structure", - "members":{ - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag returned when the part was uploaded.

" - }, - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number that identifies the part. This is a positive integer between 1 and 10,000.

" - } - } - }, - "CompletedPartList":{ - "type":"list", - "member":{"shape":"CompletedPart"}, - "flattened":true - }, - "CompressionType":{ - "type":"string", - "enum":[ - "NONE", - "GZIP", - "BZIP2" - ] - }, - "Condition":{ - "type":"structure", - "members":{ - "HttpErrorCodeReturnedEquals":{ - "shape":"HttpErrorCodeReturnedEquals", - "documentation":"

The HTTP error code when the redirect is applied. In the event of an error, if the error code equals this value, then the specified redirect is applied. Required when parent element Condition is specified and sibling KeyPrefixEquals is not specified. If both are specified, then both must be true for the redirect to be applied.

" - }, - "KeyPrefixEquals":{ - "shape":"KeyPrefixEquals", - "documentation":"

The object key name prefix when the redirect is applied. For example, to redirect requests for ExamplePage.html, the key prefix will be ExamplePage.html. To redirect request for all pages with the prefix docs/, the key prefix will be /docs, which identifies all objects in the docs/ folder. Required when the parent element Condition is specified and sibling HttpErrorCodeReturnedEquals is not specified. If both conditions are specified, both must be true for the redirect to be applied.

" - } - } - }, - "ConfirmRemoveSelfBucketAccess":{"type":"boolean"}, - "ContentDisposition":{"type":"string"}, - "ContentEncoding":{"type":"string"}, - "ContentLanguage":{"type":"string"}, - "ContentLength":{"type":"long"}, - "ContentMD5":{"type":"string"}, - "ContentRange":{"type":"string"}, - "ContentType":{"type":"string"}, - "ContinuationEvent":{ - "type":"structure", - "members":{ - }, - "event":true - }, - "CopyObjectOutput":{ - "type":"structure", - "members":{ - "CopyObjectResult":{"shape":"CopyObjectResult"}, - "Expiration":{ - "shape":"Expiration", - "documentation":"

If the object expiration is configured, the response includes this header.

", - "location":"header", - "locationName":"x-amz-expiration" - }, - "CopySourceVersionId":{ - "shape":"CopySourceVersionId", - "location":"header", - "locationName":"x-amz-copy-source-version-id" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version ID of the newly created copy.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - }, - "payload":"CopyObjectResult" - }, - "CopyObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "CopySource", - "Key" - ], - "members":{ - "ACL":{ - "shape":"ObjectCannedACL", - "documentation":"

The canned ACL to apply to the object.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "CacheControl":{ - "shape":"CacheControl", - "documentation":"

Specifies caching behavior along the request/reply chain.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentDisposition":{ - "shape":"ContentDisposition", - "documentation":"

Specifies presentational information for the object.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "ContentEncoding":{ - "shape":"ContentEncoding", - "documentation":"

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

", - "location":"header", - "locationName":"Content-Encoding" - }, - "ContentLanguage":{ - "shape":"ContentLanguage", - "documentation":"

The language the content is in.

", - "location":"header", - "locationName":"Content-Language" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

A standard MIME type describing the format of the object data.

", - "location":"header", - "locationName":"Content-Type" - }, - "CopySource":{ - "shape":"CopySource", - "documentation":"

The name of the source bucket and key name of the source object, separated by a slash (/). Must be URL-encoded.

", - "location":"header", - "locationName":"x-amz-copy-source" - }, - "CopySourceIfMatch":{ - "shape":"CopySourceIfMatch", - "documentation":"

Copies the object if its entity tag (ETag) matches the specified tag.

", - "location":"header", - "locationName":"x-amz-copy-source-if-match" - }, - "CopySourceIfModifiedSince":{ - "shape":"CopySourceIfModifiedSince", - "documentation":"

Copies the object if it has been modified since the specified time.

", - "location":"header", - "locationName":"x-amz-copy-source-if-modified-since" - }, - "CopySourceIfNoneMatch":{ - "shape":"CopySourceIfNoneMatch", - "documentation":"

Copies the object if its entity tag (ETag) is different than the specified ETag.

", - "location":"header", - "locationName":"x-amz-copy-source-if-none-match" - }, - "CopySourceIfUnmodifiedSince":{ - "shape":"CopySourceIfUnmodifiedSince", - "documentation":"

Copies the object if it hasn't been modified since the specified time.

", - "location":"header", - "locationName":"x-amz-copy-source-if-unmodified-since" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The date and time at which the object is no longer cacheable.

", - "location":"header", - "locationName":"Expires" - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to read the object data and its metadata.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the object ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable object.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

A map of metadata to store with the object in S3.

", - "location":"headers", - "locationName":"x-amz-meta-" - }, - "MetadataDirective":{ - "shape":"MetadataDirective", - "documentation":"

Specifies whether the metadata is copied from the source object or replaced with metadata provided in the request.

", - "location":"header", - "locationName":"x-amz-metadata-directive" - }, - "TaggingDirective":{ - "shape":"TaggingDirective", - "documentation":"

Specifies whether the object tag-set are copied from the source object or replaced with tag-set provided in the request.

", - "location":"header", - "locationName":"x-amz-tagging-directive" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The type of storage to use for the object. Defaults to 'STANDARD'.

", - "location":"header", - "locationName":"x-amz-storage-class" - }, - "WebsiteRedirectLocation":{ - "shape":"WebsiteRedirectLocation", - "documentation":"

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

", - "location":"header", - "locationName":"x-amz-website-redirect-location" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

Specifies the AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS will fail if not made via SSL or using SigV4. Documentation on configuring any of the officially supported AWS SDKs and CLI can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "CopySourceSSECustomerAlgorithm":{ - "shape":"CopySourceSSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use when decrypting the source object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-algorithm" - }, - "CopySourceSSECustomerKey":{ - "shape":"CopySourceSSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use to decrypt the source object. The encryption key provided in this header must be one that was used when the source object was created.

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-key" - }, - "CopySourceSSECustomerKeyMD5":{ - "shape":"CopySourceSSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-key-MD5" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "Tagging":{ - "shape":"TaggingHeader", - "documentation":"

The tag-set for the object destination object this value must be used in conjunction with the TaggingDirective. The tag-set must be encoded as URL Query parameters

", - "location":"header", - "locationName":"x-amz-tagging" - } - } - }, - "CopyObjectResult":{ - "type":"structure", - "members":{ - "ETag":{"shape":"ETag"}, - "LastModified":{"shape":"LastModified"} - } - }, - "CopyPartResult":{ - "type":"structure", - "members":{ - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag of the object.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Date and time at which the object was uploaded.

" - } - } - }, - "CopySource":{ - "type":"string", - "pattern":"\\/.+\\/.+" - }, - "CopySourceIfMatch":{"type":"string"}, - "CopySourceIfModifiedSince":{"type":"timestamp"}, - "CopySourceIfNoneMatch":{"type":"string"}, - "CopySourceIfUnmodifiedSince":{"type":"timestamp"}, - "CopySourceRange":{"type":"string"}, - "CopySourceSSECustomerAlgorithm":{"type":"string"}, - "CopySourceSSECustomerKey":{ - "type":"string", - "sensitive":true - }, - "CopySourceSSECustomerKeyMD5":{"type":"string"}, - "CopySourceVersionId":{"type":"string"}, - "CreateBucketConfiguration":{ - "type":"structure", - "members":{ - "LocationConstraint":{ - "shape":"BucketLocationConstraint", - "documentation":"

Specifies the region where the bucket will be created. If you don't specify a region, the bucket will be created in US Standard.

" - } - } - }, - "CreateBucketOutput":{ - "type":"structure", - "members":{ - "Location":{ - "shape":"Location", - "location":"header", - "locationName":"Location" - } - } - }, - "CreateBucketRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "ACL":{ - "shape":"BucketCannedACL", - "documentation":"

The canned ACL to apply to the bucket.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "CreateBucketConfiguration":{ - "shape":"CreateBucketConfiguration", - "locationName":"CreateBucketConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to list the objects in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the bucket ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWrite":{ - "shape":"GrantWrite", - "documentation":"

Allows grantee to create, overwrite, and delete any object in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-write" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable bucket.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - } - }, - "payload":"CreateBucketConfiguration" - }, - "CreateMultipartUploadOutput":{ - "type":"structure", - "members":{ - "AbortDate":{ - "shape":"AbortDate", - "documentation":"

Date when multipart upload will become eligible for abort operation by lifecycle.

", - "location":"header", - "locationName":"x-amz-abort-date" - }, - "AbortRuleId":{ - "shape":"AbortRuleId", - "documentation":"

Id of the lifecycle rule that makes a multipart upload eligible for abort operation.

", - "location":"header", - "locationName":"x-amz-abort-rule-id" - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to which the multipart upload was initiated.

", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

Object key for which the multipart upload was initiated.

" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

ID for the initiated multipart upload.

" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "CreateMultipartUploadRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "ACL":{ - "shape":"ObjectCannedACL", - "documentation":"

The canned ACL to apply to the object.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "CacheControl":{ - "shape":"CacheControl", - "documentation":"

Specifies caching behavior along the request/reply chain.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentDisposition":{ - "shape":"ContentDisposition", - "documentation":"

Specifies presentational information for the object.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "ContentEncoding":{ - "shape":"ContentEncoding", - "documentation":"

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

", - "location":"header", - "locationName":"Content-Encoding" - }, - "ContentLanguage":{ - "shape":"ContentLanguage", - "documentation":"

The language the content is in.

", - "location":"header", - "locationName":"Content-Language" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

A standard MIME type describing the format of the object data.

", - "location":"header", - "locationName":"Content-Type" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The date and time at which the object is no longer cacheable.

", - "location":"header", - "locationName":"Expires" - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to read the object data and its metadata.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the object ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable object.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

A map of metadata to store with the object in S3.

", - "location":"headers", - "locationName":"x-amz-meta-" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The type of storage to use for the object. Defaults to 'STANDARD'.

", - "location":"header", - "locationName":"x-amz-storage-class" - }, - "WebsiteRedirectLocation":{ - "shape":"WebsiteRedirectLocation", - "documentation":"

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

", - "location":"header", - "locationName":"x-amz-website-redirect-location" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

Specifies the AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS will fail if not made via SSL or using SigV4. Documentation on configuring any of the officially supported AWS SDKs and CLI can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "Tagging":{ - "shape":"TaggingHeader", - "documentation":"

The tag-set for the object. The tag-set must be encoded as URL Query parameters

", - "location":"header", - "locationName":"x-amz-tagging" - } - } - }, - "CreationDate":{"type":"timestamp"}, - "Date":{ - "type":"timestamp", - "timestampFormat":"iso8601" - }, - "Days":{"type":"integer"}, - "DaysAfterInitiation":{"type":"integer"}, - "Delete":{ - "type":"structure", - "required":["Objects"], - "members":{ - "Objects":{ - "shape":"ObjectIdentifierList", - "locationName":"Object" - }, - "Quiet":{ - "shape":"Quiet", - "documentation":"

Element to enable quiet mode for the request. When you add this element, you must set its value to true.

" - } - } - }, - "DeleteBucketAnalyticsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket from which an analytics configuration is deleted.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"AnalyticsId", - "documentation":"

The identifier used to represent an analytics configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "DeleteBucketCorsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketEncryptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the server-side encryption configuration to delete.

", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketInventoryConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the inventory configuration to delete.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"InventoryId", - "documentation":"

The ID used to identify the inventory configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "DeleteBucketLifecycleRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketMetricsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the metrics configuration to delete.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"MetricsId", - "documentation":"

The ID used to identify the metrics configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "DeleteBucketPolicyRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketReplicationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketTaggingRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteBucketWebsiteRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "DeleteMarker":{"type":"boolean"}, - "DeleteMarkerEntry":{ - "type":"structure", - "members":{ - "Owner":{"shape":"Owner"}, - "Key":{ - "shape":"ObjectKey", - "documentation":"

The object key.

" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version ID of an object.

" - }, - "IsLatest":{ - "shape":"IsLatest", - "documentation":"

Specifies whether the object is (true) or is not (false) the latest version of an object.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Date and time the object was last modified.

" - } - } - }, - "DeleteMarkerVersionId":{"type":"string"}, - "DeleteMarkers":{ - "type":"list", - "member":{"shape":"DeleteMarkerEntry"}, - "flattened":true - }, - "DeleteObjectOutput":{ - "type":"structure", - "members":{ - "DeleteMarker":{ - "shape":"DeleteMarker", - "documentation":"

Specifies whether the versioned object that was permanently deleted was (true) or was not (false) a delete marker.

", - "location":"header", - "locationName":"x-amz-delete-marker" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Returns the version ID of the delete marker created as a result of the DELETE operation.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "DeleteObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "MFA":{ - "shape":"MFA", - "documentation":"

The concatenation of the authentication device's serial number, a space, and the value that is displayed on your authentication device.

", - "location":"header", - "locationName":"x-amz-mfa" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId used to reference a specific version of the object.

", - "location":"querystring", - "locationName":"versionId" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "DeleteObjectTaggingOutput":{ - "type":"structure", - "members":{ - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

The versionId of the object the tag-set was removed from.

", - "location":"header", - "locationName":"x-amz-version-id" - } - } - }, - "DeleteObjectTaggingRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

The versionId of the object that the tag-set will be removed from.

", - "location":"querystring", - "locationName":"versionId" - } - } - }, - "DeleteObjectsOutput":{ - "type":"structure", - "members":{ - "Deleted":{"shape":"DeletedObjects"}, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - }, - "Errors":{ - "shape":"Errors", - "locationName":"Error" - } - } - }, - "DeleteObjectsRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Delete" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Delete":{ - "shape":"Delete", - "locationName":"Delete", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "MFA":{ - "shape":"MFA", - "documentation":"

The concatenation of the authentication device's serial number, a space, and the value that is displayed on your authentication device.

", - "location":"header", - "locationName":"x-amz-mfa" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - }, - "payload":"Delete" - }, - "DeletedObject":{ - "type":"structure", - "members":{ - "Key":{"shape":"ObjectKey"}, - "VersionId":{"shape":"ObjectVersionId"}, - "DeleteMarker":{"shape":"DeleteMarker"}, - "DeleteMarkerVersionId":{"shape":"DeleteMarkerVersionId"} - } - }, - "DeletedObjects":{ - "type":"list", - "member":{"shape":"DeletedObject"}, - "flattened":true - }, - "Delimiter":{"type":"string"}, - "Description":{"type":"string"}, - "Destination":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Amazon resource name (ARN) of the bucket where you want Amazon S3 to store replicas of the object identified by the rule.

" - }, - "Account":{ - "shape":"AccountId", - "documentation":"

Account ID of the destination bucket. Currently this is only being verified if Access Control Translation is enabled

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The class of storage used to store the object.

" - }, - "AccessControlTranslation":{ - "shape":"AccessControlTranslation", - "documentation":"

Container for information regarding the access control for replicas.

" - }, - "EncryptionConfiguration":{ - "shape":"EncryptionConfiguration", - "documentation":"

Container for information regarding encryption based configuration for replicas.

" - } - }, - "documentation":"

Container for replication destination information.

" - }, - "DisplayName":{"type":"string"}, - "ETag":{"type":"string"}, - "EmailAddress":{"type":"string"}, - "EnableRequestProgress":{"type":"boolean"}, - "EncodingType":{ - "type":"string", - "documentation":"

Requests Amazon S3 to encode the object keys in the response and specifies the encoding method to use. An object key may contain any Unicode character; however, XML 1.0 parser cannot parse some characters, such as characters with an ASCII value from 0 to 10. For characters that are not supported in XML 1.0, you can add this parameter to request that Amazon S3 encode the keys in the response.

", - "enum":["url"] - }, - "Encryption":{ - "type":"structure", - "required":["EncryptionType"], - "members":{ - "EncryptionType":{ - "shape":"ServerSideEncryption", - "documentation":"

The server-side encryption algorithm used when storing job results in Amazon S3 (e.g., AES256, aws:kms).

" - }, - "KMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If the encryption type is aws:kms, this optional value specifies the AWS KMS key ID to use for encryption of job results.

" - }, - "KMSContext":{ - "shape":"KMSContext", - "documentation":"

If the encryption type is aws:kms, this optional value can be used to specify the encryption context for the restore results.

" - } - }, - "documentation":"

Describes the server-side encryption that will be applied to the restore results.

" - }, - "EncryptionConfiguration":{ - "type":"structure", - "members":{ - "ReplicaKmsKeyID":{ - "shape":"ReplicaKmsKeyID", - "documentation":"

The id of the KMS key used to encrypt the replica object.

" - } - }, - "documentation":"

Container for information regarding encryption based configuration for replicas.

" - }, - "EndEvent":{ - "type":"structure", - "members":{ - }, - "event":true - }, - "Error":{ - "type":"structure", - "members":{ - "Key":{"shape":"ObjectKey"}, - "VersionId":{"shape":"ObjectVersionId"}, - "Code":{"shape":"Code"}, - "Message":{"shape":"Message"} - } - }, - "ErrorDocument":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"ObjectKey", - "documentation":"

The object key name to use when a 4XX class error occurs.

" - } - } - }, - "Errors":{ - "type":"list", - "member":{"shape":"Error"}, - "flattened":true - }, - "Event":{ - "type":"string", - "documentation":"

Bucket event for which to send notifications.

", - "enum":[ - "s3:ReducedRedundancyLostObject", - "s3:ObjectCreated:*", - "s3:ObjectCreated:Put", - "s3:ObjectCreated:Post", - "s3:ObjectCreated:Copy", - "s3:ObjectCreated:CompleteMultipartUpload", - "s3:ObjectRemoved:*", - "s3:ObjectRemoved:Delete", - "s3:ObjectRemoved:DeleteMarkerCreated" - ] - }, - "EventList":{ - "type":"list", - "member":{"shape":"Event"}, - "flattened":true - }, - "Expiration":{"type":"string"}, - "ExpirationStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "ExpiredObjectDeleteMarker":{"type":"boolean"}, - "Expires":{"type":"timestamp"}, - "ExposeHeader":{"type":"string"}, - "ExposeHeaders":{ - "type":"list", - "member":{"shape":"ExposeHeader"}, - "flattened":true - }, - "Expression":{"type":"string"}, - "ExpressionType":{ - "type":"string", - "enum":["SQL"] - }, - "FetchOwner":{"type":"boolean"}, - "FieldDelimiter":{"type":"string"}, - "FileHeaderInfo":{ - "type":"string", - "enum":[ - "USE", - "IGNORE", - "NONE" - ] - }, - "FilterRule":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"FilterRuleName", - "documentation":"

Object key name prefix or suffix identifying one or more objects to which the filtering rule applies. Maximum prefix length can be up to 1,024 characters. Overlapping prefixes and suffixes are not supported. For more information, go to Configuring Event Notifications in the Amazon Simple Storage Service Developer Guide.

" - }, - "Value":{"shape":"FilterRuleValue"} - }, - "documentation":"

Container for key value pair that defines the criteria for the filter rule.

" - }, - "FilterRuleList":{ - "type":"list", - "member":{"shape":"FilterRule"}, - "documentation":"

A list of containers for key value pair that defines the criteria for the filter rule.

", - "flattened":true - }, - "FilterRuleName":{ - "type":"string", - "enum":[ - "prefix", - "suffix" - ] - }, - "FilterRuleValue":{"type":"string"}, - "GetBucketAccelerateConfigurationOutput":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"BucketAccelerateStatus", - "documentation":"

The accelerate configuration of the bucket.

" - } - } - }, - "GetBucketAccelerateConfigurationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket for which the accelerate configuration is retrieved.

", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketAclOutput":{ - "type":"structure", - "members":{ - "Owner":{"shape":"Owner"}, - "Grants":{ - "shape":"Grants", - "documentation":"

A list of grants.

", - "locationName":"AccessControlList" - } - } - }, - "GetBucketAclRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketAnalyticsConfigurationOutput":{ - "type":"structure", - "members":{ - "AnalyticsConfiguration":{ - "shape":"AnalyticsConfiguration", - "documentation":"

The configuration and any analyses for the analytics filter.

" - } - }, - "payload":"AnalyticsConfiguration" - }, - "GetBucketAnalyticsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket from which an analytics configuration is retrieved.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"AnalyticsId", - "documentation":"

The identifier used to represent an analytics configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "GetBucketCorsOutput":{ - "type":"structure", - "members":{ - "CORSRules":{ - "shape":"CORSRules", - "locationName":"CORSRule" - } - } - }, - "GetBucketCorsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketEncryptionOutput":{ - "type":"structure", - "members":{ - "ServerSideEncryptionConfiguration":{"shape":"ServerSideEncryptionConfiguration"} - }, - "payload":"ServerSideEncryptionConfiguration" - }, - "GetBucketEncryptionRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket from which the server-side encryption configuration is retrieved.

", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketInventoryConfigurationOutput":{ - "type":"structure", - "members":{ - "InventoryConfiguration":{ - "shape":"InventoryConfiguration", - "documentation":"

Specifies the inventory configuration.

" - } - }, - "payload":"InventoryConfiguration" - }, - "GetBucketInventoryConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the inventory configuration to retrieve.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"InventoryId", - "documentation":"

The ID used to identify the inventory configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "GetBucketLifecycleConfigurationOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"LifecycleRules", - "locationName":"Rule" - } - } - }, - "GetBucketLifecycleConfigurationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketLifecycleOutput":{ - "type":"structure", - "members":{ - "Rules":{ - "shape":"Rules", - "locationName":"Rule" - } - } - }, - "GetBucketLifecycleRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketLocationOutput":{ - "type":"structure", - "members":{ - "LocationConstraint":{"shape":"BucketLocationConstraint"} - } - }, - "GetBucketLocationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketLoggingOutput":{ - "type":"structure", - "members":{ - "LoggingEnabled":{"shape":"LoggingEnabled"} - } - }, - "GetBucketLoggingRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketMetricsConfigurationOutput":{ - "type":"structure", - "members":{ - "MetricsConfiguration":{ - "shape":"MetricsConfiguration", - "documentation":"

Specifies the metrics configuration.

" - } - }, - "payload":"MetricsConfiguration" - }, - "GetBucketMetricsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the metrics configuration to retrieve.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"MetricsId", - "documentation":"

The ID used to identify the metrics configuration.

", - "location":"querystring", - "locationName":"id" - } - } - }, - "GetBucketNotificationConfigurationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to get the notification configuration for.

", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketPolicyOutput":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"Policy", - "documentation":"

The bucket policy as a JSON document.

" - } - }, - "payload":"Policy" - }, - "GetBucketPolicyRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketReplicationOutput":{ - "type":"structure", - "members":{ - "ReplicationConfiguration":{"shape":"ReplicationConfiguration"} - }, - "payload":"ReplicationConfiguration" - }, - "GetBucketReplicationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketRequestPaymentOutput":{ - "type":"structure", - "members":{ - "Payer":{ - "shape":"Payer", - "documentation":"

Specifies who pays for the download and request fees.

" - } - } - }, - "GetBucketRequestPaymentRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketTaggingOutput":{ - "type":"structure", - "required":["TagSet"], - "members":{ - "TagSet":{"shape":"TagSet"} - } - }, - "GetBucketTaggingRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketVersioningOutput":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"BucketVersioningStatus", - "documentation":"

The versioning state of the bucket.

" - }, - "MFADelete":{ - "shape":"MFADeleteStatus", - "documentation":"

Specifies whether MFA delete is enabled in the bucket versioning configuration. This element is only returned if the bucket has been configured with MFA delete. If the bucket has never been so configured, this element is not returned.

", - "locationName":"MfaDelete" - } - } - }, - "GetBucketVersioningRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetBucketWebsiteOutput":{ - "type":"structure", - "members":{ - "RedirectAllRequestsTo":{"shape":"RedirectAllRequestsTo"}, - "IndexDocument":{"shape":"IndexDocument"}, - "ErrorDocument":{"shape":"ErrorDocument"}, - "RoutingRules":{"shape":"RoutingRules"} - } - }, - "GetBucketWebsiteRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "GetObjectAclOutput":{ - "type":"structure", - "members":{ - "Owner":{"shape":"Owner"}, - "Grants":{ - "shape":"Grants", - "documentation":"

A list of grants.

", - "locationName":"AccessControlList" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "GetObjectAclRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId used to reference a specific version of the object.

", - "location":"querystring", - "locationName":"versionId" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "GetObjectOutput":{ - "type":"structure", - "members":{ - "Body":{ - "shape":"Body", - "documentation":"

Object data.

", - "streaming":true - }, - "DeleteMarker":{ - "shape":"DeleteMarker", - "documentation":"

Specifies whether the object retrieved was (true) or was not (false) a Delete Marker. If false, this response header does not appear in the response.

", - "location":"header", - "locationName":"x-amz-delete-marker" - }, - "AcceptRanges":{ - "shape":"AcceptRanges", - "location":"header", - "locationName":"accept-ranges" - }, - "Expiration":{ - "shape":"Expiration", - "documentation":"

If the object expiration is configured (see PUT Bucket lifecycle), the response includes this header. It includes the expiry-date and rule-id key value pairs providing object expiration information. The value of the rule-id is URL encoded.

", - "location":"header", - "locationName":"x-amz-expiration" - }, - "Restore":{ - "shape":"Restore", - "documentation":"

Provides information about object restoration operation and expiration time of the restored object copy.

", - "location":"header", - "locationName":"x-amz-restore" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Last modified date of the object

", - "location":"header", - "locationName":"Last-Modified" - }, - "ContentLength":{ - "shape":"ContentLength", - "documentation":"

Size of the body in bytes.

", - "location":"header", - "locationName":"Content-Length" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

An ETag is an opaque identifier assigned by a web server to a specific version of a resource found at a URL

", - "location":"header", - "locationName":"ETag" - }, - "MissingMeta":{ - "shape":"MissingMeta", - "documentation":"

This is set to the number of metadata entries not returned in x-amz-meta headers. This can happen if you create metadata using an API like SOAP that supports more flexible metadata than the REST API. For example, using SOAP, you can create metadata whose values are not legal HTTP headers.

", - "location":"header", - "locationName":"x-amz-missing-meta" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version of the object.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "CacheControl":{ - "shape":"CacheControl", - "documentation":"

Specifies caching behavior along the request/reply chain.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentDisposition":{ - "shape":"ContentDisposition", - "documentation":"

Specifies presentational information for the object.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "ContentEncoding":{ - "shape":"ContentEncoding", - "documentation":"

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

", - "location":"header", - "locationName":"Content-Encoding" - }, - "ContentLanguage":{ - "shape":"ContentLanguage", - "documentation":"

The language the content is in.

", - "location":"header", - "locationName":"Content-Language" - }, - "ContentRange":{ - "shape":"ContentRange", - "documentation":"

The portion of the object returned in the response.

", - "location":"header", - "locationName":"Content-Range" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

A standard MIME type describing the format of the object data.

", - "location":"header", - "locationName":"Content-Type" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The date and time at which the object is no longer cacheable.

", - "location":"header", - "locationName":"Expires" - }, - "WebsiteRedirectLocation":{ - "shape":"WebsiteRedirectLocation", - "documentation":"

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

", - "location":"header", - "locationName":"x-amz-website-redirect-location" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

A map of metadata to store with the object in S3.

", - "location":"headers", - "locationName":"x-amz-meta-" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "StorageClass":{ - "shape":"StorageClass", - "location":"header", - "locationName":"x-amz-storage-class" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - }, - "ReplicationStatus":{ - "shape":"ReplicationStatus", - "location":"header", - "locationName":"x-amz-replication-status" - }, - "PartsCount":{ - "shape":"PartsCount", - "documentation":"

The count of parts this object has.

", - "location":"header", - "locationName":"x-amz-mp-parts-count" - }, - "TagCount":{ - "shape":"TagCount", - "documentation":"

The number of tags, if any, on the object.

", - "location":"header", - "locationName":"x-amz-tagging-count" - } - }, - "payload":"Body" - }, - "GetObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "IfMatch":{ - "shape":"IfMatch", - "documentation":"

Return the object only if its entity tag (ETag) is the same as the one specified, otherwise return a 412 (precondition failed).

", - "location":"header", - "locationName":"If-Match" - }, - "IfModifiedSince":{ - "shape":"IfModifiedSince", - "documentation":"

Return the object only if it has been modified since the specified time, otherwise return a 304 (not modified).

", - "location":"header", - "locationName":"If-Modified-Since" - }, - "IfNoneMatch":{ - "shape":"IfNoneMatch", - "documentation":"

Return the object only if its entity tag (ETag) is different from the one specified, otherwise return a 304 (not modified).

", - "location":"header", - "locationName":"If-None-Match" - }, - "IfUnmodifiedSince":{ - "shape":"IfUnmodifiedSince", - "documentation":"

Return the object only if it has not been modified since the specified time, otherwise return a 412 (precondition failed).

", - "location":"header", - "locationName":"If-Unmodified-Since" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "Range":{ - "shape":"Range", - "documentation":"

Downloads the specified range bytes of an object. For more information about the HTTP Range header, go to http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.

", - "location":"header", - "locationName":"Range" - }, - "ResponseCacheControl":{ - "shape":"ResponseCacheControl", - "documentation":"

Sets the Cache-Control header of the response.

", - "location":"querystring", - "locationName":"response-cache-control" - }, - "ResponseContentDisposition":{ - "shape":"ResponseContentDisposition", - "documentation":"

Sets the Content-Disposition header of the response

", - "location":"querystring", - "locationName":"response-content-disposition" - }, - "ResponseContentEncoding":{ - "shape":"ResponseContentEncoding", - "documentation":"

Sets the Content-Encoding header of the response.

", - "location":"querystring", - "locationName":"response-content-encoding" - }, - "ResponseContentLanguage":{ - "shape":"ResponseContentLanguage", - "documentation":"

Sets the Content-Language header of the response.

", - "location":"querystring", - "locationName":"response-content-language" - }, - "ResponseContentType":{ - "shape":"ResponseContentType", - "documentation":"

Sets the Content-Type header of the response.

", - "location":"querystring", - "locationName":"response-content-type" - }, - "ResponseExpires":{ - "shape":"ResponseExpires", - "documentation":"

Sets the Expires header of the response.

", - "location":"querystring", - "locationName":"response-expires" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId used to reference a specific version of the object.

", - "location":"querystring", - "locationName":"versionId" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number of the object being read. This is a positive integer between 1 and 10,000. Effectively performs a 'ranged' GET request for the part specified. Useful for downloading just a part of an object.

", - "location":"querystring", - "locationName":"partNumber" - } - } - }, - "GetObjectTaggingOutput":{ - "type":"structure", - "required":["TagSet"], - "members":{ - "VersionId":{ - "shape":"ObjectVersionId", - "location":"header", - "locationName":"x-amz-version-id" - }, - "TagSet":{"shape":"TagSet"} - } - }, - "GetObjectTaggingRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "location":"querystring", - "locationName":"versionId" - } - } - }, - "GetObjectTorrentOutput":{ - "type":"structure", - "members":{ - "Body":{ - "shape":"Body", - "streaming":true - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - }, - "payload":"Body" - }, - "GetObjectTorrentRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "GlacierJobParameters":{ - "type":"structure", - "required":["Tier"], - "members":{ - "Tier":{ - "shape":"Tier", - "documentation":"

Glacier retrieval tier at which the restore will be processed.

" - } - } - }, - "Grant":{ - "type":"structure", - "members":{ - "Grantee":{"shape":"Grantee"}, - "Permission":{ - "shape":"Permission", - "documentation":"

Specifies the permission given to the grantee.

" - } - } - }, - "GrantFullControl":{"type":"string"}, - "GrantRead":{"type":"string"}, - "GrantReadACP":{"type":"string"}, - "GrantWrite":{"type":"string"}, - "GrantWriteACP":{"type":"string"}, - "Grantee":{ - "type":"structure", - "required":["Type"], - "members":{ - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

Screen name of the grantee.

" - }, - "EmailAddress":{ - "shape":"EmailAddress", - "documentation":"

Email address of the grantee.

" - }, - "ID":{ - "shape":"ID", - "documentation":"

The canonical user ID of the grantee.

" - }, - "Type":{ - "shape":"Type", - "documentation":"

Type of grantee

", - "locationName":"xsi:type", - "xmlAttribute":true - }, - "URI":{ - "shape":"URI", - "documentation":"

URI of the grantee group.

" - } - }, - "xmlNamespace":{ - "prefix":"xsi", - "uri":"http://www.w3.org/2001/XMLSchema-instance" - } - }, - "Grants":{ - "type":"list", - "member":{ - "shape":"Grant", - "locationName":"Grant" - } - }, - "HeadBucketRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - } - } - }, - "HeadObjectOutput":{ - "type":"structure", - "members":{ - "DeleteMarker":{ - "shape":"DeleteMarker", - "documentation":"

Specifies whether the object retrieved was (true) or was not (false) a Delete Marker. If false, this response header does not appear in the response.

", - "location":"header", - "locationName":"x-amz-delete-marker" - }, - "AcceptRanges":{ - "shape":"AcceptRanges", - "location":"header", - "locationName":"accept-ranges" - }, - "Expiration":{ - "shape":"Expiration", - "documentation":"

If the object expiration is configured (see PUT Bucket lifecycle), the response includes this header. It includes the expiry-date and rule-id key value pairs providing object expiration information. The value of the rule-id is URL encoded.

", - "location":"header", - "locationName":"x-amz-expiration" - }, - "Restore":{ - "shape":"Restore", - "documentation":"

Provides information about object restoration operation and expiration time of the restored object copy.

", - "location":"header", - "locationName":"x-amz-restore" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Last modified date of the object

", - "location":"header", - "locationName":"Last-Modified" - }, - "ContentLength":{ - "shape":"ContentLength", - "documentation":"

Size of the body in bytes.

", - "location":"header", - "locationName":"Content-Length" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

An ETag is an opaque identifier assigned by a web server to a specific version of a resource found at a URL

", - "location":"header", - "locationName":"ETag" - }, - "MissingMeta":{ - "shape":"MissingMeta", - "documentation":"

This is set to the number of metadata entries not returned in x-amz-meta headers. This can happen if you create metadata using an API like SOAP that supports more flexible metadata than the REST API. For example, using SOAP, you can create metadata whose values are not legal HTTP headers.

", - "location":"header", - "locationName":"x-amz-missing-meta" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version of the object.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "CacheControl":{ - "shape":"CacheControl", - "documentation":"

Specifies caching behavior along the request/reply chain.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentDisposition":{ - "shape":"ContentDisposition", - "documentation":"

Specifies presentational information for the object.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "ContentEncoding":{ - "shape":"ContentEncoding", - "documentation":"

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

", - "location":"header", - "locationName":"Content-Encoding" - }, - "ContentLanguage":{ - "shape":"ContentLanguage", - "documentation":"

The language the content is in.

", - "location":"header", - "locationName":"Content-Language" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

A standard MIME type describing the format of the object data.

", - "location":"header", - "locationName":"Content-Type" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The date and time at which the object is no longer cacheable.

", - "location":"header", - "locationName":"Expires" - }, - "WebsiteRedirectLocation":{ - "shape":"WebsiteRedirectLocation", - "documentation":"

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

", - "location":"header", - "locationName":"x-amz-website-redirect-location" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

A map of metadata to store with the object in S3.

", - "location":"headers", - "locationName":"x-amz-meta-" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "StorageClass":{ - "shape":"StorageClass", - "location":"header", - "locationName":"x-amz-storage-class" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - }, - "ReplicationStatus":{ - "shape":"ReplicationStatus", - "location":"header", - "locationName":"x-amz-replication-status" - }, - "PartsCount":{ - "shape":"PartsCount", - "documentation":"

The count of parts this object has.

", - "location":"header", - "locationName":"x-amz-mp-parts-count" - } - } - }, - "HeadObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "IfMatch":{ - "shape":"IfMatch", - "documentation":"

Return the object only if its entity tag (ETag) is the same as the one specified, otherwise return a 412 (precondition failed).

", - "location":"header", - "locationName":"If-Match" - }, - "IfModifiedSince":{ - "shape":"IfModifiedSince", - "documentation":"

Return the object only if it has been modified since the specified time, otherwise return a 304 (not modified).

", - "location":"header", - "locationName":"If-Modified-Since" - }, - "IfNoneMatch":{ - "shape":"IfNoneMatch", - "documentation":"

Return the object only if its entity tag (ETag) is different from the one specified, otherwise return a 304 (not modified).

", - "location":"header", - "locationName":"If-None-Match" - }, - "IfUnmodifiedSince":{ - "shape":"IfUnmodifiedSince", - "documentation":"

Return the object only if it has not been modified since the specified time, otherwise return a 412 (precondition failed).

", - "location":"header", - "locationName":"If-Unmodified-Since" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "Range":{ - "shape":"Range", - "documentation":"

Downloads the specified range bytes of an object. For more information about the HTTP Range header, go to http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.

", - "location":"header", - "locationName":"Range" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId used to reference a specific version of the object.

", - "location":"querystring", - "locationName":"versionId" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number of the object being read. This is a positive integer between 1 and 10,000. Effectively performs a 'ranged' HEAD request for the part specified. Useful querying about the size of the part and the number of parts in this object.

", - "location":"querystring", - "locationName":"partNumber" - } - } - }, - "HostName":{"type":"string"}, - "HttpErrorCodeReturnedEquals":{"type":"string"}, - "HttpRedirectCode":{"type":"string"}, - "ID":{"type":"string"}, - "IfMatch":{"type":"string"}, - "IfModifiedSince":{"type":"timestamp"}, - "IfNoneMatch":{"type":"string"}, - "IfUnmodifiedSince":{"type":"timestamp"}, - "IndexDocument":{ - "type":"structure", - "required":["Suffix"], - "members":{ - "Suffix":{ - "shape":"Suffix", - "documentation":"

A suffix that is appended to a request that is for a directory on the website endpoint (e.g. if the suffix is index.html and you make a request to samplebucket/images/ the data that is returned will be for the object with the key name images/index.html) The suffix must not be empty and must not include a slash character.

" - } - } - }, - "Initiated":{"type":"timestamp"}, - "Initiator":{ - "type":"structure", - "members":{ - "ID":{ - "shape":"ID", - "documentation":"

If the principal is an AWS account, it provides the Canonical User ID. If the principal is an IAM User, it provides a user ARN value.

" - }, - "DisplayName":{ - "shape":"DisplayName", - "documentation":"

Name of the Principal.

" - } - } - }, - "InputSerialization":{ - "type":"structure", - "members":{ - "CSV":{ - "shape":"CSVInput", - "documentation":"

Describes the serialization of a CSV-encoded object.

" - }, - "CompressionType":{ - "shape":"CompressionType", - "documentation":"

Specifies object's compression format. Valid values: NONE, GZIP, BZIP2. Default Value: NONE.

" - }, - "JSON":{ - "shape":"JSONInput", - "documentation":"

Specifies JSON as object's input serialization format.

" - } - }, - "documentation":"

Describes the serialization format of the object.

" - }, - "InventoryConfiguration":{ - "type":"structure", - "required":[ - "Destination", - "IsEnabled", - "Id", - "IncludedObjectVersions", - "Schedule" - ], - "members":{ - "Destination":{ - "shape":"InventoryDestination", - "documentation":"

Contains information about where to publish the inventory results.

" - }, - "IsEnabled":{ - "shape":"IsEnabled", - "documentation":"

Specifies whether the inventory is enabled or disabled.

" - }, - "Filter":{ - "shape":"InventoryFilter", - "documentation":"

Specifies an inventory filter. The inventory only includes objects that meet the filter's criteria.

" - }, - "Id":{ - "shape":"InventoryId", - "documentation":"

The ID used to identify the inventory configuration.

" - }, - "IncludedObjectVersions":{ - "shape":"InventoryIncludedObjectVersions", - "documentation":"

Specifies which object version(s) to included in the inventory results.

" - }, - "OptionalFields":{ - "shape":"InventoryOptionalFields", - "documentation":"

Contains the optional fields that are included in the inventory results.

" - }, - "Schedule":{ - "shape":"InventorySchedule", - "documentation":"

Specifies the schedule for generating inventory results.

" - } - } - }, - "InventoryConfigurationList":{ - "type":"list", - "member":{"shape":"InventoryConfiguration"}, - "flattened":true - }, - "InventoryDestination":{ - "type":"structure", - "required":["S3BucketDestination"], - "members":{ - "S3BucketDestination":{ - "shape":"InventoryS3BucketDestination", - "documentation":"

Contains the bucket name, file format, bucket owner (optional), and prefix (optional) where inventory results are published.

" - } - } - }, - "InventoryEncryption":{ - "type":"structure", - "members":{ - "SSES3":{ - "shape":"SSES3", - "documentation":"

Specifies the use of SSE-S3 to encrypt delievered Inventory reports.

", - "locationName":"SSE-S3" - }, - "SSEKMS":{ - "shape":"SSEKMS", - "documentation":"

Specifies the use of SSE-KMS to encrypt delievered Inventory reports.

", - "locationName":"SSE-KMS" - } - }, - "documentation":"

Contains the type of server-side encryption used to encrypt the inventory results.

" - }, - "InventoryFilter":{ - "type":"structure", - "required":["Prefix"], - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix that an object must have to be included in the inventory results.

" - } - } - }, - "InventoryFormat":{ - "type":"string", - "enum":[ - "CSV", - "ORC" - ] - }, - "InventoryFrequency":{ - "type":"string", - "enum":[ - "Daily", - "Weekly" - ] - }, - "InventoryId":{"type":"string"}, - "InventoryIncludedObjectVersions":{ - "type":"string", - "enum":[ - "All", - "Current" - ] - }, - "InventoryOptionalField":{ - "type":"string", - "enum":[ - "Size", - "LastModifiedDate", - "StorageClass", - "ETag", - "IsMultipartUploaded", - "ReplicationStatus", - "EncryptionStatus" - ] - }, - "InventoryOptionalFields":{ - "type":"list", - "member":{ - "shape":"InventoryOptionalField", - "locationName":"Field" - } - }, - "InventoryS3BucketDestination":{ - "type":"structure", - "required":[ - "Bucket", - "Format" - ], - "members":{ - "AccountId":{ - "shape":"AccountId", - "documentation":"

The ID of the account that owns the destination bucket.

" - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

The Amazon resource name (ARN) of the bucket where inventory results will be published.

" - }, - "Format":{ - "shape":"InventoryFormat", - "documentation":"

Specifies the output format of the inventory results.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix that is prepended to all inventory results.

" - }, - "Encryption":{ - "shape":"InventoryEncryption", - "documentation":"

Contains the type of server-side encryption used to encrypt the inventory results.

" - } - } - }, - "InventorySchedule":{ - "type":"structure", - "required":["Frequency"], - "members":{ - "Frequency":{ - "shape":"InventoryFrequency", - "documentation":"

Specifies how frequently inventory results are produced.

" - } - } - }, - "IsEnabled":{"type":"boolean"}, - "IsLatest":{"type":"boolean"}, - "IsTruncated":{"type":"boolean"}, - "JSONInput":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"JSONType", - "documentation":"

The type of JSON. Valid values: Document, Lines.

" - } - } - }, - "JSONOutput":{ - "type":"structure", - "members":{ - "RecordDelimiter":{ - "shape":"RecordDelimiter", - "documentation":"

The value used to separate individual records in the output.

" - } - } - }, - "JSONType":{ - "type":"string", - "enum":[ - "DOCUMENT", - "LINES" - ] - }, - "KMSContext":{"type":"string"}, - "KeyCount":{"type":"integer"}, - "KeyMarker":{"type":"string"}, - "KeyPrefixEquals":{"type":"string"}, - "LambdaFunctionArn":{"type":"string"}, - "LambdaFunctionConfiguration":{ - "type":"structure", - "required":[ - "LambdaFunctionArn", - "Events" - ], - "members":{ - "Id":{"shape":"NotificationId"}, - "LambdaFunctionArn":{ - "shape":"LambdaFunctionArn", - "documentation":"

Lambda cloud function ARN that Amazon S3 can invoke when it detects events of the specified type.

", - "locationName":"CloudFunction" - }, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "Filter":{"shape":"NotificationConfigurationFilter"} - }, - "documentation":"

Container for specifying the AWS Lambda notification configuration.

" - }, - "LambdaFunctionConfigurationList":{ - "type":"list", - "member":{"shape":"LambdaFunctionConfiguration"}, - "flattened":true - }, - "LastModified":{"type":"timestamp"}, - "LifecycleConfiguration":{ - "type":"structure", - "required":["Rules"], - "members":{ - "Rules":{ - "shape":"Rules", - "locationName":"Rule" - } - } - }, - "LifecycleExpiration":{ - "type":"structure", - "members":{ - "Date":{ - "shape":"Date", - "documentation":"

Indicates at what date the object is to be moved or deleted. Should be in GMT ISO 8601 Format.

" - }, - "Days":{ - "shape":"Days", - "documentation":"

Indicates the lifetime, in days, of the objects that are subject to the rule. The value must be a non-zero positive integer.

" - }, - "ExpiredObjectDeleteMarker":{ - "shape":"ExpiredObjectDeleteMarker", - "documentation":"

Indicates whether Amazon S3 will remove a delete marker with no noncurrent versions. If set to true, the delete marker will be expired; if set to false the policy takes no action. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.

" - } - } - }, - "LifecycleRule":{ - "type":"structure", - "required":["Status"], - "members":{ - "Expiration":{"shape":"LifecycleExpiration"}, - "ID":{ - "shape":"ID", - "documentation":"

Unique identifier for the rule. The value cannot be longer than 255 characters.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Prefix identifying one or more objects to which the rule applies. This is deprecated; use Filter instead.

", - "deprecated":true - }, - "Filter":{"shape":"LifecycleRuleFilter"}, - "Status":{ - "shape":"ExpirationStatus", - "documentation":"

If 'Enabled', the rule is currently being applied. If 'Disabled', the rule is not currently being applied.

" - }, - "Transitions":{ - "shape":"TransitionList", - "locationName":"Transition" - }, - "NoncurrentVersionTransitions":{ - "shape":"NoncurrentVersionTransitionList", - "locationName":"NoncurrentVersionTransition" - }, - "NoncurrentVersionExpiration":{"shape":"NoncurrentVersionExpiration"}, - "AbortIncompleteMultipartUpload":{"shape":"AbortIncompleteMultipartUpload"} - } - }, - "LifecycleRuleAndOperator":{ - "type":"structure", - "members":{ - "Prefix":{"shape":"Prefix"}, - "Tags":{ - "shape":"TagSet", - "documentation":"

All of these tags must exist in the object's tag set in order for the rule to apply.

", - "flattened":true, - "locationName":"Tag" - } - }, - "documentation":"

This is used in a Lifecycle Rule Filter to apply a logical AND to two or more predicates. The Lifecycle Rule will apply to any object matching all of the predicates configured inside the And operator.

" - }, - "LifecycleRuleFilter":{ - "type":"structure", - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

Prefix identifying one or more objects to which the rule applies.

" - }, - "Tag":{ - "shape":"Tag", - "documentation":"

This tag must exist in the object's tag set in order for the rule to apply.

" - }, - "And":{"shape":"LifecycleRuleAndOperator"} - }, - "documentation":"

The Filter is used to identify objects that a Lifecycle Rule applies to. A Filter must have exactly one of Prefix, Tag, or And specified.

" - }, - "LifecycleRules":{ - "type":"list", - "member":{"shape":"LifecycleRule"}, - "flattened":true - }, - "ListBucketAnalyticsConfigurationsOutput":{ - "type":"structure", - "members":{ - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

Indicates whether the returned list of analytics configurations is complete. A value of true indicates that the list is not complete and the NextContinuationToken will be provided for a subsequent request.

" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

The ContinuationToken that represents where this request began.

" - }, - "NextContinuationToken":{ - "shape":"NextToken", - "documentation":"

NextContinuationToken is sent when isTruncated is true, which indicates that there are more analytics configurations to list. The next request must include this NextContinuationToken. The token is obfuscated and is not a usable value.

" - }, - "AnalyticsConfigurationList":{ - "shape":"AnalyticsConfigurationList", - "documentation":"

The list of analytics configurations for a bucket.

", - "locationName":"AnalyticsConfiguration" - } - } - }, - "ListBucketAnalyticsConfigurationsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket from which analytics configurations are retrieved.

", - "location":"uri", - "locationName":"Bucket" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

The ContinuationToken that represents a placeholder from where this request should begin.

", - "location":"querystring", - "locationName":"continuation-token" - } - } - }, - "ListBucketInventoryConfigurationsOutput":{ - "type":"structure", - "members":{ - "ContinuationToken":{ - "shape":"Token", - "documentation":"

If sent in the request, the marker that is used as a starting point for this inventory configuration list response.

" - }, - "InventoryConfigurationList":{ - "shape":"InventoryConfigurationList", - "documentation":"

The list of inventory configurations for a bucket.

", - "locationName":"InventoryConfiguration" - }, - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

Indicates whether the returned list of inventory configurations is truncated in this response. A value of true indicates that the list is truncated.

" - }, - "NextContinuationToken":{ - "shape":"NextToken", - "documentation":"

The marker used to continue this inventory configuration listing. Use the NextContinuationToken from this response to continue the listing in a subsequent request. The continuation token is an opaque value that Amazon S3 understands.

" - } - } - }, - "ListBucketInventoryConfigurationsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the inventory configurations to retrieve.

", - "location":"uri", - "locationName":"Bucket" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

The marker used to continue an inventory configuration listing that has been truncated. Use the NextContinuationToken from a previously truncated list response to continue the listing. The continuation token is an opaque value that Amazon S3 understands.

", - "location":"querystring", - "locationName":"continuation-token" - } - } - }, - "ListBucketMetricsConfigurationsOutput":{ - "type":"structure", - "members":{ - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

Indicates whether the returned list of metrics configurations is complete. A value of true indicates that the list is not complete and the NextContinuationToken will be provided for a subsequent request.

" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

The marker that is used as a starting point for this metrics configuration list response. This value is present if it was sent in the request.

" - }, - "NextContinuationToken":{ - "shape":"NextToken", - "documentation":"

The marker used to continue a metrics configuration listing that has been truncated. Use the NextContinuationToken from a previously truncated list response to continue the listing. The continuation token is an opaque value that Amazon S3 understands.

" - }, - "MetricsConfigurationList":{ - "shape":"MetricsConfigurationList", - "documentation":"

The list of metrics configurations for a bucket.

", - "locationName":"MetricsConfiguration" - } - } - }, - "ListBucketMetricsConfigurationsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket containing the metrics configurations to retrieve.

", - "location":"uri", - "locationName":"Bucket" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

The marker that is used to continue a metrics configuration listing that has been truncated. Use the NextContinuationToken from a previously truncated list response to continue the listing. The continuation token is an opaque value that Amazon S3 understands.

", - "location":"querystring", - "locationName":"continuation-token" - } - } - }, - "ListBucketsOutput":{ - "type":"structure", - "members":{ - "Buckets":{"shape":"Buckets"}, - "Owner":{"shape":"Owner"} - } - }, - "ListMultipartUploadsOutput":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to which the multipart upload was initiated.

" - }, - "KeyMarker":{ - "shape":"KeyMarker", - "documentation":"

The key at or after which the listing began.

" - }, - "UploadIdMarker":{ - "shape":"UploadIdMarker", - "documentation":"

Upload ID after which listing began.

" - }, - "NextKeyMarker":{ - "shape":"NextKeyMarker", - "documentation":"

When a list is truncated, this element specifies the value that should be used for the key-marker request parameter in a subsequent request.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

When a prefix is provided in the request, this field contains the specified prefix. The result contains only keys starting with the specified prefix.

" - }, - "Delimiter":{"shape":"Delimiter"}, - "NextUploadIdMarker":{ - "shape":"NextUploadIdMarker", - "documentation":"

When a list is truncated, this element specifies the value that should be used for the upload-id-marker request parameter in a subsequent request.

" - }, - "MaxUploads":{ - "shape":"MaxUploads", - "documentation":"

Maximum number of multipart uploads that could have been included in the response.

" - }, - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

Indicates whether the returned list of multipart uploads is truncated. A value of true indicates that the list was truncated. The list can be truncated if the number of multipart uploads exceeds the limit allowed or specified by max uploads.

" - }, - "Uploads":{ - "shape":"MultipartUploadList", - "locationName":"Upload" - }, - "CommonPrefixes":{"shape":"CommonPrefixList"}, - "EncodingType":{ - "shape":"EncodingType", - "documentation":"

Encoding type used by Amazon S3 to encode object keys in the response.

" - } - } - }, - "ListMultipartUploadsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Delimiter":{ - "shape":"Delimiter", - "documentation":"

Character you use to group keys.

", - "location":"querystring", - "locationName":"delimiter" - }, - "EncodingType":{ - "shape":"EncodingType", - "location":"querystring", - "locationName":"encoding-type" - }, - "KeyMarker":{ - "shape":"KeyMarker", - "documentation":"

Together with upload-id-marker, this parameter specifies the multipart upload after which listing should begin.

", - "location":"querystring", - "locationName":"key-marker" - }, - "MaxUploads":{ - "shape":"MaxUploads", - "documentation":"

Sets the maximum number of multipart uploads, from 1 to 1,000, to return in the response body. 1,000 is the maximum number of uploads that can be returned in a response.

", - "location":"querystring", - "locationName":"max-uploads" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Lists in-progress uploads only for those keys that begin with the specified prefix.

", - "location":"querystring", - "locationName":"prefix" - }, - "UploadIdMarker":{ - "shape":"UploadIdMarker", - "documentation":"

Together with key-marker, specifies the multipart upload after which listing should begin. If key-marker is not specified, the upload-id-marker parameter is ignored.

", - "location":"querystring", - "locationName":"upload-id-marker" - } - } - }, - "ListObjectVersionsOutput":{ - "type":"structure", - "members":{ - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria. If your results were truncated, you can make a follow-up paginated request using the NextKeyMarker and NextVersionIdMarker response parameters as a starting place in another request to return the rest of the results.

" - }, - "KeyMarker":{ - "shape":"KeyMarker", - "documentation":"

Marks the last Key returned in a truncated response.

" - }, - "VersionIdMarker":{"shape":"VersionIdMarker"}, - "NextKeyMarker":{ - "shape":"NextKeyMarker", - "documentation":"

Use this value for the key marker request parameter in a subsequent request.

" - }, - "NextVersionIdMarker":{ - "shape":"NextVersionIdMarker", - "documentation":"

Use this value for the next version id marker parameter in a subsequent request.

" - }, - "Versions":{ - "shape":"ObjectVersionList", - "locationName":"Version" - }, - "DeleteMarkers":{ - "shape":"DeleteMarkers", - "locationName":"DeleteMarker" - }, - "Name":{"shape":"BucketName"}, - "Prefix":{"shape":"Prefix"}, - "Delimiter":{"shape":"Delimiter"}, - "MaxKeys":{"shape":"MaxKeys"}, - "CommonPrefixes":{"shape":"CommonPrefixList"}, - "EncodingType":{ - "shape":"EncodingType", - "documentation":"

Encoding type used by Amazon S3 to encode object keys in the response.

" - } - } - }, - "ListObjectVersionsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Delimiter":{ - "shape":"Delimiter", - "documentation":"

A delimiter is a character you use to group keys.

", - "location":"querystring", - "locationName":"delimiter" - }, - "EncodingType":{ - "shape":"EncodingType", - "location":"querystring", - "locationName":"encoding-type" - }, - "KeyMarker":{ - "shape":"KeyMarker", - "documentation":"

Specifies the key to start with when listing objects in a bucket.

", - "location":"querystring", - "locationName":"key-marker" - }, - "MaxKeys":{ - "shape":"MaxKeys", - "documentation":"

Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.

", - "location":"querystring", - "locationName":"max-keys" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Limits the response to keys that begin with the specified prefix.

", - "location":"querystring", - "locationName":"prefix" - }, - "VersionIdMarker":{ - "shape":"VersionIdMarker", - "documentation":"

Specifies the object version you want to start listing from.

", - "location":"querystring", - "locationName":"version-id-marker" - } - } - }, - "ListObjectsOutput":{ - "type":"structure", - "members":{ - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria.

" - }, - "Marker":{"shape":"Marker"}, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

When response is truncated (the IsTruncated element value in the response is true), you can use the key name in this field as marker in the subsequent request to get next set of objects. Amazon S3 lists objects in alphabetical order Note: This element is returned only if you have delimiter request parameter specified. If response does not include the NextMaker and it is truncated, you can use the value of the last Key in the response as the marker in the subsequent request to get the next set of object keys.

" - }, - "Contents":{"shape":"ObjectList"}, - "Name":{"shape":"BucketName"}, - "Prefix":{"shape":"Prefix"}, - "Delimiter":{"shape":"Delimiter"}, - "MaxKeys":{"shape":"MaxKeys"}, - "CommonPrefixes":{"shape":"CommonPrefixList"}, - "EncodingType":{ - "shape":"EncodingType", - "documentation":"

Encoding type used by Amazon S3 to encode object keys in the response.

" - } - } - }, - "ListObjectsRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Delimiter":{ - "shape":"Delimiter", - "documentation":"

A delimiter is a character you use to group keys.

", - "location":"querystring", - "locationName":"delimiter" - }, - "EncodingType":{ - "shape":"EncodingType", - "location":"querystring", - "locationName":"encoding-type" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

Specifies the key to start with when listing objects in a bucket.

", - "location":"querystring", - "locationName":"marker" - }, - "MaxKeys":{ - "shape":"MaxKeys", - "documentation":"

Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.

", - "location":"querystring", - "locationName":"max-keys" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Limits the response to keys that begin with the specified prefix.

", - "location":"querystring", - "locationName":"prefix" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "documentation":"

Confirms that the requester knows that she or he will be charged for the list objects request. Bucket owners need not specify this parameter in their requests.

", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "ListObjectsV2Output":{ - "type":"structure", - "members":{ - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

A flag that indicates whether or not Amazon S3 returned all of the results that satisfied the search criteria.

" - }, - "Contents":{ - "shape":"ObjectList", - "documentation":"

Metadata about each object returned.

" - }, - "Name":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to list.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Limits the response to keys that begin with the specified prefix.

" - }, - "Delimiter":{ - "shape":"Delimiter", - "documentation":"

A delimiter is a character you use to group keys.

" - }, - "MaxKeys":{ - "shape":"MaxKeys", - "documentation":"

Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.

" - }, - "CommonPrefixes":{ - "shape":"CommonPrefixList", - "documentation":"

CommonPrefixes contains all (if there are any) keys between Prefix and the next occurrence of the string specified by delimiter

" - }, - "EncodingType":{ - "shape":"EncodingType", - "documentation":"

Encoding type used by Amazon S3 to encode object keys in the response.

" - }, - "KeyCount":{ - "shape":"KeyCount", - "documentation":"

KeyCount is the number of keys returned with this request. KeyCount will always be less than equals to MaxKeys field. Say you ask for 50 keys, your result will include less than equals 50 keys

" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

ContinuationToken indicates Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key

" - }, - "NextContinuationToken":{ - "shape":"NextToken", - "documentation":"

NextContinuationToken is sent when isTruncated is true which means there are more keys in the bucket that can be listed. The next list requests to Amazon S3 can be continued with this NextContinuationToken. NextContinuationToken is obfuscated and is not a real key

" - }, - "StartAfter":{ - "shape":"StartAfter", - "documentation":"

StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts listing after this specified key. StartAfter can be any key in the bucket

" - } - } - }, - "ListObjectsV2Request":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to list.

", - "location":"uri", - "locationName":"Bucket" - }, - "Delimiter":{ - "shape":"Delimiter", - "documentation":"

A delimiter is a character you use to group keys.

", - "location":"querystring", - "locationName":"delimiter" - }, - "EncodingType":{ - "shape":"EncodingType", - "documentation":"

Encoding type used by Amazon S3 to encode object keys in the response.

", - "location":"querystring", - "locationName":"encoding-type" - }, - "MaxKeys":{ - "shape":"MaxKeys", - "documentation":"

Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.

", - "location":"querystring", - "locationName":"max-keys" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Limits the response to keys that begin with the specified prefix.

", - "location":"querystring", - "locationName":"prefix" - }, - "ContinuationToken":{ - "shape":"Token", - "documentation":"

ContinuationToken indicates Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key

", - "location":"querystring", - "locationName":"continuation-token" - }, - "FetchOwner":{ - "shape":"FetchOwner", - "documentation":"

The owner field is not present in listV2 by default, if you want to return owner field with each key in the result then set the fetch owner field to true

", - "location":"querystring", - "locationName":"fetch-owner" - }, - "StartAfter":{ - "shape":"StartAfter", - "documentation":"

StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts listing after this specified key. StartAfter can be any key in the bucket

", - "location":"querystring", - "locationName":"start-after" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "documentation":"

Confirms that the requester knows that she or he will be charged for the list objects request in V2 style. Bucket owners need not specify this parameter in their requests.

", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "ListPartsOutput":{ - "type":"structure", - "members":{ - "AbortDate":{ - "shape":"AbortDate", - "documentation":"

Date when multipart upload will become eligible for abort operation by lifecycle.

", - "location":"header", - "locationName":"x-amz-abort-date" - }, - "AbortRuleId":{ - "shape":"AbortRuleId", - "documentation":"

Id of the lifecycle rule that makes a multipart upload eligible for abort operation.

", - "location":"header", - "locationName":"x-amz-abort-rule-id" - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to which the multipart upload was initiated.

" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

Object key for which the multipart upload was initiated.

" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

Upload ID identifying the multipart upload whose parts are being listed.

" - }, - "PartNumberMarker":{ - "shape":"PartNumberMarker", - "documentation":"

Part number after which listing begins.

" - }, - "NextPartNumberMarker":{ - "shape":"NextPartNumberMarker", - "documentation":"

When a list is truncated, this element specifies the last part in the list, as well as the value to use for the part-number-marker request parameter in a subsequent request.

" - }, - "MaxParts":{ - "shape":"MaxParts", - "documentation":"

Maximum number of parts that were allowed in the response.

" - }, - "IsTruncated":{ - "shape":"IsTruncated", - "documentation":"

Indicates whether the returned list of parts is truncated.

" - }, - "Parts":{ - "shape":"Parts", - "locationName":"Part" - }, - "Initiator":{ - "shape":"Initiator", - "documentation":"

Identifies who initiated the multipart upload.

" - }, - "Owner":{"shape":"Owner"}, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The class of storage used to store the object.

" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "ListPartsRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "UploadId" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "MaxParts":{ - "shape":"MaxParts", - "documentation":"

Sets the maximum number of parts to return.

", - "location":"querystring", - "locationName":"max-parts" - }, - "PartNumberMarker":{ - "shape":"PartNumberMarker", - "documentation":"

Specifies the part after which listing should begin. Only parts with higher part numbers will be listed.

", - "location":"querystring", - "locationName":"part-number-marker" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

Upload ID identifying the multipart upload whose parts are being listed.

", - "location":"querystring", - "locationName":"uploadId" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "Location":{"type":"string"}, - "LocationPrefix":{"type":"string"}, - "LoggingEnabled":{ - "type":"structure", - "required":[ - "TargetBucket", - "TargetPrefix" - ], - "members":{ - "TargetBucket":{ - "shape":"TargetBucket", - "documentation":"

Specifies the bucket where you want Amazon S3 to store server access logs. You can have your logs delivered to any bucket that you own, including the same bucket that is being logged. You can also configure multiple buckets to deliver their logs to the same target bucket. In this case you should choose a different TargetPrefix for each source bucket so that the delivered log files can be distinguished by key.

" - }, - "TargetGrants":{"shape":"TargetGrants"}, - "TargetPrefix":{ - "shape":"TargetPrefix", - "documentation":"

This element lets you specify a prefix for the keys that the log files will be stored under.

" - } - }, - "documentation":"

Container for logging information. Presence of this element indicates that logging is enabled. Parameters TargetBucket and TargetPrefix are required in this case.

" - }, - "MFA":{"type":"string"}, - "MFADelete":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "MFADeleteStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "Marker":{"type":"string"}, - "MaxAgeSeconds":{"type":"integer"}, - "MaxKeys":{"type":"integer"}, - "MaxParts":{"type":"integer"}, - "MaxUploads":{"type":"integer"}, - "Message":{"type":"string"}, - "Metadata":{ - "type":"map", - "key":{"shape":"MetadataKey"}, - "value":{"shape":"MetadataValue"} - }, - "MetadataDirective":{ - "type":"string", - "enum":[ - "COPY", - "REPLACE" - ] - }, - "MetadataEntry":{ - "type":"structure", - "members":{ - "Name":{"shape":"MetadataKey"}, - "Value":{"shape":"MetadataValue"} - }, - "documentation":"

A metadata key-value pair to store with an object.

" - }, - "MetadataKey":{"type":"string"}, - "MetadataValue":{"type":"string"}, - "MetricsAndOperator":{ - "type":"structure", - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix used when evaluating an AND predicate.

" - }, - "Tags":{ - "shape":"TagSet", - "documentation":"

The list of tags used when evaluating an AND predicate.

", - "flattened":true, - "locationName":"Tag" - } - } - }, - "MetricsConfiguration":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"MetricsId", - "documentation":"

The ID used to identify the metrics configuration.

" - }, - "Filter":{ - "shape":"MetricsFilter", - "documentation":"

Specifies a metrics configuration filter. The metrics configuration will only include objects that meet the filter's criteria. A filter must be a prefix, a tag, or a conjunction (MetricsAndOperator).

" - } - } - }, - "MetricsConfigurationList":{ - "type":"list", - "member":{"shape":"MetricsConfiguration"}, - "flattened":true - }, - "MetricsFilter":{ - "type":"structure", - "members":{ - "Prefix":{ - "shape":"Prefix", - "documentation":"

The prefix used when evaluating a metrics filter.

" - }, - "Tag":{ - "shape":"Tag", - "documentation":"

The tag used when evaluating a metrics filter.

" - }, - "And":{ - "shape":"MetricsAndOperator", - "documentation":"

A conjunction (logical AND) of predicates, which is used in evaluating a metrics filter. The operator must have at least two predicates, and an object must match all of the predicates in order for the filter to apply.

" - } - } - }, - "MetricsId":{"type":"string"}, - "MissingMeta":{"type":"integer"}, - "MultipartUpload":{ - "type":"structure", - "members":{ - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

Upload ID that identifies the multipart upload.

" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

Key of the object for which the multipart upload was initiated.

" - }, - "Initiated":{ - "shape":"Initiated", - "documentation":"

Date and time at which the multipart upload was initiated.

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The class of storage used to store the object.

" - }, - "Owner":{"shape":"Owner"}, - "Initiator":{ - "shape":"Initiator", - "documentation":"

Identifies who initiated the multipart upload.

" - } - } - }, - "MultipartUploadId":{"type":"string"}, - "MultipartUploadList":{ - "type":"list", - "member":{"shape":"MultipartUpload"}, - "flattened":true - }, - "NextKeyMarker":{"type":"string"}, - "NextMarker":{"type":"string"}, - "NextPartNumberMarker":{"type":"integer"}, - "NextToken":{"type":"string"}, - "NextUploadIdMarker":{"type":"string"}, - "NextVersionIdMarker":{"type":"string"}, - "NoSuchBucket":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified bucket does not exist.

", - "exception":true - }, - "NoSuchKey":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified key does not exist.

", - "exception":true - }, - "NoSuchUpload":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified multipart upload does not exist.

", - "exception":true - }, - "NoncurrentVersionExpiration":{ - "type":"structure", - "members":{ - "NoncurrentDays":{ - "shape":"Days", - "documentation":"

Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. For information about the noncurrent days calculations, see How Amazon S3 Calculates When an Object Became Noncurrent in the Amazon Simple Storage Service Developer Guide.

" - } - }, - "documentation":"

Specifies when noncurrent object versions expire. Upon expiration, Amazon S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that Amazon S3 delete noncurrent object versions at a specific period in the object's lifetime.

" - }, - "NoncurrentVersionTransition":{ - "type":"structure", - "members":{ - "NoncurrentDays":{ - "shape":"Days", - "documentation":"

Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. For information about the noncurrent days calculations, see How Amazon S3 Calculates When an Object Became Noncurrent in the Amazon Simple Storage Service Developer Guide.

" - }, - "StorageClass":{ - "shape":"TransitionStorageClass", - "documentation":"

The class of storage used to store the object.

" - } - }, - "documentation":"

Container for the transition rule that describes when noncurrent objects transition to the STANDARD_IA, ONEZONE_IA or GLACIER storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA or GLACIER storage class at a specific period in the object's lifetime.

" - }, - "NoncurrentVersionTransitionList":{ - "type":"list", - "member":{"shape":"NoncurrentVersionTransition"}, - "flattened":true - }, - "NotificationConfiguration":{ - "type":"structure", - "members":{ - "TopicConfigurations":{ - "shape":"TopicConfigurationList", - "locationName":"TopicConfiguration" - }, - "QueueConfigurations":{ - "shape":"QueueConfigurationList", - "locationName":"QueueConfiguration" - }, - "LambdaFunctionConfigurations":{ - "shape":"LambdaFunctionConfigurationList", - "locationName":"CloudFunctionConfiguration" - } - }, - "documentation":"

Container for specifying the notification configuration of the bucket. If this element is empty, notifications are turned off on the bucket.

" - }, - "NotificationConfigurationDeprecated":{ - "type":"structure", - "members":{ - "TopicConfiguration":{"shape":"TopicConfigurationDeprecated"}, - "QueueConfiguration":{"shape":"QueueConfigurationDeprecated"}, - "CloudFunctionConfiguration":{"shape":"CloudFunctionConfiguration"} - } - }, - "NotificationConfigurationFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"S3KeyFilter", - "locationName":"S3Key" - } - }, - "documentation":"

Container for object key name filtering rules. For information about key name filtering, go to Configuring Event Notifications in the Amazon Simple Storage Service Developer Guide.

" - }, - "NotificationId":{ - "type":"string", - "documentation":"

Optional unique identifier for configurations in a notification configuration. If you don't provide one, Amazon S3 will assign an ID.

" - }, - "Object":{ - "type":"structure", - "members":{ - "Key":{"shape":"ObjectKey"}, - "LastModified":{"shape":"LastModified"}, - "ETag":{"shape":"ETag"}, - "Size":{"shape":"Size"}, - "StorageClass":{ - "shape":"ObjectStorageClass", - "documentation":"

The class of storage used to store the object.

" - }, - "Owner":{"shape":"Owner"} - } - }, - "ObjectAlreadyInActiveTierError":{ - "type":"structure", - "members":{ - }, - "documentation":"

This operation is not allowed against this storage tier

", - "exception":true - }, - "ObjectCannedACL":{ - "type":"string", - "enum":[ - "private", - "public-read", - "public-read-write", - "authenticated-read", - "aws-exec-read", - "bucket-owner-read", - "bucket-owner-full-control" - ] - }, - "ObjectIdentifier":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"ObjectKey", - "documentation":"

Key name of the object to delete.

" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId for the specific version of the object to delete.

" - } - } - }, - "ObjectIdentifierList":{ - "type":"list", - "member":{"shape":"ObjectIdentifier"}, - "flattened":true - }, - "ObjectKey":{ - "type":"string", - "min":1 - }, - "ObjectList":{ - "type":"list", - "member":{"shape":"Object"}, - "flattened":true - }, - "ObjectNotInActiveTierError":{ - "type":"structure", - "members":{ - }, - "documentation":"

The source object of the COPY operation is not in the active tier and is only stored in Amazon Glacier.

", - "exception":true - }, - "ObjectStorageClass":{ - "type":"string", - "enum":[ - "STANDARD", - "REDUCED_REDUNDANCY", - "GLACIER", - "STANDARD_IA", - "ONEZONE_IA" - ] - }, - "ObjectVersion":{ - "type":"structure", - "members":{ - "ETag":{"shape":"ETag"}, - "Size":{ - "shape":"Size", - "documentation":"

Size in bytes of the object.

" - }, - "StorageClass":{ - "shape":"ObjectVersionStorageClass", - "documentation":"

The class of storage used to store the object.

" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

The object key.

" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version ID of an object.

" - }, - "IsLatest":{ - "shape":"IsLatest", - "documentation":"

Specifies whether the object is (true) or is not (false) the latest version of an object.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Date and time the object was last modified.

" - }, - "Owner":{"shape":"Owner"} - } - }, - "ObjectVersionId":{"type":"string"}, - "ObjectVersionList":{ - "type":"list", - "member":{"shape":"ObjectVersion"}, - "flattened":true - }, - "ObjectVersionStorageClass":{ - "type":"string", - "enum":["STANDARD"] - }, - "OutputLocation":{ - "type":"structure", - "members":{ - "S3":{ - "shape":"S3Location", - "documentation":"

Describes an S3 location that will receive the results of the restore request.

" - } - }, - "documentation":"

Describes the location where the restore job's output is stored.

" - }, - "OutputSerialization":{ - "type":"structure", - "members":{ - "CSV":{ - "shape":"CSVOutput", - "documentation":"

Describes the serialization of CSV-encoded Select results.

" - }, - "JSON":{ - "shape":"JSONOutput", - "documentation":"

Specifies JSON as request's output serialization format.

" - } - }, - "documentation":"

Describes how results of the Select job are serialized.

" - }, - "Owner":{ - "type":"structure", - "members":{ - "DisplayName":{"shape":"DisplayName"}, - "ID":{"shape":"ID"} - } - }, - "OwnerOverride":{ - "type":"string", - "enum":["Destination"] - }, - "Part":{ - "type":"structure", - "members":{ - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number identifying the part. This is a positive integer between 1 and 10,000.

" - }, - "LastModified":{ - "shape":"LastModified", - "documentation":"

Date and time at which the part was uploaded.

" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag returned when the part was uploaded.

" - }, - "Size":{ - "shape":"Size", - "documentation":"

Size of the uploaded part data.

" - } - } - }, - "PartNumber":{"type":"integer"}, - "PartNumberMarker":{"type":"integer"}, - "Parts":{ - "type":"list", - "member":{"shape":"Part"}, - "flattened":true - }, - "PartsCount":{"type":"integer"}, - "Payer":{ - "type":"string", - "enum":[ - "Requester", - "BucketOwner" - ] - }, - "Permission":{ - "type":"string", - "enum":[ - "FULL_CONTROL", - "WRITE", - "WRITE_ACP", - "READ", - "READ_ACP" - ] - }, - "Policy":{"type":"string"}, - "Prefix":{"type":"string"}, - "Progress":{ - "type":"structure", - "members":{ - "BytesScanned":{ - "shape":"BytesScanned", - "documentation":"

Current number of object bytes scanned.

" - }, - "BytesProcessed":{ - "shape":"BytesProcessed", - "documentation":"

Current number of uncompressed object bytes processed.

" - }, - "BytesReturned":{ - "shape":"BytesReturned", - "documentation":"

Current number of bytes of records payload data returned.

" - } - } - }, - "ProgressEvent":{ - "type":"structure", - "members":{ - "Details":{ - "shape":"Progress", - "documentation":"

The Progress event details.

", - "eventpayload":true - } - }, - "event":true - }, - "Protocol":{ - "type":"string", - "enum":[ - "http", - "https" - ] - }, - "PutBucketAccelerateConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "AccelerateConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket for which the accelerate configuration is set.

", - "location":"uri", - "locationName":"Bucket" - }, - "AccelerateConfiguration":{ - "shape":"AccelerateConfiguration", - "documentation":"

Specifies the Accelerate Configuration you want to set for the bucket.

", - "locationName":"AccelerateConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"AccelerateConfiguration" - }, - "PutBucketAclRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "ACL":{ - "shape":"BucketCannedACL", - "documentation":"

The canned ACL to apply to the bucket.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "AccessControlPolicy":{ - "shape":"AccessControlPolicy", - "locationName":"AccessControlPolicy", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to list the objects in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the bucket ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWrite":{ - "shape":"GrantWrite", - "documentation":"

Allows grantee to create, overwrite, and delete any object in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-write" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable bucket.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - } - }, - "payload":"AccessControlPolicy" - }, - "PutBucketAnalyticsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id", - "AnalyticsConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket to which an analytics configuration is stored.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"AnalyticsId", - "documentation":"

The identifier used to represent an analytics configuration.

", - "location":"querystring", - "locationName":"id" - }, - "AnalyticsConfiguration":{ - "shape":"AnalyticsConfiguration", - "documentation":"

The configuration and any analyses for the analytics filter.

", - "locationName":"AnalyticsConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"AnalyticsConfiguration" - }, - "PutBucketCorsRequest":{ - "type":"structure", - "required":[ - "Bucket", - "CORSConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "CORSConfiguration":{ - "shape":"CORSConfiguration", - "locationName":"CORSConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - } - }, - "payload":"CORSConfiguration" - }, - "PutBucketEncryptionRequest":{ - "type":"structure", - "required":[ - "Bucket", - "ServerSideEncryptionConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket for which the server-side encryption configuration is set.

", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "documentation":"

The base64-encoded 128-bit MD5 digest of the server-side encryption configuration.

", - "location":"header", - "locationName":"Content-MD5" - }, - "ServerSideEncryptionConfiguration":{ - "shape":"ServerSideEncryptionConfiguration", - "locationName":"ServerSideEncryptionConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"ServerSideEncryptionConfiguration" - }, - "PutBucketInventoryConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id", - "InventoryConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket where the inventory configuration will be stored.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"InventoryId", - "documentation":"

The ID used to identify the inventory configuration.

", - "location":"querystring", - "locationName":"id" - }, - "InventoryConfiguration":{ - "shape":"InventoryConfiguration", - "documentation":"

Specifies the inventory configuration.

", - "locationName":"InventoryConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"InventoryConfiguration" - }, - "PutBucketLifecycleConfigurationRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "LifecycleConfiguration":{ - "shape":"BucketLifecycleConfiguration", - "locationName":"LifecycleConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"LifecycleConfiguration" - }, - "PutBucketLifecycleRequest":{ - "type":"structure", - "required":["Bucket"], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "LifecycleConfiguration":{ - "shape":"LifecycleConfiguration", - "locationName":"LifecycleConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"LifecycleConfiguration" - }, - "PutBucketLoggingRequest":{ - "type":"structure", - "required":[ - "Bucket", - "BucketLoggingStatus" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "BucketLoggingStatus":{ - "shape":"BucketLoggingStatus", - "locationName":"BucketLoggingStatus", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - } - }, - "payload":"BucketLoggingStatus" - }, - "PutBucketMetricsConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Id", - "MetricsConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The name of the bucket for which the metrics configuration is set.

", - "location":"uri", - "locationName":"Bucket" - }, - "Id":{ - "shape":"MetricsId", - "documentation":"

The ID used to identify the metrics configuration.

", - "location":"querystring", - "locationName":"id" - }, - "MetricsConfiguration":{ - "shape":"MetricsConfiguration", - "documentation":"

Specifies the metrics configuration.

", - "locationName":"MetricsConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"MetricsConfiguration" - }, - "PutBucketNotificationConfigurationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "NotificationConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "NotificationConfiguration":{ - "shape":"NotificationConfiguration", - "locationName":"NotificationConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"NotificationConfiguration" - }, - "PutBucketNotificationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "NotificationConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "NotificationConfiguration":{ - "shape":"NotificationConfigurationDeprecated", - "locationName":"NotificationConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"NotificationConfiguration" - }, - "PutBucketPolicyRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Policy" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "ConfirmRemoveSelfBucketAccess":{ - "shape":"ConfirmRemoveSelfBucketAccess", - "documentation":"

Set this parameter to true to confirm that you want to remove your permissions to change this bucket policy in the future.

", - "location":"header", - "locationName":"x-amz-confirm-remove-self-bucket-access" - }, - "Policy":{ - "shape":"Policy", - "documentation":"

The bucket policy as a JSON document.

" - } - }, - "payload":"Policy" - }, - "PutBucketReplicationRequest":{ - "type":"structure", - "required":[ - "Bucket", - "ReplicationConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "ReplicationConfiguration":{ - "shape":"ReplicationConfiguration", - "locationName":"ReplicationConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"ReplicationConfiguration" - }, - "PutBucketRequestPaymentRequest":{ - "type":"structure", - "required":[ - "Bucket", - "RequestPaymentConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "RequestPaymentConfiguration":{ - "shape":"RequestPaymentConfiguration", - "locationName":"RequestPaymentConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"RequestPaymentConfiguration" - }, - "PutBucketTaggingRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Tagging" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "Tagging":{ - "shape":"Tagging", - "locationName":"Tagging", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"Tagging" - }, - "PutBucketVersioningRequest":{ - "type":"structure", - "required":[ - "Bucket", - "VersioningConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "MFA":{ - "shape":"MFA", - "documentation":"

The concatenation of the authentication device's serial number, a space, and the value that is displayed on your authentication device.

", - "location":"header", - "locationName":"x-amz-mfa" - }, - "VersioningConfiguration":{ - "shape":"VersioningConfiguration", - "locationName":"VersioningConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"VersioningConfiguration" - }, - "PutBucketWebsiteRequest":{ - "type":"structure", - "required":[ - "Bucket", - "WebsiteConfiguration" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "WebsiteConfiguration":{ - "shape":"WebsiteConfiguration", - "locationName":"WebsiteConfiguration", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"WebsiteConfiguration" - }, - "PutObjectAclOutput":{ - "type":"structure", - "members":{ - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "PutObjectAclRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "ACL":{ - "shape":"ObjectCannedACL", - "documentation":"

The canned ACL to apply to the object.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "AccessControlPolicy":{ - "shape":"AccessControlPolicy", - "locationName":"AccessControlPolicy", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to list the objects in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the bucket ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWrite":{ - "shape":"GrantWrite", - "documentation":"

Allows grantee to create, overwrite, and delete any object in the bucket.

", - "location":"header", - "locationName":"x-amz-grant-write" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable bucket.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

VersionId used to reference a specific version of the object.

", - "location":"querystring", - "locationName":"versionId" - } - }, - "payload":"AccessControlPolicy" - }, - "PutObjectOutput":{ - "type":"structure", - "members":{ - "Expiration":{ - "shape":"Expiration", - "documentation":"

If the object expiration is configured, this will contain the expiration date (expiry-date) and rule ID (rule-id). The value of rule-id is URL encoded.

", - "location":"header", - "locationName":"x-amz-expiration" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag for the uploaded object.

", - "location":"header", - "locationName":"ETag" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "documentation":"

Version of the object.

", - "location":"header", - "locationName":"x-amz-version-id" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "PutObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "ACL":{ - "shape":"ObjectCannedACL", - "documentation":"

The canned ACL to apply to the object.

", - "location":"header", - "locationName":"x-amz-acl" - }, - "Body":{ - "shape":"Body", - "documentation":"

Object data.

", - "streaming":true - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to which the PUT operation was initiated.

", - "location":"uri", - "locationName":"Bucket" - }, - "CacheControl":{ - "shape":"CacheControl", - "documentation":"

Specifies caching behavior along the request/reply chain.

", - "location":"header", - "locationName":"Cache-Control" - }, - "ContentDisposition":{ - "shape":"ContentDisposition", - "documentation":"

Specifies presentational information for the object.

", - "location":"header", - "locationName":"Content-Disposition" - }, - "ContentEncoding":{ - "shape":"ContentEncoding", - "documentation":"

Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.

", - "location":"header", - "locationName":"Content-Encoding" - }, - "ContentLanguage":{ - "shape":"ContentLanguage", - "documentation":"

The language the content is in.

", - "location":"header", - "locationName":"Content-Language" - }, - "ContentLength":{ - "shape":"ContentLength", - "documentation":"

Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.

", - "location":"header", - "locationName":"Content-Length" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "documentation":"

The base64-encoded 128-bit MD5 digest of the part data.

", - "location":"header", - "locationName":"Content-MD5" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

A standard MIME type describing the format of the object data.

", - "location":"header", - "locationName":"Content-Type" - }, - "Expires":{ - "shape":"Expires", - "documentation":"

The date and time at which the object is no longer cacheable.

", - "location":"header", - "locationName":"Expires" - }, - "GrantFullControl":{ - "shape":"GrantFullControl", - "documentation":"

Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

", - "location":"header", - "locationName":"x-amz-grant-full-control" - }, - "GrantRead":{ - "shape":"GrantRead", - "documentation":"

Allows grantee to read the object data and its metadata.

", - "location":"header", - "locationName":"x-amz-grant-read" - }, - "GrantReadACP":{ - "shape":"GrantReadACP", - "documentation":"

Allows grantee to read the object ACL.

", - "location":"header", - "locationName":"x-amz-grant-read-acp" - }, - "GrantWriteACP":{ - "shape":"GrantWriteACP", - "documentation":"

Allows grantee to write the ACL for the applicable object.

", - "location":"header", - "locationName":"x-amz-grant-write-acp" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

Object key for which the PUT operation was initiated.

", - "location":"uri", - "locationName":"Key" - }, - "Metadata":{ - "shape":"Metadata", - "documentation":"

A map of metadata to store with the object in S3.

", - "location":"headers", - "locationName":"x-amz-meta-" - }, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The type of storage to use for the object. Defaults to 'STANDARD'.

", - "location":"header", - "locationName":"x-amz-storage-class" - }, - "WebsiteRedirectLocation":{ - "shape":"WebsiteRedirectLocation", - "documentation":"

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

", - "location":"header", - "locationName":"x-amz-website-redirect-location" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

Specifies the AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS will fail if not made via SSL or using SigV4. Documentation on configuring any of the officially supported AWS SDKs and CLI can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - }, - "Tagging":{ - "shape":"TaggingHeader", - "documentation":"

The tag-set for the object. The tag-set must be encoded as URL Query parameters

", - "location":"header", - "locationName":"x-amz-tagging" - } - }, - "payload":"Body" - }, - "PutObjectTaggingOutput":{ - "type":"structure", - "members":{ - "VersionId":{ - "shape":"ObjectVersionId", - "location":"header", - "locationName":"x-amz-version-id" - } - } - }, - "PutObjectTaggingRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "Tagging" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "location":"querystring", - "locationName":"versionId" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "location":"header", - "locationName":"Content-MD5" - }, - "Tagging":{ - "shape":"Tagging", - "locationName":"Tagging", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - } - }, - "payload":"Tagging" - }, - "QueueArn":{"type":"string"}, - "QueueConfiguration":{ - "type":"structure", - "required":[ - "QueueArn", - "Events" - ], - "members":{ - "Id":{"shape":"NotificationId"}, - "QueueArn":{ - "shape":"QueueArn", - "documentation":"

Amazon SQS queue ARN to which Amazon S3 will publish a message when it detects events of specified type.

", - "locationName":"Queue" - }, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "Filter":{"shape":"NotificationConfigurationFilter"} - }, - "documentation":"

Container for specifying an configuration when you want Amazon S3 to publish events to an Amazon Simple Queue Service (Amazon SQS) queue.

" - }, - "QueueConfigurationDeprecated":{ - "type":"structure", - "members":{ - "Id":{"shape":"NotificationId"}, - "Event":{ - "shape":"Event", - "deprecated":true - }, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "Queue":{"shape":"QueueArn"} - } - }, - "QueueConfigurationList":{ - "type":"list", - "member":{"shape":"QueueConfiguration"}, - "flattened":true - }, - "Quiet":{"type":"boolean"}, - "QuoteCharacter":{"type":"string"}, - "QuoteEscapeCharacter":{"type":"string"}, - "QuoteFields":{ - "type":"string", - "enum":[ - "ALWAYS", - "ASNEEDED" - ] - }, - "Range":{"type":"string"}, - "RecordDelimiter":{"type":"string"}, - "RecordsEvent":{ - "type":"structure", - "members":{ - "Payload":{ - "shape":"Body", - "documentation":"

The byte array of partial, one or more result records.

", - "eventpayload":true - } - }, - "event":true - }, - "Redirect":{ - "type":"structure", - "members":{ - "HostName":{ - "shape":"HostName", - "documentation":"

The host name to use in the redirect request.

" - }, - "HttpRedirectCode":{ - "shape":"HttpRedirectCode", - "documentation":"

The HTTP redirect code to use on the response. Not required if one of the siblings is present.

" - }, - "Protocol":{ - "shape":"Protocol", - "documentation":"

Protocol to use (http, https) when redirecting requests. The default is the protocol that is used in the original request.

" - }, - "ReplaceKeyPrefixWith":{ - "shape":"ReplaceKeyPrefixWith", - "documentation":"

The object key prefix to use in the redirect request. For example, to redirect requests for all pages with prefix docs/ (objects in the docs/ folder) to documents/, you can set a condition block with KeyPrefixEquals set to docs/ and in the Redirect set ReplaceKeyPrefixWith to /documents. Not required if one of the siblings is present. Can be present only if ReplaceKeyWith is not provided.

" - }, - "ReplaceKeyWith":{ - "shape":"ReplaceKeyWith", - "documentation":"

The specific object key to use in the redirect request. For example, redirect request to error.html. Not required if one of the sibling is present. Can be present only if ReplaceKeyPrefixWith is not provided.

" - } - } - }, - "RedirectAllRequestsTo":{ - "type":"structure", - "required":["HostName"], - "members":{ - "HostName":{ - "shape":"HostName", - "documentation":"

Name of the host where requests will be redirected.

" - }, - "Protocol":{ - "shape":"Protocol", - "documentation":"

Protocol to use (http, https) when redirecting requests. The default is the protocol that is used in the original request.

" - } - } - }, - "ReplaceKeyPrefixWith":{"type":"string"}, - "ReplaceKeyWith":{"type":"string"}, - "ReplicaKmsKeyID":{"type":"string"}, - "ReplicationConfiguration":{ - "type":"structure", - "required":[ - "Role", - "Rules" - ], - "members":{ - "Role":{ - "shape":"Role", - "documentation":"

Amazon Resource Name (ARN) of an IAM role for Amazon S3 to assume when replicating the objects.

" - }, - "Rules":{ - "shape":"ReplicationRules", - "documentation":"

Container for information about a particular replication rule. Replication configuration must have at least one rule and can contain up to 1,000 rules.

", - "locationName":"Rule" - } - }, - "documentation":"

Container for replication rules. You can add as many as 1,000 rules. Total replication configuration size can be up to 2 MB.

" - }, - "ReplicationRule":{ - "type":"structure", - "required":[ - "Prefix", - "Status", - "Destination" - ], - "members":{ - "ID":{ - "shape":"ID", - "documentation":"

Unique identifier for the rule. The value cannot be longer than 255 characters.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Object keyname prefix identifying one or more objects to which the rule applies. Maximum prefix length can be up to 1,024 characters. Overlapping prefixes are not supported.

" - }, - "Status":{ - "shape":"ReplicationRuleStatus", - "documentation":"

The rule is ignored if status is not Enabled.

" - }, - "SourceSelectionCriteria":{ - "shape":"SourceSelectionCriteria", - "documentation":"

Container for filters that define which source objects should be replicated.

" - }, - "Destination":{ - "shape":"Destination", - "documentation":"

Container for replication destination information.

" - } - }, - "documentation":"

Container for information about a particular replication rule.

" - }, - "ReplicationRuleStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "ReplicationRules":{ - "type":"list", - "member":{"shape":"ReplicationRule"}, - "flattened":true - }, - "ReplicationStatus":{ - "type":"string", - "enum":[ - "COMPLETE", - "PENDING", - "FAILED", - "REPLICA" - ] - }, - "RequestCharged":{ - "type":"string", - "documentation":"

If present, indicates that the requester was successfully charged for the request.

", - "enum":["requester"] - }, - "RequestPayer":{ - "type":"string", - "documentation":"

Confirms that the requester knows that she or he will be charged for the request. Bucket owners need not specify this parameter in their requests. Documentation on downloading objects from requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html

", - "enum":["requester"] - }, - "RequestPaymentConfiguration":{ - "type":"structure", - "required":["Payer"], - "members":{ - "Payer":{ - "shape":"Payer", - "documentation":"

Specifies who pays for the download and request fees.

" - } - } - }, - "RequestProgress":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"EnableRequestProgress", - "documentation":"

Specifies whether periodic QueryProgress frames should be sent. Valid values: TRUE, FALSE. Default value: FALSE.

" - } - } - }, - "ResponseCacheControl":{"type":"string"}, - "ResponseContentDisposition":{"type":"string"}, - "ResponseContentEncoding":{"type":"string"}, - "ResponseContentLanguage":{"type":"string"}, - "ResponseContentType":{"type":"string"}, - "ResponseExpires":{"type":"timestamp"}, - "Restore":{"type":"string"}, - "RestoreObjectOutput":{ - "type":"structure", - "members":{ - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - }, - "RestoreOutputPath":{ - "shape":"RestoreOutputPath", - "documentation":"

Indicates the path in the provided S3 output location where Select results will be restored to.

", - "location":"header", - "locationName":"x-amz-restore-output-path" - } - } - }, - "RestoreObjectRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "VersionId":{ - "shape":"ObjectVersionId", - "location":"querystring", - "locationName":"versionId" - }, - "RestoreRequest":{ - "shape":"RestoreRequest", - "locationName":"RestoreRequest", - "xmlNamespace":{"uri":"http://s3.amazonaws.com/doc/2006-03-01/"} - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - }, - "payload":"RestoreRequest" - }, - "RestoreOutputPath":{"type":"string"}, - "RestoreRequest":{ - "type":"structure", - "members":{ - "Days":{ - "shape":"Days", - "documentation":"

Lifetime of the active copy in days. Do not use with restores that specify OutputLocation.

" - }, - "GlacierJobParameters":{ - "shape":"GlacierJobParameters", - "documentation":"

Glacier related parameters pertaining to this job. Do not use with restores that specify OutputLocation.

" - }, - "Type":{ - "shape":"RestoreRequestType", - "documentation":"

Type of restore request.

" - }, - "Tier":{ - "shape":"Tier", - "documentation":"

Glacier retrieval tier at which the restore will be processed.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The optional description for the job.

" - }, - "SelectParameters":{ - "shape":"SelectParameters", - "documentation":"

Describes the parameters for Select job types.

" - }, - "OutputLocation":{ - "shape":"OutputLocation", - "documentation":"

Describes the location where the restore job's output is stored.

" - } - }, - "documentation":"

Container for restore job parameters.

" - }, - "RestoreRequestType":{ - "type":"string", - "enum":["SELECT"] - }, - "Role":{"type":"string"}, - "RoutingRule":{ - "type":"structure", - "required":["Redirect"], - "members":{ - "Condition":{ - "shape":"Condition", - "documentation":"

A container for describing a condition that must be met for the specified redirect to apply. For example, 1. If request is for pages in the /docs folder, redirect to the /documents folder. 2. If request results in HTTP error 4xx, redirect request to another host where you might process the error.

" - }, - "Redirect":{ - "shape":"Redirect", - "documentation":"

Container for redirect information. You can redirect requests to another host, to another page, or with another protocol. In the event of an error, you can can specify a different error code to return.

" - } - } - }, - "RoutingRules":{ - "type":"list", - "member":{ - "shape":"RoutingRule", - "locationName":"RoutingRule" - } - }, - "Rule":{ - "type":"structure", - "required":[ - "Prefix", - "Status" - ], - "members":{ - "Expiration":{"shape":"LifecycleExpiration"}, - "ID":{ - "shape":"ID", - "documentation":"

Unique identifier for the rule. The value cannot be longer than 255 characters.

" - }, - "Prefix":{ - "shape":"Prefix", - "documentation":"

Prefix identifying one or more objects to which the rule applies.

" - }, - "Status":{ - "shape":"ExpirationStatus", - "documentation":"

If 'Enabled', the rule is currently being applied. If 'Disabled', the rule is not currently being applied.

" - }, - "Transition":{"shape":"Transition"}, - "NoncurrentVersionTransition":{"shape":"NoncurrentVersionTransition"}, - "NoncurrentVersionExpiration":{"shape":"NoncurrentVersionExpiration"}, - "AbortIncompleteMultipartUpload":{"shape":"AbortIncompleteMultipartUpload"} - } - }, - "Rules":{ - "type":"list", - "member":{"shape":"Rule"}, - "flattened":true - }, - "S3KeyFilter":{ - "type":"structure", - "members":{ - "FilterRules":{ - "shape":"FilterRuleList", - "locationName":"FilterRule" - } - }, - "documentation":"

Container for object key name prefix and suffix filtering rules.

" - }, - "S3Location":{ - "type":"structure", - "required":[ - "BucketName", - "Prefix" - ], - "members":{ - "BucketName":{ - "shape":"BucketName", - "documentation":"

The name of the bucket where the restore results will be placed.

" - }, - "Prefix":{ - "shape":"LocationPrefix", - "documentation":"

The prefix that is prepended to the restore results for this request.

" - }, - "Encryption":{"shape":"Encryption"}, - "CannedACL":{ - "shape":"ObjectCannedACL", - "documentation":"

The canned ACL to apply to the restore results.

" - }, - "AccessControlList":{ - "shape":"Grants", - "documentation":"

A list of grants that control access to the staged results.

" - }, - "Tagging":{ - "shape":"Tagging", - "documentation":"

The tag-set that is applied to the restore results.

" - }, - "UserMetadata":{ - "shape":"UserMetadata", - "documentation":"

A list of metadata to store with the restore results in S3.

" - }, - "StorageClass":{ - "shape":"StorageClass", - "documentation":"

The class of storage used to store the restore results.

" - } - }, - "documentation":"

Describes an S3 location that will receive the results of the restore request.

" - }, - "SSECustomerAlgorithm":{"type":"string"}, - "SSECustomerKey":{ - "type":"string", - "sensitive":true - }, - "SSECustomerKeyMD5":{"type":"string"}, - "SSEKMS":{ - "type":"structure", - "required":["KeyId"], - "members":{ - "KeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

Specifies the ID of the AWS Key Management Service (KMS) master encryption key to use for encrypting Inventory reports.

" - } - }, - "documentation":"

Specifies the use of SSE-KMS to encrypt delievered Inventory reports.

", - "locationName":"SSE-KMS" - }, - "SSEKMSKeyId":{ - "type":"string", - "sensitive":true - }, - "SSES3":{ - "type":"structure", - "members":{ - }, - "documentation":"

Specifies the use of SSE-S3 to encrypt delievered Inventory reports.

", - "locationName":"SSE-S3" - }, - "SelectObjectContentEventStream":{ - "type":"structure", - "members":{ - "Records":{ - "shape":"RecordsEvent", - "documentation":"

The Records Event.

" - }, - "Stats":{ - "shape":"StatsEvent", - "documentation":"

The Stats Event.

" - }, - "Progress":{ - "shape":"ProgressEvent", - "documentation":"

The Progress Event.

" - }, - "Cont":{ - "shape":"ContinuationEvent", - "documentation":"

The Continuation Event.

" - }, - "End":{ - "shape":"EndEvent", - "documentation":"

The End Event.

" - } - }, - "eventstream":true - }, - "SelectObjectContentOutput":{ - "type":"structure", - "members":{ - "Payload":{"shape":"SelectObjectContentEventStream"} - }, - "payload":"Payload" - }, - "SelectObjectContentRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "Expression", - "ExpressionType", - "InputSerialization", - "OutputSerialization" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "documentation":"

The S3 Bucket.

", - "location":"uri", - "locationName":"Bucket" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

The Object Key.

", - "location":"uri", - "locationName":"Key" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

The SSE Algorithm used to encrypt the object. For more information, go to Server-Side Encryption (Using Customer-Provided Encryption Keys.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

The SSE Customer Key. For more information, go to Server-Side Encryption (Using Customer-Provided Encryption Keys.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

The SSE Customer Key MD5. For more information, go to Server-Side Encryption (Using Customer-Provided Encryption Keys.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "Expression":{ - "shape":"Expression", - "documentation":"

The expression that is used to query the object.

" - }, - "ExpressionType":{ - "shape":"ExpressionType", - "documentation":"

The type of the provided expression (e.g., SQL).

" - }, - "RequestProgress":{ - "shape":"RequestProgress", - "documentation":"

Specifies if periodic request progress information should be enabled.

" - }, - "InputSerialization":{ - "shape":"InputSerialization", - "documentation":"

Describes the format of the data in the object that is being queried.

" - }, - "OutputSerialization":{ - "shape":"OutputSerialization", - "documentation":"

Describes the format of the data that you want Amazon S3 to return in response.

" - } - }, - "documentation":"

Request to filter the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response. For more information, go to S3Select API Documentation.

" - }, - "SelectParameters":{ - "type":"structure", - "required":[ - "InputSerialization", - "ExpressionType", - "Expression", - "OutputSerialization" - ], - "members":{ - "InputSerialization":{ - "shape":"InputSerialization", - "documentation":"

Describes the serialization format of the object.

" - }, - "ExpressionType":{ - "shape":"ExpressionType", - "documentation":"

The type of the provided expression (e.g., SQL).

" - }, - "Expression":{ - "shape":"Expression", - "documentation":"

The expression that is used to query the object.

" - }, - "OutputSerialization":{ - "shape":"OutputSerialization", - "documentation":"

Describes how the results of the Select job are serialized.

" - } - }, - "documentation":"

Describes the parameters for Select job types.

" - }, - "ServerSideEncryption":{ - "type":"string", - "enum":[ - "AES256", - "aws:kms" - ] - }, - "ServerSideEncryptionByDefault":{ - "type":"structure", - "required":["SSEAlgorithm"], - "members":{ - "SSEAlgorithm":{ - "shape":"ServerSideEncryption", - "documentation":"

Server-side encryption algorithm to use for the default encryption.

" - }, - "KMSMasterKeyID":{ - "shape":"SSEKMSKeyId", - "documentation":"

KMS master key ID to use for the default encryption. This parameter is allowed if SSEAlgorithm is aws:kms.

" - } - }, - "documentation":"

Describes the default server-side encryption to apply to new objects in the bucket. If Put Object request does not specify any server-side encryption, this default encryption will be applied.

" - }, - "ServerSideEncryptionConfiguration":{ - "type":"structure", - "required":["Rules"], - "members":{ - "Rules":{ - "shape":"ServerSideEncryptionRules", - "documentation":"

Container for information about a particular server-side encryption configuration rule.

", - "locationName":"Rule" - } - }, - "documentation":"

Container for server-side encryption configuration rules. Currently S3 supports one rule only.

" - }, - "ServerSideEncryptionRule":{ - "type":"structure", - "members":{ - "ApplyServerSideEncryptionByDefault":{ - "shape":"ServerSideEncryptionByDefault", - "documentation":"

Describes the default server-side encryption to apply to new objects in the bucket. If Put Object request does not specify any server-side encryption, this default encryption will be applied.

" - } - }, - "documentation":"

Container for information about a particular server-side encryption configuration rule.

" - }, - "ServerSideEncryptionRules":{ - "type":"list", - "member":{"shape":"ServerSideEncryptionRule"}, - "flattened":true - }, - "Size":{"type":"integer"}, - "SourceSelectionCriteria":{ - "type":"structure", - "members":{ - "SseKmsEncryptedObjects":{ - "shape":"SseKmsEncryptedObjects", - "documentation":"

Container for filter information of selection of KMS Encrypted S3 objects.

" - } - }, - "documentation":"

Container for filters that define which source objects should be replicated.

" - }, - "SseKmsEncryptedObjects":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"SseKmsEncryptedObjectsStatus", - "documentation":"

The replication for KMS encrypted S3 objects is disabled if status is not Enabled.

" - } - }, - "documentation":"

Container for filter information of selection of KMS Encrypted S3 objects.

" - }, - "SseKmsEncryptedObjectsStatus":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "StartAfter":{"type":"string"}, - "Stats":{ - "type":"structure", - "members":{ - "BytesScanned":{ - "shape":"BytesScanned", - "documentation":"

Total number of object bytes scanned.

" - }, - "BytesProcessed":{ - "shape":"BytesProcessed", - "documentation":"

Total number of uncompressed object bytes processed.

" - }, - "BytesReturned":{ - "shape":"BytesReturned", - "documentation":"

Total number of bytes of records payload data returned.

" - } - } - }, - "StatsEvent":{ - "type":"structure", - "members":{ - "Details":{ - "shape":"Stats", - "documentation":"

The Stats event details.

", - "eventpayload":true - } - }, - "event":true - }, - "StorageClass":{ - "type":"string", - "enum":[ - "STANDARD", - "REDUCED_REDUNDANCY", - "STANDARD_IA", - "ONEZONE_IA" - ] - }, - "StorageClassAnalysis":{ - "type":"structure", - "members":{ - "DataExport":{ - "shape":"StorageClassAnalysisDataExport", - "documentation":"

A container used to describe how data related to the storage class analysis should be exported.

" - } - } - }, - "StorageClassAnalysisDataExport":{ - "type":"structure", - "required":[ - "OutputSchemaVersion", - "Destination" - ], - "members":{ - "OutputSchemaVersion":{ - "shape":"StorageClassAnalysisSchemaVersion", - "documentation":"

The version of the output schema to use when exporting data. Must be V_1.

" - }, - "Destination":{ - "shape":"AnalyticsExportDestination", - "documentation":"

The place to store the data for an analysis.

" - } - } - }, - "StorageClassAnalysisSchemaVersion":{ - "type":"string", - "enum":["V_1"] - }, - "Suffix":{"type":"string"}, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"ObjectKey", - "documentation":"

Name of the tag.

" - }, - "Value":{ - "shape":"Value", - "documentation":"

Value of the tag.

" - } - } - }, - "TagCount":{"type":"integer"}, - "TagSet":{ - "type":"list", - "member":{ - "shape":"Tag", - "locationName":"Tag" - } - }, - "Tagging":{ - "type":"structure", - "required":["TagSet"], - "members":{ - "TagSet":{"shape":"TagSet"} - } - }, - "TaggingDirective":{ - "type":"string", - "enum":[ - "COPY", - "REPLACE" - ] - }, - "TaggingHeader":{"type":"string"}, - "TargetBucket":{"type":"string"}, - "TargetGrant":{ - "type":"structure", - "members":{ - "Grantee":{"shape":"Grantee"}, - "Permission":{ - "shape":"BucketLogsPermission", - "documentation":"

Logging permissions assigned to the Grantee for the bucket.

" - } - } - }, - "TargetGrants":{ - "type":"list", - "member":{ - "shape":"TargetGrant", - "locationName":"Grant" - } - }, - "TargetPrefix":{"type":"string"}, - "Tier":{ - "type":"string", - "enum":[ - "Standard", - "Bulk", - "Expedited" - ] - }, - "Token":{"type":"string"}, - "TopicArn":{"type":"string"}, - "TopicConfiguration":{ - "type":"structure", - "required":[ - "TopicArn", - "Events" - ], - "members":{ - "Id":{"shape":"NotificationId"}, - "TopicArn":{ - "shape":"TopicArn", - "documentation":"

Amazon SNS topic ARN to which Amazon S3 will publish a message when it detects events of specified type.

", - "locationName":"Topic" - }, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "Filter":{"shape":"NotificationConfigurationFilter"} - }, - "documentation":"

Container for specifying the configuration when you want Amazon S3 to publish events to an Amazon Simple Notification Service (Amazon SNS) topic.

" - }, - "TopicConfigurationDeprecated":{ - "type":"structure", - "members":{ - "Id":{"shape":"NotificationId"}, - "Events":{ - "shape":"EventList", - "locationName":"Event" - }, - "Event":{ - "shape":"Event", - "documentation":"

Bucket event for which to send notifications.

", - "deprecated":true - }, - "Topic":{ - "shape":"TopicArn", - "documentation":"

Amazon SNS topic to which Amazon S3 will publish a message to report the specified events for the bucket.

" - } - } - }, - "TopicConfigurationList":{ - "type":"list", - "member":{"shape":"TopicConfiguration"}, - "flattened":true - }, - "Transition":{ - "type":"structure", - "members":{ - "Date":{ - "shape":"Date", - "documentation":"

Indicates at what date the object is to be moved or deleted. Should be in GMT ISO 8601 Format.

" - }, - "Days":{ - "shape":"Days", - "documentation":"

Indicates the lifetime, in days, of the objects that are subject to the rule. The value must be a non-zero positive integer.

" - }, - "StorageClass":{ - "shape":"TransitionStorageClass", - "documentation":"

The class of storage used to store the object.

" - } - } - }, - "TransitionList":{ - "type":"list", - "member":{"shape":"Transition"}, - "flattened":true - }, - "TransitionStorageClass":{ - "type":"string", - "enum":[ - "GLACIER", - "STANDARD_IA", - "ONEZONE_IA" - ] - }, - "Type":{ - "type":"string", - "enum":[ - "CanonicalUser", - "AmazonCustomerByEmail", - "Group" - ] - }, - "URI":{"type":"string"}, - "UploadIdMarker":{"type":"string"}, - "UploadPartCopyOutput":{ - "type":"structure", - "members":{ - "CopySourceVersionId":{ - "shape":"CopySourceVersionId", - "documentation":"

The version of the source object that was copied, if you have enabled versioning on the source bucket.

", - "location":"header", - "locationName":"x-amz-copy-source-version-id" - }, - "CopyPartResult":{"shape":"CopyPartResult"}, - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - }, - "payload":"CopyPartResult" - }, - "UploadPartCopyRequest":{ - "type":"structure", - "required":[ - "Bucket", - "CopySource", - "Key", - "PartNumber", - "UploadId" - ], - "members":{ - "Bucket":{ - "shape":"BucketName", - "location":"uri", - "locationName":"Bucket" - }, - "CopySource":{ - "shape":"CopySource", - "documentation":"

The name of the source bucket and key name of the source object, separated by a slash (/). Must be URL-encoded.

", - "location":"header", - "locationName":"x-amz-copy-source" - }, - "CopySourceIfMatch":{ - "shape":"CopySourceIfMatch", - "documentation":"

Copies the object if its entity tag (ETag) matches the specified tag.

", - "location":"header", - "locationName":"x-amz-copy-source-if-match" - }, - "CopySourceIfModifiedSince":{ - "shape":"CopySourceIfModifiedSince", - "documentation":"

Copies the object if it has been modified since the specified time.

", - "location":"header", - "locationName":"x-amz-copy-source-if-modified-since" - }, - "CopySourceIfNoneMatch":{ - "shape":"CopySourceIfNoneMatch", - "documentation":"

Copies the object if its entity tag (ETag) is different than the specified ETag.

", - "location":"header", - "locationName":"x-amz-copy-source-if-none-match" - }, - "CopySourceIfUnmodifiedSince":{ - "shape":"CopySourceIfUnmodifiedSince", - "documentation":"

Copies the object if it hasn't been modified since the specified time.

", - "location":"header", - "locationName":"x-amz-copy-source-if-unmodified-since" - }, - "CopySourceRange":{ - "shape":"CopySourceRange", - "documentation":"

The range of bytes to copy from the source object. The range value must use the form bytes=first-last, where the first and last are the zero-based byte offsets to copy. For example, bytes=0-9 indicates that you want to copy the first ten bytes of the source. You can copy a range only if the source object is greater than 5 GB.

", - "location":"header", - "locationName":"x-amz-copy-source-range" - }, - "Key":{ - "shape":"ObjectKey", - "location":"uri", - "locationName":"Key" - }, - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number of part being copied. This is a positive integer between 1 and 10,000.

", - "location":"querystring", - "locationName":"partNumber" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

Upload ID identifying the multipart upload whose part is being copied.

", - "location":"querystring", - "locationName":"uploadId" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header. This must be the same encryption key specified in the initiate multipart upload request.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "CopySourceSSECustomerAlgorithm":{ - "shape":"CopySourceSSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use when decrypting the source object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-algorithm" - }, - "CopySourceSSECustomerKey":{ - "shape":"CopySourceSSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use to decrypt the source object. The encryption key provided in this header must be one that was used when the source object was created.

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-key" - }, - "CopySourceSSECustomerKeyMD5":{ - "shape":"CopySourceSSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-copy-source-server-side-encryption-customer-key-MD5" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - } - }, - "UploadPartOutput":{ - "type":"structure", - "members":{ - "ServerSideEncryption":{ - "shape":"ServerSideEncryption", - "documentation":"

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

", - "location":"header", - "locationName":"x-amz-server-side-encryption" - }, - "ETag":{ - "shape":"ETag", - "documentation":"

Entity tag for the uploaded object.

", - "location":"header", - "locationName":"ETag" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

If server-side encryption with a customer-provided encryption key was requested, the response will include this header to provide round trip message integrity verification of the customer-provided encryption key.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "SSEKMSKeyId":{ - "shape":"SSEKMSKeyId", - "documentation":"

If present, specifies the ID of the AWS Key Management Service (KMS) master encryption key that was used for the object.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-aws-kms-key-id" - }, - "RequestCharged":{ - "shape":"RequestCharged", - "location":"header", - "locationName":"x-amz-request-charged" - } - } - }, - "UploadPartRequest":{ - "type":"structure", - "required":[ - "Bucket", - "Key", - "PartNumber", - "UploadId" - ], - "members":{ - "Body":{ - "shape":"Body", - "documentation":"

Object data.

", - "streaming":true - }, - "Bucket":{ - "shape":"BucketName", - "documentation":"

Name of the bucket to which the multipart upload was initiated.

", - "location":"uri", - "locationName":"Bucket" - }, - "ContentLength":{ - "shape":"ContentLength", - "documentation":"

Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.

", - "location":"header", - "locationName":"Content-Length" - }, - "ContentMD5":{ - "shape":"ContentMD5", - "documentation":"

The base64-encoded 128-bit MD5 digest of the part data.

", - "location":"header", - "locationName":"Content-MD5" - }, - "Key":{ - "shape":"ObjectKey", - "documentation":"

Object key for which the multipart upload was initiated.

", - "location":"uri", - "locationName":"Key" - }, - "PartNumber":{ - "shape":"PartNumber", - "documentation":"

Part number of part being uploaded. This is a positive integer between 1 and 10,000.

", - "location":"querystring", - "locationName":"partNumber" - }, - "UploadId":{ - "shape":"MultipartUploadId", - "documentation":"

Upload ID identifying the multipart upload whose part is being uploaded.

", - "location":"querystring", - "locationName":"uploadId" - }, - "SSECustomerAlgorithm":{ - "shape":"SSECustomerAlgorithm", - "documentation":"

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-algorithm" - }, - "SSECustomerKey":{ - "shape":"SSECustomerKey", - "documentation":"

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side​-encryption​-customer-algorithm header. This must be the same encryption key specified in the initiate multipart upload request.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key" - }, - "SSECustomerKeyMD5":{ - "shape":"SSECustomerKeyMD5", - "documentation":"

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

", - "location":"header", - "locationName":"x-amz-server-side-encryption-customer-key-MD5" - }, - "RequestPayer":{ - "shape":"RequestPayer", - "location":"header", - "locationName":"x-amz-request-payer" - } - }, - "payload":"Body" - }, - "UserMetadata":{ - "type":"list", - "member":{ - "shape":"MetadataEntry", - "locationName":"MetadataEntry" - } - }, - "Value":{"type":"string"}, - "VersionIdMarker":{"type":"string"}, - "VersioningConfiguration":{ - "type":"structure", - "members":{ - "MFADelete":{ - "shape":"MFADelete", - "documentation":"

Specifies whether MFA delete is enabled in the bucket versioning configuration. This element is only returned if the bucket has been configured with MFA delete. If the bucket has never been so configured, this element is not returned.

", - "locationName":"MfaDelete" - }, - "Status":{ - "shape":"BucketVersioningStatus", - "documentation":"

The versioning state of the bucket.

" - } - } - }, - "WebsiteConfiguration":{ - "type":"structure", - "members":{ - "ErrorDocument":{"shape":"ErrorDocument"}, - "IndexDocument":{"shape":"IndexDocument"}, - "RedirectAllRequestsTo":{"shape":"RedirectAllRequestsTo"}, - "RoutingRules":{"shape":"RoutingRules"} - } - }, - "WebsiteRedirectLocation":{"type":"string"} - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/waiters-2.json deleted file mode 100644 index b508a8f5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/s3/2006-03-01/waiters-2.json +++ /dev/null @@ -1,73 +0,0 @@ -{ - "version": 2, - "waiters": { - "BucketExists": { - "delay": 5, - "operation": "HeadBucket", - "maxAttempts": 20, - "acceptors": [ - { - "expected": 200, - "matcher": "status", - "state": "success" - }, - { - "expected": 301, - "matcher": "status", - "state": "success" - }, - { - "expected": 403, - "matcher": "status", - "state": "success" - }, - { - "expected": 404, - "matcher": "status", - "state": "retry" - } - ] - }, - "BucketNotExists": { - "delay": 5, - "operation": "HeadBucket", - "maxAttempts": 20, - "acceptors": [ - { - "expected": 404, - "matcher": "status", - "state": "success" - } - ] - }, - "ObjectExists": { - "delay": 5, - "operation": "HeadObject", - "maxAttempts": 20, - "acceptors": [ - { - "expected": 200, - "matcher": "status", - "state": "success" - }, - { - "expected": 404, - "matcher": "status", - "state": "retry" - } - ] - }, - "ObjectNotExists": { - "delay": 5, - "operation": "HeadObject", - "maxAttempts": 20, - "acceptors": [ - { - "expected": 404, - "matcher": "status", - "state": "success" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/service-2.json deleted file mode 100644 index c39b4fff..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker-runtime/2017-05-13/service-2.json +++ /dev/null @@ -1,160 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-05-13", - "endpointPrefix":"runtime.sagemaker", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"Amazon SageMaker Runtime", - "serviceId":"SageMaker Runtime", - "signatureVersion":"v4", - "signingName":"sagemaker", - "uid":"runtime.sagemaker-2017-05-13" - }, - "operations":{ - "InvokeEndpoint":{ - "name":"InvokeEndpoint", - "http":{ - "method":"POST", - "requestUri":"/endpoints/{EndpointName}/invocations" - }, - "input":{"shape":"InvokeEndpointInput"}, - "output":{"shape":"InvokeEndpointOutput"}, - "errors":[ - {"shape":"InternalFailure"}, - {"shape":"ServiceUnavailable"}, - {"shape":"ValidationError"}, - {"shape":"ModelError"} - ], - "documentation":"

After you deploy a model into production using Amazon SageMaker hosting services, your client applications use this API to get inferences from the model hosted at the specified endpoint.

For an overview of Amazon SageMaker, see How It Works

Amazon SageMaker strips all POST headers except those supported by the API. Amazon SageMaker might add additional headers. You should not rely on the behavior of headers outside those enumerated in the request syntax.

" - } - }, - "shapes":{ - "BodyBlob":{ - "type":"blob", - "max":5242880, - "sensitive":true - }, - "EndpointName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "Header":{ - "type":"string", - "max":1024 - }, - "InternalFailure":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

Internal failure occurred.

", - "error":{"httpStatusCode":500}, - "exception":true, - "fault":true - }, - "InvokeEndpointInput":{ - "type":"structure", - "required":[ - "EndpointName", - "Body" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint that you specified when you created the endpoint using the CreateEndpoint API.

", - "location":"uri", - "locationName":"EndpointName" - }, - "Body":{ - "shape":"BodyBlob", - "documentation":"

Provides input data, in the format specified in the ContentType request header. Amazon SageMaker passes all of the data in the body to the model.

" - }, - "ContentType":{ - "shape":"Header", - "documentation":"

The MIME type of the input data in the request body.

", - "location":"header", - "locationName":"Content-Type" - }, - "Accept":{ - "shape":"Header", - "documentation":"

The desired MIME type of the inference in the response.

", - "location":"header", - "locationName":"Accept" - } - }, - "payload":"Body" - }, - "InvokeEndpointOutput":{ - "type":"structure", - "required":["Body"], - "members":{ - "Body":{ - "shape":"BodyBlob", - "documentation":"

Includes the inference provided by the model.

" - }, - "ContentType":{ - "shape":"Header", - "documentation":"

The MIME type of the inference returned in the response body.

", - "location":"header", - "locationName":"Content-Type" - }, - "InvokedProductionVariant":{ - "shape":"Header", - "documentation":"

Identifies the production variant that was invoked.

", - "location":"header", - "locationName":"x-Amzn-Invoked-Production-Variant" - } - }, - "payload":"Body" - }, - "LogStreamArn":{"type":"string"}, - "Message":{ - "type":"string", - "max":2048 - }, - "ModelError":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"}, - "OriginalStatusCode":{ - "shape":"StatusCode", - "documentation":"

Original status code.

" - }, - "OriginalMessage":{ - "shape":"Message", - "documentation":"

Original message.

" - }, - "LogStreamArn":{ - "shape":"LogStreamArn", - "documentation":"

Amazon Resource Name (ARN) of the log stream.

" - } - }, - "documentation":"

Model (owned by the customer in the container) returned an error 500.

", - "error":{"httpStatusCode":424}, - "exception":true - }, - "ServiceUnavailable":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

Service is unavailable. Try your call again.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "StatusCode":{"type":"integer"}, - "ValidationError":{ - "type":"structure", - "members":{ - "Message":{"shape":"Message"} - }, - "documentation":"

Inspect your request and try again.

", - "error":{"httpStatusCode":400}, - "exception":true - } - }, - "documentation":"

Amazon SageMaker runtime API.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/paginators-1.json deleted file mode 100644 index f6d33286..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "ListTrainingJobs": { - "result_key": "TrainingJobSummaries", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListEndpoints": { - "result_key": "Endpoints", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListEndpointConfigs": { - "result_key": "EndpointConfigs", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListNotebookInstances": { - "result_key": "NotebookInstances", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListTags": { - "result_key": "Tags", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListModels": { - "result_key": "Models", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/service-2.json deleted file mode 100644 index 7a0c8674..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/service-2.json +++ /dev/null @@ -1,4072 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-07-24", - "endpointPrefix":"sagemaker", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"SageMaker", - "serviceFullName":"Amazon SageMaker Service", - "serviceId":"SageMaker", - "signatureVersion":"v4", - "signingName":"sagemaker", - "targetPrefix":"SageMaker", - "uid":"sagemaker-2017-07-24" - }, - "operations":{ - "AddTags":{ - "name":"AddTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsInput"}, - "output":{"shape":"AddTagsOutput"}, - "documentation":"

Adds or overwrites one or more tags for the specified Amazon SageMaker resource. You can add tags to notebook instances, training jobs, models, endpoint configurations, and endpoints.

Each tag consists of a key and an optional value. Tag keys must be unique per resource. For more information about tags, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "CreateEndpoint":{ - "name":"CreateEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEndpointInput"}, - "output":{"shape":"CreateEndpointOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Creates an endpoint using the endpoint configuration specified in the request. Amazon SageMaker uses the endpoint to provision resources and deploy models. You create the endpoint configuration with the CreateEndpointConfig API.

Use this API only for hosting models using Amazon SageMaker hosting services.

The endpoint name must be unique within an AWS Region in your AWS account.

When it receives the request, Amazon SageMaker creates the endpoint, launches the resources (ML compute instances), and deploys the model(s) on them.

When Amazon SageMaker receives the request, it sets the endpoint status to Creating. After it creates the endpoint, it sets the status to InService. Amazon SageMaker can then process incoming requests for inferences. To check the status of an endpoint, use the DescribeEndpoint API.

For an example, see Exercise 1: Using the K-Means Algorithm Provided by Amazon SageMaker.

If any of the models hosted at this endpoint get model data from an Amazon S3 location, Amazon SageMaker uses AWS Security Token Service to download model artifacts from the S3 path you provided. AWS STS is activated in your IAM user account by default. If you previously deactivated AWS STS for a region, you need to reactivate AWS STS for that region. For more information, see Activating and Deactivating AWS STS i an AWS Region in the AWS Identity and Access Management User Guide.

" - }, - "CreateEndpointConfig":{ - "name":"CreateEndpointConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateEndpointConfigInput"}, - "output":{"shape":"CreateEndpointConfigOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Creates an endpoint configuration that Amazon SageMaker hosting services uses to deploy models. In the configuration, you identify one or more models, created using the CreateModel API, to deploy and the resources that you want Amazon SageMaker to provision. Then you call the CreateEndpoint API.

Use this API only if you want to use Amazon SageMaker hosting services to deploy models into production.

In the request, you define one or more ProductionVariants, each of which identifies a model. Each ProductionVariant parameter also describes the resources that you want Amazon SageMaker to provision. This includes the number and type of ML compute instances to deploy.

If you are hosting multiple models, you also assign a VariantWeight to specify how much traffic you want to allocate to each model. For example, suppose that you want to host two models, A and B, and you assign traffic weight 2 for model A and 1 for model B. Amazon SageMaker distributes two-thirds of the traffic to Model A, and one-third to model B.

" - }, - "CreateHyperParameterTuningJob":{ - "name":"CreateHyperParameterTuningJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateHyperParameterTuningJobRequest"}, - "output":{"shape":"CreateHyperParameterTuningJobResponse"}, - "errors":[ - {"shape":"ResourceInUse"}, - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Starts a hyperparameter tuning job.

" - }, - "CreateModel":{ - "name":"CreateModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateModelInput"}, - "output":{"shape":"CreateModelOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Creates a model in Amazon SageMaker. In the request, you name the model and describe one or more containers. For each container, you specify the docker image containing inference code, artifacts (from prior training), and custom environment map that the inference code uses when you deploy the model into production.

Use this API to create a model only if you want to use Amazon SageMaker hosting services. To host your model, you create an endpoint configuration with the CreateEndpointConfig API, and then create an endpoint with the CreateEndpoint API.

Amazon SageMaker then deploys all of the containers that you defined for the model in the hosting environment.

In the CreateModel request, you must define a container with the PrimaryContainer parameter.

In the request, you also provide an IAM role that Amazon SageMaker can assume to access model artifacts and docker image for deployment on ML compute hosting instances. In addition, you also use the IAM role to manage permissions the inference code needs. For example, if the inference code access any other AWS resources, you grant necessary permissions via this role.

" - }, - "CreateNotebookInstance":{ - "name":"CreateNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNotebookInstanceInput"}, - "output":{"shape":"CreateNotebookInstanceOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Creates an Amazon SageMaker notebook instance. A notebook instance is a machine learning (ML) compute instance running on a Jupyter notebook.

In a CreateNotebookInstance request, specify the type of ML compute instance that you want to run. Amazon SageMaker launches the instance, installs common libraries that you can use to explore datasets for model training, and attaches an ML storage volume to the notebook instance.

Amazon SageMaker also provides a set of example notebooks. Each notebook demonstrates how to use Amazon SageMaker with a specific algorithm or with a machine learning framework.

After receiving the request, Amazon SageMaker does the following:

  1. Creates a network interface in the Amazon SageMaker VPC.

  2. (Option) If you specified SubnetId, Amazon SageMaker creates a network interface in your own VPC, which is inferred from the subnet ID that you provide in the input. When creating this network interface, Amazon SageMaker attaches the security group that you specified in the request to the network interface that it creates in your VPC.

  3. Launches an EC2 instance of the type specified in the request in the Amazon SageMaker VPC. If you specified SubnetId of your VPC, Amazon SageMaker specifies both network interfaces when launching this instance. This enables inbound traffic from your own VPC to the notebook instance, assuming that the security groups allow it.

After creating the notebook instance, Amazon SageMaker returns its Amazon Resource Name (ARN).

After Amazon SageMaker creates the notebook instance, you can connect to the Jupyter server and work in Jupyter notebooks. For example, you can write code to explore a dataset that you can use for model training, train a model, host models by creating Amazon SageMaker endpoints, and validate hosted models.

For more information, see How It Works.

" - }, - "CreateNotebookInstanceLifecycleConfig":{ - "name":"CreateNotebookInstanceLifecycleConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNotebookInstanceLifecycleConfigInput"}, - "output":{"shape":"CreateNotebookInstanceLifecycleConfigOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Creates a lifecycle configuration that you can associate with a notebook instance. A lifecycle configuration is a collection of shell scripts that run when you create or start a notebook instance.

Each lifecycle configuration script has a limit of 16384 characters.

The value of the $PATH environment variable that is available to both scripts is /sbin:bin:/usr/sbin:/usr/bin.

View CloudWatch Logs for notebook instance lifecycle configurations in log group /aws/sagemaker/NotebookInstances in log stream [notebook-instance-name]/[LifecycleConfigHook].

Lifecycle configuration scripts cannot run for longer than 5 minutes. If a script runs for longer than 5 minutes, it fails and the notebook instance is not created or started.

For information about notebook instance lifestyle configurations, see notebook-lifecycle-config.

" - }, - "CreatePresignedNotebookInstanceUrl":{ - "name":"CreatePresignedNotebookInstanceUrl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePresignedNotebookInstanceUrlInput"}, - "output":{"shape":"CreatePresignedNotebookInstanceUrlOutput"}, - "documentation":"

Returns a URL that you can use to connect to the Jupyter server from a notebook instance. In the Amazon SageMaker console, when you choose Open next to a notebook instance, Amazon SageMaker opens a new tab showing the Jupyter server home page from the notebook instance. The console uses this API to get the URL and show the page.

" - }, - "CreateTrainingJob":{ - "name":"CreateTrainingJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTrainingJobRequest"}, - "output":{"shape":"CreateTrainingJobResponse"}, - "errors":[ - {"shape":"ResourceInUse"}, - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Starts a model training job. After training completes, Amazon SageMaker saves the resulting model artifacts to an Amazon S3 location that you specify.

If you choose to host your model using Amazon SageMaker hosting services, you can use the resulting model artifacts as part of the model. You can also use the artifacts in a deep learning service other than Amazon SageMaker, provided that you know how to use them for inferences.

In the request body, you provide the following:

  • AlgorithmSpecification - Identifies the training algorithm to use.

  • HyperParameters - Specify these algorithm-specific parameters to influence the quality of the final model. For a list of hyperparameters for each training algorithm provided by Amazon SageMaker, see Algorithms.

  • InputDataConfig - Describes the training dataset and the Amazon S3 location where it is stored.

  • OutputDataConfig - Identifies the Amazon S3 location where you want Amazon SageMaker to save the results of model training.

  • ResourceConfig - Identifies the resources, ML compute instances, and ML storage volumes to deploy for model training. In distributed training, you specify more than one instance.

  • RoleARN - The Amazon Resource Number (ARN) that Amazon SageMaker assumes to perform tasks on your behalf during model training. You must grant this role the necessary permissions so that Amazon SageMaker can successfully complete model training.

  • StoppingCondition - Sets a duration for training. Use this parameter to cap model training costs.

For more information about Amazon SageMaker, see How It Works.

" - }, - "CreateTransformJob":{ - "name":"CreateTransformJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTransformJobRequest"}, - "output":{"shape":"CreateTransformJobResponse"}, - "errors":[ - {"shape":"ResourceInUse"}, - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Starts a transform job. A transform job uses a trained model to get inferences on a dataset and saves these results to an Amazon S3 location that you specify.

To perform batch transformations, you create a transform job and use the data that you have readily available.

In the request body, you provide the following:

  • TransformJobName - Identifies the transform job. The name must be unique within an AWS Region in an AWS account.

  • ModelName - Identifies the model to use. ModelName must be the name of an existing Amazon SageMaker model within an AWS Region in an AWS account.

  • TransformInput - Describes the dataset to be transformed and the Amazon S3 location where it is stored.

  • TransformOutput - Identifies the Amazon S3 location where you want Amazon SageMaker to save the results from the transform job.

  • TransformResources - Identifies the ML compute instances for the transform job.

For more information about how batch transformation works Amazon SageMaker, see How It Works.

" - }, - "DeleteEndpoint":{ - "name":"DeleteEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEndpointInput"}, - "documentation":"

Deletes an endpoint. Amazon SageMaker frees up all of the resources that were deployed when the endpoint was created.

Amazon SageMaker retires any custom KMS key grants associated with the endpoint, meaning you don't need to use the RevokeGrant API call.

" - }, - "DeleteEndpointConfig":{ - "name":"DeleteEndpointConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEndpointConfigInput"}, - "documentation":"

Deletes an endpoint configuration. The DeleteEndpointConfig API deletes only the specified configuration. It does not delete endpoints created using the configuration.

" - }, - "DeleteModel":{ - "name":"DeleteModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteModelInput"}, - "documentation":"

Deletes a model. The DeleteModel API deletes only the model entry that was created in Amazon SageMaker when you called the CreateModel API. It does not delete model artifacts, inference code, or the IAM role that you specified when creating the model.

" - }, - "DeleteNotebookInstance":{ - "name":"DeleteNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNotebookInstanceInput"}, - "documentation":"

Deletes an Amazon SageMaker notebook instance. Before you can delete a notebook instance, you must call the StopNotebookInstance API.

When you delete a notebook instance, you lose all of your data. Amazon SageMaker removes the ML compute instance, and deletes the ML storage volume and the network interface associated with the notebook instance.

" - }, - "DeleteNotebookInstanceLifecycleConfig":{ - "name":"DeleteNotebookInstanceLifecycleConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNotebookInstanceLifecycleConfigInput"}, - "documentation":"

Deletes a notebook instance lifecycle configuration.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsInput"}, - "output":{"shape":"DeleteTagsOutput"}, - "documentation":"

Deletes the specified tags from an Amazon SageMaker resource.

To list a resource's tags, use the ListTags API.

" - }, - "DescribeEndpoint":{ - "name":"DescribeEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEndpointInput"}, - "output":{"shape":"DescribeEndpointOutput"}, - "documentation":"

Returns the description of an endpoint.

" - }, - "DescribeEndpointConfig":{ - "name":"DescribeEndpointConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEndpointConfigInput"}, - "output":{"shape":"DescribeEndpointConfigOutput"}, - "documentation":"

Returns the description of an endpoint configuration created using the CreateEndpointConfig API.

" - }, - "DescribeHyperParameterTuningJob":{ - "name":"DescribeHyperParameterTuningJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeHyperParameterTuningJobRequest"}, - "output":{"shape":"DescribeHyperParameterTuningJobResponse"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Gets a description of a hyperparameter tuning job.

" - }, - "DescribeModel":{ - "name":"DescribeModel", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeModelInput"}, - "output":{"shape":"DescribeModelOutput"}, - "documentation":"

Describes a model that you created using the CreateModel API.

" - }, - "DescribeNotebookInstance":{ - "name":"DescribeNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNotebookInstanceInput"}, - "output":{"shape":"DescribeNotebookInstanceOutput"}, - "documentation":"

Returns information about a notebook instance.

" - }, - "DescribeNotebookInstanceLifecycleConfig":{ - "name":"DescribeNotebookInstanceLifecycleConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNotebookInstanceLifecycleConfigInput"}, - "output":{"shape":"DescribeNotebookInstanceLifecycleConfigOutput"}, - "documentation":"

Returns a description of a notebook instance lifecycle configuration.

For information about notebook instance lifestyle configurations, see notebook-lifecycle-config.

" - }, - "DescribeTrainingJob":{ - "name":"DescribeTrainingJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrainingJobRequest"}, - "output":{"shape":"DescribeTrainingJobResponse"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Returns information about a training job.

" - }, - "DescribeTransformJob":{ - "name":"DescribeTransformJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTransformJobRequest"}, - "output":{"shape":"DescribeTransformJobResponse"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Returns information about a transform job.

" - }, - "ListEndpointConfigs":{ - "name":"ListEndpointConfigs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEndpointConfigsInput"}, - "output":{"shape":"ListEndpointConfigsOutput"}, - "documentation":"

Lists endpoint configurations.

" - }, - "ListEndpoints":{ - "name":"ListEndpoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEndpointsInput"}, - "output":{"shape":"ListEndpointsOutput"}, - "documentation":"

Lists endpoints.

" - }, - "ListHyperParameterTuningJobs":{ - "name":"ListHyperParameterTuningJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListHyperParameterTuningJobsRequest"}, - "output":{"shape":"ListHyperParameterTuningJobsResponse"}, - "documentation":"

Gets a list of HyperParameterTuningJobSummary objects that describe the hyperparameter tuning jobs launched in your account.

" - }, - "ListModels":{ - "name":"ListModels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListModelsInput"}, - "output":{"shape":"ListModelsOutput"}, - "documentation":"

Lists models created with the CreateModel API.

" - }, - "ListNotebookInstanceLifecycleConfigs":{ - "name":"ListNotebookInstanceLifecycleConfigs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListNotebookInstanceLifecycleConfigsInput"}, - "output":{"shape":"ListNotebookInstanceLifecycleConfigsOutput"}, - "documentation":"

Lists notebook instance lifestyle configurations created with the CreateNotebookInstanceLifecycleConfig API.

" - }, - "ListNotebookInstances":{ - "name":"ListNotebookInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListNotebookInstancesInput"}, - "output":{"shape":"ListNotebookInstancesOutput"}, - "documentation":"

Returns a list of the Amazon SageMaker notebook instances in the requester's account in an AWS Region.

" - }, - "ListTags":{ - "name":"ListTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsInput"}, - "output":{"shape":"ListTagsOutput"}, - "documentation":"

Returns the tags for the specified Amazon SageMaker resource.

" - }, - "ListTrainingJobs":{ - "name":"ListTrainingJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTrainingJobsRequest"}, - "output":{"shape":"ListTrainingJobsResponse"}, - "documentation":"

Lists training jobs.

" - }, - "ListTrainingJobsForHyperParameterTuningJob":{ - "name":"ListTrainingJobsForHyperParameterTuningJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTrainingJobsForHyperParameterTuningJobRequest"}, - "output":{"shape":"ListTrainingJobsForHyperParameterTuningJobResponse"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Gets a list of TrainingJobSummary objects that describe the training jobs that a hyperparameter tuning job launched.

" - }, - "ListTransformJobs":{ - "name":"ListTransformJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTransformJobsRequest"}, - "output":{"shape":"ListTransformJobsResponse"}, - "documentation":"

Lists transform jobs.

" - }, - "StartNotebookInstance":{ - "name":"StartNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartNotebookInstanceInput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Launches an ML compute instance with the latest version of the libraries and attaches your ML storage volume. After configuring the notebook instance, Amazon SageMaker sets the notebook instance status to InService. A notebook instance's status must be InService before you can connect to your Jupyter notebook.

" - }, - "StopHyperParameterTuningJob":{ - "name":"StopHyperParameterTuningJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopHyperParameterTuningJobRequest"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Stops a running hyperparameter tuning job and all running training jobs that the tuning job launched.

All model artifacts output from the training jobs are stored in Amazon Simple Storage Service (Amazon S3). All data that the training jobs write to Amazon CloudWatch Logs are still available in CloudWatch. After the tuning job moves to the Stopped state, it releases all reserved resources for the tuning job.

" - }, - "StopNotebookInstance":{ - "name":"StopNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopNotebookInstanceInput"}, - "documentation":"

Terminates the ML compute instance. Before terminating the instance, Amazon SageMaker disconnects the ML storage volume from it. Amazon SageMaker preserves the ML storage volume.

To access data on the ML storage volume for a notebook instance that has been terminated, call the StartNotebookInstance API. StartNotebookInstance launches another ML compute instance, configures it, and attaches the preserved ML storage volume so you can continue your work.

" - }, - "StopTrainingJob":{ - "name":"StopTrainingJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopTrainingJobRequest"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Stops a training job. To stop a job, Amazon SageMaker sends the algorithm the SIGTERM signal, which delays job termination for 120 seconds. Algorithms might use this 120-second window to save the model artifacts, so the results of the training is not lost.

Training algorithms provided by Amazon SageMaker save the intermediate results of a model training job. This intermediate data is a valid model artifact. You can use the model artifacts that are saved when Amazon SageMaker stops a training job to create a model.

When it receives a StopTrainingJob request, Amazon SageMaker changes the status of the job to Stopping. After Amazon SageMaker stops the job, it sets the status to Stopped.

" - }, - "StopTransformJob":{ - "name":"StopTransformJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopTransformJobRequest"}, - "errors":[ - {"shape":"ResourceNotFound"} - ], - "documentation":"

Stops a transform job.

When Amazon SageMaker receives a StopTransformJob request, the status of the job changes to Stopping. After Amazon SageMaker stops the job, the status is set to Stopped. When you stop a transform job before it is completed, Amazon SageMaker doesn't store the job's output in Amazon S3.

" - }, - "UpdateEndpoint":{ - "name":"UpdateEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEndpointInput"}, - "output":{"shape":"UpdateEndpointOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Deploys the new EndpointConfig specified in the request, switches to using newly created endpoint, and then deletes resources provisioned for the endpoint using the previous EndpointConfig (there is no availability loss).

When Amazon SageMaker receives the request, it sets the endpoint status to Updating. After updating the endpoint, it sets the status to InService. To check the status of an endpoint, use the DescribeEndpoint API.

You cannot update an endpoint with the current EndpointConfig. To update an endpoint, you must create a new EndpointConfig.

" - }, - "UpdateEndpointWeightsAndCapacities":{ - "name":"UpdateEndpointWeightsAndCapacities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEndpointWeightsAndCapacitiesInput"}, - "output":{"shape":"UpdateEndpointWeightsAndCapacitiesOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Updates variant weight of one or more variants associated with an existing endpoint, or capacity of one variant associated with an existing endpoint. When it receives the request, Amazon SageMaker sets the endpoint status to Updating. After updating the endpoint, it sets the status to InService. To check the status of an endpoint, use the DescribeEndpoint API.

" - }, - "UpdateNotebookInstance":{ - "name":"UpdateNotebookInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNotebookInstanceInput"}, - "output":{"shape":"UpdateNotebookInstanceOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Updates a notebook instance. NotebookInstance updates include upgrading or downgrading the ML compute instance used for your notebook instance to accommodate changes in your workload requirements. You can also update the VPC security groups.

" - }, - "UpdateNotebookInstanceLifecycleConfig":{ - "name":"UpdateNotebookInstanceLifecycleConfig", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNotebookInstanceLifecycleConfigInput"}, - "output":{"shape":"UpdateNotebookInstanceLifecycleConfigOutput"}, - "errors":[ - {"shape":"ResourceLimitExceeded"} - ], - "documentation":"

Updates a notebook instance lifecycle configuration created with the CreateNotebookInstanceLifecycleConfig API.

" - } - }, - "shapes":{ - "Accept":{ - "type":"string", - "max":256 - }, - "AddTagsInput":{ - "type":"structure", - "required":[ - "ResourceArn", - "Tags" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resource that you want to tag.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of Tag objects. Each tag is a key-value pair. Only the key parameter is required. If you don't specify a value, Amazon SageMaker sets the value to an empty string.

" - } - } - }, - "AddTagsOutput":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags associated with the Amazon SageMaker resource.

" - } - } - }, - "AlgorithmImage":{ - "type":"string", - "max":255 - }, - "AlgorithmSpecification":{ - "type":"structure", - "required":[ - "TrainingImage", - "TrainingInputMode" - ], - "members":{ - "TrainingImage":{ - "shape":"AlgorithmImage", - "documentation":"

The registry path of the Docker image that contains the training algorithm. For information about docker registry paths for built-in algorithms, see sagemaker-algo-docker-registry-paths.

" - }, - "TrainingInputMode":{ - "shape":"TrainingInputMode", - "documentation":"

The input mode that the algorithm supports. For the input modes that Amazon SageMaker algorithms support, see Algorithms. If an algorithm supports the File input mode, Amazon SageMaker downloads the training data from S3 to the provisioned ML storage Volume, and mounts the directory to docker volume for training container. If an algorithm supports the Pipe input mode, Amazon SageMaker streams data directly from S3 to the container.

In File mode, make sure you provision ML storage volume with sufficient capacity to accommodate the data download from S3. In addition to the training data, the ML storage volume also stores the output model. The algorithm container use ML storage volume to also store intermediate information, if any.

For distributed algorithms using File mode, training data is distributed uniformly, and your training duration is predictable if the input data objects size is approximately same. Amazon SageMaker does not split the files any further for model training. If the object sizes are skewed, training won't be optimal as the data distribution is also skewed where one host in a training cluster is overloaded, thus becoming bottleneck in training.

" - } - }, - "documentation":"

Specifies the training algorithm to use in a CreateTrainingJob request.

For more information about algorithms provided by Amazon SageMaker, see Algorithms. For information about using your own algorithms, see your-algorithms.

" - }, - "AssemblyType":{ - "type":"string", - "enum":[ - "None", - "Line" - ] - }, - "BatchStrategy":{ - "type":"string", - "enum":[ - "MultiRecord", - "SingleRecord" - ] - }, - "CategoricalParameterRange":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"ParameterKey", - "documentation":"

The name of the categorical hyperparameter to tune.

" - }, - "Values":{ - "shape":"ParameterValues", - "documentation":"

A list of the categories for the hyperparameter.

" - } - }, - "documentation":"

A list of categorical hyperparameters to tune.

" - }, - "CategoricalParameterRanges":{ - "type":"list", - "member":{"shape":"CategoricalParameterRange"}, - "max":20, - "min":0 - }, - "Channel":{ - "type":"structure", - "required":[ - "ChannelName", - "DataSource" - ], - "members":{ - "ChannelName":{ - "shape":"ChannelName", - "documentation":"

The name of the channel.

" - }, - "DataSource":{ - "shape":"DataSource", - "documentation":"

The location of the channel data.

" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The MIME type of the data.

" - }, - "CompressionType":{ - "shape":"CompressionType", - "documentation":"

If training data is compressed, the compression type. The default value is None. CompressionType is used only in Pipe input mode. In File mode, leave this field unset or set it to None.

" - }, - "RecordWrapperType":{ - "shape":"RecordWrapper", - "documentation":"

Specify RecordIO as the value when input data is in raw format but the training algorithm requires the RecordIO format, in which case, Amazon SageMaker wraps each individual S3 object in a RecordIO record. If the input data is already in RecordIO format, you don't need to set this attribute. For more information, see Create a Dataset Using RecordIO.

In FILE mode, leave this field unset or set it to None.

" - } - }, - "documentation":"

A channel is a named input source that training algorithms can consume.

" - }, - "ChannelName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[A-Za-z0-9\\.\\-_]+" - }, - "CompressionType":{ - "type":"string", - "enum":[ - "None", - "Gzip" - ] - }, - "ContainerDefinition":{ - "type":"structure", - "required":["Image"], - "members":{ - "ContainerHostname":{ - "shape":"ContainerHostname", - "documentation":"

The DNS host name for the container after Amazon SageMaker deploys it.

" - }, - "Image":{ - "shape":"Image", - "documentation":"

The Amazon EC2 Container Registry (Amazon ECR) path where inference code is stored. If you are using your own custom algorithm instead of an algorithm provided by Amazon SageMaker, the inference code must meet Amazon SageMaker requirements. Amazon SageMaker supports both registry/repository[:tag] and registry/repository[@digest] image path formats. For more information, see Using Your Own Algorithms with Amazon SageMaker

" - }, - "ModelDataUrl":{ - "shape":"Url", - "documentation":"

The S3 path where the model artifacts, which result from model training, are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).

If you provide a value for this parameter, Amazon SageMaker uses AWS Security Token Service to download model artifacts from the S3 path you provide. AWS STS is activated in your IAM user account by default. If you previously deactivated AWS STS for a region, you need to reactivate AWS STS for that region. For more information, see Activating and Deactivating AWS STS i an AWS Region in the AWS Identity and Access Management User Guide.

" - }, - "Environment":{ - "shape":"EnvironmentMap", - "documentation":"

The environment variables to set in the Docker container. Each key and value in the Environment string to string map can have length of up to 1024. We support up to 16 entries in the map.

" - } - }, - "documentation":"

Describes the container, as part of model definition.

" - }, - "ContainerHostname":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "ContentType":{ - "type":"string", - "max":256 - }, - "ContinuousParameterRange":{ - "type":"structure", - "required":[ - "Name", - "MinValue", - "MaxValue" - ], - "members":{ - "Name":{ - "shape":"ParameterKey", - "documentation":"

The name of the continuous hyperparameter to tune.

" - }, - "MinValue":{ - "shape":"ParameterValue", - "documentation":"

The minimum value for the hyperparameter. The tuning job uses floating-point values between this value and MaxValuefor tuning.

" - }, - "MaxValue":{ - "shape":"ParameterValue", - "documentation":"

The maximum value for the hyperparameter. The tuning job uses floating-point values between MinValue value and this value for tuning.

" - } - }, - "documentation":"

A list of continuous hyperparameters to tune.

" - }, - "ContinuousParameterRanges":{ - "type":"list", - "member":{"shape":"ContinuousParameterRange"}, - "max":20, - "min":0 - }, - "CreateEndpointConfigInput":{ - "type":"structure", - "required":[ - "EndpointConfigName", - "ProductionVariants" - ], - "members":{ - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the endpoint configuration. You specify this name in a CreateEndpoint request.

" - }, - "ProductionVariants":{ - "shape":"ProductionVariantList", - "documentation":"

An array of ProductionVariant objects, one for each model that you want to host at this endpoint.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The Amazon Resource Name (ARN) of a AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint.

" - } - } - }, - "CreateEndpointConfigOutput":{ - "type":"structure", - "required":["EndpointConfigArn"], - "members":{ - "EndpointConfigArn":{ - "shape":"EndpointConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint configuration.

" - } - } - }, - "CreateEndpointInput":{ - "type":"structure", - "required":[ - "EndpointName", - "EndpointConfigName" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint. The name must be unique within an AWS Region in your AWS account.

" - }, - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of an endpoint configuration. For more information, see CreateEndpointConfig.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. For more information, see Using Cost Allocation Tagsin the AWS Billing and Cost Management User Guide.

" - } - } - }, - "CreateEndpointOutput":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"EndpointArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint.

" - } - } - }, - "CreateHyperParameterTuningJobRequest":{ - "type":"structure", - "required":[ - "HyperParameterTuningJobName", - "HyperParameterTuningJobConfig", - "TrainingJobDefinition" - ], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job. This name is the prefix for the names of all training jobs that this tuning job launches. The name must be unique within the same AWS account and AWS Region. Names are not case sensitive, and must be between 1-32 characters.

" - }, - "HyperParameterTuningJobConfig":{ - "shape":"HyperParameterTuningJobConfig", - "documentation":"

The HyperParameterTuningJobConfig object that describes the tuning job, including the search strategy, metric used to evaluate training jobs, ranges of parameters to search, and resource limits for the tuning job.

" - }, - "TrainingJobDefinition":{ - "shape":"HyperParameterTrainingJobDefinition", - "documentation":"

The HyperParameterTrainingJobDefinition object that describes the training jobs that this tuning job launches, including static hyperparameters, input data configuration, output data configuration, resource configuration, and stopping condition.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - } - } - }, - "CreateHyperParameterTuningJobResponse":{ - "type":"structure", - "required":["HyperParameterTuningJobArn"], - "members":{ - "HyperParameterTuningJobArn":{ - "shape":"HyperParameterTuningJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the tuning job.

" - } - } - }, - "CreateModelInput":{ - "type":"structure", - "required":[ - "ModelName", - "PrimaryContainer", - "ExecutionRoleArn" - ], - "members":{ - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the new model.

" - }, - "PrimaryContainer":{ - "shape":"ContainerDefinition", - "documentation":"

The location of the primary docker image containing inference code, associated artifacts, and custom environment map that the inference code uses when the model is deployed into production.

" - }, - "ExecutionRoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Amazon SageMaker can assume to access model artifacts and docker image for deployment on ML compute instances. Deploying on ML compute instances is part of model hosting. For more information, see Amazon SageMaker Roles.

To be able to pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

A VpcConfig object that specifies the VPC that you want your model to connect to. Control access to and from your model container by configuring the VPC. For more information, see host-vpc.

" - } - } - }, - "CreateModelOutput":{ - "type":"structure", - "required":["ModelArn"], - "members":{ - "ModelArn":{ - "shape":"ModelArn", - "documentation":"

The ARN of the model created in Amazon SageMaker.

" - } - } - }, - "CreateNotebookInstanceInput":{ - "type":"structure", - "required":[ - "NotebookInstanceName", - "InstanceType", - "RoleArn" - ], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the new notebook instance.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The type of ML compute instance to launch for the notebook instance.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The ID of the subnet in a VPC to which you would like to have a connectivity from your ML compute instance.

" - }, - "SecurityGroupIds":{ - "shape":"SecurityGroupIds", - "documentation":"

The VPC security group IDs, in the form sg-xxxxxxxx. The security groups must be for the same VPC as specified in the subnet.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

When you send any requests to AWS resources from the notebook instance, Amazon SageMaker assumes this role to perform tasks on your behalf. You must grant this role necessary permissions so Amazon SageMaker can perform these tasks. The policy must allow the Amazon SageMaker service principal (sagemaker.amazonaws.com) permissions to assume this role. For more information, see Amazon SageMaker Roles.

To be able to pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

If you provide a AWS KMS key ID, Amazon SageMaker uses it to encrypt data at rest on the ML storage volume that is attached to your notebook instance.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

A list of tags to associate with the notebook instance. You can add tags later by using the CreateTags API.

" - }, - "LifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of a lifecycle configuration to associate with the notebook instance. For information about lifestyle configurations, see notebook-lifecycle-config.

" - }, - "DirectInternetAccess":{ - "shape":"DirectInternetAccess", - "documentation":"

Sets whether Amazon SageMaker provides internet access to the notebook instance. If you set this to Disabled this notebook instance will be able to access resources only in your VPC, and will not be able to connect to Amazon SageMaker training and endpoint services unless your configure a NAT Gateway in your VPC.

For more information, see appendix-notebook-and-internet-access. You can set the value of this parameter to Disabled only if you set a value for the SubnetId parameter.

" - } - } - }, - "CreateNotebookInstanceLifecycleConfigInput":{ - "type":"structure", - "required":["NotebookInstanceLifecycleConfigName"], - "members":{ - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration.

" - }, - "OnCreate":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

A shell script that runs only once, when you create a notebook instance.

" - }, - "OnStart":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

A shell script that runs every time you start a notebook instance, including when you create the notebook instance.

" - } - } - }, - "CreateNotebookInstanceLifecycleConfigOutput":{ - "type":"structure", - "members":{ - "NotebookInstanceLifecycleConfigArn":{ - "shape":"NotebookInstanceLifecycleConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the lifecycle configuration.

" - } - } - }, - "CreateNotebookInstanceOutput":{ - "type":"structure", - "members":{ - "NotebookInstanceArn":{ - "shape":"NotebookInstanceArn", - "documentation":"

The Amazon Resource Name (ARN) of the notebook instance.

" - } - } - }, - "CreatePresignedNotebookInstanceUrlInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance.

" - }, - "SessionExpirationDurationInSeconds":{ - "shape":"SessionExpirationDurationInSeconds", - "documentation":"

The duration of the session, in seconds. The default is 12 hours.

" - } - } - }, - "CreatePresignedNotebookInstanceUrlOutput":{ - "type":"structure", - "members":{ - "AuthorizedUrl":{ - "shape":"NotebookInstanceUrl", - "documentation":"

A JSON object that contains the URL string.

" - } - } - }, - "CreateTrainingJobRequest":{ - "type":"structure", - "required":[ - "TrainingJobName", - "AlgorithmSpecification", - "RoleArn", - "InputDataConfig", - "OutputDataConfig", - "ResourceConfig", - "StoppingCondition" - ], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

The name of the training job. The name must be unique within an AWS Region in an AWS account.

" - }, - "HyperParameters":{ - "shape":"HyperParameters", - "documentation":"

Algorithm-specific parameters that influence the quality of the model. You set hyperparameters before you start the learning process. For a list of hyperparameters for each training algorithm provided by Amazon SageMaker, see Algorithms.

You can specify a maximum of 100 hyperparameters. Each hyperparameter is a key-value pair. Each key and value is limited to 256 characters, as specified by the Length Constraint.

" - }, - "AlgorithmSpecification":{ - "shape":"AlgorithmSpecification", - "documentation":"

The registry path of the Docker image that contains the training algorithm and algorithm-specific metadata, including the input mode. For more information about algorithms provided by Amazon SageMaker, see Algorithms. For information about providing your own algorithms, see your-algorithms.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.

During model training, Amazon SageMaker needs your permission to read input data from an S3 bucket, download a Docker image that contains training code, write model artifacts to an S3 bucket, write logs to Amazon CloudWatch Logs, and publish metrics to Amazon CloudWatch. You grant permissions for all of these tasks to an IAM role. For more information, see Amazon SageMaker Roles.

To be able to pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

An array of Channel objects. Each channel is a named input source. InputDataConfig describes the input data and its location.

Algorithms can accept input data from one or more channels. For example, an algorithm might have two channels of input data, training_data and validation_data. The configuration for each channel provides the S3 location where the input data is stored. It also provides information about the stored data: the MIME type, compression method, and whether the data is wrapped in RecordIO format.

Depending on the input mode that the algorithm supports, Amazon SageMaker either copies input data files from an S3 bucket to a local directory in the Docker container, or makes it available as input streams.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies the path to the S3 bucket where you want to store model artifacts. Amazon SageMaker creates subfolders for the artifacts.

" - }, - "ResourceConfig":{ - "shape":"ResourceConfig", - "documentation":"

The resources, including the ML compute instances and ML storage volumes, to use for model training.

ML storage volumes store model artifacts and incremental states. Training algorithms might also use ML storage volumes for scratch space. If you want Amazon SageMaker to use the ML storage volume to store the training data, choose File as the TrainingInputMode in the algorithm specification. For distributed training algorithms, specify an instance count greater than 1.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

A VpcConfig object that specifies the VPC that you want your training job to connect to. Control access to and from your training container by configuring the VPC. For more information, see train-vpc

" - }, - "StoppingCondition":{ - "shape":"StoppingCondition", - "documentation":"

Sets a duration for training. Use this parameter to cap model training costs. To stop a job, Amazon SageMaker sends the algorithm the SIGTERM signal, which delays job termination for 120 seconds. Algorithms might use this 120-second window to save the model artifacts.

When Amazon SageMaker terminates a job because the stopping condition has been met, training algorithms provided by Amazon SageMaker save the intermediate results of the job. This intermediate data is a valid model artifact. You can use it to create a model using the CreateModel API.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - } - } - }, - "CreateTrainingJobResponse":{ - "type":"structure", - "required":["TrainingJobArn"], - "members":{ - "TrainingJobArn":{ - "shape":"TrainingJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the training job.

" - } - } - }, - "CreateTransformJobRequest":{ - "type":"structure", - "required":[ - "TransformJobName", - "ModelName", - "TransformInput", - "TransformOutput", - "TransformResources" - ], - "members":{ - "TransformJobName":{ - "shape":"TransformJobName", - "documentation":"

The name of the transform job. The name must be unique within an AWS Region in an AWS account.

" - }, - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model that you want to use for the transform job. ModelName must be the name of an existing Amazon SageMaker model within an AWS Region in an AWS account.

" - }, - "MaxConcurrentTransforms":{ - "shape":"MaxConcurrentTransforms", - "documentation":"

The maximum number of parallel requests that can be sent to each instance in a transform job. This is good for algorithms that implement multiple workers on larger instances . The default value is 1. To allow Amazon SageMaker to determine the appropriate number for MaxConcurrentTransforms, set the value to 0.

" - }, - "MaxPayloadInMB":{ - "shape":"MaxPayloadInMB", - "documentation":"

The maximum payload size allowed, in MB. A payload is the data portion of a record (without metadata). The value in MaxPayloadInMB must be greater or equal to the size of a single record. You can approximate the size of a record by dividing the size of your dataset by the number of records. Then multiply this value by the number of records you want in a mini-batch. It is recommended to enter a value slightly larger than this to ensure the records fit within the maximum payload size. The default value is 6 MB. For an unlimited payload size, set the value to 0.

" - }, - "BatchStrategy":{ - "shape":"BatchStrategy", - "documentation":"

Determines the number of records included in a single mini-batch. SingleRecord means only one record is used per mini-batch. MultiRecord means a mini-batch is set to contain as many records that can fit within the MaxPayloadInMB limit.

Batch transform will automatically split your input data into whatever payload size is specified if you set SplitType to Line and BatchStrategy to MultiRecord. There's no need to split the dataset into smaller files or to use larger payload sizes unless the records in your dataset are very large.

" - }, - "Environment":{ - "shape":"TransformEnvironmentMap", - "documentation":"

The environment variables to set in the Docker container. We support up to 16 key and values entries in the map.

" - }, - "TransformInput":{ - "shape":"TransformInput", - "documentation":"

Describes the input source and the way the transform job consumes it.

" - }, - "TransformOutput":{ - "shape":"TransformOutput", - "documentation":"

Describes the results of the transform job.

" - }, - "TransformResources":{ - "shape":"TransformResources", - "documentation":"

Describes the resources, including ML instance types and ML instance count, to use for the transform job.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

An array of key-value pairs. Adding tags is optional. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" - } - } - }, - "CreateTransformJobResponse":{ - "type":"structure", - "required":["TransformJobArn"], - "members":{ - "TransformJobArn":{ - "shape":"TransformJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the transform job.

" - } - } - }, - "CreationTime":{"type":"timestamp"}, - "DataSource":{ - "type":"structure", - "required":["S3DataSource"], - "members":{ - "S3DataSource":{ - "shape":"S3DataSource", - "documentation":"

The S3 location of the data source that is associated with a channel.

" - } - }, - "documentation":"

Describes the location of the channel data.

" - }, - "DeleteEndpointConfigInput":{ - "type":"structure", - "required":["EndpointConfigName"], - "members":{ - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the endpoint configuration that you want to delete.

" - } - } - }, - "DeleteEndpointInput":{ - "type":"structure", - "required":["EndpointName"], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint that you want to delete.

" - } - } - }, - "DeleteModelInput":{ - "type":"structure", - "required":["ModelName"], - "members":{ - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model to delete.

" - } - } - }, - "DeleteNotebookInstanceInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the Amazon SageMaker notebook instance to delete.

" - } - } - }, - "DeleteNotebookInstanceLifecycleConfigInput":{ - "type":"structure", - "required":["NotebookInstanceLifecycleConfigName"], - "members":{ - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration to delete.

" - } - } - }, - "DeleteTagsInput":{ - "type":"structure", - "required":[ - "ResourceArn", - "TagKeys" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resource whose tags you want to delete.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

An array or one or more tag keys to delete.

" - } - } - }, - "DeleteTagsOutput":{ - "type":"structure", - "members":{ - } - }, - "DeployedImage":{ - "type":"structure", - "members":{ - "SpecifiedImage":{ - "shape":"Image", - "documentation":"

The image path you specified when you created the model.

" - }, - "ResolvedImage":{ - "shape":"Image", - "documentation":"

The specific digest path of the image hosted in this ProductionVariant.

" - }, - "ResolutionTime":{ - "shape":"Timestamp", - "documentation":"

The date and time when the image path for the model resolved to the ResolvedImage

" - } - }, - "documentation":"

Gets the Amazon EC2 Container Registry path of the docker image of the model that is hosted in this ProductionVariant.

If you used the registry/repository[:tag] form to to specify the image path of the primary container when you created the model hosted in this ProductionVariant, the path resolves to a path of the form registry/repository[@digest]. A digest is a hash value that identifies a specific version of an image. For information about Amazon ECR paths, see Pulling an Image in the Amazon ECR User Guide.

" - }, - "DeployedImages":{ - "type":"list", - "member":{"shape":"DeployedImage"} - }, - "DescribeEndpointConfigInput":{ - "type":"structure", - "required":["EndpointConfigName"], - "members":{ - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the endpoint configuration.

" - } - } - }, - "DescribeEndpointConfigOutput":{ - "type":"structure", - "required":[ - "EndpointConfigName", - "EndpointConfigArn", - "ProductionVariants", - "CreationTime" - ], - "members":{ - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

Name of the Amazon SageMaker endpoint configuration.

" - }, - "EndpointConfigArn":{ - "shape":"EndpointConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint configuration.

" - }, - "ProductionVariants":{ - "shape":"ProductionVariantList", - "documentation":"

An array of ProductionVariant objects, one for each model that you want to host at this endpoint.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

AWS KMS key ID Amazon SageMaker uses to encrypt data when storing it on the ML storage volume attached to the instance.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint configuration was created.

" - } - } - }, - "DescribeEndpointInput":{ - "type":"structure", - "required":["EndpointName"], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint.

" - } - } - }, - "DescribeEndpointOutput":{ - "type":"structure", - "required":[ - "EndpointName", - "EndpointArn", - "EndpointConfigName", - "EndpointStatus", - "CreationTime", - "LastModifiedTime" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

Name of the endpoint.

" - }, - "EndpointArn":{ - "shape":"EndpointArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint.

" - }, - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the endpoint configuration associated with this endpoint.

" - }, - "ProductionVariants":{ - "shape":"ProductionVariantSummaryList", - "documentation":"

An array of ProductionVariantSummary objects, one for each model hosted behind this endpoint.

" - }, - "EndpointStatus":{ - "shape":"EndpointStatus", - "documentation":"

The status of the endpoint.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the status of the endpoint is Failed, the reason why it failed.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint was created.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint was last modified.

" - } - } - }, - "DescribeHyperParameterTuningJobRequest":{ - "type":"structure", - "required":["HyperParameterTuningJobName"], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job to describe.

" - } - } - }, - "DescribeHyperParameterTuningJobResponse":{ - "type":"structure", - "required":[ - "HyperParameterTuningJobName", - "HyperParameterTuningJobArn", - "HyperParameterTuningJobConfig", - "TrainingJobDefinition", - "HyperParameterTuningJobStatus", - "CreationTime", - "TrainingJobStatusCounters", - "ObjectiveStatusCounters" - ], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job.

" - }, - "HyperParameterTuningJobArn":{ - "shape":"HyperParameterTuningJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the tuning job.

" - }, - "HyperParameterTuningJobConfig":{ - "shape":"HyperParameterTuningJobConfig", - "documentation":"

The HyperParameterTuningJobConfig object that specifies the configuration of the tuning job.

" - }, - "TrainingJobDefinition":{ - "shape":"HyperParameterTrainingJobDefinition", - "documentation":"

The HyperParameterTrainingJobDefinition object that specifies the definition of the training jobs that this tuning job launches.

" - }, - "HyperParameterTuningJobStatus":{ - "shape":"HyperParameterTuningJobStatus", - "documentation":"

The status of the tuning job: InProgress, Completed, Failed, Stopping, or Stopped.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the tuning job started.

" - }, - "HyperParameterTuningEndTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the tuning job ended.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the status of the tuning job was modified.

" - }, - "TrainingJobStatusCounters":{ - "shape":"TrainingJobStatusCounters", - "documentation":"

The TrainingJobStatusCounters object that specifies the number of training jobs, categorized by status, that this tuning job launched.

" - }, - "ObjectiveStatusCounters":{ - "shape":"ObjectiveStatusCounters", - "documentation":"

The ObjectiveStatusCounters object that specifies the number of training jobs, categorized by the status of their final objective metric, that this tuning job launched.

" - }, - "BestTrainingJob":{ - "shape":"HyperParameterTrainingJobSummary", - "documentation":"

A TrainingJobSummary object that describes the training job that completed with the best current HyperParameterTuningJobObjective.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the tuning job failed, the reason it failed.

" - } - } - }, - "DescribeModelInput":{ - "type":"structure", - "required":["ModelName"], - "members":{ - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model.

" - } - } - }, - "DescribeModelOutput":{ - "type":"structure", - "required":[ - "ModelName", - "PrimaryContainer", - "ExecutionRoleArn", - "CreationTime", - "ModelArn" - ], - "members":{ - "ModelName":{ - "shape":"ModelName", - "documentation":"

Name of the Amazon SageMaker model.

" - }, - "PrimaryContainer":{ - "shape":"ContainerDefinition", - "documentation":"

The location of the primary inference code, associated artifacts, and custom environment map that the inference code uses when it is deployed in production.

" - }, - "ExecutionRoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that you specified for the model.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

A VpcConfig object that specifies the VPC that this model has access to. For more information, see host-vpc

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the model was created.

" - }, - "ModelArn":{ - "shape":"ModelArn", - "documentation":"

The Amazon Resource Name (ARN) of the model.

" - } - } - }, - "DescribeNotebookInstanceInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance that you want information about.

" - } - } - }, - "DescribeNotebookInstanceLifecycleConfigInput":{ - "type":"structure", - "required":["NotebookInstanceLifecycleConfigName"], - "members":{ - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration to describe.

" - } - } - }, - "DescribeNotebookInstanceLifecycleConfigOutput":{ - "type":"structure", - "members":{ - "NotebookInstanceLifecycleConfigArn":{ - "shape":"NotebookInstanceLifecycleConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the lifecycle configuration.

" - }, - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration.

" - }, - "OnCreate":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

The shell script that runs only once, when you create a notebook instance.

" - }, - "OnStart":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

The shell script that runs every time you start a notebook instance, including when you create the notebook instance.

" - }, - "LastModifiedTime":{ - "shape":"LastModifiedTime", - "documentation":"

A timestamp that tells when the lifecycle configuration was last modified.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

A timestamp that tells when the lifecycle configuration was created.

" - } - } - }, - "DescribeNotebookInstanceOutput":{ - "type":"structure", - "members":{ - "NotebookInstanceArn":{ - "shape":"NotebookInstanceArn", - "documentation":"

The Amazon Resource Name (ARN) of the notebook instance.

" - }, - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

Name of the Amazon SageMaker notebook instance.

" - }, - "NotebookInstanceStatus":{ - "shape":"NotebookInstanceStatus", - "documentation":"

The status of the notebook instance.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If status is failed, the reason it failed.

" - }, - "Url":{ - "shape":"NotebookInstanceUrl", - "documentation":"

The URL that you use to connect to the Jupyter notebook that is running in your notebook instance.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The type of ML compute instance running on the notebook instance.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The ID of the VPC subnet.

" - }, - "SecurityGroups":{ - "shape":"SecurityGroupIds", - "documentation":"

The IDs of the VPC security groups.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

Amazon Resource Name (ARN) of the IAM role associated with the instance.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

AWS KMS key ID Amazon SageMaker uses to encrypt data when storing it on the ML storage volume attached to the instance.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

Network interface IDs that Amazon SageMaker created at the time of creating the instance.

" - }, - "LastModifiedTime":{ - "shape":"LastModifiedTime", - "documentation":"

A timestamp. Use this parameter to retrieve the time when the notebook instance was last modified.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

A timestamp. Use this parameter to return the time when the notebook instance was created

" - }, - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

Returns the name of a notebook instance lifecycle configuration.

For information about notebook instance lifestyle configurations, see notebook-lifecycle-config.

" - }, - "DirectInternetAccess":{ - "shape":"DirectInternetAccess", - "documentation":"

Describes whether Amazon SageMaker provides internet access to the notebook instance. If this value is set to Disabled, he notebook instance does not have internet access, and cannot connect to Amazon SageMaker training and endpoint services.

For more information, see appendix-notebook-and-internet-access.

" - } - } - }, - "DescribeTrainingJobRequest":{ - "type":"structure", - "required":["TrainingJobName"], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

The name of the training job.

" - } - } - }, - "DescribeTrainingJobResponse":{ - "type":"structure", - "required":[ - "TrainingJobName", - "TrainingJobArn", - "ModelArtifacts", - "TrainingJobStatus", - "SecondaryStatus", - "AlgorithmSpecification", - "InputDataConfig", - "ResourceConfig", - "StoppingCondition", - "CreationTime" - ], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

Name of the model training job.

" - }, - "TrainingJobArn":{ - "shape":"TrainingJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the training job.

" - }, - "TuningJobArn":{ - "shape":"HyperParameterTuningJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.

" - }, - "ModelArtifacts":{ - "shape":"ModelArtifacts", - "documentation":"

Information about the Amazon S3 location that is configured for storing model artifacts.

" - }, - "TrainingJobStatus":{ - "shape":"TrainingJobStatus", - "documentation":"

The status of the training job.

For the InProgress status, Amazon SageMaker can return these secondary statuses:

  • Starting - Preparing for training.

  • Downloading - Optional stage for algorithms that support File training input mode. It indicates data is being downloaded to ML storage volumes.

  • Training - Training is in progress.

  • Uploading - Training is complete and model upload is in progress.

For the Stopped training status, Amazon SageMaker can return these secondary statuses:

  • MaxRuntimeExceeded - Job stopped as a result of maximum allowed runtime exceeded.

" - }, - "SecondaryStatus":{ - "shape":"SecondaryStatus", - "documentation":"

Provides granular information about the system state. For more information, see TrainingJobStatus.

  • Starting - starting the training job.

  • LaunchingMLInstances - launching ML instances for the training job.

  • PreparingTrainingStack - preparing the ML instances for the training job.

  • Downloading - downloading the input data.

  • DownloadingTrainingImage - downloading the training algorithm image.

  • Training - model training is in progress.

  • Uploading - uploading the trained model.

  • Stopping - stopping the training job.

  • Stopped - the training job has stopped.

  • MaxRuntimeExceeded - the training job exceeded the specified max run time and has been stopped.

  • Completed - the training job has completed.

  • Failed - the training job has failed. The failure reason is provided in the StatusMessage.

The valid values for SecondaryStatus are subject to change. They primarily provide information on the progress of the training job.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the training job failed, the reason it failed.

" - }, - "HyperParameters":{ - "shape":"HyperParameters", - "documentation":"

Algorithm-specific parameters.

" - }, - "AlgorithmSpecification":{ - "shape":"AlgorithmSpecification", - "documentation":"

Information about the algorithm used for training, and algorithm metadata.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The AWS Identity and Access Management (IAM) role configured for the training job.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

An array of Channel objects that describes each data input channel.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

The S3 path where model artifacts that you configured when creating the job are stored. Amazon SageMaker creates subfolders for model artifacts.

" - }, - "ResourceConfig":{ - "shape":"ResourceConfig", - "documentation":"

Resources, including ML compute instances and ML storage volumes, that are configured for model training.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

A VpcConfig object that specifies the VPC that this training job has access to. For more information, see train-vpc.

" - }, - "StoppingCondition":{ - "shape":"StoppingCondition", - "documentation":"

The condition under which to stop the training job.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that indicates when the training job was created.

" - }, - "TrainingStartTime":{ - "shape":"Timestamp", - "documentation":"

Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of TrainingEndTime. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.

" - }, - "TrainingEndTime":{ - "shape":"Timestamp", - "documentation":"

Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when Amazon SageMaker detects a job failure.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that indicates when the status of the training job was last modified.

" - }, - "SecondaryStatusTransitions":{ - "shape":"SecondaryStatusTransitions", - "documentation":"

To give an overview of the training job lifecycle, SecondaryStatusTransitions is a log of time-ordered secondary statuses that a training job has transitioned.

" - } - } - }, - "DescribeTransformJobRequest":{ - "type":"structure", - "required":["TransformJobName"], - "members":{ - "TransformJobName":{ - "shape":"TransformJobName", - "documentation":"

The name of the transform job that you want to view details of.

" - } - } - }, - "DescribeTransformJobResponse":{ - "type":"structure", - "required":[ - "TransformJobName", - "TransformJobArn", - "TransformJobStatus", - "ModelName", - "TransformInput", - "TransformResources", - "CreationTime" - ], - "members":{ - "TransformJobName":{ - "shape":"TransformJobName", - "documentation":"

The name of the transform job.

" - }, - "TransformJobArn":{ - "shape":"TransformJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the transform job.

" - }, - "TransformJobStatus":{ - "shape":"TransformJobStatus", - "documentation":"

The status of the transform job. If the transform job failed, the reason is returned in the FailureReason field.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the transform job failed, the reason that it failed.

" - }, - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model used in the transform job.

" - }, - "MaxConcurrentTransforms":{ - "shape":"MaxConcurrentTransforms", - "documentation":"

The maximum number of parallel requests on each instance node that can be launched in a transform job. The default value is 1.

" - }, - "MaxPayloadInMB":{ - "shape":"MaxPayloadInMB", - "documentation":"

The maximum payload size , in MB used in the transform job.

" - }, - "BatchStrategy":{ - "shape":"BatchStrategy", - "documentation":"

SingleRecord means only one record was used per a batch. MultiRecord means batches contained as many records that could possibly fit within the MaxPayloadInMB limit.

" - }, - "Environment":{ - "shape":"TransformEnvironmentMap", - "documentation":"

" - }, - "TransformInput":{ - "shape":"TransformInput", - "documentation":"

Describes the dataset to be transformed and the Amazon S3 location where it is stored.

" - }, - "TransformOutput":{ - "shape":"TransformOutput", - "documentation":"

Identifies the Amazon S3 location where you want Amazon SageMaker to save the results from the transform job.

" - }, - "TransformResources":{ - "shape":"TransformResources", - "documentation":"

Describes the resources, including ML instance types and ML instance count, to use for the transform job.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the transform Job was created.

" - }, - "TransformStartTime":{ - "shape":"Timestamp", - "documentation":"

Indicates when the transform job starts on ML instances. You are billed for the time interval between this time and the value of TransformEndTime.

" - }, - "TransformEndTime":{ - "shape":"Timestamp", - "documentation":"

Indicates when the transform job is Completed, Stopped, or Failed. You are billed for the time interval between this time and the value of TransformStartTime.

" - } - } - }, - "DesiredWeightAndCapacity":{ - "type":"structure", - "required":["VariantName"], - "members":{ - "VariantName":{ - "shape":"VariantName", - "documentation":"

The name of the variant to update.

" - }, - "DesiredWeight":{ - "shape":"VariantWeight", - "documentation":"

The variant's weight.

" - }, - "DesiredInstanceCount":{ - "shape":"TaskCount", - "documentation":"

The variant's capacity.

" - } - }, - "documentation":"

Specifies weight and capacity values for a production variant.

" - }, - "DesiredWeightAndCapacityList":{ - "type":"list", - "member":{"shape":"DesiredWeightAndCapacity"}, - "min":1 - }, - "DirectInternetAccess":{ - "type":"string", - "enum":[ - "Enabled", - "Disabled" - ] - }, - "EndpointArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "EndpointConfigArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "EndpointConfigName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "EndpointConfigNameContains":{ - "type":"string", - "pattern":"[a-zA-Z0-9-]+" - }, - "EndpointConfigSortKey":{ - "type":"string", - "enum":[ - "Name", - "CreationTime" - ] - }, - "EndpointConfigSummary":{ - "type":"structure", - "required":[ - "EndpointConfigName", - "EndpointConfigArn", - "CreationTime" - ], - "members":{ - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the endpoint configuration.

" - }, - "EndpointConfigArn":{ - "shape":"EndpointConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint configuration.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint configuration was created.

" - } - }, - "documentation":"

Provides summary information for an endpoint configuration.

" - }, - "EndpointConfigSummaryList":{ - "type":"list", - "member":{"shape":"EndpointConfigSummary"} - }, - "EndpointName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "EndpointNameContains":{ - "type":"string", - "pattern":"[a-zA-Z0-9-]+" - }, - "EndpointSortKey":{ - "type":"string", - "enum":[ - "Name", - "CreationTime", - "Status" - ] - }, - "EndpointStatus":{ - "type":"string", - "enum":[ - "OutOfService", - "Creating", - "Updating", - "RollingBack", - "InService", - "Deleting", - "Failed" - ] - }, - "EndpointSummary":{ - "type":"structure", - "required":[ - "EndpointName", - "EndpointArn", - "CreationTime", - "LastModifiedTime", - "EndpointStatus" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint.

" - }, - "EndpointArn":{ - "shape":"EndpointArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint was created.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the endpoint was last modified.

" - }, - "EndpointStatus":{ - "shape":"EndpointStatus", - "documentation":"

The status of the endpoint.

" - } - }, - "documentation":"

Provides summary information for an endpoint.

" - }, - "EndpointSummaryList":{ - "type":"list", - "member":{"shape":"EndpointSummary"} - }, - "EnvironmentKey":{ - "type":"string", - "max":1024, - "pattern":"[a-zA-Z_][a-zA-Z0-9_]*" - }, - "EnvironmentMap":{ - "type":"map", - "key":{"shape":"EnvironmentKey"}, - "value":{"shape":"EnvironmentValue"}, - "max":16 - }, - "EnvironmentValue":{ - "type":"string", - "max":1024 - }, - "FailureReason":{ - "type":"string", - "max":1024 - }, - "FinalHyperParameterTuningJobObjectiveMetric":{ - "type":"structure", - "required":[ - "MetricName", - "Value" - ], - "members":{ - "Type":{ - "shape":"HyperParameterTuningJobObjectiveType", - "documentation":"

Whether to minimize or maximize the objective metric. Valid values are Minimize and Maximize.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the objective metric.

" - }, - "Value":{ - "shape":"MetricValue", - "documentation":"

The value of the objective metric.

" - } - }, - "documentation":"

Shows the final value for the objective metric for a training job that was launched by a hyperparameter tuning job. You define the objective metric in the HyperParameterTuningJobObjective parameter of HyperParameterTuningJobConfig.

" - }, - "HyperParameterAlgorithmSpecification":{ - "type":"structure", - "required":[ - "TrainingImage", - "TrainingInputMode" - ], - "members":{ - "TrainingImage":{ - "shape":"AlgorithmImage", - "documentation":"

The registry path of the Docker image that contains the training algorithm. For information about Docker registry paths for built-in algorithms, see sagemaker-algo-docker-registry-paths.

" - }, - "TrainingInputMode":{ - "shape":"TrainingInputMode", - "documentation":"

The input mode that the algorithm supports: File or Pipe. In File input mode, Amazon SageMaker downloads the training data from Amazon S3 to the storage volume that is attached to the training instance and mounts the directory to the Docker volume for the training container. In Pipe input mode, Amazon SageMaker streams data directly from Amazon S3 to the container.

If you specify File mode, make sure that you provision the storage volume that is attached to the training instance with enough capacity to accommodate the training data downloaded from Amazon S3, the model artifacts, and intermediate information.

For more information about input modes, see Algorithms.

" - }, - "MetricDefinitions":{ - "shape":"MetricDefinitionList", - "documentation":"

An array of MetricDefinition objects that specify the metrics that the algorithm emits.

" - } - }, - "documentation":"

Specifies which training algorithm to use for training jobs that a hyperparameter tuning job launches and the metrics to monitor.

" - }, - "HyperParameterTrainingJobDefinition":{ - "type":"structure", - "required":[ - "AlgorithmSpecification", - "RoleArn", - "InputDataConfig", - "OutputDataConfig", - "ResourceConfig", - "StoppingCondition" - ], - "members":{ - "StaticHyperParameters":{ - "shape":"HyperParameters", - "documentation":"

Specifies the values of hyperparameters that do not change for the tuning job.

" - }, - "AlgorithmSpecification":{ - "shape":"HyperParameterAlgorithmSpecification", - "documentation":"

The HyperParameterAlgorithmSpecification object that specifies the algorithm to use for the training jobs that the tuning job launches.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role associated with the training jobs that the tuning job launches.

" - }, - "InputDataConfig":{ - "shape":"InputDataConfig", - "documentation":"

An array of Channel objects that specify the input for the training jobs that the tuning job launches.

" - }, - "VpcConfig":{ - "shape":"VpcConfig", - "documentation":"

The VpcConfig object that specifies the VPC that you want the training jobs that this hyperparameter tuning job launches to connect to. Control access to and from your training container by configuring the VPC. For more information, see train-vpc.

" - }, - "OutputDataConfig":{ - "shape":"OutputDataConfig", - "documentation":"

Specifies the path to the Amazon S3 bucket where you store model artifacts from the training jobs that the tuning job launches.

" - }, - "ResourceConfig":{ - "shape":"ResourceConfig", - "documentation":"

The resources, including the compute instances and storage volumes, to use for the training jobs that the tuning job launches.

Storage volumes store model artifacts and incremental states. Training algorithms might also use storage volumes for scratch space. If you want Amazon SageMaker to use the storage volume to store the training data, choose File as the TrainingInputMode in the algorithm specification. For distributed training algorithms, specify an instance count greater than 1.

" - }, - "StoppingCondition":{ - "shape":"StoppingCondition", - "documentation":"

Sets a maximum duration for the training jobs that the tuning job launches. Use this parameter to limit model training costs.

To stop a job, Amazon SageMaker sends the algorithm the SIGTERM signal. This delays job termination for 120 seconds. Algorithms might use this 120-second window to save the model artifacts.

When Amazon SageMaker terminates a job because the stopping condition has been met, training algorithms provided by Amazon SageMaker save the intermediate results of the job.

" - } - }, - "documentation":"

Defines the training jobs launched by a hyperparameter tuning job.

" - }, - "HyperParameterTrainingJobSummaries":{ - "type":"list", - "member":{"shape":"HyperParameterTrainingJobSummary"} - }, - "HyperParameterTrainingJobSummary":{ - "type":"structure", - "required":[ - "TrainingJobName", - "TrainingJobArn", - "CreationTime", - "TrainingJobStatus", - "TunedHyperParameters" - ], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

The name of the training job.

" - }, - "TrainingJobArn":{ - "shape":"TrainingJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the training job.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the training job was created.

" - }, - "TrainingStartTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the training job started.

" - }, - "TrainingEndTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the training job ended.

" - }, - "TrainingJobStatus":{ - "shape":"TrainingJobStatus", - "documentation":"

The status of the training job.

" - }, - "TunedHyperParameters":{ - "shape":"HyperParameters", - "documentation":"

A list of the hyperparameters for which you specified ranges to search.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

The reason that the training job failed.

" - }, - "FinalHyperParameterTuningJobObjectiveMetric":{ - "shape":"FinalHyperParameterTuningJobObjectiveMetric", - "documentation":"

The FinalHyperParameterTuningJobObjectiveMetric object that specifies the value of the objective metric of the tuning job that launched this training job.

" - }, - "ObjectiveStatus":{ - "shape":"ObjectiveStatus", - "documentation":"

The status of the objective metric for the training job:

  • Succeeded: The final objective metric for the training job was evaluated by the hyperparameter tuning job and used in the hyperparameter tuning process.

  • Pending: The training job is in progress and evaluation of its final objective metric is pending.

  • Failed: The final objective metric for the training job was not evaluated, and was not used in the hyperparameter tuning process. This typically occurs when the training job failed or did not emit an objective metric.

" - } - }, - "documentation":"

Specifies summary information about a training job.

" - }, - "HyperParameterTuningJobArn":{ - "type":"string", - "max":256, - "pattern":"arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:hyper-parameter-tuning-job/.*" - }, - "HyperParameterTuningJobConfig":{ - "type":"structure", - "required":[ - "Strategy", - "HyperParameterTuningJobObjective", - "ResourceLimits", - "ParameterRanges" - ], - "members":{ - "Strategy":{ - "shape":"HyperParameterTuningJobStrategyType", - "documentation":"

Specifies the search strategy for hyperparameters. Currently, the only valid value is Bayesian.

" - }, - "HyperParameterTuningJobObjective":{ - "shape":"HyperParameterTuningJobObjective", - "documentation":"

The HyperParameterTuningJobObjective object that specifies the objective metric for this tuning job.

" - }, - "ResourceLimits":{ - "shape":"ResourceLimits", - "documentation":"

The ResourceLimits object that specifies the maximum number of training jobs and parallel training jobs for this tuning job.

" - }, - "ParameterRanges":{ - "shape":"ParameterRanges", - "documentation":"

The ParameterRanges object that specifies the ranges of hyperparameters that this tuning job searches.

" - } - }, - "documentation":"

Configures a hyperparameter tuning job.

" - }, - "HyperParameterTuningJobName":{ - "type":"string", - "max":32, - "min":1, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "HyperParameterTuningJobObjective":{ - "type":"structure", - "required":[ - "Type", - "MetricName" - ], - "members":{ - "Type":{ - "shape":"HyperParameterTuningJobObjectiveType", - "documentation":"

Whether to minimize or maximize the objective metric.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

The name of the metric to use for the objective metric.

" - } - }, - "documentation":"

Defines the objective metric for a hyperparameter tuning job. Hyperparameter tuning uses the value of this metric to evaluate the training jobs it launches, and returns the training job that results in either the highest or lowest value for this metric, depending on the value you specify for the Type parameter.

" - }, - "HyperParameterTuningJobObjectiveType":{ - "type":"string", - "enum":[ - "Maximize", - "Minimize" - ] - }, - "HyperParameterTuningJobSortByOptions":{ - "type":"string", - "enum":[ - "Name", - "Status", - "CreationTime" - ] - }, - "HyperParameterTuningJobStatus":{ - "type":"string", - "enum":[ - "Completed", - "InProgress", - "Failed", - "Stopped", - "Stopping" - ] - }, - "HyperParameterTuningJobStrategyType":{ - "type":"string", - "documentation":"

The strategy hyperparameter tuning uses to find the best combination of hyperparameters for your model. Currently, the only supported value is Bayesian.

", - "enum":["Bayesian"] - }, - "HyperParameterTuningJobSummaries":{ - "type":"list", - "member":{"shape":"HyperParameterTuningJobSummary"} - }, - "HyperParameterTuningJobSummary":{ - "type":"structure", - "required":[ - "HyperParameterTuningJobName", - "HyperParameterTuningJobArn", - "HyperParameterTuningJobStatus", - "Strategy", - "CreationTime", - "TrainingJobStatusCounters", - "ObjectiveStatusCounters" - ], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job.

" - }, - "HyperParameterTuningJobArn":{ - "shape":"HyperParameterTuningJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the tuning job.

" - }, - "HyperParameterTuningJobStatus":{ - "shape":"HyperParameterTuningJobStatus", - "documentation":"

The status of the tuning job.

" - }, - "Strategy":{ - "shape":"HyperParameterTuningJobStrategyType", - "documentation":"

Specifies the search strategy hyperparameter tuning uses to choose which hyperparameters to use for each iteration. Currently, the only valid value is Bayesian.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the tuning job was created.

" - }, - "HyperParameterTuningEndTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the tuning job ended.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

The date and time that the tuning job was modified.

" - }, - "TrainingJobStatusCounters":{ - "shape":"TrainingJobStatusCounters", - "documentation":"

The TrainingJobStatusCounters object that specifies the numbers of training jobs, categorized by status, that this tuning job launched.

" - }, - "ObjectiveStatusCounters":{ - "shape":"ObjectiveStatusCounters", - "documentation":"

The ObjectiveStatusCounters object that specifies the numbers of training jobs, categorized by objective metric status, that this tuning job launched.

" - }, - "ResourceLimits":{ - "shape":"ResourceLimits", - "documentation":"

The ResourceLimits object that specifies the maximum number of training jobs and parallel training jobs allowed for this tuning job.

" - } - }, - "documentation":"

Provides summary information about a hyperparameter tuning job.

" - }, - "HyperParameters":{ - "type":"map", - "key":{"shape":"ParameterKey"}, - "value":{"shape":"ParameterValue"}, - "max":100, - "min":0 - }, - "Image":{ - "type":"string", - "max":255, - "pattern":"[\\S]+" - }, - "InputDataConfig":{ - "type":"list", - "member":{"shape":"Channel"}, - "max":8, - "min":1 - }, - "InstanceType":{ - "type":"string", - "enum":[ - "ml.t2.medium", - "ml.t2.large", - "ml.t2.xlarge", - "ml.t2.2xlarge", - "ml.m4.xlarge", - "ml.m4.2xlarge", - "ml.m4.4xlarge", - "ml.m4.10xlarge", - "ml.m4.16xlarge", - "ml.p2.xlarge", - "ml.p2.8xlarge", - "ml.p2.16xlarge", - "ml.p3.2xlarge", - "ml.p3.8xlarge", - "ml.p3.16xlarge" - ] - }, - "IntegerParameterRange":{ - "type":"structure", - "required":[ - "Name", - "MinValue", - "MaxValue" - ], - "members":{ - "Name":{ - "shape":"ParameterKey", - "documentation":"

The name of the hyperparameter to search.

" - }, - "MinValue":{ - "shape":"ParameterValue", - "documentation":"

The minimum value of the hyperparameter to search.

" - }, - "MaxValue":{ - "shape":"ParameterValue", - "documentation":"

The maximum value of the hyperparameter to search.

" - } - }, - "documentation":"

For a hyperparameter of the integer type, specifies the range that a hyperparameter tuning job searches.

" - }, - "IntegerParameterRanges":{ - "type":"list", - "member":{"shape":"IntegerParameterRange"}, - "max":20, - "min":0 - }, - "KmsKeyId":{ - "type":"string", - "max":2048 - }, - "LastModifiedTime":{"type":"timestamp"}, - "ListEndpointConfigsInput":{ - "type":"structure", - "members":{ - "SortBy":{ - "shape":"EndpointConfigSortKey", - "documentation":"

The field to sort results by. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"OrderKey", - "documentation":"

The sort order for results. The default is Ascending.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the result of the previous ListEndpointConfig request was truncated, the response includes a NextToken. To retrieve the next set of endpoint configurations, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of training jobs to return in the response.

" - }, - "NameContains":{ - "shape":"EndpointConfigNameContains", - "documentation":"

A string in the endpoint configuration name. This filter returns only endpoint configurations whose name contains the specified string.

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoint configurations created before the specified time (timestamp).

" - }, - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoint configurations created after the specified time (timestamp).

" - } - } - }, - "ListEndpointConfigsOutput":{ - "type":"structure", - "required":["EndpointConfigs"], - "members":{ - "EndpointConfigs":{ - "shape":"EndpointConfigSummaryList", - "documentation":"

An array of endpoint configurations.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of endpoint configurations, use it in the subsequent request

" - } - } - }, - "ListEndpointsInput":{ - "type":"structure", - "members":{ - "SortBy":{ - "shape":"EndpointSortKey", - "documentation":"

Sorts the list of results. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"OrderKey", - "documentation":"

The sort order for results. The default is Ascending.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the result of a ListEndpoints request was truncated, the response includes a NextToken. To retrieve the next set of endpoints, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of endpoints to return in the response.

" - }, - "NameContains":{ - "shape":"EndpointNameContains", - "documentation":"

A string in endpoint names. This filter returns only endpoints whose name contains the specified string.

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoints that were created before the specified time (timestamp).

" - }, - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoints that were created after the specified time (timestamp).

" - }, - "LastModifiedTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoints that were modified before the specified timestamp.

" - }, - "LastModifiedTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only endpoints that were modified after the specified timestamp.

" - }, - "StatusEquals":{ - "shape":"EndpointStatus", - "documentation":"

A filter that returns only endpoints with the specified status.

" - } - } - }, - "ListEndpointsOutput":{ - "type":"structure", - "required":["Endpoints"], - "members":{ - "Endpoints":{ - "shape":"EndpointSummaryList", - "documentation":"

An array or endpoint objects.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of training jobs, use it in the subsequent request.

" - } - } - }, - "ListHyperParameterTuningJobsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous ListHyperParameterTuningJobs request was truncated, the response includes a NextToken. To retrieve the next set of tuning jobs, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of tuning jobs to return. The default value is 10.

", - "box":true - }, - "SortBy":{ - "shape":"HyperParameterTuningJobSortByOptions", - "documentation":"

The field to sort results by. The default is Name.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order for results. The default is Ascending.

" - }, - "NameContains":{ - "shape":"NameContains", - "documentation":"

A string in the tuning job name. This filter returns only tuning jobs whose name contains the specified string.

" - }, - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only tuning jobs that were created after the specified time.

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only tuning jobs that were created before the specified time.

" - }, - "LastModifiedTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only tuning jobs that were modified after the specified time.

" - }, - "LastModifiedTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only tuning jobs that were modified before the specified time.

" - }, - "StatusEquals":{ - "shape":"HyperParameterTuningJobStatus", - "documentation":"

A filter that returns only tuning jobs with the specified status.

" - } - } - }, - "ListHyperParameterTuningJobsResponse":{ - "type":"structure", - "required":["HyperParameterTuningJobSummaries"], - "members":{ - "HyperParameterTuningJobSummaries":{ - "shape":"HyperParameterTuningJobSummaries", - "documentation":"

A list of HyperParameterTuningJobSummary objects that describe the tuning jobs that the ListHyperParameterTuningJobs request returned.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of this ListHyperParameterTuningJobs request was truncated, the response includes a NextToken. To retrieve the next set of tuning jobs, use the token in the next request.

" - } - } - }, - "ListModelsInput":{ - "type":"structure", - "members":{ - "SortBy":{ - "shape":"ModelSortKey", - "documentation":"

Sorts the list of results. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"OrderKey", - "documentation":"

The sort order for results. The default is Ascending.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response to a previous ListModels request was truncated, the response includes a NextToken. To retrieve the next set of models, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of models to return in the response.

" - }, - "NameContains":{ - "shape":"ModelNameContains", - "documentation":"

A string in the training job name. This filter returns only models in the training job whose name contains the specified string.

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only models created before the specified time (timestamp).

" - }, - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only models created after the specified time (timestamp).

" - } - } - }, - "ListModelsOutput":{ - "type":"structure", - "required":["Models"], - "members":{ - "Models":{ - "shape":"ModelSummaryList", - "documentation":"

An array of ModelSummary objects, each of which lists a model.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of models, use it in the subsequent request.

" - } - } - }, - "ListNotebookInstanceLifecycleConfigsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of a ListNotebookInstanceLifecycleConfigs request was truncated, the response includes a NextToken. To get the next set of lifecycle configurations, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of lifecycle configurations to return in the response.

" - }, - "SortBy":{ - "shape":"NotebookInstanceLifecycleConfigSortKey", - "documentation":"

Sorts the list of results. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"NotebookInstanceLifecycleConfigSortOrder", - "documentation":"

The sort order for results.

" - }, - "NameContains":{ - "shape":"NotebookInstanceLifecycleConfigNameContains", - "documentation":"

A string in the lifecycle configuration name. This filter returns only lifecycle configurations whose name contains the specified string.

" - }, - "CreationTimeBefore":{ - "shape":"CreationTime", - "documentation":"

A filter that returns only lifecycle configurations that were created before the specified time (timestamp).

" - }, - "CreationTimeAfter":{ - "shape":"CreationTime", - "documentation":"

A filter that returns only lifecycle configurations that were created after the specified time (timestamp).

" - }, - "LastModifiedTimeBefore":{ - "shape":"LastModifiedTime", - "documentation":"

A filter that returns only lifecycle configurations that were modified before the specified time (timestamp).

" - }, - "LastModifiedTimeAfter":{ - "shape":"LastModifiedTime", - "documentation":"

A filter that returns only lifecycle configurations that were modified after the specified time (timestamp).

" - } - } - }, - "ListNotebookInstanceLifecycleConfigsOutput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To get the next set of lifecycle configurations, use it in the next request.

" - }, - "NotebookInstanceLifecycleConfigs":{ - "shape":"NotebookInstanceLifecycleConfigSummaryList", - "documentation":"

An array of NotebookInstanceLifecycleConfiguration objects, each listing a lifecycle configuration.

" - } - } - }, - "ListNotebookInstancesInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the previous call to the ListNotebookInstances is truncated, the response includes a NextToken. You can use this token in your subsequent ListNotebookInstances request to fetch the next set of notebook instances.

You might specify a filter or a sort order in your request. When response is truncated, you must use the same values for the filer and sort order in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of notebook instances to return.

" - }, - "SortBy":{ - "shape":"NotebookInstanceSortKey", - "documentation":"

The field to sort results by. The default is Name.

" - }, - "SortOrder":{ - "shape":"NotebookInstanceSortOrder", - "documentation":"

The sort order for results.

" - }, - "NameContains":{ - "shape":"NotebookInstanceNameContains", - "documentation":"

A string in the notebook instances' name. This filter returns only notebook instances whose name contains the specified string.

" - }, - "CreationTimeBefore":{ - "shape":"CreationTime", - "documentation":"

A filter that returns only notebook instances that were created before the specified time (timestamp).

" - }, - "CreationTimeAfter":{ - "shape":"CreationTime", - "documentation":"

A filter that returns only notebook instances that were created after the specified time (timestamp).

" - }, - "LastModifiedTimeBefore":{ - "shape":"LastModifiedTime", - "documentation":"

A filter that returns only notebook instances that were modified before the specified time (timestamp).

" - }, - "LastModifiedTimeAfter":{ - "shape":"LastModifiedTime", - "documentation":"

A filter that returns only notebook instances that were modified after the specified time (timestamp).

" - }, - "StatusEquals":{ - "shape":"NotebookInstanceStatus", - "documentation":"

A filter that returns only notebook instances with the specified status.

" - }, - "NotebookInstanceLifecycleConfigNameContains":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

A string in the name of a notebook instances lifecycle configuration associated with this notebook instance. This filter returns only notebook instances associated with a lifecycle configuration with a name that contains the specified string.

" - } - } - }, - "ListNotebookInstancesOutput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response to the previous ListNotebookInstances request was truncated, Amazon SageMaker returns this token. To retrieve the next set of notebook instances, use the token in the next request.

" - }, - "NotebookInstances":{ - "shape":"NotebookInstanceSummaryList", - "documentation":"

An array of NotebookInstanceSummary objects, one for each notebook instance.

" - } - } - }, - "ListTagsInput":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the resource whose tags you want to retrieve.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response to the previous ListTags request is truncated, Amazon SageMaker returns this token. To retrieve the next set of tags, use it in the subsequent request.

" - }, - "MaxResults":{ - "shape":"ListTagsMaxResults", - "documentation":"

Maximum number of tags to return.

" - } - } - }, - "ListTagsMaxResults":{ - "type":"integer", - "min":50 - }, - "ListTagsOutput":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagList", - "documentation":"

An array of Tag objects, each with a tag key and a value.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If response is truncated, Amazon SageMaker includes a token in the response. You can use this token in your subsequent request to fetch next set of tokens.

" - } - } - }, - "ListTrainingJobsForHyperParameterTuningJobRequest":{ - "type":"structure", - "required":["HyperParameterTuningJobName"], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job whose training jobs you want to list.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous ListTrainingJobsForHyperParameterTuningJob request was truncated, the response includes a NextToken. To retrieve the next set of training jobs, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of training jobs to return. The default value is 10.

" - }, - "StatusEquals":{ - "shape":"TrainingJobStatus", - "documentation":"

A filter that returns only training jobs with the specified status.

" - }, - "SortBy":{ - "shape":"TrainingJobSortByOptions", - "documentation":"

The field to sort results by. The default is Name.

If the value of this field is FinalObjectiveMetricValue, any training jobs that did not return an objective metric are not listed.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order for results. The default is Ascending.

" - } - } - }, - "ListTrainingJobsForHyperParameterTuningJobResponse":{ - "type":"structure", - "required":["TrainingJobSummaries"], - "members":{ - "TrainingJobSummaries":{ - "shape":"HyperParameterTrainingJobSummaries", - "documentation":"

A list of TrainingJobSummary objects that describe the training jobs that the ListTrainingJobsForHyperParameterTuningJob request returned.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of this ListTrainingJobsForHyperParameterTuningJob request was truncated, the response includes a NextToken. To retrieve the next set of training jobs, use the token in the next request.

" - } - } - }, - "ListTrainingJobsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous ListTrainingJobs request was truncated, the response includes a NextToken. To retrieve the next set of training jobs, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of training jobs to return in the response.

", - "box":true - }, - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only training jobs created after the specified time (timestamp).

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only training jobs created before the specified time (timestamp).

" - }, - "LastModifiedTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only training jobs modified after the specified time (timestamp).

" - }, - "LastModifiedTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only training jobs modified before the specified time (timestamp).

" - }, - "NameContains":{ - "shape":"NameContains", - "documentation":"

A string in the training job name. This filter returns only training jobs whose name contains the specified string.

" - }, - "StatusEquals":{ - "shape":"TrainingJobStatus", - "documentation":"

A filter that retrieves only training jobs with a specific status.

" - }, - "SortBy":{ - "shape":"SortBy", - "documentation":"

The field to sort results by. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order for results. The default is Ascending.

" - } - } - }, - "ListTrainingJobsResponse":{ - "type":"structure", - "required":["TrainingJobSummaries"], - "members":{ - "TrainingJobSummaries":{ - "shape":"TrainingJobSummaries", - "documentation":"

An array of TrainingJobSummary objects, each listing a training job.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of training jobs, use it in the subsequent request.

" - } - } - }, - "ListTransformJobsRequest":{ - "type":"structure", - "members":{ - "CreationTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only transform jobs created after the specified time.

" - }, - "CreationTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only transform jobs created before the specified time.

" - }, - "LastModifiedTimeAfter":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only transform jobs modified after the specified time.

" - }, - "LastModifiedTimeBefore":{ - "shape":"Timestamp", - "documentation":"

A filter that returns only transform jobs modified before the specified time.

" - }, - "NameContains":{ - "shape":"NameContains", - "documentation":"

A string in the transform job name. This filter returns only transform jobs whose name contains the specified string.

" - }, - "StatusEquals":{ - "shape":"TransformJobStatus", - "documentation":"

A filter that retrieves only transform jobs with a specific status.

" - }, - "SortBy":{ - "shape":"SortBy", - "documentation":"

The field to sort results by. The default is CreationTime.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order for results. The default is Descending.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous ListTransformJobs request was truncated, the response includes a NextToken. To retrieve the next set of transform jobs, use the token in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of transform jobs to return in the response. The default value is 10.

", - "box":true - } - } - }, - "ListTransformJobsResponse":{ - "type":"structure", - "required":["TransformJobSummaries"], - "members":{ - "TransformJobSummaries":{ - "shape":"TransformJobSummaries", - "documentation":"

An array of TransformJobSummary objects.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of transform jobs, use it in the next request.

" - } - } - }, - "MaxConcurrentTransforms":{ - "type":"integer", - "min":0 - }, - "MaxNumberOfTrainingJobs":{ - "type":"integer", - "min":1 - }, - "MaxParallelTrainingJobs":{ - "type":"integer", - "min":1 - }, - "MaxPayloadInMB":{ - "type":"integer", - "min":0 - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "MaxRuntimeInSeconds":{ - "type":"integer", - "min":1 - }, - "MetricDefinition":{ - "type":"structure", - "required":[ - "Name", - "Regex" - ], - "members":{ - "Name":{ - "shape":"MetricName", - "documentation":"

The name of the metric.

" - }, - "Regex":{ - "shape":"MetricRegex", - "documentation":"

A regular expression that searches the output of a training job and gets the value of the metric. For more information about using regular expressions to define metrics, see automatic-model-tuning-define-metrics.

" - } - }, - "documentation":"

Specifies a metric that the training algorithm writes to stderr or stdout. Amazon SageMakerHyperparamter tuning captures all defined metrics. You specify one metric that a hyperparameter tuning job uses as its objective metric to choose the best training job.

" - }, - "MetricDefinitionList":{ - "type":"list", - "member":{"shape":"MetricDefinition"}, - "max":20, - "min":0 - }, - "MetricName":{ - "type":"string", - "max":255, - "min":1 - }, - "MetricRegex":{ - "type":"string", - "max":500, - "min":1 - }, - "MetricValue":{"type":"float"}, - "ModelArn":{ - "type":"string", - "max":2048, - "min":20 - }, - "ModelArtifacts":{ - "type":"structure", - "required":["S3ModelArtifacts"], - "members":{ - "S3ModelArtifacts":{ - "shape":"S3Uri", - "documentation":"

The path of the S3 object that contains the model artifacts. For example, s3://bucket-name/keynameprefix/model.tar.gz.

" - } - }, - "documentation":"

Provides information about the location that is configured for storing model artifacts.

" - }, - "ModelName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "ModelNameContains":{ - "type":"string", - "pattern":"[a-zA-Z0-9-]+" - }, - "ModelSortKey":{ - "type":"string", - "enum":[ - "Name", - "CreationTime" - ] - }, - "ModelSummary":{ - "type":"structure", - "required":[ - "ModelName", - "ModelArn", - "CreationTime" - ], - "members":{ - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model that you want a summary for.

" - }, - "ModelArn":{ - "shape":"ModelArn", - "documentation":"

The Amazon Resource Name (ARN) of the model.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that indicates when the model was created.

" - } - }, - "documentation":"

Provides summary information about a model.

" - }, - "ModelSummaryList":{ - "type":"list", - "member":{"shape":"ModelSummary"} - }, - "NameContains":{ - "type":"string", - "max":63, - "pattern":"[a-zA-Z0-9\\-]+" - }, - "NetworkInterfaceId":{"type":"string"}, - "NextToken":{ - "type":"string", - "max":8192 - }, - "NotebookInstanceArn":{ - "type":"string", - "max":256 - }, - "NotebookInstanceLifecycleConfigArn":{ - "type":"string", - "max":256 - }, - "NotebookInstanceLifecycleConfigContent":{ - "type":"string", - "max":16384, - "min":1 - }, - "NotebookInstanceLifecycleConfigList":{ - "type":"list", - "member":{"shape":"NotebookInstanceLifecycleHook"}, - "max":1 - }, - "NotebookInstanceLifecycleConfigName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "NotebookInstanceLifecycleConfigNameContains":{ - "type":"string", - "pattern":"[a-zA-Z0-9-]+" - }, - "NotebookInstanceLifecycleConfigSortKey":{ - "type":"string", - "enum":[ - "Name", - "CreationTime", - "LastModifiedTime" - ] - }, - "NotebookInstanceLifecycleConfigSortOrder":{ - "type":"string", - "enum":[ - "Ascending", - "Descending" - ] - }, - "NotebookInstanceLifecycleConfigSummary":{ - "type":"structure", - "required":[ - "NotebookInstanceLifecycleConfigName", - "NotebookInstanceLifecycleConfigArn" - ], - "members":{ - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration.

" - }, - "NotebookInstanceLifecycleConfigArn":{ - "shape":"NotebookInstanceLifecycleConfigArn", - "documentation":"

The Amazon Resource Name (ARN) of the lifecycle configuration.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

A timestamp that tells when the lifecycle configuration was created.

" - }, - "LastModifiedTime":{ - "shape":"LastModifiedTime", - "documentation":"

A timestamp that tells when the lifecycle configuration was last modified.

" - } - }, - "documentation":"

Provides a summary of a notebook instance lifecycle configuration.

" - }, - "NotebookInstanceLifecycleConfigSummaryList":{ - "type":"list", - "member":{"shape":"NotebookInstanceLifecycleConfigSummary"} - }, - "NotebookInstanceLifecycleHook":{ - "type":"structure", - "members":{ - "Content":{ - "shape":"NotebookInstanceLifecycleConfigContent", - "documentation":"

A base64-encoded string that contains a shell script for a notebook instance lifecycle configuration.

" - } - }, - "documentation":"

Contains the notebook instance lifecycle configuration script.

Each lifecycle configuration script has a limit of 16384 characters.

The value of the $PATH environment variable that is available to both scripts is /sbin:bin:/usr/sbin:/usr/bin.

View CloudWatch Logs for notebook instance lifecycle configurations in log group /aws/sagemaker/NotebookInstances in log stream [notebook-instance-name]/[LifecycleConfigHook].

Lifecycle configuration scripts cannot run for longer than 5 minutes. If a script runs for longer than 5 minutes, it fails and the notebook instance is not created or started.

For information about notebook instance lifestyle configurations, see notebook-lifecycle-config.

" - }, - "NotebookInstanceName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "NotebookInstanceNameContains":{ - "type":"string", - "pattern":"[a-zA-Z0-9-]+" - }, - "NotebookInstanceSortKey":{ - "type":"string", - "enum":[ - "Name", - "CreationTime", - "Status" - ] - }, - "NotebookInstanceSortOrder":{ - "type":"string", - "enum":[ - "Ascending", - "Descending" - ] - }, - "NotebookInstanceStatus":{ - "type":"string", - "enum":[ - "Pending", - "InService", - "Stopping", - "Stopped", - "Failed", - "Deleting", - "Updating" - ] - }, - "NotebookInstanceSummary":{ - "type":"structure", - "required":[ - "NotebookInstanceName", - "NotebookInstanceArn" - ], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance that you want a summary for.

" - }, - "NotebookInstanceArn":{ - "shape":"NotebookInstanceArn", - "documentation":"

The Amazon Resource Name (ARN) of the notebook instance.

" - }, - "NotebookInstanceStatus":{ - "shape":"NotebookInstanceStatus", - "documentation":"

The status of the notebook instance.

" - }, - "Url":{ - "shape":"NotebookInstanceUrl", - "documentation":"

The URL that you use to connect to the Jupyter instance running in your notebook instance.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The type of ML compute instance that the notebook instance is running on.

" - }, - "CreationTime":{ - "shape":"CreationTime", - "documentation":"

A timestamp that shows when the notebook instance was created.

" - }, - "LastModifiedTime":{ - "shape":"LastModifiedTime", - "documentation":"

A timestamp that shows when the notebook instance was last modified.

" - }, - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of a notebook instance lifecycle configuration associated with this notebook instance.

For information about notebook instance lifestyle configurations, see notebook-lifecycle-config.

" - } - }, - "documentation":"

Provides summary information for an Amazon SageMaker notebook instance.

" - }, - "NotebookInstanceSummaryList":{ - "type":"list", - "member":{"shape":"NotebookInstanceSummary"} - }, - "NotebookInstanceUrl":{"type":"string"}, - "ObjectiveStatus":{ - "type":"string", - "enum":[ - "Succeeded", - "Pending", - "Failed" - ] - }, - "ObjectiveStatusCounter":{ - "type":"integer", - "min":0 - }, - "ObjectiveStatusCounters":{ - "type":"structure", - "members":{ - "Succeeded":{ - "shape":"ObjectiveStatusCounter", - "documentation":"

The number of training jobs whose final objective metric was evaluated by the hyperparameter tuning job and used in the hyperparameter tuning process.

" - }, - "Pending":{ - "shape":"ObjectiveStatusCounter", - "documentation":"

The number of training jobs that are in progress and pending evaluation of their final objective metric.

" - }, - "Failed":{ - "shape":"ObjectiveStatusCounter", - "documentation":"

The number of training jobs whose final objective metric was not evaluated and used in the hyperparameter tuning process. This typically occurs when the training job failed or did not emit an objective metric.

" - } - }, - "documentation":"

Specifies the number of training jobs that this hyperparameter tuning job launched, categorized by the status of their objective metric. The objective metric status shows whether the final objective metric for the training job has been evaluated by the tuning job and used in the hyperparameter tuning process.

" - }, - "OrderKey":{ - "type":"string", - "enum":[ - "Ascending", - "Descending" - ] - }, - "OutputDataConfig":{ - "type":"structure", - "required":["S3OutputPath"], - "members":{ - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The AWS Key Management Service (AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.

If you don't provide the KMS key ID, Amazon SageMaker uses the default KMS key for Amazon S3 for your role's account. For more information, see KMS-Managed Encryption Keys in Amazon Simple Storage Service developer guide.

The KMS key policy must grant permission to the IAM role you specify in your CreateTrainingJob request. Using Key Policies in AWS KMS in the AWS Key Management Service Developer Guide.

" - }, - "S3OutputPath":{ - "shape":"S3Uri", - "documentation":"

Identifies the S3 path where you want Amazon SageMaker to store the model artifacts. For example, s3://bucket-name/key-name-prefix.

" - } - }, - "documentation":"

Provides information about how to store model training results (model artifacts).

" - }, - "PaginationToken":{ - "type":"string", - "max":8192 - }, - "ParameterKey":{ - "type":"string", - "max":256 - }, - "ParameterRanges":{ - "type":"structure", - "members":{ - "IntegerParameterRanges":{ - "shape":"IntegerParameterRanges", - "documentation":"

The array of IntegerParameterRange objects that specify ranges of integer hyperparameters that a hyperparameter tuning job searches.

" - }, - "ContinuousParameterRanges":{ - "shape":"ContinuousParameterRanges", - "documentation":"

The array of ContinuousParameterRange objects that specify ranges of continuous hyperparameters that a hyperparameter tuning job searches.

" - }, - "CategoricalParameterRanges":{ - "shape":"CategoricalParameterRanges", - "documentation":"

The array of CategoricalParameterRange objects that specify ranges of categorical hyperparameters that a hyperparameter tuning job searches.

" - } - }, - "documentation":"

Specifies ranges of integer, continuous, and categorical hyperparameters that a hyperparameter tuning job searches.

" - }, - "ParameterValue":{ - "type":"string", - "max":256 - }, - "ParameterValues":{ - "type":"list", - "member":{"shape":"ParameterValue"}, - "max":20, - "min":1 - }, - "ProductionVariant":{ - "type":"structure", - "required":[ - "VariantName", - "ModelName", - "InitialInstanceCount", - "InstanceType" - ], - "members":{ - "VariantName":{ - "shape":"VariantName", - "documentation":"

The name of the production variant.

" - }, - "ModelName":{ - "shape":"ModelName", - "documentation":"

The name of the model that you want to host. This is the name that you specified when creating the model.

" - }, - "InitialInstanceCount":{ - "shape":"TaskCount", - "documentation":"

Number of instances to launch initially.

" - }, - "InstanceType":{ - "shape":"ProductionVariantInstanceType", - "documentation":"

The ML compute instance type.

" - }, - "InitialVariantWeight":{ - "shape":"VariantWeight", - "documentation":"

Determines initial traffic distribution among all of the models that you specify in the endpoint configuration. The traffic to a production variant is determined by the ratio of the VariantWeight to the sum of all VariantWeight values across all ProductionVariants. If unspecified, it defaults to 1.0.

" - } - }, - "documentation":"

Identifies a model that you want to host and the resources to deploy for hosting it. If you are deploying multiple models, tell Amazon SageMaker how to distribute traffic among the models by specifying variant weights.

" - }, - "ProductionVariantInstanceType":{ - "type":"string", - "enum":[ - "ml.t2.medium", - "ml.t2.large", - "ml.t2.xlarge", - "ml.t2.2xlarge", - "ml.m4.xlarge", - "ml.m4.2xlarge", - "ml.m4.4xlarge", - "ml.m4.10xlarge", - "ml.m4.16xlarge", - "ml.m5.large", - "ml.m5.xlarge", - "ml.m5.2xlarge", - "ml.m5.4xlarge", - "ml.m5.12xlarge", - "ml.m5.24xlarge", - "ml.c4.large", - "ml.c4.xlarge", - "ml.c4.2xlarge", - "ml.c4.4xlarge", - "ml.c4.8xlarge", - "ml.p2.xlarge", - "ml.p2.8xlarge", - "ml.p2.16xlarge", - "ml.p3.2xlarge", - "ml.p3.8xlarge", - "ml.p3.16xlarge", - "ml.c5.large", - "ml.c5.xlarge", - "ml.c5.2xlarge", - "ml.c5.4xlarge", - "ml.c5.9xlarge", - "ml.c5.18xlarge" - ] - }, - "ProductionVariantList":{ - "type":"list", - "member":{"shape":"ProductionVariant"}, - "min":1 - }, - "ProductionVariantSummary":{ - "type":"structure", - "required":["VariantName"], - "members":{ - "VariantName":{ - "shape":"VariantName", - "documentation":"

The name of the variant.

" - }, - "DeployedImages":{ - "shape":"DeployedImages", - "documentation":"

An array of DeployedImage objects that specify the Amazon EC2 Container Registry paths of the inference images deployed on instances of this ProductionVariant.

" - }, - "CurrentWeight":{ - "shape":"VariantWeight", - "documentation":"

The weight associated with the variant.

" - }, - "DesiredWeight":{ - "shape":"VariantWeight", - "documentation":"

The requested weight, as specified in the UpdateEndpointWeightsAndCapacities request.

" - }, - "CurrentInstanceCount":{ - "shape":"TaskCount", - "documentation":"

The number of instances associated with the variant.

" - }, - "DesiredInstanceCount":{ - "shape":"TaskCount", - "documentation":"

The number of instances requested in the UpdateEndpointWeightsAndCapacities request.

" - } - }, - "documentation":"

Describes weight and capacities for a production variant associated with an endpoint. If you sent a request to the UpdateEndpointWeightsAndCapacities API and the endpoint status is Updating, you get different desired and current values.

" - }, - "ProductionVariantSummaryList":{ - "type":"list", - "member":{"shape":"ProductionVariantSummary"}, - "min":1 - }, - "RecordWrapper":{ - "type":"string", - "enum":[ - "None", - "RecordIO" - ] - }, - "ResourceArn":{ - "type":"string", - "max":256 - }, - "ResourceConfig":{ - "type":"structure", - "required":[ - "InstanceType", - "InstanceCount", - "VolumeSizeInGB" - ], - "members":{ - "InstanceType":{ - "shape":"TrainingInstanceType", - "documentation":"

The ML compute instance type.

" - }, - "InstanceCount":{ - "shape":"TrainingInstanceCount", - "documentation":"

The number of ML compute instances to use. For distributed training, provide a value greater than 1.

" - }, - "VolumeSizeInGB":{ - "shape":"VolumeSizeInGB", - "documentation":"

The size of the ML storage volume that you want to provision.

ML storage volumes store model artifacts and incremental states. Training algorithms might also use the ML storage volume for scratch space. If you want to store the training data in the ML storage volume, choose File as the TrainingInputMode in the algorithm specification.

You must specify sufficient ML storage for your scenario.

Amazon SageMaker supports only the General Purpose SSD (gp2) ML storage volume type.

" - }, - "VolumeKmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The Amazon Resource Name (ARN) of a AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance(s) that run the training job.

" - } - }, - "documentation":"

Describes the resources, including ML compute instances and ML storage volumes, to use for model training.

" - }, - "ResourceInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"FailureReason"} - }, - "documentation":"

Resource being accessed is in use.

", - "exception":true - }, - "ResourceLimitExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"FailureReason"} - }, - "documentation":"

You have exceeded an Amazon SageMaker resource limit. For example, you might have too many training jobs created.

", - "exception":true - }, - "ResourceLimits":{ - "type":"structure", - "required":[ - "MaxNumberOfTrainingJobs", - "MaxParallelTrainingJobs" - ], - "members":{ - "MaxNumberOfTrainingJobs":{ - "shape":"MaxNumberOfTrainingJobs", - "documentation":"

The maximum number of training jobs that a hyperparameter tuning job can launch.

" - }, - "MaxParallelTrainingJobs":{ - "shape":"MaxParallelTrainingJobs", - "documentation":"

The maximum number of concurrent training jobs that a hyperparameter tuning job can launch.

" - } - }, - "documentation":"

Specifies the maximum number of training jobs and parallel training jobs that a hyperparameter tuning job can launch.

" - }, - "ResourceNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"FailureReason"} - }, - "documentation":"

Resource being access is not found.

", - "exception":true - }, - "RoleArn":{ - "type":"string", - "max":2048, - "min":20, - "pattern":"^arn:aws[a-z\\-]*:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+$" - }, - "S3DataDistribution":{ - "type":"string", - "enum":[ - "FullyReplicated", - "ShardedByS3Key" - ] - }, - "S3DataSource":{ - "type":"structure", - "required":[ - "S3DataType", - "S3Uri" - ], - "members":{ - "S3DataType":{ - "shape":"S3DataType", - "documentation":"

If you choose S3Prefix, S3Uri identifies a key name prefix. Amazon SageMaker uses all objects with the specified key name prefix for model training.

If you choose ManifestFile, S3Uri identifies an object that is a manifest file containing a list of object keys that you want Amazon SageMaker to use for model training.

" - }, - "S3Uri":{ - "shape":"S3Uri", - "documentation":"

Depending on the value specified for the S3DataType, identifies either a key name prefix or a manifest. For example:

  • A key name prefix might look like this: s3://bucketname/exampleprefix.

  • A manifest might look like this: s3://bucketname/example.manifest

    The manifest is an S3 object which is a JSON file with the following format:

    [

    {\"prefix\": \"s3://customer_bucket/some/prefix/\"},

    \"relative/path/to/custdata-1\",

    \"relative/path/custdata-2\",

    ...

    ]

    The preceding JSON matches the following s3Uris:

    s3://customer_bucket/some/prefix/relative/path/to/custdata-1

    s3://customer_bucket/some/prefix/relative/path/custdata-1

    ...

    The complete set of s3uris in this manifest constitutes the input data for the channel for this datasource. The object that each s3uris points to must readable by the IAM role that Amazon SageMaker uses to perform tasks on your behalf.

" - }, - "S3DataDistributionType":{ - "shape":"S3DataDistribution", - "documentation":"

If you want Amazon SageMaker to replicate the entire dataset on each ML compute instance that is launched for model training, specify FullyReplicated.

If you want Amazon SageMaker to replicate a subset of data on each ML compute instance that is launched for model training, specify ShardedByS3Key. If there are n ML compute instances launched for a training job, each instance gets approximately 1/n of the number of S3 objects. In this case, model training on each machine uses only the subset of training data.

Don't choose more ML compute instances for training than available S3 objects. If you do, some nodes won't get any data and you will pay for nodes that aren't getting any training data. This applies in both FILE and PIPE modes. Keep this in mind when developing algorithms.

In distributed training, where you use multiple ML compute EC2 instances, you might choose ShardedByS3Key. If the algorithm requires copying training data to the ML storage volume (when TrainingInputMode is set to File), this copies 1/n of the number of objects.

" - } - }, - "documentation":"

Describes the S3 data source.

" - }, - "S3DataType":{ - "type":"string", - "enum":[ - "ManifestFile", - "S3Prefix" - ] - }, - "S3Uri":{ - "type":"string", - "max":1024, - "pattern":"^(https|s3)://([^/]+)/?(.*)$" - }, - "SecondaryStatus":{ - "type":"string", - "enum":[ - "Starting", - "LaunchingMLInstances", - "PreparingTrainingStack", - "Downloading", - "DownloadingTrainingImage", - "Training", - "Uploading", - "Stopping", - "Stopped", - "MaxRuntimeExceeded", - "Completed", - "Failed" - ] - }, - "SecondaryStatusTransition":{ - "type":"structure", - "required":[ - "Status", - "StartTime" - ], - "members":{ - "Status":{ - "shape":"SecondaryStatus", - "documentation":"

Provides granular information about the system state. For more information, see SecondaryStatus under the DescribeTrainingJob response elements.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the training job has entered this secondary status.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the secondary status has ended and the job has transitioned into another secondary status. The EndTime timestamp is also set after the training job has ended.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

Shows a brief description and other information about the secondary status. For example, the LaunchingMLInstances secondary status could show a status message of \"Insufficent capacity error while launching instances\".

" - } - }, - "documentation":"

Specifies a secondary status the job has transitioned into. It includes a start timestamp and later an end timestamp. The end timestamp is added either after the job transitions to a different secondary status or after the job has ended.

" - }, - "SecondaryStatusTransitions":{ - "type":"list", - "member":{"shape":"SecondaryStatusTransition"} - }, - "SecurityGroupId":{ - "type":"string", - "max":32 - }, - "SecurityGroupIds":{ - "type":"list", - "member":{"shape":"SecurityGroupId"}, - "max":5 - }, - "SessionExpirationDurationInSeconds":{ - "type":"integer", - "max":43200, - "min":1800 - }, - "SortBy":{ - "type":"string", - "enum":[ - "Name", - "CreationTime", - "Status" - ] - }, - "SortOrder":{ - "type":"string", - "enum":[ - "Ascending", - "Descending" - ] - }, - "SplitType":{ - "type":"string", - "enum":[ - "None", - "Line", - "RecordIO" - ] - }, - "StartNotebookInstanceInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance to start.

" - } - } - }, - "StatusMessage":{"type":"string"}, - "StopHyperParameterTuningJobRequest":{ - "type":"structure", - "required":["HyperParameterTuningJobName"], - "members":{ - "HyperParameterTuningJobName":{ - "shape":"HyperParameterTuningJobName", - "documentation":"

The name of the tuning job to stop.

" - } - } - }, - "StopNotebookInstanceInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance to terminate.

" - } - } - }, - "StopTrainingJobRequest":{ - "type":"structure", - "required":["TrainingJobName"], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

The name of the training job to stop.

" - } - } - }, - "StopTransformJobRequest":{ - "type":"structure", - "required":["TransformJobName"], - "members":{ - "TransformJobName":{ - "shape":"TransformJobName", - "documentation":"

The name of the transform job to stop.

" - } - } - }, - "StoppingCondition":{ - "type":"structure", - "members":{ - "MaxRuntimeInSeconds":{ - "shape":"MaxRuntimeInSeconds", - "documentation":"

The maximum length of time, in seconds, that the training job can run. If model training does not complete during this time, Amazon SageMaker ends the job. If value is not specified, default value is 1 day. Maximum value is 5 days.

" - } - }, - "documentation":"

Specifies how long model training can run. When model training reaches the limit, Amazon SageMaker ends the training job. Use this API to cap model training cost.

To stop a job, Amazon SageMaker sends the algorithm the SIGTERM signal, which delays job termination for120 seconds. Algorithms might use this 120-second window to save the model artifacts, so the results of training is not lost.

Training algorithms provided by Amazon SageMaker automatically saves the intermediate results of a model training job (it is best effort case, as model might not be ready to save as some stages, for example training just started). This intermediate data is a valid model artifact. You can use it to create a model (CreateModel).

" - }, - "SubnetId":{ - "type":"string", - "max":32 - }, - "Subnets":{ - "type":"list", - "member":{"shape":"SubnetId"}, - "max":16, - "min":1 - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The tag value.

" - } - }, - "documentation":"

Describes a tag.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^((?!aws:)[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"TagKey"}, - "max":50, - "min":1 - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50, - "min":0 - }, - "TagValue":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TaskCount":{ - "type":"integer", - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "TrainingInputMode":{ - "type":"string", - "enum":[ - "Pipe", - "File" - ] - }, - "TrainingInstanceCount":{ - "type":"integer", - "min":1 - }, - "TrainingInstanceType":{ - "type":"string", - "enum":[ - "ml.m4.xlarge", - "ml.m4.2xlarge", - "ml.m4.4xlarge", - "ml.m4.10xlarge", - "ml.m4.16xlarge", - "ml.m5.large", - "ml.m5.xlarge", - "ml.m5.2xlarge", - "ml.m5.4xlarge", - "ml.m5.12xlarge", - "ml.m5.24xlarge", - "ml.c4.xlarge", - "ml.c4.2xlarge", - "ml.c4.4xlarge", - "ml.c4.8xlarge", - "ml.p2.xlarge", - "ml.p2.8xlarge", - "ml.p2.16xlarge", - "ml.p3.2xlarge", - "ml.p3.8xlarge", - "ml.p3.16xlarge", - "ml.c5.xlarge", - "ml.c5.2xlarge", - "ml.c5.4xlarge", - "ml.c5.9xlarge", - "ml.c5.18xlarge" - ] - }, - "TrainingJobArn":{ - "type":"string", - "max":256, - "pattern":"arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:training-job/.*" - }, - "TrainingJobName":{ - "type":"string", - "max":63, - "min":1, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "TrainingJobSortByOptions":{ - "type":"string", - "enum":[ - "Name", - "CreationTime", - "Status", - "FinalObjectiveMetricValue" - ] - }, - "TrainingJobStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Completed", - "Failed", - "Stopping", - "Stopped" - ] - }, - "TrainingJobStatusCounter":{ - "type":"integer", - "min":0 - }, - "TrainingJobStatusCounters":{ - "type":"structure", - "members":{ - "Completed":{ - "shape":"TrainingJobStatusCounter", - "documentation":"

The number of completed training jobs launched by a hyperparameter tuning job.

" - }, - "InProgress":{ - "shape":"TrainingJobStatusCounter", - "documentation":"

The number of in-progress training jobs launched by a hyperparameter tuning job.

" - }, - "RetryableError":{ - "shape":"TrainingJobStatusCounter", - "documentation":"

The number of training jobs that failed, but can be retried. A failed training job can be retried only if it failed because an internal service error occurred.

" - }, - "NonRetryableError":{ - "shape":"TrainingJobStatusCounter", - "documentation":"

The number of training jobs that failed and can't be retried. A failed training job can't be retried if it failed because a client error occurred.

" - }, - "Stopped":{ - "shape":"TrainingJobStatusCounter", - "documentation":"

The number of training jobs launched by a hyperparameter tuning job that were manually stopped.

" - } - }, - "documentation":"

The numbers of training jobs launched by a hyperparameter tuning job, categorized by status.

" - }, - "TrainingJobSummaries":{ - "type":"list", - "member":{"shape":"TrainingJobSummary"} - }, - "TrainingJobSummary":{ - "type":"structure", - "required":[ - "TrainingJobName", - "TrainingJobArn", - "CreationTime", - "TrainingJobStatus" - ], - "members":{ - "TrainingJobName":{ - "shape":"TrainingJobName", - "documentation":"

The name of the training job that you want a summary for.

" - }, - "TrainingJobArn":{ - "shape":"TrainingJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the training job.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the training job was created.

" - }, - "TrainingEndTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the training job ended. This field is set only if the training job has one of the terminal statuses (Completed, Failed, or Stopped).

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

Timestamp when the training job was last modified.

" - }, - "TrainingJobStatus":{ - "shape":"TrainingJobStatus", - "documentation":"

The status of the training job.

" - } - }, - "documentation":"

Provides summary information about a training job.

" - }, - "TransformDataSource":{ - "type":"structure", - "required":["S3DataSource"], - "members":{ - "S3DataSource":{ - "shape":"TransformS3DataSource", - "documentation":"

The S3 location of the data source that is associated with a channel.

" - } - }, - "documentation":"

Describes the location of the channel data.

" - }, - "TransformEnvironmentKey":{ - "type":"string", - "max":1024, - "pattern":"[a-zA-Z_][a-zA-Z0-9_]*" - }, - "TransformEnvironmentMap":{ - "type":"map", - "key":{"shape":"TransformEnvironmentKey"}, - "value":{"shape":"TransformEnvironmentValue"}, - "max":16 - }, - "TransformEnvironmentValue":{ - "type":"string", - "max":10240 - }, - "TransformInput":{ - "type":"structure", - "required":["DataSource"], - "members":{ - "DataSource":{ - "shape":"TransformDataSource", - "documentation":"

Describes the location of the channel data, meaning the S3 location of the input data that the model can consume.

" - }, - "ContentType":{ - "shape":"ContentType", - "documentation":"

The multipurpose internet mail extension (MIME) type of the data. Amazon SageMaker uses the MIME type with each http call to transfer data to the transform job.

" - }, - "CompressionType":{ - "shape":"CompressionType", - "documentation":"

Compressing data helps save on storage space. If your transform data is compressed, specify the compression type.and Amazon SageMaker will automatically decompress the data for the transform job accordingly. The default value is None.

" - }, - "SplitType":{ - "shape":"SplitType", - "documentation":"

The method to use to split the transform job's data into smaller batches. The default value is None. If you don't want to split the data, specify None. If you want to split records on a newline character boundary, specify Line. To split records according to the RecordIO format, specify RecordIO.

Amazon SageMaker will send maximum number of records per batch in each request up to the MaxPayloadInMB limit. For more information, see RecordIO data format.

For information about the RecordIO format, see Data Format.

" - } - }, - "documentation":"

Describes the input source of a transform job and the way the transform job consumes it.

" - }, - "TransformInstanceCount":{ - "type":"integer", - "min":1 - }, - "TransformInstanceType":{ - "type":"string", - "enum":[ - "ml.m4.xlarge", - "ml.m4.2xlarge", - "ml.m4.4xlarge", - "ml.m4.10xlarge", - "ml.m4.16xlarge", - "ml.c4.xlarge", - "ml.c4.2xlarge", - "ml.c4.4xlarge", - "ml.c4.8xlarge", - "ml.p2.xlarge", - "ml.p2.8xlarge", - "ml.p2.16xlarge", - "ml.p3.2xlarge", - "ml.p3.8xlarge", - "ml.p3.16xlarge", - "ml.c5.xlarge", - "ml.c5.2xlarge", - "ml.c5.4xlarge", - "ml.c5.9xlarge", - "ml.c5.18xlarge", - "ml.m5.large", - "ml.m5.xlarge", - "ml.m5.2xlarge", - "ml.m5.4xlarge", - "ml.m5.12xlarge", - "ml.m5.24xlarge" - ] - }, - "TransformJobArn":{ - "type":"string", - "max":256, - "pattern":"arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:transform-job/.*" - }, - "TransformJobName":{ - "type":"string", - "max":63, - "min":1, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "TransformJobStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Completed", - "Failed", - "Stopping", - "Stopped" - ] - }, - "TransformJobSummaries":{ - "type":"list", - "member":{"shape":"TransformJobSummary"} - }, - "TransformJobSummary":{ - "type":"structure", - "required":[ - "TransformJobName", - "TransformJobArn", - "CreationTime", - "TransformJobStatus" - ], - "members":{ - "TransformJobName":{ - "shape":"TransformJobName", - "documentation":"

The name of the transform job.

" - }, - "TransformJobArn":{ - "shape":"TransformJobArn", - "documentation":"

The Amazon Resource Name (ARN) of the transform job.

" - }, - "CreationTime":{ - "shape":"Timestamp", - "documentation":"

A timestamp that shows when the transform Job was created.

" - }, - "TransformEndTime":{ - "shape":"Timestamp", - "documentation":"

Indicates when the transform job ends on compute instances. For successful jobs and stopped jobs, this is the exact time recorded after the results are uploaded. For failed jobs, this is when Amazon SageMaker detected that the job failed.

" - }, - "LastModifiedTime":{ - "shape":"Timestamp", - "documentation":"

Indicates when the transform job was last modified.

" - }, - "TransformJobStatus":{ - "shape":"TransformJobStatus", - "documentation":"

The status of the transform job.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the transform job failed, the reason it failed.

" - } - }, - "documentation":"

Provides a summary information for a transform job. Multiple TransformJobSummary objects are returned as a list after calling ListTransformJobs.

" - }, - "TransformOutput":{ - "type":"structure", - "required":["S3OutputPath"], - "members":{ - "S3OutputPath":{ - "shape":"S3Uri", - "documentation":"

The Amazon S3 path where you want Amazon SageMaker to store the results of the transform job. For example, s3://bucket-name/key-name-prefix.

For every S3 object used as input for the transform job, the transformed data is stored in a corresponding subfolder in the location under the output prefix. For example, the input data s3://bucket-name/input-name-prefix/dataset01/data.csv will have the transformed data stored at s3://bucket-name/key-name-prefix/dataset01/, based on the original name, as a series of .part files (.part0001, part0002, etc).

" - }, - "Accept":{ - "shape":"Accept", - "documentation":"

The MIME type used to specify the output data. Amazon SageMaker uses the MIME type with each http call to transfer data from the transform job.

" - }, - "AssembleWith":{ - "shape":"AssemblyType", - "documentation":"

Defines how to assemble the results of the transform job as a single S3 object. You should select a format that is most convenient to you. To concatenate the results in binary format, specify None. To add a newline character at the end of every transformed record, specify Line. To assemble the output in RecordIO format, specify RecordIO. The default value is None.

For information about the RecordIO format, see Data Format.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyId", - "documentation":"

The AWS Key Management Service (AWS KMS) key for Amazon S3 server-side encryption that Amazon SageMaker uses to encrypt the transformed data.

If you don't provide a KMS key ID, Amazon SageMaker uses the default KMS key for Amazon S3 for your role's account. For more information, see KMS-Managed Encryption Keys in the Amazon Simple Storage Service Developer Guide.

The KMS key policy must grant permission to the IAM role that you specify in your CreateTramsformJob request. For more information, see Using Key Policies in AWS KMS in the AWS Key Management Service Developer Guide.

" - } - }, - "documentation":"

Describes the results of a transform job output.

" - }, - "TransformResources":{ - "type":"structure", - "required":[ - "InstanceType", - "InstanceCount" - ], - "members":{ - "InstanceType":{ - "shape":"TransformInstanceType", - "documentation":"

The ML compute instance type for the transform job. For using built-in algorithms to transform moderately sized datasets, ml.m4.xlarge or ml.m5.large should suffice. There is no default value for InstanceType.

" - }, - "InstanceCount":{ - "shape":"TransformInstanceCount", - "documentation":"

The number of ML compute instances to use in the transform job. For distributed transform, provide a value greater than 1. The default value is 1.

" - } - }, - "documentation":"

Describes the resources, including ML instance types and ML instance count, to use for transform job.

" - }, - "TransformS3DataSource":{ - "type":"structure", - "required":[ - "S3DataType", - "S3Uri" - ], - "members":{ - "S3DataType":{ - "shape":"S3DataType", - "documentation":"

If you choose S3Prefix, S3Uri identifies a key name prefix. Amazon SageMaker uses all objects with the specified key name prefix for batch transform.

If you choose ManifestFile, S3Uri identifies an object that is a manifest file containing a list of object keys that you want Amazon SageMaker to use for batch transform.

" - }, - "S3Uri":{ - "shape":"S3Uri", - "documentation":"

Depending on the value specified for the S3DataType, identifies either a key name prefix or a manifest. For example:

  • A key name prefix might look like this: s3://bucketname/exampleprefix.

  • A manifest might look like this: s3://bucketname/example.manifest

    The manifest is an S3 object which is a JSON file with the following format:

    [

    {\"prefix\": \"s3://customer_bucket/some/prefix/\"},

    \"relative/path/to/custdata-1\",

    \"relative/path/custdata-2\",

    ...

    ]

    The preceding JSON matches the following S3Uris:

    s3://customer_bucket/some/prefix/relative/path/to/custdata-1

    s3://customer_bucket/some/prefix/relative/path/custdata-1

    ...

    The complete set of S3Uris in this manifest constitutes the input data for the channel for this datasource. The object that each S3Uris points to must be readable by the IAM role that Amazon SageMaker uses to perform tasks on your behalf.

" - } - }, - "documentation":"

Describes the S3 data source.

" - }, - "UpdateEndpointInput":{ - "type":"structure", - "required":[ - "EndpointName", - "EndpointConfigName" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of the endpoint whose configuration you want to update.

" - }, - "EndpointConfigName":{ - "shape":"EndpointConfigName", - "documentation":"

The name of the new endpoint configuration.

" - } - } - }, - "UpdateEndpointOutput":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"EndpointArn", - "documentation":"

The Amazon Resource Name (ARN) of the endpoint.

" - } - } - }, - "UpdateEndpointWeightsAndCapacitiesInput":{ - "type":"structure", - "required":[ - "EndpointName", - "DesiredWeightsAndCapacities" - ], - "members":{ - "EndpointName":{ - "shape":"EndpointName", - "documentation":"

The name of an existing Amazon SageMaker endpoint.

" - }, - "DesiredWeightsAndCapacities":{ - "shape":"DesiredWeightAndCapacityList", - "documentation":"

An object that provides new capacity and weight values for a variant.

" - } - } - }, - "UpdateEndpointWeightsAndCapacitiesOutput":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"EndpointArn", - "documentation":"

The Amazon Resource Name (ARN) of the updated endpoint.

" - } - } - }, - "UpdateNotebookInstanceInput":{ - "type":"structure", - "required":["NotebookInstanceName"], - "members":{ - "NotebookInstanceName":{ - "shape":"NotebookInstanceName", - "documentation":"

The name of the notebook instance to update.

" - }, - "InstanceType":{ - "shape":"InstanceType", - "documentation":"

The Amazon ML compute instance type.

" - }, - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role that Amazon SageMaker can assume to access the notebook instance. For more information, see Amazon SageMaker Roles.

To be able to pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission.

" - } - } - }, - "UpdateNotebookInstanceLifecycleConfigInput":{ - "type":"structure", - "required":["NotebookInstanceLifecycleConfigName"], - "members":{ - "NotebookInstanceLifecycleConfigName":{ - "shape":"NotebookInstanceLifecycleConfigName", - "documentation":"

The name of the lifecycle configuration.

" - }, - "OnCreate":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

The shell script that runs only once, when you create a notebook instance

" - }, - "OnStart":{ - "shape":"NotebookInstanceLifecycleConfigList", - "documentation":"

The shell script that runs every time you start a notebook instance, including when you create the notebook instance.

" - } - } - }, - "UpdateNotebookInstanceLifecycleConfigOutput":{ - "type":"structure", - "members":{ - } - }, - "UpdateNotebookInstanceOutput":{ - "type":"structure", - "members":{ - } - }, - "Url":{ - "type":"string", - "max":1024, - "pattern":"^(https|s3)://([^/]+)/?(.*)$" - }, - "VariantName":{ - "type":"string", - "max":63, - "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*" - }, - "VariantWeight":{ - "type":"float", - "min":0 - }, - "VolumeSizeInGB":{ - "type":"integer", - "min":1 - }, - "VpcConfig":{ - "type":"structure", - "required":[ - "SecurityGroupIds", - "Subnets" - ], - "members":{ - "SecurityGroupIds":{ - "shape":"VpcSecurityGroupIds", - "documentation":"

The VPC security group IDs, in the form sg-xxxxxxxx. Specify the security groups for the VPC that is specified in the Subnets field.

" - }, - "Subnets":{ - "shape":"Subnets", - "documentation":"

The ID of the subnets in the VPC to which you want to connect your training job or model.

" - } - }, - "documentation":"

Specifies a VPC that your training jobs and hosted models have access to. Control access to and from your training and model containers by configuring the VPC. For more information, see host-vpc and train-vpc.

" - }, - "VpcSecurityGroupIds":{ - "type":"list", - "member":{"shape":"SecurityGroupId"}, - "max":5, - "min":1 - } - }, - "documentation":"Definition of the public APIs exposed by SageMaker" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/waiters-2.json deleted file mode 100644 index 0fbb61eb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sagemaker/2017-07-24/waiters-2.json +++ /dev/null @@ -1,133 +0,0 @@ -{ - "version": 2, - "waiters": { - "NotebookInstanceInService": { - "delay": 30, - "maxAttempts": 60, - "operation": "DescribeNotebookInstance", - "acceptors": [ - { - "expected": "InService", - "matcher": "path", - "state": "success", - "argument": "NotebookInstanceStatus" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "NotebookInstanceStatus" - } - ] - }, - "NotebookInstanceStopped": { - "delay": 30, - "operation": "DescribeNotebookInstance", - "maxAttempts": 60, - "acceptors": [ - { - "expected": "Stopped", - "matcher": "path", - "state": "success", - "argument": "NotebookInstanceStatus" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "NotebookInstanceStatus" - } - ] - }, - "NotebookInstanceDeleted": { - "delay": 30, - "maxAttempts": 60, - "operation": "DescribeNotebookInstance", - "acceptors": [ - { - "expected": "ValidationException", - "matcher": "error", - "state": "success" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "NotebookInstanceStatus" - } - ] - }, - "TrainingJobCompletedOrStopped": { - "delay": 120, - "maxAttempts": 180, - "operation": "DescribeTrainingJob", - "acceptors": [ - { - "expected": "Completed", - "matcher": "path", - "state": "success", - "argument": "TrainingJobStatus" - }, - { - "expected": "Stopped", - "matcher": "path", - "state": "success", - "argument": "TrainingJobStatus" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "TrainingJobStatus" - }, - { - "expected": "ValidationException", - "matcher": "error", - "state": "failure" - } - ] - }, - "EndpointInService": { - "delay": 30, - "maxAttempts": 120, - "operation": "DescribeEndpoint", - "acceptors": [ - { - "expected": "InService", - "matcher": "path", - "state": "success", - "argument": "EndpointStatus" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "EndpointStatus" - }, - { - "expected": "ValidationException", - "matcher": "error", - "state": "failure" - } - ] - }, - "EndpointDeleted": { - "delay": 30, - "maxAttempts": 60, - "operation": "DescribeEndpoint", - "acceptors": [ - { - "expected": "ValidationException", - "matcher": "error", - "state": "success" - }, - { - "expected": "Failed", - "matcher": "path", - "state": "failure", - "argument": "EndpointStatus" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/paginators-1.json deleted file mode 100644 index 23620988..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/paginators-1.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "pagination": { - "ListDomains": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxNumberOfDomains", - "result_key": "DomainNames" - }, - "Select": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Items" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/service-2.json deleted file mode 100644 index 1f243edc..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sdb/2009-04-15/service-2.json +++ /dev/null @@ -1,1180 +0,0 @@ -{ - "metadata":{ - "uid":"sdb-2009-04-15", - "apiVersion":"2009-04-15", - "endpointPrefix":"sdb", - "serviceFullName":"Amazon SimpleDB", - "serviceId":"SimpleDB", - "signatureVersion":"v2", - "xmlNamespace":"http://sdb.amazonaws.com/doc/2009-04-15/", - "protocol":"query" - }, - "documentation":"Amazon SimpleDB is a web service providing the core database functions of data indexing and querying in the cloud. By offloading the time and effort associated with building and operating a web-scale database, SimpleDB provides developers the freedom to focus on application development.

A traditional, clustered relational database requires a sizable upfront capital outlay, is complex to design, and often requires extensive and repetitive database administration. Amazon SimpleDB is dramatically simpler, requiring no schema, automatically indexing your data and providing a simple API for storage and access. This approach eliminates the administrative burden of data modeling, index maintenance, and performance tuning. Developers gain access to this functionality within Amazon's proven computing environment, are able to scale instantly, and pay only for what they use.

Visit http://aws.amazon.com/simpledb/ for more information.

", - "operations":{ - "BatchDeleteAttributes":{ - "name":"BatchDeleteAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchDeleteAttributesRequest"}, - "documentation":"

Performs multiple DeleteAttributes operations in a single call, which reduces round trips and latencies. This enables Amazon SimpleDB to optimize requests, which generally yields better throughput.

The following limitations are enforced for this operation:

  • 1 MB request size
  • 25 item limit per BatchDeleteAttributes operation

" - }, - "BatchPutAttributes":{ - "name":"BatchPutAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"BatchPutAttributesRequest"}, - "errors":[ - { - "shape":"DuplicateItemName", - "error":{ - "code":"DuplicateItemName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The item name was specified more than once.

" - }, - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - }, - { - "shape":"NumberItemAttributesExceeded", - "error":{ - "code":"NumberItemAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this item.

" - }, - { - "shape":"NumberDomainAttributesExceeded", - "error":{ - "code":"NumberDomainAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this domain.

" - }, - { - "shape":"NumberDomainBytesExceeded", - "error":{ - "code":"NumberDomainBytesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many bytes in this domain.

" - }, - { - "shape":"NumberSubmittedItemsExceeded", - "error":{ - "code":"NumberSubmittedItemsExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many items exist in a single call.

" - }, - { - "shape":"NumberSubmittedAttributesExceeded", - "error":{ - "code":"NumberSubmittedAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes exist in a single call.

" - } - ], - "documentation":"

The BatchPutAttributes operation creates or replaces attributes within one or more items. By using this operation, the client can perform multiple PutAttribute operation with a single call. This helps yield savings in round trips and latencies, enabling Amazon SimpleDB to optimize requests and generally produce better throughput.

The client may specify the item name with the Item.X.ItemName parameter. The client may specify new attributes using a combination of the Item.X.Attribute.Y.Name and Item.X.Attribute.Y.Value parameters. The client may specify the first attribute for the first item using the parameters Item.0.Attribute.0.Name and Item.0.Attribute.0.Value, and for the second attribute for the first item by the parameters Item.0.Attribute.1.Name and Item.0.Attribute.1.Value, and so on.

Attributes are uniquely identified within an item by their name/value combination. For example, a single item can have the attributes { \"first_name\", \"first_value\" } and { \"first_name\", \"second_value\" }. However, it cannot have two attribute instances where both the Item.X.Attribute.Y.Name and Item.X.Attribute.Y.Value are the same.

Optionally, the requester can supply the Replace parameter for each individual value. Setting this value to true will cause the new attribute values to replace the existing attribute values. For example, if an item I has the attributes { 'a', '1' }, { 'b', '2'} and { 'b', '3' } and the requester does a BatchPutAttributes of {'I', 'b', '4' } with the Replace parameter set to true, the final attributes of the item will be { 'a', '1' } and { 'b', '4' }, replacing the previous values of the 'b' attribute with the new value.

This operation is vulnerable to exceeding the maximum URL size when making a REST request using the HTTP GET method. This operation does not support conditions using Expected.X.Name, Expected.X.Value, or Expected.X.Exists.

You can execute multiple BatchPutAttributes operations and other operations in parallel. However, large numbers of concurrent BatchPutAttributes calls can result in Service Unavailable (503) responses.

The following limitations are enforced for this operation:

  • 256 attribute name-value pairs per item
  • 1 MB request size
  • 1 billion attributes per domain
  • 10 GB of total user data storage per domain
  • 25 item limit per BatchPutAttributes operation

" - }, - "CreateDomain":{ - "name":"CreateDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDomainRequest"}, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NumberDomainsExceeded", - "error":{ - "code":"NumberDomainsExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many domains exist per this account.

" - } - ], - "documentation":"

The CreateDomain operation creates a new domain. The domain name should be unique among the domains associated with the Access Key ID provided in the request. The CreateDomain operation may take 10 or more seconds to complete.

The client can create up to 100 domains per account.

If the client requires additional domains, go to http://aws.amazon.com/contact-us/simpledb-limit-request/.

" - }, - "DeleteAttributes":{ - "name":"DeleteAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAttributesRequest"}, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - }, - { - "shape":"AttributeDoesNotExist", - "error":{ - "code":"AttributeDoesNotExist", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified attribute does not exist.

" - } - ], - "documentation":"

Deletes one or more attributes associated with an item. If all attributes of the item are deleted, the item is deleted.

DeleteAttributes is an idempotent operation; running it multiple times on the same item or attribute does not result in an error response.

Because Amazon SimpleDB makes multiple copies of item data and uses an eventual consistency update model, performing a GetAttributes or Select operation (read) immediately after a DeleteAttributes or PutAttributes operation (write) might not return updated item data.

" - }, - "DeleteDomain":{ - "name":"DeleteDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDomainRequest"}, - "errors":[ - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - } - ], - "documentation":"

The DeleteDomain operation deletes a domain. Any items (and their attributes) in the domain are deleted as well. The DeleteDomain operation might take 10 or more seconds to complete.

" - }, - "DomainMetadata":{ - "name":"DomainMetadata", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DomainMetadataRequest"}, - "output":{ - "shape":"DomainMetadataResult", - "resultWrapper":"DomainMetadataResult" - }, - "errors":[ - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - } - ], - "documentation":"

Returns information about the domain, including when the domain was created, the number of items and attributes in the domain, and the size of the attribute names and values.

" - }, - "GetAttributes":{ - "name":"GetAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAttributesRequest"}, - "output":{ - "shape":"GetAttributesResult", - "resultWrapper":"GetAttributesResult" - }, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - } - ], - "documentation":"

Returns all of the attributes associated with the specified item. Optionally, the attributes returned can be limited to one or more attributes by specifying an attribute name parameter.

If the item does not exist on the replica that was accessed for this operation, an empty set is returned. The system does not return an error as it cannot guarantee the item does not exist on other replicas.

" - }, - "ListDomains":{ - "name":"ListDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDomainsRequest"}, - "output":{ - "shape":"ListDomainsResult", - "resultWrapper":"ListDomainsResult" - }, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidNextToken", - "error":{ - "code":"InvalidNextToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified NextToken is not valid.

" - } - ], - "documentation":"

The ListDomains operation lists all domains associated with the Access Key ID. It returns domain names up to the limit set by MaxNumberOfDomains. A NextToken is returned if there are more than MaxNumberOfDomains domains. Calling ListDomains successive times with the NextToken provided by the operation returns up to MaxNumberOfDomains more domain names with each successive operation call.

" - }, - "PutAttributes":{ - "name":"PutAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutAttributesRequest"}, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - }, - { - "shape":"NumberDomainAttributesExceeded", - "error":{ - "code":"NumberDomainAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this domain.

" - }, - { - "shape":"NumberDomainBytesExceeded", - "error":{ - "code":"NumberDomainBytesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many bytes in this domain.

" - }, - { - "shape":"NumberItemAttributesExceeded", - "error":{ - "code":"NumberItemAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this item.

" - }, - { - "shape":"AttributeDoesNotExist", - "error":{ - "code":"AttributeDoesNotExist", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified attribute does not exist.

" - } - ], - "documentation":"

The PutAttributes operation creates or replaces attributes in an item. The client may specify new attributes using a combination of the Attribute.X.Name and Attribute.X.Value parameters. The client specifies the first attribute by the parameters Attribute.0.Name and Attribute.0.Value, the second attribute by the parameters Attribute.1.Name and Attribute.1.Value, and so on.

Attributes are uniquely identified in an item by their name/value combination. For example, a single item can have the attributes { \"first_name\", \"first_value\" } and { \"first_name\", second_value\" }. However, it cannot have two attribute instances where both the Attribute.X.Name and Attribute.X.Value are the same.

Optionally, the requestor can supply the Replace parameter for each individual attribute. Setting this value to true causes the new attribute value to replace the existing attribute value(s). For example, if an item has the attributes { 'a', '1' }, { 'b', '2'} and { 'b', '3' } and the requestor calls PutAttributes using the attributes { 'b', '4' } with the Replace parameter set to true, the final attributes of the item are changed to { 'a', '1' } and { 'b', '4' }, which replaces the previous values of the 'b' attribute with the new value.

You cannot specify an empty string as an attribute name.

Because Amazon SimpleDB makes multiple copies of client data and uses an eventual consistency update model, an immediate GetAttributes or Select operation (read) immediately after a PutAttributes or DeleteAttributes operation (write) might not return the updated data.

The following limitations are enforced for this operation:

  • 256 total attribute name-value pairs per item
  • One billion attributes per domain
  • 10 GB of total user data storage per domain

" - }, - "Select":{ - "name":"Select", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SelectRequest"}, - "output":{ - "shape":"SelectResult", - "resultWrapper":"SelectResult" - }, - "errors":[ - { - "shape":"InvalidParameterValue", - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - { - "shape":"InvalidNextToken", - "error":{ - "code":"InvalidNextToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified NextToken is not valid.

" - }, - { - "shape":"InvalidNumberPredicates", - "error":{ - "code":"InvalidNumberPredicates", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many predicates exist in the query expression.

" - }, - { - "shape":"InvalidNumberValueTests", - "error":{ - "code":"InvalidNumberValueTests", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many predicates exist in the query expression.

" - }, - { - "shape":"InvalidQueryExpression", - "error":{ - "code":"InvalidQueryExpression", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified query expression syntax is not valid.

" - }, - { - "shape":"MissingParameter", - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - { - "shape":"NoSuchDomain", - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - }, - { - "shape":"RequestTimeout", - "error":{ - "code":"RequestTimeout", - "httpStatusCode":408, - "senderFault":true - }, - "exception":true, - "documentation":"

A timeout occurred when attempting to query the specified domain with specified query expression.

" - }, - { - "shape":"TooManyRequestedAttributes", - "error":{ - "code":"TooManyRequestedAttributes", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes requested.

" - } - ], - "documentation":"

The Select operation returns a set of attributes for ItemNames that match the select expression. Select is similar to the standard SQL SELECT statement.

The total size of the response cannot exceed 1 MB in total size. Amazon SimpleDB automatically adjusts the number of items returned per page to enforce this limit. For example, if the client asks to retrieve 2500 items, but each individual item is 10 kB in size, the system returns 100 items and an appropriate NextToken so the client can access the next page of results.

For information on how to construct select expressions, see Using Select to Create Amazon SimpleDB Queries in the Developer Guide.

" - } - }, - "shapes":{ - "Attribute":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"The name of the attribute." - }, - "AlternateNameEncoding":{ - "shape":"String", - "documentation":"

" - }, - "Value":{ - "shape":"String", - "documentation":"The value of the attribute." - }, - "AlternateValueEncoding":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

" - }, - "AttributeDoesNotExist":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"AttributeDoesNotExist", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified attribute does not exist.

" - }, - "AttributeList":{ - "type":"list", - "member":{ - "shape":"Attribute", - "locationName":"Attribute" - }, - "flattened":true - }, - "AttributeNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AttributeName" - }, - "flattened":true - }, - "BatchDeleteAttributesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Items" - ], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain in which the attributes are being deleted." - }, - "Items":{ - "shape":"DeletableItemList", - "documentation":"A list of items on which to perform the operation." - } - } - }, - "BatchPutAttributesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "Items" - ], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain in which the attributes are being stored." - }, - "Items":{ - "shape":"ReplaceableItemList", - "documentation":"A list of items on which to perform the operation." - } - } - }, - "Boolean":{"type":"boolean"}, - "CreateDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain to create. The name can range between 3 and 255 characters and can contain the following characters: a-z, A-Z, 0-9, '_', '-', and '.'." - } - } - }, - "DeletableItem":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"String", - "locationName":"ItemName" - }, - "Attributes":{"shape":"AttributeList"} - } - }, - "DeletableItemList":{ - "type":"list", - "member":{ - "shape":"DeletableItem", - "locationName":"Item" - }, - "flattened":true - }, - "DeleteAttributesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "ItemName" - ], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain in which to perform the operation." - }, - "ItemName":{ - "shape":"String", - "documentation":"The name of the item. Similar to rows on a spreadsheet, items represent individual objects that contain one or more value-attribute pairs." - }, - "Attributes":{ - "shape":"AttributeList", - "documentation":"A list of Attributes. Similar to columns on a spreadsheet, attributes represent categories of data that can be assigned to items." - }, - "Expected":{ - "shape":"UpdateCondition", - "documentation":"The update condition which, if specified, determines whether the specified attributes will be deleted or not. The update condition must be satisfied in order for this request to be processed and the attributes to be deleted." - } - } - }, - "DeleteDomainRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain to delete." - } - } - }, - "DomainMetadataRequest":{ - "type":"structure", - "required":["DomainName"], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain for which to display the metadata of." - } - } - }, - "DomainMetadataResult":{ - "type":"structure", - "members":{ - "ItemCount":{ - "shape":"Integer", - "documentation":"The number of all items in the domain." - }, - "ItemNamesSizeBytes":{ - "shape":"Long", - "documentation":"The total size of all item names in the domain, in bytes." - }, - "AttributeNameCount":{ - "shape":"Integer", - "documentation":"The number of unique attribute names in the domain." - }, - "AttributeNamesSizeBytes":{ - "shape":"Long", - "documentation":"The total size of all unique attribute names in the domain, in bytes." - }, - "AttributeValueCount":{ - "shape":"Integer", - "documentation":"The number of all attribute name/value pairs in the domain." - }, - "AttributeValuesSizeBytes":{ - "shape":"Long", - "documentation":"The total size of all attribute values in the domain, in bytes." - }, - "Timestamp":{ - "shape":"Integer", - "documentation":"The data and time when metadata was calculated, in Epoch (UNIX) seconds." - } - } - }, - "DomainNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"DomainName" - }, - "flattened":true - }, - "DuplicateItemName":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"DuplicateItemName", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The item name was specified more than once.

" - }, - "Float":{"type":"float"}, - "GetAttributesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "ItemName" - ], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain in which to perform the operation." - }, - "ItemName":{ - "shape":"String", - "documentation":"The name of the item." - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"The names of the attributes." - }, - "ConsistentRead":{ - "shape":"Boolean", - "documentation":"Determines whether or not strong consistency should be enforced when data is read from SimpleDB. If true, any data previously written to SimpleDB will be returned. Otherwise, results will be consistent eventually, and the client may not see data that was written immediately before your read." - } - } - }, - "GetAttributesResult":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"AttributeList", - "documentation":"The list of attributes returned by the operation." - } - } - }, - "Integer":{"type":"integer"}, - "InvalidNextToken":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"InvalidNextToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified NextToken is not valid.

" - }, - "InvalidNumberPredicates":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"InvalidNumberPredicates", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many predicates exist in the query expression.

" - }, - "InvalidNumberValueTests":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"InvalidNumberValueTests", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many predicates exist in the query expression.

" - }, - "InvalidParameterValue":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"InvalidParameterValue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The value for a parameter is invalid.

" - }, - "InvalidQueryExpression":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"InvalidQueryExpression", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified query expression syntax is not valid.

" - }, - "Item":{ - "type":"structure", - "required":[ - "Name", - "Attributes" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"The name of the item." - }, - "AlternateNameEncoding":{ - "shape":"String", - "documentation":"

" - }, - "Attributes":{ - "shape":"AttributeList", - "documentation":"A list of attributes." - } - }, - "documentation":"

" - }, - "ItemList":{ - "type":"list", - "member":{ - "shape":"Item", - "locationName":"Item" - }, - "flattened":true - }, - "ListDomainsRequest":{ - "type":"structure", - "members":{ - "MaxNumberOfDomains":{ - "shape":"Integer", - "documentation":"The maximum number of domain names you want returned. The range is 1 to 100. The default setting is 100." - }, - "NextToken":{ - "shape":"String", - "documentation":"A string informing Amazon SimpleDB where to start the next list of domain names." - } - } - }, - "ListDomainsResult":{ - "type":"structure", - "members":{ - "DomainNames":{ - "shape":"DomainNameList", - "documentation":"A list of domain names that match the expression." - }, - "NextToken":{ - "shape":"String", - "documentation":"An opaque token indicating that there are more domains than the specified MaxNumberOfDomains still available." - } - } - }, - "Long":{"type":"long"}, - "MissingParameter":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"MissingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The request must contain the specified missing parameter.

" - }, - "NoSuchDomain":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NoSuchDomain", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

The specified domain does not exist.

" - }, - "NumberDomainAttributesExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberDomainAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this domain.

" - }, - "NumberDomainBytesExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberDomainBytesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many bytes in this domain.

" - }, - "NumberDomainsExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberDomainsExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many domains exist per this account.

" - }, - "NumberItemAttributesExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberItemAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes in this item.

" - }, - "NumberSubmittedAttributesExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberSubmittedAttributesExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes exist in a single call.

" - }, - "NumberSubmittedItemsExceeded":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"NumberSubmittedItemsExceeded", - "httpStatusCode":409, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many items exist in a single call.

" - }, - "PutAttributesRequest":{ - "type":"structure", - "required":[ - "DomainName", - "ItemName", - "Attributes" - ], - "members":{ - "DomainName":{ - "shape":"String", - "documentation":"The name of the domain in which to perform the operation." - }, - "ItemName":{ - "shape":"String", - "documentation":"The name of the item." - }, - "Attributes":{ - "shape":"ReplaceableAttributeList", - "documentation":"The list of attributes." - }, - "Expected":{ - "shape":"UpdateCondition", - "documentation":"The update condition which, if specified, determines whether the specified attributes will be updated or not. The update condition must be satisfied in order for this request to be processed and the attributes to be updated." - } - } - }, - "ReplaceableAttribute":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"The name of the replaceable attribute." - }, - "Value":{ - "shape":"String", - "documentation":"The value of the replaceable attribute." - }, - "Replace":{ - "shape":"Boolean", - "documentation":"A flag specifying whether or not to replace the attribute/value pair or to add a new attribute/value pair. The default setting is false." - } - }, - "documentation":"

" - }, - "ReplaceableAttributeList":{ - "type":"list", - "member":{ - "shape":"ReplaceableAttribute", - "locationName":"Attribute" - }, - "flattened":true - }, - "ReplaceableItem":{ - "type":"structure", - "required":[ - "Name", - "Attributes" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"The name of the replaceable item.", - "locationName":"ItemName" - }, - "Attributes":{ - "shape":"ReplaceableAttributeList", - "documentation":"The list of attributes for a replaceable item." - } - }, - "documentation":"

" - }, - "ReplaceableItemList":{ - "type":"list", - "member":{ - "shape":"ReplaceableItem", - "locationName":"Item" - }, - "flattened":true - }, - "RequestTimeout":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"RequestTimeout", - "httpStatusCode":408, - "senderFault":true - }, - "exception":true, - "documentation":"

A timeout occurred when attempting to query the specified domain with specified query expression.

" - }, - "SelectRequest":{ - "type":"structure", - "required":["SelectExpression"], - "members":{ - "SelectExpression":{ - "shape":"String", - "documentation":"The expression used to query the domain." - }, - "NextToken":{ - "shape":"String", - "documentation":"A string informing Amazon SimpleDB where to start the next list of ItemNames." - }, - "ConsistentRead":{ - "shape":"Boolean", - "documentation":"Determines whether or not strong consistency should be enforced when data is read from SimpleDB. If true, any data previously written to SimpleDB will be returned. Otherwise, results will be consistent eventually, and the client may not see data that was written immediately before your read." - } - } - }, - "SelectResult":{ - "type":"structure", - "members":{ - "Items":{ - "shape":"ItemList", - "documentation":"A list of items that match the select expression." - }, - "NextToken":{ - "shape":"String", - "documentation":"An opaque token indicating that more items than MaxNumberOfItems were matched, the response size exceeded 1 megabyte, or the execution time exceeded 5 seconds." - } - } - }, - "String":{"type":"string"}, - "TooManyRequestedAttributes":{ - "type":"structure", - "members":{ - "BoxUsage":{"shape":"Float"} - }, - "error":{ - "code":"TooManyRequestedAttributes", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true, - "documentation":"

Too many attributes requested.

" - }, - "UpdateCondition":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the attribute involved in the condition.

" - }, - "Value":{ - "shape":"String", - "documentation":"

The value of an attribute. This value can only be specified when the Exists parameter is equal to true.

" - }, - "Exists":{ - "shape":"Boolean", - "documentation":"

A value specifying whether or not the specified attribute must exist with the specified value in order for the update condition to be satisfied. Specify true if the attribute must exist for the update condition to be satisfied. Specify false if the attribute should not exist in order for the update condition to be satisfied.

" - } - }, - "documentation":"

Specifies the conditions under which data should be updated. If an update condition is specified for a request, the data will only be updated if the condition is satisfied. For example, if an attribute with a specific name and value exists, or if a specific attribute doesn't exist.

" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/service-2.json deleted file mode 100644 index 0caeac74..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/secretsmanager/2017-10-17/service-2.json +++ /dev/null @@ -1,1344 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-17", - "endpointPrefix":"secretsmanager", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Secrets Manager", - "serviceId":"Secrets Manager", - "signatureVersion":"v4", - "signingName":"secretsmanager", - "targetPrefix":"secretsmanager", - "uid":"secretsmanager-2017-10-17" - }, - "operations":{ - "CancelRotateSecret":{ - "name":"CancelRotateSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelRotateSecretRequest"}, - "output":{"shape":"CancelRotateSecretResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalServiceError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Disables automatic scheduled rotation and cancels the rotation of a secret if one is currently in progress.

To re-enable scheduled rotation, call RotateSecret with AutomaticallyRotateAfterDays set to a value greater than 0. This will immediately rotate your secret and then enable the automatic schedule.

If you cancel a rotation that is in progress, it can leave the VersionStage labels in an unexpected state. Depending on what step of the rotation was in progress, you might need to remove the staging label AWSPENDING from the partially created version, specified by the SecretVersionId response value. You should also evaluate the partially rotated new version to see if it should be deleted, which you can do by removing all staging labels from the new version's VersionStage field.

To successfully start a rotation, the staging label AWSPENDING must be in one of the following states:

  • Not be attached to any version at all

  • Attached to the same version as the staging label AWSCURRENT

If the staging label AWSPENDING is attached to a different version than the version with AWSCURRENT then the attempt to rotate fails.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:CancelRotateSecret

Related operations

  • To configure rotation for a secret or to manually trigger a rotation, use RotateSecret.

  • To get the rotation configuration details for a secret, use DescribeSecret.

  • To list all of the currently available secrets, use ListSecrets.

  • To list all of the versions currently associated with a secret, use ListSecretVersionIds.

" - }, - "CreateSecret":{ - "name":"CreateSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSecretRequest"}, - "output":{"shape":"CreateSecretResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"EncryptionFailure"}, - {"shape":"ResourceExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"InternalServiceError"}, - {"shape":"PreconditionNotMetException"} - ], - "documentation":"

Creates a new secret. A secret in Secrets Manager consists of both the protected secret data and the important information needed to manage the secret.

Secrets Manager stores the encrypted secret data in one of a collection of \"versions\" associated with the secret. Each version contains a copy of the encrypted secret data. Each version is associated with one or more \"staging labels\" that identify where the version is in the rotation cycle. The SecretVersionsToStages field of the secret contains the mapping of staging labels to the active versions of the secret. Versions without a staging label are considered deprecated and are not included in the list.

You provide the secret data to be encrypted by putting text in either the SecretString parameter or binary data in the SecretBinary parameter, but not both. If you include SecretString or SecretBinary then Secrets Manager also creates an initial secret version and automatically attaches the staging label AWSCURRENT to the new version.

  • If you call an operation that needs to encrypt or decrypt the SecretString or SecretBinary for a secret in the same account as the calling user and that secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key doesn't already exist in your account then Secrets Manager creates it for you automatically. All users in the same AWS account automatically have access to use the default CMK. Note that if an Secrets Manager API call results in AWS having to create the account's AWS-managed CMK, it can result in a one-time significant delay in returning the result.

  • If the secret is in a different AWS account from the credentials calling an API that requires encryption or decryption of the secret value then you must create and use a custom AWS KMS CMK because you can't access the default CMK for the account using credentials from a different AWS account. Store the ARN of the CMK in the secret when you create the secret or when you update it by including it in the KMSKeyId. If you call an API that must encrypt or decrypt SecretString or SecretBinary using credentials from a different account then the AWS KMS key policy must grant cross-account access to that other account's user or role for both the kms:GenerateDataKey and kms:Decrypt operations.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:CreateSecret

  • kms:GenerateDataKey - needed only if you use a customer-managed AWS KMS key to encrypt the secret. You do not need this permission to use the account's default AWS managed CMK for Secrets Manager.

  • kms:Decrypt - needed only if you use a customer-managed AWS KMS key to encrypt the secret. You do not need this permission to use the account's default AWS managed CMK for Secrets Manager.

Related operations

  • To delete a secret, use DeleteSecret.

  • To modify an existing secret, use UpdateSecret.

  • To create a new version of a secret, use PutSecretValue.

  • To retrieve the encrypted secure string and secure binary values, use GetSecretValue.

  • To retrieve all other details for a secret, use DescribeSecret. This does not include the encrypted secure string and secure binary values.

  • To retrieve the list of secret versions associated with the current secret, use DescribeSecret and examine the SecretVersionsToStages response value.

" - }, - "DeleteResourcePolicy":{ - "name":"DeleteResourcePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteResourcePolicyRequest"}, - "output":{"shape":"DeleteResourcePolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Deletes the resource-based permission policy that's attached to the secret.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:DeleteResourcePolicy

Related operations

  • To attach a resource policy to a secret, use PutResourcePolicy.

  • To retrieve the current resource-based policy that's attached to a secret, use GetResourcePolicy.

  • To list all of the currently available secrets, use ListSecrets.

" - }, - "DeleteSecret":{ - "name":"DeleteSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSecretRequest"}, - "output":{"shape":"DeleteSecretResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Deletes an entire secret and all of its versions. You can optionally include a recovery window during which you can restore the secret. If you don't specify a recovery window value, the operation defaults to 30 days. Secrets Manager attaches a DeletionDate stamp to the secret that specifies the end of the recovery window. At the end of the recovery window, Secrets Manager deletes the secret permanently.

At any time before recovery window ends, you can use RestoreSecret to remove the DeletionDate and cancel the deletion of the secret.

You cannot access the encrypted secret information in any secret that is scheduled for deletion. If you need to access that information, you must cancel the deletion with RestoreSecret and then retrieve the information.

  • There is no explicit operation to delete a version of a secret. Instead, remove all staging labels from the VersionStage field of a version. That marks the version as deprecated and allows Secrets Manager to delete it as needed. Versions that do not have any staging labels do not show up in ListSecretVersionIds unless you specify IncludeDeprecated.

  • The permanent secret deletion at the end of the waiting period is performed as a background task with low priority. There is no guarantee of a specific time after the recovery window for the actual delete operation to occur.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:DeleteSecret

Related operations

  • To create a secret, use CreateSecret.

  • To cancel deletion of a version of a secret before the recovery window has expired, use RestoreSecret.

" - }, - "DescribeSecret":{ - "name":"DescribeSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSecretRequest"}, - "output":{"shape":"DescribeSecretResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Retrieves the details of a secret. It does not include the encrypted fields. Only those fields that are populated with a value are returned in the response.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:DescribeSecret

Related operations

" - }, - "GetRandomPassword":{ - "name":"GetRandomPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRandomPasswordRequest"}, - "output":{"shape":"GetRandomPasswordResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Generates a random password of the specified complexity. This operation is intended for use in the Lambda rotation function. Per best practice, we recommend that you specify the maximum length and include every character type that the system you are generating a password for can support.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:GetRandomPassword

" - }, - "GetResourcePolicy":{ - "name":"GetResourcePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetResourcePolicyRequest"}, - "output":{"shape":"GetResourcePolicyResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Retrieves the JSON text of the resource-based policy document that's attached to the specified secret. The JSON request string input and response output are shown formatted with white space and line breaks for better readability. Submit your input as a single line JSON string.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:GetResourcePolicy

Related operations

" - }, - "GetSecretValue":{ - "name":"GetSecretValue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSecretValueRequest"}, - "output":{"shape":"GetSecretValueResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"DecryptionFailure"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Retrieves the contents of the encrypted fields SecretString or SecretBinary from the specified version of a secret, whichever contains content.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:GetSecretValue

  • kms:Decrypt - required only if you use a customer-managed AWS KMS key to encrypt the secret. You do not need this permission to use the account's default AWS managed CMK for Secrets Manager.

Related operations

  • To create a new version of the secret with different encrypted information, use PutSecretValue.

  • To retrieve the non-encrypted details for the secret, use DescribeSecret.

" - }, - "ListSecretVersionIds":{ - "name":"ListSecretVersionIds", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSecretVersionIdsRequest"}, - "output":{"shape":"ListSecretVersionIdsResponse"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Lists all of the versions attached to the specified secret. The output does not include the SecretString or SecretBinary fields. By default, the list includes only versions that have at least one staging label in VersionStage attached.

Always check the NextToken response parameter when calling any of the List* operations. These operations can occasionally return an empty or shorter than expected list of results even when there are more results available. When this happens, the NextToken response parameter contains a value to pass to the next call to the same API to request the next part of the list.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:ListSecretVersionIds

Related operations

" - }, - "ListSecrets":{ - "name":"ListSecrets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSecretsRequest"}, - "output":{"shape":"ListSecretsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidNextTokenException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Lists all of the secrets that are stored by Secrets Manager in the AWS account. To list the versions currently stored for a specific secret, use ListSecretVersionIds. The encrypted fields SecretString and SecretBinary are not included in the output. To get that information, call the GetSecretValue operation.

Always check the NextToken response parameter when calling any of the List* operations. These operations can occasionally return an empty or shorter than expected list of results even when there are more results available. When this happens, the NextToken response parameter contains a value to pass to the next call to the same API to request the next part of the list.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:ListSecrets

Related operations

" - }, - "PutResourcePolicy":{ - "name":"PutResourcePolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutResourcePolicyRequest"}, - "output":{"shape":"PutResourcePolicyResponse"}, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalServiceError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Attaches the contents of the specified resource-based permission policy to a secret. A resource-based policy is optional. Alternatively, you can use IAM identity-based policies that specify the secret's Amazon Resource Name (ARN) in the policy statement's Resources element. You can also use a combination of both identity-based and resource-based policies. The affected users and roles receive the permissions that are permitted by all of the relevant policies. For more information, see Using Resource-Based Policies for AWS Secrets Manager. For the complete description of the AWS policy syntax and grammar, see IAM JSON Policy Reference in the IAM User Guide.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:PutResourcePolicy

Related operations

  • To retrieve the resource policy that's attached to a secret, use GetResourcePolicy.

  • To delete the resource-based policy that's attached to a secret, use DeleteResourcePolicy.

  • To list all of the currently available secrets, use ListSecrets.

" - }, - "PutSecretValue":{ - "name":"PutSecretValue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutSecretValueRequest"}, - "output":{"shape":"PutSecretValueResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"EncryptionFailure"}, - {"shape":"ResourceExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Stores a new encrypted secret value in the specified secret. To do this, the operation creates a new version and attaches it to the secret. The version can contain a new SecretString value or a new SecretBinary value. You can also specify the staging labels that are initially attached to the new version.

The Secrets Manager console uses only the SecretString field. To add binary data to a secret with the SecretBinary field you must use the AWS CLI or one of the AWS SDKs.

  • If this operation creates the first version for the secret then Secrets Manager automatically attaches the staging label AWSCURRENT to the new version.

  • If another version of this secret already exists, then this operation does not automatically move any staging labels other than those that you explicitly specify in the VersionStages parameter.

  • If this operation moves the staging label AWSCURRENT from another version to this version (because you included it in the StagingLabels parameter) then Secrets Manager also automatically moves the staging label AWSPREVIOUS to the version that AWSCURRENT was removed from.

  • This operation is idempotent. If a version with a SecretVersionId with the same value as the ClientRequestToken parameter already exists and you specify the same secret data, the operation succeeds but does nothing. However, if the secret data is different, then the operation fails because you cannot modify an existing version; you can only create new ones.

  • If you call an operation that needs to encrypt or decrypt the SecretString or SecretBinary for a secret in the same account as the calling user and that secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key doesn't already exist in your account then Secrets Manager creates it for you automatically. All users in the same AWS account automatically have access to use the default CMK. Note that if an Secrets Manager API call results in AWS having to create the account's AWS-managed CMK, it can result in a one-time significant delay in returning the result.

  • If the secret is in a different AWS account from the credentials calling an API that requires encryption or decryption of the secret value then you must create and use a custom AWS KMS CMK because you can't access the default CMK for the account using credentials from a different AWS account. Store the ARN of the CMK in the secret when you create the secret or when you update it by including it in the KMSKeyId. If you call an API that must encrypt or decrypt SecretString or SecretBinary using credentials from a different account then the AWS KMS key policy must grant cross-account access to that other account's user or role for both the kms:GenerateDataKey and kms:Decrypt operations.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:PutSecretValue

  • kms:GenerateDataKey - needed only if you use a customer-managed AWS KMS key to encrypt the secret. You do not need this permission to use the account's default AWS managed CMK for Secrets Manager.

Related operations

" - }, - "RestoreSecret":{ - "name":"RestoreSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RestoreSecretRequest"}, - "output":{"shape":"RestoreSecretResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Cancels the scheduled deletion of a secret by removing the DeletedDate time stamp. This makes the secret accessible to query once again.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:RestoreSecret

Related operations

" - }, - "RotateSecret":{ - "name":"RotateSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RotateSecretRequest"}, - "output":{"shape":"RotateSecretResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalServiceError"}, - {"shape":"InvalidRequestException"} - ], - "documentation":"

Configures and starts the asynchronous process of rotating this secret. If you include the configuration parameters, the operation sets those values for the secret and then immediately starts a rotation. If you do not include the configuration parameters, the operation starts a rotation with the values already stored in the secret. After the rotation completes, the protected service and its clients all use the new version of the secret.

This required configuration information includes the ARN of an AWS Lambda function and the time between scheduled rotations. The Lambda rotation function creates a new version of the secret and creates or updates the credentials on the protected service to match. After testing the new credentials, the function marks the new secret with the staging label AWSCURRENT so that your clients all immediately begin to use the new version. For more information about rotating secrets and how to configure a Lambda function to rotate the secrets for your protected service, see Rotating Secrets in AWS Secrets Manager in the AWS Secrets Manager User Guide.

The rotation function must end with the versions of the secret in one of two states:

  • The AWSPENDING and AWSCURRENT staging labels are attached to the same version of the secret, or

  • The AWSPENDING staging label is not attached to any version of the secret.

If instead the AWSPENDING staging label is present but is not attached to the same version as AWSCURRENT then any later invocation of RotateSecret assumes that a previous rotation request is still in progress and returns an error.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:RotateSecret

  • lambda:InvokeFunction (on the function specified in the secret's metadata)

Related operations

" - }, - "TagResource":{ - "name":"TagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagResourceRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Attaches one or more tags, each consisting of a key name and a value, to the specified secret. Tags are part of the secret's overall metadata, and are not associated with any specific version of the secret. This operation only appends tags to the existing list of tags. To remove tags, you must use UntagResource.

The following basic restrictions apply to tags:

  • Maximum number of tags per secret—50

  • Maximum key length—127 Unicode characters in UTF-8

  • Maximum value length—255 Unicode characters in UTF-8

  • Tag keys and values are case sensitive.

  • Do not use the aws: prefix in your tag names or values because it is reserved for AWS use. You can't edit or delete tag names or values with this prefix. Tags with this prefix do not count against your tags per secret limit.

  • If your tagging schema will be used across multiple services and resources, remember that other services might have restrictions on allowed characters. Generally allowed characters are: letters, spaces, and numbers representable in UTF-8, plus the following special characters: + - = . _ : / @.

If you use tags as part of your security strategy, then adding or removing a tag can change permissions. If successfully completing this operation would result in you losing your permissions for this secret, then the operation is blocked and returns an Access Denied error.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:TagResource

Related operations

  • To remove one or more tags from the collection attached to a secret, use UntagResource.

  • To view the list of tags attached to a secret, use DescribeSecret.

" - }, - "UntagResource":{ - "name":"UntagResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagResourceRequest"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidRequestException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Removes one or more tags from the specified secret.

This operation is idempotent. If a requested tag is not attached to the secret, no error is returned and the secret metadata is unchanged.

If you use tags as part of your security strategy, then removing a tag can change permissions. If successfully completing this operation would result in you losing your permissions for this secret, then the operation is blocked and returns an Access Denied error.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:UntagResource

Related operations

  • To add one or more tags to the collection attached to a secret, use TagResource.

  • To view the list of tags attached to a secret, use DescribeSecret.

" - }, - "UpdateSecret":{ - "name":"UpdateSecret", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSecretRequest"}, - "output":{"shape":"UpdateSecretResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"EncryptionFailure"}, - {"shape":"ResourceExistsException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"InternalServiceError"}, - {"shape":"PreconditionNotMetException"} - ], - "documentation":"

Modifies many of the details of the specified secret. If you include a ClientRequestToken and either SecretString or SecretBinary then it also creates a new version attached to the secret.

To modify the rotation configuration of a secret, use RotateSecret instead.

The Secrets Manager console uses only the SecretString parameter and therefore limits you to encrypting and storing only a text string. To encrypt and store binary data as part of the version of a secret, you must use either the AWS CLI or one of the AWS SDKs.

  • If a version with a SecretVersionId with the same value as the ClientRequestToken parameter already exists, the operation results in an error. You cannot modify an existing version, you can only create a new version.

  • If you include SecretString or SecretBinary to create a new secret version, Secrets Manager automatically attaches the staging label AWSCURRENT to the new version.

  • If you call an operation that needs to encrypt or decrypt the SecretString or SecretBinary for a secret in the same account as the calling user and that secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key doesn't already exist in your account then Secrets Manager creates it for you automatically. All users in the same AWS account automatically have access to use the default CMK. Note that if an Secrets Manager API call results in AWS having to create the account's AWS-managed CMK, it can result in a one-time significant delay in returning the result.

  • If the secret is in a different AWS account from the credentials calling an API that requires encryption or decryption of the secret value then you must create and use a custom AWS KMS CMK because you can't access the default CMK for the account using credentials from a different AWS account. Store the ARN of the CMK in the secret when you create the secret or when you update it by including it in the KMSKeyId. If you call an API that must encrypt or decrypt SecretString or SecretBinary using credentials from a different account then the AWS KMS key policy must grant cross-account access to that other account's user or role for both the kms:GenerateDataKey and kms:Decrypt operations.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:UpdateSecret

  • kms:GenerateDataKey - needed only if you use a custom AWS KMS key to encrypt the secret. You do not need this permission to use the account's AWS managed CMK for Secrets Manager.

  • kms:Decrypt - needed only if you use a custom AWS KMS key to encrypt the secret. You do not need this permission to use the account's AWS managed CMK for Secrets Manager.

Related operations

" - }, - "UpdateSecretVersionStage":{ - "name":"UpdateSecretVersionStage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSecretVersionStageRequest"}, - "output":{"shape":"UpdateSecretVersionStageResponse"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalServiceError"} - ], - "documentation":"

Modifies the staging labels attached to a version of a secret. Staging labels are used to track a version as it progresses through the secret rotation process. You can attach a staging label to only one version of a secret at a time. If a staging label to be added is already attached to another version, then it is moved--removed from the other version first and then attached to this one. For more information about staging labels, see Staging Labels in the AWS Secrets Manager User Guide.

The staging labels that you specify in the VersionStage parameter are added to the existing list of staging labels--they don't replace it.

You can move the AWSCURRENT staging label to this version by including it in this call.

Whenever you move AWSCURRENT, Secrets Manager automatically moves the label AWSPREVIOUS to the version that AWSCURRENT was removed from.

If this action results in the last label being removed from a version, then the version is considered to be 'deprecated' and can be deleted by Secrets Manager.

Minimum permissions

To run this command, you must have the following permissions:

  • secretsmanager:UpdateSecretVersionStage

Related operations

  • To get the list of staging labels that are currently associated with a version of a secret, use DescribeSecret and examine the SecretVersionsToStages response value.

" - } - }, - "shapes":{ - "AutomaticallyRotateAfterDaysType":{ - "type":"long", - "max":1000, - "min":1 - }, - "BooleanType":{"type":"boolean"}, - "CancelRotateSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret for which you want to cancel a rotation request. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - } - } - }, - "CancelRotateSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret for which rotation was canceled.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret for which rotation was canceled.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The unique identifier of the version of the secret that was created during the rotation. This version might not be complete, and should be evaluated for possible deletion. At the very least, you should remove the VersionStage value AWSPENDING to enable this version to be deleted. Failing to clean up a cancelled rotation can block you from successfully starting future rotations.

" - } - } - }, - "ClientRequestTokenType":{ - "type":"string", - "max":64, - "min":32 - }, - "CreateSecretRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NameType", - "documentation":"

Specifies the friendly name of the new secret.

The secret name must be ASCII letters, digits, or the following characters : /_+=.@-

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenType", - "documentation":"

(Optional) If you include SecretString or SecretBinary, then an initial version is created as part of the secret, and this parameter specifies a unique identifier for the new version.

If you use the AWS CLI or one of the AWS SDK to call this operation, then you can leave this parameter empty. The CLI or SDK generates a random UUID for you and includes it as the value for this parameter in the request. If you don't use the SDK and instead generate a raw HTTP request to the Secrets Manager service endpoint, then you must generate a ClientRequestToken yourself for the new version and include that value in the request.

This value helps ensure idempotency. Secrets Manager uses this value to prevent the accidental creation of duplicate versions if there are failures and retries during a rotation. We recommend that you generate a UUID-type value to ensure uniqueness of your versions within the specified secret.

  • If the ClientRequestToken value isn't already associated with a version of the secret then a new version of the secret is created.

  • If a version with this value already exists and that version's SecretString and SecretBinary values are the same as those in the request, then the request is ignored (the operation is idempotent).

  • If a version with this value already exists and that version's SecretString and SecretBinary values are different from those in the request then the request fails because you cannot modify an existing version. Instead, use PutSecretValue to create a new version.

This value becomes the SecretVersionId of the new version.

", - "idempotencyToken":true - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

(Optional) Specifies a user-provided description of the secret.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyIdType", - "documentation":"

(Optional) Specifies the ARN, Key ID, or alias of the AWS KMS customer master key (CMK) to be used to encrypt the SecretString or SecretBinary values in the versions stored in this secret.

You can specify any of the supported ways to identify a AWS KMS key ID. If you need to reference a CMK in a different account, you can use only the key ARN or the alias ARN.

If you don't specify this value, then Secrets Manager defaults to using the AWS account's default CMK (the one named aws/secretsmanager). If a AWS KMS CMK with that name doesn't yet exist, then Secrets Manager creates it for you automatically the first time it needs to encrypt a version's SecretString or SecretBinary fields.

You can use the account's default CMK to encrypt and decrypt only if you call this operation using credentials from the same account that owns the secret. If the secret is in a different account, then you must create a custom CMK and specify the ARN in this field.

" - }, - "SecretBinary":{ - "shape":"SecretBinaryType", - "documentation":"

(Optional) Specifies binary data that you want to encrypt and store in the new version of the secret. To use this parameter in the command-line tools, we recommend that you store your binary data in a file and then use the appropriate technique for your tool to pass the contents of the file as a parameter.

Either SecretString or SecretBinary must have a value, but not both. They cannot both be empty.

This parameter is not available using the Secrets Manager console. It can be accessed only by using the AWS CLI or one of the AWS SDKs.

" - }, - "SecretString":{ - "shape":"SecretStringType", - "documentation":"

(Optional) Specifies text data that you want to encrypt and store in this new version of the secret.

Either SecretString or SecretBinary must have a value, but not both. They cannot both be empty.

If you create a secret by using the Secrets Manager console then Secrets Manager puts the protected secret text in only the SecretString parameter. The Secrets Manager console stores the information as a JSON structure of key/value pairs that the Lambda rotation function knows how to parse.

For storing multiple values, we recommend that you use a JSON text string argument and specify key/value pairs. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide. For example:

[{\"username\":\"bob\"},{\"password\":\"abc123xyz456\"}]

If your command-line tool or SDK requires quotation marks around the parameter, you should use single quotes to avoid confusion with the double quotes required in the JSON text.

" - }, - "Tags":{ - "shape":"TagListType", - "documentation":"

(Optional) Specifies a list of user-defined tags that are attached to the secret. Each tag is a \"Key\" and \"Value\" pair of strings. This operation only appends tags to the existing list of tags. To remove tags, you must use UntagResource.

  • Secrets Manager tag key names are case sensitive. A tag with the key \"ABC\" is a different tag from one with key \"abc\".

  • If you check tags in IAM policy Condition elements as part of your security strategy, then adding or removing a tag can change permissions. If the successful completion of this operation would result in you losing your permissions for this secret, then this operation is blocked and returns an Access Denied error.

This parameter requires a JSON text string argument. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide. For example:

[{\"Key\":\"CostCenter\",\"Value\":\"12345\"},{\"Key\":\"environment\",\"Value\":\"production\"}]

If your command-line tool or SDK requires quotation marks around the parameter, you should use single quotes to avoid confusion with the double quotes required in the JSON text.

The following basic restrictions apply to tags:

  • Maximum number of tags per secret—50

  • Maximum key length—127 Unicode characters in UTF-8

  • Maximum value length—255 Unicode characters in UTF-8

  • Tag keys and values are case sensitive.

  • Do not use the aws: prefix in your tag names or values because it is reserved for AWS use. You can't edit or delete tag names or values with this prefix. Tags with this prefix do not count against your tags per secret limit.

  • If your tagging schema will be used across multiple services and resources, remember that other services might have restrictions on allowed characters. Generally allowed characters are: letters, spaces, and numbers representable in UTF-8, plus the following special characters: + - = . _ : / @.

" - } - } - }, - "CreateSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The Amazon Resource Name (ARN) of the secret that you just created.

Secrets Manager automatically adds several random characters to the name at the end of the ARN when you initially create a secret. This affects only the ARN and not the actual friendly name. This ensures that if you create a new secret with the same name as an old secret that you previously deleted, then users with access to the old secret don't automatically get access to the new secret because the ARNs are different.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret that you just created.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The unique identifier that's associated with the version of the secret you just created.

" - } - } - }, - "CreatedDateType":{"type":"timestamp"}, - "DecryptionFailure":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Secrets Manager can't decrypt the protected secret text using the provided KMS key.

", - "exception":true - }, - "DeleteResourcePolicyRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to delete the attached resource-based policy for. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - } - } - }, - "DeleteResourcePolicyResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that the resource-based policy was deleted for.

" - }, - "Name":{ - "shape":"NameType", - "documentation":"

The friendly name of the secret that the resource-based policy was deleted for.

" - } - } - }, - "DeleteSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to delete. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "RecoveryWindowInDays":{ - "shape":"RecoveryWindowInDaysType", - "documentation":"

(Optional) Specifies the number of days that Secrets Manager waits before it can delete the secret.

This value can range from 7 to 30 days. The default value is 30.

", - "box":true - }, - "ForceDeleteWithoutRecovery":{ - "shape":"BooleanType", - "documentation":"

(Optional) Specifies that the secret is to be deleted immediately without any recovery window. You cannot use both this parameter and the RecoveryWindowInDays parameter in the same API call.

An asynchronous background process performs the actual deletion, so there can be a short delay before the operation completes. If you write code to delete and then immediately recreate a secret with the same name, ensure that your code includes appropriate back off and retry logic.

Use this parameter with caution. This parameter causes the operation to skip the normal waiting period before the permanent deletion that AWS would normally impose with the RecoveryWindowInDays parameter. If you delete a secret with the ForceDeleteWithouRecovery parameter, then you have no opportunity to recover the secret. It is permanently lost.

", - "box":true - } - } - }, - "DeleteSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that is now scheduled for deletion.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret that is now scheduled for deletion.

" - }, - "DeletionDate":{ - "shape":"DeletionDateType", - "documentation":"

The date and time after which this secret can be deleted by Secrets Manager and can no longer be restored. This value is the date and time of the delete request plus the number of days specified in RecoveryWindowInDays.

", - "box":true - } - } - }, - "DeletedDateType":{"type":"timestamp"}, - "DeletionDateType":{"type":"timestamp"}, - "DescribeSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

The identifier of the secret whose details you want to retrieve. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - } - } - }, - "DescribeSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The user-provided friendly name of the secret.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

The user-provided description of the secret.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyIdType", - "documentation":"

The ARN or alias of the AWS KMS customer master key (CMK) that's used to encrypt the SecretString or SecretBinary fields in each version of the secret. If you don't provide a key, then Secrets Manager defaults to encrypting the secret fields with the default AWS KMS CMK (the one named awssecretsmanager) for this account.

" - }, - "RotationEnabled":{ - "shape":"RotationEnabledType", - "documentation":"

Specifies whether automatic rotation is enabled for this secret.

To enable rotation, use RotateSecret with AutomaticallyRotateAfterDays set to a value greater than 0. To disable rotation, use CancelRotateSecret.

", - "box":true - }, - "RotationLambdaARN":{ - "shape":"RotationLambdaARNType", - "documentation":"

The ARN of a Lambda function that's invoked by Secrets Manager to rotate the secret either automatically per the schedule or manually by a call to RotateSecret.

" - }, - "RotationRules":{ - "shape":"RotationRulesType", - "documentation":"

A structure that contains the rotation configuration for this secret.

" - }, - "LastRotatedDate":{ - "shape":"LastRotatedDateType", - "documentation":"

The last date and time that the Secrets Manager rotation process for this secret was invoked.

", - "box":true - }, - "LastChangedDate":{ - "shape":"LastChangedDateType", - "documentation":"

The last date and time that this secret was modified in any way.

", - "box":true - }, - "LastAccessedDate":{ - "shape":"LastAccessedDateType", - "documentation":"

The last date that this secret was accessed. This value is truncated to midnight of the date and therefore shows only the date, not the time.

", - "box":true - }, - "DeletedDate":{ - "shape":"DeletedDateType", - "documentation":"

This value exists if the secret is scheduled for deletion. Some time after the specified date and time, Secrets Manager deletes the secret and all of its versions.

If a secret is scheduled for deletion, then its details, including the encrypted secret information, is not accessible. To cancel a scheduled deletion and restore access, use RestoreSecret.

", - "box":true - }, - "Tags":{ - "shape":"TagListType", - "documentation":"

The list of user-defined tags that are associated with the secret. To add tags to a secret, use TagResource. To remove tags, use UntagResource.

" - }, - "VersionIdsToStages":{ - "shape":"SecretVersionsToStagesMapType", - "documentation":"

A list of all of the currently assigned VersionStage staging labels and the SecretVersionId that each is attached to. Staging labels are used to keep track of the different versions during the rotation process.

A version that does not have any staging labels attached is considered deprecated and subject to deletion. Such versions are not included in this list.

" - } - } - }, - "DescriptionType":{ - "type":"string", - "max":2048 - }, - "EncryptionFailure":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

Secrets Manager can't encrypt the protected secret text using the provided KMS key. Check that the customer master key (CMK) is available, enabled, and not in an invalid state. For more information, see How Key State Affects Use of a Customer Master Key.

", - "exception":true - }, - "ErrorMessage":{"type":"string"}, - "ExcludeCharactersType":{ - "type":"string", - "max":4096, - "min":0 - }, - "ExcludeLowercaseType":{"type":"boolean"}, - "ExcludeNumbersType":{"type":"boolean"}, - "ExcludePunctuationType":{"type":"boolean"}, - "ExcludeUppercaseType":{"type":"boolean"}, - "GetRandomPasswordRequest":{ - "type":"structure", - "members":{ - "PasswordLength":{ - "shape":"PasswordLengthType", - "documentation":"

The desired length of the generated password. The default value if you do not include this parameter is 32 characters.

", - "box":true - }, - "ExcludeCharacters":{ - "shape":"ExcludeCharactersType", - "documentation":"

A string that includes characters that should not be included in the generated password. The default is that all characters from the included sets can be used.

" - }, - "ExcludeNumbers":{ - "shape":"ExcludeNumbersType", - "documentation":"

Specifies that the generated password should not include digits. The default if you do not include this switch parameter is that digits can be included.

", - "box":true - }, - "ExcludePunctuation":{ - "shape":"ExcludePunctuationType", - "documentation":"

Specifies that the generated password should not include punctuation characters. The default if you do not include this switch parameter is that punctuation characters can be included.

", - "box":true - }, - "ExcludeUppercase":{ - "shape":"ExcludeUppercaseType", - "documentation":"

Specifies that the generated password should not include uppercase letters. The default if you do not include this switch parameter is that uppercase letters can be included.

", - "box":true - }, - "ExcludeLowercase":{ - "shape":"ExcludeLowercaseType", - "documentation":"

Specifies that the generated password should not include lowercase letters. The default if you do not include this switch parameter is that lowercase letters can be included.

", - "box":true - }, - "IncludeSpace":{ - "shape":"IncludeSpaceType", - "documentation":"

Specifies that the generated password can include the space character. The default if you do not include this switch parameter is that the space character is not included.

", - "box":true - }, - "RequireEachIncludedType":{ - "shape":"RequireEachIncludedTypeType", - "documentation":"

A boolean value that specifies whether the generated password must include at least one of every allowed character type. The default value is True and the operation requires at least one of every character type.

", - "box":true - } - } - }, - "GetRandomPasswordResponse":{ - "type":"structure", - "members":{ - "RandomPassword":{ - "shape":"RandomPasswordType", - "documentation":"

A string with the generated password.

" - } - } - }, - "GetResourcePolicyRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to retrieve the attached resource-based policy for. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - } - } - }, - "GetResourcePolicyResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that the resource-based policy was retrieved for.

" - }, - "Name":{ - "shape":"NameType", - "documentation":"

The friendly name of the secret that the resource-based policy was retrieved for.

" - }, - "ResourcePolicy":{ - "shape":"NonEmptyResourcePolicyType", - "documentation":"

A JSON-formatted string that describes the permissions that are associated with the attached secret. These permissions are combined with any permissions that are associated with the user or role that attempts to access this secret. The combined permissions specify who can access the secret and what actions they can perform. For more information, see Authentication and Access Control for AWS Secrets Manager in the AWS Secrets Manager User Guide.

" - } - } - }, - "GetSecretValueRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret containing the version that you want to retrieve. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

Specifies the unique identifier of the version of the secret that you want to retrieve. If you specify this parameter then don't specify VersionStage. If you don't specify either a VersionStage or SecretVersionId then the default is to perform the operation on the version with the VersionStage value of AWSCURRENT.

This value is typically a UUID-type value with 32 hexadecimal digits.

" - }, - "VersionStage":{ - "shape":"SecretVersionStageType", - "documentation":"

Specifies the secret version that you want to retrieve by the staging label attached to the version.

Staging labels are used to keep track of different versions during the rotation process. If you use this parameter then don't specify SecretVersionId. If you don't specify either a VersionStage or SecretVersionId, then the default is to perform the operation on the version with the VersionStage value of AWSCURRENT.

" - } - } - }, - "GetSecretValueResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The unique identifier of this version of the secret.

" - }, - "SecretBinary":{ - "shape":"SecretBinaryType", - "documentation":"

The decrypted part of the protected secret information that was originally provided as binary data in the form of a byte array. The response parameter represents the binary data as a base64-encoded string.

This parameter is not used if the secret is created by the Secrets Manager console.

If you store custom information in this field of the secret, then you must code your Lambda rotation function to parse and interpret whatever you store in the SecretString or SecretBinary fields.

" - }, - "SecretString":{ - "shape":"SecretStringType", - "documentation":"

The decrypted part of the protected secret information that was originally provided as a string.

If you create this secret by using the Secrets Manager console then only the SecretString parameter contains data. Secrets Manager stores the information as a JSON structure of key/value pairs that the Lambda rotation function knows how to parse.

If you store custom information in the secret by using the CreateSecret, UpdateSecret, or PutSecretValue API operations instead of the Secrets Manager console, or by using the Other secret type in the console, then you must code your Lambda rotation function to parse and interpret those values.

" - }, - "VersionStages":{ - "shape":"SecretVersionStagesType", - "documentation":"

A list of all of the staging labels currently attached to this version of the secret.

" - }, - "CreatedDate":{ - "shape":"CreatedDateType", - "documentation":"

The date and time that this version of the secret was created.

", - "box":true - } - } - }, - "IncludeSpaceType":{"type":"boolean"}, - "InternalServiceError":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

An error occurred on the server side.

", - "exception":true, - "fault":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You provided an invalid NextToken value.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You provided an invalid value for a parameter.

", - "exception":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

You provided a parameter value that is not valid for the current state of the resource.

Possible causes:

  • You tried to perform the operation on a secret that's currently marked deleted.

  • You tried to enable rotation on a secret that doesn't already have a Lambda function ARN configured and you didn't include such an ARN as a parameter in this call.

", - "exception":true - }, - "KmsKeyIdType":{ - "type":"string", - "max":2048, - "min":0 - }, - "LastAccessedDateType":{"type":"timestamp"}, - "LastChangedDateType":{"type":"timestamp"}, - "LastRotatedDateType":{"type":"timestamp"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request failed because it would exceed one of the Secrets Manager internal limits.

", - "exception":true - }, - "ListSecretVersionIdsRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

The identifier for the secret containing the versions you want to list. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "MaxResults":{ - "shape":"MaxResultsType", - "documentation":"

(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, it defaults to a value that's specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (isn't null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Secrets Manager might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

", - "box":true - }, - "NextToken":{ - "shape":"NextTokenType", - "documentation":"

(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - }, - "IncludeDeprecated":{ - "shape":"BooleanType", - "documentation":"

(Optional) Specifies that you want the results to include versions that do not have any staging labels attached to them. Such versions are considered deprecated and are subject to deletion by Secrets Manager as needed.

", - "box":true - } - } - }, - "ListSecretVersionIdsResponse":{ - "type":"structure", - "members":{ - "Versions":{ - "shape":"SecretVersionsListType", - "documentation":"

The list of the currently available versions of the specified secret.

" - }, - "NextToken":{ - "shape":"NextTokenType", - "documentation":"

If present in the response, this value indicates that there's more output available than what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null).

" - }, - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The Amazon Resource Name (ARN) for the secret.

Secrets Manager automatically adds several random characters to the name at the end of the ARN when you initially create a secret. This affects only the ARN and not the actual friendly name. This ensures that if you create a new secret with the same name as an old secret that you previously deleted, then users with access to the old secret don't automatically get access to the new secret because the ARNs are different.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret.

" - } - } - }, - "ListSecretsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"MaxResultsType", - "documentation":"

(Optional) Limits the number of results that you want to include in the response. If you don't include this parameter, it defaults to a value that's specific to the operation. If additional items exist beyond the maximum you specify, the NextToken response element is present and has a value (isn't null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that Secrets Manager might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.

", - "box":true - }, - "NextToken":{ - "shape":"NextTokenType", - "documentation":"

(Optional) Use this parameter in a request if you receive a NextToken response in a previous request that indicates that there's more output available. In a subsequent call, set it to the value of the previous call's NextToken response to indicate where the output should continue from.

" - } - } - }, - "ListSecretsResponse":{ - "type":"structure", - "members":{ - "SecretList":{ - "shape":"SecretListType", - "documentation":"

A list of the secrets in the account.

" - }, - "NextToken":{ - "shape":"NextTokenType", - "documentation":"

If present in the response, this value indicates that there's more output available than what's included in the current response. This can occur even when the response includes no values at all, such as when you ask for a filtered view of a very long list. Use this value in the NextToken request parameter in a subsequent call to the operation to continue processing and get the next part of the output. You should repeat this until the NextToken response element comes back empty (as null).

" - } - } - }, - "MalformedPolicyDocumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The policy document that you provided isn't valid.

", - "exception":true - }, - "MaxResultsType":{ - "type":"integer", - "max":100, - "min":1 - }, - "NameType":{ - "type":"string", - "max":512, - "min":1 - }, - "NextTokenType":{ - "type":"string", - "max":4096, - "min":1 - }, - "NonEmptyResourcePolicyType":{ - "type":"string", - "max":4096, - "min":1 - }, - "PasswordLengthType":{ - "type":"long", - "max":4096, - "min":1 - }, - "PreconditionNotMetException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request failed because you did not complete all the prerequisite steps.

", - "exception":true - }, - "PutResourcePolicyRequest":{ - "type":"structure", - "required":[ - "SecretId", - "ResourcePolicy" - ], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to attach the resource-based policy to. You can specify either the ARN or the friendly name of the secret.

" - }, - "ResourcePolicy":{ - "shape":"NonEmptyResourcePolicyType", - "documentation":"

A JSON-formatted string that's constructed according to the grammar and syntax for an AWS resource-based policy. The policy in the string identifies who can access or manage this secret and its versions. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide.

" - } - } - }, - "PutResourcePolicyResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that the resource-based policy was retrieved for.

" - }, - "Name":{ - "shape":"NameType", - "documentation":"

The friendly name of the secret that the resource-based policy was retrieved for.

" - } - } - }, - "PutSecretValueRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret to which you want to add a new version. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret. The secret must already exist.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenType", - "documentation":"

(Optional) Specifies a unique identifier for the new version of the secret.

If you use the AWS CLI or one of the AWS SDK to call this operation, then you can leave this parameter empty. The CLI or SDK generates a random UUID for you and includes that in the request. If you don't use the SDK and instead generate a raw HTTP request to the Secrets Manager service endpoint, then you must generate a ClientRequestToken yourself for new versions and include that value in the request.

This value helps ensure idempotency. Secrets Manager uses this value to prevent the accidental creation of duplicate versions if there are failures and retries during the Lambda rotation function's processing. We recommend that you generate a UUID-type value to ensure uniqueness within the specified secret.

  • If the ClientRequestToken value isn't already associated with a version of the secret then a new version of the secret is created.

  • If a version with this value already exists and that version's SecretString or SecretBinary values are the same as those in the request then the request is ignored (the operation is idempotent).

  • If a version with this value already exists and that version's SecretString and SecretBinary values are different from those in the request then the request fails because you cannot modify an existing secret version. You can only create new versions to store new secret values.

This value becomes the SecretVersionId of the new version.

", - "idempotencyToken":true - }, - "SecretBinary":{ - "shape":"SecretBinaryType", - "documentation":"

(Optional) Specifies binary data that you want to encrypt and store in the new version of the secret. To use this parameter in the command-line tools, we recommend that you store your binary data in a file and then use the appropriate technique for your tool to pass the contents of the file as a parameter. Either SecretBinary or SecretString must have a value, but not both. They cannot both be empty.

This parameter is not accessible if the secret using the Secrets Manager console.

" - }, - "SecretString":{ - "shape":"SecretStringType", - "documentation":"

(Optional) Specifies text data that you want to encrypt and store in this new version of the secret. Either SecretString or SecretBinary must have a value, but not both. They cannot both be empty.

If you create this secret by using the Secrets Manager console then Secrets Manager puts the protected secret text in only the SecretString parameter. The Secrets Manager console stores the information as a JSON structure of key/value pairs that the default Lambda rotation function knows how to parse.

For storing multiple values, we recommend that you use a JSON text string argument and specify key/value pairs. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide.

For example:

[{\"username\":\"bob\"},{\"password\":\"abc123xyz456\"}]

If your command-line tool or SDK requires quotation marks around the parameter, you should use single quotes to avoid confusion with the double quotes required in the JSON text.

" - }, - "VersionStages":{ - "shape":"SecretVersionStagesType", - "documentation":"

(Optional) Specifies a list of staging labels that are attached to this version of the secret. These staging labels are used to track the versions through the rotation process by the Lambda rotation function.

A staging label must be unique to a single version of the secret. If you specify a staging label that's already associated with a different version of the same secret then that staging label is automatically removed from the other version and attached to this version.

If you do not specify a value for VersionStages then Secrets Manager automatically moves the staging label AWSCURRENT to this new version.

" - } - } - }, - "PutSecretValueResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The Amazon Resource Name (ARN) for the secret for which you just created a version.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret for which you just created or updated a version.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The unique identifier of the version of the secret you just created or updated.

" - }, - "VersionStages":{ - "shape":"SecretVersionStagesType", - "documentation":"

The list of staging labels that are currently attached to this version of the secret. Staging labels are used to track a version as it progresses through the secret rotation process.

" - } - } - }, - "RandomPasswordType":{ - "type":"string", - "max":4096, - "min":0 - }, - "RecoveryWindowInDaysType":{"type":"long"}, - "RequireEachIncludedTypeType":{"type":"boolean"}, - "ResourceExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

A resource with the ID you requested already exists.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

We can't find the resource that you asked for.

", - "exception":true - }, - "RestoreSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to restore from a previously scheduled deletion. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - } - } - }, - "RestoreSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that was restored.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret that was restored.

" - } - } - }, - "RotateSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to rotate. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenType", - "documentation":"

(Optional) Specifies a unique identifier for the new version of the secret that helps ensure idempotency.

If you use the AWS CLI or one of the AWS SDK to call this operation, then you can leave this parameter empty. The CLI or SDK generates a random UUID for you and includes that in the request for this parameter. If you don't use the SDK and instead generate a raw HTTP request to the Secrets Manager service endpoint, then you must generate a ClientRequestToken yourself for new versions and include that value in the request.

You only need to specify your own value if you are implementing your own retry logic and want to ensure that a given secret is not created twice. We recommend that you generate a UUID-type value to ensure uniqueness within the specified secret.

Secrets Manager uses this value to prevent the accidental creation of duplicate versions if there are failures and retries during the function's processing.

  • If the ClientRequestToken value isn't already associated with a version of the secret then a new version of the secret is created.

  • If a version with this value already exists and that version's SecretString and SecretBinary values are the same as the request, then the request is ignored (the operation is idempotent).

  • If a version with this value already exists and that version's SecretString and SecretBinary values are different from the request then an error occurs because you cannot modify an existing secret value.

This value becomes the SecretVersionId of the new version.

", - "idempotencyToken":true - }, - "RotationLambdaARN":{ - "shape":"RotationLambdaARNType", - "documentation":"

(Optional) Specifies the ARN of the Lambda function that can rotate the secret.

" - }, - "RotationRules":{ - "shape":"RotationRulesType", - "documentation":"

A structure that defines the rotation configuration for this secret.

" - } - } - }, - "RotateSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The ID of the new version of the secret created by the rotation started by this request.

", - "box":true - } - } - }, - "RotationEnabledType":{"type":"boolean"}, - "RotationLambdaARNType":{ - "type":"string", - "max":2048, - "min":0 - }, - "RotationRulesType":{ - "type":"structure", - "members":{ - "AutomaticallyAfterDays":{ - "shape":"AutomaticallyRotateAfterDaysType", - "documentation":"

Specifies the number of days between automatic scheduled rotations of the secret.

", - "box":true - } - }, - "documentation":"

A structure that defines the rotation configuration for the secret.

" - }, - "SecretARNType":{ - "type":"string", - "max":2048, - "min":20 - }, - "SecretBinaryType":{ - "type":"blob", - "max":4096, - "min":0, - "sensitive":true - }, - "SecretIdType":{ - "type":"string", - "max":2048, - "min":1 - }, - "SecretListEntry":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The Amazon Resource Name (ARN) of the secret.

For more information about ARNs in Secrets Manager, see Policy Resources in the AWS Secrets Manager User Guide.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret. You can use forward slashes in the name to represent a path hierarchy. For example, /prod/databases/dbserver1 could represent the secret for a server named dbserver1 in the folder databases in the folder prod.

" - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

The user-provided description of the secret.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyIdType", - "documentation":"

The ARN or alias of the AWS KMS customer master key (CMK) that's used to encrypt the SecretString and SecretBinary fields in each version of the secret. If you don't provide a key, then Secrets Manager defaults to encrypting the secret fields with the default KMS CMK (the one named awssecretsmanager) for this account.

" - }, - "RotationEnabled":{ - "shape":"RotationEnabledType", - "documentation":"

Indicated whether automatic, scheduled rotation is enabled for this secret.

", - "box":true - }, - "RotationLambdaARN":{ - "shape":"RotationLambdaARNType", - "documentation":"

The ARN of an AWS Lambda function that's invoked by Secrets Manager to rotate and expire the secret either automatically per the schedule or manually by a call to RotateSecret.

" - }, - "RotationRules":{ - "shape":"RotationRulesType", - "documentation":"

A structure that defines the rotation configuration for the secret.

" - }, - "LastRotatedDate":{ - "shape":"LastRotatedDateType", - "documentation":"

The last date and time that the rotation process for this secret was invoked.

", - "box":true - }, - "LastChangedDate":{ - "shape":"LastChangedDateType", - "documentation":"

The last date and time that this secret was modified in any way.

", - "box":true - }, - "LastAccessedDate":{ - "shape":"LastAccessedDateType", - "documentation":"

The last date that this secret was accessed. This value is truncated to midnight of the date and therefore shows only the date, not the time.

", - "box":true - }, - "DeletedDate":{ - "shape":"DeletedDateType", - "documentation":"

The date and time on which this secret was deleted. Not present on active secrets. The secret can be recovered until the number of days in the recovery window has passed, as specified in the RecoveryWindowInDays parameter of the DeleteSecret operation.

" - }, - "Tags":{ - "shape":"TagListType", - "documentation":"

The list of user-defined tags that are associated with the secret. To add tags to a secret, use TagResource. To remove tags, use UntagResource.

" - }, - "SecretVersionsToStages":{ - "shape":"SecretVersionsToStagesMapType", - "documentation":"

A list of all of the currently assigned SecretVersionStage staging labels and the SecretVersionId that each is attached to. Staging labels are used to keep track of the different versions during the rotation process.

A version that does not have any SecretVersionStage is considered deprecated and subject to deletion. Such versions are not included in this list.

" - } - }, - "documentation":"

A structure that contains the details about a secret. It does not include the encrypted SecretString and SecretBinary values. To get those values, use the GetSecretValue operation.

" - }, - "SecretListType":{ - "type":"list", - "member":{"shape":"SecretListEntry"} - }, - "SecretNameType":{ - "type":"string", - "max":256, - "min":1 - }, - "SecretStringType":{ - "type":"string", - "max":4096, - "min":0, - "sensitive":true - }, - "SecretVersionIdType":{ - "type":"string", - "max":64, - "min":32 - }, - "SecretVersionStageType":{ - "type":"string", - "max":256, - "min":1 - }, - "SecretVersionStagesType":{ - "type":"list", - "member":{"shape":"SecretVersionStageType"}, - "max":20, - "min":1 - }, - "SecretVersionsListEntry":{ - "type":"structure", - "members":{ - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

The unique version identifier of this version of the secret.

" - }, - "VersionStages":{ - "shape":"SecretVersionStagesType", - "documentation":"

An array of staging labels that are currently associated with this version of the secret.

" - }, - "LastAccessedDate":{ - "shape":"LastAccessedDateType", - "documentation":"

The date that this version of the secret was last accessed. Note that the resolution of this field is at the date level and does not include the time.

", - "box":true - }, - "CreatedDate":{ - "shape":"CreatedDateType", - "documentation":"

The date and time this version of the secret was created.

", - "box":true - } - }, - "documentation":"

A structure that contains information about one version of a secret.

" - }, - "SecretVersionsListType":{ - "type":"list", - "member":{"shape":"SecretVersionsListEntry"} - }, - "SecretVersionsToStagesMapType":{ - "type":"map", - "key":{"shape":"SecretVersionIdType"}, - "value":{"shape":"SecretVersionStagesType"} - }, - "Tag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagKeyType", - "documentation":"

The key identifier, or name, of the tag.

" - }, - "Value":{ - "shape":"TagValueType", - "documentation":"

The string value that's associated with the key of the tag.

" - } - }, - "documentation":"

A structure that contains information about a tag.

" - }, - "TagKeyListType":{ - "type":"list", - "member":{"shape":"TagKeyType"} - }, - "TagKeyType":{ - "type":"string", - "max":128, - "min":1 - }, - "TagListType":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagResourceRequest":{ - "type":"structure", - "required":[ - "SecretId", - "Tags" - ], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

The identifier for the secret that you want to attach tags to. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "Tags":{ - "shape":"TagListType", - "documentation":"

The tags to attach to the secret. Each element in the list consists of a Key and a Value.

This parameter to the API requires a JSON text string argument. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide. For the AWS CLI, you can also use the syntax: --Tags Key=\"Key1\",Value=\"Value1\",Key=\"Key2\",Value=\"Value2\"[,…]

" - } - } - }, - "TagValueType":{ - "type":"string", - "max":256, - "min":0 - }, - "UntagResourceRequest":{ - "type":"structure", - "required":[ - "SecretId", - "TagKeys" - ], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

The identifier for the secret that you want to remove tags from. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "TagKeys":{ - "shape":"TagKeyListType", - "documentation":"

A list of tag key names to remove from the secret. You don't specify the value. Both the key and its associated value are removed.

This parameter to the API requires a JSON text string argument. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide.

" - } - } - }, - "UpdateSecretRequest":{ - "type":"structure", - "required":["SecretId"], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret that you want to modify or to which you want to add a new version. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "ClientRequestToken":{ - "shape":"ClientRequestTokenType", - "documentation":"

(Optional) If you want to add a new version to the secret, this parameter specifies a unique identifier for the new version that helps ensure idempotency.

If you use the AWS CLI or one of the AWS SDK to call this operation, then you can leave this parameter empty. The CLI or SDK generates a random UUID for you and includes that in the request. If you don't use the SDK and instead generate a raw HTTP request to the Secrets Manager service endpoint, then you must generate a ClientRequestToken yourself for new versions and include that value in the request.

You typically only need to interact with this value if you implement your own retry logic and want to ensure that a given secret is not created twice. We recommend that you generate a UUID-type value to ensure uniqueness within the specified secret.

Secrets Manager uses this value to prevent the accidental creation of duplicate versions if there are failures and retries during the Lambda rotation function's processing.

  • If the ClientRequestToken value isn't already associated with a version of the secret then a new version of the secret is created.

  • If a version with this value already exists and that version's SecretString and SecretBinary values are the same as those in the request then the request is ignored (the operation is idempotent).

  • If a version with this value already exists and that version's SecretString and SecretBinary values are different from the request then an error occurs because you cannot modify an existing secret value.

This value becomes the SecretVersionId of the new version.

", - "idempotencyToken":true - }, - "Description":{ - "shape":"DescriptionType", - "documentation":"

(Optional) Specifies an updated user-provided description of the secret.

" - }, - "KmsKeyId":{ - "shape":"KmsKeyIdType", - "documentation":"

(Optional) Specifies an updated ARN or alias of the AWS KMS customer master key (CMK) to be used to encrypt the protected text in new versions of this secret.

You can only use the account's default CMK to encrypt and decrypt if you call this operation using credentials from the same account that owns the secret. If the secret is in a different account, then you must create a custom CMK and provide the ARN of that CMK in this field. The user making the call must have permissions to both the secret and the CMK in their respective accounts.

" - }, - "SecretBinary":{ - "shape":"SecretBinaryType", - "documentation":"

(Optional) Specifies updated binary data that you want to encrypt and store in the new version of the secret. To use this parameter in the command-line tools, we recommend that you store your binary data in a file and then use the appropriate technique for your tool to pass the contents of the file as a parameter. Either SecretBinary or SecretString must have a value, but not both. They cannot both be empty.

This parameter is not accessible using the Secrets Manager console.

" - }, - "SecretString":{ - "shape":"SecretStringType", - "documentation":"

(Optional) Specifies updated text data that you want to encrypt and store in this new version of the secret. Either SecretBinary or SecretString must have a value, but not both. They cannot both be empty.

If you create this secret by using the Secrets Manager console then Secrets Manager puts the protected secret text in only the SecretString parameter. The Secrets Manager console stores the information as a JSON structure of key/value pairs that the default Lambda rotation function knows how to parse.

For storing multiple values, we recommend that you use a JSON text string argument and specify key/value pairs. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters in the AWS CLI User Guide. For example:

[{\"username\":\"bob\"},{\"password\":\"abc123xyz456\"}]

If your command-line tool or SDK requires quotation marks around the parameter, you should use single quotes to avoid confusion with the double quotes required in the JSON text. You can also 'escape' the double quote character in the embedded JSON text by prefacing each with a backslash. For example, the following string is surrounded by double-quotes. All of the embedded double quotes are escaped:

\"[{\\\"username\\\":\\\"bob\\\"},{\\\"password\\\":\\\"abc123xyz456\\\"}]\"

" - } - } - }, - "UpdateSecretResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret that was updated.

Secrets Manager automatically adds several random characters to the name at the end of the ARN when you initially create a secret. This affects only the ARN and not the actual friendly name. This ensures that if you create a new secret with the same name as an old secret that you previously deleted, then users with access to the old secret don't automatically get access to the new secret because the ARNs are different.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret that was updated.

" - }, - "VersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

If a new version of the secret was created by this operation, then VersionId contains the unique identifier of the new version.

" - } - } - }, - "UpdateSecretVersionStageRequest":{ - "type":"structure", - "required":[ - "SecretId", - "VersionStage" - ], - "members":{ - "SecretId":{ - "shape":"SecretIdType", - "documentation":"

Specifies the secret with the version whose list of staging labels you want to modify. You can specify either the Amazon Resource Name (ARN) or the friendly name of the secret.

" - }, - "VersionStage":{ - "shape":"SecretVersionStageType", - "documentation":"

The list of staging labels to add to this version.

" - }, - "RemoveFromVersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

(Optional) Specifies the secret version ID of the version that the staging labels are to be removed from.

If you want to move a label to a new version, you do not have to explicitly remove it with this parameter. Adding a label using the MoveToVersionId parameter automatically removes it from the old version. However, if you do include both the \"MoveTo\" and \"RemoveFrom\" parameters, then the move is successful only if the staging labels are actually present on the \"RemoveFrom\" version. If a staging label was on a different version than \"RemoveFrom\", then the request fails.

", - "box":true - }, - "MoveToVersionId":{ - "shape":"SecretVersionIdType", - "documentation":"

(Optional) The secret version ID that you want to add the staging labels to.

If any of the staging labels are already attached to a different version of the secret, then they are automatically removed from that version before adding them to this version.

", - "box":true - } - } - }, - "UpdateSecretVersionStageResponse":{ - "type":"structure", - "members":{ - "ARN":{ - "shape":"SecretARNType", - "documentation":"

The ARN of the secret with the staging labels that were modified.

" - }, - "Name":{ - "shape":"SecretNameType", - "documentation":"

The friendly name of the secret with the staging labels that were modified.

" - } - } - } - }, - "documentation":"AWS Secrets Manager API Reference

AWS Secrets Manager is a web service that enables you to store, manage, and retrieve, secrets.

This guide provides descriptions of the Secrets Manager API. For more information about using this service, see the AWS Secrets Manager User Guide.

API Version

This version of the Secrets Manager API Reference documents the Secrets Manager API version 2017-10-17.

As an alternative to using the API directly, you can use one of the AWS SDKs, which consist of libraries and sample code for various programming languages and platforms (such as Java, Ruby, .NET, iOS, and Android). The SDKs provide a convenient way to create programmatic access to AWS Secrets Manager. For example, the SDKs take care of cryptographically signing requests, managing errors, and retrying requests automatically. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.

We recommend that you use the AWS SDKs to make programmatic API calls to Secrets Manager. However, you also can use the Secrets Manager HTTP Query API to make direct calls to the Secrets Manager web service. To learn more about the Secrets Manager HTTP Query API, see Making Query Requests in the AWS Secrets Manager User Guide.

Secrets Manager supports GET and POST requests for all actions. That is, the API doesn't require you to use GET for some actions and POST for others. However, GET requests are subject to the limitation size of a URL. Therefore, for operations that require larger sizes, use a POST request.

Support and Feedback for AWS Secrets Manager

We welcome your feedback. Send your comments to awssecretsmanager-feedback@amazon.com, or post your feedback and questions in the AWS Secrets Manager Discussion Forum. For more information about the AWS Discussion Forums, see Forums Help.

How examples are presented

The JSON that AWS Secrets Manager expects as your request parameters and that the service returns as a response to HTTP query requests are single, long strings without line breaks or white space formatting. The JSON shown in the examples is formatted with both line breaks and white space to improve readability. When example input parameters would also result in long strings that extend beyond the screen, we insert line breaks to enhance readability. You should always submit the input as a single JSON text string.

Logging API Requests

AWS Secrets Manager supports AWS CloudTrail, a service that records AWS API calls for your AWS account and delivers log files to an Amazon S3 bucket. By using information that's collected by AWS CloudTrail, you can determine which requests were successfully made to Secrets Manager, who made the request, when it was made, and so on. For more about AWS Secrets Manager and its support for AWS CloudTrail, see Logging AWS Secrets Manager Events with AWS CloudTrail in the AWS Secrets Manager User Guide. To learn more about CloudTrail, including how to turn it on and find your log files, see the AWS CloudTrail User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/service-2.json deleted file mode 100644 index a53ae81e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/serverlessrepo/2017-09-08/service-2.json +++ /dev/null @@ -1,1591 +0,0 @@ -{ - "metadata" : { - "apiVersion" : "2017-09-08", - "endpointPrefix" : "serverlessrepo", - "signingName" : "serverlessrepo", - "serviceFullName" : "AWSServerlessApplicationRepository", - "serviceId" : "ServerlessApplicationRepository", - "protocol" : "rest-json", - "jsonVersion" : "1.1", - "uid" : "serverlessrepo-2017-09-08", - "signatureVersion" : "v4" - }, - "operations" : { - "CreateApplication" : { - "name" : "CreateApplication", - "http" : { - "method" : "POST", - "requestUri" : "/applications", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateApplicationRequest" - }, - "output" : { - "shape" : "CreateApplicationResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ConflictException", - "documentation" : "

The resource already exists.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Creates an application, optionally including an AWS SAM file to create the first application version in the same call.

" - }, - "CreateApplicationVersion" : { - "name" : "CreateApplicationVersion", - "http" : { - "method" : "PUT", - "requestUri" : "/applications/{applicationId}/versions/{semanticVersion}", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateApplicationVersionRequest" - }, - "output" : { - "shape" : "CreateApplicationVersionResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ConflictException", - "documentation" : "

The resource already exists.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Creates an application version.

" - }, - "CreateCloudFormationChangeSet" : { - "name" : "CreateCloudFormationChangeSet", - "http" : { - "method" : "POST", - "requestUri" : "/applications/{applicationId}/changesets", - "responseCode" : 201 - }, - "input" : { - "shape" : "CreateCloudFormationChangeSetRequest" - }, - "output" : { - "shape" : "CreateCloudFormationChangeSetResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Creates an AWS CloudFormation change set for the given application.

" - }, - "DeleteApplication" : { - "name" : "DeleteApplication", - "http" : { - "method" : "DELETE", - "requestUri" : "/applications/{applicationId}", - "responseCode" : 204 - }, - "input" : { - "shape" : "DeleteApplicationRequest" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - }, { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "ConflictException", - "documentation" : "

The resource already exists.

" - } ], - "documentation" : "

Deletes the specified application.

" - }, - "GetApplication" : { - "name" : "GetApplication", - "http" : { - "method" : "GET", - "requestUri" : "/applications/{applicationId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApplicationRequest" - }, - "output" : { - "shape" : "GetApplicationResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Gets the specified application.

" - }, - "GetApplicationPolicy" : { - "name" : "GetApplicationPolicy", - "http" : { - "method" : "GET", - "requestUri" : "/applications/{applicationId}/policy", - "responseCode" : 200 - }, - "input" : { - "shape" : "GetApplicationPolicyRequest" - }, - "output" : { - "shape" : "GetApplicationPolicyResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Retrieves the policy for the application.

" - }, - "ListApplicationVersions" : { - "name" : "ListApplicationVersions", - "http" : { - "method" : "GET", - "requestUri" : "/applications/{applicationId}/versions", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListApplicationVersionsRequest" - }, - "output" : { - "shape" : "ListApplicationVersionsResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Lists versions for the specified application.

" - }, - "ListApplications" : { - "name" : "ListApplications", - "http" : { - "method" : "GET", - "requestUri" : "/applications", - "responseCode" : 200 - }, - "input" : { - "shape" : "ListApplicationsRequest" - }, - "output" : { - "shape" : "ListApplicationsResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Lists applications owned by the requester.

" - }, - "PutApplicationPolicy" : { - "name" : "PutApplicationPolicy", - "http" : { - "method" : "PUT", - "requestUri" : "/applications/{applicationId}/policy", - "responseCode" : 200 - }, - "input" : { - "shape" : "PutApplicationPolicyRequest" - }, - "output" : { - "shape" : "PutApplicationPolicyResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - } ], - "documentation" : "

Sets the permission policy for an application. See\n Application Permissions\n for the list of supported actions that can be used with this operation.

" - }, - "UpdateApplication" : { - "name" : "UpdateApplication", - "http" : { - "method" : "PATCH", - "requestUri" : "/applications/{applicationId}", - "responseCode" : 200 - }, - "input" : { - "shape" : "UpdateApplicationRequest" - }, - "output" : { - "shape" : "UpdateApplicationResponse", - "documentation" : "

Success

" - }, - "errors" : [ { - "shape" : "BadRequestException", - "documentation" : "

One of the parameters in the request is invalid.

" - }, { - "shape" : "InternalServerErrorException", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - }, { - "shape" : "ForbiddenException", - "documentation" : "

The client is not authenticated.

" - }, { - "shape" : "NotFoundException", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - }, { - "shape" : "TooManyRequestsException", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - }, { - "shape" : "ConflictException", - "documentation" : "

The resource already exists.

" - } ], - "documentation" : "

Updates the specified application.

" - } - }, - "shapes" : { - "Application" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to a license file of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "Version" : { - "shape" : "Version", - "locationName" : "version", - "documentation" : "

Version information about the application.

" - } - }, - "documentation" : "

Details about the application.

", - "required" : [ "Description", "Author", "ApplicationId", "Name" ] - }, - "ApplicationPage" : { - "type" : "structure", - "members" : { - "Applications" : { - "shape" : "__listOfApplicationSummary", - "locationName" : "applications", - "documentation" : "

An array of application summaries.

" - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to request the next page of results.

" - } - }, - "documentation" : "

A list of application details.

", - "required" : [ "Applications" ] - }, - "ApplicationPolicy" : { - "type" : "structure", - "members" : { - "Statements" : { - "shape" : "__listOfApplicationPolicyStatement", - "locationName" : "statements", - "documentation" : "

An array of policy statements applied to the application.

" - } - }, - "documentation" : "

Policy statements applied to the application.

", - "required" : [ "Statements" ] - }, - "ApplicationPolicyStatement" : { - "type" : "structure", - "members" : { - "Actions" : { - "shape" : "__listOf__string", - "locationName" : "actions", - "documentation" : "

See Application Permissions for the list of supported actions.

" - }, - "Principals" : { - "shape" : "__listOf__string", - "locationName" : "principals", - "documentation" : "

An AWS account ID, or * to make the application public.

" - }, - "StatementId" : { - "shape" : "__string", - "locationName" : "statementId", - "documentation" : "

A unique ID for the statement.

" - } - }, - "documentation" : "

Policy statement applied to the application.

", - "required" : [ "Principals", "Actions" ] - }, - "ApplicationSummary" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - } - }, - "documentation" : "

Summary of details about the application.

", - "required" : [ "Description", "Author", "ApplicationId", "Name" ] - }, - "ApplicationVersionPage" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to request the next page of results.

" - }, - "Versions" : { - "shape" : "__listOfVersionSummary", - "locationName" : "versions", - "documentation" : "

An array of version summaries for the application.

" - } - }, - "documentation" : "

A list of version summaries for the application.

", - "required" : [ "Versions" ] - }, - "BadRequestException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

400

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

One of the parameters in the request is invalid.

" - } - }, - "documentation" : "

One of the parameters in the request is invalid.

", - "exception" : true, - "error" : { - "httpStatusCode" : 400 - } - }, - "ChangeSetDetails" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "ChangeSetId" : { - "shape" : "__string", - "locationName" : "changeSetId", - "documentation" : "

The Amazon Resource Name (ARN) of the change set.

Length constraints: Minimum length of 1.

Pattern: ARN:[-a-zA-Z0-9:/]*

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "StackId" : { - "shape" : "__string", - "locationName" : "stackId", - "documentation" : "

The unique ID of the stack.

" - } - }, - "documentation" : "

Details of the change set.

", - "required" : [ "ChangeSetId", "ApplicationId", "StackId", "SemanticVersion" ] - }, - "ConflictException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

409

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The resource already exists.

" - } - }, - "documentation" : "

The resource already exists.

", - "exception" : true, - "error" : { - "httpStatusCode" : 409 - } - }, - "CreateApplicationInput" : { - "type" : "structure", - "members" : { - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseBody" : { - "shape" : "__string", - "locationName" : "licenseBody", - "documentation" : "

A local text file that contains the license of the app that matches the spdxLicenseID value of your application.\n The file is of the format file://<path>/<filename>.

Maximum size 5 MB

Note: Only one of licenseBody and licenseUrl can be specified, otherwise an error will result.

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to the S3 object that contains the license of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

Note: Only one of licenseBody and licenseUrl can be specified, otherwise an error will result.

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application that you want to publish.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeBody" : { - "shape" : "__string", - "locationName" : "readmeBody", - "documentation" : "

A local text readme file in Markdown language that contains a more detailed description of the application and how it works.\n The file is of the format file://<path>/<filename>.

Maximum size 5 MB

Note: Only one of readmeBody and readmeUrl can be specified, otherwise an error will result.

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the S3 object in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

Note: Only one of readmeBody and readmeUrl can be specified, otherwise an error will result.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "TemplateBody" : { - "shape" : "__string", - "locationName" : "templateBody", - "documentation" : "

The local raw packaged AWS SAM template file of your application.\n The file is of the format file://<path>/<filename>.

Note: Only one of templateBody and templateUrl can be specified, otherwise an error will result.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the S3 object cotaining the packaged AWS SAM template of your application.

Note: Only one of templateBody and templateUrl can be specified, otherwise an error will result.

" - } - }, - "documentation" : "

Create an application request.

", - "required" : [ "Description", "Name", "Author" ] - }, - "CreateApplicationRequest" : { - "type" : "structure", - "members" : { - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseBody" : { - "shape" : "__string", - "locationName" : "licenseBody", - "documentation" : "

A local text file that contains the license of the app that matches the spdxLicenseID value of your application.\n The file is of the format file://<path>/<filename>.

Maximum size 5 MB

Note: Only one of licenseBody and licenseUrl can be specified, otherwise an error will result.

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to the S3 object that contains the license of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

Note: Only one of licenseBody and licenseUrl can be specified, otherwise an error will result.

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application that you want to publish.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeBody" : { - "shape" : "__string", - "locationName" : "readmeBody", - "documentation" : "

A local text readme file in Markdown language that contains a more detailed description of the application and how it works.\n The file is of the format file://<path>/<filename>.

Maximum size 5 MB

Note: Only one of readmeBody and readmeUrl can be specified, otherwise an error will result.

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the S3 object in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

Note: Only one of readmeBody and readmeUrl can be specified, otherwise an error will result.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "TemplateBody" : { - "shape" : "__string", - "locationName" : "templateBody", - "documentation" : "

The local raw packaged AWS SAM template file of your application.\n The file is of the format file://<path>/<filename>.

Note: Only one of templateBody and templateUrl can be specified, otherwise an error will result.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the S3 object cotaining the packaged AWS SAM template of your application.

Note: Only one of templateBody and templateUrl can be specified, otherwise an error will result.

" - } - }, - "required" : [ "Description", "Name", "Author" ] - }, - "CreateApplicationResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to a license file of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "Version" : { - "shape" : "Version", - "locationName" : "version", - "documentation" : "

Version information about the application.

" - } - } - }, - "CreateApplicationVersionInput" : { - "type" : "structure", - "members" : { - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "TemplateBody" : { - "shape" : "__string", - "locationName" : "templateBody", - "documentation" : "

The raw packaged AWS SAM template of your application.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the packaged AWS SAM template of your application.

" - } - }, - "documentation" : "

Create a version request.

" - }, - "CreateApplicationVersionRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the new version.

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "TemplateBody" : { - "shape" : "__string", - "locationName" : "templateBody", - "documentation" : "

The raw packaged AWS SAM template of your application.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the packaged AWS SAM template of your application.

" - } - }, - "required" : [ "ApplicationId", "SemanticVersion" ] - }, - "CreateApplicationVersionResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "ParameterDefinitions" : { - "shape" : "__listOfParameterDefinition", - "locationName" : "parameterDefinitions", - "documentation" : "

An array of parameter types supported by the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the packaged AWS SAM template of your application.

" - } - } - }, - "CreateCloudFormationChangeSetInput" : { - "type" : "structure", - "members" : { - "ParameterOverrides" : { - "shape" : "__listOfParameterValue", - "locationName" : "parameterOverrides", - "documentation" : "

A list of parameter values for the parameters of the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "StackName" : { - "shape" : "__string", - "locationName" : "stackName", - "documentation" : "

The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates\n the change set by comparing this stack's information with the information that you submit, such as a modified\n template or different parameter input values.

Constraints: Minimum length of 1.

Pattern: ([a-zA-Z][-a-zA-Z0-9]*)|(arn:\\b(aws|aws-us-gov|aws-cn)\\b:[-a-zA-Z0-9:/._+]*)

" - } - }, - "documentation" : "

Create an application change set request.

", - "required" : [ "StackName" ] - }, - "CreateCloudFormationChangeSetRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "ParameterOverrides" : { - "shape" : "__listOfParameterValue", - "locationName" : "parameterOverrides", - "documentation" : "

A list of parameter values for the parameters of the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "StackName" : { - "shape" : "__string", - "locationName" : "stackName", - "documentation" : "

The name or the unique ID of the stack for which you are creating a change set. AWS CloudFormation generates\n the change set by comparing this stack's information with the information that you submit, such as a modified\n template or different parameter input values.

Constraints: Minimum length of 1.

Pattern: ([a-zA-Z][-a-zA-Z0-9]*)|(arn:\\b(aws|aws-us-gov|aws-cn)\\b:[-a-zA-Z0-9:/._+]*)

" - } - }, - "required" : [ "ApplicationId", "StackName" ] - }, - "CreateCloudFormationChangeSetResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "ChangeSetId" : { - "shape" : "__string", - "locationName" : "changeSetId", - "documentation" : "

The Amazon Resource Name (ARN) of the change set.

Length constraints: Minimum length of 1.

Pattern: ARN:[-a-zA-Z0-9:/]*

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "StackId" : { - "shape" : "__string", - "locationName" : "stackId", - "documentation" : "

The unique ID of the stack.

" - } - } - }, - "DeleteApplicationRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - } - }, - "required" : [ "ApplicationId" ] - }, - "ForbiddenException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

403

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The client is not authenticated.

" - } - }, - "documentation" : "

The client is not authenticated.

", - "exception" : true, - "error" : { - "httpStatusCode" : 403 - } - }, - "GetApplicationPolicyRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApplicationPolicyResponse" : { - "type" : "structure", - "members" : { - "Statements" : { - "shape" : "__listOfApplicationPolicyStatement", - "locationName" : "statements", - "documentation" : "

An array of policy statements applied to the application.

" - } - } - }, - "GetApplicationRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application to get.

" - } - }, - "required" : [ "ApplicationId" ] - }, - "GetApplicationResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to a license file of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "Version" : { - "shape" : "Version", - "locationName" : "version", - "documentation" : "

Version information about the application.

" - } - } - }, - "InternalServerErrorException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

500

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

" - } - }, - "documentation" : "

The AWS Serverless Application Repository service encountered an internal error.

", - "exception" : true, - "error" : { - "httpStatusCode" : 500 - } - }, - "ListApplicationVersionsRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "MaxItems" : { - "shape" : "MaxItems", - "location" : "querystring", - "locationName" : "maxItems", - "documentation" : "

The total number of items to return.

" - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "

A token to specify where to start paginating.

" - } - }, - "required" : [ "ApplicationId" ] - }, - "ListApplicationVersionsResponse" : { - "type" : "structure", - "members" : { - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to request the next page of results.

" - }, - "Versions" : { - "shape" : "__listOfVersionSummary", - "locationName" : "versions", - "documentation" : "

An array of version summaries for the application.

" - } - } - }, - "ListApplicationsRequest" : { - "type" : "structure", - "members" : { - "MaxItems" : { - "shape" : "MaxItems", - "location" : "querystring", - "locationName" : "maxItems", - "documentation" : "

The total number of items to return.

" - }, - "NextToken" : { - "shape" : "__string", - "location" : "querystring", - "locationName" : "nextToken", - "documentation" : "

A token to specify where to start paginating.

" - } - } - }, - "ListApplicationsResponse" : { - "type" : "structure", - "members" : { - "Applications" : { - "shape" : "__listOfApplicationSummary", - "locationName" : "applications", - "documentation" : "

An array of application summaries.

" - }, - "NextToken" : { - "shape" : "__string", - "locationName" : "nextToken", - "documentation" : "

The token to request the next page of results.

" - } - } - }, - "MaxItems" : { - "type" : "integer", - "min" : 1, - "max" : 100 - }, - "NotFoundException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

404

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

" - } - }, - "documentation" : "

The resource (for example, an access policy statement) specified in the request doesn't exist.

", - "exception" : true, - "error" : { - "httpStatusCode" : 404 - } - }, - "ParameterDefinition" : { - "type" : "structure", - "members" : { - "AllowedPattern" : { - "shape" : "__string", - "locationName" : "allowedPattern", - "documentation" : "

A regular expression that represents the patterns to allow for String types.

" - }, - "AllowedValues" : { - "shape" : "__listOf__string", - "locationName" : "allowedValues", - "documentation" : "

An array containing the list of values allowed for the parameter.

" - }, - "ConstraintDescription" : { - "shape" : "__string", - "locationName" : "constraintDescription", - "documentation" : "

A string that explains a constraint when the constraint is violated. For example, without a constraint description,\n a parameter that has an allowed pattern of [A-Za-z0-9]+ displays the following error message when the user\n specifies an invalid value:

\n Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+\n

By adding a constraint description, such as \"must contain only uppercase and lowercase letters and numbers,\" you can display\n the following customized error message:

\n Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.\n

" - }, - "DefaultValue" : { - "shape" : "__string", - "locationName" : "defaultValue", - "documentation" : "

A value of the appropriate type for the template to use if no value is specified when a stack is created.\n If you define constraints for the parameter, you must specify a value that adheres to those constraints.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

A string of up to 4,000 characters that describes the parameter.

" - }, - "MaxLength" : { - "shape" : "__integer", - "locationName" : "maxLength", - "documentation" : "

An integer value that determines the largest number of characters that you want to allow for String types.

" - }, - "MaxValue" : { - "shape" : "__integer", - "locationName" : "maxValue", - "documentation" : "

A numeric value that determines the largest numeric value that you want to allow for Number types.

" - }, - "MinLength" : { - "shape" : "__integer", - "locationName" : "minLength", - "documentation" : "

An integer value that determines the smallest number of characters that you want to allow for String types.

" - }, - "MinValue" : { - "shape" : "__integer", - "locationName" : "minValue", - "documentation" : "

A numeric value that determines the smallest numeric value that you want to allow for Number types.

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the parameter.

" - }, - "NoEcho" : { - "shape" : "__boolean", - "locationName" : "noEcho", - "documentation" : "

Whether to mask the parameter value whenever anyone makes a call that describes the stack. If you set the\n value to true, the parameter value is masked with asterisks (*****).

" - }, - "ReferencedByResources" : { - "shape" : "__listOf__string", - "locationName" : "referencedByResources", - "documentation" : "

A list of AWS SAM resources that use this parameter.

" - }, - "Type" : { - "shape" : "__string", - "locationName" : "type", - "documentation" : "

The type of the parameter.

Valid values: String | Number | List<Number> | CommaDelimitedList\n

\n String: A literal string.

For example, users can specify \"MyUserName\".

\n Number: An integer or float. AWS CloudFormation validates the parameter value as a number. However, when you use the\n parameter elsewhere in your template (for example, by using the Ref intrinsic function), the parameter value becomes a string.

For example, users might specify \"8888\".

\n List<Number>: An array of integers or floats that are separated by commas. AWS CloudFormation validates the parameter value as numbers. However, when\n you use the parameter elsewhere in your template (for example, by using the Ref intrinsic function), the parameter value becomes a list of strings.

For example, users might specify \"80,20\", and then Ref results in [\"80\",\"20\"].

\n CommaDelimitedList: An array of literal strings that are separated by commas. The total number of strings should be one more than the total number of commas.\n Also, each member string is space-trimmed.

For example, users might specify \"test,dev,prod\", and then Ref results in [\"test\",\"dev\",\"prod\"].

" - } - }, - "documentation" : "

Parameters supported by the application.

", - "required" : [ "ReferencedByResources", "Name" ] - }, - "ParameterValue" : { - "type" : "structure", - "members" : { - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The key associated with the parameter. If you don't specify a key and value for a particular parameter, AWS CloudFormation\n uses the default value that is specified in your template.

" - }, - "Value" : { - "shape" : "__string", - "locationName" : "value", - "documentation" : "

The input value associated with the parameter.

" - } - }, - "documentation" : "

Parameter value of the application.

", - "required" : [ "Value", "Name" ] - }, - "PutApplicationPolicyRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "Statements" : { - "shape" : "__listOfApplicationPolicyStatement", - "locationName" : "statements", - "documentation" : "

An array of policy statements applied to the application.

" - } - }, - "required" : [ "ApplicationId", "Statements" ] - }, - "PutApplicationPolicyResponse" : { - "type" : "structure", - "members" : { - "Statements" : { - "shape" : "__listOfApplicationPolicyStatement", - "locationName" : "statements", - "documentation" : "

An array of policy statements applied to the application.

" - } - } - }, - "TooManyRequestsException" : { - "type" : "structure", - "members" : { - "ErrorCode" : { - "shape" : "__string", - "locationName" : "errorCode", - "documentation" : "

429

" - }, - "Message" : { - "shape" : "__string", - "locationName" : "message", - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" - } - }, - "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

", - "exception" : true, - "error" : { - "httpStatusCode" : 429 - } - }, - "UpdateApplicationInput" : { - "type" : "structure", - "members" : { - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "ReadmeBody" : { - "shape" : "__string", - "locationName" : "readmeBody", - "documentation" : "

A text readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - } - }, - "documentation" : "

Update the application request.

" - }, - "UpdateApplicationRequest" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "location" : "uri", - "locationName" : "applicationId", - "documentation" : "

The Amazon Resource Name (ARN) of the application.

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "ReadmeBody" : { - "shape" : "__string", - "locationName" : "readmeBody", - "documentation" : "

A text readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - } - }, - "required" : [ "ApplicationId" ] - }, - "UpdateApplicationResponse" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "Author" : { - "shape" : "__string", - "locationName" : "author", - "documentation" : "

The name of the author publishing the app.

Minimum length=1. Maximum length=127.

Pattern \"^[a-z0-9](([a-z0-9]|-(?!-))*[a-z0-9])?$\";

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "Description" : { - "shape" : "__string", - "locationName" : "description", - "documentation" : "

The description of the application.

Minimum length=1. Maximum length=256

" - }, - "HomePageUrl" : { - "shape" : "__string", - "locationName" : "homePageUrl", - "documentation" : "

A URL with more information about the application, for example\n the location of your GitHub repository for the application.

" - }, - "Labels" : { - "shape" : "__listOf__string", - "locationName" : "labels", - "documentation" : "

Labels to improve discovery of apps in search results.

Minimum length=1. Maximum length=127. Maximum number of labels: 10

Pattern: \"^[a-zA-Z0-9+\\\\-_:\\\\/@]+$\";

" - }, - "LicenseUrl" : { - "shape" : "__string", - "locationName" : "licenseUrl", - "documentation" : "

A link to a license file of the app that matches the spdxLicenseID value of your application.

Maximum size 5 MB

" - }, - "Name" : { - "shape" : "__string", - "locationName" : "name", - "documentation" : "

The name of the application.

Minimum length=1. Maximum length=140

Pattern: \"[a-zA-Z0-9\\\\-]+\";

" - }, - "ReadmeUrl" : { - "shape" : "__string", - "locationName" : "readmeUrl", - "documentation" : "

A link to the readme file in Markdown language that contains a more detailed description of the application and how it works.

Maximum size 5 MB

" - }, - "SpdxLicenseId" : { - "shape" : "__string", - "locationName" : "spdxLicenseId", - "documentation" : "

A valid identifier from https://spdx.org/licenses/.

" - }, - "Version" : { - "shape" : "Version", - "locationName" : "version", - "documentation" : "

Version information about the application.

" - } - } - }, - "Version" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "ParameterDefinitions" : { - "shape" : "__listOfParameterDefinition", - "locationName" : "parameterDefinitions", - "documentation" : "

An array of parameter types supported by the application.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - }, - "TemplateUrl" : { - "shape" : "__string", - "locationName" : "templateUrl", - "documentation" : "

A link to the packaged AWS SAM template of your application.

" - } - }, - "documentation" : "

Application version details.

", - "required" : [ "TemplateUrl", "ParameterDefinitions", "CreationTime", "ApplicationId", "SemanticVersion" ] - }, - "VersionSummary" : { - "type" : "structure", - "members" : { - "ApplicationId" : { - "shape" : "__string", - "locationName" : "applicationId", - "documentation" : "

The application Amazon Resource Name (ARN).

" - }, - "CreationTime" : { - "shape" : "__string", - "locationName" : "creationTime", - "documentation" : "

The date and time this resource was created.

" - }, - "SemanticVersion" : { - "shape" : "__string", - "locationName" : "semanticVersion", - "documentation" : "

The semantic version of the application:

\n https://semver.org/\n

" - }, - "SourceCodeUrl" : { - "shape" : "__string", - "locationName" : "sourceCodeUrl", - "documentation" : "

A link to a public repository for the source code of your application.

" - } - }, - "documentation" : "

An application version summary.

", - "required" : [ "CreationTime", "ApplicationId", "SemanticVersion" ] - }, - "__boolean" : { - "type" : "boolean" - }, - "__double" : { - "type" : "double" - }, - "__integer" : { - "type" : "integer" - }, - "__listOfApplicationPolicyStatement" : { - "type" : "list", - "member" : { - "shape" : "ApplicationPolicyStatement" - } - }, - "__listOfApplicationSummary" : { - "type" : "list", - "member" : { - "shape" : "ApplicationSummary" - } - }, - "__listOfParameterDefinition" : { - "type" : "list", - "member" : { - "shape" : "ParameterDefinition" - } - }, - "__listOfParameterValue" : { - "type" : "list", - "member" : { - "shape" : "ParameterValue" - } - }, - "__listOfVersionSummary" : { - "type" : "list", - "member" : { - "shape" : "VersionSummary" - } - }, - "__listOf__string" : { - "type" : "list", - "member" : { - "shape" : "__string" - } - }, - "__long" : { - "type" : "long" - }, - "__string" : { - "type" : "string" - } - }, - "documentation" : "

The AWS Serverless Application Repository makes it easy for developers and enterprises to quickly find\n and deploy serverless applications in the AWS Cloud. For more information about serverless applications,\n see Serverless Computing and Applications on the AWS website.

The AWS Serverless Application Repository is deeply integrated with the AWS Lambda console, so that developers of \n all levels can get started with serverless computing without needing to learn anything new. You can use category \n keywords to browse for applications such as web and mobile backends, data processing applications, or chatbots. \n You can also search for applications by name, publisher, or event source. To use an application, you simply choose it, \n configure any required fields, and deploy it with a few clicks.

You can also easily publish applications, sharing them publicly with the community at large, or privately\n within your team or across your organization. To publish a serverless application (or app), you can use the\n AWS Management Console, AWS Command Line Interface (AWS CLI), or AWS SDKs to upload the code. Along with the\n code, you upload a simple manifest file, also known as the AWS Serverless Application Model (AWS SAM) template.\n For more information about AWS SAM, see AWS Serverless Application Model (AWS SAM) on the AWS Labs\n GitHub repository.

The AWS Serverless Application Repository Developer Guide contains more information about the two developer\n experiences available:

    \n
  • \n

    Consuming Applications – Browse for applications and view information about them, including\n source code and readme files. Also install, configure, and deploy applications of your choosing.

    \n

    Publishing Applications – Configure and upload applications to make them available to other\n developers, and publish new versions of applications.

    \n
  • \n
" -} \ No newline at end of file diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/paginators-1.json deleted file mode 100644 index bb399615..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/paginators-1.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "pagination": { - "SearchProductsAsAdmin": { - "result_key": "ProductViewDetails", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListAcceptedPortfolioShares": { - "result_key": "PortfolioDetails", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListPortfolios": { - "result_key": "PortfolioDetails", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListConstraintsForPortfolio": { - "result_key": "ConstraintDetails", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListLaunchPaths": { - "result_key": "LaunchPathSummaries", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListTagOptions": { - "result_key": "TagOptionDetails", - "output_token": "PageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListPortfoliosForProduct": { - "result_key": "PortfolioDetails", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListPrincipalsForPortfolio": { - "result_key": "Principals", - "output_token": "NextPageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - }, - "ListResourcesForTagOption": { - "result_key": "ResourceDetails", - "output_token": "PageToken", - "input_token": "PageToken", - "limit_key": "PageSize" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/service-2.json deleted file mode 100644 index 2278c957..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicecatalog/2015-12-10/service-2.json +++ /dev/null @@ -1,4523 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-12-10", - "endpointPrefix":"servicecatalog", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Service Catalog", - "serviceId":"Service Catalog", - "signatureVersion":"v4", - "targetPrefix":"AWS242ServiceCatalogService", - "uid":"servicecatalog-2015-12-10" - }, - "operations":{ - "AcceptPortfolioShare":{ - "name":"AcceptPortfolioShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AcceptPortfolioShareInput"}, - "output":{"shape":"AcceptPortfolioShareOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Accepts an offer to share the specified portfolio.

" - }, - "AssociatePrincipalWithPortfolio":{ - "name":"AssociatePrincipalWithPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociatePrincipalWithPortfolioInput"}, - "output":{"shape":"AssociatePrincipalWithPortfolioOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Associates the specified principal ARN with the specified portfolio.

" - }, - "AssociateProductWithPortfolio":{ - "name":"AssociateProductWithPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateProductWithPortfolioInput"}, - "output":{"shape":"AssociateProductWithPortfolioOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Associates the specified product with the specified portfolio.

" - }, - "AssociateTagOptionWithResource":{ - "name":"AssociateTagOptionWithResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateTagOptionWithResourceInput"}, - "output":{"shape":"AssociateTagOptionWithResourceOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"}, - {"shape":"LimitExceededException"}, - {"shape":"DuplicateResourceException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Associate the specified TagOption with the specified portfolio or product.

" - }, - "CopyProduct":{ - "name":"CopyProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CopyProductInput"}, - "output":{"shape":"CopyProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Copies the specified source product to the specified target product or a new product.

You can copy a product to the same account or another account. You can copy a product to the same region or another region.

This operation is performed asynchronously. To track the progress of the operation, use DescribeCopyProductStatus.

" - }, - "CreateConstraint":{ - "name":"CreateConstraint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConstraintInput"}, - "output":{"shape":"CreateConstraintOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"}, - {"shape":"LimitExceededException"}, - {"shape":"DuplicateResourceException"} - ], - "documentation":"

Creates a constraint.

" - }, - "CreatePortfolio":{ - "name":"CreatePortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePortfolioInput"}, - "output":{"shape":"CreatePortfolioOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"LimitExceededException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Creates a portfolio.

" - }, - "CreatePortfolioShare":{ - "name":"CreatePortfolioShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePortfolioShareInput"}, - "output":{"shape":"CreatePortfolioShareOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Shares the specified portfolio with the specified account.

" - }, - "CreateProduct":{ - "name":"CreateProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProductInput"}, - "output":{"shape":"CreateProductOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"LimitExceededException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Creates a product.

" - }, - "CreateProvisionedProductPlan":{ - "name":"CreateProvisionedProductPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProvisionedProductPlanInput"}, - "output":{"shape":"CreateProvisionedProductPlanOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Creates a plan. A plan includes the list of resources to be created (when provisioning a new product) or modified (when updating a provisioned product) when the plan is executed.

You can create one plan per provisioned product. To create a plan for an existing provisioned product, the product status must be AVAILBLE or TAINTED.

To view the resource changes in the change set, use DescribeProvisionedProductPlan. To create or modify the provisioned product, use ExecuteProvisionedProductPlan.

" - }, - "CreateProvisioningArtifact":{ - "name":"CreateProvisioningArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProvisioningArtifactInput"}, - "output":{"shape":"CreateProvisioningArtifactOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a provisioning artifact (also known as a version) for the specified product.

You cannot create a provisioning artifact for a product that was shared with you.

" - }, - "CreateTagOption":{ - "name":"CreateTagOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagOptionInput"}, - "output":{"shape":"CreateTagOptionOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"DuplicateResourceException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a TagOption.

" - }, - "DeleteConstraint":{ - "name":"DeleteConstraint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConstraintInput"}, - "output":{"shape":"DeleteConstraintOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Deletes the specified constraint.

" - }, - "DeletePortfolio":{ - "name":"DeletePortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePortfolioInput"}, - "output":{"shape":"DeletePortfolioOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"}, - {"shape":"ResourceInUseException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Deletes the specified portfolio.

You cannot delete a portfolio if it was shared with you or if it has associated products, users, constraints, or shared accounts.

" - }, - "DeletePortfolioShare":{ - "name":"DeletePortfolioShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePortfolioShareInput"}, - "output":{"shape":"DeletePortfolioShareOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Stops sharing the specified portfolio with the specified account.

" - }, - "DeleteProduct":{ - "name":"DeleteProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProductInput"}, - "output":{"shape":"DeleteProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidParametersException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Deletes the specified product.

You cannot delete a product if it was shared with you or is associated with a portfolio.

" - }, - "DeleteProvisionedProductPlan":{ - "name":"DeleteProvisionedProductPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProvisionedProductPlanInput"}, - "output":{"shape":"DeleteProvisionedProductPlanOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes the specified plan.

" - }, - "DeleteProvisioningArtifact":{ - "name":"DeleteProvisioningArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProvisioningArtifactInput"}, - "output":{"shape":"DeleteProvisioningArtifactOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Deletes the specified provisioning artifact (also known as a version) for the specified product.

You cannot delete a provisioning artifact associated with a product that was shared with you. You cannot delete the last provisioning artifact for a product, because a product must have at least one provisioning artifact.

" - }, - "DeleteTagOption":{ - "name":"DeleteTagOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagOptionInput"}, - "output":{"shape":"DeleteTagOptionOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceInUseException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Deletes the specified TagOption.

You cannot delete a TagOption if it is associated with a product or portfolio.

" - }, - "DescribeConstraint":{ - "name":"DescribeConstraint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConstraintInput"}, - "output":{"shape":"DescribeConstraintOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified constraint.

" - }, - "DescribeCopyProductStatus":{ - "name":"DescribeCopyProductStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCopyProductStatusInput"}, - "output":{"shape":"DescribeCopyProductStatusOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets the status of the specified copy product operation.

" - }, - "DescribePortfolio":{ - "name":"DescribePortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePortfolioInput"}, - "output":{"shape":"DescribePortfolioOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified portfolio.

" - }, - "DescribeProduct":{ - "name":"DescribeProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProductInput"}, - "output":{"shape":"DescribeProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the specified product.

" - }, - "DescribeProductAsAdmin":{ - "name":"DescribeProductAsAdmin", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProductAsAdminInput"}, - "output":{"shape":"DescribeProductAsAdminOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified product. This operation is run with administrator access.

" - }, - "DescribeProductView":{ - "name":"DescribeProductView", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProductViewInput"}, - "output":{"shape":"DescribeProductViewOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the specified product.

" - }, - "DescribeProvisionedProduct":{ - "name":"DescribeProvisionedProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProvisionedProductInput"}, - "output":{"shape":"DescribeProvisionedProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified provisioned product.

" - }, - "DescribeProvisionedProductPlan":{ - "name":"DescribeProvisionedProductPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProvisionedProductPlanInput"}, - "output":{"shape":"DescribeProvisionedProductPlanOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the resource changes for the specified plan.

" - }, - "DescribeProvisioningArtifact":{ - "name":"DescribeProvisioningArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProvisioningArtifactInput"}, - "output":{"shape":"DescribeProvisioningArtifactOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified provisioning artifact (also known as a version) for the specified product.

" - }, - "DescribeProvisioningParameters":{ - "name":"DescribeProvisioningParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProvisioningParametersInput"}, - "output":{"shape":"DescribeProvisioningParametersOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the configuration required to provision the specified product using the specified provisioning artifact.

If the output contains a TagOption key with an empty list of values, there is a TagOption conflict for that key. The end user cannot take action to fix the conflict, and launch is not blocked. In subsequent calls to ProvisionProduct, do not include conflicted TagOption keys as tags, or this causes the error \"Parameter validation failed: Missing required parameter in Tags[N]:Value\". Tag the provisioned product with the value sc-tagoption-conflict-portfolioId-productId.

" - }, - "DescribeRecord":{ - "name":"DescribeRecord", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeRecordInput"}, - "output":{"shape":"DescribeRecordOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified request operation.

Use this operation after calling a request operation (for example, ProvisionProduct, TerminateProvisionedProduct, or UpdateProvisionedProduct).

" - }, - "DescribeTagOption":{ - "name":"DescribeTagOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagOptionInput"}, - "output":{"shape":"DescribeTagOptionOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Gets information about the specified TagOption.

" - }, - "DisassociatePrincipalFromPortfolio":{ - "name":"DisassociatePrincipalFromPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociatePrincipalFromPortfolioInput"}, - "output":{"shape":"DisassociatePrincipalFromPortfolioOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociates a previously associated principal ARN from a specified portfolio.

" - }, - "DisassociateProductFromPortfolio":{ - "name":"DisassociateProductFromPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateProductFromPortfolioInput"}, - "output":{"shape":"DisassociateProductFromPortfolioOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Disassociates the specified product from the specified portfolio.

" - }, - "DisassociateTagOptionFromResource":{ - "name":"DisassociateTagOptionFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateTagOptionFromResourceInput"}, - "output":{"shape":"DisassociateTagOptionFromResourceOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Disassociates the specified TagOption from the specified resource.

" - }, - "ExecuteProvisionedProductPlan":{ - "name":"ExecuteProvisionedProductPlan", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ExecuteProvisionedProductPlanInput"}, - "output":{"shape":"ExecuteProvisionedProductPlanOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidStateException"} - ], - "documentation":"

Provisions or modifies a product based on the resource changes for the specified plan.

" - }, - "ListAcceptedPortfolioShares":{ - "name":"ListAcceptedPortfolioShares", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAcceptedPortfolioSharesInput"}, - "output":{"shape":"ListAcceptedPortfolioSharesOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists all portfolios for which sharing was accepted by this account.

" - }, - "ListConstraintsForPortfolio":{ - "name":"ListConstraintsForPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListConstraintsForPortfolioInput"}, - "output":{"shape":"ListConstraintsForPortfolioOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the constraints for the specified portfolio and product.

" - }, - "ListLaunchPaths":{ - "name":"ListLaunchPaths", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListLaunchPathsInput"}, - "output":{"shape":"ListLaunchPathsOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the paths to the specified product. A path is how the user has access to a specified product, and is necessary when provisioning a product. A path also determines the constraints put on the product.

" - }, - "ListPortfolioAccess":{ - "name":"ListPortfolioAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPortfolioAccessInput"}, - "output":{"shape":"ListPortfolioAccessOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the account IDs that have access to the specified portfolio.

" - }, - "ListPortfolios":{ - "name":"ListPortfolios", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPortfoliosInput"}, - "output":{"shape":"ListPortfoliosOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists all portfolios in the catalog.

" - }, - "ListPortfoliosForProduct":{ - "name":"ListPortfoliosForProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPortfoliosForProductInput"}, - "output":{"shape":"ListPortfoliosForProductOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists all portfolios that the specified product is associated with.

" - }, - "ListPrincipalsForPortfolio":{ - "name":"ListPrincipalsForPortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPrincipalsForPortfolioInput"}, - "output":{"shape":"ListPrincipalsForPortfolioOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists all principal ARNs associated with the specified portfolio.

" - }, - "ListProvisionedProductPlans":{ - "name":"ListProvisionedProductPlans", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProvisionedProductPlansInput"}, - "output":{"shape":"ListProvisionedProductPlansOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the plans for the specified provisioned product or all plans to which the user has access.

" - }, - "ListProvisioningArtifacts":{ - "name":"ListProvisioningArtifacts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProvisioningArtifactsInput"}, - "output":{"shape":"ListProvisioningArtifactsOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists all provisioning artifacts (also known as versions) for the specified product.

" - }, - "ListRecordHistory":{ - "name":"ListRecordHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRecordHistoryInput"}, - "output":{"shape":"ListRecordHistoryOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the specified requests or all performed requests.

" - }, - "ListResourcesForTagOption":{ - "name":"ListResourcesForTagOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourcesForTagOptionInput"}, - "output":{"shape":"ListResourcesForTagOptionOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the resources associated with the specified TagOption.

" - }, - "ListTagOptions":{ - "name":"ListTagOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagOptionsInput"}, - "output":{"shape":"ListTagOptionsOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the specified TagOptions or all TagOptions.

" - }, - "ProvisionProduct":{ - "name":"ProvisionProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ProvisionProductInput"}, - "output":{"shape":"ProvisionProductOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"DuplicateResourceException"} - ], - "documentation":"

Provisions the specified product.

A provisioned product is a resourced instance of a product. For example, provisioning a product based on a CloudFormation template launches a CloudFormation stack and its underlying resources. You can check the status of this request using DescribeRecord.

If the request contains a tag key with an empty list of values, there is a tag conflict for that key. Do not include conflicted keys as tags, or this causes the error \"Parameter validation failed: Missing required parameter in Tags[N]:Value\".

" - }, - "RejectPortfolioShare":{ - "name":"RejectPortfolioShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RejectPortfolioShareInput"}, - "output":{"shape":"RejectPortfolioShareOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Rejects an offer to share the specified portfolio.

" - }, - "ScanProvisionedProducts":{ - "name":"ScanProvisionedProducts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ScanProvisionedProductsInput"}, - "output":{"shape":"ScanProvisionedProductsOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Lists the provisioned products that are available (not terminated).

To use additional filtering, see SearchProvisionedProducts.

" - }, - "SearchProducts":{ - "name":"SearchProducts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchProductsInput"}, - "output":{"shape":"SearchProductsOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the products to which the caller has access.

" - }, - "SearchProductsAsAdmin":{ - "name":"SearchProductsAsAdmin", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchProductsAsAdminInput"}, - "output":{"shape":"SearchProductsAsAdminOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the products for the specified portfolio or all products.

" - }, - "SearchProvisionedProducts":{ - "name":"SearchProvisionedProducts", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SearchProvisionedProductsInput"}, - "output":{"shape":"SearchProvisionedProductsOutput"}, - "errors":[ - {"shape":"InvalidParametersException"} - ], - "documentation":"

Gets information about the provisioned products that meet the specified criteria.

" - }, - "TerminateProvisionedProduct":{ - "name":"TerminateProvisionedProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateProvisionedProductInput"}, - "output":{"shape":"TerminateProvisionedProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Terminates the specified provisioned product.

This operation does not delete any records associated with the provisioned product.

You can check the status of this request using DescribeRecord.

" - }, - "UpdateConstraint":{ - "name":"UpdateConstraint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConstraintInput"}, - "output":{"shape":"UpdateConstraintOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Updates the specified constraint.

" - }, - "UpdatePortfolio":{ - "name":"UpdatePortfolio", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePortfolioInput"}, - "output":{"shape":"UpdatePortfolioOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Updates the specified portfolio.

You cannot update a product that was shared with you.

" - }, - "UpdateProduct":{ - "name":"UpdateProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProductInput"}, - "output":{"shape":"UpdateProductOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"}, - {"shape":"TagOptionNotMigratedException"} - ], - "documentation":"

Updates the specified product.

" - }, - "UpdateProvisionedProduct":{ - "name":"UpdateProvisionedProduct", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProvisionedProductInput"}, - "output":{"shape":"UpdateProvisionedProductOutput"}, - "errors":[ - {"shape":"InvalidParametersException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Requests updates to the configuration of the specified provisioned product.

If there are tags associated with the object, they cannot be updated or added. Depending on the specific updates requested, this operation can update with no interruption, with some interruption, or replace the provisioned product entirely.

You can check the status of this request using DescribeRecord.

" - }, - "UpdateProvisioningArtifact":{ - "name":"UpdateProvisioningArtifact", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateProvisioningArtifactInput"}, - "output":{"shape":"UpdateProvisioningArtifactOutput"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Updates the specified provisioning artifact (also known as a version) for the specified product.

You cannot update a provisioning artifact for a product that was shared with you.

" - }, - "UpdateTagOption":{ - "name":"UpdateTagOption", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTagOptionInput"}, - "output":{"shape":"UpdateTagOptionOutput"}, - "errors":[ - {"shape":"TagOptionNotMigratedException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"DuplicateResourceException"}, - {"shape":"InvalidParametersException"} - ], - "documentation":"

Updates the specified TagOption.

" - } - }, - "shapes":{ - "AcceptLanguage":{"type":"string"}, - "AcceptPortfolioShareInput":{ - "type":"structure", - "required":["PortfolioId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "AcceptPortfolioShareOutput":{ - "type":"structure", - "members":{ - } - }, - "AccessLevelFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"AccessLevelFilterKey", - "documentation":"

The access level.

  • Account - Filter results based on the account.

  • Role - Filter results based on the federated role of the specified user.

  • User - Filter results based on the specified user.

" - }, - "Value":{ - "shape":"AccessLevelFilterValue", - "documentation":"

The user to which the access level applies. The only supported value is Self.

" - } - }, - "documentation":"

The access level to use to filter results.

" - }, - "AccessLevelFilterKey":{ - "type":"string", - "enum":[ - "Account", - "Role", - "User" - ] - }, - "AccessLevelFilterValue":{"type":"string"}, - "AccountId":{ - "type":"string", - "pattern":"^[0-9]{12}$" - }, - "AccountIds":{ - "type":"list", - "member":{"shape":"AccountId"} - }, - "AddTags":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":20 - }, - "AllowedValue":{"type":"string"}, - "AllowedValues":{ - "type":"list", - "member":{"shape":"AllowedValue"} - }, - "ApproximateCount":{"type":"integer"}, - "AssociatePrincipalWithPortfolioInput":{ - "type":"structure", - "required":[ - "PortfolioId", - "PrincipalARN", - "PrincipalType" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "PrincipalARN":{ - "shape":"PrincipalARN", - "documentation":"

The ARN of the principal (IAM user, role, or group).

" - }, - "PrincipalType":{ - "shape":"PrincipalType", - "documentation":"

The principal type. The supported value is IAM.

" - } - } - }, - "AssociatePrincipalWithPortfolioOutput":{ - "type":"structure", - "members":{ - } - }, - "AssociateProductWithPortfolioInput":{ - "type":"structure", - "required":[ - "ProductId", - "PortfolioId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "SourcePortfolioId":{ - "shape":"Id", - "documentation":"

The identifier of the source portfolio.

" - } - } - }, - "AssociateProductWithPortfolioOutput":{ - "type":"structure", - "members":{ - } - }, - "AssociateTagOptionWithResourceInput":{ - "type":"structure", - "required":[ - "ResourceId", - "TagOptionId" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource identifier.

" - }, - "TagOptionId":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - } - } - }, - "AssociateTagOptionWithResourceOutput":{ - "type":"structure", - "members":{ - } - }, - "AttributeValue":{"type":"string"}, - "CausingEntity":{"type":"string"}, - "ChangeAction":{ - "type":"string", - "enum":[ - "ADD", - "MODIFY", - "REMOVE" - ] - }, - "CloudWatchDashboard":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"CloudWatchDashboardName", - "documentation":"

The name of the CloudWatch dashboard.

" - } - }, - "documentation":"

Information about a CloudWatch dashboard.

" - }, - "CloudWatchDashboardName":{"type":"string"}, - "CloudWatchDashboards":{ - "type":"list", - "member":{"shape":"CloudWatchDashboard"} - }, - "ConstraintDescription":{ - "type":"string", - "max":2000 - }, - "ConstraintDetail":{ - "type":"structure", - "members":{ - "ConstraintId":{ - "shape":"Id", - "documentation":"

The identifier of the constraint.

" - }, - "Type":{ - "shape":"ConstraintType", - "documentation":"

The type of constraint.

  • LAUNCH

  • NOTIFICATION

  • TEMPLATE

" - }, - "Description":{ - "shape":"ConstraintDescription", - "documentation":"

The description of the constraint.

" - }, - "Owner":{ - "shape":"AccountId", - "documentation":"

The owner of the constraint.

" - } - }, - "documentation":"

Information about a constraint.

" - }, - "ConstraintDetails":{ - "type":"list", - "member":{"shape":"ConstraintDetail"} - }, - "ConstraintParameters":{"type":"string"}, - "ConstraintSummaries":{ - "type":"list", - "member":{"shape":"ConstraintSummary"} - }, - "ConstraintSummary":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"ConstraintType", - "documentation":"

The type of constraint.

  • LAUNCH

  • NOTIFICATION

  • TEMPLATE

" - }, - "Description":{ - "shape":"ConstraintDescription", - "documentation":"

The description of the constraint.

" - } - }, - "documentation":"

Summary information about a constraint.

" - }, - "ConstraintType":{ - "type":"string", - "max":1024, - "min":1 - }, - "CopyOption":{ - "type":"string", - "enum":["CopyTags"] - }, - "CopyOptions":{ - "type":"list", - "member":{"shape":"CopyOption"} - }, - "CopyProductInput":{ - "type":"structure", - "required":[ - "SourceProductArn", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "SourceProductArn":{ - "shape":"ProductArn", - "documentation":"

The Amazon Resource Name (ARN) of the source product.

" - }, - "TargetProductId":{ - "shape":"Id", - "documentation":"

The identifier of the target product. By default, a new product is created.

" - }, - "TargetProductName":{ - "shape":"ProductViewName", - "documentation":"

A name for the target product. The default is the name of the source product.

" - }, - "SourceProvisioningArtifactIdentifiers":{ - "shape":"SourceProvisioningArtifactProperties", - "documentation":"

The identifiers of the provisioning artifacts (also known as versions) of the product to copy. By default, all provisioning artifacts are copied.

" - }, - "CopyOptions":{ - "shape":"CopyOptions", - "documentation":"

The copy options. If the value is CopyTags, the tags from the source product are copied to the target product.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "CopyProductOutput":{ - "type":"structure", - "members":{ - "CopyProductToken":{ - "shape":"Id", - "documentation":"

The token to use to track the progress of the operation.

" - } - } - }, - "CopyProductStatus":{ - "type":"string", - "enum":[ - "SUCCEEDED", - "IN_PROGRESS", - "FAILED" - ] - }, - "CreateConstraintInput":{ - "type":"structure", - "required":[ - "PortfolioId", - "ProductId", - "Parameters", - "Type", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "Parameters":{ - "shape":"ConstraintParameters", - "documentation":"

The constraint parameters, in JSON format. The syntax depends on the constraint type as follows:

LAUNCH

Specify the RoleArn property as follows:

\\\"RoleArn\\\" : \\\"arn:aws:iam::123456789012:role/LaunchRole\\\"

NOTIFICATION

Specify the NotificationArns property as follows:

\\\"NotificationArns\\\" : [\\\"arn:aws:sns:us-east-1:123456789012:Topic\\\"]

TEMPLATE

Specify the Rules property. For more information, see Template Constraint Rules.

" - }, - "Type":{ - "shape":"ConstraintType", - "documentation":"

The type of constraint.

  • LAUNCH

  • NOTIFICATION

  • TEMPLATE

" - }, - "Description":{ - "shape":"ConstraintDescription", - "documentation":"

The description of the constraint.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "CreateConstraintOutput":{ - "type":"structure", - "members":{ - "ConstraintDetail":{ - "shape":"ConstraintDetail", - "documentation":"

Information about the constraint.

" - }, - "ConstraintParameters":{ - "shape":"ConstraintParameters", - "documentation":"

The constraint parameters.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "CreatePortfolioInput":{ - "type":"structure", - "required":[ - "DisplayName", - "ProviderName", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "DisplayName":{ - "shape":"PortfolioDisplayName", - "documentation":"

The name to use for display purposes.

" - }, - "Description":{ - "shape":"PortfolioDescription", - "documentation":"

The description of the portfolio.

" - }, - "ProviderName":{ - "shape":"ProviderName", - "documentation":"

The name of the portfolio provider.

" - }, - "Tags":{ - "shape":"AddTags", - "documentation":"

One or more tags.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "CreatePortfolioOutput":{ - "type":"structure", - "members":{ - "PortfolioDetail":{ - "shape":"PortfolioDetail", - "documentation":"

Information about the portfolio.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the portfolio.

" - } - } - }, - "CreatePortfolioShareInput":{ - "type":"structure", - "required":[ - "PortfolioId", - "AccountId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The AWS account ID.

" - } - } - }, - "CreatePortfolioShareOutput":{ - "type":"structure", - "members":{ - } - }, - "CreateProductInput":{ - "type":"structure", - "required":[ - "Name", - "Owner", - "ProductType", - "ProvisioningArtifactParameters", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Name":{ - "shape":"ProductViewName", - "documentation":"

The name of the product.

" - }, - "Owner":{ - "shape":"ProductViewOwner", - "documentation":"

The owner of the product.

" - }, - "Description":{ - "shape":"ProductViewShortDescription", - "documentation":"

The description of the product.

" - }, - "Distributor":{ - "shape":"ProductViewOwner", - "documentation":"

The distributor of the product.

" - }, - "SupportDescription":{ - "shape":"SupportDescription", - "documentation":"

The support information about the product.

" - }, - "SupportEmail":{ - "shape":"SupportEmail", - "documentation":"

The contact email for product support.

" - }, - "SupportUrl":{ - "shape":"SupportUrl", - "documentation":"

The contact URL for product support.

" - }, - "ProductType":{ - "shape":"ProductType", - "documentation":"

The type of product.

" - }, - "Tags":{ - "shape":"AddTags", - "documentation":"

One or more tags.

" - }, - "ProvisioningArtifactParameters":{ - "shape":"ProvisioningArtifactProperties", - "documentation":"

The configuration of the provisioning artifact.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "CreateProductOutput":{ - "type":"structure", - "members":{ - "ProductViewDetail":{ - "shape":"ProductViewDetail", - "documentation":"

Information about the product view.

" - }, - "ProvisioningArtifactDetail":{ - "shape":"ProvisioningArtifactDetail", - "documentation":"

Information about the provisioning artifact.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the product.

" - } - } - }, - "CreateProvisionedProductPlanInput":{ - "type":"structure", - "required":[ - "PlanName", - "PlanType", - "ProductId", - "ProvisionedProductName", - "ProvisioningArtifactId", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PlanName":{ - "shape":"ProvisionedProductPlanName", - "documentation":"

The name of the plan.

" - }, - "PlanType":{ - "shape":"ProvisionedProductPlanType", - "documentation":"

The plan type.

" - }, - "NotificationArns":{ - "shape":"NotificationArns", - "documentation":"

Passed to CloudFormation. The SNS topic ARNs to which to publish stack-related events.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisionedProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

A user-friendly name for the provisioned product. This value must be unique for the AWS account and cannot be updated after the product is provisioned.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "ProvisioningParameters":{ - "shape":"UpdateProvisioningParameters", - "documentation":"

Parameters specified by the administrator that are required for provisioning the product.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - }, - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - } - } - }, - "CreateProvisionedProductPlanOutput":{ - "type":"structure", - "members":{ - "PlanName":{ - "shape":"ProvisionedProductPlanName", - "documentation":"

The name of the plan.

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "ProvisionProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisionedProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - } - } - }, - "CreateProvisioningArtifactInput":{ - "type":"structure", - "required":[ - "ProductId", - "Parameters", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "Parameters":{ - "shape":"ProvisioningArtifactProperties", - "documentation":"

The configuration for the provisioning artifact.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "CreateProvisioningArtifactOutput":{ - "type":"structure", - "members":{ - "ProvisioningArtifactDetail":{ - "shape":"ProvisioningArtifactDetail", - "documentation":"

Information about the provisioning artifact.

" - }, - "Info":{ - "shape":"ProvisioningArtifactInfo", - "documentation":"

The URL of the CloudFormation template in Amazon S3, in JSON format.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "CreateTagOptionInput":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagOptionKey", - "documentation":"

The TagOption key.

" - }, - "Value":{ - "shape":"TagOptionValue", - "documentation":"

The TagOption value.

" - } - } - }, - "CreateTagOptionOutput":{ - "type":"structure", - "members":{ - "TagOptionDetail":{ - "shape":"TagOptionDetail", - "documentation":"

Information about the TagOption.

" - } - } - }, - "CreatedTime":{"type":"timestamp"}, - "CreationTime":{"type":"timestamp"}, - "DefaultValue":{"type":"string"}, - "DeleteConstraintInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the constraint.

" - } - } - }, - "DeleteConstraintOutput":{ - "type":"structure", - "members":{ - } - }, - "DeletePortfolioInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "DeletePortfolioOutput":{ - "type":"structure", - "members":{ - } - }, - "DeletePortfolioShareInput":{ - "type":"structure", - "required":[ - "PortfolioId", - "AccountId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "AccountId":{ - "shape":"AccountId", - "documentation":"

The AWS account ID.

" - } - } - }, - "DeletePortfolioShareOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteProductInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The product identifier.

" - } - } - }, - "DeleteProductOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteProvisionedProductPlanInput":{ - "type":"structure", - "required":["PlanId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "IgnoreErrors":{ - "shape":"IgnoreErrors", - "documentation":"

If set to true, AWS Service Catalog stops managing the specified provisioned product even if it cannot delete the underlying resources.

" - } - } - }, - "DeleteProvisionedProductPlanOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteProvisioningArtifactInput":{ - "type":"structure", - "required":[ - "ProductId", - "ProvisioningArtifactId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - } - } - }, - "DeleteProvisioningArtifactOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteTagOptionInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - } - } - }, - "DeleteTagOptionOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeConstraintInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the constraint.

" - } - } - }, - "DescribeConstraintOutput":{ - "type":"structure", - "members":{ - "ConstraintDetail":{ - "shape":"ConstraintDetail", - "documentation":"

Information about the constraint.

" - }, - "ConstraintParameters":{ - "shape":"ConstraintParameters", - "documentation":"

The constraint parameters.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "DescribeCopyProductStatusInput":{ - "type":"structure", - "required":["CopyProductToken"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "CopyProductToken":{ - "shape":"Id", - "documentation":"

The token for the copy product operation. This token is returned by CopyProduct.

" - } - } - }, - "DescribeCopyProductStatusOutput":{ - "type":"structure", - "members":{ - "CopyProductStatus":{ - "shape":"CopyProductStatus", - "documentation":"

The status of the copy product operation.

" - }, - "TargetProductId":{ - "shape":"Id", - "documentation":"

The identifier of the copied product.

" - }, - "StatusDetail":{ - "shape":"StatusDetail", - "documentation":"

The status message.

" - } - } - }, - "DescribePortfolioInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "DescribePortfolioOutput":{ - "type":"structure", - "members":{ - "PortfolioDetail":{ - "shape":"PortfolioDetail", - "documentation":"

Information about the portfolio.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the portfolio.

" - }, - "TagOptions":{ - "shape":"TagOptionDetails", - "documentation":"

Information about the TagOptions associated with the portfolio.

" - } - } - }, - "DescribeProductAsAdminInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The product identifier.

" - } - } - }, - "DescribeProductAsAdminOutput":{ - "type":"structure", - "members":{ - "ProductViewDetail":{ - "shape":"ProductViewDetail", - "documentation":"

Information about the product view.

" - }, - "ProvisioningArtifactSummaries":{ - "shape":"ProvisioningArtifactSummaries", - "documentation":"

Information about the provisioning artifacts (also known as versions) for the specified product.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the product.

" - }, - "TagOptions":{ - "shape":"TagOptionDetails", - "documentation":"

Information about the TagOptions associated with the product.

" - } - } - }, - "DescribeProductInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The product identifier.

" - } - } - }, - "DescribeProductOutput":{ - "type":"structure", - "members":{ - "ProductViewSummary":{ - "shape":"ProductViewSummary", - "documentation":"

Summary information about the product view.

" - }, - "ProvisioningArtifacts":{ - "shape":"ProvisioningArtifacts", - "documentation":"

Information about the provisioning artifacts for the specified product.

" - } - } - }, - "DescribeProductViewInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The product view identifier.

" - } - } - }, - "DescribeProductViewOutput":{ - "type":"structure", - "members":{ - "ProductViewSummary":{ - "shape":"ProductViewSummary", - "documentation":"

Summary information about the product.

" - }, - "ProvisioningArtifacts":{ - "shape":"ProvisioningArtifacts", - "documentation":"

Information about the provisioning artifacts for the product.

" - } - } - }, - "DescribeProvisionedProductInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The provisioned product identifier.

" - } - } - }, - "DescribeProvisionedProductOutput":{ - "type":"structure", - "members":{ - "ProvisionedProductDetail":{ - "shape":"ProvisionedProductDetail", - "documentation":"

Information about the provisioned product.

" - }, - "CloudWatchDashboards":{ - "shape":"CloudWatchDashboards", - "documentation":"

Any CloudWatch dashboards that were created when provisioning the product.

" - } - } - }, - "DescribeProvisionedProductPlanInput":{ - "type":"structure", - "required":["PlanId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "DescribeProvisionedProductPlanOutput":{ - "type":"structure", - "members":{ - "ProvisionedProductPlanDetails":{ - "shape":"ProvisionedProductPlanDetails", - "documentation":"

Information about the plan.

" - }, - "ResourceChanges":{ - "shape":"ResourceChanges", - "documentation":"

Information about the resource changes that will occur when the plan is executed.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "DescribeProvisioningArtifactInput":{ - "type":"structure", - "required":[ - "ProvisioningArtifactId", - "ProductId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "Verbose":{ - "shape":"Verbose", - "documentation":"

Indicates whether a verbose level of detail is enabled.

" - } - } - }, - "DescribeProvisioningArtifactOutput":{ - "type":"structure", - "members":{ - "ProvisioningArtifactDetail":{ - "shape":"ProvisioningArtifactDetail", - "documentation":"

Information about the provisioning artifact.

" - }, - "Info":{ - "shape":"ProvisioningArtifactInfo", - "documentation":"

The URL of the CloudFormation template in Amazon S3.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "DescribeProvisioningParametersInput":{ - "type":"structure", - "required":[ - "ProductId", - "ProvisioningArtifactId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

" - } - } - }, - "DescribeProvisioningParametersOutput":{ - "type":"structure", - "members":{ - "ProvisioningArtifactParameters":{ - "shape":"ProvisioningArtifactParameters", - "documentation":"

Information about the parameters used to provision the product.

" - }, - "ConstraintSummaries":{ - "shape":"ConstraintSummaries", - "documentation":"

Information about the constraints used to provision the product.

" - }, - "UsageInstructions":{ - "shape":"UsageInstructions", - "documentation":"

Any additional metadata specifically related to the provisioning of the product. For example, see the Version field of the CloudFormation template.

" - }, - "TagOptions":{ - "shape":"TagOptionSummaries", - "documentation":"

Information about the TagOptions associated with the resource.

" - } - } - }, - "DescribeRecordInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The record identifier of the provisioned product. This identifier is returned by the request operation.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - } - } - }, - "DescribeRecordOutput":{ - "type":"structure", - "members":{ - "RecordDetail":{ - "shape":"RecordDetail", - "documentation":"

Information about the product.

" - }, - "RecordOutputs":{ - "shape":"RecordOutputs", - "documentation":"

Information about the product created as the result of a request. For example, the output for a CloudFormation-backed product that creates an S3 bucket would include the S3 bucket URL.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "DescribeTagOptionInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - } - } - }, - "DescribeTagOptionOutput":{ - "type":"structure", - "members":{ - "TagOptionDetail":{ - "shape":"TagOptionDetail", - "documentation":"

Information about the TagOption.

" - } - } - }, - "Description":{"type":"string"}, - "DisassociatePrincipalFromPortfolioInput":{ - "type":"structure", - "required":[ - "PortfolioId", - "PrincipalARN" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "PrincipalARN":{ - "shape":"PrincipalARN", - "documentation":"

The ARN of the principal (IAM user, role, or group).

" - } - } - }, - "DisassociatePrincipalFromPortfolioOutput":{ - "type":"structure", - "members":{ - } - }, - "DisassociateProductFromPortfolioInput":{ - "type":"structure", - "required":[ - "ProductId", - "PortfolioId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "DisassociateProductFromPortfolioOutput":{ - "type":"structure", - "members":{ - } - }, - "DisassociateTagOptionFromResourceInput":{ - "type":"structure", - "required":[ - "ResourceId", - "TagOptionId" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource identifier.

" - }, - "TagOptionId":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - } - } - }, - "DisassociateTagOptionFromResourceOutput":{ - "type":"structure", - "members":{ - } - }, - "DuplicateResourceException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource is a duplicate.

", - "exception":true - }, - "ErrorCode":{"type":"string"}, - "ErrorDescription":{"type":"string"}, - "EvaluationType":{ - "type":"string", - "enum":[ - "STATIC", - "DYNAMIC" - ] - }, - "ExecuteProvisionedProductPlanInput":{ - "type":"structure", - "required":[ - "PlanId", - "IdempotencyToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", - "idempotencyToken":true - } - } - }, - "ExecuteProvisionedProductPlanOutput":{ - "type":"structure", - "members":{ - "RecordDetail":{ - "shape":"RecordDetail", - "documentation":"

Information about the result of provisioning the product.

" - } - } - }, - "HasDefaultPath":{"type":"boolean"}, - "Id":{ - "type":"string", - "max":100, - "min":1 - }, - "IdempotencyToken":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9][a-zA-Z0-9_-]*" - }, - "IgnoreErrors":{"type":"boolean"}, - "InstructionType":{"type":"string"}, - "InstructionValue":{"type":"string"}, - "InvalidParametersException":{ - "type":"structure", - "members":{ - }, - "documentation":"

One or more parameters provided to the operation are not valid.

", - "exception":true - }, - "InvalidStateException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An attempt was made to modify a resource that is in a state that is not valid. Check your resources to ensure that they are in valid states before retrying the operation.

", - "exception":true - }, - "LastRequestId":{"type":"string"}, - "LaunchPathSummaries":{ - "type":"list", - "member":{"shape":"LaunchPathSummary"} - }, - "LaunchPathSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the product path.

" - }, - "ConstraintSummaries":{ - "shape":"ConstraintSummaries", - "documentation":"

The constraints on the portfolio-product relationship.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The tags associated with this product path.

" - }, - "Name":{ - "shape":"PortfolioName", - "documentation":"

The name of the portfolio to which the user was assigned.

" - } - }, - "documentation":"

Summary information about a product path for a user.

" - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The current limits of the service would have been exceeded by this operation. Decrease your resource use or increase your service limits and retry the operation.

", - "exception":true - }, - "ListAcceptedPortfolioSharesInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PortfolioShareType":{ - "shape":"PortfolioShareType", - "documentation":"

The type of shared portfolios to list. The default is to list imported portfolios.

  • AWS_SERVICECATALOG - List default portfolios

  • IMPORTED - List imported portfolios

" - } - } - }, - "ListAcceptedPortfolioSharesOutput":{ - "type":"structure", - "members":{ - "PortfolioDetails":{ - "shape":"PortfolioDetails", - "documentation":"

Information about the portfolios.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListConstraintsForPortfolioInput":{ - "type":"structure", - "required":["PortfolioId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListConstraintsForPortfolioOutput":{ - "type":"structure", - "members":{ - "ConstraintDetails":{ - "shape":"ConstraintDetails", - "documentation":"

Information about the constraints.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListLaunchPathsInput":{ - "type":"structure", - "required":["ProductId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListLaunchPathsOutput":{ - "type":"structure", - "members":{ - "LaunchPathSummaries":{ - "shape":"LaunchPathSummaries", - "documentation":"

Information about the launch path.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListPortfolioAccessInput":{ - "type":"structure", - "required":["PortfolioId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "ListPortfolioAccessOutput":{ - "type":"structure", - "members":{ - "AccountIds":{ - "shape":"AccountIds", - "documentation":"

Information about the AWS accounts with access to the portfolio.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListPortfoliosForProductInput":{ - "type":"structure", - "required":["ProductId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - } - } - }, - "ListPortfoliosForProductOutput":{ - "type":"structure", - "members":{ - "PortfolioDetails":{ - "shape":"PortfolioDetails", - "documentation":"

Information about the portfolios.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListPortfoliosInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - } - } - }, - "ListPortfoliosOutput":{ - "type":"structure", - "members":{ - "PortfolioDetails":{ - "shape":"PortfolioDetails", - "documentation":"

Information about the portfolios.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListPrincipalsForPortfolioInput":{ - "type":"structure", - "required":["PortfolioId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListPrincipalsForPortfolioOutput":{ - "type":"structure", - "members":{ - "Principals":{ - "shape":"Principals", - "documentation":"

The IAM principals (users or roles) associated with the portfolio.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListProvisionedProductPlansInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProvisionProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "AccessLevelFilter":{ - "shape":"AccessLevelFilter", - "documentation":"

The access level to use to obtain results. The default is User.

" - } - } - }, - "ListProvisionedProductPlansOutput":{ - "type":"structure", - "members":{ - "ProvisionedProductPlans":{ - "shape":"ProvisionedProductPlans", - "documentation":"

Information about the plans.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListProvisioningArtifactsInput":{ - "type":"structure", - "required":["ProductId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - } - } - }, - "ListProvisioningArtifactsOutput":{ - "type":"structure", - "members":{ - "ProvisioningArtifactDetails":{ - "shape":"ProvisioningArtifactDetails", - "documentation":"

Information about the provisioning artifacts.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListRecordHistoryInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "AccessLevelFilter":{ - "shape":"AccessLevelFilter", - "documentation":"

The access level to use to obtain results. The default is User.

" - }, - "SearchFilter":{ - "shape":"ListRecordHistorySearchFilter", - "documentation":"

The search filter to scope the results.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListRecordHistoryOutput":{ - "type":"structure", - "members":{ - "RecordDetails":{ - "shape":"RecordDetails", - "documentation":"

The records, in reverse chronological order.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "ListRecordHistorySearchFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"SearchFilterKey", - "documentation":"

The filter key.

  • product - Filter results based on the specified product identifier.

  • provisionedproduct - Filter results based on the provisioned product identifier.

" - }, - "Value":{ - "shape":"SearchFilterValue", - "documentation":"

The filter value.

" - } - }, - "documentation":"

The search filter to use when listing history records.

" - }, - "ListResourcesForTagOptionInput":{ - "type":"structure", - "required":["TagOptionId"], - "members":{ - "TagOptionId":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type.

  • Portfolio

  • Product

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListResourcesForTagOptionOutput":{ - "type":"structure", - "members":{ - "ResourceDetails":{ - "shape":"ResourceDetails", - "documentation":"

Information about the resources.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListTagOptionsFilters":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagOptionKey", - "documentation":"

The TagOption key.

" - }, - "Value":{ - "shape":"TagOptionValue", - "documentation":"

The TagOption value.

" - }, - "Active":{ - "shape":"TagOptionActive", - "documentation":"

The active state.

" - } - }, - "documentation":"

Filters to use when listing TagOptions.

" - }, - "ListTagOptionsInput":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ListTagOptionsFilters", - "documentation":"

The search filters. If no search filters are specified, the output includes all TagOptions.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ListTagOptionsOutput":{ - "type":"structure", - "members":{ - "TagOptionDetails":{ - "shape":"TagOptionDetails", - "documentation":"

Information about the TagOptions.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "LogicalResourceId":{"type":"string"}, - "NoEcho":{"type":"boolean"}, - "NotificationArn":{ - "type":"string", - "max":1224, - "min":1, - "pattern":"arn:[a-z0-9-\\.]{1,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[^/].{0,1023}" - }, - "NotificationArns":{ - "type":"list", - "member":{"shape":"NotificationArn"}, - "max":5 - }, - "OutputKey":{"type":"string"}, - "OutputValue":{"type":"string"}, - "PageSize":{ - "type":"integer", - "max":20, - "min":0 - }, - "PageToken":{ - "type":"string", - "pattern":"[\\u0009\\u000a\\u000d\\u0020-\\uD7FF\\uE000-\\uFFFD]*" - }, - "ParameterConstraints":{ - "type":"structure", - "members":{ - "AllowedValues":{ - "shape":"AllowedValues", - "documentation":"

The values that the administrator has allowed for the parameter.

" - } - }, - "documentation":"

The constraints that the administrator has put on the parameter.

" - }, - "ParameterKey":{ - "type":"string", - "max":1000, - "min":1 - }, - "ParameterType":{"type":"string"}, - "ParameterValue":{ - "type":"string", - "max":4096 - }, - "PhysicalId":{"type":"string"}, - "PhysicalResourceId":{"type":"string"}, - "PlanResourceType":{ - "type":"string", - "max":256, - "min":1 - }, - "PortfolioDescription":{ - "type":"string", - "max":2000 - }, - "PortfolioDetail":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "ARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN assigned to the portfolio.

" - }, - "DisplayName":{ - "shape":"PortfolioDisplayName", - "documentation":"

The name to use for display purposes.

" - }, - "Description":{ - "shape":"PortfolioDescription", - "documentation":"

The description of the portfolio.

" - }, - "CreatedTime":{ - "shape":"CreationTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "ProviderName":{ - "shape":"ProviderName", - "documentation":"

The name of the portfolio provider.

" - } - }, - "documentation":"

Information about a portfolio.

" - }, - "PortfolioDetails":{ - "type":"list", - "member":{"shape":"PortfolioDetail"} - }, - "PortfolioDisplayName":{ - "type":"string", - "max":100, - "min":1 - }, - "PortfolioName":{"type":"string"}, - "PortfolioShareType":{ - "type":"string", - "enum":[ - "IMPORTED", - "AWS_SERVICECATALOG" - ] - }, - "Principal":{ - "type":"structure", - "members":{ - "PrincipalARN":{ - "shape":"PrincipalARN", - "documentation":"

The ARN of the principal (IAM user, role, or group).

" - }, - "PrincipalType":{ - "shape":"PrincipalType", - "documentation":"

The principal type. The supported value is IAM.

" - } - }, - "documentation":"

Information about a principal.

" - }, - "PrincipalARN":{ - "type":"string", - "max":1000, - "min":1 - }, - "PrincipalType":{ - "type":"string", - "enum":["IAM"] - }, - "Principals":{ - "type":"list", - "member":{"shape":"Principal"} - }, - "ProductArn":{ - "type":"string", - "max":1224, - "min":1, - "pattern":"arn:[a-z0-9-\\.]{1,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[^/].{0,1023}" - }, - "ProductSource":{ - "type":"string", - "enum":["ACCOUNT"] - }, - "ProductType":{ - "type":"string", - "enum":[ - "CLOUD_FORMATION_TEMPLATE", - "MARKETPLACE" - ], - "max":8191 - }, - "ProductViewAggregationType":{"type":"string"}, - "ProductViewAggregationValue":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"AttributeValue", - "documentation":"

The value of the product view aggregation.

" - }, - "ApproximateCount":{ - "shape":"ApproximateCount", - "documentation":"

An approximate count of the products that match the value.

" - } - }, - "documentation":"

A single product view aggregation value/count pair, containing metadata about each product to which the calling user has access.

" - }, - "ProductViewAggregationValues":{ - "type":"list", - "member":{"shape":"ProductViewAggregationValue"} - }, - "ProductViewAggregations":{ - "type":"map", - "key":{"shape":"ProductViewAggregationType"}, - "value":{"shape":"ProductViewAggregationValues"} - }, - "ProductViewDetail":{ - "type":"structure", - "members":{ - "ProductViewSummary":{ - "shape":"ProductViewSummary", - "documentation":"

Summary information about the product view.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the product.

  • AVAILABLE - The product is ready for use.

  • CREATING - Product creation has started; the product is not ready for use.

  • FAILED - An action failed.

" - }, - "ProductARN":{ - "shape":"ResourceARN", - "documentation":"

The ARN of the product.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - } - }, - "documentation":"

Information about a product view.

" - }, - "ProductViewDetails":{ - "type":"list", - "member":{"shape":"ProductViewDetail"} - }, - "ProductViewDistributor":{"type":"string"}, - "ProductViewFilterBy":{ - "type":"string", - "enum":[ - "FullTextSearch", - "Owner", - "ProductType", - "SourceProductId" - ] - }, - "ProductViewFilterValue":{"type":"string"}, - "ProductViewFilterValues":{ - "type":"list", - "member":{"shape":"ProductViewFilterValue"} - }, - "ProductViewFilters":{ - "type":"map", - "key":{"shape":"ProductViewFilterBy"}, - "value":{"shape":"ProductViewFilterValues"} - }, - "ProductViewName":{ - "type":"string", - "max":8191 - }, - "ProductViewOwner":{ - "type":"string", - "max":8191 - }, - "ProductViewShortDescription":{ - "type":"string", - "max":8191 - }, - "ProductViewSortBy":{ - "type":"string", - "enum":[ - "Title", - "VersionCount", - "CreationDate" - ] - }, - "ProductViewSummaries":{ - "type":"list", - "member":{"shape":"ProductViewSummary"} - }, - "ProductViewSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The product view identifier.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "Name":{ - "shape":"ProductViewName", - "documentation":"

The name of the product.

" - }, - "Owner":{ - "shape":"ProductViewOwner", - "documentation":"

The owner of the product. Contact the product administrator for the significance of this value.

" - }, - "ShortDescription":{ - "shape":"ProductViewShortDescription", - "documentation":"

Short description of the product.

" - }, - "Type":{ - "shape":"ProductType", - "documentation":"

The product type. Contact the product administrator for the significance of this value. If this value is MARKETPLACE, the product was created by AWS Marketplace.

" - }, - "Distributor":{ - "shape":"ProductViewDistributor", - "documentation":"

The distributor of the product. Contact the product administrator for the significance of this value.

" - }, - "HasDefaultPath":{ - "shape":"HasDefaultPath", - "documentation":"

Indicates whether the product has a default path. If the product does not have a default path, call ListLaunchPaths to disambiguate between paths. Otherwise, ListLaunchPaths is not required, and the output of ProductViewSummary can be used directly with DescribeProvisioningParameters.

" - }, - "SupportEmail":{ - "shape":"SupportEmail", - "documentation":"

The email contact information to obtain support for this Product.

" - }, - "SupportDescription":{ - "shape":"SupportDescription", - "documentation":"

The description of the support for this Product.

" - }, - "SupportUrl":{ - "shape":"SupportUrl", - "documentation":"

The URL information to obtain support for this Product.

" - } - }, - "documentation":"

Summary information about a product view.

" - }, - "PropertyName":{"type":"string"}, - "ProviderName":{ - "type":"string", - "max":50, - "min":1 - }, - "ProvisionProductInput":{ - "type":"structure", - "required":[ - "ProductId", - "ProvisioningArtifactId", - "ProvisionedProductName", - "ProvisionToken" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

" - }, - "ProvisionedProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

A user-friendly name for the provisioned product. This value must be unique for the AWS account and cannot be updated after the product is provisioned.

" - }, - "ProvisioningParameters":{ - "shape":"ProvisioningParameters", - "documentation":"

Parameters specified by the administrator that are required for provisioning the product.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - }, - "NotificationArns":{ - "shape":"NotificationArns", - "documentation":"

Passed to CloudFormation. The SNS topic ARNs to which to publish stack-related events.

" - }, - "ProvisionToken":{ - "shape":"IdempotencyToken", - "documentation":"

An idempotency token that uniquely identifies the provisioning request.

", - "idempotencyToken":true - } - } - }, - "ProvisionProductOutput":{ - "type":"structure", - "members":{ - "RecordDetail":{ - "shape":"RecordDetail", - "documentation":"

Information about the result of provisioning the product.

" - } - } - }, - "ProvisionedProductAttribute":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "Arn":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The ARN of the provisioned product.

" - }, - "Type":{ - "shape":"ProvisionedProductType", - "documentation":"

The type of provisioned product. The supported value is CFN_STACK.

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the provisioned product.

" - }, - "Status":{ - "shape":"ProvisionedProductStatus", - "documentation":"

The current status of the provisioned product.

  • AVAILABLE - Stable state, ready to perform any operation. The most recent operation succeeded and completed.

  • UNDER_CHANGE - Transitive state, operations performed might not have valid results. Wait for an AVAILABLE status before performing operations.

  • TAINTED - Stable state, ready to perform any operation. The stack has completed the requested operation but is not exactly what was requested. For example, a request to update to a new version failed and the stack rolled back to the current version.

  • ERROR - An unexpected error occurred, the provisioned product exists but the stack is not running. For example, CloudFormation received a parameter value that was not valid and could not launch the stack.

" - }, - "StatusMessage":{ - "shape":"ProvisionedProductStatusMessage", - "documentation":"

The current status message of the provisioned product.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

" - }, - "LastRecordId":{ - "shape":"Id", - "documentation":"

The record identifier of the last request performed on this provisioned product.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - }, - "PhysicalId":{ - "shape":"PhysicalId", - "documentation":"

The assigned identifier for the resource, such as an EC2 instance ID or an S3 bucket name.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "UserArn":{ - "shape":"UserArn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM user.

" - }, - "UserArnSession":{ - "shape":"UserArnSession", - "documentation":"

The ARN of the IAM user in the session. This ARN might contain a session ID.

" - } - }, - "documentation":"

Information about a provisioned product.

" - }, - "ProvisionedProductAttributes":{ - "type":"list", - "member":{"shape":"ProvisionedProductAttribute"} - }, - "ProvisionedProductDetail":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "Arn":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The ARN of the provisioned product.

" - }, - "Type":{ - "shape":"ProvisionedProductType", - "documentation":"

The type of provisioned product. The supported value is CFN_STACK.

" - }, - "Id":{ - "shape":"ProvisionedProductId", - "documentation":"

The identifier of the provisioned product.

" - }, - "Status":{ - "shape":"ProvisionedProductStatus", - "documentation":"

The current status of the provisioned product.

  • AVAILABLE - Stable state, ready to perform any operation. The most recent operation succeeded and completed.

  • UNDER_CHANGE - Transitive state, operations performed might not have valid results. Wait for an AVAILABLE status before performing operations.

  • TAINTED - Stable state, ready to perform any operation. The stack has completed the requested operation but is not exactly what was requested. For example, a request to update to a new version failed and the stack rolled back to the current version.

  • ERROR - An unexpected error occurred, the provisioned product exists but the stack is not running. For example, CloudFormation received a parameter value that was not valid and could not launch the stack.

" - }, - "StatusMessage":{ - "shape":"ProvisionedProductStatusMessage", - "documentation":"

The current status message of the provisioned product.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "IdempotencyToken":{ - "shape":"IdempotencyToken", - "documentation":"

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

" - }, - "LastRecordId":{ - "shape":"LastRequestId", - "documentation":"

The record identifier of the last request performed on this provisioned product.

" - } - }, - "documentation":"

Information about a provisioned product.

" - }, - "ProvisionedProductDetails":{ - "type":"list", - "member":{"shape":"ProvisionedProductDetail"} - }, - "ProvisionedProductFilters":{ - "type":"map", - "key":{"shape":"ProvisionedProductViewFilterBy"}, - "value":{"shape":"ProvisionedProductViewFilterValues"} - }, - "ProvisionedProductId":{"type":"string"}, - "ProvisionedProductName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9][a-zA-Z0-9._-]*" - }, - "ProvisionedProductNameOrArn":{ - "type":"string", - "max":1224, - "min":1, - "pattern":"[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}|arn:[a-z0-9-\\.]{1,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[a-z0-9-\\.]{0,63}:[^/].{0,1023}" - }, - "ProvisionedProductPlanDetails":{ - "type":"structure", - "members":{ - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "PlanName":{ - "shape":"ProvisionedProductPlanName", - "documentation":"

The name of the plan.

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "ProvisionProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisionProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "PlanType":{ - "shape":"ProvisionedProductPlanType", - "documentation":"

The plan type.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "Status":{ - "shape":"ProvisionedProductPlanStatus", - "documentation":"

The status.

" - }, - "UpdatedTime":{ - "shape":"UpdatedTime", - "documentation":"

The time when the plan was last updated.

" - }, - "NotificationArns":{ - "shape":"NotificationArns", - "documentation":"

Passed to CloudFormation. The SNS topic ARNs to which to publish stack-related events.

" - }, - "ProvisioningParameters":{ - "shape":"UpdateProvisioningParameters", - "documentation":"

Parameters specified by the administrator that are required for provisioning the product.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

One or more tags.

" - }, - "StatusMessage":{ - "shape":"StatusMessage", - "documentation":"

The status message.

" - } - }, - "documentation":"

Information about a plan.

" - }, - "ProvisionedProductPlanName":{"type":"string"}, - "ProvisionedProductPlanStatus":{ - "type":"string", - "enum":[ - "CREATE_IN_PROGRESS", - "CREATE_SUCCESS", - "CREATE_FAILED", - "EXECUTE_IN_PROGRESS", - "EXECUTE_SUCCESS", - "EXECUTE_FAILED" - ] - }, - "ProvisionedProductPlanSummary":{ - "type":"structure", - "members":{ - "PlanName":{ - "shape":"ProvisionedProductPlanName", - "documentation":"

The name of the plan.

" - }, - "PlanId":{ - "shape":"Id", - "documentation":"

The plan identifier.

" - }, - "ProvisionProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisionProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "PlanType":{ - "shape":"ProvisionedProductPlanType", - "documentation":"

The plan type.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - } - }, - "documentation":"

Summary information about a plan.

" - }, - "ProvisionedProductPlanType":{ - "type":"string", - "enum":["CLOUDFORMATION"] - }, - "ProvisionedProductPlans":{ - "type":"list", - "member":{"shape":"ProvisionedProductPlanSummary"} - }, - "ProvisionedProductStatus":{ - "type":"string", - "enum":[ - "AVAILABLE", - "UNDER_CHANGE", - "TAINTED", - "ERROR", - "PLAN_IN_PROGRESS" - ] - }, - "ProvisionedProductStatusMessage":{"type":"string"}, - "ProvisionedProductType":{"type":"string"}, - "ProvisionedProductViewFilterBy":{ - "type":"string", - "enum":["SearchQuery"] - }, - "ProvisionedProductViewFilterValue":{"type":"string"}, - "ProvisionedProductViewFilterValues":{ - "type":"list", - "member":{"shape":"ProvisionedProductViewFilterValue"} - }, - "ProvisioningArtifact":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "Name":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The name of the provisioning artifact.

" - }, - "Description":{ - "shape":"ProvisioningArtifactDescription", - "documentation":"

The description of the provisioning artifact.

" - }, - "CreatedTime":{ - "shape":"ProvisioningArtifactCreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - } - }, - "documentation":"

Information about a provisioning artifact. A provisioning artifact is also known as a product version.

" - }, - "ProvisioningArtifactActive":{"type":"boolean"}, - "ProvisioningArtifactCreatedTime":{"type":"timestamp"}, - "ProvisioningArtifactDescription":{"type":"string"}, - "ProvisioningArtifactDetail":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "Name":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The name of the provisioning artifact.

" - }, - "Description":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The description of the provisioning artifact.

" - }, - "Type":{ - "shape":"ProvisioningArtifactType", - "documentation":"

The type of provisioning artifact.

  • CLOUD_FORMATION_TEMPLATE - AWS CloudFormation template

  • MARKETPLACE_AMI - AWS Marketplace AMI

  • MARKETPLACE_CAR - AWS Marketplace Clusters and AWS Resources

" - }, - "CreatedTime":{ - "shape":"CreationTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "Active":{ - "shape":"ProvisioningArtifactActive", - "documentation":"

Indicates whether the product version is active.

" - } - }, - "documentation":"

Information about a provisioning artifact (also known as a version) for a product.

" - }, - "ProvisioningArtifactDetails":{ - "type":"list", - "member":{"shape":"ProvisioningArtifactDetail"} - }, - "ProvisioningArtifactInfo":{ - "type":"map", - "key":{"shape":"ProvisioningArtifactInfoKey"}, - "value":{"shape":"ProvisioningArtifactInfoValue"}, - "max":100, - "min":1 - }, - "ProvisioningArtifactInfoKey":{"type":"string"}, - "ProvisioningArtifactInfoValue":{"type":"string"}, - "ProvisioningArtifactName":{"type":"string"}, - "ProvisioningArtifactParameter":{ - "type":"structure", - "members":{ - "ParameterKey":{ - "shape":"ParameterKey", - "documentation":"

The parameter key.

" - }, - "DefaultValue":{ - "shape":"DefaultValue", - "documentation":"

The default value.

" - }, - "ParameterType":{ - "shape":"ParameterType", - "documentation":"

The parameter type.

" - }, - "IsNoEcho":{ - "shape":"NoEcho", - "documentation":"

If this value is true, the value for this parameter is obfuscated from view when the parameter is retrieved. This parameter is used to hide sensitive information.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description of the parameter.

" - }, - "ParameterConstraints":{ - "shape":"ParameterConstraints", - "documentation":"

Constraints that the administrator has put on a parameter.

" - } - }, - "documentation":"

Information about a parameter used to provision a product.

" - }, - "ProvisioningArtifactParameters":{ - "type":"list", - "member":{"shape":"ProvisioningArtifactParameter"} - }, - "ProvisioningArtifactProperties":{ - "type":"structure", - "required":["Info"], - "members":{ - "Name":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The name of the provisioning artifact (for example, v1 v2beta). No spaces are allowed.

" - }, - "Description":{ - "shape":"ProvisioningArtifactDescription", - "documentation":"

The description of the provisioning artifact, including how it differs from the previous provisioning artifact.

" - }, - "Info":{ - "shape":"ProvisioningArtifactInfo", - "documentation":"

The URL of the CloudFormation template in Amazon S3. Specify the URL in JSON format as follows:

\"LoadTemplateFromURL\": \"https://s3.amazonaws.com/cf-templates-ozkq9d3hgiq2-us-east-1/...\"

" - }, - "Type":{ - "shape":"ProvisioningArtifactType", - "documentation":"

The type of provisioning artifact.

  • CLOUD_FORMATION_TEMPLATE - AWS CloudFormation template

  • MARKETPLACE_AMI - AWS Marketplace AMI

  • MARKETPLACE_CAR - AWS Marketplace Clusters and AWS Resources

" - } - }, - "documentation":"

Information about a provisioning artifact (also known as a version) for a product.

" - }, - "ProvisioningArtifactPropertyName":{ - "type":"string", - "enum":["Id"] - }, - "ProvisioningArtifactPropertyValue":{"type":"string"}, - "ProvisioningArtifactSummaries":{ - "type":"list", - "member":{"shape":"ProvisioningArtifactSummary"} - }, - "ProvisioningArtifactSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "Name":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The name of the provisioning artifact.

" - }, - "Description":{ - "shape":"ProvisioningArtifactDescription", - "documentation":"

The description of the provisioning artifact.

" - }, - "CreatedTime":{ - "shape":"ProvisioningArtifactCreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "ProvisioningArtifactMetadata":{ - "shape":"ProvisioningArtifactInfo", - "documentation":"

The metadata for the provisioning artifact. This is used with AWS Marketplace products.

" - } - }, - "documentation":"

Summary information about a provisioning artifact (also known as a version) for a product.

" - }, - "ProvisioningArtifactType":{ - "type":"string", - "enum":[ - "CLOUD_FORMATION_TEMPLATE", - "MARKETPLACE_AMI", - "MARKETPLACE_CAR" - ] - }, - "ProvisioningArtifacts":{ - "type":"list", - "member":{"shape":"ProvisioningArtifact"} - }, - "ProvisioningParameter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"ParameterKey", - "documentation":"

The parameter key.

" - }, - "Value":{ - "shape":"ParameterValue", - "documentation":"

The parameter value.

" - } - }, - "documentation":"

Information about a parameter used to provision a product.

" - }, - "ProvisioningParameters":{ - "type":"list", - "member":{"shape":"ProvisioningParameter"} - }, - "RecordDetail":{ - "type":"structure", - "members":{ - "RecordId":{ - "shape":"Id", - "documentation":"

The identifier of the record.

" - }, - "ProvisionedProductName":{ - "shape":"ProvisionedProductName", - "documentation":"

The user-friendly name of the provisioned product.

" - }, - "Status":{ - "shape":"RecordStatus", - "documentation":"

The status of the provisioned product.

  • CREATED - The request was created but the operation has not started.

  • IN_PROGRESS - The requested operation is in progress.

  • IN_PROGRESS_IN_ERROR - The provisioned product is under change but the requested operation failed and some remediation is occurring. For example, a rollback.

  • SUCCEEDED - The requested operation has successfully completed.

  • FAILED - The requested operation has unsuccessfully completed. Investigate using the error messages returned.

" - }, - "CreatedTime":{ - "shape":"CreatedTime", - "documentation":"

The UTC time stamp of the creation time.

" - }, - "UpdatedTime":{ - "shape":"UpdatedTime", - "documentation":"

The time when the record was last updated.

" - }, - "ProvisionedProductType":{ - "shape":"ProvisionedProductType", - "documentation":"

The type of provisioned product. The supported value is CFN_STACK.

" - }, - "RecordType":{ - "shape":"RecordType", - "documentation":"

The record type.

  • PROVISION_PRODUCT

  • UPDATE_PROVISIONED_PRODUCT

  • TERMINATE_PROVISIONED_PRODUCT

" - }, - "ProvisionedProductId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioned product.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The path identifier.

" - }, - "RecordErrors":{ - "shape":"RecordErrors", - "documentation":"

The errors that occurred.

" - }, - "RecordTags":{ - "shape":"RecordTags", - "documentation":"

One or more tags.

" - } - }, - "documentation":"

Information about a request operation.

" - }, - "RecordDetails":{ - "type":"list", - "member":{"shape":"RecordDetail"} - }, - "RecordError":{ - "type":"structure", - "members":{ - "Code":{ - "shape":"ErrorCode", - "documentation":"

The numeric value of the error.

" - }, - "Description":{ - "shape":"ErrorDescription", - "documentation":"

The description of the error.

" - } - }, - "documentation":"

The error code and description resulting from an operation.

" - }, - "RecordErrors":{ - "type":"list", - "member":{"shape":"RecordError"} - }, - "RecordOutput":{ - "type":"structure", - "members":{ - "OutputKey":{ - "shape":"OutputKey", - "documentation":"

The output key.

" - }, - "OutputValue":{ - "shape":"OutputValue", - "documentation":"

The output value.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

The description of the output.

" - } - }, - "documentation":"

The output for the product created as the result of a request. For example, the output for a CloudFormation-backed product that creates an S3 bucket would include the S3 bucket URL.

" - }, - "RecordOutputs":{ - "type":"list", - "member":{"shape":"RecordOutput"} - }, - "RecordStatus":{ - "type":"string", - "enum":[ - "CREATED", - "IN_PROGRESS", - "IN_PROGRESS_IN_ERROR", - "SUCCEEDED", - "FAILED" - ] - }, - "RecordTag":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"RecordTagKey", - "documentation":"

The key for this tag.

" - }, - "Value":{ - "shape":"RecordTagValue", - "documentation":"

The value for this tag.

" - } - }, - "documentation":"

Information about a tag, which is a key-value pair.

" - }, - "RecordTagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-%@]*)$" - }, - "RecordTagValue":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-%@]*)$" - }, - "RecordTags":{ - "type":"list", - "member":{"shape":"RecordTag"}, - "max":50 - }, - "RecordType":{"type":"string"}, - "RejectPortfolioShareInput":{ - "type":"structure", - "required":["PortfolioId"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - } - } - }, - "RejectPortfolioShareOutput":{ - "type":"structure", - "members":{ - } - }, - "Replacement":{ - "type":"string", - "enum":[ - "TRUE", - "FALSE", - "CONDITIONAL" - ] - }, - "RequiresRecreation":{ - "type":"string", - "enum":[ - "NEVER", - "CONDITIONALLY", - "ALWAYS" - ] - }, - "ResourceARN":{ - "type":"string", - "max":150, - "min":1 - }, - "ResourceAttribute":{ - "type":"string", - "enum":[ - "PROPERTIES", - "METADATA", - "CREATIONPOLICY", - "UPDATEPOLICY", - "DELETIONPOLICY", - "TAGS" - ] - }, - "ResourceChange":{ - "type":"structure", - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

The change action.

" - }, - "LogicalResourceId":{ - "shape":"LogicalResourceId", - "documentation":"

The ID of the resource, as defined in the CloudFormation template.

" - }, - "PhysicalResourceId":{ - "shape":"PhysicalResourceId", - "documentation":"

The ID of the resource, if it was already created.

" - }, - "ResourceType":{ - "shape":"PlanResourceType", - "documentation":"

The type of resource.

" - }, - "Replacement":{ - "shape":"Replacement", - "documentation":"

If the change type is Modify, indicates whether the existing resource is deleted and replaced with a new one.

" - }, - "Scope":{ - "shape":"Scope", - "documentation":"

The change scope.

" - }, - "Details":{ - "shape":"ResourceChangeDetails", - "documentation":"

Information about the resource changes.

" - } - }, - "documentation":"

Information about a resource change that will occur when a plan is executed.

" - }, - "ResourceChangeDetail":{ - "type":"structure", - "members":{ - "Target":{ - "shape":"ResourceTargetDefinition", - "documentation":"

Information about the resource attribute to be modified.

" - }, - "Evaluation":{ - "shape":"EvaluationType", - "documentation":"

For static evaluations, the value of the resource attribute will change and the new value is known. For dynamic evaluations, the value might change, and any new value will be determined when the plan is updated.

" - }, - "CausingEntity":{ - "shape":"CausingEntity", - "documentation":"

The ID of the entity that caused the change.

" - } - }, - "documentation":"

Information about a change to a resource attribute.

" - }, - "ResourceChangeDetails":{ - "type":"list", - "member":{"shape":"ResourceChangeDetail"} - }, - "ResourceChanges":{ - "type":"list", - "member":{"shape":"ResourceChange"} - }, - "ResourceDetail":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceDetailId", - "documentation":"

The identifier of the resource.

" - }, - "ARN":{ - "shape":"ResourceDetailARN", - "documentation":"

The ARN of the resource.

" - }, - "Name":{ - "shape":"ResourceDetailName", - "documentation":"

The name of the resource.

" - }, - "Description":{ - "shape":"ResourceDetailDescription", - "documentation":"

The description of the resource.

" - }, - "CreatedTime":{ - "shape":"ResourceDetailCreatedTime", - "documentation":"

The creation time of the resource.

" - } - }, - "documentation":"

Information about a resource.

" - }, - "ResourceDetailARN":{"type":"string"}, - "ResourceDetailCreatedTime":{"type":"timestamp"}, - "ResourceDetailDescription":{"type":"string"}, - "ResourceDetailId":{"type":"string"}, - "ResourceDetailName":{"type":"string"}, - "ResourceDetails":{ - "type":"list", - "member":{"shape":"ResourceDetail"} - }, - "ResourceId":{"type":"string"}, - "ResourceInUseException":{ - "type":"structure", - "members":{ - }, - "documentation":"

A resource that is currently in use. Ensure that the resource is not in use and retry the operation.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified resource was not found.

", - "exception":true - }, - "ResourceTargetDefinition":{ - "type":"structure", - "members":{ - "Attribute":{ - "shape":"ResourceAttribute", - "documentation":"

The attribute to be changed.

" - }, - "Name":{ - "shape":"PropertyName", - "documentation":"

If the attribute is Properties, the value is the name of the property. Otherwise, the value is null.

" - }, - "RequiresRecreation":{ - "shape":"RequiresRecreation", - "documentation":"

If the attribute is Properties, indicates whether a change to this property causes the resource to be re-created.

" - } - }, - "documentation":"

Information about a change to a resource attribute.

" - }, - "ResourceType":{"type":"string"}, - "ScanProvisionedProductsInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "AccessLevelFilter":{ - "shape":"AccessLevelFilter", - "documentation":"

The access level to use to obtain results. The default is User.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "ScanProvisionedProductsOutput":{ - "type":"structure", - "members":{ - "ProvisionedProducts":{ - "shape":"ProvisionedProductDetails", - "documentation":"

Information about the provisioned products.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "Scope":{ - "type":"list", - "member":{"shape":"ResourceAttribute"} - }, - "SearchFilterKey":{"type":"string"}, - "SearchFilterValue":{"type":"string"}, - "SearchProductsAsAdminInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "PortfolioId":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "Filters":{ - "shape":"ProductViewFilters", - "documentation":"

The search filters. If no search filters are specified, the output includes all products to which the administrator has access.

" - }, - "SortBy":{ - "shape":"ProductViewSortBy", - "documentation":"

The sort field. If no value is specified, the results are not sorted.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order. If no value is specified, the results are not sorted.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "ProductSource":{ - "shape":"ProductSource", - "documentation":"

Access level of the source of the product.

" - } - } - }, - "SearchProductsAsAdminOutput":{ - "type":"structure", - "members":{ - "ProductViewDetails":{ - "shape":"ProductViewDetails", - "documentation":"

Information about the product views.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "SearchProductsInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Filters":{ - "shape":"ProductViewFilters", - "documentation":"

The search filters. If no search filters are specified, the output includes all products to which the caller has access.

" - }, - "PageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "SortBy":{ - "shape":"ProductViewSortBy", - "documentation":"

The sort field. If no value is specified, the results are not sorted.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order. If no value is specified, the results are not sorted.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "SearchProductsOutput":{ - "type":"structure", - "members":{ - "ProductViewSummaries":{ - "shape":"ProductViewSummaries", - "documentation":"

Information about the product views.

" - }, - "ProductViewAggregations":{ - "shape":"ProductViewAggregations", - "documentation":"

The product view aggregations.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "SearchProvisionedProductsInput":{ - "type":"structure", - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "AccessLevelFilter":{ - "shape":"AccessLevelFilter", - "documentation":"

The access level to use to obtain results. The default is User.

" - }, - "Filters":{ - "shape":"ProvisionedProductFilters", - "documentation":"

The search filters.

When the key is SearchQuery, the searchable fields are arn, createdTime, id, lastRecordId, idempotencyToken, name, physicalId, productId, provisioningArtifact, type, status, tags, userArn, and userArnSession.

Example: \"SearchQuery\":[\"status:AVAILABLE\"]

" - }, - "SortBy":{ - "shape":"SortField", - "documentation":"

The sort field. If no value is specified, the results are not sorted. The valid values are arn, id, name, and lastRecordId.

" - }, - "SortOrder":{ - "shape":"SortOrder", - "documentation":"

The sort order. If no value is specified, the results are not sorted.

" - }, - "PageSize":{ - "shape":"SearchProvisionedProductsPageSize", - "documentation":"

The maximum number of items to return with this call.

" - }, - "PageToken":{ - "shape":"PageToken", - "documentation":"

The page token for the next set of results. To retrieve the first set of results, use null.

" - } - } - }, - "SearchProvisionedProductsOutput":{ - "type":"structure", - "members":{ - "ProvisionedProducts":{ - "shape":"ProvisionedProductAttributes", - "documentation":"

Information about the provisioned products.

" - }, - "TotalResultsCount":{ - "shape":"TotalResultsCount", - "documentation":"

The number of provisioned products found.

" - }, - "NextPageToken":{ - "shape":"PageToken", - "documentation":"

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

" - } - } - }, - "SearchProvisionedProductsPageSize":{ - "type":"integer", - "max":100, - "min":0 - }, - "SortField":{"type":"string"}, - "SortOrder":{ - "type":"string", - "enum":[ - "ASCENDING", - "DESCENDING" - ] - }, - "SourceProvisioningArtifactProperties":{ - "type":"list", - "member":{"shape":"SourceProvisioningArtifactPropertiesMap"} - }, - "SourceProvisioningArtifactPropertiesMap":{ - "type":"map", - "key":{"shape":"ProvisioningArtifactPropertyName"}, - "value":{"shape":"ProvisioningArtifactPropertyValue"} - }, - "Status":{ - "type":"string", - "enum":[ - "AVAILABLE", - "CREATING", - "FAILED" - ] - }, - "StatusDetail":{"type":"string"}, - "StatusMessage":{ - "type":"string", - "pattern":"[\\u0009\\u000a\\u000d\\u0020-\\uD7FF\\uE000-\\uFFFD]*" - }, - "SupportDescription":{ - "type":"string", - "max":8191 - }, - "SupportEmail":{ - "type":"string", - "max":254 - }, - "SupportUrl":{ - "type":"string", - "max":2083 - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The tag key.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value for this key.

" - } - }, - "documentation":"

Information about a tag. A tag is a key-value pair. Tags are propagated to the resources created when provisioning a product.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagOptionActive":{"type":"boolean"}, - "TagOptionDetail":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagOptionKey", - "documentation":"

The TagOption key.

" - }, - "Value":{ - "shape":"TagOptionValue", - "documentation":"

The TagOption value.

" - }, - "Active":{ - "shape":"TagOptionActive", - "documentation":"

The TagOption active state.

" - }, - "Id":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - } - }, - "documentation":"

Information about a TagOption.

" - }, - "TagOptionDetails":{ - "type":"list", - "member":{"shape":"TagOptionDetail"} - }, - "TagOptionId":{ - "type":"string", - "max":100, - "min":1 - }, - "TagOptionKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagOptionNotMigratedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

An operation requiring TagOptions failed because the TagOptions migration process has not been performed for this account. Please use the AWS console to perform the migration process before retrying the operation.

", - "exception":true - }, - "TagOptionSummaries":{ - "type":"list", - "member":{"shape":"TagOptionSummary"} - }, - "TagOptionSummary":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TagOptionKey", - "documentation":"

The TagOption key.

" - }, - "Values":{ - "shape":"TagOptionValues", - "documentation":"

The TagOption value.

" - } - }, - "documentation":"

Summary information about a TagOption.

" - }, - "TagOptionValue":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagOptionValues":{ - "type":"list", - "member":{"shape":"TagOptionValue"} - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":50 - }, - "TerminateProvisionedProductInput":{ - "type":"structure", - "required":["TerminateToken"], - "members":{ - "ProvisionedProductName":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The name of the provisioned product. You cannot specify both ProvisionedProductName and ProvisionedProductId.

" - }, - "ProvisionedProductId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioned product. You cannot specify both ProvisionedProductName and ProvisionedProductId.

" - }, - "TerminateToken":{ - "shape":"IdempotencyToken", - "documentation":"

An idempotency token that uniquely identifies the termination request. This token is only valid during the termination process. After the provisioned product is terminated, subsequent requests to terminate the same provisioned product always return ResourceNotFound.

", - "idempotencyToken":true - }, - "IgnoreErrors":{ - "shape":"IgnoreErrors", - "documentation":"

If set to true, AWS Service Catalog stops managing the specified provisioned product even if it cannot delete the underlying resources.

" - }, - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - } - } - }, - "TerminateProvisionedProductOutput":{ - "type":"structure", - "members":{ - "RecordDetail":{ - "shape":"RecordDetail", - "documentation":"

Information about the result of this request.

" - } - } - }, - "TotalResultsCount":{"type":"integer"}, - "UpdateConstraintInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The identifier of the constraint.

" - }, - "Description":{ - "shape":"ConstraintDescription", - "documentation":"

The updated description of the constraint.

" - } - } - }, - "UpdateConstraintOutput":{ - "type":"structure", - "members":{ - "ConstraintDetail":{ - "shape":"ConstraintDetail", - "documentation":"

Information about the constraint.

" - }, - "ConstraintParameters":{ - "shape":"ConstraintParameters", - "documentation":"

The constraint parameters.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "UpdatePortfolioInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The portfolio identifier.

" - }, - "DisplayName":{ - "shape":"PortfolioDisplayName", - "documentation":"

The name to use for display purposes.

" - }, - "Description":{ - "shape":"PortfolioDescription", - "documentation":"

The updated description of the portfolio.

" - }, - "ProviderName":{ - "shape":"ProviderName", - "documentation":"

The updated name of the portfolio provider.

" - }, - "AddTags":{ - "shape":"AddTags", - "documentation":"

The tags to add.

" - }, - "RemoveTags":{ - "shape":"TagKeys", - "documentation":"

The tags to remove.

" - } - } - }, - "UpdatePortfolioOutput":{ - "type":"structure", - "members":{ - "PortfolioDetail":{ - "shape":"PortfolioDetail", - "documentation":"

Information about the portfolio.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the portfolio.

" - } - } - }, - "UpdateProductInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "Id":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "Name":{ - "shape":"ProductViewName", - "documentation":"

The updated product name.

" - }, - "Owner":{ - "shape":"ProductViewOwner", - "documentation":"

The updated owner of the product.

" - }, - "Description":{ - "shape":"ProductViewShortDescription", - "documentation":"

The updated description of the product.

" - }, - "Distributor":{ - "shape":"ProductViewOwner", - "documentation":"

The updated distributor of the product.

" - }, - "SupportDescription":{ - "shape":"SupportDescription", - "documentation":"

The updated support description for the product.

" - }, - "SupportEmail":{ - "shape":"SupportEmail", - "documentation":"

The updated support email for the product.

" - }, - "SupportUrl":{ - "shape":"SupportUrl", - "documentation":"

The updated support URL for the product.

" - }, - "AddTags":{ - "shape":"AddTags", - "documentation":"

The tags to add to the product.

" - }, - "RemoveTags":{ - "shape":"TagKeys", - "documentation":"

The tags to remove from the product.

" - } - } - }, - "UpdateProductOutput":{ - "type":"structure", - "members":{ - "ProductViewDetail":{ - "shape":"ProductViewDetail", - "documentation":"

Information about the product view.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

Information about the tags associated with the product.

" - } - } - }, - "UpdateProvisionedProductInput":{ - "type":"structure", - "required":["UpdateToken"], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProvisionedProductName":{ - "shape":"ProvisionedProductNameOrArn", - "documentation":"

The updated name of the provisioned product. You cannot specify both ProvisionedProductName and ProvisionedProductId.

" - }, - "ProvisionedProductId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioned product. You cannot specify both ProvisionedProductName and ProvisionedProductId.

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioned product.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "PathId":{ - "shape":"Id", - "documentation":"

The new path identifier. This value is optional if the product has a default path, and required if the product has more than one path.

" - }, - "ProvisioningParameters":{ - "shape":"UpdateProvisioningParameters", - "documentation":"

The new parameters.

" - }, - "UpdateToken":{ - "shape":"IdempotencyToken", - "documentation":"

The idempotency token that uniquely identifies the provisioning update request.

", - "idempotencyToken":true - } - } - }, - "UpdateProvisionedProductOutput":{ - "type":"structure", - "members":{ - "RecordDetail":{ - "shape":"RecordDetail", - "documentation":"

Information about the result of the request.

" - } - } - }, - "UpdateProvisioningArtifactInput":{ - "type":"structure", - "required":[ - "ProductId", - "ProvisioningArtifactId" - ], - "members":{ - "AcceptLanguage":{ - "shape":"AcceptLanguage", - "documentation":"

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

" - }, - "ProductId":{ - "shape":"Id", - "documentation":"

The product identifier.

" - }, - "ProvisioningArtifactId":{ - "shape":"Id", - "documentation":"

The identifier of the provisioning artifact.

" - }, - "Name":{ - "shape":"ProvisioningArtifactName", - "documentation":"

The updated name of the provisioning artifact.

" - }, - "Description":{ - "shape":"ProvisioningArtifactDescription", - "documentation":"

The updated description of the provisioning artifact.

" - }, - "Active":{ - "shape":"ProvisioningArtifactActive", - "documentation":"

Indicates whether the product version is active.

" - } - } - }, - "UpdateProvisioningArtifactOutput":{ - "type":"structure", - "members":{ - "ProvisioningArtifactDetail":{ - "shape":"ProvisioningArtifactDetail", - "documentation":"

Information about the provisioning artifact.

" - }, - "Info":{ - "shape":"ProvisioningArtifactInfo", - "documentation":"

The URL of the CloudFormation template in Amazon S3.

" - }, - "Status":{ - "shape":"Status", - "documentation":"

The status of the current request.

" - } - } - }, - "UpdateProvisioningParameter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"ParameterKey", - "documentation":"

The parameter key.

" - }, - "Value":{ - "shape":"ParameterValue", - "documentation":"

The parameter value.

" - }, - "UsePreviousValue":{ - "shape":"UsePreviousValue", - "documentation":"

If set to true, Value is ignored and the previous parameter value is kept.

" - } - }, - "documentation":"

The parameter key-value pair used to update a provisioned product.

" - }, - "UpdateProvisioningParameters":{ - "type":"list", - "member":{"shape":"UpdateProvisioningParameter"} - }, - "UpdateTagOptionInput":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"TagOptionId", - "documentation":"

The TagOption identifier.

" - }, - "Value":{ - "shape":"TagOptionValue", - "documentation":"

The updated value.

" - }, - "Active":{ - "shape":"TagOptionActive", - "documentation":"

The updated active state.

" - } - } - }, - "UpdateTagOptionOutput":{ - "type":"structure", - "members":{ - "TagOptionDetail":{ - "shape":"TagOptionDetail", - "documentation":"

Information about the TagOption.

" - } - } - }, - "UpdatedTime":{"type":"timestamp"}, - "UsageInstruction":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"InstructionType", - "documentation":"

The usage instruction type for the value.

" - }, - "Value":{ - "shape":"InstructionValue", - "documentation":"

The usage instruction value for this type.

" - } - }, - "documentation":"

Additional information provided by the administrator.

" - }, - "UsageInstructions":{ - "type":"list", - "member":{"shape":"UsageInstruction"} - }, - "UsePreviousValue":{"type":"boolean"}, - "UserArn":{"type":"string"}, - "UserArnSession":{"type":"string"}, - "Verbose":{"type":"boolean"} - }, - "documentation":"AWS Service Catalog

AWS Service Catalog enables organizations to create and manage catalogs of IT services that are approved for use on AWS. To get the most out of this documentation, you should be familiar with the terminology discussed in AWS Service Catalog Concepts.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/paginators-1.json deleted file mode 100644 index f58df70e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "ListServices": { - "result_key": "Services", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListInstances": { - "result_key": "Instances", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListNamespaces": { - "result_key": "Namespaces", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListOperations": { - "result_key": "Operations", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/service-2.json deleted file mode 100644 index e6c0f80a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/servicediscovery/2017-03-14/service-2.json +++ /dev/null @@ -1,1481 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-03-14", - "endpointPrefix":"servicediscovery", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"ServiceDiscovery", - "serviceFullName":"Amazon Route 53 Auto Naming", - "serviceId":"ServiceDiscovery", - "signatureVersion":"v4", - "targetPrefix":"Route53AutoNaming_v20170314", - "uid":"servicediscovery-2017-03-14" - }, - "operations":{ - "CreatePrivateDnsNamespace":{ - "name":"CreatePrivateDnsNamespace", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePrivateDnsNamespaceRequest"}, - "output":{"shape":"CreatePrivateDnsNamespaceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NamespaceAlreadyExists"}, - {"shape":"ResourceLimitExceeded"}, - {"shape":"DuplicateRequest"} - ], - "documentation":"

Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see Limits on Auto Naming in the Route 53 Developer Guide.

" - }, - "CreatePublicDnsNamespace":{ - "name":"CreatePublicDnsNamespace", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePublicDnsNamespaceRequest"}, - "output":{"shape":"CreatePublicDnsNamespaceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NamespaceAlreadyExists"}, - {"shape":"ResourceLimitExceeded"}, - {"shape":"DuplicateRequest"} - ], - "documentation":"

Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see Limits on Auto Naming in the Route 53 Developer Guide.

" - }, - "CreateService":{ - "name":"CreateService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateServiceRequest"}, - "output":{"shape":"CreateServiceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"ResourceLimitExceeded"}, - {"shape":"NamespaceNotFound"}, - {"shape":"ServiceAlreadyExists"} - ], - "documentation":"

Creates a service, which defines the configuration for the following entities:

  • Up to three records (A, AAAA, and SRV) or one CNAME record

  • Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and Amazon Route 53 uses the values in the configuration to create the specified entities.

For the current limit on the number of instances that you can register using the same namespace and using the same service, see Limits on Auto Naming in the Route 53 Developer Guide.

" - }, - "DeleteNamespace":{ - "name":"DeleteNamespace", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteNamespaceRequest"}, - "output":{"shape":"DeleteNamespaceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NamespaceNotFound"}, - {"shape":"ResourceInUse"}, - {"shape":"DuplicateRequest"} - ], - "documentation":"

Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.

" - }, - "DeleteService":{ - "name":"DeleteService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServiceRequest"}, - "output":{"shape":"DeleteServiceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"ServiceNotFound"}, - {"shape":"ResourceInUse"} - ], - "documentation":"

Deletes a specified service. If the service still contains one or more registered instances, the request fails.

" - }, - "DeregisterInstance":{ - "name":"DeregisterInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterInstanceRequest"}, - "output":{"shape":"DeregisterInstanceResponse"}, - "errors":[ - {"shape":"DuplicateRequest"}, - {"shape":"InvalidInput"}, - {"shape":"InstanceNotFound"}, - {"shape":"ResourceInUse"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Deletes the records and the health check, if any, that Amazon Route 53 created for the specified instance.

" - }, - "GetInstance":{ - "name":"GetInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstanceRequest"}, - "output":{"shape":"GetInstanceResponse"}, - "errors":[ - {"shape":"InstanceNotFound"}, - {"shape":"InvalidInput"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Gets information about a specified instance.

" - }, - "GetInstancesHealthStatus":{ - "name":"GetInstancesHealthStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInstancesHealthStatusRequest"}, - "output":{"shape":"GetInstancesHealthStatusResponse"}, - "errors":[ - {"shape":"InstanceNotFound"}, - {"shape":"InvalidInput"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.

There is a brief delay between when you register an instance and when the health status for the instance is available.

" - }, - "GetNamespace":{ - "name":"GetNamespace", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetNamespaceRequest"}, - "output":{"shape":"GetNamespaceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"NamespaceNotFound"} - ], - "documentation":"

Gets information about a namespace.

" - }, - "GetOperation":{ - "name":"GetOperation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetOperationRequest"}, - "output":{"shape":"GetOperationResponse"}, - "errors":[ - {"shape":"OperationNotFound"} - ], - "documentation":"

Gets information about any operation that returns an operation ID in the response, such as a CreateService request.

To get a list of operations that match specified criteria, see ListOperations.

" - }, - "GetService":{ - "name":"GetService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetServiceRequest"}, - "output":{"shape":"GetServiceResponse"}, - "errors":[ - {"shape":"InvalidInput"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Gets the settings for a specified service.

" - }, - "ListInstances":{ - "name":"ListInstances", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInstancesRequest"}, - "output":{"shape":"ListInstancesResponse"}, - "errors":[ - {"shape":"ServiceNotFound"}, - {"shape":"InvalidInput"} - ], - "documentation":"

Lists summary information about the instances that you registered by using a specified service.

" - }, - "ListNamespaces":{ - "name":"ListNamespaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListNamespacesRequest"}, - "output":{"shape":"ListNamespacesResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Lists summary information about the namespaces that were created by the current AWS account.

" - }, - "ListOperations":{ - "name":"ListOperations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOperationsRequest"}, - "output":{"shape":"ListOperationsResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Lists operations that match the criteria that you specify.

" - }, - "ListServices":{ - "name":"ListServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListServicesRequest"}, - "output":{"shape":"ListServicesResponse"}, - "errors":[ - {"shape":"InvalidInput"} - ], - "documentation":"

Lists summary information for all the services that are associated with one or more specified namespaces.

" - }, - "RegisterInstance":{ - "name":"RegisterInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterInstanceRequest"}, - "output":{"shape":"RegisterInstanceResponse"}, - "errors":[ - {"shape":"DuplicateRequest"}, - {"shape":"InvalidInput"}, - {"shape":"ResourceInUse"}, - {"shape":"ResourceLimitExceeded"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Creates or updates one or more records and optionally a health check based on the settings in a specified service. When you submit a RegisterInstance request, Amazon Route 53 does the following:

  • For each DNS record that you define in the service specified by ServiceId, creates or updates a record in the hosted zone that is associated with the corresponding namespace

  • If the service includes HealthCheckConfig, creates or updates a health check based on the settings in the health check configuration

  • Associates the health check, if any, with each of the records

One RegisterInstance request must complete before you can submit another request and specify the same service ID and instance ID.

For more information, see CreateService.

When Route 53 receives a DNS query for the specified DNS name, it returns the applicable value:

  • If the health check is healthy: returns all the records

  • If the health check is unhealthy: returns the applicable value for the last healthy instance

  • If you didn't specify a health check configuration: returns all the records

For the current limit on the number of instances that you can register using the same namespace and using the same service, see Limits on Auto Naming in the Route 53 Developer Guide.

" - }, - "UpdateInstanceCustomHealthStatus":{ - "name":"UpdateInstanceCustomHealthStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateInstanceCustomHealthStatusRequest"}, - "errors":[ - {"shape":"InstanceNotFound"}, - {"shape":"ServiceNotFound"}, - {"shape":"CustomHealthNotFound"}, - {"shape":"InvalidInput"} - ] - }, - "UpdateService":{ - "name":"UpdateService", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateServiceRequest"}, - "output":{"shape":"UpdateServiceResponse"}, - "errors":[ - {"shape":"DuplicateRequest"}, - {"shape":"InvalidInput"}, - {"shape":"ServiceNotFound"} - ], - "documentation":"

Submits a request to perform the following operations:

  • Add or delete DnsRecords configurations

  • Update the TTL setting for existing DnsRecords configurations

  • Add, update, or delete HealthCheckConfig for a specified service

You must specify all DnsRecords configurations (and, optionally, HealthCheckConfig) that you want to appear in the updated service. Any current configurations that don't appear in an UpdateService request are deleted.

When you update the TTL setting for a service, Amazon Route 53 also updates the corresponding settings in all the records and health checks that were created by using the specified service.

" - } - }, - "shapes":{ - "Arn":{ - "type":"string", - "max":255 - }, - "AttrKey":{ - "type":"string", - "max":255 - }, - "AttrValue":{ - "type":"string", - "max":255 - }, - "Attributes":{ - "type":"map", - "key":{"shape":"AttrKey"}, - "value":{"shape":"AttrValue"} - }, - "Code":{"type":"string"}, - "CreatePrivateDnsNamespaceRequest":{ - "type":"structure", - "required":[ - "Name", - "Vpc" - ], - "members":{ - "Name":{ - "shape":"NamespaceName", - "documentation":"

The name that you want to assign to this namespace. When you create a namespace, Amazon Route 53 automatically creates a hosted zone that has the same name as the namespace.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed CreatePrivateDnsNamespace requests to be retried without the risk of executing the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.

", - "idempotencyToken":true - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

A description for the namespace.

" - }, - "Vpc":{ - "shape":"ResourceId", - "documentation":"

The ID of the Amazon VPC that you want to associate the namespace with.

" - } - } - }, - "CreatePrivateDnsNamespaceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. To get the status of the operation, see GetOperation.

" - } - } - }, - "CreatePublicDnsNamespaceRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"NamespaceName", - "documentation":"

The name that you want to assign to this namespace.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed CreatePublicDnsNamespace requests to be retried without the risk of executing the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.

", - "idempotencyToken":true - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

A description for the namespace.

" - } - } - }, - "CreatePublicDnsNamespaceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. To get the status of the operation, see GetOperation.

" - } - } - }, - "CreateServiceRequest":{ - "type":"structure", - "required":[ - "Name", - "DnsConfig" - ], - "members":{ - "Name":{ - "shape":"ServiceName", - "documentation":"

The name that you want to assign to the service.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed CreateService requests to be retried without the risk of executing the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.

", - "idempotencyToken":true - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

A description for the service.

" - }, - "DnsConfig":{ - "shape":"DnsConfig", - "documentation":"

A complex type that contains information about the records that you want Route 53 to create when you register an instance.

" - }, - "HealthCheckConfig":{ - "shape":"HealthCheckConfig", - "documentation":"

Public DNS namespaces only. A complex type that contains settings for an optional health check. If you specify settings for a health check, Route 53 associates the health check with all the records that you specify in DnsConfig.

For information about the charges for health checks, see Route 53 Pricing.

" - }, - "HealthCheckCustomConfig":{"shape":"HealthCheckCustomConfig"} - } - }, - "CreateServiceResponse":{ - "type":"structure", - "members":{ - "Service":{ - "shape":"Service", - "documentation":"

A complex type that contains information about the new service.

" - } - } - }, - "CustomHealthNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "exception":true - }, - "CustomHealthStatus":{ - "type":"string", - "enum":[ - "HEALTHY", - "UNHEALTHY" - ] - }, - "DeleteNamespaceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the namespace that you want to delete.

" - } - } - }, - "DeleteNamespaceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. To get the status of the operation, see GetOperation.

" - } - } - }, - "DeleteServiceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that you want to delete.

" - } - } - }, - "DeleteServiceResponse":{ - "type":"structure", - "members":{ - } - }, - "DeregisterInstanceRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "InstanceId" - ], - "members":{ - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that the instance is associated with.

" - }, - "InstanceId":{ - "shape":"ResourceId", - "documentation":"

The value that you specified for Id in the RegisterInstance request.

" - } - } - }, - "DeregisterInstanceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. For more information, see GetOperation.

" - } - } - }, - "DnsConfig":{ - "type":"structure", - "required":[ - "NamespaceId", - "DnsRecords" - ], - "members":{ - "NamespaceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the namespace to use for DNS configuration.

" - }, - "RoutingPolicy":{ - "shape":"RoutingPolicy", - "documentation":"

The routing policy that you want to apply to all records that Route 53 creates when you register an instance and specify this service.

If you want to use this service to register instances that create alias records, specify WEIGHTED for the routing policy.

You can specify the following values:

MULTIVALUE

If you define a health check for the service and the health check is healthy, Route 53 returns the applicable value for up to eight instances.

For example, suppose the service includes configurations for one A record and a health check, and you use the service to register 10 instances. Route 53 responds to DNS queries with IP addresses for up to eight healthy instances. If fewer than eight instances are healthy, Route 53 responds to every DNS query with the IP addresses for all of the healthy instances.

If you don't define a health check for the service, Route 53 assumes that all instances are healthy and returns the values for up to eight instances.

For more information about the multivalue routing policy, see Multivalue Answer Routing in the Route 53 Developer Guide.

WEIGHTED

Route 53 returns the applicable value from one randomly selected instance from among the instances that you registered using the same service. Currently, all records have the same weight, so you can't route more or less traffic to any instances.

For example, suppose the service includes configurations for one A record and a health check, and you use the service to register 10 instances. Route 53 responds to DNS queries with the IP address for one randomly selected instance from among the healthy instances. If no instances are healthy, Route 53 responds to DNS queries as if all of the instances were healthy.

If you don't define a health check for the service, Route 53 assumes that all instances are healthy and returns the applicable value for one randomly selected instance.

For more information about the weighted routing policy, see Weighted Routing in the Route 53 Developer Guide.

" - }, - "DnsRecords":{ - "shape":"DnsRecordList", - "documentation":"

An array that contains one DnsRecord object for each record that you want Route 53 to create when you register an instance.

" - } - }, - "documentation":"

A complex type that contains information about the records that you want Amazon Route 53 to create when you register an instance.

" - }, - "DnsConfigChange":{ - "type":"structure", - "required":["DnsRecords"], - "members":{ - "DnsRecords":{ - "shape":"DnsRecordList", - "documentation":"

An array that contains one DnsRecord object for each record that you want Route 53 to create when you register an instance.

" - } - }, - "documentation":"

A complex type that contains information about changes to the records that Route 53 creates when you register an instance.

" - }, - "DnsProperties":{ - "type":"structure", - "members":{ - "HostedZoneId":{ - "shape":"ResourceId", - "documentation":"

The ID for the hosted zone that Route 53 creates when you create a namespace.

" - } - }, - "documentation":"

A complex type that contains the ID for the hosted zone that Route 53 creates when you create a namespace.

" - }, - "DnsRecord":{ - "type":"structure", - "required":[ - "Type", - "TTL" - ], - "members":{ - "Type":{ - "shape":"RecordType", - "documentation":"

The type of the resource, which indicates the type of value that Route 53 returns in response to DNS queries.

Note the following:

  • A, AAAA, and SRV records: You can specify settings for a maximum of one A, one AAAA, and one SRV record. You can specify them in any combination.

  • CNAME records: If you specify CNAME for Type, you can't define any other records. This is a limitation of DNS—you can't create a CNAME record and any other type of record that has the same name as a CNAME record.

  • Alias records: If you want Route 53 to create an alias record when you register an instance, specify A or AAAA for Type.

  • All records: You specify settings other than TTL and Type when you register an instance.

The following values are supported:

A

Route 53 returns the IP address of the resource in IPv4 format, such as 192.0.2.44.

AAAA

Route 53 returns the IP address of the resource in IPv6 format, such as 2001:0db8:85a3:0000:0000:abcd:0001:2345.

CNAME

Route 53 returns the domain name of the resource, such as www.example.com. Note the following:

  • You specify the domain name that you want to route traffic to when you register an instance. For more information, see RegisterInstanceRequest$Attributes.

  • You must specify WEIGHTED for the value of RoutingPolicy.

  • You can't specify both CNAME for Type and settings for HealthCheckConfig. If you do, the request will fail with an InvalidInput error.

SRV

Route 53 returns the value for an SRV record. The value for an SRV record uses the following values:

priority weight port service-hostname

Note the following about the values:

  • The values of priority and weight are both set to 1 and can't be changed.

  • The value of port comes from the value that you specify for the AWS_INSTANCE_PORT attribute when you submit a RegisterInstance request.

  • The value of service-hostname is a concatenation of the following values:

    • The value that you specify for InstanceId when you register an instance.

    • The name of the service.

    • The name of the namespace.

    For example, if the value of InstanceId is test, the name of the service is backend, and the name of the namespace is example.com, the value of service-hostname is:

    test.backend.example.com

If you specify settings for an SRV record and if you specify values for AWS_INSTANCE_IPV4, AWS_INSTANCE_IPV6, or both in the RegisterInstance request, Route 53 automatically creates A and/or AAAA records that have the same name as the value of service-hostname in the SRV record. You can ignore these records.

" - }, - "TTL":{ - "shape":"RecordTTL", - "documentation":"

The amount of time, in seconds, that you want DNS resolvers to cache the settings for this record.

Alias records don't include a TTL because Route 53 uses the TTL for the AWS resource that an alias record routes traffic to. If you include the AWS_ALIAS_DNS_NAME attribute when you submit a RegisterInstance request, the TTL value is ignored. Always specify a TTL for the service; you can use a service to register instances that create either alias or non-alias records.

" - } - }, - "documentation":"

A complex type that contains information about the records that you want Route 53 to create when you register an instance.

" - }, - "DnsRecordList":{ - "type":"list", - "member":{"shape":"DnsRecord"} - }, - "DuplicateRequest":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The operation is already in progress.

", - "exception":true - }, - "ErrorMessage":{"type":"string"}, - "FailureThreshold":{ - "type":"integer", - "max":10, - "min":1 - }, - "FilterCondition":{ - "type":"string", - "enum":[ - "EQ", - "IN", - "BETWEEN" - ] - }, - "FilterValue":{ - "type":"string", - "max":255, - "min":1 - }, - "FilterValues":{ - "type":"list", - "member":{"shape":"FilterValue"} - }, - "GetInstanceRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "InstanceId" - ], - "members":{ - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that the instance is associated with.

" - }, - "InstanceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the instance that you want to get information about.

" - } - } - }, - "GetInstanceResponse":{ - "type":"structure", - "members":{ - "Instance":{ - "shape":"Instance", - "documentation":"

A complex type that contains information about a specified instance.

" - } - } - }, - "GetInstancesHealthStatusRequest":{ - "type":"structure", - "required":["ServiceId"], - "members":{ - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that the instance is associated with.

" - }, - "Instances":{ - "shape":"InstanceIdList", - "documentation":"

An array that contains the IDs of all the instances that you want to get the health status for.

If you omit Instances, Amazon Route 53 returns the health status for all the instances that are associated with the specified service.

To get the IDs for the instances that you've registered by using a specified service, submit a ListInstances request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of instances that you want Route 53 to return in the response to a GetInstancesHealthStatus request. If you don't specify a value for MaxResults, Route 53 returns up to 100 instances.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

For the first GetInstancesHealthStatus request, omit this value.

If more than MaxResults instances match the specified criteria, you can submit another GetInstancesHealthStatus request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

" - } - } - }, - "GetInstancesHealthStatusResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"InstanceHealthStatusMap", - "documentation":"

A complex type that contains the IDs and the health status of the instances that you specified in the GetInstancesHealthStatus request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If more than MaxResults instances match the specified criteria, you can submit another GetInstancesHealthStatus request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

" - } - } - }, - "GetNamespaceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the namespace that you want to get information about.

" - } - } - }, - "GetNamespaceResponse":{ - "type":"structure", - "members":{ - "Namespace":{ - "shape":"Namespace", - "documentation":"

A complex type that contains information about the specified namespace.

" - } - } - }, - "GetOperationRequest":{ - "type":"structure", - "required":["OperationId"], - "members":{ - "OperationId":{ - "shape":"ResourceId", - "documentation":"

The ID of the operation that you want to get more information about.

" - } - } - }, - "GetOperationResponse":{ - "type":"structure", - "members":{ - "Operation":{ - "shape":"Operation", - "documentation":"

A complex type that contains information about the operation.

" - } - } - }, - "GetServiceRequest":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that you want to get settings for.

" - } - } - }, - "GetServiceResponse":{ - "type":"structure", - "members":{ - "Service":{ - "shape":"Service", - "documentation":"

A complex type that contains information about the service.

" - } - } - }, - "HealthCheckConfig":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"HealthCheckType", - "documentation":"

The type of health check that you want to create, which indicates how Route 53 determines whether an endpoint is healthy.

You can't change the value of Type after you create a health check.

You can create the following types of health checks:

  • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

  • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

    If you specify HTTPS for the value of Type, the endpoint must support TLS v1.0 or later.

  • TCP: Route 53 tries to establish a TCP connection.

For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Route 53 Developer Guide.

" - }, - "ResourcePath":{ - "shape":"ResourcePath", - "documentation":"

The path that you want Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, such as the file /docs/route53-health-check.html. Route 53 automatically adds the DNS name for the service and a leading forward slash (/) character.

" - }, - "FailureThreshold":{ - "shape":"FailureThreshold", - "documentation":"

The number of consecutive health checks that an endpoint must pass or fail for Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Route 53 Developer Guide.

" - } - }, - "documentation":"

Public DNS namespaces only. A complex type that contains settings for an optional health check. If you specify settings for a health check, Amazon Route 53 associates the health check with all the records that you specify in DnsConfig.

A and AAAA records

If DnsConfig includes configurations for both A and AAAA records, Route 53 creates a health check that uses the IPv4 address to check the health of the resource. If the endpoint that is specified by the IPv4 address is unhealthy, Route 53 considers both the A and AAAA records to be unhealthy.

CNAME records

You can't specify settings for HealthCheckConfig when the DNSConfig includes CNAME for the value of Type. If you do, the CreateService request will fail with an InvalidInput error.

Request interval

The health check uses 30 seconds as the request interval. This is the number of seconds between the time that each Route 53 health checker gets a response from your endpoint and the time that it sends the next health check request. A health checker in each data center around the world sends your endpoint a health check request every 30 seconds. On average, your endpoint receives a health check request about every two seconds. Health checkers in different data centers don't coordinate with one another, so you'll sometimes see several requests per second followed by a few seconds with no health checks at all.

Health checking regions

Health checkers perform checks from all Route 53 health-checking regions. For a list of the current regions, see Regions.

Alias records

When you register an instance, if you include the AWS_ALIAS_DNS_NAME attribute, Route 53 creates an alias record. Note the following:

  • Route 53 automatically sets EvaluateTargetHealth to true for alias records. When EvaluateTargetHealth is true, the alias record inherits the health of the referenced AWS resource. such as an ELB load balancer. For more information, see EvaluateTargetHealth.

  • If you include HealthCheckConfig and then use the service to register an instance that creates an alias record, Route 53 doesn't create the health check.

For information about the charges for health checks, see Route 53 Pricing.

" - }, - "HealthCheckCustomConfig":{ - "type":"structure", - "members":{ - "FailureThreshold":{"shape":"FailureThreshold"} - } - }, - "HealthCheckType":{ - "type":"string", - "enum":[ - "HTTP", - "HTTPS", - "TCP" - ] - }, - "HealthStatus":{ - "type":"string", - "enum":[ - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - }, - "Instance":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

An identifier that you want to associate with the instance. Note the following:

  • If the service that is specified by ServiceId includes settings for an SRV record, the value of InstanceId is automatically included as part of the value for the SRV record. For more information, see DnsRecord$Type.

  • You can use this value to update an existing instance.

  • To register a new instance, you must specify a value that is unique among instances that you register by using the same service.

  • If you specify an existing InstanceId and ServiceId, Route 53 updates the existing records. If there's also an existing health check, Route 53 deletes the old health check and creates a new one.

    The health check isn't deleted immediately, so it will still appear for a while if you submit a ListHealthChecks request, for example.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed RegisterInstance requests to be retried without the risk of executing the operation twice. You must use a unique CreatorRequestId string every time you submit a RegisterInstance request if you're registering additional instances for the same namespace and service. CreatorRequestId can be any unique string, for example, a date/time stamp.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

A string map that contains the following information for the service that you specify in ServiceId:

  • The attributes that apply to the records that are defined in the service.

  • For each attribute, the applicable value.

Supported attribute keys include the following:

AWS_ALIAS_DNS_NAME

If you want Route 53 to create an alias record that routes traffic to an Elastic Load Balancing load balancer, specify the DNS name that is associated with the load balancer. For information about how to get the DNS name, see \"DNSName\" in the topic AliasTarget.

Note the following:

  • The configuration for the service that is specified by ServiceId must include settings for an A record, an AAAA record, or both.

  • In the service that is specified by ServiceId, the value of RoutingPolicy must be WEIGHTED.

  • If the service that is specified by ServiceId includes HealthCheckConfig settings, Route 53 will create the health check, but it won't associate the health check with the alias record.

  • Auto naming currently doesn't support creating alias records that route traffic to AWS resources other than ELB load balancers.

  • If you specify a value for AWS_ALIAS_DNS_NAME, don't specify values for any of the AWS_INSTANCE attributes.

AWS_INSTANCE_CNAME

If the service configuration includes a CNAME record, the domain name that you want Route 53 to return in response to DNS queries, for example, example.com.

This value is required if the service specified by ServiceId includes settings for an CNAME record.

AWS_INSTANCE_IPV4

If the service configuration includes an A record, the IPv4 address that you want Route 53 to return in response to DNS queries, for example, 192.0.2.44.

This value is required if the service specified by ServiceId includes settings for an A record. If the service includes settings for an SRV record, you must specify a value for AWS_INSTANCE_IPV4, AWS_INSTANCE_IPV6, or both.

AWS_INSTANCE_IPV6

If the service configuration includes an AAAA record, the IPv6 address that you want Route 53 to return in response to DNS queries, for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345.

This value is required if the service specified by ServiceId includes settings for an AAAA record. If the service includes settings for an SRV record, you must specify a value for AWS_INSTANCE_IPV4, AWS_INSTANCE_IPV6, or both.

AWS_INSTANCE_PORT

If the service includes an SRV record, the value that you want Route 53 to return for the port.

If the service includes HealthCheckConfig, the port on the endpoint that you want Route 53 to send requests to.

This value is required if you specified settings for an SRV record when you created the service.

" - } - }, - "documentation":"

A complex type that contains information about an instance that Amazon Route 53 creates when you submit a RegisterInstance request.

" - }, - "InstanceHealthStatusMap":{ - "type":"map", - "key":{"shape":"ResourceId"}, - "value":{"shape":"HealthStatus"} - }, - "InstanceIdList":{ - "type":"list", - "member":{"shape":"ResourceId"}, - "min":1 - }, - "InstanceNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

No instance exists with the specified ID, or the instance was recently registered, and information about the instance hasn't propagated yet.

", - "exception":true - }, - "InstanceSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID for an instance that you created by using a specified service.

" - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

A string map that contains the following information:

  • The attributes that are associate with the instance.

  • For each attribute, the applicable value.

Supported attribute keys include the following:

  • AWS_ALIAS_DNS_NAME: For an alias record that routes traffic to an Elastic Load Balancing load balancer, the DNS name that is associated with the load balancer.

  • AWS_INSTANCE_CNAME: For a CNAME record, the domain name that Route 53 returns in response to DNS queries, for example, example.com.

  • AWS_INSTANCE_IPV4: For an A record, the IPv4 address that Route 53 returns in response to DNS queries, for example, 192.0.2.44.

  • AWS_INSTANCE_IPV6: For an AAAA record, the IPv6 address that Route 53 returns in response to DNS queries, for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345.

  • AWS_INSTANCE_PORT: For an SRV record, the value that Route 53 returns for the port. In addition, if the service includes HealthCheckConfig, the port on the endpoint that Route 53 sends requests to.

" - } - }, - "documentation":"

A complex type that contains information about the instances that you registered by using a specified service.

" - }, - "InstanceSummaryList":{ - "type":"list", - "member":{"shape":"InstanceSummary"} - }, - "InvalidInput":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

One or more specified values aren't valid. For example, when you're creating a namespace, the value of Name might not be a valid DNS name.

", - "exception":true - }, - "ListInstancesRequest":{ - "type":"structure", - "required":["ServiceId"], - "members":{ - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that you want to list instances for.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

For the first ListInstances request, omit this value.

If more than MaxResults instances match the specified criteria, you can submit another ListInstances request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of instances that you want Amazon Route 53 to return in the response to a ListInstances request. If you don't specify a value for MaxResults, Route 53 returns up to 100 instances.

" - } - } - }, - "ListInstancesResponse":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"InstanceSummaryList", - "documentation":"

Summary information about the instances that are associated with the specified service.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If more than MaxResults instances match the specified criteria, you can submit another ListInstances request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

" - } - } - }, - "ListNamespacesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

For the first ListNamespaces request, omit this value.

If the response contains NextToken, submit another ListNamespaces request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults namespaces and then filters them based on the specified criteria. It's possible that no namespaces in the first MaxResults namespaces matched the specified criteria but that subsequent groups of MaxResults namespaces do contain namespaces that match the criteria.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of namespaces that you want Amazon Route 53 to return in the response to a ListNamespaces request. If you don't specify a value for MaxResults, Route 53 returns up to 100 namespaces.

" - }, - "Filters":{ - "shape":"NamespaceFilters", - "documentation":"

A complex type that contains specifications for the namespaces that you want to list.

If you specify more than one filter, a namespace must match all filters to be returned by ListNamespaces.

" - } - } - }, - "ListNamespacesResponse":{ - "type":"structure", - "members":{ - "Namespaces":{ - "shape":"NamespaceSummariesList", - "documentation":"

An array that contains one NamespaceSummary object for each namespace that matches the specified filter criteria.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response contains NextToken, submit another ListNamespaces request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults namespaces and then filters them based on the specified criteria. It's possible that no namespaces in the first MaxResults namespaces matched the specified criteria but that subsequent groups of MaxResults namespaces do contain namespaces that match the criteria.

" - } - } - }, - "ListOperationsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

For the first ListOperations request, omit this value.

If the response contains NextToken, submit another ListOperations request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults operations and then filters them based on the specified criteria. It's possible that no operations in the first MaxResults operations matched the specified criteria but that subsequent groups of MaxResults operations do contain operations that match the criteria.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items that you want Amazon Route 53 to return in the response to a ListOperations request. If you don't specify a value for MaxResults, Route 53 returns up to 100 operations.

" - }, - "Filters":{ - "shape":"OperationFilters", - "documentation":"

A complex type that contains specifications for the operations that you want to list, for example, operations that you started between a specified start date and end date.

If you specify more than one filter, an operation must match all filters to be returned by ListOperations.

" - } - } - }, - "ListOperationsResponse":{ - "type":"structure", - "members":{ - "Operations":{ - "shape":"OperationSummaryList", - "documentation":"

Summary information about the operations that match the specified criteria.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response contains NextToken, submit another ListOperations request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults operations and then filters them based on the specified criteria. It's possible that no operations in the first MaxResults operations matched the specified criteria but that subsequent groups of MaxResults operations do contain operations that match the criteria.

" - } - } - }, - "ListServicesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

For the first ListServices request, omit this value.

If the response contains NextToken, submit another ListServices request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults services and then filters them based on the specified criteria. It's possible that no services in the first MaxResults services matched the specified criteria but that subsequent groups of MaxResults services do contain services that match the criteria.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of services that you want Amazon Route 53 to return in the response to a ListServices request. If you don't specify a value for MaxResults, Route 53 returns up to 100 services.

" - }, - "Filters":{ - "shape":"ServiceFilters", - "documentation":"

A complex type that contains specifications for the namespaces that you want to list services for.

If you specify more than one filter, an operation must match all filters to be returned by ListServices.

" - } - } - }, - "ListServicesResponse":{ - "type":"structure", - "members":{ - "Services":{ - "shape":"ServiceSummariesList", - "documentation":"

An array that contains one ServiceSummary object for each service that matches the specified filter criteria.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the response contains NextToken, submit another ListServices request to get the next group of results. Specify the value of NextToken from the previous response in the next request.

Route 53 gets MaxResults services and then filters them based on the specified criteria. It's possible that no services in the first MaxResults services matched the specified criteria but that subsequent groups of MaxResults services do contain services that match the criteria.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "Message":{"type":"string"}, - "Namespace":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of a namespace.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that Route 53 assigns to the namespace when you create it.

" - }, - "Name":{ - "shape":"NamespaceName", - "documentation":"

The name of the namespace, such as example.com.

" - }, - "Type":{ - "shape":"NamespaceType", - "documentation":"

The type of the namespace. Valid values are DNS_PUBLIC and DNS_PRIVATE.

" - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

The description that you specify for the namespace when you create it.

" - }, - "ServiceCount":{ - "shape":"ResourceCount", - "documentation":"

The number of services that are associated with the namespace.

" - }, - "Properties":{ - "shape":"NamespaceProperties", - "documentation":"

A complex type that contains information that's specific to the type of the namespace.

" - }, - "CreateDate":{ - "shape":"Timestamp", - "documentation":"

The date that the namespace was created, in Unix date/time format and Coordinated Universal Time (UTC). The value of CreateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed requests to be retried without the risk of executing an operation twice.

" - } - }, - "documentation":"

A complex type that contains information about a specified namespace.

" - }, - "NamespaceAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

The CreatorRequestId that was used to create the namespace.

" - }, - "NamespaceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the existing namespace.

" - } - }, - "documentation":"

The namespace that you're trying to create already exists.

", - "exception":true - }, - "NamespaceFilter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"NamespaceFilterName", - "documentation":"

Specify TYPE.

" - }, - "Values":{ - "shape":"FilterValues", - "documentation":"

If you specify EQ for Condition, specify either DNS_PUBLIC or DNS_PRIVATE.

If you specify IN for Condition, you can specify DNS_PUBLIC, DNS_PRIVATE, or both.

" - }, - "Condition":{ - "shape":"FilterCondition", - "documentation":"

The operator that you want to use to determine whether ListNamespaces returns a namespace. Valid values for condition include:

  • EQ: When you specify EQ for the condition, you can choose to list only public namespaces or private namespaces, but not both. EQ is the default condition and can be omitted.

  • IN: When you specify IN for the condition, you can choose to list public namespaces, private namespaces, or both.

  • BETWEEN: Not applicable

" - } - }, - "documentation":"

A complex type that identifies the namespaces that you want to list. You can choose to list public or private namespaces.

" - }, - "NamespaceFilterName":{ - "type":"string", - "enum":["TYPE"] - }, - "NamespaceFilters":{ - "type":"list", - "member":{"shape":"NamespaceFilter"} - }, - "NamespaceName":{ - "type":"string", - "max":1024 - }, - "NamespaceNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

No namespace exists with the specified ID.

", - "exception":true - }, - "NamespaceProperties":{ - "type":"structure", - "members":{ - "DnsProperties":{ - "shape":"DnsProperties", - "documentation":"

A complex type that contains the ID for the hosted zone that Route 53 creates when you create a namespace.

" - } - }, - "documentation":"

A complex type that contains information that is specific to the namespace type.

" - }, - "NamespaceSummariesList":{ - "type":"list", - "member":{"shape":"NamespaceSummary"} - }, - "NamespaceSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the namespace.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that Route 53 assigns to the namespace when you create it.

" - }, - "Name":{ - "shape":"NamespaceName", - "documentation":"

The name of the namespace. When you create a namespace, Route 53 automatically creates a hosted zone that has the same name as the namespace.

" - }, - "Type":{ - "shape":"NamespaceType", - "documentation":"

The type of the namespace, either public or private.

" - } - }, - "documentation":"

A complex type that contains information about a namespace.

" - }, - "NamespaceType":{ - "type":"string", - "enum":[ - "DNS_PUBLIC", - "DNS_PRIVATE" - ] - }, - "NextToken":{ - "type":"string", - "max":4096 - }, - "Operation":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"OperationId", - "documentation":"

The ID of the operation that you want to get information about.

" - }, - "Type":{ - "shape":"OperationType", - "documentation":"

The name of the operation that is associated with the specified ID.

" - }, - "Status":{ - "shape":"OperationStatus", - "documentation":"

The status of the operation. Values include the following:

  • SUBMITTED: This is the initial state immediately after you submit a request.

  • PENDING: Route 53 is performing the operation.

  • SUCCESS: The operation succeeded.

  • FAIL: The operation failed. For the failure reason, see ErrorMessage.

" - }, - "ErrorMessage":{ - "shape":"Message", - "documentation":"

If the value of Status is FAIL, the reason that the operation failed.

" - }, - "ErrorCode":{ - "shape":"Code", - "documentation":"

The code associated with ErrorMessage. Values for ErrorCode include the following:

  • ACCESS_DENIED

  • CANNOT_CREATE_HOSTED_ZONE

  • EXPIRED_TOKEN

  • HOSTED_ZONE_NOT_FOUND

  • INTERNAL_FAILURE

  • INVALID_CHANGE_BATCH

  • THROTTLED_REQUEST

" - }, - "CreateDate":{ - "shape":"Timestamp", - "documentation":"

The date and time that the request was submitted, in Unix date/time format and Coordinated Universal Time (UTC). The value of CreateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

" - }, - "UpdateDate":{ - "shape":"Timestamp", - "documentation":"

The date and time that the value of Status changed to the current value, in Unix date/time format and Coordinated Universal Time (UTC). The value of UpdateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

" - }, - "Targets":{ - "shape":"OperationTargetsMap", - "documentation":"

The name of the target entity that is associated with the operation:

  • NAMESPACE: The namespace ID is returned in the ResourceId property.

  • SERVICE: The service ID is returned in the ResourceId property.

  • INSTANCE: The instance ID is returned in the ResourceId property.

" - } - }, - "documentation":"

A complex type that contains information about a specified operation.

" - }, - "OperationFilter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"OperationFilterName", - "documentation":"

Specify the operations that you want to get:

  • NAMESPACE_ID: Gets operations related to specified namespaces.

  • SERVICE_ID: Gets operations related to specified services.

  • STATUS: Gets operations based on the status of the operations: SUBMITTED, PENDING, SUCCEED, or FAIL.

  • TYPE: Gets specified types of operation.

  • UPDATE_DATE: Gets operations that changed status during a specified date/time range.

" - }, - "Values":{ - "shape":"FilterValues", - "documentation":"

Specify values that are applicable to the value that you specify for Name:

  • NAMESPACE_ID: Specify one namespace ID.

  • SERVICE_ID: Specify one service ID.

  • STATUS: Specify one or more statuses: SUBMITTED, PENDING, SUCCEED, or FAIL.

  • TYPE: Specify one or more of the following types: CREATE_NAMESPACE, DELETE_NAMESPACE, UPDATE_SERVICE, REGISTER_INSTANCE, or DEREGISTER_INSTANCE.

  • UPDATE_DATE: Specify a start date and an end date in Unix date/time format and Coordinated Universal Time (UTC). The start date must be the first value.

" - }, - "Condition":{ - "shape":"FilterCondition", - "documentation":"

The operator that you want to use to determine whether an operation matches the specified value. Valid values for condition include:

  • EQ: When you specify EQ for the condition, you can specify only one value. EQ is supported for NAMESPACE_ID, SERVICE_ID, STATUS, and TYPE. EQ is the default condition and can be omitted.

  • IN: When you specify IN for the condition, you can specify a list of one or more values. IN is supported for STATUS and TYPE. An operation must match one of the specified values to be returned in the response.

  • BETWEEN: Specify a start date and an end date in Unix date/time format and Coordinated Universal Time (UTC). The start date must be the first value. BETWEEN is supported for UPDATE_DATE.

" - } - }, - "documentation":"

A complex type that lets you select the operations that you want to list.

" - }, - "OperationFilterName":{ - "type":"string", - "enum":[ - "NAMESPACE_ID", - "SERVICE_ID", - "STATUS", - "TYPE", - "UPDATE_DATE" - ] - }, - "OperationFilters":{ - "type":"list", - "member":{"shape":"OperationFilter"} - }, - "OperationId":{ - "type":"string", - "max":255 - }, - "OperationNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

No operation exists with the specified ID.

", - "exception":true - }, - "OperationStatus":{ - "type":"string", - "enum":[ - "SUBMITTED", - "PENDING", - "SUCCESS", - "FAIL" - ] - }, - "OperationSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"OperationId", - "documentation":"

The ID for an operation.

" - }, - "Status":{ - "shape":"OperationStatus", - "documentation":"

The status of the operation. Values include the following:

  • SUBMITTED: This is the initial state immediately after you submit a request.

  • PENDING: Route 53 is performing the operation.

  • SUCCESS: The operation succeeded.

  • FAIL: The operation failed. For the failure reason, see ErrorMessage.

" - } - }, - "documentation":"

A complex type that contains information about an operation that matches the criteria that you specified in a ListOperations request.

" - }, - "OperationSummaryList":{ - "type":"list", - "member":{"shape":"OperationSummary"} - }, - "OperationTargetType":{ - "type":"string", - "enum":[ - "NAMESPACE", - "SERVICE", - "INSTANCE" - ] - }, - "OperationTargetsMap":{ - "type":"map", - "key":{"shape":"OperationTargetType"}, - "value":{"shape":"ResourceId"} - }, - "OperationType":{ - "type":"string", - "enum":[ - "CREATE_NAMESPACE", - "DELETE_NAMESPACE", - "UPDATE_SERVICE", - "REGISTER_INSTANCE", - "DEREGISTER_INSTANCE" - ] - }, - "RecordTTL":{ - "type":"long", - "max":2147483647, - "min":0 - }, - "RecordType":{ - "type":"string", - "enum":[ - "SRV", - "A", - "AAAA", - "CNAME" - ] - }, - "RegisterInstanceRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "InstanceId", - "Attributes" - ], - "members":{ - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that you want to use for settings for the records and health check that Route 53 will create.

" - }, - "InstanceId":{ - "shape":"ResourceId", - "documentation":"

An identifier that you want to associate with the instance. Note the following:

  • If the service that is specified by ServiceId includes settings for an SRV record, the value of InstanceId is automatically included as part of the value for the SRV record. For more information, see DnsRecord$Type.

  • You can use this value to update an existing instance.

  • To register a new instance, you must specify a value that is unique among instances that you register by using the same service.

  • If you specify an existing InstanceId and ServiceId, Route 53 updates the existing records. If there's also an existing health check, Route 53 deletes the old health check and creates a new one.

    The health check isn't deleted immediately, so it will still appear for a while if you submit a ListHealthChecks request, for example.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed RegisterInstance requests to be retried without the risk of executing the operation twice. You must use a unique CreatorRequestId string every time you submit a RegisterInstance request if you're registering additional instances for the same namespace and service. CreatorRequestId can be any unique string, for example, a date/time stamp.

", - "idempotencyToken":true - }, - "Attributes":{ - "shape":"Attributes", - "documentation":"

A string map that contains the following information for the service that you specify in ServiceId:

  • The attributes that apply to the records that are defined in the service.

  • For each attribute, the applicable value.

Supported attribute keys include the following:

AWS_ALIAS_DNS_NAME

If you want Route 53 to create an alias record that routes traffic to an Elastic Load Balancing load balancer, specify the DNS name that is associated with the load balancer. For information about how to get the DNS name, see \"DNSName\" in the topic AliasTarget.

Note the following:

  • The configuration for the service that is specified by ServiceId must include settings for an A record, an AAAA record, or both.

  • In the service that is specified by ServiceId, the value of RoutingPolicy must be WEIGHTED.

  • If the service that is specified by ServiceId includes HealthCheckConfig settings, Route 53 will create the health check, but it won't associate the health check with the alias record.

  • Auto naming currently doesn't support creating alias records that route traffic to AWS resources other than ELB load balancers.

  • If you specify a value for AWS_ALIAS_DNS_NAME, don't specify values for any of the AWS_INSTANCE attributes.

AWS_INSTANCE_CNAME

If the service configuration includes a CNAME record, the domain name that you want Route 53 to return in response to DNS queries, for example, example.com.

This value is required if the service specified by ServiceId includes settings for an CNAME record.

AWS_INSTANCE_IPV4

If the service configuration includes an A record, the IPv4 address that you want Route 53 to return in response to DNS queries, for example, 192.0.2.44.

This value is required if the service specified by ServiceId includes settings for an A record. If the service includes settings for an SRV record, you must specify a value for AWS_INSTANCE_IPV4, AWS_INSTANCE_IPV6, or both.

AWS_INSTANCE_IPV6

If the service configuration includes an AAAA record, the IPv6 address that you want Route 53 to return in response to DNS queries, for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345.

This value is required if the service specified by ServiceId includes settings for an AAAA record. If the service includes settings for an SRV record, you must specify a value for AWS_INSTANCE_IPV4, AWS_INSTANCE_IPV6, or both.

AWS_INSTANCE_PORT

If the service includes an SRV record, the value that you want Route 53 to return for the port.

If the service includes HealthCheckConfig, the port on the endpoint that you want Route 53 to send requests to.

This value is required if you specified settings for an SRV record when you created the service.

" - } - } - }, - "RegisterInstanceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. To get the status of the operation, see GetOperation.

" - } - } - }, - "ResourceCount":{"type":"integer"}, - "ResourceDescription":{ - "type":"string", - "max":1024 - }, - "ResourceId":{ - "type":"string", - "max":64 - }, - "ResourceInUse":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified resource can't be deleted because it contains other resources. For example, you can't delete a service that contains any instances.

", - "exception":true - }, - "ResourceLimitExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The resource can't be created because you've reached the limit on the number of resources.

", - "exception":true - }, - "ResourcePath":{ - "type":"string", - "max":255 - }, - "RoutingPolicy":{ - "type":"string", - "enum":[ - "MULTIVALUE", - "WEIGHTED" - ] - }, - "Service":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID that Route 53 assigned to the service when you created it.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that Route 53 assigns to the service when you create it.

" - }, - "Name":{ - "shape":"ServiceName", - "documentation":"

The name of the service.

" - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

The description of the service.

" - }, - "InstanceCount":{ - "shape":"ResourceCount", - "documentation":"

The number of instances that are currently associated with the service. Instances that were previously associated with the service but that have been deleted are not included in the count.

" - }, - "DnsConfig":{ - "shape":"DnsConfig", - "documentation":"

A complex type that contains information about the records that you want Route 53 to create when you register an instance.

" - }, - "HealthCheckConfig":{ - "shape":"HealthCheckConfig", - "documentation":"

Public DNS namespaces only. A complex type that contains settings for an optional health check. If you specify settings for a health check, Route 53 associates the health check with all the records that you specify in DnsConfig.

For information about the charges for health checks, see Route 53 Pricing.

" - }, - "HealthCheckCustomConfig":{"shape":"HealthCheckCustomConfig"}, - "CreateDate":{ - "shape":"Timestamp", - "documentation":"

The date and time that the service was created, in Unix format and Coordinated Universal Time (UTC). The value of CreateDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

" - }, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

A unique string that identifies the request and that allows failed requests to be retried without the risk of executing the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.

" - } - }, - "documentation":"

A complex type that contains information about the specified service.

" - }, - "ServiceAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"}, - "CreatorRequestId":{ - "shape":"ResourceId", - "documentation":"

The CreatorRequestId that was used to create the service.

" - }, - "ServiceId":{ - "shape":"ResourceId", - "documentation":"

The ID of the existing service.

" - } - }, - "documentation":"

The service can't be created because a service with the same name already exists.

", - "exception":true - }, - "ServiceChange":{ - "type":"structure", - "required":["DnsConfig"], - "members":{ - "Description":{ - "shape":"ResourceDescription", - "documentation":"

A description for the service.

" - }, - "DnsConfig":{ - "shape":"DnsConfigChange", - "documentation":"

A complex type that contains information about the records that you want Route 53 to create when you register an instance.

" - }, - "HealthCheckConfig":{"shape":"HealthCheckConfig"} - }, - "documentation":"

A complex type that contains changes to an existing service.

" - }, - "ServiceFilter":{ - "type":"structure", - "required":[ - "Name", - "Values" - ], - "members":{ - "Name":{ - "shape":"ServiceFilterName", - "documentation":"

Specify NAMESPACE_ID.

" - }, - "Values":{ - "shape":"FilterValues", - "documentation":"

The values that are applicable to the value that you specify for Condition to filter the list of services.

" - }, - "Condition":{ - "shape":"FilterCondition", - "documentation":"

The operator that you want to use to determine whether a service is returned by ListServices. Valid values for Condition include the following:

  • EQ: When you specify EQ, specify one namespace ID for Values. EQ is the default condition and can be omitted.

  • IN: When you specify IN, specify a list of the IDs for the namespaces that you want ListServices to return a list of services for.

  • BETWEEN: Not applicable.

" - } - }, - "documentation":"

A complex type that lets you specify the namespaces that you want to list services for.

" - }, - "ServiceFilterName":{ - "type":"string", - "enum":["NAMESPACE_ID"] - }, - "ServiceFilters":{ - "type":"list", - "member":{"shape":"ServiceFilter"} - }, - "ServiceName":{ - "type":"string", - "pattern":"((?=^.{1,127}$)^([a-zA-Z0-9_][a-zA-Z0-9-_]{0,61}[a-zA-Z0-9_]|[a-zA-Z0-9])(\\.([a-zA-Z0-9_][a-zA-Z0-9-_]{0,61}[a-zA-Z0-9_]|[a-zA-Z0-9]))*$)|(^\\.$)" - }, - "ServiceNotFound":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

No service exists with the specified ID.

", - "exception":true - }, - "ServiceSummariesList":{ - "type":"list", - "member":{"shape":"ServiceSummary"} - }, - "ServiceSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID that Route 53 assigned to the service when you created it.

" - }, - "Arn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that Route 53 assigns to the service when you create it.

" - }, - "Name":{ - "shape":"ServiceName", - "documentation":"

The name of the service.

" - }, - "Description":{ - "shape":"ResourceDescription", - "documentation":"

The description that you specify when you create the service.

" - }, - "InstanceCount":{ - "shape":"ResourceCount", - "documentation":"

The number of instances that are currently associated with the service. Instances that were previously associated with the service but that have been deleted are not included in the count.

" - } - }, - "documentation":"

A complex type that contains information about a specified service.

" - }, - "Timestamp":{"type":"timestamp"}, - "UpdateInstanceCustomHealthStatusRequest":{ - "type":"structure", - "required":[ - "ServiceId", - "InstanceId", - "Status" - ], - "members":{ - "ServiceId":{"shape":"ResourceId"}, - "InstanceId":{"shape":"ResourceId"}, - "Status":{"shape":"CustomHealthStatus"} - } - }, - "UpdateServiceRequest":{ - "type":"structure", - "required":[ - "Id", - "Service" - ], - "members":{ - "Id":{ - "shape":"ResourceId", - "documentation":"

The ID of the service that you want to update.

" - }, - "Service":{ - "shape":"ServiceChange", - "documentation":"

A complex type that contains the new settings for the service.

" - } - } - }, - "UpdateServiceResponse":{ - "type":"structure", - "members":{ - "OperationId":{ - "shape":"OperationId", - "documentation":"

A value that you can use to determine whether the request completed successfully. To get the status of the operation, see GetOperation.

" - } - } - } - }, - "documentation":"

Amazon Route 53 auto naming lets you configure public or private namespaces that your microservice applications run in. When instances of the service become available, you can call the auto naming API to register the instance, and Route 53 automatically creates up to five DNS records and an optional health check. Clients that submit DNS queries for the service receive an answer that contains up to eight healthy records.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/examples-1.json deleted file mode 100644 index 88555294..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/examples-1.json +++ /dev/null @@ -1,953 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CloneReceiptRuleSet": [ - { - "input": { - "OriginalRuleSetName": "RuleSetToClone", - "RuleSetName": "RuleSetToCreate" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a receipt rule set by cloning an existing one:", - "id": "clonereceiptruleset-1469055039770", - "title": "CloneReceiptRuleSet" - } - ], - "CreateReceiptFilter": [ - { - "input": { - "Filter": { - "IpFilter": { - "Cidr": "1.2.3.4/24", - "Policy": "Allow" - }, - "Name": "MyFilter" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a new IP address filter:", - "id": "createreceiptfilter-1469122681253", - "title": "CreateReceiptFilter" - } - ], - "CreateReceiptRule": [ - { - "input": { - "After": "", - "Rule": { - "Actions": [ - { - "S3Action": { - "BucketName": "MyBucket", - "ObjectKeyPrefix": "email" - } - } - ], - "Enabled": true, - "Name": "MyRule", - "ScanEnabled": true, - "TlsPolicy": "Optional" - }, - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a new receipt rule:", - "id": "createreceiptrule-1469122946515", - "title": "CreateReceiptRule" - } - ], - "CreateReceiptRuleSet": [ - { - "input": { - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates an empty receipt rule set:", - "id": "createreceiptruleset-1469058761646", - "title": "CreateReceiptRuleSet" - } - ], - "DeleteIdentity": [ - { - "input": { - "Identity": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an identity from the list of identities that have been submitted for verification with Amazon SES:", - "id": "deleteidentity-1469047858906", - "title": "DeleteIdentity" - } - ], - "DeleteIdentityPolicy": [ - { - "input": { - "Identity": "user@example.com", - "PolicyName": "MyPolicy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a sending authorization policy for an identity:", - "id": "deleteidentitypolicy-1469055282499", - "title": "DeleteIdentityPolicy" - } - ], - "DeleteReceiptFilter": [ - { - "input": { - "FilterName": "MyFilter" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an IP address filter:", - "id": "deletereceiptfilter-1469055456835", - "title": "DeleteReceiptFilter" - } - ], - "DeleteReceiptRule": [ - { - "input": { - "RuleName": "MyRule", - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a receipt rule:", - "id": "deletereceiptrule-1469055563599", - "title": "DeleteReceiptRule" - } - ], - "DeleteReceiptRuleSet": [ - { - "input": { - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a receipt rule set:", - "id": "deletereceiptruleset-1469055713690", - "title": "DeleteReceiptRuleSet" - } - ], - "DeleteVerifiedEmailAddress": [ - { - "input": { - "EmailAddress": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an email address from the list of identities that have been submitted for verification with Amazon SES:", - "id": "deleteverifiedemailaddress-1469051086444", - "title": "DeleteVerifiedEmailAddress" - } - ], - "DescribeActiveReceiptRuleSet": [ - { - "input": { - }, - "output": { - "Metadata": { - "CreatedTimestamp": "2016-07-15T16:25:59.607Z", - "Name": "default-rule-set" - }, - "Rules": [ - { - "Actions": [ - { - "S3Action": { - "BucketName": "MyBucket", - "ObjectKeyPrefix": "email" - } - } - ], - "Enabled": true, - "Name": "MyRule", - "ScanEnabled": true, - "TlsPolicy": "Optional" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the metadata and receipt rules for the receipt rule set that is currently active:", - "id": "describeactivereceiptruleset-1469121611502", - "title": "DescribeActiveReceiptRuleSet" - } - ], - "DescribeReceiptRule": [ - { - "input": { - "RuleName": "MyRule", - "RuleSetName": "MyRuleSet" - }, - "output": { - "Rule": { - "Actions": [ - { - "S3Action": { - "BucketName": "MyBucket", - "ObjectKeyPrefix": "email" - } - } - ], - "Enabled": true, - "Name": "MyRule", - "ScanEnabled": true, - "TlsPolicy": "Optional" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a receipt rule:", - "id": "describereceiptrule-1469055813118", - "title": "DescribeReceiptRule" - } - ], - "DescribeReceiptRuleSet": [ - { - "input": { - "RuleSetName": "MyRuleSet" - }, - "output": { - "Metadata": { - "CreatedTimestamp": "2016-07-15T16:25:59.607Z", - "Name": "MyRuleSet" - }, - "Rules": [ - { - "Actions": [ - { - "S3Action": { - "BucketName": "MyBucket", - "ObjectKeyPrefix": "email" - } - } - ], - "Enabled": true, - "Name": "MyRule", - "ScanEnabled": true, - "TlsPolicy": "Optional" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the metadata and receipt rules of a receipt rule set:", - "id": "describereceiptruleset-1469121240385", - "title": "DescribeReceiptRuleSet" - } - ], - "GetIdentityDkimAttributes": [ - { - "input": { - "Identities": [ - "example.com", - "user@example.com" - ] - }, - "output": { - "DkimAttributes": { - "example.com": { - "DkimEnabled": true, - "DkimTokens": [ - "EXAMPLEjcs5xoyqytjsotsijas7236gr", - "EXAMPLEjr76cvoc6mysspnioorxsn6ep", - "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k" - ], - "DkimVerificationStatus": "Success" - }, - "user@example.com": { - "DkimEnabled": false, - "DkimVerificationStatus": "NotStarted" - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example retrieves the Amazon SES Easy DKIM attributes for a list of identities:", - "id": "getidentitydkimattributes-1469050695628", - "title": "GetIdentityDkimAttributes" - } - ], - "GetIdentityMailFromDomainAttributes": [ - { - "input": { - "Identities": [ - "example.com" - ] - }, - "output": { - "MailFromDomainAttributes": { - "example.com": { - "BehaviorOnMXFailure": "UseDefaultValue", - "MailFromDomain": "bounces.example.com", - "MailFromDomainStatus": "Success" - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the custom MAIL FROM attributes for an identity:", - "id": "getidentitymailfromdomainattributes-1469123114860", - "title": "GetIdentityMailFromDomainAttributes" - } - ], - "GetIdentityNotificationAttributes": [ - { - "input": { - "Identities": [ - "example.com" - ] - }, - "output": { - "NotificationAttributes": { - "example.com": { - "BounceTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:ExampleTopic", - "ForwardingEnabled": true, - "HeadersInBounceNotificationsEnabled": false, - "HeadersInComplaintNotificationsEnabled": false, - "HeadersInDeliveryNotificationsEnabled": false - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the notification attributes for an identity:", - "id": "getidentitynotificationattributes-1469123466947", - "title": "GetIdentityNotificationAttributes" - } - ], - "GetIdentityPolicies": [ - { - "input": { - "Identity": "example.com", - "PolicyNames": [ - "MyPolicy" - ] - }, - "output": { - "Policies": { - "MyPolicy": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"stmt1469123904194\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":[\"ses:SendEmail\",\"ses:SendRawEmail\"],\"Resource\":\"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com\"}]}" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns a sending authorization policy for an identity:", - "id": "getidentitypolicies-1469123949351", - "title": "GetIdentityPolicies" - } - ], - "GetIdentityVerificationAttributes": [ - { - "input": { - "Identities": [ - "example.com" - ] - }, - "output": { - "VerificationAttributes": { - "example.com": { - "VerificationStatus": "Success", - "VerificationToken": "EXAMPLE3VYb9EDI2nTOQRi/Tf6MI/6bD6THIGiP1MVY=" - } - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the verification status and the verification token for a domain identity:", - "id": "getidentityverificationattributes-1469124205897", - "title": "GetIdentityVerificationAttributes" - } - ], - "GetSendQuota": [ - { - "output": { - "Max24HourSend": 200, - "MaxSendRate": 1, - "SentLast24Hours": 1 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the Amazon SES sending limits for an AWS account:", - "id": "getsendquota-1469047324508", - "title": "GetSendQuota" - } - ], - "GetSendStatistics": [ - { - "output": { - "SendDataPoints": [ - { - "Bounces": 0, - "Complaints": 0, - "DeliveryAttempts": 5, - "Rejects": 0, - "Timestamp": "2016-07-13T22:43:00Z" - }, - { - "Bounces": 0, - "Complaints": 0, - "DeliveryAttempts": 3, - "Rejects": 0, - "Timestamp": "2016-07-13T23:13:00Z" - }, - { - "Bounces": 0, - "Complaints": 0, - "DeliveryAttempts": 1, - "Rejects": 0, - "Timestamp": "2016-07-13T21:13:00Z" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns Amazon SES sending statistics:", - "id": "getsendstatistics-1469047741329", - "title": "GetSendStatistics" - } - ], - "ListIdentities": [ - { - "input": { - "IdentityType": "EmailAddress", - "MaxItems": 123, - "NextToken": "" - }, - "output": { - "Identities": [ - "user@example.com" - ], - "NextToken": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example lists the email address identities that have been submitted for verification with Amazon SES:", - "id": "listidentities-1469048638493", - "title": "ListIdentities" - } - ], - "ListIdentityPolicies": [ - { - "input": { - "Identity": "example.com" - }, - "output": { - "PolicyNames": [ - "MyPolicy" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns a list of sending authorization policies that are attached to an identity:", - "id": "listidentitypolicies-1469124417674", - "title": "ListIdentityPolicies" - } - ], - "ListReceiptFilters": [ - { - "output": { - "Filters": [ - { - "IpFilter": { - "Cidr": "1.2.3.4/24", - "Policy": "Block" - }, - "Name": "MyFilter" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example lists the IP address filters that are associated with an AWS account:", - "id": "listreceiptfilters-1469120786789", - "title": "ListReceiptFilters" - } - ], - "ListReceiptRuleSets": [ - { - "input": { - "NextToken": "" - }, - "output": { - "NextToken": "", - "RuleSets": [ - { - "CreatedTimestamp": "2016-07-15T16:25:59.607Z", - "Name": "MyRuleSet" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example lists the receipt rule sets that exist under an AWS account:", - "id": "listreceiptrulesets-1469121037235", - "title": "ListReceiptRuleSets" - } - ], - "ListVerifiedEmailAddresses": [ - { - "output": { - "VerifiedEmailAddresses": [ - "user1@example.com", - "user2@example.com" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example lists all email addresses that have been submitted for verification with Amazon SES:", - "id": "listverifiedemailaddresses-1469051402570", - "title": "ListVerifiedEmailAddresses" - } - ], - "PutIdentityPolicy": [ - { - "input": { - "Identity": "example.com", - "Policy": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"stmt1469123904194\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":[\"ses:SendEmail\",\"ses:SendRawEmail\"],\"Resource\":\"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com\"}]}", - "PolicyName": "MyPolicy" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example adds a sending authorization policy to an identity:", - "id": "putidentitypolicy-1469124560016", - "title": "PutIdentityPolicy" - } - ], - "ReorderReceiptRuleSet": [ - { - "input": { - "RuleNames": [ - "MyRule", - "MyOtherRule" - ], - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example reorders the receipt rules within a receipt rule set:", - "id": "reorderreceiptruleset-1469058156806", - "title": "ReorderReceiptRuleSet" - } - ], - "SendEmail": [ - { - "input": { - "Destination": { - "BccAddresses": [ - - ], - "CcAddresses": [ - "recipient3@example.com" - ], - "ToAddresses": [ - "recipient1@example.com", - "recipient2@example.com" - ] - }, - "Message": { - "Body": { - "Html": { - "Charset": "UTF-8", - "Data": "This message body contains HTML formatting. It can, for example, contain links like this one: Amazon SES Developer Guide." - }, - "Text": { - "Charset": "UTF-8", - "Data": "This is the message body in text format." - } - }, - "Subject": { - "Charset": "UTF-8", - "Data": "Test email" - } - }, - "ReplyToAddresses": [ - - ], - "ReturnPath": "", - "ReturnPathArn": "", - "Source": "sender@example.com", - "SourceArn": "" - }, - "output": { - "MessageId": "EXAMPLE78603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example sends a formatted email:", - "id": "sendemail-1469049656296", - "title": "SendEmail" - } - ], - "SendRawEmail": [ - { - "input": { - "Destinations": [ - - ], - "FromArn": "", - "RawMessage": { - "Data": "From: sender@example.com\\nTo: recipient@example.com\\nSubject: Test email (contains an attachment)\\nMIME-Version: 1.0\\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\\n\\n--NextPart\\nContent-Type: text/plain\\n\\nThis is the message body.\\n\\n--NextPart\\nContent-Type: text/plain;\\nContent-Disposition: attachment; filename=\"attachment.txt\"\\n\\nThis is the text in the attachment.\\n\\n--NextPart--" - }, - "ReturnPathArn": "", - "Source": "", - "SourceArn": "" - }, - "output": { - "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example sends an email with an attachment:", - "id": "sendrawemail-1469118548649", - "title": "SendRawEmail" - } - ], - "SetActiveReceiptRuleSet": [ - { - "input": { - "RuleSetName": "RuleSetToActivate" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example sets the active receipt rule set:", - "id": "setactivereceiptruleset-1469058391329", - "title": "SetActiveReceiptRuleSet" - } - ], - "SetIdentityDkimEnabled": [ - { - "input": { - "DkimEnabled": true, - "Identity": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example configures Amazon SES to Easy DKIM-sign the email sent from an identity:", - "id": "setidentitydkimenabled-1469057485202", - "title": "SetIdentityDkimEnabled" - } - ], - "SetIdentityFeedbackForwardingEnabled": [ - { - "input": { - "ForwardingEnabled": true, - "Identity": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example configures Amazon SES to forward an identity's bounces and complaints via email:", - "id": "setidentityfeedbackforwardingenabled-1469056811329", - "title": "SetIdentityFeedbackForwardingEnabled" - } - ], - "SetIdentityHeadersInNotificationsEnabled": [ - { - "input": { - "Enabled": true, - "Identity": "user@example.com", - "NotificationType": "Bounce" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example configures Amazon SES to include the original email headers in the Amazon SNS bounce notifications for an identity:", - "id": "setidentityheadersinnotificationsenabled-1469057295001", - "title": "SetIdentityHeadersInNotificationsEnabled" - } - ], - "SetIdentityMailFromDomain": [ - { - "input": { - "BehaviorOnMXFailure": "UseDefaultValue", - "Identity": "user@example.com", - "MailFromDomain": "bounces.example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example configures Amazon SES to use a custom MAIL FROM domain for an identity:", - "id": "setidentitymailfromdomain-1469057693908", - "title": "SetIdentityMailFromDomain" - } - ], - "SetIdentityNotificationTopic": [ - { - "input": { - "Identity": "user@example.com", - "NotificationType": "Bounce", - "SnsTopic": "arn:aws:sns:us-west-2:111122223333:MyTopic" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example sets the Amazon SNS topic to which Amazon SES will publish bounce, complaint, and/or delivery notifications for emails sent with the specified identity as the Source:", - "id": "setidentitynotificationtopic-1469057854966", - "title": "SetIdentityNotificationTopic" - } - ], - "SetReceiptRulePosition": [ - { - "input": { - "After": "PutRuleAfterThisRule", - "RuleName": "RuleToReposition", - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example sets the position of a receipt rule in a receipt rule set:", - "id": "setreceiptruleposition-1469058530550", - "title": "SetReceiptRulePosition" - } - ], - "UpdateReceiptRule": [ - { - "input": { - "Rule": { - "Actions": [ - { - "S3Action": { - "BucketName": "MyBucket", - "ObjectKeyPrefix": "email" - } - } - ], - "Enabled": true, - "Name": "MyRule", - "ScanEnabled": true, - "TlsPolicy": "Optional" - }, - "RuleSetName": "MyRuleSet" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example updates a receipt rule to use an Amazon S3 action:", - "id": "updatereceiptrule-1469051756940", - "title": "UpdateReceiptRule" - } - ], - "VerifyDomainDkim": [ - { - "input": { - "Domain": "example.com" - }, - "output": { - "DkimTokens": [ - "EXAMPLEq76owjnks3lnluwg65scbemvw", - "EXAMPLEi3dnsj67hstzaj673klariwx2", - "EXAMPLEwfbtcukvimehexktmdtaz6naj" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example generates DKIM tokens for a domain that has been verified with Amazon SES:", - "id": "verifydomaindkim-1469049503083", - "title": "VerifyDomainDkim" - } - ], - "VerifyDomainIdentity": [ - { - "input": { - "Domain": "example.com" - }, - "output": { - "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example starts the domain verification process with Amazon SES:", - "id": "verifydomainidentity-1469049165936", - "title": "VerifyDomainIdentity" - } - ], - "VerifyEmailAddress": [ - { - "input": { - "EmailAddress": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example starts the email address verification process with Amazon SES:", - "id": "verifyemailaddress-1469048849187", - "title": "VerifyEmailAddress" - } - ], - "VerifyEmailIdentity": [ - { - "input": { - "EmailAddress": "user@example.com" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example starts the email address verification process with Amazon SES:", - "id": "verifyemailidentity-1469049068623", - "title": "VerifyEmailIdentity" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/paginators-1.json deleted file mode 100644 index 1d61869e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "ListIdentities": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxItems", - "result_key": "Identities" - }, - "ListCustomVerificationEmailTemplates": { - "result_key": "CustomVerificationEmailTemplates", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/service-2.json deleted file mode 100644 index ed07be63..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/service-2.json +++ /dev/null @@ -1,4417 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-12-01", - "endpointPrefix":"email", - "protocol":"query", - "serviceAbbreviation":"Amazon SES", - "serviceFullName":"Amazon Simple Email Service", - "serviceId":"SES", - "signatureVersion":"v4", - "signingName":"ses", - "uid":"email-2010-12-01", - "xmlNamespace":"http://ses.amazonaws.com/doc/2010-12-01/" - }, - "operations":{ - "CloneReceiptRuleSet":{ - "name":"CloneReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CloneReceiptRuleSetRequest"}, - "output":{ - "shape":"CloneReceiptRuleSetResponse", - "resultWrapper":"CloneReceiptRuleSetResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a receipt rule set by cloning an existing one. All receipt rules and configurations are copied to the new receipt rule set and are completely independent of the source rule set.

For information about setting up rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateConfigurationSet":{ - "name":"CreateConfigurationSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConfigurationSetRequest"}, - "output":{ - "shape":"CreateConfigurationSetResponse", - "resultWrapper":"CreateConfigurationSetResult" - }, - "errors":[ - {"shape":"ConfigurationSetAlreadyExistsException"}, - {"shape":"InvalidConfigurationSetException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a configuration set.

Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateConfigurationSetEventDestination":{ - "name":"CreateConfigurationSetEventDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConfigurationSetEventDestinationRequest"}, - "output":{ - "shape":"CreateConfigurationSetEventDestinationResponse", - "resultWrapper":"CreateConfigurationSetEventDestinationResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"EventDestinationAlreadyExistsException"}, - {"shape":"InvalidCloudWatchDestinationException"}, - {"shape":"InvalidFirehoseDestinationException"}, - {"shape":"InvalidSNSDestinationException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a configuration set event destination.

When you create or update an event destination, you must provide one, and only one, destination. The destination can be CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS).

An event destination is the AWS service to which Amazon SES publishes the email sending events associated with a configuration set. For information about using configuration sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateConfigurationSetTrackingOptions":{ - "name":"CreateConfigurationSetTrackingOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateConfigurationSetTrackingOptionsRequest"}, - "output":{ - "shape":"CreateConfigurationSetTrackingOptionsResponse", - "resultWrapper":"CreateConfigurationSetTrackingOptionsResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"TrackingOptionsAlreadyExistsException"}, - {"shape":"InvalidTrackingOptionsException"} - ], - "documentation":"

Creates an association between a configuration set and a custom domain for open and click event tracking.

By default, images and links used for tracking open and click events are hosted on domains operated by Amazon SES. You can configure a subdomain of your own to handle these events. For information about using custom domains, see the Amazon SES Developer Guide.

" - }, - "CreateCustomVerificationEmailTemplate":{ - "name":"CreateCustomVerificationEmailTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCustomVerificationEmailTemplateRequest"}, - "errors":[ - {"shape":"CustomVerificationEmailTemplateAlreadyExistsException"}, - {"shape":"FromEmailAddressNotVerifiedException"}, - {"shape":"CustomVerificationEmailInvalidContentException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a new custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateReceiptFilter":{ - "name":"CreateReceiptFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReceiptFilterRequest"}, - "output":{ - "shape":"CreateReceiptFilterResponse", - "resultWrapper":"CreateReceiptFilterResult" - }, - "errors":[ - {"shape":"LimitExceededException"}, - {"shape":"AlreadyExistsException"} - ], - "documentation":"

Creates a new IP address filter.

For information about setting up IP address filters, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateReceiptRule":{ - "name":"CreateReceiptRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReceiptRuleRequest"}, - "output":{ - "shape":"CreateReceiptRuleResponse", - "resultWrapper":"CreateReceiptRuleResult" - }, - "errors":[ - {"shape":"InvalidSnsTopicException"}, - {"shape":"InvalidS3ConfigurationException"}, - {"shape":"InvalidLambdaFunctionException"}, - {"shape":"AlreadyExistsException"}, - {"shape":"RuleDoesNotExistException"}, - {"shape":"RuleSetDoesNotExistException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates a receipt rule.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateReceiptRuleSet":{ - "name":"CreateReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReceiptRuleSetRequest"}, - "output":{ - "shape":"CreateReceiptRuleSetResponse", - "resultWrapper":"CreateReceiptRuleSetResult" - }, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an empty receipt rule set.

For information about setting up receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "CreateTemplate":{ - "name":"CreateTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTemplateRequest"}, - "output":{ - "shape":"CreateTemplateResponse", - "resultWrapper":"CreateTemplateResult" - }, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"InvalidTemplateException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Creates an email template. Email templates enable you to send personalized email to one or more destinations in a single API operation. For more information, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteConfigurationSet":{ - "name":"DeleteConfigurationSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationSetRequest"}, - "output":{ - "shape":"DeleteConfigurationSetResponse", - "resultWrapper":"DeleteConfigurationSetResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"} - ], - "documentation":"

Deletes a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteConfigurationSetEventDestination":{ - "name":"DeleteConfigurationSetEventDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationSetEventDestinationRequest"}, - "output":{ - "shape":"DeleteConfigurationSetEventDestinationResponse", - "resultWrapper":"DeleteConfigurationSetEventDestinationResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"EventDestinationDoesNotExistException"} - ], - "documentation":"

Deletes a configuration set event destination. Configuration set event destinations are associated with configuration sets, which enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteConfigurationSetTrackingOptions":{ - "name":"DeleteConfigurationSetTrackingOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteConfigurationSetTrackingOptionsRequest"}, - "output":{ - "shape":"DeleteConfigurationSetTrackingOptionsResponse", - "resultWrapper":"DeleteConfigurationSetTrackingOptionsResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"TrackingOptionsDoesNotExistException"} - ], - "documentation":"

Deletes an association between a configuration set and a custom domain for open and click event tracking.

By default, images and links used for tracking open and click events are hosted on domains operated by Amazon SES. You can configure a subdomain of your own to handle these events. For information about using custom domains, see the Amazon SES Developer Guide.

Deleting this kind of association will result in emails sent using the specified configuration set to capture open and click events using the standard, Amazon SES-operated domains.

" - }, - "DeleteCustomVerificationEmailTemplate":{ - "name":"DeleteCustomVerificationEmailTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteCustomVerificationEmailTemplateRequest"}, - "documentation":"

Deletes an existing custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteIdentity":{ - "name":"DeleteIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIdentityRequest"}, - "output":{ - "shape":"DeleteIdentityResponse", - "resultWrapper":"DeleteIdentityResult" - }, - "documentation":"

Deletes the specified identity (an email address or a domain) from the list of verified identities.

You can execute this operation no more than once per second.

" - }, - "DeleteIdentityPolicy":{ - "name":"DeleteIdentityPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIdentityPolicyRequest"}, - "output":{ - "shape":"DeleteIdentityPolicyResponse", - "resultWrapper":"DeleteIdentityPolicyResult" - }, - "documentation":"

Deletes the specified sending authorization policy for the given identity (an email address or a domain). This API returns successfully even if a policy with the specified name does not exist.

This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteReceiptFilter":{ - "name":"DeleteReceiptFilter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReceiptFilterRequest"}, - "output":{ - "shape":"DeleteReceiptFilterResponse", - "resultWrapper":"DeleteReceiptFilterResult" - }, - "documentation":"

Deletes the specified IP address filter.

For information about managing IP address filters, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteReceiptRule":{ - "name":"DeleteReceiptRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReceiptRuleRequest"}, - "output":{ - "shape":"DeleteReceiptRuleResponse", - "resultWrapper":"DeleteReceiptRuleResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"} - ], - "documentation":"

Deletes the specified receipt rule.

For information about managing receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteReceiptRuleSet":{ - "name":"DeleteReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReceiptRuleSetRequest"}, - "output":{ - "shape":"DeleteReceiptRuleSetResponse", - "resultWrapper":"DeleteReceiptRuleSetResult" - }, - "errors":[ - {"shape":"CannotDeleteException"} - ], - "documentation":"

Deletes the specified receipt rule set and all of the receipt rules it contains.

The currently active rule set cannot be deleted.

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DeleteTemplate":{ - "name":"DeleteTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTemplateRequest"}, - "output":{ - "shape":"DeleteTemplateResponse", - "resultWrapper":"DeleteTemplateResult" - }, - "documentation":"

Deletes an email template.

You can execute this operation no more than once per second.

" - }, - "DeleteVerifiedEmailAddress":{ - "name":"DeleteVerifiedEmailAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVerifiedEmailAddressRequest"}, - "documentation":"

Deprecated. Use the DeleteIdentity operation to delete email addresses and domains.

" - }, - "DescribeActiveReceiptRuleSet":{ - "name":"DescribeActiveReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeActiveReceiptRuleSetRequest"}, - "output":{ - "shape":"DescribeActiveReceiptRuleSetResponse", - "resultWrapper":"DescribeActiveReceiptRuleSetResult" - }, - "documentation":"

Returns the metadata and receipt rules for the receipt rule set that is currently active.

For information about setting up receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DescribeConfigurationSet":{ - "name":"DescribeConfigurationSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeConfigurationSetRequest"}, - "output":{ - "shape":"DescribeConfigurationSetResponse", - "resultWrapper":"DescribeConfigurationSetResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"} - ], - "documentation":"

Returns the details of the specified configuration set. For information about using configuration sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DescribeReceiptRule":{ - "name":"DescribeReceiptRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReceiptRuleRequest"}, - "output":{ - "shape":"DescribeReceiptRuleResponse", - "resultWrapper":"DescribeReceiptRuleResult" - }, - "errors":[ - {"shape":"RuleDoesNotExistException"}, - {"shape":"RuleSetDoesNotExistException"} - ], - "documentation":"

Returns the details of the specified receipt rule.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "DescribeReceiptRuleSet":{ - "name":"DescribeReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeReceiptRuleSetRequest"}, - "output":{ - "shape":"DescribeReceiptRuleSetResponse", - "resultWrapper":"DescribeReceiptRuleSetResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"} - ], - "documentation":"

Returns the details of the specified receipt rule set.

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "GetAccountSendingEnabled":{ - "name":"GetAccountSendingEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetAccountSendingEnabledResponse", - "resultWrapper":"GetAccountSendingEnabledResult" - }, - "documentation":"

Returns the email sending status of the Amazon SES account for the current region.

You can execute this operation no more than once per second.

" - }, - "GetCustomVerificationEmailTemplate":{ - "name":"GetCustomVerificationEmailTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCustomVerificationEmailTemplateRequest"}, - "output":{ - "shape":"GetCustomVerificationEmailTemplateResponse", - "resultWrapper":"GetCustomVerificationEmailTemplateResult" - }, - "errors":[ - {"shape":"CustomVerificationEmailTemplateDoesNotExistException"} - ], - "documentation":"

Returns the custom email verification template for the template name you specify.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "GetIdentityDkimAttributes":{ - "name":"GetIdentityDkimAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityDkimAttributesRequest"}, - "output":{ - "shape":"GetIdentityDkimAttributesResponse", - "resultWrapper":"GetIdentityDkimAttributesResult" - }, - "documentation":"

Returns the current status of Easy DKIM signing for an entity. For domain name identities, this operation also returns the DKIM tokens that are required for Easy DKIM signing, and whether Amazon SES has successfully verified that these tokens have been published.

This operation takes a list of identities as input and returns the following information for each:

  • Whether Easy DKIM signing is enabled or disabled.

  • A set of DKIM tokens that represent the identity. If the identity is an email address, the tokens represent the domain of that address.

  • Whether Amazon SES has successfully verified the DKIM tokens published in the domain's DNS. This information is only returned for domain name identities, not for email addresses.

This operation is throttled at one request per second and can only get DKIM attributes for up to 100 identities at a time.

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

" - }, - "GetIdentityMailFromDomainAttributes":{ - "name":"GetIdentityMailFromDomainAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityMailFromDomainAttributesRequest"}, - "output":{ - "shape":"GetIdentityMailFromDomainAttributesResponse", - "resultWrapper":"GetIdentityMailFromDomainAttributesResult" - }, - "documentation":"

Returns the custom MAIL FROM attributes for a list of identities (email addresses : domains).

This operation is throttled at one request per second and can only get custom MAIL FROM attributes for up to 100 identities at a time.

" - }, - "GetIdentityNotificationAttributes":{ - "name":"GetIdentityNotificationAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityNotificationAttributesRequest"}, - "output":{ - "shape":"GetIdentityNotificationAttributesResponse", - "resultWrapper":"GetIdentityNotificationAttributesResult" - }, - "documentation":"

Given a list of verified identities (email addresses and/or domains), returns a structure describing identity notification attributes.

This operation is throttled at one request per second and can only get notification attributes for up to 100 identities at a time.

For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide.

" - }, - "GetIdentityPolicies":{ - "name":"GetIdentityPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityPoliciesRequest"}, - "output":{ - "shape":"GetIdentityPoliciesResponse", - "resultWrapper":"GetIdentityPoliciesResult" - }, - "documentation":"

Returns the requested sending authorization policies for the given identity (an email address or a domain). The policies are returned as a map of policy names to policy contents. You can retrieve a maximum of 20 policies at a time.

This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "GetIdentityVerificationAttributes":{ - "name":"GetIdentityVerificationAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIdentityVerificationAttributesRequest"}, - "output":{ - "shape":"GetIdentityVerificationAttributesResponse", - "resultWrapper":"GetIdentityVerificationAttributesResult" - }, - "documentation":"

Given a list of identities (email addresses and/or domains), returns the verification status and (for domain identities) the verification token for each identity.

The verification status of an email address is \"Pending\" until the email address owner clicks the link within the verification email that Amazon SES sent to that address. If the email address owner clicks the link within 24 hours, the verification status of the email address changes to \"Success\". If the link is not clicked within 24 hours, the verification status changes to \"Failed.\" In that case, if you still want to verify the email address, you must restart the verification process from the beginning.

For domain identities, the domain's verification status is \"Pending\" as Amazon SES searches for the required TXT record in the DNS settings of the domain. When Amazon SES detects the record, the domain's verification status changes to \"Success\". If Amazon SES is unable to detect the record within 72 hours, the domain's verification status changes to \"Failed.\" In that case, if you still want to verify the domain, you must restart the verification process from the beginning.

This operation is throttled at one request per second and can only get verification attributes for up to 100 identities at a time.

" - }, - "GetSendQuota":{ - "name":"GetSendQuota", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetSendQuotaResponse", - "resultWrapper":"GetSendQuotaResult" - }, - "documentation":"

Provides the sending limits for the Amazon SES account.

You can execute this operation no more than once per second.

" - }, - "GetSendStatistics":{ - "name":"GetSendStatistics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"GetSendStatisticsResponse", - "resultWrapper":"GetSendStatisticsResult" - }, - "documentation":"

Provides sending statistics for the current AWS Region. The result is a list of data points, representing the last two weeks of sending activity. Each data point in the list contains statistics for a 15-minute period of time.

You can execute this operation no more than once per second.

" - }, - "GetTemplate":{ - "name":"GetTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTemplateRequest"}, - "output":{ - "shape":"GetTemplateResponse", - "resultWrapper":"GetTemplateResult" - }, - "errors":[ - {"shape":"TemplateDoesNotExistException"} - ], - "documentation":"

Displays the template object (which includes the Subject line, HTML part and text part) for the template you specify.

You can execute this operation no more than once per second.

" - }, - "ListConfigurationSets":{ - "name":"ListConfigurationSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListConfigurationSetsRequest"}, - "output":{ - "shape":"ListConfigurationSetsResponse", - "resultWrapper":"ListConfigurationSetsResult" - }, - "documentation":"

Provides a list of the configuration sets associated with your Amazon SES account in the current AWS Region. For information about using configuration sets, see Monitoring Your Amazon SES Sending Activity in the Amazon SES Developer Guide.

You can execute this operation no more than once per second. This operation will return up to 1,000 configuration sets each time it is run. If your Amazon SES account has more than 1,000 configuration sets, this operation will also return a NextToken element. You can then execute the ListConfigurationSets operation again, passing the NextToken parameter and the value of the NextToken element to retrieve additional results.

" - }, - "ListCustomVerificationEmailTemplates":{ - "name":"ListCustomVerificationEmailTemplates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCustomVerificationEmailTemplatesRequest"}, - "output":{ - "shape":"ListCustomVerificationEmailTemplatesResponse", - "resultWrapper":"ListCustomVerificationEmailTemplatesResult" - }, - "documentation":"

Lists the existing custom verification email templates for your account in the current AWS Region.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "ListIdentities":{ - "name":"ListIdentities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIdentitiesRequest"}, - "output":{ - "shape":"ListIdentitiesResponse", - "resultWrapper":"ListIdentitiesResult" - }, - "documentation":"

Returns a list containing all of the identities (email addresses and domains) for your AWS account in the current AWS Region, regardless of verification status.

You can execute this operation no more than once per second.

" - }, - "ListIdentityPolicies":{ - "name":"ListIdentityPolicies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIdentityPoliciesRequest"}, - "output":{ - "shape":"ListIdentityPoliciesResponse", - "resultWrapper":"ListIdentityPoliciesResult" - }, - "documentation":"

Returns a list of sending authorization policies that are attached to the given identity (an email address or a domain). This API returns only a list. If you want the actual policy content, you can use GetIdentityPolicies.

This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "ListReceiptFilters":{ - "name":"ListReceiptFilters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListReceiptFiltersRequest"}, - "output":{ - "shape":"ListReceiptFiltersResponse", - "resultWrapper":"ListReceiptFiltersResult" - }, - "documentation":"

Lists the IP address filters associated with your AWS account in the current AWS Region.

For information about managing IP address filters, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "ListReceiptRuleSets":{ - "name":"ListReceiptRuleSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListReceiptRuleSetsRequest"}, - "output":{ - "shape":"ListReceiptRuleSetsResponse", - "resultWrapper":"ListReceiptRuleSetsResult" - }, - "documentation":"

Lists the receipt rule sets that exist under your AWS account in the current AWS Region. If there are additional receipt rule sets to be retrieved, you will receive a NextToken that you can provide to the next call to ListReceiptRuleSets to retrieve the additional entries.

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "ListTemplates":{ - "name":"ListTemplates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTemplatesRequest"}, - "output":{ - "shape":"ListTemplatesResponse", - "resultWrapper":"ListTemplatesResult" - }, - "documentation":"

Lists the email templates present in your Amazon SES account in the current AWS Region.

You can execute this operation no more than once per second.

" - }, - "ListVerifiedEmailAddresses":{ - "name":"ListVerifiedEmailAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "output":{ - "shape":"ListVerifiedEmailAddressesResponse", - "resultWrapper":"ListVerifiedEmailAddressesResult" - }, - "documentation":"

Deprecated. Use the ListIdentities operation to list the email addresses and domains associated with your account.

" - }, - "PutIdentityPolicy":{ - "name":"PutIdentityPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutIdentityPolicyRequest"}, - "output":{ - "shape":"PutIdentityPolicyResponse", - "resultWrapper":"PutIdentityPolicyResult" - }, - "errors":[ - {"shape":"InvalidPolicyException"} - ], - "documentation":"

Adds or updates a sending authorization policy for the specified identity (an email address or a domain).

This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "ReorderReceiptRuleSet":{ - "name":"ReorderReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReorderReceiptRuleSetRequest"}, - "output":{ - "shape":"ReorderReceiptRuleSetResponse", - "resultWrapper":"ReorderReceiptRuleSetResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"}, - {"shape":"RuleDoesNotExistException"} - ], - "documentation":"

Reorders the receipt rules within a receipt rule set.

All of the rules in the rule set must be represented in this request. That is, this API will return an error if the reorder request doesn't explicitly position all of the rules.

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "SendBounce":{ - "name":"SendBounce", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendBounceRequest"}, - "output":{ - "shape":"SendBounceResponse", - "resultWrapper":"SendBounceResult" - }, - "errors":[ - {"shape":"MessageRejected"} - ], - "documentation":"

Generates and sends a bounce message to the sender of an email you received through Amazon SES. You can only use this API on an email up to 24 hours after you receive it.

You cannot use this API to send generic bounces for mail that was not received by Amazon SES.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "SendBulkTemplatedEmail":{ - "name":"SendBulkTemplatedEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendBulkTemplatedEmailRequest"}, - "output":{ - "shape":"SendBulkTemplatedEmailResponse", - "resultWrapper":"SendBulkTemplatedEmailResult" - }, - "errors":[ - {"shape":"MessageRejected"}, - {"shape":"MailFromDomainNotVerifiedException"}, - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"TemplateDoesNotExistException"}, - {"shape":"ConfigurationSetSendingPausedException"}, - {"shape":"AccountSendingPausedException"} - ], - "documentation":"

Composes an email message to multiple destinations. The message body is created using an email template.

In order to send email using the SendBulkTemplatedEmail operation, your call to the API must meet the following requirements:

  • The call must refer to an existing email template. You can create email templates using the CreateTemplate operation.

  • The message must be sent from a verified email address or domain.

  • If your account is still in the Amazon SES sandbox, you may only send to verified addresses or domains, or to email addresses associated with the Amazon SES Mailbox Simulator. For more information, see Verifying Email Addresses and Domains in the Amazon SES Developer Guide.

  • The total size of the message, including attachments, must be less than 10 MB.

  • Each Destination parameter must include at least one recipient email address. The recipient address can be a To: address, a CC: address, or a BCC: address. If a recipient email address is invalid (that is, it is not in the format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be rejected, even if the message contains other recipients that are valid.

" - }, - "SendCustomVerificationEmail":{ - "name":"SendCustomVerificationEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendCustomVerificationEmailRequest"}, - "output":{ - "shape":"SendCustomVerificationEmailResponse", - "resultWrapper":"SendCustomVerificationEmailResult" - }, - "errors":[ - {"shape":"MessageRejected"}, - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"CustomVerificationEmailTemplateDoesNotExistException"}, - {"shape":"FromEmailAddressNotVerifiedException"}, - {"shape":"ProductionAccessNotGrantedException"} - ], - "documentation":"

Adds an email address to the list of identities for your Amazon SES account in the current AWS Region and attempts to verify it. As a result of executing this operation, a customized verification email is sent to the specified address.

To use this operation, you must first create a custom verification email template. For more information about creating and using custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "SendEmail":{ - "name":"SendEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendEmailRequest"}, - "output":{ - "shape":"SendEmailResponse", - "resultWrapper":"SendEmailResult" - }, - "errors":[ - {"shape":"MessageRejected"}, - {"shape":"MailFromDomainNotVerifiedException"}, - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"ConfigurationSetSendingPausedException"}, - {"shape":"AccountSendingPausedException"} - ], - "documentation":"

Composes an email message and immediately queues it for sending. In order to send email using the SendEmail operation, your message must meet the following requirements:

  • The message must be sent from a verified email address or domain. If you attempt to send email using a non-verified address or domain, the operation will result in an \"Email address not verified\" error.

  • If your account is still in the Amazon SES sandbox, you may only send to verified addresses or domains, or to email addresses associated with the Amazon SES Mailbox Simulator. For more information, see Verifying Email Addresses and Domains in the Amazon SES Developer Guide.

  • The total size of the message, including attachments, must be smaller than 10 MB.

  • The message must include at least one recipient email address. The recipient address can be a To: address, a CC: address, or a BCC: address. If a recipient email address is invalid (that is, it is not in the format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be rejected, even if the message contains other recipients that are valid.

  • The message may not include more than 50 recipients, across the To:, CC: and BCC: fields. If you need to send an email message to a larger audience, you can divide your recipient list into groups of 50 or fewer, and then call the SendEmail operation several times to send the message to each group.

For every message that you send, the total number of recipients (including each recipient in the To:, CC: and BCC: fields) is counted against the maximum number of emails you can send in a 24-hour period (your sending quota). For more information about sending quotas in Amazon SES, see Managing Your Amazon SES Sending Limits in the Amazon SES Developer Guide.

" - }, - "SendRawEmail":{ - "name":"SendRawEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendRawEmailRequest"}, - "output":{ - "shape":"SendRawEmailResponse", - "resultWrapper":"SendRawEmailResult" - }, - "errors":[ - {"shape":"MessageRejected"}, - {"shape":"MailFromDomainNotVerifiedException"}, - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"ConfigurationSetSendingPausedException"}, - {"shape":"AccountSendingPausedException"} - ], - "documentation":"

Composes an email message and immediately queues it for sending. When calling this operation, you may specify the message headers as well as the content. The SendRawEmail operation is particularly useful for sending multipart MIME emails (such as those that contain both a plain-text and an HTML version).

In order to send email using the SendRawEmail operation, your message must meet the following requirements:

  • The message must be sent from a verified email address or domain. If you attempt to send email using a non-verified address or domain, the operation will result in an \"Email address not verified\" error.

  • If your account is still in the Amazon SES sandbox, you may only send to verified addresses or domains, or to email addresses associated with the Amazon SES Mailbox Simulator. For more information, see Verifying Email Addresses and Domains in the Amazon SES Developer Guide.

  • The total size of the message, including attachments, must be smaller than 10 MB.

  • The message must include at least one recipient email address. The recipient address can be a To: address, a CC: address, or a BCC: address. If a recipient email address is invalid (that is, it is not in the format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be rejected, even if the message contains other recipients that are valid.

  • The message may not include more than 50 recipients, across the To:, CC: and BCC: fields. If you need to send an email message to a larger audience, you can divide your recipient list into groups of 50 or fewer, and then call the SendRawEmail operation several times to send the message to each group.

For every message that you send, the total number of recipients (including each recipient in the To:, CC: and BCC: fields) is counted against the maximum number of emails you can send in a 24-hour period (your sending quota). For more information about sending quotas in Amazon SES, see Managing Your Amazon SES Sending Limits in the Amazon SES Developer Guide.

Additionally, keep the following considerations in mind when using the SendRawEmail operation:

  • Although you can customize the message headers when using the SendRawEmail operation, Amazon SES will automatically apply its own Message-ID and Date headers; if you passed these headers when creating the message, they will be overwritten by the values that Amazon SES provides.

  • If you are using sending authorization to send on behalf of another user, SendRawEmail enables you to specify the cross-account identity for the email's Source, From, and Return-Path parameters in one of two ways: you can pass optional parameters SourceArn, FromArn, and/or ReturnPathArn to the API, or you can include the following X-headers in the header of your raw email:

    • X-SES-SOURCE-ARN

    • X-SES-FROM-ARN

    • X-SES-RETURN-PATH-ARN

    Do not include these X-headers in the DKIM signature; Amazon SES will remove them before sending the email.

    For most common sending authorization scenarios, we recommend that you specify the SourceIdentityArn parameter and not the FromIdentityArn or ReturnPathIdentityArn parameters. If you only specify the SourceIdentityArn parameter, Amazon SES will set the From and Return Path addresses to the identity specified in SourceIdentityArn. For more information about sending authorization, see the Using Sending Authorization with Amazon SES in the Amazon SES Developer Guide.

" - }, - "SendTemplatedEmail":{ - "name":"SendTemplatedEmail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendTemplatedEmailRequest"}, - "output":{ - "shape":"SendTemplatedEmailResponse", - "resultWrapper":"SendTemplatedEmailResult" - }, - "errors":[ - {"shape":"MessageRejected"}, - {"shape":"MailFromDomainNotVerifiedException"}, - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"TemplateDoesNotExistException"}, - {"shape":"ConfigurationSetSendingPausedException"}, - {"shape":"AccountSendingPausedException"} - ], - "documentation":"

Composes an email message using an email template and immediately queues it for sending.

In order to send email using the SendTemplatedEmail operation, your call to the API must meet the following requirements:

  • The call must refer to an existing email template. You can create email templates using the CreateTemplate operation.

  • The message must be sent from a verified email address or domain.

  • If your account is still in the Amazon SES sandbox, you may only send to verified addresses or domains, or to email addresses associated with the Amazon SES Mailbox Simulator. For more information, see Verifying Email Addresses and Domains in the Amazon SES Developer Guide.

  • The total size of the message, including attachments, must be less than 10 MB.

  • Calls to the SendTemplatedEmail operation may only include one Destination parameter. A destination is a set of recipients who will receive the same version of the email. The Destination parameter can include up to 50 recipients, across the To:, CC: and BCC: fields.

  • The Destination parameter must include at least one recipient email address. The recipient address can be a To: address, a CC: address, or a BCC: address. If a recipient email address is invalid (that is, it is not in the format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be rejected, even if the message contains other recipients that are valid.

If your call to the SendTemplatedEmail operation includes all of the required parameters, Amazon SES accepts it and returns a Message ID. However, if Amazon SES can't render the email because the template contains errors, it doesn't send the email. Additionally, because it already accepted the message, Amazon SES doesn't return a message stating that it was unable to send the email.

For these reasons, we highly recommend that you set up Amazon SES to send you notifications when Rendering Failure events occur. For more information, see Sending Personalized Email Using the Amazon SES API in the Amazon Simple Email Service Developer Guide.

" - }, - "SetActiveReceiptRuleSet":{ - "name":"SetActiveReceiptRuleSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetActiveReceiptRuleSetRequest"}, - "output":{ - "shape":"SetActiveReceiptRuleSetResponse", - "resultWrapper":"SetActiveReceiptRuleSetResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"} - ], - "documentation":"

Sets the specified receipt rule set as the active receipt rule set.

To disable your email-receiving through Amazon SES completely, you can call this API with RuleSetName set to null.

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "SetIdentityDkimEnabled":{ - "name":"SetIdentityDkimEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityDkimEnabledRequest"}, - "output":{ - "shape":"SetIdentityDkimEnabledResponse", - "resultWrapper":"SetIdentityDkimEnabledResult" - }, - "documentation":"

Enables or disables Easy DKIM signing of email sent from an identity:

  • If Easy DKIM signing is enabled for a domain name identity (such as example.com), then Amazon SES will DKIM-sign all email sent by addresses under that domain name (for example, user@example.com).

  • If Easy DKIM signing is enabled for an email address, then Amazon SES will DKIM-sign all email sent by that email address.

For email addresses (for example, user@example.com), you can only enable Easy DKIM signing if the corresponding domain (in this case, example.com) has been set up for Easy DKIM using the AWS Console or the VerifyDomainDkim operation.

You can execute this operation no more than once per second.

For more information about Easy DKIM signing, go to the Amazon SES Developer Guide.

" - }, - "SetIdentityFeedbackForwardingEnabled":{ - "name":"SetIdentityFeedbackForwardingEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityFeedbackForwardingEnabledRequest"}, - "output":{ - "shape":"SetIdentityFeedbackForwardingEnabledResponse", - "resultWrapper":"SetIdentityFeedbackForwardingEnabledResult" - }, - "documentation":"

Given an identity (an email address or a domain), enables or disables whether Amazon SES forwards bounce and complaint notifications as email. Feedback forwarding can only be disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified for both bounces and complaints.

Feedback forwarding does not apply to delivery notifications. Delivery notifications are only available through Amazon SNS.

You can execute this operation no more than once per second.

For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide.

" - }, - "SetIdentityHeadersInNotificationsEnabled":{ - "name":"SetIdentityHeadersInNotificationsEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityHeadersInNotificationsEnabledRequest"}, - "output":{ - "shape":"SetIdentityHeadersInNotificationsEnabledResponse", - "resultWrapper":"SetIdentityHeadersInNotificationsEnabledResult" - }, - "documentation":"

Given an identity (an email address or a domain), sets whether Amazon SES includes the original email headers in the Amazon Simple Notification Service (Amazon SNS) notifications of a specified type.

You can execute this operation no more than once per second.

For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide.

" - }, - "SetIdentityMailFromDomain":{ - "name":"SetIdentityMailFromDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityMailFromDomainRequest"}, - "output":{ - "shape":"SetIdentityMailFromDomainResponse", - "resultWrapper":"SetIdentityMailFromDomainResult" - }, - "documentation":"

Enables or disables the custom MAIL FROM domain setup for a verified identity (an email address or a domain).

To send emails using the specified MAIL FROM domain, you must add an MX record to your MAIL FROM domain's DNS settings. If you want your emails to pass Sender Policy Framework (SPF) checks, you must also add or update an SPF record. For more information, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "SetIdentityNotificationTopic":{ - "name":"SetIdentityNotificationTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetIdentityNotificationTopicRequest"}, - "output":{ - "shape":"SetIdentityNotificationTopicResponse", - "resultWrapper":"SetIdentityNotificationTopicResult" - }, - "documentation":"

Given an identity (an email address or a domain), sets the Amazon Simple Notification Service (Amazon SNS) topic to which Amazon SES will publish bounce, complaint, and/or delivery notifications for emails sent with that identity as the Source.

Unless feedback forwarding is enabled, you must specify Amazon SNS topics for bounce and complaint notifications. For more information, see SetIdentityFeedbackForwardingEnabled.

You can execute this operation no more than once per second.

For more information about feedback notification, see the Amazon SES Developer Guide.

" - }, - "SetReceiptRulePosition":{ - "name":"SetReceiptRulePosition", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetReceiptRulePositionRequest"}, - "output":{ - "shape":"SetReceiptRulePositionResponse", - "resultWrapper":"SetReceiptRulePositionResult" - }, - "errors":[ - {"shape":"RuleSetDoesNotExistException"}, - {"shape":"RuleDoesNotExistException"} - ], - "documentation":"

Sets the position of the specified receipt rule in the receipt rule set.

For information about managing receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "TestRenderTemplate":{ - "name":"TestRenderTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TestRenderTemplateRequest"}, - "output":{ - "shape":"TestRenderTemplateResponse", - "resultWrapper":"TestRenderTemplateResult" - }, - "errors":[ - {"shape":"TemplateDoesNotExistException"}, - {"shape":"InvalidRenderingParameterException"}, - {"shape":"MissingRenderingAttributeException"} - ], - "documentation":"

Creates a preview of the MIME content of an email when provided with a template and a set of replacement data.

You can execute this operation no more than once per second.

" - }, - "UpdateAccountSendingEnabled":{ - "name":"UpdateAccountSendingEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAccountSendingEnabledRequest"}, - "documentation":"

Enables or disables email sending across your entire Amazon SES account in the current AWS Region. You can use this operation in conjunction with Amazon CloudWatch alarms to temporarily pause email sending across your Amazon SES account in a given AWS Region when reputation metrics (such as your bounce or complaint rates) reach certain thresholds.

You can execute this operation no more than once per second.

" - }, - "UpdateConfigurationSetEventDestination":{ - "name":"UpdateConfigurationSetEventDestination", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConfigurationSetEventDestinationRequest"}, - "output":{ - "shape":"UpdateConfigurationSetEventDestinationResponse", - "resultWrapper":"UpdateConfigurationSetEventDestinationResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"EventDestinationDoesNotExistException"}, - {"shape":"InvalidCloudWatchDestinationException"}, - {"shape":"InvalidFirehoseDestinationException"}, - {"shape":"InvalidSNSDestinationException"} - ], - "documentation":"

Updates the event destination of a configuration set. Event destinations are associated with configuration sets, which enable you to publish email sending events to Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS). For information about using configuration sets, see Monitoring Your Amazon SES Sending Activity in the Amazon SES Developer Guide.

When you create or update an event destination, you must provide one, and only one, destination. The destination can be Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS).

You can execute this operation no more than once per second.

" - }, - "UpdateConfigurationSetReputationMetricsEnabled":{ - "name":"UpdateConfigurationSetReputationMetricsEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConfigurationSetReputationMetricsEnabledRequest"}, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"} - ], - "documentation":"

Enables or disables the publishing of reputation metrics for emails sent using a specific configuration set in a given AWS Region. Reputation metrics include bounce and complaint rates. These metrics are published to Amazon CloudWatch. By using CloudWatch, you can create alarms when bounce or complaint rates exceed certain thresholds.

You can execute this operation no more than once per second.

" - }, - "UpdateConfigurationSetSendingEnabled":{ - "name":"UpdateConfigurationSetSendingEnabled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConfigurationSetSendingEnabledRequest"}, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"} - ], - "documentation":"

Enables or disables email sending for messages sent using a specific configuration set in a given AWS Region. You can use this operation in conjunction with Amazon CloudWatch alarms to temporarily pause email sending for a configuration set when the reputation metrics for that configuration set (such as your bounce on complaint rate) exceed certain thresholds.

You can execute this operation no more than once per second.

" - }, - "UpdateConfigurationSetTrackingOptions":{ - "name":"UpdateConfigurationSetTrackingOptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateConfigurationSetTrackingOptionsRequest"}, - "output":{ - "shape":"UpdateConfigurationSetTrackingOptionsResponse", - "resultWrapper":"UpdateConfigurationSetTrackingOptionsResult" - }, - "errors":[ - {"shape":"ConfigurationSetDoesNotExistException"}, - {"shape":"TrackingOptionsDoesNotExistException"}, - {"shape":"InvalidTrackingOptionsException"} - ], - "documentation":"

Modifies an association between a configuration set and a custom domain for open and click event tracking.

By default, images and links used for tracking open and click events are hosted on domains operated by Amazon SES. You can configure a subdomain of your own to handle these events. For information about using custom domains, see the Amazon SES Developer Guide.

" - }, - "UpdateCustomVerificationEmailTemplate":{ - "name":"UpdateCustomVerificationEmailTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateCustomVerificationEmailTemplateRequest"}, - "errors":[ - {"shape":"CustomVerificationEmailTemplateDoesNotExistException"}, - {"shape":"FromEmailAddressNotVerifiedException"}, - {"shape":"CustomVerificationEmailInvalidContentException"} - ], - "documentation":"

Updates an existing custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "UpdateReceiptRule":{ - "name":"UpdateReceiptRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateReceiptRuleRequest"}, - "output":{ - "shape":"UpdateReceiptRuleResponse", - "resultWrapper":"UpdateReceiptRuleResult" - }, - "errors":[ - {"shape":"InvalidSnsTopicException"}, - {"shape":"InvalidS3ConfigurationException"}, - {"shape":"InvalidLambdaFunctionException"}, - {"shape":"RuleSetDoesNotExistException"}, - {"shape":"RuleDoesNotExistException"}, - {"shape":"LimitExceededException"} - ], - "documentation":"

Updates a receipt rule.

For information about managing receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "UpdateTemplate":{ - "name":"UpdateTemplate", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateTemplateRequest"}, - "output":{ - "shape":"UpdateTemplateResponse", - "resultWrapper":"UpdateTemplateResult" - }, - "errors":[ - {"shape":"TemplateDoesNotExistException"}, - {"shape":"InvalidTemplateException"} - ], - "documentation":"

Updates an email template. Email templates enable you to send personalized email to one or more destinations in a single API operation. For more information, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "VerifyDomainDkim":{ - "name":"VerifyDomainDkim", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyDomainDkimRequest"}, - "output":{ - "shape":"VerifyDomainDkimResponse", - "resultWrapper":"VerifyDomainDkimResult" - }, - "documentation":"

Returns a set of DKIM tokens for a domain. DKIM tokens are character strings that represent your domain's identity. Using these tokens, you will need to create DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web Services will eventually detect that you have updated your DNS records; this detection process may take up to 72 hours. Upon successful detection, Amazon SES will be able to DKIM-sign email originating from that domain.

You can execute this operation no more than once per second.

To enable or disable Easy DKIM signing for a domain, use the SetIdentityDkimEnabled operation.

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

" - }, - "VerifyDomainIdentity":{ - "name":"VerifyDomainIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyDomainIdentityRequest"}, - "output":{ - "shape":"VerifyDomainIdentityResponse", - "resultWrapper":"VerifyDomainIdentityResult" - }, - "documentation":"

Adds a domain to the list of identities for your Amazon SES account in the current AWS Region and attempts to verify it. For more information about verifying domains, see Verifying Email Addresses and Domains in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

" - }, - "VerifyEmailAddress":{ - "name":"VerifyEmailAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyEmailAddressRequest"}, - "documentation":"

Deprecated. Use the VerifyEmailIdentity operation to verify a new email address.

" - }, - "VerifyEmailIdentity":{ - "name":"VerifyEmailIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"VerifyEmailIdentityRequest"}, - "output":{ - "shape":"VerifyEmailIdentityResponse", - "resultWrapper":"VerifyEmailIdentityResult" - }, - "documentation":"

Adds an email address to the list of identities for your Amazon SES account in the current AWS region and attempts to verify it. As a result of executing this operation, a verification email is sent to the specified address.

You can execute this operation no more than once per second.

" - } - }, - "shapes":{ - "AccountSendingPausedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that email sending is disabled for your entire Amazon SES account.

You can enable or disable email sending for your Amazon SES account using UpdateAccountSendingEnabled.

", - "error":{ - "code":"AccountSendingPausedException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AddHeaderAction":{ - "type":"structure", - "required":[ - "HeaderName", - "HeaderValue" - ], - "members":{ - "HeaderName":{ - "shape":"HeaderName", - "documentation":"

The name of the header to add. Must be between 1 and 50 characters, inclusive, and consist of alphanumeric (a-z, A-Z, 0-9) characters and dashes only.

" - }, - "HeaderValue":{ - "shape":"HeaderValue", - "documentation":"

Must be less than 2048 characters, and must not contain newline characters (\"\\r\" or \"\\n\").

" - } - }, - "documentation":"

When included in a receipt rule, this action adds a header to the received email.

For information about adding a header using a receipt rule, see the Amazon SES Developer Guide.

" - }, - "Address":{"type":"string"}, - "AddressList":{ - "type":"list", - "member":{"shape":"Address"} - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleOrRuleSetName", - "documentation":"

Indicates that a resource could not be created because the resource name already exists.

" - } - }, - "documentation":"

Indicates that a resource could not be created because of a naming conflict.

", - "error":{ - "code":"AlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "AmazonResourceName":{"type":"string"}, - "ArrivalDate":{"type":"timestamp"}, - "BehaviorOnMXFailure":{ - "type":"string", - "enum":[ - "UseDefaultValue", - "RejectMessage" - ] - }, - "Body":{ - "type":"structure", - "members":{ - "Text":{ - "shape":"Content", - "documentation":"

The content of the message, in text format. Use this for text-based email clients, or clients on high-latency networks (such as mobile devices).

" - }, - "Html":{ - "shape":"Content", - "documentation":"

The content of the message, in HTML format. Use this for email clients that can process HTML. You can include clickable links, formatted text, and much more in an HTML message.

" - } - }, - "documentation":"

Represents the body of the message. You can specify text, HTML, or both. If you use both, then the message should display correctly in the widest variety of email clients.

" - }, - "BounceAction":{ - "type":"structure", - "required":[ - "SmtpReplyCode", - "Message", - "Sender" - ], - "members":{ - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the bounce action is taken. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - }, - "SmtpReplyCode":{ - "shape":"BounceSmtpReplyCode", - "documentation":"

The SMTP reply code, as defined by RFC 5321.

" - }, - "StatusCode":{ - "shape":"BounceStatusCode", - "documentation":"

The SMTP enhanced status code, as defined by RFC 3463.

" - }, - "Message":{ - "shape":"BounceMessage", - "documentation":"

Human-readable text to include in the bounce message.

" - }, - "Sender":{ - "shape":"Address", - "documentation":"

The email address of the sender of the bounced email. This is the address from which the bounce message will be sent.

" - } - }, - "documentation":"

When included in a receipt rule, this action rejects the received email by returning a bounce response to the sender and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

For information about sending a bounce message in response to a received email, see the Amazon SES Developer Guide.

" - }, - "BounceMessage":{"type":"string"}, - "BounceSmtpReplyCode":{"type":"string"}, - "BounceStatusCode":{"type":"string"}, - "BounceType":{ - "type":"string", - "enum":[ - "DoesNotExist", - "MessageTooLarge", - "ExceededQuota", - "ContentRejected", - "Undefined", - "TemporaryFailure" - ] - }, - "BouncedRecipientInfo":{ - "type":"structure", - "required":["Recipient"], - "members":{ - "Recipient":{ - "shape":"Address", - "documentation":"

The email address of the recipient of the bounced email.

" - }, - "RecipientArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to receive email for the recipient of the bounced email. For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "BounceType":{ - "shape":"BounceType", - "documentation":"

The reason for the bounce. You must provide either this parameter or RecipientDsnFields.

" - }, - "RecipientDsnFields":{ - "shape":"RecipientDsnFields", - "documentation":"

Recipient-related DSN fields, most of which would normally be filled in automatically when provided with a BounceType. You must provide either this parameter or BounceType.

" - } - }, - "documentation":"

Recipient-related information to include in the Delivery Status Notification (DSN) when an email that Amazon SES receives on your behalf bounces.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

" - }, - "BouncedRecipientInfoList":{ - "type":"list", - "member":{"shape":"BouncedRecipientInfo"} - }, - "BulkEmailDestination":{ - "type":"structure", - "required":["Destination"], - "members":{ - "Destination":{"shape":"Destination"}, - "ReplacementTags":{ - "shape":"MessageTagList", - "documentation":"

A list of tags, in the form of name/value pairs, to apply to an email that you send using SendBulkTemplatedEmail. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

" - }, - "ReplacementTemplateData":{ - "shape":"TemplateData", - "documentation":"

A list of replacement values to apply to the template. This parameter is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.

" - } - }, - "documentation":"

An array that contains one or more Destinations, as well as the tags and replacement data associated with each of those Destinations.

" - }, - "BulkEmailDestinationList":{ - "type":"list", - "member":{"shape":"BulkEmailDestination"} - }, - "BulkEmailDestinationStatus":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"BulkEmailStatus", - "documentation":"

The status of a message sent using the SendBulkTemplatedEmail operation.

Possible values for this parameter include:

  • Success: Amazon SES accepted the message, and will attempt to deliver it to the recipients.

  • MessageRejected: The message was rejected because it contained a virus.

  • MailFromDomainNotVerified: The sender's email address or domain was not verified.

  • ConfigurationSetDoesNotExist: The configuration set you specified does not exist.

  • TemplateDoesNotExist: The template you specified does not exist.

  • AccountSuspended: Your account has been shut down because of issues related to your email sending practices.

  • AccountThrottled: The number of emails you can send has been reduced because your account has exceeded its allocated sending limit.

  • AccountDailyQuotaExceeded: You have reached or exceeded the maximum number of emails you can send from your account in a 24-hour period.

  • InvalidSendingPoolName: The configuration set you specified refers to an IP pool that does not exist.

  • AccountSendingPaused: Email sending for the Amazon SES account was disabled using the UpdateAccountSendingEnabled operation.

  • ConfigurationSetSendingPaused: Email sending for this configuration set was disabled using the UpdateConfigurationSetSendingEnabled operation.

  • InvalidParameterValue: One or more of the parameters you specified when calling this operation was invalid. See the error message for additional information.

  • TransientFailure: Amazon SES was unable to process your request because of a temporary issue.

  • Failed: Amazon SES was unable to process your request. See the error message for additional information.

" - }, - "Error":{ - "shape":"Error", - "documentation":"

A description of an error that prevented a message being sent using the SendBulkTemplatedEmail operation.

" - }, - "MessageId":{ - "shape":"MessageId", - "documentation":"

The unique message identifier returned from the SendBulkTemplatedEmail operation.

" - } - }, - "documentation":"

An object that contains the response from the SendBulkTemplatedEmail operation.

" - }, - "BulkEmailDestinationStatusList":{ - "type":"list", - "member":{"shape":"BulkEmailDestinationStatus"} - }, - "BulkEmailStatus":{ - "type":"string", - "enum":[ - "Success", - "MessageRejected", - "MailFromDomainNotVerified", - "ConfigurationSetDoesNotExist", - "TemplateDoesNotExist", - "AccountSuspended", - "AccountThrottled", - "AccountDailyQuotaExceeded", - "InvalidSendingPoolName", - "AccountSendingPaused", - "ConfigurationSetSendingPaused", - "InvalidParameterValue", - "TransientFailure", - "Failed" - ] - }, - "CannotDeleteException":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleOrRuleSetName", - "documentation":"

Indicates that a resource could not be deleted because no resource with the specified name exists.

" - } - }, - "documentation":"

Indicates that the delete operation could not be completed.

", - "error":{ - "code":"CannotDelete", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Charset":{"type":"string"}, - "Cidr":{"type":"string"}, - "CloneReceiptRuleSetRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "OriginalRuleSetName" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the rule set to create. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Start and end with a letter or number.

  • Contain less than 64 characters.

" - }, - "OriginalRuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the rule set to clone.

" - } - }, - "documentation":"

Represents a request to create a receipt rule set by cloning an existing one. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "CloneReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CloudWatchDestination":{ - "type":"structure", - "required":["DimensionConfigurations"], - "members":{ - "DimensionConfigurations":{ - "shape":"CloudWatchDimensionConfigurations", - "documentation":"

A list of dimensions upon which to categorize your emails when you publish email sending events to Amazon CloudWatch.

" - } - }, - "documentation":"

Contains information associated with an Amazon CloudWatch event destination to which email sending events are published.

Event destinations, such as Amazon CloudWatch, are associated with configuration sets, which enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "CloudWatchDimensionConfiguration":{ - "type":"structure", - "required":[ - "DimensionName", - "DimensionValueSource", - "DefaultDimensionValue" - ], - "members":{ - "DimensionName":{ - "shape":"DimensionName", - "documentation":"

The name of an Amazon CloudWatch dimension associated with an email sending metric. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain less than 256 characters.

" - }, - "DimensionValueSource":{ - "shape":"DimensionValueSource", - "documentation":"

The place where Amazon SES finds the value of a dimension to publish to Amazon CloudWatch. If you want Amazon SES to use the message tags that you specify using an X-SES-MESSAGE-TAGS header or a parameter to the SendEmail/SendRawEmail API, choose messageTag. If you want Amazon SES to use your own email headers, choose emailHeader.

" - }, - "DefaultDimensionValue":{ - "shape":"DefaultDimensionValue", - "documentation":"

The default value of the dimension that is published to Amazon CloudWatch if you do not provide the value of the dimension when you send an email. The default value must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain less than 256 characters.

" - } - }, - "documentation":"

Contains the dimension configuration to use when you publish email sending events to Amazon CloudWatch.

For information about publishing email sending events to Amazon CloudWatch, see the Amazon SES Developer Guide.

" - }, - "CloudWatchDimensionConfigurations":{ - "type":"list", - "member":{"shape":"CloudWatchDimensionConfiguration"} - }, - "ConfigurationSet":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set. The name must meet the following requirements:

  • Contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain 64 characters or fewer.

" - } - }, - "documentation":"

The name of the configuration set.

Configuration sets let you create groups of rules that you can apply to the emails you send using Amazon SES. For more information about using configuration sets, see Using Amazon SES Configuration Sets in the Amazon SES Developer Guide.

" - }, - "ConfigurationSetAlreadyExistsException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - } - }, - "documentation":"

Indicates that the configuration set could not be created because of a naming conflict.

", - "error":{ - "code":"ConfigurationSetAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ConfigurationSetAttribute":{ - "type":"string", - "enum":[ - "eventDestinations", - "trackingOptions", - "reputationOptions" - ] - }, - "ConfigurationSetAttributeList":{ - "type":"list", - "member":{"shape":"ConfigurationSetAttribute"} - }, - "ConfigurationSetDoesNotExistException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - } - }, - "documentation":"

Indicates that the configuration set does not exist.

", - "error":{ - "code":"ConfigurationSetDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ConfigurationSetName":{"type":"string"}, - "ConfigurationSetSendingPausedException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set for which email sending is disabled.

" - } - }, - "documentation":"

Indicates that email sending is disabled for the configuration set.

You can enable or disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled.

", - "error":{ - "code":"ConfigurationSetSendingPausedException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ConfigurationSets":{ - "type":"list", - "member":{"shape":"ConfigurationSet"} - }, - "Content":{ - "type":"structure", - "required":["Data"], - "members":{ - "Data":{ - "shape":"MessageData", - "documentation":"

The textual data of the content.

" - }, - "Charset":{ - "shape":"Charset", - "documentation":"

The character set of the content.

" - } - }, - "documentation":"

Represents textual data, plus an optional character set specification.

By default, the text must be 7-bit ASCII, due to the constraints of the SMTP protocol. If the text must contain any other characters, then you must also specify a character set. Examples include UTF-8, ISO-8859-1, and Shift_JIS.

" - }, - "Counter":{"type":"long"}, - "CreateConfigurationSetEventDestinationRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "EventDestination" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set that the event destination should be associated with.

" - }, - "EventDestination":{ - "shape":"EventDestination", - "documentation":"

An object that describes the AWS service that email sending event information will be published to.

" - } - }, - "documentation":"

Represents a request to create a configuration set event destination. A configuration set event destination, which can be either Amazon CloudWatch or Amazon Kinesis Firehose, describes an AWS service in which Amazon SES publishes the email sending events associated with a configuration set. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "CreateConfigurationSetEventDestinationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateConfigurationSetRequest":{ - "type":"structure", - "required":["ConfigurationSet"], - "members":{ - "ConfigurationSet":{ - "shape":"ConfigurationSet", - "documentation":"

A data structure that contains the name of the configuration set.

" - } - }, - "documentation":"

Represents a request to create a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "CreateConfigurationSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateConfigurationSetTrackingOptionsRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "TrackingOptions" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set that the tracking options should be associated with.

" - }, - "TrackingOptions":{"shape":"TrackingOptions"} - }, - "documentation":"

Represents a request to create an open and click tracking option object in a configuration set.

" - }, - "CreateConfigurationSetTrackingOptionsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateCustomVerificationEmailTemplateRequest":{ - "type":"structure", - "required":[ - "TemplateName", - "FromEmailAddress", - "TemplateSubject", - "TemplateContent", - "SuccessRedirectionURL", - "FailureRedirectionURL" - ], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template.

" - }, - "FromEmailAddress":{ - "shape":"FromAddress", - "documentation":"

The email address that the custom verification email is sent from.

" - }, - "TemplateSubject":{ - "shape":"Subject", - "documentation":"

The subject line of the custom verification email.

" - }, - "TemplateContent":{ - "shape":"TemplateContent", - "documentation":"

The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see Custom Verification Email Frequently Asked Questions in the Amazon SES Developer Guide.

" - }, - "SuccessRedirectionURL":{ - "shape":"SuccessRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

" - }, - "FailureRedirectionURL":{ - "shape":"FailureRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

" - } - }, - "documentation":"

Represents a request to create a custom verification email template.

" - }, - "CreateReceiptFilterRequest":{ - "type":"structure", - "required":["Filter"], - "members":{ - "Filter":{ - "shape":"ReceiptFilter", - "documentation":"

A data structure that describes the IP address filter to create, which consists of a name, an IP address range, and whether to allow or block mail from it.

" - } - }, - "documentation":"

Represents a request to create a new IP address filter. You use IP address filters when you receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "CreateReceiptFilterResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateReceiptRuleRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "Rule" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the rule set that the receipt rule will be added to.

" - }, - "After":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of an existing rule after which the new rule will be placed. If this parameter is null, the new rule will be inserted at the beginning of the rule list.

" - }, - "Rule":{ - "shape":"ReceiptRule", - "documentation":"

A data structure that contains the specified rule's name, actions, recipients, domains, enabled status, scan status, and TLS policy.

" - } - }, - "documentation":"

Represents a request to create a receipt rule. You use receipt rules to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "CreateReceiptRuleResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateReceiptRuleSetRequest":{ - "type":"structure", - "required":["RuleSetName"], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the rule set to create. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Start and end with a letter or number.

  • Contain less than 64 characters.

" - } - }, - "documentation":"

Represents a request to create an empty receipt rule set. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "CreateReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "CreateTemplateRequest":{ - "type":"structure", - "required":["Template"], - "members":{ - "Template":{ - "shape":"Template", - "documentation":"

The content of the email, composed of a subject line, an HTML part, and a text-only part.

" - } - }, - "documentation":"

Represents a request to create an email template. For more information, see the Amazon SES Developer Guide.

" - }, - "CreateTemplateResponse":{ - "type":"structure", - "members":{ - } - }, - "CustomMailFromStatus":{ - "type":"string", - "enum":[ - "Pending", - "Success", - "Failed", - "TemporaryFailure" - ] - }, - "CustomRedirectDomain":{"type":"string"}, - "CustomVerificationEmailInvalidContentException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that custom verification email template provided content is invalid.

", - "error":{ - "code":"CustomVerificationEmailInvalidContent", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CustomVerificationEmailTemplate":{ - "type":"structure", - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template.

" - }, - "FromEmailAddress":{ - "shape":"FromAddress", - "documentation":"

The email address that the custom verification email is sent from.

" - }, - "TemplateSubject":{ - "shape":"Subject", - "documentation":"

The subject line of the custom verification email.

" - }, - "SuccessRedirectionURL":{ - "shape":"SuccessRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

" - }, - "FailureRedirectionURL":{ - "shape":"FailureRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

" - } - }, - "documentation":"

Contains information about a custom verification email template.

" - }, - "CustomVerificationEmailTemplateAlreadyExistsException":{ - "type":"structure", - "members":{ - "CustomVerificationEmailTemplateName":{ - "shape":"TemplateName", - "documentation":"

Indicates that the provided custom verification email template with the specified template name already exists.

" - } - }, - "documentation":"

Indicates that a custom verification email template with the name you specified already exists.

", - "error":{ - "code":"CustomVerificationEmailTemplateAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CustomVerificationEmailTemplateDoesNotExistException":{ - "type":"structure", - "members":{ - "CustomVerificationEmailTemplateName":{ - "shape":"TemplateName", - "documentation":"

Indicates that the provided custom verification email template does not exist.

" - } - }, - "documentation":"

Indicates that a custom verification email template with the name you specified does not exist.

", - "error":{ - "code":"CustomVerificationEmailTemplateDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "CustomVerificationEmailTemplates":{ - "type":"list", - "member":{"shape":"CustomVerificationEmailTemplate"} - }, - "DefaultDimensionValue":{"type":"string"}, - "DeleteConfigurationSetEventDestinationRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "EventDestinationName" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set from which to delete the event destination.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

The name of the event destination to delete.

" - } - }, - "documentation":"

Represents a request to delete a configuration set event destination. Configuration set event destinations are associated with configuration sets, which enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "DeleteConfigurationSetEventDestinationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteConfigurationSetRequest":{ - "type":"structure", - "required":["ConfigurationSetName"], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to delete.

" - } - }, - "documentation":"

Represents a request to delete a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "DeleteConfigurationSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteConfigurationSetTrackingOptionsRequest":{ - "type":"structure", - "required":["ConfigurationSetName"], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set from which you want to delete the tracking options.

" - } - }, - "documentation":"

Represents a request to delete open and click tracking options in a configuration set.

" - }, - "DeleteConfigurationSetTrackingOptionsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteCustomVerificationEmailTemplateRequest":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template that you want to delete.

" - } - }, - "documentation":"

Represents a request to delete an existing custom verification email template.

" - }, - "DeleteIdentityPolicyRequest":{ - "type":"structure", - "required":[ - "Identity", - "PolicyName" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity that is associated with the policy that you want to delete. You can specify the identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy to be deleted.

" - } - }, - "documentation":"

Represents a request to delete a sending authorization policy for an identity. Sending authorization is an Amazon SES feature that enables you to authorize other senders to use your identities. For information, see the Amazon SES Developer Guide.

" - }, - "DeleteIdentityPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteIdentityRequest":{ - "type":"structure", - "required":["Identity"], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity to be removed from the list of identities for the AWS Account.

" - } - }, - "documentation":"

Represents a request to delete one of your Amazon SES identities (an email address or domain).

" - }, - "DeleteIdentityResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteReceiptFilterRequest":{ - "type":"structure", - "required":["FilterName"], - "members":{ - "FilterName":{ - "shape":"ReceiptFilterName", - "documentation":"

The name of the IP address filter to delete.

" - } - }, - "documentation":"

Represents a request to delete an IP address filter. You use IP address filters when you receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DeleteReceiptFilterResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteReceiptRuleRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "RuleName" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set that contains the receipt rule to delete.

" - }, - "RuleName":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of the receipt rule to delete.

" - } - }, - "documentation":"

Represents a request to delete a receipt rule. You use receipt rules to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DeleteReceiptRuleResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteReceiptRuleSetRequest":{ - "type":"structure", - "required":["RuleSetName"], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set to delete.

" - } - }, - "documentation":"

Represents a request to delete a receipt rule set and all of the receipt rules it contains. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DeleteReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "DeleteTemplateRequest":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the template to be deleted.

" - } - }, - "documentation":"

Represents a request to delete an email template. For more information, see the Amazon SES Developer Guide.

" - }, - "DeleteTemplateResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteVerifiedEmailAddressRequest":{ - "type":"structure", - "required":["EmailAddress"], - "members":{ - "EmailAddress":{ - "shape":"Address", - "documentation":"

An email address to be removed from the list of verified addresses.

" - } - }, - "documentation":"

Represents a request to delete an email address from the list of email addresses you have attempted to verify under your AWS account.

" - }, - "DescribeActiveReceiptRuleSetRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents a request to return the metadata and receipt rules for the receipt rule set that is currently active. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DescribeActiveReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"ReceiptRuleSetMetadata", - "documentation":"

The metadata for the currently active receipt rule set. The metadata consists of the rule set name and a timestamp of when the rule set was created.

" - }, - "Rules":{ - "shape":"ReceiptRulesList", - "documentation":"

The receipt rules that belong to the active rule set.

" - } - }, - "documentation":"

Represents the metadata and receipt rules for the receipt rule set that is currently active.

" - }, - "DescribeConfigurationSetRequest":{ - "type":"structure", - "required":["ConfigurationSetName"], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to describe.

" - }, - "ConfigurationSetAttributeNames":{ - "shape":"ConfigurationSetAttributeList", - "documentation":"

A list of configuration set attributes to return.

" - } - }, - "documentation":"

Represents a request to return the details of a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "DescribeConfigurationSetResponse":{ - "type":"structure", - "members":{ - "ConfigurationSet":{ - "shape":"ConfigurationSet", - "documentation":"

The configuration set object associated with the specified configuration set.

" - }, - "EventDestinations":{ - "shape":"EventDestinations", - "documentation":"

A list of event destinations associated with the configuration set.

" - }, - "TrackingOptions":{ - "shape":"TrackingOptions", - "documentation":"

The name of the custom open and click tracking domain associated with the configuration set.

" - }, - "ReputationOptions":{ - "shape":"ReputationOptions", - "documentation":"

An object that represents the reputation settings for the configuration set.

" - } - }, - "documentation":"

Represents the details of a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "DescribeReceiptRuleRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "RuleName" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set that the receipt rule belongs to.

" - }, - "RuleName":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of the receipt rule.

" - } - }, - "documentation":"

Represents a request to return the details of a receipt rule. You use receipt rules to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DescribeReceiptRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"ReceiptRule", - "documentation":"

A data structure that contains the specified receipt rule's name, actions, recipients, domains, enabled status, scan status, and Transport Layer Security (TLS) policy.

" - } - }, - "documentation":"

Represents the details of a receipt rule.

" - }, - "DescribeReceiptRuleSetRequest":{ - "type":"structure", - "required":["RuleSetName"], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set to describe.

" - } - }, - "documentation":"

Represents a request to return the details of a receipt rule set. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "DescribeReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"ReceiptRuleSetMetadata", - "documentation":"

The metadata for the receipt rule set, which consists of the rule set name and the timestamp of when the rule set was created.

" - }, - "Rules":{ - "shape":"ReceiptRulesList", - "documentation":"

A list of the receipt rules that belong to the specified receipt rule set.

" - } - }, - "documentation":"

Represents the details of the specified receipt rule set.

" - }, - "Destination":{ - "type":"structure", - "members":{ - "ToAddresses":{ - "shape":"AddressList", - "documentation":"

The To: field(s) of the message.

" - }, - "CcAddresses":{ - "shape":"AddressList", - "documentation":"

The CC: field(s) of the message.

" - }, - "BccAddresses":{ - "shape":"AddressList", - "documentation":"

The BCC: field(s) of the message.

" - } - }, - "documentation":"

Represents the destination of the message, consisting of To:, CC:, and BCC: fields.

Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531. For this reason, the local part of a destination email address (the part of the email address that precedes the @ sign) may only contain 7-bit ASCII characters. If the domain part of an address (the part after the @ sign) contains non-ASCII characters, they must be encoded using Punycode, as described in RFC3492.

" - }, - "DiagnosticCode":{"type":"string"}, - "DimensionName":{"type":"string"}, - "DimensionValueSource":{ - "type":"string", - "enum":[ - "messageTag", - "emailHeader", - "linkTag" - ] - }, - "DkimAttributes":{ - "type":"map", - "key":{"shape":"Identity"}, - "value":{"shape":"IdentityDkimAttributes"} - }, - "Domain":{"type":"string"}, - "DsnAction":{ - "type":"string", - "enum":[ - "failed", - "delayed", - "delivered", - "relayed", - "expanded" - ] - }, - "DsnStatus":{"type":"string"}, - "Enabled":{"type":"boolean"}, - "Error":{"type":"string"}, - "EventDestination":{ - "type":"structure", - "required":[ - "Name", - "MatchingEventTypes" - ], - "members":{ - "Name":{ - "shape":"EventDestinationName", - "documentation":"

The name of the event destination. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain less than 64 characters.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Sets whether Amazon SES publishes events to this destination when you send an email with the associated configuration set. Set to true to enable publishing to this destination; set to false to prevent publishing to this destination. The default value is false.

" - }, - "MatchingEventTypes":{ - "shape":"EventTypes", - "documentation":"

The type of email sending events to publish to the event destination.

" - }, - "KinesisFirehoseDestination":{ - "shape":"KinesisFirehoseDestination", - "documentation":"

An object that contains the delivery stream ARN and the IAM role ARN associated with an Amazon Kinesis Firehose event destination.

" - }, - "CloudWatchDestination":{ - "shape":"CloudWatchDestination", - "documentation":"

An object that contains the names, default values, and sources of the dimensions associated with an Amazon CloudWatch event destination.

" - }, - "SNSDestination":{ - "shape":"SNSDestination", - "documentation":"

An object that contains the topic ARN associated with an Amazon Simple Notification Service (Amazon SNS) event destination.

" - } - }, - "documentation":"

Contains information about the event destination that the specified email sending events will be published to.

When you create or update an event destination, you must provide one, and only one, destination. The destination can be Amazon CloudWatch, Amazon Kinesis Firehose or Amazon Simple Notification Service (Amazon SNS).

Event destinations are associated with configuration sets, which enable you to publish email sending events to Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS). For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "EventDestinationAlreadyExistsException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

Indicates that the event destination does not exist.

" - } - }, - "documentation":"

Indicates that the event destination could not be created because of a naming conflict.

", - "error":{ - "code":"EventDestinationAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EventDestinationDoesNotExistException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

Indicates that the event destination does not exist.

" - } - }, - "documentation":"

Indicates that the event destination does not exist.

", - "error":{ - "code":"EventDestinationDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "EventDestinationName":{"type":"string"}, - "EventDestinations":{ - "type":"list", - "member":{"shape":"EventDestination"} - }, - "EventType":{ - "type":"string", - "enum":[ - "send", - "reject", - "bounce", - "complaint", - "delivery", - "open", - "click", - "renderingFailure" - ] - }, - "EventTypes":{ - "type":"list", - "member":{"shape":"EventType"} - }, - "Explanation":{"type":"string"}, - "ExtensionField":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"ExtensionFieldName", - "documentation":"

The name of the header to add. Must be between 1 and 50 characters, inclusive, and consist of alphanumeric (a-z, A-Z, 0-9) characters and dashes only.

" - }, - "Value":{ - "shape":"ExtensionFieldValue", - "documentation":"

The value of the header to add. Must be less than 2048 characters, and must not contain newline characters (\"\\r\" or \"\\n\").

" - } - }, - "documentation":"

Additional X-headers to include in the Delivery Status Notification (DSN) when an email that Amazon SES receives on your behalf bounces.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

" - }, - "ExtensionFieldList":{ - "type":"list", - "member":{"shape":"ExtensionField"} - }, - "ExtensionFieldName":{"type":"string"}, - "ExtensionFieldValue":{"type":"string"}, - "FailureRedirectionURL":{"type":"string"}, - "FromAddress":{"type":"string"}, - "FromEmailAddressNotVerifiedException":{ - "type":"structure", - "members":{ - "FromEmailAddress":{ - "shape":"FromAddress", - "documentation":"

Indicates that the from email address associated with the custom verification email template is not verified.

" - } - }, - "documentation":"

Indicates that the sender address specified for a custom verification email is not verified, and is therefore not eligible to send the custom verification email.

", - "error":{ - "code":"FromEmailAddressNotVerified", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "GetAccountSendingEnabledResponse":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Enabled", - "documentation":"

Describes whether email sending is enabled or disabled for your Amazon SES account in the current AWS Region.

" - } - }, - "documentation":"

Represents a request to return the email sending status for your Amazon SES account in the current AWS Region.

" - }, - "GetCustomVerificationEmailTemplateRequest":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template that you want to retrieve.

" - } - }, - "documentation":"

Represents a request to retrieve an existing custom verification email template.

" - }, - "GetCustomVerificationEmailTemplateResponse":{ - "type":"structure", - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template.

" - }, - "FromEmailAddress":{ - "shape":"FromAddress", - "documentation":"

The email address that the custom verification email is sent from.

" - }, - "TemplateSubject":{ - "shape":"Subject", - "documentation":"

The subject line of the custom verification email.

" - }, - "TemplateContent":{ - "shape":"TemplateContent", - "documentation":"

The content of the custom verification email.

" - }, - "SuccessRedirectionURL":{ - "shape":"SuccessRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

" - }, - "FailureRedirectionURL":{ - "shape":"FailureRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

" - } - }, - "documentation":"

The content of the custom verification email template.

" - }, - "GetIdentityDkimAttributesRequest":{ - "type":"structure", - "required":["Identities"], - "members":{ - "Identities":{ - "shape":"IdentityList", - "documentation":"

A list of one or more verified identities - email addresses, domains, or both.

" - } - }, - "documentation":"

Represents a request for the status of Amazon SES Easy DKIM signing for an identity. For domain identities, this request also returns the DKIM tokens that are required for Easy DKIM signing, and whether Amazon SES successfully verified that these tokens were published. For more information about Easy DKIM, see the Amazon SES Developer Guide.

" - }, - "GetIdentityDkimAttributesResponse":{ - "type":"structure", - "required":["DkimAttributes"], - "members":{ - "DkimAttributes":{ - "shape":"DkimAttributes", - "documentation":"

The DKIM attributes for an email address or a domain.

" - } - }, - "documentation":"

Represents the status of Amazon SES Easy DKIM signing for an identity. For domain identities, this response also contains the DKIM tokens that are required for Easy DKIM signing, and whether Amazon SES successfully verified that these tokens were published.

" - }, - "GetIdentityMailFromDomainAttributesRequest":{ - "type":"structure", - "required":["Identities"], - "members":{ - "Identities":{ - "shape":"IdentityList", - "documentation":"

A list of one or more identities.

" - } - }, - "documentation":"

Represents a request to return the Amazon SES custom MAIL FROM attributes for a list of identities. For information about using a custom MAIL FROM domain, see the Amazon SES Developer Guide.

" - }, - "GetIdentityMailFromDomainAttributesResponse":{ - "type":"structure", - "required":["MailFromDomainAttributes"], - "members":{ - "MailFromDomainAttributes":{ - "shape":"MailFromDomainAttributes", - "documentation":"

A map of identities to custom MAIL FROM attributes.

" - } - }, - "documentation":"

Represents the custom MAIL FROM attributes for a list of identities.

" - }, - "GetIdentityNotificationAttributesRequest":{ - "type":"structure", - "required":["Identities"], - "members":{ - "Identities":{ - "shape":"IdentityList", - "documentation":"

A list of one or more identities. You can specify an identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

" - } - }, - "documentation":"

Represents a request to return the notification attributes for a list of identities you verified with Amazon SES. For information about Amazon SES notifications, see the Amazon SES Developer Guide.

" - }, - "GetIdentityNotificationAttributesResponse":{ - "type":"structure", - "required":["NotificationAttributes"], - "members":{ - "NotificationAttributes":{ - "shape":"NotificationAttributes", - "documentation":"

A map of Identity to IdentityNotificationAttributes.

" - } - }, - "documentation":"

Represents the notification attributes for a list of identities.

" - }, - "GetIdentityPoliciesRequest":{ - "type":"structure", - "required":[ - "Identity", - "PolicyNames" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity for which the policies will be retrieved. You can specify an identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

" - }, - "PolicyNames":{ - "shape":"PolicyNameList", - "documentation":"

A list of the names of policies to be retrieved. You can retrieve a maximum of 20 policies at a time. If you do not know the names of the policies that are attached to the identity, you can use ListIdentityPolicies.

" - } - }, - "documentation":"

Represents a request to return the requested sending authorization policies for an identity. Sending authorization is an Amazon SES feature that enables you to authorize other senders to use your identities. For information, see the Amazon SES Developer Guide.

" - }, - "GetIdentityPoliciesResponse":{ - "type":"structure", - "required":["Policies"], - "members":{ - "Policies":{ - "shape":"PolicyMap", - "documentation":"

A map of policy names to policies.

" - } - }, - "documentation":"

Represents the requested sending authorization policies.

" - }, - "GetIdentityVerificationAttributesRequest":{ - "type":"structure", - "required":["Identities"], - "members":{ - "Identities":{ - "shape":"IdentityList", - "documentation":"

A list of identities.

" - } - }, - "documentation":"

Represents a request to return the Amazon SES verification status of a list of identities. For domain identities, this request also returns the verification token. For information about verifying identities with Amazon SES, see the Amazon SES Developer Guide.

" - }, - "GetIdentityVerificationAttributesResponse":{ - "type":"structure", - "required":["VerificationAttributes"], - "members":{ - "VerificationAttributes":{ - "shape":"VerificationAttributes", - "documentation":"

A map of Identities to IdentityVerificationAttributes objects.

" - } - }, - "documentation":"

The Amazon SES verification status of a list of identities. For domain identities, this response also contains the verification token.

" - }, - "GetSendQuotaResponse":{ - "type":"structure", - "members":{ - "Max24HourSend":{ - "shape":"Max24HourSend", - "documentation":"

The maximum number of emails the user is allowed to send in a 24-hour interval. A value of -1 signifies an unlimited quota.

" - }, - "MaxSendRate":{ - "shape":"MaxSendRate", - "documentation":"

The maximum number of emails that Amazon SES can accept from the user's account per second.

The rate at which Amazon SES accepts the user's messages might be less than the maximum send rate.

" - }, - "SentLast24Hours":{ - "shape":"SentLast24Hours", - "documentation":"

The number of emails sent during the previous 24 hours.

" - } - }, - "documentation":"

Represents your Amazon SES daily sending quota, maximum send rate, and the number of emails you have sent in the last 24 hours.

" - }, - "GetSendStatisticsResponse":{ - "type":"structure", - "members":{ - "SendDataPoints":{ - "shape":"SendDataPointList", - "documentation":"

A list of data points, each of which represents 15 minutes of activity.

" - } - }, - "documentation":"

Represents a list of data points. This list contains aggregated data from the previous two weeks of your sending activity with Amazon SES.

" - }, - "GetTemplateRequest":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the template you want to retrieve.

" - } - } - }, - "GetTemplateResponse":{ - "type":"structure", - "members":{ - "Template":{"shape":"Template"} - } - }, - "HeaderName":{"type":"string"}, - "HeaderValue":{"type":"string"}, - "HtmlPart":{"type":"string"}, - "Identity":{"type":"string"}, - "IdentityDkimAttributes":{ - "type":"structure", - "required":[ - "DkimEnabled", - "DkimVerificationStatus" - ], - "members":{ - "DkimEnabled":{ - "shape":"Enabled", - "documentation":"

True if DKIM signing is enabled for email sent from the identity; false otherwise. The default value is true.

" - }, - "DkimVerificationStatus":{ - "shape":"VerificationStatus", - "documentation":"

Describes whether Amazon SES has successfully verified the DKIM DNS records (tokens) published in the domain name's DNS. (This only applies to domain identities, not email address identities.)

" - }, - "DkimTokens":{ - "shape":"VerificationTokenList", - "documentation":"

A set of character strings that represent the domain's identity. Using these tokens, you will need to create DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web Services will eventually detect that you have updated your DNS records; this detection process may take up to 72 hours. Upon successful detection, Amazon SES will be able to DKIM-sign email originating from that domain. (This only applies to domain identities, not email address identities.)

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

" - } - }, - "documentation":"

Represents the DKIM attributes of a verified email address or a domain.

" - }, - "IdentityList":{ - "type":"list", - "member":{"shape":"Identity"} - }, - "IdentityMailFromDomainAttributes":{ - "type":"structure", - "required":[ - "MailFromDomain", - "MailFromDomainStatus", - "BehaviorOnMXFailure" - ], - "members":{ - "MailFromDomain":{ - "shape":"MailFromDomainName", - "documentation":"

The custom MAIL FROM domain that the identity is configured to use.

" - }, - "MailFromDomainStatus":{ - "shape":"CustomMailFromStatus", - "documentation":"

The state that indicates whether Amazon SES has successfully read the MX record required for custom MAIL FROM domain setup. If the state is Success, Amazon SES uses the specified custom MAIL FROM domain when the verified identity sends an email. All other states indicate that Amazon SES takes the action described by BehaviorOnMXFailure.

" - }, - "BehaviorOnMXFailure":{ - "shape":"BehaviorOnMXFailure", - "documentation":"

The action that Amazon SES takes if it cannot successfully read the required MX record when you send an email. A value of UseDefaultValue indicates that if Amazon SES cannot read the required MX record, it uses amazonses.com (or a subdomain of that) as the MAIL FROM domain. A value of RejectMessage indicates that if Amazon SES cannot read the required MX record, Amazon SES returns a MailFromDomainNotVerified error and does not send the email.

The custom MAIL FROM setup states that result in this behavior are Pending, Failed, and TemporaryFailure.

" - } - }, - "documentation":"

Represents the custom MAIL FROM domain attributes of a verified identity (email address or domain).

" - }, - "IdentityNotificationAttributes":{ - "type":"structure", - "required":[ - "BounceTopic", - "ComplaintTopic", - "DeliveryTopic", - "ForwardingEnabled" - ], - "members":{ - "BounceTopic":{ - "shape":"NotificationTopic", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will publish bounce notifications.

" - }, - "ComplaintTopic":{ - "shape":"NotificationTopic", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will publish complaint notifications.

" - }, - "DeliveryTopic":{ - "shape":"NotificationTopic", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will publish delivery notifications.

" - }, - "ForwardingEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether Amazon SES will forward bounce and complaint notifications as email. true indicates that Amazon SES will forward bounce and complaint notifications as email, while false indicates that bounce and complaint notifications will be published only to the specified bounce and complaint Amazon SNS topics.

" - }, - "HeadersInBounceNotificationsEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether Amazon SES includes the original email headers in Amazon SNS notifications of type Bounce. A value of true specifies that Amazon SES will include headers in bounce notifications, and a value of false specifies that Amazon SES will not include headers in bounce notifications.

" - }, - "HeadersInComplaintNotificationsEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether Amazon SES includes the original email headers in Amazon SNS notifications of type Complaint. A value of true specifies that Amazon SES will include headers in complaint notifications, and a value of false specifies that Amazon SES will not include headers in complaint notifications.

" - }, - "HeadersInDeliveryNotificationsEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether Amazon SES includes the original email headers in Amazon SNS notifications of type Delivery. A value of true specifies that Amazon SES will include headers in delivery notifications, and a value of false specifies that Amazon SES will not include headers in delivery notifications.

" - } - }, - "documentation":"

Represents the notification attributes of an identity, including whether an identity has Amazon Simple Notification Service (Amazon SNS) topics set for bounce, complaint, and/or delivery notifications, and whether feedback forwarding is enabled for bounce and complaint notifications.

" - }, - "IdentityType":{ - "type":"string", - "enum":[ - "EmailAddress", - "Domain" - ] - }, - "IdentityVerificationAttributes":{ - "type":"structure", - "required":["VerificationStatus"], - "members":{ - "VerificationStatus":{ - "shape":"VerificationStatus", - "documentation":"

The verification status of the identity: \"Pending\", \"Success\", \"Failed\", or \"TemporaryFailure\".

" - }, - "VerificationToken":{ - "shape":"VerificationToken", - "documentation":"

The verification token for a domain identity. Null for email address identities.

" - } - }, - "documentation":"

Represents the verification attributes of a single identity.

" - }, - "InvalidCloudWatchDestinationException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

Indicates that the event destination does not exist.

" - } - }, - "documentation":"

Indicates that the Amazon CloudWatch destination is invalid. See the error message for details.

", - "error":{ - "code":"InvalidCloudWatchDestination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidConfigurationSetException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the configuration set is invalid. See the error message for details.

", - "error":{ - "code":"InvalidConfigurationSet", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidFirehoseDestinationException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

Indicates that the event destination does not exist.

" - } - }, - "documentation":"

Indicates that the Amazon Kinesis Firehose destination is invalid. See the error message for details.

", - "error":{ - "code":"InvalidFirehoseDestination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidLambdaFunctionException":{ - "type":"structure", - "members":{ - "FunctionArn":{ - "shape":"AmazonResourceName", - "documentation":"

Indicates that the ARN of the function was not found.

" - } - }, - "documentation":"

Indicates that the provided AWS Lambda function is invalid, or that Amazon SES could not execute the provided function, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

", - "error":{ - "code":"InvalidLambdaFunction", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidPolicyException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the provided policy is invalid. Check the error stack for more information about what caused the error.

", - "error":{ - "code":"InvalidPolicy", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidRenderingParameterException":{ - "type":"structure", - "members":{ - "TemplateName":{"shape":"TemplateName"} - }, - "documentation":"

Indicates that one or more of the replacement values you provided is invalid. This error may occur when the TemplateData object contains invalid JSON.

", - "error":{ - "code":"InvalidRenderingParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidS3ConfigurationException":{ - "type":"structure", - "members":{ - "Bucket":{ - "shape":"S3BucketName", - "documentation":"

Indicated that the S3 Bucket was not found.

" - } - }, - "documentation":"

Indicates that the provided Amazon S3 bucket or AWS KMS encryption key is invalid, or that Amazon SES could not publish to the bucket, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

", - "error":{ - "code":"InvalidS3Configuration", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSNSDestinationException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that the configuration set does not exist.

" - }, - "EventDestinationName":{ - "shape":"EventDestinationName", - "documentation":"

Indicates that the event destination does not exist.

" - } - }, - "documentation":"

Indicates that the Amazon Simple Notification Service (Amazon SNS) destination is invalid. See the error message for details.

", - "error":{ - "code":"InvalidSNSDestination", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidSnsTopicException":{ - "type":"structure", - "members":{ - "Topic":{ - "shape":"AmazonResourceName", - "documentation":"

Indicates that the topic does not exist.

" - } - }, - "documentation":"

Indicates that the provided Amazon SNS topic is invalid, or that Amazon SES could not publish to the topic, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.

", - "error":{ - "code":"InvalidSnsTopic", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidTemplateException":{ - "type":"structure", - "members":{ - "TemplateName":{"shape":"TemplateName"} - }, - "documentation":"

Indicates that the template that you specified could not be rendered. This issue may occur when a template refers to a partial that does not exist.

", - "error":{ - "code":"InvalidTemplate", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidTrackingOptionsException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the custom domain to be used for open and click tracking redirects is invalid. This error appears most often in the following situations:

  • When the tracking domain you specified is not verified in Amazon SES.

  • When the tracking domain you specified is not a valid domain or subdomain.

", - "error":{ - "code":"InvalidTrackingOptions", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvocationType":{ - "type":"string", - "enum":[ - "Event", - "RequestResponse" - ] - }, - "KinesisFirehoseDestination":{ - "type":"structure", - "required":[ - "IAMRoleARN", - "DeliveryStreamARN" - ], - "members":{ - "IAMRoleARN":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the IAM role under which Amazon SES publishes email sending events to the Amazon Kinesis Firehose stream.

" - }, - "DeliveryStreamARN":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the Amazon Kinesis Firehose stream that email sending events should be published to.

" - } - }, - "documentation":"

Contains the delivery stream ARN and the IAM role ARN associated with an Amazon Kinesis Firehose event destination.

Event destinations, such as Amazon Kinesis Firehose, are associated with configuration sets, which enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "LambdaAction":{ - "type":"structure", - "required":["FunctionArn"], - "members":{ - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the Lambda action is taken. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - }, - "FunctionArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the AWS Lambda function. An example of an AWS Lambda function ARN is arn:aws:lambda:us-west-2:account-id:function:MyFunction. For more information about AWS Lambda, see the AWS Lambda Developer Guide.

" - }, - "InvocationType":{ - "shape":"InvocationType", - "documentation":"

The invocation type of the AWS Lambda function. An invocation type of RequestResponse means that the execution of the function will immediately result in a response, and a value of Event means that the function will be invoked asynchronously. The default value is Event. For information about AWS Lambda invocation types, see the AWS Lambda Developer Guide.

There is a 30-second timeout on RequestResponse invocations. You should use Event invocation in most cases. Use RequestResponse only when you want to make a mail flow decision, such as whether to stop the receipt rule or the receipt rule set.

" - } - }, - "documentation":"

When included in a receipt rule, this action calls an AWS Lambda function and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

To enable Amazon SES to call your AWS Lambda function or to publish to an Amazon SNS topic of another account, Amazon SES must have permission to access those resources. For information about giving permissions, see the Amazon SES Developer Guide.

For information about using AWS Lambda actions in receipt rules, see the Amazon SES Developer Guide.

" - }, - "LastAttemptDate":{"type":"timestamp"}, - "LastFreshStart":{"type":"timestamp"}, - "LimitExceededException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that a resource could not be created because of service limits. For a list of Amazon SES limits, see the Amazon SES Developer Guide.

", - "error":{ - "code":"LimitExceeded", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ListConfigurationSetsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token returned from a previous call to ListConfigurationSets to indicate the position of the configuration set in the configuration set list.

" - }, - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

The number of configuration sets to return.

" - } - }, - "documentation":"

Represents a request to list the configuration sets associated with your AWS account. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "ListConfigurationSetsResponse":{ - "type":"structure", - "members":{ - "ConfigurationSets":{ - "shape":"ConfigurationSets", - "documentation":"

A list of configuration sets.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token indicating that there are additional configuration sets available to be listed. Pass this token to successive calls of ListConfigurationSets.

" - } - }, - "documentation":"

A list of configuration sets associated with your AWS account. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "ListCustomVerificationEmailTemplatesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

An array the contains the name and creation time stamp for each template in your Amazon SES account.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of custom verification email templates to return. This value must be at least 1 and less than or equal to 50. If you do not specify a value, or if you specify a value less than 1 or greater than 50, the operation will return up to 50 results.

" - } - }, - "documentation":"

Represents a request to list the existing custom verification email templates for your account.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

" - }, - "ListCustomVerificationEmailTemplatesResponse":{ - "type":"structure", - "members":{ - "CustomVerificationEmailTemplates":{ - "shape":"CustomVerificationEmailTemplates", - "documentation":"

A list of the custom verification email templates that exist in your account.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token indicating that there are additional custom verification email templates available to be listed. Pass this token to a subsequent call to ListTemplates to retrieve the next 50 custom verification email templates.

" - } - }, - "documentation":"

A paginated list of custom verification email templates.

" - }, - "ListIdentitiesRequest":{ - "type":"structure", - "members":{ - "IdentityType":{ - "shape":"IdentityType", - "documentation":"

The type of the identities to list. Possible values are \"EmailAddress\" and \"Domain\". If this parameter is omitted, then all identities will be listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use for pagination.

" - }, - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

The maximum number of identities per page. Possible values are 1-1000 inclusive.

" - } - }, - "documentation":"

Represents a request to return a list of all identities (email addresses and domains) that you have attempted to verify under your AWS account, regardless of verification status.

" - }, - "ListIdentitiesResponse":{ - "type":"structure", - "required":["Identities"], - "members":{ - "Identities":{ - "shape":"IdentityList", - "documentation":"

A list of identities.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token used for pagination.

" - } - }, - "documentation":"

A list of all identities that you have attempted to verify under your AWS account, regardless of verification status.

" - }, - "ListIdentityPoliciesRequest":{ - "type":"structure", - "required":["Identity"], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity that is associated with the policy for which the policies will be listed. You can specify an identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

" - } - }, - "documentation":"

Represents a request to return a list of sending authorization policies that are attached to an identity. Sending authorization is an Amazon SES feature that enables you to authorize other senders to use your identities. For information, see the Amazon SES Developer Guide.

" - }, - "ListIdentityPoliciesResponse":{ - "type":"structure", - "required":["PolicyNames"], - "members":{ - "PolicyNames":{ - "shape":"PolicyNameList", - "documentation":"

A list of names of policies that apply to the specified identity.

" - } - }, - "documentation":"

A list of names of sending authorization policies that apply to an identity.

" - }, - "ListReceiptFiltersRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

Represents a request to list the IP address filters that exist under your AWS account. You use IP address filters when you receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "ListReceiptFiltersResponse":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ReceiptFilterList", - "documentation":"

A list of IP address filter data structures, which each consist of a name, an IP address range, and whether to allow or block mail from it.

" - } - }, - "documentation":"

A list of IP address filters that exist under your AWS account.

" - }, - "ListReceiptRuleSetsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token returned from a previous call to ListReceiptRuleSets to indicate the position in the receipt rule set list.

" - } - }, - "documentation":"

Represents a request to list the receipt rule sets that exist under your AWS account. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "ListReceiptRuleSetsResponse":{ - "type":"structure", - "members":{ - "RuleSets":{ - "shape":"ReceiptRuleSetsLists", - "documentation":"

The metadata for the currently active receipt rule set. The metadata consists of the rule set name and the timestamp of when the rule set was created.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token indicating that there are additional receipt rule sets available to be listed. Pass this token to successive calls of ListReceiptRuleSets to retrieve up to 100 receipt rule sets at a time.

" - } - }, - "documentation":"

A list of receipt rule sets that exist under your AWS account.

" - }, - "ListTemplatesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token returned from a previous call to ListTemplates to indicate the position in the list of email templates.

" - }, - "MaxItems":{ - "shape":"MaxItems", - "documentation":"

The maximum number of templates to return. This value must be at least 1 and less than or equal to 10. If you do not specify a value, or if you specify a value less than 1 or greater than 10, the operation will return up to 10 results.

" - } - } - }, - "ListTemplatesResponse":{ - "type":"structure", - "members":{ - "TemplatesMetadata":{ - "shape":"TemplateMetadataList", - "documentation":"

An array the contains the name and creation time stamp for each template in your Amazon SES account.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token indicating that there are additional email templates available to be listed. Pass this token to a subsequent call to ListTemplates to retrieve the next 50 email templates.

" - } - } - }, - "ListVerifiedEmailAddressesResponse":{ - "type":"structure", - "members":{ - "VerifiedEmailAddresses":{ - "shape":"AddressList", - "documentation":"

A list of email addresses that have been verified.

" - } - }, - "documentation":"

A list of email addresses that you have verified with Amazon SES under your AWS account.

" - }, - "MailFromDomainAttributes":{ - "type":"map", - "key":{"shape":"Identity"}, - "value":{"shape":"IdentityMailFromDomainAttributes"} - }, - "MailFromDomainName":{"type":"string"}, - "MailFromDomainNotVerifiedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the message could not be sent because Amazon SES could not read the MX record required to use the specified MAIL FROM domain. For information about editing the custom MAIL FROM domain settings for an identity, see the Amazon SES Developer Guide.

", - "error":{ - "code":"MailFromDomainNotVerifiedException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Max24HourSend":{"type":"double"}, - "MaxItems":{"type":"integer"}, - "MaxResults":{ - "type":"integer", - "box":true, - "max":50, - "min":1 - }, - "MaxSendRate":{"type":"double"}, - "Message":{ - "type":"structure", - "required":[ - "Subject", - "Body" - ], - "members":{ - "Subject":{ - "shape":"Content", - "documentation":"

The subject of the message: A short summary of the content, which will appear in the recipient's inbox.

" - }, - "Body":{ - "shape":"Body", - "documentation":"

The message body.

" - } - }, - "documentation":"

Represents the message to be sent, composed of a subject and a body.

" - }, - "MessageData":{"type":"string"}, - "MessageDsn":{ - "type":"structure", - "required":["ReportingMta"], - "members":{ - "ReportingMta":{ - "shape":"ReportingMta", - "documentation":"

The reporting MTA that attempted to deliver the message, formatted as specified in RFC 3464 (mta-name-type; mta-name). The default value is dns; inbound-smtp.[region].amazonaws.com.

" - }, - "ArrivalDate":{ - "shape":"ArrivalDate", - "documentation":"

When the message was received by the reporting mail transfer agent (MTA), in RFC 822 date-time format.

" - }, - "ExtensionFields":{ - "shape":"ExtensionFieldList", - "documentation":"

Additional X-headers to include in the DSN.

" - } - }, - "documentation":"

Message-related information to include in the Delivery Status Notification (DSN) when an email that Amazon SES receives on your behalf bounces.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

" - }, - "MessageId":{"type":"string"}, - "MessageRejected":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

", - "error":{ - "code":"MessageRejected", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "MessageTag":{ - "type":"structure", - "required":[ - "Name", - "Value" - ], - "members":{ - "Name":{ - "shape":"MessageTagName", - "documentation":"

The name of the tag. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain less than 256 characters.

" - }, - "Value":{ - "shape":"MessageTagValue", - "documentation":"

The value of the tag. The value must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Contain less than 256 characters.

" - } - }, - "documentation":"

Contains the name and value of a tag that you can provide to SendEmail or SendRawEmail to apply to an email.

Message tags, which you use with configuration sets, enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "MessageTagList":{ - "type":"list", - "member":{"shape":"MessageTag"} - }, - "MessageTagName":{"type":"string"}, - "MessageTagValue":{"type":"string"}, - "MissingRenderingAttributeException":{ - "type":"structure", - "members":{ - "TemplateName":{"shape":"TemplateName"} - }, - "documentation":"

Indicates that one or more of the replacement values for the specified template was not specified. Ensure that the TemplateData object contains references to all of the replacement tags in the specified template.

", - "error":{ - "code":"MissingRenderingAttribute", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NextToken":{"type":"string"}, - "NotificationAttributes":{ - "type":"map", - "key":{"shape":"Identity"}, - "value":{"shape":"IdentityNotificationAttributes"} - }, - "NotificationTopic":{"type":"string"}, - "NotificationType":{ - "type":"string", - "enum":[ - "Bounce", - "Complaint", - "Delivery" - ] - }, - "Policy":{ - "type":"string", - "min":1 - }, - "PolicyMap":{ - "type":"map", - "key":{"shape":"PolicyName"}, - "value":{"shape":"Policy"} - }, - "PolicyName":{ - "type":"string", - "max":64, - "min":1 - }, - "PolicyNameList":{ - "type":"list", - "member":{"shape":"PolicyName"} - }, - "ProductionAccessNotGrantedException":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the account has not been granted production access.

", - "error":{ - "code":"ProductionAccessNotGranted", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PutIdentityPolicyRequest":{ - "type":"structure", - "required":[ - "Identity", - "PolicyName", - "Policy" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity that the policy will apply to. You can specify an identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

" - }, - "PolicyName":{ - "shape":"PolicyName", - "documentation":"

The name of the policy.

The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.

" - }, - "Policy":{ - "shape":"Policy", - "documentation":"

The text of the policy in JSON format. The policy cannot exceed 4 KB.

For information about the syntax of sending authorization policies, see the Amazon SES Developer Guide.

" - } - }, - "documentation":"

Represents a request to add or update a sending authorization policy for an identity. Sending authorization is an Amazon SES feature that enables you to authorize other senders to use your identities. For information, see the Amazon SES Developer Guide.

" - }, - "PutIdentityPolicyResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "RawMessage":{ - "type":"structure", - "required":["Data"], - "members":{ - "Data":{ - "shape":"RawMessageData", - "documentation":"

The raw data of the message. This data needs to base64-encoded if you are accessing Amazon SES directly through the HTTPS interface. If you are accessing Amazon SES using an AWS SDK, the SDK takes care of the base 64-encoding for you. In all cases, the client must ensure that the message format complies with Internet email standards regarding email header fields, MIME types, and MIME encoding.

The To:, CC:, and BCC: headers in the raw message can contain a group list.

If you are using SendRawEmail with sending authorization, you can include X-headers in the raw message to specify the \"Source,\" \"From,\" and \"Return-Path\" addresses. For more information, see the documentation for SendRawEmail.

Do not include these X-headers in the DKIM signature, because they are removed by Amazon SES before sending the email.

For more information, go to the Amazon SES Developer Guide.

" - } - }, - "documentation":"

Represents the raw data of the message.

" - }, - "RawMessageData":{"type":"blob"}, - "ReceiptAction":{ - "type":"structure", - "members":{ - "S3Action":{ - "shape":"S3Action", - "documentation":"

Saves the received message to an Amazon Simple Storage Service (Amazon S3) bucket and, optionally, publishes a notification to Amazon SNS.

" - }, - "BounceAction":{ - "shape":"BounceAction", - "documentation":"

Rejects the received email by returning a bounce response to the sender and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

" - }, - "WorkmailAction":{ - "shape":"WorkmailAction", - "documentation":"

Calls Amazon WorkMail and, optionally, publishes a notification to Amazon Amazon SNS.

" - }, - "LambdaAction":{ - "shape":"LambdaAction", - "documentation":"

Calls an AWS Lambda function, and optionally, publishes a notification to Amazon SNS.

" - }, - "StopAction":{ - "shape":"StopAction", - "documentation":"

Terminates the evaluation of the receipt rule set and optionally publishes a notification to Amazon SNS.

" - }, - "AddHeaderAction":{ - "shape":"AddHeaderAction", - "documentation":"

Adds a header to the received email.

" - }, - "SNSAction":{ - "shape":"SNSAction", - "documentation":"

Publishes the email content within a notification to Amazon SNS.

" - } - }, - "documentation":"

An action that Amazon SES can take when it receives an email on behalf of one or more email addresses or domains that you own. An instance of this data type can represent only one action.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

" - }, - "ReceiptActionsList":{ - "type":"list", - "member":{"shape":"ReceiptAction"} - }, - "ReceiptFilter":{ - "type":"structure", - "required":[ - "Name", - "IpFilter" - ], - "members":{ - "Name":{ - "shape":"ReceiptFilterName", - "documentation":"

The name of the IP address filter. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Start and end with a letter or number.

  • Contain less than 64 characters.

" - }, - "IpFilter":{ - "shape":"ReceiptIpFilter", - "documentation":"

A structure that provides the IP addresses to block or allow, and whether to block or allow incoming mail from them.

" - } - }, - "documentation":"

A receipt IP address filter enables you to specify whether to accept or reject mail originating from an IP address or range of IP addresses.

For information about setting up IP address filters, see the Amazon SES Developer Guide.

" - }, - "ReceiptFilterList":{ - "type":"list", - "member":{"shape":"ReceiptFilter"} - }, - "ReceiptFilterName":{"type":"string"}, - "ReceiptFilterPolicy":{ - "type":"string", - "enum":[ - "Block", - "Allow" - ] - }, - "ReceiptIpFilter":{ - "type":"structure", - "required":[ - "Policy", - "Cidr" - ], - "members":{ - "Policy":{ - "shape":"ReceiptFilterPolicy", - "documentation":"

Indicates whether to block or allow incoming mail from the specified IP addresses.

" - }, - "Cidr":{ - "shape":"Cidr", - "documentation":"

A single IP address or a range of IP addresses that you want to block or allow, specified in Classless Inter-Domain Routing (CIDR) notation. An example of a single email address is 10.0.0.1. An example of a range of IP addresses is 10.0.0.1/24. For more information about CIDR notation, see RFC 2317.

" - } - }, - "documentation":"

A receipt IP address filter enables you to specify whether to accept or reject mail originating from an IP address or range of IP addresses.

For information about setting up IP address filters, see the Amazon SES Developer Guide.

" - }, - "ReceiptRule":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of the receipt rule. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Start and end with a letter or number.

  • Contain less than 64 characters.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

If true, the receipt rule is active. The default value is false.

" - }, - "TlsPolicy":{ - "shape":"TlsPolicy", - "documentation":"

Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted with Transport Layer Security (TLS). If this parameter is set to Require, Amazon SES will bounce emails that are not received over TLS. The default is Optional.

" - }, - "Recipients":{ - "shape":"RecipientsList", - "documentation":"

The recipient domains and email addresses that the receipt rule applies to. If this field is not specified, this rule will match all recipients under all verified domains.

" - }, - "Actions":{ - "shape":"ReceiptActionsList", - "documentation":"

An ordered list of actions to perform on messages that match at least one of the recipient email addresses or domains specified in the receipt rule.

" - }, - "ScanEnabled":{ - "shape":"Enabled", - "documentation":"

If true, then messages that this receipt rule applies to are scanned for spam and viruses. The default value is false.

" - } - }, - "documentation":"

Receipt rules enable you to specify which actions Amazon SES should take when it receives mail on behalf of one or more email addresses or domains that you own.

Each receipt rule defines a set of email addresses or domains that it applies to. If the email addresses or domains match at least one recipient address of the message, Amazon SES executes all of the receipt rule's actions on the message.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

" - }, - "ReceiptRuleName":{"type":"string"}, - "ReceiptRuleNamesList":{ - "type":"list", - "member":{"shape":"ReceiptRuleName"} - }, - "ReceiptRuleSetMetadata":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set. The name must:

  • This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

  • Start and end with a letter or number.

  • Contain less than 64 characters.

" - }, - "CreatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time the receipt rule set was created.

" - } - }, - "documentation":"

Information about a receipt rule set.

A receipt rule set is a collection of rules that specify what Amazon SES should do with mail it receives on behalf of your account's verified domains.

For information about setting up receipt rule sets, see the Amazon SES Developer Guide.

" - }, - "ReceiptRuleSetName":{"type":"string"}, - "ReceiptRuleSetsLists":{ - "type":"list", - "member":{"shape":"ReceiptRuleSetMetadata"} - }, - "ReceiptRulesList":{ - "type":"list", - "member":{"shape":"ReceiptRule"} - }, - "Recipient":{"type":"string"}, - "RecipientDsnFields":{ - "type":"structure", - "required":[ - "Action", - "Status" - ], - "members":{ - "FinalRecipient":{ - "shape":"Address", - "documentation":"

The email address that the message was ultimately delivered to. This corresponds to the Final-Recipient in the DSN. If not specified, FinalRecipient will be set to the Recipient specified in the BouncedRecipientInfo structure. Either FinalRecipient or the recipient in BouncedRecipientInfo must be a recipient of the original bounced message.

Do not prepend the FinalRecipient email address with rfc 822;, as described in RFC 3798.

" - }, - "Action":{ - "shape":"DsnAction", - "documentation":"

The action performed by the reporting mail transfer agent (MTA) as a result of its attempt to deliver the message to the recipient address. This is required by RFC 3464.

" - }, - "RemoteMta":{ - "shape":"RemoteMta", - "documentation":"

The MTA to which the remote MTA attempted to deliver the message, formatted as specified in RFC 3464 (mta-name-type; mta-name). This parameter typically applies only to propagating synchronous bounces.

" - }, - "Status":{ - "shape":"DsnStatus", - "documentation":"

The status code that indicates what went wrong. This is required by RFC 3464.

" - }, - "DiagnosticCode":{ - "shape":"DiagnosticCode", - "documentation":"

An extended explanation of what went wrong; this is usually an SMTP response. See RFC 3463 for the correct formatting of this parameter.

" - }, - "LastAttemptDate":{ - "shape":"LastAttemptDate", - "documentation":"

The time the final delivery attempt was made, in RFC 822 date-time format.

" - }, - "ExtensionFields":{ - "shape":"ExtensionFieldList", - "documentation":"

Additional X-headers to include in the DSN.

" - } - }, - "documentation":"

Recipient-related information to include in the Delivery Status Notification (DSN) when an email that Amazon SES receives on your behalf bounces.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.

" - }, - "RecipientsList":{ - "type":"list", - "member":{"shape":"Recipient"} - }, - "RemoteMta":{"type":"string"}, - "RenderedTemplate":{"type":"string"}, - "ReorderReceiptRuleSetRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "RuleNames" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set to reorder.

" - }, - "RuleNames":{ - "shape":"ReceiptRuleNamesList", - "documentation":"

A list of the specified receipt rule set's receipt rules in the order that you want to put them.

" - } - }, - "documentation":"

Represents a request to reorder the receipt rules within a receipt rule set. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "ReorderReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "ReportingMta":{"type":"string"}, - "ReputationOptions":{ - "type":"structure", - "members":{ - "SendingEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether email sending is enabled or disabled for the configuration set. If the value is true, then Amazon SES will send emails that use the configuration set. If the value is false, Amazon SES will not send emails that use the configuration set. The default value is true. You can change this setting using UpdateConfigurationSetSendingEnabled.

" - }, - "ReputationMetricsEnabled":{ - "shape":"Enabled", - "documentation":"

Describes whether or not Amazon SES publishes reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch.

If the value is true, reputation metrics are published. If the value is false, reputation metrics are not published. The default value is false.

" - }, - "LastFreshStart":{ - "shape":"LastFreshStart", - "documentation":"

The date and time at which the reputation metrics for the configuration set were last reset. Resetting these metrics is known as a fresh start.

When you disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled and later re-enable it, the reputation metrics for the configuration set (but not for the entire Amazon SES account) are reset.

If email sending for the configuration set has never been disabled and later re-enabled, the value of this attribute is null.

" - } - }, - "documentation":"

Contains information about the reputation settings for a configuration set.

" - }, - "RuleDoesNotExistException":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleOrRuleSetName", - "documentation":"

Indicates that the named receipt rule does not exist.

" - } - }, - "documentation":"

Indicates that the provided receipt rule does not exist.

", - "error":{ - "code":"RuleDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "RuleOrRuleSetName":{"type":"string"}, - "RuleSetDoesNotExistException":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"RuleOrRuleSetName", - "documentation":"

Indicates that the named receipt rule set does not exist.

" - } - }, - "documentation":"

Indicates that the provided receipt rule set does not exist.

", - "error":{ - "code":"RuleSetDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "S3Action":{ - "type":"structure", - "required":["BucketName"], - "members":{ - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the Amazon SNS topic to notify when the message is saved to the Amazon S3 bucket. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - }, - "BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the Amazon S3 bucket that incoming email will be saved to.

" - }, - "ObjectKeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The key prefix of the Amazon S3 bucket. The key prefix is similar to a directory name that enables you to store similar data under the same directory in a bucket.

" - }, - "KmsKeyArn":{ - "shape":"AmazonResourceName", - "documentation":"

The customer master key that Amazon SES should use to encrypt your emails before saving them to the Amazon S3 bucket. You can use the default master key or a custom master key you created in AWS KMS as follows:

  • To use the default master key, provide an ARN in the form of arn:aws:kms:REGION:ACCOUNT-ID-WITHOUT-HYPHENS:alias/aws/ses. For example, if your AWS account ID is 123456789012 and you want to use the default master key in the US West (Oregon) region, the ARN of the default master key would be arn:aws:kms:us-west-2:123456789012:alias/aws/ses. If you use the default master key, you don't need to perform any extra steps to give Amazon SES permission to use the key.

  • To use a custom master key you created in AWS KMS, provide the ARN of the master key and ensure that you add a statement to your key's policy to give Amazon SES permission to use it. For more information about giving permissions, see the Amazon SES Developer Guide.

For more information about key policies, see the AWS KMS Developer Guide. If you do not specify a master key, Amazon SES will not encrypt your emails.

Your mail is encrypted by Amazon SES using the Amazon S3 encryption client before the mail is submitted to Amazon S3 for storage. It is not encrypted using Amazon S3 server-side encryption. This means that you must use the Amazon S3 encryption client to decrypt the email after retrieving it from Amazon S3, as the service has no access to use your AWS KMS keys for decryption. This encryption client is currently available with the AWS SDK for Java and AWS SDK for Ruby only. For more information about client-side encryption using AWS KMS master keys, see the Amazon S3 Developer Guide.

" - } - }, - "documentation":"

When included in a receipt rule, this action saves the received message to an Amazon Simple Storage Service (Amazon S3) bucket and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

To enable Amazon SES to write emails to your Amazon S3 bucket, use an AWS KMS key to encrypt your emails, or publish to an Amazon SNS topic of another account, Amazon SES must have permission to access those resources. For information about giving permissions, see the Amazon SES Developer Guide.

When you save your emails to an Amazon S3 bucket, the maximum email size (including headers) is 30 MB. Emails larger than that will bounce.

For information about specifying Amazon S3 actions in receipt rules, see the Amazon SES Developer Guide.

" - }, - "S3BucketName":{"type":"string"}, - "S3KeyPrefix":{"type":"string"}, - "SNSAction":{ - "type":"structure", - "required":["TopicArn"], - "members":{ - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - }, - "Encoding":{ - "shape":"SNSActionEncoding", - "documentation":"

The encoding to use for the email within the Amazon SNS notification. UTF-8 is easier to use, but may not preserve all special characters when a message was encoded with a different encoding format. Base64 preserves all special characters. The default value is UTF-8.

" - } - }, - "documentation":"

When included in a receipt rule, this action publishes a notification to Amazon Simple Notification Service (Amazon SNS). This action includes a complete copy of the email content in the Amazon SNS notifications. Amazon SNS notifications for all other actions simply provide information about the email. They do not include the email content itself.

If you own the Amazon SNS topic, you don't need to do anything to give Amazon SES permission to publish emails to it. However, if you don't own the Amazon SNS topic, you need to attach a policy to the topic to give Amazon SES permissions to access it. For information about giving permissions, see the Amazon SES Developer Guide.

You can only publish emails that are 150 KB or less (including the header) to Amazon SNS. Larger emails will bounce. If you anticipate emails larger than 150 KB, use the S3 action instead.

For information about using a receipt rule to publish an Amazon SNS notification, see the Amazon SES Developer Guide.

" - }, - "SNSActionEncoding":{ - "type":"string", - "enum":[ - "UTF-8", - "Base64" - ] - }, - "SNSDestination":{ - "type":"structure", - "required":["TopicARN"], - "members":{ - "TopicARN":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the Amazon SNS topic that email sending events will be published to. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - } - }, - "documentation":"

Contains the topic ARN associated with an Amazon Simple Notification Service (Amazon SNS) event destination.

Event destinations, such as Amazon SNS, are associated with configuration sets, which enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "SendBounceRequest":{ - "type":"structure", - "required":[ - "OriginalMessageId", - "BounceSender", - "BouncedRecipientInfoList" - ], - "members":{ - "OriginalMessageId":{ - "shape":"MessageId", - "documentation":"

The message ID of the message to be bounced.

" - }, - "BounceSender":{ - "shape":"Address", - "documentation":"

The address to use in the \"From\" header of the bounce message. This must be an identity that you have verified with Amazon SES.

" - }, - "Explanation":{ - "shape":"Explanation", - "documentation":"

Human-readable text for the bounce message to explain the failure. If not specified, the text will be auto-generated based on the bounced recipient information.

" - }, - "MessageDsn":{ - "shape":"MessageDsn", - "documentation":"

Message-related DSN fields. If not specified, Amazon SES will choose the values.

" - }, - "BouncedRecipientInfoList":{ - "shape":"BouncedRecipientInfoList", - "documentation":"

A list of recipients of the bounced message, including the information required to create the Delivery Status Notifications (DSNs) for the recipients. You must specify at least one BouncedRecipientInfo in the list.

" - }, - "BounceSenderArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the address in the \"From\" header of the bounce. For more information about sending authorization, see the Amazon SES Developer Guide.

" - } - }, - "documentation":"

Represents a request to send a bounce message to the sender of an email you received through Amazon SES.

" - }, - "SendBounceResponse":{ - "type":"structure", - "members":{ - "MessageId":{ - "shape":"MessageId", - "documentation":"

The message ID of the bounce message.

" - } - }, - "documentation":"

Represents a unique message ID.

" - }, - "SendBulkTemplatedEmailRequest":{ - "type":"structure", - "required":[ - "Source", - "Template", - "Destinations" - ], - "members":{ - "Source":{ - "shape":"Address", - "documentation":"

The email address that is sending the email. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES. For information about verifying identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted to do so by a sending authorization policy, then you must also specify the SourceArn parameter. For more information about sending authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531. For this reason, the local part of a source email address (the part of the email address that precedes the @ sign) may only contain 7-bit ASCII characters. If the domain part of an address (the part after the @ sign) contains non-ASCII characters, they must be encoded using Punycode, as described in RFC3492. The sender name (also known as the friendly name) may contain non-ASCII characters. These characters must be encoded using MIME encoded-word syntax, as described in RFC 2047. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=.

" - }, - "SourceArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to send for the email address specified in the Source parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to send from user@example.com, then you would specify the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the Source to be user@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "ReplyToAddresses":{ - "shape":"AddressList", - "documentation":"

The reply-to email address(es) for the message. If the recipient replies to the message, each reply-to address will receive the reply.

" - }, - "ReturnPath":{ - "shape":"Address", - "documentation":"

The email address that bounces and complaints will be forwarded to when feedback forwarding is enabled. If the message cannot be delivered to the recipient, then an error message will be returned from the recipient's ISP; this message will then be forwarded to the email address specified by the ReturnPath parameter. The ReturnPath parameter is never overwritten. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES.

" - }, - "ReturnPathArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the ReturnPath parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the ReturnPath to be feedback@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to use when you send an email using SendBulkTemplatedEmail.

" - }, - "DefaultTags":{ - "shape":"MessageTagList", - "documentation":"

A list of tags, in the form of name/value pairs, to apply to an email that you send to a destination using SendBulkTemplatedEmail.

" - }, - "Template":{ - "shape":"TemplateName", - "documentation":"

The template to use when sending this email.

" - }, - "TemplateArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the template to use when sending this email.

" - }, - "DefaultTemplateData":{ - "shape":"TemplateData", - "documentation":"

A list of replacement values to apply to the template when replacement data is not specified in a Destination object. These values act as a default or fallback option when no other data is available.

The template data is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.

" - }, - "Destinations":{ - "shape":"BulkEmailDestinationList", - "documentation":"

One or more Destination objects. All of the recipients in a Destination will receive the same version of the email. You can specify up to 50 Destination objects within a Destinations array.

" - } - }, - "documentation":"

Represents a request to send a templated email to multiple destinations using Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SendBulkTemplatedEmailResponse":{ - "type":"structure", - "required":["Status"], - "members":{ - "Status":{ - "shape":"BulkEmailDestinationStatusList", - "documentation":"

The unique message identifier returned from the SendBulkTemplatedEmail action.

" - } - } - }, - "SendCustomVerificationEmailRequest":{ - "type":"structure", - "required":[ - "EmailAddress", - "TemplateName" - ], - "members":{ - "EmailAddress":{ - "shape":"Address", - "documentation":"

The email address to verify.

" - }, - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template to use when sending the verification email.

" - }, - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Name of a configuration set to use when sending the verification email.

" - } - }, - "documentation":"

Represents a request to send a custom verification email to a specified recipient.

" - }, - "SendCustomVerificationEmailResponse":{ - "type":"structure", - "members":{ - "MessageId":{ - "shape":"MessageId", - "documentation":"

The unique message identifier returned from the SendCustomVerificationEmail operation.

" - } - }, - "documentation":"

The response received when attempting to send the custom verification email.

" - }, - "SendDataPoint":{ - "type":"structure", - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

Time of the data point.

" - }, - "DeliveryAttempts":{ - "shape":"Counter", - "documentation":"

Number of emails that have been sent.

" - }, - "Bounces":{ - "shape":"Counter", - "documentation":"

Number of emails that have bounced.

" - }, - "Complaints":{ - "shape":"Counter", - "documentation":"

Number of unwanted emails that were rejected by recipients.

" - }, - "Rejects":{ - "shape":"Counter", - "documentation":"

Number of emails rejected by Amazon SES.

" - } - }, - "documentation":"

Represents sending statistics data. Each SendDataPoint contains statistics for a 15-minute period of sending activity.

" - }, - "SendDataPointList":{ - "type":"list", - "member":{"shape":"SendDataPoint"} - }, - "SendEmailRequest":{ - "type":"structure", - "required":[ - "Source", - "Destination", - "Message" - ], - "members":{ - "Source":{ - "shape":"Address", - "documentation":"

The email address that is sending the email. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES. For information about verifying identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted to do so by a sending authorization policy, then you must also specify the SourceArn parameter. For more information about sending authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531. For this reason, the local part of a source email address (the part of the email address that precedes the @ sign) may only contain 7-bit ASCII characters. If the domain part of an address (the part after the @ sign) contains non-ASCII characters, they must be encoded using Punycode, as described in RFC3492. The sender name (also known as the friendly name) may contain non-ASCII characters. These characters must be encoded using MIME encoded-word syntax, as described in RFC 2047. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=.

" - }, - "Destination":{ - "shape":"Destination", - "documentation":"

The destination for this email, composed of To:, CC:, and BCC: fields.

" - }, - "Message":{ - "shape":"Message", - "documentation":"

The message to be sent.

" - }, - "ReplyToAddresses":{ - "shape":"AddressList", - "documentation":"

The reply-to email address(es) for the message. If the recipient replies to the message, each reply-to address will receive the reply.

" - }, - "ReturnPath":{ - "shape":"Address", - "documentation":"

The email address that bounces and complaints will be forwarded to when feedback forwarding is enabled. If the message cannot be delivered to the recipient, then an error message will be returned from the recipient's ISP; this message will then be forwarded to the email address specified by the ReturnPath parameter. The ReturnPath parameter is never overwritten. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES.

" - }, - "SourceArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to send for the email address specified in the Source parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to send from user@example.com, then you would specify the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the Source to be user@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "ReturnPathArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the ReturnPath parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the ReturnPath to be feedback@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "Tags":{ - "shape":"MessageTagList", - "documentation":"

A list of tags, in the form of name/value pairs, to apply to an email that you send using SendEmail. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

" - }, - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to use when you send an email using SendEmail.

" - } - }, - "documentation":"

Represents a request to send a single formatted email using Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SendEmailResponse":{ - "type":"structure", - "required":["MessageId"], - "members":{ - "MessageId":{ - "shape":"MessageId", - "documentation":"

The unique message identifier returned from the SendEmail action.

" - } - }, - "documentation":"

Represents a unique message ID.

" - }, - "SendRawEmailRequest":{ - "type":"structure", - "required":["RawMessage"], - "members":{ - "Source":{ - "shape":"Address", - "documentation":"

The identity's email address. If you do not provide a value for this parameter, you must specify a \"From\" address in the raw text of the message. (You can also specify both.)

Amazon SES does not support the SMTPUTF8 extension, as described inRFC6531. For this reason, the local part of a source email address (the part of the email address that precedes the @ sign) may only contain 7-bit ASCII characters. If the domain part of an address (the part after the @ sign) contains non-ASCII characters, they must be encoded using Punycode, as described in RFC3492. The sender name (also known as the friendly name) may contain non-ASCII characters. These characters must be encoded using MIME encoded-word syntax, as described in RFC 2047. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=.

If you specify the Source parameter and have feedback forwarding enabled, then bounces and complaints will be sent to this email address. This takes precedence over any Return-Path header that you might include in the raw text of the message.

" - }, - "Destinations":{ - "shape":"AddressList", - "documentation":"

A list of destinations for the message, consisting of To:, CC:, and BCC: addresses.

" - }, - "RawMessage":{ - "shape":"RawMessage", - "documentation":"

The raw text of the message. The client is responsible for ensuring the following:

  • Message must contain a header and a body, separated by a blank line.

  • All required header fields must be present.

  • Each part of a multipart MIME message must be formatted properly.

  • MIME content types must be among those supported by Amazon SES. For more information, go to the Amazon SES Developer Guide.

  • Must be base64-encoded.

  • Per RFC 5321, the maximum length of each line of text, including the <CRLF>, must not exceed 1,000 characters.

" - }, - "FromArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to specify a particular \"From\" address in the header of the raw email.

Instead of using this parameter, you can use the X-header X-SES-FROM-ARN in the raw message of the email. If you use both the FromArn parameter and the corresponding X-header, Amazon SES uses the value of the FromArn parameter.

For information about when to use this parameter, see the description of SendRawEmail in this guide, or see the Amazon SES Developer Guide.

" - }, - "SourceArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to send for the email address specified in the Source parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to send from user@example.com, then you would specify the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the Source to be user@example.com.

Instead of using this parameter, you can use the X-header X-SES-SOURCE-ARN in the raw message of the email. If you use both the SourceArn parameter and the corresponding X-header, Amazon SES uses the value of the SourceArn parameter.

For information about when to use this parameter, see the description of SendRawEmail in this guide, or see the Amazon SES Developer Guide.

" - }, - "ReturnPathArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the ReturnPath parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the ReturnPath to be feedback@example.com.

Instead of using this parameter, you can use the X-header X-SES-RETURN-PATH-ARN in the raw message of the email. If you use both the ReturnPathArn parameter and the corresponding X-header, Amazon SES uses the value of the ReturnPathArn parameter.

For information about when to use this parameter, see the description of SendRawEmail in this guide, or see the Amazon SES Developer Guide.

" - }, - "Tags":{ - "shape":"MessageTagList", - "documentation":"

A list of tags, in the form of name/value pairs, to apply to an email that you send using SendRawEmail. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

" - }, - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to use when you send an email using SendRawEmail.

" - } - }, - "documentation":"

Represents a request to send a single raw email using Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SendRawEmailResponse":{ - "type":"structure", - "required":["MessageId"], - "members":{ - "MessageId":{ - "shape":"MessageId", - "documentation":"

The unique message identifier returned from the SendRawEmail action.

" - } - }, - "documentation":"

Represents a unique message ID.

" - }, - "SendTemplatedEmailRequest":{ - "type":"structure", - "required":[ - "Source", - "Destination", - "Template", - "TemplateData" - ], - "members":{ - "Source":{ - "shape":"Address", - "documentation":"

The email address that is sending the email. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES. For information about verifying identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted to do so by a sending authorization policy, then you must also specify the SourceArn parameter. For more information about sending authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531. For this reason, the local part of a source email address (the part of the email address that precedes the @ sign) may only contain 7-bit ASCII characters. If the domain part of an address (the part after the @ sign) contains non-ASCII characters, they must be encoded using Punycode, as described in RFC3492. The sender name (also known as the friendly name) may contain non-ASCII characters. These characters must be encoded using MIME encoded-word syntax, as described inRFC 2047. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=.

" - }, - "Destination":{ - "shape":"Destination", - "documentation":"

The destination for this email, composed of To:, CC:, and BCC: fields. A Destination can include up to 50 recipients across these three fields.

" - }, - "ReplyToAddresses":{ - "shape":"AddressList", - "documentation":"

The reply-to email address(es) for the message. If the recipient replies to the message, each reply-to address will receive the reply.

" - }, - "ReturnPath":{ - "shape":"Address", - "documentation":"

The email address that bounces and complaints will be forwarded to when feedback forwarding is enabled. If the message cannot be delivered to the recipient, then an error message will be returned from the recipient's ISP; this message will then be forwarded to the email address specified by the ReturnPath parameter. The ReturnPath parameter is never overwritten. This email address must be either individually verified with Amazon SES, or from a domain that has been verified with Amazon SES.

" - }, - "SourceArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to send for the email address specified in the Source parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to send from user@example.com, then you would specify the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the Source to be user@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "ReturnPathArn":{ - "shape":"AmazonResourceName", - "documentation":"

This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the ReturnPath parameter.

For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the ReturnPath to be feedback@example.com.

For more information about sending authorization, see the Amazon SES Developer Guide.

" - }, - "Tags":{ - "shape":"MessageTagList", - "documentation":"

A list of tags, in the form of name/value pairs, to apply to an email that you send using SendTemplatedEmail. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

" - }, - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set to use when you send an email using SendTemplatedEmail.

" - }, - "Template":{ - "shape":"TemplateName", - "documentation":"

The template to use when sending this email.

" - }, - "TemplateArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the template to use when sending this email.

" - }, - "TemplateData":{ - "shape":"TemplateData", - "documentation":"

A list of replacement values to apply to the template. This parameter is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.

" - } - }, - "documentation":"

Represents a request to send a templated email using Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SendTemplatedEmailResponse":{ - "type":"structure", - "required":["MessageId"], - "members":{ - "MessageId":{ - "shape":"MessageId", - "documentation":"

The unique message identifier returned from the SendTemplatedEmail action.

" - } - } - }, - "SentLast24Hours":{"type":"double"}, - "SetActiveReceiptRuleSetRequest":{ - "type":"structure", - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set to make active. Setting this value to null disables all email receiving.

" - } - }, - "documentation":"

Represents a request to set a receipt rule set as the active receipt rule set. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SetActiveReceiptRuleSetResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetIdentityDkimEnabledRequest":{ - "type":"structure", - "required":[ - "Identity", - "DkimEnabled" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity for which DKIM signing should be enabled or disabled.

" - }, - "DkimEnabled":{ - "shape":"Enabled", - "documentation":"

Sets whether DKIM signing is enabled for an identity. Set to true to enable DKIM signing for this identity; false to disable it.

" - } - }, - "documentation":"

Represents a request to enable or disable Amazon SES Easy DKIM signing for an identity. For more information about setting up Easy DKIM, see the Amazon SES Developer Guide.

" - }, - "SetIdentityDkimEnabledResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetIdentityFeedbackForwardingEnabledRequest":{ - "type":"structure", - "required":[ - "Identity", - "ForwardingEnabled" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity for which to set bounce and complaint notification forwarding. Examples: user@example.com, example.com.

" - }, - "ForwardingEnabled":{ - "shape":"Enabled", - "documentation":"

Sets whether Amazon SES will forward bounce and complaint notifications as email. true specifies that Amazon SES will forward bounce and complaint notifications as email, in addition to any Amazon SNS topic publishing otherwise specified. false specifies that Amazon SES will publish bounce and complaint notifications only through Amazon SNS. This value can only be set to false when Amazon SNS topics are set for both Bounce and Complaint notification types.

" - } - }, - "documentation":"

Represents a request to enable or disable whether Amazon SES forwards you bounce and complaint notifications through email. For information about email feedback forwarding, see the Amazon SES Developer Guide.

" - }, - "SetIdentityFeedbackForwardingEnabledResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetIdentityHeadersInNotificationsEnabledRequest":{ - "type":"structure", - "required":[ - "Identity", - "NotificationType", - "Enabled" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity for which to enable or disable headers in notifications. Examples: user@example.com, example.com.

" - }, - "NotificationType":{ - "shape":"NotificationType", - "documentation":"

The notification type for which to enable or disable headers in notifications.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Sets whether Amazon SES includes the original email headers in Amazon SNS notifications of the specified notification type. A value of true specifies that Amazon SES will include headers in notifications, and a value of false specifies that Amazon SES will not include headers in notifications.

This value can only be set when NotificationType is already set to use a particular Amazon SNS topic.

" - } - }, - "documentation":"

Represents a request to set whether Amazon SES includes the original email headers in the Amazon SNS notifications of a specified type. For information about notifications, see the Amazon SES Developer Guide.

" - }, - "SetIdentityHeadersInNotificationsEnabledResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetIdentityMailFromDomainRequest":{ - "type":"structure", - "required":["Identity"], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The verified identity for which you want to enable or disable the specified custom MAIL FROM domain.

" - }, - "MailFromDomain":{ - "shape":"MailFromDomainName", - "documentation":"

The custom MAIL FROM domain that you want the verified identity to use. The MAIL FROM domain must 1) be a subdomain of the verified identity, 2) not be used in a \"From\" address if the MAIL FROM domain is the destination of email feedback forwarding (for more information, see the Amazon SES Developer Guide), and 3) not be used to receive emails. A value of null disables the custom MAIL FROM setting for the identity.

" - }, - "BehaviorOnMXFailure":{ - "shape":"BehaviorOnMXFailure", - "documentation":"

The action that you want Amazon SES to take if it cannot successfully read the required MX record when you send an email. If you choose UseDefaultValue, Amazon SES will use amazonses.com (or a subdomain of that) as the MAIL FROM domain. If you choose RejectMessage, Amazon SES will return a MailFromDomainNotVerified error and not send the email.

The action specified in BehaviorOnMXFailure is taken when the custom MAIL FROM domain setup is in the Pending, Failed, and TemporaryFailure states.

" - } - }, - "documentation":"

Represents a request to enable or disable the Amazon SES custom MAIL FROM domain setup for a verified identity. For information about using a custom MAIL FROM domain, see the Amazon SES Developer Guide.

" - }, - "SetIdentityMailFromDomainResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetIdentityNotificationTopicRequest":{ - "type":"structure", - "required":[ - "Identity", - "NotificationType" - ], - "members":{ - "Identity":{ - "shape":"Identity", - "documentation":"

The identity for which the Amazon SNS topic will be set. You can specify an identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

" - }, - "NotificationType":{ - "shape":"NotificationType", - "documentation":"

The type of notifications that will be published to the specified Amazon SNS topic.

" - }, - "SnsTopic":{ - "shape":"NotificationTopic", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic. If the parameter is omitted from the request or a null value is passed, SnsTopic is cleared and publishing is disabled.

" - } - }, - "documentation":"

Represents a request to specify the Amazon SNS topic to which Amazon SES will publish bounce, complaint, or delivery notifications for emails sent with that identity as the Source. For information about Amazon SES notifications, see the Amazon SES Developer Guide.

" - }, - "SetIdentityNotificationTopicResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "SetReceiptRulePositionRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "RuleName" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set that contains the receipt rule to reposition.

" - }, - "RuleName":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of the receipt rule to reposition.

" - }, - "After":{ - "shape":"ReceiptRuleName", - "documentation":"

The name of the receipt rule after which to place the specified receipt rule.

" - } - }, - "documentation":"

Represents a request to set the position of a receipt rule in a receipt rule set. You use receipt rule sets to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "SetReceiptRulePositionResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "StopAction":{ - "type":"structure", - "required":["Scope"], - "members":{ - "Scope":{ - "shape":"StopScope", - "documentation":"

The name of the RuleSet that is being stopped.

" - }, - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the stop action is taken. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - } - }, - "documentation":"

When included in a receipt rule, this action terminates the evaluation of the receipt rule set and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS).

For information about setting a stop action in a receipt rule, see the Amazon SES Developer Guide.

" - }, - "StopScope":{ - "type":"string", - "enum":["RuleSet"] - }, - "Subject":{"type":"string"}, - "SubjectPart":{"type":"string"}, - "SuccessRedirectionURL":{"type":"string"}, - "Template":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the template. You will refer to this name when you send email using the SendTemplatedEmail or SendBulkTemplatedEmail operations.

" - }, - "SubjectPart":{ - "shape":"SubjectPart", - "documentation":"

The subject line of the email.

" - }, - "TextPart":{ - "shape":"TextPart", - "documentation":"

The email body that will be visible to recipients whose email clients do not display HTML.

" - }, - "HtmlPart":{ - "shape":"HtmlPart", - "documentation":"

The HTML body of the email.

" - } - }, - "documentation":"

The content of the email, composed of a subject line, an HTML part, and a text-only part.

" - }, - "TemplateContent":{"type":"string"}, - "TemplateData":{ - "type":"string", - "max":262144 - }, - "TemplateDoesNotExistException":{ - "type":"structure", - "members":{ - "TemplateName":{"shape":"TemplateName"} - }, - "documentation":"

Indicates that the Template object you specified does not exist in your Amazon SES account.

", - "error":{ - "code":"TemplateDoesNotExist", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TemplateMetadata":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"TemplateName", - "documentation":"

The name of the template.

" - }, - "CreatedTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time and date the template was created.

" - } - }, - "documentation":"

Contains information about an email template.

" - }, - "TemplateMetadataList":{ - "type":"list", - "member":{"shape":"TemplateMetadata"} - }, - "TemplateName":{"type":"string"}, - "TestRenderTemplateRequest":{ - "type":"structure", - "required":[ - "TemplateName", - "TemplateData" - ], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the template that you want to render.

" - }, - "TemplateData":{ - "shape":"TemplateData", - "documentation":"

A list of replacement values to apply to the template. This parameter is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.

" - } - } - }, - "TestRenderTemplateResponse":{ - "type":"structure", - "members":{ - "RenderedTemplate":{ - "shape":"RenderedTemplate", - "documentation":"

The complete MIME message rendered by applying the data in the TemplateData parameter to the template specified in the TemplateName parameter.

" - } - } - }, - "TextPart":{"type":"string"}, - "Timestamp":{"type":"timestamp"}, - "TlsPolicy":{ - "type":"string", - "enum":[ - "Require", - "Optional" - ] - }, - "TrackingOptions":{ - "type":"structure", - "members":{ - "CustomRedirectDomain":{ - "shape":"CustomRedirectDomain", - "documentation":"

The custom subdomain that will be used to redirect email recipients to the Amazon SES event tracking domain.

" - } - }, - "documentation":"

A domain that is used to redirect email recipients to an Amazon SES-operated domain. This domain captures open and click events generated by Amazon SES emails.

For more information, see Configuring Custom Domains to Handle Open and Click Tracking in the Amazon SES Developer Guide.

" - }, - "TrackingOptionsAlreadyExistsException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that a TrackingOptions object already exists in the specified configuration set.

" - } - }, - "documentation":"

Indicates that the configuration set you specified already contains a TrackingOptions object.

", - "error":{ - "code":"TrackingOptionsAlreadyExistsException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "TrackingOptionsDoesNotExistException":{ - "type":"structure", - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

Indicates that a TrackingOptions object does not exist in the specified configuration set.

" - } - }, - "documentation":"

Indicates that the TrackingOptions object you specified does not exist.

", - "error":{ - "code":"TrackingOptionsDoesNotExistException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UpdateAccountSendingEnabledRequest":{ - "type":"structure", - "members":{ - "Enabled":{ - "shape":"Enabled", - "documentation":"

Describes whether email sending is enabled or disabled for your Amazon SES account in the current AWS Region.

" - } - }, - "documentation":"

Represents a request to enable or disable the email sending capabilities for your entire Amazon SES account.

" - }, - "UpdateConfigurationSetEventDestinationRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "EventDestination" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set that contains the event destination that you want to update.

" - }, - "EventDestination":{ - "shape":"EventDestination", - "documentation":"

The event destination object that you want to apply to the specified configuration set.

" - } - }, - "documentation":"

Represents a request to update the event destination of a configuration set. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

" - }, - "UpdateConfigurationSetEventDestinationResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "UpdateConfigurationSetReputationMetricsEnabledRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "Enabled" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set that you want to update.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Describes whether or not Amazon SES will publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch.

" - } - }, - "documentation":"

Represents a request to modify the reputation metric publishing settings for a configuration set.

" - }, - "UpdateConfigurationSetSendingEnabledRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "Enabled" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set that you want to update.

" - }, - "Enabled":{ - "shape":"Enabled", - "documentation":"

Describes whether email sending is enabled or disabled for the configuration set.

" - } - }, - "documentation":"

Represents a request to enable or disable the email sending capabilities for a specific configuration set.

" - }, - "UpdateConfigurationSetTrackingOptionsRequest":{ - "type":"structure", - "required":[ - "ConfigurationSetName", - "TrackingOptions" - ], - "members":{ - "ConfigurationSetName":{ - "shape":"ConfigurationSetName", - "documentation":"

The name of the configuration set for which you want to update the custom tracking domain.

" - }, - "TrackingOptions":{"shape":"TrackingOptions"} - }, - "documentation":"

Represents a request to update the tracking options for a configuration set.

" - }, - "UpdateConfigurationSetTrackingOptionsResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "UpdateCustomVerificationEmailTemplateRequest":{ - "type":"structure", - "required":["TemplateName"], - "members":{ - "TemplateName":{ - "shape":"TemplateName", - "documentation":"

The name of the custom verification email template that you want to update.

" - }, - "FromEmailAddress":{ - "shape":"FromAddress", - "documentation":"

The email address that the custom verification email is sent from.

" - }, - "TemplateSubject":{ - "shape":"Subject", - "documentation":"

The subject line of the custom verification email.

" - }, - "TemplateContent":{ - "shape":"TemplateContent", - "documentation":"

The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see Custom Verification Email Frequently Asked Questions in the Amazon SES Developer Guide.

" - }, - "SuccessRedirectionURL":{ - "shape":"SuccessRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

" - }, - "FailureRedirectionURL":{ - "shape":"FailureRedirectionURL", - "documentation":"

The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

" - } - }, - "documentation":"

Represents a request to update an existing custom verification email template.

" - }, - "UpdateReceiptRuleRequest":{ - "type":"structure", - "required":[ - "RuleSetName", - "Rule" - ], - "members":{ - "RuleSetName":{ - "shape":"ReceiptRuleSetName", - "documentation":"

The name of the receipt rule set that the receipt rule belongs to.

" - }, - "Rule":{ - "shape":"ReceiptRule", - "documentation":"

A data structure that contains the updated receipt rule information.

" - } - }, - "documentation":"

Represents a request to update a receipt rule. You use receipt rules to receive email with Amazon SES. For more information, see the Amazon SES Developer Guide.

" - }, - "UpdateReceiptRuleResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "UpdateTemplateRequest":{ - "type":"structure", - "required":["Template"], - "members":{ - "Template":{"shape":"Template"} - } - }, - "UpdateTemplateResponse":{ - "type":"structure", - "members":{ - } - }, - "VerificationAttributes":{ - "type":"map", - "key":{"shape":"Identity"}, - "value":{"shape":"IdentityVerificationAttributes"} - }, - "VerificationStatus":{ - "type":"string", - "enum":[ - "Pending", - "Success", - "Failed", - "TemporaryFailure", - "NotStarted" - ] - }, - "VerificationToken":{"type":"string"}, - "VerificationTokenList":{ - "type":"list", - "member":{"shape":"VerificationToken"} - }, - "VerifyDomainDkimRequest":{ - "type":"structure", - "required":["Domain"], - "members":{ - "Domain":{ - "shape":"Domain", - "documentation":"

The name of the domain to be verified for Easy DKIM signing.

" - } - }, - "documentation":"

Represents a request to generate the CNAME records needed to set up Easy DKIM with Amazon SES. For more information about setting up Easy DKIM, see the Amazon SES Developer Guide.

" - }, - "VerifyDomainDkimResponse":{ - "type":"structure", - "required":["DkimTokens"], - "members":{ - "DkimTokens":{ - "shape":"VerificationTokenList", - "documentation":"

A set of character strings that represent the domain's identity. If the identity is an email address, the tokens represent the domain of that address.

Using these tokens, you will need to create DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web Services will eventually detect that you have updated your DNS records; this detection process may take up to 72 hours. Upon successful detection, Amazon SES will be able to DKIM-sign emails originating from that domain.

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

" - } - }, - "documentation":"

Returns CNAME records that you must publish to the DNS server of your domain to set up Easy DKIM with Amazon SES.

" - }, - "VerifyDomainIdentityRequest":{ - "type":"structure", - "required":["Domain"], - "members":{ - "Domain":{ - "shape":"Domain", - "documentation":"

The domain to be verified.

" - } - }, - "documentation":"

Represents a request to begin Amazon SES domain verification and to generate the TXT records that you must publish to the DNS server of your domain to complete the verification. For information about domain verification, see the Amazon SES Developer Guide.

" - }, - "VerifyDomainIdentityResponse":{ - "type":"structure", - "required":["VerificationToken"], - "members":{ - "VerificationToken":{ - "shape":"VerificationToken", - "documentation":"

A TXT record that you must place in the DNS settings of the domain to complete domain verification with Amazon SES.

As Amazon SES searches for the TXT record, the domain's verification status is \"Pending\". When Amazon SES detects the record, the domain's verification status changes to \"Success\". If Amazon SES is unable to detect the record within 72 hours, the domain's verification status changes to \"Failed.\" In that case, if you still want to verify the domain, you must restart the verification process from the beginning.

" - } - }, - "documentation":"

Returns a TXT record that you must publish to the DNS server of your domain to complete domain verification with Amazon SES.

" - }, - "VerifyEmailAddressRequest":{ - "type":"structure", - "required":["EmailAddress"], - "members":{ - "EmailAddress":{ - "shape":"Address", - "documentation":"

The email address to be verified.

" - } - }, - "documentation":"

Represents a request to begin email address verification with Amazon SES. For information about email address verification, see the Amazon SES Developer Guide.

" - }, - "VerifyEmailIdentityRequest":{ - "type":"structure", - "required":["EmailAddress"], - "members":{ - "EmailAddress":{ - "shape":"Address", - "documentation":"

The email address to be verified.

" - } - }, - "documentation":"

Represents a request to begin email address verification with Amazon SES. For information about email address verification, see the Amazon SES Developer Guide.

" - }, - "VerifyEmailIdentityResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

An empty element returned on a successful request.

" - }, - "WorkmailAction":{ - "type":"structure", - "required":["OrganizationArn"], - "members":{ - "TopicArn":{ - "shape":"AmazonResourceName", - "documentation":"

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the WorkMail action is called. An example of an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic. For more information about Amazon SNS topics, see the Amazon SNS Developer Guide.

" - }, - "OrganizationArn":{ - "shape":"AmazonResourceName", - "documentation":"

The ARN of the Amazon WorkMail organization. An example of an Amazon WorkMail organization ARN is arn:aws:workmail:us-west-2:123456789012:organization/m-68755160c4cb4e29a2b2f8fb58f359d7. For information about Amazon WorkMail organizations, see the Amazon WorkMail Administrator Guide.

" - } - }, - "documentation":"

When included in a receipt rule, this action calls Amazon WorkMail and, optionally, publishes a notification to Amazon Simple Notification Service (Amazon SNS). You will typically not use this action directly because Amazon WorkMail adds the rule automatically during its setup procedure.

For information using a receipt rule to call Amazon WorkMail, see the Amazon SES Developer Guide.

" - } - }, - "documentation":"Amazon Simple Email Service

This document contains reference information for the Amazon Simple Email Service (Amazon SES) API, version 2010-12-01. This document is best used in conjunction with the Amazon SES Developer Guide.

For a list of Amazon SES endpoints to use in service requests, see Regions and Amazon SES in the Amazon SES Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/waiters-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/waiters-2.json deleted file mode 100644 index b585d309..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ses/2010-12-01/waiters-2.json +++ /dev/null @@ -1,18 +0,0 @@ -{ - "version": 2, - "waiters": { - "IdentityExists": { - "delay": 3, - "operation": "GetIdentityVerificationAttributes", - "maxAttempts": 20, - "acceptors": [ - { - "expected": "Success", - "matcher": "pathAll", - "state": "success", - "argument": "VerificationAttributes.*.VerificationStatus" - } - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/paginators-1.json deleted file mode 100644 index 022e0dca..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/paginators-1.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "pagination": { - "ListProtections": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Protections" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/service-2.json deleted file mode 100644 index 4d732920..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/shield/2016-06-02/service-2.json +++ /dev/null @@ -1,1149 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-06-02", - "endpointPrefix":"shield", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"AWS Shield", - "serviceFullName":"AWS Shield", - "serviceId":"Shield", - "signatureVersion":"v4", - "targetPrefix":"AWSShield_20160616", - "uid":"shield-2016-06-02" - }, - "operations":{ - "AssociateDRTLogBucket":{ - "name":"AssociateDRTLogBucket", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDRTLogBucketRequest"}, - "output":{"shape":"AssociateDRTLogBucketResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidOperationException"}, - {"shape":"NoAssociatedRoleException"}, - {"shape":"LimitsExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedForDependencyException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Authorizes the DDoS Response team (DRT) to access the specified Amazon S3 bucket containing your flow logs. You can associate up to 10 Amazon S3 buckets with your subscription.

To use the services of the DRT and make an AssociateDRTLogBucket request, you must be subscribed to the Business Support plan or the Enterprise Support plan.

" - }, - "AssociateDRTRole":{ - "name":"AssociateDRTRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDRTRoleRequest"}, - "output":{"shape":"AssociateDRTRoleResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidOperationException"}, - {"shape":"InvalidParameterException"}, - {"shape":"AccessDeniedForDependencyException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Authorizes the DDoS Response team (DRT), using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks. This enables the DRT to inspect your AWS WAF configuration and create or update AWS WAF rules and web ACLs.

You can associate only one RoleArn with your subscription. If you submit an AssociateDRTRole request for an account that already has an associated role, the new RoleArn will replace the existing RoleArn.

Prior to making the AssociateDRTRole request, you must attach the AWSShieldDRTAccessPolicy managed policy to the role you will specify in the request. For more information see Attaching and Detaching IAM Policies. The role must also trust the service principal drt.shield.amazonaws.com. For more information, see IAM JSON Policy Elements: Principal.

The DRT will have access only to your AWS WAF and Shield resources. By submitting this request, you authorize the DRT to inspect your AWS WAF and Shield configuration and create and update AWS WAF rules and web ACLs on your behalf. The DRT takes these actions only if explicitly authorized by you.

You must have the iam:PassRole permission to make an AssociateDRTRole request. For more information, see Granting a User Permissions to Pass a Role to an AWS Service.

To use the services of the DRT and make an AssociateDRTRole request, you must be subscribed to the Business Support plan or the Enterprise Support plan.

" - }, - "CreateProtection":{ - "name":"CreateProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateProtectionRequest"}, - "output":{"shape":"CreateProtectionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidResourceException"}, - {"shape":"InvalidOperationException"}, - {"shape":"LimitsExceededException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Enables AWS Shield Advanced for a specific AWS resource. The resource can be an Amazon CloudFront distribution, Elastic Load Balancing load balancer, Elastic IP Address, or an Amazon Route 53 hosted zone.

You can add protection to only a single resource with each CreateProtection request. If you want to add protection to multiple resources at once, use the AWS WAF console. For more information see Getting Started with AWS Shield Advanced and Add AWS Shield Advanced Protection to more AWS Resources.

" - }, - "CreateSubscription":{ - "name":"CreateSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSubscriptionRequest"}, - "output":{"shape":"CreateSubscriptionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceAlreadyExistsException"} - ], - "documentation":"

Activates AWS Shield Advanced for an account.

As part of this request you can specify EmergencySettings that automaticaly grant the DDoS response team (DRT) needed permissions to assist you during a suspected DDoS attack. For more information see Authorize the DDoS Response Team to Create Rules and Web ACLs on Your Behalf.

When you initally create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an UpdateSubscription request.

" - }, - "DeleteProtection":{ - "name":"DeleteProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteProtectionRequest"}, - "output":{"shape":"DeleteProtectionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"OptimisticLockException"} - ], - "documentation":"

Deletes an AWS Shield Advanced Protection.

" - }, - "DeleteSubscription":{ - "name":"DeleteSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSubscriptionRequest"}, - "output":{"shape":"DeleteSubscriptionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"LockedSubscriptionException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes AWS Shield Advanced from an account. AWS Shield Advanced requires a 1-year subscription commitment. You cannot delete a subscription prior to the completion of that commitment.

", - "deprecated":true - }, - "DescribeAttack":{ - "name":"DescribeAttack", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAttackRequest"}, - "output":{"shape":"DescribeAttackResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Describes the details of a DDoS attack.

" - }, - "DescribeDRTAccess":{ - "name":"DescribeDRTAccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDRTAccessRequest"}, - "output":{"shape":"DescribeDRTAccessResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Returns the current role and list of Amazon S3 log buckets used by the DDoS Response team (DRT) to access your AWS account while assisting with attack mitigation.

" - }, - "DescribeEmergencyContactSettings":{ - "name":"DescribeEmergencyContactSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEmergencyContactSettingsRequest"}, - "output":{"shape":"DescribeEmergencyContactSettingsResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the email addresses that the DRT can use to contact you during a suspected attack.

" - }, - "DescribeProtection":{ - "name":"DescribeProtection", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeProtectionRequest"}, - "output":{"shape":"DescribeProtectionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Lists the details of a Protection object.

" - }, - "DescribeSubscription":{ - "name":"DescribeSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSubscriptionRequest"}, - "output":{"shape":"DescribeSubscriptionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Provides details about the AWS Shield Advanced subscription for an account.

" - }, - "DisassociateDRTLogBucket":{ - "name":"DisassociateDRTLogBucket", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateDRTLogBucketRequest"}, - "output":{"shape":"DisassociateDRTLogBucketResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidOperationException"}, - {"shape":"NoAssociatedRoleException"}, - {"shape":"AccessDeniedForDependencyException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes the DDoS Response team's (DRT) access to the specified Amazon S3 bucket containing your flow logs.

To make a DisassociateDRTLogBucket request, you must be subscribed to the Business Support plan or the Enterprise Support plan. However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTLogBucket request to remove this access.

" - }, - "DisassociateDRTRole":{ - "name":"DisassociateDRTRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateDRTRoleRequest"}, - "output":{"shape":"DisassociateDRTRoleResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidOperationException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Removes the DDoS Response team's (DRT) access to your AWS account.

To make a DisassociateDRTRole request, you must be subscribed to the Business Support plan or the Enterprise Support plan. However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTRole request to remove this access.

" - }, - "GetSubscriptionState":{ - "name":"GetSubscriptionState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSubscriptionStateRequest"}, - "output":{"shape":"GetSubscriptionStateResponse"}, - "errors":[ - {"shape":"InternalErrorException"} - ], - "documentation":"

Returns the SubscriptionState, either Active or Inactive.

" - }, - "ListAttacks":{ - "name":"ListAttacks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAttacksRequest"}, - "output":{"shape":"ListAttacksResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidOperationException"} - ], - "documentation":"

Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period.

" - }, - "ListProtections":{ - "name":"ListProtections", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListProtectionsRequest"}, - "output":{"shape":"ListProtectionsResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidPaginationTokenException"} - ], - "documentation":"

Lists all Protection objects for the account.

" - }, - "UpdateEmergencyContactSettings":{ - "name":"UpdateEmergencyContactSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateEmergencyContactSettingsRequest"}, - "output":{"shape":"UpdateEmergencyContactSettingsResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OptimisticLockException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Updates the details of the list of email addresses that the DRT can use to contact you during a suspected attack.

" - }, - "UpdateSubscription":{ - "name":"UpdateSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSubscriptionRequest"}, - "output":{"shape":"UpdateSubscriptionResponse"}, - "errors":[ - {"shape":"InternalErrorException"}, - {"shape":"LockedSubscriptionException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OptimisticLockException"} - ], - "documentation":"

Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty parameters are not updated.

" - } - }, - "shapes":{ - "AccessDeniedForDependencyException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

In order to grant the necessary access to the DDoS Response Team, the user submitting AssociateDRTRole must have the iam:PassRole permission. This error indicates the user did not have the appropriate permissions. For more information, see Granting a User Permissions to Pass a Role to an AWS Service.

", - "exception":true - }, - "AssociateDRTLogBucketRequest":{ - "type":"structure", - "required":["LogBucket"], - "members":{ - "LogBucket":{ - "shape":"LogBucket", - "documentation":"

The Amazon S3 bucket that contains your flow logs.

" - } - } - }, - "AssociateDRTLogBucketResponse":{ - "type":"structure", - "members":{ - } - }, - "AssociateDRTRoleRequest":{ - "type":"structure", - "required":["RoleArn"], - "members":{ - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the role the DRT will use to access your AWS account.

Prior to making the AssociateDRTRole request, you must attach the AWSShieldDRTAccessPolicy managed policy to this role. For more information see Attaching and Detaching IAM Policies.

" - } - } - }, - "AssociateDRTRoleResponse":{ - "type":"structure", - "members":{ - } - }, - "AttackDetail":{ - "type":"structure", - "members":{ - "AttackId":{ - "shape":"AttackId", - "documentation":"

The unique identifier (ID) of the attack.

" - }, - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the resource that was attacked.

" - }, - "SubResources":{ - "shape":"SubResourceSummaryList", - "documentation":"

If applicable, additional detail about the resource being attacked, for example, IP address or URL.

" - }, - "StartTime":{ - "shape":"AttackTimestamp", - "documentation":"

The time the attack started, in Unix time in seconds. For more information see timestamp.

" - }, - "EndTime":{ - "shape":"AttackTimestamp", - "documentation":"

The time the attack ended, in Unix time in seconds. For more information see timestamp.

" - }, - "AttackCounters":{ - "shape":"SummarizedCounterList", - "documentation":"

List of counters that describe the attack for the specified time period.

" - }, - "AttackProperties":{ - "shape":"AttackProperties", - "documentation":"

The array of AttackProperty objects.

" - }, - "Mitigations":{ - "shape":"MitigationList", - "documentation":"

List of mitigation actions taken for the attack.

" - } - }, - "documentation":"

The details of a DDoS attack.

" - }, - "AttackId":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[a-zA-Z0-9\\\\-]*" - }, - "AttackLayer":{ - "type":"string", - "enum":[ - "NETWORK", - "APPLICATION" - ] - }, - "AttackProperties":{ - "type":"list", - "member":{"shape":"AttackProperty"} - }, - "AttackProperty":{ - "type":"structure", - "members":{ - "AttackLayer":{ - "shape":"AttackLayer", - "documentation":"

The type of DDoS event that was observed. NETWORK indicates layer 3 and layer 4 events and APPLICATION indicates layer 7 events.

" - }, - "AttackPropertyIdentifier":{ - "shape":"AttackPropertyIdentifier", - "documentation":"

Defines the DDoS attack property information that is provided.

" - }, - "TopContributors":{ - "shape":"TopContributors", - "documentation":"

The array of Contributor objects that includes the top five contributors to an attack.

" - }, - "Unit":{ - "shape":"Unit", - "documentation":"

The unit of the Value of the contributions.

" - }, - "Total":{ - "shape":"Long", - "documentation":"

The total contributions made to this attack by all contributors, not just the five listed in the TopContributors list.

" - } - }, - "documentation":"

Details of the described attack.

" - }, - "AttackPropertyIdentifier":{ - "type":"string", - "enum":[ - "DESTINATION_URL", - "REFERRER", - "SOURCE_ASN", - "SOURCE_COUNTRY", - "SOURCE_IP_ADDRESS", - "SOURCE_USER_AGENT" - ] - }, - "AttackSummaries":{ - "type":"list", - "member":{"shape":"AttackSummary"} - }, - "AttackSummary":{ - "type":"structure", - "members":{ - "AttackId":{ - "shape":"String", - "documentation":"

The unique identifier (ID) of the attack.

" - }, - "ResourceArn":{ - "shape":"String", - "documentation":"

The ARN (Amazon Resource Name) of the resource that was attacked.

" - }, - "StartTime":{ - "shape":"AttackTimestamp", - "documentation":"

The start time of the attack, in Unix time in seconds. For more information see timestamp.

" - }, - "EndTime":{ - "shape":"AttackTimestamp", - "documentation":"

The end time of the attack, in Unix time in seconds. For more information see timestamp.

" - }, - "AttackVectors":{ - "shape":"AttackVectorDescriptionList", - "documentation":"

The list of attacks for a specified time period.

" - } - }, - "documentation":"

Summarizes all DDoS attacks for a specified time period.

" - }, - "AttackTimestamp":{"type":"timestamp"}, - "AttackVectorDescription":{ - "type":"structure", - "required":["VectorType"], - "members":{ - "VectorType":{ - "shape":"String", - "documentation":"

The attack type. Valid values:

  • UDP_TRAFFIC

  • UDP_FRAGMENT

  • GENERIC_UDP_REFLECTION

  • DNS_REFLECTION

  • NTP_REFLECTION

  • CHARGEN_REFLECTION

  • SSDP_REFLECTION

  • PORT_MAPPER

  • RIP_REFLECTION

  • SNMP_REFLECTION

  • MSSQL_REFLECTION

  • NET_BIOS_REFLECTION

  • SYN_FLOOD

  • ACK_FLOOD

  • REQUEST_FLOOD

" - } - }, - "documentation":"

Describes the attack.

" - }, - "AttackVectorDescriptionList":{ - "type":"list", - "member":{"shape":"AttackVectorDescription"} - }, - "AutoRenew":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED" - ] - }, - "Contributor":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The name of the contributor. This is dependent on the AttackPropertyIdentifier. For example, if the AttackPropertyIdentifier is SOURCE_COUNTRY, the Name could be United States.

" - }, - "Value":{ - "shape":"Long", - "documentation":"

The contribution of this contributor expressed in Protection units. For example 10,000.

" - } - }, - "documentation":"

A contributor to the attack and their contribution.

" - }, - "CreateProtectionRequest":{ - "type":"structure", - "required":[ - "Name", - "ResourceArn" - ], - "members":{ - "Name":{ - "shape":"ProtectionName", - "documentation":"

Friendly name for the Protection you are creating.

" - }, - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the resource to be protected.

The ARN should be in one of the following formats:

  • For an Application Load Balancer: arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id

  • For an Elastic Load Balancer (Classic Load Balancer): arn:aws:elasticloadbalancing:region:account-id:loadbalancer/load-balancer-name

  • For AWS CloudFront distribution: arn:aws:cloudfront::account-id:distribution/distribution-id

  • For Amazon Route 53: arn:aws:route53::account-id:hostedzone/hosted-zone-id

  • For an Elastic IP address: arn:aws:ec2:region:account-id:eip-allocation/allocation-id

" - } - } - }, - "CreateProtectionResponse":{ - "type":"structure", - "members":{ - "ProtectionId":{ - "shape":"ProtectionId", - "documentation":"

The unique identifier (ID) for the Protection object that is created.

" - } - } - }, - "CreateSubscriptionRequest":{ - "type":"structure", - "members":{ - } - }, - "CreateSubscriptionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteProtectionRequest":{ - "type":"structure", - "required":["ProtectionId"], - "members":{ - "ProtectionId":{ - "shape":"ProtectionId", - "documentation":"

The unique identifier (ID) for the Protection object to be deleted.

" - } - } - }, - "DeleteProtectionResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteSubscriptionRequest":{ - "type":"structure", - "members":{ - }, - "deprecated":true - }, - "DeleteSubscriptionResponse":{ - "type":"structure", - "members":{ - }, - "deprecated":true - }, - "DescribeAttackRequest":{ - "type":"structure", - "required":["AttackId"], - "members":{ - "AttackId":{ - "shape":"AttackId", - "documentation":"

The unique identifier (ID) for the attack that to be described.

" - } - } - }, - "DescribeAttackResponse":{ - "type":"structure", - "members":{ - "Attack":{ - "shape":"AttackDetail", - "documentation":"

The attack that is described.

" - } - } - }, - "DescribeDRTAccessRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeDRTAccessResponse":{ - "type":"structure", - "members":{ - "RoleArn":{ - "shape":"RoleArn", - "documentation":"

The Amazon Resource Name (ARN) of the role the DRT used to access your AWS account.

" - }, - "LogBucketList":{ - "shape":"LogBucketList", - "documentation":"

The list of Amazon S3 buckets accessed by the DRT.

" - } - } - }, - "DescribeEmergencyContactSettingsRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeEmergencyContactSettingsResponse":{ - "type":"structure", - "members":{ - "EmergencyContactList":{ - "shape":"EmergencyContactList", - "documentation":"

A list of email addresses that the DRT can use to contact you during a suspected attack.

" - } - } - }, - "DescribeProtectionRequest":{ - "type":"structure", - "required":["ProtectionId"], - "members":{ - "ProtectionId":{ - "shape":"ProtectionId", - "documentation":"

The unique identifier (ID) for the Protection object that is described.

" - } - } - }, - "DescribeProtectionResponse":{ - "type":"structure", - "members":{ - "Protection":{ - "shape":"Protection", - "documentation":"

The Protection object that is described.

" - } - } - }, - "DescribeSubscriptionRequest":{ - "type":"structure", - "members":{ - } - }, - "DescribeSubscriptionResponse":{ - "type":"structure", - "members":{ - "Subscription":{ - "shape":"Subscription", - "documentation":"

The AWS Shield Advanced subscription details for an account.

" - } - } - }, - "DisassociateDRTLogBucketRequest":{ - "type":"structure", - "required":["LogBucket"], - "members":{ - "LogBucket":{ - "shape":"LogBucket", - "documentation":"

The Amazon S3 bucket that contains your flow logs.

" - } - } - }, - "DisassociateDRTLogBucketResponse":{ - "type":"structure", - "members":{ - } - }, - "DisassociateDRTRoleRequest":{ - "type":"structure", - "members":{ - } - }, - "DisassociateDRTRoleResponse":{ - "type":"structure", - "members":{ - } - }, - "Double":{"type":"double"}, - "DurationInSeconds":{ - "type":"long", - "min":0 - }, - "EmailAddress":{ - "type":"string", - "pattern":"^\\S+@\\S+\\.\\S+$" - }, - "EmergencyContact":{ - "type":"structure", - "required":["EmailAddress"], - "members":{ - "EmailAddress":{ - "shape":"EmailAddress", - "documentation":"

An email address that the DRT can use to contact you during a suspected attack.

" - } - }, - "documentation":"

Contact information that the DRT can use to contact you during a suspected attack.

" - }, - "EmergencyContactList":{ - "type":"list", - "member":{"shape":"EmergencyContact"}, - "max":10, - "min":0 - }, - "GetSubscriptionStateRequest":{ - "type":"structure", - "members":{ - } - }, - "GetSubscriptionStateResponse":{ - "type":"structure", - "required":["SubscriptionState"], - "members":{ - "SubscriptionState":{ - "shape":"SubscriptionState", - "documentation":"

The status of the subscription.

" - } - } - }, - "Integer":{"type":"integer"}, - "InternalErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that a problem occurred with the service infrastructure. You can retry the request.

", - "exception":true, - "fault":true - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that the operation would not cause any change to occur.

", - "exception":true - }, - "InvalidPaginationTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that the NextToken specified in the request is invalid. Submit the request using the NextToken value that was returned in the response.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that the parameters passed to the API are invalid.

", - "exception":true - }, - "InvalidResourceException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that the resource is invalid. You might not have access to the resource, or the resource might not exist.

", - "exception":true - }, - "Limit":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"String", - "documentation":"

The type of protection.

" - }, - "Max":{ - "shape":"Long", - "documentation":"

The maximum number of protections that can be created for the specified Type.

" - } - }, - "documentation":"

Specifies how many protections of a given type you can create.

" - }, - "LimitNumber":{"type":"long"}, - "LimitType":{"type":"string"}, - "Limits":{ - "type":"list", - "member":{"shape":"Limit"} - }, - "LimitsExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"}, - "Type":{"shape":"LimitType"}, - "Limit":{"shape":"LimitNumber"} - }, - "documentation":"

Exception that indicates that the operation would exceed a limit.

Type is the type of limit that would be exceeded.

Limit is the threshold that would be exceeded.

", - "exception":true - }, - "ListAttacksRequest":{ - "type":"structure", - "members":{ - "ResourceArns":{ - "shape":"ResourceArnFilterList", - "documentation":"

The ARN (Amazon Resource Name) of the resource that was attacked. If this is left blank, all applicable resources for this account will be included.

" - }, - "StartTime":{ - "shape":"TimeRange", - "documentation":"

The start of the time period for the attacks. This is a timestamp type. The sample request above indicates a number type because the default used by WAF is Unix time in seconds. However any valid timestamp format is allowed.

" - }, - "EndTime":{ - "shape":"TimeRange", - "documentation":"

The end of the time period for the attacks. This is a timestamp type. The sample request above indicates a number type because the default used by WAF is Unix time in seconds. However any valid timestamp format is allowed.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

The ListAttacksRequest.NextMarker value from a previous call to ListAttacksRequest. Pass null if this is the first call.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of AttackSummary objects to be returned. If this is left blank, the first 20 results will be returned.

" - } - } - }, - "ListAttacksResponse":{ - "type":"structure", - "members":{ - "AttackSummaries":{ - "shape":"AttackSummaries", - "documentation":"

The attack information for the specified time range.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

The token returned by a previous call to indicate that there is more data available. If not null, more results are available. Pass this value for the NextMarker parameter in a subsequent call to ListAttacks to retrieve the next set of items.

" - } - } - }, - "ListProtectionsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"Token", - "documentation":"

The ListProtectionsRequest.NextToken value from a previous call to ListProtections. Pass null if this is the first call.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of Protection objects to be returned. If this is left blank the first 20 results will be returned.

" - } - } - }, - "ListProtectionsResponse":{ - "type":"structure", - "members":{ - "Protections":{ - "shape":"Protections", - "documentation":"

The array of enabled Protection objects.

" - }, - "NextToken":{ - "shape":"Token", - "documentation":"

If you specify a value for MaxResults and you have more Protections than the value of MaxResults, AWS Shield Advanced returns a NextToken value in the response that allows you to list another group of Protections. For the second and subsequent ListProtections requests, specify the value of NextToken from the previous response to get information about another batch of Protections.

" - } - } - }, - "LockedSubscriptionException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

You are trying to update a subscription that has not yet completed the 1-year commitment. You can change the AutoRenew parameter during the last 30 days of your subscription. This exception indicates that you are attempting to change AutoRenew prior to that period.

", - "exception":true - }, - "LogBucket":{ - "type":"string", - "max":63, - "min":3, - "pattern":"^([a-z]|(\\d(?!\\d{0,2}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})))([a-z\\d]|(\\.(?!(\\.|-)))|(-(?!\\.))){1,61}[a-z\\d]$" - }, - "LogBucketList":{ - "type":"list", - "member":{"shape":"LogBucket"}, - "max":10, - "min":0 - }, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "box":true, - "max":10000, - "min":0 - }, - "Mitigation":{ - "type":"structure", - "members":{ - "MitigationName":{ - "shape":"String", - "documentation":"

The name of the mitigation taken for this attack.

" - } - }, - "documentation":"

The mitigation applied to a DDoS attack.

" - }, - "MitigationList":{ - "type":"list", - "member":{"shape":"Mitigation"} - }, - "NoAssociatedRoleException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The ARN of the role that you specifed does not exist.

", - "exception":true - }, - "OptimisticLockException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception that indicates that the protection state has been modified by another client. You can retry the request.

", - "exception":true - }, - "Protection":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ProtectionId", - "documentation":"

The unique identifier (ID) of the protection.

" - }, - "Name":{ - "shape":"ProtectionName", - "documentation":"

The friendly name of the protection. For example, My CloudFront distributions.

" - }, - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the AWS resource that is protected.

" - } - }, - "documentation":"

An object that represents a resource that is under DDoS protection.

" - }, - "ProtectionId":{ - "type":"string", - "max":36, - "min":1, - "pattern":"[a-zA-Z0-9\\\\-]*" - }, - "ProtectionName":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[ a-zA-Z0-9_\\\\.\\\\-]*" - }, - "Protections":{ - "type":"list", - "member":{"shape":"Protection"} - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception indicating the specified resource already exists.

", - "exception":true - }, - "ResourceArn":{ - "type":"string", - "min":1 - }, - "ResourceArnFilterList":{ - "type":"list", - "member":{"shape":"ResourceArn"} - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

Exception indicating the specified resource does not exist.

", - "exception":true - }, - "RoleArn":{ - "type":"string", - "max":96, - "pattern":"^arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - }, - "String":{"type":"string"}, - "SubResourceSummary":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"SubResourceType", - "documentation":"

The SubResource type.

" - }, - "Id":{ - "shape":"String", - "documentation":"

The unique identifier (ID) of the SubResource.

" - }, - "AttackVectors":{ - "shape":"SummarizedAttackVectorList", - "documentation":"

The list of attack types and associated counters.

" - }, - "Counters":{ - "shape":"SummarizedCounterList", - "documentation":"

The counters that describe the details of the attack.

" - } - }, - "documentation":"

The attack information for the specified SubResource.

" - }, - "SubResourceSummaryList":{ - "type":"list", - "member":{"shape":"SubResourceSummary"} - }, - "SubResourceType":{ - "type":"string", - "enum":[ - "IP", - "URL" - ] - }, - "Subscription":{ - "type":"structure", - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start time of the subscription, in Unix time in seconds. For more information see timestamp.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The date and time your subscription will end.

" - }, - "TimeCommitmentInSeconds":{ - "shape":"DurationInSeconds", - "documentation":"

The length, in seconds, of the AWS Shield Advanced subscription for the account.

" - }, - "AutoRenew":{ - "shape":"AutoRenew", - "documentation":"

If ENABLED, the subscription will be automatically renewed at the end of the existing subscription period.

When you initally create a subscription, AutoRenew is set to ENABLED. You can change this by submitting an UpdateSubscription request. If the UpdateSubscription request does not included a value for AutoRenew, the existing value for AutoRenew remains unchanged.

" - }, - "Limits":{ - "shape":"Limits", - "documentation":"

Specifies how many protections of a given type you can create.

" - } - }, - "documentation":"

Information about the AWS Shield Advanced subscription for an account.

" - }, - "SubscriptionState":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE" - ] - }, - "SummarizedAttackVector":{ - "type":"structure", - "required":["VectorType"], - "members":{ - "VectorType":{ - "shape":"String", - "documentation":"

The attack type, for example, SNMP reflection or SYN flood.

" - }, - "VectorCounters":{ - "shape":"SummarizedCounterList", - "documentation":"

The list of counters that describe the details of the attack.

" - } - }, - "documentation":"

A summary of information about the attack.

" - }, - "SummarizedAttackVectorList":{ - "type":"list", - "member":{"shape":"SummarizedAttackVector"} - }, - "SummarizedCounter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The counter name.

" - }, - "Max":{ - "shape":"Double", - "documentation":"

The maximum value of the counter for a specified time period.

" - }, - "Average":{ - "shape":"Double", - "documentation":"

The average value of the counter for a specified time period.

" - }, - "Sum":{ - "shape":"Double", - "documentation":"

The total of counter values for a specified time period.

" - }, - "N":{ - "shape":"Integer", - "documentation":"

The number of counters for a specified time period.

" - }, - "Unit":{ - "shape":"String", - "documentation":"

The unit of the counters.

" - } - }, - "documentation":"

The counter that describes a DDoS attack.

" - }, - "SummarizedCounterList":{ - "type":"list", - "member":{"shape":"SummarizedCounter"} - }, - "TimeRange":{ - "type":"structure", - "members":{ - "FromInclusive":{ - "shape":"AttackTimestamp", - "documentation":"

The start time, in Unix time in seconds. For more information see timestamp.

" - }, - "ToExclusive":{ - "shape":"AttackTimestamp", - "documentation":"

The end time, in Unix time in seconds. For more information see timestamp.

" - } - }, - "documentation":"

The time range.

" - }, - "Timestamp":{"type":"timestamp"}, - "Token":{ - "type":"string", - "min":1 - }, - "TopContributors":{ - "type":"list", - "member":{"shape":"Contributor"} - }, - "Unit":{ - "type":"string", - "enum":[ - "BITS", - "BYTES", - "PACKETS", - "REQUESTS" - ] - }, - "UpdateEmergencyContactSettingsRequest":{ - "type":"structure", - "members":{ - "EmergencyContactList":{ - "shape":"EmergencyContactList", - "documentation":"

A list of email addresses that the DRT can use to contact you during a suspected attack.

" - } - } - }, - "UpdateEmergencyContactSettingsResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateSubscriptionRequest":{ - "type":"structure", - "members":{ - "AutoRenew":{ - "shape":"AutoRenew", - "documentation":"

When you initally create a subscription, AutoRenew is set to ENABLED. If ENABLED, the subscription will be automatically renewed at the end of the existing subscription period. You can change this by submitting an UpdateSubscription request. If the UpdateSubscription request does not included a value for AutoRenew, the existing value for AutoRenew remains unchanged.

" - } - } - }, - "UpdateSubscriptionResponse":{ - "type":"structure", - "members":{ - } - }, - "errorMessage":{"type":"string"} - }, - "documentation":"AWS Shield Advanced

This is the AWS Shield Advanced API Reference. This guide is for developers who need detailed information about the AWS Shield Advanced API actions, data types, and errors. For detailed information about AWS WAF and AWS Shield Advanced features and an overview of how to use the AWS WAF and AWS Shield Advanced APIs, see the AWS WAF and AWS Shield Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/paginators-1.json deleted file mode 100644 index 6e184415..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "GetReplicationJobs": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "replicationJobList" - }, - "GetReplicationRuns": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "replicationRunList" - }, - "GetConnectors": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "connectorList" - }, - "GetServers": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "serverList" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/service-2.json deleted file mode 100644 index 5de6fb15..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sms/2016-10-24/service-2.json +++ /dev/null @@ -1,724 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"sms-2016-10-24", - "apiVersion":"2016-10-24", - "endpointPrefix":"sms", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"SMS", - "serviceFullName":"AWS Server Migration Service", - "serviceId":"SMS", - "signatureVersion":"v4", - "targetPrefix":"AWSServerMigrationService_V2016_10_24" - }, - "operations":{ - "CreateReplicationJob":{ - "name":"CreateReplicationJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateReplicationJobRequest"}, - "output":{"shape":"CreateReplicationJobResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ServerCannotBeReplicatedException"}, - {"shape":"ReplicationJobAlreadyExistsException"}, - {"shape":"NoConnectorsAvailableException"}, - {"shape":"InternalError"} - ], - "documentation":"The CreateReplicationJob API is used to create a ReplicationJob to replicate a server on AWS. Call this API to first create a ReplicationJob, which will then schedule periodic ReplicationRuns to replicate your server to AWS. Each ReplicationRun will result in the creation of an AWS AMI." - }, - "DeleteReplicationJob":{ - "name":"DeleteReplicationJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteReplicationJobRequest"}, - "output":{"shape":"DeleteReplicationJobResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ReplicationJobNotFoundException"} - ], - "documentation":"The DeleteReplicationJob API is used to delete a ReplicationJob, resulting in no further ReplicationRuns. This will delete the contents of the S3 bucket used to store SMS artifacts, but will not delete any AMIs created by the SMS service." - }, - "DeleteServerCatalog":{ - "name":"DeleteServerCatalog", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteServerCatalogRequest"}, - "output":{"shape":"DeleteServerCatalogResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"} - ], - "documentation":"The DeleteServerCatalog API clears all servers from your server catalog. This means that these servers will no longer be accessible to the Server Migration Service." - }, - "DisassociateConnector":{ - "name":"DisassociateConnector", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateConnectorRequest"}, - "output":{"shape":"DisassociateConnectorResponse"}, - "errors":[ - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"The DisassociateConnector API will disassociate a connector from the Server Migration Service, rendering it unavailable to support replication jobs." - }, - "GetConnectors":{ - "name":"GetConnectors", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetConnectorsRequest"}, - "output":{"shape":"GetConnectorsResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"} - ], - "documentation":"The GetConnectors API returns a list of connectors that are registered with the Server Migration Service." - }, - "GetReplicationJobs":{ - "name":"GetReplicationJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReplicationJobsRequest"}, - "output":{"shape":"GetReplicationJobsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"} - ], - "documentation":"The GetReplicationJobs API will return all of your ReplicationJobs and their details. This API returns a paginated list, that may be consecutively called with nextToken to retrieve all ReplicationJobs." - }, - "GetReplicationRuns":{ - "name":"GetReplicationRuns", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetReplicationRunsRequest"}, - "output":{"shape":"GetReplicationRunsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"} - ], - "documentation":"The GetReplicationRuns API will return all ReplicationRuns for a given ReplicationJob. This API returns a paginated list, that may be consecutively called with nextToken to retrieve all ReplicationRuns for a ReplicationJob." - }, - "GetServers":{ - "name":"GetServers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetServersRequest"}, - "output":{"shape":"GetServersResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"} - ], - "documentation":"The GetServers API returns a list of all servers in your server catalog. For this call to succeed, you must previously have called ImportServerCatalog." - }, - "ImportServerCatalog":{ - "name":"ImportServerCatalog", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ImportServerCatalogRequest"}, - "output":{"shape":"ImportServerCatalogResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"NoConnectorsAvailableException"} - ], - "documentation":"The ImportServerCatalog API is used to gather the complete list of on-premises servers on your premises. This API call requires connectors to be installed and monitoring all servers you would like imported. This API call returns immediately, but may take some time to retrieve all of the servers." - }, - "StartOnDemandReplicationRun":{ - "name":"StartOnDemandReplicationRun", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartOnDemandReplicationRunRequest"}, - "output":{"shape":"StartOnDemandReplicationRunResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"ReplicationRunLimitExceededException"} - ], - "documentation":"The StartOnDemandReplicationRun API is used to start a ReplicationRun on demand (in addition to those that are scheduled based on your frequency). This ReplicationRun will start immediately. StartOnDemandReplicationRun is subject to limits on how many on demand ReplicationRuns you may call per 24-hour period." - }, - "UpdateReplicationJob":{ - "name":"UpdateReplicationJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateReplicationJobRequest"}, - "output":{"shape":"UpdateReplicationJobResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"MissingRequiredParameterException"}, - {"shape":"OperationNotPermittedException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"ServerCannotBeReplicatedException"}, - {"shape":"ReplicationJobNotFoundException"}, - {"shape":"InternalError"} - ], - "documentation":"The UpdateReplicationJob API is used to change the settings of your existing ReplicationJob created using CreateReplicationJob. Calling this API will affect the next scheduled ReplicationRun." - } - }, - "shapes":{ - "AmiId":{ - "type":"string", - "documentation":"The AMI id for the image resulting from a Replication Run." - }, - "Connector":{ - "type":"structure", - "members":{ - "connectorId":{"shape":"ConnectorId"}, - "version":{"shape":"ConnectorVersion"}, - "status":{"shape":"ConnectorStatus"}, - "capabilityList":{"shape":"ConnectorCapabilityList"}, - "vmManagerName":{"shape":"VmManagerName"}, - "vmManagerType":{"shape":"VmManagerType"}, - "vmManagerId":{"shape":"VmManagerId"}, - "ipAddress":{"shape":"IpAddress"}, - "macAddress":{"shape":"MacAddress"}, - "associatedOn":{"shape":"Timestamp"} - }, - "documentation":"Object representing a Connector" - }, - "ConnectorCapability":{ - "type":"string", - "documentation":"Capabilities for a Connector", - "enum":["VSPHERE"] - }, - "ConnectorCapabilityList":{ - "type":"list", - "member":{ - "shape":"ConnectorCapability", - "locationName":"item" - }, - "documentation":"List of Connector Capabilities" - }, - "ConnectorId":{ - "type":"string", - "documentation":"Unique Identifier for Connector" - }, - "ConnectorList":{ - "type":"list", - "member":{ - "shape":"Connector", - "locationName":"item" - }, - "documentation":"List of connectors" - }, - "ConnectorStatus":{ - "type":"string", - "documentation":"Status of on-premise Connector", - "enum":[ - "HEALTHY", - "UNHEALTHY" - ] - }, - "ConnectorVersion":{ - "type":"string", - "documentation":"Connector version string" - }, - "CreateReplicationJobRequest":{ - "type":"structure", - "required":[ - "serverId", - "seedReplicationTime", - "frequency" - ], - "members":{ - "serverId":{"shape":"ServerId"}, - "seedReplicationTime":{"shape":"Timestamp"}, - "frequency":{"shape":"Frequency"}, - "licenseType":{"shape":"LicenseType"}, - "roleName":{"shape":"RoleName"}, - "description":{"shape":"Description"} - } - }, - "CreateReplicationJobResponse":{ - "type":"structure", - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"} - } - }, - "DeleteReplicationJobRequest":{ - "type":"structure", - "required":["replicationJobId"], - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"} - } - }, - "DeleteReplicationJobResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteServerCatalogRequest":{ - "type":"structure", - "members":{ - } - }, - "DeleteServerCatalogResponse":{ - "type":"structure", - "members":{ - } - }, - "Description":{ - "type":"string", - "documentation":"The description for a Replication Job/Run." - }, - "DisassociateConnectorRequest":{ - "type":"structure", - "required":["connectorId"], - "members":{ - "connectorId":{"shape":"ConnectorId"} - } - }, - "DisassociateConnectorResponse":{ - "type":"structure", - "members":{ - } - }, - "ErrorMessage":{ - "type":"string", - "documentation":"Error Message string" - }, - "Frequency":{ - "type":"integer", - "documentation":"Interval between Replication Runs. This value is specified in hours, and represents the time between consecutive Replication Runs." - }, - "GetConnectorsRequest":{ - "type":"structure", - "members":{ - "nextToken":{"shape":"NextToken"}, - "maxResults":{"shape":"MaxResults"} - } - }, - "GetConnectorsResponse":{ - "type":"structure", - "members":{ - "connectorList":{"shape":"ConnectorList"}, - "nextToken":{"shape":"NextToken"} - } - }, - "GetReplicationJobsRequest":{ - "type":"structure", - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"}, - "nextToken":{"shape":"NextToken"}, - "maxResults":{"shape":"MaxResults"} - } - }, - "GetReplicationJobsResponse":{ - "type":"structure", - "members":{ - "replicationJobList":{"shape":"ReplicationJobList"}, - "nextToken":{"shape":"NextToken"} - } - }, - "GetReplicationRunsRequest":{ - "type":"structure", - "required":["replicationJobId"], - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"}, - "nextToken":{"shape":"NextToken"}, - "maxResults":{"shape":"MaxResults"} - } - }, - "GetReplicationRunsResponse":{ - "type":"structure", - "members":{ - "replicationJob":{"shape":"ReplicationJob"}, - "replicationRunList":{"shape":"ReplicationRunList"}, - "nextToken":{"shape":"NextToken"} - } - }, - "GetServersRequest":{ - "type":"structure", - "members":{ - "nextToken":{"shape":"NextToken"}, - "maxResults":{"shape":"MaxResults"} - } - }, - "GetServersResponse":{ - "type":"structure", - "members":{ - "lastModifiedOn":{"shape":"Timestamp"}, - "serverCatalogStatus":{"shape":"ServerCatalogStatus"}, - "serverList":{"shape":"ServerList"}, - "nextToken":{"shape":"NextToken"} - } - }, - "ImportServerCatalogRequest":{ - "type":"structure", - "members":{ - } - }, - "ImportServerCatalogResponse":{ - "type":"structure", - "members":{ - } - }, - "InternalError":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"An internal error has occured.", - "exception":true, - "fault":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"A parameter specified in the request is not valid, is unsupported, or cannot be used.", - "exception":true - }, - "IpAddress":{ - "type":"string", - "documentation":"Internet Protocol (IP) Address" - }, - "LicenseType":{ - "type":"string", - "documentation":"The license type to be used for the Amazon Machine Image (AMI) created after a successful ReplicationRun.", - "enum":[ - "AWS", - "BYOL" - ] - }, - "MacAddress":{ - "type":"string", - "documentation":"Hardware (MAC) address" - }, - "MaxResults":{ - "type":"integer", - "documentation":"The maximum number of results to return in one API call. If left empty, this will default to 50." - }, - "MissingRequiredParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.", - "exception":true - }, - "NextToken":{ - "type":"string", - "documentation":"Pagination token to pass as input to API call" - }, - "NoConnectorsAvailableException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"No connectors are available to handle this request. Please associate connector(s) and verify any existing connectors are healthy and can respond to requests.", - "exception":true - }, - "OperationNotPermittedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.", - "exception":true - }, - "ReplicationJob":{ - "type":"structure", - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"}, - "serverId":{"shape":"ServerId"}, - "serverType":{"shape":"ServerType"}, - "vmServer":{"shape":"VmServer"}, - "seedReplicationTime":{"shape":"Timestamp"}, - "frequency":{"shape":"Frequency"}, - "nextReplicationRunStartTime":{"shape":"Timestamp"}, - "licenseType":{"shape":"LicenseType"}, - "roleName":{"shape":"RoleName"}, - "latestAmiId":{"shape":"AmiId"}, - "state":{"shape":"ReplicationJobState"}, - "statusMessage":{"shape":"ReplicationJobStatusMessage"}, - "description":{"shape":"Description"}, - "replicationRunList":{"shape":"ReplicationRunList"} - }, - "documentation":"Object representing a Replication Job" - }, - "ReplicationJobAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"An active Replication Job already exists for the specified server.", - "exception":true - }, - "ReplicationJobId":{ - "type":"string", - "documentation":"The unique identifier for a Replication Job." - }, - "ReplicationJobList":{ - "type":"list", - "member":{ - "shape":"ReplicationJob", - "locationName":"item" - }, - "documentation":"List of Replication Jobs" - }, - "ReplicationJobNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"The specified Replication Job cannot be found.", - "exception":true - }, - "ReplicationJobState":{ - "type":"string", - "documentation":"Current state of Replication Job", - "enum":[ - "PENDING", - "ACTIVE", - "FAILED", - "DELETING", - "DELETED" - ] - }, - "ReplicationJobStatusMessage":{ - "type":"string", - "documentation":"String describing current status of Replication Job" - }, - "ReplicationJobTerminated":{ - "type":"boolean", - "documentation":"An indicator of the Replication Job being deleted or failed." - }, - "ReplicationRun":{ - "type":"structure", - "members":{ - "replicationRunId":{"shape":"ReplicationRunId"}, - "state":{"shape":"ReplicationRunState"}, - "type":{"shape":"ReplicationRunType"}, - "statusMessage":{"shape":"ReplicationRunStatusMessage"}, - "amiId":{"shape":"AmiId"}, - "scheduledStartTime":{"shape":"Timestamp"}, - "completedTime":{"shape":"Timestamp"}, - "description":{"shape":"Description"} - }, - "documentation":"Object representing a Replication Run" - }, - "ReplicationRunId":{ - "type":"string", - "documentation":"The unique identifier for a Replication Run." - }, - "ReplicationRunLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"This user has exceeded the maximum allowed Replication Run limit.", - "exception":true - }, - "ReplicationRunList":{ - "type":"list", - "member":{ - "shape":"ReplicationRun", - "locationName":"item" - }, - "documentation":"List of Replication Runs" - }, - "ReplicationRunState":{ - "type":"string", - "documentation":"Current state of Replication Run", - "enum":[ - "PENDING", - "MISSED", - "ACTIVE", - "FAILED", - "COMPLETED", - "DELETING", - "DELETED" - ] - }, - "ReplicationRunStatusMessage":{ - "type":"string", - "documentation":"String describing current status of Replication Run" - }, - "ReplicationRunType":{ - "type":"string", - "documentation":"Type of Replication Run", - "enum":[ - "ON_DEMAND", - "AUTOMATIC" - ] - }, - "RoleName":{ - "type":"string", - "documentation":"Name of service role in customer's account to be used by SMS service." - }, - "Server":{ - "type":"structure", - "members":{ - "serverId":{"shape":"ServerId"}, - "serverType":{"shape":"ServerType"}, - "vmServer":{"shape":"VmServer"}, - "replicationJobId":{"shape":"ReplicationJobId"}, - "replicationJobTerminated":{"shape":"ReplicationJobTerminated"} - }, - "documentation":"Object representing a server" - }, - "ServerCannotBeReplicatedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"The provided server cannot be replicated.", - "exception":true - }, - "ServerCatalogStatus":{ - "type":"string", - "documentation":"Status of Server catalog", - "enum":[ - "NOT_IMPORTED", - "IMPORTING", - "AVAILABLE", - "DELETED", - "EXPIRED" - ] - }, - "ServerId":{ - "type":"string", - "documentation":"Unique Identifier for a server" - }, - "ServerList":{ - "type":"list", - "member":{ - "shape":"Server", - "locationName":"item" - }, - "documentation":"List of servers from catalog" - }, - "ServerType":{ - "type":"string", - "documentation":"Type of server.", - "enum":["VIRTUAL_MACHINE"] - }, - "StartOnDemandReplicationRunRequest":{ - "type":"structure", - "required":["replicationJobId"], - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"}, - "description":{"shape":"Description"} - } - }, - "StartOnDemandReplicationRunResponse":{ - "type":"structure", - "members":{ - "replicationRunId":{"shape":"ReplicationRunId"} - } - }, - "Timestamp":{ - "type":"timestamp", - "documentation":"Timestamp of an operation" - }, - "UnauthorizedOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"This user does not have permissions to perform this operation.", - "exception":true - }, - "UpdateReplicationJobRequest":{ - "type":"structure", - "required":["replicationJobId"], - "members":{ - "replicationJobId":{"shape":"ReplicationJobId"}, - "frequency":{"shape":"Frequency"}, - "nextReplicationRunStartTime":{"shape":"Timestamp"}, - "licenseType":{"shape":"LicenseType"}, - "roleName":{"shape":"RoleName"}, - "description":{"shape":"Description"} - } - }, - "UpdateReplicationJobResponse":{ - "type":"structure", - "members":{ - } - }, - "VmId":{ - "type":"string", - "documentation":"Unique Identifier for a VM" - }, - "VmManagerId":{ - "type":"string", - "documentation":"Unique Identifier for VM Manager" - }, - "VmManagerName":{ - "type":"string", - "documentation":"VM Manager Name" - }, - "VmManagerType":{ - "type":"string", - "documentation":"VM Management Product", - "enum":["VSPHERE"] - }, - "VmName":{ - "type":"string", - "documentation":"Name of Virtual Machine" - }, - "VmPath":{ - "type":"string", - "documentation":"Path to VM" - }, - "VmServer":{ - "type":"structure", - "members":{ - "vmServerAddress":{"shape":"VmServerAddress"}, - "vmName":{"shape":"VmName"}, - "vmManagerName":{"shape":"VmManagerName"}, - "vmManagerType":{"shape":"VmManagerType"}, - "vmPath":{"shape":"VmPath"} - }, - "documentation":"Object representing a VM server" - }, - "VmServerAddress":{ - "type":"structure", - "members":{ - "vmManagerId":{"shape":"VmManagerId"}, - "vmId":{"shape":"VmId"} - }, - "documentation":"Object representing a server's location" - } - }, - "documentation":"Amazon Server Migration Service automates the process of migrating servers to EC2." -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/examples-1.json deleted file mode 100644 index 9d699718..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/examples-1.json +++ /dev/null @@ -1,442 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CancelCluster": [ - { - "input": { - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000" - }, - "comments": { - }, - "description": "This operation cancels a cluster job. You can only cancel a cluster job while it's in the AwaitingQuorum status.", - "id": "to-cancel-a-cluster-job-1482533760554", - "title": "To cancel a cluster job" - } - ], - "CancelJob": [ - { - "input": { - "JobId": "JID123e4567-e89b-12d3-a456-426655440000" - }, - "comments": { - }, - "description": "This operation cancels a job. You can only cancel a job before its JobState value changes to PreparingAppliance.", - "id": "to-cancel-a-job-for-a-snowball-device-1482534699477", - "title": "To cancel a job for a Snowball device" - } - ], - "CreateAddress": [ - { - "input": { - "Address": { - "City": "Seattle", - "Company": "My Company's Name", - "Country": "USA", - "Name": "My Name", - "PhoneNumber": "425-555-5555", - "PostalCode": "98101", - "StateOrProvince": "WA", - "Street1": "123 Main Street" - } - }, - "output": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b" - }, - "comments": { - }, - "description": "This operation creates an address for a job. Addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. If the address is invalid or unsupported, then an exception is thrown.", - "id": "to-create-an-address-for-a-job-1482535416294", - "title": "To create an address for a job" - } - ], - "CreateCluster": [ - { - "input": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "Description": "MyCluster", - "JobType": "LOCAL_USE", - "KmsKeyARN": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-12ab-34cd-56ef-123456123456", - "Notification": { - "JobStatesToNotify": [ - - ], - "NotifyAll": false - }, - "Resources": { - "S3Resources": [ - { - "BucketArn": "arn:aws:s3:::MyBucket", - "KeyRange": { - } - } - ] - }, - "RoleARN": "arn:aws:iam::123456789012:role/snowball-import-S3-role", - "ShippingOption": "SECOND_DAY", - "SnowballType": "EDGE" - }, - "output": { - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000" - }, - "comments": { - }, - "description": "Creates an empty cluster. Each cluster supports five nodes. You use the CreateJob action separately to create the jobs for each of these nodes. The cluster does not ship until these five node jobs have been created.", - "id": "to-create-a-cluster-1482864724077", - "title": "To create a cluster" - } - ], - "CreateJob": [ - { - "input": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "Description": "My Job", - "JobType": "IMPORT", - "KmsKeyARN": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-12ab-34cd-56ef-123456123456", - "Notification": { - "JobStatesToNotify": [ - - ], - "NotifyAll": false - }, - "Resources": { - "S3Resources": [ - { - "BucketArn": "arn:aws:s3:::MyBucket", - "KeyRange": { - } - } - ] - }, - "RoleARN": "arn:aws:iam::123456789012:role/snowball-import-S3-role", - "ShippingOption": "SECOND_DAY", - "SnowballCapacityPreference": "T80", - "SnowballType": "STANDARD" - }, - "output": { - "JobId": "JID123e4567-e89b-12d3-a456-426655440000" - }, - "comments": { - }, - "description": "Creates a job to import or export data between Amazon S3 and your on-premises data center. Your AWS account must have the right trust policies and permissions in place to create a job for Snowball. If you're creating a job for a node in a cluster, you only need to provide the clusterId value; the other job attributes are inherited from the cluster.", - "id": "to-create-a-job-1482864834886", - "title": "To create a job" - } - ], - "DescribeAddress": [ - { - "input": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b" - }, - "output": { - "Address": { - "AddressId": "ADID5643ec50-3eec-4eb3-9be6-9374c10eb51b", - "City": "Seattle", - "Company": "My Company", - "Country": "US", - "Name": "My Name", - "PhoneNumber": "425-555-5555", - "PostalCode": "98101", - "StateOrProvince": "WA", - "Street1": "123 Main Street" - } - }, - "comments": { - }, - "description": "This operation describes an address for a job.", - "id": "to-describe-an-address-for-a-job-1482538608745", - "title": "To describe an address for a job" - } - ], - "DescribeAddresses": [ - { - "input": { - }, - "output": { - "Addresses": [ - { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "City": "Seattle", - "Company": "My Company", - "Country": "US", - "Name": "My Name", - "PhoneNumber": "425-555-5555", - "PostalCode": "98101", - "StateOrProvince": "WA", - "Street1": "123 Main Street" - } - ] - }, - "comments": { - }, - "description": "This operation describes all the addresses that you've created for AWS Snowball. Calling this API in one of the US regions will return addresses from the list of all addresses associated with this account in all US regions.", - "id": "to-describe-all-the-addresses-youve-created-for-aws-snowball-1482538936603", - "title": "To describe all the addresses you've created for AWS Snowball" - } - ], - "DescribeCluster": [ - { - "input": { - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000" - }, - "output": { - "ClusterMetadata": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000", - "ClusterState": "Pending", - "CreationDate": "1480475517.0", - "Description": "MyCluster", - "JobType": "LOCAL_USE", - "KmsKeyARN": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-12ab-34cd-56ef-123456123456", - "Notification": { - "JobStatesToNotify": [ - - ], - "NotifyAll": false - }, - "Resources": { - "S3Resources": [ - { - "BucketArn": "arn:aws:s3:::MyBucket", - "KeyRange": { - } - } - ] - }, - "RoleARN": "arn:aws:iam::123456789012:role/snowball-import-S3-role", - "ShippingOption": "SECOND_DAY" - } - }, - "comments": { - }, - "description": "Returns information about a specific cluster including shipping information, cluster status, and other important metadata.", - "id": "to-describe-a-cluster-1482864218396", - "title": "To describe a cluster" - } - ], - "DescribeJob": [ - { - "input": { - "JobId": "JID123e4567-e89b-12d3-a456-426655440000" - }, - "output": { - "JobMetadata": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "CreationDate": "1475626164", - "Description": "My Job", - "JobId": "JID123e4567-e89b-12d3-a456-426655440000", - "JobState": "New", - "JobType": "IMPORT", - "KmsKeyARN": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-12ab-34cd-56ef-123456123456", - "Notification": { - "JobStatesToNotify": [ - - ], - "NotifyAll": false - }, - "Resources": { - "S3Resources": [ - { - "BucketArn": "arn:aws:s3:::MyBucket", - "KeyRange": { - } - } - ] - }, - "RoleARN": "arn:aws:iam::123456789012:role/snowball-import-S3-role", - "ShippingDetails": { - "ShippingOption": "SECOND_DAY" - }, - "SnowballCapacityPreference": "T80", - "SnowballType": "STANDARD" - } - }, - "comments": { - }, - "description": "This operation describes a job you've created for AWS Snowball.", - "id": "to-describe-a-job-youve-created-for-aws-snowball-1482539500180", - "title": "To describe a job you've created for AWS Snowball" - } - ], - "GetJobManifest": [ - { - "input": { - "JobId": "JID123e4567-e89b-12d3-a456-426655440000" - }, - "output": { - "ManifestURI": "https://awsie-frosty-manifests-prod.s3.amazonaws.com/JID123e4567-e89b-12d3-a456-426655440000_manifest.bin?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20161224T005115Z&X-Amz-SignedHeaders=..." - }, - "comments": { - }, - "description": "Returns a link to an Amazon S3 presigned URL for the manifest file associated with the specified JobId value. You can access the manifest file for up to 60 minutes after this request has been made. To access the manifest file after 60 minutes have passed, you'll have to make another call to the GetJobManifest action.\n\nThe manifest is an encrypted file that you can download after your job enters the WithCustomer status. The manifest is decrypted by using the UnlockCode code value, when you pass both values to the Snowball through the Snowball client when the client is started for the first time.\n\nAs a best practice, we recommend that you don't save a copy of an UnlockCode value in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.\n\nThe credentials of a given job, including its manifest file and unlock code, expire 90 days after the job is created.", - "id": "to-get-the-manifest-for-a-job-youve-created-for-aws-snowball-1482540389246", - "title": "To get the manifest for a job you've created for AWS Snowball" - } - ], - "GetJobUnlockCode": [ - { - "input": { - "JobId": "JID123e4567-e89b-12d3-a456-426655440000" - }, - "output": { - "UnlockCode": "12345-abcde-56789-fghij-01234" - }, - "comments": { - }, - "description": "Returns the UnlockCode code value for the specified job. A particular UnlockCode value can be accessed for up to 90 days after the associated job has been created.\n\nThe UnlockCode value is a 29-character code with 25 alphanumeric characters and 4 hyphens. This code is used to decrypt the manifest file when it is passed along with the manifest to the Snowball through the Snowball client when the client is started for the first time.\n\nAs a best practice, we recommend that you don't save a copy of the UnlockCode in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.", - "id": "to-get-the-unlock-code-for-a-job-youve-created-for-aws-snowball-1482541987286", - "title": "To get the unlock code for a job you've created for AWS Snowball" - } - ], - "GetSnowballUsage": [ - { - "input": { - }, - "output": { - "SnowballLimit": 1, - "SnowballsInUse": 0 - }, - "comments": { - }, - "description": "Returns information about the Snowball service limit for your account, and also the number of Snowballs your account has in use.\n\nThe default service limit for the number of Snowballs that you can have at one time is 1. If you want to increase your service limit, contact AWS Support.", - "id": "to-see-your-snowball-service-limit-and-the-number-of-snowballs-you-have-in-use-1482863394588", - "title": "To see your Snowball service limit and the number of Snowballs you have in use" - } - ], - "ListClusterJobs": [ - { - "input": { - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000" - }, - "output": { - "JobListEntries": [ - { - "CreationDate": "1480475524.0", - "Description": "MyClustrer-node-001", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440000", - "JobState": "New", - "JobType": "LOCAL_USE", - "SnowballType": "EDGE" - }, - { - "CreationDate": "1480475525.0", - "Description": "MyClustrer-node-002", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440001", - "JobState": "New", - "JobType": "LOCAL_USE", - "SnowballType": "EDGE" - }, - { - "CreationDate": "1480475525.0", - "Description": "MyClustrer-node-003", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440002", - "JobState": "New", - "JobType": "LOCAL_USE", - "SnowballType": "EDGE" - }, - { - "CreationDate": "1480475525.0", - "Description": "MyClustrer-node-004", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440003", - "JobState": "New", - "JobType": "LOCAL_USE", - "SnowballType": "EDGE" - }, - { - "CreationDate": "1480475525.0", - "Description": "MyClustrer-node-005", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440004", - "JobState": "New", - "JobType": "LOCAL_USE", - "SnowballType": "EDGE" - } - ] - }, - "comments": { - }, - "description": "Returns an array of JobListEntry objects of the specified length. Each JobListEntry object is for a job in the specified cluster and contains a job's state, a job's ID, and other information.", - "id": "to-get-a-list-of-jobs-in-a-cluster-that-youve-created-for-aws-snowball-1482863105773", - "title": "To get a list of jobs in a cluster that you've created for AWS Snowball" - } - ], - "ListClusters": [ - { - "input": { - }, - "output": { - "ClusterListEntries": [ - { - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000", - "ClusterState": "Pending", - "CreationDate": "1480475517.0", - "Description": "MyCluster" - } - ] - }, - "comments": { - }, - "description": "Returns an array of ClusterListEntry objects of the specified length. Each ClusterListEntry object contains a cluster's state, a cluster's ID, and other important status information.", - "id": "to-get-a-list-of-clusters-that-youve-created-for-aws-snowball-1482862223003", - "title": "To get a list of clusters that you've created for AWS Snowball" - } - ], - "ListJobs": [ - { - "input": { - }, - "output": { - "JobListEntries": [ - { - "CreationDate": "1460678186.0", - "Description": "MyJob", - "IsMaster": false, - "JobId": "JID123e4567-e89b-12d3-a456-426655440000", - "JobState": "New", - "JobType": "IMPORT", - "SnowballType": "STANDARD" - } - ] - }, - "comments": { - }, - "description": "Returns an array of JobListEntry objects of the specified length. Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of export jobs. Calling this API action in one of the US regions will return jobs from the list of all jobs associated with this account in all US regions.", - "id": "to-get-a-list-of-jobs-that-youve-created-for-aws-snowball-1482542167627", - "title": "To get a list of jobs that you've created for AWS Snowball" - } - ], - "UpdateCluster": [ - { - "input": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "ClusterId": "CID123e4567-e89b-12d3-a456-426655440000", - "Description": "Updated the address to send this to image processing - RJ" - }, - "comments": { - }, - "description": "This action allows you to update certain parameters for a cluster. Once the cluster changes to a different state, usually within 60 minutes of it being created, this action is no longer available.", - "id": "to-update-a-cluster-1482863900595", - "title": "To update a cluster" - } - ], - "UpdateJob": [ - { - "input": { - "AddressId": "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b", - "Description": "Upgraded to Edge, shipped to Finance Dept, and requested faster shipping speed - TS.", - "JobId": "JID123e4567-e89b-12d3-a456-426655440000", - "ShippingOption": "NEXT_DAY", - "SnowballCapacityPreference": "T100" - }, - "comments": { - }, - "description": "This action allows you to update certain parameters for a job. Once the job changes to a different job state, usually within 60 minutes of the job being created, this action is no longer available.", - "id": "to-update-a-job-1482863556886", - "title": "To update a job" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/paginators-1.json deleted file mode 100644 index 79596df9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "ListJobs": { - "limit_key": "MaxResults", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "JobListEntries" - }, - "DescribeAddresses": { - "limit_key": "MaxResults", - "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Addresses" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/service-2.json deleted file mode 100644 index 910baa80..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/snowball/2016-06-30/service-2.json +++ /dev/null @@ -1,1462 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-06-30", - "endpointPrefix":"snowball", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon Snowball", - "serviceFullName":"Amazon Import/Export Snowball", - "serviceId":"Snowball", - "signatureVersion":"v4", - "targetPrefix":"AWSIESnowballJobManagementService", - "uid":"snowball-2016-06-30" - }, - "operations":{ - "CancelCluster":{ - "name":"CancelCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelClusterRequest"}, - "output":{"shape":"CancelClusterResult"}, - "errors":[ - {"shape":"KMSRequestFailedException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"InvalidResourceException"} - ], - "documentation":"

Cancels a cluster job. You can only cancel a cluster job while it's in the AwaitingQuorum status. You'll have at least an hour after creating a cluster job to cancel it.

" - }, - "CancelJob":{ - "name":"CancelJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelJobRequest"}, - "output":{"shape":"CancelJobResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"KMSRequestFailedException"} - ], - "documentation":"

Cancels the specified job. You can only cancel a job before its JobState value changes to PreparingAppliance. Requesting the ListJobs or DescribeJob action returns a job's JobState as part of the response element data returned.

" - }, - "CreateAddress":{ - "name":"CreateAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAddressRequest"}, - "output":{"shape":"CreateAddressResult"}, - "errors":[ - {"shape":"InvalidAddressException"}, - {"shape":"UnsupportedAddressException"} - ], - "documentation":"

Creates an address for a Snowball to be shipped to. In most regions, addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. If the address is invalid or unsupported, then an exception is thrown.

" - }, - "CreateCluster":{ - "name":"CreateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateClusterRequest"}, - "output":{"shape":"CreateClusterResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"KMSRequestFailedException"}, - {"shape":"InvalidInputCombinationException"}, - {"shape":"Ec2RequestFailedException"} - ], - "documentation":"

Creates an empty cluster. Each cluster supports five nodes. You use the CreateJob action separately to create the jobs for each of these nodes. The cluster does not ship until these five node jobs have been created.

" - }, - "CreateJob":{ - "name":"CreateJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateJobRequest"}, - "output":{"shape":"CreateJobResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"KMSRequestFailedException"}, - {"shape":"InvalidInputCombinationException"}, - {"shape":"ClusterLimitExceededException"}, - {"shape":"Ec2RequestFailedException"} - ], - "documentation":"

Creates a job to import or export data between Amazon S3 and your on-premises data center. Your AWS account must have the right trust policies and permissions in place to create a job for Snowball. If you're creating a job for a node in a cluster, you only need to provide the clusterId value; the other job attributes are inherited from the cluster.

" - }, - "DescribeAddress":{ - "name":"DescribeAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressRequest"}, - "output":{"shape":"DescribeAddressResult"}, - "errors":[ - {"shape":"InvalidResourceException"} - ], - "documentation":"

Takes an AddressId and returns specific details about that address in the form of an Address object.

" - }, - "DescribeAddresses":{ - "name":"DescribeAddresses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAddressesRequest"}, - "output":{"shape":"DescribeAddressesResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns a specified number of ADDRESS objects. Calling this API in one of the US regions will return addresses from the list of all addresses associated with this account in all US regions.

" - }, - "DescribeCluster":{ - "name":"DescribeCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeClusterRequest"}, - "output":{"shape":"DescribeClusterResult"}, - "errors":[ - {"shape":"InvalidResourceException"} - ], - "documentation":"

Returns information about a specific cluster including shipping information, cluster status, and other important metadata.

" - }, - "DescribeJob":{ - "name":"DescribeJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeJobRequest"}, - "output":{"shape":"DescribeJobResult"}, - "errors":[ - {"shape":"InvalidResourceException"} - ], - "documentation":"

Returns information about a specific job including shipping information, job status, and other important metadata.

" - }, - "GetJobManifest":{ - "name":"GetJobManifest", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobManifestRequest"}, - "output":{"shape":"GetJobManifestResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidJobStateException"} - ], - "documentation":"

Returns a link to an Amazon S3 presigned URL for the manifest file associated with the specified JobId value. You can access the manifest file for up to 60 minutes after this request has been made. To access the manifest file after 60 minutes have passed, you'll have to make another call to the GetJobManifest action.

The manifest is an encrypted file that you can download after your job enters the WithCustomer status. The manifest is decrypted by using the UnlockCode code value, when you pass both values to the Snowball through the Snowball client when the client is started for the first time.

As a best practice, we recommend that you don't save a copy of an UnlockCode value in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.

The credentials of a given job, including its manifest file and unlock code, expire 90 days after the job is created.

" - }, - "GetJobUnlockCode":{ - "name":"GetJobUnlockCode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetJobUnlockCodeRequest"}, - "output":{"shape":"GetJobUnlockCodeResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidJobStateException"} - ], - "documentation":"

Returns the UnlockCode code value for the specified job. A particular UnlockCode value can be accessed for up to 90 days after the associated job has been created.

The UnlockCode value is a 29-character code with 25 alphanumeric characters and 4 hyphens. This code is used to decrypt the manifest file when it is passed along with the manifest to the Snowball through the Snowball client when the client is started for the first time.

As a best practice, we recommend that you don't save a copy of the UnlockCode in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.

" - }, - "GetSnowballUsage":{ - "name":"GetSnowballUsage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSnowballUsageRequest"}, - "output":{"shape":"GetSnowballUsageResult"}, - "documentation":"

Returns information about the Snowball service limit for your account, and also the number of Snowballs your account has in use.

The default service limit for the number of Snowballs that you can have at one time is 1. If you want to increase your service limit, contact AWS Support.

" - }, - "ListClusterJobs":{ - "name":"ListClusterJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListClusterJobsRequest"}, - "output":{"shape":"ListClusterJobsResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns an array of JobListEntry objects of the specified length. Each JobListEntry object is for a job in the specified cluster and contains a job's state, a job's ID, and other information.

" - }, - "ListClusters":{ - "name":"ListClusters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListClustersRequest"}, - "output":{"shape":"ListClustersResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns an array of ClusterListEntry objects of the specified length. Each ClusterListEntry object contains a cluster's state, a cluster's ID, and other important status information.

" - }, - "ListCompatibleImages":{ - "name":"ListCompatibleImages", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCompatibleImagesRequest"}, - "output":{"shape":"ListCompatibleImagesResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"}, - {"shape":"Ec2RequestFailedException"} - ], - "documentation":"

This action returns a list of the different Amazon EC2 Amazon Machine Images (AMIs) that are owned by your AWS account that would be supported for use on a Snowball Edge device. Currently, supported AMIs are based on the CentOS 7 (x86_64) - with Updates HVM, Ubuntu Server 14.04 LTS (HVM), and Ubuntu 16.04 LTS - Xenial (HVM) images, available on the AWS Marketplace.

" - }, - "ListJobs":{ - "name":"ListJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListJobsRequest"}, - "output":{"shape":"ListJobsResult"}, - "errors":[ - {"shape":"InvalidNextTokenException"} - ], - "documentation":"

Returns an array of JobListEntry objects of the specified length. Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of export jobs. Calling this API action in one of the US regions will return jobs from the list of all jobs associated with this account in all US regions.

" - }, - "UpdateCluster":{ - "name":"UpdateCluster", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateClusterRequest"}, - "output":{"shape":"UpdateClusterResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"KMSRequestFailedException"}, - {"shape":"InvalidInputCombinationException"}, - {"shape":"Ec2RequestFailedException"} - ], - "documentation":"

While a cluster's ClusterState value is in the AwaitingQuorum state, you can update some of the information associated with a cluster. Once the cluster changes to a different job state, usually 60 minutes after the cluster being created, this action is no longer available.

" - }, - "UpdateJob":{ - "name":"UpdateJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateJobRequest"}, - "output":{"shape":"UpdateJobResult"}, - "errors":[ - {"shape":"InvalidResourceException"}, - {"shape":"InvalidJobStateException"}, - {"shape":"KMSRequestFailedException"}, - {"shape":"InvalidInputCombinationException"}, - {"shape":"ClusterLimitExceededException"}, - {"shape":"Ec2RequestFailedException"} - ], - "documentation":"

While a job's JobState value is New, you can update some of the information associated with a job. Once the job changes to a different job state, usually within 60 minutes of the job being created, this action is no longer available.

" - } - }, - "shapes":{ - "Address":{ - "type":"structure", - "members":{ - "AddressId":{ - "shape":"AddressId", - "documentation":"

The unique ID for an address.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of a person to receive a Snowball at an address.

" - }, - "Company":{ - "shape":"String", - "documentation":"

The name of the company to receive a Snowball at an address.

" - }, - "Street1":{ - "shape":"String", - "documentation":"

The first line in a street address that a Snowball is to be delivered to.

" - }, - "Street2":{ - "shape":"String", - "documentation":"

The second line in a street address that a Snowball is to be delivered to.

" - }, - "Street3":{ - "shape":"String", - "documentation":"

The third line in a street address that a Snowball is to be delivered to.

" - }, - "City":{ - "shape":"String", - "documentation":"

The city in an address that a Snowball is to be delivered to.

" - }, - "StateOrProvince":{ - "shape":"String", - "documentation":"

The state or province in an address that a Snowball is to be delivered to.

" - }, - "PrefectureOrDistrict":{ - "shape":"String", - "documentation":"

This field is no longer used and the value is ignored.

" - }, - "Landmark":{ - "shape":"String", - "documentation":"

This field is no longer used and the value is ignored.

" - }, - "Country":{ - "shape":"String", - "documentation":"

The country in an address that a Snowball is to be delivered to.

" - }, - "PostalCode":{ - "shape":"String", - "documentation":"

The postal code in an address that a Snowball is to be delivered to.

" - }, - "PhoneNumber":{ - "shape":"String", - "documentation":"

The phone number associated with an address that a Snowball is to be delivered to.

" - }, - "IsRestricted":{ - "shape":"Boolean", - "documentation":"

If the address you are creating is a primary address, then set this option to true. This field is not supported in most regions.

" - } - }, - "documentation":"

The address that you want the Snowball or Snowballs associated with a specific job to be shipped to. Addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. Although no individual elements of the Address are required, if the address is invalid or unsupported, then an exception is thrown.

" - }, - "AddressId":{ - "type":"string", - "max":40, - "min":40, - "pattern":"ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "AddressList":{ - "type":"list", - "member":{"shape":"Address"} - }, - "AmiId":{ - "type":"string", - "max":21, - "min":12, - "pattern":"(ami-[0-9a-f]{8})|(ami-[0-9a-f]{17})" - }, - "Boolean":{"type":"boolean"}, - "CancelClusterRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The 39-character ID for the cluster that you want to cancel, for example CID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "CancelClusterResult":{ - "type":"structure", - "members":{ - } - }, - "CancelJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The 39-character job ID for the job that you want to cancel, for example JID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "CancelJobResult":{ - "type":"structure", - "members":{ - } - }, - "ClusterId":{ - "type":"string", - "max":39, - "min":39, - "pattern":"CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "ClusterLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Job creation failed. Currently, clusters support five nodes. If you have less than five nodes for your cluster and you have more nodes to create for this cluster, try again and create jobs until your cluster has exactly five notes.

", - "exception":true - }, - "ClusterListEntry":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"String", - "documentation":"

The 39-character ID for the cluster that you want to list, for example CID123e4567-e89b-12d3-a456-426655440000.

" - }, - "ClusterState":{ - "shape":"ClusterState", - "documentation":"

The current state of this cluster. For information about the state of a specific node, see JobListEntry$JobState.

" - }, - "CreationDate":{ - "shape":"Timestamp", - "documentation":"

The creation date for this cluster.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Defines an optional description of the cluster, for example Environmental Data Cluster-01.

" - } - }, - "documentation":"

Contains a cluster's state, a cluster's ID, and other important information.

" - }, - "ClusterListEntryList":{ - "type":"list", - "member":{"shape":"ClusterListEntry"} - }, - "ClusterMetadata":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"String", - "documentation":"

The automatically generated ID for a cluster.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The optional description of the cluster.

" - }, - "KmsKeyARN":{ - "shape":"KmsKeyARN", - "documentation":"

The KmsKeyARN Amazon Resource Name (ARN) associated with this cluster. This ARN was created using the CreateKey API action in AWS Key Management Service (AWS KMS).

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The role ARN associated with this cluster. This ARN was created using the CreateRole API action in AWS Identity and Access Management (IAM).

" - }, - "ClusterState":{ - "shape":"ClusterState", - "documentation":"

The current status of the cluster.

" - }, - "JobType":{ - "shape":"JobType", - "documentation":"

The type of job for this cluster. Currently, the only job type supported for clusters is LOCAL_USE.

" - }, - "SnowballType":{ - "shape":"SnowballType", - "documentation":"

The type of AWS Snowball device to use for this cluster. Currently, the only supported device type for cluster jobs is EDGE.

" - }, - "CreationDate":{ - "shape":"Timestamp", - "documentation":"

The creation date for this cluster.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

The arrays of JobResource objects that can include updated S3Resource objects or LambdaResource objects.

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The automatically generated ID for a specific address.

" - }, - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each Snowball Edge device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows:

  • In Australia, you have access to express shipping. Typically, devices shipped express are delivered in about a day.

  • In the European Union (EU), you have access to express shipping. Typically, Snowball Edges shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.

  • In India, Snowball Edges are delivered in one to seven days.

  • In the US, you have access to one-day shipping and two-day shipping.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The ID of the address that you want a cluster shipped to, after it will be shipped to its primary address. This field is not supported in most regions.

" - } - }, - "documentation":"

Contains metadata about a specific cluster.

" - }, - "ClusterState":{ - "type":"string", - "enum":[ - "AwaitingQuorum", - "Pending", - "InUse", - "Complete", - "Cancelled" - ] - }, - "CompatibleImage":{ - "type":"structure", - "members":{ - "AmiId":{ - "shape":"String", - "documentation":"

The unique identifier for an individual Snowball Edge AMI.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The optional name of a compatible image.

" - } - }, - "documentation":"

A JSON-formatted object that describes a compatible Amazon Machine Image (AMI), including the ID and name for a Snowball Edge AMI. This AMI is compatible with the device's physical hardware requirements, and it should be able to be run in an SBE1 instance on the device.

" - }, - "CompatibleImageList":{ - "type":"list", - "member":{"shape":"CompatibleImage"} - }, - "CreateAddressRequest":{ - "type":"structure", - "required":["Address"], - "members":{ - "Address":{ - "shape":"Address", - "documentation":"

The address that you want the Snowball shipped to.

" - } - } - }, - "CreateAddressResult":{ - "type":"structure", - "members":{ - "AddressId":{ - "shape":"String", - "documentation":"

The automatically generated ID for a specific address. You'll use this ID when you create a job to specify which address you want the Snowball for that job shipped to.

" - } - } - }, - "CreateClusterRequest":{ - "type":"structure", - "required":[ - "JobType", - "Resources", - "AddressId", - "RoleARN", - "ShippingOption" - ], - "members":{ - "JobType":{ - "shape":"JobType", - "documentation":"

The type of job for this cluster. Currently, the only job type supported for clusters is LOCAL_USE.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

The resources associated with the cluster job. These resources include Amazon S3 buckets and optional AWS Lambda functions written in the Python language.

" - }, - "Description":{ - "shape":"String", - "documentation":"

An optional description of this specific cluster, for example Environmental Data Cluster-01.

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The ID for the address that you want the cluster shipped to.

" - }, - "KmsKeyARN":{ - "shape":"KmsKeyARN", - "documentation":"

The KmsKeyARN value that you want to associate with this cluster. KmsKeyARN values are created by using the CreateKey API action in AWS Key Management Service (AWS KMS).

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The RoleARN that you want to associate with this cluster. RoleArn values are created by using the CreateRole API action in AWS Identity and Access Management (IAM).

" - }, - "SnowballType":{ - "shape":"SnowballType", - "documentation":"

The type of AWS Snowball device to use for this cluster. Currently, the only supported device type for cluster jobs is EDGE.

" - }, - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each Snowball Edge device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows:

  • In Australia, you have access to express shipping. Typically, devices shipped express are delivered in about a day.

  • In the European Union (EU), you have access to express shipping. Typically, Snowball Edges shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.

  • In India, Snowball Edges are delivered in one to seven days.

  • In the US, you have access to one-day shipping and two-day shipping.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The forwarding address ID for a cluster. This field is not supported in most regions.

" - } - } - }, - "CreateClusterResult":{ - "type":"structure", - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The automatically generated ID for a cluster.

" - } - } - }, - "CreateJobRequest":{ - "type":"structure", - "members":{ - "JobType":{ - "shape":"JobType", - "documentation":"

Defines the type of job that you're creating.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

Defines the Amazon S3 buckets associated with this job.

With IMPORT jobs, you specify the bucket or buckets that your transferred data will be imported into.

With EXPORT jobs, you specify the bucket or buckets that your transferred data will be exported from. Optionally, you can also specify a KeyRange value. If you choose to export a range, you define the length of the range by providing either an inclusive BeginMarker value, an inclusive EndMarker value, or both. Ranges are UTF-8 binary sorted.

" - }, - "Description":{ - "shape":"String", - "documentation":"

Defines an optional description of this specific job, for example Important Photos 2016-08-11.

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The ID for the address that you want the Snowball shipped to.

" - }, - "KmsKeyARN":{ - "shape":"KmsKeyARN", - "documentation":"

The KmsKeyARN that you want to associate with this job. KmsKeyARNs are created using the CreateKey AWS Key Management Service (KMS) API action.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The RoleARN that you want to associate with this job. RoleArns are created using the CreateRole AWS Identity and Access Management (IAM) API action.

" - }, - "SnowballCapacityPreference":{ - "shape":"SnowballCapacity", - "documentation":"

If your job is being created in one of the US regions, you have the option of specifying what size Snowball you'd like for this job. In all other regions, Snowballs come with 80 TB in storage capacity.

" - }, - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The shipping speed for this job. This speed doesn't dictate how soon you'll get the Snowball, rather it represents how quickly the Snowball moves to its destination while in transit. Regional shipping speeds are as follows:

  • In Australia, you have access to express shipping. Typically, Snowballs shipped express are delivered in about a day.

  • In the European Union (EU), you have access to express shipping. Typically, Snowballs shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.

  • In India, Snowballs are delivered in one to seven days.

  • In the US, you have access to one-day shipping and two-day shipping.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

Defines the Amazon Simple Notification Service (Amazon SNS) notification settings for this job.

" - }, - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The ID of a cluster. If you're creating a job for a node in a cluster, you need to provide only this clusterId value. The other job attributes are inherited from the cluster.

" - }, - "SnowballType":{ - "shape":"SnowballType", - "documentation":"

The type of AWS Snowball device to use for this job. Currently, the only supported device type for cluster jobs is EDGE.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The forwarding address ID for a job. This field is not supported in most regions.

" - } - } - }, - "CreateJobResult":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "DataTransfer":{ - "type":"structure", - "members":{ - "BytesTransferred":{ - "shape":"Long", - "documentation":"

The number of bytes transferred between a Snowball and Amazon S3.

" - }, - "ObjectsTransferred":{ - "shape":"Long", - "documentation":"

The number of objects transferred between a Snowball and Amazon S3.

" - }, - "TotalBytes":{ - "shape":"Long", - "documentation":"

The total bytes of data for a transfer between a Snowball and Amazon S3. This value is set to 0 (zero) until all the keys that will be transferred have been listed.

" - }, - "TotalObjects":{ - "shape":"Long", - "documentation":"

The total number of objects for a transfer between a Snowball and Amazon S3. This value is set to 0 (zero) until all the keys that will be transferred have been listed.

" - } - }, - "documentation":"

Defines the real-time status of a Snowball's data transfer while the device is at AWS. This data is only available while a job has a JobState value of InProgress, for both import and export jobs.

" - }, - "DescribeAddressRequest":{ - "type":"structure", - "required":["AddressId"], - "members":{ - "AddressId":{ - "shape":"AddressId", - "documentation":"

The automatically generated ID for a specific address.

" - } - } - }, - "DescribeAddressResult":{ - "type":"structure", - "members":{ - "Address":{ - "shape":"Address", - "documentation":"

The address that you want the Snowball or Snowballs associated with a specific job to be shipped to.

" - } - } - }, - "DescribeAddressesRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The number of ADDRESS objects to return.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. To identify what object comes \"next\" in the list of ADDRESS objects, you have the option of specifying a value for NextToken as the starting point for your list of returned addresses.

" - } - } - }, - "DescribeAddressesResult":{ - "type":"structure", - "members":{ - "Addresses":{ - "shape":"AddressList", - "documentation":"

The Snowball shipping addresses that were created for this account.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. If you use the automatically generated NextToken value in your next DescribeAddresses call, your list of returned addresses will start from this point in the array.

" - } - } - }, - "DescribeClusterRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The automatically generated ID for a cluster.

" - } - } - }, - "DescribeClusterResult":{ - "type":"structure", - "members":{ - "ClusterMetadata":{ - "shape":"ClusterMetadata", - "documentation":"

Information about a specific cluster, including shipping information, cluster status, and other important metadata.

" - } - } - }, - "DescribeJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "DescribeJobResult":{ - "type":"structure", - "members":{ - "JobMetadata":{ - "shape":"JobMetadata", - "documentation":"

Information about a specific job, including shipping information, job status, and other important metadata.

" - }, - "SubJobMetadata":{ - "shape":"JobMetadataList", - "documentation":"

Information about a specific job part (in the case of an export job), including shipping information, job status, and other important metadata.

" - } - } - }, - "Ec2AmiResource":{ - "type":"structure", - "required":["AmiId"], - "members":{ - "AmiId":{ - "shape":"AmiId", - "documentation":"

The ID of the AMI in Amazon EC2.

" - }, - "SnowballAmiId":{ - "shape":"String", - "documentation":"

The ID of the AMI on the Snowball Edge device.

" - } - }, - "documentation":"

A JSON-formatted object that contains the IDs for an Amazon Machine Image (AMI), including the Amazon EC2 AMI ID and the Snowball Edge AMI ID. Each AMI has these two IDs to simplify identifying the AMI in both the AWS Cloud and on the device.

" - }, - "Ec2AmiResourceList":{ - "type":"list", - "member":{"shape":"Ec2AmiResource"} - }, - "Ec2RequestFailedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Your IAM user lacks the necessary Amazon EC2 permissions to perform the attempted action.

", - "exception":true - }, - "EventTriggerDefinition":{ - "type":"structure", - "members":{ - "EventResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) for any local Amazon S3 resource that is an AWS Lambda function's event trigger associated with this job.

" - } - }, - "documentation":"

The container for the EventTriggerDefinition$EventResourceARN.

" - }, - "EventTriggerDefinitionList":{ - "type":"list", - "member":{"shape":"EventTriggerDefinition"} - }, - "GetJobManifestRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The ID for a job that you want to get the manifest file for, for example JID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "GetJobManifestResult":{ - "type":"structure", - "members":{ - "ManifestURI":{ - "shape":"String", - "documentation":"

The Amazon S3 presigned URL for the manifest file associated with the specified JobId value.

" - } - } - }, - "GetJobUnlockCodeRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The ID for the job that you want to get the UnlockCode value for, for example JID123e4567-e89b-12d3-a456-426655440000.

" - } - } - }, - "GetJobUnlockCodeResult":{ - "type":"structure", - "members":{ - "UnlockCode":{ - "shape":"String", - "documentation":"

The UnlockCode value for the specified job. The UnlockCode value can be accessed for up to 90 days after the job has been created.

" - } - } - }, - "GetSnowballUsageRequest":{ - "type":"structure", - "members":{ - } - }, - "GetSnowballUsageResult":{ - "type":"structure", - "members":{ - "SnowballLimit":{ - "shape":"Integer", - "documentation":"

The service limit for number of Snowballs this account can have at once. The default service limit is 1 (one).

" - }, - "SnowballsInUse":{ - "shape":"Integer", - "documentation":"

The number of Snowballs that this account is currently using.

" - } - } - }, - "Integer":{"type":"integer"}, - "InvalidAddressException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The address provided was invalid. Check the address with your region's carrier, and try again.

", - "exception":true - }, - "InvalidInputCombinationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Job or cluster creation failed. One ore more inputs were invalid. Confirm that the CreateClusterRequest$SnowballType value supports your CreateJobRequest$JobType, and try again.

", - "exception":true - }, - "InvalidJobStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The action can't be performed because the job's current state doesn't allow that action to be performed.

", - "exception":true - }, - "InvalidNextTokenException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The NextToken string was altered unexpectedly, and the operation has stopped. Run the operation without changing the NextToken string, and try again.

", - "exception":true - }, - "InvalidResourceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"}, - "ResourceType":{ - "shape":"String", - "documentation":"

The provided resource value is invalid.

" - } - }, - "documentation":"

The specified resource can't be found. Check the information you provided in your last request, and try again.

", - "exception":true - }, - "JobId":{ - "type":"string", - "max":39, - "min":39, - "pattern":"(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" - }, - "JobListEntry":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"String", - "documentation":"

The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000.

" - }, - "JobState":{ - "shape":"JobState", - "documentation":"

The current state of this job.

" - }, - "IsMaster":{ - "shape":"Boolean", - "documentation":"

A value that indicates that this job is a master job. A master job represents a successful request to create an export job. Master jobs aren't associated with any Snowballs. Instead, each master job will have at least one job part, and each job part is associated with a Snowball. It might take some time before the job parts associated with a particular master job are listed, because they are created after the master job is created.

" - }, - "JobType":{ - "shape":"JobType", - "documentation":"

The type of job.

" - }, - "SnowballType":{ - "shape":"SnowballType", - "documentation":"

The type of device used with this job.

" - }, - "CreationDate":{ - "shape":"Timestamp", - "documentation":"

The creation date for this job.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The optional description of this specific job, for example Important Photos 2016-08-11.

" - } - }, - "documentation":"

Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of an export job.

" - }, - "JobListEntryList":{ - "type":"list", - "member":{"shape":"JobListEntry"} - }, - "JobLogs":{ - "type":"structure", - "members":{ - "JobCompletionReportURI":{ - "shape":"String", - "documentation":"

A link to an Amazon S3 presigned URL where the job completion report is located.

" - }, - "JobSuccessLogURI":{ - "shape":"String", - "documentation":"

A link to an Amazon S3 presigned URL where the job success log is located.

" - }, - "JobFailureLogURI":{ - "shape":"String", - "documentation":"

A link to an Amazon S3 presigned URL where the job failure log is located.

" - } - }, - "documentation":"

Contains job logs. Whenever Snowball is used to import data into or export data out of Amazon S3, you'll have the option of downloading a PDF job report. Job logs are returned as a part of the response syntax of the DescribeJob action in the JobMetadata data type. The job logs can be accessed for up to 60 minutes after this request has been made. To access any of the job logs after 60 minutes have passed, you'll have to make another call to the DescribeJob action.

For import jobs, the PDF job report becomes available at the end of the import process. For export jobs, your job report typically becomes available while the Snowball for your job part is being delivered to you.

The job report provides you insight into the state of your Amazon S3 data transfer. The report includes details about your job or job part for your records.

For deeper visibility into the status of your transferred objects, you can look at the two associated logs: a success log and a failure log. The logs are saved in comma-separated value (CSV) format, and the name of each log includes the ID of the job or job part that the log describes.

" - }, - "JobMetadata":{ - "type":"structure", - "members":{ - "JobId":{ - "shape":"String", - "documentation":"

The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000.

" - }, - "JobState":{ - "shape":"JobState", - "documentation":"

The current status of the jobs.

" - }, - "JobType":{ - "shape":"JobType", - "documentation":"

The type of job.

" - }, - "SnowballType":{ - "shape":"SnowballType", - "documentation":"

The type of device used with this job.

" - }, - "CreationDate":{ - "shape":"Timestamp", - "documentation":"

The creation date for this job.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

An array of S3Resource objects. Each S3Resource object represents an Amazon S3 bucket that your transferred data will be exported from or imported into.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The description of the job, provided at job creation.

" - }, - "KmsKeyARN":{ - "shape":"KmsKeyARN", - "documentation":"

The Amazon Resource Name (ARN) for the AWS Key Management Service (AWS KMS) key associated with this job. This ARN was created using the CreateKey API action in AWS KMS.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The role ARN associated with this job. This ARN was created using the CreateRole API action in AWS Identity and Access Management (IAM).

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The ID for the address that you want the Snowball shipped to.

" - }, - "ShippingDetails":{ - "shape":"ShippingDetails", - "documentation":"

A job's shipping information, including inbound and outbound tracking numbers and shipping speed options.

" - }, - "SnowballCapacityPreference":{ - "shape":"SnowballCapacity", - "documentation":"

The Snowball capacity preference for this job, specified at job creation. In US regions, you can choose between 50 TB and 80 TB Snowballs. All other regions use 80 TB capacity Snowballs.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) notification settings associated with a specific job. The Notification object is returned as a part of the response syntax of the DescribeJob action in the JobMetadata data type.

" - }, - "DataTransferProgress":{ - "shape":"DataTransfer", - "documentation":"

A value that defines the real-time status of a Snowball's data transfer while the device is at AWS. This data is only available while a job has a JobState value of InProgress, for both import and export jobs.

" - }, - "JobLogInfo":{ - "shape":"JobLogs", - "documentation":"

Links to Amazon S3 presigned URLs for the job report and logs. For import jobs, the PDF job report becomes available at the end of the import process. For export jobs, your job report typically becomes available while the Snowball for your job part is being delivered to you.

" - }, - "ClusterId":{ - "shape":"String", - "documentation":"

The 39-character ID for the cluster, for example CID123e4567-e89b-12d3-a456-426655440000.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The ID of the address that you want a job shipped to, after it will be shipped to its primary address. This field is not supported in most regions.

" - } - }, - "documentation":"

Contains information about a specific job including shipping information, job status, and other important metadata. This information is returned as a part of the response syntax of the DescribeJob action.

" - }, - "JobMetadataList":{ - "type":"list", - "member":{"shape":"JobMetadata"} - }, - "JobResource":{ - "type":"structure", - "members":{ - "S3Resources":{ - "shape":"S3ResourceList", - "documentation":"

An array of S3Resource objects.

" - }, - "LambdaResources":{ - "shape":"LambdaResourceList", - "documentation":"

The Python-language Lambda functions for this job.

" - }, - "Ec2AmiResources":{ - "shape":"Ec2AmiResourceList", - "documentation":"

The Amazon Machine Images (AMIs) associated with this job.

" - } - }, - "documentation":"

Contains an array of AWS resource objects. Each object represents an Amazon S3 bucket, an AWS Lambda function, or an Amazon Machine Image (AMI) based on Amazon EC2 that is associated with a particular job.

" - }, - "JobState":{ - "type":"string", - "enum":[ - "New", - "PreparingAppliance", - "PreparingShipment", - "InTransitToCustomer", - "WithCustomer", - "InTransitToAWS", - "WithAWS", - "InProgress", - "Complete", - "Cancelled", - "Listing", - "Pending" - ] - }, - "JobStateList":{ - "type":"list", - "member":{"shape":"JobState"} - }, - "JobType":{ - "type":"string", - "enum":[ - "IMPORT", - "EXPORT", - "LOCAL_USE" - ] - }, - "KMSRequestFailedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The provided AWS Key Management Service key lacks the permissions to perform the specified CreateJob or UpdateJob action.

", - "exception":true - }, - "KeyRange":{ - "type":"structure", - "members":{ - "BeginMarker":{ - "shape":"String", - "documentation":"

The key that starts an optional key range for an export job. Ranges are inclusive and UTF-8 binary sorted.

" - }, - "EndMarker":{ - "shape":"String", - "documentation":"

The key that ends an optional key range for an export job. Ranges are inclusive and UTF-8 binary sorted.

" - } - }, - "documentation":"

Contains a key range. For export jobs, a S3Resource object can have an optional KeyRange value. The length of the range is defined at job creation, and has either an inclusive BeginMarker, an inclusive EndMarker, or both. Ranges are UTF-8 binary sorted.

" - }, - "KmsKeyARN":{ - "type":"string", - "max":255, - "pattern":"arn:aws.*:kms:.*:[0-9]{12}:key/.*" - }, - "LambdaResource":{ - "type":"structure", - "members":{ - "LambdaArn":{ - "shape":"ResourceARN", - "documentation":"

An Amazon Resource Name (ARN) that represents an AWS Lambda function to be triggered by PUT object actions on the associated local Amazon S3 resource.

" - }, - "EventTriggers":{ - "shape":"EventTriggerDefinitionList", - "documentation":"

The array of ARNs for S3Resource objects to trigger the LambdaResource objects associated with this job.

" - } - }, - "documentation":"

Identifies

" - }, - "LambdaResourceList":{ - "type":"list", - "member":{"shape":"LambdaResource"} - }, - "ListClusterJobsRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The 39-character ID for the cluster that you want to list, for example CID123e4567-e89b-12d3-a456-426655440000.

" - }, - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The number of JobListEntry objects to return.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. To identify what object comes \"next\" in the list of JobListEntry objects, you have the option of specifying NextToken as the starting point for your returned list.

" - } - } - }, - "ListClusterJobsResult":{ - "type":"structure", - "members":{ - "JobListEntries":{ - "shape":"JobListEntryList", - "documentation":"

Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of export jobs.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. If you use the automatically generated NextToken value in your next ListClusterJobsResult call, your list of returned jobs will start from this point in the array.

" - } - } - }, - "ListClustersRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The number of ClusterListEntry objects to return.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. To identify what object comes \"next\" in the list of ClusterListEntry objects, you have the option of specifying NextToken as the starting point for your returned list.

" - } - } - }, - "ListClustersResult":{ - "type":"structure", - "members":{ - "ClusterListEntries":{ - "shape":"ClusterListEntryList", - "documentation":"

Each ClusterListEntry object contains a cluster's state, a cluster's ID, and other important status information.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. If you use the automatically generated NextToken value in your next ClusterListEntry call, your list of returned clusters will start from this point in the array.

" - } - } - }, - "ListCompatibleImagesRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The maximum number of results for the list of compatible images. Currently, a Snowball Edge device can store 10 AMIs.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. To identify what object comes \"next\" in the list of compatible images, you can specify a value for NextToken as the starting point for your list of returned images.

" - } - } - }, - "ListCompatibleImagesResult":{ - "type":"structure", - "members":{ - "CompatibleImages":{ - "shape":"CompatibleImageList", - "documentation":"

A JSON-formatted object that describes a compatible AMI, including the ID and name for a Snowball Edge AMI.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Because HTTP requests are stateless, this is the starting point for your next list of returned images.

" - } - } - }, - "ListJobsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"ListLimit", - "documentation":"

The number of JobListEntry objects to return.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. To identify what object comes \"next\" in the list of JobListEntry objects, you have the option of specifying NextToken as the starting point for your returned list.

" - } - } - }, - "ListJobsResult":{ - "type":"structure", - "members":{ - "JobListEntries":{ - "shape":"JobListEntryList", - "documentation":"

Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of export jobs.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

HTTP requests are stateless. If you use this automatically generated NextToken value in your next ListJobs call, your returned JobListEntry objects will start from this point in the array.

" - } - } - }, - "ListLimit":{ - "type":"integer", - "max":100, - "min":0 - }, - "Long":{"type":"long"}, - "Notification":{ - "type":"structure", - "members":{ - "SnsTopicARN":{ - "shape":"SnsTopicARN", - "documentation":"

The new SNS TopicArn that you want to associate with this job. You can create Amazon Resource Names (ARNs) for topics by using the CreateTopic Amazon SNS API action.

You can subscribe email addresses to an Amazon SNS topic through the AWS Management Console, or by using the Subscribe AWS Simple Notification Service (SNS) API action.

" - }, - "JobStatesToNotify":{ - "shape":"JobStateList", - "documentation":"

The list of job states that will trigger a notification for this job.

" - }, - "NotifyAll":{ - "shape":"Boolean", - "documentation":"

Any change in job state will trigger a notification for this job.

" - } - }, - "documentation":"

The Amazon Simple Notification Service (Amazon SNS) notification settings associated with a specific job. The Notification object is returned as a part of the response syntax of the DescribeJob action in the JobMetadata data type.

When the notification settings are defined during job creation, you can choose to notify based on a specific set of job states using the JobStatesToNotify array of strings, or you can specify that you want to have Amazon SNS notifications sent out for all job states with NotifyAll set to true.

" - }, - "ResourceARN":{ - "type":"string", - "max":255 - }, - "RoleARN":{ - "type":"string", - "max":255, - "pattern":"arn:aws.*:iam::[0-9]{12}:role/.*" - }, - "S3Resource":{ - "type":"structure", - "members":{ - "BucketArn":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of an Amazon S3 bucket.

" - }, - "KeyRange":{ - "shape":"KeyRange", - "documentation":"

For export jobs, you can provide an optional KeyRange within a specific Amazon S3 bucket. The length of the range is defined at job creation, and has either an inclusive BeginMarker, an inclusive EndMarker, or both. Ranges are UTF-8 binary sorted.

" - } - }, - "documentation":"

Each S3Resource object represents an Amazon S3 bucket that your transferred data will be exported from or imported into. For export jobs, this object can have an optional KeyRange value. The length of the range is defined at job creation, and has either an inclusive BeginMarker, an inclusive EndMarker, or both. Ranges are UTF-8 binary sorted.

" - }, - "S3ResourceList":{ - "type":"list", - "member":{"shape":"S3Resource"} - }, - "Shipment":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"String", - "documentation":"

Status information for a shipment.

" - }, - "TrackingNumber":{ - "shape":"String", - "documentation":"

The tracking number for this job. Using this tracking number with your region's carrier's website, you can track a Snowball as the carrier transports it.

For India, the carrier is Amazon Logistics. For all other regions, UPS is the carrier.

" - } - }, - "documentation":"

The Status and TrackingNumber information for an inbound or outbound shipment.

" - }, - "ShippingDetails":{ - "type":"structure", - "members":{ - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The shipping speed for a particular job. This speed doesn't dictate how soon you'll get the Snowball from the job's creation date. This speed represents how quickly it moves to its destination while in transit. Regional shipping speeds are as follows:

  • In Australia, you have access to express shipping. Typically, Snowballs shipped express are delivered in about a day.

  • In the European Union (EU), you have access to express shipping. Typically, Snowballs shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.

  • In India, Snowballs are delivered in one to seven days.

  • In the United States of America (US), you have access to one-day shipping and two-day shipping.

" - }, - "InboundShipment":{ - "shape":"Shipment", - "documentation":"

The Status and TrackingNumber values for a Snowball being returned to AWS for a particular job.

" - }, - "OutboundShipment":{ - "shape":"Shipment", - "documentation":"

The Status and TrackingNumber values for a Snowball being delivered to the address that you specified for a particular job.

" - } - }, - "documentation":"

A job's shipping information, including inbound and outbound tracking numbers and shipping speed options.

" - }, - "ShippingOption":{ - "type":"string", - "enum":[ - "SECOND_DAY", - "NEXT_DAY", - "EXPRESS", - "STANDARD" - ] - }, - "SnowballCapacity":{ - "type":"string", - "enum":[ - "T50", - "T80", - "T100", - "NoPreference" - ] - }, - "SnowballType":{ - "type":"string", - "enum":[ - "STANDARD", - "EDGE" - ] - }, - "SnsTopicARN":{ - "type":"string", - "max":255, - "pattern":"arn:aws.*:sns:.*:[0-9]{12}:.*" - }, - "String":{ - "type":"string", - "min":1 - }, - "Timestamp":{"type":"timestamp"}, - "UnsupportedAddressException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The address is either outside the serviceable area for your region, or an error occurred. Check the address with your region's carrier and try again. If the issue persists, contact AWS Support.

", - "exception":true - }, - "UpdateClusterRequest":{ - "type":"structure", - "required":["ClusterId"], - "members":{ - "ClusterId":{ - "shape":"ClusterId", - "documentation":"

The cluster ID of the cluster that you want to update, for example CID123e4567-e89b-12d3-a456-426655440000.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The new role Amazon Resource Name (ARN) that you want to associate with this cluster. To create a role ARN, use the CreateRole API action in AWS Identity and Access Management (IAM).

" - }, - "Description":{ - "shape":"String", - "documentation":"

The updated description of this cluster.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

The updated arrays of JobResource objects that can include updated S3Resource objects or LambdaResource objects.

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The ID of the updated Address object.

" - }, - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The updated shipping option value of this cluster's ShippingDetails object.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The new or updated Notification object.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The updated ID for the forwarding address for a cluster. This field is not supported in most regions.

" - } - } - }, - "UpdateClusterResult":{ - "type":"structure", - "members":{ - } - }, - "UpdateJobRequest":{ - "type":"structure", - "required":["JobId"], - "members":{ - "JobId":{ - "shape":"JobId", - "documentation":"

The job ID of the job that you want to update, for example JID123e4567-e89b-12d3-a456-426655440000.

" - }, - "RoleARN":{ - "shape":"RoleARN", - "documentation":"

The new role Amazon Resource Name (ARN) that you want to associate with this job. To create a role ARN, use the CreateRoleAWS Identity and Access Management (IAM) API action.

" - }, - "Notification":{ - "shape":"Notification", - "documentation":"

The new or updated Notification object.

" - }, - "Resources":{ - "shape":"JobResource", - "documentation":"

The updated JobResource object, or the updated JobResource object.

" - }, - "AddressId":{ - "shape":"AddressId", - "documentation":"

The ID of the updated Address object.

" - }, - "ShippingOption":{ - "shape":"ShippingOption", - "documentation":"

The updated shipping option value of this job's ShippingDetails object.

" - }, - "Description":{ - "shape":"String", - "documentation":"

The updated description of this job's JobMetadata object.

" - }, - "SnowballCapacityPreference":{ - "shape":"SnowballCapacity", - "documentation":"

The updated SnowballCapacityPreference of this job's JobMetadata object. The 50 TB Snowballs are only available in the US regions.

" - }, - "ForwardingAddressId":{ - "shape":"AddressId", - "documentation":"

The updated ID for the forwarding address for a job. This field is not supported in most regions.

" - } - } - }, - "UpdateJobResult":{ - "type":"structure", - "members":{ - } - } - }, - "documentation":"

AWS Snowball is a petabyte-scale data transport solution that uses secure devices to transfer large amounts of data between your on-premises data centers and Amazon Simple Storage Service (Amazon S3). The Snowball commands described here provide access to the same functionality that is available in the AWS Snowball Management Console, which enables you to create and manage jobs for Snowball. To transfer data locally with a Snowball device, you'll need to use the Snowball client or the Amazon S3 API adapter for Snowball. For more information, see the User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/paginators-1.json deleted file mode 100644 index 455e4708..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/paginators-1.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "pagination": { - "ListEndpointsByPlatformApplication": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Endpoints" - }, - "ListPlatformApplications": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "PlatformApplications" - }, - "ListSubscriptions": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Subscriptions" - }, - "ListSubscriptionsByTopic": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Subscriptions" - }, - "ListTopics": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Topics" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/service-2.json deleted file mode 100644 index 5fb59881..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sns/2010-03-31/service-2.json +++ /dev/null @@ -1,1556 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2010-03-31", - "endpointPrefix":"sns", - "protocol":"query", - "serviceAbbreviation":"Amazon SNS", - "serviceFullName":"Amazon Simple Notification Service", - "serviceId":"SNS", - "signatureVersion":"v4", - "uid":"sns-2010-03-31", - "xmlNamespace":"http://sns.amazonaws.com/doc/2010-03-31/" - }, - "operations":{ - "AddPermission":{ - "name":"AddPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddPermissionInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Adds a statement to a topic's access control policy, granting access for the specified AWS accounts to the specified actions.

" - }, - "CheckIfPhoneNumberIsOptedOut":{ - "name":"CheckIfPhoneNumberIsOptedOut", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CheckIfPhoneNumberIsOptedOutInput"}, - "output":{ - "shape":"CheckIfPhoneNumberIsOptedOutResponse", - "resultWrapper":"CheckIfPhoneNumberIsOptedOutResult" - }, - "errors":[ - {"shape":"ThrottledException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Accepts a phone number and indicates whether the phone holder has opted out of receiving SMS messages from your account. You cannot send SMS messages to a number that is opted out.

To resume sending messages, you can opt in the number by using the OptInPhoneNumber action.

" - }, - "ConfirmSubscription":{ - "name":"ConfirmSubscription", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ConfirmSubscriptionInput"}, - "output":{ - "shape":"ConfirmSubscriptionResponse", - "resultWrapper":"ConfirmSubscriptionResult" - }, - "errors":[ - {"shape":"SubscriptionLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NotFoundException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Verifies an endpoint owner's intent to receive messages by validating the token sent to the endpoint by an earlier Subscribe action. If the token is valid, the action creates a new subscription and returns its Amazon Resource Name (ARN). This call requires an AWS signature only when the AuthenticateOnUnsubscribe flag is set to \"true\".

" - }, - "CreatePlatformApplication":{ - "name":"CreatePlatformApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlatformApplicationInput"}, - "output":{ - "shape":"CreatePlatformApplicationResponse", - "resultWrapper":"CreatePlatformApplicationResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Creates a platform application object for one of the supported push notification services, such as APNS and GCM, to which devices and mobile apps may register. You must specify PlatformPrincipal and PlatformCredential attributes when using the CreatePlatformApplication action. The PlatformPrincipal is received from the notification service. For APNS/APNS_SANDBOX, PlatformPrincipal is \"SSL certificate\". For GCM, PlatformPrincipal is not applicable. For ADM, PlatformPrincipal is \"client id\". The PlatformCredential is also received from the notification service. For WNS, PlatformPrincipal is \"Package Security Identifier\". For MPNS, PlatformPrincipal is \"TLS certificate\". For Baidu, PlatformPrincipal is \"API key\".

For APNS/APNS_SANDBOX, PlatformCredential is \"private key\". For GCM, PlatformCredential is \"API key\". For ADM, PlatformCredential is \"client secret\". For WNS, PlatformCredential is \"secret key\". For MPNS, PlatformCredential is \"private key\". For Baidu, PlatformCredential is \"secret key\". The PlatformApplicationArn that is returned when using CreatePlatformApplication is then used as an attribute for the CreatePlatformEndpoint action. For more information, see Using Amazon SNS Mobile Push Notifications. For more information about obtaining the PlatformPrincipal and PlatformCredential for each of the supported push notification services, see Getting Started with Apple Push Notification Service, Getting Started with Amazon Device Messaging, Getting Started with Baidu Cloud Push, Getting Started with Google Cloud Messaging for Android, Getting Started with MPNS, or Getting Started with WNS.

" - }, - "CreatePlatformEndpoint":{ - "name":"CreatePlatformEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePlatformEndpointInput"}, - "output":{ - "shape":"CreateEndpointResponse", - "resultWrapper":"CreatePlatformEndpointResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Creates an endpoint for a device and mobile app on one of the supported push notification services, such as GCM and APNS. CreatePlatformEndpoint requires the PlatformApplicationArn that is returned from CreatePlatformApplication. The EndpointArn that is returned when using CreatePlatformEndpoint can then be used by the Publish action to send a message to a mobile app or by the Subscribe action for subscription to a topic. The CreatePlatformEndpoint action is idempotent, so if the requester already owns an endpoint with the same device token and attributes, that endpoint's ARN is returned without creating a new endpoint. For more information, see Using Amazon SNS Mobile Push Notifications.

When using CreatePlatformEndpoint with Baidu, two attributes must be provided: ChannelId and UserId. The token field must also contain the ChannelId. For more information, see Creating an Amazon SNS Endpoint for Baidu.

" - }, - "CreateTopic":{ - "name":"CreateTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTopicInput"}, - "output":{ - "shape":"CreateTopicResponse", - "resultWrapper":"CreateTopicResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"TopicLimitExceededException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Creates a topic to which notifications can be published. Users can create at most 100,000 topics. For more information, see http://aws.amazon.com/sns. This action is idempotent, so if the requester already owns a topic with the specified name, that topic's ARN is returned without creating a new topic.

" - }, - "DeleteEndpoint":{ - "name":"DeleteEndpoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteEndpointInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Deletes the endpoint for a device and mobile app from Amazon SNS. This action is idempotent. For more information, see Using Amazon SNS Mobile Push Notifications.

When you delete an endpoint that is also subscribed to a topic, then you must also unsubscribe the endpoint from the topic.

" - }, - "DeletePlatformApplication":{ - "name":"DeletePlatformApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePlatformApplicationInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Deletes a platform application object for one of the supported push notification services, such as APNS and GCM. For more information, see Using Amazon SNS Mobile Push Notifications.

" - }, - "DeleteTopic":{ - "name":"DeleteTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTopicInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a topic and all its subscriptions. Deleting a topic might prevent some messages previously sent to the topic from being delivered to subscribers. This action is idempotent, so deleting a topic that does not exist does not result in an error.

" - }, - "GetEndpointAttributes":{ - "name":"GetEndpointAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetEndpointAttributesInput"}, - "output":{ - "shape":"GetEndpointAttributesResponse", - "resultWrapper":"GetEndpointAttributesResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Retrieves the endpoint attributes for a device on one of the supported push notification services, such as GCM and APNS. For more information, see Using Amazon SNS Mobile Push Notifications.

" - }, - "GetPlatformApplicationAttributes":{ - "name":"GetPlatformApplicationAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPlatformApplicationAttributesInput"}, - "output":{ - "shape":"GetPlatformApplicationAttributesResponse", - "resultWrapper":"GetPlatformApplicationAttributesResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Retrieves the attributes of the platform application object for the supported push notification services, such as APNS and GCM. For more information, see Using Amazon SNS Mobile Push Notifications.

" - }, - "GetSMSAttributes":{ - "name":"GetSMSAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSMSAttributesInput"}, - "output":{ - "shape":"GetSMSAttributesResponse", - "resultWrapper":"GetSMSAttributesResult" - }, - "errors":[ - {"shape":"ThrottledException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns the settings for sending SMS messages from your account.

These settings are set with the SetSMSAttributes action.

" - }, - "GetSubscriptionAttributes":{ - "name":"GetSubscriptionAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSubscriptionAttributesInput"}, - "output":{ - "shape":"GetSubscriptionAttributesResponse", - "resultWrapper":"GetSubscriptionAttributesResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Returns all of the properties of a subscription.

" - }, - "GetTopicAttributes":{ - "name":"GetTopicAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTopicAttributesInput"}, - "output":{ - "shape":"GetTopicAttributesResponse", - "resultWrapper":"GetTopicAttributesResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Returns all of the properties of a topic. Topic properties returned might differ based on the authorization of the user.

" - }, - "ListEndpointsByPlatformApplication":{ - "name":"ListEndpointsByPlatformApplication", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListEndpointsByPlatformApplicationInput"}, - "output":{ - "shape":"ListEndpointsByPlatformApplicationResponse", - "resultWrapper":"ListEndpointsByPlatformApplicationResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Lists the endpoints and endpoint attributes for devices in a supported push notification service, such as GCM and APNS. The results for ListEndpointsByPlatformApplication are paginated and return a limited list of endpoints, up to 100. If additional records are available after the first page results, then a NextToken string will be returned. To receive the next page, you call ListEndpointsByPlatformApplication again using the NextToken string received from the previous call. When there are no more records to return, NextToken will be null. For more information, see Using Amazon SNS Mobile Push Notifications.

This action is throttled at 30 transactions per second (TPS).

" - }, - "ListPhoneNumbersOptedOut":{ - "name":"ListPhoneNumbersOptedOut", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPhoneNumbersOptedOutInput"}, - "output":{ - "shape":"ListPhoneNumbersOptedOutResponse", - "resultWrapper":"ListPhoneNumbersOptedOutResult" - }, - "errors":[ - {"shape":"ThrottledException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns a list of phone numbers that are opted out, meaning you cannot send SMS messages to them.

The results for ListPhoneNumbersOptedOut are paginated, and each page returns up to 100 phone numbers. If additional phone numbers are available after the first page of results, then a NextToken string will be returned. To receive the next page, you call ListPhoneNumbersOptedOut again using the NextToken string received from the previous call. When there are no more records to return, NextToken will be null.

" - }, - "ListPlatformApplications":{ - "name":"ListPlatformApplications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListPlatformApplicationsInput"}, - "output":{ - "shape":"ListPlatformApplicationsResponse", - "resultWrapper":"ListPlatformApplicationsResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Lists the platform application objects for the supported push notification services, such as APNS and GCM. The results for ListPlatformApplications are paginated and return a limited list of applications, up to 100. If additional records are available after the first page results, then a NextToken string will be returned. To receive the next page, you call ListPlatformApplications using the NextToken string received from the previous call. When there are no more records to return, NextToken will be null. For more information, see Using Amazon SNS Mobile Push Notifications.

This action is throttled at 15 transactions per second (TPS).

" - }, - "ListSubscriptions":{ - "name":"ListSubscriptions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSubscriptionsInput"}, - "output":{ - "shape":"ListSubscriptionsResponse", - "resultWrapper":"ListSubscriptionsResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Returns a list of the requester's subscriptions. Each call returns a limited list of subscriptions, up to 100. If there are more subscriptions, a NextToken is also returned. Use the NextToken parameter in a new ListSubscriptions call to get further results.

This action is throttled at 30 transactions per second (TPS).

" - }, - "ListSubscriptionsByTopic":{ - "name":"ListSubscriptionsByTopic", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSubscriptionsByTopicInput"}, - "output":{ - "shape":"ListSubscriptionsByTopicResponse", - "resultWrapper":"ListSubscriptionsByTopicResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Returns a list of the subscriptions to a specific topic. Each call returns a limited list of subscriptions, up to 100. If there are more subscriptions, a NextToken is also returned. Use the NextToken parameter in a new ListSubscriptionsByTopic call to get further results.

This action is throttled at 30 transactions per second (TPS).

" - }, - "ListTopics":{ - "name":"ListTopics", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTopicsInput"}, - "output":{ - "shape":"ListTopicsResponse", - "resultWrapper":"ListTopicsResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Returns a list of the requester's topics. Each call returns a limited list of topics, up to 100. If there are more topics, a NextToken is also returned. Use the NextToken parameter in a new ListTopics call to get further results.

This action is throttled at 30 transactions per second (TPS).

" - }, - "OptInPhoneNumber":{ - "name":"OptInPhoneNumber", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"OptInPhoneNumberInput"}, - "output":{ - "shape":"OptInPhoneNumberResponse", - "resultWrapper":"OptInPhoneNumberResult" - }, - "errors":[ - {"shape":"ThrottledException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"InvalidParameterException"} - ], - "documentation":"

Use this request to opt in a phone number that is opted out, which enables you to resume sending SMS messages to the number.

You can opt in a phone number only once every 30 days.

" - }, - "Publish":{ - "name":"Publish", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PublishInput"}, - "output":{ - "shape":"PublishResponse", - "resultWrapper":"PublishResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InvalidParameterValueException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"EndpointDisabledException"}, - {"shape":"PlatformApplicationDisabledException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Sends a message to an Amazon SNS topic or sends a text message (SMS message) directly to a phone number.

If you send a message to a topic, Amazon SNS delivers the message to each endpoint that is subscribed to the topic. The format of the message depends on the notification protocol for each subscribed endpoint.

When a messageId is returned, the message has been saved and Amazon SNS will attempt to deliver it shortly.

To use the Publish action for sending a message to a mobile endpoint, such as an app on a Kindle device or mobile phone, you must specify the EndpointArn for the TargetArn parameter. The EndpointArn is returned when making a call with the CreatePlatformEndpoint action.

For more information about formatting messages, see Send Custom Platform-Specific Payloads in Messages to Mobile Devices.

" - }, - "RemovePermission":{ - "name":"RemovePermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemovePermissionInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Removes a statement from a topic's access control policy.

" - }, - "SetEndpointAttributes":{ - "name":"SetEndpointAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetEndpointAttributesInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Sets the attributes for an endpoint for a device on one of the supported push notification services, such as GCM and APNS. For more information, see Using Amazon SNS Mobile Push Notifications.

" - }, - "SetPlatformApplicationAttributes":{ - "name":"SetPlatformApplicationAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetPlatformApplicationAttributesInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Sets the attributes of the platform application object for the supported push notification services, such as APNS and GCM. For more information, see Using Amazon SNS Mobile Push Notifications. For information on configuring attributes for message delivery status, see Using Amazon SNS Application Attributes for Message Delivery Status.

" - }, - "SetSMSAttributes":{ - "name":"SetSMSAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetSMSAttributesInput"}, - "output":{ - "shape":"SetSMSAttributesResponse", - "resultWrapper":"SetSMSAttributesResult" - }, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"ThrottledException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Use this request to set the default settings for sending SMS messages and receiving daily SMS usage reports.

You can override some of these settings for a single message when you use the Publish action with the MessageAttributes.entry.N parameter. For more information, see Sending an SMS Message in the Amazon SNS Developer Guide.

" - }, - "SetSubscriptionAttributes":{ - "name":"SetSubscriptionAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetSubscriptionAttributesInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"FilterPolicyLimitExceededException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Allows a subscription owner to set an attribute of the subscription to a new value.

" - }, - "SetTopicAttributes":{ - "name":"SetTopicAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetTopicAttributesInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Allows a topic owner to set an attribute of the topic to a new value.

" - }, - "Subscribe":{ - "name":"Subscribe", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SubscribeInput"}, - "output":{ - "shape":"SubscribeResponse", - "resultWrapper":"SubscribeResult" - }, - "errors":[ - {"shape":"SubscriptionLimitExceededException"}, - {"shape":"FilterPolicyLimitExceededException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"NotFoundException"}, - {"shape":"AuthorizationErrorException"} - ], - "documentation":"

Prepares to subscribe an endpoint by sending the endpoint a confirmation message. To actually create a subscription, the endpoint owner must call the ConfirmSubscription action with the token from the confirmation message. Confirmation tokens are valid for three days.

This action is throttled at 100 transactions per second (TPS).

" - }, - "Unsubscribe":{ - "name":"Unsubscribe", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UnsubscribeInput"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"InternalErrorException"}, - {"shape":"AuthorizationErrorException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Deletes a subscription. If the subscription requires authentication for deletion, only the owner of the subscription or the topic's owner can unsubscribe, and an AWS signature is required. If the Unsubscribe call does not require authentication and the requester is not the subscription owner, a final cancellation message is delivered to the endpoint, so that the endpoint owner can easily resubscribe to the topic if the Unsubscribe request was unintended.

This action is throttled at 100 transactions per second (TPS).

" - } - }, - "shapes":{ - "ActionsList":{ - "type":"list", - "member":{"shape":"action"} - }, - "AddPermissionInput":{ - "type":"structure", - "required":[ - "TopicArn", - "Label", - "AWSAccountId", - "ActionName" - ], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic whose access control policy you wish to modify.

" - }, - "Label":{ - "shape":"label", - "documentation":"

A unique identifier for the new policy statement.

" - }, - "AWSAccountId":{ - "shape":"DelegatesList", - "documentation":"

The AWS account IDs of the users (principals) who will be given access to the specified actions. The users must have AWS accounts, but do not need to be signed up for this service.

" - }, - "ActionName":{ - "shape":"ActionsList", - "documentation":"

The action you want to allow for the specified principal(s).

Valid values: any Amazon SNS action name.

" - } - } - }, - "AuthorizationErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that the user has been denied access to the requested resource.

", - "error":{ - "code":"AuthorizationError", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "Binary":{"type":"blob"}, - "CheckIfPhoneNumberIsOptedOutInput":{ - "type":"structure", - "required":["phoneNumber"], - "members":{ - "phoneNumber":{ - "shape":"PhoneNumber", - "documentation":"

The phone number for which you want to check the opt out status.

" - } - }, - "documentation":"

The input for the CheckIfPhoneNumberIsOptedOut action.

" - }, - "CheckIfPhoneNumberIsOptedOutResponse":{ - "type":"structure", - "members":{ - "isOptedOut":{ - "shape":"boolean", - "documentation":"

Indicates whether the phone number is opted out:

  • true – The phone number is opted out, meaning you cannot publish SMS messages to it.

  • false – The phone number is opted in, meaning you can publish SMS messages to it.

" - } - }, - "documentation":"

The response from the CheckIfPhoneNumberIsOptedOut action.

" - }, - "ConfirmSubscriptionInput":{ - "type":"structure", - "required":[ - "TopicArn", - "Token" - ], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic for which you wish to confirm a subscription.

" - }, - "Token":{ - "shape":"token", - "documentation":"

Short-lived token sent to an endpoint during the Subscribe action.

" - }, - "AuthenticateOnUnsubscribe":{ - "shape":"authenticateOnUnsubscribe", - "documentation":"

Disallows unauthenticated unsubscribes of the subscription. If the value of this parameter is true and the request has an AWS signature, then only the topic owner and the subscription owner can unsubscribe the endpoint. The unsubscribe action requires AWS authentication.

" - } - }, - "documentation":"

Input for ConfirmSubscription action.

" - }, - "ConfirmSubscriptionResponse":{ - "type":"structure", - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The ARN of the created subscription.

" - } - }, - "documentation":"

Response for ConfirmSubscriptions action.

" - }, - "CreateEndpointResponse":{ - "type":"structure", - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

EndpointArn returned from CreateEndpoint action.

" - } - }, - "documentation":"

Response from CreateEndpoint action.

" - }, - "CreatePlatformApplicationInput":{ - "type":"structure", - "required":[ - "Name", - "Platform", - "Attributes" - ], - "members":{ - "Name":{ - "shape":"String", - "documentation":"

Application names must be made up of only uppercase and lowercase ASCII letters, numbers, underscores, hyphens, and periods, and must be between 1 and 256 characters long.

" - }, - "Platform":{ - "shape":"String", - "documentation":"

The following platforms are supported: ADM (Amazon Device Messaging), APNS (Apple Push Notification Service), APNS_SANDBOX, and GCM (Google Cloud Messaging).

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

For a list of attributes, see SetPlatformApplicationAttributes

" - } - }, - "documentation":"

Input for CreatePlatformApplication action.

" - }, - "CreatePlatformApplicationResponse":{ - "type":"structure", - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn is returned.

" - } - }, - "documentation":"

Response from CreatePlatformApplication action.

" - }, - "CreatePlatformEndpointInput":{ - "type":"structure", - "required":[ - "PlatformApplicationArn", - "Token" - ], - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn returned from CreatePlatformApplication is used to create a an endpoint.

" - }, - "Token":{ - "shape":"String", - "documentation":"

Unique identifier created by the notification service for an app on a device. The specific name for Token will vary, depending on which notification service is being used. For example, when using APNS as the notification service, you need the device token. Alternatively, when using GCM or ADM, the device token equivalent is called the registration ID.

" - }, - "CustomUserData":{ - "shape":"String", - "documentation":"

Arbitrary user data to associate with the endpoint. Amazon SNS does not use this data. The data must be in UTF-8 format and less than 2KB.

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

For a list of attributes, see SetEndpointAttributes.

" - } - }, - "documentation":"

Input for CreatePlatformEndpoint action.

" - }, - "CreateTopicInput":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"topicName", - "documentation":"

The name of the topic you want to create.

Constraints: Topic names must be made up of only uppercase and lowercase ASCII letters, numbers, underscores, and hyphens, and must be between 1 and 256 characters long.

" - } - }, - "documentation":"

Input for CreateTopic action.

" - }, - "CreateTopicResponse":{ - "type":"structure", - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The Amazon Resource Name (ARN) assigned to the created topic.

" - } - }, - "documentation":"

Response from CreateTopic action.

" - }, - "DelegatesList":{ - "type":"list", - "member":{"shape":"delegate"} - }, - "DeleteEndpointInput":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

EndpointArn of endpoint to delete.

" - } - }, - "documentation":"

Input for DeleteEndpoint action.

" - }, - "DeletePlatformApplicationInput":{ - "type":"structure", - "required":["PlatformApplicationArn"], - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn of platform application object to delete.

" - } - }, - "documentation":"

Input for DeletePlatformApplication action.

" - }, - "DeleteTopicInput":{ - "type":"structure", - "required":["TopicArn"], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic you want to delete.

" - } - } - }, - "Endpoint":{ - "type":"structure", - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

EndpointArn for mobile app and device.

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

Attributes for endpoint.

" - } - }, - "documentation":"

Endpoint for mobile app and device.

" - }, - "EndpointDisabledException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

Message for endpoint disabled.

" - } - }, - "documentation":"

Exception error indicating endpoint disabled.

", - "error":{ - "code":"EndpointDisabled", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "FilterPolicyLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that the number of filter polices in your AWS account exceeds the limit. To add more filter polices, submit an SNS Limit Increase case in the AWS Support Center.

", - "error":{ - "code":"FilterPolicyLimitExceeded", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "GetEndpointAttributesInput":{ - "type":"structure", - "required":["EndpointArn"], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

EndpointArn for GetEndpointAttributes input.

" - } - }, - "documentation":"

Input for GetEndpointAttributes action.

" - }, - "GetEndpointAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

Attributes include the following:

  • CustomUserData -- arbitrary user data to associate with the endpoint. Amazon SNS does not use this data. The data must be in UTF-8 format and less than 2KB.

  • Enabled -- flag that enables/disables delivery to the endpoint. Amazon SNS will set this to false when a notification service indicates to Amazon SNS that the endpoint is invalid. Users can set it back to true, typically after updating Token.

  • Token -- device token, also referred to as a registration id, for an app and mobile device. This is returned from the notification service when an app and mobile device are registered with the notification service.

" - } - }, - "documentation":"

Response from GetEndpointAttributes of the EndpointArn.

" - }, - "GetPlatformApplicationAttributesInput":{ - "type":"structure", - "required":["PlatformApplicationArn"], - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn for GetPlatformApplicationAttributesInput.

" - } - }, - "documentation":"

Input for GetPlatformApplicationAttributes action.

" - }, - "GetPlatformApplicationAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

Attributes include the following:

  • EventEndpointCreated -- Topic ARN to which EndpointCreated event notifications should be sent.

  • EventEndpointDeleted -- Topic ARN to which EndpointDeleted event notifications should be sent.

  • EventEndpointUpdated -- Topic ARN to which EndpointUpdate event notifications should be sent.

  • EventDeliveryFailure -- Topic ARN to which DeliveryFailure event notifications should be sent upon Direct Publish delivery failure (permanent) to one of the application's endpoints.

" - } - }, - "documentation":"

Response for GetPlatformApplicationAttributes action.

" - }, - "GetSMSAttributesInput":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"ListString", - "documentation":"

A list of the individual attribute names, such as MonthlySpendLimit, for which you want values.

For all attribute names, see SetSMSAttributes.

If you don't use this parameter, Amazon SNS returns all SMS attributes.

" - } - }, - "documentation":"

The input for the GetSMSAttributes request.

" - }, - "GetSMSAttributesResponse":{ - "type":"structure", - "members":{ - "attributes":{ - "shape":"MapStringToString", - "documentation":"

The SMS attribute names and their values.

" - } - }, - "documentation":"

The response from the GetSMSAttributes request.

" - }, - "GetSubscriptionAttributesInput":{ - "type":"structure", - "required":["SubscriptionArn"], - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The ARN of the subscription whose properties you want to get.

" - } - }, - "documentation":"

Input for GetSubscriptionAttributes.

" - }, - "GetSubscriptionAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"SubscriptionAttributesMap", - "documentation":"

A map of the subscription's attributes. Attributes in this map include the following:

  • ConfirmationWasAuthenticated -- true if the subscription confirmation request was authenticated.

  • DeliveryPolicy -- The JSON serialization of the subscription's delivery policy.

  • EffectiveDeliveryPolicy -- The JSON serialization of the effective delivery policy that takes into account the topic delivery policy and account system defaults.

  • FilterPolicy -- The filter policy JSON that is assigned to the subscription.

  • Owner -- The AWS account ID of the subscription's owner.

  • PendingConfirmation -- true if the subscription hasn't been confirmed. To confirm a pending subscription, call the ConfirmSubscription action with a confirmation token.

  • RawMessageDelivery -- true if raw message delivery is enabled for the subscription. Raw messages are free of JSON formatting and can be sent to HTTP/S and Amazon SQS endpoints.

  • SubscriptionArn -- The subscription's ARN.

  • TopicArn -- The topic ARN that the subscription is associated with.

" - } - }, - "documentation":"

Response for GetSubscriptionAttributes action.

" - }, - "GetTopicAttributesInput":{ - "type":"structure", - "required":["TopicArn"], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic whose properties you want to get.

" - } - }, - "documentation":"

Input for GetTopicAttributes action.

" - }, - "GetTopicAttributesResponse":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"TopicAttributesMap", - "documentation":"

A map of the topic's attributes. Attributes in this map include the following:

  • TopicArn -- the topic's ARN

  • Owner -- the AWS account ID of the topic's owner

  • Policy -- the JSON serialization of the topic's access control policy

  • DisplayName -- the human-readable name used in the \"From\" field for notifications to email and email-json endpoints

  • SubscriptionsPending -- the number of subscriptions pending confirmation on this topic

  • SubscriptionsConfirmed -- the number of confirmed subscriptions on this topic

  • SubscriptionsDeleted -- the number of deleted subscriptions on this topic

  • DeliveryPolicy -- the JSON serialization of the topic's delivery policy

  • EffectiveDeliveryPolicy -- the JSON serialization of the effective delivery policy that takes into account system defaults

" - } - }, - "documentation":"

Response for GetTopicAttributes action.

" - }, - "InternalErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates an internal service error.

", - "error":{ - "code":"InternalError", - "httpStatusCode":500 - }, - "exception":true, - "fault":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that a request parameter does not comply with the associated constraints.

", - "error":{ - "code":"InvalidParameter", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidParameterValueException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

The parameter value is invalid.

" - } - }, - "documentation":"

Indicates that a request parameter does not comply with the associated constraints.

", - "error":{ - "code":"ParameterValueInvalid", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "ListEndpointsByPlatformApplicationInput":{ - "type":"structure", - "required":["PlatformApplicationArn"], - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn for ListEndpointsByPlatformApplicationInput action.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken string is used when calling ListEndpointsByPlatformApplication action to retrieve additional records that are available after the first page results.

" - } - }, - "documentation":"

Input for ListEndpointsByPlatformApplication action.

" - }, - "ListEndpointsByPlatformApplicationResponse":{ - "type":"structure", - "members":{ - "Endpoints":{ - "shape":"ListOfEndpoints", - "documentation":"

Endpoints returned for ListEndpointsByPlatformApplication action.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken string is returned when calling ListEndpointsByPlatformApplication action if additional records are available after the first page results.

" - } - }, - "documentation":"

Response for ListEndpointsByPlatformApplication action.

" - }, - "ListOfEndpoints":{ - "type":"list", - "member":{"shape":"Endpoint"} - }, - "ListOfPlatformApplications":{ - "type":"list", - "member":{"shape":"PlatformApplication"} - }, - "ListPhoneNumbersOptedOutInput":{ - "type":"structure", - "members":{ - "nextToken":{ - "shape":"string", - "documentation":"

A NextToken string is used when you call the ListPhoneNumbersOptedOut action to retrieve additional records that are available after the first page of results.

" - } - }, - "documentation":"

The input for the ListPhoneNumbersOptedOut action.

" - }, - "ListPhoneNumbersOptedOutResponse":{ - "type":"structure", - "members":{ - "phoneNumbers":{ - "shape":"PhoneNumberList", - "documentation":"

A list of phone numbers that are opted out of receiving SMS messages. The list is paginated, and each page can contain up to 100 phone numbers.

" - }, - "nextToken":{ - "shape":"string", - "documentation":"

A NextToken string is returned when you call the ListPhoneNumbersOptedOut action if additional records are available after the first page of results.

" - } - }, - "documentation":"

The response from the ListPhoneNumbersOptedOut action.

" - }, - "ListPlatformApplicationsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"String", - "documentation":"

NextToken string is used when calling ListPlatformApplications action to retrieve additional records that are available after the first page results.

" - } - }, - "documentation":"

Input for ListPlatformApplications action.

" - }, - "ListPlatformApplicationsResponse":{ - "type":"structure", - "members":{ - "PlatformApplications":{ - "shape":"ListOfPlatformApplications", - "documentation":"

Platform applications returned when calling ListPlatformApplications action.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

NextToken string is returned when calling ListPlatformApplications action if additional records are available after the first page results.

" - } - }, - "documentation":"

Response for ListPlatformApplications action.

" - }, - "ListString":{ - "type":"list", - "member":{"shape":"String"} - }, - "ListSubscriptionsByTopicInput":{ - "type":"structure", - "required":["TopicArn"], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic for which you wish to find subscriptions.

" - }, - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token returned by the previous ListSubscriptionsByTopic request.

" - } - }, - "documentation":"

Input for ListSubscriptionsByTopic action.

" - }, - "ListSubscriptionsByTopicResponse":{ - "type":"structure", - "members":{ - "Subscriptions":{ - "shape":"SubscriptionsList", - "documentation":"

A list of subscriptions.

" - }, - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token to pass along to the next ListSubscriptionsByTopic request. This element is returned if there are more subscriptions to retrieve.

" - } - }, - "documentation":"

Response for ListSubscriptionsByTopic action.

" - }, - "ListSubscriptionsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token returned by the previous ListSubscriptions request.

" - } - }, - "documentation":"

Input for ListSubscriptions action.

" - }, - "ListSubscriptionsResponse":{ - "type":"structure", - "members":{ - "Subscriptions":{ - "shape":"SubscriptionsList", - "documentation":"

A list of subscriptions.

" - }, - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token to pass along to the next ListSubscriptions request. This element is returned if there are more subscriptions to retrieve.

" - } - }, - "documentation":"

Response for ListSubscriptions action

" - }, - "ListTopicsInput":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token returned by the previous ListTopics request.

" - } - } - }, - "ListTopicsResponse":{ - "type":"structure", - "members":{ - "Topics":{ - "shape":"TopicsList", - "documentation":"

A list of topic ARNs.

" - }, - "NextToken":{ - "shape":"nextToken", - "documentation":"

Token to pass along to the next ListTopics request. This element is returned if there are additional topics to retrieve.

" - } - }, - "documentation":"

Response for ListTopics action.

" - }, - "MapStringToString":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "MessageAttributeMap":{ - "type":"map", - "key":{ - "shape":"String", - "locationName":"Name" - }, - "value":{ - "shape":"MessageAttributeValue", - "locationName":"Value" - } - }, - "MessageAttributeValue":{ - "type":"structure", - "required":["DataType"], - "members":{ - "DataType":{ - "shape":"String", - "documentation":"

Amazon SNS supports the following logical data types: String, String.Array, Number, and Binary. For more information, see Message Attribute Data Types.

" - }, - "StringValue":{ - "shape":"String", - "documentation":"

Strings are Unicode with UTF8 binary encoding. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

" - }, - "BinaryValue":{ - "shape":"Binary", - "documentation":"

Binary type attributes can store any binary data, for example, compressed data, encrypted data, or images.

" - } - }, - "documentation":"

The user-specified message attribute value. For string data types, the value attribute has the same restrictions on the content as the message body. For more information, see Publish.

Name, type, and value must not be empty or null. In addition, the message body should not be empty or null. All parts of the message attribute, including name, type, and value, are included in the message size restriction, which is currently 256 KB (262,144 bytes). For more information, see Using Amazon SNS Message Attributes.

" - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that the requested resource does not exist.

", - "error":{ - "code":"NotFound", - "httpStatusCode":404, - "senderFault":true - }, - "exception":true - }, - "OptInPhoneNumberInput":{ - "type":"structure", - "required":["phoneNumber"], - "members":{ - "phoneNumber":{ - "shape":"PhoneNumber", - "documentation":"

The phone number to opt in.

" - } - }, - "documentation":"

Input for the OptInPhoneNumber action.

" - }, - "OptInPhoneNumberResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response for the OptInPhoneNumber action.

" - }, - "PhoneNumber":{"type":"string"}, - "PhoneNumberList":{ - "type":"list", - "member":{"shape":"PhoneNumber"} - }, - "PlatformApplication":{ - "type":"structure", - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn for platform application object.

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

Attributes for platform application object.

" - } - }, - "documentation":"

Platform application object.

" - }, - "PlatformApplicationDisabledException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

Message for platform application disabled.

" - } - }, - "documentation":"

Exception error indicating platform application disabled.

", - "error":{ - "code":"PlatformApplicationDisabled", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "PublishInput":{ - "type":"structure", - "required":["Message"], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The topic you want to publish to.

If you don't specify a value for the TopicArn parameter, you must specify a value for the PhoneNumber or TargetArn parameters.

" - }, - "TargetArn":{ - "shape":"String", - "documentation":"

Either TopicArn or EndpointArn, but not both.

If you don't specify a value for the TargetArn parameter, you must specify a value for the PhoneNumber or TopicArn parameters.

" - }, - "PhoneNumber":{ - "shape":"String", - "documentation":"

The phone number to which you want to deliver an SMS message. Use E.164 format.

If you don't specify a value for the PhoneNumber parameter, you must specify a value for the TargetArn or TopicArn parameters.

" - }, - "Message":{ - "shape":"message", - "documentation":"

The message you want to send.

If you are publishing to a topic and you want to send the same message to all transport protocols, include the text of the message as a String value. If you want to send different messages for each transport protocol, set the value of the MessageStructure parameter to json and use a JSON object for the Message parameter.

Constraints:

  • With the exception of SMS, messages must be UTF-8 encoded strings and at most 256 KB in size (262144 bytes, not 262144 characters).

  • For SMS, each message can contain up to 140 bytes, and the character limit depends on the encoding scheme. For example, an SMS message can contain 160 GSM characters, 140 ASCII characters, or 70 UCS-2 characters. If you publish a message that exceeds the size limit, Amazon SNS sends it as multiple messages, each fitting within the size limit. Messages are not cut off in the middle of a word but on whole-word boundaries. The total size limit for a single SMS publish action is 1600 bytes.

JSON-specific constraints:

  • Keys in the JSON object that correspond to supported transport protocols must have simple JSON string values.

  • The values will be parsed (unescaped) before they are used in outgoing messages.

  • Outbound notifications are JSON encoded (meaning that the characters will be reescaped for sending).

  • Values have a minimum length of 0 (the empty string, \"\", is allowed).

  • Values have a maximum length bounded by the overall message size (so, including multiple protocols may limit message sizes).

  • Non-string values will cause the key to be ignored.

  • Keys that do not correspond to supported transport protocols are ignored.

  • Duplicate keys are not allowed.

  • Failure to parse or validate any key or value in the message will cause the Publish call to return an error (no partial delivery).

" - }, - "Subject":{ - "shape":"subject", - "documentation":"

Optional parameter to be used as the \"Subject\" line when the message is delivered to email endpoints. This field will also be included, if present, in the standard JSON messages delivered to other endpoints.

Constraints: Subjects must be ASCII text that begins with a letter, number, or punctuation mark; must not include line breaks or control characters; and must be less than 100 characters long.

" - }, - "MessageStructure":{ - "shape":"messageStructure", - "documentation":"

Set MessageStructure to json if you want to send a different message for each protocol. For example, using one publish action, you can send a short message to your SMS subscribers and a longer message to your email subscribers. If you set MessageStructure to json, the value of the Message parameter must:

  • be a syntactically valid JSON object; and

  • contain at least a top-level JSON key of \"default\" with a value that is a string.

You can define other top-level keys that define the message you want to send to a specific transport protocol (e.g., \"http\").

For information about sending different messages for each protocol using the AWS Management Console, go to Create Different Messages for Each Protocol in the Amazon Simple Notification Service Getting Started Guide.

Valid value: json

" - }, - "MessageAttributes":{ - "shape":"MessageAttributeMap", - "documentation":"

Message attributes for Publish action.

" - } - }, - "documentation":"

Input for Publish action.

" - }, - "PublishResponse":{ - "type":"structure", - "members":{ - "MessageId":{ - "shape":"messageId", - "documentation":"

Unique identifier assigned to the published message.

Length Constraint: Maximum 100 characters

" - } - }, - "documentation":"

Response for Publish action.

" - }, - "RemovePermissionInput":{ - "type":"structure", - "required":[ - "TopicArn", - "Label" - ], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic whose access control policy you wish to modify.

" - }, - "Label":{ - "shape":"label", - "documentation":"

The unique label of the statement you want to remove.

" - } - }, - "documentation":"

Input for RemovePermission action.

" - }, - "SetEndpointAttributesInput":{ - "type":"structure", - "required":[ - "EndpointArn", - "Attributes" - ], - "members":{ - "EndpointArn":{ - "shape":"String", - "documentation":"

EndpointArn used for SetEndpointAttributes action.

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

A map of the endpoint attributes. Attributes in this map include the following:

  • CustomUserData -- arbitrary user data to associate with the endpoint. Amazon SNS does not use this data. The data must be in UTF-8 format and less than 2KB.

  • Enabled -- flag that enables/disables delivery to the endpoint. Amazon SNS will set this to false when a notification service indicates to Amazon SNS that the endpoint is invalid. Users can set it back to true, typically after updating Token.

  • Token -- device token, also referred to as a registration id, for an app and mobile device. This is returned from the notification service when an app and mobile device are registered with the notification service.

" - } - }, - "documentation":"

Input for SetEndpointAttributes action.

" - }, - "SetPlatformApplicationAttributesInput":{ - "type":"structure", - "required":[ - "PlatformApplicationArn", - "Attributes" - ], - "members":{ - "PlatformApplicationArn":{ - "shape":"String", - "documentation":"

PlatformApplicationArn for SetPlatformApplicationAttributes action.

" - }, - "Attributes":{ - "shape":"MapStringToString", - "documentation":"

A map of the platform application attributes. Attributes in this map include the following:

  • PlatformCredential -- The credential received from the notification service. For APNS/APNS_SANDBOX, PlatformCredential is private key. For GCM, PlatformCredential is \"API key\". For ADM, PlatformCredential is \"client secret\".

  • PlatformPrincipal -- The principal received from the notification service. For APNS/APNS_SANDBOX, PlatformPrincipal is SSL certificate. For GCM, PlatformPrincipal is not applicable. For ADM, PlatformPrincipal is \"client id\".

  • EventEndpointCreated -- Topic ARN to which EndpointCreated event notifications should be sent.

  • EventEndpointDeleted -- Topic ARN to which EndpointDeleted event notifications should be sent.

  • EventEndpointUpdated -- Topic ARN to which EndpointUpdate event notifications should be sent.

  • EventDeliveryFailure -- Topic ARN to which DeliveryFailure event notifications should be sent upon Direct Publish delivery failure (permanent) to one of the application's endpoints.

  • SuccessFeedbackRoleArn -- IAM role ARN used to give Amazon SNS write access to use CloudWatch Logs on your behalf.

  • FailureFeedbackRoleArn -- IAM role ARN used to give Amazon SNS write access to use CloudWatch Logs on your behalf.

  • SuccessFeedbackSampleRate -- Sample rate percentage (0-100) of successfully delivered messages.

" - } - }, - "documentation":"

Input for SetPlatformApplicationAttributes action.

" - }, - "SetSMSAttributesInput":{ - "type":"structure", - "required":["attributes"], - "members":{ - "attributes":{ - "shape":"MapStringToString", - "documentation":"

The default settings for sending SMS messages from your account. You can set values for the following attribute names:

MonthlySpendLimit – The maximum amount in USD that you are willing to spend each month to send SMS messages. When Amazon SNS determines that sending an SMS message would incur a cost that exceeds this limit, it stops sending SMS messages within minutes.

Amazon SNS stops sending SMS messages within minutes of the limit being crossed. During that interval, if you continue to send SMS messages, you will incur costs that exceed your limit.

By default, the spend limit is set to the maximum allowed by Amazon SNS. If you want to raise the limit, submit an SNS Limit Increase case. For New limit value, enter your desired monthly spend limit. In the Use Case Description field, explain that you are requesting an SMS monthly spend limit increase.

DeliveryStatusIAMRole – The ARN of the IAM role that allows Amazon SNS to write logs about SMS deliveries in CloudWatch Logs. For each SMS message that you send, Amazon SNS writes a log that includes the message price, the success or failure status, the reason for failure (if the message failed), the message dwell time, and other information.

DeliveryStatusSuccessSamplingRate – The percentage of successful SMS deliveries for which Amazon SNS will write logs in CloudWatch Logs. The value can be an integer from 0 - 100. For example, to write logs only for failed deliveries, set this value to 0. To write logs for 10% of your successful deliveries, set it to 10.

DefaultSenderID – A string, such as your business brand, that is displayed as the sender on the receiving device. Support for sender IDs varies by country. The sender ID can be 1 - 11 alphanumeric characters, and it must contain at least one letter.

DefaultSMSType – The type of SMS message that you will send by default. You can assign the following values:

  • Promotional – (Default) Noncritical messages, such as marketing messages. Amazon SNS optimizes the message delivery to incur the lowest cost.

  • Transactional – Critical messages that support customer transactions, such as one-time passcodes for multi-factor authentication. Amazon SNS optimizes the message delivery to achieve the highest reliability.

UsageReportS3Bucket – The name of the Amazon S3 bucket to receive daily SMS usage reports from Amazon SNS. Each day, Amazon SNS will deliver a usage report as a CSV file to the bucket. The report includes the following information for each SMS message that was successfully delivered by your account:

  • Time that the message was published (in UTC)

  • Message ID

  • Destination phone number

  • Message type

  • Delivery status

  • Message price (in USD)

  • Part number (a message is split into multiple parts if it is too long for a single message)

  • Total number of parts

To receive the report, the bucket must have a policy that allows the Amazon SNS service principle to perform the s3:PutObject and s3:GetBucketLocation actions.

For an example bucket policy and usage report, see Monitoring SMS Activity in the Amazon SNS Developer Guide.

" - } - }, - "documentation":"

The input for the SetSMSAttributes action.

" - }, - "SetSMSAttributesResponse":{ - "type":"structure", - "members":{ - }, - "documentation":"

The response for the SetSMSAttributes action.

" - }, - "SetSubscriptionAttributesInput":{ - "type":"structure", - "required":[ - "SubscriptionArn", - "AttributeName" - ], - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The ARN of the subscription to modify.

" - }, - "AttributeName":{ - "shape":"attributeName", - "documentation":"

The name of the attribute you want to set. Only a subset of the subscriptions attributes are mutable.

Valid values: DeliveryPolicy | FilterPolicy | RawMessageDelivery

" - }, - "AttributeValue":{ - "shape":"attributeValue", - "documentation":"

The new value for the attribute in JSON format.

" - } - }, - "documentation":"

Input for SetSubscriptionAttributes action.

" - }, - "SetTopicAttributesInput":{ - "type":"structure", - "required":[ - "TopicArn", - "AttributeName" - ], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic to modify.

" - }, - "AttributeName":{ - "shape":"attributeName", - "documentation":"

The name of the attribute you want to set. Only a subset of the topic's attributes are mutable.

Valid values: Policy | DisplayName | DeliveryPolicy

" - }, - "AttributeValue":{ - "shape":"attributeValue", - "documentation":"

The new value for the attribute.

" - } - }, - "documentation":"

Input for SetTopicAttributes action.

" - }, - "String":{"type":"string"}, - "SubscribeInput":{ - "type":"structure", - "required":[ - "TopicArn", - "Protocol" - ], - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the topic you want to subscribe to.

" - }, - "Protocol":{ - "shape":"protocol", - "documentation":"

The protocol you want to use. Supported protocols include:

  • http -- delivery of JSON-encoded message via HTTP POST

  • https -- delivery of JSON-encoded message via HTTPS POST

  • email -- delivery of message via SMTP

  • email-json -- delivery of JSON-encoded message via SMTP

  • sms -- delivery of message via SMS

  • sqs -- delivery of JSON-encoded message to an Amazon SQS queue

  • application -- delivery of JSON-encoded message to an EndpointArn for a mobile app and device.

  • lambda -- delivery of JSON-encoded message to an AWS Lambda function.

" - }, - "Endpoint":{ - "shape":"endpoint", - "documentation":"

The endpoint that you want to receive notifications. Endpoints vary by protocol:

  • For the http protocol, the endpoint is an URL beginning with \"http://\"

  • For the https protocol, the endpoint is a URL beginning with \"https://\"

  • For the email protocol, the endpoint is an email address

  • For the email-json protocol, the endpoint is an email address

  • For the sms protocol, the endpoint is a phone number of an SMS-enabled device

  • For the sqs protocol, the endpoint is the ARN of an Amazon SQS queue

  • For the application protocol, the endpoint is the EndpointArn of a mobile app and device.

  • For the lambda protocol, the endpoint is the ARN of an AWS Lambda function.

" - }, - "Attributes":{ - "shape":"SubscriptionAttributesMap", - "documentation":"

Assigns attributes to the subscription as a map of key-value pairs. You can assign any attribute that is supported by the SetSubscriptionAttributes action.

" - }, - "ReturnSubscriptionArn":{ - "shape":"boolean", - "documentation":"

Sets whether the response from the Subscribe request includes the subscription ARN, even if the subscription is not yet confirmed.

If you set this parameter to false, the response includes the ARN for confirmed subscriptions, but it includes an ARN value of \"pending subscription\" for subscriptions that are not yet confirmed. A subscription becomes confirmed when the subscriber calls the ConfirmSubscription action with a confirmation token.

If you set this parameter to true, the response includes the ARN in all cases, even if the subscription is not yet confirmed.

The default value is false.

" - } - }, - "documentation":"

Input for Subscribe action.

" - }, - "SubscribeResponse":{ - "type":"structure", - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The ARN of the subscription if it is confirmed, or the string \"pending confirmation\" if the subscription requires confirmation. However, if the API request parameter ReturnSubscriptionArn is true, then the value is always the subscription ARN, even if the subscription requires confirmation.

" - } - }, - "documentation":"

Response for Subscribe action.

" - }, - "Subscription":{ - "type":"structure", - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The subscription's ARN.

" - }, - "Owner":{ - "shape":"account", - "documentation":"

The subscription's owner.

" - }, - "Protocol":{ - "shape":"protocol", - "documentation":"

The subscription's protocol.

" - }, - "Endpoint":{ - "shape":"endpoint", - "documentation":"

The subscription's endpoint (format depends on the protocol).

" - }, - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The ARN of the subscription's topic.

" - } - }, - "documentation":"

A wrapper type for the attributes of an Amazon SNS subscription.

" - }, - "SubscriptionAttributesMap":{ - "type":"map", - "key":{"shape":"attributeName"}, - "value":{"shape":"attributeValue"} - }, - "SubscriptionLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that the customer already owns the maximum allowed number of subscriptions.

", - "error":{ - "code":"SubscriptionLimitExceeded", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "SubscriptionsList":{ - "type":"list", - "member":{"shape":"Subscription"} - }, - "ThrottledException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

Throttled request.

" - } - }, - "documentation":"

Indicates that the rate at which requests have been submitted for this action exceeds the limit for your account.

", - "error":{ - "code":"Throttled", - "httpStatusCode":429, - "senderFault":true - }, - "exception":true - }, - "Topic":{ - "type":"structure", - "members":{ - "TopicArn":{ - "shape":"topicARN", - "documentation":"

The topic's ARN.

" - } - }, - "documentation":"

A wrapper type for the topic's Amazon Resource Name (ARN). To retrieve a topic's attributes, use GetTopicAttributes.

" - }, - "TopicAttributesMap":{ - "type":"map", - "key":{"shape":"attributeName"}, - "value":{"shape":"attributeValue"} - }, - "TopicLimitExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"string"} - }, - "documentation":"

Indicates that the customer already owns the maximum allowed number of topics.

", - "error":{ - "code":"TopicLimitExceeded", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "TopicsList":{ - "type":"list", - "member":{"shape":"Topic"} - }, - "UnsubscribeInput":{ - "type":"structure", - "required":["SubscriptionArn"], - "members":{ - "SubscriptionArn":{ - "shape":"subscriptionARN", - "documentation":"

The ARN of the subscription to be deleted.

" - } - }, - "documentation":"

Input for Unsubscribe action.

" - }, - "account":{"type":"string"}, - "action":{"type":"string"}, - "attributeName":{"type":"string"}, - "attributeValue":{"type":"string"}, - "authenticateOnUnsubscribe":{"type":"string"}, - "boolean":{"type":"boolean"}, - "delegate":{"type":"string"}, - "endpoint":{"type":"string"}, - "label":{"type":"string"}, - "message":{"type":"string"}, - "messageId":{"type":"string"}, - "messageStructure":{"type":"string"}, - "nextToken":{"type":"string"}, - "protocol":{"type":"string"}, - "string":{"type":"string"}, - "subject":{"type":"string"}, - "subscriptionARN":{"type":"string"}, - "token":{"type":"string"}, - "topicARN":{"type":"string"}, - "topicName":{"type":"string"} - }, - "documentation":"Amazon Simple Notification Service

Amazon Simple Notification Service (Amazon SNS) is a web service that enables you to build distributed web-enabled applications. Applications can use Amazon SNS to easily push real-time notification messages to interested subscribers over multiple delivery protocols. For more information about this product see http://aws.amazon.com/sns. For detailed information about Amazon SNS features and their associated API calls, see the Amazon SNS Developer Guide.

We also provide SDKs that enable you to access Amazon SNS from your preferred programming language. The SDKs contain functionality that automatically takes care of tasks such as: cryptographically signing your service requests, retrying requests, and handling error responses. For a list of available SDKs, go to Tools for Amazon Web Services.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/examples-1.json deleted file mode 100644 index 9dc8ac74..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/examples-1.json +++ /dev/null @@ -1,44 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateQueue": [ - { - "input": { - "QueueName": "MyQueue" - }, - "output": { - "QueueUrl": "https://queue.amazonaws.com/012345678910/MyQueue" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following operation creates an SQS queue named MyQueue.", - "id": "create-an-sqs-queue-1445915686197", - "title": "Create an SQS queue" - } - ], - "GetQueueUrl": [ - { - "input": { - "QueueName": "MyQueue", - "QueueOwnerAWSAccountId": "12345678910" - }, - "output": { - "QueueUrl": "https://queue.amazonaws.com/123456789101112/MyQueue" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example retrieves the queue ARN.", - "id": "retrieve-queue-attributes-from-an-sqs-queue-1445915930574", - "title": "Retrieve queue attributes from an SQS queue" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/service-2.json deleted file mode 100644 index 2301a77a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sqs/2012-11-05/service-2.json +++ /dev/null @@ -1,1424 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-11-05", - "endpointPrefix":"sqs", - "protocol":"query", - "serviceAbbreviation":"Amazon SQS", - "serviceFullName":"Amazon Simple Queue Service", - "serviceId":"SQS", - "signatureVersion":"v4", - "uid":"sqs-2012-11-05", - "xmlNamespace":"http://queue.amazonaws.com/doc/2012-11-05/" - }, - "operations":{ - "AddPermission":{ - "name":"AddPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddPermissionRequest"}, - "errors":[ - {"shape":"OverLimit"} - ], - "documentation":"

Adds a permission to a queue for a specific principal. This allows sharing access to the queue.

When you create a queue, you have full control access rights for the queue. Only you, the owner of the queue, can grant or deny permissions to the queue. For more information about these permissions, see Shared Queues in the Amazon Simple Queue Service Developer Guide.

AddPermission writes an Amazon-SQS-generated policy. If you want to write your own policy, use SetQueueAttributes to upload your policy. For more information about writing your own policy, see Using The Access Policy Language in the Amazon Simple Queue Service Developer Guide.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "ChangeMessageVisibility":{ - "name":"ChangeMessageVisibility", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ChangeMessageVisibilityRequest"}, - "errors":[ - {"shape":"MessageNotInflight"}, - {"shape":"ReceiptHandleIsInvalid"} - ], - "documentation":"

Changes the visibility timeout of a specified message in a queue to a new value. The maximum allowed timeout value is 12 hours. Thus, you can't extend the timeout of a message in an existing queue to more than a total visibility timeout of 12 hours. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

For example, you have a message with a visibility timeout of 5 minutes. After 3 minutes, you call ChangeMessageVisiblity with a timeout of 10 minutes. At that time, the timeout for the message is extended by 10 minutes beyond the time of the ChangeMessageVisibility action. This results in a total visibility timeout of 13 minutes. You can continue to call the ChangeMessageVisibility to extend the visibility timeout to a maximum of 12 hours. If you try to extend the visibility timeout beyond 12 hours, your request is rejected.

A message is considered to be in flight after it's received from a queue by a consumer, but not yet deleted from the queue.

For standard queues, there can be a maximum of 120,000 inflight messages per queue. If you reach this limit, Amazon SQS returns the OverLimit error message. To avoid reaching the limit, you should delete messages from the queue after they're processed. You can also increase the number of queues you use to process your messages.

For FIFO queues, there can be a maximum of 20,000 inflight messages per queue. If you reach this limit, Amazon SQS returns no error messages.

If you attempt to set the VisibilityTimeout to a value greater than the maximum time left, Amazon SQS returns an error. Amazon SQS doesn't automatically recalculate and increase the timeout to the maximum remaining time.

Unlike with a queue, when you change the visibility timeout for a specific message the timeout value is applied immediately but isn't saved in memory for that message. If you don't delete a message after it is received, the visibility timeout for the message reverts to the original timeout value (not to the value you set using the ChangeMessageVisibility action) the next time the message is received.

" - }, - "ChangeMessageVisibilityBatch":{ - "name":"ChangeMessageVisibilityBatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ChangeMessageVisibilityBatchRequest"}, - "output":{ - "shape":"ChangeMessageVisibilityBatchResult", - "resultWrapper":"ChangeMessageVisibilityBatchResult" - }, - "errors":[ - {"shape":"TooManyEntriesInBatchRequest"}, - {"shape":"EmptyBatchRequest"}, - {"shape":"BatchEntryIdsNotDistinct"}, - {"shape":"InvalidBatchEntryId"} - ], - "documentation":"

Changes the visibility timeout of multiple messages. This is a batch version of ChangeMessageVisibility. The result of the action on each message is reported individually in the response. You can send up to 10 ChangeMessageVisibility requests with each ChangeMessageVisibilityBatch action.

Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "CreateQueue":{ - "name":"CreateQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateQueueRequest"}, - "output":{ - "shape":"CreateQueueResult", - "resultWrapper":"CreateQueueResult" - }, - "errors":[ - {"shape":"QueueDeletedRecently"}, - {"shape":"QueueNameExists"} - ], - "documentation":"

Creates a new standard or FIFO queue. You can pass one or more attributes in the request. Keep the following caveats in mind:

  • If you don't specify the FifoQueue attribute, Amazon SQS creates a standard queue.

    You can't change the queue type after you create it and you can't convert an existing standard queue into a FIFO queue. You must either create a new FIFO queue for your application or delete your existing standard queue and recreate it as a FIFO queue. For more information, see Moving From a Standard Queue to a FIFO Queue in the Amazon Simple Queue Service Developer Guide.

  • If you don't provide a value for an attribute, the queue is created with the default value for the attribute.

  • If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

To successfully create a new queue, you must provide a queue name that adheres to the limits related to queues and is unique within the scope of your queues.

To get the queue URL, use the GetQueueUrl action. GetQueueUrl requires only the QueueName parameter. be aware of existing queue names:

  • If you provide the name of an existing queue along with the exact names and values of all the queue's attributes, CreateQueue returns the queue URL for the existing queue.

  • If the queue name, attribute names, or attribute values don't match an existing queue, CreateQueue returns an error.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "DeleteMessage":{ - "name":"DeleteMessage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMessageRequest"}, - "errors":[ - {"shape":"InvalidIdFormat"}, - {"shape":"ReceiptHandleIsInvalid"} - ], - "documentation":"

Deletes the specified message from the specified queue. You specify the message by using the message's receipt handle and not the MessageId you receive when you send the message. Even if the message is locked by another reader due to the visibility timeout setting, it is still deleted from the queue. If you leave a message in the queue for longer than the queue's configured retention period, Amazon SQS automatically deletes the message.

The receipt handle is associated with a specific instance of receiving the message. If you receive a message more than once, the receipt handle you get each time you receive the message is different. If you don't provide the most recently received receipt handle for the message when you use the DeleteMessage action, the request succeeds, but the message might not be deleted.

For standard queues, it is possible to receive a message even after you delete it. This might happen on rare occasions if one of the servers storing a copy of the message is unavailable when you send the request to delete the message. The copy remains on the server and might be returned to you on a subsequent receive request. You should ensure that your application is idempotent, so that receiving a message more than once does not cause issues.

" - }, - "DeleteMessageBatch":{ - "name":"DeleteMessageBatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMessageBatchRequest"}, - "output":{ - "shape":"DeleteMessageBatchResult", - "resultWrapper":"DeleteMessageBatchResult" - }, - "errors":[ - {"shape":"TooManyEntriesInBatchRequest"}, - {"shape":"EmptyBatchRequest"}, - {"shape":"BatchEntryIdsNotDistinct"}, - {"shape":"InvalidBatchEntryId"} - ], - "documentation":"

Deletes up to ten messages from the specified queue. This is a batch version of DeleteMessage. The result of the action on each message is reported individually in the response.

Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "DeleteQueue":{ - "name":"DeleteQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteQueueRequest"}, - "documentation":"

Deletes the queue specified by the QueueUrl, regardless of the queue's contents. If the specified queue doesn't exist, Amazon SQS returns a successful response.

Be careful with the DeleteQueue action: When you delete a queue, any messages in the queue are no longer available.

When you delete a queue, the deletion process takes up to 60 seconds. Requests you send involving that queue during the 60 seconds might succeed. For example, a SendMessage request might succeed, but after 60 seconds the queue and the message you sent no longer exist.

When you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

" - }, - "GetQueueAttributes":{ - "name":"GetQueueAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQueueAttributesRequest"}, - "output":{ - "shape":"GetQueueAttributesResult", - "resultWrapper":"GetQueueAttributesResult" - }, - "errors":[ - {"shape":"InvalidAttributeName"} - ], - "documentation":"

Gets attributes for the specified queue.

To determine whether a queue is FIFO, you can check whether QueueName ends with the .fifo suffix.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "GetQueueUrl":{ - "name":"GetQueueUrl", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetQueueUrlRequest"}, - "output":{ - "shape":"GetQueueUrlResult", - "resultWrapper":"GetQueueUrlResult" - }, - "errors":[ - {"shape":"QueueDoesNotExist"} - ], - "documentation":"

Returns the URL of an existing queue. This action provides a simple way to retrieve the URL of an Amazon SQS queue.

To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId parameter to specify the account ID of the queue's owner. The queue's owner must grant you permission to access the queue. For more information about shared queue access, see AddPermission or see Shared Queues in the Amazon Simple Queue Service Developer Guide.

" - }, - "ListDeadLetterSourceQueues":{ - "name":"ListDeadLetterSourceQueues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDeadLetterSourceQueuesRequest"}, - "output":{ - "shape":"ListDeadLetterSourceQueuesResult", - "resultWrapper":"ListDeadLetterSourceQueuesResult" - }, - "errors":[ - {"shape":"QueueDoesNotExist"} - ], - "documentation":"

Returns a list of your queues that have the RedrivePolicy queue attribute configured with a dead-letter queue.

For more information about using dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

" - }, - "ListQueueTags":{ - "name":"ListQueueTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListQueueTagsRequest"}, - "output":{ - "shape":"ListQueueTagsResult", - "resultWrapper":"ListQueueTagsResult" - }, - "documentation":"

List all cost allocation tags added to the specified Amazon SQS queue. For an overview, see Tagging Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

When you use queue tags, keep the following guidelines in mind:

  • Adding more than 50 tags to a queue isn't recommended.

  • Tags don't have any semantic meaning. Amazon SQS interprets tags as character strings.

  • Tags are case-sensitive.

  • A new tag with a key identical to that of an existing tag overwrites the existing tag.

  • Tagging API actions are limited to 5 TPS per AWS account. If your application requires a higher throughput, file a technical support request.

For a full list of tag restrictions, see Limits Related to Queues in the Amazon Simple Queue Service Developer Guide.

" - }, - "ListQueues":{ - "name":"ListQueues", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListQueuesRequest"}, - "output":{ - "shape":"ListQueuesResult", - "resultWrapper":"ListQueuesResult" - }, - "documentation":"

Returns a list of your queues. The maximum number of queues that can be returned is 1,000. If you specify a value for the optional QueueNamePrefix parameter, only queues with a name that begins with the specified value are returned.

" - }, - "PurgeQueue":{ - "name":"PurgeQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PurgeQueueRequest"}, - "errors":[ - {"shape":"QueueDoesNotExist"}, - {"shape":"PurgeQueueInProgress"} - ], - "documentation":"

Deletes the messages in a queue specified by the QueueURL parameter.

When you use the PurgeQueue action, you can't retrieve a message deleted from a queue.

When you purge a queue, the message deletion process takes up to 60 seconds. All messages sent to the queue before calling the PurgeQueue action are deleted. Messages sent to the queue while it is being purged might be deleted. While the queue is being purged, messages sent to the queue before PurgeQueue is called might be received, but are deleted within the next minute.

" - }, - "ReceiveMessage":{ - "name":"ReceiveMessage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ReceiveMessageRequest"}, - "output":{ - "shape":"ReceiveMessageResult", - "resultWrapper":"ReceiveMessageResult" - }, - "errors":[ - {"shape":"OverLimit"} - ], - "documentation":"

Retrieves one or more messages (up to 10), from the specified queue. Using the WaitTimeSeconds parameter enables long-poll support. For more information, see Amazon SQS Long Polling in the Amazon Simple Queue Service Developer Guide.

Short poll is the default behavior where a weighted random set of machines is sampled on a ReceiveMessage call. Thus, only the messages on the sampled machines are returned. If the number of messages in the queue is small (fewer than 1,000), you most likely get fewer messages than you requested per ReceiveMessage call. If the number of messages in the queue is extremely small, you might not receive any messages in a particular ReceiveMessage response. If this happens, repeat the request.

For each message returned, the response includes the following:

  • The message body.

  • An MD5 digest of the message body. For information about MD5, see RFC1321.

  • The MessageId you received when you sent the message to the queue.

  • The receipt handle.

  • The message attributes.

  • An MD5 digest of the message attributes.

The receipt handle is the identifier you must provide when deleting the message. For more information, see Queue and Message Identifiers in the Amazon Simple Queue Service Developer Guide.

You can provide the VisibilityTimeout parameter in your request. The parameter is applied to the messages that Amazon SQS returns in the response. If you don't include the parameter, the overall visibility timeout for the queue is used for the returned messages. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

A message that isn't deleted or a message whose visibility isn't extended before the visibility timeout expires counts as a failed receive. Depending on the configuration of the queue, the message might be sent to the dead-letter queue.

In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

" - }, - "RemovePermission":{ - "name":"RemovePermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemovePermissionRequest"}, - "documentation":"

Revokes any permissions in the queue policy that matches the specified Label parameter. Only the owner of the queue can remove permissions.

" - }, - "SendMessage":{ - "name":"SendMessage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendMessageRequest"}, - "output":{ - "shape":"SendMessageResult", - "resultWrapper":"SendMessageResult" - }, - "errors":[ - {"shape":"InvalidMessageContents"}, - {"shape":"UnsupportedOperation"} - ], - "documentation":"

Delivers a message to the specified queue.

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

" - }, - "SendMessageBatch":{ - "name":"SendMessageBatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendMessageBatchRequest"}, - "output":{ - "shape":"SendMessageBatchResult", - "resultWrapper":"SendMessageBatchResult" - }, - "errors":[ - {"shape":"TooManyEntriesInBatchRequest"}, - {"shape":"EmptyBatchRequest"}, - {"shape":"BatchEntryIdsNotDistinct"}, - {"shape":"BatchRequestTooLong"}, - {"shape":"InvalidBatchEntryId"}, - {"shape":"UnsupportedOperation"} - ], - "documentation":"

Delivers up to ten messages to the specified queue. This is a batch version of SendMessage. For a FIFO queue, multiple messages within a single batch are enqueued in the order they are sent.

The result of sending each message is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of all of the batched messages) are both 256 KB (262,144 bytes).

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

If you don't specify the DelaySeconds parameter for an entry, Amazon SQS uses the default value for the queue.

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

&Attribute.1=this

&Attribute.2=that

" - }, - "SetQueueAttributes":{ - "name":"SetQueueAttributes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetQueueAttributesRequest"}, - "errors":[ - {"shape":"InvalidAttributeName"} - ], - "documentation":"

Sets the value of one or more queue attributes. When you change a queue's attributes, the change can take up to 60 seconds for most of the attributes to propagate throughout the Amazon SQS system. Changes made to the MessageRetentionPeriod attribute can take up to 15 minutes.

In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

" - }, - "TagQueue":{ - "name":"TagQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TagQueueRequest"}, - "documentation":"

Add cost allocation tags to the specified Amazon SQS queue. For an overview, see Tagging Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

When you use queue tags, keep the following guidelines in mind:

  • Adding more than 50 tags to a queue isn't recommended.

  • Tags don't have any semantic meaning. Amazon SQS interprets tags as character strings.

  • Tags are case-sensitive.

  • A new tag with a key identical to that of an existing tag overwrites the existing tag.

  • Tagging API actions are limited to 5 TPS per AWS account. If your application requires a higher throughput, file a technical support request.

For a full list of tag restrictions, see Limits Related to Queues in the Amazon Simple Queue Service Developer Guide.

" - }, - "UntagQueue":{ - "name":"UntagQueue", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UntagQueueRequest"}, - "documentation":"

Remove cost allocation tags from the specified Amazon SQS queue. For an overview, see Tagging Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

When you use queue tags, keep the following guidelines in mind:

  • Adding more than 50 tags to a queue isn't recommended.

  • Tags don't have any semantic meaning. Amazon SQS interprets tags as character strings.

  • Tags are case-sensitive.

  • A new tag with a key identical to that of an existing tag overwrites the existing tag.

  • Tagging API actions are limited to 5 TPS per AWS account. If your application requires a higher throughput, file a technical support request.

For a full list of tag restrictions, see Limits Related to Queues in the Amazon Simple Queue Service Developer Guide.

" - } - }, - "shapes":{ - "AWSAccountIdList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"AWSAccountId" - }, - "flattened":true - }, - "ActionNameList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"ActionName" - }, - "flattened":true - }, - "AddPermissionRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Label", - "AWSAccountIds", - "Actions" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue to which permissions are added.

Queue URLs are case-sensitive.

" - }, - "Label":{ - "shape":"String", - "documentation":"

The unique identification of the permission you're setting (for example, AliceSendMessage). Maximum 80 characters. Allowed characters include alphanumeric characters, hyphens (-), and underscores (_).

" - }, - "AWSAccountIds":{ - "shape":"AWSAccountIdList", - "documentation":"

The AWS account number of the principal who is given permission. The principal must have an AWS account, but does not need to be signed up for Amazon SQS. For information about locating the AWS account identification, see Your AWS Identifiers in the Amazon Simple Queue Service Developer Guide.

" - }, - "Actions":{ - "shape":"ActionNameList", - "documentation":"

The action the client wants to allow for the specified principal. The following values are valid:

  • *

  • ChangeMessageVisibility

  • DeleteMessage

  • GetQueueAttributes

  • GetQueueUrl

  • ReceiveMessage

  • SendMessage

For more information about these actions, see Understanding Permissions in the Amazon Simple Queue Service Developer Guide.

Specifying SendMessage, DeleteMessage, or ChangeMessageVisibility for ActionName.n also grants permissions for the corresponding batch versions of those actions: SendMessageBatch, DeleteMessageBatch, and ChangeMessageVisibilityBatch.

" - } - }, - "documentation":"

" - }, - "AttributeNameList":{ - "type":"list", - "member":{ - "shape":"QueueAttributeName", - "locationName":"AttributeName" - }, - "flattened":true - }, - "BatchEntryIdsNotDistinct":{ - "type":"structure", - "members":{ - }, - "documentation":"

Two or more batch entries in the request have the same Id.

", - "error":{ - "code":"AWS.SimpleQueueService.BatchEntryIdsNotDistinct", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "BatchRequestTooLong":{ - "type":"structure", - "members":{ - }, - "documentation":"

The length of all the messages put together is more than the limit.

", - "error":{ - "code":"AWS.SimpleQueueService.BatchRequestTooLong", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "BatchResultErrorEntry":{ - "type":"structure", - "required":[ - "Id", - "SenderFault", - "Code" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The Id of an entry in a batch request.

" - }, - "SenderFault":{ - "shape":"Boolean", - "documentation":"

Specifies whether the error happened due to the sender's fault.

" - }, - "Code":{ - "shape":"String", - "documentation":"

An error code representing why the action failed on this entry.

" - }, - "Message":{ - "shape":"String", - "documentation":"

A message explaining why the action failed on this entry.

" - } - }, - "documentation":"

This is used in the responses of batch API to give a detailed description of the result of an action on each entry in the request.

" - }, - "BatchResultErrorEntryList":{ - "type":"list", - "member":{ - "shape":"BatchResultErrorEntry", - "locationName":"BatchResultErrorEntry" - }, - "flattened":true - }, - "Binary":{"type":"blob"}, - "BinaryList":{ - "type":"list", - "member":{ - "shape":"Binary", - "locationName":"BinaryListValue" - } - }, - "Boolean":{"type":"boolean"}, - "ChangeMessageVisibilityBatchRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Entries" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue whose messages' visibility is changed.

Queue URLs are case-sensitive.

" - }, - "Entries":{ - "shape":"ChangeMessageVisibilityBatchRequestEntryList", - "documentation":"

A list of receipt handles of the messages for which the visibility timeout must be changed.

" - } - }, - "documentation":"

" - }, - "ChangeMessageVisibilityBatchRequestEntry":{ - "type":"structure", - "required":[ - "Id", - "ReceiptHandle" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

An identifier for this particular receipt handle used to communicate the result.

The Ids of a batch request need to be unique within a request

" - }, - "ReceiptHandle":{ - "shape":"String", - "documentation":"

A receipt handle.

" - }, - "VisibilityTimeout":{ - "shape":"Integer", - "documentation":"

The new value (in seconds) for the message's visibility timeout.

" - } - }, - "documentation":"

Encloses a receipt handle and an entry id for each message in ChangeMessageVisibilityBatch.

All of the following list parameters must be prefixed with ChangeMessageVisibilityBatchRequestEntry.n, where n is an integer value starting with 1. For example, a parameter list for this action might look like this:

&amp;ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2

&amp;ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=<replaceable>Your_Receipt_Handle</replaceable>

&amp;ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45

" - }, - "ChangeMessageVisibilityBatchRequestEntryList":{ - "type":"list", - "member":{ - "shape":"ChangeMessageVisibilityBatchRequestEntry", - "locationName":"ChangeMessageVisibilityBatchRequestEntry" - }, - "flattened":true - }, - "ChangeMessageVisibilityBatchResult":{ - "type":"structure", - "required":[ - "Successful", - "Failed" - ], - "members":{ - "Successful":{ - "shape":"ChangeMessageVisibilityBatchResultEntryList", - "documentation":"

A list of ChangeMessageVisibilityBatchResultEntry items.

" - }, - "Failed":{ - "shape":"BatchResultErrorEntryList", - "documentation":"

A list of BatchResultErrorEntry items.

" - } - }, - "documentation":"

For each message in the batch, the response contains a ChangeMessageVisibilityBatchResultEntry tag if the message succeeds or a BatchResultErrorEntry tag if the message fails.

" - }, - "ChangeMessageVisibilityBatchResultEntry":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

Represents a message whose visibility timeout has been changed successfully.

" - } - }, - "documentation":"

Encloses the Id of an entry in ChangeMessageVisibilityBatch.

" - }, - "ChangeMessageVisibilityBatchResultEntryList":{ - "type":"list", - "member":{ - "shape":"ChangeMessageVisibilityBatchResultEntry", - "locationName":"ChangeMessageVisibilityBatchResultEntry" - }, - "flattened":true - }, - "ChangeMessageVisibilityRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "ReceiptHandle", - "VisibilityTimeout" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue whose message's visibility is changed.

Queue URLs are case-sensitive.

" - }, - "ReceiptHandle":{ - "shape":"String", - "documentation":"

The receipt handle associated with the message whose visibility timeout is changed. This parameter is returned by the ReceiveMessage action.

" - }, - "VisibilityTimeout":{ - "shape":"Integer", - "documentation":"

The new value for the message's visibility timeout (in seconds). Values values: 0 to 43200. Maximum: 12 hours.

" - } - } - }, - "CreateQueueRequest":{ - "type":"structure", - "required":["QueueName"], - "members":{ - "QueueName":{ - "shape":"String", - "documentation":"

The name of the new queue. The following limits apply to this name:

  • A queue name can have up to 80 characters.

  • Valid values: alphanumeric characters, hyphens (-), and underscores (_).

  • A FIFO queue name must end with the .fifo suffix.

Queue names are case-sensitive.

" - }, - "Attributes":{ - "shape":"QueueAttributeMap", - "documentation":"

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that the CreateQueue action uses:

  • DelaySeconds - The length of time, in seconds, for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 seconds (15 minutes). The default is 0 (zero).

  • MaximumMessageSize - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB).

  • MessageRetentionPeriod - The length of time, in seconds, for which Amazon SQS retains a message. Valid values: An integer from 60 seconds (1 minute) to 1,209,600 seconds (14 days). The default is 345,600 (4 days).

  • Policy - The queue's policy. A valid AWS policy. For more information about policy structure, see Overview of AWS IAM Policies in the Amazon IAM User Guide.

  • ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for which a ReceiveMessage action waits for a message to arrive. Valid values: An integer from 0 to 20 (seconds). The default is 0 (zero).

  • RedrivePolicy - The string that includes the parameters for the dead-letter queue functionality of the source queue. For more information about the redrive policy and dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

    • deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue to which Amazon SQS moves messages after the value of maxReceiveCount is exceeded.

    • maxReceiveCount - The number of times a message is delivered to the source queue before being moved to the dead-letter queue.

    The dead-letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead-letter queue of a standard queue must also be a standard queue.

  • VisibilityTimeout - The visibility timeout for the queue. Valid values: An integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

The following attributes apply only to server-side-encryption:

  • KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see Key Terms. While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs, the alias of a custom CMK can, for example, be alias/MyAlias . For more examples, see KeyId in the AWS Key Management Service API Reference.

  • KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling AWS KMS again. An integer representing seconds, between 60 seconds (1 minute) and 86,400 seconds (24 hours). The default is 300 (5 minutes). A shorter time period provides better security but results in more calls to KMS which might incur charges after Free Tier. For more information, see How Does the Data Key Reuse Period Work?.

The following attributes apply only to FIFO (first-in-first-out) queues:

  • FifoQueue - Designates a queue as FIFO. Valid values: true, false. You can provide this attribute only during queue creation. You can't change it for an existing queue. When you set this attribute, you must also provide the MessageGroupId for your messages explicitly.

    For more information, see FIFO Queue Logic in the Amazon Simple Queue Service Developer Guide.

  • ContentBasedDeduplication - Enables content-based deduplication. Valid values: true, false. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

    • Every message must have a unique MessageDeduplicationId,

      • You may provide a MessageDeduplicationId explicitly.

      • If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId using the body of the message (but not the attributes of the message).

      • If you don't provide a MessageDeduplicationId and the queue doesn't have ContentBasedDeduplication set, the action fails with an error.

      • If the queue has ContentBasedDeduplication set, your MessageDeduplicationId overrides the generated one.

    • When ContentBasedDeduplication is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.

    • If you send one message with ContentBasedDeduplication enabled and then another message with a MessageDeduplicationId that is the same as the one generated for the first MessageDeduplicationId, the two messages are treated as duplicates and only one copy of the message is delivered.

Any other valid special request parameters (such as the following) are ignored:

  • ApproximateNumberOfMessages

  • ApproximateNumberOfMessagesDelayed

  • ApproximateNumberOfMessagesNotVisible

  • CreatedTimestamp

  • LastModifiedTimestamp

  • QueueArn

", - "locationName":"Attribute" - } - }, - "documentation":"

" - }, - "CreateQueueResult":{ - "type":"structure", - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the created Amazon SQS queue.

" - } - }, - "documentation":"

Returns the QueueUrl attribute of the created queue.

" - }, - "DeleteMessageBatchRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Entries" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue from which messages are deleted.

Queue URLs are case-sensitive.

" - }, - "Entries":{ - "shape":"DeleteMessageBatchRequestEntryList", - "documentation":"

A list of receipt handles for the messages to be deleted.

" - } - }, - "documentation":"

" - }, - "DeleteMessageBatchRequestEntry":{ - "type":"structure", - "required":[ - "Id", - "ReceiptHandle" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

An identifier for this particular receipt handle. This is used to communicate the result.

The Ids of a batch request need to be unique within a request

" - }, - "ReceiptHandle":{ - "shape":"String", - "documentation":"

A receipt handle.

" - } - }, - "documentation":"

Encloses a receipt handle and an identifier for it.

" - }, - "DeleteMessageBatchRequestEntryList":{ - "type":"list", - "member":{ - "shape":"DeleteMessageBatchRequestEntry", - "locationName":"DeleteMessageBatchRequestEntry" - }, - "flattened":true - }, - "DeleteMessageBatchResult":{ - "type":"structure", - "required":[ - "Successful", - "Failed" - ], - "members":{ - "Successful":{ - "shape":"DeleteMessageBatchResultEntryList", - "documentation":"

A list of DeleteMessageBatchResultEntry items.

" - }, - "Failed":{ - "shape":"BatchResultErrorEntryList", - "documentation":"

A list of BatchResultErrorEntry items.

" - } - }, - "documentation":"

For each message in the batch, the response contains a DeleteMessageBatchResultEntry tag if the message is deleted or a BatchResultErrorEntry tag if the message can't be deleted.

" - }, - "DeleteMessageBatchResultEntry":{ - "type":"structure", - "required":["Id"], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

Represents a successfully deleted message.

" - } - }, - "documentation":"

Encloses the Id of an entry in DeleteMessageBatch.

" - }, - "DeleteMessageBatchResultEntryList":{ - "type":"list", - "member":{ - "shape":"DeleteMessageBatchResultEntry", - "locationName":"DeleteMessageBatchResultEntry" - }, - "flattened":true - }, - "DeleteMessageRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "ReceiptHandle" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue from which messages are deleted.

Queue URLs are case-sensitive.

" - }, - "ReceiptHandle":{ - "shape":"String", - "documentation":"

The receipt handle associated with the message to delete.

" - } - }, - "documentation":"

" - }, - "DeleteQueueRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue to delete.

Queue URLs are case-sensitive.

" - } - }, - "documentation":"

" - }, - "EmptyBatchRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

The batch request doesn't contain any entries.

", - "error":{ - "code":"AWS.SimpleQueueService.EmptyBatchRequest", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "GetQueueAttributesRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue whose attribute information is retrieved.

Queue URLs are case-sensitive.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attributes for which to retrieve information.

In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

The following attributes are supported:

  • All - Returns all values.

  • ApproximateNumberOfMessages - Returns the approximate number of visible messages in a queue. For more information, see Resources Required to Process Messages in the Amazon Simple Queue Service Developer Guide.

  • ApproximateNumberOfMessagesDelayed - Returns the approximate number of messages that are waiting to be added to the queue.

  • ApproximateNumberOfMessagesNotVisible - Returns the approximate number of messages that have not timed-out and aren't deleted. For more information, see Resources Required to Process Messages in the Amazon Simple Queue Service Developer Guide.

  • CreatedTimestamp - Returns the time when the queue was created in seconds (epoch time).

  • DelaySeconds - Returns the default delay on the queue in seconds.

  • LastModifiedTimestamp - Returns the time when the queue was last changed in seconds (epoch time).

  • MaximumMessageSize - Returns the limit of how many bytes a message can contain before Amazon SQS rejects it.

  • MessageRetentionPeriod - Returns the length of time, in seconds, for which Amazon SQS retains a message.

  • Policy - Returns the policy of the queue.

  • QueueArn - Returns the Amazon resource name (ARN) of the queue.

  • ReceiveMessageWaitTimeSeconds - Returns the length of time, in seconds, for which the ReceiveMessage action waits for a message to arrive.

  • RedrivePolicy - Returns the string that includes the parameters for dead-letter queue functionality of the source queue. For more information about the redrive policy and dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

    • deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue to which Amazon SQS moves messages after the value of maxReceiveCount is exceeded.

    • maxReceiveCount - The number of times a message is delivered to the source queue before being moved to the dead-letter queue.

  • VisibilityTimeout - Returns the visibility timeout for the queue. For more information about the visibility timeout, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

The following attributes apply only to server-side-encryption:

  • KmsMasterKeyId - Returns the ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see Key Terms.

  • KmsDataKeyReusePeriodSeconds - Returns the length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling AWS KMS again. For more information, see How Does the Data Key Reuse Period Work?.

The following attributes apply only to FIFO (first-in-first-out) queues:

  • FifoQueue - Returns whether the queue is FIFO. For more information, see FIFO Queue Logic in the Amazon Simple Queue Service Developer Guide.

    To determine whether a queue is FIFO, you can check whether QueueName ends with the .fifo suffix.

  • ContentBasedDeduplication - Returns whether content-based deduplication is enabled for the queue. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

" - } - }, - "documentation":"

" - }, - "GetQueueAttributesResult":{ - "type":"structure", - "members":{ - "Attributes":{ - "shape":"QueueAttributeMap", - "documentation":"

A map of attributes to their respective values.

", - "locationName":"Attribute" - } - }, - "documentation":"

A list of returned queue attributes.

" - }, - "GetQueueUrlRequest":{ - "type":"structure", - "required":["QueueName"], - "members":{ - "QueueName":{ - "shape":"String", - "documentation":"

The name of the queue whose URL must be fetched. Maximum 80 characters. Valid values: alphanumeric characters, hyphens (-), and underscores (_).

Queue names are case-sensitive.

" - }, - "QueueOwnerAWSAccountId":{ - "shape":"String", - "documentation":"

The AWS account ID of the account that created the queue.

" - } - }, - "documentation":"

" - }, - "GetQueueUrlResult":{ - "type":"structure", - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the queue.

" - } - }, - "documentation":"

For more information, see Responses in the Amazon Simple Queue Service Developer Guide.

" - }, - "Integer":{"type":"integer"}, - "InvalidAttributeName":{ - "type":"structure", - "members":{ - }, - "documentation":"

The attribute referred to doesn't exist.

", - "exception":true - }, - "InvalidBatchEntryId":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Id of a batch entry in a batch request doesn't abide by the specification.

", - "error":{ - "code":"AWS.SimpleQueueService.InvalidBatchEntryId", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidIdFormat":{ - "type":"structure", - "members":{ - }, - "documentation":"

The receipt handle isn't valid for the current version.

", - "exception":true - }, - "InvalidMessageContents":{ - "type":"structure", - "members":{ - }, - "documentation":"

The message contains characters outside the allowed set.

", - "exception":true - }, - "ListDeadLetterSourceQueuesRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of a dead-letter queue.

Queue URLs are case-sensitive.

" - } - }, - "documentation":"

" - }, - "ListDeadLetterSourceQueuesResult":{ - "type":"structure", - "required":["queueUrls"], - "members":{ - "queueUrls":{ - "shape":"QueueUrlList", - "documentation":"

A list of source queue URLs that have the RedrivePolicy queue attribute configured with a dead-letter queue.

" - } - }, - "documentation":"

A list of your dead letter source queues.

" - }, - "ListQueueTagsRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the queue.

" - } - } - }, - "ListQueueTagsResult":{ - "type":"structure", - "members":{ - "Tags":{ - "shape":"TagMap", - "documentation":"

The list of all tags added to the specified queue.

", - "locationName":"Tag" - } - } - }, - "ListQueuesRequest":{ - "type":"structure", - "members":{ - "QueueNamePrefix":{ - "shape":"String", - "documentation":"

A string to use for filtering the list results. Only those queues whose name begins with the specified string are returned.

Queue names are case-sensitive.

" - } - }, - "documentation":"

" - }, - "ListQueuesResult":{ - "type":"structure", - "members":{ - "QueueUrls":{ - "shape":"QueueUrlList", - "documentation":"

A list of queue URLs, up to 1,000 entries.

" - } - }, - "documentation":"

A list of your queues.

" - }, - "Message":{ - "type":"structure", - "members":{ - "MessageId":{ - "shape":"String", - "documentation":"

A unique identifier for the message. A MessageIdis considered unique across all AWS accounts for an extended period of time.

" - }, - "ReceiptHandle":{ - "shape":"String", - "documentation":"

An identifier associated with the act of receiving the message. A new receipt handle is returned every time you receive a message. When deleting a message, you provide the last received receipt handle to delete the message.

" - }, - "MD5OfBody":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message body string.

" - }, - "Body":{ - "shape":"String", - "documentation":"

The message's contents (not URL-encoded).

" - }, - "Attributes":{ - "shape":"MessageSystemAttributeMap", - "documentation":"

SenderId, SentTimestamp, ApproximateReceiveCount, and/or ApproximateFirstReceiveTimestamp. SentTimestamp and ApproximateFirstReceiveTimestamp are each returned as an integer representing the epoch time in milliseconds.

", - "locationName":"Attribute" - }, - "MD5OfMessageAttributes":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

" - }, - "MessageAttributes":{ - "shape":"MessageBodyAttributeMap", - "documentation":"

Each message attribute consists of a Name, Type, and Value. For more information, see Message Attribute Items and Validation in the Amazon Simple Queue Service Developer Guide.

", - "locationName":"MessageAttribute" - } - }, - "documentation":"

An Amazon SQS message.

" - }, - "MessageAttributeName":{"type":"string"}, - "MessageAttributeNameList":{ - "type":"list", - "member":{ - "shape":"MessageAttributeName", - "locationName":"MessageAttributeName" - }, - "flattened":true - }, - "MessageAttributeValue":{ - "type":"structure", - "required":["DataType"], - "members":{ - "StringValue":{ - "shape":"String", - "documentation":"

Strings are Unicode with UTF-8 binary encoding. For a list of code values, see ASCII Printable Characters.

" - }, - "BinaryValue":{ - "shape":"Binary", - "documentation":"

Binary type attributes can store any binary data, such as compressed data, encrypted data, or images.

" - }, - "StringListValues":{ - "shape":"StringList", - "documentation":"

Not implemented. Reserved for future use.

", - "flattened":true, - "locationName":"StringListValue" - }, - "BinaryListValues":{ - "shape":"BinaryList", - "documentation":"

Not implemented. Reserved for future use.

", - "flattened":true, - "locationName":"BinaryListValue" - }, - "DataType":{ - "shape":"String", - "documentation":"

Amazon SQS supports the following logical data types: String, Number, and Binary. For the Number data type, you must use StringValue.

You can also append custom labels. For more information, see Message Attribute Data Types and Validation in the Amazon Simple Queue Service Developer Guide.

" - } - }, - "documentation":"

The user-specified message attribute value. For string data types, the Value attribute has the same restrictions on the content as the message body. For more information, see SendMessage.

Name, type, value and the message body must not be empty or null. All parts of the message attribute, including Name, Type, and Value, are part of the message size restriction (256 KB or 262,144 bytes).

" - }, - "MessageBodyAttributeMap":{ - "type":"map", - "key":{ - "shape":"String", - "locationName":"Name" - }, - "value":{ - "shape":"MessageAttributeValue", - "locationName":"Value" - }, - "flattened":true - }, - "MessageList":{ - "type":"list", - "member":{ - "shape":"Message", - "locationName":"Message" - }, - "flattened":true - }, - "MessageNotInflight":{ - "type":"structure", - "members":{ - }, - "documentation":"

The message referred to isn't in flight.

", - "error":{ - "code":"AWS.SimpleQueueService.MessageNotInflight", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "MessageSystemAttributeMap":{ - "type":"map", - "key":{ - "shape":"MessageSystemAttributeName", - "locationName":"Name" - }, - "value":{ - "shape":"String", - "locationName":"Value" - }, - "flattened":true, - "locationName":"Attribute" - }, - "MessageSystemAttributeName":{ - "type":"string", - "enum":[ - "SenderId", - "SentTimestamp", - "ApproximateReceiveCount", - "ApproximateFirstReceiveTimestamp", - "SequenceNumber", - "MessageDeduplicationId", - "MessageGroupId" - ] - }, - "OverLimit":{ - "type":"structure", - "members":{ - }, - "documentation":"

The action that you requested would violate a limit. For example, ReceiveMessage returns this error if the maximum number of inflight messages is reached. AddPermission returns this error if the maximum number of permissions for the queue is reached.

", - "error":{ - "code":"OverLimit", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "PurgeQueueInProgress":{ - "type":"structure", - "members":{ - }, - "documentation":"

Indicates that the specified queue previously received a PurgeQueue request within the last 60 seconds (the time it can take to delete the messages in the queue).

", - "error":{ - "code":"AWS.SimpleQueueService.PurgeQueueInProgress", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "PurgeQueueRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the queue from which the PurgeQueue action deletes messages.

Queue URLs are case-sensitive.

" - } - }, - "documentation":"

" - }, - "QueueAttributeMap":{ - "type":"map", - "key":{ - "shape":"QueueAttributeName", - "locationName":"Name" - }, - "value":{ - "shape":"String", - "locationName":"Value" - }, - "flattened":true, - "locationName":"Attribute" - }, - "QueueAttributeName":{ - "type":"string", - "enum":[ - "All", - "Policy", - "VisibilityTimeout", - "MaximumMessageSize", - "MessageRetentionPeriod", - "ApproximateNumberOfMessages", - "ApproximateNumberOfMessagesNotVisible", - "CreatedTimestamp", - "LastModifiedTimestamp", - "QueueArn", - "ApproximateNumberOfMessagesDelayed", - "DelaySeconds", - "ReceiveMessageWaitTimeSeconds", - "RedrivePolicy", - "FifoQueue", - "ContentBasedDeduplication", - "KmsMasterKeyId", - "KmsDataKeyReusePeriodSeconds" - ] - }, - "QueueDeletedRecently":{ - "type":"structure", - "members":{ - }, - "documentation":"

You must wait 60 seconds after deleting a queue before you can create another one with the same name.

", - "error":{ - "code":"AWS.SimpleQueueService.QueueDeletedRecently", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "QueueDoesNotExist":{ - "type":"structure", - "members":{ - }, - "documentation":"

The queue referred to doesn't exist.

", - "error":{ - "code":"AWS.SimpleQueueService.NonExistentQueue", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "QueueNameExists":{ - "type":"structure", - "members":{ - }, - "documentation":"

A queue already exists with this name. Amazon SQS returns this error only if the request includes attributes whose values differ from those of the existing queue.

", - "error":{ - "code":"QueueAlreadyExists", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "QueueUrlList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"QueueUrl" - }, - "flattened":true - }, - "ReceiptHandleIsInvalid":{ - "type":"structure", - "members":{ - }, - "documentation":"

The receipt handle provided isn't valid.

", - "exception":true - }, - "ReceiveMessageRequest":{ - "type":"structure", - "required":["QueueUrl"], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue from which messages are received.

Queue URLs are case-sensitive.

" - }, - "AttributeNames":{ - "shape":"AttributeNameList", - "documentation":"

A list of attributes that need to be returned along with each message. These attributes include:

  • All - Returns all values.

  • ApproximateFirstReceiveTimestamp - Returns the time the message was first received from the queue (epoch time in milliseconds).

  • ApproximateReceiveCount - Returns the number of times a message has been received from the queue but not deleted.

  • SenderId

    • For an IAM user, returns the IAM user ID, for example ABCDEFGHI1JKLMNOPQ23R.

    • For an IAM role, returns the IAM role ID, for example ABCDE1F2GH3I4JK5LMNOP:i-a123b456.

  • SentTimestamp - Returns the time the message was sent to the queue (epoch time in milliseconds).

  • MessageDeduplicationId - Returns the value provided by the sender that calls the SendMessage action.

  • MessageGroupId - Returns the value provided by the sender that calls the SendMessage action. Messages with the same MessageGroupId are returned in sequence.

  • SequenceNumber - Returns the value provided by Amazon SQS.

Any other valid special request parameters (such as the following) are ignored:

  • ApproximateNumberOfMessages

  • ApproximateNumberOfMessagesDelayed

  • ApproximateNumberOfMessagesNotVisible

  • CreatedTimestamp

  • ContentBasedDeduplication

  • DelaySeconds

  • FifoQueue

  • LastModifiedTimestamp

  • MaximumMessageSize

  • MessageRetentionPeriod

  • Policy

  • QueueArn,

  • ReceiveMessageWaitTimeSeconds

  • RedrivePolicy

  • VisibilityTimeout

" - }, - "MessageAttributeNames":{ - "shape":"MessageAttributeNameList", - "documentation":"

The name of the message attribute, where N is the index.

  • The name can contain alphanumeric characters and the underscore (_), hyphen (-), and period (.).

  • The name is case-sensitive and must be unique among all attribute names for the message.

  • The name must not start with AWS-reserved prefixes such as AWS. or Amazon. (or any casing variants).

  • The name must not start or end with a period (.), and it should not have periods in succession (..).

  • The name can be up to 256 characters long.

When using ReceiveMessage, you can send a list of attribute names to receive, or you can return all of the attributes by specifying All or .* in your request. You can also use all message attributes starting with a prefix, for example bar.*.

" - }, - "MaxNumberOfMessages":{ - "shape":"Integer", - "documentation":"

The maximum number of messages to return. Amazon SQS never returns more messages than this value (however, fewer messages might be returned). Valid values are 1 to 10. Default is 1.

" - }, - "VisibilityTimeout":{ - "shape":"Integer", - "documentation":"

The duration (in seconds) that the received messages are hidden from subsequent retrieve requests after being retrieved by a ReceiveMessage request.

" - }, - "WaitTimeSeconds":{ - "shape":"Integer", - "documentation":"

The duration (in seconds) for which the call waits for a message to arrive in the queue before returning. If a message is available, the call returns sooner than WaitTimeSeconds. If no messages are available and the wait time expires, the call returns successfully with an empty list of messages.

" - }, - "ReceiveRequestAttemptId":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The token used for deduplication of ReceiveMessage calls. If a networking issue occurs after a ReceiveMessage action, and instead of a response you receive a generic error, you can retry the same action with an identical ReceiveRequestAttemptId to retrieve the same set of messages, even if their visibility timeout has not yet expired.

  • You can use ReceiveRequestAttemptId only for 5 minutes after a ReceiveMessage action.

  • When you set FifoQueue, a caller of the ReceiveMessage action can provide a ReceiveRequestAttemptId explicitly.

  • If a caller of the ReceiveMessage action doesn't provide a ReceiveRequestAttemptId, Amazon SQS generates a ReceiveRequestAttemptId.

  • You can retry the ReceiveMessage action with the same ReceiveRequestAttemptId if none of the messages have been modified (deleted or had their visibility changes).

  • During a visibility timeout, subsequent calls with the same ReceiveRequestAttemptId return the same messages and receipt handles. If a retry occurs within the deduplication interval, it resets the visibility timeout. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

    If a caller of the ReceiveMessage action is still processing messages when the visibility timeout expires and messages become visible, another worker reading from the same queue can receive the same messages and therefore process duplicates. Also, if a reader whose message processing time is longer than the visibility timeout tries to delete the processed messages, the action fails with an error.

    To mitigate this effect, ensure that your application observes a safe threshold before the visibility timeout expires and extend the visibility timeout as necessary.

  • While messages with a particular MessageGroupId are invisible, no more messages belonging to the same MessageGroupId are returned until the visibility timeout expires. You can still receive messages with another MessageGroupId as long as it is also visible.

  • If a caller of ReceiveMessage can't track the ReceiveRequestAttemptId, no retries work until the original visibility timeout expires. As a result, delays might occur but the messages in the queue remain in a strict order.

The length of ReceiveRequestAttemptId is 128 characters. ReceiveRequestAttemptId can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using ReceiveRequestAttemptId, see Using the ReceiveRequestAttemptId Request Parameter in the Amazon Simple Queue Service Developer Guide.

" - } - }, - "documentation":"

" - }, - "ReceiveMessageResult":{ - "type":"structure", - "members":{ - "Messages":{ - "shape":"MessageList", - "documentation":"

A list of messages.

" - } - }, - "documentation":"

A list of received messages.

" - }, - "RemovePermissionRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Label" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue from which permissions are removed.

Queue URLs are case-sensitive.

" - }, - "Label":{ - "shape":"String", - "documentation":"

The identification of the permission to remove. This is the label added using the AddPermission action.

" - } - }, - "documentation":"

" - }, - "SendMessageBatchRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Entries" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue to which batched messages are sent.

Queue URLs are case-sensitive.

" - }, - "Entries":{ - "shape":"SendMessageBatchRequestEntryList", - "documentation":"

A list of SendMessageBatchRequestEntry items.

" - } - }, - "documentation":"

" - }, - "SendMessageBatchRequestEntry":{ - "type":"structure", - "required":[ - "Id", - "MessageBody" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

An identifier for a message in this batch used to communicate the result.

The Ids of a batch request need to be unique within a request

" - }, - "MessageBody":{ - "shape":"String", - "documentation":"

The body of the message.

" - }, - "DelaySeconds":{ - "shape":"Integer", - "documentation":"

The length of time, in seconds, for which a specific message is delayed. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue is applied.

When you set FifoQueue, you can't set DelaySeconds per message. You can set this parameter only on a queue level.

" - }, - "MessageAttributes":{ - "shape":"MessageBodyAttributeMap", - "documentation":"

Each message attribute consists of a Name, Type, and Value. For more information, see Message Attribute Items and Validation in the Amazon Simple Queue Service Developer Guide.

", - "locationName":"MessageAttribute" - }, - "MessageDeduplicationId":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The token used for deduplication of messages within a 5-minute minimum deduplication interval. If a message with a particular MessageDeduplicationId is sent successfully, subsequent messages with the same MessageDeduplicationId are accepted successfully but aren't delivered. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

  • Every message must have a unique MessageDeduplicationId,

    • You may provide a MessageDeduplicationId explicitly.

    • If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId using the body of the message (but not the attributes of the message).

    • If you don't provide a MessageDeduplicationId and the queue doesn't have ContentBasedDeduplication set, the action fails with an error.

    • If the queue has ContentBasedDeduplication set, your MessageDeduplicationId overrides the generated one.

  • When ContentBasedDeduplication is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.

  • If you send one message with ContentBasedDeduplication enabled and then another message with a MessageDeduplicationId that is the same as the one generated for the first MessageDeduplicationId, the two messages are treated as duplicates and only one copy of the message is delivered.

The MessageDeduplicationId is available to the recipient of the message (this can be useful for troubleshooting delivery issues).

If a message is sent successfully but the acknowledgement is lost and the message is resent with the same MessageDeduplicationId after the deduplication interval, Amazon SQS can't detect duplicate messages.

The length of MessageDeduplicationId is 128 characters. MessageDeduplicationId can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageDeduplicationId, see Using the MessageDeduplicationId Property in the Amazon Simple Queue Service Developer Guide.

" - }, - "MessageGroupId":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use MessageGroupId values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.

  • You must associate a non-empty MessageGroupId with a message. If you don't provide a MessageGroupId, the action fails.

  • ReceiveMessage might return messages with multiple MessageGroupId values. For each MessageGroupId, the messages are sorted by time sent. The caller can't specify a MessageGroupId.

The length of MessageGroupId is 128 characters. Valid values are alphanumeric characters and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageGroupId, see Using the MessageGroupId Property in the Amazon Simple Queue Service Developer Guide.

MessageGroupId is required for FIFO queues. You can't use it for Standard queues.

" - } - }, - "documentation":"

Contains the details of a single Amazon SQS message along with an Id.

" - }, - "SendMessageBatchRequestEntryList":{ - "type":"list", - "member":{ - "shape":"SendMessageBatchRequestEntry", - "locationName":"SendMessageBatchRequestEntry" - }, - "flattened":true - }, - "SendMessageBatchResult":{ - "type":"structure", - "required":[ - "Successful", - "Failed" - ], - "members":{ - "Successful":{ - "shape":"SendMessageBatchResultEntryList", - "documentation":"

A list of SendMessageBatchResultEntry items.

" - }, - "Failed":{ - "shape":"BatchResultErrorEntryList", - "documentation":"

A list of BatchResultErrorEntry items with error details about each message that can't be enqueued.

" - } - }, - "documentation":"

For each message in the batch, the response contains a SendMessageBatchResultEntry tag if the message succeeds or a BatchResultErrorEntry tag if the message fails.

" - }, - "SendMessageBatchResultEntry":{ - "type":"structure", - "required":[ - "Id", - "MessageId", - "MD5OfMessageBody" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

An identifier for the message in this batch.

" - }, - "MessageId":{ - "shape":"String", - "documentation":"

An identifier for the message.

" - }, - "MD5OfMessageBody":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

" - }, - "MD5OfMessageAttributes":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

" - }, - "SequenceNumber":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The large, non-consecutive number that Amazon SQS assigns to each message.

The length of SequenceNumber is 128 bits. As SequenceNumber continues to increase for a particular MessageGroupId.

" - } - }, - "documentation":"

Encloses a MessageId for a successfully-enqueued message in a SendMessageBatch.

" - }, - "SendMessageBatchResultEntryList":{ - "type":"list", - "member":{ - "shape":"SendMessageBatchResultEntry", - "locationName":"SendMessageBatchResultEntry" - }, - "flattened":true - }, - "SendMessageRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "MessageBody" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue to which a message is sent.

Queue URLs are case-sensitive.

" - }, - "MessageBody":{ - "shape":"String", - "documentation":"

The message to send. The maximum string size is 256 KB.

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

" - }, - "DelaySeconds":{ - "shape":"Integer", - "documentation":"

The length of time, in seconds, for which to delay a specific message. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue applies.

When you set FifoQueue, you can't set DelaySeconds per message. You can set this parameter only on a queue level.

" - }, - "MessageAttributes":{ - "shape":"MessageBodyAttributeMap", - "documentation":"

Each message attribute consists of a Name, Type, and Value. For more information, see Message Attribute Items and Validation in the Amazon Simple Queue Service Developer Guide.

", - "locationName":"MessageAttribute" - }, - "MessageDeduplicationId":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The token used for deduplication of sent messages. If a message with a particular MessageDeduplicationId is sent successfully, any messages sent with the same MessageDeduplicationId are accepted successfully but aren't delivered during the 5-minute deduplication interval. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

  • Every message must have a unique MessageDeduplicationId,

    • You may provide a MessageDeduplicationId explicitly.

    • If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId using the body of the message (but not the attributes of the message).

    • If you don't provide a MessageDeduplicationId and the queue doesn't have ContentBasedDeduplication set, the action fails with an error.

    • If the queue has ContentBasedDeduplication set, your MessageDeduplicationId overrides the generated one.

  • When ContentBasedDeduplication is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.

  • If you send one message with ContentBasedDeduplication enabled and then another message with a MessageDeduplicationId that is the same as the one generated for the first MessageDeduplicationId, the two messages are treated as duplicates and only one copy of the message is delivered.

The MessageDeduplicationId is available to the recipient of the message (this can be useful for troubleshooting delivery issues).

If a message is sent successfully but the acknowledgement is lost and the message is resent with the same MessageDeduplicationId after the deduplication interval, Amazon SQS can't detect duplicate messages.

The length of MessageDeduplicationId is 128 characters. MessageDeduplicationId can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageDeduplicationId, see Using the MessageDeduplicationId Property in the Amazon Simple Queue Service Developer Guide.

" - }, - "MessageGroupId":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use MessageGroupId values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.

  • You must associate a non-empty MessageGroupId with a message. If you don't provide a MessageGroupId, the action fails.

  • ReceiveMessage might return messages with multiple MessageGroupId values. For each MessageGroupId, the messages are sorted by time sent. The caller can't specify a MessageGroupId.

The length of MessageGroupId is 128 characters. Valid values are alphanumeric characters and punctuation (!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~).

For best practices of using MessageGroupId, see Using the MessageGroupId Property in the Amazon Simple Queue Service Developer Guide.

MessageGroupId is required for FIFO queues. You can't use it for Standard queues.

" - } - }, - "documentation":"

" - }, - "SendMessageResult":{ - "type":"structure", - "members":{ - "MD5OfMessageBody":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

" - }, - "MD5OfMessageAttributes":{ - "shape":"String", - "documentation":"

An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see RFC1321.

" - }, - "MessageId":{ - "shape":"String", - "documentation":"

An attribute containing the MessageId of the message sent to the queue. For more information, see Queue and Message Identifiers in the Amazon Simple Queue Service Developer Guide.

" - }, - "SequenceNumber":{ - "shape":"String", - "documentation":"

This parameter applies only to FIFO (first-in-first-out) queues.

The large, non-consecutive number that Amazon SQS assigns to each message.

The length of SequenceNumber is 128 bits. SequenceNumber continues to increase for a particular MessageGroupId.

" - } - }, - "documentation":"

The MD5OfMessageBody and MessageId elements.

" - }, - "SetQueueAttributesRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Attributes" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the Amazon SQS queue whose attributes are set.

Queue URLs are case-sensitive.

" - }, - "Attributes":{ - "shape":"QueueAttributeMap", - "documentation":"

A map of attributes to set.

The following lists the names, descriptions, and values of the special request parameters that the SetQueueAttributes action uses:

  • DelaySeconds - The length of time, in seconds, for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 (15 minutes). The default is 0 (zero).

  • MaximumMessageSize - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB).

  • MessageRetentionPeriod - The length of time, in seconds, for which Amazon SQS retains a message. Valid values: An integer representing seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is 345,600 (4 days).

  • Policy - The queue's policy. A valid AWS policy. For more information about policy structure, see Overview of AWS IAM Policies in the Amazon IAM User Guide.

  • ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for which a ReceiveMessage action waits for a message to arrive. Valid values: an integer from 0 to 20 (seconds). The default is 0.

  • RedrivePolicy - The string that includes the parameters for the dead-letter queue functionality of the source queue. For more information about the redrive policy and dead-letter queues, see Using Amazon SQS Dead-Letter Queues in the Amazon Simple Queue Service Developer Guide.

    • deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue to which Amazon SQS moves messages after the value of maxReceiveCount is exceeded.

    • maxReceiveCount - The number of times a message is delivered to the source queue before being moved to the dead-letter queue.

    The dead-letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead-letter queue of a standard queue must also be a standard queue.

  • VisibilityTimeout - The visibility timeout for the queue. Valid values: an integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

The following attributes apply only to server-side-encryption:

  • KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see Key Terms. While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs, the alias of a custom CMK can, for example, be alias/MyAlias . For more examples, see KeyId in the AWS Key Management Service API Reference.

  • KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling AWS KMS again. An integer representing seconds, between 60 seconds (1 minute) and 86,400 seconds (24 hours). The default is 300 (5 minutes). A shorter time period provides better security but results in more calls to KMS which might incur charges after Free Tier. For more information, see How Does the Data Key Reuse Period Work?.

The following attribute applies only to FIFO (first-in-first-out) queues:

  • ContentBasedDeduplication - Enables content-based deduplication. For more information, see Exactly-Once Processing in the Amazon Simple Queue Service Developer Guide.

    • Every message must have a unique MessageDeduplicationId,

      • You may provide a MessageDeduplicationId explicitly.

      • If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId using the body of the message (but not the attributes of the message).

      • If you don't provide a MessageDeduplicationId and the queue doesn't have ContentBasedDeduplication set, the action fails with an error.

      • If the queue has ContentBasedDeduplication set, your MessageDeduplicationId overrides the generated one.

    • When ContentBasedDeduplication is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.

    • If you send one message with ContentBasedDeduplication enabled and then another message with a MessageDeduplicationId that is the same as the one generated for the first MessageDeduplicationId, the two messages are treated as duplicates and only one copy of the message is delivered.

Any other valid special request parameters (such as the following) are ignored:

  • ApproximateNumberOfMessages

  • ApproximateNumberOfMessagesDelayed

  • ApproximateNumberOfMessagesNotVisible

  • CreatedTimestamp

  • LastModifiedTimestamp

  • QueueArn

", - "locationName":"Attribute" - } - }, - "documentation":"

" - }, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{ - "shape":"String", - "locationName":"StringListValue" - } - }, - "TagKey":{"type":"string"}, - "TagKeyList":{ - "type":"list", - "member":{ - "shape":"TagKey", - "locationName":"TagKey" - }, - "flattened":true - }, - "TagMap":{ - "type":"map", - "key":{ - "shape":"TagKey", - "locationName":"Key" - }, - "value":{ - "shape":"TagValue", - "locationName":"Value" - }, - "flattened":true, - "locationName":"Tag" - }, - "TagQueueRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "Tags" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the queue.

" - }, - "Tags":{ - "shape":"TagMap", - "documentation":"

The list of tags to be added to the specified queue.

" - } - } - }, - "TagValue":{"type":"string"}, - "TooManyEntriesInBatchRequest":{ - "type":"structure", - "members":{ - }, - "documentation":"

The batch request contains more entries than permissible.

", - "error":{ - "code":"AWS.SimpleQueueService.TooManyEntriesInBatchRequest", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UnsupportedOperation":{ - "type":"structure", - "members":{ - }, - "documentation":"

Error code 400. Unsupported operation.

", - "error":{ - "code":"AWS.SimpleQueueService.UnsupportedOperation", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "UntagQueueRequest":{ - "type":"structure", - "required":[ - "QueueUrl", - "TagKeys" - ], - "members":{ - "QueueUrl":{ - "shape":"String", - "documentation":"

The URL of the queue.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The list of tags to be removed from the specified queue.

" - } - } - } - }, - "documentation":"

Welcome to the Amazon Simple Queue Service API Reference.

Amazon Simple Queue Service (Amazon SQS) is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.

Standard queues are available in all regions. FIFO queues are available in the US East (N. Virginia), US East (Ohio), US West (Oregon), and EU (Ireland) regions.

You can use AWS SDKs to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:

  • Cryptographically sign your service requests

  • Retry requests

  • Handle error responses

Additional Information

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/paginators-1.json deleted file mode 100644 index 94790e81..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/paginators-1.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "pagination": { - "ListAssociations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Associations" - }, - "ListCommandInvocations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "CommandInvocations" - }, - "ListCommands": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Commands" - }, - "ListDocuments": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "DocumentIdentifiers" - }, - "DescribeInstanceInformation": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "InstanceInformationList" - }, - "DescribeActivations": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "ActivationList" - }, - "DescribeParameters": { - "input_token": "NextToken", - "output_token": "NextToken", - "limit_key": "MaxResults", - "result_key": "Parameters" - }, - "GetParametersByPath": { - "result_key": "Parameters", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "GetParameterHistory": { - "result_key": "Parameters", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/service-2.json deleted file mode 100644 index 1521383f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/ssm/2014-11-06/service-2.json +++ /dev/null @@ -1,11296 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2014-11-06", - "endpointPrefix":"ssm", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"Amazon SSM", - "serviceFullName":"Amazon Simple Systems Manager (SSM)", - "serviceId":"SSM", - "signatureVersion":"v4", - "targetPrefix":"AmazonSSM", - "uid":"ssm-2014-11-06" - }, - "operations":{ - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceRequest"}, - "output":{"shape":"AddTagsToResourceResult"}, - "errors":[ - {"shape":"InvalidResourceType"}, - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"}, - {"shape":"TooManyTagsError"}, - {"shape":"TooManyUpdates"} - ], - "documentation":"

Adds or overwrites one or more tags for the specified resource. Tags are metadata that you can assign to your documents, managed instances, Maintenance Windows, Parameter Store parameters, and patch baselines. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test.

Each resource can have a maximum of 50 tags.

We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters.

For more information about tags, see Tagging Your Amazon EC2 Resources in the Amazon EC2 User Guide.

" - }, - "CancelCommand":{ - "name":"CancelCommand", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelCommandRequest"}, - "output":{"shape":"CancelCommandResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidCommandId"}, - {"shape":"InvalidInstanceId"}, - {"shape":"DuplicateInstanceId"} - ], - "documentation":"

Attempts to cancel the command specified by the Command ID. There is no guarantee that the command will be terminated and the underlying process stopped.

" - }, - "CreateActivation":{ - "name":"CreateActivation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateActivationRequest"}, - "output":{"shape":"CreateActivationResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Registers your on-premises server or virtual machine with Amazon EC2 so that you can manage these resources using Run Command. An on-premises server or virtual machine that has been registered with EC2 is called a managed instance. For more information about activations, see Setting Up Systems Manager in Hybrid Environments.

" - }, - "CreateAssociation":{ - "name":"CreateAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAssociationRequest"}, - "output":{"shape":"CreateAssociationResult"}, - "errors":[ - {"shape":"AssociationAlreadyExists"}, - {"shape":"AssociationLimitExceeded"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"InvalidInstanceId"}, - {"shape":"UnsupportedPlatformType"}, - {"shape":"InvalidOutputLocation"}, - {"shape":"InvalidParameters"}, - {"shape":"InvalidTarget"}, - {"shape":"InvalidSchedule"} - ], - "documentation":"

Associates the specified Systems Manager document with the specified instances or targets.

When you associate a document with one or more instances using instance IDs or tags, the SSM Agent running on the instance processes the document and configures the instance as specified.

If you associate a document with an instance that already has an associated document, the system throws the AssociationAlreadyExists exception.

" - }, - "CreateAssociationBatch":{ - "name":"CreateAssociationBatch", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAssociationBatchRequest"}, - "output":{"shape":"CreateAssociationBatchResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidParameters"}, - {"shape":"DuplicateInstanceId"}, - {"shape":"AssociationLimitExceeded"}, - {"shape":"UnsupportedPlatformType"}, - {"shape":"InvalidOutputLocation"}, - {"shape":"InvalidTarget"}, - {"shape":"InvalidSchedule"} - ], - "documentation":"

Associates the specified Systems Manager document with the specified instances or targets.

When you associate a document with one or more instances using instance IDs or tags, the SSM Agent running on the instance processes the document and configures the instance as specified.

If you associate a document with an instance that already has an associated document, the system throws the AssociationAlreadyExists exception.

" - }, - "CreateDocument":{ - "name":"CreateDocument", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateDocumentRequest"}, - "output":{"shape":"CreateDocumentResult"}, - "errors":[ - {"shape":"DocumentAlreadyExists"}, - {"shape":"MaxDocumentSizeExceeded"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidDocumentContent"}, - {"shape":"DocumentLimitExceeded"}, - {"shape":"InvalidDocumentSchemaVersion"} - ], - "documentation":"

Creates a Systems Manager document.

After you create a document, you can use CreateAssociation to associate it with one or more running instances.

" - }, - "CreateMaintenanceWindow":{ - "name":"CreateMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateMaintenanceWindowRequest"}, - "output":{"shape":"CreateMaintenanceWindowResult"}, - "errors":[ - {"shape":"IdempotentParameterMismatch"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a new Maintenance Window.

" - }, - "CreatePatchBaseline":{ - "name":"CreatePatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreatePatchBaselineRequest"}, - "output":{"shape":"CreatePatchBaselineResult"}, - "errors":[ - {"shape":"IdempotentParameterMismatch"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a patch baseline.

For information about valid key and value pairs in PatchFilters for each supported operating system type, see PatchFilter.

" - }, - "CreateResourceDataSync":{ - "name":"CreateResourceDataSync", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateResourceDataSyncRequest"}, - "output":{"shape":"CreateResourceDataSyncResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"ResourceDataSyncCountExceededException"}, - {"shape":"ResourceDataSyncAlreadyExistsException"}, - {"shape":"ResourceDataSyncInvalidConfigurationException"} - ], - "documentation":"

Creates a resource data sync configuration to a single bucket in Amazon S3. This is an asynchronous operation that returns immediately. After a successful initial sync is completed, the system continuously syncs data to the Amazon S3 bucket. To check the status of the sync, use the ListResourceDataSync.

By default, data is not encrypted in Amazon S3. We strongly recommend that you enable encryption in Amazon S3 to ensure secure data storage. We also recommend that you secure access to the Amazon S3 bucket by creating a restrictive bucket policy. To view an example of a restrictive Amazon S3 bucket policy for Resource Data Sync, see Create a Resource Data Sync for Inventory in the AWS Systems Manager User Guide.

" - }, - "DeleteActivation":{ - "name":"DeleteActivation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteActivationRequest"}, - "output":{"shape":"DeleteActivationResult"}, - "errors":[ - {"shape":"InvalidActivationId"}, - {"shape":"InvalidActivation"}, - {"shape":"InternalServerError"}, - {"shape":"TooManyUpdates"} - ], - "documentation":"

Deletes an activation. You are not required to delete an activation. If you delete an activation, you can no longer use it to register additional managed instances. Deleting an activation does not de-register managed instances. You must manually de-register managed instances.

" - }, - "DeleteAssociation":{ - "name":"DeleteAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAssociationRequest"}, - "output":{"shape":"DeleteAssociationResult"}, - "errors":[ - {"shape":"AssociationDoesNotExist"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidInstanceId"}, - {"shape":"TooManyUpdates"} - ], - "documentation":"

Disassociates the specified Systems Manager document from the specified instance.

When you disassociate a document from an instance, it does not change the configuration of the instance. To change the configuration state of an instance after you disassociate a document, you must create a new document with the desired configuration and associate it with the instance.

" - }, - "DeleteDocument":{ - "name":"DeleteDocument", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteDocumentRequest"}, - "output":{"shape":"DeleteDocumentResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentOperation"}, - {"shape":"AssociatedInstances"} - ], - "documentation":"

Deletes the Systems Manager document and all instance associations to the document.

Before you delete the document, we recommend that you use DeleteAssociation to disassociate all instances that are associated with the document.

" - }, - "DeleteInventory":{ - "name":"DeleteInventory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteInventoryRequest"}, - "output":{"shape":"DeleteInventoryResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidTypeNameException"}, - {"shape":"InvalidOptionException"}, - {"shape":"InvalidDeleteInventoryParametersException"}, - {"shape":"InvalidInventoryRequestException"} - ], - "documentation":"

Delete a custom inventory type, or the data associated with a custom Inventory type. Deleting a custom inventory type is also referred to as deleting a custom inventory schema.

" - }, - "DeleteMaintenanceWindow":{ - "name":"DeleteMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMaintenanceWindowRequest"}, - "output":{"shape":"DeleteMaintenanceWindowResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a Maintenance Window.

" - }, - "DeleteParameter":{ - "name":"DeleteParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteParameterRequest"}, - "output":{"shape":"DeleteParameterResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"ParameterNotFound"} - ], - "documentation":"

Delete a parameter from the system.

" - }, - "DeleteParameters":{ - "name":"DeleteParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteParametersRequest"}, - "output":{"shape":"DeleteParametersResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Delete a list of parameters. This API is used to delete parameters by using the Amazon EC2 console.

" - }, - "DeletePatchBaseline":{ - "name":"DeletePatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePatchBaselineRequest"}, - "output":{"shape":"DeletePatchBaselineResult"}, - "errors":[ - {"shape":"ResourceInUseException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a patch baseline.

" - }, - "DeleteResourceDataSync":{ - "name":"DeleteResourceDataSync", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteResourceDataSyncRequest"}, - "output":{"shape":"DeleteResourceDataSyncResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"ResourceDataSyncNotFoundException"} - ], - "documentation":"

Deletes a Resource Data Sync configuration. After the configuration is deleted, changes to inventory data on managed instances are no longer synced with the target Amazon S3 bucket. Deleting a sync configuration does not delete data in the target Amazon S3 bucket.

" - }, - "DeregisterManagedInstance":{ - "name":"DeregisterManagedInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterManagedInstanceRequest"}, - "output":{"shape":"DeregisterManagedInstanceResult"}, - "errors":[ - {"shape":"InvalidInstanceId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Removes the server or virtual machine from the list of registered servers. You can reregister the instance again at any time. If you don't plan to use Run Command on the server, we suggest uninstalling SSM Agent first.

" - }, - "DeregisterPatchBaselineForPatchGroup":{ - "name":"DeregisterPatchBaselineForPatchGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterPatchBaselineForPatchGroupRequest"}, - "output":{"shape":"DeregisterPatchBaselineForPatchGroupResult"}, - "errors":[ - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Removes a patch group from a patch baseline.

" - }, - "DeregisterTargetFromMaintenanceWindow":{ - "name":"DeregisterTargetFromMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterTargetFromMaintenanceWindowRequest"}, - "output":{"shape":"DeregisterTargetFromMaintenanceWindowResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"}, - {"shape":"TargetInUseException"} - ], - "documentation":"

Removes a target from a Maintenance Window.

" - }, - "DeregisterTaskFromMaintenanceWindow":{ - "name":"DeregisterTaskFromMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterTaskFromMaintenanceWindowRequest"}, - "output":{"shape":"DeregisterTaskFromMaintenanceWindowResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Removes a task from a Maintenance Window.

" - }, - "DescribeActivations":{ - "name":"DescribeActivations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeActivationsRequest"}, - "output":{"shape":"DescribeActivationsResult"}, - "errors":[ - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Details about the activation, including: the date and time the activation was created, the expiration date, the IAM role assigned to the instances in the activation, and the number of instances activated by this registration.

" - }, - "DescribeAssociation":{ - "name":"DescribeAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssociationRequest"}, - "output":{"shape":"DescribeAssociationResult"}, - "errors":[ - {"shape":"AssociationDoesNotExist"}, - {"shape":"InvalidAssociationVersion"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidInstanceId"} - ], - "documentation":"

Describes the association for the specified target or instance. If you created the association by using the Targets parameter, then you must retrieve the association by using the association ID. If you created the association by specifying an instance ID and a Systems Manager document, then you retrieve the association by specifying the document name and the instance ID.

" - }, - "DescribeAssociationExecutionTargets":{ - "name":"DescribeAssociationExecutionTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssociationExecutionTargetsRequest"}, - "output":{"shape":"DescribeAssociationExecutionTargetsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"AssociationDoesNotExist"}, - {"shape":"InvalidNextToken"}, - {"shape":"AssociationExecutionDoesNotExist"} - ], - "documentation":"

Use this API action to view information about a specific execution of a specific association.

" - }, - "DescribeAssociationExecutions":{ - "name":"DescribeAssociationExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAssociationExecutionsRequest"}, - "output":{"shape":"DescribeAssociationExecutionsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"AssociationDoesNotExist"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Use this API action to view all executions for a specific association ID.

" - }, - "DescribeAutomationExecutions":{ - "name":"DescribeAutomationExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAutomationExecutionsRequest"}, - "output":{"shape":"DescribeAutomationExecutionsResult"}, - "errors":[ - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidFilterValue"}, - {"shape":"InvalidNextToken"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Provides details about all active and terminated Automation executions.

" - }, - "DescribeAutomationStepExecutions":{ - "name":"DescribeAutomationStepExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAutomationStepExecutionsRequest"}, - "output":{"shape":"DescribeAutomationStepExecutionsResult"}, - "errors":[ - {"shape":"AutomationExecutionNotFoundException"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidFilterValue"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Information about all active and terminated step executions in an Automation workflow.

" - }, - "DescribeAvailablePatches":{ - "name":"DescribeAvailablePatches", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAvailablePatchesRequest"}, - "output":{"shape":"DescribeAvailablePatchesResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists all patches that could possibly be included in a patch baseline.

" - }, - "DescribeDocument":{ - "name":"DescribeDocument", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDocumentRequest"}, - "output":{"shape":"DescribeDocumentResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"} - ], - "documentation":"

Describes the specified Systems Manager document.

" - }, - "DescribeDocumentPermission":{ - "name":"DescribeDocumentPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDocumentPermissionRequest"}, - "output":{"shape":"DescribeDocumentPermissionResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidPermissionType"} - ], - "documentation":"

Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user's AWS account ID) or publicly (All).

" - }, - "DescribeEffectiveInstanceAssociations":{ - "name":"DescribeEffectiveInstanceAssociations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEffectiveInstanceAssociationsRequest"}, - "output":{"shape":"DescribeEffectiveInstanceAssociationsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

All associations for the instance(s).

" - }, - "DescribeEffectivePatchesForPatchBaseline":{ - "name":"DescribeEffectivePatchesForPatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeEffectivePatchesForPatchBaselineRequest"}, - "output":{"shape":"DescribeEffectivePatchesForPatchBaselineResult"}, - "errors":[ - {"shape":"InvalidResourceId"}, - {"shape":"DoesNotExistException"}, - {"shape":"UnsupportedOperatingSystem"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline. Note that this API applies only to Windows patch baselines.

" - }, - "DescribeInstanceAssociationsStatus":{ - "name":"DescribeInstanceAssociationsStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceAssociationsStatusRequest"}, - "output":{"shape":"DescribeInstanceAssociationsStatusResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

The status of the associations for the instance(s).

" - }, - "DescribeInstanceInformation":{ - "name":"DescribeInstanceInformation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstanceInformationRequest"}, - "output":{"shape":"DescribeInstanceInformationResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidInstanceInformationFilterValue"}, - {"shape":"InvalidFilterKey"} - ], - "documentation":"

Describes one or more of your instances. You can use this to get information about instances like the operating system platform, the SSM Agent version (Linux), status etc. If you specify one or more instance IDs, it returns information for those instances. If you do not specify instance IDs, it returns information for all your instances. If you specify an instance ID that is not valid or an instance that you do not own, you receive an error.

The IamRole field for this API action is the Amazon Identity and Access Management (IAM) role assigned to on-premises instances. This call does not return the IAM role for Amazon EC2 instances.

" - }, - "DescribeInstancePatchStates":{ - "name":"DescribeInstancePatchStates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancePatchStatesRequest"}, - "output":{"shape":"DescribeInstancePatchStatesResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieves the high-level patch state of one or more instances.

" - }, - "DescribeInstancePatchStatesForPatchGroup":{ - "name":"DescribeInstancePatchStatesForPatchGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancePatchStatesForPatchGroupRequest"}, - "output":{"shape":"DescribeInstancePatchStatesForPatchGroupResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieves the high-level patch state for the instances in the specified patch group.

" - }, - "DescribeInstancePatches":{ - "name":"DescribeInstancePatches", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInstancePatchesRequest"}, - "output":{"shape":"DescribeInstancePatchesResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieves information about the patches on the specified instance and their state relative to the patch baseline being used for the instance.

" - }, - "DescribeInventoryDeletions":{ - "name":"DescribeInventoryDeletions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeInventoryDeletionsRequest"}, - "output":{"shape":"DescribeInventoryDeletionsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDeletionIdException"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Describes a specific delete inventory operation.

" - }, - "DescribeMaintenanceWindowExecutionTaskInvocations":{ - "name":"DescribeMaintenanceWindowExecutionTaskInvocations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowExecutionTaskInvocationsRequest"}, - "output":{"shape":"DescribeMaintenanceWindowExecutionTaskInvocationsResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the individual task executions (one per target) for a particular task executed as part of a Maintenance Window execution.

" - }, - "DescribeMaintenanceWindowExecutionTasks":{ - "name":"DescribeMaintenanceWindowExecutionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowExecutionTasksRequest"}, - "output":{"shape":"DescribeMaintenanceWindowExecutionTasksResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

For a given Maintenance Window execution, lists the tasks that were executed.

" - }, - "DescribeMaintenanceWindowExecutions":{ - "name":"DescribeMaintenanceWindowExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowExecutionsRequest"}, - "output":{"shape":"DescribeMaintenanceWindowExecutionsResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the executions of a Maintenance Window. This includes information about when the Maintenance Window was scheduled to be active, and information about tasks registered and run with the Maintenance Window.

" - }, - "DescribeMaintenanceWindowTargets":{ - "name":"DescribeMaintenanceWindowTargets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowTargetsRequest"}, - "output":{"shape":"DescribeMaintenanceWindowTargetsResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the targets registered with the Maintenance Window.

" - }, - "DescribeMaintenanceWindowTasks":{ - "name":"DescribeMaintenanceWindowTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowTasksRequest"}, - "output":{"shape":"DescribeMaintenanceWindowTasksResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the tasks in a Maintenance Window.

" - }, - "DescribeMaintenanceWindows":{ - "name":"DescribeMaintenanceWindows", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceWindowsRequest"}, - "output":{"shape":"DescribeMaintenanceWindowsResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the Maintenance Windows in an AWS account.

" - }, - "DescribeParameters":{ - "name":"DescribeParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeParametersRequest"}, - "output":{"shape":"DescribeParametersResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidFilterOption"}, - {"shape":"InvalidFilterValue"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Get information about a parameter.

Request results are returned on a best-effort basis. If you specify MaxResults in the request, the response includes information up to the limit specified. The number of items returned, however, can be between zero and the value of MaxResults. If the service reaches an internal limit while processing the results, it stops the operation and returns the matching values up to that point and a NextToken. You can specify the NextToken in a subsequent call to get the next set of results.

" - }, - "DescribePatchBaselines":{ - "name":"DescribePatchBaselines", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePatchBaselinesRequest"}, - "output":{"shape":"DescribePatchBaselinesResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the patch baselines in your AWS account.

" - }, - "DescribePatchGroupState":{ - "name":"DescribePatchGroupState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePatchGroupStateRequest"}, - "output":{"shape":"DescribePatchGroupStateResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Returns high-level aggregated patch compliance state for a patch group.

" - }, - "DescribePatchGroups":{ - "name":"DescribePatchGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribePatchGroupsRequest"}, - "output":{"shape":"DescribePatchGroupsResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Lists all patch groups that have been registered with patch baselines.

" - }, - "GetAutomationExecution":{ - "name":"GetAutomationExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetAutomationExecutionRequest"}, - "output":{"shape":"GetAutomationExecutionResult"}, - "errors":[ - {"shape":"AutomationExecutionNotFoundException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Get detailed information about a particular Automation execution.

" - }, - "GetCommandInvocation":{ - "name":"GetCommandInvocation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCommandInvocationRequest"}, - "output":{"shape":"GetCommandInvocationResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidCommandId"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidPluginName"}, - {"shape":"InvocationDoesNotExist"} - ], - "documentation":"

Returns detailed information about command execution for an invocation or plugin.

" - }, - "GetDefaultPatchBaseline":{ - "name":"GetDefaultPatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDefaultPatchBaselineRequest"}, - "output":{"shape":"GetDefaultPatchBaselineResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the default patch baseline. Note that Systems Manager supports creating multiple default patch baselines. For example, you can create a default patch baseline for each operating system.

If you do not specify an operating system value, the default patch baseline for Windows is returned.

" - }, - "GetDeployablePatchSnapshotForInstance":{ - "name":"GetDeployablePatchSnapshotForInstance", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDeployablePatchSnapshotForInstanceRequest"}, - "output":{"shape":"GetDeployablePatchSnapshotForInstanceResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"UnsupportedOperatingSystem"} - ], - "documentation":"

Retrieves the current snapshot for the patch baseline the instance uses. This API is primarily used by the AWS-RunPatchBaseline Systems Manager document.

" - }, - "GetDocument":{ - "name":"GetDocument", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetDocumentRequest"}, - "output":{"shape":"GetDocumentResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"} - ], - "documentation":"

Gets the contents of the specified Systems Manager document.

" - }, - "GetInventory":{ - "name":"GetInventory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInventoryRequest"}, - "output":{"shape":"GetInventoryResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidTypeNameException"}, - {"shape":"InvalidResultAttributeException"} - ], - "documentation":"

Query inventory information.

" - }, - "GetInventorySchema":{ - "name":"GetInventorySchema", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetInventorySchemaRequest"}, - "output":{"shape":"GetInventorySchemaResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidTypeNameException"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Return a list of inventory type names for the account, or return a list of attribute names for a specific Inventory item type.

" - }, - "GetMaintenanceWindow":{ - "name":"GetMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMaintenanceWindowRequest"}, - "output":{"shape":"GetMaintenanceWindowResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves a Maintenance Window.

" - }, - "GetMaintenanceWindowExecution":{ - "name":"GetMaintenanceWindowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMaintenanceWindowExecutionRequest"}, - "output":{"shape":"GetMaintenanceWindowExecutionResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves details about a specific task executed as part of a Maintenance Window execution.

" - }, - "GetMaintenanceWindowExecutionTask":{ - "name":"GetMaintenanceWindowExecutionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMaintenanceWindowExecutionTaskRequest"}, - "output":{"shape":"GetMaintenanceWindowExecutionTaskResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the details about a specific task executed as part of a Maintenance Window execution.

" - }, - "GetMaintenanceWindowExecutionTaskInvocation":{ - "name":"GetMaintenanceWindowExecutionTaskInvocation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMaintenanceWindowExecutionTaskInvocationRequest"}, - "output":{"shape":"GetMaintenanceWindowExecutionTaskInvocationResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves a task invocation. A task invocation is a specific task executing on a specific target. Maintenance Windows report status for all invocations.

" - }, - "GetMaintenanceWindowTask":{ - "name":"GetMaintenanceWindowTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetMaintenanceWindowTaskRequest"}, - "output":{"shape":"GetMaintenanceWindowTaskResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the tasks in a Maintenance Window.

" - }, - "GetParameter":{ - "name":"GetParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetParameterRequest"}, - "output":{"shape":"GetParameterResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidKeyId"}, - {"shape":"ParameterNotFound"}, - {"shape":"ParameterVersionNotFound"} - ], - "documentation":"

Get information about a parameter by using the parameter name. Don't confuse this API action with the GetParameters API action.

" - }, - "GetParameterHistory":{ - "name":"GetParameterHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetParameterHistoryRequest"}, - "output":{"shape":"GetParameterHistoryResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"ParameterNotFound"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidKeyId"} - ], - "documentation":"

Query a list of all parameters used by the AWS account.

" - }, - "GetParameters":{ - "name":"GetParameters", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetParametersRequest"}, - "output":{"shape":"GetParametersResult"}, - "errors":[ - {"shape":"InvalidKeyId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Get details of a parameter. Don't confuse this API action with the GetParameter API action.

" - }, - "GetParametersByPath":{ - "name":"GetParametersByPath", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetParametersByPathRequest"}, - "output":{"shape":"GetParametersByPathResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidFilterOption"}, - {"shape":"InvalidFilterValue"}, - {"shape":"InvalidKeyId"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Retrieve parameters in a specific hierarchy. For more information, see Working with Systems Manager Parameters in the AWS Systems Manager User Guide.

Request results are returned on a best-effort basis. If you specify MaxResults in the request, the response includes information up to the limit specified. The number of items returned, however, can be between zero and the value of MaxResults. If the service reaches an internal limit while processing the results, it stops the operation and returns the matching values up to that point and a NextToken. You can specify the NextToken in a subsequent call to get the next set of results.

This API action doesn't support filtering by tags.

" - }, - "GetPatchBaseline":{ - "name":"GetPatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPatchBaselineRequest"}, - "output":{"shape":"GetPatchBaselineResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves information about a patch baseline.

" - }, - "GetPatchBaselineForPatchGroup":{ - "name":"GetPatchBaselineForPatchGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPatchBaselineForPatchGroupRequest"}, - "output":{"shape":"GetPatchBaselineForPatchGroupResult"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the patch baseline that should be used for the specified patch group.

" - }, - "LabelParameterVersion":{ - "name":"LabelParameterVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"LabelParameterVersionRequest"}, - "output":{"shape":"LabelParameterVersionResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"TooManyUpdates"}, - {"shape":"ParameterNotFound"}, - {"shape":"ParameterVersionNotFound"}, - {"shape":"ParameterVersionLabelLimitExceeded"} - ], - "documentation":"

A parameter label is a user-defined alias to help you manage different versions of a parameter. When you modify a parameter, Systems Manager automatically saves a new version and increments the version number by one. A label can help you remember the purpose of a parameter when there are multiple versions.

Parameter labels have the following requirements and restrictions.

  • A version of a parameter can have a maximum of 10 labels.

  • You can't attach the same label to different versions of the same parameter. For example, if version 1 has the label Production, then you can't attach Production to version 2.

  • You can move a label from one version of a parameter to another.

  • You can't create a label when you create a new parameter. You must attach a label to a specific version of a parameter.

  • You can't delete a parameter label. If you no longer want to use a parameter label, then you must move it to a different version of a parameter.

  • A label can have a maximum of 100 characters.

  • Labels can contain letters (case sensitive), numbers, periods (.), hyphens (-), or underscores (_).

  • Labels can't begin with a number, \"aws,\" or \"ssm\" (not case sensitive). If a label fails to meet these requirements, then the label is not associated with a parameter and the system displays it in the list of InvalidLabels.

" - }, - "ListAssociationVersions":{ - "name":"ListAssociationVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssociationVersionsRequest"}, - "output":{"shape":"ListAssociationVersionsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"}, - {"shape":"AssociationDoesNotExist"} - ], - "documentation":"

Retrieves all versions of an association for a specific association ID.

" - }, - "ListAssociations":{ - "name":"ListAssociations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAssociationsRequest"}, - "output":{"shape":"ListAssociationsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Lists the associations for the specified Systems Manager document or instance.

" - }, - "ListCommandInvocations":{ - "name":"ListCommandInvocations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCommandInvocationsRequest"}, - "output":{"shape":"ListCommandInvocationsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidCommandId"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

An invocation is copy of a command sent to a specific instance. A command can apply to one or more instances. A command invocation applies to one instance. For example, if a user executes SendCommand against three instances, then a command invocation is created for each requested instance ID. ListCommandInvocations provide status about command execution.

" - }, - "ListCommands":{ - "name":"ListCommands", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListCommandsRequest"}, - "output":{"shape":"ListCommandsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidCommandId"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidFilterKey"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Lists the commands requested by users of the AWS account.

" - }, - "ListComplianceItems":{ - "name":"ListComplianceItems", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListComplianceItemsRequest"}, - "output":{"shape":"ListComplianceItemsResult"}, - "errors":[ - {"shape":"InvalidResourceType"}, - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

For a specified resource ID, this API action returns a list of compliance statuses for different resource types. Currently, you can only specify one resource ID per call. List results depend on the criteria specified in the filter.

" - }, - "ListComplianceSummaries":{ - "name":"ListComplianceSummaries", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListComplianceSummariesRequest"}, - "output":{"shape":"ListComplianceSummariesResult"}, - "errors":[ - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a summary count of compliant and non-compliant resources for a compliance type. For example, this call can return State Manager associations, patches, or custom compliance types according to the filter criteria that you specify.

" - }, - "ListDocumentVersions":{ - "name":"ListDocumentVersions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDocumentVersionsRequest"}, - "output":{"shape":"ListDocumentVersionsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidDocument"} - ], - "documentation":"

List all versions for a document.

" - }, - "ListDocuments":{ - "name":"ListDocuments", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDocumentsRequest"}, - "output":{"shape":"ListDocumentsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"}, - {"shape":"InvalidFilterKey"} - ], - "documentation":"

Describes one or more of your Systems Manager documents.

" - }, - "ListInventoryEntries":{ - "name":"ListInventoryEntries", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListInventoryEntriesRequest"}, - "output":{"shape":"ListInventoryEntriesResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidTypeNameException"}, - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

A list of inventory items returned by the request.

" - }, - "ListResourceComplianceSummaries":{ - "name":"ListResourceComplianceSummaries", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourceComplianceSummariesRequest"}, - "output":{"shape":"ListResourceComplianceSummariesResult"}, - "errors":[ - {"shape":"InvalidFilter"}, - {"shape":"InvalidNextToken"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a resource-level summary count. The summary includes information about compliant and non-compliant statuses and detailed compliance-item severity counts, according to the filter criteria you specify.

" - }, - "ListResourceDataSync":{ - "name":"ListResourceDataSync", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourceDataSyncRequest"}, - "output":{"shape":"ListResourceDataSyncResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidNextToken"} - ], - "documentation":"

Lists your resource data sync configurations. Includes information about the last time a sync attempted to start, the last sync status, and the last time a sync successfully completed.

The number of sync configurations might be too large to return using a single call to ListResourceDataSync. You can limit the number of sync configurations returned by using the MaxResults parameter. To determine whether there are more sync configurations to list, check the value of NextToken in the output. If there are more sync configurations to list, you can request them by specifying the NextToken returned in the call to the parameter of a subsequent call.

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceRequest"}, - "output":{"shape":"ListTagsForResourceResult"}, - "errors":[ - {"shape":"InvalidResourceType"}, - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a list of the tags assigned to the specified resource.

" - }, - "ModifyDocumentPermission":{ - "name":"ModifyDocumentPermission", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyDocumentPermissionRequest"}, - "output":{"shape":"ModifyDocumentPermissionResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidPermissionType"}, - {"shape":"DocumentPermissionLimit"}, - {"shape":"DocumentLimitExceeded"} - ], - "documentation":"

Shares a Systems Manager document publicly or privately. If you share a document privately, you must specify the AWS user account IDs for those people who can use the document. If you share a document publicly, you must specify All as the account ID.

" - }, - "PutComplianceItems":{ - "name":"PutComplianceItems", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutComplianceItemsRequest"}, - "output":{"shape":"PutComplianceItemsResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidItemContentException"}, - {"shape":"TotalSizeLimitExceededException"}, - {"shape":"ItemSizeLimitExceededException"}, - {"shape":"ComplianceTypeCountLimitExceededException"}, - {"shape":"InvalidResourceType"}, - {"shape":"InvalidResourceId"} - ], - "documentation":"

Registers a compliance type and other compliance details on a designated resource. This action lets you register custom compliance details with a resource. This call overwrites existing compliance information on the resource, so you must provide a full list of compliance items each time that you send the request.

ComplianceType can be one of the following:

  • ExecutionId: The execution ID when the patch, association, or custom compliance item was applied.

  • ExecutionType: Specify patch, association, or Custom:string.

  • ExecutionTime. The time the patch, association, or custom compliance item was applied to the instance.

  • Id: The patch, association, or custom compliance ID.

  • Title: A title.

  • Status: The status of the compliance item. For example, approved for patches, or Failed for associations.

  • Severity: A patch severity. For example, critical.

  • DocumentName: A SSM document name. For example, AWS-RunPatchBaseline.

  • DocumentVersion: An SSM document version number. For example, 4.

  • Classification: A patch classification. For example, security updates.

  • PatchBaselineId: A patch baseline ID.

  • PatchSeverity: A patch severity. For example, Critical.

  • PatchState: A patch state. For example, InstancesWithFailedPatches.

  • PatchGroup: The name of a patch group.

  • InstalledTime: The time the association, patch, or custom compliance item was applied to the resource. Specify the time by using the following format: yyyy-MM-dd'T'HH:mm:ss'Z'

" - }, - "PutInventory":{ - "name":"PutInventory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutInventoryRequest"}, - "output":{"shape":"PutInventoryResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidTypeNameException"}, - {"shape":"InvalidItemContentException"}, - {"shape":"TotalSizeLimitExceededException"}, - {"shape":"ItemSizeLimitExceededException"}, - {"shape":"ItemContentMismatchException"}, - {"shape":"CustomSchemaCountLimitExceededException"}, - {"shape":"UnsupportedInventorySchemaVersionException"}, - {"shape":"UnsupportedInventoryItemContextException"}, - {"shape":"InvalidInventoryItemContextException"}, - {"shape":"SubTypeCountLimitExceededException"} - ], - "documentation":"

Bulk update custom inventory items on one more instance. The request adds an inventory item, if it doesn't already exist, or updates an inventory item, if it does exist.

" - }, - "PutParameter":{ - "name":"PutParameter", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutParameterRequest"}, - "output":{"shape":"PutParameterResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidKeyId"}, - {"shape":"ParameterLimitExceeded"}, - {"shape":"TooManyUpdates"}, - {"shape":"ParameterAlreadyExists"}, - {"shape":"HierarchyLevelLimitExceededException"}, - {"shape":"HierarchyTypeMismatchException"}, - {"shape":"InvalidAllowedPatternException"}, - {"shape":"ParameterMaxVersionLimitExceeded"}, - {"shape":"ParameterPatternMismatchException"}, - {"shape":"UnsupportedParameterType"} - ], - "documentation":"

Add a parameter to the system.

" - }, - "RegisterDefaultPatchBaseline":{ - "name":"RegisterDefaultPatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterDefaultPatchBaselineRequest"}, - "output":{"shape":"RegisterDefaultPatchBaselineResult"}, - "errors":[ - {"shape":"InvalidResourceId"}, - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Defines the default patch baseline.

" - }, - "RegisterPatchBaselineForPatchGroup":{ - "name":"RegisterPatchBaselineForPatchGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterPatchBaselineForPatchGroupRequest"}, - "output":{"shape":"RegisterPatchBaselineForPatchGroupResult"}, - "errors":[ - {"shape":"AlreadyExistsException"}, - {"shape":"DoesNotExistException"}, - {"shape":"InvalidResourceId"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Registers a patch baseline for a patch group.

" - }, - "RegisterTargetWithMaintenanceWindow":{ - "name":"RegisterTargetWithMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterTargetWithMaintenanceWindowRequest"}, - "output":{"shape":"RegisterTargetWithMaintenanceWindowResult"}, - "errors":[ - {"shape":"IdempotentParameterMismatch"}, - {"shape":"DoesNotExistException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Registers a target with a Maintenance Window.

" - }, - "RegisterTaskWithMaintenanceWindow":{ - "name":"RegisterTaskWithMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterTaskWithMaintenanceWindowRequest"}, - "output":{"shape":"RegisterTaskWithMaintenanceWindowResult"}, - "errors":[ - {"shape":"IdempotentParameterMismatch"}, - {"shape":"DoesNotExistException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"FeatureNotAvailableException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Adds a new task to a Maintenance Window.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceRequest"}, - "output":{"shape":"RemoveTagsFromResourceResult"}, - "errors":[ - {"shape":"InvalidResourceType"}, - {"shape":"InvalidResourceId"}, - {"shape":"InternalServerError"}, - {"shape":"TooManyUpdates"} - ], - "documentation":"

Removes all tags from the specified resource.

" - }, - "SendAutomationSignal":{ - "name":"SendAutomationSignal", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendAutomationSignalRequest"}, - "output":{"shape":"SendAutomationSignalResult"}, - "errors":[ - {"shape":"AutomationExecutionNotFoundException"}, - {"shape":"AutomationStepNotFoundException"}, - {"shape":"InvalidAutomationSignalException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Sends a signal to an Automation execution to change the current behavior or status of the execution.

" - }, - "SendCommand":{ - "name":"SendCommand", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendCommandRequest"}, - "output":{"shape":"SendCommandResult"}, - "errors":[ - {"shape":"DuplicateInstanceId"}, - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"InvalidOutputFolder"}, - {"shape":"InvalidParameters"}, - {"shape":"UnsupportedPlatformType"}, - {"shape":"MaxDocumentSizeExceeded"}, - {"shape":"InvalidRole"}, - {"shape":"InvalidNotificationConfig"} - ], - "documentation":"

Executes commands on one or more managed instances.

" - }, - "StartAssociationsOnce":{ - "name":"StartAssociationsOnce", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartAssociationsOnceRequest"}, - "output":{"shape":"StartAssociationsOnceResult"}, - "errors":[ - {"shape":"InvalidAssociation"}, - {"shape":"AssociationDoesNotExist"} - ], - "documentation":"

Use this API action to execute an association immediately and only one time. This action can be helpful when troubleshooting associations.

" - }, - "StartAutomationExecution":{ - "name":"StartAutomationExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartAutomationExecutionRequest"}, - "output":{"shape":"StartAutomationExecutionResult"}, - "errors":[ - {"shape":"AutomationDefinitionNotFoundException"}, - {"shape":"InvalidAutomationExecutionParametersException"}, - {"shape":"AutomationExecutionLimitExceededException"}, - {"shape":"AutomationDefinitionVersionNotFoundException"}, - {"shape":"IdempotentParameterMismatch"}, - {"shape":"InvalidTarget"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Initiates execution of an Automation document.

" - }, - "StopAutomationExecution":{ - "name":"StopAutomationExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopAutomationExecutionRequest"}, - "output":{"shape":"StopAutomationExecutionResult"}, - "errors":[ - {"shape":"AutomationExecutionNotFoundException"}, - {"shape":"InvalidAutomationStatusUpdateException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Stop an Automation that is currently executing.

" - }, - "UpdateAssociation":{ - "name":"UpdateAssociation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAssociationRequest"}, - "output":{"shape":"UpdateAssociationResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidSchedule"}, - {"shape":"InvalidParameters"}, - {"shape":"InvalidOutputLocation"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"AssociationDoesNotExist"}, - {"shape":"InvalidUpdate"}, - {"shape":"TooManyUpdates"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidTarget"}, - {"shape":"InvalidAssociationVersion"}, - {"shape":"AssociationVersionLimitExceeded"} - ], - "documentation":"

Updates an association. You can update the association name and version, the document version, schedule, parameters, and Amazon S3 output.

" - }, - "UpdateAssociationStatus":{ - "name":"UpdateAssociationStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateAssociationStatusRequest"}, - "output":{"shape":"UpdateAssociationStatusResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidInstanceId"}, - {"shape":"InvalidDocument"}, - {"shape":"AssociationDoesNotExist"}, - {"shape":"StatusUnchanged"}, - {"shape":"TooManyUpdates"} - ], - "documentation":"

Updates the status of the Systems Manager document associated with the specified instance.

" - }, - "UpdateDocument":{ - "name":"UpdateDocument", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDocumentRequest"}, - "output":{"shape":"UpdateDocumentResult"}, - "errors":[ - {"shape":"MaxDocumentSizeExceeded"}, - {"shape":"DocumentVersionLimitExceeded"}, - {"shape":"InternalServerError"}, - {"shape":"DuplicateDocumentContent"}, - {"shape":"InvalidDocumentContent"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"InvalidDocumentSchemaVersion"}, - {"shape":"InvalidDocument"} - ], - "documentation":"

The document you want to update.

" - }, - "UpdateDocumentDefaultVersion":{ - "name":"UpdateDocumentDefaultVersion", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateDocumentDefaultVersionRequest"}, - "output":{"shape":"UpdateDocumentDefaultVersionResult"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"InvalidDocument"}, - {"shape":"InvalidDocumentVersion"}, - {"shape":"InvalidDocumentSchemaVersion"} - ], - "documentation":"

Set the default version of a document.

" - }, - "UpdateMaintenanceWindow":{ - "name":"UpdateMaintenanceWindow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMaintenanceWindowRequest"}, - "output":{"shape":"UpdateMaintenanceWindowResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates an existing Maintenance Window. Only specified parameters are modified.

" - }, - "UpdateMaintenanceWindowTarget":{ - "name":"UpdateMaintenanceWindowTarget", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMaintenanceWindowTargetRequest"}, - "output":{"shape":"UpdateMaintenanceWindowTargetResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Modifies the target of an existing Maintenance Window. You can't change the target type, but you can change the following:

The target from being an ID target to a Tag target, or a Tag target to an ID target.

IDs for an ID target.

Tags for a Tag target.

Owner.

Name.

Description.

If a parameter is null, then the corresponding field is not modified.

" - }, - "UpdateMaintenanceWindowTask":{ - "name":"UpdateMaintenanceWindowTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMaintenanceWindowTaskRequest"}, - "output":{"shape":"UpdateMaintenanceWindowTaskResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Modifies a task assigned to a Maintenance Window. You can't change the task type, but you can change the following values:

  • TaskARN. For example, you can change a RUN_COMMAND task from AWS-RunPowerShellScript to AWS-RunShellScript.

  • ServiceRoleArn

  • TaskInvocationParameters

  • Priority

  • MaxConcurrency

  • MaxErrors

If a parameter is null, then the corresponding field is not modified. Also, if you set Replace to true, then all fields required by the RegisterTaskWithMaintenanceWindow action are required for this request. Optional fields that aren't specified are set to null.

" - }, - "UpdateManagedInstanceRole":{ - "name":"UpdateManagedInstanceRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateManagedInstanceRoleRequest"}, - "output":{"shape":"UpdateManagedInstanceRoleResult"}, - "errors":[ - {"shape":"InvalidInstanceId"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Assigns or changes an Amazon Identity and Access Management (IAM) role to the managed instance.

" - }, - "UpdatePatchBaseline":{ - "name":"UpdatePatchBaseline", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePatchBaselineRequest"}, - "output":{"shape":"UpdatePatchBaselineResult"}, - "errors":[ - {"shape":"DoesNotExistException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Modifies an existing patch baseline. Fields not specified in the request are left unchanged.

For information about valid key and value pairs in PatchFilters for each supported operating system type, see PatchFilter.

" - } - }, - "shapes":{ - "AccountId":{ - "type":"string", - "pattern":"(?i)all|[0-9]{12}" - }, - "AccountIdList":{ - "type":"list", - "member":{"shape":"AccountId"}, - "max":20 - }, - "Activation":{ - "type":"structure", - "members":{ - "ActivationId":{ - "shape":"ActivationId", - "documentation":"

The ID created by Systems Manager when you submitted the activation.

" - }, - "Description":{ - "shape":"ActivationDescription", - "documentation":"

A user defined description of the activation.

" - }, - "DefaultInstanceName":{ - "shape":"DefaultInstanceName", - "documentation":"

A name for the managed instance when it is created.

" - }, - "IamRole":{ - "shape":"IamRole", - "documentation":"

The Amazon Identity and Access Management (IAM) role to assign to the managed instance.

" - }, - "RegistrationLimit":{ - "shape":"RegistrationLimit", - "documentation":"

The maximum number of managed instances that can be registered using this activation.

" - }, - "RegistrationsCount":{ - "shape":"RegistrationsCount", - "documentation":"

The number of managed instances already registered with this activation.

" - }, - "ExpirationDate":{ - "shape":"ExpirationDate", - "documentation":"

The date when this activation can no longer be used to register managed instances.

" - }, - "Expired":{ - "shape":"Boolean", - "documentation":"

Whether or not the activation is expired.

" - }, - "CreatedDate":{ - "shape":"CreatedDate", - "documentation":"

The date the activation was created.

" - } - }, - "documentation":"

An activation registers one or more on-premises servers or virtual machines (VMs) with AWS so that you can configure those servers or VMs using Run Command. A server or VM that has been registered with AWS is called a managed instance.

" - }, - "ActivationCode":{ - "type":"string", - "max":250, - "min":20 - }, - "ActivationDescription":{ - "type":"string", - "max":256, - "min":0 - }, - "ActivationId":{ - "type":"string", - "pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" - }, - "ActivationList":{ - "type":"list", - "member":{"shape":"Activation"} - }, - "AddTagsToResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId", - "Tags" - ], - "members":{ - "ResourceType":{ - "shape":"ResourceTypeForTagging", - "documentation":"

Specifies the type of resource you are tagging.

The ManagedInstance type for this API action is for on-premises managed instances. You must specify the the name of the managed instance in the following format: mi-ID_number. For example, mi-1a2b3c4d5e6f.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource ID you want to tag.

Use the ID of the resource. Here are some examples:

ManagedInstance: mi-012345abcde

MaintenanceWindow: mw-012345abcde

PatchBaseline: pb-012345abcde

For the Document and Parameter values, use the name of the resource.

The ManagedInstance type for this API action is only for on-premises managed instances. You must specify the the name of the managed instance in the following format: mi-ID_number. For example, mi-1a2b3c4d5e6f.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

Do not enter personally identifiable information in this field.

" - } - } - }, - "AddTagsToResourceResult":{ - "type":"structure", - "members":{ - } - }, - "AgentErrorCode":{ - "type":"string", - "max":10 - }, - "AggregatorSchemaOnly":{"type":"boolean"}, - "AllowedPattern":{ - "type":"string", - "max":1024, - "min":0 - }, - "AlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Error returned if an attempt is made to register a patch group with a patch baseline that is already registered with a different patch baseline.

", - "exception":true - }, - "ApproveAfterDays":{ - "type":"integer", - "max":100, - "min":0 - }, - "AssociatedInstances":{ - "type":"structure", - "members":{ - }, - "documentation":"

You must disassociate a document from all instances before you can delete it.

", - "exception":true - }, - "Association":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The ID created by the system when you create an association. An association is a binding between a document and a set of targets with a schedule.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The association version.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of the document used in the association.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The instances targeted by the request to create an association.

" - }, - "LastExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date on which the association was last run.

" - }, - "Overview":{ - "shape":"AssociationOverview", - "documentation":"

Information about the association.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

A cron expression that specifies a schedule when the association runs.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

The association name.

" - } - }, - "documentation":"

Describes an association of a Systems Manager document and an instance.

" - }, - "AssociationAlreadyExists":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified association already exists.

", - "exception":true - }, - "AssociationDescription":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The association version.

" - }, - "Date":{ - "shape":"DateTime", - "documentation":"

The date when the association was made.

" - }, - "LastUpdateAssociationDate":{ - "shape":"DateTime", - "documentation":"

The date when the association was last updated.

" - }, - "Status":{ - "shape":"AssociationStatus", - "documentation":"

The association status.

" - }, - "Overview":{ - "shape":"AssociationOverview", - "documentation":"

Information about the association.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A description of the parameters for a document.

" - }, - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The instances targeted by the request.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

A cron expression that specifies a schedule when the association runs.

" - }, - "OutputLocation":{ - "shape":"InstanceAssociationOutputLocation", - "documentation":"

An Amazon S3 bucket where you want to store the output details of the request.

" - }, - "LastExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date on which the association was last run.

" - }, - "LastSuccessfulExecutionDate":{ - "shape":"DateTime", - "documentation":"

The last date on which the association was successfully run.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

The association name.

" - } - }, - "documentation":"

Describes the parameters for a document.

" - }, - "AssociationDescriptionList":{ - "type":"list", - "member":{"shape":"AssociationDescription"} - }, - "AssociationDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified association does not exist.

", - "exception":true - }, - "AssociationExecution":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The association version.

" - }, - "ExecutionId":{ - "shape":"AssociationExecutionId", - "documentation":"

The execution ID for the association. If the association does not run at intervals or according to a schedule, then the ExecutionID is the same as the AssociationID.

" - }, - "Status":{ - "shape":"StatusName", - "documentation":"

The status of the association execution.

" - }, - "DetailedStatus":{ - "shape":"StatusName", - "documentation":"

Detailed status information about the execution.

" - }, - "CreatedTime":{ - "shape":"DateTime", - "documentation":"

The time the execution started.

" - }, - "LastExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date of the last execution.

" - }, - "ResourceCountByStatus":{ - "shape":"ResourceCountByStatus", - "documentation":"

An aggregate status of the resources in the execution based on the status type.

" - } - }, - "documentation":"

Includes information about the specified association.

" - }, - "AssociationExecutionDoesNotExist":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified execution ID does not exist. Verify the ID number and try again.

", - "exception":true - }, - "AssociationExecutionFilter":{ - "type":"structure", - "required":[ - "Key", - "Value", - "Type" - ], - "members":{ - "Key":{ - "shape":"AssociationExecutionFilterKey", - "documentation":"

The key value used in the request.

" - }, - "Value":{ - "shape":"AssociationExecutionFilterValue", - "documentation":"

The value specified for the key.

" - }, - "Type":{ - "shape":"AssociationFilterOperatorType", - "documentation":"

The filter type specified in the request.

" - } - }, - "documentation":"

Filters used in the request.

" - }, - "AssociationExecutionFilterKey":{ - "type":"string", - "enum":[ - "ExecutionId", - "Status", - "CreatedTime" - ] - }, - "AssociationExecutionFilterList":{ - "type":"list", - "member":{"shape":"AssociationExecutionFilter"}, - "min":1 - }, - "AssociationExecutionFilterValue":{ - "type":"string", - "min":1 - }, - "AssociationExecutionId":{ - "type":"string", - "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" - }, - "AssociationExecutionTarget":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The association version.

" - }, - "ExecutionId":{ - "shape":"AssociationExecutionId", - "documentation":"

The execution ID. If the association does not run at intervals or according to a schedule, then the ExecutionID is the same as the AssociationID.

" - }, - "ResourceId":{ - "shape":"AssociationResourceId", - "documentation":"

The resource ID, for example, the instance ID where the association ran.

" - }, - "ResourceType":{ - "shape":"AssociationResourceType", - "documentation":"

The resource type, for example, instance.

" - }, - "Status":{ - "shape":"StatusName", - "documentation":"

The association execution status.

" - }, - "DetailedStatus":{ - "shape":"StatusName", - "documentation":"

Detailed information about the execution status.

" - }, - "LastExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date of the last execution.

" - }, - "OutputSource":{ - "shape":"OutputSource", - "documentation":"

The location where the association details are saved.

" - } - }, - "documentation":"

Includes information about the specified association execution.

" - }, - "AssociationExecutionTargetsFilter":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"AssociationExecutionTargetsFilterKey", - "documentation":"

The key value used in the request.

" - }, - "Value":{ - "shape":"AssociationExecutionTargetsFilterValue", - "documentation":"

The value specified for the key.

" - } - }, - "documentation":"

Filters for the association execution.

" - }, - "AssociationExecutionTargetsFilterKey":{ - "type":"string", - "enum":[ - "Status", - "ResourceId", - "ResourceType" - ] - }, - "AssociationExecutionTargetsFilterList":{ - "type":"list", - "member":{"shape":"AssociationExecutionTargetsFilter"}, - "min":1 - }, - "AssociationExecutionTargetsFilterValue":{ - "type":"string", - "min":1 - }, - "AssociationExecutionTargetsList":{ - "type":"list", - "member":{"shape":"AssociationExecutionTarget"} - }, - "AssociationExecutionsList":{ - "type":"list", - "member":{"shape":"AssociationExecution"} - }, - "AssociationFilter":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"AssociationFilterKey", - "documentation":"

The name of the filter.

" - }, - "value":{ - "shape":"AssociationFilterValue", - "documentation":"

The filter value.

" - } - }, - "documentation":"

Describes a filter.

" - }, - "AssociationFilterKey":{ - "type":"string", - "enum":[ - "InstanceId", - "Name", - "AssociationId", - "AssociationStatusName", - "LastExecutedBefore", - "LastExecutedAfter", - "AssociationName" - ] - }, - "AssociationFilterList":{ - "type":"list", - "member":{"shape":"AssociationFilter"}, - "min":1 - }, - "AssociationFilterOperatorType":{ - "type":"string", - "enum":[ - "EQUAL", - "LESS_THAN", - "GREATER_THAN" - ] - }, - "AssociationFilterValue":{ - "type":"string", - "min":1 - }, - "AssociationId":{ - "type":"string", - "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" - }, - "AssociationIdList":{ - "type":"list", - "member":{"shape":"AssociationId"}, - "max":10, - "min":1 - }, - "AssociationLimitExceeded":{ - "type":"structure", - "members":{ - }, - "documentation":"

You can have at most 2,000 active associations.

", - "exception":true - }, - "AssociationList":{ - "type":"list", - "member":{"shape":"Association"} - }, - "AssociationName":{ - "type":"string", - "pattern":"^[a-zA-Z0-9_\\-.]{3,128}$" - }, - "AssociationOverview":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"StatusName", - "documentation":"

The status of the association. Status can be: Pending, Success, or Failed.

" - }, - "DetailedStatus":{ - "shape":"StatusName", - "documentation":"

A detailed status of the association.

" - }, - "AssociationStatusAggregatedCount":{ - "shape":"AssociationStatusAggregatedCount", - "documentation":"

Returns the number of targets for the association status. For example, if you created an association with two instances, and one of them was successful, this would return the count of instances by status.

" - } - }, - "documentation":"

Information about the association.

" - }, - "AssociationResourceId":{ - "type":"string", - "max":100, - "min":1 - }, - "AssociationResourceType":{ - "type":"string", - "max":50, - "min":1 - }, - "AssociationStatus":{ - "type":"structure", - "required":[ - "Date", - "Name", - "Message" - ], - "members":{ - "Date":{ - "shape":"DateTime", - "documentation":"

The date when the status changed.

" - }, - "Name":{ - "shape":"AssociationStatusName", - "documentation":"

The status.

" - }, - "Message":{ - "shape":"StatusMessage", - "documentation":"

The reason for the status.

" - }, - "AdditionalInfo":{ - "shape":"StatusAdditionalInfo", - "documentation":"

A user-defined string.

" - } - }, - "documentation":"

Describes an association status.

" - }, - "AssociationStatusAggregatedCount":{ - "type":"map", - "key":{"shape":"StatusName"}, - "value":{"shape":"InstanceCount"} - }, - "AssociationStatusName":{ - "type":"string", - "enum":[ - "Pending", - "Success", - "Failed" - ] - }, - "AssociationVersion":{ - "type":"string", - "pattern":"([$]LATEST)|([1-9][0-9]*)" - }, - "AssociationVersionInfo":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The ID created by the system when the association was created.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The association version.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date the association version was created.

" - }, - "Name":{ - "shape":"DocumentName", - "documentation":"

The name specified when the association was created.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of a Systems Manager document used when the association version was created.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

Parameters specified when the association version was created.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets specified for the association when the association version was created.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The cron or rate schedule specified for the association when the association version was created.

" - }, - "OutputLocation":{ - "shape":"InstanceAssociationOutputLocation", - "documentation":"

The location in Amazon S3 specified for the association when the association version was created.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

The name specified for the association version when the association version was created.

" - } - }, - "documentation":"

Information about the association version.

" - }, - "AssociationVersionLimitExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You have reached the maximum number versions allowed for an association. Each association has a limit of 1,000 versions.

", - "exception":true - }, - "AssociationVersionList":{ - "type":"list", - "member":{"shape":"AssociationVersionInfo"}, - "min":1 - }, - "AttributeName":{ - "type":"string", - "max":64, - "min":1 - }, - "AttributeValue":{ - "type":"string", - "max":4096, - "min":0 - }, - "AutomationActionName":{ - "type":"string", - "pattern":"^aws:[a-zA-Z]{3,25}$" - }, - "AutomationDefinitionNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An Automation document with the specified name could not be found.

", - "exception":true - }, - "AutomationDefinitionVersionNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An Automation document with the specified name and version could not be found.

", - "exception":true - }, - "AutomationExecution":{ - "type":"structure", - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The execution ID.

" - }, - "DocumentName":{ - "shape":"DocumentName", - "documentation":"

The name of the Automation document used during the execution.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of the document to use during execution.

" - }, - "ExecutionStartTime":{ - "shape":"DateTime", - "documentation":"

The time the execution started.

" - }, - "ExecutionEndTime":{ - "shape":"DateTime", - "documentation":"

The time the execution finished.

" - }, - "AutomationExecutionStatus":{ - "shape":"AutomationExecutionStatus", - "documentation":"

The execution status of the Automation.

" - }, - "StepExecutions":{ - "shape":"StepExecutionList", - "documentation":"

A list of details about the current state of all steps that comprise an execution. An Automation document contains a list of steps that are executed in order.

" - }, - "StepExecutionsTruncated":{ - "shape":"Boolean", - "documentation":"

A boolean value that indicates if the response contains the full list of the Automation step executions. If true, use the DescribeAutomationStepExecutions API action to get the full list of step executions.

" - }, - "Parameters":{ - "shape":"AutomationParameterMap", - "documentation":"

The key-value map of execution parameters, which were supplied when calling StartAutomationExecution.

" - }, - "Outputs":{ - "shape":"AutomationParameterMap", - "documentation":"

The list of execution outputs as defined in the automation document.

" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

A message describing why an execution has failed, if the status is set to Failed.

" - }, - "Mode":{ - "shape":"ExecutionMode", - "documentation":"

The automation execution mode.

" - }, - "ParentAutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The AutomationExecutionId of the parent automation.

" - }, - "ExecutedBy":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the user who executed the automation.

" - }, - "CurrentStepName":{ - "shape":"String", - "documentation":"

The name of the currently executing step.

" - }, - "CurrentAction":{ - "shape":"String", - "documentation":"

The action of the currently executing step.

" - }, - "TargetParameterName":{ - "shape":"AutomationParameterKey", - "documentation":"

The parameter name.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The specified targets.

" - }, - "TargetMaps":{ - "shape":"TargetMaps", - "documentation":"

The specified key-value mapping of document parameters to target resources.

" - }, - "ResolvedTargets":{ - "shape":"ResolvedTargets", - "documentation":"

A list of resolved targets in the rate control execution.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The MaxConcurrency value specified by the user when the execution started.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The MaxErrors value specified by the user when the execution started.

" - }, - "Target":{ - "shape":"String", - "documentation":"

The target of the execution.

" - } - }, - "documentation":"

Detailed information about the current state of an individual Automation execution.

" - }, - "AutomationExecutionFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"AutomationExecutionFilterKey", - "documentation":"

One or more keys to limit the results. Valid filter keys include the following: DocumentNamePrefix, ExecutionStatus, ExecutionId, ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter.

" - }, - "Values":{ - "shape":"AutomationExecutionFilterValueList", - "documentation":"

The values used to limit the execution information associated with the filter's key.

" - } - }, - "documentation":"

A filter used to match specific automation executions. This is used to limit the scope of Automation execution information returned.

" - }, - "AutomationExecutionFilterKey":{ - "type":"string", - "enum":[ - "DocumentNamePrefix", - "ExecutionStatus", - "ExecutionId", - "ParentExecutionId", - "CurrentAction", - "StartTimeBefore", - "StartTimeAfter" - ] - }, - "AutomationExecutionFilterList":{ - "type":"list", - "member":{"shape":"AutomationExecutionFilter"}, - "max":10, - "min":1 - }, - "AutomationExecutionFilterValue":{ - "type":"string", - "max":150, - "min":1 - }, - "AutomationExecutionFilterValueList":{ - "type":"list", - "member":{"shape":"AutomationExecutionFilterValue"}, - "max":10, - "min":1 - }, - "AutomationExecutionId":{ - "type":"string", - "max":36, - "min":36 - }, - "AutomationExecutionLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The number of simultaneously running Automation executions exceeded the allowable limit.

", - "exception":true - }, - "AutomationExecutionMetadata":{ - "type":"structure", - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The execution ID.

" - }, - "DocumentName":{ - "shape":"DocumentName", - "documentation":"

The name of the Automation document used during execution.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version used during the execution.

" - }, - "AutomationExecutionStatus":{ - "shape":"AutomationExecutionStatus", - "documentation":"

The status of the execution. Valid values include: Running, Succeeded, Failed, Timed out, or Cancelled.

" - }, - "ExecutionStartTime":{ - "shape":"DateTime", - "documentation":"

The time the execution started.>

" - }, - "ExecutionEndTime":{ - "shape":"DateTime", - "documentation":"

The time the execution finished. This is not populated if the execution is still in progress.

" - }, - "ExecutedBy":{ - "shape":"String", - "documentation":"

The IAM role ARN of the user who executed the Automation.

" - }, - "LogFile":{ - "shape":"String", - "documentation":"

An Amazon S3 bucket where execution information is stored.

" - }, - "Outputs":{ - "shape":"AutomationParameterMap", - "documentation":"

The list of execution outputs as defined in the Automation document.

" - }, - "Mode":{ - "shape":"ExecutionMode", - "documentation":"

The Automation execution mode.

" - }, - "ParentAutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The ExecutionId of the parent Automation.

" - }, - "CurrentStepName":{ - "shape":"String", - "documentation":"

The name of the currently executing step.

" - }, - "CurrentAction":{ - "shape":"String", - "documentation":"

The action of the currently executing step.

" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

The list of execution outputs as defined in the Automation document.

" - }, - "TargetParameterName":{ - "shape":"AutomationParameterKey", - "documentation":"

The list of execution outputs as defined in the Automation document.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets defined by the user when starting the Automation.

" - }, - "TargetMaps":{ - "shape":"TargetMaps", - "documentation":"

The specified key-value mapping of document parameters to target resources.

" - }, - "ResolvedTargets":{ - "shape":"ResolvedTargets", - "documentation":"

A list of targets that resolved during the execution.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The MaxConcurrency value specified by the user when starting the Automation.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The MaxErrors value specified by the user when starting the Automation.

" - }, - "Target":{ - "shape":"String", - "documentation":"

The list of execution outputs as defined in the Automation document.

" - } - }, - "documentation":"

Details about a specific Automation execution.

" - }, - "AutomationExecutionMetadataList":{ - "type":"list", - "member":{"shape":"AutomationExecutionMetadata"} - }, - "AutomationExecutionNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

There is no automation execution information for the requested automation execution ID.

", - "exception":true - }, - "AutomationExecutionStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Waiting", - "Success", - "TimedOut", - "Cancelling", - "Cancelled", - "Failed" - ] - }, - "AutomationParameterKey":{ - "type":"string", - "max":30, - "min":1 - }, - "AutomationParameterMap":{ - "type":"map", - "key":{"shape":"AutomationParameterKey"}, - "value":{"shape":"AutomationParameterValueList"}, - "max":200, - "min":1 - }, - "AutomationParameterValue":{ - "type":"string", - "max":512, - "min":1 - }, - "AutomationParameterValueList":{ - "type":"list", - "member":{"shape":"AutomationParameterValue"}, - "max":10, - "min":0 - }, - "AutomationStepNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified step name and execution ID don't exist. Verify the information and try again.

", - "exception":true - }, - "BaselineDescription":{ - "type":"string", - "max":1024, - "min":1 - }, - "BaselineId":{ - "type":"string", - "max":128, - "min":20, - "pattern":"^[a-zA-Z0-9_\\-:/]{20,128}$" - }, - "BaselineName":{ - "type":"string", - "max":128, - "min":3, - "pattern":"^[a-zA-Z0-9_\\-.]{3,128}$" - }, - "BatchErrorMessage":{"type":"string"}, - "Boolean":{"type":"boolean"}, - "CancelCommandRequest":{ - "type":"structure", - "required":["CommandId"], - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

The ID of the command you want to cancel.

" - }, - "InstanceIds":{ - "shape":"InstanceIdList", - "documentation":"

(Optional) A list of instance IDs on which you want to cancel the command. If not provided, the command is canceled on every instance on which it was requested.

" - } - }, - "documentation":"

" - }, - "CancelCommandResult":{ - "type":"structure", - "members":{ - }, - "documentation":"

Whether or not the command was successfully canceled. There is no guarantee that a request can be canceled.

" - }, - "ClientToken":{ - "type":"string", - "max":64, - "min":1 - }, - "CloudWatchLogGroupName":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[\\.\\-_/#A-Za-z0-9]+" - }, - "CloudWatchOutputConfig":{ - "type":"structure", - "members":{ - "CloudWatchLogGroupName":{ - "shape":"CloudWatchLogGroupName", - "documentation":"

The name of the CloudWatch log group where you want to send command output. If you don't specify a group name, Systems Manager automatically creates a log group for you. The log group uses the following naming format: aws/ssm/SystemsManagerDocumentName.

" - }, - "CloudWatchOutputEnabled":{ - "shape":"CloudWatchOutputEnabled", - "documentation":"

Enables Systems Manager to send command output to CloudWatch Logs.

" - } - }, - "documentation":"

Configuration options for sending command output to CloudWatch Logs.

" - }, - "CloudWatchOutputEnabled":{"type":"boolean"}, - "Command":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

A unique identifier for this command.

" - }, - "DocumentName":{ - "shape":"DocumentName", - "documentation":"

The name of the document requested for execution.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The SSM document version.

" - }, - "Comment":{ - "shape":"Comment", - "documentation":"

User-specified information about the command, such as a brief description of what the command should do.

" - }, - "ExpiresAfter":{ - "shape":"DateTime", - "documentation":"

If this time is reached and the command has not already started executing, it will not run. Calculated based on the ExpiresAfter user input provided as part of the SendCommand API.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The parameter values to be inserted in the document when executing the command.

" - }, - "InstanceIds":{ - "shape":"InstanceIdList", - "documentation":"

The instance IDs against which this command was requested.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.

" - }, - "RequestedDateTime":{ - "shape":"DateTime", - "documentation":"

The date and time the command was requested.

" - }, - "Status":{ - "shape":"CommandStatus", - "documentation":"

The status of the command.

" - }, - "StatusDetails":{ - "shape":"StatusDetails", - "documentation":"

A detailed status of the command execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding Command Statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:

  • Pending: The command has not been sent to any instances.

  • In Progress: The command has been sent to at least one instance but has not reached a final state on all instances.

  • Success: The command successfully executed on all invocations. This is a terminal state.

  • Delivery Timed Out: The value of MaxErrors or more command invocations shows a status of Delivery Timed Out. This is a terminal state.

  • Execution Timed Out: The value of MaxErrors or more command invocations shows a status of Execution Timed Out. This is a terminal state.

  • Failed: The value of MaxErrors or more command invocations shows a status of Failed. This is a terminal state.

  • Incomplete: The command was attempted on all instances and one or more invocations does not have a value of Success but not enough invocations failed for the status to be Failed. This is a terminal state.

  • Canceled: The command was terminated before it was completed. This is a terminal state.

  • Rate Exceeded: The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before executing it on any instance. This is a terminal state.

" - }, - "OutputS3Region":{ - "shape":"S3Region", - "documentation":"

(Deprecated) You can no longer specify this parameter. The system ignores it. Instead, Systems Manager automatically determines the Amazon S3 bucket region.

" - }, - "OutputS3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command.

" - }, - "OutputS3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The maximum number of instances that are allowed to execute the command at the same time. You can specify a number of instances, such as 10, or a percentage of instances, such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see Executing Commands Using Systems Manager Run Command in the AWS Systems Manager User Guide.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The maximum number of errors allowed before the system stops sending the command to additional targets. You can specify a number of errors, such as 10, or a percentage or errors, such as 10%. The default value is 0. For more information about how to use MaxErrors, see Executing Commands Using Systems Manager Run Command in the AWS Systems Manager User Guide.

" - }, - "TargetCount":{ - "shape":"TargetCount", - "documentation":"

The number of targets for the command.

" - }, - "CompletedCount":{ - "shape":"CompletedCount", - "documentation":"

The number of targets for which the command invocation reached a terminal state. Terminal states include the following: Success, Failed, Execution Timed Out, Delivery Timed Out, Canceled, Terminated, or Undeliverable.

" - }, - "ErrorCount":{ - "shape":"ErrorCount", - "documentation":"

The number of targets for which the status is Failed or Execution Timed Out.

" - }, - "DeliveryTimedOutCount":{ - "shape":"DeliveryTimedOutCount", - "documentation":"

The number of targets for which the status is Delivery Timed Out.

" - }, - "ServiceRole":{ - "shape":"ServiceRole", - "documentation":"

The IAM service role that Run Command uses to act on your behalf when sending notifications about command status changes.

" - }, - "NotificationConfig":{ - "shape":"NotificationConfig", - "documentation":"

Configurations for sending notifications about command status changes.

" - }, - "CloudWatchOutputConfig":{ - "shape":"CloudWatchOutputConfig", - "documentation":"

CloudWatch Logs information where you want Systems Manager to send the command output.

" - } - }, - "documentation":"

Describes a command request.

" - }, - "CommandFilter":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"CommandFilterKey", - "documentation":"

The name of the filter.

" - }, - "value":{ - "shape":"CommandFilterValue", - "documentation":"

The filter value.

" - } - }, - "documentation":"

Describes a command filter.

" - }, - "CommandFilterKey":{ - "type":"string", - "enum":[ - "InvokedAfter", - "InvokedBefore", - "Status" - ] - }, - "CommandFilterList":{ - "type":"list", - "member":{"shape":"CommandFilter"}, - "max":3, - "min":1 - }, - "CommandFilterValue":{ - "type":"string", - "min":1 - }, - "CommandId":{ - "type":"string", - "max":36, - "min":36 - }, - "CommandInvocation":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

The command against which this invocation was requested.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID in which this invocation was requested.

" - }, - "InstanceName":{ - "shape":"InstanceTagName", - "documentation":"

The name of the invocation target. For Amazon EC2 instances this is the value for the aws:Name tag. For on-premises instances, this is the name of the instance.

" - }, - "Comment":{ - "shape":"Comment", - "documentation":"

User-specified information about the command, such as a brief description of what the command should do.

" - }, - "DocumentName":{ - "shape":"DocumentName", - "documentation":"

The document name that was requested for execution.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The SSM document version.

" - }, - "RequestedDateTime":{ - "shape":"DateTime", - "documentation":"

The time and date the request was sent to this instance.

" - }, - "Status":{ - "shape":"CommandInvocationStatus", - "documentation":"

Whether or not the invocation succeeded, failed, or is pending.

" - }, - "StatusDetails":{ - "shape":"StatusDetails", - "documentation":"

A detailed status of the command execution for each invocation (each instance targeted by the command). StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding Command Statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:

  • Pending: The command has not been sent to the instance.

  • In Progress: The command has been sent to the instance but has not reached a terminal state.

  • Success: The execution of the command or plugin was successfully completed. This is a terminal state.

  • Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.

  • Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.

  • Canceled: The command was terminated before it was completed. This is a terminal state.

  • Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.

" - }, - "TraceOutput":{ - "shape":"InvocationTraceOutput", - "documentation":"

Gets the trace output sent by the agent.

" - }, - "StandardOutputUrl":{ - "shape":"Url", - "documentation":"

The URL to the plugin's StdOut file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardOutputUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.

" - }, - "StandardErrorUrl":{ - "shape":"Url", - "documentation":"

The URL to the plugin's StdErr file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardErrorUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.

" - }, - "CommandPlugins":{"shape":"CommandPluginList"}, - "ServiceRole":{ - "shape":"ServiceRole", - "documentation":"

The IAM service role that Run Command uses to act on your behalf when sending notifications about command status changes on a per instance basis.

" - }, - "NotificationConfig":{ - "shape":"NotificationConfig", - "documentation":"

Configurations for sending notifications about command status changes on a per instance basis.

" - }, - "CloudWatchOutputConfig":{ - "shape":"CloudWatchOutputConfig", - "documentation":"

CloudWatch Logs information where you want Systems Manager to send the command output.

" - } - }, - "documentation":"

An invocation is copy of a command sent to a specific instance. A command can apply to one or more instances. A command invocation applies to one instance. For example, if a user executes SendCommand against three instances, then a command invocation is created for each requested instance ID. A command invocation returns status and detail information about a command you executed.

" - }, - "CommandInvocationList":{ - "type":"list", - "member":{"shape":"CommandInvocation"} - }, - "CommandInvocationStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Delayed", - "Success", - "Cancelled", - "TimedOut", - "Failed", - "Cancelling" - ] - }, - "CommandList":{ - "type":"list", - "member":{"shape":"Command"} - }, - "CommandMaxResults":{ - "type":"integer", - "max":50, - "min":1 - }, - "CommandPlugin":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"CommandPluginName", - "documentation":"

The name of the plugin. Must be one of the following: aws:updateAgent, aws:domainjoin, aws:applications, aws:runPowerShellScript, aws:psmodule, aws:cloudWatch, aws:runShellScript, or aws:updateSSMAgent.

" - }, - "Status":{ - "shape":"CommandPluginStatus", - "documentation":"

The status of this plugin. You can execute a document with multiple plugins.

" - }, - "StatusDetails":{ - "shape":"StatusDetails", - "documentation":"

A detailed status of the plugin execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding Command Statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:

  • Pending: The command has not been sent to the instance.

  • In Progress: The command has been sent to the instance but has not reached a terminal state.

  • Success: The execution of the command or plugin was successfully completed. This is a terminal state.

  • Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.

  • Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.

  • Canceled: The command was terminated before it was completed. This is a terminal state.

  • Undeliverable: The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit, and they don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.

" - }, - "ResponseCode":{ - "shape":"ResponseCode", - "documentation":"

A numeric response code generated after executing the plugin.

" - }, - "ResponseStartDateTime":{ - "shape":"DateTime", - "documentation":"

The time the plugin started executing.

" - }, - "ResponseFinishDateTime":{ - "shape":"DateTime", - "documentation":"

The time the plugin stopped executing. Could stop prematurely if, for example, a cancel command was sent.

" - }, - "Output":{ - "shape":"CommandPluginOutput", - "documentation":"

Output of the plugin execution.

" - }, - "StandardOutputUrl":{ - "shape":"Url", - "documentation":"

The URL for the complete text written by the plugin to stdout in Amazon S3. If the Amazon S3 bucket for the command was not specified, then this string is empty.

" - }, - "StandardErrorUrl":{ - "shape":"Url", - "documentation":"

The URL for the complete text written by the plugin to stderr. If execution is not yet complete, then this string is empty.

" - }, - "OutputS3Region":{ - "shape":"S3Region", - "documentation":"

(Deprecated) You can no longer specify this parameter. The system ignores it. Instead, Systems Manager automatically determines the Amazon S3 bucket region.

" - }, - "OutputS3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:

test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript

test_folder is the name of the Amazon S3 bucket;

ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;

i-1234567876543 is the instance ID;

awsrunShellScript is the name of the plugin.

" - }, - "OutputS3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:

test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript

test_folder is the name of the Amazon S3 bucket;

ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;

i-1234567876543 is the instance ID;

awsrunShellScript is the name of the plugin.

" - } - }, - "documentation":"

Describes plugin details.

" - }, - "CommandPluginList":{ - "type":"list", - "member":{"shape":"CommandPlugin"} - }, - "CommandPluginName":{ - "type":"string", - "min":4 - }, - "CommandPluginOutput":{ - "type":"string", - "max":2500 - }, - "CommandPluginStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Success", - "TimedOut", - "Cancelled", - "Failed" - ] - }, - "CommandStatus":{ - "type":"string", - "enum":[ - "Pending", - "InProgress", - "Success", - "Cancelled", - "Failed", - "TimedOut", - "Cancelling" - ] - }, - "Comment":{ - "type":"string", - "max":100 - }, - "CompletedCount":{"type":"integer"}, - "ComplianceExecutionId":{ - "type":"string", - "max":100 - }, - "ComplianceExecutionSummary":{ - "type":"structure", - "required":["ExecutionTime"], - "members":{ - "ExecutionTime":{ - "shape":"DateTime", - "documentation":"

The time the execution ran as a datetime object that is saved in the following format: yyyy-MM-dd'T'HH:mm:ss'Z'.

" - }, - "ExecutionId":{ - "shape":"ComplianceExecutionId", - "documentation":"

An ID created by the system when PutComplianceItems was called. For example, CommandID is a valid execution ID. You can use this ID in subsequent calls.

" - }, - "ExecutionType":{ - "shape":"ComplianceExecutionType", - "documentation":"

The type of execution. For example, Command is a valid execution type.

" - } - }, - "documentation":"

A summary of the call execution that includes an execution ID, the type of execution (for example, Command), and the date/time of the execution using a datetime object that is saved in the following format: yyyy-MM-dd'T'HH:mm:ss'Z'.

" - }, - "ComplianceExecutionType":{ - "type":"string", - "max":50 - }, - "ComplianceFilterValue":{"type":"string"}, - "ComplianceItem":{ - "type":"structure", - "members":{ - "ComplianceType":{ - "shape":"ComplianceTypeName", - "documentation":"

The compliance type. For example, Association (for a State Manager association), Patch, or Custom:string are all valid compliance types.

" - }, - "ResourceType":{ - "shape":"ComplianceResourceType", - "documentation":"

The type of resource. ManagedInstance is currently the only supported resource type.

" - }, - "ResourceId":{ - "shape":"ComplianceResourceId", - "documentation":"

An ID for the resource. For a managed instance, this is the instance ID.

" - }, - "Id":{ - "shape":"ComplianceItemId", - "documentation":"

An ID for the compliance item. For example, if the compliance item is a Windows patch, the ID could be the number of the KB article; for example: KB4010320.

" - }, - "Title":{ - "shape":"ComplianceItemTitle", - "documentation":"

A title for the compliance item. For example, if the compliance item is a Windows patch, the title could be the title of the KB article for the patch; for example: Security Update for Active Directory Federation Services.

" - }, - "Status":{ - "shape":"ComplianceStatus", - "documentation":"

The status of the compliance item. An item is either COMPLIANT or NON_COMPLIANT.

" - }, - "Severity":{ - "shape":"ComplianceSeverity", - "documentation":"

The severity of the compliance status. Severity can be one of the following: Critical, High, Medium, Low, Informational, Unspecified.

" - }, - "ExecutionSummary":{ - "shape":"ComplianceExecutionSummary", - "documentation":"

A summary for the compliance item. The summary includes an execution ID, the execution type (for example, command), and the execution time.

" - }, - "Details":{ - "shape":"ComplianceItemDetails", - "documentation":"

A \"Key\": \"Value\" tag combination for the compliance item.

" - } - }, - "documentation":"

Information about the compliance as defined by the resource type. For example, for a patch resource type, Items includes information about the PatchSeverity, Classification, etc.

" - }, - "ComplianceItemContentHash":{ - "type":"string", - "max":256 - }, - "ComplianceItemDetails":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"} - }, - "ComplianceItemEntry":{ - "type":"structure", - "required":[ - "Severity", - "Status" - ], - "members":{ - "Id":{ - "shape":"ComplianceItemId", - "documentation":"

The compliance item ID. For example, if the compliance item is a Windows patch, the ID could be the number of the KB article.

" - }, - "Title":{ - "shape":"ComplianceItemTitle", - "documentation":"

The title of the compliance item. For example, if the compliance item is a Windows patch, the title could be the title of the KB article for the patch; for example: Security Update for Active Directory Federation Services.

" - }, - "Severity":{ - "shape":"ComplianceSeverity", - "documentation":"

The severity of the compliance status. Severity can be one of the following: Critical, High, Medium, Low, Informational, Unspecified.

" - }, - "Status":{ - "shape":"ComplianceStatus", - "documentation":"

The status of the compliance item. An item is either COMPLIANT or NON_COMPLIANT.

" - }, - "Details":{ - "shape":"ComplianceItemDetails", - "documentation":"

A \"Key\": \"Value\" tag combination for the compliance item.

" - } - }, - "documentation":"

Information about a compliance item.

" - }, - "ComplianceItemEntryList":{ - "type":"list", - "member":{"shape":"ComplianceItemEntry"}, - "max":10000, - "min":0 - }, - "ComplianceItemId":{ - "type":"string", - "max":100, - "min":1 - }, - "ComplianceItemList":{ - "type":"list", - "member":{"shape":"ComplianceItem"} - }, - "ComplianceItemTitle":{ - "type":"string", - "max":500 - }, - "ComplianceQueryOperatorType":{ - "type":"string", - "enum":[ - "EQUAL", - "NOT_EQUAL", - "BEGIN_WITH", - "LESS_THAN", - "GREATER_THAN" - ] - }, - "ComplianceResourceId":{ - "type":"string", - "max":100, - "min":1 - }, - "ComplianceResourceIdList":{ - "type":"list", - "member":{"shape":"ComplianceResourceId"}, - "min":1 - }, - "ComplianceResourceType":{ - "type":"string", - "max":50, - "min":1 - }, - "ComplianceResourceTypeList":{ - "type":"list", - "member":{"shape":"ComplianceResourceType"}, - "min":1 - }, - "ComplianceSeverity":{ - "type":"string", - "enum":[ - "CRITICAL", - "HIGH", - "MEDIUM", - "LOW", - "INFORMATIONAL", - "UNSPECIFIED" - ] - }, - "ComplianceStatus":{ - "type":"string", - "enum":[ - "COMPLIANT", - "NON_COMPLIANT" - ] - }, - "ComplianceStringFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"ComplianceStringFilterKey", - "documentation":"

The name of the filter.

" - }, - "Values":{ - "shape":"ComplianceStringFilterValueList", - "documentation":"

The value for which to search.

" - }, - "Type":{ - "shape":"ComplianceQueryOperatorType", - "documentation":"

The type of comparison that should be performed for the value: Equal, NotEqual, BeginWith, LessThan, or GreaterThan.

" - } - }, - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "ComplianceStringFilterKey":{ - "type":"string", - "max":200, - "min":1 - }, - "ComplianceStringFilterList":{ - "type":"list", - "member":{"shape":"ComplianceStringFilter"} - }, - "ComplianceStringFilterValueList":{ - "type":"list", - "member":{"shape":"ComplianceFilterValue"}, - "max":20, - "min":1 - }, - "ComplianceSummaryCount":{"type":"integer"}, - "ComplianceSummaryItem":{ - "type":"structure", - "members":{ - "ComplianceType":{ - "shape":"ComplianceTypeName", - "documentation":"

The type of compliance item. For example, the compliance type can be Association, Patch, or Custom:string.

" - }, - "CompliantSummary":{ - "shape":"CompliantSummary", - "documentation":"

A list of COMPLIANT items for the specified compliance type.

" - }, - "NonCompliantSummary":{ - "shape":"NonCompliantSummary", - "documentation":"

A list of NON_COMPLIANT items for the specified compliance type.

" - } - }, - "documentation":"

A summary of compliance information by compliance type.

" - }, - "ComplianceSummaryItemList":{ - "type":"list", - "member":{"shape":"ComplianceSummaryItem"} - }, - "ComplianceTypeCountLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You specified too many custom compliance types. You can specify a maximum of 10 different types.

", - "exception":true - }, - "ComplianceTypeName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"[A-Za-z0-9_\\-]\\w+|Custom:[a-zA-Z0-9_\\-]\\w+" - }, - "CompliantSummary":{ - "type":"structure", - "members":{ - "CompliantCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources that are compliant.

" - }, - "SeveritySummary":{ - "shape":"SeveritySummary", - "documentation":"

A summary of the compliance severity by compliance type.

" - } - }, - "documentation":"

A summary of resources that are compliant. The summary is organized according to the resource count for each compliance type.

" - }, - "ComputerName":{ - "type":"string", - "max":255, - "min":1 - }, - "CreateActivationRequest":{ - "type":"structure", - "required":["IamRole"], - "members":{ - "Description":{ - "shape":"ActivationDescription", - "documentation":"

A user-defined description of the resource that you want to register with Amazon EC2.

Do not enter personally identifiable information in this field.

" - }, - "DefaultInstanceName":{ - "shape":"DefaultInstanceName", - "documentation":"

The name of the registered, managed instance as it will appear in the Amazon EC2 console or when you use the AWS command line tools to list EC2 resources.

Do not enter personally identifiable information in this field.

" - }, - "IamRole":{ - "shape":"IamRole", - "documentation":"

The Amazon Identity and Access Management (IAM) role that you want to assign to the managed instance.

" - }, - "RegistrationLimit":{ - "shape":"RegistrationLimit", - "documentation":"

Specify the maximum number of managed instances you want to register. The default value is 1 instance.

", - "box":true - }, - "ExpirationDate":{ - "shape":"ExpirationDate", - "documentation":"

The date by which this activation request should expire. The default value is 24 hours.

" - } - } - }, - "CreateActivationResult":{ - "type":"structure", - "members":{ - "ActivationId":{ - "shape":"ActivationId", - "documentation":"

The ID number generated by the system when it processed the activation. The activation ID functions like a user name.

" - }, - "ActivationCode":{ - "shape":"ActivationCode", - "documentation":"

The code the system generates when it processes the activation. The activation code functions like a password to validate the activation ID.

" - } - } - }, - "CreateAssociationBatchRequest":{ - "type":"structure", - "required":["Entries"], - "members":{ - "Entries":{ - "shape":"CreateAssociationBatchRequestEntries", - "documentation":"

One or more associations.

" - } - } - }, - "CreateAssociationBatchRequestEntries":{ - "type":"list", - "member":{"shape":"CreateAssociationBatchRequestEntry"}, - "min":1 - }, - "CreateAssociationBatchRequestEntry":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the configuration document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

A description of the parameters for a document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The instances targeted by the request.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

A cron expression that specifies a schedule when the association runs.

" - }, - "OutputLocation":{ - "shape":"InstanceAssociationOutputLocation", - "documentation":"

An Amazon S3 bucket where you want to store the results of this request.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

Specify a descriptive name for the association.

" - } - }, - "documentation":"

Describes the association of a Systems Manager document and an instance.

" - }, - "CreateAssociationBatchResult":{ - "type":"structure", - "members":{ - "Successful":{ - "shape":"AssociationDescriptionList", - "documentation":"

Information about the associations that succeeded.

" - }, - "Failed":{ - "shape":"FailedCreateAssociationList", - "documentation":"

Information about the associations that failed.

" - } - } - }, - "CreateAssociationRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version you want to associate with the target(s). Can be a specific version or the default version.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The parameters for the documents runtime configuration.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or tags) for the association.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

A cron expression when the association will be applied to the target(s).

" - }, - "OutputLocation":{ - "shape":"InstanceAssociationOutputLocation", - "documentation":"

An Amazon S3 bucket where you want to store the output details of the request.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

Specify a descriptive name for the association.

" - } - } - }, - "CreateAssociationResult":{ - "type":"structure", - "members":{ - "AssociationDescription":{ - "shape":"AssociationDescription", - "documentation":"

Information about the association.

" - } - } - }, - "CreateDocumentRequest":{ - "type":"structure", - "required":[ - "Content", - "Name" - ], - "members":{ - "Content":{ - "shape":"DocumentContent", - "documentation":"

A valid JSON or YAML string.

" - }, - "Name":{ - "shape":"DocumentName", - "documentation":"

A name for the Systems Manager document.

Do not use the following to begin the names of documents you create. They are reserved by AWS for use as document prefixes:

  • aws

  • amazon

  • amzn

" - }, - "DocumentType":{ - "shape":"DocumentType", - "documentation":"

The type of document to create. Valid document types include: Policy, Automation, and Command.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

Specify the document format for the request. The document format can be either JSON or YAML. JSON is the default format.

" - }, - "TargetType":{ - "shape":"TargetType", - "documentation":"

Specify a target type to define the kinds of resources the document can run on. For example, to run a document on EC2 instances, specify the following value: /AWS::EC2::Instance. If you specify a value of '/' the document can run on all types of resources. If you don't specify a value, the document can't run on any resources. For a list of valid resource types, see AWS Resource Types Reference in the AWS CloudFormation User Guide.

" - } - } - }, - "CreateDocumentResult":{ - "type":"structure", - "members":{ - "DocumentDescription":{ - "shape":"DocumentDescription", - "documentation":"

Information about the Systems Manager document.

" - } - } - }, - "CreateMaintenanceWindowRequest":{ - "type":"structure", - "required":[ - "Name", - "Schedule", - "Duration", - "Cutoff", - "AllowUnassociatedTargets" - ], - "members":{ - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The name of the Maintenance Window.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description for the Maintenance Window. We recommend specifying a description to help you organize your Maintenance Windows.

" - }, - "Schedule":{ - "shape":"MaintenanceWindowSchedule", - "documentation":"

The schedule of the Maintenance Window in the form of a cron or rate expression.

" - }, - "Duration":{ - "shape":"MaintenanceWindowDurationHours", - "documentation":"

The duration of the Maintenance Window in hours.

" - }, - "Cutoff":{ - "shape":"MaintenanceWindowCutoff", - "documentation":"

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

" - }, - "AllowUnassociatedTargets":{ - "shape":"MaintenanceWindowAllowUnassociatedTargets", - "documentation":"

Enables a Maintenance Window task to execute on managed instances, even if you have not registered those instances as targets. If enabled, then you must specify the unregistered instances (by instance ID) when you register a task with the Maintenance Window

If you don't enable this option, then you must specify previously-registered targets when you register a task with the Maintenance Window.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

User-provided idempotency token.

", - "idempotencyToken":true - } - } - }, - "CreateMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the created Maintenance Window.

" - } - } - }, - "CreatePatchBaselineRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Defines the operating system the patch baseline applies to. The Default value is WINDOWS.

" - }, - "Name":{ - "shape":"BaselineName", - "documentation":"

The name of the patch baseline.

" - }, - "GlobalFilters":{ - "shape":"PatchFilterGroup", - "documentation":"

A set of global filters used to exclude patches from the baseline.

" - }, - "ApprovalRules":{ - "shape":"PatchRuleGroup", - "documentation":"

A set of rules used to include patches in the baseline.

" - }, - "ApprovedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly approved patches for the baseline.

For information about accepted formats for lists of approved patches and rejected patches, see Package Name Formats for Approved and Rejected Patch Lists in the AWS Systems Manager User Guide.

" - }, - "ApprovedPatchesComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

Defines the compliance level for approved patches. This means that if an approved patch is reported as missing, this is the severity of the compliance violation. The default value is UNSPECIFIED.

" - }, - "ApprovedPatchesEnableNonSecurity":{ - "shape":"Boolean", - "documentation":"

Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.

", - "box":true - }, - "RejectedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly rejected patches for the baseline.

For information about accepted formats for lists of approved patches and rejected patches, see Package Name Formats for Approved and Rejected Patch Lists in the AWS Systems Manager User Guide.

" - }, - "Description":{ - "shape":"BaselineDescription", - "documentation":"

A description of the patch baseline.

" - }, - "Sources":{ - "shape":"PatchSourceList", - "documentation":"

Information about the patches to use to update the instances, including target operating systems and source repositories. Applies to Linux instances only.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

User-provided idempotency token.

", - "idempotencyToken":true - } - } - }, - "CreatePatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the created patch baseline.

" - } - } - }, - "CreateResourceDataSyncRequest":{ - "type":"structure", - "required":[ - "SyncName", - "S3Destination" - ], - "members":{ - "SyncName":{ - "shape":"ResourceDataSyncName", - "documentation":"

A name for the configuration.

" - }, - "S3Destination":{ - "shape":"ResourceDataSyncS3Destination", - "documentation":"

Amazon S3 configuration details for the sync.

" - } - } - }, - "CreateResourceDataSyncResult":{ - "type":"structure", - "members":{ - } - }, - "CreatedDate":{"type":"timestamp"}, - "CustomSchemaCountLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You have exceeded the limit for custom schemas. Delete one or more custom schemas and try again.

", - "exception":true - }, - "DateTime":{"type":"timestamp"}, - "DefaultBaseline":{"type":"boolean"}, - "DefaultInstanceName":{ - "type":"string", - "max":256, - "min":0, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "DeleteActivationRequest":{ - "type":"structure", - "required":["ActivationId"], - "members":{ - "ActivationId":{ - "shape":"ActivationId", - "documentation":"

The ID of the activation that you want to delete.

" - } - } - }, - "DeleteActivationResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteAssociationRequest":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID that you want to delete.

" - } - } - }, - "DeleteAssociationResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteDocumentRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document.

" - } - } - }, - "DeleteDocumentResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteInventoryRequest":{ - "type":"structure", - "required":["TypeName"], - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the custom inventory type for which you want to delete either all previously collected data, or the inventory type itself.

" - }, - "SchemaDeleteOption":{ - "shape":"InventorySchemaDeleteOption", - "documentation":"

Use the SchemaDeleteOption to delete a custom inventory type (schema). If you don't choose this option, the system only deletes existing inventory data associated with the custom inventory type. Choose one of the following options:

DisableSchema: If you choose this option, the system ignores all inventory data for the specified version, and any earlier versions. To enable this schema again, you must call the PutInventory action for a version greater than the disbled version.

DeleteSchema: This option deletes the specified custom type from the Inventory service. You can recreate the schema later, if you want.

" - }, - "DryRun":{ - "shape":"DryRun", - "documentation":"

Use this option to view a summary of the deletion request without deleting any data or the data type. This option is useful when you only want to understand what will be deleted. Once you validate that the data to be deleted is what you intend to delete, you can run the same command without specifying the DryRun option.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

User-provided idempotency token.

", - "idempotencyToken":true - } - } - }, - "DeleteInventoryResult":{ - "type":"structure", - "members":{ - "DeletionId":{ - "shape":"InventoryDeletionId", - "documentation":"

Every DeleteInventory action is assigned a unique ID. This option returns a unique ID. You can use this ID to query the status of a delete operation. This option is useful for ensuring that a delete operation has completed before you begin other actions.

" - }, - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the inventory data type specified in the request.

" - }, - "DeletionSummary":{ - "shape":"InventoryDeletionSummary", - "documentation":"

A summary of the delete operation. For more information about this summary, see Understanding the Delete Inventory Summary in the AWS Systems Manager User Guide.

" - } - } - }, - "DeleteMaintenanceWindowRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window to delete.

" - } - } - }, - "DeleteMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the deleted Maintenance Window.

" - } - } - }, - "DeleteParameterRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The name of the parameter to delete.

" - } - } - }, - "DeleteParameterResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteParametersRequest":{ - "type":"structure", - "required":["Names"], - "members":{ - "Names":{ - "shape":"ParameterNameList", - "documentation":"

The names of the parameters to delete.

" - } - } - }, - "DeleteParametersResult":{ - "type":"structure", - "members":{ - "DeletedParameters":{ - "shape":"ParameterNameList", - "documentation":"

The names of the deleted parameters.

" - }, - "InvalidParameters":{ - "shape":"ParameterNameList", - "documentation":"

The names of parameters that weren't deleted because the parameters are not valid.

" - } - } - }, - "DeletePatchBaselineRequest":{ - "type":"structure", - "required":["BaselineId"], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to delete.

" - } - } - }, - "DeletePatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the deleted patch baseline.

" - } - } - }, - "DeleteResourceDataSyncRequest":{ - "type":"structure", - "required":["SyncName"], - "members":{ - "SyncName":{ - "shape":"ResourceDataSyncName", - "documentation":"

The name of the configuration to delete.

" - } - } - }, - "DeleteResourceDataSyncResult":{ - "type":"structure", - "members":{ - } - }, - "DeliveryTimedOutCount":{"type":"integer"}, - "DeregisterManagedInstanceRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"ManagedInstanceId", - "documentation":"

The ID assigned to the managed instance when you registered it using the activation process.

" - } - } - }, - "DeregisterManagedInstanceResult":{ - "type":"structure", - "members":{ - } - }, - "DeregisterPatchBaselineForPatchGroupRequest":{ - "type":"structure", - "required":[ - "BaselineId", - "PatchGroup" - ], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to deregister the patch group from.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group that should be deregistered from the patch baseline.

" - } - } - }, - "DeregisterPatchBaselineForPatchGroupResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline the patch group was deregistered from.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group deregistered from the patch baseline.

" - } - } - }, - "DeregisterTargetFromMaintenanceWindowRequest":{ - "type":"structure", - "required":[ - "WindowId", - "WindowTargetId" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the target should be removed from.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The ID of the target definition to remove.

" - }, - "Safe":{ - "shape":"Boolean", - "documentation":"

The system checks if the target is being referenced by a task. If the target is being referenced, the system returns an error and does not deregister the target from the Maintenance Window.

", - "box":true - } - } - }, - "DeregisterTargetFromMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the target was removed from.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The ID of the removed target definition.

" - } - } - }, - "DeregisterTaskFromMaintenanceWindowRequest":{ - "type":"structure", - "required":[ - "WindowId", - "WindowTaskId" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the task should be removed from.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The ID of the task to remove from the Maintenance Window.

" - } - } - }, - "DeregisterTaskFromMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the task was removed from.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The ID of the task removed from the Maintenance Window.

" - } - } - }, - "DescribeActivationsFilter":{ - "type":"structure", - "members":{ - "FilterKey":{ - "shape":"DescribeActivationsFilterKeys", - "documentation":"

The name of the filter.

" - }, - "FilterValues":{ - "shape":"StringList", - "documentation":"

The filter values.

" - } - }, - "documentation":"

Filter for the DescribeActivation API.

" - }, - "DescribeActivationsFilterKeys":{ - "type":"string", - "enum":[ - "ActivationIds", - "DefaultInstanceName", - "IamRole" - ] - }, - "DescribeActivationsFilterList":{ - "type":"list", - "member":{"shape":"DescribeActivationsFilter"} - }, - "DescribeActivationsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"DescribeActivationsFilterList", - "documentation":"

A filter to view information about your activations.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "DescribeActivationsResult":{ - "type":"structure", - "members":{ - "ActivationList":{ - "shape":"ActivationList", - "documentation":"

A list of activations for your AWS account.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "DescribeAssociationExecutionTargetsRequest":{ - "type":"structure", - "required":[ - "AssociationId", - "ExecutionId" - ], - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID that includes the execution for which you want to view details.

" - }, - "ExecutionId":{ - "shape":"AssociationExecutionId", - "documentation":"

The execution ID for which you want to view details.

" - }, - "Filters":{ - "shape":"AssociationExecutionTargetsFilterList", - "documentation":"

Filters for the request. You can specify the following filters and values.

Status (EQUAL)

ResourceId (EQUAL)

ResourceType (EQUAL)

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "DescribeAssociationExecutionTargetsResult":{ - "type":"structure", - "members":{ - "AssociationExecutionTargets":{ - "shape":"AssociationExecutionTargetsList", - "documentation":"

Information about the execution.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "DescribeAssociationExecutionsRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID for which you want to view execution history details.

" - }, - "Filters":{ - "shape":"AssociationExecutionFilterList", - "documentation":"

Filters for the request. You can specify the following filters and values.

ExecutionId (EQUAL)

Status (EQUAL)

CreatedTime (EQUAL, GREATER_THAN, LESS_THAN)

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "DescribeAssociationExecutionsResult":{ - "type":"structure", - "members":{ - "AssociationExecutions":{ - "shape":"AssociationExecutionsList", - "documentation":"

A list of the executions for the specified association ID.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "DescribeAssociationRequest":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - }, - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID for which you want information.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

Specify the association version to retrieve. To view the latest version, either specify $LATEST for this parameter, or omit this parameter. To view a list of all associations for an instance, use ListInstanceAssociations. To get a list of versions for a specific association, use ListAssociationVersions.

" - } - } - }, - "DescribeAssociationResult":{ - "type":"structure", - "members":{ - "AssociationDescription":{ - "shape":"AssociationDescription", - "documentation":"

Information about the association.

" - } - } - }, - "DescribeAutomationExecutionsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"AutomationExecutionFilterList", - "documentation":"

Filters used to limit the scope of executions that are requested.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeAutomationExecutionsResult":{ - "type":"structure", - "members":{ - "AutomationExecutionMetadataList":{ - "shape":"AutomationExecutionMetadataList", - "documentation":"

The list of details about each automation execution which has occurred which matches the filter specification, if any.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeAutomationStepExecutionsRequest":{ - "type":"structure", - "required":["AutomationExecutionId"], - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The Automation execution ID for which you want step execution descriptions.

" - }, - "Filters":{ - "shape":"StepExecutionFilterList", - "documentation":"

One or more filters to limit the number of step executions returned by the request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "ReverseOrder":{ - "shape":"Boolean", - "documentation":"

A boolean that indicates whether to list step executions in reverse order by start time. The default value is false.

", - "box":true - } - } - }, - "DescribeAutomationStepExecutionsResult":{ - "type":"structure", - "members":{ - "StepExecutions":{ - "shape":"StepExecutionList", - "documentation":"

A list of details about the current state of all steps that make up an execution.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeAvailablePatchesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"PatchOrchestratorFilterList", - "documentation":"

Filters used to scope down the returned patches.

" - }, - "MaxResults":{ - "shape":"PatchBaselineMaxResults", - "documentation":"

The maximum number of patches to return (per page).

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeAvailablePatchesResult":{ - "type":"structure", - "members":{ - "Patches":{ - "shape":"PatchList", - "documentation":"

An array of patches. Each entry in the array is a patch structure.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeDocumentPermissionRequest":{ - "type":"structure", - "required":[ - "Name", - "PermissionType" - ], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document for which you are the owner.

" - }, - "PermissionType":{ - "shape":"DocumentPermissionType", - "documentation":"

The permission type for the document. The permission type can be Share.

" - } - } - }, - "DescribeDocumentPermissionResponse":{ - "type":"structure", - "members":{ - "AccountIds":{ - "shape":"AccountIdList", - "documentation":"

The account IDs that have permission to use this document. The ID can be either an AWS account or All.

" - } - } - }, - "DescribeDocumentRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentARN", - "documentation":"

The name of the Systems Manager document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version for which you want information. Can be a specific version or the default version.

" - } - } - }, - "DescribeDocumentResult":{ - "type":"structure", - "members":{ - "Document":{ - "shape":"DocumentDescription", - "documentation":"

Information about the Systems Manager document.

" - } - } - }, - "DescribeEffectiveInstanceAssociationsRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID for which you want to view all associations.

" - }, - "MaxResults":{ - "shape":"EffectiveInstanceAssociationMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeEffectiveInstanceAssociationsResult":{ - "type":"structure", - "members":{ - "Associations":{ - "shape":"InstanceAssociationList", - "documentation":"

The associations for the requested instance.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeEffectivePatchesForPatchBaselineRequest":{ - "type":"structure", - "required":["BaselineId"], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to retrieve the effective patches for.

" - }, - "MaxResults":{ - "shape":"PatchBaselineMaxResults", - "documentation":"

The maximum number of patches to return (per page).

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeEffectivePatchesForPatchBaselineResult":{ - "type":"structure", - "members":{ - "EffectivePatches":{ - "shape":"EffectivePatchList", - "documentation":"

An array of patches and patch status.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInstanceAssociationsStatusRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance IDs for which you want association status information.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeInstanceAssociationsStatusResult":{ - "type":"structure", - "members":{ - "InstanceAssociationStatusInfos":{ - "shape":"InstanceAssociationStatusInfos", - "documentation":"

Status information about the association.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInstanceInformationRequest":{ - "type":"structure", - "members":{ - "InstanceInformationFilterList":{ - "shape":"InstanceInformationFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of instances.

" - }, - "Filters":{ - "shape":"InstanceInformationStringFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of instances.

" - }, - "MaxResults":{ - "shape":"MaxResultsEC2Compatible", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeInstanceInformationResult":{ - "type":"structure", - "members":{ - "InstanceInformationList":{ - "shape":"InstanceInformationList", - "documentation":"

The instance information list.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInstancePatchStatesForPatchGroupRequest":{ - "type":"structure", - "required":["PatchGroup"], - "members":{ - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group for which the patch state information should be retrieved.

" - }, - "Filters":{ - "shape":"InstancePatchStateFilterList", - "documentation":"

Each entry in the array is a structure containing:

Key (string between 1 and 200 characters)

Values (array containing a single string)

Type (string \"Equal\", \"NotEqual\", \"LessThan\", \"GreaterThan\")

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"PatchComplianceMaxResults", - "documentation":"

The maximum number of patches to return (per page).

", - "box":true - } - } - }, - "DescribeInstancePatchStatesForPatchGroupResult":{ - "type":"structure", - "members":{ - "InstancePatchStates":{ - "shape":"InstancePatchStatesList", - "documentation":"

The high-level patch state for the requested instances.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInstancePatchStatesRequest":{ - "type":"structure", - "required":["InstanceIds"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdList", - "documentation":"

The ID of the instance whose patch state information should be retrieved.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"PatchComplianceMaxResults", - "documentation":"

The maximum number of instances to return (per page).

", - "box":true - } - } - }, - "DescribeInstancePatchStatesResult":{ - "type":"structure", - "members":{ - "InstancePatchStates":{ - "shape":"InstancePatchStateList", - "documentation":"

The high-level patch state for the requested instances.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInstancePatchesRequest":{ - "type":"structure", - "required":["InstanceId"], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance whose patch state information should be retrieved.

" - }, - "Filters":{ - "shape":"PatchOrchestratorFilterList", - "documentation":"

Each entry in the array is a structure containing:

Key (string, between 1 and 128 characters)

Values (array of strings, each string between 1 and 256 characters)

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"PatchComplianceMaxResults", - "documentation":"

The maximum number of patches to return (per page).

", - "box":true - } - } - }, - "DescribeInstancePatchesResult":{ - "type":"structure", - "members":{ - "Patches":{ - "shape":"PatchComplianceDataList", - "documentation":"

Each entry in the array is a structure containing:

Title (string)

KBId (string)

Classification (string)

Severity (string)

State (string: \"INSTALLED\", \"INSTALLED OTHER\", \"MISSING\", \"NOT APPLICABLE\", \"FAILED\")

InstalledTime (DateTime)

InstalledBy (string)

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeInventoryDeletionsRequest":{ - "type":"structure", - "members":{ - "DeletionId":{ - "shape":"InventoryDeletionId", - "documentation":"

Specify the delete inventory ID for which you want information. This ID was returned by the DeleteInventory action.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "DescribeInventoryDeletionsResult":{ - "type":"structure", - "members":{ - "InventoryDeletions":{ - "shape":"InventoryDeletionsList", - "documentation":"

A list of status items for deleted inventory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "DescribeMaintenanceWindowExecutionTaskInvocationsRequest":{ - "type":"structure", - "required":[ - "WindowExecutionId", - "TaskId" - ], - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution the task is part of.

" - }, - "TaskId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task in the Maintenance Window task that should be retrieved.

" - }, - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Optional filters used to scope down the returned task invocations. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowExecutionTaskInvocationsResult":{ - "type":"structure", - "members":{ - "WindowExecutionTaskInvocationIdentities":{ - "shape":"MaintenanceWindowExecutionTaskInvocationIdentityList", - "documentation":"

Information about the task invocation results per invocation.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMaintenanceWindowExecutionTasksRequest":{ - "type":"structure", - "required":["WindowExecutionId"], - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution whose task executions should be retrieved.

" - }, - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Optional filters used to scope down the returned tasks. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowExecutionTasksResult":{ - "type":"structure", - "members":{ - "WindowExecutionTaskIdentities":{ - "shape":"MaintenanceWindowExecutionTaskIdentityList", - "documentation":"

Information about the task executions.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMaintenanceWindowExecutionsRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window whose executions should be retrieved.

" - }, - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Each entry in the array is a structure containing:

Key (string, between 1 and 128 characters)

Values (array of strings, each string is between 1 and 256 characters)

The supported Keys are ExecutedBefore and ExecutedAfter with the value being a date/time string such as 2016-11-04T05:00:00Z.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowExecutionsResult":{ - "type":"structure", - "members":{ - "WindowExecutions":{ - "shape":"MaintenanceWindowExecutionList", - "documentation":"

Information about the Maintenance Windows execution.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMaintenanceWindowTargetsRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window whose targets should be retrieved.

" - }, - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Optional filters that can be used to narrow down the scope of the returned window targets. The supported filter keys are Type, WindowTargetId and OwnerInformation.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowTargetsResult":{ - "type":"structure", - "members":{ - "Targets":{ - "shape":"MaintenanceWindowTargetList", - "documentation":"

Information about the targets in the Maintenance Window.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMaintenanceWindowTasksRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window whose tasks should be retrieved.

" - }, - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Optional filters used to narrow down the scope of the returned tasks. The supported filter keys are WindowTaskId, TaskArn, Priority, and TaskType.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowTasksResult":{ - "type":"structure", - "members":{ - "Tasks":{ - "shape":"MaintenanceWindowTaskList", - "documentation":"

Information about the tasks in the Maintenance Window.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeMaintenanceWindowsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"MaintenanceWindowFilterList", - "documentation":"

Optional filters used to narrow down the scope of the returned Maintenance Windows. Supported filter keys are Name and Enabled.

" - }, - "MaxResults":{ - "shape":"MaintenanceWindowMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeMaintenanceWindowsResult":{ - "type":"structure", - "members":{ - "WindowIdentities":{ - "shape":"MaintenanceWindowIdentityList", - "documentation":"

Information about the Maintenance Windows.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribeParametersRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ParametersFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "ParameterFilters":{ - "shape":"ParameterStringFilterList", - "documentation":"

Filters to limit the request results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribeParametersResult":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParameterMetadataList", - "documentation":"

Parameters returned by the request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribePatchBaselinesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"PatchOrchestratorFilterList", - "documentation":"

Each element in the array is a structure containing:

Key: (string, \"NAME_PREFIX\" or \"OWNER\")

Value: (array of strings, exactly 1 entry, between 1 and 255 characters)

" - }, - "MaxResults":{ - "shape":"PatchBaselineMaxResults", - "documentation":"

The maximum number of patch baselines to return (per page).

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribePatchBaselinesResult":{ - "type":"structure", - "members":{ - "BaselineIdentities":{ - "shape":"PatchBaselineIdentityList", - "documentation":"

An array of PatchBaselineIdentity elements.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescribePatchGroupStateRequest":{ - "type":"structure", - "required":["PatchGroup"], - "members":{ - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group whose patch snapshot should be retrieved.

" - } - } - }, - "DescribePatchGroupStateResult":{ - "type":"structure", - "members":{ - "Instances":{ - "shape":"Integer", - "documentation":"

The number of instances in the patch group.

" - }, - "InstancesWithInstalledPatches":{ - "shape":"Integer", - "documentation":"

The number of instances with installed patches.

" - }, - "InstancesWithInstalledOtherPatches":{ - "shape":"Integer", - "documentation":"

The number of instances with patches installed that aren't defined in the patch baseline.

" - }, - "InstancesWithMissingPatches":{ - "shape":"Integer", - "documentation":"

The number of instances with missing patches from the patch baseline.

" - }, - "InstancesWithFailedPatches":{ - "shape":"Integer", - "documentation":"

The number of instances with patches from the patch baseline that failed to install.

" - }, - "InstancesWithNotApplicablePatches":{ - "shape":"Integer", - "documentation":"

The number of instances with patches that aren't applicable.

" - } - } - }, - "DescribePatchGroupsRequest":{ - "type":"structure", - "members":{ - "MaxResults":{ - "shape":"PatchBaselineMaxResults", - "documentation":"

The maximum number of patch groups to return (per page).

", - "box":true - }, - "Filters":{ - "shape":"PatchOrchestratorFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "DescribePatchGroupsResult":{ - "type":"structure", - "members":{ - "Mappings":{ - "shape":"PatchGroupPatchBaselineMappingList", - "documentation":"

Each entry in the array contains:

PatchGroup: string (between 1 and 256 characters, Regex: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$)

PatchBaselineIdentity: A PatchBaselineIdentity element.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "DescriptionInDocument":{"type":"string"}, - "DocumentARN":{ - "type":"string", - "pattern":"^[a-zA-Z0-9_\\-.:/]{3,128}$" - }, - "DocumentAlreadyExists":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified document already exists.

", - "exception":true - }, - "DocumentContent":{ - "type":"string", - "min":1 - }, - "DocumentDefaultVersionDescription":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document.

" - }, - "DefaultVersion":{ - "shape":"DocumentVersion", - "documentation":"

The default version of the document.

" - } - }, - "documentation":"

A default version of a document.

" - }, - "DocumentDescription":{ - "type":"structure", - "members":{ - "Sha1":{ - "shape":"DocumentSha1", - "documentation":"

The SHA1 hash of the document, which you can use for verification.

" - }, - "Hash":{ - "shape":"DocumentHash", - "documentation":"

The Sha256 or Sha1 hash created by the system when the document was created.

Sha1 hashes have been deprecated.

" - }, - "HashType":{ - "shape":"DocumentHashType", - "documentation":"

Sha256 or Sha1.

Sha1 hashes have been deprecated.

" - }, - "Name":{ - "shape":"DocumentARN", - "documentation":"

The name of the Systems Manager document.

" - }, - "Owner":{ - "shape":"DocumentOwner", - "documentation":"

The AWS user account that created the document.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date when the document was created.

" - }, - "Status":{ - "shape":"DocumentStatus", - "documentation":"

The status of the Systems Manager document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "Description":{ - "shape":"DescriptionInDocument", - "documentation":"

A description of the document.

" - }, - "Parameters":{ - "shape":"DocumentParameterList", - "documentation":"

A description of the parameters for a document.

" - }, - "PlatformTypes":{ - "shape":"PlatformTypeList", - "documentation":"

The list of OS platforms compatible with this Systems Manager document.

" - }, - "DocumentType":{ - "shape":"DocumentType", - "documentation":"

The type of document.

" - }, - "SchemaVersion":{ - "shape":"DocumentSchemaVersion", - "documentation":"

The schema version.

" - }, - "LatestVersion":{ - "shape":"DocumentVersion", - "documentation":"

The latest version of the document.

" - }, - "DefaultVersion":{ - "shape":"DocumentVersion", - "documentation":"

The default version.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

The document format, either JSON or YAML.

" - }, - "TargetType":{ - "shape":"TargetType", - "documentation":"

The target type which defines the kinds of resources the document can run on. For example, /AWS::EC2::Instance. For a list of valid resource types, see AWS Resource Types Reference in the AWS CloudFormation User Guide.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags, or metadata, that have been applied to the document.

" - } - }, - "documentation":"

Describes a Systems Manager document.

" - }, - "DocumentFilter":{ - "type":"structure", - "required":[ - "key", - "value" - ], - "members":{ - "key":{ - "shape":"DocumentFilterKey", - "documentation":"

The name of the filter.

" - }, - "value":{ - "shape":"DocumentFilterValue", - "documentation":"

The value of the filter.

" - } - }, - "documentation":"

Describes a filter.

" - }, - "DocumentFilterKey":{ - "type":"string", - "enum":[ - "Name", - "Owner", - "PlatformTypes", - "DocumentType" - ] - }, - "DocumentFilterList":{ - "type":"list", - "member":{"shape":"DocumentFilter"}, - "min":1 - }, - "DocumentFilterValue":{ - "type":"string", - "min":1 - }, - "DocumentFormat":{ - "type":"string", - "enum":[ - "YAML", - "JSON" - ] - }, - "DocumentHash":{ - "type":"string", - "max":256 - }, - "DocumentHashType":{ - "type":"string", - "enum":[ - "Sha256", - "Sha1" - ] - }, - "DocumentIdentifier":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentARN", - "documentation":"

The name of the Systems Manager document.

" - }, - "Owner":{ - "shape":"DocumentOwner", - "documentation":"

The AWS user account that created the document.

" - }, - "PlatformTypes":{ - "shape":"PlatformTypeList", - "documentation":"

The operating system platform.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "DocumentType":{ - "shape":"DocumentType", - "documentation":"

The document type.

" - }, - "SchemaVersion":{ - "shape":"DocumentSchemaVersion", - "documentation":"

The schema version.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

The document format, either JSON or YAML.

" - }, - "TargetType":{ - "shape":"TargetType", - "documentation":"

The target type which defines the kinds of resources the document can run on. For example, /AWS::EC2::Instance. For a list of valid resource types, see AWS Resource Types Reference in the AWS CloudFormation User Guide.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags, or metadata, that have been applied to the document.

" - } - }, - "documentation":"

Describes the name of a Systems Manager document.

" - }, - "DocumentIdentifierList":{ - "type":"list", - "member":{"shape":"DocumentIdentifier"} - }, - "DocumentKeyValuesFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"DocumentKeyValuesFilterKey", - "documentation":"

The name of the filter key.

" - }, - "Values":{ - "shape":"DocumentKeyValuesFilterValues", - "documentation":"

The value for the filter key.

" - } - }, - "documentation":"

One or more filters. Use a filter to return a more specific list of documents.

For keys, you can specify one or more tags that have been applied to a document.

Other valid values include Owner, Name, PlatformTypes, and DocumentType.

Note that only one Owner can be specified in a request. For example: Key=Owner,Values=Self.

If you use Name as a key, you can use a name prefix to return a list of documents. For example, in the AWS CLI, to return a list of all documents that begin with Te, run the following command:

aws ssm list-documents --filters Key=Name,Values=Te

If you specify more than two keys, only documents that are identified by all the tags are returned in the results. If you specify more than two values for a key, documents that are identified by any of the values are returned in the results.

To specify a custom key and value pair, use the format Key=tag:[tagName],Values=[valueName].

For example, if you created a Key called region and are using the AWS CLI to call the list-documents command:

aws ssm list-documents --filters Key=tag:region,Values=east,west Key=Owner,Values=Self

" - }, - "DocumentKeyValuesFilterKey":{ - "type":"string", - "max":128, - "min":1 - }, - "DocumentKeyValuesFilterList":{ - "type":"list", - "member":{"shape":"DocumentKeyValuesFilter"}, - "max":6, - "min":0 - }, - "DocumentKeyValuesFilterValue":{ - "type":"string", - "max":256, - "min":1 - }, - "DocumentKeyValuesFilterValues":{ - "type":"list", - "member":{"shape":"DocumentKeyValuesFilterValue"} - }, - "DocumentLimitExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You can have at most 200 active Systems Manager documents.

", - "exception":true - }, - "DocumentName":{ - "type":"string", - "pattern":"^[a-zA-Z0-9_\\-.]{3,128}$" - }, - "DocumentOwner":{"type":"string"}, - "DocumentParameter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentParameterName", - "documentation":"

The name of the parameter.

" - }, - "Type":{ - "shape":"DocumentParameterType", - "documentation":"

The type of parameter. The type can be either String or StringList.

" - }, - "Description":{ - "shape":"DocumentParameterDescrption", - "documentation":"

A description of what the parameter does, how to use it, the default value, and whether or not the parameter is optional.

" - }, - "DefaultValue":{ - "shape":"DocumentParameterDefaultValue", - "documentation":"

If specified, the default values for the parameters. Parameters without a default value are required. Parameters with a default value are optional.

" - } - }, - "documentation":"

Parameters specified in a System Manager document that execute on the server when the command is run.

" - }, - "DocumentParameterDefaultValue":{"type":"string"}, - "DocumentParameterDescrption":{"type":"string"}, - "DocumentParameterList":{ - "type":"list", - "member":{"shape":"DocumentParameter"} - }, - "DocumentParameterName":{"type":"string"}, - "DocumentParameterType":{ - "type":"string", - "enum":[ - "String", - "StringList" - ] - }, - "DocumentPermissionLimit":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The document cannot be shared with more AWS user accounts. You can share a document with a maximum of 20 accounts. You can publicly share up to five documents. If you need to increase this limit, contact AWS Support.

", - "exception":true - }, - "DocumentPermissionType":{ - "type":"string", - "enum":["Share"] - }, - "DocumentSchemaVersion":{ - "type":"string", - "pattern":"([0-9]+)\\.([0-9]+)" - }, - "DocumentSha1":{"type":"string"}, - "DocumentStatus":{ - "type":"string", - "enum":[ - "Creating", - "Active", - "Updating", - "Deleting" - ] - }, - "DocumentType":{ - "type":"string", - "enum":[ - "Command", - "Policy", - "Automation" - ] - }, - "DocumentVersion":{ - "type":"string", - "pattern":"([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)" - }, - "DocumentVersionInfo":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The document name.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date the document was created.

" - }, - "IsDefaultVersion":{ - "shape":"Boolean", - "documentation":"

An identifier for the default version of the document.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

The document format, either JSON or YAML.

" - } - }, - "documentation":"

Version information about the document.

" - }, - "DocumentVersionLimitExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The document has too many versions. Delete one or more document versions and try again.

", - "exception":true - }, - "DocumentVersionList":{ - "type":"list", - "member":{"shape":"DocumentVersionInfo"}, - "min":1 - }, - "DocumentVersionNumber":{ - "type":"string", - "pattern":"(^[1-9][0-9]*$)" - }, - "DoesNotExistException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Error returned when the ID specified for a resource, such as a Maintenance Window or Patch baseline, doesn't exist.

For information about resource limits in Systems Manager, see AWS Systems Manager Limits.

", - "exception":true - }, - "DryRun":{"type":"boolean"}, - "DuplicateDocumentContent":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The content of the association document matches another document. Change the content of the document and try again.

", - "exception":true - }, - "DuplicateInstanceId":{ - "type":"structure", - "members":{ - }, - "documentation":"

You cannot specify an instance ID in more than one association.

", - "exception":true - }, - "EffectiveInstanceAssociationMaxResults":{ - "type":"integer", - "max":5, - "min":1 - }, - "EffectivePatch":{ - "type":"structure", - "members":{ - "Patch":{ - "shape":"Patch", - "documentation":"

Provides metadata for a patch, including information such as the KB ID, severity, classification and a URL for where more information can be obtained about the patch.

" - }, - "PatchStatus":{ - "shape":"PatchStatus", - "documentation":"

The status of the patch in a patch baseline. This includes information about whether the patch is currently approved, due to be approved by a rule, explicitly approved, or explicitly rejected and the date the patch was or will be approved.

" - } - }, - "documentation":"

The EffectivePatch structure defines metadata about a patch along with the approval state of the patch in a particular patch baseline. The approval state includes information about whether the patch is currently approved, due to be approved by a rule, explicitly approved, or explicitly rejected and the date the patch was or will be approved.

" - }, - "EffectivePatchList":{ - "type":"list", - "member":{"shape":"EffectivePatch"} - }, - "ErrorCount":{"type":"integer"}, - "ExecutionMode":{ - "type":"string", - "enum":[ - "Auto", - "Interactive" - ] - }, - "ExpirationDate":{"type":"timestamp"}, - "FailedCreateAssociation":{ - "type":"structure", - "members":{ - "Entry":{ - "shape":"CreateAssociationBatchRequestEntry", - "documentation":"

The association.

" - }, - "Message":{ - "shape":"BatchErrorMessage", - "documentation":"

A description of the failure.

" - }, - "Fault":{ - "shape":"Fault", - "documentation":"

The source of the failure.

" - } - }, - "documentation":"

Describes a failed association.

" - }, - "FailedCreateAssociationList":{ - "type":"list", - "member":{"shape":"FailedCreateAssociation"} - }, - "FailureDetails":{ - "type":"structure", - "members":{ - "FailureStage":{ - "shape":"String", - "documentation":"

The stage of the Automation execution when the failure occurred. The stages include the following: InputValidation, PreVerification, Invocation, PostVerification.

" - }, - "FailureType":{ - "shape":"String", - "documentation":"

The type of Automation failure. Failure types include the following: Action, Permission, Throttling, Verification, Internal.

" - }, - "Details":{ - "shape":"AutomationParameterMap", - "documentation":"

Detailed information about the Automation step failure.

" - } - }, - "documentation":"

Information about an Automation failure.

" - }, - "Fault":{ - "type":"string", - "enum":[ - "Client", - "Server", - "Unknown" - ] - }, - "FeatureNotAvailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You attempted to register a LAMBDA or STEP_FUNCTION task in a region where the corresponding service is not available.

", - "exception":true - }, - "GetAutomationExecutionRequest":{ - "type":"structure", - "required":["AutomationExecutionId"], - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The unique identifier for an existing automation execution to examine. The execution ID is returned by StartAutomationExecution when the execution of an Automation document is initiated.

" - } - } - }, - "GetAutomationExecutionResult":{ - "type":"structure", - "members":{ - "AutomationExecution":{ - "shape":"AutomationExecution", - "documentation":"

Detailed information about the current state of an automation execution.

" - } - } - }, - "GetCommandInvocationRequest":{ - "type":"structure", - "required":[ - "CommandId", - "InstanceId" - ], - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

(Required) The parent command ID of the invocation plugin.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

(Required) The ID of the managed instance targeted by the command. A managed instance can be an Amazon EC2 instance or an instance in your hybrid environment that is configured for Systems Manager.

" - }, - "PluginName":{ - "shape":"CommandPluginName", - "documentation":"

(Optional) The name of the plugin for which you want detailed results. If the document contains only one plugin, the name can be omitted and the details will be returned.

" - } - } - }, - "GetCommandInvocationResult":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

The parent command ID of the invocation plugin.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the managed instance targeted by the command. A managed instance can be an Amazon EC2 instance or an instance in your hybrid environment that is configured for Systems Manager.

" - }, - "Comment":{ - "shape":"Comment", - "documentation":"

The comment text for the command.

" - }, - "DocumentName":{ - "shape":"DocumentName", - "documentation":"

The name of the document that was executed. For example, AWS-RunShellScript.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The SSM document version used in the request.

" - }, - "PluginName":{ - "shape":"CommandPluginName", - "documentation":"

The name of the plugin for which you want detailed results. For example, aws:RunShellScript is a plugin.

" - }, - "ResponseCode":{ - "shape":"ResponseCode", - "documentation":"

The error level response code for the plugin script. If the response code is -1, then the command has not started executing on the instance, or it was not received by the instance.

" - }, - "ExecutionStartDateTime":{ - "shape":"StringDateTime", - "documentation":"

The date and time the plugin started executing. Date and time are written in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. The following sample AWS CLI command uses the InvokedBefore filter.

aws ssm list-commands --filters key=InvokedBefore,value=2017-06-07T00:00:00Z

If the plugin has not started to execute, the string is empty.

" - }, - "ExecutionElapsedTime":{ - "shape":"StringDateTime", - "documentation":"

Duration since ExecutionStartDateTime.

" - }, - "ExecutionEndDateTime":{ - "shape":"StringDateTime", - "documentation":"

The date and time the plugin was finished executing. Date and time are written in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. The following sample AWS CLI command uses the InvokedAfter filter.

aws ssm list-commands --filters key=InvokedAfter,value=2017-06-07T00:00:00Z

If the plugin has not started to execute, the string is empty.

" - }, - "Status":{ - "shape":"CommandInvocationStatus", - "documentation":"

The status of this invocation plugin. This status can be different than StatusDetails.

" - }, - "StatusDetails":{ - "shape":"StatusDetails", - "documentation":"

A detailed status of the command execution for an invocation. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding Command Statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:

  • Pending: The command has not been sent to the instance.

  • In Progress: The command has been sent to the instance but has not reached a terminal state.

  • Delayed: The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, the instance was stopped, etc. The system will try to deliver the command again.

  • Success: The command or plugin was executed successfully. This is a terminal state.

  • Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Execution Timed Out: The command started to execute on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.

  • Failed: The command wasn't executed successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.

  • Canceled: The command was terminated before it was completed. This is a terminal state.

  • Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.

  • Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.

" - }, - "StandardOutputContent":{ - "shape":"StandardOutputContent", - "documentation":"

The first 24,000 characters written by the plugin to stdout. If the command has not finished executing, if ExecutionStatus is neither Succeeded nor Failed, then this string is empty.

" - }, - "StandardOutputUrl":{ - "shape":"Url", - "documentation":"

The URL for the complete text written by the plugin to stdout in Amazon S3. If an Amazon S3 bucket was not specified, then this string is empty.

" - }, - "StandardErrorContent":{ - "shape":"StandardErrorContent", - "documentation":"

The first 8,000 characters written by the plugin to stderr. If the command has not finished executing, then this string is empty.

" - }, - "StandardErrorUrl":{ - "shape":"Url", - "documentation":"

The URL for the complete text written by the plugin to stderr. If the command has not finished executing, then this string is empty.

" - }, - "CloudWatchOutputConfig":{ - "shape":"CloudWatchOutputConfig", - "documentation":"

CloudWatch Logs information where Systems Manager sent the command output.

" - } - } - }, - "GetDefaultPatchBaselineRequest":{ - "type":"structure", - "members":{ - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Returns the default patch baseline for the specified operating system.

" - } - } - }, - "GetDefaultPatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the default patch baseline.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

The operating system for the returned patch baseline.

" - } - } - }, - "GetDeployablePatchSnapshotForInstanceRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "SnapshotId" - ], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance for which the appropriate patch snapshot should be retrieved.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The user-defined snapshot ID.

" - } - } - }, - "GetDeployablePatchSnapshotForInstanceResult":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The user-defined snapshot ID.

" - }, - "SnapshotDownloadUrl":{ - "shape":"SnapshotDownloadUrl", - "documentation":"

A pre-signed Amazon S3 URL that can be used to download the patch snapshot.

" - }, - "Product":{ - "shape":"Product", - "documentation":"

Returns the specific operating system (for example Windows Server 2012 or Amazon Linux 2015.09) on the instance for the specified patch snapshot.

" - } - } - }, - "GetDocumentRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentARN", - "documentation":"

The name of the Systems Manager document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version for which you want information.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

Returns the document in the specified format. The document format can be either JSON or YAML. JSON is the default format.

" - } - } - }, - "GetDocumentResult":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"DocumentARN", - "documentation":"

The name of the Systems Manager document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version.

" - }, - "Content":{ - "shape":"DocumentContent", - "documentation":"

The contents of the Systems Manager document.

" - }, - "DocumentType":{ - "shape":"DocumentType", - "documentation":"

The document type.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

The document format, either JSON or YAML.

" - } - } - }, - "GetInventoryRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"InventoryFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "Aggregators":{ - "shape":"InventoryAggregatorList", - "documentation":"

Returns counts of inventory types based on one or more expressions. For example, if you aggregate by using an expression that uses the AWS:InstanceInformation.PlatformType type, you can see a count of how many Windows and Linux instances exist in your inventoried fleet.

" - }, - "ResultAttributes":{ - "shape":"ResultAttributeList", - "documentation":"

The list of inventory item types to return.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "GetInventoryResult":{ - "type":"structure", - "members":{ - "Entities":{ - "shape":"InventoryResultEntityList", - "documentation":"

Collection of inventory entities such as a collection of instance inventory.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "GetInventorySchemaMaxResults":{ - "type":"integer", - "max":200, - "min":50 - }, - "GetInventorySchemaRequest":{ - "type":"structure", - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeNameFilter", - "documentation":"

The type of inventory item to return.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"GetInventorySchemaMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "Aggregator":{ - "shape":"AggregatorSchemaOnly", - "documentation":"

Returns inventory schemas that support aggregation. For example, this call returns the AWS:InstanceInformation type, because it supports aggregation based on the PlatformName, PlatformType, and PlatformVersion attributes.

" - }, - "SubType":{ - "shape":"IsSubTypeSchema", - "documentation":"

Returns the sub-type schema for a specified inventory type.

", - "box":true - } - } - }, - "GetInventorySchemaResult":{ - "type":"structure", - "members":{ - "Schemas":{ - "shape":"InventoryItemSchemaResultList", - "documentation":"

Inventory schemas returned by the request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "GetMaintenanceWindowExecutionRequest":{ - "type":"structure", - "required":["WindowExecutionId"], - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution that includes the task.

" - } - } - }, - "GetMaintenanceWindowExecutionResult":{ - "type":"structure", - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution.

" - }, - "TaskIds":{ - "shape":"MaintenanceWindowExecutionTaskIdList", - "documentation":"

The ID of the task executions from the Maintenance Window execution.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The status of the Maintenance Window execution.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the Status. Only available for certain status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time the Maintenance Window started executing.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time the Maintenance Window finished executing.

" - } - } - }, - "GetMaintenanceWindowExecutionTaskInvocationRequest":{ - "type":"structure", - "required":[ - "WindowExecutionId", - "TaskId", - "InvocationId" - ], - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution for which the task is a part.

" - }, - "TaskId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task in the Maintenance Window task that should be retrieved.

" - }, - "InvocationId":{ - "shape":"MaintenanceWindowExecutionTaskInvocationId", - "documentation":"

The invocation ID to retrieve.

" - } - } - }, - "GetMaintenanceWindowExecutionTaskInvocationResult":{ - "type":"structure", - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The Maintenance Window execution ID.

" - }, - "TaskExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The task execution ID.

" - }, - "InvocationId":{ - "shape":"MaintenanceWindowExecutionTaskInvocationId", - "documentation":"

The invocation ID.

" - }, - "ExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskExecutionId", - "documentation":"

The execution ID.

" - }, - "TaskType":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

Retrieves the task type for a Maintenance Window. Task types include the following: LAMBDA, STEP_FUNCTION, AUTOMATION, RUN_COMMAND.

" - }, - "Parameters":{ - "shape":"MaintenanceWindowExecutionTaskInvocationParameters", - "documentation":"

The parameters used at the time that the task executed.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The task status for an invocation.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the status. Details are only available for certain status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time that the task started executing on the target.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time that the task finished executing on the target.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

User-provided value to be included in any CloudWatch events raised while running tasks for these targets in this Maintenance Window.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTaskTargetId", - "documentation":"

The Maintenance Window target ID.

" - } - } - }, - "GetMaintenanceWindowExecutionTaskRequest":{ - "type":"structure", - "required":[ - "WindowExecutionId", - "TaskId" - ], - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution that includes the task.

" - }, - "TaskId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task execution in the Maintenance Window task that should be retrieved.

" - } - } - }, - "GetMaintenanceWindowExecutionTaskResult":{ - "type":"structure", - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution that includes the task.

" - }, - "TaskExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task execution in the Maintenance Window task that was retrieved.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The ARN of the executed task.

" - }, - "ServiceRole":{ - "shape":"ServiceRole", - "documentation":"

The role that was assumed when executing the task.

" - }, - "Type":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The type of task executed.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParametersList", - "documentation":"

The parameters passed to the task when it was executed.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

The map has the following format:

Key: string, between 1 and 255 characters

Value: an array of strings, each string is between 1 and 255 characters

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The priority of the task.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The defined maximum number of task executions that could be run in parallel.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The defined maximum number of task execution errors allowed before scheduling of the task execution would have been stopped.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The status of the task.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the Status. Only available for certain status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time the task execution started.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time the task execution completed.

" - } - } - }, - "GetMaintenanceWindowRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the desired Maintenance Window.

" - } - } - }, - "GetMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the created Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The name of the Maintenance Window.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

The description of the Maintenance Window.

" - }, - "Schedule":{ - "shape":"MaintenanceWindowSchedule", - "documentation":"

The schedule of the Maintenance Window in the form of a cron or rate expression.

" - }, - "Duration":{ - "shape":"MaintenanceWindowDurationHours", - "documentation":"

The duration of the Maintenance Window in hours.

" - }, - "Cutoff":{ - "shape":"MaintenanceWindowCutoff", - "documentation":"

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

" - }, - "AllowUnassociatedTargets":{ - "shape":"MaintenanceWindowAllowUnassociatedTargets", - "documentation":"

Whether targets must be registered with the Maintenance Window before tasks can be defined for those targets.

" - }, - "Enabled":{ - "shape":"MaintenanceWindowEnabled", - "documentation":"

Whether the Maintenance Windows is enabled.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date the Maintenance Window was created.

" - }, - "ModifiedDate":{ - "shape":"DateTime", - "documentation":"

The date the Maintenance Window was last modified.

" - } - } - }, - "GetMaintenanceWindowTaskRequest":{ - "type":"structure", - "required":[ - "WindowId", - "WindowTaskId" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID that includes the task to retrieve.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The Maintenance Window task ID to retrieve.

" - } - } - }, - "GetMaintenanceWindowTaskResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The retrieved Maintenance Window ID.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The retrieved Maintenance Window task ID.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets where the task should execute.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The resource that the task used during execution. For RUN_COMMAND and AUTOMATION task types, the TaskArn is the Systems Manager Document name/ARN. For LAMBDA tasks, the value is the function name/ARN. For STEP_FUNCTION tasks, the value is the state machine ARN.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The IAM service role to assume during task execution.

" - }, - "TaskType":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The type of task to execute.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParameters", - "documentation":"

The parameters to pass to the task when it executes.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "TaskInvocationParameters":{ - "shape":"MaintenanceWindowTaskInvocationParameters", - "documentation":"

The parameters to pass to the task when it executes.

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The priority of the task when it executes. The lower the number, the higher the priority. Tasks that have the same priority are scheduled in parallel.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The maximum number of targets allowed to run this task in parallel.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The maximum number of errors allowed before the task stops being scheduled.

" - }, - "LoggingInfo":{ - "shape":"LoggingInfo", - "documentation":"

The location in Amazon S3 where the task results are logged.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The retrieved task name.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

The retrieved task description.

" - } - } - }, - "GetParameterHistoryRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The name of a parameter you want to query.

" - }, - "WithDecryption":{ - "shape":"Boolean", - "documentation":"

Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.

", - "box":true - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "GetParameterHistoryResult":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParameterHistoryList", - "documentation":"

A list of parameters returned by the request.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "GetParameterRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The name of the parameter you want to query.

" - }, - "WithDecryption":{ - "shape":"Boolean", - "documentation":"

Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.

", - "box":true - } - } - }, - "GetParameterResult":{ - "type":"structure", - "members":{ - "Parameter":{ - "shape":"Parameter", - "documentation":"

Information about a parameter.

" - } - } - }, - "GetParametersByPathMaxResults":{ - "type":"integer", - "max":10, - "min":1 - }, - "GetParametersByPathRequest":{ - "type":"structure", - "required":["Path"], - "members":{ - "Path":{ - "shape":"PSParameterName", - "documentation":"

The hierarchy for the parameter. Hierarchies start with a forward slash (/) and end with the parameter name. A parameter name hierarchy can have a maximum of 15 levels. Here is an example of a hierarchy: /Finance/Prod/IAD/WinServ2016/license33

" - }, - "Recursive":{ - "shape":"Boolean", - "documentation":"

Retrieve all parameters within a hierarchy.

If a user has access to a path, then the user can access all levels of that path. For example, if a user has permission to access path /a, then the user can also access /a/b. Even if a user has explicitly been denied access in IAM for parameter /a, they can still call the GetParametersByPath API action recursively and view /a/b.

", - "box":true - }, - "ParameterFilters":{ - "shape":"ParameterStringFilterList", - "documentation":"

Filters to limit the request results.

You can't filter using the parameter name.

" - }, - "WithDecryption":{ - "shape":"Boolean", - "documentation":"

Retrieve all parameters in a hierarchy with their value decrypted.

", - "box":true - }, - "MaxResults":{ - "shape":"GetParametersByPathMaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "GetParametersByPathResult":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParameterList", - "documentation":"

A list of parameters found in the specified hierarchy.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "GetParametersRequest":{ - "type":"structure", - "required":["Names"], - "members":{ - "Names":{ - "shape":"ParameterNameList", - "documentation":"

Names of the parameters for which you want to query information.

" - }, - "WithDecryption":{ - "shape":"Boolean", - "documentation":"

Return decrypted secure string value. Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.

", - "box":true - } - } - }, - "GetParametersResult":{ - "type":"structure", - "members":{ - "Parameters":{ - "shape":"ParameterList", - "documentation":"

A list of details for a parameter.

" - }, - "InvalidParameters":{ - "shape":"ParameterNameList", - "documentation":"

A list of parameters that are not formatted correctly or do not run when executed.

" - } - } - }, - "GetPatchBaselineForPatchGroupRequest":{ - "type":"structure", - "required":["PatchGroup"], - "members":{ - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group whose patch baseline should be retrieved.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Returns he operating system rule specified for patch groups using the patch baseline.

" - } - } - }, - "GetPatchBaselineForPatchGroupResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline that should be used for the patch group.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

The operating system rule specified for patch groups using the patch baseline.

" - } - } - }, - "GetPatchBaselineRequest":{ - "type":"structure", - "required":["BaselineId"], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to retrieve.

" - } - } - }, - "GetPatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the retrieved patch baseline.

" - }, - "Name":{ - "shape":"BaselineName", - "documentation":"

The name of the patch baseline.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Returns the operating system specified for the patch baseline.

" - }, - "GlobalFilters":{ - "shape":"PatchFilterGroup", - "documentation":"

A set of global filters used to exclude patches from the baseline.

" - }, - "ApprovalRules":{ - "shape":"PatchRuleGroup", - "documentation":"

A set of rules used to include patches in the baseline.

" - }, - "ApprovedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly approved patches for the baseline.

" - }, - "ApprovedPatchesComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

Returns the specified compliance severity level for approved patches in the patch baseline.

" - }, - "ApprovedPatchesEnableNonSecurity":{ - "shape":"Boolean", - "documentation":"

Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.

", - "box":true - }, - "RejectedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly rejected patches for the baseline.

" - }, - "PatchGroups":{ - "shape":"PatchGroupList", - "documentation":"

Patch groups included in the patch baseline.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date the patch baseline was created.

" - }, - "ModifiedDate":{ - "shape":"DateTime", - "documentation":"

The date the patch baseline was last modified.

" - }, - "Description":{ - "shape":"BaselineDescription", - "documentation":"

A description of the patch baseline.

" - }, - "Sources":{ - "shape":"PatchSourceList", - "documentation":"

Information about the patches to use to update the instances, including target operating systems and source repositories. Applies to Linux instances only.

" - } - } - }, - "HierarchyLevelLimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

A hierarchy can have a maximum of 15 levels. For more information, see Requirements and Constraints for Parameter Names in the AWS Systems Manager User Guide.

" - } - }, - "documentation":"

A hierarchy can have a maximum of 15 levels. For more information, see Requirements and Constraints for Parameter Names in the AWS Systems Manager User Guide.

", - "exception":true - }, - "HierarchyTypeMismatchException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

Parameter Store does not support changing a parameter type in a hierarchy. For example, you can't change a parameter from a String type to a SecureString type. You must create a new, unique parameter.

" - } - }, - "documentation":"

Parameter Store does not support changing a parameter type in a hierarchy. For example, you can't change a parameter from a String type to a SecureString type. You must create a new, unique parameter.

", - "exception":true - }, - "IPAddress":{ - "type":"string", - "max":46, - "min":1 - }, - "IamRole":{ - "type":"string", - "max":64 - }, - "IdempotencyToken":{ - "type":"string", - "max":36, - "min":36, - "pattern":"[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}" - }, - "IdempotentParameterMismatch":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Error returned when an idempotent operation is retried and the parameters don't match the original call to the API with the same idempotency token.

", - "exception":true - }, - "InstanceAggregatedAssociationOverview":{ - "type":"structure", - "members":{ - "DetailedStatus":{ - "shape":"StatusName", - "documentation":"

Detailed status information about the aggregated associations.

" - }, - "InstanceAssociationStatusAggregatedCount":{ - "shape":"InstanceAssociationStatusAggregatedCount", - "documentation":"

The number of associations for the instance(s).

" - } - }, - "documentation":"

Status information about the aggregated associations.

" - }, - "InstanceAssociation":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - }, - "Content":{ - "shape":"DocumentContent", - "documentation":"

The content of the association document for the instance(s).

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

Version information for the association on the instance.

" - } - }, - "documentation":"

One or more association documents on the instance.

" - }, - "InstanceAssociationExecutionSummary":{ - "type":"string", - "max":512, - "min":1 - }, - "InstanceAssociationList":{ - "type":"list", - "member":{"shape":"InstanceAssociation"} - }, - "InstanceAssociationOutputLocation":{ - "type":"structure", - "members":{ - "S3Location":{ - "shape":"S3OutputLocation", - "documentation":"

An Amazon S3 bucket where you want to store the results of this request.

" - } - }, - "documentation":"

An Amazon S3 bucket where you want to store the results of this request.

" - }, - "InstanceAssociationOutputUrl":{ - "type":"structure", - "members":{ - "S3OutputUrl":{ - "shape":"S3OutputUrl", - "documentation":"

The URL of Amazon S3 bucket where you want to store the results of this request.

" - } - }, - "documentation":"

The URL of Amazon S3 bucket where you want to store the results of this request.

" - }, - "InstanceAssociationStatusAggregatedCount":{ - "type":"map", - "key":{"shape":"StatusName"}, - "value":{"shape":"InstanceCount"} - }, - "InstanceAssociationStatusInfo":{ - "type":"structure", - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID.

" - }, - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the association.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The association document verions.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

The version of the association applied to the instance.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID where the association was created.

" - }, - "ExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date the instance association executed.

" - }, - "Status":{ - "shape":"StatusName", - "documentation":"

Status information about the instance association.

" - }, - "DetailedStatus":{ - "shape":"StatusName", - "documentation":"

Detailed status information about the instance association.

" - }, - "ExecutionSummary":{ - "shape":"InstanceAssociationExecutionSummary", - "documentation":"

Summary information about association execution.

" - }, - "ErrorCode":{ - "shape":"AgentErrorCode", - "documentation":"

An error code returned by the request to create the association.

" - }, - "OutputUrl":{ - "shape":"InstanceAssociationOutputUrl", - "documentation":"

A URL for an Amazon S3 bucket where you want to store the results of this request.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

The name of the association applied to the instance.

" - } - }, - "documentation":"

Status information about the instance association.

" - }, - "InstanceAssociationStatusInfos":{ - "type":"list", - "member":{"shape":"InstanceAssociationStatusInfo"} - }, - "InstanceCount":{"type":"integer"}, - "InstanceId":{ - "type":"string", - "pattern":"(^i-(\\w{8}|\\w{17})$)|(^mi-\\w{17}$)" - }, - "InstanceIdList":{ - "type":"list", - "member":{"shape":"InstanceId"}, - "max":50, - "min":0 - }, - "InstanceInformation":{ - "type":"structure", - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID.

" - }, - "PingStatus":{ - "shape":"PingStatus", - "documentation":"

Connection status of SSM Agent.

" - }, - "LastPingDateTime":{ - "shape":"DateTime", - "documentation":"

The date and time when agent last pinged Systems Manager service.

", - "box":true - }, - "AgentVersion":{ - "shape":"Version", - "documentation":"

The version of SSM Agent running on your Linux instance.

" - }, - "IsLatestVersion":{ - "shape":"Boolean", - "documentation":"

Indicates whether latest version of SSM Agent is running on your instance. Some older versions of Windows Server use the EC2Config service to process SSM requests. For this reason, this field does not indicate whether or not the latest version is installed on Windows managed instances.

", - "box":true - }, - "PlatformType":{ - "shape":"PlatformType", - "documentation":"

The operating system platform type.

" - }, - "PlatformName":{ - "shape":"String", - "documentation":"

The name of the operating system platform running on your instance.

" - }, - "PlatformVersion":{ - "shape":"String", - "documentation":"

The version of the OS platform running on your instance.

" - }, - "ActivationId":{ - "shape":"ActivationId", - "documentation":"

The activation ID created by Systems Manager when the server or VM was registered.

" - }, - "IamRole":{ - "shape":"IamRole", - "documentation":"

The Amazon Identity and Access Management (IAM) role assigned to the on-premises Systems Manager managed instances. This call does not return the IAM role for Amazon EC2 instances.

" - }, - "RegistrationDate":{ - "shape":"DateTime", - "documentation":"

The date the server or VM was registered with AWS as a managed instance.

", - "box":true - }, - "ResourceType":{ - "shape":"ResourceType", - "documentation":"

The type of instance. Instances are either EC2 instances or managed instances.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the managed instance.

" - }, - "IPAddress":{ - "shape":"IPAddress", - "documentation":"

The IP address of the managed instance.

" - }, - "ComputerName":{ - "shape":"ComputerName", - "documentation":"

The fully qualified host name of the managed instance.

" - }, - "AssociationStatus":{ - "shape":"StatusName", - "documentation":"

The status of the association.

" - }, - "LastAssociationExecutionDate":{ - "shape":"DateTime", - "documentation":"

The date the association was last executed.

" - }, - "LastSuccessfulAssociationExecutionDate":{ - "shape":"DateTime", - "documentation":"

The last date the association was successfully run.

" - }, - "AssociationOverview":{ - "shape":"InstanceAggregatedAssociationOverview", - "documentation":"

Information about the association.

" - } - }, - "documentation":"

Describes a filter for a specific list of instances.

" - }, - "InstanceInformationFilter":{ - "type":"structure", - "required":[ - "key", - "valueSet" - ], - "members":{ - "key":{ - "shape":"InstanceInformationFilterKey", - "documentation":"

The name of the filter.

" - }, - "valueSet":{ - "shape":"InstanceInformationFilterValueSet", - "documentation":"

The filter values.

" - } - }, - "documentation":"

Describes a filter for a specific list of instances.

" - }, - "InstanceInformationFilterKey":{ - "type":"string", - "enum":[ - "InstanceIds", - "AgentVersion", - "PingStatus", - "PlatformTypes", - "ActivationIds", - "IamRole", - "ResourceType", - "AssociationStatus" - ] - }, - "InstanceInformationFilterList":{ - "type":"list", - "member":{"shape":"InstanceInformationFilter"}, - "min":0 - }, - "InstanceInformationFilterValue":{ - "type":"string", - "min":1 - }, - "InstanceInformationFilterValueSet":{ - "type":"list", - "member":{"shape":"InstanceInformationFilterValue"}, - "max":100, - "min":1 - }, - "InstanceInformationList":{ - "type":"list", - "member":{"shape":"InstanceInformation"} - }, - "InstanceInformationStringFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"InstanceInformationStringFilterKey", - "documentation":"

The filter key name to describe your instances. For example:

\"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"ResourceType\"|\"AssociationStatus\"|\"Tag Key\"

" - }, - "Values":{ - "shape":"InstanceInformationFilterValueSet", - "documentation":"

The filter values.

" - } - }, - "documentation":"

The filters to describe or get information about your managed instances.

" - }, - "InstanceInformationStringFilterKey":{ - "type":"string", - "min":1 - }, - "InstanceInformationStringFilterList":{ - "type":"list", - "member":{"shape":"InstanceInformationStringFilter"}, - "min":0 - }, - "InstancePatchState":{ - "type":"structure", - "required":[ - "InstanceId", - "PatchGroup", - "BaselineId", - "OperationStartTime", - "OperationEndTime", - "Operation" - ], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the managed instance the high-level patch compliance information was collected for.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group the managed instance belongs to.

" - }, - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline used to patch the instance.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The ID of the patch baseline snapshot used during the patching operation when this compliance data was collected.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

Placeholder information. This field will always be empty in the current release of the service.

" - }, - "InstalledCount":{ - "shape":"PatchInstalledCount", - "documentation":"

The number of patches from the patch baseline that are installed on the instance.

" - }, - "InstalledOtherCount":{ - "shape":"PatchInstalledOtherCount", - "documentation":"

The number of patches not specified in the patch baseline that are installed on the instance.

" - }, - "MissingCount":{ - "shape":"PatchMissingCount", - "documentation":"

The number of patches from the patch baseline that are applicable for the instance but aren't currently installed.

" - }, - "FailedCount":{ - "shape":"PatchFailedCount", - "documentation":"

The number of patches from the patch baseline that were attempted to be installed during the last patching operation, but failed to install.

" - }, - "NotApplicableCount":{ - "shape":"PatchNotApplicableCount", - "documentation":"

The number of patches from the patch baseline that aren't applicable for the instance and hence aren't installed on the instance.

" - }, - "OperationStartTime":{ - "shape":"DateTime", - "documentation":"

The time the most recent patching operation was started on the instance.

" - }, - "OperationEndTime":{ - "shape":"DateTime", - "documentation":"

The time the most recent patching operation completed on the instance.

" - }, - "Operation":{ - "shape":"PatchOperationType", - "documentation":"

The type of patching operation that was performed: SCAN (assess patch compliance state) or INSTALL (install missing patches).

" - } - }, - "documentation":"

Defines the high-level patch compliance state for a managed instance, providing information about the number of installed, missing, not applicable, and failed patches along with metadata about the operation when this information was gathered for the instance.

" - }, - "InstancePatchStateFilter":{ - "type":"structure", - "required":[ - "Key", - "Values", - "Type" - ], - "members":{ - "Key":{ - "shape":"InstancePatchStateFilterKey", - "documentation":"

The key for the filter. Supported values are FailedCount, InstalledCount, InstalledOtherCount, MissingCount and NotApplicableCount.

" - }, - "Values":{ - "shape":"InstancePatchStateFilterValues", - "documentation":"

The value for the filter, must be an integer greater than or equal to 0.

" - }, - "Type":{ - "shape":"InstancePatchStateOperatorType", - "documentation":"

The type of comparison that should be performed for the value: Equal, NotEqual, LessThan or GreaterThan.

" - } - }, - "documentation":"

Defines a filter used in DescribeInstancePatchStatesForPatchGroup used to scope down the information returned by the API.

" - }, - "InstancePatchStateFilterKey":{ - "type":"string", - "max":200, - "min":1 - }, - "InstancePatchStateFilterList":{ - "type":"list", - "member":{"shape":"InstancePatchStateFilter"}, - "max":4, - "min":0 - }, - "InstancePatchStateFilterValue":{"type":"string"}, - "InstancePatchStateFilterValues":{ - "type":"list", - "member":{"shape":"InstancePatchStateFilterValue"}, - "max":1, - "min":1 - }, - "InstancePatchStateList":{ - "type":"list", - "member":{"shape":"InstancePatchState"} - }, - "InstancePatchStateOperatorType":{ - "type":"string", - "enum":[ - "Equal", - "NotEqual", - "LessThan", - "GreaterThan" - ] - }, - "InstancePatchStatesList":{ - "type":"list", - "member":{"shape":"InstancePatchState"}, - "max":5, - "min":1 - }, - "InstanceTagName":{ - "type":"string", - "max":255 - }, - "Integer":{"type":"integer"}, - "InternalServerError":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An error occurred on the server side.

", - "exception":true, - "fault":true - }, - "InvalidActivation":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The activation is not valid. The activation might have been deleted, or the ActivationId and the ActivationCode do not match.

", - "exception":true - }, - "InvalidActivationId":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The activation ID is not valid. Verify the you entered the correct ActivationId or ActivationCode and try again.

", - "exception":true - }, - "InvalidAllowedPatternException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The request does not meet the regular expression requirement.

" - } - }, - "documentation":"

The request does not meet the regular expression requirement.

", - "exception":true - }, - "InvalidAssociation":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The association is not valid or does not exist.

", - "exception":true - }, - "InvalidAssociationVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The version you specified is not valid. Use ListAssociationVersions to view all versions of an association according to the association ID. Or, use the $LATEST parameter to view the latest version of the association.

", - "exception":true - }, - "InvalidAutomationExecutionParametersException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The supplied parameters for invoking the specified Automation document are incorrect. For example, they may not match the set of parameters permitted for the specified Automation document.

", - "exception":true - }, - "InvalidAutomationSignalException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The signal is not valid for the current Automation execution.

", - "exception":true - }, - "InvalidAutomationStatusUpdateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified update status operation is not valid.

", - "exception":true - }, - "InvalidCommandId":{ - "type":"structure", - "members":{ - }, - "exception":true - }, - "InvalidDeleteInventoryParametersException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

One or more of the parameters specified for the delete operation is not valid. Verify all parameters and try again.

", - "exception":true - }, - "InvalidDeletionIdException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The ID specified for the delete operation does not exist or is not valide. Verify the ID and try again.

", - "exception":true - }, - "InvalidDocument":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

The document does not exist or the document is not available to the user. This exception can be issued by CreateAssociation, CreateAssociationBatch, DeleteAssociation, DeleteDocument, DescribeAssociation, DescribeDocument, GetDocument, SendCommand, or UpdateAssociationStatus.

" - } - }, - "documentation":"

The specified document does not exist.

", - "exception":true - }, - "InvalidDocumentContent":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"String", - "documentation":"

A description of the validation error.

" - } - }, - "documentation":"

The content for the document is not valid.

", - "exception":true - }, - "InvalidDocumentOperation":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You attempted to delete a document while it is still shared. You must stop sharing the document before you can delete it.

", - "exception":true - }, - "InvalidDocumentSchemaVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The version of the document schema is not supported.

", - "exception":true - }, - "InvalidDocumentVersion":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The document version is not valid or does not exist.

", - "exception":true - }, - "InvalidFilter":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The filter name is not valid. Verify the you entered the correct name and try again.

", - "exception":true - }, - "InvalidFilterKey":{ - "type":"structure", - "members":{ - }, - "documentation":"

The specified key is not valid.

", - "exception":true - }, - "InvalidFilterOption":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The specified filter option is not valid. Valid options are Equals and BeginsWith. For Path filter, valid options are Recursive and OneLevel.

" - } - }, - "documentation":"

The specified filter option is not valid. Valid options are Equals and BeginsWith. For Path filter, valid options are Recursive and OneLevel.

", - "exception":true - }, - "InvalidFilterValue":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The filter value is not valid. Verify the value and try again.

", - "exception":true - }, - "InvalidInstanceId":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The following problems can cause this exception:

You do not have permission to access the instance.

SSM Agent is not running. On managed instances and Linux instances, verify that the SSM Agent is running. On EC2 Windows instances, verify that the EC2Config service is running.

SSM Agent or EC2Config service is not registered to the SSM endpoint. Try reinstalling SSM Agent or EC2Config service.

The instance is not in valid state. Valid states are: Running, Pending, Stopped, Stopping. Invalid states are: Shutting-down and Terminated.

", - "exception":true - }, - "InvalidInstanceInformationFilterValue":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The specified filter value is not valid.

", - "exception":true - }, - "InvalidInventoryItemContextException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You specified invalid keys or values in the Context attribute for InventoryItem. Verify the keys and values, and try again.

", - "exception":true - }, - "InvalidInventoryRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The request is not valid.

", - "exception":true - }, - "InvalidItemContentException":{ - "type":"structure", - "members":{ - "TypeName":{"shape":"InventoryItemTypeName"}, - "Message":{"shape":"String"} - }, - "documentation":"

One or more content items is not valid.

", - "exception":true - }, - "InvalidKeyId":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The query key ID is not valid.

", - "exception":true - }, - "InvalidNextToken":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified token is not valid.

", - "exception":true - }, - "InvalidNotificationConfig":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

One or more configuration items is not valid. Verify that a valid Amazon Resource Name (ARN) was provided for an Amazon SNS topic.

", - "exception":true - }, - "InvalidOptionException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The delete inventory option specified is not valid. Verify the option and try again.

", - "exception":true - }, - "InvalidOutputFolder":{ - "type":"structure", - "members":{ - }, - "documentation":"

The S3 bucket does not exist.

", - "exception":true - }, - "InvalidOutputLocation":{ - "type":"structure", - "members":{ - }, - "documentation":"

The output location is not valid or does not exist.

", - "exception":true - }, - "InvalidParameters":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You must specify values for all required parameters in the Systems Manager document. You can only supply values to parameters defined in the Systems Manager document.

", - "exception":true - }, - "InvalidPermissionType":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The permission type is not supported. Share is the only supported permission type.

", - "exception":true - }, - "InvalidPluginName":{ - "type":"structure", - "members":{ - }, - "documentation":"

The plugin name is not valid.

", - "exception":true - }, - "InvalidResourceId":{ - "type":"structure", - "members":{ - }, - "documentation":"

The resource ID is not valid. Verify that you entered the correct ID and try again.

", - "exception":true - }, - "InvalidResourceType":{ - "type":"structure", - "members":{ - }, - "documentation":"

The resource type is not valid. For example, if you are attempting to tag an instance, the instance must be a registered, managed instance.

", - "exception":true - }, - "InvalidResultAttributeException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified inventory item result attribute is not valid.

", - "exception":true - }, - "InvalidRole":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The role name can't contain invalid characters. Also verify that you specified an IAM role for notifications that includes the required trust policy. For information about configuring the IAM role for Run Command notifications, see Configuring Amazon SNS Notifications for Run Command in the AWS Systems Manager User Guide.

", - "exception":true - }, - "InvalidSchedule":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The schedule is invalid. Verify your cron or rate expression and try again.

", - "exception":true - }, - "InvalidTarget":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The target is not valid or does not exist. It might not be configured for EC2 Systems Manager or you might not have permission to perform the operation.

", - "exception":true - }, - "InvalidTypeNameException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The parameter type name is not valid.

", - "exception":true - }, - "InvalidUpdate":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The update is not valid.

", - "exception":true - }, - "InventoryAggregator":{ - "type":"structure", - "members":{ - "Expression":{ - "shape":"InventoryAggregatorExpression", - "documentation":"

The inventory type and attribute name for aggregation.

" - }, - "Aggregators":{ - "shape":"InventoryAggregatorList", - "documentation":"

Nested aggregators to further refine aggregation for an inventory type.

" - } - }, - "documentation":"

Specifies the inventory type and attribute for the aggregation execution.

" - }, - "InventoryAggregatorExpression":{ - "type":"string", - "max":1000, - "min":1 - }, - "InventoryAggregatorList":{ - "type":"list", - "member":{"shape":"InventoryAggregator"}, - "max":10, - "min":1 - }, - "InventoryAttributeDataType":{ - "type":"string", - "enum":[ - "string", - "number" - ] - }, - "InventoryDeletionId":{"type":"string"}, - "InventoryDeletionLastStatusMessage":{"type":"string"}, - "InventoryDeletionLastStatusUpdateTime":{"type":"timestamp"}, - "InventoryDeletionStartTime":{"type":"timestamp"}, - "InventoryDeletionStatus":{ - "type":"string", - "enum":[ - "InProgress", - "Complete" - ] - }, - "InventoryDeletionStatusItem":{ - "type":"structure", - "members":{ - "DeletionId":{ - "shape":"InventoryDeletionId", - "documentation":"

The deletion ID returned by the DeleteInventory action.

" - }, - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the inventory data type.

" - }, - "DeletionStartTime":{ - "shape":"InventoryDeletionStartTime", - "documentation":"

The UTC timestamp when the delete operation started.

" - }, - "LastStatus":{ - "shape":"InventoryDeletionStatus", - "documentation":"

The status of the operation. Possible values are InProgress and Complete.

" - }, - "LastStatusMessage":{ - "shape":"InventoryDeletionLastStatusMessage", - "documentation":"

Information about the status.

" - }, - "DeletionSummary":{ - "shape":"InventoryDeletionSummary", - "documentation":"

Information about the delete operation. For more information about this summary, see Understanding the Delete Inventory Summary in the AWS Systems Manager User Guide.

" - }, - "LastStatusUpdateTime":{ - "shape":"InventoryDeletionLastStatusUpdateTime", - "documentation":"

The UTC timestamp of when the last status report.

" - } - }, - "documentation":"

Status information returned by the DeleteInventory action.

" - }, - "InventoryDeletionSummary":{ - "type":"structure", - "members":{ - "TotalCount":{ - "shape":"TotalCount", - "documentation":"

The total number of items to delete. This count does not change during the delete operation.

" - }, - "RemainingCount":{ - "shape":"RemainingCount", - "documentation":"

Remaining number of items to delete.

" - }, - "SummaryItems":{ - "shape":"InventoryDeletionSummaryItems", - "documentation":"

A list of counts and versions for deleted items.

" - } - }, - "documentation":"

Information about the delete operation.

" - }, - "InventoryDeletionSummaryItem":{ - "type":"structure", - "members":{ - "Version":{ - "shape":"InventoryItemSchemaVersion", - "documentation":"

The inventory type version.

" - }, - "Count":{ - "shape":"ResourceCount", - "documentation":"

A count of the number of deleted items.

" - }, - "RemainingCount":{ - "shape":"RemainingCount", - "documentation":"

The remaining number of items to delete.

" - } - }, - "documentation":"

Either a count, remaining count, or a version number in a delete inventory summary.

" - }, - "InventoryDeletionSummaryItems":{ - "type":"list", - "member":{"shape":"InventoryDeletionSummaryItem"} - }, - "InventoryDeletionsList":{ - "type":"list", - "member":{"shape":"InventoryDeletionStatusItem"} - }, - "InventoryFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"InventoryFilterKey", - "documentation":"

The name of the filter key.

" - }, - "Values":{ - "shape":"InventoryFilterValueList", - "documentation":"

Inventory filter values. Example: inventory filter where instance IDs are specified as values Key=AWS:InstanceInformation.InstanceId,Values= i-a12b3c4d5e6g, i-1a2b3c4d5e6,Type=Equal

" - }, - "Type":{ - "shape":"InventoryQueryOperatorType", - "documentation":"

The type of filter. Valid values include the following: \"Equal\"|\"NotEqual\"|\"BeginWith\"|\"LessThan\"|\"GreaterThan\"

" - } - }, - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "InventoryFilterKey":{ - "type":"string", - "max":200, - "min":1 - }, - "InventoryFilterList":{ - "type":"list", - "member":{"shape":"InventoryFilter"}, - "max":5, - "min":1 - }, - "InventoryFilterValue":{"type":"string"}, - "InventoryFilterValueList":{ - "type":"list", - "member":{"shape":"InventoryFilterValue"}, - "max":20, - "min":1 - }, - "InventoryItem":{ - "type":"structure", - "required":[ - "TypeName", - "SchemaVersion", - "CaptureTime" - ], - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.

" - }, - "SchemaVersion":{ - "shape":"InventoryItemSchemaVersion", - "documentation":"

The schema version for the inventory item.

" - }, - "CaptureTime":{ - "shape":"InventoryItemCaptureTime", - "documentation":"

The time the inventory information was collected.

" - }, - "ContentHash":{ - "shape":"InventoryItemContentHash", - "documentation":"

MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update.

" - }, - "Content":{ - "shape":"InventoryItemEntryList", - "documentation":"

The inventory data of the inventory type.

" - }, - "Context":{ - "shape":"InventoryItemContentContext", - "documentation":"

A map of associated properties for a specified inventory type. For example, with this attribute, you can specify the ExecutionId, ExecutionType, ComplianceType properties of the AWS:ComplianceItem type.

" - } - }, - "documentation":"

Information collected from managed instances based on your inventory policy document

" - }, - "InventoryItemAttribute":{ - "type":"structure", - "required":[ - "Name", - "DataType" - ], - "members":{ - "Name":{ - "shape":"InventoryItemAttributeName", - "documentation":"

Name of the inventory item attribute.

" - }, - "DataType":{ - "shape":"InventoryAttributeDataType", - "documentation":"

The data type of the inventory item attribute.

" - } - }, - "documentation":"

Attributes are the entries within the inventory item content. It contains name and value.

" - }, - "InventoryItemAttributeList":{ - "type":"list", - "member":{"shape":"InventoryItemAttribute"}, - "max":50, - "min":1 - }, - "InventoryItemAttributeName":{"type":"string"}, - "InventoryItemCaptureTime":{ - "type":"string", - "pattern":"^(20)[0-9][0-9]-(0[1-9]|1[012])-([12][0-9]|3[01]|0[1-9])(T)(2[0-3]|[0-1][0-9])(:[0-5][0-9])(:[0-5][0-9])(Z)$" - }, - "InventoryItemContentContext":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"}, - "max":50, - "min":0 - }, - "InventoryItemContentHash":{ - "type":"string", - "max":256 - }, - "InventoryItemEntry":{ - "type":"map", - "key":{"shape":"AttributeName"}, - "value":{"shape":"AttributeValue"}, - "max":50, - "min":0 - }, - "InventoryItemEntryList":{ - "type":"list", - "member":{"shape":"InventoryItemEntry"}, - "max":10000, - "min":0 - }, - "InventoryItemList":{ - "type":"list", - "member":{"shape":"InventoryItem"}, - "max":30, - "min":1 - }, - "InventoryItemSchema":{ - "type":"structure", - "required":[ - "TypeName", - "Attributes" - ], - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.

" - }, - "Version":{ - "shape":"InventoryItemSchemaVersion", - "documentation":"

The schema version for the inventory item.

" - }, - "Attributes":{ - "shape":"InventoryItemAttributeList", - "documentation":"

The schema attributes for inventory. This contains data type and attribute name.

" - }, - "DisplayName":{ - "shape":"InventoryTypeDisplayName", - "documentation":"

The alias name of the inventory type. The alias name is used for display purposes.

" - } - }, - "documentation":"

The inventory item schema definition. Users can use this to compose inventory query filters.

" - }, - "InventoryItemSchemaResultList":{ - "type":"list", - "member":{"shape":"InventoryItemSchema"} - }, - "InventoryItemSchemaVersion":{ - "type":"string", - "pattern":"^([0-9]{1,6})(\\.[0-9]{1,6})$" - }, - "InventoryItemTypeName":{ - "type":"string", - "max":100, - "min":1, - "pattern":"^(AWS|Custom):.*$" - }, - "InventoryItemTypeNameFilter":{ - "type":"string", - "max":100, - "min":0 - }, - "InventoryQueryOperatorType":{ - "type":"string", - "enum":[ - "Equal", - "NotEqual", - "BeginWith", - "LessThan", - "GreaterThan" - ] - }, - "InventoryResultEntity":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"InventoryResultEntityId", - "documentation":"

ID of the inventory result entity. For example, for managed instance inventory the result will be the managed instance ID. For EC2 instance inventory, the result will be the instance ID.

" - }, - "Data":{ - "shape":"InventoryResultItemMap", - "documentation":"

The data section in the inventory result entity JSON.

" - } - }, - "documentation":"

Inventory query results.

" - }, - "InventoryResultEntityId":{"type":"string"}, - "InventoryResultEntityList":{ - "type":"list", - "member":{"shape":"InventoryResultEntity"} - }, - "InventoryResultItem":{ - "type":"structure", - "required":[ - "TypeName", - "SchemaVersion", - "Content" - ], - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The name of the inventory result item type.

" - }, - "SchemaVersion":{ - "shape":"InventoryItemSchemaVersion", - "documentation":"

The schema version for the inventory result item/

" - }, - "CaptureTime":{ - "shape":"InventoryItemCaptureTime", - "documentation":"

The time inventory item data was captured.

" - }, - "ContentHash":{ - "shape":"InventoryItemContentHash", - "documentation":"

MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update.

" - }, - "Content":{ - "shape":"InventoryItemEntryList", - "documentation":"

Contains all the inventory data of the item type. Results include attribute names and values.

" - } - }, - "documentation":"

The inventory result item.

" - }, - "InventoryResultItemKey":{"type":"string"}, - "InventoryResultItemMap":{ - "type":"map", - "key":{"shape":"InventoryResultItemKey"}, - "value":{"shape":"InventoryResultItem"} - }, - "InventorySchemaDeleteOption":{ - "type":"string", - "enum":[ - "DisableSchema", - "DeleteSchema" - ] - }, - "InventoryTypeDisplayName":{"type":"string"}, - "InvocationDoesNotExist":{ - "type":"structure", - "members":{ - }, - "documentation":"

The command ID and instance ID you specified did not match any invocations. Verify the command ID adn the instance ID and try again.

", - "exception":true - }, - "InvocationTraceOutput":{ - "type":"string", - "max":2500 - }, - "IsSubTypeSchema":{"type":"boolean"}, - "ItemContentMismatchException":{ - "type":"structure", - "members":{ - "TypeName":{"shape":"InventoryItemTypeName"}, - "Message":{"shape":"String"} - }, - "documentation":"

The inventory item has invalid content.

", - "exception":true - }, - "ItemSizeLimitExceededException":{ - "type":"structure", - "members":{ - "TypeName":{"shape":"InventoryItemTypeName"}, - "Message":{"shape":"String"} - }, - "documentation":"

The inventory item size has exceeded the size limit.

", - "exception":true - }, - "KeyList":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "LabelParameterVersionRequest":{ - "type":"structure", - "required":[ - "Name", - "Labels" - ], - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The parameter name on which you want to attach one or more labels.

" - }, - "ParameterVersion":{ - "shape":"PSParameterVersion", - "documentation":"

The specific version of the parameter on which you want to attach one or more labels. If no version is specified, the system attaches the label to the latest version.)

", - "box":true - }, - "Labels":{ - "shape":"ParameterLabelList", - "documentation":"

One or more labels to attach to the specified parameter version.

" - } - } - }, - "LabelParameterVersionResult":{ - "type":"structure", - "members":{ - "InvalidLabels":{ - "shape":"ParameterLabelList", - "documentation":"

The label does not meet the requirements. For information about parameter label requirements, see Labeling Parameters in the AWS Systems Manager User Guide.

" - } - } - }, - "LastResourceDataSyncMessage":{"type":"string"}, - "LastResourceDataSyncStatus":{ - "type":"string", - "enum":[ - "Successful", - "Failed", - "InProgress" - ] - }, - "LastResourceDataSyncTime":{"type":"timestamp"}, - "LastSuccessfulResourceDataSyncTime":{"type":"timestamp"}, - "ListAssociationVersionsRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The association ID for which you want to view all versions.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - } - } - }, - "ListAssociationVersionsResult":{ - "type":"structure", - "members":{ - "AssociationVersions":{ - "shape":"AssociationVersionList", - "documentation":"

Information about all versions of the association for the specified association ID.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "ListAssociationsRequest":{ - "type":"structure", - "members":{ - "AssociationFilterList":{ - "shape":"AssociationFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "ListAssociationsResult":{ - "type":"structure", - "members":{ - "Associations":{ - "shape":"AssociationList", - "documentation":"

The associations.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "ListCommandInvocationsRequest":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

(Optional) The invocations for a specific command ID.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

(Optional) The command execution details for a specific instance ID.

" - }, - "MaxResults":{ - "shape":"CommandMaxResults", - "documentation":"

(Optional) The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

(Optional) The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "Filters":{ - "shape":"CommandFilterList", - "documentation":"

(Optional) One or more filters. Use a filter to return a more specific list of results.

" - }, - "Details":{ - "shape":"Boolean", - "documentation":"

(Optional) If set this returns the response of the command executions and any command output. By default this is set to False.

" - } - } - }, - "ListCommandInvocationsResult":{ - "type":"structure", - "members":{ - "CommandInvocations":{ - "shape":"CommandInvocationList", - "documentation":"

(Optional) A list of all invocations.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

(Optional) The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "ListCommandsRequest":{ - "type":"structure", - "members":{ - "CommandId":{ - "shape":"CommandId", - "documentation":"

(Optional) If provided, lists only the specified command.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

(Optional) Lists commands issued against this instance ID.

" - }, - "MaxResults":{ - "shape":"CommandMaxResults", - "documentation":"

(Optional) The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

(Optional) The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "Filters":{ - "shape":"CommandFilterList", - "documentation":"

(Optional) One or more filters. Use a filter to return a more specific list of results.

" - } - } - }, - "ListCommandsResult":{ - "type":"structure", - "members":{ - "Commands":{ - "shape":"CommandList", - "documentation":"

(Optional) The list of commands requested by the user.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

(Optional) The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "ListComplianceItemsRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ComplianceStringFilterList", - "documentation":"

One or more compliance filters. Use a filter to return a more specific list of results.

" - }, - "ResourceIds":{ - "shape":"ComplianceResourceIdList", - "documentation":"

The ID for the resources from which to get compliance information. Currently, you can only specify one resource ID.

" - }, - "ResourceTypes":{ - "shape":"ComplianceResourceTypeList", - "documentation":"

The type of resource from which to get compliance information. Currently, the only supported resource type is ManagedInstance.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "ListComplianceItemsResult":{ - "type":"structure", - "members":{ - "ComplianceItems":{ - "shape":"ComplianceItemList", - "documentation":"

A list of compliance information for the specified resource ID.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "ListComplianceSummariesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ComplianceStringFilterList", - "documentation":"

One or more compliance or inventory filters. Use a filter to return a more specific list of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. Currently, you can specify null or 50. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "ListComplianceSummariesResult":{ - "type":"structure", - "members":{ - "ComplianceSummaryItems":{ - "shape":"ComplianceSummaryItemList", - "documentation":"

A list of compliant and non-compliant summary counts based on compliance types. For example, this call returns State Manager associations, patches, or custom compliance types according to the filter criteria that you specified.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "ListDocumentVersionsRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document about which you want version information.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "ListDocumentVersionsResult":{ - "type":"structure", - "members":{ - "DocumentVersions":{ - "shape":"DocumentVersionList", - "documentation":"

The document versions.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "ListDocumentsRequest":{ - "type":"structure", - "members":{ - "DocumentFilterList":{ - "shape":"DocumentFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "Filters":{ - "shape":"DocumentKeyValuesFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - } - } - }, - "ListDocumentsResult":{ - "type":"structure", - "members":{ - "DocumentIdentifiers":{ - "shape":"DocumentIdentifierList", - "documentation":"

The names of the Systems Manager documents.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "ListInventoryEntriesRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "TypeName" - ], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID for which you want inventory information.

" - }, - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The type of inventory item for which you want information.

" - }, - "Filters":{ - "shape":"InventoryFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "ListInventoryEntriesResult":{ - "type":"structure", - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

The type of inventory item returned by the request.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The instance ID targeted by the request to query inventory information.

" - }, - "SchemaVersion":{ - "shape":"InventoryItemSchemaVersion", - "documentation":"

The inventory schema version used by the instance(s).

" - }, - "CaptureTime":{ - "shape":"InventoryItemCaptureTime", - "documentation":"

The time that inventory information was collected for the instance(s).

" - }, - "Entries":{ - "shape":"InventoryItemEntryList", - "documentation":"

A list of inventory items on the instance(s).

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

" - } - } - }, - "ListResourceComplianceSummariesRequest":{ - "type":"structure", - "members":{ - "Filters":{ - "shape":"ComplianceStringFilterList", - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "ListResourceComplianceSummariesResult":{ - "type":"structure", - "members":{ - "ResourceComplianceSummaryItems":{ - "shape":"ResourceComplianceSummaryItemList", - "documentation":"

A summary count for specified or targeted managed instances. Summary count includes information about compliant and non-compliant State Manager associations, patch status, or custom items according to the filter criteria that you specify.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "ListResourceDataSyncRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

A token to start the list. Use this token to get the next set of results.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

", - "box":true - } - } - }, - "ListResourceDataSyncResult":{ - "type":"structure", - "members":{ - "ResourceDataSyncItems":{ - "shape":"ResourceDataSyncItemList", - "documentation":"

A list of your current Resource Data Sync configurations and their statuses.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token for the next set of items to return. Use this token to get the next set of results.

" - } - } - }, - "ListTagsForResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId" - ], - "members":{ - "ResourceType":{ - "shape":"ResourceTypeForTagging", - "documentation":"

Returns a list of tags for a specific resource type.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource ID for which you want to see a list of tags.

" - } - } - }, - "ListTagsForResourceResult":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

A list of tags.

" - } - } - }, - "LoggingInfo":{ - "type":"structure", - "required":[ - "S3BucketName", - "S3Region" - ], - "members":{ - "S3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of an Amazon S3 bucket where execution logs are stored .

" - }, - "S3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

(Optional) The Amazon S3 bucket subfolder.

" - }, - "S3Region":{ - "shape":"S3Region", - "documentation":"

The region where the Amazon S3 bucket is located.

" - } - }, - "documentation":"

Information about an Amazon S3 bucket to write instance-level logs to.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Long":{"type":"long"}, - "MaintenanceWindowAllowUnassociatedTargets":{"type":"boolean"}, - "MaintenanceWindowAutomationParameters":{ - "type":"structure", - "members":{ - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of an Automation document to use during task execution.

" - }, - "Parameters":{ - "shape":"AutomationParameterMap", - "documentation":"

The parameters for the AUTOMATION task.

For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

For AUTOMATION task types, Systems Manager ignores any values specified for these parameters.

" - } - }, - "documentation":"

The parameters for an AUTOMATION task type.

" - }, - "MaintenanceWindowCutoff":{ - "type":"integer", - "max":23, - "min":0 - }, - "MaintenanceWindowDescription":{ - "type":"string", - "max":128, - "min":1, - "sensitive":true - }, - "MaintenanceWindowDurationHours":{ - "type":"integer", - "max":24, - "min":1 - }, - "MaintenanceWindowEnabled":{"type":"boolean"}, - "MaintenanceWindowExecution":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window.

" - }, - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The status of the execution.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the Status. Only available for certain status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time the execution started.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time the execution finished.

" - } - }, - "documentation":"

Describes the information about an execution of a Maintenance Window.

" - }, - "MaintenanceWindowExecutionId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$" - }, - "MaintenanceWindowExecutionList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowExecution"} - }, - "MaintenanceWindowExecutionStatus":{ - "type":"string", - "enum":[ - "PENDING", - "IN_PROGRESS", - "SUCCESS", - "FAILED", - "TIMED_OUT", - "CANCELLING", - "CANCELLED", - "SKIPPED_OVERLAPPING" - ] - }, - "MaintenanceWindowExecutionStatusDetails":{ - "type":"string", - "max":250, - "min":0 - }, - "MaintenanceWindowExecutionTaskExecutionId":{"type":"string"}, - "MaintenanceWindowExecutionTaskId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$" - }, - "MaintenanceWindowExecutionTaskIdList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowExecutionTaskId"} - }, - "MaintenanceWindowExecutionTaskIdentity":{ - "type":"structure", - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution that ran the task.

" - }, - "TaskExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task execution in the Maintenance Window execution.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The status of the task execution.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the status of the task execution. Only available for certain status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time the task execution started.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time the task execution finished.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The ARN of the executed task.

" - }, - "TaskType":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The type of executed task.

" - } - }, - "documentation":"

Information about a task execution performed as part of a Maintenance Window execution.

" - }, - "MaintenanceWindowExecutionTaskIdentityList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowExecutionTaskIdentity"} - }, - "MaintenanceWindowExecutionTaskInvocationId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$" - }, - "MaintenanceWindowExecutionTaskInvocationIdentity":{ - "type":"structure", - "members":{ - "WindowExecutionId":{ - "shape":"MaintenanceWindowExecutionId", - "documentation":"

The ID of the Maintenance Window execution that ran the task.

" - }, - "TaskExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskId", - "documentation":"

The ID of the specific task execution in the Maintenance Window execution.

" - }, - "InvocationId":{ - "shape":"MaintenanceWindowExecutionTaskInvocationId", - "documentation":"

The ID of the task invocation.

" - }, - "ExecutionId":{ - "shape":"MaintenanceWindowExecutionTaskExecutionId", - "documentation":"

The ID of the action performed in the service that actually handled the task invocation. If the task type is RUN_COMMAND, this value is the command ID.

" - }, - "TaskType":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The task type.

" - }, - "Parameters":{ - "shape":"MaintenanceWindowExecutionTaskInvocationParameters", - "documentation":"

The parameters that were provided for the invocation when it was executed.

" - }, - "Status":{ - "shape":"MaintenanceWindowExecutionStatus", - "documentation":"

The status of the task invocation.

" - }, - "StatusDetails":{ - "shape":"MaintenanceWindowExecutionStatusDetails", - "documentation":"

The details explaining the status of the task invocation. Only available for certain Status values.

" - }, - "StartTime":{ - "shape":"DateTime", - "documentation":"

The time the invocation started.

" - }, - "EndTime":{ - "shape":"DateTime", - "documentation":"

The time the invocation finished.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

User-provided value that was specified when the target was registered with the Maintenance Window. This was also included in any CloudWatch events raised during the task invocation.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTaskTargetId", - "documentation":"

The ID of the target definition in this Maintenance Window the invocation was performed for.

" - } - }, - "documentation":"

Describes the information about a task invocation for a particular target as part of a task execution performed as part of a Maintenance Window execution.

" - }, - "MaintenanceWindowExecutionTaskInvocationIdentityList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowExecutionTaskInvocationIdentity"} - }, - "MaintenanceWindowExecutionTaskInvocationParameters":{ - "type":"string", - "sensitive":true - }, - "MaintenanceWindowFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"MaintenanceWindowFilterKey", - "documentation":"

The name of the filter.

" - }, - "Values":{ - "shape":"MaintenanceWindowFilterValues", - "documentation":"

The filter values.

" - } - }, - "documentation":"

Filter used in the request.

" - }, - "MaintenanceWindowFilterKey":{ - "type":"string", - "max":128, - "min":1 - }, - "MaintenanceWindowFilterList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowFilter"}, - "max":5, - "min":0 - }, - "MaintenanceWindowFilterValue":{ - "type":"string", - "max":256, - "min":1 - }, - "MaintenanceWindowFilterValues":{ - "type":"list", - "member":{"shape":"MaintenanceWindowFilterValue"} - }, - "MaintenanceWindowId":{ - "type":"string", - "max":20, - "min":20, - "pattern":"^mw-[0-9a-f]{17}$" - }, - "MaintenanceWindowIdentity":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The name of the Maintenance Window.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

A description of the Maintenance Window.

" - }, - "Enabled":{ - "shape":"MaintenanceWindowEnabled", - "documentation":"

Whether the Maintenance Window is enabled.

" - }, - "Duration":{ - "shape":"MaintenanceWindowDurationHours", - "documentation":"

The duration of the Maintenance Window in hours.

" - }, - "Cutoff":{ - "shape":"MaintenanceWindowCutoff", - "documentation":"

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

" - } - }, - "documentation":"

Information about the Maintenance Window.

" - }, - "MaintenanceWindowIdentityList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowIdentity"} - }, - "MaintenanceWindowLambdaClientContext":{ - "type":"string", - "max":8000, - "min":1 - }, - "MaintenanceWindowLambdaParameters":{ - "type":"structure", - "members":{ - "ClientContext":{ - "shape":"MaintenanceWindowLambdaClientContext", - "documentation":"

Pass client-specific information to the Lambda function that you are invoking. You can then process the client information in your Lambda function as you choose through the context variable.

" - }, - "Qualifier":{ - "shape":"MaintenanceWindowLambdaQualifier", - "documentation":"

(Optional) Specify a Lambda function version or alias name. If you specify a function version, the action uses the qualified function ARN to invoke a specific Lambda function. If you specify an alias name, the action uses the alias ARN to invoke the Lambda function version to which the alias points.

" - }, - "Payload":{ - "shape":"MaintenanceWindowLambdaPayload", - "documentation":"

JSON to provide to your Lambda function as input.

" - } - }, - "documentation":"

The parameters for a LAMBDA task type.

For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

For Lambda tasks, Systems Manager ignores any values specified for TaskParameters and LoggingInfo.

" - }, - "MaintenanceWindowLambdaPayload":{ - "type":"blob", - "max":4096, - "sensitive":true - }, - "MaintenanceWindowLambdaQualifier":{ - "type":"string", - "max":128, - "min":1 - }, - "MaintenanceWindowMaxResults":{ - "type":"integer", - "max":100, - "min":10 - }, - "MaintenanceWindowName":{ - "type":"string", - "max":128, - "min":3, - "pattern":"^[a-zA-Z0-9_\\-.]{3,128}$" - }, - "MaintenanceWindowResourceType":{ - "type":"string", - "enum":["INSTANCE"] - }, - "MaintenanceWindowRunCommandParameters":{ - "type":"structure", - "members":{ - "Comment":{ - "shape":"Comment", - "documentation":"

Information about the command(s) to execute.

" - }, - "DocumentHash":{ - "shape":"DocumentHash", - "documentation":"

The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.

" - }, - "DocumentHashType":{ - "shape":"DocumentHashType", - "documentation":"

SHA-256 or SHA-1. SHA-1 hashes have been deprecated.

" - }, - "NotificationConfig":{ - "shape":"NotificationConfig", - "documentation":"

Configurations for sending notifications about command status changes on a per-instance basis.

" - }, - "OutputS3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the Amazon S3 bucket.

" - }, - "OutputS3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The Amazon S3 bucket subfolder.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The parameters for the RUN_COMMAND task execution.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The IAM service role to assume during task execution.

" - }, - "TimeoutSeconds":{ - "shape":"TimeoutSeconds", - "documentation":"

If this time is reached and the command has not already started executing, it doesn not execute.

", - "box":true - } - }, - "documentation":"

The parameters for a RUN_COMMAND task type.

For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

For Run Command tasks, Systems Manager uses specified values for TaskParameters and LoggingInfo only if no values are specified for TaskInvocationParameters.

" - }, - "MaintenanceWindowSchedule":{ - "type":"string", - "max":256, - "min":1 - }, - "MaintenanceWindowStepFunctionsInput":{ - "type":"string", - "max":4096, - "sensitive":true - }, - "MaintenanceWindowStepFunctionsName":{ - "type":"string", - "max":80, - "min":1 - }, - "MaintenanceWindowStepFunctionsParameters":{ - "type":"structure", - "members":{ - "Input":{ - "shape":"MaintenanceWindowStepFunctionsInput", - "documentation":"

The inputs for the STEP_FUNCTION task.

" - }, - "Name":{ - "shape":"MaintenanceWindowStepFunctionsName", - "documentation":"

The name of the STEP_FUNCTION task.

" - } - }, - "documentation":"

The parameters for a STEP_FUNCTION task.

For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

For Step Functions tasks, Systems Manager ignores any values specified for TaskParameters and LoggingInfo.

" - }, - "MaintenanceWindowTarget":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID where the target is registered.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The ID of the target.

" - }, - "ResourceType":{ - "shape":"MaintenanceWindowResourceType", - "documentation":"

The type of target.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

User-provided value that will be included in any CloudWatch events raised while running tasks for these targets in this Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The target name.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

A description of the target.

" - } - }, - "documentation":"

The target registered with the Maintenance Window.

" - }, - "MaintenanceWindowTargetId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$" - }, - "MaintenanceWindowTargetList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowTarget"} - }, - "MaintenanceWindowTask":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID where the task is registered.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The task ID.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The resource that the task uses during execution. For RUN_COMMAND and AUTOMATION task types, TaskArn is the Systems Manager document name or ARN. For LAMBDA tasks, it's the function name or ARN. For STEP_FUNCTION tasks, it's the state machine ARN.

" - }, - "Type":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The type of task. The type can be one of the following: RUN_COMMAND, AUTOMATION, LAMBDA, or STEP_FUNCTION.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParameters", - "documentation":"

The parameters that should be passed to the task when it is executed.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The priority of the task in the Maintenance Window. The lower the number, the higher the priority. Tasks that have the same priority are scheduled in parallel.

" - }, - "LoggingInfo":{ - "shape":"LoggingInfo", - "documentation":"

Information about an Amazon S3 bucket to write task-level logs to.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The role that should be assumed when executing the task

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The maximum number of targets this task can be run for in parallel.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The maximum number of errors allowed before this task stops being scheduled.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The task name.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

A description of the task.

" - } - }, - "documentation":"

Information about a task defined for a Maintenance Window.

" - }, - "MaintenanceWindowTaskArn":{ - "type":"string", - "max":1600, - "min":1 - }, - "MaintenanceWindowTaskId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$" - }, - "MaintenanceWindowTaskInvocationParameters":{ - "type":"structure", - "members":{ - "RunCommand":{ - "shape":"MaintenanceWindowRunCommandParameters", - "documentation":"

The parameters for a RUN_COMMAND task type.

" - }, - "Automation":{ - "shape":"MaintenanceWindowAutomationParameters", - "documentation":"

The parameters for an AUTOMATION task type.

" - }, - "StepFunctions":{ - "shape":"MaintenanceWindowStepFunctionsParameters", - "documentation":"

The parameters for a STEP_FUNCTION task type.

" - }, - "Lambda":{ - "shape":"MaintenanceWindowLambdaParameters", - "documentation":"

The parameters for a LAMBDA task type.

" - } - }, - "documentation":"

The parameters for task execution.

" - }, - "MaintenanceWindowTaskList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowTask"} - }, - "MaintenanceWindowTaskParameterName":{ - "type":"string", - "max":255, - "min":1 - }, - "MaintenanceWindowTaskParameterValue":{ - "type":"string", - "max":255, - "min":1, - "sensitive":true - }, - "MaintenanceWindowTaskParameterValueExpression":{ - "type":"structure", - "members":{ - "Values":{ - "shape":"MaintenanceWindowTaskParameterValueList", - "documentation":"

This field contains an array of 0 or more strings, each 1 to 255 characters in length.

" - } - }, - "documentation":"

Defines the values for a task parameter.

", - "sensitive":true - }, - "MaintenanceWindowTaskParameterValueList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowTaskParameterValue"}, - "sensitive":true - }, - "MaintenanceWindowTaskParameters":{ - "type":"map", - "key":{"shape":"MaintenanceWindowTaskParameterName"}, - "value":{"shape":"MaintenanceWindowTaskParameterValueExpression"}, - "sensitive":true - }, - "MaintenanceWindowTaskParametersList":{ - "type":"list", - "member":{"shape":"MaintenanceWindowTaskParameters"}, - "sensitive":true - }, - "MaintenanceWindowTaskPriority":{ - "type":"integer", - "min":0 - }, - "MaintenanceWindowTaskTargetId":{ - "type":"string", - "max":36 - }, - "MaintenanceWindowTaskType":{ - "type":"string", - "enum":[ - "RUN_COMMAND", - "AUTOMATION", - "STEP_FUNCTIONS", - "LAMBDA" - ] - }, - "ManagedInstanceId":{ - "type":"string", - "pattern":"^mi-[0-9a-f]{17}$" - }, - "MaxConcurrency":{ - "type":"string", - "max":7, - "min":1, - "pattern":"^([1-9][0-9]*|[1-9][0-9]%|[1-9]%|100%)$" - }, - "MaxDocumentSizeExceeded":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The size limit of a document is 64 KB.

", - "exception":true - }, - "MaxErrors":{ - "type":"string", - "max":7, - "min":1, - "pattern":"^([1-9][0-9]*|[0]|[1-9][0-9]%|[0-9]%|100%)$" - }, - "MaxResults":{ - "type":"integer", - "max":50, - "min":1 - }, - "MaxResultsEC2Compatible":{ - "type":"integer", - "max":50, - "min":5 - }, - "ModifyDocumentPermissionRequest":{ - "type":"structure", - "required":[ - "Name", - "PermissionType" - ], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document that you want to share.

" - }, - "PermissionType":{ - "shape":"DocumentPermissionType", - "documentation":"

The permission type for the document. The permission type can be Share.

" - }, - "AccountIdsToAdd":{ - "shape":"AccountIdList", - "documentation":"

The AWS user accounts that should have access to the document. The account IDs can either be a group of account IDs or All.

" - }, - "AccountIdsToRemove":{ - "shape":"AccountIdList", - "documentation":"

The AWS user accounts that should no longer have access to the document. The AWS user account can either be a group of account IDs or All. This action has a higher priority than AccountIdsToAdd. If you specify an account ID to add and the same ID to remove, the system removes access to the document.

" - } - } - }, - "ModifyDocumentPermissionResponse":{ - "type":"structure", - "members":{ - } - }, - "NextToken":{"type":"string"}, - "NonCompliantSummary":{ - "type":"structure", - "members":{ - "NonCompliantCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of compliance items that are not compliant.

" - }, - "SeveritySummary":{ - "shape":"SeveritySummary", - "documentation":"

A summary of the non-compliance severity by compliance type

" - } - }, - "documentation":"

A summary of resources that are not compliant. The summary is organized according to resource type.

" - }, - "NormalStringMap":{ - "type":"map", - "key":{"shape":"String"}, - "value":{"shape":"String"} - }, - "NotificationArn":{"type":"string"}, - "NotificationConfig":{ - "type":"structure", - "members":{ - "NotificationArn":{ - "shape":"NotificationArn", - "documentation":"

An Amazon Resource Name (ARN) for a Simple Notification Service (SNS) topic. Run Command pushes notifications about command status changes to this topic.

" - }, - "NotificationEvents":{ - "shape":"NotificationEventList", - "documentation":"

The different events for which you can receive notifications. These events include the following: All (events), InProgress, Success, TimedOut, Cancelled, Failed. To learn more about these events, see Configuring Amazon SNS Notifications for Run Command in the AWS Systems Manager User Guide.

" - }, - "NotificationType":{ - "shape":"NotificationType", - "documentation":"

Command: Receive notification when the status of a command changes. Invocation: For commands sent to multiple instances, receive notification on a per-instance basis when the status of a command changes.

" - } - }, - "documentation":"

Configurations for sending notifications.

" - }, - "NotificationEvent":{ - "type":"string", - "enum":[ - "All", - "InProgress", - "Success", - "TimedOut", - "Cancelled", - "Failed" - ] - }, - "NotificationEventList":{ - "type":"list", - "member":{"shape":"NotificationEvent"} - }, - "NotificationType":{ - "type":"string", - "enum":[ - "Command", - "Invocation" - ] - }, - "OperatingSystem":{ - "type":"string", - "enum":[ - "WINDOWS", - "AMAZON_LINUX", - "AMAZON_LINUX_2", - "UBUNTU", - "REDHAT_ENTERPRISE_LINUX", - "SUSE", - "CENTOS" - ] - }, - "OutputSource":{ - "type":"structure", - "members":{ - "OutputSourceId":{ - "shape":"OutputSourceId", - "documentation":"

The ID of the output source, for example the URL of an Amazon S3 bucket.

" - }, - "OutputSourceType":{ - "shape":"OutputSourceType", - "documentation":"

The type of source where the association execution details are stored, for example, Amazon S3.

" - } - }, - "documentation":"

Information about the source where the association execution details are stored.

" - }, - "OutputSourceId":{ - "type":"string", - "max":36, - "min":36 - }, - "OutputSourceType":{"type":"string"}, - "OwnerInformation":{ - "type":"string", - "max":128, - "min":1, - "sensitive":true - }, - "PSParameterName":{ - "type":"string", - "max":2048, - "min":1 - }, - "PSParameterSelector":{ - "type":"string", - "max":128, - "min":0 - }, - "PSParameterValue":{ - "type":"string", - "max":4096, - "min":1 - }, - "PSParameterVersion":{"type":"long"}, - "Parameter":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The name of the parameter.

" - }, - "Type":{ - "shape":"ParameterType", - "documentation":"

The type of parameter. Valid values include the following: String, String list, Secure string.

" - }, - "Value":{ - "shape":"PSParameterValue", - "documentation":"

The parameter value.

" - }, - "Version":{ - "shape":"PSParameterVersion", - "documentation":"

The parameter version.

" - }, - "Selector":{ - "shape":"PSParameterSelector", - "documentation":"

Either the version number or the label used to retrieve the parameter value. Specify selectors by using one of the following formats:

parameter_name:version

parameter_name:label

" - }, - "SourceResult":{ - "shape":"String", - "documentation":"

Applies to parameters that reference information in other AWS services. SourceResult is the raw result or response from the source.

" - }, - "LastModifiedDate":{ - "shape":"DateTime", - "documentation":"

Date the parameter was last changed or updated and the parameter version was created.

" - }, - "ARN":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the parameter.

" - } - }, - "documentation":"

An Amazon EC2 Systems Manager parameter in Parameter Store.

" - }, - "ParameterAlreadyExists":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The parameter already exists. You can't create duplicate parameters.

", - "exception":true - }, - "ParameterDescription":{ - "type":"string", - "max":1024, - "min":0 - }, - "ParameterHistory":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The name of the parameter.

" - }, - "Type":{ - "shape":"ParameterType", - "documentation":"

The type of parameter used.

" - }, - "KeyId":{ - "shape":"ParameterKeyId", - "documentation":"

The ID of the query key used for this parameter.

" - }, - "LastModifiedDate":{ - "shape":"DateTime", - "documentation":"

Date the parameter was last changed or updated.

" - }, - "LastModifiedUser":{ - "shape":"String", - "documentation":"

Amazon Resource Name (ARN) of the AWS user who last changed the parameter.

" - }, - "Description":{ - "shape":"ParameterDescription", - "documentation":"

Information about the parameter.

" - }, - "Value":{ - "shape":"PSParameterValue", - "documentation":"

The parameter value.

" - }, - "AllowedPattern":{ - "shape":"AllowedPattern", - "documentation":"

Parameter names can include the following letters and symbols.

a-zA-Z0-9_.-

" - }, - "Version":{ - "shape":"PSParameterVersion", - "documentation":"

The parameter version.

" - }, - "Labels":{ - "shape":"ParameterLabelList", - "documentation":"

Labels assigned to the parameter version.

" - } - }, - "documentation":"

Information about parameter usage.

" - }, - "ParameterHistoryList":{ - "type":"list", - "member":{"shape":"ParameterHistory"} - }, - "ParameterKeyId":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([a-zA-Z0-9:/_-]+)$" - }, - "ParameterLabel":{ - "type":"string", - "max":100, - "min":1 - }, - "ParameterLabelList":{ - "type":"list", - "member":{"shape":"ParameterLabel"}, - "max":10, - "min":1 - }, - "ParameterLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

You have exceeded the number of parameters for this AWS account. Delete one or more parameters and try again.

", - "exception":true - }, - "ParameterList":{ - "type":"list", - "member":{"shape":"Parameter"} - }, - "ParameterMaxVersionLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The parameter exceeded the maximum number of allowed versions.

", - "exception":true - }, - "ParameterMetadata":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The parameter name.

" - }, - "Type":{ - "shape":"ParameterType", - "documentation":"

The type of parameter. Valid parameter types include the following: String, String list, Secure string.

" - }, - "KeyId":{ - "shape":"ParameterKeyId", - "documentation":"

The ID of the query key used for this parameter.

" - }, - "LastModifiedDate":{ - "shape":"DateTime", - "documentation":"

Date the parameter was last changed or updated.

" - }, - "LastModifiedUser":{ - "shape":"String", - "documentation":"

Amazon Resource Name (ARN) of the AWS user who last changed the parameter.

" - }, - "Description":{ - "shape":"ParameterDescription", - "documentation":"

Description of the parameter actions.

" - }, - "AllowedPattern":{ - "shape":"AllowedPattern", - "documentation":"

A parameter name can include only the following letters and symbols.

a-zA-Z0-9_.-

" - }, - "Version":{ - "shape":"PSParameterVersion", - "documentation":"

The parameter version.

" - } - }, - "documentation":"

Metada includes information like the ARN of the last user and the date/time the parameter was last used.

" - }, - "ParameterMetadataList":{ - "type":"list", - "member":{"shape":"ParameterMetadata"} - }, - "ParameterName":{"type":"string"}, - "ParameterNameList":{ - "type":"list", - "member":{"shape":"PSParameterName"}, - "max":10, - "min":1 - }, - "ParameterNotFound":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The parameter could not be found. Verify the name and try again.

", - "exception":true - }, - "ParameterPatternMismatchException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"String", - "documentation":"

The parameter name is not valid.

" - } - }, - "documentation":"

The parameter name is not valid.

", - "exception":true - }, - "ParameterStringFilter":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"ParameterStringFilterKey", - "documentation":"

The name of the filter.

" - }, - "Option":{ - "shape":"ParameterStringQueryOption", - "documentation":"

Valid options are Equals and BeginsWith. For Path filter, valid options are Recursive and OneLevel.

" - }, - "Values":{ - "shape":"ParameterStringFilterValueList", - "documentation":"

The value you want to search for.

" - } - }, - "documentation":"

One or more filters. Use a filter to return a more specific list of results.

The Name field can't be used with the GetParametersByPath API action.

" - }, - "ParameterStringFilterKey":{ - "type":"string", - "max":132, - "min":1, - "pattern":"tag:.+|Name|Type|KeyId|Path|Label" - }, - "ParameterStringFilterList":{ - "type":"list", - "member":{"shape":"ParameterStringFilter"} - }, - "ParameterStringFilterValue":{ - "type":"string", - "max":1024, - "min":1 - }, - "ParameterStringFilterValueList":{ - "type":"list", - "member":{"shape":"ParameterStringFilterValue"}, - "max":50, - "min":1 - }, - "ParameterStringQueryOption":{ - "type":"string", - "max":10, - "min":1 - }, - "ParameterType":{ - "type":"string", - "enum":[ - "String", - "StringList", - "SecureString" - ] - }, - "ParameterValue":{"type":"string"}, - "ParameterValueList":{ - "type":"list", - "member":{"shape":"ParameterValue"} - }, - "ParameterVersionLabelLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

A parameter version can have a maximum of ten labels.

", - "exception":true - }, - "ParameterVersionNotFound":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The specified parameter version was not found. Verify the parameter name and version, and try again.

", - "exception":true - }, - "Parameters":{ - "type":"map", - "key":{"shape":"ParameterName"}, - "value":{"shape":"ParameterValueList"} - }, - "ParametersFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"ParametersFilterKey", - "documentation":"

The name of the filter.

" - }, - "Values":{ - "shape":"ParametersFilterValueList", - "documentation":"

The filter values.

" - } - }, - "documentation":"

This data type is deprecated. Instead, use ParameterStringFilter.

" - }, - "ParametersFilterKey":{ - "type":"string", - "enum":[ - "Name", - "Type", - "KeyId" - ] - }, - "ParametersFilterList":{ - "type":"list", - "member":{"shape":"ParametersFilter"} - }, - "ParametersFilterValue":{ - "type":"string", - "max":1024, - "min":1 - }, - "ParametersFilterValueList":{ - "type":"list", - "member":{"shape":"ParametersFilterValue"}, - "max":50, - "min":1 - }, - "Patch":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"PatchId", - "documentation":"

The ID of the patch (this is different than the Microsoft Knowledge Base ID).

" - }, - "ReleaseDate":{ - "shape":"DateTime", - "documentation":"

The date the patch was released.

" - }, - "Title":{ - "shape":"PatchTitle", - "documentation":"

The title of the patch.

" - }, - "Description":{ - "shape":"PatchDescription", - "documentation":"

The description of the patch.

" - }, - "ContentUrl":{ - "shape":"PatchContentUrl", - "documentation":"

The URL where more information can be obtained about the patch.

" - }, - "Vendor":{ - "shape":"PatchVendor", - "documentation":"

The name of the vendor providing the patch.

" - }, - "ProductFamily":{ - "shape":"PatchProductFamily", - "documentation":"

The product family the patch is applicable for (for example, Windows).

" - }, - "Product":{ - "shape":"PatchProduct", - "documentation":"

The specific product the patch is applicable for (for example, WindowsServer2016).

" - }, - "Classification":{ - "shape":"PatchClassification", - "documentation":"

The classification of the patch (for example, SecurityUpdates, Updates, CriticalUpdates).

" - }, - "MsrcSeverity":{ - "shape":"PatchMsrcSeverity", - "documentation":"

The severity of the patch (for example Critical, Important, Moderate).

" - }, - "KbNumber":{ - "shape":"PatchKbNumber", - "documentation":"

The Microsoft Knowledge Base ID of the patch.

" - }, - "MsrcNumber":{ - "shape":"PatchMsrcNumber", - "documentation":"

The ID of the MSRC bulletin the patch is related to.

" - }, - "Language":{ - "shape":"PatchLanguage", - "documentation":"

The language of the patch if it's language-specific.

" - } - }, - "documentation":"

Represents metadata about a patch.

" - }, - "PatchBaselineIdentity":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline.

" - }, - "BaselineName":{ - "shape":"BaselineName", - "documentation":"

The name of the patch baseline.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

Defines the operating system the patch baseline applies to. The Default value is WINDOWS.

" - }, - "BaselineDescription":{ - "shape":"BaselineDescription", - "documentation":"

The description of the patch baseline.

" - }, - "DefaultBaseline":{ - "shape":"DefaultBaseline", - "documentation":"

Whether this is the default baseline. Note that Systems Manager supports creating multiple default patch baselines. For example, you can create a default patch baseline for each operating system.

" - } - }, - "documentation":"

Defines the basic information about a patch baseline.

" - }, - "PatchBaselineIdentityList":{ - "type":"list", - "member":{"shape":"PatchBaselineIdentity"} - }, - "PatchBaselineMaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "PatchClassification":{"type":"string"}, - "PatchComplianceData":{ - "type":"structure", - "required":[ - "Title", - "KBId", - "Classification", - "Severity", - "State", - "InstalledTime" - ], - "members":{ - "Title":{ - "shape":"PatchTitle", - "documentation":"

The title of the patch.

" - }, - "KBId":{ - "shape":"PatchKbNumber", - "documentation":"

The operating system-specific ID of the patch.

" - }, - "Classification":{ - "shape":"PatchClassification", - "documentation":"

The classification of the patch (for example, SecurityUpdates, Updates, CriticalUpdates).

" - }, - "Severity":{ - "shape":"PatchSeverity", - "documentation":"

The severity of the patch (for example, Critical, Important, Moderate).

" - }, - "State":{ - "shape":"PatchComplianceDataState", - "documentation":"

The state of the patch on the instance (INSTALLED, INSTALLED_OTHER, MISSING, NOT_APPLICABLE or FAILED).

" - }, - "InstalledTime":{ - "shape":"DateTime", - "documentation":"

The date/time the patch was installed on the instance. Note that not all operating systems provide this level of information.

" - } - }, - "documentation":"

Information about the state of a patch on a particular instance as it relates to the patch baseline used to patch the instance.

" - }, - "PatchComplianceDataList":{ - "type":"list", - "member":{"shape":"PatchComplianceData"} - }, - "PatchComplianceDataState":{ - "type":"string", - "enum":[ - "INSTALLED", - "INSTALLED_OTHER", - "MISSING", - "NOT_APPLICABLE", - "FAILED" - ] - }, - "PatchComplianceLevel":{ - "type":"string", - "enum":[ - "CRITICAL", - "HIGH", - "MEDIUM", - "LOW", - "INFORMATIONAL", - "UNSPECIFIED" - ] - }, - "PatchComplianceMaxResults":{ - "type":"integer", - "max":100, - "min":10 - }, - "PatchContentUrl":{"type":"string"}, - "PatchDeploymentStatus":{ - "type":"string", - "enum":[ - "APPROVED", - "PENDING_APPROVAL", - "EXPLICIT_APPROVED", - "EXPLICIT_REJECTED" - ] - }, - "PatchDescription":{"type":"string"}, - "PatchFailedCount":{"type":"integer"}, - "PatchFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"PatchFilterKey", - "documentation":"

The key for the filter.

See PatchFilter for lists of valid keys for each operating system type.

" - }, - "Values":{ - "shape":"PatchFilterValueList", - "documentation":"

The value for the filter key.

See PatchFilter for lists of valid values for each key based on operating system type.

" - } - }, - "documentation":"

Defines a patch filter.

A patch filter consists of key/value pairs, but not all keys are valid for all operating system types. For example, the key PRODUCT is valid for all supported operating system types. The key MSRC_SEVERITY, however, is valid only for Windows operating systems, and the key SECTION is valid only for Ubuntu operating systems.

Refer to the following sections for information about which keys may be used with each major operating system, and which values are valid for each key.

Windows Operating Systems

The supported keys for Windows operating systems are PRODUCT, CLASSIFICATION, and MSRC_SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • Windows7

  • Windows8

  • Windows8.1

  • Windows8Embedded

  • Windows10

  • Windows10LTSB

  • WindowsServer2008

  • WindowsServer2008R2

  • WindowsServer2012

  • WindowsServer2012R2

  • WindowsServer2016

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • CriticalUpdates

  • DefinitionUpdates

  • Drivers

  • FeaturePacks

  • SecurityUpdates

  • ServicePacks

  • Tools

  • UpdateRollups

  • Updates

  • Upgrades

Supported key: MSRC_SEVERITY

Supported values:

  • Critical

  • Important

  • Moderate

  • Low

  • Unspecified

Ubuntu Operating Systems

The supported keys for Ubuntu operating systems are PRODUCT, PRIORITY, and SECTION. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • Ubuntu14.04

  • Ubuntu16.04

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: PRIORITY

Supported values:

  • Required

  • Important

  • Standard

  • Optional

  • Extra

Supported key: SECTION

Only the length of the key value is validated. Minimum length is 1. Maximum length is 64.

Amazon Linux Operating Systems

The supported keys for Amazon Linux operating systems are PRODUCT, CLASSIFICATION, and SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • AmazonLinux2012.03

  • AmazonLinux2012.09

  • AmazonLinux2013.03

  • AmazonLinux2013.09

  • AmazonLinux2014.03

  • AmazonLinux2014.09

  • AmazonLinux2015.03

  • AmazonLinux2015.09

  • AmazonLinux2016.03

  • AmazonLinux2016.09

  • AmazonLinux2017.03

  • AmazonLinux2017.09

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • Security

  • Bugfix

  • Enhancement

  • Recommended

  • Newpackage

Supported key: SEVERITY

Supported values:

  • Critical

  • Important

  • Medium

  • Low

Amazon Linux 2 Operating Systems

The supported keys for Amazon Linux 2 operating systems are PRODUCT, CLASSIFICATION, and SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • AmazonLinux2

  • AmazonLinux2.0

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • Security

  • Bugfix

  • Enhancement

  • Recommended

  • Newpackage

Supported key: SEVERITY

Supported values:

  • Critical

  • Important

  • Medium

  • Low

RedHat Enterprise Linux (RHEL) Operating Systems

The supported keys for RedHat Enterprise Linux operating systems are PRODUCT, CLASSIFICATION, and SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • RedhatEnterpriseLinux6.5

  • RedhatEnterpriseLinux6.6

  • RedhatEnterpriseLinux6.7

  • RedhatEnterpriseLinux6.8

  • RedhatEnterpriseLinux6.9

  • RedhatEnterpriseLinux7.0

  • RedhatEnterpriseLinux7.1

  • RedhatEnterpriseLinux7.2

  • RedhatEnterpriseLinux7.3

  • RedhatEnterpriseLinux7.4

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • Security

  • Bugfix

  • Enhancement

  • Recommended

  • Newpackage

Supported key: SEVERITY

Supported values:

  • Critical

  • Important

  • Medium

  • Low

SUSE Linux Enterprise Server (SLES) Operating Systems

The supported keys for SLES operating systems are PRODUCT, CLASSIFICATION, and SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • Suse12.0

  • Suse12.1

  • Suse12.2

  • Suse12.3

  • Suse12.4

  • Suse12.5

  • Suse12.6

  • Suse12.7

  • Suse12.8

  • Suse12.9

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • Security

  • Recommended

  • Optional

  • Feature

  • Document

  • Yast

Supported key: SEVERITY

Supported values:

  • Critical

  • Important

  • Moderate

  • Low

CentOS Operating Systems

The supported keys for CentOS operating systems are PRODUCT, CLASSIFICATION, and SEVERITY. See the following lists for valid values for each of these keys.

Supported key: PRODUCT

Supported values:

  • CentOS6.5

  • CentOS6.6

  • CentOS6.7

  • CentOS6.8

  • CentOS6.9

  • CentOS7.0

  • CentOS7.1

  • CentOS7.2

  • CentOS7.3

  • CentOS7.4

  • *

    Use a wildcard character (*) to target all supported operating system versions.

Supported key: CLASSIFICATION

Supported values:

  • Security

  • Bugfix

  • Enhancement

  • Recommended

  • Newpackage

Supported key: SEVERITY

Supported values:

  • Critical

  • Important

  • Medium

  • Low

" - }, - "PatchFilterGroup":{ - "type":"structure", - "required":["PatchFilters"], - "members":{ - "PatchFilters":{ - "shape":"PatchFilterList", - "documentation":"

The set of patch filters that make up the group.

" - } - }, - "documentation":"

A set of patch filters, typically used for approval rules.

" - }, - "PatchFilterKey":{ - "type":"string", - "enum":[ - "PRODUCT", - "CLASSIFICATION", - "MSRC_SEVERITY", - "PATCH_ID", - "SECTION", - "PRIORITY", - "SEVERITY" - ] - }, - "PatchFilterList":{ - "type":"list", - "member":{"shape":"PatchFilter"}, - "max":4, - "min":0 - }, - "PatchFilterValue":{ - "type":"string", - "max":64, - "min":1 - }, - "PatchFilterValueList":{ - "type":"list", - "member":{"shape":"PatchFilterValue"}, - "max":20, - "min":1 - }, - "PatchGroup":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "PatchGroupList":{ - "type":"list", - "member":{"shape":"PatchGroup"} - }, - "PatchGroupPatchBaselineMapping":{ - "type":"structure", - "members":{ - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group registered with the patch baseline.

" - }, - "BaselineIdentity":{ - "shape":"PatchBaselineIdentity", - "documentation":"

The patch baseline the patch group is registered with.

" - } - }, - "documentation":"

The mapping between a patch group and the patch baseline the patch group is registered with.

" - }, - "PatchGroupPatchBaselineMappingList":{ - "type":"list", - "member":{"shape":"PatchGroupPatchBaselineMapping"} - }, - "PatchId":{ - "type":"string", - "max":100, - "min":1 - }, - "PatchIdList":{ - "type":"list", - "member":{"shape":"PatchId"}, - "max":50, - "min":0 - }, - "PatchInstalledCount":{"type":"integer"}, - "PatchInstalledOtherCount":{"type":"integer"}, - "PatchKbNumber":{"type":"string"}, - "PatchLanguage":{"type":"string"}, - "PatchList":{ - "type":"list", - "member":{"shape":"Patch"} - }, - "PatchMissingCount":{"type":"integer"}, - "PatchMsrcNumber":{"type":"string"}, - "PatchMsrcSeverity":{"type":"string"}, - "PatchNotApplicableCount":{"type":"integer"}, - "PatchOperationType":{ - "type":"string", - "enum":[ - "Scan", - "Install" - ] - }, - "PatchOrchestratorFilter":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"PatchOrchestratorFilterKey", - "documentation":"

The key for the filter.

" - }, - "Values":{ - "shape":"PatchOrchestratorFilterValues", - "documentation":"

The value for the filter.

" - } - }, - "documentation":"

Defines a filter used in Patch Manager APIs.

" - }, - "PatchOrchestratorFilterKey":{ - "type":"string", - "max":128, - "min":1 - }, - "PatchOrchestratorFilterList":{ - "type":"list", - "member":{"shape":"PatchOrchestratorFilter"}, - "max":5, - "min":0 - }, - "PatchOrchestratorFilterValue":{ - "type":"string", - "max":256, - "min":1 - }, - "PatchOrchestratorFilterValues":{ - "type":"list", - "member":{"shape":"PatchOrchestratorFilterValue"} - }, - "PatchProduct":{"type":"string"}, - "PatchProductFamily":{"type":"string"}, - "PatchRule":{ - "type":"structure", - "required":[ - "PatchFilterGroup", - "ApproveAfterDays" - ], - "members":{ - "PatchFilterGroup":{ - "shape":"PatchFilterGroup", - "documentation":"

The patch filter group that defines the criteria for the rule.

" - }, - "ComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

A compliance severity level for all approved patches in a patch baseline. Valid compliance severity levels include the following: Unspecified, Critical, High, Medium, Low, and Informational.

" - }, - "ApproveAfterDays":{ - "shape":"ApproveAfterDays", - "documentation":"

The number of days after the release date of each patch matched by the rule that the patch is marked as approved in the patch baseline. For example, a value of 7 means that patches are approved seven days after they are released.

", - "box":true - }, - "EnableNonSecurity":{ - "shape":"Boolean", - "documentation":"

For instances identified by the approval rule filters, enables a patch baseline to apply non-security updates available in the specified repository. The default value is 'false'. Applies to Linux instances only.

", - "box":true - } - }, - "documentation":"

Defines an approval rule for a patch baseline.

" - }, - "PatchRuleGroup":{ - "type":"structure", - "required":["PatchRules"], - "members":{ - "PatchRules":{ - "shape":"PatchRuleList", - "documentation":"

The rules that make up the rule group.

" - } - }, - "documentation":"

A set of rules defining the approval rules for a patch baseline.

" - }, - "PatchRuleList":{ - "type":"list", - "member":{"shape":"PatchRule"}, - "max":10, - "min":0 - }, - "PatchSeverity":{"type":"string"}, - "PatchSource":{ - "type":"structure", - "required":[ - "Name", - "Products", - "Configuration" - ], - "members":{ - "Name":{ - "shape":"PatchSourceName", - "documentation":"

The name specified to identify the patch source.

" - }, - "Products":{ - "shape":"PatchSourceProductList", - "documentation":"

The specific operating system versions a patch repository applies to, such as \"Ubuntu16.04\", \"AmazonLinux2016.09\", \"RedhatEnterpriseLinux7.2\" or \"Suse12.7\". For lists of supported product values, see PatchFilter.

" - }, - "Configuration":{ - "shape":"PatchSourceConfiguration", - "documentation":"

The value of the yum repo configuration. For example:

cachedir=/var/cache/yum/$basesearch

$releasever

keepcache=0

debuglevel=2

" - } - }, - "documentation":"

Information about the patches to use to update the instances, including target operating systems and source repository. Applies to Linux instances only.

" - }, - "PatchSourceConfiguration":{ - "type":"string", - "max":512, - "min":1, - "sensitive":true - }, - "PatchSourceList":{ - "type":"list", - "member":{"shape":"PatchSource"}, - "max":20, - "min":0 - }, - "PatchSourceName":{ - "type":"string", - "pattern":"^[a-zA-Z0-9_\\-.]{3,50}$" - }, - "PatchSourceProduct":{ - "type":"string", - "max":128, - "min":1 - }, - "PatchSourceProductList":{ - "type":"list", - "member":{"shape":"PatchSourceProduct"}, - "max":20, - "min":1 - }, - "PatchStatus":{ - "type":"structure", - "members":{ - "DeploymentStatus":{ - "shape":"PatchDeploymentStatus", - "documentation":"

The approval status of a patch (APPROVED, PENDING_APPROVAL, EXPLICIT_APPROVED, EXPLICIT_REJECTED).

" - }, - "ComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

The compliance severity level for a patch.

" - }, - "ApprovalDate":{ - "shape":"DateTime", - "documentation":"

The date the patch was approved (or will be approved if the status is PENDING_APPROVAL).

" - } - }, - "documentation":"

Information about the approval status of a patch.

" - }, - "PatchTitle":{"type":"string"}, - "PatchVendor":{"type":"string"}, - "PingStatus":{ - "type":"string", - "enum":[ - "Online", - "ConnectionLost", - "Inactive" - ] - }, - "PlatformType":{ - "type":"string", - "enum":[ - "Windows", - "Linux" - ] - }, - "PlatformTypeList":{ - "type":"list", - "member":{"shape":"PlatformType"} - }, - "Product":{"type":"string"}, - "PutComplianceItemsRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "ResourceType", - "ComplianceType", - "ExecutionSummary", - "Items" - ], - "members":{ - "ResourceId":{ - "shape":"ComplianceResourceId", - "documentation":"

Specify an ID for this resource. For a managed instance, this is the instance ID.

" - }, - "ResourceType":{ - "shape":"ComplianceResourceType", - "documentation":"

Specify the type of resource. ManagedInstance is currently the only supported resource type.

" - }, - "ComplianceType":{ - "shape":"ComplianceTypeName", - "documentation":"

Specify the compliance type. For example, specify Association (for a State Manager association), Patch, or Custom:string.

" - }, - "ExecutionSummary":{ - "shape":"ComplianceExecutionSummary", - "documentation":"

A summary of the call execution that includes an execution ID, the type of execution (for example, Command), and the date/time of the execution using a datetime object that is saved in the following format: yyyy-MM-dd'T'HH:mm:ss'Z'.

" - }, - "Items":{ - "shape":"ComplianceItemEntryList", - "documentation":"

Information about the compliance as defined by the resource type. For example, for a patch compliance type, Items includes information about the PatchSeverity, Classification, etc.

" - }, - "ItemContentHash":{ - "shape":"ComplianceItemContentHash", - "documentation":"

MD5 or SHA-256 content hash. The content hash is used to determine if existing information should be overwritten or ignored. If the content hashes match, the request to put compliance information is ignored.

" - } - } - }, - "PutComplianceItemsResult":{ - "type":"structure", - "members":{ - } - }, - "PutInventoryMessage":{"type":"string"}, - "PutInventoryRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "Items" - ], - "members":{ - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

One or more instance IDs where you want to add or update inventory items.

" - }, - "Items":{ - "shape":"InventoryItemList", - "documentation":"

The inventory items that you want to add or update on instances.

" - } - } - }, - "PutInventoryResult":{ - "type":"structure", - "members":{ - "Message":{ - "shape":"PutInventoryMessage", - "documentation":"

Information about the request.

" - } - } - }, - "PutParameterRequest":{ - "type":"structure", - "required":[ - "Name", - "Value", - "Type" - ], - "members":{ - "Name":{ - "shape":"PSParameterName", - "documentation":"

The fully qualified name of the parameter that you want to add to the system. The fully qualified name includes the complete hierarchy of the parameter path and name. For example: /Dev/DBServer/MySQL/db-string13

Naming Constraints:

  • Parameter names are case sensitive.

  • A parameter name must be unique within an AWS Region

  • A parameter name can't be prefixed with \"aws\" or \"ssm\" (case-insensitive).

  • Parameter names can include only the following symbols and letters: a-zA-Z0-9_.-/

  • A parameter name can't include spaces.

  • Parameter hierarchies are limited to a maximum depth of fifteen levels.

For additional information about valid values for parameter names, see Requirements and Constraints for Parameter Names in the AWS Systems Manager User Guide.

The maximum length constraint listed below includes capacity for additional system attributes that are not part of the name. The maximum length for the fully qualified parameter name is 1011 characters.

" - }, - "Description":{ - "shape":"ParameterDescription", - "documentation":"

Information about the parameter that you want to add to the system. Optional but recommended.

Do not enter personally identifiable information in this field.

" - }, - "Value":{ - "shape":"PSParameterValue", - "documentation":"

The parameter value that you want to add to the system.

" - }, - "Type":{ - "shape":"ParameterType", - "documentation":"

The type of parameter that you want to add to the system.

Items in a StringList must be separated by a comma (,). You can't use other punctuation or special character to escape items in the list. If you have a parameter value that requires a comma, then use the String data type.

SecureString is not currently supported for AWS CloudFormation templates or in the China Regions.

" - }, - "KeyId":{ - "shape":"ParameterKeyId", - "documentation":"

The KMS Key ID that you want to use to encrypt a parameter. Either the default AWS Key Management Service (AWS KMS) key automatically assigned to your AWS account or a custom key. Required for parameters that use the SecureString data type.

If you don't specify a key ID, the system uses the default key associated with your AWS account.

  • To use your default AWS KMS key, choose the SecureString data type, and do not specify the Key ID when you create the parameter. The system automatically populates Key ID with your default KMS key.

  • To use a custom KMS key, choose the SecureString data type with the Key ID parameter.

" - }, - "Overwrite":{ - "shape":"Boolean", - "documentation":"

Overwrite an existing parameter. If not specified, will default to \"false\".

", - "box":true - }, - "AllowedPattern":{ - "shape":"AllowedPattern", - "documentation":"

A regular expression used to validate the parameter value. For example, for String types with values restricted to numbers, you can specify the following: AllowedPattern=^\\d+$

" - } - } - }, - "PutParameterResult":{ - "type":"structure", - "members":{ - "Version":{ - "shape":"PSParameterVersion", - "documentation":"

The new version number of a parameter. If you edit a parameter value, Parameter Store automatically creates a new version and assigns this new version a unique ID. You can reference a parameter version ID in API actions or in Systems Manager documents (SSM documents). By default, if you don't specify a specific version, the system returns the latest parameter value when a parameter is called.

" - } - } - }, - "RegisterDefaultPatchBaselineRequest":{ - "type":"structure", - "required":["BaselineId"], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline that should be the default patch baseline.

" - } - } - }, - "RegisterDefaultPatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the default patch baseline.

" - } - } - }, - "RegisterPatchBaselineForPatchGroupRequest":{ - "type":"structure", - "required":[ - "BaselineId", - "PatchGroup" - ], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to register the patch group with.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group that should be registered with the patch baseline.

" - } - } - }, - "RegisterPatchBaselineForPatchGroupResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline the patch group was registered with.

" - }, - "PatchGroup":{ - "shape":"PatchGroup", - "documentation":"

The name of the patch group registered with the patch baseline.

" - } - } - }, - "RegisterTargetWithMaintenanceWindowRequest":{ - "type":"structure", - "required":[ - "WindowId", - "ResourceType", - "Targets" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the target should be registered with.

" - }, - "ResourceType":{ - "shape":"MaintenanceWindowResourceType", - "documentation":"

The type of target being registered with the Maintenance Window.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or tags).

Specify instances using the following format:

Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>

Specify tags using either of the following formats:

Key=tag:<tag-key>,Values=<tag-value-1>,<tag-value-2>

Key=tag-key,Values=<tag-key-1>,<tag-key-2>

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

User-provided value that will be included in any CloudWatch events raised while running tasks for these targets in this Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

An optional name for the target.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description for the target.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

User-provided idempotency token.

", - "idempotencyToken":true - } - } - }, - "RegisterTargetWithMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The ID of the target definition in this Maintenance Window.

" - } - } - }, - "RegisterTaskWithMaintenanceWindowRequest":{ - "type":"structure", - "required":[ - "WindowId", - "Targets", - "TaskArn", - "TaskType", - "MaxConcurrency", - "MaxErrors" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window the task should be added to.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or Maintenance Window targets).

Specify instances using the following format:

Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>

Specify Maintenance Window targets using the following format:

Key=<WindowTargetIds>,Values=<window-target-id-1>,<window-target-id-2>

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The ARN of the task to execute

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The role to assume when running the Maintenance Window task.

If you do not specify a service role ARN, Systems Manager will use your account's service-linked role for Systems Manager by default. If no service-linked role for Systems Manager exists in your account, it will be created when you run RegisterTaskWithMaintenanceWindow without specifying a service role ARN.

For more information, see Service-Linked Role Permissions for Systems Manager and Should I Use a Service-Linked Role or a Custom Service Role to Run Maintenance Window Tasks? in the AWS Systems Manager User Guide.

" - }, - "TaskType":{ - "shape":"MaintenanceWindowTaskType", - "documentation":"

The type of task being registered.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParameters", - "documentation":"

The parameters that should be passed to the task when it is executed.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "TaskInvocationParameters":{ - "shape":"MaintenanceWindowTaskInvocationParameters", - "documentation":"

The parameters that the task should use during execution. Populate only the fields that match the task type. All other fields should be empty.

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The priority of the task in the Maintenance Window, the lower the number the higher the priority. Tasks in a Maintenance Window are scheduled in priority order with tasks that have the same priority scheduled in parallel.

", - "box":true - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The maximum number of targets this task can be run for in parallel.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The maximum number of errors allowed before this task stops being scheduled.

" - }, - "LoggingInfo":{ - "shape":"LoggingInfo", - "documentation":"

A structure containing information about an Amazon S3 bucket to write instance-level logs to.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

An optional name for the task.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description for the task.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

User-provided idempotency token.

", - "idempotencyToken":true - } - } - }, - "RegisterTaskWithMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The id of the task in the Maintenance Window.

" - } - } - }, - "RegistrationLimit":{ - "type":"integer", - "max":1000, - "min":1 - }, - "RegistrationsCount":{ - "type":"integer", - "max":1000, - "min":1 - }, - "RemainingCount":{"type":"integer"}, - "RemoveTagsFromResourceRequest":{ - "type":"structure", - "required":[ - "ResourceType", - "ResourceId", - "TagKeys" - ], - "members":{ - "ResourceType":{ - "shape":"ResourceTypeForTagging", - "documentation":"

The type of resource of which you want to remove a tag.

The ManagedInstance type for this API action is only for on-premises managed instances. You must specify the the name of the managed instance in the following format: mi-ID_number. For example, mi-1a2b3c4d5e6f.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource ID for which you want to remove tags. Use the ID of the resource. Here are some examples:

ManagedInstance: mi-012345abcde

MaintenanceWindow: mw-012345abcde

PatchBaseline: pb-012345abcde

For the Document and Parameter values, use the name of the resource.

The ManagedInstance type for this API action is only for on-premises managed instances. You must specify the the name of the managed instance in the following format: mi-ID_number. For example, mi-1a2b3c4d5e6f.

" - }, - "TagKeys":{ - "shape":"KeyList", - "documentation":"

Tag keys that you want to remove from the specified resource.

" - } - } - }, - "RemoveTagsFromResourceResult":{ - "type":"structure", - "members":{ - } - }, - "ResolvedTargets":{ - "type":"structure", - "members":{ - "ParameterValues":{ - "shape":"TargetParameterList", - "documentation":"

A list of parameter values sent to targets that resolved during the Automation execution.

" - }, - "Truncated":{ - "shape":"Boolean", - "documentation":"

A boolean value indicating whether the resolved target list is truncated.

" - } - }, - "documentation":"

Information about targets that resolved during the Automation execution.

" - }, - "ResourceComplianceSummaryItem":{ - "type":"structure", - "members":{ - "ComplianceType":{ - "shape":"ComplianceTypeName", - "documentation":"

The compliance type.

" - }, - "ResourceType":{ - "shape":"ComplianceResourceType", - "documentation":"

The resource type.

" - }, - "ResourceId":{ - "shape":"ComplianceResourceId", - "documentation":"

The resource ID.

" - }, - "Status":{ - "shape":"ComplianceStatus", - "documentation":"

The compliance status for the resource.

" - }, - "OverallSeverity":{ - "shape":"ComplianceSeverity", - "documentation":"

The highest severity item found for the resource. The resource is compliant for this item.

" - }, - "ExecutionSummary":{ - "shape":"ComplianceExecutionSummary", - "documentation":"

Information about the execution.

" - }, - "CompliantSummary":{ - "shape":"CompliantSummary", - "documentation":"

A list of items that are compliant for the resource.

" - }, - "NonCompliantSummary":{ - "shape":"NonCompliantSummary", - "documentation":"

A list of items that aren't compliant for the resource.

" - } - }, - "documentation":"

Compliance summary information for a specific resource.

" - }, - "ResourceComplianceSummaryItemList":{ - "type":"list", - "member":{"shape":"ResourceComplianceSummaryItem"} - }, - "ResourceCount":{"type":"integer"}, - "ResourceCountByStatus":{"type":"string"}, - "ResourceDataSyncAWSKMSKeyARN":{ - "type":"string", - "max":512, - "min":1, - "pattern":"arn:.*" - }, - "ResourceDataSyncAlreadyExistsException":{ - "type":"structure", - "members":{ - "SyncName":{"shape":"ResourceDataSyncName"} - }, - "documentation":"

A sync configuration with the same name already exists.

", - "exception":true - }, - "ResourceDataSyncCountExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You have exceeded the allowed maximum sync configurations.

", - "exception":true - }, - "ResourceDataSyncCreatedTime":{"type":"timestamp"}, - "ResourceDataSyncInvalidConfigurationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The specified sync configuration is invalid.

", - "exception":true - }, - "ResourceDataSyncItem":{ - "type":"structure", - "members":{ - "SyncName":{ - "shape":"ResourceDataSyncName", - "documentation":"

The name of the Resource Data Sync.

" - }, - "S3Destination":{ - "shape":"ResourceDataSyncS3Destination", - "documentation":"

Configuration information for the target Amazon S3 bucket.

" - }, - "LastSyncTime":{ - "shape":"LastResourceDataSyncTime", - "documentation":"

The last time the configuration attempted to sync (UTC).

" - }, - "LastSuccessfulSyncTime":{ - "shape":"LastSuccessfulResourceDataSyncTime", - "documentation":"

The last time the sync operations returned a status of SUCCESSFUL (UTC).

" - }, - "LastStatus":{ - "shape":"LastResourceDataSyncStatus", - "documentation":"

The status reported by the last sync.

" - }, - "SyncCreatedTime":{ - "shape":"ResourceDataSyncCreatedTime", - "documentation":"

The date and time the configuration was created (UTC).

" - }, - "LastSyncStatusMessage":{ - "shape":"LastResourceDataSyncMessage", - "documentation":"

The status message details reported by the last sync.

" - } - }, - "documentation":"

Information about a Resource Data Sync configuration, including its current status and last successful sync.

" - }, - "ResourceDataSyncItemList":{ - "type":"list", - "member":{"shape":"ResourceDataSyncItem"} - }, - "ResourceDataSyncName":{ - "type":"string", - "max":64, - "min":1 - }, - "ResourceDataSyncNotFoundException":{ - "type":"structure", - "members":{ - "SyncName":{"shape":"ResourceDataSyncName"} - }, - "documentation":"

The specified sync name was not found.

", - "exception":true - }, - "ResourceDataSyncS3BucketName":{ - "type":"string", - "max":2048, - "min":1 - }, - "ResourceDataSyncS3Destination":{ - "type":"structure", - "required":[ - "BucketName", - "SyncFormat", - "Region" - ], - "members":{ - "BucketName":{ - "shape":"ResourceDataSyncS3BucketName", - "documentation":"

The name of the Amazon S3 bucket where the aggregated data is stored.

" - }, - "Prefix":{ - "shape":"ResourceDataSyncS3Prefix", - "documentation":"

An Amazon S3 prefix for the bucket.

" - }, - "SyncFormat":{ - "shape":"ResourceDataSyncS3Format", - "documentation":"

A supported sync format. The following format is currently supported: JsonSerDe

" - }, - "Region":{ - "shape":"ResourceDataSyncS3Region", - "documentation":"

The AWS Region with the Amazon S3 bucket targeted by the Resource Data Sync.

" - }, - "AWSKMSKeyARN":{ - "shape":"ResourceDataSyncAWSKMSKeyARN", - "documentation":"

The ARN of an encryption key for a destination in Amazon S3. Must belong to the same region as the destination Amazon S3 bucket.

" - } - }, - "documentation":"

Information about the target Amazon S3 bucket for the Resource Data Sync.

" - }, - "ResourceDataSyncS3Format":{ - "type":"string", - "enum":["JsonSerDe"] - }, - "ResourceDataSyncS3Prefix":{ - "type":"string", - "max":256, - "min":1 - }, - "ResourceDataSyncS3Region":{ - "type":"string", - "max":64, - "min":1 - }, - "ResourceId":{"type":"string"}, - "ResourceInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Error returned if an attempt is made to delete a patch baseline that is registered for a patch group.

", - "exception":true - }, - "ResourceLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Error returned when the caller has exceeded the default resource limits. For example, too many Maintenance Windows or Patch baselines have been created.

For information about resource limits in Systems Manager, see AWS Systems Manager Limits.

", - "exception":true - }, - "ResourceType":{ - "type":"string", - "enum":[ - "ManagedInstance", - "Document", - "EC2Instance" - ] - }, - "ResourceTypeForTagging":{ - "type":"string", - "enum":[ - "Document", - "ManagedInstance", - "MaintenanceWindow", - "Parameter", - "PatchBaseline" - ] - }, - "ResponseCode":{"type":"integer"}, - "ResultAttribute":{ - "type":"structure", - "required":["TypeName"], - "members":{ - "TypeName":{ - "shape":"InventoryItemTypeName", - "documentation":"

Name of the inventory item type. Valid value: AWS:InstanceInformation. Default Value: AWS:InstanceInformation.

" - } - }, - "documentation":"

The inventory item result attribute.

" - }, - "ResultAttributeList":{ - "type":"list", - "member":{"shape":"ResultAttribute"}, - "max":1, - "min":1 - }, - "S3BucketName":{ - "type":"string", - "max":63, - "min":3 - }, - "S3KeyPrefix":{ - "type":"string", - "max":500 - }, - "S3OutputLocation":{ - "type":"structure", - "members":{ - "OutputS3Region":{ - "shape":"S3Region", - "documentation":"

(Deprecated) You can no longer specify this parameter. The system ignores it. Instead, Systems Manager automatically determines the Amazon S3 bucket region.

" - }, - "OutputS3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the Amazon S3 bucket.

" - }, - "OutputS3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The Amazon S3 bucket subfolder.

" - } - }, - "documentation":"

An Amazon S3 bucket where you want to store the results of this request.

" - }, - "S3OutputUrl":{ - "type":"structure", - "members":{ - "OutputUrl":{ - "shape":"Url", - "documentation":"

A URL for an Amazon S3 bucket where you want to store the results of this request.

" - } - }, - "documentation":"

A URL for the Amazon S3 bucket where you want to store the results of this request.

" - }, - "S3Region":{ - "type":"string", - "max":20, - "min":3 - }, - "ScheduleExpression":{ - "type":"string", - "max":256, - "min":1 - }, - "SendAutomationSignalRequest":{ - "type":"structure", - "required":[ - "AutomationExecutionId", - "SignalType" - ], - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The unique identifier for an existing Automation execution that you want to send the signal to.

" - }, - "SignalType":{ - "shape":"SignalType", - "documentation":"

The type of signal. Valid signal types include the following: Approve and Reject

" - }, - "Payload":{ - "shape":"AutomationParameterMap", - "documentation":"

The data sent with the signal. The data schema depends on the type of signal used in the request.

" - } - } - }, - "SendAutomationSignalResult":{ - "type":"structure", - "members":{ - } - }, - "SendCommandRequest":{ - "type":"structure", - "required":["DocumentName"], - "members":{ - "InstanceIds":{ - "shape":"InstanceIdList", - "documentation":"

The instance IDs where the command should execute. You can specify a maximum of 50 IDs. If you prefer not to list individual instance IDs, you can instead send commands to a fleet of instances using the Targets parameter, which accepts EC2 tags. For more information about how to use Targets, see Sending Commands to a Fleet in the AWS Systems Manager User Guide.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

(Optional) An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call. For more information about how to use Targets, see Sending Commands to a Fleet in the AWS Systems Manager User Guide.

" - }, - "DocumentName":{ - "shape":"DocumentARN", - "documentation":"

Required. The name of the Systems Manager document to execute. This can be a public document or a custom document.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The SSM document version to use in the request. You can specify $DEFAULT, $LATEST, or a specific version number. If you execute commands by using the AWS CLI, then you must escape the first two options by using a backslash. If you specify a version number, then you don't need to use the backslash. For example:

--document-version \"\\$DEFAULT\"

--document-version \"\\$LATEST\"

--document-version \"3\"

" - }, - "DocumentHash":{ - "shape":"DocumentHash", - "documentation":"

The Sha256 or Sha1 hash created by the system when the document was created.

Sha1 hashes have been deprecated.

" - }, - "DocumentHashType":{ - "shape":"DocumentHashType", - "documentation":"

Sha256 or Sha1.

Sha1 hashes have been deprecated.

" - }, - "TimeoutSeconds":{ - "shape":"TimeoutSeconds", - "documentation":"

If this time is reached and the command has not already started executing, it will not run.

", - "box":true - }, - "Comment":{ - "shape":"Comment", - "documentation":"

User-specified information about the command, such as a brief description of what the command should do.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The required and optional parameters specified in the document being executed.

" - }, - "OutputS3Region":{ - "shape":"S3Region", - "documentation":"

(Deprecated) You can no longer specify this parameter. The system ignores it. Instead, Systems Manager automatically determines the Amazon S3 bucket region.

" - }, - "OutputS3BucketName":{ - "shape":"S3BucketName", - "documentation":"

The name of the S3 bucket where command execution responses should be stored.

" - }, - "OutputS3KeyPrefix":{ - "shape":"S3KeyPrefix", - "documentation":"

The directory structure within the S3 bucket where the responses should be stored.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

(Optional) The maximum number of instances that are allowed to execute the command at the same time. You can specify a number such as 10 or a percentage such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see Using Concurrency Controls in the AWS Systems Manager User Guide.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The maximum number of errors allowed without the command failing. When the command fails one more time beyond the value of MaxErrors, the systems stops sending the command to additional targets. You can specify a number like 10 or a percentage like 10%. The default value is 0. For more information about how to use MaxErrors, see Using Error Controls in the AWS Systems Manager User Guide.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The IAM role that Systems Manager uses to send notifications.

" - }, - "NotificationConfig":{ - "shape":"NotificationConfig", - "documentation":"

Configurations for sending notifications.

" - }, - "CloudWatchOutputConfig":{ - "shape":"CloudWatchOutputConfig", - "documentation":"

Enables Systems Manager to send Run Command output to Amazon CloudWatch Logs.

" - } - } - }, - "SendCommandResult":{ - "type":"structure", - "members":{ - "Command":{ - "shape":"Command", - "documentation":"

The request as it was received by Systems Manager. Also provides the command ID which can be used future references to this request.

" - } - } - }, - "ServiceRole":{"type":"string"}, - "SeveritySummary":{ - "type":"structure", - "members":{ - "CriticalCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of critical. Critical severity is determined by the organization that published the compliance items.

" - }, - "HighCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of high. High severity is determined by the organization that published the compliance items.

" - }, - "MediumCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of medium. Medium severity is determined by the organization that published the compliance items.

" - }, - "LowCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of low. Low severity is determined by the organization that published the compliance items.

" - }, - "InformationalCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of informational. Informational severity is determined by the organization that published the compliance items.

" - }, - "UnspecifiedCount":{ - "shape":"ComplianceSummaryCount", - "documentation":"

The total number of resources or compliance items that have a severity level of unspecified. Unspecified severity is determined by the organization that published the compliance items.

" - } - }, - "documentation":"

The number of managed instances found for each patch severity level defined in the request filter.

" - }, - "SignalType":{ - "type":"string", - "enum":[ - "Approve", - "Reject", - "StartStep", - "StopStep", - "Resume" - ] - }, - "SnapshotDownloadUrl":{"type":"string"}, - "SnapshotId":{ - "type":"string", - "max":36, - "min":36, - "pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" - }, - "StandardErrorContent":{ - "type":"string", - "max":8000 - }, - "StandardOutputContent":{ - "type":"string", - "max":24000 - }, - "StartAssociationsOnceRequest":{ - "type":"structure", - "required":["AssociationIds"], - "members":{ - "AssociationIds":{ - "shape":"AssociationIdList", - "documentation":"

The association IDs that you want to execute immediately and only one time.

" - } - } - }, - "StartAssociationsOnceResult":{ - "type":"structure", - "members":{ - } - }, - "StartAutomationExecutionRequest":{ - "type":"structure", - "required":["DocumentName"], - "members":{ - "DocumentName":{ - "shape":"DocumentARN", - "documentation":"

The name of the Automation document to use for this execution.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of the Automation document to use for this execution.

", - "box":true - }, - "Parameters":{ - "shape":"AutomationParameterMap", - "documentation":"

A key-value map of execution parameters, which match the declared parameters in the Automation document.

" - }, - "ClientToken":{ - "shape":"IdempotencyToken", - "documentation":"

User-provided idempotency token. The token must be unique, is case insensitive, enforces the UUID format, and can't be reused.

" - }, - "Mode":{ - "shape":"ExecutionMode", - "documentation":"

The execution mode of the automation. Valid modes include the following: Auto and Interactive. The default mode is Auto.

" - }, - "TargetParameterName":{ - "shape":"AutomationParameterKey", - "documentation":"

The name of the parameter used as the target resource for the rate-controlled execution. Required if you specify Targets.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

A key-value mapping to target resources. Required if you specify TargetParameterName.

" - }, - "TargetMaps":{ - "shape":"TargetMaps", - "documentation":"

A key-value mapping of document parameters to target resources. Both Targets and TargetMaps cannot be specified together.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The maximum number of targets allowed to run this task in parallel. You can specify a number, such as 10, or a percentage, such as 10%. The default value is 10.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The number of errors that are allowed before the system stops running the automation on additional targets. You can specify either an absolute number of errors, for example 10, or a percentage of the target set, for example 10%. If you specify 3, for example, the system stops running the automation when the fourth error is received. If you specify 0, then the system stops running the automation on additional targets after the first error result is returned. If you run an automation on 50 resources and set max-errors to 10%, then the system stops running the automation on additional targets when the sixth error is received.

Executions that are already running an automation when max-errors is reached are allowed to complete, but some of these executions may fail as well. If you need to ensure that there won't be more than max-errors failed executions, set max-concurrency to 1 so the executions proceed one at a time.

" - } - } - }, - "StartAutomationExecutionResult":{ - "type":"structure", - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The unique ID of a newly scheduled automation execution.

" - } - } - }, - "StatusAdditionalInfo":{ - "type":"string", - "max":1024 - }, - "StatusDetails":{ - "type":"string", - "max":100, - "min":0 - }, - "StatusMessage":{ - "type":"string", - "max":1024, - "min":1 - }, - "StatusName":{"type":"string"}, - "StatusUnchanged":{ - "type":"structure", - "members":{ - }, - "documentation":"

The updated status is the same as the current status.

", - "exception":true - }, - "StepExecution":{ - "type":"structure", - "members":{ - "StepName":{ - "shape":"String", - "documentation":"

The name of this execution step.

" - }, - "Action":{ - "shape":"AutomationActionName", - "documentation":"

The action this step performs. The action determines the behavior of the step.

" - }, - "TimeoutSeconds":{ - "shape":"Long", - "documentation":"

The timeout seconds of the step.

", - "box":true - }, - "OnFailure":{ - "shape":"String", - "documentation":"

The action to take if the step fails. The default value is Abort.

" - }, - "MaxAttempts":{ - "shape":"Integer", - "documentation":"

The maximum number of tries to run the action of the step. The default value is 1.

", - "box":true - }, - "ExecutionStartTime":{ - "shape":"DateTime", - "documentation":"

If a step has begun execution, this contains the time the step started. If the step is in Pending status, this field is not populated.

" - }, - "ExecutionEndTime":{ - "shape":"DateTime", - "documentation":"

If a step has finished execution, this contains the time the execution ended. If the step has not yet concluded, this field is not populated.

" - }, - "StepStatus":{ - "shape":"AutomationExecutionStatus", - "documentation":"

The execution status for this step. Valid values include: Pending, InProgress, Success, Cancelled, Failed, and TimedOut.

" - }, - "ResponseCode":{ - "shape":"String", - "documentation":"

The response code returned by the execution of the step.

" - }, - "Inputs":{ - "shape":"NormalStringMap", - "documentation":"

Fully-resolved values passed into the step before execution.

" - }, - "Outputs":{ - "shape":"AutomationParameterMap", - "documentation":"

Returned values from the execution of the step.

" - }, - "Response":{ - "shape":"String", - "documentation":"

A message associated with the response code for an execution.

" - }, - "FailureMessage":{ - "shape":"String", - "documentation":"

If a step failed, this message explains why the execution failed.

" - }, - "FailureDetails":{ - "shape":"FailureDetails", - "documentation":"

Information about the Automation failure.

" - }, - "StepExecutionId":{ - "shape":"String", - "documentation":"

The unique ID of a step execution.

" - }, - "OverriddenParameters":{ - "shape":"AutomationParameterMap", - "documentation":"

A user-specified list of parameters to override when executing a step.

" - }, - "IsEnd":{ - "shape":"Boolean", - "documentation":"

The flag which can be used to end automation no matter whether the step succeeds or fails.

", - "box":true - }, - "NextStep":{ - "shape":"String", - "documentation":"

The next step after the step succeeds.

", - "box":true - }, - "IsCritical":{ - "shape":"Boolean", - "documentation":"

The flag which can be used to help decide whether the failure of current step leads to the Automation failure.

", - "box":true - }, - "ValidNextSteps":{ - "shape":"ValidNextStepList", - "documentation":"

Strategies used when step fails, we support Continue and Abort. Abort will fail the automation when the step fails. Continue will ignore the failure of current step and allow automation to execute the next step. With conditional branching, we add step:stepName to support the automation to go to another specific step.

" - } - }, - "documentation":"

Detailed information about an the execution state of an Automation step.

" - }, - "StepExecutionFilter":{ - "type":"structure", - "required":[ - "Key", - "Values" - ], - "members":{ - "Key":{ - "shape":"StepExecutionFilterKey", - "documentation":"

One or more keys to limit the results. Valid filter keys include the following: StepName, Action, StepExecutionId, StepExecutionStatus, StartTimeBefore, StartTimeAfter.

" - }, - "Values":{ - "shape":"StepExecutionFilterValueList", - "documentation":"

The values of the filter key.

" - } - }, - "documentation":"

A filter to limit the amount of step execution information returned by the call.

" - }, - "StepExecutionFilterKey":{ - "type":"string", - "enum":[ - "StartTimeBefore", - "StartTimeAfter", - "StepExecutionStatus", - "StepExecutionId", - "StepName", - "Action" - ] - }, - "StepExecutionFilterList":{ - "type":"list", - "member":{"shape":"StepExecutionFilter"}, - "max":6, - "min":1 - }, - "StepExecutionFilterValue":{ - "type":"string", - "max":150, - "min":1 - }, - "StepExecutionFilterValueList":{ - "type":"list", - "member":{"shape":"StepExecutionFilterValue"}, - "max":10, - "min":1 - }, - "StepExecutionList":{ - "type":"list", - "member":{"shape":"StepExecution"} - }, - "StopAutomationExecutionRequest":{ - "type":"structure", - "required":["AutomationExecutionId"], - "members":{ - "AutomationExecutionId":{ - "shape":"AutomationExecutionId", - "documentation":"

The execution ID of the Automation to stop.

" - }, - "Type":{ - "shape":"StopType", - "documentation":"

The stop request type. Valid types include the following: Cancel and Complete. The default type is Cancel.

" - } - } - }, - "StopAutomationExecutionResult":{ - "type":"structure", - "members":{ - } - }, - "StopType":{ - "type":"string", - "enum":[ - "Complete", - "Cancel" - ] - }, - "String":{"type":"string"}, - "StringDateTime":{ - "type":"string", - "pattern":"^([\\-]?\\d{4}(?!\\d{2}\\b))((-?)((0[1-9]|1[0-2])(\\3([12]\\d|0[1-9]|3[01]))?|W([0-4]\\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\\d|[12]\\d{2}|3([0-5]\\d|6[1-6])))([T\\s]((([01]\\d|2[0-3])((:?)[0-5]\\d)?|24\\:?00)([\\.,]\\d(?!:))?)?(\\17[0-5]\\d([\\.,]\\d)?)?([zZ]|([\\-])([01]\\d|2[0-3]):?([0-5]\\d)?)?)?)?$" - }, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "SubTypeCountLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The sub-type count exceeded the limit for the inventory type.

", - "exception":true - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The name of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Metadata that you assign to your AWS resources. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. In Systems Manager, you can apply tags to documents, managed instances, Maintenance Windows, Parameter Store parameters, and patch baselines.

" - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^(?!^(?i)aws:)(?=^[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*$).*$" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{ - "type":"string", - "max":256, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Target":{ - "type":"structure", - "members":{ - "Key":{ - "shape":"TargetKey", - "documentation":"

User-defined criteria for sending commands that target instances that meet the criteria. Key can be tag:<Amazon EC2 tag> or InstanceIds. For more information about how to send commands that target instances using Key,Value parameters, see Targeting Multiple Instances in the AWS Systems Manager User Guide.

" - }, - "Values":{ - "shape":"TargetValues", - "documentation":"

User-defined criteria that maps to Key. For example, if you specified tag:ServerRole, you could specify value:WebServer to execute a command on instances that include Amazon EC2 tags of ServerRole,WebServer. For more information about how to send commands that target instances using Key,Value parameters, see Sending Commands to a Fleet in the AWS Systems Manager User Guide.

" - } - }, - "documentation":"

An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.

" - }, - "TargetCount":{"type":"integer"}, - "TargetInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You specified the Safe option for the DeregisterTargetFromMaintenanceWindow operation, but the target is still referenced in a task.

", - "exception":true - }, - "TargetKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^[\\p{L}\\p{Z}\\p{N}_.:/=\\-@]*$" - }, - "TargetMap":{ - "type":"map", - "key":{"shape":"TargetMapKey"}, - "value":{"shape":"TargetMapValueList"}, - "max":20, - "min":1 - }, - "TargetMapKey":{ - "type":"string", - "max":50, - "min":1 - }, - "TargetMapValue":{ - "type":"string", - "max":50, - "min":1 - }, - "TargetMapValueList":{ - "type":"list", - "member":{"shape":"TargetMapValue"}, - "max":25, - "min":0 - }, - "TargetMaps":{ - "type":"list", - "member":{"shape":"TargetMap"}, - "max":300, - "min":0 - }, - "TargetParameterList":{ - "type":"list", - "member":{"shape":"ParameterValue"} - }, - "TargetType":{ - "type":"string", - "max":200, - "pattern":"^\\/[\\w\\.\\-\\:\\/]*$" - }, - "TargetValue":{"type":"string"}, - "TargetValues":{ - "type":"list", - "member":{"shape":"TargetValue"}, - "max":50, - "min":0 - }, - "Targets":{ - "type":"list", - "member":{"shape":"Target"}, - "max":5, - "min":0 - }, - "TimeoutSeconds":{ - "type":"integer", - "max":2592000, - "min":30 - }, - "TooManyTagsError":{ - "type":"structure", - "members":{ - }, - "documentation":"

The Targets parameter includes too many tags. Remove one or more tags and try the command again.

", - "exception":true - }, - "TooManyUpdates":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

There are concurrent updates for a resource that supports one update at a time.

", - "exception":true - }, - "TotalCount":{"type":"integer"}, - "TotalSizeLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The size of inventory data has exceeded the total size limit for the resource.

", - "exception":true - }, - "UnsupportedInventoryItemContextException":{ - "type":"structure", - "members":{ - "TypeName":{"shape":"InventoryItemTypeName"}, - "Message":{"shape":"String"} - }, - "documentation":"

The Context attribute that you specified for the InventoryItem is not allowed for this inventory type. You can only use the Context attribute with inventory types like AWS:ComplianceItem.

", - "exception":true - }, - "UnsupportedInventorySchemaVersionException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Inventory item type schema version has to match supported versions in the service. Check output of GetInventorySchema to see the available schema version for each type.

", - "exception":true - }, - "UnsupportedOperatingSystem":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The operating systems you specified is not supported, or the operation is not supported for the operating system. Valid operating systems include: Windows, AmazonLinux, RedhatEnterpriseLinux, and Ubuntu.

", - "exception":true - }, - "UnsupportedParameterType":{ - "type":"structure", - "members":{ - "message":{"shape":"String"} - }, - "documentation":"

The parameter type is not supported.

", - "exception":true - }, - "UnsupportedPlatformType":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The document does not support the platform type of the given instance ID(s). For example, you sent an document for a Windows instance to a Linux instance.

", - "exception":true - }, - "UpdateAssociationRequest":{ - "type":"structure", - "required":["AssociationId"], - "members":{ - "AssociationId":{ - "shape":"AssociationId", - "documentation":"

The ID of the association you want to update.

" - }, - "Parameters":{ - "shape":"Parameters", - "documentation":"

The parameters you want to update for the association. If you create a parameter using Parameter Store, you can reference the parameter using {{ssm:parameter-name}}

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The document version you want update for the association.

" - }, - "ScheduleExpression":{ - "shape":"ScheduleExpression", - "documentation":"

The cron expression used to schedule the association that you want to update.

" - }, - "OutputLocation":{ - "shape":"InstanceAssociationOutputLocation", - "documentation":"

An Amazon S3 bucket where you want to store the results of this request.

" - }, - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the association document.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets of the association.

" - }, - "AssociationName":{ - "shape":"AssociationName", - "documentation":"

The name of the association that you want to update.

" - }, - "AssociationVersion":{ - "shape":"AssociationVersion", - "documentation":"

This parameter is provided for concurrency control purposes. You must specify the latest association version in the service. If you want to ensure that this request succeeds, either specify $LATEST, or omit this parameter.

" - } - } - }, - "UpdateAssociationResult":{ - "type":"structure", - "members":{ - "AssociationDescription":{ - "shape":"AssociationDescription", - "documentation":"

The description of the association that was updated.

" - } - } - }, - "UpdateAssociationStatusRequest":{ - "type":"structure", - "required":[ - "Name", - "InstanceId", - "AssociationStatus" - ], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the Systems Manager document.

" - }, - "InstanceId":{ - "shape":"InstanceId", - "documentation":"

The ID of the instance.

" - }, - "AssociationStatus":{ - "shape":"AssociationStatus", - "documentation":"

The association status.

" - } - } - }, - "UpdateAssociationStatusResult":{ - "type":"structure", - "members":{ - "AssociationDescription":{ - "shape":"AssociationDescription", - "documentation":"

Information about the association.

" - } - } - }, - "UpdateDocumentDefaultVersionRequest":{ - "type":"structure", - "required":[ - "Name", - "DocumentVersion" - ], - "members":{ - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of a custom document that you want to set as the default version.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersionNumber", - "documentation":"

The version of a custom document that you want to set as the default version.

" - } - } - }, - "UpdateDocumentDefaultVersionResult":{ - "type":"structure", - "members":{ - "Description":{ - "shape":"DocumentDefaultVersionDescription", - "documentation":"

The description of a custom document that you want to set as the default version.

" - } - } - }, - "UpdateDocumentRequest":{ - "type":"structure", - "required":[ - "Content", - "Name" - ], - "members":{ - "Content":{ - "shape":"DocumentContent", - "documentation":"

The content in a document that you want to update.

" - }, - "Name":{ - "shape":"DocumentName", - "documentation":"

The name of the document that you want to update.

" - }, - "DocumentVersion":{ - "shape":"DocumentVersion", - "documentation":"

The version of the document that you want to update.

" - }, - "DocumentFormat":{ - "shape":"DocumentFormat", - "documentation":"

Specify the document format for the new document version. Systems Manager supports JSON and YAML documents. JSON is the default format.

" - }, - "TargetType":{ - "shape":"TargetType", - "documentation":"

Specify a new target type for the document.

" - } - } - }, - "UpdateDocumentResult":{ - "type":"structure", - "members":{ - "DocumentDescription":{ - "shape":"DocumentDescription", - "documentation":"

A description of the document that was updated.

" - } - } - }, - "UpdateMaintenanceWindowRequest":{ - "type":"structure", - "required":["WindowId"], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window to update.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The name of the Maintenance Window.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description for the update request.

" - }, - "Schedule":{ - "shape":"MaintenanceWindowSchedule", - "documentation":"

The schedule of the Maintenance Window in the form of a cron or rate expression.

" - }, - "Duration":{ - "shape":"MaintenanceWindowDurationHours", - "documentation":"

The duration of the Maintenance Window in hours.

", - "box":true - }, - "Cutoff":{ - "shape":"MaintenanceWindowCutoff", - "documentation":"

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

", - "box":true - }, - "AllowUnassociatedTargets":{ - "shape":"MaintenanceWindowAllowUnassociatedTargets", - "documentation":"

Whether targets must be registered with the Maintenance Window before tasks can be defined for those targets.

", - "box":true - }, - "Enabled":{ - "shape":"MaintenanceWindowEnabled", - "documentation":"

Whether the Maintenance Window is enabled.

", - "box":true - }, - "Replace":{ - "shape":"Boolean", - "documentation":"

If True, then all fields that are required by the CreateMaintenanceWindow action are also required for this API request. Optional fields that are not specified are set to null.

", - "box":true - } - } - }, - "UpdateMaintenanceWindowResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the created Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The name of the Maintenance Window.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description of the update.

" - }, - "Schedule":{ - "shape":"MaintenanceWindowSchedule", - "documentation":"

The schedule of the Maintenance Window in the form of a cron or rate expression.

" - }, - "Duration":{ - "shape":"MaintenanceWindowDurationHours", - "documentation":"

The duration of the Maintenance Window in hours.

" - }, - "Cutoff":{ - "shape":"MaintenanceWindowCutoff", - "documentation":"

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

" - }, - "AllowUnassociatedTargets":{ - "shape":"MaintenanceWindowAllowUnassociatedTargets", - "documentation":"

Whether targets must be registered with the Maintenance Window before tasks can be defined for those targets.

" - }, - "Enabled":{ - "shape":"MaintenanceWindowEnabled", - "documentation":"

Whether the Maintenance Window is enabled.

" - } - } - }, - "UpdateMaintenanceWindowTargetRequest":{ - "type":"structure", - "required":[ - "WindowId", - "WindowTargetId" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID with which to modify the target.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The target ID to modify.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets to add or replace.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

User-provided value that will be included in any CloudWatch events raised while running tasks for these targets in this Maintenance Window.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

A name for the update.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

An optional description for the update.

" - }, - "Replace":{ - "shape":"Boolean", - "documentation":"

If True, then all fields that are required by the RegisterTargetWithMaintenanceWindow action are also required for this API request. Optional fields that are not specified are set to null.

", - "box":true - } - } - }, - "UpdateMaintenanceWindowTargetResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID specified in the update request.

" - }, - "WindowTargetId":{ - "shape":"MaintenanceWindowTargetId", - "documentation":"

The target ID specified in the update request.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The updated targets.

" - }, - "OwnerInformation":{ - "shape":"OwnerInformation", - "documentation":"

The updated owner.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The updated name.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

The updated description.

" - } - } - }, - "UpdateMaintenanceWindowTaskRequest":{ - "type":"structure", - "required":[ - "WindowId", - "WindowTaskId" - ], - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The Maintenance Window ID that contains the task to modify.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The task ID to modify.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The targets (either instances or tags) to modify. Instances are specified using Key=instanceids,Values=instanceID_1,instanceID_2. Tags are specified using Key=tag_name,Values=tag_value.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The task ARN to modify.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The IAM service role ARN to modify. The system assumes this role during task execution.

If you do not specify a service role ARN, Systems Manager will use your account's service-linked role for Systems Manager by default. If no service-linked role for Systems Manager exists in your account, it will be created when you run RegisterTaskWithMaintenanceWindow without specifying a service role ARN.

For more information, see Service-Linked Role Permissions for Systems Manager and Should I Use a Service-Linked Role or a Custom Service Role to Run Maintenance Window Tasks? in the AWS Systems Manager User Guide.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParameters", - "documentation":"

The parameters to modify.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

The map has the following format:

Key: string, between 1 and 255 characters

Value: an array of strings, each string is between 1 and 255 characters

" - }, - "TaskInvocationParameters":{ - "shape":"MaintenanceWindowTaskInvocationParameters", - "documentation":"

The parameters that the task should use during execution. Populate only the fields that match the task type. All other fields should be empty.

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The new task priority to specify. The lower the number, the higher the priority. Tasks that have the same priority are scheduled in parallel.

", - "box":true - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The new MaxConcurrency value you want to specify. MaxConcurrency is the number of targets that are allowed to run this task in parallel.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The new MaxErrors value to specify. MaxErrors is the maximum number of errors that are allowed before the task stops being scheduled.

" - }, - "LoggingInfo":{ - "shape":"LoggingInfo", - "documentation":"

The new logging location in Amazon S3 to specify.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The new task name to specify.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

The new task description to specify.

" - }, - "Replace":{ - "shape":"Boolean", - "documentation":"

If True, then all fields that are required by the RegisterTaskWithMaintenanceWndow action are also required for this API request. Optional fields that are not specified are set to null.

", - "box":true - } - } - }, - "UpdateMaintenanceWindowTaskResult":{ - "type":"structure", - "members":{ - "WindowId":{ - "shape":"MaintenanceWindowId", - "documentation":"

The ID of the Maintenance Window that was updated.

" - }, - "WindowTaskId":{ - "shape":"MaintenanceWindowTaskId", - "documentation":"

The task ID of the Maintenance Window that was updated.

" - }, - "Targets":{ - "shape":"Targets", - "documentation":"

The updated target values.

" - }, - "TaskArn":{ - "shape":"MaintenanceWindowTaskArn", - "documentation":"

The updated task ARN value.

" - }, - "ServiceRoleArn":{ - "shape":"ServiceRole", - "documentation":"

The updated service role ARN value.

" - }, - "TaskParameters":{ - "shape":"MaintenanceWindowTaskParameters", - "documentation":"

The updated parameter values.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "TaskInvocationParameters":{ - "shape":"MaintenanceWindowTaskInvocationParameters", - "documentation":"

The updated parameter values.

" - }, - "Priority":{ - "shape":"MaintenanceWindowTaskPriority", - "documentation":"

The updated priority value.

" - }, - "MaxConcurrency":{ - "shape":"MaxConcurrency", - "documentation":"

The updated MaxConcurrency value.

" - }, - "MaxErrors":{ - "shape":"MaxErrors", - "documentation":"

The updated MaxErrors value.

" - }, - "LoggingInfo":{ - "shape":"LoggingInfo", - "documentation":"

The updated logging information in Amazon S3.

LoggingInfo has been deprecated. To specify an S3 bucket to contain logs, instead use the OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported Maintenance Window task types, see MaintenanceWindowTaskInvocationParameters.

" - }, - "Name":{ - "shape":"MaintenanceWindowName", - "documentation":"

The updated task name.

" - }, - "Description":{ - "shape":"MaintenanceWindowDescription", - "documentation":"

The updated task description.

" - } - } - }, - "UpdateManagedInstanceRoleRequest":{ - "type":"structure", - "required":[ - "InstanceId", - "IamRole" - ], - "members":{ - "InstanceId":{ - "shape":"ManagedInstanceId", - "documentation":"

The ID of the managed instance where you want to update the role.

" - }, - "IamRole":{ - "shape":"IamRole", - "documentation":"

The IAM role you want to assign or change.

" - } - } - }, - "UpdateManagedInstanceRoleResult":{ - "type":"structure", - "members":{ - } - }, - "UpdatePatchBaselineRequest":{ - "type":"structure", - "required":["BaselineId"], - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the patch baseline to update.

" - }, - "Name":{ - "shape":"BaselineName", - "documentation":"

The name of the patch baseline.

" - }, - "GlobalFilters":{ - "shape":"PatchFilterGroup", - "documentation":"

A set of global filters used to exclude patches from the baseline.

" - }, - "ApprovalRules":{ - "shape":"PatchRuleGroup", - "documentation":"

A set of rules used to include patches in the baseline.

" - }, - "ApprovedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly approved patches for the baseline.

For information about accepted formats for lists of approved patches and rejected patches, see Package Name Formats for Approved and Rejected Patch Lists in the AWS Systems Manager User Guide.

" - }, - "ApprovedPatchesComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

Assigns a new compliance severity level to an existing patch baseline.

" - }, - "ApprovedPatchesEnableNonSecurity":{ - "shape":"Boolean", - "documentation":"

Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.

", - "box":true - }, - "RejectedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly rejected patches for the baseline.

For information about accepted formats for lists of approved patches and rejected patches, see Package Name Formats for Approved and Rejected Patch Lists in the AWS Systems Manager User Guide.

" - }, - "Description":{ - "shape":"BaselineDescription", - "documentation":"

A description of the patch baseline.

" - }, - "Sources":{ - "shape":"PatchSourceList", - "documentation":"

Information about the patches to use to update the instances, including target operating systems and source repositories. Applies to Linux instances only.

" - }, - "Replace":{ - "shape":"Boolean", - "documentation":"

If True, then all fields that are required by the CreatePatchBaseline action are also required for this API request. Optional fields that are not specified are set to null.

", - "box":true - } - } - }, - "UpdatePatchBaselineResult":{ - "type":"structure", - "members":{ - "BaselineId":{ - "shape":"BaselineId", - "documentation":"

The ID of the deleted patch baseline.

" - }, - "Name":{ - "shape":"BaselineName", - "documentation":"

The name of the patch baseline.

" - }, - "OperatingSystem":{ - "shape":"OperatingSystem", - "documentation":"

The operating system rule used by the updated patch baseline.

" - }, - "GlobalFilters":{ - "shape":"PatchFilterGroup", - "documentation":"

A set of global filters used to exclude patches from the baseline.

" - }, - "ApprovalRules":{ - "shape":"PatchRuleGroup", - "documentation":"

A set of rules used to include patches in the baseline.

" - }, - "ApprovedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly approved patches for the baseline.

" - }, - "ApprovedPatchesComplianceLevel":{ - "shape":"PatchComplianceLevel", - "documentation":"

The compliance severity level assigned to the patch baseline after the update completed.

" - }, - "ApprovedPatchesEnableNonSecurity":{ - "shape":"Boolean", - "documentation":"

Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.

", - "box":true - }, - "RejectedPatches":{ - "shape":"PatchIdList", - "documentation":"

A list of explicitly rejected patches for the baseline.

" - }, - "CreatedDate":{ - "shape":"DateTime", - "documentation":"

The date when the patch baseline was created.

" - }, - "ModifiedDate":{ - "shape":"DateTime", - "documentation":"

The date when the patch baseline was last modified.

" - }, - "Description":{ - "shape":"BaselineDescription", - "documentation":"

A description of the Patch Baseline.

" - }, - "Sources":{ - "shape":"PatchSourceList", - "documentation":"

Information about the patches to use to update the instances, including target operating systems and source repositories. Applies to Linux instances only.

" - } - } - }, - "Url":{"type":"string"}, - "ValidNextStep":{ - "type":"string", - "max":65535, - "min":1 - }, - "ValidNextStepList":{ - "type":"list", - "member":{"shape":"ValidNextStep"} - }, - "Version":{ - "type":"string", - "pattern":"^[0-9]{1,6}(\\.[0-9]{1,6}){2,3}$" - } - }, - "documentation":"AWS Systems Manager

AWS Systems Manager is a collection of capabilities that helps you automate management tasks such as collecting system inventory, applying operating system (OS) patches, automating the creation of Amazon Machine Images (AMIs), and configuring operating systems (OSs) and applications at scale. Systems Manager lets you remotely and securely manage the configuration of your managed instances. A managed instance is any Amazon EC2 instance or on-premises machine in your hybrid environment that has been configured for Systems Manager.

This reference is intended to be used with the AWS Systems Manager User Guide.

To get started, verify prerequisites and configure managed instances. For more information, see Systems Manager Prerequisites in the AWS Systems Manager User Guide.

For information about other API actions you can perform on Amazon EC2 instances, see the Amazon EC2 API Reference. For information about how to use a Query API, see Making API Requests.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/paginators-1.json deleted file mode 100644 index 9feccba6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/paginators-1.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "pagination": { - "GetExecutionHistory": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "events" - }, - "ListActivities": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "activities" - }, - "ListExecutions": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "executions" - }, - "ListStateMachines": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "stateMachines" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/service-2.json deleted file mode 100644 index 59933d79..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/stepfunctions/2016-11-23/service-2.json +++ /dev/null @@ -1,1562 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-23", - "endpointPrefix":"states", - "jsonVersion":"1.0", - "protocol":"json", - "serviceAbbreviation":"AWS SFN", - "serviceFullName":"AWS Step Functions", - "serviceId":"SFN", - "signatureVersion":"v4", - "targetPrefix":"AWSStepFunctions", - "uid":"states-2016-11-23" - }, - "operations":{ - "CreateActivity":{ - "name":"CreateActivity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateActivityInput"}, - "output":{"shape":"CreateActivityOutput"}, - "errors":[ - {"shape":"ActivityLimitExceeded"}, - {"shape":"InvalidName"} - ], - "documentation":"

Creates an activity. An activity is a task which you write in any programming language and host on any machine which has access to AWS Step Functions. Activities must poll Step Functions using the GetActivityTask API action and respond using SendTask* API actions. This function lets Step Functions know the existence of your activity and returns an identifier for use in a state machine and when polling from the activity.

", - "idempotent":true - }, - "CreateStateMachine":{ - "name":"CreateStateMachine", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStateMachineInput"}, - "output":{"shape":"CreateStateMachineOutput"}, - "errors":[ - {"shape":"InvalidArn"}, - {"shape":"InvalidDefinition"}, - {"shape":"InvalidName"}, - {"shape":"StateMachineAlreadyExists"}, - {"shape":"StateMachineDeleting"}, - {"shape":"StateMachineLimitExceeded"} - ], - "documentation":"

Creates a state machine. A state machine consists of a collection of states that can do work (Task states), determine to which states to transition next (Choice states), stop an execution with an error (Fail states), and so on. State machines are specified using a JSON-based, structured language.

", - "idempotent":true - }, - "DeleteActivity":{ - "name":"DeleteActivity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteActivityInput"}, - "output":{"shape":"DeleteActivityOutput"}, - "errors":[ - {"shape":"InvalidArn"} - ], - "documentation":"

Deletes an activity.

" - }, - "DeleteStateMachine":{ - "name":"DeleteStateMachine", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteStateMachineInput"}, - "output":{"shape":"DeleteStateMachineOutput"}, - "errors":[ - {"shape":"InvalidArn"} - ], - "documentation":"

Deletes a state machine. This is an asynchronous operation: It sets the state machine's status to DELETING and begins the deletion process. Each state machine execution is deleted the next time it makes a state transition.

The state machine itself is deleted after all executions are completed or deleted.

" - }, - "DescribeActivity":{ - "name":"DescribeActivity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeActivityInput"}, - "output":{"shape":"DescribeActivityOutput"}, - "errors":[ - {"shape":"ActivityDoesNotExist"}, - {"shape":"InvalidArn"} - ], - "documentation":"

Describes an activity.

" - }, - "DescribeExecution":{ - "name":"DescribeExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeExecutionInput"}, - "output":{"shape":"DescribeExecutionOutput"}, - "errors":[ - {"shape":"ExecutionDoesNotExist"}, - {"shape":"InvalidArn"} - ], - "documentation":"

Describes an execution.

" - }, - "DescribeStateMachine":{ - "name":"DescribeStateMachine", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStateMachineInput"}, - "output":{"shape":"DescribeStateMachineOutput"}, - "errors":[ - {"shape":"InvalidArn"}, - {"shape":"StateMachineDoesNotExist"} - ], - "documentation":"

Describes a state machine.

" - }, - "DescribeStateMachineForExecution":{ - "name":"DescribeStateMachineForExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStateMachineForExecutionInput"}, - "output":{"shape":"DescribeStateMachineForExecutionOutput"}, - "errors":[ - {"shape":"ExecutionDoesNotExist"}, - {"shape":"InvalidArn"} - ], - "documentation":"

Describes the state machine associated with a specific execution.

" - }, - "GetActivityTask":{ - "name":"GetActivityTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetActivityTaskInput"}, - "output":{"shape":"GetActivityTaskOutput"}, - "errors":[ - {"shape":"ActivityDoesNotExist"}, - {"shape":"ActivityWorkerLimitExceeded"}, - {"shape":"InvalidArn"} - ], - "documentation":"

Used by workers to retrieve a task (with the specified activity ARN) which has been scheduled for execution by a running state machine. This initiates a long poll, where the service holds the HTTP connection open and responds as soon as a task becomes available (i.e. an execution of a task of this type is needed.) The maximum time the service holds on to the request before responding is 60 seconds. If no task is available within 60 seconds, the poll returns a taskToken with a null string.

Workers should set their client side socket timeout to at least 65 seconds (5 seconds higher than the maximum time the service may hold the poll request).

" - }, - "GetExecutionHistory":{ - "name":"GetExecutionHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetExecutionHistoryInput"}, - "output":{"shape":"GetExecutionHistoryOutput"}, - "errors":[ - {"shape":"ExecutionDoesNotExist"}, - {"shape":"InvalidArn"}, - {"shape":"InvalidToken"} - ], - "documentation":"

Returns the history of the specified execution as a list of events. By default, the results are returned in ascending order of the timeStamp of the events. Use the reverseOrder parameter to get the latest events first.

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

" - }, - "ListActivities":{ - "name":"ListActivities", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListActivitiesInput"}, - "output":{"shape":"ListActivitiesOutput"}, - "errors":[ - {"shape":"InvalidToken"} - ], - "documentation":"

Lists the existing activities.

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

" - }, - "ListExecutions":{ - "name":"ListExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListExecutionsInput"}, - "output":{"shape":"ListExecutionsOutput"}, - "errors":[ - {"shape":"InvalidArn"}, - {"shape":"InvalidToken"}, - {"shape":"StateMachineDoesNotExist"} - ], - "documentation":"

Lists the executions of a state machine that meet the filtering criteria.

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

" - }, - "ListStateMachines":{ - "name":"ListStateMachines", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListStateMachinesInput"}, - "output":{"shape":"ListStateMachinesOutput"}, - "errors":[ - {"shape":"InvalidToken"} - ], - "documentation":"

Lists the existing state machines.

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

" - }, - "SendTaskFailure":{ - "name":"SendTaskFailure", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendTaskFailureInput"}, - "output":{"shape":"SendTaskFailureOutput"}, - "errors":[ - {"shape":"TaskDoesNotExist"}, - {"shape":"InvalidToken"}, - {"shape":"TaskTimedOut"} - ], - "documentation":"

Used by workers to report that the task identified by the taskToken failed.

" - }, - "SendTaskHeartbeat":{ - "name":"SendTaskHeartbeat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendTaskHeartbeatInput"}, - "output":{"shape":"SendTaskHeartbeatOutput"}, - "errors":[ - {"shape":"TaskDoesNotExist"}, - {"shape":"InvalidToken"}, - {"shape":"TaskTimedOut"} - ], - "documentation":"

Used by workers to report to the service that the task represented by the specified taskToken is still making progress. This action resets the Heartbeat clock. The Heartbeat threshold is specified in the state machine's Amazon States Language definition. This action does not in itself create an event in the execution history. However, if the task times out, the execution history contains an ActivityTimedOut event.

The Timeout of a task, defined in the state machine's Amazon States Language definition, is its maximum allowed duration, regardless of the number of SendTaskHeartbeat requests received.

This operation is only useful for long-lived tasks to report the liveliness of the task.

" - }, - "SendTaskSuccess":{ - "name":"SendTaskSuccess", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SendTaskSuccessInput"}, - "output":{"shape":"SendTaskSuccessOutput"}, - "errors":[ - {"shape":"TaskDoesNotExist"}, - {"shape":"InvalidOutput"}, - {"shape":"InvalidToken"}, - {"shape":"TaskTimedOut"} - ], - "documentation":"

Used by workers to report that the task identified by the taskToken completed successfully.

" - }, - "StartExecution":{ - "name":"StartExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartExecutionInput"}, - "output":{"shape":"StartExecutionOutput"}, - "errors":[ - {"shape":"ExecutionLimitExceeded"}, - {"shape":"ExecutionAlreadyExists"}, - {"shape":"InvalidArn"}, - {"shape":"InvalidExecutionInput"}, - {"shape":"InvalidName"}, - {"shape":"StateMachineDoesNotExist"}, - {"shape":"StateMachineDeleting"} - ], - "documentation":"

Starts a state machine execution.

", - "idempotent":true - }, - "StopExecution":{ - "name":"StopExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopExecutionInput"}, - "output":{"shape":"StopExecutionOutput"}, - "errors":[ - {"shape":"ExecutionDoesNotExist"}, - {"shape":"InvalidArn"} - ], - "documentation":"

Stops an execution.

" - }, - "UpdateStateMachine":{ - "name":"UpdateStateMachine", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateStateMachineInput"}, - "output":{"shape":"UpdateStateMachineOutput"}, - "errors":[ - {"shape":"InvalidArn"}, - {"shape":"InvalidDefinition"}, - {"shape":"MissingRequiredParameter"}, - {"shape":"StateMachineDeleting"}, - {"shape":"StateMachineDoesNotExist"} - ], - "documentation":"

Updates an existing state machine by modifying its definition and/or roleArn. Running executions will continue to use the previous definition and roleArn.

All StartExecution calls within a few seconds will use the updated definition and roleArn. Executions started immediately after calling UpdateStateMachine may use the previous state machine definition and roleArn. You must include at least one of definition or roleArn or you will receive a MissingRequiredParameter error.

", - "idempotent":true - } - }, - "shapes":{ - "ActivityDoesNotExist":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified activity does not exist.

", - "exception":true - }, - "ActivityFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about an activity which failed during an execution.

" - }, - "ActivityLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum number of activities has been reached. Existing activities must be deleted before a new activity can be created.

", - "exception":true - }, - "ActivityList":{ - "type":"list", - "member":{"shape":"ActivityListItem"} - }, - "ActivityListItem":{ - "type":"structure", - "required":[ - "activityArn", - "name", - "creationDate" - ], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the activity.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the activity.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the activity is created.

" - } - }, - "documentation":"

Contains details about an activity.

" - }, - "ActivityScheduleFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about an activity schedule failure which occurred during an execution.

" - }, - "ActivityScheduledEventDetails":{ - "type":"structure", - "required":["resource"], - "members":{ - "resource":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the scheduled activity.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The JSON data input to the activity task.

" - }, - "timeoutInSeconds":{ - "shape":"TimeoutInSeconds", - "documentation":"

The maximum allowed duration of the activity task.

", - "box":true - }, - "heartbeatInSeconds":{ - "shape":"TimeoutInSeconds", - "documentation":"

The maximum allowed duration between two heartbeats for the activity task.

", - "box":true - } - }, - "documentation":"

Contains details about an activity scheduled during an execution.

" - }, - "ActivityStartedEventDetails":{ - "type":"structure", - "members":{ - "workerName":{ - "shape":"Identity", - "documentation":"

The name of the worker that the task is assigned to. These names are provided by the workers when calling GetActivityTask.

" - } - }, - "documentation":"

Contains details about the start of an activity during an execution.

" - }, - "ActivitySucceededEventDetails":{ - "type":"structure", - "members":{ - "output":{ - "shape":"Data", - "documentation":"

The JSON data output by the activity task.

" - } - }, - "documentation":"

Contains details about an activity which successfully terminated during an execution.

" - }, - "ActivityTimedOutEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the timeout.

" - } - }, - "documentation":"

Contains details about an activity timeout which occurred during an execution.

" - }, - "ActivityWorkerLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum number of workers concurrently polling for activity tasks has been reached.

", - "exception":true - }, - "Arn":{ - "type":"string", - "max":256, - "min":1 - }, - "Cause":{ - "type":"string", - "max":32768, - "min":0 - }, - "CreateActivityInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the activity to create. This name must be unique for your AWS account and region for 90 days. For more information, see Limits Related to State Machine Executions in the AWS Step Functions Developer Guide.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - } - } - }, - "CreateActivityOutput":{ - "type":"structure", - "required":[ - "activityArn", - "creationDate" - ], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the created activity.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the activity is created.

" - } - } - }, - "CreateStateMachineInput":{ - "type":"structure", - "required":[ - "name", - "definition", - "roleArn" - ], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the state machine. This name must be unique for your AWS account and region for 90 days. For more information, see Limits Related to State Machine Executions in the AWS Step Functions Developer Guide.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "definition":{ - "shape":"Definition", - "documentation":"

The Amazon States Language definition of the state machine.

" - }, - "roleArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role to use for this state machine.

" - } - } - }, - "CreateStateMachineOutput":{ - "type":"structure", - "required":[ - "stateMachineArn", - "creationDate" - ], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the created state machine.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the state machine is created.

" - } - } - }, - "Data":{ - "type":"string", - "max":32768 - }, - "Definition":{ - "type":"string", - "max":1048576, - "min":1 - }, - "DeleteActivityInput":{ - "type":"structure", - "required":["activityArn"], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the activity to delete.

" - } - } - }, - "DeleteActivityOutput":{ - "type":"structure", - "members":{ - } - }, - "DeleteStateMachineInput":{ - "type":"structure", - "required":["stateMachineArn"], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine to delete.

" - } - } - }, - "DeleteStateMachineOutput":{ - "type":"structure", - "members":{ - } - }, - "DescribeActivityInput":{ - "type":"structure", - "required":["activityArn"], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the activity to describe.

" - } - } - }, - "DescribeActivityOutput":{ - "type":"structure", - "required":[ - "activityArn", - "name", - "creationDate" - ], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the activity.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the activity.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the activity is created.

" - } - } - }, - "DescribeExecutionInput":{ - "type":"structure", - "required":["executionArn"], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the execution to describe.

" - } - } - }, - "DescribeExecutionOutput":{ - "type":"structure", - "required":[ - "executionArn", - "stateMachineArn", - "status", - "startDate", - "input" - ], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the execution.

" - }, - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the executed stated machine.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the execution.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The current status of the execution.

" - }, - "startDate":{ - "shape":"Timestamp", - "documentation":"

The date the execution is started.

" - }, - "stopDate":{ - "shape":"Timestamp", - "documentation":"

If the execution has already ended, the date the execution stopped.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The string that contains the JSON input data of the execution.

" - }, - "output":{ - "shape":"Data", - "documentation":"

The JSON output data of the execution.

This field is set only if the execution succeeds. If the execution fails, this field is null.

" - } - } - }, - "DescribeStateMachineForExecutionInput":{ - "type":"structure", - "required":["executionArn"], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the execution you want state machine information for.

" - } - } - }, - "DescribeStateMachineForExecutionOutput":{ - "type":"structure", - "required":[ - "stateMachineArn", - "name", - "definition", - "roleArn", - "updateDate" - ], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine associated with the execution.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the state machine associated with the execution.

" - }, - "definition":{ - "shape":"Definition", - "documentation":"

The Amazon States Language definition of the state machine.

" - }, - "roleArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role of the State Machine for the execution.

" - }, - "updateDate":{ - "shape":"Timestamp", - "documentation":"

The date and time the state machine associated with an execution was updated. For a newly created state machine, this is the creation date.

" - } - } - }, - "DescribeStateMachineInput":{ - "type":"structure", - "required":["stateMachineArn"], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine to describe.

" - } - } - }, - "DescribeStateMachineOutput":{ - "type":"structure", - "required":[ - "stateMachineArn", - "name", - "definition", - "roleArn", - "creationDate" - ], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the state machine.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the state machine.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "status":{ - "shape":"StateMachineStatus", - "documentation":"

The current status of the state machine.

" - }, - "definition":{ - "shape":"Definition", - "documentation":"

The Amazon States Language definition of the state machine.

" - }, - "roleArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role used when creating this state machine. (The IAM role maintains security by granting Step Functions access to AWS resources.)

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the state machine is created.

" - } - } - }, - "Error":{ - "type":"string", - "max":256, - "min":0 - }, - "ErrorMessage":{"type":"string"}, - "EventId":{"type":"long"}, - "ExecutionAbortedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about an abort of an execution.

" - }, - "ExecutionAlreadyExists":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The execution has the same name as another execution (but a different input).

Executions with the same name and input are considered idempotent.

", - "exception":true - }, - "ExecutionDoesNotExist":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified execution does not exist.

", - "exception":true - }, - "ExecutionFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about an execution failure event.

" - }, - "ExecutionLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum number of running executions has been reached. Running executions must end or be stopped before a new execution can be started.

", - "exception":true - }, - "ExecutionList":{ - "type":"list", - "member":{"shape":"ExecutionListItem"} - }, - "ExecutionListItem":{ - "type":"structure", - "required":[ - "executionArn", - "stateMachineArn", - "name", - "status", - "startDate" - ], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the execution.

" - }, - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the executed state machine.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the execution.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "status":{ - "shape":"ExecutionStatus", - "documentation":"

The current status of the execution.

" - }, - "startDate":{ - "shape":"Timestamp", - "documentation":"

The date the execution started.

" - }, - "stopDate":{ - "shape":"Timestamp", - "documentation":"

If the execution already ended, the date the execution stopped.

" - } - }, - "documentation":"

Contains details about an execution.

" - }, - "ExecutionStartedEventDetails":{ - "type":"structure", - "members":{ - "input":{ - "shape":"Data", - "documentation":"

The JSON data input to the execution.

" - }, - "roleArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role used for executing AWS Lambda tasks.

" - } - }, - "documentation":"

Contains details about the start of the execution.

" - }, - "ExecutionStatus":{ - "type":"string", - "enum":[ - "RUNNING", - "SUCCEEDED", - "FAILED", - "TIMED_OUT", - "ABORTED" - ] - }, - "ExecutionSucceededEventDetails":{ - "type":"structure", - "members":{ - "output":{ - "shape":"Data", - "documentation":"

The JSON data output by the execution.

" - } - }, - "documentation":"

Contains details about the successful termination of the execution.

" - }, - "ExecutionTimedOutEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the timeout.

" - } - }, - "documentation":"

Contains details about the execution timeout which occurred during the execution.

" - }, - "GetActivityTaskInput":{ - "type":"structure", - "required":["activityArn"], - "members":{ - "activityArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the activity to retrieve tasks from (assigned when you create the task using CreateActivity.)

" - }, - "workerName":{ - "shape":"Name", - "documentation":"

You can provide an arbitrary name in order to identify the worker that the task is assigned to. This name is used when it is logged in the execution history.

" - } - } - }, - "GetActivityTaskOutput":{ - "type":"structure", - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

A token that identifies the scheduled task. This token must be copied and included in subsequent calls to SendTaskHeartbeat, SendTaskSuccess or SendTaskFailure in order to report the progress or completion of the task.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The string that contains the JSON input data for the task.

" - } - } - }, - "GetExecutionHistoryInput":{ - "type":"structure", - "required":["executionArn"], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the execution.

" - }, - "maxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 100 and the maximum allowed page size is 100. A value of 0 uses the default.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

Lists events in descending order of their timeStamp.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "GetExecutionHistoryOutput":{ - "type":"structure", - "required":["events"], - "members":{ - "events":{ - "shape":"HistoryEventList", - "documentation":"

The list of events that occurred in the execution.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "HistoryEvent":{ - "type":"structure", - "required":[ - "timestamp", - "type", - "id" - ], - "members":{ - "timestamp":{ - "shape":"Timestamp", - "documentation":"

The date the event occurred.

" - }, - "type":{ - "shape":"HistoryEventType", - "documentation":"

The type of the event.

" - }, - "id":{ - "shape":"EventId", - "documentation":"

The id of the event. Events are numbered sequentially, starting at one.

" - }, - "previousEventId":{ - "shape":"EventId", - "documentation":"

The id of the previous event.

" - }, - "activityFailedEventDetails":{"shape":"ActivityFailedEventDetails"}, - "activityScheduleFailedEventDetails":{ - "shape":"ActivityScheduleFailedEventDetails", - "documentation":"

Contains details about an activity schedule event which failed during an execution.

" - }, - "activityScheduledEventDetails":{"shape":"ActivityScheduledEventDetails"}, - "activityStartedEventDetails":{"shape":"ActivityStartedEventDetails"}, - "activitySucceededEventDetails":{"shape":"ActivitySucceededEventDetails"}, - "activityTimedOutEventDetails":{"shape":"ActivityTimedOutEventDetails"}, - "executionFailedEventDetails":{"shape":"ExecutionFailedEventDetails"}, - "executionStartedEventDetails":{"shape":"ExecutionStartedEventDetails"}, - "executionSucceededEventDetails":{"shape":"ExecutionSucceededEventDetails"}, - "executionAbortedEventDetails":{"shape":"ExecutionAbortedEventDetails"}, - "executionTimedOutEventDetails":{"shape":"ExecutionTimedOutEventDetails"}, - "lambdaFunctionFailedEventDetails":{"shape":"LambdaFunctionFailedEventDetails"}, - "lambdaFunctionScheduleFailedEventDetails":{"shape":"LambdaFunctionScheduleFailedEventDetails"}, - "lambdaFunctionScheduledEventDetails":{"shape":"LambdaFunctionScheduledEventDetails"}, - "lambdaFunctionStartFailedEventDetails":{ - "shape":"LambdaFunctionStartFailedEventDetails", - "documentation":"

Contains details about a lambda function which failed to start during an execution.

" - }, - "lambdaFunctionSucceededEventDetails":{ - "shape":"LambdaFunctionSucceededEventDetails", - "documentation":"

Contains details about a lambda function which terminated successfully during an execution.

" - }, - "lambdaFunctionTimedOutEventDetails":{"shape":"LambdaFunctionTimedOutEventDetails"}, - "stateEnteredEventDetails":{"shape":"StateEnteredEventDetails"}, - "stateExitedEventDetails":{"shape":"StateExitedEventDetails"} - }, - "documentation":"

Contains details about the events of an execution.

" - }, - "HistoryEventList":{ - "type":"list", - "member":{"shape":"HistoryEvent"}, - "documentation":"

Contains details about the events which occurred during an execution.

" - }, - "HistoryEventType":{ - "type":"string", - "enum":[ - "ActivityFailed", - "ActivityScheduleFailed", - "ActivityScheduled", - "ActivityStarted", - "ActivitySucceeded", - "ActivityTimedOut", - "ChoiceStateEntered", - "ChoiceStateExited", - "ExecutionFailed", - "ExecutionStarted", - "ExecutionSucceeded", - "ExecutionAborted", - "ExecutionTimedOut", - "FailStateEntered", - "LambdaFunctionFailed", - "LambdaFunctionScheduleFailed", - "LambdaFunctionScheduled", - "LambdaFunctionStartFailed", - "LambdaFunctionStarted", - "LambdaFunctionSucceeded", - "LambdaFunctionTimedOut", - "SucceedStateEntered", - "SucceedStateExited", - "TaskStateAborted", - "TaskStateEntered", - "TaskStateExited", - "PassStateEntered", - "PassStateExited", - "ParallelStateAborted", - "ParallelStateEntered", - "ParallelStateExited", - "ParallelStateFailed", - "ParallelStateStarted", - "ParallelStateSucceeded", - "WaitStateAborted", - "WaitStateEntered", - "WaitStateExited" - ] - }, - "Identity":{ - "type":"string", - "max":256 - }, - "InvalidArn":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided Amazon Resource Name (ARN) is invalid.

", - "exception":true - }, - "InvalidDefinition":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided Amazon States Language definition is invalid.

", - "exception":true - }, - "InvalidExecutionInput":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided JSON input data is invalid.

", - "exception":true - }, - "InvalidName":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided name is invalid.

", - "exception":true - }, - "InvalidOutput":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided JSON output data is invalid.

", - "exception":true - }, - "InvalidToken":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The provided token is invalid.

", - "exception":true - }, - "LambdaFunctionFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about a lambda function which failed during an execution.

" - }, - "LambdaFunctionScheduleFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about a failed lambda function schedule event which occurred during an execution.

" - }, - "LambdaFunctionScheduledEventDetails":{ - "type":"structure", - "required":["resource"], - "members":{ - "resource":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the scheduled lambda function.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The JSON data input to the lambda function.

" - }, - "timeoutInSeconds":{ - "shape":"TimeoutInSeconds", - "documentation":"

The maximum allowed duration of the lambda function.

", - "box":true - } - }, - "documentation":"

Contains details about a lambda function scheduled during an execution.

" - }, - "LambdaFunctionStartFailedEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - }, - "documentation":"

Contains details about a lambda function which failed to start during an execution.

" - }, - "LambdaFunctionSucceededEventDetails":{ - "type":"structure", - "members":{ - "output":{ - "shape":"Data", - "documentation":"

The JSON data output by the lambda function.

" - } - }, - "documentation":"

Contains details about a lambda function which successfully terminated during an execution.

" - }, - "LambdaFunctionTimedOutEventDetails":{ - "type":"structure", - "members":{ - "error":{ - "shape":"Error", - "documentation":"

The error code of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the timeout.

" - } - }, - "documentation":"

Contains details about a lambda function timeout which occurred during an execution.

" - }, - "ListActivitiesInput":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 100 and the maximum allowed page size is 100. A value of 0 uses the default.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "ListActivitiesOutput":{ - "type":"structure", - "required":["activities"], - "members":{ - "activities":{ - "shape":"ActivityList", - "documentation":"

The list of activities.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "ListExecutionsInput":{ - "type":"structure", - "required":["stateMachineArn"], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine whose executions is listed.

" - }, - "statusFilter":{ - "shape":"ExecutionStatus", - "documentation":"

If specified, only list the executions whose current execution status matches the given filter.

" - }, - "maxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 100 and the maximum allowed page size is 100. A value of 0 uses the default.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "ListExecutionsOutput":{ - "type":"structure", - "required":["executions"], - "members":{ - "executions":{ - "shape":"ExecutionList", - "documentation":"

The list of matching executions.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "ListStateMachinesInput":{ - "type":"structure", - "members":{ - "maxResults":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. You can use nextToken to obtain further pages of results. The default is 100 and the maximum allowed page size is 100. A value of 0 uses the default.

This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.

" - }, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "ListStateMachinesOutput":{ - "type":"structure", - "required":["stateMachines"], - "members":{ - "stateMachines":{"shape":"StateMachineList"}, - "nextToken":{ - "shape":"PageToken", - "documentation":"

If a nextToken is returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextToken. Keep all other arguments unchanged.

The configured maxResults determines how many results can be returned in a single call.

" - } - } - }, - "MissingRequiredParameter":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

Request is missing a required parameter. This error occurs if both definition and roleArn are not specified.

", - "exception":true - }, - "Name":{ - "type":"string", - "max":80, - "min":1 - }, - "PageSize":{ - "type":"integer", - "max":1000, - "min":0 - }, - "PageToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "ReverseOrder":{"type":"boolean"}, - "SendTaskFailureInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The token that represents this task. Task tokens are generated by the service when the tasks are assigned to a worker (see GetActivityTask::taskToken).

" - }, - "error":{ - "shape":"Error", - "documentation":"

An arbitrary error code that identifies the cause of the failure.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the failure.

" - } - } - }, - "SendTaskFailureOutput":{ - "type":"structure", - "members":{ - } - }, - "SendTaskHeartbeatInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The token that represents this task. Task tokens are generated by the service when the tasks are assigned to a worker (see GetActivityTaskOutput$taskToken).

" - } - } - }, - "SendTaskHeartbeatOutput":{ - "type":"structure", - "members":{ - } - }, - "SendTaskSuccessInput":{ - "type":"structure", - "required":[ - "taskToken", - "output" - ], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The token that represents this task. Task tokens are generated by the service when the tasks are assigned to a worker (see GetActivityTaskOutput$taskToken).

" - }, - "output":{ - "shape":"Data", - "documentation":"

The JSON output of the task.

" - } - } - }, - "SendTaskSuccessOutput":{ - "type":"structure", - "members":{ - } - }, - "StartExecutionInput":{ - "type":"structure", - "required":["stateMachineArn"], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine to execute.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the execution. This name must be unique for your AWS account and region for 90 days. For more information, see Limits Related to State Machine Executions in the AWS Step Functions Developer Guide.

An execution can't use the name of another execution for 90 days.

When you make multiple StartExecution calls with the same name, the new execution doesn't run and the following rules apply:

  • When the original execution is open and the execution input from the new call is different, the ExecutionAlreadyExists message is returned.

  • When the original execution is open and the execution input from the new call is identical, the Success message is returned.

  • When the original execution is closed, the ExecutionAlreadyExists message is returned regardless of input.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "input":{ - "shape":"Data", - "documentation":"

The string that contains the JSON input data for the execution, for example:

\"input\": \"{\\\"first_name\\\" : \\\"test\\\"}\"

If you don't include any JSON input data, you still must include the two braces, for example: \"input\": \"{}\"

" - } - } - }, - "StartExecutionOutput":{ - "type":"structure", - "required":[ - "executionArn", - "startDate" - ], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the execution.

" - }, - "startDate":{ - "shape":"Timestamp", - "documentation":"

The date the execution is started.

" - } - } - }, - "StateEnteredEventDetails":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the state.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The string that contains the JSON input data for the state.

" - } - }, - "documentation":"

Contains details about a state entered during an execution.

" - }, - "StateExitedEventDetails":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the state.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "output":{ - "shape":"Data", - "documentation":"

The JSON output data of the state.

" - } - }, - "documentation":"

Contains details about an exit from a state during an execution.

" - }, - "StateMachineAlreadyExists":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

A state machine with the same name but a different definition or role ARN already exists.

", - "exception":true - }, - "StateMachineDeleting":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified state machine is being deleted.

", - "exception":true - }, - "StateMachineDoesNotExist":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The specified state machine does not exist.

", - "exception":true - }, - "StateMachineLimitExceeded":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The maximum number of state machines has been reached. Existing state machines must be deleted before a new state machine can be created.

", - "exception":true - }, - "StateMachineList":{ - "type":"list", - "member":{"shape":"StateMachineListItem"} - }, - "StateMachineListItem":{ - "type":"structure", - "required":[ - "stateMachineArn", - "name", - "creationDate" - ], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) that identifies the state machine.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the state machine.

A name must not contain:

  • whitespace

  • brackets < > { } [ ]

  • wildcard characters ? *

  • special characters \" # % \\ ^ | ~ ` $ & , ; : /

  • control characters (U+0000-001F, U+007F-009F)

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date the state machine is created.

" - } - }, - "documentation":"

Contains details about the state machine.

" - }, - "StateMachineStatus":{ - "type":"string", - "enum":[ - "ACTIVE", - "DELETING" - ] - }, - "StopExecutionInput":{ - "type":"structure", - "required":["executionArn"], - "members":{ - "executionArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the execution to stop.

" - }, - "error":{ - "shape":"Error", - "documentation":"

An arbitrary error code that identifies the cause of the termination.

" - }, - "cause":{ - "shape":"Cause", - "documentation":"

A more detailed explanation of the cause of the termination.

" - } - } - }, - "StopExecutionOutput":{ - "type":"structure", - "required":["stopDate"], - "members":{ - "stopDate":{ - "shape":"Timestamp", - "documentation":"

The date the execution is stopped.

" - } - } - }, - "TaskDoesNotExist":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true - }, - "TaskTimedOut":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "exception":true - }, - "TaskToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "TimeoutInSeconds":{"type":"long"}, - "Timestamp":{"type":"timestamp"}, - "UpdateStateMachineInput":{ - "type":"structure", - "required":["stateMachineArn"], - "members":{ - "stateMachineArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the state machine.

" - }, - "definition":{ - "shape":"Definition", - "documentation":"

The Amazon States Language definition of the state machine.

" - }, - "roleArn":{ - "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the IAM role of the state machine.

" - } - } - }, - "UpdateStateMachineOutput":{ - "type":"structure", - "required":["updateDate"], - "members":{ - "updateDate":{ - "shape":"Timestamp", - "documentation":"

The date and time the state machine was updated.

" - } - } - } - }, - "documentation":"AWS Step Functions

AWS Step Functions is a service that lets you coordinate the components of distributed applications and microservices using visual workflows.

You can use Step Functions to build applications from individual components, each of which performs a discrete function, or task, allowing you to scale and change applications quickly. Step Functions provides a console that helps visualize the components of your application as a series of steps. Step Functions automatically triggers and tracks each step, and retries steps when there are errors, so your application executes predictably and in the right order every time. Step Functions logs the state of each step, so you can quickly diagnose and debug any issues.

Step Functions manages operations and underlying infrastructure to ensure your application is available at any scale. You can run tasks on AWS, your own servers, or any system that has access to AWS. You can access and use Step Functions using the console, the AWS SDKs, or an HTTP API. For more information about Step Functions, see the AWS Step Functions Developer Guide .

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/examples-1.json deleted file mode 100644 index 7cc0d7d4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/examples-1.json +++ /dev/null @@ -1,1381 +0,0 @@ -{ - "version": "1.0", - "examples": { - "ActivateGateway": [ - { - "input": { - "ActivationKey": "29AV1-3OFV9-VVIUB-NKT0I-LRO6V", - "GatewayName": "My_Gateway", - "GatewayRegion": "us-east-1", - "GatewayTimezone": "GMT-12:00", - "GatewayType": "STORED", - "MediumChangerType": "AWS-Gateway-VTL", - "TapeDriveType": "IBM-ULT3580-TD5" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Activates the gateway you previously deployed on your host.", - "id": "to-activate-the-gateway-1471281611207", - "title": "To activate the gateway" - } - ], - "AddCache": [ - { - "input": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:03:00.0-scsi-0:0:1:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example shows a request that activates a gateway-stored volume.", - "id": "to-add-a-cache-1471043606854", - "title": "To add a cache" - } - ], - "AddTagsToResource": [ - { - "input": { - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B", - "Tags": [ - { - "Key": "Dev Gatgeway Region", - "Value": "East Coast" - } - ] - }, - "output": { - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Adds one or more tags to the specified resource.", - "id": "to-add-tags-to-resource-1471283689460", - "title": "To add tags to resource" - } - ], - "AddUploadBuffer": [ - { - "input": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:03:00.0-scsi-0:0:1:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Configures one or more gateway local disks as upload buffer for a specified gateway.", - "id": "to-add-upload-buffer-on-local-disk-1471293902847", - "title": "To add upload buffer on local disk" - } - ], - "AddWorkingStorage": [ - { - "input": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:03:00.0-scsi-0:0:1:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Configures one or more gateway local disks as working storage for a gateway. (Working storage is also referred to as upload buffer.)", - "id": "to-add-storage-on-local-disk-1471294305401", - "title": "To add storage on local disk" - } - ], - "CancelArchival": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/AMZN01A2A4" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/AMZN01A2A4" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Cancels archiving of a virtual tape to the virtual tape shelf (VTS) after the archiving process is initiated.", - "id": "to-cancel-virtual-tape-archiving-1471294865203", - "title": "To cancel virtual tape archiving" - } - ], - "CancelRetrieval": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/AMZN01A2A4" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/AMZN01A2A4" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) to a gateway after the retrieval process is initiated.", - "id": "to-cancel-virtual-tape-retrieval-1471295704491", - "title": "To cancel virtual tape retrieval" - } - ], - "CreateCachediSCSIVolume": [ - { - "input": { - "ClientToken": "cachedvol112233", - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "NetworkInterfaceId": "10.1.1.1", - "SnapshotId": "snap-f47b7b94", - "TargetName": "my-volume", - "VolumeSizeInBytes": 536870912000 - }, - "output": { - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates a cached volume on a specified cached gateway.", - "id": "to-create-a-cached-iscsi-volume-1471296661787", - "title": "To create a cached iSCSI volume" - } - ], - "CreateSnapshot": [ - { - "input": { - "SnapshotDescription": "My root volume snapshot as of 10/03/2017", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "SnapshotId": "snap-78e22663", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Initiates an ad-hoc snapshot of a gateway volume.", - "id": "to-create-a-snapshot-of-a-gateway-volume-1471301469561", - "title": "To create a snapshot of a gateway volume" - } - ], - "CreateSnapshotFromVolumeRecoveryPoint": [ - { - "input": { - "SnapshotDescription": "My root volume snapshot as of 2017-06-30T10:10:10.000Z", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "SnapshotId": "snap-78e22663", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeRecoveryPointTime": "2017-06-30T10:10:10.000Z" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Initiates a snapshot of a gateway from a volume recovery point.", - "id": "to-create-a-snapshot-of-a-gateway-volume-1471301469561", - "title": "To create a snapshot of a gateway volume" - } - ], - "CreateStorediSCSIVolume": [ - { - "input": { - "DiskId": "pci-0000:03:00.0-scsi-0:0:0:0", - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "NetworkInterfaceId": "10.1.1.1", - "PreserveExistingData": true, - "SnapshotId": "snap-f47b7b94", - "TargetName": "my-volume" - }, - "output": { - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeSizeInBytes": 1099511627776 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates a stored volume on a specified stored gateway.", - "id": "to-create-a-stored-iscsi-volume-1471367662813", - "title": "To create a stored iSCSI volume" - } - ], - "CreateTapeWithBarcode": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "TapeBarcode": "TEST12345", - "TapeSizeInBytes": 107374182400 - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST12345" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates a virtual tape by using your own barcode.", - "id": "to-create-a-virtual-tape-using-a-barcode-1471371842452", - "title": "To create a virtual tape using a barcode" - } - ], - "CreateTapes": [ - { - "input": { - "ClientToken": "77777", - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "NumTapesToCreate": 3, - "TapeBarcodePrefix": "TEST", - "TapeSizeInBytes": 107374182400 - }, - "output": { - "TapeARNs": [ - "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST38A29D", - "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST3AA29F", - "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST3BA29E" - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Creates one or more virtual tapes.", - "id": "to-create-a-virtual-tape-1471372061659", - "title": "To create a virtual tape" - } - ], - "DeleteBandwidthRateLimit": [ - { - "input": { - "BandwidthType": "All", - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the bandwidth rate limits of a gateway; either the upload or download limit, or both.", - "id": "to-delete-bandwidth-rate-limits-of-gateway-1471373225520", - "title": "To delete bandwidth rate limits of gateway" - } - ], - "DeleteChapCredentials": [ - { - "input": { - "InitiatorName": "iqn.1991-05.com.microsoft:computername.domain.example.com", - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - }, - "output": { - "InitiatorName": "iqn.1991-05.com.microsoft:computername.domain.example.com", - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes Challenge-Handshake Authentication Protocol (CHAP) credentials for a specified iSCSI target and initiator pair.", - "id": "to-delete-chap-credentials-1471375025612", - "title": "To delete CHAP credentials" - } - ], - "DeleteGateway": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation deletes the gateway, but not the gateway's VM from the host computer.", - "id": "to-delete-a-gatgeway-1471381697333", - "title": "To delete a gatgeway" - } - ], - "DeleteSnapshotSchedule": [ - { - "input": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This action enables you to delete a snapshot schedule for a volume.", - "id": "to-delete-a-snapshot-of-a-volume-1471382234377", - "title": "To delete a snapshot of a volume" - } - ], - "DeleteTape": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:204469490176:gateway/sgw-12A3456B", - "TapeARN": "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST05A2A0" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST05A2A0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example deletes the specified virtual tape.", - "id": "to-delete-a-virtual-tape-1471382444157", - "title": "To delete a virtual tape" - } - ], - "DeleteTapeArchive": [ - { - "input": { - "TapeARN": "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST05A2A0" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST05A2A0" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the specified virtual tape from the virtual tape shelf (VTS).", - "id": "to-delete-a-virtual-tape-from-the-shelf-vts-1471383964329", - "title": "To delete a virtual tape from the shelf (VTS)" - } - ], - "DeleteVolume": [ - { - "input": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Deletes the specified gateway volume that you previously created using the CreateCachediSCSIVolume or CreateStorediSCSIVolume API.", - "id": "to-delete-a-gateway-volume-1471384418416", - "title": "To delete a gateway volume" - } - ], - "DescribeBandwidthRateLimit": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "AverageDownloadRateLimitInBitsPerSec": 204800, - "AverageUploadRateLimitInBitsPerSec": 102400, - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a value for a bandwidth rate limit if set. If not set, then only the gateway ARN is returned.", - "id": "to-describe-the-bandwidth-rate-limits-of-a-gateway-1471384826404", - "title": "To describe the bandwidth rate limits of a gateway" - } - ], - "DescribeCache": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "CacheAllocatedInBytes": 2199023255552, - "CacheDirtyPercentage": 0.07, - "CacheHitPercentage": 99.68, - "CacheMissPercentage": 0.32, - "CacheUsedPercentage": 0.07, - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:04:00.0-scsi-0:1:0:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns information about the cache of a gateway.", - "id": "to-describe-cache-information-1471385756036", - "title": "To describe cache information" - } - ], - "DescribeCachediSCSIVolumes": [ - { - "input": { - "VolumeARNs": [ - "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - ] - }, - "output": { - "CachediSCSIVolumes": [ - { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeId": "vol-1122AABB", - "VolumeSizeInBytes": 1099511627776, - "VolumeStatus": "AVAILABLE", - "VolumeType": "CACHED iSCSI", - "VolumeiSCSIAttributes": { - "ChapEnabled": true, - "LunNumber": 1, - "NetworkInterfaceId": "10.243.43.207", - "NetworkInterfacePort": 3260, - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a description of the gateway cached iSCSI volumes specified in the request.", - "id": "to-describe-gateway-cached-iscsi-volumes-1471458094649", - "title": "To describe gateway cached iSCSI volumes" - } - ], - "DescribeChapCredentials": [ - { - "input": { - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - }, - "output": { - "ChapCredentials": [ - { - "InitiatorName": "iqn.1991-05.com.microsoft:computername.domain.example.com", - "SecretToAuthenticateInitiator": "111111111111", - "SecretToAuthenticateTarget": "222222222222", - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns an array of Challenge-Handshake Authentication Protocol (CHAP) credentials information for a specified iSCSI target, one for each target-initiator pair.", - "id": "to-describe-chap-credetnitals-for-an-iscsi-1471467462967", - "title": "To describe CHAP credetnitals for an iSCSI" - } - ], - "DescribeGatewayInformation": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "GatewayId": "sgw-AABB1122", - "GatewayName": "My_Gateway", - "GatewayNetworkInterfaces": [ - { - "Ipv4Address": "10.35.69.216" - } - ], - "GatewayState": "STATE_RUNNING", - "GatewayTimezone": "GMT-8:00", - "GatewayType": "STORED", - "LastSoftwareUpdate": "2016-01-02T16:00:00", - "NextUpdateAvailabilityDate": "2017-01-02T16:00:00" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns metadata about a gateway such as its name, network interfaces, configured time zone, and the state (whether the gateway is running or not).", - "id": "to-describe-metadata-about-the-gateway-1471467849079", - "title": "To describe metadata about the gateway" - } - ], - "DescribeMaintenanceStartTime": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "DayOfWeek": 2, - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "HourOfDay": 15, - "MinuteOfHour": 35, - "Timezone": "GMT+7:00" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns your gateway's weekly maintenance start time including the day and time of the week.", - "id": "to-describe-gateways-maintenance-start-time-1471470727387", - "title": "To describe gateway's maintenance start time" - } - ], - "DescribeSnapshotSchedule": [ - { - "input": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "Description": "sgw-AABB1122:vol-AABB1122:Schedule", - "RecurrenceInHours": 24, - "StartAt": 6, - "Timezone": "GMT+7:00", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Describes the snapshot schedule for the specified gateway volume including intervals at which snapshots are automatically initiated.", - "id": "to-describe-snapshot-schedule-for-gateway-volume-1471471139538", - "title": "To describe snapshot schedule for gateway volume" - } - ], - "DescribeStorediSCSIVolumes": [ - { - "input": { - "VolumeARNs": [ - "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - ] - }, - "output": { - "StorediSCSIVolumes": [ - { - "PreservedExistingData": false, - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeDiskId": "pci-0000:03:00.0-scsi-0:0:0:0", - "VolumeId": "vol-1122AABB", - "VolumeProgress": 23.7, - "VolumeSizeInBytes": 1099511627776, - "VolumeStatus": "BOOTSTRAPPING", - "VolumeiSCSIAttributes": { - "ChapEnabled": true, - "NetworkInterfaceId": "10.243.43.207", - "NetworkInterfacePort": 3260, - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - } - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns the description of the gateway volumes specified in the request belonging to the same gateway.", - "id": "to-describe-the-volumes-of-a-gateway-1471472640660", - "title": "To describe the volumes of a gateway" - } - ], - "DescribeTapeArchives": [ - { - "input": { - "Limit": 123, - "Marker": "1", - "TapeARNs": [ - "arn:aws:storagegateway:us-east-1:999999999999:tape/AM08A1AD", - "arn:aws:storagegateway:us-east-1:999999999999:tape/AMZN01A2A4" - ] - }, - "output": { - "Marker": "1", - "TapeArchives": [ - { - "CompletionTime": "2016-12-16T13:50Z", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999:tape/AM08A1AD", - "TapeBarcode": "AM08A1AD", - "TapeSizeInBytes": 107374182400, - "TapeStatus": "ARCHIVED" - }, - { - "CompletionTime": "2016-12-16T13:59Z", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999:tape/AMZN01A2A4", - "TapeBarcode": "AMZN01A2A4", - "TapeSizeInBytes": 429496729600, - "TapeStatus": "ARCHIVED" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a description of specified virtual tapes in the virtual tape shelf (VTS).", - "id": "to-describe-virtual-tapes-in-the-vts-1471473188198", - "title": "To describe virtual tapes in the VTS" - } - ], - "DescribeTapeRecoveryPoints": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "Limit": 1, - "Marker": "1" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "Marker": "1", - "TapeRecoveryPointInfos": [ - { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999:tape/AMZN01A2A4", - "TapeRecoveryPointTime": "2016-12-16T13:50Z", - "TapeSizeInBytes": 1471550497, - "TapeStatus": "AVAILABLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a list of virtual tape recovery points that are available for the specified gateway-VTL.", - "id": "to-describe-virtual-tape-recovery-points-1471542042026", - "title": "To describe virtual tape recovery points" - } - ], - "DescribeTapes": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "Limit": 2, - "Marker": "1", - "TapeARNs": [ - "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST04A2A1", - "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST05A2A0" - ] - }, - "output": { - "Marker": "1", - "Tapes": [ - { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST04A2A1", - "TapeBarcode": "TEST04A2A1", - "TapeSizeInBytes": 107374182400, - "TapeStatus": "AVAILABLE" - }, - { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST05A2A0", - "TapeBarcode": "TEST05A2A0", - "TapeSizeInBytes": 107374182400, - "TapeStatus": "AVAILABLE" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a description of the specified Amazon Resource Name (ARN) of virtual tapes. If a TapeARN is not specified, returns a description of all virtual tapes.", - "id": "to-describe-virtual-tapes-associated-with-gateway-1471629287727", - "title": "To describe virtual tape(s) associated with gateway" - } - ], - "DescribeUploadBuffer": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:04:00.0-scsi-0:1:0:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "UploadBufferAllocatedInBytes": 0, - "UploadBufferUsedInBytes": 161061273600 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns information about the upload buffer of a gateway including disk IDs and the amount of upload buffer space allocated/used.", - "id": "to-describe-upload-buffer-of-gateway-1471631099003", - "title": "To describe upload buffer of gateway" - }, - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:04:00.0-scsi-0:1:0:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "UploadBufferAllocatedInBytes": 161061273600, - "UploadBufferUsedInBytes": 0 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns information about the upload buffer of a gateway including disk IDs and the amount of upload buffer space allocated and used.", - "id": "to-describe-upload-buffer-of-a-gateway--1471904566370", - "title": "To describe upload buffer of a gateway" - } - ], - "DescribeVTLDevices": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "Limit": 123, - "Marker": "1", - "VTLDeviceARNs": [ - - ] - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "Marker": "1", - "VTLDevices": [ - { - "DeviceiSCSIAttributes": { - "ChapEnabled": false, - "NetworkInterfaceId": "10.243.43.207", - "NetworkInterfacePort": 3260, - "TargetARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:sgw-1fad4876-mediachanger" - }, - "VTLDeviceARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_MEDIACHANGER_00001", - "VTLDeviceProductIdentifier": "L700", - "VTLDeviceType": "Medium Changer", - "VTLDeviceVendor": "STK" - }, - { - "DeviceiSCSIAttributes": { - "ChapEnabled": false, - "NetworkInterfaceId": "10.243.43.209", - "NetworkInterfacePort": 3260, - "TargetARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:sgw-1fad4876-tapedrive-01" - }, - "VTLDeviceARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_TAPEDRIVE_00001", - "VTLDeviceProductIdentifier": "ULT3580-TD5", - "VTLDeviceType": "Tape Drive", - "VTLDeviceVendor": "IBM" - }, - { - "DeviceiSCSIAttributes": { - "ChapEnabled": false, - "NetworkInterfaceId": "10.243.43.209", - "NetworkInterfacePort": 3260, - "TargetARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:sgw-1fad4876-tapedrive-02" - }, - "VTLDeviceARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_TAPEDRIVE_00002", - "VTLDeviceProductIdentifier": "ULT3580-TD5", - "VTLDeviceType": "Tape Drive", - "VTLDeviceVendor": "IBM" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Returns a description of virtual tape library (VTL) devices for the specified gateway.", - "id": "to-describe-virtual-tape-library-vtl-devices-of-a-single-gateway-1471906071410", - "title": "To describe virtual tape library (VTL) devices of a single gateway" - } - ], - "DescribeWorkingStorage": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "DiskIds": [ - "pci-0000:03:00.0-scsi-0:0:0:0", - "pci-0000:03:00.0-scsi-0:0:1:0" - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "WorkingStorageAllocatedInBytes": 2199023255552, - "WorkingStorageUsedInBytes": 789207040 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation is supported only for the gateway-stored volume architecture. This operation is deprecated in cached-volumes API version (20120630). Use DescribeUploadBuffer instead.", - "id": "to-describe-the-working-storage-of-a-gateway-depreciated-1472070842332", - "title": "To describe the working storage of a gateway [Depreciated]" - } - ], - "DisableGateway": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Disables a gateway when the gateway is no longer functioning. Use this operation for a gateway-VTL that is not reachable or not functioning.", - "id": "to-disable-a-gateway-when-it-is-no-longer-functioning-1472076046936", - "title": "To disable a gateway when it is no longer functioning" - } - ], - "ListGateways": [ - { - "input": { - "Limit": 2, - "Marker": "1" - }, - "output": { - "Gateways": [ - { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-23A4567C" - } - ], - "Marker": "1" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists gateways owned by an AWS account in a specified region as requested. Results are sorted by gateway ARN up to a maximum of 100 gateways.", - "id": "to-lists-region-specific-gateways-per-aws-account-1472077860657", - "title": "To lists region specific gateways per AWS account" - } - ], - "ListLocalDisks": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "Disks": [ - { - "DiskAllocationType": "CACHE_STORAGE", - "DiskId": "pci-0000:03:00.0-scsi-0:0:0:0", - "DiskNode": "SCSI(0:0)", - "DiskPath": "/dev/sda", - "DiskSizeInBytes": 1099511627776, - "DiskStatus": "missing" - }, - { - "DiskAllocationResource": "", - "DiskAllocationType": "UPLOAD_BUFFER", - "DiskId": "pci-0000:03:00.0-scsi-0:0:1:0", - "DiskNode": "SCSI(0:1)", - "DiskPath": "/dev/sdb", - "DiskSizeInBytes": 1099511627776, - "DiskStatus": "present" - } - ], - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all.", - "id": "to-list-the-gateways-local-disks-1472079564618", - "title": "To list the gateway's local disks" - } - ], - "ListTagsForResource": [ - { - "input": { - "Limit": 1, - "Marker": "1", - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B" - }, - "output": { - "Marker": "1", - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B", - "Tags": [ - { - "Key": "Dev Gatgeway Region", - "Value": "East Coast" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the tags that have been added to the specified resource.", - "id": "to-list-tags-that-have-been-added-to-a-resource-1472080268972", - "title": "To list tags that have been added to a resource" - } - ], - "ListVolumeRecoveryPoints": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "VolumeRecoveryPointInfos": [ - { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeRecoveryPointTime": "2012-09-04T21:08:44.627Z", - "VolumeSizeInBytes": 536870912000 - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the recovery points for a specified gateway in which all data of the volume is consistent and can be used to create a snapshot.", - "id": "to-list-recovery-points-for-a-gateway-1472143015088", - "title": "To list recovery points for a gateway" - } - ], - "ListVolumes": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "Limit": 2, - "Marker": "1" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "Marker": "1", - "VolumeInfos": [ - { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "GatewayId": "sgw-12A3456B", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB", - "VolumeId": "vol-1122AABB", - "VolumeSizeInBytes": 107374182400, - "VolumeType": "STORED" - }, - { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-13B4567C", - "GatewayId": "sgw-gw-13B4567C", - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-13B4567C/volume/vol-3344CCDD", - "VolumeId": "vol-1122AABB", - "VolumeSizeInBytes": 107374182400, - "VolumeType": "STORED" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the iSCSI stored volumes of a gateway. Results are sorted by volume ARN up to a maximum of 100 volumes.", - "id": "to-list-the-iscsi-stored-volumes-of-a-gateway-1472145723653", - "title": "To list the iSCSI stored volumes of a gateway" - } - ], - "RemoveTagsFromResource": [ - { - "input": { - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B", - "TagKeys": [ - "Dev Gatgeway Region", - "East Coast" - ] - }, - "output": { - "ResourceARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-11A2222B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Lists the iSCSI stored volumes of a gateway. Removes one or more tags from the specified resource.", - "id": "to-remove-tags-from-a-resource-1472147210553", - "title": "To remove tags from a resource" - } - ], - "ResetCache": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-13B4567C" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-13B4567C" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Resets all cache disks that have encountered a error and makes the disks available for reconfiguration as cache storage.", - "id": "to-reset-cache-disks-in-error-status-1472148909807", - "title": "To reset cache disks in error status" - } - ], - "RetrieveTapeArchive": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Retrieves an archived virtual tape from the virtual tape shelf (VTS) to a gateway-VTL. Virtual tapes archived in the VTS are not associated with any gateway.", - "id": "to-retrieve-an-archived-tape-from-the-vts-1472149812358", - "title": "To retrieve an archived tape from the VTS" - } - ], - "RetrieveTapeRecoveryPoint": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF" - }, - "output": { - "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Retrieves the recovery point for the specified virtual tape.", - "id": "to-retrieve-the-recovery-point-of-a-virtual-tape-1472150014805", - "title": "To retrieve the recovery point of a virtual tape" - } - ], - "SetLocalConsolePassword": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B", - "LocalConsolePassword": "PassWordMustBeAtLeast6Chars." - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Sets the password for your VM local console.", - "id": "to-set-a-password-for-your-vm-1472150202632", - "title": "To set a password for your VM" - } - ], - "ShutdownGateway": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This operation shuts down the gateway service component running in the storage gateway's virtual machine (VM) and not the VM.", - "id": "to-shut-down-a-gateway-service-1472150508835", - "title": "To shut down a gateway service" - } - ], - "StartGateway": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Starts a gateway service that was previously shut down.", - "id": "to-start-a-gateway-service-1472150722315", - "title": "To start a gateway service" - } - ], - "UpdateBandwidthRateLimit": [ - { - "input": { - "AverageDownloadRateLimitInBitsPerSec": 102400, - "AverageUploadRateLimitInBitsPerSec": 51200, - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates the bandwidth rate limits of a gateway. Both the upload and download bandwidth rate limit can be set, or either one of the two. If a new limit is not set, the existing rate limit remains.", - "id": "to-update-the-bandwidth-rate-limits-of-a-gateway-1472151016202", - "title": "To update the bandwidth rate limits of a gateway" - } - ], - "UpdateChapCredentials": [ - { - "input": { - "InitiatorName": "iqn.1991-05.com.microsoft:computername.domain.example.com", - "SecretToAuthenticateInitiator": "111111111111", - "SecretToAuthenticateTarget": "222222222222", - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - }, - "output": { - "InitiatorName": "iqn.1991-05.com.microsoft:computername.domain.example.com", - "TargetARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates the Challenge-Handshake Authentication Protocol (CHAP) credentials for a specified iSCSI target.", - "id": "to-update-chap-credentials-for-an-iscsi-target-1472151325795", - "title": "To update CHAP credentials for an iSCSI target" - } - ], - "UpdateGatewayInformation": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "GatewayName": "MyGateway2", - "GatewayTimezone": "GMT-12:00" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "GatewayName": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates a gateway's metadata, which includes the gateway's name and time zone.", - "id": "to-update-a-gateways-metadata-1472151688693", - "title": "To update a gateway's metadata" - } - ], - "UpdateGatewaySoftwareNow": [ - { - "input": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.", - "id": "to-update-a-gateways-vm-software-1472152020929", - "title": "To update a gateway's VM software" - } - ], - "UpdateMaintenanceStartTime": [ - { - "input": { - "DayOfWeek": 2, - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B", - "HourOfDay": 0, - "MinuteOfHour": 30 - }, - "output": { - "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates a gateway's weekly maintenance start time information, including day and time of the week. The maintenance time is in your gateway's time zone.", - "id": "to-update-a-gateways-maintenance-start-time-1472152552031", - "title": "To update a gateway's maintenance start time" - } - ], - "UpdateSnapshotSchedule": [ - { - "input": { - "Description": "Hourly snapshot", - "RecurrenceInHours": 1, - "StartAt": 0, - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "output": { - "VolumeARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates a snapshot schedule configured for a gateway volume.", - "id": "to-update-a-volume-snapshot-schedule-1472152757068", - "title": "To update a volume snapshot schedule" - } - ], - "UpdateVTLDeviceType": [ - { - "input": { - "DeviceType": "Medium Changer", - "VTLDeviceARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_MEDIACHANGER_00001" - }, - "output": { - "VTLDeviceARN": "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_MEDIACHANGER_00001" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "Updates the type of medium changer in a gateway-VTL after a gateway-VTL is activated.", - "id": "to-update-a-vtl-device-type-1472153012967", - "title": "To update a VTL device type" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/paginators-1.json deleted file mode 100644 index b5e10c05..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "DescribeTapeArchives": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "TapeArchives" - }, - "DescribeTapeRecoveryPoints": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "TapeRecoveryPointInfos" - }, - "DescribeTapes": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "Tapes" - }, - "DescribeVTLDevices": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "VTLDevices" - }, - "ListGateways": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "Gateways" - }, - "ListVolumes": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "VolumeInfos" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/service-2.json deleted file mode 100644 index 54aab405..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/storagegateway/2013-06-30/service-2.json +++ /dev/null @@ -1,4109 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2013-06-30", - "endpointPrefix":"storagegateway", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Storage Gateway", - "serviceId":"Storage Gateway", - "signatureVersion":"v4", - "targetPrefix":"StorageGateway_20130630", - "uid":"storagegateway-2013-06-30" - }, - "operations":{ - "ActivateGateway":{ - "name":"ActivateGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ActivateGatewayInput"}, - "output":{"shape":"ActivateGatewayOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Activates the gateway you previously deployed on your host. In the activation process, you specify information such as the region you want to use for storing snapshots or tapes, the time zone for scheduled snapshots the gateway snapshot schedule window, an activation key, and a name for your gateway. The activation process also associates your gateway with your account; for more information, see UpdateGatewayInformation.

You must turn on the gateway VM before you can activate your gateway.

" - }, - "AddCache":{ - "name":"AddCache", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddCacheInput"}, - "output":{"shape":"AddCacheOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Configures one or more gateway local disks as cache for a gateway. This operation is only supported in the cached volume, tape and file gateway type (see Storage Gateway Concepts).

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to add cache, and one or more disk IDs that you want to configure as cache.

" - }, - "AddTagsToResource":{ - "name":"AddTagsToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddTagsToResourceInput"}, - "output":{"shape":"AddTagsToResourceOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Adds one or more tags to the specified resource. You use tags to add metadata to resources, which you can use to categorize these resources. For example, you can categorize resources by purpose, owner, environment, or team. Each tag consists of a key and a value, which you define. You can add tags to the following AWS Storage Gateway resources:

  • Storage gateways of all types

  • Storage Volumes

  • Virtual Tapes

You can create a maximum of 10 tags for each resource. Virtual tapes and storage volumes that are recovered to a new gateway maintain their tags.

" - }, - "AddUploadBuffer":{ - "name":"AddUploadBuffer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddUploadBufferInput"}, - "output":{"shape":"AddUploadBufferOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Configures one or more gateway local disks as upload buffer for a specified gateway. This operation is supported for the stored volume, cached volume and tape gateway types.

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to add upload buffer, and one or more disk IDs that you want to configure as upload buffer.

" - }, - "AddWorkingStorage":{ - "name":"AddWorkingStorage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddWorkingStorageInput"}, - "output":{"shape":"AddWorkingStorageOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Configures one or more gateway local disks as working storage for a gateway. This operation is only supported in the stored volume gateway type. This operation is deprecated in cached volume API version 20120630. Use AddUploadBuffer instead.

Working storage is also referred to as upload buffer. You can also use the AddUploadBuffer operation to add upload buffer to a stored volume gateway.

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to add working storage, and one or more disk IDs that you want to configure as working storage.

" - }, - "CancelArchival":{ - "name":"CancelArchival", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelArchivalInput"}, - "output":{"shape":"CancelArchivalOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Cancels archiving of a virtual tape to the virtual tape shelf (VTS) after the archiving process is initiated. This operation is only supported in the tape gateway type.

" - }, - "CancelRetrieval":{ - "name":"CancelRetrieval", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CancelRetrievalInput"}, - "output":{"shape":"CancelRetrievalOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) to a gateway after the retrieval process is initiated. The virtual tape is returned to the VTS. This operation is only supported in the tape gateway type.

" - }, - "CreateCachediSCSIVolume":{ - "name":"CreateCachediSCSIVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCachediSCSIVolumeInput"}, - "output":{"shape":"CreateCachediSCSIVolumeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a cached volume on a specified cached volume gateway. This operation is only supported in the cached volume gateway type.

Cache storage must be allocated to the gateway before you can create a cached volume. Use the AddCache operation to add cache storage to a gateway.

In the request, you must specify the gateway, size of the volume in bytes, the iSCSI target name, an IP address on which to expose the target, and a unique client token. In response, the gateway creates the volume and returns information about it. This information includes the volume Amazon Resource Name (ARN), its size, and the iSCSI target ARN that initiators can use to connect to the volume target.

Optionally, you can provide the ARN for an existing volume as the SourceVolumeARN for this cached volume, which creates an exact copy of the existing volume’s latest recovery point. The VolumeSizeInBytes value must be equal to or larger than the size of the copied volume, in bytes.

" - }, - "CreateNFSFileShare":{ - "name":"CreateNFSFileShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateNFSFileShareInput"}, - "output":{"shape":"CreateNFSFileShareOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a Network File System (NFS) file share on an existing file gateway. In Storage Gateway, a file share is a file system mount point backed by Amazon S3 cloud storage. Storage Gateway exposes file shares using a NFS interface. This operation is only supported for file gateways.

File gateway requires AWS Security Token Service (AWS STS) to be activated to enable you create a file share. Make sure AWS STS is activated in the region you are creating your file gateway in. If AWS STS is not activated in the region, activate it. For information about how to activate AWS STS, see Activating and Deactivating AWS STS in an AWS Region in the AWS Identity and Access Management User Guide.

File gateway does not support creating hard or symbolic links on a file share.

" - }, - "CreateSMBFileShare":{ - "name":"CreateSMBFileShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSMBFileShareInput"}, - "output":{"shape":"CreateSMBFileShareOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a Server Message Block (SMB) file share on an existing file gateway. In Storage Gateway, a file share is a file system mount point backed by Amazon S3 cloud storage. Storage Gateway expose file shares using a SMB interface. This operation is only supported for file gateways.

File gateways require AWS Security Token Service (AWS STS) to be activated to enable you to create a file share. Make sure that AWS STS is activated in the AWS Region you are creating your file gateway in. If AWS STS is not activated in this AWS Region, activate it. For information about how to activate AWS STS, see Activating and Deactivating AWS STS in an AWS Region in the AWS Identity and Access Management User Guide.

File gateways don't support creating hard or symbolic links on a file share.

" - }, - "CreateSnapshot":{ - "name":"CreateSnapshot", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotInput"}, - "output":{"shape":"CreateSnapshotOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableError"} - ], - "documentation":"

Initiates a snapshot of a volume.

AWS Storage Gateway provides the ability to back up point-in-time snapshots of your data to Amazon Simple Storage (S3) for durable off-site recovery, as well as import the data to an Amazon Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud (EC2). You can take snapshots of your gateway volume on a scheduled or ad-hoc basis. This API enables you to take ad-hoc snapshot. For more information, see Editing a Snapshot Schedule.

In the CreateSnapshot request you identify the volume by providing its Amazon Resource Name (ARN). You must also provide description for the snapshot. When AWS Storage Gateway takes the snapshot of specified volume, the snapshot and description appears in the AWS Storage Gateway Console. In response, AWS Storage Gateway returns you a snapshot ID. You can use this snapshot ID to check the snapshot progress or later use it when you want to create a volume from a snapshot. This operation is only supported in stored and cached volume gateway type.

To list or delete a snapshot, you must use the Amazon EC2 API. For more information, see DescribeSnapshots or DeleteSnapshot in the EC2 API reference.

Volume and snapshot IDs are changing to a longer length ID format. For more information, see the important note on the Welcome page.

" - }, - "CreateSnapshotFromVolumeRecoveryPoint":{ - "name":"CreateSnapshotFromVolumeRecoveryPoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSnapshotFromVolumeRecoveryPointInput"}, - "output":{"shape":"CreateSnapshotFromVolumeRecoveryPointOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"}, - {"shape":"ServiceUnavailableError"} - ], - "documentation":"

Initiates a snapshot of a gateway from a volume recovery point. This operation is only supported in the cached volume gateway type.

A volume recovery point is a point in time at which all data of the volume is consistent and from which you can create a snapshot. To get a list of volume recovery point for cached volume gateway, use ListVolumeRecoveryPoints.

In the CreateSnapshotFromVolumeRecoveryPoint request, you identify the volume by providing its Amazon Resource Name (ARN). You must also provide a description for the snapshot. When the gateway takes a snapshot of the specified volume, the snapshot and its description appear in the AWS Storage Gateway console. In response, the gateway returns you a snapshot ID. You can use this snapshot ID to check the snapshot progress or later use it when you want to create a volume from a snapshot.

To list or delete a snapshot, you must use the Amazon EC2 API. For more information, in Amazon Elastic Compute Cloud API Reference.

" - }, - "CreateStorediSCSIVolume":{ - "name":"CreateStorediSCSIVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateStorediSCSIVolumeInput"}, - "output":{"shape":"CreateStorediSCSIVolumeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a volume on a specified gateway. This operation is only supported in the stored volume gateway type.

The size of the volume to create is inferred from the disk size. You can choose to preserve existing data on the disk, create volume from an existing snapshot, or create an empty volume. If you choose to create an empty gateway volume, then any existing data on the disk is erased.

In the request you must specify the gateway and the disk information on which you are creating the volume. In response, the gateway creates the volume and returns volume information such as the volume Amazon Resource Name (ARN), its size, and the iSCSI target ARN that initiators can use to connect to the volume target.

" - }, - "CreateTapeWithBarcode":{ - "name":"CreateTapeWithBarcode", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTapeWithBarcodeInput"}, - "output":{"shape":"CreateTapeWithBarcodeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates a virtual tape by using your own barcode. You write data to the virtual tape and then archive the tape. A barcode is unique and can not be reused if it has already been used on a tape . This applies to barcodes used on deleted tapes. This operation is only supported in the tape gateway type.

Cache storage must be allocated to the gateway before you can create a virtual tape. Use the AddCache operation to add cache storage to a gateway.

" - }, - "CreateTapes":{ - "name":"CreateTapes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTapesInput"}, - "output":{"shape":"CreateTapesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Creates one or more virtual tapes. You write data to the virtual tapes and then archive the tapes. This operation is only supported in the tape gateway type.

Cache storage must be allocated to the gateway before you can create virtual tapes. Use the AddCache operation to add cache storage to a gateway.

" - }, - "DeleteBandwidthRateLimit":{ - "name":"DeleteBandwidthRateLimit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteBandwidthRateLimitInput"}, - "output":{"shape":"DeleteBandwidthRateLimitOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the bandwidth rate limits of a gateway. You can delete either the upload and download bandwidth rate limit, or you can delete both. If you delete only one of the limits, the other limit remains unchanged. To specify which gateway to work with, use the Amazon Resource Name (ARN) of the gateway in your request.

" - }, - "DeleteChapCredentials":{ - "name":"DeleteChapCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteChapCredentialsInput"}, - "output":{"shape":"DeleteChapCredentialsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes Challenge-Handshake Authentication Protocol (CHAP) credentials for a specified iSCSI target and initiator pair.

" - }, - "DeleteFileShare":{ - "name":"DeleteFileShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteFileShareInput"}, - "output":{"shape":"DeleteFileShareOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a file share from a file gateway. This operation is only supported for file gateways.

" - }, - "DeleteGateway":{ - "name":"DeleteGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGatewayInput"}, - "output":{"shape":"DeleteGatewayOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a gateway. To specify which gateway to delete, use the Amazon Resource Name (ARN) of the gateway in your request. The operation deletes the gateway; however, it does not delete the gateway virtual machine (VM) from your host computer.

After you delete a gateway, you cannot reactivate it. Completed snapshots of the gateway volumes are not deleted upon deleting the gateway, however, pending snapshots will not complete. After you delete a gateway, your next step is to remove it from your environment.

You no longer pay software charges after the gateway is deleted; however, your existing Amazon EBS snapshots persist and you will continue to be billed for these snapshots. You can choose to remove all remaining Amazon EBS snapshots by canceling your Amazon EC2 subscription.  If you prefer not to cancel your Amazon EC2 subscription, you can delete your snapshots using the Amazon EC2 console. For more information, see the AWS Storage Gateway Detail Page.

" - }, - "DeleteSnapshotSchedule":{ - "name":"DeleteSnapshotSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSnapshotScheduleInput"}, - "output":{"shape":"DeleteSnapshotScheduleOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes a snapshot of a volume.

You can take snapshots of your gateway volumes on a scheduled or ad hoc basis. This API action enables you to delete a snapshot schedule for a volume. For more information, see Working with Snapshots. In the DeleteSnapshotSchedule request, you identify the volume by providing its Amazon Resource Name (ARN). This operation is only supported in stored and cached volume gateway types.

To list or delete a snapshot, you must use the Amazon EC2 API. in Amazon Elastic Compute Cloud API Reference.

" - }, - "DeleteTape":{ - "name":"DeleteTape", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTapeInput"}, - "output":{"shape":"DeleteTapeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the specified virtual tape. This operation is only supported in the tape gateway type.

" - }, - "DeleteTapeArchive":{ - "name":"DeleteTapeArchive", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTapeArchiveInput"}, - "output":{"shape":"DeleteTapeArchiveOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the specified virtual tape from the virtual tape shelf (VTS). This operation is only supported in the tape gateway type.

" - }, - "DeleteVolume":{ - "name":"DeleteVolume", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVolumeInput"}, - "output":{"shape":"DeleteVolumeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Deletes the specified storage volume that you previously created using the CreateCachediSCSIVolume or CreateStorediSCSIVolume API. This operation is only supported in the cached volume and stored volume types. For stored volume gateways, the local disk that was configured as the storage volume is not deleted. You can reuse the local disk to create another storage volume.

Before you delete a volume, make sure there are no iSCSI connections to the volume you are deleting. You should also make sure there is no snapshot in progress. You can use the Amazon Elastic Compute Cloud (Amazon EC2) API to query snapshots on the volume you are deleting and check the snapshot status. For more information, go to DescribeSnapshots in the Amazon Elastic Compute Cloud API Reference.

In the request, you must provide the Amazon Resource Name (ARN) of the storage volume you want to delete.

" - }, - "DescribeBandwidthRateLimit":{ - "name":"DescribeBandwidthRateLimit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeBandwidthRateLimitInput"}, - "output":{"shape":"DescribeBandwidthRateLimitOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the bandwidth rate limits of a gateway. By default, these limits are not set, which means no bandwidth rate limiting is in effect.

This operation only returns a value for a bandwidth rate limit only if the limit is set. If no limits are set for the gateway, then this operation returns only the gateway ARN in the response body. To specify which gateway to describe, use the Amazon Resource Name (ARN) of the gateway in your request.

" - }, - "DescribeCache":{ - "name":"DescribeCache", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCacheInput"}, - "output":{"shape":"DescribeCacheOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about the cache of a gateway. This operation is only supported in the cached volume, tape and file gateway types.

The response includes disk IDs that are configured as cache, and it includes the amount of cache allocated and used.

" - }, - "DescribeCachediSCSIVolumes":{ - "name":"DescribeCachediSCSIVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCachediSCSIVolumesInput"}, - "output":{"shape":"DescribeCachediSCSIVolumesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a description of the gateway volumes specified in the request. This operation is only supported in the cached volume gateway types.

The list of gateway volumes in the request must be from one gateway. In the response Amazon Storage Gateway returns volume information sorted by volume Amazon Resource Name (ARN).

" - }, - "DescribeChapCredentials":{ - "name":"DescribeChapCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeChapCredentialsInput"}, - "output":{"shape":"DescribeChapCredentialsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns an array of Challenge-Handshake Authentication Protocol (CHAP) credentials information for a specified iSCSI target, one for each target-initiator pair.

" - }, - "DescribeGatewayInformation":{ - "name":"DescribeGatewayInformation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGatewayInformationInput"}, - "output":{"shape":"DescribeGatewayInformationOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns metadata about a gateway such as its name, network interfaces, configured time zone, and the state (whether the gateway is running or not). To specify which gateway to describe, use the Amazon Resource Name (ARN) of the gateway in your request.

" - }, - "DescribeMaintenanceStartTime":{ - "name":"DescribeMaintenanceStartTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeMaintenanceStartTimeInput"}, - "output":{"shape":"DescribeMaintenanceStartTimeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns your gateway's weekly maintenance start time including the day and time of the week. Note that values are in terms of the gateway's time zone.

" - }, - "DescribeNFSFileShares":{ - "name":"DescribeNFSFileShares", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeNFSFileSharesInput"}, - "output":{"shape":"DescribeNFSFileSharesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gets a description for one or more Network File System (NFS) file shares from a file gateway. This operation is only supported for file gateways.

" - }, - "DescribeSMBFileShares":{ - "name":"DescribeSMBFileShares", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSMBFileSharesInput"}, - "output":{"shape":"DescribeSMBFileSharesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gets a description for one or more Server Message Block (SMB) file shares from a file gateway. This operation is only supported for file gateways.

" - }, - "DescribeSMBSettings":{ - "name":"DescribeSMBSettings", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSMBSettingsInput"}, - "output":{"shape":"DescribeSMBSettingsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gets a description of a Server Message Block (SMB) file share settings from a file gateway. This operation is only supported for file gateways.

" - }, - "DescribeSnapshotSchedule":{ - "name":"DescribeSnapshotSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSnapshotScheduleInput"}, - "output":{"shape":"DescribeSnapshotScheduleOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Describes the snapshot schedule for the specified gateway volume. The snapshot schedule information includes intervals at which snapshots are automatically initiated on the volume. This operation is only supported in the cached volume and stored volume types.

" - }, - "DescribeStorediSCSIVolumes":{ - "name":"DescribeStorediSCSIVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeStorediSCSIVolumesInput"}, - "output":{"shape":"DescribeStorediSCSIVolumesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the description of the gateway volumes specified in the request. The list of gateway volumes in the request must be from one gateway. In the response Amazon Storage Gateway returns volume information sorted by volume ARNs. This operation is only supported in stored volume gateway type.

" - }, - "DescribeTapeArchives":{ - "name":"DescribeTapeArchives", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTapeArchivesInput"}, - "output":{"shape":"DescribeTapeArchivesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a description of specified virtual tapes in the virtual tape shelf (VTS). This operation is only supported in the tape gateway type.

If a specific TapeARN is not specified, AWS Storage Gateway returns a description of all virtual tapes found in the VTS associated with your account.

" - }, - "DescribeTapeRecoveryPoints":{ - "name":"DescribeTapeRecoveryPoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTapeRecoveryPointsInput"}, - "output":{"shape":"DescribeTapeRecoveryPointsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a list of virtual tape recovery points that are available for the specified tape gateway.

A recovery point is a point-in-time view of a virtual tape at which all the data on the virtual tape is consistent. If your gateway crashes, virtual tapes that have recovery points can be recovered to a new gateway. This operation is only supported in the tape gateway type.

" - }, - "DescribeTapes":{ - "name":"DescribeTapes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTapesInput"}, - "output":{"shape":"DescribeTapesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a description of the specified Amazon Resource Name (ARN) of virtual tapes. If a TapeARN is not specified, returns a description of all virtual tapes associated with the specified gateway. This operation is only supported in the tape gateway type.

" - }, - "DescribeUploadBuffer":{ - "name":"DescribeUploadBuffer", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUploadBufferInput"}, - "output":{"shape":"DescribeUploadBufferOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about the upload buffer of a gateway. This operation is supported for the stored volume, cached volume and tape gateway types.

The response includes disk IDs that are configured as upload buffer space, and it includes the amount of upload buffer space allocated and used.

" - }, - "DescribeVTLDevices":{ - "name":"DescribeVTLDevices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeVTLDevicesInput"}, - "output":{"shape":"DescribeVTLDevicesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a description of virtual tape library (VTL) devices for the specified tape gateway. In the response, AWS Storage Gateway returns VTL device information.

This operation is only supported in the tape gateway type.

" - }, - "DescribeWorkingStorage":{ - "name":"DescribeWorkingStorage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkingStorageInput"}, - "output":{"shape":"DescribeWorkingStorageOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about the working storage of a gateway. This operation is only supported in the stored volumes gateway type. This operation is deprecated in cached volumes API version (20120630). Use DescribeUploadBuffer instead.

Working storage is also referred to as upload buffer. You can also use the DescribeUploadBuffer operation to add upload buffer to a stored volume gateway.

The response includes disk IDs that are configured as working storage, and it includes the amount of working storage allocated and used.

" - }, - "DisableGateway":{ - "name":"DisableGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisableGatewayInput"}, - "output":{"shape":"DisableGatewayOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Disables a tape gateway when the gateway is no longer functioning. For example, if your gateway VM is damaged, you can disable the gateway so you can recover virtual tapes.

Use this operation for a tape gateway that is not reachable or not functioning. This operation is only supported in the tape gateway type.

Once a gateway is disabled it cannot be enabled.

" - }, - "JoinDomain":{ - "name":"JoinDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"JoinDomainInput"}, - "output":{"shape":"JoinDomainOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Adds a file gateway to an Active Directory domain. This operation is only supported for file gateways that support the SMB file protocol.

" - }, - "ListFileShares":{ - "name":"ListFileShares", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListFileSharesInput"}, - "output":{"shape":"ListFileSharesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Gets a list of the file shares for a specific file gateway, or the list of file shares that belong to the calling user account. This operation is only supported for file gateways.

" - }, - "ListGateways":{ - "name":"ListGateways", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGatewaysInput"}, - "output":{"shape":"ListGatewaysOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists gateways owned by an AWS account in a region specified in the request. The returned list is ordered by gateway Amazon Resource Name (ARN).

By default, the operation returns a maximum of 100 gateways. This operation supports pagination that allows you to optionally reduce the number of gateways returned in a response.

If you have more gateways than are returned in a response (that is, the response returns only a truncated list of your gateways), the response contains a marker that you can specify in your next request to fetch the next page of gateways.

" - }, - "ListLocalDisks":{ - "name":"ListLocalDisks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListLocalDisksInput"}, - "output":{"shape":"ListLocalDisksOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Returns a list of the gateway's local disks. To specify which gateway to describe, you use the Amazon Resource Name (ARN) of the gateway in the body of the request.

The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all. The response includes a DiskStatus field. This field can have a value of present (the disk is available to use), missing (the disk is no longer connected to the gateway), or mismatch (the disk node is occupied by a disk that has incorrect metadata or the disk content is corrupted).

" - }, - "ListTagsForResource":{ - "name":"ListTagsForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTagsForResourceInput"}, - "output":{"shape":"ListTagsForResourceOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the tags that have been added to the specified resource. This operation is only supported in the cached volume, stored volume and tape gateway type.

" - }, - "ListTapes":{ - "name":"ListTapes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTapesInput"}, - "output":{"shape":"ListTapesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists virtual tapes in your virtual tape library (VTL) and your virtual tape shelf (VTS). You specify the tapes to list by specifying one or more tape Amazon Resource Names (ARNs). If you don't specify a tape ARN, the operation lists all virtual tapes in both your VTL and VTS.

This operation supports pagination. By default, the operation returns a maximum of up to 100 tapes. You can optionally specify the Limit parameter in the body to limit the number of tapes in the response. If the number of tapes returned in the response is truncated, the response includes a Marker element that you can use in your subsequent request to retrieve the next set of tapes. This operation is only supported in the tape gateway type.

" - }, - "ListVolumeInitiators":{ - "name":"ListVolumeInitiators", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVolumeInitiatorsInput"}, - "output":{"shape":"ListVolumeInitiatorsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists iSCSI initiators that are connected to a volume. You can use this operation to determine whether a volume is being used or not. This operation is only supported in the cached volume and stored volume gateway types.

" - }, - "ListVolumeRecoveryPoints":{ - "name":"ListVolumeRecoveryPoints", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVolumeRecoveryPointsInput"}, - "output":{"shape":"ListVolumeRecoveryPointsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the recovery points for a specified gateway. This operation is only supported in the cached volume gateway type.

Each cache volume has one recovery point. A volume recovery point is a point in time at which all data of the volume is consistent and from which you can create a snapshot or clone a new cached volume from a source volume. To create a snapshot from a volume recovery point use the CreateSnapshotFromVolumeRecoveryPoint operation.

" - }, - "ListVolumes":{ - "name":"ListVolumes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVolumesInput"}, - "output":{"shape":"ListVolumesOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Lists the iSCSI stored volumes of a gateway. Results are sorted by volume ARN. The response includes only the volume ARNs. If you want additional volume information, use the DescribeStorediSCSIVolumes or the DescribeCachediSCSIVolumes API.

The operation supports pagination. By default, the operation returns a maximum of up to 100 volumes. You can optionally specify the Limit field in the body to limit the number of volumes in the response. If the number of volumes returned in the response is truncated, the response includes a Marker field. You can use this Marker value in your subsequent request to retrieve the next set of volumes. This operation is only supported in the cached volume and stored volume gateway types.

" - }, - "NotifyWhenUploaded":{ - "name":"NotifyWhenUploaded", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"NotifyWhenUploadedInput"}, - "output":{"shape":"NotifyWhenUploadedOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Sends you notification through CloudWatch Events when all files written to your NFS file share have been uploaded to Amazon S3.

AWS Storage Gateway can send a notification through Amazon CloudWatch Events when all files written to your file share up to that point in time have been uploaded to Amazon S3. These files include files written to the NFS file share up to the time that you make a request for notification. When the upload is done, Storage Gateway sends you notification through an Amazon CloudWatch Event. You can configure CloudWatch Events to send the notification through event targets such as Amazon SNS or AWS Lambda function. This operation is only supported for file gateways.

For more information, see Getting File Upload Notification in the Storage Gateway User Guide (https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-upload-notification).

" - }, - "RefreshCache":{ - "name":"RefreshCache", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RefreshCacheInput"}, - "output":{"shape":"RefreshCacheOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Refreshes the cache for the specified file share. This operation finds objects in the Amazon S3 bucket that were added, removed or replaced since the gateway last listed the bucket's contents and cached the results. This operation is only supported in the file gateway type.

" - }, - "RemoveTagsFromResource":{ - "name":"RemoveTagsFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RemoveTagsFromResourceInput"}, - "output":{"shape":"RemoveTagsFromResourceOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Removes one or more tags from the specified resource. This operation is only supported in the cached volume, stored volume and tape gateway types.

" - }, - "ResetCache":{ - "name":"ResetCache", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetCacheInput"}, - "output":{"shape":"ResetCacheOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Resets all cache disks that have encountered a error and makes the disks available for reconfiguration as cache storage. If your cache disk encounters a error, the gateway prevents read and write operations on virtual tapes in the gateway. For example, an error can occur when a disk is corrupted or removed from the gateway. When a cache is reset, the gateway loses its cache storage. At this point you can reconfigure the disks as cache disks. This operation is only supported in the cached volume and tape types.

If the cache disk you are resetting contains data that has not been uploaded to Amazon S3 yet, that data can be lost. After you reset cache disks, there will be no configured cache disks left in the gateway, so you must configure at least one new cache disk for your gateway to function properly.

" - }, - "RetrieveTapeArchive":{ - "name":"RetrieveTapeArchive", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetrieveTapeArchiveInput"}, - "output":{"shape":"RetrieveTapeArchiveOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves an archived virtual tape from the virtual tape shelf (VTS) to a tape gateway. Virtual tapes archived in the VTS are not associated with any gateway. However after a tape is retrieved, it is associated with a gateway, even though it is also listed in the VTS, that is, archive. This operation is only supported in the tape gateway type.

Once a tape is successfully retrieved to a gateway, it cannot be retrieved again to another gateway. You must archive the tape again before you can retrieve it to another gateway. This operation is only supported in the tape gateway type.

" - }, - "RetrieveTapeRecoveryPoint":{ - "name":"RetrieveTapeRecoveryPoint", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RetrieveTapeRecoveryPointInput"}, - "output":{"shape":"RetrieveTapeRecoveryPointOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Retrieves the recovery point for the specified virtual tape. This operation is only supported in the tape gateway type.

A recovery point is a point in time view of a virtual tape at which all the data on the tape is consistent. If your gateway crashes, virtual tapes that have recovery points can be recovered to a new gateway.

The virtual tape can be retrieved to only one gateway. The retrieved tape is read-only. The virtual tape can be retrieved to only a tape gateway. There is no charge for retrieving recovery points.

" - }, - "SetLocalConsolePassword":{ - "name":"SetLocalConsolePassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetLocalConsolePasswordInput"}, - "output":{"shape":"SetLocalConsolePasswordOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Sets the password for your VM local console. When you log in to the local console for the first time, you log in to the VM with the default credentials. We recommend that you set a new password. You don't need to know the default password to set a new password.

" - }, - "SetSMBGuestPassword":{ - "name":"SetSMBGuestPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SetSMBGuestPasswordInput"}, - "output":{"shape":"SetSMBGuestPasswordOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Sets the password for the guest user smbguest. The smbguest user is the user when the authentication method for the file share is set to GuestAccess.

" - }, - "ShutdownGateway":{ - "name":"ShutdownGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ShutdownGatewayInput"}, - "output":{"shape":"ShutdownGatewayOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Shuts down a gateway. To specify which gateway to shut down, use the Amazon Resource Name (ARN) of the gateway in the body of your request.

The operation shuts down the gateway service component running in the gateway's virtual machine (VM) and not the host VM.

If you want to shut down the VM, it is recommended that you first shut down the gateway component in the VM to avoid unpredictable conditions.

After the gateway is shutdown, you cannot call any other API except StartGateway, DescribeGatewayInformation, and ListGateways. For more information, see ActivateGateway. Your applications cannot read from or write to the gateway's storage volumes, and there are no snapshots taken.

When you make a shutdown request, you will get a 200 OK success response immediately. However, it might take some time for the gateway to shut down. You can call the DescribeGatewayInformation API to check the status. For more information, see ActivateGateway.

If do not intend to use the gateway again, you must delete the gateway (using DeleteGateway) to no longer pay software charges associated with the gateway.

" - }, - "StartGateway":{ - "name":"StartGateway", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartGatewayInput"}, - "output":{"shape":"StartGatewayOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Starts a gateway that you previously shut down (see ShutdownGateway). After the gateway starts, you can then make other API calls, your applications can read from or write to the gateway's storage volumes and you will be able to take snapshot backups.

When you make a request, you will get a 200 OK success response immediately. However, it might take some time for the gateway to be ready. You should call DescribeGatewayInformation and check the status before making any additional API calls. For more information, see ActivateGateway.

To specify which gateway to start, use the Amazon Resource Name (ARN) of the gateway in your request.

" - }, - "UpdateBandwidthRateLimit":{ - "name":"UpdateBandwidthRateLimit", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateBandwidthRateLimitInput"}, - "output":{"shape":"UpdateBandwidthRateLimitOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates the bandwidth rate limits of a gateway. You can update both the upload and download bandwidth rate limit or specify only one of the two. If you don't set a bandwidth rate limit, the existing rate limit remains.

By default, a gateway's bandwidth rate limits are not set. If you don't set any limit, the gateway does not have any limitations on its bandwidth usage and could potentially use the maximum available bandwidth.

To specify which gateway to update, use the Amazon Resource Name (ARN) of the gateway in your request.

" - }, - "UpdateChapCredentials":{ - "name":"UpdateChapCredentials", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateChapCredentialsInput"}, - "output":{"shape":"UpdateChapCredentialsOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates the Challenge-Handshake Authentication Protocol (CHAP) credentials for a specified iSCSI target. By default, a gateway does not have CHAP enabled; however, for added security, you might use it.

When you update CHAP credentials, all existing connections on the target are closed and initiators must reconnect with the new credentials.

" - }, - "UpdateGatewayInformation":{ - "name":"UpdateGatewayInformation", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGatewayInformationInput"}, - "output":{"shape":"UpdateGatewayInformationOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates a gateway's metadata, which includes the gateway's name and time zone. To specify which gateway to update, use the Amazon Resource Name (ARN) of the gateway in your request.

For Gateways activated after September 2, 2015, the gateway's ARN contains the gateway ID rather than the gateway name. However, changing the name of the gateway has no effect on the gateway's ARN.

" - }, - "UpdateGatewaySoftwareNow":{ - "name":"UpdateGatewaySoftwareNow", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGatewaySoftwareNowInput"}, - "output":{"shape":"UpdateGatewaySoftwareNowOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.

When you make this request, you get a 200 OK success response immediately. However, it might take some time for the update to complete. You can call DescribeGatewayInformation to verify the gateway is in the STATE_RUNNING state.

A software update forces a system restart of your gateway. You can minimize the chance of any disruption to your applications by increasing your iSCSI Initiators' timeouts. For more information about increasing iSCSI Initiator timeouts for Windows and Linux, see Customizing Your Windows iSCSI Settings and Customizing Your Linux iSCSI Settings, respectively.

" - }, - "UpdateMaintenanceStartTime":{ - "name":"UpdateMaintenanceStartTime", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateMaintenanceStartTimeInput"}, - "output":{"shape":"UpdateMaintenanceStartTimeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates a gateway's weekly maintenance start time information, including day and time of the week. The maintenance time is the time in your gateway's time zone.

" - }, - "UpdateNFSFileShare":{ - "name":"UpdateNFSFileShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateNFSFileShareInput"}, - "output":{"shape":"UpdateNFSFileShareOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates a Network File System (NFS) file share. This operation is only supported in the file gateway type.

To leave a file share field unchanged, set the corresponding input field to null.

Updates the following file share setting:

  • Default storage class for your S3 bucket

  • Metadata defaults for your S3 bucket

  • Allowed NFS clients for your file share

  • Squash settings

  • Write status of your file share

To leave a file share field unchanged, set the corresponding input field to null. This operation is only supported in file gateways.

" - }, - "UpdateSMBFileShare":{ - "name":"UpdateSMBFileShare", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSMBFileShareInput"}, - "output":{"shape":"UpdateSMBFileShareOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates a Server Message Block (SMB) file share.

To leave a file share field unchanged, set the corresponding input field to null. This operation is only supported for file gateways.

File gateways require AWS Security Token Service (AWS STS) to be activated to enable you to create a file share. Make sure that AWS STS is activated in the AWS Region you are creating your file gateway in. If AWS STS is not activated in this AWS Region, activate it. For information about how to activate AWS STS, see Activating and Deactivating AWS STS in an AWS Region in the AWS Identity and Access Management User Guide.

File gateways don't support creating hard or symbolic links on a file share.

" - }, - "UpdateSnapshotSchedule":{ - "name":"UpdateSnapshotSchedule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSnapshotScheduleInput"}, - "output":{"shape":"UpdateSnapshotScheduleOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates a snapshot schedule configured for a gateway volume. This operation is only supported in the cached volume and stored volume gateway types.

The default snapshot schedule for volume is once every 24 hours, starting at the creation time of the volume. You can use this API to change the snapshot schedule configured for the volume.

In the request you must identify the gateway volume whose snapshot schedule you want to update, and the schedule information, including when you want the snapshot to begin on a day and the frequency (in hours) of snapshots.

" - }, - "UpdateVTLDeviceType":{ - "name":"UpdateVTLDeviceType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateVTLDeviceTypeInput"}, - "output":{"shape":"UpdateVTLDeviceTypeOutput"}, - "errors":[ - {"shape":"InvalidGatewayRequestException"}, - {"shape":"InternalServerError"} - ], - "documentation":"

Updates the type of medium changer in a tape gateway. When you activate a tape gateway, you select a medium changer type for the tape gateway. This operation enables you to select a different type of medium changer after a tape gateway is activated. This operation is only supported in the tape gateway type.

" - } - }, - "shapes":{ - "ActivateGatewayInput":{ - "type":"structure", - "required":[ - "ActivationKey", - "GatewayName", - "GatewayTimezone", - "GatewayRegion" - ], - "members":{ - "ActivationKey":{ - "shape":"ActivationKey", - "documentation":"

Your gateway activation key. You can obtain the activation key by sending an HTTP GET request with redirects enabled to the gateway IP address (port 80). The redirect URL returned in the response provides you the activation key for your gateway in the query string parameter activationKey. It may also include other activation-related parameters, however, these are merely defaults -- the arguments you pass to the ActivateGateway API call determine the actual configuration of your gateway.

For more information, see https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html in the Storage Gateway User Guide.

" - }, - "GatewayName":{ - "shape":"GatewayName", - "documentation":"

The name you configured for your gateway.

" - }, - "GatewayTimezone":{ - "shape":"GatewayTimezone", - "documentation":"

A value that indicates the time zone you want to set for the gateway. The time zone is of the format \"GMT-hr:mm\" or \"GMT+hr:mm\". For example, GMT-4:00 indicates the time is 4 hours behind GMT. GMT+2:00 indicates the time is 2 hours ahead of GMT. The time zone is used, for example, for scheduling snapshots and your gateway's maintenance schedule.

" - }, - "GatewayRegion":{ - "shape":"RegionId", - "documentation":"

A value that indicates the region where you want to store your data. The gateway region specified must be the same region as the region in your Host header in the request. For more information about available regions and endpoints for AWS Storage Gateway, see Regions and Endpoints in the Amazon Web Services Glossary.

Valid Values: \"us-east-1\", \"us-east-2\", \"us-west-1\", \"us-west-2\", \"ca-central-1\", \"eu-west-1\", \"eu-central-1\", \"eu-west-2\", \"eu-west-3\", \"ap-northeast-1\", \"ap-northeast-2\", \"ap-southeast-1\", \"ap-southeast-2\", \"ap-south-1\", \"sa-east-1\"

" - }, - "GatewayType":{ - "shape":"GatewayType", - "documentation":"

A value that defines the type of gateway to activate. The type specified is critical to all later functions of the gateway and cannot be changed after activation. The default value is STORED.

Valid Values: \"STORED\", \"CACHED\", \"VTL\", \"FILE_S3\"

" - }, - "TapeDriveType":{ - "shape":"TapeDriveType", - "documentation":"

The value that indicates the type of tape drive to use for tape gateway. This field is optional.

Valid Values: \"IBM-ULT3580-TD5\"

" - }, - "MediumChangerType":{ - "shape":"MediumChangerType", - "documentation":"

The value that indicates the type of medium changer to use for tape gateway. This field is optional.

Valid Values: \"STK-L700\", \"AWS-Gateway-VTL\"

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "ActivateGatewayOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

AWS Storage Gateway returns the Amazon Resource Name (ARN) of the activated gateway. It is a string made of information such as your account, gateway name, and region. This ARN is used to reference the gateway in other API operations as well as resource-based authorization.

For gateways activated prior to September 02, 2015, the gateway ARN contains the gateway name rather than the gateway ID. Changing the name of the gateway has no effect on the gateway ARN.

" - }, - "ActivationKey":{ - "type":"string", - "max":50, - "min":1 - }, - "AddCacheInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "DiskIds" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{"shape":"DiskIds"} - } - }, - "AddCacheOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "AddTagsToResourceInput":{ - "type":"structure", - "required":[ - "ResourceARN", - "Tags" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource you want to add tags to.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

The key-value pair that represents the tag you want to add to the resource. The value can be an empty string.

Valid characters for key and value are letters, spaces, and numbers representable in UTF-8 format, and the following special characters: + - = . _ : / @.

" - } - }, - "documentation":"

AddTagsToResourceInput

" - }, - "AddTagsToResourceOutput":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource you want to add tags to.

" - } - }, - "documentation":"

AddTagsToResourceOutput

" - }, - "AddUploadBufferInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "DiskIds" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{"shape":"DiskIds"} - } - }, - "AddUploadBufferOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "AddWorkingStorageInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "DiskIds" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{ - "shape":"DiskIds", - "documentation":"

An array of strings that identify disks that are to be configured as working storage. Each string have a minimum length of 1 and maximum length of 300. You can get the disk IDs from the ListLocalDisks API.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "AddWorkingStorageOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway for which working storage was configured.

" - }, - "Authentication":{ - "type":"string", - "documentation":"

The authentication method of the file share.

Valid values are ActiveDirectory or GuestAccess. The default is ActiveDirectory.

", - "max":15, - "min":5 - }, - "BandwidthDownloadRateLimit":{ - "type":"long", - "min":102400 - }, - "BandwidthType":{ - "type":"string", - "max":25, - "min":3 - }, - "BandwidthUploadRateLimit":{ - "type":"long", - "min":51200 - }, - "Boolean":{"type":"boolean"}, - "CachediSCSIVolume":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the storage volume.

" - }, - "VolumeId":{ - "shape":"VolumeId", - "documentation":"

The unique identifier of the volume, e.g. vol-AE4B946D.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

One of the VolumeType enumeration values that describes the type of the volume.

" - }, - "VolumeStatus":{ - "shape":"VolumeStatus", - "documentation":"

One of the VolumeStatus values that indicates the state of the storage volume.

" - }, - "VolumeSizeInBytes":{ - "shape":"long", - "documentation":"

The size, in bytes, of the volume capacity.

" - }, - "VolumeProgress":{ - "shape":"DoubleObject", - "documentation":"

Represents the percentage complete if the volume is restoring or bootstrapping that represents the percent of data transferred. This field does not appear in the response if the cached volume is not restoring or bootstrapping.

" - }, - "SourceSnapshotId":{ - "shape":"SnapshotId", - "documentation":"

If the cached volume was created from a snapshot, this field contains the snapshot ID used, e.g. snap-78e22663. Otherwise, this field is not included.

" - }, - "VolumeiSCSIAttributes":{ - "shape":"VolumeiSCSIAttributes", - "documentation":"

An VolumeiSCSIAttributes object that represents a collection of iSCSI attributes for one stored volume.

" - }, - "CreatedDate":{ - "shape":"CreatedDate", - "documentation":"

The date the volume was created. Volumes created prior to March 28, 2017 don’t have this time stamp.

" - }, - "VolumeUsedInBytes":{ - "shape":"VolumeUsedInBytes", - "documentation":"

The size of the data stored on the volume in bytes.

This value is not available for volumes created prior to May 13, 2015, until you store data on the volume.

" - }, - "KMSKey":{"shape":"KMSKey"} - }, - "documentation":"

Describes an iSCSI cached volume.

" - }, - "CachediSCSIVolumes":{ - "type":"list", - "member":{"shape":"CachediSCSIVolume"} - }, - "CancelArchivalInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "TapeARN" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape you want to cancel archiving for.

" - } - }, - "documentation":"

CancelArchivalInput

" - }, - "CancelArchivalOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape for which archiving was canceled.

" - } - }, - "documentation":"

CancelArchivalOutput

" - }, - "CancelRetrievalInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "TapeARN" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape you want to cancel retrieval for.

" - } - }, - "documentation":"

CancelRetrievalInput

" - }, - "CancelRetrievalOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape for which retrieval was canceled.

" - } - }, - "documentation":"

CancelRetrievalOutput

" - }, - "ChapCredentials":{ - "type":"list", - "member":{"shape":"ChapInfo"} - }, - "ChapInfo":{ - "type":"structure", - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume.

Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and hyphens (-).

" - }, - "SecretToAuthenticateInitiator":{ - "shape":"ChapSecret", - "documentation":"

The secret key that the initiator (for example, the Windows client) must provide to participate in mutual CHAP with the target.

" - }, - "InitiatorName":{ - "shape":"IqnName", - "documentation":"

The iSCSI initiator that connects to the target.

" - }, - "SecretToAuthenticateTarget":{ - "shape":"ChapSecret", - "documentation":"

The secret key that the target must provide to participate in mutual CHAP with the initiator (e.g. Windows client).

" - } - }, - "documentation":"

Describes Challenge-Handshake Authentication Protocol (CHAP) information that supports authentication between your gateway and iSCSI initiators.

" - }, - "ChapSecret":{ - "type":"string", - "max":100, - "min":1 - }, - "ClientToken":{ - "type":"string", - "max":100, - "min":5 - }, - "CreateCachediSCSIVolumeInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "VolumeSizeInBytes", - "TargetName", - "NetworkInterfaceId", - "ClientToken" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "VolumeSizeInBytes":{ - "shape":"long", - "documentation":"

The size of the volume in bytes.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The snapshot ID (e.g. \"snap-1122aabb\") of the snapshot to restore as the new cached volume. Specify this field if you want to create the iSCSI storage volume from a snapshot otherwise do not include this field. To list snapshots for your account use DescribeSnapshots in the Amazon Elastic Compute Cloud API Reference.

" - }, - "TargetName":{ - "shape":"TargetName", - "documentation":"

The name of the iSCSI target used by initiators to connect to the target and as a suffix for the target ARN. For example, specifying TargetName as myvolume results in the target ARN of arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume. The target name must be unique across all volumes of a gateway.

" - }, - "SourceVolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The ARN for an existing volume. Specifying this ARN makes the new volume into an exact copy of the specified existing volume's latest recovery point. The VolumeSizeInBytes value for this new volume must be equal to or larger than the size of the existing volume, in bytes.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

The network interface of the gateway on which to expose the iSCSI target. Only IPv4 addresses are accepted. Use DescribeGatewayInformation to get a list of the network interfaces available on a gateway.

Valid Values: A valid IP address.

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique identifier that you use to retry a request. If you retry a request, use the same ClientToken you specified in the initial request.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - } - } - }, - "CreateCachediSCSIVolumeOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the configured volume.

" - }, - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

he Amazon Resource Name (ARN) of the volume target that includes the iSCSI name that initiators can use to connect to the target.

" - } - } - }, - "CreateNFSFileShareInput":{ - "type":"structure", - "required":[ - "ClientToken", - "GatewayARN", - "Role", - "LocationARN" - ], - "members":{ - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique string value that you supply that is used by file gateway to ensure idempotent file share creation.

" - }, - "NFSFileShareDefaults":{ - "shape":"NFSFileShareDefaults", - "documentation":"

File share default values. Optional.

" - }, - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the file gateway on which you want to create a file share.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The ARN of the AWS Identity and Access Management (IAM) role that a file gateway assumes when it accesses the underlying storage.

" - }, - "LocationARN":{ - "shape":"LocationARN", - "documentation":"

The ARN of the backed storage used for storing file data.

" - }, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{ - "shape":"ObjectACL", - "documentation":"

A value that sets the access control list permission for objects in the S3 bucket that a file gateway puts objects into. The default value is \"private\".

" - }, - "ClientList":{ - "shape":"FileShareClientList", - "documentation":"

The list of clients that are allowed to access the file gateway. The list must contain either valid IP addresses or valid CIDR blocks.

" - }, - "Squash":{ - "shape":"Squash", - "documentation":"

Maps a user to anonymous user. Valid options are the following:

  • RootSquash - Only root is mapped to anonymous user.

  • NoSquash - No one is mapped to anonymous user

  • AllSquash - Everyone is mapped to anonymous user.

" - }, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - } - }, - "documentation":"

CreateNFSFileShareInput

" - }, - "CreateNFSFileShareOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the newly created file share.

" - } - }, - "documentation":"

CreateNFSFileShareOutput

" - }, - "CreateSMBFileShareInput":{ - "type":"structure", - "required":[ - "ClientToken", - "GatewayARN", - "Role", - "LocationARN" - ], - "members":{ - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique string value that you supply that is used by file gateway to ensure idempotent file share creation.

" - }, - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the file gateway on which you want to create a file share.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - }, - "Role":{ - "shape":"Role", - "documentation":"

The ARN of the AWS Identity and Access Management (IAM) role that a file gateway assumes when it accesses the underlying storage.

" - }, - "LocationARN":{ - "shape":"LocationARN", - "documentation":"

The ARN of the backed storage used for storing file data.

" - }, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{ - "shape":"ObjectACL", - "documentation":"

A value that sets the access control list permission for objects in the S3 bucket that a file gateway puts objects into. The default value is \"private\".

" - }, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - }, - "ValidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - }, - "InvalidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are not allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - }, - "Authentication":{ - "shape":"Authentication", - "documentation":"

The authentication method that users use to access the file share.

Valid values are ActiveDirectory or GuestAccess. The default is ActiveDirectory.

" - } - }, - "documentation":"

CreateSMBFileShareInput

" - }, - "CreateSMBFileShareOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the newly created file share.

" - } - }, - "documentation":"

CreateSMBFileShareOutput

" - }, - "CreateSnapshotFromVolumeRecoveryPointInput":{ - "type":"structure", - "required":[ - "VolumeARN", - "SnapshotDescription" - ], - "members":{ - "VolumeARN":{"shape":"VolumeARN"}, - "SnapshotDescription":{"shape":"SnapshotDescription"} - } - }, - "CreateSnapshotFromVolumeRecoveryPointOutput":{ - "type":"structure", - "members":{ - "SnapshotId":{"shape":"SnapshotId"}, - "VolumeARN":{"shape":"VolumeARN"}, - "VolumeRecoveryPointTime":{"shape":"string"} - } - }, - "CreateSnapshotInput":{ - "type":"structure", - "required":[ - "VolumeARN", - "SnapshotDescription" - ], - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

" - }, - "SnapshotDescription":{ - "shape":"SnapshotDescription", - "documentation":"

Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "CreateSnapshotOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume of which the snapshot was taken.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The snapshot ID that is used to refer to the snapshot in future operations such as describing snapshots (Amazon Elastic Compute Cloud API DescribeSnapshots) or creating a volume from a snapshot (CreateStorediSCSIVolume).

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "CreateStorediSCSIVolumeInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "DiskId", - "PreserveExistingData", - "TargetName", - "NetworkInterfaceId" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskId":{ - "shape":"DiskId", - "documentation":"

The unique identifier for the gateway local disk that is configured as a stored volume. Use ListLocalDisks to list disk IDs for a gateway.

" - }, - "SnapshotId":{ - "shape":"SnapshotId", - "documentation":"

The snapshot ID (e.g. \"snap-1122aabb\") of the snapshot to restore as the new stored volume. Specify this field if you want to create the iSCSI storage volume from a snapshot otherwise do not include this field. To list snapshots for your account use DescribeSnapshots in the Amazon Elastic Compute Cloud API Reference.

" - }, - "PreserveExistingData":{ - "shape":"boolean", - "documentation":"

Specify this field as true if you want to preserve the data on the local disk. Otherwise, specifying this field as false creates an empty volume.

Valid Values: true, false

" - }, - "TargetName":{ - "shape":"TargetName", - "documentation":"

The name of the iSCSI target used by initiators to connect to the target and as a suffix for the target ARN. For example, specifying TargetName as myvolume results in the target ARN of arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume. The target name must be unique across all volumes of a gateway.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

The network interface of the gateway on which to expose the iSCSI target. Only IPv4 addresses are accepted. Use DescribeGatewayInformation to get a list of the network interfaces available on a gateway.

Valid Values: A valid IP address.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "CreateStorediSCSIVolumeOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the configured volume.

" - }, - "VolumeSizeInBytes":{ - "shape":"long", - "documentation":"

The size of the volume in bytes.

" - }, - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

he Amazon Resource Name (ARN) of the volume target that includes the iSCSI name that initiators can use to connect to the target.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "CreateTapeWithBarcodeInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "TapeSizeInBytes", - "TapeBarcode" - ], - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) that represents the gateway to associate the virtual tape with. Use the ListGateways operation to return a list of gateways for your account and region.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of the virtual tape that you want to create.

The size must be aligned by gigabyte (1024*1024*1024 byte).

" - }, - "TapeBarcode":{ - "shape":"TapeBarcode", - "documentation":"

The barcode that you want to assign to the tape.

Barcodes cannot be reused. This includes barcodes used for tapes that have been deleted.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS Key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - } - }, - "documentation":"

CreateTapeWithBarcodeInput

" - }, - "CreateTapeWithBarcodeOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

A unique Amazon Resource Name (ARN) that represents the virtual tape that was created.

" - } - }, - "documentation":"

CreateTapeOutput

" - }, - "CreateTapesInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "TapeSizeInBytes", - "ClientToken", - "NumTapesToCreate", - "TapeBarcodePrefix" - ], - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) that represents the gateway to associate the virtual tapes with. Use the ListGateways operation to return a list of gateways for your account and region.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of the virtual tapes that you want to create.

The size must be aligned by gigabyte (1024*1024*1024 byte).

" - }, - "ClientToken":{ - "shape":"ClientToken", - "documentation":"

A unique identifier that you use to retry a request. If you retry a request, use the same ClientToken you specified in the initial request.

Using the same ClientToken prevents creating the tape multiple times.

" - }, - "NumTapesToCreate":{ - "shape":"NumTapesToCreate", - "documentation":"

The number of virtual tapes that you want to create.

" - }, - "TapeBarcodePrefix":{ - "shape":"TapeBarcodePrefix", - "documentation":"

A prefix that you append to the barcode of the virtual tape you are creating. This prefix makes the barcode unique.

The prefix must be 1 to 4 characters in length and must be one of the uppercase letters from A to Z.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - } - }, - "documentation":"

CreateTapesInput

" - }, - "CreateTapesOutput":{ - "type":"structure", - "members":{ - "TapeARNs":{ - "shape":"TapeARNs", - "documentation":"

A list of unique Amazon Resource Names (ARNs) that represents the virtual tapes that were created.

" - } - }, - "documentation":"

CreateTapeOutput

" - }, - "CreatedDate":{"type":"timestamp"}, - "DayOfWeek":{ - "type":"integer", - "max":6, - "min":0 - }, - "DeleteBandwidthRateLimitInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "BandwidthType" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "BandwidthType":{ - "shape":"BandwidthType", - "documentation":"

One of the BandwidthType values that indicates the gateway bandwidth rate limit to delete.

Valid Values: Upload, Download, All.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DeleteBandwidthRateLimitOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway whose bandwidth rate information was deleted.

" - }, - "DeleteChapCredentialsInput":{ - "type":"structure", - "required":[ - "TargetARN", - "InitiatorName" - ], - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the iSCSI volume target. Use the DescribeStorediSCSIVolumes operation to return to retrieve the TargetARN for specified VolumeARN.

" - }, - "InitiatorName":{ - "shape":"IqnName", - "documentation":"

The iSCSI initiator that connects to the target.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "DeleteChapCredentialsOutput":{ - "type":"structure", - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the target.

" - }, - "InitiatorName":{ - "shape":"IqnName", - "documentation":"

The iSCSI initiator that connects to the target.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DeleteFileShareInput":{ - "type":"structure", - "required":["FileShareARN"], - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the file share to be deleted.

" - }, - "ForceDelete":{ - "shape":"boolean", - "documentation":"

If this value is set to true, the operation deletes a file share immediately and aborts all data uploads to AWS. Otherwise, the file share is not deleted until all data is uploaded to AWS. This process aborts the data upload process, and the file share enters the FORCE_DELETING status.

" - } - }, - "documentation":"

DeleteFileShareInput

" - }, - "DeleteFileShareOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the deleted file share.

" - } - }, - "documentation":"

DeleteFileShareOutput

" - }, - "DeleteGatewayInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the ID of the gateway to delete.

" - }, - "DeleteGatewayOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the ID of the deleted gateway.

" - }, - "DeleteSnapshotScheduleInput":{ - "type":"structure", - "required":["VolumeARN"], - "members":{ - "VolumeARN":{"shape":"VolumeARN"} - } - }, - "DeleteSnapshotScheduleOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{"shape":"VolumeARN"} - } - }, - "DeleteTapeArchiveInput":{ - "type":"structure", - "required":["TapeARN"], - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape to delete from the virtual tape shelf (VTS).

" - } - }, - "documentation":"

DeleteTapeArchiveInput

" - }, - "DeleteTapeArchiveOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape that was deleted from the virtual tape shelf (VTS).

" - } - }, - "documentation":"

DeleteTapeArchiveOutput

" - }, - "DeleteTapeInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "TapeARN" - ], - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) of the gateway that the virtual tape to delete is associated with. Use the ListGateways operation to return a list of gateways for your account and region.

" - }, - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape to delete.

" - } - }, - "documentation":"

DeleteTapeInput

" - }, - "DeleteTapeOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the deleted virtual tape.

" - } - }, - "documentation":"

DeleteTapeOutput

" - }, - "DeleteVolumeInput":{ - "type":"structure", - "required":["VolumeARN"], - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

" - } - }, - "documentation":"

A JSON object containing the DeleteVolumeInput$VolumeARN to delete.

" - }, - "DeleteVolumeOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the storage volume that was deleted. It is the same ARN you provided in the request.

" - } - }, - "documentation":"

A JSON object containing the of the storage volume that was deleted

" - }, - "DescribeBandwidthRateLimitInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway.

" - }, - "DescribeBandwidthRateLimitOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "AverageUploadRateLimitInBitsPerSec":{ - "shape":"BandwidthUploadRateLimit", - "documentation":"

The average upload bandwidth rate limit in bits per second. This field does not appear in the response if the upload rate limit is not set.

" - }, - "AverageDownloadRateLimitInBitsPerSec":{ - "shape":"BandwidthDownloadRateLimit", - "documentation":"

The average download bandwidth rate limit in bits per second. This field does not appear in the response if the download rate limit is not set.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DescribeCacheInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "DescribeCacheOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{"shape":"DiskIds"}, - "CacheAllocatedInBytes":{"shape":"long"}, - "CacheUsedPercentage":{"shape":"double"}, - "CacheDirtyPercentage":{"shape":"double"}, - "CacheHitPercentage":{"shape":"double"}, - "CacheMissPercentage":{"shape":"double"} - } - }, - "DescribeCachediSCSIVolumesInput":{ - "type":"structure", - "required":["VolumeARNs"], - "members":{ - "VolumeARNs":{"shape":"VolumeARNs"} - } - }, - "DescribeCachediSCSIVolumesOutput":{ - "type":"structure", - "members":{ - "CachediSCSIVolumes":{ - "shape":"CachediSCSIVolumes", - "documentation":"

An array of objects where each object contains metadata about one cached volume.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DescribeChapCredentialsInput":{ - "type":"structure", - "required":["TargetARN"], - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the iSCSI volume target. Use the DescribeStorediSCSIVolumes operation to return to retrieve the TargetARN for specified VolumeARN.

" - } - }, - "documentation":"

A JSON object containing the Amazon Resource Name (ARN) of the iSCSI volume target.

" - }, - "DescribeChapCredentialsOutput":{ - "type":"structure", - "members":{ - "ChapCredentials":{ - "shape":"ChapCredentials", - "documentation":"

An array of ChapInfo objects that represent CHAP credentials. Each object in the array contains CHAP credential information for one target-initiator pair. If no CHAP credentials are set, an empty array is returned. CHAP credential information is provided in a JSON object with the following fields:

  • InitiatorName: The iSCSI initiator that connects to the target.

  • SecretToAuthenticateInitiator: The secret key that the initiator (for example, the Windows client) must provide to participate in mutual CHAP with the target.

  • SecretToAuthenticateTarget: The secret key that the target must provide to participate in mutual CHAP with the initiator (e.g. Windows client).

  • TargetARN: The Amazon Resource Name (ARN) of the storage volume.

" - } - }, - "documentation":"

A JSON object containing a .

" - }, - "DescribeGatewayInformationInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the ID of the gateway.

" - }, - "DescribeGatewayInformationOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "GatewayId":{ - "shape":"GatewayId", - "documentation":"

The unique identifier assigned to your gateway during activation. This ID becomes part of the gateway Amazon Resource Name (ARN), which you use as input for other operations.

" - }, - "GatewayName":{ - "shape":"string", - "documentation":"

The name you configured for your gateway.

" - }, - "GatewayTimezone":{ - "shape":"GatewayTimezone", - "documentation":"

A value that indicates the time zone configured for the gateway.

" - }, - "GatewayState":{ - "shape":"GatewayState", - "documentation":"

A value that indicates the operating state of the gateway.

" - }, - "GatewayNetworkInterfaces":{ - "shape":"GatewayNetworkInterfaces", - "documentation":"

A NetworkInterface array that contains descriptions of the gateway network interfaces.

" - }, - "GatewayType":{ - "shape":"GatewayType", - "documentation":"

The type of the gateway.

" - }, - "NextUpdateAvailabilityDate":{ - "shape":"NextUpdateAvailabilityDate", - "documentation":"

The date on which an update to the gateway is available. This date is in the time zone of the gateway. If the gateway is not available for an update this field is not returned in the response.

" - }, - "LastSoftwareUpdate":{ - "shape":"LastSoftwareUpdate", - "documentation":"

The date on which the last software update was applied to the gateway. If the gateway has never been updated, this field does not return a value in the response.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DescribeMaintenanceStartTimeInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway.

" - }, - "DescribeMaintenanceStartTimeOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "HourOfDay":{ - "shape":"HourOfDay", - "documentation":"

The hour component of the maintenance start time represented as hh, where hh is the hour (0 to 23). The hour of the day is in the time zone of the gateway.

" - }, - "MinuteOfHour":{ - "shape":"MinuteOfHour", - "documentation":"

The minute component of the maintenance start time represented as mm, where mm is the minute (0 to 59). The minute of the hour is in the time zone of the gateway.

" - }, - "DayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

An ordinal number between 0 and 6 that represents the day of the week, where 0 represents Sunday and 6 represents Saturday. The day of week is in the time zone of the gateway.

" - }, - "Timezone":{"shape":"GatewayTimezone"} - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "DescribeNFSFileSharesInput":{ - "type":"structure", - "required":["FileShareARNList"], - "members":{ - "FileShareARNList":{ - "shape":"FileShareARNList", - "documentation":"

An array containing the Amazon Resource Name (ARN) of each file share to be described.

" - } - }, - "documentation":"

DescribeNFSFileSharesInput

" - }, - "DescribeNFSFileSharesOutput":{ - "type":"structure", - "members":{ - "NFSFileShareInfoList":{ - "shape":"NFSFileShareInfoList", - "documentation":"

An array containing a description for each requested file share.

" - } - }, - "documentation":"

DescribeNFSFileSharesOutput

" - }, - "DescribeSMBFileSharesInput":{ - "type":"structure", - "required":["FileShareARNList"], - "members":{ - "FileShareARNList":{ - "shape":"FileShareARNList", - "documentation":"

An array containing the Amazon Resource Name (ARN) of each file share to be described.

" - } - }, - "documentation":"

DescribeSMBFileSharesInput

" - }, - "DescribeSMBFileSharesOutput":{ - "type":"structure", - "members":{ - "SMBFileShareInfoList":{ - "shape":"SMBFileShareInfoList", - "documentation":"

An array containing a description for each requested file share.

" - } - }, - "documentation":"

DescribeSMBFileSharesOutput

" - }, - "DescribeSMBSettingsInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "DescribeSMBSettingsOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that the gateway is joined to.

" - }, - "SMBGuestPasswordSet":{ - "shape":"Boolean", - "documentation":"

This value is true if a password for the guest user “smbguest” is set, and otherwise false.

" - } - } - }, - "DescribeSnapshotScheduleInput":{ - "type":"structure", - "required":["VolumeARN"], - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

" - } - }, - "documentation":"

A JSON object containing the DescribeSnapshotScheduleInput$VolumeARN of the volume.

" - }, - "DescribeSnapshotScheduleOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{"shape":"VolumeARN"}, - "StartAt":{"shape":"HourOfDay"}, - "RecurrenceInHours":{"shape":"RecurrenceInHours"}, - "Description":{"shape":"Description"}, - "Timezone":{"shape":"GatewayTimezone"} - } - }, - "DescribeStorediSCSIVolumesInput":{ - "type":"structure", - "required":["VolumeARNs"], - "members":{ - "VolumeARNs":{ - "shape":"VolumeARNs", - "documentation":"

An array of strings where each string represents the Amazon Resource Name (ARN) of a stored volume. All of the specified stored volumes must from the same gateway. Use ListVolumes to get volume ARNs for a gateway.

" - } - }, - "documentation":"

A JSON object containing a list of DescribeStorediSCSIVolumesInput$VolumeARNs.

" - }, - "DescribeStorediSCSIVolumesOutput":{ - "type":"structure", - "members":{ - "StorediSCSIVolumes":{"shape":"StorediSCSIVolumes"} - } - }, - "DescribeTapeArchivesInput":{ - "type":"structure", - "members":{ - "TapeARNs":{ - "shape":"TapeARNs", - "documentation":"

Specifies one or more unique Amazon Resource Names (ARNs) that represent the virtual tapes you want to describe.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to begin describing virtual tapes.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the number of virtual tapes descried be limited to the specified number.

" - } - }, - "documentation":"

DescribeTapeArchivesInput

" - }, - "DescribeTapeArchivesOutput":{ - "type":"structure", - "members":{ - "TapeArchives":{ - "shape":"TapeArchives", - "documentation":"

An array of virtual tape objects in the virtual tape shelf (VTS). The description includes of the Amazon Resource Name (ARN) of the virtual tapes. The information returned includes the Amazon Resource Names (ARNs) of the tapes, size of the tapes, status of the tapes, progress of the description and tape barcode.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which the virtual tapes that were fetched for description ended. Use this marker in your next request to fetch the next set of virtual tapes in the virtual tape shelf (VTS). If there are no more virtual tapes to describe, this field does not appear in the response.

" - } - }, - "documentation":"

DescribeTapeArchivesOutput

" - }, - "DescribeTapeRecoveryPointsInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to begin describing the virtual tape recovery points.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the number of virtual tape recovery points that are described be limited to the specified number.

" - } - }, - "documentation":"

DescribeTapeRecoveryPointsInput

" - }, - "DescribeTapeRecoveryPointsOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "TapeRecoveryPointInfos":{ - "shape":"TapeRecoveryPointInfos", - "documentation":"

An array of TapeRecoveryPointInfos that are available for the specified gateway.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which the virtual tape recovery points that were listed for description ended.

Use this marker in your next request to list the next set of virtual tape recovery points in the list. If there are no more recovery points to describe, this field does not appear in the response.

" - } - }, - "documentation":"

DescribeTapeRecoveryPointsOutput

" - }, - "DescribeTapesInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "TapeARNs":{ - "shape":"TapeARNs", - "documentation":"

Specifies one or more unique Amazon Resource Names (ARNs) that represent the virtual tapes you want to describe. If this parameter is not specified, Tape gateway returns a description of all virtual tapes associated with the specified gateway.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

A marker value, obtained in a previous call to DescribeTapes. This marker indicates which page of results to retrieve.

If not specified, the first page of results is retrieved.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the number of virtual tapes described be limited to the specified number.

Amazon Web Services may impose its own limit, if this field is not set.

" - } - }, - "documentation":"

DescribeTapesInput

" - }, - "DescribeTapesOutput":{ - "type":"structure", - "members":{ - "Tapes":{ - "shape":"Tapes", - "documentation":"

An array of virtual tape descriptions.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string which can be used as part of a subsequent DescribeTapes call to retrieve the next page of results.

If a response does not contain a marker, then there are no more results to be retrieved.

" - } - }, - "documentation":"

DescribeTapesOutput

" - }, - "DescribeUploadBufferInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "DescribeUploadBufferOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{"shape":"DiskIds"}, - "UploadBufferUsedInBytes":{"shape":"long"}, - "UploadBufferAllocatedInBytes":{"shape":"long"} - } - }, - "DescribeVTLDevicesInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "VTLDeviceARNs":{ - "shape":"VTLDeviceARNs", - "documentation":"

An array of strings, where each string represents the Amazon Resource Name (ARN) of a VTL device.

All of the specified VTL devices must be from the same gateway. If no VTL devices are specified, the result will contain all devices on the specified gateway.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to begin describing the VTL devices.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the number of VTL devices described be limited to the specified number.

" - } - }, - "documentation":"

DescribeVTLDevicesInput

" - }, - "DescribeVTLDevicesOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "VTLDevices":{ - "shape":"VTLDevices", - "documentation":"

An array of VTL device objects composed of the Amazon Resource Name(ARN) of the VTL devices.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which the VTL devices that were fetched for description ended. Use the marker in your next request to fetch the next set of VTL devices in the list. If there are no more VTL devices to describe, this field does not appear in the response.

" - } - }, - "documentation":"

DescribeVTLDevicesOutput

" - }, - "DescribeWorkingStorageInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway.

" - }, - "DescribeWorkingStorageOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "DiskIds":{ - "shape":"DiskIds", - "documentation":"

An array of the gateway's local disk IDs that are configured as working storage. Each local disk ID is specified as a string (minimum length of 1 and maximum length of 300). If no local disks are configured as working storage, then the DiskIds array is empty.

" - }, - "WorkingStorageUsedInBytes":{ - "shape":"long", - "documentation":"

The total working storage in bytes in use by the gateway. If no working storage is configured for the gateway, this field returns 0.

" - }, - "WorkingStorageAllocatedInBytes":{ - "shape":"long", - "documentation":"

The total working storage in bytes allocated for the gateway. If no working storage is configured for the gateway, this field returns 0.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "Description":{ - "type":"string", - "max":255, - "min":1 - }, - "DeviceType":{ - "type":"string", - "max":50, - "min":2 - }, - "DeviceiSCSIAttributes":{ - "type":"structure", - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

Specifies the unique Amazon Resource Name (ARN) that encodes the iSCSI qualified name(iqn) of a tape drive or media changer target.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

The network interface identifier of the VTL device.

" - }, - "NetworkInterfacePort":{ - "shape":"integer", - "documentation":"

The port used to communicate with iSCSI VTL device targets.

" - }, - "ChapEnabled":{ - "shape":"boolean", - "documentation":"

Indicates whether mutual CHAP is enabled for the iSCSI target.

" - } - }, - "documentation":"

Lists iSCSI information about a VTL device.

" - }, - "DisableGatewayInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

DisableGatewayInput

" - }, - "DisableGatewayOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) of the disabled gateway.

" - } - }, - "documentation":"

DisableGatewayOutput

" - }, - "Disk":{ - "type":"structure", - "members":{ - "DiskId":{"shape":"DiskId"}, - "DiskPath":{"shape":"string"}, - "DiskNode":{"shape":"string"}, - "DiskStatus":{"shape":"string"}, - "DiskSizeInBytes":{"shape":"long"}, - "DiskAllocationType":{"shape":"DiskAllocationType"}, - "DiskAllocationResource":{"shape":"string"} - } - }, - "DiskAllocationType":{ - "type":"string", - "max":100, - "min":3 - }, - "DiskId":{ - "type":"string", - "max":300, - "min":1 - }, - "DiskIds":{ - "type":"list", - "member":{"shape":"DiskId"} - }, - "Disks":{ - "type":"list", - "member":{"shape":"Disk"} - }, - "DomainName":{ - "type":"string", - "pattern":"^([a-z0-9]+(-[a-z0-9]+)*\\.)+[a-z]{2,}$" - }, - "DomainUserName":{ - "type":"string", - "pattern":"^\\w[\\w\\.\\- ]*$" - }, - "DomainUserPassword":{ - "type":"string", - "pattern":"^[ -~]+$", - "sensitive":true - }, - "DoubleObject":{"type":"double"}, - "ErrorCode":{ - "type":"string", - "enum":[ - "ActivationKeyExpired", - "ActivationKeyInvalid", - "ActivationKeyNotFound", - "GatewayInternalError", - "GatewayNotConnected", - "GatewayNotFound", - "GatewayProxyNetworkConnectionBusy", - "AuthenticationFailure", - "BandwidthThrottleScheduleNotFound", - "Blocked", - "CannotExportSnapshot", - "ChapCredentialNotFound", - "DiskAlreadyAllocated", - "DiskDoesNotExist", - "DiskSizeGreaterThanVolumeMaxSize", - "DiskSizeLessThanVolumeSize", - "DiskSizeNotGigAligned", - "DuplicateCertificateInfo", - "DuplicateSchedule", - "EndpointNotFound", - "IAMNotSupported", - "InitiatorInvalid", - "InitiatorNotFound", - "InternalError", - "InvalidGateway", - "InvalidEndpoint", - "InvalidParameters", - "InvalidSchedule", - "LocalStorageLimitExceeded", - "LunAlreadyAllocated ", - "LunInvalid", - "MaximumContentLengthExceeded", - "MaximumTapeCartridgeCountExceeded", - "MaximumVolumeCountExceeded", - "NetworkConfigurationChanged", - "NoDisksAvailable", - "NotImplemented", - "NotSupported", - "OperationAborted", - "OutdatedGateway", - "ParametersNotImplemented", - "RegionInvalid", - "RequestTimeout", - "ServiceUnavailable", - "SnapshotDeleted", - "SnapshotIdInvalid", - "SnapshotInProgress", - "SnapshotNotFound", - "SnapshotScheduleNotFound", - "StagingAreaFull", - "StorageFailure", - "TapeCartridgeNotFound", - "TargetAlreadyExists", - "TargetInvalid", - "TargetNotFound", - "UnauthorizedOperation", - "VolumeAlreadyExists", - "VolumeIdInvalid", - "VolumeInUse", - "VolumeNotFound", - "VolumeNotReady" - ] - }, - "FileShareARN":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN) of the file share.

", - "max":500, - "min":50 - }, - "FileShareARNList":{ - "type":"list", - "member":{"shape":"FileShareARN"}, - "max":10, - "min":1 - }, - "FileShareClientList":{ - "type":"list", - "member":{"shape":"IPV4AddressCIDR"}, - "documentation":"

The list of clients that are allowed to access the file gateway. The list must contain either valid IP addresses or valid CIDR blocks.

", - "max":100, - "min":1 - }, - "FileShareId":{ - "type":"string", - "documentation":"

The ID of the file share.

", - "max":30, - "min":12 - }, - "FileShareInfo":{ - "type":"structure", - "members":{ - "FileShareType":{"shape":"FileShareType"}, - "FileShareARN":{"shape":"FileShareARN"}, - "FileShareId":{"shape":"FileShareId"}, - "FileShareStatus":{"shape":"FileShareStatus"}, - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

Describes a file share.

" - }, - "FileShareInfoList":{ - "type":"list", - "member":{"shape":"FileShareInfo"} - }, - "FileShareStatus":{ - "type":"string", - "documentation":"

The status of the file share. Possible values are CREATING, UPDATING, AVAILABLE and DELETING.

", - "max":50, - "min":3 - }, - "FileShareType":{ - "type":"string", - "documentation":"

The type of the file share.

", - "enum":[ - "NFS", - "SMB" - ] - }, - "FileShareUser":{ - "type":"string", - "max":64, - "min":1 - }, - "FileShareUserList":{ - "type":"list", - "member":{"shape":"FileShareUser"}, - "max":100, - "min":0 - }, - "GatewayARN":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and region.

", - "max":500, - "min":50 - }, - "GatewayId":{ - "type":"string", - "max":30, - "min":12 - }, - "GatewayInfo":{ - "type":"structure", - "members":{ - "GatewayId":{ - "shape":"GatewayId", - "documentation":"

The unique identifier assigned to your gateway during activation. This ID becomes part of the gateway Amazon Resource Name (ARN), which you use as input for other operations.

" - }, - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and region.

" - }, - "GatewayType":{ - "shape":"GatewayType", - "documentation":"

The type of the gateway.

" - }, - "GatewayOperationalState":{ - "shape":"GatewayOperationalState", - "documentation":"

The state of the gateway.

Valid Values: DISABLED or ACTIVE

" - }, - "GatewayName":{ - "shape":"string", - "documentation":"

The name of the gateway.

" - } - }, - "documentation":"

Describes a gateway object.

" - }, - "GatewayName":{ - "type":"string", - "documentation":"

The name you configured for your gateway.

", - "max":255, - "min":2, - "pattern":"^[ -\\.0-\\[\\]-~]*[!-\\.0-\\[\\]-~][ -\\.0-\\[\\]-~]*$" - }, - "GatewayNetworkInterfaces":{ - "type":"list", - "member":{"shape":"NetworkInterface"} - }, - "GatewayOperationalState":{ - "type":"string", - "max":25, - "min":2 - }, - "GatewayState":{ - "type":"string", - "max":25, - "min":2 - }, - "GatewayTimezone":{ - "type":"string", - "max":10, - "min":3 - }, - "GatewayType":{ - "type":"string", - "max":20, - "min":2 - }, - "Gateways":{ - "type":"list", - "member":{"shape":"GatewayInfo"} - }, - "HourOfDay":{ - "type":"integer", - "max":23, - "min":0 - }, - "IPV4AddressCIDR":{ - "type":"string", - "pattern":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))?$" - }, - "Initiator":{ - "type":"string", - "max":50, - "min":1 - }, - "Initiators":{ - "type":"list", - "member":{"shape":"Initiator"} - }, - "InternalServerError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

A human-readable message describing the error that occurred.

" - }, - "error":{ - "shape":"StorageGatewayError", - "documentation":"

A StorageGatewayError that provides more information about the cause of the error.

" - } - }, - "documentation":"

An internal server error has occurred during the request. For more information, see the error and message fields.

", - "exception":true - }, - "InvalidGatewayRequestException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

A human-readable message describing the error that occurred.

" - }, - "error":{ - "shape":"StorageGatewayError", - "documentation":"

A StorageGatewayError that provides more detail about the cause of the error.

" - } - }, - "documentation":"

An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields.

", - "exception":true - }, - "IqnName":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[0-9a-z:.-]+" - }, - "JoinDomainInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "DomainName", - "UserName", - "Password" - ], - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) of the file gateway you want to add to the Active Directory domain.

" - }, - "DomainName":{ - "shape":"DomainName", - "documentation":"

The name of the domain that you want the gateway to join.

" - }, - "UserName":{ - "shape":"DomainUserName", - "documentation":"

Sets the user name of user who has permission to add the gateway to the Active Directory domain.

" - }, - "Password":{ - "shape":"DomainUserPassword", - "documentation":"

Sets the password of the user who has permission to add the gateway to the Active Directory domain.

" - } - }, - "documentation":"

JoinDomainInput

" - }, - "JoinDomainOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The unique Amazon Resource Name (ARN) of the gateway that joined the domain.

" - } - }, - "documentation":"

JoinDomainOutput

" - }, - "KMSKey":{ - "type":"string", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

", - "max":2048, - "min":20 - }, - "LastSoftwareUpdate":{ - "type":"string", - "max":25, - "min":1 - }, - "ListFileSharesInput":{ - "type":"structure", - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon resource Name (ARN) of the gateway whose file shares you want to list. If this field is not present, all file shares under your account are listed.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

The maximum number of file shares to return in the response. The value must be an integer with a value greater than zero. Optional.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

Opaque pagination token returned from a previous ListFileShares operation. If present, Marker specifies where to continue the list from after a previous call to ListFileShares. Optional.

" - } - }, - "documentation":"

ListFileShareInput

" - }, - "ListFileSharesOutput":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

If the request includes Marker, the response returns that value in this field.

" - }, - "NextMarker":{ - "shape":"Marker", - "documentation":"

If a value is present, there are more file shares to return. In a subsequent request, use NextMarker as the value for Marker to retrieve the next set of file shares.

" - }, - "FileShareInfoList":{ - "shape":"FileShareInfoList", - "documentation":"

An array of information about the file gateway's file shares.

" - } - }, - "documentation":"

ListFileShareOutput

" - }, - "ListGatewaysInput":{ - "type":"structure", - "members":{ - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to begin the returned list of gateways.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the list of gateways returned be limited to the specified number of items.

" - } - }, - "documentation":"

A JSON object containing zero or more of the following fields:

" - }, - "ListGatewaysOutput":{ - "type":"structure", - "members":{ - "Gateways":{"shape":"Gateways"}, - "Marker":{"shape":"Marker"} - } - }, - "ListLocalDisksInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway.

" - }, - "ListLocalDisksOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "Disks":{"shape":"Disks"} - } - }, - "ListTagsForResourceInput":{ - "type":"structure", - "required":["ResourceARN"], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource for which you want to list tags.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to begin returning the list of tags.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the list of tags returned be limited to the specified number of items.

" - } - }, - "documentation":"

ListTagsForResourceInput

" - }, - "ListTagsForResourceOutput":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

he Amazon Resource Name (ARN) of the resource for which you want to list tags.

" - }, - "Marker":{ - "shape":"Marker", - "documentation":"

An opaque string that indicates the position at which to stop returning the list of tags.

" - }, - "Tags":{ - "shape":"Tags", - "documentation":"

An array that contains the tags for the specified resource.

" - } - }, - "documentation":"

ListTagsForResourceOutput

" - }, - "ListTapesInput":{ - "type":"structure", - "members":{ - "TapeARNs":{"shape":"TapeARNs"}, - "Marker":{ - "shape":"Marker", - "documentation":"

A string that indicates the position at which to begin the returned list of tapes.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

An optional number limit for the tapes in the list returned by this call.

" - } - }, - "documentation":"

A JSON object that contains one or more of the following fields:

" - }, - "ListTapesOutput":{ - "type":"structure", - "members":{ - "TapeInfos":{"shape":"TapeInfos"}, - "Marker":{ - "shape":"Marker", - "documentation":"

A string that indicates the position at which to begin returning the next list of tapes. Use the marker in your next request to continue pagination of tapes. If there are no more tapes to list, this element does not appear in the response body.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "ListVolumeInitiatorsInput":{ - "type":"structure", - "required":["VolumeARN"], - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes for the gateway.

" - } - }, - "documentation":"

ListVolumeInitiatorsInput

" - }, - "ListVolumeInitiatorsOutput":{ - "type":"structure", - "members":{ - "Initiators":{ - "shape":"Initiators", - "documentation":"

The host names and port numbers of all iSCSI initiators that are connected to the gateway.

" - } - }, - "documentation":"

ListVolumeInitiatorsOutput

" - }, - "ListVolumeRecoveryPointsInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "ListVolumeRecoveryPointsOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "VolumeRecoveryPointInfos":{"shape":"VolumeRecoveryPointInfos"} - } - }, - "ListVolumesInput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "Marker":{ - "shape":"Marker", - "documentation":"

A string that indicates the position at which to begin the returned list of volumes. Obtain the marker from the response of a previous List iSCSI Volumes request.

" - }, - "Limit":{ - "shape":"PositiveIntObject", - "documentation":"

Specifies that the list of volumes returned be limited to the specified number of items.

" - } - }, - "documentation":"

A JSON object that contains one or more of the following fields:

" - }, - "ListVolumesOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "Marker":{"shape":"Marker"}, - "VolumeInfos":{"shape":"VolumeInfos"} - } - }, - "LocalConsolePassword":{ - "type":"string", - "max":512, - "min":6, - "pattern":"^[ -~]+$", - "sensitive":true - }, - "LocationARN":{ - "type":"string", - "documentation":"

The ARN of the backend storage used for storing file data.

", - "max":310, - "min":16 - }, - "Marker":{ - "type":"string", - "max":1000, - "min":1 - }, - "MediumChangerType":{ - "type":"string", - "max":50, - "min":2 - }, - "MinuteOfHour":{ - "type":"integer", - "max":59, - "min":0 - }, - "NFSFileShareDefaults":{ - "type":"structure", - "members":{ - "FileMode":{ - "shape":"PermissionMode", - "documentation":"

The Unix file mode in the form \"nnnn\". For example, \"0666\" represents the default file mode inside the file share. The default value is 0666.

" - }, - "DirectoryMode":{ - "shape":"PermissionMode", - "documentation":"

The Unix directory mode in the form \"nnnn\". For example, \"0666\" represents the default access mode for all directories inside the file share. The default value is 0777.

" - }, - "GroupId":{ - "shape":"PermissionId", - "documentation":"

The default group ID for the file share (unless the files have another group ID specified). The default value is nfsnobody.

" - }, - "OwnerId":{ - "shape":"PermissionId", - "documentation":"

The default owner ID for files in the file share (unless the files have another owner ID specified). The default value is nfsnobody.

" - } - }, - "documentation":"

Describes Network File System (NFS) file share default values. Files and folders stored as Amazon S3 objects in S3 buckets don't, by default, have Unix file permissions assigned to them. Upon discovery in an S3 bucket by Storage Gateway, the S3 objects that represent files and folders are assigned these default Unix permissions. This operation is only supported for file gateways.

" - }, - "NFSFileShareInfo":{ - "type":"structure", - "members":{ - "NFSFileShareDefaults":{"shape":"NFSFileShareDefaults"}, - "FileShareARN":{"shape":"FileShareARN"}, - "FileShareId":{"shape":"FileShareId"}, - "FileShareStatus":{"shape":"FileShareStatus"}, - "GatewayARN":{"shape":"GatewayARN"}, - "KMSEncrypted":{ - "shape":"boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{"shape":"KMSKey"}, - "Path":{"shape":"Path"}, - "Role":{"shape":"Role"}, - "LocationARN":{"shape":"LocationARN"}, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{"shape":"ObjectACL"}, - "ClientList":{"shape":"FileShareClientList"}, - "Squash":{"shape":"Squash"}, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - } - }, - "documentation":"

The Unix file permissions and ownership information assigned, by default, to native S3 objects when file gateway discovers them in S3 buckets. This operation is only supported in file gateways.

" - }, - "NFSFileShareInfoList":{ - "type":"list", - "member":{"shape":"NFSFileShareInfo"} - }, - "NetworkInterface":{ - "type":"structure", - "members":{ - "Ipv4Address":{ - "shape":"string", - "documentation":"

The Internet Protocol version 4 (IPv4) address of the interface.

" - }, - "MacAddress":{ - "shape":"string", - "documentation":"

The Media Access Control (MAC) address of the interface.

This is currently unsupported and will not be returned in output.

" - }, - "Ipv6Address":{ - "shape":"string", - "documentation":"

The Internet Protocol version 6 (IPv6) address of the interface. Currently not supported.

" - } - }, - "documentation":"

Describes a gateway's network interface.

" - }, - "NetworkInterfaceId":{ - "type":"string", - "pattern":"\\A(25[0-5]|2[0-4]\\d|[0-1]?\\d?\\d)(\\.(25[0-5]|2[0-4]\\d|[0-1]?\\d?\\d)){3}\\z" - }, - "NextUpdateAvailabilityDate":{ - "type":"string", - "max":25, - "min":1 - }, - "NotificationId":{ - "type":"string", - "documentation":"

The randomly generated ID of the notification that was sent. This ID is in UUID format.

", - "max":2048, - "min":1 - }, - "NotifyWhenUploadedInput":{ - "type":"structure", - "required":["FileShareARN"], - "members":{ - "FileShareARN":{"shape":"FileShareARN"} - } - }, - "NotifyWhenUploadedOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{"shape":"FileShareARN"}, - "NotificationId":{"shape":"NotificationId"} - } - }, - "NumTapesToCreate":{ - "type":"integer", - "max":10, - "min":1 - }, - "ObjectACL":{ - "type":"string", - "documentation":"

A value that sets the access control list permission for objects in the S3 bucket that a file gateway puts objects into. The default value is \"private\".

", - "enum":[ - "private", - "public-read", - "public-read-write", - "authenticated-read", - "bucket-owner-read", - "bucket-owner-full-control", - "aws-exec-read" - ] - }, - "Path":{ - "type":"string", - "documentation":"

The file share path used by the NFS client to identify the mount point.

" - }, - "PermissionId":{ - "type":"long", - "max":4294967294, - "min":0 - }, - "PermissionMode":{ - "type":"string", - "max":4, - "min":1, - "pattern":"^[0-7]{4}$" - }, - "PositiveIntObject":{ - "type":"integer", - "min":1 - }, - "RecurrenceInHours":{ - "type":"integer", - "max":24, - "min":1 - }, - "RefreshCacheInput":{ - "type":"structure", - "required":["FileShareARN"], - "members":{ - "FileShareARN":{"shape":"FileShareARN"} - } - }, - "RefreshCacheOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{"shape":"FileShareARN"} - } - }, - "RegionId":{ - "type":"string", - "max":25, - "min":1 - }, - "RemoveTagsFromResourceInput":{ - "type":"structure", - "required":[ - "ResourceARN", - "TagKeys" - ], - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource you want to remove the tags from.

" - }, - "TagKeys":{ - "shape":"TagKeys", - "documentation":"

The keys of the tags you want to remove from the specified resource. A tag is composed of a key/value pair.

" - } - }, - "documentation":"

RemoveTagsFromResourceInput

" - }, - "RemoveTagsFromResourceOutput":{ - "type":"structure", - "members":{ - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

The Amazon Resource Name (ARN) of the resource that the tags were removed from.

" - } - }, - "documentation":"

RemoveTagsFromResourceOutput

" - }, - "ResetCacheInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "ResetCacheOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "ResourceARN":{ - "type":"string", - "max":500, - "min":50 - }, - "RetrieveTapeArchiveInput":{ - "type":"structure", - "required":[ - "TapeARN", - "GatewayARN" - ], - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape you want to retrieve from the virtual tape shelf (VTS).

" - }, - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the gateway you want to retrieve the virtual tape to. Use the ListGateways operation to return a list of gateways for your account and region.

You retrieve archived virtual tapes to only one gateway and the gateway must be a tape gateway.

" - } - }, - "documentation":"

RetrieveTapeArchiveInput

" - }, - "RetrieveTapeArchiveOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the retrieved virtual tape.

" - } - }, - "documentation":"

RetrieveTapeArchiveOutput

" - }, - "RetrieveTapeRecoveryPointInput":{ - "type":"structure", - "required":[ - "TapeARN", - "GatewayARN" - ], - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape for which you want to retrieve the recovery point.

" - }, - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

RetrieveTapeRecoveryPointInput

" - }, - "RetrieveTapeRecoveryPointOutput":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape for which the recovery point was retrieved.

" - } - }, - "documentation":"

RetrieveTapeRecoveryPointOutput

" - }, - "Role":{ - "type":"string", - "documentation":"

The ARN of the IAM role that file gateway assumes when it accesses the underlying storage.

", - "max":2048, - "min":20 - }, - "SMBFileShareInfo":{ - "type":"structure", - "members":{ - "FileShareARN":{"shape":"FileShareARN"}, - "FileShareId":{"shape":"FileShareId"}, - "FileShareStatus":{"shape":"FileShareStatus"}, - "GatewayARN":{"shape":"GatewayARN"}, - "KMSEncrypted":{ - "shape":"boolean", - "documentation":"

True to use Amazon S3 server-side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{"shape":"KMSKey"}, - "Path":{ - "shape":"Path", - "documentation":"

The file share path used by the SMB client to identify the mount point.

" - }, - "Role":{"shape":"Role"}, - "LocationARN":{"shape":"LocationARN"}, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{"shape":"ObjectACL"}, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - }, - "ValidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - }, - "InvalidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are not allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - }, - "Authentication":{"shape":"Authentication"} - }, - "documentation":"

The Windows file permissions and ownership information assigned, by default, to native S3 objects when file gateway discovers them in S3 buckets. This operation is only supported for file gateways.

" - }, - "SMBFileShareInfoList":{ - "type":"list", - "member":{"shape":"SMBFileShareInfo"} - }, - "SMBGuestPassword":{ - "type":"string", - "max":512, - "min":6, - "pattern":"^[ -~]+$", - "sensitive":true - }, - "ServiceUnavailableError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"string", - "documentation":"

A human-readable message describing the error that occurred.

" - }, - "error":{ - "shape":"StorageGatewayError", - "documentation":"

A StorageGatewayError that provides more information about the cause of the error.

" - } - }, - "documentation":"

An internal server error has occurred because the service is unavailable. For more information, see the error and message fields.

", - "exception":true - }, - "SetLocalConsolePasswordInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "LocalConsolePassword" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "LocalConsolePassword":{ - "shape":"LocalConsolePassword", - "documentation":"

The password you want to set for your VM local console.

" - } - }, - "documentation":"

SetLocalConsolePasswordInput

" - }, - "SetLocalConsolePasswordOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "SetSMBGuestPasswordInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "Password" - ], - "members":{ - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the file gateway the SMB file share is associated with.

" - }, - "Password":{ - "shape":"SMBGuestPassword", - "documentation":"

The password that you want to set for your SMB Server.

" - } - }, - "documentation":"

SetSMBGuestPasswordInput

" - }, - "SetSMBGuestPasswordOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - } - }, - "ShutdownGatewayInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway to shut down.

" - }, - "ShutdownGatewayOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway that was shut down.

" - }, - "SnapshotDescription":{ - "type":"string", - "max":255, - "min":1 - }, - "SnapshotId":{ - "type":"string", - "pattern":"\\Asnap-([0-9A-Fa-f]{8}|[0-9A-Fa-f]{17})\\z" - }, - "Squash":{ - "type":"string", - "documentation":"

The user mapped to anonymous user. Valid options are the following:

  • RootSquash - Only root is mapped to anonymous user.

  • NoSquash - No one is mapped to anonymous user

  • AllSquash - Everyone is mapped to anonymous user.

", - "max":15, - "min":5 - }, - "StartGatewayInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway to start.

" - }, - "StartGatewayOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway that was restarted.

" - }, - "StorageClass":{ - "type":"string", - "documentation":"

", - "max":20, - "min":5 - }, - "StorageGatewayError":{ - "type":"structure", - "members":{ - "errorCode":{ - "shape":"ErrorCode", - "documentation":"

Additional information about the error.

" - }, - "errorDetails":{ - "shape":"errorDetails", - "documentation":"

Human-readable text that provides detail about the error that occurred.

" - } - }, - "documentation":"

Provides additional information about an error that was returned by the service as an or. See the errorCode and errorDetails members for more information about the error.

" - }, - "StorediSCSIVolume":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the storage volume.

" - }, - "VolumeId":{ - "shape":"VolumeId", - "documentation":"

The unique identifier of the volume, e.g. vol-AE4B946D.

" - }, - "VolumeType":{ - "shape":"VolumeType", - "documentation":"

One of the VolumeType enumeration values describing the type of the volume.

" - }, - "VolumeStatus":{ - "shape":"VolumeStatus", - "documentation":"

One of the VolumeStatus values that indicates the state of the storage volume.

" - }, - "VolumeSizeInBytes":{ - "shape":"long", - "documentation":"

The size of the volume in bytes.

" - }, - "VolumeProgress":{ - "shape":"DoubleObject", - "documentation":"

Represents the percentage complete if the volume is restoring or bootstrapping that represents the percent of data transferred. This field does not appear in the response if the stored volume is not restoring or bootstrapping.

" - }, - "VolumeDiskId":{ - "shape":"DiskId", - "documentation":"

The ID of the local disk that was specified in the CreateStorediSCSIVolume operation.

" - }, - "SourceSnapshotId":{ - "shape":"SnapshotId", - "documentation":"

If the stored volume was created from a snapshot, this field contains the snapshot ID used, e.g. snap-78e22663. Otherwise, this field is not included.

" - }, - "PreservedExistingData":{ - "shape":"boolean", - "documentation":"

Indicates if when the stored volume was created, existing data on the underlying local disk was preserved.

Valid Values: true, false

" - }, - "VolumeiSCSIAttributes":{ - "shape":"VolumeiSCSIAttributes", - "documentation":"

An VolumeiSCSIAttributes object that represents a collection of iSCSI attributes for one stored volume.

" - }, - "CreatedDate":{ - "shape":"CreatedDate", - "documentation":"

The date the volume was created. Volumes created prior to March 28, 2017 don’t have this time stamp.

" - }, - "VolumeUsedInBytes":{ - "shape":"VolumeUsedInBytes", - "documentation":"

The size of the data stored on the volume in bytes.

This value is not available for volumes created prior to May 13, 2015, until you store data on the volume.

" - }, - "KMSKey":{"shape":"KMSKey"} - }, - "documentation":"

Describes an iSCSI stored volume.

" - }, - "StorediSCSIVolumes":{ - "type":"list", - "member":{"shape":"StorediSCSIVolume"} - }, - "Tag":{ - "type":"structure", - "required":[ - "Key", - "Value" - ], - "members":{ - "Key":{"shape":"TagKey"}, - "Value":{"shape":"TagValue"} - } - }, - "TagKey":{ - "type":"string", - "max":128, - "min":1, - "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys":{ - "type":"list", - "member":{"shape":"TagKey"} - }, - "TagValue":{ - "type":"string", - "max":256 - }, - "Tags":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "Tape":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape.

" - }, - "TapeBarcode":{ - "shape":"TapeBarcode", - "documentation":"

The barcode that identifies a specific virtual tape.

" - }, - "TapeCreatedDate":{ - "shape":"Time", - "documentation":"

The date the virtual tape was created.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of the virtual tape capacity.

" - }, - "TapeStatus":{ - "shape":"TapeStatus", - "documentation":"

The current state of the virtual tape.

" - }, - "VTLDevice":{ - "shape":"VTLDeviceARN", - "documentation":"

The virtual tape library (VTL) device that the virtual tape is associated with.

" - }, - "Progress":{ - "shape":"DoubleObject", - "documentation":"

For archiving virtual tapes, indicates how much data remains to be uploaded before archiving is complete.

Range: 0 (not started) to 100 (complete).

" - }, - "TapeUsedInBytes":{ - "shape":"TapeUsage", - "documentation":"

The size, in bytes, of data stored on the virtual tape.

This value is not available for tapes created prior to May 13, 2015.

" - }, - "KMSKey":{"shape":"KMSKey"} - }, - "documentation":"

Describes a virtual tape object.

" - }, - "TapeARN":{ - "type":"string", - "max":500, - "min":50, - "pattern":"^arn:(aws|aws-cn|aws-us-gov):storagegateway:[a-z\\-0-9]+:[0-9]+:tape\\/[0-9A-Z]{7,16}$" - }, - "TapeARNs":{ - "type":"list", - "member":{"shape":"TapeARN"}, - "documentation":"

The Amazon Resource Name (ARN) of each of the tapes you want to list. If you don't specify a tape ARN, the response lists all tapes in both your VTL and VTS.

" - }, - "TapeArchive":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of an archived virtual tape.

" - }, - "TapeBarcode":{ - "shape":"TapeBarcode", - "documentation":"

The barcode that identifies the archived virtual tape.

" - }, - "TapeCreatedDate":{ - "shape":"Time", - "documentation":"

The date the virtual tape was created.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of the archived virtual tape.

" - }, - "CompletionTime":{ - "shape":"Time", - "documentation":"

The time that the archiving of the virtual tape was completed.

The default time stamp format is in the ISO8601 extended YYYY-MM-DD'T'HH:MM:SS'Z' format.

" - }, - "RetrievedTo":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the tape gateway that the virtual tape is being retrieved to.

The virtual tape is retrieved from the virtual tape shelf (VTS).

" - }, - "TapeStatus":{ - "shape":"TapeArchiveStatus", - "documentation":"

The current state of the archived virtual tape.

" - }, - "TapeUsedInBytes":{ - "shape":"TapeUsage", - "documentation":"

The size, in bytes, of data stored on the virtual tape.

This value is not available for tapes created prior to May 13, 2015.

" - }, - "KMSKey":{"shape":"KMSKey"} - }, - "documentation":"

Represents a virtual tape that is archived in the virtual tape shelf (VTS).

" - }, - "TapeArchiveStatus":{"type":"string"}, - "TapeArchives":{ - "type":"list", - "member":{"shape":"TapeArchive"} - }, - "TapeBarcode":{ - "type":"string", - "max":16, - "min":7, - "pattern":"^[A-Z0-9]*$" - }, - "TapeBarcodePrefix":{ - "type":"string", - "max":4, - "min":1, - "pattern":"^[A-Z]*$" - }, - "TapeDriveType":{ - "type":"string", - "max":50, - "min":2 - }, - "TapeInfo":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of a virtual tape.

" - }, - "TapeBarcode":{ - "shape":"TapeBarcode", - "documentation":"

The barcode that identifies a specific virtual tape.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of a virtual tape.

" - }, - "TapeStatus":{ - "shape":"TapeStatus", - "documentation":"

The status of the tape.

" - }, - "GatewayARN":{ - "shape":"GatewayARN", - "documentation":"

The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and region.

" - } - }, - "documentation":"

Describes a virtual tape.

" - }, - "TapeInfos":{ - "type":"list", - "member":{"shape":"TapeInfo"}, - "documentation":"

An array of TapeInfo objects, where each object describes an a single tape. If there not tapes in the tape library or VTS, then the TapeInfos is an empty array.

" - }, - "TapeRecoveryPointInfo":{ - "type":"structure", - "members":{ - "TapeARN":{ - "shape":"TapeARN", - "documentation":"

The Amazon Resource Name (ARN) of the virtual tape.

" - }, - "TapeRecoveryPointTime":{ - "shape":"Time", - "documentation":"

The time when the point-in-time view of the virtual tape was replicated for later recovery.

The default time stamp format of the tape recovery point time is in the ISO8601 extended YYYY-MM-DD'T'HH:MM:SS'Z' format.

" - }, - "TapeSizeInBytes":{ - "shape":"TapeSize", - "documentation":"

The size, in bytes, of the virtual tapes to recover.

" - }, - "TapeStatus":{"shape":"TapeRecoveryPointStatus"} - }, - "documentation":"

Describes a recovery point.

" - }, - "TapeRecoveryPointInfos":{ - "type":"list", - "member":{"shape":"TapeRecoveryPointInfo"} - }, - "TapeRecoveryPointStatus":{"type":"string"}, - "TapeSize":{"type":"long"}, - "TapeStatus":{"type":"string"}, - "TapeUsage":{"type":"long"}, - "Tapes":{ - "type":"list", - "member":{"shape":"Tape"} - }, - "TargetARN":{ - "type":"string", - "max":800, - "min":50 - }, - "TargetName":{ - "type":"string", - "max":200, - "min":1, - "pattern":"^[-\\.;a-z0-9]+$" - }, - "Time":{"type":"timestamp"}, - "UpdateBandwidthRateLimitInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "AverageUploadRateLimitInBitsPerSec":{ - "shape":"BandwidthUploadRateLimit", - "documentation":"

The average upload bandwidth rate limit in bits per second.

" - }, - "AverageDownloadRateLimitInBitsPerSec":{ - "shape":"BandwidthDownloadRateLimit", - "documentation":"

The average download bandwidth rate limit in bits per second.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "UpdateBandwidthRateLimitOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway whose throttle information was updated.

" - }, - "UpdateChapCredentialsInput":{ - "type":"structure", - "required":[ - "TargetARN", - "SecretToAuthenticateInitiator", - "InitiatorName" - ], - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the iSCSI volume target. Use the DescribeStorediSCSIVolumes operation to return the TargetARN for specified VolumeARN.

" - }, - "SecretToAuthenticateInitiator":{ - "shape":"ChapSecret", - "documentation":"

The secret key that the initiator (for example, the Windows client) must provide to participate in mutual CHAP with the target.

The secret key must be between 12 and 16 bytes when encoded in UTF-8.

" - }, - "InitiatorName":{ - "shape":"IqnName", - "documentation":"

The iSCSI initiator that connects to the target.

" - }, - "SecretToAuthenticateTarget":{ - "shape":"ChapSecret", - "documentation":"

The secret key that the target must provide to participate in mutual CHAP with the initiator (e.g. Windows client).

Byte constraints: Minimum bytes of 12. Maximum bytes of 16.

The secret key must be between 12 and 16 bytes when encoded in UTF-8.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "UpdateChapCredentialsOutput":{ - "type":"structure", - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the target. This is the same target specified in the request.

" - }, - "InitiatorName":{ - "shape":"IqnName", - "documentation":"

The iSCSI initiator that connects to the target. This is the same initiator name specified in the request.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "UpdateGatewayInformationInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "GatewayName":{"shape":"GatewayName"}, - "GatewayTimezone":{"shape":"GatewayTimezone"} - } - }, - "UpdateGatewayInformationOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "GatewayName":{"shape":"string"} - }, - "documentation":"

A JSON object containing the ARN of the gateway that was updated.

" - }, - "UpdateGatewaySoftwareNowInput":{ - "type":"structure", - "required":["GatewayARN"], - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway to update.

" - }, - "UpdateGatewaySoftwareNowOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway that was updated.

" - }, - "UpdateMaintenanceStartTimeInput":{ - "type":"structure", - "required":[ - "GatewayARN", - "HourOfDay", - "MinuteOfHour", - "DayOfWeek" - ], - "members":{ - "GatewayARN":{"shape":"GatewayARN"}, - "HourOfDay":{ - "shape":"HourOfDay", - "documentation":"

The hour component of the maintenance start time represented as hh, where hh is the hour (00 to 23). The hour of the day is in the time zone of the gateway.

" - }, - "MinuteOfHour":{ - "shape":"MinuteOfHour", - "documentation":"

The minute component of the maintenance start time represented as mm, where mm is the minute (00 to 59). The minute of the hour is in the time zone of the gateway.

" - }, - "DayOfWeek":{ - "shape":"DayOfWeek", - "documentation":"

The maintenance start time day of the week represented as an ordinal number from 0 to 6, where 0 represents Sunday and 6 Saturday.

" - } - }, - "documentation":"

A JSON object containing the following fields:

" - }, - "UpdateMaintenanceStartTimeOutput":{ - "type":"structure", - "members":{ - "GatewayARN":{"shape":"GatewayARN"} - }, - "documentation":"

A JSON object containing the of the gateway whose maintenance start time is updated.

" - }, - "UpdateNFSFileShareInput":{ - "type":"structure", - "required":["FileShareARN"], - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the file share to be updated.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - }, - "NFSFileShareDefaults":{ - "shape":"NFSFileShareDefaults", - "documentation":"

The default values for the file share. Optional.

" - }, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{ - "shape":"ObjectACL", - "documentation":"

A value that sets the access control list permission for objects in the S3 bucket that a file gateway puts objects into. The default value is \"private\".

" - }, - "ClientList":{ - "shape":"FileShareClientList", - "documentation":"

The list of clients that are allowed to access the file gateway. The list must contain either valid IP addresses or valid CIDR blocks.

" - }, - "Squash":{ - "shape":"Squash", - "documentation":"

The user mapped to anonymous user. Valid options are the following:

  • RootSquash - Only root is mapped to anonymous user.

  • NoSquash - No one is mapped to anonymous user

  • AllSquash - Everyone is mapped to anonymous user.

" - }, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - } - }, - "documentation":"

UpdateNFSFileShareInput

" - }, - "UpdateNFSFileShareOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the updated file share.

" - } - }, - "documentation":"

UpdateNFSFileShareOutput

" - }, - "UpdateSMBFileShareInput":{ - "type":"structure", - "required":["FileShareARN"], - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the SMB file share that you want to update.

" - }, - "KMSEncrypted":{ - "shape":"Boolean", - "documentation":"

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

" - }, - "KMSKey":{ - "shape":"KMSKey", - "documentation":"

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

" - }, - "DefaultStorageClass":{ - "shape":"StorageClass", - "documentation":"

The default storage class for objects put into an Amazon S3 bucket by the file gateway. Possible values are S3_STANDARD, S3_STANDARD_IA, or S3_ONEZONE_IA. If this field is not populated, the default value S3_STANDARD is used. Optional.

" - }, - "ObjectACL":{ - "shape":"ObjectACL", - "documentation":"

A value that sets the access control list permission for objects in the S3 bucket that a file gateway puts objects into. The default value is \"private\".

" - }, - "ReadOnly":{ - "shape":"Boolean", - "documentation":"

A value that sets the write status of a file share. This value is true if the write status is read-only, and otherwise false.

" - }, - "GuessMIMETypeEnabled":{ - "shape":"Boolean", - "documentation":"

A value that enables guessing of the MIME type for uploaded objects based on file extensions. Set this value to true to enable MIME type guessing, and otherwise to false. The default value is true.

" - }, - "RequesterPays":{ - "shape":"Boolean", - "documentation":"

A value that sets the access control list permission for objects in the Amazon S3 bucket that a file gateway puts objects into. The default value is private.

" - }, - "ValidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - }, - "InvalidUserList":{ - "shape":"FileShareUserList", - "documentation":"

A list of users or groups in the Active Directory that are not allowed to access the file share. A group must be prefixed with the @ character. For example @group1. Can only be set if Authentication is set to ActiveDirectory.

" - } - }, - "documentation":"

UpdateSMBFileShareInput

" - }, - "UpdateSMBFileShareOutput":{ - "type":"structure", - "members":{ - "FileShareARN":{ - "shape":"FileShareARN", - "documentation":"

The Amazon Resource Name (ARN) of the updated SMB file share.

" - } - }, - "documentation":"

UpdateSMBFileShareOutput

" - }, - "UpdateSnapshotScheduleInput":{ - "type":"structure", - "required":[ - "VolumeARN", - "StartAt", - "RecurrenceInHours" - ], - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

" - }, - "StartAt":{ - "shape":"HourOfDay", - "documentation":"

The hour of the day at which the snapshot schedule begins represented as hh, where hh is the hour (0 to 23). The hour of the day is in the time zone of the gateway.

" - }, - "RecurrenceInHours":{ - "shape":"RecurrenceInHours", - "documentation":"

Frequency of snapshots. Specify the number of hours between snapshots.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

Optional description of the snapshot that overwrites the existing description.

" - } - }, - "documentation":"

A JSON object containing one or more of the following fields:

" - }, - "UpdateSnapshotScheduleOutput":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

" - } - }, - "documentation":"

A JSON object containing the of the updated storage volume.

" - }, - "UpdateVTLDeviceTypeInput":{ - "type":"structure", - "required":[ - "VTLDeviceARN", - "DeviceType" - ], - "members":{ - "VTLDeviceARN":{ - "shape":"VTLDeviceARN", - "documentation":"

The Amazon Resource Name (ARN) of the medium changer you want to select.

" - }, - "DeviceType":{ - "shape":"DeviceType", - "documentation":"

The type of medium changer you want to select.

Valid Values: \"STK-L700\", \"AWS-Gateway-VTL\"

" - } - } - }, - "UpdateVTLDeviceTypeOutput":{ - "type":"structure", - "members":{ - "VTLDeviceARN":{ - "shape":"VTLDeviceARN", - "documentation":"

The Amazon Resource Name (ARN) of the medium changer you have selected.

" - } - }, - "documentation":"

UpdateVTLDeviceTypeOutput

" - }, - "VTLDevice":{ - "type":"structure", - "members":{ - "VTLDeviceARN":{ - "shape":"VTLDeviceARN", - "documentation":"

Specifies the unique Amazon Resource Name (ARN) of the device (tape drive or media changer).

" - }, - "VTLDeviceType":{"shape":"VTLDeviceType"}, - "VTLDeviceVendor":{"shape":"VTLDeviceVendor"}, - "VTLDeviceProductIdentifier":{"shape":"VTLDeviceProductIdentifier"}, - "DeviceiSCSIAttributes":{ - "shape":"DeviceiSCSIAttributes", - "documentation":"

A list of iSCSI information about a VTL device.

" - } - }, - "documentation":"

Represents a device object associated with a tape gateway.

" - }, - "VTLDeviceARN":{ - "type":"string", - "max":500, - "min":50 - }, - "VTLDeviceARNs":{ - "type":"list", - "member":{"shape":"VTLDeviceARN"} - }, - "VTLDeviceProductIdentifier":{"type":"string"}, - "VTLDeviceType":{"type":"string"}, - "VTLDeviceVendor":{"type":"string"}, - "VTLDevices":{ - "type":"list", - "member":{"shape":"VTLDevice"} - }, - "VolumeARN":{ - "type":"string", - "max":500, - "min":50 - }, - "VolumeARNs":{ - "type":"list", - "member":{"shape":"VolumeARN"} - }, - "VolumeId":{ - "type":"string", - "max":30, - "min":12 - }, - "VolumeInfo":{ - "type":"structure", - "members":{ - "VolumeARN":{ - "shape":"VolumeARN", - "documentation":"

The Amazon Resource Name (ARN) for the storage volume. For example, the following is a valid ARN:

arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB

Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and hyphens (-).

" - }, - "VolumeId":{ - "shape":"VolumeId", - "documentation":"

The unique identifier assigned to the volume. This ID becomes part of the volume Amazon Resource Name (ARN), which you use as input for other operations.

Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and hyphens (-).

" - }, - "GatewayARN":{"shape":"GatewayARN"}, - "GatewayId":{ - "shape":"GatewayId", - "documentation":"

The unique identifier assigned to your gateway during activation. This ID becomes part of the gateway Amazon Resource Name (ARN), which you use as input for other operations.

Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and hyphens (-).

" - }, - "VolumeType":{"shape":"VolumeType"}, - "VolumeSizeInBytes":{ - "shape":"long", - "documentation":"

The size of the volume in bytes.

Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and hyphens (-).

" - } - }, - "documentation":"

Describes a storage volume object.

" - }, - "VolumeInfos":{ - "type":"list", - "member":{"shape":"VolumeInfo"} - }, - "VolumeRecoveryPointInfo":{ - "type":"structure", - "members":{ - "VolumeARN":{"shape":"VolumeARN"}, - "VolumeSizeInBytes":{"shape":"long"}, - "VolumeUsageInBytes":{"shape":"long"}, - "VolumeRecoveryPointTime":{"shape":"string"} - } - }, - "VolumeRecoveryPointInfos":{ - "type":"list", - "member":{"shape":"VolumeRecoveryPointInfo"} - }, - "VolumeStatus":{ - "type":"string", - "max":50, - "min":3 - }, - "VolumeType":{ - "type":"string", - "max":100, - "min":3 - }, - "VolumeUsedInBytes":{"type":"long"}, - "VolumeiSCSIAttributes":{ - "type":"structure", - "members":{ - "TargetARN":{ - "shape":"TargetARN", - "documentation":"

The Amazon Resource Name (ARN) of the volume target.

" - }, - "NetworkInterfaceId":{ - "shape":"NetworkInterfaceId", - "documentation":"

The network interface identifier.

" - }, - "NetworkInterfacePort":{ - "shape":"integer", - "documentation":"

The port used to communicate with iSCSI targets.

" - }, - "LunNumber":{ - "shape":"PositiveIntObject", - "documentation":"

The logical disk number.

" - }, - "ChapEnabled":{ - "shape":"boolean", - "documentation":"

Indicates whether mutual CHAP is enabled for the iSCSI target.

" - } - }, - "documentation":"

Lists iSCSI information about a volume.

" - }, - "boolean":{"type":"boolean"}, - "double":{"type":"double"}, - "errorDetails":{ - "type":"map", - "key":{"shape":"string"}, - "value":{"shape":"string"} - }, - "integer":{"type":"integer"}, - "long":{"type":"long"}, - "string":{"type":"string"} - }, - "documentation":"AWS Storage Gateway Service

AWS Storage Gateway is the service that connects an on-premises software appliance with cloud-based storage to provide seamless and secure integration between an organization's on-premises IT environment and AWS's storage infrastructure. The service enables you to securely upload data to the AWS cloud for cost effective backup and rapid disaster recovery.

Use the following links to get started using the AWS Storage Gateway Service API Reference:

AWS Storage Gateway resource IDs are in uppercase. When you use these resource IDs with the Amazon EC2 API, EC2 expects resource IDs in lowercase. You must change your resource ID to lowercase to use it with the EC2 API. For example, in Storage Gateway the ID for a volume might be vol-AA22BB012345DAF670. When you use this ID with the EC2 API, you must change it to vol-aa22bb012345daf670. Otherwise, the EC2 API might not behave as expected.

IDs for Storage Gateway volumes and Amazon EBS snapshots created from gateway volumes are changing to a longer format. Starting in December 2016, all new volumes and snapshots will be created with a 17-character string. Starting in April 2016, you will be able to use these longer IDs so you can test your systems with the new format. For more information, see Longer EC2 and EBS Resource IDs.

For example, a volume Amazon Resource Name (ARN) with the longer volume ID format looks like the following:

arn:aws:storagegateway:us-west-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABBCCDDEEFFG.

A snapshot ID with the longer ID format looks like the following: snap-78e226633445566ee.

For more information, see Announcement: Heads-up – Longer AWS Storage Gateway volume and snapshot IDs coming in 2016.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/examples-1.json deleted file mode 100644 index 84442a10..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/examples-1.json +++ /dev/null @@ -1,206 +0,0 @@ -{ - "version": "1.0", - "examples": { - "AssumeRole": [ - { - "input": { - "DurationSeconds": 3600, - "ExternalId": "123ABC", - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Stmt1\",\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}]}", - "RoleArn": "arn:aws:iam::123456789012:role/demo", - "RoleSessionName": "Bob" - }, - "output": { - "AssumedRoleUser": { - "Arn": "arn:aws:sts::123456789012:assumed-role/demo/Bob", - "AssumedRoleId": "ARO123EXAMPLE123:Bob" - }, - "Credentials": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "Expiration": "2011-07-15T23:28:33.359Z", - "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", - "SessionToken": "AQoDYXdzEPT//////////wEXAMPLEtc764bNrC9SAPBSM22wDOk4x4HIZ8j4FZTwdQWLWsKWHGBuFqwAeMicRXmxfpSPfIeoIYRqTflfKD8YUuwthAx7mSEI/qkPpKPi/kMcGdQrmGdeehM4IC1NtBmUpp2wUE8phUZampKsburEDy0KPkyQDYwT7WZ0wq5VSXDvp75YU9HFvlRd8Tx6q6fE8YQcHNVXAkiY9q6d+xo0rKwT38xVqr7ZD0u0iPPkUL64lIZbqBAz+scqKmlzm8FDrypNC9Yjc8fPOLn9FX9KSYvKTr4rvx3iSIlTJabIQwj2ICCR/oLxBA==" - }, - "PackedPolicySize": 6 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "to-assume-a-role-1480532402212", - "title": "To assume a role" - } - ], - "AssumeRoleWithWebIdentity": [ - { - "input": { - "DurationSeconds": 3600, - "ProviderId": "www.amazon.com", - "RoleArn": "arn:aws:iam::123456789012:role/FederatedWebIdentityRole", - "RoleSessionName": "app1", - "WebIdentityToken": "Atza%7CIQEBLjAsAhRFiXuWpUXuRvQ9PZL3GMFcYevydwIUFAHZwXZXXXXXXXXJnrulxKDHwy87oGKPznh0D6bEQZTSCzyoCtL_8S07pLpr0zMbn6w1lfVZKNTBdDansFBmtGnIsIapjI6xKR02Yc_2bQ8LZbUXSGm6Ry6_BG7PrtLZtj_dfCTj92xNGed-CrKqjG7nPBjNIL016GGvuS5gSvPRUxWES3VYfm1wl7WTI7jn-Pcb6M-buCgHhFOzTQxod27L9CqnOLio7N3gZAGpsp6n1-AJBOCJckcyXe2c6uD0srOJeZlKUm2eTDVMf8IehDVI0r1QOnTV6KzzAI3OY87Vd_cVMQ" - }, - "output": { - "AssumedRoleUser": { - "Arn": "arn:aws:sts::123456789012:assumed-role/FederatedWebIdentityRole/app1", - "AssumedRoleId": "AROACLKWSDQRAOEXAMPLE:app1" - }, - "Audience": "client.5498841531868486423.1548@apps.example.com", - "Credentials": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "Expiration": "2014-10-24T23:00:23Z", - "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", - "SessionToken": "AQoDYXdzEE0a8ANXXXXXXXXNO1ewxE5TijQyp+IEXAMPLE" - }, - "PackedPolicySize": 123, - "Provider": "www.amazon.com", - "SubjectFromWebIdentityToken": "amzn1.account.AF6RHO7KZU5XRVQJGXK6HEXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "to-assume-a-role-as-an-openid-connect-federated-user-1480533445696", - "title": "To assume a role as an OpenID Connect-federated user" - } - ], - "DecodeAuthorizationMessage": [ - { - "input": { - "EncodedMessage": "" - }, - "output": { - "DecodedMessage": "{\"allowed\": \"false\",\"explicitDeny\": \"false\",\"matchedStatements\": \"\",\"failures\": \"\",\"context\": {\"principal\": {\"id\": \"AIDACKCEVSQ6C2EXAMPLE\",\"name\": \"Bob\",\"arn\": \"arn:aws:iam::123456789012:user/Bob\"},\"action\": \"ec2:StopInstances\",\"resource\": \"arn:aws:ec2:us-east-1:123456789012:instance/i-dd01c9bd\",\"conditions\": [{\"item\": {\"key\": \"ec2:Tenancy\",\"values\": [\"default\"]},{\"item\": {\"key\": \"ec2:ResourceTag/elasticbeanstalk:environment-name\",\"values\": [\"Default-Environment\"]}},(Additional items ...)]}}" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "to-decode-information-about-an-authorization-status-of-a-request-1480533854499", - "title": "To decode information about an authorization status of a request" - } - ], - "GetCallerIdentity": [ - { - "input": { - }, - "output": { - "Account": "123456789012", - "Arn": "arn:aws:iam::123456789012:user/Alice", - "UserId": "AKIAI44QH8DHBEXAMPLE" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example shows a request and response made with the credentials for a user named Alice in the AWS account 123456789012.", - "id": "to-get-details-about-a-calling-iam-user-1480540050376", - "title": "To get details about a calling IAM user" - }, - { - "input": { - }, - "output": { - "Account": "123456789012", - "Arn": "arn:aws:sts::123456789012:assumed-role/my-role-name/my-role-session-name", - "UserId": "AKIAI44QH8DHBEXAMPLE:my-role-session-name" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example shows a request and response made with temporary credentials created by AssumeRole. The name of the assumed role is my-role-name, and the RoleSessionName is set to my-role-session-name.", - "id": "to-get-details-about-a-calling-user-federated-with-assumerole-1480540158545", - "title": "To get details about a calling user federated with AssumeRole" - }, - { - "input": { - }, - "output": { - "Account": "123456789012", - "Arn": "arn:aws:sts::123456789012:federated-user/my-federated-user-name", - "UserId": "123456789012:my-federated-user-name" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example shows a request and response made with temporary credentials created by using GetFederationToken. The Name parameter is set to my-federated-user-name.", - "id": "to-get-details-about-a-calling-user-federated-with-getfederationtoken-1480540231316", - "title": "To get details about a calling user federated with GetFederationToken" - } - ], - "GetFederationToken": [ - { - "input": { - "DurationSeconds": 3600, - "Name": "Bob", - "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Stmt1\",\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}]}" - }, - "output": { - "Credentials": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "Expiration": "2011-07-15T23:28:33.359Z", - "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", - "SessionToken": "AQoDYXdzEPT//////////wEXAMPLEtc764bNrC9SAPBSM22wDOk4x4HIZ8j4FZTwdQWLWsKWHGBuFqwAeMicRXmxfpSPfIeoIYRqTflfKD8YUuwthAx7mSEI/qkPpKPi/kMcGdQrmGdeehM4IC1NtBmUpp2wUE8phUZampKsburEDy0KPkyQDYwT7WZ0wq5VSXDvp75YU9HFvlRd8Tx6q6fE8YQcHNVXAkiY9q6d+xo0rKwT38xVqr7ZD0u0iPPkUL64lIZbqBAz+scqKmlzm8FDrypNC9Yjc8fPOLn9FX9KSYvKTr4rvx3iSIlTJabIQwj2ICCR/oLxBA==" - }, - "FederatedUser": { - "Arn": "arn:aws:sts::123456789012:federated-user/Bob", - "FederatedUserId": "123456789012:Bob" - }, - "PackedPolicySize": 6 - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "to-get-temporary-credentials-for-a-role-by-using-getfederationtoken-1480540749900", - "title": "To get temporary credentials for a role by using GetFederationToken" - } - ], - "GetSessionToken": [ - { - "input": { - "DurationSeconds": 3600, - "SerialNumber": "YourMFASerialNumber", - "TokenCode": "123456" - }, - "output": { - "Credentials": { - "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", - "Expiration": "2011-07-11T19:55:29.611Z", - "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY", - "SessionToken": "AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4OlgkBN9bkUDNCJiBeb/AXlzBBko7b15fjrBs2+cTQtpZ3CYWFXG8C5zqx37wnOE49mRl/+OtkIKGO7fAE" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "", - "id": "to-get-temporary-credentials-for-an-iam-user-or-an-aws-account-1480540814038", - "title": "To get temporary credentials for an IAM user or an AWS account" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/service-2.json deleted file mode 100644 index 4be790cf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/sts/2011-06-15/service-2.json +++ /dev/null @@ -1,723 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2011-06-15", - "endpointPrefix":"sts", - "globalEndpoint":"sts.amazonaws.com", - "protocol":"query", - "serviceAbbreviation":"AWS STS", - "serviceFullName":"AWS Security Token Service", - "serviceId":"STS", - "signatureVersion":"v4", - "uid":"sts-2011-06-15", - "xmlNamespace":"https://sts.amazonaws.com/doc/2011-06-15/" - }, - "operations":{ - "AssumeRole":{ - "name":"AssumeRole", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssumeRoleRequest"}, - "output":{ - "shape":"AssumeRoleResponse", - "resultWrapper":"AssumeRoleResult" - }, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PackedPolicyTooLargeException"}, - {"shape":"RegionDisabledException"} - ], - "documentation":"

Returns a set of temporary security credentials (consisting of an access key ID, a secret access key, and a security token) that you can use to access AWS resources that you might not normally have access to. Typically, you use AssumeRole for cross-account access or federation. For a comparison of AssumeRole with the other APIs that produce temporary credentials, see Requesting Temporary Security Credentials and Comparing the AWS STS APIs in the IAM User Guide.

Important: You cannot call AssumeRole by using AWS root account credentials; access is denied. You must use credentials for an IAM user or an IAM role to call AssumeRole.

For cross-account access, imagine that you own multiple accounts and need to access resources in each account. You could create long-term credentials in each account to access those resources. However, managing all those credentials and remembering which one can access which account can be time consuming. Instead, you can create one set of long-term credentials in one account and then use temporary security credentials to access all the other accounts by assuming roles in those accounts. For more information about roles, see IAM Roles (Delegation and Federation) in the IAM User Guide.

For federation, you can, for example, grant single sign-on access to the AWS Management Console. If you already have an identity and authentication system in your corporate network, you don't have to recreate user identities in AWS in order to grant those user identities access to AWS. Instead, after a user has been authenticated, you call AssumeRole (and specify the role with the appropriate permissions) to get temporary security credentials for that user. With those temporary security credentials, you construct a sign-in URL that users can use to access the console. For more information, see Common Scenarios for Temporary Credentials in the IAM User Guide.

By default, the temporary security credentials created by AssumeRole last for one hour. However, you can use the optional DurationSeconds parameter to specify the duration of your session. You can provide a value from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide. The maximum session duration limit applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide.

The temporary security credentials created by AssumeRole can be used to make API calls to any AWS service with the following exception: you cannot call the STS service's GetFederationToken or GetSessionToken APIs.

Optionally, you can pass an IAM access policy to this operation. If you choose not to pass a policy, the temporary security credentials that are returned by the operation have the permissions that are defined in the access policy of the role that is being assumed. If you pass a policy to this operation, the temporary security credentials that are returned by the operation have the permissions that are allowed by both the access policy of the role that is being assumed, and the policy that you pass. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, see Permissions for AssumeRole, AssumeRoleWithSAML, and AssumeRoleWithWebIdentity in the IAM User Guide.

To assume a role, your AWS account must be trusted by the role. The trust relationship is defined in the role's trust policy when the role is created. That trust policy states which accounts are allowed to delegate access to this account's role.

The user who wants to access the role must also have permissions delegated from the role's administrator. If the user is in a different account than the role, then the user's administrator must attach a policy that allows the user to call AssumeRole on the ARN of the role in the other account. If the user is in the same account as the role, then you can either attach a policy to the user (identical to the previous different account user), or you can add the user as a principal directly in the role's trust policy. In this case, the trust policy acts as the only resource-based policy in IAM, and users in the same account as the role do not need explicit permission to assume the role. For more information about trust policies and resource-based policies, see IAM Policies in the IAM User Guide.

Using MFA with AssumeRole

You can optionally include multi-factor authentication (MFA) information when you call AssumeRole. This is useful for cross-account scenarios in which you want to make sure that the user who is assuming the role has been authenticated using an AWS MFA device. In that scenario, the trust policy of the role being assumed includes a condition that tests for MFA authentication; if the caller does not include valid MFA information, the request to assume the role is denied. The condition in a trust policy that tests for MFA authentication might look like the following example.

\"Condition\": {\"Bool\": {\"aws:MultiFactorAuthPresent\": true}}

For more information, see Configuring MFA-Protected API Access in the IAM User Guide guide.

To use MFA with AssumeRole, you pass values for the SerialNumber and TokenCode parameters. The SerialNumber value identifies the user's hardware or virtual MFA device. The TokenCode is the time-based one-time password (TOTP) that the MFA devices produces.

" - }, - "AssumeRoleWithSAML":{ - "name":"AssumeRoleWithSAML", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssumeRoleWithSAMLRequest"}, - "output":{ - "shape":"AssumeRoleWithSAMLResponse", - "resultWrapper":"AssumeRoleWithSAMLResult" - }, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PackedPolicyTooLargeException"}, - {"shape":"IDPRejectedClaimException"}, - {"shape":"InvalidIdentityTokenException"}, - {"shape":"ExpiredTokenException"}, - {"shape":"RegionDisabledException"} - ], - "documentation":"

Returns a set of temporary security credentials for users who have been authenticated via a SAML authentication response. This operation provides a mechanism for tying an enterprise identity store or directory to role-based AWS access without user-specific credentials or configuration. For a comparison of AssumeRoleWithSAML with the other APIs that produce temporary credentials, see Requesting Temporary Security Credentials and Comparing the AWS STS APIs in the IAM User Guide.

The temporary security credentials returned by this operation consist of an access key ID, a secret access key, and a security token. Applications can use these temporary security credentials to sign calls to AWS services.

By default, the temporary security credentials created by AssumeRoleWithSAML last for one hour. However, you can use the optional DurationSeconds parameter to specify the duration of your session. Your role session lasts for the duration that you specify, or until the time specified in the SAML authentication response's SessionNotOnOrAfter value, whichever is shorter. You can provide a DurationSeconds value from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide. The maximum session duration limit applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide.

The temporary security credentials created by AssumeRoleWithSAML can be used to make API calls to any AWS service with the following exception: you cannot call the STS service's GetFederationToken or GetSessionToken APIs.

Optionally, you can pass an IAM access policy to this operation. If you choose not to pass a policy, the temporary security credentials that are returned by the operation have the permissions that are defined in the access policy of the role that is being assumed. If you pass a policy to this operation, the temporary security credentials that are returned by the operation have the permissions that are allowed by the intersection of both the access policy of the role that is being assumed, and the policy that you pass. This means that both policies must grant the permission for the action to be allowed. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, see Permissions for AssumeRole, AssumeRoleWithSAML, and AssumeRoleWithWebIdentity in the IAM User Guide.

Before your application can call AssumeRoleWithSAML, you must configure your SAML identity provider (IdP) to issue the claims required by AWS. Additionally, you must use AWS Identity and Access Management (IAM) to create a SAML provider entity in your AWS account that represents your identity provider, and create an IAM role that specifies this SAML provider in its trust policy.

Calling AssumeRoleWithSAML does not require the use of AWS security credentials. The identity of the caller is validated by using keys in the metadata document that is uploaded for the SAML provider entity for your identity provider.

Calling AssumeRoleWithSAML can result in an entry in your AWS CloudTrail logs. The entry includes the value in the NameID element of the SAML assertion. We recommend that you use a NameIDType that is not associated with any personally identifiable information (PII). For example, you could instead use the Persistent Identifier (urn:oasis:names:tc:SAML:2.0:nameid-format:persistent).

For more information, see the following resources:

" - }, - "AssumeRoleWithWebIdentity":{ - "name":"AssumeRoleWithWebIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssumeRoleWithWebIdentityRequest"}, - "output":{ - "shape":"AssumeRoleWithWebIdentityResponse", - "resultWrapper":"AssumeRoleWithWebIdentityResult" - }, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PackedPolicyTooLargeException"}, - {"shape":"IDPRejectedClaimException"}, - {"shape":"IDPCommunicationErrorException"}, - {"shape":"InvalidIdentityTokenException"}, - {"shape":"ExpiredTokenException"}, - {"shape":"RegionDisabledException"} - ], - "documentation":"

Returns a set of temporary security credentials for users who have been authenticated in a mobile or web application with a web identity provider, such as Amazon Cognito, Login with Amazon, Facebook, Google, or any OpenID Connect-compatible identity provider.

For mobile applications, we recommend that you use Amazon Cognito. You can use Amazon Cognito with the AWS SDK for iOS and the AWS SDK for Android to uniquely identify a user and supply the user with a consistent identity throughout the lifetime of an application.

To learn more about Amazon Cognito, see Amazon Cognito Overview in the AWS SDK for Android Developer Guide guide and Amazon Cognito Overview in the AWS SDK for iOS Developer Guide.

Calling AssumeRoleWithWebIdentity does not require the use of AWS security credentials. Therefore, you can distribute an application (for example, on mobile devices) that requests temporary security credentials without including long-term AWS credentials in the application, and without deploying server-based proxy services that use long-term AWS credentials. Instead, the identity of the caller is validated by using a token from the web identity provider. For a comparison of AssumeRoleWithWebIdentity with the other APIs that produce temporary credentials, see Requesting Temporary Security Credentials and Comparing the AWS STS APIs in the IAM User Guide.

The temporary security credentials returned by this API consist of an access key ID, a secret access key, and a security token. Applications can use these temporary security credentials to sign calls to AWS service APIs.

By default, the temporary security credentials created by AssumeRoleWithWebIdentity last for one hour. However, you can use the optional DurationSeconds parameter to specify the duration of your session. You can provide a value from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide. The maximum session duration limit applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide.

The temporary security credentials created by AssumeRoleWithWebIdentity can be used to make API calls to any AWS service with the following exception: you cannot call the STS service's GetFederationToken or GetSessionToken APIs.

Optionally, you can pass an IAM access policy to this operation. If you choose not to pass a policy, the temporary security credentials that are returned by the operation have the permissions that are defined in the access policy of the role that is being assumed. If you pass a policy to this operation, the temporary security credentials that are returned by the operation have the permissions that are allowed by both the access policy of the role that is being assumed, and the policy that you pass. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, see Permissions for AssumeRole, AssumeRoleWithSAML, and AssumeRoleWithWebIdentity in the IAM User Guide.

Before your application can call AssumeRoleWithWebIdentity, you must have an identity token from a supported identity provider and create a role that the application can assume. The role that your application assumes must trust the identity provider that is associated with the identity token. In other words, the identity provider must be specified in the role's trust policy.

Calling AssumeRoleWithWebIdentity can result in an entry in your AWS CloudTrail logs. The entry includes the Subject of the provided Web Identity Token. We recommend that you avoid using any personally identifiable information (PII) in this field. For example, you could instead use a GUID or a pairwise identifier, as suggested in the OIDC specification.

For more information about how to use web identity federation and the AssumeRoleWithWebIdentity API, see the following resources:

" - }, - "DecodeAuthorizationMessage":{ - "name":"DecodeAuthorizationMessage", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DecodeAuthorizationMessageRequest"}, - "output":{ - "shape":"DecodeAuthorizationMessageResponse", - "resultWrapper":"DecodeAuthorizationMessageResult" - }, - "errors":[ - {"shape":"InvalidAuthorizationMessageException"} - ], - "documentation":"

Decodes additional information about the authorization status of a request from an encoded message returned in response to an AWS request.

For example, if a user is not authorized to perform an action that he or she has requested, the request returns a Client.UnauthorizedOperation response (an HTTP 403 response). Some AWS actions additionally return an encoded message that can provide details about this authorization failure.

Only certain AWS actions return an encoded authorization message. The documentation for an individual action indicates whether that action returns an encoded message in addition to returning an HTTP code.

The message is encoded because the details of the authorization status can constitute privileged information that the user who requested the action should not see. To decode an authorization status message, a user must be granted permissions via an IAM policy to request the DecodeAuthorizationMessage (sts:DecodeAuthorizationMessage) action.

The decoded message includes the following type of information:

  • Whether the request was denied due to an explicit deny or due to the absence of an explicit allow. For more information, see Determining Whether a Request is Allowed or Denied in the IAM User Guide.

  • The principal who made the request.

  • The requested action.

  • The requested resource.

  • The values of condition keys in the context of the user's request.

" - }, - "GetCallerIdentity":{ - "name":"GetCallerIdentity", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetCallerIdentityRequest"}, - "output":{ - "shape":"GetCallerIdentityResponse", - "resultWrapper":"GetCallerIdentityResult" - }, - "documentation":"

Returns details about the IAM identity whose credentials are used to call the API.

" - }, - "GetFederationToken":{ - "name":"GetFederationToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetFederationTokenRequest"}, - "output":{ - "shape":"GetFederationTokenResponse", - "resultWrapper":"GetFederationTokenResult" - }, - "errors":[ - {"shape":"MalformedPolicyDocumentException"}, - {"shape":"PackedPolicyTooLargeException"}, - {"shape":"RegionDisabledException"} - ], - "documentation":"

Returns a set of temporary security credentials (consisting of an access key ID, a secret access key, and a security token) for a federated user. A typical use is in a proxy application that gets temporary security credentials on behalf of distributed applications inside a corporate network. Because you must call the GetFederationToken action using the long-term security credentials of an IAM user, this call is appropriate in contexts where those credentials can be safely stored, usually in a server-based application. For a comparison of GetFederationToken with the other APIs that produce temporary credentials, see Requesting Temporary Security Credentials and Comparing the AWS STS APIs in the IAM User Guide.

If you are creating a mobile-based or browser-based app that can authenticate users using a web identity provider like Login with Amazon, Facebook, Google, or an OpenID Connect-compatible identity provider, we recommend that you use Amazon Cognito or AssumeRoleWithWebIdentity. For more information, see Federation Through a Web-based Identity Provider.

The GetFederationToken action must be called by using the long-term AWS security credentials of an IAM user. You can also call GetFederationToken using the security credentials of an AWS root account, but we do not recommended it. Instead, we recommend that you create an IAM user for the purpose of the proxy application and then attach a policy to the IAM user that limits federated users to only the actions and resources that they need access to. For more information, see IAM Best Practices in the IAM User Guide.

The temporary security credentials that are obtained by using the long-term credentials of an IAM user are valid for the specified duration, from 900 seconds (15 minutes) up to a maximium of 129600 seconds (36 hours). The default is 43200 seconds (12 hours). Temporary credentials that are obtained by using AWS root account credentials have a maximum duration of 3600 seconds (1 hour).

The temporary security credentials created by GetFederationToken can be used to make API calls to any AWS service with the following exceptions:

  • You cannot use these credentials to call any IAM APIs.

  • You cannot call any STS APIs except GetCallerIdentity.

Permissions

The permissions for the temporary security credentials returned by GetFederationToken are determined by a combination of the following:

  • The policy or policies that are attached to the IAM user whose credentials are used to call GetFederationToken.

  • The policy that is passed as a parameter in the call.

The passed policy is attached to the temporary security credentials that result from the GetFederationToken API call--that is, to the federated user. When the federated user makes an AWS request, AWS evaluates the policy attached to the federated user in combination with the policy or policies attached to the IAM user whose credentials were used to call GetFederationToken. AWS allows the federated user's request only when both the federated user and the IAM user are explicitly allowed to perform the requested action. The passed policy cannot grant more permissions than those that are defined in the IAM user policy.

A typical use case is that the permissions of the IAM user whose credentials are used to call GetFederationToken are designed to allow access to all the actions and resources that any federated user will need. Then, for individual users, you pass a policy to the operation that scopes down the permissions to a level that's appropriate to that individual user, using a policy that allows only a subset of permissions that are granted to the IAM user.

If you do not pass a policy, the resulting temporary security credentials have no effective permissions. The only exception is when the temporary security credentials are used to access a resource that has a resource-based policy that specifically allows the federated user to access the resource.

For more information about how permissions work, see Permissions for GetFederationToken. For information about using GetFederationToken to create temporary security credentials, see GetFederationToken—Federation Through a Custom Identity Broker.

" - }, - "GetSessionToken":{ - "name":"GetSessionToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSessionTokenRequest"}, - "output":{ - "shape":"GetSessionTokenResponse", - "resultWrapper":"GetSessionTokenResult" - }, - "errors":[ - {"shape":"RegionDisabledException"} - ], - "documentation":"

Returns a set of temporary credentials for an AWS account or IAM user. The credentials consist of an access key ID, a secret access key, and a security token. Typically, you use GetSessionToken if you want to use MFA to protect programmatic calls to specific AWS APIs like Amazon EC2 StopInstances. MFA-enabled IAM users would need to call GetSessionToken and submit an MFA code that is associated with their MFA device. Using the temporary security credentials that are returned from the call, IAM users can then make programmatic calls to APIs that require MFA authentication. If you do not supply a correct MFA code, then the API returns an access denied error. For a comparison of GetSessionToken with the other APIs that produce temporary credentials, see Requesting Temporary Security Credentials and Comparing the AWS STS APIs in the IAM User Guide.

The GetSessionToken action must be called by using the long-term AWS security credentials of the AWS account or an IAM user. Credentials that are created by IAM users are valid for the duration that you specify, from 900 seconds (15 minutes) up to a maximum of 129600 seconds (36 hours), with a default of 43200 seconds (12 hours); credentials that are created by using account credentials can range from 900 seconds (15 minutes) up to a maximum of 3600 seconds (1 hour), with a default of 1 hour.

The temporary security credentials created by GetSessionToken can be used to make API calls to any AWS service with the following exceptions:

  • You cannot call any IAM APIs unless MFA authentication information is included in the request.

  • You cannot call any STS API except AssumeRole or GetCallerIdentity.

We recommend that you do not call GetSessionToken with root account credentials. Instead, follow our best practices by creating one or more IAM users, giving them the necessary permissions, and using IAM users for everyday interaction with AWS.

The permissions associated with the temporary security credentials returned by GetSessionToken are based on the permissions associated with account or IAM user whose credentials are used to call the action. If GetSessionToken is called using root account credentials, the temporary credentials have root account permissions. Similarly, if GetSessionToken is called using the credentials of an IAM user, the temporary credentials have the same permissions as the IAM user.

For more information about using GetSessionToken to create temporary credentials, go to Temporary Credentials for Users in Untrusted Environments in the IAM User Guide.

" - } - }, - "shapes":{ - "AssumeRoleRequest":{ - "type":"structure", - "required":[ - "RoleArn", - "RoleSessionName" - ], - "members":{ - "RoleArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the role to assume.

" - }, - "RoleSessionName":{ - "shape":"roleSessionNameType", - "documentation":"

An identifier for the assumed role session.

Use the role session name to uniquely identify a session when the same role is assumed by different principals or for different reasons. In cross-account scenarios, the role session name is visible to, and can be logged by the account that owns the role. The role session name is also used in the ARN of the assumed role principal. This means that subsequent cross-account API requests using the temporary security credentials will expose the role session name to the external account in their CloudTrail logs.

The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-

" - }, - "Policy":{ - "shape":"sessionPolicyDocumentType", - "documentation":"

An IAM policy in JSON format.

This parameter is optional. If you pass a policy, the temporary security credentials that are returned by the operation have the permissions that are allowed by both (the intersection of) the access policy of the role that is being assumed, and the policy that you pass. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, see Permissions for AssumeRole, AssumeRoleWithSAML, and AssumeRoleWithWebIdentity in the IAM User Guide.

The format for this parameter, as described by its regex pattern, is a string of characters up to 2048 characters in length. The characters can be any ASCII character from the space character to the end of the valid character list (\\u0020-\\u00FF). It can also include the tab (\\u0009), linefeed (\\u000A), and carriage return (\\u000D) characters.

The policy plain text must be 2048 bytes or shorter. However, an internal conversion compresses it into a packed binary format with a separate limit. The PackedPolicySize response element indicates by percentage how close to the upper size limit the policy is, with 100% equaling the maximum allowed size.

" - }, - "DurationSeconds":{ - "shape":"roleDurationSecondsType", - "documentation":"

The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. If you specify a value higher than this setting, the operation fails. For example, if you specify a session duration of 12 hours, but your administrator set the maximum session duration to 6 hours, your operation fails. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide.

By default, the value is set to 3600 seconds.

The DurationSeconds parameter is separate from the duration of a console session that you might request using the returned credentials. The request to the federation endpoint for a console sign-in token takes a SessionDuration parameter that specifies the maximum length of the console session. For more information, see Creating a URL that Enables Federated Users to Access the AWS Management Console in the IAM User Guide.

" - }, - "ExternalId":{ - "shape":"externalIdType", - "documentation":"

A unique identifier that is used by third parties when assuming roles in their customers' accounts. For each role that the third party can assume, they should instruct their customers to ensure the role's trust policy checks for the external ID that the third party generated. Each time the third party assumes the role, they should pass the customer's external ID. The external ID is useful in order to help third parties bind a role to the customer who created it. For more information about the external ID, see How to Use an External ID When Granting Access to Your AWS Resources to a Third Party in the IAM User Guide.

The regex used to validated this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@:/-

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The identification number of the MFA device that is associated with the user who is making the AssumeRole call. Specify this value if the trust policy of the role being assumed includes a condition that requires MFA authentication. The value is either the serial number for a hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device (such as arn:aws:iam::123456789012:mfa/user).

The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-

" - }, - "TokenCode":{ - "shape":"tokenCodeType", - "documentation":"

The value provided by the MFA device, if the trust policy of the role being assumed requires MFA (that is, if the policy includes a condition that tests for MFA). If the role being assumed requires MFA and if the TokenCode value is missing or expired, the AssumeRole call returns an \"access denied\" error.

The format for this parameter, as described by its regex pattern, is a sequence of six numeric digits.

" - } - } - }, - "AssumeRoleResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.

Note: The size of the security token that STS APIs return is not fixed. We strongly recommend that you make no assumptions about the maximum size. As of this writing, the typical size is less than 4096 bytes, but that can vary. Also, future updates to AWS might require larger sizes.

" - }, - "AssumedRoleUser":{ - "shape":"AssumedRoleUser", - "documentation":"

The Amazon Resource Name (ARN) and the assumed role ID, which are identifiers that you can use to refer to the resulting temporary security credentials. For example, you can reference these credentials as a principal in a resource-based policy by using the ARN or assumed role ID. The ARN and ID include the RoleSessionName that you specified when you called AssumeRole.

" - }, - "PackedPolicySize":{ - "shape":"nonNegativeIntegerType", - "documentation":"

A percentage value that indicates the size of the policy in packed form. The service rejects any policy with a packed size greater than 100 percent, which means the policy exceeded the allowed space.

" - } - }, - "documentation":"

Contains the response to a successful AssumeRole request, including temporary AWS credentials that can be used to make AWS requests.

" - }, - "AssumeRoleWithSAMLRequest":{ - "type":"structure", - "required":[ - "RoleArn", - "PrincipalArn", - "SAMLAssertion" - ], - "members":{ - "RoleArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the role that the caller is assuming.

" - }, - "PrincipalArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the SAML provider in IAM that describes the IdP.

" - }, - "SAMLAssertion":{ - "shape":"SAMLAssertionType", - "documentation":"

The base-64 encoded SAML authentication response provided by the IdP.

For more information, see Configuring a Relying Party and Adding Claims in the Using IAM guide.

" - }, - "Policy":{ - "shape":"sessionPolicyDocumentType", - "documentation":"

An IAM policy in JSON format.

The policy parameter is optional. If you pass a policy, the temporary security credentials that are returned by the operation have the permissions that are allowed by both the access policy of the role that is being assumed, and the policy that you pass. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, Permissions for AssumeRole, AssumeRoleWithSAML, and AssumeRoleWithWebIdentity in the IAM User Guide.

The format for this parameter, as described by its regex pattern, is a string of characters up to 2048 characters in length. The characters can be any ASCII character from the space character to the end of the valid character list (\\u0020-\\u00FF). It can also include the tab (\\u0009), linefeed (\\u000A), and carriage return (\\u000D) characters.

The policy plain text must be 2048 bytes or shorter. However, an internal conversion compresses it into a packed binary format with a separate limit. The PackedPolicySize response element indicates by percentage how close to the upper size limit the policy is, with 100% equaling the maximum allowed size.

" - }, - "DurationSeconds":{ - "shape":"roleDurationSecondsType", - "documentation":"

The duration, in seconds, of the role session. Your role session lasts for the duration that you specify for the DurationSeconds parameter, or until the time specified in the SAML authentication response's SessionNotOnOrAfter value, whichever is shorter. You can provide a DurationSeconds value from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. If you specify a value higher than this setting, the operation fails. For example, if you specify a session duration of 12 hours, but your administrator set the maximum session duration to 6 hours, your operation fails. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide.

By default, the value is set to 3600 seconds.

The DurationSeconds parameter is separate from the duration of a console session that you might request using the returned credentials. The request to the federation endpoint for a console sign-in token takes a SessionDuration parameter that specifies the maximum length of the console session. For more information, see Creating a URL that Enables Federated Users to Access the AWS Management Console in the IAM User Guide.

" - } - } - }, - "AssumeRoleWithSAMLResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.

Note: The size of the security token that STS APIs return is not fixed. We strongly recommend that you make no assumptions about the maximum size. As of this writing, the typical size is less than 4096 bytes, but that can vary. Also, future updates to AWS might require larger sizes.

" - }, - "AssumedRoleUser":{ - "shape":"AssumedRoleUser", - "documentation":"

The identifiers for the temporary security credentials that the operation returns.

" - }, - "PackedPolicySize":{ - "shape":"nonNegativeIntegerType", - "documentation":"

A percentage value that indicates the size of the policy in packed form. The service rejects any policy with a packed size greater than 100 percent, which means the policy exceeded the allowed space.

" - }, - "Subject":{ - "shape":"Subject", - "documentation":"

The value of the NameID element in the Subject element of the SAML assertion.

" - }, - "SubjectType":{ - "shape":"SubjectType", - "documentation":"

The format of the name ID, as defined by the Format attribute in the NameID element of the SAML assertion. Typical examples of the format are transient or persistent.

If the format includes the prefix urn:oasis:names:tc:SAML:2.0:nameid-format, that prefix is removed. For example, urn:oasis:names:tc:SAML:2.0:nameid-format:transient is returned as transient. If the format includes any other prefix, the format is returned with no modifications.

" - }, - "Issuer":{ - "shape":"Issuer", - "documentation":"

The value of the Issuer element of the SAML assertion.

" - }, - "Audience":{ - "shape":"Audience", - "documentation":"

The value of the Recipient attribute of the SubjectConfirmationData element of the SAML assertion.

" - }, - "NameQualifier":{ - "shape":"NameQualifier", - "documentation":"

A hash value based on the concatenation of the Issuer response value, the AWS account ID, and the friendly name (the last part of the ARN) of the SAML provider in IAM. The combination of NameQualifier and Subject can be used to uniquely identify a federated user.

The following pseudocode shows how the hash value is calculated:

BASE64 ( SHA1 ( \"https://example.com/saml\" + \"123456789012\" + \"/MySAMLIdP\" ) )

" - } - }, - "documentation":"

Contains the response to a successful AssumeRoleWithSAML request, including temporary AWS credentials that can be used to make AWS requests.

" - }, - "AssumeRoleWithWebIdentityRequest":{ - "type":"structure", - "required":[ - "RoleArn", - "RoleSessionName", - "WebIdentityToken" - ], - "members":{ - "RoleArn":{ - "shape":"arnType", - "documentation":"

The Amazon Resource Name (ARN) of the role that the caller is assuming.

" - }, - "RoleSessionName":{ - "shape":"roleSessionNameType", - "documentation":"

An identifier for the assumed role session. Typically, you pass the name or identifier that is associated with the user who is using your application. That way, the temporary security credentials that your application will use are associated with that user. This session name is included as part of the ARN and assumed role ID in the AssumedRoleUser response element.

The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-

" - }, - "WebIdentityToken":{ - "shape":"clientTokenType", - "documentation":"

The OAuth 2.0 access token or OpenID Connect ID token that is provided by the identity provider. Your application must get this token by authenticating the user who is using your application with a web identity provider before the application makes an AssumeRoleWithWebIdentity call.

" - }, - "ProviderId":{ - "shape":"urlType", - "documentation":"

The fully qualified host component of the domain name of the identity provider.

Specify this value only for OAuth 2.0 access tokens. Currently www.amazon.com and graph.facebook.com are the only supported identity providers for OAuth 2.0 access tokens. Do not include URL schemes and port numbers.

Do not specify this value for OpenID Connect ID tokens.

" - }, - "Policy":{ - "shape":"sessionPolicyDocumentType", - "documentation":"

An IAM policy in JSON format.

The policy parameter is optional. If you pass a policy, the temporary security credentials that are returned by the operation have the permissions that are allowed by both the access policy of the role that is being assumed, and the policy that you pass. This gives you a way to further restrict the permissions for the resulting temporary security credentials. You cannot use the passed policy to grant permissions that are in excess of those allowed by the access policy of the role that is being assumed. For more information, see Permissions for AssumeRoleWithWebIdentity in the IAM User Guide.

The format for this parameter, as described by its regex pattern, is a string of characters up to 2048 characters in length. The characters can be any ASCII character from the space character to the end of the valid character list (\\u0020-\\u00FF). It can also include the tab (\\u0009), linefeed (\\u000A), and carriage return (\\u000D) characters.

The policy plain text must be 2048 bytes or shorter. However, an internal conversion compresses it into a packed binary format with a separate limit. The PackedPolicySize response element indicates by percentage how close to the upper size limit the policy is, with 100% equaling the maximum allowed size.

" - }, - "DurationSeconds":{ - "shape":"roleDurationSecondsType", - "documentation":"

The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. This setting can have a value from 1 hour to 12 hours. If you specify a value higher than this setting, the operation fails. For example, if you specify a session duration of 12 hours, but your administrator set the maximum session duration to 6 hours, your operation fails. To learn how to view the maximum value for your role, see View the Maximum Session Duration Setting for a Role in the IAM User Guide.

By default, the value is set to 3600 seconds.

The DurationSeconds parameter is separate from the duration of a console session that you might request using the returned credentials. The request to the federation endpoint for a console sign-in token takes a SessionDuration parameter that specifies the maximum length of the console session. For more information, see Creating a URL that Enables Federated Users to Access the AWS Management Console in the IAM User Guide.

" - } - } - }, - "AssumeRoleWithWebIdentityResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The temporary security credentials, which include an access key ID, a secret access key, and a security token.

Note: The size of the security token that STS APIs return is not fixed. We strongly recommend that you make no assumptions about the maximum size. As of this writing, the typical size is less than 4096 bytes, but that can vary. Also, future updates to AWS might require larger sizes.

" - }, - "SubjectFromWebIdentityToken":{ - "shape":"webIdentitySubjectType", - "documentation":"

The unique user identifier that is returned by the identity provider. This identifier is associated with the WebIdentityToken that was submitted with the AssumeRoleWithWebIdentity call. The identifier is typically unique to the user and the application that acquired the WebIdentityToken (pairwise identifier). For OpenID Connect ID tokens, this field contains the value returned by the identity provider as the token's sub (Subject) claim.

" - }, - "AssumedRoleUser":{ - "shape":"AssumedRoleUser", - "documentation":"

The Amazon Resource Name (ARN) and the assumed role ID, which are identifiers that you can use to refer to the resulting temporary security credentials. For example, you can reference these credentials as a principal in a resource-based policy by using the ARN or assumed role ID. The ARN and ID include the RoleSessionName that you specified when you called AssumeRole.

" - }, - "PackedPolicySize":{ - "shape":"nonNegativeIntegerType", - "documentation":"

A percentage value that indicates the size of the policy in packed form. The service rejects any policy with a packed size greater than 100 percent, which means the policy exceeded the allowed space.

" - }, - "Provider":{ - "shape":"Issuer", - "documentation":"

The issuing authority of the web identity token presented. For OpenID Connect ID Tokens this contains the value of the iss field. For OAuth 2.0 access tokens, this contains the value of the ProviderId parameter that was passed in the AssumeRoleWithWebIdentity request.

" - }, - "Audience":{ - "shape":"Audience", - "documentation":"

The intended audience (also known as client ID) of the web identity token. This is traditionally the client identifier issued to the application that requested the web identity token.

" - } - }, - "documentation":"

Contains the response to a successful AssumeRoleWithWebIdentity request, including temporary AWS credentials that can be used to make AWS requests.

" - }, - "AssumedRoleUser":{ - "type":"structure", - "required":[ - "AssumedRoleId", - "Arn" - ], - "members":{ - "AssumedRoleId":{ - "shape":"assumedRoleIdType", - "documentation":"

A unique identifier that contains the role ID and the role session name of the role that is being assumed. The role ID is generated by AWS when the role is created.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The ARN of the temporary security credentials that are returned from the AssumeRole action. For more information about ARNs and how to use them in policies, see IAM Identifiers in Using IAM.

" - } - }, - "documentation":"

The identifiers for the temporary security credentials that the operation returns.

" - }, - "Audience":{"type":"string"}, - "Credentials":{ - "type":"structure", - "required":[ - "AccessKeyId", - "SecretAccessKey", - "SessionToken", - "Expiration" - ], - "members":{ - "AccessKeyId":{ - "shape":"accessKeyIdType", - "documentation":"

The access key ID that identifies the temporary security credentials.

" - }, - "SecretAccessKey":{ - "shape":"accessKeySecretType", - "documentation":"

The secret access key that can be used to sign requests.

" - }, - "SessionToken":{ - "shape":"tokenType", - "documentation":"

The token that users must pass to the service API to use the temporary credentials.

" - }, - "Expiration":{ - "shape":"dateType", - "documentation":"

The date on which the current credentials expire.

" - } - }, - "documentation":"

AWS credentials for API authentication.

" - }, - "DecodeAuthorizationMessageRequest":{ - "type":"structure", - "required":["EncodedMessage"], - "members":{ - "EncodedMessage":{ - "shape":"encodedMessageType", - "documentation":"

The encoded message that was returned with the response.

" - } - } - }, - "DecodeAuthorizationMessageResponse":{ - "type":"structure", - "members":{ - "DecodedMessage":{ - "shape":"decodedMessageType", - "documentation":"

An XML document that contains the decoded message.

" - } - }, - "documentation":"

A document that contains additional information about the authorization status of a request from an encoded message that is returned in response to an AWS request.

" - }, - "ExpiredTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"expiredIdentityTokenMessage"} - }, - "documentation":"

The web identity token that was passed is expired or is not valid. Get a new identity token from the identity provider and then retry the request.

", - "error":{ - "code":"ExpiredTokenException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "FederatedUser":{ - "type":"structure", - "required":[ - "FederatedUserId", - "Arn" - ], - "members":{ - "FederatedUserId":{ - "shape":"federatedIdType", - "documentation":"

The string that identifies the federated user associated with the credentials, similar to the unique ID of an IAM user.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The ARN that specifies the federated user that is associated with the credentials. For more information about ARNs and how to use them in policies, see IAM Identifiers in Using IAM.

" - } - }, - "documentation":"

Identifiers for the federated user that is associated with the credentials.

" - }, - "GetCallerIdentityRequest":{ - "type":"structure", - "members":{ - } - }, - "GetCallerIdentityResponse":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"userIdType", - "documentation":"

The unique identifier of the calling entity. The exact value depends on the type of entity making the call. The values returned are those listed in the aws:userid column in the Principal table found on the Policy Variables reference page in the IAM User Guide.

" - }, - "Account":{ - "shape":"accountType", - "documentation":"

The AWS account ID number of the account that owns or contains the calling entity.

" - }, - "Arn":{ - "shape":"arnType", - "documentation":"

The AWS ARN associated with the calling entity.

" - } - }, - "documentation":"

Contains the response to a successful GetCallerIdentity request, including information about the entity making the request.

" - }, - "GetFederationTokenRequest":{ - "type":"structure", - "required":["Name"], - "members":{ - "Name":{ - "shape":"userNameType", - "documentation":"

The name of the federated user. The name is used as an identifier for the temporary security credentials (such as Bob). For example, you can reference the federated user name in a resource-based policy, such as in an Amazon S3 bucket policy.

The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-

" - }, - "Policy":{ - "shape":"sessionPolicyDocumentType", - "documentation":"

An IAM policy in JSON format that is passed with the GetFederationToken call and evaluated along with the policy or policies that are attached to the IAM user whose credentials are used to call GetFederationToken. The passed policy is used to scope down the permissions that are available to the IAM user, by allowing only a subset of the permissions that are granted to the IAM user. The passed policy cannot grant more permissions than those granted to the IAM user. The final permissions for the federated user are the most restrictive set based on the intersection of the passed policy and the IAM user policy.

If you do not pass a policy, the resulting temporary security credentials have no effective permissions. The only exception is when the temporary security credentials are used to access a resource that has a resource-based policy that specifically allows the federated user to access the resource.

The format for this parameter, as described by its regex pattern, is a string of characters up to 2048 characters in length. The characters can be any ASCII character from the space character to the end of the valid character list (\\u0020-\\u00FF). It can also include the tab (\\u0009), linefeed (\\u000A), and carriage return (\\u000D) characters.

The policy plain text must be 2048 bytes or shorter. However, an internal conversion compresses it into a packed binary format with a separate limit. The PackedPolicySize response element indicates by percentage how close to the upper size limit the policy is, with 100% equaling the maximum allowed size.

For more information about how permissions work, see Permissions for GetFederationToken.

" - }, - "DurationSeconds":{ - "shape":"durationSecondsType", - "documentation":"

The duration, in seconds, that the session should last. Acceptable durations for federation sessions range from 900 seconds (15 minutes) to 129600 seconds (36 hours), with 43200 seconds (12 hours) as the default. Sessions obtained using AWS account (root) credentials are restricted to a maximum of 3600 seconds (one hour). If the specified duration is longer than one hour, the session obtained by using AWS account (root) credentials defaults to one hour.

" - } - } - }, - "GetFederationTokenResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.

Note: The size of the security token that STS APIs return is not fixed. We strongly recommend that you make no assumptions about the maximum size. As of this writing, the typical size is less than 4096 bytes, but that can vary. Also, future updates to AWS might require larger sizes.

" - }, - "FederatedUser":{ - "shape":"FederatedUser", - "documentation":"

Identifiers for the federated user associated with the credentials (such as arn:aws:sts::123456789012:federated-user/Bob or 123456789012:Bob). You can use the federated user's ARN in your resource-based policies, such as an Amazon S3 bucket policy.

" - }, - "PackedPolicySize":{ - "shape":"nonNegativeIntegerType", - "documentation":"

A percentage value indicating the size of the policy in packed form. The service rejects policies for which the packed size is greater than 100 percent of the allowed value.

" - } - }, - "documentation":"

Contains the response to a successful GetFederationToken request, including temporary AWS credentials that can be used to make AWS requests.

" - }, - "GetSessionTokenRequest":{ - "type":"structure", - "members":{ - "DurationSeconds":{ - "shape":"durationSecondsType", - "documentation":"

The duration, in seconds, that the credentials should remain valid. Acceptable durations for IAM user sessions range from 900 seconds (15 minutes) to 129600 seconds (36 hours), with 43200 seconds (12 hours) as the default. Sessions for AWS account owners are restricted to a maximum of 3600 seconds (one hour). If the duration is longer than one hour, the session for AWS account owners defaults to one hour.

" - }, - "SerialNumber":{ - "shape":"serialNumberType", - "documentation":"

The identification number of the MFA device that is associated with the IAM user who is making the GetSessionToken call. Specify this value if the IAM user has a policy that requires MFA authentication. The value is either the serial number for a hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device (such as arn:aws:iam::123456789012:mfa/user). You can find the device for an IAM user by going to the AWS Management Console and viewing the user's security credentials.

The regex used to validated this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@:/-

" - }, - "TokenCode":{ - "shape":"tokenCodeType", - "documentation":"

The value provided by the MFA device, if MFA is required. If any policy requires the IAM user to submit an MFA code, specify this value. If MFA authentication is required, and the user does not provide a code when requesting a set of temporary security credentials, the user will receive an \"access denied\" response when requesting resources that require MFA authentication.

The format for this parameter, as described by its regex pattern, is a sequence of six numeric digits.

" - } - } - }, - "GetSessionTokenResponse":{ - "type":"structure", - "members":{ - "Credentials":{ - "shape":"Credentials", - "documentation":"

The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.

Note: The size of the security token that STS APIs return is not fixed. We strongly recommend that you make no assumptions about the maximum size. As of this writing, the typical size is less than 4096 bytes, but that can vary. Also, future updates to AWS might require larger sizes.

" - } - }, - "documentation":"

Contains the response to a successful GetSessionToken request, including temporary AWS credentials that can be used to make AWS requests.

" - }, - "IDPCommunicationErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"idpCommunicationErrorMessage"} - }, - "documentation":"

The request could not be fulfilled because the non-AWS identity provider (IDP) that was asked to verify the incoming identity token could not be reached. This is often a transient error caused by network conditions. Retry the request a limited number of times so that you don't exceed the request rate. If the error persists, the non-AWS identity provider might be down or not responding.

", - "error":{ - "code":"IDPCommunicationError", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "IDPRejectedClaimException":{ - "type":"structure", - "members":{ - "message":{"shape":"idpRejectedClaimMessage"} - }, - "documentation":"

The identity provider (IdP) reported that authentication failed. This might be because the claim is invalid.

If this error is returned for the AssumeRoleWithWebIdentity operation, it can also mean that the claim has expired or has been explicitly revoked.

", - "error":{ - "code":"IDPRejectedClaim", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "InvalidAuthorizationMessageException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidAuthorizationMessage"} - }, - "documentation":"

The error returned if the message passed to DecodeAuthorizationMessage was invalid. This can happen if the token contains invalid characters, such as linebreaks.

", - "error":{ - "code":"InvalidAuthorizationMessageException", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "InvalidIdentityTokenException":{ - "type":"structure", - "members":{ - "message":{"shape":"invalidIdentityTokenMessage"} - }, - "documentation":"

The web identity token that was passed could not be validated by AWS. Get a new identity token from the identity provider and then retry the request.

", - "error":{ - "code":"InvalidIdentityToken", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "Issuer":{"type":"string"}, - "MalformedPolicyDocumentException":{ - "type":"structure", - "members":{ - "message":{"shape":"malformedPolicyDocumentMessage"} - }, - "documentation":"

The request was rejected because the policy document was malformed. The error message describes the specific error.

", - "error":{ - "code":"MalformedPolicyDocument", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "NameQualifier":{"type":"string"}, - "PackedPolicyTooLargeException":{ - "type":"structure", - "members":{ - "message":{"shape":"packedPolicyTooLargeMessage"} - }, - "documentation":"

The request was rejected because the policy document was too large. The error message describes how big the policy document is, in packed form, as a percentage of what the API allows.

", - "error":{ - "code":"PackedPolicyTooLarge", - "httpStatusCode":400, - "senderFault":true - }, - "exception":true - }, - "RegionDisabledException":{ - "type":"structure", - "members":{ - "message":{"shape":"regionDisabledMessage"} - }, - "documentation":"

STS is not activated in the requested region for the account that is being asked to generate credentials. The account administrator must use the IAM console to activate STS in that region. For more information, see Activating and Deactivating AWS STS in an AWS Region in the IAM User Guide.

", - "error":{ - "code":"RegionDisabledException", - "httpStatusCode":403, - "senderFault":true - }, - "exception":true - }, - "SAMLAssertionType":{ - "type":"string", - "max":100000, - "min":4 - }, - "Subject":{"type":"string"}, - "SubjectType":{"type":"string"}, - "accessKeyIdType":{ - "type":"string", - "max":128, - "min":16, - "pattern":"[\\w]*" - }, - "accessKeySecretType":{"type":"string"}, - "accountType":{"type":"string"}, - "arnType":{ - "type":"string", - "max":2048, - "min":20, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]+" - }, - "assumedRoleIdType":{ - "type":"string", - "max":193, - "min":2, - "pattern":"[\\w+=,.@:-]*" - }, - "clientTokenType":{ - "type":"string", - "max":2048, - "min":4 - }, - "dateType":{"type":"timestamp"}, - "decodedMessageType":{"type":"string"}, - "durationSecondsType":{ - "type":"integer", - "max":129600, - "min":900 - }, - "encodedMessageType":{ - "type":"string", - "max":10240, - "min":1 - }, - "expiredIdentityTokenMessage":{"type":"string"}, - "externalIdType":{ - "type":"string", - "max":1224, - "min":2, - "pattern":"[\\w+=,.@:\\/-]*" - }, - "federatedIdType":{ - "type":"string", - "max":193, - "min":2, - "pattern":"[\\w+=,.@\\:-]*" - }, - "idpCommunicationErrorMessage":{"type":"string"}, - "idpRejectedClaimMessage":{"type":"string"}, - "invalidAuthorizationMessage":{"type":"string"}, - "invalidIdentityTokenMessage":{"type":"string"}, - "malformedPolicyDocumentMessage":{"type":"string"}, - "nonNegativeIntegerType":{ - "type":"integer", - "min":0 - }, - "packedPolicyTooLargeMessage":{"type":"string"}, - "regionDisabledMessage":{"type":"string"}, - "roleDurationSecondsType":{ - "type":"integer", - "max":43200, - "min":900 - }, - "roleSessionNameType":{ - "type":"string", - "max":64, - "min":2, - "pattern":"[\\w+=,.@-]*" - }, - "serialNumberType":{ - "type":"string", - "max":256, - "min":9, - "pattern":"[\\w+=/:,.@-]*" - }, - "sessionPolicyDocumentType":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" - }, - "tokenCodeType":{ - "type":"string", - "max":6, - "min":6, - "pattern":"[\\d]*" - }, - "tokenType":{"type":"string"}, - "urlType":{ - "type":"string", - "max":2048, - "min":4 - }, - "userIdType":{"type":"string"}, - "userNameType":{ - "type":"string", - "max":32, - "min":2, - "pattern":"[\\w+=,.@-]*" - }, - "webIdentitySubjectType":{ - "type":"string", - "max":255, - "min":6 - } - }, - "documentation":"AWS Security Token Service

The AWS Security Token Service (STS) is a web service that enables you to request temporary, limited-privilege credentials for AWS Identity and Access Management (IAM) users or for users that you authenticate (federated users). This guide provides descriptions of the STS API. For more detailed information about using this service, go to Temporary Security Credentials.

As an alternative to using the API, you can use one of the AWS SDKs, which consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to STS. For example, the SDKs take care of cryptographically signing requests, managing errors, and retrying requests automatically. For information about the AWS SDKs, including how to download and install them, see the Tools for Amazon Web Services page.

For information about setting up signatures and authorization through the API, go to Signing AWS API Requests in the AWS General Reference. For general information about the Query API, go to Making Query Requests in Using IAM. For information about using security tokens with other AWS products, go to AWS Services That Work with IAM in the IAM User Guide.

If you're new to AWS and need additional technical information about a specific AWS product, you can find the product's technical documentation at http://aws.amazon.com/documentation/.

Endpoints

The AWS Security Token Service (STS) has a default endpoint of https://sts.amazonaws.com that maps to the US East (N. Virginia) region. Additional regions are available and are activated by default. For more information, see Activating and Deactivating AWS STS in an AWS Region in the IAM User Guide.

For information about STS endpoints, see Regions and Endpoints in the AWS General Reference.

Recording API requests

STS supports AWS CloudTrail, which is a service that records AWS calls for your AWS account and delivers log files to an Amazon S3 bucket. By using information collected by CloudTrail, you can determine what requests were successfully made to STS, who made the request, when it was made, and so on. To learn more about CloudTrail, including how to turn it on and find your log files, see the AWS CloudTrail User Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/paginators-1.json deleted file mode 100644 index 11bdb62c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/paginators-1.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "pagination": { - "DescribeCases": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "cases" - }, - "DescribeCommunications": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "communications" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/service-2.json deleted file mode 100644 index e86bf787..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/support/2013-04-15/service-2.json +++ /dev/null @@ -1,1221 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "uid":"support-2013-04-15", - "apiVersion":"2013-04-15", - "endpointPrefix":"support", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"AWS Support", - "serviceId":"Support", - "signatureVersion":"v4", - "targetPrefix":"AWSSupport_20130415" - }, - "operations":{ - "AddAttachmentsToSet":{ - "name":"AddAttachmentsToSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddAttachmentsToSetRequest"}, - "output":{"shape":"AddAttachmentsToSetResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"AttachmentSetIdNotFound"}, - {"shape":"AttachmentSetExpired"}, - {"shape":"AttachmentSetSizeLimitExceeded"}, - {"shape":"AttachmentLimitExceeded"} - ], - "documentation":"

Adds one or more attachments to an attachment set. If an attachmentSetId is not specified, a new attachment set is created, and the ID of the set is returned in the response. If an attachmentSetId is specified, the attachments are added to the specified set, if it exists.

An attachment set is a temporary container for attachments that are to be added to a case or case communication. The set is available for one hour after it is created; the expiryTime returned in the response indicates when the set expires. The maximum number of attachments in a set is 3, and the maximum size of any attachment in the set is 5 MB.

" - }, - "AddCommunicationToCase":{ - "name":"AddCommunicationToCase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AddCommunicationToCaseRequest"}, - "output":{"shape":"AddCommunicationToCaseResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"CaseIdNotFound"}, - {"shape":"AttachmentSetIdNotFound"}, - {"shape":"AttachmentSetExpired"} - ], - "documentation":"

Adds additional customer communication to an AWS Support case. You use the caseId value to identify the case to add communication to. You can list a set of email addresses to copy on the communication using the ccEmailAddresses value. The communicationBody value contains the text of the communication.

The response indicates the success or failure of the request.

This operation implements a subset of the features of the AWS Support Center.

" - }, - "CreateCase":{ - "name":"CreateCase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateCaseRequest"}, - "output":{"shape":"CreateCaseResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"CaseCreationLimitExceeded"}, - {"shape":"AttachmentSetIdNotFound"}, - {"shape":"AttachmentSetExpired"} - ], - "documentation":"

Creates a new case in the AWS Support Center. This operation is modeled on the behavior of the AWS Support Center Create Case page. Its parameters require you to specify the following information:

  • issueType. The type of issue for the case. You can specify either \"customer-service\" or \"technical.\" If you do not indicate a value, the default is \"technical.\"

  • serviceCode. The code for an AWS service. You obtain the serviceCode by calling DescribeServices.

  • categoryCode. The category for the service defined for the serviceCode value. You also obtain the category code for a service by calling DescribeServices. Each AWS service defines its own set of category codes.

  • severityCode. A value that indicates the urgency of the case, which in turn determines the response time according to your service level agreement with AWS Support. You obtain the SeverityCode by calling DescribeSeverityLevels.

  • subject. The Subject field on the AWS Support Center Create Case page.

  • communicationBody. The Description field on the AWS Support Center Create Case page.

  • attachmentSetId. The ID of a set of attachments that has been created by using AddAttachmentsToSet.

  • language. The human language in which AWS Support handles the case. English and Japanese are currently supported.

  • ccEmailAddresses. The AWS Support Center CC field on the Create Case page. You can list email addresses to be copied on any correspondence about the case. The account that opens the case is already identified by passing the AWS Credentials in the HTTP POST method or in a method or function call from one of the programming languages supported by an AWS SDK.

To add additional communication or attachments to an existing case, use AddCommunicationToCase.

A successful CreateCase request returns an AWS Support case number. Case numbers are used by the DescribeCases operation to retrieve existing AWS Support cases.

" - }, - "DescribeAttachment":{ - "name":"DescribeAttachment", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeAttachmentRequest"}, - "output":{"shape":"DescribeAttachmentResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"DescribeAttachmentLimitExceeded"}, - {"shape":"AttachmentIdNotFound"} - ], - "documentation":"

Returns the attachment that has the specified ID. Attachment IDs are generated by the case management system when you add an attachment to a case or case communication. Attachment IDs are returned in the AttachmentDetails objects that are returned by the DescribeCommunications operation.

" - }, - "DescribeCases":{ - "name":"DescribeCases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCasesRequest"}, - "output":{"shape":"DescribeCasesResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"CaseIdNotFound"} - ], - "documentation":"

Returns a list of cases that you specify by passing one or more case IDs. In addition, you can filter the cases by date by setting values for the afterTime and beforeTime request parameters. You can set values for the includeResolvedCases and includeCommunications request parameters to control how much information is returned.

Case data is available for 12 months after creation. If a case was created more than 12 months ago, a request for data might cause an error.

The response returns the following in JSON format:

  • One or more CaseDetails data types.

  • One or more nextToken values, which specify where to paginate the returned records represented by the CaseDetails objects.

" - }, - "DescribeCommunications":{ - "name":"DescribeCommunications", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeCommunicationsRequest"}, - "output":{"shape":"DescribeCommunicationsResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"CaseIdNotFound"} - ], - "documentation":"

Returns communications (and attachments) for one or more support cases. You can use the afterTime and beforeTime parameters to filter by date. You can use the caseId parameter to restrict the results to a particular case.

Case data is available for 12 months after creation. If a case was created more than 12 months ago, a request for data might cause an error.

You can use the maxResults and nextToken parameters to control the pagination of the result set. Set maxResults to the number of cases you want displayed on each page, and use nextToken to specify the resumption of pagination.

" - }, - "DescribeServices":{ - "name":"DescribeServices", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeServicesRequest"}, - "output":{"shape":"DescribeServicesResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the current list of AWS services and a list of service categories that applies to each one. You then use service names and categories in your CreateCase requests. Each AWS service has its own set of categories.

The service codes and category codes correspond to the values that are displayed in the Service and Category drop-down lists on the AWS Support Center Create Case page. The values in those fields, however, do not necessarily match the service codes and categories returned by the DescribeServices request. Always use the service codes and categories obtained programmatically. This practice ensures that you always have the most recent set of service and category codes.

" - }, - "DescribeSeverityLevels":{ - "name":"DescribeSeverityLevels", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeSeverityLevelsRequest"}, - "output":{"shape":"DescribeSeverityLevelsResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the list of severity levels that you can assign to an AWS Support case. The severity level for a case is also a field in the CaseDetails data type included in any CreateCase request.

" - }, - "DescribeTrustedAdvisorCheckRefreshStatuses":{ - "name":"DescribeTrustedAdvisorCheckRefreshStatuses", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrustedAdvisorCheckRefreshStatusesRequest"}, - "output":{"shape":"DescribeTrustedAdvisorCheckRefreshStatusesResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the refresh status of the Trusted Advisor checks that have the specified check IDs. Check IDs can be obtained by calling DescribeTrustedAdvisorChecks.

Some checks are refreshed automatically, and their refresh statuses cannot be retrieved by using this operation. Use of the DescribeTrustedAdvisorCheckRefreshStatuses operation for these checks causes an InvalidParameterValue error.

" - }, - "DescribeTrustedAdvisorCheckResult":{ - "name":"DescribeTrustedAdvisorCheckResult", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrustedAdvisorCheckResultRequest"}, - "output":{"shape":"DescribeTrustedAdvisorCheckResultResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the results of the Trusted Advisor check that has the specified check ID. Check IDs can be obtained by calling DescribeTrustedAdvisorChecks.

The response contains a TrustedAdvisorCheckResult object, which contains these three objects:

In addition, the response contains these fields:

  • status. The alert status of the check: \"ok\" (green), \"warning\" (yellow), \"error\" (red), or \"not_available\".

  • timestamp. The time of the last refresh of the check.

  • checkId. The unique identifier for the check.

" - }, - "DescribeTrustedAdvisorCheckSummaries":{ - "name":"DescribeTrustedAdvisorCheckSummaries", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrustedAdvisorCheckSummariesRequest"}, - "output":{"shape":"DescribeTrustedAdvisorCheckSummariesResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns the summaries of the results of the Trusted Advisor checks that have the specified check IDs. Check IDs can be obtained by calling DescribeTrustedAdvisorChecks.

The response contains an array of TrustedAdvisorCheckSummary objects.

" - }, - "DescribeTrustedAdvisorChecks":{ - "name":"DescribeTrustedAdvisorChecks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTrustedAdvisorChecksRequest"}, - "output":{"shape":"DescribeTrustedAdvisorChecksResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Returns information about all available Trusted Advisor checks, including name, ID, category, description, and metadata. You must specify a language code; English (\"en\") and Japanese (\"ja\") are currently supported. The response contains a TrustedAdvisorCheckDescription for each check.

" - }, - "RefreshTrustedAdvisorCheck":{ - "name":"RefreshTrustedAdvisorCheck", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RefreshTrustedAdvisorCheckRequest"}, - "output":{"shape":"RefreshTrustedAdvisorCheckResponse"}, - "errors":[ - {"shape":"InternalServerError"} - ], - "documentation":"

Requests a refresh of the Trusted Advisor check that has the specified check ID. Check IDs can be obtained by calling DescribeTrustedAdvisorChecks.

Some checks are refreshed automatically, and they cannot be refreshed by using this operation. Use of the RefreshTrustedAdvisorCheck operation for these checks causes an InvalidParameterValue error.

The response contains a TrustedAdvisorCheckRefreshStatus object, which contains these fields:

  • status. The refresh status of the check: \"none\", \"enqueued\", \"processing\", \"success\", or \"abandoned\".

  • millisUntilNextRefreshable. The amount of time, in milliseconds, until the check is eligible for refresh.

  • checkId. The unique identifier for the check.

" - }, - "ResolveCase":{ - "name":"ResolveCase", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResolveCaseRequest"}, - "output":{"shape":"ResolveCaseResponse"}, - "errors":[ - {"shape":"InternalServerError"}, - {"shape":"CaseIdNotFound"} - ], - "documentation":"

Takes a caseId and returns the initial state of the case along with the state of the case after the call to ResolveCase completed.

" - } - }, - "shapes":{ - "AddAttachmentsToSetRequest":{ - "type":"structure", - "required":["attachments"], - "members":{ - "attachmentSetId":{ - "shape":"AttachmentSetId", - "documentation":"

The ID of the attachment set. If an attachmentSetId is not specified, a new attachment set is created, and the ID of the set is returned in the response. If an attachmentSetId is specified, the attachments are added to the specified set, if it exists.

" - }, - "attachments":{ - "shape":"Attachments", - "documentation":"

One or more attachments to add to the set. The limit is 3 attachments per set, and the size limit is 5 MB per attachment.

" - } - }, - "documentation":"

" - }, - "AddAttachmentsToSetResponse":{ - "type":"structure", - "members":{ - "attachmentSetId":{ - "shape":"AttachmentSetId", - "documentation":"

The ID of the attachment set. If an attachmentSetId was not specified, a new attachment set is created, and the ID of the set is returned in the response. If an attachmentSetId was specified, the attachments are added to the specified set, if it exists.

" - }, - "expiryTime":{ - "shape":"ExpiryTime", - "documentation":"

The time and date when the attachment set expires.

" - } - }, - "documentation":"

The ID and expiry time of the attachment set returned by the AddAttachmentsToSet operation.

" - }, - "AddCommunicationToCaseRequest":{ - "type":"structure", - "required":["communicationBody"], - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - }, - "communicationBody":{ - "shape":"CommunicationBody", - "documentation":"

The body of an email communication to add to the support case.

" - }, - "ccEmailAddresses":{ - "shape":"CcEmailAddressList", - "documentation":"

The email addresses in the CC line of an email to be added to the support case.

" - }, - "attachmentSetId":{ - "shape":"AttachmentSetId", - "documentation":"

The ID of a set of one or more attachments for the communication to add to the case. Create the set by calling AddAttachmentsToSet

" - } - }, - "documentation":"

To be written.

" - }, - "AddCommunicationToCaseResponse":{ - "type":"structure", - "members":{ - "result":{ - "shape":"Result", - "documentation":"

True if AddCommunicationToCase succeeds. Otherwise, returns an error.

" - } - }, - "documentation":"

The result of the AddCommunicationToCase operation.

" - }, - "AfterTime":{"type":"string"}, - "Attachment":{ - "type":"structure", - "members":{ - "fileName":{ - "shape":"FileName", - "documentation":"

The name of the attachment file.

" - }, - "data":{ - "shape":"Data", - "documentation":"

The content of the attachment file.

" - } - }, - "documentation":"

An attachment to a case communication. The attachment consists of the file name and the content of the file.

" - }, - "AttachmentDetails":{ - "type":"structure", - "members":{ - "attachmentId":{ - "shape":"AttachmentId", - "documentation":"

The ID of the attachment.

" - }, - "fileName":{ - "shape":"FileName", - "documentation":"

The file name of the attachment.

" - } - }, - "documentation":"

The file name and ID of an attachment to a case communication. You can use the ID to retrieve the attachment with the DescribeAttachment operation.

" - }, - "AttachmentId":{"type":"string"}, - "AttachmentIdNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

An attachment with the specified ID could not be found.

" - } - }, - "documentation":"

An attachment with the specified ID could not be found.

", - "exception":true - }, - "AttachmentLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The limit for the number of attachment sets created in a short period of time has been exceeded.

" - } - }, - "documentation":"

The limit for the number of attachment sets created in a short period of time has been exceeded.

", - "exception":true - }, - "AttachmentSet":{ - "type":"list", - "member":{"shape":"AttachmentDetails"} - }, - "AttachmentSetExpired":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The expiration time of the attachment set has passed. The set expires 1 hour after it is created.

" - } - }, - "documentation":"

The expiration time of the attachment set has passed. The set expires 1 hour after it is created.

", - "exception":true - }, - "AttachmentSetId":{"type":"string"}, - "AttachmentSetIdNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

An attachment set with the specified ID could not be found.

" - } - }, - "documentation":"

An attachment set with the specified ID could not be found.

", - "exception":true - }, - "AttachmentSetSizeLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A limit for the size of an attachment set has been exceeded. The limits are 3 attachments and 5 MB per attachment.

" - } - }, - "documentation":"

A limit for the size of an attachment set has been exceeded. The limits are 3 attachments and 5 MB per attachment.

", - "exception":true - }, - "Attachments":{ - "type":"list", - "member":{"shape":"Attachment"} - }, - "BeforeTime":{"type":"string"}, - "Boolean":{"type":"boolean"}, - "CaseCreationLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

An error message that indicates that you have exceeded the number of cases you can have open.

" - } - }, - "documentation":"

The case creation limit for the account has been exceeded.

", - "exception":true - }, - "CaseDetails":{ - "type":"structure", - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - }, - "displayId":{ - "shape":"DisplayId", - "documentation":"

The ID displayed for the case in the AWS Support Center. This is a numeric string.

" - }, - "subject":{ - "shape":"Subject", - "documentation":"

The subject line for the case in the AWS Support Center.

" - }, - "status":{ - "shape":"Status", - "documentation":"

The status of the case.

" - }, - "serviceCode":{ - "shape":"ServiceCode", - "documentation":"

The code for the AWS service returned by the call to DescribeServices.

" - }, - "categoryCode":{ - "shape":"CategoryCode", - "documentation":"

The category of problem for the AWS Support case.

" - }, - "severityCode":{ - "shape":"SeverityCode", - "documentation":"

The code for the severity level returned by the call to DescribeSeverityLevels.

" - }, - "submittedBy":{ - "shape":"SubmittedBy", - "documentation":"

The email address of the account that submitted the case.

" - }, - "timeCreated":{ - "shape":"TimeCreated", - "documentation":"

The time that the case was case created in the AWS Support Center.

" - }, - "recentCommunications":{ - "shape":"RecentCaseCommunications", - "documentation":"

The five most recent communications between you and AWS Support Center, including the IDs of any attachments to the communications. Also includes a nextToken that you can use to retrieve earlier communications.

" - }, - "ccEmailAddresses":{ - "shape":"CcEmailAddressList", - "documentation":"

The email addresses that receive copies of communication about the case.

" - }, - "language":{ - "shape":"Language", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - } - }, - "documentation":"

A JSON-formatted object that contains the metadata for a support case. It is contained the response from a DescribeCases request. CaseDetails contains the following fields:

  • caseId. The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47.

  • categoryCode. The category of problem for the AWS Support case. Corresponds to the CategoryCode values returned by a call to DescribeServices.

  • displayId. The identifier for the case on pages in the AWS Support Center.

  • language. The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

  • recentCommunications. One or more Communication objects. Fields of these objects are attachments, body, caseId, submittedBy, and timeCreated.

  • nextToken. A resumption point for pagination.

  • serviceCode. The identifier for the AWS service that corresponds to the service code defined in the call to DescribeServices.

  • severityCode. The severity code assigned to the case. Contains one of the values returned by the call to DescribeSeverityLevels.

  • status. The status of the case in the AWS Support Center.

  • subject. The subject line of the case.

  • submittedBy. The email address of the account that submitted the case.

  • timeCreated. The time the case was created, in ISO-8601 format.

" - }, - "CaseId":{"type":"string"}, - "CaseIdList":{ - "type":"list", - "member":{"shape":"CaseId"}, - "max":100, - "min":0 - }, - "CaseIdNotFound":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The requested CaseId could not be located.

" - } - }, - "documentation":"

The requested caseId could not be located.

", - "exception":true - }, - "CaseList":{ - "type":"list", - "member":{"shape":"CaseDetails"} - }, - "CaseStatus":{"type":"string"}, - "Category":{ - "type":"structure", - "members":{ - "code":{ - "shape":"CategoryCode", - "documentation":"

The category code for the support case.

" - }, - "name":{ - "shape":"CategoryName", - "documentation":"

The category name for the support case.

" - } - }, - "documentation":"

A JSON-formatted name/value pair that represents the category name and category code of the problem, selected from the DescribeServices response for each AWS service.

" - }, - "CategoryCode":{"type":"string"}, - "CategoryList":{ - "type":"list", - "member":{"shape":"Category"} - }, - "CategoryName":{"type":"string"}, - "CcEmailAddress":{"type":"string"}, - "CcEmailAddressList":{ - "type":"list", - "member":{"shape":"CcEmailAddress"}, - "max":10, - "min":0 - }, - "Communication":{ - "type":"structure", - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - }, - "body":{ - "shape":"CommunicationBody", - "documentation":"

The text of the communication between the customer and AWS Support.

" - }, - "submittedBy":{ - "shape":"SubmittedBy", - "documentation":"

The email address of the account that submitted the AWS Support case.

" - }, - "timeCreated":{ - "shape":"TimeCreated", - "documentation":"

The time the communication was created.

" - }, - "attachmentSet":{ - "shape":"AttachmentSet", - "documentation":"

Information about the attachments to the case communication.

" - } - }, - "documentation":"

A communication associated with an AWS Support case. The communication consists of the case ID, the message body, attachment information, the account email address, and the date and time of the communication.

" - }, - "CommunicationBody":{ - "type":"string", - "max":8000, - "min":1 - }, - "CommunicationList":{ - "type":"list", - "member":{"shape":"Communication"} - }, - "CreateCaseRequest":{ - "type":"structure", - "required":[ - "subject", - "communicationBody" - ], - "members":{ - "subject":{ - "shape":"Subject", - "documentation":"

The title of the AWS Support case.

" - }, - "serviceCode":{ - "shape":"ServiceCode", - "documentation":"

The code for the AWS service returned by the call to DescribeServices.

" - }, - "severityCode":{ - "shape":"SeverityCode", - "documentation":"

The code for the severity level returned by the call to DescribeSeverityLevels.

The availability of severity levels depends on each customer's support subscription. In other words, your subscription may not necessarily require the urgent level of response time.

" - }, - "categoryCode":{ - "shape":"CategoryCode", - "documentation":"

The category of problem for the AWS Support case.

" - }, - "communicationBody":{ - "shape":"CommunicationBody", - "documentation":"

The communication body text when you create an AWS Support case by calling CreateCase.

" - }, - "ccEmailAddresses":{ - "shape":"CcEmailAddressList", - "documentation":"

A list of email addresses that AWS Support copies on case correspondence.

" - }, - "language":{ - "shape":"Language", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - }, - "issueType":{ - "shape":"IssueType", - "documentation":"

The type of issue for the case. You can specify either \"customer-service\" or \"technical.\" If you do not indicate a value, the default is \"technical.\"

" - }, - "attachmentSetId":{ - "shape":"AttachmentSetId", - "documentation":"

The ID of a set of one or more attachments for the case. Create the set by using AddAttachmentsToSet.

" - } - }, - "documentation":"

" - }, - "CreateCaseResponse":{ - "type":"structure", - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - } - }, - "documentation":"

The AWS Support case ID returned by a successful completion of the CreateCase operation.

" - }, - "Data":{"type":"blob"}, - "DescribeAttachmentLimitExceeded":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

The limit for the number of DescribeAttachment requests in a short period of time has been exceeded.

" - } - }, - "documentation":"

The limit for the number of DescribeAttachment requests in a short period of time has been exceeded.

", - "exception":true - }, - "DescribeAttachmentRequest":{ - "type":"structure", - "required":["attachmentId"], - "members":{ - "attachmentId":{ - "shape":"AttachmentId", - "documentation":"

The ID of the attachment to return. Attachment IDs are returned by the DescribeCommunications operation.

" - } - } - }, - "DescribeAttachmentResponse":{ - "type":"structure", - "members":{ - "attachment":{ - "shape":"Attachment", - "documentation":"

The attachment content and file name.

" - } - }, - "documentation":"

The content and file name of the attachment returned by the DescribeAttachment operation.

" - }, - "DescribeCasesRequest":{ - "type":"structure", - "members":{ - "caseIdList":{ - "shape":"CaseIdList", - "documentation":"

A list of ID numbers of the support cases you want returned. The maximum number of cases is 100.

" - }, - "displayId":{ - "shape":"DisplayId", - "documentation":"

The ID displayed for a case in the AWS Support Center user interface.

" - }, - "afterTime":{ - "shape":"AfterTime", - "documentation":"

The start date for a filtered date search on support case communications. Case communications are available for 12 months after creation.

" - }, - "beforeTime":{ - "shape":"BeforeTime", - "documentation":"

The end date for a filtered date search on support case communications. Case communications are available for 12 months after creation.

" - }, - "includeResolvedCases":{ - "shape":"IncludeResolvedCases", - "documentation":"

Specifies whether resolved support cases should be included in the DescribeCases results. The default is false.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A resumption point for pagination.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return before paginating.

" - }, - "language":{ - "shape":"Language", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - }, - "includeCommunications":{ - "shape":"IncludeCommunications", - "documentation":"

Specifies whether communications should be included in the DescribeCases results. The default is true.

" - } - }, - "documentation":"

" - }, - "DescribeCasesResponse":{ - "type":"structure", - "members":{ - "cases":{ - "shape":"CaseList", - "documentation":"

The details for the cases that match the request.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A resumption point for pagination.

" - } - }, - "documentation":"

Returns an array of CaseDetails objects and a nextToken that defines a point for pagination in the result set.

" - }, - "DescribeCommunicationsRequest":{ - "type":"structure", - "required":["caseId"], - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - }, - "beforeTime":{ - "shape":"BeforeTime", - "documentation":"

The end date for a filtered date search on support case communications. Case communications are available for 12 months after creation.

" - }, - "afterTime":{ - "shape":"AfterTime", - "documentation":"

The start date for a filtered date search on support case communications. Case communications are available for 12 months after creation.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A resumption point for pagination.

" - }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return before paginating.

" - } - }, - "documentation":"

" - }, - "DescribeCommunicationsResponse":{ - "type":"structure", - "members":{ - "communications":{ - "shape":"CommunicationList", - "documentation":"

The communications for the case.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A resumption point for pagination.

" - } - }, - "documentation":"

The communications returned by the DescribeCommunications operation.

" - }, - "DescribeServicesRequest":{ - "type":"structure", - "members":{ - "serviceCodeList":{ - "shape":"ServiceCodeList", - "documentation":"

A JSON-formatted list of service codes available for AWS services.

" - }, - "language":{ - "shape":"Language", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - } - }, - "documentation":"

" - }, - "DescribeServicesResponse":{ - "type":"structure", - "members":{ - "services":{ - "shape":"ServiceList", - "documentation":"

A JSON-formatted list of AWS services.

" - } - }, - "documentation":"

The list of AWS services returned by the DescribeServices operation.

" - }, - "DescribeSeverityLevelsRequest":{ - "type":"structure", - "members":{ - "language":{ - "shape":"Language", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - } - }, - "documentation":"

" - }, - "DescribeSeverityLevelsResponse":{ - "type":"structure", - "members":{ - "severityLevels":{ - "shape":"SeverityLevelsList", - "documentation":"

The available severity levels for the support case. Available severity levels are defined by your service level agreement with AWS.

" - } - }, - "documentation":"

The list of severity levels returned by the DescribeSeverityLevels operation.

" - }, - "DescribeTrustedAdvisorCheckRefreshStatusesRequest":{ - "type":"structure", - "required":["checkIds"], - "members":{ - "checkIds":{ - "shape":"StringList", - "documentation":"

The IDs of the Trusted Advisor checks to get the status of. Note: Specifying the check ID of a check that is automatically refreshed causes an InvalidParameterValue error.

" - } - }, - "documentation":"

" - }, - "DescribeTrustedAdvisorCheckRefreshStatusesResponse":{ - "type":"structure", - "required":["statuses"], - "members":{ - "statuses":{ - "shape":"TrustedAdvisorCheckRefreshStatusList", - "documentation":"

The refresh status of the specified Trusted Advisor checks.

" - } - }, - "documentation":"

The statuses of the Trusted Advisor checks returned by the DescribeTrustedAdvisorCheckRefreshStatuses operation.

" - }, - "DescribeTrustedAdvisorCheckResultRequest":{ - "type":"structure", - "required":["checkId"], - "members":{ - "checkId":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check.

" - }, - "language":{ - "shape":"String", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - } - }, - "documentation":"

" - }, - "DescribeTrustedAdvisorCheckResultResponse":{ - "type":"structure", - "members":{ - "result":{ - "shape":"TrustedAdvisorCheckResult", - "documentation":"

The detailed results of the Trusted Advisor check.

" - } - }, - "documentation":"

The result of the Trusted Advisor check returned by the DescribeTrustedAdvisorCheckResult operation.

" - }, - "DescribeTrustedAdvisorCheckSummariesRequest":{ - "type":"structure", - "required":["checkIds"], - "members":{ - "checkIds":{ - "shape":"StringList", - "documentation":"

The IDs of the Trusted Advisor checks.

" - } - }, - "documentation":"

" - }, - "DescribeTrustedAdvisorCheckSummariesResponse":{ - "type":"structure", - "required":["summaries"], - "members":{ - "summaries":{ - "shape":"TrustedAdvisorCheckSummaryList", - "documentation":"

The summary information for the requested Trusted Advisor checks.

" - } - }, - "documentation":"

The summaries of the Trusted Advisor checks returned by the DescribeTrustedAdvisorCheckSummaries operation.

" - }, - "DescribeTrustedAdvisorChecksRequest":{ - "type":"structure", - "required":["language"], - "members":{ - "language":{ - "shape":"String", - "documentation":"

The ISO 639-1 code for the language in which AWS provides support. AWS Support currently supports English (\"en\") and Japanese (\"ja\"). Language parameters must be passed explicitly for operations that take them.

" - } - }, - "documentation":"

" - }, - "DescribeTrustedAdvisorChecksResponse":{ - "type":"structure", - "required":["checks"], - "members":{ - "checks":{ - "shape":"TrustedAdvisorCheckList", - "documentation":"

Information about all available Trusted Advisor checks.

" - } - }, - "documentation":"

Information about the Trusted Advisor checks returned by the DescribeTrustedAdvisorChecks operation.

" - }, - "DisplayId":{"type":"string"}, - "Double":{"type":"double"}, - "ErrorMessage":{"type":"string"}, - "ExpiryTime":{"type":"string"}, - "FileName":{"type":"string"}, - "IncludeCommunications":{"type":"boolean"}, - "IncludeResolvedCases":{"type":"boolean"}, - "InternalServerError":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

An internal server error occurred.

" - } - }, - "documentation":"

An internal server error occurred.

", - "exception":true, - "fault":true - }, - "IssueType":{"type":"string"}, - "Language":{"type":"string"}, - "Long":{"type":"long"}, - "MaxResults":{ - "type":"integer", - "max":100, - "min":10 - }, - "NextToken":{"type":"string"}, - "RecentCaseCommunications":{ - "type":"structure", - "members":{ - "communications":{ - "shape":"CommunicationList", - "documentation":"

The five most recent communications associated with the case.

" - }, - "nextToken":{ - "shape":"NextToken", - "documentation":"

A resumption point for pagination.

" - } - }, - "documentation":"

The five most recent communications associated with the case.

" - }, - "RefreshTrustedAdvisorCheckRequest":{ - "type":"structure", - "required":["checkId"], - "members":{ - "checkId":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check to refresh. Note: Specifying the check ID of a check that is automatically refreshed causes an InvalidParameterValue error.

" - } - }, - "documentation":"

" - }, - "RefreshTrustedAdvisorCheckResponse":{ - "type":"structure", - "required":["status"], - "members":{ - "status":{ - "shape":"TrustedAdvisorCheckRefreshStatus", - "documentation":"

The current refresh status for a check, including the amount of time until the check is eligible for refresh.

" - } - }, - "documentation":"

The current refresh status of a Trusted Advisor check.

" - }, - "ResolveCaseRequest":{ - "type":"structure", - "members":{ - "caseId":{ - "shape":"CaseId", - "documentation":"

The AWS Support case ID requested or returned in the call. The case ID is an alphanumeric string formatted as shown in this example: case-12345678910-2013-c4c1d2bf33c5cf47

" - } - }, - "documentation":"

" - }, - "ResolveCaseResponse":{ - "type":"structure", - "members":{ - "initialCaseStatus":{ - "shape":"CaseStatus", - "documentation":"

The status of the case when the ResolveCase request was sent.

" - }, - "finalCaseStatus":{ - "shape":"CaseStatus", - "documentation":"

The status of the case after the ResolveCase request was processed.

" - } - }, - "documentation":"

The status of the case returned by the ResolveCase operation.

" - }, - "Result":{"type":"boolean"}, - "Service":{ - "type":"structure", - "members":{ - "code":{ - "shape":"ServiceCode", - "documentation":"

The code for an AWS service returned by the DescribeServices response. The name element contains the corresponding friendly name.

" - }, - "name":{ - "shape":"ServiceName", - "documentation":"

The friendly name for an AWS service. The code element contains the corresponding code.

" - }, - "categories":{ - "shape":"CategoryList", - "documentation":"

A list of categories that describe the type of support issue a case describes. Categories consist of a category name and a category code. Category names and codes are passed to AWS Support when you call CreateCase.

" - } - }, - "documentation":"

Information about an AWS service returned by the DescribeServices operation.

" - }, - "ServiceCode":{"type":"string"}, - "ServiceCodeList":{ - "type":"list", - "member":{"shape":"ServiceCode"}, - "max":100, - "min":0 - }, - "ServiceList":{ - "type":"list", - "member":{"shape":"Service"} - }, - "ServiceName":{"type":"string"}, - "SeverityCode":{"type":"string"}, - "SeverityLevel":{ - "type":"structure", - "members":{ - "code":{ - "shape":"SeverityLevelCode", - "documentation":"

One of four values: \"low,\" \"medium,\" \"high,\" and \"urgent\". These values correspond to response times returned to the caller in severityLevel.name.

" - }, - "name":{ - "shape":"SeverityLevelName", - "documentation":"

The name of the severity level that corresponds to the severity level code.

" - } - }, - "documentation":"

A code and name pair that represent a severity level that can be applied to a support case.

" - }, - "SeverityLevelCode":{"type":"string"}, - "SeverityLevelName":{"type":"string"}, - "SeverityLevelsList":{ - "type":"list", - "member":{"shape":"SeverityLevel"} - }, - "Status":{"type":"string"}, - "String":{"type":"string"}, - "StringList":{ - "type":"list", - "member":{"shape":"String"} - }, - "Subject":{"type":"string"}, - "SubmittedBy":{"type":"string"}, - "TimeCreated":{"type":"string"}, - "TrustedAdvisorCategorySpecificSummary":{ - "type":"structure", - "members":{ - "costOptimizing":{ - "shape":"TrustedAdvisorCostOptimizingSummary", - "documentation":"

The summary information about cost savings for a Trusted Advisor check that is in the Cost Optimizing category.

" - } - }, - "documentation":"

The container for summary information that relates to the category of the Trusted Advisor check.

" - }, - "TrustedAdvisorCheckDescription":{ - "type":"structure", - "required":[ - "id", - "name", - "description", - "category", - "metadata" - ], - "members":{ - "id":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check.

" - }, - "name":{ - "shape":"String", - "documentation":"

The display name for the Trusted Advisor check.

" - }, - "description":{ - "shape":"String", - "documentation":"

The description of the Trusted Advisor check, which includes the alert criteria and recommended actions (contains HTML markup).

" - }, - "category":{ - "shape":"String", - "documentation":"

The category of the Trusted Advisor check.

" - }, - "metadata":{ - "shape":"StringList", - "documentation":"

The column headings for the data returned by the Trusted Advisor check. The order of the headings corresponds to the order of the data in the Metadata element of the TrustedAdvisorResourceDetail for the check. Metadata contains all the data that is shown in the Excel download, even in those cases where the UI shows just summary data.

" - } - }, - "documentation":"

The description and metadata for a Trusted Advisor check.

" - }, - "TrustedAdvisorCheckList":{ - "type":"list", - "member":{"shape":"TrustedAdvisorCheckDescription"} - }, - "TrustedAdvisorCheckRefreshStatus":{ - "type":"structure", - "required":[ - "checkId", - "status", - "millisUntilNextRefreshable" - ], - "members":{ - "checkId":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check.

" - }, - "status":{ - "shape":"String", - "documentation":"

The status of the Trusted Advisor check for which a refresh has been requested: \"none\", \"enqueued\", \"processing\", \"success\", or \"abandoned\".

" - }, - "millisUntilNextRefreshable":{ - "shape":"Long", - "documentation":"

The amount of time, in milliseconds, until the Trusted Advisor check is eligible for refresh.

" - } - }, - "documentation":"

The refresh status of a Trusted Advisor check.

" - }, - "TrustedAdvisorCheckRefreshStatusList":{ - "type":"list", - "member":{"shape":"TrustedAdvisorCheckRefreshStatus"} - }, - "TrustedAdvisorCheckResult":{ - "type":"structure", - "required":[ - "checkId", - "timestamp", - "status", - "resourcesSummary", - "categorySpecificSummary", - "flaggedResources" - ], - "members":{ - "checkId":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check.

" - }, - "timestamp":{ - "shape":"String", - "documentation":"

The time of the last refresh of the check.

" - }, - "status":{ - "shape":"String", - "documentation":"

The alert status of the check: \"ok\" (green), \"warning\" (yellow), \"error\" (red), or \"not_available\".

" - }, - "resourcesSummary":{"shape":"TrustedAdvisorResourcesSummary"}, - "categorySpecificSummary":{ - "shape":"TrustedAdvisorCategorySpecificSummary", - "documentation":"

Summary information that relates to the category of the check. Cost Optimizing is the only category that is currently supported.

" - }, - "flaggedResources":{ - "shape":"TrustedAdvisorResourceDetailList", - "documentation":"

The details about each resource listed in the check result.

" - } - }, - "documentation":"

The results of a Trusted Advisor check returned by DescribeTrustedAdvisorCheckResult.

" - }, - "TrustedAdvisorCheckSummary":{ - "type":"structure", - "required":[ - "checkId", - "timestamp", - "status", - "resourcesSummary", - "categorySpecificSummary" - ], - "members":{ - "checkId":{ - "shape":"String", - "documentation":"

The unique identifier for the Trusted Advisor check.

" - }, - "timestamp":{ - "shape":"String", - "documentation":"

The time of the last refresh of the check.

" - }, - "status":{ - "shape":"String", - "documentation":"

The alert status of the check: \"ok\" (green), \"warning\" (yellow), \"error\" (red), or \"not_available\".

" - }, - "hasFlaggedResources":{ - "shape":"Boolean", - "documentation":"

Specifies whether the Trusted Advisor check has flagged resources.

" - }, - "resourcesSummary":{"shape":"TrustedAdvisorResourcesSummary"}, - "categorySpecificSummary":{ - "shape":"TrustedAdvisorCategorySpecificSummary", - "documentation":"

Summary information that relates to the category of the check. Cost Optimizing is the only category that is currently supported.

" - } - }, - "documentation":"

A summary of a Trusted Advisor check result, including the alert status, last refresh, and number of resources examined.

" - }, - "TrustedAdvisorCheckSummaryList":{ - "type":"list", - "member":{"shape":"TrustedAdvisorCheckSummary"} - }, - "TrustedAdvisorCostOptimizingSummary":{ - "type":"structure", - "required":[ - "estimatedMonthlySavings", - "estimatedPercentMonthlySavings" - ], - "members":{ - "estimatedMonthlySavings":{ - "shape":"Double", - "documentation":"

The estimated monthly savings that might be realized if the recommended actions are taken.

" - }, - "estimatedPercentMonthlySavings":{ - "shape":"Double", - "documentation":"

The estimated percentage of savings that might be realized if the recommended actions are taken.

" - } - }, - "documentation":"

The estimated cost savings that might be realized if the recommended actions are taken.

" - }, - "TrustedAdvisorResourceDetail":{ - "type":"structure", - "required":[ - "status", - "resourceId", - "metadata" - ], - "members":{ - "status":{ - "shape":"String", - "documentation":"

The status code for the resource identified in the Trusted Advisor check.

" - }, - "region":{ - "shape":"String", - "documentation":"

The AWS region in which the identified resource is located.

" - }, - "resourceId":{ - "shape":"String", - "documentation":"

The unique identifier for the identified resource.

" - }, - "isSuppressed":{ - "shape":"Boolean", - "documentation":"

Specifies whether the AWS resource was ignored by Trusted Advisor because it was marked as suppressed by the user.

" - }, - "metadata":{ - "shape":"StringList", - "documentation":"

Additional information about the identified resource. The exact metadata and its order can be obtained by inspecting the TrustedAdvisorCheckDescription object returned by the call to DescribeTrustedAdvisorChecks. Metadata contains all the data that is shown in the Excel download, even in those cases where the UI shows just summary data.

" - } - }, - "documentation":"

Contains information about a resource identified by a Trusted Advisor check.

" - }, - "TrustedAdvisorResourceDetailList":{ - "type":"list", - "member":{"shape":"TrustedAdvisorResourceDetail"} - }, - "TrustedAdvisorResourcesSummary":{ - "type":"structure", - "required":[ - "resourcesProcessed", - "resourcesFlagged", - "resourcesIgnored", - "resourcesSuppressed" - ], - "members":{ - "resourcesProcessed":{ - "shape":"Long", - "documentation":"

The number of AWS resources that were analyzed by the Trusted Advisor check.

" - }, - "resourcesFlagged":{ - "shape":"Long", - "documentation":"

The number of AWS resources that were flagged (listed) by the Trusted Advisor check.

" - }, - "resourcesIgnored":{ - "shape":"Long", - "documentation":"

The number of AWS resources ignored by Trusted Advisor because information was unavailable.

" - }, - "resourcesSuppressed":{ - "shape":"Long", - "documentation":"

The number of AWS resources ignored by Trusted Advisor because they were marked as suppressed by the user.

" - } - }, - "documentation":"

Details about AWS resources that were analyzed in a call to Trusted Advisor DescribeTrustedAdvisorCheckSummaries.

" - } - }, - "documentation":"AWS Support

The AWS Support API reference is intended for programmers who need detailed information about the AWS Support operations and data types. This service enables you to manage your AWS Support cases programmatically. It uses HTTP methods that return results in JSON format.

The AWS Support service also exposes a set of Trusted Advisor features. You can retrieve a list of checks and their descriptions, get check results, specify checks to refresh, and get the refresh status of checks.

The following list describes the AWS Support case management operations:

The following list describes the operations available from the AWS Support service for Trusted Advisor:

For authentication of requests, AWS Support uses Signature Version 4 Signing Process.

See About the AWS Support API in the AWS Support User Guide for information about how to use this service to create and manage your support cases, and how to call Trusted Advisor for results of checks on your resources.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/paginators-1.json deleted file mode 100644 index e92bfebe..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/paginators-1.json +++ /dev/null @@ -1,53 +0,0 @@ -{ - "pagination": { - "GetWorkflowExecutionHistory": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "events" - }, - "ListActivityTypes": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "typeInfos" - }, - "ListClosedWorkflowExecutions": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "executionInfos" - }, - "ListDomains": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "domainInfos" - }, - "ListOpenWorkflowExecutions": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "executionInfos" - }, - "ListWorkflowTypes": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "typeInfos" - }, - "PollForDecisionTask": { - "limit_key": "maximumPageSize", - "input_token": "nextPageToken", - "output_token": "nextPageToken", - "result_key": "events", - "non_aggregate_keys": [ - "taskToken", - "startedEventId", - "workflowExecution", - "workflowType", - "previousStartedEventId" - ] - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/service-2.json deleted file mode 100644 index c7238593..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/swf/2012-01-25/service-2.json +++ /dev/null @@ -1,4513 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2012-01-25", - "endpointPrefix":"swf", - "jsonVersion":"1.0", - "protocol":"json", - "serviceAbbreviation":"Amazon SWF", - "serviceFullName":"Amazon Simple Workflow Service", - "serviceId":"SWF", - "signatureVersion":"v4", - "targetPrefix":"SimpleWorkflowService", - "timestampFormat":"unixTimestamp", - "uid":"swf-2012-01-25" - }, - "operations":{ - "CountClosedWorkflowExecutions":{ - "name":"CountClosedWorkflowExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CountClosedWorkflowExecutionsInput"}, - "output":{"shape":"WorkflowExecutionCount"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the number of closed workflow executions within the given domain that meet the specified filtering criteria.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagFilter.tag: String constraint. The key is swf:tagFilter.tag.

    • typeFilter.name: String constraint. The key is swf:typeFilter.name.

    • typeFilter.version: String constraint. The key is swf:typeFilter.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CountOpenWorkflowExecutions":{ - "name":"CountOpenWorkflowExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CountOpenWorkflowExecutionsInput"}, - "output":{"shape":"WorkflowExecutionCount"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the number of open workflow executions within the given domain that meet the specified filtering criteria.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagFilter.tag: String constraint. The key is swf:tagFilter.tag.

    • typeFilter.name: String constraint. The key is swf:typeFilter.name.

    • typeFilter.version: String constraint. The key is swf:typeFilter.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CountPendingActivityTasks":{ - "name":"CountPendingActivityTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CountPendingActivityTasksInput"}, - "output":{"shape":"PendingTaskCount"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the estimated number of activity tasks in the specified task list. The count returned is an approximation and isn't guaranteed to be exact. If you specify a task list that no activity task was ever scheduled in then 0 is returned.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the taskList.name parameter by using a Condition element with the swf:taskList.name key to allow the action to access only certain task lists.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CountPendingDecisionTasks":{ - "name":"CountPendingDecisionTasks", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CountPendingDecisionTasksInput"}, - "output":{"shape":"PendingTaskCount"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the estimated number of decision tasks in the specified task list. The count returned is an approximation and isn't guaranteed to be exact. If you specify a task list that no decision task was ever scheduled in then 0 is returned.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the taskList.name parameter by using a Condition element with the swf:taskList.name key to allow the action to access only certain task lists.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DeprecateActivityType":{ - "name":"DeprecateActivityType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeprecateActivityTypeInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"TypeDeprecatedFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Deprecates the specified activity type. After an activity type has been deprecated, you cannot create new tasks of that activity type. Tasks of this type that were scheduled before the type was deprecated continue to run.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • activityType.name: String constraint. The key is swf:activityType.name.

    • activityType.version: String constraint. The key is swf:activityType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DeprecateDomain":{ - "name":"DeprecateDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeprecateDomainInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"DomainDeprecatedFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Deprecates the specified domain. After a domain has been deprecated it cannot be used to create new workflow executions or register new types. However, you can still use visibility actions on this domain. Deprecating a domain also deprecates all activity and workflow types registered in the domain. Executions that were started before the domain was deprecated continues to run.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DeprecateWorkflowType":{ - "name":"DeprecateWorkflowType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeprecateWorkflowTypeInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"TypeDeprecatedFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Deprecates the specified workflow type. After a workflow type has been deprecated, you cannot create new executions of that type. Executions that were started before the type was deprecated continues to run. A deprecated workflow type may still be used when calling visibility actions.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • workflowType.name: String constraint. The key is swf:workflowType.name.

    • workflowType.version: String constraint. The key is swf:workflowType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DescribeActivityType":{ - "name":"DescribeActivityType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeActivityTypeInput"}, - "output":{"shape":"ActivityTypeDetail"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns information about the specified activity type. This includes configuration settings provided when the type was registered and other general information about the type.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • activityType.name: String constraint. The key is swf:activityType.name.

    • activityType.version: String constraint. The key is swf:activityType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DescribeDomain":{ - "name":"DescribeDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeDomainInput"}, - "output":{"shape":"DomainDetail"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns information about the specified domain, including description and status.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DescribeWorkflowExecution":{ - "name":"DescribeWorkflowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkflowExecutionInput"}, - "output":{"shape":"WorkflowExecutionDetail"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns information about the specified workflow execution including its type and some statistics.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "DescribeWorkflowType":{ - "name":"DescribeWorkflowType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkflowTypeInput"}, - "output":{"shape":"WorkflowTypeDetail"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns information about the specified workflow type. This includes configuration settings specified when the type was registered and other information such as creation date, current status, etc.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • workflowType.name: String constraint. The key is swf:workflowType.name.

    • workflowType.version: String constraint. The key is swf:workflowType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "GetWorkflowExecutionHistory":{ - "name":"GetWorkflowExecutionHistory", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetWorkflowExecutionHistoryInput"}, - "output":{"shape":"History"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the history of the specified workflow execution. The results may be split into multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken returned by the initial call.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ListActivityTypes":{ - "name":"ListActivityTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListActivityTypesInput"}, - "output":{"shape":"ActivityTypeInfos"}, - "errors":[ - {"shape":"OperationNotPermittedFault"}, - {"shape":"UnknownResourceFault"} - ], - "documentation":"

Returns information about all activities registered in the specified domain that match the specified name and registration status. The result includes information like creation date, current status of the activity, etc. The results may be split into multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken returned by the initial call.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ListClosedWorkflowExecutions":{ - "name":"ListClosedWorkflowExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListClosedWorkflowExecutionsInput"}, - "output":{"shape":"WorkflowExecutionInfos"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns a list of closed workflow executions in the specified domain that meet the filtering criteria. The results may be split into multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken returned by the initial call.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagFilter.tag: String constraint. The key is swf:tagFilter.tag.

    • typeFilter.name: String constraint. The key is swf:typeFilter.name.

    • typeFilter.version: String constraint. The key is swf:typeFilter.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ListDomains":{ - "name":"ListDomains", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListDomainsInput"}, - "output":{"shape":"DomainInfos"}, - "errors":[ - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns the list of domains registered in the account. The results may be split into multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken returned by the initial call.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains. The element must be set to arn:aws:swf::AccountID:domain/*, where AccountID is the account ID, with no dashes.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ListOpenWorkflowExecutions":{ - "name":"ListOpenWorkflowExecutions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOpenWorkflowExecutionsInput"}, - "output":{"shape":"WorkflowExecutionInfos"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Returns a list of open workflow executions in the specified domain that meet the filtering criteria. The results may be split into multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken returned by the initial call.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagFilter.tag: String constraint. The key is swf:tagFilter.tag.

    • typeFilter.name: String constraint. The key is swf:typeFilter.name.

    • typeFilter.version: String constraint. The key is swf:typeFilter.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ListWorkflowTypes":{ - "name":"ListWorkflowTypes", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWorkflowTypesInput"}, - "output":{"shape":"WorkflowTypeInfos"}, - "errors":[ - {"shape":"OperationNotPermittedFault"}, - {"shape":"UnknownResourceFault"} - ], - "documentation":"

Returns information about workflow types in the specified domain. The results may be split into multiple pages that can be retrieved by making the call repeatedly.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "PollForActivityTask":{ - "name":"PollForActivityTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PollForActivityTaskInput"}, - "output":{"shape":"ActivityTask"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"}, - {"shape":"LimitExceededFault"} - ], - "documentation":"

Used by workers to get an ActivityTask from the specified activity taskList. This initiates a long poll, where the service holds the HTTP connection open and responds as soon as a task becomes available. The maximum time the service holds on to the request before responding is 60 seconds. If no task is available within 60 seconds, the poll returns an empty result. An empty result, in this context, means that an ActivityTask is returned, but that the value of taskToken is an empty string. If a task is returned, the worker should use its type to identify and process it correctly.

Workers should set their client side socket timeout to at least 70 seconds (10 seconds higher than the maximum time service may hold the poll request).

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the taskList.name parameter by using a Condition element with the swf:taskList.name key to allow the action to access only certain task lists.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "PollForDecisionTask":{ - "name":"PollForDecisionTask", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PollForDecisionTaskInput"}, - "output":{"shape":"DecisionTask"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"}, - {"shape":"LimitExceededFault"} - ], - "documentation":"

Used by deciders to get a DecisionTask from the specified decision taskList. A decision task may be returned for any open workflow execution that is using the specified task list. The task includes a paginated view of the history of the workflow execution. The decider should use the workflow type and the history to determine how to properly handle the task.

This action initiates a long poll, where the service holds the HTTP connection open and responds as soon a task becomes available. If no decision task is available in the specified task list before the timeout of 60 seconds expires, an empty result is returned. An empty result, in this context, means that a DecisionTask is returned, but that the value of taskToken is an empty string.

Deciders should set their client side socket timeout to at least 70 seconds (10 seconds higher than the timeout).

Because the number of workflow history events for a single workflow execution might be very large, the result returned might be split up across a number of pages. To retrieve subsequent pages, make additional calls to PollForDecisionTask using the nextPageToken returned by the initial call. Note that you do not call GetWorkflowExecutionHistory with this nextPageToken. Instead, call PollForDecisionTask again.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the taskList.name parameter by using a Condition element with the swf:taskList.name key to allow the action to access only certain task lists.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RecordActivityTaskHeartbeat":{ - "name":"RecordActivityTaskHeartbeat", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RecordActivityTaskHeartbeatInput"}, - "output":{"shape":"ActivityTaskStatus"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Used by activity workers to report to the service that the ActivityTask represented by the specified taskToken is still making progress. The worker can also specify details of the progress, for example percent complete, using the details parameter. This action can also be used by the worker as a mechanism to check if cancellation is being requested for the activity task. If a cancellation is being attempted for the specified task, then the boolean cancelRequested flag returned by the service is set to true.

This action resets the taskHeartbeatTimeout clock. The taskHeartbeatTimeout is specified in RegisterActivityType.

This action doesn't in itself create an event in the workflow execution history. However, if the task times out, the workflow execution history contains a ActivityTaskTimedOut event that contains the information from the last heartbeat generated by the activity worker.

The taskStartToCloseTimeout of an activity type is the maximum duration of an activity task, regardless of the number of RecordActivityTaskHeartbeat requests received. The taskStartToCloseTimeout is also specified in RegisterActivityType.

This operation is only useful for long-lived activities to report liveliness of the task and to determine if a cancellation is being attempted.

If the cancelRequested flag returns true, a cancellation is being attempted. If the worker can cancel the activity, it should respond with RespondActivityTaskCanceled. Otherwise, it should ignore the cancellation request.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RegisterActivityType":{ - "name":"RegisterActivityType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterActivityTypeInput"}, - "errors":[ - {"shape":"TypeAlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Registers a new activity type along with its configuration settings in the specified domain.

A TypeAlreadyExists fault is returned if the type already exists in the domain. You cannot change any configuration settings of the type after its registration, and it must be registered as a new version.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • defaultTaskList.name: String constraint. The key is swf:defaultTaskList.name.

    • name: String constraint. The key is swf:name.

    • version: String constraint. The key is swf:version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RegisterDomain":{ - "name":"RegisterDomain", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterDomainInput"}, - "errors":[ - {"shape":"DomainAlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Registers a new domain.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • You cannot use an IAM policy to control domain access for this action. The name of the domain being registered is available as the resource of this action.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RegisterWorkflowType":{ - "name":"RegisterWorkflowType", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterWorkflowTypeInput"}, - "errors":[ - {"shape":"TypeAlreadyExistsFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Registers a new workflow type and its configuration settings in the specified domain.

The retention period for the workflow history is set by the RegisterDomain action.

If the type already exists, then a TypeAlreadyExists fault is returned. You cannot change the configuration settings of a workflow type once it is registered and it must be registered as a new version.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • defaultTaskList.name: String constraint. The key is swf:defaultTaskList.name.

    • name: String constraint. The key is swf:name.

    • version: String constraint. The key is swf:version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RequestCancelWorkflowExecution":{ - "name":"RequestCancelWorkflowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RequestCancelWorkflowExecutionInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Records a WorkflowExecutionCancelRequested event in the currently running workflow execution identified by the given domain, workflowId, and runId. This logically requests the cancellation of the workflow execution as a whole. It is up to the decider to take appropriate actions when it receives an execution history with this event.

If the runId isn't specified, the WorkflowExecutionCancelRequested event is recorded in the history of the current open workflow execution with the specified workflowId in the domain.

Because this action allows the workflow to properly clean up and gracefully close, it should be used instead of TerminateWorkflowExecution when possible.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RespondActivityTaskCanceled":{ - "name":"RespondActivityTaskCanceled", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RespondActivityTaskCanceledInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Used by workers to tell the service that the ActivityTask identified by the taskToken was successfully canceled. Additional details can be provided using the details argument.

These details (if provided) appear in the ActivityTaskCanceled event added to the workflow history.

Only use this operation if the canceled flag of a RecordActivityTaskHeartbeat request returns true and if the activity can be safely undone or abandoned.

A task is considered open from the time that it is scheduled until it is closed. Therefore a task is reported as open while a worker is processing it. A task is closed after it has been specified in a call to RespondActivityTaskCompleted, RespondActivityTaskCanceled, RespondActivityTaskFailed, or the task has timed out.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RespondActivityTaskCompleted":{ - "name":"RespondActivityTaskCompleted", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RespondActivityTaskCompletedInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Used by workers to tell the service that the ActivityTask identified by the taskToken completed successfully with a result (if provided). The result appears in the ActivityTaskCompleted event in the workflow history.

If the requested task doesn't complete successfully, use RespondActivityTaskFailed instead. If the worker finds that the task is canceled through the canceled flag returned by RecordActivityTaskHeartbeat, it should cancel the task, clean up and then call RespondActivityTaskCanceled.

A task is considered open from the time that it is scheduled until it is closed. Therefore a task is reported as open while a worker is processing it. A task is closed after it has been specified in a call to RespondActivityTaskCompleted, RespondActivityTaskCanceled, RespondActivityTaskFailed, or the task has timed out.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RespondActivityTaskFailed":{ - "name":"RespondActivityTaskFailed", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RespondActivityTaskFailedInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Used by workers to tell the service that the ActivityTask identified by the taskToken has failed with reason (if specified). The reason and details appear in the ActivityTaskFailed event added to the workflow history.

A task is considered open from the time that it is scheduled until it is closed. Therefore a task is reported as open while a worker is processing it. A task is closed after it has been specified in a call to RespondActivityTaskCompleted, RespondActivityTaskCanceled, RespondActivityTaskFailed, or the task has timed out.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RespondDecisionTaskCompleted":{ - "name":"RespondDecisionTaskCompleted", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RespondDecisionTaskCompletedInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Used by deciders to tell the service that the DecisionTask identified by the taskToken has successfully completed. The decisions argument specifies the list of decisions made while processing the task.

A DecisionTaskCompleted event is added to the workflow history. The executionContext specified is attached to the event in the workflow execution history.

Access Control

If an IAM policy grants permission to use RespondDecisionTaskCompleted, it can express permissions for the list of decisions in the decisions parameter. Each of the decisions has one or more parameters, much like a regular API call. To allow for policies to be as readable as possible, you can express permissions on decisions as if they were actual API calls, including applying conditions to some parameters. For more information, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "SignalWorkflowExecution":{ - "name":"SignalWorkflowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"SignalWorkflowExecutionInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Records a WorkflowExecutionSignaled event in the workflow execution history and creates a decision task for the workflow execution identified by the given domain, workflowId and runId. The event is recorded with the specified user defined signalName and input (if provided).

If a runId isn't specified, then the WorkflowExecutionSignaled event is recorded in the history of the current open workflow with the matching workflowId in the domain.

If the specified workflow execution isn't open, this method fails with UnknownResource.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "StartWorkflowExecution":{ - "name":"StartWorkflowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartWorkflowExecutionInput"}, - "output":{"shape":"Run"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"TypeDeprecatedFault"}, - {"shape":"WorkflowExecutionAlreadyStartedFault"}, - {"shape":"LimitExceededFault"}, - {"shape":"OperationNotPermittedFault"}, - {"shape":"DefaultUndefinedFault"} - ], - "documentation":"

Starts an execution of the workflow type in the specified domain using the provided workflowId and input data.

This action returns the newly started workflow execution.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagList.member.0: The key is swf:tagList.member.0.

    • tagList.member.1: The key is swf:tagList.member.1.

    • tagList.member.2: The key is swf:tagList.member.2.

    • tagList.member.3: The key is swf:tagList.member.3.

    • tagList.member.4: The key is swf:tagList.member.4.

    • taskList: String constraint. The key is swf:taskList.name.

    • workflowType.name: String constraint. The key is swf:workflowType.name.

    • workflowType.version: String constraint. The key is swf:workflowType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "TerminateWorkflowExecution":{ - "name":"TerminateWorkflowExecution", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateWorkflowExecutionInput"}, - "errors":[ - {"shape":"UnknownResourceFault"}, - {"shape":"OperationNotPermittedFault"} - ], - "documentation":"

Records a WorkflowExecutionTerminated event and forces closure of the workflow execution identified by the given domain, runId, and workflowId. The child policy, registered with the workflow type or specified when starting this execution, is applied to any open child workflow executions of this workflow execution.

If the identified workflow execution was in progress, it is terminated immediately.

If a runId isn't specified, then the WorkflowExecutionTerminated event is recorded in the history of the current open workflow with the matching workflowId in the domain.

You should consider using RequestCancelWorkflowExecution action instead because it allows the workflow to gracefully close while TerminateWorkflowExecution doesn't.

Access Control

You can use IAM policies to control this action's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - } - }, - "shapes":{ - "ActivityId":{ - "type":"string", - "max":256, - "min":1 - }, - "ActivityTask":{ - "type":"structure", - "required":[ - "taskToken", - "activityId", - "startedEventId", - "workflowExecution", - "activityType" - ], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The opaque string used as a handle on the task. This token is used by workers to communicate progress and response information back to the system about the task.

" - }, - "activityId":{ - "shape":"ActivityId", - "documentation":"

The unique ID of the task.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event recorded in the history.

" - }, - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The workflow execution that started this activity task.

" - }, - "activityType":{ - "shape":"ActivityType", - "documentation":"

The type of this activity task.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The inputs provided when the activity task was scheduled. The form of the input is user defined and should be meaningful to the activity implementation.

" - } - }, - "documentation":"

Unit of work sent to an activity worker.

" - }, - "ActivityTaskCancelRequestedEventAttributes":{ - "type":"structure", - "required":[ - "decisionTaskCompletedEventId", - "activityId" - ], - "members":{ - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RequestCancelActivityTask decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "activityId":{ - "shape":"ActivityId", - "documentation":"

The unique ID of the task.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskCancelRequested event.

" - }, - "ActivityTaskCanceledEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "details":{ - "shape":"Data", - "documentation":"

Details of the cancellation.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event recorded when this activity task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "latestCancelRequestedEventId":{ - "shape":"EventId", - "documentation":"

If set, contains the ID of the last ActivityTaskCancelRequested event recorded for this activity task. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskCanceled event.

" - }, - "ActivityTaskCompletedEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "result":{ - "shape":"Data", - "documentation":"

The results of the activity task.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event recorded when this activity task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskCompleted event.

" - }, - "ActivityTaskFailedEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "reason":{ - "shape":"FailureReason", - "documentation":"

The reason provided for the failure.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the failure.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event recorded when this activity task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskFailed event.

" - }, - "ActivityTaskScheduledEventAttributes":{ - "type":"structure", - "required":[ - "activityType", - "activityId", - "taskList", - "decisionTaskCompletedEventId" - ], - "members":{ - "activityType":{ - "shape":"ActivityType", - "documentation":"

The type of the activity task.

" - }, - "activityId":{ - "shape":"ActivityId", - "documentation":"

The unique ID of the activity task.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input provided to the activity task.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent workflow tasks. This data isn't sent to the activity.

" - }, - "scheduleToStartTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum amount of time the activity task can wait to be assigned to a worker.

" - }, - "scheduleToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum amount of time for this activity task.

" - }, - "startToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum amount of time a worker may take to process the activity task.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The task list in which the activity task has been scheduled.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The priority to assign to the scheduled activity task. If set, this overrides any default priority value that was assigned when the activity type was registered.

Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision that resulted in the scheduling of this activity task. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "heartbeatTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum time before which the worker processing this task must report progress by calling RecordActivityTaskHeartbeat. If the timeout is exceeded, the activity task is automatically timed out. If the worker subsequently attempts to record a heartbeat or return a result, it is ignored.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskScheduled event.

" - }, - "ActivityTaskStartedEventAttributes":{ - "type":"structure", - "required":["scheduledEventId"], - "members":{ - "identity":{ - "shape":"Identity", - "documentation":"

Identity of the worker that was assigned this task. This aids diagnostics when problems arise. The form of this identity is user defined.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskStarted event.

" - }, - "ActivityTaskStatus":{ - "type":"structure", - "required":["cancelRequested"], - "members":{ - "cancelRequested":{ - "shape":"Canceled", - "documentation":"

Set to true if cancellation of the task is requested.

" - } - }, - "documentation":"

Status information about an activity task.

" - }, - "ActivityTaskTimedOutEventAttributes":{ - "type":"structure", - "required":[ - "timeoutType", - "scheduledEventId", - "startedEventId" - ], - "members":{ - "timeoutType":{ - "shape":"ActivityTaskTimeoutType", - "documentation":"

The type of the timeout that caused this event.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event recorded when this activity task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "details":{ - "shape":"LimitedData", - "documentation":"

Contains the content of the details parameter for the last call made by the activity to RecordActivityTaskHeartbeat.

" - } - }, - "documentation":"

Provides the details of the ActivityTaskTimedOut event.

" - }, - "ActivityTaskTimeoutType":{ - "type":"string", - "enum":[ - "START_TO_CLOSE", - "SCHEDULE_TO_START", - "SCHEDULE_TO_CLOSE", - "HEARTBEAT" - ] - }, - "ActivityType":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of this activity.

The combination of activity type name and version must be unique within a domain.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of this activity.

The combination of activity type name and version must be unique with in a domain.

" - } - }, - "documentation":"

Represents an activity type.

" - }, - "ActivityTypeConfiguration":{ - "type":"structure", - "members":{ - "defaultTaskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum duration for tasks of an activity type specified when registering the activity type. You can override this default when scheduling a task through the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskHeartbeatTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum time, in seconds, before which a worker processing a task must report progress by calling RecordActivityTaskHeartbeat.

You can specify this value only when registering an activity type. The registered default value can be overridden when you schedule a task through the ScheduleActivityTask Decision. If the activity worker subsequently attempts to record a heartbeat or returns a result, the activity worker receives an UnknownResource fault. In this case, Amazon SWF no longer considers the activity task to be valid; the activity worker should clean up the activity task.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskList":{ - "shape":"TaskList", - "documentation":"

The default task list specified for this activity type at registration. This default is used if a task list isn't provided when a task is scheduled through the ScheduleActivityTask Decision. You can override the default registered task list when scheduling a task through the ScheduleActivityTask Decision.

" - }, - "defaultTaskPriority":{ - "shape":"TaskPriority", - "documentation":"

The default task priority for tasks of this activity type, specified at registration. If not set, then 0 is used as the default priority. This default can be overridden when scheduling an activity task.

Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "defaultTaskScheduleToStartTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum duration, specified when registering the activity type, that a task of an activity type can wait before being assigned to a worker. You can override this default when scheduling a task through the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskScheduleToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum duration, specified when registering the activity type, for tasks of this activity type. You can override this default when scheduling a task through the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - } - }, - "documentation":"

Configuration settings registered with the activity type.

" - }, - "ActivityTypeDetail":{ - "type":"structure", - "required":[ - "typeInfo", - "configuration" - ], - "members":{ - "typeInfo":{ - "shape":"ActivityTypeInfo", - "documentation":"

General information about the activity type.

The status of activity type (returned in the ActivityTypeInfo structure) can be one of the following.

  • REGISTERED – The type is registered and available. Workers supporting this type should be running.

  • DEPRECATED – The type was deprecated using DeprecateActivityType, but is still in use. You should keep workers supporting this type running. You cannot create new tasks of this type.

" - }, - "configuration":{ - "shape":"ActivityTypeConfiguration", - "documentation":"

The configuration settings registered with the activity type.

" - } - }, - "documentation":"

Detailed information about an activity type.

" - }, - "ActivityTypeInfo":{ - "type":"structure", - "required":[ - "activityType", - "status", - "creationDate" - ], - "members":{ - "activityType":{ - "shape":"ActivityType", - "documentation":"

The ActivityType type structure representing the activity type.

" - }, - "status":{ - "shape":"RegistrationStatus", - "documentation":"

The current status of the activity type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the activity type provided in RegisterActivityType.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date and time this activity type was created through RegisterActivityType.

" - }, - "deprecationDate":{ - "shape":"Timestamp", - "documentation":"

If DEPRECATED, the date and time DeprecateActivityType was called.

" - } - }, - "documentation":"

Detailed information about an activity type.

" - }, - "ActivityTypeInfoList":{ - "type":"list", - "member":{"shape":"ActivityTypeInfo"} - }, - "ActivityTypeInfos":{ - "type":"structure", - "required":["typeInfos"], - "members":{ - "typeInfos":{ - "shape":"ActivityTypeInfoList", - "documentation":"

List of activity type information.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - } - }, - "documentation":"

Contains a paginated list of activity type information structures.

" - }, - "Arn":{ - "type":"string", - "max":1600, - "min":1 - }, - "CancelTimerDecisionAttributes":{ - "type":"structure", - "required":["timerId"], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The unique ID of the timer to cancel.

" - } - }, - "documentation":"

Provides the details of the CancelTimer decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CancelTimerFailedCause":{ - "type":"string", - "enum":[ - "TIMER_ID_UNKNOWN", - "OPERATION_NOT_PERMITTED" - ] - }, - "CancelTimerFailedEventAttributes":{ - "type":"structure", - "required":[ - "timerId", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The timerId provided in the CancelTimer decision that failed.

" - }, - "cause":{ - "shape":"CancelTimerFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CancelTimer decision to cancel this timer. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the CancelTimerFailed event.

" - }, - "CancelWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "members":{ - "details":{ - "shape":"Data", - "documentation":"

Details of the cancellation.

" - } - }, - "documentation":"

Provides the details of the CancelWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CancelWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNHANDLED_DECISION", - "OPERATION_NOT_PERMITTED" - ] - }, - "CancelWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "cause":{ - "shape":"CancelWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CancelWorkflowExecution decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the CancelWorkflowExecutionFailed event.

" - }, - "Canceled":{"type":"boolean"}, - "CauseMessage":{ - "type":"string", - "max":1728 - }, - "ChildPolicy":{ - "type":"string", - "enum":[ - "TERMINATE", - "REQUEST_CANCEL", - "ABANDON" - ] - }, - "ChildWorkflowExecutionCanceledEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "initiatedEventId", - "startedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that was canceled.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "details":{ - "shape":"Data", - "documentation":"

Details of the cancellation (if provided).

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ChildWorkflowExecutionStarted event recorded when this child workflow execution was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provide details of the ChildWorkflowExecutionCanceled event.

" - }, - "ChildWorkflowExecutionCompletedEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "initiatedEventId", - "startedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that was completed.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "result":{ - "shape":"Data", - "documentation":"

The result of the child workflow execution.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ChildWorkflowExecutionStarted event recorded when this child workflow execution was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ChildWorkflowExecutionCompleted event.

" - }, - "ChildWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "initiatedEventId", - "startedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that failed.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "reason":{ - "shape":"FailureReason", - "documentation":"

The reason for the failure (if provided).

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the failure (if provided).

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ChildWorkflowExecutionStarted event recorded when this child workflow execution was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ChildWorkflowExecutionFailed event.

" - }, - "ChildWorkflowExecutionStartedEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "initiatedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that was started.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ChildWorkflowExecutionStarted event.

" - }, - "ChildWorkflowExecutionTerminatedEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "initiatedEventId", - "startedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that was terminated.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ChildWorkflowExecutionStarted event recorded when this child workflow execution was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ChildWorkflowExecutionTerminated event.

" - }, - "ChildWorkflowExecutionTimedOutEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "workflowType", - "timeoutType", - "initiatedEventId", - "startedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The child workflow execution that timed out.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "timeoutType":{ - "shape":"WorkflowExecutionTimeoutType", - "documentation":"

The type of the timeout that caused the child workflow execution to time out.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ChildWorkflowExecutionStarted event recorded when this child workflow execution was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ChildWorkflowExecutionTimedOut event.

" - }, - "CloseStatus":{ - "type":"string", - "enum":[ - "COMPLETED", - "FAILED", - "CANCELED", - "TERMINATED", - "CONTINUED_AS_NEW", - "TIMED_OUT" - ] - }, - "CloseStatusFilter":{ - "type":"structure", - "required":["status"], - "members":{ - "status":{ - "shape":"CloseStatus", - "documentation":"

The close status that must match the close status of an execution for it to meet the criteria of this filter.

" - } - }, - "documentation":"

Used to filter the closed workflow executions in visibility APIs by their close status.

" - }, - "CompleteWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "members":{ - "result":{ - "shape":"Data", - "documentation":"

The result of the workflow execution. The form of the result is implementation defined.

" - } - }, - "documentation":"

Provides the details of the CompleteWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "CompleteWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNHANDLED_DECISION", - "OPERATION_NOT_PERMITTED" - ] - }, - "CompleteWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "cause":{ - "shape":"CompleteWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CompleteWorkflowExecution decision to complete this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the CompleteWorkflowExecutionFailed event.

" - }, - "ContinueAsNewWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "members":{ - "input":{ - "shape":"Data", - "documentation":"

The input provided to the new workflow execution.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the total duration for this workflow execution. This overrides the defaultExecutionStartToCloseTimeout specified when registering the workflow type.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

An execution start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this field. If neither this field is set nor a default execution start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The task list to use for the decisions of the new (continued) workflow execution.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The task priority that, if set, specifies the priority for the decision tasks for this workflow execution. This overrides the defaultTaskPriority specified when registering the workflow type. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

Specifies the maximum duration of decision tasks for the new workflow execution. This parameter overrides the defaultTaskStartToCloseTimout specified when registering the workflow type using RegisterWorkflowType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A task start-to-close timeout for the new workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

If set, specifies the policy to use for the child workflow executions of the new execution if it is terminated by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout. This policy overrides the default child policy specified when registering the workflow type using RegisterWorkflowType.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

A child policy for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default child policy was specified at registration time then a fault is returned.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags to associate with the new workflow execution. A maximum of 5 tags can be specified. You can list workflow executions with a specific tag by calling ListOpenWorkflowExecutions or ListClosedWorkflowExecutions and specifying a TagFilter.

" - }, - "workflowTypeVersion":{ - "shape":"Version", - "documentation":"

The version of the workflow to start.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role to attach to the new (continued) execution.

" - } - }, - "documentation":"

Provides the details of the ContinueAsNewWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tag – A tag used to identify the workflow execution

    • taskList – String constraint. The key is swf:taskList.name.

    • workflowType.version – String constraint. The key is swf:workflowType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ContinueAsNewWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNHANDLED_DECISION", - "WORKFLOW_TYPE_DEPRECATED", - "WORKFLOW_TYPE_DOES_NOT_EXIST", - "DEFAULT_EXECUTION_START_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_TASK_START_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_TASK_LIST_UNDEFINED", - "DEFAULT_CHILD_POLICY_UNDEFINED", - "CONTINUE_AS_NEW_WORKFLOW_EXECUTION_RATE_EXCEEDED", - "OPERATION_NOT_PERMITTED" - ] - }, - "ContinueAsNewWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "cause":{ - "shape":"ContinueAsNewWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the ContinueAsNewWorkflowExecution decision that started this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ContinueAsNewWorkflowExecutionFailed event.

" - }, - "Count":{ - "type":"integer", - "min":0 - }, - "CountClosedWorkflowExecutionsInput":{ - "type":"structure", - "required":["domain"], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow executions to count.

" - }, - "startTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

If specified, only workflow executions that meet the start time criteria of the filter are counted.

startTimeFilter and closeTimeFilter are mutually exclusive. You must specify one of these in a request but not both.

" - }, - "closeTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

If specified, only workflow executions that meet the close time criteria of the filter are counted.

startTimeFilter and closeTimeFilter are mutually exclusive. You must specify one of these in a request but not both.

" - }, - "executionFilter":{ - "shape":"WorkflowExecutionFilter", - "documentation":"

If specified, only workflow executions matching the WorkflowId in the filter are counted.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "typeFilter":{ - "shape":"WorkflowTypeFilter", - "documentation":"

If specified, indicates the type of the workflow executions to be counted.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "tagFilter":{ - "shape":"TagFilter", - "documentation":"

If specified, only executions that have a tag that matches the filter are counted.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "closeStatusFilter":{ - "shape":"CloseStatusFilter", - "documentation":"

If specified, only workflow executions that match this close status are counted. This filter has an affect only if executionStatus is specified as CLOSED.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - } - } - }, - "CountOpenWorkflowExecutionsInput":{ - "type":"structure", - "required":[ - "domain", - "startTimeFilter" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow executions to count.

" - }, - "startTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

Specifies the start time criteria that workflow executions must meet in order to be counted.

" - }, - "typeFilter":{ - "shape":"WorkflowTypeFilter", - "documentation":"

Specifies the type of the workflow executions to be counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "tagFilter":{ - "shape":"TagFilter", - "documentation":"

If specified, only executions that have a tag that matches the filter are counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "executionFilter":{ - "shape":"WorkflowExecutionFilter", - "documentation":"

If specified, only workflow executions matching the WorkflowId in the filter are counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - } - } - }, - "CountPendingActivityTasksInput":{ - "type":"structure", - "required":[ - "domain", - "taskList" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain that contains the task list.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list.

" - } - } - }, - "CountPendingDecisionTasksInput":{ - "type":"structure", - "required":[ - "domain", - "taskList" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain that contains the task list.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list.

" - } - } - }, - "Data":{ - "type":"string", - "max":32768 - }, - "Decision":{ - "type":"structure", - "required":["decisionType"], - "members":{ - "decisionType":{ - "shape":"DecisionType", - "documentation":"

Specifies the type of the decision.

" - }, - "scheduleActivityTaskDecisionAttributes":{ - "shape":"ScheduleActivityTaskDecisionAttributes", - "documentation":"

Provides the details of the ScheduleActivityTask decision. It isn't set for other decision types.

" - }, - "requestCancelActivityTaskDecisionAttributes":{ - "shape":"RequestCancelActivityTaskDecisionAttributes", - "documentation":"

Provides the details of the RequestCancelActivityTask decision. It isn't set for other decision types.

" - }, - "completeWorkflowExecutionDecisionAttributes":{ - "shape":"CompleteWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the CompleteWorkflowExecution decision. It isn't set for other decision types.

" - }, - "failWorkflowExecutionDecisionAttributes":{ - "shape":"FailWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the FailWorkflowExecution decision. It isn't set for other decision types.

" - }, - "cancelWorkflowExecutionDecisionAttributes":{ - "shape":"CancelWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the CancelWorkflowExecution decision. It isn't set for other decision types.

" - }, - "continueAsNewWorkflowExecutionDecisionAttributes":{ - "shape":"ContinueAsNewWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the ContinueAsNewWorkflowExecution decision. It isn't set for other decision types.

" - }, - "recordMarkerDecisionAttributes":{ - "shape":"RecordMarkerDecisionAttributes", - "documentation":"

Provides the details of the RecordMarker decision. It isn't set for other decision types.

" - }, - "startTimerDecisionAttributes":{ - "shape":"StartTimerDecisionAttributes", - "documentation":"

Provides the details of the StartTimer decision. It isn't set for other decision types.

" - }, - "cancelTimerDecisionAttributes":{ - "shape":"CancelTimerDecisionAttributes", - "documentation":"

Provides the details of the CancelTimer decision. It isn't set for other decision types.

" - }, - "signalExternalWorkflowExecutionDecisionAttributes":{ - "shape":"SignalExternalWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the SignalExternalWorkflowExecution decision. It isn't set for other decision types.

" - }, - "requestCancelExternalWorkflowExecutionDecisionAttributes":{ - "shape":"RequestCancelExternalWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the RequestCancelExternalWorkflowExecution decision. It isn't set for other decision types.

" - }, - "startChildWorkflowExecutionDecisionAttributes":{ - "shape":"StartChildWorkflowExecutionDecisionAttributes", - "documentation":"

Provides the details of the StartChildWorkflowExecution decision. It isn't set for other decision types.

" - }, - "scheduleLambdaFunctionDecisionAttributes":{ - "shape":"ScheduleLambdaFunctionDecisionAttributes", - "documentation":"

Provides the details of the ScheduleLambdaFunction decision. It isn't set for other decision types.

" - } - }, - "documentation":"

Specifies a decision made by the decider. A decision can be one of these types:

  • CancelTimer – Cancels a previously started timer and records a TimerCanceled event in the history.

  • CancelWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionCanceled event in the history.

  • CompleteWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionCompleted event in the history .

  • ContinueAsNewWorkflowExecution – Closes the workflow execution and starts a new workflow execution of the same type using the same workflow ID and a unique run Id. A WorkflowExecutionContinuedAsNew event is recorded in the history.

  • FailWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionFailed event in the history.

  • RecordMarker – Records a MarkerRecorded event in the history. Markers can be used for adding custom information in the history for instance to let deciders know that they don't need to look at the history beyond the marker event.

  • RequestCancelActivityTask – Attempts to cancel a previously scheduled activity task. If the activity task was scheduled but has not been assigned to a worker, then it is canceled. If the activity task was already assigned to a worker, then the worker is informed that cancellation has been requested in the response to RecordActivityTaskHeartbeat.

  • RequestCancelExternalWorkflowExecution – Requests that a request be made to cancel the specified external workflow execution and records a RequestCancelExternalWorkflowExecutionInitiated event in the history.

  • ScheduleActivityTask – Schedules an activity task.

  • SignalExternalWorkflowExecution – Requests a signal to be delivered to the specified external workflow execution and records a SignalExternalWorkflowExecutionInitiated event in the history.

  • StartChildWorkflowExecution – Requests that a child workflow execution be started and records a StartChildWorkflowExecutionInitiated event in the history. The child workflow execution is a separate workflow execution with its own history.

  • StartTimer – Starts a timer for this workflow execution and records a TimerStarted event in the history. This timer fires after the specified delay and record a TimerFired event.

Access Control

If you grant permission to use RespondDecisionTaskCompleted, you can use IAM policies to express permissions for the list of decisions returned by this action as if they were members of the API. Treating decisions as a pseudo API maintains a uniform conceptual model and helps keep policies readable. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

Decision Failure

Decisions can fail for several reasons

  • The ordering of decisions should follow a logical flow. Some decisions might not make sense in the current context of the workflow execution and therefore fails.

  • A limit on your account was reached.

  • The decision lacks sufficient permissions.

One of the following events might be added to the history to indicate an error. The event attribute's cause parameter indicates the cause. If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

  • ScheduleActivityTaskFailed – A ScheduleActivityTask decision failed. This could happen if the activity type specified in the decision isn't registered, is in a deprecated state, or the decision isn't properly configured.

  • RequestCancelActivityTaskFailed – A RequestCancelActivityTask decision failed. This could happen if there is no open activity task with the specified activityId.

  • StartTimerFailed – A StartTimer decision failed. This could happen if there is another open timer with the same timerId.

  • CancelTimerFailed – A CancelTimer decision failed. This could happen if there is no open timer with the specified timerId.

  • StartChildWorkflowExecutionFailed – A StartChildWorkflowExecution decision failed. This could happen if the workflow type specified isn't registered, is deprecated, or the decision isn't properly configured.

  • SignalExternalWorkflowExecutionFailed – A SignalExternalWorkflowExecution decision failed. This could happen if the workflowID specified in the decision was incorrect.

  • RequestCancelExternalWorkflowExecutionFailed – A RequestCancelExternalWorkflowExecution decision failed. This could happen if the workflowID specified in the decision was incorrect.

  • CancelWorkflowExecutionFailed – A CancelWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution.

  • CompleteWorkflowExecutionFailed – A CompleteWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution.

  • ContinueAsNewWorkflowExecutionFailed – A ContinueAsNewWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution or the ContinueAsNewWorkflowExecution decision was not configured correctly.

  • FailWorkflowExecutionFailed – A FailWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution.

The preceding error events might occur due to an error in the decider logic, which might put the workflow execution in an unstable state The cause field in the event structure for the error event indicates the cause of the error.

A workflow execution may be closed by the decider by returning one of the following decisions when completing a decision task: CompleteWorkflowExecution, FailWorkflowExecution, CancelWorkflowExecution and ContinueAsNewWorkflowExecution. An UnhandledDecision fault is returned if a workflow closing decision is specified and a signal or activity event had been added to the history while the decision task was being performed by the decider. Unlike the above situations which are logic issues, this fault is always possible because of race conditions in a distributed system. The right action here is to call RespondDecisionTaskCompleted without any decisions. This would result in another decision task with these new events included in the history. The decider should handle the new events and may decide to close the workflow execution.

How to Code a Decision

You code a decision by first setting the decision type field to one of the above decision values, and then set the corresponding attributes field shown below:

" - }, - "DecisionList":{ - "type":"list", - "member":{"shape":"Decision"} - }, - "DecisionTask":{ - "type":"structure", - "required":[ - "taskToken", - "startedEventId", - "workflowExecution", - "workflowType", - "events" - ], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The opaque string used as a handle on the task. This token is used by workers to communicate progress and response information back to the system about the task.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskStarted event recorded in the history.

" - }, - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The workflow execution for which this decision task was created.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the workflow execution for which this decision task was created.

" - }, - "events":{ - "shape":"HistoryEventList", - "documentation":"

A paginated list of history events of the workflow execution. The decider uses this during the processing of the decision task.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "previousStartedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskStarted event of the previous decision task of this workflow execution that was processed by the decider. This can be used to determine the events in the history new since the last decision task received by the decider.

" - } - }, - "documentation":"

A structure that represents a decision task. Decision tasks are sent to deciders in order for them to make decisions.

" - }, - "DecisionTaskCompletedEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "executionContext":{ - "shape":"Data", - "documentation":"

User defined context for the workflow execution.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskScheduled event that was recorded when this decision task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskStarted event recorded when this decision task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the DecisionTaskCompleted event.

" - }, - "DecisionTaskScheduledEventAttributes":{ - "type":"structure", - "required":["taskList"], - "members":{ - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list in which the decision task was scheduled.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

A task priority that, if set, specifies the priority for this decision task. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "startToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration for this decision task. The task is considered timed out if it doesn't completed within this duration.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - } - }, - "documentation":"

Provides details about the DecisionTaskScheduled event.

" - }, - "DecisionTaskStartedEventAttributes":{ - "type":"structure", - "required":["scheduledEventId"], - "members":{ - "identity":{ - "shape":"Identity", - "documentation":"

Identity of the decider making the request. This enables diagnostic tracing when problems arise. The form of this identity is user defined.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskScheduled event that was recorded when this decision task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the DecisionTaskStarted event.

" - }, - "DecisionTaskTimedOutEventAttributes":{ - "type":"structure", - "required":[ - "timeoutType", - "scheduledEventId", - "startedEventId" - ], - "members":{ - "timeoutType":{ - "shape":"DecisionTaskTimeoutType", - "documentation":"

The type of timeout that expired before the decision task could be completed.

" - }, - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskScheduled event that was recorded when this decision task was scheduled. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskStarted event recorded when this decision task was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the DecisionTaskTimedOut event.

" - }, - "DecisionTaskTimeoutType":{ - "type":"string", - "enum":["START_TO_CLOSE"] - }, - "DecisionType":{ - "type":"string", - "enum":[ - "ScheduleActivityTask", - "RequestCancelActivityTask", - "CompleteWorkflowExecution", - "FailWorkflowExecution", - "CancelWorkflowExecution", - "ContinueAsNewWorkflowExecution", - "RecordMarker", - "StartTimer", - "CancelTimer", - "SignalExternalWorkflowExecution", - "RequestCancelExternalWorkflowExecution", - "StartChildWorkflowExecution", - "ScheduleLambdaFunction" - ] - }, - "DefaultUndefinedFault":{ - "type":"structure", - "members":{ - "message":{"shape":"ErrorMessage"} - }, - "documentation":"

The StartWorkflowExecution API action was called without the required parameters set.

Some workflow execution parameters, such as the decision taskList, must be set to start the execution. However, these parameters might have been set as defaults when the workflow type was registered. In this case, you can omit these parameters from the StartWorkflowExecution call and Amazon SWF uses the values defined in the workflow type.

If these parameters aren't set and no default parameters were defined in the workflow type, this error is displayed.

", - "exception":true - }, - "DeprecateActivityTypeInput":{ - "type":"structure", - "required":[ - "domain", - "activityType" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the activity type is registered.

" - }, - "activityType":{ - "shape":"ActivityType", - "documentation":"

The activity type to deprecate.

" - } - } - }, - "DeprecateDomainInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"DomainName", - "documentation":"

The name of the domain to deprecate.

" - } - } - }, - "DeprecateWorkflowTypeInput":{ - "type":"structure", - "required":[ - "domain", - "workflowType" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the workflow type is registered.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type to deprecate.

" - } - } - }, - "DescribeActivityTypeInput":{ - "type":"structure", - "required":[ - "domain", - "activityType" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the activity type is registered.

" - }, - "activityType":{ - "shape":"ActivityType", - "documentation":"

The activity type to get information about. Activity types are identified by the name and version that were supplied when the activity was registered.

" - } - } - }, - "DescribeDomainInput":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"DomainName", - "documentation":"

The name of the domain to describe.

" - } - } - }, - "DescribeWorkflowExecutionInput":{ - "type":"structure", - "required":[ - "domain", - "execution" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow execution.

" - }, - "execution":{ - "shape":"WorkflowExecution", - "documentation":"

The workflow execution to describe.

" - } - } - }, - "DescribeWorkflowTypeInput":{ - "type":"structure", - "required":[ - "domain", - "workflowType" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which this workflow type is registered.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type to describe.

" - } - } - }, - "Description":{ - "type":"string", - "max":1024 - }, - "DomainAlreadyExistsFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned if the specified domain already exists. You get this fault even if the existing domain is in deprecated status.

", - "exception":true - }, - "DomainConfiguration":{ - "type":"structure", - "required":["workflowExecutionRetentionPeriodInDays"], - "members":{ - "workflowExecutionRetentionPeriodInDays":{ - "shape":"DurationInDays", - "documentation":"

The retention period for workflow executions in this domain.

" - } - }, - "documentation":"

Contains the configuration settings of a domain.

" - }, - "DomainDeprecatedFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned when the specified domain has been deprecated.

", - "exception":true - }, - "DomainDetail":{ - "type":"structure", - "required":[ - "domainInfo", - "configuration" - ], - "members":{ - "domainInfo":{ - "shape":"DomainInfo", - "documentation":"

The basic information about a domain, such as its name, status, and description.

" - }, - "configuration":{ - "shape":"DomainConfiguration", - "documentation":"

The domain configuration. Currently, this includes only the domain's retention period.

" - } - }, - "documentation":"

Contains details of a domain.

" - }, - "DomainInfo":{ - "type":"structure", - "required":[ - "name", - "status" - ], - "members":{ - "name":{ - "shape":"DomainName", - "documentation":"

The name of the domain. This name is unique within the account.

" - }, - "status":{ - "shape":"RegistrationStatus", - "documentation":"

The status of the domain:

  • REGISTERED – The domain is properly registered and available. You can use this domain for registering types and creating new workflow executions.

  • DEPRECATED – The domain was deprecated using DeprecateDomain, but is still in use. You should not create new workflow executions in this domain.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the domain provided through RegisterDomain.

" - } - }, - "documentation":"

Contains general information about a domain.

" - }, - "DomainInfoList":{ - "type":"list", - "member":{"shape":"DomainInfo"} - }, - "DomainInfos":{ - "type":"structure", - "required":["domainInfos"], - "members":{ - "domainInfos":{ - "shape":"DomainInfoList", - "documentation":"

A list of DomainInfo structures.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - } - }, - "documentation":"

Contains a paginated collection of DomainInfo structures.

" - }, - "DomainName":{ - "type":"string", - "max":256, - "min":1 - }, - "DurationInDays":{ - "type":"string", - "max":8, - "min":1 - }, - "DurationInSeconds":{ - "type":"string", - "max":8, - "min":1 - }, - "DurationInSecondsOptional":{ - "type":"string", - "max":8 - }, - "ErrorMessage":{"type":"string"}, - "EventId":{"type":"long"}, - "EventType":{ - "type":"string", - "enum":[ - "WorkflowExecutionStarted", - "WorkflowExecutionCancelRequested", - "WorkflowExecutionCompleted", - "CompleteWorkflowExecutionFailed", - "WorkflowExecutionFailed", - "FailWorkflowExecutionFailed", - "WorkflowExecutionTimedOut", - "WorkflowExecutionCanceled", - "CancelWorkflowExecutionFailed", - "WorkflowExecutionContinuedAsNew", - "ContinueAsNewWorkflowExecutionFailed", - "WorkflowExecutionTerminated", - "DecisionTaskScheduled", - "DecisionTaskStarted", - "DecisionTaskCompleted", - "DecisionTaskTimedOut", - "ActivityTaskScheduled", - "ScheduleActivityTaskFailed", - "ActivityTaskStarted", - "ActivityTaskCompleted", - "ActivityTaskFailed", - "ActivityTaskTimedOut", - "ActivityTaskCanceled", - "ActivityTaskCancelRequested", - "RequestCancelActivityTaskFailed", - "WorkflowExecutionSignaled", - "MarkerRecorded", - "RecordMarkerFailed", - "TimerStarted", - "StartTimerFailed", - "TimerFired", - "TimerCanceled", - "CancelTimerFailed", - "StartChildWorkflowExecutionInitiated", - "StartChildWorkflowExecutionFailed", - "ChildWorkflowExecutionStarted", - "ChildWorkflowExecutionCompleted", - "ChildWorkflowExecutionFailed", - "ChildWorkflowExecutionTimedOut", - "ChildWorkflowExecutionCanceled", - "ChildWorkflowExecutionTerminated", - "SignalExternalWorkflowExecutionInitiated", - "SignalExternalWorkflowExecutionFailed", - "ExternalWorkflowExecutionSignaled", - "RequestCancelExternalWorkflowExecutionInitiated", - "RequestCancelExternalWorkflowExecutionFailed", - "ExternalWorkflowExecutionCancelRequested", - "LambdaFunctionScheduled", - "LambdaFunctionStarted", - "LambdaFunctionCompleted", - "LambdaFunctionFailed", - "LambdaFunctionTimedOut", - "ScheduleLambdaFunctionFailed", - "StartLambdaFunctionFailed" - ] - }, - "ExecutionStatus":{ - "type":"string", - "enum":[ - "OPEN", - "CLOSED" - ] - }, - "ExecutionTimeFilter":{ - "type":"structure", - "required":["oldestDate"], - "members":{ - "oldestDate":{ - "shape":"Timestamp", - "documentation":"

Specifies the oldest start or close date and time to return.

" - }, - "latestDate":{ - "shape":"Timestamp", - "documentation":"

Specifies the latest start or close date and time to return.

" - } - }, - "documentation":"

Used to filter the workflow executions in visibility APIs by various time-based rules. Each parameter, if specified, defines a rule that must be satisfied by each returned query result. The parameter values are in the Unix Time format. For example: \"oldestDate\": 1325376070.

" - }, - "ExternalWorkflowExecutionCancelRequestedEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "initiatedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The external workflow execution to which the cancellation request was delivered.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the RequestCancelExternalWorkflowExecutionInitiated event corresponding to the RequestCancelExternalWorkflowExecution decision to cancel this external workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ExternalWorkflowExecutionCancelRequested event.

" - }, - "ExternalWorkflowExecutionSignaledEventAttributes":{ - "type":"structure", - "required":[ - "workflowExecution", - "initiatedEventId" - ], - "members":{ - "workflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The external workflow execution that the signal was delivered to.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the SignalExternalWorkflowExecutionInitiated event corresponding to the SignalExternalWorkflowExecution decision to request this signal. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ExternalWorkflowExecutionSignaled event.

" - }, - "FailWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "members":{ - "reason":{ - "shape":"FailureReason", - "documentation":"

A descriptive reason for the failure that may help in diagnostics.

" - }, - "details":{ - "shape":"Data", - "documentation":"

Details of the failure.

" - } - }, - "documentation":"

Provides the details of the FailWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "FailWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNHANDLED_DECISION", - "OPERATION_NOT_PERMITTED" - ] - }, - "FailWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "cause":{ - "shape":"FailWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the FailWorkflowExecution decision to fail this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the FailWorkflowExecutionFailed event.

" - }, - "FailureReason":{ - "type":"string", - "max":256 - }, - "FunctionId":{ - "type":"string", - "max":256, - "min":1 - }, - "FunctionInput":{ - "type":"string", - "max":32768, - "min":0 - }, - "FunctionName":{ - "type":"string", - "max":64, - "min":1 - }, - "GetWorkflowExecutionHistoryInput":{ - "type":"structure", - "required":[ - "domain", - "execution" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow execution.

" - }, - "execution":{ - "shape":"WorkflowExecution", - "documentation":"

Specifies the workflow execution for which to return the history.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the events in reverse order. By default the results are returned in ascending order of the eventTimeStamp of the events.

" - } - } - }, - "History":{ - "type":"structure", - "required":["events"], - "members":{ - "events":{ - "shape":"HistoryEventList", - "documentation":"

The list of history events.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - } - }, - "documentation":"

Paginated representation of a workflow history for a workflow execution. This is the up to date, complete and authoritative record of the events related to all tasks and events in the life of the workflow execution.

" - }, - "HistoryEvent":{ - "type":"structure", - "required":[ - "eventTimestamp", - "eventType", - "eventId" - ], - "members":{ - "eventTimestamp":{ - "shape":"Timestamp", - "documentation":"

The date and time when the event occurred.

" - }, - "eventType":{ - "shape":"EventType", - "documentation":"

The type of the history event.

" - }, - "eventId":{ - "shape":"EventId", - "documentation":"

The system generated ID of the event. This ID uniquely identifies the event with in the workflow execution history.

" - }, - "workflowExecutionStartedEventAttributes":{ - "shape":"WorkflowExecutionStartedEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionStarted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionCompletedEventAttributes":{ - "shape":"WorkflowExecutionCompletedEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionCompleted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "completeWorkflowExecutionFailedEventAttributes":{ - "shape":"CompleteWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type CompleteWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionFailedEventAttributes":{ - "shape":"WorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "failWorkflowExecutionFailedEventAttributes":{ - "shape":"FailWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type FailWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionTimedOutEventAttributes":{ - "shape":"WorkflowExecutionTimedOutEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionTimedOut then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionCanceledEventAttributes":{ - "shape":"WorkflowExecutionCanceledEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionCanceled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "cancelWorkflowExecutionFailedEventAttributes":{ - "shape":"CancelWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type CancelWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionContinuedAsNewEventAttributes":{ - "shape":"WorkflowExecutionContinuedAsNewEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionContinuedAsNew then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "continueAsNewWorkflowExecutionFailedEventAttributes":{ - "shape":"ContinueAsNewWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type ContinueAsNewWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionTerminatedEventAttributes":{ - "shape":"WorkflowExecutionTerminatedEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionTerminated then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionCancelRequestedEventAttributes":{ - "shape":"WorkflowExecutionCancelRequestedEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionCancelRequested then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "decisionTaskScheduledEventAttributes":{ - "shape":"DecisionTaskScheduledEventAttributes", - "documentation":"

If the event is of type DecisionTaskScheduled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "decisionTaskStartedEventAttributes":{ - "shape":"DecisionTaskStartedEventAttributes", - "documentation":"

If the event is of type DecisionTaskStarted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "decisionTaskCompletedEventAttributes":{ - "shape":"DecisionTaskCompletedEventAttributes", - "documentation":"

If the event is of type DecisionTaskCompleted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "decisionTaskTimedOutEventAttributes":{ - "shape":"DecisionTaskTimedOutEventAttributes", - "documentation":"

If the event is of type DecisionTaskTimedOut then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskScheduledEventAttributes":{ - "shape":"ActivityTaskScheduledEventAttributes", - "documentation":"

If the event is of type ActivityTaskScheduled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskStartedEventAttributes":{ - "shape":"ActivityTaskStartedEventAttributes", - "documentation":"

If the event is of type ActivityTaskStarted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskCompletedEventAttributes":{ - "shape":"ActivityTaskCompletedEventAttributes", - "documentation":"

If the event is of type ActivityTaskCompleted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskFailedEventAttributes":{ - "shape":"ActivityTaskFailedEventAttributes", - "documentation":"

If the event is of type ActivityTaskFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskTimedOutEventAttributes":{ - "shape":"ActivityTaskTimedOutEventAttributes", - "documentation":"

If the event is of type ActivityTaskTimedOut then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskCanceledEventAttributes":{ - "shape":"ActivityTaskCanceledEventAttributes", - "documentation":"

If the event is of type ActivityTaskCanceled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "activityTaskCancelRequestedEventAttributes":{ - "shape":"ActivityTaskCancelRequestedEventAttributes", - "documentation":"

If the event is of type ActivityTaskcancelRequested then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "workflowExecutionSignaledEventAttributes":{ - "shape":"WorkflowExecutionSignaledEventAttributes", - "documentation":"

If the event is of type WorkflowExecutionSignaled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "markerRecordedEventAttributes":{ - "shape":"MarkerRecordedEventAttributes", - "documentation":"

If the event is of type MarkerRecorded then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "recordMarkerFailedEventAttributes":{ - "shape":"RecordMarkerFailedEventAttributes", - "documentation":"

If the event is of type DecisionTaskFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "timerStartedEventAttributes":{ - "shape":"TimerStartedEventAttributes", - "documentation":"

If the event is of type TimerStarted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "timerFiredEventAttributes":{ - "shape":"TimerFiredEventAttributes", - "documentation":"

If the event is of type TimerFired then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "timerCanceledEventAttributes":{ - "shape":"TimerCanceledEventAttributes", - "documentation":"

If the event is of type TimerCanceled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "startChildWorkflowExecutionInitiatedEventAttributes":{ - "shape":"StartChildWorkflowExecutionInitiatedEventAttributes", - "documentation":"

If the event is of type StartChildWorkflowExecutionInitiated then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionStartedEventAttributes":{ - "shape":"ChildWorkflowExecutionStartedEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionStarted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionCompletedEventAttributes":{ - "shape":"ChildWorkflowExecutionCompletedEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionCompleted then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionFailedEventAttributes":{ - "shape":"ChildWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionTimedOutEventAttributes":{ - "shape":"ChildWorkflowExecutionTimedOutEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionTimedOut then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionCanceledEventAttributes":{ - "shape":"ChildWorkflowExecutionCanceledEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionCanceled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "childWorkflowExecutionTerminatedEventAttributes":{ - "shape":"ChildWorkflowExecutionTerminatedEventAttributes", - "documentation":"

If the event is of type ChildWorkflowExecutionTerminated then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "signalExternalWorkflowExecutionInitiatedEventAttributes":{ - "shape":"SignalExternalWorkflowExecutionInitiatedEventAttributes", - "documentation":"

If the event is of type SignalExternalWorkflowExecutionInitiated then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "externalWorkflowExecutionSignaledEventAttributes":{ - "shape":"ExternalWorkflowExecutionSignaledEventAttributes", - "documentation":"

If the event is of type ExternalWorkflowExecutionSignaled then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "signalExternalWorkflowExecutionFailedEventAttributes":{ - "shape":"SignalExternalWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type SignalExternalWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "externalWorkflowExecutionCancelRequestedEventAttributes":{ - "shape":"ExternalWorkflowExecutionCancelRequestedEventAttributes", - "documentation":"

If the event is of type ExternalWorkflowExecutionCancelRequested then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "requestCancelExternalWorkflowExecutionInitiatedEventAttributes":{ - "shape":"RequestCancelExternalWorkflowExecutionInitiatedEventAttributes", - "documentation":"

If the event is of type RequestCancelExternalWorkflowExecutionInitiated then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "requestCancelExternalWorkflowExecutionFailedEventAttributes":{ - "shape":"RequestCancelExternalWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type RequestCancelExternalWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "scheduleActivityTaskFailedEventAttributes":{ - "shape":"ScheduleActivityTaskFailedEventAttributes", - "documentation":"

If the event is of type ScheduleActivityTaskFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "requestCancelActivityTaskFailedEventAttributes":{ - "shape":"RequestCancelActivityTaskFailedEventAttributes", - "documentation":"

If the event is of type RequestCancelActivityTaskFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "startTimerFailedEventAttributes":{ - "shape":"StartTimerFailedEventAttributes", - "documentation":"

If the event is of type StartTimerFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "cancelTimerFailedEventAttributes":{ - "shape":"CancelTimerFailedEventAttributes", - "documentation":"

If the event is of type CancelTimerFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "startChildWorkflowExecutionFailedEventAttributes":{ - "shape":"StartChildWorkflowExecutionFailedEventAttributes", - "documentation":"

If the event is of type StartChildWorkflowExecutionFailed then this member is set and provides detailed information about the event. It isn't set for other event types.

" - }, - "lambdaFunctionScheduledEventAttributes":{ - "shape":"LambdaFunctionScheduledEventAttributes", - "documentation":"

Provides the details of the LambdaFunctionScheduled event. It isn't set for other event types.

" - }, - "lambdaFunctionStartedEventAttributes":{ - "shape":"LambdaFunctionStartedEventAttributes", - "documentation":"

Provides the details of the LambdaFunctionStarted event. It isn't set for other event types.

" - }, - "lambdaFunctionCompletedEventAttributes":{ - "shape":"LambdaFunctionCompletedEventAttributes", - "documentation":"

Provides the details of the LambdaFunctionCompleted event. It isn't set for other event types.

" - }, - "lambdaFunctionFailedEventAttributes":{ - "shape":"LambdaFunctionFailedEventAttributes", - "documentation":"

Provides the details of the LambdaFunctionFailed event. It isn't set for other event types.

" - }, - "lambdaFunctionTimedOutEventAttributes":{ - "shape":"LambdaFunctionTimedOutEventAttributes", - "documentation":"

Provides the details of the LambdaFunctionTimedOut event. It isn't set for other event types.

" - }, - "scheduleLambdaFunctionFailedEventAttributes":{ - "shape":"ScheduleLambdaFunctionFailedEventAttributes", - "documentation":"

Provides the details of the ScheduleLambdaFunctionFailed event. It isn't set for other event types.

" - }, - "startLambdaFunctionFailedEventAttributes":{ - "shape":"StartLambdaFunctionFailedEventAttributes", - "documentation":"

Provides the details of the StartLambdaFunctionFailed event. It isn't set for other event types.

" - } - }, - "documentation":"

Event within a workflow execution. A history event can be one of these types:

  • ActivityTaskCancelRequested – A RequestCancelActivityTask decision was received by the system.

  • ActivityTaskCanceled – The activity task was successfully canceled.

  • ActivityTaskCompleted – An activity worker successfully completed an activity task by calling RespondActivityTaskCompleted.

  • ActivityTaskFailed – An activity worker failed an activity task by calling RespondActivityTaskFailed.

  • ActivityTaskScheduled – An activity task was scheduled for execution.

  • ActivityTaskStarted – The scheduled activity task was dispatched to a worker.

  • ActivityTaskTimedOut – The activity task timed out.

  • CancelTimerFailed – Failed to process CancelTimer decision. This happens when the decision isn't configured properly, for example no timer exists with the specified timer Id.

  • CancelWorkflowExecutionFailed – A request to cancel a workflow execution failed.

  • ChildWorkflowExecutionCanceled – A child workflow execution, started by this workflow execution, was canceled and closed.

  • ChildWorkflowExecutionCompleted – A child workflow execution, started by this workflow execution, completed successfully and was closed.

  • ChildWorkflowExecutionFailed – A child workflow execution, started by this workflow execution, failed to complete successfully and was closed.

  • ChildWorkflowExecutionStarted – A child workflow execution was successfully started.

  • ChildWorkflowExecutionTerminated – A child workflow execution, started by this workflow execution, was terminated.

  • ChildWorkflowExecutionTimedOut – A child workflow execution, started by this workflow execution, timed out and was closed.

  • CompleteWorkflowExecutionFailed – The workflow execution failed to complete.

  • ContinueAsNewWorkflowExecutionFailed – The workflow execution failed to complete after being continued as a new workflow execution.

  • DecisionTaskCompleted – The decider successfully completed a decision task by calling RespondDecisionTaskCompleted.

  • DecisionTaskScheduled – A decision task was scheduled for the workflow execution.

  • DecisionTaskStarted – The decision task was dispatched to a decider.

  • DecisionTaskTimedOut – The decision task timed out.

  • ExternalWorkflowExecutionCancelRequested – Request to cancel an external workflow execution was successfully delivered to the target execution.

  • ExternalWorkflowExecutionSignaled – A signal, requested by this workflow execution, was successfully delivered to the target external workflow execution.

  • FailWorkflowExecutionFailed – A request to mark a workflow execution as failed, itself failed.

  • MarkerRecorded – A marker was recorded in the workflow history as the result of a RecordMarker decision.

  • RecordMarkerFailed – A RecordMarker decision was returned as failed.

  • RequestCancelActivityTaskFailed – Failed to process RequestCancelActivityTask decision. This happens when the decision isn't configured properly.

  • RequestCancelExternalWorkflowExecutionFailed – Request to cancel an external workflow execution failed.

  • RequestCancelExternalWorkflowExecutionInitiated – A request was made to request the cancellation of an external workflow execution.

  • ScheduleActivityTaskFailed – Failed to process ScheduleActivityTask decision. This happens when the decision isn't configured properly, for example the activity type specified isn't registered.

  • SignalExternalWorkflowExecutionFailed – The request to signal an external workflow execution failed.

  • SignalExternalWorkflowExecutionInitiated – A request to signal an external workflow was made.

  • StartActivityTaskFailed – A scheduled activity task failed to start.

  • StartChildWorkflowExecutionFailed – Failed to process StartChildWorkflowExecution decision. This happens when the decision isn't configured properly, for example the workflow type specified isn't registered.

  • StartChildWorkflowExecutionInitiated – A request was made to start a child workflow execution.

  • StartTimerFailed – Failed to process StartTimer decision. This happens when the decision isn't configured properly, for example a timer already exists with the specified timer Id.

  • TimerCanceled – A timer, previously started for this workflow execution, was successfully canceled.

  • TimerFired – A timer, previously started for this workflow execution, fired.

  • TimerStarted – A timer was started for the workflow execution due to a StartTimer decision.

  • WorkflowExecutionCancelRequested – A request to cancel this workflow execution was made.

  • WorkflowExecutionCanceled – The workflow execution was successfully canceled and closed.

  • WorkflowExecutionCompleted – The workflow execution was closed due to successful completion.

  • WorkflowExecutionContinuedAsNew – The workflow execution was closed and a new execution of the same type was created with the same workflowId.

  • WorkflowExecutionFailed – The workflow execution closed due to a failure.

  • WorkflowExecutionSignaled – An external signal was received for the workflow execution.

  • WorkflowExecutionStarted – The workflow execution was started.

  • WorkflowExecutionTerminated – The workflow execution was terminated.

  • WorkflowExecutionTimedOut – The workflow execution was closed because a time out was exceeded.

" - }, - "HistoryEventList":{ - "type":"list", - "member":{"shape":"HistoryEvent"} - }, - "Identity":{ - "type":"string", - "max":256 - }, - "LambdaFunctionCompletedEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionScheduled event that was recorded when this Lambda task was scheduled. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionStarted event recorded when this activity task started. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "result":{ - "shape":"Data", - "documentation":"

The results of the Lambda task.

" - } - }, - "documentation":"

Provides the details of the LambdaFunctionCompleted event. It isn't set for other event types.

" - }, - "LambdaFunctionFailedEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionScheduled event that was recorded when this activity task was scheduled. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionStarted event recorded when this activity task started. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "reason":{ - "shape":"FailureReason", - "documentation":"

The reason provided for the failure.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the failure.

" - } - }, - "documentation":"

Provides the details of the LambdaFunctionFailed event. It isn't set for other event types.

" - }, - "LambdaFunctionScheduledEventAttributes":{ - "type":"structure", - "required":[ - "id", - "name", - "decisionTaskCompletedEventId" - ], - "members":{ - "id":{ - "shape":"FunctionId", - "documentation":"

The unique ID of the Lambda task.

" - }, - "name":{ - "shape":"FunctionName", - "documentation":"

The name of the Lambda function.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the Lambda task.

" - }, - "input":{ - "shape":"FunctionInput", - "documentation":"

The input provided to the Lambda task.

" - }, - "startToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum amount of time a worker can take to process the Lambda task.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionCompleted event corresponding to the decision that resulted in scheduling this activity task. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the LambdaFunctionScheduled event. It isn't set for other event types.

" - }, - "LambdaFunctionStartedEventAttributes":{ - "type":"structure", - "required":["scheduledEventId"], - "members":{ - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionScheduled event that was recorded when this activity task was scheduled. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the LambdaFunctionStarted event. It isn't set for other event types.

" - }, - "LambdaFunctionTimedOutEventAttributes":{ - "type":"structure", - "required":[ - "scheduledEventId", - "startedEventId" - ], - "members":{ - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionScheduled event that was recorded when this activity task was scheduled. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskStarted event that was recorded when this activity task started. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "timeoutType":{ - "shape":"LambdaFunctionTimeoutType", - "documentation":"

The type of the timeout that caused this event.

" - } - }, - "documentation":"

Provides details of the LambdaFunctionTimedOut event.

" - }, - "LambdaFunctionTimeoutType":{ - "type":"string", - "enum":["START_TO_CLOSE"] - }, - "LimitExceededFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned by any operation if a system imposed limitation has been reached. To address this fault you should either clean up unused resources or increase the limit by contacting AWS.

", - "exception":true - }, - "LimitedData":{ - "type":"string", - "max":2048 - }, - "ListActivityTypesInput":{ - "type":"structure", - "required":[ - "domain", - "registrationStatus" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the activity types have been registered.

" - }, - "name":{ - "shape":"Name", - "documentation":"

If specified, only lists the activity types that have this name.

" - }, - "registrationStatus":{ - "shape":"RegistrationStatus", - "documentation":"

Specifies the registration status of the activity types to list.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the results in reverse order. By default, the results are returned in ascending alphabetical order by name of the activity types.

" - } - } - }, - "ListClosedWorkflowExecutionsInput":{ - "type":"structure", - "required":["domain"], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain that contains the workflow executions to list.

" - }, - "startTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

If specified, the workflow executions are included in the returned results based on whether their start times are within the range specified by this filter. Also, if this parameter is specified, the returned results are ordered by their start times.

startTimeFilter and closeTimeFilter are mutually exclusive. You must specify one of these in a request but not both.

" - }, - "closeTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

If specified, the workflow executions are included in the returned results based on whether their close times are within the range specified by this filter. Also, if this parameter is specified, the returned results are ordered by their close times.

startTimeFilter and closeTimeFilter are mutually exclusive. You must specify one of these in a request but not both.

" - }, - "executionFilter":{ - "shape":"WorkflowExecutionFilter", - "documentation":"

If specified, only workflow executions matching the workflow ID specified in the filter are returned.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "closeStatusFilter":{ - "shape":"CloseStatusFilter", - "documentation":"

If specified, only workflow executions that match this close status are listed. For example, if TERMINATED is specified, then only TERMINATED workflow executions are listed.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "typeFilter":{ - "shape":"WorkflowTypeFilter", - "documentation":"

If specified, only executions of the type specified in the filter are returned.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "tagFilter":{ - "shape":"TagFilter", - "documentation":"

If specified, only executions that have the matching tag are listed.

closeStatusFilter, executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the results in reverse order. By default the results are returned in descending order of the start or the close time of the executions.

" - } - } - }, - "ListDomainsInput":{ - "type":"structure", - "required":["registrationStatus"], - "members":{ - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "registrationStatus":{ - "shape":"RegistrationStatus", - "documentation":"

Specifies the registration status of the domains to list.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the results in reverse order. By default, the results are returned in ascending alphabetical order by name of the domains.

" - } - } - }, - "ListOpenWorkflowExecutionsInput":{ - "type":"structure", - "required":[ - "domain", - "startTimeFilter" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain that contains the workflow executions to list.

" - }, - "startTimeFilter":{ - "shape":"ExecutionTimeFilter", - "documentation":"

Workflow executions are included in the returned results based on whether their start times are within the range specified by this filter.

" - }, - "typeFilter":{ - "shape":"WorkflowTypeFilter", - "documentation":"

If specified, only executions of the type specified in the filter are returned.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "tagFilter":{ - "shape":"TagFilter", - "documentation":"

If specified, only executions that have the matching tag are listed.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the results in reverse order. By default the results are returned in descending order of the start time of the executions.

" - }, - "executionFilter":{ - "shape":"WorkflowExecutionFilter", - "documentation":"

If specified, only workflow executions matching the workflow ID specified in the filter are returned.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

" - } - } - }, - "ListWorkflowTypesInput":{ - "type":"structure", - "required":[ - "domain", - "registrationStatus" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the workflow types have been registered.

" - }, - "name":{ - "shape":"Name", - "documentation":"

If specified, lists the workflow type with this name.

" - }, - "registrationStatus":{ - "shape":"RegistrationStatus", - "documentation":"

Specifies the registration status of the workflow types to list.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the results in reverse order. By default the results are returned in ascending alphabetical order of the name of the workflow types.

" - } - } - }, - "MarkerName":{ - "type":"string", - "max":256, - "min":1 - }, - "MarkerRecordedEventAttributes":{ - "type":"structure", - "required":[ - "markerName", - "decisionTaskCompletedEventId" - ], - "members":{ - "markerName":{ - "shape":"MarkerName", - "documentation":"

The name of the marker.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the marker.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RecordMarker decision that requested this marker. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the MarkerRecorded event.

" - }, - "Name":{ - "type":"string", - "max":256, - "min":1 - }, - "OpenDecisionTasksCount":{ - "type":"integer", - "max":1, - "min":0 - }, - "OperationNotPermittedFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned when the caller doesn't have sufficient permissions to invoke the action.

", - "exception":true - }, - "PageSize":{ - "type":"integer", - "max":1000, - "min":0 - }, - "PageToken":{ - "type":"string", - "max":2048 - }, - "PendingTaskCount":{ - "type":"structure", - "required":["count"], - "members":{ - "count":{ - "shape":"Count", - "documentation":"

The number of tasks in the task list.

" - }, - "truncated":{ - "shape":"Truncated", - "documentation":"

If set to true, indicates that the actual count was more than the maximum supported by this API and the count returned is the truncated value.

" - } - }, - "documentation":"

Contains the count of tasks in a task list.

" - }, - "PollForActivityTaskInput":{ - "type":"structure", - "required":[ - "domain", - "taskList" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain that contains the task lists being polled.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

Specifies the task list to poll for activity tasks.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "identity":{ - "shape":"Identity", - "documentation":"

Identity of the worker making the request, recorded in the ActivityTaskStarted event in the workflow history. This enables diagnostic tracing when problems arise. The form of this identity is user defined.

" - } - } - }, - "PollForDecisionTaskInput":{ - "type":"structure", - "required":[ - "domain", - "taskList" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the task lists to poll.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

Specifies the task list to poll for decision tasks.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "identity":{ - "shape":"Identity", - "documentation":"

Identity of the decider making the request, which is recorded in the DecisionTaskStarted event in the workflow history. This enables diagnostic tracing when problems arise. The form of this identity is user defined.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

The nextPageToken returned by this action cannot be used with GetWorkflowExecutionHistory to get the next page. You must call PollForDecisionTask again (with the nextPageToken) to retrieve the next page of history records. Calling PollForDecisionTask with a nextPageToken doesn't return a new decision task.

" - }, - "maximumPageSize":{ - "shape":"PageSize", - "documentation":"

The maximum number of results that are returned per call. nextPageToken can be used to obtain futher pages of results. The default is 1000, which is the maximum allowed page size. You can, however, specify a page size smaller than the maximum.

This is an upper limit only; the actual number of results returned per call may be fewer than the specified maximum.

" - }, - "reverseOrder":{ - "shape":"ReverseOrder", - "documentation":"

When set to true, returns the events in reverse order. By default the results are returned in ascending order of the eventTimestamp of the events.

" - } - } - }, - "RecordActivityTaskHeartbeatInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The taskToken of the ActivityTask.

taskToken is generated by the service and should be treated as an opaque value. If the task is passed to another process, its taskToken must also be passed. This enables it to provide its progress and respond with results.

" - }, - "details":{ - "shape":"LimitedData", - "documentation":"

If specified, contains details about the progress of the task.

" - } - } - }, - "RecordMarkerDecisionAttributes":{ - "type":"structure", - "required":["markerName"], - "members":{ - "markerName":{ - "shape":"MarkerName", - "documentation":"

The name of the marker.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the marker.

" - } - }, - "documentation":"

Provides the details of the RecordMarker decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RecordMarkerFailedCause":{ - "type":"string", - "enum":["OPERATION_NOT_PERMITTED"] - }, - "RecordMarkerFailedEventAttributes":{ - "type":"structure", - "required":[ - "markerName", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "markerName":{ - "shape":"MarkerName", - "documentation":"

The marker's name.

" - }, - "cause":{ - "shape":"RecordMarkerFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RecordMarkerFailed decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the RecordMarkerFailed event.

" - }, - "RegisterActivityTypeInput":{ - "type":"structure", - "required":[ - "domain", - "name", - "version" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which this activity is to be registered.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the activity type within the domain.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the activity type.

The activity type consists of the name and version, the combination of which must be unique within the domain.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A textual description of the activity type.

" - }, - "defaultTaskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum duration that a worker can take to process tasks of this activity type. This default can be overridden when scheduling an activity task using the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskHeartbeatTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum time before which a worker processing a task of this type must report progress by calling RecordActivityTaskHeartbeat. If the timeout is exceeded, the activity task is automatically timed out. This default can be overridden when scheduling an activity task using the ScheduleActivityTask Decision. If the activity worker subsequently attempts to record a heartbeat or returns a result, the activity worker receives an UnknownResource fault. In this case, Amazon SWF no longer considers the activity task to be valid; the activity worker should clean up the activity task.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskList":{ - "shape":"TaskList", - "documentation":"

If set, specifies the default task list to use for scheduling tasks of this activity type. This default task list is used if a task list isn't provided when a task is scheduled through the ScheduleActivityTask Decision.

" - }, - "defaultTaskPriority":{ - "shape":"TaskPriority", - "documentation":"

The default task priority to assign to the activity type. If not assigned, then 0 is used. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the in the Amazon SWF Developer Guide..

" - }, - "defaultTaskScheduleToStartTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum duration that a task of this activity type can wait before being assigned to a worker. This default can be overridden when scheduling an activity task using the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskScheduleToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum duration for a task of this activity type. This default can be overridden when scheduling an activity task using the ScheduleActivityTask Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - } - } - }, - "RegisterDomainInput":{ - "type":"structure", - "required":[ - "name", - "workflowExecutionRetentionPeriodInDays" - ], - "members":{ - "name":{ - "shape":"DomainName", - "documentation":"

Name of the domain to register. The name must be unique in the region that the domain is registered in.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "description":{ - "shape":"Description", - "documentation":"

A text description of the domain.

" - }, - "workflowExecutionRetentionPeriodInDays":{ - "shape":"DurationInDays", - "documentation":"

The duration (in days) that records and histories of workflow executions on the domain should be kept by the service. After the retention period, the workflow execution isn't available in the results of visibility calls.

If you pass the value NONE or 0 (zero), then the workflow execution history isn't retained. As soon as the workflow execution completes, the execution record and its history are deleted.

The maximum workflow execution retention period is 90 days. For more information about Amazon SWF service limits, see: Amazon SWF Service Limits in the Amazon SWF Developer Guide.

" - } - } - }, - "RegisterWorkflowTypeInput":{ - "type":"structure", - "required":[ - "domain", - "name", - "version" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which to register the workflow type.

" - }, - "name":{ - "shape":"Name", - "documentation":"

The name of the workflow type.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the workflow type.

The workflow type consists of the name and version, the combination of which must be unique within the domain. To get a list of all currently registered workflow types, use the ListWorkflowTypes action.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "description":{ - "shape":"Description", - "documentation":"

Textual description of the workflow type.

" - }, - "defaultTaskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum duration of decision tasks for this workflow type. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultExecutionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the default maximum duration for executions of this workflow type. You can override this default when starting an execution through the StartWorkflowExecution Action or StartChildWorkflowExecution Decision.

The duration is specified in seconds; an integer greater than or equal to 0. Unlike some of the other timeout parameters in Amazon SWF, you cannot specify a value of \"NONE\" for defaultExecutionStartToCloseTimeout; there is a one-year max limit on the time that a workflow execution can run. Exceeding this limit always causes the workflow execution to time out.

" - }, - "defaultTaskList":{ - "shape":"TaskList", - "documentation":"

If set, specifies the default task list to use for scheduling decision tasks for executions of this workflow type. This default is used only if a task list isn't provided when starting the execution through the StartWorkflowExecution Action or StartChildWorkflowExecution Decision.

" - }, - "defaultTaskPriority":{ - "shape":"TaskPriority", - "documentation":"

The default task priority to assign to the workflow type. If not assigned, then 0 is used. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "defaultChildPolicy":{ - "shape":"ChildPolicy", - "documentation":"

If set, specifies the default policy to use for the child workflow executions when a workflow execution of this type is terminated, by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "defaultLambdaRole":{ - "shape":"Arn", - "documentation":"

The default IAM role attached to this workflow type.

Executions of this workflow type need IAM roles to invoke Lambda functions. If you don't specify an IAM role when you start this workflow type, the default Lambda role is attached to the execution. For more information, see http://docs.aws.amazon.com/amazonswf/latest/developerguide/lambda-task.html in the Amazon SWF Developer Guide.

" - } - } - }, - "RegistrationStatus":{ - "type":"string", - "enum":[ - "REGISTERED", - "DEPRECATED" - ] - }, - "RequestCancelActivityTaskDecisionAttributes":{ - "type":"structure", - "required":["activityId"], - "members":{ - "activityId":{ - "shape":"ActivityId", - "documentation":"

The activityId of the activity task to be canceled.

" - } - }, - "documentation":"

Provides the details of the RequestCancelActivityTask decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RequestCancelActivityTaskFailedCause":{ - "type":"string", - "enum":[ - "ACTIVITY_ID_UNKNOWN", - "OPERATION_NOT_PERMITTED" - ] - }, - "RequestCancelActivityTaskFailedEventAttributes":{ - "type":"structure", - "required":[ - "activityId", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "activityId":{ - "shape":"ActivityId", - "documentation":"

The activityId provided in the RequestCancelActivityTask decision that failed.

" - }, - "cause":{ - "shape":"RequestCancelActivityTaskFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RequestCancelActivityTask decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the RequestCancelActivityTaskFailed event.

" - }, - "RequestCancelExternalWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "required":["workflowId"], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the external workflow execution to cancel.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the external workflow execution to cancel.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that can be used by the decider in subsequent workflow tasks.

" - } - }, - "documentation":"

Provides the details of the RequestCancelExternalWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "RequestCancelExternalWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNKNOWN_EXTERNAL_WORKFLOW_EXECUTION", - "REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED", - "OPERATION_NOT_PERMITTED" - ] - }, - "RequestCancelExternalWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "cause", - "initiatedEventId", - "decisionTaskCompletedEventId" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the external workflow to which the cancel request was to be delivered.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the external workflow execution.

" - }, - "cause":{ - "shape":"RequestCancelExternalWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the RequestCancelExternalWorkflowExecutionInitiated event corresponding to the RequestCancelExternalWorkflowExecution decision to cancel this external workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RequestCancelExternalWorkflowExecution decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the workflow execution.

" - } - }, - "documentation":"

Provides the details of the RequestCancelExternalWorkflowExecutionFailed event.

" - }, - "RequestCancelExternalWorkflowExecutionInitiatedEventAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "decisionTaskCompletedEventId" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the external workflow execution to be canceled.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the external workflow execution to be canceled.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the RequestCancelExternalWorkflowExecution decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent workflow tasks.

" - } - }, - "documentation":"

Provides the details of the RequestCancelExternalWorkflowExecutionInitiated event.

" - }, - "RequestCancelWorkflowExecutionInput":{ - "type":"structure", - "required":[ - "domain", - "workflowId" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow execution to cancel.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the workflow execution to cancel.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the workflow execution to cancel.

" - } - } - }, - "RespondActivityTaskCanceledInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The taskToken of the ActivityTask.

taskToken is generated by the service and should be treated as an opaque value. If the task is passed to another process, its taskToken must also be passed. This enables it to provide its progress and respond with results.

" - }, - "details":{ - "shape":"Data", - "documentation":"

Information about the cancellation.

" - } - } - }, - "RespondActivityTaskCompletedInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The taskToken of the ActivityTask.

taskToken is generated by the service and should be treated as an opaque value. If the task is passed to another process, its taskToken must also be passed. This enables it to provide its progress and respond with results.

" - }, - "result":{ - "shape":"Data", - "documentation":"

The result of the activity task. It is a free form string that is implementation specific.

" - } - } - }, - "RespondActivityTaskFailedInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The taskToken of the ActivityTask.

taskToken is generated by the service and should be treated as an opaque value. If the task is passed to another process, its taskToken must also be passed. This enables it to provide its progress and respond with results.

" - }, - "reason":{ - "shape":"FailureReason", - "documentation":"

Description of the error that may assist in diagnostics.

" - }, - "details":{ - "shape":"Data", - "documentation":"

Detailed information about the failure.

" - } - } - }, - "RespondDecisionTaskCompletedInput":{ - "type":"structure", - "required":["taskToken"], - "members":{ - "taskToken":{ - "shape":"TaskToken", - "documentation":"

The taskToken from the DecisionTask.

taskToken is generated by the service and should be treated as an opaque value. If the task is passed to another process, its taskToken must also be passed. This enables it to provide its progress and respond with results.

" - }, - "decisions":{ - "shape":"DecisionList", - "documentation":"

The list of decisions (possibly empty) made by the decider while processing this decision task. See the docs for the Decision structure for details.

" - }, - "executionContext":{ - "shape":"Data", - "documentation":"

User defined context to add to workflow execution.

" - } - }, - "documentation":"

Input data for a TaskCompleted response to a decision task.

" - }, - "ReverseOrder":{"type":"boolean"}, - "Run":{ - "type":"structure", - "members":{ - "runId":{ - "shape":"WorkflowRunId", - "documentation":"

The runId of a workflow execution. This ID is generated by the service and can be used to uniquely identify the workflow execution within a domain.

" - } - }, - "documentation":"

Specifies the runId of a workflow execution.

" - }, - "ScheduleActivityTaskDecisionAttributes":{ - "type":"structure", - "required":[ - "activityType", - "activityId" - ], - "members":{ - "activityType":{ - "shape":"ActivityType", - "documentation":"

The type of the activity task to schedule.

" - }, - "activityId":{ - "shape":"ActivityId", - "documentation":"

The activityId of the activity task.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent workflow tasks. This data isn't sent to the activity.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input provided to the activity task.

" - }, - "scheduleToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration for this activity task.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A schedule-to-close timeout for this activity task must be specified either as a default for the activity type or through this field. If neither this field is set nor a default schedule-to-close timeout was specified at registration time then a fault is returned.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

If set, specifies the name of the task list in which to schedule the activity task. If not specified, the defaultTaskList registered with the activity type is used.

A task list for this activity task must be specified either as a default for the activity type or through this field. If neither this field is set nor a default task list was specified at registration time then a fault is returned.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

If set, specifies the priority with which the activity task is to be assigned to a worker. This overrides the defaultTaskPriority specified when registering the activity type using RegisterActivityType. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "scheduleToStartTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the maximum duration the activity task can wait to be assigned to a worker. This overrides the default schedule-to-start timeout specified when registering the activity type using RegisterActivityType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A schedule-to-start timeout for this activity task must be specified either as a default for the activity type or through this field. If neither this field is set nor a default schedule-to-start timeout was specified at registration time then a fault is returned.

" - }, - "startToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the maximum duration a worker may take to process this activity task. This overrides the default start-to-close timeout specified when registering the activity type using RegisterActivityType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A start-to-close timeout for this activity task must be specified either as a default for the activity type or through this field. If neither this field is set nor a default start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "heartbeatTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

If set, specifies the maximum time before which a worker processing a task of this type must report progress by calling RecordActivityTaskHeartbeat. If the timeout is exceeded, the activity task is automatically timed out. If the worker subsequently attempts to record a heartbeat or returns a result, it is ignored. This overrides the default heartbeat timeout specified when registering the activity type using RegisterActivityType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - } - }, - "documentation":"

Provides the details of the ScheduleActivityTask decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • activityType.name – String constraint. The key is swf:activityType.name.

    • activityType.version – String constraint. The key is swf:activityType.version.

    • taskList – String constraint. The key is swf:taskList.name.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "ScheduleActivityTaskFailedCause":{ - "type":"string", - "enum":[ - "ACTIVITY_TYPE_DEPRECATED", - "ACTIVITY_TYPE_DOES_NOT_EXIST", - "ACTIVITY_ID_ALREADY_IN_USE", - "OPEN_ACTIVITIES_LIMIT_EXCEEDED", - "ACTIVITY_CREATION_RATE_EXCEEDED", - "DEFAULT_SCHEDULE_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_TASK_LIST_UNDEFINED", - "DEFAULT_SCHEDULE_TO_START_TIMEOUT_UNDEFINED", - "DEFAULT_START_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_HEARTBEAT_TIMEOUT_UNDEFINED", - "OPERATION_NOT_PERMITTED" - ] - }, - "ScheduleActivityTaskFailedEventAttributes":{ - "type":"structure", - "required":[ - "activityType", - "activityId", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "activityType":{ - "shape":"ActivityType", - "documentation":"

The activity type provided in the ScheduleActivityTask decision that failed.

" - }, - "activityId":{ - "shape":"ActivityId", - "documentation":"

The activityId provided in the ScheduleActivityTask decision that failed.

" - }, - "cause":{ - "shape":"ScheduleActivityTaskFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision that resulted in the scheduling of this activity task. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ScheduleActivityTaskFailed event.

" - }, - "ScheduleLambdaFunctionDecisionAttributes":{ - "type":"structure", - "required":[ - "id", - "name" - ], - "members":{ - "id":{ - "shape":"FunctionId", - "documentation":"

A string that identifies the Lambda function execution in the event history.

" - }, - "name":{ - "shape":"FunctionName", - "documentation":"

The name, or ARN, of the Lambda function to schedule.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the Lambda task.

" - }, - "input":{ - "shape":"FunctionInput", - "documentation":"

The optional input data to be supplied to the Lambda function.

" - }, - "startToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The timeout value, in seconds, after which the Lambda function is considered to be failed once it has started. This can be any integer from 1-300 (1s-5m). If no value is supplied, than a default value of 300s is assumed.

" - } - }, - "documentation":"

Decision attributes specified in scheduleLambdaFunctionDecisionAttributes within the list of decisions decisions passed to RespondDecisionTaskCompleted.

" - }, - "ScheduleLambdaFunctionFailedCause":{ - "type":"string", - "enum":[ - "ID_ALREADY_IN_USE", - "OPEN_LAMBDA_FUNCTIONS_LIMIT_EXCEEDED", - "LAMBDA_FUNCTION_CREATION_RATE_EXCEEDED", - "LAMBDA_SERVICE_NOT_AVAILABLE_IN_REGION" - ] - }, - "ScheduleLambdaFunctionFailedEventAttributes":{ - "type":"structure", - "required":[ - "id", - "name", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "id":{ - "shape":"FunctionId", - "documentation":"

The ID provided in the ScheduleLambdaFunction decision that failed.

" - }, - "name":{ - "shape":"FunctionName", - "documentation":"

The name of the Lambda function.

" - }, - "cause":{ - "shape":"ScheduleLambdaFunctionFailedCause", - "documentation":"

The cause of the failure. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the LambdaFunctionCompleted event corresponding to the decision that resulted in scheduling this Lambda task. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the ScheduleLambdaFunctionFailed event. It isn't set for other event types.

" - }, - "SignalExternalWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "signalName" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the workflow execution to be signaled.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the workflow execution to be signaled.

" - }, - "signalName":{ - "shape":"SignalName", - "documentation":"

The name of the signal.The target workflow execution uses the signal name and input to process the signal.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input data to be provided with the signal. The target workflow execution uses the signal name and input data to process the signal.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that can be used by the decider in subsequent decision tasks.

" - } - }, - "documentation":"

Provides the details of the SignalExternalWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "SignalExternalWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "UNKNOWN_EXTERNAL_WORKFLOW_EXECUTION", - "SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED", - "OPERATION_NOT_PERMITTED" - ] - }, - "SignalExternalWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "cause", - "initiatedEventId", - "decisionTaskCompletedEventId" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the external workflow execution that the signal was being delivered to.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the external workflow execution that the signal was being delivered to.

" - }, - "cause":{ - "shape":"SignalExternalWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the SignalExternalWorkflowExecutionInitiated event corresponding to the SignalExternalWorkflowExecution decision to request this signal. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the SignalExternalWorkflowExecution decision for this signal. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the workflow execution.

" - } - }, - "documentation":"

Provides the details of the SignalExternalWorkflowExecutionFailed event.

" - }, - "SignalExternalWorkflowExecutionInitiatedEventAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "signalName", - "decisionTaskCompletedEventId" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the external workflow execution.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the external workflow execution to send the signal to.

" - }, - "signalName":{ - "shape":"SignalName", - "documentation":"

The name of the signal.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input provided to the signal.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the SignalExternalWorkflowExecution decision for this signal. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent decision tasks.

" - } - }, - "documentation":"

Provides the details of the SignalExternalWorkflowExecutionInitiated event.

" - }, - "SignalName":{ - "type":"string", - "max":256, - "min":1 - }, - "SignalWorkflowExecutionInput":{ - "type":"structure", - "required":[ - "domain", - "workflowId", - "signalName" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain containing the workflow execution to signal.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the workflow execution to signal.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the workflow execution to signal.

" - }, - "signalName":{ - "shape":"SignalName", - "documentation":"

The name of the signal. This name must be meaningful to the target workflow.

" - }, - "input":{ - "shape":"Data", - "documentation":"

Data to attach to the WorkflowExecutionSignaled event in the target workflow execution's history.

" - } - } - }, - "StartChildWorkflowExecutionDecisionAttributes":{ - "type":"structure", - "required":[ - "workflowType", - "workflowId" - ], - "members":{ - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the workflow execution to be started.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the workflow execution.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that can be used by the decider in subsequent workflow tasks. This data isn't sent to the child workflow execution.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input to be provided to the workflow execution.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The total duration for this workflow execution. This overrides the defaultExecutionStartToCloseTimeout specified when registering the workflow type.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

An execution start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default execution start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list to be used for decision tasks of the child workflow execution.

A task list for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task list was specified at registration time then a fault is returned.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

A task priority that, if set, specifies the priority for a decision task of this workflow execution. This overrides the defaultTaskPriority specified when registering the workflow type. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

Specifies the maximum duration of decision tasks for this workflow execution. This parameter overrides the defaultTaskStartToCloseTimout specified when registering the workflow type using RegisterWorkflowType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A task start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

If set, specifies the policy to use for the child workflow executions if the workflow execution being started is terminated by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout. This policy overrides the default child policy specified when registering the workflow type using RegisterWorkflowType.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

A child policy for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default child policy was specified at registration time then a fault is returned.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags to associate with the child workflow execution. A maximum of 5 tags can be specified. You can list workflow executions with a specific tag by calling ListOpenWorkflowExecutions or ListClosedWorkflowExecutions and specifying a TagFilter.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role attached to the child workflow execution.

" - } - }, - "documentation":"

Provides the details of the StartChildWorkflowExecution decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • Constrain the following parameters by using a Condition element with the appropriate keys.

    • tagList.member.N – The key is \"swf:tagList.N\" where N is the tag number from 0 to 4, inclusive.

    • taskList – String constraint. The key is swf:taskList.name.

    • workflowType.name – String constraint. The key is swf:workflowType.name.

    • workflowType.version – String constraint. The key is swf:workflowType.version.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "StartChildWorkflowExecutionFailedCause":{ - "type":"string", - "enum":[ - "WORKFLOW_TYPE_DOES_NOT_EXIST", - "WORKFLOW_TYPE_DEPRECATED", - "OPEN_CHILDREN_LIMIT_EXCEEDED", - "OPEN_WORKFLOWS_LIMIT_EXCEEDED", - "CHILD_CREATION_RATE_EXCEEDED", - "WORKFLOW_ALREADY_RUNNING", - "DEFAULT_EXECUTION_START_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_TASK_LIST_UNDEFINED", - "DEFAULT_TASK_START_TO_CLOSE_TIMEOUT_UNDEFINED", - "DEFAULT_CHILD_POLICY_UNDEFINED", - "OPERATION_NOT_PERMITTED" - ] - }, - "StartChildWorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":[ - "workflowType", - "cause", - "workflowId", - "initiatedEventId", - "decisionTaskCompletedEventId" - ], - "members":{ - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type provided in the StartChildWorkflowExecution Decision that failed.

" - }, - "cause":{ - "shape":"StartChildWorkflowExecutionFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

When cause is set to OPERATION_NOT_PERMITTED, the decision fails because it lacks sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the child workflow execution.

" - }, - "initiatedEventId":{ - "shape":"EventId", - "documentation":"

When the cause is WORKFLOW_ALREADY_RUNNING, initiatedEventId is the ID of the StartChildWorkflowExecutionInitiated event that corresponds to the StartChildWorkflowExecution Decision to start the workflow execution. You can use this information to diagnose problems by tracing back the chain of events leading up to this event.

When the cause isn't WORKFLOW_ALREADY_RUNNING, initiatedEventId is set to 0 because the StartChildWorkflowExecutionInitiated event doesn't exist.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the StartChildWorkflowExecution Decision to request this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the child workflow execution.

" - } - }, - "documentation":"

Provides the details of the StartChildWorkflowExecutionFailed event.

" - }, - "StartChildWorkflowExecutionInitiatedEventAttributes":{ - "type":"structure", - "required":[ - "workflowId", - "workflowType", - "taskList", - "decisionTaskCompletedEventId", - "childPolicy" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the child workflow execution.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the child workflow execution.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent decision tasks. This data isn't sent to the activity.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The inputs provided to the child workflow execution.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration for the child workflow execution. If the workflow execution isn't closed within this duration, it is timed out and force-terminated.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list used for the decision tasks of the child workflow execution.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The priority assigned for the decision tasks for this workflow execution. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the StartChildWorkflowExecution Decision to request this child workflow execution. This information can be useful for diagnosing problems by tracing back the cause of events.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy to use for the child workflow executions if this execution gets terminated by explicitly calling the TerminateWorkflowExecution action or due to an expired timeout.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration allowed for the decision tasks for this workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags to associated with the child workflow execution.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role to attach to the child workflow execution.

" - } - }, - "documentation":"

Provides the details of the StartChildWorkflowExecutionInitiated event.

" - }, - "StartLambdaFunctionFailedCause":{ - "type":"string", - "enum":["ASSUME_ROLE_FAILED"] - }, - "StartLambdaFunctionFailedEventAttributes":{ - "type":"structure", - "members":{ - "scheduledEventId":{ - "shape":"EventId", - "documentation":"

The ID of the ActivityTaskScheduled event that was recorded when this activity task was scheduled. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

" - }, - "cause":{ - "shape":"StartLambdaFunctionFailedCause", - "documentation":"

The cause of the failure. To help diagnose issues, use this information to trace back the chain of events leading up to this event.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because the IAM role attached to the execution lacked sufficient permissions. For details and example IAM policies, see Lambda Tasks in the Amazon SWF Developer Guide.

" - }, - "message":{ - "shape":"CauseMessage", - "documentation":"

A description that can help diagnose the cause of the fault.

" - } - }, - "documentation":"

Provides the details of the StartLambdaFunctionFailed event. It isn't set for other event types.

" - }, - "StartTimerDecisionAttributes":{ - "type":"structure", - "required":[ - "timerId", - "startToFireTimeout" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The unique ID of the timer.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "control":{ - "shape":"Data", - "documentation":"

The data attached to the event that can be used by the decider in subsequent workflow tasks.

" - }, - "startToFireTimeout":{ - "shape":"DurationInSeconds", - "documentation":"

The duration to wait before firing the timer.

The duration is specified in seconds, an integer greater than or equal to 0.

" - } - }, - "documentation":"

Provides the details of the StartTimer decision.

Access Control

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:

  • Use a Resource element with the domain name to limit the action to only specified domains.

  • Use an Action element to allow or deny permission to call this action.

  • You cannot use an IAM policy to constrain this action's parameters.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "StartTimerFailedCause":{ - "type":"string", - "enum":[ - "TIMER_ID_ALREADY_IN_USE", - "OPEN_TIMERS_LIMIT_EXCEEDED", - "TIMER_CREATION_RATE_EXCEEDED", - "OPERATION_NOT_PERMITTED" - ] - }, - "StartTimerFailedEventAttributes":{ - "type":"structure", - "required":[ - "timerId", - "cause", - "decisionTaskCompletedEventId" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The timerId provided in the StartTimer decision that failed.

" - }, - "cause":{ - "shape":"StartTimerFailedCause", - "documentation":"

The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.

If cause is set to OPERATION_NOT_PERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the StartTimer decision for this activity task. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the StartTimerFailed event.

" - }, - "StartWorkflowExecutionInput":{ - "type":"structure", - "required":[ - "domain", - "workflowId", - "workflowType" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The name of the domain in which the workflow execution is created.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The user defined identifier associated with the workflow execution. You can use this to associate a custom identifier with the workflow execution. You may specify the same identifier if a workflow execution is logically a restart of a previous execution. You cannot have two open workflow executions with the same workflowId at the same time.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the workflow to start.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The task list to use for the decision tasks generated for this workflow execution. This overrides the defaultTaskList specified when registering the workflow type.

A task list for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task list was specified at registration time then a fault is returned.

The specified string must not start or end with whitespace. It must not contain a : (colon), / (slash), | (vertical bar), or any control characters (\\u0000-\\u001f | \\u007f-\\u009f). Also, it must not contain the literal string arn.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The task priority to use for this workflow execution. This overrides any default priority that was assigned when the workflow type was registered. If not set, then the default task priority for the workflow type is used. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The input for the workflow execution. This is a free form string which should be meaningful to the workflow you are starting. This input is made available to the new workflow execution in the WorkflowExecutionStarted history event.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The total duration for this workflow execution. This overrides the defaultExecutionStartToCloseTimeout specified when registering the workflow type.

The duration is specified in seconds; an integer greater than or equal to 0. Exceeding this limit causes the workflow execution to time out. Unlike some of the other timeout parameters in Amazon SWF, you cannot specify a value of \"NONE\" for this timeout; there is a one-year max limit on the time that a workflow execution can run.

An execution start-to-close timeout must be specified either through this parameter or as a default when the workflow type is registered. If neither this parameter nor a default execution start-to-close timeout is specified, a fault is returned.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags to associate with the workflow execution. You can specify a maximum of 5 tags. You can list workflow executions with a specific tag by calling ListOpenWorkflowExecutions or ListClosedWorkflowExecutions and specifying a TagFilter.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

Specifies the maximum duration of decision tasks for this workflow execution. This parameter overrides the defaultTaskStartToCloseTimout specified when registering the workflow type using RegisterWorkflowType.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

A task start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task start-to-close timeout was specified at registration time then a fault is returned.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

If set, specifies the policy to use for the child workflow executions of this workflow execution if it is terminated, by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout. This policy overrides the default child policy specified when registering the workflow type using RegisterWorkflowType.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

A child policy for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default child policy was specified at registration time then a fault is returned.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role to attach to this workflow execution.

Executions of this workflow type need IAM roles to invoke Lambda functions. If you don't attach an IAM role, any attempt to schedule a Lambda task fails. This results in a ScheduleLambdaFunctionFailed history event. For more information, see http://docs.aws.amazon.com/amazonswf/latest/developerguide/lambda-task.html in the Amazon SWF Developer Guide.

" - } - } - }, - "Tag":{ - "type":"string", - "max":256, - "min":0 - }, - "TagFilter":{ - "type":"structure", - "required":["tag"], - "members":{ - "tag":{ - "shape":"Tag", - "documentation":"

Specifies the tag that must be associated with the execution for it to meet the filter criteria.

" - } - }, - "documentation":"

Used to filter the workflow executions in visibility APIs based on a tag.

" - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"}, - "max":5 - }, - "TaskList":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the task list.

" - } - }, - "documentation":"

Represents a task list.

" - }, - "TaskPriority":{"type":"string"}, - "TaskToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "TerminateReason":{ - "type":"string", - "max":256 - }, - "TerminateWorkflowExecutionInput":{ - "type":"structure", - "required":[ - "domain", - "workflowId" - ], - "members":{ - "domain":{ - "shape":"DomainName", - "documentation":"

The domain of the workflow execution to terminate.

" - }, - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId of the workflow execution to terminate.

" - }, - "runId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

The runId of the workflow execution to terminate.

" - }, - "reason":{ - "shape":"TerminateReason", - "documentation":"

A descriptive reason for terminating the workflow execution.

" - }, - "details":{ - "shape":"Data", - "documentation":"

Details for terminating the workflow execution.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

If set, specifies the policy to use for the child workflow executions of the workflow execution being terminated. This policy overrides the child policy specified for the workflow execution at registration time or when starting the execution.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

A child policy for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default child policy was specified at registration time then a fault is returned.

" - } - } - }, - "TimerCanceledEventAttributes":{ - "type":"structure", - "required":[ - "timerId", - "startedEventId", - "decisionTaskCompletedEventId" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The unique ID of the timer that was canceled.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the TimerStarted event that was recorded when this timer was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CancelTimer decision to cancel this timer. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the TimerCanceled event.

" - }, - "TimerFiredEventAttributes":{ - "type":"structure", - "required":[ - "timerId", - "startedEventId" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The unique ID of the timer that fired.

" - }, - "startedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the TimerStarted event that was recorded when this timer was started. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the TimerFired event.

" - }, - "TimerId":{ - "type":"string", - "max":256, - "min":1 - }, - "TimerStartedEventAttributes":{ - "type":"structure", - "required":[ - "timerId", - "startToFireTimeout", - "decisionTaskCompletedEventId" - ], - "members":{ - "timerId":{ - "shape":"TimerId", - "documentation":"

The unique ID of the timer that was started.

" - }, - "control":{ - "shape":"Data", - "documentation":"

Data attached to the event that can be used by the decider in subsequent workflow tasks.

" - }, - "startToFireTimeout":{ - "shape":"DurationInSeconds", - "documentation":"

The duration of time after which the timer fires.

The duration is specified in seconds, an integer greater than or equal to 0.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the StartTimer decision for this activity task. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the TimerStarted event.

" - }, - "Timestamp":{"type":"timestamp"}, - "Truncated":{"type":"boolean"}, - "TypeAlreadyExistsFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned if the type already exists in the specified domain. You get this fault even if the existing type is in deprecated status. You can specify another version if the intent is to create a new distinct version of the type.

", - "exception":true - }, - "TypeDeprecatedFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned when the specified activity or workflow type was already deprecated.

", - "exception":true - }, - "UnknownResourceFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned when the named resource cannot be found with in the scope of this operation (region or domain). This could happen if the named resource was never created or is no longer available for this operation.

", - "exception":true - }, - "Version":{ - "type":"string", - "max":64, - "min":1 - }, - "VersionOptional":{ - "type":"string", - "max":64 - }, - "WorkflowExecution":{ - "type":"structure", - "required":[ - "workflowId", - "runId" - ], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The user defined identifier associated with the workflow execution.

" - }, - "runId":{ - "shape":"WorkflowRunId", - "documentation":"

A system-generated unique identifier for the workflow execution.

" - } - }, - "documentation":"

Represents a workflow execution.

" - }, - "WorkflowExecutionAlreadyStartedFault":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ErrorMessage", - "documentation":"

A description that may help with diagnosing the cause of the fault.

" - } - }, - "documentation":"

Returned by StartWorkflowExecution when an open execution with the same workflowId is already running in the specified domain.

", - "exception":true - }, - "WorkflowExecutionCancelRequestedCause":{ - "type":"string", - "enum":["CHILD_POLICY_APPLIED"] - }, - "WorkflowExecutionCancelRequestedEventAttributes":{ - "type":"structure", - "members":{ - "externalWorkflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The external workflow execution for which the cancellation was requested.

" - }, - "externalInitiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the RequestCancelExternalWorkflowExecutionInitiated event corresponding to the RequestCancelExternalWorkflowExecution decision to cancel this workflow execution.The source event with this ID can be found in the history of the source workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "cause":{ - "shape":"WorkflowExecutionCancelRequestedCause", - "documentation":"

If set, indicates that the request to cancel the workflow execution was automatically generated, and specifies the cause. This happens if the parent workflow execution times out or is terminated, and the child policy is set to cancel child executions.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionCancelRequested event.

" - }, - "WorkflowExecutionCanceledEventAttributes":{ - "type":"structure", - "required":["decisionTaskCompletedEventId"], - "members":{ - "details":{ - "shape":"Data", - "documentation":"

The details of the cancellation.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CancelWorkflowExecution decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionCanceled event.

" - }, - "WorkflowExecutionCompletedEventAttributes":{ - "type":"structure", - "required":["decisionTaskCompletedEventId"], - "members":{ - "result":{ - "shape":"Data", - "documentation":"

The result produced by the workflow execution upon successful completion.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the CompleteWorkflowExecution decision to complete this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionCompleted event.

" - }, - "WorkflowExecutionConfiguration":{ - "type":"structure", - "required":[ - "taskStartToCloseTimeout", - "executionStartToCloseTimeout", - "taskList", - "childPolicy" - ], - "members":{ - "taskStartToCloseTimeout":{ - "shape":"DurationInSeconds", - "documentation":"

The maximum duration allowed for decision tasks for this workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSeconds", - "documentation":"

The total duration for this workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The task list used for the decision tasks generated for this workflow execution.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The priority assigned to decision tasks for this workflow execution. Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy to use for the child workflow executions if this workflow execution is terminated, by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role attached to the child workflow execution.

" - } - }, - "documentation":"

The configuration settings for a workflow execution including timeout values, tasklist etc. These configuration settings are determined from the defaults specified when registering the workflow type and those specified when starting the workflow execution.

" - }, - "WorkflowExecutionContinuedAsNewEventAttributes":{ - "type":"structure", - "required":[ - "decisionTaskCompletedEventId", - "newExecutionRunId", - "taskList", - "childPolicy", - "workflowType" - ], - "members":{ - "input":{ - "shape":"Data", - "documentation":"

The input provided to the new workflow execution.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the ContinueAsNewWorkflowExecution decision that started this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "newExecutionRunId":{ - "shape":"WorkflowRunId", - "documentation":"

The runId of the new workflow execution.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The total duration allowed for the new workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The task list to use for the decisions of the new (continued) workflow execution.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The priority of the task to use for the decisions of the new (continued) workflow execution.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration of decision tasks for the new workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy to use for the child workflow executions of the new execution if it is terminated by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags associated with the new workflow execution.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type of this execution.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role to attach to the new (continued) workflow execution.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionContinuedAsNew event.

" - }, - "WorkflowExecutionCount":{ - "type":"structure", - "required":["count"], - "members":{ - "count":{ - "shape":"Count", - "documentation":"

The number of workflow executions.

" - }, - "truncated":{ - "shape":"Truncated", - "documentation":"

If set to true, indicates that the actual count was more than the maximum supported by this API and the count returned is the truncated value.

" - } - }, - "documentation":"

Contains the count of workflow executions returned from CountOpenWorkflowExecutions or CountClosedWorkflowExecutions

" - }, - "WorkflowExecutionDetail":{ - "type":"structure", - "required":[ - "executionInfo", - "executionConfiguration", - "openCounts" - ], - "members":{ - "executionInfo":{ - "shape":"WorkflowExecutionInfo", - "documentation":"

Information about the workflow execution.

" - }, - "executionConfiguration":{ - "shape":"WorkflowExecutionConfiguration", - "documentation":"

The configuration settings for this workflow execution including timeout values, tasklist etc.

" - }, - "openCounts":{ - "shape":"WorkflowExecutionOpenCounts", - "documentation":"

The number of tasks for this workflow execution. This includes open and closed tasks of all types.

" - }, - "latestActivityTaskTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time when the last activity task was scheduled for this workflow execution. You can use this information to determine if the workflow has not made progress for an unusually long period of time and might require a corrective action.

" - }, - "latestExecutionContext":{ - "shape":"Data", - "documentation":"

The latest executionContext provided by the decider for this workflow execution. A decider can provide an executionContext (a free-form string) when closing a decision task using RespondDecisionTaskCompleted.

" - } - }, - "documentation":"

Contains details about a workflow execution.

" - }, - "WorkflowExecutionFailedEventAttributes":{ - "type":"structure", - "required":["decisionTaskCompletedEventId"], - "members":{ - "reason":{ - "shape":"FailureReason", - "documentation":"

The descriptive reason provided for the failure.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details of the failure.

" - }, - "decisionTaskCompletedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the DecisionTaskCompleted event corresponding to the decision task that resulted in the FailWorkflowExecution decision to fail this execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionFailed event.

" - }, - "WorkflowExecutionFilter":{ - "type":"structure", - "required":["workflowId"], - "members":{ - "workflowId":{ - "shape":"WorkflowId", - "documentation":"

The workflowId to pass of match the criteria of this filter.

" - } - }, - "documentation":"

Used to filter the workflow executions in visibility APIs by their workflowId.

" - }, - "WorkflowExecutionInfo":{ - "type":"structure", - "required":[ - "execution", - "workflowType", - "startTimestamp", - "executionStatus" - ], - "members":{ - "execution":{ - "shape":"WorkflowExecution", - "documentation":"

The workflow execution this information is about.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The type of the workflow execution.

" - }, - "startTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time when the execution was started.

" - }, - "closeTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time when the workflow execution was closed. Set only if the execution status is CLOSED.

" - }, - "executionStatus":{ - "shape":"ExecutionStatus", - "documentation":"

The current status of the execution.

" - }, - "closeStatus":{ - "shape":"CloseStatus", - "documentation":"

If the execution status is closed then this specifies how the execution was closed:

  • COMPLETED – the execution was successfully completed.

  • CANCELED – the execution was canceled.Cancellation allows the implementation to gracefully clean up before the execution is closed.

  • TERMINATED – the execution was force terminated.

  • FAILED – the execution failed to complete.

  • TIMED_OUT – the execution did not complete in the alloted time and was automatically timed out.

  • CONTINUED_AS_NEW – the execution is logically continued. This means the current execution was completed and a new execution was started to carry on the workflow.

" - }, - "parent":{ - "shape":"WorkflowExecution", - "documentation":"

If this workflow execution is a child of another execution then contains the workflow execution that started this execution.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags associated with the workflow execution. Tags can be used to identify and list workflow executions of interest through the visibility APIs. A workflow execution can have a maximum of 5 tags.

" - }, - "cancelRequested":{ - "shape":"Canceled", - "documentation":"

Set to true if a cancellation is requested for this workflow execution.

" - } - }, - "documentation":"

Contains information about a workflow execution.

" - }, - "WorkflowExecutionInfoList":{ - "type":"list", - "member":{"shape":"WorkflowExecutionInfo"} - }, - "WorkflowExecutionInfos":{ - "type":"structure", - "required":["executionInfos"], - "members":{ - "executionInfos":{ - "shape":"WorkflowExecutionInfoList", - "documentation":"

The list of workflow information structures.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - } - }, - "documentation":"

Contains a paginated list of information about workflow executions.

" - }, - "WorkflowExecutionOpenCounts":{ - "type":"structure", - "required":[ - "openActivityTasks", - "openDecisionTasks", - "openTimers", - "openChildWorkflowExecutions" - ], - "members":{ - "openActivityTasks":{ - "shape":"Count", - "documentation":"

The count of activity tasks whose status is OPEN.

" - }, - "openDecisionTasks":{ - "shape":"OpenDecisionTasksCount", - "documentation":"

The count of decision tasks whose status is OPEN. A workflow execution can have at most one open decision task.

" - }, - "openTimers":{ - "shape":"Count", - "documentation":"

The count of timers started by this workflow execution that have not fired yet.

" - }, - "openChildWorkflowExecutions":{ - "shape":"Count", - "documentation":"

The count of child workflow executions whose status is OPEN.

" - }, - "openLambdaFunctions":{ - "shape":"Count", - "documentation":"

The count of Lambda tasks whose status is OPEN.

" - } - }, - "documentation":"

Contains the counts of open tasks, child workflow executions and timers for a workflow execution.

" - }, - "WorkflowExecutionSignaledEventAttributes":{ - "type":"structure", - "required":["signalName"], - "members":{ - "signalName":{ - "shape":"SignalName", - "documentation":"

The name of the signal received. The decider can use the signal name and inputs to determine how to the process the signal.

" - }, - "input":{ - "shape":"Data", - "documentation":"

The inputs provided with the signal. The decider can use the signal name and inputs to determine how to process the signal.

" - }, - "externalWorkflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The workflow execution that sent the signal. This is set only of the signal was sent by another workflow execution.

" - }, - "externalInitiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the SignalExternalWorkflowExecutionInitiated event corresponding to the SignalExternalWorkflow decision to signal this workflow execution.The source event with this ID can be found in the history of the source workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event. This field is set only if the signal was initiated by another workflow execution.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionSignaled event.

" - }, - "WorkflowExecutionStartedEventAttributes":{ - "type":"structure", - "required":[ - "childPolicy", - "taskList", - "workflowType" - ], - "members":{ - "input":{ - "shape":"Data", - "documentation":"

The input provided to the workflow execution.

" - }, - "executionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration for this workflow execution.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "taskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The maximum duration of decision tasks for this workflow type.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy to use for the child workflow executions if this workflow execution is terminated, by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "taskList":{ - "shape":"TaskList", - "documentation":"

The name of the task list for scheduling the decision tasks for this workflow execution.

" - }, - "taskPriority":{ - "shape":"TaskPriority", - "documentation":"

The priority of the decision tasks in the workflow execution.

" - }, - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type of this execution.

" - }, - "tagList":{ - "shape":"TagList", - "documentation":"

The list of tags associated with this workflow execution. An execution can have up to 5 tags.

" - }, - "continuedExecutionRunId":{ - "shape":"WorkflowRunIdOptional", - "documentation":"

If this workflow execution was started due to a ContinueAsNewWorkflowExecution decision, then it contains the runId of the previous workflow execution that was closed and continued as this execution.

" - }, - "parentWorkflowExecution":{ - "shape":"WorkflowExecution", - "documentation":"

The source workflow execution that started this workflow execution. The member isn't set if the workflow execution was not started by a workflow.

" - }, - "parentInitiatedEventId":{ - "shape":"EventId", - "documentation":"

The ID of the StartChildWorkflowExecutionInitiated event corresponding to the StartChildWorkflowExecution Decision to start this workflow execution. The source event with this ID can be found in the history of the source workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.

" - }, - "lambdaRole":{ - "shape":"Arn", - "documentation":"

The IAM role attached to the workflow execution.

" - } - }, - "documentation":"

Provides details of WorkflowExecutionStarted event.

" - }, - "WorkflowExecutionTerminatedCause":{ - "type":"string", - "enum":[ - "CHILD_POLICY_APPLIED", - "EVENT_LIMIT_EXCEEDED", - "OPERATOR_INITIATED" - ] - }, - "WorkflowExecutionTerminatedEventAttributes":{ - "type":"structure", - "required":["childPolicy"], - "members":{ - "reason":{ - "shape":"TerminateReason", - "documentation":"

The reason provided for the termination.

" - }, - "details":{ - "shape":"Data", - "documentation":"

The details provided for the termination.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy used for the child workflow executions of this workflow execution.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "cause":{ - "shape":"WorkflowExecutionTerminatedCause", - "documentation":"

If set, indicates that the workflow execution was automatically terminated, and specifies the cause. This happens if the parent workflow execution times out or is terminated and the child policy is set to terminate child executions.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionTerminated event.

" - }, - "WorkflowExecutionTimedOutEventAttributes":{ - "type":"structure", - "required":[ - "timeoutType", - "childPolicy" - ], - "members":{ - "timeoutType":{ - "shape":"WorkflowExecutionTimeoutType", - "documentation":"

The type of timeout that caused this event.

" - }, - "childPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The policy used for the child workflow executions of this workflow execution.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - } - }, - "documentation":"

Provides the details of the WorkflowExecutionTimedOut event.

" - }, - "WorkflowExecutionTimeoutType":{ - "type":"string", - "enum":["START_TO_CLOSE"] - }, - "WorkflowId":{ - "type":"string", - "max":256, - "min":1 - }, - "WorkflowRunId":{ - "type":"string", - "max":64, - "min":1 - }, - "WorkflowRunIdOptional":{ - "type":"string", - "max":64 - }, - "WorkflowType":{ - "type":"structure", - "required":[ - "name", - "version" - ], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

The name of the workflow type.

The combination of workflow type name and version must be unique with in a domain.

" - }, - "version":{ - "shape":"Version", - "documentation":"

The version of the workflow type.

The combination of workflow type name and version must be unique with in a domain.

" - } - }, - "documentation":"

Represents a workflow type.

" - }, - "WorkflowTypeConfiguration":{ - "type":"structure", - "members":{ - "defaultTaskStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum duration, specified when registering the workflow type, that a decision task for executions of this workflow type might take before returning completion or failure. If the task doesn'tdo close in the specified time then the task is automatically timed out and rescheduled. If the decider eventually reports a completion or failure, it is ignored. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultExecutionStartToCloseTimeout":{ - "shape":"DurationInSecondsOptional", - "documentation":"

The default maximum duration, specified when registering the workflow type, for executions of this workflow type. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

The duration is specified in seconds, an integer greater than or equal to 0. You can use NONE to specify unlimited duration.

" - }, - "defaultTaskList":{ - "shape":"TaskList", - "documentation":"

The default task list, specified when registering the workflow type, for decisions tasks scheduled for workflow executions of this type. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

" - }, - "defaultTaskPriority":{ - "shape":"TaskPriority", - "documentation":"

The default task priority, specified when registering the workflow type, for all decision tasks of this workflow type. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution decision.

Valid values are integers that range from Java's Integer.MIN_VALUE (-2147483648) to Integer.MAX_VALUE (2147483647). Higher numbers indicate higher priority.

For more information about setting task priority, see Setting Task Priority in the Amazon SWF Developer Guide.

" - }, - "defaultChildPolicy":{ - "shape":"ChildPolicy", - "documentation":"

The default policy to use for the child workflow executions when a workflow execution of this type is terminated, by calling the TerminateWorkflowExecution action explicitly or due to an expired timeout. This default can be overridden when starting a workflow execution using the StartWorkflowExecution action or the StartChildWorkflowExecution Decision.

The supported child policies are:

  • TERMINATE – The child executions are terminated.

  • REQUEST_CANCEL – A request to cancel is attempted for each child execution by recording a WorkflowExecutionCancelRequested event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.

  • ABANDON – No action is taken. The child executions continue to run.

" - }, - "defaultLambdaRole":{ - "shape":"Arn", - "documentation":"

The default IAM role attached to this workflow type.

Executions of this workflow type need IAM roles to invoke Lambda functions. If you don't specify an IAM role when starting this workflow type, the default Lambda role is attached to the execution. For more information, see http://docs.aws.amazon.com/amazonswf/latest/developerguide/lambda-task.html in the Amazon SWF Developer Guide.

" - } - }, - "documentation":"

The configuration settings of a workflow type.

" - }, - "WorkflowTypeDetail":{ - "type":"structure", - "required":[ - "typeInfo", - "configuration" - ], - "members":{ - "typeInfo":{ - "shape":"WorkflowTypeInfo", - "documentation":"

General information about the workflow type.

The status of the workflow type (returned in the WorkflowTypeInfo structure) can be one of the following.

  • REGISTERED – The type is registered and available. Workers supporting this type should be running.

  • DEPRECATED – The type was deprecated using DeprecateWorkflowType, but is still in use. You should keep workers supporting this type running. You cannot create new workflow executions of this type.

" - }, - "configuration":{ - "shape":"WorkflowTypeConfiguration", - "documentation":"

Configuration settings of the workflow type registered through RegisterWorkflowType

" - } - }, - "documentation":"

Contains details about a workflow type.

" - }, - "WorkflowTypeFilter":{ - "type":"structure", - "required":["name"], - "members":{ - "name":{ - "shape":"Name", - "documentation":"

Name of the workflow type.

" - }, - "version":{ - "shape":"VersionOptional", - "documentation":"

Version of the workflow type.

" - } - }, - "documentation":"

Used to filter workflow execution query results by type. Each parameter, if specified, defines a rule that must be satisfied by each returned result.

" - }, - "WorkflowTypeInfo":{ - "type":"structure", - "required":[ - "workflowType", - "status", - "creationDate" - ], - "members":{ - "workflowType":{ - "shape":"WorkflowType", - "documentation":"

The workflow type this information is about.

" - }, - "status":{ - "shape":"RegistrationStatus", - "documentation":"

The current status of the workflow type.

" - }, - "description":{ - "shape":"Description", - "documentation":"

The description of the type registered through RegisterWorkflowType.

" - }, - "creationDate":{ - "shape":"Timestamp", - "documentation":"

The date when this type was registered.

" - }, - "deprecationDate":{ - "shape":"Timestamp", - "documentation":"

If the type is in deprecated state, then it is set to the date when the type was deprecated.

" - } - }, - "documentation":"

Contains information about a workflow type.

" - }, - "WorkflowTypeInfoList":{ - "type":"list", - "member":{"shape":"WorkflowTypeInfo"} - }, - "WorkflowTypeInfos":{ - "type":"structure", - "required":["typeInfos"], - "members":{ - "typeInfos":{ - "shape":"WorkflowTypeInfoList", - "documentation":"

The list of workflow type information.

" - }, - "nextPageToken":{ - "shape":"PageToken", - "documentation":"

If a NextPageToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in nextPageToken. Keep all other arguments unchanged.

The configured maximumPageSize determines how many results can be returned in a single call.

" - } - }, - "documentation":"

Contains a paginated list of information structures about workflow types.

" - } - }, - "documentation":"Amazon Simple Workflow Service

The Amazon Simple Workflow Service (Amazon SWF) makes it easy to build applications that use Amazon's cloud to coordinate work across distributed components. In Amazon SWF, a task represents a logical unit of work that is performed by a component of your workflow. Coordinating tasks in a workflow involves managing intertask dependencies, scheduling, and concurrency in accordance with the logical flow of the application.

Amazon SWF gives you full control over implementing tasks and coordinating them without worrying about underlying complexities such as tracking their progress and maintaining their state.

This documentation serves as reference only. For a broader overview of the Amazon SWF programming model, see the Amazon SWF Developer Guide .

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/service-2.json deleted file mode 100644 index 7d7e5cc0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/transcribe/2017-10-26/service-2.json +++ /dev/null @@ -1,717 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-26", - "endpointPrefix":"transcribe", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Transcribe Service", - "serviceId":"Transcribe", - "signatureVersion":"v4", - "signingName":"transcribe", - "targetPrefix":"Transcribe", - "uid":"transcribe-2017-10-26" - }, - "operations":{ - "CreateVocabulary":{ - "name":"CreateVocabulary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateVocabularyRequest"}, - "output":{"shape":"CreateVocabularyResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file.

" - }, - "DeleteVocabulary":{ - "name":"DeleteVocabulary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteVocabularyRequest"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"BadRequestException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Deletes a vocabulary from Amazon Transcribe.

" - }, - "GetTranscriptionJob":{ - "name":"GetTranscriptionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetTranscriptionJobRequest"}, - "output":{"shape":"GetTranscriptionJobResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"NotFoundException"} - ], - "documentation":"

Returns information about a transcription job. To see the status of the job, check the TranscriptionJobStatus field. If the status is COMPLETED, the job is finished and you can find the results at the location specified in the TranscriptionFileUri field.

" - }, - "GetVocabulary":{ - "name":"GetVocabulary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetVocabularyRequest"}, - "output":{"shape":"GetVocabularyResponse"}, - "errors":[ - {"shape":"NotFoundException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"BadRequestException"} - ], - "documentation":"

Gets information about a vocabulary.

" - }, - "ListTranscriptionJobs":{ - "name":"ListTranscriptionJobs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListTranscriptionJobsRequest"}, - "output":{"shape":"ListTranscriptionJobsResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Lists transcription jobs with the specified status.

" - }, - "ListVocabularies":{ - "name":"ListVocabularies", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListVocabulariesRequest"}, - "output":{"shape":"ListVocabulariesResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"} - ], - "documentation":"

Returns a list of vocabularies that match the specified criteria. If no criteria are specified, returns the entire list of vocabularies.

" - }, - "StartTranscriptionJob":{ - "name":"StartTranscriptionJob", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartTranscriptionJobRequest"}, - "output":{"shape":"StartTranscriptionJobResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Starts an asynchronous job to transcribe speech to text.

" - }, - "UpdateVocabulary":{ - "name":"UpdateVocabulary", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateVocabularyRequest"}, - "output":{"shape":"UpdateVocabularyResponse"}, - "errors":[ - {"shape":"BadRequestException"}, - {"shape":"LimitExceededException"}, - {"shape":"InternalFailureException"}, - {"shape":"NotFoundException"}, - {"shape":"ConflictException"} - ], - "documentation":"

Updates an existing vocabulary with new values. The UpdateVocabulary operation overwrites all of the existing information with the values that you provide in the request.

" - } - }, - "shapes":{ - "BadRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"FailureReason"} - }, - "documentation":"

Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

", - "exception":true - }, - "Boolean":{"type":"boolean"}, - "ConflictException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

When you are using the StartTranscriptionJob operation, the JobName field is a duplicate of a previously entered job name. Resend your request with a different name.

When you are using the UpdateVocabulary operation, there are two jobs running at the same time. Resend the second request later.

", - "exception":true - }, - "CreateVocabularyRequest":{ - "type":"structure", - "required":[ - "VocabularyName", - "LanguageCode", - "Phrases" - ], - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary. The name must be unique within an AWS account. The name is case-sensitive.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "Phrases":{ - "shape":"Phrases", - "documentation":"

An array of strings that contains the vocabulary entries.

" - } - } - }, - "CreateVocabularyResponse":{ - "type":"structure", - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "VocabularyState":{ - "shape":"VocabularyState", - "documentation":"

The processing state of the vocabulary. When the VocabularyState field contains READY the vocabulary is ready to be used in a StartTranscriptionJob request.

" - }, - "LastModifiedTime":{ - "shape":"DateTime", - "documentation":"

The date and time that the vocabulary was created.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the VocabularyState field is FAILED, this field contains information about why the job failed.

" - } - } - }, - "DateTime":{"type":"timestamp"}, - "DeleteVocabularyRequest":{ - "type":"structure", - "required":["VocabularyName"], - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary to delete.

" - } - } - }, - "FailureReason":{"type":"string"}, - "GetTranscriptionJobRequest":{ - "type":"structure", - "required":["TranscriptionJobName"], - "members":{ - "TranscriptionJobName":{ - "shape":"TranscriptionJobName", - "documentation":"

The name of the job.

" - } - } - }, - "GetTranscriptionJobResponse":{ - "type":"structure", - "members":{ - "TranscriptionJob":{ - "shape":"TranscriptionJob", - "documentation":"

An object that contains the results of the transcription job.

" - } - } - }, - "GetVocabularyRequest":{ - "type":"structure", - "required":["VocabularyName"], - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary to return information about. The name is case-sensitive.

" - } - } - }, - "GetVocabularyResponse":{ - "type":"structure", - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary to return.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "VocabularyState":{ - "shape":"VocabularyState", - "documentation":"

The processing state of the vocabulary.

" - }, - "LastModifiedTime":{ - "shape":"DateTime", - "documentation":"

The date and time that the vocabulary was last modified.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the VocabularyState field is FAILED, this field contains information about why the job failed.

" - }, - "DownloadUri":{ - "shape":"Uri", - "documentation":"

The S3 location where the vocabulary is stored. Use this URI to get the contents of the vocabulary. The URI is available for a limited time.

" - } - } - }, - "InternalFailureException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

There was an internal error. Check the error message and try your request again.

", - "exception":true, - "fault":true - }, - "LanguageCode":{ - "type":"string", - "enum":[ - "en-US", - "es-US" - ] - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

", - "exception":true - }, - "ListTranscriptionJobsRequest":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"TranscriptionJobStatus", - "documentation":"

When specified, returns only transcription jobs with the specified status.

" - }, - "JobNameContains":{ - "shape":"TranscriptionJobName", - "documentation":"

When specified, the jobs returned in the list are limited to jobs whose name contains the specified string.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous request to ListTranscriptionJobs was truncated, include the NextToken to fetch the next set of jobs.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of jobs to return in the response. If there are fewer results in the list, this response contains only the actual results.

" - } - } - }, - "ListTranscriptionJobsResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"TranscriptionJobStatus", - "documentation":"

The requested status of the jobs returned.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The ListTranscriptionJobs operation returns a page of jobs at a time. The maximum size of the page is set by the MaxResults parameter. If there are more jobs in the list than the page size, Amazon Transcribe returns the NextPage token. Include the token in the next request to the ListTranscriptionJobs operation to return in the next page of jobs.

" - }, - "TranscriptionJobSummaries":{ - "shape":"TranscriptionJobSummaries", - "documentation":"

A list of objects containing summary information for a transcription job.

" - } - } - }, - "ListVocabulariesRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

If the result of the previous request to ListVocabularies was truncated, include the NextToken to fetch the next set of jobs.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of vocabularies to return in the response. If there are fewer results in the list, this response contains only the actual results.

" - }, - "StateEquals":{ - "shape":"VocabularyState", - "documentation":"

When specified, only returns vocabularies with the VocabularyState field equal to the specified state.

" - }, - "NameContains":{ - "shape":"VocabularyName", - "documentation":"

When specified, the vocabularies returned in the list are limited to vocabularies whose name contains the specified string. The search is case-insensitive, ListVocabularies will return both \"vocabularyname\" and \"VocabularyName\" in the response list.

" - } - } - }, - "ListVocabulariesResponse":{ - "type":"structure", - "members":{ - "Status":{ - "shape":"TranscriptionJobStatus", - "documentation":"

The requested vocabulary state.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The ListVocabularies operation returns a page of vocabularies at a time. The maximum size of the page is set by the MaxResults parameter. If there are more jobs in the list than the page size, Amazon Transcribe returns the NextPage token. Include the token in the next request to the ListVocabularies operation to return in the next page of jobs.

" - }, - "Vocabularies":{ - "shape":"Vocabularies", - "documentation":"

A list of objects that describe the vocabularies that match the search criteria in the request.

" - } - } - }, - "MaxResults":{ - "type":"integer", - "max":100, - "min":1 - }, - "MaxSpeakers":{ - "type":"integer", - "max":10, - "min":2 - }, - "Media":{ - "type":"structure", - "members":{ - "MediaFileUri":{ - "shape":"Uri", - "documentation":"

The S3 location of the input media file. The URI must be in the same region as the API endpoint that you are calling. The general form is:

https://<aws-region>.amazonaws.com/<bucket-name>/<keyprefix>/<objectkey>

For example:

https://s3-us-east-1.amazonaws.com/examplebucket/example.mp4

https://s3-us-east-1.amazonaws.com/examplebucket/mediadocs/example.mp4

For more information about S3 object names, see Object Keys in the Amazon S3 Developer Guide.

" - } - }, - "documentation":"

Describes the input media file in a transcription request.

" - }, - "MediaFormat":{ - "type":"string", - "enum":[ - "mp3", - "mp4", - "wav", - "flac" - ] - }, - "MediaSampleRateHertz":{ - "type":"integer", - "max":48000, - "min":8000 - }, - "NextToken":{ - "type":"string", - "max":8192 - }, - "NotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

We can't find the requested resource. Check the name and try your request again.

", - "exception":true - }, - "OutputBucketName":{ - "type":"string", - "pattern":"[a-z0-9][\\.\\-a-z0-9]{1,61}[a-z0-9]" - }, - "OutputLocationType":{ - "type":"string", - "enum":[ - "CUSTOMER_BUCKET", - "SERVICE_BUCKET" - ] - }, - "Phrase":{ - "type":"string", - "max":256, - "min":0 - }, - "Phrases":{ - "type":"list", - "member":{"shape":"Phrase"} - }, - "Settings":{ - "type":"structure", - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of a vocabulary to use when processing the transcription job.

" - }, - "ShowSpeakerLabels":{ - "shape":"Boolean", - "documentation":"

Determines whether the transcription job uses speaker recognition to identify different speakers in the input audio. Speaker recognition labels individual speakers in the audio file. If you set the ShowSpeakerLabels field to true, you must also set the maximum number of speaker labels MaxSpeakerLabels field.

You can't set both ShowSpeakerLabels and ChannelIdentification in the same request. If you set both, your request returns a BadRequestException.

" - }, - "MaxSpeakerLabels":{ - "shape":"MaxSpeakers", - "documentation":"

The maximum number of speakers to identify in the input audio. If there are more speakers in the audio than this number, multiple speakers will be identified as a single speaker. If you specify the MaxSpeakerLabels field, you must set the ShowSpeakerLabels field to true.

" - }, - "ChannelIdentification":{ - "shape":"Boolean", - "documentation":"

Instructs Amazon Transcribe to process each audio channel separately and then merge the transcription output of each channel into a single transcription.

Amazon Transcribe also produces a transcription of each item detected on an audio channel, including the start time and end time of the item and alternative transcriptions of the item including the confidence that Amazon Transcribe has in the transcription.

You can't set both ShowSpeakerLabels and ChannelIdentification in the same request. If you set both, your request returns a BadRequestException.

" - } - }, - "documentation":"

Provides optional settings for the StartTranscriptionJob operation.

" - }, - "StartTranscriptionJobRequest":{ - "type":"structure", - "required":[ - "TranscriptionJobName", - "LanguageCode", - "MediaFormat", - "Media" - ], - "members":{ - "TranscriptionJobName":{ - "shape":"TranscriptionJobName", - "documentation":"

The name of the job. You can't use the strings \".\" or \"..\" in the job name. The name must be unique within an AWS account.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code for the language used in the input media file.

" - }, - "MediaSampleRateHertz":{ - "shape":"MediaSampleRateHertz", - "documentation":"

The sample rate, in Hertz, of the audio track in the input media file.

" - }, - "MediaFormat":{ - "shape":"MediaFormat", - "documentation":"

The format of the input media file.

" - }, - "Media":{ - "shape":"Media", - "documentation":"

An object that describes the input media for a transcription job.

" - }, - "OutputBucketName":{ - "shape":"OutputBucketName", - "documentation":"

The location where the transcription is stored.

If you set the OutputBucketName, Amazon Transcribe puts the transcription in the specified S3 bucket. When you call the GetTranscriptionJob operation, the operation returns this location in the TranscriptFileUri field. The S3 bucket must have permissions that allow Amazon Transcribe to put files in the bucket. For more information, see Permissions Required for IAM User Roles.

If you don't set the OutputBucketName, Amazon Transcribe generates a pre-signed URL, a shareable URL that provides secure access to your transcription, and returns it in the TranscriptFileUri field. Use this URL to download the transcription.

" - }, - "Settings":{ - "shape":"Settings", - "documentation":"

A Settings object that provides optional settings for a transcription job.

" - } - } - }, - "StartTranscriptionJobResponse":{ - "type":"structure", - "members":{ - "TranscriptionJob":{ - "shape":"TranscriptionJob", - "documentation":"

An object containing details of the asynchronous transcription job.

" - } - } - }, - "String":{"type":"string"}, - "Transcript":{ - "type":"structure", - "members":{ - "TranscriptFileUri":{ - "shape":"Uri", - "documentation":"

The location where the transcription is stored.

Use this URI to access the transcription. If you specified an S3 bucket in the OutputBucketName field when you created the job, this is the URI of that bucket. If you chose to store the transcription in Amazon Transcribe, this is a shareable URL that provides secure access to that location.

" - } - }, - "documentation":"

Identifies the location of a transcription.

" - }, - "TranscriptionJob":{ - "type":"structure", - "members":{ - "TranscriptionJobName":{ - "shape":"TranscriptionJobName", - "documentation":"

The name of the transcription job.

" - }, - "TranscriptionJobStatus":{ - "shape":"TranscriptionJobStatus", - "documentation":"

The status of the transcription job.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code for the input speech.

" - }, - "MediaSampleRateHertz":{ - "shape":"MediaSampleRateHertz", - "documentation":"

The sample rate, in Hertz, of the audio track in the input media file.

" - }, - "MediaFormat":{ - "shape":"MediaFormat", - "documentation":"

The format of the input media file.

" - }, - "Media":{ - "shape":"Media", - "documentation":"

An object that describes the input media for the transcription job.

" - }, - "Transcript":{ - "shape":"Transcript", - "documentation":"

An object that describes the output of the transcription job.

" - }, - "CreationTime":{ - "shape":"DateTime", - "documentation":"

A timestamp that shows when the job was created.

" - }, - "CompletionTime":{ - "shape":"DateTime", - "documentation":"

A timestamp that shows when the job was completed.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the TranscriptionJobStatus field is FAILED, this field contains information about why the job failed.

" - }, - "Settings":{ - "shape":"Settings", - "documentation":"

Optional settings for the transcription job. Use these settings to turn on speaker recognition, to set the maximum number of speakers that should be identified and to specify a custom vocabulary to use when processing the transcription job.

" - } - }, - "documentation":"

Describes an asynchronous transcription job that was created with the StartTranscriptionJob operation.

" - }, - "TranscriptionJobName":{ - "type":"string", - "max":200, - "min":1, - "pattern":"^[0-9a-zA-Z._-]+" - }, - "TranscriptionJobStatus":{ - "type":"string", - "enum":[ - "IN_PROGRESS", - "FAILED", - "COMPLETED" - ] - }, - "TranscriptionJobSummaries":{ - "type":"list", - "member":{"shape":"TranscriptionJobSummary"} - }, - "TranscriptionJobSummary":{ - "type":"structure", - "members":{ - "TranscriptionJobName":{ - "shape":"TranscriptionJobName", - "documentation":"

The name of the transcription job.

" - }, - "CreationTime":{ - "shape":"DateTime", - "documentation":"

A timestamp that shows when the job was created.

" - }, - "CompletionTime":{ - "shape":"DateTime", - "documentation":"

A timestamp that shows when the job was completed.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code for the input speech.

" - }, - "TranscriptionJobStatus":{ - "shape":"TranscriptionJobStatus", - "documentation":"

The status of the transcription job. When the status is COMPLETED, use the GetTranscriptionJob operation to get the results of the transcription.

" - }, - "FailureReason":{ - "shape":"FailureReason", - "documentation":"

If the TranscriptionJobStatus field is FAILED, a description of the error.

" - }, - "OutputLocationType":{ - "shape":"OutputLocationType", - "documentation":"

Indicates the location of the output of the transcription job.

If the value is CUSTOMER_BUCKET then the location is the S3 bucket specified in the outputBucketName field when the transcription job was started with the StartTranscriptionJob operation.

If the value is SERVICE_BUCKET then the output is stored by Amazon Transcribe and can be retrieved using the URI in the GetTranscriptionJob response's TranscriptFileUri field.

" - } - }, - "documentation":"

Provides a summary of information about a transcription job.

" - }, - "UpdateVocabularyRequest":{ - "type":"structure", - "required":[ - "VocabularyName", - "LanguageCode", - "Phrases" - ], - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary to update. The name is case-sensitive.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "Phrases":{ - "shape":"Phrases", - "documentation":"

An array of strings containing the vocabulary entries.

" - } - } - }, - "UpdateVocabularyResponse":{ - "type":"structure", - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary that was updated.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "LastModifiedTime":{ - "shape":"DateTime", - "documentation":"

The date and time that the vocabulary was updated.

" - }, - "VocabularyState":{ - "shape":"VocabularyState", - "documentation":"

The processing state of the vocabulary. When the VocabularyState field contains READY the vocabulary is ready to be used in a StartTranscriptionJob request.

" - } - } - }, - "Uri":{ - "type":"string", - "max":2000, - "min":1 - }, - "Vocabularies":{ - "type":"list", - "member":{"shape":"VocabularyInfo"} - }, - "VocabularyInfo":{ - "type":"structure", - "members":{ - "VocabularyName":{ - "shape":"VocabularyName", - "documentation":"

The name of the vocabulary.

" - }, - "LanguageCode":{ - "shape":"LanguageCode", - "documentation":"

The language code of the vocabulary entries.

" - }, - "LastModifiedTime":{ - "shape":"DateTime", - "documentation":"

The date and time that the vocabulary was last modified.

" - }, - "VocabularyState":{ - "shape":"VocabularyState", - "documentation":"

The processing state of the vocabulary. If the state is READY you can use the vocabulary in a StartTranscriptionJob request.

" - } - }, - "documentation":"

Provides information about a custom vocabulary.

" - }, - "VocabularyName":{ - "type":"string", - "max":200, - "min":1, - "pattern":"^[0-9a-zA-Z._-]+" - }, - "VocabularyState":{ - "type":"string", - "enum":[ - "PENDING", - "READY", - "FAILED" - ] - } - }, - "documentation":"

Operations and objects for transcribing speech to text.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/service-2.json deleted file mode 100644 index 95de9aaf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/translate/2017-07-01/service-2.json +++ /dev/null @@ -1,158 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-07-01", - "endpointPrefix":"translate", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon Translate", - "serviceId":"Translate", - "signatureVersion":"v4", - "signingName":"translate", - "targetPrefix":"AWSShineFrontendService_20170701", - "uid":"translate-2017-07-01" - }, - "operations":{ - "TranslateText":{ - "name":"TranslateText", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TranslateTextRequest"}, - "output":{"shape":"TranslateTextResponse"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"TextSizeLimitExceededException"}, - {"shape":"TooManyRequestsException"}, - {"shape":"UnsupportedLanguagePairException"}, - {"shape":"DetectedLanguageLowConfidenceException"}, - {"shape":"InternalServerException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Translates input text from the source language to the target language. You can translate between English (en) and one of the following languages, or between one of the following languages and English.

  • Arabic (ar)

  • Chinese (Simplified) (zh)

  • French (fr)

  • German (de)

  • Portuguese (pt)

  • Spanish (es)

To have Amazon Translate determine the source language of your text, you can specify auto in the SourceLanguageCode field. If you specify auto, Amazon Translate will call Amazon Comprehend to determine the source language.

" - } - }, - "shapes":{ - "BoundedLengthString":{ - "type":"string", - "max":5000, - "min":1 - }, - "DetectedLanguageLowConfidenceException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"}, - "DetectedLanguageCode":{ - "shape":"LanguageCodeString", - "documentation":"

Auto detected language code from Comprehend.

" - } - }, - "documentation":"

The confidence that Amazon Comprehend accurately detected the source language is low. If a low confidence level is acceptable for your application, you can use the language in the exception to call Amazon Translate again. For more information, see the DetectDominantLanguage operation in the Amazon Comprehend Developer Guide.

", - "exception":true - }, - "InternalServerException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An internal server error occurred. Retry your request.

", - "exception":true, - "fault":true - }, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The request is invalid.

", - "exception":true - }, - "LanguageCodeString":{ - "type":"string", - "max":5, - "min":2 - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Amazon Translate is unavailable. Retry your request later.

", - "exception":true - }, - "String":{ - "type":"string", - "min":1 - }, - "TextSizeLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The size of the input text exceeds the length constraint for the Text field. Try again with a shorter text.

", - "exception":true - }, - "TooManyRequestsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The number of requests exceeds the limit. Resubmit your request later.

", - "exception":true - }, - "TranslateTextRequest":{ - "type":"structure", - "required":[ - "Text", - "SourceLanguageCode", - "TargetLanguageCode" - ], - "members":{ - "Text":{ - "shape":"BoundedLengthString", - "documentation":"

The text to translate.

" - }, - "SourceLanguageCode":{ - "shape":"LanguageCodeString", - "documentation":"

One of the supported language codes for the source text. If the TargetLanguageCode is not \"en\", the SourceLanguageCode must be \"en\".

To have Amazon Translate determine the source language of your text, you can specify auto in the SourceLanguageCode field. If you specify auto, Amazon Translate will call Amazon Comprehend to determine the source language.

" - }, - "TargetLanguageCode":{ - "shape":"LanguageCodeString", - "documentation":"

One of the supported language codes for the target text. If the SourceLanguageCode is not \"en\", the TargetLanguageCode must be \"en\".

" - } - } - }, - "TranslateTextResponse":{ - "type":"structure", - "required":[ - "TranslatedText", - "SourceLanguageCode", - "TargetLanguageCode" - ], - "members":{ - "TranslatedText":{ - "shape":"String", - "documentation":"

The text translated into the target language.

" - }, - "SourceLanguageCode":{ - "shape":"LanguageCodeString", - "documentation":"

The language code for the language of the input text.

" - }, - "TargetLanguageCode":{ - "shape":"LanguageCodeString", - "documentation":"

The language code for the language of the translated text.

" - } - } - }, - "UnsupportedLanguagePairException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

Amazon Translate cannot translate input text in the source language into this target language. For more information, see how-to-error-msg.

", - "exception":true - } - }, - "documentation":"

Provides translation between English and one of six languages, or between one of the six languages and English.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/examples-1.json deleted file mode 100644 index eee5b6f4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/examples-1.json +++ /dev/null @@ -1,1017 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MyIPSetFriendlyName" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSet": { - "IPSetDescriptors": [ - { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - ], - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Name": "MyIPSetFriendlyName" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates an IP match set named MyIPSetFriendlyName.", - "id": "createipset-1472501003122", - "title": "To create an IP set" - } - ], - "CreateRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Rule": { - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule", - "Predicates": [ - { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - ], - "RuleId": "WAFRule-1-Example" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a rule named WAFByteHeaderRule.", - "id": "createrule-1474072675555", - "title": "To create a rule" - } - ], - "CreateSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySampleSizeConstraintSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSet": { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SizeConstraints": [ - { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates size constraint set named MySampleSizeConstraintSet.", - "id": "createsizeconstraint-1474299140754", - "title": "To create a size constraint" - } - ], - "CreateSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySQLInjectionMatchSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSet": { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SqlInjectionMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a SQL injection match set named MySQLInjectionMatchSet.", - "id": "createsqlinjectionmatchset-1474492796105", - "title": "To create a SQL injection match set" - } - ], - "CreateWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "WebACL": { - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample", - "Rules": [ - { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - ], - "WebACLId": "example-46da-4444-5555-example" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a web ACL named CreateExample.", - "id": "createwebacl-1472061481310", - "title": "To create a web ACL" - } - ], - "CreateXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySampleXssMatchSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "XssMatchSet": { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "XssMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates an XSS match set named MySampleXssMatchSet.", - "id": "createxssmatchset-1474560868500", - "title": "To create an XSS match set" - } - ], - "DeleteByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletebytematchset-1473367566229", - "title": "To delete a byte match set" - } - ], - "DeleteIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deleteipset-1472767434306", - "title": "To delete an IP set" - } - ], - "DeleteRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "RuleId": "WAFRule-1-Example" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a rule with the ID WAFRule-1-Example.", - "id": "deleterule-1474073108749", - "title": "To delete a rule" - } - ], - "DeleteSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a size constraint set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletesizeconstraintset-1474299857905", - "title": "To delete a size constraint set" - } - ], - "DeleteSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletesqlinjectionmatchset-1474493373197", - "title": "To delete a SQL injection match set" - } - ], - "DeleteWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "WebACLId": "example-46da-4444-5555-example" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a web ACL with the ID example-46da-4444-5555-example.", - "id": "deletewebacl-1472767755931", - "title": "To delete a web ACL" - } - ], - "DeleteXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletexssmatchset-1474561302618", - "title": "To delete an XSS match set" - } - ], - "GetByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ByteMatchSet": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ByteMatchTuples": [ - { - "FieldToMatch": { - "Data": "referer", - "Type": "HEADER" - }, - "PositionalConstraint": "CONTAINS", - "TargetString": "badrefer1", - "TextTransformation": "NONE" - } - ], - "Name": "ByteMatchNameExample" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getbytematchset-1473273311532", - "title": "To get a byte match set" - } - ], - "GetChangeToken": [ - { - "input": { - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns a change token to use for a create, update or delete operation.", - "id": "get-change-token-example-1471635120794", - "title": "To get a change token" - } - ], - "GetChangeTokenStatus": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "output": { - "ChangeTokenStatus": "PENDING" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the status of a change token with the ID abcd12f2-46da-4fdb-b8d5-fbd4c466928f.", - "id": "getchangetokenstatus-1474658417107", - "title": "To get the change token status" - } - ], - "GetIPSet": [ - { - "input": { - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "IPSet": { - "IPSetDescriptors": [ - { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - ], - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Name": "MyIPSetFriendlyName" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getipset-1474658688675", - "title": "To get an IP set" - } - ], - "GetRule": [ - { - "input": { - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "Rule": { - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule", - "Predicates": [ - { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - ], - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getrule-1474659238790", - "title": "To get a rule" - } - ], - "GetSampledRequests": [ - { - "input": { - "MaxItems": 100, - "RuleId": "WAFRule-1-Example", - "TimeWindow": { - "EndTime": "2016-09-27T15:50Z", - "StartTime": "2016-09-27T15:50Z" - }, - "WebAclId": "createwebacl-1472061481310" - }, - "output": { - "PopulationSize": 50, - "SampledRequests": [ - { - "Action": "BLOCK", - "Request": { - "ClientIP": "192.0.2.44", - "Country": "US", - "HTTPVersion": "HTTP/1.1", - "Headers": [ - { - "Name": "User-Agent", - "Value": "BadBot " - } - ], - "Method": "HEAD" - }, - "Timestamp": "2016-09-27T14:55Z", - "Weight": 1 - } - ], - "TimeWindow": { - "EndTime": "2016-09-27T15:50Z", - "StartTime": "2016-09-27T14:50Z" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns detailed information about 100 requests --a sample-- that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received between the time period 2016-09-27T15:50Z to 2016-09-27T15:50Z.", - "id": "getsampledrequests-1474927997195", - "title": "To get a sampled requests" - } - ], - "GetSizeConstraintSet": [ - { - "input": { - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "SizeConstraintSet": { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SizeConstraints": [ - { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a size constraint match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getsizeconstraintset-1475005422493", - "title": "To get a size constraint set" - } - ], - "GetSqlInjectionMatchSet": [ - { - "input": { - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "SqlInjectionMatchSet": { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SqlInjectionMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getsqlinjectionmatchset-1475005940137", - "title": "To get a SQL injection match set" - } - ], - "GetWebACL": [ - { - "input": { - "WebACLId": "createwebacl-1472061481310" - }, - "output": { - "WebACL": { - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample", - "Rules": [ - { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - ], - "WebACLId": "createwebacl-1472061481310" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a web ACL with the ID createwebacl-1472061481310.", - "id": "getwebacl-1475006348525", - "title": "To get a web ACL" - } - ], - "GetXssMatchSet": [ - { - "input": { - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "XssMatchSet": { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "XssMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getxssmatchset-1475187879017", - "title": "To get an XSS match set" - } - ], - "ListIPSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "IPSets": [ - { - "IPSetId": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MyIPSetFriendlyName" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 IP match sets.", - "id": "listipsets-1472235676229", - "title": "To list IP sets" - } - ], - "ListRules": [ - { - "input": { - "Limit": 100 - }, - "output": { - "Rules": [ - { - "Name": "WAFByteHeaderRule", - "RuleId": "WAFRule-1-Example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 rules.", - "id": "listrules-1475258406433", - "title": "To list rules" - } - ], - "ListSizeConstraintSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "SizeConstraintSets": [ - { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 size contraint match sets.", - "id": "listsizeconstraintsets-1474300067597", - "title": "To list a size constraint sets" - } - ], - "ListSqlInjectionMatchSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "SqlInjectionMatchSets": [ - { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 SQL injection match sets.", - "id": "listsqlinjectionmatchset-1474493560103", - "title": "To list SQL injection match sets" - } - ], - "ListWebACLs": [ - { - "input": { - "Limit": 100 - }, - "output": { - "WebACLs": [ - { - "Name": "WebACLexample", - "WebACLId": "webacl-1472061481310" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 web ACLs.", - "id": "listwebacls-1475258732691", - "title": "To list Web ACLs" - } - ], - "ListXssMatchSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "XssMatchSets": [ - { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 XSS match sets.", - "id": "listxssmatchsets-1474561481168", - "title": "To list XSS match sets" - } - ], - "UpdateByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Updates": [ - { - "Action": "DELETE", - "ByteMatchTuple": { - "FieldToMatch": { - "Data": "referer", - "Type": "HEADER" - }, - "PositionalConstraint": "CONTAINS", - "TargetString": "badrefer1", - "TextTransformation": "NONE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a ByteMatchTuple object (filters) in an byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatebytematchset-1475259074558", - "title": "To update a byte match set" - } - ], - "UpdateIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "IPSetDescriptor": { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an IPSetDescriptor object in an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updateipset-1475259733625", - "title": "To update an IP set" - } - ], - "UpdateRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "Predicate": { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a Predicate object in a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updaterule-1475260064720", - "title": "To update a rule" - } - ], - "UpdateSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "SizeConstraint": { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SizeConstraint object (filters) in a size constraint set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatesizeconstraintset-1475531697891", - "title": "To update a size constraint set" - } - ], - "UpdateSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "SqlInjectionMatchTuple": { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SqlInjectionMatchTuple object (filters) in a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatesqlinjectionmatchset-1475532094686", - "title": "To update a SQL injection match set" - } - ], - "UpdateWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "DefaultAction": { - "Type": "ALLOW" - }, - "Updates": [ - { - "Action": "DELETE", - "ActivatedRule": { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - } - ], - "WebACLId": "webacl-1472061481310" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an ActivatedRule object in a WebACL with the ID webacl-1472061481310.", - "id": "updatewebacl-1475533627385", - "title": "To update a Web ACL" - } - ], - "UpdateXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Updates": [ - { - "Action": "DELETE", - "XssMatchTuple": { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - } - ], - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an XssMatchTuple object (filters) in an XssMatchSet with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatexssmatchset-1475534098881", - "title": "To update an XSS match set" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/paginators-1.json deleted file mode 100644 index ea142457..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/paginators-1.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "pagination": {} -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/service-2.json deleted file mode 100644 index 611bdb63..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf-regional/2016-11-28/service-2.json +++ /dev/null @@ -1,4949 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-11-28", - "endpointPrefix":"waf-regional", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"WAF Regional", - "serviceFullName":"AWS WAF Regional", - "serviceId":"WAF Regional", - "signatureVersion":"v4", - "targetPrefix":"AWSWAF_Regional_20161128", - "uid":"waf-regional-2016-11-28" - }, - "operations":{ - "AssociateWebACL":{ - "name":"AssociateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateWebACLRequest"}, - "output":{"shape":"AssociateWebACLResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFUnavailableEntityException"} - ], - "documentation":"

Associates a web ACL with a resource.

" - }, - "CreateByteMatchSet":{ - "name":"CreateByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateByteMatchSetRequest"}, - "output":{"shape":"CreateByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a ByteMatchSet. You then use UpdateByteMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. For example, you can create a ByteMatchSet that matches any requests with User-Agent headers that contain the string BadBot. You can then configure AWS WAF to reject those requests.

To create and configure a ByteMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateByteMatchSet request.

  2. Submit a CreateByteMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateByteMatchSet request.

  4. Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateGeoMatchSet":{ - "name":"CreateGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGeoMatchSetRequest"}, - "output":{"shape":"CreateGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an GeoMatchSet, which you use to specify which web requests you want to allow or block based on the country that the requests originate from. For example, if you're receiving a lot of requests from one or more countries and you want to block the requests, you can create an GeoMatchSet that contains those countries and then configure AWS WAF to block the requests.

To create and configure a GeoMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateGeoMatchSet request.

  2. Submit a CreateGeoMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateGeoMatchSet request.

  4. Submit an UpdateGeoMatchSetSet request to specify the countries that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateIPSet":{ - "name":"CreateIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateIPSetRequest"}, - "output":{"shape":"CreateIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an IPSet, which you use to specify which web requests you want to allow or block based on the IP addresses that the requests originate from. For example, if you're receiving a lot of requests from one or more individual IP addresses or one or more ranges of IP addresses and you want to block the requests, you can create an IPSet that contains those IP addresses and then configure AWS WAF to block the requests.

To create and configure an IPSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateIPSet request.

  2. Submit a CreateIPSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  4. Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRateBasedRule":{ - "name":"CreateRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRateBasedRuleRequest"}, - "output":{"shape":"CreateRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RateBasedRule. The RateBasedRule contains a RateLimit, which specifies the maximum number of requests that AWS WAF allows from a specified IP address in a five-minute period. The RateBasedRule also contains the IPSet objects, ByteMatchSet objects, and other predicates that identify the requests that you want to count or block if these requests exceed the RateLimit.

If you add more than one predicate to a RateBasedRule, a request not only must exceed the RateLimit, but it also must match all the specifications to be counted or blocked. For example, suppose you add the following to a RateBasedRule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

Further, you specify a RateLimit of 15,000.

You then add the RateBasedRule to a WebACL and specify that you want to block requests that meet the conditions in the rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot. Further, requests that match these two conditions must be received at a rate of more than 15,000 requests every five minutes. If both conditions are met and the rate is exceeded, AWS WAF blocks the requests. If the rate drops below 15,000 for a five-minute period, AWS WAF no longer blocks the requests.

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a RateBasedRule:

  • A ByteMatchSet with FieldToMatch of URI

  • A PositionalConstraint of STARTS_WITH

  • A TargetString of login

Further, you specify a RateLimit of 15,000.

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

To create and configure a RateBasedRule, perform the following steps:

  1. Create and update the predicates that you want to include in the rule. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRule request.

  3. Submit a CreateRateBasedRule request.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  5. Submit an UpdateRateBasedRule request to specify the predicates that you want to include in the rule.

  6. Create and update a WebACL that contains the RateBasedRule. For more information, see CreateWebACL.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRegexMatchSet":{ - "name":"CreateRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRegexMatchSetRequest"}, - "output":{"shape":"CreateRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. For example, you can create a RegexMatchSet that contains a RegexMatchTuple that looks for any requests with User-Agent headers that match a RegexPatternSet with pattern B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRegexMatchSet request.

  2. Submit a CreateRegexMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexMatchSet request.

  4. Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value, using a RegexPatternSet, that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRegexPatternSet":{ - "name":"CreateRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRegexPatternSetRequest"}, - "output":{"shape":"CreateRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RegexPatternSet. You then use UpdateRegexPatternSet to specify the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexPatternSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRegexPatternSet request.

  2. Submit a CreateRegexPatternSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexPatternSet request.

  4. Submit an UpdateRegexPatternSet request to specify the string that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRule":{ - "name":"CreateRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRuleRequest"}, - "output":{"shape":"CreateRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a Rule, which contains the IPSet objects, ByteMatchSet objects, and other predicates that identify the requests that you want to block. If you add more than one predicate to a Rule, a request must match all of the specifications to be allowed or blocked. For example, suppose you add the following to a Rule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

You then add the Rule to a WebACL and specify that you want to blocks requests that satisfy the Rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot.

To create and configure a Rule, perform the following steps:

  1. Create and update the predicates that you want to include in the Rule. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRule request.

  3. Submit a CreateRule request.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  5. Submit an UpdateRule request to specify the predicates that you want to include in the Rule.

  6. Create and update a WebACL that contains the Rule. For more information, see CreateWebACL.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRuleGroup":{ - "name":"CreateRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRuleGroupRequest"}, - "output":{"shape":"CreateRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RuleGroup. A rule group is a collection of predefined rules that you add to a web ACL. You use UpdateRuleGroup to add rules to the rule group.

Rule groups are subject to the following limits:

  • Three rule groups per account. You can request an increase to this limit by contacting customer support.

  • One rule group per web ACL.

  • Ten rules per rule group.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateSizeConstraintSet":{ - "name":"CreateSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSizeConstraintSetRequest"}, - "output":{"shape":"CreateSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a SizeConstraintSet. You then use UpdateSizeConstraintSet to identify the part of a web request that you want AWS WAF to check for length, such as the length of the User-Agent header or the length of the query string. For example, you can create a SizeConstraintSet that matches any requests that have a query string that is longer than 100 bytes. You can then configure AWS WAF to reject those requests.

To create and configure a SizeConstraintSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateSizeConstraintSet request.

  2. Submit a CreateSizeConstraintSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSizeConstraintSet request.

  4. Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateSqlInjectionMatchSet":{ - "name":"CreateSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSqlInjectionMatchSetRequest"}, - "output":{"shape":"CreateSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

To create and configure a SqlInjectionMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateSqlInjectionMatchSet request.

  2. Submit a CreateSqlInjectionMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSqlInjectionMatchSet request.

  4. Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to allow, block, or count malicious SQL code.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateWebACL":{ - "name":"CreateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateWebACLRequest"}, - "output":{"shape":"CreateWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a WebACL, which contains the Rules that identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluates Rules in order based on the value of Priority for each Rule.

You also specify a default action, either ALLOW or BLOCK. If a web request doesn't match any of the Rules in a WebACL, AWS WAF responds to the request with the default action.

To create and configure a WebACL, perform the following steps:

  1. Create and update the ByteMatchSet objects and other predicates that you want to include in Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

  2. Create and update the Rules that you want to include in the WebACL. For more information, see CreateRule and UpdateRule.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateWebACL request.

  4. Submit a CreateWebACL request.

  5. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateWebACL request.

  6. Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, to specify the default action, and to associate the WebACL with a CloudFront distribution.

For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.

" - }, - "CreateXssMatchSet":{ - "name":"CreateXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateXssMatchSetRequest"}, - "output":{"shape":"CreateXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

To create and configure an XssMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateXssMatchSet request.

  2. Submit a CreateXssMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateXssMatchSet request.

  4. Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to allow, block, or count cross-site scripting attacks.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "DeleteByteMatchSet":{ - "name":"DeleteByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteByteMatchSetRequest"}, - "output":{"shape":"DeleteByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any Rules or if it still includes any ByteMatchTuple objects (any filters).

If you just want to remove a ByteMatchSet from a Rule, use UpdateRule.

To permanently delete a ByteMatchSet, perform the following steps:

  1. Update the ByteMatchSet to remove filters, if any. For more information, see UpdateByteMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteByteMatchSet request.

  3. Submit a DeleteByteMatchSet request.

" - }, - "DeleteGeoMatchSet":{ - "name":"DeleteGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGeoMatchSetRequest"}, - "output":{"shape":"DeleteGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a GeoMatchSet. You can't delete a GeoMatchSet if it's still used in any Rules or if it still includes any countries.

If you just want to remove a GeoMatchSet from a Rule, use UpdateRule.

To permanently delete a GeoMatchSet from AWS WAF, perform the following steps:

  1. Update the GeoMatchSet to remove any countries. For more information, see UpdateGeoMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteGeoMatchSet request.

  3. Submit a DeleteGeoMatchSet request.

" - }, - "DeleteIPSet":{ - "name":"DeleteIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIPSetRequest"}, - "output":{"shape":"DeleteIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any Rules or if it still includes any IP addresses.

If you just want to remove an IPSet from a Rule, use UpdateRule.

To permanently delete an IPSet from AWS WAF, perform the following steps:

  1. Update the IPSet to remove IP address ranges, if any. For more information, see UpdateIPSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteIPSet request.

  3. Submit a DeleteIPSet request.

" - }, - "DeletePermissionPolicy":{ - "name":"DeletePermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePermissionPolicyRequest"}, - "output":{"shape":"DeletePermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Permanently deletes an IAM policy from the specified RuleGroup.

The user making the request must be the owner of the RuleGroup.

" - }, - "DeleteRateBasedRule":{ - "name":"DeleteRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRateBasedRuleRequest"}, - "output":{"shape":"DeleteRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RateBasedRule. You can't delete a rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

If you just want to remove a rule from a WebACL, use UpdateWebACL.

To permanently delete a RateBasedRule from AWS WAF, perform the following steps:

  1. Update the RateBasedRule to remove predicates, if any. For more information, see UpdateRateBasedRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRateBasedRule request.

  3. Submit a DeleteRateBasedRule request.

" - }, - "DeleteRegexMatchSet":{ - "name":"DeleteRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRegexMatchSetRequest"}, - "output":{"shape":"DeleteRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RegexMatchSet. You can't delete a RegexMatchSet if it's still used in any Rules or if it still includes any RegexMatchTuples objects (any filters).

If you just want to remove a RegexMatchSet from a Rule, use UpdateRule.

To permanently delete a RegexMatchSet, perform the following steps:

  1. Update the RegexMatchSet to remove filters, if any. For more information, see UpdateRegexMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRegexMatchSet request.

  3. Submit a DeleteRegexMatchSet request.

" - }, - "DeleteRegexPatternSet":{ - "name":"DeleteRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRegexPatternSetRequest"}, - "output":{"shape":"DeleteRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RegexPatternSet. You can't delete a RegexPatternSet if it's still used in any RegexMatchSet or if the RegexPatternSet is not empty.

" - }, - "DeleteRule":{ - "name":"DeleteRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleRequest"}, - "output":{"shape":"DeleteRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a Rule. You can't delete a Rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

If you just want to remove a Rule from a WebACL, use UpdateWebACL.

To permanently delete a Rule from AWS WAF, perform the following steps:

  1. Update the Rule to remove predicates, if any. For more information, see UpdateRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRule request.

  3. Submit a DeleteRule request.

" - }, - "DeleteRuleGroup":{ - "name":"DeleteRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleGroupRequest"}, - "output":{"shape":"DeleteRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RuleGroup. You can't delete a RuleGroup if it's still used in any WebACL objects or if it still includes any rules.

If you just want to remove a RuleGroup from a WebACL, use UpdateWebACL.

To permanently delete a RuleGroup from AWS WAF, perform the following steps:

  1. Update the RuleGroup to remove rules, if any. For more information, see UpdateRuleGroup.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRuleGroup request.

  3. Submit a DeleteRuleGroup request.

" - }, - "DeleteSizeConstraintSet":{ - "name":"DeleteSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSizeConstraintSetRequest"}, - "output":{"shape":"DeleteSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still used in any Rules or if it still includes any SizeConstraint objects (any filters).

If you just want to remove a SizeConstraintSet from a Rule, use UpdateRule.

To permanently delete a SizeConstraintSet, perform the following steps:

  1. Update the SizeConstraintSet to remove filters, if any. For more information, see UpdateSizeConstraintSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteSizeConstraintSet request.

  3. Submit a DeleteSizeConstraintSet request.

" - }, - "DeleteSqlInjectionMatchSet":{ - "name":"DeleteSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSqlInjectionMatchSetRequest"}, - "output":{"shape":"DeleteSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.

If you just want to remove a SqlInjectionMatchSet from a Rule, use UpdateRule.

To permanently delete a SqlInjectionMatchSet from AWS WAF, perform the following steps:

  1. Update the SqlInjectionMatchSet to remove filters, if any. For more information, see UpdateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteSqlInjectionMatchSet request.

  3. Submit a DeleteSqlInjectionMatchSet request.

" - }, - "DeleteWebACL":{ - "name":"DeleteWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteWebACLRequest"}, - "output":{"shape":"DeleteWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a WebACL. You can't delete a WebACL if it still contains any Rules.

To delete a WebACL, perform the following steps:

  1. Update the WebACL to remove Rules, if any. For more information, see UpdateWebACL.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteWebACL request.

  3. Submit a DeleteWebACL request.

" - }, - "DeleteXssMatchSet":{ - "name":"DeleteXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteXssMatchSetRequest"}, - "output":{"shape":"DeleteXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's still used in any Rules or if it still contains any XssMatchTuple objects.

If you just want to remove an XssMatchSet from a Rule, use UpdateRule.

To permanently delete an XssMatchSet from AWS WAF, perform the following steps:

  1. Update the XssMatchSet to remove filters, if any. For more information, see UpdateXssMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteXssMatchSet request.

  3. Submit a DeleteXssMatchSet request.

" - }, - "DisassociateWebACL":{ - "name":"DisassociateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateWebACLRequest"}, - "output":{"shape":"DisassociateWebACLResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Removes a web ACL from the specified resource.

" - }, - "GetByteMatchSet":{ - "name":"GetByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetByteMatchSetRequest"}, - "output":{"shape":"GetByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the ByteMatchSet specified by ByteMatchSetId.

" - }, - "GetChangeToken":{ - "name":"GetChangeToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetChangeTokenRequest"}, - "output":{"shape":"GetChangeTokenResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.

Each create, update, or delete request must use a unique change token. If your application submits a GetChangeToken request and then submits a second GetChangeToken request before submitting a create, update, or delete request, the second GetChangeToken request returns the same value as the first GetChangeToken request.

When you use a change token in a create, update, or delete request, the status of the change token changes to PENDING, which indicates that AWS WAF is propagating the change to all AWS WAF servers. Use GetChangeTokenStatus to determine the status of your change token.

" - }, - "GetChangeTokenStatus":{ - "name":"GetChangeTokenStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetChangeTokenStatusRequest"}, - "output":{"shape":"GetChangeTokenStatusResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns the status of a ChangeToken that you got by calling GetChangeToken. ChangeTokenStatus is one of the following values:

  • PROVISIONED: You requested the change token by calling GetChangeToken, but you haven't used it yet in a call to create, update, or delete an AWS WAF object.

  • PENDING: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.

  • IN_SYNC: Propagation is complete.

" - }, - "GetGeoMatchSet":{ - "name":"GetGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGeoMatchSetRequest"}, - "output":{"shape":"GetGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the GeoMatchSet that is specified by GeoMatchSetId.

" - }, - "GetIPSet":{ - "name":"GetIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIPSetRequest"}, - "output":{"shape":"GetIPSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the IPSet that is specified by IPSetId.

" - }, - "GetPermissionPolicy":{ - "name":"GetPermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPermissionPolicyRequest"}, - "output":{"shape":"GetPermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the IAM policy attached to the RuleGroup.

" - }, - "GetRateBasedRule":{ - "name":"GetRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRateBasedRuleRequest"}, - "output":{"shape":"GetRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RateBasedRule that is specified by the RuleId that you included in the GetRateBasedRule request.

" - }, - "GetRateBasedRuleManagedKeys":{ - "name":"GetRateBasedRuleManagedKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRateBasedRuleManagedKeysRequest"}, - "output":{"shape":"GetRateBasedRuleManagedKeysResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Returns an array of IP addresses currently being blocked by the RateBasedRule that is specified by the RuleId. The maximum number of managed keys that will be blocked is 10,000. If more than 10,000 addresses exceed the rate limit, the 10,000 addresses with the highest rates will be blocked.

" - }, - "GetRegexMatchSet":{ - "name":"GetRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRegexMatchSetRequest"}, - "output":{"shape":"GetRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RegexMatchSet specified by RegexMatchSetId.

" - }, - "GetRegexPatternSet":{ - "name":"GetRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRegexPatternSetRequest"}, - "output":{"shape":"GetRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RegexPatternSet specified by RegexPatternSetId.

" - }, - "GetRule":{ - "name":"GetRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRuleRequest"}, - "output":{"shape":"GetRuleResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the Rule that is specified by the RuleId that you included in the GetRule request.

" - }, - "GetRuleGroup":{ - "name":"GetRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRuleGroupRequest"}, - "output":{"shape":"GetRuleGroupResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RuleGroup that is specified by the RuleGroupId that you included in the GetRuleGroup request.

To view the rules in a rule group, use ListActivatedRulesInRuleGroup.

" - }, - "GetSampledRequests":{ - "name":"GetSampledRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSampledRequestsRequest"}, - "output":{"shape":"GetSampledRequestsResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

" - }, - "GetSizeConstraintSet":{ - "name":"GetSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSizeConstraintSetRequest"}, - "output":{"shape":"GetSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the SizeConstraintSet specified by SizeConstraintSetId.

" - }, - "GetSqlInjectionMatchSet":{ - "name":"GetSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSqlInjectionMatchSetRequest"}, - "output":{"shape":"GetSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.

" - }, - "GetWebACL":{ - "name":"GetWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetWebACLRequest"}, - "output":{"shape":"GetWebACLResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the WebACL that is specified by WebACLId.

" - }, - "GetWebACLForResource":{ - "name":"GetWebACLForResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetWebACLForResourceRequest"}, - "output":{"shape":"GetWebACLForResourceResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFUnavailableEntityException"} - ], - "documentation":"

Returns the web ACL for the specified resource.

" - }, - "GetXssMatchSet":{ - "name":"GetXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetXssMatchSetRequest"}, - "output":{"shape":"GetXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the XssMatchSet that is specified by XssMatchSetId.

" - }, - "ListActivatedRulesInRuleGroup":{ - "name":"ListActivatedRulesInRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListActivatedRulesInRuleGroupRequest"}, - "output":{"shape":"ListActivatedRulesInRuleGroupResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Returns an array of ActivatedRule objects.

" - }, - "ListByteMatchSets":{ - "name":"ListByteMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListByteMatchSetsRequest"}, - "output":{"shape":"ListByteMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of ByteMatchSetSummary objects.

" - }, - "ListGeoMatchSets":{ - "name":"ListGeoMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGeoMatchSetsRequest"}, - "output":{"shape":"ListGeoMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of GeoMatchSetSummary objects in the response.

" - }, - "ListIPSets":{ - "name":"ListIPSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIPSetsRequest"}, - "output":{"shape":"ListIPSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of IPSetSummary objects in the response.

" - }, - "ListRateBasedRules":{ - "name":"ListRateBasedRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRateBasedRulesRequest"}, - "output":{"shape":"ListRateBasedRulesResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RuleSummary objects.

" - }, - "ListRegexMatchSets":{ - "name":"ListRegexMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRegexMatchSetsRequest"}, - "output":{"shape":"ListRegexMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RegexMatchSetSummary objects.

" - }, - "ListRegexPatternSets":{ - "name":"ListRegexPatternSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRegexPatternSetsRequest"}, - "output":{"shape":"ListRegexPatternSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RegexPatternSetSummary objects.

" - }, - "ListResourcesForWebACL":{ - "name":"ListResourcesForWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourcesForWebACLRequest"}, - "output":{"shape":"ListResourcesForWebACLResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns an array of resources associated with the specified web ACL.

" - }, - "ListRuleGroups":{ - "name":"ListRuleGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRuleGroupsRequest"}, - "output":{"shape":"ListRuleGroupsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns an array of RuleGroup objects.

" - }, - "ListRules":{ - "name":"ListRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRulesRequest"}, - "output":{"shape":"ListRulesResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RuleSummary objects.

" - }, - "ListSizeConstraintSets":{ - "name":"ListSizeConstraintSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSizeConstraintSetsRequest"}, - "output":{"shape":"ListSizeConstraintSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of SizeConstraintSetSummary objects.

" - }, - "ListSqlInjectionMatchSets":{ - "name":"ListSqlInjectionMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSqlInjectionMatchSetsRequest"}, - "output":{"shape":"ListSqlInjectionMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of SqlInjectionMatchSet objects.

" - }, - "ListSubscribedRuleGroups":{ - "name":"ListSubscribedRuleGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSubscribedRuleGroupsRequest"}, - "output":{"shape":"ListSubscribedRuleGroupsResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns an array of RuleGroup objects that you are subscribed to.

" - }, - "ListWebACLs":{ - "name":"ListWebACLs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWebACLsRequest"}, - "output":{"shape":"ListWebACLsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of WebACLSummary objects in the response.

" - }, - "ListXssMatchSets":{ - "name":"ListXssMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListXssMatchSetsRequest"}, - "output":{"shape":"ListXssMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of XssMatchSet objects.

" - }, - "PutPermissionPolicy":{ - "name":"PutPermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutPermissionPolicyRequest"}, - "output":{"shape":"PutPermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidPermissionPolicyException"} - ], - "documentation":"

Attaches a IAM policy to the specified resource. The only supported use for this action is to share a RuleGroup across accounts.

The PutPermissionPolicy is subject to the following restrictions:

  • You can attach only one policy with each PutPermissionPolicy request.

  • The policy must include an Effect, Action and Principal.

  • Effect must specify Allow.

  • The Action in the policy must be waf:UpdateWebACL and waf-regional:UpdateWebACL. Any extra or wildcard actions in the policy will be rejected.

  • The policy cannot include a Resource parameter.

  • The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

  • The user making the request must be the owner of the RuleGroup.

  • Your policy must be composed using IAM Policy version 2012-10-17.

For more information, see IAM Policies.

An example of a valid policy parameter is shown in the Examples section below.

" - }, - "UpdateByteMatchSet":{ - "name":"UpdateByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateByteMatchSetRequest"}, - "output":{"shape":"UpdateByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each ByteMatchTuple object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a ByteMatchSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to look for. For more information, including how you specify the values for the AWS WAF API and the AWS CLI or SDKs, see TargetString in the ByteMatchTuple data type.

  • Where to look, such as at the beginning or the end of a query string.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

For example, you can add a ByteMatchSetUpdate object that matches web requests in which User-Agent headers contain the string BadBot. You can then configure AWS WAF to block those requests.

To create and configure a ByteMatchSet, perform the following steps:

  1. Create a ByteMatchSet. For more information, see CreateByteMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateByteMatchSet request.

  3. Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateGeoMatchSet":{ - "name":"UpdateGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGeoMatchSetRequest"}, - "output":{"shape":"UpdateGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes GeoMatchConstraint objects in an GeoMatchSet. For each GeoMatchConstraint object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change an GeoMatchConstraint object, you delete the existing object and add a new one.

  • The Type. The only valid value for Type is Country.

  • The Value, which is a two character code for the country to add to the GeoMatchConstraint object. Valid codes are listed in GeoMatchConstraint$Value.

To create and configure an GeoMatchSet, perform the following steps:

  1. Submit a CreateGeoMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateGeoMatchSet request.

  3. Submit an UpdateGeoMatchSet request to specify the country that you want AWS WAF to watch for.

When you update an GeoMatchSet, you specify the country that you want to add and/or the country that you want to delete. If you want to change a country, you delete the existing country and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateIPSet":{ - "name":"UpdateIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateIPSetRequest"}, - "output":{"shape":"UpdateIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes IPSetDescriptor objects in an IPSet. For each IPSetDescriptor object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change an IPSetDescriptor object, you delete the existing object and add a new one.

  • The IP address version, IPv4 or IPv6.

  • The IP address in CIDR notation, for example, 192.0.2.0/24 (for the range of IP addresses from 192.0.2.0 to 192.0.2.255) or 192.0.2.44/32 (for the individual IP address 192.0.2.44).

AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

IPv6 addresses can be represented using any of the following formats:

  • 1111:0000:0000:0000:0000:0000:0000:0111/128

  • 1111:0:0:0:0:0:0:0111/128

  • 1111::0111/128

  • 1111::111/128

You use an IPSet to specify which web requests you want to allow or block based on the IP addresses that the requests originated from. For example, if you're receiving a lot of requests from one or a small number of IP addresses and you want to block the requests, you can create an IPSet that specifies those IP addresses, and then configure AWS WAF to block the requests.

To create and configure an IPSet, perform the following steps:

  1. Submit a CreateIPSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

When you update an IPSet, you specify the IP addresses that you want to add and/or the IP addresses that you want to delete. If you want to change an IP address, you delete the existing IP address and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRateBasedRule":{ - "name":"UpdateRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRateBasedRuleRequest"}, - "output":{"shape":"UpdateRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes Predicate objects in a rule and updates the RateLimit in the rule.

Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to block or count. The RateLimit specifies the number of requests every five minutes that triggers the rule.

If you add more than one predicate to a RateBasedRule, a request must match all the predicates and exceed the RateLimit to be counted or blocked. For example, suppose you add the following to a RateBasedRule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

Further, you specify a RateLimit of 15,000.

You then add the RateBasedRule to a WebACL and specify that you want to block requests that satisfy the rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot. Further, requests that match these two conditions much be received at a rate of more than 15,000 every five minutes. If the rate drops below this limit, AWS WAF no longer blocks the requests.

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a RateBasedRule:

  • A ByteMatchSet with FieldToMatch of URI

  • A PositionalConstraint of STARTS_WITH

  • A TargetString of login

Further, you specify a RateLimit of 15,000.

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

" - }, - "UpdateRegexMatchSet":{ - "name":"UpdateRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRegexMatchSetRequest"}, - "output":{"shape":"UpdateRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Inserts or deletes RegexMatchTuple objects (filters) in a RegexMatchSet. For each RegexMatchSetUpdate object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a RegexMatchSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to inspectupdate, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

For example, you can create a RegexPatternSet that matches any requests with User-Agent headers that contain the string B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexMatchSet, perform the following steps:

  1. Create a RegexMatchSet. For more information, see CreateRegexMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexMatchSet request.

  3. Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the identifier of the RegexPatternSet that contain the regular expression patters you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRegexPatternSet":{ - "name":"UpdateRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRegexPatternSetRequest"}, - "output":{"shape":"UpdateRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidRegexPatternException"} - ], - "documentation":"

Inserts or deletes RegexPatternString objects in a RegexPatternSet. For each RegexPatternString object, you specify the following values:

  • Whether to insert or delete the RegexPatternString.

  • The regular expression pattern that you want to insert or delete. For more information, see RegexPatternSet.

For example, you can create a RegexPatternString such as B[a@]dB[o0]t. AWS WAF will match this RegexPatternString to:

  • BadBot

  • BadB0t

  • B@dBot

  • B@dB0t

To create and configure a RegexPatternSet, perform the following steps:

  1. Create a RegexPatternSet. For more information, see CreateRegexPatternSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexPatternSet request.

  3. Submit an UpdateRegexPatternSet request to specify the regular expression pattern that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRule":{ - "name":"UpdateRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRuleRequest"}, - "output":{"shape":"UpdateRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes Predicate objects in a Rule. Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to allow, block, or count. If you add more than one predicate to a Rule, a request must match all of the specifications to be allowed, blocked, or counted. For example, suppose you add the following to a Rule:

  • A ByteMatchSet that matches the value BadBot in the User-Agent header

  • An IPSet that matches the IP address 192.0.2.44

You then add the Rule to a WebACL and specify that you want to block requests that satisfy the Rule. For a request to be blocked, the User-Agent header in the request must contain the value BadBot and the request must originate from the IP address 192.0.2.44.

To create and configure a Rule, perform the following steps:

  1. Create and update the predicates that you want to include in the Rule.

  2. Create the Rule. See CreateRule.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  4. Submit an UpdateRule request to add predicates to the Rule.

  5. Create and update a WebACL that contains the Rule. See CreateWebACL.

If you want to replace one ByteMatchSet or IPSet with another, you delete the existing one and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRuleGroup":{ - "name":"UpdateRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRuleGroupRequest"}, - "output":{"shape":"UpdateRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Inserts or deletes ActivatedRule objects in a RuleGroup.

You can only insert REGULAR rules into a rule group.

You can have a maximum of ten rules per rule group.

To create and configure a RuleGroup, perform the following steps:

  1. Create and update the Rules that you want to include in the RuleGroup. See CreateRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRuleGroup request.

  3. Submit an UpdateRuleGroup request to add Rules to the RuleGroup.

  4. Create and update a WebACL that contains the RuleGroup. See CreateWebACL.

If you want to replace one Rule with another, you delete the existing one and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateSizeConstraintSet":{ - "name":"UpdateSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSizeConstraintSetRequest"}, - "output":{"shape":"UpdateSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each SizeConstraint object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a SizeConstraintSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to evaluate, such as the length of a query string or the length of the User-Agent header.

  • Whether to perform any transformations on the request, such as converting it to lowercase, before checking its length. Note that transformations of the request body are not supported because the AWS resource forwards only the first 8192 bytes of your request to AWS WAF.

  • A ComparisonOperator used for evaluating the selected part of the request against the specified Size, such as equals, greater than, less than, and so on.

  • The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.

For example, you can add a SizeConstraintSetUpdate object that matches web requests in which the length of the User-Agent header is greater than 100 bytes. You can then configure AWS WAF to block those requests.

To create and configure a SizeConstraintSet, perform the following steps:

  1. Create a SizeConstraintSet. For more information, see CreateSizeConstraintSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSizeConstraintSet request.

  3. Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateSqlInjectionMatchSet":{ - "name":"UpdateSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSqlInjectionMatchSetRequest"}, - "output":{"shape":"UpdateSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. For each SqlInjectionMatchTuple object, you specify the following values:

  • Action: Whether to insert the object into or delete the object from the array. To change a SqlInjectionMatchTuple, you delete the existing object and add a new one.

  • FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.

  • TextTransformation: Which text transformation, if any, to perform on the web request before inspecting the request for snippets of malicious SQL code.

You use SqlInjectionMatchSet objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain snippets of SQL code in the query string and you want to block the requests, you can create a SqlInjectionMatchSet with the applicable settings, and then configure AWS WAF to block the requests.

To create and configure a SqlInjectionMatchSet, perform the following steps:

  1. Submit a CreateSqlInjectionMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests that you want AWS WAF to inspect for snippets of SQL code.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateWebACL":{ - "name":"UpdateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateWebACLRequest"}, - "output":{"shape":"UpdateWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFSubscriptionNotFoundException"} - ], - "documentation":"

Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies web requests that you want to allow, block, or count. When you update a WebACL, you specify the following values:

  • A default action for the WebACL, either ALLOW or BLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of the Rules in a WebACL.

  • The Rules that you want to add and/or delete. If you want to replace one Rule with another, you delete the existing Rule and add the new one.

  • For each Rule, whether you want AWS WAF to allow requests, block requests, or count requests that match the conditions in the Rule.

  • The order in which you want AWS WAF to evaluate the Rules in a WebACL. If you add more than one Rule to a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. (The Rule that has the lowest value for Priority is evaluated first.) When a web request matches all of the predicates (such as ByteMatchSets and IPSets) in a Rule, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remaining Rules in the WebACL, if any.

To create and configure a WebACL, perform the following steps:

  1. Create and update the predicates that you want to include in Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

  2. Create and update the Rules that you want to include in the WebACL. For more information, see CreateRule and UpdateRule.

  3. Create a WebACL. See CreateWebACL.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateWebACL request.

  5. Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, to specify the default action, and to associate the WebACL with a CloudFront distribution.

Be aware that if you try to add a RATE_BASED rule to a web ACL without setting the rule type when first creating the rule, the UpdateWebACL request will fail because the request tries to add a REGULAR rule (the default rule type) with the specified ID, which does not exist.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateXssMatchSet":{ - "name":"UpdateXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateXssMatchSetRequest"}, - "output":{"shape":"UpdateXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. For each XssMatchTuple object, you specify the following values:

  • Action: Whether to insert the object into or delete the object from the array. To change a XssMatchTuple, you delete the existing object and add a new one.

  • FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.

  • TextTransformation: Which text transformation, if any, to perform on the web request before inspecting the request for cross-site scripting attacks.

You use XssMatchSet objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain cross-site scripting attacks in the request body and you want to block the requests, you can create an XssMatchSet with the applicable settings, and then configure AWS WAF to block the requests.

To create and configure an XssMatchSet, perform the following steps:

  1. Submit a CreateXssMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateXssMatchSet request to specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - } - }, - "shapes":{ - "Action":{"type":"string"}, - "ActivatedRule":{ - "type":"structure", - "required":[ - "Priority", - "RuleId" - ], - "members":{ - "Priority":{ - "shape":"RulePriority", - "documentation":"

Specifies the order in which the Rules in a WebACL are evaluated. Rules with a lower value for Priority are evaluated before Rules with a higher value. The value must be a unique integer. If you add multiple Rules to a WebACL, the values don't need to be consecutive.

" - }, - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Action":{ - "shape":"WafAction", - "documentation":"

Specifies the action that CloudFront or AWS WAF takes when a web request matches the conditions in the Rule. Valid values for Action include the following:

  • ALLOW: CloudFront responds with the requested object.

  • BLOCK: CloudFront responds with an HTTP 403 (Forbidden) status code.

  • COUNT: AWS WAF increments a counter of requests that match the conditions in the rule and then continues to inspect the web request based on the remaining rules in the web ACL.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "OverrideAction":{ - "shape":"WafOverrideAction", - "documentation":"

Use the OverrideAction to test your RuleGroup.

Any rule in a RuleGroup can potentially block a request. If you set the OverrideAction to None, the RuleGroup will block a request if any individual rule in the RuleGroup matches the request and is configured to block that request. However if you first want to test the RuleGroup, set the OverrideAction to Count. The RuleGroup will then override any block action specified by individual rules contained within the group. Instead of blocking matching requests, those requests will be counted. You can view a record of counted requests using GetSampledRequests.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "Type":{ - "shape":"WafRuleType", - "documentation":"

The rule type, either REGULAR, as defined by Rule, RATE_BASED, as defined by RateBasedRule, or GROUP, as defined by RuleGroup. The default is REGULAR. Although this field is optional, be aware that if you try to add a RATE_BASED rule to a web ACL without setting the type, the UpdateWebACL request will fail because the request tries to add a REGULAR rule with the specified ID, which does not exist.

" - } - }, - "documentation":"

The ActivatedRule object in an UpdateWebACL request specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

To specify whether to insert or delete a Rule, use the Action parameter in the WebACLUpdate data type.

" - }, - "ActivatedRules":{ - "type":"list", - "member":{"shape":"ActivatedRule"} - }, - "AssociateWebACLRequest":{ - "type":"structure", - "required":[ - "WebACLId", - "ResourceArn" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier (ID) for the web ACL.

" - }, - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the resource to be protected.

" - } - } - }, - "AssociateWebACLResponse":{ - "type":"structure", - "members":{ - } - }, - "ByteMatchSet":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ByteMatchTuples" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId for a ByteMatchSet. You use ByteMatchSetId to get information about a ByteMatchSet (see GetByteMatchSet), update a ByteMatchSet (see UpdateByteMatchSet), insert a ByteMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a ByteMatchSet from AWS WAF (see DeleteByteMatchSet).

ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - }, - "ByteMatchTuples":{ - "shape":"ByteMatchTuples", - "documentation":"

Specifies the bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings.

" - } - }, - "documentation":"

In a GetByteMatchSet request, ByteMatchSet is a complex type that contains the ByteMatchSetId and Name of a ByteMatchSet, and the values that you specified when you updated the ByteMatchSet.

A complex type that contains ByteMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a ByteMatchSet contains more than one ByteMatchTuple object, a request needs to match the settings in only one ByteMatchTuple to be considered a match.

" - }, - "ByteMatchSetSummaries":{ - "type":"list", - "member":{"shape":"ByteMatchSetSummary"} - }, - "ByteMatchSetSummary":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "Name" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId for a ByteMatchSet. You use ByteMatchSetId to get information about a ByteMatchSet, update a ByteMatchSet, remove a ByteMatchSet from a Rule, and delete a ByteMatchSet from AWS WAF.

ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - } - }, - "documentation":"

Returned by ListByteMatchSets. Each ByteMatchSetSummary object includes the Name and ByteMatchSetId for one ByteMatchSet.

" - }, - "ByteMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "ByteMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a ByteMatchTuple.

" - }, - "ByteMatchTuple":{ - "shape":"ByteMatchTuple", - "documentation":"

Information about the part of a web request that you want AWS WAF to inspect and the value that you want AWS WAF to search for. If you specify DELETE for the value of Action, the ByteMatchTuple values must exactly match the values in the ByteMatchTuple that you want to delete from the ByteMatchSet.

" - } - }, - "documentation":"

In an UpdateByteMatchSet request, ByteMatchSetUpdate specifies whether to insert or delete a ByteMatchTuple and includes the settings for the ByteMatchTuple.

" - }, - "ByteMatchSetUpdates":{ - "type":"list", - "member":{"shape":"ByteMatchSetUpdate"}, - "min":1 - }, - "ByteMatchTargetString":{"type":"blob"}, - "ByteMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TargetString", - "TextTransformation", - "PositionalConstraint" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

The part of a web request that you want AWS WAF to search, such as a specified header or a query string. For more information, see FieldToMatch.

" - }, - "TargetString":{ - "shape":"ByteMatchTargetString", - "documentation":"

The value that you want AWS WAF to search for. AWS WAF searches for the specified string in the part of web requests that you specified in FieldToMatch. The maximum length of the value is 50 bytes.

Valid values depend on the values that you specified for FieldToMatch:

  • HEADER: The value that you want AWS WAF to search for in the request header that you specified in FieldToMatch, for example, the value of the User-Agent or Referer header.

  • METHOD: The HTTP method, which indicates the type of operation specified in the request. CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

  • QUERY_STRING: The value that you want AWS WAF to search for in the query string, which is the part of a URL that appears after a ? character.

  • URI: The value that you want AWS WAF to search for in the part of a URL that identifies a resource, for example, /images/daily-ad.jpg.

  • BODY: The part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form. The request body immediately follows the request headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For more information, see CreateSizeConstraintSet.

If TargetString includes alphabetic characters A-Z and a-z, note that the value is case sensitive.

If you're using the AWS WAF API

Specify a base64-encoded version of the value. The maximum length of the value before you base64-encode it is 50 bytes.

For example, suppose the value of Type is HEADER and the value of Data is User-Agent. If you want to search the User-Agent header for the value BadBot, you base64-encode BadBot using MIME base64 encoding and include the resulting value, QmFkQm90, in the value of TargetString.

If you're using the AWS CLI or one of the AWS SDKs

The value that you want AWS WAF to search for. The SDK automatically base64 encodes the value.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on TargetString before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - }, - "PositionalConstraint":{ - "shape":"PositionalConstraint", - "documentation":"

Within the portion of a web request that you want to search (for example, in the query string, if any), specify where you want AWS WAF to search. Valid values include the following:

CONTAINS

The specified part of the web request must include the value of TargetString, but the location doesn't matter.

CONTAINS_WORD

The specified part of the web request must include the value of TargetString, and TargetString must contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In addition, TargetString must be a word, which means one of the following:

  • TargetString exactly matches the value of the specified part of the web request, such as the value of a header.

  • TargetString is at the beginning of the specified part of the web request and is followed by a character other than an alphanumeric character or underscore (_), for example, BadBot;.

  • TargetString is at the end of the specified part of the web request and is preceded by a character other than an alphanumeric character or underscore (_), for example, ;BadBot.

  • TargetString is in the middle of the specified part of the web request and is preceded and followed by characters other than alphanumeric characters or underscore (_), for example, -BadBot;.

EXACTLY

The value of the specified part of the web request must exactly match the value of TargetString.

STARTS_WITH

The value of TargetString must appear at the beginning of the specified part of the web request.

ENDS_WITH

The value of TargetString must appear at the end of the specified part of the web request.

" - } - }, - "documentation":"

The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings.

" - }, - "ByteMatchTuples":{ - "type":"list", - "member":{"shape":"ByteMatchTuple"} - }, - "ChangeAction":{ - "type":"string", - "enum":[ - "INSERT", - "DELETE" - ] - }, - "ChangeToken":{ - "type":"string", - "min":1 - }, - "ChangeTokenStatus":{ - "type":"string", - "enum":[ - "PROVISIONED", - "PENDING", - "INSYNC" - ] - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "EQ", - "NE", - "LE", - "LT", - "GE", - "GT" - ] - }, - "Country":{"type":"string"}, - "CreateByteMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ByteMatchSet":{ - "shape":"ByteMatchSet", - "documentation":"

A ByteMatchSet that contains no ByteMatchTuple objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change Name after you create the GeoMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "GeoMatchSet":{ - "shape":"GeoMatchSet", - "documentation":"

The GeoMatchSet returned in the CreateGeoMatchSet response. The GeoMatchSet contains no GeoMatchConstraints.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateIPSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change Name after you create the IPSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateIPSetResponse":{ - "type":"structure", - "members":{ - "IPSet":{ - "shape":"IPSet", - "documentation":"

The IPSet returned in the CreateIPSet response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "RateKey", - "RateLimit", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RateBasedRule. You can't change the name of a RateBasedRule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RateBasedRule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RateBasedRule.

" - }, - "RateKey":{ - "shape":"RateKey", - "documentation":"

The field that AWS WAF uses to determine if requests are likely arriving from a single source and thus subject to rate monitoring. The only valid value for RateKey is IP. IP indicates that requests that arrive from the same IP address are subject to the RateLimit that is specified in the RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field that is specified by RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"RateBasedRule", - "documentation":"

The RateBasedRule that is returned in the CreateRateBasedRule response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "RegexMatchSet":{ - "shape":"RegexMatchSet", - "documentation":"

A RegexMatchSet that contains no RegexMatchTuple objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "RegexPatternSet":{ - "shape":"RegexPatternSet", - "documentation":"

A RegexPatternSet that contains no objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRuleGroupRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change Name after you create a RuleGroup.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRuleGroupResponse":{ - "type":"structure", - "members":{ - "RuleGroup":{ - "shape":"RuleGroup", - "documentation":"

An empty RuleGroup.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRuleRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the Rule. You can't change the name of a Rule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this Rule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the Rule.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"Rule", - "documentation":"

The Rule returned in the CreateRule response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the SizeConstraintSet. You can't change Name after you create a SizeConstraintSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "SizeConstraintSet":{ - "shape":"SizeConstraintSet", - "documentation":"

A SizeConstraintSet that contains no SizeConstraint objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for the SqlInjectionMatchSet that you're creating. You can't change Name after you create the SqlInjectionMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to create a SqlInjectionMatchSet.

" - }, - "CreateSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "SqlInjectionMatchSet":{ - "shape":"SqlInjectionMatchSet", - "documentation":"

A SqlInjectionMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a CreateSqlInjectionMatchSet request.

" - }, - "CreateWebACLRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "DefaultAction", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change Name after you create the WebACL.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this WebACL. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the WebACL.

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

The action that you want AWS WAF to take when a request doesn't match the criteria specified in any of the Rule objects that are associated with the WebACL.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateWebACLResponse":{ - "type":"structure", - "members":{ - "WebACL":{ - "shape":"WebACL", - "documentation":"

The WebACL returned in the CreateWebACL response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateXssMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for the XssMatchSet that you're creating. You can't change Name after you create the XssMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to create an XssMatchSet.

" - }, - "CreateXssMatchSetResponse":{ - "type":"structure", - "members":{ - "XssMatchSet":{ - "shape":"XssMatchSet", - "documentation":"

An XssMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a CreateXssMatchSet request.

" - }, - "DeleteByteMatchSetRequest":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ChangeToken" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to delete. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "ChangeToken" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetID of the GeoMatchSet that you want to delete. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteIPSetRequest":{ - "type":"structure", - "required":[ - "IPSetId", - "ChangeToken" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to delete. IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteIPSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeletePermissionPolicyRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup from which you want to delete the policy.

The user making the request must be the owner of the RuleGroup.

" - } - } - }, - "DeletePermissionPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to delete. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "ChangeToken" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to delete. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "ChangeToken" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to delete. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRuleGroupRequest":{ - "type":"structure", - "required":[ - "RuleGroupId", - "ChangeToken" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to delete. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRuleGroupResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to delete. RuleId is returned by CreateRule and by ListRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "ChangeToken" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to delete. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "ChangeToken" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to delete. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to delete a SqlInjectionMatchSet from AWS WAF.

" - }, - "DeleteSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a request to delete a SqlInjectionMatchSet from AWS WAF.

" - }, - "DeleteWebACLRequest":{ - "type":"structure", - "required":[ - "WebACLId", - "ChangeToken" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to delete. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteWebACLResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteXssMatchSetRequest":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "ChangeToken" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to delete. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to delete an XssMatchSet from AWS WAF.

" - }, - "DeleteXssMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a request to delete an XssMatchSet from AWS WAF.

" - }, - "DisassociateWebACLRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the resource from which the web ACL is being removed.

" - } - } - }, - "DisassociateWebACLResponse":{ - "type":"structure", - "members":{ - } - }, - "FieldToMatch":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"MatchFieldType", - "documentation":"

The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that you can search include the following:

  • HEADER: A specified request header, for example, the value of the User-Agent or Referer header. If you choose HEADER for the type, specify the name of the header in Data.

  • METHOD: The HTTP method, which indicated the type of operation that the request is asking the origin to perform. Amazon CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

  • QUERY_STRING: A query string, which is the part of a URL that appears after a ? character, if any.

  • URI: The part of a web request that identifies a resource, for example, /images/daily-ad.jpg.

  • BODY: The part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form. The request body immediately follows the request headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For more information, see CreateSizeConstraintSet.

" - }, - "Data":{ - "shape":"MatchFieldData", - "documentation":"

When the value of Type is HEADER, enter the name of the header that you want AWS WAF to search, for example, User-Agent or Referer. If the value of Type is any other value, omit Data.

The name of the header is not case sensitive.

" - } - }, - "documentation":"

Specifies where in a web request to look for TargetString.

" - }, - "GeoMatchConstraint":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"GeoMatchConstraintType", - "documentation":"

The type of geographical area you want AWS WAF to search for. Currently Country is the only valid value.

" - }, - "Value":{ - "shape":"GeoMatchConstraintValue", - "documentation":"

The country that you want AWS WAF to search for.

" - } - }, - "documentation":"

The country from which web requests originate that you want AWS WAF to search for.

" - }, - "GeoMatchConstraintType":{ - "type":"string", - "enum":["Country"] - }, - "GeoMatchConstraintValue":{ - "type":"string", - "enum":[ - "AF", - "AX", - "AL", - "DZ", - "AS", - "AD", - "AO", - "AI", - "AQ", - "AG", - "AR", - "AM", - "AW", - "AU", - "AT", - "AZ", - "BS", - "BH", - "BD", - "BB", - "BY", - "BE", - "BZ", - "BJ", - "BM", - "BT", - "BO", - "BQ", - "BA", - "BW", - "BV", - "BR", - "IO", - "BN", - "BG", - "BF", - "BI", - "KH", - "CM", - "CA", - "CV", - "KY", - "CF", - "TD", - "CL", - "CN", - "CX", - "CC", - "CO", - "KM", - "CG", - "CD", - "CK", - "CR", - "CI", - "HR", - "CU", - "CW", - "CY", - "CZ", - "DK", - "DJ", - "DM", - "DO", - "EC", - "EG", - "SV", - "GQ", - "ER", - "EE", - "ET", - "FK", - "FO", - "FJ", - "FI", - "FR", - "GF", - "PF", - "TF", - "GA", - "GM", - "GE", - "DE", - "GH", - "GI", - "GR", - "GL", - "GD", - "GP", - "GU", - "GT", - "GG", - "GN", - "GW", - "GY", - "HT", - "HM", - "VA", - "HN", - "HK", - "HU", - "IS", - "IN", - "ID", - "IR", - "IQ", - "IE", - "IM", - "IL", - "IT", - "JM", - "JP", - "JE", - "JO", - "KZ", - "KE", - "KI", - "KP", - "KR", - "KW", - "KG", - "LA", - "LV", - "LB", - "LS", - "LR", - "LY", - "LI", - "LT", - "LU", - "MO", - "MK", - "MG", - "MW", - "MY", - "MV", - "ML", - "MT", - "MH", - "MQ", - "MR", - "MU", - "YT", - "MX", - "FM", - "MD", - "MC", - "MN", - "ME", - "MS", - "MA", - "MZ", - "MM", - "NA", - "NR", - "NP", - "NL", - "NC", - "NZ", - "NI", - "NE", - "NG", - "NU", - "NF", - "MP", - "NO", - "OM", - "PK", - "PW", - "PS", - "PA", - "PG", - "PY", - "PE", - "PH", - "PN", - "PL", - "PT", - "PR", - "QA", - "RE", - "RO", - "RU", - "RW", - "BL", - "SH", - "KN", - "LC", - "MF", - "PM", - "VC", - "WS", - "SM", - "ST", - "SA", - "SN", - "RS", - "SC", - "SL", - "SG", - "SX", - "SK", - "SI", - "SB", - "SO", - "ZA", - "GS", - "SS", - "ES", - "LK", - "SD", - "SR", - "SJ", - "SZ", - "SE", - "CH", - "SY", - "TW", - "TJ", - "TZ", - "TH", - "TL", - "TG", - "TK", - "TO", - "TT", - "TN", - "TR", - "TM", - "TC", - "TV", - "UG", - "UA", - "AE", - "GB", - "US", - "UM", - "UY", - "UZ", - "VU", - "VE", - "VN", - "VG", - "VI", - "WF", - "EH", - "YE", - "ZM", - "ZW" - ] - }, - "GeoMatchConstraints":{ - "type":"list", - "member":{"shape":"GeoMatchConstraint"} - }, - "GeoMatchSet":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "GeoMatchConstraints" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId for an GeoMatchSet. You use GeoMatchSetId to get information about a GeoMatchSet (see GeoMatchSet), update a GeoMatchSet (see UpdateGeoMatchSet), insert a GeoMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a GeoMatchSet from AWS WAF (see DeleteGeoMatchSet).

GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change the name of an GeoMatchSet after you create it.

" - }, - "GeoMatchConstraints":{ - "shape":"GeoMatchConstraints", - "documentation":"

An array of GeoMatchConstraint objects, which contain the country that you want AWS WAF to search for.

" - } - }, - "documentation":"

Contains one or more countries that AWS WAF will search for.

" - }, - "GeoMatchSetSummaries":{ - "type":"list", - "member":{"shape":"GeoMatchSetSummary"} - }, - "GeoMatchSetSummary":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "Name" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId for an GeoMatchSet. You can use GeoMatchSetId in a GetGeoMatchSet request to get detailed information about an GeoMatchSet.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change the name of an GeoMatchSet after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name of the GeoMatchSet.

" - }, - "GeoMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "GeoMatchConstraint" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a country with UpdateGeoMatchSet.

" - }, - "GeoMatchConstraint":{ - "shape":"GeoMatchConstraint", - "documentation":"

The country from which web requests originate that you want AWS WAF to search for.

" - } - }, - "documentation":"

Specifies the type of update to perform to an GeoMatchSet with UpdateGeoMatchSet.

" - }, - "GeoMatchSetUpdates":{ - "type":"list", - "member":{"shape":"GeoMatchSetUpdate"}, - "min":1 - }, - "GetByteMatchSetRequest":{ - "type":"structure", - "required":["ByteMatchSetId"], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to get. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - } - } - }, - "GetByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ByteMatchSet":{ - "shape":"ByteMatchSet", - "documentation":"

Information about the ByteMatchSet that you specified in the GetByteMatchSet request. For more information, see the following topics:

  • ByteMatchSet: Contains ByteMatchSetId, ByteMatchTuples, and Name

  • ByteMatchTuples: Contains an array of ByteMatchTuple objects. Each ByteMatchTuple object contains FieldToMatch, PositionalConstraint, TargetString, and TextTransformation

  • FieldToMatch: Contains Data and Type

" - } - } - }, - "GetChangeTokenRequest":{ - "type":"structure", - "members":{ - } - }, - "GetChangeTokenResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used in the request. Use this value in a GetChangeTokenStatus request to get the current status of the request.

" - } - } - }, - "GetChangeTokenStatusRequest":{ - "type":"structure", - "required":["ChangeToken"], - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The change token for which you want to get the status. This change token was previously returned in the GetChangeToken response.

" - } - } - }, - "GetChangeTokenStatusResponse":{ - "type":"structure", - "members":{ - "ChangeTokenStatus":{ - "shape":"ChangeTokenStatus", - "documentation":"

The status of the change token.

" - } - } - }, - "GetGeoMatchSetRequest":{ - "type":"structure", - "required":["GeoMatchSetId"], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId of the GeoMatchSet that you want to get. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - } - } - }, - "GetGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "GeoMatchSet":{ - "shape":"GeoMatchSet", - "documentation":"

Information about the GeoMatchSet that you specified in the GetGeoMatchSet request. This includes the Type, which for a GeoMatchContraint is always Country, as well as the Value, which is the identifier for a specific country.

" - } - } - }, - "GetIPSetRequest":{ - "type":"structure", - "required":["IPSetId"], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to get. IPSetId is returned by CreateIPSet and by ListIPSets.

" - } - } - }, - "GetIPSetResponse":{ - "type":"structure", - "members":{ - "IPSet":{ - "shape":"IPSet", - "documentation":"

Information about the IPSet that you specified in the GetIPSet request. For more information, see the following topics:

  • IPSet: Contains IPSetDescriptors, IPSetId, and Name

  • IPSetDescriptors: Contains an array of IPSetDescriptor objects. Each IPSetDescriptor object contains Type and Value

" - } - } - }, - "GetPermissionPolicyRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup for which you want to get the policy.

" - } - } - }, - "GetPermissionPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"PolicyString", - "documentation":"

The IAM policy attached to the specified RuleGroup.

" - } - } - }, - "GetRateBasedRuleManagedKeysRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule for which you want to get a list of ManagedKeys. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

A null value and not currently used. Do not include this in your request.

" - } - } - }, - "GetRateBasedRuleManagedKeysResponse":{ - "type":"structure", - "members":{ - "ManagedKeys":{ - "shape":"ManagedKeys", - "documentation":"

An array of IP addresses that currently are blocked by the specified RateBasedRule.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

A null value and not currently used.

" - } - } - }, - "GetRateBasedRuleRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to get. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - } - } - }, - "GetRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"RateBasedRule", - "documentation":"

Information about the RateBasedRule that you specified in the GetRateBasedRule request.

" - } - } - }, - "GetRegexMatchSetRequest":{ - "type":"structure", - "required":["RegexMatchSetId"], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to get. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - } - } - }, - "GetRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "RegexMatchSet":{ - "shape":"RegexMatchSet", - "documentation":"

Information about the RegexMatchSet that you specified in the GetRegexMatchSet request. For more information, see RegexMatchTuple.

" - } - } - }, - "GetRegexPatternSetRequest":{ - "type":"structure", - "required":["RegexPatternSetId"], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to get. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - } - } - }, - "GetRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "RegexPatternSet":{ - "shape":"RegexPatternSet", - "documentation":"

Information about the RegexPatternSet that you specified in the GetRegexPatternSet request, including the identifier of the pattern set and the regular expression patterns you want AWS WAF to search for.

" - } - } - }, - "GetRuleGroupRequest":{ - "type":"structure", - "required":["RuleGroupId"], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to get. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - } - } - }, - "GetRuleGroupResponse":{ - "type":"structure", - "members":{ - "RuleGroup":{ - "shape":"RuleGroup", - "documentation":"

Information about the RuleGroup that you specified in the GetRuleGroup request.

" - } - } - }, - "GetRuleRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to get. RuleId is returned by CreateRule and by ListRules.

" - } - } - }, - "GetRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"Rule", - "documentation":"

Information about the Rule that you specified in the GetRule request. For more information, see the following topics:

  • Rule: Contains MetricName, Name, an array of Predicate objects, and RuleId

  • Predicate: Each Predicate object contains DataId, Negated, and Type

" - } - } - }, - "GetSampledRequestsMaxItems":{ - "type":"long", - "max":500, - "min":1 - }, - "GetSampledRequestsRequest":{ - "type":"structure", - "required":[ - "WebAclId", - "RuleId", - "TimeWindow", - "MaxItems" - ], - "members":{ - "WebAclId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL for which you want GetSampledRequests to return a sample of requests.

" - }, - "RuleId":{ - "shape":"ResourceId", - "documentation":"

RuleId is one of three values:

  • The RuleId of the Rule or the RuleGroupId of the RuleGroup for which you want GetSampledRequests to return a sample of requests.

  • Default_Action, which causes GetSampledRequests to return a sample of the requests that didn't match any of the rules in the specified WebACL.

" - }, - "TimeWindow":{ - "shape":"TimeWindow", - "documentation":"

The start date and time and the end date and time of the range for which you want GetSampledRequests to return a sample of requests. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - }, - "MaxItems":{ - "shape":"GetSampledRequestsMaxItems", - "documentation":"

The number of requests that you want AWS WAF to return from among the first 5,000 requests that your AWS resource received during the time range. If your resource received fewer requests than the value of MaxItems, GetSampledRequests returns information about all of them.

" - } - } - }, - "GetSampledRequestsResponse":{ - "type":"structure", - "members":{ - "SampledRequests":{ - "shape":"SampledHTTPRequests", - "documentation":"

A complex type that contains detailed information about each of the requests in the sample.

" - }, - "PopulationSize":{ - "shape":"PopulationSize", - "documentation":"

The total number of requests from which GetSampledRequests got a sample of MaxItems requests. If PopulationSize is less than MaxItems, the sample includes every request that your AWS resource received during the specified time range.

" - }, - "TimeWindow":{ - "shape":"TimeWindow", - "documentation":"

Usually, TimeWindow is the time range that you specified in the GetSampledRequests request. However, if your AWS resource received more than 5,000 requests during the time range that you specified in the request, GetSampledRequests returns the time range for the first 5,000 requests.

" - } - } - }, - "GetSizeConstraintSetRequest":{ - "type":"structure", - "required":["SizeConstraintSetId"], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to get. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - } - } - }, - "GetSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "SizeConstraintSet":{ - "shape":"SizeConstraintSet", - "documentation":"

Information about the SizeConstraintSet that you specified in the GetSizeConstraintSet request. For more information, see the following topics:

" - } - } - }, - "GetSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":["SqlInjectionMatchSetId"], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to get. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - } - }, - "documentation":"

A request to get a SqlInjectionMatchSet.

" - }, - "GetSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "SqlInjectionMatchSet":{ - "shape":"SqlInjectionMatchSet", - "documentation":"

Information about the SqlInjectionMatchSet that you specified in the GetSqlInjectionMatchSet request. For more information, see the following topics:

" - } - }, - "documentation":"

The response to a GetSqlInjectionMatchSet request.

" - }, - "GetWebACLForResourceRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The ARN (Amazon Resource Name) of the resource for which to get the web ACL.

" - } - } - }, - "GetWebACLForResourceResponse":{ - "type":"structure", - "members":{ - "WebACLSummary":{ - "shape":"WebACLSummary", - "documentation":"

Information about the web ACL that you specified in the GetWebACLForResource request. If there is no associated resource, a null WebACLSummary is returned.

" - } - } - }, - "GetWebACLRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to get. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - } - } - }, - "GetWebACLResponse":{ - "type":"structure", - "members":{ - "WebACL":{ - "shape":"WebACL", - "documentation":"

Information about the WebACL that you specified in the GetWebACL request. For more information, see the following topics:

  • WebACL: Contains DefaultAction, MetricName, Name, an array of Rule objects, and WebACLId

  • DefaultAction (Data type is WafAction): Contains Type

  • Rules: Contains an array of ActivatedRule objects, which contain Action, Priority, and RuleId

  • Action: Contains Type

" - } - } - }, - "GetXssMatchSetRequest":{ - "type":"structure", - "required":["XssMatchSetId"], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to get. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - } - }, - "documentation":"

A request to get an XssMatchSet.

" - }, - "GetXssMatchSetResponse":{ - "type":"structure", - "members":{ - "XssMatchSet":{ - "shape":"XssMatchSet", - "documentation":"

Information about the XssMatchSet that you specified in the GetXssMatchSet request. For more information, see the following topics:

  • XssMatchSet: Contains Name, XssMatchSetId, and an array of XssMatchTuple objects

  • XssMatchTuple: Each XssMatchTuple object contains FieldToMatch and TextTransformation

  • FieldToMatch: Contains Data and Type

" - } - }, - "documentation":"

The response to a GetXssMatchSet request.

" - }, - "HTTPHeader":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"HeaderName", - "documentation":"

The name of one of the headers in the sampled web request.

" - }, - "Value":{ - "shape":"HeaderValue", - "documentation":"

The value of one of the headers in the sampled web request.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes an HTTPHeader complex type that appears as Headers in the response syntax. HTTPHeader contains the names and values of all of the headers that appear in one of the web requests that were returned by GetSampledRequests.

" - }, - "HTTPHeaders":{ - "type":"list", - "member":{"shape":"HTTPHeader"} - }, - "HTTPMethod":{"type":"string"}, - "HTTPRequest":{ - "type":"structure", - "members":{ - "ClientIP":{ - "shape":"IPString", - "documentation":"

The IP address that the request originated from. If the WebACL is associated with a CloudFront distribution, this is the value of one of the following fields in CloudFront access logs:

  • c-ip, if the viewer did not use an HTTP proxy or a load balancer to send the request

  • x-forwarded-for, if the viewer did use an HTTP proxy or a load balancer to send the request

" - }, - "Country":{ - "shape":"Country", - "documentation":"

The two-letter country code for the country that the request originated from. For a current list of country codes, see the Wikipedia entry ISO 3166-1 alpha-2.

" - }, - "URI":{ - "shape":"URIString", - "documentation":"

The part of a web request that identifies the resource, for example, /images/daily-ad.jpg.

" - }, - "Method":{ - "shape":"HTTPMethod", - "documentation":"

The HTTP method specified in the sampled web request. CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

" - }, - "HTTPVersion":{ - "shape":"HTTPVersion", - "documentation":"

The HTTP version specified in the sampled web request, for example, HTTP/1.1.

" - }, - "Headers":{ - "shape":"HTTPHeaders", - "documentation":"

A complex type that contains two values for each header in the sampled web request: the name of the header and the value of the header.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes an HTTPRequest complex type that appears as Request in the response syntax. HTTPRequest contains information about one of the web requests that were returned by GetSampledRequests.

" - }, - "HTTPVersion":{"type":"string"}, - "HeaderName":{"type":"string"}, - "HeaderValue":{"type":"string"}, - "IPSet":{ - "type":"structure", - "required":[ - "IPSetId", - "IPSetDescriptors" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId for an IPSet. You use IPSetId to get information about an IPSet (see GetIPSet), update an IPSet (see UpdateIPSet), insert an IPSet into a Rule or delete one from a Rule (see UpdateRule), and delete an IPSet from AWS WAF (see DeleteIPSet).

IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change the name of an IPSet after you create it.

" - }, - "IPSetDescriptors":{ - "shape":"IPSetDescriptors", - "documentation":"

The IP address type (IPV4 or IPV6) and the IP address range (in CIDR notation) that web requests originate from. If the WebACL is associated with a CloudFront distribution and the viewer did not use an HTTP proxy or a load balancer to send the request, this is the value of the c-ip field in the CloudFront access logs.

" - } - }, - "documentation":"

Contains one or more IP addresses or blocks of IP addresses specified in Classless Inter-Domain Routing (CIDR) notation. AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6.

To specify an individual IP address, you specify the four-part IP address followed by a /32, for example, 192.0.2.0/31. To block a range of IP addresses, you can specify a /128, /64, /56, /48, /32, /24, /16, or /8 CIDR. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

" - }, - "IPSetDescriptor":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"IPSetDescriptorType", - "documentation":"

Specify IPV4 or IPV6.

" - }, - "Value":{ - "shape":"IPSetDescriptorValue", - "documentation":"

Specify an IPv4 address by using CIDR notation. For example:

  • To configure AWS WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify 192.0.2.44/32.

  • To configure AWS WAF to allow, block, or count requests that originated from IP addresses from 192.0.2.0 to 192.0.2.255, specify 192.0.2.0/24.

For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

Specify an IPv6 address by using CIDR notation. For example:

  • To configure AWS WAF to allow, block, or count requests that originated from the IP address 1111:0000:0000:0000:0000:0000:0000:0111, specify 1111:0000:0000:0000:0000:0000:0000:0111/128.

  • To configure AWS WAF to allow, block, or count requests that originated from IP addresses 1111:0000:0000:0000:0000:0000:0000:0000 to 1111:0000:0000:0000:ffff:ffff:ffff:ffff, specify 1111:0000:0000:0000:0000:0000:0000:0000/64.

" - } - }, - "documentation":"

Specifies the IP address type (IPV4 or IPV6) and the IP address range (in CIDR format) that web requests originate from.

" - }, - "IPSetDescriptorType":{ - "type":"string", - "enum":[ - "IPV4", - "IPV6" - ] - }, - "IPSetDescriptorValue":{"type":"string"}, - "IPSetDescriptors":{ - "type":"list", - "member":{"shape":"IPSetDescriptor"} - }, - "IPSetSummaries":{ - "type":"list", - "member":{"shape":"IPSetSummary"} - }, - "IPSetSummary":{ - "type":"structure", - "required":[ - "IPSetId", - "Name" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId for an IPSet. You can use IPSetId in a GetIPSet request to get detailed information about an IPSet.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change the name of an IPSet after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name of the IPSet.

" - }, - "IPSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "IPSetDescriptor" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete an IP address with UpdateIPSet.

" - }, - "IPSetDescriptor":{ - "shape":"IPSetDescriptor", - "documentation":"

The IP address type (IPV4 or IPV6) and the IP address range (in CIDR notation) that web requests originate from.

" - } - }, - "documentation":"

Specifies the type of update to perform to an IPSet with UpdateIPSet.

" - }, - "IPSetUpdates":{ - "type":"list", - "member":{"shape":"IPSetUpdate"}, - "min":1 - }, - "IPString":{"type":"string"}, - "ListActivatedRulesInRuleGroupRequest":{ - "type":"structure", - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup for which you want to get a list of ActivatedRule objects.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ActivatedRules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ActivatedRules. For the second and subsequent ListActivatedRulesInRuleGroup requests, specify the value of NextMarker from the previous response to get information about another batch of ActivatedRules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of ActivatedRules that you want AWS WAF to return for this request. If you have more ActivatedRules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of ActivatedRules.

" - } - } - }, - "ListActivatedRulesInRuleGroupResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more ActivatedRules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more ActivatedRules, submit another ListActivatedRulesInRuleGroup request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "ActivatedRules":{ - "shape":"ActivatedRules", - "documentation":"

An array of ActivatedRules objects.

" - } - } - }, - "ListByteMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ByteMatchSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ByteMatchSets. For the second and subsequent ListByteMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of ByteMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of ByteMatchSet objects that you want AWS WAF to return for this request. If you have more ByteMatchSets objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of ByteMatchSet objects.

" - } - } - }, - "ListByteMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more ByteMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more ByteMatchSet objects, submit another ListByteMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "ByteMatchSets":{ - "shape":"ByteMatchSetSummaries", - "documentation":"

An array of ByteMatchSetSummary objects.

" - } - } - }, - "ListGeoMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more GeoMatchSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of GeoMatchSet objects. For the second and subsequent ListGeoMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of GeoMatchSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of GeoMatchSet objects that you want AWS WAF to return for this request. If you have more GeoMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of GeoMatchSet objects.

" - } - } - }, - "ListGeoMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more GeoMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more GeoMatchSet objects, submit another ListGeoMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "GeoMatchSets":{ - "shape":"GeoMatchSetSummaries", - "documentation":"

An array of GeoMatchSetSummary objects.

" - } - } - }, - "ListIPSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more IPSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of IPSets. For the second and subsequent ListIPSets requests, specify the value of NextMarker from the previous response to get information about another batch of IPSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of IPSet objects that you want AWS WAF to return for this request. If you have more IPSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of IPSet objects.

" - } - } - }, - "ListIPSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more IPSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more IPSet objects, submit another ListIPSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "IPSets":{ - "shape":"IPSetSummaries", - "documentation":"

An array of IPSetSummary objects.

" - } - } - }, - "ListRateBasedRulesRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more Rules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of Rules. For the second and subsequent ListRateBasedRules requests, specify the value of NextMarker from the previous response to get information about another batch of Rules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of Rules that you want AWS WAF to return for this request. If you have more Rules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - } - }, - "ListRateBasedRulesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more Rules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more Rules, submit another ListRateBasedRules request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "Rules":{ - "shape":"RuleSummaries", - "documentation":"

An array of RuleSummary objects.

" - } - } - }, - "ListRegexMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RegexMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ByteMatchSets. For the second and subsequent ListRegexMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of RegexMatchSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RegexMatchSet objects that you want AWS WAF to return for this request. If you have more RegexMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RegexMatchSet objects.

" - } - } - }, - "ListRegexMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RegexMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RegexMatchSet objects, submit another ListRegexMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RegexMatchSets":{ - "shape":"RegexMatchSetSummaries", - "documentation":"

An array of RegexMatchSetSummary objects.

" - } - } - }, - "ListRegexPatternSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RegexPatternSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of RegexPatternSet objects. For the second and subsequent ListRegexPatternSets requests, specify the value of NextMarker from the previous response to get information about another batch of RegexPatternSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RegexPatternSet objects that you want AWS WAF to return for this request. If you have more RegexPatternSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RegexPatternSet objects.

" - } - } - }, - "ListRegexPatternSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RegexPatternSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RegexPatternSet objects, submit another ListRegexPatternSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RegexPatternSets":{ - "shape":"RegexPatternSetSummaries", - "documentation":"

An array of RegexPatternSetSummary objects.

" - } - } - }, - "ListResourcesForWebACLRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The unique identifier (ID) of the web ACL for which to list the associated resources.

" - } - } - }, - "ListResourcesForWebACLResponse":{ - "type":"structure", - "members":{ - "ResourceArns":{ - "shape":"ResourceArns", - "documentation":"

An array of ARNs (Amazon Resource Names) of the resources associated with the specified web ACL. An array with zero elements is returned if there are no resources associated with the web ACL.

" - } - } - }, - "ListRuleGroupsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RuleGroups than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of RuleGroups. For the second and subsequent ListRuleGroups requests, specify the value of NextMarker from the previous response to get information about another batch of RuleGroups.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RuleGroups that you want AWS WAF to return for this request. If you have more RuleGroups than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RuleGroups.

" - } - } - }, - "ListRuleGroupsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RuleGroups than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RuleGroups, submit another ListRuleGroups request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RuleGroups":{ - "shape":"RuleGroupSummaries", - "documentation":"

An array of RuleGroup objects.

" - } - } - }, - "ListRulesRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more Rules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of Rules. For the second and subsequent ListRules requests, specify the value of NextMarker from the previous response to get information about another batch of Rules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of Rules that you want AWS WAF to return for this request. If you have more Rules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - } - }, - "ListRulesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more Rules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more Rules, submit another ListRules request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "Rules":{ - "shape":"RuleSummaries", - "documentation":"

An array of RuleSummary objects.

" - } - } - }, - "ListSizeConstraintSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more SizeConstraintSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of SizeConstraintSets. For the second and subsequent ListSizeConstraintSets requests, specify the value of NextMarker from the previous response to get information about another batch of SizeConstraintSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of SizeConstraintSet objects that you want AWS WAF to return for this request. If you have more SizeConstraintSets objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of SizeConstraintSet objects.

" - } - } - }, - "ListSizeConstraintSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more SizeConstraintSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more SizeConstraintSet objects, submit another ListSizeConstraintSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "SizeConstraintSets":{ - "shape":"SizeConstraintSetSummaries", - "documentation":"

An array of SizeConstraintSetSummary objects.

" - } - } - }, - "ListSqlInjectionMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more SqlInjectionMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of SqlInjectionMatchSets. For the second and subsequent ListSqlInjectionMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of SqlInjectionMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of SqlInjectionMatchSet objects that you want AWS WAF to return for this request. If you have more SqlInjectionMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - }, - "documentation":"

A request to list the SqlInjectionMatchSet objects created by the current AWS account.

" - }, - "ListSqlInjectionMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more SqlInjectionMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more SqlInjectionMatchSet objects, submit another ListSqlInjectionMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "SqlInjectionMatchSets":{ - "shape":"SqlInjectionMatchSetSummaries", - "documentation":"

An array of SqlInjectionMatchSetSummary objects.

" - } - }, - "documentation":"

The response to a ListSqlInjectionMatchSets request.

" - }, - "ListSubscribedRuleGroupsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ByteMatchSetssubscribed rule groups than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of subscribed rule groups. For the second and subsequent ListSubscribedRuleGroupsRequest requests, specify the value of NextMarker from the previous response to get information about another batch of subscribed rule groups.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of subscribed rule groups that you want AWS WAF to return for this request. If you have more objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of objects.

" - } - } - }, - "ListSubscribedRuleGroupsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more objects, submit another ListSubscribedRuleGroups request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RuleGroups":{ - "shape":"SubscribedRuleGroupSummaries", - "documentation":"

An array of RuleGroup objects.

" - } - } - }, - "ListWebACLsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more WebACL objects than the number that you specify for Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of WebACL objects. For the second and subsequent ListWebACLs requests, specify the value of NextMarker from the previous response to get information about another batch of WebACL objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of WebACL objects that you want AWS WAF to return for this request. If you have more WebACL objects than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of WebACL objects.

" - } - } - }, - "ListWebACLsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more WebACL objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more WebACL objects, submit another ListWebACLs request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "WebACLs":{ - "shape":"WebACLSummaries", - "documentation":"

An array of WebACLSummary objects.

" - } - } - }, - "ListXssMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more XssMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of XssMatchSets. For the second and subsequent ListXssMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of XssMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of XssMatchSet objects that you want AWS WAF to return for this request. If you have more XssMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - }, - "documentation":"

A request to list the XssMatchSet objects created by the current AWS account.

" - }, - "ListXssMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more XssMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more XssMatchSet objects, submit another ListXssMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "XssMatchSets":{ - "shape":"XssMatchSetSummaries", - "documentation":"

An array of XssMatchSetSummary objects.

" - } - }, - "documentation":"

The response to a ListXssMatchSets request.

" - }, - "ManagedKey":{"type":"string"}, - "ManagedKeys":{ - "type":"list", - "member":{"shape":"ManagedKey"} - }, - "MatchFieldData":{"type":"string"}, - "MatchFieldType":{ - "type":"string", - "enum":[ - "URI", - "QUERY_STRING", - "HEADER", - "METHOD", - "BODY" - ] - }, - "MetricName":{"type":"string"}, - "Negated":{"type":"boolean"}, - "NextMarker":{ - "type":"string", - "min":1 - }, - "PaginationLimit":{ - "type":"integer", - "max":100, - "min":0 - }, - "ParameterExceptionField":{ - "type":"string", - "enum":[ - "CHANGE_ACTION", - "WAF_ACTION", - "WAF_OVERRIDE_ACTION", - "PREDICATE_TYPE", - "IPSET_TYPE", - "BYTE_MATCH_FIELD_TYPE", - "SQL_INJECTION_MATCH_FIELD_TYPE", - "BYTE_MATCH_TEXT_TRANSFORMATION", - "BYTE_MATCH_POSITIONAL_CONSTRAINT", - "SIZE_CONSTRAINT_COMPARISON_OPERATOR", - "GEO_MATCH_LOCATION_TYPE", - "GEO_MATCH_LOCATION_VALUE", - "RATE_KEY", - "RULE_TYPE", - "NEXT_MARKER" - ] - }, - "ParameterExceptionParameter":{ - "type":"string", - "min":1 - }, - "ParameterExceptionReason":{ - "type":"string", - "enum":[ - "INVALID_OPTION", - "ILLEGAL_COMBINATION" - ] - }, - "PolicyString":{ - "type":"string", - "min":1 - }, - "PopulationSize":{"type":"long"}, - "PositionalConstraint":{ - "type":"string", - "enum":[ - "EXACTLY", - "STARTS_WITH", - "ENDS_WITH", - "CONTAINS", - "CONTAINS_WORD" - ] - }, - "Predicate":{ - "type":"structure", - "required":[ - "Negated", - "Type", - "DataId" - ], - "members":{ - "Negated":{ - "shape":"Negated", - "documentation":"

Set Negated to False if you want AWS WAF to allow, block, or count requests based on the settings in the specified ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, or SizeConstraintSet. For example, if an IPSet includes the IP address 192.0.2.44, AWS WAF will allow or block requests based on that IP address.

Set Negated to True if you want AWS WAF to allow or block a request based on the negation of the settings in the ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, or SizeConstraintSet. For example, if an IPSet includes the IP address 192.0.2.44, AWS WAF will allow, block, or count requests based on all IP addresses except 192.0.2.44.

" - }, - "Type":{ - "shape":"PredicateType", - "documentation":"

The type of predicate in a Rule, such as ByteMatchSet or IPSet.

" - }, - "DataId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a predicate in a Rule, such as ByteMatchSetId or IPSetId. The ID is returned by the corresponding Create or List command.

" - } - }, - "documentation":"

Specifies the ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, and SizeConstraintSet objects that you want to add to a Rule and, for each object, indicates whether you want to negate the settings, for example, requests that do NOT originate from the IP address 192.0.2.44.

" - }, - "PredicateType":{ - "type":"string", - "enum":[ - "IPMatch", - "ByteMatch", - "SqlInjectionMatch", - "GeoMatch", - "SizeConstraint", - "XssMatch", - "RegexMatch" - ] - }, - "Predicates":{ - "type":"list", - "member":{"shape":"Predicate"} - }, - "PutPermissionPolicyRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Policy" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup to which you want to attach the policy.

" - }, - "Policy":{ - "shape":"PolicyString", - "documentation":"

The policy to attach to the specified RuleGroup.

" - } - } - }, - "PutPermissionPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "RateBasedRule":{ - "type":"structure", - "required":[ - "RuleId", - "MatchPredicates", - "RateKey", - "RateLimit" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RateBasedRule. You use RuleId to get more information about a RateBasedRule (see GetRateBasedRule), update a RateBasedRule (see UpdateRateBasedRule), insert a RateBasedRule into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a RateBasedRule from AWS WAF (see DeleteRateBasedRule).

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for a RateBasedRule. You can't change the name of a RateBasedRule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for a RateBasedRule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RateBasedRule.

" - }, - "MatchPredicates":{ - "shape":"Predicates", - "documentation":"

The Predicates object contains one Predicate element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in a RateBasedRule.

" - }, - "RateKey":{ - "shape":"RateKey", - "documentation":"

The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value for RateKey is IP. IP indicates that requests arriving from the same IP address are subject to the RateLimit that is specified in the RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field specified by the RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - } - }, - "documentation":"

A RateBasedRule is identical to a regular Rule, with one addition: a RateBasedRule counts the number of requests that arrive from a specified IP address every five minutes. For example, based on recent requests that you've seen from an attacker, you might create a RateBasedRule that includes the following conditions:

  • The requests come from 192.0.2.44.

  • They contain the value BadBot in the User-Agent header.

In the rule, you also define the rate limit as 15,000.

Requests that meet both of these conditions and exceed 15,000 requests every five minutes trigger the rule's action (block or count), which is defined in the web ACL.

" - }, - "RateKey":{ - "type":"string", - "enum":["IP"] - }, - "RateLimit":{ - "type":"long", - "min":2000 - }, - "RegexMatchSet":{ - "type":"structure", - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId for a RegexMatchSet. You use RegexMatchSetId to get information about a RegexMatchSet (see GetRegexMatchSet), update a RegexMatchSet (see UpdateRegexMatchSet), insert a RegexMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a RegexMatchSet from AWS WAF (see DeleteRegexMatchSet).

RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - }, - "RegexMatchTuples":{ - "shape":"RegexMatchTuples", - "documentation":"

Contains an array of RegexMatchTuple objects. Each RegexMatchTuple object contains:

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

" - } - }, - "documentation":"

In a GetRegexMatchSet request, RegexMatchSet is a complex type that contains the RegexMatchSetId and Name of a RegexMatchSet, and the values that you specified when you updated the RegexMatchSet.

The values are contained in a RegexMatchTuple object, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a RegexMatchSet contains more than one RegexMatchTuple object, a request needs to match the settings in only one ByteMatchTuple to be considered a match.

" - }, - "RegexMatchSetSummaries":{ - "type":"list", - "member":{"shape":"RegexMatchSetSummary"} - }, - "RegexMatchSetSummary":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "Name" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId for a RegexMatchSet. You use RegexMatchSetId to get information about a RegexMatchSet, update a RegexMatchSet, remove a RegexMatchSet from a Rule, and delete a RegexMatchSet from AWS WAF.

RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - } - }, - "documentation":"

Returned by ListRegexMatchSets. Each RegexMatchSetSummary object includes the Name and RegexMatchSetId for one RegexMatchSet.

" - }, - "RegexMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "RegexMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a RegexMatchTuple.

" - }, - "RegexMatchTuple":{ - "shape":"RegexMatchTuple", - "documentation":"

Information about the part of a web request that you want AWS WAF to inspect and the identifier of the regular expression (regex) pattern that you want AWS WAF to search for. If you specify DELETE for the value of Action, the RegexMatchTuple values must exactly match the values in the RegexMatchTuple that you want to delete from the RegexMatchSet.

" - } - }, - "documentation":"

In an UpdateRegexMatchSet request, RegexMatchSetUpdate specifies whether to insert or delete a RegexMatchTuple and includes the settings for the RegexMatchTuple.

" - }, - "RegexMatchSetUpdates":{ - "type":"list", - "member":{"shape":"RegexMatchSetUpdate"}, - "min":1 - }, - "RegexMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation", - "RegexPatternSetId" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for the RegexPatternSet.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on RegexPatternSet before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - }, - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId for a RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet (see GetRegexPatternSet), update a RegexPatternSet (see UpdateRegexPatternSet), insert a RegexPatternSet into a RegexMatchSet or delete one from a RegexMatchSet (see UpdateRegexMatchSet), and delete an RegexPatternSet from AWS WAF (see DeleteRegexPatternSet).

RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - } - }, - "documentation":"

The regular expression pattern that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings. Each RegexMatchTuple object contains:

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

" - }, - "RegexMatchTuples":{ - "type":"list", - "member":{"shape":"RegexMatchTuple"} - }, - "RegexPatternSet":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "RegexPatternStrings" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The identifier for the RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet, update a RegexPatternSet, remove a RegexPatternSet from a RegexMatchSet, and delete a RegexPatternSet from AWS WAF.

RegexMatchSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - }, - "RegexPatternStrings":{ - "shape":"RegexPatternStrings", - "documentation":"

Specifies the regular expression (regex) patterns that you want AWS WAF to search for, such as B[a@]dB[o0]t.

" - } - }, - "documentation":"

The RegexPatternSet specifies the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

" - }, - "RegexPatternSetSummaries":{ - "type":"list", - "member":{"shape":"RegexPatternSetSummary"} - }, - "RegexPatternSetSummary":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "Name" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId for a RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet, update a RegexPatternSet, remove a RegexPatternSet from a RegexMatchSet, and delete a RegexPatternSet from AWS WAF.

RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - } - }, - "documentation":"

Returned by ListRegexPatternSets. Each RegexPatternSetSummary object includes the Name and RegexPatternSetId for one RegexPatternSet.

" - }, - "RegexPatternSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "RegexPatternString" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a RegexPatternString.

" - }, - "RegexPatternString":{ - "shape":"RegexPatternString", - "documentation":"

Specifies the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t.

" - } - }, - "documentation":"

In an UpdateRegexPatternSet request, RegexPatternSetUpdate specifies whether to insert or delete a RegexPatternString and includes the settings for the RegexPatternString.

" - }, - "RegexPatternSetUpdates":{ - "type":"list", - "member":{"shape":"RegexPatternSetUpdate"}, - "min":1 - }, - "RegexPatternString":{ - "type":"string", - "min":1 - }, - "RegexPatternStrings":{ - "type":"list", - "member":{"shape":"RegexPatternString"}, - "max":10 - }, - "ResourceArn":{ - "type":"string", - "max":1224, - "min":1 - }, - "ResourceArns":{ - "type":"list", - "member":{"shape":"ResourceArn"} - }, - "ResourceId":{ - "type":"string", - "max":128, - "min":1 - }, - "ResourceName":{ - "type":"string", - "max":128, - "min":1 - }, - "Rule":{ - "type":"structure", - "required":[ - "RuleId", - "Predicates" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The friendly name or description for the Rule. You can't change the name of a Rule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this Rule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the Rule.

" - }, - "Predicates":{ - "shape":"Predicates", - "documentation":"

The Predicates object contains one Predicate element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in a Rule.

" - } - }, - "documentation":"

A combination of ByteMatchSet, IPSet, and/or SqlInjectionMatchSet objects that identify the web requests that you want to allow, block, or count. For example, you might create a Rule that includes the following predicates:

  • An IPSet that causes AWS WAF to search for web requests that originate from the IP address 192.0.2.44

  • A ByteMatchSet that causes AWS WAF to search for web requests for which the value of the User-Agent header is BadBot.

To match the settings in this Rule, a request must originate from 192.0.2.44 AND include a User-Agent header for which the value is BadBot.

" - }, - "RuleGroup":{ - "type":"structure", - "required":["RuleGroupId"], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup. You use RuleGroupId to get more information about a RuleGroup (see GetRuleGroup), update a RuleGroup (see UpdateRuleGroup), insert a RuleGroup into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a RuleGroup from AWS WAF (see DeleteRuleGroup).

RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The friendly name or description for the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - } - }, - "documentation":"

A collection of predefined rules that you can add to a web ACL.

Rule groups are subject to the following limits:

  • Three rule groups per account. You can request an increase to this limit by contacting customer support.

  • One rule group per web ACL.

  • Ten rules per rule group.

" - }, - "RuleGroupSummaries":{ - "type":"list", - "member":{"shape":"RuleGroupSummary"} - }, - "RuleGroupSummary":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Name" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup. You use RuleGroupId to get more information about a RuleGroup (see GetRuleGroup), update a RuleGroup (see UpdateRuleGroup), insert a RuleGroup into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a RuleGroup from AWS WAF (see DeleteRuleGroup).

RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - } - }, - "documentation":"

Contains the identifier and the friendly name or description of the RuleGroup.

" - }, - "RuleGroupUpdate":{ - "type":"structure", - "required":[ - "Action", - "ActivatedRule" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add an ActivatedRule to a RuleGroup. Use DELETE to remove an ActivatedRule from a RuleGroup.

" - }, - "ActivatedRule":{ - "shape":"ActivatedRule", - "documentation":"

The ActivatedRule object specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

" - } - }, - "documentation":"

Specifies an ActivatedRule and indicates whether you want to add it to a RuleGroup or delete it from a RuleGroup.

" - }, - "RuleGroupUpdates":{ - "type":"list", - "member":{"shape":"RuleGroupUpdate"}, - "min":1 - }, - "RulePriority":{"type":"integer"}, - "RuleSummaries":{ - "type":"list", - "member":{"shape":"RuleSummary"} - }, - "RuleSummary":{ - "type":"structure", - "required":[ - "RuleId", - "Name" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the Rule. You can't change the name of a Rule after you create it.

" - } - }, - "documentation":"

Contains the identifier and the friendly name or description of the Rule.

" - }, - "RuleUpdate":{ - "type":"structure", - "required":[ - "Action", - "Predicate" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a Predicate to a Rule. Use DELETE to remove a Predicate from a Rule.

" - }, - "Predicate":{ - "shape":"Predicate", - "documentation":"

The ID of the Predicate (such as an IPSet) that you want to add to a Rule.

" - } - }, - "documentation":"

Specifies a Predicate (such as an IPSet) and indicates whether you want to add it to a Rule or delete it from a Rule.

" - }, - "RuleUpdates":{ - "type":"list", - "member":{"shape":"RuleUpdate"} - }, - "SampleWeight":{ - "type":"long", - "min":0 - }, - "SampledHTTPRequest":{ - "type":"structure", - "required":[ - "Request", - "Weight" - ], - "members":{ - "Request":{ - "shape":"HTTPRequest", - "documentation":"

A complex type that contains detailed information about the request.

" - }, - "Weight":{ - "shape":"SampleWeight", - "documentation":"

A value that indicates how one result in the response relates proportionally to other results in the response. A result that has a weight of 2 represents roughly twice as many CloudFront web requests as a result that has a weight of 1.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which AWS WAF received the request from your AWS resource, in Unix time format (in seconds).

" - }, - "Action":{ - "shape":"Action", - "documentation":"

The action for the Rule that the request matched: ALLOW, BLOCK, or COUNT.

" - }, - "RuleWithinRuleGroup":{ - "shape":"ResourceId", - "documentation":"

This value is returned if the GetSampledRequests request specifies the ID of a RuleGroup rather than the ID of an individual rule. RuleWithinRuleGroup is the rule within the specified RuleGroup that matched the request listed in the response.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes a SampledHTTPRequests complex type that appears as SampledRequests in the response syntax. SampledHTTPRequests contains one SampledHTTPRequest object for each web request that is returned by GetSampledRequests.

" - }, - "SampledHTTPRequests":{ - "type":"list", - "member":{"shape":"SampledHTTPRequest"} - }, - "Size":{ - "type":"long", - "max":21474836480, - "min":0 - }, - "SizeConstraint":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation", - "ComparisonOperator", - "Size" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for the size constraint.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

Note that if you choose BODY for the value of Type, you must choose NONE for TextTransformation because CloudFront forwards only the first 8192 bytes for inspection.

NONE

Specify NONE if you don't want to perform any text transformations.

CMD_LINE

When you're concerned that attackers are injecting an operating system command line command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The type of comparison you want AWS WAF to perform. AWS WAF uses this in combination with the provided Size and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

EQ: Used to test if the Size is equal to the size of the FieldToMatch

NE: Used to test if the Size is not equal to the size of the FieldToMatch

LE: Used to test if the Size is less than or equal to the size of the FieldToMatch

LT: Used to test if the Size is strictly less than the size of the FieldToMatch

GE: Used to test if the Size is greater than or equal to the size of the FieldToMatch

GT: Used to test if the Size is strictly greater than the size of the FieldToMatch

" - }, - "Size":{ - "shape":"Size", - "documentation":"

The size in bytes that you want AWS WAF to compare against the size of the specified FieldToMatch. AWS WAF uses this in combination with ComparisonOperator and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

Valid values for size are 0 - 21474836480 bytes (0 - 20 GB).

If you specify URI for the value of Type, the / in the URI counts as one character. For example, the URI /logo.jpg is nine characters long.

" - } - }, - "documentation":"

Specifies a constraint on the size of a part of the web request. AWS WAF uses the Size, ComparisonOperator, and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

" - }, - "SizeConstraintSet":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "SizeConstraints" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SizeConstraintSet. You use SizeConstraintSetId to get information about a SizeConstraintSet (see GetSizeConstraintSet), update a SizeConstraintSet (see UpdateSizeConstraintSet), insert a SizeConstraintSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SizeConstraintSet from AWS WAF (see DeleteSizeConstraintSet).

SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the SizeConstraintSet.

" - }, - "SizeConstraints":{ - "shape":"SizeConstraints", - "documentation":"

Specifies the parts of web requests that you want to inspect the size of.

" - } - }, - "documentation":"

A complex type that contains SizeConstraint objects, which specify the parts of web requests that you want AWS WAF to inspect the size of. If a SizeConstraintSet contains more than one SizeConstraint object, a request only needs to match one constraint to be considered a match.

" - }, - "SizeConstraintSetSummaries":{ - "type":"list", - "member":{"shape":"SizeConstraintSetSummary"} - }, - "SizeConstraintSetSummary":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "Name" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SizeConstraintSet. You use SizeConstraintSetId to get information about a SizeConstraintSet (see GetSizeConstraintSet), update a SizeConstraintSet (see UpdateSizeConstraintSet), insert a SizeConstraintSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SizeConstraintSet from AWS WAF (see DeleteSizeConstraintSet).

SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the SizeConstraintSet, if any.

" - } - }, - "documentation":"

The Id and Name of a SizeConstraintSet.

" - }, - "SizeConstraintSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "SizeConstraint" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a SizeConstraintSetUpdate to a SizeConstraintSet. Use DELETE to remove a SizeConstraintSetUpdate from a SizeConstraintSet.

" - }, - "SizeConstraint":{ - "shape":"SizeConstraint", - "documentation":"

Specifies a constraint on the size of a part of the web request. AWS WAF uses the Size, ComparisonOperator, and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect the size of and indicates whether you want to add the specification to a SizeConstraintSet or delete it from a SizeConstraintSet.

" - }, - "SizeConstraintSetUpdates":{ - "type":"list", - "member":{"shape":"SizeConstraintSetUpdate"}, - "min":1 - }, - "SizeConstraints":{ - "type":"list", - "member":{"shape":"SizeConstraint"} - }, - "SqlInjectionMatchSet":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "SqlInjectionMatchTuples" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SqlInjectionMatchSet. You use SqlInjectionMatchSetId to get information about a SqlInjectionMatchSet (see GetSqlInjectionMatchSet), update a SqlInjectionMatchSet (see UpdateSqlInjectionMatchSet), insert a SqlInjectionMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SqlInjectionMatchSet from AWS WAF (see DeleteSqlInjectionMatchSet).

SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchTuples":{ - "shape":"SqlInjectionMatchTuples", - "documentation":"

Specifies the parts of web requests that you want to inspect for snippets of malicious SQL code.

" - } - }, - "documentation":"

A complex type that contains SqlInjectionMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header. If a SqlInjectionMatchSet contains more than one SqlInjectionMatchTuple object, a request needs to include snippets of SQL code in only one of the specified parts of the request to be considered a match.

" - }, - "SqlInjectionMatchSetSummaries":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchSetSummary"} - }, - "SqlInjectionMatchSetSummary":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "Name" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SqlInjectionMatchSet. You use SqlInjectionMatchSetId to get information about a SqlInjectionMatchSet (see GetSqlInjectionMatchSet), update a SqlInjectionMatchSet (see UpdateSqlInjectionMatchSet), insert a SqlInjectionMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SqlInjectionMatchSet from AWS WAF (see DeleteSqlInjectionMatchSet).

SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the SqlInjectionMatchSet, if any, specified by Id.

" - } - }, - "documentation":"

The Id and Name of a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "SqlInjectionMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a SqlInjectionMatchSetUpdate to a SqlInjectionMatchSet. Use DELETE to remove a SqlInjectionMatchSetUpdate from a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchTuple":{ - "shape":"SqlInjectionMatchTuple", - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect for snippets of malicious SQL code and indicates whether you want to add the specification to a SqlInjectionMatchSet or delete it from a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchSetUpdates":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchSetUpdate"}, - "min":1 - }, - "SqlInjectionMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for snippets of malicious SQL code.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - } - }, - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header.

" - }, - "SqlInjectionMatchTuples":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchTuple"} - }, - "SubscribedRuleGroupSummaries":{ - "type":"list", - "member":{"shape":"SubscribedRuleGroupSummary"} - }, - "SubscribedRuleGroupSummary":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Name", - "MetricName" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - } - }, - "documentation":"

A summary of the rule groups you are subscribed to.

" - }, - "TextTransformation":{ - "type":"string", - "enum":[ - "NONE", - "COMPRESS_WHITE_SPACE", - "HTML_ENTITY_DECODE", - "LOWERCASE", - "CMD_LINE", - "URL_DECODE" - ] - }, - "TimeWindow":{ - "type":"structure", - "required":[ - "StartTime", - "EndTime" - ], - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The beginning of the time range from which you want GetSampledRequests to return a sample of the requests that your AWS resource received. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time range from which you want GetSampledRequests to return a sample of the requests that your AWS resource received. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - } - }, - "documentation":"

In a GetSampledRequests request, the StartTime and EndTime objects specify the time range for which you want AWS WAF to return a sample of web requests.

In a GetSampledRequests response, the StartTime and EndTime objects specify the time range for which AWS WAF actually returned a sample of web requests. AWS WAF gets the specified number of requests from among the first 5,000 requests that your AWS resource receives during the specified time period. If your resource receives more than 5,000 requests during that period, AWS WAF stops sampling after the 5,000th request. In that case, EndTime is the time that AWS WAF received the 5,000th request.

" - }, - "Timestamp":{"type":"timestamp"}, - "URIString":{"type":"string"}, - "UpdateByteMatchSetRequest":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to update. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"ByteMatchSetUpdates", - "documentation":"

An array of ByteMatchSetUpdate objects that you want to insert into or delete from a ByteMatchSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId of the GeoMatchSet that you want to update. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"GeoMatchSetUpdates", - "documentation":"

An array of GeoMatchSetUpdate objects that you want to insert into or delete from an GeoMatchSet. For more information, see the applicable data types:

  • GeoMatchSetUpdate: Contains Action and GeoMatchConstraint

  • GeoMatchConstraint: Contains Type and Value

    You can have only one Type and Value per GeoMatchConstraint. To add multiple countries, include multiple GeoMatchSetUpdate objects in your request.

" - } - } - }, - "UpdateGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateIPSetRequest":{ - "type":"structure", - "required":[ - "IPSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to update. IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"IPSetUpdates", - "documentation":"

An array of IPSetUpdate objects that you want to insert into or delete from an IPSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateIPSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken", - "Updates", - "RateLimit" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to update. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"RuleUpdates", - "documentation":"

An array of RuleUpdate objects that you want to insert into or delete from a RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field specified by the RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - } - } - }, - "UpdateRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "Updates", - "ChangeToken" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to update. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Updates":{ - "shape":"RegexMatchSetUpdates", - "documentation":"

An array of RegexMatchSetUpdate objects that you want to insert into or delete from a RegexMatchSet. For more information, see RegexMatchTuple.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "Updates", - "ChangeToken" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to update. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Updates":{ - "shape":"RegexPatternSetUpdates", - "documentation":"

An array of RegexPatternSetUpdate objects that you want to insert into or delete from a RegexPatternSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRuleGroupRequest":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Updates", - "ChangeToken" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to update. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Updates":{ - "shape":"RuleGroupUpdates", - "documentation":"

An array of RuleGroupUpdate objects that you want to insert into or delete from a RuleGroup.

You can only insert REGULAR rules into a rule group.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRuleGroupResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken", - "Updates" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to update. RuleId is returned by CreateRule and by ListRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"RuleUpdates", - "documentation":"

An array of RuleUpdate objects that you want to insert into or delete from a Rule. For more information, see the applicable data types:

" - } - } - }, - "UpdateRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to update. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"SizeConstraintSetUpdates", - "documentation":"

An array of SizeConstraintSetUpdate objects that you want to insert into or delete from a SizeConstraintSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to update. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"SqlInjectionMatchSetUpdates", - "documentation":"

An array of SqlInjectionMatchSetUpdate objects that you want to insert into or delete from a SqlInjectionMatchSet. For more information, see the applicable data types:

" - } - }, - "documentation":"

A request to update a SqlInjectionMatchSet.

" - }, - "UpdateSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to an UpdateSqlInjectionMatchSets request.

" - }, - "UpdateWebACLRequest":{ - "type":"structure", - "required":[ - "WebACLId", - "ChangeToken" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to update. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"WebACLUpdates", - "documentation":"

An array of updates to make to the WebACL.

An array of WebACLUpdate objects that you want to insert into or delete from a WebACL. For more information, see the applicable data types:

  • WebACLUpdate: Contains Action and ActivatedRule

  • ActivatedRule: Contains Action, OverrideAction, Priority, RuleId, and Type. ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

  • WafAction: Contains Type

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

A default action for the web ACL, either ALLOW or BLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of the rules in a web ACL.

" - } - } - }, - "UpdateWebACLResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateXssMatchSetRequest":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to update. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"XssMatchSetUpdates", - "documentation":"

An array of XssMatchSetUpdate objects that you want to insert into or delete from a XssMatchSet. For more information, see the applicable data types:

" - } - }, - "documentation":"

A request to update an XssMatchSet.

" - }, - "UpdateXssMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to an UpdateXssMatchSets request.

" - }, - "WAFDisallowedNameException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The name specified is invalid.

", - "exception":true - }, - "WAFInternalErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because of a system problem, even though the request was valid. Retry your request.

", - "exception":true, - "fault":true - }, - "WAFInvalidAccountException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation failed because you tried to create, update, or delete an object by using an invalid account identifier.

", - "exception":true - }, - "WAFInvalidOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because there was nothing to do. For example:

  • You tried to remove a Rule from a WebACL, but the Rule isn't in the specified WebACL.

  • You tried to remove an IP address from an IPSet, but the IP address isn't in the specified IPSet.

  • You tried to remove a ByteMatchTuple from a ByteMatchSet, but the ByteMatchTuple isn't in the specified WebACL.

  • You tried to add a Rule to a WebACL, but the Rule already exists in the specified WebACL.

  • You tried to add an IP address to an IPSet, but the IP address already exists in the specified IPSet.

  • You tried to add a ByteMatchTuple to a ByteMatchSet, but the ByteMatchTuple already exists in the specified WebACL.

", - "exception":true - }, - "WAFInvalidParameterException":{ - "type":"structure", - "members":{ - "field":{"shape":"ParameterExceptionField"}, - "parameter":{"shape":"ParameterExceptionParameter"}, - "reason":{"shape":"ParameterExceptionReason"} - }, - "documentation":"

The operation failed because AWS WAF didn't recognize a parameter in the request. For example:

  • You specified an invalid parameter name.

  • You specified an invalid value.

  • You tried to update an object (ByteMatchSet, IPSet, Rule, or WebACL) using an action other than INSERT or DELETE.

  • You tried to create a WebACL with a DefaultAction Type other than ALLOW, BLOCK, or COUNT.

  • You tried to create a RateBasedRule with a RateKey value other than IP.

  • You tried to update a WebACL with a WafAction Type other than ALLOW, BLOCK, or COUNT.

  • You tried to update a ByteMatchSet with a FieldToMatch Type other than HEADER, METHOD, QUERY_STRING, URI, or BODY.

  • You tried to update a ByteMatchSet with a Field of HEADER but no value for Data.

  • Your request references an ARN that is malformed, or corresponds to a resource with which a web ACL cannot be associated.

", - "exception":true - }, - "WAFInvalidPermissionPolicyException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because the specified policy is not in the proper format.

The policy is subject to the following restrictions:

  • You can attach only one policy with each PutPermissionPolicy request.

  • The policy must include an Effect, Action and Principal.

  • Effect must specify Allow.

  • The Action in the policy must be waf:UpdateWebACL or waf-regional:UpdateWebACL. Any extra or wildcard actions in the policy will be rejected.

  • The policy cannot include a Resource parameter.

  • The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

  • The user making the request must be the owner of the RuleGroup.

  • Your policy must be composed using IAM Policy version 2012-10-17.

", - "exception":true - }, - "WAFInvalidRegexPatternException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The regular expression (regex) you specified in RegexPatternString is invalid.

", - "exception":true - }, - "WAFLimitsExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation exceeds a resource limit, for example, the maximum number of WebACL objects that you can create for an AWS account. For more information, see Limits in the AWS WAF Developer Guide.

", - "exception":true - }, - "WAFNonEmptyEntityException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to delete an object that isn't empty. For example:

  • You tried to delete a WebACL that still contains one or more Rule objects.

  • You tried to delete a Rule that still contains one or more ByteMatchSet objects or other predicates.

  • You tried to delete a ByteMatchSet that contains one or more ByteMatchTuple objects.

  • You tried to delete an IPSet that references one or more IP addresses.

", - "exception":true - }, - "WAFNonexistentContainerException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to add an object to or delete an object from another object that doesn't exist. For example:

  • You tried to add a Rule to or delete a Rule from a WebACL that doesn't exist.

  • You tried to add a ByteMatchSet to or delete a ByteMatchSet from a Rule that doesn't exist.

  • You tried to add an IP address to or delete an IP address from an IPSet that doesn't exist.

  • You tried to add a ByteMatchTuple to or delete a ByteMatchTuple from a ByteMatchSet that doesn't exist.

", - "exception":true - }, - "WAFNonexistentItemException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because the referenced object doesn't exist.

", - "exception":true - }, - "WAFReferencedItemException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to delete an object that is still in use. For example:

  • You tried to delete a ByteMatchSet that is still referenced by a Rule.

  • You tried to delete a Rule that is still referenced by a WebACL.

", - "exception":true - }, - "WAFStaleDataException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to create, update, or delete an object by using a change token that has already been used.

", - "exception":true - }, - "WAFSubscriptionNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The specified subscription does not exist.

", - "exception":true - }, - "WAFUnavailableEntityException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because the entity referenced is temporarily unavailable. Retry your request.

", - "exception":true - }, - "WafAction":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"WafActionType", - "documentation":"

Specifies how you want AWS WAF to respond to requests that match the settings in a Rule. Valid settings include the following:

  • ALLOW: AWS WAF allows requests

  • BLOCK: AWS WAF blocks requests

  • COUNT: AWS WAF increments a counter of the requests that match all of the conditions in the rule. AWS WAF then continues to inspect the web request based on the remaining rules in the web ACL. You can't specify COUNT for the default action for a WebACL.

" - } - }, - "documentation":"

For the action that is associated with a rule in a WebACL, specifies the action that you want AWS WAF to perform when a web request matches all of the conditions in a rule. For the default action in a WebACL, specifies the action that you want AWS WAF to take when a web request doesn't match all of the conditions in any of the rules in a WebACL.

" - }, - "WafActionType":{ - "type":"string", - "enum":[ - "BLOCK", - "ALLOW", - "COUNT" - ] - }, - "WafOverrideAction":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"WafOverrideActionType", - "documentation":"

COUNT overrides the action specified by the individual rule within a RuleGroup . If set to NONE, the rule's action will take place.

" - } - }, - "documentation":"

The action to take if any rule within the RuleGroup matches a request.

" - }, - "WafOverrideActionType":{ - "type":"string", - "enum":[ - "NONE", - "COUNT" - ] - }, - "WafRuleType":{ - "type":"string", - "enum":[ - "REGULAR", - "RATE_BASED", - "GROUP" - ] - }, - "WebACL":{ - "type":"structure", - "required":[ - "WebACLId", - "DefaultAction", - "Rules" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this WebACL. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the WebACL.

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.

" - }, - "Rules":{ - "shape":"ActivatedRules", - "documentation":"

An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

" - } - }, - "documentation":"

Contains the Rules that identify the requests that you want to allow, block, or count. In a WebACL, you also specify a default action (ALLOW or BLOCK), and the action for each Rule that you add to a WebACL, for example, block requests from specified IP addresses or block requests from specified referrers. You also associate the WebACL with a CloudFront distribution to identify the requests that you want AWS WAF to filter. If you add more than one Rule to a WebACL, a request needs to match only one of the specifications to be allowed, blocked, or counted. For more information, see UpdateWebACL.

" - }, - "WebACLSummaries":{ - "type":"list", - "member":{"shape":"WebACLSummary"} - }, - "WebACLSummary":{ - "type":"structure", - "required":[ - "WebACLId", - "Name" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name or description of the WebACL.

" - }, - "WebACLUpdate":{ - "type":"structure", - "required":[ - "Action", - "ActivatedRule" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert a Rule into or delete a Rule from a WebACL.

" - }, - "ActivatedRule":{ - "shape":"ActivatedRule", - "documentation":"

The ActivatedRule object in an UpdateWebACL request specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

" - } - }, - "documentation":"

Specifies whether to insert a Rule into or delete a Rule from a WebACL.

" - }, - "WebACLUpdates":{ - "type":"list", - "member":{"shape":"WebACLUpdate"} - }, - "XssMatchSet":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "XssMatchTuples" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for an XssMatchSet. You use XssMatchSetId to get information about an XssMatchSet (see GetXssMatchSet), update an XssMatchSet (see UpdateXssMatchSet), insert an XssMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete an XssMatchSet from AWS WAF (see DeleteXssMatchSet).

XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the XssMatchSet.

" - }, - "XssMatchTuples":{ - "shape":"XssMatchTuples", - "documentation":"

Specifies the parts of web requests that you want to inspect for cross-site scripting attacks.

" - } - }, - "documentation":"

A complex type that contains XssMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header. If a XssMatchSet contains more than one XssMatchTuple object, a request needs to include cross-site scripting attacks in only one of the specified parts of the request to be considered a match.

" - }, - "XssMatchSetSummaries":{ - "type":"list", - "member":{"shape":"XssMatchSetSummary"} - }, - "XssMatchSetSummary":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "Name" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for an XssMatchSet. You use XssMatchSetId to get information about a XssMatchSet (see GetXssMatchSet), update an XssMatchSet (see UpdateXssMatchSet), insert an XssMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete an XssMatchSet from AWS WAF (see DeleteXssMatchSet).

XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the XssMatchSet, if any, specified by Id.

" - } - }, - "documentation":"

The Id and Name of an XssMatchSet.

" - }, - "XssMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "XssMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a XssMatchSetUpdate to an XssMatchSet. Use DELETE to remove a XssMatchSetUpdate from an XssMatchSet.

" - }, - "XssMatchTuple":{ - "shape":"XssMatchTuple", - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect for cross-site scripting attacks and indicates whether you want to add the specification to an XssMatchSet or delete it from an XssMatchSet.

" - }, - "XssMatchSetUpdates":{ - "type":"list", - "member":{"shape":"XssMatchSetUpdate"}, - "min":1 - }, - "XssMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for cross-site scripting attacks.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - } - }, - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header.

" - }, - "XssMatchTuples":{ - "type":"list", - "member":{"shape":"XssMatchTuple"} - }, - "errorMessage":{"type":"string"} - }, - "documentation":"

This is the AWS WAF Regional API Reference for using AWS WAF with Elastic Load Balancing (ELB) Application Load Balancers. The AWS WAF actions and data types listed in the reference are available for protecting Application Load Balancers. You can use these actions and data types by means of the endpoints listed in AWS Regions and Endpoints. This guide is for developers who need detailed information about the AWS WAF API actions, data types, and errors. For detailed information about AWS WAF features and an overview of how to use the AWS WAF API, see the AWS WAF Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/examples-1.json deleted file mode 100644 index eee5b6f4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/examples-1.json +++ /dev/null @@ -1,1017 +0,0 @@ -{ - "version": "1.0", - "examples": { - "CreateIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MyIPSetFriendlyName" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSet": { - "IPSetDescriptors": [ - { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - ], - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Name": "MyIPSetFriendlyName" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates an IP match set named MyIPSetFriendlyName.", - "id": "createipset-1472501003122", - "title": "To create an IP set" - } - ], - "CreateRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Rule": { - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule", - "Predicates": [ - { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - ], - "RuleId": "WAFRule-1-Example" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a rule named WAFByteHeaderRule.", - "id": "createrule-1474072675555", - "title": "To create a rule" - } - ], - "CreateSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySampleSizeConstraintSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSet": { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SizeConstraints": [ - { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates size constraint set named MySampleSizeConstraintSet.", - "id": "createsizeconstraint-1474299140754", - "title": "To create a size constraint" - } - ], - "CreateSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySQLInjectionMatchSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSet": { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SqlInjectionMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a SQL injection match set named MySQLInjectionMatchSet.", - "id": "createsqlinjectionmatchset-1474492796105", - "title": "To create a SQL injection match set" - } - ], - "CreateWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "WebACL": { - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample", - "Rules": [ - { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - ], - "WebACLId": "example-46da-4444-5555-example" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates a web ACL named CreateExample.", - "id": "createwebacl-1472061481310", - "title": "To create a web ACL" - } - ], - "CreateXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MySampleXssMatchSet" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "XssMatchSet": { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "XssMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example creates an XSS match set named MySampleXssMatchSet.", - "id": "createxssmatchset-1474560868500", - "title": "To create an XSS match set" - } - ], - "DeleteByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletebytematchset-1473367566229", - "title": "To delete a byte match set" - } - ], - "DeleteIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deleteipset-1472767434306", - "title": "To delete an IP set" - } - ], - "DeleteRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "RuleId": "WAFRule-1-Example" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a rule with the ID WAFRule-1-Example.", - "id": "deleterule-1474073108749", - "title": "To delete a rule" - } - ], - "DeleteSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a size constraint set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletesizeconstraintset-1474299857905", - "title": "To delete a size constraint set" - } - ], - "DeleteSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletesqlinjectionmatchset-1474493373197", - "title": "To delete a SQL injection match set" - } - ], - "DeleteWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "WebACLId": "example-46da-4444-5555-example" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a web ACL with the ID example-46da-4444-5555-example.", - "id": "deletewebacl-1472767755931", - "title": "To delete a web ACL" - } - ], - "DeleteXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "deletexssmatchset-1474561302618", - "title": "To delete an XSS match set" - } - ], - "GetByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ByteMatchSet": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ByteMatchTuples": [ - { - "FieldToMatch": { - "Data": "referer", - "Type": "HEADER" - }, - "PositionalConstraint": "CONTAINS", - "TargetString": "badrefer1", - "TextTransformation": "NONE" - } - ], - "Name": "ByteMatchNameExample" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getbytematchset-1473273311532", - "title": "To get a byte match set" - } - ], - "GetChangeToken": [ - { - "input": { - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns a change token to use for a create, update or delete operation.", - "id": "get-change-token-example-1471635120794", - "title": "To get a change token" - } - ], - "GetChangeTokenStatus": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "output": { - "ChangeTokenStatus": "PENDING" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the status of a change token with the ID abcd12f2-46da-4fdb-b8d5-fbd4c466928f.", - "id": "getchangetokenstatus-1474658417107", - "title": "To get the change token status" - } - ], - "GetIPSet": [ - { - "input": { - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "IPSet": { - "IPSetDescriptors": [ - { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - ], - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Name": "MyIPSetFriendlyName" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getipset-1474658688675", - "title": "To get an IP set" - } - ], - "GetRule": [ - { - "input": { - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "Rule": { - "MetricName": "WAFByteHeaderRule", - "Name": "WAFByteHeaderRule", - "Predicates": [ - { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - ], - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getrule-1474659238790", - "title": "To get a rule" - } - ], - "GetSampledRequests": [ - { - "input": { - "MaxItems": 100, - "RuleId": "WAFRule-1-Example", - "TimeWindow": { - "EndTime": "2016-09-27T15:50Z", - "StartTime": "2016-09-27T15:50Z" - }, - "WebAclId": "createwebacl-1472061481310" - }, - "output": { - "PopulationSize": 50, - "SampledRequests": [ - { - "Action": "BLOCK", - "Request": { - "ClientIP": "192.0.2.44", - "Country": "US", - "HTTPVersion": "HTTP/1.1", - "Headers": [ - { - "Name": "User-Agent", - "Value": "BadBot " - } - ], - "Method": "HEAD" - }, - "Timestamp": "2016-09-27T14:55Z", - "Weight": 1 - } - ], - "TimeWindow": { - "EndTime": "2016-09-27T15:50Z", - "StartTime": "2016-09-27T14:50Z" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns detailed information about 100 requests --a sample-- that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received between the time period 2016-09-27T15:50Z to 2016-09-27T15:50Z.", - "id": "getsampledrequests-1474927997195", - "title": "To get a sampled requests" - } - ], - "GetSizeConstraintSet": [ - { - "input": { - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "SizeConstraintSet": { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SizeConstraints": [ - { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a size constraint match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getsizeconstraintset-1475005422493", - "title": "To get a size constraint set" - } - ], - "GetSqlInjectionMatchSet": [ - { - "input": { - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "SqlInjectionMatchSet": { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "SqlInjectionMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getsqlinjectionmatchset-1475005940137", - "title": "To get a SQL injection match set" - } - ], - "GetWebACL": [ - { - "input": { - "WebACLId": "createwebacl-1472061481310" - }, - "output": { - "WebACL": { - "DefaultAction": { - "Type": "ALLOW" - }, - "MetricName": "CreateExample", - "Name": "CreateExample", - "Rules": [ - { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - ], - "WebACLId": "createwebacl-1472061481310" - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of a web ACL with the ID createwebacl-1472061481310.", - "id": "getwebacl-1475006348525", - "title": "To get a web ACL" - } - ], - "GetXssMatchSet": [ - { - "input": { - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "XssMatchSet": { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "XssMatchTuples": [ - { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - ] - } - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns the details of an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "getxssmatchset-1475187879017", - "title": "To get an XSS match set" - } - ], - "ListIPSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "IPSets": [ - { - "IPSetId": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Name": "MyIPSetFriendlyName" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 IP match sets.", - "id": "listipsets-1472235676229", - "title": "To list IP sets" - } - ], - "ListRules": [ - { - "input": { - "Limit": 100 - }, - "output": { - "Rules": [ - { - "Name": "WAFByteHeaderRule", - "RuleId": "WAFRule-1-Example" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 rules.", - "id": "listrules-1475258406433", - "title": "To list rules" - } - ], - "ListSizeConstraintSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "SizeConstraintSets": [ - { - "Name": "MySampleSizeConstraintSet", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 size contraint match sets.", - "id": "listsizeconstraintsets-1474300067597", - "title": "To list a size constraint sets" - } - ], - "ListSqlInjectionMatchSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "SqlInjectionMatchSets": [ - { - "Name": "MySQLInjectionMatchSet", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 SQL injection match sets.", - "id": "listsqlinjectionmatchset-1474493560103", - "title": "To list SQL injection match sets" - } - ], - "ListWebACLs": [ - { - "input": { - "Limit": 100 - }, - "output": { - "WebACLs": [ - { - "Name": "WebACLexample", - "WebACLId": "webacl-1472061481310" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 web ACLs.", - "id": "listwebacls-1475258732691", - "title": "To list Web ACLs" - } - ], - "ListXssMatchSets": [ - { - "input": { - "Limit": 100 - }, - "output": { - "XssMatchSets": [ - { - "Name": "MySampleXssMatchSet", - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - } - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example returns an array of up to 100 XSS match sets.", - "id": "listxssmatchsets-1474561481168", - "title": "To list XSS match sets" - } - ], - "UpdateByteMatchSet": [ - { - "input": { - "ByteMatchSetId": "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Updates": [ - { - "Action": "DELETE", - "ByteMatchTuple": { - "FieldToMatch": { - "Data": "referer", - "Type": "HEADER" - }, - "PositionalConstraint": "CONTAINS", - "TargetString": "badrefer1", - "TextTransformation": "NONE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a ByteMatchTuple object (filters) in an byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatebytematchset-1475259074558", - "title": "To update a byte match set" - } - ], - "UpdateIPSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "IPSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "IPSetDescriptor": { - "Type": "IPV4", - "Value": "192.0.2.44/32" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an IPSetDescriptor object in an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updateipset-1475259733625", - "title": "To update an IP set" - } - ], - "UpdateRule": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "RuleId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "Predicate": { - "DataId": "MyByteMatchSetID", - "Negated": false, - "Type": "ByteMatch" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a Predicate object in a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updaterule-1475260064720", - "title": "To update a rule" - } - ], - "UpdateSizeConstraintSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SizeConstraintSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "SizeConstraint": { - "ComparisonOperator": "GT", - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "Size": 0, - "TextTransformation": "NONE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SizeConstraint object (filters) in a size constraint set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatesizeconstraintset-1475531697891", - "title": "To update a size constraint set" - } - ], - "UpdateSqlInjectionMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "SqlInjectionMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5", - "Updates": [ - { - "Action": "DELETE", - "SqlInjectionMatchTuple": { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - } - ] - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes a SqlInjectionMatchTuple object (filters) in a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatesqlinjectionmatchset-1475532094686", - "title": "To update a SQL injection match set" - } - ], - "UpdateWebACL": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "DefaultAction": { - "Type": "ALLOW" - }, - "Updates": [ - { - "Action": "DELETE", - "ActivatedRule": { - "Action": { - "Type": "ALLOW" - }, - "Priority": 1, - "RuleId": "WAFRule-1-Example" - } - } - ], - "WebACLId": "webacl-1472061481310" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an ActivatedRule object in a WebACL with the ID webacl-1472061481310.", - "id": "updatewebacl-1475533627385", - "title": "To update a Web ACL" - } - ], - "UpdateXssMatchSet": [ - { - "input": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", - "Updates": [ - { - "Action": "DELETE", - "XssMatchTuple": { - "FieldToMatch": { - "Type": "QUERY_STRING" - }, - "TextTransformation": "URL_DECODE" - } - } - ], - "XssMatchSetId": "example1ds3t-46da-4fdb-b8d5-abc321j569j5" - }, - "output": { - "ChangeToken": "abcd12f2-46da-4fdb-b8d5-fbd4c466928f" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "The following example deletes an XssMatchTuple object (filters) in an XssMatchSet with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.", - "id": "updatexssmatchset-1475534098881", - "title": "To update an XSS match set" - } - ] - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/paginators-1.json deleted file mode 100644 index ae6668d9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/paginators-1.json +++ /dev/null @@ -1,46 +0,0 @@ -{ - "pagination": { - "ListByteMatchSets": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "ByteMatchSets" - }, - "ListIPSets": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "IPSets" - }, - "ListRules": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "Rules" - }, - "ListSizeConstraintSets": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "SizeConstraintSets" - }, - "ListSqlInjectionMatchSets": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "SqlInjectionMatchSets" - }, - "ListWebACLs": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "WebACLs" - }, - "ListXssMatchSets": { - "input_token": "NextMarker", - "output_token": "NextMarker", - "limit_key": "Limit", - "result_key": "XssMatchSets" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/service-2.json deleted file mode 100644 index d14a4a7a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/waf/2015-08-24/service-2.json +++ /dev/null @@ -1,4797 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-08-24", - "endpointPrefix":"waf", - "jsonVersion":"1.1", - "protocol":"json", - "serviceAbbreviation":"WAF", - "serviceFullName":"AWS WAF", - "serviceId":"WAF", - "signatureVersion":"v4", - "targetPrefix":"AWSWAF_20150824", - "uid":"waf-2015-08-24" - }, - "operations":{ - "CreateByteMatchSet":{ - "name":"CreateByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateByteMatchSetRequest"}, - "output":{"shape":"CreateByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a ByteMatchSet. You then use UpdateByteMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. For example, you can create a ByteMatchSet that matches any requests with User-Agent headers that contain the string BadBot. You can then configure AWS WAF to reject those requests.

To create and configure a ByteMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateByteMatchSet request.

  2. Submit a CreateByteMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateByteMatchSet request.

  4. Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateGeoMatchSet":{ - "name":"CreateGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGeoMatchSetRequest"}, - "output":{"shape":"CreateGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an GeoMatchSet, which you use to specify which web requests you want to allow or block based on the country that the requests originate from. For example, if you're receiving a lot of requests from one or more countries and you want to block the requests, you can create an GeoMatchSet that contains those countries and then configure AWS WAF to block the requests.

To create and configure a GeoMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateGeoMatchSet request.

  2. Submit a CreateGeoMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateGeoMatchSet request.

  4. Submit an UpdateGeoMatchSetSet request to specify the countries that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateIPSet":{ - "name":"CreateIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateIPSetRequest"}, - "output":{"shape":"CreateIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an IPSet, which you use to specify which web requests you want to allow or block based on the IP addresses that the requests originate from. For example, if you're receiving a lot of requests from one or more individual IP addresses or one or more ranges of IP addresses and you want to block the requests, you can create an IPSet that contains those IP addresses and then configure AWS WAF to block the requests.

To create and configure an IPSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateIPSet request.

  2. Submit a CreateIPSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  4. Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRateBasedRule":{ - "name":"CreateRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRateBasedRuleRequest"}, - "output":{"shape":"CreateRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RateBasedRule. The RateBasedRule contains a RateLimit, which specifies the maximum number of requests that AWS WAF allows from a specified IP address in a five-minute period. The RateBasedRule also contains the IPSet objects, ByteMatchSet objects, and other predicates that identify the requests that you want to count or block if these requests exceed the RateLimit.

If you add more than one predicate to a RateBasedRule, a request not only must exceed the RateLimit, but it also must match all the specifications to be counted or blocked. For example, suppose you add the following to a RateBasedRule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

Further, you specify a RateLimit of 15,000.

You then add the RateBasedRule to a WebACL and specify that you want to block requests that meet the conditions in the rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot. Further, requests that match these two conditions must be received at a rate of more than 15,000 requests every five minutes. If both conditions are met and the rate is exceeded, AWS WAF blocks the requests. If the rate drops below 15,000 for a five-minute period, AWS WAF no longer blocks the requests.

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a RateBasedRule:

  • A ByteMatchSet with FieldToMatch of URI

  • A PositionalConstraint of STARTS_WITH

  • A TargetString of login

Further, you specify a RateLimit of 15,000.

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

To create and configure a RateBasedRule, perform the following steps:

  1. Create and update the predicates that you want to include in the rule. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRule request.

  3. Submit a CreateRateBasedRule request.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  5. Submit an UpdateRateBasedRule request to specify the predicates that you want to include in the rule.

  6. Create and update a WebACL that contains the RateBasedRule. For more information, see CreateWebACL.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRegexMatchSet":{ - "name":"CreateRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRegexMatchSetRequest"}, - "output":{"shape":"CreateRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. For example, you can create a RegexMatchSet that contains a RegexMatchTuple that looks for any requests with User-Agent headers that match a RegexPatternSet with pattern B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRegexMatchSet request.

  2. Submit a CreateRegexMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexMatchSet request.

  4. Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value, using a RegexPatternSet, that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRegexPatternSet":{ - "name":"CreateRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRegexPatternSetRequest"}, - "output":{"shape":"CreateRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RegexPatternSet. You then use UpdateRegexPatternSet to specify the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexPatternSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRegexPatternSet request.

  2. Submit a CreateRegexPatternSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexPatternSet request.

  4. Submit an UpdateRegexPatternSet request to specify the string that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRule":{ - "name":"CreateRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRuleRequest"}, - "output":{"shape":"CreateRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a Rule, which contains the IPSet objects, ByteMatchSet objects, and other predicates that identify the requests that you want to block. If you add more than one predicate to a Rule, a request must match all of the specifications to be allowed or blocked. For example, suppose you add the following to a Rule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

You then add the Rule to a WebACL and specify that you want to blocks requests that satisfy the Rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot.

To create and configure a Rule, perform the following steps:

  1. Create and update the predicates that you want to include in the Rule. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateRule request.

  3. Submit a CreateRule request.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  5. Submit an UpdateRule request to specify the predicates that you want to include in the Rule.

  6. Create and update a WebACL that contains the Rule. For more information, see CreateWebACL.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateRuleGroup":{ - "name":"CreateRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateRuleGroupRequest"}, - "output":{"shape":"CreateRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a RuleGroup. A rule group is a collection of predefined rules that you add to a web ACL. You use UpdateRuleGroup to add rules to the rule group.

Rule groups are subject to the following limits:

  • Three rule groups per account. You can request an increase to this limit by contacting customer support.

  • One rule group per web ACL.

  • Ten rules per rule group.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateSizeConstraintSet":{ - "name":"CreateSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSizeConstraintSetRequest"}, - "output":{"shape":"CreateSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a SizeConstraintSet. You then use UpdateSizeConstraintSet to identify the part of a web request that you want AWS WAF to check for length, such as the length of the User-Agent header or the length of the query string. For example, you can create a SizeConstraintSet that matches any requests that have a query string that is longer than 100 bytes. You can then configure AWS WAF to reject those requests.

To create and configure a SizeConstraintSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateSizeConstraintSet request.

  2. Submit a CreateSizeConstraintSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSizeConstraintSet request.

  4. Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateSqlInjectionMatchSet":{ - "name":"CreateSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateSqlInjectionMatchSetRequest"}, - "output":{"shape":"CreateSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

To create and configure a SqlInjectionMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateSqlInjectionMatchSet request.

  2. Submit a CreateSqlInjectionMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSqlInjectionMatchSet request.

  4. Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to allow, block, or count malicious SQL code.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "CreateWebACL":{ - "name":"CreateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateWebACLRequest"}, - "output":{"shape":"CreateWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates a WebACL, which contains the Rules that identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluates Rules in order based on the value of Priority for each Rule.

You also specify a default action, either ALLOW or BLOCK. If a web request doesn't match any of the Rules in a WebACL, AWS WAF responds to the request with the default action.

To create and configure a WebACL, perform the following steps:

  1. Create and update the ByteMatchSet objects and other predicates that you want to include in Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

  2. Create and update the Rules that you want to include in the WebACL. For more information, see CreateRule and UpdateRule.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateWebACL request.

  4. Submit a CreateWebACL request.

  5. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateWebACL request.

  6. Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, to specify the default action, and to associate the WebACL with a CloudFront distribution.

For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.

" - }, - "CreateXssMatchSet":{ - "name":"CreateXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateXssMatchSetRequest"}, - "output":{"shape":"CreateXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

To create and configure an XssMatchSet, perform the following steps:

  1. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a CreateXssMatchSet request.

  2. Submit a CreateXssMatchSet request.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateXssMatchSet request.

  4. Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to allow, block, or count cross-site scripting attacks.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "DeleteByteMatchSet":{ - "name":"DeleteByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteByteMatchSetRequest"}, - "output":{"shape":"DeleteByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any Rules or if it still includes any ByteMatchTuple objects (any filters).

If you just want to remove a ByteMatchSet from a Rule, use UpdateRule.

To permanently delete a ByteMatchSet, perform the following steps:

  1. Update the ByteMatchSet to remove filters, if any. For more information, see UpdateByteMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteByteMatchSet request.

  3. Submit a DeleteByteMatchSet request.

" - }, - "DeleteGeoMatchSet":{ - "name":"DeleteGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGeoMatchSetRequest"}, - "output":{"shape":"DeleteGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a GeoMatchSet. You can't delete a GeoMatchSet if it's still used in any Rules or if it still includes any countries.

If you just want to remove a GeoMatchSet from a Rule, use UpdateRule.

To permanently delete a GeoMatchSet from AWS WAF, perform the following steps:

  1. Update the GeoMatchSet to remove any countries. For more information, see UpdateGeoMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteGeoMatchSet request.

  3. Submit a DeleteGeoMatchSet request.

" - }, - "DeleteIPSet":{ - "name":"DeleteIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIPSetRequest"}, - "output":{"shape":"DeleteIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any Rules or if it still includes any IP addresses.

If you just want to remove an IPSet from a Rule, use UpdateRule.

To permanently delete an IPSet from AWS WAF, perform the following steps:

  1. Update the IPSet to remove IP address ranges, if any. For more information, see UpdateIPSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteIPSet request.

  3. Submit a DeleteIPSet request.

" - }, - "DeletePermissionPolicy":{ - "name":"DeletePermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeletePermissionPolicyRequest"}, - "output":{"shape":"DeletePermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Permanently deletes an IAM policy from the specified RuleGroup.

The user making the request must be the owner of the RuleGroup.

" - }, - "DeleteRateBasedRule":{ - "name":"DeleteRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRateBasedRuleRequest"}, - "output":{"shape":"DeleteRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RateBasedRule. You can't delete a rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

If you just want to remove a rule from a WebACL, use UpdateWebACL.

To permanently delete a RateBasedRule from AWS WAF, perform the following steps:

  1. Update the RateBasedRule to remove predicates, if any. For more information, see UpdateRateBasedRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRateBasedRule request.

  3. Submit a DeleteRateBasedRule request.

" - }, - "DeleteRegexMatchSet":{ - "name":"DeleteRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRegexMatchSetRequest"}, - "output":{"shape":"DeleteRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RegexMatchSet. You can't delete a RegexMatchSet if it's still used in any Rules or if it still includes any RegexMatchTuples objects (any filters).

If you just want to remove a RegexMatchSet from a Rule, use UpdateRule.

To permanently delete a RegexMatchSet, perform the following steps:

  1. Update the RegexMatchSet to remove filters, if any. For more information, see UpdateRegexMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRegexMatchSet request.

  3. Submit a DeleteRegexMatchSet request.

" - }, - "DeleteRegexPatternSet":{ - "name":"DeleteRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRegexPatternSetRequest"}, - "output":{"shape":"DeleteRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RegexPatternSet. You can't delete a RegexPatternSet if it's still used in any RegexMatchSet or if the RegexPatternSet is not empty.

" - }, - "DeleteRule":{ - "name":"DeleteRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleRequest"}, - "output":{"shape":"DeleteRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a Rule. You can't delete a Rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

If you just want to remove a Rule from a WebACL, use UpdateWebACL.

To permanently delete a Rule from AWS WAF, perform the following steps:

  1. Update the Rule to remove predicates, if any. For more information, see UpdateRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRule request.

  3. Submit a DeleteRule request.

" - }, - "DeleteRuleGroup":{ - "name":"DeleteRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteRuleGroupRequest"}, - "output":{"shape":"DeleteRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a RuleGroup. You can't delete a RuleGroup if it's still used in any WebACL objects or if it still includes any rules.

If you just want to remove a RuleGroup from a WebACL, use UpdateWebACL.

To permanently delete a RuleGroup from AWS WAF, perform the following steps:

  1. Update the RuleGroup to remove rules, if any. For more information, see UpdateRuleGroup.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRuleGroup request.

  3. Submit a DeleteRuleGroup request.

" - }, - "DeleteSizeConstraintSet":{ - "name":"DeleteSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSizeConstraintSetRequest"}, - "output":{"shape":"DeleteSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still used in any Rules or if it still includes any SizeConstraint objects (any filters).

If you just want to remove a SizeConstraintSet from a Rule, use UpdateRule.

To permanently delete a SizeConstraintSet, perform the following steps:

  1. Update the SizeConstraintSet to remove filters, if any. For more information, see UpdateSizeConstraintSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteSizeConstraintSet request.

  3. Submit a DeleteSizeConstraintSet request.

" - }, - "DeleteSqlInjectionMatchSet":{ - "name":"DeleteSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteSqlInjectionMatchSetRequest"}, - "output":{"shape":"DeleteSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.

If you just want to remove a SqlInjectionMatchSet from a Rule, use UpdateRule.

To permanently delete a SqlInjectionMatchSet from AWS WAF, perform the following steps:

  1. Update the SqlInjectionMatchSet to remove filters, if any. For more information, see UpdateSqlInjectionMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteSqlInjectionMatchSet request.

  3. Submit a DeleteSqlInjectionMatchSet request.

" - }, - "DeleteWebACL":{ - "name":"DeleteWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteWebACLRequest"}, - "output":{"shape":"DeleteWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes a WebACL. You can't delete a WebACL if it still contains any Rules.

To delete a WebACL, perform the following steps:

  1. Update the WebACL to remove Rules, if any. For more information, see UpdateWebACL.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteWebACL request.

  3. Submit a DeleteWebACL request.

" - }, - "DeleteXssMatchSet":{ - "name":"DeleteXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteXssMatchSetRequest"}, - "output":{"shape":"DeleteXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonEmptyEntityException"} - ], - "documentation":"

Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's still used in any Rules or if it still contains any XssMatchTuple objects.

If you just want to remove an XssMatchSet from a Rule, use UpdateRule.

To permanently delete an XssMatchSet from AWS WAF, perform the following steps:

  1. Update the XssMatchSet to remove filters, if any. For more information, see UpdateXssMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteXssMatchSet request.

  3. Submit a DeleteXssMatchSet request.

" - }, - "GetByteMatchSet":{ - "name":"GetByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetByteMatchSetRequest"}, - "output":{"shape":"GetByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the ByteMatchSet specified by ByteMatchSetId.

" - }, - "GetChangeToken":{ - "name":"GetChangeToken", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetChangeTokenRequest"}, - "output":{"shape":"GetChangeTokenResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.

Each create, update, or delete request must use a unique change token. If your application submits a GetChangeToken request and then submits a second GetChangeToken request before submitting a create, update, or delete request, the second GetChangeToken request returns the same value as the first GetChangeToken request.

When you use a change token in a create, update, or delete request, the status of the change token changes to PENDING, which indicates that AWS WAF is propagating the change to all AWS WAF servers. Use GetChangeTokenStatus to determine the status of your change token.

" - }, - "GetChangeTokenStatus":{ - "name":"GetChangeTokenStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetChangeTokenStatusRequest"}, - "output":{"shape":"GetChangeTokenStatusResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns the status of a ChangeToken that you got by calling GetChangeToken. ChangeTokenStatus is one of the following values:

  • PROVISIONED: You requested the change token by calling GetChangeToken, but you haven't used it yet in a call to create, update, or delete an AWS WAF object.

  • PENDING: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.

  • IN_SYNC: Propagation is complete.

" - }, - "GetGeoMatchSet":{ - "name":"GetGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetGeoMatchSetRequest"}, - "output":{"shape":"GetGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the GeoMatchSet that is specified by GeoMatchSetId.

" - }, - "GetIPSet":{ - "name":"GetIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetIPSetRequest"}, - "output":{"shape":"GetIPSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the IPSet that is specified by IPSetId.

" - }, - "GetPermissionPolicy":{ - "name":"GetPermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetPermissionPolicyRequest"}, - "output":{"shape":"GetPermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the IAM policy attached to the RuleGroup.

" - }, - "GetRateBasedRule":{ - "name":"GetRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRateBasedRuleRequest"}, - "output":{"shape":"GetRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RateBasedRule that is specified by the RuleId that you included in the GetRateBasedRule request.

" - }, - "GetRateBasedRuleManagedKeys":{ - "name":"GetRateBasedRuleManagedKeys", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRateBasedRuleManagedKeysRequest"}, - "output":{"shape":"GetRateBasedRuleManagedKeysResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Returns an array of IP addresses currently being blocked by the RateBasedRule that is specified by the RuleId. The maximum number of managed keys that will be blocked is 10,000. If more than 10,000 addresses exceed the rate limit, the 10,000 addresses with the highest rates will be blocked.

" - }, - "GetRegexMatchSet":{ - "name":"GetRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRegexMatchSetRequest"}, - "output":{"shape":"GetRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RegexMatchSet specified by RegexMatchSetId.

" - }, - "GetRegexPatternSet":{ - "name":"GetRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRegexPatternSetRequest"}, - "output":{"shape":"GetRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RegexPatternSet specified by RegexPatternSetId.

" - }, - "GetRule":{ - "name":"GetRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRuleRequest"}, - "output":{"shape":"GetRuleResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the Rule that is specified by the RuleId that you included in the GetRule request.

" - }, - "GetRuleGroup":{ - "name":"GetRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetRuleGroupRequest"}, - "output":{"shape":"GetRuleGroupResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the RuleGroup that is specified by the RuleGroupId that you included in the GetRuleGroup request.

To view the rules in a rule group, use ListActivatedRulesInRuleGroup.

" - }, - "GetSampledRequests":{ - "name":"GetSampledRequests", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSampledRequestsRequest"}, - "output":{"shape":"GetSampledRequestsResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

" - }, - "GetSizeConstraintSet":{ - "name":"GetSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSizeConstraintSetRequest"}, - "output":{"shape":"GetSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the SizeConstraintSet specified by SizeConstraintSetId.

" - }, - "GetSqlInjectionMatchSet":{ - "name":"GetSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetSqlInjectionMatchSetRequest"}, - "output":{"shape":"GetSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.

" - }, - "GetWebACL":{ - "name":"GetWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetWebACLRequest"}, - "output":{"shape":"GetWebACLResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the WebACL that is specified by WebACLId.

" - }, - "GetXssMatchSet":{ - "name":"GetXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"GetXssMatchSetRequest"}, - "output":{"shape":"GetXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFNonexistentItemException"} - ], - "documentation":"

Returns the XssMatchSet that is specified by XssMatchSetId.

" - }, - "ListActivatedRulesInRuleGroup":{ - "name":"ListActivatedRulesInRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListActivatedRulesInRuleGroupRequest"}, - "output":{"shape":"ListActivatedRulesInRuleGroupResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Returns an array of ActivatedRule objects.

" - }, - "ListByteMatchSets":{ - "name":"ListByteMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListByteMatchSetsRequest"}, - "output":{"shape":"ListByteMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of ByteMatchSetSummary objects.

" - }, - "ListGeoMatchSets":{ - "name":"ListGeoMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGeoMatchSetsRequest"}, - "output":{"shape":"ListGeoMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of GeoMatchSetSummary objects in the response.

" - }, - "ListIPSets":{ - "name":"ListIPSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListIPSetsRequest"}, - "output":{"shape":"ListIPSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of IPSetSummary objects in the response.

" - }, - "ListRateBasedRules":{ - "name":"ListRateBasedRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRateBasedRulesRequest"}, - "output":{"shape":"ListRateBasedRulesResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RuleSummary objects.

" - }, - "ListRegexMatchSets":{ - "name":"ListRegexMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRegexMatchSetsRequest"}, - "output":{"shape":"ListRegexMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RegexMatchSetSummary objects.

" - }, - "ListRegexPatternSets":{ - "name":"ListRegexPatternSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRegexPatternSetsRequest"}, - "output":{"shape":"ListRegexPatternSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RegexPatternSetSummary objects.

" - }, - "ListRuleGroups":{ - "name":"ListRuleGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRuleGroupsRequest"}, - "output":{"shape":"ListRuleGroupsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns an array of RuleGroup objects.

" - }, - "ListRules":{ - "name":"ListRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListRulesRequest"}, - "output":{"shape":"ListRulesResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of RuleSummary objects.

" - }, - "ListSizeConstraintSets":{ - "name":"ListSizeConstraintSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSizeConstraintSetsRequest"}, - "output":{"shape":"ListSizeConstraintSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of SizeConstraintSetSummary objects.

" - }, - "ListSqlInjectionMatchSets":{ - "name":"ListSqlInjectionMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSqlInjectionMatchSetsRequest"}, - "output":{"shape":"ListSqlInjectionMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of SqlInjectionMatchSet objects.

" - }, - "ListSubscribedRuleGroups":{ - "name":"ListSubscribedRuleGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListSubscribedRuleGroupsRequest"}, - "output":{"shape":"ListSubscribedRuleGroupsResponse"}, - "errors":[ - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInternalErrorException"} - ], - "documentation":"

Returns an array of RuleGroup objects that you are subscribed to.

" - }, - "ListWebACLs":{ - "name":"ListWebACLs", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListWebACLsRequest"}, - "output":{"shape":"ListWebACLsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of WebACLSummary objects in the response.

" - }, - "ListXssMatchSets":{ - "name":"ListXssMatchSets", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListXssMatchSetsRequest"}, - "output":{"shape":"ListXssMatchSetsResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Returns an array of XssMatchSet objects.

" - }, - "PutPermissionPolicy":{ - "name":"PutPermissionPolicy", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutPermissionPolicyRequest"}, - "output":{"shape":"PutPermissionPolicyResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidPermissionPolicyException"} - ], - "documentation":"

Attaches a IAM policy to the specified resource. The only supported use for this action is to share a RuleGroup across accounts.

The PutPermissionPolicy is subject to the following restrictions:

  • You can attach only one policy with each PutPermissionPolicy request.

  • The policy must include an Effect, Action and Principal.

  • Effect must specify Allow.

  • The Action in the policy must be waf:UpdateWebACL and waf-regional:UpdateWebACL. Any extra or wildcard actions in the policy will be rejected.

  • The policy cannot include a Resource parameter.

  • The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

  • The user making the request must be the owner of the RuleGroup.

  • Your policy must be composed using IAM Policy version 2012-10-17.

For more information, see IAM Policies.

An example of a valid policy parameter is shown in the Examples section below.

" - }, - "UpdateByteMatchSet":{ - "name":"UpdateByteMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateByteMatchSetRequest"}, - "output":{"shape":"UpdateByteMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each ByteMatchTuple object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a ByteMatchSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to look for. For more information, including how you specify the values for the AWS WAF API and the AWS CLI or SDKs, see TargetString in the ByteMatchTuple data type.

  • Where to look, such as at the beginning or the end of a query string.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

For example, you can add a ByteMatchSetUpdate object that matches web requests in which User-Agent headers contain the string BadBot. You can then configure AWS WAF to block those requests.

To create and configure a ByteMatchSet, perform the following steps:

  1. Create a ByteMatchSet. For more information, see CreateByteMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateByteMatchSet request.

  3. Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateGeoMatchSet":{ - "name":"UpdateGeoMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateGeoMatchSetRequest"}, - "output":{"shape":"UpdateGeoMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes GeoMatchConstraint objects in an GeoMatchSet. For each GeoMatchConstraint object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change an GeoMatchConstraint object, you delete the existing object and add a new one.

  • The Type. The only valid value for Type is Country.

  • The Value, which is a two character code for the country to add to the GeoMatchConstraint object. Valid codes are listed in GeoMatchConstraint$Value.

To create and configure an GeoMatchSet, perform the following steps:

  1. Submit a CreateGeoMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateGeoMatchSet request.

  3. Submit an UpdateGeoMatchSet request to specify the country that you want AWS WAF to watch for.

When you update an GeoMatchSet, you specify the country that you want to add and/or the country that you want to delete. If you want to change a country, you delete the existing country and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateIPSet":{ - "name":"UpdateIPSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateIPSetRequest"}, - "output":{"shape":"UpdateIPSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes IPSetDescriptor objects in an IPSet. For each IPSetDescriptor object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change an IPSetDescriptor object, you delete the existing object and add a new one.

  • The IP address version, IPv4 or IPv6.

  • The IP address in CIDR notation, for example, 192.0.2.0/24 (for the range of IP addresses from 192.0.2.0 to 192.0.2.255) or 192.0.2.44/32 (for the individual IP address 192.0.2.44).

AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

IPv6 addresses can be represented using any of the following formats:

  • 1111:0000:0000:0000:0000:0000:0000:0111/128

  • 1111:0:0:0:0:0:0:0111/128

  • 1111::0111/128

  • 1111::111/128

You use an IPSet to specify which web requests you want to allow or block based on the IP addresses that the requests originated from. For example, if you're receiving a lot of requests from one or a small number of IP addresses and you want to block the requests, you can create an IPSet that specifies those IP addresses, and then configure AWS WAF to block the requests.

To create and configure an IPSet, perform the following steps:

  1. Submit a CreateIPSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

When you update an IPSet, you specify the IP addresses that you want to add and/or the IP addresses that you want to delete. If you want to change an IP address, you delete the existing IP address and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRateBasedRule":{ - "name":"UpdateRateBasedRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRateBasedRuleRequest"}, - "output":{"shape":"UpdateRateBasedRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes Predicate objects in a rule and updates the RateLimit in the rule.

Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to block or count. The RateLimit specifies the number of requests every five minutes that triggers the rule.

If you add more than one predicate to a RateBasedRule, a request must match all the predicates and exceed the RateLimit to be counted or blocked. For example, suppose you add the following to a RateBasedRule:

  • An IPSet that matches the IP address 192.0.2.44/32

  • A ByteMatchSet that matches BadBot in the User-Agent header

Further, you specify a RateLimit of 15,000.

You then add the RateBasedRule to a WebACL and specify that you want to block requests that satisfy the rule. For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request must contain the value BadBot. Further, requests that match these two conditions much be received at a rate of more than 15,000 every five minutes. If the rate drops below this limit, AWS WAF no longer blocks the requests.

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a RateBasedRule:

  • A ByteMatchSet with FieldToMatch of URI

  • A PositionalConstraint of STARTS_WITH

  • A TargetString of login

Further, you specify a RateLimit of 15,000.

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

" - }, - "UpdateRegexMatchSet":{ - "name":"UpdateRegexMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRegexMatchSetRequest"}, - "output":{"shape":"UpdateRegexMatchSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFDisallowedNameException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidAccountException"} - ], - "documentation":"

Inserts or deletes RegexMatchTuple objects (filters) in a RegexMatchSet. For each RegexMatchSetUpdate object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a RegexMatchSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to inspectupdate, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

For example, you can create a RegexPatternSet that matches any requests with User-Agent headers that contain the string B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

To create and configure a RegexMatchSet, perform the following steps:

  1. Create a RegexMatchSet. For more information, see CreateRegexMatchSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexMatchSet request.

  3. Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the identifier of the RegexPatternSet that contain the regular expression patters you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRegexPatternSet":{ - "name":"UpdateRegexPatternSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRegexPatternSetRequest"}, - "output":{"shape":"UpdateRegexPatternSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidRegexPatternException"} - ], - "documentation":"

Inserts or deletes RegexPatternString objects in a RegexPatternSet. For each RegexPatternString object, you specify the following values:

  • Whether to insert or delete the RegexPatternString.

  • The regular expression pattern that you want to insert or delete. For more information, see RegexPatternSet.

For example, you can create a RegexPatternString such as B[a@]dB[o0]t. AWS WAF will match this RegexPatternString to:

  • BadBot

  • BadB0t

  • B@dBot

  • B@dB0t

To create and configure a RegexPatternSet, perform the following steps:

  1. Create a RegexPatternSet. For more information, see CreateRegexPatternSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRegexPatternSet request.

  3. Submit an UpdateRegexPatternSet request to specify the regular expression pattern that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRule":{ - "name":"UpdateRule", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRuleRequest"}, - "output":{"shape":"UpdateRuleResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes Predicate objects in a Rule. Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to allow, block, or count. If you add more than one predicate to a Rule, a request must match all of the specifications to be allowed, blocked, or counted. For example, suppose you add the following to a Rule:

  • A ByteMatchSet that matches the value BadBot in the User-Agent header

  • An IPSet that matches the IP address 192.0.2.44

You then add the Rule to a WebACL and specify that you want to block requests that satisfy the Rule. For a request to be blocked, the User-Agent header in the request must contain the value BadBot and the request must originate from the IP address 192.0.2.44.

To create and configure a Rule, perform the following steps:

  1. Create and update the predicates that you want to include in the Rule.

  2. Create the Rule. See CreateRule.

  3. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRule request.

  4. Submit an UpdateRule request to add predicates to the Rule.

  5. Create and update a WebACL that contains the Rule. See CreateWebACL.

If you want to replace one ByteMatchSet or IPSet with another, you delete the existing one and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateRuleGroup":{ - "name":"UpdateRuleGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRuleGroupRequest"}, - "output":{"shape":"UpdateRuleGroupResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFInvalidParameterException"} - ], - "documentation":"

Inserts or deletes ActivatedRule objects in a RuleGroup.

You can only insert REGULAR rules into a rule group.

You can have a maximum of ten rules per rule group.

To create and configure a RuleGroup, perform the following steps:

  1. Create and update the Rules that you want to include in the RuleGroup. See CreateRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateRuleGroup request.

  3. Submit an UpdateRuleGroup request to add Rules to the RuleGroup.

  4. Create and update a WebACL that contains the RuleGroup. See CreateWebACL.

If you want to replace one Rule with another, you delete the existing one and add the new one.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateSizeConstraintSet":{ - "name":"UpdateSizeConstraintSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSizeConstraintSetRequest"}, - "output":{"shape":"UpdateSizeConstraintSetResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each SizeConstraint object, you specify the following values:

  • Whether to insert or delete the object from the array. If you want to change a SizeConstraintSetUpdate object, you delete the existing object and add a new one.

  • The part of a web request that you want AWS WAF to evaluate, such as the length of a query string or the length of the User-Agent header.

  • Whether to perform any transformations on the request, such as converting it to lowercase, before checking its length. Note that transformations of the request body are not supported because the AWS resource forwards only the first 8192 bytes of your request to AWS WAF.

  • A ComparisonOperator used for evaluating the selected part of the request against the specified Size, such as equals, greater than, less than, and so on.

  • The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.

For example, you can add a SizeConstraintSetUpdate object that matches web requests in which the length of the User-Agent header is greater than 100 bytes. You can then configure AWS WAF to block those requests.

To create and configure a SizeConstraintSet, perform the following steps:

  1. Create a SizeConstraintSet. For more information, see CreateSizeConstraintSet.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateSizeConstraintSet request.

  3. Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateSqlInjectionMatchSet":{ - "name":"UpdateSqlInjectionMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateSqlInjectionMatchSetRequest"}, - "output":{"shape":"UpdateSqlInjectionMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. For each SqlInjectionMatchTuple object, you specify the following values:

  • Action: Whether to insert the object into or delete the object from the array. To change a SqlInjectionMatchTuple, you delete the existing object and add a new one.

  • FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.

  • TextTransformation: Which text transformation, if any, to perform on the web request before inspecting the request for snippets of malicious SQL code.

You use SqlInjectionMatchSet objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain snippets of SQL code in the query string and you want to block the requests, you can create a SqlInjectionMatchSet with the applicable settings, and then configure AWS WAF to block the requests.

To create and configure a SqlInjectionMatchSet, perform the following steps:

  1. Submit a CreateSqlInjectionMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests that you want AWS WAF to inspect for snippets of SQL code.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateWebACL":{ - "name":"UpdateWebACL", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateWebACLRequest"}, - "output":{"shape":"UpdateWebACLResponse"}, - "errors":[ - {"shape":"WAFStaleDataException"}, - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFReferencedItemException"}, - {"shape":"WAFLimitsExceededException"}, - {"shape":"WAFSubscriptionNotFoundException"} - ], - "documentation":"

Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies web requests that you want to allow, block, or count. When you update a WebACL, you specify the following values:

  • A default action for the WebACL, either ALLOW or BLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of the Rules in a WebACL.

  • The Rules that you want to add and/or delete. If you want to replace one Rule with another, you delete the existing Rule and add the new one.

  • For each Rule, whether you want AWS WAF to allow requests, block requests, or count requests that match the conditions in the Rule.

  • The order in which you want AWS WAF to evaluate the Rules in a WebACL. If you add more than one Rule to a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. (The Rule that has the lowest value for Priority is evaluated first.) When a web request matches all of the predicates (such as ByteMatchSets and IPSets) in a Rule, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remaining Rules in the WebACL, if any.

To create and configure a WebACL, perform the following steps:

  1. Create and update the predicates that you want to include in Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

  2. Create and update the Rules that you want to include in the WebACL. For more information, see CreateRule and UpdateRule.

  3. Create a WebACL. See CreateWebACL.

  4. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateWebACL request.

  5. Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, to specify the default action, and to associate the WebACL with a CloudFront distribution.

Be aware that if you try to add a RATE_BASED rule to a web ACL without setting the rule type when first creating the rule, the UpdateWebACL request will fail because the request tries to add a REGULAR rule (the default rule type) with the specified ID, which does not exist.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - }, - "UpdateXssMatchSet":{ - "name":"UpdateXssMatchSet", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateXssMatchSetRequest"}, - "output":{"shape":"UpdateXssMatchSetResponse"}, - "errors":[ - {"shape":"WAFInternalErrorException"}, - {"shape":"WAFInvalidAccountException"}, - {"shape":"WAFInvalidOperationException"}, - {"shape":"WAFInvalidParameterException"}, - {"shape":"WAFNonexistentContainerException"}, - {"shape":"WAFNonexistentItemException"}, - {"shape":"WAFStaleDataException"}, - {"shape":"WAFLimitsExceededException"} - ], - "documentation":"

Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. For each XssMatchTuple object, you specify the following values:

  • Action: Whether to insert the object into or delete the object from the array. To change a XssMatchTuple, you delete the existing object and add a new one.

  • FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.

  • TextTransformation: Which text transformation, if any, to perform on the web request before inspecting the request for cross-site scripting attacks.

You use XssMatchSet objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain cross-site scripting attacks in the request body and you want to block the requests, you can create an XssMatchSet with the applicable settings, and then configure AWS WAF to block the requests.

To create and configure an XssMatchSet, perform the following steps:

  1. Submit a CreateXssMatchSet request.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an UpdateIPSet request.

  3. Submit an UpdateXssMatchSet request to specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks.

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

" - } - }, - "shapes":{ - "Action":{"type":"string"}, - "ActivatedRule":{ - "type":"structure", - "required":[ - "Priority", - "RuleId" - ], - "members":{ - "Priority":{ - "shape":"RulePriority", - "documentation":"

Specifies the order in which the Rules in a WebACL are evaluated. Rules with a lower value for Priority are evaluated before Rules with a higher value. The value must be a unique integer. If you add multiple Rules to a WebACL, the values don't need to be consecutive.

" - }, - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Action":{ - "shape":"WafAction", - "documentation":"

Specifies the action that CloudFront or AWS WAF takes when a web request matches the conditions in the Rule. Valid values for Action include the following:

  • ALLOW: CloudFront responds with the requested object.

  • BLOCK: CloudFront responds with an HTTP 403 (Forbidden) status code.

  • COUNT: AWS WAF increments a counter of requests that match the conditions in the rule and then continues to inspect the web request based on the remaining rules in the web ACL.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "OverrideAction":{ - "shape":"WafOverrideAction", - "documentation":"

Use the OverrideAction to test your RuleGroup.

Any rule in a RuleGroup can potentially block a request. If you set the OverrideAction to None, the RuleGroup will block a request if any individual rule in the RuleGroup matches the request and is configured to block that request. However if you first want to test the RuleGroup, set the OverrideAction to Count. The RuleGroup will then override any block action specified by individual rules contained within the group. Instead of blocking matching requests, those requests will be counted. You can view a record of counted requests using GetSampledRequests.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "Type":{ - "shape":"WafRuleType", - "documentation":"

The rule type, either REGULAR, as defined by Rule, RATE_BASED, as defined by RateBasedRule, or GROUP, as defined by RuleGroup. The default is REGULAR. Although this field is optional, be aware that if you try to add a RATE_BASED rule to a web ACL without setting the type, the UpdateWebACL request will fail because the request tries to add a REGULAR rule with the specified ID, which does not exist.

" - } - }, - "documentation":"

The ActivatedRule object in an UpdateWebACL request specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

To specify whether to insert or delete a Rule, use the Action parameter in the WebACLUpdate data type.

" - }, - "ActivatedRules":{ - "type":"list", - "member":{"shape":"ActivatedRule"} - }, - "ByteMatchSet":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ByteMatchTuples" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId for a ByteMatchSet. You use ByteMatchSetId to get information about a ByteMatchSet (see GetByteMatchSet), update a ByteMatchSet (see UpdateByteMatchSet), insert a ByteMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a ByteMatchSet from AWS WAF (see DeleteByteMatchSet).

ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - }, - "ByteMatchTuples":{ - "shape":"ByteMatchTuples", - "documentation":"

Specifies the bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings.

" - } - }, - "documentation":"

In a GetByteMatchSet request, ByteMatchSet is a complex type that contains the ByteMatchSetId and Name of a ByteMatchSet, and the values that you specified when you updated the ByteMatchSet.

A complex type that contains ByteMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a ByteMatchSet contains more than one ByteMatchTuple object, a request needs to match the settings in only one ByteMatchTuple to be considered a match.

" - }, - "ByteMatchSetSummaries":{ - "type":"list", - "member":{"shape":"ByteMatchSetSummary"} - }, - "ByteMatchSetSummary":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "Name" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId for a ByteMatchSet. You use ByteMatchSetId to get information about a ByteMatchSet, update a ByteMatchSet, remove a ByteMatchSet from a Rule, and delete a ByteMatchSet from AWS WAF.

ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - } - }, - "documentation":"

Returned by ListByteMatchSets. Each ByteMatchSetSummary object includes the Name and ByteMatchSetId for one ByteMatchSet.

" - }, - "ByteMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "ByteMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a ByteMatchTuple.

" - }, - "ByteMatchTuple":{ - "shape":"ByteMatchTuple", - "documentation":"

Information about the part of a web request that you want AWS WAF to inspect and the value that you want AWS WAF to search for. If you specify DELETE for the value of Action, the ByteMatchTuple values must exactly match the values in the ByteMatchTuple that you want to delete from the ByteMatchSet.

" - } - }, - "documentation":"

In an UpdateByteMatchSet request, ByteMatchSetUpdate specifies whether to insert or delete a ByteMatchTuple and includes the settings for the ByteMatchTuple.

" - }, - "ByteMatchSetUpdates":{ - "type":"list", - "member":{"shape":"ByteMatchSetUpdate"}, - "min":1 - }, - "ByteMatchTargetString":{"type":"blob"}, - "ByteMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TargetString", - "TextTransformation", - "PositionalConstraint" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

The part of a web request that you want AWS WAF to search, such as a specified header or a query string. For more information, see FieldToMatch.

" - }, - "TargetString":{ - "shape":"ByteMatchTargetString", - "documentation":"

The value that you want AWS WAF to search for. AWS WAF searches for the specified string in the part of web requests that you specified in FieldToMatch. The maximum length of the value is 50 bytes.

Valid values depend on the values that you specified for FieldToMatch:

  • HEADER: The value that you want AWS WAF to search for in the request header that you specified in FieldToMatch, for example, the value of the User-Agent or Referer header.

  • METHOD: The HTTP method, which indicates the type of operation specified in the request. CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

  • QUERY_STRING: The value that you want AWS WAF to search for in the query string, which is the part of a URL that appears after a ? character.

  • URI: The value that you want AWS WAF to search for in the part of a URL that identifies a resource, for example, /images/daily-ad.jpg.

  • BODY: The part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form. The request body immediately follows the request headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For more information, see CreateSizeConstraintSet.

If TargetString includes alphabetic characters A-Z and a-z, note that the value is case sensitive.

If you're using the AWS WAF API

Specify a base64-encoded version of the value. The maximum length of the value before you base64-encode it is 50 bytes.

For example, suppose the value of Type is HEADER and the value of Data is User-Agent. If you want to search the User-Agent header for the value BadBot, you base64-encode BadBot using MIME base64 encoding and include the resulting value, QmFkQm90, in the value of TargetString.

If you're using the AWS CLI or one of the AWS SDKs

The value that you want AWS WAF to search for. The SDK automatically base64 encodes the value.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on TargetString before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - }, - "PositionalConstraint":{ - "shape":"PositionalConstraint", - "documentation":"

Within the portion of a web request that you want to search (for example, in the query string, if any), specify where you want AWS WAF to search. Valid values include the following:

CONTAINS

The specified part of the web request must include the value of TargetString, but the location doesn't matter.

CONTAINS_WORD

The specified part of the web request must include the value of TargetString, and TargetString must contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In addition, TargetString must be a word, which means one of the following:

  • TargetString exactly matches the value of the specified part of the web request, such as the value of a header.

  • TargetString is at the beginning of the specified part of the web request and is followed by a character other than an alphanumeric character or underscore (_), for example, BadBot;.

  • TargetString is at the end of the specified part of the web request and is preceded by a character other than an alphanumeric character or underscore (_), for example, ;BadBot.

  • TargetString is in the middle of the specified part of the web request and is preceded and followed by characters other than alphanumeric characters or underscore (_), for example, -BadBot;.

EXACTLY

The value of the specified part of the web request must exactly match the value of TargetString.

STARTS_WITH

The value of TargetString must appear at the beginning of the specified part of the web request.

ENDS_WITH

The value of TargetString must appear at the end of the specified part of the web request.

" - } - }, - "documentation":"

The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings.

" - }, - "ByteMatchTuples":{ - "type":"list", - "member":{"shape":"ByteMatchTuple"} - }, - "ChangeAction":{ - "type":"string", - "enum":[ - "INSERT", - "DELETE" - ] - }, - "ChangeToken":{ - "type":"string", - "min":1 - }, - "ChangeTokenStatus":{ - "type":"string", - "enum":[ - "PROVISIONED", - "PENDING", - "INSYNC" - ] - }, - "ComparisonOperator":{ - "type":"string", - "enum":[ - "EQ", - "NE", - "LE", - "LT", - "GE", - "GT" - ] - }, - "Country":{"type":"string"}, - "CreateByteMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the ByteMatchSet. You can't change Name after you create a ByteMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ByteMatchSet":{ - "shape":"ByteMatchSet", - "documentation":"

A ByteMatchSet that contains no ByteMatchTuple objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change Name after you create the GeoMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "GeoMatchSet":{ - "shape":"GeoMatchSet", - "documentation":"

The GeoMatchSet returned in the CreateGeoMatchSet response. The GeoMatchSet contains no GeoMatchConstraints.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateIPSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change Name after you create the IPSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateIPSetResponse":{ - "type":"structure", - "members":{ - "IPSet":{ - "shape":"IPSet", - "documentation":"

The IPSet returned in the CreateIPSet response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "RateKey", - "RateLimit", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RateBasedRule. You can't change the name of a RateBasedRule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RateBasedRule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RateBasedRule.

" - }, - "RateKey":{ - "shape":"RateKey", - "documentation":"

The field that AWS WAF uses to determine if requests are likely arriving from a single source and thus subject to rate monitoring. The only valid value for RateKey is IP. IP indicates that requests that arrive from the same IP address are subject to the RateLimit that is specified in the RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field that is specified by RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"RateBasedRule", - "documentation":"

The RateBasedRule that is returned in the CreateRateBasedRule response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "RegexMatchSet":{ - "shape":"RegexMatchSet", - "documentation":"

A RegexMatchSet that contains no RegexMatchTuple objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "RegexPatternSet":{ - "shape":"RegexPatternSet", - "documentation":"

A RegexPatternSet that contains no objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRuleGroupRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change Name after you create a RuleGroup.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRuleGroupResponse":{ - "type":"structure", - "members":{ - "RuleGroup":{ - "shape":"RuleGroup", - "documentation":"

An empty RuleGroup.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateRuleRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the Rule. You can't change the name of a Rule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this Rule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the Rule.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"Rule", - "documentation":"

The Rule returned in the CreateRule response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the SizeConstraintSet. You can't change Name after you create a SizeConstraintSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "SizeConstraintSet":{ - "shape":"SizeConstraintSet", - "documentation":"

A SizeConstraintSet that contains no SizeConstraint objects.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for the SqlInjectionMatchSet that you're creating. You can't change Name after you create the SqlInjectionMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to create a SqlInjectionMatchSet.

" - }, - "CreateSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "SqlInjectionMatchSet":{ - "shape":"SqlInjectionMatchSet", - "documentation":"

A SqlInjectionMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a CreateSqlInjectionMatchSet request.

" - }, - "CreateWebACLRequest":{ - "type":"structure", - "required":[ - "Name", - "MetricName", - "DefaultAction", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change Name after you create the WebACL.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this WebACL. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the WebACL.

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

The action that you want AWS WAF to take when a request doesn't match the criteria specified in any of the Rule objects that are associated with the WebACL.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "CreateWebACLResponse":{ - "type":"structure", - "members":{ - "WebACL":{ - "shape":"WebACL", - "documentation":"

The WebACL returned in the CreateWebACL response.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "CreateXssMatchSetRequest":{ - "type":"structure", - "required":[ - "Name", - "ChangeToken" - ], - "members":{ - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for the XssMatchSet that you're creating. You can't change Name after you create the XssMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to create an XssMatchSet.

" - }, - "CreateXssMatchSetResponse":{ - "type":"structure", - "members":{ - "XssMatchSet":{ - "shape":"XssMatchSet", - "documentation":"

An XssMatchSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the CreateXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a CreateXssMatchSet request.

" - }, - "DeleteByteMatchSetRequest":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ChangeToken" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to delete. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "ChangeToken" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetID of the GeoMatchSet that you want to delete. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteIPSetRequest":{ - "type":"structure", - "required":[ - "IPSetId", - "ChangeToken" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to delete. IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteIPSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeletePermissionPolicyRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup from which you want to delete the policy.

The user making the request must be the owner of the RuleGroup.

" - } - } - }, - "DeletePermissionPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to delete. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "ChangeToken" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to delete. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "ChangeToken" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to delete. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRuleGroupRequest":{ - "type":"structure", - "required":[ - "RuleGroupId", - "ChangeToken" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to delete. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRuleGroupResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to delete. RuleId is returned by CreateRule and by ListRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "ChangeToken" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to delete. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "ChangeToken" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to delete. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to delete a SqlInjectionMatchSet from AWS WAF.

" - }, - "DeleteSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a request to delete a SqlInjectionMatchSet from AWS WAF.

" - }, - "DeleteWebACLRequest":{ - "type":"structure", - "required":[ - "WebACLId", - "ChangeToken" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to delete. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "DeleteWebACLResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "DeleteXssMatchSetRequest":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "ChangeToken" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to delete. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - }, - "documentation":"

A request to delete an XssMatchSet from AWS WAF.

" - }, - "DeleteXssMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the DeleteXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to a request to delete an XssMatchSet from AWS WAF.

" - }, - "FieldToMatch":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"MatchFieldType", - "documentation":"

The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that you can search include the following:

  • HEADER: A specified request header, for example, the value of the User-Agent or Referer header. If you choose HEADER for the type, specify the name of the header in Data.

  • METHOD: The HTTP method, which indicated the type of operation that the request is asking the origin to perform. Amazon CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

  • QUERY_STRING: A query string, which is the part of a URL that appears after a ? character, if any.

  • URI: The part of a web request that identifies a resource, for example, /images/daily-ad.jpg.

  • BODY: The part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form. The request body immediately follows the request headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For more information, see CreateSizeConstraintSet.

" - }, - "Data":{ - "shape":"MatchFieldData", - "documentation":"

When the value of Type is HEADER, enter the name of the header that you want AWS WAF to search, for example, User-Agent or Referer. If the value of Type is any other value, omit Data.

The name of the header is not case sensitive.

" - } - }, - "documentation":"

Specifies where in a web request to look for TargetString.

" - }, - "GeoMatchConstraint":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"GeoMatchConstraintType", - "documentation":"

The type of geographical area you want AWS WAF to search for. Currently Country is the only valid value.

" - }, - "Value":{ - "shape":"GeoMatchConstraintValue", - "documentation":"

The country that you want AWS WAF to search for.

" - } - }, - "documentation":"

The country from which web requests originate that you want AWS WAF to search for.

" - }, - "GeoMatchConstraintType":{ - "type":"string", - "enum":["Country"] - }, - "GeoMatchConstraintValue":{ - "type":"string", - "enum":[ - "AF", - "AX", - "AL", - "DZ", - "AS", - "AD", - "AO", - "AI", - "AQ", - "AG", - "AR", - "AM", - "AW", - "AU", - "AT", - "AZ", - "BS", - "BH", - "BD", - "BB", - "BY", - "BE", - "BZ", - "BJ", - "BM", - "BT", - "BO", - "BQ", - "BA", - "BW", - "BV", - "BR", - "IO", - "BN", - "BG", - "BF", - "BI", - "KH", - "CM", - "CA", - "CV", - "KY", - "CF", - "TD", - "CL", - "CN", - "CX", - "CC", - "CO", - "KM", - "CG", - "CD", - "CK", - "CR", - "CI", - "HR", - "CU", - "CW", - "CY", - "CZ", - "DK", - "DJ", - "DM", - "DO", - "EC", - "EG", - "SV", - "GQ", - "ER", - "EE", - "ET", - "FK", - "FO", - "FJ", - "FI", - "FR", - "GF", - "PF", - "TF", - "GA", - "GM", - "GE", - "DE", - "GH", - "GI", - "GR", - "GL", - "GD", - "GP", - "GU", - "GT", - "GG", - "GN", - "GW", - "GY", - "HT", - "HM", - "VA", - "HN", - "HK", - "HU", - "IS", - "IN", - "ID", - "IR", - "IQ", - "IE", - "IM", - "IL", - "IT", - "JM", - "JP", - "JE", - "JO", - "KZ", - "KE", - "KI", - "KP", - "KR", - "KW", - "KG", - "LA", - "LV", - "LB", - "LS", - "LR", - "LY", - "LI", - "LT", - "LU", - "MO", - "MK", - "MG", - "MW", - "MY", - "MV", - "ML", - "MT", - "MH", - "MQ", - "MR", - "MU", - "YT", - "MX", - "FM", - "MD", - "MC", - "MN", - "ME", - "MS", - "MA", - "MZ", - "MM", - "NA", - "NR", - "NP", - "NL", - "NC", - "NZ", - "NI", - "NE", - "NG", - "NU", - "NF", - "MP", - "NO", - "OM", - "PK", - "PW", - "PS", - "PA", - "PG", - "PY", - "PE", - "PH", - "PN", - "PL", - "PT", - "PR", - "QA", - "RE", - "RO", - "RU", - "RW", - "BL", - "SH", - "KN", - "LC", - "MF", - "PM", - "VC", - "WS", - "SM", - "ST", - "SA", - "SN", - "RS", - "SC", - "SL", - "SG", - "SX", - "SK", - "SI", - "SB", - "SO", - "ZA", - "GS", - "SS", - "ES", - "LK", - "SD", - "SR", - "SJ", - "SZ", - "SE", - "CH", - "SY", - "TW", - "TJ", - "TZ", - "TH", - "TL", - "TG", - "TK", - "TO", - "TT", - "TN", - "TR", - "TM", - "TC", - "TV", - "UG", - "UA", - "AE", - "GB", - "US", - "UM", - "UY", - "UZ", - "VU", - "VE", - "VN", - "VG", - "VI", - "WF", - "EH", - "YE", - "ZM", - "ZW" - ] - }, - "GeoMatchConstraints":{ - "type":"list", - "member":{"shape":"GeoMatchConstraint"} - }, - "GeoMatchSet":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "GeoMatchConstraints" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId for an GeoMatchSet. You use GeoMatchSetId to get information about a GeoMatchSet (see GeoMatchSet), update a GeoMatchSet (see UpdateGeoMatchSet), insert a GeoMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a GeoMatchSet from AWS WAF (see DeleteGeoMatchSet).

GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change the name of an GeoMatchSet after you create it.

" - }, - "GeoMatchConstraints":{ - "shape":"GeoMatchConstraints", - "documentation":"

An array of GeoMatchConstraint objects, which contain the country that you want AWS WAF to search for.

" - } - }, - "documentation":"

Contains one or more countries that AWS WAF will search for.

" - }, - "GeoMatchSetSummaries":{ - "type":"list", - "member":{"shape":"GeoMatchSetSummary"} - }, - "GeoMatchSetSummary":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "Name" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId for an GeoMatchSet. You can use GeoMatchSetId in a GetGeoMatchSet request to get detailed information about an GeoMatchSet.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the GeoMatchSet. You can't change the name of an GeoMatchSet after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name of the GeoMatchSet.

" - }, - "GeoMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "GeoMatchConstraint" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a country with UpdateGeoMatchSet.

" - }, - "GeoMatchConstraint":{ - "shape":"GeoMatchConstraint", - "documentation":"

The country from which web requests originate that you want AWS WAF to search for.

" - } - }, - "documentation":"

Specifies the type of update to perform to an GeoMatchSet with UpdateGeoMatchSet.

" - }, - "GeoMatchSetUpdates":{ - "type":"list", - "member":{"shape":"GeoMatchSetUpdate"}, - "min":1 - }, - "GetByteMatchSetRequest":{ - "type":"structure", - "required":["ByteMatchSetId"], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to get. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - } - } - }, - "GetByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ByteMatchSet":{ - "shape":"ByteMatchSet", - "documentation":"

Information about the ByteMatchSet that you specified in the GetByteMatchSet request. For more information, see the following topics:

  • ByteMatchSet: Contains ByteMatchSetId, ByteMatchTuples, and Name

  • ByteMatchTuples: Contains an array of ByteMatchTuple objects. Each ByteMatchTuple object contains FieldToMatch, PositionalConstraint, TargetString, and TextTransformation

  • FieldToMatch: Contains Data and Type

" - } - } - }, - "GetChangeTokenRequest":{ - "type":"structure", - "members":{ - } - }, - "GetChangeTokenResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used in the request. Use this value in a GetChangeTokenStatus request to get the current status of the request.

" - } - } - }, - "GetChangeTokenStatusRequest":{ - "type":"structure", - "required":["ChangeToken"], - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The change token for which you want to get the status. This change token was previously returned in the GetChangeToken response.

" - } - } - }, - "GetChangeTokenStatusResponse":{ - "type":"structure", - "members":{ - "ChangeTokenStatus":{ - "shape":"ChangeTokenStatus", - "documentation":"

The status of the change token.

" - } - } - }, - "GetGeoMatchSetRequest":{ - "type":"structure", - "required":["GeoMatchSetId"], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId of the GeoMatchSet that you want to get. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - } - } - }, - "GetGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "GeoMatchSet":{ - "shape":"GeoMatchSet", - "documentation":"

Information about the GeoMatchSet that you specified in the GetGeoMatchSet request. This includes the Type, which for a GeoMatchContraint is always Country, as well as the Value, which is the identifier for a specific country.

" - } - } - }, - "GetIPSetRequest":{ - "type":"structure", - "required":["IPSetId"], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to get. IPSetId is returned by CreateIPSet and by ListIPSets.

" - } - } - }, - "GetIPSetResponse":{ - "type":"structure", - "members":{ - "IPSet":{ - "shape":"IPSet", - "documentation":"

Information about the IPSet that you specified in the GetIPSet request. For more information, see the following topics:

  • IPSet: Contains IPSetDescriptors, IPSetId, and Name

  • IPSetDescriptors: Contains an array of IPSetDescriptor objects. Each IPSetDescriptor object contains Type and Value

" - } - } - }, - "GetPermissionPolicyRequest":{ - "type":"structure", - "required":["ResourceArn"], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup for which you want to get the policy.

" - } - } - }, - "GetPermissionPolicyResponse":{ - "type":"structure", - "members":{ - "Policy":{ - "shape":"PolicyString", - "documentation":"

The IAM policy attached to the specified RuleGroup.

" - } - } - }, - "GetRateBasedRuleManagedKeysRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule for which you want to get a list of ManagedKeys. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

A null value and not currently used. Do not include this in your request.

" - } - } - }, - "GetRateBasedRuleManagedKeysResponse":{ - "type":"structure", - "members":{ - "ManagedKeys":{ - "shape":"ManagedKeys", - "documentation":"

An array of IP addresses that currently are blocked by the specified RateBasedRule.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

A null value and not currently used.

" - } - } - }, - "GetRateBasedRuleRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to get. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - } - } - }, - "GetRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"RateBasedRule", - "documentation":"

Information about the RateBasedRule that you specified in the GetRateBasedRule request.

" - } - } - }, - "GetRegexMatchSetRequest":{ - "type":"structure", - "required":["RegexMatchSetId"], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to get. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - } - } - }, - "GetRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "RegexMatchSet":{ - "shape":"RegexMatchSet", - "documentation":"

Information about the RegexMatchSet that you specified in the GetRegexMatchSet request. For more information, see RegexMatchTuple.

" - } - } - }, - "GetRegexPatternSetRequest":{ - "type":"structure", - "required":["RegexPatternSetId"], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to get. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - } - } - }, - "GetRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "RegexPatternSet":{ - "shape":"RegexPatternSet", - "documentation":"

Information about the RegexPatternSet that you specified in the GetRegexPatternSet request, including the identifier of the pattern set and the regular expression patterns you want AWS WAF to search for.

" - } - } - }, - "GetRuleGroupRequest":{ - "type":"structure", - "required":["RuleGroupId"], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to get. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - } - } - }, - "GetRuleGroupResponse":{ - "type":"structure", - "members":{ - "RuleGroup":{ - "shape":"RuleGroup", - "documentation":"

Information about the RuleGroup that you specified in the GetRuleGroup request.

" - } - } - }, - "GetRuleRequest":{ - "type":"structure", - "required":["RuleId"], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to get. RuleId is returned by CreateRule and by ListRules.

" - } - } - }, - "GetRuleResponse":{ - "type":"structure", - "members":{ - "Rule":{ - "shape":"Rule", - "documentation":"

Information about the Rule that you specified in the GetRule request. For more information, see the following topics:

  • Rule: Contains MetricName, Name, an array of Predicate objects, and RuleId

  • Predicate: Each Predicate object contains DataId, Negated, and Type

" - } - } - }, - "GetSampledRequestsMaxItems":{ - "type":"long", - "max":500, - "min":1 - }, - "GetSampledRequestsRequest":{ - "type":"structure", - "required":[ - "WebAclId", - "RuleId", - "TimeWindow", - "MaxItems" - ], - "members":{ - "WebAclId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL for which you want GetSampledRequests to return a sample of requests.

" - }, - "RuleId":{ - "shape":"ResourceId", - "documentation":"

RuleId is one of three values:

  • The RuleId of the Rule or the RuleGroupId of the RuleGroup for which you want GetSampledRequests to return a sample of requests.

  • Default_Action, which causes GetSampledRequests to return a sample of the requests that didn't match any of the rules in the specified WebACL.

" - }, - "TimeWindow":{ - "shape":"TimeWindow", - "documentation":"

The start date and time and the end date and time of the range for which you want GetSampledRequests to return a sample of requests. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - }, - "MaxItems":{ - "shape":"GetSampledRequestsMaxItems", - "documentation":"

The number of requests that you want AWS WAF to return from among the first 5,000 requests that your AWS resource received during the time range. If your resource received fewer requests than the value of MaxItems, GetSampledRequests returns information about all of them.

" - } - } - }, - "GetSampledRequestsResponse":{ - "type":"structure", - "members":{ - "SampledRequests":{ - "shape":"SampledHTTPRequests", - "documentation":"

A complex type that contains detailed information about each of the requests in the sample.

" - }, - "PopulationSize":{ - "shape":"PopulationSize", - "documentation":"

The total number of requests from which GetSampledRequests got a sample of MaxItems requests. If PopulationSize is less than MaxItems, the sample includes every request that your AWS resource received during the specified time range.

" - }, - "TimeWindow":{ - "shape":"TimeWindow", - "documentation":"

Usually, TimeWindow is the time range that you specified in the GetSampledRequests request. However, if your AWS resource received more than 5,000 requests during the time range that you specified in the request, GetSampledRequests returns the time range for the first 5,000 requests.

" - } - } - }, - "GetSizeConstraintSetRequest":{ - "type":"structure", - "required":["SizeConstraintSetId"], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to get. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - } - } - }, - "GetSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "SizeConstraintSet":{ - "shape":"SizeConstraintSet", - "documentation":"

Information about the SizeConstraintSet that you specified in the GetSizeConstraintSet request. For more information, see the following topics:

" - } - } - }, - "GetSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":["SqlInjectionMatchSetId"], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to get. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - } - }, - "documentation":"

A request to get a SqlInjectionMatchSet.

" - }, - "GetSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "SqlInjectionMatchSet":{ - "shape":"SqlInjectionMatchSet", - "documentation":"

Information about the SqlInjectionMatchSet that you specified in the GetSqlInjectionMatchSet request. For more information, see the following topics:

" - } - }, - "documentation":"

The response to a GetSqlInjectionMatchSet request.

" - }, - "GetWebACLRequest":{ - "type":"structure", - "required":["WebACLId"], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to get. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - } - } - }, - "GetWebACLResponse":{ - "type":"structure", - "members":{ - "WebACL":{ - "shape":"WebACL", - "documentation":"

Information about the WebACL that you specified in the GetWebACL request. For more information, see the following topics:

  • WebACL: Contains DefaultAction, MetricName, Name, an array of Rule objects, and WebACLId

  • DefaultAction (Data type is WafAction): Contains Type

  • Rules: Contains an array of ActivatedRule objects, which contain Action, Priority, and RuleId

  • Action: Contains Type

" - } - } - }, - "GetXssMatchSetRequest":{ - "type":"structure", - "required":["XssMatchSetId"], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to get. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - } - }, - "documentation":"

A request to get an XssMatchSet.

" - }, - "GetXssMatchSetResponse":{ - "type":"structure", - "members":{ - "XssMatchSet":{ - "shape":"XssMatchSet", - "documentation":"

Information about the XssMatchSet that you specified in the GetXssMatchSet request. For more information, see the following topics:

  • XssMatchSet: Contains Name, XssMatchSetId, and an array of XssMatchTuple objects

  • XssMatchTuple: Each XssMatchTuple object contains FieldToMatch and TextTransformation

  • FieldToMatch: Contains Data and Type

" - } - }, - "documentation":"

The response to a GetXssMatchSet request.

" - }, - "HTTPHeader":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"HeaderName", - "documentation":"

The name of one of the headers in the sampled web request.

" - }, - "Value":{ - "shape":"HeaderValue", - "documentation":"

The value of one of the headers in the sampled web request.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes an HTTPHeader complex type that appears as Headers in the response syntax. HTTPHeader contains the names and values of all of the headers that appear in one of the web requests that were returned by GetSampledRequests.

" - }, - "HTTPHeaders":{ - "type":"list", - "member":{"shape":"HTTPHeader"} - }, - "HTTPMethod":{"type":"string"}, - "HTTPRequest":{ - "type":"structure", - "members":{ - "ClientIP":{ - "shape":"IPString", - "documentation":"

The IP address that the request originated from. If the WebACL is associated with a CloudFront distribution, this is the value of one of the following fields in CloudFront access logs:

  • c-ip, if the viewer did not use an HTTP proxy or a load balancer to send the request

  • x-forwarded-for, if the viewer did use an HTTP proxy or a load balancer to send the request

" - }, - "Country":{ - "shape":"Country", - "documentation":"

The two-letter country code for the country that the request originated from. For a current list of country codes, see the Wikipedia entry ISO 3166-1 alpha-2.

" - }, - "URI":{ - "shape":"URIString", - "documentation":"

The part of a web request that identifies the resource, for example, /images/daily-ad.jpg.

" - }, - "Method":{ - "shape":"HTTPMethod", - "documentation":"

The HTTP method specified in the sampled web request. CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

" - }, - "HTTPVersion":{ - "shape":"HTTPVersion", - "documentation":"

The HTTP version specified in the sampled web request, for example, HTTP/1.1.

" - }, - "Headers":{ - "shape":"HTTPHeaders", - "documentation":"

A complex type that contains two values for each header in the sampled web request: the name of the header and the value of the header.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes an HTTPRequest complex type that appears as Request in the response syntax. HTTPRequest contains information about one of the web requests that were returned by GetSampledRequests.

" - }, - "HTTPVersion":{"type":"string"}, - "HeaderName":{"type":"string"}, - "HeaderValue":{"type":"string"}, - "IPSet":{ - "type":"structure", - "required":[ - "IPSetId", - "IPSetDescriptors" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId for an IPSet. You use IPSetId to get information about an IPSet (see GetIPSet), update an IPSet (see UpdateIPSet), insert an IPSet into a Rule or delete one from a Rule (see UpdateRule), and delete an IPSet from AWS WAF (see DeleteIPSet).

IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change the name of an IPSet after you create it.

" - }, - "IPSetDescriptors":{ - "shape":"IPSetDescriptors", - "documentation":"

The IP address type (IPV4 or IPV6) and the IP address range (in CIDR notation) that web requests originate from. If the WebACL is associated with a CloudFront distribution and the viewer did not use an HTTP proxy or a load balancer to send the request, this is the value of the c-ip field in the CloudFront access logs.

" - } - }, - "documentation":"

Contains one or more IP addresses or blocks of IP addresses specified in Classless Inter-Domain Routing (CIDR) notation. AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6.

To specify an individual IP address, you specify the four-part IP address followed by a /32, for example, 192.0.2.0/31. To block a range of IP addresses, you can specify a /128, /64, /56, /48, /32, /24, /16, or /8 CIDR. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

" - }, - "IPSetDescriptor":{ - "type":"structure", - "required":[ - "Type", - "Value" - ], - "members":{ - "Type":{ - "shape":"IPSetDescriptorType", - "documentation":"

Specify IPV4 or IPV6.

" - }, - "Value":{ - "shape":"IPSetDescriptorValue", - "documentation":"

Specify an IPv4 address by using CIDR notation. For example:

  • To configure AWS WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify 192.0.2.44/32.

  • To configure AWS WAF to allow, block, or count requests that originated from IP addresses from 192.0.2.0 to 192.0.2.255, specify 192.0.2.0/24.

For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.

Specify an IPv6 address by using CIDR notation. For example:

  • To configure AWS WAF to allow, block, or count requests that originated from the IP address 1111:0000:0000:0000:0000:0000:0000:0111, specify 1111:0000:0000:0000:0000:0000:0000:0111/128.

  • To configure AWS WAF to allow, block, or count requests that originated from IP addresses 1111:0000:0000:0000:0000:0000:0000:0000 to 1111:0000:0000:0000:ffff:ffff:ffff:ffff, specify 1111:0000:0000:0000:0000:0000:0000:0000/64.

" - } - }, - "documentation":"

Specifies the IP address type (IPV4 or IPV6) and the IP address range (in CIDR format) that web requests originate from.

" - }, - "IPSetDescriptorType":{ - "type":"string", - "enum":[ - "IPV4", - "IPV6" - ] - }, - "IPSetDescriptorValue":{"type":"string"}, - "IPSetDescriptors":{ - "type":"list", - "member":{"shape":"IPSetDescriptor"} - }, - "IPSetSummaries":{ - "type":"list", - "member":{"shape":"IPSetSummary"} - }, - "IPSetSummary":{ - "type":"structure", - "required":[ - "IPSetId", - "Name" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId for an IPSet. You can use IPSetId in a GetIPSet request to get detailed information about an IPSet.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the IPSet. You can't change the name of an IPSet after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name of the IPSet.

" - }, - "IPSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "IPSetDescriptor" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete an IP address with UpdateIPSet.

" - }, - "IPSetDescriptor":{ - "shape":"IPSetDescriptor", - "documentation":"

The IP address type (IPV4 or IPV6) and the IP address range (in CIDR notation) that web requests originate from.

" - } - }, - "documentation":"

Specifies the type of update to perform to an IPSet with UpdateIPSet.

" - }, - "IPSetUpdates":{ - "type":"list", - "member":{"shape":"IPSetUpdate"}, - "min":1 - }, - "IPString":{"type":"string"}, - "ListActivatedRulesInRuleGroupRequest":{ - "type":"structure", - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup for which you want to get a list of ActivatedRule objects.

" - }, - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ActivatedRules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ActivatedRules. For the second and subsequent ListActivatedRulesInRuleGroup requests, specify the value of NextMarker from the previous response to get information about another batch of ActivatedRules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of ActivatedRules that you want AWS WAF to return for this request. If you have more ActivatedRules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of ActivatedRules.

" - } - } - }, - "ListActivatedRulesInRuleGroupResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more ActivatedRules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more ActivatedRules, submit another ListActivatedRulesInRuleGroup request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "ActivatedRules":{ - "shape":"ActivatedRules", - "documentation":"

An array of ActivatedRules objects.

" - } - } - }, - "ListByteMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ByteMatchSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ByteMatchSets. For the second and subsequent ListByteMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of ByteMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of ByteMatchSet objects that you want AWS WAF to return for this request. If you have more ByteMatchSets objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of ByteMatchSet objects.

" - } - } - }, - "ListByteMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more ByteMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more ByteMatchSet objects, submit another ListByteMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "ByteMatchSets":{ - "shape":"ByteMatchSetSummaries", - "documentation":"

An array of ByteMatchSetSummary objects.

" - } - } - }, - "ListGeoMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more GeoMatchSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of GeoMatchSet objects. For the second and subsequent ListGeoMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of GeoMatchSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of GeoMatchSet objects that you want AWS WAF to return for this request. If you have more GeoMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of GeoMatchSet objects.

" - } - } - }, - "ListGeoMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more GeoMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more GeoMatchSet objects, submit another ListGeoMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "GeoMatchSets":{ - "shape":"GeoMatchSetSummaries", - "documentation":"

An array of GeoMatchSetSummary objects.

" - } - } - }, - "ListIPSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more IPSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of IPSets. For the second and subsequent ListIPSets requests, specify the value of NextMarker from the previous response to get information about another batch of IPSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of IPSet objects that you want AWS WAF to return for this request. If you have more IPSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of IPSet objects.

" - } - } - }, - "ListIPSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more IPSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more IPSet objects, submit another ListIPSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "IPSets":{ - "shape":"IPSetSummaries", - "documentation":"

An array of IPSetSummary objects.

" - } - } - }, - "ListRateBasedRulesRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more Rules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of Rules. For the second and subsequent ListRateBasedRules requests, specify the value of NextMarker from the previous response to get information about another batch of Rules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of Rules that you want AWS WAF to return for this request. If you have more Rules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - } - }, - "ListRateBasedRulesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more Rules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more Rules, submit another ListRateBasedRules request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "Rules":{ - "shape":"RuleSummaries", - "documentation":"

An array of RuleSummary objects.

" - } - } - }, - "ListRegexMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RegexMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of ByteMatchSets. For the second and subsequent ListRegexMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of RegexMatchSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RegexMatchSet objects that you want AWS WAF to return for this request. If you have more RegexMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RegexMatchSet objects.

" - } - } - }, - "ListRegexMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RegexMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RegexMatchSet objects, submit another ListRegexMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RegexMatchSets":{ - "shape":"RegexMatchSetSummaries", - "documentation":"

An array of RegexMatchSetSummary objects.

" - } - } - }, - "ListRegexPatternSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RegexPatternSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of RegexPatternSet objects. For the second and subsequent ListRegexPatternSets requests, specify the value of NextMarker from the previous response to get information about another batch of RegexPatternSet objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RegexPatternSet objects that you want AWS WAF to return for this request. If you have more RegexPatternSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RegexPatternSet objects.

" - } - } - }, - "ListRegexPatternSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RegexPatternSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RegexPatternSet objects, submit another ListRegexPatternSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RegexPatternSets":{ - "shape":"RegexPatternSetSummaries", - "documentation":"

An array of RegexPatternSetSummary objects.

" - } - } - }, - "ListRuleGroupsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more RuleGroups than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of RuleGroups. For the second and subsequent ListRuleGroups requests, specify the value of NextMarker from the previous response to get information about another batch of RuleGroups.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of RuleGroups that you want AWS WAF to return for this request. If you have more RuleGroups than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of RuleGroups.

" - } - } - }, - "ListRuleGroupsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more RuleGroups than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more RuleGroups, submit another ListRuleGroups request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RuleGroups":{ - "shape":"RuleGroupSummaries", - "documentation":"

An array of RuleGroup objects.

" - } - } - }, - "ListRulesRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more Rules than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of Rules. For the second and subsequent ListRules requests, specify the value of NextMarker from the previous response to get information about another batch of Rules.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of Rules that you want AWS WAF to return for this request. If you have more Rules than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - } - }, - "ListRulesResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more Rules than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more Rules, submit another ListRules request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "Rules":{ - "shape":"RuleSummaries", - "documentation":"

An array of RuleSummary objects.

" - } - } - }, - "ListSizeConstraintSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more SizeConstraintSets than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of SizeConstraintSets. For the second and subsequent ListSizeConstraintSets requests, specify the value of NextMarker from the previous response to get information about another batch of SizeConstraintSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of SizeConstraintSet objects that you want AWS WAF to return for this request. If you have more SizeConstraintSets objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of SizeConstraintSet objects.

" - } - } - }, - "ListSizeConstraintSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more SizeConstraintSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more SizeConstraintSet objects, submit another ListSizeConstraintSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "SizeConstraintSets":{ - "shape":"SizeConstraintSetSummaries", - "documentation":"

An array of SizeConstraintSetSummary objects.

" - } - } - }, - "ListSqlInjectionMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more SqlInjectionMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of SqlInjectionMatchSets. For the second and subsequent ListSqlInjectionMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of SqlInjectionMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of SqlInjectionMatchSet objects that you want AWS WAF to return for this request. If you have more SqlInjectionMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - }, - "documentation":"

A request to list the SqlInjectionMatchSet objects created by the current AWS account.

" - }, - "ListSqlInjectionMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more SqlInjectionMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more SqlInjectionMatchSet objects, submit another ListSqlInjectionMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "SqlInjectionMatchSets":{ - "shape":"SqlInjectionMatchSetSummaries", - "documentation":"

An array of SqlInjectionMatchSetSummary objects.

" - } - }, - "documentation":"

The response to a ListSqlInjectionMatchSets request.

" - }, - "ListSubscribedRuleGroupsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more ByteMatchSetssubscribed rule groups than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of subscribed rule groups. For the second and subsequent ListSubscribedRuleGroupsRequest requests, specify the value of NextMarker from the previous response to get information about another batch of subscribed rule groups.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of subscribed rule groups that you want AWS WAF to return for this request. If you have more objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of objects.

" - } - } - }, - "ListSubscribedRuleGroupsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more objects, submit another ListSubscribedRuleGroups request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "RuleGroups":{ - "shape":"SubscribedRuleGroupSummaries", - "documentation":"

An array of RuleGroup objects.

" - } - } - }, - "ListWebACLsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more WebACL objects than the number that you specify for Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of WebACL objects. For the second and subsequent ListWebACLs requests, specify the value of NextMarker from the previous response to get information about another batch of WebACL objects.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of WebACL objects that you want AWS WAF to return for this request. If you have more WebACL objects than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of WebACL objects.

" - } - } - }, - "ListWebACLsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more WebACL objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more WebACL objects, submit another ListWebACLs request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "WebACLs":{ - "shape":"WebACLSummaries", - "documentation":"

An array of WebACLSummary objects.

" - } - } - }, - "ListXssMatchSetsRequest":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you specify a value for Limit and you have more XssMatchSet objects than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of XssMatchSets. For the second and subsequent ListXssMatchSets requests, specify the value of NextMarker from the previous response to get information about another batch of XssMatchSets.

" - }, - "Limit":{ - "shape":"PaginationLimit", - "documentation":"

Specifies the number of XssMatchSet objects that you want AWS WAF to return for this request. If you have more XssMatchSet objects than the number you specify for Limit, the response includes a NextMarker value that you can use to get another batch of Rules.

" - } - }, - "documentation":"

A request to list the XssMatchSet objects created by the current AWS account.

" - }, - "ListXssMatchSetsResponse":{ - "type":"structure", - "members":{ - "NextMarker":{ - "shape":"NextMarker", - "documentation":"

If you have more XssMatchSet objects than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more XssMatchSet objects, submit another ListXssMatchSets request, and specify the NextMarker value from the response in the NextMarker value in the next request.

" - }, - "XssMatchSets":{ - "shape":"XssMatchSetSummaries", - "documentation":"

An array of XssMatchSetSummary objects.

" - } - }, - "documentation":"

The response to a ListXssMatchSets request.

" - }, - "ManagedKey":{"type":"string"}, - "ManagedKeys":{ - "type":"list", - "member":{"shape":"ManagedKey"} - }, - "MatchFieldData":{"type":"string"}, - "MatchFieldType":{ - "type":"string", - "enum":[ - "URI", - "QUERY_STRING", - "HEADER", - "METHOD", - "BODY" - ] - }, - "MetricName":{"type":"string"}, - "Negated":{"type":"boolean"}, - "NextMarker":{ - "type":"string", - "min":1 - }, - "PaginationLimit":{ - "type":"integer", - "max":100, - "min":0 - }, - "ParameterExceptionField":{ - "type":"string", - "enum":[ - "CHANGE_ACTION", - "WAF_ACTION", - "WAF_OVERRIDE_ACTION", - "PREDICATE_TYPE", - "IPSET_TYPE", - "BYTE_MATCH_FIELD_TYPE", - "SQL_INJECTION_MATCH_FIELD_TYPE", - "BYTE_MATCH_TEXT_TRANSFORMATION", - "BYTE_MATCH_POSITIONAL_CONSTRAINT", - "SIZE_CONSTRAINT_COMPARISON_OPERATOR", - "GEO_MATCH_LOCATION_TYPE", - "GEO_MATCH_LOCATION_VALUE", - "RATE_KEY", - "RULE_TYPE", - "NEXT_MARKER" - ] - }, - "ParameterExceptionParameter":{ - "type":"string", - "min":1 - }, - "ParameterExceptionReason":{ - "type":"string", - "enum":[ - "INVALID_OPTION", - "ILLEGAL_COMBINATION" - ] - }, - "PolicyString":{ - "type":"string", - "min":1 - }, - "PopulationSize":{"type":"long"}, - "PositionalConstraint":{ - "type":"string", - "enum":[ - "EXACTLY", - "STARTS_WITH", - "ENDS_WITH", - "CONTAINS", - "CONTAINS_WORD" - ] - }, - "Predicate":{ - "type":"structure", - "required":[ - "Negated", - "Type", - "DataId" - ], - "members":{ - "Negated":{ - "shape":"Negated", - "documentation":"

Set Negated to False if you want AWS WAF to allow, block, or count requests based on the settings in the specified ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, or SizeConstraintSet. For example, if an IPSet includes the IP address 192.0.2.44, AWS WAF will allow or block requests based on that IP address.

Set Negated to True if you want AWS WAF to allow or block a request based on the negation of the settings in the ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, or SizeConstraintSet. For example, if an IPSet includes the IP address 192.0.2.44, AWS WAF will allow, block, or count requests based on all IP addresses except 192.0.2.44.

" - }, - "Type":{ - "shape":"PredicateType", - "documentation":"

The type of predicate in a Rule, such as ByteMatchSet or IPSet.

" - }, - "DataId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a predicate in a Rule, such as ByteMatchSetId or IPSetId. The ID is returned by the corresponding Create or List command.

" - } - }, - "documentation":"

Specifies the ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, and SizeConstraintSet objects that you want to add to a Rule and, for each object, indicates whether you want to negate the settings, for example, requests that do NOT originate from the IP address 192.0.2.44.

" - }, - "PredicateType":{ - "type":"string", - "enum":[ - "IPMatch", - "ByteMatch", - "SqlInjectionMatch", - "GeoMatch", - "SizeConstraint", - "XssMatch", - "RegexMatch" - ] - }, - "Predicates":{ - "type":"list", - "member":{"shape":"Predicate"} - }, - "PutPermissionPolicyRequest":{ - "type":"structure", - "required":[ - "ResourceArn", - "Policy" - ], - "members":{ - "ResourceArn":{ - "shape":"ResourceArn", - "documentation":"

The Amazon Resource Name (ARN) of the RuleGroup to which you want to attach the policy.

" - }, - "Policy":{ - "shape":"PolicyString", - "documentation":"

The policy to attach to the specified RuleGroup.

" - } - } - }, - "PutPermissionPolicyResponse":{ - "type":"structure", - "members":{ - } - }, - "RateBasedRule":{ - "type":"structure", - "required":[ - "RuleId", - "MatchPredicates", - "RateKey", - "RateLimit" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RateBasedRule. You use RuleId to get more information about a RateBasedRule (see GetRateBasedRule), update a RateBasedRule (see UpdateRateBasedRule), insert a RateBasedRule into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a RateBasedRule from AWS WAF (see DeleteRateBasedRule).

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description for a RateBasedRule. You can't change the name of a RateBasedRule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for a RateBasedRule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RateBasedRule.

" - }, - "MatchPredicates":{ - "shape":"Predicates", - "documentation":"

The Predicates object contains one Predicate element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in a RateBasedRule.

" - }, - "RateKey":{ - "shape":"RateKey", - "documentation":"

The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value for RateKey is IP. IP indicates that requests arriving from the same IP address are subject to the RateLimit that is specified in the RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field specified by the RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - } - }, - "documentation":"

A RateBasedRule is identical to a regular Rule, with one addition: a RateBasedRule counts the number of requests that arrive from a specified IP address every five minutes. For example, based on recent requests that you've seen from an attacker, you might create a RateBasedRule that includes the following conditions:

  • The requests come from 192.0.2.44.

  • They contain the value BadBot in the User-Agent header.

In the rule, you also define the rate limit as 15,000.

Requests that meet both of these conditions and exceed 15,000 requests every five minutes trigger the rule's action (block or count), which is defined in the web ACL.

" - }, - "RateKey":{ - "type":"string", - "enum":["IP"] - }, - "RateLimit":{ - "type":"long", - "min":2000 - }, - "RegexMatchSet":{ - "type":"structure", - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId for a RegexMatchSet. You use RegexMatchSetId to get information about a RegexMatchSet (see GetRegexMatchSet), update a RegexMatchSet (see UpdateRegexMatchSet), insert a RegexMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a RegexMatchSet from AWS WAF (see DeleteRegexMatchSet).

RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - }, - "RegexMatchTuples":{ - "shape":"RegexMatchTuples", - "documentation":"

Contains an array of RegexMatchTuple objects. Each RegexMatchTuple object contains:

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

" - } - }, - "documentation":"

In a GetRegexMatchSet request, RegexMatchSet is a complex type that contains the RegexMatchSetId and Name of a RegexMatchSet, and the values that you specified when you updated the RegexMatchSet.

The values are contained in a RegexMatchTuple object, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a RegexMatchSet contains more than one RegexMatchTuple object, a request needs to match the settings in only one ByteMatchTuple to be considered a match.

" - }, - "RegexMatchSetSummaries":{ - "type":"list", - "member":{"shape":"RegexMatchSetSummary"} - }, - "RegexMatchSetSummary":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "Name" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId for a RegexMatchSet. You use RegexMatchSetId to get information about a RegexMatchSet, update a RegexMatchSet, remove a RegexMatchSet from a Rule, and delete a RegexMatchSet from AWS WAF.

RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexMatchSet. You can't change Name after you create a RegexMatchSet.

" - } - }, - "documentation":"

Returned by ListRegexMatchSets. Each RegexMatchSetSummary object includes the Name and RegexMatchSetId for one RegexMatchSet.

" - }, - "RegexMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "RegexMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a RegexMatchTuple.

" - }, - "RegexMatchTuple":{ - "shape":"RegexMatchTuple", - "documentation":"

Information about the part of a web request that you want AWS WAF to inspect and the identifier of the regular expression (regex) pattern that you want AWS WAF to search for. If you specify DELETE for the value of Action, the RegexMatchTuple values must exactly match the values in the RegexMatchTuple that you want to delete from the RegexMatchSet.

" - } - }, - "documentation":"

In an UpdateRegexMatchSet request, RegexMatchSetUpdate specifies whether to insert or delete a RegexMatchTuple and includes the settings for the RegexMatchTuple.

" - }, - "RegexMatchSetUpdates":{ - "type":"list", - "member":{"shape":"RegexMatchSetUpdate"}, - "min":1 - }, - "RegexMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation", - "RegexPatternSetId" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for the RegexPatternSet.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on RegexPatternSet before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - }, - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId for a RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet (see GetRegexPatternSet), update a RegexPatternSet (see UpdateRegexPatternSet), insert a RegexPatternSet into a RegexMatchSet or delete one from a RegexMatchSet (see UpdateRegexMatchSet), and delete an RegexPatternSet from AWS WAF (see DeleteRegexPatternSet).

RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - } - }, - "documentation":"

The regular expression pattern that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings. Each RegexMatchTuple object contains:

  • The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

  • The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

  • Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

" - }, - "RegexMatchTuples":{ - "type":"list", - "member":{"shape":"RegexMatchTuple"} - }, - "RegexPatternSet":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "RegexPatternStrings" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The identifier for the RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet, update a RegexPatternSet, remove a RegexPatternSet from a RegexMatchSet, and delete a RegexPatternSet from AWS WAF.

RegexMatchSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - }, - "RegexPatternStrings":{ - "shape":"RegexPatternStrings", - "documentation":"

Specifies the regular expression (regex) patterns that you want AWS WAF to search for, such as B[a@]dB[o0]t.

" - } - }, - "documentation":"

The RegexPatternSet specifies the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

" - }, - "RegexPatternSetSummaries":{ - "type":"list", - "member":{"shape":"RegexPatternSetSummary"} - }, - "RegexPatternSetSummary":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "Name" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId for a RegexPatternSet. You use RegexPatternSetId to get information about a RegexPatternSet, update a RegexPatternSet, remove a RegexPatternSet from a RegexMatchSet, and delete a RegexPatternSet from AWS WAF.

RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RegexPatternSet. You can't change Name after you create a RegexPatternSet.

" - } - }, - "documentation":"

Returned by ListRegexPatternSets. Each RegexPatternSetSummary object includes the Name and RegexPatternSetId for one RegexPatternSet.

" - }, - "RegexPatternSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "RegexPatternString" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert or delete a RegexPatternString.

" - }, - "RegexPatternString":{ - "shape":"RegexPatternString", - "documentation":"

Specifies the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t.

" - } - }, - "documentation":"

In an UpdateRegexPatternSet request, RegexPatternSetUpdate specifies whether to insert or delete a RegexPatternString and includes the settings for the RegexPatternString.

" - }, - "RegexPatternSetUpdates":{ - "type":"list", - "member":{"shape":"RegexPatternSetUpdate"}, - "min":1 - }, - "RegexPatternString":{ - "type":"string", - "min":1 - }, - "RegexPatternStrings":{ - "type":"list", - "member":{"shape":"RegexPatternString"}, - "max":10 - }, - "ResourceArn":{ - "type":"string", - "max":1224, - "min":1 - }, - "ResourceId":{ - "type":"string", - "max":128, - "min":1 - }, - "ResourceName":{ - "type":"string", - "max":128, - "min":1 - }, - "Rule":{ - "type":"structure", - "required":[ - "RuleId", - "Predicates" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The friendly name or description for the Rule. You can't change the name of a Rule after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this Rule. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the Rule.

" - }, - "Predicates":{ - "shape":"Predicates", - "documentation":"

The Predicates object contains one Predicate element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in a Rule.

" - } - }, - "documentation":"

A combination of ByteMatchSet, IPSet, and/or SqlInjectionMatchSet objects that identify the web requests that you want to allow, block, or count. For example, you might create a Rule that includes the following predicates:

  • An IPSet that causes AWS WAF to search for web requests that originate from the IP address 192.0.2.44

  • A ByteMatchSet that causes AWS WAF to search for web requests for which the value of the User-Agent header is BadBot.

To match the settings in this Rule, a request must originate from 192.0.2.44 AND include a User-Agent header for which the value is BadBot.

" - }, - "RuleGroup":{ - "type":"structure", - "required":["RuleGroupId"], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup. You use RuleGroupId to get more information about a RuleGroup (see GetRuleGroup), update a RuleGroup (see UpdateRuleGroup), insert a RuleGroup into a WebACL or delete a one from a WebACL (see UpdateWebACL), or delete a RuleGroup from AWS WAF (see DeleteRuleGroup).

RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The friendly name or description for the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - } - }, - "documentation":"

A collection of predefined rules that you can add to a web ACL.

Rule groups are subject to the following limits:

  • Three rule groups per account. You can request an increase to this limit by contacting customer support.

  • One rule group per web ACL.

  • Ten rules per rule group.

" - }, - "RuleGroupSummaries":{ - "type":"list", - "member":{"shape":"RuleGroupSummary"} - }, - "RuleGroupSummary":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Name" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup. You use RuleGroupId to get more information about a RuleGroup (see GetRuleGroup), update a RuleGroup (see UpdateRuleGroup), insert a RuleGroup into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a RuleGroup from AWS WAF (see DeleteRuleGroup).

RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - } - }, - "documentation":"

Contains the identifier and the friendly name or description of the RuleGroup.

" - }, - "RuleGroupUpdate":{ - "type":"structure", - "required":[ - "Action", - "ActivatedRule" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add an ActivatedRule to a RuleGroup. Use DELETE to remove an ActivatedRule from a RuleGroup.

" - }, - "ActivatedRule":{ - "shape":"ActivatedRule", - "documentation":"

The ActivatedRule object specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

" - } - }, - "documentation":"

Specifies an ActivatedRule and indicates whether you want to add it to a RuleGroup or delete it from a RuleGroup.

" - }, - "RuleGroupUpdates":{ - "type":"list", - "member":{"shape":"RuleGroupUpdate"}, - "min":1 - }, - "RulePriority":{"type":"integer"}, - "RuleSummaries":{ - "type":"list", - "member":{"shape":"RuleSummary"} - }, - "RuleSummary":{ - "type":"structure", - "required":[ - "RuleId", - "Name" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a Rule. You use RuleId to get more information about a Rule (see GetRule), update a Rule (see UpdateRule), insert a Rule into a WebACL or delete one from a WebACL (see UpdateWebACL), or delete a Rule from AWS WAF (see DeleteRule).

RuleId is returned by CreateRule and by ListRules.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the Rule. You can't change the name of a Rule after you create it.

" - } - }, - "documentation":"

Contains the identifier and the friendly name or description of the Rule.

" - }, - "RuleUpdate":{ - "type":"structure", - "required":[ - "Action", - "Predicate" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a Predicate to a Rule. Use DELETE to remove a Predicate from a Rule.

" - }, - "Predicate":{ - "shape":"Predicate", - "documentation":"

The ID of the Predicate (such as an IPSet) that you want to add to a Rule.

" - } - }, - "documentation":"

Specifies a Predicate (such as an IPSet) and indicates whether you want to add it to a Rule or delete it from a Rule.

" - }, - "RuleUpdates":{ - "type":"list", - "member":{"shape":"RuleUpdate"} - }, - "SampleWeight":{ - "type":"long", - "min":0 - }, - "SampledHTTPRequest":{ - "type":"structure", - "required":[ - "Request", - "Weight" - ], - "members":{ - "Request":{ - "shape":"HTTPRequest", - "documentation":"

A complex type that contains detailed information about the request.

" - }, - "Weight":{ - "shape":"SampleWeight", - "documentation":"

A value that indicates how one result in the response relates proportionally to other results in the response. A result that has a weight of 2 represents roughly twice as many CloudFront web requests as a result that has a weight of 1.

" - }, - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

The time at which AWS WAF received the request from your AWS resource, in Unix time format (in seconds).

" - }, - "Action":{ - "shape":"Action", - "documentation":"

The action for the Rule that the request matched: ALLOW, BLOCK, or COUNT.

" - }, - "RuleWithinRuleGroup":{ - "shape":"ResourceId", - "documentation":"

This value is returned if the GetSampledRequests request specifies the ID of a RuleGroup rather than the ID of an individual rule. RuleWithinRuleGroup is the rule within the specified RuleGroup that matched the request listed in the response.

" - } - }, - "documentation":"

The response from a GetSampledRequests request includes a SampledHTTPRequests complex type that appears as SampledRequests in the response syntax. SampledHTTPRequests contains one SampledHTTPRequest object for each web request that is returned by GetSampledRequests.

" - }, - "SampledHTTPRequests":{ - "type":"list", - "member":{"shape":"SampledHTTPRequest"} - }, - "Size":{ - "type":"long", - "max":21474836480, - "min":0 - }, - "SizeConstraint":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation", - "ComparisonOperator", - "Size" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for the size constraint.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

Note that if you choose BODY for the value of Type, you must choose NONE for TextTransformation because CloudFront forwards only the first 8192 bytes for inspection.

NONE

Specify NONE if you don't want to perform any text transformations.

CMD_LINE

When you're concerned that attackers are injecting an operating system command line command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

" - }, - "ComparisonOperator":{ - "shape":"ComparisonOperator", - "documentation":"

The type of comparison you want AWS WAF to perform. AWS WAF uses this in combination with the provided Size and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

EQ: Used to test if the Size is equal to the size of the FieldToMatch

NE: Used to test if the Size is not equal to the size of the FieldToMatch

LE: Used to test if the Size is less than or equal to the size of the FieldToMatch

LT: Used to test if the Size is strictly less than the size of the FieldToMatch

GE: Used to test if the Size is greater than or equal to the size of the FieldToMatch

GT: Used to test if the Size is strictly greater than the size of the FieldToMatch

" - }, - "Size":{ - "shape":"Size", - "documentation":"

The size in bytes that you want AWS WAF to compare against the size of the specified FieldToMatch. AWS WAF uses this in combination with ComparisonOperator and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

Valid values for size are 0 - 21474836480 bytes (0 - 20 GB).

If you specify URI for the value of Type, the / in the URI counts as one character. For example, the URI /logo.jpg is nine characters long.

" - } - }, - "documentation":"

Specifies a constraint on the size of a part of the web request. AWS WAF uses the Size, ComparisonOperator, and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

" - }, - "SizeConstraintSet":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "SizeConstraints" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SizeConstraintSet. You use SizeConstraintSetId to get information about a SizeConstraintSet (see GetSizeConstraintSet), update a SizeConstraintSet (see UpdateSizeConstraintSet), insert a SizeConstraintSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SizeConstraintSet from AWS WAF (see DeleteSizeConstraintSet).

SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the SizeConstraintSet.

" - }, - "SizeConstraints":{ - "shape":"SizeConstraints", - "documentation":"

Specifies the parts of web requests that you want to inspect the size of.

" - } - }, - "documentation":"

A complex type that contains SizeConstraint objects, which specify the parts of web requests that you want AWS WAF to inspect the size of. If a SizeConstraintSet contains more than one SizeConstraint object, a request only needs to match one constraint to be considered a match.

" - }, - "SizeConstraintSetSummaries":{ - "type":"list", - "member":{"shape":"SizeConstraintSetSummary"} - }, - "SizeConstraintSetSummary":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "Name" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SizeConstraintSet. You use SizeConstraintSetId to get information about a SizeConstraintSet (see GetSizeConstraintSet), update a SizeConstraintSet (see UpdateSizeConstraintSet), insert a SizeConstraintSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SizeConstraintSet from AWS WAF (see DeleteSizeConstraintSet).

SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the SizeConstraintSet, if any.

" - } - }, - "documentation":"

The Id and Name of a SizeConstraintSet.

" - }, - "SizeConstraintSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "SizeConstraint" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a SizeConstraintSetUpdate to a SizeConstraintSet. Use DELETE to remove a SizeConstraintSetUpdate from a SizeConstraintSet.

" - }, - "SizeConstraint":{ - "shape":"SizeConstraint", - "documentation":"

Specifies a constraint on the size of a part of the web request. AWS WAF uses the Size, ComparisonOperator, and FieldToMatch to build an expression in the form of \"Size ComparisonOperator size in bytes of FieldToMatch\". If that expression is true, the SizeConstraint is considered to match.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect the size of and indicates whether you want to add the specification to a SizeConstraintSet or delete it from a SizeConstraintSet.

" - }, - "SizeConstraintSetUpdates":{ - "type":"list", - "member":{"shape":"SizeConstraintSetUpdate"}, - "min":1 - }, - "SizeConstraints":{ - "type":"list", - "member":{"shape":"SizeConstraint"} - }, - "SqlInjectionMatchSet":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "SqlInjectionMatchTuples" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SqlInjectionMatchSet. You use SqlInjectionMatchSetId to get information about a SqlInjectionMatchSet (see GetSqlInjectionMatchSet), update a SqlInjectionMatchSet (see UpdateSqlInjectionMatchSet), insert a SqlInjectionMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SqlInjectionMatchSet from AWS WAF (see DeleteSqlInjectionMatchSet).

SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchTuples":{ - "shape":"SqlInjectionMatchTuples", - "documentation":"

Specifies the parts of web requests that you want to inspect for snippets of malicious SQL code.

" - } - }, - "documentation":"

A complex type that contains SqlInjectionMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header. If a SqlInjectionMatchSet contains more than one SqlInjectionMatchTuple object, a request needs to include snippets of SQL code in only one of the specified parts of the request to be considered a match.

" - }, - "SqlInjectionMatchSetSummaries":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchSetSummary"} - }, - "SqlInjectionMatchSetSummary":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "Name" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a SqlInjectionMatchSet. You use SqlInjectionMatchSetId to get information about a SqlInjectionMatchSet (see GetSqlInjectionMatchSet), update a SqlInjectionMatchSet (see UpdateSqlInjectionMatchSet), insert a SqlInjectionMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete a SqlInjectionMatchSet from AWS WAF (see DeleteSqlInjectionMatchSet).

SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the SqlInjectionMatchSet, if any, specified by Id.

" - } - }, - "documentation":"

The Id and Name of a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "SqlInjectionMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a SqlInjectionMatchSetUpdate to a SqlInjectionMatchSet. Use DELETE to remove a SqlInjectionMatchSetUpdate from a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchTuple":{ - "shape":"SqlInjectionMatchTuple", - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect for snippets of malicious SQL code and indicates whether you want to add the specification to a SqlInjectionMatchSet or delete it from a SqlInjectionMatchSet.

" - }, - "SqlInjectionMatchSetUpdates":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchSetUpdate"}, - "min":1 - }, - "SqlInjectionMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for snippets of malicious SQL code.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - } - }, - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header.

" - }, - "SqlInjectionMatchTuples":{ - "type":"list", - "member":{"shape":"SqlInjectionMatchTuple"} - }, - "SubscribedRuleGroupSummaries":{ - "type":"list", - "member":{"shape":"SubscribedRuleGroupSummary"} - }, - "SubscribedRuleGroupSummary":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Name", - "MetricName" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a RuleGroup.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the RuleGroup. You can't change the name of a RuleGroup after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this RuleGroup. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change the name of the metric after you create the RuleGroup.

" - } - }, - "documentation":"

A summary of the rule groups you are subscribed to.

" - }, - "TextTransformation":{ - "type":"string", - "enum":[ - "NONE", - "COMPRESS_WHITE_SPACE", - "HTML_ENTITY_DECODE", - "LOWERCASE", - "CMD_LINE", - "URL_DECODE" - ] - }, - "TimeWindow":{ - "type":"structure", - "required":[ - "StartTime", - "EndTime" - ], - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The beginning of the time range from which you want GetSampledRequests to return a sample of the requests that your AWS resource received. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time range from which you want GetSampledRequests to return a sample of the requests that your AWS resource received. Specify the date and time in the following format: \"2016-09-27T14:50Z\". You can specify any time range in the previous three hours.

" - } - }, - "documentation":"

In a GetSampledRequests request, the StartTime and EndTime objects specify the time range for which you want AWS WAF to return a sample of web requests.

In a GetSampledRequests response, the StartTime and EndTime objects specify the time range for which AWS WAF actually returned a sample of web requests. AWS WAF gets the specified number of requests from among the first 5,000 requests that your AWS resource receives during the specified time period. If your resource receives more than 5,000 requests during that period, AWS WAF stops sampling after the 5,000th request. In that case, EndTime is the time that AWS WAF received the 5,000th request.

" - }, - "Timestamp":{"type":"timestamp"}, - "URIString":{"type":"string"}, - "UpdateByteMatchSetRequest":{ - "type":"structure", - "required":[ - "ByteMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "ByteMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The ByteMatchSetId of the ByteMatchSet that you want to update. ByteMatchSetId is returned by CreateByteMatchSet and by ListByteMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"ByteMatchSetUpdates", - "documentation":"

An array of ByteMatchSetUpdate objects that you want to insert into or delete from a ByteMatchSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateByteMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateByteMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateGeoMatchSetRequest":{ - "type":"structure", - "required":[ - "GeoMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "GeoMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The GeoMatchSetId of the GeoMatchSet that you want to update. GeoMatchSetId is returned by CreateGeoMatchSet and by ListGeoMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"GeoMatchSetUpdates", - "documentation":"

An array of GeoMatchSetUpdate objects that you want to insert into or delete from an GeoMatchSet. For more information, see the applicable data types:

  • GeoMatchSetUpdate: Contains Action and GeoMatchConstraint

  • GeoMatchConstraint: Contains Type and Value

    You can have only one Type and Value per GeoMatchConstraint. To add multiple countries, include multiple GeoMatchSetUpdate objects in your request.

" - } - } - }, - "UpdateGeoMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateGeoMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateIPSetRequest":{ - "type":"structure", - "required":[ - "IPSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "IPSetId":{ - "shape":"ResourceId", - "documentation":"

The IPSetId of the IPSet that you want to update. IPSetId is returned by CreateIPSet and by ListIPSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"IPSetUpdates", - "documentation":"

An array of IPSetUpdate objects that you want to insert into or delete from an IPSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateIPSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateIPSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRateBasedRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken", - "Updates", - "RateLimit" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the RateBasedRule that you want to update. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"RuleUpdates", - "documentation":"

An array of RuleUpdate objects that you want to insert into or delete from a RateBasedRule.

" - }, - "RateLimit":{ - "shape":"RateLimit", - "documentation":"

The maximum number of requests, which have an identical value in the field specified by the RateKey, allowed in a five-minute period. If the number of requests exceeds the RateLimit and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.

" - } - } - }, - "UpdateRateBasedRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRateBasedRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRegexMatchSetRequest":{ - "type":"structure", - "required":[ - "RegexMatchSetId", - "Updates", - "ChangeToken" - ], - "members":{ - "RegexMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexMatchSetId of the RegexMatchSet that you want to update. RegexMatchSetId is returned by CreateRegexMatchSet and by ListRegexMatchSets.

" - }, - "Updates":{ - "shape":"RegexMatchSetUpdates", - "documentation":"

An array of RegexMatchSetUpdate objects that you want to insert into or delete from a RegexMatchSet. For more information, see RegexMatchTuple.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRegexMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRegexMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRegexPatternSetRequest":{ - "type":"structure", - "required":[ - "RegexPatternSetId", - "Updates", - "ChangeToken" - ], - "members":{ - "RegexPatternSetId":{ - "shape":"ResourceId", - "documentation":"

The RegexPatternSetId of the RegexPatternSet that you want to update. RegexPatternSetId is returned by CreateRegexPatternSet and by ListRegexPatternSets.

" - }, - "Updates":{ - "shape":"RegexPatternSetUpdates", - "documentation":"

An array of RegexPatternSetUpdate objects that you want to insert into or delete from a RegexPatternSet.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRegexPatternSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRegexPatternSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRuleGroupRequest":{ - "type":"structure", - "required":[ - "RuleGroupId", - "Updates", - "ChangeToken" - ], - "members":{ - "RuleGroupId":{ - "shape":"ResourceId", - "documentation":"

The RuleGroupId of the RuleGroup that you want to update. RuleGroupId is returned by CreateRuleGroup and by ListRuleGroups.

" - }, - "Updates":{ - "shape":"RuleGroupUpdates", - "documentation":"

An array of RuleGroupUpdate objects that you want to insert into or delete from a RuleGroup.

You can only insert REGULAR rules into a rule group.

ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - } - } - }, - "UpdateRuleGroupResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRuleGroup request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateRuleRequest":{ - "type":"structure", - "required":[ - "RuleId", - "ChangeToken", - "Updates" - ], - "members":{ - "RuleId":{ - "shape":"ResourceId", - "documentation":"

The RuleId of the Rule that you want to update. RuleId is returned by CreateRule and by ListRules.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"RuleUpdates", - "documentation":"

An array of RuleUpdate objects that you want to insert into or delete from a Rule. For more information, see the applicable data types:

" - } - } - }, - "UpdateRuleResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateSizeConstraintSetRequest":{ - "type":"structure", - "required":[ - "SizeConstraintSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "SizeConstraintSetId":{ - "shape":"ResourceId", - "documentation":"

The SizeConstraintSetId of the SizeConstraintSet that you want to update. SizeConstraintSetId is returned by CreateSizeConstraintSet and by ListSizeConstraintSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"SizeConstraintSetUpdates", - "documentation":"

An array of SizeConstraintSetUpdate objects that you want to insert into or delete from a SizeConstraintSet. For more information, see the applicable data types:

" - } - } - }, - "UpdateSizeConstraintSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateSizeConstraintSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateSqlInjectionMatchSetRequest":{ - "type":"structure", - "required":[ - "SqlInjectionMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "SqlInjectionMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The SqlInjectionMatchSetId of the SqlInjectionMatchSet that you want to update. SqlInjectionMatchSetId is returned by CreateSqlInjectionMatchSet and by ListSqlInjectionMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"SqlInjectionMatchSetUpdates", - "documentation":"

An array of SqlInjectionMatchSetUpdate objects that you want to insert into or delete from a SqlInjectionMatchSet. For more information, see the applicable data types:

" - } - }, - "documentation":"

A request to update a SqlInjectionMatchSet.

" - }, - "UpdateSqlInjectionMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateSqlInjectionMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to an UpdateSqlInjectionMatchSets request.

" - }, - "UpdateWebACLRequest":{ - "type":"structure", - "required":[ - "WebACLId", - "ChangeToken" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

The WebACLId of the WebACL that you want to update. WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"WebACLUpdates", - "documentation":"

An array of updates to make to the WebACL.

An array of WebACLUpdate objects that you want to insert into or delete from a WebACL. For more information, see the applicable data types:

  • WebACLUpdate: Contains Action and ActivatedRule

  • ActivatedRule: Contains Action, OverrideAction, Priority, RuleId, and Type. ActivatedRule|OverrideAction applies only when updating or adding a RuleGroup to a WebACL. In this case you do not use ActivatedRule|Action. For all other update requests, ActivatedRule|Action is used instead of ActivatedRule|OverrideAction.

  • WafAction: Contains Type

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

A default action for the web ACL, either ALLOW or BLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of the rules in a web ACL.

" - } - } - }, - "UpdateWebACLResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateWebACL request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - } - }, - "UpdateXssMatchSetRequest":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "ChangeToken", - "Updates" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

The XssMatchSetId of the XssMatchSet that you want to update. XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The value returned by the most recent call to GetChangeToken.

" - }, - "Updates":{ - "shape":"XssMatchSetUpdates", - "documentation":"

An array of XssMatchSetUpdate objects that you want to insert into or delete from a XssMatchSet. For more information, see the applicable data types:

" - } - }, - "documentation":"

A request to update an XssMatchSet.

" - }, - "UpdateXssMatchSetResponse":{ - "type":"structure", - "members":{ - "ChangeToken":{ - "shape":"ChangeToken", - "documentation":"

The ChangeToken that you used to submit the UpdateXssMatchSet request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

" - } - }, - "documentation":"

The response to an UpdateXssMatchSets request.

" - }, - "WAFDisallowedNameException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The name specified is invalid.

", - "exception":true - }, - "WAFInternalErrorException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because of a system problem, even though the request was valid. Retry your request.

", - "exception":true, - "fault":true - }, - "WAFInvalidAccountException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation failed because you tried to create, update, or delete an object by using an invalid account identifier.

", - "exception":true - }, - "WAFInvalidOperationException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because there was nothing to do. For example:

  • You tried to remove a Rule from a WebACL, but the Rule isn't in the specified WebACL.

  • You tried to remove an IP address from an IPSet, but the IP address isn't in the specified IPSet.

  • You tried to remove a ByteMatchTuple from a ByteMatchSet, but the ByteMatchTuple isn't in the specified WebACL.

  • You tried to add a Rule to a WebACL, but the Rule already exists in the specified WebACL.

  • You tried to add an IP address to an IPSet, but the IP address already exists in the specified IPSet.

  • You tried to add a ByteMatchTuple to a ByteMatchSet, but the ByteMatchTuple already exists in the specified WebACL.

", - "exception":true - }, - "WAFInvalidParameterException":{ - "type":"structure", - "members":{ - "field":{"shape":"ParameterExceptionField"}, - "parameter":{"shape":"ParameterExceptionParameter"}, - "reason":{"shape":"ParameterExceptionReason"} - }, - "documentation":"

The operation failed because AWS WAF didn't recognize a parameter in the request. For example:

  • You specified an invalid parameter name.

  • You specified an invalid value.

  • You tried to update an object (ByteMatchSet, IPSet, Rule, or WebACL) using an action other than INSERT or DELETE.

  • You tried to create a WebACL with a DefaultAction Type other than ALLOW, BLOCK, or COUNT.

  • You tried to create a RateBasedRule with a RateKey value other than IP.

  • You tried to update a WebACL with a WafAction Type other than ALLOW, BLOCK, or COUNT.

  • You tried to update a ByteMatchSet with a FieldToMatch Type other than HEADER, METHOD, QUERY_STRING, URI, or BODY.

  • You tried to update a ByteMatchSet with a Field of HEADER but no value for Data.

  • Your request references an ARN that is malformed, or corresponds to a resource with which a web ACL cannot be associated.

", - "exception":true - }, - "WAFInvalidPermissionPolicyException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because the specified policy is not in the proper format.

The policy is subject to the following restrictions:

  • You can attach only one policy with each PutPermissionPolicy request.

  • The policy must include an Effect, Action and Principal.

  • Effect must specify Allow.

  • The Action in the policy must be waf:UpdateWebACL or waf-regional:UpdateWebACL. Any extra or wildcard actions in the policy will be rejected.

  • The policy cannot include a Resource parameter.

  • The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

  • The user making the request must be the owner of the RuleGroup.

  • Your policy must be composed using IAM Policy version 2012-10-17.

", - "exception":true - }, - "WAFInvalidRegexPatternException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The regular expression (regex) you specified in RegexPatternString is invalid.

", - "exception":true - }, - "WAFLimitsExceededException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation exceeds a resource limit, for example, the maximum number of WebACL objects that you can create for an AWS account. For more information, see Limits in the AWS WAF Developer Guide.

", - "exception":true - }, - "WAFNonEmptyEntityException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to delete an object that isn't empty. For example:

  • You tried to delete a WebACL that still contains one or more Rule objects.

  • You tried to delete a Rule that still contains one or more ByteMatchSet objects or other predicates.

  • You tried to delete a ByteMatchSet that contains one or more ByteMatchTuple objects.

  • You tried to delete an IPSet that references one or more IP addresses.

", - "exception":true - }, - "WAFNonexistentContainerException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to add an object to or delete an object from another object that doesn't exist. For example:

  • You tried to add a Rule to or delete a Rule from a WebACL that doesn't exist.

  • You tried to add a ByteMatchSet to or delete a ByteMatchSet from a Rule that doesn't exist.

  • You tried to add an IP address to or delete an IP address from an IPSet that doesn't exist.

  • You tried to add a ByteMatchTuple to or delete a ByteMatchTuple from a ByteMatchSet that doesn't exist.

", - "exception":true - }, - "WAFNonexistentItemException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because the referenced object doesn't exist.

", - "exception":true - }, - "WAFReferencedItemException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to delete an object that is still in use. For example:

  • You tried to delete a ByteMatchSet that is still referenced by a Rule.

  • You tried to delete a Rule that is still referenced by a WebACL.

", - "exception":true - }, - "WAFStaleDataException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The operation failed because you tried to create, update, or delete an object by using a change token that has already been used.

", - "exception":true - }, - "WAFSubscriptionNotFoundException":{ - "type":"structure", - "members":{ - "message":{"shape":"errorMessage"} - }, - "documentation":"

The specified subscription does not exist.

", - "exception":true - }, - "WafAction":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"WafActionType", - "documentation":"

Specifies how you want AWS WAF to respond to requests that match the settings in a Rule. Valid settings include the following:

  • ALLOW: AWS WAF allows requests

  • BLOCK: AWS WAF blocks requests

  • COUNT: AWS WAF increments a counter of the requests that match all of the conditions in the rule. AWS WAF then continues to inspect the web request based on the remaining rules in the web ACL. You can't specify COUNT for the default action for a WebACL.

" - } - }, - "documentation":"

For the action that is associated with a rule in a WebACL, specifies the action that you want AWS WAF to perform when a web request matches all of the conditions in a rule. For the default action in a WebACL, specifies the action that you want AWS WAF to take when a web request doesn't match all of the conditions in any of the rules in a WebACL.

" - }, - "WafActionType":{ - "type":"string", - "enum":[ - "BLOCK", - "ALLOW", - "COUNT" - ] - }, - "WafOverrideAction":{ - "type":"structure", - "required":["Type"], - "members":{ - "Type":{ - "shape":"WafOverrideActionType", - "documentation":"

COUNT overrides the action specified by the individual rule within a RuleGroup . If set to NONE, the rule's action will take place.

" - } - }, - "documentation":"

The action to take if any rule within the RuleGroup matches a request.

" - }, - "WafOverrideActionType":{ - "type":"string", - "enum":[ - "NONE", - "COUNT" - ] - }, - "WafRuleType":{ - "type":"string", - "enum":[ - "REGULAR", - "RATE_BASED", - "GROUP" - ] - }, - "WebACL":{ - "type":"structure", - "required":[ - "WebACLId", - "DefaultAction", - "Rules" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

" - }, - "MetricName":{ - "shape":"MetricName", - "documentation":"

A friendly name or description for the metrics for this WebACL. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName after you create the WebACL.

" - }, - "DefaultAction":{ - "shape":"WafAction", - "documentation":"

The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.

" - }, - "Rules":{ - "shape":"ActivatedRules", - "documentation":"

An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

" - } - }, - "documentation":"

Contains the Rules that identify the requests that you want to allow, block, or count. In a WebACL, you also specify a default action (ALLOW or BLOCK), and the action for each Rule that you add to a WebACL, for example, block requests from specified IP addresses or block requests from specified referrers. You also associate the WebACL with a CloudFront distribution to identify the requests that you want AWS WAF to filter. If you add more than one Rule to a WebACL, a request needs to match only one of the specifications to be allowed, blocked, or counted. For more information, see UpdateWebACL.

" - }, - "WebACLSummaries":{ - "type":"list", - "member":{"shape":"WebACLSummary"} - }, - "WebACLSummary":{ - "type":"structure", - "required":[ - "WebACLId", - "Name" - ], - "members":{ - "WebACLId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

WebACLId is returned by CreateWebACL and by ListWebACLs.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

" - } - }, - "documentation":"

Contains the identifier and the name or description of the WebACL.

" - }, - "WebACLUpdate":{ - "type":"structure", - "required":[ - "Action", - "ActivatedRule" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specifies whether to insert a Rule into or delete a Rule from a WebACL.

" - }, - "ActivatedRule":{ - "shape":"ActivatedRule", - "documentation":"

The ActivatedRule object in an UpdateWebACL request specifies a Rule that you want to insert or delete, the priority of the Rule in the WebACL, and the action that you want AWS WAF to take when a web request matches the Rule (ALLOW, BLOCK, or COUNT).

" - } - }, - "documentation":"

Specifies whether to insert a Rule into or delete a Rule from a WebACL.

" - }, - "WebACLUpdates":{ - "type":"list", - "member":{"shape":"WebACLUpdate"} - }, - "XssMatchSet":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "XssMatchTuples" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for an XssMatchSet. You use XssMatchSetId to get information about an XssMatchSet (see GetXssMatchSet), update an XssMatchSet (see UpdateXssMatchSet), insert an XssMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete an XssMatchSet from AWS WAF (see DeleteXssMatchSet).

XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name, if any, of the XssMatchSet.

" - }, - "XssMatchTuples":{ - "shape":"XssMatchTuples", - "documentation":"

Specifies the parts of web requests that you want to inspect for cross-site scripting attacks.

" - } - }, - "documentation":"

A complex type that contains XssMatchTuple objects, which specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header. If a XssMatchSet contains more than one XssMatchTuple object, a request needs to include cross-site scripting attacks in only one of the specified parts of the request to be considered a match.

" - }, - "XssMatchSetSummaries":{ - "type":"list", - "member":{"shape":"XssMatchSetSummary"} - }, - "XssMatchSetSummary":{ - "type":"structure", - "required":[ - "XssMatchSetId", - "Name" - ], - "members":{ - "XssMatchSetId":{ - "shape":"ResourceId", - "documentation":"

A unique identifier for an XssMatchSet. You use XssMatchSetId to get information about a XssMatchSet (see GetXssMatchSet), update an XssMatchSet (see UpdateXssMatchSet), insert an XssMatchSet into a Rule or delete one from a Rule (see UpdateRule), and delete an XssMatchSet from AWS WAF (see DeleteXssMatchSet).

XssMatchSetId is returned by CreateXssMatchSet and by ListXssMatchSets.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the XssMatchSet, if any, specified by Id.

" - } - }, - "documentation":"

The Id and Name of an XssMatchSet.

" - }, - "XssMatchSetUpdate":{ - "type":"structure", - "required":[ - "Action", - "XssMatchTuple" - ], - "members":{ - "Action":{ - "shape":"ChangeAction", - "documentation":"

Specify INSERT to add a XssMatchSetUpdate to an XssMatchSet. Use DELETE to remove a XssMatchSetUpdate from an XssMatchSet.

" - }, - "XssMatchTuple":{ - "shape":"XssMatchTuple", - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header.

" - } - }, - "documentation":"

Specifies the part of a web request that you want to inspect for cross-site scripting attacks and indicates whether you want to add the specification to an XssMatchSet or delete it from an XssMatchSet.

" - }, - "XssMatchSetUpdates":{ - "type":"list", - "member":{"shape":"XssMatchSetUpdate"}, - "min":1 - }, - "XssMatchTuple":{ - "type":"structure", - "required":[ - "FieldToMatch", - "TextTransformation" - ], - "members":{ - "FieldToMatch":{ - "shape":"FieldToMatch", - "documentation":"

Specifies where in a web request to look for cross-site scripting attacks.

" - }, - "TextTransformation":{ - "shape":"TextTransformation", - "documentation":"

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass AWS WAF. If you specify a transformation, AWS WAF performs the transformation on FieldToMatch before inspecting a request for a match.

CMD_LINE

When you're concerned that attackers are injecting an operating system commandline command and using unusual formatting to disguise some or all of the command, use this option to perform the following transformations:

  • Delete the following characters: \\ \" ' ^

  • Delete spaces before the following characters: / (

  • Replace the following characters with a space: , ;

  • Replace multiple spaces with one space

  • Convert uppercase letters (A-Z) to lowercase (a-z)

COMPRESS_WHITE_SPACE

Use this option to replace the following characters with a space character (decimal 32):

  • \\f, formfeed, decimal 12

  • \\t, tab, decimal 9

  • \\n, newline, decimal 10

  • \\r, carriage return, decimal 13

  • \\v, vertical tab, decimal 11

  • non-breaking space, decimal 160

COMPRESS_WHITE_SPACE also replaces multiple spaces with one space.

HTML_ENTITY_DECODE

Use this option to replace HTML-encoded characters with unencoded characters. HTML_ENTITY_DECODE performs the following operations:

  • Replaces (ampersand)quot; with \"

  • Replaces (ampersand)nbsp; with a non-breaking space, decimal 160

  • Replaces (ampersand)lt; with a \"less than\" symbol

  • Replaces (ampersand)gt; with >

  • Replaces characters that are represented in hexadecimal format, (ampersand)#xhhhh;, with the corresponding characters

  • Replaces characters that are represented in decimal format, (ampersand)#nnnn;, with the corresponding characters

LOWERCASE

Use this option to convert uppercase letters (A-Z) to lowercase (a-z).

URL_DECODE

Use this option to decode a URL-encoded value.

NONE

Specify NONE if you don't want to perform any text transformations.

" - } - }, - "documentation":"

Specifies the part of a web request that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header.

" - }, - "XssMatchTuples":{ - "type":"list", - "member":{"shape":"XssMatchTuple"} - }, - "errorMessage":{"type":"string"} - }, - "documentation":"

This is the AWS WAF API Reference for using AWS WAF with Amazon CloudFront. The AWS WAF actions and data types listed in the reference are available for protecting Amazon CloudFront distributions. You can use these actions and data types via the endpoint waf.amazonaws.com. This guide is for developers who need detailed information about the AWS WAF API actions, data types, and errors. For detailed information about AWS WAF features and an overview of how to use the AWS WAF API, see the AWS WAF Developer Guide.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/paginators-1.json deleted file mode 100644 index 3dc6d7e8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/paginators-1.json +++ /dev/null @@ -1,25 +0,0 @@ -{ - "pagination": { - "DescribeDocumentVersions": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "DocumentVersions" - }, - "DescribeFolderContents": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": [ - "Folders", - "Documents" - ] - }, - "DescribeUsers": { - "input_token": "Marker", - "limit_key": "Limit", - "output_token": "Marker", - "result_key": "Users" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/service-2.json deleted file mode 100644 index be8ff5d1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workdocs/2016-05-01/service-2.json +++ /dev/null @@ -1,3576 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-05-01", - "endpointPrefix":"workdocs", - "jsonVersion":"1.1", - "protocol":"rest-json", - "serviceFullName":"Amazon WorkDocs", - "serviceId":"WorkDocs", - "signatureVersion":"v4", - "uid":"workdocs-2016-05-01" - }, - "operations":{ - "AbortDocumentVersionUpload":{ - "name":"AbortDocumentVersionUpload", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}", - "responseCode":204 - }, - "input":{"shape":"AbortDocumentVersionUploadRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Aborts the upload of the specified document version that was previously initiated by InitiateDocumentVersionUpload. The client should make this call only when it no longer intends to upload the document version, or fails to do so.

" - }, - "ActivateUser":{ - "name":"ActivateUser", - "http":{ - "method":"POST", - "requestUri":"/api/v1/users/{UserId}/activation", - "responseCode":200 - }, - "input":{"shape":"ActivateUserRequest"}, - "output":{"shape":"ActivateUserResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Activates the specified user. Only active users can access Amazon WorkDocs.

" - }, - "AddResourcePermissions":{ - "name":"AddResourcePermissions", - "http":{ - "method":"POST", - "requestUri":"/api/v1/resources/{ResourceId}/permissions", - "responseCode":201 - }, - "input":{"shape":"AddResourcePermissionsRequest"}, - "output":{"shape":"AddResourcePermissionsResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a set of permissions for the specified folder or document. The resource permissions are overwritten if the principals already have different permissions.

" - }, - "CreateComment":{ - "name":"CreateComment", - "http":{ - "method":"POST", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}/comment", - "responseCode":201 - }, - "input":{"shape":"CreateCommentRequest"}, - "output":{"shape":"CreateCommentResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DocumentLockedForCommentsException"} - ], - "documentation":"

Adds a new comment to the specified document version.

" - }, - "CreateCustomMetadata":{ - "name":"CreateCustomMetadata", - "http":{ - "method":"PUT", - "requestUri":"/api/v1/resources/{ResourceId}/customMetadata", - "responseCode":200 - }, - "input":{"shape":"CreateCustomMetadataRequest"}, - "output":{"shape":"CreateCustomMetadataResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"CustomMetadataLimitExceededException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Adds one or more custom properties to the specified resource (a folder, document, or version).

" - }, - "CreateFolder":{ - "name":"CreateFolder", - "http":{ - "method":"POST", - "requestUri":"/api/v1/folders", - "responseCode":201 - }, - "input":{"shape":"CreateFolderRequest"}, - "output":{"shape":"CreateFolderResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a folder with the specified name and parent folder.

" - }, - "CreateLabels":{ - "name":"CreateLabels", - "http":{ - "method":"PUT", - "requestUri":"/api/v1/resources/{ResourceId}/labels", - "responseCode":200 - }, - "input":{"shape":"CreateLabelsRequest"}, - "output":{"shape":"CreateLabelsResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"TooManyLabelsException"} - ], - "documentation":"

Adds the specified list of labels to the given resource (a document or folder)

" - }, - "CreateNotificationSubscription":{ - "name":"CreateNotificationSubscription", - "http":{ - "method":"POST", - "requestUri":"/api/v1/organizations/{OrganizationId}/subscriptions", - "responseCode":200 - }, - "input":{"shape":"CreateNotificationSubscriptionRequest"}, - "output":{"shape":"CreateNotificationSubscriptionResponse"}, - "errors":[ - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"TooManySubscriptionsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Configure WorkDocs to use Amazon SNS notifications.

The endpoint receives a confirmation message, and must confirm the subscription. For more information, see Confirm the Subscription in the Amazon Simple Notification Service Developer Guide.

" - }, - "CreateUser":{ - "name":"CreateUser", - "http":{ - "method":"POST", - "requestUri":"/api/v1/users", - "responseCode":201 - }, - "input":{"shape":"CreateUserRequest"}, - "output":{"shape":"CreateUserResponse"}, - "errors":[ - {"shape":"EntityAlreadyExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Creates a user in a Simple AD or Microsoft AD directory. The status of a newly created user is \"ACTIVE\". New users can access Amazon WorkDocs.

" - }, - "DeactivateUser":{ - "name":"DeactivateUser", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/users/{UserId}/activation", - "responseCode":204 - }, - "input":{"shape":"DeactivateUserRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deactivates the specified user, which revokes the user's access to Amazon WorkDocs.

" - }, - "DeleteComment":{ - "name":"DeleteComment", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}/comment/{CommentId}", - "responseCode":204 - }, - "input":{"shape":"DeleteCommentRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DocumentLockedForCommentsException"} - ], - "documentation":"

Deletes the specified comment from the document version.

" - }, - "DeleteCustomMetadata":{ - "name":"DeleteCustomMetadata", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/resources/{ResourceId}/customMetadata", - "responseCode":200 - }, - "input":{"shape":"DeleteCustomMetadataRequest"}, - "output":{"shape":"DeleteCustomMetadataResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes custom metadata from the specified resource.

" - }, - "DeleteDocument":{ - "name":"DeleteDocument", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/documents/{DocumentId}", - "responseCode":204 - }, - "input":{"shape":"DeleteDocumentRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Permanently deletes the specified document and its associated metadata.

" - }, - "DeleteFolder":{ - "name":"DeleteFolder", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/folders/{FolderId}", - "responseCode":204 - }, - "input":{"shape":"DeleteFolderRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Permanently deletes the specified folder and its contents.

" - }, - "DeleteFolderContents":{ - "name":"DeleteFolderContents", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/folders/{FolderId}/contents", - "responseCode":204 - }, - "input":{"shape":"DeleteFolderContentsRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the contents of the specified folder.

" - }, - "DeleteLabels":{ - "name":"DeleteLabels", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/resources/{ResourceId}/labels", - "responseCode":200 - }, - "input":{"shape":"DeleteLabelsRequest"}, - "output":{"shape":"DeleteLabelsResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified list of labels from a resource.

" - }, - "DeleteNotificationSubscription":{ - "name":"DeleteNotificationSubscription", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/organizations/{OrganizationId}/subscriptions/{SubscriptionId}", - "responseCode":200 - }, - "input":{"shape":"DeleteNotificationSubscriptionRequest"}, - "errors":[ - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"EntityNotExistsException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ProhibitedStateException"} - ], - "documentation":"

Deletes the specified subscription from the specified organization.

" - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/users/{UserId}", - "responseCode":204 - }, - "input":{"shape":"DeleteUserRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Deletes the specified user from a Simple AD or Microsoft AD directory.

" - }, - "DescribeActivities":{ - "name":"DescribeActivities", - "http":{ - "method":"GET", - "requestUri":"/api/v1/activities", - "responseCode":200 - }, - "input":{"shape":"DescribeActivitiesRequest"}, - "output":{"shape":"DescribeActivitiesResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes the user activities in a specified time period.

" - }, - "DescribeComments":{ - "name":"DescribeComments", - "http":{ - "method":"GET", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}/comments", - "responseCode":200 - }, - "input":{"shape":"DescribeCommentsRequest"}, - "output":{"shape":"DescribeCommentsResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

List all the comments for the specified document version.

" - }, - "DescribeDocumentVersions":{ - "name":"DescribeDocumentVersions", - "http":{ - "method":"GET", - "requestUri":"/api/v1/documents/{DocumentId}/versions", - "responseCode":200 - }, - "input":{"shape":"DescribeDocumentVersionsRequest"}, - "output":{"shape":"DescribeDocumentVersionsResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ProhibitedStateException"} - ], - "documentation":"

Retrieves the document versions for the specified document.

By default, only active versions are returned.

" - }, - "DescribeFolderContents":{ - "name":"DescribeFolderContents", - "http":{ - "method":"GET", - "requestUri":"/api/v1/folders/{FolderId}/contents", - "responseCode":200 - }, - "input":{"shape":"DescribeFolderContentsRequest"}, - "output":{"shape":"DescribeFolderContentsResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ProhibitedStateException"} - ], - "documentation":"

Describes the contents of the specified folder, including its documents and subfolders.

By default, Amazon WorkDocs returns the first 100 active document and folder metadata items. If there are more results, the response includes a marker that you can use to request the next set of results. You can also request initialized documents.

" - }, - "DescribeGroups":{ - "name":"DescribeGroups", - "http":{ - "method":"GET", - "requestUri":"/api/v1/groups", - "responseCode":200 - }, - "input":{"shape":"DescribeGroupsRequest"}, - "output":{"shape":"DescribeGroupsResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes the groups specified by query.

" - }, - "DescribeNotificationSubscriptions":{ - "name":"DescribeNotificationSubscriptions", - "http":{ - "method":"GET", - "requestUri":"/api/v1/organizations/{OrganizationId}/subscriptions", - "responseCode":200 - }, - "input":{"shape":"DescribeNotificationSubscriptionsRequest"}, - "output":{"shape":"DescribeNotificationSubscriptionsResponse"}, - "errors":[ - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"EntityNotExistsException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Lists the specified notification subscriptions.

" - }, - "DescribeResourcePermissions":{ - "name":"DescribeResourcePermissions", - "http":{ - "method":"GET", - "requestUri":"/api/v1/resources/{ResourceId}/permissions", - "responseCode":200 - }, - "input":{"shape":"DescribeResourcePermissionsRequest"}, - "output":{"shape":"DescribeResourcePermissionsResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes the permissions of a specified resource.

" - }, - "DescribeRootFolders":{ - "name":"DescribeRootFolders", - "http":{ - "method":"GET", - "requestUri":"/api/v1/me/root", - "responseCode":200 - }, - "input":{"shape":"DescribeRootFoldersRequest"}, - "output":{"shape":"DescribeRootFoldersResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Describes the current user's special folders; the RootFolder and the RecycleBin. RootFolder is the root of user's files and folders and RecycleBin is the root of recycled items. This is not a valid action for SigV4 (administrative API) clients.

" - }, - "DescribeUsers":{ - "name":"DescribeUsers", - "http":{ - "method":"GET", - "requestUri":"/api/v1/users", - "responseCode":200 - }, - "input":{"shape":"DescribeUsersRequest"}, - "output":{"shape":"DescribeUsersResponse"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Describes the specified users. You can describe all users or filter the results (for example, by status or organization).

By default, Amazon WorkDocs returns the first 24 active or pending users. If there are more results, the response includes a marker that you can use to request the next set of results.

" - }, - "GetCurrentUser":{ - "name":"GetCurrentUser", - "http":{ - "method":"GET", - "requestUri":"/api/v1/me", - "responseCode":200 - }, - "input":{"shape":"GetCurrentUserRequest"}, - "output":{"shape":"GetCurrentUserResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Retrieves details of the current user for whom the authentication token was generated. This is not a valid action for SigV4 (administrative API) clients.

" - }, - "GetDocument":{ - "name":"GetDocument", - "http":{ - "method":"GET", - "requestUri":"/api/v1/documents/{DocumentId}", - "responseCode":200 - }, - "input":{"shape":"GetDocumentRequest"}, - "output":{"shape":"GetDocumentResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"InvalidPasswordException"} - ], - "documentation":"

Retrieves details of a document.

" - }, - "GetDocumentPath":{ - "name":"GetDocumentPath", - "http":{ - "method":"GET", - "requestUri":"/api/v1/documents/{DocumentId}/path", - "responseCode":200 - }, - "input":{"shape":"GetDocumentPathRequest"}, - "output":{"shape":"GetDocumentPathResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Retrieves the path information (the hierarchy from the root folder) for the requested document.

By default, Amazon WorkDocs returns a maximum of 100 levels upwards from the requested document and only includes the IDs of the parent folders in the path. You can limit the maximum number of levels. You can also request the names of the parent folders.

" - }, - "GetDocumentVersion":{ - "name":"GetDocumentVersion", - "http":{ - "method":"GET", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}", - "responseCode":200 - }, - "input":{"shape":"GetDocumentVersionRequest"}, - "output":{"shape":"GetDocumentVersionResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"InvalidPasswordException"} - ], - "documentation":"

Retrieves version metadata for the specified document.

" - }, - "GetFolder":{ - "name":"GetFolder", - "http":{ - "method":"GET", - "requestUri":"/api/v1/folders/{FolderId}", - "responseCode":200 - }, - "input":{"shape":"GetFolderRequest"}, - "output":{"shape":"GetFolderResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"InvalidArgumentException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"ProhibitedStateException"} - ], - "documentation":"

Retrieves the metadata of the specified folder.

" - }, - "GetFolderPath":{ - "name":"GetFolderPath", - "http":{ - "method":"GET", - "requestUri":"/api/v1/folders/{FolderId}/path", - "responseCode":200 - }, - "input":{"shape":"GetFolderPathRequest"}, - "output":{"shape":"GetFolderPathResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Retrieves the path information (the hierarchy from the root folder) for the specified folder.

By default, Amazon WorkDocs returns a maximum of 100 levels upwards from the requested folder and only includes the IDs of the parent folders in the path. You can limit the maximum number of levels. You can also request the parent folder names.

" - }, - "InitiateDocumentVersionUpload":{ - "name":"InitiateDocumentVersionUpload", - "http":{ - "method":"POST", - "requestUri":"/api/v1/documents", - "responseCode":201 - }, - "input":{"shape":"InitiateDocumentVersionUploadRequest"}, - "output":{"shape":"InitiateDocumentVersionUploadResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"StorageLimitExceededException"}, - {"shape":"StorageLimitWillExceedException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DraftUploadOutOfSyncException"}, - {"shape":"ResourceAlreadyCheckedOutException"} - ], - "documentation":"

Creates a new document object and version object.

The client specifies the parent folder ID and name of the document to upload. The ID is optionally specified when creating a new version of an existing document. This is the first step to upload a document. Next, upload the document to the URL returned from the call, and then call UpdateDocumentVersion.

To cancel the document upload, call AbortDocumentVersionUpload.

" - }, - "RemoveAllResourcePermissions":{ - "name":"RemoveAllResourcePermissions", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/resources/{ResourceId}/permissions", - "responseCode":204 - }, - "input":{"shape":"RemoveAllResourcePermissionsRequest"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Removes all the permissions from the specified resource.

" - }, - "RemoveResourcePermission":{ - "name":"RemoveResourcePermission", - "http":{ - "method":"DELETE", - "requestUri":"/api/v1/resources/{ResourceId}/permissions/{PrincipalId}", - "responseCode":204 - }, - "input":{"shape":"RemoveResourcePermissionRequest"}, - "errors":[ - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Removes the permission for the specified principal from the specified resource.

" - }, - "UpdateDocument":{ - "name":"UpdateDocument", - "http":{ - "method":"PATCH", - "requestUri":"/api/v1/documents/{DocumentId}", - "responseCode":200 - }, - "input":{"shape":"UpdateDocumentRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"LimitExceededException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Updates the specified attributes of a document. The user must have access to both the document and its parent folder, if applicable.

" - }, - "UpdateDocumentVersion":{ - "name":"UpdateDocumentVersion", - "http":{ - "method":"PATCH", - "requestUri":"/api/v1/documents/{DocumentId}/versions/{VersionId}", - "responseCode":200 - }, - "input":{"shape":"UpdateDocumentVersionRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"InvalidOperationException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Changes the status of the document version to ACTIVE.

Amazon WorkDocs also sets its document container to ACTIVE. This is the last step in a document upload, after the client uploads the document to an S3-presigned URL returned by InitiateDocumentVersionUpload.

" - }, - "UpdateFolder":{ - "name":"UpdateFolder", - "http":{ - "method":"PATCH", - "requestUri":"/api/v1/folders/{FolderId}", - "responseCode":200 - }, - "input":{"shape":"UpdateFolderRequest"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"EntityAlreadyExistsException"}, - {"shape":"ProhibitedStateException"}, - {"shape":"ConcurrentModificationException"}, - {"shape":"LimitExceededException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"} - ], - "documentation":"

Updates the specified attributes of the specified folder. The user must have access to both the folder and its parent folder, if applicable.

" - }, - "UpdateUser":{ - "name":"UpdateUser", - "http":{ - "method":"PATCH", - "requestUri":"/api/v1/users/{UserId}", - "responseCode":200 - }, - "input":{"shape":"UpdateUserRequest"}, - "output":{"shape":"UpdateUserResponse"}, - "errors":[ - {"shape":"EntityNotExistsException"}, - {"shape":"UnauthorizedOperationException"}, - {"shape":"UnauthorizedResourceAccessException"}, - {"shape":"IllegalUserStateException"}, - {"shape":"FailedDependencyException"}, - {"shape":"ServiceUnavailableException"}, - {"shape":"DeactivatingLastSystemUserException"}, - {"shape":"InvalidArgumentException"} - ], - "documentation":"

Updates the specified attributes of the specified user, and grants or revokes administrative privileges to the Amazon WorkDocs site.

" - } - }, - "shapes":{ - "AbortDocumentVersionUploadRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the version.

", - "location":"uri", - "locationName":"VersionId" - } - } - }, - "ActivateUserRequest":{ - "type":"structure", - "required":["UserId"], - "members":{ - "UserId":{ - "shape":"IdType", - "documentation":"

The ID of the user.

", - "location":"uri", - "locationName":"UserId" - }, - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - } - } - }, - "ActivateUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

The user information.

" - } - } - }, - "Activity":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"ActivityType", - "documentation":"

The activity type.

" - }, - "TimeStamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the action was performed.

" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

" - }, - "Initiator":{ - "shape":"UserMetadata", - "documentation":"

The user who performed the action.

" - }, - "Participants":{ - "shape":"Participants", - "documentation":"

The list of users or groups impacted by this action. This is an optional field and is filled for the following sharing activities: DOCUMENT_SHARED, DOCUMENT_SHARED, DOCUMENT_UNSHARED, FOLDER_SHARED, FOLDER_UNSHARED.

" - }, - "ResourceMetadata":{ - "shape":"ResourceMetadata", - "documentation":"

The metadata of the resource involved in the user action.

" - }, - "OriginalParent":{ - "shape":"ResourceMetadata", - "documentation":"

The original parent of the resource. This is an optional field and is filled for move activities.

" - }, - "CommentMetadata":{ - "shape":"CommentMetadata", - "documentation":"

Metadata of the commenting activity. This is an optional field and is filled for commenting activities.

" - } - }, - "documentation":"

Describes the activity information.

" - }, - "ActivityType":{ - "type":"string", - "enum":[ - "DOCUMENT_CHECKED_IN", - "DOCUMENT_CHECKED_OUT", - "DOCUMENT_RENAMED", - "DOCUMENT_VERSION_UPLOADED", - "DOCUMENT_VERSION_DELETED", - "DOCUMENT_RECYCLED", - "DOCUMENT_RESTORED", - "DOCUMENT_REVERTED", - "DOCUMENT_SHARED", - "DOCUMENT_UNSHARED", - "DOCUMENT_SHARE_PERMISSION_CHANGED", - "DOCUMENT_SHAREABLE_LINK_CREATED", - "DOCUMENT_SHAREABLE_LINK_REMOVED", - "DOCUMENT_SHAREABLE_LINK_PERMISSION_CHANGED", - "DOCUMENT_MOVED", - "DOCUMENT_COMMENT_ADDED", - "DOCUMENT_COMMENT_DELETED", - "DOCUMENT_ANNOTATION_ADDED", - "DOCUMENT_ANNOTATION_DELETED", - "FOLDER_CREATED", - "FOLDER_DELETED", - "FOLDER_RENAMED", - "FOLDER_RECYCLED", - "FOLDER_RESTORED", - "FOLDER_SHARED", - "FOLDER_UNSHARED", - "FOLDER_SHARE_PERMISSION_CHANGED", - "FOLDER_SHAREABLE_LINK_CREATED", - "FOLDER_SHAREABLE_LINK_REMOVED", - "FOLDER_SHAREABLE_LINK_PERMISSION_CHANGED", - "FOLDER_MOVED" - ] - }, - "AddResourcePermissionsRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "Principals" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "Principals":{ - "shape":"SharePrincipalList", - "documentation":"

The users, groups, or organization being granted permission.

" - }, - "NotificationOptions":{ - "shape":"NotificationOptions", - "documentation":"

The notification options.

" - } - } - }, - "AddResourcePermissionsResponse":{ - "type":"structure", - "members":{ - "ShareResults":{ - "shape":"ShareResultsList", - "documentation":"

The share results.

" - } - } - }, - "AuthenticationHeaderType":{ - "type":"string", - "max":8199, - "min":1, - "sensitive":true - }, - "BooleanEnumType":{ - "type":"string", - "enum":[ - "TRUE", - "FALSE" - ] - }, - "BooleanType":{"type":"boolean"}, - "Comment":{ - "type":"structure", - "required":["CommentId"], - "members":{ - "CommentId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the comment.

" - }, - "ParentId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the parent comment.

" - }, - "ThreadId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the root comment in the thread.

" - }, - "Text":{ - "shape":"CommentTextType", - "documentation":"

The text of the comment.

" - }, - "Contributor":{ - "shape":"User", - "documentation":"

The details of the user who made the comment.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time that the comment was created.

" - }, - "Status":{ - "shape":"CommentStatusType", - "documentation":"

The status of the comment.

" - }, - "Visibility":{ - "shape":"CommentVisibilityType", - "documentation":"

The visibility of the comment. Options are either PRIVATE, where the comment is visible only to the comment author and document owner and co-owners, or PUBLIC, where the comment is visible to document owners, co-owners, and contributors.

" - }, - "RecipientId":{ - "shape":"IdType", - "documentation":"

If the comment is a reply to another user's comment, this field contains the user ID of the user being replied to.

" - } - }, - "documentation":"

Describes a comment.

" - }, - "CommentIdType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+-.@]+" - }, - "CommentList":{ - "type":"list", - "member":{"shape":"Comment"} - }, - "CommentMetadata":{ - "type":"structure", - "members":{ - "CommentId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the comment.

" - }, - "Contributor":{ - "shape":"User", - "documentation":"

The user who made the comment.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp that the comment was created.

" - }, - "CommentStatus":{ - "shape":"CommentStatusType", - "documentation":"

The status of the comment.

" - }, - "RecipientId":{ - "shape":"IdType", - "documentation":"

The ID of the user being replied to.

" - } - }, - "documentation":"

Describes the metadata of a comment.

" - }, - "CommentStatusType":{ - "type":"string", - "enum":[ - "DRAFT", - "PUBLISHED", - "DELETED" - ] - }, - "CommentTextType":{ - "type":"string", - "max":2048, - "min":1, - "sensitive":true - }, - "CommentVisibilityType":{ - "type":"string", - "enum":[ - "PUBLIC", - "PRIVATE" - ] - }, - "ConcurrentModificationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The resource hierarchy is changing.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "CreateCommentRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId", - "Text" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the document version.

", - "location":"uri", - "locationName":"VersionId" - }, - "ParentId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the parent comment.

" - }, - "ThreadId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the root comment in the thread.

" - }, - "Text":{ - "shape":"CommentTextType", - "documentation":"

The text of the comment.

" - }, - "Visibility":{ - "shape":"CommentVisibilityType", - "documentation":"

The visibility of the comment. Options are either PRIVATE, where the comment is visible only to the comment author and document owner and co-owners, or PUBLIC, where the comment is visible to document owners, co-owners, and contributors.

" - }, - "NotifyCollaborators":{ - "shape":"BooleanType", - "documentation":"

Set this parameter to TRUE to send an email out to the document collaborators after the comment is created.

" - } - } - }, - "CreateCommentResponse":{ - "type":"structure", - "members":{ - "Comment":{ - "shape":"Comment", - "documentation":"

The comment that has been created.

" - } - } - }, - "CreateCustomMetadataRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "CustomMetadata" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the version, if the custom metadata is being added to a document version.

", - "location":"querystring", - "locationName":"versionid" - }, - "CustomMetadata":{ - "shape":"CustomMetadataMap", - "documentation":"

Custom metadata in the form of name-value pairs.

" - } - } - }, - "CreateCustomMetadataResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateFolderRequest":{ - "type":"structure", - "required":["ParentFolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the new folder.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - } - } - }, - "CreateFolderResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"FolderMetadata", - "documentation":"

The metadata of the folder.

" - } - } - }, - "CreateLabelsRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "Labels" - ], - "members":{ - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "Labels":{ - "shape":"SharedLabels", - "documentation":"

List of labels to add to the resource.

" - }, - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - } - } - }, - "CreateLabelsResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateNotificationSubscriptionRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "Endpoint", - "Protocol", - "SubscriptionType" - ], - "members":{ - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

", - "location":"uri", - "locationName":"OrganizationId" - }, - "Endpoint":{ - "shape":"SubscriptionEndPointType", - "documentation":"

The endpoint to receive the notifications. If the protocol is HTTPS, the endpoint is a URL that begins with \"https://\".

" - }, - "Protocol":{ - "shape":"SubscriptionProtocolType", - "documentation":"

The protocol to use. The supported value is https, which delivers JSON-encoded messages using HTTPS POST.

" - }, - "SubscriptionType":{ - "shape":"SubscriptionType", - "documentation":"

The notification type.

" - } - } - }, - "CreateNotificationSubscriptionResponse":{ - "type":"structure", - "members":{ - "Subscription":{ - "shape":"Subscription", - "documentation":"

The subscription.

" - } - } - }, - "CreateUserRequest":{ - "type":"structure", - "required":[ - "Username", - "GivenName", - "Surname", - "Password" - ], - "members":{ - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The login name of the user.

" - }, - "EmailAddress":{ - "shape":"EmailAddressType", - "documentation":"

The email address of the user.

" - }, - "GivenName":{ - "shape":"UserAttributeValueType", - "documentation":"

The given name of the user.

" - }, - "Surname":{ - "shape":"UserAttributeValueType", - "documentation":"

The surname of the user.

" - }, - "Password":{ - "shape":"PasswordType", - "documentation":"

The password of the user.

" - }, - "TimeZoneId":{ - "shape":"TimeZoneIdType", - "documentation":"

The time zone ID of the user.

" - }, - "StorageRule":{ - "shape":"StorageRuleType", - "documentation":"

The amount of storage for the user.

" - }, - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - } - } - }, - "CreateUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

The user information.

" - } - } - }, - "CustomMetadataKeyList":{ - "type":"list", - "member":{"shape":"CustomMetadataKeyType"}, - "max":8 - }, - "CustomMetadataKeyType":{ - "type":"string", - "max":56, - "min":1, - "pattern":"[a-zA-Z0-9._+-/=][a-zA-Z0-9 ._+-/=]*" - }, - "CustomMetadataLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The limit has been reached on the number of custom properties for the specified resource.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "CustomMetadataMap":{ - "type":"map", - "key":{"shape":"CustomMetadataKeyType"}, - "value":{"shape":"CustomMetadataValueType"}, - "max":8, - "min":1 - }, - "CustomMetadataValueType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9._+-/=][a-zA-Z0-9 ._+-/=]*" - }, - "DeactivateUserRequest":{ - "type":"structure", - "required":["UserId"], - "members":{ - "UserId":{ - "shape":"IdType", - "documentation":"

The ID of the user.

", - "location":"uri", - "locationName":"UserId" - }, - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - } - } - }, - "DeactivatingLastSystemUserException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The last user in the organization is being deactivated.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DeleteCommentRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId", - "CommentId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the document version.

", - "location":"uri", - "locationName":"VersionId" - }, - "CommentId":{ - "shape":"CommentIdType", - "documentation":"

The ID of the comment.

", - "location":"uri", - "locationName":"CommentId" - } - } - }, - "DeleteCustomMetadataRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource, either a document or folder.

", - "location":"uri", - "locationName":"ResourceId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the version, if the custom metadata is being deleted from a document version.

", - "location":"querystring", - "locationName":"versionId" - }, - "Keys":{ - "shape":"CustomMetadataKeyList", - "documentation":"

List of properties to remove.

", - "location":"querystring", - "locationName":"keys" - }, - "DeleteAll":{ - "shape":"BooleanType", - "documentation":"

Flag to indicate removal of all custom metadata properties from the specified resource.

", - "location":"querystring", - "locationName":"deleteAll" - } - } - }, - "DeleteCustomMetadataResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteDocumentRequest":{ - "type":"structure", - "required":["DocumentId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - } - } - }, - "DeleteFolderContentsRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - } - } - }, - "DeleteFolderRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - } - } - }, - "DeleteLabelsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "Labels":{ - "shape":"SharedLabels", - "documentation":"

List of labels to delete from the resource.

", - "location":"querystring", - "locationName":"labels" - }, - "DeleteAll":{ - "shape":"BooleanType", - "documentation":"

Flag to request removal of all labels from the specified resource.

", - "location":"querystring", - "locationName":"deleteAll" - } - } - }, - "DeleteLabelsResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteNotificationSubscriptionRequest":{ - "type":"structure", - "required":[ - "SubscriptionId", - "OrganizationId" - ], - "members":{ - "SubscriptionId":{ - "shape":"IdType", - "documentation":"

The ID of the subscription.

", - "location":"uri", - "locationName":"SubscriptionId" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

", - "location":"uri", - "locationName":"OrganizationId" - } - } - }, - "DeleteUserRequest":{ - "type":"structure", - "required":["UserId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "UserId":{ - "shape":"IdType", - "documentation":"

The ID of the user.

", - "location":"uri", - "locationName":"UserId" - } - } - }, - "DescribeActivitiesRequest":{ - "type":"structure", - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "StartTime":{ - "shape":"TimestampType", - "documentation":"

The timestamp that determines the starting time of the activities. The response includes the activities performed after the specified timestamp.

", - "location":"querystring", - "locationName":"startTime" - }, - "EndTime":{ - "shape":"TimestampType", - "documentation":"

The timestamp that determines the end time of the activities. The response includes the activities performed before the specified timestamp.

", - "location":"querystring", - "locationName":"endTime" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization. This is a mandatory parameter when using administrative API (SigV4) requests.

", - "location":"querystring", - "locationName":"organizationId" - }, - "UserId":{ - "shape":"IdType", - "documentation":"

The ID of the user who performed the action. The response includes activities pertaining to this user. This is an optional parameter and is only applicable for administrative API (SigV4) requests.

", - "location":"querystring", - "locationName":"userId" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker for the next set of results.

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "DescribeActivitiesResponse":{ - "type":"structure", - "members":{ - "UserActivities":{ - "shape":"UserActivities", - "documentation":"

The list of activities for the specified user and time period.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker for the next set of results.

" - } - } - }, - "DescribeCommentsRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the document version.

", - "location":"uri", - "locationName":"VersionId" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker for the next set of results. This marker was received from a previous call.

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "DescribeCommentsResponse":{ - "type":"structure", - "members":{ - "Comments":{ - "shape":"CommentList", - "documentation":"

The list of comments for the specified document version.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker for the next set of results. This marker was received from a previous call.

" - } - } - }, - "DescribeDocumentVersionsRequest":{ - "type":"structure", - "required":["DocumentId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

", - "location":"querystring", - "locationName":"marker" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of versions to return with this call.

", - "location":"querystring", - "locationName":"limit" - }, - "Include":{ - "shape":"FieldNamesType", - "documentation":"

A comma-separated list of values. Specify \"INITIALIZED\" to include incomplete versions.

", - "location":"querystring", - "locationName":"include" - }, - "Fields":{ - "shape":"FieldNamesType", - "documentation":"

Specify \"SOURCE\" to include initialized versions and a URL for the source document.

", - "location":"querystring", - "locationName":"fields" - } - } - }, - "DescribeDocumentVersionsResponse":{ - "type":"structure", - "members":{ - "DocumentVersions":{ - "shape":"DocumentVersionMetadataList", - "documentation":"

The document versions.

" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeFolderContentsRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - }, - "Sort":{ - "shape":"ResourceSortType", - "documentation":"

The sorting criteria.

", - "location":"querystring", - "locationName":"sort" - }, - "Order":{ - "shape":"OrderType", - "documentation":"

The order for the contents of the folder.

", - "location":"querystring", - "locationName":"order" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return with this call.

", - "location":"querystring", - "locationName":"limit" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. This marker was received from a previous call.

", - "location":"querystring", - "locationName":"marker" - }, - "Type":{ - "shape":"FolderContentType", - "documentation":"

The type of items.

", - "location":"querystring", - "locationName":"type" - }, - "Include":{ - "shape":"FieldNamesType", - "documentation":"

The contents to include. Specify \"INITIALIZED\" to include initialized documents.

", - "location":"querystring", - "locationName":"include" - } - } - }, - "DescribeFolderContentsResponse":{ - "type":"structure", - "members":{ - "Folders":{ - "shape":"FolderMetadataList", - "documentation":"

The subfolders in the specified folder.

" - }, - "Documents":{ - "shape":"DocumentMetadataList", - "documentation":"

The documents in the specified folder.

" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeGroupsRequest":{ - "type":"structure", - "required":["SearchQuery"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "SearchQuery":{ - "shape":"SearchQueryType", - "documentation":"

A query to describe groups by group name.

", - "location":"querystring", - "locationName":"searchQuery" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

", - "location":"querystring", - "locationName":"organizationId" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

", - "location":"querystring", - "locationName":"marker" - }, - "Limit":{ - "shape":"PositiveIntegerType", - "documentation":"

The maximum number of items to return with this call.

", - "location":"querystring", - "locationName":"limit" - } - } - }, - "DescribeGroupsResponse":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"GroupMetadataList", - "documentation":"

The list of groups.

" - }, - "Marker":{ - "shape":"MarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeNotificationSubscriptionsRequest":{ - "type":"structure", - "required":["OrganizationId"], - "members":{ - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

", - "location":"uri", - "locationName":"OrganizationId" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

", - "location":"querystring", - "locationName":"marker" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return with this call.

", - "location":"querystring", - "locationName":"limit" - } - } - }, - "DescribeNotificationSubscriptionsResponse":{ - "type":"structure", - "members":{ - "Subscriptions":{ - "shape":"SubscriptionList", - "documentation":"

The subscriptions.

" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeResourcePermissionsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "PrincipalId":{ - "shape":"IdType", - "documentation":"

The ID of the principal to filter permissions by.

", - "location":"querystring", - "locationName":"principalId" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return with this call.

", - "location":"querystring", - "locationName":"limit" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call)

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "DescribeResourcePermissionsResponse":{ - "type":"structure", - "members":{ - "Principals":{ - "shape":"PrincipalList", - "documentation":"

The principals.

" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DescribeRootFoldersRequest":{ - "type":"structure", - "required":["AuthenticationToken"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "DescribeRootFoldersResponse":{ - "type":"structure", - "members":{ - "Folders":{ - "shape":"FolderMetadataList", - "documentation":"

The user's special folders.

" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results.

" - } - } - }, - "DescribeUsersRequest":{ - "type":"structure", - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

", - "location":"querystring", - "locationName":"organizationId" - }, - "UserIds":{ - "shape":"UserIdsType", - "documentation":"

The IDs of the users.

", - "location":"querystring", - "locationName":"userIds" - }, - "Query":{ - "shape":"SearchQueryType", - "documentation":"

A query to filter users by user name.

", - "location":"querystring", - "locationName":"query" - }, - "Include":{ - "shape":"UserFilterType", - "documentation":"

The state of the users. Specify \"ALL\" to include inactive users.

", - "location":"querystring", - "locationName":"include" - }, - "Order":{ - "shape":"OrderType", - "documentation":"

The order for the results.

", - "location":"querystring", - "locationName":"order" - }, - "Sort":{ - "shape":"UserSortType", - "documentation":"

The sorting criteria.

", - "location":"querystring", - "locationName":"sort" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker for the next set of results. (You received this marker from a previous call.)

", - "location":"querystring", - "locationName":"marker" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of items to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Fields":{ - "shape":"FieldNamesType", - "documentation":"

A comma-separated list of values. Specify \"STORAGE_METADATA\" to include the user storage quota and utilization information.

", - "location":"querystring", - "locationName":"fields" - } - } - }, - "DescribeUsersResponse":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"OrganizationUserList", - "documentation":"

The users.

" - }, - "TotalNumberOfUsers":{ - "shape":"SizeType", - "documentation":"

The total number of users included in the results.

", - "deprecated":true - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

" - } - } - }, - "DocumentContentType":{ - "type":"string", - "max":128, - "min":1 - }, - "DocumentLockedForCommentsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

This exception is thrown when the document is locked for comments and user tries to create or delete a comment on that document.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "DocumentMetadata":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

" - }, - "CreatorId":{ - "shape":"IdType", - "documentation":"

The ID of the creator.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the document was created.

" - }, - "ModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the document was updated.

" - }, - "LatestVersionMetadata":{ - "shape":"DocumentVersionMetadata", - "documentation":"

The latest version of the document.

" - }, - "ResourceState":{ - "shape":"ResourceStateType", - "documentation":"

The resource state.

" - }, - "Labels":{ - "shape":"SharedLabels", - "documentation":"

List of labels on the document.

" - } - }, - "documentation":"

Describes the document.

" - }, - "DocumentMetadataList":{ - "type":"list", - "member":{"shape":"DocumentMetadata"} - }, - "DocumentSourceType":{ - "type":"string", - "enum":[ - "ORIGINAL", - "WITH_COMMENTS" - ] - }, - "DocumentSourceUrlMap":{ - "type":"map", - "key":{"shape":"DocumentSourceType"}, - "value":{"shape":"UrlType"} - }, - "DocumentStatusType":{ - "type":"string", - "enum":[ - "INITIALIZED", - "ACTIVE" - ] - }, - "DocumentThumbnailType":{ - "type":"string", - "enum":[ - "SMALL", - "SMALL_HQ", - "LARGE" - ] - }, - "DocumentThumbnailUrlMap":{ - "type":"map", - "key":{"shape":"DocumentThumbnailType"}, - "value":{"shape":"UrlType"} - }, - "DocumentVersionIdType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+-.@]+" - }, - "DocumentVersionMetadata":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"DocumentVersionIdType", - "documentation":"

The ID of the version.

" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the version.

" - }, - "ContentType":{ - "shape":"DocumentContentType", - "documentation":"

The content type of the document.

" - }, - "Size":{ - "shape":"SizeType", - "documentation":"

The size of the document, in bytes.

" - }, - "Signature":{ - "shape":"HashType", - "documentation":"

The signature of the document.

" - }, - "Status":{ - "shape":"DocumentStatusType", - "documentation":"

The status of the document.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the document was first uploaded.

" - }, - "ModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the document was last uploaded.

" - }, - "ContentCreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the content of the document was originally created.

" - }, - "ContentModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the content of the document was modified.

" - }, - "CreatorId":{ - "shape":"IdType", - "documentation":"

The ID of the creator.

" - }, - "Thumbnail":{ - "shape":"DocumentThumbnailUrlMap", - "documentation":"

The thumbnail of the document.

" - }, - "Source":{ - "shape":"DocumentSourceUrlMap", - "documentation":"

The source of the document.

" - } - }, - "documentation":"

Describes a version of a document.

" - }, - "DocumentVersionMetadataList":{ - "type":"list", - "member":{"shape":"DocumentVersionMetadata"} - }, - "DocumentVersionStatus":{ - "type":"string", - "enum":["ACTIVE"] - }, - "DraftUploadOutOfSyncException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

This exception is thrown when a valid checkout ID is not presented on document version upload calls for a document that has been checked out from Web client.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "EmailAddressType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}" - }, - "EntityAlreadyExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The resource already exists.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "EntityIdList":{ - "type":"list", - "member":{"shape":"IdType"} - }, - "EntityNotExistsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"}, - "EntityIds":{"shape":"EntityIdList"} - }, - "documentation":"

The resource does not exist.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "ErrorMessageType":{"type":"string"}, - "FailedDependencyException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The AWS Directory Service cannot reach an on-premises instance. Or a dependency under the control of the organization is failing, such as a connected Active Directory.

", - "error":{"httpStatusCode":424}, - "exception":true - }, - "FieldNamesType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w,]+" - }, - "FolderContentType":{ - "type":"string", - "enum":[ - "ALL", - "DOCUMENT", - "FOLDER" - ] - }, - "FolderMetadata":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the folder.

" - }, - "CreatorId":{ - "shape":"IdType", - "documentation":"

The ID of the creator.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the folder was created.

" - }, - "ModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the folder was updated.

" - }, - "ResourceState":{ - "shape":"ResourceStateType", - "documentation":"

The resource state of the folder.

" - }, - "Signature":{ - "shape":"HashType", - "documentation":"

The unique identifier created from the subfolders and documents of the folder.

" - }, - "Labels":{ - "shape":"SharedLabels", - "documentation":"

List of labels on the folder.

" - }, - "Size":{ - "shape":"SizeType", - "documentation":"

The size of the folder metadata.

" - }, - "LatestVersionSize":{ - "shape":"SizeType", - "documentation":"

The size of the latest version of the folder metadata.

" - } - }, - "documentation":"

Describes a folder.

" - }, - "FolderMetadataList":{ - "type":"list", - "member":{"shape":"FolderMetadata"} - }, - "GetCurrentUserRequest":{ - "type":"structure", - "required":["AuthenticationToken"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - } - } - }, - "GetCurrentUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

Metadata of the user.

" - } - } - }, - "GetDocumentPathRequest":{ - "type":"structure", - "required":["DocumentId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"IdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of levels in the hierarchy to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Fields":{ - "shape":"FieldNamesType", - "documentation":"

A comma-separated list of values. Specify NAME to include the names of the parent folders.

", - "location":"querystring", - "locationName":"fields" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

This value is not supported.

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "GetDocumentPathResponse":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"ResourcePath", - "documentation":"

The path information.

" - } - } - }, - "GetDocumentRequest":{ - "type":"structure", - "required":["DocumentId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "IncludeCustomMetadata":{ - "shape":"BooleanType", - "documentation":"

Set this to TRUE to include custom metadata in the response.

", - "location":"querystring", - "locationName":"includeCustomMetadata" - } - } - }, - "GetDocumentResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"DocumentMetadata", - "documentation":"

The metadata details of the document.

" - }, - "CustomMetadata":{ - "shape":"CustomMetadataMap", - "documentation":"

The custom metadata on the document.

" - } - } - }, - "GetDocumentVersionRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The version ID of the document.

", - "location":"uri", - "locationName":"VersionId" - }, - "Fields":{ - "shape":"FieldNamesType", - "documentation":"

A comma-separated list of values. Specify \"SOURCE\" to include a URL for the source document.

", - "location":"querystring", - "locationName":"fields" - }, - "IncludeCustomMetadata":{ - "shape":"BooleanType", - "documentation":"

Set this to TRUE to include custom metadata in the response.

", - "location":"querystring", - "locationName":"includeCustomMetadata" - } - } - }, - "GetDocumentVersionResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"DocumentVersionMetadata", - "documentation":"

The version metadata.

" - }, - "CustomMetadata":{ - "shape":"CustomMetadataMap", - "documentation":"

The custom metadata on the document version.

" - } - } - }, - "GetFolderPathRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"IdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - }, - "Limit":{ - "shape":"LimitType", - "documentation":"

The maximum number of levels in the hierarchy to return.

", - "location":"querystring", - "locationName":"limit" - }, - "Fields":{ - "shape":"FieldNamesType", - "documentation":"

A comma-separated list of values. Specify \"NAME\" to include the names of the parent folders.

", - "location":"querystring", - "locationName":"fields" - }, - "Marker":{ - "shape":"PageMarkerType", - "documentation":"

This value is not supported.

", - "location":"querystring", - "locationName":"marker" - } - } - }, - "GetFolderPathResponse":{ - "type":"structure", - "members":{ - "Path":{ - "shape":"ResourcePath", - "documentation":"

The path information.

" - } - } - }, - "GetFolderRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - }, - "IncludeCustomMetadata":{ - "shape":"BooleanType", - "documentation":"

Set to TRUE to include custom metadata in the response.

", - "location":"querystring", - "locationName":"includeCustomMetadata" - } - } - }, - "GetFolderResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"FolderMetadata", - "documentation":"

The metadata of the folder.

" - }, - "CustomMetadata":{ - "shape":"CustomMetadataMap", - "documentation":"

The custom metadata on the folder.

" - } - } - }, - "GroupMetadata":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the user group.

" - }, - "Name":{ - "shape":"GroupNameType", - "documentation":"

The name of the group.

" - } - }, - "documentation":"

Describes the metadata of a user group.

" - }, - "GroupMetadataList":{ - "type":"list", - "member":{"shape":"GroupMetadata"} - }, - "GroupNameType":{"type":"string"}, - "HashType":{ - "type":"string", - "max":128, - "min":0, - "pattern":"[&\\w+-.@]+" - }, - "HeaderNameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w-]+" - }, - "HeaderValueType":{ - "type":"string", - "max":1024, - "min":1 - }, - "IdType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[&\\w+-.@]+" - }, - "IllegalUserStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The user is undergoing transfer of ownership.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "InitiateDocumentVersionUploadRequest":{ - "type":"structure", - "required":["ParentFolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "Id":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the document.

" - }, - "ContentCreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the content of the document was originally created.

" - }, - "ContentModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The timestamp when the content of the document was modified.

" - }, - "ContentType":{ - "shape":"DocumentContentType", - "documentation":"

The content type of the document.

" - }, - "DocumentSizeInBytes":{ - "shape":"SizeType", - "documentation":"

The size of the document, in bytes.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - } - } - }, - "InitiateDocumentVersionUploadResponse":{ - "type":"structure", - "members":{ - "Metadata":{ - "shape":"DocumentMetadata", - "documentation":"

The document metadata.

" - }, - "UploadMetadata":{ - "shape":"UploadMetadata", - "documentation":"

The upload metadata.

" - } - } - }, - "InvalidArgumentException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The pagination marker or limit fields are not valid.

", - "error":{"httpStatusCode":400}, - "exception":true - }, - "InvalidOperationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The operation is invalid.

", - "error":{"httpStatusCode":405}, - "exception":true - }, - "InvalidPasswordException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The password is invalid.

", - "error":{"httpStatusCode":401}, - "exception":true - }, - "LimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The maximum of 100,000 folders under the parent folder has been exceeded.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "LimitType":{ - "type":"integer", - "max":999, - "min":1 - }, - "LocaleType":{ - "type":"string", - "enum":[ - "en", - "fr", - "ko", - "de", - "es", - "ja", - "ru", - "zh_CN", - "zh_TW", - "pt_BR", - "default" - ] - }, - "MarkerType":{ - "type":"string", - "max":2048, - "min":1, - "pattern":"[\\u0000-\\u00FF]+" - }, - "MessageType":{ - "type":"string", - "max":2048, - "min":0, - "sensitive":true - }, - "NotificationOptions":{ - "type":"structure", - "members":{ - "SendEmail":{ - "shape":"BooleanType", - "documentation":"

Boolean value to indicate an email notification should be sent to the receipients.

" - }, - "EmailMessage":{ - "shape":"MessageType", - "documentation":"

Text value to be included in the email body.

" - } - }, - "documentation":"

Set of options which defines notification preferences of given action.

" - }, - "OrderType":{ - "type":"string", - "enum":[ - "ASCENDING", - "DESCENDING" - ] - }, - "OrganizationUserList":{ - "type":"list", - "member":{"shape":"User"} - }, - "PageMarkerType":{ - "type":"string", - "max":2048, - "min":1 - }, - "Participants":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"UserMetadataList", - "documentation":"

The list of users.

" - }, - "Groups":{ - "shape":"GroupMetadataList", - "documentation":"

The list of user groups.

" - } - }, - "documentation":"

Describes the users or user groups.

" - }, - "PasswordType":{ - "type":"string", - "max":32, - "min":4, - "pattern":"[\\u0020-\\u00FF]+", - "sensitive":true - }, - "PermissionInfo":{ - "type":"structure", - "members":{ - "Role":{ - "shape":"RoleType", - "documentation":"

The role of the user.

" - }, - "Type":{ - "shape":"RolePermissionType", - "documentation":"

The type of permissions.

" - } - }, - "documentation":"

Describes the permissions.

" - }, - "PermissionInfoList":{ - "type":"list", - "member":{"shape":"PermissionInfo"} - }, - "PositiveIntegerType":{ - "type":"integer", - "min":1 - }, - "PositiveSizeType":{ - "type":"long", - "min":0 - }, - "Principal":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the resource.

" - }, - "Type":{ - "shape":"PrincipalType", - "documentation":"

The type of resource.

" - }, - "Roles":{ - "shape":"PermissionInfoList", - "documentation":"

The permission information for the resource.

" - } - }, - "documentation":"

Describes a resource.

" - }, - "PrincipalList":{ - "type":"list", - "member":{"shape":"Principal"} - }, - "PrincipalType":{ - "type":"string", - "enum":[ - "USER", - "GROUP", - "INVITE", - "ANONYMOUS", - "ORGANIZATION" - ] - }, - "ProhibitedStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The specified document version is not in the INITIALIZED state.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "RemoveAllResourcePermissionsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - } - } - }, - "RemoveResourcePermissionRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "PrincipalId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "ResourceId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

", - "location":"uri", - "locationName":"ResourceId" - }, - "PrincipalId":{ - "shape":"IdType", - "documentation":"

The principal ID of the resource.

", - "location":"uri", - "locationName":"PrincipalId" - }, - "PrincipalType":{ - "shape":"PrincipalType", - "documentation":"

The principal type of the resource.

", - "location":"querystring", - "locationName":"type" - } - } - }, - "ResourceAlreadyCheckedOutException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The resource is already checked out.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "ResourceIdType":{ - "type":"string", - "max":128, - "min":1, - "pattern":"[\\w+-.@]+" - }, - "ResourceMetadata":{ - "type":"structure", - "members":{ - "Type":{ - "shape":"ResourceType", - "documentation":"

The type of resource.

" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the resource.

" - }, - "OriginalName":{ - "shape":"ResourceNameType", - "documentation":"

The original name of the resource before a rename operation.

" - }, - "Id":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource.

" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The version ID of the resource. This is an optional field and is filled for action on document version.

" - }, - "Owner":{ - "shape":"UserMetadata", - "documentation":"

The owner of the resource.

" - }, - "ParentId":{ - "shape":"ResourceIdType", - "documentation":"

The parent ID of the resource before a rename operation.

" - } - }, - "documentation":"

Describes the metadata of a resource.

" - }, - "ResourceNameType":{ - "type":"string", - "max":255, - "min":1, - "pattern":"[\\u0020-\\u202D\\u202F-\\uFFFF]+" - }, - "ResourcePath":{ - "type":"structure", - "members":{ - "Components":{ - "shape":"ResourcePathComponentList", - "documentation":"

The components of the resource path.

" - } - }, - "documentation":"

Describes the path information of a resource.

" - }, - "ResourcePathComponent":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the resource path.

" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the resource path.

" - } - }, - "documentation":"

Describes the resource path.

" - }, - "ResourcePathComponentList":{ - "type":"list", - "member":{"shape":"ResourcePathComponent"} - }, - "ResourceSortType":{ - "type":"string", - "enum":[ - "DATE", - "NAME" - ] - }, - "ResourceStateType":{ - "type":"string", - "enum":[ - "ACTIVE", - "RESTORING", - "RECYCLING", - "RECYCLED" - ] - }, - "ResourceType":{ - "type":"string", - "enum":[ - "FOLDER", - "DOCUMENT" - ] - }, - "RolePermissionType":{ - "type":"string", - "enum":[ - "DIRECT", - "INHERITED" - ] - }, - "RoleType":{ - "type":"string", - "enum":[ - "VIEWER", - "CONTRIBUTOR", - "OWNER", - "COOWNER" - ] - }, - "SearchQueryType":{ - "type":"string", - "max":512, - "min":1, - "pattern":"[\\u0020-\\uFFFF]+", - "sensitive":true - }, - "ServiceUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

One or more of the dependencies is unavailable.

", - "error":{"httpStatusCode":503}, - "exception":true, - "fault":true - }, - "SharePrincipal":{ - "type":"structure", - "required":[ - "Id", - "Type", - "Role" - ], - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the recipient.

" - }, - "Type":{ - "shape":"PrincipalType", - "documentation":"

The type of the recipient.

" - }, - "Role":{ - "shape":"RoleType", - "documentation":"

The role of the recipient.

" - } - }, - "documentation":"

Describes the recipient type and ID, if available.

" - }, - "SharePrincipalList":{ - "type":"list", - "member":{"shape":"SharePrincipal"} - }, - "ShareResult":{ - "type":"structure", - "members":{ - "PrincipalId":{ - "shape":"IdType", - "documentation":"

The ID of the principal.

" - }, - "Role":{ - "shape":"RoleType", - "documentation":"

The role.

" - }, - "Status":{ - "shape":"ShareStatusType", - "documentation":"

The status.

" - }, - "ShareId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the resource that was shared.

" - }, - "StatusMessage":{ - "shape":"MessageType", - "documentation":"

The status message.

" - } - }, - "documentation":"

Describes the share results of a resource.

" - }, - "ShareResultsList":{ - "type":"list", - "member":{"shape":"ShareResult"} - }, - "ShareStatusType":{ - "type":"string", - "enum":[ - "SUCCESS", - "FAILURE" - ] - }, - "SharedLabel":{ - "type":"string", - "max":32, - "min":1, - "pattern":"[a-zA-Z0-9._+-/=][a-zA-Z0-9 ._+-/=]*" - }, - "SharedLabels":{ - "type":"list", - "member":{"shape":"SharedLabel"}, - "max":20 - }, - "SignedHeaderMap":{ - "type":"map", - "key":{"shape":"HeaderNameType"}, - "value":{"shape":"HeaderValueType"} - }, - "SizeType":{"type":"long"}, - "StorageLimitExceededException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The storage limit has been exceeded.

", - "error":{"httpStatusCode":409}, - "exception":true - }, - "StorageLimitWillExceedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The storage limit will be exceeded.

", - "error":{"httpStatusCode":413}, - "exception":true - }, - "StorageRuleType":{ - "type":"structure", - "members":{ - "StorageAllocatedInBytes":{ - "shape":"PositiveSizeType", - "documentation":"

The amount of storage allocated, in bytes.

" - }, - "StorageType":{ - "shape":"StorageType", - "documentation":"

The type of storage.

" - } - }, - "documentation":"

Describes the storage for a user.

" - }, - "StorageType":{ - "type":"string", - "enum":[ - "UNLIMITED", - "QUOTA" - ] - }, - "Subscription":{ - "type":"structure", - "members":{ - "SubscriptionId":{ - "shape":"IdType", - "documentation":"

The ID of the subscription.

" - }, - "EndPoint":{ - "shape":"SubscriptionEndPointType", - "documentation":"

The endpoint of the subscription.

" - }, - "Protocol":{ - "shape":"SubscriptionProtocolType", - "documentation":"

The protocol of the subscription.

" - } - }, - "documentation":"

Describes a subscription.

" - }, - "SubscriptionEndPointType":{ - "type":"string", - "max":256, - "min":1 - }, - "SubscriptionList":{ - "type":"list", - "member":{"shape":"Subscription"}, - "max":256 - }, - "SubscriptionProtocolType":{ - "type":"string", - "enum":["HTTPS"] - }, - "SubscriptionType":{ - "type":"string", - "enum":["ALL"] - }, - "TimeZoneIdType":{ - "type":"string", - "max":256, - "min":1 - }, - "TimestampType":{"type":"timestamp"}, - "TooManyLabelsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The limit has been reached on the number of labels for the specified resource.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "TooManySubscriptionsException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

You've reached the limit on the number of subscriptions for the WorkDocs instance.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "UnauthorizedOperationException":{ - "type":"structure", - "members":{ - }, - "documentation":"

The operation is not permitted.

", - "error":{"httpStatusCode":403}, - "exception":true - }, - "UnauthorizedResourceAccessException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessageType"} - }, - "documentation":"

The caller does not have access to perform the action on the resource.

", - "error":{"httpStatusCode":404}, - "exception":true - }, - "UpdateDocumentRequest":{ - "type":"structure", - "required":["DocumentId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the document.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - }, - "ResourceState":{ - "shape":"ResourceStateType", - "documentation":"

The resource state of the document. Only ACTIVE and RECYCLED are supported.

" - } - } - }, - "UpdateDocumentVersionRequest":{ - "type":"structure", - "required":[ - "DocumentId", - "VersionId" - ], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "DocumentId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the document.

", - "location":"uri", - "locationName":"DocumentId" - }, - "VersionId":{ - "shape":"DocumentVersionIdType", - "documentation":"

The version ID of the document.

", - "location":"uri", - "locationName":"VersionId" - }, - "VersionStatus":{ - "shape":"DocumentVersionStatus", - "documentation":"

The status of the version.

" - } - } - }, - "UpdateFolderRequest":{ - "type":"structure", - "required":["FolderId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "FolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the folder.

", - "location":"uri", - "locationName":"FolderId" - }, - "Name":{ - "shape":"ResourceNameType", - "documentation":"

The name of the folder.

" - }, - "ParentFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the parent folder.

" - }, - "ResourceState":{ - "shape":"ResourceStateType", - "documentation":"

The resource state of the folder. Only ACTIVE and RECYCLED are accepted values from the API.

" - } - } - }, - "UpdateUserRequest":{ - "type":"structure", - "required":["UserId"], - "members":{ - "AuthenticationToken":{ - "shape":"AuthenticationHeaderType", - "documentation":"

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

", - "location":"header", - "locationName":"Authentication" - }, - "UserId":{ - "shape":"IdType", - "documentation":"

The ID of the user.

", - "location":"uri", - "locationName":"UserId" - }, - "GivenName":{ - "shape":"UserAttributeValueType", - "documentation":"

The given name of the user.

" - }, - "Surname":{ - "shape":"UserAttributeValueType", - "documentation":"

The surname of the user.

" - }, - "Type":{ - "shape":"UserType", - "documentation":"

The type of the user.

" - }, - "StorageRule":{ - "shape":"StorageRuleType", - "documentation":"

The amount of storage for the user.

" - }, - "TimeZoneId":{ - "shape":"TimeZoneIdType", - "documentation":"

The time zone ID of the user.

" - }, - "Locale":{ - "shape":"LocaleType", - "documentation":"

The locale of the user.

" - }, - "GrantPoweruserPrivileges":{ - "shape":"BooleanEnumType", - "documentation":"

Boolean value to determine whether the user is granted Poweruser privileges.

" - } - } - }, - "UpdateUserResponse":{ - "type":"structure", - "members":{ - "User":{ - "shape":"User", - "documentation":"

The user information.

" - } - } - }, - "UploadMetadata":{ - "type":"structure", - "members":{ - "UploadUrl":{ - "shape":"UrlType", - "documentation":"

The URL of the upload.

" - }, - "SignedHeaders":{ - "shape":"SignedHeaderMap", - "documentation":"

The signed headers.

" - } - }, - "documentation":"

Describes the upload.

" - }, - "UrlType":{ - "type":"string", - "max":1024, - "min":1, - "sensitive":true - }, - "User":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The login name of the user.

" - }, - "EmailAddress":{ - "shape":"EmailAddressType", - "documentation":"

The email address of the user.

" - }, - "GivenName":{ - "shape":"UserAttributeValueType", - "documentation":"

The given name of the user.

" - }, - "Surname":{ - "shape":"UserAttributeValueType", - "documentation":"

The surname of the user.

" - }, - "OrganizationId":{ - "shape":"IdType", - "documentation":"

The ID of the organization.

" - }, - "RootFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the root folder.

" - }, - "RecycleBinFolderId":{ - "shape":"ResourceIdType", - "documentation":"

The ID of the recycle bin folder.

" - }, - "Status":{ - "shape":"UserStatusType", - "documentation":"

The status of the user.

" - }, - "Type":{ - "shape":"UserType", - "documentation":"

The type of user.

" - }, - "CreatedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the user was created.

" - }, - "ModifiedTimestamp":{ - "shape":"TimestampType", - "documentation":"

The time when the user was modified.

" - }, - "TimeZoneId":{ - "shape":"TimeZoneIdType", - "documentation":"

The time zone ID of the user.

" - }, - "Locale":{ - "shape":"LocaleType", - "documentation":"

The locale of the user.

" - }, - "Storage":{ - "shape":"UserStorageMetadata", - "documentation":"

The storage for the user.

" - } - }, - "documentation":"

Describes a user.

" - }, - "UserActivities":{ - "type":"list", - "member":{"shape":"Activity"} - }, - "UserAttributeValueType":{ - "type":"string", - "max":64, - "min":1 - }, - "UserFilterType":{ - "type":"string", - "enum":[ - "ALL", - "ACTIVE_PENDING" - ] - }, - "UserIdsType":{ - "type":"string", - "max":2000, - "min":1, - "pattern":"[&\\w+-.@, ]+" - }, - "UserMetadata":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"IdType", - "documentation":"

The ID of the user.

" - }, - "Username":{ - "shape":"UsernameType", - "documentation":"

The name of the user.

" - }, - "GivenName":{ - "shape":"UserAttributeValueType", - "documentation":"

The given name of the user before a rename operation.

" - }, - "Surname":{ - "shape":"UserAttributeValueType", - "documentation":"

The surname of the user.

" - }, - "EmailAddress":{ - "shape":"EmailAddressType", - "documentation":"

The email address of the user.

" - } - }, - "documentation":"

Describes the metadata of the user.

" - }, - "UserMetadataList":{ - "type":"list", - "member":{"shape":"UserMetadata"} - }, - "UserSortType":{ - "type":"string", - "enum":[ - "USER_NAME", - "FULL_NAME", - "STORAGE_LIMIT", - "USER_STATUS", - "STORAGE_USED" - ] - }, - "UserStatusType":{ - "type":"string", - "enum":[ - "ACTIVE", - "INACTIVE", - "PENDING" - ] - }, - "UserStorageMetadata":{ - "type":"structure", - "members":{ - "StorageUtilizedInBytes":{ - "shape":"SizeType", - "documentation":"

The amount of storage used, in bytes.

" - }, - "StorageRule":{ - "shape":"StorageRuleType", - "documentation":"

The storage for a user.

" - } - }, - "documentation":"

Describes the storage for a user.

" - }, - "UserType":{ - "type":"string", - "enum":[ - "USER", - "ADMIN", - "POWERUSER", - "MINIMALUSER", - "WORKSPACESUSER" - ] - }, - "UsernameType":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\w\\-+.]+(@[a-zA-Z0-9.\\-]+\\.[a-zA-Z]+)?" - } - }, - "documentation":"

The WorkDocs API is designed for the following use cases:

  • File Migration: File migration applications are supported for users who want to migrate their files from an on-premises or off-premises file system or service. Users can insert files into a user directory structure, as well as allow for basic metadata changes, such as modifications to the permissions of files.

  • Security: Support security applications are supported for users who have additional security needs, such as antivirus or data loss prevention. The API actions, along with AWS CloudTrail, allow these applications to detect when changes occur in Amazon WorkDocs. Then, the application can take the necessary actions and replace the target file. If the target file violates the policy, the application can also choose to email the user.

  • eDiscovery/Analytics: General administrative applications are supported, such as eDiscovery and analytics. These applications can choose to mimic or record the actions in an Amazon WorkDocs site, along with AWS CloudTrail, to replicate data for eDiscovery, backup, or analytical applications.

All Amazon WorkDocs API actions are Amazon authenticated and certificate-signed. They not only require the use of the AWS SDK, but also allow for the exclusive use of IAM users and roles to help facilitate access, trust, and permission policies. By creating a role and allowing an IAM user to access the Amazon WorkDocs site, the IAM user gains full administrative visibility into the entire Amazon WorkDocs site (or as set in the IAM policy). This includes, but is not limited to, the ability to modify file permissions and upload any file to any user. This allows developers to perform the three use cases above, as well as give users the ability to grant access on a selective basis using the IAM model.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/paginators-1.json deleted file mode 100644 index d5de8253..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "ListUsers": { - "result_key": "Users", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListGroupMembers": { - "result_key": "Members", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListOrganizations": { - "result_key": "OrganizationSummaries", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListGroups": { - "result_key": "Groups", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListResources": { - "result_key": "Resources", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - }, - "ListAliases": { - "result_key": "Aliases", - "output_token": "NextToken", - "input_token": "NextToken", - "limit_key": "MaxResults" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/service-2.json deleted file mode 100644 index d0ca5c1e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workmail/2017-10-01/service-2.json +++ /dev/null @@ -1,2070 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2017-10-01", - "endpointPrefix":"workmail", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon WorkMail", - "serviceId":"WorkMail", - "signatureVersion":"v4", - "targetPrefix":"WorkMailService", - "uid":"workmail-2017-10-01" - }, - "operations":{ - "AssociateDelegateToResource":{ - "name":"AssociateDelegateToResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateDelegateToResourceRequest"}, - "output":{"shape":"AssociateDelegateToResourceResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Adds a member to the resource's set of delegates.

", - "idempotent":true - }, - "AssociateMemberToGroup":{ - "name":"AssociateMemberToGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateMemberToGroupRequest"}, - "output":{"shape":"AssociateMemberToGroupResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Adds a member to the group's set.

", - "idempotent":true - }, - "CreateAlias":{ - "name":"CreateAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateAliasRequest"}, - "output":{"shape":"CreateAliasResponse"}, - "errors":[ - {"shape":"EmailAddressInUseException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"MailDomainNotFoundException"}, - {"shape":"MailDomainStateException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Adds an alias to the set of a given member of Amazon WorkMail.

", - "idempotent":true - }, - "CreateGroup":{ - "name":"CreateGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateGroupRequest"}, - "output":{"shape":"CreateGroupResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NameAvailabilityException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"ReservedNameException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.

", - "idempotent":true - }, - "CreateResource":{ - "name":"CreateResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateResourceRequest"}, - "output":{"shape":"CreateResourceResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"NameAvailabilityException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"ReservedNameException"} - ], - "documentation":"

Creates a new Amazon WorkMail resource. The available types are equipment and room.

", - "idempotent":true - }, - "CreateUser":{ - "name":"CreateUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateUserRequest"}, - "output":{"shape":"CreateUserResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"NameAvailabilityException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"ReservedNameException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Creates a user who can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.

", - "idempotent":true - }, - "DeleteAlias":{ - "name":"DeleteAlias", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteAliasRequest"}, - "output":{"shape":"DeleteAliasResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Remove the alias from a set of aliases for a given user.

", - "idempotent":true - }, - "DeleteGroup":{ - "name":"DeleteGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteGroupRequest"}, - "output":{"shape":"DeleteGroupResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Deletes a group from Amazon WorkMail.

", - "idempotent":true - }, - "DeleteMailboxPermissions":{ - "name":"DeleteMailboxPermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteMailboxPermissionsRequest"}, - "output":{"shape":"DeleteMailboxPermissionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Deletes permissions granted to a user or group.

", - "idempotent":true - }, - "DeleteResource":{ - "name":"DeleteResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteResourceRequest"}, - "output":{"shape":"DeleteResourceResponse"}, - "errors":[ - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Deletes the specified resource.

", - "idempotent":true - }, - "DeleteUser":{ - "name":"DeleteUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteUserRequest"}, - "output":{"shape":"DeleteUserResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Deletes a user from Amazon WorkMail and all subsequent systems. The action can't be undone. The mailbox is kept as-is for a minimum of 30 days, without any means to restore it.

", - "idempotent":true - }, - "DeregisterFromWorkMail":{ - "name":"DeregisterFromWorkMail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeregisterFromWorkMailRequest"}, - "output":{"shape":"DeregisterFromWorkMailResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Mark a user, group, or resource as no longer used in Amazon WorkMail. This action disassociates the mailbox and schedules it for clean-up. Amazon WorkMail keeps mailboxes for 30 days before they are permanently removed. The functionality in the console is Disable.

", - "idempotent":true - }, - "DescribeGroup":{ - "name":"DescribeGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeGroupRequest"}, - "output":{"shape":"DescribeGroupResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns the data available for the group.

", - "idempotent":true - }, - "DescribeOrganization":{ - "name":"DescribeOrganization", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeOrganizationRequest"}, - "output":{"shape":"DescribeOrganizationResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"} - ], - "documentation":"

Provides more information regarding a given organization based on its identifier.

", - "idempotent":true - }, - "DescribeResource":{ - "name":"DescribeResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeResourceRequest"}, - "output":{"shape":"DescribeResourceResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns the data available for the resource.

", - "idempotent":true - }, - "DescribeUser":{ - "name":"DescribeUser", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeUserRequest"}, - "output":{"shape":"DescribeUserResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Provides information regarding the user.

", - "idempotent":true - }, - "DisassociateDelegateFromResource":{ - "name":"DisassociateDelegateFromResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateDelegateFromResourceRequest"}, - "output":{"shape":"DisassociateDelegateFromResourceResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Removes a member from the resource's set of delegates.

", - "idempotent":true - }, - "DisassociateMemberFromGroup":{ - "name":"DisassociateMemberFromGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateMemberFromGroupRequest"}, - "output":{"shape":"DisassociateMemberFromGroupResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Removes a member from a group.

", - "idempotent":true - }, - "ListAliases":{ - "name":"ListAliases", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListAliasesRequest"}, - "output":{"shape":"ListAliasesResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Creates a paginated call to list the aliases associated with a given entity.

", - "idempotent":true - }, - "ListGroupMembers":{ - "name":"ListGroupMembers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupMembersRequest"}, - "output":{"shape":"ListGroupMembersResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns an overview of the members of a group.

", - "idempotent":true - }, - "ListGroups":{ - "name":"ListGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListGroupsRequest"}, - "output":{"shape":"ListGroupsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns summaries of the organization's groups.

", - "idempotent":true - }, - "ListMailboxPermissions":{ - "name":"ListMailboxPermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListMailboxPermissionsRequest"}, - "output":{"shape":"ListMailboxPermissionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Lists the mailbox permissions associated with a mailbox.

", - "idempotent":true - }, - "ListOrganizations":{ - "name":"ListOrganizations", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListOrganizationsRequest"}, - "output":{"shape":"ListOrganizationsResponse"}, - "errors":[ - {"shape":"InvalidParameterException"} - ], - "documentation":"

Returns summaries of the customer's non-deleted organizations.

", - "idempotent":true - }, - "ListResourceDelegates":{ - "name":"ListResourceDelegates", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourceDelegatesRequest"}, - "output":{"shape":"ListResourceDelegatesResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Lists the delegates associated with a resource. Users and groups can be resource delegates and answer requests on behalf of the resource.

", - "idempotent":true - }, - "ListResources":{ - "name":"ListResources", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListResourcesRequest"}, - "output":{"shape":"ListResourcesResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns summaries of the organization's resources.

", - "idempotent":true - }, - "ListUsers":{ - "name":"ListUsers", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ListUsersRequest"}, - "output":{"shape":"ListUsersResponse"}, - "errors":[ - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Returns summaries of the organization's users.

", - "idempotent":true - }, - "PutMailboxPermissions":{ - "name":"PutMailboxPermissions", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"PutMailboxPermissionsRequest"}, - "output":{"shape":"PutMailboxPermissionsResponse"}, - "errors":[ - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Sets permissions for a user or group. This replaces any pre-existing permissions set for the entity.

", - "idempotent":true - }, - "RegisterToWorkMail":{ - "name":"RegisterToWorkMail", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RegisterToWorkMailRequest"}, - "output":{"shape":"RegisterToWorkMailResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EmailAddressInUseException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"EntityAlreadyRegisteredException"}, - {"shape":"InvalidParameterException"}, - {"shape":"MailDomainNotFoundException"}, - {"shape":"MailDomainStateException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Registers an existing and disabled user, group, or resource/entity for Amazon WorkMail use by associating a mailbox and calendaring capabilities. It performs no change if the entity is enabled and fails if the entity is deleted. This operation results in the accumulation of costs. For more information, see Pricing. The equivalent console functionality for this operation is Enable. Users can either be created by calling the CreateUser API or they can be synchronized from your directory. For more information, see DeregisterFromWorkMail.

", - "idempotent":true - }, - "ResetPassword":{ - "name":"ResetPassword", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ResetPasswordRequest"}, - "output":{"shape":"ResetPasswordResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"InvalidPasswordException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Allows the administrator to reset the password for a user.

", - "idempotent":true - }, - "UpdatePrimaryEmailAddress":{ - "name":"UpdatePrimaryEmailAddress", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdatePrimaryEmailAddressRequest"}, - "output":{"shape":"UpdatePrimaryEmailAddressResponse"}, - "errors":[ - {"shape":"DirectoryServiceAuthenticationFailedException"}, - {"shape":"DirectoryUnavailableException"}, - {"shape":"EmailAddressInUseException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"MailDomainNotFoundException"}, - {"shape":"MailDomainStateException"}, - {"shape":"InvalidParameterException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"}, - {"shape":"UnsupportedOperationException"} - ], - "documentation":"

Updates the primary email for an entity. The current email is moved into the list of aliases (or swapped between an existing alias and the current primary email) and the email provided in the input is promoted as the primary.

", - "idempotent":true - }, - "UpdateResource":{ - "name":"UpdateResource", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateResourceRequest"}, - "output":{"shape":"UpdateResourceResponse"}, - "errors":[ - {"shape":"DirectoryUnavailableException"}, - {"shape":"EntityNotFoundException"}, - {"shape":"EntityStateException"}, - {"shape":"InvalidConfigurationException"}, - {"shape":"EmailAddressInUseException"}, - {"shape":"MailDomainNotFoundException"}, - {"shape":"MailDomainStateException"}, - {"shape":"NameAvailabilityException"}, - {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} - ], - "documentation":"

Updates data for the resource. It must be preceded by a describe call in order to have the latest information. The dataset in the request should be the one expected when performing another describe call.

", - "idempotent":true - } - }, - "shapes":{ - "Aliases":{ - "type":"list", - "member":{"shape":"EmailAddress"} - }, - "AssociateDelegateToResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId", - "EntityId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization under which the resource exists.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The resource for which members are associated.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The member (user or group) to associate to the resource.

" - } - } - }, - "AssociateDelegateToResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "AssociateMemberToGroupRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "GroupId", - "MemberId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization under which the group exists.

" - }, - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The group for which the member is associated.

" - }, - "MemberId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The member to associate to the group.

" - } - } - }, - "AssociateMemberToGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "BookingOptions":{ - "type":"structure", - "members":{ - "AutoAcceptRequests":{ - "shape":"Boolean", - "documentation":"

The resource's ability to automatically reply to requests. If disabled, delegates must be associated to the resource.

" - }, - "AutoDeclineRecurringRequests":{ - "shape":"Boolean", - "documentation":"

The resource's ability to automatically decline any recurring requests.

" - }, - "AutoDeclineConflictingRequests":{ - "shape":"Boolean", - "documentation":"

The resource's ability to automatically decline any conflicting requests.

" - } - }, - "documentation":"

At least one delegate must be associated to the resource to disable automatic replies from the resource.

" - }, - "Boolean":{"type":"boolean"}, - "CreateAliasRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "Alias" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization under which the member exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The alias is added to this Amazon WorkMail entity.

" - }, - "Alias":{ - "shape":"EmailAddress", - "documentation":"

The alias to add to the user.

" - } - } - }, - "CreateAliasResponse":{ - "type":"structure", - "members":{ - } - }, - "CreateGroupRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "Name" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization under which the group is to be created.

" - }, - "Name":{ - "shape":"GroupName", - "documentation":"

The name of the group.

" - } - } - }, - "CreateGroupResponse":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The ID of the group.

" - } - } - }, - "CreateResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "Name", - "Type" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier associated with the organization for which the resource is created.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the created resource.

" - }, - "Type":{ - "shape":"ResourceType", - "documentation":"

The type of the created resource.

" - } - } - }, - "CreateResourceResponse":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the created resource.

" - } - } - }, - "CreateUserRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "Name", - "DisplayName", - "Password" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of the organization for which the user is created.

" - }, - "Name":{ - "shape":"UserName", - "documentation":"

The name for the user to be created.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The display name for the user to be created.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The password for the user to be created.

" - } - } - }, - "CreateUserResponse":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The information regarding the newly created user.

" - } - } - }, - "Delegate":{ - "type":"structure", - "required":[ - "Id", - "Type" - ], - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The identifier for the user or group is associated as the resource's delegate.

" - }, - "Type":{ - "shape":"MemberType", - "documentation":"

The type of the delegate: user or group.

" - } - }, - "documentation":"

The name of the attribute, which is one of the values defined in the UserAttribute enumeration.

" - }, - "DeleteAliasRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "Alias" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the user exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the Amazon WorkMail entity to have the aliases removed.

" - }, - "Alias":{ - "shape":"EmailAddress", - "documentation":"

The aliases to be removed from the user's set of aliases. Duplicate entries in the list are collapsed into single entries (the list is transformed into a set).

" - } - } - }, - "DeleteAliasResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteGroupRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "GroupId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization that contains the group.

" - }, - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the group to be deleted.

" - } - } - }, - "DeleteGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteMailboxPermissionsRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "GranteeId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of the organization under which the entity (user or group) exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) for which to delete mailbox permissions.

" - }, - "GranteeId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) for which to delete granted permissions.

" - } - } - }, - "DeleteMailboxPermissionsResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier associated with the organization for which the resource is deleted.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the resource to be deleted.

" - } - } - }, - "DeleteResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "DeleteUserRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "UserId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization that contains the user.

" - }, - "UserId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the user to be deleted.

" - } - } - }, - "DeleteUserResponse":{ - "type":"structure", - "members":{ - } - }, - "DeregisterFromWorkMailRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the Amazon WorkMail entity exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the entity to be updated.

" - } - } - }, - "DeregisterFromWorkMailResponse":{ - "type":"structure", - "members":{ - } - }, - "DescribeGroupRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "GroupId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the group exists.

" - }, - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the group to be described.

" - } - } - }, - "DescribeGroupResponse":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the described group.

" - }, - "Name":{ - "shape":"GroupName", - "documentation":"

The name of the described group.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the described group.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the user: enabled (registered to Amazon WorkMail) or disabled (deregistered or never registered to Amazon WorkMail).

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time when a user was registered to Amazon WorkMail, in UNIX epoch time format.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time when a user was deregistered from Amazon WorkMail, in UNIX epoch time format.

" - } - } - }, - "DescribeOrganizationRequest":{ - "type":"structure", - "required":["OrganizationId"], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization to be described.

" - } - } - }, - "DescribeOrganizationResponse":{ - "type":"structure", - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of an organization.

" - }, - "Alias":{ - "shape":"OrganizationName", - "documentation":"

The alias for an organization.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state of an organization.

" - }, - "DirectoryId":{ - "shape":"String", - "documentation":"

The identifier for the directory associated with an Amazon WorkMail organization.

" - }, - "DirectoryType":{ - "shape":"String", - "documentation":"

The type of directory associated with the Amazon WorkMail organization.

" - }, - "DefaultMailDomain":{ - "shape":"String", - "documentation":"

The default mail domain associated with the organization.

" - }, - "CompletedDate":{ - "shape":"Timestamp", - "documentation":"

The date at which the organization became usable in the Amazon WorkMail context, in UNIX epoch time format.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

The (optional) error message indicating if unexpected behavior was encountered with regards to the organization.

" - } - } - }, - "DescribeResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier associated with the organization for which the resource is described.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the resource to be described.

" - } - } - }, - "DescribeResourceResponse":{ - "type":"structure", - "members":{ - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the described resource.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the described resource.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the described resource.

" - }, - "Type":{ - "shape":"ResourceType", - "documentation":"

The type of the described resource.

" - }, - "BookingOptions":{ - "shape":"BookingOptions", - "documentation":"

The booking options for the described resource.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the resource: enabled (registered to Amazon WorkMail) or disabled (deregistered or never registered to Amazon WorkMail).

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time when a resource was registered to Amazon WorkMail, in UNIX epoch time format.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time when a resource was registered from Amazon WorkMail, in UNIX epoch time format.

" - } - } - }, - "DescribeUserRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "UserId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the user exists.

" - }, - "UserId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the user to be described.

" - } - } - }, - "DescribeUserResponse":{ - "type":"structure", - "members":{ - "UserId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the described user.

" - }, - "Name":{ - "shape":"UserName", - "documentation":"

The name for the user.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the user.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The display name of the user.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of a user: enabled (registered to Amazon WorkMail) or disabled (deregistered or never registered to Amazon WorkMail).

" - }, - "UserRole":{ - "shape":"UserRole", - "documentation":"

In certain cases other entities are modeled as users. If interoperability is enabled, resources are imported into Amazon WorkMail as users. Because different Amazon WorkMail organizations rely on different directory types, administrators can distinguish between a user that is not registered to Amazon WorkMail (is disabled and has a user role) and the administrative users of the directory. The values are USER, RESOURCE, and SYSTEM_USER.

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time at which the user was enabled for Amazon WorkMail usage, in UNIX epoch time format.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date and time at which the user was disabled for Amazon WorkMail usage, in UNIX epoch time format.

" - } - } - }, - "DirectoryServiceAuthenticationFailedException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The Directory Service doesn't recognize the credentials supplied by the Amazon WorkMail service.

", - "exception":true - }, - "DirectoryUnavailableException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The directory that you are trying to perform operations on isn't available.

", - "exception":true - }, - "DisassociateDelegateFromResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId", - "EntityId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the resource exists.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the resource from which delegates' set members are removed.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the member (user, group) to be removed from the resource's delegates.

" - } - } - }, - "DisassociateDelegateFromResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "DisassociateMemberFromGroupRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "GroupId", - "MemberId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the group exists.

" - }, - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the group from which members are removed.

" - }, - "MemberId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the member to be removed to the group.

" - } - } - }, - "DisassociateMemberFromGroupResponse":{ - "type":"structure", - "members":{ - } - }, - "EmailAddress":{ - "type":"string", - "max":254, - "min":1, - "pattern":"[a-zA-Z0-9._%+-]{1,64}@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}" - }, - "EmailAddressInUseException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The email address that you're trying to assign is already created for a different user, group, or resource.

", - "exception":true - }, - "EntityAlreadyRegisteredException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The user, group, or resource that you're trying to register is already registered.

", - "exception":true - }, - "EntityNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The identifier supplied for the entity is valid, but it does not exist in your organization.

", - "exception":true - }, - "EntityState":{ - "type":"string", - "enum":[ - "ENABLED", - "DISABLED", - "DELETED" - ] - }, - "EntityStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You are performing an operation on an entity that isn't in the expected state, such as trying to update a deleted user.

", - "exception":true - }, - "Group":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the group.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the group.

" - }, - "Name":{ - "shape":"GroupName", - "documentation":"

The name of the group.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the group, which can be ENABLED, DISABLED, or DELETED.

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the group was enabled for Amazon WorkMail use.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the group was disabled from Amazon WorkMail use.

" - } - }, - "documentation":"

The representation of an Amazon WorkMail group.

" - }, - "GroupName":{ - "type":"string", - "max":256, - "min":1, - "pattern":"[\\u0020-\\u00FF]+" - }, - "Groups":{ - "type":"list", - "member":{"shape":"Group"} - }, - "InvalidConfigurationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The configuration for a resource isn't valid. A resource must either be able to auto-respond to requests or have at least one delegate associated that can do it on its behalf.

", - "exception":true - }, - "InvalidParameterException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

One or more of the input parameters don't match the service's restrictions.

", - "exception":true - }, - "InvalidPasswordException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The supplied password doesn't match the minimum security constraints, such as length or use of special characters.

", - "exception":true - }, - "ListAliasesRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the entity exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the entity for which to list the aliases.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListAliasesResponse":{ - "type":"structure", - "members":{ - "Aliases":{ - "shape":"Aliases", - "documentation":"

The entity's paginated aliases.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The value is \"null\" when there are no more results to return.

" - } - } - }, - "ListGroupMembersRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "GroupId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the group exists.

" - }, - "GroupId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the group to which the members are associated.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListGroupMembersResponse":{ - "type":"structure", - "members":{ - "Members":{ - "shape":"Members", - "documentation":"

The members associated to the group.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - } - } - }, - "ListGroupsRequest":{ - "type":"structure", - "required":["OrganizationId"], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the groups exist.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListGroupsResponse":{ - "type":"structure", - "members":{ - "Groups":{ - "shape":"Groups", - "documentation":"

The overview of groups for an organization.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The value is \"null\" when there are no more results to return.

" - } - } - }, - "ListMailboxPermissionsRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of the organization under which the entity (user or group) exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) for which to list mailbox permissions.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListMailboxPermissionsResponse":{ - "type":"structure", - "members":{ - "Permissions":{ - "shape":"Permissions", - "documentation":"

One page of the entity's mailbox permissions.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The value is \"null\" when there are no more results to return.

" - } - } - }, - "ListOrganizationsRequest":{ - "type":"structure", - "members":{ - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListOrganizationsResponse":{ - "type":"structure", - "members":{ - "OrganizationSummaries":{ - "shape":"OrganizationSummaries", - "documentation":"

The overview of owned organizations presented as a list of organization summaries.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The value is \"null\" when there are no more results to return.

" - } - } - }, - "ListResourceDelegatesRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization that contains the resource for which delegates are listed.

" - }, - "ResourceId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the resource whose delegates are listed.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token used to paginate through the delegates associated with a resource.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The number of maximum results in a page.

" - } - } - }, - "ListResourceDelegatesResponse":{ - "type":"structure", - "members":{ - "Delegates":{ - "shape":"ResourceDelegates", - "documentation":"

One page of the resource's delegates.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token used to paginate through the delegates associated with a resource. While results are still available, it has an associated value. When the last page is reached, the token is empty.

" - } - } - }, - "ListResourcesRequest":{ - "type":"structure", - "required":["OrganizationId"], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the resources exist.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. The first call does not contain any tokens.

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListResourcesResponse":{ - "type":"structure", - "members":{ - "Resources":{ - "shape":"Resources", - "documentation":"

One page of the organization's resource representation.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token used to paginate through all the organization's resources. While results are still available, it has an associated value. When the last page is reached, the token is empty.

" - } - } - }, - "ListUsersRequest":{ - "type":"structure", - "required":["OrganizationId"], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the users exist.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

TBD

" - }, - "MaxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of results to return in a single call.

" - } - } - }, - "ListUsersResponse":{ - "type":"structure", - "members":{ - "Users":{ - "shape":"Users", - "documentation":"

The overview of users for an organization.

" - }, - "NextToken":{ - "shape":"NextToken", - "documentation":"

The token to use to retrieve the next page of results. This value is `null` when there are no more results to return.

" - } - } - }, - "MailDomainNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

For an email or alias to be created in Amazon WorkMail, the included domain must be defined in the organization.

", - "exception":true - }, - "MailDomainStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

After a domain has been added to the organization, it must be verified. The domain is not yet verified.

", - "exception":true - }, - "MaxResults":{ - "type":"integer", - "box":true, - "max":100, - "min":1 - }, - "Member":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The identifier of the member.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The name of the member.

" - }, - "Type":{ - "shape":"MemberType", - "documentation":"

A member can be a user or group.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the member, which can be ENABLED, DISABLED, or DELETED.

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the member was enabled for Amazon WorkMail use.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the member was disabled from Amazon WorkMail use.

" - } - }, - "documentation":"

The representation of a group member (user or group).

" - }, - "MemberType":{ - "type":"string", - "enum":[ - "GROUP", - "USER" - ] - }, - "Members":{ - "type":"list", - "member":{"shape":"Member"} - }, - "NameAvailabilityException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The entity (user, group, or user) name isn't unique in Amazon WorkMail.

", - "exception":true - }, - "NextToken":{ - "type":"string", - "max":1024, - "min":1 - }, - "OrganizationId":{ - "type":"string", - "pattern":"^m-[0-9a-f]{32}$" - }, - "OrganizationName":{ - "type":"string", - "max":62, - "min":1, - "pattern":"^(?!d-)([\\da-zA-Z]+)([-]*[\\da-zA-Z])*" - }, - "OrganizationNotFoundException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

An operation received a valid organization identifier that either doesn't belong or exist in the system.

", - "exception":true - }, - "OrganizationStateException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

The organization must have a valid state (Active or Synchronizing) to perform certain operations on the organization or its entities.

", - "exception":true - }, - "OrganizationSummaries":{ - "type":"list", - "member":{"shape":"OrganizationSummary"} - }, - "OrganizationSummary":{ - "type":"structure", - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier associated with the organization.

" - }, - "Alias":{ - "shape":"OrganizationName", - "documentation":"

The alias associated with the organization.

" - }, - "ErrorMessage":{ - "shape":"String", - "documentation":"

The error message associated with the organization. It is only present if unexpected behavior has occurred with regards to the organization. It provides insight or solutions regarding unexpected behavior.

" - }, - "State":{ - "shape":"String", - "documentation":"

The state associated with the organization.

" - } - }, - "documentation":"

The brief overview associated with an organization.

" - }, - "Password":{ - "type":"string", - "max":256, - "pattern":"[\\u0020-\\u00FF]+", - "sensitive":true - }, - "Permission":{ - "type":"structure", - "required":[ - "GranteeId", - "GranteeType", - "PermissionValues" - ], - "members":{ - "GranteeId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) to which the permissions are granted.

" - }, - "GranteeType":{ - "shape":"MemberType", - "documentation":"

The type of entity (user, group) of the entity referred to in GranteeId.

" - }, - "PermissionValues":{ - "shape":"PermissionValues", - "documentation":"

The permissions granted to the grantee. SEND_AS allows the grantee to send email as the owner of the mailbox (the grantee is not mentioned on these emails). SEND_ON_BEHALF allows the grantee to send email on behalf of the owner of the mailbox (the grantee is not mentioned as the physical sender of these emails). FULL_ACCESS allows the grantee full access to the mailbox, irrespective of other folder-level permissions set on the mailbox.

" - } - }, - "documentation":"

Permission granted to an entity (user, group) to access a certain aspect of another entity's mailbox.

" - }, - "PermissionType":{ - "type":"string", - "enum":[ - "FULL_ACCESS", - "SEND_AS", - "SEND_ON_BEHALF" - ] - }, - "PermissionValues":{ - "type":"list", - "member":{"shape":"PermissionType"} - }, - "Permissions":{ - "type":"list", - "member":{"shape":"Permission"} - }, - "PutMailboxPermissionsRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "GranteeId", - "PermissionValues" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of the organization under which the entity (user or group) exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) for which to update mailbox permissions.

" - }, - "GranteeId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the entity (user or group) to which to grant the permissions.

" - }, - "PermissionValues":{ - "shape":"PermissionValues", - "documentation":"

The permissions granted to the grantee. SEND_AS allows the grantee to send email as the owner of the mailbox (the grantee is not mentioned on these emails). SEND_ON_BEHALF allows the grantee to send email on behalf of the owner of the mailbox (the grantee is not mentioned as the physical sender of these emails). FULL_ACCESS allows the grantee full access to the mailbox, irrespective of other folder-level permissions set on the mailbox.

" - } - } - }, - "PutMailboxPermissionsResponse":{ - "type":"structure", - "members":{ - } - }, - "RegisterToWorkMailRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "Email" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier for the organization under which the Amazon WorkMail entity exists.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier for the entity to be updated.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email for the entity to be updated.

" - } - } - }, - "RegisterToWorkMailResponse":{ - "type":"structure", - "members":{ - } - }, - "ReservedNameException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

This entity name is not allowed in Amazon WorkMail.

", - "exception":true - }, - "ResetPasswordRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "UserId", - "Password" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier of the organization that contains the user for which the password is reset.

" - }, - "UserId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the user for whom the password is reset.

" - }, - "Password":{ - "shape":"Password", - "documentation":"

The new password for the user.

" - } - } - }, - "ResetPasswordResponse":{ - "type":"structure", - "members":{ - } - }, - "Resource":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the resource.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the resource.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the resource.

" - }, - "Type":{ - "shape":"ResourceType", - "documentation":"

The type of the resource: equipment or room.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the resource, which can be ENABLED, DISABLED, or DELETED.

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the resource was enabled for Amazon WorkMail use.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the resource was disabled from Amazon WorkMail use.

" - } - }, - "documentation":"

The overview for a resource containing relevant data regarding it.

" - }, - "ResourceDelegates":{ - "type":"list", - "member":{"shape":"Delegate"} - }, - "ResourceId":{ - "type":"string", - "pattern":"^r-[0-9a-f]{32}$" - }, - "ResourceName":{ - "type":"string", - "max":20, - "min":1, - "pattern":"[\\w\\-.]+(@[a-zA-Z0-9.\\-]+\\.[a-zA-Z0-9]{2,})?" - }, - "ResourceType":{ - "type":"string", - "enum":[ - "ROOM", - "EQUIPMENT" - ] - }, - "Resources":{ - "type":"list", - "member":{"shape":"Resource"} - }, - "String":{ - "type":"string", - "max":256 - }, - "Timestamp":{"type":"timestamp"}, - "UnsupportedOperationException":{ - "type":"structure", - "members":{ - "Message":{"shape":"String"} - }, - "documentation":"

You can't perform a write operation against a read-only directory.

", - "exception":true - }, - "UpdatePrimaryEmailAddressRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "EntityId", - "Email" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The organization that contains the entity to update.

" - }, - "EntityId":{ - "shape":"WorkMailIdentifier", - "documentation":"

The entity to update (user, group, or resource).

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The value of the email to be updated as primary.

" - } - } - }, - "UpdatePrimaryEmailAddressResponse":{ - "type":"structure", - "members":{ - } - }, - "UpdateResourceRequest":{ - "type":"structure", - "required":[ - "OrganizationId", - "ResourceId" - ], - "members":{ - "OrganizationId":{ - "shape":"OrganizationId", - "documentation":"

The identifier associated with the organization for which the resource is updated.

" - }, - "ResourceId":{ - "shape":"ResourceId", - "documentation":"

The identifier of the resource to be updated.

" - }, - "Name":{ - "shape":"ResourceName", - "documentation":"

The name of the resource to be updated.

" - }, - "BookingOptions":{ - "shape":"BookingOptions", - "documentation":"

The resource's booking options to be updated.

" - } - } - }, - "UpdateResourceResponse":{ - "type":"structure", - "members":{ - } - }, - "User":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"WorkMailIdentifier", - "documentation":"

The identifier of the user.

" - }, - "Email":{ - "shape":"EmailAddress", - "documentation":"

The email of the user.

" - }, - "Name":{ - "shape":"UserName", - "documentation":"

The name of the user.

" - }, - "DisplayName":{ - "shape":"String", - "documentation":"

The display name of the user.

" - }, - "State":{ - "shape":"EntityState", - "documentation":"

The state of the user, which can be ENABLED, DISABLED, or DELETED.

" - }, - "UserRole":{ - "shape":"UserRole", - "documentation":"

The role of the user.

" - }, - "EnabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the user was enabled for Amazon WorkMail use.

" - }, - "DisabledDate":{ - "shape":"Timestamp", - "documentation":"

The date indicating when the user was disabled from Amazon WorkMail use.

" - } - }, - "documentation":"

The representation of an Amazon WorkMail user.

" - }, - "UserName":{ - "type":"string", - "max":64, - "min":1, - "pattern":"[\\w\\-.]+(@[a-zA-Z0-9.\\-]+\\.[a-zA-Z0-9]{2,})?" - }, - "UserRole":{ - "type":"string", - "enum":[ - "USER", - "RESOURCE", - "SYSTEM_USER" - ] - }, - "Users":{ - "type":"list", - "member":{"shape":"User"} - }, - "WorkMailIdentifier":{ - "type":"string", - "max":256, - "min":12 - } - }, - "documentation":"

Amazon WorkMail is a secure, managed business email and calendaring service with support for existing desktop and mobile email clients. You can access your email, contacts, and calendars using Microsoft Outlook, your browser, or their native iOS and Android email applications. You can integrate Amazon WorkMail with your existing corporate directory and control both the keys that encrypt your data and the location in which your data is stored.

The Amazon WorkMail API is designed for the following scenarios:

  • Listing and describing organizations

  • Managing users

  • Managing groups

  • Managing resources

All Amazon WorkMail API actions are Amazon-authenticated and certificate-signed. They not only require the use of the AWS SDK, but also allow for the exclusive use of IAM users and roles to help facilitate access, trust, and permission policies. By creating a role and allowing an IAM user to access the Amazon WorkMail site, the IAM user gains full administrative visibility into the entire Amazon WorkMail organization (or as set in the IAM policy). This includes, but is not limited to, the ability to create, update, and delete users, groups, and resources. This allows developers to perform the scenarios listed above, as well as give users the ability to grant access on a selective basis using the IAM model.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/paginators-1.json deleted file mode 100644 index efa8cbad..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/paginators-1.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "pagination": { - "DescribeWorkspaceBundles": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Bundles" - }, - "DescribeWorkspaceDirectories": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Directories" - }, - "DescribeWorkspaces": { - "limit_key": "Limit", - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Workspaces" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/service-2.json deleted file mode 100644 index 24c0d6a3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/workspaces/2015-04-08/service-2.json +++ /dev/null @@ -1,1745 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2015-04-08", - "endpointPrefix":"workspaces", - "jsonVersion":"1.1", - "protocol":"json", - "serviceFullName":"Amazon WorkSpaces", - "serviceId":"WorkSpaces", - "signatureVersion":"v4", - "targetPrefix":"WorkspacesService", - "uid":"workspaces-2015-04-08" - }, - "operations":{ - "AssociateIpGroups":{ - "name":"AssociateIpGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AssociateIpGroupsRequest"}, - "output":{"shape":"AssociateIpGroupsResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"AccessDeniedException"}, - {"shape":"OperationNotSupportedException"} - ], - "documentation":"

Associates the specified IP access control group with the specified directory.

" - }, - "AuthorizeIpRules":{ - "name":"AuthorizeIpRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"AuthorizeIpRulesRequest"}, - "output":{"shape":"AuthorizeIpRulesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Adds one or more rules to the specified IP access control group.

This action gives users permission to access their WorkSpaces from the CIDR address ranges specified in the rules.

" - }, - "CreateIpGroup":{ - "name":"CreateIpGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateIpGroupRequest"}, - "output":{"shape":"CreateIpGroupResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"ResourceAlreadyExistsException"}, - {"shape":"ResourceCreationFailedException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Creates an IP access control group.

An IP access control group provides you with the ability to control the IP addresses from which users are allowed to access their WorkSpaces. To specify the CIDR address ranges, add rules to your IP access control group and then associate the group with your directory. You can add rules when you create the group or at any time using AuthorizeIpRules.

There is a default IP access control group associated with your directory. If you don't associate an IP access control group with your directory, the default group is used. The default group includes a default rule that allows users to access their WorkSpaces from anywhere. You cannot modify the default IP access control group for your directory.

" - }, - "CreateTags":{ - "name":"CreateTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateTagsRequest"}, - "output":{"shape":"CreateTagsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceLimitExceededException"} - ], - "documentation":"

Creates the specified tags for the specified WorkSpace.

" - }, - "CreateWorkspaces":{ - "name":"CreateWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"CreateWorkspacesRequest"}, - "output":{"shape":"CreateWorkspacesResult"}, - "errors":[ - {"shape":"ResourceLimitExceededException"}, - {"shape":"InvalidParameterValuesException"} - ], - "documentation":"

Creates one or more WorkSpaces.

This operation is asynchronous and returns before the WorkSpaces are created.

" - }, - "DeleteIpGroup":{ - "name":"DeleteIpGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteIpGroupRequest"}, - "output":{"shape":"DeleteIpGroupResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceAssociatedException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Deletes the specified IP access control group.

You cannot delete an IP access control group that is associated with a directory.

" - }, - "DeleteTags":{ - "name":"DeleteTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DeleteTagsRequest"}, - "output":{"shape":"DeleteTagsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidParameterValuesException"} - ], - "documentation":"

Deletes the specified tags from the specified WorkSpace.

" - }, - "DescribeIpGroups":{ - "name":"DescribeIpGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeIpGroupsRequest"}, - "output":{"shape":"DescribeIpGroupsResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Describes one or more of your IP access control groups.

" - }, - "DescribeTags":{ - "name":"DescribeTags", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeTagsRequest"}, - "output":{"shape":"DescribeTagsResult"}, - "errors":[ - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Describes the specified tags for the specified WorkSpace.

" - }, - "DescribeWorkspaceBundles":{ - "name":"DescribeWorkspaceBundles", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkspaceBundlesRequest"}, - "output":{"shape":"DescribeWorkspaceBundlesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"} - ], - "documentation":"

Describes the available WorkSpace bundles.

You can filter the results using either bundle ID or owner, but not both.

" - }, - "DescribeWorkspaceDirectories":{ - "name":"DescribeWorkspaceDirectories", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkspaceDirectoriesRequest"}, - "output":{"shape":"DescribeWorkspaceDirectoriesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"} - ], - "documentation":"

Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.

" - }, - "DescribeWorkspaces":{ - "name":"DescribeWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkspacesRequest"}, - "output":{"shape":"DescribeWorkspacesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceUnavailableException"} - ], - "documentation":"

Describes the specified WorkSpaces.

You can filter the results using bundle ID, directory ID, or owner, but you can specify only one filter at a time.

" - }, - "DescribeWorkspacesConnectionStatus":{ - "name":"DescribeWorkspacesConnectionStatus", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DescribeWorkspacesConnectionStatusRequest"}, - "output":{"shape":"DescribeWorkspacesConnectionStatusResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"} - ], - "documentation":"

Describes the connection status of the specified WorkSpaces.

" - }, - "DisassociateIpGroups":{ - "name":"DisassociateIpGroups", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"DisassociateIpGroupsRequest"}, - "output":{"shape":"DisassociateIpGroupsResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Disassociates the specified IP access control group from the specified directory.

" - }, - "ModifyWorkspaceProperties":{ - "name":"ModifyWorkspaceProperties", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyWorkspacePropertiesRequest"}, - "output":{"shape":"ModifyWorkspacePropertiesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"OperationInProgressException"}, - {"shape":"UnsupportedWorkspaceConfigurationException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"AccessDeniedException"}, - {"shape":"ResourceUnavailableException"} - ], - "documentation":"

Modifies the specified WorkSpace properties.

" - }, - "ModifyWorkspaceState":{ - "name":"ModifyWorkspaceState", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"ModifyWorkspaceStateRequest"}, - "output":{"shape":"ModifyWorkspaceStateResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"ResourceNotFoundException"} - ], - "documentation":"

Sets the state of the specified WorkSpace.

To maintain a WorkSpace without being interrupted, set the WorkSpace state to ADMIN_MAINTENANCE. WorkSpaces in this state do not respond to requests to reboot, stop, start, or rebuild. An AutoStop WorkSpace in this state is not stopped. Users can log into a WorkSpace in the ADMIN_MAINTENANCE state.

" - }, - "RebootWorkspaces":{ - "name":"RebootWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebootWorkspacesRequest"}, - "output":{"shape":"RebootWorkspacesResult"}, - "documentation":"

Reboots the specified WorkSpaces.

You cannot reboot a WorkSpace unless its state is AVAILABLE or UNHEALTHY.

This operation is asynchronous and returns before the WorkSpaces have rebooted.

" - }, - "RebuildWorkspaces":{ - "name":"RebuildWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RebuildWorkspacesRequest"}, - "output":{"shape":"RebuildWorkspacesResult"}, - "documentation":"

Rebuilds the specified WorkSpace.

You cannot rebuild a WorkSpace unless its state is AVAILABLE, ERROR, or UNHEALTHY.

Rebuilding a WorkSpace is a potentially destructive action that can result in the loss of data. For more information, see Rebuild a WorkSpace.

This operation is asynchronous and returns before the WorkSpaces have been completely rebuilt.

" - }, - "RevokeIpRules":{ - "name":"RevokeIpRules", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"RevokeIpRulesRequest"}, - "output":{"shape":"RevokeIpRulesResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Removes one or more rules from the specified IP access control group.

" - }, - "StartWorkspaces":{ - "name":"StartWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StartWorkspacesRequest"}, - "output":{"shape":"StartWorkspacesResult"}, - "documentation":"

Starts the specified WorkSpaces.

You cannot start a WorkSpace unless it has a running mode of AutoStop and a state of STOPPED.

" - }, - "StopWorkspaces":{ - "name":"StopWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"StopWorkspacesRequest"}, - "output":{"shape":"StopWorkspacesResult"}, - "documentation":"

Stops the specified WorkSpaces.

You cannot stop a WorkSpace unless it has a running mode of AutoStop and a state of AVAILABLE, IMPAIRED, UNHEALTHY, or ERROR.

" - }, - "TerminateWorkspaces":{ - "name":"TerminateWorkspaces", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"TerminateWorkspacesRequest"}, - "output":{"shape":"TerminateWorkspacesResult"}, - "documentation":"

Terminates the specified WorkSpaces.

Terminating a WorkSpace is a permanent action and cannot be undone. The user's data is destroyed. If you need to archive any user data, contact Amazon Web Services before terminating the WorkSpace.

You can terminate a WorkSpace that is in any state except SUSPENDED.

This operation is asynchronous and returns before the WorkSpaces have been completely terminated.

" - }, - "UpdateRulesOfIpGroup":{ - "name":"UpdateRulesOfIpGroup", - "http":{ - "method":"POST", - "requestUri":"/" - }, - "input":{"shape":"UpdateRulesOfIpGroupRequest"}, - "output":{"shape":"UpdateRulesOfIpGroupResult"}, - "errors":[ - {"shape":"InvalidParameterValuesException"}, - {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceLimitExceededException"}, - {"shape":"InvalidResourceStateException"}, - {"shape":"AccessDeniedException"} - ], - "documentation":"

Replaces the current rules of the specified IP access control group with the specified rules.

" - } - }, - "shapes":{ - "ARN":{ - "type":"string", - "pattern":"^arn:aws:[A-Za-z0-9][A-za-z0-9_/.-]{0,62}:[A-za-z0-9_/.-]{0,63}:[A-za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-za-z0-9_/.-]{0,127}$" - }, - "AccessDeniedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The user is not authorized to access a resource.

", - "exception":true - }, - "Alias":{"type":"string"}, - "AssociateIpGroupsRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "GroupIds" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The ID of the directory.

" - }, - "GroupIds":{ - "shape":"IpGroupIdList", - "documentation":"

The IDs of one or more IP access control groups.

" - } - } - }, - "AssociateIpGroupsResult":{ - "type":"structure", - "members":{ - } - }, - "AuthorizeIpRulesRequest":{ - "type":"structure", - "required":[ - "GroupId", - "UserRules" - ], - "members":{ - "GroupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the group.

" - }, - "UserRules":{ - "shape":"IpRuleList", - "documentation":"

The rules to add to the group.

" - } - } - }, - "AuthorizeIpRulesResult":{ - "type":"structure", - "members":{ - } - }, - "BooleanObject":{"type":"boolean"}, - "BundleId":{ - "type":"string", - "pattern":"^wsb-[0-9a-z]{8,63}$" - }, - "BundleIdList":{ - "type":"list", - "member":{"shape":"BundleId"}, - "max":25, - "min":1 - }, - "BundleList":{ - "type":"list", - "member":{"shape":"WorkspaceBundle"} - }, - "BundleOwner":{"type":"string"}, - "Compute":{ - "type":"string", - "enum":[ - "VALUE", - "STANDARD", - "PERFORMANCE", - "POWER", - "GRAPHICS" - ] - }, - "ComputeType":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"Compute", - "documentation":"

The compute type.

" - } - }, - "documentation":"

Information about the compute type.

" - }, - "ComputerName":{"type":"string"}, - "ConnectionState":{ - "type":"string", - "enum":[ - "CONNECTED", - "DISCONNECTED", - "UNKNOWN" - ] - }, - "CreateIpGroupRequest":{ - "type":"structure", - "required":["GroupName"], - "members":{ - "GroupName":{ - "shape":"IpGroupName", - "documentation":"

The name of the group.

" - }, - "GroupDesc":{ - "shape":"IpGroupDesc", - "documentation":"

The description of the group.

" - }, - "UserRules":{ - "shape":"IpRuleList", - "documentation":"

The rules to add to the group.

" - } - } - }, - "CreateIpGroupResult":{ - "type":"structure", - "members":{ - "GroupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the group.

" - } - } - }, - "CreateTagsRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "Tags" - ], - "members":{ - "ResourceId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the WorkSpace. To find this ID, use DescribeWorkspaces.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags. Each WorkSpace can have a maximum of 50 tags.

" - } - } - }, - "CreateTagsResult":{ - "type":"structure", - "members":{ - } - }, - "CreateWorkspacesRequest":{ - "type":"structure", - "required":["Workspaces"], - "members":{ - "Workspaces":{ - "shape":"WorkspaceRequestList", - "documentation":"

The WorkSpaces to create. You can specify up to 25 WorkSpaces.

" - } - } - }, - "CreateWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedCreateWorkspaceRequests", - "documentation":"

Information about the WorkSpaces that could not be created.

" - }, - "PendingRequests":{ - "shape":"WorkspaceList", - "documentation":"

Information about the WorkSpaces that were created.

Because this operation is asynchronous, the identifier returned is not immediately available for use with other operations. For example, if you call DescribeWorkspaces before the WorkSpace is created, the information returned can be incomplete.

" - } - } - }, - "DefaultOu":{"type":"string"}, - "DefaultWorkspaceCreationProperties":{ - "type":"structure", - "members":{ - "EnableWorkDocs":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the directory is enabled for Amazon WorkDocs.

" - }, - "EnableInternetAccess":{ - "shape":"BooleanObject", - "documentation":"

The public IP address to attach to all WorkSpaces that are created or rebuilt.

" - }, - "DefaultOu":{ - "shape":"DefaultOu", - "documentation":"

The organizational unit (OU) in the directory for the WorkSpace machine accounts.

" - }, - "CustomSecurityGroupId":{ - "shape":"SecurityGroupId", - "documentation":"

The identifier of any security groups to apply to WorkSpaces when they are created.

" - }, - "UserEnabledAsLocalAdministrator":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the WorkSpace user is an administrator on the WorkSpace.

" - } - }, - "documentation":"

Information about defaults used to create a WorkSpace.

" - }, - "DeleteIpGroupRequest":{ - "type":"structure", - "required":["GroupId"], - "members":{ - "GroupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the IP access control group.

" - } - } - }, - "DeleteIpGroupResult":{ - "type":"structure", - "members":{ - } - }, - "DeleteTagsRequest":{ - "type":"structure", - "required":[ - "ResourceId", - "TagKeys" - ], - "members":{ - "ResourceId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the WorkSpace. To find this ID, use DescribeWorkspaces.

" - }, - "TagKeys":{ - "shape":"TagKeyList", - "documentation":"

The tag keys.

" - } - } - }, - "DeleteTagsResult":{ - "type":"structure", - "members":{ - } - }, - "DescribeIpGroupsRequest":{ - "type":"structure", - "members":{ - "GroupIds":{ - "shape":"IpGroupIdList", - "documentation":"

The IDs of one or more IP access control groups.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token for the next set of results. (You received this token from a previous call.)

" - }, - "MaxResults":{ - "shape":"Limit", - "documentation":"

The maximum number of items to return.

" - } - } - }, - "DescribeIpGroupsResult":{ - "type":"structure", - "members":{ - "Result":{ - "shape":"WorkspacesIpGroupsList", - "documentation":"

Information about the IP access control groups.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token to use to retrieve the next set of results, or null if there are no more results available. This token is valid for one day and must be used within that time frame.

" - } - } - }, - "DescribeTagsRequest":{ - "type":"structure", - "required":["ResourceId"], - "members":{ - "ResourceId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the WorkSpace. To find this ID, use DescribeWorkspaces.

" - } - } - }, - "DescribeTagsResult":{ - "type":"structure", - "members":{ - "TagList":{ - "shape":"TagList", - "documentation":"

The tags.

" - } - } - }, - "DescribeWorkspaceBundlesRequest":{ - "type":"structure", - "members":{ - "BundleIds":{ - "shape":"BundleIdList", - "documentation":"

The IDs of the bundles. This parameter cannot be combined with any other filter.

" - }, - "Owner":{ - "shape":"BundleOwner", - "documentation":"

The owner of the bundles. This parameter cannot be combined with any other filter.

Specify AMAZON to describe the bundles provided by AWS or null to describe the bundles that belong to your account.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token for the next set of results. (You received this token from a previous call.)

" - } - } - }, - "DescribeWorkspaceBundlesResult":{ - "type":"structure", - "members":{ - "Bundles":{ - "shape":"BundleList", - "documentation":"

Information about the bundles.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token to use to retrieve the next set of results, or null if there are no more results available. This token is valid for one day and must be used within that time frame.

" - } - } - }, - "DescribeWorkspaceDirectoriesRequest":{ - "type":"structure", - "members":{ - "DirectoryIds":{ - "shape":"DirectoryIdList", - "documentation":"

The identifiers of the directories. If the value is null, all directories are retrieved.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token for the next set of results. (You received this token from a previous call.)

" - } - } - }, - "DescribeWorkspaceDirectoriesResult":{ - "type":"structure", - "members":{ - "Directories":{ - "shape":"DirectoryList", - "documentation":"

Information about the directories.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token to use to retrieve the next set of results, or null if there are no more results available. This token is valid for one day and must be used within that time frame.

" - } - } - }, - "DescribeWorkspacesConnectionStatusRequest":{ - "type":"structure", - "members":{ - "WorkspaceIds":{ - "shape":"WorkspaceIdList", - "documentation":"

The identifiers of the WorkSpaces. You can specify up to 25 WorkSpaces.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token for the next set of results. (You received this token from a previous call.)

" - } - } - }, - "DescribeWorkspacesConnectionStatusResult":{ - "type":"structure", - "members":{ - "WorkspacesConnectionStatus":{ - "shape":"WorkspaceConnectionStatusList", - "documentation":"

Information about the connection status of the WorkSpace.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token to use to retrieve the next set of results, or null if there are no more results available.

" - } - } - }, - "DescribeWorkspacesRequest":{ - "type":"structure", - "members":{ - "WorkspaceIds":{ - "shape":"WorkspaceIdList", - "documentation":"

The IDs of the WorkSpaces. This parameter cannot be combined with any other filter.

Because the CreateWorkspaces operation is asynchronous, the identifier it returns is not immediately available. If you immediately call DescribeWorkspaces with this identifier, no information is returned.

" - }, - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The ID of the directory. In addition, you can optionally specify a specific directory user (see UserName). This parameter cannot be combined with any other filter.

" - }, - "UserName":{ - "shape":"UserName", - "documentation":"

The name of the directory user. You must specify this parameter with DirectoryId.

" - }, - "BundleId":{ - "shape":"BundleId", - "documentation":"

The ID of the bundle. All WorkSpaces that are created from this bundle are retrieved. This parameter cannot be combined with any other filter.

" - }, - "Limit":{ - "shape":"Limit", - "documentation":"

The maximum number of items to return.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token for the next set of results. (You received this token from a previous call.)

" - } - } - }, - "DescribeWorkspacesResult":{ - "type":"structure", - "members":{ - "Workspaces":{ - "shape":"WorkspaceList", - "documentation":"

Information about the WorkSpaces.

Because CreateWorkspaces is an asynchronous operation, some of the returned information could be incomplete.

" - }, - "NextToken":{ - "shape":"PaginationToken", - "documentation":"

The token to use to retrieve the next set of results, or null if there are no more results available. This token is valid for one day and must be used within that time frame.

" - } - } - }, - "Description":{"type":"string"}, - "DirectoryId":{ - "type":"string", - "pattern":"^d-[0-9a-f]{8,63}$" - }, - "DirectoryIdList":{ - "type":"list", - "member":{"shape":"DirectoryId"}, - "max":25, - "min":1 - }, - "DirectoryList":{ - "type":"list", - "member":{"shape":"WorkspaceDirectory"} - }, - "DirectoryName":{"type":"string"}, - "DisassociateIpGroupsRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "GroupIds" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The ID of the directory.

" - }, - "GroupIds":{ - "shape":"IpGroupIdList", - "documentation":"

The IDs of one or more IP access control groups.

" - } - } - }, - "DisassociateIpGroupsResult":{ - "type":"structure", - "members":{ - } - }, - "DnsIpAddresses":{ - "type":"list", - "member":{"shape":"IpAddress"} - }, - "ErrorType":{"type":"string"}, - "ExceptionMessage":{"type":"string"}, - "FailedCreateWorkspaceRequest":{ - "type":"structure", - "members":{ - "WorkspaceRequest":{ - "shape":"WorkspaceRequest", - "documentation":"

Information about the WorkSpace.

" - }, - "ErrorCode":{ - "shape":"ErrorType", - "documentation":"

The error code.

" - }, - "ErrorMessage":{ - "shape":"Description", - "documentation":"

The textual error message.

" - } - }, - "documentation":"

Information about a WorkSpace that could not be created.

" - }, - "FailedCreateWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedCreateWorkspaceRequest"} - }, - "FailedRebootWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedWorkspaceChangeRequest"} - }, - "FailedRebuildWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedWorkspaceChangeRequest"} - }, - "FailedStartWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedWorkspaceChangeRequest"} - }, - "FailedStopWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedWorkspaceChangeRequest"} - }, - "FailedTerminateWorkspaceRequests":{ - "type":"list", - "member":{"shape":"FailedWorkspaceChangeRequest"} - }, - "FailedWorkspaceChangeRequest":{ - "type":"structure", - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The identifier of the WorkSpace.

" - }, - "ErrorCode":{ - "shape":"ErrorType", - "documentation":"

The error code.

" - }, - "ErrorMessage":{ - "shape":"Description", - "documentation":"

The textual error message.

" - } - }, - "documentation":"

Information about a WorkSpace that could not be rebooted (RebootWorkspaces), rebuilt (RebuildWorkspaces), terminated (TerminateWorkspaces), started (StartWorkspaces), or stopped (StopWorkspaces).

" - }, - "InvalidParameterValuesException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The exception error message.

" - } - }, - "documentation":"

One or more parameter values are not valid.

", - "exception":true - }, - "InvalidResourceStateException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The state of the resource is not valid for this operation.

", - "exception":true - }, - "IpAddress":{"type":"string"}, - "IpGroupDesc":{"type":"string"}, - "IpGroupId":{ - "type":"string", - "pattern":"wsipg-[0-9a-z]{8,63}$" - }, - "IpGroupIdList":{ - "type":"list", - "member":{"shape":"IpGroupId"} - }, - "IpGroupName":{"type":"string"}, - "IpRevokedRuleList":{ - "type":"list", - "member":{"shape":"IpRule"} - }, - "IpRule":{"type":"string"}, - "IpRuleDesc":{"type":"string"}, - "IpRuleItem":{ - "type":"structure", - "members":{ - "ipRule":{ - "shape":"IpRule", - "documentation":"

The IP address range, in CIDR notation.

" - }, - "ruleDesc":{ - "shape":"IpRuleDesc", - "documentation":"

The description.

" - } - }, - "documentation":"

Information about a rule for an IP access control group.

" - }, - "IpRuleList":{ - "type":"list", - "member":{"shape":"IpRuleItem"} - }, - "Limit":{ - "type":"integer", - "max":25, - "min":1 - }, - "ModificationResourceEnum":{ - "type":"string", - "enum":[ - "ROOT_VOLUME", - "USER_VOLUME", - "COMPUTE_TYPE" - ] - }, - "ModificationState":{ - "type":"structure", - "members":{ - "Resource":{ - "shape":"ModificationResourceEnum", - "documentation":"

The resource.

" - }, - "State":{ - "shape":"ModificationStateEnum", - "documentation":"

The modification state.

" - } - }, - "documentation":"

Information about a WorkSpace modification.

" - }, - "ModificationStateEnum":{ - "type":"string", - "enum":[ - "UPDATE_INITIATED", - "UPDATE_IN_PROGRESS" - ] - }, - "ModificationStateList":{ - "type":"list", - "member":{"shape":"ModificationState"} - }, - "ModifyWorkspacePropertiesRequest":{ - "type":"structure", - "required":[ - "WorkspaceId", - "WorkspaceProperties" - ], - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - }, - "WorkspaceProperties":{ - "shape":"WorkspaceProperties", - "documentation":"

The properties of the WorkSpace.

" - } - } - }, - "ModifyWorkspacePropertiesResult":{ - "type":"structure", - "members":{ - } - }, - "ModifyWorkspaceStateRequest":{ - "type":"structure", - "required":[ - "WorkspaceId", - "WorkspaceState" - ], - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - }, - "WorkspaceState":{ - "shape":"TargetWorkspaceState", - "documentation":"

The WorkSpace state.

" - } - } - }, - "ModifyWorkspaceStateResult":{ - "type":"structure", - "members":{ - } - }, - "NonEmptyString":{ - "type":"string", - "min":1 - }, - "OperationInProgressException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The properties of this WorkSpace are currently being modified. Try again in a moment.

", - "exception":true - }, - "OperationNotSupportedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

This operation is not supported.

", - "exception":true - }, - "PaginationToken":{ - "type":"string", - "max":63, - "min":1 - }, - "RebootRequest":{ - "type":"structure", - "required":["WorkspaceId"], - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - } - }, - "documentation":"

Information used to reboot a WorkSpace.

" - }, - "RebootWorkspaceRequests":{ - "type":"list", - "member":{"shape":"RebootRequest"}, - "max":25, - "min":1 - }, - "RebootWorkspacesRequest":{ - "type":"structure", - "required":["RebootWorkspaceRequests"], - "members":{ - "RebootWorkspaceRequests":{ - "shape":"RebootWorkspaceRequests", - "documentation":"

The WorkSpaces to reboot. You can specify up to 25 WorkSpaces.

" - } - } - }, - "RebootWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedRebootWorkspaceRequests", - "documentation":"

Information about the WorkSpaces that could not be rebooted.

" - } - } - }, - "RebuildRequest":{ - "type":"structure", - "required":["WorkspaceId"], - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - } - }, - "documentation":"

Information used to rebuild a WorkSpace.

" - }, - "RebuildWorkspaceRequests":{ - "type":"list", - "member":{"shape":"RebuildRequest"}, - "max":1, - "min":1 - }, - "RebuildWorkspacesRequest":{ - "type":"structure", - "required":["RebuildWorkspaceRequests"], - "members":{ - "RebuildWorkspaceRequests":{ - "shape":"RebuildWorkspaceRequests", - "documentation":"

The WorkSpace to rebuild. You can specify a single WorkSpace.

" - } - } - }, - "RebuildWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedRebuildWorkspaceRequests", - "documentation":"

Information about the WorkSpace if it could not be rebuilt.

" - } - } - }, - "RegistrationCode":{ - "type":"string", - "max":20, - "min":1 - }, - "ResourceAlreadyExistsException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The specified resource already exists.

", - "exception":true - }, - "ResourceAssociatedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The resource is associated with a directory.

", - "exception":true - }, - "ResourceCreationFailedException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The resource could not be created.

", - "exception":true - }, - "ResourceLimitExceededException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The exception error message.

" - } - }, - "documentation":"

Your resource limits have been exceeded.

", - "exception":true - }, - "ResourceNotFoundException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The resource could not be found.

" - }, - "ResourceId":{ - "shape":"NonEmptyString", - "documentation":"

The ID of the resource that could not be found.

" - } - }, - "documentation":"

The resource could not be found.

", - "exception":true - }, - "ResourceUnavailableException":{ - "type":"structure", - "members":{ - "message":{ - "shape":"ExceptionMessage", - "documentation":"

The exception error message.

" - }, - "ResourceId":{ - "shape":"NonEmptyString", - "documentation":"

The identifier of the resource that is not available.

" - } - }, - "documentation":"

The specified resource is not available.

", - "exception":true - }, - "RevokeIpRulesRequest":{ - "type":"structure", - "required":[ - "GroupId", - "UserRules" - ], - "members":{ - "GroupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the group.

" - }, - "UserRules":{ - "shape":"IpRevokedRuleList", - "documentation":"

The rules to remove from the group.

" - } - } - }, - "RevokeIpRulesResult":{ - "type":"structure", - "members":{ - } - }, - "RootStorage":{ - "type":"structure", - "members":{ - "Capacity":{ - "shape":"NonEmptyString", - "documentation":"

The size of the root volume.

" - } - }, - "documentation":"

Information about the root volume for a WorkSpace bundle.

" - }, - "RootVolumeSizeGib":{"type":"integer"}, - "RunningMode":{ - "type":"string", - "enum":[ - "AUTO_STOP", - "ALWAYS_ON" - ] - }, - "RunningModeAutoStopTimeoutInMinutes":{"type":"integer"}, - "SecurityGroupId":{ - "type":"string", - "pattern":"^(sg-[0-9a-f]{8})$" - }, - "StartRequest":{ - "type":"structure", - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - } - }, - "documentation":"

Information used to start a WorkSpace.

" - }, - "StartWorkspaceRequests":{ - "type":"list", - "member":{"shape":"StartRequest"}, - "max":25, - "min":1 - }, - "StartWorkspacesRequest":{ - "type":"structure", - "required":["StartWorkspaceRequests"], - "members":{ - "StartWorkspaceRequests":{ - "shape":"StartWorkspaceRequests", - "documentation":"

The WorkSpaces to start. You can specify up to 25 WorkSpaces.

" - } - } - }, - "StartWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedStartWorkspaceRequests", - "documentation":"

Information about the WorkSpaces that could not be started.

" - } - } - }, - "StopRequest":{ - "type":"structure", - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - } - }, - "documentation":"

Information used to stop a WorkSpace.

" - }, - "StopWorkspaceRequests":{ - "type":"list", - "member":{"shape":"StopRequest"}, - "max":25, - "min":1 - }, - "StopWorkspacesRequest":{ - "type":"structure", - "required":["StopWorkspaceRequests"], - "members":{ - "StopWorkspaceRequests":{ - "shape":"StopWorkspaceRequests", - "documentation":"

The WorkSpaces to stop. You can specify up to 25 WorkSpaces.

" - } - } - }, - "StopWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedStopWorkspaceRequests", - "documentation":"

Information about the WorkSpaces that could not be stopped.

" - } - } - }, - "SubnetId":{ - "type":"string", - "pattern":"^(subnet-[0-9a-f]{8})$" - }, - "SubnetIds":{ - "type":"list", - "member":{"shape":"SubnetId"} - }, - "Tag":{ - "type":"structure", - "required":["Key"], - "members":{ - "Key":{ - "shape":"TagKey", - "documentation":"

The key of the tag.

" - }, - "Value":{ - "shape":"TagValue", - "documentation":"

The value of the tag.

" - } - }, - "documentation":"

Information about a tag.

" - }, - "TagKey":{ - "type":"string", - "max":127, - "min":1 - }, - "TagKeyList":{ - "type":"list", - "member":{"shape":"NonEmptyString"} - }, - "TagList":{ - "type":"list", - "member":{"shape":"Tag"} - }, - "TagValue":{ - "type":"string", - "max":255 - }, - "TargetWorkspaceState":{ - "type":"string", - "enum":[ - "AVAILABLE", - "ADMIN_MAINTENANCE" - ] - }, - "TerminateRequest":{ - "type":"structure", - "required":["WorkspaceId"], - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - } - }, - "documentation":"

Information used to terminate a WorkSpace.

" - }, - "TerminateWorkspaceRequests":{ - "type":"list", - "member":{"shape":"TerminateRequest"}, - "max":25, - "min":1 - }, - "TerminateWorkspacesRequest":{ - "type":"structure", - "required":["TerminateWorkspaceRequests"], - "members":{ - "TerminateWorkspaceRequests":{ - "shape":"TerminateWorkspaceRequests", - "documentation":"

The WorkSpaces to terminate. You can specify up to 25 WorkSpaces.

" - } - } - }, - "TerminateWorkspacesResult":{ - "type":"structure", - "members":{ - "FailedRequests":{ - "shape":"FailedTerminateWorkspaceRequests", - "documentation":"

Information about the WorkSpaces that could not be terminated.

" - } - } - }, - "Timestamp":{"type":"timestamp"}, - "UnsupportedWorkspaceConfigurationException":{ - "type":"structure", - "members":{ - "message":{"shape":"ExceptionMessage"} - }, - "documentation":"

The configuration of this WorkSpace is not supported for this operation. For more information, see the Amazon WorkSpaces Administration Guide.

", - "exception":true - }, - "UpdateRulesOfIpGroupRequest":{ - "type":"structure", - "required":[ - "GroupId", - "UserRules" - ], - "members":{ - "GroupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the group.

" - }, - "UserRules":{ - "shape":"IpRuleList", - "documentation":"

One or more rules.

" - } - } - }, - "UpdateRulesOfIpGroupResult":{ - "type":"structure", - "members":{ - } - }, - "UserName":{ - "type":"string", - "max":63, - "min":1 - }, - "UserStorage":{ - "type":"structure", - "members":{ - "Capacity":{ - "shape":"NonEmptyString", - "documentation":"

The size of the user storage.

" - } - }, - "documentation":"

Information about the user storage for a WorkSpace bundle.

" - }, - "UserVolumeSizeGib":{"type":"integer"}, - "VolumeEncryptionKey":{"type":"string"}, - "Workspace":{ - "type":"structure", - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The identifier of the WorkSpace.

" - }, - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the AWS Directory Service directory for the WorkSpace.

" - }, - "UserName":{ - "shape":"UserName", - "documentation":"

The user for the WorkSpace.

" - }, - "IpAddress":{ - "shape":"IpAddress", - "documentation":"

The IP address of the WorkSpace.

" - }, - "State":{ - "shape":"WorkspaceState", - "documentation":"

The operational state of the WorkSpace.

" - }, - "BundleId":{ - "shape":"BundleId", - "documentation":"

The identifier of the bundle used to create the WorkSpace.

" - }, - "SubnetId":{ - "shape":"SubnetId", - "documentation":"

The identifier of the subnet for the WorkSpace.

" - }, - "ErrorMessage":{ - "shape":"Description", - "documentation":"

If the WorkSpace could not be created, contains a textual error message that describes the failure.

" - }, - "ErrorCode":{ - "shape":"WorkspaceErrorCode", - "documentation":"

If the WorkSpace could not be created, contains the error code.

" - }, - "ComputerName":{ - "shape":"ComputerName", - "documentation":"

The name of the WorkSpace, as seen by the operating system.

" - }, - "VolumeEncryptionKey":{ - "shape":"VolumeEncryptionKey", - "documentation":"

The KMS key used to encrypt data stored on your WorkSpace.

" - }, - "UserVolumeEncryptionEnabled":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the data stored on the user volume is encrypted.

" - }, - "RootVolumeEncryptionEnabled":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the data stored on the root volume is encrypted.

" - }, - "WorkspaceProperties":{ - "shape":"WorkspaceProperties", - "documentation":"

The properties of the WorkSpace.

" - }, - "ModificationStates":{ - "shape":"ModificationStateList", - "documentation":"

The modification states of the WorkSpace.

" - } - }, - "documentation":"

Information about a WorkSpace.

" - }, - "WorkspaceBundle":{ - "type":"structure", - "members":{ - "BundleId":{ - "shape":"BundleId", - "documentation":"

The bundle identifier.

" - }, - "Name":{ - "shape":"NonEmptyString", - "documentation":"

The name of the bundle.

" - }, - "Owner":{ - "shape":"BundleOwner", - "documentation":"

The owner of the bundle. This is the account identifier of the owner, or AMAZON if the bundle is provided by AWS.

" - }, - "Description":{ - "shape":"Description", - "documentation":"

A description.

" - }, - "RootStorage":{ - "shape":"RootStorage", - "documentation":"

The size of the root volume.

" - }, - "UserStorage":{ - "shape":"UserStorage", - "documentation":"

The size of the user storage.

" - }, - "ComputeType":{ - "shape":"ComputeType", - "documentation":"

The compute type. For more information, see Amazon WorkSpaces Bundles.

" - } - }, - "documentation":"

Information about a WorkSpace bundle.

" - }, - "WorkspaceConnectionStatus":{ - "type":"structure", - "members":{ - "WorkspaceId":{ - "shape":"WorkspaceId", - "documentation":"

The ID of the WorkSpace.

" - }, - "ConnectionState":{ - "shape":"ConnectionState", - "documentation":"

The connection state of the WorkSpace. The connection state is unknown if the WorkSpace is stopped.

" - }, - "ConnectionStateCheckTimestamp":{ - "shape":"Timestamp", - "documentation":"

The timestamp of the connection state check.

" - }, - "LastKnownUserConnectionTimestamp":{ - "shape":"Timestamp", - "documentation":"

The timestamp of the last known user connection.

" - } - }, - "documentation":"

Describes the connection status of a WorkSpace.

" - }, - "WorkspaceConnectionStatusList":{ - "type":"list", - "member":{"shape":"WorkspaceConnectionStatus"} - }, - "WorkspaceDirectory":{ - "type":"structure", - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The directory identifier.

" - }, - "Alias":{ - "shape":"Alias", - "documentation":"

The directory alias.

" - }, - "DirectoryName":{ - "shape":"DirectoryName", - "documentation":"

The name of the directory.

" - }, - "RegistrationCode":{ - "shape":"RegistrationCode", - "documentation":"

The registration code for the directory. This is the code that users enter in their Amazon WorkSpaces client application to connect to the directory.

" - }, - "SubnetIds":{ - "shape":"SubnetIds", - "documentation":"

The identifiers of the subnets used with the directory.

" - }, - "DnsIpAddresses":{ - "shape":"DnsIpAddresses", - "documentation":"

The IP addresses of the DNS servers for the directory.

" - }, - "CustomerUserName":{ - "shape":"UserName", - "documentation":"

The user name for the service account.

" - }, - "IamRoleId":{ - "shape":"ARN", - "documentation":"

The identifier of the IAM role. This is the role that allows Amazon WorkSpaces to make calls to other services, such as Amazon EC2, on your behalf.

" - }, - "DirectoryType":{ - "shape":"WorkspaceDirectoryType", - "documentation":"

The directory type.

" - }, - "WorkspaceSecurityGroupId":{ - "shape":"SecurityGroupId", - "documentation":"

The identifier of the security group that is assigned to new WorkSpaces.

" - }, - "State":{ - "shape":"WorkspaceDirectoryState", - "documentation":"

The state of the directory's registration with Amazon WorkSpaces

" - }, - "WorkspaceCreationProperties":{ - "shape":"DefaultWorkspaceCreationProperties", - "documentation":"

The default creation properties for all WorkSpaces in the directory.

" - }, - "ipGroupIds":{ - "shape":"IpGroupIdList", - "documentation":"

The identifiers of the IP access control groups associated with the directory.

" - } - }, - "documentation":"

Information about an AWS Directory Service directory for use with Amazon WorkSpaces.

" - }, - "WorkspaceDirectoryState":{ - "type":"string", - "enum":[ - "REGISTERING", - "REGISTERED", - "DEREGISTERING", - "DEREGISTERED", - "ERROR" - ] - }, - "WorkspaceDirectoryType":{ - "type":"string", - "enum":[ - "SIMPLE_AD", - "AD_CONNECTOR" - ] - }, - "WorkspaceErrorCode":{"type":"string"}, - "WorkspaceId":{ - "type":"string", - "pattern":"^ws-[0-9a-z]{8,63}$" - }, - "WorkspaceIdList":{ - "type":"list", - "member":{"shape":"WorkspaceId"}, - "max":25, - "min":1 - }, - "WorkspaceList":{ - "type":"list", - "member":{"shape":"Workspace"} - }, - "WorkspaceProperties":{ - "type":"structure", - "members":{ - "RunningMode":{ - "shape":"RunningMode", - "documentation":"

The running mode. For more information, see Manage the WorkSpace Running Mode.

" - }, - "RunningModeAutoStopTimeoutInMinutes":{ - "shape":"RunningModeAutoStopTimeoutInMinutes", - "documentation":"

The time after a user logs off when WorkSpaces are automatically stopped. Configured in 60 minute intervals.

" - }, - "RootVolumeSizeGib":{ - "shape":"RootVolumeSizeGib", - "documentation":"

The size of the root volume.

" - }, - "UserVolumeSizeGib":{ - "shape":"UserVolumeSizeGib", - "documentation":"

The size of the user storage.

" - }, - "ComputeTypeName":{ - "shape":"Compute", - "documentation":"

The compute type. For more information, see Amazon WorkSpaces Bundles.

" - } - }, - "documentation":"

Information about a WorkSpace.

" - }, - "WorkspaceRequest":{ - "type":"structure", - "required":[ - "DirectoryId", - "UserName", - "BundleId" - ], - "members":{ - "DirectoryId":{ - "shape":"DirectoryId", - "documentation":"

The identifier of the AWS Directory Service directory for the WorkSpace. You can use DescribeWorkspaceDirectories to list the available directories.

" - }, - "UserName":{ - "shape":"UserName", - "documentation":"

The username of the user for the WorkSpace. This username must exist in the AWS Directory Service directory for the WorkSpace.

" - }, - "BundleId":{ - "shape":"BundleId", - "documentation":"

The identifier of the bundle for the WorkSpace. You can use DescribeWorkspaceBundles to list the available bundles.

" - }, - "VolumeEncryptionKey":{ - "shape":"VolumeEncryptionKey", - "documentation":"

The KMS key used to encrypt data stored on your WorkSpace.

" - }, - "UserVolumeEncryptionEnabled":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the data stored on the user volume is encrypted.

" - }, - "RootVolumeEncryptionEnabled":{ - "shape":"BooleanObject", - "documentation":"

Indicates whether the data stored on the root volume is encrypted.

" - }, - "WorkspaceProperties":{ - "shape":"WorkspaceProperties", - "documentation":"

The WorkSpace properties.

" - }, - "Tags":{ - "shape":"TagList", - "documentation":"

The tags for the WorkSpace.

" - } - }, - "documentation":"

Information used to create a WorkSpace.

" - }, - "WorkspaceRequestList":{ - "type":"list", - "member":{"shape":"WorkspaceRequest"}, - "max":25, - "min":1 - }, - "WorkspaceState":{ - "type":"string", - "enum":[ - "PENDING", - "AVAILABLE", - "IMPAIRED", - "UNHEALTHY", - "REBOOTING", - "STARTING", - "REBUILDING", - "MAINTENANCE", - "ADMIN_MAINTENANCE", - "TERMINATING", - "TERMINATED", - "SUSPENDED", - "UPDATING", - "STOPPING", - "STOPPED", - "ERROR" - ] - }, - "WorkspacesIpGroup":{ - "type":"structure", - "members":{ - "groupId":{ - "shape":"IpGroupId", - "documentation":"

The ID of the group.

" - }, - "groupName":{ - "shape":"IpGroupName", - "documentation":"

The name of the group.

" - }, - "groupDesc":{ - "shape":"IpGroupDesc", - "documentation":"

The description of the group.

" - }, - "userRules":{ - "shape":"IpRuleList", - "documentation":"

The rules.

" - } - }, - "documentation":"

Information about an IP access control group.

" - }, - "WorkspacesIpGroupsList":{ - "type":"list", - "member":{"shape":"WorkspacesIpGroup"} - } - }, - "documentation":"Amazon WorkSpaces Service

Amazon WorkSpaces enables you to provision virtual, cloud-based Microsoft Windows desktops for your users.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/examples-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/examples-1.json deleted file mode 100644 index 0ea7e3b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/examples-1.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "version": "1.0", - "examples": { - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/paginators-1.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/paginators-1.json deleted file mode 100644 index 00d9811c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/paginators-1.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "pagination": { - "BatchGetTraces": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Traces" - }, - "GetServiceGraph": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Services" - }, - "GetTraceGraph": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "Services" - }, - "GetTraceSummaries": { - "input_token": "NextToken", - "output_token": "NextToken", - "result_key": "TraceSummaries" - } - } -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/service-2.json b/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/service-2.json deleted file mode 100644 index 292a35d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/data/xray/2016-04-12/service-2.json +++ /dev/null @@ -1,986 +0,0 @@ -{ - "version":"2.0", - "metadata":{ - "apiVersion":"2016-04-12", - "endpointPrefix":"xray", - "protocol":"rest-json", - "serviceFullName":"AWS X-Ray", - "serviceId":"XRay", - "signatureVersion":"v4", - "uid":"xray-2016-04-12" - }, - "operations":{ - "BatchGetTraces":{ - "name":"BatchGetTraces", - "http":{ - "method":"POST", - "requestUri":"/Traces" - }, - "input":{"shape":"BatchGetTracesRequest"}, - "output":{"shape":"BatchGetTracesResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.

" - }, - "GetEncryptionConfig":{ - "name":"GetEncryptionConfig", - "http":{ - "method":"POST", - "requestUri":"/EncryptionConfig" - }, - "input":{"shape":"GetEncryptionConfigRequest"}, - "output":{"shape":"GetEncryptionConfigResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Retrieves the current encryption configuration for X-Ray data.

" - }, - "GetServiceGraph":{ - "name":"GetServiceGraph", - "http":{ - "method":"POST", - "requestUri":"/ServiceGraph" - }, - "input":{"shape":"GetServiceGraphRequest"}, - "output":{"shape":"GetServiceGraphResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.

" - }, - "GetTraceGraph":{ - "name":"GetTraceGraph", - "http":{ - "method":"POST", - "requestUri":"/TraceGraph" - }, - "input":{"shape":"GetTraceGraphRequest"}, - "output":{"shape":"GetTraceGraphResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Retrieves a service graph for one or more specific trace IDs.

" - }, - "GetTraceSummaries":{ - "name":"GetTraceSummaries", - "http":{ - "method":"POST", - "requestUri":"/TraceSummaries" - }, - "input":{"shape":"GetTraceSummariesRequest"}, - "output":{"shape":"GetTraceSummariesResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.

A filter expression can target traced requests that hit specific service nodes or edges, have errors, or come from a known user. For example, the following filter expression targets traces that pass through api.example.com:

service(\"api.example.com\")

This filter expression finds traces that have an annotation named account with the value 12345:

annotation.account = \"12345\"

For a full list of indexed fields and keywords that you can use in filter expressions, see Using Filter Expressions in the AWS X-Ray Developer Guide.

" - }, - "PutEncryptionConfig":{ - "name":"PutEncryptionConfig", - "http":{ - "method":"POST", - "requestUri":"/PutEncryptionConfig" - }, - "input":{"shape":"PutEncryptionConfigRequest"}, - "output":{"shape":"PutEncryptionConfigResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Updates the encryption configuration for X-Ray data.

" - }, - "PutTelemetryRecords":{ - "name":"PutTelemetryRecords", - "http":{ - "method":"POST", - "requestUri":"/TelemetryRecords" - }, - "input":{"shape":"PutTelemetryRecordsRequest"}, - "output":{"shape":"PutTelemetryRecordsResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Used by the AWS X-Ray daemon to upload telemetry.

" - }, - "PutTraceSegments":{ - "name":"PutTraceSegments", - "http":{ - "method":"POST", - "requestUri":"/TraceSegments" - }, - "input":{"shape":"PutTraceSegmentsRequest"}, - "output":{"shape":"PutTraceSegmentsResult"}, - "errors":[ - {"shape":"InvalidRequestException"}, - {"shape":"ThrottledException"} - ], - "documentation":"

Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in batches. A segment document can be a completed segment, an in-progress segment, or an array of subsegments.

Segments must include the following fields. For the full segment document schema, see AWS X-Ray Segment Documents in the AWS X-Ray Developer Guide.

Required Segment Document Fields

  • name - The name of the service that handled the request.

  • id - A 64-bit identifier for the segment, unique among segments in the same trace, in 16 hexadecimal digits.

  • trace_id - A unique identifier that connects all segments and subsegments originating from a single client request.

  • start_time - Time the segment or subsegment was created, in floating point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010 or 1.480615200010E9.

  • end_time - Time the segment or subsegment was closed. For example, 1480615200.090 or 1.480615200090E9. Specify either an end_time or in_progress.

  • in_progress - Set to true instead of specifying an end_time to record that a segment has been started, but is not complete. Send an in progress segment when your application receives a request that will take a long time to serve, to trace the fact that the request was received. When the response is sent, send the complete segment to overwrite the in-progress segment.

A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979. This includes:

Trace ID Format

  • The version number, i.e. 1.

  • The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 seconds, or 58406520 in hexadecimal.

  • A 96-bit identifier for the trace, globally unique, in 24 hexadecimal digits.

" - } - }, - "shapes":{ - "Alias":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

The canonical name of the alias.

" - }, - "Names":{ - "shape":"AliasNames", - "documentation":"

A list of names for the alias, including the canonical name.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of the alias.

" - } - }, - "documentation":"

An alias for an edge.

" - }, - "AliasList":{ - "type":"list", - "member":{"shape":"Alias"} - }, - "AliasNames":{ - "type":"list", - "member":{"shape":"String"} - }, - "AnnotationKey":{"type":"string"}, - "AnnotationValue":{ - "type":"structure", - "members":{ - "NumberValue":{ - "shape":"NullableDouble", - "documentation":"

Value for a Number annotation.

" - }, - "BooleanValue":{ - "shape":"NullableBoolean", - "documentation":"

Value for a Boolean annotation.

" - }, - "StringValue":{ - "shape":"String", - "documentation":"

Value for a String annotation.

" - } - }, - "documentation":"

Value of a segment annotation. Has one of three value types: Number, Boolean or String.

" - }, - "Annotations":{ - "type":"map", - "key":{"shape":"AnnotationKey"}, - "value":{"shape":"ValuesWithServiceIds"} - }, - "BackendConnectionErrors":{ - "type":"structure", - "members":{ - "TimeoutCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "ConnectionRefusedCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "HTTPCode4XXCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "HTTPCode5XXCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "UnknownHostCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "OtherCount":{ - "shape":"NullableInteger", - "documentation":"

" - } - }, - "documentation":"

" - }, - "BatchGetTracesRequest":{ - "type":"structure", - "required":["TraceIds"], - "members":{ - "TraceIds":{ - "shape":"TraceIdList", - "documentation":"

Specify the trace IDs of requests for which to retrieve segments.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "BatchGetTracesResult":{ - "type":"structure", - "members":{ - "Traces":{ - "shape":"TraceList", - "documentation":"

Full traces for the specified requests.

" - }, - "UnprocessedTraceIds":{ - "shape":"UnprocessedTraceIdList", - "documentation":"

Trace IDs of requests that haven't been processed.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "Double":{"type":"double"}, - "EC2InstanceId":{ - "type":"string", - "max":20 - }, - "Edge":{ - "type":"structure", - "members":{ - "ReferenceId":{ - "shape":"NullableInteger", - "documentation":"

Identifier of the edge. Unique within a service map.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start time of the first segment on the edge.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end time of the last segment on the edge.

" - }, - "SummaryStatistics":{ - "shape":"EdgeStatistics", - "documentation":"

Response statistics for segments on the edge.

" - }, - "ResponseTimeHistogram":{ - "shape":"Histogram", - "documentation":"

A histogram that maps the spread of client response times on an edge.

" - }, - "Aliases":{ - "shape":"AliasList", - "documentation":"

Aliases for the edge.

" - } - }, - "documentation":"

Information about a connection between two services.

" - }, - "EdgeList":{ - "type":"list", - "member":{"shape":"Edge"} - }, - "EdgeStatistics":{ - "type":"structure", - "members":{ - "OkCount":{ - "shape":"NullableLong", - "documentation":"

The number of requests that completed with a 2xx Success status code.

" - }, - "ErrorStatistics":{ - "shape":"ErrorStatistics", - "documentation":"

Information about requests that failed with a 4xx Client Error status code.

" - }, - "FaultStatistics":{ - "shape":"FaultStatistics", - "documentation":"

Information about requests that failed with a 5xx Server Error status code.

" - }, - "TotalCount":{ - "shape":"NullableLong", - "documentation":"

The total number of completed requests.

" - }, - "TotalResponseTime":{ - "shape":"NullableDouble", - "documentation":"

The aggregate response time of completed requests.

" - } - }, - "documentation":"

Response statistics for an edge.

" - }, - "EncryptionConfig":{ - "type":"structure", - "members":{ - "KeyId":{ - "shape":"String", - "documentation":"

The ID of the customer master key (CMK) used for encryption, if applicable.

" - }, - "Status":{ - "shape":"EncryptionStatus", - "documentation":"

The encryption status. After modifying encryption configuration with PutEncryptionConfig, the status can be UPDATING for up to one hour before X-Ray starts encrypting data with the new key.

" - }, - "Type":{ - "shape":"EncryptionType", - "documentation":"

The type of encryption. Set to KMS for encryption with CMKs. Set to NONE for default encryption.

" - } - }, - "documentation":"

A configuration document that specifies encryption configuration settings.

" - }, - "EncryptionKeyId":{ - "type":"string", - "max":3000, - "min":1 - }, - "EncryptionStatus":{ - "type":"string", - "enum":[ - "UPDATING", - "ACTIVE" - ] - }, - "EncryptionType":{ - "type":"string", - "enum":[ - "NONE", - "KMS" - ] - }, - "ErrorMessage":{"type":"string"}, - "ErrorStatistics":{ - "type":"structure", - "members":{ - "ThrottleCount":{ - "shape":"NullableLong", - "documentation":"

The number of requests that failed with a 419 throttling status code.

" - }, - "OtherCount":{ - "shape":"NullableLong", - "documentation":"

The number of requests that failed with untracked 4xx Client Error status codes.

" - }, - "TotalCount":{ - "shape":"NullableLong", - "documentation":"

The total number of requests that failed with a 4xx Client Error status code.

" - } - }, - "documentation":"

Information about requests that failed with a 4xx Client Error status code.

" - }, - "FaultStatistics":{ - "type":"structure", - "members":{ - "OtherCount":{ - "shape":"NullableLong", - "documentation":"

The number of requests that failed with untracked 5xx Server Error status codes.

" - }, - "TotalCount":{ - "shape":"NullableLong", - "documentation":"

The total number of requests that failed with a 5xx Server Error status code.

" - } - }, - "documentation":"

Information about requests that failed with a 5xx Server Error status code.

" - }, - "FilterExpression":{ - "type":"string", - "max":2000, - "min":1 - }, - "GetEncryptionConfigRequest":{ - "type":"structure", - "members":{ - } - }, - "GetEncryptionConfigResult":{ - "type":"structure", - "members":{ - "EncryptionConfig":{ - "shape":"EncryptionConfig", - "documentation":"

The encryption configuration document.

" - } - } - }, - "GetServiceGraphRequest":{ - "type":"structure", - "required":[ - "StartTime", - "EndTime" - ], - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start of the time frame for which to generate a graph.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time frame for which to generate a graph.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "GetServiceGraphResult":{ - "type":"structure", - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start of the time frame for which the graph was generated.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time frame for which the graph was generated.

" - }, - "Services":{ - "shape":"ServiceList", - "documentation":"

The services that have processed a traced request during the specified time frame.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "GetTraceGraphRequest":{ - "type":"structure", - "required":["TraceIds"], - "members":{ - "TraceIds":{ - "shape":"TraceIdList", - "documentation":"

Trace IDs of requests for which to generate a service graph.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "GetTraceGraphResult":{ - "type":"structure", - "members":{ - "Services":{ - "shape":"ServiceList", - "documentation":"

The services that have processed one of the specified requests.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Pagination token. Not used.

" - } - } - }, - "GetTraceSummariesRequest":{ - "type":"structure", - "required":[ - "StartTime", - "EndTime" - ], - "members":{ - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start of the time frame for which to retrieve traces.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end of the time frame for which to retrieve traces.

" - }, - "Sampling":{ - "shape":"NullableBoolean", - "documentation":"

Set to true to get summaries for only a subset of available traces.

" - }, - "FilterExpression":{ - "shape":"FilterExpression", - "documentation":"

Specify a filter expression to retrieve trace summaries for services or requests that meet certain requirements.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

Specify the pagination token returned by a previous request to retrieve the next page of results.

" - } - } - }, - "GetTraceSummariesResult":{ - "type":"structure", - "members":{ - "TraceSummaries":{ - "shape":"TraceSummaryList", - "documentation":"

Trace IDs and metadata for traces that were found in the specified time frame.

" - }, - "ApproximateTime":{ - "shape":"Timestamp", - "documentation":"

The start time of this page of results.

" - }, - "TracesProcessedCount":{ - "shape":"NullableLong", - "documentation":"

The total number of traces processed, including traces that did not match the specified filter expression.

" - }, - "NextToken":{ - "shape":"String", - "documentation":"

If the requested time frame contained more than one page of results, you can use this token to retrieve the next page. The first page contains the most most recent results, closest to the end of the time frame.

" - } - } - }, - "Histogram":{ - "type":"list", - "member":{"shape":"HistogramEntry"} - }, - "HistogramEntry":{ - "type":"structure", - "members":{ - "Value":{ - "shape":"Double", - "documentation":"

The value of the entry.

" - }, - "Count":{ - "shape":"Integer", - "documentation":"

The prevalence of the entry.

" - } - }, - "documentation":"

An entry in a histogram for a statistic. A histogram maps the range of observed values on the X axis, and the prevalence of each value on the Y axis.

" - }, - "Hostname":{ - "type":"string", - "max":255 - }, - "Http":{ - "type":"structure", - "members":{ - "HttpURL":{ - "shape":"String", - "documentation":"

The request URL.

" - }, - "HttpStatus":{ - "shape":"NullableInteger", - "documentation":"

The response status.

" - }, - "HttpMethod":{ - "shape":"String", - "documentation":"

The request method.

" - }, - "UserAgent":{ - "shape":"String", - "documentation":"

The request's user agent string.

" - }, - "ClientIp":{ - "shape":"String", - "documentation":"

The IP address of the requestor.

" - } - }, - "documentation":"

Information about an HTTP request.

" - }, - "Integer":{"type":"integer"}, - "InvalidRequestException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request is missing required parameters or has invalid parameters.

", - "exception":true - }, - "NullableBoolean":{"type":"boolean"}, - "NullableDouble":{"type":"double"}, - "NullableInteger":{"type":"integer"}, - "NullableLong":{"type":"long"}, - "PutEncryptionConfigRequest":{ - "type":"structure", - "required":["Type"], - "members":{ - "KeyId":{ - "shape":"EncryptionKeyId", - "documentation":"

An AWS KMS customer master key (CMK) in one of the following formats:

  • Alias - The name of the key. For example, alias/MyKey.

  • Key ID - The KMS key ID of the key. For example, ae4aa6d49-a4d8-9df9-a475-4ff6d7898456.

  • ARN - The full Amazon Resource Name of the key ID or alias. For example, arn:aws:kms:us-east-2:123456789012:key/ae4aa6d49-a4d8-9df9-a475-4ff6d7898456. Use this format to specify a key in a different account.

Omit this key if you set Type to NONE.

" - }, - "Type":{ - "shape":"EncryptionType", - "documentation":"

The type of encryption. Set to KMS to use your own key for encryption. Set to NONE for default encryption.

" - } - } - }, - "PutEncryptionConfigResult":{ - "type":"structure", - "members":{ - "EncryptionConfig":{ - "shape":"EncryptionConfig", - "documentation":"

The new encryption configuration.

" - } - } - }, - "PutTelemetryRecordsRequest":{ - "type":"structure", - "required":["TelemetryRecords"], - "members":{ - "TelemetryRecords":{ - "shape":"TelemetryRecordList", - "documentation":"

" - }, - "EC2InstanceId":{ - "shape":"EC2InstanceId", - "documentation":"

" - }, - "Hostname":{ - "shape":"Hostname", - "documentation":"

" - }, - "ResourceARN":{ - "shape":"ResourceARN", - "documentation":"

" - } - } - }, - "PutTelemetryRecordsResult":{ - "type":"structure", - "members":{ - } - }, - "PutTraceSegmentsRequest":{ - "type":"structure", - "required":["TraceSegmentDocuments"], - "members":{ - "TraceSegmentDocuments":{ - "shape":"TraceSegmentDocumentList", - "documentation":"

A string containing a JSON document defining one or more segments or subsegments.

" - } - } - }, - "PutTraceSegmentsResult":{ - "type":"structure", - "members":{ - "UnprocessedTraceSegments":{ - "shape":"UnprocessedTraceSegmentList", - "documentation":"

Segments that failed processing.

" - } - } - }, - "ResourceARN":{ - "type":"string", - "max":500 - }, - "Segment":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"SegmentId", - "documentation":"

The segment's ID.

" - }, - "Document":{ - "shape":"SegmentDocument", - "documentation":"

The segment document.

" - } - }, - "documentation":"

A segment from a trace that has been ingested by the X-Ray service. The segment can be compiled from documents uploaded with PutTraceSegments, or an inferred segment for a downstream service, generated from a subsegment sent by the service that called it.

For the full segment document schema, see AWS X-Ray Segment Documents in the AWS X-Ray Developer Guide.

" - }, - "SegmentDocument":{ - "type":"string", - "min":1 - }, - "SegmentId":{"type":"string"}, - "SegmentList":{ - "type":"list", - "member":{"shape":"Segment"} - }, - "Service":{ - "type":"structure", - "members":{ - "ReferenceId":{ - "shape":"NullableInteger", - "documentation":"

Identifier for the service. Unique within the service map.

" - }, - "Name":{ - "shape":"String", - "documentation":"

The canonical name of the service.

" - }, - "Names":{ - "shape":"ServiceNames", - "documentation":"

A list of names for the service, including the canonical name.

" - }, - "Root":{ - "shape":"NullableBoolean", - "documentation":"

Indicates that the service was the first service to process a request.

" - }, - "AccountId":{ - "shape":"String", - "documentation":"

Identifier of the AWS account in which the service runs.

" - }, - "Type":{ - "shape":"String", - "documentation":"

The type of service.

  • AWS Resource - The type of an AWS resource. For example, AWS::EC2::Instance for a application running on Amazon EC2 or AWS::DynamoDB::Table for an Amazon DynamoDB table that the application used.

  • AWS Service - The type of an AWS service. For example, AWS::DynamoDB for downstream calls to Amazon DynamoDB that didn't target a specific table.

  • client - Represents the clients that sent requests to a root service.

  • remote - A downstream service of indeterminate type.

" - }, - "State":{ - "shape":"String", - "documentation":"

The service's state.

" - }, - "StartTime":{ - "shape":"Timestamp", - "documentation":"

The start time of the first segment that the service generated.

" - }, - "EndTime":{ - "shape":"Timestamp", - "documentation":"

The end time of the last segment that the service generated.

" - }, - "Edges":{ - "shape":"EdgeList", - "documentation":"

Connections to downstream services.

" - }, - "SummaryStatistics":{ - "shape":"ServiceStatistics", - "documentation":"

Aggregated statistics for the service.

" - }, - "DurationHistogram":{ - "shape":"Histogram", - "documentation":"

A histogram that maps the spread of service durations.

" - }, - "ResponseTimeHistogram":{ - "shape":"Histogram", - "documentation":"

A histogram that maps the spread of service response times.

" - } - }, - "documentation":"

Information about an application that processed requests, users that made requests, or downstream services, resources and applications that an application used.

" - }, - "ServiceId":{ - "type":"structure", - "members":{ - "Name":{ - "shape":"String", - "documentation":"

" - }, - "Names":{ - "shape":"ServiceNames", - "documentation":"

" - }, - "AccountId":{ - "shape":"String", - "documentation":"

" - }, - "Type":{ - "shape":"String", - "documentation":"

" - } - }, - "documentation":"

" - }, - "ServiceIds":{ - "type":"list", - "member":{"shape":"ServiceId"} - }, - "ServiceList":{ - "type":"list", - "member":{"shape":"Service"} - }, - "ServiceNames":{ - "type":"list", - "member":{"shape":"String"} - }, - "ServiceStatistics":{ - "type":"structure", - "members":{ - "OkCount":{ - "shape":"NullableLong", - "documentation":"

The number of requests that completed with a 2xx Success status code.

" - }, - "ErrorStatistics":{ - "shape":"ErrorStatistics", - "documentation":"

Information about requests that failed with a 4xx Client Error status code.

" - }, - "FaultStatistics":{ - "shape":"FaultStatistics", - "documentation":"

Information about requests that failed with a 5xx Server Error status code.

" - }, - "TotalCount":{ - "shape":"NullableLong", - "documentation":"

The total number of completed requests.

" - }, - "TotalResponseTime":{ - "shape":"NullableDouble", - "documentation":"

The aggregate response time of completed requests.

" - } - }, - "documentation":"

Response statistics for a service.

" - }, - "String":{"type":"string"}, - "TelemetryRecord":{ - "type":"structure", - "required":["Timestamp"], - "members":{ - "Timestamp":{ - "shape":"Timestamp", - "documentation":"

" - }, - "SegmentsReceivedCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "SegmentsSentCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "SegmentsSpilloverCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "SegmentsRejectedCount":{ - "shape":"NullableInteger", - "documentation":"

" - }, - "BackendConnectionErrors":{ - "shape":"BackendConnectionErrors", - "documentation":"

" - } - }, - "documentation":"

" - }, - "TelemetryRecordList":{ - "type":"list", - "member":{"shape":"TelemetryRecord"} - }, - "ThrottledException":{ - "type":"structure", - "members":{ - "Message":{"shape":"ErrorMessage"} - }, - "documentation":"

The request exceeds the maximum number of requests per second.

", - "error":{"httpStatusCode":429}, - "exception":true - }, - "Timestamp":{"type":"timestamp"}, - "Trace":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"TraceId", - "documentation":"

The unique identifier for the request that generated the trace's segments and subsegments.

" - }, - "Duration":{ - "shape":"NullableDouble", - "documentation":"

The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.

" - }, - "Segments":{ - "shape":"SegmentList", - "documentation":"

Segment documents for the segments and subsegments that comprise the trace.

" - } - }, - "documentation":"

A collection of segment documents with matching trace IDs.

" - }, - "TraceId":{ - "type":"string", - "max":35, - "min":1 - }, - "TraceIdList":{ - "type":"list", - "member":{"shape":"TraceId"} - }, - "TraceList":{ - "type":"list", - "member":{"shape":"Trace"} - }, - "TraceSegmentDocument":{"type":"string"}, - "TraceSegmentDocumentList":{ - "type":"list", - "member":{"shape":"TraceSegmentDocument"} - }, - "TraceSummary":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"TraceId", - "documentation":"

The unique identifier for the request that generated the trace's segments and subsegments.

" - }, - "Duration":{ - "shape":"NullableDouble", - "documentation":"

The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.

" - }, - "ResponseTime":{ - "shape":"NullableDouble", - "documentation":"

The length of time in seconds between the start and end times of the root segment. If the service performs work asynchronously, the response time measures the time before the response is sent to the user, while the duration measures the amount of time before the last traced activity completes.

" - }, - "HasFault":{ - "shape":"NullableBoolean", - "documentation":"

One or more of the segment documents has a 500 series error.

" - }, - "HasError":{ - "shape":"NullableBoolean", - "documentation":"

One or more of the segment documents has a 400 series error.

" - }, - "HasThrottle":{ - "shape":"NullableBoolean", - "documentation":"

One or more of the segment documents has a 429 throttling error.

" - }, - "IsPartial":{ - "shape":"NullableBoolean", - "documentation":"

One or more of the segment documents is in progress.

" - }, - "Http":{ - "shape":"Http", - "documentation":"

Information about the HTTP request served by the trace.

" - }, - "Annotations":{ - "shape":"Annotations", - "documentation":"

Annotations from the trace's segment documents.

" - }, - "Users":{ - "shape":"TraceUsers", - "documentation":"

Users from the trace's segment documents.

" - }, - "ServiceIds":{ - "shape":"ServiceIds", - "documentation":"

Service IDs from the trace's segment documents.

" - } - }, - "documentation":"

Metadata generated from the segment documents in a trace.

" - }, - "TraceSummaryList":{ - "type":"list", - "member":{"shape":"TraceSummary"} - }, - "TraceUser":{ - "type":"structure", - "members":{ - "UserName":{ - "shape":"String", - "documentation":"

The user's name.

" - }, - "ServiceIds":{ - "shape":"ServiceIds", - "documentation":"

Services that the user's request hit.

" - } - }, - "documentation":"

Information about a user recorded in segment documents.

" - }, - "TraceUsers":{ - "type":"list", - "member":{"shape":"TraceUser"} - }, - "UnprocessedTraceIdList":{ - "type":"list", - "member":{"shape":"TraceId"} - }, - "UnprocessedTraceSegment":{ - "type":"structure", - "members":{ - "Id":{ - "shape":"String", - "documentation":"

The segment's ID.

" - }, - "ErrorCode":{ - "shape":"String", - "documentation":"

The error that caused processing to fail.

" - }, - "Message":{ - "shape":"String", - "documentation":"

The error message.

" - } - }, - "documentation":"

Information about a segment that failed processing.

" - }, - "UnprocessedTraceSegmentList":{ - "type":"list", - "member":{"shape":"UnprocessedTraceSegment"} - }, - "ValueWithServiceIds":{ - "type":"structure", - "members":{ - "AnnotationValue":{ - "shape":"AnnotationValue", - "documentation":"

Values of the annotation.

" - }, - "ServiceIds":{ - "shape":"ServiceIds", - "documentation":"

Services to which the annotation applies.

" - } - }, - "documentation":"

Information about a segment annotation.

" - }, - "ValuesWithServiceIds":{ - "type":"list", - "member":{"shape":"ValueWithServiceIds"} - } - }, - "documentation":"

AWS X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces.

" -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/__init__.py deleted file mode 100644 index b76f7990..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/__init__.py +++ /dev/null @@ -1,38 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import os - -from botocore.docs.service import ServiceDocumenter - - -def generate_docs(root_dir, session): - """Generates the reference documentation for botocore - - This will go through every available AWS service and output ReSTructured - text files documenting each service. - - :param root_dir: The directory to write the reference files to. Each - service's reference documentation is loacated at - root_dir/reference/services/service-name.rst - """ - services_doc_path = os.path.join(root_dir, 'reference', 'services') - if not os.path.exists(services_doc_path): - os.makedirs(services_doc_path) - - # Generate reference docs and write them out. - for service_name in session.get_available_services(): - docs = ServiceDocumenter(service_name, session).document_service() - service_doc_path = os.path.join( - services_doc_path, service_name + '.rst') - with open(service_doc_path, 'wb') as f: - f.write(docs) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/__init__.py deleted file mode 100644 index b687f69d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright 2013 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -__version__ = '0.16.0' diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docevents.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docevents.py deleted file mode 100644 index f5c6c849..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docevents.py +++ /dev/null @@ -1,103 +0,0 @@ -# Copyright 2012-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - - -DOC_EVENTS = { - 'doc-breadcrumbs': '.%s', - 'doc-title': '.%s', - 'doc-description': '.%s', - 'doc-synopsis-start': '.%s', - 'doc-synopsis-option': '.%s.%s', - 'doc-synopsis-end': '.%s', - 'doc-options-start': '.%s', - 'doc-option': '.%s.%s', - 'doc-option-example': '.%s.%s', - 'doc-options-end': '.%s', - 'doc-examples': '.%s', - 'doc-output': '.%s', - 'doc-subitems-start': '.%s', - 'doc-subitem': '.%s.%s', - 'doc-subitems-end': '.%s', - 'doc-relateditems-start': '.%s', - 'doc-relateditem': '.%s.%s', - 'doc-relateditems-end': '.%s' - } - - -def generate_events(session, help_command): - # Now generate the documentation events - session.emit('doc-breadcrumbs.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-title.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-description.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-synopsis-start.%s' % help_command.event_class, - help_command=help_command) - if help_command.arg_table: - for arg_name in help_command.arg_table: - # An argument can set an '_UNDOCUMENTED' attribute - # to True to indicate a parameter that exists - # but shouldn't be documented. This can be used - # for backwards compatibility of deprecated arguments. - if getattr(help_command.arg_table[arg_name], - '_UNDOCUMENTED', False): - continue - session.emit( - 'doc-synopsis-option.%s.%s' % (help_command.event_class, - arg_name), - arg_name=arg_name, help_command=help_command) - session.emit('doc-synopsis-end.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-options-start.%s' % help_command.event_class, - help_command=help_command) - if help_command.arg_table: - for arg_name in help_command.arg_table: - if getattr(help_command.arg_table[arg_name], - '_UNDOCUMENTED', False): - continue - session.emit('doc-option.%s.%s' % (help_command.event_class, - arg_name), - arg_name=arg_name, help_command=help_command) - session.emit('doc-option-example.%s.%s' % - (help_command.event_class, arg_name), - arg_name=arg_name, help_command=help_command) - session.emit('doc-options-end.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-subitems-start.%s' % help_command.event_class, - help_command=help_command) - if help_command.command_table: - for command_name in sorted(help_command.command_table.keys()): - if hasattr(help_command.command_table[command_name], - '_UNDOCUMENTED'): - continue - session.emit('doc-subitem.%s.%s' - % (help_command.event_class, command_name), - command_name=command_name, - help_command=help_command) - session.emit('doc-subitems-end.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-examples.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-output.%s' % help_command.event_class, - help_command=help_command) - session.emit('doc-relateditems-start.%s' % help_command.event_class, - help_command=help_command) - if help_command.related_items: - for related_item in sorted(help_command.related_items): - session.emit('doc-relateditem.%s.%s' - % (help_command.event_class, related_item), - help_command=help_command, - related_item=related_item) - session.emit('doc-relateditems-end.%s' % help_command.event_class, - help_command=help_command) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docstringparser.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docstringparser.py deleted file mode 100644 index 868bd5d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/docstringparser.py +++ /dev/null @@ -1,200 +0,0 @@ -# Copyright 2012-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.compat import six - - -class DocStringParser(six.moves.html_parser.HTMLParser): - """ - A simple HTML parser. Focused on converting the subset of HTML - that appears in the documentation strings of the JSON models into - simple ReST format. - """ - - def __init__(self, doc): - self.tree = None - self.doc = doc - six.moves.html_parser.HTMLParser.__init__(self) - - def reset(self): - six.moves.html_parser.HTMLParser.reset(self) - self.tree = HTMLTree(self.doc) - - def feed(self, data): - # HTMLParser is an old style class, so the super() method will not work. - six.moves.html_parser.HTMLParser.feed(self, data) - self.tree.write() - self.tree = HTMLTree(self.doc) - - def close(self): - six.moves.html_parser.HTMLParser.close(self) - # Write if there is anything remaining. - self.tree.write() - self.tree = HTMLTree(self.doc) - - def handle_starttag(self, tag, attrs): - self.tree.add_tag(tag, attrs=attrs) - - def handle_endtag(self, tag): - self.tree.add_tag(tag, is_start=False) - - def handle_data(self, data): - self.tree.add_data(data) - - -class HTMLTree(object): - """ - A tree which handles HTML nodes. Designed to work with a python HTML parser, - meaning that the current_node will be the most recently opened tag. When - a tag is closed, the current_node moves up to the parent node. - """ - def __init__(self, doc): - self.doc = doc - self.head = StemNode() - self.current_node = self.head - self.unhandled_tags = [] - - def add_tag(self, tag, attrs=None, is_start=True): - if not self._doc_has_handler(tag, is_start): - self.unhandled_tags.append(tag) - return - - if is_start: - if tag == 'li': - node = LineItemNode(attrs) - else: - node = TagNode(tag, attrs) - self.current_node.add_child(node) - self.current_node = node - else: - self.current_node = self.current_node.parent - - def _doc_has_handler(self, tag, is_start): - if is_start: - handler_name = 'start_%s' % tag - else: - handler_name = 'end_%s' % tag - - return hasattr(self.doc.style, handler_name) - - def add_data(self, data): - self.current_node.add_child(DataNode(data)) - - def write(self): - self.head.write(self.doc) - - -class Node(object): - def __init__(self, parent=None): - self.parent = parent - - def write(self, doc): - raise NotImplementedError - - -class StemNode(Node): - def __init__(self, parent=None): - super(StemNode, self).__init__(parent) - self.children = [] - - def add_child(self, child): - child.parent = self - self.children.append(child) - - def write(self, doc): - self._write_children(doc) - - def _write_children(self, doc): - for child in self.children: - child.write(doc) - - -class TagNode(StemNode): - """ - A generic Tag node. It will verify that handlers exist before writing. - """ - def __init__(self, tag, attrs=None, parent=None): - super(TagNode, self).__init__(parent) - self.attrs = attrs - self.tag = tag - - def write(self, doc): - self._write_start(doc) - self._write_children(doc) - self._write_end(doc) - - def _write_start(self, doc): - handler_name = 'start_%s' % self.tag - if hasattr(doc.style, handler_name): - getattr(doc.style, handler_name)(self.attrs) - - def _write_end(self, doc): - handler_name = 'end_%s' % self.tag - if hasattr(doc.style, handler_name): - getattr(doc.style, handler_name)() - - -class LineItemNode(TagNode): - def __init__(self, attrs=None, parent=None): - super(LineItemNode, self).__init__('li', attrs, parent) - - def write(self, doc): - self._lstrip(self) - super(LineItemNode, self).write(doc) - - def _lstrip(self, node): - """ - Traverses the tree, stripping out whitespace until text data is found - :param node: The node to strip - :return: True if non-whitespace data was found, False otherwise - """ - for child in node.children: - if isinstance(child, DataNode): - child.lstrip() - if child.data: - return True - else: - found = self._lstrip(child) - if found: - return True - - return False - - -class DataNode(Node): - """ - A Node that contains only string data. - """ - def __init__(self, data, parent=None): - super(DataNode, self).__init__(parent) - if not isinstance(data, six.string_types): - raise ValueError("Expecting string type, %s given." % type(data)) - self.data = data - - def lstrip(self): - self.data = self.data.lstrip() - - def write(self, doc): - if not self.data: - return - - if self.data.isspace(): - str_data = ' ' - else: - end_space = self.data[-1].isspace() - words = self.data.split() - words = doc.translate_words(words) - str_data = ' '.join(words) - if end_space: - str_data += ' ' - - doc.handle_data(str_data) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/restdoc.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/restdoc.py deleted file mode 100644 index 9f91e1c3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/restdoc.py +++ /dev/null @@ -1,218 +0,0 @@ -# Copyright 2012-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import logging - -from botocore.compat import OrderedDict -from botocore.docs.bcdoc.docstringparser import DocStringParser -from botocore.docs.bcdoc.style import ReSTStyle - -LOG = logging.getLogger('bcdocs') - - -class ReSTDocument(object): - - def __init__(self, target='man'): - self.style = ReSTStyle(self) - self.target = target - self.parser = DocStringParser(self) - self.keep_data = True - self.do_translation = False - self.translation_map = {} - self.hrefs = {} - self._writes = [] - self._last_doc_string = None - - def _write(self, s): - if self.keep_data and s is not None: - self._writes.append(s) - - def write(self, content): - """ - Write content into the document. - """ - self._write(content) - - def writeln(self, content): - """ - Write content on a newline. - """ - self._write('%s%s\n' % (self.style.spaces(), content)) - - def peek_write(self): - """ - Returns the last content written to the document without - removing it from the stack. - """ - return self._writes[-1] - - def pop_write(self): - """ - Removes and returns the last content written to the stack. - """ - return self._writes.pop() - - def push_write(self, s): - """ - Places new content on the stack. - """ - self._writes.append(s) - - def getvalue(self): - """ - Returns the current content of the document as a string. - """ - if self.hrefs: - self.style.new_paragraph() - for refname, link in self.hrefs.items(): - self.style.link_target_definition(refname, link) - return ''.join(self._writes).encode('utf-8') - - def translate_words(self, words): - return [self.translation_map.get(w, w) for w in words] - - def handle_data(self, data): - if data and self.keep_data: - self._write(data) - - def include_doc_string(self, doc_string): - if doc_string: - try: - start = len(self._writes) - self.parser.feed(doc_string) - self.parser.close() - end = len(self._writes) - self._last_doc_string = (start, end) - except Exception: - LOG.debug('Error parsing doc string', exc_info=True) - LOG.debug(doc_string) - - def remove_last_doc_string(self): - # Removes all writes inserted by last doc string - if self._last_doc_string is not None: - start, end = self._last_doc_string - del self._writes[start:end] - - -class DocumentStructure(ReSTDocument): - def __init__(self, name, section_names=None, target='man', context=None): - """Provides a Hierarichial structure to a ReSTDocument - - You can write to it similiar to as you can to a ReSTDocument but - has an innate structure for more orginaztion and abstraction. - - :param name: The name of the document - :param section_names: A list of sections to be included - in the document. - :param target: The target documentation of the Document structure - :param context: A dictionary of data to store with the strucuture. These - are only stored per section not the entire structure. - """ - super(DocumentStructure, self).__init__(target=target) - self._name = name - self._structure = OrderedDict() - self._path = [self._name] - self._context = {} - if context is not None: - self._context = context - if section_names is not None: - self._generate_structure(section_names) - - @property - def name(self): - """The name of the document structure""" - return self._name - - @property - def path(self): - """ - A list of where to find a particular document structure in the - overlying document structure. - """ - return self._path - - @path.setter - def path(self, value): - self._path = value - - @property - def available_sections(self): - return list(self._structure) - - @property - def context(self): - return self._context - - def _generate_structure(self, section_names): - for section_name in section_names: - self.add_new_section(section_name) - - def add_new_section(self, name, context=None): - """Adds a new section to the current document structure - - This document structure will be considered a section to the - current document structure but will in itself be an entirely - new document structure that can be written to and have sections - as well - - :param name: The name of the section. - :param context: A dictionary of data to store with the strucuture. These - are only stored per section not the entire structure. - :rtype: DocumentStructure - :returns: A new document structure to add to but lives as a section - to the document structure it was instantiated from. - """ - # Add a new section - section = self.__class__(name=name, target=self.target, - context=context) - section.path = self.path + [name] - # Indent the section apporpriately as well - section.style.indentation = self.style.indentation - section.translation_map = self.translation_map - section.hrefs = self.hrefs - self._structure[name] = section - return section - - def get_section(self, name): - """Retrieve a section""" - return self._structure[name] - - def delete_section(self, name): - """Delete a section""" - del self._structure[name] - - def flush_structure(self): - """Flushes a doc structure to a ReSTructed string - - The document is flushed out in a DFS style where sections and their - subsections' values are added to the string as they are visited. - """ - # We are at the root flush the links at the beginning of the - # document - if len(self.path) == 1: - if self.hrefs: - self.style.new_paragraph() - for refname, link in self.hrefs.items(): - self.style.link_target_definition(refname, link) - value = self.getvalue() - for name, section in self._structure.items(): - value += section.flush_structure() - return value - - def getvalue(self): - return ''.join(self._writes).encode('utf-8') - - def remove_all_sections(self): - self._structure = OrderedDict() - - def clear_text(self): - self._writes = [] diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/style.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/style.py deleted file mode 100644 index 4470d65d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/style.py +++ /dev/null @@ -1,418 +0,0 @@ -# Copyright 2012-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import logging - -logger = logging.getLogger('bcdocs') - - -class BaseStyle(object): - - def __init__(self, doc, indent_width=2): - self.doc = doc - self.indent_width = indent_width - self._indent = 0 - self.keep_data = True - - @property - def indentation(self): - return self._indent - - @indentation.setter - def indentation(self, value): - self._indent = value - - def new_paragraph(self): - return '\n%s' % self.spaces() - - def indent(self): - self._indent += 1 - - def dedent(self): - if self._indent > 0: - self._indent -= 1 - - def spaces(self): - return ' ' * (self._indent * self.indent_width) - - def bold(self, s): - return s - - def ref(self, link, title=None): - return link - - def h2(self, s): - return s - - def h3(self, s): - return s - - def underline(self, s): - return s - - def italics(self, s): - return s - - -class ReSTStyle(BaseStyle): - - def __init__(self, doc, indent_width=2): - BaseStyle.__init__(self, doc, indent_width) - self.do_p = True - self.a_href = None - self.list_depth = 0 - - def new_paragraph(self): - self.doc.write('\n\n%s' % self.spaces()) - - def new_line(self): - self.doc.write('\n%s' % self.spaces()) - - def _start_inline(self, markup): - self.doc.write(markup) - - def _end_inline(self, markup): - # Sometimes the HTML markup has whitespace between the end - # of the text inside the inline markup and the closing element - # (e.g. foobar ). This trailing space will cause - # problems in the ReST inline markup so we remove it here - # by popping the last item written off the stack, striping - # the whitespace and then pushing it back on the stack. - last_write = self.doc.pop_write().rstrip(' ') - - # Sometimes, for whatever reason, a tag like is present. This - # is problematic because if we simply translate that directly then - # we end up with something like ****, which rst will assume is a - # heading instead of an empty bold. - if last_write == markup: - return - - self.doc.push_write(last_write) - self.doc.write(markup + ' ') - - def start_bold(self, attrs=None): - self._start_inline('**') - - def end_bold(self): - self._end_inline('**') - - def start_b(self, attrs=None): - self.doc.do_translation = True - self.start_bold(attrs) - - def end_b(self): - self.doc.do_translation = False - self.end_bold() - - def bold(self, s): - if s: - self.start_bold() - self.doc.write(s) - self.end_bold() - - def ref(self, title, link=None): - if link is None: - link = title - self.doc.write(':doc:`%s <%s>`' % (title, link)) - - def _heading(self, s, border_char): - border = border_char * len(s) - self.new_paragraph() - self.doc.write('%s\n%s\n%s' % (border, s, border)) - self.new_paragraph() - - def h1(self, s): - self._heading(s, '*') - - def h2(self, s): - self._heading(s, '=') - - def h3(self, s): - self._heading(s, '-') - - def start_italics(self, attrs=None): - self._start_inline('*') - - def end_italics(self): - self._end_inline('*') - - def italics(self, s): - if s: - self.start_italics() - self.doc.write(s) - self.end_italics() - - def start_p(self, attrs=None): - if self.do_p: - self.doc.write('\n\n%s' % self.spaces()) - - def end_p(self): - if self.do_p: - self.doc.write('\n\n%s' % self.spaces()) - - def start_code(self, attrs=None): - self.doc.do_translation = True - self._start_inline('``') - - def end_code(self): - self.doc.do_translation = False - self._end_inline('``') - - def code(self, s): - if s: - self.start_code() - self.doc.write(s) - self.end_code() - - def start_note(self, attrs=None): - self.new_paragraph() - self.doc.write('.. note::') - self.indent() - self.new_paragraph() - - def end_note(self): - self.dedent() - self.new_paragraph() - - def start_important(self, attrs=None): - self.new_paragraph() - self.doc.write('.. warning::') - self.indent() - self.new_paragraph() - - def end_important(self): - self.dedent() - self.new_paragraph() - - def start_danger(self, attrs=None): - self.new_paragraph() - self.doc.write('.. danger::') - self.indent() - self.new_paragraph() - - def end_danger(self): - self.dedent() - self.new_paragraph() - - def start_a(self, attrs=None): - if attrs: - for attr_key, attr_value in attrs: - if attr_key == 'href': - self.a_href = attr_value - self.doc.write('`') - else: - # There are some model documentation that - # looks like this: DescribeInstances. - # In this case we just write out an empty - # string. - self.doc.write(' ') - self.doc.do_translation = True - - def link_target_definition(self, refname, link): - self.doc.writeln('.. _%s: %s' % (refname, link)) - - def sphinx_reference_label(self, label, text=None): - if text is None: - text = label - if self.doc.target == 'html': - self.doc.write(':ref:`%s <%s>`' % (text, label)) - else: - self.doc.write(text) - - def end_a(self): - self.doc.do_translation = False - if self.a_href: - last_write = self.doc.pop_write() - last_write = last_write.rstrip(' ') - if last_write and last_write != '`': - if ':' in last_write: - last_write = last_write.replace(':', r'\:') - self.doc.push_write(last_write) - self.doc.push_write(' <%s>`__' % self.a_href) - elif last_write == '`': - # Look at start_a(). It will do a self.doc.write('`') - # which is the start of the link title. If that is the - # case then there was no link text. We should just - # use an inline link. The syntax of this is - # ``_ - self.doc.push_write('`<%s>`__' % self.a_href) - else: - self.doc.push_write(self.a_href) - self.doc.hrefs[self.a_href] = self.a_href - self.doc.write('`__') - self.a_href = None - self.doc.write(' ') - - def start_i(self, attrs=None): - self.doc.do_translation = True - self.start_italics() - - def end_i(self): - self.doc.do_translation = False - self.end_italics() - - def start_li(self, attrs=None): - self.new_line() - self.do_p = False - self.doc.write('* ') - - def end_li(self): - self.do_p = True - self.new_line() - - def li(self, s): - if s: - self.start_li() - self.doc.writeln(s) - self.end_li() - - def start_ul(self, attrs=None): - if self.list_depth != 0: - self.indent() - self.list_depth += 1 - self.new_paragraph() - - def end_ul(self): - self.list_depth -= 1 - if self.list_depth != 0: - self.dedent() - self.new_paragraph() - - def start_ol(self, attrs=None): - # TODO: Need to control the bullets used for LI items - if self.list_depth != 0: - self.indent() - self.list_depth += 1 - self.new_paragraph() - - def end_ol(self): - self.list_depth -= 1 - if self.list_depth != 0: - self.dedent() - self.new_paragraph() - - def start_examples(self, attrs=None): - self.doc.keep_data = False - - def end_examples(self): - self.doc.keep_data = True - - def start_fullname(self, attrs=None): - self.doc.keep_data = False - - def end_fullname(self): - self.doc.keep_data = True - - def start_codeblock(self, attrs=None): - self.doc.write('::') - self.indent() - self.new_paragraph() - - def end_codeblock(self): - self.dedent() - self.new_paragraph() - - def codeblock(self, code): - """ - Literal code blocks are introduced by ending a paragraph with - the special marker ::. The literal block must be indented - (and, like all paragraphs, separated from the surrounding - ones by blank lines). - """ - self.start_codeblock() - self.doc.writeln(code) - self.end_codeblock() - - def toctree(self): - if self.doc.target == 'html': - self.doc.write('\n.. toctree::\n') - self.doc.write(' :maxdepth: 1\n') - self.doc.write(' :titlesonly:\n\n') - else: - self.start_ul() - - def tocitem(self, item, file_name=None): - if self.doc.target == 'man': - self.li(item) - else: - if file_name: - self.doc.writeln(' %s' % file_name) - else: - self.doc.writeln(' %s' % item) - - def hidden_toctree(self): - if self.doc.target == 'html': - self.doc.write('\n.. toctree::\n') - self.doc.write(' :maxdepth: 1\n') - self.doc.write(' :hidden:\n\n') - - def hidden_tocitem(self, item): - if self.doc.target == 'html': - self.tocitem(item) - - def table_of_contents(self, title=None, depth=None): - self.doc.write('.. contents:: ') - if title is not None: - self.doc.writeln(title) - if depth is not None: - self.doc.writeln(' :depth: %s' % depth) - - def start_sphinx_py_class(self, class_name): - self.new_paragraph() - self.doc.write('.. py:class:: %s' % class_name) - self.indent() - self.new_paragraph() - - def end_sphinx_py_class(self): - self.dedent() - self.new_paragraph() - - def start_sphinx_py_method(self, method_name, parameters=None): - self.new_paragraph() - content = '.. py:method:: %s' % method_name - if parameters is not None: - content += '(%s)' % parameters - self.doc.write(content) - self.indent() - self.new_paragraph() - - def end_sphinx_py_method(self): - self.dedent() - self.new_paragraph() - - def start_sphinx_py_attr(self, attr_name): - self.new_paragraph() - self.doc.write('.. py:attribute:: %s' % attr_name) - self.indent() - self.new_paragraph() - - def end_sphinx_py_attr(self): - self.dedent() - self.new_paragraph() - - def write_py_doc_string(self, docstring): - docstring_lines = docstring.splitlines() - for docstring_line in docstring_lines: - self.doc.writeln(docstring_line) - - def external_link(self, title, link): - if self.doc.target == 'html': - self.doc.write('`%s <%s>`_' % (title, link)) - else: - self.doc.write(title) - - def internal_link(self, title, page): - if self.doc.target == 'html': - self.doc.write(':doc:`%s <%s>`' % (title, page)) - else: - self.doc.write(title) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/textwriter.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/textwriter.py deleted file mode 100644 index 6fc171b9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/bcdoc/textwriter.py +++ /dev/null @@ -1,799 +0,0 @@ -# -*- coding: utf-8 -*- -""" - - Custom docutils writer for plain text. - Based heavily on the Sphinx text writer. See copyright below. - - :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - :license: BSD, see LICENSE for details. - -""" -import os -import re -import textwrap - -from docutils import nodes, writers - - -class TextWrapper(textwrap.TextWrapper): - """Custom subclass that uses a different word separator regex.""" - - wordsep_re = re.compile( - r'(\s+|' # any whitespace - r'(?<=\s)(?::[a-z-]+:)?`\S+|' # interpreted text start - r'[^\s\w]*\w+[a-zA-Z]-(?=\w+[a-zA-Z])|' # hyphenated words - r'(?<=[\w\!\"\'\&\.\,\?])-{2,}(?=\w))') # em-dash - - -MAXWIDTH = 70 -STDINDENT = 3 - - -def my_wrap(text, width=MAXWIDTH, **kwargs): - w = TextWrapper(width=width, **kwargs) - return w.wrap(text) - - -class TextWriter(writers.Writer): - supported = ('text',) - settings_spec = ('No options here.', '', ()) - settings_defaults = {} - - output = None - - def __init__(self): - writers.Writer.__init__(self) - - def translate(self): - visitor = TextTranslator(self.document) - self.document.walkabout(visitor) - self.output = visitor.body - - -class TextTranslator(nodes.NodeVisitor): - sectionchars = '*=-~"+`' - - def __init__(self, document): - nodes.NodeVisitor.__init__(self, document) - - self.nl = os.linesep - self.states = [[]] - self.stateindent = [0] - self.list_counter = [] - self.sectionlevel = 0 - self.table = None - - def add_text(self, text): - self.states[-1].append((-1, text)) - - def new_state(self, indent=STDINDENT): - self.states.append([]) - self.stateindent.append(indent) - - def end_state(self, wrap=True, end=[''], first=None): - content = self.states.pop() - maxindent = sum(self.stateindent) - indent = self.stateindent.pop() - result = [] - toformat = [] - - def do_format(): - if not toformat: - return - if wrap: - res = my_wrap(''.join(toformat), width=MAXWIDTH-maxindent) - else: - res = ''.join(toformat).splitlines() - if end: - res += end - result.append((indent, res)) - for itemindent, item in content: - if itemindent == -1: - toformat.append(item) - else: - do_format() - result.append((indent + itemindent, item)) - toformat = [] - do_format() - if first is not None and result: - itemindent, item = result[0] - if item: - result.insert(0, (itemindent - indent, [first + item[0]])) - result[1] = (itemindent, item[1:]) - self.states[-1].extend(result) - - def visit_document(self, node): - self.new_state(0) - - def depart_document(self, node): - self.end_state() - self.body = self.nl.join(line and (' '*indent + line) - for indent, lines in self.states[0] - for line in lines) - # XXX header/footer? - - def visit_highlightlang(self, node): - raise nodes.SkipNode - - def visit_section(self, node): - self._title_char = self.sectionchars[self.sectionlevel] - self.sectionlevel += 1 - - def depart_section(self, node): - self.sectionlevel -= 1 - - def visit_topic(self, node): - self.new_state(0) - - def depart_topic(self, node): - self.end_state() - - visit_sidebar = visit_topic - depart_sidebar = depart_topic - - def visit_rubric(self, node): - self.new_state(0) - self.add_text('-[ ') - - def depart_rubric(self, node): - self.add_text(' ]-') - self.end_state() - - def visit_compound(self, node): - pass - - def depart_compound(self, node): - pass - - def visit_glossary(self, node): - pass - - def depart_glossary(self, node): - pass - - def visit_title(self, node): - if isinstance(node.parent, nodes.Admonition): - self.add_text(node.astext()+': ') - raise nodes.SkipNode - self.new_state(0) - - def depart_title(self, node): - if isinstance(node.parent, nodes.section): - char = self._title_char - else: - char = '^' - text = ''.join(x[1] for x in self.states.pop() if x[0] == -1) - self.stateindent.pop() - self.states[-1].append((0, ['', text, '%s' % (char * len(text)), ''])) - - def visit_subtitle(self, node): - pass - - def depart_subtitle(self, node): - pass - - def visit_attribution(self, node): - self.add_text('-- ') - - def depart_attribution(self, node): - pass - - def visit_desc(self, node): - pass - - def depart_desc(self, node): - pass - - def visit_desc_signature(self, node): - self.new_state(0) - if node.parent['objtype'] in ('class', 'exception'): - self.add_text('%s ' % node.parent['objtype']) - - def depart_desc_signature(self, node): - # XXX: wrap signatures in a way that makes sense - self.end_state(wrap=False, end=None) - - def visit_desc_name(self, node): - pass - - def depart_desc_name(self, node): - pass - - def visit_desc_addname(self, node): - pass - - def depart_desc_addname(self, node): - pass - - def visit_desc_type(self, node): - pass - - def depart_desc_type(self, node): - pass - - def visit_desc_returns(self, node): - self.add_text(' -> ') - - def depart_desc_returns(self, node): - pass - - def visit_desc_parameterlist(self, node): - self.add_text('(') - self.first_param = 1 - - def depart_desc_parameterlist(self, node): - self.add_text(')') - - def visit_desc_parameter(self, node): - if not self.first_param: - self.add_text(', ') - else: - self.first_param = 0 - self.add_text(node.astext()) - raise nodes.SkipNode - - def visit_desc_optional(self, node): - self.add_text('[') - - def depart_desc_optional(self, node): - self.add_text(']') - - def visit_desc_annotation(self, node): - pass - - def depart_desc_annotation(self, node): - pass - - def visit_refcount(self, node): - pass - - def depart_refcount(self, node): - pass - - def visit_desc_content(self, node): - self.new_state() - self.add_text(self.nl) - - def depart_desc_content(self, node): - self.end_state() - - def visit_figure(self, node): - self.new_state() - - def depart_figure(self, node): - self.end_state() - - def visit_caption(self, node): - pass - - def depart_caption(self, node): - pass - - def visit_productionlist(self, node): - self.new_state() - names = [] - for production in node: - names.append(production['tokenname']) - maxlen = max(len(name) for name in names) - for production in node: - if production['tokenname']: - self.add_text(production['tokenname'].ljust(maxlen) + ' ::=') - lastname = production['tokenname'] - else: - self.add_text('%s ' % (' '*len(lastname))) - self.add_text(production.astext() + self.nl) - self.end_state(wrap=False) - raise nodes.SkipNode - - def visit_seealso(self, node): - self.new_state() - - def depart_seealso(self, node): - self.end_state(first='') - - def visit_footnote(self, node): - self._footnote = node.children[0].astext().strip() - self.new_state(len(self._footnote) + 3) - - def depart_footnote(self, node): - self.end_state(first='[%s] ' % self._footnote) - - def visit_citation(self, node): - if len(node) and isinstance(node[0], nodes.label): - self._citlabel = node[0].astext() - else: - self._citlabel = '' - self.new_state(len(self._citlabel) + 3) - - def depart_citation(self, node): - self.end_state(first='[%s] ' % self._citlabel) - - def visit_label(self, node): - raise nodes.SkipNode - - # XXX: option list could use some better styling - - def visit_option_list(self, node): - pass - - def depart_option_list(self, node): - pass - - def visit_option_list_item(self, node): - self.new_state(0) - - def depart_option_list_item(self, node): - self.end_state() - - def visit_option_group(self, node): - self._firstoption = True - - def depart_option_group(self, node): - self.add_text(' ') - - def visit_option(self, node): - if self._firstoption: - self._firstoption = False - else: - self.add_text(', ') - - def depart_option(self, node): - pass - - def visit_option_string(self, node): - pass - - def depart_option_string(self, node): - pass - - def visit_option_argument(self, node): - self.add_text(node['delimiter']) - - def depart_option_argument(self, node): - pass - - def visit_description(self, node): - pass - - def depart_description(self, node): - pass - - def visit_tabular_col_spec(self, node): - raise nodes.SkipNode - - def visit_colspec(self, node): - self.table[0].append(node['colwidth']) - raise nodes.SkipNode - - def visit_tgroup(self, node): - pass - - def depart_tgroup(self, node): - pass - - def visit_thead(self, node): - pass - - def depart_thead(self, node): - pass - - def visit_tbody(self, node): - self.table.append('sep') - - def depart_tbody(self, node): - pass - - def visit_row(self, node): - self.table.append([]) - - def depart_row(self, node): - pass - - def visit_entry(self, node): - if 'morerows' in node or 'morecols' in node: - raise NotImplementedError('Column or row spanning cells are ' - 'not implemented.') - self.new_state(0) - - def depart_entry(self, node): - text = self.nl.join(self.nl.join(x[1]) for x in self.states.pop()) - self.stateindent.pop() - self.table[-1].append(text) - - def visit_table(self, node): - if self.table: - raise NotImplementedError('Nested tables are not supported.') - self.new_state(0) - self.table = [[]] - - def depart_table(self, node): - lines = self.table[1:] - fmted_rows = [] - colwidths = self.table[0] - realwidths = colwidths[:] - separator = 0 - # don't allow paragraphs in table cells for now - for line in lines: - if line == 'sep': - separator = len(fmted_rows) - else: - cells = [] - for i, cell in enumerate(line): - par = my_wrap(cell, width=colwidths[i]) - if par: - maxwidth = max(map(len, par)) - else: - maxwidth = 0 - realwidths[i] = max(realwidths[i], maxwidth) - cells.append(par) - fmted_rows.append(cells) - - def writesep(char='-'): - out = ['+'] - for width in realwidths: - out.append(char * (width+2)) - out.append('+') - self.add_text(''.join(out) + self.nl) - - def writerow(row): - lines = zip(*row) - for line in lines: - out = ['|'] - for i, cell in enumerate(line): - if cell: - out.append(' ' + cell.ljust(realwidths[i]+1)) - else: - out.append(' ' * (realwidths[i] + 2)) - out.append('|') - self.add_text(''.join(out) + self.nl) - - for i, row in enumerate(fmted_rows): - if separator and i == separator: - writesep('=') - else: - writesep('-') - writerow(row) - writesep('-') - self.table = None - self.end_state(wrap=False) - - def visit_acks(self, node): - self.new_state(0) - self.add_text( - ', '.join(n.astext() for n in node.children[0].children) + '.') - self.end_state() - raise nodes.SkipNode - - def visit_image(self, node): - if 'alt' in node.attributes: - self.add_text(_('[image: %s]') % node['alt']) - self.add_text(_('[image]')) - raise nodes.SkipNode - - def visit_transition(self, node): - indent = sum(self.stateindent) - self.new_state(0) - self.add_text('=' * (MAXWIDTH - indent)) - self.end_state() - raise nodes.SkipNode - - def visit_bullet_list(self, node): - self.list_counter.append(-1) - - def depart_bullet_list(self, node): - self.list_counter.pop() - - def visit_enumerated_list(self, node): - self.list_counter.append(0) - - def depart_enumerated_list(self, node): - self.list_counter.pop() - - def visit_definition_list(self, node): - self.list_counter.append(-2) - - def depart_definition_list(self, node): - self.list_counter.pop() - - def visit_list_item(self, node): - if self.list_counter[-1] == -1: - # bullet list - self.new_state(2) - elif self.list_counter[-1] == -2: - # definition list - pass - else: - # enumerated list - self.list_counter[-1] += 1 - self.new_state(len(str(self.list_counter[-1])) + 2) - - def depart_list_item(self, node): - if self.list_counter[-1] == -1: - self.end_state(first='* ', end=None) - elif self.list_counter[-1] == -2: - pass - else: - self.end_state(first='%s. ' % self.list_counter[-1], end=None) - - def visit_definition_list_item(self, node): - self._li_has_classifier = len(node) >= 2 and \ - isinstance(node[1], nodes.classifier) - - def depart_definition_list_item(self, node): - pass - - def visit_term(self, node): - self.new_state(0) - - def depart_term(self, node): - if not self._li_has_classifier: - self.end_state(end=None) - - def visit_termsep(self, node): - self.add_text(', ') - raise nodes.SkipNode - - def visit_classifier(self, node): - self.add_text(' : ') - - def depart_classifier(self, node): - self.end_state(end=None) - - def visit_definition(self, node): - self.new_state() - - def depart_definition(self, node): - self.end_state() - - def visit_field_list(self, node): - pass - - def depart_field_list(self, node): - pass - - def visit_field(self, node): - pass - - def depart_field(self, node): - pass - - def visit_field_name(self, node): - self.new_state(0) - - def depart_field_name(self, node): - self.add_text(':') - self.end_state(end=None) - - def visit_field_body(self, node): - self.new_state() - - def depart_field_body(self, node): - self.end_state() - - def visit_centered(self, node): - pass - - def depart_centered(self, node): - pass - - def visit_hlist(self, node): - pass - - def depart_hlist(self, node): - pass - - def visit_hlistcol(self, node): - pass - - def depart_hlistcol(self, node): - pass - - def visit_admonition(self, node): - self.new_state(0) - - def depart_admonition(self, node): - self.end_state() - - def visit_versionmodified(self, node): - self.new_state(0) - - def depart_versionmodified(self, node): - self.end_state() - - def visit_literal_block(self, node): - self.new_state() - - def depart_literal_block(self, node): - self.end_state(wrap=False) - - def visit_doctest_block(self, node): - self.new_state(0) - - def depart_doctest_block(self, node): - self.end_state(wrap=False) - - def visit_line_block(self, node): - self.new_state(0) - - def depart_line_block(self, node): - self.end_state(wrap=False) - - def visit_line(self, node): - pass - - def depart_line(self, node): - pass - - def visit_block_quote(self, node): - self.new_state() - - def depart_block_quote(self, node): - self.end_state() - - def visit_compact_paragraph(self, node): - pass - - def depart_compact_paragraph(self, node): - pass - - def visit_paragraph(self, node): - self.new_state(0) - - def depart_paragraph(self, node): - self.end_state() - - def visit_target(self, node): - raise nodes.SkipNode - - def visit_index(self, node): - raise nodes.SkipNode - - def visit_substitution_definition(self, node): - raise nodes.SkipNode - - def visit_pending_xref(self, node): - pass - - def depart_pending_xref(self, node): - pass - - def visit_reference(self, node): - pass - - def depart_reference(self, node): - pass - - def visit_download_reference(self, node): - pass - - def depart_download_reference(self, node): - pass - - def visit_emphasis(self, node): - self.add_text('*') - - def depart_emphasis(self, node): - self.add_text('*') - - def visit_literal_emphasis(self, node): - self.add_text('*') - - def depart_literal_emphasis(self, node): - self.add_text('*') - - def visit_strong(self, node): - self.add_text('**') - - def depart_strong(self, node): - self.add_text('**') - - def visit_abbreviation(self, node): - self.add_text('') - - def depart_abbreviation(self, node): - if node.hasattr('explanation'): - self.add_text(' (%s)' % node['explanation']) - - def visit_title_reference(self, node): - self.add_text('*') - - def depart_title_reference(self, node): - self.add_text('*') - - def visit_literal(self, node): - self.add_text('"') - - def depart_literal(self, node): - self.add_text('"') - - def visit_subscript(self, node): - self.add_text('_') - - def depart_subscript(self, node): - pass - - def visit_superscript(self, node): - self.add_text('^') - - def depart_superscript(self, node): - pass - - def visit_footnote_reference(self, node): - self.add_text('[%s]' % node.astext()) - raise nodes.SkipNode - - def visit_citation_reference(self, node): - self.add_text('[%s]' % node.astext()) - raise nodes.SkipNode - - def visit_Text(self, node): - self.add_text(node.astext()) - - def depart_Text(self, node): - pass - - def visit_generated(self, node): - pass - - def depart_generated(self, node): - pass - - def visit_inline(self, node): - pass - - def depart_inline(self, node): - pass - - def visit_problematic(self, node): - self.add_text('>>') - - def depart_problematic(self, node): - self.add_text('<<') - - def visit_system_message(self, node): - self.new_state(0) - self.add_text('' % node.astext()) - self.end_state() - raise nodes.SkipNode - - def visit_comment(self, node): - raise nodes.SkipNode - - def visit_meta(self, node): - # only valid for HTML - raise nodes.SkipNode - - def visit_raw(self, node): - if 'text' in node.get('format', '').split(): - self.body.append(node.astext()) - raise nodes.SkipNode - - def _visit_admonition(self, node): - self.new_state(2) - - def _make_depart_admonition(name): - def depart_admonition(self, node): - self.end_state(first=name.capitalize() + ': ') - return depart_admonition - - visit_attention = _visit_admonition - depart_attention = _make_depart_admonition('attention') - visit_caution = _visit_admonition - depart_caution = _make_depart_admonition('caution') - visit_danger = _visit_admonition - depart_danger = _make_depart_admonition('danger') - visit_error = _visit_admonition - depart_error = _make_depart_admonition('error') - visit_hint = _visit_admonition - depart_hint = _make_depart_admonition('hint') - visit_important = _visit_admonition - depart_important = _make_depart_admonition('important') - visit_note = _visit_admonition - depart_note = _make_depart_admonition('note') - visit_tip = _visit_admonition - depart_tip = _make_depart_admonition('tip') - visit_warning = _visit_admonition - depart_warning = _make_depart_admonition('warning') - - def unknown_visit(self, node): - raise NotImplementedError('Unknown node: ' + node.__class__.__name__) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/client.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/client.py deleted file mode 100644 index f69bf1f4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/client.py +++ /dev/null @@ -1,113 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import inspect - -from botocore.docs.utils import get_official_service_name -from botocore.docs.method import document_custom_method -from botocore.docs.method import document_model_driven_method -from botocore.docs.method import get_instance_public_methods -from botocore.docs.sharedexample import document_shared_examples - - -class ClientDocumenter(object): - def __init__(self, client, shared_examples=None): - self._client = client - self._shared_examples = shared_examples - if self._shared_examples is None: - self._shared_examples = {} - self._service_name = self._client.meta.service_model.service_name - - def document_client(self, section): - """Documents a client and its methods - - :param section: The section to write to. - """ - self._add_title(section) - self._add_class_signature(section) - client_methods = get_instance_public_methods(self._client) - self._add_client_intro(section, client_methods) - self._add_client_methods(section, client_methods) - - def _add_title(self, section): - section.style.h2('Client') - - def _add_client_intro(self, section, client_methods): - section = section.add_new_section('intro') - # Write out the top level description for the client. - official_service_name = get_official_service_name( - self._client.meta.service_model) - section.write( - 'A low-level client representing %s' % official_service_name) - - # Write out the client example instantiation. - self._add_client_creation_example(section) - - # List out all of the possible client methods. - section.style.new_line() - section.write('These are the available methods:') - section.style.new_line() - class_name = self._client.__class__.__name__ - for method_name in sorted(client_methods): - section.style.li(':py:meth:`~%s.Client.%s`' % ( - class_name, method_name)) - - def _add_class_signature(self, section): - section.style.start_sphinx_py_class( - class_name='%s.Client' % self._client.__class__.__name__) - - def _add_client_creation_example(self, section): - section.style.start_codeblock() - section.style.new_line() - section.write( - 'client = session.create_client(\'{service}\')'.format( - service=self._service_name) - ) - section.style.end_codeblock() - - def _add_client_methods(self, section, client_methods): - section = section.add_new_section('methods') - for method_name in sorted(client_methods): - self._add_client_method( - section, method_name, client_methods[method_name]) - - def _add_client_method(self, section, method_name, method): - section = section.add_new_section(method_name) - if self._is_custom_method(method_name): - self._add_custom_method(section, method_name, method) - else: - self._add_model_driven_method(section, method_name) - - def _is_custom_method(self, method_name): - return method_name not in self._client.meta.method_to_api_mapping - - def _add_custom_method(self, section, method_name, method): - document_custom_method(section, method_name, method) - - def _add_model_driven_method(self, section, method_name): - service_model = self._client.meta.service_model - operation_name = self._client.meta.method_to_api_mapping[method_name] - operation_model = service_model.operation_model(operation_name) - - example_prefix = 'response = client.%s' % method_name - document_model_driven_method( - section, method_name, operation_model, - event_emitter=self._client.meta.events, - method_description=operation_model.documentation, - example_prefix=example_prefix, - ) - - # Add the shared examples - shared_examples = self._shared_examples.get(operation_name) - if shared_examples: - document_shared_examples( - section, operation_model, example_prefix, shared_examples) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/docstring.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/docstring.py deleted file mode 100644 index 33c68932..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/docstring.py +++ /dev/null @@ -1,96 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.method import document_model_driven_method -from botocore.docs.waiter import document_wait_method -from botocore.docs.paginator import document_paginate_method -from botocore.docs.bcdoc.restdoc import DocumentStructure - - -class LazyLoadedDocstring(str): - """Used for lazily loading docstrings - - You can instantiate this class and assign it to a __doc__ value. - The docstring will not be generated till accessed via __doc__ or - help(). Note that all docstring classes **must** subclass from - this class. It cannot be used directly as a docstring. - """ - def __init__(self, *args, **kwargs): - """ - The args and kwargs are the same as the underlying document - generation function. These just get proxied to the underlying - function. - """ - super(LazyLoadedDocstring, self).__init__() - self._gen_args = args - self._gen_kwargs = kwargs - self._docstring = None - - def __new__(cls, *args, **kwargs): - # Needed in order to sub class from str with args and kwargs - return super(LazyLoadedDocstring, cls).__new__(cls) - - def _write_docstring(self, *args, **kwargs): - raise NotImplementedError( - '_write_docstring is not implemented. Please subclass from ' - 'this class and provide your own _write_docstring method' - ) - - def expandtabs(self, tabsize=8): - """Expands tabs to spaces - - So this is a big hack in order to get lazy loaded docstring work - for the ``help()``. In the ``help()`` function, ``pydoc`` and - ``inspect`` are used. At some point the ``inspect.cleandoc`` - method is called. To clean the docs ``expandtabs`` is called - and that is where we override the method to generate and return the - docstrings. - """ - if self._docstring is None: - self._generate() - return self._docstring.expandtabs(tabsize) - - def __str__(self): - return self._generate() - - # __doc__ of target will use either __repr__ or __str__ of this class. - __repr__ = __str__ - - def _generate(self): - # Generate the docstring if it is not already cached. - if self._docstring is None: - self._docstring = self._create_docstring() - return self._docstring - - def _create_docstring(self): - docstring_structure = DocumentStructure('docstring', target='html') - # Call the document method function with the args and kwargs - # passed to the class. - self._write_docstring( - docstring_structure, *self._gen_args, - **self._gen_kwargs) - return docstring_structure.flush_structure().decode('utf-8') - - -class ClientMethodDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_model_driven_method(*args, **kwargs) - - -class WaiterDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_wait_method(*args, **kwargs) - - -class PaginatorDocstring(LazyLoadedDocstring): - def _write_docstring(self, *args, **kwargs): - document_paginate_method(*args, **kwargs) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/example.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/example.py deleted file mode 100644 index c0f6bbb6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/example.py +++ /dev/null @@ -1,208 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.shape import ShapeDocumenter -from botocore.docs.utils import py_default - - -class BaseExampleDocumenter(ShapeDocumenter): - def document_example(self, section, shape, prefix=None, include=None, - exclude=None): - """Generates an example based on a shape - - :param section: The section to write the documentation to. - - :param shape: The shape of the operation. - - :param prefix: Anything to be included before the example - - :type include: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include: The parameter shapes to include in the documentation. - - :type exclude: List of the names of the parameters to exclude. - :param exclude: The names of the parameters to exclude from - documentation. - """ - history = [] - section.style.new_line() - section.style.start_codeblock() - if prefix is not None: - section.write(prefix) - self.traverse_and_document_shape( - section=section, shape=shape, history=history, - include=include, exclude=exclude) - - def document_recursive_shape(self, section, shape, **kwargs): - section.write('{\'... recursive ...\'}') - - def document_shape_default(self, section, shape, history, include=None, - exclude=None, **kwargs): - py_type = self._get_special_py_default(shape) - if py_type is None: - py_type = py_default(shape.type_name) - - if self._context.get('streaming_shape') == shape: - py_type = 'StreamingBody()' - section.write(py_type) - - def document_shape_type_string(self, section, shape, history, - include=None, exclude=None, **kwargs): - if 'enum' in shape.metadata: - for i, enum in enumerate(shape.metadata['enum']): - section.write('\'%s\'' % enum) - if i < len(shape.metadata['enum']) - 1: - section.write('|') - else: - self.document_shape_default(section, shape, history) - - def document_shape_type_list(self, section, shape, history, include=None, - exclude=None, **kwargs): - param_shape = shape.member - list_section = section.add_new_section('list-value') - self._start_nested_param(list_section, '[') - param_section = list_section.add_new_section( - 'member', context={'shape': param_shape.name}) - self.traverse_and_document_shape( - section=param_section, shape=param_shape, history=history) - ending_comma_section = list_section.add_new_section('ending-comma') - ending_comma_section.write(',') - ending_bracket_section = list_section.add_new_section( - 'ending-bracket') - self._end_nested_param(ending_bracket_section, ']') - - def document_shape_type_structure(self, section, shape, history, - include=None, exclude=None, **kwargs): - if not shape.members: - section.write('{}') - return - - section = section.add_new_section('structure-value') - self._start_nested_param(section, '{') - - input_members = self._add_members_to_shape(shape.members, include) - - for i, param in enumerate(input_members): - if exclude and param in exclude: - continue - param_section = section.add_new_section(param) - param_section.write('\'%s\': ' % param) - param_shape = input_members[param] - param_value_section = param_section.add_new_section( - 'member-value', context={'shape': param_shape.name}) - self.traverse_and_document_shape( - section=param_value_section, shape=param_shape, - history=history, name=param) - if i < len(input_members) - 1: - ending_comma_section = param_section.add_new_section( - 'ending-comma') - ending_comma_section.write(',') - ending_comma_section.style.new_line() - self._end_structure(section, '{', '}') - - def document_shape_type_map(self, section, shape, history, - include=None, exclude=None, **kwargs): - map_section = section.add_new_section('map-value') - self._start_nested_param(map_section, '{') - value_shape = shape.value - key_section = map_section.add_new_section( - 'key', context={'shape': shape.key.name}) - key_section.write('\'string\': ') - value_section = map_section.add_new_section( - 'value', context={'shape': value_shape.name}) - self.traverse_and_document_shape( - section=value_section, shape=value_shape, history=history) - end_bracket_section = map_section.add_new_section('ending-bracket') - self._end_nested_param(end_bracket_section, '}') - - def _add_members_to_shape(self, members, include): - if include: - members = members.copy() - for param in include: - members[param.name] = param - return members - - def _start_nested_param(self, section, start=None): - if start is not None: - section.write(start) - section.style.indent() - section.style.indent() - section.style.new_line() - - def _end_nested_param(self, section, end=None): - section.style.dedent() - section.style.dedent() - section.style.new_line() - if end is not None: - section.write(end) - - def _end_structure(self, section, start, end): - # If there are no members in the strucuture, then make sure the - # start and the end bracket are on the same line, by removing all - # previous text and writing the start and end. - if not section.available_sections: - section.clear_text() - section.write(start + end) - self._end_nested_param(section) - else: - end_bracket_section = section.add_new_section('ending-bracket') - self._end_nested_param(end_bracket_section, end) - - -class ResponseExampleDocumenter(BaseExampleDocumenter): - EVENT_NAME = 'response-example' - - def document_shape_type_event_stream(self, section, shape, history, - **kwargs): - section.write('EventStream(') - self.document_shape_type_structure(section, shape, history, **kwargs) - end_section = section.add_new_section('event-stream-end') - end_section.write(')') - - -class RequestExampleDocumenter(BaseExampleDocumenter): - EVENT_NAME = 'request-example' - - def document_shape_type_structure(self, section, shape, history, - include=None, exclude=None, **kwargs): - param_format = '\'%s\'' - operator = ': ' - start = '{' - end = '}' - - if len(history) <= 1: - operator = '=' - start = '(' - end = ')' - param_format = '%s' - section = section.add_new_section('structure-value') - self._start_nested_param(section, start) - input_members = self._add_members_to_shape(shape.members, include) - - for i, param in enumerate(input_members): - if exclude and param in exclude: - continue - param_section = section.add_new_section(param) - param_section.write(param_format % param) - param_section.write(operator) - param_shape = input_members[param] - param_value_section = param_section.add_new_section( - 'member-value', context={'shape': param_shape.name}) - self.traverse_and_document_shape( - section=param_value_section, shape=param_shape, - history=history, name=param) - if i < len(input_members) - 1: - ending_comma_section = param_section.add_new_section( - 'ending-comma') - ending_comma_section.write(',') - ending_comma_section.style.new_line() - self._end_structure(section, start, end) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/method.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/method.py deleted file mode 100644 index 856a7a21..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/method.py +++ /dev/null @@ -1,282 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import inspect - -from botocore.docs.params import RequestParamsDocumenter -from botocore.docs.params import ResponseParamsDocumenter -from botocore.docs.example import ResponseExampleDocumenter -from botocore.docs.example import RequestExampleDocumenter - - -AWS_DOC_BASE = 'https://docs.aws.amazon.com/goto/WebAPI' - - -def get_instance_public_methods(instance): - """Retrieves an objects public methods - - :param instance: The instance of the class to inspect - :rtype: dict - :returns: A dictionary that represents an instance's methods where - the keys are the name of the methods and the - values are the handler to the method. - """ - instance_members = inspect.getmembers(instance) - instance_methods = {} - for name, member in instance_members: - if not name.startswith('_'): - if inspect.ismethod(member): - instance_methods[name] = member - return instance_methods - - -def document_model_driven_signature(section, name, operation_model, - include=None, exclude=None): - """Documents the signature of a model-driven method - - :param section: The section to write the documentation to. - - :param name: The name of the method - - :param operation_model: The operation model for the method - - :type include: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include: The parameter shapes to include in the documentation. - - :type exclude: List of the names of the parameters to exclude. - :param exclude: The names of the parameters to exclude from - documentation. - """ - params = {} - if operation_model.input_shape: - params = operation_model.input_shape.members - - parameter_names = list(params.keys()) - - if include is not None: - for member in include: - parameter_names.append(member.name) - - if exclude is not None: - for member in exclude: - if member in parameter_names: - parameter_names.remove(member) - - signature_params = '' - if parameter_names: - signature_params = '**kwargs' - section.style.start_sphinx_py_method(name, signature_params) - - -def document_custom_signature(section, name, method, - include=None, exclude=None): - """Documents the signature of a custom method - - :param section: The section to write the documentation to. - - :param name: The name of the method - - :param method: The handle to the method being documented - - :type include: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include: The parameter shapes to include in the documentation. - - :type exclude: List of the names of the parameters to exclude. - :param exclude: The names of the parameters to exclude from - documentation. - """ - args, varargs, keywords, defaults = inspect.getargspec(method) - args = args[1:] - signature_params = inspect.formatargspec( - args, varargs, keywords, defaults) - signature_params = signature_params.lstrip('(') - signature_params = signature_params.rstrip(')') - section.style.start_sphinx_py_method(name, signature_params) - - -def document_custom_method(section, method_name, method): - """Documents a non-data driven method - - :param section: The section to write the documentation to. - - :param method_name: The name of the method - - :param method: The handle to the method being documented - """ - document_custom_signature( - section, method_name, method) - method_intro_section = section.add_new_section('method-intro') - method_intro_section.writeln('') - doc_string = inspect.getdoc(method) - if doc_string is not None: - method_intro_section.style.write_py_doc_string(doc_string) - - -def document_model_driven_method(section, method_name, operation_model, - event_emitter, method_description=None, - example_prefix=None, include_input=None, - include_output=None, exclude_input=None, - exclude_output=None, document_output=True, - include_signature=True): - """Documents an individual method - - :param section: The section to write to - - :param method_name: The name of the method - - :param operation_model: The model of the operation - - :param event_emitter: The event emitter to use to emit events - - :param example_prefix: The prefix to use in the method example. - - :type include_input: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include_input: The parameter shapes to include in the - input documentation. - - :type include_output: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include_input: The parameter shapes to include in the - output documentation. - - :type exclude_input: List of the names of the parameters to exclude. - :param exclude_input: The names of the parameters to exclude from - input documentation. - - :type exclude_output: List of the names of the parameters to exclude. - :param exclude_input: The names of the parameters to exclude from - output documentation. - - :param document_output: A boolean flag to indicate whether to - document the output. - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - # Add the signature if specified. - if include_signature: - document_model_driven_signature( - section, method_name, operation_model, include=include_input, - exclude=exclude_input) - - # Add the description for the method. - method_intro_section = section.add_new_section('method-intro') - method_intro_section.include_doc_string(method_description) - if operation_model.deprecated: - method_intro_section.style.start_danger() - method_intro_section.writeln( - 'This operation is deprecated and may not function as ' - 'expected. This operation should not be used going forward ' - 'and is only kept for the purpose of backwards compatiblity.') - method_intro_section.style.end_danger() - service_uid = operation_model.service_model.metadata.get('uid') - if service_uid is not None: - method_intro_section.style.new_paragraph() - method_intro_section.write("See also: ") - link = '%s/%s/%s' % (AWS_DOC_BASE, service_uid, - operation_model.name) - method_intro_section.style.external_link(title="AWS API Documentation", - link=link) - method_intro_section.writeln('') - - # Add the example section. - example_section = section.add_new_section('example') - example_section.style.new_paragraph() - example_section.style.bold('Request Syntax') - - context = { - 'special_shape_types': { - 'streaming_input_shape': operation_model.get_streaming_input(), - 'streaming_output_shape': operation_model.get_streaming_output(), - 'eventstream_output_shape': operation_model.get_event_stream_output(), - }, - } - - if operation_model.input_shape: - RequestExampleDocumenter( - service_name=operation_model.service_model.service_name, - operation_name=operation_model.name, - event_emitter=event_emitter, context=context).document_example( - example_section, operation_model.input_shape, - prefix=example_prefix, include=include_input, - exclude=exclude_input) - else: - example_section.style.new_paragraph() - example_section.style.start_codeblock() - example_section.write(example_prefix + '()') - - # Add the request parameter documentation. - request_params_section = section.add_new_section('request-params') - if operation_model.input_shape: - RequestParamsDocumenter( - service_name=operation_model.service_model.service_name, - operation_name=operation_model.name, - event_emitter=event_emitter, context=context).document_params( - request_params_section, operation_model.input_shape, - include=include_input, exclude=exclude_input) - - # Add the return value documentation - return_section = section.add_new_section('return') - return_section.style.new_line() - if operation_model.output_shape is not None and document_output: - return_section.write(':rtype: dict') - return_section.style.new_line() - return_section.write(':returns: ') - return_section.style.indent() - return_section.style.new_line() - - # If the operation is an event stream, describe the tagged union - event_stream_output = operation_model.get_event_stream_output() - if event_stream_output: - event_section = return_section.add_new_section('event-stream') - event_section.style.new_paragraph() - event_section.write( - 'The response of this operation contains an ' - ':class:`.EventStream` member. When iterated the ' - ':class:`.EventStream` will yield events based on the ' - 'structure below, where only one of the top level keys ' - 'will be present for any given event.' - ) - event_section.style.new_line() - - # Add an example return value - return_example_section = return_section.add_new_section('example') - return_example_section.style.new_line() - return_example_section.style.bold('Response Syntax') - return_example_section.style.new_paragraph() - ResponseExampleDocumenter( - service_name=operation_model.service_model.service_name, - operation_name=operation_model.name, - event_emitter=event_emitter, - context=context).document_example( - return_example_section, operation_model.output_shape, - include=include_output, exclude=exclude_output) - - # Add a description for the return value - return_description_section = return_section.add_new_section( - 'description') - return_description_section.style.new_line() - return_description_section.style.bold('Response Structure') - return_description_section.style.new_paragraph() - ResponseParamsDocumenter( - service_name=operation_model.service_model.service_name, - operation_name=operation_model.name, - event_emitter=event_emitter, - context=context).document_params( - return_description_section, operation_model.output_shape, - include=include_output, exclude=exclude_output) - else: - return_section.write(':returns: None') - diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/paginator.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/paginator.py deleted file mode 100644 index 13e0bb22..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/paginator.py +++ /dev/null @@ -1,176 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.compat import OrderedDict -from botocore.docs.utils import DocumentedShape -from botocore.utils import get_service_module_name -from botocore.docs.method import document_model_driven_method - - -class PaginatorDocumenter(object): - def __init__(self, client, service_paginator_model): - self._client = client - self._service_name = self._client.meta.service_model.service_name - self._service_paginator_model = service_paginator_model - - def document_paginators(self, section): - """Documents the various paginators for a service - - param section: The section to write to. - """ - section.style.h2('Paginators') - section.style.new_line() - section.writeln('The available paginators are:') - - paginator_names = sorted( - self._service_paginator_model._paginator_config) - - # List the available paginators and then document each paginator. - for paginator_name in paginator_names: - section.style.li( - ':py:class:`%s.Paginator.%s`' % ( - self._client.__class__.__name__, paginator_name)) - self._add_paginator(section, paginator_name) - - def _add_paginator(self, section, paginator_name): - section = section.add_new_section(paginator_name) - - # Docment the paginator class - section.style.start_sphinx_py_class( - class_name='%s.Paginator.%s' % ( - self._client.__class__.__name__, paginator_name)) - section.style.start_codeblock() - section.style.new_line() - - # Document how to instantiate the paginator. - section.write( - 'paginator = client.get_paginator(\'%s\')' % xform_name( - paginator_name) - ) - section.style.end_codeblock() - section.style.new_line() - # Get the pagination model for the particular paginator. - paginator_config = self._service_paginator_model.get_paginator( - paginator_name) - document_paginate_method( - section=section, - paginator_name=paginator_name, - event_emitter=self._client.meta.events, - service_model=self._client.meta.service_model, - paginator_config=paginator_config - ) - - -def document_paginate_method(section, paginator_name, event_emitter, - service_model, paginator_config, - include_signature=True): - """Documents the paginate method of a paginator - - :param section: The section to write to - - :param paginator_name: The name of the paginator. It is snake cased. - - :param event_emitter: The event emitter to use to emit events - - :param service_model: The service model - - :param paginator_config: The paginator config associated to a particular - paginator. - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - # Retrieve the operation model of the underlying operation. - operation_model = service_model.operation_model( - paginator_name) - - # Add representations of the request and response parameters - # we want to include in the description of the paginate method. - # These are parameters we expose via the botocore interface. - pagination_config_members = OrderedDict() - - pagination_config_members['MaxItems'] = DocumentedShape( - name='MaxItems', type_name='integer', - documentation=( - '

The total number of items to return. If the total ' - 'number of items available is more than the value ' - 'specified in max-items then a NextToken ' - 'will be provided in the output that you can use to ' - 'resume pagination.

')) - - pagination_config_members['PageSize'] = DocumentedShape( - name='PageSize', type_name='integer', - documentation='

The size of each page.

') - - pagination_config_members['StartingToken'] = DocumentedShape( - name='StartingToken', type_name='string', - documentation=( - '

A token to specify where to start paginating. ' - 'This is the NextToken from a previous ' - 'response.

')) - - botocore_pagination_params = [ - DocumentedShape( - name='PaginationConfig', type_name='structure', - documentation=( - '

A dictionary that provides parameters to control ' - 'pagination.

'), - members=pagination_config_members) - ] - - botocore_pagination_response_params = [ - DocumentedShape( - name='NextToken', type_name='string', - documentation=( - '

A token to resume pagination.

')) - ] - - service_pagination_params = [] - - # Add the normal input token of the method to a list - # of input paramters that we wish to hide since we expose our own. - if isinstance(paginator_config['input_token'], list): - service_pagination_params += paginator_config['input_token'] - else: - service_pagination_params.append(paginator_config['input_token']) - - # Hide the limit key in the documentation. - if paginator_config.get('limit_key', None): - service_pagination_params.append(paginator_config['limit_key']) - - # Hide the output tokens in the documentation. - service_pagination_response_params = [] - if isinstance(paginator_config['output_token'], list): - service_pagination_response_params += paginator_config[ - 'output_token'] - else: - service_pagination_response_params.append(paginator_config[ - 'output_token']) - - paginate_description = ( - 'Creates an iterator that will paginate through responses ' - 'from :py:meth:`{0}.Client.{1}`.'.format( - get_service_module_name(service_model), xform_name(paginator_name)) - ) - - document_model_driven_method( - section, 'paginate', operation_model, - event_emitter=event_emitter, - method_description=paginate_description, - example_prefix='response_iterator = paginator.paginate', - include_input=botocore_pagination_params, - include_output=botocore_pagination_response_params, - exclude_input=service_pagination_params, - exclude_output=service_pagination_response_params, - include_signature=include_signature - ) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/params.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/params.py deleted file mode 100644 index 1ce4ddff..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/params.py +++ /dev/null @@ -1,220 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.docs.shape import ShapeDocumenter -from botocore.docs.utils import py_type_name - - -class BaseParamsDocumenter(ShapeDocumenter): - def document_params(self, section, shape, include=None, exclude=None): - """Fills out the documentation for a section given a model shape. - - :param section: The section to write the documentation to. - - :param shape: The shape of the operation. - - :type include: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include: The parameter shapes to include in the documentation. - - :type exclude: List of the names of the parameters to exclude. - :param exclude: The names of the parameters to exclude from - documentation. - """ - history = [] - self.traverse_and_document_shape( - section=section, shape=shape, history=history, - name=None, include=include, exclude=exclude) - - def document_recursive_shape(self, section, shape, **kwargs): - self._add_member_documentation(section, shape, **kwargs) - - def document_shape_default(self, section, shape, history, include=None, - exclude=None, **kwargs): - self._add_member_documentation(section, shape, **kwargs) - - def document_shape_type_list(self, section, shape, history, include=None, - exclude=None, **kwargs): - self._add_member_documentation(section, shape, **kwargs) - param_shape = shape.member - param_section = section.add_new_section( - param_shape.name, context={'shape': shape.member.name}) - self._start_nested_param(param_section) - self.traverse_and_document_shape( - section=param_section, shape=param_shape, - history=history, name=None) - section = section.add_new_section('end-list') - self._end_nested_param(section) - - def document_shape_type_map(self, section, shape, history, include=None, - exclude=None, **kwargs): - self._add_member_documentation(section, shape, **kwargs) - - key_section = section.add_new_section( - 'key', context={'shape': shape.key.name}) - self._start_nested_param(key_section) - self._add_member_documentation(key_section, shape.key) - - param_section = section.add_new_section( - shape.value.name, context={'shape': shape.value.name}) - param_section.style.indent() - self._start_nested_param(param_section) - self.traverse_and_document_shape( - section=param_section, shape=shape.value, - history=history, name=None) - - end_section = section.add_new_section('end-map') - self._end_nested_param(end_section) - self._end_nested_param(end_section) - - def document_shape_type_structure(self, section, shape, history, - include=None, exclude=None, - name=None, **kwargs): - members = self._add_members_to_shape(shape.members, include) - self._add_member_documentation(section, shape, name=name) - for param in members: - if exclude and param in exclude: - continue - param_shape = members[param] - param_section = section.add_new_section( - param, context={'shape': param_shape.name}) - self._start_nested_param(param_section) - self.traverse_and_document_shape( - section=param_section, shape=param_shape, - history=history, name=param) - section = section.add_new_section('end-structure') - self._end_nested_param(section) - - def _add_member_documentation(self, section, shape, **kwargs): - pass - - def _add_members_to_shape(self, members, include): - if include: - members = members.copy() - for param in include: - members[param.name] = param - return members - - def _document_non_top_level_param_type(self, type_section, shape): - special_py_type = self._get_special_py_type_name(shape) - py_type = py_type_name(shape.type_name) - - type_format = '(%s) -- ' - if special_py_type is not None: - # Special type can reference a linked class. - # Italicizing it blows away the link. - type_section.write(type_format % special_py_type) - else: - type_section.style.italics(type_format % py_type) - - def _start_nested_param(self, section): - section.style.indent() - section.style.new_line() - - def _end_nested_param(self, section): - section.style.dedent() - section.style.new_line() - - -class ResponseParamsDocumenter(BaseParamsDocumenter): - """Generates the description for the response parameters""" - - EVENT_NAME = 'response-params' - - def _add_member_documentation(self, section, shape, name=None, **kwargs): - name_section = section.add_new_section('param-name') - name_section.write('- ') - if name is not None: - name_section.style.bold('%s ' % name) - type_section = section.add_new_section('param-type') - self._document_non_top_level_param_type(type_section, shape) - - documentation_section = section.add_new_section('param-documentation') - if shape.documentation: - documentation_section.style.indent() - documentation_section.include_doc_string(shape.documentation) - section.style.new_paragraph() - - def document_shape_type_event_stream(self, section, shape, history, - **kwargs): - self.document_shape_type_structure(section, shape, history, **kwargs) - - -class RequestParamsDocumenter(BaseParamsDocumenter): - """Generates the description for the request parameters""" - - EVENT_NAME = 'request-params' - - def document_shape_type_structure(self, section, shape, history, - include=None, exclude=None, **kwargs): - if len(history) > 1: - self._add_member_documentation(section, shape, **kwargs) - section.style.indent() - members = self._add_members_to_shape(shape.members, include) - for i, param in enumerate(members): - if exclude and param in exclude: - continue - param_shape = members[param] - param_section = section.add_new_section( - param, context={'shape': param_shape.name}) - param_section.style.new_line() - is_required = param in shape.required_members - self.traverse_and_document_shape( - section=param_section, shape=param_shape, - history=history, name=param, is_required=is_required) - section = section.add_new_section('end-structure') - if len(history) > 1: - section.style.dedent() - section.style.new_line() - - def _add_member_documentation(self, section, shape, name=None, - is_top_level_param=False, is_required=False, - **kwargs): - py_type = self._get_special_py_type_name(shape) - if py_type is None: - py_type = py_type_name(shape.type_name) - if is_top_level_param: - type_section = section.add_new_section('param-type') - type_section.write(':type %s: %s' % (name, py_type)) - end_type_section = type_section.add_new_section('end-param-type') - end_type_section.style.new_line() - name_section = section.add_new_section('param-name') - name_section.write(':param %s: ' % name) - - else: - name_section = section.add_new_section('param-name') - name_section.write('- ') - if name is not None: - name_section.style.bold('%s ' % name) - type_section = section.add_new_section('param-type') - self._document_non_top_level_param_type(type_section, shape) - - if is_required: - is_required_section = section.add_new_section('is-required') - is_required_section.style.indent() - is_required_section.style.bold('[REQUIRED] ') - if shape.documentation: - documentation_section = section.add_new_section( - 'param-documentation') - documentation_section.style.indent() - documentation_section.include_doc_string(shape.documentation) - self._add_special_trait_documentation(documentation_section, shape) - end_param_section = section.add_new_section('end-param') - end_param_section.style.new_paragraph() - - def _add_special_trait_documentation(self, section, shape): - if 'idempotencyToken' in shape.metadata: - self._append_idempotency_documentation(section) - - def _append_idempotency_documentation(self, section): - docstring = 'This field is autopopulated if not provided.' - section.write(docstring) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/service.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/service.py deleted file mode 100644 index c9b5d7b3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/service.py +++ /dev/null @@ -1,90 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.exceptions import DataNotFoundError -from botocore.docs.utils import get_official_service_name -from botocore.docs.client import ClientDocumenter -from botocore.docs.waiter import WaiterDocumenter -from botocore.docs.paginator import PaginatorDocumenter -from botocore.docs.bcdoc.restdoc import DocumentStructure - - -class ServiceDocumenter(object): - def __init__(self, service_name, session): - self._session = session - self._service_name = service_name - - self._client = self._session.create_client( - service_name, region_name='us-east-1', aws_access_key_id='foo', - aws_secret_access_key='bar') - - self.sections = [ - 'title', - 'table-of-contents', - 'client-api', - 'paginator-api', - 'waiter-api' - ] - - def document_service(self): - """Documents an entire service. - - :returns: The reStructured text of the documented service. - """ - doc_structure = DocumentStructure( - self._service_name, section_names=self.sections, - target='html') - self.title(doc_structure.get_section('title')) - self.table_of_contents(doc_structure.get_section('table-of-contents')) - self.client_api(doc_structure.get_section('client-api')) - self.paginator_api(doc_structure.get_section('paginator-api')) - self.waiter_api(doc_structure.get_section('waiter-api')) - return doc_structure.flush_structure() - - def title(self, section): - section.style.h1(self._client.__class__.__name__) - - def table_of_contents(self, section): - section.style.table_of_contents(title='Table of Contents', depth=2) - - def client_api(self, section): - examples = None - try: - examples = self.get_examples(self._service_name) - except DataNotFoundError: - pass - - ClientDocumenter(self._client, examples).document_client(section) - - def paginator_api(self, section): - try: - service_paginator_model = self._session.get_paginator_model( - self._service_name) - except DataNotFoundError: - return - paginator_documenter = PaginatorDocumenter( - self._client, service_paginator_model) - paginator_documenter.document_paginators(section) - - def waiter_api(self, section): - if self._client.waiter_names: - service_waiter_model = self._session.get_waiter_model( - self._service_name) - waiter_documenter = WaiterDocumenter( - self._client, service_waiter_model) - waiter_documenter.document_waiters(section) - - def get_examples(self, service_name, api_version=None): - loader = self._session.get_component('data_loader') - examples = loader.load_service_model( - service_name, 'examples-1', api_version) - return examples['examples'] diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/shape.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/shape.py deleted file mode 100644 index c1886166..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/shape.py +++ /dev/null @@ -1,117 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - - -# NOTE: This class should not be instantiated and its -# ``traverse_and_document_shape`` method called directly. It should be -# inherited from a Documenter class with the appropriate methods -# and attributes. -from botocore.utils import is_json_value_header - - -class ShapeDocumenter(object): - EVENT_NAME = '' - - def __init__(self, service_name, operation_name, event_emitter, - context=None): - self._service_name = service_name - self._operation_name = operation_name - self._event_emitter = event_emitter - self._context = context - if context is None: - self._context = { - 'special_shape_types': {} - } - - def traverse_and_document_shape(self, section, shape, history, - include=None, exclude=None, name=None, - is_required=False): - """Traverses and documents a shape - - Will take a self class and call its appropriate methods as a shape - is traversed. - - :param section: The section to document. - - :param history: A list of the names of the shapes that have been - traversed. - - :type include: Dictionary where keys are parameter names and - values are the shapes of the parameter names. - :param include: The parameter shapes to include in the documentation. - - :type exclude: List of the names of the parameters to exclude. - :param exclude: The names of the parameters to exclude from - documentation. - - :param name: The name of the shape. - - :param is_required: If the shape is a required member. - """ - param_type = shape.type_name - if getattr(shape, 'serialization', {}).get('eventstream'): - param_type = 'event_stream' - if shape.name in history: - self.document_recursive_shape(section, shape, name=name) - else: - history.append(shape.name) - is_top_level_param = (len(history) == 2) - getattr(self, 'document_shape_type_%s' % param_type, - self.document_shape_default)( - section, shape, history=history, name=name, - include=include, exclude=exclude, - is_top_level_param=is_top_level_param, - is_required=is_required) - if is_top_level_param: - self._event_emitter.emit( - 'docs.%s.%s.%s.%s' % (self.EVENT_NAME, - self._service_name, - self._operation_name, - name), - section=section) - at_overlying_method_section = (len(history) == 1) - if at_overlying_method_section: - self._event_emitter.emit( - 'docs.%s.%s.%s.complete-section' % (self.EVENT_NAME, - self._service_name, - self._operation_name), - section=section) - history.pop() - - def _get_special_py_default(self, shape): - special_defaults = { - 'jsonvalue_header': '{...}|[...]|123|123.4|\'string\'|True|None', - 'streaming_input_shape': 'b\'bytes\'|file', - 'streaming_output_shape': 'StreamingBody()', - 'eventstream_output_shape': 'EventStream()', - } - return self._get_value_for_special_type(shape, special_defaults) - - def _get_special_py_type_name(self, shape): - special_type_names = { - 'jsonvalue_header': 'JSON serializable', - 'streaming_input_shape': 'bytes or seekable file-like object', - 'streaming_output_shape': ':class:`.StreamingBody`', - 'eventstream_output_shape': ':class:`.EventStream`', - } - return self._get_value_for_special_type(shape, special_type_names) - - def _get_value_for_special_type(self, shape, special_type_map): - if is_json_value_header(shape): - return special_type_map['jsonvalue_header'] - for special_type, marked_shape in self._context[ - 'special_shape_types'].items(): - if special_type in special_type_map: - if shape == marked_shape: - return special_type_map[special_type] - return None diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/sharedexample.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/sharedexample.py deleted file mode 100644 index 1a31b6e4..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/sharedexample.py +++ /dev/null @@ -1,223 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import re -import numbers -from botocore.utils import parse_timestamp -from botocore.docs.utils import escape_controls -from botocore.compat import six - - -class SharedExampleDocumenter(object): - def document_shared_example(self, example, prefix, section, - operation_model): - """Documents a single shared example based on its definition. - - :param example: The model of the example - - :param prefix: The prefix to use in the method example. - - :param section: The section to write to. - - :param operation_model: The model of the operation used in the example - """ - section.style.new_paragraph() - section.write(example.get('description')) - section.style.new_line() - self.document_input(section, example, prefix, - operation_model.input_shape) - self.document_output(section, example, operation_model.output_shape) - - def document_input(self, section, example, prefix, shape): - input_section = section.add_new_section('input') - input_section.style.start_codeblock() - if prefix is not None: - input_section.write(prefix) - params = example.get('input', {}) - comments = example.get('comments') - if comments: - comments = comments.get('input') - param_section = input_section.add_new_section('parameters') - self._document_params(param_section, params, comments, [], shape) - closing_section = input_section.add_new_section('input-close') - closing_section.style.new_line() - closing_section.style.new_line() - closing_section.write('print(response)') - closing_section.style.end_codeblock() - - def document_output(self, section, example, shape): - output_section = section.add_new_section('output') - output_section.style.new_line() - output_section.write('Expected Output:') - output_section.style.new_line() - output_section.style.start_codeblock() - params = example.get('output', {}) - - # There might not be an output, but we will return metadata anyway - params['ResponseMetadata'] = {"...": "..."} - comments = example.get('comments') - if comments: - comments = comments.get('output') - self._document_dict(output_section, params, comments, [], shape, True) - closing_section = output_section.add_new_section('output-close') - closing_section.style.end_codeblock() - - def _document(self, section, value, comments, path, shape): - """ - :param section: The section to add the docs to. - - :param value: The input / output values representing the parameters that - are included in the example. - - :param comments: The dictionary containing all the comments to be - applied to the example. - - :param path: A list describing where the documenter is in traversing the - parameters. This is used to find the equivalent location - in the comments dictionary. - """ - if isinstance(value, dict): - self._document_dict(section, value, comments, path, shape) - elif isinstance(value, list): - self._document_list(section, value, comments, path, shape) - elif isinstance(value, numbers.Number): - self._document_number(section, value, path) - elif shape and shape.type_name == 'timestamp': - self._document_datetime(section, value, path) - else: - self._document_str(section, value, path) - - def _document_dict(self, section, value, comments, path, shape, - top_level=False): - dict_section = section.add_new_section('dict-value') - self._start_nested_value(dict_section, '{') - for key, val in value.items(): - path.append('.%s' % key) - item_section = dict_section.add_new_section(key) - item_section.style.new_line() - item_comment = self._get_comment(path, comments) - if item_comment: - item_section.write(item_comment) - item_section.style.new_line() - item_section.write("'%s': " % key) - - # Shape could be none if there is no output besides ResponseMetadata - item_shape = None - if shape: - if shape.type_name == 'structure': - item_shape = shape.members.get(key) - elif shape.type_name == 'map': - item_shape = shape.value - self._document(item_section, val, comments, path, item_shape) - path.pop() - dict_section_end = dict_section.add_new_section('ending-brace') - self._end_nested_value(dict_section_end, '}') - if not top_level: - dict_section_end.write(',') - - def _document_params(self, section, value, comments, path, shape): - param_section = section.add_new_section('param-values') - self._start_nested_value(param_section, '(') - for key, val in value.items(): - path.append('.%s' % key) - item_section = param_section.add_new_section(key) - item_section.style.new_line() - item_comment = self._get_comment(path, comments) - if item_comment: - item_section.write(item_comment) - item_section.style.new_line() - item_section.write(key + '=') - - # Shape could be none if there are no input parameters - item_shape = None - if shape: - item_shape = shape.members.get(key) - self._document(item_section, val, comments, path, item_shape) - path.pop() - param_section_end = param_section.add_new_section('ending-parenthesis') - self._end_nested_value(param_section_end, ')') - - def _document_list(self, section, value, comments, path, shape): - list_section = section.add_new_section('list-section') - self._start_nested_value(list_section, '[') - item_shape = shape.member - for index, val in enumerate(value): - item_section = list_section.add_new_section(index) - item_section.style.new_line() - path.append('[%s]' % index) - item_comment = self._get_comment(path, comments) - if item_comment: - item_section.write(item_comment) - item_section.style.new_line() - self._document(item_section, val, comments, path, item_shape) - path.pop() - list_section_end = list_section.add_new_section('ending-bracket') - self._end_nested_value(list_section_end, '],') - - def _document_str(self, section, value, path): - # We do the string conversion because this might accept a type that - # we don't specifically address. - safe_value = escape_controls(value) - section.write(u"'%s'," % six.text_type(safe_value)) - - def _document_number(self, section, value, path): - section.write("%s," % str(value)) - - def _document_datetime(self, section, value, path): - datetime_tuple = parse_timestamp(value).timetuple() - datetime_str = str(datetime_tuple[0]) - for i in range(1, len(datetime_tuple)): - datetime_str += ", " + str(datetime_tuple[i]) - section.write("datetime(%s)," % datetime_str) - - def _get_comment(self, path, comments): - key = re.sub(r'^\.', '', ''.join(path)) - if comments and key in comments: - return '# ' + comments[key] - else: - return '' - - def _start_nested_value(self, section, start): - section.write(start) - section.style.indent() - section.style.indent() - - def _end_nested_value(self, section, end): - section.style.dedent() - section.style.dedent() - section.style.new_line() - section.write(end) - - -def document_shared_examples(section, operation_model, example_prefix, - shared_examples): - """Documents the shared examples - - :param section: The section to write to. - - :param operation_model: The model of the operation. - - :param example_prefix: The prefix to use in the method example. - - :param shared_examples: The shared JSON examples from the model. - """ - container_section = section.add_new_section('shared-examples') - container_section.style.new_paragraph() - container_section.style.bold('Examples') - documenter = SharedExampleDocumenter() - for example in shared_examples: - documenter.document_shared_example( - example=example, - section=container_section.add_new_section(example['id']), - prefix=example_prefix, - operation_model=operation_model - ) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/utils.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/utils.py deleted file mode 100644 index a0d2d662..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/utils.py +++ /dev/null @@ -1,197 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import re -from collections import namedtuple - - -def py_type_name(type_name): - """Get the Python type name for a given model type. - - >>> py_type_name('list') - 'list' - >>> py_type_name('structure') - 'dict' - - :rtype: string - """ - return { - 'blob': 'bytes', - 'character': 'string', - 'double': 'float', - 'long': 'integer', - 'map': 'dict', - 'structure': 'dict', - 'timestamp': 'datetime', - }.get(type_name, type_name) - - -def py_default(type_name): - """Get the Python default value for a given model type. - - >>> py_default('string') - '\'string\'' - >>> py_default('list') - '[...]' - >>> py_default('unknown') - '...' - - :rtype: string - """ - return { - 'double': '123.0', - 'long': '123', - 'integer': '123', - 'string': "'string'", - 'blob': "b'bytes'", - 'boolean': 'True|False', - 'list': '[...]', - 'map': '{...}', - 'structure': '{...}', - 'timestamp': 'datetime(2015, 1, 1)', - }.get(type_name, '...') - - -def get_official_service_name(service_model): - """Generate the official name of an AWS Service - - :param service_model: The service model representing the service - """ - official_name = service_model.metadata.get('serviceFullName') - short_name = service_model.metadata.get('serviceAbbreviation', '') - if short_name.startswith('Amazon'): - short_name = short_name[7:] - if short_name.startswith('AWS'): - short_name = short_name[4:] - if short_name and short_name.lower() not in official_name.lower(): - official_name += ' ({0})'.format(short_name) - return official_name - - -_DocumentedShape = namedtuple( - 'DocumentedShape', ['name', 'type_name', 'documentation', 'metadata', - 'members', 'required_members']) - - -class DocumentedShape (_DocumentedShape): - """Use this class to inject new shapes into a model for documentation""" - def __new__(cls, name, type_name, documentation, metadata=None, - members=None, required_members=None): - if metadata is None: - metadata = [] - if members is None: - members = [] - if required_members is None: - required_members = [] - return super(DocumentedShape, cls).__new__( - cls, name, type_name, documentation, metadata, members, - required_members) - - -class AutoPopulatedParam(object): - def __init__(self, name, param_description=None): - self.name = name - self.param_description = param_description - if param_description is None: - self.param_description = ( - 'Please note that this parameter is automatically populated ' - 'if it is not provided. Including this parameter is not ' - 'required\n') - - def document_auto_populated_param(self, event_name, section, **kwargs): - """Documents auto populated parameters - - It will remove any required marks for the parameter, remove the - parameter from the example, and add a snippet about the parameter - being autopopulated in the description. - """ - if event_name.startswith('docs.request-params'): - if self.name in section.available_sections: - section = section.get_section(self.name) - if 'is-required' in section.available_sections: - section.delete_section('is-required') - description_section = section.get_section( - 'param-documentation') - description_section.writeln(self.param_description) - elif event_name.startswith('docs.request-example'): - section = section.get_section('structure-value') - if self.name in section.available_sections: - section.delete_section(self.name) - - -class HideParamFromOperations(object): - """Hides a single parameter from multiple operations. - - This method will remove a parameter from documentation and from - examples. This method is typically used for things that are - automatically populated because a user would be unable to provide - a value (e.g., a checksum of a serialized XML request body).""" - def __init__(self, service_name, parameter_name, operation_names): - """ - :type service_name: str - :param service_name: Name of the service to modify. - - :type parameter_name: str - :param parameter_name: Name of the parameter to modify. - - :type operation_names: list - :param operation_names: Operation names to modify. - """ - self._parameter_name = parameter_name - self._params_events = set() - self._example_events = set() - # Build up the sets of relevant event names. - param_template = 'docs.request-params.%s.%s.complete-section' - example_template = 'docs.request-example.%s.%s.complete-section' - for name in operation_names: - self._params_events.add(param_template % (service_name, name)) - self._example_events.add(example_template % (service_name, name)) - - def hide_param(self, event_name, section, **kwargs): - if event_name in self._example_events: - # Modify the structure value for example events. - section = section.get_section('structure-value') - elif event_name not in self._params_events: - return - if self._parameter_name in section.available_sections: - section.delete_section(self._parameter_name) - - -class AppendParamDocumentation(object): - """Appends documentation to a specific parameter""" - def __init__(self, parameter_name, doc_string): - self._parameter_name = parameter_name - self._doc_string = doc_string - - def append_documentation(self, event_name, section, **kwargs): - if self._parameter_name in section.available_sections: - section = section.get_section(self._parameter_name) - description_section = section.get_section( - 'param-documentation') - description_section.writeln(self._doc_string) - - -_CONTROLS = { - '\n': '\\n', - '\r': '\\r', - '\t': '\\t', - '\b': '\\b', - '\f': '\\f', -} -# Combines all CONTROLS keys into a big or regular expression -_ESCAPE_CONTROLS_RE = re.compile('|'.join(map(re.escape, _CONTROLS))) -# Based on the match get the appropriate replacement from CONTROLS -_CONTROLS_MATCH_HANDLER = lambda match: _CONTROLS[match.group(0)] - - -def escape_controls(value): - return _ESCAPE_CONTROLS_RE.sub(_CONTROLS_MATCH_HANDLER, value) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/waiter.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/waiter.py deleted file mode 100644 index a38049c2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/docs/waiter.py +++ /dev/null @@ -1,127 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore import xform_name -from botocore.compat import OrderedDict -from botocore.docs.utils import DocumentedShape -from botocore.utils import get_service_module_name -from botocore.docs.method import document_model_driven_method - - -class WaiterDocumenter(object): - def __init__(self, client, service_waiter_model): - self._client = client - self._service_name = self._client.meta.service_model.service_name - self._service_waiter_model = service_waiter_model - - def document_waiters(self, section): - """Documents the various waiters for a service. - - :param section: The section to write to. - """ - section.style.h2('Waiters') - section.style.new_line() - section.writeln('The available waiters are:') - for waiter_name in self._service_waiter_model.waiter_names: - section.style.li( - ':py:class:`%s.Waiter.%s`' % ( - self._client.__class__.__name__, waiter_name)) - self._add_single_waiter(section, waiter_name) - - def _add_single_waiter(self, section, waiter_name): - section = section.add_new_section(waiter_name) - section.style.start_sphinx_py_class( - class_name='%s.Waiter.%s' % ( - self._client.__class__.__name__, waiter_name)) - - # Add example on how to instantiate waiter. - section.style.start_codeblock() - section.style.new_line() - section.write( - 'waiter = client.get_waiter(\'%s\')' % xform_name(waiter_name) - ) - section.style.end_codeblock() - - # Add information on the wait() method - section.style.new_line() - document_wait_method( - section=section, - waiter_name=waiter_name, - event_emitter=self._client.meta.events, - service_model=self._client.meta.service_model, - service_waiter_model=self._service_waiter_model - ) - - -def document_wait_method(section, waiter_name, event_emitter, - service_model, service_waiter_model, - include_signature=True): - """Documents a the wait method of a waiter - - :param section: The section to write to - - :param waiter_name: The name of the waiter - - :param event_emitter: The event emitter to use to emit events - - :param service_model: The service model - - :param service_waiter_model: The waiter model associated to the service - - :param include_signature: Whether or not to include the signature. - It is useful for generating docstrings. - """ - waiter_model = service_waiter_model.get_waiter(waiter_name) - operation_model = service_model.operation_model( - waiter_model.operation) - - waiter_config_members = OrderedDict() - - waiter_config_members['Delay'] = DocumentedShape( - name='Delay', type_name='integer', - documentation=( - '

The amount of time in seconds to wait between ' - 'attempts. Default: {0}

'.format(waiter_model.delay))) - - waiter_config_members['MaxAttempts'] = DocumentedShape( - name='MaxAttempts', type_name='integer', - documentation=( - '

The maximum number of attempts to be made. ' - 'Default: {0}

'.format(waiter_model.max_attempts))) - - botocore_waiter_params = [ - DocumentedShape( - name='WaiterConfig', type_name='structure', - documentation=( - '

A dictionary that provides parameters to control ' - 'waiting behavior.

'), - members=waiter_config_members) - ] - - wait_description = ( - 'Polls :py:meth:`{0}.Client.{1}` every {2} ' - 'seconds until a successful state is reached. An error is ' - 'returned after {3} failed checks.'.format( - get_service_module_name(service_model), - xform_name(waiter_model.operation), - waiter_model.delay, waiter_model.max_attempts) - ) - - document_model_driven_method( - section, 'wait', operation_model, - event_emitter=event_emitter, - method_description=wait_description, - example_prefix='waiter.wait', - include_input=botocore_waiter_params, - document_output=False, - include_signature=include_signature - ) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/endpoint.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/endpoint.py deleted file mode 100644 index ec335177..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/endpoint.py +++ /dev/null @@ -1,326 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import os -import logging -import time -import threading - -from botocore.vendored.requests.adapters import HTTPAdapter -from botocore.vendored.requests.sessions import Session -from botocore.vendored.requests.utils import get_environ_proxies -from botocore.vendored.requests.exceptions import ConnectionError -from botocore.vendored import six - -from botocore.awsrequest import create_request_object -from botocore.exceptions import UnknownEndpointError -from botocore.exceptions import EndpointConnectionError -from botocore.exceptions import ConnectionClosedError -from botocore.compat import filter_ssl_warnings -from botocore.utils import is_valid_endpoint_url -from botocore.hooks import first_non_none_response -from botocore.history import get_global_history_recorder -from botocore.response import StreamingBody -from botocore import parsers - - -logger = logging.getLogger(__name__) -history_recorder = get_global_history_recorder() -DEFAULT_TIMEOUT = 60 -MAX_POOL_CONNECTIONS = 10 -filter_ssl_warnings() - -try: - from botocore.vendored.requests.packages.urllib3.contrib import pyopenssl - pyopenssl.extract_from_urllib3() -except ImportError: - pass - - -def convert_to_response_dict(http_response, operation_model): - """Convert an HTTP response object to a request dict. - - This converts the requests library's HTTP response object to - a dictionary. - - :type http_response: botocore.vendored.requests.model.Response - :param http_response: The HTTP response from an AWS service request. - - :rtype: dict - :return: A response dictionary which will contain the following keys: - * headers (dict) - * status_code (int) - * body (string or file-like object) - - """ - response_dict = { - 'headers': http_response.headers, - 'status_code': http_response.status_code, - 'context': { - 'operation_name': operation_model.name, - } - } - if response_dict['status_code'] >= 300: - response_dict['body'] = http_response.content - elif operation_model.has_event_stream_output: - response_dict['body'] = http_response.raw - elif operation_model.has_streaming_output: - length = response_dict['headers'].get('content-length') - response_dict['body'] = StreamingBody(http_response.raw, length) - else: - response_dict['body'] = http_response.content - return response_dict - - -class BotocoreHTTPSession(Session): - """Internal session class used to workaround requests behavior. - - This class is intended to be used only by the Endpoint class. - - """ - def __init__(self, max_pool_connections=MAX_POOL_CONNECTIONS, - http_adapter_cls=HTTPAdapter): - super(BotocoreHTTPSession, self).__init__() - # In order to support a user provided "max_pool_connections", we need - # to recreate the HTTPAdapter and pass in our max_pool_connections - # value. - adapter = http_adapter_cls(pool_maxsize=max_pool_connections) - # requests uses an HTTPAdapter for mounting both http:// and https:// - self.mount('https://', adapter) - self.mount('http://', adapter) - - def rebuild_auth(self, prepared_request, response): - # Keep the existing auth information from the original prepared request. - # Normally this method would be where auth is regenerated as needed. - # By making this a noop, we're keeping the existing auth info. - pass - - -class Endpoint(object): - """ - Represents an endpoint for a particular service in a specific - region. Only an endpoint can make requests. - - :ivar service: The Service object that describes this endpoints - service. - :ivar host: The fully qualified endpoint hostname. - :ivar session: The session object. - """ - - def __init__(self, host, endpoint_prefix, - event_emitter, proxies=None, verify=True, - timeout=DEFAULT_TIMEOUT, response_parser_factory=None, - max_pool_connections=MAX_POOL_CONNECTIONS): - self._endpoint_prefix = endpoint_prefix - self._event_emitter = event_emitter - self.host = host - self.verify = verify - if proxies is None: - proxies = {} - self.proxies = proxies - self.http_session = BotocoreHTTPSession( - max_pool_connections=max_pool_connections) - self.timeout = timeout - self.max_pool_connections = max_pool_connections - logger.debug('Setting %s timeout as %s', endpoint_prefix, self.timeout) - self._lock = threading.Lock() - if response_parser_factory is None: - response_parser_factory = parsers.ResponseParserFactory() - self._response_parser_factory = response_parser_factory - - def __repr__(self): - return '%s(%s)' % (self._endpoint_prefix, self.host) - - def make_request(self, operation_model, request_dict): - logger.debug("Making request for %s (verify_ssl=%s) with params: %s", - operation_model, self.verify, request_dict) - return self._send_request(request_dict, operation_model) - - def create_request(self, params, operation_model=None): - request = create_request_object(params) - if operation_model: - event_name = 'request-created.{endpoint_prefix}.{op_name}'.format( - endpoint_prefix=self._endpoint_prefix, - op_name=operation_model.name) - self._event_emitter.emit(event_name, request=request, - operation_name=operation_model.name) - prepared_request = self.prepare_request(request) - return prepared_request - - def _encode_headers(self, headers): - # In place encoding of headers to utf-8 if they are unicode. - for key, value in headers.items(): - if isinstance(value, six.text_type): - headers[key] = value.encode('utf-8') - - def prepare_request(self, request): - self._encode_headers(request.headers) - return request.prepare() - - def _send_request(self, request_dict, operation_model): - attempts = 1 - request = self.create_request(request_dict, operation_model) - success_response, exception = self._get_response( - request, operation_model, attempts) - while self._needs_retry(attempts, operation_model, request_dict, - success_response, exception): - attempts += 1 - # If there is a stream associated with the request, we need - # to reset it before attempting to send the request again. - # This will ensure that we resend the entire contents of the - # body. - request.reset_stream() - # Create a new request when retried (including a new signature). - request = self.create_request( - request_dict, operation_model) - success_response, exception = self._get_response( - request, operation_model, attempts) - if success_response is not None and \ - 'ResponseMetadata' in success_response[1]: - # We want to share num retries, not num attempts. - total_retries = attempts - 1 - success_response[1]['ResponseMetadata']['RetryAttempts'] = \ - total_retries - if exception is not None: - raise exception - else: - return success_response - - def _get_response(self, request, operation_model, attempts): - # This will return a tuple of (success_response, exception) - # and success_response is itself a tuple of - # (http_response, parsed_dict). - # If an exception occurs then the success_response is None. - # If no exception occurs then exception is None. - try: - logger.debug("Sending http request: %s", request) - history_recorder.record('HTTP_REQUEST', { - 'method': request.method, - 'headers': request.headers, - 'streaming': operation_model.has_streaming_input, - 'url': request.url, - 'body': request.body - }) - streaming = any([ - operation_model.has_streaming_output, - operation_model.has_event_stream_output - ]) - http_response = self.http_session.send( - request, verify=self.verify, - stream=streaming, - proxies=self.proxies, timeout=self.timeout) - except ConnectionError as e: - # For a connection error, if it looks like it's a DNS - # lookup issue, 99% of the time this is due to a misconfigured - # region/endpoint so we'll raise a more specific error message - # to help users. - logger.debug("ConnectionError received when sending HTTP request.", - exc_info=True) - if self._looks_like_dns_error(e): - endpoint_url = e.request.url - better_exception = EndpointConnectionError( - endpoint_url=endpoint_url, error=e) - return (None, better_exception) - elif self._looks_like_bad_status_line(e): - better_exception = ConnectionClosedError( - endpoint_url=e.request.url, request=e.request) - return (None, better_exception) - else: - return (None, e) - except Exception as e: - logger.debug("Exception received when sending HTTP request.", - exc_info=True) - return (None, e) - # This returns the http_response and the parsed_data. - response_dict = convert_to_response_dict(http_response, operation_model) - - http_response_record_dict = response_dict.copy() - http_response_record_dict['streaming'] = \ - operation_model.has_streaming_output - history_recorder.record('HTTP_RESPONSE', http_response_record_dict) - - protocol = operation_model.metadata['protocol'] - parser = self._response_parser_factory.create_parser(protocol) - parsed_response = parser.parse( - response_dict, operation_model.output_shape) - history_recorder.record('PARSED_RESPONSE', parsed_response) - return (http_response, parsed_response), None - - def _looks_like_dns_error(self, e): - return 'gaierror' in str(e) and e.request is not None - - def _looks_like_bad_status_line(self, e): - return 'BadStatusLine' in str(e) and e.request is not None - - def _needs_retry(self, attempts, operation_model, request_dict, - response=None, caught_exception=None): - event_name = 'needs-retry.%s.%s' % (self._endpoint_prefix, - operation_model.name) - responses = self._event_emitter.emit( - event_name, response=response, endpoint=self, - operation=operation_model, attempts=attempts, - caught_exception=caught_exception, request_dict=request_dict) - handler_response = first_non_none_response(responses) - if handler_response is None: - return False - else: - # Request needs to be retried, and we need to sleep - # for the specified number of times. - logger.debug("Response received to retry, sleeping for " - "%s seconds", handler_response) - time.sleep(handler_response) - return True - - -class EndpointCreator(object): - def __init__(self, event_emitter): - self._event_emitter = event_emitter - - def create_endpoint(self, service_model, region_name, endpoint_url, - verify=None, response_parser_factory=None, - timeout=DEFAULT_TIMEOUT, - max_pool_connections=MAX_POOL_CONNECTIONS, - proxies=None): - if not is_valid_endpoint_url(endpoint_url): - - raise ValueError("Invalid endpoint: %s" % endpoint_url) - if proxies is None: - proxies = self._get_proxies(endpoint_url) - return Endpoint( - endpoint_url, - endpoint_prefix=service_model.endpoint_prefix, - event_emitter=self._event_emitter, - proxies=proxies, - verify=self._get_verify_value(verify), - timeout=timeout, - max_pool_connections=max_pool_connections, - response_parser_factory=response_parser_factory) - - def _get_proxies(self, url): - # We could also support getting proxies from a config file, - # but for now proxy support is taken from the environment. - return get_environ_proxies(url) - - def _get_verify_value(self, verify): - # This is to account for: - # https://github.com/kennethreitz/requests/issues/1436 - # where we need to honor REQUESTS_CA_BUNDLE because we're creating our - # own request objects. - # First, if verify is not None, then the user explicitly specified - # a value so this automatically wins. - if verify is not None: - return verify - # Otherwise use the value from REQUESTS_CA_BUNDLE, or default to - # True if the env var does not exist. - return os.environ.get('REQUESTS_CA_BUNDLE', True) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/errorfactory.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/errorfactory.py deleted file mode 100644 index 05ac5c1e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/errorfactory.py +++ /dev/null @@ -1,95 +0,0 @@ -# Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from botocore.exceptions import ClientError -from botocore.utils import get_service_module_name - - -class BaseClientExceptions(object): - ClientError = ClientError - - def __init__(self, code_to_exception): - """Base class for exceptions object on a client - - :type code_to_exception: dict - :param code_to_exception: Mapping of error codes (strings) to exception - class that should be raised when encountering a particular - error code. - """ - self._code_to_exception = code_to_exception - - def from_code(self, error_code): - """Retrieves the error class based on the error code - - This is helpful for identifying the exception class needing to be - caught based on the ClientError.parsed_reponse['Error']['Code'] value - - :type error_code: string - :param error_code: The error code associated to a ClientError exception - - :rtype: ClientError or a subclass of ClientError - :returns: The appropriate modeled exception class for that error - code. If the error code does not match any of the known - modeled exceptions then return a generic ClientError. - """ - return self._code_to_exception.get(error_code, self.ClientError) - - def __getattr__(self, name): - exception_cls_names = [ - exception_cls.__name__ for exception_cls - in self._code_to_exception.values() - ] - raise AttributeError( - '%r object has no attribute %r. Valid exceptions are: %s' % ( - self, name, ', '.join(exception_cls_names))) - - -class ClientExceptionsFactory(object): - def __init__(self): - self._client_exceptions_cache = {} - - def create_client_exceptions(self, service_model): - """Creates a ClientExceptions object for the particular service client - - :type service_model: botocore.model.ServiceModel - :param service_model: The service model for the client - - :rtype: object that subclasses from BaseClientExceptions - :returns: The exceptions object of a client that can be used - to grab the various different modeled exceptions. - """ - service_name = service_model.service_name - if service_name not in self._client_exceptions_cache: - client_exceptions = self._create_client_exceptions(service_model) - self._client_exceptions_cache[service_name] = client_exceptions - return self._client_exceptions_cache[service_name] - - def _create_client_exceptions(self, service_model): - cls_props = {} - code_to_exception = {} - for shape_name in service_model.shape_names: - shape = service_model.shape_for(shape_name) - if shape.metadata.get('exception', False): - exception_name = str(shape.name) - exception_cls = type(exception_name, (ClientError,), {}) - code = shape.metadata.get("error", {}).get("code") - cls_props[exception_name] = exception_cls - if code: - code_to_exception[code] = exception_cls - else: - # Use the exception name if there is no explicit code - # modeled - code_to_exception[exception_name] = exception_cls - cls_name = str(get_service_module_name(service_model) + 'Exceptions') - client_exceptions_cls = type( - cls_name, (BaseClientExceptions,), cls_props) - return client_exceptions_cls(code_to_exception) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/eventstream.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/eventstream.py deleted file mode 100644 index ea8a076d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/eventstream.py +++ /dev/null @@ -1,575 +0,0 @@ -# Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Binary Event Stream Decoding """ - -from binascii import crc32 -from struct import unpack -from botocore.exceptions import EventStreamError - -# byte length of the prelude (total_length + header_length + prelude_crc) -_PRELUDE_LENGTH = 12 -_MAX_HEADERS_LENGTH = 128 * 1024 # 128 Kb -_MAX_PAYLOAD_LENGTH = 16 * 1024 ** 2 # 16 Mb - - -class ParserError(Exception): - """Base binary flow encoding parsing exception. """ - pass - - -class DuplicateHeader(ParserError): - """Duplicate header found in the event. """ - def __init__(self, header): - message = 'Duplicate header present: "%s"' % header - super(DuplicateHeader, self).__init__(message) - - -class InvalidHeadersLength(ParserError): - """Headers length is longer than the maximum. """ - def __init__(self, length): - message = 'Header length of %s exceeded the maximum of %s' % ( - length, _MAX_HEADERS_LENGTH - ) - super(InvalidHeadersLength, self).__init__(message) - - -class InvalidPayloadLength(ParserError): - """Payload length is longer than the maximum. """ - def __init__(self, length): - message = 'Payload length of %s exceeded the maximum of %s' % ( - length, _MAX_PAYLOAD_LENGTH - ) - super(InvalidPayloadLength, self).__init__(message) - - -class ChecksumMismatch(ParserError): - """Calculated checksum did not match the expected checksum. """ - def __init__(self, expected, calculated): - message = 'Checksum mismatch: expected 0x%08x, calculated 0x%08x' % ( - expected, calculated - ) - super(ChecksumMismatch, self).__init__(message) - - -class DecodeUtils(object): - """Unpacking utility functions used in the decoder. - - All methods on this class take raw bytes and return a tuple containing - the value parsed from the bytes and the number of bytes consumed to parse - that value. - """ - - UINT8_BYTE_FORMAT = '!B' - UINT16_BYTE_FORMAT = '!H' - UINT32_BYTE_FORMAT = '!I' - INT16_BYTE_FORMAT = '!h' - INT32_BYTE_FORMAT = '!i' - INT64_BYTE_FORMAT = '!q' - PRELUDE_BYTE_FORMAT = '!III' - - # uint byte size to unpack format - UINT_BYTE_FORMAT = { - 1: UINT8_BYTE_FORMAT, - 2: UINT16_BYTE_FORMAT, - 4: UINT32_BYTE_FORMAT, - } - - @staticmethod - def unpack_true(data): - """This method consumes none of the provided bytes and returns True. - - :type data: bytes - :param data: The bytes to parse from. This is ignored in this method. - - :rtype: tuple - :rtype: (bool, int) - :returns: The tuple (True, 0) - """ - return True, 0 - - @staticmethod - def unpack_false(data): - """This method consumes none of the provided bytes and returns False. - - :type data: bytes - :param data: The bytes to parse from. This is ignored in this method. - - :rtype: tuple - :rtype: (bool, int) - :returns: The tuple (False, 0) - """ - return False, 0 - - @staticmethod - def unpack_uint8(data): - """Parse an unsigned 8-bit integer from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: (int, int) - :returns: A tuple containing the (parsed integer value, bytes consumed) - """ - value = unpack(DecodeUtils.UINT8_BYTE_FORMAT, data[:1])[0] - return value, 1 - - @staticmethod - def unpack_uint32(data): - """Parse an unsigned 32-bit integer from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: (int, int) - :returns: A tuple containing the (parsed integer value, bytes consumed) - """ - value = unpack(DecodeUtils.UINT32_BYTE_FORMAT, data[:4])[0] - return value, 4 - - @staticmethod - def unpack_int16(data): - """Parse a signed 16-bit integer from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: tuple - :rtype: (int, int) - :returns: A tuple containing the (parsed integer value, bytes consumed) - """ - value = unpack(DecodeUtils.INT16_BYTE_FORMAT, data[:2])[0] - return value, 2 - - @staticmethod - def unpack_int32(data): - """Parse a signed 32-bit integer from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: tuple - :rtype: (int, int) - :returns: A tuple containing the (parsed integer value, bytes consumed) - """ - value = unpack(DecodeUtils.INT32_BYTE_FORMAT, data[:4])[0] - return value, 4 - - @staticmethod - def unpack_int64(data): - """Parse a signed 64-bit integer from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: tuple - :rtype: (int, int) - :returns: A tuple containing the (parsed integer value, bytes consumed) - """ - value = unpack(DecodeUtils.INT64_BYTE_FORMAT, data[:8])[0] - return value, 8 - - @staticmethod - def unpack_byte_array(data, length_byte_size=2): - """Parse a variable length byte array from the bytes. - - The bytes are expected to be in the following format: - [ length ][0 ... length bytes] - where length is an unsigned integer represented in the smallest number - of bytes to hold the maximum length of the array. - - :type data: bytes - :param data: The bytes to parse from. - - :type length_byte_size: int - :param length_byte_size: The byte size of the preceeding integer that - represents the length of the array. Supported values are 1, 2, and 4. - - :rtype: (bytes, int) - :returns: A tuple containing the (parsed byte array, bytes consumed). - """ - uint_byte_format = DecodeUtils.UINT_BYTE_FORMAT[length_byte_size] - length = unpack(uint_byte_format, data[:length_byte_size])[0] - bytes_end = length + length_byte_size - array_bytes = data[length_byte_size:bytes_end] - return array_bytes, bytes_end - - @staticmethod - def unpack_utf8_string(data, length_byte_size=2): - """Parse a variable length utf-8 string from the bytes. - - The bytes are expected to be in the following format: - [ length ][0 ... length bytes] - where length is an unsigned integer represented in the smallest number - of bytes to hold the maximum length of the array and the following - bytes are a valid utf-8 string. - - :type data: bytes - :param bytes: The bytes to parse from. - - :type length_byte_size: int - :param length_byte_size: The byte size of the preceeding integer that - represents the length of the array. Supported values are 1, 2, and 4. - - :rtype: (str, int) - :returns: A tuple containing the (utf-8 string, bytes consumed). - """ - array_bytes, consumed = DecodeUtils.unpack_byte_array( - data, length_byte_size) - return array_bytes.decode('utf-8'), consumed - - @staticmethod - def unpack_uuid(data): - """Parse a 16-byte uuid from the bytes. - - :type data: bytes - :param data: The bytes to parse from. - - :rtype: (bytes, int) - :returns: A tuple containing the (uuid bytes, bytes consumed). - """ - return data[:16], 16 - - @staticmethod - def unpack_prelude(data): - """Parse the prelude for an event stream message from the bytes. - - The prelude for an event stream message has the following format: - [total_length][header_length][prelude_crc] - where each field is an unsigned 32-bit integer. - - :rtype: ((int, int, int), int) - :returns: A tuple of ((total_length, headers_length, prelude_crc), - consumed) - """ - return (unpack(DecodeUtils.PRELUDE_BYTE_FORMAT, data), _PRELUDE_LENGTH) - - -def _validate_checksum(data, checksum, crc=0): - # To generate the same numeric value across all Python versions and - # platforms use crc32(data) & 0xffffffff. - computed_checksum = crc32(data, crc) & 0xFFFFFFFF - if checksum != computed_checksum: - raise ChecksumMismatch(checksum, computed_checksum) - - -class MessagePrelude(object): - """Represents the prelude of an event stream message. """ - def __init__(self, total_length, headers_length, crc): - self.total_length = total_length - self.headers_length = headers_length - self.crc = crc - - @property - def payload_length(self): - """Calculates the total payload length. - - The extra minus 4 bytes is for the message CRC. - - :rtype: int - :returns: The total payload length. - """ - return self.total_length - self.headers_length - _PRELUDE_LENGTH - 4 - - @property - def payload_end(self): - """Calculates the byte offset for the end of the message payload. - - The extra minus 4 bytes is for the message CRC. - - :rtype: int - :returns: The byte offset from the beginning of the event stream - message to the end of the payload. - """ - return self.total_length - 4 - - @property - def headers_end(self): - """Calculates the byte offset for the end of the message headers. - - :rtype: int - :returns: The byte offset from the beginning of the event stream - message to the end of the headers. - """ - return _PRELUDE_LENGTH + self.headers_length - - -class EventStreamMessage(object): - """Represents an event stream message. """ - def __init__(self, prelude, headers, payload, crc): - self.prelude = prelude - self.headers = headers - self.payload = payload - self.crc = crc - - def to_response_dict(self, status_code=200): - if self.headers.get(':message-type') == 'error': - status_code = 400 - return { - 'status_code': status_code, - 'headers': self.headers, - 'body': self.payload - } - - -class EventStreamHeaderParser(object): - """ Parses the event headers from an event stream message. - - Expects all of the header data upfront and creates a dictionary of headers - to return. This object can be reused multiple times to parse the headers - from multiple event stream messages. - """ - - # Maps header type to appropriate unpacking function - # These unpacking functions return the value and the amount unpacked - _HEADER_TYPE_MAP = { - # boolean_true - 0: DecodeUtils.unpack_true, - # boolean_false - 1: DecodeUtils.unpack_false, - # byte - 2: DecodeUtils.unpack_uint8, - # short - 3: DecodeUtils.unpack_int16, - # integer - 4: DecodeUtils.unpack_int32, - # long - 5: DecodeUtils.unpack_int64, - # byte_array - 6: DecodeUtils.unpack_byte_array, - # string - 7: DecodeUtils.unpack_utf8_string, - # timestamp - 8: DecodeUtils.unpack_int64, - # uuid - 9: DecodeUtils.unpack_uuid, - } - - def __init__(self): - self._data = None - - def parse(self, data): - """Parses the event stream headers from an event stream message. - - :type data: bytes - :param data: The bytes that correspond to the headers section of an - event stream message. - - :rtype: dict - :returns: A dicionary of header key, value pairs. - """ - self._data = data - return self._parse_headers() - - def _parse_headers(self): - headers = {} - while self._data: - name, value = self._parse_header() - if name in headers: - raise DuplicateHeader(name) - headers[name] = value - return headers - - def _parse_header(self): - name = self._parse_name() - value = self._parse_value() - return name, value - - def _parse_name(self): - name, consumed = DecodeUtils.unpack_utf8_string(self._data, 1) - self._advance_data(consumed) - return name - - def _parse_type(self): - type, consumed = DecodeUtils.unpack_uint8(self._data) - self._advance_data(consumed) - return type - - def _parse_value(self): - header_type = self._parse_type() - value_unpacker = self._HEADER_TYPE_MAP[header_type] - value, consumed = value_unpacker(self._data) - self._advance_data(consumed) - return value - - def _advance_data(self, consumed): - self._data = self._data[consumed:] - - -class EventStreamBuffer(object): - """Streaming based event stream buffer - - A buffer class that wraps bytes from an event stream providing parsed - messages as they become available via an iterable interface. - """ - - def __init__(self): - self._data = b'' - self._prelude = None - self._header_parser = EventStreamHeaderParser() - - def add_data(self, data): - """Add data to the buffer. - - :type data: bytes - :param data: The bytes to add to the buffer to be used when parsing - """ - self._data += data - - def _validate_prelude(self, prelude): - if prelude.headers_length > _MAX_HEADERS_LENGTH: - raise InvalidHeadersLength(prelude.headers_length) - - if prelude.payload_length > _MAX_PAYLOAD_LENGTH: - raise InvalidPayloadLength(prelude.payload_length) - - def _parse_prelude(self): - prelude_bytes = self._data[:_PRELUDE_LENGTH] - raw_prelude, _ = DecodeUtils.unpack_prelude(prelude_bytes) - prelude = MessagePrelude(*raw_prelude) - self._validate_prelude(prelude) - # The minus 4 removes the prelude crc from the bytes to be checked - _validate_checksum(prelude_bytes[:_PRELUDE_LENGTH-4], prelude.crc) - return prelude - - def _parse_headers(self): - header_bytes = self._data[_PRELUDE_LENGTH:self._prelude.headers_end] - return self._header_parser.parse(header_bytes) - - def _parse_payload(self): - prelude = self._prelude - payload_bytes = self._data[prelude.headers_end:prelude.payload_end] - return payload_bytes - - def _parse_message_crc(self): - prelude = self._prelude - crc_bytes = self._data[prelude.payload_end:prelude.total_length] - message_crc, _ = DecodeUtils.unpack_uint32(crc_bytes) - return message_crc - - def _parse_message_bytes(self): - # The minus 4 includes the prelude crc to the bytes to be checked - message_bytes = self._data[_PRELUDE_LENGTH-4:self._prelude.payload_end] - return message_bytes - - def _validate_message_crc(self): - message_crc = self._parse_message_crc() - message_bytes = self._parse_message_bytes() - _validate_checksum(message_bytes, message_crc, crc=self._prelude.crc) - return message_crc - - def _parse_message(self): - crc = self._validate_message_crc() - headers = self._parse_headers() - payload = self._parse_payload() - message = EventStreamMessage(self._prelude, headers, payload, crc) - self._prepare_for_next_message() - return message - - def _prepare_for_next_message(self): - # Advance the data and reset the current prelude - self._data = self._data[self._prelude.total_length:] - self._prelude = None - - def next(self): - """Provides the next available message parsed from the stream - - :rtype: EventStreamMessage - :returns: The next event stream message - """ - if len(self._data) < _PRELUDE_LENGTH: - raise StopIteration() - - if self._prelude is None: - self._prelude = self._parse_prelude() - - if len(self._data) < self._prelude.total_length: - raise StopIteration() - - return self._parse_message() - - def __next__(self): - return self.next() - - def __iter__(self): - return self - - -class EventStream(object): - """Wrapper class for an event stream body. - - This wraps the underlying streaming body, parsing it for individual events - and yielding them as they come available through the iterator interface. - - The following example uses the S3 select API to get structured data out of - an object stored in S3 using an event stream. - - **Example:** - :: - from botocore.session import Session - - s3 = Session().create_client('s3') - response = s3.select_object_content( - Bucket='bucketname', - Key='keyname', - ExpressionType='SQL', - RequestProgress={'Enabled': True}, - Expression="SELECT * FROM S3Object s", - InputSerialization={'CSV': {}}, - OutputSerialization={'CSV': {}}, - ) - # This is the event stream in the response - event_stream = response['Payload'] - end_event_received = False - with open('output', 'wb') as f: - # Iterate over events in the event stream as they come - for event in event_stream: - # If we received a records event, write the data to a file - if 'Records' in event: - data = event['Records']['Payload'] - f.write(data) - # If we received a progress event, print the details - elif 'Progress' in event: - print(event['Progress']['Details']) - # End event indicates that the request finished successfully - elif 'End' in event: - print('Result is complete') - end_event_received = True - if not end_event_received: - raise Exception("End event not received, request incomplete.") - """ - def __init__(self, raw_stream, output_shape, parser, operation_name): - self._raw_stream = raw_stream - self._output_shape = output_shape - self._operation_name = operation_name - self._parser = parser - self._buffer = EventStreamBuffer() - - def __iter__(self): - for data in self._raw_stream.stream(): - self._buffer.add_data(data) - for event in self._buffer: - parsed_event = self._parse_event(event) - if parsed_event: - yield parsed_event - - def _parse_event(self, event): - response_dict = event.to_response_dict() - parsed_response = self._parser.parse(response_dict, self._output_shape) - if response_dict['status_code'] == 200: - return parsed_response - else: - raise EventStreamError(parsed_response, self._operation_name) - - def close(self): - """Closes the underlying streaming body. """ - self._raw_stream.close() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/exceptions.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/exceptions.py deleted file mode 100644 index b5eb012a..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/exceptions.py +++ /dev/null @@ -1,453 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -from __future__ import unicode_literals -from botocore.vendored.requests.exceptions import ConnectionError - - -class BotoCoreError(Exception): - """ - The base exception class for BotoCore exceptions. - - :ivar msg: The descriptive message associated with the error. - """ - fmt = 'An unspecified error occurred' - - def __init__(self, **kwargs): - msg = self.fmt.format(**kwargs) - Exception.__init__(self, msg) - self.kwargs = kwargs - - -class DataNotFoundError(BotoCoreError): - """ - The data associated with a particular path could not be loaded. - - :ivar path: The data path that the user attempted to load. - """ - fmt = 'Unable to load data for: {data_path}' - - -class UnknownServiceError(DataNotFoundError): - """Raised when trying to load data for an unknown service. - - :ivar service_name: The name of the unknown service. - - """ - fmt = ( - "Unknown service: '{service_name}'. Valid service names are: " - "{known_service_names}") - - -class ApiVersionNotFoundError(BotoCoreError): - """ - The data associated with either that API version or a compatible one - could not be loaded. - - :ivar path: The data path that the user attempted to load. - :ivar path: The API version that the user attempted to load. - """ - fmt = 'Unable to load data {data_path} for: {api_version}' - - -class EndpointConnectionError(BotoCoreError): - fmt = ( - 'Could not connect to the endpoint URL: "{endpoint_url}"') - - -class ConnectionClosedError(ConnectionError): - fmt = ( - 'Connection was closed before we received a valid response ' - 'from endpoint URL: "{endpoint_url}".') - - def __init__(self, **kwargs): - msg = self.fmt.format(**kwargs) - kwargs.pop('endpoint_url') - super(ConnectionClosedError, self).__init__(msg, **kwargs) - - -class NoCredentialsError(BotoCoreError): - """ - No credentials could be found - """ - fmt = 'Unable to locate credentials' - - -class PartialCredentialsError(BotoCoreError): - """ - Only partial credentials were found. - - :ivar cred_var: The missing credential variable name. - - """ - fmt = 'Partial credentials found in {provider}, missing: {cred_var}' - - -class CredentialRetrievalError(BotoCoreError): - """ - Error attempting to retrieve credentials from a remote source. - - :ivar provider: The name of the credential provider. - :ivar error_msg: The msg explaning why credentials could not be - retrieved. - - """ - fmt = 'Error when retrieving credentials from {provider}: {error_msg}' - - -class UnknownSignatureVersionError(BotoCoreError): - """ - Requested Signature Version is not known. - - :ivar signature_version: The name of the requested signature version. - """ - fmt = 'Unknown Signature Version: {signature_version}.' - - -class ServiceNotInRegionError(BotoCoreError): - """ - The service is not available in requested region. - - :ivar service_name: The name of the service. - :ivar region_name: The name of the region. - """ - fmt = 'Service {service_name} not available in region {region_name}' - - -class BaseEndpointResolverError(BotoCoreError): - """Base error for endpoint resolving errors. - - Should never be raised directly, but clients can catch - this exception if they want to generically handle any errors - during the endpoint resolution process. - - """ - - -class NoRegionError(BaseEndpointResolverError): - """No region was specified.""" - fmt = 'You must specify a region.' - - -class UnknownEndpointError(BaseEndpointResolverError, ValueError): - """ - Could not construct an endpoint. - - :ivar service_name: The name of the service. - :ivar region_name: The name of the region. - """ - fmt = ( - 'Unable to construct an endpoint for ' - '{service_name} in region {region_name}') - - -class ProfileNotFound(BotoCoreError): - """ - The specified configuration profile was not found in the - configuration file. - - :ivar profile: The name of the profile the user attempted to load. - """ - fmt = 'The config profile ({profile}) could not be found' - - -class ConfigParseError(BotoCoreError): - """ - The configuration file could not be parsed. - - :ivar path: The path to the configuration file. - """ - fmt = 'Unable to parse config file: {path}' - - -class ConfigNotFound(BotoCoreError): - """ - The specified configuration file could not be found. - - :ivar path: The path to the configuration file. - """ - fmt = 'The specified config file ({path}) could not be found.' - - -class MissingParametersError(BotoCoreError): - """ - One or more required parameters were not supplied. - - :ivar object: The object that has missing parameters. - This can be an operation or a parameter (in the - case of inner params). The str() of this object - will be used so it doesn't need to implement anything - other than str(). - :ivar missing: The names of the missing parameters. - """ - fmt = ('The following required parameters are missing for ' - '{object_name}: {missing}') - - -class ValidationError(BotoCoreError): - """ - An exception occurred validating parameters. - - Subclasses must accept a ``value`` and ``param`` - argument in their ``__init__``. - - :ivar value: The value that was being validated. - :ivar param: The parameter that failed validation. - :ivar type_name: The name of the underlying type. - """ - fmt = ("Invalid value ('{value}') for param {param} " - "of type {type_name} ") - - -class ParamValidationError(BotoCoreError): - fmt = 'Parameter validation failed:\n{report}' - - -# These exceptions subclass from ValidationError so that code -# can just 'except ValidationError' to catch any possibly validation -# error. -class UnknownKeyError(ValidationError): - """ - Unknown key in a struct paramster. - - :ivar value: The value that was being checked. - :ivar param: The name of the parameter. - :ivar choices: The valid choices the value can be. - """ - fmt = ("Unknown key '{value}' for param '{param}'. Must be one " - "of: {choices}") - - -class RangeError(ValidationError): - """ - A parameter value was out of the valid range. - - :ivar value: The value that was being checked. - :ivar param: The parameter that failed validation. - :ivar min_value: The specified minimum value. - :ivar max_value: The specified maximum value. - """ - fmt = ('Value out of range for param {param}: ' - '{min_value} <= {value} <= {max_value}') - - -class UnknownParameterError(ValidationError): - """ - Unknown top level parameter. - - :ivar name: The name of the unknown parameter. - :ivar operation: The name of the operation. - :ivar choices: The valid choices the parameter name can be. - """ - fmt = ( - "Unknown parameter '{name}' for operation {operation}. Must be one " - "of: {choices}" - ) - - -class AliasConflictParameterError(ValidationError): - """ - Error when an alias is provided for a parameter as well as the original. - - :ivar original: The name of the original parameter. - :ivar alias: The name of the alias - :ivar operation: The name of the operation. - """ - fmt = ( - "Parameter '{original}' and its alias '{alias}' were provided " - "for operation {operation}. Only one of them may be used." - ) - - -class UnknownServiceStyle(BotoCoreError): - """ - Unknown style of service invocation. - - :ivar service_style: The style requested. - """ - fmt = 'The service style ({service_style}) is not understood.' - - -class PaginationError(BotoCoreError): - fmt = 'Error during pagination: {message}' - - -class OperationNotPageableError(BotoCoreError): - fmt = 'Operation cannot be paginated: {operation_name}' - - -class ChecksumError(BotoCoreError): - """The expected checksum did not match the calculated checksum. - - """ - fmt = ('Checksum {checksum_type} failed, expected checksum ' - '{expected_checksum} did not match calculated checksum ' - '{actual_checksum}.') - - -class UnseekableStreamError(BotoCoreError): - """Need to seek a stream, but stream does not support seeking. - - """ - fmt = ('Need to rewind the stream {stream_object}, but stream ' - 'is not seekable.') - - -class WaiterError(BotoCoreError): - """Waiter failed to reach desired state.""" - fmt = 'Waiter {name} failed: {reason}' - - def __init__(self, name, reason, last_response): - super(WaiterError, self).__init__(name=name, reason=reason) - self.last_response = last_response - - -class IncompleteReadError(BotoCoreError): - """HTTP response did not return expected number of bytes.""" - fmt = ('{actual_bytes} read, but total bytes ' - 'expected is {expected_bytes}.') - - -class InvalidExpressionError(BotoCoreError): - """Expression is either invalid or too complex.""" - fmt = 'Invalid expression {expression}: Only dotted lookups are supported.' - - -class UnknownCredentialError(BotoCoreError): - """Tried to insert before/after an unregistered credential type.""" - fmt = 'Credential named {name} not found.' - - -class WaiterConfigError(BotoCoreError): - """Error when processing waiter configuration.""" - fmt = 'Error processing waiter config: {error_msg}' - - -class UnknownClientMethodError(BotoCoreError): - """Error when trying to access a method on a client that does not exist.""" - fmt = 'Client does not have method: {method_name}' - - -class UnsupportedSignatureVersionError(BotoCoreError): - """Error when trying to access a method on a client that does not exist.""" - fmt = 'Signature version is not supported: {signature_version}' - - -class ClientError(Exception): - MSG_TEMPLATE = ( - 'An error occurred ({error_code}) when calling the {operation_name} ' - 'operation{retry_info}: {error_message}') - - def __init__(self, error_response, operation_name): - retry_info = self._get_retry_info(error_response) - error = error_response.get('Error', {}) - msg = self.MSG_TEMPLATE.format( - error_code=error.get('Code', 'Unknown'), - error_message=error.get('Message', 'Unknown'), - operation_name=operation_name, - retry_info=retry_info, - ) - super(ClientError, self).__init__(msg) - self.response = error_response - self.operation_name = operation_name - - def _get_retry_info(self, response): - retry_info = '' - if 'ResponseMetadata' in response: - metadata = response['ResponseMetadata'] - if metadata.get('MaxAttemptsReached', False): - if 'RetryAttempts' in metadata: - retry_info = (' (reached max retries: %s)' % - metadata['RetryAttempts']) - return retry_info - - -class EventStreamError(ClientError): - pass - - -class UnsupportedTLSVersionWarning(Warning): - """Warn when an openssl version that uses TLS 1.2 is required""" - pass - - -class ImminentRemovalWarning(Warning): - pass - - -class InvalidDNSNameError(BotoCoreError): - """Error when virtual host path is forced on a non-DNS compatible bucket""" - fmt = ( - 'Bucket named {bucket_name} is not DNS compatible. Virtual ' - 'hosted-style addressing cannot be used. The addressing style ' - 'can be configured by removing the addressing_style value ' - 'or setting that value to \'path\' or \'auto\' in the AWS Config ' - 'file or in the botocore.client.Config object.' - ) - - -class InvalidS3AddressingStyleError(BotoCoreError): - """Error when an invalid path style is specified""" - fmt = ( - 'S3 addressing style {s3_addressing_style} is invaild. Valid options ' - 'are: \'auto\', \'virtual\', and \'path\'' - ) - - -class InvalidRetryConfigurationError(BotoCoreError): - """Error when invalid retry configuration is specified""" - fmt = ( - 'Cannot provide retry configuration for "{retry_config_option}". ' - 'Valid retry configuration options are: \'max_attempts\'' - ) - - -class InvalidMaxRetryAttemptsError(InvalidRetryConfigurationError): - """Error when invalid retry configuration is specified""" - fmt = ( - 'Value provided to "max_attempts": {provided_max_attempts} must ' - 'be an integer greater than or equal to zero.' - ) - -class StubResponseError(BotoCoreError): - fmt = 'Error getting response stub for operation {operation_name}: {reason}' - - -class StubAssertionError(StubResponseError, AssertionError): - pass - -class UnStubbedResponseError(StubResponseError): - pass - -class InvalidConfigError(BotoCoreError): - fmt = '{error_msg}' - - -class InfiniteLoopConfigError(InvalidConfigError): - fmt = ( - 'Infinite loop in credential configuration detected. Attempting to ' - 'load from profile {source_profile} which has already been visited. ' - 'Visited profiles: {visited_profiles}' - ) - - -class RefreshWithMFAUnsupportedError(BotoCoreError): - fmt = 'Cannot refresh credentials: MFA token required.' - - -class MD5UnavailableError(BotoCoreError): - fmt = "This system does not support MD5 generation." - - -class MetadataRetrievalError(BotoCoreError): - fmt = "Error retrieving metadata: {error_msg}" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/handlers.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/handlers.py deleted file mode 100644 index 02604aaf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/handlers.py +++ /dev/null @@ -1,1013 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -"""Builtin event handlers. - -This module contains builtin handlers for events emitted by botocore. -""" - -import base64 -import logging -import xml.etree.cElementTree -import copy -import re -import warnings -import uuid - -from botocore.compat import unquote, json, six, unquote_str, \ - ensure_bytes, get_md5, MD5_AVAILABLE, OrderedDict -from botocore.docs.utils import AutoPopulatedParam -from botocore.docs.utils import HideParamFromOperations -from botocore.docs.utils import AppendParamDocumentation -from botocore.signers import add_generate_presigned_url -from botocore.signers import add_generate_presigned_post -from botocore.signers import add_generate_db_auth_token -from botocore.exceptions import ParamValidationError -from botocore.exceptions import AliasConflictParameterError -from botocore.exceptions import UnsupportedTLSVersionWarning -from botocore.utils import percent_encode, SAFE_CHARS -from botocore.utils import switch_host_with_param - -from botocore import retryhandler -from botocore import utils -from botocore import translate -import botocore -import botocore.auth - - -logger = logging.getLogger(__name__) - -REGISTER_FIRST = object() -REGISTER_LAST = object() -# From the S3 docs: -# The rules for bucket names in the US Standard region allow bucket names -# to be as long as 255 characters, and bucket names can contain any -# combination of uppercase letters, lowercase letters, numbers, periods -# (.), hyphens (-), and underscores (_). -VALID_BUCKET = re.compile(r'^[a-zA-Z0-9.\-_]{1,255}$') -VERSION_ID_SUFFIX = re.compile(r'\?versionId=[^\s]+$') - -SERVICE_NAME_ALIASES = { - 'runtime.sagemaker': 'sagemaker-runtime' -} - - -def handle_service_name_alias(service_name, **kwargs): - return SERVICE_NAME_ALIASES.get(service_name, service_name) - - -def check_for_200_error(response, **kwargs): - # From: http://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectCOPY.html - # There are two opportunities for a copy request to return an error. One - # can occur when Amazon S3 receives the copy request and the other can - # occur while Amazon S3 is copying the files. If the error occurs before - # the copy operation starts, you receive a standard Amazon S3 error. If the - # error occurs during the copy operation, the error response is embedded in - # the 200 OK response. This means that a 200 OK response can contain either - # a success or an error. Make sure to design your application to parse the - # contents of the response and handle it appropriately. - # - # So this handler checks for this case. Even though the server sends a - # 200 response, conceptually this should be handled exactly like a - # 500 response (with respect to raising exceptions, retries, etc.) - # We're connected *before* all the other retry logic handlers, so as long - # as we switch the error code to 500, we'll retry the error as expected. - if response is None: - # A None response can happen if an exception is raised while - # trying to retrieve the response. See Endpoint._get_response(). - return - http_response, parsed = response - if _looks_like_special_case_error(http_response): - logger.debug("Error found for response with 200 status code, " - "errors: %s, changing status code to " - "500.", parsed) - http_response.status_code = 500 - - -def _looks_like_special_case_error(http_response): - if http_response.status_code == 200: - parser = xml.etree.cElementTree.XMLParser( - target=xml.etree.cElementTree.TreeBuilder(), - encoding='utf-8') - parser.feed(http_response.content) - root = parser.close() - if root.tag == 'Error': - return True - return False - - -def set_operation_specific_signer(context, signing_name, **kwargs): - """ Choose the operation-specific signer. - - Individual operations may have a different auth type than the service as a - whole. This will most often manifest as operations that should not be - authenticated at all, but can include other auth modes such as sigv4 - without body signing. - """ - auth_type = context.get('auth_type') - - # Auth type will be None if the operation doesn't have a configured auth - # type. - if not auth_type: - return - - # Auth type will be the string value 'none' if the operation should not - # be signed at all. - if auth_type == 'none': - return botocore.UNSIGNED - - if auth_type.startswith('v4'): - signature_version = 'v4' - if signing_name == 's3': - signature_version = 's3v4' - - # If the operation needs an unsigned body, we set additional context - # allowing the signer to be aware of this. - if auth_type == 'v4-unsigned-body': - context['payload_signing_enabled'] = False - - return signature_version - - -def decode_console_output(parsed, **kwargs): - if 'Output' in parsed: - try: - # We're using 'replace' for errors because it is - # possible that console output contains non string - # chars we can't utf-8 decode. - value = base64.b64decode(six.b(parsed['Output'])).decode( - 'utf-8', 'replace') - parsed['Output'] = value - except (ValueError, TypeError, AttributeError): - logger.debug('Error decoding base64', exc_info=True) - - -def generate_idempotent_uuid(params, model, **kwargs): - for name in model.idempotent_members: - if name not in params: - params[name] = str(uuid.uuid4()) - logger.debug("injecting idempotency token (%s) into param '%s'." % - (params[name], name)) - - -def decode_quoted_jsondoc(value): - try: - value = json.loads(unquote(value)) - except (ValueError, TypeError): - logger.debug('Error loading quoted JSON', exc_info=True) - return value - - -def json_decode_template_body(parsed, **kwargs): - if 'TemplateBody' in parsed: - try: - value = json.loads( - parsed['TemplateBody'], object_pairs_hook=OrderedDict) - parsed['TemplateBody'] = value - except (ValueError, TypeError): - logger.debug('error loading JSON', exc_info=True) - - -def calculate_md5(params, **kwargs): - request_dict = params - if request_dict['body'] and 'Content-MD5' not in params['headers']: - body = request_dict['body'] - if isinstance(body, (bytes, bytearray)): - binary_md5 = _calculate_md5_from_bytes(body) - else: - binary_md5 = _calculate_md5_from_file(body) - base64_md5 = base64.b64encode(binary_md5).decode('ascii') - params['headers']['Content-MD5'] = base64_md5 - - -def _calculate_md5_from_bytes(body_bytes): - md5 = get_md5(body_bytes) - return md5.digest() - - -def _calculate_md5_from_file(fileobj): - start_position = fileobj.tell() - md5 = get_md5() - for chunk in iter(lambda: fileobj.read(1024 * 1024), b''): - md5.update(chunk) - fileobj.seek(start_position) - return md5.digest() - - -def conditionally_calculate_md5(params, context, request_signer, **kwargs): - """Only add a Content-MD5 if the system supports it.""" - if MD5_AVAILABLE: - calculate_md5(params, **kwargs) - - -def validate_bucket_name(params, **kwargs): - if 'Bucket' not in params: - return - bucket = params['Bucket'] - if VALID_BUCKET.search(bucket) is None: - error_msg = ( - 'Invalid bucket name "%s": Bucket name must match ' - 'the regex "%s"' % (bucket, VALID_BUCKET.pattern)) - raise ParamValidationError(report=error_msg) - - -def sse_md5(params, **kwargs): - """ - S3 server-side encryption requires the encryption key to be sent to the - server base64 encoded, as well as a base64-encoded MD5 hash of the - encryption key. This handler does both if the MD5 has not been set by - the caller. - """ - _sse_md5(params, 'SSECustomer') - - -def copy_source_sse_md5(params, **kwargs): - """ - S3 server-side encryption requires the encryption key to be sent to the - server base64 encoded, as well as a base64-encoded MD5 hash of the - encryption key. This handler does both if the MD5 has not been set by - the caller specifically if the parameter is for the copy-source sse-c key. - """ - _sse_md5(params, 'CopySourceSSECustomer') - - -def _sse_md5(params, sse_member_prefix='SSECustomer'): - if not _needs_s3_sse_customization(params, sse_member_prefix): - return - - sse_key_member = sse_member_prefix + 'Key' - sse_md5_member = sse_member_prefix + 'KeyMD5' - key_as_bytes = params[sse_key_member] - if isinstance(key_as_bytes, six.text_type): - key_as_bytes = key_as_bytes.encode('utf-8') - key_md5_str = base64.b64encode( - get_md5(key_as_bytes).digest()).decode('utf-8') - key_b64_encoded = base64.b64encode(key_as_bytes).decode('utf-8') - params[sse_key_member] = key_b64_encoded - params[sse_md5_member] = key_md5_str - - -def _needs_s3_sse_customization(params, sse_member_prefix): - return (params.get(sse_member_prefix + 'Key') is not None and - sse_member_prefix + 'KeyMD5' not in params) - - -# NOTE: Retries get registered in two separate places in the botocore -# code: once when creating the client and once when you load the service -# model from the session. While at first this handler seems unneeded, it -# would be a breaking change for the AWS CLI to have it removed. This is -# because it relies on the service model from the session to create commands -# and this handler respects operation granular retry logic while the client -# one does not. If this is ever to be removed the handler, the client -# will have to respect per-operation level retry configuration. -def register_retries_for_service(service_data, session, - service_name, **kwargs): - loader = session.get_component('data_loader') - endpoint_prefix = service_data.get('metadata', {}).get('endpointPrefix') - if endpoint_prefix is None: - logger.debug("Not registering retry handlers, could not endpoint " - "prefix from model for service %s", service_name) - return - config = _load_retry_config(loader, endpoint_prefix) - if not config: - return - logger.debug("Registering retry handlers for service: %s", service_name) - handler = retryhandler.create_retry_handler( - config, endpoint_prefix) - unique_id = 'retry-config-%s' % endpoint_prefix - session.register('needs-retry.%s' % endpoint_prefix, - handler, unique_id=unique_id) - _register_for_operations(config, session, - service_name=endpoint_prefix) - - -def _load_retry_config(loader, endpoint_prefix): - original_config = loader.load_data('_retry') - retry_config = translate.build_retry_config( - endpoint_prefix, original_config['retry'], - original_config.get('definitions', {})) - return retry_config - - -def _register_for_operations(config, session, service_name): - # There's certainly a tradeoff for registering the retry config - # for the operations when the service is created. In practice, - # there aren't a whole lot of per operation retry configs so - # this is ok for now. - for key in config: - if key == '__default__': - continue - handler = retryhandler.create_retry_handler(config, key) - unique_id = 'retry-config-%s-%s' % (service_name, key) - session.register('needs-retry.%s.%s' % (service_name, key), - handler, unique_id=unique_id) - - -def disable_signing(**kwargs): - """ - This handler disables request signing by setting the signer - name to a special sentinel value. - """ - return botocore.UNSIGNED - - -def add_expect_header(model, params, **kwargs): - if model.http.get('method', '') not in ['PUT', 'POST']: - return - if 'body' in params: - body = params['body'] - if hasattr(body, 'read'): - # Any file like object will use an expect 100-continue - # header regardless of size. - logger.debug("Adding expect 100 continue header to request.") - params['headers']['Expect'] = '100-continue' - - -def document_copy_source_form(section, event_name, **kwargs): - if 'request-example' in event_name: - parent = section.get_section('structure-value') - param_line = parent.get_section('CopySource') - value_portion = param_line.get_section('member-value') - value_portion.clear_text() - value_portion.write("'string' or {'Bucket': 'string', " - "'Key': 'string', 'VersionId': 'string'}") - elif 'request-params' in event_name: - param_section = section.get_section('CopySource') - type_section = param_section.get_section('param-type') - type_section.clear_text() - type_section.write(':type CopySource: str or dict') - doc_section = param_section.get_section('param-documentation') - doc_section.clear_text() - doc_section.write( - "The name of the source bucket, key name of the source object, " - "and optional version ID of the source object. You can either " - "provide this value as a string or a dictionary. The " - "string form is {bucket}/{key} or " - "{bucket}/{key}?versionId={versionId} if you want to copy a " - "specific version. You can also provide this value as a " - "dictionary. The dictionary format is recommended over " - "the string format because it is more explicit. The dictionary " - "format is: {'Bucket': 'bucket', 'Key': 'key', 'VersionId': 'id'}." - " Note that the VersionId key is optional and may be omitted." - ) - - -def handle_copy_source_param(params, **kwargs): - """Convert CopySource param for CopyObject/UploadPartCopy. - - This handler will deal with two cases: - - * CopySource provided as a string. We'll make a best effort - to URL encode the key name as required. This will require - parsing the bucket and version id from the CopySource value - and only encoding the key. - * CopySource provided as a dict. In this case we're - explicitly given the Bucket, Key, and VersionId so we're - able to encode the key and ensure this value is serialized - and correctly sent to S3. - - """ - source = params.get('CopySource') - if source is None: - # The call will eventually fail but we'll let the - # param validator take care of this. It will - # give a better error message. - return - if isinstance(source, six.string_types): - params['CopySource'] = _quote_source_header(source) - elif isinstance(source, dict): - params['CopySource'] = _quote_source_header_from_dict(source) - - -def _quote_source_header_from_dict(source_dict): - try: - bucket = source_dict['Bucket'] - key = percent_encode(source_dict['Key'], safe=SAFE_CHARS + '/') - version_id = source_dict.get('VersionId') - except KeyError as e: - raise ParamValidationError( - report='Missing required parameter: %s' % str(e)) - final = '%s/%s' % (bucket, key) - if version_id is not None: - final += '?versionId=%s' % version_id - return final - - -def _quote_source_header(value): - result = VERSION_ID_SUFFIX.search(value) - if result is None: - return percent_encode(value, safe=SAFE_CHARS + '/') - else: - first, version_id = value[:result.start()], value[result.start():] - return percent_encode(first, safe=SAFE_CHARS + '/') + version_id - - -def _get_cross_region_presigned_url(request_signer, request_dict, model, - source_region, destination_region): - # The better way to do this is to actually get the - # endpoint_resolver and get the endpoint_url given the - # source region. In this specific case, we know that - # we can safely replace the dest region with the source - # region because of the supported EC2 regions, but in - # general this is not a safe assumption to make. - # I think eventually we should try to plumb through something - # that allows us to resolve endpoints from regions. - request_dict_copy = copy.deepcopy(request_dict) - request_dict_copy['body']['DestinationRegion'] = destination_region - request_dict_copy['url'] = request_dict['url'].replace( - destination_region, source_region) - request_dict_copy['method'] = 'GET' - request_dict_copy['headers'] = {} - return request_signer.generate_presigned_url( - request_dict_copy, region_name=source_region, - operation_name=model.name) - - -def _get_presigned_url_source_and_destination_regions(request_signer, params): - # Gets the source and destination regions to be used - destination_region = request_signer._region_name - source_region = params.get('SourceRegion') - return source_region, destination_region - - -def inject_presigned_url_ec2(params, request_signer, model, **kwargs): - # The customer can still provide this, so we should pass if they do. - if 'PresignedUrl' in params['body']: - return - src, dest = _get_presigned_url_source_and_destination_regions( - request_signer, params['body']) - url = _get_cross_region_presigned_url( - request_signer, params, model, src, dest) - params['body']['PresignedUrl'] = url - # EC2 Requires that the destination region be sent over the wire in - # addition to the source region. - params['body']['DestinationRegion'] = dest - - -def inject_presigned_url_rds(params, request_signer, model, **kwargs): - # SourceRegion is not required for RDS operations, so it's possible that - # it isn't set. In that case it's probably a local copy so we don't need - # to do anything else. - if 'SourceRegion' not in params['body']: - return - - src, dest = _get_presigned_url_source_and_destination_regions( - request_signer, params['body']) - - # Since SourceRegion isn't actually modeled for RDS, it needs to be - # removed from the request params before we send the actual request. - del params['body']['SourceRegion'] - - if 'PreSignedUrl' in params['body']: - return - - url = _get_cross_region_presigned_url( - request_signer, params, model, src, dest) - params['body']['PreSignedUrl'] = url - - -def json_decode_policies(parsed, model, **kwargs): - # Any time an IAM operation returns a policy document - # it is a string that is json that has been urlencoded, - # i.e urlencode(json.dumps(policy_document)). - # To give users something more useful, we will urldecode - # this value and json.loads() the result so that they have - # the policy document as a dictionary. - output_shape = model.output_shape - if output_shape is not None: - _decode_policy_types(parsed, model.output_shape) - - -def _decode_policy_types(parsed, shape): - # IAM consistently uses the policyDocumentType shape to indicate - # strings that have policy documents. - shape_name = 'policyDocumentType' - if shape.type_name == 'structure': - for member_name, member_shape in shape.members.items(): - if member_shape.type_name == 'string' and \ - member_shape.name == shape_name and \ - member_name in parsed: - parsed[member_name] = decode_quoted_jsondoc( - parsed[member_name]) - elif member_name in parsed: - _decode_policy_types(parsed[member_name], member_shape) - if shape.type_name == 'list': - shape_member = shape.member - for item in parsed: - _decode_policy_types(item, shape_member) - - -def parse_get_bucket_location(parsed, http_response, **kwargs): - # s3.GetBucketLocation cannot be modeled properly. To - # account for this we just manually parse the XML document. - # The "parsed" passed in only has the ResponseMetadata - # filled out. This handler will fill in the LocationConstraint - # value. - if 'LocationConstraint' in parsed: - # Response already set - a stub? - return - response_body = http_response.content - parser = xml.etree.cElementTree.XMLParser( - target=xml.etree.cElementTree.TreeBuilder(), - encoding='utf-8') - parser.feed(response_body) - root = parser.close() - region = root.text - parsed['LocationConstraint'] = region - - -def base64_encode_user_data(params, **kwargs): - if 'UserData' in params: - if isinstance(params['UserData'], six.text_type): - # Encode it to bytes if it is text. - params['UserData'] = params['UserData'].encode('utf-8') - params['UserData'] = base64.b64encode( - params['UserData']).decode('utf-8') - - -def document_base64_encoding(param): - description = ('**This value will be base64 encoded automatically. Do ' - 'not base64 encode this value prior to performing the ' - 'operation.**') - append = AppendParamDocumentation(param, description) - return append.append_documentation - - -def validate_ascii_metadata(params, **kwargs): - """Verify S3 Metadata only contains ascii characters. - - From: http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html - - "Amazon S3 stores user-defined metadata in lowercase. Each name, value pair - must conform to US-ASCII when using REST and UTF-8 when using SOAP or - browser-based uploads via POST." - - """ - metadata = params.get('Metadata') - if not metadata or not isinstance(metadata, dict): - # We have to at least type check the metadata as a dict type - # because this handler is called before param validation. - # We'll go ahead and return because the param validator will - # give a descriptive error message for us. - # We might need a post-param validation event. - return - for key, value in metadata.items(): - try: - key.encode('ascii') - value.encode('ascii') - except UnicodeEncodeError as e: - error_msg = ( - 'Non ascii characters found in S3 metadata ' - 'for key "%s", value: "%s". \nS3 metadata can only ' - 'contain ASCII characters. ' % (key, value) - ) - raise ParamValidationError( - report=error_msg) - - -def fix_route53_ids(params, model, **kwargs): - """ - Check for and split apart Route53 resource IDs, setting - only the last piece. This allows the output of one operation - (e.g. ``'foo/1234'``) to be used as input in another - operation (e.g. it expects just ``'1234'``). - """ - input_shape = model.input_shape - if not input_shape or not hasattr(input_shape, 'members'): - return - - members = [name for (name, shape) in input_shape.members.items() - if shape.name in ['ResourceId', 'DelegationSetId']] - - for name in members: - if name in params: - orig_value = params[name] - params[name] = orig_value.split('/')[-1] - logger.debug('%s %s -> %s', name, orig_value, params[name]) - - -def inject_account_id(params, **kwargs): - if params.get('accountId') is None: - # Glacier requires accountId, but allows you - # to specify '-' for the current owners account. - # We add this default value if the user does not - # provide the accountId as a convenience. - params['accountId'] = '-' - - -def add_glacier_version(model, params, **kwargs): - request_dict = params - request_dict['headers']['x-amz-glacier-version'] = model.metadata[ - 'apiVersion'] - - -def add_accept_header(model, params, **kwargs): - if params['headers'].get('Accept', None) is None: - request_dict = params - request_dict['headers']['Accept'] = 'application/json' - - -def add_glacier_checksums(params, **kwargs): - """Add glacier checksums to the http request. - - This will add two headers to the http request: - - * x-amz-content-sha256 - * x-amz-sha256-tree-hash - - These values will only be added if they are not present - in the HTTP request. - - """ - request_dict = params - headers = request_dict['headers'] - body = request_dict['body'] - if isinstance(body, six.binary_type): - # If the user provided a bytes type instead of a file - # like object, we're temporarily create a BytesIO object - # so we can use the util functions to calculate the - # checksums which assume file like objects. Note that - # we're not actually changing the body in the request_dict. - body = six.BytesIO(body) - starting_position = body.tell() - if 'x-amz-content-sha256' not in headers: - headers['x-amz-content-sha256'] = utils.calculate_sha256( - body, as_hex=True) - body.seek(starting_position) - if 'x-amz-sha256-tree-hash' not in headers: - headers['x-amz-sha256-tree-hash'] = utils.calculate_tree_hash(body) - body.seek(starting_position) - - -def document_glacier_tree_hash_checksum(): - doc = ''' - This is a required field. - - Ideally you will want to compute this value with checksums from - previous uploaded parts, using the algorithm described in - `Glacier documentation `_. - - But if you prefer, you can also use botocore.utils.calculate_tree_hash() - to compute it from raw file by:: - - checksum = calculate_tree_hash(open('your_file.txt', 'rb')) - - ''' - return AppendParamDocumentation('checksum', doc).append_documentation - - -def document_cloudformation_get_template_return_type(section, event_name, **kwargs): - if 'response-params' in event_name: - template_body_section = section.get_section('TemplateBody') - type_section = template_body_section.get_section('param-type') - type_section.clear_text() - type_section.write('(*dict*) --') - elif 'response-example' in event_name: - parent = section.get_section('structure-value') - param_line = parent.get_section('TemplateBody') - value_portion = param_line.get_section('member-value') - value_portion.clear_text() - value_portion.write('{}') - - -def switch_host_machinelearning(request, **kwargs): - switch_host_with_param(request, 'PredictEndpoint') - - -def check_openssl_supports_tls_version_1_2(**kwargs): - import ssl - try: - openssl_version_tuple = ssl.OPENSSL_VERSION_INFO - if openssl_version_tuple < (1, 0, 1): - warnings.warn( - 'Currently installed openssl version: %s does not ' - 'support TLS 1.2, which is required for use of iot-data. ' - 'Please use python installed with openssl version 1.0.1 or ' - 'higher.' % (ssl.OPENSSL_VERSION), - UnsupportedTLSVersionWarning - ) - # We cannot check the openssl version on python2.6, so we should just - # pass on this conveniency check. - except AttributeError: - pass - - -def change_get_to_post(request, **kwargs): - # This is useful when we need to change a potentially large GET request - # into a POST with x-www-form-urlencoded encoding. - if request.method == 'GET' and '?' in request.url: - request.headers['Content-Type'] = 'application/x-www-form-urlencoded' - request.method = 'POST' - request.url, request.data = request.url.split('?', 1) - - -def set_list_objects_encoding_type_url(params, context, **kwargs): - if 'EncodingType' not in params: - # We set this context so that we know it wasn't the customer that - # requested the encoding. - context['encoding_type_auto_set'] = True - params['EncodingType'] = 'url' - - -def decode_list_object(parsed, context, **kwargs): - # This is needed because we are passing url as the encoding type. Since the - # paginator is based on the key, we need to handle it before it can be - # round tripped. - # - # From the documentation: If you specify encoding-type request parameter, - # Amazon S3 includes this element in the response, and returns encoded key - # name values in the following response elements: - # Delimiter, Marker, Prefix, NextMarker, Key. - if parsed.get('EncodingType') == 'url' and \ - context.get('encoding_type_auto_set'): - # URL decode top-level keys in the response if present. - top_level_keys = ['Delimiter', 'Marker', 'NextMarker'] - for key in top_level_keys: - if key in parsed: - parsed[key] = unquote_str(parsed[key]) - # URL decode nested keys from the response if present. - nested_keys = [('Contents', 'Key'), ('CommonPrefixes', 'Prefix')] - for (top_key, child_key) in nested_keys: - if top_key in parsed: - for member in parsed[top_key]: - member[child_key] = unquote_str(member[child_key]) - - -def convert_body_to_file_like_object(params, **kwargs): - if 'Body' in params: - if isinstance(params['Body'], six.string_types): - params['Body'] = six.BytesIO(ensure_bytes(params['Body'])) - elif isinstance(params['Body'], six.binary_type): - params['Body'] = six.BytesIO(params['Body']) - - -def _add_parameter_aliases(handler_list): - # Mapping of original parameter to parameter alias. - # The key is ..parameter - # The first part of the key is used for event registration. - # The last part is the original parameter name and the value is the - # alias to expose in documentation. - aliases = { - 'ec2.*.Filter': 'Filters', - 'logs.CreateExportTask.from': 'fromTime', - 'cloudsearchdomain.Search.return': 'returnFields' - } - - for original, new_name in aliases.items(): - event_portion, original_name = original.rsplit('.', 1) - parameter_alias = ParameterAlias(original_name, new_name) - - # Add the handlers to the list of handlers. - # One handler is to handle when users provide the alias. - # The other handler is to update the documentation to show only - # the alias. - parameter_build_event_handler_tuple = ( - 'before-parameter-build.' + event_portion, - parameter_alias.alias_parameter_in_call, - REGISTER_FIRST - ) - docs_event_handler_tuple = ( - 'docs.*.' + event_portion + '.complete-section', - parameter_alias.alias_parameter_in_documentation) - handler_list.append(parameter_build_event_handler_tuple) - handler_list.append(docs_event_handler_tuple) - - -class ParameterAlias(object): - def __init__(self, original_name, alias_name): - self._original_name = original_name - self._alias_name = alias_name - - def alias_parameter_in_call(self, params, model, **kwargs): - if model.input_shape: - # Only consider accepting the alias if it is modeled in the - # input shape. - if self._original_name in model.input_shape.members: - if self._alias_name in params: - if self._original_name in params: - raise AliasConflictParameterError( - original=self._original_name, - alias=self._alias_name, - operation=model.name - ) - # Remove the alias parameter value and use the old name - # instead. - params[self._original_name] = params.pop(self._alias_name) - - def alias_parameter_in_documentation(self, event_name, section, **kwargs): - if event_name.startswith('docs.request-params'): - if self._original_name not in section.available_sections: - return - # Replace the name for parameter type - param_section = section.get_section(self._original_name) - param_type_section = param_section.get_section('param-type') - self._replace_content(param_type_section) - - # Replace the name for the parameter description - param_name_section = param_section.get_section('param-name') - self._replace_content(param_name_section) - elif event_name.startswith('docs.request-example'): - section = section.get_section('structure-value') - if self._original_name not in section.available_sections: - return - # Replace the name for the example - param_section = section.get_section(self._original_name) - self._replace_content(param_section) - - def _replace_content(self, section): - content = section.getvalue().decode('utf-8') - updated_content = content.replace( - self._original_name, self._alias_name) - section.clear_text() - section.write(updated_content) - - -class ClientMethodAlias(object): - def __init__(self, actual_name): - """ Aliases a non-extant method to an existing method. - - :param actual_name: The name of the method that actually exists on - the client. - """ - self._actual = actual_name - - def __call__(self, client, **kwargs): - return getattr(client, self._actual) - - -def remove_subscribe_to_shard(class_attributes, **kwargs): - if 'subscribe_to_shard' in class_attributes: - # subscribe_to_shard requires HTTP 2 support - del class_attributes['subscribe_to_shard'] - -# This is a list of (event_name, handler). -# When a Session is created, everything in this list will be -# automatically registered with that Session. - -BUILTIN_HANDLERS = [ - ('choose-service-name', handle_service_name_alias), - ('getattr.mturk.list_hi_ts_for_qualification_type', - ClientMethodAlias('list_hits_for_qualification_type')), - ('before-parameter-build.s3.UploadPart', - convert_body_to_file_like_object, REGISTER_LAST), - ('before-parameter-build.s3.PutObject', - convert_body_to_file_like_object, REGISTER_LAST), - ('creating-client-class.kinesis', remove_subscribe_to_shard), - ('creating-client-class', add_generate_presigned_url), - ('creating-client-class.s3', add_generate_presigned_post), - ('creating-client-class.rds', add_generate_db_auth_token), - ('creating-client-class.iot-data', check_openssl_supports_tls_version_1_2), - ('after-call.iam', json_decode_policies), - - ('after-call.ec2.GetConsoleOutput', decode_console_output), - ('after-call.cloudformation.GetTemplate', json_decode_template_body), - ('after-call.s3.GetBucketLocation', parse_get_bucket_location), - - ('before-parameter-build', generate_idempotent_uuid), - - ('before-parameter-build.s3', validate_bucket_name), - - ('before-parameter-build.s3.ListObjects', - set_list_objects_encoding_type_url), - ('before-call.s3.PutBucketTagging', calculate_md5), - ('before-call.s3.PutBucketLifecycle', calculate_md5), - ('before-call.s3.PutBucketLifecycleConfiguration', calculate_md5), - ('before-call.s3.PutBucketCors', calculate_md5), - ('before-call.s3.DeleteObjects', calculate_md5), - ('before-call.s3.PutBucketReplication', calculate_md5), - ('before-call.s3.PutObject', conditionally_calculate_md5), - ('before-call.s3.UploadPart', conditionally_calculate_md5), - ('before-call.s3.PutBucketAcl', conditionally_calculate_md5), - ('before-call.s3.PutBucketLogging', conditionally_calculate_md5), - ('before-call.s3.PutBucketNotification', conditionally_calculate_md5), - ('before-call.s3.PutBucketPolicy', conditionally_calculate_md5), - ('before-call.s3.PutBucketRequestPayment', conditionally_calculate_md5), - ('before-call.s3.PutBucketVersioning', conditionally_calculate_md5), - ('before-call.s3.PutBucketWebsite', conditionally_calculate_md5), - ('before-call.s3.PutObjectAcl', conditionally_calculate_md5), - - ('before-parameter-build.s3.CopyObject', - handle_copy_source_param), - ('before-parameter-build.s3.UploadPartCopy', - handle_copy_source_param), - ('before-parameter-build.s3.CopyObject', validate_ascii_metadata), - ('before-parameter-build.s3.PutObject', validate_ascii_metadata), - ('before-parameter-build.s3.CreateMultipartUpload', - validate_ascii_metadata), - ('docs.*.s3.CopyObject.complete-section', document_copy_source_form), - ('docs.*.s3.UploadPartCopy.complete-section', document_copy_source_form), - - ('before-call.s3', add_expect_header), - ('before-call.glacier', add_glacier_version), - ('before-call.apigateway', add_accept_header), - ('before-call.glacier.UploadArchive', add_glacier_checksums), - ('before-call.glacier.UploadMultipartPart', add_glacier_checksums), - ('before-call.ec2.CopySnapshot', inject_presigned_url_ec2), - ('before-call.rds.CopyDBClusterSnapshot', - inject_presigned_url_rds), - ('before-call.rds.CreateDBCluster', - inject_presigned_url_rds), - ('before-call.rds.CopyDBSnapshot', - inject_presigned_url_rds), - ('before-call.rds.CreateDBInstanceReadReplica', - inject_presigned_url_rds), - ('request-created.machinelearning.Predict', switch_host_machinelearning), - ('needs-retry.s3.UploadPartCopy', check_for_200_error, REGISTER_FIRST), - ('needs-retry.s3.CopyObject', check_for_200_error, REGISTER_FIRST), - ('needs-retry.s3.CompleteMultipartUpload', check_for_200_error, - REGISTER_FIRST), - ('service-data-loaded', register_retries_for_service), - ('choose-signer.cognito-identity.GetId', disable_signing), - ('choose-signer.cognito-identity.GetOpenIdToken', disable_signing), - ('choose-signer.cognito-identity.UnlinkIdentity', disable_signing), - ('choose-signer.cognito-identity.GetCredentialsForIdentity', - disable_signing), - ('choose-signer.sts.AssumeRoleWithSAML', disable_signing), - ('choose-signer.sts.AssumeRoleWithWebIdentity', disable_signing), - ('choose-signer', set_operation_specific_signer), - ('before-parameter-build.s3.HeadObject', sse_md5), - ('before-parameter-build.s3.GetObject', sse_md5), - ('before-parameter-build.s3.PutObject', sse_md5), - ('before-parameter-build.s3.CopyObject', sse_md5), - ('before-parameter-build.s3.CopyObject', copy_source_sse_md5), - ('before-parameter-build.s3.CreateMultipartUpload', sse_md5), - ('before-parameter-build.s3.UploadPart', sse_md5), - ('before-parameter-build.s3.UploadPartCopy', sse_md5), - ('before-parameter-build.s3.UploadPartCopy', copy_source_sse_md5), - ('before-parameter-build.ec2.RunInstances', base64_encode_user_data), - ('before-parameter-build.autoscaling.CreateLaunchConfiguration', - base64_encode_user_data), - ('before-parameter-build.route53', fix_route53_ids), - ('before-parameter-build.glacier', inject_account_id), - ('after-call.s3.ListObjects', decode_list_object), - - # Cloudsearchdomain search operation will be sent by HTTP POST - ('request-created.cloudsearchdomain.Search', - change_get_to_post), - # Glacier documentation customizations - ('docs.*.glacier.*.complete-section', - AutoPopulatedParam('accountId', 'Note: this parameter is set to "-" by' - 'default if no value is not specified.') - .document_auto_populated_param), - ('docs.*.glacier.UploadArchive.complete-section', - AutoPopulatedParam('checksum').document_auto_populated_param), - ('docs.*.glacier.UploadMultipartPart.complete-section', - AutoPopulatedParam('checksum').document_auto_populated_param), - ('docs.request-params.glacier.CompleteMultipartUpload.complete-section', - document_glacier_tree_hash_checksum()), - # Cloudformation documentation customizations - ('docs.*.cloudformation.GetTemplate.complete-section', - document_cloudformation_get_template_return_type), - - # UserData base64 encoding documentation customizations - ('docs.*.ec2.RunInstances.complete-section', - document_base64_encoding('UserData')), - ('docs.*.autoscaling.CreateLaunchConfiguration.complete-section', - document_base64_encoding('UserData')), - - # RDS PresignedUrl documentation customizations - ('docs.*.rds.CopyDBClusterSnapshot.complete-section', - AutoPopulatedParam('PreSignedUrl').document_auto_populated_param), - ('docs.*.rds.CreateDBCluster.complete-section', - AutoPopulatedParam('PreSignedUrl').document_auto_populated_param), - ('docs.*.rds.CopyDBSnapshot.complete-section', - AutoPopulatedParam('PreSignedUrl').document_auto_populated_param), - ('docs.*.rds.CreateDBInstanceReadReplica.complete-section', - AutoPopulatedParam('PreSignedUrl').document_auto_populated_param), - - # EC2 CopySnapshot documentation customizations - ('docs.*.ec2.CopySnapshot.complete-section', - AutoPopulatedParam('PresignedUrl').document_auto_populated_param), - ('docs.*.ec2.CopySnapshot.complete-section', - AutoPopulatedParam('DestinationRegion').document_auto_populated_param), - # S3 SSE documentation modifications - ('docs.*.s3.*.complete-section', - AutoPopulatedParam('SSECustomerKeyMD5').document_auto_populated_param), - # S3 SSE Copy Source documentation modifications - ('docs.*.s3.*.complete-section', - AutoPopulatedParam( - 'CopySourceSSECustomerKeyMD5').document_auto_populated_param), - # Add base64 information to Lambda - ('docs.*.lambda.UpdateFunctionCode.complete-section', - document_base64_encoding('ZipFile')), - # The following S3 operations cannot actually accept a ContentMD5 - ('docs.*.s3.*.complete-section', - HideParamFromOperations( - 's3', 'ContentMD5', - ['DeleteObjects', 'PutBucketAcl', 'PutBucketCors', - 'PutBucketLifecycle', 'PutBucketLogging', 'PutBucketNotification', - 'PutBucketPolicy', 'PutBucketReplication', 'PutBucketRequestPayment', - 'PutBucketTagging', 'PutBucketVersioning', 'PutBucketWebsite', - 'PutObjectAcl']).hide_param) -] -_add_parameter_aliases(BUILTIN_HANDLERS) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/history.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/history.py deleted file mode 100644 index f4c72dbe..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/history.py +++ /dev/null @@ -1,55 +0,0 @@ -# Copyright 2017 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import logging - - -HISTORY_RECORDER = None -logger = logging.getLogger(__name__) - - -class BaseHistoryHandler(object): - def emit(self, event_type, payload, source): - raise NotImplementedError('emit()') - - -class HistoryRecorder(object): - def __init__(self): - self._enabled = False - self._handlers = [] - - def enable(self): - self._enabled = True - - def disable(self): - self._enabled = False - - def add_handler(self, handler): - self._handlers.append(handler) - - def record(self, event_type, payload, source='BOTOCORE'): - if self._enabled and self._handlers: - for handler in self._handlers: - try: - handler.emit(event_type, payload, source) - except Exception: - # Never let the process die because we had a failure in - # a record collection handler. - logger.debug("Exception raised in %s.", handler, - exc_info=True) - - -def get_global_history_recorder(): - global HISTORY_RECORDER - if HISTORY_RECORDER is None: - HISTORY_RECORDER = HistoryRecorder() - return HISTORY_RECORDER diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/hooks.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/hooks.py deleted file mode 100644 index 2a928956..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/hooks.py +++ /dev/null @@ -1,499 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import copy -import logging -from collections import defaultdict, deque, namedtuple -from botocore.compat import accepts_kwargs, six - -logger = logging.getLogger(__name__) - - -_NodeList = namedtuple('NodeList', ['first', 'middle', 'last']) -_FIRST = 0 -_MIDDLE = 1 -_LAST = 2 - - -class NodeList(_NodeList): - - def __copy__(self): - first_copy = copy.copy(self.first) - middle_copy = copy.copy(self.middle) - last_copy = copy.copy(self.last) - copied = NodeList(first_copy, middle_copy, last_copy) - return copied - - -def first_non_none_response(responses, default=None): - """Find first non None response in a list of tuples. - - This function can be used to find the first non None response from - handlers connected to an event. This is useful if you are interested - in the returned responses from event handlers. Example usage:: - - print(first_non_none_response([(func1, None), (func2, 'foo'), - (func3, 'bar')])) - # This will print 'foo' - - :type responses: list of tuples - :param responses: The responses from the ``EventHooks.emit`` method. - This is a list of tuples, and each tuple is - (handler, handler_response). - - :param default: If no non-None responses are found, then this default - value will be returned. - - :return: The first non-None response in the list of tuples. - - """ - for response in responses: - if response[1] is not None: - return response[1] - return default - - -class BaseEventHooks(object): - def emit(self, event_name, **kwargs): - """Call all handlers subscribed to an event. - - :type event_name: str - :param event_name: The name of the event to emit. - - :type **kwargs: dict - :param **kwargs: Arbitrary kwargs to pass through to the - subscribed handlers. The ``event_name`` will be injected - into the kwargs so it's not necesary to add this to **kwargs. - - :rtype: list of tuples - :return: A list of ``(handler_func, handler_func_return_value)`` - - """ - return [] - - def register(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - """Register an event handler for a given event. - - If a ``unique_id`` is given, the handler will not be registered - if a handler with the ``unique_id`` has already been registered. - - Handlers are called in the order they have been registered. - Note handlers can also be registered with ``register_first()`` - and ``register_last()``. All handlers registered with - ``register_first()`` are called before handlers registered - with ``register()`` which are called before handlers registered - with ``register_last()``. - - """ - self._verify_and_register(event_name, handler, unique_id, - register_method=self._register, - unique_id_uses_count=unique_id_uses_count) - - def register_first(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - """Register an event handler to be called first for an event. - - All event handlers registered with ``register_first()`` will - be called before handlers registered with ``register()`` and - ``register_last()``. - - """ - self._verify_and_register(event_name, handler, unique_id, - register_method=self._register_first, - unique_id_uses_count=unique_id_uses_count) - - def register_last(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - """Register an event handler to be called last for an event. - - All event handlers registered with ``register_last()`` will be called - after handlers registered with ``register_first()`` and ``register()``. - - """ - self._verify_and_register(event_name, handler, unique_id, - register_method=self._register_last, - unique_id_uses_count=unique_id_uses_count) - - def _verify_and_register(self, event_name, handler, unique_id, - register_method, unique_id_uses_count): - self._verify_is_callable(handler) - self._verify_accept_kwargs(handler) - register_method(event_name, handler, unique_id, unique_id_uses_count) - - def unregister(self, event_name, handler=None, unique_id=None, - unique_id_uses_count=False): - """Unregister an event handler for a given event. - - If no ``unique_id`` was given during registration, then the - first instance of the event handler is removed (if the event - handler has been registered multiple times). - - """ - pass - - def _verify_is_callable(self, func): - if not six.callable(func): - raise ValueError("Event handler %s must be callable." % func) - - def _verify_accept_kwargs(self, func): - """Verifies a callable accepts kwargs - - :type func: callable - :param func: A callable object. - - :returns: True, if ``func`` accepts kwargs, otherwise False. - - """ - try: - if not accepts_kwargs(func): - raise ValueError("Event handler %s must accept keyword " - "arguments (**kwargs)" % func) - except TypeError: - return False - - -class HierarchicalEmitter(BaseEventHooks): - def __init__(self): - # We keep a reference to the handlers for quick - # read only access (we never modify self._handlers). - # A cache of event name to handler list. - self._lookup_cache = {} - self._handlers = _PrefixTrie() - # This is used to ensure that unique_id's are only - # registered once. - self._unique_id_handlers = {} - - def _emit(self, event_name, kwargs, stop_on_response=False): - """ - Emit an event with optional keyword arguments. - - :type event_name: string - :param event_name: Name of the event - :type kwargs: dict - :param kwargs: Arguments to be passed to the handler functions. - :type stop_on_response: boolean - :param stop_on_response: Whether to stop on the first non-None - response. If False, then all handlers - will be called. This is especially useful - to handlers which mutate data and then - want to stop propagation of the event. - :rtype: list - :return: List of (handler, response) tuples from all processed - handlers. - """ - responses = [] - # Invoke the event handlers from most specific - # to least specific, each time stripping off a dot. - handlers_to_call = self._lookup_cache.get(event_name) - if handlers_to_call is None: - handlers_to_call = self._handlers.prefix_search(event_name) - self._lookup_cache[event_name] = handlers_to_call - elif not handlers_to_call: - # Short circuit and return an empty response is we have - # no handlers to call. This is the common case where - # for the majority of signals, nothing is listening. - return [] - kwargs['event_name'] = event_name - responses = [] - for handler in handlers_to_call: - logger.debug('Event %s: calling handler %s', event_name, handler) - response = handler(**kwargs) - responses.append((handler, response)) - if stop_on_response and response is not None: - return responses - return responses - - def emit(self, event_name, **kwargs): - """ - Emit an event by name with arguments passed as keyword args. - - >>> responses = emitter.emit( - ... 'my-event.service.operation', arg1='one', arg2='two') - - :rtype: list - :return: List of (handler, response) tuples from all processed - handlers. - """ - return self._emit(event_name, kwargs) - - def emit_until_response(self, event_name, **kwargs): - """ - Emit an event by name with arguments passed as keyword args, - until the first non-``None`` response is received. This - method prevents subsequent handlers from being invoked. - - >>> handler, response = emitter.emit_until_response( - 'my-event.service.operation', arg1='one', arg2='two') - - :rtype: tuple - :return: The first (handler, response) tuple where the response - is not ``None``, otherwise (``None``, ``None``). - """ - responses = self._emit(event_name, kwargs, stop_on_response=True) - if responses: - return responses[-1] - else: - return (None, None) - - def _register(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - self._register_section(event_name, handler, unique_id, - unique_id_uses_count, section=_MIDDLE) - - def _register_first(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - self._register_section(event_name, handler, unique_id, - unique_id_uses_count, section=_FIRST) - - def _register_last(self, event_name, handler, unique_id, - unique_id_uses_count=False): - self._register_section(event_name, handler, unique_id, - unique_id_uses_count, section=_LAST) - - def _register_section(self, event_name, handler, unique_id, - unique_id_uses_count, section): - if unique_id is not None: - if unique_id in self._unique_id_handlers: - # We've already registered a handler using this unique_id - # so we don't need to register it again. - count = self._unique_id_handlers[unique_id].get('count', None) - if unique_id_uses_count: - if not count: - raise ValueError( - "Initial registration of unique id %s was " - "specified to use a counter. Subsequent register " - "calls to unique id must specify use of a counter " - "as well." % unique_id) - else: - self._unique_id_handlers[unique_id]['count'] += 1 - else: - if count: - raise ValueError( - "Initial registration of unique id %s was " - "specified to not use a counter. Subsequent " - "register calls to unique id must specify not to " - "use a counter as well." % unique_id) - return - else: - # Note that the trie knows nothing about the unique - # id. We track uniqueness in this class via the - # _unique_id_handlers. - self._handlers.append_item(event_name, handler, - section=section) - unique_id_handler_item = {'handler': handler} - if unique_id_uses_count: - unique_id_handler_item['count'] = 1 - self._unique_id_handlers[unique_id] = unique_id_handler_item - else: - self._handlers.append_item(event_name, handler, section=section) - # Super simple caching strategy for now, if we change the registrations - # clear the cache. This has the opportunity for smarter invalidations. - self._lookup_cache = {} - - def unregister(self, event_name, handler=None, unique_id=None, - unique_id_uses_count=False): - if unique_id is not None: - try: - count = self._unique_id_handlers[unique_id].get('count', None) - except KeyError: - # There's no handler matching that unique_id so we have - # nothing to unregister. - return - if unique_id_uses_count: - if count is None: - raise ValueError( - "Initial registration of unique id %s was specified to " - "use a counter. Subsequent unregister calls to unique " - "id must specify use of a counter as well." % unique_id) - elif count == 1: - handler = self._unique_id_handlers.pop(unique_id)['handler'] - else: - self._unique_id_handlers[unique_id]['count'] -= 1 - return - else: - if count: - raise ValueError( - "Initial registration of unique id %s was specified " - "to not use a counter. Subsequent unregister calls " - "to unique id must specify not to use a counter as " - "well." % unique_id) - handler = self._unique_id_handlers.pop(unique_id)['handler'] - try: - self._handlers.remove_item(event_name, handler) - self._lookup_cache = {} - except ValueError: - pass - - def __copy__(self): - new_instance = self.__class__() - new_state = self.__dict__.copy() - new_state['_handlers'] = copy.copy(self._handlers) - new_state['_unique_id_handlers'] = copy.copy(self._unique_id_handlers) - new_instance.__dict__ = new_state - return new_instance - - -class _PrefixTrie(object): - """Specialized prefix trie that handles wildcards. - - The prefixes in this case are based on dot separated - names so 'foo.bar.baz' is:: - - foo -> bar -> baz - - Wildcard support just means that having a key such as 'foo.bar.*.baz' will - be matched with a call to ``get_items(key='foo.bar.ANYTHING.baz')``. - - You can think of this prefix trie as the equivalent as defaultdict(list), - except that it can do prefix searches: - - foo.bar.baz -> A - foo.bar -> B - foo -> C - - Calling ``get_items('foo.bar.baz')`` will return [A + B + C], from - most specific to least specific. - - """ - def __init__(self): - # Each dictionary can be though of as a node, where a node - # has values associated with the node, and children is a link - # to more nodes. So 'foo.bar' would have a 'foo' node with - # a 'bar' node as a child of foo. - # {'foo': {'children': {'bar': {...}}}}. - self._root = {'chunk': None, 'children': {}, 'values': None} - - def append_item(self, key, value, section=_MIDDLE): - """Add an item to a key. - - If a value is already associated with that key, the new - value is appended to the list for the key. - """ - key_parts = key.split('.') - current = self._root - for part in key_parts: - if part not in current['children']: - new_child = {'chunk': part, 'values': None, 'children': {}} - current['children'][part] = new_child - current = new_child - else: - current = current['children'][part] - if current['values'] is None: - current['values'] = NodeList([], [], []) - current['values'][section].append(value) - - def prefix_search(self, key): - """Collect all items that are prefixes of key. - - Prefix in this case are delineated by '.' characters so - 'foo.bar.baz' is a 3 chunk sequence of 3 "prefixes" ( - "foo", "bar", and "baz"). - - """ - collected = deque() - key_parts = key.split('.') - current = self._root - self._get_items(current, key_parts, collected, 0) - return collected - - def _get_items(self, starting_node, key_parts, collected, starting_index): - stack = [(starting_node, starting_index)] - key_parts_len = len(key_parts) - # Traverse down the nodes, where at each level we add the - # next part from key_parts as well as the wildcard element '*'. - # This means for each node we see we potentially add two more - # elements to our stack. - while stack: - current_node, index = stack.pop() - if current_node['values']: - # We're using extendleft because we want - # the values associated with the node furthest - # from the root to come before nodes closer - # to the root. extendleft() also adds its items - # in right-left order so .extendleft([1, 2, 3]) - # will result in final_list = [3, 2, 1], which is - # why we reverse the lists. - node_list = current_node['values'] - complete_order = (node_list.first + node_list.middle + - node_list.last) - collected.extendleft(reversed(complete_order)) - if not index == key_parts_len: - children = current_node['children'] - directs = children.get(key_parts[index]) - wildcard = children.get('*') - next_index = index + 1 - if wildcard is not None: - stack.append((wildcard, next_index)) - if directs is not None: - stack.append((directs, next_index)) - - def remove_item(self, key, value): - """Remove an item associated with a key. - - If the value is not associated with the key a ``ValueError`` - will be raised. If the key does not exist in the trie, a - ``ValueError`` will be raised. - - """ - key_parts = key.split('.') - current = self._root - self._remove_item(current, key_parts, value, index=0) - - def _remove_item(self, current_node, key_parts, value, index): - if current_node is None: - return - elif index < len(key_parts): - next_node = current_node['children'].get(key_parts[index]) - if next_node is not None: - self._remove_item(next_node, key_parts, value, index + 1) - if index == len(key_parts) - 1: - node_list = next_node['values'] - if value in node_list.first: - node_list.first.remove(value) - elif value in node_list.middle: - node_list.middle.remove(value) - elif value in node_list.last: - node_list.last.remove(value) - if not next_node['children'] and not next_node['values']: - # Then this is a leaf node with no values so - # we can just delete this link from the parent node. - # This makes subsequent search faster in the case - # where a key does not exist. - del current_node['children'][key_parts[index]] - else: - raise ValueError( - "key is not in trie: %s" % '.'.join(key_parts)) - - def __copy__(self): - # The fact that we're using a nested dict under the covers - # is an implementation detail, and the user shouldn't have - # to know that they'd normally need a deepcopy so we expose - # __copy__ instead of __deepcopy__. - new_copy = self.__class__() - copied_attrs = self._recursive_copy(self.__dict__) - new_copy.__dict__ = copied_attrs - return new_copy - - def _recursive_copy(self, node): - # We can't use copy.deepcopy because we actually only want to copy - # the structure of the trie, not the handlers themselves. - # Each node has a chunk, children, and values. - copied_node = {} - for key, value in node.items(): - if isinstance(value, NodeList): - copied_node[key] = copy.copy(value) - elif isinstance(value, dict): - copied_node[key] = self._recursive_copy(value) - else: - copied_node[key] = value - return copied_node diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/loaders.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/loaders.py deleted file mode 100644 index 24f47a63..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/loaders.py +++ /dev/null @@ -1,461 +0,0 @@ -# Copyright 2012-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Module for loading various model files. - -This module provides the classes that are used to load models used -by botocore. This can include: - - * Service models (e.g. the model for EC2, S3, DynamoDB, etc.) - * Service model extras which customize the service models - * Other models associated with a service (pagination, waiters) - * Non service-specific config (Endpoint data, retry config) - -Loading a module is broken down into several steps: - - * Determining the path to load - * Search the data_path for files to load - * The mechanics of loading the file - * Searching for extras and applying them to the loaded file - -The last item is used so that other faster loading mechanism -besides the default JSON loader can be used. - -The Search Path -=============== - -Similar to how the PATH environment variable is to finding executables -and the PYTHONPATH environment variable is to finding python modules -to import, the botocore loaders have the concept of a data path exposed -through AWS_DATA_PATH. - -This enables end users to provide additional search paths where we -will attempt to load models outside of the models we ship with -botocore. When you create a ``Loader``, there are two paths -automatically added to the model search path: - - * /data/ - * ~/.aws/models - -The first value is the path where all the model files shipped with -botocore are located. - -The second path is so that users can just drop new model files in -``~/.aws/models`` without having to mess around with the AWS_DATA_PATH. - -The AWS_DATA_PATH using the platform specific path separator to -separate entries (typically ``:`` on linux and ``;`` on windows). - - -Directory Layout -================ - -The Loader expects a particular directory layout. In order for any -directory specified in AWS_DATA_PATH to be considered, it must have -this structure for service models:: - - - | - |-- servicename1 - | |-- 2012-10-25 - | |-- service-2.json - |-- ec2 - | |-- 2014-01-01 - | | |-- paginators-1.json - | | |-- service-2.json - | | |-- waiters-2.json - | |-- 2015-03-01 - | |-- paginators-1.json - | |-- service-2.json - | |-- waiters-2.json - | |-- service-2.sdk-extras.json - - -That is: - - * The root directory contains sub directories that are the name - of the services. - * Within each service directory, there's a sub directory for each - available API version. - * Within each API version, there are model specific files, including - (but not limited to): service-2.json, waiters-2.json, paginators-1.json - -The ``-1`` and ``-2`` suffix at the end of the model files denote which version -schema is used within the model. Even though this information is available in -the ``version`` key within the model, this version is also part of the filename -so that code does not need to load the JSON model in order to determine which -version to use. - -The ``sdk-extras`` and similar files represent extra data that needs to be -applied to the model after it is loaded. Data in these files might represent -information that doesn't quite fit in the original models, but is still needed -for the sdk. For instance, additional operation parameters might be added here -which don't represent the actual service api. -""" -import os -import logging - -from botocore import BOTOCORE_ROOT -from botocore.compat import json -from botocore.compat import OrderedDict -from botocore.exceptions import DataNotFoundError, UnknownServiceError -from botocore.utils import deep_merge - - -logger = logging.getLogger(__name__) - - -def instance_cache(func): - """Cache the result of a method on a per instance basis. - - This is not a general purpose caching decorator. In order - for this to be used, it must be used on methods on an - instance, and that instance *must* provide a - ``self._cache`` dictionary. - - """ - def _wrapper(self, *args, **kwargs): - key = (func.__name__,) + args - for pair in sorted(kwargs.items()): - key += pair - if key in self._cache: - return self._cache[key] - data = func(self, *args, **kwargs) - self._cache[key] = data - return data - return _wrapper - - -class JSONFileLoader(object): - """Loader JSON files. - - This class can load the default format of models, which is a JSON file. - - """ - def exists(self, file_path): - """Checks if the file exists. - - :type file_path: str - :param file_path: The full path to the file to load without - the '.json' extension. - - :return: True if file path exists, False otherwise. - - """ - return os.path.isfile(file_path + '.json') - - def load_file(self, file_path): - """Attempt to load the file path. - - :type file_path: str - :param file_path: The full path to the file to load without - the '.json' extension. - - :return: The loaded data if it exists, otherwise None. - - """ - full_path = file_path + '.json' - if not os.path.isfile(full_path): - return - - # By default the file will be opened with locale encoding on Python 3. - # We specify "utf8" here to ensure the correct behavior. - with open(full_path, 'rb') as fp: - payload = fp.read().decode('utf-8') - logger.debug("Loading JSON file: %s", full_path) - return json.loads(payload, object_pairs_hook=OrderedDict) - - -def create_loader(search_path_string=None): - """Create a Loader class. - - This factory function creates a loader given a search string path. - - :type search_string_path: str - :param search_string_path: The AWS_DATA_PATH value. A string - of data path values separated by the ``os.path.pathsep`` value, - which is typically ``:`` on POSIX platforms and ``;`` on - windows. - - :return: A ``Loader`` instance. - - """ - if search_path_string is None: - return Loader() - paths = [] - extra_paths = search_path_string.split(os.pathsep) - for path in extra_paths: - path = os.path.expanduser(os.path.expandvars(path)) - paths.append(path) - return Loader(extra_search_paths=paths) - - -class Loader(object): - """Find and load data models. - - This class will handle searching for and loading data models. - - The main method used here is ``load_service_model``, which is a - convenience method over ``load_data`` and ``determine_latest_version``. - - """ - FILE_LOADER_CLASS = JSONFileLoader - # The included models in botocore/data/ that we ship with botocore. - BUILTIN_DATA_PATH = os.path.join(BOTOCORE_ROOT, 'data') - # For convenience we automatically add ~/.aws/models to the data path. - CUSTOMER_DATA_PATH = os.path.join(os.path.expanduser('~'), - '.aws', 'models') - BUILTIN_EXTRAS_TYPES = ['sdk'] - - def __init__(self, extra_search_paths=None, file_loader=None, - cache=None, include_default_search_paths=True, - include_default_extras=True): - self._cache = {} - if file_loader is None: - file_loader = self.FILE_LOADER_CLASS() - self.file_loader = file_loader - if extra_search_paths is not None: - self._search_paths = extra_search_paths - else: - self._search_paths = [] - if include_default_search_paths: - self._search_paths.extend([self.CUSTOMER_DATA_PATH, - self.BUILTIN_DATA_PATH]) - - self._extras_types = [] - if include_default_extras: - self._extras_types.extend(self.BUILTIN_EXTRAS_TYPES) - - self._extras_processor = ExtrasProcessor() - - @property - def search_paths(self): - return self._search_paths - - @property - def extras_types(self): - return self._extras_types - - @instance_cache - def list_available_services(self, type_name): - """List all known services. - - This will traverse the search path and look for all known - services. - - :type type_name: str - :param type_name: The type of the service (service-2, - paginators-1, waiters-2, etc). This is needed because - the list of available services depends on the service - type. For example, the latest API version available for - a resource-1.json file may not be the latest API version - available for a services-2.json file. - - :return: A list of all services. The list of services will - be sorted. - - """ - services = set() - for possible_path in self._potential_locations(): - # Any directory in the search path is potentially a service. - # We'll collect any initial list of potential services, - # but we'll then need to further process these directories - # by searching for the corresponding type_name in each - # potential directory. - possible_services = [ - d for d in os.listdir(possible_path) - if os.path.isdir(os.path.join(possible_path, d))] - for service_name in possible_services: - full_dirname = os.path.join(possible_path, service_name) - api_versions = os.listdir(full_dirname) - for api_version in api_versions: - full_load_path = os.path.join(full_dirname, - api_version, - type_name) - if self.file_loader.exists(full_load_path): - services.add(service_name) - break - return sorted(services) - - @instance_cache - def determine_latest_version(self, service_name, type_name): - """Find the latest API version available for a service. - - :type service_name: str - :param service_name: The name of the service. - - :type type_name: str - :param type_name: The type of the service (service-2, - paginators-1, waiters-2, etc). This is needed because - the latest API version available can depend on the service - type. For example, the latest API version available for - a resource-1.json file may not be the latest API version - available for a services-2.json file. - - :rtype: str - :return: The latest API version. If the service does not exist - or does not have any available API data, then a - ``DataNotFoundError`` exception will be raised. - - """ - return max(self.list_api_versions(service_name, type_name)) - - @instance_cache - def list_api_versions(self, service_name, type_name): - """List all API versions available for a particular service type - - :type service_name: str - :param service_name: The name of the service - - :type type_name: str - :param type_name: The type name for the service (i.e service-2, - paginators-1, etc.) - - :rtype: list - :return: A list of API version strings in sorted order. - - """ - known_api_versions = set() - for possible_path in self._potential_locations(service_name, - must_exist=True, - is_dir=True): - for dirname in os.listdir(possible_path): - full_path = os.path.join(possible_path, dirname, type_name) - # Only add to the known_api_versions if the directory - # contains a service-2, paginators-1, etc. file corresponding - # to the type_name passed in. - if self.file_loader.exists(full_path): - known_api_versions.add(dirname) - if not known_api_versions: - raise DataNotFoundError(data_path=service_name) - return sorted(known_api_versions) - - @instance_cache - def load_service_model(self, service_name, type_name, api_version=None): - """Load a botocore service model - - This is the main method for loading botocore models (e.g. a service - model, pagination configs, waiter configs, etc.). - - :type service_name: str - :param service_name: The name of the service (e.g ``ec2``, ``s3``). - - :type type_name: str - :param type_name: The model type. Valid types include, but are not - limited to: ``service-2``, ``paginators-1``, ``waiters-2``. - - :type api_version: str - :param api_version: The API version to load. If this is not - provided, then the latest API version will be used. - - :type load_extras: bool - :param load_extras: Whether or not to load the tool extras which - contain additional data to be added to the model. - - :raises: UnknownServiceError if there is no known service with - the provided service_name. - - :raises: DataNotFoundError if no data could be found for the - service_name/type_name/api_version. - - :return: The loaded data, as a python type (e.g. dict, list, etc). - """ - # Wrapper around the load_data. This will calculate the path - # to call load_data with. - known_services = self.list_available_services(type_name) - if service_name not in known_services: - raise UnknownServiceError( - service_name=service_name, - known_service_names=', '.join(sorted(known_services))) - if api_version is None: - api_version = self.determine_latest_version( - service_name, type_name) - full_path = os.path.join(service_name, api_version, type_name) - model = self.load_data(full_path) - - # Load in all the extras - extras_data = self._find_extras(service_name, type_name, api_version) - self._extras_processor.process(model, extras_data) - - return model - - def _find_extras(self, service_name, type_name, api_version): - """Creates an iterator over all the extras data.""" - for extras_type in self.extras_types: - extras_name = '%s.%s-extras' % (type_name, extras_type) - full_path = os.path.join(service_name, api_version, extras_name) - - try: - yield self.load_data(full_path) - except DataNotFoundError: - pass - - @instance_cache - def load_data(self, name): - """Load data given a data path. - - This is a low level method that will search through the various - search paths until it's able to load a value. This is typically - only needed to load *non* model files (such as _endpoints and - _retry). If you need to load model files, you should prefer - ``load_service_model``. - - :type name: str - :param name: The data path, i.e ``ec2/2015-03-01/service-2``. - - :return: The loaded data. If no data could be found then - a DataNotFoundError is raised. - - """ - for possible_path in self._potential_locations(name): - found = self.file_loader.load_file(possible_path) - if found is not None: - return found - # We didn't find anything that matched on any path. - raise DataNotFoundError(data_path=name) - - def _potential_locations(self, name=None, must_exist=False, - is_dir=False): - # Will give an iterator over the full path of potential locations - # according to the search path. - for path in self.search_paths: - if os.path.isdir(path): - full_path = path - if name is not None: - full_path = os.path.join(path, name) - if not must_exist: - yield full_path - else: - if is_dir and os.path.isdir(full_path): - yield full_path - elif os.path.exists(full_path): - yield full_path - - -class ExtrasProcessor(object): - """Processes data from extras files into service models.""" - def process(self, original_model, extra_models): - """Processes data from a list of loaded extras files into a model - - :type original_model: dict - :param original_model: The service model to load all the extras into. - - :type extra_models: iterable of dict - :param extra_models: A list of loaded extras models. - """ - for extras in extra_models: - self._process(original_model, extras) - - def _process(self, model, extra_model): - """Process a single extras model into a service model.""" - if 'merge' in extra_model: - deep_merge(model, extra_model['merge']) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/model.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/model.py deleted file mode 100644 index 295dd47c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/model.py +++ /dev/null @@ -1,735 +0,0 @@ -# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Abstractions to interact with service models.""" -from collections import defaultdict - -from botocore.utils import CachedProperty, instance_cache -from botocore.compat import OrderedDict - - -NOT_SET = object() - - -class NoShapeFoundError(Exception): - pass - - -class InvalidShapeError(Exception): - pass - - -class OperationNotFoundError(Exception): - pass - - -class InvalidShapeReferenceError(Exception): - pass - - -class UndefinedModelAttributeError(Exception): - pass - - -class Shape(object): - """Object representing a shape from the service model.""" - # To simplify serialization logic, all shape params that are - # related to serialization are moved from the top level hash into - # a 'serialization' hash. This list below contains the names of all - # the attributes that should be moved. - SERIALIZED_ATTRS = ['locationName', 'queryName', 'flattened', 'location', - 'payload', 'streaming', 'timestampFormat', - 'xmlNamespace', 'resultWrapper', 'xmlAttribute', - 'eventstream', 'event', 'eventheader', 'eventpayload', - 'jsonvalue', 'timestampFormat'] - METADATA_ATTRS = ['required', 'min', 'max', 'sensitive', 'enum', - 'idempotencyToken', 'error', 'exception'] - MAP_TYPE = OrderedDict - - def __init__(self, shape_name, shape_model, shape_resolver=None): - """ - - :type shape_name: string - :param shape_name: The name of the shape. - - :type shape_model: dict - :param shape_model: The shape model. This would be the value - associated with the key in the "shapes" dict of the - service model (i.e ``model['shapes'][shape_name]``) - - :type shape_resolver: botocore.model.ShapeResolver - :param shape_resolver: A shape resolver object. This is used to - resolve references to other shapes. For scalar shape types - (string, integer, boolean, etc.), this argument is not - required. If a shape_resolver is not provided for a complex - type, then a ``ValueError`` will be raised when an attempt - to resolve a shape is made. - - """ - self.name = shape_name - self.type_name = shape_model['type'] - self.documentation = shape_model.get('documentation', '') - self._shape_model = shape_model - if shape_resolver is None: - # If a shape_resolver is not provided, we create an object - # that will throw errors if you attempt to resolve - # a shape. This is actually ok for scalar shapes - # because they don't need to resolve shapes and shouldn't - # be required to provide an object they won't use. - shape_resolver = UnresolvableShapeMap() - self._shape_resolver = shape_resolver - self._cache = {} - - @CachedProperty - def serialization(self): - """Serialization information about the shape. - - This contains information that may be needed for input serialization - or response parsing. This can include: - - * name - * queryName - * flattened - * location - * payload - * streaming - * xmlNamespace - * resultWrapper - * xmlAttribute - * jsonvalue - * timestampFormat - - :rtype: dict - :return: Serialization information about the shape. - - """ - model = self._shape_model - serialization = {} - for attr in self.SERIALIZED_ATTRS: - if attr in self._shape_model: - serialization[attr] = model[attr] - # For consistency, locationName is renamed to just 'name'. - if 'locationName' in serialization: - serialization['name'] = serialization.pop('locationName') - return serialization - - @CachedProperty - def metadata(self): - """Metadata about the shape. - - This requires optional information about the shape, including: - - * min - * max - * enum - * sensitive - * required - * idempotencyToken - - :rtype: dict - :return: Metadata about the shape. - - """ - model = self._shape_model - metadata = {} - for attr in self.METADATA_ATTRS: - if attr in self._shape_model: - metadata[attr] = model[attr] - return metadata - - @CachedProperty - def required_members(self): - """A list of members that are required. - - A structure shape can define members that are required. - This value will return a list of required members. If there - are no required members an empty list is returned. - - """ - return self.metadata.get('required', []) - - def _resolve_shape_ref(self, shape_ref): - return self._shape_resolver.resolve_shape_ref(shape_ref) - - def __repr__(self): - return "<%s(%s)>" % (self.__class__.__name__, - self.name) - - -class StructureShape(Shape): - @CachedProperty - def members(self): - members = self._shape_model['members'] - # The members dict looks like: - # 'members': { - # 'MemberName': {'shape': 'shapeName'}, - # 'MemberName2': {'shape': 'shapeName'}, - # } - # We return a dict of member name to Shape object. - shape_members = self.MAP_TYPE() - for name, shape_ref in members.items(): - shape_members[name] = self._resolve_shape_ref(shape_ref) - return shape_members - - -class ListShape(Shape): - @CachedProperty - def member(self): - return self._resolve_shape_ref(self._shape_model['member']) - - -class MapShape(Shape): - @CachedProperty - def key(self): - return self._resolve_shape_ref(self._shape_model['key']) - - @CachedProperty - def value(self): - return self._resolve_shape_ref(self._shape_model['value']) - - -class StringShape(Shape): - @CachedProperty - def enum(self): - return self.metadata.get('enum', []) - - -class ServiceModel(object): - """ - - :ivar service_description: The parsed service description dictionary. - - """ - - def __init__(self, service_description, service_name=None): - """ - - :type service_description: dict - :param service_description: The service description model. This value - is obtained from a botocore.loader.Loader, or from directly loading - the file yourself:: - - service_description = json.load( - open('/path/to/service-description-model.json')) - model = ServiceModel(service_description) - - :type service_name: str - :param service_name: The name of the service. Normally this is - the endpoint prefix defined in the service_description. However, - you can override this value to provide a more convenient name. - This is done in a few places in botocore (ses instead of email, - emr instead of elasticmapreduce). If this value is not provided, - it will default to the endpointPrefix defined in the model. - - """ - self._service_description = service_description - # We want clients to be able to access metadata directly. - self.metadata = service_description.get('metadata', {}) - self._shape_resolver = ShapeResolver( - service_description.get('shapes', {})) - self._signature_version = NOT_SET - self._service_name = service_name - self._instance_cache = {} - - def shape_for(self, shape_name, member_traits=None): - return self._shape_resolver.get_shape_by_name( - shape_name, member_traits) - - def resolve_shape_ref(self, shape_ref): - return self._shape_resolver.resolve_shape_ref(shape_ref) - - @CachedProperty - def shape_names(self): - return list(self._service_description.get('shapes', {})) - - @instance_cache - def operation_model(self, operation_name): - try: - model = self._service_description['operations'][operation_name] - except KeyError: - raise OperationNotFoundError(operation_name) - return OperationModel(model, self, operation_name) - - @CachedProperty - def documentation(self): - return self._service_description.get('documentation', '') - - @CachedProperty - def operation_names(self): - return list(self._service_description.get('operations', [])) - - @CachedProperty - def service_name(self): - """The name of the service. - - This defaults to the endpointPrefix defined in the service model. - However, this value can be overriden when a ``ServiceModel`` is - created. If a service_name was not provided when the ``ServiceModel`` - was created and if there is no endpointPrefix defined in the - service model, then an ``UndefinedModelAttributeError`` exception - will be raised. - - """ - if self._service_name is not None: - return self._service_name - else: - return self.endpoint_prefix - - @CachedProperty - def service_id(self): - return self._get_metadata_property('serviceId') - - @CachedProperty - def signing_name(self): - """The name to use when computing signatures. - - If the model does not define a signing name, this - value will be the endpoint prefix defined in the model. - """ - signing_name = self.metadata.get('signingName') - if signing_name is None: - signing_name = self.endpoint_prefix - return signing_name - - @CachedProperty - def api_version(self): - return self._get_metadata_property('apiVersion') - - @CachedProperty - def protocol(self): - return self._get_metadata_property('protocol') - - @CachedProperty - def endpoint_prefix(self): - return self._get_metadata_property('endpointPrefix') - - def _get_metadata_property(self, name): - try: - return self.metadata[name] - except KeyError: - raise UndefinedModelAttributeError( - '"%s" not defined in the metadata of the model: %s' % - (name, self)) - - # Signature version is one of the rare properties - # than can be modified so a CachedProperty is not used here. - - @property - def signature_version(self): - if self._signature_version is NOT_SET: - signature_version = self.metadata.get('signatureVersion') - self._signature_version = signature_version - return self._signature_version - - @signature_version.setter - def signature_version(self, value): - self._signature_version = value - - -class OperationModel(object): - def __init__(self, operation_model, service_model, name=None): - """ - - :type operation_model: dict - :param operation_model: The operation model. This comes from the - service model, and is the value associated with the operation - name in the service model (i.e ``model['operations'][op_name]``). - - :type service_model: botocore.model.ServiceModel - :param service_model: The service model associated with the operation. - - :type name: string - :param name: The operation name. This is the operation name exposed to - the users of this model. This can potentially be different from - the "wire_name", which is the operation name that *must* by - provided over the wire. For example, given:: - - "CreateCloudFrontOriginAccessIdentity":{ - "name":"CreateCloudFrontOriginAccessIdentity2014_11_06", - ... - } - - The ``name`` would be ``CreateCloudFrontOriginAccessIdentity``, - but the ``self.wire_name`` would be - ``CreateCloudFrontOriginAccessIdentity2014_11_06``, which is the - value we must send in the corresponding HTTP request. - - """ - self._operation_model = operation_model - self._service_model = service_model - self._api_name = name - # Clients can access '.name' to get the operation name - # and '.metadata' to get the top level metdata of the service. - self._wire_name = operation_model.get('name') - self.metadata = service_model.metadata - self.http = operation_model.get('http', {}) - - @CachedProperty - def name(self): - if self._api_name is not None: - return self._api_name - else: - return self.wire_name - - @property - def wire_name(self): - """The wire name of the operation. - - In many situations this is the same value as the - ``name``, value, but in some services, the operation name - exposed to the user is different from the operaiton name - we send across the wire (e.g cloudfront). - - Any serialization code should use ``wire_name``. - - """ - return self._operation_model.get('name') - - @property - def service_model(self): - return self._service_model - - @CachedProperty - def documentation(self): - return self._operation_model.get('documentation', '') - - @CachedProperty - def deprecated(self): - return self._operation_model.get('deprecated', False) - - @CachedProperty - def input_shape(self): - if 'input' not in self._operation_model: - # Some operations do not accept any input and do not define an - # input shape. - return None - return self._service_model.resolve_shape_ref( - self._operation_model['input']) - - @CachedProperty - def output_shape(self): - if 'output' not in self._operation_model: - # Some operations do not define an output shape, - # in which case we return None to indicate the - # operation has no expected output. - return None - return self._service_model.resolve_shape_ref( - self._operation_model['output']) - - @CachedProperty - def idempotent_members(self): - input_shape = self.input_shape - if not input_shape: - return [] - - return [name for (name, shape) in input_shape.members.items() - if 'idempotencyToken' in shape.metadata and - shape.metadata['idempotencyToken']] - - @CachedProperty - def auth_type(self): - return self._operation_model.get('authtype') - - @CachedProperty - def error_shapes(self): - shapes = self._operation_model.get("errors", []) - return list(self._service_model.resolve_shape_ref(s) for s in shapes) - - @CachedProperty - def has_event_stream_input(self): - return self.get_event_stream_input() is not None - - @CachedProperty - def has_event_stream_output(self): - return self.get_event_stream_output() is not None - - def get_event_stream_input(self): - return self._get_event_stream(self.input_shape) - - def get_event_stream_output(self): - return self._get_event_stream(self.output_shape) - - def _get_event_stream(self, shape): - """Returns the event stream member's shape if any or None otherwise.""" - if shape is None: - return None - for member in shape.members.values(): - if member.serialization.get('eventstream'): - return member - return None - - @CachedProperty - def has_streaming_input(self): - return self.get_streaming_input() is not None - - @CachedProperty - def has_streaming_output(self): - return self.get_streaming_output() is not None - - def get_streaming_input(self): - return self._get_streaming_body(self.input_shape) - - def get_streaming_output(self): - return self._get_streaming_body(self.output_shape) - - def _get_streaming_body(self, shape): - """Returns the streaming member's shape if any; or None otherwise.""" - if shape is None: - return None - payload = shape.serialization.get('payload') - if payload is not None: - payload_shape = shape.members[payload] - if payload_shape.type_name == 'blob': - return payload_shape - return None - - def __repr__(self): - return '%s(name=%s)' % (self.__class__.__name__, self.name) - - -class ShapeResolver(object): - """Resolves shape references.""" - - # Any type not in this mapping will default to the Shape class. - SHAPE_CLASSES = { - 'structure': StructureShape, - 'list': ListShape, - 'map': MapShape, - 'string': StringShape - } - - def __init__(self, shape_map): - self._shape_map = shape_map - self._shape_cache = {} - - def get_shape_by_name(self, shape_name, member_traits=None): - try: - shape_model = self._shape_map[shape_name] - except KeyError: - raise NoShapeFoundError(shape_name) - try: - shape_cls = self.SHAPE_CLASSES.get(shape_model['type'], Shape) - except KeyError: - raise InvalidShapeError("Shape is missing required key 'type': %s" - % shape_model) - if member_traits: - shape_model = shape_model.copy() - shape_model.update(member_traits) - result = shape_cls(shape_name, shape_model, self) - return result - - def resolve_shape_ref(self, shape_ref): - # A shape_ref is a dict that has a 'shape' key that - # refers to a shape name as well as any additional - # member traits that are then merged over the shape - # definition. For example: - # {"shape": "StringType", "locationName": "Foobar"} - if len(shape_ref) == 1 and 'shape' in shape_ref: - # It's just a shape ref with no member traits, we can avoid - # a .copy(). This is the common case so it's specifically - # called out here. - return self.get_shape_by_name(shape_ref['shape']) - else: - member_traits = shape_ref.copy() - try: - shape_name = member_traits.pop('shape') - except KeyError: - raise InvalidShapeReferenceError( - "Invalid model, missing shape reference: %s" % shape_ref) - return self.get_shape_by_name(shape_name, member_traits) - - -class UnresolvableShapeMap(object): - """A ShapeResolver that will throw ValueErrors when shapes are resolved. - """ - def get_shape_by_name(self, shape_name, member_traits=None): - raise ValueError("Attempted to lookup shape '%s', but no shape " - "map was provided.") - - def resolve_shape_ref(self, shape_ref): - raise ValueError("Attempted to resolve shape '%s', but no shape " - "map was provided.") - - -class DenormalizedStructureBuilder(object): - """Build a StructureShape from a denormalized model. - - This is a convenience builder class that makes it easy to construct - ``StructureShape``s based on a denormalized model. - - It will handle the details of creating unique shape names and creating - the appropriate shape map needed by the ``StructureShape`` class. - - Example usage:: - - builder = DenormalizedStructureBuilder() - shape = builder.with_members({ - 'A': { - 'type': 'structure', - 'members': { - 'B': { - 'type': 'structure', - 'members': { - 'C': { - 'type': 'string', - } - } - } - } - } - }).build_model() - # ``shape`` is now an instance of botocore.model.StructureShape - - :type dict_type: class - :param dict_type: The dictionary type to use, allowing you to opt-in - to using OrderedDict or another dict type. This can - be particularly useful for testing when order - matters, such as for documentation. - - """ - def __init__(self, name=None): - self.members = OrderedDict() - self._name_generator = ShapeNameGenerator() - if name is None: - self.name = self._name_generator.new_shape_name('structure') - - def with_members(self, members): - """ - - :type members: dict - :param members: The denormalized members. - - :return: self - - """ - self._members = members - return self - - def build_model(self): - """Build the model based on the provided members. - - :rtype: botocore.model.StructureShape - :return: The built StructureShape object. - - """ - shapes = OrderedDict() - denormalized = { - 'type': 'structure', - 'members': self._members, - } - self._build_model(denormalized, shapes, self.name) - resolver = ShapeResolver(shape_map=shapes) - return StructureShape(shape_name=self.name, - shape_model=shapes[self.name], - shape_resolver=resolver) - - def _build_model(self, model, shapes, shape_name): - if model['type'] == 'structure': - shapes[shape_name] = self._build_structure(model, shapes) - elif model['type'] == 'list': - shapes[shape_name] = self._build_list(model, shapes) - elif model['type'] == 'map': - shapes[shape_name] = self._build_map(model, shapes) - elif model['type'] in ['string', 'integer', 'boolean', 'blob', 'float', - 'timestamp', 'long', 'double', 'char']: - shapes[shape_name] = self._build_scalar(model) - else: - raise InvalidShapeError("Unknown shape type: %s" % model['type']) - - def _build_structure(self, model, shapes): - members = OrderedDict() - shape = self._build_initial_shape(model) - shape['members'] = members - - for name, member_model in model['members'].items(): - member_shape_name = self._get_shape_name(member_model) - members[name] = {'shape': member_shape_name} - self._build_model(member_model, shapes, member_shape_name) - return shape - - def _build_list(self, model, shapes): - member_shape_name = self._get_shape_name(model) - shape = self._build_initial_shape(model) - shape['member'] = {'shape': member_shape_name} - self._build_model(model['member'], shapes, member_shape_name) - return shape - - def _build_map(self, model, shapes): - key_shape_name = self._get_shape_name(model['key']) - value_shape_name = self._get_shape_name(model['value']) - shape = self._build_initial_shape(model) - shape['key'] = {'shape': key_shape_name} - shape['value'] = {'shape': value_shape_name} - self._build_model(model['key'], shapes, key_shape_name) - self._build_model(model['value'], shapes, value_shape_name) - return shape - - def _build_initial_shape(self, model): - shape = { - 'type': model['type'], - } - if 'documentation' in model: - shape['documentation'] = model['documentation'] - if 'enum' in model: - shape['enum'] = model['enum'] - return shape - - def _build_scalar(self, model): - return self._build_initial_shape(model) - - def _get_shape_name(self, model): - if 'shape_name' in model: - return model['shape_name'] - else: - return self._name_generator.new_shape_name(model['type']) - - -class ShapeNameGenerator(object): - """Generate unique shape names for a type. - - This class can be used in conjunction with the DenormalizedStructureBuilder - to generate unique shape names for a given type. - - """ - def __init__(self): - self._name_cache = defaultdict(int) - - def new_shape_name(self, type_name): - """Generate a unique shape name. - - This method will guarantee a unique shape name each time it is - called with the same type. - - :: - - >>> s = ShapeNameGenerator() - >>> s.new_shape_name('structure') - 'StructureType1' - >>> s.new_shape_name('structure') - 'StructureType2' - >>> s.new_shape_name('list') - 'ListType1' - >>> s.new_shape_name('list') - 'ListType2' - - - :type type_name: string - :param type_name: The type name (structure, list, map, string, etc.) - - :rtype: string - :return: A unique shape name for the given type - - """ - self._name_cache[type_name] += 1 - current_index = self._name_cache[type_name] - return '%sType%s' % (type_name.capitalize(), - current_index) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/paginate.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/paginate.py deleted file mode 100644 index 7ca13ae2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/paginate.py +++ /dev/null @@ -1,675 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -from itertools import tee - -from botocore.compat import six - -import jmespath -import json -import base64 -import logging -from botocore.exceptions import PaginationError -from botocore.compat import zip -from botocore.utils import set_value_from_jmespath, merge_dicts - - -log = logging.getLogger(__name__) - - -class TokenEncoder(object): - """Encodes dictionaries into opaque strings. - - This for the most part json dumps + base64 encoding, but also supports - having bytes in the dictionary in addition to the types that json can - handle by default. - - This is intended for use in encoding pagination tokens, which in some - cases can be complex structures and / or contain bytes. - """ - - def encode(self, token): - """Encodes a dictionary to an opaque string. - - :type token: dict - :param token: A dictionary containing pagination information, - particularly the service pagination token(s) but also other boto - metadata. - - :rtype: str - :returns: An opaque string - """ - try: - # Try just using json dumps first to avoid having to traverse - # and encode the dict. In 99.9999% of cases this will work. - json_string = json.dumps(token) - except (TypeError, UnicodeDecodeError): - # If normal dumping failed, go through and base64 encode all bytes. - encoded_token, encoded_keys = self._encode(token, []) - - # Save the list of all the encoded key paths. We can safely - # assume that no service will ever use this key. - encoded_token['boto_encoded_keys'] = encoded_keys - - # Now that the bytes are all encoded, dump the json. - json_string = json.dumps(encoded_token) - - # base64 encode the json string to produce an opaque token string. - return base64.b64encode(json_string.encode('utf-8')).decode('utf-8') - - def _encode(self, data, path): - """Encode bytes in given data, keeping track of the path traversed.""" - if isinstance(data, dict): - return self._encode_dict(data, path) - elif isinstance(data, list): - return self._encode_list(data, path) - elif isinstance(data, six.binary_type): - return self._encode_bytes(data, path) - else: - return data, [] - - def _encode_list(self, data, path): - """Encode any bytes in a list, noting the index of what is encoded.""" - new_data = [] - encoded = [] - for i, value in enumerate(data): - new_path = path + [i] - new_value, new_encoded = self._encode(value, new_path) - new_data.append(new_value) - encoded.extend(new_encoded) - return new_data, encoded - - def _encode_dict(self, data, path): - """Encode any bytes in a dict, noting the index of what is encoded.""" - new_data = {} - encoded = [] - for key, value in data.items(): - new_path = path + [key] - new_value, new_encoded = self._encode(value, new_path) - new_data[key] = new_value - encoded.extend(new_encoded) - return new_data, encoded - - def _encode_bytes(self, data, path): - """Base64 encode a byte string.""" - return base64.b64encode(data).decode('utf-8'), [path] - - -class TokenDecoder(object): - """Decodes token strings back into dictionaries. - - This performs the inverse operation to the TokenEncoder, accepting - opaque strings and decoding them into a useable form. - """ - - def decode(self, token): - """Decodes an opaque string to a dictionary. - - :type token: str - :param token: A token string given by the botocore pagination - interface. - - :rtype: dict - :returns: A dictionary containing pagination information, - particularly the service pagination token(s) but also other boto - metadata. - """ - json_string = base64.b64decode(token.encode('utf-8')).decode('utf-8') - decoded_token = json.loads(json_string) - - # Remove the encoding metadata as it is read since it will no longer - # be needed. - encoded_keys = decoded_token.pop('boto_encoded_keys', None) - if encoded_keys is None: - return decoded_token - else: - return self._decode(decoded_token, encoded_keys) - - def _decode(self, token, encoded_keys): - """Find each encoded value and decode it.""" - for key in encoded_keys: - encoded = self._path_get(token, key) - decoded = base64.b64decode(encoded.encode('utf-8')) - self._path_set(token, key, decoded) - return token - - def _path_get(self, data, path): - """Return the nested data at the given path. - - For instance: - data = {'foo': ['bar', 'baz']} - path = ['foo', 0] - ==> 'bar' - """ - # jmespath isn't used here because it would be difficult to actually - # create the jmespath query when taking all of the unknowns of key - # structure into account. Gross though this is, it is simple and not - # very error prone. - d = data - for step in path: - d = d[step] - return d - - def _path_set(self, data, path, value): - """Set the value of a key in the given data. - - Example: - data = {'foo': ['bar', 'baz']} - path = ['foo', 1] - value = 'bin' - ==> data = {'foo': ['bar', 'bin']} - """ - container = self._path_get(data, path[:-1]) - container[path[-1]] = value - - -class PaginatorModel(object): - def __init__(self, paginator_config): - self._paginator_config = paginator_config['pagination'] - - def get_paginator(self, operation_name): - try: - single_paginator_config = self._paginator_config[operation_name] - except KeyError: - raise ValueError("Paginator for operation does not exist: %s" - % operation_name) - return single_paginator_config - - -class PageIterator(object): - def __init__(self, method, input_token, output_token, more_results, - result_keys, non_aggregate_keys, limit_key, max_items, - starting_token, page_size, op_kwargs): - self._method = method - self._input_token = input_token - self._output_token = output_token - self._more_results = more_results - self._result_keys = result_keys - self._max_items = max_items - self._limit_key = limit_key - self._starting_token = starting_token - self._page_size = page_size - self._op_kwargs = op_kwargs - self._resume_token = None - self._non_aggregate_key_exprs = non_aggregate_keys - self._non_aggregate_part = {} - self._token_encoder = TokenEncoder() - self._token_decoder = TokenDecoder() - - @property - def result_keys(self): - return self._result_keys - - @property - def resume_token(self): - """Token to specify to resume pagination.""" - return self._resume_token - - @resume_token.setter - def resume_token(self, value): - if not isinstance(value, dict): - raise ValueError("Bad starting token: %s" % value) - - if 'boto_truncate_amount' in value: - token_keys = sorted(self._input_token + ['boto_truncate_amount']) - else: - token_keys = sorted(self._input_token) - dict_keys = sorted(value.keys()) - - if token_keys == dict_keys: - self._resume_token = self._token_encoder.encode(value) - else: - raise ValueError("Bad starting token: %s" % value) - - @property - def non_aggregate_part(self): - return self._non_aggregate_part - - def __iter__(self): - current_kwargs = self._op_kwargs - previous_next_token = None - next_token = dict((key, None) for key in self._input_token) - if self._starting_token is not None: - # If the starting token exists, populate the next_token with the - # values inside it. This ensures that we have the service's - # pagination token on hand if we need to truncate after the - # first response. - next_token = self._parse_starting_token()[0] - # The number of items from result_key we've seen so far. - total_items = 0 - first_request = True - primary_result_key = self.result_keys[0] - starting_truncation = 0 - self._inject_starting_params(current_kwargs) - while True: - response = self._make_request(current_kwargs) - parsed = self._extract_parsed_response(response) - if first_request: - # The first request is handled differently. We could - # possibly have a resume/starting token that tells us where - # to index into the retrieved page. - if self._starting_token is not None: - starting_truncation = self._handle_first_request( - parsed, primary_result_key, starting_truncation) - first_request = False - self._record_non_aggregate_key_values(parsed) - else: - # If this isn't the first request, we have already sliced into - # the first request and had to make additional requests after. - # We no longer need to add this to truncation. - starting_truncation = 0 - current_response = primary_result_key.search(parsed) - if current_response is None: - current_response = [] - num_current_response = len(current_response) - truncate_amount = 0 - if self._max_items is not None: - truncate_amount = (total_items + num_current_response) \ - - self._max_items - if truncate_amount > 0: - self._truncate_response(parsed, primary_result_key, - truncate_amount, starting_truncation, - next_token) - yield response - break - else: - yield response - total_items += num_current_response - next_token = self._get_next_token(parsed) - if all(t is None for t in next_token.values()): - break - if self._max_items is not None and \ - total_items == self._max_items: - # We're on a page boundary so we can set the current - # next token to be the resume token. - self.resume_token = next_token - break - if previous_next_token is not None and \ - previous_next_token == next_token: - message = ("The same next token was received " - "twice: %s" % next_token) - raise PaginationError(message=message) - self._inject_token_into_kwargs(current_kwargs, next_token) - previous_next_token = next_token - - def search(self, expression): - """Applies a JMESPath expression to a paginator - - Each page of results is searched using the provided JMESPath - expression. If the result is not a list, it is yielded - directly. If the result is a list, each element in the result - is yielded individually (essentially implementing a flatmap in - which the JMESPath search is the mapping function). - - :type expression: str - :param expression: JMESPath expression to apply to each page. - - :return: Returns an iterator that yields the individual - elements of applying a JMESPath expression to each page of - results. - """ - compiled = jmespath.compile(expression) - for page in self: - results = compiled.search(page) - if isinstance(results, list): - for element in results: - yield element - else: - # Yield result directly if it is not a list. - yield results - - def _make_request(self, current_kwargs): - return self._method(**current_kwargs) - - def _extract_parsed_response(self, response): - return response - - def _record_non_aggregate_key_values(self, response): - non_aggregate_keys = {} - for expression in self._non_aggregate_key_exprs: - result = expression.search(response) - set_value_from_jmespath(non_aggregate_keys, - expression.expression, - result) - self._non_aggregate_part = non_aggregate_keys - - def _inject_starting_params(self, op_kwargs): - # If the user has specified a starting token we need to - # inject that into the operation's kwargs. - if self._starting_token is not None: - # Don't need to do anything special if there is no starting - # token specified. - next_token = self._parse_starting_token()[0] - self._inject_token_into_kwargs(op_kwargs, next_token) - if self._page_size is not None: - # Pass the page size as the parameter name for limiting - # page size, also known as the limit_key. - op_kwargs[self._limit_key] = self._page_size - - def _inject_token_into_kwargs(self, op_kwargs, next_token): - for name, token in next_token.items(): - if (token is not None) and (token != 'None'): - op_kwargs[name] = token - elif name in op_kwargs: - del op_kwargs[name] - - def _handle_first_request(self, parsed, primary_result_key, - starting_truncation): - # If the payload is an array or string, we need to slice into it - # and only return the truncated amount. - starting_truncation = self._parse_starting_token()[1] - all_data = primary_result_key.search(parsed) - if isinstance(all_data, (list, six.string_types)): - data = all_data[starting_truncation:] - else: - data = None - set_value_from_jmespath( - parsed, - primary_result_key.expression, - data - ) - # We also need to truncate any secondary result keys - # because they were not truncated in the previous last - # response. - for token in self.result_keys: - if token == primary_result_key: - continue - sample = token.search(parsed) - if isinstance(sample, list): - empty_value = [] - elif isinstance(sample, six.string_types): - empty_value = '' - elif isinstance(sample, (int, float)): - empty_value = 0 - else: - empty_value = None - set_value_from_jmespath(parsed, token.expression, empty_value) - return starting_truncation - - def _truncate_response(self, parsed, primary_result_key, truncate_amount, - starting_truncation, next_token): - original = primary_result_key.search(parsed) - if original is None: - original = [] - amount_to_keep = len(original) - truncate_amount - truncated = original[:amount_to_keep] - set_value_from_jmespath( - parsed, - primary_result_key.expression, - truncated - ) - # The issue here is that even though we know how much we've truncated - # we need to account for this globally including any starting - # left truncation. For example: - # Raw response: [0,1,2,3] - # Starting index: 1 - # Max items: 1 - # Starting left truncation: [1, 2, 3] - # End right truncation for max items: [1] - # However, even though we only kept 1, this is post - # left truncation so the next starting index should be 2, not 1 - # (left_truncation + amount_to_keep). - next_token['boto_truncate_amount'] = \ - amount_to_keep + starting_truncation - self.resume_token = next_token - - def _get_next_token(self, parsed): - if self._more_results is not None: - if not self._more_results.search(parsed): - return {} - next_tokens = {} - for output_token, input_key in \ - zip(self._output_token, self._input_token): - next_token = output_token.search(parsed) - # We do not want to include any empty strings as actual tokens. - # Treat them as None. - if next_token: - next_tokens[input_key] = next_token - else: - next_tokens[input_key] = None - return next_tokens - - def result_key_iters(self): - teed_results = tee(self, len(self.result_keys)) - return [ResultKeyIterator(i, result_key) for i, result_key - in zip(teed_results, self.result_keys)] - - def build_full_result(self): - complete_result = {} - for response in self: - page = response - # We want to try to catch operation object pagination - # and format correctly for those. They come in the form - # of a tuple of two elements: (http_response, parsed_responsed). - # We want the parsed_response as that is what the page iterator - # uses. We can remove it though once operation objects are removed. - if isinstance(response, tuple) and len(response) == 2: - page = response[1] - # We're incrementally building the full response page - # by page. For each page in the response we need to - # inject the necessary components from the page - # into the complete_result. - for result_expression in self.result_keys: - # In order to incrementally update a result key - # we need to search the existing value from complete_result, - # then we need to search the _current_ page for the - # current result key value. Then we append the current - # value onto the existing value, and re-set that value - # as the new value. - result_value = result_expression.search(page) - if result_value is None: - continue - existing_value = result_expression.search(complete_result) - if existing_value is None: - # Set the initial result - set_value_from_jmespath( - complete_result, result_expression.expression, - result_value) - continue - # Now both result_value and existing_value contain something - if isinstance(result_value, list): - existing_value.extend(result_value) - elif isinstance(result_value, (int, float, six.string_types)): - # Modify the existing result with the sum or concatenation - set_value_from_jmespath( - complete_result, result_expression.expression, - existing_value + result_value) - merge_dicts(complete_result, self.non_aggregate_part) - if self.resume_token is not None: - complete_result['NextToken'] = self.resume_token - return complete_result - - def _parse_starting_token(self): - if self._starting_token is None: - return None - - # The starting token is a dict passed as a base64 encoded string. - next_token = self._starting_token - try: - next_token = self._token_decoder.decode(next_token) - index = 0 - if 'boto_truncate_amount' in next_token: - index = next_token.get('boto_truncate_amount') - del next_token['boto_truncate_amount'] - except (ValueError, TypeError): - next_token, index = self._parse_starting_token_deprecated() - return next_token, index - - def _parse_starting_token_deprecated(self): - """ - This handles parsing of old style starting tokens, and attempts to - coerce them into the new style. - """ - log.debug("Attempting to fall back to old starting token parser. For " - "token: %s" % self._starting_token) - if self._starting_token is None: - return None - - parts = self._starting_token.split('___') - next_token = [] - index = 0 - if len(parts) == len(self._input_token) + 1: - try: - index = int(parts.pop()) - except ValueError: - raise ValueError("Bad starting token: %s" % - self._starting_token) - for part in parts: - if part == 'None': - next_token.append(None) - else: - next_token.append(part) - return self._convert_deprecated_starting_token(next_token), index - - def _convert_deprecated_starting_token(self, deprecated_token): - """ - This attempts to convert a deprecated starting token into the new - style. - """ - len_deprecated_token = len(deprecated_token) - len_input_token = len(self._input_token) - if len_deprecated_token > len_input_token: - raise ValueError("Bad starting token: %s" % self._starting_token) - elif len_deprecated_token < len_input_token: - log.debug("Old format starting token does not contain all input " - "tokens. Setting the rest, in order, as None.") - for i in range(len_input_token - len_deprecated_token): - deprecated_token.append(None) - return dict(zip(self._input_token, deprecated_token)) - - -class Paginator(object): - PAGE_ITERATOR_CLS = PageIterator - - def __init__(self, method, pagination_config, model): - self._model = model - self._method = method - self._pagination_cfg = pagination_config - self._output_token = self._get_output_tokens(self._pagination_cfg) - self._input_token = self._get_input_tokens(self._pagination_cfg) - self._more_results = self._get_more_results_token(self._pagination_cfg) - self._non_aggregate_keys = self._get_non_aggregate_keys( - self._pagination_cfg) - self._result_keys = self._get_result_keys(self._pagination_cfg) - self._limit_key = self._get_limit_key(self._pagination_cfg) - - @property - def result_keys(self): - return self._result_keys - - def _get_non_aggregate_keys(self, config): - keys = [] - for key in config.get('non_aggregate_keys', []): - keys.append(jmespath.compile(key)) - return keys - - def _get_output_tokens(self, config): - output = [] - output_token = config['output_token'] - if not isinstance(output_token, list): - output_token = [output_token] - for config in output_token: - output.append(jmespath.compile(config)) - return output - - def _get_input_tokens(self, config): - input_token = self._pagination_cfg['input_token'] - if not isinstance(input_token, list): - input_token = [input_token] - return input_token - - def _get_more_results_token(self, config): - more_results = config.get('more_results') - if more_results is not None: - return jmespath.compile(more_results) - - def _get_result_keys(self, config): - result_key = config.get('result_key') - if result_key is not None: - if not isinstance(result_key, list): - result_key = [result_key] - result_key = [jmespath.compile(rk) for rk in result_key] - return result_key - - def _get_limit_key(self, config): - return config.get('limit_key') - - def paginate(self, **kwargs): - """Create paginator object for an operation. - - This returns an iterable object. Iterating over - this object will yield a single page of a response - at a time. - - """ - page_params = self._extract_paging_params(kwargs) - return self.PAGE_ITERATOR_CLS( - self._method, self._input_token, - self._output_token, self._more_results, - self._result_keys, self._non_aggregate_keys, - self._limit_key, - page_params['MaxItems'], - page_params['StartingToken'], - page_params['PageSize'], - kwargs) - - def _extract_paging_params(self, kwargs): - pagination_config = kwargs.pop('PaginationConfig', {}) - max_items = pagination_config.get('MaxItems', None) - if max_items is not None: - max_items = int(max_items) - page_size = pagination_config.get('PageSize', None) - if page_size is not None: - if self._limit_key is None: - raise PaginationError( - message="PageSize parameter is not supported for the " - "pagination interface for this operation.") - input_members = self._model.input_shape.members - limit_key_shape = input_members.get(self._limit_key) - if limit_key_shape.type_name == 'string': - if not isinstance(page_size, six.string_types): - page_size = str(page_size) - else: - page_size = int(page_size) - return { - 'MaxItems': max_items, - 'StartingToken': pagination_config.get('StartingToken', None), - 'PageSize': page_size, - } - - -class ResultKeyIterator(object): - """Iterates over the results of paginated responses. - - Each iterator is associated with a single result key. - Iterating over this object will give you each element in - the result key list. - - :param pages_iterator: An iterator that will give you - pages of results (a ``PageIterator`` class). - :param result_key: The JMESPath expression representing - the result key. - - """ - - def __init__(self, pages_iterator, result_key): - self._pages_iterator = pages_iterator - self.result_key = result_key - - def __iter__(self): - for page in self._pages_iterator: - results = self.result_key.search(page) - if results is None: - results = [] - for result in results: - yield result diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/parsers.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/parsers.py deleted file mode 100644 index 6273c89c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/parsers.py +++ /dev/null @@ -1,929 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Response parsers for the various protocol types. - -The module contains classes that can take an HTTP response, and given -an output shape, parse the response into a dict according to the -rules in the output shape. - -There are many similarities amongst the different protocols with regard -to response parsing, and the code is structured in a way to avoid -code duplication when possible. The diagram below is a diagram -showing the inheritance hierarchy of the response classes. - -:: - - - - +--------------+ - |ResponseParser| - +--------------+ - ^ ^ ^ - +--------------------+ | +-------------------+ - | | | - +----------+----------+ +------+-------+ +-------+------+ - |BaseXMLResponseParser| |BaseRestParser| |BaseJSONParser| - +---------------------+ +--------------+ +--------------+ - ^ ^ ^ ^ ^ ^ - | | | | | | - | | | | | | - | ++----------+-+ +-+-----------++ | - | |RestXMLParser| |RestJSONParser| | - +-----+-----+ +-------------+ +--------------+ +----+-----+ - |QueryParser| |JSONParser| - +-----------+ +----------+ - - -The diagram above shows that there is a base class, ``ResponseParser`` that -contains logic that is similar amongst all the different protocols (``query``, -``json``, ``rest-json``, ``rest-xml``). Amongst the various services there -is shared logic that can be grouped several ways: - -* The ``query`` and ``rest-xml`` both have XML bodies that are parsed in the - same way. -* The ``json`` and ``rest-json`` protocols both have JSON bodies that are - parsed in the same way. -* The ``rest-json`` and ``rest-xml`` protocols have additional attributes - besides body parameters that are parsed the same (headers, query string, - status code). - -This is reflected in the class diagram above. The ``BaseXMLResponseParser`` -and the BaseJSONParser contain logic for parsing the XML/JSON body, -and the BaseRestParser contains logic for parsing out attributes that -come from other parts of the HTTP response. Classes like the -``RestXMLParser`` inherit from the ``BaseXMLResponseParser`` to get the -XML body parsing logic and the ``BaseRestParser`` to get the HTTP -header/status code/query string parsing. - -Additionally, there are event stream parsers that are used by the other parsers -to wrap streaming bodies that represent a stream of events. The -BaseEventStreamParser extends from ResponseParser and defines the logic for -parsing values from the headers and payload of a message from the underlying -binary encoding protocol. Currently, event streams support parsing bodies -encoded as JSON and XML through the following hierarchy. - - - +--------------+ - |ResponseParser| - +--------------+ - ^ ^ ^ - +--------------------+ | +------------------+ - | | | - +----------+----------+ +----------+----------+ +-------+------+ - |BaseXMLResponseParser| |BaseEventStreamParser| |BaseJSONParser| - +---------------------+ +---------------------+ +--------------+ - ^ ^ ^ ^ - | | | | - | | | | - +-+----------------+-+ +-+-----------------+-+ - |EventStreamXMLParser| |EventStreamJSONParser| - +--------------------+ +---------------------+ - -Return Values -============= - -Each call to ``parse()`` returns a dict has this form:: - - Standard Response - - { - "ResponseMetadata": {"RequestId": } - - } - - Error response - - { - "ResponseMetadata": {"RequestId": } - "Error": { - "Code": , - "Message": , - "Type": , - - } - } - -""" -import re -import base64 -import json -import xml.etree.cElementTree -import logging - -from botocore.compat import six, XMLParseError -from botocore.eventstream import EventStream - -from botocore.utils import parse_timestamp, merge_dicts, \ - is_json_value_header - -LOG = logging.getLogger(__name__) - -DEFAULT_TIMESTAMP_PARSER = parse_timestamp - - -class ResponseParserFactory(object): - def __init__(self): - self._defaults = {} - - def set_parser_defaults(self, **kwargs): - """Set default arguments when a parser instance is created. - - You can specify any kwargs that are allowed by a ResponseParser - class. There are currently two arguments: - - * timestamp_parser - A callable that can parse a timetsamp string - * blob_parser - A callable that can parse a blob type - - """ - self._defaults.update(kwargs) - - def create_parser(self, protocol_name): - parser_cls = PROTOCOL_PARSERS[protocol_name] - return parser_cls(**self._defaults) - - -def create_parser(protocol): - return ResponseParserFactory().create_parser(protocol) - - -def _text_content(func): - # This decorator hides the difference between - # an XML node with text or a plain string. It's used - # to ensure that scalar processing operates only on text - # strings, which allows the same scalar handlers to be used - # for XML nodes from the body and HTTP headers. - def _get_text_content(self, shape, node_or_string): - if hasattr(node_or_string, 'text'): - text = node_or_string.text - if text is None: - # If an XML node is empty , - # we want to parse that as an empty string, - # not as a null/None value. - text = '' - else: - text = node_or_string - return func(self, shape, text) - return _get_text_content - - -class ResponseParserError(Exception): - pass - - -class ResponseParser(object): - """Base class for response parsing. - - This class represents the interface that all ResponseParsers for the - various protocols must implement. - - This class will take an HTTP response and a model shape and parse the - HTTP response into a dictionary. - - There is a single public method exposed: ``parse``. See the ``parse`` - docstring for more info. - - """ - DEFAULT_ENCODING = 'utf-8' - EVENT_STREAM_PARSER_CLS = None - - def __init__(self, timestamp_parser=None, blob_parser=None): - if timestamp_parser is None: - timestamp_parser = DEFAULT_TIMESTAMP_PARSER - self._timestamp_parser = timestamp_parser - if blob_parser is None: - blob_parser = self._default_blob_parser - self._blob_parser = blob_parser - self._event_stream_parser = None - if self.EVENT_STREAM_PARSER_CLS is not None: - self._event_stream_parser = self.EVENT_STREAM_PARSER_CLS( - timestamp_parser, blob_parser) - - def _default_blob_parser(self, value): - # Blobs are always returned as bytes type (this matters on python3). - # We don't decode this to a str because it's entirely possible that the - # blob contains binary data that actually can't be decoded. - return base64.b64decode(value) - - def parse(self, response, shape): - """Parse the HTTP response given a shape. - - :param response: The HTTP response dictionary. This is a dictionary - that represents the HTTP request. The dictionary must have the - following keys, ``body``, ``headers``, and ``status_code``. - - :param shape: The model shape describing the expected output. - :return: Returns a dictionary representing the parsed response - described by the model. In addition to the shape described from - the model, each response will also have a ``ResponseMetadata`` - which contains metadata about the response, which contains at least - two keys containing ``RequestId`` and ``HTTPStatusCode``. Some - responses may populate additional keys, but ``RequestId`` will - always be present. - - """ - LOG.debug('Response headers: %s', response['headers']) - LOG.debug('Response body:\n%s', response['body']) - if response['status_code'] >= 301: - if self._is_generic_error_response(response): - parsed = self._do_generic_error_parse(response) - else: - parsed = self._do_error_parse(response, shape) - else: - parsed = self._do_parse(response, shape) - - # We don't want to decorate event stream responses with metadata - if shape and shape.serialization.get('eventstream'): - return parsed - - # Add ResponseMetadata if it doesn't exist and inject the HTTP - # status code and headers from the response. - if isinstance(parsed, dict): - response_metadata = parsed.get('ResponseMetadata', {}) - response_metadata['HTTPStatusCode'] = response['status_code'] - response_metadata['HTTPHeaders'] = dict(response['headers']) - parsed['ResponseMetadata'] = response_metadata - return parsed - - def _is_generic_error_response(self, response): - # There are times when a service will respond with a generic - # error response such as: - # 'Http/1.1 Service Unavailable' - # - # This can also happen if you're going through a proxy. - # In this case the protocol specific _do_error_parse will either - # fail to parse the response (in the best case) or silently succeed - # and treat the HTML above as an XML response and return - # non sensical parsed data. - # To prevent this case from happening we first need to check - # whether or not this response looks like the generic response. - if response['status_code'] >= 500: - body = response['body'].strip() - return body.startswith(b'') or not body - - def _do_generic_error_parse(self, response): - # There's not really much we can do when we get a generic - # html response. - LOG.debug("Received a non protocol specific error response from the " - "service, unable to populate error code and message.") - return { - 'Error': {'Code': str(response['status_code']), - 'Message': six.moves.http_client.responses.get( - response['status_code'], '')}, - 'ResponseMetadata': {}, - } - - def _do_parse(self, response, shape): - raise NotImplementedError("%s._do_parse" % self.__class__.__name__) - - def _do_error_parse(self, response, shape): - raise NotImplementedError( - "%s._do_error_parse" % self.__class__.__name__) - - def _parse_shape(self, shape, node): - handler = getattr(self, '_handle_%s' % shape.type_name, - self._default_handle) - return handler(shape, node) - - def _handle_list(self, shape, node): - # Enough implementations share list serialization that it's moved - # up here in the base class. - parsed = [] - member_shape = shape.member - for item in node: - parsed.append(self._parse_shape(member_shape, item)) - return parsed - - def _default_handle(self, shape, value): - return value - - -class BaseXMLResponseParser(ResponseParser): - def __init__(self, timestamp_parser=None, blob_parser=None): - super(BaseXMLResponseParser, self).__init__(timestamp_parser, - blob_parser) - self._namespace_re = re.compile('{.*}') - - def _handle_map(self, shape, node): - parsed = {} - key_shape = shape.key - value_shape = shape.value - key_location_name = key_shape.serialization.get('name') or 'key' - value_location_name = value_shape.serialization.get('name') or 'value' - if shape.serialization.get('flattened') and not isinstance(node, list): - node = [node] - for keyval_node in node: - for single_pair in keyval_node: - # Within each there's a and a - tag_name = self._node_tag(single_pair) - if tag_name == key_location_name: - key_name = self._parse_shape(key_shape, single_pair) - elif tag_name == value_location_name: - val_name = self._parse_shape(value_shape, single_pair) - else: - raise ResponseParserError("Unknown tag: %s" % tag_name) - parsed[key_name] = val_name - return parsed - - def _node_tag(self, node): - return self._namespace_re.sub('', node.tag) - - def _handle_list(self, shape, node): - # When we use _build_name_to_xml_node, repeated elements are aggregated - # into a list. However, we can't tell the difference between a scalar - # value and a single element flattened list. So before calling the - # real _handle_list, we know that "node" should actually be a list if - # it's flattened, and if it's not, then we make it a one element list. - if shape.serialization.get('flattened') and not isinstance(node, list): - node = [node] - return super(BaseXMLResponseParser, self)._handle_list(shape, node) - - def _handle_structure(self, shape, node): - parsed = {} - members = shape.members - xml_dict = self._build_name_to_xml_node(node) - for member_name in members: - member_shape = members[member_name] - if 'location' in member_shape.serialization or \ - member_shape.serialization.get('eventheader'): - # All members with locations have already been handled, - # so we don't need to parse these members. - continue - xml_name = self._member_key_name(member_shape, member_name) - member_node = xml_dict.get(xml_name) - if member_node is not None: - parsed[member_name] = self._parse_shape( - member_shape, member_node) - elif member_shape.serialization.get('xmlAttribute'): - attribs = {} - location_name = member_shape.serialization['name'] - for key, value in node.attrib.items(): - new_key = self._namespace_re.sub( - location_name.split(':')[0] + ':', key) - attribs[new_key] = value - if location_name in attribs: - parsed[member_name] = attribs[location_name] - return parsed - - def _member_key_name(self, shape, member_name): - # This method is needed because we have to special case flattened list - # with a serialization name. If this is the case we use the - # locationName from the list's member shape as the key name for the - # surrounding structure. - if shape.type_name == 'list' and shape.serialization.get('flattened'): - list_member_serialized_name = shape.member.serialization.get( - 'name') - if list_member_serialized_name is not None: - return list_member_serialized_name - serialized_name = shape.serialization.get('name') - if serialized_name is not None: - return serialized_name - return member_name - - def _build_name_to_xml_node(self, parent_node): - # If the parent node is actually a list. We should not be trying - # to serialize it to a dictionary. Instead, return the first element - # in the list. - if isinstance(parent_node, list): - return self._build_name_to_xml_node(parent_node[0]) - xml_dict = {} - for item in parent_node: - key = self._node_tag(item) - if key in xml_dict: - # If the key already exists, the most natural - # way to handle this is to aggregate repeated - # keys into a single list. - # 12 -> {'foo': [Node(1), Node(2)]} - if isinstance(xml_dict[key], list): - xml_dict[key].append(item) - else: - # Convert from a scalar to a list. - xml_dict[key] = [xml_dict[key], item] - else: - xml_dict[key] = item - return xml_dict - - def _parse_xml_string_to_dom(self, xml_string): - try: - parser = xml.etree.cElementTree.XMLParser( - target=xml.etree.cElementTree.TreeBuilder(), - encoding=self.DEFAULT_ENCODING) - parser.feed(xml_string) - root = parser.close() - except XMLParseError as e: - raise ResponseParserError( - "Unable to parse response (%s), " - "invalid XML received:\n%s" % (e, xml_string)) - return root - - def _replace_nodes(self, parsed): - for key, value in parsed.items(): - if value.getchildren(): - sub_dict = self._build_name_to_xml_node(value) - parsed[key] = self._replace_nodes(sub_dict) - else: - parsed[key] = value.text - return parsed - - @_text_content - def _handle_boolean(self, shape, text): - if text == 'true': - return True - else: - return False - - @_text_content - def _handle_float(self, shape, text): - return float(text) - - @_text_content - def _handle_timestamp(self, shape, text): - return self._timestamp_parser(text) - - @_text_content - def _handle_integer(self, shape, text): - return int(text) - - @_text_content - def _handle_string(self, shape, text): - return text - - @_text_content - def _handle_blob(self, shape, text): - return self._blob_parser(text) - - _handle_character = _handle_string - _handle_double = _handle_float - _handle_long = _handle_integer - - -class QueryParser(BaseXMLResponseParser): - - def _do_error_parse(self, response, shape): - xml_contents = response['body'] - root = self._parse_xml_string_to_dom(xml_contents) - parsed = self._build_name_to_xml_node(root) - self._replace_nodes(parsed) - # Once we've converted xml->dict, we need to make one or two - # more adjustments to extract nested errors and to be consistent - # with ResponseMetadata for non-error responses: - # 1. {"Errors": {"Error": {...}}} -> {"Error": {...}} - # 2. {"RequestId": "id"} -> {"ResponseMetadata": {"RequestId": "id"}} - if 'Errors' in parsed: - parsed.update(parsed.pop('Errors')) - if 'RequestId' in parsed: - parsed['ResponseMetadata'] = {'RequestId': parsed.pop('RequestId')} - return parsed - - def _do_parse(self, response, shape): - xml_contents = response['body'] - root = self._parse_xml_string_to_dom(xml_contents) - parsed = {} - if shape is not None: - start = root - if 'resultWrapper' in shape.serialization: - start = self._find_result_wrapped_shape( - shape.serialization['resultWrapper'], - root) - parsed = self._parse_shape(shape, start) - self._inject_response_metadata(root, parsed) - return parsed - - def _find_result_wrapped_shape(self, element_name, xml_root_node): - mapping = self._build_name_to_xml_node(xml_root_node) - return mapping[element_name] - - def _inject_response_metadata(self, node, inject_into): - mapping = self._build_name_to_xml_node(node) - child_node = mapping.get('ResponseMetadata') - if child_node is not None: - sub_mapping = self._build_name_to_xml_node(child_node) - for key, value in sub_mapping.items(): - sub_mapping[key] = value.text - inject_into['ResponseMetadata'] = sub_mapping - - -class EC2QueryParser(QueryParser): - - def _inject_response_metadata(self, node, inject_into): - mapping = self._build_name_to_xml_node(node) - child_node = mapping.get('requestId') - if child_node is not None: - inject_into['ResponseMetadata'] = {'RequestId': child_node.text} - - def _do_error_parse(self, response, shape): - # EC2 errors look like: - # - # - # - # InvalidInstanceID.Malformed - # Invalid id: "1343124" - # - # - # 12345 - # - # This is different from QueryParser in that it's RequestID, - # not RequestId - original = super(EC2QueryParser, self)._do_error_parse(response, shape) - original['ResponseMetadata'] = { - 'RequestId': original.pop('RequestID') - } - return original - - -class BaseJSONParser(ResponseParser): - - def _handle_structure(self, shape, value): - member_shapes = shape.members - if value is None: - # If the comes across the wire as "null" (None in python), - # we should be returning this unchanged, instead of as an - # empty dict. - return None - final_parsed = {} - for member_name in member_shapes: - member_shape = member_shapes[member_name] - json_name = member_shape.serialization.get('name', member_name) - raw_value = value.get(json_name) - if raw_value is not None: - final_parsed[member_name] = self._parse_shape( - member_shapes[member_name], - raw_value) - return final_parsed - - def _handle_map(self, shape, value): - parsed = {} - key_shape = shape.key - value_shape = shape.value - for key, value in value.items(): - actual_key = self._parse_shape(key_shape, key) - actual_value = self._parse_shape(value_shape, value) - parsed[actual_key] = actual_value - return parsed - - def _handle_blob(self, shape, value): - return self._blob_parser(value) - - def _handle_timestamp(self, shape, value): - return self._timestamp_parser(value) - - def _do_error_parse(self, response, shape): - body = self._parse_body_as_json(response['body']) - error = {"Error": {"Message": '', "Code": ''}, "ResponseMetadata": {}} - # Error responses can have slightly different structures for json. - # The basic structure is: - # - # {"__type":"ConnectClientException", - # "message":"The error message."} - - # The error message can either come in the 'message' or 'Message' key - # so we need to check for both. - error['Error']['Message'] = body.get('message', - body.get('Message', '')) - # if the message did not contain an error code - # include the response status code - response_code = response.get('status_code') - code = body.get('__type', response_code and str(response_code)) - if code is not None: - # code has a couple forms as well: - # * "com.aws.dynamodb.vAPI#ProvisionedThroughputExceededException" - # * "ResourceNotFoundException" - if '#' in code: - code = code.rsplit('#', 1)[1] - error['Error']['Code'] = code - self._inject_response_metadata(error, response['headers']) - return error - - def _inject_response_metadata(self, parsed, headers): - if 'x-amzn-requestid' in headers: - parsed.setdefault('ResponseMetadata', {})['RequestId'] = ( - headers['x-amzn-requestid']) - - def _parse_body_as_json(self, body_contents): - if not body_contents: - return {} - body = body_contents.decode(self.DEFAULT_ENCODING) - try: - original_parsed = json.loads(body) - return original_parsed - except ValueError: - # if the body cannot be parsed, include - # the literal string as the message - return { 'message': body } - - -class JSONParser(BaseJSONParser): - """Response parse for the "json" protocol.""" - def _do_parse(self, response, shape): - # The json.loads() gives us the primitive JSON types, - # but we need to traverse the parsed JSON data to convert - # to richer types (blobs, timestamps, etc. - parsed = {} - if shape is not None: - original_parsed = self._parse_body_as_json(response['body']) - parsed = self._parse_shape(shape, original_parsed) - self._inject_response_metadata(parsed, response['headers']) - return parsed - - -class BaseEventStreamParser(ResponseParser): - - def _do_parse(self, response, shape): - final_parsed = {} - if shape.serialization.get('eventstream'): - event_type = response['headers'].get(':event-type') - event_shape = shape.members.get(event_type) - if event_shape: - final_parsed[event_type] = self._do_parse(response, event_shape) - else: - self._parse_non_payload_attrs(response, shape, - shape.members, final_parsed) - self._parse_payload(response, shape, shape.members, final_parsed) - return final_parsed - - def _do_error_parse(self, response, shape): - error = { - 'Error': { - 'Code': response['headers'].get(':error-code', ''), - 'Message': response['headers'].get(':error-message', ''), - } - } - return error - - def _parse_payload(self, response, shape, member_shapes, final_parsed): - if shape.serialization.get('event'): - for name in member_shapes: - member_shape = member_shapes[name] - if member_shape.serialization.get('eventpayload'): - body = response['body'] - if member_shape.type_name == 'blob': - parsed_body = body - elif member_shape.type_name == 'string': - parsed_body = body.decode(self.DEFAULT_ENCODING) - else: - raw_parse = self._initial_body_parse(body) - parsed_body = self._parse_shape(member_shape, raw_parse) - final_parsed[name] = parsed_body - return - # If we didn't find an explicit payload, use the current shape - original_parsed = self._initial_body_parse(response['body']) - body_parsed = self._parse_shape(shape, original_parsed) - final_parsed.update(body_parsed) - - def _parse_non_payload_attrs(self, response, shape, - member_shapes, final_parsed): - headers = response['headers'] - for name in member_shapes: - member_shape = member_shapes[name] - if member_shape.serialization.get('eventheader'): - if name in headers: - value = headers[name] - if member_shape.type_name == 'timestamp': - # Event stream timestamps are an in milleseconds so we - # divide by 1000 to convert to seconds. - value = self._timestamp_parser(value / 1000.0) - final_parsed[name] = value - - def _initial_body_parse(self, body_contents): - # This method should do the initial xml/json parsing of the - # body. We we still need to walk the parsed body in order - # to convert types, but this method will do the first round - # of parsing. - raise NotImplementedError("_initial_body_parse") - - -class EventStreamJSONParser(BaseEventStreamParser, BaseJSONParser): - - def _initial_body_parse(self, body_contents): - return self._parse_body_as_json(body_contents) - - -class EventStreamXMLParser(BaseEventStreamParser, BaseXMLResponseParser): - - def _initial_body_parse(self, xml_string): - if not xml_string: - return xml.etree.cElementTree.Element('') - return self._parse_xml_string_to_dom(xml_string) - - -class BaseRestParser(ResponseParser): - - def _do_parse(self, response, shape): - final_parsed = {} - final_parsed['ResponseMetadata'] = self._populate_response_metadata( - response) - if shape is None: - return final_parsed - member_shapes = shape.members - self._parse_non_payload_attrs(response, shape, - member_shapes, final_parsed) - self._parse_payload(response, shape, member_shapes, final_parsed) - return final_parsed - - def _populate_response_metadata(self, response): - metadata = {} - headers = response['headers'] - if 'x-amzn-requestid' in headers: - metadata['RequestId'] = headers['x-amzn-requestid'] - elif 'x-amz-request-id' in headers: - metadata['RequestId'] = headers['x-amz-request-id'] - # HostId is what it's called whenver this value is returned - # in an XML response body, so to be consistent, we'll always - # call is HostId. - metadata['HostId'] = headers.get('x-amz-id-2', '') - return metadata - - def _parse_payload(self, response, shape, member_shapes, final_parsed): - if 'payload' in shape.serialization: - # If a payload is specified in the output shape, then only that - # shape is used for the body payload. - payload_member_name = shape.serialization['payload'] - body_shape = member_shapes[payload_member_name] - if body_shape.serialization.get('eventstream'): - parser = self._event_stream_parser - name = response['context'].get('operation_name') - body = EventStream(response['body'], body_shape, parser, name) - final_parsed[payload_member_name] = body - elif body_shape.type_name in ['string', 'blob']: - # This is a stream - body = response['body'] - if isinstance(body, bytes): - body = body.decode(self.DEFAULT_ENCODING) - final_parsed[payload_member_name] = body - else: - original_parsed = self._initial_body_parse(response['body']) - final_parsed[payload_member_name] = self._parse_shape( - body_shape, original_parsed) - else: - original_parsed = self._initial_body_parse(response['body']) - body_parsed = self._parse_shape(shape, original_parsed) - final_parsed.update(body_parsed) - - def _parse_non_payload_attrs(self, response, shape, - member_shapes, final_parsed): - headers = response['headers'] - for name in member_shapes: - member_shape = member_shapes[name] - location = member_shape.serialization.get('location') - if location is None: - continue - elif location == 'statusCode': - final_parsed[name] = self._parse_shape( - member_shape, response['status_code']) - elif location == 'headers': - final_parsed[name] = self._parse_header_map(member_shape, - headers) - elif location == 'header': - header_name = member_shape.serialization.get('name', name) - if header_name in headers: - final_parsed[name] = self._parse_shape( - member_shape, headers[header_name]) - - def _parse_header_map(self, shape, headers): - # Note that headers are case insensitive, so we .lower() - # all header names and header prefixes. - parsed = {} - prefix = shape.serialization.get('name', '').lower() - for header_name in headers: - if header_name.lower().startswith(prefix): - # The key name inserted into the parsed hash - # strips off the prefix. - name = header_name[len(prefix):] - parsed[name] = headers[header_name] - return parsed - - def _initial_body_parse(self, body_contents): - # This method should do the initial xml/json parsing of the - # body. We we still need to walk the parsed body in order - # to convert types, but this method will do the first round - # of parsing. - raise NotImplementedError("_initial_body_parse") - - def _handle_string(self, shape, value): - parsed = value - if is_json_value_header(shape): - decoded = base64.b64decode(value).decode(self.DEFAULT_ENCODING) - parsed = json.loads(decoded) - return parsed - - -class RestJSONParser(BaseRestParser, BaseJSONParser): - - EVENT_STREAM_PARSER_CLS = EventStreamJSONParser - - def _initial_body_parse(self, body_contents): - return self._parse_body_as_json(body_contents) - - def _do_error_parse(self, response, shape): - error = super(RestJSONParser, self)._do_error_parse(response, shape) - self._inject_error_code(error, response) - return error - - def _inject_error_code(self, error, response): - # The "Code" value can come from either a response - # header or a value in the JSON body. - body = self._initial_body_parse(response['body']) - if 'x-amzn-errortype' in response['headers']: - code = response['headers']['x-amzn-errortype'] - # Could be: - # x-amzn-errortype: ValidationException: - code = code.split(':')[0] - error['Error']['Code'] = code - elif 'code' in body or 'Code' in body: - error['Error']['Code'] = body.get( - 'code', body.get('Code', '')) - - -class RestXMLParser(BaseRestParser, BaseXMLResponseParser): - - EVENT_STREAM_PARSER_CLS = EventStreamXMLParser - - def _initial_body_parse(self, xml_string): - if not xml_string: - return xml.etree.cElementTree.Element('') - return self._parse_xml_string_to_dom(xml_string) - - def _do_error_parse(self, response, shape): - # We're trying to be service agnostic here, but S3 does have a slightly - # different response structure for its errors compared to other - # rest-xml serivces (route53/cloudfront). We handle this by just - # trying to parse both forms. - # First: - # - # - # Sender - # InvalidInput - # Invalid resource type: foo - # - # request-id - # - if response['body']: - # If the body ends up being invalid xml, the xml parser should not - # blow up. It should at least try to pull information about the - # the error response from other sources like the HTTP status code. - try: - return self._parse_error_from_body(response) - except ResponseParserError as e: - LOG.debug( - 'Exception caught when parsing error response body:', - exc_info=True) - return self._parse_error_from_http_status(response) - - def _parse_error_from_http_status(self, response): - return { - 'Error': { - 'Code': str(response['status_code']), - 'Message': six.moves.http_client.responses.get( - response['status_code'], ''), - }, - 'ResponseMetadata': { - 'RequestId': response['headers'].get('x-amz-request-id', ''), - 'HostId': response['headers'].get('x-amz-id-2', ''), - } - } - - def _parse_error_from_body(self, response): - xml_contents = response['body'] - root = self._parse_xml_string_to_dom(xml_contents) - parsed = self._build_name_to_xml_node(root) - self._replace_nodes(parsed) - if root.tag == 'Error': - # This is an S3 error response. First we'll populate the - # response metadata. - metadata = self._populate_response_metadata(response) - # The RequestId and the HostId are already in the - # ResponseMetadata, but are also duplicated in the XML - # body. We don't need these values in both places, - # we'll just remove them from the parsed XML body. - parsed.pop('RequestId', '') - parsed.pop('HostId', '') - return {'Error': parsed, 'ResponseMetadata': metadata} - elif 'RequestId' in parsed: - # Other rest-xml serivces: - parsed['ResponseMetadata'] = {'RequestId': parsed.pop('RequestId')} - default = {'Error': {'Message': '', 'Code': ''}} - merge_dicts(default, parsed) - return default - - @_text_content - def _handle_string(self, shape, text): - text = super(RestXMLParser, self)._handle_string(shape, text) - return text - - -PROTOCOL_PARSERS = { - 'ec2': EC2QueryParser, - 'query': QueryParser, - 'json': JSONParser, - 'rest-json': RestJSONParser, - 'rest-xml': RestXMLParser, -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/regions.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/regions.py deleted file mode 100644 index d0099ba8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/regions.py +++ /dev/null @@ -1,188 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Resolves regions and endpoints. - -This module implements endpoint resolution, including resolving endpoints for a -given service and region and resolving the available endpoints for a service -in a specific AWS partition. -""" -import logging -import re - -from botocore.exceptions import NoRegionError - -LOG = logging.getLogger(__name__) -DEFAULT_URI_TEMPLATE = '{service}.{region}.{dnsSuffix}' -DEFAULT_SERVICE_DATA = {'endpoints': {}} - - -class BaseEndpointResolver(object): - """Resolves regions and endpoints. Must be subclassed.""" - def construct_endpoint(self, service_name, region_name=None): - """Resolves an endpoint for a service and region combination. - - :type service_name: string - :param service_name: Name of the service to resolve an endpoint for - (e.g., s3) - - :type region_name: string - :param region_name: Region/endpoint name to resolve (e.g., us-east-1) - if no region is provided, the first found partition-wide endpoint - will be used if available. - - :rtype: dict - :return: Returns a dict containing the following keys: - - partition: (string, required) Resolved partition name - - endpointName: (string, required) Resolved endpoint name - - hostname: (string, required) Hostname to use for this endpoint - - sslCommonName: (string) sslCommonName to use for this endpoint. - - credentialScope: (dict) Signature version 4 credential scope - - region: (string) region name override when signing. - - service: (string) service name override when signing. - - signatureVersions: (list) A list of possible signature - versions, including s3, v4, v2, and s3v4 - - protocols: (list) A list of supported protocols - (e.g., http, https) - - ...: Other keys may be included as well based on the metadata - """ - raise NotImplementedError - - def get_available_partitions(self): - """Lists the partitions available to the endpoint resolver. - - :return: Returns a list of partition names (e.g., ["aws", "aws-cn"]). - """ - raise NotImplementedError - - def get_available_endpoints(self, service_name, partition_name='aws', - allow_non_regional=False): - """Lists the endpoint names of a particular partition. - - :type service_name: string - :param service_name: Name of a service to list endpoint for (e.g., s3) - - :type partition_name: string - :param partition_name: Name of the partition to limit endpoints to. - (e.g., aws for the public AWS endpoints, aws-cn for AWS China - endpoints, aws-us-gov for AWS GovCloud (US) Endpoints, etc. - - :type allow_non_regional: bool - :param allow_non_regional: Set to True to include endpoints that are - not regional endpoints (e.g., s3-external-1, - fips-us-gov-west-1, etc). - :return: Returns a list of endpoint names (e.g., ["us-east-1"]). - """ - raise NotImplementedError - - -class EndpointResolver(BaseEndpointResolver): - """Resolves endpoints based on partition endpoint metadata""" - def __init__(self, endpoint_data): - """ - :param endpoint_data: A dict of partition data. - """ - if 'partitions' not in endpoint_data: - raise ValueError('Missing "partitions" in endpoint data') - self._endpoint_data = endpoint_data - - def get_available_partitions(self): - result = [] - for partition in self._endpoint_data['partitions']: - result.append(partition['partition']) - return result - - def get_available_endpoints(self, service_name, partition_name='aws', - allow_non_regional=False): - result = [] - for partition in self._endpoint_data['partitions']: - if partition['partition'] != partition_name: - continue - services = partition['services'] - if service_name not in services: - continue - for endpoint_name in services[service_name]['endpoints']: - if allow_non_regional or endpoint_name in partition['regions']: - result.append(endpoint_name) - return result - - def construct_endpoint(self, service_name, region_name=None): - # Iterate over each partition until a match is found. - for partition in self._endpoint_data['partitions']: - result = self._endpoint_for_partition( - partition, service_name, region_name) - if result: - return result - - def _endpoint_for_partition(self, partition, service_name, region_name): - # Get the service from the partition, or an empty template. - service_data = partition['services'].get( - service_name, DEFAULT_SERVICE_DATA) - # Use the partition endpoint if no region is supplied. - if region_name is None: - if 'partitionEndpoint' in service_data: - region_name = service_data['partitionEndpoint'] - else: - raise NoRegionError() - # Attempt to resolve the exact region for this partition. - if region_name in service_data['endpoints']: - return self._resolve( - partition, service_name, service_data, region_name) - # Check to see if the endpoint provided is valid for the partition. - if self._region_match(partition, region_name): - # Use the partition endpoint if set and not regionalized. - partition_endpoint = service_data.get('partitionEndpoint') - is_regionalized = service_data.get('isRegionalized', True) - if partition_endpoint and not is_regionalized: - LOG.debug('Using partition endpoint for %s, %s: %s', - service_name, region_name, partition_endpoint) - return self._resolve( - partition, service_name, service_data, partition_endpoint) - LOG.debug('Creating a regex based endpoint for %s, %s', - service_name, region_name) - return self._resolve( - partition, service_name, service_data, region_name) - - def _region_match(self, partition, region_name): - if region_name in partition['regions']: - return True - if 'regionRegex' in partition: - return re.compile(partition['regionRegex']).match(region_name) - return False - - def _resolve(self, partition, service_name, service_data, endpoint_name): - result = service_data['endpoints'].get(endpoint_name, {}) - result['partition'] = partition['partition'] - result['endpointName'] = endpoint_name - # Merge in the service defaults then the partition defaults. - self._merge_keys(service_data.get('defaults', {}), result) - self._merge_keys(partition.get('defaults', {}), result) - hostname = result.get('hostname', DEFAULT_URI_TEMPLATE) - result['hostname'] = self._expand_template( - partition, result['hostname'], service_name, endpoint_name) - if 'sslCommonName' in result: - result['sslCommonName'] = self._expand_template( - partition, result['sslCommonName'], service_name, - endpoint_name) - result['dnsSuffix'] = partition['dnsSuffix'] - return result - - def _merge_keys(self, from_data, result): - for key in from_data: - if key not in result: - result[key] = from_data[key] - - def _expand_template(self, partition, template, service_name, - endpoint_name): - return template.format( - service=service_name, region=endpoint_name, - dnsSuffix=partition['dnsSuffix']) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/response.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/response.py deleted file mode 100644 index 7b58c9e7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/response.py +++ /dev/null @@ -1,160 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import sys -import xml.etree.cElementTree -import logging - -from botocore import ScalarTypes -from botocore.hooks import first_non_none_response -from botocore.compat import json, set_socket_timeout, XMLParseError -from botocore.exceptions import IncompleteReadError -from botocore import parsers - - -logger = logging.getLogger(__name__) - - -class StreamingBody(object): - """Wrapper class for an http response body. - - This provides a few additional conveniences that do not exist - in the urllib3 model: - - * Set the timeout on the socket (i.e read() timeouts) - * Auto validation of content length, if the amount of bytes - we read does not match the content length, an exception - is raised. - - """ - _DEFAULT_CHUNK_SIZE = 1024 - - def __init__(self, raw_stream, content_length): - self._raw_stream = raw_stream - self._content_length = content_length - self._amount_read = 0 - - def set_socket_timeout(self, timeout): - """Set the timeout seconds on the socket.""" - # The problem we're trying to solve is to prevent .read() calls from - # hanging. This can happen in rare cases. What we'd like to ideally - # do is set a timeout on the .read() call so that callers can retry - # the request. - # Unfortunately, this isn't currently possible in requests. - # See: https://github.com/kennethreitz/requests/issues/1803 - # So what we're going to do is reach into the guts of the stream and - # grab the socket object, which we can set the timeout on. We're - # putting in a check here so in case this interface goes away, we'll - # know. - try: - # To further complicate things, the way to grab the - # underlying socket object from an HTTPResponse is different - # in py2 and py3. So this code has been pushed to botocore.compat. - set_socket_timeout(self._raw_stream, timeout) - except AttributeError: - logger.error("Cannot access the socket object of " - "a streaming response. It's possible " - "the interface has changed.", exc_info=True) - raise - - def read(self, amt=None): - """Read at most amt bytes from the stream. - - If the amt argument is omitted, read all data. - """ - chunk = self._raw_stream.read(amt) - self._amount_read += len(chunk) - if amt is None or (not chunk and amt > 0): - # If the server sends empty contents or - # we ask to read all of the contents, then we know - # we need to verify the content length. - self._verify_content_length() - return chunk - - def __iter__(self): - """Return an iterator to yield 1k chunks from the raw stream. - """ - return self.iter_chunks(self._DEFAULT_CHUNK_SIZE) - - def iter_lines(self, chunk_size=1024): - """Return an iterator to yield lines from the raw stream. - - This is achieved by reading chunk of bytes (of size chunk_size) at a - time from the raw stream, and then yielding lines from there. - """ - pending = None - for chunk in self.iter_chunks(chunk_size): - if pending is not None: - chunk = pending + chunk - - lines = chunk.splitlines() - - if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]: - # We might be in the 'middle' of a line. Hence we keep the - # last line as pending. - pending = lines.pop() - else: - pending = None - - for line in lines: - yield line - - if pending is not None: - yield pending - - def iter_chunks(self, chunk_size=_DEFAULT_CHUNK_SIZE): - """Return an iterator to yield chunks of chunk_size bytes from the raw - stream. - """ - while True: - current_chunk = self.read(chunk_size) - if current_chunk == b"": - break - yield current_chunk - - def _verify_content_length(self): - # See: https://github.com/kennethreitz/requests/issues/1855 - # Basically, our http library doesn't do this for us, so we have - # to do this ourself. - if self._content_length is not None and \ - self._amount_read != int(self._content_length): - raise IncompleteReadError( - actual_bytes=self._amount_read, - expected_bytes=int(self._content_length)) - - def close(self): - """Close the underlying http response stream.""" - self._raw_stream.close() - - -def get_response(operation_model, http_response): - protocol = operation_model.metadata['protocol'] - response_dict = { - 'headers': http_response.headers, - 'status_code': http_response.status_code, - } - # TODO: Unfortunately, we have to have error logic here. - # If it looks like an error, in the streaming response case we - # need to actually grab the contents. - if response_dict['status_code'] >= 300: - response_dict['body'] = http_response.content - elif operation_model.has_streaming_output: - response_dict['body'] = StreamingBody( - http_response.raw, response_dict['headers'].get('content-length')) - else: - response_dict['body'] = http_response.content - - parser = parsers.create_parser(protocol) - return http_response, parser.parse(response_dict, - operation_model.output_shape) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/retryhandler.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/retryhandler.py deleted file mode 100644 index 09b59e55..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/retryhandler.py +++ /dev/null @@ -1,359 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. - -import random -import functools -import logging -from binascii import crc32 - -from botocore.vendored.requests import ConnectionError, Timeout -from botocore.vendored.requests.packages.urllib3.exceptions import ClosedPoolError - -from botocore.exceptions import ChecksumError, EndpointConnectionError - - -logger = logging.getLogger(__name__) -# The only supported error for now is GENERAL_CONNECTION_ERROR -# which maps to requests generic ConnectionError. If we're able -# to get more specific exceptions from requests we can update -# this mapping with more specific exceptions. -EXCEPTION_MAP = { - 'GENERAL_CONNECTION_ERROR': [ - ConnectionError, ClosedPoolError, Timeout, - EndpointConnectionError - ], -} - - -def delay_exponential(base, growth_factor, attempts): - """Calculate time to sleep based on exponential function. - - The format is:: - - base * growth_factor ^ (attempts - 1) - - If ``base`` is set to 'rand' then a random number between - 0 and 1 will be used as the base. - Base must be greater than 0, otherwise a ValueError will be - raised. - - """ - if base == 'rand': - base = random.random() - elif base <= 0: - raise ValueError("The 'base' param must be greater than 0, " - "got: %s" % base) - time_to_sleep = base * (growth_factor ** (attempts - 1)) - return time_to_sleep - - -def create_exponential_delay_function(base, growth_factor): - """Create an exponential delay function based on the attempts. - - This is used so that you only have to pass it the attempts - parameter to calculate the delay. - - """ - return functools.partial( - delay_exponential, base=base, growth_factor=growth_factor) - - -def create_retry_handler(config, operation_name=None): - checker = create_checker_from_retry_config( - config, operation_name=operation_name) - action = create_retry_action_from_config( - config, operation_name=operation_name) - return RetryHandler(checker=checker, action=action) - - -def create_retry_action_from_config(config, operation_name=None): - # The spec has the possibility of supporting per policy - # actions, but right now, we assume this comes from the - # default section, which means that delay functions apply - # for every policy in the retry config (per service). - delay_config = config['__default__']['delay'] - if delay_config['type'] == 'exponential': - return create_exponential_delay_function( - base=delay_config['base'], - growth_factor=delay_config['growth_factor']) - - -def create_checker_from_retry_config(config, operation_name=None): - checkers = [] - max_attempts = None - retryable_exceptions = [] - if '__default__' in config: - policies = config['__default__'].get('policies', []) - max_attempts = config['__default__']['max_attempts'] - for key in policies: - current_config = policies[key] - checkers.append(_create_single_checker(current_config)) - retry_exception = _extract_retryable_exception(current_config) - if retry_exception is not None: - retryable_exceptions.extend(retry_exception) - if operation_name is not None and config.get(operation_name) is not None: - operation_policies = config[operation_name]['policies'] - for key in operation_policies: - checkers.append(_create_single_checker(operation_policies[key])) - retry_exception = _extract_retryable_exception( - operation_policies[key]) - if retry_exception is not None: - retryable_exceptions.extend(retry_exception) - if len(checkers) == 1: - # Don't need to use a MultiChecker - return MaxAttemptsDecorator(checkers[0], max_attempts=max_attempts) - else: - multi_checker = MultiChecker(checkers) - return MaxAttemptsDecorator( - multi_checker, max_attempts=max_attempts, - retryable_exceptions=tuple(retryable_exceptions)) - - -def _create_single_checker(config): - if 'response' in config['applies_when']: - return _create_single_response_checker( - config['applies_when']['response']) - elif 'socket_errors' in config['applies_when']: - return ExceptionRaiser() - - -def _create_single_response_checker(response): - if 'service_error_code' in response: - checker = ServiceErrorCodeChecker( - status_code=response['http_status_code'], - error_code=response['service_error_code']) - elif 'http_status_code' in response: - checker = HTTPStatusCodeChecker( - status_code=response['http_status_code']) - elif 'crc32body' in response: - checker = CRC32Checker(header=response['crc32body']) - else: - # TODO: send a signal. - raise ValueError("Unknown retry policy: %s" % config) - return checker - - -def _extract_retryable_exception(config): - applies_when = config['applies_when'] - if 'crc32body' in applies_when.get('response', {}): - return [ChecksumError] - elif 'socket_errors' in applies_when: - exceptions = [] - for name in applies_when['socket_errors']: - exceptions.extend(EXCEPTION_MAP[name]) - return exceptions - - -class RetryHandler(object): - """Retry handler. - - The retry handler takes two params, ``checker`` object - and an ``action`` object. - - The ``checker`` object must be a callable object and based on a response - and an attempt number, determines whether or not sufficient criteria for - a retry has been met. If this is the case then the ``action`` object - (which also is a callable) determines what needs to happen in the event - of a retry. - - """ - - def __init__(self, checker, action): - self._checker = checker - self._action = action - - def __call__(self, attempts, response, caught_exception, **kwargs): - """Handler for a retry. - - Intended to be hooked up to an event handler (hence the **kwargs), - this will process retries appropriately. - - """ - if self._checker(attempts, response, caught_exception): - result = self._action(attempts=attempts) - logger.debug("Retry needed, action of: %s", result) - return result - logger.debug("No retry needed.") - - -class BaseChecker(object): - """Base class for retry checkers. - - Each class is responsible for checking a single criteria that determines - whether or not a retry should not happen. - - """ - def __call__(self, attempt_number, response, caught_exception): - """Determine if retry criteria matches. - - Note that either ``response`` is not None and ``caught_exception`` is - None or ``response`` is None and ``caught_exception`` is not None. - - :type attempt_number: int - :param attempt_number: The total number of times we've attempted - to send the request. - - :param response: The HTTP response (if one was received). - - :type caught_exception: Exception - :param caught_exception: Any exception that was caught while trying to - send the HTTP response. - - :return: True, if the retry criteria matches (and therefore a retry - should occur. False if the criteria does not match. - - """ - # The default implementation allows subclasses to not have to check - # whether or not response is None or not. - if response is not None: - return self._check_response(attempt_number, response) - elif caught_exception is not None: - return self._check_caught_exception( - attempt_number, caught_exception) - else: - raise ValueError("Both response and caught_exception are None.") - - def _check_response(self, attempt_number, response): - pass - - def _check_caught_exception(self, attempt_number, caught_exception): - pass - - -class MaxAttemptsDecorator(BaseChecker): - """Allow retries up to a maximum number of attempts. - - This will pass through calls to the decorated retry checker, provided - that the number of attempts does not exceed max_attempts. It will - also catch any retryable_exceptions passed in. Once max_attempts has - been exceeded, then False will be returned or the retryable_exceptions - that was previously being caught will be raised. - - """ - def __init__(self, checker, max_attempts, retryable_exceptions=None): - self._checker = checker - self._max_attempts = max_attempts - self._retryable_exceptions = retryable_exceptions - - def __call__(self, attempt_number, response, caught_exception): - should_retry = self._should_retry(attempt_number, response, - caught_exception) - if should_retry: - if attempt_number >= self._max_attempts: - # explicitly set MaxAttemptsReached - if response is not None and 'ResponseMetadata' in response[1]: - response[1]['ResponseMetadata']['MaxAttemptsReached'] = True - logger.debug("Reached the maximum number of retry " - "attempts: %s", attempt_number) - return False - else: - return should_retry - else: - return False - - def _should_retry(self, attempt_number, response, caught_exception): - if self._retryable_exceptions and \ - attempt_number < self._max_attempts: - try: - return self._checker(attempt_number, response, caught_exception) - except self._retryable_exceptions as e: - logger.debug("retry needed, retryable exception caught: %s", - e, exc_info=True) - return True - else: - # If we've exceeded the max attempts we just let the exception - # propogate if one has occurred. - return self._checker(attempt_number, response, caught_exception) - - -class HTTPStatusCodeChecker(BaseChecker): - def __init__(self, status_code): - self._status_code = status_code - - def _check_response(self, attempt_number, response): - if response[0].status_code == self._status_code: - logger.debug( - "retry needed: retryable HTTP status code received: %s", - self._status_code) - return True - else: - return False - - -class ServiceErrorCodeChecker(BaseChecker): - def __init__(self, status_code, error_code): - self._status_code = status_code - self._error_code = error_code - - def _check_response(self, attempt_number, response): - if response[0].status_code == self._status_code: - actual_error_code = response[1].get('Error', {}).get('Code') - if actual_error_code == self._error_code: - logger.debug( - "retry needed: matching HTTP status and error code seen: " - "%s, %s", self._status_code, self._error_code) - return True - return False - - -class MultiChecker(BaseChecker): - def __init__(self, checkers): - self._checkers = checkers - - def __call__(self, attempt_number, response, caught_exception): - for checker in self._checkers: - checker_response = checker(attempt_number, response, - caught_exception) - if checker_response: - return checker_response - return False - - -class CRC32Checker(BaseChecker): - def __init__(self, header): - # The header where the expected crc32 is located. - self._header_name = header - - def _check_response(self, attempt_number, response): - http_response = response[0] - expected_crc = http_response.headers.get(self._header_name) - if expected_crc is None: - logger.debug("crc32 check skipped, the %s header is not " - "in the http response.", self._header_name) - else: - actual_crc32 = crc32(response[0].content) & 0xffffffff - if not actual_crc32 == int(expected_crc): - logger.debug( - "retry needed: crc32 check failed, expected != actual: " - "%s != %s", int(expected_crc), actual_crc32) - raise ChecksumError(checksum_type='crc32', - expected_checksum=int(expected_crc), - actual_checksum=actual_crc32) - - -class ExceptionRaiser(BaseChecker): - """Raise any caught exceptions. - - This class will raise any non None ``caught_exception``. - - """ - def _check_caught_exception(self, attempt_number, caught_exception): - # This is implementation specific, but this class is useful by - # coordinating with the MaxAttemptsDecorator. - # The MaxAttemptsDecorator has a list of exceptions it should catch - # and retry, but something needs to come along and actually raise the - # caught_exception. That's what this class is being used for. If - # the MaxAttemptsDecorator is not interested in retrying the exception - # then this exception just propogates out past the retry code. - raise caught_exception diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/serialize.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/serialize.py deleted file mode 100644 index 9975ef12..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/serialize.py +++ /dev/null @@ -1,659 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -"""Protocol input serializes. - -This module contains classes that implement input serialization -for the various AWS protocol types. - -These classes essentially take user input, a model object that -represents what the expected input should look like, and it returns -a dictionary that contains the various parts of a request. A few -high level design decisions: - - -* Each protocol type maps to a separate class, all inherit from - ``Serializer``. -* The return value for ``serialize_to_request`` (the main entry - point) returns a dictionary that represents a request. This - will have keys like ``url_path``, ``query_string``, etc. This - is done so that it's a) easy to test and b) not tied to a - particular HTTP library. See the ``serialize_to_request`` docstring - for more details. - -Unicode -------- - -The input to the serializers should be text (str/unicode), not bytes, -with the exception of blob types. Those are assumed to be binary, -and if a str/unicode type is passed in, it will be encoded as utf-8. -""" -import re -import base64 -import calendar -import datetime -from xml.etree import ElementTree - -from botocore.compat import six - -from botocore.compat import json, formatdate -from botocore.utils import parse_to_aware_datetime -from botocore.utils import percent_encode -from botocore.utils import is_json_value_header -from botocore import validate - - -# From the spec, the default timestamp format if not specified is iso8601. -DEFAULT_TIMESTAMP_FORMAT = 'iso8601' -ISO8601 = '%Y-%m-%dT%H:%M:%SZ' -# Same as ISO8601, but with microsecond precision. -ISO8601_MICRO = '%Y-%m-%dT%H:%M:%S.%fZ' - - -def create_serializer(protocol_name, include_validation=True): - # TODO: Unknown protocols. - serializer = SERIALIZERS[protocol_name]() - if include_validation: - validator = validate.ParamValidator() - serializer = validate.ParamValidationDecorator(validator, serializer) - return serializer - - -class Serializer(object): - DEFAULT_METHOD = 'POST' - # Clients can change this to a different MutableMapping - # (i.e OrderedDict) if they want. This is used in the - # compliance test to match the hash ordering used in the - # tests. - MAP_TYPE = dict - DEFAULT_ENCODING = 'utf-8' - - def serialize_to_request(self, parameters, operation_model): - """Serialize parameters into an HTTP request. - - This method takes user provided parameters and a shape - model and serializes the parameters to an HTTP request. - More specifically, this method returns information about - parts of the HTTP request, it does not enforce a particular - interface or standard for an HTTP request. It instead returns - a dictionary of: - - * 'url_path' - * 'query_string' - * 'headers' - * 'body' - * 'method' - - It is then up to consumers to decide how to map this to a Request - object of their HTTP library of choice. Below is an example - return value:: - - {'body': {'Action': 'OperationName', - 'Bar': 'val2', - 'Foo': 'val1', - 'Version': '2014-01-01'}, - 'headers': {}, - 'method': 'POST', - 'query_string': '', - 'url_path': '/'} - - :param parameters: The dictionary input parameters for the - operation (i.e the user input). - :param operation_model: The OperationModel object that describes - the operation. - """ - raise NotImplementedError("serialize_to_request") - - def _create_default_request(self): - # Creates a boilerplate default request dict that subclasses - # can use as a starting point. - serialized = { - 'url_path': '/', - 'query_string': '', - 'method': self.DEFAULT_METHOD, - 'headers': {}, - # An empty body is represented as an empty byte string. - 'body': b'' - } - return serialized - - # Some extra utility methods subclasses can use. - - def _timestamp_iso8601(self, value): - if value.microsecond > 0: - timestamp_format = ISO8601_MICRO - else: - timestamp_format = ISO8601 - return value.strftime(timestamp_format) - - def _timestamp_unixtimestamp(self, value): - return int(calendar.timegm(value.timetuple())) - - def _timestamp_rfc822(self, value): - if isinstance(value, datetime.datetime): - value = self._timestamp_unixtimestamp(value) - return formatdate(value, usegmt=True) - - def _convert_timestamp_to_str(self, value, timestamp_format=None): - if timestamp_format is None: - timestamp_format = self.TIMESTAMP_FORMAT - timestamp_format = timestamp_format.lower() - datetime_obj = parse_to_aware_datetime(value) - converter = getattr( - self, '_timestamp_%s' % timestamp_format) - final_value = converter(datetime_obj) - return final_value - - def _get_serialized_name(self, shape, default_name): - # Returns the serialized name for the shape if it exists. - # Otherwise it will return the passed in default_name. - return shape.serialization.get('name', default_name) - - def _get_base64(self, value): - # Returns the base64-encoded version of value, handling - # both strings and bytes. The returned value is a string - # via the default encoding. - if isinstance(value, six.text_type): - value = value.encode(self.DEFAULT_ENCODING) - return base64.b64encode(value).strip().decode( - self.DEFAULT_ENCODING) - - -class QuerySerializer(Serializer): - - TIMESTAMP_FORMAT = 'iso8601' - - def serialize_to_request(self, parameters, operation_model): - shape = operation_model.input_shape - serialized = self._create_default_request() - serialized['method'] = operation_model.http.get('method', - self.DEFAULT_METHOD) - serialized['headers'] = { - 'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8' - } - # The query serializer only deals with body params so - # that's what we hand off the _serialize_* methods. - body_params = self.MAP_TYPE() - body_params['Action'] = operation_model.name - body_params['Version'] = operation_model.metadata['apiVersion'] - if shape is not None: - self._serialize(body_params, parameters, shape) - serialized['body'] = body_params - return serialized - - def _serialize(self, serialized, value, shape, prefix=''): - # serialized: The dict that is incrementally added to with the - # final serialized parameters. - # value: The current user input value. - # shape: The shape object that describes the structure of the - # input. - # prefix: The incrementally built up prefix for the serialized - # key (i.e Foo.bar.members.1). - method = getattr(self, '_serialize_type_%s' % shape.type_name, - self._default_serialize) - method(serialized, value, shape, prefix=prefix) - - def _serialize_type_structure(self, serialized, value, shape, prefix=''): - members = shape.members - for key, value in value.items(): - member_shape = members[key] - member_prefix = self._get_serialized_name(member_shape, key) - if prefix: - member_prefix = '%s.%s' % (prefix, member_prefix) - self._serialize(serialized, value, member_shape, member_prefix) - - def _serialize_type_list(self, serialized, value, shape, prefix=''): - if not value: - # The query protocol serializes empty lists. - serialized[prefix] = '' - return - if self._is_shape_flattened(shape): - list_prefix = prefix - if shape.member.serialization.get('name'): - name = self._get_serialized_name(shape.member, default_name='') - # Replace '.Original' with '.{name}'. - list_prefix = '.'.join(prefix.split('.')[:-1] + [name]) - else: - list_name = shape.member.serialization.get('name', 'member') - list_prefix = '%s.%s' % (prefix, list_name) - for i, element in enumerate(value, 1): - element_prefix = '%s.%s' % (list_prefix, i) - element_shape = shape.member - self._serialize(serialized, element, element_shape, element_prefix) - - def _serialize_type_map(self, serialized, value, shape, prefix=''): - if self._is_shape_flattened(shape): - full_prefix = prefix - else: - full_prefix = '%s.entry' % prefix - template = full_prefix + '.{i}.{suffix}' - key_shape = shape.key - value_shape = shape.value - key_suffix = self._get_serialized_name(key_shape, default_name='key') - value_suffix = self._get_serialized_name(value_shape, 'value') - for i, key in enumerate(value, 1): - key_prefix = template.format(i=i, suffix=key_suffix) - value_prefix = template.format(i=i, suffix=value_suffix) - self._serialize(serialized, key, key_shape, key_prefix) - self._serialize(serialized, value[key], value_shape, value_prefix) - - def _serialize_type_blob(self, serialized, value, shape, prefix=''): - # Blob args must be base64 encoded. - serialized[prefix] = self._get_base64(value) - - def _serialize_type_timestamp(self, serialized, value, shape, prefix=''): - serialized[prefix] = self._convert_timestamp_to_str( - value, shape.serialization.get('timestampFormat')) - - def _serialize_type_boolean(self, serialized, value, shape, prefix=''): - if value: - serialized[prefix] = 'true' - else: - serialized[prefix] = 'false' - - def _default_serialize(self, serialized, value, shape, prefix=''): - serialized[prefix] = value - - def _is_shape_flattened(self, shape): - return shape.serialization.get('flattened') - - -class EC2Serializer(QuerySerializer): - """EC2 specific customizations to the query protocol serializers. - - The EC2 model is almost, but not exactly, similar to the query protocol - serializer. This class encapsulates those differences. The model - will have be marked with a ``protocol`` of ``ec2``, so you don't need - to worry about wiring this class up correctly. - - """ - - def _get_serialized_name(self, shape, default_name): - # Returns the serialized name for the shape if it exists. - # Otherwise it will return the passed in default_name. - if 'queryName' in shape.serialization: - return shape.serialization['queryName'] - elif 'name' in shape.serialization: - # A locationName is always capitalized - # on input for the ec2 protocol. - name = shape.serialization['name'] - return name[0].upper() + name[1:] - else: - return default_name - - def _serialize_type_list(self, serialized, value, shape, prefix=''): - for i, element in enumerate(value, 1): - element_prefix = '%s.%s' % (prefix, i) - element_shape = shape.member - self._serialize(serialized, element, element_shape, element_prefix) - - -class JSONSerializer(Serializer): - TIMESTAMP_FORMAT = 'unixtimestamp' - - def serialize_to_request(self, parameters, operation_model): - target = '%s.%s' % (operation_model.metadata['targetPrefix'], - operation_model.name) - json_version = operation_model.metadata['jsonVersion'] - serialized = self._create_default_request() - serialized['method'] = operation_model.http.get('method', - self.DEFAULT_METHOD) - serialized['headers'] = { - 'X-Amz-Target': target, - 'Content-Type': 'application/x-amz-json-%s' % json_version, - } - body = self.MAP_TYPE() - input_shape = operation_model.input_shape - if input_shape is not None: - self._serialize(body, parameters, input_shape) - serialized['body'] = json.dumps(body).encode(self.DEFAULT_ENCODING) - return serialized - - def _serialize(self, serialized, value, shape, key=None): - method = getattr(self, '_serialize_type_%s' % shape.type_name, - self._default_serialize) - method(serialized, value, shape, key) - - def _serialize_type_structure(self, serialized, value, shape, key): - if key is not None: - # If a key is provided, this is a result of a recursive - # call so we need to add a new child dict as the value - # of the passed in serialized dict. We'll then add - # all the structure members as key/vals in the new serialized - # dictionary we just created. - new_serialized = self.MAP_TYPE() - serialized[key] = new_serialized - serialized = new_serialized - members = shape.members - for member_key, member_value in value.items(): - member_shape = members[member_key] - if 'name' in member_shape.serialization: - member_key = member_shape.serialization['name'] - self._serialize(serialized, member_value, member_shape, member_key) - - def _serialize_type_map(self, serialized, value, shape, key): - map_obj = self.MAP_TYPE() - serialized[key] = map_obj - for sub_key, sub_value in value.items(): - self._serialize(map_obj, sub_value, shape.value, sub_key) - - def _serialize_type_list(self, serialized, value, shape, key): - list_obj = [] - serialized[key] = list_obj - for list_item in value: - wrapper = {} - # The JSON list serialization is the only case where we aren't - # setting a key on a dict. We handle this by using - # a __current__ key on a wrapper dict to serialize each - # list item before appending it to the serialized list. - self._serialize(wrapper, list_item, shape.member, "__current__") - list_obj.append(wrapper["__current__"]) - - def _default_serialize(self, serialized, value, shape, key): - serialized[key] = value - - def _serialize_type_timestamp(self, serialized, value, shape, key): - serialized[key] = self._convert_timestamp_to_str( - value, shape.serialization.get('timestampFormat')) - - def _serialize_type_blob(self, serialized, value, shape, key): - serialized[key] = self._get_base64(value) - - -class BaseRestSerializer(Serializer): - """Base class for rest protocols. - - The only variance between the various rest protocols is the - way that the body is serialized. All other aspects (headers, uri, etc.) - are the same and logic for serializing those aspects lives here. - - Subclasses must implement the ``_serialize_body_params`` method. - - """ - QUERY_STRING_TIMESTAMP_FORMAT = 'iso8601' - HEADER_TIMESTAMP_FORMAT = 'rfc822' - # This is a list of known values for the "location" key in the - # serialization dict. The location key tells us where on the request - # to put the serialized value. - KNOWN_LOCATIONS = ['uri', 'querystring', 'header', 'headers'] - - def serialize_to_request(self, parameters, operation_model): - serialized = self._create_default_request() - serialized['method'] = operation_model.http.get('method', - self.DEFAULT_METHOD) - shape = operation_model.input_shape - if shape is None: - serialized['url_path'] = operation_model.http['requestUri'] - return serialized - shape_members = shape.members - # While the ``serialized`` key holds the final serialized request - # data, we need interim dicts for the various locations of the - # request. We need this for the uri_path_kwargs and the - # query_string_kwargs because they are templated, so we need - # to gather all the needed data for the string template, - # then we render the template. The body_kwargs is needed - # because once we've collected them all, we run them through - # _serialize_body_params, which for rest-json, creates JSON, - # and for rest-xml, will create XML. This is what the - # ``partitioned`` dict below is for. - partitioned = { - 'uri_path_kwargs': self.MAP_TYPE(), - 'query_string_kwargs': self.MAP_TYPE(), - 'body_kwargs': self.MAP_TYPE(), - 'headers': self.MAP_TYPE(), - } - for param_name, param_value in parameters.items(): - if param_value is None: - # Don't serialize any parameter with a None value. - continue - self._partition_parameters(partitioned, param_name, param_value, - shape_members) - serialized['url_path'] = self._render_uri_template( - operation_model.http['requestUri'], - partitioned['uri_path_kwargs']) - # Note that we lean on the http implementation to handle the case - # where the requestUri path already has query parameters. - # The bundled http client, requests, already supports this. - serialized['query_string'] = partitioned['query_string_kwargs'] - if partitioned['headers']: - serialized['headers'] = partitioned['headers'] - self._serialize_payload(partitioned, parameters, - serialized, shape, shape_members) - return serialized - - def _render_uri_template(self, uri_template, params): - # We need to handle two cases:: - # - # /{Bucket}/foo - # /{Key+}/bar - # A label ending with '+' is greedy. There can only - # be one greedy key. - encoded_params = {} - for template_param in re.findall(r'{(.*?)}', uri_template): - if template_param.endswith('+'): - encoded_params[template_param] = percent_encode( - params[template_param[:-1]], safe='/~') - else: - encoded_params[template_param] = percent_encode( - params[template_param]) - return uri_template.format(**encoded_params) - - def _serialize_payload(self, partitioned, parameters, - serialized, shape, shape_members): - # partitioned - The user input params partitioned by location. - # parameters - The user input params. - # serialized - The final serialized request dict. - # shape - Describes the expected input shape - # shape_members - The members of the input struct shape - payload_member = shape.serialization.get('payload') - if payload_member is not None and \ - shape_members[payload_member].type_name in ['blob', 'string']: - # If it's streaming, then the body is just the - # value of the payload. - body_payload = parameters.get(payload_member, b'') - body_payload = self._encode_payload(body_payload) - serialized['body'] = body_payload - elif payload_member is not None: - # If there's a payload member, we serialized that - # member to they body. - body_params = parameters.get(payload_member) - if body_params is not None: - serialized['body'] = self._serialize_body_params( - body_params, - shape_members[payload_member]) - elif partitioned['body_kwargs']: - serialized['body'] = self._serialize_body_params( - partitioned['body_kwargs'], shape) - - def _encode_payload(self, body): - if isinstance(body, six.text_type): - return body.encode(self.DEFAULT_ENCODING) - return body - - def _partition_parameters(self, partitioned, param_name, - param_value, shape_members): - # This takes the user provided input parameter (``param``) - # and figures out where they go in the request dict. - # Some params are HTTP headers, some are used in the URI, some - # are in the request body. This method deals with this. - member = shape_members[param_name] - location = member.serialization.get('location') - key_name = member.serialization.get('name', param_name) - if location == 'uri': - partitioned['uri_path_kwargs'][key_name] = param_value - elif location == 'querystring': - if isinstance(param_value, dict): - partitioned['query_string_kwargs'].update(param_value) - elif isinstance(param_value, bool): - partitioned['query_string_kwargs'][ - key_name] = str(param_value).lower() - elif member.type_name == 'timestamp': - timestamp_format = member.serialization.get( - 'timestampFormat', self.QUERY_STRING_TIMESTAMP_FORMAT) - partitioned['query_string_kwargs'][ - key_name] = self._convert_timestamp_to_str( - param_value, timestamp_format - ) - else: - partitioned['query_string_kwargs'][key_name] = param_value - elif location == 'header': - shape = shape_members[param_name] - value = self._convert_header_value(shape, param_value) - partitioned['headers'][key_name] = str(value) - elif location == 'headers': - # 'headers' is a bit of an oddball. The ``key_name`` - # is actually really a prefix for the header names: - header_prefix = key_name - # The value provided by the user is a dict so we'll be - # creating multiple header key/val pairs. The key - # name to use for each header is the header_prefix (``key_name``) - # plus the key provided by the user. - self._do_serialize_header_map(header_prefix, - partitioned['headers'], - param_value) - else: - partitioned['body_kwargs'][param_name] = param_value - - def _do_serialize_header_map(self, header_prefix, headers, user_input): - for key, val in user_input.items(): - full_key = header_prefix + key - headers[full_key] = val - - def _serialize_body_params(self, params, shape): - raise NotImplementedError('_serialize_body_params') - - def _convert_header_value(self, shape, value): - if shape.type_name == 'timestamp': - datetime_obj = parse_to_aware_datetime(value) - timestamp = calendar.timegm(datetime_obj.utctimetuple()) - timestamp_format = shape.serialization.get( - 'timestampFormat', self.HEADER_TIMESTAMP_FORMAT) - return self._convert_timestamp_to_str(timestamp, timestamp_format) - elif is_json_value_header(shape): - # Serialize with no spaces after separators to save space in - # the header. - return self._get_base64(json.dumps(value, separators=(',', ':'))) - else: - return value - - -class RestJSONSerializer(BaseRestSerializer, JSONSerializer): - - def _serialize_body_params(self, params, shape): - serialized_body = self.MAP_TYPE() - self._serialize(serialized_body, params, shape) - return json.dumps(serialized_body).encode(self.DEFAULT_ENCODING) - - -class RestXMLSerializer(BaseRestSerializer): - TIMESTAMP_FORMAT = 'iso8601' - - def _serialize_body_params(self, params, shape): - root_name = shape.serialization['name'] - pseudo_root = ElementTree.Element('') - self._serialize(shape, params, pseudo_root, root_name) - real_root = list(pseudo_root)[0] - return ElementTree.tostring(real_root, encoding=self.DEFAULT_ENCODING) - - def _serialize(self, shape, params, xmlnode, name): - method = getattr(self, '_serialize_type_%s' % shape.type_name, - self._default_serialize) - method(xmlnode, params, shape, name) - - def _serialize_type_structure(self, xmlnode, params, shape, name): - structure_node = ElementTree.SubElement(xmlnode, name) - - if 'xmlNamespace' in shape.serialization: - namespace_metadata = shape.serialization['xmlNamespace'] - attribute_name = 'xmlns' - if namespace_metadata.get('prefix'): - attribute_name += ':%s' % namespace_metadata['prefix'] - structure_node.attrib[attribute_name] = namespace_metadata['uri'] - for key, value in params.items(): - member_shape = shape.members[key] - member_name = member_shape.serialization.get('name', key) - # We need to special case member shapes that are marked as an - # xmlAttribute. Rather than serializing into an XML child node, - # we instead serialize the shape to an XML attribute of the - # *current* node. - if value is None: - # Don't serialize any param whose value is None. - return - if member_shape.serialization.get('xmlAttribute'): - # xmlAttributes must have a serialization name. - xml_attribute_name = member_shape.serialization['name'] - structure_node.attrib[xml_attribute_name] = value - continue - self._serialize(member_shape, value, structure_node, member_name) - - def _serialize_type_list(self, xmlnode, params, shape, name): - member_shape = shape.member - if shape.serialization.get('flattened'): - element_name = name - list_node = xmlnode - else: - element_name = member_shape.serialization.get('name', 'member') - list_node = ElementTree.SubElement(xmlnode, name) - for item in params: - self._serialize(member_shape, item, list_node, element_name) - - def _serialize_type_map(self, xmlnode, params, shape, name): - # Given the ``name`` of MyMap, and input of {"key1": "val1"} - # we serialize this as: - # - # - # key1 - # val1 - # - # - node = ElementTree.SubElement(xmlnode, name) - # TODO: handle flattened maps. - for key, value in params.items(): - entry_node = ElementTree.SubElement(node, 'entry') - key_name = self._get_serialized_name(shape.key, default_name='key') - val_name = self._get_serialized_name(shape.value, - default_name='value') - self._serialize(shape.key, key, entry_node, key_name) - self._serialize(shape.value, value, entry_node, val_name) - - def _serialize_type_boolean(self, xmlnode, params, shape, name): - # For scalar types, the 'params' attr is actually just a scalar - # value representing the data we need to serialize as a boolean. - # It will either be 'true' or 'false' - node = ElementTree.SubElement(xmlnode, name) - if params: - str_value = 'true' - else: - str_value = 'false' - node.text = str_value - - def _serialize_type_blob(self, xmlnode, params, shape, name): - node = ElementTree.SubElement(xmlnode, name) - node.text = self._get_base64(params) - - def _serialize_type_timestamp(self, xmlnode, params, shape, name): - node = ElementTree.SubElement(xmlnode, name) - node.text = self._convert_timestamp_to_str( - params, shape.serialization.get('timestampFormat')) - - def _default_serialize(self, xmlnode, params, shape, name): - node = ElementTree.SubElement(xmlnode, name) - node.text = six.text_type(params) - - -SERIALIZERS = { - 'ec2': EC2Serializer, - 'query': QuerySerializer, - 'json': JSONSerializer, - 'rest-json': RestJSONSerializer, - 'rest-xml': RestXMLSerializer, -} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/session.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/session.py deleted file mode 100644 index 9fb41a8f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/session.py +++ /dev/null @@ -1,975 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -""" -This module contains the main interface to the botocore package, the -Session object. -""" - -import copy -import logging -import os -import platform -import warnings - -from botocore import __version__ -import botocore.configloader -import botocore.credentials -import botocore.client -from botocore.exceptions import ConfigNotFound, ProfileNotFound -from botocore.exceptions import UnknownServiceError, PartialCredentialsError -from botocore.errorfactory import ClientExceptionsFactory -from botocore import handlers -from botocore.hooks import HierarchicalEmitter, first_non_none_response -from botocore.loaders import create_loader -from botocore.parsers import ResponseParserFactory -from botocore.regions import EndpointResolver -from botocore.model import ServiceModel -from botocore import paginate -from botocore import waiter -from botocore import retryhandler, translate - - -logger = logging.getLogger(__name__) - - -class Session(object): - """ - The Session object collects together useful functionality - from `botocore` as well as important data such as configuration - information and credentials into a single, easy-to-use object. - - :ivar available_profiles: A list of profiles defined in the config - file associated with this session. - :ivar profile: The current profile. - """ - - #: A default dictionary that maps the logical names for session variables - #: to the specific environment variables and configuration file names - #: that contain the values for these variables. - #: When creating a new Session object, you can pass in your own dictionary - #: to remap the logical names or to add new logical names. You can then - #: get the current value for these variables by using the - #: ``get_config_variable`` method of the :class:`botocore.session.Session` - #: class. - #: These form the keys of the dictionary. The values in the dictionary - #: are tuples of (, , , - #: ). - #: The conversion func is a function that takes the configuration value - #: as an argument and returns the converted value. If this value is - #: None, then the configuration value is returned unmodified. This - #: conversion function can be used to type convert config values to - #: values other than the default values of strings. - #: The ``profile`` and ``config_file`` variables should always have a - #: None value for the first entry in the tuple because it doesn't make - #: sense to look inside the config file for the location of the config - #: file or for the default profile to use. - #: The ``config_name`` is the name to look for in the configuration file, - #: the ``env var`` is the OS environment variable (``os.environ``) to - #: use, and ``default_value`` is the value to use if no value is otherwise - #: found. - SESSION_VARIABLES = { - # logical: config_file, env_var, default_value, conversion_func - 'profile': (None, ['AWS_DEFAULT_PROFILE', 'AWS_PROFILE'], None, None), - 'region': ('region', 'AWS_DEFAULT_REGION', None, None), - 'data_path': ('data_path', 'AWS_DATA_PATH', None, None), - 'config_file': (None, 'AWS_CONFIG_FILE', '~/.aws/config', None), - 'ca_bundle': ('ca_bundle', 'AWS_CA_BUNDLE', None, None), - 'api_versions': ('api_versions', None, {}, None), - - # This is the shared credentials file amongst sdks. - 'credentials_file': (None, 'AWS_SHARED_CREDENTIALS_FILE', - '~/.aws/credentials', None), - - # These variables only exist in the config file. - - # This is the number of seconds until we time out a request to - # the instance metadata service. - 'metadata_service_timeout': ( - 'metadata_service_timeout', - 'AWS_METADATA_SERVICE_TIMEOUT', 1, int), - # This is the number of request attempts we make until we give - # up trying to retrieve data from the instance metadata service. - 'metadata_service_num_attempts': ( - 'metadata_service_num_attempts', - 'AWS_METADATA_SERVICE_NUM_ATTEMPTS', 1, int), - 'parameter_validation': ('parameter_validation', None, True, None), - } - - #: The default format string to use when configuring the botocore logger. - LOG_FORMAT = '%(asctime)s - %(name)s - %(levelname)s - %(message)s' - - def __init__(self, session_vars=None, event_hooks=None, - include_builtin_handlers=True, profile=None): - """ - Create a new Session object. - - :type session_vars: dict - :param session_vars: A dictionary that is used to override some or all - of the environment variables associated with this session. The - key/value pairs defined in this dictionary will override the - corresponding variables defined in ``SESSION_VARIABLES``. - - :type event_hooks: BaseEventHooks - :param event_hooks: The event hooks object to use. If one is not - provided, an event hooks object will be automatically created - for you. - - :type include_builtin_handlers: bool - :param include_builtin_handlers: Indicates whether or not to - automatically register builtin handlers. - - :type profile: str - :param profile: The name of the profile to use for this - session. Note that the profile can only be set when - the session is created. - - """ - self.session_var_map = copy.copy(self.SESSION_VARIABLES) - if session_vars: - self.session_var_map.update(session_vars) - if event_hooks is None: - self._events = HierarchicalEmitter() - else: - self._events = event_hooks - if include_builtin_handlers: - self._register_builtin_handlers(self._events) - self.user_agent_name = 'Botocore' - self.user_agent_version = __version__ - self.user_agent_extra = '' - # The _profile attribute is just used to cache the value - # of the current profile to avoid going through the normal - # config lookup process each access time. - self._profile = None - self._config = None - self._credentials = None - self._profile_map = None - # This is a dict that stores per session specific config variable - # overrides via set_config_variable(). - self._session_instance_vars = {} - if profile is not None: - self._session_instance_vars['profile'] = profile - self._client_config = None - self._components = ComponentLocator() - self._internal_components = ComponentLocator() - self._register_components() - - def _register_components(self): - self._register_credential_provider() - self._register_data_loader() - self._register_endpoint_resolver() - self._register_event_emitter() - self._register_response_parser_factory() - self._register_exceptions_factory() - - def _register_event_emitter(self): - self._components.register_component('event_emitter', self._events) - - def _register_credential_provider(self): - self._components.lazy_register_component( - 'credential_provider', - lambda: botocore.credentials.create_credential_resolver(self)) - - def _register_data_loader(self): - self._components.lazy_register_component( - 'data_loader', - lambda: create_loader(self.get_config_variable('data_path'))) - - def _register_endpoint_resolver(self): - def create_default_resolver(): - loader = self.get_component('data_loader') - endpoints = loader.load_data('endpoints') - return EndpointResolver(endpoints) - self._internal_components.lazy_register_component( - 'endpoint_resolver', create_default_resolver) - - def _register_response_parser_factory(self): - self._components.register_component('response_parser_factory', - ResponseParserFactory()) - - def _register_exceptions_factory(self): - self._internal_components.register_component( - 'exceptions_factory', ClientExceptionsFactory()) - - def _register_builtin_handlers(self, events): - for spec in handlers.BUILTIN_HANDLERS: - if len(spec) == 2: - event_name, handler = spec - self.register(event_name, handler) - else: - event_name, handler, register_type = spec - if register_type is handlers.REGISTER_FIRST: - self._events.register_first(event_name, handler) - elif register_type is handlers.REGISTER_LAST: - self._events.register_last(event_name, handler) - - @property - def available_profiles(self): - return list(self._build_profile_map().keys()) - - def _build_profile_map(self): - # This will build the profile map if it has not been created, - # otherwise it will return the cached value. The profile map - # is a list of profile names, to the config values for the profile. - if self._profile_map is None: - self._profile_map = self.full_config['profiles'] - return self._profile_map - - @property - def profile(self): - if self._profile is None: - profile = self.get_config_variable('profile') - self._profile = profile - return self._profile - - def get_config_variable(self, logical_name, - methods=('instance', 'env', 'config')): - """ - Retrieve the value associated with the specified logical_name - from the environment or the config file. Values found in the - environment variable take precedence of values found in the - config file. If no value can be found, a None will be returned. - - :type logical_name: str - :param logical_name: The logical name of the session variable - you want to retrieve. This name will be mapped to the - appropriate environment variable name for this session as - well as the appropriate config file entry. - - :type method: tuple - :param method: Defines which methods will be used to find - the variable value. By default, all available methods - are tried but you can limit which methods are used - by supplying a different value to this parameter. - Valid choices are: instance|env|config - - :returns: value of variable or None if not defined. - - """ - # Handle all the short circuit special cases first. - if logical_name not in self.session_var_map: - return - # Do the actual lookups. We need to handle - # 'instance', 'env', and 'config' locations, in that order. - value = None - var_config = self.session_var_map[logical_name] - if self._found_in_instance_vars(methods, logical_name): - value = self._session_instance_vars[logical_name] - logger.debug( - "Loading variable %s from instance vars with value %r.", - logical_name, - value, - ) - return value - elif self._found_in_env(methods, var_config): - value = self._retrieve_from_env(var_config[1], os.environ) - logger.debug( - "Loading variable %s from environment with value %r.", - logical_name, - value, - ) - elif self._found_in_config_file(methods, var_config): - value = self.get_scoped_config()[var_config[0]] - logger.debug( - "Loading variable %s from config file with value %r.", - logical_name, - value, - ) - if value is None: - logger.debug("Loading variable %s from defaults.", logical_name) - value = var_config[2] - if var_config[3] is not None: - value = var_config[3](value) - return value - - def _found_in_instance_vars(self, methods, logical_name): - if 'instance' in methods: - return logical_name in self._session_instance_vars - return False - - def _found_in_env(self, methods, var_config): - return ( - 'env' in methods and - var_config[1] is not None and - self._retrieve_from_env(var_config[1], os.environ) is not None) - - def _found_in_config_file(self, methods, var_config): - if 'config' in methods and var_config[0] is not None: - return var_config[0] in self.get_scoped_config() - return False - - def _retrieve_from_env(self, names, environ): - # We need to handle the case where names is either - # a single value or a list of variables. - if not isinstance(names, list): - names = [names] - for name in names: - if name in environ: - return environ[name] - return None - - def set_config_variable(self, logical_name, value): - """Set a configuration variable to a specific value. - - By using this method, you can override the normal lookup - process used in ``get_config_variable`` by explicitly setting - a value. Subsequent calls to ``get_config_variable`` will - use the ``value``. This gives you per-session specific - configuration values. - - :: - >>> # Assume logical name 'foo' maps to env var 'FOO' - >>> os.environ['FOO'] = 'myvalue' - >>> s.get_config_variable('foo') - 'myvalue' - >>> s.set_config_variable('foo', 'othervalue') - >>> s.get_config_variable('foo') - 'othervalue' - - :type logical_name: str - :param logical_name: The logical name of the session variable - you want to set. These are the keys in ``SESSION_VARIABLES``. - :param value: The value to associate with the config variable. - - """ - logger.debug( - "Setting config variable for %s to %r", - logical_name, - value, - ) - self._session_instance_vars[logical_name] = value - - def get_scoped_config(self): - """ - Returns the config values from the config file scoped to the current - profile. - - The configuration data is loaded **only** from the config file. - It does not resolve variables based on different locations - (e.g. first from the session instance, then from environment - variables, then from the config file). If you want this lookup - behavior, use the ``get_config_variable`` method instead. - - Note that this configuration is specific to a single profile (the - ``profile`` session variable). - - If the ``profile`` session variable is set and the profile does - not exist in the config file, a ``ProfileNotFound`` exception - will be raised. - - :raises: ConfigNotFound, ConfigParseError, ProfileNotFound - :rtype: dict - - """ - profile_name = self.get_config_variable('profile') - profile_map = self._build_profile_map() - # If a profile is not explicitly set return the default - # profile config or an empty config dict if we don't have - # a default profile. - if profile_name is None: - return profile_map.get('default', {}) - elif profile_name not in profile_map: - # Otherwise if they specified a profile, it has to - # exist (even if it's the default profile) otherwise - # we complain. - raise ProfileNotFound(profile=profile_name) - else: - return profile_map[profile_name] - - @property - def full_config(self): - """Return the parsed config file. - - The ``get_config`` method returns the config associated with the - specified profile. This property returns the contents of the - **entire** config file. - - :rtype: dict - """ - if self._config is None: - try: - config_file = self.get_config_variable('config_file') - self._config = botocore.configloader.load_config(config_file) - except ConfigNotFound: - self._config = {'profiles': {}} - try: - # Now we need to inject the profiles from the - # credentials file. We don't actually need the values - # in the creds file, only the profile names so that we - # can validate the user is not referring to a nonexistent - # profile. - cred_file = self.get_config_variable('credentials_file') - cred_profiles = botocore.configloader.raw_config_parse( - cred_file) - for profile in cred_profiles: - cred_vars = cred_profiles[profile] - if profile not in self._config['profiles']: - self._config['profiles'][profile] = cred_vars - else: - self._config['profiles'][profile].update(cred_vars) - except ConfigNotFound: - pass - return self._config - - def get_default_client_config(self): - """Retrieves the default config for creating clients - - :rtype: botocore.client.Config - :returns: The default client config object when creating clients. If - the value is ``None`` then there is no default config object - attached to the session. - """ - return self._client_config - - def set_default_client_config(self, client_config): - """Sets the default config for creating clients - - :type client_config: botocore.client.Config - :param client_config: The default client config object when creating - clients. If the value is ``None`` then there is no default config - object attached to the session. - """ - self._client_config = client_config - - def set_credentials(self, access_key, secret_key, token=None): - """ - Manually create credentials for this session. If you would - prefer to use botocore without a config file, environment variables, - or IAM roles, you can pass explicit credentials into this - method to establish credentials for this session. - - :type access_key: str - :param access_key: The access key part of the credentials. - - :type secret_key: str - :param secret_key: The secret key part of the credentials. - - :type token: str - :param token: An option session token used by STS session - credentials. - """ - self._credentials = botocore.credentials.Credentials(access_key, - secret_key, - token) - - def get_credentials(self): - """ - Return the :class:`botocore.credential.Credential` object - associated with this session. If the credentials have not - yet been loaded, this will attempt to load them. If they - have already been loaded, this will return the cached - credentials. - - """ - if self._credentials is None: - self._credentials = self._components.get_component( - 'credential_provider').load_credentials() - return self._credentials - - def user_agent(self): - """ - Return a string suitable for use as a User-Agent header. - The string will be of the form: - - / Python/ / - - Where: - - - agent_name is the value of the `user_agent_name` attribute - of the session object (`Boto` by default). - - agent_version is the value of the `user_agent_version` - attribute of the session object (the botocore version by default). - by default. - - py_ver is the version of the Python interpreter beng used. - - plat_name is the name of the platform (e.g. Darwin) - - plat_ver is the version of the platform - - exec_env is exec-env/$AWS_EXECUTION_ENV - - If ``user_agent_extra`` is not empty, then this value will be - appended to the end of the user agent string. - - """ - base = '%s/%s Python/%s %s/%s' % (self.user_agent_name, - self.user_agent_version, - platform.python_version(), - platform.system(), - platform.release()) - if os.environ.get('AWS_EXECUTION_ENV') is not None: - base += ' exec-env/%s' % os.environ.get('AWS_EXECUTION_ENV') - if self.user_agent_extra: - base += ' %s' % self.user_agent_extra - - return base - - def get_data(self, data_path): - """ - Retrieve the data associated with `data_path`. - - :type data_path: str - :param data_path: The path to the data you wish to retrieve. - """ - return self.get_component('data_loader').load_data(data_path) - - def get_service_model(self, service_name, api_version=None): - """Get the service model object. - - :type service_name: string - :param service_name: The service name - - :type api_version: string - :param api_version: The API version of the service. If none is - provided, then the latest API version will be used. - - :rtype: L{botocore.model.ServiceModel} - :return: The botocore service model for the service. - - """ - service_description = self.get_service_data(service_name, api_version) - return ServiceModel(service_description, service_name=service_name) - - def get_waiter_model(self, service_name, api_version=None): - loader = self.get_component('data_loader') - waiter_config = loader.load_service_model( - service_name, 'waiters-2', api_version) - return waiter.WaiterModel(waiter_config) - - def get_paginator_model(self, service_name, api_version=None): - loader = self.get_component('data_loader') - paginator_config = loader.load_service_model( - service_name, 'paginators-1', api_version) - return paginate.PaginatorModel(paginator_config) - - def get_service_data(self, service_name, api_version=None): - """ - Retrieve the fully merged data associated with a service. - """ - data_path = service_name - service_data = self.get_component('data_loader').load_service_model( - data_path, - type_name='service-2', - api_version=api_version - ) - self._events.emit('service-data-loaded.%s' % service_name, - service_data=service_data, - service_name=service_name, session=self) - return service_data - - def get_available_services(self): - """ - Return a list of names of available services. - """ - return self.get_component('data_loader')\ - .list_available_services(type_name='service-2') - - def set_debug_logger(self, logger_name='botocore'): - """ - Convenience function to quickly configure full debug output - to go to the console. - """ - self.set_stream_logger(logger_name, logging.DEBUG) - - def set_stream_logger(self, logger_name, log_level, stream=None, - format_string=None): - """ - Convenience method to configure a stream logger. - - :type logger_name: str - :param logger_name: The name of the logger to configure - - :type log_level: str - :param log_level: The log level to set for the logger. This - is any param supported by the ``.setLevel()`` method of - a ``Log`` object. - - :type stream: file - :param stream: A file like object to log to. If none is provided - then sys.stderr will be used. - - :type format_string: str - :param format_string: The format string to use for the log - formatter. If none is provided this will default to - ``self.LOG_FORMAT``. - - """ - log = logging.getLogger(logger_name) - log.setLevel(logging.DEBUG) - - ch = logging.StreamHandler(stream) - ch.setLevel(log_level) - - # create formatter - if format_string is None: - format_string = self.LOG_FORMAT - formatter = logging.Formatter(format_string) - - # add formatter to ch - ch.setFormatter(formatter) - - # add ch to logger - log.addHandler(ch) - - def set_file_logger(self, log_level, path, logger_name='botocore'): - """ - Convenience function to quickly configure any level of logging - to a file. - - :type log_level: int - :param log_level: A log level as specified in the `logging` module - - :type path: string - :param path: Path to the log file. The file will be created - if it doesn't already exist. - """ - log = logging.getLogger(logger_name) - log.setLevel(logging.DEBUG) - - # create console handler and set level to debug - ch = logging.FileHandler(path) - ch.setLevel(log_level) - - # create formatter - formatter = logging.Formatter(self.LOG_FORMAT) - - # add formatter to ch - ch.setFormatter(formatter) - - # add ch to logger - log.addHandler(ch) - - def register(self, event_name, handler, unique_id=None, - unique_id_uses_count=False): - """Register a handler with an event. - - :type event_name: str - :param event_name: The name of the event. - - :type handler: callable - :param handler: The callback to invoke when the event - is emitted. This object must be callable, and must - accept ``**kwargs``. If either of these preconditions are - not met, a ``ValueError`` will be raised. - - :type unique_id: str - :param unique_id: An optional identifier to associate with the - registration. A unique_id can only be used once for - the entire session registration (unless it is unregistered). - This can be used to prevent an event handler from being - registered twice. - - :param unique_id_uses_count: boolean - :param unique_id_uses_count: Specifies if the event should maintain - a count when a ``unique_id`` is registered and unregisted. The - event can only be completely unregistered once every register call - using the unique id has been matched by an ``unregister`` call. - If ``unique_id`` is specified, subsequent ``register`` - calls must use the same value for ``unique_id_uses_count`` - as the ``register`` call that first registered the event. - - :raises ValueError: If the call to ``register`` uses ``unique_id`` - but the value for ``unique_id_uses_count`` differs from the - ``unique_id_uses_count`` value declared by the very first - ``register`` call for that ``unique_id``. - """ - self._events.register(event_name, handler, unique_id, - unique_id_uses_count=unique_id_uses_count) - - def unregister(self, event_name, handler=None, unique_id=None, - unique_id_uses_count=False): - """Unregister a handler with an event. - - :type event_name: str - :param event_name: The name of the event. - - :type handler: callable - :param handler: The callback to unregister. - - :type unique_id: str - :param unique_id: A unique identifier identifying the callback - to unregister. You can provide either the handler or the - unique_id, you do not have to provide both. - - :param unique_id_uses_count: boolean - :param unique_id_uses_count: Specifies if the event should maintain - a count when a ``unique_id`` is registered and unregisted. The - event can only be completely unregistered once every ``register`` - call using the ``unique_id`` has been matched by an ``unregister`` - call. If the ``unique_id`` is specified, subsequent - ``unregister`` calls must use the same value for - ``unique_id_uses_count`` as the ``register`` call that first - registered the event. - - :raises ValueError: If the call to ``unregister`` uses ``unique_id`` - but the value for ``unique_id_uses_count`` differs from the - ``unique_id_uses_count`` value declared by the very first - ``register`` call for that ``unique_id``. - """ - self._events.unregister(event_name, handler=handler, - unique_id=unique_id, - unique_id_uses_count=unique_id_uses_count) - - def emit(self, event_name, **kwargs): - return self._events.emit(event_name, **kwargs) - - def emit_first_non_none_response(self, event_name, **kwargs): - responses = self._events.emit(event_name, **kwargs) - return first_non_none_response(responses) - - def get_component(self, name): - try: - return self._components.get_component(name) - except ValueError: - if name in ['endpoint_resolver', 'exceptions_factory']: - warnings.warn( - 'Fetching the %s component with the get_component() ' - 'method is deprecated as the component has always been ' - 'considered an internal interface of botocore' % name, - DeprecationWarning) - return self._internal_components.get_component(name) - raise - - def _get_internal_component(self, name): - # While this method may be called by botocore classes outside of the - # Session, this method should **never** be used by a class that lives - # outside of botocore. - return self._internal_components.get_component(name) - - def _register_internal_component(self, name, component): - # While this method may be called by botocore classes outside of the - # Session, this method should **never** be used by a class that lives - # outside of botocore. - return self._internal_components.register_component(name, component) - - def register_component(self, name, component): - self._components.register_component(name, component) - - def lazy_register_component(self, name, component): - self._components.lazy_register_component(name, component) - - def create_client(self, service_name, region_name=None, api_version=None, - use_ssl=True, verify=None, endpoint_url=None, - aws_access_key_id=None, aws_secret_access_key=None, - aws_session_token=None, config=None): - """Create a botocore client. - - :type service_name: string - :param service_name: The name of the service for which a client will - be created. You can use the ``Sesssion.get_available_services()`` - method to get a list of all available service names. - - :type region_name: string - :param region_name: The name of the region associated with the client. - A client is associated with a single region. - - :type api_version: string - :param api_version: The API version to use. By default, botocore will - use the latest API version when creating a client. You only need - to specify this parameter if you want to use a previous API version - of the client. - - :type use_ssl: boolean - :param use_ssl: Whether or not to use SSL. By default, SSL is used. - Note that not all services support non-ssl connections. - - :type verify: boolean/string - :param verify: Whether or not to verify SSL certificates. - By default SSL certificates are verified. You can provide the - following values: - - * False - do not validate SSL certificates. SSL will still be - used (unless use_ssl is False), but SSL certificates - will not be verified. - * path/to/cert/bundle.pem - A filename of the CA cert bundle to - uses. You can specify this argument if you want to use a - different CA cert bundle than the one used by botocore. - - :type endpoint_url: string - :param endpoint_url: The complete URL to use for the constructed - client. Normally, botocore will automatically construct the - appropriate URL to use when communicating with a service. You can - specify a complete URL (including the "http/https" scheme) to - override this behavior. If this value is provided, then - ``use_ssl`` is ignored. - - :type aws_access_key_id: string - :param aws_access_key_id: The access key to use when creating - the client. This is entirely optional, and if not provided, - the credentials configured for the session will automatically - be used. You only need to provide this argument if you want - to override the credentials used for this specific client. - - :type aws_secret_access_key: string - :param aws_secret_access_key: The secret key to use when creating - the client. Same semantics as aws_access_key_id above. - - :type aws_session_token: string - :param aws_session_token: The session token to use when creating - the client. Same semantics as aws_access_key_id above. - - :type config: botocore.client.Config - :param config: Advanced client configuration options. If a value - is specified in the client config, its value will take precedence - over environment variables and configuration values, but not over - a value passed explicitly to the method. If a default config - object is set on the session, the config object used when creating - the client will be the result of calling ``merge()`` on the - default config with the config provided to this call. - - :rtype: botocore.client.BaseClient - :return: A botocore client instance - - """ - default_client_config = self.get_default_client_config() - # If a config is provided and a default config is set, then - # use the config resulting from merging the two. - if config is not None and default_client_config is not None: - config = default_client_config.merge(config) - # If a config was not provided then use the default - # client config from the session - elif default_client_config is not None: - config = default_client_config - - # Figure out the user-provided region based on the various - # configuration options. - if region_name is None: - if config and config.region_name is not None: - region_name = config.region_name - else: - region_name = self.get_config_variable('region') - - # Figure out the verify value base on the various - # configuration options. - if verify is None: - verify = self.get_config_variable('ca_bundle') - - if api_version is None: - api_version = self.get_config_variable('api_versions').get( - service_name, None) - - loader = self.get_component('data_loader') - event_emitter = self.get_component('event_emitter') - response_parser_factory = self.get_component( - 'response_parser_factory') - if aws_access_key_id is not None and aws_secret_access_key is not None: - credentials = botocore.credentials.Credentials( - access_key=aws_access_key_id, - secret_key=aws_secret_access_key, - token=aws_session_token) - elif self._missing_cred_vars(aws_access_key_id, - aws_secret_access_key): - raise PartialCredentialsError( - provider='explicit', - cred_var=self._missing_cred_vars(aws_access_key_id, - aws_secret_access_key)) - else: - credentials = self.get_credentials() - endpoint_resolver = self._get_internal_component('endpoint_resolver') - exceptions_factory = self._get_internal_component('exceptions_factory') - client_creator = botocore.client.ClientCreator( - loader, endpoint_resolver, self.user_agent(), event_emitter, - retryhandler, translate, response_parser_factory, - exceptions_factory) - client = client_creator.create_client( - service_name=service_name, region_name=region_name, - is_secure=use_ssl, endpoint_url=endpoint_url, verify=verify, - credentials=credentials, scoped_config=self.get_scoped_config(), - client_config=config, api_version=api_version) - return client - - def _missing_cred_vars(self, access_key, secret_key): - if access_key is not None and secret_key is None: - return 'aws_secret_access_key' - if secret_key is not None and access_key is None: - return 'aws_access_key_id' - return None - - def get_available_partitions(self): - """Lists the available partitions found on disk - - :rtype: list - :return: Returns a list of partition names (e.g., ["aws", "aws-cn"]) - """ - resolver = self._get_internal_component('endpoint_resolver') - return resolver.get_available_partitions() - - def get_available_regions(self, service_name, partition_name='aws', - allow_non_regional=False): - """Lists the region and endpoint names of a particular partition. - - :type service_name: string - :param service_name: Name of a service to list endpoint for (e.g., s3). - This parameter accepts a service name (e.g., "elb") or endpoint - prefix (e.g., "elasticloadbalancing"). - - :type partition_name: string - :param partition_name: Name of the partition to limit endpoints to. - (e.g., aws for the public AWS endpoints, aws-cn for AWS China - endpoints, aws-us-gov for AWS GovCloud (US) Endpoints, etc. - - :type allow_non_regional: bool - :param allow_non_regional: Set to True to include endpoints that are - not regional endpoints (e.g., s3-external-1, - fips-us-gov-west-1, etc). - :return: Returns a list of endpoint names (e.g., ["us-east-1"]). - """ - resolver = self._get_internal_component('endpoint_resolver') - results = [] - try: - service_data = self.get_service_data(service_name) - endpoint_prefix = service_data['metadata'].get( - 'endpointPrefix', service_name) - results = resolver.get_available_endpoints( - endpoint_prefix, partition_name, allow_non_regional) - except UnknownServiceError: - pass - return results - - -class ComponentLocator(object): - """Service locator for session components.""" - def __init__(self): - self._components = {} - self._deferred = {} - - def get_component(self, name): - if name in self._deferred: - factory = self._deferred[name] - self._components[name] = factory() - # Only delete the component from the deferred dict after - # successfully creating the object from the factory as well as - # injecting the instantiated value into the _components dict. - del self._deferred[name] - try: - return self._components[name] - except KeyError: - raise ValueError("Unknown component: %s" % name) - - def register_component(self, name, component): - self._components[name] = component - try: - del self._deferred[name] - except KeyError: - pass - - def lazy_register_component(self, name, no_arg_factory): - self._deferred[name] = no_arg_factory - try: - del self._components[name] - except KeyError: - pass - - -def get_session(env_vars=None): - """ - Return a new session object. - """ - return Session(env_vars) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/signers.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/signers.py deleted file mode 100644 index be755849..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/signers.py +++ /dev/null @@ -1,721 +0,0 @@ -# Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import datetime -import weakref -import json -import base64 - -import botocore -import botocore.auth -from botocore.compat import six, OrderedDict -from botocore.awsrequest import create_request_object, prepare_request_dict -from botocore.exceptions import UnknownSignatureVersionError -from botocore.exceptions import UnknownClientMethodError -from botocore.exceptions import UnsupportedSignatureVersionError -from botocore.utils import fix_s3_host, datetime2timestamp - - -class RequestSigner(object): - """ - An object to sign requests before they go out over the wire using - one of the authentication mechanisms defined in ``auth.py``. This - class fires two events scoped to a service and operation name: - - * choose-signer: Allows overriding the auth signer name. - * before-sign: Allows mutating the request before signing. - - Together these events allow for customization of the request - signing pipeline, including overrides, request path manipulation, - and disabling signing per operation. - - :type service_name: string - :param service_name: Name of the service, e.g. ``S3`` - - :type region_name: string - :param region_name: Name of the service region, e.g. ``us-east-1`` - - :type signing_name: string - :param signing_name: Service signing name. This is usually the - same as the service name, but can differ. E.g. - ``emr`` vs. ``elasticmapreduce``. - - :type signature_version: string - :param signature_version: Signature name like ``v4``. - - :type credentials: :py:class:`~botocore.credentials.Credentials` - :param credentials: User credentials with which to sign requests. - - :type event_emitter: :py:class:`~botocore.hooks.BaseEventHooks` - :param event_emitter: Extension mechanism to fire events. - - """ - def __init__(self, service_name, region_name, signing_name, - signature_version, credentials, event_emitter): - self._service_name = service_name - self._region_name = region_name - self._signing_name = signing_name - self._signature_version = signature_version - self._credentials = credentials - - # We need weakref to prevent leaking memory in Python 2.6 on Linux 2.6 - self._event_emitter = weakref.proxy(event_emitter) - - @property - def region_name(self): - return self._region_name - - @property - def signature_version(self): - return self._signature_version - - @property - def signing_name(self): - return self._signing_name - - def handler(self, operation_name=None, request=None, **kwargs): - # This is typically hooked up to the "request-created" event - # from a client's event emitter. When a new request is created - # this method is invoked to sign the request. - # Don't call this method directly. - return self.sign(operation_name, request) - - def sign(self, operation_name, request, region_name=None, - signing_type='standard', expires_in=None, signing_name=None): - """Sign a request before it goes out over the wire. - - :type operation_name: string - :param operation_name: The name of the current operation, e.g. - ``ListBuckets``. - :type request: AWSRequest - :param request: The request object to be sent over the wire. - - :type region_name: str - :param region_name: The region to sign the request for. - - :type signing_type: str - :param signing_type: The type of signing to perform. This can be one of - three possible values: - - * 'standard' - This should be used for most requests. - * 'presign-url' - This should be used when pre-signing a request. - * 'presign-post' - This should be used when pre-signing an S3 post. - - :type expires_in: int - :param expires_in: The number of seconds the presigned url is valid - for. This parameter is only valid for signing type 'presign-url'. - - :type signing_name: str - :param signing_name: The name to use for the service when signing. - """ - if region_name is None: - region_name = self._region_name - - if signing_name is None: - signing_name = self._signing_name - - signature_version = self._choose_signer( - operation_name, signing_type, request.context) - - # Allow mutating request before signing - self._event_emitter.emit( - 'before-sign.{0}.{1}'.format(self._service_name, operation_name), - request=request, signing_name=signing_name, - region_name=self._region_name, - signature_version=signature_version, request_signer=self, - operation_name=operation_name - ) - - if signature_version != botocore.UNSIGNED: - kwargs = { - 'signing_name': signing_name, - 'region_name': region_name, - 'signature_version': signature_version - } - if expires_in is not None: - kwargs['expires'] = expires_in - - try: - auth = self.get_auth_instance(**kwargs) - except UnknownSignatureVersionError as e: - if signing_type != 'standard': - raise UnsupportedSignatureVersionError( - signature_version=signature_version) - else: - raise e - - auth.add_auth(request) - - def _choose_signer(self, operation_name, signing_type, context): - """ - Allow setting the signature version via the choose-signer event. - A value of `botocore.UNSIGNED` means no signing will be performed. - - :param operation_name: The operation to sign. - :param signing_type: The type of signing that the signer is to be used - for. - :return: The signature version to sign with. - """ - signing_type_suffix_map = { - 'presign-post': '-presign-post', - 'presign-url': '-query' - } - suffix = signing_type_suffix_map.get(signing_type, '') - - signature_version = self._signature_version - if signature_version is not botocore.UNSIGNED and not \ - signature_version.endswith(suffix): - signature_version += suffix - - handler, response = self._event_emitter.emit_until_response( - 'choose-signer.{0}.{1}'.format(self._service_name, operation_name), - signing_name=self._signing_name, region_name=self._region_name, - signature_version=signature_version, context=context) - - if response is not None: - signature_version = response - # The suffix needs to be checked again in case we get an improper - # signature version from choose-signer. - if signature_version is not botocore.UNSIGNED and not \ - signature_version.endswith(suffix): - signature_version += suffix - - return signature_version - - def get_auth_instance(self, signing_name, region_name, - signature_version=None, **kwargs): - """ - Get an auth instance which can be used to sign a request - using the given signature version. - - :type signing_name: string - :param signing_name: Service signing name. This is usually the - same as the service name, but can differ. E.g. - ``emr`` vs. ``elasticmapreduce``. - - :type region_name: string - :param region_name: Name of the service region, e.g. ``us-east-1`` - - :type signature_version: string - :param signature_version: Signature name like ``v4``. - - :rtype: :py:class:`~botocore.auth.BaseSigner` - :return: Auth instance to sign a request. - """ - if signature_version is None: - signature_version = self._signature_version - - cls = botocore.auth.AUTH_TYPE_MAPS.get(signature_version) - if cls is None: - raise UnknownSignatureVersionError( - signature_version=signature_version) - # If there's no credentials provided (i.e credentials is None), - # then we'll pass a value of "None" over to the auth classes, - # which already handle the cases where no credentials have - # been provided. - frozen_credentials = None - if self._credentials is not None: - frozen_credentials = self._credentials.get_frozen_credentials() - kwargs['credentials'] = frozen_credentials - if cls.REQUIRES_REGION: - if self._region_name is None: - raise botocore.exceptions.NoRegionError() - kwargs['region_name'] = region_name - kwargs['service_name'] = signing_name - auth = cls(**kwargs) - return auth - - # Alias get_auth for backwards compatibility. - get_auth = get_auth_instance - - def generate_presigned_url(self, request_dict, operation_name, - expires_in=3600, region_name=None, - signing_name=None): - """Generates a presigned url - - :type request_dict: dict - :param request_dict: The prepared request dictionary returned by - ``botocore.awsrequest.prepare_request_dict()`` - - :type operation_name: str - :param operation_name: The operation being signed. - - :type expires_in: int - :param expires_in: The number of seconds the presigned url is valid - for. By default it expires in an hour (3600 seconds) - - :type region_name: string - :param region_name: The region name to sign the presigned url. - - :type signing_name: str - :param signing_name: The name to use for the service when signing. - - :returns: The presigned url - """ - request = create_request_object(request_dict) - self.sign(operation_name, request, region_name, - 'presign-url', expires_in, signing_name) - - request.prepare() - return request.url - - -class CloudFrontSigner(object): - '''A signer to create a signed CloudFront URL. - - First you create a cloudfront signer based on a normalized RSA signer:: - - import rsa - def rsa_signer(message): - private_key = open('private_key.pem', 'r').read() - return rsa.sign( - message, - rsa.PrivateKey.load_pkcs1(private_key.encode('utf8')), - 'SHA-1') # CloudFront requires SHA-1 hash - cf_signer = CloudFrontSigner(key_id, rsa_signer) - - To sign with a canned policy:: - - signed_url = cf_signer.generate_signed_url( - url, date_less_than=datetime(2015, 12, 1)) - - To sign with a custom policy:: - - signed_url = cf_signer.generate_signed_url(url, policy=my_policy) - ''' - - def __init__(self, key_id, rsa_signer): - """Create a CloudFrontSigner. - - :type key_id: str - :param key_id: The CloudFront Key Pair ID - - :type rsa_signer: callable - :param rsa_signer: An RSA signer. - Its only input parameter will be the message to be signed, - and its output will be the signed content as a binary string. - The hash algorithm needed by CloudFront is SHA-1. - """ - self.key_id = key_id - self.rsa_signer = rsa_signer - - def generate_presigned_url(self, url, date_less_than=None, policy=None): - """Creates a signed CloudFront URL based on given parameters. - - :type url: str - :param url: The URL of the protected object - - :type date_less_than: datetime - :param date_less_than: The URL will expire after that date and time - - :type policy: str - :param policy: The custom policy, possibly built by self.build_policy() - - :rtype: str - :return: The signed URL. - """ - if (date_less_than is not None and policy is not None or - date_less_than is None and policy is None): - e = 'Need to provide either date_less_than or policy, but not both' - raise ValueError(e) - if date_less_than is not None: - # We still need to build a canned policy for signing purpose - policy = self.build_policy(url, date_less_than) - if isinstance(policy, six.text_type): - policy = policy.encode('utf8') - if date_less_than is not None: - params = ['Expires=%s' % int(datetime2timestamp(date_less_than))] - else: - params = ['Policy=%s' % self._url_b64encode(policy).decode('utf8')] - signature = self.rsa_signer(policy) - params.extend([ - 'Signature=%s' % self._url_b64encode(signature).decode('utf8'), - 'Key-Pair-Id=%s' % self.key_id, - ]) - return self._build_url(url, params) - - def _build_url(self, base_url, extra_params): - separator = '&' if '?' in base_url else '?' - return base_url + separator + '&'.join(extra_params) - - def build_policy(self, resource, date_less_than, - date_greater_than=None, ip_address=None): - """A helper to build policy. - - :type resource: str - :param resource: The URL or the stream filename of the protected object - - :type date_less_than: datetime - :param date_less_than: The URL will expire after the time has passed - - :type date_greater_than: datetime - :param date_greater_than: The URL will not be valid until this time - - :type ip_address: str - :param ip_address: Use 'x.x.x.x' for an IP, or 'x.x.x.x/x' for a subnet - - :rtype: str - :return: The policy in a compact string. - """ - # Note: - # 1. Order in canned policy is significant. Special care has been taken - # to ensure the output will match the order defined by the document. - # There is also a test case to ensure that order. - # SEE: http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-canned-policy.html#private-content-canned-policy-creating-policy-statement - # 2. Albeit the order in custom policy is not required by CloudFront, - # we still use OrderedDict internally to ensure the result is stable - # and also matches canned policy requirement. - # SEE: http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-custom-policy.html - moment = int(datetime2timestamp(date_less_than)) - condition = OrderedDict({"DateLessThan": {"AWS:EpochTime": moment}}) - if ip_address: - if '/' not in ip_address: - ip_address += '/32' - condition["IpAddress"] = {"AWS:SourceIp": ip_address} - if date_greater_than: - moment = int(datetime2timestamp(date_greater_than)) - condition["DateGreaterThan"] = {"AWS:EpochTime": moment} - ordered_payload = [('Resource', resource), ('Condition', condition)] - custom_policy = {"Statement": [OrderedDict(ordered_payload)]} - return json.dumps(custom_policy, separators=(',', ':')) - - def _url_b64encode(self, data): - # Required by CloudFront. See also: - # http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-linux-openssl.html - return base64.b64encode( - data).replace(b'+', b'-').replace(b'=', b'_').replace(b'/', b'~') - - -def add_generate_db_auth_token(class_attributes, **kwargs): - class_attributes['generate_db_auth_token'] = generate_db_auth_token - - -def generate_db_auth_token(self, DBHostname, Port, DBUsername, Region=None): - """Generates an auth token used to connect to a db with IAM credentials. - - :type DBHostname: str - :param DBHostname: The hostname of the database to connect to. - - :type Port: int - :param Port: The port number the database is listening on. - - :type DBUsername: str - :param DBUsername: The username to log in as. - - :type Region: str - :param Region: The region the database is in. If None, the client - region will be used. - - :return: A presigned url which can be used as an auth token. - """ - region = Region - if region is None: - region = self.meta.region_name - - params = { - 'Action': 'connect', - 'DBUser': DBUsername, - } - - request_dict = { - 'url_path': '/', - 'query_string': '', - 'headers': {}, - 'body': params, - 'method': 'GET' - } - - # RDS requires that the scheme not be set when sent over. This can cause - # issues when signing because the Python url parsing libraries follow - # RFC 1808 closely, which states that a netloc must be introduced by `//`. - # Otherwise the url is presumed to be relative, and thus the whole - # netloc would be treated as a path component. To work around this we - # introduce https here and remove it once we're done processing it. - scheme = 'https://' - endpoint_url = '%s%s:%s' % (scheme, DBHostname, Port) - prepare_request_dict(request_dict, endpoint_url) - presigned_url = self._request_signer.generate_presigned_url( - operation_name='connect', request_dict=request_dict, - region_name=region, expires_in=900, signing_name='rds-db' - ) - return presigned_url[len(scheme):] - - -class S3PostPresigner(object): - def __init__(self, request_signer): - self._request_signer = request_signer - - def generate_presigned_post(self, request_dict, fields=None, - conditions=None, expires_in=3600, - region_name=None): - """Generates the url and the form fields used for a presigned s3 post - - :type request_dict: dict - :param request_dict: The prepared request dictionary returned by - ``botocore.awsrequest.prepare_request_dict()`` - - :type fields: dict - :param fields: A dictionary of prefilled form fields to build on top - of. - - :type conditions: list - :param conditions: A list of conditions to include in the policy. Each - element can be either a list or a structure. For example: - [ - {"acl": "public-read"}, - {"bucket": "mybucket"}, - ["starts-with", "$key", "mykey"] - ] - - :type expires_in: int - :param expires_in: The number of seconds the presigned post is valid - for. - - :type region_name: string - :param region_name: The region name to sign the presigned post to. - - :rtype: dict - :returns: A dictionary with two elements: ``url`` and ``fields``. - Url is the url to post to. Fields is a dictionary filled with - the form fields and respective values to use when submitting the - post. For example: - - {'url': 'https://mybucket.s3.amazonaws.com - 'fields': {'acl': 'public-read', - 'key': 'mykey', - 'signature': 'mysignature', - 'policy': 'mybase64 encoded policy'} - } - """ - if fields is None: - fields = {} - - if conditions is None: - conditions = [] - - # Create the policy for the post. - policy = {} - - # Create an expiration date for the policy - datetime_now = datetime.datetime.utcnow() - expire_date = datetime_now + datetime.timedelta(seconds=expires_in) - policy['expiration'] = expire_date.strftime(botocore.auth.ISO8601) - - # Append all of the conditions that the user supplied. - policy['conditions'] = [] - for condition in conditions: - policy['conditions'].append(condition) - - # Store the policy and the fields in the request for signing - request = create_request_object(request_dict) - request.context['s3-presign-post-fields'] = fields - request.context['s3-presign-post-policy'] = policy - - self._request_signer.sign( - 'PutObject', request, region_name, 'presign-post') - # Return the url and the fields for th form to post. - return {'url': request.url, 'fields': fields} - - -def add_generate_presigned_url(class_attributes, **kwargs): - class_attributes['generate_presigned_url'] = generate_presigned_url - - -def generate_presigned_url(self, ClientMethod, Params=None, ExpiresIn=3600, - HttpMethod=None): - """Generate a presigned url given a client, its method, and arguments - - :type ClientMethod: string - :param ClientMethod: The client method to presign for - - :type Params: dict - :param Params: The parameters normally passed to - ``ClientMethod``. - - :type ExpiresIn: int - :param ExpiresIn: The number of seconds the presigned url is valid - for. By default it expires in an hour (3600 seconds) - - :type HttpMethod: string - :param HttpMethod: The http method to use on the generated url. By - default, the http method is whatever is used in the method's model. - - :returns: The presigned url - """ - client_method = ClientMethod - params = Params - if params is None: - params = {} - expires_in = ExpiresIn - http_method = HttpMethod - context = { - 'is_presign_request': True, - 'use_global_endpoint': _should_use_global_endpoint(self), - } - - request_signer = self._request_signer - serializer = self._serializer - - try: - operation_name = self._PY_TO_OP_NAME[client_method] - except KeyError: - raise UnknownClientMethodError(method_name=client_method) - - operation_model = self.meta.service_model.operation_model( - operation_name) - - params = self._emit_api_params(params, operation_model, context) - - # Create a request dict based on the params to serialize. - request_dict = serializer.serialize_to_request( - params, operation_model) - - # Switch out the http method if user specified it. - if http_method is not None: - request_dict['method'] = http_method - - # Prepare the request dict by including the client's endpoint url. - prepare_request_dict( - request_dict, endpoint_url=self.meta.endpoint_url, context=context) - - # Generate the presigned url. - return request_signer.generate_presigned_url( - request_dict=request_dict, expires_in=expires_in, - operation_name=operation_name) - - -def add_generate_presigned_post(class_attributes, **kwargs): - class_attributes['generate_presigned_post'] = generate_presigned_post - - -def generate_presigned_post(self, Bucket, Key, Fields=None, Conditions=None, - ExpiresIn=3600): - """Builds the url and the form fields used for a presigned s3 post - - :type Bucket: string - :param Bucket: The name of the bucket to presign the post to. Note that - bucket related conditions should not be included in the - ``conditions`` parameter. - - :type Key: string - :param Key: Key name, optionally add ${filename} to the end to - attach the submitted filename. Note that key related conditions and - fields are filled out for you and should not be included in the - ``Fields`` or ``Conditions`` parameter. - - :type Fields: dict - :param Fields: A dictionary of prefilled form fields to build on top - of. Elements that may be included are acl, Cache-Control, - Content-Type, Content-Disposition, Content-Encoding, Expires, - success_action_redirect, redirect, success_action_status, - and x-amz-meta-. - - Note that if a particular element is included in the fields - dictionary it will not be automatically added to the conditions - list. You must specify a condition for the element as well. - - :type Conditions: list - :param Conditions: A list of conditions to include in the policy. Each - element can be either a list or a structure. For example: - - [ - {"acl": "public-read"}, - ["content-length-range", 2, 5], - ["starts-with", "$success_action_redirect", ""] - ] - - Conditions that are included may pertain to acl, - content-length-range, Cache-Control, Content-Type, - Content-Disposition, Content-Encoding, Expires, - success_action_redirect, redirect, success_action_status, - and/or x-amz-meta-. - - Note that if you include a condition, you must specify - the a valid value in the fields dictionary as well. A value will - not be added automatically to the fields dictionary based on the - conditions. - - :type ExpiresIn: int - :param ExpiresIn: The number of seconds the presigned post - is valid for. - - :rtype: dict - :returns: A dictionary with two elements: ``url`` and ``fields``. - Url is the url to post to. Fields is a dictionary filled with - the form fields and respective values to use when submitting the - post. For example: - - {'url': 'https://mybucket.s3.amazonaws.com - 'fields': {'acl': 'public-read', - 'key': 'mykey', - 'signature': 'mysignature', - 'policy': 'mybase64 encoded policy'} - } - """ - bucket = Bucket - key = Key - fields = Fields - conditions = Conditions - expires_in = ExpiresIn - - if fields is None: - fields = {} - - if conditions is None: - conditions = [] - - post_presigner = S3PostPresigner(self._request_signer) - serializer = self._serializer - - # We choose the CreateBucket operation model because its url gets - # serialized to what a presign post requires. - operation_model = self.meta.service_model.operation_model( - 'CreateBucket') - - # Create a request dict based on the params to serialize. - request_dict = serializer.serialize_to_request( - {'Bucket': bucket}, operation_model) - - # Prepare the request dict by including the client's endpoint url. - prepare_request_dict( - request_dict, endpoint_url=self.meta.endpoint_url, - context={ - 'is_presign_request': True, - 'use_global_endpoint': _should_use_global_endpoint(self), - }, - ) - - # Append that the bucket name to the list of conditions. - conditions.append({'bucket': bucket}) - - # If the key ends with filename, the only constraint that can be - # imposed is if it starts with the specified prefix. - if key.endswith('${filename}'): - conditions.append(["starts-with", '$key', key[:-len('${filename}')]]) - else: - conditions.append({'key': key}) - - # Add the key to the fields. - fields['key'] = key - - return post_presigner.generate_presigned_post( - request_dict=request_dict, fields=fields, conditions=conditions, - expires_in=expires_in) - - -def _should_use_global_endpoint(client): - use_dualstack_endpoint = False - if client.meta.config.s3 is not None: - use_dualstack_endpoint = client.meta.config.s3.get( - 'use_dualstack_endpoint', False) - return (client.meta.partition == 'aws' and - not use_dualstack_endpoint) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/stub.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/stub.py deleted file mode 100644 index 312a6cef..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/stub.py +++ /dev/null @@ -1,397 +0,0 @@ -# Copyright 2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import copy -from collections import deque -from pprint import pformat - -from botocore.validate import validate_parameters -from botocore.exceptions import ParamValidationError, \ - StubResponseError, StubAssertionError, UnStubbedResponseError -from botocore.vendored.requests.models import Response - - -class _ANY(object): - """ - A helper object that compares equal to everything. Copied from - unittest.mock - """ - - def __eq__(self, other): - return True - - def __ne__(self, other): - return False - - def __repr__(self): - return '' - -ANY = _ANY() - - -class Stubber(object): - """ - This class will allow you to stub out requests so you don't have to hit - an endpoint to write tests. Responses are returned first in, first out. - If operations are called out of order, or are called with no remaining - queued responses, an error will be raised. - - **Example:** - :: - import datetime - import botocore.session - from botocore.stub import Stubber - - - s3 = botocore.session.get_session().create_client('s3') - stubber = Stubber(s3) - - response = { - 'IsTruncated': False, - 'Name': 'test-bucket', - 'MaxKeys': 1000, 'Prefix': '', - 'Contents': [{ - 'Key': 'test.txt', - 'ETag': '"abc123"', - 'StorageClass': 'STANDARD', - 'LastModified': datetime.datetime(2016, 1, 20, 22, 9), - 'Owner': {'ID': 'abc123', 'DisplayName': 'myname'}, - 'Size': 14814 - }], - 'EncodingType': 'url', - 'ResponseMetadata': { - 'RequestId': 'abc123', - 'HTTPStatusCode': 200, - 'HostId': 'abc123' - }, - 'Marker': '' - } - - expected_params = {'Bucket': 'test-bucket'} - - stubber.add_response('list_objects', response, expected_params) - stubber.activate() - - service_response = s3.list_objects(Bucket='test-bucket') - assert service_response == response - - - This class can also be called as a context manager, which will handle - activation / deactivation for you. - - **Example:** - :: - import datetime - import botocore.session - from botocore.stub import Stubber - - - s3 = botocore.session.get_session().create_client('s3') - - response = { - "Owner": { - "ID": "foo", - "DisplayName": "bar" - }, - "Buckets": [{ - "CreationDate": datetime.datetime(2016, 1, 20, 22, 9), - "Name": "baz" - }] - } - - - with Stubber(s3) as stubber: - stubber.add_response('list_buckets', response, {}) - service_response = s3.list_buckets() - - assert service_response == response - - - If you have an input parameter that is a randomly generated value, or you - otherwise don't care about its value, you can use ``stub.ANY`` to ignore - it in validation. - - **Example:** - :: - import datetime - import botocore.session - from botocore.stub import Stubber, ANY - - - s3 = botocore.session.get_session().create_client('s3') - stubber = Stubber(s3) - - response = { - 'IsTruncated': False, - 'Name': 'test-bucket', - 'MaxKeys': 1000, 'Prefix': '', - 'Contents': [{ - 'Key': 'test.txt', - 'ETag': '"abc123"', - 'StorageClass': 'STANDARD', - 'LastModified': datetime.datetime(2016, 1, 20, 22, 9), - 'Owner': {'ID': 'abc123', 'DisplayName': 'myname'}, - 'Size': 14814 - }], - 'EncodingType': 'url', - 'ResponseMetadata': { - 'RequestId': 'abc123', - 'HTTPStatusCode': 200, - 'HostId': 'abc123' - }, - 'Marker': '' - } - - expected_params = {'Bucket': ANY} - stubber.add_response('list_objects', response, expected_params) - - with stubber: - service_response = s3.list_objects(Bucket='test-bucket') - - assert service_response == response - """ - def __init__(self, client): - """ - :param client: The client to add your stubs to. - """ - self.client = client - self._event_id = 'boto_stubber' - self._expected_params_event_id = 'boto_stubber_expected_params' - self._queue = deque() - - def __enter__(self): - self.activate() - return self - - def __exit__(self, exception_type, exception_value, traceback): - self.deactivate() - - def activate(self): - """ - Activates the stubber on the client - """ - self.client.meta.events.register_first( - 'before-parameter-build.*.*', - self._assert_expected_params, - unique_id=self._expected_params_event_id) - self.client.meta.events.register( - 'before-call.*.*', - self._get_response_handler, - unique_id=self._event_id) - - def deactivate(self): - """ - Deactivates the stubber on the client - """ - self.client.meta.events.unregister( - 'before-parameter-build.*.*', - self._assert_expected_params, - unique_id=self._expected_params_event_id) - self.client.meta.events.unregister( - 'before-call.*.*', - self._get_response_handler, - unique_id=self._event_id) - - def add_response(self, method, service_response, expected_params=None): - """ - Adds a service response to the response queue. This will be validated - against the service model to ensure correctness. It should be noted, - however, that while missing attributes are often considered correct, - your code may not function properly if you leave them out. Therefore - you should always fill in every value you see in a typical response for - your particular request. - - :param method: The name of the client method to stub. - :type method: str - - :param service_response: A dict response stub. Provided parameters will - be validated against the service model. - :type service_response: dict - - :param expected_params: A dictionary of the expected parameters to - be called for the provided service response. The parameters match - the names of keyword arguments passed to that client call. If - any of the parameters differ a ``StubResponseError`` is thrown. - You can use stub.ANY to indicate a particular parameter to ignore - in validation. stub.ANY is only valid for top level params. - """ - self._add_response(method, service_response, expected_params) - - def _add_response(self, method, service_response, expected_params): - if not hasattr(self.client, method): - raise ValueError( - "Client %s does not have method: %s" - % (self.client.meta.service_model.service_name, method)) - - # Create a successful http response - http_response = Response() - http_response.status_code = 200 - http_response.reason = 'OK' - - operation_name = self.client.meta.method_to_api_mapping.get(method) - self._validate_response(operation_name, service_response) - - # Add the service_response to the queue for returning responses - response = { - 'operation_name': operation_name, - 'response': (http_response, service_response), - 'expected_params': expected_params - } - self._queue.append(response) - - def add_client_error(self, method, service_error_code='', - service_message='', http_status_code=400, - service_error_meta=None, expected_params=None, - response_meta=None): - """ - Adds a ``ClientError`` to the response queue. - - :param method: The name of the service method to return the error on. - :type method: str - - :param service_error_code: The service error code to return, - e.g. ``NoSuchBucket`` - :type service_error_code: str - - :param service_message: The service message to return, e.g. - 'The specified bucket does not exist.' - :type service_message: str - - :param http_status_code: The HTTP status code to return, e.g. 404, etc - :type http_status_code: int - - :param service_error_meta: Additional keys to be added to the - service Error - :type service_error_meta: dict - - :param expected_params: A dictionary of the expected parameters to - be called for the provided service response. The parameters match - the names of keyword arguments passed to that client call. If - any of the parameters differ a ``StubResponseError`` is thrown. - You can use stub.ANY to indicate a particular parameter to ignore - in validation. - - :param response_meta: Additional keys to be added to the - response's ResponseMetadata - :type response_meta: dict - - """ - http_response = Response() - http_response.status_code = http_status_code - - # We don't look to the model to build this because the caller would - # need to know the details of what the HTTP body would need to - # look like. - parsed_response = { - 'ResponseMetadata': {'HTTPStatusCode': http_status_code}, - 'Error': { - 'Message': service_message, - 'Code': service_error_code - } - } - - if service_error_meta is not None: - parsed_response['Error'].update(service_error_meta) - - if response_meta is not None: - parsed_response['ResponseMetadata'].update(response_meta) - - operation_name = self.client.meta.method_to_api_mapping.get(method) - # Note that we do not allow for expected_params while - # adding errors into the queue yet. - response = { - 'operation_name': operation_name, - 'response': (http_response, parsed_response), - 'expected_params': expected_params, - } - self._queue.append(response) - - def assert_no_pending_responses(self): - """ - Asserts that all expected calls were made. - """ - remaining = len(self._queue) - if remaining != 0: - raise AssertionError( - "%d responses remaining in queue." % remaining) - - def _assert_expected_call_order(self, model, params): - if not self._queue: - raise UnStubbedResponseError( - operation_name=model.name, - reason=( - 'Unexpected API Call: A call was made but no additional calls expected.' - 'Either the API Call was not stubbed or it was called multiple times.' - ) - ) - - name = self._queue[0]['operation_name'] - if name != model.name: - raise StubResponseError( - operation_name=model.name, - reason='Operation mismatch: found response for %s.' % name) - - def _get_response_handler(self, model, params, context, **kwargs): - self._assert_expected_call_order(model, params) - # Pop off the entire response once everything has been validated - return self._queue.popleft()['response'] - - def _assert_expected_params(self, model, params, context, **kwargs): - if self._should_not_stub(context): - return - self._assert_expected_call_order(model, params) - expected_params = self._queue[0]['expected_params'] - if expected_params is None: - return - - # Validate the parameters are equal - for param, value in expected_params.items(): - if param not in params or expected_params[param] != params[param]: - raise StubAssertionError( - operation_name=model.name, - reason='Expected parameters:\n%s,\nbut received:\n%s' % ( - pformat(expected_params), pformat(params))) - - # Ensure there are no extra params hanging around - if sorted(expected_params.keys()) != sorted(params.keys()): - raise StubAssertionError( - operation_name=model.name, - reason='Expected parameters:\n%s,\nbut received:\n%s' % ( - pformat(expected_params), pformat(params))) - - def _should_not_stub(self, context): - # Do not include presign requests when processing stubbed client calls - # as a presign request will never have an HTTP request sent over the - # wire for it and therefore not receive a response back. - if context and context.get('is_presign_request'): - return True - - def _validate_response(self, operation_name, service_response): - service_model = self.client.meta.service_model - operation_model = service_model.operation_model(operation_name) - output_shape = operation_model.output_shape - - # Remove ResponseMetadata so that the validator doesn't attempt to - # perform validation on it. - response = service_response - if 'ResponseMetadata' in response: - response = copy.copy(service_response) - del response['ResponseMetadata'] - - if output_shape is not None: - validate_parameters(response, output_shape) - elif response: - # If the output shape is None, that means the response should be - # empty apart from ResponseMetadata - raise ParamValidationError( - report=( - "Service response should only contain ResponseMetadata.")) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/translate.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/translate.py deleted file mode 100644 index 5a661ab0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/translate.py +++ /dev/null @@ -1,76 +0,0 @@ -# Copyright (c) 2012-2013 Mitch Garnaat http://garnaat.org/ -# Copyright 2012-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import copy - -from botocore.utils import merge_dicts - - -def build_retry_config(endpoint_prefix, retry_model, definitions, - client_retry_config=None): - service_config = retry_model.get(endpoint_prefix, {}) - resolve_references(service_config, definitions) - # We want to merge the global defaults with the service specific - # defaults, with the service specific defaults taking precedence. - # So we use the global defaults as the base. - # - # A deepcopy is done on the retry defaults because it ensures the - # retry model has no chance of getting mutated when the service specific - # configuration or client retry config is merged in. - final_retry_config = { - '__default__': copy.deepcopy(retry_model.get('__default__', {})) - } - resolve_references(final_retry_config, definitions) - # The merge the service specific config on top. - merge_dicts(final_retry_config, service_config) - if client_retry_config is not None: - _merge_client_retry_config(final_retry_config, client_retry_config) - return final_retry_config - - -def _merge_client_retry_config(retry_config, client_retry_config): - max_retry_attempts_override = client_retry_config.get('max_attempts') - if max_retry_attempts_override is not None: - # In the retry config, the max_attempts refers to the maximum number - # of requests in general will be made. However, for the client's - # retry config it refers to how many retry attempts will be made at - # most. So to translate this number from the client config, one is - # added to convert it to the maximum number request that will be made - # by including the initial request. - # - # It is also important to note that if we ever support per operation - # configuration in the retry model via the client, we will need to - # revisit this logic to make sure max_attempts gets applied - # per operation. - retry_config['__default__'][ - 'max_attempts'] = max_retry_attempts_override + 1 - - -def resolve_references(config, definitions): - """Recursively replace $ref keys. - - To cut down on duplication, common definitions can be declared - (and passed in via the ``definitions`` attribute) and then - references as {"$ref": "name"}, when this happens the reference - dict is placed with the value from the ``definition`` dict. - - This is recursively done. - - """ - for key, value in config.items(): - if isinstance(value, dict): - if len(value) == 1 and list(value.keys())[0] == '$ref': - # Then we need to resolve this reference. - config[key] = definitions[list(value.values())[0]] - else: - resolve_references(value, definitions) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/utils.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/utils.py deleted file mode 100644 index 48b1b451..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/utils.py +++ /dev/null @@ -1,1114 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import re -import time -import logging -import datetime -import hashlib -import binascii -import functools -import weakref -import random -import os - -import dateutil.parser -from dateutil.tz import tzlocal, tzutc - -import botocore -from botocore.exceptions import InvalidExpressionError, ConfigNotFound -from botocore.exceptions import InvalidDNSNameError, ClientError -from botocore.exceptions import MetadataRetrievalError -from botocore.compat import json, quote, zip_longest, urlsplit, urlunsplit -from botocore.vendored import requests -from botocore.compat import OrderedDict, six - - -logger = logging.getLogger(__name__) -DEFAULT_METADATA_SERVICE_TIMEOUT = 1 -METADATA_SECURITY_CREDENTIALS_URL = ( - 'http://169.254.169.254/latest/meta-data/iam/security-credentials/' -) -# These are chars that do not need to be urlencoded. -# Based on rfc2986, section 2.3 -SAFE_CHARS = '-._~' -LABEL_RE = re.compile(r'[a-z0-9][a-z0-9\-]*[a-z0-9]') -RETRYABLE_HTTP_ERRORS = (requests.Timeout, requests.ConnectionError) -S3_ACCELERATE_WHITELIST = ['dualstack'] - - -class _RetriesExceededError(Exception): - """Internal exception used when the number of retries are exceeded.""" - pass - - -def is_json_value_header(shape): - """Determines if the provided shape is the special header type jsonvalue. - - :type shape: botocore.shape - :param shape: Shape to be inspected for the jsonvalue trait. - - :return: True if this type is a jsonvalue, False otherwise - :rtype: Bool - """ - return (hasattr(shape, 'serialization') and - shape.serialization.get('jsonvalue', False) and - shape.serialization.get('location') == 'header' and - shape.type_name == 'string') - - -def get_service_module_name(service_model): - """Returns the module name for a service - - This is the value used in both the documentation and client class name - """ - name = service_model.metadata.get( - 'serviceAbbreviation', - service_model.metadata.get( - 'serviceFullName', service_model.service_name)) - name = name.replace('Amazon', '') - name = name.replace('AWS', '') - name = re.sub(r'\W+', '', name) - return name - - -def normalize_url_path(path): - if not path: - return '/' - return remove_dot_segments(path) - - -def remove_dot_segments(url): - # RFC 3986, section 5.2.4 "Remove Dot Segments" - # Also, AWS services require consecutive slashes to be removed, - # so that's done here as well - if not url: - return '' - input_url = url.split('/') - output_list = [] - for x in input_url: - if x and x != '.': - if x == '..': - if output_list: - output_list.pop() - else: - output_list.append(x) - - if url[0] == '/': - first = '/' - else: - first = '' - if url[-1] == '/' and output_list: - last = '/' - else: - last = '' - return first + '/'.join(output_list) + last - - -def validate_jmespath_for_set(expression): - # Validates a limited jmespath expression to determine if we can set a - # value based on it. Only works with dotted paths. - if not expression or expression == '.': - raise InvalidExpressionError(expression=expression) - - for invalid in ['[', ']', '*']: - if invalid in expression: - raise InvalidExpressionError(expression=expression) - - -def set_value_from_jmespath(source, expression, value, is_first=True): - # This takes a (limited) jmespath-like expression & can set a value based - # on it. - # Limitations: - # * Only handles dotted lookups - # * No offsets/wildcards/slices/etc. - if is_first: - validate_jmespath_for_set(expression) - - bits = expression.split('.', 1) - current_key, remainder = bits[0], bits[1] if len(bits) > 1 else '' - - if not current_key: - raise InvalidExpressionError(expression=expression) - - if remainder: - if current_key not in source: - # We've got something in the expression that's not present in the - # source (new key). If there's any more bits, we'll set the key - # with an empty dictionary. - source[current_key] = {} - - return set_value_from_jmespath( - source[current_key], - remainder, - value, - is_first=False - ) - - # If we're down to a single key, set it. - source[current_key] = value - - -class InstanceMetadataFetcher(object): - def __init__(self, timeout=DEFAULT_METADATA_SERVICE_TIMEOUT, - num_attempts=1, url=METADATA_SECURITY_CREDENTIALS_URL, - env=None, user_agent=None): - self._timeout = timeout - self._num_attempts = num_attempts - self._url = url - if env is None: - env = os.environ.copy() - self._disabled = env.get('AWS_EC2_METADATA_DISABLED', 'false').lower() - self._disabled = self._disabled == 'true' - self._user_agent = user_agent - - def _get_request(self, url, timeout, num_attempts=1): - if self._disabled: - logger.debug("Access to EC2 metadata has been disabled.") - raise _RetriesExceededError() - - headers = {} - if self._user_agent is not None: - headers['User-Agent'] = self._user_agent - - for i in range(num_attempts): - try: - response = requests.get(url, timeout=timeout, headers=headers) - except RETRYABLE_HTTP_ERRORS as e: - logger.debug("Caught exception while trying to retrieve " - "credentials: %s", e, exc_info=True) - else: - if response.status_code == 200: - return response - raise _RetriesExceededError() - - def retrieve_iam_role_credentials(self): - data = {} - url = self._url - timeout = self._timeout - num_attempts = self._num_attempts - try: - r = self._get_request(url, timeout, num_attempts) - if r.content: - fields = r.content.decode('utf-8').split('\n') - for field in fields: - if field.endswith('/'): - data[field[0:-1]] = self.retrieve_iam_role_credentials( - url + field, timeout, num_attempts) - else: - val = self._get_request( - url + field, - timeout=timeout, - num_attempts=num_attempts, - ).content.decode('utf-8') - if val[0] == '{': - val = json.loads(val) - data[field] = val - else: - logger.debug("Metadata service returned non 200 status code " - "of %s for url: %s, content body: %s", - r.status_code, url, r.content) - except _RetriesExceededError: - logger.debug("Max number of attempts exceeded (%s) when " - "attempting to retrieve data from metadata service.", - num_attempts) - # We sort for stable ordering. In practice, this should only consist - # of one role, but may need revisiting if this expands in the future. - final_data = {} - for role_name in sorted(data): - final_data = { - 'role_name': role_name, - 'access_key': data[role_name]['AccessKeyId'], - 'secret_key': data[role_name]['SecretAccessKey'], - 'token': data[role_name]['Token'], - 'expiry_time': data[role_name]['Expiration'], - } - return final_data - - -def merge_dicts(dict1, dict2, append_lists=False): - """Given two dict, merge the second dict into the first. - - The dicts can have arbitrary nesting. - - :param append_lists: If true, instead of clobbering a list with the new - value, append all of the new values onto the original list. - """ - for key in dict2: - if isinstance(dict2[key], dict): - if key in dict1 and key in dict2: - merge_dicts(dict1[key], dict2[key]) - else: - dict1[key] = dict2[key] - # If the value is a list and the ``append_lists`` flag is set, - # append the new values onto the original list - elif isinstance(dict2[key], list) and append_lists: - # The value in dict1 must be a list in order to append new - # values onto it. - if key in dict1 and isinstance(dict1[key], list): - dict1[key].extend(dict2[key]) - else: - dict1[key] = dict2[key] - else: - # At scalar types, we iterate and merge the - # current dict that we're on. - dict1[key] = dict2[key] - - -def parse_key_val_file(filename, _open=open): - try: - with _open(filename) as f: - contents = f.read() - return parse_key_val_file_contents(contents) - except OSError: - raise ConfigNotFound(path=filename) - - -def parse_key_val_file_contents(contents): - # This was originally extracted from the EC2 credential provider, which was - # fairly lenient in its parsing. We only try to parse key/val pairs if - # there's a '=' in the line. - final = {} - for line in contents.splitlines(): - if '=' not in line: - continue - key, val = line.split('=', 1) - key = key.strip() - val = val.strip() - final[key] = val - return final - - -def percent_encode_sequence(mapping, safe=SAFE_CHARS): - """Urlencode a dict or list into a string. - - This is similar to urllib.urlencode except that: - - * It uses quote, and not quote_plus - * It has a default list of safe chars that don't need - to be encoded, which matches what AWS services expect. - - If any value in the input ``mapping`` is a list type, - then each list element wil be serialized. This is the equivalent - to ``urlencode``'s ``doseq=True`` argument. - - This function should be preferred over the stdlib - ``urlencode()`` function. - - :param mapping: Either a dict to urlencode or a list of - ``(key, value)`` pairs. - - """ - encoded_pairs = [] - if hasattr(mapping, 'items'): - pairs = mapping.items() - else: - pairs = mapping - for key, value in pairs: - if isinstance(value, list): - for element in value: - encoded_pairs.append('%s=%s' % (percent_encode(key), - percent_encode(element))) - else: - encoded_pairs.append('%s=%s' % (percent_encode(key), - percent_encode(value))) - return '&'.join(encoded_pairs) - - -def percent_encode(input_str, safe=SAFE_CHARS): - """Urlencodes a string. - - Whereas percent_encode_sequence handles taking a dict/sequence and - producing a percent encoded string, this function deals only with - taking a string (not a dict/sequence) and percent encoding it. - - If given the binary type, will simply URL encode it. If given the - text type, will produce the binary type by UTF-8 encoding the - text. If given something else, will convert it to the text type - first. - """ - # If its not a binary or text string, make it a text string. - if not isinstance(input_str, (six.binary_type, six.text_type)): - input_str = six.text_type(input_str) - # If it's not bytes, make it bytes by UTF-8 encoding it. - if not isinstance(input_str, six.binary_type): - input_str = input_str.encode('utf-8') - return quote(input_str, safe=safe) - - -def parse_timestamp(value): - """Parse a timestamp into a datetime object. - - Supported formats: - - * iso8601 - * rfc822 - * epoch (value is an integer) - - This will return a ``datetime.datetime`` object. - - """ - if isinstance(value, (int, float)): - # Possibly an epoch time. - return datetime.datetime.fromtimestamp(value, tzlocal()) - else: - try: - return datetime.datetime.fromtimestamp(float(value), tzlocal()) - except (TypeError, ValueError): - pass - try: - # In certain cases, a timestamp marked with GMT can be parsed into a - # different time zone, so here we provide a context which will - # enforce that GMT == UTC. - return dateutil.parser.parse(value, tzinfos={'GMT': tzutc()}) - except (TypeError, ValueError) as e: - raise ValueError('Invalid timestamp "%s": %s' % (value, e)) - - -def parse_to_aware_datetime(value): - """Converted the passed in value to a datetime object with tzinfo. - - This function can be used to normalize all timestamp inputs. This - function accepts a number of different types of inputs, but - will always return a datetime.datetime object with time zone - information. - - The input param ``value`` can be one of several types: - - * A datetime object (both naive and aware) - * An integer representing the epoch time (can also be a string - of the integer, i.e '0', instead of 0). The epoch time is - considered to be UTC. - * An iso8601 formatted timestamp. This does not need to be - a complete timestamp, it can contain just the date portion - without the time component. - - The returned value will be a datetime object that will have tzinfo. - If no timezone info was provided in the input value, then UTC is - assumed, not local time. - - """ - # This is a general purpose method that handles several cases of - # converting the provided value to a string timestamp suitable to be - # serialized to an http request. It can handle: - # 1) A datetime.datetime object. - if isinstance(value, datetime.datetime): - datetime_obj = value - else: - # 2) A string object that's formatted as a timestamp. - # We document this as being an iso8601 timestamp, although - # parse_timestamp is a bit more flexible. - datetime_obj = parse_timestamp(value) - if datetime_obj.tzinfo is None: - # I think a case would be made that if no time zone is provided, - # we should use the local time. However, to restore backwards - # compat, the previous behavior was to assume UTC, which is - # what we're going to do here. - datetime_obj = datetime_obj.replace(tzinfo=tzutc()) - else: - datetime_obj = datetime_obj.astimezone(tzutc()) - return datetime_obj - - -def datetime2timestamp(dt, default_timezone=None): - """Calculate the timestamp based on the given datetime instance. - - :type dt: datetime - :param dt: A datetime object to be converted into timestamp - :type default_timezone: tzinfo - :param default_timezone: If it is provided as None, we treat it as tzutc(). - But it is only used when dt is a naive datetime. - :returns: The timestamp - """ - epoch = datetime.datetime(1970, 1, 1) - if dt.tzinfo is None: - if default_timezone is None: - default_timezone = tzutc() - dt = dt.replace(tzinfo=default_timezone) - d = dt.replace(tzinfo=None) - dt.utcoffset() - epoch - if hasattr(d, "total_seconds"): - return d.total_seconds() # Works in Python 2.7+ - return (d.microseconds + (d.seconds + d.days * 24 * 3600) * 10**6) / 10**6 - - -def calculate_sha256(body, as_hex=False): - """Calculate a sha256 checksum. - - This method will calculate the sha256 checksum of a file like - object. Note that this method will iterate through the entire - file contents. The caller is responsible for ensuring the proper - starting position of the file and ``seek()``'ing the file back - to its starting location if other consumers need to read from - the file like object. - - :param body: Any file like object. The file must be opened - in binary mode such that a ``.read()`` call returns bytes. - :param as_hex: If True, then the hex digest is returned. - If False, then the digest (as binary bytes) is returned. - - :returns: The sha256 checksum - - """ - checksum = hashlib.sha256() - for chunk in iter(lambda: body.read(1024 * 1024), b''): - checksum.update(chunk) - if as_hex: - return checksum.hexdigest() - else: - return checksum.digest() - - -def calculate_tree_hash(body): - """Calculate a tree hash checksum. - - For more information see: - - http://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html - - :param body: Any file like object. This has the same constraints as - the ``body`` param in calculate_sha256 - - :rtype: str - :returns: The hex version of the calculated tree hash - - """ - chunks = [] - required_chunk_size = 1024 * 1024 - sha256 = hashlib.sha256 - for chunk in iter(lambda: body.read(required_chunk_size), b''): - chunks.append(sha256(chunk).digest()) - if not chunks: - return sha256(b'').hexdigest() - while len(chunks) > 1: - new_chunks = [] - for first, second in _in_pairs(chunks): - if second is not None: - new_chunks.append(sha256(first + second).digest()) - else: - # We're at the end of the list and there's no pair left. - new_chunks.append(first) - chunks = new_chunks - return binascii.hexlify(chunks[0]).decode('ascii') - - -def _in_pairs(iterable): - # Creates iterator that iterates over the list in pairs: - # for a, b in _in_pairs([0, 1, 2, 3, 4]): - # print(a, b) - # - # will print: - # 0, 1 - # 2, 3 - # 4, None - shared_iter = iter(iterable) - # Note that zip_longest is a compat import that uses - # the itertools izip_longest. This creates an iterator, - # this call below does _not_ immediately create the list - # of pairs. - return zip_longest(shared_iter, shared_iter) - - -class CachedProperty(object): - """A read only property that caches the initially computed value. - - This descriptor will only call the provided ``fget`` function once. - Subsequent access to this property will return the cached value. - - """ - - def __init__(self, fget): - self._fget = fget - - def __get__(self, obj, cls): - if obj is None: - return self - else: - computed_value = self._fget(obj) - obj.__dict__[self._fget.__name__] = computed_value - return computed_value - - -class ArgumentGenerator(object): - """Generate sample input based on a shape model. - - This class contains a ``generate_skeleton`` method that will take - an input/output shape (created from ``botocore.model``) and generate - a sample dictionary corresponding to the input/output shape. - - The specific values used are place holder values. For strings either an - empty string or the member name can be used, for numbers 0 or 0.0 is used. - The intended usage of this class is to generate the *shape* of the input - structure. - - This can be useful for operations that have complex input shapes. - This allows a user to just fill in the necessary data instead of - worrying about the specific structure of the input arguments. - - Example usage:: - - s = botocore.session.get_session() - ddb = s.get_service_model('dynamodb') - arg_gen = ArgumentGenerator() - sample_input = arg_gen.generate_skeleton( - ddb.operation_model('CreateTable').input_shape) - print("Sample input for dynamodb.CreateTable: %s" % sample_input) - - """ - def __init__(self, use_member_names=False): - self._use_member_names = use_member_names - - def generate_skeleton(self, shape): - """Generate a sample input. - - :type shape: ``botocore.model.Shape`` - :param shape: The input shape. - - :return: The generated skeleton input corresponding to the - provided input shape. - - """ - stack = [] - return self._generate_skeleton(shape, stack) - - def _generate_skeleton(self, shape, stack, name=''): - stack.append(shape.name) - try: - if shape.type_name == 'structure': - return self._generate_type_structure(shape, stack) - elif shape.type_name == 'list': - return self._generate_type_list(shape, stack) - elif shape.type_name == 'map': - return self._generate_type_map(shape, stack) - elif shape.type_name == 'string': - if self._use_member_names: - return name - if shape.enum: - return random.choice(shape.enum) - return '' - elif shape.type_name in ['integer', 'long']: - return 0 - elif shape.type_name == 'float': - return 0.0 - elif shape.type_name == 'boolean': - return True - elif shape.type_name == 'timestamp': - return datetime.datetime(1970, 1, 1, 0, 0, 0) - finally: - stack.pop() - - def _generate_type_structure(self, shape, stack): - if stack.count(shape.name) > 1: - return {} - skeleton = OrderedDict() - for member_name, member_shape in shape.members.items(): - skeleton[member_name] = self._generate_skeleton( - member_shape, stack, name=member_name) - return skeleton - - def _generate_type_list(self, shape, stack): - # For list elements we've arbitrarily decided to - # return two elements for the skeleton list. - name = '' - if self._use_member_names: - name = shape.member.name - return [ - self._generate_skeleton(shape.member, stack, name), - ] - - def _generate_type_map(self, shape, stack): - key_shape = shape.key - value_shape = shape.value - assert key_shape.type_name == 'string' - return OrderedDict([ - ('KeyName', self._generate_skeleton(value_shape, stack)), - ]) - - -def is_valid_endpoint_url(endpoint_url): - """Verify the endpoint_url is valid. - - :type endpoint_url: string - :param endpoint_url: An endpoint_url. Must have at least a scheme - and a hostname. - - :return: True if the endpoint url is valid. False otherwise. - - """ - parts = urlsplit(endpoint_url) - hostname = parts.hostname - if hostname is None: - return False - if len(hostname) > 255: - return False - if hostname[-1] == ".": - hostname = hostname[:-1] - allowed = re.compile( - r"^((?!-)[A-Z\d-]{1,63}(? 63: - # Wrong length - return False - if n == 1: - if not bucket_name.isalnum(): - return False - match = LABEL_RE.match(bucket_name) - if match is None or match.end() != len(bucket_name): - return False - return True - - -def fix_s3_host(request, signature_version, region_name, - default_endpoint_url=None, **kwargs): - """ - This handler looks at S3 requests just before they are signed. - If there is a bucket name on the path (true for everything except - ListAllBuckets) it checks to see if that bucket name conforms to - the DNS naming conventions. If it does, it alters the request to - use ``virtual hosting`` style addressing rather than ``path-style`` - addressing. - - """ - if request.context.get('use_global_endpoint', False): - default_endpoint_url = 's3.amazonaws.com' - try: - switch_to_virtual_host_style( - request, signature_version, default_endpoint_url) - except InvalidDNSNameError as e: - bucket_name = e.kwargs['bucket_name'] - logger.debug('Not changing URI, bucket is not DNS compatible: %s', - bucket_name) - - -def switch_to_virtual_host_style(request, signature_version, - default_endpoint_url=None, **kwargs): - """ - This is a handler to force virtual host style s3 addressing no matter - the signature version (which is taken in consideration for the default - case). If the bucket is not DNS compatible an InvalidDNSName is thrown. - - :param request: A AWSRequest object that is about to be sent. - :param signature_version: The signature version to sign with - :param default_endpoint_url: The endpoint to use when switching to a - virtual style. If None is supplied, the virtual host will be - constructed from the url of the request. - """ - if request.auth_path is not None: - # The auth_path has already been applied (this may be a - # retried request). We don't need to perform this - # customization again. - return - elif _is_get_bucket_location_request(request): - # For the GetBucketLocation response, we should not be using - # the virtual host style addressing so we can avoid any sigv4 - # issues. - logger.debug("Request is GetBucketLocation operation, not checking " - "for DNS compatibility.") - return - parts = urlsplit(request.url) - request.auth_path = parts.path - path_parts = parts.path.split('/') - - # Retrieve what the endpoint we will be prepending the bucket name to. - if default_endpoint_url is None: - default_endpoint_url = parts.netloc - - if len(path_parts) > 1: - bucket_name = path_parts[1] - if not bucket_name: - # If the bucket name is empty we should not be checking for - # dns compatibility. - return - logger.debug('Checking for DNS compatible bucket for: %s', - request.url) - if check_dns_name(bucket_name): - # If the operation is on a bucket, the auth_path must be - # terminated with a '/' character. - if len(path_parts) == 2: - if request.auth_path[-1] != '/': - request.auth_path += '/' - path_parts.remove(bucket_name) - # At the very least the path must be a '/', such as with the - # CreateBucket operation when DNS style is being used. If this - # is not used you will get an empty path which is incorrect. - path = '/'.join(path_parts) or '/' - global_endpoint = default_endpoint_url - host = bucket_name + '.' + global_endpoint - new_tuple = (parts.scheme, host, path, - parts.query, '') - new_uri = urlunsplit(new_tuple) - request.url = new_uri - logger.debug('URI updated to: %s', new_uri) - else: - raise InvalidDNSNameError(bucket_name=bucket_name) - - -def _is_get_bucket_location_request(request): - return request.url.endswith('?location') - - -def instance_cache(func): - """Method decorator for caching method calls to a single instance. - - **This is not a general purpose caching decorator.** - - In order to use this, you *must* provide an ``_instance_cache`` - attribute on the instance. - - This decorator is used to cache method calls. The cache is only - scoped to a single instance though such that multiple instances - will maintain their own cache. In order to keep things simple, - this decorator requires that you provide an ``_instance_cache`` - attribute on your instance. - - """ - func_name = func.__name__ - - @functools.wraps(func) - def _cache_guard(self, *args, **kwargs): - cache_key = (func_name, args) - if kwargs: - kwarg_items = tuple(sorted(kwargs.items())) - cache_key = (func_name, args, kwarg_items) - result = self._instance_cache.get(cache_key) - if result is not None: - return result - result = func(self, *args, **kwargs) - self._instance_cache[cache_key] = result - return result - return _cache_guard - - -def switch_host_s3_accelerate(request, operation_name, **kwargs): - """Switches the current s3 endpoint with an S3 Accelerate endpoint""" - - # Note that when registered the switching of the s3 host happens - # before it gets changed to virtual. So we are not concerned with ensuring - # that the bucket name is translated to the virtual style here and we - # can hard code the Accelerate endpoint. - parts = urlsplit(request.url).netloc.split('.') - parts = [p for p in parts if p in S3_ACCELERATE_WHITELIST] - endpoint = 'https://s3-accelerate.' - if len(parts) > 0: - endpoint += '.'.join(parts) + '.' - endpoint += 'amazonaws.com' - - if operation_name in ['ListBuckets', 'CreateBucket', 'DeleteBucket']: - return - _switch_hosts(request, endpoint, use_new_scheme=False) - - -def switch_host_with_param(request, param_name): - """Switches the host using a parameter value from a JSON request body""" - request_json = json.loads(request.data.decode('utf-8')) - if request_json.get(param_name): - new_endpoint = request_json[param_name] - _switch_hosts(request, new_endpoint) - - -def _switch_hosts(request, new_endpoint, use_new_scheme=True): - final_endpoint = _get_new_endpoint( - request.url, new_endpoint, use_new_scheme) - request.url = final_endpoint - - -def _get_new_endpoint(original_endpoint, new_endpoint, use_new_scheme=True): - new_endpoint_components = urlsplit(new_endpoint) - original_endpoint_components = urlsplit(original_endpoint) - scheme = original_endpoint_components.scheme - if use_new_scheme: - scheme = new_endpoint_components.scheme - final_endpoint_components = ( - scheme, - new_endpoint_components.netloc, - original_endpoint_components.path, - original_endpoint_components.query, - '' - ) - final_endpoint = urlunsplit(final_endpoint_components) - logger.debug('Updating URI from %s to %s' % ( - original_endpoint, final_endpoint)) - return final_endpoint - - -def deep_merge(base, extra): - """Deeply two dictionaries, overriding existing keys in the base. - - :param base: The base dictionary which will be merged into. - :param extra: The dictionary to merge into the base. Keys from this - dictionary will take precedence. - """ - for key in extra: - # If the key represents a dict on both given dicts, merge the sub-dicts - if key in base and isinstance(base[key], dict)\ - and isinstance(extra[key], dict): - deep_merge(base[key], extra[key]) - continue - - # Otherwise, set the key on the base to be the value of the extra. - base[key] = extra[key] - - -class S3RegionRedirector(object): - def __init__(self, endpoint_bridge, client, cache=None): - self._endpoint_resolver = endpoint_bridge - self._cache = cache - if self._cache is None: - self._cache = {} - - # This needs to be a weak ref in order to prevent memory leaks on - # python 2.6 - self._client = weakref.proxy(client) - - def register(self, event_emitter=None): - emitter = event_emitter or self._client.meta.events - emitter.register('needs-retry.s3', self.redirect_from_error) - emitter.register('before-call.s3', self.set_request_url) - emitter.register('before-parameter-build.s3', - self.redirect_from_cache) - - def redirect_from_error(self, request_dict, response, operation, **kwargs): - """ - An S3 request sent to the wrong region will return an error that - contains the endpoint the request should be sent to. This handler - will add the redirect information to the signing context and then - redirect the request. - """ - if response is None: - # This could be none if there was a ConnectionError or other - # transport error. - return - - if request_dict.get('context', {}).get('s3_redirected'): - logger.debug( - 'S3 request was previously redirected, not redirecting.') - return - - error = response[1].get('Error', {}) - error_code = error.get('Code') - response_metadata = response[1].get('ResponseMetadata', {}) - - # We have to account for 400 responses because - # if we sign a Head* request with the wrong region, - # we'll get a 400 Bad Request but we won't get a - # body saying it's an "AuthorizationHeaderMalformed". - is_special_head_object = ( - error_code in ['301', '400'] and - operation.name == 'HeadObject' - ) - is_special_head_bucket = ( - error_code in ['301', '400'] and - operation.name == 'HeadBucket' and - 'x-amz-bucket-region' in response_metadata.get('HTTPHeaders', {}) - ) - is_wrong_signing_region = ( - error_code == 'AuthorizationHeaderMalformed' and - 'Region' in error - ) - is_permanent_redirect = error_code == 'PermanentRedirect' - if not any([is_special_head_object, is_wrong_signing_region, - is_permanent_redirect, is_special_head_bucket]): - return - - bucket = request_dict['context']['signing']['bucket'] - client_region = request_dict['context'].get('client_region') - new_region = self.get_bucket_region(bucket, response) - - if new_region is None: - logger.debug( - "S3 client configured for region %s but the bucket %s is not " - "in that region and the proper region could not be " - "automatically determined." % (client_region, bucket)) - return - - logger.debug( - "S3 client configured for region %s but the bucket %s is in region" - " %s; Please configure the proper region to avoid multiple " - "unnecessary redirects and signing attempts." % ( - client_region, bucket, new_region)) - endpoint = self._endpoint_resolver.resolve('s3', new_region) - endpoint = endpoint['endpoint_url'] - - signing_context = { - 'region': new_region, - 'bucket': bucket, - 'endpoint': endpoint - } - request_dict['context']['signing'] = signing_context - - self._cache[bucket] = signing_context - self.set_request_url(request_dict, request_dict['context']) - - request_dict['context']['s3_redirected'] = True - - # Return 0 so it doesn't wait to retry - return 0 - - def get_bucket_region(self, bucket, response): - """ - There are multiple potential sources for the new region to redirect to, - but they aren't all universally available for use. This will try to - find region from response elements, but will fall back to calling - HEAD on the bucket if all else fails. - - :param bucket: The bucket to find the region for. This is necessary if - the region is not available in the error response. - :param response: A response representing a service request that failed - due to incorrect region configuration. - """ - # First try to source the region from the headers. - service_response = response[1] - response_headers = service_response['ResponseMetadata']['HTTPHeaders'] - if 'x-amz-bucket-region' in response_headers: - return response_headers['x-amz-bucket-region'] - - # Next, check the error body - region = service_response.get('Error', {}).get('Region', None) - if region is not None: - return region - - # Finally, HEAD the bucket. No other choice sadly. - try: - response = self._client.head_bucket(Bucket=bucket) - headers = response['ResponseMetadata']['HTTPHeaders'] - except ClientError as e: - headers = e.response['ResponseMetadata']['HTTPHeaders'] - - region = headers.get('x-amz-bucket-region', None) - return region - - def set_request_url(self, params, context, **kwargs): - endpoint = context.get('signing', {}).get('endpoint', None) - if endpoint is not None: - params['url'] = _get_new_endpoint(params['url'], endpoint, False) - - def redirect_from_cache(self, params, context, **kwargs): - """ - This handler retrieves a given bucket's signing context from the cache - and adds it into the request context. - """ - bucket = params.get('Bucket') - signing_context = self._cache.get(bucket) - if signing_context is not None: - context['signing'] = signing_context - else: - context['signing'] = {'bucket': bucket} - - -class ContainerMetadataFetcher(object): - - TIMEOUT_SECONDS = 2 - RETRY_ATTEMPTS = 3 - SLEEP_TIME = 1 - IP_ADDRESS = '169.254.170.2' - _ALLOWED_HOSTS = [IP_ADDRESS, 'localhost', '127.0.0.1'] - - def __init__(self, session=None, sleep=time.sleep): - if session is None: - session = requests.Session() - session.trust_env = False - session.proxies = {} - self._session = session - self._sleep = sleep - - def retrieve_full_uri(self, full_url, headers=None): - """Retrieve JSON metadata from container metadata. - - :type full_url: str - :param full_url: The full URL of the metadata service. - This should include the scheme as well, e.g - "http://localhost:123/foo" - - """ - self._validate_allowed_url(full_url) - return self._retrieve_credentials(full_url, headers) - - def _validate_allowed_url(self, full_url): - parsed = botocore.compat.urlparse(full_url) - is_whitelisted_host = self._check_if_whitelisted_host( - parsed.hostname) - if not is_whitelisted_host: - raise ValueError( - "Unsupported host '%s'. Can only " - "retrieve metadata from these hosts: %s" % - (parsed.hostname, ', '.join(self._ALLOWED_HOSTS))) - - def _check_if_whitelisted_host(self, host): - if host in self._ALLOWED_HOSTS: - return True - return False - - def retrieve_uri(self, relative_uri): - """Retrieve JSON metadata from ECS metadata. - - :type relative_uri: str - :param relative_uri: A relative URI, e.g "/foo/bar?id=123" - - :return: The parsed JSON response. - - """ - full_url = self.full_url(relative_uri) - return self._retrieve_credentials(full_url) - - def _retrieve_credentials(self, full_url, extra_headers=None): - headers = {'Accept': 'application/json'} - if extra_headers is not None: - headers.update(extra_headers) - attempts = 0 - while True: - try: - return self._get_response(full_url, headers, self.TIMEOUT_SECONDS) - except MetadataRetrievalError as e: - logger.debug("Received error when attempting to retrieve " - "container metadata: %s", e, exc_info=True) - self._sleep(self.SLEEP_TIME) - attempts += 1 - if attempts >= self.RETRY_ATTEMPTS: - raise - - def _get_response(self, full_url, headers, timeout): - try: - response = self._session.get(full_url, headers=headers, - timeout=timeout) - if response.status_code != 200: - raise MetadataRetrievalError( - error_msg="Received non 200 response (%s) from ECS metadata: %s" - % (response.status_code, response.text)) - try: - return json.loads(response.text) - except ValueError: - raise MetadataRetrievalError( - error_msg=("Unable to parse JSON returned from " - "ECS metadata: %s" % response.text)) - except RETRYABLE_HTTP_ERRORS as e: - error_msg = ("Received error when attempting to retrieve " - "ECS metadata: %s" % e) - raise MetadataRetrievalError(error_msg=error_msg) - - def full_url(self, relative_uri): - return 'http://%s%s' % (self.IP_ADDRESS, relative_uri) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/validate.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/validate.py deleted file mode 100644 index c52881fa..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/validate.py +++ /dev/null @@ -1,293 +0,0 @@ -"""User input parameter validation. - -This module handles user input parameter validation -against a provided input model. - -Note that the objects in this module do *not* mutate any -arguments. No type version happens here. It is up to another -layer to properly convert arguments to any required types. - -Validation Errors ------------------ - - -""" - -from botocore.compat import six -import decimal -import json -from datetime import datetime - -from botocore.utils import parse_to_aware_datetime -from botocore.utils import is_json_value_header -from botocore.exceptions import ParamValidationError - - -def validate_parameters(params, shape): - """Validates input parameters against a schema. - - This is a convenience function that validates parameters against a schema. - You can also instantiate and use the ParamValidator class directly if you - want more control. - - If there are any validation errors then a ParamValidationError - will be raised. If there are no validation errors than no exception - is raised and a value of None is returned. - - :param params: The user provided input parameters. - - :type shape: botocore.model.Shape - :param shape: The schema which the input parameters should - adhere to. - - :raise: ParamValidationError - - """ - validator = ParamValidator() - report = validator.validate(params, shape) - if report.has_errors(): - raise ParamValidationError(report=report.generate_report()) - - -def type_check(valid_types): - def _create_type_check_guard(func): - def _on_passes_type_check(self, param, shape, errors, name): - if _type_check(param, errors, name): - return func(self, param, shape, errors, name) - - def _type_check(param, errors, name): - if not isinstance(param, valid_types): - valid_type_names = [six.text_type(t) for t in valid_types] - errors.report(name, 'invalid type', param=param, - valid_types=valid_type_names) - return False - return True - - return _on_passes_type_check - return _create_type_check_guard - - -def range_check(name, value, shape, error_type, errors): - failed = False - min_allowed = float('-inf') - max_allowed = float('inf') - if 'min' in shape.metadata: - min_allowed = shape.metadata['min'] - if value < min_allowed: - failed = True - if failed: - errors.report(name, error_type, param=value, - valid_range=[min_allowed, max_allowed]) - - -class ValidationErrors(object): - def __init__(self): - self._errors = [] - - def has_errors(self): - if self._errors: - return True - return False - - def generate_report(self): - error_messages = [] - for error in self._errors: - error_messages.append(self._format_error(error)) - return '\n'.join(error_messages) - - def _format_error(self, error): - error_type, name, additional = error - name = self._get_name(name) - if error_type == 'missing required field': - return 'Missing required parameter in %s: "%s"' % ( - name, additional['required_name']) - elif error_type == 'unknown field': - return 'Unknown parameter in %s: "%s", must be one of: %s' % ( - name, additional['unknown_param'], - ', '.join(additional['valid_names'])) - elif error_type == 'invalid type': - return 'Invalid type for parameter %s, value: %s, type: %s, ' \ - 'valid types: %s' % (name, additional['param'], - str(type(additional['param'])), - ', '.join(additional['valid_types'])) - elif error_type == 'invalid range': - min_allowed = additional['valid_range'][0] - max_allowed = additional['valid_range'][1] - return ('Invalid range for parameter %s, value: %s, valid range: ' - '%s-%s' % (name, additional['param'], - min_allowed, max_allowed)) - elif error_type == 'invalid length': - min_allowed = additional['valid_range'][0] - max_allowed = additional['valid_range'][1] - return ('Invalid length for parameter %s, value: %s, valid range: ' - '%s-%s' % (name, additional['param'], - min_allowed, max_allowed)) - elif error_type == 'unable to encode to json': - return 'Invalid parameter %s must be json serializable: %s' \ - % (name, additional['type_error']) - - def _get_name(self, name): - if not name: - return 'input' - elif name.startswith('.'): - return name[1:] - else: - return name - - def report(self, name, reason, **kwargs): - self._errors.append((reason, name, kwargs)) - - -class ParamValidator(object): - """Validates parameters against a shape model.""" - - def validate(self, params, shape): - """Validate parameters against a shape model. - - This method will validate the parameters against a provided shape model. - All errors will be collected before returning to the caller. This means - that this method will not stop at the first error, it will return all - possible errors. - - :param params: User provided dict of parameters - :param shape: A shape model describing the expected input. - - :return: A list of errors. - - """ - errors = ValidationErrors() - self._validate(params, shape, errors, name='') - return errors - - def _check_special_validation_cases(self, shape): - if is_json_value_header(shape): - return self._validate_jsonvalue_string - - def _validate(self, params, shape, errors, name): - special_validator = self._check_special_validation_cases(shape) - if special_validator: - special_validator(params, shape, errors, name) - else: - getattr(self, '_validate_%s' % shape.type_name)( - params, shape, errors, name) - - def _validate_jsonvalue_string(self, params, shape, errors, name): - # Check to see if a value marked as a jsonvalue can be dumped to - # a json string. - try: - json.dumps(params) - except (ValueError, TypeError) as e: - errors.report(name, 'unable to encode to json', type_error=e) - - @type_check(valid_types=(dict,)) - def _validate_structure(self, params, shape, errors, name): - # Validate required fields. - for required_member in shape.metadata.get('required', []): - if required_member not in params: - errors.report(name, 'missing required field', - required_name=required_member, user_params=params) - members = shape.members - known_params = [] - # Validate known params. - for param in params: - if param not in members: - errors.report(name, 'unknown field', unknown_param=param, - valid_names=list(members)) - else: - known_params.append(param) - # Validate structure members. - for param in known_params: - self._validate(params[param], shape.members[param], - errors, '%s.%s' % (name, param)) - - @type_check(valid_types=six.string_types) - def _validate_string(self, param, shape, errors, name): - # Validate range. For a string, the min/max contraints - # are of the string length. - # Looks like: - # "WorkflowId":{ - # "type":"string", - # "min":1, - # "max":256 - # } - range_check(name, len(param), shape, 'invalid length', errors) - - @type_check(valid_types=(list, tuple)) - def _validate_list(self, param, shape, errors, name): - member_shape = shape.member - range_check(name, len(param), shape, 'invalid length', errors) - for i, item in enumerate(param): - self._validate(item, member_shape, errors, '%s[%s]' % (name, i)) - - @type_check(valid_types=(dict,)) - def _validate_map(self, param, shape, errors, name): - key_shape = shape.key - value_shape = shape.value - for key, value in param.items(): - self._validate(key, key_shape, errors, "%s (key: %s)" - % (name, key)) - self._validate(value, value_shape, errors, '%s.%s' % (name, key)) - - @type_check(valid_types=six.integer_types) - def _validate_integer(self, param, shape, errors, name): - range_check(name, param, shape, 'invalid range', errors) - - def _validate_blob(self, param, shape, errors, name): - if isinstance(param, (bytes, bytearray, six.text_type)): - return - elif hasattr(param, 'read'): - # File like objects are also allowed for blob types. - return - else: - errors.report(name, 'invalid type', param=param, - valid_types=[str(bytes), str(bytearray), - 'file-like object']) - - @type_check(valid_types=(bool,)) - def _validate_boolean(self, param, shape, errors, name): - pass - - @type_check(valid_types=(float, decimal.Decimal) + six.integer_types) - def _validate_double(self, param, shape, errors, name): - range_check(name, param, shape, 'invalid range', errors) - - _validate_float = _validate_double - - @type_check(valid_types=six.integer_types) - def _validate_long(self, param, shape, errors, name): - range_check(name, param, shape, 'invalid range', errors) - - def _validate_timestamp(self, param, shape, errors, name): - # We don't use @type_check because datetimes are a bit - # more flexible. You can either provide a datetime - # object, or a string that parses to a datetime. - is_valid_type = self._type_check_datetime(param) - if not is_valid_type: - valid_type_names = [six.text_type(datetime), 'timestamp-string'] - errors.report(name, 'invalid type', param=param, - valid_types=valid_type_names) - - def _type_check_datetime(self, value): - try: - parse_to_aware_datetime(value) - return True - except (TypeError, ValueError, AttributeError): - # Yes, dateutil can sometimes raise an AttributeError - # when parsing timestamps. - return False - - -class ParamValidationDecorator(object): - def __init__(self, param_validator, serializer): - self._param_validator = param_validator - self._serializer = serializer - - def serialize_to_request(self, parameters, operation_model): - input_shape = operation_model.input_shape - if input_shape is not None: - report = self._param_validator.validate(parameters, - operation_model.input_shape) - if report.has_errors(): - raise ParamValidationError(report=report.generate_report()) - return self._serializer.serialize_to_request(parameters, - operation_model) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/__init__.py deleted file mode 100644 index e69de29b..00000000 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/__init__.py deleted file mode 100644 index 4bca66e7..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/__init__.py +++ /dev/null @@ -1,77 +0,0 @@ -# -*- coding: utf-8 -*- - -# __ -# /__) _ _ _ _ _/ _ -# / ( (- (/ (/ (- _) / _) -# / - -""" -requests HTTP library -~~~~~~~~~~~~~~~~~~~~~ - -Requests is an HTTP library, written in Python, for human beings. Basic GET -usage: - - >>> import requests - >>> r = requests.get('https://www.python.org') - >>> r.status_code - 200 - >>> 'Python is a programming language' in r.content - True - -... or POST: - - >>> payload = dict(key1='value1', key2='value2') - >>> r = requests.post('http://httpbin.org/post', data=payload) - >>> print(r.text) - { - ... - "form": { - "key2": "value2", - "key1": "value1" - }, - ... - } - -The other HTTP methods are supported - see `requests.api`. Full documentation -is at . - -:copyright: (c) 2015 by Kenneth Reitz. -:license: Apache 2.0, see LICENSE for more details. - -""" - -__title__ = 'requests' -__version__ = '2.7.0' -__build__ = 0x020700 -__author__ = 'Kenneth Reitz' -__license__ = 'Apache 2.0' -__copyright__ = 'Copyright 2015 Kenneth Reitz' - -# Attempt to enable urllib3's SNI support, if possible -try: - from .packages.urllib3.contrib import pyopenssl - pyopenssl.inject_into_urllib3() -except ImportError: - pass - -from . import utils -from .models import Request, Response, PreparedRequest -from .api import request, get, head, post, patch, put, delete, options -from .sessions import session, Session -from .status_codes import codes -from .exceptions import ( - RequestException, Timeout, URLRequired, - TooManyRedirects, HTTPError, ConnectionError -) - -# Set default logging handler to avoid "No handler found" warnings. -import logging -try: # Python 2.7+ - from logging import NullHandler -except ImportError: - class NullHandler(logging.Handler): - def emit(self, record): - pass - -logging.getLogger(__name__).addHandler(NullHandler()) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/adapters.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/adapters.py deleted file mode 100644 index 02e0dd1f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/adapters.py +++ /dev/null @@ -1,437 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.adapters -~~~~~~~~~~~~~~~~~ - -This module contains the transport adapters that Requests uses to define -and maintain connections. -""" - -import socket - -from .models import Response -from .packages.urllib3.poolmanager import PoolManager, proxy_from_url -from .packages.urllib3.response import HTTPResponse -from .packages.urllib3.util import Timeout as TimeoutSauce -from .packages.urllib3.util.retry import Retry -from .compat import urlparse, basestring -from .utils import (DEFAULT_CA_BUNDLE_PATH, get_encoding_from_headers, - prepend_scheme_if_needed, get_auth_from_url, urldefragauth) -from .structures import CaseInsensitiveDict -from .packages.urllib3.exceptions import ConnectTimeoutError -from .packages.urllib3.exceptions import HTTPError as _HTTPError -from .packages.urllib3.exceptions import MaxRetryError -from .packages.urllib3.exceptions import ProxyError as _ProxyError -from .packages.urllib3.exceptions import ProtocolError -from .packages.urllib3.exceptions import ReadTimeoutError -from .packages.urllib3.exceptions import SSLError as _SSLError -from .packages.urllib3.exceptions import ResponseError -from .cookies import extract_cookies_to_jar -from .exceptions import (ConnectionError, ConnectTimeout, ReadTimeout, SSLError, - ProxyError, RetryError) -from .auth import _basic_auth_str - -DEFAULT_POOLBLOCK = False -DEFAULT_POOLSIZE = 10 -DEFAULT_RETRIES = 0 - - -class BaseAdapter(object): - """The Base Transport Adapter""" - - def __init__(self): - super(BaseAdapter, self).__init__() - - def send(self): - raise NotImplementedError - - def close(self): - raise NotImplementedError - - -class HTTPAdapter(BaseAdapter): - """The built-in HTTP Adapter for urllib3. - - Provides a general-case interface for Requests sessions to contact HTTP and - HTTPS urls by implementing the Transport Adapter interface. This class will - usually be created by the :class:`Session ` class under the - covers. - - :param pool_connections: The number of urllib3 connection pools to cache. - :param pool_maxsize: The maximum number of connections to save in the pool. - :param int max_retries: The maximum number of retries each connection - should attempt. Note, this applies only to failed DNS lookups, socket - connections and connection timeouts, never to requests where data has - made it to the server. By default, Requests does not retry failed - connections. If you need granular control over the conditions under - which we retry a request, import urllib3's ``Retry`` class and pass - that instead. - :param pool_block: Whether the connection pool should block for connections. - - Usage:: - - >>> import requests - >>> s = requests.Session() - >>> a = requests.adapters.HTTPAdapter(max_retries=3) - >>> s.mount('http://', a) - """ - __attrs__ = ['max_retries', 'config', '_pool_connections', '_pool_maxsize', - '_pool_block'] - - def __init__(self, pool_connections=DEFAULT_POOLSIZE, - pool_maxsize=DEFAULT_POOLSIZE, max_retries=DEFAULT_RETRIES, - pool_block=DEFAULT_POOLBLOCK): - if max_retries == DEFAULT_RETRIES: - self.max_retries = Retry(0, read=False) - else: - self.max_retries = Retry.from_int(max_retries) - self.config = {} - self.proxy_manager = {} - - super(HTTPAdapter, self).__init__() - - self._pool_connections = pool_connections - self._pool_maxsize = pool_maxsize - self._pool_block = pool_block - - self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block) - - def __getstate__(self): - return dict((attr, getattr(self, attr, None)) for attr in - self.__attrs__) - - def __setstate__(self, state): - # Can't handle by adding 'proxy_manager' to self.__attrs__ because - # because self.poolmanager uses a lambda function, which isn't pickleable. - self.proxy_manager = {} - self.config = {} - - for attr, value in state.items(): - setattr(self, attr, value) - - self.init_poolmanager(self._pool_connections, self._pool_maxsize, - block=self._pool_block) - - def init_poolmanager(self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs): - """Initializes a urllib3 PoolManager. - - This method should not be called from user code, and is only - exposed for use when subclassing the - :class:`HTTPAdapter `. - - :param connections: The number of urllib3 connection pools to cache. - :param maxsize: The maximum number of connections to save in the pool. - :param block: Block when no free connections are available. - :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager. - """ - # save these values for pickling - self._pool_connections = connections - self._pool_maxsize = maxsize - self._pool_block = block - - self.poolmanager = PoolManager(num_pools=connections, maxsize=maxsize, - block=block, strict=True, **pool_kwargs) - - def proxy_manager_for(self, proxy, **proxy_kwargs): - """Return urllib3 ProxyManager for the given proxy. - - This method should not be called from user code, and is only - exposed for use when subclassing the - :class:`HTTPAdapter `. - - :param proxy: The proxy to return a urllib3 ProxyManager for. - :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager. - :returns: ProxyManager - """ - if not proxy in self.proxy_manager: - proxy_headers = self.proxy_headers(proxy) - self.proxy_manager[proxy] = proxy_from_url( - proxy, - proxy_headers=proxy_headers, - num_pools=self._pool_connections, - maxsize=self._pool_maxsize, - block=self._pool_block, - **proxy_kwargs) - - return self.proxy_manager[proxy] - - def cert_verify(self, conn, url, verify, cert): - """Verify a SSL certificate. This method should not be called from user - code, and is only exposed for use when subclassing the - :class:`HTTPAdapter `. - - :param conn: The urllib3 connection object associated with the cert. - :param url: The requested URL. - :param verify: Whether we should actually verify the certificate. - :param cert: The SSL certificate to verify. - """ - if url.lower().startswith('https') and verify: - - cert_loc = None - - # Allow self-specified cert location. - if verify is not True: - cert_loc = verify - - if not cert_loc: - cert_loc = DEFAULT_CA_BUNDLE_PATH - - if not cert_loc: - raise Exception("Could not find a suitable SSL CA certificate bundle.") - - conn.cert_reqs = 'CERT_REQUIRED' - conn.ca_certs = cert_loc - else: - conn.cert_reqs = 'CERT_NONE' - conn.ca_certs = None - - if cert: - if not isinstance(cert, basestring): - conn.cert_file = cert[0] - conn.key_file = cert[1] - else: - conn.cert_file = cert - - def build_response(self, req, resp): - """Builds a :class:`Response ` object from a urllib3 - response. This should not be called from user code, and is only exposed - for use when subclassing the - :class:`HTTPAdapter ` - - :param req: The :class:`PreparedRequest ` used to generate the response. - :param resp: The urllib3 response object. - """ - response = Response() - - # Fallback to None if there's no status_code, for whatever reason. - response.status_code = getattr(resp, 'status', None) - - # Make headers case-insensitive. - response.headers = CaseInsensitiveDict(getattr(resp, 'headers', {})) - - # Set encoding. - response.encoding = get_encoding_from_headers(response.headers) - response.raw = resp - response.reason = response.raw.reason - - if isinstance(req.url, bytes): - response.url = req.url.decode('utf-8') - else: - response.url = req.url - - # Add new cookies from the server. - extract_cookies_to_jar(response.cookies, req, resp) - - # Give the Response some context. - response.request = req - response.connection = self - - return response - - def get_connection(self, url, proxies=None): - """Returns a urllib3 connection for the given URL. This should not be - called from user code, and is only exposed for use when subclassing the - :class:`HTTPAdapter `. - - :param url: The URL to connect to. - :param proxies: (optional) A Requests-style dictionary of proxies used on this request. - """ - proxies = proxies or {} - proxy = proxies.get(urlparse(url.lower()).scheme) - - if proxy: - proxy = prepend_scheme_if_needed(proxy, 'http') - proxy_manager = self.proxy_manager_for(proxy) - conn = proxy_manager.connection_from_url(url) - else: - # Only scheme should be lower case - parsed = urlparse(url) - url = parsed.geturl() - conn = self.poolmanager.connection_from_url(url) - - return conn - - def close(self): - """Disposes of any internal state. - - Currently, this just closes the PoolManager, which closes pooled - connections. - """ - self.poolmanager.clear() - - def request_url(self, request, proxies): - """Obtain the url to use when making the final request. - - If the message is being sent through a HTTP proxy, the full URL has to - be used. Otherwise, we should only use the path portion of the URL. - - This should not be called from user code, and is only exposed for use - when subclassing the - :class:`HTTPAdapter `. - - :param request: The :class:`PreparedRequest ` being sent. - :param proxies: A dictionary of schemes to proxy URLs. - """ - proxies = proxies or {} - scheme = urlparse(request.url).scheme - proxy = proxies.get(scheme) - - if proxy and scheme != 'https': - url = urldefragauth(request.url) - else: - url = request.path_url - - return url - - def add_headers(self, request, **kwargs): - """Add any headers needed by the connection. As of v2.0 this does - nothing by default, but is left for overriding by users that subclass - the :class:`HTTPAdapter `. - - This should not be called from user code, and is only exposed for use - when subclassing the - :class:`HTTPAdapter `. - - :param request: The :class:`PreparedRequest ` to add headers to. - :param kwargs: The keyword arguments from the call to send(). - """ - pass - - def proxy_headers(self, proxy): - """Returns a dictionary of the headers to add to any request sent - through a proxy. This works with urllib3 magic to ensure that they are - correctly sent to the proxy, rather than in a tunnelled request if - CONNECT is being used. - - This should not be called from user code, and is only exposed for use - when subclassing the - :class:`HTTPAdapter `. - - :param proxies: The url of the proxy being used for this request. - :param kwargs: Optional additional keyword arguments. - """ - headers = {} - username, password = get_auth_from_url(proxy) - - if username and password: - headers['Proxy-Authorization'] = _basic_auth_str(username, - password) - - return headers - - def send(self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None): - """Sends PreparedRequest object. Returns Response object. - - :param request: The :class:`PreparedRequest ` being sent. - :param stream: (optional) Whether to stream the request content. - :param timeout: (optional) How long to wait for the server to send - data before giving up, as a float, or a (`connect timeout, read - timeout `_) tuple. - :type timeout: float or tuple - :param verify: (optional) Whether to verify SSL certificates. - :param cert: (optional) Any user-provided SSL certificate to be trusted. - :param proxies: (optional) The proxies dictionary to apply to the request. - """ - - conn = self.get_connection(request.url, proxies) - - self.cert_verify(conn, request.url, verify, cert) - url = self.request_url(request, proxies) - self.add_headers(request) - - chunked = not (request.body is None or 'Content-Length' in request.headers) - - if isinstance(timeout, tuple): - try: - connect, read = timeout - timeout = TimeoutSauce(connect=connect, read=read) - except ValueError as e: - # this may raise a string formatting error. - err = ("Invalid timeout {0}. Pass a (connect, read) " - "timeout tuple, or a single float to set " - "both timeouts to the same value".format(timeout)) - raise ValueError(err) - else: - timeout = TimeoutSauce(connect=timeout, read=timeout) - - try: - if not chunked: - resp = conn.urlopen( - method=request.method, - url=url, - body=request.body, - headers=request.headers, - redirect=False, - assert_same_host=False, - preload_content=False, - decode_content=False, - retries=self.max_retries, - timeout=timeout - ) - - # Send the request. - else: - if hasattr(conn, 'proxy_pool'): - conn = conn.proxy_pool - - low_conn = conn._get_conn(timeout=timeout) - - try: - low_conn.putrequest(request.method, - url, - skip_accept_encoding=True) - - for header, value in request.headers.items(): - low_conn.putheader(header, value) - - low_conn.endheaders() - - for i in request.body: - low_conn.send(hex(len(i))[2:].encode('utf-8')) - low_conn.send(b'\r\n') - low_conn.send(i) - low_conn.send(b'\r\n') - low_conn.send(b'0\r\n\r\n') - - r = low_conn.getresponse() - resp = HTTPResponse.from_httplib( - r, - pool=conn, - connection=low_conn, - preload_content=False, - decode_content=False - ) - except: - # If we hit any problems here, clean up the connection. - # Then, reraise so that we can handle the actual exception. - low_conn.close() - raise - else: - # All is well, return the connection to the pool. - conn._put_conn(low_conn) - - except (ProtocolError, socket.error) as err: - raise ConnectionError(err, request=request) - - except MaxRetryError as e: - if isinstance(e.reason, ConnectTimeoutError): - raise ConnectTimeout(e, request=request) - - if isinstance(e.reason, ResponseError): - raise RetryError(e, request=request) - - raise ConnectionError(e, request=request) - - except _ProxyError as e: - raise ProxyError(e) - - except (_SSLError, _HTTPError) as e: - if isinstance(e, _SSLError): - raise SSLError(e, request=request) - elif isinstance(e, ReadTimeoutError): - raise ReadTimeout(e, request=request) - else: - raise - - return self.build_response(request, resp) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/api.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/api.py deleted file mode 100644 index d40fa380..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/api.py +++ /dev/null @@ -1,147 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.api -~~~~~~~~~~~~ - -This module implements the Requests API. - -:copyright: (c) 2012 by Kenneth Reitz. -:license: Apache2, see LICENSE for more details. - -""" - -from . import sessions - - -def request(method, url, **kwargs): - """Constructs and sends a :class:`Request `. - - :param method: method for the new :class:`Request` object. - :param url: URL for the new :class:`Request` object. - :param params: (optional) Dictionary or bytes to be sent in the query string for the :class:`Request`. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param json: (optional) json data to send in the body of the :class:`Request`. - :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`. - :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`. - :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': ('filename', fileobj)}``) for multipart encoding upload. - :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth. - :param timeout: (optional) How long to wait for the server to send data - before giving up, as a float, or a (`connect timeout, read timeout - `_) tuple. - :type timeout: float or tuple - :param allow_redirects: (optional) Boolean. Set to True if POST/PUT/DELETE redirect following is allowed. - :type allow_redirects: bool - :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy. - :param verify: (optional) if ``True``, the SSL cert will be verified. A CA_BUNDLE path can also be provided. - :param stream: (optional) if ``False``, the response content will be immediately downloaded. - :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair. - :return: :class:`Response ` object - :rtype: requests.Response - - Usage:: - - >>> import requests - >>> req = requests.request('GET', 'http://httpbin.org/get') - - """ - - session = sessions.Session() - response = session.request(method=method, url=url, **kwargs) - # By explicitly closing the session, we avoid leaving sockets open which - # can trigger a ResourceWarning in some cases, and look like a memory leak - # in others. - session.close() - return response - - -def get(url, params=None, **kwargs): - """Sends a GET request. - - :param url: URL for the new :class:`Request` object. - :param params: (optional) Dictionary or bytes to be sent in the query string for the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - kwargs.setdefault('allow_redirects', True) - return request('get', url, params=params, **kwargs) - - -def options(url, **kwargs): - """Sends a OPTIONS request. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - kwargs.setdefault('allow_redirects', True) - return request('options', url, **kwargs) - - -def head(url, **kwargs): - """Sends a HEAD request. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - kwargs.setdefault('allow_redirects', False) - return request('head', url, **kwargs) - - -def post(url, data=None, json=None, **kwargs): - """Sends a POST request. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param json: (optional) json data to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - return request('post', url, data=data, json=json, **kwargs) - - -def put(url, data=None, **kwargs): - """Sends a PUT request. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - return request('put', url, data=data, **kwargs) - - -def patch(url, data=None, **kwargs): - """Sends a PATCH request. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - return request('patch', url, data=data, **kwargs) - - -def delete(url, **kwargs): - """Sends a DELETE request. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - :return: :class:`Response ` object - :rtype: requests.Response - """ - - return request('delete', url, **kwargs) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/auth.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/auth.py deleted file mode 100644 index 0ff9c298..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/auth.py +++ /dev/null @@ -1,212 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.auth -~~~~~~~~~~~~~ - -This module contains the authentication handlers for Requests. -""" - -import os -import re -import time -import hashlib - -from base64 import b64encode - -from .compat import urlparse, str -from .cookies import extract_cookies_to_jar -from .utils import parse_dict_header, to_native_string -from .status_codes import codes - -CONTENT_TYPE_FORM_URLENCODED = 'application/x-www-form-urlencoded' -CONTENT_TYPE_MULTI_PART = 'multipart/form-data' - - -def _basic_auth_str(username, password): - """Returns a Basic Auth string.""" - - authstr = 'Basic ' + to_native_string( - b64encode(('%s:%s' % (username, password)).encode('latin1')).strip() - ) - - return authstr - - -class AuthBase(object): - """Base class that all auth implementations derive from""" - - def __call__(self, r): - raise NotImplementedError('Auth hooks must be callable.') - - -class HTTPBasicAuth(AuthBase): - """Attaches HTTP Basic Authentication to the given Request object.""" - def __init__(self, username, password): - self.username = username - self.password = password - - def __call__(self, r): - r.headers['Authorization'] = _basic_auth_str(self.username, self.password) - return r - - -class HTTPProxyAuth(HTTPBasicAuth): - """Attaches HTTP Proxy Authentication to a given Request object.""" - def __call__(self, r): - r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password) - return r - - -class HTTPDigestAuth(AuthBase): - """Attaches HTTP Digest Authentication to the given Request object.""" - def __init__(self, username, password): - self.username = username - self.password = password - self.last_nonce = '' - self.nonce_count = 0 - self.chal = {} - self.pos = None - self.num_401_calls = 1 - - def build_digest_header(self, method, url): - - realm = self.chal['realm'] - nonce = self.chal['nonce'] - qop = self.chal.get('qop') - algorithm = self.chal.get('algorithm') - opaque = self.chal.get('opaque') - - if algorithm is None: - _algorithm = 'MD5' - else: - _algorithm = algorithm.upper() - # lambdas assume digest modules are imported at the top level - if _algorithm == 'MD5' or _algorithm == 'MD5-SESS': - def md5_utf8(x): - if isinstance(x, str): - x = x.encode('utf-8') - return hashlib.md5(x).hexdigest() - hash_utf8 = md5_utf8 - elif _algorithm == 'SHA': - def sha_utf8(x): - if isinstance(x, str): - x = x.encode('utf-8') - return hashlib.sha1(x).hexdigest() - hash_utf8 = sha_utf8 - - KD = lambda s, d: hash_utf8("%s:%s" % (s, d)) - - if hash_utf8 is None: - return None - - # XXX not implemented yet - entdig = None - p_parsed = urlparse(url) - #: path is request-uri defined in RFC 2616 which should not be empty - path = p_parsed.path or "/" - if p_parsed.query: - path += '?' + p_parsed.query - - A1 = '%s:%s:%s' % (self.username, realm, self.password) - A2 = '%s:%s' % (method, path) - - HA1 = hash_utf8(A1) - HA2 = hash_utf8(A2) - - if nonce == self.last_nonce: - self.nonce_count += 1 - else: - self.nonce_count = 1 - ncvalue = '%08x' % self.nonce_count - s = str(self.nonce_count).encode('utf-8') - s += nonce.encode('utf-8') - s += time.ctime().encode('utf-8') - s += os.urandom(8) - - cnonce = (hashlib.sha1(s).hexdigest()[:16]) - if _algorithm == 'MD5-SESS': - HA1 = hash_utf8('%s:%s:%s' % (HA1, nonce, cnonce)) - - if qop is None: - respdig = KD(HA1, "%s:%s" % (nonce, HA2)) - elif qop == 'auth' or 'auth' in qop.split(','): - noncebit = "%s:%s:%s:%s:%s" % ( - nonce, ncvalue, cnonce, 'auth', HA2 - ) - respdig = KD(HA1, noncebit) - else: - # XXX handle auth-int. - return None - - self.last_nonce = nonce - - # XXX should the partial digests be encoded too? - base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \ - 'response="%s"' % (self.username, realm, nonce, path, respdig) - if opaque: - base += ', opaque="%s"' % opaque - if algorithm: - base += ', algorithm="%s"' % algorithm - if entdig: - base += ', digest="%s"' % entdig - if qop: - base += ', qop="auth", nc=%s, cnonce="%s"' % (ncvalue, cnonce) - - return 'Digest %s' % (base) - - def handle_redirect(self, r, **kwargs): - """Reset num_401_calls counter on redirects.""" - if r.is_redirect: - self.num_401_calls = 1 - - def handle_401(self, r, **kwargs): - """Takes the given response and tries digest-auth, if needed.""" - - if self.pos is not None: - # Rewind the file position indicator of the body to where - # it was to resend the request. - r.request.body.seek(self.pos) - num_401_calls = getattr(self, 'num_401_calls', 1) - s_auth = r.headers.get('www-authenticate', '') - - if 'digest' in s_auth.lower() and num_401_calls < 2: - - self.num_401_calls += 1 - pat = re.compile(r'digest ', flags=re.IGNORECASE) - self.chal = parse_dict_header(pat.sub('', s_auth, count=1)) - - # Consume content and release the original connection - # to allow our new request to reuse the same one. - r.content - r.raw.release_conn() - prep = r.request.copy() - extract_cookies_to_jar(prep._cookies, r.request, r.raw) - prep.prepare_cookies(prep._cookies) - - prep.headers['Authorization'] = self.build_digest_header( - prep.method, prep.url) - _r = r.connection.send(prep, **kwargs) - _r.history.append(r) - _r.request = prep - - return _r - - self.num_401_calls = 1 - return r - - def __call__(self, r): - # If we have a saved nonce, skip the 401 - if self.last_nonce: - r.headers['Authorization'] = self.build_digest_header(r.method, r.url) - try: - self.pos = r.body.tell() - except AttributeError: - # In the case of HTTPDigestAuth being reused and the body of - # the previous request was a file-like object, pos has the - # file position of the previous body. Ensure it's set to - # None. - self.pos = None - r.register_hook('response', self.handle_401) - r.register_hook('response', self.handle_redirect) - return r diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cacert.pem b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cacert.pem deleted file mode 100644 index 101ac98f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cacert.pem +++ /dev/null @@ -1,4433 +0,0 @@ - -# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA -# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA -# Label: "GlobalSign Root CA" -# Serial: 4835703278459707669005204 -# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a -# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c -# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99 ------BEGIN CERTIFICATE----- -MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG -A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv -b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw -MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i -YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT -aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ -jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp -xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp -1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG -snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ -U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8 -9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E -BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B -AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz -yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE -38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP -AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad -DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME -HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A== ------END CERTIFICATE----- - -# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2 -# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2 -# Label: "GlobalSign Root CA - R2" -# Serial: 4835703278459682885658125 -# MD5 Fingerprint: 94:14:77:7e:3e:5e:fd:8f:30:bd:41:b0:cf:e7:d0:30 -# SHA1 Fingerprint: 75:e0:ab:b6:13:85:12:27:1c:04:f8:5f:dd:de:38:e4:b7:24:2e:fe -# SHA256 Fingerprint: ca:42:dd:41:74:5f:d0:b8:1e:b9:02:36:2c:f9:d8:bf:71:9d:a1:bd:1b:1e:fc:94:6f:5b:4c:99:f4:2c:1b:9e ------BEGIN CERTIFICATE----- -MIIDujCCAqKgAwIBAgILBAAAAAABD4Ym5g0wDQYJKoZIhvcNAQEFBQAwTDEgMB4G -A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjIxEzARBgNVBAoTCkdsb2JhbFNp -Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDYxMjE1MDgwMDAwWhcNMjExMjE1 -MDgwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMjETMBEG -A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI -hvcNAQEBBQADggEPADCCAQoCggEBAKbPJA6+Lm8omUVCxKs+IVSbC9N/hHD6ErPL -v4dfxn+G07IwXNb9rfF73OX4YJYJkhD10FPe+3t+c4isUoh7SqbKSaZeqKeMWhG8 -eoLrvozps6yWJQeXSpkqBy+0Hne/ig+1AnwblrjFuTosvNYSuetZfeLQBoZfXklq -tTleiDTsvHgMCJiEbKjNS7SgfQx5TfC4LcshytVsW33hoCmEofnTlEnLJGKRILzd -C9XZzPnqJworc5HGnRusyMvo4KD0L5CLTfuwNhv2GXqF4G3yYROIXJ/gkwpRl4pa -zq+r1feqCapgvdzZX99yqWATXgAByUr6P6TqBwMhAo6CygPCm48CAwEAAaOBnDCB -mTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUm+IH -V2ccHsBqBt5ZtJot39wZhi4wNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2NybC5n -bG9iYWxzaWduLm5ldC9yb290LXIyLmNybDAfBgNVHSMEGDAWgBSb4gdXZxwewGoG -3lm0mi3f3BmGLjANBgkqhkiG9w0BAQUFAAOCAQEAmYFThxxol4aR7OBKuEQLq4Gs -J0/WwbgcQ3izDJr86iw8bmEbTUsp9Z8FHSbBuOmDAGJFtqkIk7mpM0sYmsL4h4hO -291xNBrBVNpGP+DTKqttVCL1OmLNIG+6KYnX3ZHu01yiPqFbQfXf5WRDLenVOavS -ot+3i9DAgBkcRcAtjOj4LaR0VknFBbVPFd5uRHg5h6h+u/N5GJG79G+dwfCMNYxd -AfvDbbnvRG15RjF+Cv6pgsH/76tuIMRQyV+dTZsXjAzlAcmgQWpzU/qlULRuJQ/7 -TBj0/VLZjmmx6BEP3ojY+x1J96relc8geMJgEtslQIxq/H5COEBkEveegeGTLg== ------END CERTIFICATE----- - -# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G3 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 1999 VeriSign, Inc. - For authorized use only -# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G3 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 1999 VeriSign, Inc. - For authorized use only -# Label: "Verisign Class 3 Public Primary Certification Authority - G3" -# Serial: 206684696279472310254277870180966723415 -# MD5 Fingerprint: cd:68:b6:a7:c7:c4:ce:75:e0:1d:4f:57:44:61:92:09 -# SHA1 Fingerprint: 13:2d:0d:45:53:4b:69:97:cd:b2:d5:c3:39:e2:55:76:60:9b:5c:c6 -# SHA256 Fingerprint: eb:04:cf:5e:b1:f3:9a:fa:76:2f:2b:b1:20:f2:96:cb:a5:20:c1:b9:7d:b1:58:95:65:b8:1c:b9:a1:7b:72:44 ------BEGIN CERTIFICATE----- -MIIEGjCCAwICEQCbfgZJoz5iudXukEhxKe9XMA0GCSqGSIb3DQEBBQUAMIHKMQsw -CQYDVQQGEwJVUzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZl -cmlTaWduIFRydXN0IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAxOTk5IFZlcmlTaWdu -LCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxRTBDBgNVBAMTPFZlcmlT -aWduIENsYXNzIDMgUHVibGljIFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3Jp -dHkgLSBHMzAeFw05OTEwMDEwMDAwMDBaFw0zNjA3MTYyMzU5NTlaMIHKMQswCQYD -VQQGEwJVUzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZlcmlT -aWduIFRydXN0IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAxOTk5IFZlcmlTaWduLCBJ -bmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxRTBDBgNVBAMTPFZlcmlTaWdu -IENsYXNzIDMgUHVibGljIFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkg -LSBHMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMu6nFL8eB8aHm8b -N3O9+MlrlBIwT/A2R/XQkQr1F8ilYcEWQE37imGQ5XYgwREGfassbqb1EUGO+i2t -KmFZpGcmTNDovFJbcCAEWNF6yaRpvIMXZK0Fi7zQWM6NjPXr8EJJC52XJ2cybuGu -kxUccLwgTS8Y3pKI6GyFVxEa6X7jJhFUokWWVYPKMIno3Nij7SqAP395ZVc+FSBm -CC+Vk7+qRy+oRpfwEuL+wgorUeZ25rdGt+INpsyow0xZVYnm6FNcHOqd8GIWC6fJ -Xwzw3sJ2zq/3avL6QaaiMxTJ5Xpj055iN9WFZZ4O5lMkdBteHRJTW8cs54NJOxWu -imi5V5cCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAERSWwauSCPc/L8my/uRan2Te -2yFPhpk0djZX3dAVL8WtfxUfN2JzPtTnX84XA9s1+ivbrmAJXx5fj267Cz3qWhMe -DGBvtcC1IyIuBwvLqXTLR7sdwdela8wv0kL9Sd2nic9TutoAWii/gt/4uhMdUIaC -/Y4wjylGsB49Ndo4YhYYSq3mtlFs3q9i6wHQHiT+eo8SGhJouPtmmRQURVyu565p -F4ErWjfJXir0xuKhXFSbplQAz/DxwceYMBo7Nhbbo27q/a2ywtrvAkcTisDxszGt -TxzhT5yvDwyd93gN2PQ1VoDat20Xj50egWTh/sVFuq1ruQp6Tk9LhO5L8X3dEQ== ------END CERTIFICATE----- - -# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited -# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited -# Label: "Entrust.net Premium 2048 Secure Server CA" -# Serial: 946069240 -# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90 -# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31 -# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77 ------BEGIN CERTIFICATE----- -MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML -RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp -bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5 -IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp -ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3 -MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3 -LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp -YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG -A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp -MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq -K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe -sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX -MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT -XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/ -HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH -4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV -HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub -j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo -U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf -zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b -u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+ -bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er -fF6adulZkMV8gzURZVE= ------END CERTIFICATE----- - -# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust -# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust -# Label: "Baltimore CyberTrust Root" -# Serial: 33554617 -# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4 -# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74 -# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb ------BEGIN CERTIFICATE----- -MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ -RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD -VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX -DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y -ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy -VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr -mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr -IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK -mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu -XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy -dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye -jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1 -BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3 -DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92 -9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx -jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0 -Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz -ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS -R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp ------END CERTIFICATE----- - -# Issuer: CN=AddTrust External CA Root O=AddTrust AB OU=AddTrust External TTP Network -# Subject: CN=AddTrust External CA Root O=AddTrust AB OU=AddTrust External TTP Network -# Label: "AddTrust External Root" -# Serial: 1 -# MD5 Fingerprint: 1d:35:54:04:85:78:b0:3f:42:42:4d:bf:20:73:0a:3f -# SHA1 Fingerprint: 02:fa:f3:e2:91:43:54:68:60:78:57:69:4d:f5:e4:5b:68:85:18:68 -# SHA256 Fingerprint: 68:7f:a4:51:38:22:78:ff:f0:c8:b1:1f:8d:43:d5:76:67:1c:6e:b2:bc:ea:b4:13:fb:83:d9:65:d0:6d:2f:f2 ------BEGIN CERTIFICATE----- -MIIENjCCAx6gAwIBAgIBATANBgkqhkiG9w0BAQUFADBvMQswCQYDVQQGEwJTRTEU -MBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFkZFRydXN0IEV4dGVybmFs -IFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBFeHRlcm5hbCBDQSBSb290 -MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFowbzELMAkGA1UEBhMCU0Ux -FDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVzdCBFeHRlcm5h -bCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJuYWwgQ0EgUm9v -dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALf3GjPm8gAELTngTlvt -H7xsD821+iO2zt6bETOXpClMfZOfvUq8k+0DGuOPz+VtUFrWlymUWoCwSXrbLpX9 -uMq/NzgtHj6RQa1wVsfwTz/oMp50ysiQVOnGXw94nZpAPA6sYapeFI+eh6FqUNzX -mk6vBbOmcZSccbNQYArHE504B4YCqOmoaSYYkKtMsE8jqzpPhNjfzp/haW+710LX -a0Tkx63ubUFfclpxCDezeWWkWaCUN/cALw3CknLa0Dhy2xSoRcRdKn23tNbE7qzN -E0S3ySvdQwAl+mG5aWpYIxG3pzOPVnVZ9c0p10a3CitlttNCbxWyuHv77+ldU9U0 -WicCAwEAAaOB3DCB2TAdBgNVHQ4EFgQUrb2YejS0Jvf6xCZU7wO94CTLVBowCwYD -VR0PBAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wgZkGA1UdIwSBkTCBjoAUrb2YejS0 -Jvf6xCZU7wO94CTLVBqhc6RxMG8xCzAJBgNVBAYTAlNFMRQwEgYDVQQKEwtBZGRU -cnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0ZXJuYWwgVFRQIE5ldHdvcmsx -IjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENBIFJvb3SCAQEwDQYJKoZIhvcN -AQEFBQADggEBALCb4IUlwtYj4g+WBpKdQZic2YR5gdkeWxQHIzZlj7DYd7usQWxH -YINRsPkyPef89iYTx4AWpb9a/IfPeHmJIZriTAcKhjW88t5RxNKWt9x+Tu5w/Rw5 -6wwCURQtjr0W4MHfRnXnJK3s9EK0hZNwEGe6nQY1ShjTK3rMUUKhemPR5ruhxSvC -Nr4TDea9Y355e6cJDUCrat2PisP29owaQgVR1EX1n6diIWgVIEM8med8vSTYqZEX -c4g/VhsxOBi0cQ+azcgOno4uG+GMmIPLHzHxREzGBHNJdmAPx/i9F4BrLunMTA5a -mnkPIAou1Z5jJh5VkpTYghdae9C8x49OhgQ= ------END CERTIFICATE----- - -# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc. -# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc. -# Label: "Entrust Root Certification Authority" -# Serial: 1164660820 -# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4 -# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9 -# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c ------BEGIN CERTIFICATE----- -MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC -VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0 -Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW -KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl -cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw -NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw -NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy -ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV -BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ -KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo -Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4 -4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9 -KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI -rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi -94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB -sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi -gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo -kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE -vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA -A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t -O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua -AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP -9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/ -eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m -0vdXcDazv/wor3ElhVsT/h5/WrQ8 ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Global CA O=GeoTrust Inc. -# Subject: CN=GeoTrust Global CA O=GeoTrust Inc. -# Label: "GeoTrust Global CA" -# Serial: 144470 -# MD5 Fingerprint: f7:75:ab:29:fb:51:4e:b7:77:5e:ff:05:3c:99:8e:f5 -# SHA1 Fingerprint: de:28:f4:a4:ff:e5:b9:2f:a3:c5:03:d1:a3:49:a7:f9:96:2a:82:12 -# SHA256 Fingerprint: ff:85:6a:2d:25:1d:cd:88:d3:66:56:f4:50:12:67:98:cf:ab:aa:de:40:79:9c:72:2d:e4:d2:b5:db:36:a7:3a ------BEGIN CERTIFICATE----- -MIIDVDCCAjygAwIBAgIDAjRWMA0GCSqGSIb3DQEBBQUAMEIxCzAJBgNVBAYTAlVT -MRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMRswGQYDVQQDExJHZW9UcnVzdCBHbG9i -YWwgQ0EwHhcNMDIwNTIxMDQwMDAwWhcNMjIwNTIxMDQwMDAwWjBCMQswCQYDVQQG -EwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEbMBkGA1UEAxMSR2VvVHJ1c3Qg -R2xvYmFsIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2swYYzD9 -9BcjGlZ+W988bDjkcbd4kdS8odhM+KhDtgPpTSEHCIjaWC9mOSm9BXiLnTjoBbdq -fnGk5sRgprDvgOSJKA+eJdbtg/OtppHHmMlCGDUUna2YRpIuT8rxh0PBFpVXLVDv -iS2Aelet8u5fa9IAjbkU+BQVNdnARqN7csiRv8lVK83Qlz6cJmTM386DGXHKTubU -1XupGc1V3sjs0l44U+VcT4wt/lAjNvxm5suOpDkZALeVAjmRCw7+OC7RHQWa9k0+ -bw8HHa8sHo9gOeL6NlMTOdReJivbPagUvTLrGAMoUgRx5aszPeE4uwc2hGKceeoW -MPRfwCvocWvk+QIDAQABo1MwUTAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTA -ephojYn7qwVkDBF9qn1luMrMTjAfBgNVHSMEGDAWgBTAephojYn7qwVkDBF9qn1l -uMrMTjANBgkqhkiG9w0BAQUFAAOCAQEANeMpauUvXVSOKVCUn5kaFOSPeCpilKIn -Z57QzxpeR+nBsqTP3UEaBU6bS+5Kb1VSsyShNwrrZHYqLizz/Tt1kL/6cdjHPTfS -tQWVYrmm3ok9Nns4d0iXrKYgjy6myQzCsplFAMfOEVEiIuCl6rYVSAlk6l5PdPcF -PseKUgzbFbS9bZvlxrFUaKnjaZC2mqUPuLk/IH2uSrW4nOQdtqvmlKXBx4Ot2/Un -hw4EbNX/3aBd7YdStysVAq45pmp06drE57xNNB6pXE0zX5IJL4hmXXeXxx12E6nV -5fEWCRE11azbJHFwLJhWC9kXtNHjUStedejV0NxPNO3CBWaAocvmMw== ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Universal CA O=GeoTrust Inc. -# Subject: CN=GeoTrust Universal CA O=GeoTrust Inc. -# Label: "GeoTrust Universal CA" -# Serial: 1 -# MD5 Fingerprint: 92:65:58:8b:a2:1a:31:72:73:68:5c:b4:a5:7a:07:48 -# SHA1 Fingerprint: e6:21:f3:35:43:79:05:9a:4b:68:30:9d:8a:2f:74:22:15:87:ec:79 -# SHA256 Fingerprint: a0:45:9b:9f:63:b2:25:59:f5:fa:5d:4c:6d:b3:f9:f7:2f:f1:93:42:03:35:78:f0:73:bf:1d:1b:46:cb:b9:12 ------BEGIN CERTIFICATE----- -MIIFaDCCA1CgAwIBAgIBATANBgkqhkiG9w0BAQUFADBFMQswCQYDVQQGEwJVUzEW -MBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEeMBwGA1UEAxMVR2VvVHJ1c3QgVW5pdmVy -c2FsIENBMB4XDTA0MDMwNDA1MDAwMFoXDTI5MDMwNDA1MDAwMFowRTELMAkGA1UE -BhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xHjAcBgNVBAMTFUdlb1RydXN0 -IFVuaXZlcnNhbCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKYV -VaCjxuAfjJ0hUNfBvitbtaSeodlyWL0AG0y/YckUHUWCq8YdgNY96xCcOq9tJPi8 -cQGeBvV8Xx7BDlXKg5pZMK4ZyzBIle0iN430SppyZj6tlcDgFgDgEB8rMQ7XlFTT -QjOgNB0eRXbdT8oYN+yFFXoZCPzVx5zw8qkuEKmS5j1YPakWaDwvdSEYfyh3peFh -F7em6fgemdtzbvQKoiFs7tqqhZJmr/Z6a4LauiIINQ/PQvE1+mrufislzDoR5G2v -c7J2Ha3QsnhnGqQ5HFELZ1aD/ThdDc7d8Lsrlh/eezJS/R27tQahsiFepdaVaH/w -mZ7cRQg+59IJDTWU3YBOU5fXtQlEIGQWFwMCTFMNaN7VqnJNk22CDtucvc+081xd -VHppCZbW2xHBjXWotM85yM48vCR85mLK4b19p71XZQvk/iXttmkQ3CgaRr0BHdCX -teGYO8A3ZNY9lO4L4fUorgtWv3GLIylBjobFS1J72HGrH4oVpjuDWtdYAVHGTEHZ -f9hBZ3KiKN9gg6meyHv8U3NyWfWTehd2Ds735VzZC1U0oqpbtWpU5xPKV+yXbfRe -Bi9Fi1jUIxaS5BZuKGNZMN9QAZxjiRqf2xeUgnA3wySemkfWWspOqGmJch+RbNt+ -nhutxx9z3SxPGWX9f5NAEC7S8O08ni4oPmkmM8V7AgMBAAGjYzBhMA8GA1UdEwEB -/wQFMAMBAf8wHQYDVR0OBBYEFNq7LqqwDLiIJlF0XG0D08DYj3rWMB8GA1UdIwQY -MBaAFNq7LqqwDLiIJlF0XG0D08DYj3rWMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG -9w0BAQUFAAOCAgEAMXjmx7XfuJRAyXHEqDXsRh3ChfMoWIawC/yOsjmPRFWrZIRc -aanQmjg8+uUfNeVE44B5lGiku8SfPeE0zTBGi1QrlaXv9z+ZhP015s8xxtxqv6fX -IwjhmF7DWgh2qaavdy+3YL1ERmrvl/9zlcGO6JP7/TG37FcREUWbMPEaiDnBTzyn -ANXH/KttgCJwpQzgXQQpAvvLoJHRfNbDflDVnVi+QTjruXU8FdmbyUqDWcDaU/0z -uzYYm4UPFd3uLax2k7nZAY1IEKj79TiG8dsKxr2EoyNB3tZ3b4XUhRxQ4K5RirqN -Pnbiucon8l+f725ZDQbYKxek0nxru18UGkiPGkzns0ccjkxFKyDuSN/n3QmOGKja -QI2SJhFTYXNd673nxE0pN2HrrDktZy4W1vUAg4WhzH92xH3kt0tm7wNFYGm2DFKW -koRepqO1pD4r2czYG0eq8kTaT/kD6PAUyz/zg97QwVTjt+gKN02LIFkDMBmhLMi9 -ER/frslKxfMnZmaGrGiR/9nmUxwPi1xpZQomyB40w11Re9epnAahNt3ViZS82eQt -DF4JbAiXfKM9fJP/P6EUp8+1Xevb2xzEdt+Iub1FBZUbrvxGakyvSOPOrg/Sfuvm -bJxPgWp6ZKy7PtXny3YuxadIwVyQD8vIP/rmMuGNG2+k5o7Y+SlIis5z/iw= ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Universal CA 2 O=GeoTrust Inc. -# Subject: CN=GeoTrust Universal CA 2 O=GeoTrust Inc. -# Label: "GeoTrust Universal CA 2" -# Serial: 1 -# MD5 Fingerprint: 34:fc:b8:d0:36:db:9e:14:b3:c2:f2:db:8f:e4:94:c7 -# SHA1 Fingerprint: 37:9a:19:7b:41:85:45:35:0c:a6:03:69:f3:3c:2e:af:47:4f:20:79 -# SHA256 Fingerprint: a0:23:4f:3b:c8:52:7c:a5:62:8e:ec:81:ad:5d:69:89:5d:a5:68:0d:c9:1d:1c:b8:47:7f:33:f8:78:b9:5b:0b ------BEGIN CERTIFICATE----- -MIIFbDCCA1SgAwIBAgIBATANBgkqhkiG9w0BAQUFADBHMQswCQYDVQQGEwJVUzEW -MBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEgMB4GA1UEAxMXR2VvVHJ1c3QgVW5pdmVy -c2FsIENBIDIwHhcNMDQwMzA0MDUwMDAwWhcNMjkwMzA0MDUwMDAwWjBHMQswCQYD -VQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEgMB4GA1UEAxMXR2VvVHJ1 -c3QgVW5pdmVyc2FsIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC -AQCzVFLByT7y2dyxUxpZKeexw0Uo5dfR7cXFS6GqdHtXr0om/Nj1XqduGdt0DE81 -WzILAePb63p3NeqqWuDW6KFXlPCQo3RWlEQwAx5cTiuFJnSCegx2oG9NzkEtoBUG -FF+3Qs17j1hhNNwqCPkuwwGmIkQcTAeC5lvO0Ep8BNMZcyfwqph/Lq9O64ceJHdq -XbboW0W63MOhBW9Wjo8QJqVJwy7XQYci4E+GymC16qFjwAGXEHm9ADwSbSsVsaxL -se4YuU6W3Nx2/zu+z18DwPw76L5GG//aQMJS9/7jOvdqdzXQ2o3rXhhqMcceujwb -KNZrVMaqW9eiLBsZzKIC9ptZvTdrhrVtgrrY6slWvKk2WP0+GfPtDCapkzj4T8Fd -IgbQl+rhrcZV4IErKIM6+vR7IVEAvlI4zs1meaj0gVbi0IMJR1FbUGrP20gaXT73 -y/Zl92zxlfgCOzJWgjl6W70viRu/obTo/3+NjN8D8WBOWBFM66M/ECuDmgFz2ZRt -hAAnZqzwcEAJQpKtT5MNYQlRJNiS1QuUYbKHsu3/mjX/hVTK7URDrBs8FmtISgoc -QIgfksILAAX/8sgCSqSqqcyZlpwvWOB94b67B9xfBHJcMTTD7F8t4D1kkCLm0ey4 -Lt1ZrtmhN79UNdxzMk+MBB4zsslG8dhcyFVQyWi9qLo2CQIDAQABo2MwYTAPBgNV -HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR281Xh+qQ2+/CfXGJx7Tz0RzgQKzAfBgNV -HSMEGDAWgBR281Xh+qQ2+/CfXGJx7Tz0RzgQKzAOBgNVHQ8BAf8EBAMCAYYwDQYJ -KoZIhvcNAQEFBQADggIBAGbBxiPz2eAubl/oz66wsCVNK/g7WJtAJDday6sWSf+z -dXkzoS9tcBc0kf5nfo/sm+VegqlVHy/c1FEHEv6sFj4sNcZj/NwQ6w2jqtB8zNHQ -L1EuxBRa3ugZ4T7GzKQp5y6EqgYweHZUcyiYWTjgAA1i00J9IZ+uPTqM1fp3DRgr -Fg5fNuH8KrUwJM/gYwx7WBr+mbpCErGR9Hxo4sjoryzqyX6uuyo9DRXcNJW2GHSo -ag/HtPQTxORb7QrSpJdMKu0vbBKJPfEncKpqA1Ihn0CoZ1Dy81of398j9tx4TuaY -T1U6U+Pv8vSfx3zYWK8pIpe44L2RLrB27FcRz+8pRPPphXpgY+RdM4kX2TGq2tbz -GDVyz4crL2MjhF2EjD9XoIj8mZEoJmmZ1I+XRL6O1UixpCgp8RW04eWe3fiPpm8m -1wk8OhwRDqZsN/etRIcsKMfYdIKz0G9KV7s1KSegi+ghp4dkNl3M2Basx7InQJJV -OCiNUW7dFGdTbHFcJoRNdVq2fmBWqU2t+5sel/MN2dKXVHfaPRK34B7vCAas+YWH -6aLcr34YEoP9VhdBLtUpgn2Z9DH2canPLAEnpQW5qrJITirvn5NSUZU8UnOOVkwX -QMAJKOSLakhT2+zNVVXxxvjpoixMptEmX36vWkzaH6byHCx+rgIW0lbQL1dTR+iS ------END CERTIFICATE----- - -# Issuer: CN=Visa eCommerce Root O=VISA OU=Visa International Service Association -# Subject: CN=Visa eCommerce Root O=VISA OU=Visa International Service Association -# Label: "Visa eCommerce Root" -# Serial: 25952180776285836048024890241505565794 -# MD5 Fingerprint: fc:11:b8:d8:08:93:30:00:6d:23:f9:7e:eb:52:1e:02 -# SHA1 Fingerprint: 70:17:9b:86:8c:00:a4:fa:60:91:52:22:3f:9f:3e:32:bd:e0:05:62 -# SHA256 Fingerprint: 69:fa:c9:bd:55:fb:0a:c7:8d:53:bb:ee:5c:f1:d5:97:98:9f:d0:aa:ab:20:a2:51:51:bd:f1:73:3e:e7:d1:22 ------BEGIN CERTIFICATE----- -MIIDojCCAoqgAwIBAgIQE4Y1TR0/BvLB+WUF1ZAcYjANBgkqhkiG9w0BAQUFADBr -MQswCQYDVQQGEwJVUzENMAsGA1UEChMEVklTQTEvMC0GA1UECxMmVmlzYSBJbnRl -cm5hdGlvbmFsIFNlcnZpY2UgQXNzb2NpYXRpb24xHDAaBgNVBAMTE1Zpc2EgZUNv -bW1lcmNlIFJvb3QwHhcNMDIwNjI2MDIxODM2WhcNMjIwNjI0MDAxNjEyWjBrMQsw -CQYDVQQGEwJVUzENMAsGA1UEChMEVklTQTEvMC0GA1UECxMmVmlzYSBJbnRlcm5h -dGlvbmFsIFNlcnZpY2UgQXNzb2NpYXRpb24xHDAaBgNVBAMTE1Zpc2EgZUNvbW1l -cmNlIFJvb3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvV95WHm6h -2mCxlCfLF9sHP4CFT8icttD0b0/Pmdjh28JIXDqsOTPHH2qLJj0rNfVIsZHBAk4E -lpF7sDPwsRROEW+1QK8bRaVK7362rPKgH1g/EkZgPI2h4H3PVz4zHvtH8aoVlwdV -ZqW1LS7YgFmypw23RuwhY/81q6UCzyr0TP579ZRdhE2o8mCP2w4lPJ9zcc+U30rq -299yOIzzlr3xF7zSujtFWsan9sYXiwGd/BmoKoMWuDpI/k4+oKsGGelT84ATB+0t -vz8KPFUgOSwsAGl0lUq8ILKpeeUYiZGo3BxN77t+Nwtd/jmliFKMAGzsGHxBvfaL -dXe6YJ2E5/4tAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD -AgEGMB0GA1UdDgQWBBQVOIMPPyw/cDMezUb+B4wg4NfDtzANBgkqhkiG9w0BAQUF -AAOCAQEAX/FBfXxcCLkr4NWSR/pnXKUTwwMhmytMiUbPWU3J/qVAtmPN3XEolWcR -zCSs00Rsca4BIGsDoo8Ytyk6feUWYFN4PMCvFYP3j1IzJL1kk5fui/fbGKhtcbP3 -LBfQdCVp9/5rPJS+TUtBjE7ic9DjkCJzQ83z7+pzzkWKsKZJ/0x9nXGIxHYdkFsd -7v3M9+79YKWxehZx0RbQfBI8bGmX265fOZpwLwU8GUYEmSA20GBuYQa7FkKMcPcw -++DbZqMAAb3mLNqRX6BGi01qnD093QVG/na/oAo85ADmJ7f/hC3euiInlhBx6yLt -398znM/jra6O1I7mT1GvFpLgXPYHDw== ------END CERTIFICATE----- - -# Issuer: CN=AAA Certificate Services O=Comodo CA Limited -# Subject: CN=AAA Certificate Services O=Comodo CA Limited -# Label: "Comodo AAA Services root" -# Serial: 1 -# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0 -# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49 -# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4 ------BEGIN CERTIFICATE----- -MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb -MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow -GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj -YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL -MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE -BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM -GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP -ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua -BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe -3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4 -YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR -rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm -ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU -oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF -MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v -QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t -b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF -AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q -GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz -Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2 -G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi -l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3 -smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg== ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root Certification Authority O=QuoVadis Limited OU=Root Certification Authority -# Subject: CN=QuoVadis Root Certification Authority O=QuoVadis Limited OU=Root Certification Authority -# Label: "QuoVadis Root CA" -# Serial: 985026699 -# MD5 Fingerprint: 27:de:36:fe:72:b7:00:03:00:9d:f4:f0:1e:6c:04:24 -# SHA1 Fingerprint: de:3f:40:bd:50:93:d3:9b:6c:60:f6:da:bc:07:62:01:00:89:76:c9 -# SHA256 Fingerprint: a4:5e:de:3b:bb:f0:9c:8a:e1:5c:72:ef:c0:72:68:d6:93:a2:1c:99:6f:d5:1e:67:ca:07:94:60:fd:6d:88:73 ------BEGIN CERTIFICATE----- -MIIF0DCCBLigAwIBAgIEOrZQizANBgkqhkiG9w0BAQUFADB/MQswCQYDVQQGEwJC -TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDElMCMGA1UECxMcUm9vdCBDZXJ0 -aWZpY2F0aW9uIEF1dGhvcml0eTEuMCwGA1UEAxMlUXVvVmFkaXMgUm9vdCBDZXJ0 -aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wMTAzMTkxODMzMzNaFw0yMTAzMTcxODMz -MzNaMH8xCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMSUw -IwYDVQQLExxSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MS4wLAYDVQQDEyVR -dW9WYWRpcyBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG -9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv2G1lVO6V/z68mcLOhrfEYBklbTRvM16z/Yp -li4kVEAkOPcahdxYTMukJ0KX0J+DisPkBgNbAKVRHnAEdOLB1Dqr1607BxgFjv2D -rOpm2RgbaIr1VxqYuvXtdj182d6UajtLF8HVj71lODqV0D1VNk7feVcxKh7YWWVJ -WCCYfqtffp/p1k3sg3Spx2zY7ilKhSoGFPlU5tPaZQeLYzcS19Dsw3sgQUSj7cug -F+FxZc4dZjH3dgEZyH0DWLaVSR2mEiboxgx24ONmy+pdpibu5cxfvWenAScOospU -xbF6lR1xHkopigPcakXBpBlebzbNw6Kwt/5cOOJSvPhEQ+aQuwIDAQABo4ICUjCC -Ak4wPQYIKwYBBQUHAQEEMTAvMC0GCCsGAQUFBzABhiFodHRwczovL29jc3AucXVv -dmFkaXNvZmZzaG9yZS5jb20wDwYDVR0TAQH/BAUwAwEB/zCCARoGA1UdIASCAREw -ggENMIIBCQYJKwYBBAG+WAABMIH7MIHUBggrBgEFBQcCAjCBxxqBxFJlbGlhbmNl -IG9uIHRoZSBRdW9WYWRpcyBSb290IENlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBh -c3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFy -ZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRpb24gcHJh -Y3RpY2VzLCBhbmQgdGhlIFF1b1ZhZGlzIENlcnRpZmljYXRlIFBvbGljeS4wIgYI -KwYBBQUHAgEWFmh0dHA6Ly93d3cucXVvdmFkaXMuYm0wHQYDVR0OBBYEFItLbe3T -KbkGGew5Oanwl4Rqy+/fMIGuBgNVHSMEgaYwgaOAFItLbe3TKbkGGew5Oanwl4Rq -y+/foYGEpIGBMH8xCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1p -dGVkMSUwIwYDVQQLExxSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MS4wLAYD -VQQDEyVRdW9WYWRpcyBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggQ6tlCL -MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQUFAAOCAQEAitQUtf70mpKnGdSk -fnIYj9lofFIk3WdvOXrEql494liwTXCYhGHoG+NpGA7O+0dQoE7/8CQfvbLO9Sf8 -7C9TqnN7Az10buYWnuulLsS/VidQK2K6vkscPFVcQR0kvoIgR13VRH56FmjffU1R -cHhXHTMe/QKZnAzNCgVPx7uOpHX6Sm2xgI4JVrmcGmD+XcHXetwReNDWXcG31a0y -mQM6isxUJTkxgXsTIlG6Rmyhu576BGxJJnSP0nPrzDCi5upZIof4l/UO/erMkqQW -xFIY6iHOsfHmhIHluqmGKPJDWl0Snawe2ajlCmqnf6CHKc/yiU3U7MXi5nrQNiOK -SnQ2+Q== ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited -# Label: "QuoVadis Root CA 2" -# Serial: 1289 -# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b -# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7 -# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86 ------BEGIN CERTIFICATE----- -MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x -GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv -b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV -BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W -YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa -GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg -Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J -WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB -rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp -+ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1 -ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i -Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz -PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og -/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH -oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI -yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud -EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2 -A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL -MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT -ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f -BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn -g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl -fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K -WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha -B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc -hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR -TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD -mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z -ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y -4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza -8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited -# Label: "QuoVadis Root CA 3" -# Serial: 1478 -# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf -# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85 -# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35 ------BEGIN CERTIFICATE----- -MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x -GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv -b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV -BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W -YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM -V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB -4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr -H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd -8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv -vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT -mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe -btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc -T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt -WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ -c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A -4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD -VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG -CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0 -aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0 -aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu -dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw -czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G -A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC -TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg -Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0 -7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem -d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd -+LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B -4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN -t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x -DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57 -k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s -zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j -Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT -mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK -4SVhM7JZG+Ju1zdXtg2pEto= ------END CERTIFICATE----- - -# Issuer: O=SECOM Trust.net OU=Security Communication RootCA1 -# Subject: O=SECOM Trust.net OU=Security Communication RootCA1 -# Label: "Security Communication Root CA" -# Serial: 0 -# MD5 Fingerprint: f1:bc:63:6a:54:e0:b5:27:f5:cd:e7:1a:e3:4d:6e:4a -# SHA1 Fingerprint: 36:b1:2b:49:f9:81:9e:d7:4c:9e:bc:38:0f:c6:56:8f:5d:ac:b2:f7 -# SHA256 Fingerprint: e7:5e:72:ed:9f:56:0e:ec:6e:b4:80:00:73:a4:3f:c3:ad:19:19:5a:39:22:82:01:78:95:97:4a:99:02:6b:6c ------BEGIN CERTIFICATE----- -MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEY -MBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21t -dW5pY2F0aW9uIFJvb3RDQTEwHhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5 -WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYD -VQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEwggEiMA0GCSqGSIb3 -DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw8yl8 -9f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJ -DKaVv0uMDPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9 -Ms+k2Y7CI9eNqPPYJayX5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/N -QV3Is00qVUarH9oe4kA92819uZKAnDfdDJZkndwi92SL32HeFZRSFaB9UslLqCHJ -xrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2JChzAgMBAAGjPzA9MB0G -A1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYwDwYDVR0T -AQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vG -kl3g0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfr -Uj94nK9NrvjVT8+amCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5 -Bw+SUEmK3TGXX8npN6o7WWWXlDLJs58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJU -JRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ6rBK+1YWc26sTfcioU+tHXot -RSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAiFL39vmwLAw== ------END CERTIFICATE----- - -# Issuer: CN=Sonera Class2 CA O=Sonera -# Subject: CN=Sonera Class2 CA O=Sonera -# Label: "Sonera Class 2 Root CA" -# Serial: 29 -# MD5 Fingerprint: a3:ec:75:0f:2e:88:df:fa:48:01:4e:0b:5c:48:6f:fb -# SHA1 Fingerprint: 37:f7:6d:e6:07:7c:90:c5:b1:3e:93:1a:b7:41:10:b4:f2:e4:9a:27 -# SHA256 Fingerprint: 79:08:b4:03:14:c1:38:10:0b:51:8d:07:35:80:7f:fb:fc:f8:51:8a:00:95:33:71:05:ba:38:6b:15:3d:d9:27 ------BEGIN CERTIFICATE----- -MIIDIDCCAgigAwIBAgIBHTANBgkqhkiG9w0BAQUFADA5MQswCQYDVQQGEwJGSTEP -MA0GA1UEChMGU29uZXJhMRkwFwYDVQQDExBTb25lcmEgQ2xhc3MyIENBMB4XDTAx -MDQwNjA3Mjk0MFoXDTIxMDQwNjA3Mjk0MFowOTELMAkGA1UEBhMCRkkxDzANBgNV -BAoTBlNvbmVyYTEZMBcGA1UEAxMQU29uZXJhIENsYXNzMiBDQTCCASIwDQYJKoZI -hvcNAQEBBQADggEPADCCAQoCggEBAJAXSjWdyvANlsdE+hY3/Ei9vX+ALTU74W+o -Z6m/AxxNjG8yR9VBaKQTBME1DJqEQ/xcHf+Js+gXGM2RX/uJ4+q/Tl18GybTdXnt -5oTjV+WtKcT0OijnpXuENmmz/V52vaMtmdOQTiMofRhj8VQ7Jp12W5dCsv+u8E7s -3TmVToMGf+dJQMjFAbJUWmYdPfz56TwKnoG4cPABi+QjVHzIrviQHgCWctRUz2Ej -vOr7nQKV0ba5cTppCD8PtOFCx4j1P5iop7oc4HFx71hXgVB6XGt0Rg6DA5jDjqhu -8nYybieDwnPz3BjotJPqdURrBGAgcVeHnfO+oJAjPYok4doh28MCAwEAAaMzMDEw -DwYDVR0TAQH/BAUwAwEB/zARBgNVHQ4ECgQISqCqWITTXjwwCwYDVR0PBAQDAgEG -MA0GCSqGSIb3DQEBBQUAA4IBAQBazof5FnIVV0sd2ZvnoiYw7JNn39Yt0jSv9zil -zqsWuasvfDXLrNAPtEwr/IDva4yRXzZ299uzGxnq9LIR/WFxRL8oszodv7ND6J+/ -3DEIcbCdjdY0RzKQxmUk96BKfARzjzlvF4xytb1LyHr4e4PDKE6cCepnP7JnBBvD -FNr450kkkdAdavphOe9r5yF1BgfYErQhIHBCcYHaPJo2vqZbDWpsmh+Re/n570K6 -Tk6ezAyNlNzZRZxe7EJQY670XcSxEtzKO6gunRRaBXW37Ndj4ro1tgQIkejanZz2 -ZrUYrAqmVCY0M9IbwdR/GjqOC6oybtv8TyWf2TLHllpwrN9M ------END CERTIFICATE----- - -# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com -# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com -# Label: "XRamp Global CA Root" -# Serial: 107108908803651509692980124233745014957 -# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1 -# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6 -# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2 ------BEGIN CERTIFICATE----- -MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB -gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk -MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY -UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx -NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3 -dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy -dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB -dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6 -38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP -KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q -DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4 -qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa -JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi -PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P -BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs -jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0 -eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD -ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR -vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt -qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa -IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy -i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ -O+7ETPTsJ3xCwnR8gooJybQDJbw= ------END CERTIFICATE----- - -# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority -# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority -# Label: "Go Daddy Class 2 CA" -# Serial: 0 -# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67 -# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4 -# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4 ------BEGIN CERTIFICATE----- -MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh -MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE -YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3 -MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo -ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg -MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN -ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA -PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w -wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi -EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY -avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+ -YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE -sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h -/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5 -IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj -YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD -ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy -OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P -TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ -HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER -dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf -ReYNnyicsbkqWletNw+vHX/bvZ8= ------END CERTIFICATE----- - -# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority -# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority -# Label: "Starfield Class 2 CA" -# Serial: 0 -# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24 -# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a -# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58 ------BEGIN CERTIFICATE----- -MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl -MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp -U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw -NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE -ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp -ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3 -DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf -8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN -+lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0 -X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa -K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA -1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G -A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR -zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0 -YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD -bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w -DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3 -L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D -eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl -xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp -VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY -WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q= ------END CERTIFICATE----- - -# Issuer: O=Government Root Certification Authority -# Subject: O=Government Root Certification Authority -# Label: "Taiwan GRCA" -# Serial: 42023070807708724159991140556527066870 -# MD5 Fingerprint: 37:85:44:53:32:45:1f:20:f0:f3:95:e1:25:c4:43:4e -# SHA1 Fingerprint: f4:8b:11:bf:de:ab:be:94:54:20:71:e6:41:de:6b:be:88:2b:40:b9 -# SHA256 Fingerprint: 76:00:29:5e:ef:e8:5b:9e:1f:d6:24:db:76:06:2a:aa:ae:59:81:8a:54:d2:77:4c:d4:c0:b2:c0:11:31:e1:b3 ------BEGIN CERTIFICATE----- -MIIFcjCCA1qgAwIBAgIQH51ZWtcvwgZEpYAIaeNe9jANBgkqhkiG9w0BAQUFADA/ -MQswCQYDVQQGEwJUVzEwMC4GA1UECgwnR292ZXJubWVudCBSb290IENlcnRpZmlj -YXRpb24gQXV0aG9yaXR5MB4XDTAyMTIwNTEzMjMzM1oXDTMyMTIwNTEzMjMzM1ow -PzELMAkGA1UEBhMCVFcxMDAuBgNVBAoMJ0dvdmVybm1lbnQgUm9vdCBDZXJ0aWZp -Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB -AJoluOzMonWoe/fOW1mKydGGEghU7Jzy50b2iPN86aXfTEc2pBsBHH8eV4qNw8XR -IePaJD9IK/ufLqGU5ywck9G/GwGHU5nOp/UKIXZ3/6m3xnOUT0b3EEk3+qhZSV1q -gQdW8or5BtD3cCJNtLdBuTK4sfCxw5w/cP1T3YGq2GN49thTbqGsaoQkclSGxtKy -yhwOeYHWtXBiCAEuTk8O1RGvqa/lmr/czIdtJuTJV6L7lvnM4T9TjGxMfptTCAts -F/tnyMKtsc2AtJfcdgEWFelq16TheEfOhtX7MfP6Mb40qij7cEwdScevLJ1tZqa2 -jWR+tSBqnTuBto9AAGdLiYa4zGX+FVPpBMHWXx1E1wovJ5pGfaENda1UhhXcSTvx -ls4Pm6Dso3pdvtUqdULle96ltqqvKKyskKw4t9VoNSZ63Pc78/1Fm9G7Q3hub/FC -VGqY8A2tl+lSXunVanLeavcbYBT0peS2cWeqH+riTcFCQP5nRhc4L0c/cZyu5SHK -YS1tB6iEfC3uUSXxY5Ce/eFXiGvviiNtsea9P63RPZYLhY3Naye7twWb7LuRqQoH -EgKXTiCQ8P8NHuJBO9NAOueNXdpm5AKwB1KYXA6OM5zCppX7VRluTI6uSw+9wThN -Xo+EHWbNxWCWtFJaBYmOlXqYwZE8lSOyDvR5tMl8wUohAgMBAAGjajBoMB0GA1Ud -DgQWBBTMzO/MKWCkO7GStjz6MmKPrCUVOzAMBgNVHRMEBTADAQH/MDkGBGcqBwAE -MTAvMC0CAQAwCQYFKw4DAhoFADAHBgVnKgMAAAQUA5vwIhP/lSg209yewDL7MTqK -UWUwDQYJKoZIhvcNAQEFBQADggIBAECASvomyc5eMN1PhnR2WPWus4MzeKR6dBcZ -TulStbngCnRiqmjKeKBMmo4sIy7VahIkv9Ro04rQ2JyftB8M3jh+Vzj8jeJPXgyf -qzvS/3WXy6TjZwj/5cAWtUgBfen5Cv8b5Wppv3ghqMKnI6mGq3ZW6A4M9hPdKmaK -ZEk9GhiHkASfQlK3T8v+R0F2Ne//AHY2RTKbxkaFXeIksB7jSJaYV0eUVXoPQbFE -JPPB/hprv4j9wabak2BegUqZIJxIZhm1AHlUD7gsL0u8qV1bYH+Mh6XgUmMqvtg7 -hUAV/h62ZT/FS9p+tXo1KaMuephgIqP0fSdOLeq0dDzpD6QzDxARvBMB1uUO07+1 -EqLhRSPAzAhuYbeJq4PjJB7mXQfnHyA+z2fI56wwbSdLaG5LKlwCCDTb+HbkZ6Mm -nD+iMsJKxYEYMRBWqoTvLQr/uB930r+lWKBi5NdLkXWNiYCYfm3LU05er/ayl4WX -udpVBrkk7tfGOB5jGxI7leFYrPLfhNVfmS8NVVvmONsuP3LpSIXLuykTjx44Vbnz -ssQwmSNOXfJIoRIM3BKQCZBUkQM8R+XVyWXgt0t97EfTsws+rZ7QdAAO671RrcDe -LMDDav7v3Aun+kbfYNucpllQdSNpc5Oy+fwC00fmcc4QAu4njIT/rEUNE1yDMuAl -pYYsfPQS ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Assured ID Root CA" -# Serial: 17154717934120587862167794914071425081 -# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72 -# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43 -# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c ------BEGIN CERTIFICATE----- -MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv -b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG -EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl -cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi -MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c -JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP -mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+ -wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4 -VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/ -AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB -AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW -BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun -pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC -dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf -fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm -NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx -H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe -+o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g== ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Global Root CA" -# Serial: 10944719598952040374951832963794454346 -# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e -# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36 -# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61 ------BEGIN CERTIFICATE----- -MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD -QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT -MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j -b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG -9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB -CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97 -nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt -43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P -T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4 -gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO -BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR -TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw -DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr -hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg -06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF -PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls -YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk -CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= ------END CERTIFICATE----- - -# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert High Assurance EV Root CA" -# Serial: 3553400076410547919724730734378100087 -# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a -# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25 -# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf ------BEGIN CERTIFICATE----- -MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j -ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL -MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3 -LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug -RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm -+9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW -PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM -xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB -Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3 -hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg -EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF -MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA -FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec -nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z -eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF -hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2 -Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe -vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep -+OkuE6N36B9K ------END CERTIFICATE----- - -# Issuer: CN=Class 2 Primary CA O=Certplus -# Subject: CN=Class 2 Primary CA O=Certplus -# Label: "Certplus Class 2 Primary CA" -# Serial: 177770208045934040241468760488327595043 -# MD5 Fingerprint: 88:2c:8c:52:b8:a2:3c:f3:f7:bb:03:ea:ae:ac:42:0b -# SHA1 Fingerprint: 74:20:74:41:72:9c:dd:92:ec:79:31:d8:23:10:8d:c2:81:92:e2:bb -# SHA256 Fingerprint: 0f:99:3c:8a:ef:97:ba:af:56:87:14:0e:d5:9a:d1:82:1b:b4:af:ac:f0:aa:9a:58:b5:d5:7a:33:8a:3a:fb:cb ------BEGIN CERTIFICATE----- -MIIDkjCCAnqgAwIBAgIRAIW9S/PY2uNp9pTXX8OlRCMwDQYJKoZIhvcNAQEFBQAw -PTELMAkGA1UEBhMCRlIxETAPBgNVBAoTCENlcnRwbHVzMRswGQYDVQQDExJDbGFz -cyAyIFByaW1hcnkgQ0EwHhcNOTkwNzA3MTcwNTAwWhcNMTkwNzA2MjM1OTU5WjA9 -MQswCQYDVQQGEwJGUjERMA8GA1UEChMIQ2VydHBsdXMxGzAZBgNVBAMTEkNsYXNz -IDIgUHJpbWFyeSBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANxQ -ltAS+DXSCHh6tlJw/W/uz7kRy1134ezpfgSN1sxvc0NXYKwzCkTsA18cgCSR5aiR -VhKC9+Ar9NuuYS6JEI1rbLqzAr3VNsVINyPi8Fo3UjMXEuLRYE2+L0ER4/YXJQyL -kcAbmXuZVg2v7tK8R1fjeUl7NIknJITesezpWE7+Tt9avkGtrAjFGA7v0lPubNCd -EgETjdyAYveVqUSISnFOYFWe2yMZeVYHDD9jC1yw4r5+FfyUM1hBOHTE4Y+L3yas -H7WLO7dDWWuwJKZtkIvEcupdM5i3y95ee++U8Rs+yskhwcWYAqqi9lt3m/V+llU0 -HGdpwPFC40es/CgcZlUCAwEAAaOBjDCBiTAPBgNVHRMECDAGAQH/AgEKMAsGA1Ud -DwQEAwIBBjAdBgNVHQ4EFgQU43Mt38sOKAze3bOkynm4jrvoMIkwEQYJYIZIAYb4 -QgEBBAQDAgEGMDcGA1UdHwQwMC4wLKAqoCiGJmh0dHA6Ly93d3cuY2VydHBsdXMu -Y29tL0NSTC9jbGFzczIuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQCnVM+IRBnL39R/ -AN9WM2K191EBkOvDP9GIROkkXe/nFL0gt5o8AP5tn9uQ3Nf0YtaLcF3n5QRIqWh8 -yfFC82x/xXp8HVGIutIKPidd3i1RTtMTZGnkLuPT55sJmabglZvOGtd/vjzOUrMR -FcEPF80Du5wlFbqidon8BvEY0JNLDnyCt6X09l/+7UCmnYR0ObncHoUW2ikbhiMA -ybuJfm6AiB4vFLQDJKgybwOaRywwvlbGp0ICcBvqQNi6BQNwB6SW//1IMwrh3KWB -kJtN3X3n57LNXMhqlfil9o3EXXgIvnsG1knPGTZQIy4I5p4FTUcY1Rbpsda2ENW7 -l7+ijrRU ------END CERTIFICATE----- - -# Issuer: CN=DST Root CA X3 O=Digital Signature Trust Co. -# Subject: CN=DST Root CA X3 O=Digital Signature Trust Co. -# Label: "DST Root CA X3" -# Serial: 91299735575339953335919266965803778155 -# MD5 Fingerprint: 41:03:52:dc:0f:f7:50:1b:16:f0:02:8e:ba:6f:45:c5 -# SHA1 Fingerprint: da:c9:02:4f:54:d8:f6:df:94:93:5f:b1:73:26:38:ca:6a:d7:7c:13 -# SHA256 Fingerprint: 06:87:26:03:31:a7:24:03:d9:09:f1:05:e6:9b:cf:0d:32:e1:bd:24:93:ff:c6:d9:20:6d:11:bc:d6:77:07:39 ------BEGIN CERTIFICATE----- -MIIDSjCCAjKgAwIBAgIQRK+wgNajJ7qJMDmGLvhAazANBgkqhkiG9w0BAQUFADA/ -MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT -DkRTVCBSb290IENBIFgzMB4XDTAwMDkzMDIxMTIxOVoXDTIxMDkzMDE0MDExNVow -PzEkMCIGA1UEChMbRGlnaXRhbCBTaWduYXR1cmUgVHJ1c3QgQ28uMRcwFQYDVQQD -Ew5EU1QgUm9vdCBDQSBYMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB -AN+v6ZdQCINXtMxiZfaQguzH0yxrMMpb7NnDfcdAwRgUi+DoM3ZJKuM/IUmTrE4O -rz5Iy2Xu/NMhD2XSKtkyj4zl93ewEnu1lcCJo6m67XMuegwGMoOifooUMM0RoOEq -OLl5CjH9UL2AZd+3UWODyOKIYepLYYHsUmu5ouJLGiifSKOeDNoJjj4XLh7dIN9b -xiqKqy69cK3FCxolkHRyxXtqqzTWMIn/5WgTe1QLyNau7Fqckh49ZLOMxt+/yUFw -7BZy1SbsOFU5Q9D8/RhcQPGX69Wam40dutolucbY38EVAjqr2m7xPi71XAicPNaD -aeQQmxkqtilX4+U9m5/wAl0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV -HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFMSnsaR7LHH62+FLkHX/xBVghYkQMA0GCSqG -SIb3DQEBBQUAA4IBAQCjGiybFwBcqR7uKGY3Or+Dxz9LwwmglSBd49lZRNI+DT69 -ikugdB/OEIKcdBodfpga3csTS7MgROSR6cz8faXbauX+5v3gTt23ADq1cEmv8uXr -AvHRAosZy5Q6XkjEGB5YGV8eAlrwDPGxrancWYaLbumR9YbK+rlmM6pZW87ipxZz -R8srzJmwN0jP41ZL9c8PDHIyh8bwRLtTcm1D9SZImlJnt1ir/md2cXjbDaJWFBM5 -JDGFoqgCWjBH4d1QB7wCCZAA62RjYJsWvIjJEubSfZGL+T0yjWW06XyxV3bqxbYo -Ob8VZRzI9neWagqNdwvYkQsEjgfbKbYK7p2CNTUQ ------END CERTIFICATE----- - -# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG -# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG -# Label: "SwissSign Gold CA - G2" -# Serial: 13492815561806991280 -# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93 -# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61 -# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95 ------BEGIN CERTIFICATE----- -MIIFujCCA6KgAwIBAgIJALtAHEP1Xk+wMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV -BAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxHzAdBgNVBAMTFlN3aXNzU2ln -biBHb2xkIENBIC0gRzIwHhcNMDYxMDI1MDgzMDM1WhcNMzYxMDI1MDgzMDM1WjBF -MQswCQYDVQQGEwJDSDEVMBMGA1UEChMMU3dpc3NTaWduIEFHMR8wHQYDVQQDExZT -d2lzc1NpZ24gR29sZCBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC -CgKCAgEAr+TufoskDhJuqVAtFkQ7kpJcyrhdhJJCEyq8ZVeCQD5XJM1QiyUqt2/8 -76LQwB8CJEoTlo8jE+YoWACjR8cGp4QjK7u9lit/VcyLwVcfDmJlD909Vopz2q5+ -bbqBHH5CjCA12UNNhPqE21Is8w4ndwtrvxEvcnifLtg+5hg3Wipy+dpikJKVyh+c -6bM8K8vzARO/Ws/BtQpgvd21mWRTuKCWs2/iJneRjOBiEAKfNA+k1ZIzUd6+jbqE -emA8atufK+ze3gE/bk3lUIbLtK/tREDFylqM2tIrfKjuvqblCqoOpd8FUrdVxyJd -MmqXl2MT28nbeTZ7hTpKxVKJ+STnnXepgv9VHKVxaSvRAiTysybUa9oEVeXBCsdt -MDeQKuSeFDNeFhdVxVu1yzSJkvGdJo+hB9TGsnhQ2wwMC3wLjEHXuendjIj3o02y -MszYF9rNt85mndT9Xv+9lz4pded+p2JYryU0pUHHPbwNUMoDAw8IWh+Vc3hiv69y -FGkOpeUDDniOJihC8AcLYiAQZzlG+qkDzAQ4embvIIO1jEpWjpEA/I5cgt6IoMPi -aG59je883WX0XaxR7ySArqpWl2/5rX3aYT+YdzylkbYcjCbaZaIJbcHiVOO5ykxM -gI93e2CaHt+28kgeDrpOVG2Y4OGiGqJ3UM/EY5LsRxmd6+ZrzsECAwEAAaOBrDCB -qTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUWyV7 -lqRlUX64OfPAeGZe6Drn8O4wHwYDVR0jBBgwFoAUWyV7lqRlUX64OfPAeGZe6Drn -8O4wRgYDVR0gBD8wPTA7BglghXQBWQECAQEwLjAsBggrBgEFBQcCARYgaHR0cDov -L3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBACe6 -45R88a7A3hfm5djV9VSwg/S7zV4Fe0+fdWavPOhWfvxyeDgD2StiGwC5+OlgzczO -UYrHUDFu4Up+GC9pWbY9ZIEr44OE5iKHjn3g7gKZYbge9LgriBIWhMIxkziWMaa5 -O1M/wySTVltpkuzFwbs4AOPsF6m43Md8AYOfMke6UiI0HTJ6CVanfCU2qT1L2sCC -bwq7EsiHSycR+R4tx5M/nttfJmtS2S6K8RTGRI0Vqbe/vd6mGu6uLftIdxf+u+yv -GPUqUfA5hJeVbG4bwyvEdGB5JbAKJ9/fXtI5z0V9QkvfsywexcZdylU6oJxpmo/a -77KwPJ+HbBIrZXAVUjEaJM9vMSNQH4xPjyPDdEFjHFWoFN0+4FFQz/EbMFYOkrCC -hdiDyyJkvC24JdVUorgG6q2SpCSgwYa1ShNqR88uC1aVVMvOmttqtKay20EIhid3 -92qgQmwLOM7XdVAyksLfKzAiSNDVQTglXaTpXZ/GlHXQRf0wl0OPkKsKx4ZzYEpp -Ld6leNcG2mqeSz53OiATIgHQv2ieY2BrNU0LbbqhPcCT4H8js1WtciVORvnSFu+w -ZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6LqjviOvrv1vA+ACOzB2+htt -Qc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ ------END CERTIFICATE----- - -# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG -# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG -# Label: "SwissSign Silver CA - G2" -# Serial: 5700383053117599563 -# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13 -# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb -# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5 ------BEGIN CERTIFICATE----- -MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UE -BhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWdu -IFNpbHZlciBDQSAtIEcyMB4XDTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0Nlow -RzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMY -U3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A -MIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644N0Mv -Fz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7br -YT7QbNHm+/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieF -nbAVlDLaYQ1HTWBCrpJH6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH -6ATK72oxh9TAtvmUcXtnZLi2kUpCe2UuMGoM9ZDulebyzYLs2aFK7PayS+VFheZt -eJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5hqAaEuSh6XzjZG6k4sIN/ -c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5FZGkECwJ -MoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRH -HTBsROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTf -jNFusB3hB48IHpmccelM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb6 -5i/4z3GcRm25xBWNOHkDRUjvxF3XCO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOB -rDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU -F6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRBtjpbO8tFnb0c -wpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0 -cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIB -AHPGgeAn0i0P4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShp -WJHckRE1qTodvBqlYJ7YH39FkWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9 -xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L3XWgwF15kIwb4FDm3jH+mHtwX6WQ -2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx/uNncqCxv1yL5PqZ -IseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFaDGi8 -aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2X -em1ZqSqPe97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQR -dAtq/gsD/KNVV4n+SsuuWxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/ -OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJDIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+ -hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ubDgEj8Z+7fNzcbBGXJbLy -tGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Primary Certification Authority O=GeoTrust Inc. -# Subject: CN=GeoTrust Primary Certification Authority O=GeoTrust Inc. -# Label: "GeoTrust Primary Certification Authority" -# Serial: 32798226551256963324313806436981982369 -# MD5 Fingerprint: 02:26:c3:01:5e:08:30:37:43:a9:d0:7d:cf:37:e6:bf -# SHA1 Fingerprint: 32:3c:11:8e:1b:f7:b8:b6:52:54:e2:e2:10:0d:d6:02:90:37:f0:96 -# SHA256 Fingerprint: 37:d5:10:06:c5:12:ea:ab:62:64:21:f1:ec:8c:92:01:3f:c5:f8:2a:e9:8e:e5:33:eb:46:19:b8:de:b4:d0:6c ------BEGIN CERTIFICATE----- -MIIDfDCCAmSgAwIBAgIQGKy1av1pthU6Y2yv2vrEoTANBgkqhkiG9w0BAQUFADBY -MQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjExMC8GA1UEAxMo -R2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEx -MjcwMDAwMDBaFw0zNjA3MTYyMzU5NTlaMFgxCzAJBgNVBAYTAlVTMRYwFAYDVQQK -Ew1HZW9UcnVzdCBJbmMuMTEwLwYDVQQDEyhHZW9UcnVzdCBQcmltYXJ5IENlcnRp -ZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC -AQEAvrgVe//UfH1nrYNke8hCUy3f9oQIIGHWAVlqnEQRr+92/ZV+zmEwu3qDXwK9 -AWbK7hWNb6EwnL2hhZ6UOvNWiAAxz9juapYC2e0DjPt1befquFUWBRaa9OBesYjA -ZIVcFU2Ix7e64HXprQU9nceJSOC7KMgD4TCTZF5SwFlwIjVXiIrxlQqD17wxcwE0 -7e9GceBrAqg1cmuXm2bgyxx5X9gaBGgeRwLmnWDiNpcB3841kt++Z8dtd1k7j53W -kBWUvEI0EME5+bEnPn7WinXFsq+W06Lem+SYvn3h6YGttm/81w7a4DSwDRp35+MI -mO9Y+pyEtzavwt+s0vQQBnBxNQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G -A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQULNVQQZcVi/CPNmFbSvtr2ZnJM5IwDQYJ -KoZIhvcNAQEFBQADggEBAFpwfyzdtzRP9YZRqSa+S7iq8XEN3GHHoOo0Hnp3DwQ1 -6CePbJC/kRYkRj5KTs4rFtULUh38H2eiAkUxT87z+gOneZ1TatnaYzr4gNfTmeGl -4b7UVXGYNTq+k+qurUKykG/g/CFNNWMziUnWm07Kx+dOCQD32sfvmWKZd7aVIl6K -oKv0uHiYyjgZmclynnjNS6yvGaBzEi38wkG6gZHaFloxt/m0cYASSJlyc1pZU8Fj -UjPtp8nSOQJw+uCxQmYpqptR7TBUIhRf2asdweSU8Pj1K/fqynhG1riR/aYNKxoU -AT6A8EKglQdebc3MS6RFjasS6LPeWuWgfOgPIh1a6Vk= ------END CERTIFICATE----- - -# Issuer: CN=thawte Primary Root CA O=thawte, Inc. OU=Certification Services Division/(c) 2006 thawte, Inc. - For authorized use only -# Subject: CN=thawte Primary Root CA O=thawte, Inc. OU=Certification Services Division/(c) 2006 thawte, Inc. - For authorized use only -# Label: "thawte Primary Root CA" -# Serial: 69529181992039203566298953787712940909 -# MD5 Fingerprint: 8c:ca:dc:0b:22:ce:f5:be:72:ac:41:1a:11:a8:d8:12 -# SHA1 Fingerprint: 91:c6:d6:ee:3e:8a:c8:63:84:e5:48:c2:99:29:5c:75:6c:81:7b:81 -# SHA256 Fingerprint: 8d:72:2f:81:a9:c1:13:c0:79:1d:f1:36:a2:96:6d:b2:6c:95:0a:97:1d:b4:6b:41:99:f4:ea:54:b7:8b:fb:9f ------BEGIN CERTIFICATE----- -MIIEIDCCAwigAwIBAgIQNE7VVyDV7exJ9C/ON9srbTANBgkqhkiG9w0BAQUFADCB -qTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYGA1UECxMf -Q2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMvKGMpIDIw -MDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxHzAdBgNV -BAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwHhcNMDYxMTE3MDAwMDAwWhcNMzYw -NzE2MjM1OTU5WjCBqTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5j -LjEoMCYGA1UECxMfQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYG -A1UECxMvKGMpIDIwMDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNl -IG9ubHkxHzAdBgNVBAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwggEiMA0GCSqG -SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCsoPD7gFnUnMekz52hWXMJEEUMDSxuaPFs -W0hoSVk3/AszGcJ3f8wQLZU0HObrTQmnHNK4yZc2AreJ1CRfBsDMRJSUjQJib+ta -3RGNKJpchJAQeg29dGYvajig4tVUROsdB58Hum/u6f1OCyn1PoSgAfGcq/gcfomk -6KHYcWUNo1F77rzSImANuVud37r8UVsLr5iy6S7pBOhih94ryNdOwUxkHt3Ph1i6 -Sk/KaAcdHJ1KxtUvkcx8cXIcxcBn6zL9yZJclNqFwJu/U30rCfSMnZEfl2pSy94J -NqR32HuHUETVPm4pafs5SSYeCaWAe0At6+gnhcn+Yf1+5nyXHdWdAgMBAAGjQjBA -MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBR7W0XP -r87Lev0xkhpqtvNG61dIUDANBgkqhkiG9w0BAQUFAAOCAQEAeRHAS7ORtvzw6WfU -DW5FvlXok9LOAz/t2iWwHVfLHjp2oEzsUHboZHIMpKnxuIvW1oeEuzLlQRHAd9mz -YJ3rG9XRbkREqaYB7FViHXe4XI5ISXycO1cRrK1zN44veFyQaEfZYGDm/Ac9IiAX -xPcW6cTYcvnIc3zfFi8VqT79aie2oetaupgf1eNNZAqdE8hhuvU5HIe6uL17In/2 -/qxAeeWsEG89jxt5dovEN7MhGITlNgDrYyCZuen+MwS7QcjBAvlEYyCegc5C09Y/ -LHbTY5xZ3Y+m4Q6gLkH3LpVHz7z9M/P2C2F+fpErgUfCJzDupxBdN49cOSvkBPB7 -jVaMaA== ------END CERTIFICATE----- - -# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G5 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2006 VeriSign, Inc. - For authorized use only -# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G5 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2006 VeriSign, Inc. - For authorized use only -# Label: "VeriSign Class 3 Public Primary Certification Authority - G5" -# Serial: 33037644167568058970164719475676101450 -# MD5 Fingerprint: cb:17:e4:31:67:3e:e2:09:fe:45:57:93:f3:0a:fa:1c -# SHA1 Fingerprint: 4e:b6:d5:78:49:9b:1c:cf:5f:58:1e:ad:56:be:3d:9b:67:44:a5:e5 -# SHA256 Fingerprint: 9a:cf:ab:7e:43:c8:d8:80:d0:6b:26:2a:94:de:ee:e4:b4:65:99:89:c3:d0:ca:f1:9b:af:64:05:e4:1a:b7:df ------BEGIN CERTIFICATE----- -MIIE0zCCA7ugAwIBAgIQGNrRniZ96LtKIVjNzGs7SjANBgkqhkiG9w0BAQUFADCB -yjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQL -ExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNiBWZXJp -U2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxW -ZXJpU2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0 -aG9yaXR5IC0gRzUwHhcNMDYxMTA4MDAwMDAwWhcNMzYwNzE2MjM1OTU5WjCByjEL -MAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZW -ZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNiBWZXJpU2ln -biwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJp -U2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9y -aXR5IC0gRzUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvJAgIKXo1 -nmAMqudLO07cfLw8RRy7K+D+KQL5VwijZIUVJ/XxrcgxiV0i6CqqpkKzj/i5Vbex -t0uz/o9+B1fs70PbZmIVYc9gDaTY3vjgw2IIPVQT60nKWVSFJuUrjxuf6/WhkcIz -SdhDY2pSS9KP6HBRTdGJaXvHcPaz3BJ023tdS1bTlr8Vd6Gw9KIl8q8ckmcY5fQG -BO+QueQA5N06tRn/Arr0PO7gi+s3i+z016zy9vA9r911kTMZHRxAy3QkGSGT2RT+ -rCpSx4/VBEnkjWNHiDxpg8v+R70rfk/Fla4OndTRQ8Bnc+MUCH7lP59zuDMKz10/ -NIeWiu5T6CUVAgMBAAGjgbIwga8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8E -BAMCAQYwbQYIKwYBBQUHAQwEYTBfoV2gWzBZMFcwVRYJaW1hZ2UvZ2lmMCEwHzAH -BgUrDgMCGgQUj+XTGoasjY5rw8+AatRIGCx7GS4wJRYjaHR0cDovL2xvZ28udmVy -aXNpZ24uY29tL3ZzbG9nby5naWYwHQYDVR0OBBYEFH/TZafC3ey78DAJ80M5+gKv -MzEzMA0GCSqGSIb3DQEBBQUAA4IBAQCTJEowX2LP2BqYLz3q3JktvXf2pXkiOOzE -p6B4Eq1iDkVwZMXnl2YtmAl+X6/WzChl8gGqCBpH3vn5fJJaCGkgDdk+bW48DW7Y -5gaRQBi5+MHt39tBquCWIMnNZBU4gcmU7qKEKQsTb47bDN0lAtukixlE0kF6BWlK -WE9gyn6CagsCqiUXObXbf+eEZSqVir2G3l6BFoMtEMze/aiCKm0oHw0LxOXnGiYZ -4fQRbxC1lfznQgUy286dUV4otp6F01vvpX1FQHKOtw5rDgb7MzVIcbidJ4vEZV8N -hnacRHr2lVz2XTIIM6RUthg/aFzyQkqFOFSDX9HoLPKsEdao7WNq ------END CERTIFICATE----- - -# Issuer: CN=SecureTrust CA O=SecureTrust Corporation -# Subject: CN=SecureTrust CA O=SecureTrust Corporation -# Label: "SecureTrust CA" -# Serial: 17199774589125277788362757014266862032 -# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1 -# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11 -# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73 ------BEGIN CERTIFICATE----- -MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI -MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x -FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz -MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv -cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN -AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz -Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO -0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao -wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj -7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS -8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT -BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB -/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg -JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC -NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3 -6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/ -3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm -D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS -CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR -3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE= ------END CERTIFICATE----- - -# Issuer: CN=Secure Global CA O=SecureTrust Corporation -# Subject: CN=Secure Global CA O=SecureTrust Corporation -# Label: "Secure Global CA" -# Serial: 9751836167731051554232119481456978597 -# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de -# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b -# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69 ------BEGIN CERTIFICATE----- -MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK -MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x -GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx -MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg -Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG -SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ -iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa -/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ -jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI -HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7 -sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w -gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF -MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw -KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG -AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L -URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO -H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm -I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY -iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc -f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW ------END CERTIFICATE----- - -# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited -# Subject: CN=COMODO Certification Authority O=COMODO CA Limited -# Label: "COMODO Certification Authority" -# Serial: 104350513648249232941998508985834464573 -# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75 -# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b -# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66 ------BEGIN CERTIFICATE----- -MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB -gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G -A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV -BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw -MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl -YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P -RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0 -aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3 -UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI -2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8 -Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp -+2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+ -DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O -nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW -/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g -PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u -QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY -SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv -IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/ -RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4 -zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd -BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB -ZQ== ------END CERTIFICATE----- - -# Issuer: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C. -# Subject: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C. -# Label: "Network Solutions Certificate Authority" -# Serial: 116697915152937497490437556386812487904 -# MD5 Fingerprint: d3:f3:a6:16:c0:fa:6b:1d:59:b1:2d:96:4d:0e:11:2e -# SHA1 Fingerprint: 74:f8:a3:c3:ef:e7:b3:90:06:4b:83:90:3c:21:64:60:20:e5:df:ce -# SHA256 Fingerprint: 15:f0:ba:00:a3:ac:7a:f3:ac:88:4c:07:2b:10:11:a0:77:bd:77:c0:97:f4:01:64:b2:f8:59:8a:bd:83:86:0c ------BEGIN CERTIFICATE----- -MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBi -MQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu -MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3Jp -dHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMxMjM1OTU5WjBiMQswCQYDVQQGEwJV -UzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydO -ZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0GCSqG -SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwz -c7MEL7xxjOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPP -OCwGJgl6cvf6UDL4wpPTaaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rl -mGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXTcrA/vGp97Eh/jcOrqnErU2lBUzS1sLnF -BgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc/Qzpf14Dl847ABSHJ3A4 -qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMBAAGjgZcw -gZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIB -BjAPBgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwu -bmV0c29sc3NsLmNvbS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3Jp -dHkuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc8 -6fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q4LqILPxFzBiwmZVRDuwduIj/ -h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/GGUsyfJj4akH -/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv -wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHN -pGxlaKFJdlxDydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey ------END CERTIFICATE----- - -# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited -# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited -# Label: "COMODO ECC Certification Authority" -# Serial: 41578283867086692638256921589707938090 -# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23 -# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11 -# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7 ------BEGIN CERTIFICATE----- -MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL -MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE -BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT -IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw -MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy -ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N -T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv -biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR -FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J -cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW -BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ -BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm -fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv -GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY= ------END CERTIFICATE----- - -# Issuer: CN=OISTE WISeKey Global Root GA CA O=WISeKey OU=Copyright (c) 2005/OISTE Foundation Endorsed -# Subject: CN=OISTE WISeKey Global Root GA CA O=WISeKey OU=Copyright (c) 2005/OISTE Foundation Endorsed -# Label: "OISTE WISeKey Global Root GA CA" -# Serial: 86718877871133159090080555911823548314 -# MD5 Fingerprint: bc:6c:51:33:a7:e9:d3:66:63:54:15:72:1b:21:92:93 -# SHA1 Fingerprint: 59:22:a1:e1:5a:ea:16:35:21:f8:98:39:6a:46:46:b0:44:1b:0f:a9 -# SHA256 Fingerprint: 41:c9:23:86:6a:b4:ca:d6:b7:ad:57:80:81:58:2e:02:07:97:a6:cb:df:4f:ff:78:ce:83:96:b3:89:37:d7:f5 ------BEGIN CERTIFICATE----- -MIID8TCCAtmgAwIBAgIQQT1yx/RrH4FDffHSKFTfmjANBgkqhkiG9w0BAQUFADCB -ijELMAkGA1UEBhMCQ0gxEDAOBgNVBAoTB1dJU2VLZXkxGzAZBgNVBAsTEkNvcHly -aWdodCAoYykgMjAwNTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNl -ZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQSBDQTAeFw0w -NTEyMTExNjAzNDRaFw0zNzEyMTExNjA5NTFaMIGKMQswCQYDVQQGEwJDSDEQMA4G -A1UEChMHV0lTZUtleTEbMBkGA1UECxMSQ29weXJpZ2h0IChjKSAyMDA1MSIwIAYD -VQQLExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBX -SVNlS2V5IEdsb2JhbCBSb290IEdBIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A -MIIBCgKCAQEAy0+zAJs9Nt350UlqaxBJH+zYK7LG+DKBKUOVTJoZIyEVRd7jyBxR -VVuuk+g3/ytr6dTqvirdqFEr12bDYVxgAsj1znJ7O7jyTmUIms2kahnBAbtzptf2 -w93NvKSLtZlhuAGio9RN1AU9ka34tAhxZK9w8RxrfvbDd50kc3vkDIzh2TbhmYsF -mQvtRTEJysIA2/dyoJaqlYfQjse2YXMNdmaM3Bu0Y6Kff5MTMPGhJ9vZ/yxViJGg -4E8HsChWjBgbl0SOid3gF27nKu+POQoxhILYQBRJLnpB5Kf+42TMwVlxSywhp1t9 -4B3RLoGbw9ho972WG6xwsRYUC9tguSYBBQIDAQABo1EwTzALBgNVHQ8EBAMCAYYw -DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUswN+rja8sHnR3JQmthG+IbJphpQw -EAYJKwYBBAGCNxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBAEuh/wuHbrP5wUOx -SPMowB0uyQlB+pQAHKSkq0lPjz0e701vvbyk9vImMMkQyh2I+3QZH4VFvbBsUfk2 -ftv1TDI6QU9bR8/oCy22xBmddMVHxjtqD6wU2zz0c5ypBd8A3HR4+vg1YFkCExh8 -vPtNsCBtQ7tgMHpnM1zFmdH4LTlSc/uMqpclXHLZCB6rTjzjgTGfA6b7wP4piFXa -hNVQA7bihKOmNqoROgHhGEvWRGizPflTdISzRpFGlgC3gCy24eMQ4tui5yiPAZZi -Fj4A4xylNoEYokxSdsARo27mHbrjWr42U8U+dY+GaSlYU7Wcu2+fXMUY7N0v4ZjJ -/L7fCg0= ------END CERTIFICATE----- - -# Issuer: CN=Certigna O=Dhimyotis -# Subject: CN=Certigna O=Dhimyotis -# Label: "Certigna" -# Serial: 18364802974209362175 -# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff -# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97 -# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d ------BEGIN CERTIFICATE----- -MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV -BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X -DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ -BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3 -DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4 -QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny -gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw -zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q -130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2 -JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw -DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw -ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT -AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj -AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG -9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h -bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc -fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu -HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w -t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw -WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg== ------END CERTIFICATE----- - -# Issuer: CN=Deutsche Telekom Root CA 2 O=Deutsche Telekom AG OU=T-TeleSec Trust Center -# Subject: CN=Deutsche Telekom Root CA 2 O=Deutsche Telekom AG OU=T-TeleSec Trust Center -# Label: "Deutsche Telekom Root CA 2" -# Serial: 38 -# MD5 Fingerprint: 74:01:4a:91:b1:08:c4:58:ce:47:cd:f0:dd:11:53:08 -# SHA1 Fingerprint: 85:a4:08:c0:9c:19:3e:5d:51:58:7d:cd:d6:13:30:fd:8c:de:37:bf -# SHA256 Fingerprint: b6:19:1a:50:d0:c3:97:7f:7d:a9:9b:cd:aa:c8:6a:22:7d:ae:b9:67:9e:c7:0b:a3:b0:c9:d9:22:71:c1:70:d3 ------BEGIN CERTIFICATE----- -MIIDnzCCAoegAwIBAgIBJjANBgkqhkiG9w0BAQUFADBxMQswCQYDVQQGEwJERTEc -MBoGA1UEChMTRGV1dHNjaGUgVGVsZWtvbSBBRzEfMB0GA1UECxMWVC1UZWxlU2Vj -IFRydXN0IENlbnRlcjEjMCEGA1UEAxMaRGV1dHNjaGUgVGVsZWtvbSBSb290IENB -IDIwHhcNOTkwNzA5MTIxMTAwWhcNMTkwNzA5MjM1OTAwWjBxMQswCQYDVQQGEwJE -RTEcMBoGA1UEChMTRGV1dHNjaGUgVGVsZWtvbSBBRzEfMB0GA1UECxMWVC1UZWxl -U2VjIFRydXN0IENlbnRlcjEjMCEGA1UEAxMaRGV1dHNjaGUgVGVsZWtvbSBSb290 -IENBIDIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCrC6M14IspFLEU -ha88EOQ5bzVdSq7d6mGNlUn0b2SjGmBmpKlAIoTZ1KXleJMOaAGtuU1cOs7TuKhC -QN/Po7qCWWqSG6wcmtoIKyUn+WkjR/Hg6yx6m/UTAtB+NHzCnjwAWav12gz1Mjwr -rFDa1sPeg5TKqAyZMg4ISFZbavva4VhYAUlfckE8FQYBjl2tqriTtM2e66foai1S -NNs671x1Udrb8zH57nGYMsRUFUQM+ZtV7a3fGAigo4aKSe5TBY8ZTNXeWHmb0moc -QqvF1afPaA+W5OFhmHZhyJF81j4A4pFQh+GdCuatl9Idxjp9y7zaAzTVjlsB9WoH -txa2bkp/AgMBAAGjQjBAMB0GA1UdDgQWBBQxw3kbuvVT1xfgiXotF2wKsyudMzAP -BgNVHRMECDAGAQH/AgEFMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQUFAAOC -AQEAlGRZrTlk5ynrE/5aw4sTV8gEJPB0d8Bg42f76Ymmg7+Wgnxu1MM9756Abrsp -tJh6sTtU6zkXR34ajgv8HzFZMQSyzhfzLMdiNlXiItiJVbSYSKpk+tYcNthEeFpa -IzpXl/V6ME+un2pMSyuOoAPjPuCp1NJ70rOo4nI8rZ7/gFnkm0W09juwzTkZmDLl -6iFhkOQxIY40sfcvNUqFENrnijchvllj4PKFiDFT1FQUhXB59C4Gdyd1Lx+4ivn+ -xbrYNuSD7Odlt79jWvNGr4GUN9RBjNYj1h7P9WgbRGOiWrqnNVmh5XAFmw4jV5mU -Cm26OWMohpLzGITY+9HPBVZkVw== ------END CERTIFICATE----- - -# Issuer: CN=Cybertrust Global Root O=Cybertrust, Inc -# Subject: CN=Cybertrust Global Root O=Cybertrust, Inc -# Label: "Cybertrust Global Root" -# Serial: 4835703278459682877484360 -# MD5 Fingerprint: 72:e4:4a:87:e3:69:40:80:77:ea:bc:e3:f4:ff:f0:e1 -# SHA1 Fingerprint: 5f:43:e5:b1:bf:f8:78:8c:ac:1c:c7:ca:4a:9a:c6:22:2b:cc:34:c6 -# SHA256 Fingerprint: 96:0a:df:00:63:e9:63:56:75:0c:29:65:dd:0a:08:67:da:0b:9c:bd:6e:77:71:4a:ea:fb:23:49:ab:39:3d:a3 ------BEGIN CERTIFICATE----- -MIIDoTCCAomgAwIBAgILBAAAAAABD4WqLUgwDQYJKoZIhvcNAQEFBQAwOzEYMBYG -A1UEChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2Jh -bCBSb290MB4XDTA2MTIxNTA4MDAwMFoXDTIxMTIxNTA4MDAwMFowOzEYMBYGA1UE -ChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2JhbCBS -b290MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+Mi8vRRQZhP/8NN5 -7CPytxrHjoXxEnOmGaoQ25yiZXRadz5RfVb23CO21O1fWLE3TdVJDm71aofW0ozS -J8bi/zafmGWgE07GKmSb1ZASzxQG9Dvj1Ci+6A74q05IlG2OlTEQXO2iLb3VOm2y -HLtgwEZLAfVJrn5GitB0jaEMAs7u/OePuGtm839EAL9mJRQr3RAwHQeWP032a7iP -t3sMpTjr3kfb1V05/Iin89cqdPHoWqI7n1C6poxFNcJQZZXcY4Lv3b93TZxiyWNz -FtApD0mpSPCzqrdsxacwOUBdrsTiXSZT8M4cIwhhqJQZugRiQOwfOHB3EgZxpzAY -XSUnpQIDAQABo4GlMIGiMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/ -MB0GA1UdDgQWBBS2CHsNesysIEyGVjJez6tuhS1wVzA/BgNVHR8EODA2MDSgMqAw -hi5odHRwOi8vd3d3Mi5wdWJsaWMtdHJ1c3QuY29tL2NybC9jdC9jdHJvb3QuY3Js -MB8GA1UdIwQYMBaAFLYIew16zKwgTIZWMl7Pq26FLXBXMA0GCSqGSIb3DQEBBQUA -A4IBAQBW7wojoFROlZfJ+InaRcHUowAl9B8Tq7ejhVhpwjCt2BWKLePJzYFa+HMj -Wqd8BfP9IjsO0QbE2zZMcwSO5bAi5MXzLqXZI+O4Tkogp24CJJ8iYGd7ix1yCcUx -XOl5n4BHPa2hCwcUPUf/A2kaDAtE52Mlp3+yybh2hO0j9n0Hq0V+09+zv+mKts2o -omcrUtW3ZfA5TGOgkXmTUg9U3YO7n9GPp1Nzw8v/MOx8BLjYRB+TX3EJIrduPuoc -A06dGiBh+4E37F78CkWr1+cXVdCg6mCbpvbjjFspwgZgFJ0tl0ypkxWdYcQBX0jW -WL1WMRJOEcgh4LMRkWXbtKaIOM5V ------END CERTIFICATE----- - -# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority -# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority -# Label: "ePKI Root Certification Authority" -# Serial: 28956088682735189655030529057352760477 -# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3 -# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0 -# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5 ------BEGIN CERTIFICATE----- -MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe -MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0 -ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe -Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw -IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL -SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF -AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH -SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh -ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X -DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1 -TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ -fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA -sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU -WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS -nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH -dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip -NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC -AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF -MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH -ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB -uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl -PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP -JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/ -gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2 -j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6 -5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB -o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS -/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z -Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE -W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D -hNQ+IIX3Sj0rnP0qCglN6oH4EZw= ------END CERTIFICATE----- - -# Issuer: O=certSIGN OU=certSIGN ROOT CA -# Subject: O=certSIGN OU=certSIGN ROOT CA -# Label: "certSIGN ROOT CA" -# Serial: 35210227249154 -# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17 -# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b -# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb ------BEGIN CERTIFICATE----- -MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT -AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD -QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP -MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC -ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do -0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ -UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d -RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ -OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv -JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C -AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O -BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ -LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY -MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ -44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I -Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw -i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN -9u6wWk5JRFRYX0KD ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Primary Certification Authority - G3 O=GeoTrust Inc. OU=(c) 2008 GeoTrust Inc. - For authorized use only -# Subject: CN=GeoTrust Primary Certification Authority - G3 O=GeoTrust Inc. OU=(c) 2008 GeoTrust Inc. - For authorized use only -# Label: "GeoTrust Primary Certification Authority - G3" -# Serial: 28809105769928564313984085209975885599 -# MD5 Fingerprint: b5:e8:34:36:c9:10:44:58:48:70:6d:2e:83:d4:b8:05 -# SHA1 Fingerprint: 03:9e:ed:b8:0b:e7:a0:3c:69:53:89:3b:20:d2:d9:32:3a:4c:2a:fd -# SHA256 Fingerprint: b4:78:b8:12:25:0d:f8:78:63:5c:2a:a7:ec:7d:15:5e:aa:62:5e:e8:29:16:e2:cd:29:43:61:88:6c:d1:fb:d4 ------BEGIN CERTIFICATE----- -MIID/jCCAuagAwIBAgIQFaxulBmyeUtB9iepwxgPHzANBgkqhkiG9w0BAQsFADCB -mDELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xOTA3BgNVBAsT -MChjKSAyMDA4IEdlb1RydXN0IEluYy4gLSBGb3IgYXV0aG9yaXplZCB1c2Ugb25s -eTE2MDQGA1UEAxMtR2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhv -cml0eSAtIEczMB4XDTA4MDQwMjAwMDAwMFoXDTM3MTIwMTIzNTk1OVowgZgxCzAJ -BgNVBAYTAlVTMRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMTkwNwYDVQQLEzAoYykg -MjAwOCBHZW9UcnVzdCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxNjA0 -BgNVBAMTLUdlb1RydXN0IFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkg -LSBHMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANziXmJYHTNXOTIz -+uvLh4yn1ErdBojqZI4xmKU4kB6Yzy5jK/BGvESyiaHAKAxJcCGVn2TAppMSAmUm -hsalifD614SgcK9PGpc/BkTVyetyEH3kMSj7HGHmKAdEc5IiaacDiGydY8hS2pgn -5whMcD60yRLBxWeDXTPzAxHsatBT4tG6NmCUgLthY2xbF37fQJQeqw3CIShwiP/W -JmxsYAQlTlV+fe+/lEjetx3dcI0FX4ilm/LC7urRQEFtYjgdVgbFA0dRIBn8exAL -DmKudlW/X3e+PkkBUz2YJQN2JFodtNuJ6nnltrM7P7pMKEF/BqxqjsHQ9gUdfeZC -huOl1UcCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYw -HQYDVR0OBBYEFMR5yo6hTgMdHNxr2zFblD4/MH8tMA0GCSqGSIb3DQEBCwUAA4IB -AQAtxRPPVoB7eni9n64smefv2t+UXglpp+duaIy9cr5HqQ6XErhK8WTTOd8lNNTB -zU6B8A8ExCSzNJbGpqow32hhc9f5joWJ7w5elShKKiePEI4ufIbEAp7aDHdlDkQN -kv39sxY2+hENHYwOB4lqKVb3cvTdFZx3NWZXqxNT2I7BQMXXExZacse3aQHEerGD -AWh9jUGhlBjBJVz88P6DAod8DQ3PLghcSkANPuyBYeYk28rgDi0Hsj5W3I31QYUH -SJsMC8tJP33st/3LjWeJGqvtux6jAAgIFyqCXDFdRootD4abdNlF+9RAsXqqaC2G -spki4cErx5z481+oghLrGREt ------END CERTIFICATE----- - -# Issuer: CN=thawte Primary Root CA - G2 O=thawte, Inc. OU=(c) 2007 thawte, Inc. - For authorized use only -# Subject: CN=thawte Primary Root CA - G2 O=thawte, Inc. OU=(c) 2007 thawte, Inc. - For authorized use only -# Label: "thawte Primary Root CA - G2" -# Serial: 71758320672825410020661621085256472406 -# MD5 Fingerprint: 74:9d:ea:60:24:c4:fd:22:53:3e:cc:3a:72:d9:29:4f -# SHA1 Fingerprint: aa:db:bc:22:23:8f:c4:01:a1:27:bb:38:dd:f4:1d:db:08:9e:f0:12 -# SHA256 Fingerprint: a4:31:0d:50:af:18:a6:44:71:90:37:2a:86:af:af:8b:95:1f:fb:43:1d:83:7f:1e:56:88:b4:59:71:ed:15:57 ------BEGIN CERTIFICATE----- -MIICiDCCAg2gAwIBAgIQNfwmXNmET8k9Jj1Xm67XVjAKBggqhkjOPQQDAzCBhDEL -MAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjE4MDYGA1UECxMvKGMp -IDIwMDcgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxJDAi -BgNVBAMTG3RoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EgLSBHMjAeFw0wNzExMDUwMDAw -MDBaFw0zODAxMTgyMzU5NTlaMIGEMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMdGhh -d3RlLCBJbmMuMTgwNgYDVQQLEy8oYykgMjAwNyB0aGF3dGUsIEluYy4gLSBGb3Ig -YXV0aG9yaXplZCB1c2Ugb25seTEkMCIGA1UEAxMbdGhhd3RlIFByaW1hcnkgUm9v -dCBDQSAtIEcyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEotWcgnuVnfFSeIf+iha/ -BebfowJPDQfGAFG6DAJSLSKkQjnE/o/qycG+1E3/n3qe4rF8mq2nhglzh9HnmuN6 -papu+7qzcMBniKI11KOasf2twu8x+qi58/sIxpHR+ymVo0IwQDAPBgNVHRMBAf8E -BTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUmtgAMADna3+FGO6Lts6K -DPgR4bswCgYIKoZIzj0EAwMDaQAwZgIxAN344FdHW6fmCsO99YCKlzUNG4k8VIZ3 -KMqh9HneteY4sPBlcIx/AlTCv//YoT7ZzwIxAMSNlPzcU9LcnXgWHxUzI1NS41ox -XZ3Krr0TKUQNJ1uo52icEvdYPy5yAlejj6EULg== ------END CERTIFICATE----- - -# Issuer: CN=thawte Primary Root CA - G3 O=thawte, Inc. OU=Certification Services Division/(c) 2008 thawte, Inc. - For authorized use only -# Subject: CN=thawte Primary Root CA - G3 O=thawte, Inc. OU=Certification Services Division/(c) 2008 thawte, Inc. - For authorized use only -# Label: "thawte Primary Root CA - G3" -# Serial: 127614157056681299805556476275995414779 -# MD5 Fingerprint: fb:1b:5d:43:8a:94:cd:44:c6:76:f2:43:4b:47:e7:31 -# SHA1 Fingerprint: f1:8b:53:8d:1b:e9:03:b6:a6:f0:56:43:5b:17:15:89:ca:f3:6b:f2 -# SHA256 Fingerprint: 4b:03:f4:58:07:ad:70:f2:1b:fc:2c:ae:71:c9:fd:e4:60:4c:06:4c:f5:ff:b6:86:ba:e5:db:aa:d7:fd:d3:4c ------BEGIN CERTIFICATE----- -MIIEKjCCAxKgAwIBAgIQYAGXt0an6rS0mtZLL/eQ+zANBgkqhkiG9w0BAQsFADCB -rjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYGA1UECxMf -Q2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMvKGMpIDIw -MDggdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxJDAiBgNV -BAMTG3RoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EgLSBHMzAeFw0wODA0MDIwMDAwMDBa -Fw0zNzEyMDEyMzU5NTlaMIGuMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMdGhhd3Rl -LCBJbmMuMSgwJgYDVQQLEx9DZXJ0aWZpY2F0aW9uIFNlcnZpY2VzIERpdmlzaW9u -MTgwNgYDVQQLEy8oYykgMjAwOCB0aGF3dGUsIEluYy4gLSBGb3IgYXV0aG9yaXpl -ZCB1c2Ugb25seTEkMCIGA1UEAxMbdGhhd3RlIFByaW1hcnkgUm9vdCBDQSAtIEcz -MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsr8nLPvb2FvdeHsbnndm -gcs+vHyu86YnmjSjaDFxODNi5PNxZnmxqWWjpYvVj2AtP0LMqmsywCPLLEHd5N/8 -YZzic7IilRFDGF/Eth9XbAoFWCLINkw6fKXRz4aviKdEAhN0cXMKQlkC+BsUa0Lf -b1+6a4KinVvnSr0eAXLbS3ToO39/fR8EtCab4LRarEc9VbjXsCZSKAExQGbY2SS9 -9irY7CFJXJv2eul/VTV+lmuNk5Mny5K76qxAwJ/C+IDPXfRa3M50hqY+bAtTyr2S -zhkGcuYMXDhpxwTWvGzOW/b3aJzcJRVIiKHpqfiYnODz1TEoYRFsZ5aNOZnLwkUk -OQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNV -HQ4EFgQUrWyqlGCc7eT/+j4KdCtjA/e2Wb8wDQYJKoZIhvcNAQELBQADggEBABpA -2JVlrAmSicY59BDlqQ5mU1143vokkbvnRFHfxhY0Cu9qRFHqKweKA3rD6z8KLFIW -oCtDuSWQP3CpMyVtRRooOyfPqsMpQhvfO0zAMzRbQYi/aytlryjvsvXDqmbOe1bu -t8jLZ8HJnBoYuMTDSQPxYA5QzUbF83d597YV4Djbxy8ooAw/dyZ02SUS2jHaGh7c -KUGRIjxpp7sC8rZcJwOJ9Abqm+RyguOhCcHpABnTPtRwa7pxpqpYrvS76Wy274fM -m7v/OeZWYdMKp8RcTGB7BXcmer/YB1IsYvdwY9k5vG8cwnncdimvzsUsZAReiDZu -MdRAGmI0Nj81Aa6sY6A= ------END CERTIFICATE----- - -# Issuer: CN=GeoTrust Primary Certification Authority - G2 O=GeoTrust Inc. OU=(c) 2007 GeoTrust Inc. - For authorized use only -# Subject: CN=GeoTrust Primary Certification Authority - G2 O=GeoTrust Inc. OU=(c) 2007 GeoTrust Inc. - For authorized use only -# Label: "GeoTrust Primary Certification Authority - G2" -# Serial: 80682863203381065782177908751794619243 -# MD5 Fingerprint: 01:5e:d8:6b:bd:6f:3d:8e:a1:31:f8:12:e0:98:73:6a -# SHA1 Fingerprint: 8d:17:84:d5:37:f3:03:7d:ec:70:fe:57:8b:51:9a:99:e6:10:d7:b0 -# SHA256 Fingerprint: 5e:db:7a:c4:3b:82:a0:6a:87:61:e8:d7:be:49:79:eb:f2:61:1f:7d:d7:9b:f9:1c:1c:6b:56:6a:21:9e:d7:66 ------BEGIN CERTIFICATE----- -MIICrjCCAjWgAwIBAgIQPLL0SAoA4v7rJDteYD7DazAKBggqhkjOPQQDAzCBmDEL -MAkGA1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xOTA3BgNVBAsTMChj -KSAyMDA3IEdlb1RydXN0IEluYy4gLSBGb3IgYXV0aG9yaXplZCB1c2Ugb25seTE2 -MDQGA1UEAxMtR2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0 -eSAtIEcyMB4XDTA3MTEwNTAwMDAwMFoXDTM4MDExODIzNTk1OVowgZgxCzAJBgNV -BAYTAlVTMRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMTkwNwYDVQQLEzAoYykgMjAw -NyBHZW9UcnVzdCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxNjA0BgNV -BAMTLUdlb1RydXN0IFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgLSBH -MjB2MBAGByqGSM49AgEGBSuBBAAiA2IABBWx6P0DFUPlrOuHNxFi79KDNlJ9RVcL -So17VDs6bl8VAsBQps8lL33KSLjHUGMcKiEIfJo22Av+0SbFWDEwKCXzXV2juLal -tJLtbCyf691DiaI8S0iRHVDsJt/WYC69IaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO -BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFBVfNVdRVfslsq0DafwBo/q+EVXVMAoG -CCqGSM49BAMDA2cAMGQCMGSWWaboCd6LuvpaiIjwH5HTRqjySkwCY/tsXzjbLkGT -qQ7mndwxHLKgpxgceeHHNgIwOlavmnRs9vuD4DPTCF+hnMJbn0bWtsuRBmOiBucz -rD6ogRLQy7rQkgu2npaqBA+K ------END CERTIFICATE----- - -# Issuer: CN=VeriSign Universal Root Certification Authority O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2008 VeriSign, Inc. - For authorized use only -# Subject: CN=VeriSign Universal Root Certification Authority O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2008 VeriSign, Inc. - For authorized use only -# Label: "VeriSign Universal Root Certification Authority" -# Serial: 85209574734084581917763752644031726877 -# MD5 Fingerprint: 8e:ad:b5:01:aa:4d:81:e4:8c:1d:d1:e1:14:00:95:19 -# SHA1 Fingerprint: 36:79:ca:35:66:87:72:30:4d:30:a5:fb:87:3b:0f:a7:7b:b7:0d:54 -# SHA256 Fingerprint: 23:99:56:11:27:a5:71:25:de:8c:ef:ea:61:0d:df:2f:a0:78:b5:c8:06:7f:4e:82:82:90:bf:b8:60:e8:4b:3c ------BEGIN CERTIFICATE----- -MIIEuTCCA6GgAwIBAgIQQBrEZCGzEyEDDrvkEhrFHTANBgkqhkiG9w0BAQsFADCB -vTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQL -ExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwOCBWZXJp -U2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MTgwNgYDVQQDEy9W -ZXJpU2lnbiBVbml2ZXJzYWwgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe -Fw0wODA0MDIwMDAwMDBaFw0zNzEyMDEyMzU5NTlaMIG9MQswCQYDVQQGEwJVUzEX -MBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZlcmlTaWduIFRydXN0 -IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAyMDA4IFZlcmlTaWduLCBJbmMuIC0gRm9y -IGF1dGhvcml6ZWQgdXNlIG9ubHkxODA2BgNVBAMTL1ZlcmlTaWduIFVuaXZlcnNh -bCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEF -AAOCAQ8AMIIBCgKCAQEAx2E3XrEBNNti1xWb/1hajCMj1mCOkdeQmIN65lgZOIzF -9uVkhbSicfvtvbnazU0AtMgtc6XHaXGVHzk8skQHnOgO+k1KxCHfKWGPMiJhgsWH -H26MfF8WIFFE0XBPV+rjHOPMee5Y2A7Cs0WTwCznmhcrewA3ekEzeOEz4vMQGn+H -LL729fdC4uW/h2KJXwBL38Xd5HVEMkE6HnFuacsLdUYI0crSK5XQz/u5QGtkjFdN -/BMReYTtXlT2NJ8IAfMQJQYXStrxHXpma5hgZqTZ79IugvHw7wnqRMkVauIDbjPT -rJ9VAMf2CGqUuV/c4DPxhGD5WycRtPwW8rtWaoAljQIDAQABo4GyMIGvMA8GA1Ud -EwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMG0GCCsGAQUFBwEMBGEwX6FdoFsw -WTBXMFUWCWltYWdlL2dpZjAhMB8wBwYFKw4DAhoEFI/l0xqGrI2Oa8PPgGrUSBgs -exkuMCUWI2h0dHA6Ly9sb2dvLnZlcmlzaWduLmNvbS92c2xvZ28uZ2lmMB0GA1Ud -DgQWBBS2d/ppSEefUxLVwuoHMnYH0ZcHGTANBgkqhkiG9w0BAQsFAAOCAQEASvj4 -sAPmLGd75JR3Y8xuTPl9Dg3cyLk1uXBPY/ok+myDjEedO2Pzmvl2MpWRsXe8rJq+ -seQxIcaBlVZaDrHC1LGmWazxY8u4TB1ZkErvkBYoH1quEPuBUDgMbMzxPcP1Y+Oz -4yHJJDnp/RVmRvQbEdBNc6N9Rvk97ahfYtTxP/jgdFcrGJ2BtMQo2pSXpXDrrB2+ -BxHw1dvd5Yzw1TKwg+ZX4o+/vqGqvz0dtdQ46tewXDpPaj+PwGZsY6rp2aQW9IHR -lRQOfc2VNNnSj3BzgXucfr2YYdhFh5iQxeuGMMY1v/D/w1WIg0vvBZIGcfK4mJO3 -7M2CYfE45k+XmCpajQ== ------END CERTIFICATE----- - -# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G4 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2007 VeriSign, Inc. - For authorized use only -# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G4 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2007 VeriSign, Inc. - For authorized use only -# Label: "VeriSign Class 3 Public Primary Certification Authority - G4" -# Serial: 63143484348153506665311985501458640051 -# MD5 Fingerprint: 3a:52:e1:e7:fd:6f:3a:e3:6f:f3:6f:99:1b:f9:22:41 -# SHA1 Fingerprint: 22:d5:d8:df:8f:02:31:d1:8d:f7:9d:b7:cf:8a:2d:64:c9:3f:6c:3a -# SHA256 Fingerprint: 69:dd:d7:ea:90:bb:57:c9:3e:13:5d:c8:5e:a6:fc:d5:48:0b:60:32:39:bd:c4:54:fc:75:8b:2a:26:cf:7f:79 ------BEGIN CERTIFICATE----- -MIIDhDCCAwqgAwIBAgIQL4D+I4wOIg9IZxIokYesszAKBggqhkjOPQQDAzCByjEL -MAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZW -ZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNyBWZXJpU2ln -biwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJp -U2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9y -aXR5IC0gRzQwHhcNMDcxMTA1MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCByjELMAkG -A1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZWZXJp -U2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNyBWZXJpU2lnbiwg -SW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJpU2ln -biBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9yaXR5 -IC0gRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAASnVnp8Utpkmw4tXNherJI9/gHm -GUo9FANL+mAnINmDiWn6VMaaGF5VKmTeBvaNSjutEDxlPZCIBIngMGGzrl0Bp3ve -fLK+ymVhAIau2o970ImtTR1ZmkGxvEeA3J5iw/mjgbIwga8wDwYDVR0TAQH/BAUw -AwEB/zAOBgNVHQ8BAf8EBAMCAQYwbQYIKwYBBQUHAQwEYTBfoV2gWzBZMFcwVRYJ -aW1hZ2UvZ2lmMCEwHzAHBgUrDgMCGgQUj+XTGoasjY5rw8+AatRIGCx7GS4wJRYj -aHR0cDovL2xvZ28udmVyaXNpZ24uY29tL3ZzbG9nby5naWYwHQYDVR0OBBYEFLMW -kf3upm7ktS5Jj4d4gYDs5bG1MAoGCCqGSM49BAMDA2gAMGUCMGYhDBgmYFo4e1ZC -4Kf8NoRRkSAsdk1DPcQdhCPQrNZ8NQbOzWm9kA3bbEhCHQ6qQgIxAJw9SDkjOVga -FRJZap7v1VmyHVIsmXHNxynfGyphe3HR3vPA5Q06Sqotp9iGKt0uEA== ------END CERTIFICATE----- - -# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) -# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) -# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny" -# Serial: 80544274841616 -# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88 -# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91 -# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98 ------BEGIN CERTIFICATE----- -MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG -EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3 -MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl -cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR -dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB -pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM -b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm -aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz -IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A -MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT -lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz -AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5 -VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG -ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2 -BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG -AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M -U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh -bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C -+C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC -bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F -uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2 -XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E= ------END CERTIFICATE----- - -# Issuer: CN=Staat der Nederlanden Root CA - G2 O=Staat der Nederlanden -# Subject: CN=Staat der Nederlanden Root CA - G2 O=Staat der Nederlanden -# Label: "Staat der Nederlanden Root CA - G2" -# Serial: 10000012 -# MD5 Fingerprint: 7c:a5:0f:f8:5b:9a:7d:6d:30:ae:54:5a:e3:42:a2:8a -# SHA1 Fingerprint: 59:af:82:79:91:86:c7:b4:75:07:cb:cf:03:57:46:eb:04:dd:b7:16 -# SHA256 Fingerprint: 66:8c:83:94:7d:a6:3b:72:4b:ec:e1:74:3c:31:a0:e6:ae:d0:db:8e:c5:b3:1b:e3:77:bb:78:4f:91:b6:71:6f ------BEGIN CERTIFICATE----- -MIIFyjCCA7KgAwIBAgIEAJiWjDANBgkqhkiG9w0BAQsFADBaMQswCQYDVQQGEwJO -TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSswKQYDVQQDDCJTdGFh -dCBkZXIgTmVkZXJsYW5kZW4gUm9vdCBDQSAtIEcyMB4XDTA4MDMyNjExMTgxN1oX -DTIwMDMyNTExMDMxMFowWjELMAkGA1UEBhMCTkwxHjAcBgNVBAoMFVN0YWF0IGRl -ciBOZWRlcmxhbmRlbjErMCkGA1UEAwwiU3RhYXQgZGVyIE5lZGVybGFuZGVuIFJv -b3QgQ0EgLSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMVZ5291 -qj5LnLW4rJ4L5PnZyqtdj7U5EILXr1HgO+EASGrP2uEGQxGZqhQlEq0i6ABtQ8Sp -uOUfiUtnvWFI7/3S4GCI5bkYYCjDdyutsDeqN95kWSpGV+RLufg3fNU254DBtvPU -Z5uW6M7XxgpT0GtJlvOjCwV3SPcl5XCsMBQgJeN/dVrlSPhOewMHBPqCYYdu8DvE -pMfQ9XQ+pV0aCPKbJdL2rAQmPlU6Yiile7Iwr/g3wtG61jj99O9JMDeZJiFIhQGp -5Rbn3JBV3w/oOM2ZNyFPXfUib2rFEhZgF1XyZWampzCROME4HYYEhLoaJXhena/M -UGDWE4dS7WMfbWV9whUYdMrhfmQpjHLYFhN9C0lK8SgbIHRrxT3dsKpICT0ugpTN -GmXZK4iambwYfp/ufWZ8Pr2UuIHOzZgweMFvZ9C+X+Bo7d7iscksWXiSqt8rYGPy -5V6548r6f1CGPqI0GAwJaCgRHOThuVw+R7oyPxjMW4T182t0xHJ04eOLoEq9jWYv -6q012iDTiIJh8BIitrzQ1aTsr1SIJSQ8p22xcik/Plemf1WvbibG/ufMQFxRRIEK -eN5KzlW/HdXZt1bv8Hb/C3m1r737qWmRRpdogBQ2HbN/uymYNqUg+oJgYjOk7Na6 -B6duxc8UpufWkjTYgfX8HV2qXB72o007uPc5AgMBAAGjgZcwgZQwDwYDVR0TAQH/ -BAUwAwEB/zBSBgNVHSAESzBJMEcGBFUdIAAwPzA9BggrBgEFBQcCARYxaHR0cDov -L3d3dy5wa2lvdmVyaGVpZC5ubC9wb2xpY2llcy9yb290LXBvbGljeS1HMjAOBgNV -HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJFoMocVHYnitfGsNig0jQt8YojrMA0GCSqG -SIb3DQEBCwUAA4ICAQCoQUpnKpKBglBu4dfYszk78wIVCVBR7y29JHuIhjv5tLyS -CZa59sCrI2AGeYwRTlHSeYAz+51IvuxBQ4EffkdAHOV6CMqqi3WtFMTC6GY8ggen -5ieCWxjmD27ZUD6KQhgpxrRW/FYQoAUXvQwjf/ST7ZwaUb7dRUG/kSS0H4zpX897 -IZmflZ85OkYcbPnNe5yQzSipx6lVu6xiNGI1E0sUOlWDuYaNkqbG9AclVMwWVxJK -gnjIFNkXgiYtXSAfea7+1HAWFpWD2DU5/1JddRwWxRNVz0fMdWVSSt7wsKfkCpYL -+63C4iWEst3kvX5ZbJvw8NjnyvLplzh+ib7M+zkXYT9y2zqR2GUBGR2tUKRXCnxL -vJxxcypFURmFzI79R6d0lR2o0a9OF7FpJsKqeFdbxU2n5Z4FF5TKsl+gSRiNNOkm -bEgeqmiSBeGCc1qb3AdbCG19ndeNIdn8FCCqwkXfP+cAslHkwvgFuXkajDTznlvk -N1trSt8sV4pAWja63XVECDdCcAz+3F4hoKOKwJCcaNpQ5kUQR3i2TtJlycM33+FC -Y7BXN0Ute4qcvwXqZVUz9zkQxSgqIXobisQk+T8VyJoVIPVVYpbtbZNQvOSqeK3Z -ywplh6ZmwcSBo3c6WB4L7oOLnR7SUqTMHW+wmG2UMbX4cQrcufx9MmDm66+KAQ== ------END CERTIFICATE----- - -# Issuer: CN=Hongkong Post Root CA 1 O=Hongkong Post -# Subject: CN=Hongkong Post Root CA 1 O=Hongkong Post -# Label: "Hongkong Post Root CA 1" -# Serial: 1000 -# MD5 Fingerprint: a8:0d:6f:39:78:b9:43:6d:77:42:6d:98:5a:cc:23:ca -# SHA1 Fingerprint: d6:da:a8:20:8d:09:d2:15:4d:24:b5:2f:cb:34:6e:b2:58:b2:8a:58 -# SHA256 Fingerprint: f9:e6:7d:33:6c:51:00:2a:c0:54:c6:32:02:2d:66:dd:a2:e7:e3:ff:f1:0a:d0:61:ed:31:d8:bb:b4:10:cf:b2 ------BEGIN CERTIFICATE----- -MIIDMDCCAhigAwIBAgICA+gwDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCSEsx -FjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3Qg -Um9vdCBDQSAxMB4XDTAzMDUxNTA1MTMxNFoXDTIzMDUxNTA0NTIyOVowRzELMAkG -A1UEBhMCSEsxFjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdr -b25nIFBvc3QgUm9vdCBDQSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC -AQEArP84tulmAknjorThkPlAj3n54r15/gK97iSSHSL22oVyaf7XPwnU3ZG1ApzQ -jVrhVcNQhrkpJsLj2aDxaQMoIIBFIi1WpztUlVYiWR8o3x8gPW2iNr4joLFutbEn -PzlTCeqrauh0ssJlXI6/fMN4hM2eFvz1Lk8gKgifd/PFHsSaUmYeSF7jEAaPIpjh -ZY4bXSNmO7ilMlHIhqqhqZ5/dpTCpmy3QfDVyAY45tQM4vM7TG1QjMSDJ8EThFk9 -nnV0ttgCXjqQesBCNnLsak3c78QA3xMYV18meMjWCnl3v/evt3a5pQuEF10Q6m/h -q5URX208o1xNg1vysxmKgIsLhwIDAQABoyYwJDASBgNVHRMBAf8ECDAGAQH/AgED -MA4GA1UdDwEB/wQEAwIBxjANBgkqhkiG9w0BAQUFAAOCAQEADkbVPK7ih9legYsC -mEEIjEy82tvuJxuC52pF7BaLT4Wg87JwvVqWuspube5Gi27nKi6Wsxkz67SfqLI3 -7piol7Yutmcn1KZJ/RyTZXaeQi/cImyaT/JaFTmxcdcrUehtHJjA2Sr0oYJ71clB -oiMBdDhViw+5LmeiIAQ32pwL0xch4I+XeTRvhEgCIDMb5jREn5Fw9IBehEPCKdJs -EhTkYY2sEJCehFC78JZvRZ+K88psT/oROhUVRsPNH4NbLUES7VBnQRM9IauUiqpO -fMGx+6fWtScvl6tu4B3i0RwsH0Ti/L6RoZz71ilTc4afU9hDDl3WY4JxHYB0yvbi -AmvZWg== ------END CERTIFICATE----- - -# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc. -# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc. -# Label: "SecureSign RootCA11" -# Serial: 1 -# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26 -# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3 -# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12 ------BEGIN CERTIFICATE----- -MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr -MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG -A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0 -MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp -Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD -QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz -i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8 -h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV -MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9 -UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni -8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC -h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD -VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB -AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm -KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ -X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr -QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5 -pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN -QSdJQO7e5iNEOdyhIta6A/I= ------END CERTIFICATE----- - -# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd. -# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd. -# Label: "Microsec e-Szigno Root CA 2009" -# Serial: 14014712776195784473 -# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1 -# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e -# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78 ------BEGIN CERTIFICATE----- -MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD -VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0 -ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G -CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y -OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx -FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp -Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o -dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP -kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc -cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U -fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7 -N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC -xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1 -+rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G -A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM -Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG -SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h -mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk -ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775 -tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c -2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t -HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW ------END CERTIFICATE----- - -# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 -# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3 -# Label: "GlobalSign Root CA - R3" -# Serial: 4835703278459759426209954 -# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28 -# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad -# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b ------BEGIN CERTIFICATE----- -MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G -A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp -Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4 -MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG -A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI -hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8 -RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT -gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm -KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd -QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ -XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw -DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o -LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU -RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp -jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK -6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX -mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs -Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH -WD9f ------END CERTIFICATE----- - -# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 -# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068 -# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068" -# Serial: 6047274297262753887 -# MD5 Fingerprint: 73:3a:74:7a:ec:bb:a3:96:a6:c2:e4:e2:c8:9b:c0:c3 -# SHA1 Fingerprint: ae:c5:fb:3f:c8:e1:bf:c4:e5:4f:03:07:5a:9a:e8:00:b7:f7:b6:fa -# SHA256 Fingerprint: 04:04:80:28:bf:1f:28:64:d4:8f:9a:d4:d8:32:94:36:6a:82:88:56:55:3f:3b:14:30:3f:90:14:7f:5d:40:ef ------BEGIN CERTIFICATE----- -MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UE -BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h -cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEy -MzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg -Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi -MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9 -thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM -cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG -L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i -NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h -X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b -m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy -Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja -EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T -KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF -6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh -OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1UdEwEB/wQIMAYBAf8CAQEwDgYD -VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNHDhpkLzCBpgYD -VR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp -cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBv -ACAAZABlACAAbABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBl -AGwAbwBuAGEAIAAwADgAMAAxADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF -661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx51tkljYyGOylMnfX40S2wBEqgLk9 -am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qkR71kMrv2JYSiJ0L1 -ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaPT481 -PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS -3a/DTg4fJl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5k -SeTy36LssUzAKh3ntLFlosS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF -3dvd6qJ2gHN99ZwExEWN57kci57q13XRcrHedUTnQn3iV2t93Jm8PYMo6oCTjcVM -ZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoRsaS8I8nkvof/uZS2+F0g -StRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTDKCOM/icz -Q0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQB -jLMi6Et8Vcad+qMUu2WFbm5PEn4KPJ2V ------END CERTIFICATE----- - -# Issuer: CN=Izenpe.com O=IZENPE S.A. -# Subject: CN=Izenpe.com O=IZENPE S.A. -# Label: "Izenpe.com" -# Serial: 917563065490389241595536686991402621 -# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73 -# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19 -# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f ------BEGIN CERTIFICATE----- -MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4 -MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6 -ZW5wZS5jb20wHhcNMDcxMjEzMTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYD -VQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5j -b20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ03rKDx6sp4boFmVq -scIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAKClaO -xdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6H -LmYRY2xU+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFX -uaOKmMPsOzTFlUFpfnXCPCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQD -yCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxTOTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+ -JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbKF7jJeodWLBoBHmy+E60Q -rLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK0GqfvEyN -BjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8L -hij+0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIB -QFqNeb+Lz0vPqhbBleStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+ -HMh3/1uaD7euBUbl8agW7EekFwIDAQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2lu -Zm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+SVpFTlBFIFMuQS4gLSBDSUYg -QTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBGNjIgUzgxQzBB -BgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx -MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC -AQYwHQYDVR0OBBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUA -A4ICAQB4pgwWSp9MiDrAyw6lFn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWb -laQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbgakEyrkgPH7UIBzg/YsfqikuFgba56 -awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8qhT/AQKM6WfxZSzwo -JNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Csg1lw -LDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCT -VyvehQP5aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGk -LhObNA5me0mrZJfQRsN5nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJb -UjWumDqtujWTI6cfSN01RpiyEGjkpTHCClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/ -QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZoQ0iy2+tzJOeRf1SktoA+ -naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1ZWrOZyGls -QyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw== ------END CERTIFICATE----- - -# Issuer: CN=Chambers of Commerce Root - 2008 O=AC Camerfirma S.A. -# Subject: CN=Chambers of Commerce Root - 2008 O=AC Camerfirma S.A. -# Label: "Chambers of Commerce Root - 2008" -# Serial: 11806822484801597146 -# MD5 Fingerprint: 5e:80:9e:84:5a:0e:65:0b:17:02:f3:55:18:2a:3e:d7 -# SHA1 Fingerprint: 78:6a:74:ac:76:ab:14:7f:9c:6a:30:50:ba:9e:a8:7e:fe:9a:ce:3c -# SHA256 Fingerprint: 06:3e:4a:fa:c4:91:df:d3:32:f3:08:9b:85:42:e9:46:17:d8:93:d7:fe:94:4e:10:a7:93:7e:e2:9d:96:93:c0 ------BEGIN CERTIFICATE----- -MIIHTzCCBTegAwIBAgIJAKPaQn6ksa7aMA0GCSqGSIb3DQEBBQUAMIGuMQswCQYD -VQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3VycmVudCBhZGRyZXNzIGF0 -IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAGA1UEBRMJQTgyNzQzMjg3 -MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xKTAnBgNVBAMTIENoYW1iZXJz -IG9mIENvbW1lcmNlIFJvb3QgLSAyMDA4MB4XDTA4MDgwMTEyMjk1MFoXDTM4MDcz -MTEyMjk1MFowga4xCzAJBgNVBAYTAkVVMUMwQQYDVQQHEzpNYWRyaWQgKHNlZSBj -dXJyZW50IGFkZHJlc3MgYXQgd3d3LmNhbWVyZmlybWEuY29tL2FkZHJlc3MpMRIw -EAYDVQQFEwlBODI3NDMyODcxGzAZBgNVBAoTEkFDIENhbWVyZmlybWEgUy5BLjEp -MCcGA1UEAxMgQ2hhbWJlcnMgb2YgQ29tbWVyY2UgUm9vdCAtIDIwMDgwggIiMA0G -CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCvAMtwNyuAWko6bHiUfaN/Gh/2NdW9 -28sNRHI+JrKQUrpjOyhYb6WzbZSm891kDFX29ufyIiKAXuFixrYp4YFs8r/lfTJq -VKAyGVn+H4vXPWCGhSRv4xGzdz4gljUha7MI2XAuZPeEklPWDrCQiorjh40G072Q -DuKZoRuGDtqaCrsLYVAGUvGef3bsyw/QHg3PmTA9HMRFEFis1tPo1+XqxQEHd9ZR -5gN/ikilTWh1uem8nk4ZcfUyS5xtYBkL+8ydddy/Js2Pk3g5eXNeJQ7KXOt3EgfL -ZEFHcpOrUMPrCXZkNNI5t3YRCQ12RcSprj1qr7V9ZS+UWBDsXHyvfuK2GNnQm05a -Sd+pZgvMPMZ4fKecHePOjlO+Bd5gD2vlGts/4+EhySnB8esHnFIbAURRPHsl18Tl -UlRdJQfKFiC4reRB7noI/plvg6aRArBsNlVq5331lubKgdaX8ZSD6e2wsWsSaR6s -+12pxZjptFtYer49okQ6Y1nUCyXeG0+95QGezdIp1Z8XGQpvvwyQ0wlf2eOKNcx5 -Wk0ZN5K3xMGtr/R5JJqyAQuxr1yW84Ay+1w9mPGgP0revq+ULtlVmhduYJ1jbLhj -ya6BXBg14JC7vjxPNyK5fuvPnnchpj04gftI2jE9K+OJ9dC1vX7gUMQSibMjmhAx -hduub+84Mxh2EQIDAQABo4IBbDCCAWgwEgYDVR0TAQH/BAgwBgEB/wIBDDAdBgNV -HQ4EFgQU+SSsD7K1+HnA+mCIG8TZTQKeFxkwgeMGA1UdIwSB2zCB2IAU+SSsD7K1 -+HnA+mCIG8TZTQKeFxmhgbSkgbEwga4xCzAJBgNVBAYTAkVVMUMwQQYDVQQHEzpN -YWRyaWQgKHNlZSBjdXJyZW50IGFkZHJlc3MgYXQgd3d3LmNhbWVyZmlybWEuY29t -L2FkZHJlc3MpMRIwEAYDVQQFEwlBODI3NDMyODcxGzAZBgNVBAoTEkFDIENhbWVy -ZmlybWEgUy5BLjEpMCcGA1UEAxMgQ2hhbWJlcnMgb2YgQ29tbWVyY2UgUm9vdCAt -IDIwMDiCCQCj2kJ+pLGu2jAOBgNVHQ8BAf8EBAMCAQYwPQYDVR0gBDYwNDAyBgRV -HSAAMCowKAYIKwYBBQUHAgEWHGh0dHA6Ly9wb2xpY3kuY2FtZXJmaXJtYS5jb20w -DQYJKoZIhvcNAQEFBQADggIBAJASryI1wqM58C7e6bXpeHxIvj99RZJe6dqxGfwW -PJ+0W2aeaufDuV2I6A+tzyMP3iU6XsxPpcG1Lawk0lgH3qLPaYRgM+gQDROpI9CF -5Y57pp49chNyM/WqfcZjHwj0/gF/JM8rLFQJ3uIrbZLGOU8W6jx+ekbURWpGqOt1 -glanq6B8aBMz9p0w8G8nOSQjKpD9kCk18pPfNKXG9/jvjA9iSnyu0/VU+I22mlaH -FoI6M6taIgj3grrqLuBHmrS1RaMFO9ncLkVAO+rcf+g769HsJtg1pDDFOqxXnrN2 -pSB7+R5KBWIBpih1YJeSDW4+TTdDDZIVnBgizVGZoCkaPF+KMjNbMMeJL0eYD6MD -xvbxrN8y8NmBGuScvfaAFPDRLLmF9dijscilIeUcE5fuDr3fKanvNFNb0+RqE4QG -tjICxFKuItLcsiFCGtpA8CnJ7AoMXOLQusxI0zcKzBIKinmwPQN/aUv0NCB9szTq -jktk9T79syNnFQ0EuPAtwQlRPLJsFfClI9eDdOTlLsn+mCdCxqvGnrDQWzilm1De -fhiYtUU79nm06PcaewaD+9CL2rvHvRirCG88gGtAPxkZumWK5r7VXNM21+9AUiRg -OGcEMeyP84LG3rlV8zsxkVrctQgVrXYlCg17LofiDKYGvCYQbTed7N14jHyAxfDZ -d0jQ ------END CERTIFICATE----- - -# Issuer: CN=Global Chambersign Root - 2008 O=AC Camerfirma S.A. -# Subject: CN=Global Chambersign Root - 2008 O=AC Camerfirma S.A. -# Label: "Global Chambersign Root - 2008" -# Serial: 14541511773111788494 -# MD5 Fingerprint: 9e:80:ff:78:01:0c:2e:c1:36:bd:fe:96:90:6e:08:f3 -# SHA1 Fingerprint: 4a:bd:ee:ec:95:0d:35:9c:89:ae:c7:52:a1:2c:5b:29:f6:d6:aa:0c -# SHA256 Fingerprint: 13:63:35:43:93:34:a7:69:80:16:a0:d3:24:de:72:28:4e:07:9d:7b:52:20:bb:8f:bd:74:78:16:ee:be:ba:ca ------BEGIN CERTIFICATE----- -MIIHSTCCBTGgAwIBAgIJAMnN0+nVfSPOMA0GCSqGSIb3DQEBBQUAMIGsMQswCQYD -VQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3VycmVudCBhZGRyZXNzIGF0 -IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAGA1UEBRMJQTgyNzQzMjg3 -MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xJzAlBgNVBAMTHkdsb2JhbCBD -aGFtYmVyc2lnbiBSb290IC0gMjAwODAeFw0wODA4MDExMjMxNDBaFw0zODA3MzEx -MjMxNDBaMIGsMQswCQYDVQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3Vy -cmVudCBhZGRyZXNzIGF0IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAG -A1UEBRMJQTgyNzQzMjg3MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xJzAl -BgNVBAMTHkdsb2JhbCBDaGFtYmVyc2lnbiBSb290IC0gMjAwODCCAiIwDQYJKoZI -hvcNAQEBBQADggIPADCCAgoCggIBAMDfVtPkOpt2RbQT2//BthmLN0EYlVJH6xed -KYiONWwGMi5HYvNJBL99RDaxccy9Wglz1dmFRP+RVyXfXjaOcNFccUMd2drvXNL7 -G706tcuto8xEpw2uIRU/uXpbknXYpBI4iRmKt4DS4jJvVpyR1ogQC7N0ZJJ0YPP2 -zxhPYLIj0Mc7zmFLmY/CDNBAspjcDahOo7kKrmCgrUVSY7pmvWjg+b4aqIG7HkF4 -ddPB/gBVsIdU6CeQNR1MM62X/JcumIS/LMmjv9GYERTtY/jKmIhYF5ntRQOXfjyG -HoiMvvKRhI9lNNgATH23MRdaKXoKGCQwoze1eqkBfSbW+Q6OWfH9GzO1KTsXO0G2 -Id3UwD2ln58fQ1DJu7xsepeY7s2MH/ucUa6LcL0nn3HAa6x9kGbo1106DbDVwo3V -yJ2dwW3Q0L9R5OP4wzg2rtandeavhENdk5IMagfeOx2YItaswTXbo6Al/3K1dh3e -beksZixShNBFks4c5eUzHdwHU1SjqoI7mjcv3N2gZOnm3b2u/GSFHTynyQbehP9r -6GsaPMWis0L7iwk+XwhSx2LE1AVxv8Rk5Pihg+g+EpuoHtQ2TS9x9o0o9oOpE9Jh -wZG7SMA0j0GMS0zbaRL/UJScIINZc+18ofLx/d33SdNDWKBWY8o9PeU1VlnpDsog -zCtLkykPAgMBAAGjggFqMIIBZjASBgNVHRMBAf8ECDAGAQH/AgEMMB0GA1UdDgQW -BBS5CcqcHtvTbDprru1U8VuTBjUuXjCB4QYDVR0jBIHZMIHWgBS5CcqcHtvTbDpr -ru1U8VuTBjUuXqGBsqSBrzCBrDELMAkGA1UEBhMCRVUxQzBBBgNVBAcTOk1hZHJp -ZCAoc2VlIGN1cnJlbnQgYWRkcmVzcyBhdCB3d3cuY2FtZXJmaXJtYS5jb20vYWRk -cmVzcykxEjAQBgNVBAUTCUE4Mjc0MzI4NzEbMBkGA1UEChMSQUMgQ2FtZXJmaXJt -YSBTLkEuMScwJQYDVQQDEx5HbG9iYWwgQ2hhbWJlcnNpZ24gUm9vdCAtIDIwMDiC -CQDJzdPp1X0jzjAOBgNVHQ8BAf8EBAMCAQYwPQYDVR0gBDYwNDAyBgRVHSAAMCow -KAYIKwYBBQUHAgEWHGh0dHA6Ly9wb2xpY3kuY2FtZXJmaXJtYS5jb20wDQYJKoZI -hvcNAQEFBQADggIBAICIf3DekijZBZRG/5BXqfEv3xoNa/p8DhxJJHkn2EaqbylZ -UohwEurdPfWbU1Rv4WCiqAm57OtZfMY18dwY6fFn5a+6ReAJ3spED8IXDneRRXoz -X1+WLGiLwUePmJs9wOzL9dWCkoQ10b42OFZyMVtHLaoXpGNR6woBrX/sdZ7LoR/x -fxKxueRkf2fWIyr0uDldmOghp+G9PUIadJpwr2hsUF1Jz//7Dl3mLEfXgTpZALVz -a2Mg9jFFCDkO9HB+QHBaP9BrQql0PSgvAm11cpUJjUhjxsYjV5KTXjXBjfkK9yyd -Yhz2rXzdpjEetrHHfoUm+qRqtdpjMNHvkzeyZi99Bffnt0uYlDXA2TopwZ2yUDMd -SqlapskD7+3056huirRXhOukP9DuqqqHW2Pok+JrqNS4cnhrG+055F3Lm6qH1U9O -AP7Zap88MQ8oAgF9mOinsKJknnn4SPIVqczmyETrP3iZ8ntxPjzxmKfFGBI/5rso -M0LpRQp8bfKGeS/Fghl9CYl8slR2iK7ewfPM4W7bMdaTrpmg7yVqc5iJWzouE4ge -v8CSlDQb4ye3ix5vQv/n6TebUB0tovkC7stYWDpxvGjjqsGvHCgfotwjZT+B6q6Z -09gwzxMNTxXJhLynSC34MCN32EZLeW32jO06f2ARePTpm67VVMB0gNELQp/B ------END CERTIFICATE----- - -# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. -# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc. -# Label: "Go Daddy Root Certificate Authority - G2" -# Serial: 0 -# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01 -# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b -# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da ------BEGIN CERTIFICATE----- -MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx -EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT -EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp -ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz -NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH -EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE -AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw -DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD -E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH -/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy -DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh -GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR -tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA -AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE -FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX -WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu -9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr -gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo -2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO -LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI -4uJEvlz36hz1 ------END CERTIFICATE----- - -# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. -# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc. -# Label: "Starfield Root Certificate Authority - G2" -# Serial: 0 -# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96 -# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e -# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5 ------BEGIN CERTIFICATE----- -MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx -EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT -HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs -ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw -MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6 -b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj -aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp -Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC -ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg -nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1 -HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N -Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN -dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0 -HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO -BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G -CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU -sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3 -4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg -8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K -pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1 -mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0 ------END CERTIFICATE----- - -# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. -# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc. -# Label: "Starfield Services Root Certificate Authority - G2" -# Serial: 0 -# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2 -# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f -# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5 ------BEGIN CERTIFICATE----- -MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx -EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT -HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs -ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5 -MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD -VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy -ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy -dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI -hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p -OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2 -8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K -Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe -hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk -6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw -DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q -AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI -bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB -ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z -qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd -iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn -0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN -sSi6 ------END CERTIFICATE----- - -# Issuer: CN=AffirmTrust Commercial O=AffirmTrust -# Subject: CN=AffirmTrust Commercial O=AffirmTrust -# Label: "AffirmTrust Commercial" -# Serial: 8608355977964138876 -# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7 -# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7 -# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7 ------BEGIN CERTIFICATE----- -MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE -BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz -dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL -MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp -cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC -AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP -Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr -ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL -MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1 -yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr -VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/ -nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ -KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG -XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj -vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt -Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g -N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC -nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8= ------END CERTIFICATE----- - -# Issuer: CN=AffirmTrust Networking O=AffirmTrust -# Subject: CN=AffirmTrust Networking O=AffirmTrust -# Label: "AffirmTrust Networking" -# Serial: 8957382827206547757 -# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f -# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f -# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b ------BEGIN CERTIFICATE----- -MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE -BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz -dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL -MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp -cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC -AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y -YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua -kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL -QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp -6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG -yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i -QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ -KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO -tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu -QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ -Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u -olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48 -x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s= ------END CERTIFICATE----- - -# Issuer: CN=AffirmTrust Premium O=AffirmTrust -# Subject: CN=AffirmTrust Premium O=AffirmTrust -# Label: "AffirmTrust Premium" -# Serial: 7893706540734352110 -# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57 -# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27 -# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a ------BEGIN CERTIFICATE----- -MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE -BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz -dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG -A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U -cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf -qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ -JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ -+jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS -s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5 -HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7 -70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG -V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S -qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S -5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia -C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX -OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE -FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ -BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2 -KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg -Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B -8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ -MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc -0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ -u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF -u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH -YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8 -GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO -RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e -KeC2uAloGRwYQw== ------END CERTIFICATE----- - -# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust -# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust -# Label: "AffirmTrust Premium ECC" -# Serial: 8401224907861490260 -# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d -# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb -# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23 ------BEGIN CERTIFICATE----- -MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC -VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ -cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ -BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt -VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D -0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9 -ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G -A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G -A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs -aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I -flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ== ------END CERTIFICATE----- - -# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority -# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority -# Label: "Certum Trusted Network CA" -# Serial: 279744 -# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78 -# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e -# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e ------BEGIN CERTIFICATE----- -MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM -MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D -ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU -cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3 -WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg -Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw -IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B -AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH -UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM -TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU -BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM -kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x -AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV -HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV -HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y -sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL -I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8 -J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY -VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI -03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw= ------END CERTIFICATE----- - -# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA -# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA -# Label: "TWCA Root Certification Authority" -# Serial: 1 -# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79 -# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48 -# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44 ------BEGIN CERTIFICATE----- -MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES -MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU -V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz -WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO -LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm -aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB -AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE -AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH -K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX -RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z -rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx -3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV -HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq -hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC -MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls -XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D -lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn -aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ -YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw== ------END CERTIFICATE----- - -# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 -# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2 -# Label: "Security Communication RootCA2" -# Serial: 0 -# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43 -# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74 -# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6 ------BEGIN CERTIFICATE----- -MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl -MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe -U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX -DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy -dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj -YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV -OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr -zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM -VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ -hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO -ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw -awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs -OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3 -DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF -coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc -okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8 -t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy -1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/ -SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03 ------END CERTIFICATE----- - -# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority -# Subject: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority -# Label: "Hellenic Academic and Research Institutions RootCA 2011" -# Serial: 0 -# MD5 Fingerprint: 73:9f:4c:4b:73:5b:79:e9:fa:ba:1c:ef:6e:cb:d5:c9 -# SHA1 Fingerprint: fe:45:65:9b:79:03:5b:98:a1:61:b5:51:2e:ac:da:58:09:48:22:4d -# SHA256 Fingerprint: bc:10:4f:15:a4:8b:e7:09:dc:a5:42:a7:e1:d4:b9:df:6f:05:45:27:e8:02:ea:a9:2d:59:54:44:25:8a:fe:71 ------BEGIN CERTIFICATE----- -MIIEMTCCAxmgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBlTELMAkGA1UEBhMCR1Ix -RDBCBgNVBAoTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1 -dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUAwPgYDVQQDEzdIZWxsZW5pYyBBY2FkZW1p -YyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIFJvb3RDQSAyMDExMB4XDTExMTIw -NjEzNDk1MloXDTMxMTIwMTEzNDk1MlowgZUxCzAJBgNVBAYTAkdSMUQwQgYDVQQK -EztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIENl -cnQuIEF1dGhvcml0eTFAMD4GA1UEAxM3SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl -c2VhcmNoIEluc3RpdHV0aW9ucyBSb290Q0EgMjAxMTCCASIwDQYJKoZIhvcNAQEB -BQADggEPADCCAQoCggEBAKlTAOMupvaO+mDYLZU++CwqVE7NuYRhlFhPjz2L5EPz -dYmNUeTDN9KKiE15HrcS3UN4SoqS5tdI1Q+kOilENbgH9mgdVc04UfCMJDGFr4PJ -fel3r+0ae50X+bOdOFAPplp5kYCvN66m0zH7tSYJnTxa71HFK9+WXesyHgLacEns -bgzImjeN9/E2YEsmLIKe0HjzDQ9jpFEw4fkrJxIH2Oq9GGKYsFk3fb7u8yBRQlqD -75O6aRXxYp2fmTmCobd0LovUxQt7L/DICto9eQqakxylKHJzkUOap9FNhYS5qXSP -FEDH3N6sQWRstBmbAmNtJGSPRLIl6s5ddAxjMlyNh+UCAwEAAaOBiTCBhjAPBgNV -HRMBAf8EBTADAQH/MAsGA1UdDwQEAwIBBjAdBgNVHQ4EFgQUppFC/RNhSiOeCKQp -5dgTBCPuQSUwRwYDVR0eBEAwPqA8MAWCAy5ncjAFggMuZXUwBoIELmVkdTAGggQu -b3JnMAWBAy5ncjAFgQMuZXUwBoEELmVkdTAGgQQub3JnMA0GCSqGSIb3DQEBBQUA -A4IBAQAf73lB4XtuP7KMhjdCSk4cNx6NZrokgclPEg8hwAOXhiVtXdMiKahsog2p -6z0GW5k6x8zDmjR/qw7IThzh+uTczQ2+vyT+bOdrwg3IBp5OjWEopmr95fZi6hg8 -TqBTnbI6nOulnJEWtk2C4AwFSKls9cz4y51JtPACpf1wA+2KIaWuE4ZJwzNzvoc7 -dIsXRSZMFpGD/md9zU1jZ/rzAxKWeAaNsWftjj++n08C9bMJL/NMh98qy5V8Acys -Nnq/onN694/BtZqhFLKPM58N7yLcZnuEvUUXBj08yrl3NI/K6s8/MT7jiOOASSXI -l7WdmplNsDz4SgCbZN2fOUvRJ9e4 ------END CERTIFICATE----- - -# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967 -# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967 -# Label: "Actalis Authentication Root CA" -# Serial: 6271844772424770508 -# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6 -# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac -# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66 ------BEGIN CERTIFICATE----- -MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE -BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w -MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290 -IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC -SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1 -ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB -MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv -UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX -4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9 -KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/ -gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb -rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ -51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F -be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe -KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F -v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn -fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7 -jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz -ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt -ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL -e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70 -jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz -WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V -SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j -pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX -X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok -fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R -K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU -ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU -LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT -LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg== ------END CERTIFICATE----- - -# Issuer: O=Trustis Limited OU=Trustis FPS Root CA -# Subject: O=Trustis Limited OU=Trustis FPS Root CA -# Label: "Trustis FPS Root CA" -# Serial: 36053640375399034304724988975563710553 -# MD5 Fingerprint: 30:c9:e7:1e:6b:e6:14:eb:65:b2:16:69:20:31:67:4d -# SHA1 Fingerprint: 3b:c0:38:0b:33:c3:f6:a6:0c:86:15:22:93:d9:df:f5:4b:81:c0:04 -# SHA256 Fingerprint: c1:b4:82:99:ab:a5:20:8f:e9:63:0a:ce:55:ca:68:a0:3e:da:5a:51:9c:88:02:a0:d3:a6:73:be:8f:8e:55:7d ------BEGIN CERTIFICATE----- -MIIDZzCCAk+gAwIBAgIQGx+ttiD5JNM2a/fH8YygWTANBgkqhkiG9w0BAQUFADBF -MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPVHJ1c3RpcyBMaW1pdGVkMRwwGgYDVQQL -ExNUcnVzdGlzIEZQUyBSb290IENBMB4XDTAzMTIyMzEyMTQwNloXDTI0MDEyMTEx -MzY1NFowRTELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1RydXN0aXMgTGltaXRlZDEc -MBoGA1UECxMTVHJ1c3RpcyBGUFMgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQAD -ggEPADCCAQoCggEBAMVQe547NdDfxIzNjpvto8A2mfRC6qc+gIMPpqdZh8mQRUN+ -AOqGeSoDvT03mYlmt+WKVoaTnGhLaASMk5MCPjDSNzoiYYkchU59j9WvezX2fihH -iTHcDnlkH5nSW7r+f2C/revnPDgpai/lkQtV/+xvWNUtyd5MZnGPDNcE2gfmHhjj -vSkCqPoc4Vu5g6hBSLwacY3nYuUtsuvffM/bq1rKMfFMIvMFE/eC+XN5DL7XSxzA -0RU8k0Fk0ea+IxciAIleH2ulrG6nS4zto3Lmr2NNL4XSFDWaLk6M6jKYKIahkQlB -OrTh4/L68MkKokHdqeMDx4gVOxzUGpTXn2RZEm0CAwEAAaNTMFEwDwYDVR0TAQH/ -BAUwAwEB/zAfBgNVHSMEGDAWgBS6+nEleYtXQSUhhgtx67JkDoshZzAdBgNVHQ4E -FgQUuvpxJXmLV0ElIYYLceuyZA6LIWcwDQYJKoZIhvcNAQEFBQADggEBAH5Y//01 -GX2cGE+esCu8jowU/yyg2kdbw++BLa8F6nRIW/M+TgfHbcWzk88iNVy2P3UnXwmW -zaD+vkAMXBJV+JOCyinpXj9WV4s4NvdFGkwozZ5BuO1WTISkQMi4sKUraXAEasP4 -1BIy+Q7DsdwyhEQsb8tGD+pmQQ9P8Vilpg0ND2HepZ5dfWWhPBfnqFVO76DH7cZE -f1T1o+CP8HxVIo8ptoGj4W1OLBuAZ+ytIJ8MYmHVl/9D7S3B2l0pKoU/rGXuhg8F -jZBf3+6f9L/uHfuY5H+QK4R4EA5sSVPvFVtlRkpdr7r7OnIdzfYliB6XzCGcKQEN -ZetX2fNXlrtIzYE= ------END CERTIFICATE----- - -# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 -# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327 -# Label: "Buypass Class 2 Root CA" -# Serial: 2 -# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29 -# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99 -# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48 ------BEGIN CERTIFICATE----- -MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd -MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg -Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow -TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw -HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB -BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr -6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV -L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91 -1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx -MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ -QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB -arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr -Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi -FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS -P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN -9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP -AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz -uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h -9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s -A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t -OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo -+fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7 -KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2 -DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us -H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ -I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7 -5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h -3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz -Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA= ------END CERTIFICATE----- - -# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 -# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327 -# Label: "Buypass Class 3 Root CA" -# Serial: 2 -# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec -# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57 -# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d ------BEGIN CERTIFICATE----- -MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd -MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg -Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow -TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw -HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB -BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y -ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E -N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9 -tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX -0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c -/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X -KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY -zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS -O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D -34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP -K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3 -AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv -Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj -QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV -cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS -IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2 -HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa -O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv -033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u -dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE -kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41 -3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD -u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq -4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc= ------END CERTIFICATE----- - -# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center -# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center -# Label: "T-TeleSec GlobalRoot Class 3" -# Serial: 1 -# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef -# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1 -# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd ------BEGIN CERTIFICATE----- -MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx -KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd -BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl -YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1 -OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy -aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 -ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G -CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN -8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/ -RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4 -hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5 -ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM -EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj -QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1 -A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy -WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ -1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30 -6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT -91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml -e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p -TpPDpFQUWw== ------END CERTIFICATE----- - -# Issuer: CN=EE Certification Centre Root CA O=AS Sertifitseerimiskeskus -# Subject: CN=EE Certification Centre Root CA O=AS Sertifitseerimiskeskus -# Label: "EE Certification Centre Root CA" -# Serial: 112324828676200291871926431888494945866 -# MD5 Fingerprint: 43:5e:88:d4:7d:1a:4a:7e:fd:84:2e:52:eb:01:d4:6f -# SHA1 Fingerprint: c9:a8:b9:e7:55:80:5e:58:e3:53:77:a7:25:eb:af:c3:7b:27:cc:d7 -# SHA256 Fingerprint: 3e:84:ba:43:42:90:85:16:e7:75:73:c0:99:2f:09:79:ca:08:4e:46:85:68:1f:f1:95:cc:ba:8a:22:9b:8a:76 ------BEGIN CERTIFICATE----- -MIIEAzCCAuugAwIBAgIQVID5oHPtPwBMyonY43HmSjANBgkqhkiG9w0BAQUFADB1 -MQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1 -czEoMCYGA1UEAwwfRUUgQ2VydGlmaWNhdGlvbiBDZW50cmUgUm9vdCBDQTEYMBYG -CSqGSIb3DQEJARYJcGtpQHNrLmVlMCIYDzIwMTAxMDMwMTAxMDMwWhgPMjAzMDEy -MTcyMzU5NTlaMHUxCzAJBgNVBAYTAkVFMSIwIAYDVQQKDBlBUyBTZXJ0aWZpdHNl -ZXJpbWlza2Vza3VzMSgwJgYDVQQDDB9FRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBS -b290IENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwggEiMA0GCSqGSIb3DQEB -AQUAA4IBDwAwggEKAoIBAQDIIMDs4MVLqwd4lfNE7vsLDP90jmG7sWLqI9iroWUy -euuOF0+W2Ap7kaJjbMeMTC55v6kF/GlclY1i+blw7cNRfdCT5mzrMEvhvH2/UpvO -bntl8jixwKIy72KyaOBhU8E2lf/slLo2rpwcpzIP5Xy0xm90/XsY6KxX7QYgSzIw -WFv9zajmofxwvI6Sc9uXp3whrj3B9UiHbCe9nyV0gVWw93X2PaRka9ZP585ArQ/d -MtO8ihJTmMmJ+xAdTX7Nfh9WDSFwhfYggx/2uh8Ej+p3iDXE/+pOoYtNP2MbRMNE -1CV2yreN1x5KZmTNXMWcg+HCCIia7E6j8T4cLNlsHaFLAgMBAAGjgYowgYcwDwYD -VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFBLyWj7qVhy/ -zQas8fElyalL1BSZMEUGA1UdJQQ+MDwGCCsGAQUFBwMCBggrBgEFBQcDAQYIKwYB -BQUHAwMGCCsGAQUFBwMEBggrBgEFBQcDCAYIKwYBBQUHAwkwDQYJKoZIhvcNAQEF -BQADggEBAHv25MANqhlHt01Xo/6tu7Fq1Q+e2+RjxY6hUFaTlrg4wCQiZrxTFGGV -v9DHKpY5P30osxBAIWrEr7BSdxjhlthWXePdNl4dp1BUoMUq5KqMlIpPnTX/dqQG -E5Gion0ARD9V04I8GtVbvFZMIi5GQ4okQC3zErg7cBqklrkar4dBGmoYDQZPxz5u -uSlNDUmJEYcyW+ZLBMjkXOZ0c5RdFpgTlf7727FE5TpwrDdr5rMzcijJs1eg9gIW -iAYLtqZLICjU3j2LrTcFU3T+bsy8QxdxXvnFzBqpYe73dgzzcvRyrc9yAjYHR8/v -GVCJYMzpJJUPwssd8m92kMfMdcGWxZ0= ------END CERTIFICATE----- - -# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH -# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH -# Label: "D-TRUST Root Class 3 CA 2 2009" -# Serial: 623603 -# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f -# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0 -# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1 ------BEGIN CERTIFICATE----- -MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF -MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD -bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha -ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM -HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB -BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03 -UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42 -tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R -ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM -lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp -/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G -A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G -A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj -dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy -MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl -cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js -L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL -BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni -acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0 -o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K -zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8 -PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y -Johw1+qRzT65ysCQblrGXnRl11z+o+I= ------END CERTIFICATE----- - -# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH -# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH -# Label: "D-TRUST Root Class 3 CA 2 EV 2009" -# Serial: 623604 -# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6 -# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83 -# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81 ------BEGIN CERTIFICATE----- -MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF -MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD -bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw -NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV -BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI -hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn -ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0 -3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z -qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR -p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8 -HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw -ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea -HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw -Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh -c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E -RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt -dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku -Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp -3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05 -nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF -CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na -xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX -KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1 ------END CERTIFICATE----- - -# Issuer: CN=CA Disig Root R2 O=Disig a.s. -# Subject: CN=CA Disig Root R2 O=Disig a.s. -# Label: "CA Disig Root R2" -# Serial: 10572350602393338211 -# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03 -# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71 -# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03 ------BEGIN CERTIFICATE----- -MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV -BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu -MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy -MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx -EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw -ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe -NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH -PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I -x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe -QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR -yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO -QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912 -H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ -QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD -i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs -nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1 -rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud -DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI -hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM -tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf -GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb -lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka -+elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal -TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i -nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3 -gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr -G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os -zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x -L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL ------END CERTIFICATE----- - -# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV -# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV -# Label: "ACCVRAIZ1" -# Serial: 6828503384748696800 -# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02 -# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17 -# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13 ------BEGIN CERTIFICATE----- -MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE -AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw -CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ -BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND -VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb -qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY -HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo -G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA -lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr -IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/ -0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH -k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47 -4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO -m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa -cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl -uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI -KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls -ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG -AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2 -VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT -VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG -CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA -cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA -QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA -7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA -cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA -QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA -czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu -aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt -aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud -DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF -BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp -D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU -JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m -AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD -vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms -tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH -7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h -I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA -h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF -d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H -pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7 ------END CERTIFICATE----- - -# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA -# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA -# Label: "TWCA Global Root CA" -# Serial: 3262 -# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96 -# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65 -# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b ------BEGIN CERTIFICATE----- -MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx -EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT -VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5 -NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT -B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF -10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz -0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh -MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH -zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc -46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2 -yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi -laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP -oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA -BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE -qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm -4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB -/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL -1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn -LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF -H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo -RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+ -nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh -15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW -6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW -nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j -wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz -aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy -KwbQBM0= ------END CERTIFICATE----- - -# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera -# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera -# Label: "TeliaSonera Root CA v1" -# Serial: 199041966741090107964904287217786801558 -# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c -# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37 -# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89 ------BEGIN CERTIFICATE----- -MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw -NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv -b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD -VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2 -MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F -VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1 -7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X -Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+ -/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs -81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm -dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe -Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu -sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4 -pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs -slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ -arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD -VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG -9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl -dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx -0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj -TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed -Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7 -Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI -OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7 -vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW -t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn -HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx -SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= ------END CERTIFICATE----- - -# Issuer: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi -# Subject: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi -# Label: "E-Tugra Certification Authority" -# Serial: 7667447206703254355 -# MD5 Fingerprint: b8:a1:03:63:b0:bd:21:71:70:8a:6f:13:3a:bb:79:49 -# SHA1 Fingerprint: 51:c6:e7:08:49:06:6e:f3:92:d4:5c:a0:0d:6d:a3:62:8f:c3:52:39 -# SHA256 Fingerprint: b0:bf:d5:2b:b0:d7:d9:bd:92:bf:5d:4d:c1:3d:a2:55:c0:2c:54:2f:37:83:65:ea:89:39:11:f5:5e:55:f2:3c ------BEGIN CERTIFICATE----- -MIIGSzCCBDOgAwIBAgIIamg+nFGby1MwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNV -BAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBC -aWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhpem1ldGxlcmkgQS7Fni4xJjAkBgNV -BAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBNZXJrZXppMSgwJgYDVQQDDB9FLVR1 -Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTEzMDMwNTEyMDk0OFoXDTIz -MDMwMzEyMDk0OFowgbIxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+ -BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhp -em1ldGxlcmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBN -ZXJrZXppMSgwJgYDVQQDDB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5 -MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA4vU/kwVRHoViVF56C/UY -B4Oufq9899SKa6VjQzm5S/fDxmSJPZQuVIBSOTkHS0vdhQd2h8y/L5VMzH2nPbxH -D5hw+IyFHnSOkm0bQNGZDbt1bsipa5rAhDGvykPL6ys06I+XawGb1Q5KCKpbknSF -Q9OArqGIW66z6l7LFpp3RMih9lRozt6Plyu6W0ACDGQXwLWTzeHxE2bODHnv0ZEo -q1+gElIwcxmOj+GMB6LDu0rw6h8VqO4lzKRG+Bsi77MOQ7osJLjFLFzUHPhdZL3D -k14opz8n8Y4e0ypQBaNV2cvnOVPAmJ6MVGKLJrD3fY185MaeZkJVgkfnsliNZvcH -fC425lAcP9tDJMW/hkd5s3kc91r0E+xs+D/iWR+V7kI+ua2oMoVJl0b+SzGPWsut -dEcf6ZG33ygEIqDUD13ieU/qbIWGvaimzuT6w+Gzrt48Ue7LE3wBf4QOXVGUnhMM -ti6lTPk5cDZvlsouDERVxcr6XQKj39ZkjFqzAQqptQpHF//vkUAqjqFGOjGY5RH8 -zLtJVor8udBhmm9lbObDyz51Sf6Pp+KJxWfXnUYTTjF2OySznhFlhqt/7x3U+Lzn -rFpct1pHXFXOVbQicVtbC/DP3KBhZOqp12gKY6fgDT+gr9Oq0n7vUaDmUStVkhUX -U8u3Zg5mTPj5dUyQ5xJwx0UCAwEAAaNjMGEwHQYDVR0OBBYEFC7j27JJ0JxUeVz6 -Jyr+zE7S6E5UMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAULuPbsknQnFR5 -XPonKv7MTtLoTlQwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAF -Nzr0TbdF4kV1JI+2d1LoHNgQk2Xz8lkGpD4eKexd0dCrfOAKkEh47U6YA5n+KGCR -HTAduGN8qOY1tfrTYXbm1gdLymmasoR6d5NFFxWfJNCYExL/u6Au/U5Mh/jOXKqY -GwXgAEZKgoClM4so3O0409/lPun++1ndYYRP0lSWE2ETPo+Aab6TR7U1Q9Jauz1c -77NCR807VRMGsAnb/WP2OogKmW9+4c4bU2pEZiNRCHu8W1Ki/QY3OEBhj0qWuJA3 -+GbHeJAAFS6LrVE1Uweoa2iu+U48BybNCAVwzDk/dr2l02cmAYamU9JgO3xDf1WK -vJUawSg5TB9D0pH0clmKuVb8P7Sd2nCcdlqMQ1DujjByTd//SffGqWfZbawCEeI6 -FiWnWAjLb1NBnEg4R2gz0dfHj9R0IdTDBZB6/86WiLEVKV0jq9BgoRJP3vQXzTLl -yb/IQ639Lo7xr+L0mPoSHyDYwKcMhcWQ9DstliaxLL5Mq+ux0orJ23gTDx4JnW2P -AJ8C2sH6H3p6CcRK5ogql5+Ji/03X186zjhZhkuvcQu02PJwT58yE+Owp1fl2tpD -y4Q08ijE6m30Ku/Ba3ba+367hTzSU8JNvnHhRdH9I2cNE3X7z2VnIp2usAnRCf8d -NL/+I5c30jn6PQ0GC7TbO6Orb1wdtn7os4I07QZcJA== ------END CERTIFICATE----- - -# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center -# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center -# Label: "T-TeleSec GlobalRoot Class 2" -# Serial: 1 -# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a -# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9 -# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52 ------BEGIN CERTIFICATE----- -MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx -KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd -BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl -YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1 -OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy -aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50 -ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G -CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd -AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC -FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi -1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq -jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ -wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj -QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/ -WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy -NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC -uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw -IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6 -g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN -9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP -BSeOE6Fuwg== ------END CERTIFICATE----- - -# Issuer: CN=Atos TrustedRoot 2011 O=Atos -# Subject: CN=Atos TrustedRoot 2011 O=Atos -# Label: "Atos TrustedRoot 2011" -# Serial: 6643877497813316402 -# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56 -# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21 -# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74 ------BEGIN CERTIFICATE----- -MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE -AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG -EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM -FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC -REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp -Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM -VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+ -SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ -4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L -cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi -eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV -HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG -A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3 -DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j -vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP -DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc -maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D -lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv -KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited -# Label: "QuoVadis Root CA 1 G3" -# Serial: 687049649626669250736271037606554624078720034195 -# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab -# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67 -# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74 ------BEGIN CERTIFICATE----- -MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL -BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc -BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00 -MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM -aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV -wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe -rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341 -68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh -4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp -UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o -abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc -3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G -KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt -hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO -Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt -zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB -BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD -ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC -MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2 -cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN -qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5 -YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv -b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2 -8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k -NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj -ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp -q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt -nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited -# Label: "QuoVadis Root CA 2 G3" -# Serial: 390156079458959257446133169266079962026824725800 -# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06 -# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36 -# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40 ------BEGIN CERTIFICATE----- -MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL -BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc -BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00 -MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM -aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf -qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW -n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym -c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+ -O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1 -o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j -IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq -IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz -8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh -vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l -7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG -cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB -BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD -ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66 -AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC -roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga -W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n -lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE -+V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV -csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd -dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg -KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM -HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4 -WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited -# Label: "QuoVadis Root CA 3 G3" -# Serial: 268090761170461462463995952157327242137089239581 -# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7 -# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d -# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46 ------BEGIN CERTIFICATE----- -MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL -BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc -BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00 -MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM -aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR -/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu -FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR -U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c -ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR -FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k -A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw -eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl -sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp -VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q -A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+ -ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB -BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD -ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px -KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI -FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv -oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg -u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP -0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf -3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl -8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+ -DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN -PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/ -ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0 ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Assured ID Root G2" -# Serial: 15385348160840213938643033620894905419 -# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d -# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f -# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85 ------BEGIN CERTIFICATE----- -MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv -b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG -EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl -cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi -MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA -n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc -biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp -EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA -bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu -YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB -AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW -BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI -QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I -0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni -lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9 -B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv -ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo -IhNzbM8m9Yop5w== ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Assured ID Root G3" -# Serial: 15459312981008553731928384953135426796 -# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb -# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89 -# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2 ------BEGIN CERTIFICATE----- -MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw -CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu -ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg -RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV -UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu -Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq -hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf -Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q -RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ -BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD -AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY -JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv -6pZjamVFkpUBtA== ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Global Root G2" -# Serial: 4293743540046975378534879503202253541 -# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44 -# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4 -# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f ------BEGIN CERTIFICATE----- -MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH -MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT -MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j -b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG -9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI -2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx -1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ -q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz -tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ -vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP -BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV -5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY -1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4 -NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG -Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91 -8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe -pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl -MrY= ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Global Root G3" -# Serial: 7089244469030293291760083333884364146 -# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca -# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e -# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0 ------BEGIN CERTIFICATE----- -MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw -CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu -ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe -Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw -EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x -IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF -K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG -fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO -Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd -BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx -AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/ -oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8 -sycX ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Trusted Root G4" -# Serial: 7451500558977370777930084869016614236 -# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49 -# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4 -# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88 ------BEGIN CERTIFICATE----- -MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg -RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV -UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu -Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y -ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If -xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV -ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO -DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ -jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/ -CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi -EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM -fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY -uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK -chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t -9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB -hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD -ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2 -SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd -+SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc -fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa -sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N -cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N -0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie -4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI -r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1 -/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm -gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+ ------END CERTIFICATE----- - -# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited -# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited -# Label: "COMODO RSA Certification Authority" -# Serial: 101909084537582093308941363524873193117 -# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18 -# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4 -# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34 ------BEGIN CERTIFICATE----- -MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB -hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G -A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV -BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5 -MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT -EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR -Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh -dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR -6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X -pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC -9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV -/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf -Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z -+pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w -qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah -SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC -u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf -Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq -crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E -FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB -/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl -wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM -4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV -2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna -FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ -CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK -boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke -jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL -S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb -QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl -0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB -NVOFBkpdn627G190 ------END CERTIFICATE----- - -# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network -# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network -# Label: "USERTrust RSA Certification Authority" -# Serial: 2645093764781058787591871645665788717 -# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5 -# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e -# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2 ------BEGIN CERTIFICATE----- -MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB -iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl -cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV -BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw -MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV -BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU -aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy -dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK -AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B -3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY -tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/ -Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2 -VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT -79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6 -c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT -Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l -c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee -UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE -Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd -BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G -A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF -Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO -VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3 -ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs -8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR -iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze -Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ -XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/ -qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB -VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB -L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG -jjxDah2nGN59PRbxYvnKkKj9 ------END CERTIFICATE----- - -# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network -# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network -# Label: "USERTrust ECC Certification Authority" -# Serial: 123013823720199481456569720443997572134 -# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1 -# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0 -# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a ------BEGIN CERTIFICATE----- -MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL -MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl -eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT -JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx -MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT -Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg -VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm -aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo -I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng -o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G -A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD -VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB -zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW -RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg= ------END CERTIFICATE----- - -# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4 -# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4 -# Label: "GlobalSign ECC Root CA - R4" -# Serial: 14367148294922964480859022125800977897474 -# MD5 Fingerprint: 20:f0:27:68:d1:7e:a0:9d:0e:e6:2a:ca:df:5c:89:8e -# SHA1 Fingerprint: 69:69:56:2e:40:80:f4:24:a1:e7:19:9f:14:ba:f3:ee:58:ab:6a:bb -# SHA256 Fingerprint: be:c9:49:11:c2:95:56:76:db:6c:0a:55:09:86:d7:6e:3b:a0:05:66:7c:44:2c:97:62:b4:fb:b7:73:de:22:8c ------BEGIN CERTIFICATE----- -MIIB4TCCAYegAwIBAgIRKjikHJYKBN5CsiilC+g0mAIwCgYIKoZIzj0EAwIwUDEk -MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI0MRMwEQYDVQQKEwpH -bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX -DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD -QSAtIFI0MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu -MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEuMZ5049sJQ6fLjkZHAOkrprlOQcJ -FspjsbmG+IpXwVfOQvpzofdlQv8ewQCybnMO/8ch5RikqtlxP6jUuc6MHaNCMEAw -DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFFSwe61F -uOJAf/sKbvu+M8k8o4TVMAoGCCqGSM49BAMCA0gAMEUCIQDckqGgE6bPA7DmxCGX -kPoUVy0D7O48027KqGx2vKLeuwIgJ6iFJzWbVsaj8kfSt24bAgAXqmemFZHe+pTs -ewv4n4Q= ------END CERTIFICATE----- - -# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5 -# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5 -# Label: "GlobalSign ECC Root CA - R5" -# Serial: 32785792099990507226680698011560947931244 -# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08 -# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa -# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24 ------BEGIN CERTIFICATE----- -MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk -MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH -bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX -DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD -QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu -MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc -8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke -hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD -VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI -KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg -515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO -xwy8p2Fp8fc74SrL+SvzZpA3 ------END CERTIFICATE----- - -# Issuer: CN=Staat der Nederlanden Root CA - G3 O=Staat der Nederlanden -# Subject: CN=Staat der Nederlanden Root CA - G3 O=Staat der Nederlanden -# Label: "Staat der Nederlanden Root CA - G3" -# Serial: 10003001 -# MD5 Fingerprint: 0b:46:67:07:db:10:2f:19:8c:35:50:60:d1:0b:f4:37 -# SHA1 Fingerprint: d8:eb:6b:41:51:92:59:e0:f3:e7:85:00:c0:3d:b6:88:97:c9:ee:fc -# SHA256 Fingerprint: 3c:4f:b0:b9:5a:b8:b3:00:32:f4:32:b8:6f:53:5f:e1:72:c1:85:d0:fd:39:86:58:37:cf:36:18:7f:a6:f4:28 ------BEGIN CERTIFICATE----- -MIIFdDCCA1ygAwIBAgIEAJiiOTANBgkqhkiG9w0BAQsFADBaMQswCQYDVQQGEwJO -TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSswKQYDVQQDDCJTdGFh -dCBkZXIgTmVkZXJsYW5kZW4gUm9vdCBDQSAtIEczMB4XDTEzMTExNDExMjg0MloX -DTI4MTExMzIzMDAwMFowWjELMAkGA1UEBhMCTkwxHjAcBgNVBAoMFVN0YWF0IGRl -ciBOZWRlcmxhbmRlbjErMCkGA1UEAwwiU3RhYXQgZGVyIE5lZGVybGFuZGVuIFJv -b3QgQ0EgLSBHMzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAL4yolQP -cPssXFnrbMSkUeiFKrPMSjTysF/zDsccPVMeiAho2G89rcKezIJnByeHaHE6n3WW -IkYFsO2tx1ueKt6c/DrGlaf1F2cY5y9JCAxcz+bMNO14+1Cx3Gsy8KL+tjzk7FqX -xz8ecAgwoNzFs21v0IJyEavSgWhZghe3eJJg+szeP4TrjTgzkApyI/o1zCZxMdFy -KJLZWyNtZrVtB0LrpjPOktvA9mxjeM3KTj215VKb8b475lRgsGYeCasH/lSJEULR -9yS6YHgamPfJEf0WwTUaVHXvQ9Plrk7O53vDxk5hUUurmkVLoR9BvUhTFXFkC4az -5S6+zqQbwSmEorXLCCN2QyIkHxcE1G6cxvx/K2Ya7Irl1s9N9WMJtxU51nus6+N8 -6U78dULI7ViVDAZCopz35HCz33JvWjdAidiFpNfxC95DGdRKWCyMijmev4SH8RY7 -Ngzp07TKbBlBUgmhHbBqv4LvcFEhMtwFdozL92TkA1CvjJFnq8Xy7ljY3r735zHP -bMk7ccHViLVlvMDoFxcHErVc0qsgk7TmgoNwNsXNo42ti+yjwUOH5kPiNL6VizXt -BznaqB16nzaeErAMZRKQFWDZJkBE41ZgpRDUajz9QdwOWke275dhdU/Z/seyHdTt -XUmzqWrLZoQT1Vyg3N9udwbRcXXIV2+vD3dbAgMBAAGjQjBAMA8GA1UdEwEB/wQF -MAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRUrfrHkleuyjWcLhL75Lpd -INyUVzANBgkqhkiG9w0BAQsFAAOCAgEAMJmdBTLIXg47mAE6iqTnB/d6+Oea31BD -U5cqPco8R5gu4RV78ZLzYdqQJRZlwJ9UXQ4DO1t3ApyEtg2YXzTdO2PCwyiBwpwp -LiniyMMB8jPqKqrMCQj3ZWfGzd/TtiunvczRDnBfuCPRy5FOCvTIeuXZYzbB1N/8 -Ipf3YF3qKS9Ysr1YvY2WTxB1v0h7PVGHoTx0IsL8B3+A3MSs/mrBcDCw6Y5p4ixp -gZQJut3+TcCDjJRYwEYgr5wfAvg1VUkvRtTA8KCWAg8zxXHzniN9lLf9OtMJgwYh -/WA9rjLA0u6NpvDntIJ8CsxwyXmA+P5M9zWEGYox+wrZ13+b8KKaa8MFSu1BYBQw -0aoRQm7TIwIEC8Zl3d1Sd9qBa7Ko+gE4uZbqKmxnl4mUnrzhVNXkanjvSr0rmj1A -fsbAddJu+2gw7OyLnflJNZoaLNmzlTnVHpL3prllL+U9bTpITAjc5CgSKL59NVzq -4BZ+Extq1z7XnvwtdbLBFNUjA9tbbws+eC8N3jONFrdI54OagQ97wUNNVQQXOEpR -1VmiiXTTn74eS9fGbbeIJG9gkaSChVtWQbzQRKtqE77RLFi3EjNYsjdj3BP1lB0/ -QFH1T/U67cjF68IeHRaVesd+QnGTbksVtzDfqu1XhUisHWrdOWnk4Xl4vs4Fv6EM -94B7IWcnMFk= ------END CERTIFICATE----- - -# Issuer: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden -# Subject: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden -# Label: "Staat der Nederlanden EV Root CA" -# Serial: 10000013 -# MD5 Fingerprint: fc:06:af:7b:e8:1a:f1:9a:b4:e8:d2:70:1f:c0:f5:ba -# SHA1 Fingerprint: 76:e2:7e:c1:4f:db:82:c1:c0:a6:75:b5:05:be:3d:29:b4:ed:db:bb -# SHA256 Fingerprint: 4d:24:91:41:4c:fe:95:67:46:ec:4c:ef:a6:cf:6f:72:e2:8a:13:29:43:2f:9d:8a:90:7a:c4:cb:5d:ad:c1:5a ------BEGIN CERTIFICATE----- -MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJO -TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFh -dCBkZXIgTmVkZXJsYW5kZW4gRVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0y -MjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5MMR4wHAYDVQQKDBVTdGFhdCBkZXIg -TmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRlcmxhbmRlbiBFViBS -b290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkkSzrS -M4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nC -UiY4iKTWO0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3d -Z//BYY1jTw+bbRcwJu+r0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46p -rfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13l -pJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gVXJrm0w912fxBmJc+qiXb -j5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr08C+eKxC -KFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS -/ZbV0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0X -cgOPvZuM5l5Tnrmd74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH -1vI4gnPah1vlPNOePqc7nvQDs/nxfRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrP -px9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB -/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwaivsnuL8wbqg7 -MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI -eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u -2dfOWBfoqSmuc0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHS -v4ilf0X8rLiltTMMgsT7B/Zq5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTC -wPTxGfARKbalGAKb12NMcIxHowNDXLldRqANb/9Zjr7dn3LDWyvfjFvO5QxGbJKy -CqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tNf1zuacpzEPuKqf2e -vTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi5Dp6 -Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIa -Gl6I6lD4WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeL -eG9QgkRQP2YGiqtDhFZKDyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8 -FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGyeUN51q1veieQA6TqJIc/2b3Z6fJfUEkc -7uzXLg== ------END CERTIFICATE----- - -# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust -# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust -# Label: "IdenTrust Commercial Root CA 1" -# Serial: 13298821034946342390520003877796839426 -# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7 -# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25 -# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae ------BEGIN CERTIFICATE----- -MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK -MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu -VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw -MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw -JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG -SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT -3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU -+ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp -S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1 -bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi -T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL -vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK -Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK -dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT -c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv -l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N -iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB -/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD -ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH -6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt -LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93 -nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3 -+wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK -W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT -AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq -l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG -4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ -mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A -7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H ------END CERTIFICATE----- - -# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust -# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust -# Label: "IdenTrust Public Sector Root CA 1" -# Serial: 13298821034946342390521976156843933698 -# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba -# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd -# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f ------BEGIN CERTIFICATE----- -MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN -MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu -VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN -MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0 -MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi -MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7 -ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy -RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS -bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF -/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R -3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw -EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy -9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V -GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ -2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV -WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD -W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ -BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN -AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj -t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV -DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9 -TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G -lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW -mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df -WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5 -+bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ -tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA -GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv -8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c ------END CERTIFICATE----- - -# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only -# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only -# Label: "Entrust Root Certification Authority - G2" -# Serial: 1246989352 -# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2 -# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4 -# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39 ------BEGIN CERTIFICATE----- -MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC -VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50 -cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs -IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz -dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy -NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu -dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt -dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0 -aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj -YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK -AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T -RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN -cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW -wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1 -U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0 -jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP -BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN -BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/ -jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ -Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v -1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R -nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH -VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g== ------END CERTIFICATE----- - -# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only -# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only -# Label: "Entrust Root Certification Authority - EC1" -# Serial: 51543124481930649114116133369 -# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc -# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47 -# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5 ------BEGIN CERTIFICATE----- -MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG -A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3 -d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu -dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq -RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy -MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD -VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0 -L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g -Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD -ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi -A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt -ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH -Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O -BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC -R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX -hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G ------END CERTIFICATE----- - -# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority -# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority -# Label: "CFCA EV ROOT" -# Serial: 407555286 -# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30 -# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83 -# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd ------BEGIN CERTIFICATE----- -MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD -TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y -aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx -MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j -aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP -T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03 -sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL -TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5 -/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp -7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz -EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt -hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP -a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot -aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg -TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV -PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv -cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL -tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd -BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB -ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT -ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL -jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS -ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy -P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19 -xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d -Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN -5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe -/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z -AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ -5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su ------END CERTIFICATE----- - -# Issuer: CN=T\xdcRKTRUST Elektronik Sertifika Hizmet Sa\u011flay\u0131c\u0131s\u0131 H5 O=T\xdcRKTRUST Bilgi \u0130leti\u015fim ve Bili\u015fim G\xfcvenli\u011fi Hizmetleri A.\u015e. -# Subject: CN=T\xdcRKTRUST Elektronik Sertifika Hizmet Sa\u011flay\u0131c\u0131s\u0131 H5 O=T\xdcRKTRUST Bilgi \u0130leti\u015fim ve Bili\u015fim G\xfcvenli\u011fi Hizmetleri A.\u015e. -# Label: "T\xdcRKTRUST Elektronik Sertifika Hizmet Sa\u011flay\u0131c\u0131s\u0131 H5" -# Serial: 156233699172481 -# MD5 Fingerprint: da:70:8e:f0:22:df:93:26:f6:5f:9f:d3:15:06:52:4e -# SHA1 Fingerprint: c4:18:f6:4d:46:d1:df:00:3d:27:30:13:72:43:a9:12:11:c6:75:fb -# SHA256 Fingerprint: 49:35:1b:90:34:44:c1:85:cc:dc:5c:69:3d:24:d8:55:5c:b2:08:d6:a8:14:13:07:69:9f:4a:f0:63:19:9d:78 ------BEGIN CERTIFICATE----- -MIIEJzCCAw+gAwIBAgIHAI4X/iQggTANBgkqhkiG9w0BAQsFADCBsTELMAkGA1UE -BhMCVFIxDzANBgNVBAcMBkFua2FyYTFNMEsGA1UECgxEVMOcUktUUlVTVCBCaWxn -aSDEsGxldGnFn2ltIHZlIEJpbGnFn2ltIEfDvHZlbmxpxJ9pIEhpem1ldGxlcmkg -QS7Fni4xQjBABgNVBAMMOVTDnFJLVFJVU1QgRWxla3Ryb25payBTZXJ0aWZpa2Eg -SGl6bWV0IFNhxJ9sYXnEsWPEsXPEsSBINTAeFw0xMzA0MzAwODA3MDFaFw0yMzA0 -MjgwODA3MDFaMIGxMQswCQYDVQQGEwJUUjEPMA0GA1UEBwwGQW5rYXJhMU0wSwYD -VQQKDERUw5xSS1RSVVNUIEJpbGdpIMSwbGV0acWfaW0gdmUgQmlsacWfaW0gR8O8 -dmVubGnEn2kgSGl6bWV0bGVyaSBBLsWeLjFCMEAGA1UEAww5VMOcUktUUlVTVCBF -bGVrdHJvbmlrIFNlcnRpZmlrYSBIaXptZXQgU2HEn2xhecSxY8Sxc8SxIEg1MIIB -IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApCUZ4WWe60ghUEoI5RHwWrom -/4NZzkQqL/7hzmAD/I0Dpe3/a6i6zDQGn1k19uwsu537jVJp45wnEFPzpALFp/kR -Gml1bsMdi9GYjZOHp3GXDSHHmflS0yxjXVW86B8BSLlg/kJK9siArs1mep5Fimh3 -4khon6La8eHBEJ/rPCmBp+EyCNSgBbGM+42WAA4+Jd9ThiI7/PS98wl+d+yG6w8z -5UNP9FR1bSmZLmZaQ9/LXMrI5Tjxfjs1nQ/0xVqhzPMggCTTV+wVunUlm+hkS7M0 -hO8EuPbJbKoCPrZV4jI3X/xml1/N1p7HIL9Nxqw/dV8c7TKcfGkAaZHjIxhT6QID -AQABo0IwQDAdBgNVHQ4EFgQUVpkHHtOsDGlktAxQR95DLL4gwPswDgYDVR0PAQH/ -BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAJ5FdnsX -SDLyOIspve6WSk6BGLFRRyDN0GSxDsnZAdkJzsiZ3GglE9Rc8qPoBP5yCccLqh0l -VX6Wmle3usURehnmp349hQ71+S4pL+f5bFgWV1Al9j4uPqrtd3GqqpmWRgqujuwq -URawXs3qZwQcWDD1YIq9pr1N5Za0/EKJAWv2cMhQOQwt1WbZyNKzMrcbGW3LM/nf -peYVhDfwwvJllpKQd/Ct9JDpEXjXk4nAPQu6KfTomZ1yju2dL+6SfaHx/126M2CF -Yv4HAqGEVka+lgqaE9chTLd8B59OTj+RdPsnnRHM3eaxynFNExc5JsUpISuTKWqW -+qtB4Uu2NQvAmxU= ------END CERTIFICATE----- - -# Issuer: CN=Certinomis - Root CA O=Certinomis OU=0002 433998903 -# Subject: CN=Certinomis - Root CA O=Certinomis OU=0002 433998903 -# Label: "Certinomis - Root CA" -# Serial: 1 -# MD5 Fingerprint: 14:0a:fd:8d:a8:28:b5:38:69:db:56:7e:61:22:03:3f -# SHA1 Fingerprint: 9d:70:bb:01:a5:a4:a0:18:11:2e:f7:1c:01:b9:32:c5:34:e7:88:a8 -# SHA256 Fingerprint: 2a:99:f5:bc:11:74:b7:3c:bb:1d:62:08:84:e0:1c:34:e5:1c:cb:39:78:da:12:5f:0e:33:26:88:83:bf:41:58 ------BEGIN CERTIFICATE----- -MIIFkjCCA3qgAwIBAgIBATANBgkqhkiG9w0BAQsFADBaMQswCQYDVQQGEwJGUjET -MBEGA1UEChMKQ2VydGlub21pczEXMBUGA1UECxMOMDAwMiA0MzM5OTg5MDMxHTAb -BgNVBAMTFENlcnRpbm9taXMgLSBSb290IENBMB4XDTEzMTAyMTA5MTcxOFoXDTMz -MTAyMTA5MTcxOFowWjELMAkGA1UEBhMCRlIxEzARBgNVBAoTCkNlcnRpbm9taXMx -FzAVBgNVBAsTDjAwMDIgNDMzOTk4OTAzMR0wGwYDVQQDExRDZXJ0aW5vbWlzIC0g -Um9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANTMCQosP5L2 -fxSeC5yaah1AMGT9qt8OHgZbn1CF6s2Nq0Nn3rD6foCWnoR4kkjW4znuzuRZWJfl -LieY6pOod5tK8O90gC3rMB+12ceAnGInkYjwSond3IjmFPnVAy//ldu9n+ws+hQV -WZUKxkd8aRi5pwP5ynapz8dvtF4F/u7BUrJ1Mofs7SlmO/NKFoL21prbcpjp3vDF -TKWrteoB4owuZH9kb/2jJZOLyKIOSY008B/sWEUuNKqEUL3nskoTuLAPrjhdsKkb -5nPJWqHZZkCqqU2mNAKthH6yI8H7KsZn9DS2sJVqM09xRLWtwHkziOC/7aOgFLSc -CbAK42C++PhmiM1b8XcF4LVzbsF9Ri6OSyemzTUK/eVNfaoqoynHWmgE6OXWk6Ri -wsXm9E/G+Z8ajYJJGYrKWUM66A0ywfRMEwNvbqY/kXPLynNvEiCL7sCCeN5LLsJJ -wx3tFvYk9CcbXFcx3FXuqB5vbKziRcxXV4p1VxngtViZSTYxPDMBbRZKzbgqg4SG -m/lg0h9tkQPTYKbVPZrdd5A9NaSfD171UkRpucC63M9933zZxKyGIjK8e2uR73r4 -F2iw4lNVYC2vPsKD2NkJK/DAZNuHi5HMkesE/Xa0lZrmFAYb1TQdvtj/dBxThZng -WVJKYe2InmtJiUZ+IFrZ50rlau7SZRFDAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIB -BjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTvkUz1pcMw6C8I6tNxIqSSaHh0 -2TAfBgNVHSMEGDAWgBTvkUz1pcMw6C8I6tNxIqSSaHh02TANBgkqhkiG9w0BAQsF -AAOCAgEAfj1U2iJdGlg+O1QnurrMyOMaauo++RLrVl89UM7g6kgmJs95Vn6RHJk/ -0KGRHCwPT5iVWVO90CLYiF2cN/z7ZMF4jIuaYAnq1fohX9B0ZedQxb8uuQsLrbWw -F6YSjNRieOpWauwK0kDDPAUwPk2Ut59KA9N9J0u2/kTO+hkzGm2kQtHdzMjI1xZS -g081lLMSVX3l4kLr5JyTCcBMWwerx20RoFAXlCOotQqSD7J6wWAsOMwaplv/8gzj -qh8c3LigkyfeY+N/IZ865Z764BNqdeuWXGKRlI5nU7aJ+BIJy29SWwNyhlCVCNSN -h4YVH5Uk2KRvms6knZtt0rJ2BobGVgjF6wnaNsIbW0G+YSrjcOa4pvi2WsS9Iff/ -ql+hbHY5ZtbqTFXhADObE5hjyW/QASAJN1LnDE8+zbz1X5YnpyACleAu6AdBBR8V -btaw5BngDwKTACdyxYvRVB9dSsNAl35VpnzBMwQUAR1JIGkLGZOdblgi90AMRgwj -Y/M50n92Uaf0yKHxDHYiI0ZSKS3io0EHVmmY0gUJvGnHWmHNj4FgFU2A3ZDifcRQ -8ow7bkrHxuaAKzyBvBGAFhAn1/DNP3nMcyrDflOR1m749fPH0FFNjkulW+YZFzvW -gQncItzujrnEj1PhZ7szuIgVRs/taTX/dQ1G885x4cVrhkIGuUE= ------END CERTIFICATE----- - -# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed -# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed -# Label: "OISTE WISeKey Global Root GB CA" -# Serial: 157768595616588414422159278966750757568 -# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d -# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed -# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6 ------BEGIN CERTIFICATE----- -MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt -MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg -Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i -YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x -CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG -b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh -bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3 -HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx -WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX -1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk -u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P -99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r -M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw -AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB -BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh -cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5 -gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO -ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf -aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic -Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM= ------END CERTIFICATE----- - -# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. -# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A. -# Label: "SZAFIR ROOT CA2" -# Serial: 357043034767186914217277344587386743377558296292 -# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99 -# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de -# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe ------BEGIN CERTIFICATE----- -MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL -BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6 -ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw -NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L -cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg -Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN -QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT -3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw -3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6 -3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5 -BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN -XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD -AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF -AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw -8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG -nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP -oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy -d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg -LvWpCz/UXeHPhJ/iGcJfitYgHuNztw== ------END CERTIFICATE----- - -# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority -# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority -# Label: "Certum Trusted Network CA 2" -# Serial: 44979900017204383099463764357512596969 -# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2 -# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92 -# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04 ------BEGIN CERTIFICATE----- -MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB -gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu -QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG -A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz -OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ -VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp -ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3 -b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA -DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn -0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB -OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE -fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E -Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m -o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i -sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW -OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez -Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS -adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n -3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD -AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC -AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ -F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf -CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29 -XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm -djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/ -WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb -AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq -P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko -b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj -XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P -5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi -DrW5viSP ------END CERTIFICATE----- - -# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority -# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority -# Label: "Hellenic Academic and Research Institutions RootCA 2015" -# Serial: 0 -# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce -# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6 -# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36 ------BEGIN CERTIFICATE----- -MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix -DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k -IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT -N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v -dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG -A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh -ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx -QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1 -dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC -AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA -4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0 -AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10 -4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C -ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV -9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD -gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6 -Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq -NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko -LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc -Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV -HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd -ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I -XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI -M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot -9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V -Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea -j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh -X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ -l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf -bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4 -pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK -e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0 -vm9qp/UsQu0yrbYhnr68 ------END CERTIFICATE----- - -# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority -# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority -# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015" -# Serial: 0 -# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef -# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66 -# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33 ------BEGIN CERTIFICATE----- -MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN -BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl -c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl -bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv -b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ -BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj -YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5 -MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0 -dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg -QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa -jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC -MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi -C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep -lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof -TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR ------END CERTIFICATE----- - -# Issuer: CN=Certplus Root CA G1 O=Certplus -# Subject: CN=Certplus Root CA G1 O=Certplus -# Label: "Certplus Root CA G1" -# Serial: 1491911565779898356709731176965615564637713 -# MD5 Fingerprint: 7f:09:9c:f7:d9:b9:5c:69:69:56:d5:37:3e:14:0d:42 -# SHA1 Fingerprint: 22:fd:d0:b7:fd:a2:4e:0d:ac:49:2c:a0:ac:a6:7b:6a:1f:e3:f7:66 -# SHA256 Fingerprint: 15:2a:40:2b:fc:df:2c:d5:48:05:4d:22:75:b3:9c:7f:ca:3e:c0:97:80:78:b0:f0:ea:76:e5:61:a6:c7:43:3e ------BEGIN CERTIFICATE----- -MIIFazCCA1OgAwIBAgISESBVg+QtPlRWhS2DN7cs3EYRMA0GCSqGSIb3DQEBDQUA -MD4xCzAJBgNVBAYTAkZSMREwDwYDVQQKDAhDZXJ0cGx1czEcMBoGA1UEAwwTQ2Vy -dHBsdXMgUm9vdCBDQSBHMTAeFw0xNDA1MjYwMDAwMDBaFw0zODAxMTUwMDAwMDBa -MD4xCzAJBgNVBAYTAkZSMREwDwYDVQQKDAhDZXJ0cGx1czEcMBoGA1UEAwwTQ2Vy -dHBsdXMgUm9vdCBDQSBHMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB -ANpQh7bauKk+nWT6VjOaVj0W5QOVsjQcmm1iBdTYj+eJZJ+622SLZOZ5KmHNr49a -iZFluVj8tANfkT8tEBXgfs+8/H9DZ6itXjYj2JizTfNDnjl8KvzsiNWI7nC9hRYt -6kuJPKNxQv4c/dMcLRC4hlTqQ7jbxofaqK6AJc96Jh2qkbBIb6613p7Y1/oA/caP -0FG7Yn2ksYyy/yARujVjBYZHYEMzkPZHogNPlk2dT8Hq6pyi/jQu3rfKG3akt62f -6ajUeD94/vI4CTYd0hYCyOwqaK/1jpTvLRN6HkJKHRUxrgwEV/xhc/MxVoYxgKDE -EW4wduOU8F8ExKyHcomYxZ3MVwia9Az8fXoFOvpHgDm2z4QTd28n6v+WZxcIbekN -1iNQMLAVdBM+5S//Ds3EC0pd8NgAM0lm66EYfFkuPSi5YXHLtaW6uOrc4nBvCGrc -h2c0798wct3zyT8j/zXhviEpIDCB5BmlIOklynMxdCm+4kLV87ImZsdo/Rmz5yCT -mehd4F6H50boJZwKKSTUzViGUkAksnsPmBIgJPaQbEfIDbsYIC7Z/fyL8inqh3SV -4EJQeIQEQWGw9CEjjy3LKCHyamz0GqbFFLQ3ZU+V/YDI+HLlJWvEYLF7bY5KinPO -WftwenMGE9nTdDckQQoRb5fc5+R+ob0V8rqHDz1oihYHAgMBAAGjYzBhMA4GA1Ud -DwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSowcCbkahDFXxd -Bie0KlHYlwuBsTAfBgNVHSMEGDAWgBSowcCbkahDFXxdBie0KlHYlwuBsTANBgkq -hkiG9w0BAQ0FAAOCAgEAnFZvAX7RvUz1isbwJh/k4DgYzDLDKTudQSk0YcbX8ACh -66Ryj5QXvBMsdbRX7gp8CXrc1cqh0DQT+Hern+X+2B50ioUHj3/MeXrKls3N/U/7 -/SMNkPX0XtPGYX2eEeAC7gkE2Qfdpoq3DIMku4NQkv5gdRE+2J2winq14J2by5BS -S7CTKtQ+FjPlnsZlFT5kOwQ/2wyPX1wdaR+v8+khjPPvl/aatxm2hHSco1S1cE5j -2FddUyGbQJJD+tZ3VTNPZNX70Cxqjm0lpu+F6ALEUz65noe8zDUa3qHpimOHZR4R -Kttjd5cUvpoUmRGywO6wT/gUITJDT5+rosuoD6o7BlXGEilXCNQ314cnrUlZp5Gr -RHpejXDbl85IULFzk/bwg2D5zfHhMf1bfHEhYxQUqq/F3pN+aLHsIqKqkHWetUNy -6mSjhEv9DKgma3GX7lZjZuhCVPnHHd/Qj1vfyDBviP4NxDMcU6ij/UgQ8uQKTuEV -V/xuZDDCVRHc6qnNSlSsKWNEz0pAoNZoWRsz+e86i9sgktxChL8Bq4fA1SCC28a5 -g4VCXA9DO2pJNdWY9BW/+mGBDAkgGNLQFwzLSABQ6XaCjGTXOqAHVcweMcDvOrRl -++O/QmueD6i9a5jc2NvLi6Td11n0bt3+qsOR0C5CB8AMTVPNJLFMWx5R9N/pkvo= ------END CERTIFICATE----- - -# Issuer: CN=Certplus Root CA G2 O=Certplus -# Subject: CN=Certplus Root CA G2 O=Certplus -# Label: "Certplus Root CA G2" -# Serial: 1492087096131536844209563509228951875861589 -# MD5 Fingerprint: a7:ee:c4:78:2d:1b:ee:2d:b9:29:ce:d6:a7:96:32:31 -# SHA1 Fingerprint: 4f:65:8e:1f:e9:06:d8:28:02:e9:54:47:41:c9:54:25:5d:69:cc:1a -# SHA256 Fingerprint: 6c:c0:50:41:e6:44:5e:74:69:6c:4c:fb:c9:f8:0f:54:3b:7e:ab:bb:44:b4:ce:6f:78:7c:6a:99:71:c4:2f:17 ------BEGIN CERTIFICATE----- -MIICHDCCAaKgAwIBAgISESDZkc6uo+jF5//pAq/Pc7xVMAoGCCqGSM49BAMDMD4x -CzAJBgNVBAYTAkZSMREwDwYDVQQKDAhDZXJ0cGx1czEcMBoGA1UEAwwTQ2VydHBs -dXMgUm9vdCBDQSBHMjAeFw0xNDA1MjYwMDAwMDBaFw0zODAxMTUwMDAwMDBaMD4x -CzAJBgNVBAYTAkZSMREwDwYDVQQKDAhDZXJ0cGx1czEcMBoGA1UEAwwTQ2VydHBs -dXMgUm9vdCBDQSBHMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABM0PW1aC3/BFGtat -93nwHcmsltaeTpwftEIRyoa/bfuFo8XlGVzX7qY/aWfYeOKmycTbLXku54uNAm8x -Ik0G42ByRZ0OQneezs/lf4WbGOT8zC5y0xaTTsqZY1yhBSpsBqNjMGEwDgYDVR0P -AQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNqDYwJ5jtpMxjwj -FNiPwyCrKGBZMB8GA1UdIwQYMBaAFNqDYwJ5jtpMxjwjFNiPwyCrKGBZMAoGCCqG -SM49BAMDA2gAMGUCMHD+sAvZ94OX7PNVHdTcswYO/jOYnYs5kGuUIe22113WTNch -p+e/IQ8rzfcq3IUHnQIxAIYUFuXcsGXCwI4Un78kFmjlvPl5adytRSv3tjFzzAal -U5ORGpOucGpnutee5WEaXw== ------END CERTIFICATE----- - -# Issuer: CN=OpenTrust Root CA G1 O=OpenTrust -# Subject: CN=OpenTrust Root CA G1 O=OpenTrust -# Label: "OpenTrust Root CA G1" -# Serial: 1492036577811947013770400127034825178844775 -# MD5 Fingerprint: 76:00:cc:81:29:cd:55:5e:88:6a:7a:2e:f7:4d:39:da -# SHA1 Fingerprint: 79:91:e8:34:f7:e2:ee:dd:08:95:01:52:e9:55:2d:14:e9:58:d5:7e -# SHA256 Fingerprint: 56:c7:71:28:d9:8c:18:d9:1b:4c:fd:ff:bc:25:ee:91:03:d4:75:8e:a2:ab:ad:82:6a:90:f3:45:7d:46:0e:b4 ------BEGIN CERTIFICATE----- -MIIFbzCCA1egAwIBAgISESCzkFU5fX82bWTCp59rY45nMA0GCSqGSIb3DQEBCwUA -MEAxCzAJBgNVBAYTAkZSMRIwEAYDVQQKDAlPcGVuVHJ1c3QxHTAbBgNVBAMMFE9w -ZW5UcnVzdCBSb290IENBIEcxMB4XDTE0MDUyNjA4NDU1MFoXDTM4MDExNTAwMDAw -MFowQDELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCU9wZW5UcnVzdDEdMBsGA1UEAwwU -T3BlblRydXN0IFJvb3QgQ0EgRzEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK -AoICAQD4eUbalsUwXopxAy1wpLuwxQjczeY1wICkES3d5oeuXT2R0odsN7faYp6b -wiTXj/HbpqbfRm9RpnHLPhsxZ2L3EVs0J9V5ToybWL0iEA1cJwzdMOWo010hOHQX -/uMftk87ay3bfWAfjH1MBcLrARYVmBSO0ZB3Ij/swjm4eTrwSSTilZHcYTSSjFR0 -77F9jAHiOH3BX2pfJLKOYheteSCtqx234LSWSE9mQxAGFiQD4eCcjsZGT44ameGP -uY4zbGneWK2gDqdkVBFpRGZPTBKnjix9xNRbxQA0MMHZmf4yzgeEtE7NCv82TWLx -p2NX5Ntqp66/K7nJ5rInieV+mhxNaMbBGN4zK1FGSxyO9z0M+Yo0FMT7MzUj8czx -Kselu7Cizv5Ta01BG2Yospb6p64KTrk5M0ScdMGTHPjgniQlQ/GbI4Kq3ywgsNw2 -TgOzfALU5nsaqocTvz6hdLubDuHAk5/XpGbKuxs74zD0M1mKB3IDVedzagMxbm+W -G+Oin6+Sx+31QrclTDsTBM8clq8cIqPQqwWyTBIjUtz9GVsnnB47ev1CI9sjgBPw -vFEVVJSmdz7QdFG9URQIOTfLHzSpMJ1ShC5VkLG631UAC9hWLbFJSXKAqWLXwPYY -EQRVzXR7z2FwefR7LFxckvzluFqrTJOVoSfupb7PcSNCupt2LQIDAQABo2MwYTAO -BgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUl0YhVyE1 -2jZVx/PxN3DlCPaTKbYwHwYDVR0jBBgwFoAUl0YhVyE12jZVx/PxN3DlCPaTKbYw -DQYJKoZIhvcNAQELBQADggIBAB3dAmB84DWn5ph76kTOZ0BP8pNuZtQ5iSas000E -PLuHIT839HEl2ku6q5aCgZG27dmxpGWX4m9kWaSW7mDKHyP7Rbr/jyTwyqkxf3kf -gLMtMrpkZ2CvuVnN35pJ06iCsfmYlIrM4LvgBBuZYLFGZdwIorJGnkSI6pN+VxbS -FXJfLkur1J1juONI5f6ELlgKn0Md/rcYkoZDSw6cMoYsYPXpSOqV7XAp8dUv/TW0 -V8/bhUiZucJvbI/NeJWsZCj9VrDDb8O+WVLhX4SPgPL0DTatdrOjteFkdjpY3H1P -XlZs5VVZV6Xf8YpmMIzUUmI4d7S+KNfKNsSbBfD4Fdvb8e80nR14SohWZ25g/4/I -i+GOvUKpMwpZQhISKvqxnUOOBZuZ2mKtVzazHbYNeS2WuOvyDEsMpZTGMKcmGS3t -TAZQMPH9WD25SxdfGbRqhFS0OE85og2WaMMolP3tLR9Ka0OWLpABEPs4poEL0L91 -09S5zvE/bw4cHjdx5RiHdRk/ULlepEU0rbDK5uUTdg8xFKmOLZTW1YVNcxVPS/Ky -Pu1svf0OnWZzsD2097+o4BGkxK51CUpjAEggpsadCwmKtODmzj7HPiY46SvepghJ -AwSQiumPv+i2tCqjI40cHLI5kqiPAlxAOXXUc0ECd97N4EOH1uS6SsNsEn/+KuYj -1oxx ------END CERTIFICATE----- - -# Issuer: CN=OpenTrust Root CA G2 O=OpenTrust -# Subject: CN=OpenTrust Root CA G2 O=OpenTrust -# Label: "OpenTrust Root CA G2" -# Serial: 1492012448042702096986875987676935573415441 -# MD5 Fingerprint: 57:24:b6:59:24:6b:ae:c8:fe:1c:0c:20:f2:c0:4e:eb -# SHA1 Fingerprint: 79:5f:88:60:c5:ab:7c:3d:92:e6:cb:f4:8d:e1:45:cd:11:ef:60:0b -# SHA256 Fingerprint: 27:99:58:29:fe:6a:75:15:c1:bf:e8:48:f9:c4:76:1d:b1:6c:22:59:29:25:7b:f4:0d:08:94:f2:9e:a8:ba:f2 ------BEGIN CERTIFICATE----- -MIIFbzCCA1egAwIBAgISESChaRu/vbm9UpaPI+hIvyYRMA0GCSqGSIb3DQEBDQUA -MEAxCzAJBgNVBAYTAkZSMRIwEAYDVQQKDAlPcGVuVHJ1c3QxHTAbBgNVBAMMFE9w -ZW5UcnVzdCBSb290IENBIEcyMB4XDTE0MDUyNjAwMDAwMFoXDTM4MDExNTAwMDAw -MFowQDELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCU9wZW5UcnVzdDEdMBsGA1UEAwwU -T3BlblRydXN0IFJvb3QgQ0EgRzIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK -AoICAQDMtlelM5QQgTJT32F+D3Y5z1zCU3UdSXqWON2ic2rxb95eolq5cSG+Ntmh -/LzubKh8NBpxGuga2F8ORAbtp+Dz0mEL4DKiltE48MLaARf85KxP6O6JHnSrT78e -CbY2albz4e6WiWYkBuTNQjpK3eCasMSCRbP+yatcfD7J6xcvDH1urqWPyKwlCm/6 -1UWY0jUJ9gNDlP7ZvyCVeYCYitmJNbtRG6Q3ffyZO6v/v6wNj0OxmXsWEH4db0fE -FY8ElggGQgT4hNYdvJGmQr5J1WqIP7wtUdGejeBSzFfdNTVY27SPJIjki9/ca1TS -gSuyzpJLHB9G+h3Ykst2Z7UJmQnlrBcUVXDGPKBWCgOz3GIZ38i1MH/1PCZ1Eb3X -G7OHngevZXHloM8apwkQHZOJZlvoPGIytbU6bumFAYueQ4xncyhZW+vj3CzMpSZy -YhK05pyDRPZRpOLAeiRXyg6lPzq1O4vldu5w5pLeFlwoW5cZJ5L+epJUzpM5ChaH -vGOz9bGTXOBut9Dq+WIyiET7vycotjCVXRIouZW+j1MY5aIYFuJWpLIsEPUdN6b4 -t/bQWVyJ98LVtZR00dX+G7bw5tYee9I8y6jj9RjzIR9u701oBnstXW5DiabA+aC/ -gh7PU3+06yzbXfZqfUAkBXKJOAGTy3HCOV0GEfZvePg3DTmEJwIDAQABo2MwYTAO -BgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUajn6QiL3 -5okATV59M4PLuG53hq8wHwYDVR0jBBgwFoAUajn6QiL35okATV59M4PLuG53hq8w -DQYJKoZIhvcNAQENBQADggIBAJjLq0A85TMCl38th6aP1F5Kr7ge57tx+4BkJamz -Gj5oXScmp7oq4fBXgwpkTx4idBvpkF/wrM//T2h6OKQQbA2xx6R3gBi2oihEdqc0 -nXGEL8pZ0keImUEiyTCYYW49qKgFbdEfwFFEVn8nNQLdXpgKQuswv42hm1GqO+qT -RmTFAHneIWv2V6CG1wZy7HBGS4tz3aAhdT7cHcCP009zHIXZ/n9iyJVvttN7jLpT -wm+bREx50B1ws9efAvSyB7DH5fitIw6mVskpEndI2S9G/Tvw/HRwkqWOOAgfZDC2 -t0v7NqwQjqBSM2OdAzVWxWm9xiNaJ5T2pBL4LTM8oValX9YZ6e18CL13zSdkzJTa -TkZQh+D5wVOAHrut+0dSixv9ovneDiK3PTNZbNTe9ZUGMg1RGUFcPk8G97krgCf2 -o6p6fAbhQ8MTOWIaNr3gKC6UAuQpLmBVrkA9sHSSXvAgZJY/X0VdiLWK2gKgW0VU -3jg9CcCoSmVGFvyqv1ROTVu+OEO3KMqLM6oaJbolXCkvW0pujOotnCr2BXbgd5eA -iN1nE28daCSLT7d0geX0YJ96Vdc+N9oWaz53rK4YcJUIeSkDiv7BO7M/Gg+kO14f -WKGVyasvc0rQLW6aWQ9VGHgtPFGml4vmu7JwqkwR3v98KzfUetF3NI/n+UL3PIEM -S1IK ------END CERTIFICATE----- - -# Issuer: CN=OpenTrust Root CA G3 O=OpenTrust -# Subject: CN=OpenTrust Root CA G3 O=OpenTrust -# Label: "OpenTrust Root CA G3" -# Serial: 1492104908271485653071219941864171170455615 -# MD5 Fingerprint: 21:37:b4:17:16:92:7b:67:46:70:a9:96:d7:a8:13:24 -# SHA1 Fingerprint: 6e:26:64:f3:56:bf:34:55:bf:d1:93:3f:7c:01:de:d8:13:da:8a:a6 -# SHA256 Fingerprint: b7:c3:62:31:70:6e:81:07:8c:36:7c:b8:96:19:8f:1e:32:08:dd:92:69:49:dd:8f:57:09:a4:10:f7:5b:62:92 ------BEGIN CERTIFICATE----- -MIICITCCAaagAwIBAgISESDm+Ez8JLC+BUCs2oMbNGA/MAoGCCqGSM49BAMDMEAx -CzAJBgNVBAYTAkZSMRIwEAYDVQQKDAlPcGVuVHJ1c3QxHTAbBgNVBAMMFE9wZW5U -cnVzdCBSb290IENBIEczMB4XDTE0MDUyNjAwMDAwMFoXDTM4MDExNTAwMDAwMFow -QDELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCU9wZW5UcnVzdDEdMBsGA1UEAwwUT3Bl -blRydXN0IFJvb3QgQ0EgRzMwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARK7liuTcpm -3gY6oxH84Bjwbhy6LTAMidnW7ptzg6kjFYwvWYpa3RTqnVkrQ7cG7DK2uu5Bta1d -oYXM6h0UZqNnfkbilPPntlahFVmhTzeXuSIevRHr9LIfXsMUmuXZl5mjYzBhMA4G -A1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRHd8MUi2I5 -DMlv4VBN0BBY3JWIbTAfBgNVHSMEGDAWgBRHd8MUi2I5DMlv4VBN0BBY3JWIbTAK -BggqhkjOPQQDAwNpADBmAjEAj6jcnboMBBf6Fek9LykBl7+BFjNAk2z8+e2AcG+q -j9uEwov1NcoG3GRvaBbhj5G5AjEA2Euly8LQCGzpGPta3U1fJAuwACEl74+nBCZx -4nxp5V2a+EEfOzmTk51V6s2N8fvB ------END CERTIFICATE----- - -# Issuer: CN=ISRG Root X1 O=Internet Security Research Group -# Subject: CN=ISRG Root X1 O=Internet Security Research Group -# Label: "ISRG Root X1" -# Serial: 172886928669790476064670243504169061120 -# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e -# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8 -# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6 ------BEGIN CERTIFICATE----- -MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw -TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh -cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4 -WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu -ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY -MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc -h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+ -0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U -A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW -T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH -B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC -B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv -KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn -OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn -jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw -qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI -rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV -HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq -hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL -ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ -3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK -NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5 -ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur -TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC -jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc -oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq -4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA -mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d -emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc= ------END CERTIFICATE----- - -# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM -# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM -# Label: "AC RAIZ FNMT-RCM" -# Serial: 485876308206448804701554682760554759 -# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d -# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20 -# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa ------BEGIN CERTIFICATE----- -MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx -CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ -WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ -BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG -Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/ -yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf -BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz -WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF -tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z -374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC -IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL -mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7 -wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS -MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2 -ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet -UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw -AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H -YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3 -LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD -nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1 -RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM -LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf -77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N -JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm -fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp -6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp -1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B -9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok -RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv -uu8wd+RU4riEmViAqhOLUTpPSPaLtrM= ------END CERTIFICATE----- - -# Issuer: CN=Amazon Root CA 1 O=Amazon -# Subject: CN=Amazon Root CA 1 O=Amazon -# Label: "Amazon Root CA 1" -# Serial: 143266978916655856878034712317230054538369994 -# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6 -# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16 -# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e ------BEGIN CERTIFICATE----- -MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF -ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 -b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL -MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv -b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj -ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM -9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw -IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6 -VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L -93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm -jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC -AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA -A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI -U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs -N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv -o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU -5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy -rqXRfboQnoZsG4q5WTP468SQvvG5 ------END CERTIFICATE----- - -# Issuer: CN=Amazon Root CA 2 O=Amazon -# Subject: CN=Amazon Root CA 2 O=Amazon -# Label: "Amazon Root CA 2" -# Serial: 143266982885963551818349160658925006970653239 -# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66 -# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a -# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4 ------BEGIN CERTIFICATE----- -MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF -ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 -b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL -MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv -b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK -gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ -W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg -1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K -8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r -2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me -z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR -8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj -mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz -7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6 -+XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI -0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB -Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm -UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2 -LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY -+gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS -k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl -7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm -btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl -urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+ -fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63 -n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE -76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H -9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT -4PsJYGw= ------END CERTIFICATE----- - -# Issuer: CN=Amazon Root CA 3 O=Amazon -# Subject: CN=Amazon Root CA 3 O=Amazon -# Label: "Amazon Root CA 3" -# Serial: 143266986699090766294700635381230934788665930 -# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87 -# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e -# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4 ------BEGIN CERTIFICATE----- -MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5 -MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g -Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG -A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg -Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl -ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j -QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr -ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr -BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM -YyRIHN8wfdVoOw== ------END CERTIFICATE----- - -# Issuer: CN=Amazon Root CA 4 O=Amazon -# Subject: CN=Amazon Root CA 4 O=Amazon -# Label: "Amazon Root CA 4" -# Serial: 143266989758080763974105200630763877849284878 -# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd -# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be -# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92 ------BEGIN CERTIFICATE----- -MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5 -MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g -Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG -A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg -Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi -9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk -M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB -/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB -MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw -CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW -1KyLa2tJElMzrdfkviT8tQp21KW8EA== ------END CERTIFICATE----- - -# Issuer: CN=LuxTrust Global Root 2 O=LuxTrust S.A. -# Subject: CN=LuxTrust Global Root 2 O=LuxTrust S.A. -# Label: "LuxTrust Global Root 2" -# Serial: 59914338225734147123941058376788110305822489521 -# MD5 Fingerprint: b2:e1:09:00:61:af:f7:f1:91:6f:c4:ad:8d:5e:3b:7c -# SHA1 Fingerprint: 1e:0e:56:19:0a:d1:8b:25:98:b2:04:44:ff:66:8a:04:17:99:5f:3f -# SHA256 Fingerprint: 54:45:5f:71:29:c2:0b:14:47:c4:18:f9:97:16:8f:24:c5:8f:c5:02:3b:f5:da:5b:e2:eb:6e:1d:d8:90:2e:d5 ------BEGIN CERTIFICATE----- -MIIFwzCCA6ugAwIBAgIUCn6m30tEntpqJIWe5rgV0xZ/u7EwDQYJKoZIhvcNAQEL -BQAwRjELMAkGA1UEBhMCTFUxFjAUBgNVBAoMDUx1eFRydXN0IFMuQS4xHzAdBgNV -BAMMFkx1eFRydXN0IEdsb2JhbCBSb290IDIwHhcNMTUwMzA1MTMyMTU3WhcNMzUw -MzA1MTMyMTU3WjBGMQswCQYDVQQGEwJMVTEWMBQGA1UECgwNTHV4VHJ1c3QgUy5B -LjEfMB0GA1UEAwwWTHV4VHJ1c3QgR2xvYmFsIFJvb3QgMjCCAiIwDQYJKoZIhvcN -AQEBBQADggIPADCCAgoCggIBANeFl78RmOnwYoNMPIf5U2o3C/IPPIfOb9wmKb3F -ibrJgz337spbxm1Jc7TJRqMbNBM/wYlFV/TZsfs2ZUv7COJIcRHIbjuend+JZTem -hfY7RBi2xjcwYkSSl2l9QjAk5A0MiWtj3sXh306pFGxT4GHO9hcvHTy95iJMHZP1 -EMShduxq3sVs35a0VkBCwGKSMKEtFZSg0iAGCW5qbeXrt77U8PEVfIvmTroTzEsn -Xpk8F12PgX8zPU/TPxvsXD/wPEx1bvKm1Z3aLQdjAsZy6ZS8TEmVT4hSyNvoaYL4 -zDRbIvCGp4m9SAptZoFtyMhk+wHh9OHe2Z7d21vUKpkmFRseTJIpgp7VkoGSQXAZ -96Tlk0u8d2cx3Rz9MXANF5kM+Qw5GSoXtTBxVdUPrljhPS80m8+f9niFwpN6cj5m -j5wWEWCPnolvZ77gR1o7DJpni89Gxq44o/KnvObWhWszJHAiS8sIm7vI+AIpHb4g -DEa/a4ebsypmQjVGbKq6rfmYe+lQVRQxv7HaLe2ArWgk+2mr2HETMOZns4dA/Yl+ -8kPREd8vZS9kzl8UubG/Mb2HeFpZZYiq/FkySIbWTLkpS5XTdvN3JW1CHDiDTf2j -X5t/Lax5Gw5CMZdjpPuKadUiDTSQMC6otOBttpSsvItO13D8xTiOZCXhTTmQzsmH -hFhxAgMBAAGjgagwgaUwDwYDVR0TAQH/BAUwAwEB/zBCBgNVHSAEOzA5MDcGByuB -KwEBAQowLDAqBggrBgEFBQcCARYeaHR0cHM6Ly9yZXBvc2l0b3J5Lmx1eHRydXN0 -Lmx1MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBT/GCh2+UgFLKGu8SsbK7JT -+Et8szAdBgNVHQ4EFgQU/xgodvlIBSyhrvErGyuyU/hLfLMwDQYJKoZIhvcNAQEL -BQADggIBAGoZFO1uecEsh9QNcH7X9njJCwROxLHOk3D+sFTAMs2ZMGQXvw/l4jP9 -BzZAcg4atmpZ1gDlaCDdLnINH2pkMSCEfUmmWjfrRcmF9dTHF5kH5ptV5AzoqbTO -jFu1EVzPig4N1qx3gf4ynCSecs5U89BvolbW7MM3LGVYvlcAGvI1+ut7MV3CwRI9 -loGIlonBWVx65n9wNOeD4rHh4bhY79SV5GCc8JaXcozrhAIuZY+kt9J/Z93I055c -qqmkoCUUBpvsT34tC38ddfEz2O3OuHVtPlu5mB0xDVbYQw8wkbIEa91WvpWAVWe+ -2M2D2RjuLg+GLZKecBPs3lHJQ3gCpU3I+V/EkVhGFndadKpAvAefMLmx9xIX3eP/ -JEAdemrRTxgKqpAd60Ae36EeRJIQmvKN4dFLRp7oRUKX6kWZ8+xm1QL68qZKJKre -zrnK+T+Tb/mjuuqlPpmt/f97mfVl7vBZKGfXkJWkE4SphMHozs51k2MavDzq1WQf -LSoSOcbDWjLtR5EWDrw4wVDej8oqkDQc7kGUnF4ZLvhFSZl0kbAEb+MEWrGrKqv+ -x9CWttrhSmQGbmBNvUJO/3jaJMobtNeWOWyu8Q6qp31IiyBMz2TWuJdGsE7RKlY6 -oJO9r4Ak4Ap+58rVyuiFVdw2KuGUaJPHZnJED4AhMmwlxyOAgwrr ------END CERTIFICATE----- - -# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM -# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM -# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1" -# Serial: 1 -# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49 -# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca -# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16 ------BEGIN CERTIFICATE----- -MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx -GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp -bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w -KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0 -BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy -dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG -EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll -IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU -QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT -TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg -LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7 -a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr -LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr -N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X -YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/ -iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f -AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH -V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL -BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh -AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf -IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4 -lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c -8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf -lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM= ------END CERTIFICATE----- - -# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. -# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD. -# Label: "GDCA TrustAUTH R5 ROOT" -# Serial: 9009899650740120186 -# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4 -# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4 -# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93 ------BEGIN CERTIFICATE----- -MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE -BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ -IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0 -MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV -BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w -HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF -AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj -Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj -TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u -KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj -qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm -MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12 -ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP -zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk -L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC -jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA -HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC -AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB -/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg -p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm -DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5 -COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry -L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf -JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg -IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io -2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV -09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ -XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq -T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe -MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g== ------END CERTIFICATE----- - -# Issuer: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Subject: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Label: "TrustCor RootCert CA-1" -# Serial: 15752444095811006489 -# MD5 Fingerprint: 6e:85:f1:dc:1a:00:d3:22:d5:b2:b2:ac:6b:37:05:45 -# SHA1 Fingerprint: ff:bd:cd:e7:82:c8:43:5e:3c:6f:26:86:5c:ca:a8:3a:45:5b:c3:0a -# SHA256 Fingerprint: d4:0e:9c:86:cd:8f:e4:68:c1:77:69:59:f4:9e:a7:74:fa:54:86:84:b6:c4:06:f3:90:92:61:f4:dc:e2:57:5c ------BEGIN CERTIFICATE----- -MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYD -VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk -MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U -cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29y -IFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkxMjMxMTcyMzE2WjCB -pDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFuYW1h -IENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUG -A1UECwweVHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZU -cnVzdENvciBSb290Q2VydCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB -CgKCAQEAv463leLCJhJrMxnHQFgKq1mqjQCj/IDHUHuO1CAmujIS2CNUSSUQIpid -RtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4pQa81QBeCQryJ3pS/C3V -seq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0JEsq1pme -9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CV -EY4hgLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorW -hnAbJN7+KIor0Gqw/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/ -DeOxCbeKyKsZn3MzUOcwHwYDVR0jBBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcw -DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQAD -ggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5mDo4Nvu7Zp5I -/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf -ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZ -yonnMlo2HD6CqFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djts -L1Ac59v2Z3kf9YKVmgenFK+P3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdN -zl/HHk484IkzlQsPpTLWPFp5LBk= ------END CERTIFICATE----- - -# Issuer: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Subject: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Label: "TrustCor RootCert CA-2" -# Serial: 2711694510199101698 -# MD5 Fingerprint: a2:e1:f8:18:0b:ba:45:d5:c7:41:2a:bb:37:52:45:64 -# SHA1 Fingerprint: b8:be:6d:cb:56:f1:55:b9:63:d4:12:ca:4e:06:34:c7:94:b2:1c:c0 -# SHA256 Fingerprint: 07:53:e9:40:37:8c:1b:d5:e3:83:6e:39:5d:ae:a5:cb:83:9e:50:46:f1:bd:0e:ae:19:51:cf:10:fe:c7:c9:65 ------BEGIN CERTIFICATE----- -MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNV -BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw -IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy -dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEfMB0GA1UEAwwWVHJ1c3RDb3Ig -Um9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEyMzExNzI2MzlaMIGk -MQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEg -Q2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYD -VQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRy -dXN0Q29yIFJvb3RDZXJ0IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK -AoICAQCnIG7CKqJiJJWQdsg4foDSq8GbZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+ -QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9NkRvRUqdw6VC0xK5mC8tkq -1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1oYxOdqHp -2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nK -DOObXUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hape -az6LMvYHL1cEksr1/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF -3wP+TfSvPd9cW436cOGlfifHhi5qjxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88 -oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQPeSghYA2FFn3XVDjxklb9tTNM -g9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+CtgrKAmrhQhJ8Z3 -mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh -8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAd -BgNVHQ4EFgQU2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6U -nrybPZx9mCAZ5YwwYrIwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYw -DQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/hOsh80QA9z+LqBrWyOrsGS2h60COX -dKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnpkpfbsEZC89NiqpX+ -MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv2wnL -/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RX -CI/hOWB3S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYa -ZH9bDTMJBzN7Bj8RpFxwPIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW -2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dvDDqPys/cA8GiCcjl/YBeyGBCARsaU1q7 -N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYURpFHmygk71dSTlxCnKr3 -Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANExdqtvArB -As8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp -5KeXRKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu -1uwJ ------END CERTIFICATE----- - -# Issuer: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Subject: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority -# Label: "TrustCor ECA-1" -# Serial: 9548242946988625984 -# MD5 Fingerprint: 27:92:23:1d:0a:f5:40:7c:e9:e6:6b:9d:d8:f5:e7:6c -# SHA1 Fingerprint: 58:d1:df:95:95:67:6b:63:c0:f0:5b:1c:17:4d:8b:84:0b:c8:78:bd -# SHA256 Fingerprint: 5a:88:5d:b1:9c:01:d9:12:c5:75:93:88:93:8c:af:bb:df:03:1a:b2:d4:8e:91:ee:15:58:9b:42:97:1d:03:9c ------BEGIN CERTIFICATE----- -MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYD -VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk -MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U -cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxFzAVBgNVBAMMDlRydXN0Q29y -IEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3MjgwN1owgZwxCzAJBgNV -BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw -IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy -dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3Ig -RUNBLTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb -3w9U73NjKYKtR8aja+3+XzP4Q1HpGjORMRegdMTUpwHmspI+ap3tDvl0mEDTPwOA -BoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23xFUfJ3zSCNV2HykVh0A5 -3ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmcp0yJF4Ou -owReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/ -wZ0+fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZF -ZtS6mFjBAgMBAAGjYzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAf -BgNVHSMEGDAWgBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/ -MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAQEABT41XBVwm8nHc2Fv -civUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u/ukZMjgDfxT2 -AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F -hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50 -soIipX1TH0XsJ5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BI -WJZpTdwHjFGTot+fDz2LYLSCjaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1Wi -tJ/X5g== ------END CERTIFICATE----- - -# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation -# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation -# Label: "SSL.com Root Certification Authority RSA" -# Serial: 8875640296558310041 -# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29 -# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb -# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69 ------BEGIN CERTIFICATE----- -MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE -BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK -DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp -Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz -OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv -dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv -bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN -AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R -xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX -qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC -C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3 -6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh -/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF -YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E -JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc -US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8 -ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm -+Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi -M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV -HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G -A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV -cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc -Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs -PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/ -q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0 -cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr -a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I -H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y -K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu -nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf -oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY -Ic2wBlX7Jz9TkHCpBB5XJ7k= ------END CERTIFICATE----- - -# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation -# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation -# Label: "SSL.com Root Certification Authority ECC" -# Serial: 8495723813297216424 -# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e -# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a -# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65 ------BEGIN CERTIFICATE----- -MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC -VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T -U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0 -aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz -WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0 -b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS -b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB -BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI -7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg -CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud -EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD -VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T -kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+ -gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl ------END CERTIFICATE----- - -# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation -# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation -# Label: "SSL.com EV Root Certification Authority RSA R2" -# Serial: 6248227494352943350 -# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95 -# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a -# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c ------BEGIN CERTIFICATE----- -MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV -BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE -CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy -dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy -MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G -A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD -DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy -MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq -M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf -OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa -4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9 -HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR -aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA -b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ -Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV -PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO -pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu -UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY -MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV -HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4 -9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW -s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5 -Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg -cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM -79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz -/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt -ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm -Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK -QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ -w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi -S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07 -mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w== ------END CERTIFICATE----- - -# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation -# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation -# Label: "SSL.com EV Root Certification Authority ECC" -# Serial: 3182246526754555285 -# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90 -# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d -# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8 ------BEGIN CERTIFICATE----- -MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC -VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T -U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp -Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx -NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv -dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv -bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49 -AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA -VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku -WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP -MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX -5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ -ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg -h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg== ------END CERTIFICATE----- diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/certs.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/certs.py deleted file mode 100644 index 07e64750..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/certs.py +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- - -""" -certs.py -~~~~~~~~ - -This module returns the preferred default CA certificate bundle. - -If you are packaging Requests, e.g., for a Linux distribution or a managed -environment, you can change the definition of where() to return a separately -packaged CA bundle. -""" -import os.path - -try: - from certifi import where -except ImportError: - def where(): - """Return the preferred certificate bundle.""" - # vendored bundle inside Requests - return os.path.join(os.path.dirname(__file__), 'cacert.pem') - -if __name__ == '__main__': - print(where()) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/compat.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/compat.py deleted file mode 100644 index 70edff78..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/compat.py +++ /dev/null @@ -1,62 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -pythoncompat -""" - -from .packages import chardet - -import sys - -# ------- -# Pythons -# ------- - -# Syntax sugar. -_ver = sys.version_info - -#: Python 2.x? -is_py2 = (_ver[0] == 2) - -#: Python 3.x? -is_py3 = (_ver[0] == 3) - -try: - import simplejson as json -except (ImportError, SyntaxError): - # simplejson does not support Python 3.2, it throws a SyntaxError - # because of u'...' Unicode literals. - import json - -# --------- -# Specifics -# --------- - -if is_py2: - from urllib import quote, unquote, quote_plus, unquote_plus, urlencode, getproxies, proxy_bypass - from urlparse import urlparse, urlunparse, urljoin, urlsplit, urldefrag - from urllib2 import parse_http_list - import cookielib - from Cookie import Morsel - from StringIO import StringIO - from .packages.urllib3.packages.ordered_dict import OrderedDict - - builtin_str = str - bytes = str - str = unicode - basestring = basestring - numeric_types = (int, long, float) - -elif is_py3: - from urllib.parse import urlparse, urlunparse, urljoin, urlsplit, urlencode, quote, unquote, quote_plus, unquote_plus, urldefrag - from urllib.request import parse_http_list, getproxies, proxy_bypass - from http import cookiejar as cookielib - from http.cookies import Morsel - from io import StringIO - from collections import OrderedDict - - builtin_str = str - str = str - bytes = bytes - basestring = (str, bytes) - numeric_types = (int, float) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cookies.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cookies.py deleted file mode 100644 index 1fbc934c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/cookies.py +++ /dev/null @@ -1,479 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -Compatibility code to be able to use `cookielib.CookieJar` with requests. - -requests.utils imports from here, so be careful with imports. -""" - -import copy -import time -import collections -from .compat import cookielib, urlparse, urlunparse, Morsel - -try: - import threading - # grr, pyflakes: this fixes "redefinition of unused 'threading'" - threading -except ImportError: - import dummy_threading as threading - - -class MockRequest(object): - """Wraps a `requests.Request` to mimic a `urllib2.Request`. - - The code in `cookielib.CookieJar` expects this interface in order to correctly - manage cookie policies, i.e., determine whether a cookie can be set, given the - domains of the request and the cookie. - - The original request object is read-only. The client is responsible for collecting - the new headers via `get_new_headers()` and interpreting them appropriately. You - probably want `get_cookie_header`, defined below. - """ - - def __init__(self, request): - self._r = request - self._new_headers = {} - self.type = urlparse(self._r.url).scheme - - def get_type(self): - return self.type - - def get_host(self): - return urlparse(self._r.url).netloc - - def get_origin_req_host(self): - return self.get_host() - - def get_full_url(self): - # Only return the response's URL if the user hadn't set the Host - # header - if not self._r.headers.get('Host'): - return self._r.url - # If they did set it, retrieve it and reconstruct the expected domain - host = self._r.headers['Host'] - parsed = urlparse(self._r.url) - # Reconstruct the URL as we expect it - return urlunparse([ - parsed.scheme, host, parsed.path, parsed.params, parsed.query, - parsed.fragment - ]) - - def is_unverifiable(self): - return True - - def has_header(self, name): - return name in self._r.headers or name in self._new_headers - - def get_header(self, name, default=None): - return self._r.headers.get(name, self._new_headers.get(name, default)) - - def add_header(self, key, val): - """cookielib has no legitimate use for this method; add it back if you find one.""" - raise NotImplementedError("Cookie headers should be added with add_unredirected_header()") - - def add_unredirected_header(self, name, value): - self._new_headers[name] = value - - def get_new_headers(self): - return self._new_headers - - @property - def unverifiable(self): - return self.is_unverifiable() - - @property - def origin_req_host(self): - return self.get_origin_req_host() - - @property - def host(self): - return self.get_host() - - -class MockResponse(object): - """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`. - - ...what? Basically, expose the parsed HTTP headers from the server response - the way `cookielib` expects to see them. - """ - - def __init__(self, headers): - """Make a MockResponse for `cookielib` to read. - - :param headers: a httplib.HTTPMessage or analogous carrying the headers - """ - self._headers = headers - - def info(self): - return self._headers - - def getheaders(self, name): - self._headers.getheaders(name) - - -def extract_cookies_to_jar(jar, request, response): - """Extract the cookies from the response into a CookieJar. - - :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar) - :param request: our own requests.Request object - :param response: urllib3.HTTPResponse object - """ - if not (hasattr(response, '_original_response') and - response._original_response): - return - # the _original_response field is the wrapped httplib.HTTPResponse object, - req = MockRequest(request) - # pull out the HTTPMessage with the headers and put it in the mock: - res = MockResponse(response._original_response.msg) - jar.extract_cookies(res, req) - - -def get_cookie_header(jar, request): - """Produce an appropriate Cookie header string to be sent with `request`, or None.""" - r = MockRequest(request) - jar.add_cookie_header(r) - return r.get_new_headers().get('Cookie') - - -def remove_cookie_by_name(cookiejar, name, domain=None, path=None): - """Unsets a cookie by name, by default over all domains and paths. - - Wraps CookieJar.clear(), is O(n). - """ - clearables = [] - for cookie in cookiejar: - if cookie.name == name: - if domain is None or domain == cookie.domain: - if path is None or path == cookie.path: - clearables.append((cookie.domain, cookie.path, cookie.name)) - - for domain, path, name in clearables: - cookiejar.clear(domain, path, name) - - -class CookieConflictError(RuntimeError): - """There are two cookies that meet the criteria specified in the cookie jar. - Use .get and .set and include domain and path args in order to be more specific.""" - - -class RequestsCookieJar(cookielib.CookieJar, collections.MutableMapping): - """Compatibility class; is a cookielib.CookieJar, but exposes a dict - interface. - - This is the CookieJar we create by default for requests and sessions that - don't specify one, since some clients may expect response.cookies and - session.cookies to support dict operations. - - Requests does not use the dict interface internally; it's just for - compatibility with external client code. All requests code should work - out of the box with externally provided instances of ``CookieJar``, e.g. - ``LWPCookieJar`` and ``FileCookieJar``. - - Unlike a regular CookieJar, this class is pickleable. - - .. warning:: dictionary operations that are normally O(1) may be O(n). - """ - def get(self, name, default=None, domain=None, path=None): - """Dict-like get() that also supports optional domain and path args in - order to resolve naming collisions from using one cookie jar over - multiple domains. - - .. warning:: operation is O(n), not O(1).""" - try: - return self._find_no_duplicates(name, domain, path) - except KeyError: - return default - - def set(self, name, value, **kwargs): - """Dict-like set() that also supports optional domain and path args in - order to resolve naming collisions from using one cookie jar over - multiple domains.""" - # support client code that unsets cookies by assignment of a None value: - if value is None: - remove_cookie_by_name(self, name, domain=kwargs.get('domain'), path=kwargs.get('path')) - return - - if isinstance(value, Morsel): - c = morsel_to_cookie(value) - else: - c = create_cookie(name, value, **kwargs) - self.set_cookie(c) - return c - - def iterkeys(self): - """Dict-like iterkeys() that returns an iterator of names of cookies - from the jar. See itervalues() and iteritems().""" - for cookie in iter(self): - yield cookie.name - - def keys(self): - """Dict-like keys() that returns a list of names of cookies from the - jar. See values() and items().""" - return list(self.iterkeys()) - - def itervalues(self): - """Dict-like itervalues() that returns an iterator of values of cookies - from the jar. See iterkeys() and iteritems().""" - for cookie in iter(self): - yield cookie.value - - def values(self): - """Dict-like values() that returns a list of values of cookies from the - jar. See keys() and items().""" - return list(self.itervalues()) - - def iteritems(self): - """Dict-like iteritems() that returns an iterator of name-value tuples - from the jar. See iterkeys() and itervalues().""" - for cookie in iter(self): - yield cookie.name, cookie.value - - def items(self): - """Dict-like items() that returns a list of name-value tuples from the - jar. See keys() and values(). Allows client-code to call - ``dict(RequestsCookieJar)`` and get a vanilla python dict of key value - pairs.""" - return list(self.iteritems()) - - def list_domains(self): - """Utility method to list all the domains in the jar.""" - domains = [] - for cookie in iter(self): - if cookie.domain not in domains: - domains.append(cookie.domain) - return domains - - def list_paths(self): - """Utility method to list all the paths in the jar.""" - paths = [] - for cookie in iter(self): - if cookie.path not in paths: - paths.append(cookie.path) - return paths - - def multiple_domains(self): - """Returns True if there are multiple domains in the jar. - Returns False otherwise.""" - domains = [] - for cookie in iter(self): - if cookie.domain is not None and cookie.domain in domains: - return True - domains.append(cookie.domain) - return False # there is only one domain in jar - - def get_dict(self, domain=None, path=None): - """Takes as an argument an optional domain and path and returns a plain - old Python dict of name-value pairs of cookies that meet the - requirements.""" - dictionary = {} - for cookie in iter(self): - if (domain is None or cookie.domain == domain) and (path is None - or cookie.path == path): - dictionary[cookie.name] = cookie.value - return dictionary - - def __getitem__(self, name): - """Dict-like __getitem__() for compatibility with client code. Throws - exception if there are more than one cookie with name. In that case, - use the more explicit get() method instead. - - .. warning:: operation is O(n), not O(1).""" - - return self._find_no_duplicates(name) - - def __setitem__(self, name, value): - """Dict-like __setitem__ for compatibility with client code. Throws - exception if there is already a cookie of that name in the jar. In that - case, use the more explicit set() method instead.""" - - self.set(name, value) - - def __delitem__(self, name): - """Deletes a cookie given a name. Wraps ``cookielib.CookieJar``'s - ``remove_cookie_by_name()``.""" - remove_cookie_by_name(self, name) - - def set_cookie(self, cookie, *args, **kwargs): - if hasattr(cookie.value, 'startswith') and cookie.value.startswith('"') and cookie.value.endswith('"'): - cookie.value = cookie.value.replace('\\"', '') - return super(RequestsCookieJar, self).set_cookie(cookie, *args, **kwargs) - - def update(self, other): - """Updates this jar with cookies from another CookieJar or dict-like""" - if isinstance(other, cookielib.CookieJar): - for cookie in other: - self.set_cookie(copy.copy(cookie)) - else: - super(RequestsCookieJar, self).update(other) - - def _find(self, name, domain=None, path=None): - """Requests uses this method internally to get cookie values. Takes as - args name and optional domain and path. Returns a cookie.value. If - there are conflicting cookies, _find arbitrarily chooses one. See - _find_no_duplicates if you want an exception thrown if there are - conflicting cookies.""" - for cookie in iter(self): - if cookie.name == name: - if domain is None or cookie.domain == domain: - if path is None or cookie.path == path: - return cookie.value - - raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path)) - - def _find_no_duplicates(self, name, domain=None, path=None): - """Both ``__get_item__`` and ``get`` call this function: it's never - used elsewhere in Requests. Takes as args name and optional domain and - path. Returns a cookie.value. Throws KeyError if cookie is not found - and CookieConflictError if there are multiple cookies that match name - and optionally domain and path.""" - toReturn = None - for cookie in iter(self): - if cookie.name == name: - if domain is None or cookie.domain == domain: - if path is None or cookie.path == path: - if toReturn is not None: # if there are multiple cookies that meet passed in criteria - raise CookieConflictError('There are multiple cookies with name, %r' % (name)) - toReturn = cookie.value # we will eventually return this as long as no cookie conflict - - if toReturn: - return toReturn - raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path)) - - def __getstate__(self): - """Unlike a normal CookieJar, this class is pickleable.""" - state = self.__dict__.copy() - # remove the unpickleable RLock object - state.pop('_cookies_lock') - return state - - def __setstate__(self, state): - """Unlike a normal CookieJar, this class is pickleable.""" - self.__dict__.update(state) - if '_cookies_lock' not in self.__dict__: - self._cookies_lock = threading.RLock() - - def copy(self): - """Return a copy of this RequestsCookieJar.""" - new_cj = RequestsCookieJar() - new_cj.update(self) - return new_cj - - -def _copy_cookie_jar(jar): - if jar is None: - return None - - if hasattr(jar, 'copy'): - # We're dealing with an instane of RequestsCookieJar - return jar.copy() - # We're dealing with a generic CookieJar instance - new_jar = copy.copy(jar) - new_jar.clear() - for cookie in jar: - new_jar.set_cookie(copy.copy(cookie)) - return new_jar - - -def create_cookie(name, value, **kwargs): - """Make a cookie from underspecified parameters. - - By default, the pair of `name` and `value` will be set for the domain '' - and sent on every request (this is sometimes called a "supercookie"). - """ - result = dict( - version=0, - name=name, - value=value, - port=None, - domain='', - path='/', - secure=False, - expires=None, - discard=True, - comment=None, - comment_url=None, - rest={'HttpOnly': None}, - rfc2109=False,) - - badargs = set(kwargs) - set(result) - if badargs: - err = 'create_cookie() got unexpected keyword arguments: %s' - raise TypeError(err % list(badargs)) - - result.update(kwargs) - result['port_specified'] = bool(result['port']) - result['domain_specified'] = bool(result['domain']) - result['domain_initial_dot'] = result['domain'].startswith('.') - result['path_specified'] = bool(result['path']) - - return cookielib.Cookie(**result) - - -def morsel_to_cookie(morsel): - """Convert a Morsel object into a Cookie containing the one k/v pair.""" - - expires = None - if morsel['max-age']: - expires = time.time() + morsel['max-age'] - elif morsel['expires']: - time_template = '%a, %d-%b-%Y %H:%M:%S GMT' - expires = time.mktime( - time.strptime(morsel['expires'], time_template)) - time.timezone - return create_cookie( - comment=morsel['comment'], - comment_url=bool(morsel['comment']), - discard=False, - domain=morsel['domain'], - expires=expires, - name=morsel.key, - path=morsel['path'], - port=None, - rest={'HttpOnly': morsel['httponly']}, - rfc2109=False, - secure=bool(morsel['secure']), - value=morsel.value, - version=morsel['version'] or 0, - ) - - -def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True): - """Returns a CookieJar from a key/value dictionary. - - :param cookie_dict: Dict of key/values to insert into CookieJar. - :param cookiejar: (optional) A cookiejar to add the cookies to. - :param overwrite: (optional) If False, will not replace cookies - already in the jar with new ones. - """ - if cookiejar is None: - cookiejar = RequestsCookieJar() - - if cookie_dict is not None: - names_from_jar = [cookie.name for cookie in cookiejar] - for name in cookie_dict: - if overwrite or (name not in names_from_jar): - cookiejar.set_cookie(create_cookie(name, cookie_dict[name])) - - return cookiejar - - -def merge_cookies(cookiejar, cookies): - """Add cookies to cookiejar and returns a merged CookieJar. - - :param cookiejar: CookieJar object to add the cookies to. - :param cookies: Dictionary or CookieJar object to be added. - """ - if not isinstance(cookiejar, cookielib.CookieJar): - raise ValueError('You can only merge into CookieJar') - - if isinstance(cookies, dict): - cookiejar = cookiejar_from_dict( - cookies, cookiejar=cookiejar, overwrite=False) - elif isinstance(cookies, cookielib.CookieJar): - try: - cookiejar.update(cookies) - except AttributeError: - for cookie_in_jar in cookies: - cookiejar.set_cookie(cookie_in_jar) - - return cookiejar diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/exceptions.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/exceptions.py deleted file mode 100644 index 89135a80..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/exceptions.py +++ /dev/null @@ -1,99 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.exceptions -~~~~~~~~~~~~~~~~~~~ - -This module contains the set of Requests' exceptions. - -""" -from .packages.urllib3.exceptions import HTTPError as BaseHTTPError - - -class RequestException(IOError): - """There was an ambiguous exception that occurred while handling your - request.""" - - def __init__(self, *args, **kwargs): - """ - Initialize RequestException with `request` and `response` objects. - """ - response = kwargs.pop('response', None) - self.response = response - self.request = kwargs.pop('request', None) - if (response is not None and not self.request and - hasattr(response, 'request')): - self.request = self.response.request - super(RequestException, self).__init__(*args, **kwargs) - - -class HTTPError(RequestException): - """An HTTP error occurred.""" - - -class ConnectionError(RequestException): - """A Connection error occurred.""" - - -class ProxyError(ConnectionError): - """A proxy error occurred.""" - - -class SSLError(ConnectionError): - """An SSL error occurred.""" - - -class Timeout(RequestException): - """The request timed out. - - Catching this error will catch both - :exc:`~requests.exceptions.ConnectTimeout` and - :exc:`~requests.exceptions.ReadTimeout` errors. - """ - - -class ConnectTimeout(ConnectionError, Timeout): - """The request timed out while trying to connect to the remote server. - - Requests that produced this error are safe to retry. - """ - - -class ReadTimeout(Timeout): - """The server did not send any data in the allotted amount of time.""" - - -class URLRequired(RequestException): - """A valid URL is required to make a request.""" - - -class TooManyRedirects(RequestException): - """Too many redirects.""" - - -class MissingSchema(RequestException, ValueError): - """The URL schema (e.g. http or https) is missing.""" - - -class InvalidSchema(RequestException, ValueError): - """See defaults.py for valid schemas.""" - - -class InvalidURL(RequestException, ValueError): - """ The URL provided was somehow invalid. """ - - -class ChunkedEncodingError(RequestException): - """The server declared chunked encoding but sent an invalid chunk.""" - - -class ContentDecodingError(RequestException, BaseHTTPError): - """Failed to decode response content""" - - -class StreamConsumedError(RequestException, TypeError): - """The content for this response was already consumed""" - - -class RetryError(RequestException): - """Custom retries logic failed""" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/hooks.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/hooks.py deleted file mode 100644 index 5dfaf6b6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/hooks.py +++ /dev/null @@ -1,45 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.hooks -~~~~~~~~~~~~~~ - -This module provides the capabilities for the Requests hooks system. - -Available hooks: - -``response``: - The response generated from a Request. - -""" - - -HOOKS = ['response'] - - -def default_hooks(): - hooks = {} - for event in HOOKS: - hooks[event] = [] - return hooks - -# TODO: response is the only one - - -def dispatch_hook(key, hooks, hook_data, **kwargs): - """Dispatches a hook dictionary on a given piece of data.""" - - hooks = hooks or dict() - - if key in hooks: - hooks = hooks.get(key) - - if hasattr(hooks, '__call__'): - hooks = [hooks] - - for hook in hooks: - _hook_data = hook(hook_data, **kwargs) - if _hook_data is not None: - hook_data = _hook_data - - return hook_data diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/models.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/models.py deleted file mode 100644 index 45b3ea96..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/models.py +++ /dev/null @@ -1,859 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.models -~~~~~~~~~~~~~~~ - -This module contains the primary objects that power Requests. -""" - -import collections -import datetime - -from io import BytesIO, UnsupportedOperation -from .hooks import default_hooks -from .structures import CaseInsensitiveDict - -from .auth import HTTPBasicAuth -from .cookies import cookiejar_from_dict, get_cookie_header, _copy_cookie_jar -from .packages.urllib3.fields import RequestField -from .packages.urllib3.filepost import encode_multipart_formdata -from .packages.urllib3.util import parse_url -from .packages.urllib3.exceptions import ( - DecodeError, ReadTimeoutError, ProtocolError, LocationParseError) -from .exceptions import ( - HTTPError, MissingSchema, InvalidURL, ChunkedEncodingError, - ContentDecodingError, ConnectionError, StreamConsumedError) -from .utils import ( - guess_filename, get_auth_from_url, requote_uri, - stream_decode_response_unicode, to_key_val_list, parse_header_links, - iter_slices, guess_json_utf, super_len, to_native_string) -from .compat import ( - cookielib, urlunparse, urlsplit, urlencode, str, bytes, StringIO, - is_py2, chardet, json, builtin_str, basestring) -from .status_codes import codes - -#: The set of HTTP status codes that indicate an automatically -#: processable redirect. -REDIRECT_STATI = ( - codes.moved, # 301 - codes.found, # 302 - codes.other, # 303 - codes.temporary_redirect, # 307 - codes.permanent_redirect, # 308 -) -DEFAULT_REDIRECT_LIMIT = 30 -CONTENT_CHUNK_SIZE = 10 * 1024 -ITER_CHUNK_SIZE = 512 - -json_dumps = json.dumps - - -class RequestEncodingMixin(object): - @property - def path_url(self): - """Build the path URL to use.""" - - url = [] - - p = urlsplit(self.url) - - path = p.path - if not path: - path = '/' - - url.append(path) - - query = p.query - if query: - url.append('?') - url.append(query) - - return ''.join(url) - - @staticmethod - def _encode_params(data): - """Encode parameters in a piece of data. - - Will successfully encode parameters when passed as a dict or a list of - 2-tuples. Order is retained if data is a list of 2-tuples but arbitrary - if parameters are supplied as a dict. - """ - - if isinstance(data, (str, bytes)): - return data - elif hasattr(data, 'read'): - return data - elif hasattr(data, '__iter__'): - result = [] - for k, vs in to_key_val_list(data): - if isinstance(vs, basestring) or not hasattr(vs, '__iter__'): - vs = [vs] - for v in vs: - if v is not None: - result.append( - (k.encode('utf-8') if isinstance(k, str) else k, - v.encode('utf-8') if isinstance(v, str) else v)) - return urlencode(result, doseq=True) - else: - return data - - @staticmethod - def _encode_files(files, data): - """Build the body for a multipart/form-data request. - - Will successfully encode files when passed as a dict or a list of - 2-tuples. Order is retained if data is a list of 2-tuples but arbitrary - if parameters are supplied as a dict. - - """ - if (not files): - raise ValueError("Files must be provided.") - elif isinstance(data, basestring): - raise ValueError("Data must not be a string.") - - new_fields = [] - fields = to_key_val_list(data or {}) - files = to_key_val_list(files or {}) - - for field, val in fields: - if isinstance(val, basestring) or not hasattr(val, '__iter__'): - val = [val] - for v in val: - if v is not None: - # Don't call str() on bytestrings: in Py3 it all goes wrong. - if not isinstance(v, bytes): - v = str(v) - - new_fields.append( - (field.decode('utf-8') if isinstance(field, bytes) else field, - v.encode('utf-8') if isinstance(v, str) else v)) - - for (k, v) in files: - # support for explicit filename - ft = None - fh = None - if isinstance(v, (tuple, list)): - if len(v) == 2: - fn, fp = v - elif len(v) == 3: - fn, fp, ft = v - else: - fn, fp, ft, fh = v - else: - fn = guess_filename(v) or k - fp = v - - if isinstance(fp, (str, bytes, bytearray)): - fdata = fp - else: - fdata = fp.read() - - rf = RequestField(name=k, data=fdata, - filename=fn, headers=fh) - rf.make_multipart(content_type=ft) - new_fields.append(rf) - - body, content_type = encode_multipart_formdata(new_fields) - - return body, content_type - - -class RequestHooksMixin(object): - def register_hook(self, event, hook): - """Properly register a hook.""" - - if event not in self.hooks: - raise ValueError('Unsupported event specified, with event name "%s"' % (event)) - - if isinstance(hook, collections.Callable): - self.hooks[event].append(hook) - elif hasattr(hook, '__iter__'): - self.hooks[event].extend(h for h in hook if isinstance(h, collections.Callable)) - - def deregister_hook(self, event, hook): - """Deregister a previously registered hook. - Returns True if the hook existed, False if not. - """ - - try: - self.hooks[event].remove(hook) - return True - except ValueError: - return False - - -class Request(RequestHooksMixin): - """A user-created :class:`Request ` object. - - Used to prepare a :class:`PreparedRequest `, which is sent to the server. - - :param method: HTTP method to use. - :param url: URL to send. - :param headers: dictionary of headers to send. - :param files: dictionary of {filename: fileobject} files to multipart upload. - :param data: the body to attach to the request. If a dictionary is provided, form-encoding will take place. - :param json: json for the body to attach to the request (if data is not specified). - :param params: dictionary of URL parameters to append to the URL. - :param auth: Auth handler or (user, pass) tuple. - :param cookies: dictionary or CookieJar of cookies to attach to this request. - :param hooks: dictionary of callback hooks, for internal usage. - - Usage:: - - >>> import requests - >>> req = requests.Request('GET', 'http://httpbin.org/get') - >>> req.prepare() - - - """ - def __init__(self, - method=None, - url=None, - headers=None, - files=None, - data=None, - params=None, - auth=None, - cookies=None, - hooks=None, - json=None): - - # Default empty dicts for dict params. - data = [] if data is None else data - files = [] if files is None else files - headers = {} if headers is None else headers - params = {} if params is None else params - hooks = {} if hooks is None else hooks - - self.hooks = default_hooks() - for (k, v) in list(hooks.items()): - self.register_hook(event=k, hook=v) - - self.method = method - self.url = url - self.headers = headers - self.files = files - self.data = data - self.json = json - self.params = params - self.auth = auth - self.cookies = cookies - - def __repr__(self): - return '' % (self.method) - - def prepare(self): - """Constructs a :class:`PreparedRequest ` for transmission and returns it.""" - p = PreparedRequest() - p.prepare( - method=self.method, - url=self.url, - headers=self.headers, - files=self.files, - data=self.data, - json=self.json, - params=self.params, - auth=self.auth, - cookies=self.cookies, - hooks=self.hooks, - ) - return p - - -class PreparedRequest(RequestEncodingMixin, RequestHooksMixin): - """The fully mutable :class:`PreparedRequest ` object, - containing the exact bytes that will be sent to the server. - - Generated from either a :class:`Request ` object or manually. - - Usage:: - - >>> import requests - >>> req = requests.Request('GET', 'http://httpbin.org/get') - >>> r = req.prepare() - - - >>> s = requests.Session() - >>> s.send(r) - - - """ - - def __init__(self): - #: HTTP verb to send to the server. - self.method = None - #: HTTP URL to send the request to. - self.url = None - #: dictionary of HTTP headers. - self.headers = None - # The `CookieJar` used to create the Cookie header will be stored here - # after prepare_cookies is called - self._cookies = None - #: request body to send to the server. - self.body = None - #: dictionary of callback hooks, for internal usage. - self.hooks = default_hooks() - - def prepare(self, method=None, url=None, headers=None, files=None, - data=None, params=None, auth=None, cookies=None, hooks=None, - json=None): - """Prepares the entire request with the given parameters.""" - - self.prepare_method(method) - self.prepare_url(url, params) - self.prepare_headers(headers) - self.prepare_cookies(cookies) - self.prepare_body(data, files, json) - self.prepare_auth(auth, url) - # Note that prepare_auth must be last to enable authentication schemes - # such as OAuth to work on a fully prepared request. - - # This MUST go after prepare_auth. Authenticators could add a hook - self.prepare_hooks(hooks) - - def __repr__(self): - return '' % (self.method) - - def copy(self): - p = PreparedRequest() - p.method = self.method - p.url = self.url - p.headers = self.headers.copy() if self.headers is not None else None - p._cookies = _copy_cookie_jar(self._cookies) - p.body = self.body - p.hooks = self.hooks - return p - - def prepare_method(self, method): - """Prepares the given HTTP method.""" - self.method = method - if self.method is not None: - self.method = self.method.upper() - - def prepare_url(self, url, params): - """Prepares the given HTTP URL.""" - #: Accept objects that have string representations. - #: We're unable to blindy call unicode/str functions - #: as this will include the bytestring indicator (b'') - #: on python 3.x. - #: https://github.com/kennethreitz/requests/pull/2238 - if isinstance(url, bytes): - url = url.decode('utf8') - else: - url = unicode(url) if is_py2 else str(url) - - # Don't do any URL preparation for non-HTTP schemes like `mailto`, - # `data` etc to work around exceptions from `url_parse`, which - # handles RFC 3986 only. - if ':' in url and not url.lower().startswith('http'): - self.url = url - return - - # Support for unicode domain names and paths. - try: - scheme, auth, host, port, path, query, fragment = parse_url(url) - except LocationParseError as e: - raise InvalidURL(*e.args) - - if not scheme: - raise MissingSchema("Invalid URL {0!r}: No schema supplied. " - "Perhaps you meant http://{0}?".format( - to_native_string(url, 'utf8'))) - - if not host: - raise InvalidURL("Invalid URL %r: No host supplied" % url) - - # Only want to apply IDNA to the hostname - try: - host = host.encode('idna').decode('utf-8') - except UnicodeError: - raise InvalidURL('URL has an invalid label.') - - # Carefully reconstruct the network location - netloc = auth or '' - if netloc: - netloc += '@' - netloc += host - if port: - netloc += ':' + str(port) - - # Bare domains aren't valid URLs. - if not path: - path = '/' - - if is_py2: - if isinstance(scheme, str): - scheme = scheme.encode('utf-8') - if isinstance(netloc, str): - netloc = netloc.encode('utf-8') - if isinstance(path, str): - path = path.encode('utf-8') - if isinstance(query, str): - query = query.encode('utf-8') - if isinstance(fragment, str): - fragment = fragment.encode('utf-8') - - enc_params = self._encode_params(params) - if enc_params: - if query: - query = '%s&%s' % (query, enc_params) - else: - query = enc_params - - url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment])) - self.url = url - - def prepare_headers(self, headers): - """Prepares the given HTTP headers.""" - - if headers: - self.headers = CaseInsensitiveDict((to_native_string(name), value) for name, value in headers.items()) - else: - self.headers = CaseInsensitiveDict() - - def prepare_body(self, data, files, json=None): - """Prepares the given HTTP body data.""" - - # Check if file, fo, generator, iterator. - # If not, run through normal process. - - # Nottin' on you. - body = None - content_type = None - length = None - - if json is not None: - content_type = 'application/json' - body = json_dumps(json) - - is_stream = all([ - hasattr(data, '__iter__'), - not isinstance(data, (basestring, list, tuple, dict)) - ]) - - try: - length = super_len(data) - except (TypeError, AttributeError, UnsupportedOperation): - length = None - - if is_stream: - body = data - - if files: - raise NotImplementedError('Streamed bodies and files are mutually exclusive.') - - if length is not None: - self.headers['Content-Length'] = builtin_str(length) - else: - self.headers['Transfer-Encoding'] = 'chunked' - else: - # Multi-part file uploads. - if files: - (body, content_type) = self._encode_files(files, data) - else: - if data and json is None: - body = self._encode_params(data) - if isinstance(data, basestring) or hasattr(data, 'read'): - content_type = None - else: - content_type = 'application/x-www-form-urlencoded' - - self.prepare_content_length(body) - - # Add content-type if it wasn't explicitly provided. - if content_type and ('content-type' not in self.headers): - self.headers['Content-Type'] = content_type - - self.body = body - - def prepare_content_length(self, body): - if hasattr(body, 'seek') and hasattr(body, 'tell'): - body.seek(0, 2) - self.headers['Content-Length'] = builtin_str(body.tell()) - body.seek(0, 0) - elif body is not None: - l = super_len(body) - if l: - self.headers['Content-Length'] = builtin_str(l) - elif (self.method not in ('GET', 'HEAD')) and (self.headers.get('Content-Length') is None): - self.headers['Content-Length'] = '0' - - def prepare_auth(self, auth, url=''): - """Prepares the given HTTP auth data.""" - - # If no Auth is explicitly provided, extract it from the URL first. - if auth is None: - url_auth = get_auth_from_url(self.url) - auth = url_auth if any(url_auth) else None - - if auth: - if isinstance(auth, tuple) and len(auth) == 2: - # special-case basic HTTP auth - auth = HTTPBasicAuth(*auth) - - # Allow auth to make its changes. - r = auth(self) - - # Update self to reflect the auth changes. - self.__dict__.update(r.__dict__) - - # Recompute Content-Length - self.prepare_content_length(self.body) - - def prepare_cookies(self, cookies): - """Prepares the given HTTP cookie data. - - This function eventually generates a ``Cookie`` header from the - given cookies using cookielib. Due to cookielib's design, the header - will not be regenerated if it already exists, meaning this function - can only be called once for the life of the - :class:`PreparedRequest ` object. Any subsequent calls - to ``prepare_cookies`` will have no actual effect, unless the "Cookie" - header is removed beforehand.""" - - if isinstance(cookies, cookielib.CookieJar): - self._cookies = cookies - else: - self._cookies = cookiejar_from_dict(cookies) - - cookie_header = get_cookie_header(self._cookies, self) - if cookie_header is not None: - self.headers['Cookie'] = cookie_header - - def prepare_hooks(self, hooks): - """Prepares the given hooks.""" - # hooks can be passed as None to the prepare method and to this - # method. To prevent iterating over None, simply use an empty list - # if hooks is False-y - hooks = hooks or [] - for event in hooks: - self.register_hook(event, hooks[event]) - - -class Response(object): - """The :class:`Response ` object, which contains a - server's response to an HTTP request. - """ - - __attrs__ = [ - '_content', - 'status_code', - 'headers', - 'url', - 'history', - 'encoding', - 'reason', - 'cookies', - 'elapsed', - 'request', - ] - - def __init__(self): - super(Response, self).__init__() - - self._content = False - self._content_consumed = False - - #: Integer Code of responded HTTP Status, e.g. 404 or 200. - self.status_code = None - - #: Case-insensitive Dictionary of Response Headers. - #: For example, ``headers['content-encoding']`` will return the - #: value of a ``'Content-Encoding'`` response header. - self.headers = CaseInsensitiveDict() - - #: File-like object representation of response (for advanced usage). - #: Use of ``raw`` requires that ``stream=True`` be set on the request. - # This requirement does not apply for use internally to Requests. - self.raw = None - - #: Final URL location of Response. - self.url = None - - #: Encoding to decode with when accessing r.text. - self.encoding = None - - #: A list of :class:`Response ` objects from - #: the history of the Request. Any redirect responses will end - #: up here. The list is sorted from the oldest to the most recent request. - self.history = [] - - #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK". - self.reason = None - - #: A CookieJar of Cookies the server sent back. - self.cookies = cookiejar_from_dict({}) - - #: The amount of time elapsed between sending the request - #: and the arrival of the response (as a timedelta). - #: This property specifically measures the time taken between sending - #: the first byte of the request and finishing parsing the headers. It - #: is therefore unaffected by consuming the response content or the - #: value of the ``stream`` keyword argument. - self.elapsed = datetime.timedelta(0) - - #: The :class:`PreparedRequest ` object to which this - #: is a response. - self.request = None - - def __getstate__(self): - # Consume everything; accessing the content attribute makes - # sure the content has been fully read. - if not self._content_consumed: - self.content - - return dict( - (attr, getattr(self, attr, None)) - for attr in self.__attrs__ - ) - - def __setstate__(self, state): - for name, value in state.items(): - setattr(self, name, value) - - # pickled objects do not have .raw - setattr(self, '_content_consumed', True) - setattr(self, 'raw', None) - - def __repr__(self): - return '' % (self.status_code) - - def __bool__(self): - """Returns true if :attr:`status_code` is 'OK'.""" - return self.ok - - def __nonzero__(self): - """Returns true if :attr:`status_code` is 'OK'.""" - return self.ok - - def __iter__(self): - """Allows you to use a response as an iterator.""" - return self.iter_content(128) - - @property - def ok(self): - try: - self.raise_for_status() - except HTTPError: - return False - return True - - @property - def is_redirect(self): - """True if this Response is a well-formed HTTP redirect that could have - been processed automatically (by :meth:`Session.resolve_redirects`). - """ - return ('location' in self.headers and self.status_code in REDIRECT_STATI) - - @property - def is_permanent_redirect(self): - """True if this Response one of the permanant versions of redirect""" - return ('location' in self.headers and self.status_code in (codes.moved_permanently, codes.permanent_redirect)) - - @property - def apparent_encoding(self): - """The apparent encoding, provided by the chardet library""" - return chardet.detect(self.content)['encoding'] - - def iter_content(self, chunk_size=1, decode_unicode=False): - """Iterates over the response data. When stream=True is set on the - request, this avoids reading the content at once into memory for - large responses. The chunk size is the number of bytes it should - read into memory. This is not necessarily the length of each item - returned as decoding can take place. - - If decode_unicode is True, content will be decoded using the best - available encoding based on the response. - """ - def generate(): - try: - # Special case for urllib3. - try: - for chunk in self.raw.stream(chunk_size, decode_content=True): - yield chunk - except ProtocolError as e: - raise ChunkedEncodingError(e) - except DecodeError as e: - raise ContentDecodingError(e) - except ReadTimeoutError as e: - raise ConnectionError(e) - except AttributeError: - # Standard file-like object. - while True: - chunk = self.raw.read(chunk_size) - if not chunk: - break - yield chunk - - self._content_consumed = True - - if self._content_consumed and isinstance(self._content, bool): - raise StreamConsumedError() - # simulate reading small chunks of the content - reused_chunks = iter_slices(self._content, chunk_size) - - stream_chunks = generate() - - chunks = reused_chunks if self._content_consumed else stream_chunks - - if decode_unicode: - chunks = stream_decode_response_unicode(chunks, self) - - return chunks - - def iter_lines(self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=None, delimiter=None): - """Iterates over the response data, one line at a time. When - stream=True is set on the request, this avoids reading the - content at once into memory for large responses. - - .. note:: This method is not reentrant safe. - """ - - pending = None - - for chunk in self.iter_content(chunk_size=chunk_size, decode_unicode=decode_unicode): - - if pending is not None: - chunk = pending + chunk - - if delimiter: - lines = chunk.split(delimiter) - else: - lines = chunk.splitlines() - - if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]: - pending = lines.pop() - else: - pending = None - - for line in lines: - yield line - - if pending is not None: - yield pending - - @property - def content(self): - """Content of the response, in bytes.""" - - if self._content is False: - # Read the contents. - try: - if self._content_consumed: - raise RuntimeError( - 'The content for this response was already consumed') - - if self.status_code == 0: - self._content = None - else: - self._content = bytes().join(self.iter_content(CONTENT_CHUNK_SIZE)) or bytes() - - except AttributeError: - self._content = None - - self._content_consumed = True - # don't need to release the connection; that's been handled by urllib3 - # since we exhausted the data. - return self._content - - @property - def text(self): - """Content of the response, in unicode. - - If Response.encoding is None, encoding will be guessed using - ``chardet``. - - The encoding of the response content is determined based solely on HTTP - headers, following RFC 2616 to the letter. If you can take advantage of - non-HTTP knowledge to make a better guess at the encoding, you should - set ``r.encoding`` appropriately before accessing this property. - """ - - # Try charset from content-type - content = None - encoding = self.encoding - - if not self.content: - return str('') - - # Fallback to auto-detected encoding. - if self.encoding is None: - encoding = self.apparent_encoding - - # Decode unicode from given encoding. - try: - content = str(self.content, encoding, errors='replace') - except (LookupError, TypeError): - # A LookupError is raised if the encoding was not found which could - # indicate a misspelling or similar mistake. - # - # A TypeError can be raised if encoding is None - # - # So we try blindly encoding. - content = str(self.content, errors='replace') - - return content - - def json(self, **kwargs): - """Returns the json-encoded content of a response, if any. - - :param \*\*kwargs: Optional arguments that ``json.loads`` takes. - """ - - if not self.encoding and len(self.content) > 3: - # No encoding set. JSON RFC 4627 section 3 states we should expect - # UTF-8, -16 or -32. Detect which one to use; If the detection or - # decoding fails, fall back to `self.text` (using chardet to make - # a best guess). - encoding = guess_json_utf(self.content) - if encoding is not None: - try: - return json.loads(self.content.decode(encoding), **kwargs) - except UnicodeDecodeError: - # Wrong UTF codec detected; usually because it's not UTF-8 - # but some other 8-bit codec. This is an RFC violation, - # and the server didn't bother to tell us what codec *was* - # used. - pass - return json.loads(self.text, **kwargs) - - @property - def links(self): - """Returns the parsed header links of the response, if any.""" - - header = self.headers.get('link') - - # l = MultiDict() - l = {} - - if header: - links = parse_header_links(header) - - for link in links: - key = link.get('rel') or link.get('url') - l[key] = link - - return l - - def raise_for_status(self): - """Raises stored :class:`HTTPError`, if one occurred.""" - - http_error_msg = '' - - if 400 <= self.status_code < 500: - http_error_msg = '%s Client Error: %s' % (self.status_code, self.reason) - - elif 500 <= self.status_code < 600: - http_error_msg = '%s Server Error: %s' % (self.status_code, self.reason) - - if http_error_msg: - raise HTTPError(http_error_msg, response=self) - - def close(self): - """Releases the connection back to the pool. Once this method has been - called the underlying ``raw`` object must not be accessed again. - - *Note: Should not normally need to be called explicitly.* - """ - return self.raw.release_conn() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/__init__.py deleted file mode 100644 index d62c4b71..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/__init__.py +++ /dev/null @@ -1,3 +0,0 @@ -from __future__ import absolute_import - -from . import urllib3 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/__init__.py deleted file mode 100644 index 82c2a48d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/__init__.py +++ /dev/null @@ -1,32 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -__version__ = "2.3.0" -from sys import version_info - - -def detect(aBuf): - if ((version_info < (3, 0) and isinstance(aBuf, unicode)) or - (version_info >= (3, 0) and not isinstance(aBuf, bytes))): - raise ValueError('Expected a bytes object, not a unicode object') - - from . import universaldetector - u = universaldetector.UniversalDetector() - u.reset() - u.feed(aBuf) - u.close() - return u.result diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5freq.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5freq.py deleted file mode 100644 index 65bffc04..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5freq.py +++ /dev/null @@ -1,925 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# Big5 frequency table -# by Taiwan's Mandarin Promotion Council -# -# -# 128 --> 0.42261 -# 256 --> 0.57851 -# 512 --> 0.74851 -# 1024 --> 0.89384 -# 2048 --> 0.97583 -# -# Ideal Distribution Ratio = 0.74851/(1-0.74851) =2.98 -# Random Distribution Ration = 512/(5401-512)=0.105 -# -# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR - -BIG5_TYPICAL_DISTRIBUTION_RATIO = 0.75 - -#Char to FreqOrder table -BIG5_TABLE_SIZE = 5376 - -Big5CharToFreqOrder = ( - 1,1801,1506, 255,1431, 198, 9, 82, 6,5008, 177, 202,3681,1256,2821, 110, # 16 -3814, 33,3274, 261, 76, 44,2114, 16,2946,2187,1176, 659,3971, 26,3451,2653, # 32 -1198,3972,3350,4202, 410,2215, 302, 590, 361,1964, 8, 204, 58,4510,5009,1932, # 48 - 63,5010,5011, 317,1614, 75, 222, 159,4203,2417,1480,5012,3555,3091, 224,2822, # 64 -3682, 3, 10,3973,1471, 29,2787,1135,2866,1940, 873, 130,3275,1123, 312,5013, # 80 -4511,2052, 507, 252, 682,5014, 142,1915, 124, 206,2947, 34,3556,3204, 64, 604, # 96 -5015,2501,1977,1978, 155,1991, 645, 641,1606,5016,3452, 337, 72, 406,5017, 80, # 112 - 630, 238,3205,1509, 263, 939,1092,2654, 756,1440,1094,3453, 449, 69,2987, 591, # 128 - 179,2096, 471, 115,2035,1844, 60, 50,2988, 134, 806,1869, 734,2036,3454, 180, # 144 - 995,1607, 156, 537,2907, 688,5018, 319,1305, 779,2145, 514,2379, 298,4512, 359, # 160 -2502, 90,2716,1338, 663, 11, 906,1099,2553, 20,2441, 182, 532,1716,5019, 732, # 176 -1376,4204,1311,1420,3206, 25,2317,1056, 113, 399, 382,1950, 242,3455,2474, 529, # 192 -3276, 475,1447,3683,5020, 117, 21, 656, 810,1297,2300,2334,3557,5021, 126,4205, # 208 - 706, 456, 150, 613,4513, 71,1118,2037,4206, 145,3092, 85, 835, 486,2115,1246, # 224 -1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,5022,2128,2359, 347,3815, 221, # 240 -3558,3135,5023,1956,1153,4207, 83, 296,1199,3093, 192, 624, 93,5024, 822,1898, # 256 -2823,3136, 795,2065, 991,1554,1542,1592, 27, 43,2867, 859, 139,1456, 860,4514, # 272 - 437, 712,3974, 164,2397,3137, 695, 211,3037,2097, 195,3975,1608,3559,3560,3684, # 288 -3976, 234, 811,2989,2098,3977,2233,1441,3561,1615,2380, 668,2077,1638, 305, 228, # 304 -1664,4515, 467, 415,5025, 262,2099,1593, 239, 108, 300, 200,1033, 512,1247,2078, # 320 -5026,5027,2176,3207,3685,2682, 593, 845,1062,3277, 88,1723,2038,3978,1951, 212, # 336 - 266, 152, 149, 468,1899,4208,4516, 77, 187,5028,3038, 37, 5,2990,5029,3979, # 352 -5030,5031, 39,2524,4517,2908,3208,2079, 55, 148, 74,4518, 545, 483,1474,1029, # 368 -1665, 217,1870,1531,3138,1104,2655,4209, 24, 172,3562, 900,3980,3563,3564,4519, # 384 - 32,1408,2824,1312, 329, 487,2360,2251,2717, 784,2683, 4,3039,3351,1427,1789, # 400 - 188, 109, 499,5032,3686,1717,1790, 888,1217,3040,4520,5033,3565,5034,3352,1520, # 416 -3687,3981, 196,1034, 775,5035,5036, 929,1816, 249, 439, 38,5037,1063,5038, 794, # 432 -3982,1435,2301, 46, 178,3278,2066,5039,2381,5040, 214,1709,4521, 804, 35, 707, # 448 - 324,3688,1601,2554, 140, 459,4210,5041,5042,1365, 839, 272, 978,2262,2580,3456, # 464 -2129,1363,3689,1423, 697, 100,3094, 48, 70,1231, 495,3139,2196,5043,1294,5044, # 480 -2080, 462, 586,1042,3279, 853, 256, 988, 185,2382,3457,1698, 434,1084,5045,3458, # 496 - 314,2625,2788,4522,2335,2336, 569,2285, 637,1817,2525, 757,1162,1879,1616,3459, # 512 - 287,1577,2116, 768,4523,1671,2868,3566,2526,1321,3816, 909,2418,5046,4211, 933, # 528 -3817,4212,2053,2361,1222,4524, 765,2419,1322, 786,4525,5047,1920,1462,1677,2909, # 544 -1699,5048,4526,1424,2442,3140,3690,2600,3353,1775,1941,3460,3983,4213, 309,1369, # 560 -1130,2825, 364,2234,1653,1299,3984,3567,3985,3986,2656, 525,1085,3041, 902,2001, # 576 -1475, 964,4527, 421,1845,1415,1057,2286, 940,1364,3141, 376,4528,4529,1381, 7, # 592 -2527, 983,2383, 336,1710,2684,1846, 321,3461, 559,1131,3042,2752,1809,1132,1313, # 608 - 265,1481,1858,5049, 352,1203,2826,3280, 167,1089, 420,2827, 776, 792,1724,3568, # 624 -4214,2443,3281,5050,4215,5051, 446, 229, 333,2753, 901,3818,1200,1557,4530,2657, # 640 -1921, 395,2754,2685,3819,4216,1836, 125, 916,3209,2626,4531,5052,5053,3820,5054, # 656 -5055,5056,4532,3142,3691,1133,2555,1757,3462,1510,2318,1409,3569,5057,2146, 438, # 672 -2601,2910,2384,3354,1068, 958,3043, 461, 311,2869,2686,4217,1916,3210,4218,1979, # 688 - 383, 750,2755,2627,4219, 274, 539, 385,1278,1442,5058,1154,1965, 384, 561, 210, # 704 - 98,1295,2556,3570,5059,1711,2420,1482,3463,3987,2911,1257, 129,5060,3821, 642, # 720 - 523,2789,2790,2658,5061, 141,2235,1333, 68, 176, 441, 876, 907,4220, 603,2602, # 736 - 710, 171,3464, 404, 549, 18,3143,2398,1410,3692,1666,5062,3571,4533,2912,4534, # 752 -5063,2991, 368,5064, 146, 366, 99, 871,3693,1543, 748, 807,1586,1185, 22,2263, # 768 - 379,3822,3211,5065,3212, 505,1942,2628,1992,1382,2319,5066, 380,2362, 218, 702, # 784 -1818,1248,3465,3044,3572,3355,3282,5067,2992,3694, 930,3283,3823,5068, 59,5069, # 800 - 585, 601,4221, 497,3466,1112,1314,4535,1802,5070,1223,1472,2177,5071, 749,1837, # 816 - 690,1900,3824,1773,3988,1476, 429,1043,1791,2236,2117, 917,4222, 447,1086,1629, # 832 -5072, 556,5073,5074,2021,1654, 844,1090, 105, 550, 966,1758,2828,1008,1783, 686, # 848 -1095,5075,2287, 793,1602,5076,3573,2603,4536,4223,2948,2302,4537,3825, 980,2503, # 864 - 544, 353, 527,4538, 908,2687,2913,5077, 381,2629,1943,1348,5078,1341,1252, 560, # 880 -3095,5079,3467,2870,5080,2054, 973, 886,2081, 143,4539,5081,5082, 157,3989, 496, # 896 -4224, 57, 840, 540,2039,4540,4541,3468,2118,1445, 970,2264,1748,1966,2082,4225, # 912 -3144,1234,1776,3284,2829,3695, 773,1206,2130,1066,2040,1326,3990,1738,1725,4226, # 928 - 279,3145, 51,1544,2604, 423,1578,2131,2067, 173,4542,1880,5083,5084,1583, 264, # 944 - 610,3696,4543,2444, 280, 154,5085,5086,5087,1739, 338,1282,3096, 693,2871,1411, # 960 -1074,3826,2445,5088,4544,5089,5090,1240, 952,2399,5091,2914,1538,2688, 685,1483, # 976 -4227,2475,1436, 953,4228,2055,4545, 671,2400, 79,4229,2446,3285, 608, 567,2689, # 992 -3469,4230,4231,1691, 393,1261,1792,2401,5092,4546,5093,5094,5095,5096,1383,1672, # 1008 -3827,3213,1464, 522,1119, 661,1150, 216, 675,4547,3991,1432,3574, 609,4548,2690, # 1024 -2402,5097,5098,5099,4232,3045, 0,5100,2476, 315, 231,2447, 301,3356,4549,2385, # 1040 -5101, 233,4233,3697,1819,4550,4551,5102, 96,1777,1315,2083,5103, 257,5104,1810, # 1056 -3698,2718,1139,1820,4234,2022,1124,2164,2791,1778,2659,5105,3097, 363,1655,3214, # 1072 -5106,2993,5107,5108,5109,3992,1567,3993, 718, 103,3215, 849,1443, 341,3357,2949, # 1088 -1484,5110,1712, 127, 67, 339,4235,2403, 679,1412, 821,5111,5112, 834, 738, 351, # 1104 -2994,2147, 846, 235,1497,1881, 418,1993,3828,2719, 186,1100,2148,2756,3575,1545, # 1120 -1355,2950,2872,1377, 583,3994,4236,2581,2995,5113,1298,3699,1078,2557,3700,2363, # 1136 - 78,3829,3830, 267,1289,2100,2002,1594,4237, 348, 369,1274,2197,2178,1838,4552, # 1152 -1821,2830,3701,2757,2288,2003,4553,2951,2758, 144,3358, 882,4554,3995,2759,3470, # 1168 -4555,2915,5114,4238,1726, 320,5115,3996,3046, 788,2996,5116,2831,1774,1327,2873, # 1184 -3997,2832,5117,1306,4556,2004,1700,3831,3576,2364,2660, 787,2023, 506, 824,3702, # 1200 - 534, 323,4557,1044,3359,2024,1901, 946,3471,5118,1779,1500,1678,5119,1882,4558, # 1216 - 165, 243,4559,3703,2528, 123, 683,4239, 764,4560, 36,3998,1793, 589,2916, 816, # 1232 - 626,1667,3047,2237,1639,1555,1622,3832,3999,5120,4000,2874,1370,1228,1933, 891, # 1248 -2084,2917, 304,4240,5121, 292,2997,2720,3577, 691,2101,4241,1115,4561, 118, 662, # 1264 -5122, 611,1156, 854,2386,1316,2875, 2, 386, 515,2918,5123,5124,3286, 868,2238, # 1280 -1486, 855,2661, 785,2216,3048,5125,1040,3216,3578,5126,3146, 448,5127,1525,5128, # 1296 -2165,4562,5129,3833,5130,4242,2833,3579,3147, 503, 818,4001,3148,1568, 814, 676, # 1312 -1444, 306,1749,5131,3834,1416,1030, 197,1428, 805,2834,1501,4563,5132,5133,5134, # 1328 -1994,5135,4564,5136,5137,2198, 13,2792,3704,2998,3149,1229,1917,5138,3835,2132, # 1344 -5139,4243,4565,2404,3580,5140,2217,1511,1727,1120,5141,5142, 646,3836,2448, 307, # 1360 -5143,5144,1595,3217,5145,5146,5147,3705,1113,1356,4002,1465,2529,2530,5148, 519, # 1376 -5149, 128,2133, 92,2289,1980,5150,4003,1512, 342,3150,2199,5151,2793,2218,1981, # 1392 -3360,4244, 290,1656,1317, 789, 827,2365,5152,3837,4566, 562, 581,4004,5153, 401, # 1408 -4567,2252, 94,4568,5154,1399,2794,5155,1463,2025,4569,3218,1944,5156, 828,1105, # 1424 -4245,1262,1394,5157,4246, 605,4570,5158,1784,2876,5159,2835, 819,2102, 578,2200, # 1440 -2952,5160,1502, 436,3287,4247,3288,2836,4005,2919,3472,3473,5161,2721,2320,5162, # 1456 -5163,2337,2068, 23,4571, 193, 826,3838,2103, 699,1630,4248,3098, 390,1794,1064, # 1472 -3581,5164,1579,3099,3100,1400,5165,4249,1839,1640,2877,5166,4572,4573, 137,4250, # 1488 - 598,3101,1967, 780, 104, 974,2953,5167, 278, 899, 253, 402, 572, 504, 493,1339, # 1504 -5168,4006,1275,4574,2582,2558,5169,3706,3049,3102,2253, 565,1334,2722, 863, 41, # 1520 -5170,5171,4575,5172,1657,2338, 19, 463,2760,4251, 606,5173,2999,3289,1087,2085, # 1536 -1323,2662,3000,5174,1631,1623,1750,4252,2691,5175,2878, 791,2723,2663,2339, 232, # 1552 -2421,5176,3001,1498,5177,2664,2630, 755,1366,3707,3290,3151,2026,1609, 119,1918, # 1568 -3474, 862,1026,4253,5178,4007,3839,4576,4008,4577,2265,1952,2477,5179,1125, 817, # 1584 -4254,4255,4009,1513,1766,2041,1487,4256,3050,3291,2837,3840,3152,5180,5181,1507, # 1600 -5182,2692, 733, 40,1632,1106,2879, 345,4257, 841,2531, 230,4578,3002,1847,3292, # 1616 -3475,5183,1263, 986,3476,5184, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562, # 1632 -4010,4011,2954, 967,2761,2665,1349, 592,2134,1692,3361,3003,1995,4258,1679,4012, # 1648 -1902,2188,5185, 739,3708,2724,1296,1290,5186,4259,2201,2202,1922,1563,2605,2559, # 1664 -1871,2762,3004,5187, 435,5188, 343,1108, 596, 17,1751,4579,2239,3477,3709,5189, # 1680 -4580, 294,3582,2955,1693, 477, 979, 281,2042,3583, 643,2043,3710,2631,2795,2266, # 1696 -1031,2340,2135,2303,3584,4581, 367,1249,2560,5190,3585,5191,4582,1283,3362,2005, # 1712 - 240,1762,3363,4583,4584, 836,1069,3153, 474,5192,2149,2532, 268,3586,5193,3219, # 1728 -1521,1284,5194,1658,1546,4260,5195,3587,3588,5196,4261,3364,2693,1685,4262, 961, # 1744 -1673,2632, 190,2006,2203,3841,4585,4586,5197, 570,2504,3711,1490,5198,4587,2633, # 1760 -3293,1957,4588, 584,1514, 396,1045,1945,5199,4589,1968,2449,5200,5201,4590,4013, # 1776 - 619,5202,3154,3294, 215,2007,2796,2561,3220,4591,3221,4592, 763,4263,3842,4593, # 1792 -5203,5204,1958,1767,2956,3365,3712,1174, 452,1477,4594,3366,3155,5205,2838,1253, # 1808 -2387,2189,1091,2290,4264, 492,5206, 638,1169,1825,2136,1752,4014, 648, 926,1021, # 1824 -1324,4595, 520,4596, 997, 847,1007, 892,4597,3843,2267,1872,3713,2405,1785,4598, # 1840 -1953,2957,3103,3222,1728,4265,2044,3714,4599,2008,1701,3156,1551, 30,2268,4266, # 1856 -5207,2027,4600,3589,5208, 501,5209,4267, 594,3478,2166,1822,3590,3479,3591,3223, # 1872 - 829,2839,4268,5210,1680,3157,1225,4269,5211,3295,4601,4270,3158,2341,5212,4602, # 1888 -4271,5213,4015,4016,5214,1848,2388,2606,3367,5215,4603, 374,4017, 652,4272,4273, # 1904 - 375,1140, 798,5216,5217,5218,2366,4604,2269, 546,1659, 138,3051,2450,4605,5219, # 1920 -2254, 612,1849, 910, 796,3844,1740,1371, 825,3845,3846,5220,2920,2562,5221, 692, # 1936 - 444,3052,2634, 801,4606,4274,5222,1491, 244,1053,3053,4275,4276, 340,5223,4018, # 1952 -1041,3005, 293,1168, 87,1357,5224,1539, 959,5225,2240, 721, 694,4277,3847, 219, # 1968 -1478, 644,1417,3368,2666,1413,1401,1335,1389,4019,5226,5227,3006,2367,3159,1826, # 1984 - 730,1515, 184,2840, 66,4607,5228,1660,2958, 246,3369, 378,1457, 226,3480, 975, # 2000 -4020,2959,1264,3592, 674, 696,5229, 163,5230,1141,2422,2167, 713,3593,3370,4608, # 2016 -4021,5231,5232,1186, 15,5233,1079,1070,5234,1522,3224,3594, 276,1050,2725, 758, # 2032 -1126, 653,2960,3296,5235,2342, 889,3595,4022,3104,3007, 903,1250,4609,4023,3481, # 2048 -3596,1342,1681,1718, 766,3297, 286, 89,2961,3715,5236,1713,5237,2607,3371,3008, # 2064 -5238,2962,2219,3225,2880,5239,4610,2505,2533, 181, 387,1075,4024, 731,2190,3372, # 2080 -5240,3298, 310, 313,3482,2304, 770,4278, 54,3054, 189,4611,3105,3848,4025,5241, # 2096 -1230,1617,1850, 355,3597,4279,4612,3373, 111,4280,3716,1350,3160,3483,3055,4281, # 2112 -2150,3299,3598,5242,2797,4026,4027,3009, 722,2009,5243,1071, 247,1207,2343,2478, # 2128 -1378,4613,2010, 864,1437,1214,4614, 373,3849,1142,2220, 667,4615, 442,2763,2563, # 2144 -3850,4028,1969,4282,3300,1840, 837, 170,1107, 934,1336,1883,5244,5245,2119,4283, # 2160 -2841, 743,1569,5246,4616,4284, 582,2389,1418,3484,5247,1803,5248, 357,1395,1729, # 2176 -3717,3301,2423,1564,2241,5249,3106,3851,1633,4617,1114,2086,4285,1532,5250, 482, # 2192 -2451,4618,5251,5252,1492, 833,1466,5253,2726,3599,1641,2842,5254,1526,1272,3718, # 2208 -4286,1686,1795, 416,2564,1903,1954,1804,5255,3852,2798,3853,1159,2321,5256,2881, # 2224 -4619,1610,1584,3056,2424,2764, 443,3302,1163,3161,5257,5258,4029,5259,4287,2506, # 2240 -3057,4620,4030,3162,2104,1647,3600,2011,1873,4288,5260,4289, 431,3485,5261, 250, # 2256 - 97, 81,4290,5262,1648,1851,1558, 160, 848,5263, 866, 740,1694,5264,2204,2843, # 2272 -3226,4291,4621,3719,1687, 950,2479, 426, 469,3227,3720,3721,4031,5265,5266,1188, # 2288 - 424,1996, 861,3601,4292,3854,2205,2694, 168,1235,3602,4293,5267,2087,1674,4622, # 2304 -3374,3303, 220,2565,1009,5268,3855, 670,3010, 332,1208, 717,5269,5270,3603,2452, # 2320 -4032,3375,5271, 513,5272,1209,2882,3376,3163,4623,1080,5273,5274,5275,5276,2534, # 2336 -3722,3604, 815,1587,4033,4034,5277,3605,3486,3856,1254,4624,1328,3058,1390,4035, # 2352 -1741,4036,3857,4037,5278, 236,3858,2453,3304,5279,5280,3723,3859,1273,3860,4625, # 2368 -5281, 308,5282,4626, 245,4627,1852,2480,1307,2583, 430, 715,2137,2454,5283, 270, # 2384 - 199,2883,4038,5284,3606,2727,1753, 761,1754, 725,1661,1841,4628,3487,3724,5285, # 2400 -5286, 587, 14,3305, 227,2608, 326, 480,2270, 943,2765,3607, 291, 650,1884,5287, # 2416 -1702,1226, 102,1547, 62,3488, 904,4629,3489,1164,4294,5288,5289,1224,1548,2766, # 2432 - 391, 498,1493,5290,1386,1419,5291,2056,1177,4630, 813, 880,1081,2368, 566,1145, # 2448 -4631,2291,1001,1035,2566,2609,2242, 394,1286,5292,5293,2069,5294, 86,1494,1730, # 2464 -4039, 491,1588, 745, 897,2963, 843,3377,4040,2767,2884,3306,1768, 998,2221,2070, # 2480 - 397,1827,1195,1970,3725,3011,3378, 284,5295,3861,2507,2138,2120,1904,5296,4041, # 2496 -2151,4042,4295,1036,3490,1905, 114,2567,4296, 209,1527,5297,5298,2964,2844,2635, # 2512 -2390,2728,3164, 812,2568,5299,3307,5300,1559, 737,1885,3726,1210, 885, 28,2695, # 2528 -3608,3862,5301,4297,1004,1780,4632,5302, 346,1982,2222,2696,4633,3863,1742, 797, # 2544 -1642,4043,1934,1072,1384,2152, 896,4044,3308,3727,3228,2885,3609,5303,2569,1959, # 2560 -4634,2455,1786,5304,5305,5306,4045,4298,1005,1308,3728,4299,2729,4635,4636,1528, # 2576 -2610, 161,1178,4300,1983, 987,4637,1101,4301, 631,4046,1157,3229,2425,1343,1241, # 2592 -1016,2243,2570, 372, 877,2344,2508,1160, 555,1935, 911,4047,5307, 466,1170, 169, # 2608 -1051,2921,2697,3729,2481,3012,1182,2012,2571,1251,2636,5308, 992,2345,3491,1540, # 2624 -2730,1201,2071,2406,1997,2482,5309,4638, 528,1923,2191,1503,1874,1570,2369,3379, # 2640 -3309,5310, 557,1073,5311,1828,3492,2088,2271,3165,3059,3107, 767,3108,2799,4639, # 2656 -1006,4302,4640,2346,1267,2179,3730,3230, 778,4048,3231,2731,1597,2667,5312,4641, # 2672 -5313,3493,5314,5315,5316,3310,2698,1433,3311, 131, 95,1504,4049, 723,4303,3166, # 2688 -1842,3610,2768,2192,4050,2028,2105,3731,5317,3013,4051,1218,5318,3380,3232,4052, # 2704 -4304,2584, 248,1634,3864, 912,5319,2845,3732,3060,3865, 654, 53,5320,3014,5321, # 2720 -1688,4642, 777,3494,1032,4053,1425,5322, 191, 820,2121,2846, 971,4643, 931,3233, # 2736 - 135, 664, 783,3866,1998, 772,2922,1936,4054,3867,4644,2923,3234, 282,2732, 640, # 2752 -1372,3495,1127, 922, 325,3381,5323,5324, 711,2045,5325,5326,4055,2223,2800,1937, # 2768 -4056,3382,2224,2255,3868,2305,5327,4645,3869,1258,3312,4057,3235,2139,2965,4058, # 2784 -4059,5328,2225, 258,3236,4646, 101,1227,5329,3313,1755,5330,1391,3314,5331,2924, # 2800 -2057, 893,5332,5333,5334,1402,4305,2347,5335,5336,3237,3611,5337,5338, 878,1325, # 2816 -1781,2801,4647, 259,1385,2585, 744,1183,2272,4648,5339,4060,2509,5340, 684,1024, # 2832 -4306,5341, 472,3612,3496,1165,3315,4061,4062, 322,2153, 881, 455,1695,1152,1340, # 2848 - 660, 554,2154,4649,1058,4650,4307, 830,1065,3383,4063,4651,1924,5342,1703,1919, # 2864 -5343, 932,2273, 122,5344,4652, 947, 677,5345,3870,2637, 297,1906,1925,2274,4653, # 2880 -2322,3316,5346,5347,4308,5348,4309, 84,4310, 112, 989,5349, 547,1059,4064, 701, # 2896 -3613,1019,5350,4311,5351,3497, 942, 639, 457,2306,2456, 993,2966, 407, 851, 494, # 2912 -4654,3384, 927,5352,1237,5353,2426,3385, 573,4312, 680, 921,2925,1279,1875, 285, # 2928 - 790,1448,1984, 719,2168,5354,5355,4655,4065,4066,1649,5356,1541, 563,5357,1077, # 2944 -5358,3386,3061,3498, 511,3015,4067,4068,3733,4069,1268,2572,3387,3238,4656,4657, # 2960 -5359, 535,1048,1276,1189,2926,2029,3167,1438,1373,2847,2967,1134,2013,5360,4313, # 2976 -1238,2586,3109,1259,5361, 700,5362,2968,3168,3734,4314,5363,4315,1146,1876,1907, # 2992 -4658,2611,4070, 781,2427, 132,1589, 203, 147, 273,2802,2407, 898,1787,2155,4071, # 3008 -4072,5364,3871,2803,5365,5366,4659,4660,5367,3239,5368,1635,3872, 965,5369,1805, # 3024 -2699,1516,3614,1121,1082,1329,3317,4073,1449,3873, 65,1128,2848,2927,2769,1590, # 3040 -3874,5370,5371, 12,2668, 45, 976,2587,3169,4661, 517,2535,1013,1037,3240,5372, # 3056 -3875,2849,5373,3876,5374,3499,5375,2612, 614,1999,2323,3877,3110,2733,2638,5376, # 3072 -2588,4316, 599,1269,5377,1811,3735,5378,2700,3111, 759,1060, 489,1806,3388,3318, # 3088 -1358,5379,5380,2391,1387,1215,2639,2256, 490,5381,5382,4317,1759,2392,2348,5383, # 3104 -4662,3878,1908,4074,2640,1807,3241,4663,3500,3319,2770,2349, 874,5384,5385,3501, # 3120 -3736,1859, 91,2928,3737,3062,3879,4664,5386,3170,4075,2669,5387,3502,1202,1403, # 3136 -3880,2969,2536,1517,2510,4665,3503,2511,5388,4666,5389,2701,1886,1495,1731,4076, # 3152 -2370,4667,5390,2030,5391,5392,4077,2702,1216, 237,2589,4318,2324,4078,3881,4668, # 3168 -4669,2703,3615,3504, 445,4670,5393,5394,5395,5396,2771, 61,4079,3738,1823,4080, # 3184 -5397, 687,2046, 935, 925, 405,2670, 703,1096,1860,2734,4671,4081,1877,1367,2704, # 3200 -3389, 918,2106,1782,2483, 334,3320,1611,1093,4672, 564,3171,3505,3739,3390, 945, # 3216 -2641,2058,4673,5398,1926, 872,4319,5399,3506,2705,3112, 349,4320,3740,4082,4674, # 3232 -3882,4321,3741,2156,4083,4675,4676,4322,4677,2408,2047, 782,4084, 400, 251,4323, # 3248 -1624,5400,5401, 277,3742, 299,1265, 476,1191,3883,2122,4324,4325,1109, 205,5402, # 3264 -2590,1000,2157,3616,1861,5403,5404,5405,4678,5406,4679,2573, 107,2484,2158,4085, # 3280 -3507,3172,5407,1533, 541,1301, 158, 753,4326,2886,3617,5408,1696, 370,1088,4327, # 3296 -4680,3618, 579, 327, 440, 162,2244, 269,1938,1374,3508, 968,3063, 56,1396,3113, # 3312 -2107,3321,3391,5409,1927,2159,4681,3016,5410,3619,5411,5412,3743,4682,2485,5413, # 3328 -2804,5414,1650,4683,5415,2613,5416,5417,4086,2671,3392,1149,3393,4087,3884,4088, # 3344 -5418,1076, 49,5419, 951,3242,3322,3323, 450,2850, 920,5420,1812,2805,2371,4328, # 3360 -1909,1138,2372,3885,3509,5421,3243,4684,1910,1147,1518,2428,4685,3886,5422,4686, # 3376 -2393,2614, 260,1796,3244,5423,5424,3887,3324, 708,5425,3620,1704,5426,3621,1351, # 3392 -1618,3394,3017,1887, 944,4329,3395,4330,3064,3396,4331,5427,3744, 422, 413,1714, # 3408 -3325, 500,2059,2350,4332,2486,5428,1344,1911, 954,5429,1668,5430,5431,4089,2409, # 3424 -4333,3622,3888,4334,5432,2307,1318,2512,3114, 133,3115,2887,4687, 629, 31,2851, # 3440 -2706,3889,4688, 850, 949,4689,4090,2970,1732,2089,4335,1496,1853,5433,4091, 620, # 3456 -3245, 981,1242,3745,3397,1619,3746,1643,3326,2140,2457,1971,1719,3510,2169,5434, # 3472 -3246,5435,5436,3398,1829,5437,1277,4690,1565,2048,5438,1636,3623,3116,5439, 869, # 3488 -2852, 655,3890,3891,3117,4092,3018,3892,1310,3624,4691,5440,5441,5442,1733, 558, # 3504 -4692,3747, 335,1549,3065,1756,4336,3748,1946,3511,1830,1291,1192, 470,2735,2108, # 3520 -2806, 913,1054,4093,5443,1027,5444,3066,4094,4693, 982,2672,3399,3173,3512,3247, # 3536 -3248,1947,2807,5445, 571,4694,5446,1831,5447,3625,2591,1523,2429,5448,2090, 984, # 3552 -4695,3749,1960,5449,3750, 852, 923,2808,3513,3751, 969,1519, 999,2049,2325,1705, # 3568 -5450,3118, 615,1662, 151, 597,4095,2410,2326,1049, 275,4696,3752,4337, 568,3753, # 3584 -3626,2487,4338,3754,5451,2430,2275, 409,3249,5452,1566,2888,3514,1002, 769,2853, # 3600 - 194,2091,3174,3755,2226,3327,4339, 628,1505,5453,5454,1763,2180,3019,4096, 521, # 3616 -1161,2592,1788,2206,2411,4697,4097,1625,4340,4341, 412, 42,3119, 464,5455,2642, # 3632 -4698,3400,1760,1571,2889,3515,2537,1219,2207,3893,2643,2141,2373,4699,4700,3328, # 3648 -1651,3401,3627,5456,5457,3628,2488,3516,5458,3756,5459,5460,2276,2092, 460,5461, # 3664 -4701,5462,3020, 962, 588,3629, 289,3250,2644,1116, 52,5463,3067,1797,5464,5465, # 3680 -5466,1467,5467,1598,1143,3757,4342,1985,1734,1067,4702,1280,3402, 465,4703,1572, # 3696 - 510,5468,1928,2245,1813,1644,3630,5469,4704,3758,5470,5471,2673,1573,1534,5472, # 3712 -5473, 536,1808,1761,3517,3894,3175,2645,5474,5475,5476,4705,3518,2929,1912,2809, # 3728 -5477,3329,1122, 377,3251,5478, 360,5479,5480,4343,1529, 551,5481,2060,3759,1769, # 3744 -2431,5482,2930,4344,3330,3120,2327,2109,2031,4706,1404, 136,1468,1479, 672,1171, # 3760 -3252,2308, 271,3176,5483,2772,5484,2050, 678,2736, 865,1948,4707,5485,2014,4098, # 3776 -2971,5486,2737,2227,1397,3068,3760,4708,4709,1735,2931,3403,3631,5487,3895, 509, # 3792 -2854,2458,2890,3896,5488,5489,3177,3178,4710,4345,2538,4711,2309,1166,1010, 552, # 3808 - 681,1888,5490,5491,2972,2973,4099,1287,1596,1862,3179, 358, 453, 736, 175, 478, # 3824 -1117, 905,1167,1097,5492,1854,1530,5493,1706,5494,2181,3519,2292,3761,3520,3632, # 3840 -4346,2093,4347,5495,3404,1193,2489,4348,1458,2193,2208,1863,1889,1421,3331,2932, # 3856 -3069,2182,3521, 595,2123,5496,4100,5497,5498,4349,1707,2646, 223,3762,1359, 751, # 3872 -3121, 183,3522,5499,2810,3021, 419,2374, 633, 704,3897,2394, 241,5500,5501,5502, # 3888 - 838,3022,3763,2277,2773,2459,3898,1939,2051,4101,1309,3122,2246,1181,5503,1136, # 3904 -2209,3899,2375,1446,4350,2310,4712,5504,5505,4351,1055,2615, 484,3764,5506,4102, # 3920 - 625,4352,2278,3405,1499,4353,4103,5507,4104,4354,3253,2279,2280,3523,5508,5509, # 3936 -2774, 808,2616,3765,3406,4105,4355,3123,2539, 526,3407,3900,4356, 955,5510,1620, # 3952 -4357,2647,2432,5511,1429,3766,1669,1832, 994, 928,5512,3633,1260,5513,5514,5515, # 3968 -1949,2293, 741,2933,1626,4358,2738,2460, 867,1184, 362,3408,1392,5516,5517,4106, # 3984 -4359,1770,1736,3254,2934,4713,4714,1929,2707,1459,1158,5518,3070,3409,2891,1292, # 4000 -1930,2513,2855,3767,1986,1187,2072,2015,2617,4360,5519,2574,2514,2170,3768,2490, # 4016 -3332,5520,3769,4715,5521,5522, 666,1003,3023,1022,3634,4361,5523,4716,1814,2257, # 4032 - 574,3901,1603, 295,1535, 705,3902,4362, 283, 858, 417,5524,5525,3255,4717,4718, # 4048 -3071,1220,1890,1046,2281,2461,4107,1393,1599, 689,2575, 388,4363,5526,2491, 802, # 4064 -5527,2811,3903,2061,1405,2258,5528,4719,3904,2110,1052,1345,3256,1585,5529, 809, # 4080 -5530,5531,5532, 575,2739,3524, 956,1552,1469,1144,2328,5533,2329,1560,2462,3635, # 4096 -3257,4108, 616,2210,4364,3180,2183,2294,5534,1833,5535,3525,4720,5536,1319,3770, # 4112 -3771,1211,3636,1023,3258,1293,2812,5537,5538,5539,3905, 607,2311,3906, 762,2892, # 4128 -1439,4365,1360,4721,1485,3072,5540,4722,1038,4366,1450,2062,2648,4367,1379,4723, # 4144 -2593,5541,5542,4368,1352,1414,2330,2935,1172,5543,5544,3907,3908,4724,1798,1451, # 4160 -5545,5546,5547,5548,2936,4109,4110,2492,2351, 411,4111,4112,3637,3333,3124,4725, # 4176 -1561,2674,1452,4113,1375,5549,5550, 47,2974, 316,5551,1406,1591,2937,3181,5552, # 4192 -1025,2142,3125,3182, 354,2740, 884,2228,4369,2412, 508,3772, 726,3638, 996,2433, # 4208 -3639, 729,5553, 392,2194,1453,4114,4726,3773,5554,5555,2463,3640,2618,1675,2813, # 4224 - 919,2352,2975,2353,1270,4727,4115, 73,5556,5557, 647,5558,3259,2856,2259,1550, # 4240 -1346,3024,5559,1332, 883,3526,5560,5561,5562,5563,3334,2775,5564,1212, 831,1347, # 4256 -4370,4728,2331,3909,1864,3073, 720,3910,4729,4730,3911,5565,4371,5566,5567,4731, # 4272 -5568,5569,1799,4732,3774,2619,4733,3641,1645,2376,4734,5570,2938, 669,2211,2675, # 4288 -2434,5571,2893,5572,5573,1028,3260,5574,4372,2413,5575,2260,1353,5576,5577,4735, # 4304 -3183, 518,5578,4116,5579,4373,1961,5580,2143,4374,5581,5582,3025,2354,2355,3912, # 4320 - 516,1834,1454,4117,2708,4375,4736,2229,2620,1972,1129,3642,5583,2776,5584,2976, # 4336 -1422, 577,1470,3026,1524,3410,5585,5586, 432,4376,3074,3527,5587,2594,1455,2515, # 4352 -2230,1973,1175,5588,1020,2741,4118,3528,4737,5589,2742,5590,1743,1361,3075,3529, # 4368 -2649,4119,4377,4738,2295, 895, 924,4378,2171, 331,2247,3076, 166,1627,3077,1098, # 4384 -5591,1232,2894,2231,3411,4739, 657, 403,1196,2377, 542,3775,3412,1600,4379,3530, # 4400 -5592,4740,2777,3261, 576, 530,1362,4741,4742,2540,2676,3776,4120,5593, 842,3913, # 4416 -5594,2814,2032,1014,4121, 213,2709,3413, 665, 621,4380,5595,3777,2939,2435,5596, # 4432 -2436,3335,3643,3414,4743,4381,2541,4382,4744,3644,1682,4383,3531,1380,5597, 724, # 4448 -2282, 600,1670,5598,1337,1233,4745,3126,2248,5599,1621,4746,5600, 651,4384,5601, # 4464 -1612,4385,2621,5602,2857,5603,2743,2312,3078,5604, 716,2464,3079, 174,1255,2710, # 4480 -4122,3645, 548,1320,1398, 728,4123,1574,5605,1891,1197,3080,4124,5606,3081,3082, # 4496 -3778,3646,3779, 747,5607, 635,4386,4747,5608,5609,5610,4387,5611,5612,4748,5613, # 4512 -3415,4749,2437, 451,5614,3780,2542,2073,4388,2744,4389,4125,5615,1764,4750,5616, # 4528 -4390, 350,4751,2283,2395,2493,5617,4391,4126,2249,1434,4127, 488,4752, 458,4392, # 4544 -4128,3781, 771,1330,2396,3914,2576,3184,2160,2414,1553,2677,3185,4393,5618,2494, # 4560 -2895,2622,1720,2711,4394,3416,4753,5619,2543,4395,5620,3262,4396,2778,5621,2016, # 4576 -2745,5622,1155,1017,3782,3915,5623,3336,2313, 201,1865,4397,1430,5624,4129,5625, # 4592 -5626,5627,5628,5629,4398,1604,5630, 414,1866, 371,2595,4754,4755,3532,2017,3127, # 4608 -4756,1708, 960,4399, 887, 389,2172,1536,1663,1721,5631,2232,4130,2356,2940,1580, # 4624 -5632,5633,1744,4757,2544,4758,4759,5634,4760,5635,2074,5636,4761,3647,3417,2896, # 4640 -4400,5637,4401,2650,3418,2815, 673,2712,2465, 709,3533,4131,3648,4402,5638,1148, # 4656 - 502, 634,5639,5640,1204,4762,3649,1575,4763,2623,3783,5641,3784,3128, 948,3263, # 4672 - 121,1745,3916,1110,5642,4403,3083,2516,3027,4132,3785,1151,1771,3917,1488,4133, # 4688 -1987,5643,2438,3534,5644,5645,2094,5646,4404,3918,1213,1407,2816, 531,2746,2545, # 4704 -3264,1011,1537,4764,2779,4405,3129,1061,5647,3786,3787,1867,2897,5648,2018, 120, # 4720 -4406,4407,2063,3650,3265,2314,3919,2678,3419,1955,4765,4134,5649,3535,1047,2713, # 4736 -1266,5650,1368,4766,2858, 649,3420,3920,2546,2747,1102,2859,2679,5651,5652,2000, # 4752 -5653,1111,3651,2977,5654,2495,3921,3652,2817,1855,3421,3788,5655,5656,3422,2415, # 4768 -2898,3337,3266,3653,5657,2577,5658,3654,2818,4135,1460, 856,5659,3655,5660,2899, # 4784 -2978,5661,2900,3922,5662,4408, 632,2517, 875,3923,1697,3924,2296,5663,5664,4767, # 4800 -3028,1239, 580,4768,4409,5665, 914, 936,2075,1190,4136,1039,2124,5666,5667,5668, # 4816 -5669,3423,1473,5670,1354,4410,3925,4769,2173,3084,4137, 915,3338,4411,4412,3339, # 4832 -1605,1835,5671,2748, 398,3656,4413,3926,4138, 328,1913,2860,4139,3927,1331,4414, # 4848 -3029, 937,4415,5672,3657,4140,4141,3424,2161,4770,3425, 524, 742, 538,3085,1012, # 4864 -5673,5674,3928,2466,5675, 658,1103, 225,3929,5676,5677,4771,5678,4772,5679,3267, # 4880 -1243,5680,4142, 963,2250,4773,5681,2714,3658,3186,5682,5683,2596,2332,5684,4774, # 4896 -5685,5686,5687,3536, 957,3426,2547,2033,1931,2941,2467, 870,2019,3659,1746,2780, # 4912 -2781,2439,2468,5688,3930,5689,3789,3130,3790,3537,3427,3791,5690,1179,3086,5691, # 4928 -3187,2378,4416,3792,2548,3188,3131,2749,4143,5692,3428,1556,2549,2297, 977,2901, # 4944 -2034,4144,1205,3429,5693,1765,3430,3189,2125,1271, 714,1689,4775,3538,5694,2333, # 4960 -3931, 533,4417,3660,2184, 617,5695,2469,3340,3539,2315,5696,5697,3190,5698,5699, # 4976 -3932,1988, 618, 427,2651,3540,3431,5700,5701,1244,1690,5702,2819,4418,4776,5703, # 4992 -3541,4777,5704,2284,1576, 473,3661,4419,3432, 972,5705,3662,5706,3087,5707,5708, # 5008 -4778,4779,5709,3793,4145,4146,5710, 153,4780, 356,5711,1892,2902,4420,2144, 408, # 5024 - 803,2357,5712,3933,5713,4421,1646,2578,2518,4781,4782,3934,5714,3935,4422,5715, # 5040 -2416,3433, 752,5716,5717,1962,3341,2979,5718, 746,3030,2470,4783,4423,3794, 698, # 5056 -4784,1893,4424,3663,2550,4785,3664,3936,5719,3191,3434,5720,1824,1302,4147,2715, # 5072 -3937,1974,4425,5721,4426,3192, 823,1303,1288,1236,2861,3542,4148,3435, 774,3938, # 5088 -5722,1581,4786,1304,2862,3939,4787,5723,2440,2162,1083,3268,4427,4149,4428, 344, # 5104 -1173, 288,2316, 454,1683,5724,5725,1461,4788,4150,2597,5726,5727,4789, 985, 894, # 5120 -5728,3436,3193,5729,1914,2942,3795,1989,5730,2111,1975,5731,4151,5732,2579,1194, # 5136 - 425,5733,4790,3194,1245,3796,4429,5734,5735,2863,5736, 636,4791,1856,3940, 760, # 5152 -1800,5737,4430,2212,1508,4792,4152,1894,1684,2298,5738,5739,4793,4431,4432,2213, # 5168 - 479,5740,5741, 832,5742,4153,2496,5743,2980,2497,3797, 990,3132, 627,1815,2652, # 5184 -4433,1582,4434,2126,2112,3543,4794,5744, 799,4435,3195,5745,4795,2113,1737,3031, # 5200 -1018, 543, 754,4436,3342,1676,4796,4797,4154,4798,1489,5746,3544,5747,2624,2903, # 5216 -4155,5748,5749,2981,5750,5751,5752,5753,3196,4799,4800,2185,1722,5754,3269,3270, # 5232 -1843,3665,1715, 481, 365,1976,1857,5755,5756,1963,2498,4801,5757,2127,3666,3271, # 5248 - 433,1895,2064,2076,5758, 602,2750,5759,5760,5761,5762,5763,3032,1628,3437,5764, # 5264 -3197,4802,4156,2904,4803,2519,5765,2551,2782,5766,5767,5768,3343,4804,2905,5769, # 5280 -4805,5770,2864,4806,4807,1221,2982,4157,2520,5771,5772,5773,1868,1990,5774,5775, # 5296 -5776,1896,5777,5778,4808,1897,4158, 318,5779,2095,4159,4437,5780,5781, 485,5782, # 5312 - 938,3941, 553,2680, 116,5783,3942,3667,5784,3545,2681,2783,3438,3344,2820,5785, # 5328 -3668,2943,4160,1747,2944,2983,5786,5787, 207,5788,4809,5789,4810,2521,5790,3033, # 5344 - 890,3669,3943,5791,1878,3798,3439,5792,2186,2358,3440,1652,5793,5794,5795, 941, # 5360 -2299, 208,3546,4161,2020, 330,4438,3944,2906,2499,3799,4439,4811,5796,5797,5798, # 5376 #last 512 -#Everything below is of no interest for detection purpose -2522,1613,4812,5799,3345,3945,2523,5800,4162,5801,1637,4163,2471,4813,3946,5802, # 5392 -2500,3034,3800,5803,5804,2195,4814,5805,2163,5806,5807,5808,5809,5810,5811,5812, # 5408 -5813,5814,5815,5816,5817,5818,5819,5820,5821,5822,5823,5824,5825,5826,5827,5828, # 5424 -5829,5830,5831,5832,5833,5834,5835,5836,5837,5838,5839,5840,5841,5842,5843,5844, # 5440 -5845,5846,5847,5848,5849,5850,5851,5852,5853,5854,5855,5856,5857,5858,5859,5860, # 5456 -5861,5862,5863,5864,5865,5866,5867,5868,5869,5870,5871,5872,5873,5874,5875,5876, # 5472 -5877,5878,5879,5880,5881,5882,5883,5884,5885,5886,5887,5888,5889,5890,5891,5892, # 5488 -5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904,5905,5906,5907,5908, # 5504 -5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920,5921,5922,5923,5924, # 5520 -5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,5936,5937,5938,5939,5940, # 5536 -5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951,5952,5953,5954,5955,5956, # 5552 -5957,5958,5959,5960,5961,5962,5963,5964,5965,5966,5967,5968,5969,5970,5971,5972, # 5568 -5973,5974,5975,5976,5977,5978,5979,5980,5981,5982,5983,5984,5985,5986,5987,5988, # 5584 -5989,5990,5991,5992,5993,5994,5995,5996,5997,5998,5999,6000,6001,6002,6003,6004, # 5600 -6005,6006,6007,6008,6009,6010,6011,6012,6013,6014,6015,6016,6017,6018,6019,6020, # 5616 -6021,6022,6023,6024,6025,6026,6027,6028,6029,6030,6031,6032,6033,6034,6035,6036, # 5632 -6037,6038,6039,6040,6041,6042,6043,6044,6045,6046,6047,6048,6049,6050,6051,6052, # 5648 -6053,6054,6055,6056,6057,6058,6059,6060,6061,6062,6063,6064,6065,6066,6067,6068, # 5664 -6069,6070,6071,6072,6073,6074,6075,6076,6077,6078,6079,6080,6081,6082,6083,6084, # 5680 -6085,6086,6087,6088,6089,6090,6091,6092,6093,6094,6095,6096,6097,6098,6099,6100, # 5696 -6101,6102,6103,6104,6105,6106,6107,6108,6109,6110,6111,6112,6113,6114,6115,6116, # 5712 -6117,6118,6119,6120,6121,6122,6123,6124,6125,6126,6127,6128,6129,6130,6131,6132, # 5728 -6133,6134,6135,6136,6137,6138,6139,6140,6141,6142,6143,6144,6145,6146,6147,6148, # 5744 -6149,6150,6151,6152,6153,6154,6155,6156,6157,6158,6159,6160,6161,6162,6163,6164, # 5760 -6165,6166,6167,6168,6169,6170,6171,6172,6173,6174,6175,6176,6177,6178,6179,6180, # 5776 -6181,6182,6183,6184,6185,6186,6187,6188,6189,6190,6191,6192,6193,6194,6195,6196, # 5792 -6197,6198,6199,6200,6201,6202,6203,6204,6205,6206,6207,6208,6209,6210,6211,6212, # 5808 -6213,6214,6215,6216,6217,6218,6219,6220,6221,6222,6223,3670,6224,6225,6226,6227, # 5824 -6228,6229,6230,6231,6232,6233,6234,6235,6236,6237,6238,6239,6240,6241,6242,6243, # 5840 -6244,6245,6246,6247,6248,6249,6250,6251,6252,6253,6254,6255,6256,6257,6258,6259, # 5856 -6260,6261,6262,6263,6264,6265,6266,6267,6268,6269,6270,6271,6272,6273,6274,6275, # 5872 -6276,6277,6278,6279,6280,6281,6282,6283,6284,6285,4815,6286,6287,6288,6289,6290, # 5888 -6291,6292,4816,6293,6294,6295,6296,6297,6298,6299,6300,6301,6302,6303,6304,6305, # 5904 -6306,6307,6308,6309,6310,6311,4817,4818,6312,6313,6314,6315,6316,6317,6318,4819, # 5920 -6319,6320,6321,6322,6323,6324,6325,6326,6327,6328,6329,6330,6331,6332,6333,6334, # 5936 -6335,6336,6337,4820,6338,6339,6340,6341,6342,6343,6344,6345,6346,6347,6348,6349, # 5952 -6350,6351,6352,6353,6354,6355,6356,6357,6358,6359,6360,6361,6362,6363,6364,6365, # 5968 -6366,6367,6368,6369,6370,6371,6372,6373,6374,6375,6376,6377,6378,6379,6380,6381, # 5984 -6382,6383,6384,6385,6386,6387,6388,6389,6390,6391,6392,6393,6394,6395,6396,6397, # 6000 -6398,6399,6400,6401,6402,6403,6404,6405,6406,6407,6408,6409,6410,3441,6411,6412, # 6016 -6413,6414,6415,6416,6417,6418,6419,6420,6421,6422,6423,6424,6425,4440,6426,6427, # 6032 -6428,6429,6430,6431,6432,6433,6434,6435,6436,6437,6438,6439,6440,6441,6442,6443, # 6048 -6444,6445,6446,6447,6448,6449,6450,6451,6452,6453,6454,4821,6455,6456,6457,6458, # 6064 -6459,6460,6461,6462,6463,6464,6465,6466,6467,6468,6469,6470,6471,6472,6473,6474, # 6080 -6475,6476,6477,3947,3948,6478,6479,6480,6481,3272,4441,6482,6483,6484,6485,4442, # 6096 -6486,6487,6488,6489,6490,6491,6492,6493,6494,6495,6496,4822,6497,6498,6499,6500, # 6112 -6501,6502,6503,6504,6505,6506,6507,6508,6509,6510,6511,6512,6513,6514,6515,6516, # 6128 -6517,6518,6519,6520,6521,6522,6523,6524,6525,6526,6527,6528,6529,6530,6531,6532, # 6144 -6533,6534,6535,6536,6537,6538,6539,6540,6541,6542,6543,6544,6545,6546,6547,6548, # 6160 -6549,6550,6551,6552,6553,6554,6555,6556,2784,6557,4823,6558,6559,6560,6561,6562, # 6176 -6563,6564,6565,6566,6567,6568,6569,3949,6570,6571,6572,4824,6573,6574,6575,6576, # 6192 -6577,6578,6579,6580,6581,6582,6583,4825,6584,6585,6586,3950,2785,6587,6588,6589, # 6208 -6590,6591,6592,6593,6594,6595,6596,6597,6598,6599,6600,6601,6602,6603,6604,6605, # 6224 -6606,6607,6608,6609,6610,6611,6612,4826,6613,6614,6615,4827,6616,6617,6618,6619, # 6240 -6620,6621,6622,6623,6624,6625,4164,6626,6627,6628,6629,6630,6631,6632,6633,6634, # 6256 -3547,6635,4828,6636,6637,6638,6639,6640,6641,6642,3951,2984,6643,6644,6645,6646, # 6272 -6647,6648,6649,4165,6650,4829,6651,6652,4830,6653,6654,6655,6656,6657,6658,6659, # 6288 -6660,6661,6662,4831,6663,6664,6665,6666,6667,6668,6669,6670,6671,4166,6672,4832, # 6304 -3952,6673,6674,6675,6676,4833,6677,6678,6679,4167,6680,6681,6682,3198,6683,6684, # 6320 -6685,6686,6687,6688,6689,6690,6691,6692,6693,6694,6695,6696,6697,4834,6698,6699, # 6336 -6700,6701,6702,6703,6704,6705,6706,6707,6708,6709,6710,6711,6712,6713,6714,6715, # 6352 -6716,6717,6718,6719,6720,6721,6722,6723,6724,6725,6726,6727,6728,6729,6730,6731, # 6368 -6732,6733,6734,4443,6735,6736,6737,6738,6739,6740,6741,6742,6743,6744,6745,4444, # 6384 -6746,6747,6748,6749,6750,6751,6752,6753,6754,6755,6756,6757,6758,6759,6760,6761, # 6400 -6762,6763,6764,6765,6766,6767,6768,6769,6770,6771,6772,6773,6774,6775,6776,6777, # 6416 -6778,6779,6780,6781,4168,6782,6783,3442,6784,6785,6786,6787,6788,6789,6790,6791, # 6432 -4169,6792,6793,6794,6795,6796,6797,6798,6799,6800,6801,6802,6803,6804,6805,6806, # 6448 -6807,6808,6809,6810,6811,4835,6812,6813,6814,4445,6815,6816,4446,6817,6818,6819, # 6464 -6820,6821,6822,6823,6824,6825,6826,6827,6828,6829,6830,6831,6832,6833,6834,6835, # 6480 -3548,6836,6837,6838,6839,6840,6841,6842,6843,6844,6845,6846,4836,6847,6848,6849, # 6496 -6850,6851,6852,6853,6854,3953,6855,6856,6857,6858,6859,6860,6861,6862,6863,6864, # 6512 -6865,6866,6867,6868,6869,6870,6871,6872,6873,6874,6875,6876,6877,3199,6878,6879, # 6528 -6880,6881,6882,4447,6883,6884,6885,6886,6887,6888,6889,6890,6891,6892,6893,6894, # 6544 -6895,6896,6897,6898,6899,6900,6901,6902,6903,6904,4170,6905,6906,6907,6908,6909, # 6560 -6910,6911,6912,6913,6914,6915,6916,6917,6918,6919,6920,6921,6922,6923,6924,6925, # 6576 -6926,6927,4837,6928,6929,6930,6931,6932,6933,6934,6935,6936,3346,6937,6938,4838, # 6592 -6939,6940,6941,4448,6942,6943,6944,6945,6946,4449,6947,6948,6949,6950,6951,6952, # 6608 -6953,6954,6955,6956,6957,6958,6959,6960,6961,6962,6963,6964,6965,6966,6967,6968, # 6624 -6969,6970,6971,6972,6973,6974,6975,6976,6977,6978,6979,6980,6981,6982,6983,6984, # 6640 -6985,6986,6987,6988,6989,6990,6991,6992,6993,6994,3671,6995,6996,6997,6998,4839, # 6656 -6999,7000,7001,7002,3549,7003,7004,7005,7006,7007,7008,7009,7010,7011,7012,7013, # 6672 -7014,7015,7016,7017,7018,7019,7020,7021,7022,7023,7024,7025,7026,7027,7028,7029, # 6688 -7030,4840,7031,7032,7033,7034,7035,7036,7037,7038,4841,7039,7040,7041,7042,7043, # 6704 -7044,7045,7046,7047,7048,7049,7050,7051,7052,7053,7054,7055,7056,7057,7058,7059, # 6720 -7060,7061,7062,7063,7064,7065,7066,7067,7068,7069,7070,2985,7071,7072,7073,7074, # 6736 -7075,7076,7077,7078,7079,7080,4842,7081,7082,7083,7084,7085,7086,7087,7088,7089, # 6752 -7090,7091,7092,7093,7094,7095,7096,7097,7098,7099,7100,7101,7102,7103,7104,7105, # 6768 -7106,7107,7108,7109,7110,7111,7112,7113,7114,7115,7116,7117,7118,4450,7119,7120, # 6784 -7121,7122,7123,7124,7125,7126,7127,7128,7129,7130,7131,7132,7133,7134,7135,7136, # 6800 -7137,7138,7139,7140,7141,7142,7143,4843,7144,7145,7146,7147,7148,7149,7150,7151, # 6816 -7152,7153,7154,7155,7156,7157,7158,7159,7160,7161,7162,7163,7164,7165,7166,7167, # 6832 -7168,7169,7170,7171,7172,7173,7174,7175,7176,7177,7178,7179,7180,7181,7182,7183, # 6848 -7184,7185,7186,7187,7188,4171,4172,7189,7190,7191,7192,7193,7194,7195,7196,7197, # 6864 -7198,7199,7200,7201,7202,7203,7204,7205,7206,7207,7208,7209,7210,7211,7212,7213, # 6880 -7214,7215,7216,7217,7218,7219,7220,7221,7222,7223,7224,7225,7226,7227,7228,7229, # 6896 -7230,7231,7232,7233,7234,7235,7236,7237,7238,7239,7240,7241,7242,7243,7244,7245, # 6912 -7246,7247,7248,7249,7250,7251,7252,7253,7254,7255,7256,7257,7258,7259,7260,7261, # 6928 -7262,7263,7264,7265,7266,7267,7268,7269,7270,7271,7272,7273,7274,7275,7276,7277, # 6944 -7278,7279,7280,7281,7282,7283,7284,7285,7286,7287,7288,7289,7290,7291,7292,7293, # 6960 -7294,7295,7296,4844,7297,7298,7299,7300,7301,7302,7303,7304,7305,7306,7307,7308, # 6976 -7309,7310,7311,7312,7313,7314,7315,7316,4451,7317,7318,7319,7320,7321,7322,7323, # 6992 -7324,7325,7326,7327,7328,7329,7330,7331,7332,7333,7334,7335,7336,7337,7338,7339, # 7008 -7340,7341,7342,7343,7344,7345,7346,7347,7348,7349,7350,7351,7352,7353,4173,7354, # 7024 -7355,4845,7356,7357,7358,7359,7360,7361,7362,7363,7364,7365,7366,7367,7368,7369, # 7040 -7370,7371,7372,7373,7374,7375,7376,7377,7378,7379,7380,7381,7382,7383,7384,7385, # 7056 -7386,7387,7388,4846,7389,7390,7391,7392,7393,7394,7395,7396,7397,7398,7399,7400, # 7072 -7401,7402,7403,7404,7405,3672,7406,7407,7408,7409,7410,7411,7412,7413,7414,7415, # 7088 -7416,7417,7418,7419,7420,7421,7422,7423,7424,7425,7426,7427,7428,7429,7430,7431, # 7104 -7432,7433,7434,7435,7436,7437,7438,7439,7440,7441,7442,7443,7444,7445,7446,7447, # 7120 -7448,7449,7450,7451,7452,7453,4452,7454,3200,7455,7456,7457,7458,7459,7460,7461, # 7136 -7462,7463,7464,7465,7466,7467,7468,7469,7470,7471,7472,7473,7474,4847,7475,7476, # 7152 -7477,3133,7478,7479,7480,7481,7482,7483,7484,7485,7486,7487,7488,7489,7490,7491, # 7168 -7492,7493,7494,7495,7496,7497,7498,7499,7500,7501,7502,3347,7503,7504,7505,7506, # 7184 -7507,7508,7509,7510,7511,7512,7513,7514,7515,7516,7517,7518,7519,7520,7521,4848, # 7200 -7522,7523,7524,7525,7526,7527,7528,7529,7530,7531,7532,7533,7534,7535,7536,7537, # 7216 -7538,7539,7540,7541,7542,7543,7544,7545,7546,7547,7548,7549,3801,4849,7550,7551, # 7232 -7552,7553,7554,7555,7556,7557,7558,7559,7560,7561,7562,7563,7564,7565,7566,7567, # 7248 -7568,7569,3035,7570,7571,7572,7573,7574,7575,7576,7577,7578,7579,7580,7581,7582, # 7264 -7583,7584,7585,7586,7587,7588,7589,7590,7591,7592,7593,7594,7595,7596,7597,7598, # 7280 -7599,7600,7601,7602,7603,7604,7605,7606,7607,7608,7609,7610,7611,7612,7613,7614, # 7296 -7615,7616,4850,7617,7618,3802,7619,7620,7621,7622,7623,7624,7625,7626,7627,7628, # 7312 -7629,7630,7631,7632,4851,7633,7634,7635,7636,7637,7638,7639,7640,7641,7642,7643, # 7328 -7644,7645,7646,7647,7648,7649,7650,7651,7652,7653,7654,7655,7656,7657,7658,7659, # 7344 -7660,7661,7662,7663,7664,7665,7666,7667,7668,7669,7670,4453,7671,7672,7673,7674, # 7360 -7675,7676,7677,7678,7679,7680,7681,7682,7683,7684,7685,7686,7687,7688,7689,7690, # 7376 -7691,7692,7693,7694,7695,7696,7697,3443,7698,7699,7700,7701,7702,4454,7703,7704, # 7392 -7705,7706,7707,7708,7709,7710,7711,7712,7713,2472,7714,7715,7716,7717,7718,7719, # 7408 -7720,7721,7722,7723,7724,7725,7726,7727,7728,7729,7730,7731,3954,7732,7733,7734, # 7424 -7735,7736,7737,7738,7739,7740,7741,7742,7743,7744,7745,7746,7747,7748,7749,7750, # 7440 -3134,7751,7752,4852,7753,7754,7755,4853,7756,7757,7758,7759,7760,4174,7761,7762, # 7456 -7763,7764,7765,7766,7767,7768,7769,7770,7771,7772,7773,7774,7775,7776,7777,7778, # 7472 -7779,7780,7781,7782,7783,7784,7785,7786,7787,7788,7789,7790,7791,7792,7793,7794, # 7488 -7795,7796,7797,7798,7799,7800,7801,7802,7803,7804,7805,4854,7806,7807,7808,7809, # 7504 -7810,7811,7812,7813,7814,7815,7816,7817,7818,7819,7820,7821,7822,7823,7824,7825, # 7520 -4855,7826,7827,7828,7829,7830,7831,7832,7833,7834,7835,7836,7837,7838,7839,7840, # 7536 -7841,7842,7843,7844,7845,7846,7847,3955,7848,7849,7850,7851,7852,7853,7854,7855, # 7552 -7856,7857,7858,7859,7860,3444,7861,7862,7863,7864,7865,7866,7867,7868,7869,7870, # 7568 -7871,7872,7873,7874,7875,7876,7877,7878,7879,7880,7881,7882,7883,7884,7885,7886, # 7584 -7887,7888,7889,7890,7891,4175,7892,7893,7894,7895,7896,4856,4857,7897,7898,7899, # 7600 -7900,2598,7901,7902,7903,7904,7905,7906,7907,7908,4455,7909,7910,7911,7912,7913, # 7616 -7914,3201,7915,7916,7917,7918,7919,7920,7921,4858,7922,7923,7924,7925,7926,7927, # 7632 -7928,7929,7930,7931,7932,7933,7934,7935,7936,7937,7938,7939,7940,7941,7942,7943, # 7648 -7944,7945,7946,7947,7948,7949,7950,7951,7952,7953,7954,7955,7956,7957,7958,7959, # 7664 -7960,7961,7962,7963,7964,7965,7966,7967,7968,7969,7970,7971,7972,7973,7974,7975, # 7680 -7976,7977,7978,7979,7980,7981,4859,7982,7983,7984,7985,7986,7987,7988,7989,7990, # 7696 -7991,7992,7993,7994,7995,7996,4860,7997,7998,7999,8000,8001,8002,8003,8004,8005, # 7712 -8006,8007,8008,8009,8010,8011,8012,8013,8014,8015,8016,4176,8017,8018,8019,8020, # 7728 -8021,8022,8023,4861,8024,8025,8026,8027,8028,8029,8030,8031,8032,8033,8034,8035, # 7744 -8036,4862,4456,8037,8038,8039,8040,4863,8041,8042,8043,8044,8045,8046,8047,8048, # 7760 -8049,8050,8051,8052,8053,8054,8055,8056,8057,8058,8059,8060,8061,8062,8063,8064, # 7776 -8065,8066,8067,8068,8069,8070,8071,8072,8073,8074,8075,8076,8077,8078,8079,8080, # 7792 -8081,8082,8083,8084,8085,8086,8087,8088,8089,8090,8091,8092,8093,8094,8095,8096, # 7808 -8097,8098,8099,4864,4177,8100,8101,8102,8103,8104,8105,8106,8107,8108,8109,8110, # 7824 -8111,8112,8113,8114,8115,8116,8117,8118,8119,8120,4178,8121,8122,8123,8124,8125, # 7840 -8126,8127,8128,8129,8130,8131,8132,8133,8134,8135,8136,8137,8138,8139,8140,8141, # 7856 -8142,8143,8144,8145,4865,4866,8146,8147,8148,8149,8150,8151,8152,8153,8154,8155, # 7872 -8156,8157,8158,8159,8160,8161,8162,8163,8164,8165,4179,8166,8167,8168,8169,8170, # 7888 -8171,8172,8173,8174,8175,8176,8177,8178,8179,8180,8181,4457,8182,8183,8184,8185, # 7904 -8186,8187,8188,8189,8190,8191,8192,8193,8194,8195,8196,8197,8198,8199,8200,8201, # 7920 -8202,8203,8204,8205,8206,8207,8208,8209,8210,8211,8212,8213,8214,8215,8216,8217, # 7936 -8218,8219,8220,8221,8222,8223,8224,8225,8226,8227,8228,8229,8230,8231,8232,8233, # 7952 -8234,8235,8236,8237,8238,8239,8240,8241,8242,8243,8244,8245,8246,8247,8248,8249, # 7968 -8250,8251,8252,8253,8254,8255,8256,3445,8257,8258,8259,8260,8261,8262,4458,8263, # 7984 -8264,8265,8266,8267,8268,8269,8270,8271,8272,4459,8273,8274,8275,8276,3550,8277, # 8000 -8278,8279,8280,8281,8282,8283,8284,8285,8286,8287,8288,8289,4460,8290,8291,8292, # 8016 -8293,8294,8295,8296,8297,8298,8299,8300,8301,8302,8303,8304,8305,8306,8307,4867, # 8032 -8308,8309,8310,8311,8312,3551,8313,8314,8315,8316,8317,8318,8319,8320,8321,8322, # 8048 -8323,8324,8325,8326,4868,8327,8328,8329,8330,8331,8332,8333,8334,8335,8336,8337, # 8064 -8338,8339,8340,8341,8342,8343,8344,8345,8346,8347,8348,8349,8350,8351,8352,8353, # 8080 -8354,8355,8356,8357,8358,8359,8360,8361,8362,8363,4869,4461,8364,8365,8366,8367, # 8096 -8368,8369,8370,4870,8371,8372,8373,8374,8375,8376,8377,8378,8379,8380,8381,8382, # 8112 -8383,8384,8385,8386,8387,8388,8389,8390,8391,8392,8393,8394,8395,8396,8397,8398, # 8128 -8399,8400,8401,8402,8403,8404,8405,8406,8407,8408,8409,8410,4871,8411,8412,8413, # 8144 -8414,8415,8416,8417,8418,8419,8420,8421,8422,4462,8423,8424,8425,8426,8427,8428, # 8160 -8429,8430,8431,8432,8433,2986,8434,8435,8436,8437,8438,8439,8440,8441,8442,8443, # 8176 -8444,8445,8446,8447,8448,8449,8450,8451,8452,8453,8454,8455,8456,8457,8458,8459, # 8192 -8460,8461,8462,8463,8464,8465,8466,8467,8468,8469,8470,8471,8472,8473,8474,8475, # 8208 -8476,8477,8478,4180,8479,8480,8481,8482,8483,8484,8485,8486,8487,8488,8489,8490, # 8224 -8491,8492,8493,8494,8495,8496,8497,8498,8499,8500,8501,8502,8503,8504,8505,8506, # 8240 -8507,8508,8509,8510,8511,8512,8513,8514,8515,8516,8517,8518,8519,8520,8521,8522, # 8256 -8523,8524,8525,8526,8527,8528,8529,8530,8531,8532,8533,8534,8535,8536,8537,8538, # 8272 -8539,8540,8541,8542,8543,8544,8545,8546,8547,8548,8549,8550,8551,8552,8553,8554, # 8288 -8555,8556,8557,8558,8559,8560,8561,8562,8563,8564,4872,8565,8566,8567,8568,8569, # 8304 -8570,8571,8572,8573,4873,8574,8575,8576,8577,8578,8579,8580,8581,8582,8583,8584, # 8320 -8585,8586,8587,8588,8589,8590,8591,8592,8593,8594,8595,8596,8597,8598,8599,8600, # 8336 -8601,8602,8603,8604,8605,3803,8606,8607,8608,8609,8610,8611,8612,8613,4874,3804, # 8352 -8614,8615,8616,8617,8618,8619,8620,8621,3956,8622,8623,8624,8625,8626,8627,8628, # 8368 -8629,8630,8631,8632,8633,8634,8635,8636,8637,8638,2865,8639,8640,8641,8642,8643, # 8384 -8644,8645,8646,8647,8648,8649,8650,8651,8652,8653,8654,8655,8656,4463,8657,8658, # 8400 -8659,4875,4876,8660,8661,8662,8663,8664,8665,8666,8667,8668,8669,8670,8671,8672, # 8416 -8673,8674,8675,8676,8677,8678,8679,8680,8681,4464,8682,8683,8684,8685,8686,8687, # 8432 -8688,8689,8690,8691,8692,8693,8694,8695,8696,8697,8698,8699,8700,8701,8702,8703, # 8448 -8704,8705,8706,8707,8708,8709,2261,8710,8711,8712,8713,8714,8715,8716,8717,8718, # 8464 -8719,8720,8721,8722,8723,8724,8725,8726,8727,8728,8729,8730,8731,8732,8733,4181, # 8480 -8734,8735,8736,8737,8738,8739,8740,8741,8742,8743,8744,8745,8746,8747,8748,8749, # 8496 -8750,8751,8752,8753,8754,8755,8756,8757,8758,8759,8760,8761,8762,8763,4877,8764, # 8512 -8765,8766,8767,8768,8769,8770,8771,8772,8773,8774,8775,8776,8777,8778,8779,8780, # 8528 -8781,8782,8783,8784,8785,8786,8787,8788,4878,8789,4879,8790,8791,8792,4880,8793, # 8544 -8794,8795,8796,8797,8798,8799,8800,8801,4881,8802,8803,8804,8805,8806,8807,8808, # 8560 -8809,8810,8811,8812,8813,8814,8815,3957,8816,8817,8818,8819,8820,8821,8822,8823, # 8576 -8824,8825,8826,8827,8828,8829,8830,8831,8832,8833,8834,8835,8836,8837,8838,8839, # 8592 -8840,8841,8842,8843,8844,8845,8846,8847,4882,8848,8849,8850,8851,8852,8853,8854, # 8608 -8855,8856,8857,8858,8859,8860,8861,8862,8863,8864,8865,8866,8867,8868,8869,8870, # 8624 -8871,8872,8873,8874,8875,8876,8877,8878,8879,8880,8881,8882,8883,8884,3202,8885, # 8640 -8886,8887,8888,8889,8890,8891,8892,8893,8894,8895,8896,8897,8898,8899,8900,8901, # 8656 -8902,8903,8904,8905,8906,8907,8908,8909,8910,8911,8912,8913,8914,8915,8916,8917, # 8672 -8918,8919,8920,8921,8922,8923,8924,4465,8925,8926,8927,8928,8929,8930,8931,8932, # 8688 -4883,8933,8934,8935,8936,8937,8938,8939,8940,8941,8942,8943,2214,8944,8945,8946, # 8704 -8947,8948,8949,8950,8951,8952,8953,8954,8955,8956,8957,8958,8959,8960,8961,8962, # 8720 -8963,8964,8965,4884,8966,8967,8968,8969,8970,8971,8972,8973,8974,8975,8976,8977, # 8736 -8978,8979,8980,8981,8982,8983,8984,8985,8986,8987,8988,8989,8990,8991,8992,4885, # 8752 -8993,8994,8995,8996,8997,8998,8999,9000,9001,9002,9003,9004,9005,9006,9007,9008, # 8768 -9009,9010,9011,9012,9013,9014,9015,9016,9017,9018,9019,9020,9021,4182,9022,9023, # 8784 -9024,9025,9026,9027,9028,9029,9030,9031,9032,9033,9034,9035,9036,9037,9038,9039, # 8800 -9040,9041,9042,9043,9044,9045,9046,9047,9048,9049,9050,9051,9052,9053,9054,9055, # 8816 -9056,9057,9058,9059,9060,9061,9062,9063,4886,9064,9065,9066,9067,9068,9069,4887, # 8832 -9070,9071,9072,9073,9074,9075,9076,9077,9078,9079,9080,9081,9082,9083,9084,9085, # 8848 -9086,9087,9088,9089,9090,9091,9092,9093,9094,9095,9096,9097,9098,9099,9100,9101, # 8864 -9102,9103,9104,9105,9106,9107,9108,9109,9110,9111,9112,9113,9114,9115,9116,9117, # 8880 -9118,9119,9120,9121,9122,9123,9124,9125,9126,9127,9128,9129,9130,9131,9132,9133, # 8896 -9134,9135,9136,9137,9138,9139,9140,9141,3958,9142,9143,9144,9145,9146,9147,9148, # 8912 -9149,9150,9151,4888,9152,9153,9154,9155,9156,9157,9158,9159,9160,9161,9162,9163, # 8928 -9164,9165,9166,9167,9168,9169,9170,9171,9172,9173,9174,9175,4889,9176,9177,9178, # 8944 -9179,9180,9181,9182,9183,9184,9185,9186,9187,9188,9189,9190,9191,9192,9193,9194, # 8960 -9195,9196,9197,9198,9199,9200,9201,9202,9203,4890,9204,9205,9206,9207,9208,9209, # 8976 -9210,9211,9212,9213,9214,9215,9216,9217,9218,9219,9220,9221,9222,4466,9223,9224, # 8992 -9225,9226,9227,9228,9229,9230,9231,9232,9233,9234,9235,9236,9237,9238,9239,9240, # 9008 -9241,9242,9243,9244,9245,4891,9246,9247,9248,9249,9250,9251,9252,9253,9254,9255, # 9024 -9256,9257,4892,9258,9259,9260,9261,4893,4894,9262,9263,9264,9265,9266,9267,9268, # 9040 -9269,9270,9271,9272,9273,4467,9274,9275,9276,9277,9278,9279,9280,9281,9282,9283, # 9056 -9284,9285,3673,9286,9287,9288,9289,9290,9291,9292,9293,9294,9295,9296,9297,9298, # 9072 -9299,9300,9301,9302,9303,9304,9305,9306,9307,9308,9309,9310,9311,9312,9313,9314, # 9088 -9315,9316,9317,9318,9319,9320,9321,9322,4895,9323,9324,9325,9326,9327,9328,9329, # 9104 -9330,9331,9332,9333,9334,9335,9336,9337,9338,9339,9340,9341,9342,9343,9344,9345, # 9120 -9346,9347,4468,9348,9349,9350,9351,9352,9353,9354,9355,9356,9357,9358,9359,9360, # 9136 -9361,9362,9363,9364,9365,9366,9367,9368,9369,9370,9371,9372,9373,4896,9374,4469, # 9152 -9375,9376,9377,9378,9379,4897,9380,9381,9382,9383,9384,9385,9386,9387,9388,9389, # 9168 -9390,9391,9392,9393,9394,9395,9396,9397,9398,9399,9400,9401,9402,9403,9404,9405, # 9184 -9406,4470,9407,2751,9408,9409,3674,3552,9410,9411,9412,9413,9414,9415,9416,9417, # 9200 -9418,9419,9420,9421,4898,9422,9423,9424,9425,9426,9427,9428,9429,3959,9430,9431, # 9216 -9432,9433,9434,9435,9436,4471,9437,9438,9439,9440,9441,9442,9443,9444,9445,9446, # 9232 -9447,9448,9449,9450,3348,9451,9452,9453,9454,9455,9456,9457,9458,9459,9460,9461, # 9248 -9462,9463,9464,9465,9466,9467,9468,9469,9470,9471,9472,4899,9473,9474,9475,9476, # 9264 -9477,4900,9478,9479,9480,9481,9482,9483,9484,9485,9486,9487,9488,3349,9489,9490, # 9280 -9491,9492,9493,9494,9495,9496,9497,9498,9499,9500,9501,9502,9503,9504,9505,9506, # 9296 -9507,9508,9509,9510,9511,9512,9513,9514,9515,9516,9517,9518,9519,9520,4901,9521, # 9312 -9522,9523,9524,9525,9526,4902,9527,9528,9529,9530,9531,9532,9533,9534,9535,9536, # 9328 -9537,9538,9539,9540,9541,9542,9543,9544,9545,9546,9547,9548,9549,9550,9551,9552, # 9344 -9553,9554,9555,9556,9557,9558,9559,9560,9561,9562,9563,9564,9565,9566,9567,9568, # 9360 -9569,9570,9571,9572,9573,9574,9575,9576,9577,9578,9579,9580,9581,9582,9583,9584, # 9376 -3805,9585,9586,9587,9588,9589,9590,9591,9592,9593,9594,9595,9596,9597,9598,9599, # 9392 -9600,9601,9602,4903,9603,9604,9605,9606,9607,4904,9608,9609,9610,9611,9612,9613, # 9408 -9614,4905,9615,9616,9617,9618,9619,9620,9621,9622,9623,9624,9625,9626,9627,9628, # 9424 -9629,9630,9631,9632,4906,9633,9634,9635,9636,9637,9638,9639,9640,9641,9642,9643, # 9440 -4907,9644,9645,9646,9647,9648,9649,9650,9651,9652,9653,9654,9655,9656,9657,9658, # 9456 -9659,9660,9661,9662,9663,9664,9665,9666,9667,9668,9669,9670,9671,9672,4183,9673, # 9472 -9674,9675,9676,9677,4908,9678,9679,9680,9681,4909,9682,9683,9684,9685,9686,9687, # 9488 -9688,9689,9690,4910,9691,9692,9693,3675,9694,9695,9696,2945,9697,9698,9699,9700, # 9504 -9701,9702,9703,9704,9705,4911,9706,9707,9708,9709,9710,9711,9712,9713,9714,9715, # 9520 -9716,9717,9718,9719,9720,9721,9722,9723,9724,9725,9726,9727,9728,9729,9730,9731, # 9536 -9732,9733,9734,9735,4912,9736,9737,9738,9739,9740,4913,9741,9742,9743,9744,9745, # 9552 -9746,9747,9748,9749,9750,9751,9752,9753,9754,9755,9756,9757,9758,4914,9759,9760, # 9568 -9761,9762,9763,9764,9765,9766,9767,9768,9769,9770,9771,9772,9773,9774,9775,9776, # 9584 -9777,9778,9779,9780,9781,9782,4915,9783,9784,9785,9786,9787,9788,9789,9790,9791, # 9600 -9792,9793,4916,9794,9795,9796,9797,9798,9799,9800,9801,9802,9803,9804,9805,9806, # 9616 -9807,9808,9809,9810,9811,9812,9813,9814,9815,9816,9817,9818,9819,9820,9821,9822, # 9632 -9823,9824,9825,9826,9827,9828,9829,9830,9831,9832,9833,9834,9835,9836,9837,9838, # 9648 -9839,9840,9841,9842,9843,9844,9845,9846,9847,9848,9849,9850,9851,9852,9853,9854, # 9664 -9855,9856,9857,9858,9859,9860,9861,9862,9863,9864,9865,9866,9867,9868,4917,9869, # 9680 -9870,9871,9872,9873,9874,9875,9876,9877,9878,9879,9880,9881,9882,9883,9884,9885, # 9696 -9886,9887,9888,9889,9890,9891,9892,4472,9893,9894,9895,9896,9897,3806,9898,9899, # 9712 -9900,9901,9902,9903,9904,9905,9906,9907,9908,9909,9910,9911,9912,9913,9914,4918, # 9728 -9915,9916,9917,4919,9918,9919,9920,9921,4184,9922,9923,9924,9925,9926,9927,9928, # 9744 -9929,9930,9931,9932,9933,9934,9935,9936,9937,9938,9939,9940,9941,9942,9943,9944, # 9760 -9945,9946,4920,9947,9948,9949,9950,9951,9952,9953,9954,9955,4185,9956,9957,9958, # 9776 -9959,9960,9961,9962,9963,9964,9965,4921,9966,9967,9968,4473,9969,9970,9971,9972, # 9792 -9973,9974,9975,9976,9977,4474,9978,9979,9980,9981,9982,9983,9984,9985,9986,9987, # 9808 -9988,9989,9990,9991,9992,9993,9994,9995,9996,9997,9998,9999,10000,10001,10002,10003, # 9824 -10004,10005,10006,10007,10008,10009,10010,10011,10012,10013,10014,10015,10016,10017,10018,10019, # 9840 -10020,10021,4922,10022,4923,10023,10024,10025,10026,10027,10028,10029,10030,10031,10032,10033, # 9856 -10034,10035,10036,10037,10038,10039,10040,10041,10042,10043,10044,10045,10046,10047,10048,4924, # 9872 -10049,10050,10051,10052,10053,10054,10055,10056,10057,10058,10059,10060,10061,10062,10063,10064, # 9888 -10065,10066,10067,10068,10069,10070,10071,10072,10073,10074,10075,10076,10077,10078,10079,10080, # 9904 -10081,10082,10083,10084,10085,10086,10087,4475,10088,10089,10090,10091,10092,10093,10094,10095, # 9920 -10096,10097,4476,10098,10099,10100,10101,10102,10103,10104,10105,10106,10107,10108,10109,10110, # 9936 -10111,2174,10112,10113,10114,10115,10116,10117,10118,10119,10120,10121,10122,10123,10124,10125, # 9952 -10126,10127,10128,10129,10130,10131,10132,10133,10134,10135,10136,10137,10138,10139,10140,3807, # 9968 -4186,4925,10141,10142,10143,10144,10145,10146,10147,4477,4187,10148,10149,10150,10151,10152, # 9984 -10153,4188,10154,10155,10156,10157,10158,10159,10160,10161,4926,10162,10163,10164,10165,10166, #10000 -10167,10168,10169,10170,10171,10172,10173,10174,10175,10176,10177,10178,10179,10180,10181,10182, #10016 -10183,10184,10185,10186,10187,10188,10189,10190,10191,10192,3203,10193,10194,10195,10196,10197, #10032 -10198,10199,10200,4478,10201,10202,10203,10204,4479,10205,10206,10207,10208,10209,10210,10211, #10048 -10212,10213,10214,10215,10216,10217,10218,10219,10220,10221,10222,10223,10224,10225,10226,10227, #10064 -10228,10229,10230,10231,10232,10233,10234,4927,10235,10236,10237,10238,10239,10240,10241,10242, #10080 -10243,10244,10245,10246,10247,10248,10249,10250,10251,10252,10253,10254,10255,10256,10257,10258, #10096 -10259,10260,10261,10262,10263,10264,10265,10266,10267,10268,10269,10270,10271,10272,10273,4480, #10112 -4928,4929,10274,10275,10276,10277,10278,10279,10280,10281,10282,10283,10284,10285,10286,10287, #10128 -10288,10289,10290,10291,10292,10293,10294,10295,10296,10297,10298,10299,10300,10301,10302,10303, #10144 -10304,10305,10306,10307,10308,10309,10310,10311,10312,10313,10314,10315,10316,10317,10318,10319, #10160 -10320,10321,10322,10323,10324,10325,10326,10327,10328,10329,10330,10331,10332,10333,10334,4930, #10176 -10335,10336,10337,10338,10339,10340,10341,10342,4931,10343,10344,10345,10346,10347,10348,10349, #10192 -10350,10351,10352,10353,10354,10355,3088,10356,2786,10357,10358,10359,10360,4189,10361,10362, #10208 -10363,10364,10365,10366,10367,10368,10369,10370,10371,10372,10373,10374,10375,4932,10376,10377, #10224 -10378,10379,10380,10381,10382,10383,10384,10385,10386,10387,10388,10389,10390,10391,10392,4933, #10240 -10393,10394,10395,4934,10396,10397,10398,10399,10400,10401,10402,10403,10404,10405,10406,10407, #10256 -10408,10409,10410,10411,10412,3446,10413,10414,10415,10416,10417,10418,10419,10420,10421,10422, #10272 -10423,4935,10424,10425,10426,10427,10428,10429,10430,4936,10431,10432,10433,10434,10435,10436, #10288 -10437,10438,10439,10440,10441,10442,10443,4937,10444,10445,10446,10447,4481,10448,10449,10450, #10304 -10451,10452,10453,10454,10455,10456,10457,10458,10459,10460,10461,10462,10463,10464,10465,10466, #10320 -10467,10468,10469,10470,10471,10472,10473,10474,10475,10476,10477,10478,10479,10480,10481,10482, #10336 -10483,10484,10485,10486,10487,10488,10489,10490,10491,10492,10493,10494,10495,10496,10497,10498, #10352 -10499,10500,10501,10502,10503,10504,10505,4938,10506,10507,10508,10509,10510,2552,10511,10512, #10368 -10513,10514,10515,10516,3447,10517,10518,10519,10520,10521,10522,10523,10524,10525,10526,10527, #10384 -10528,10529,10530,10531,10532,10533,10534,10535,10536,10537,10538,10539,10540,10541,10542,10543, #10400 -4482,10544,4939,10545,10546,10547,10548,10549,10550,10551,10552,10553,10554,10555,10556,10557, #10416 -10558,10559,10560,10561,10562,10563,10564,10565,10566,10567,3676,4483,10568,10569,10570,10571, #10432 -10572,3448,10573,10574,10575,10576,10577,10578,10579,10580,10581,10582,10583,10584,10585,10586, #10448 -10587,10588,10589,10590,10591,10592,10593,10594,10595,10596,10597,10598,10599,10600,10601,10602, #10464 -10603,10604,10605,10606,10607,10608,10609,10610,10611,10612,10613,10614,10615,10616,10617,10618, #10480 -10619,10620,10621,10622,10623,10624,10625,10626,10627,4484,10628,10629,10630,10631,10632,4940, #10496 -10633,10634,10635,10636,10637,10638,10639,10640,10641,10642,10643,10644,10645,10646,10647,10648, #10512 -10649,10650,10651,10652,10653,10654,10655,10656,4941,10657,10658,10659,2599,10660,10661,10662, #10528 -10663,10664,10665,10666,3089,10667,10668,10669,10670,10671,10672,10673,10674,10675,10676,10677, #10544 -10678,10679,10680,4942,10681,10682,10683,10684,10685,10686,10687,10688,10689,10690,10691,10692, #10560 -10693,10694,10695,10696,10697,4485,10698,10699,10700,10701,10702,10703,10704,4943,10705,3677, #10576 -10706,10707,10708,10709,10710,10711,10712,4944,10713,10714,10715,10716,10717,10718,10719,10720, #10592 -10721,10722,10723,10724,10725,10726,10727,10728,4945,10729,10730,10731,10732,10733,10734,10735, #10608 -10736,10737,10738,10739,10740,10741,10742,10743,10744,10745,10746,10747,10748,10749,10750,10751, #10624 -10752,10753,10754,10755,10756,10757,10758,10759,10760,10761,4946,10762,10763,10764,10765,10766, #10640 -10767,4947,4948,10768,10769,10770,10771,10772,10773,10774,10775,10776,10777,10778,10779,10780, #10656 -10781,10782,10783,10784,10785,10786,10787,10788,10789,10790,10791,10792,10793,10794,10795,10796, #10672 -10797,10798,10799,10800,10801,10802,10803,10804,10805,10806,10807,10808,10809,10810,10811,10812, #10688 -10813,10814,10815,10816,10817,10818,10819,10820,10821,10822,10823,10824,10825,10826,10827,10828, #10704 -10829,10830,10831,10832,10833,10834,10835,10836,10837,10838,10839,10840,10841,10842,10843,10844, #10720 -10845,10846,10847,10848,10849,10850,10851,10852,10853,10854,10855,10856,10857,10858,10859,10860, #10736 -10861,10862,10863,10864,10865,10866,10867,10868,10869,10870,10871,10872,10873,10874,10875,10876, #10752 -10877,10878,4486,10879,10880,10881,10882,10883,10884,10885,4949,10886,10887,10888,10889,10890, #10768 -10891,10892,10893,10894,10895,10896,10897,10898,10899,10900,10901,10902,10903,10904,10905,10906, #10784 -10907,10908,10909,10910,10911,10912,10913,10914,10915,10916,10917,10918,10919,4487,10920,10921, #10800 -10922,10923,10924,10925,10926,10927,10928,10929,10930,10931,10932,4950,10933,10934,10935,10936, #10816 -10937,10938,10939,10940,10941,10942,10943,10944,10945,10946,10947,10948,10949,4488,10950,10951, #10832 -10952,10953,10954,10955,10956,10957,10958,10959,4190,10960,10961,10962,10963,10964,10965,10966, #10848 -10967,10968,10969,10970,10971,10972,10973,10974,10975,10976,10977,10978,10979,10980,10981,10982, #10864 -10983,10984,10985,10986,10987,10988,10989,10990,10991,10992,10993,10994,10995,10996,10997,10998, #10880 -10999,11000,11001,11002,11003,11004,11005,11006,3960,11007,11008,11009,11010,11011,11012,11013, #10896 -11014,11015,11016,11017,11018,11019,11020,11021,11022,11023,11024,11025,11026,11027,11028,11029, #10912 -11030,11031,11032,4951,11033,11034,11035,11036,11037,11038,11039,11040,11041,11042,11043,11044, #10928 -11045,11046,11047,4489,11048,11049,11050,11051,4952,11052,11053,11054,11055,11056,11057,11058, #10944 -4953,11059,11060,11061,11062,11063,11064,11065,11066,11067,11068,11069,11070,11071,4954,11072, #10960 -11073,11074,11075,11076,11077,11078,11079,11080,11081,11082,11083,11084,11085,11086,11087,11088, #10976 -11089,11090,11091,11092,11093,11094,11095,11096,11097,11098,11099,11100,11101,11102,11103,11104, #10992 -11105,11106,11107,11108,11109,11110,11111,11112,11113,11114,11115,3808,11116,11117,11118,11119, #11008 -11120,11121,11122,11123,11124,11125,11126,11127,11128,11129,11130,11131,11132,11133,11134,4955, #11024 -11135,11136,11137,11138,11139,11140,11141,11142,11143,11144,11145,11146,11147,11148,11149,11150, #11040 -11151,11152,11153,11154,11155,11156,11157,11158,11159,11160,11161,4956,11162,11163,11164,11165, #11056 -11166,11167,11168,11169,11170,11171,11172,11173,11174,11175,11176,11177,11178,11179,11180,4957, #11072 -11181,11182,11183,11184,11185,11186,4958,11187,11188,11189,11190,11191,11192,11193,11194,11195, #11088 -11196,11197,11198,11199,11200,3678,11201,11202,11203,11204,11205,11206,4191,11207,11208,11209, #11104 -11210,11211,11212,11213,11214,11215,11216,11217,11218,11219,11220,11221,11222,11223,11224,11225, #11120 -11226,11227,11228,11229,11230,11231,11232,11233,11234,11235,11236,11237,11238,11239,11240,11241, #11136 -11242,11243,11244,11245,11246,11247,11248,11249,11250,11251,4959,11252,11253,11254,11255,11256, #11152 -11257,11258,11259,11260,11261,11262,11263,11264,11265,11266,11267,11268,11269,11270,11271,11272, #11168 -11273,11274,11275,11276,11277,11278,11279,11280,11281,11282,11283,11284,11285,11286,11287,11288, #11184 -11289,11290,11291,11292,11293,11294,11295,11296,11297,11298,11299,11300,11301,11302,11303,11304, #11200 -11305,11306,11307,11308,11309,11310,11311,11312,11313,11314,3679,11315,11316,11317,11318,4490, #11216 -11319,11320,11321,11322,11323,11324,11325,11326,11327,11328,11329,11330,11331,11332,11333,11334, #11232 -11335,11336,11337,11338,11339,11340,11341,11342,11343,11344,11345,11346,11347,4960,11348,11349, #11248 -11350,11351,11352,11353,11354,11355,11356,11357,11358,11359,11360,11361,11362,11363,11364,11365, #11264 -11366,11367,11368,11369,11370,11371,11372,11373,11374,11375,11376,11377,3961,4961,11378,11379, #11280 -11380,11381,11382,11383,11384,11385,11386,11387,11388,11389,11390,11391,11392,11393,11394,11395, #11296 -11396,11397,4192,11398,11399,11400,11401,11402,11403,11404,11405,11406,11407,11408,11409,11410, #11312 -11411,4962,11412,11413,11414,11415,11416,11417,11418,11419,11420,11421,11422,11423,11424,11425, #11328 -11426,11427,11428,11429,11430,11431,11432,11433,11434,11435,11436,11437,11438,11439,11440,11441, #11344 -11442,11443,11444,11445,11446,11447,11448,11449,11450,11451,11452,11453,11454,11455,11456,11457, #11360 -11458,11459,11460,11461,11462,11463,11464,11465,11466,11467,11468,11469,4963,11470,11471,4491, #11376 -11472,11473,11474,11475,4964,11476,11477,11478,11479,11480,11481,11482,11483,11484,11485,11486, #11392 -11487,11488,11489,11490,11491,11492,4965,11493,11494,11495,11496,11497,11498,11499,11500,11501, #11408 -11502,11503,11504,11505,11506,11507,11508,11509,11510,11511,11512,11513,11514,11515,11516,11517, #11424 -11518,11519,11520,11521,11522,11523,11524,11525,11526,11527,11528,11529,3962,11530,11531,11532, #11440 -11533,11534,11535,11536,11537,11538,11539,11540,11541,11542,11543,11544,11545,11546,11547,11548, #11456 -11549,11550,11551,11552,11553,11554,11555,11556,11557,11558,11559,11560,11561,11562,11563,11564, #11472 -4193,4194,11565,11566,11567,11568,11569,11570,11571,11572,11573,11574,11575,11576,11577,11578, #11488 -11579,11580,11581,11582,11583,11584,11585,11586,11587,11588,11589,11590,11591,4966,4195,11592, #11504 -11593,11594,11595,11596,11597,11598,11599,11600,11601,11602,11603,11604,3090,11605,11606,11607, #11520 -11608,11609,11610,4967,11611,11612,11613,11614,11615,11616,11617,11618,11619,11620,11621,11622, #11536 -11623,11624,11625,11626,11627,11628,11629,11630,11631,11632,11633,11634,11635,11636,11637,11638, #11552 -11639,11640,11641,11642,11643,11644,11645,11646,11647,11648,11649,11650,11651,11652,11653,11654, #11568 -11655,11656,11657,11658,11659,11660,11661,11662,11663,11664,11665,11666,11667,11668,11669,11670, #11584 -11671,11672,11673,11674,4968,11675,11676,11677,11678,11679,11680,11681,11682,11683,11684,11685, #11600 -11686,11687,11688,11689,11690,11691,11692,11693,3809,11694,11695,11696,11697,11698,11699,11700, #11616 -11701,11702,11703,11704,11705,11706,11707,11708,11709,11710,11711,11712,11713,11714,11715,11716, #11632 -11717,11718,3553,11719,11720,11721,11722,11723,11724,11725,11726,11727,11728,11729,11730,4969, #11648 -11731,11732,11733,11734,11735,11736,11737,11738,11739,11740,4492,11741,11742,11743,11744,11745, #11664 -11746,11747,11748,11749,11750,11751,11752,4970,11753,11754,11755,11756,11757,11758,11759,11760, #11680 -11761,11762,11763,11764,11765,11766,11767,11768,11769,11770,11771,11772,11773,11774,11775,11776, #11696 -11777,11778,11779,11780,11781,11782,11783,11784,11785,11786,11787,11788,11789,11790,4971,11791, #11712 -11792,11793,11794,11795,11796,11797,4972,11798,11799,11800,11801,11802,11803,11804,11805,11806, #11728 -11807,11808,11809,11810,4973,11811,11812,11813,11814,11815,11816,11817,11818,11819,11820,11821, #11744 -11822,11823,11824,11825,11826,11827,11828,11829,11830,11831,11832,11833,11834,3680,3810,11835, #11760 -11836,4974,11837,11838,11839,11840,11841,11842,11843,11844,11845,11846,11847,11848,11849,11850, #11776 -11851,11852,11853,11854,11855,11856,11857,11858,11859,11860,11861,11862,11863,11864,11865,11866, #11792 -11867,11868,11869,11870,11871,11872,11873,11874,11875,11876,11877,11878,11879,11880,11881,11882, #11808 -11883,11884,4493,11885,11886,11887,11888,11889,11890,11891,11892,11893,11894,11895,11896,11897, #11824 -11898,11899,11900,11901,11902,11903,11904,11905,11906,11907,11908,11909,11910,11911,11912,11913, #11840 -11914,11915,4975,11916,11917,11918,11919,11920,11921,11922,11923,11924,11925,11926,11927,11928, #11856 -11929,11930,11931,11932,11933,11934,11935,11936,11937,11938,11939,11940,11941,11942,11943,11944, #11872 -11945,11946,11947,11948,11949,4976,11950,11951,11952,11953,11954,11955,11956,11957,11958,11959, #11888 -11960,11961,11962,11963,11964,11965,11966,11967,11968,11969,11970,11971,11972,11973,11974,11975, #11904 -11976,11977,11978,11979,11980,11981,11982,11983,11984,11985,11986,11987,4196,11988,11989,11990, #11920 -11991,11992,4977,11993,11994,11995,11996,11997,11998,11999,12000,12001,12002,12003,12004,12005, #11936 -12006,12007,12008,12009,12010,12011,12012,12013,12014,12015,12016,12017,12018,12019,12020,12021, #11952 -12022,12023,12024,12025,12026,12027,12028,12029,12030,12031,12032,12033,12034,12035,12036,12037, #11968 -12038,12039,12040,12041,12042,12043,12044,12045,12046,12047,12048,12049,12050,12051,12052,12053, #11984 -12054,12055,12056,12057,12058,12059,12060,12061,4978,12062,12063,12064,12065,12066,12067,12068, #12000 -12069,12070,12071,12072,12073,12074,12075,12076,12077,12078,12079,12080,12081,12082,12083,12084, #12016 -12085,12086,12087,12088,12089,12090,12091,12092,12093,12094,12095,12096,12097,12098,12099,12100, #12032 -12101,12102,12103,12104,12105,12106,12107,12108,12109,12110,12111,12112,12113,12114,12115,12116, #12048 -12117,12118,12119,12120,12121,12122,12123,4979,12124,12125,12126,12127,12128,4197,12129,12130, #12064 -12131,12132,12133,12134,12135,12136,12137,12138,12139,12140,12141,12142,12143,12144,12145,12146, #12080 -12147,12148,12149,12150,12151,12152,12153,12154,4980,12155,12156,12157,12158,12159,12160,4494, #12096 -12161,12162,12163,12164,3811,12165,12166,12167,12168,12169,4495,12170,12171,4496,12172,12173, #12112 -12174,12175,12176,3812,12177,12178,12179,12180,12181,12182,12183,12184,12185,12186,12187,12188, #12128 -12189,12190,12191,12192,12193,12194,12195,12196,12197,12198,12199,12200,12201,12202,12203,12204, #12144 -12205,12206,12207,12208,12209,12210,12211,12212,12213,12214,12215,12216,12217,12218,12219,12220, #12160 -12221,4981,12222,12223,12224,12225,12226,12227,12228,12229,12230,12231,12232,12233,12234,12235, #12176 -4982,12236,12237,12238,12239,12240,12241,12242,12243,12244,12245,4983,12246,12247,12248,12249, #12192 -4984,12250,12251,12252,12253,12254,12255,12256,12257,12258,12259,12260,12261,12262,12263,12264, #12208 -4985,12265,4497,12266,12267,12268,12269,12270,12271,12272,12273,12274,12275,12276,12277,12278, #12224 -12279,12280,12281,12282,12283,12284,12285,12286,12287,4986,12288,12289,12290,12291,12292,12293, #12240 -12294,12295,12296,2473,12297,12298,12299,12300,12301,12302,12303,12304,12305,12306,12307,12308, #12256 -12309,12310,12311,12312,12313,12314,12315,12316,12317,12318,12319,3963,12320,12321,12322,12323, #12272 -12324,12325,12326,12327,12328,12329,12330,12331,12332,4987,12333,12334,12335,12336,12337,12338, #12288 -12339,12340,12341,12342,12343,12344,12345,12346,12347,12348,12349,12350,12351,12352,12353,12354, #12304 -12355,12356,12357,12358,12359,3964,12360,12361,12362,12363,12364,12365,12366,12367,12368,12369, #12320 -12370,3965,12371,12372,12373,12374,12375,12376,12377,12378,12379,12380,12381,12382,12383,12384, #12336 -12385,12386,12387,12388,12389,12390,12391,12392,12393,12394,12395,12396,12397,12398,12399,12400, #12352 -12401,12402,12403,12404,12405,12406,12407,12408,4988,12409,12410,12411,12412,12413,12414,12415, #12368 -12416,12417,12418,12419,12420,12421,12422,12423,12424,12425,12426,12427,12428,12429,12430,12431, #12384 -12432,12433,12434,12435,12436,12437,12438,3554,12439,12440,12441,12442,12443,12444,12445,12446, #12400 -12447,12448,12449,12450,12451,12452,12453,12454,12455,12456,12457,12458,12459,12460,12461,12462, #12416 -12463,12464,4989,12465,12466,12467,12468,12469,12470,12471,12472,12473,12474,12475,12476,12477, #12432 -12478,12479,12480,4990,12481,12482,12483,12484,12485,12486,12487,12488,12489,4498,12490,12491, #12448 -12492,12493,12494,12495,12496,12497,12498,12499,12500,12501,12502,12503,12504,12505,12506,12507, #12464 -12508,12509,12510,12511,12512,12513,12514,12515,12516,12517,12518,12519,12520,12521,12522,12523, #12480 -12524,12525,12526,12527,12528,12529,12530,12531,12532,12533,12534,12535,12536,12537,12538,12539, #12496 -12540,12541,12542,12543,12544,12545,12546,12547,12548,12549,12550,12551,4991,12552,12553,12554, #12512 -12555,12556,12557,12558,12559,12560,12561,12562,12563,12564,12565,12566,12567,12568,12569,12570, #12528 -12571,12572,12573,12574,12575,12576,12577,12578,3036,12579,12580,12581,12582,12583,3966,12584, #12544 -12585,12586,12587,12588,12589,12590,12591,12592,12593,12594,12595,12596,12597,12598,12599,12600, #12560 -12601,12602,12603,12604,12605,12606,12607,12608,12609,12610,12611,12612,12613,12614,12615,12616, #12576 -12617,12618,12619,12620,12621,12622,12623,12624,12625,12626,12627,12628,12629,12630,12631,12632, #12592 -12633,12634,12635,12636,12637,12638,12639,12640,12641,12642,12643,12644,12645,12646,4499,12647, #12608 -12648,12649,12650,12651,12652,12653,12654,12655,12656,12657,12658,12659,12660,12661,12662,12663, #12624 -12664,12665,12666,12667,12668,12669,12670,12671,12672,12673,12674,12675,12676,12677,12678,12679, #12640 -12680,12681,12682,12683,12684,12685,12686,12687,12688,12689,12690,12691,12692,12693,12694,12695, #12656 -12696,12697,12698,4992,12699,12700,12701,12702,12703,12704,12705,12706,12707,12708,12709,12710, #12672 -12711,12712,12713,12714,12715,12716,12717,12718,12719,12720,12721,12722,12723,12724,12725,12726, #12688 -12727,12728,12729,12730,12731,12732,12733,12734,12735,12736,12737,12738,12739,12740,12741,12742, #12704 -12743,12744,12745,12746,12747,12748,12749,12750,12751,12752,12753,12754,12755,12756,12757,12758, #12720 -12759,12760,12761,12762,12763,12764,12765,12766,12767,12768,12769,12770,12771,12772,12773,12774, #12736 -12775,12776,12777,12778,4993,2175,12779,12780,12781,12782,12783,12784,12785,12786,4500,12787, #12752 -12788,12789,12790,12791,12792,12793,12794,12795,12796,12797,12798,12799,12800,12801,12802,12803, #12768 -12804,12805,12806,12807,12808,12809,12810,12811,12812,12813,12814,12815,12816,12817,12818,12819, #12784 -12820,12821,12822,12823,12824,12825,12826,4198,3967,12827,12828,12829,12830,12831,12832,12833, #12800 -12834,12835,12836,12837,12838,12839,12840,12841,12842,12843,12844,12845,12846,12847,12848,12849, #12816 -12850,12851,12852,12853,12854,12855,12856,12857,12858,12859,12860,12861,4199,12862,12863,12864, #12832 -12865,12866,12867,12868,12869,12870,12871,12872,12873,12874,12875,12876,12877,12878,12879,12880, #12848 -12881,12882,12883,12884,12885,12886,12887,4501,12888,12889,12890,12891,12892,12893,12894,12895, #12864 -12896,12897,12898,12899,12900,12901,12902,12903,12904,12905,12906,12907,12908,12909,12910,12911, #12880 -12912,4994,12913,12914,12915,12916,12917,12918,12919,12920,12921,12922,12923,12924,12925,12926, #12896 -12927,12928,12929,12930,12931,12932,12933,12934,12935,12936,12937,12938,12939,12940,12941,12942, #12912 -12943,12944,12945,12946,12947,12948,12949,12950,12951,12952,12953,12954,12955,12956,1772,12957, #12928 -12958,12959,12960,12961,12962,12963,12964,12965,12966,12967,12968,12969,12970,12971,12972,12973, #12944 -12974,12975,12976,12977,12978,12979,12980,12981,12982,12983,12984,12985,12986,12987,12988,12989, #12960 -12990,12991,12992,12993,12994,12995,12996,12997,4502,12998,4503,12999,13000,13001,13002,13003, #12976 -4504,13004,13005,13006,13007,13008,13009,13010,13011,13012,13013,13014,13015,13016,13017,13018, #12992 -13019,13020,13021,13022,13023,13024,13025,13026,13027,13028,13029,3449,13030,13031,13032,13033, #13008 -13034,13035,13036,13037,13038,13039,13040,13041,13042,13043,13044,13045,13046,13047,13048,13049, #13024 -13050,13051,13052,13053,13054,13055,13056,13057,13058,13059,13060,13061,13062,13063,13064,13065, #13040 -13066,13067,13068,13069,13070,13071,13072,13073,13074,13075,13076,13077,13078,13079,13080,13081, #13056 -13082,13083,13084,13085,13086,13087,13088,13089,13090,13091,13092,13093,13094,13095,13096,13097, #13072 -13098,13099,13100,13101,13102,13103,13104,13105,13106,13107,13108,13109,13110,13111,13112,13113, #13088 -13114,13115,13116,13117,13118,3968,13119,4995,13120,13121,13122,13123,13124,13125,13126,13127, #13104 -4505,13128,13129,13130,13131,13132,13133,13134,4996,4506,13135,13136,13137,13138,13139,4997, #13120 -13140,13141,13142,13143,13144,13145,13146,13147,13148,13149,13150,13151,13152,13153,13154,13155, #13136 -13156,13157,13158,13159,4998,13160,13161,13162,13163,13164,13165,13166,13167,13168,13169,13170, #13152 -13171,13172,13173,13174,13175,13176,4999,13177,13178,13179,13180,13181,13182,13183,13184,13185, #13168 -13186,13187,13188,13189,13190,13191,13192,13193,13194,13195,13196,13197,13198,13199,13200,13201, #13184 -13202,13203,13204,13205,13206,5000,13207,13208,13209,13210,13211,13212,13213,13214,13215,13216, #13200 -13217,13218,13219,13220,13221,13222,13223,13224,13225,13226,13227,4200,5001,13228,13229,13230, #13216 -13231,13232,13233,13234,13235,13236,13237,13238,13239,13240,3969,13241,13242,13243,13244,3970, #13232 -13245,13246,13247,13248,13249,13250,13251,13252,13253,13254,13255,13256,13257,13258,13259,13260, #13248 -13261,13262,13263,13264,13265,13266,13267,13268,3450,13269,13270,13271,13272,13273,13274,13275, #13264 -13276,5002,13277,13278,13279,13280,13281,13282,13283,13284,13285,13286,13287,13288,13289,13290, #13280 -13291,13292,13293,13294,13295,13296,13297,13298,13299,13300,13301,13302,3813,13303,13304,13305, #13296 -13306,13307,13308,13309,13310,13311,13312,13313,13314,13315,13316,13317,13318,13319,13320,13321, #13312 -13322,13323,13324,13325,13326,13327,13328,4507,13329,13330,13331,13332,13333,13334,13335,13336, #13328 -13337,13338,13339,13340,13341,5003,13342,13343,13344,13345,13346,13347,13348,13349,13350,13351, #13344 -13352,13353,13354,13355,13356,13357,13358,13359,13360,13361,13362,13363,13364,13365,13366,13367, #13360 -5004,13368,13369,13370,13371,13372,13373,13374,13375,13376,13377,13378,13379,13380,13381,13382, #13376 -13383,13384,13385,13386,13387,13388,13389,13390,13391,13392,13393,13394,13395,13396,13397,13398, #13392 -13399,13400,13401,13402,13403,13404,13405,13406,13407,13408,13409,13410,13411,13412,13413,13414, #13408 -13415,13416,13417,13418,13419,13420,13421,13422,13423,13424,13425,13426,13427,13428,13429,13430, #13424 -13431,13432,4508,13433,13434,13435,4201,13436,13437,13438,13439,13440,13441,13442,13443,13444, #13440 -13445,13446,13447,13448,13449,13450,13451,13452,13453,13454,13455,13456,13457,5005,13458,13459, #13456 -13460,13461,13462,13463,13464,13465,13466,13467,13468,13469,13470,4509,13471,13472,13473,13474, #13472 -13475,13476,13477,13478,13479,13480,13481,13482,13483,13484,13485,13486,13487,13488,13489,13490, #13488 -13491,13492,13493,13494,13495,13496,13497,13498,13499,13500,13501,13502,13503,13504,13505,13506, #13504 -13507,13508,13509,13510,13511,13512,13513,13514,13515,13516,13517,13518,13519,13520,13521,13522, #13520 -13523,13524,13525,13526,13527,13528,13529,13530,13531,13532,13533,13534,13535,13536,13537,13538, #13536 -13539,13540,13541,13542,13543,13544,13545,13546,13547,13548,13549,13550,13551,13552,13553,13554, #13552 -13555,13556,13557,13558,13559,13560,13561,13562,13563,13564,13565,13566,13567,13568,13569,13570, #13568 -13571,13572,13573,13574,13575,13576,13577,13578,13579,13580,13581,13582,13583,13584,13585,13586, #13584 -13587,13588,13589,13590,13591,13592,13593,13594,13595,13596,13597,13598,13599,13600,13601,13602, #13600 -13603,13604,13605,13606,13607,13608,13609,13610,13611,13612,13613,13614,13615,13616,13617,13618, #13616 -13619,13620,13621,13622,13623,13624,13625,13626,13627,13628,13629,13630,13631,13632,13633,13634, #13632 -13635,13636,13637,13638,13639,13640,13641,13642,5006,13643,13644,13645,13646,13647,13648,13649, #13648 -13650,13651,5007,13652,13653,13654,13655,13656,13657,13658,13659,13660,13661,13662,13663,13664, #13664 -13665,13666,13667,13668,13669,13670,13671,13672,13673,13674,13675,13676,13677,13678,13679,13680, #13680 -13681,13682,13683,13684,13685,13686,13687,13688,13689,13690,13691,13692,13693,13694,13695,13696, #13696 -13697,13698,13699,13700,13701,13702,13703,13704,13705,13706,13707,13708,13709,13710,13711,13712, #13712 -13713,13714,13715,13716,13717,13718,13719,13720,13721,13722,13723,13724,13725,13726,13727,13728, #13728 -13729,13730,13731,13732,13733,13734,13735,13736,13737,13738,13739,13740,13741,13742,13743,13744, #13744 -13745,13746,13747,13748,13749,13750,13751,13752,13753,13754,13755,13756,13757,13758,13759,13760, #13760 -13761,13762,13763,13764,13765,13766,13767,13768,13769,13770,13771,13772,13773,13774,3273,13775, #13776 -13776,13777,13778,13779,13780,13781,13782,13783,13784,13785,13786,13787,13788,13789,13790,13791, #13792 -13792,13793,13794,13795,13796,13797,13798,13799,13800,13801,13802,13803,13804,13805,13806,13807, #13808 -13808,13809,13810,13811,13812,13813,13814,13815,13816,13817,13818,13819,13820,13821,13822,13823, #13824 -13824,13825,13826,13827,13828,13829,13830,13831,13832,13833,13834,13835,13836,13837,13838,13839, #13840 -13840,13841,13842,13843,13844,13845,13846,13847,13848,13849,13850,13851,13852,13853,13854,13855, #13856 -13856,13857,13858,13859,13860,13861,13862,13863,13864,13865,13866,13867,13868,13869,13870,13871, #13872 -13872,13873,13874,13875,13876,13877,13878,13879,13880,13881,13882,13883,13884,13885,13886,13887, #13888 -13888,13889,13890,13891,13892,13893,13894,13895,13896,13897,13898,13899,13900,13901,13902,13903, #13904 -13904,13905,13906,13907,13908,13909,13910,13911,13912,13913,13914,13915,13916,13917,13918,13919, #13920 -13920,13921,13922,13923,13924,13925,13926,13927,13928,13929,13930,13931,13932,13933,13934,13935, #13936 -13936,13937,13938,13939,13940,13941,13942,13943,13944,13945,13946,13947,13948,13949,13950,13951, #13952 -13952,13953,13954,13955,13956,13957,13958,13959,13960,13961,13962,13963,13964,13965,13966,13967, #13968 -13968,13969,13970,13971,13972) #13973 - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5prober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5prober.py deleted file mode 100644 index becce81e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/big5prober.py +++ /dev/null @@ -1,42 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import Big5DistributionAnalysis -from .mbcssm import Big5SMModel - - -class Big5Prober(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(Big5SMModel) - self._mDistributionAnalyzer = Big5DistributionAnalysis() - self.reset() - - def get_charset_name(self): - return "Big5" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardetect.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardetect.py deleted file mode 100644 index ffe892f2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardetect.py +++ /dev/null @@ -1,80 +0,0 @@ -#!/usr/bin/env python -""" -Script which takes one or more file paths and reports on their detected -encodings - -Example:: - - % chardetect somefile someotherfile - somefile: windows-1252 with confidence 0.5 - someotherfile: ascii with confidence 1.0 - -If no paths are provided, it takes its input from stdin. - -""" - -from __future__ import absolute_import, print_function, unicode_literals - -import argparse -import sys -from io import open - -from chardet import __version__ -from chardet.universaldetector import UniversalDetector - - -def description_of(lines, name='stdin'): - """ - Return a string describing the probable encoding of a file or - list of strings. - - :param lines: The lines to get the encoding of. - :type lines: Iterable of bytes - :param name: Name of file or collection of lines - :type name: str - """ - u = UniversalDetector() - for line in lines: - u.feed(line) - u.close() - result = u.result - if result['encoding']: - return '{0}: {1} with confidence {2}'.format(name, result['encoding'], - result['confidence']) - else: - return '{0}: no result'.format(name) - - -def main(argv=None): - ''' - Handles command line arguments and gets things started. - - :param argv: List of arguments, as if specified on the command-line. - If None, ``sys.argv[1:]`` is used instead. - :type argv: list of str - ''' - # Get command line arguments - parser = argparse.ArgumentParser( - description="Takes one or more file paths and reports their detected \ - encodings", - formatter_class=argparse.ArgumentDefaultsHelpFormatter, - conflict_handler='resolve') - parser.add_argument('input', - help='File whose encoding we would like to determine.', - type=argparse.FileType('rb'), nargs='*', - default=[sys.stdin]) - parser.add_argument('--version', action='version', - version='%(prog)s {0}'.format(__version__)) - args = parser.parse_args(argv) - - for f in args.input: - if f.isatty(): - print("You are running chardetect interactively. Press " + - "CTRL-D twice at the start of a blank line to signal the " + - "end of your input. If you want help, run chardetect " + - "--help\n", file=sys.stderr) - print(description_of(f, f.name)) - - -if __name__ == '__main__': - main() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardistribution.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardistribution.py deleted file mode 100644 index 4e64a00b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/chardistribution.py +++ /dev/null @@ -1,231 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .euctwfreq import (EUCTWCharToFreqOrder, EUCTW_TABLE_SIZE, - EUCTW_TYPICAL_DISTRIBUTION_RATIO) -from .euckrfreq import (EUCKRCharToFreqOrder, EUCKR_TABLE_SIZE, - EUCKR_TYPICAL_DISTRIBUTION_RATIO) -from .gb2312freq import (GB2312CharToFreqOrder, GB2312_TABLE_SIZE, - GB2312_TYPICAL_DISTRIBUTION_RATIO) -from .big5freq import (Big5CharToFreqOrder, BIG5_TABLE_SIZE, - BIG5_TYPICAL_DISTRIBUTION_RATIO) -from .jisfreq import (JISCharToFreqOrder, JIS_TABLE_SIZE, - JIS_TYPICAL_DISTRIBUTION_RATIO) -from .compat import wrap_ord - -ENOUGH_DATA_THRESHOLD = 1024 -SURE_YES = 0.99 -SURE_NO = 0.01 -MINIMUM_DATA_THRESHOLD = 3 - - -class CharDistributionAnalysis: - def __init__(self): - # Mapping table to get frequency order from char order (get from - # GetOrder()) - self._mCharToFreqOrder = None - self._mTableSize = None # Size of above table - # This is a constant value which varies from language to language, - # used in calculating confidence. See - # http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html - # for further detail. - self._mTypicalDistributionRatio = None - self.reset() - - def reset(self): - """reset analyser, clear any state""" - # If this flag is set to True, detection is done and conclusion has - # been made - self._mDone = False - self._mTotalChars = 0 # Total characters encountered - # The number of characters whose frequency order is less than 512 - self._mFreqChars = 0 - - def feed(self, aBuf, aCharLen): - """feed a character with known length""" - if aCharLen == 2: - # we only care about 2-bytes character in our distribution analysis - order = self.get_order(aBuf) - else: - order = -1 - if order >= 0: - self._mTotalChars += 1 - # order is valid - if order < self._mTableSize: - if 512 > self._mCharToFreqOrder[order]: - self._mFreqChars += 1 - - def get_confidence(self): - """return confidence based on existing data""" - # if we didn't receive any character in our consideration range, - # return negative answer - if self._mTotalChars <= 0 or self._mFreqChars <= MINIMUM_DATA_THRESHOLD: - return SURE_NO - - if self._mTotalChars != self._mFreqChars: - r = (self._mFreqChars / ((self._mTotalChars - self._mFreqChars) - * self._mTypicalDistributionRatio)) - if r < SURE_YES: - return r - - # normalize confidence (we don't want to be 100% sure) - return SURE_YES - - def got_enough_data(self): - # It is not necessary to receive all data to draw conclusion. - # For charset detection, certain amount of data is enough - return self._mTotalChars > ENOUGH_DATA_THRESHOLD - - def get_order(self, aBuf): - # We do not handle characters based on the original encoding string, - # but convert this encoding string to a number, here called order. - # This allows multiple encodings of a language to share one frequency - # table. - return -1 - - -class EUCTWDistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = EUCTWCharToFreqOrder - self._mTableSize = EUCTW_TABLE_SIZE - self._mTypicalDistributionRatio = EUCTW_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for euc-TW encoding, we are interested - # first byte range: 0xc4 -- 0xfe - # second byte range: 0xa1 -- 0xfe - # no validation needed here. State machine has done that - first_char = wrap_ord(aBuf[0]) - if first_char >= 0xC4: - return 94 * (first_char - 0xC4) + wrap_ord(aBuf[1]) - 0xA1 - else: - return -1 - - -class EUCKRDistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = EUCKRCharToFreqOrder - self._mTableSize = EUCKR_TABLE_SIZE - self._mTypicalDistributionRatio = EUCKR_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for euc-KR encoding, we are interested - # first byte range: 0xb0 -- 0xfe - # second byte range: 0xa1 -- 0xfe - # no validation needed here. State machine has done that - first_char = wrap_ord(aBuf[0]) - if first_char >= 0xB0: - return 94 * (first_char - 0xB0) + wrap_ord(aBuf[1]) - 0xA1 - else: - return -1 - - -class GB2312DistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = GB2312CharToFreqOrder - self._mTableSize = GB2312_TABLE_SIZE - self._mTypicalDistributionRatio = GB2312_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for GB2312 encoding, we are interested - # first byte range: 0xb0 -- 0xfe - # second byte range: 0xa1 -- 0xfe - # no validation needed here. State machine has done that - first_char, second_char = wrap_ord(aBuf[0]), wrap_ord(aBuf[1]) - if (first_char >= 0xB0) and (second_char >= 0xA1): - return 94 * (first_char - 0xB0) + second_char - 0xA1 - else: - return -1 - - -class Big5DistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = Big5CharToFreqOrder - self._mTableSize = BIG5_TABLE_SIZE - self._mTypicalDistributionRatio = BIG5_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for big5 encoding, we are interested - # first byte range: 0xa4 -- 0xfe - # second byte range: 0x40 -- 0x7e , 0xa1 -- 0xfe - # no validation needed here. State machine has done that - first_char, second_char = wrap_ord(aBuf[0]), wrap_ord(aBuf[1]) - if first_char >= 0xA4: - if second_char >= 0xA1: - return 157 * (first_char - 0xA4) + second_char - 0xA1 + 63 - else: - return 157 * (first_char - 0xA4) + second_char - 0x40 - else: - return -1 - - -class SJISDistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = JISCharToFreqOrder - self._mTableSize = JIS_TABLE_SIZE - self._mTypicalDistributionRatio = JIS_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for sjis encoding, we are interested - # first byte range: 0x81 -- 0x9f , 0xe0 -- 0xfe - # second byte range: 0x40 -- 0x7e, 0x81 -- oxfe - # no validation needed here. State machine has done that - first_char, second_char = wrap_ord(aBuf[0]), wrap_ord(aBuf[1]) - if (first_char >= 0x81) and (first_char <= 0x9F): - order = 188 * (first_char - 0x81) - elif (first_char >= 0xE0) and (first_char <= 0xEF): - order = 188 * (first_char - 0xE0 + 31) - else: - return -1 - order = order + second_char - 0x40 - if second_char > 0x7F: - order = -1 - return order - - -class EUCJPDistributionAnalysis(CharDistributionAnalysis): - def __init__(self): - CharDistributionAnalysis.__init__(self) - self._mCharToFreqOrder = JISCharToFreqOrder - self._mTableSize = JIS_TABLE_SIZE - self._mTypicalDistributionRatio = JIS_TYPICAL_DISTRIBUTION_RATIO - - def get_order(self, aBuf): - # for euc-JP encoding, we are interested - # first byte range: 0xa0 -- 0xfe - # second byte range: 0xa1 -- 0xfe - # no validation needed here. State machine has done that - char = wrap_ord(aBuf[0]) - if char >= 0xA0: - return 94 * (char - 0xA1) + wrap_ord(aBuf[1]) - 0xa1 - else: - return -1 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetgroupprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetgroupprober.py deleted file mode 100644 index 85e7a1c6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetgroupprober.py +++ /dev/null @@ -1,106 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from . import constants -import sys -from .charsetprober import CharSetProber - - -class CharSetGroupProber(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self._mActiveNum = 0 - self._mProbers = [] - self._mBestGuessProber = None - - def reset(self): - CharSetProber.reset(self) - self._mActiveNum = 0 - for prober in self._mProbers: - if prober: - prober.reset() - prober.active = True - self._mActiveNum += 1 - self._mBestGuessProber = None - - def get_charset_name(self): - if not self._mBestGuessProber: - self.get_confidence() - if not self._mBestGuessProber: - return None -# self._mBestGuessProber = self._mProbers[0] - return self._mBestGuessProber.get_charset_name() - - def feed(self, aBuf): - for prober in self._mProbers: - if not prober: - continue - if not prober.active: - continue - st = prober.feed(aBuf) - if not st: - continue - if st == constants.eFoundIt: - self._mBestGuessProber = prober - return self.get_state() - elif st == constants.eNotMe: - prober.active = False - self._mActiveNum -= 1 - if self._mActiveNum <= 0: - self._mState = constants.eNotMe - return self.get_state() - return self.get_state() - - def get_confidence(self): - st = self.get_state() - if st == constants.eFoundIt: - return 0.99 - elif st == constants.eNotMe: - return 0.01 - bestConf = 0.0 - self._mBestGuessProber = None - for prober in self._mProbers: - if not prober: - continue - if not prober.active: - if constants._debug: - sys.stderr.write(prober.get_charset_name() - + ' not active\n') - continue - cf = prober.get_confidence() - if constants._debug: - sys.stderr.write('%s confidence = %s\n' % - (prober.get_charset_name(), cf)) - if bestConf < cf: - bestConf = cf - self._mBestGuessProber = prober - if not self._mBestGuessProber: - return 0.0 - return bestConf -# else: -# self._mBestGuessProber = self._mProbers[0] -# return self._mBestGuessProber.get_confidence() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetprober.py deleted file mode 100644 index 97581712..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/charsetprober.py +++ /dev/null @@ -1,62 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from . import constants -import re - - -class CharSetProber: - def __init__(self): - pass - - def reset(self): - self._mState = constants.eDetecting - - def get_charset_name(self): - return None - - def feed(self, aBuf): - pass - - def get_state(self): - return self._mState - - def get_confidence(self): - return 0.0 - - def filter_high_bit_only(self, aBuf): - aBuf = re.sub(b'([\x00-\x7F])+', b' ', aBuf) - return aBuf - - def filter_without_english_letters(self, aBuf): - aBuf = re.sub(b'([A-Za-z])+', b' ', aBuf) - return aBuf - - def filter_with_english_letters(self, aBuf): - # TODO - return aBuf diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/codingstatemachine.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/codingstatemachine.py deleted file mode 100644 index 8dd8c917..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/codingstatemachine.py +++ /dev/null @@ -1,61 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .constants import eStart -from .compat import wrap_ord - - -class CodingStateMachine: - def __init__(self, sm): - self._mModel = sm - self._mCurrentBytePos = 0 - self._mCurrentCharLen = 0 - self.reset() - - def reset(self): - self._mCurrentState = eStart - - def next_state(self, c): - # for each byte we get its class - # if it is first byte, we also get byte length - # PY3K: aBuf is a byte stream, so c is an int, not a byte - byteCls = self._mModel['classTable'][wrap_ord(c)] - if self._mCurrentState == eStart: - self._mCurrentBytePos = 0 - self._mCurrentCharLen = self._mModel['charLenTable'][byteCls] - # from byte's class and stateTable, we get its next state - curr_state = (self._mCurrentState * self._mModel['classFactor'] - + byteCls) - self._mCurrentState = self._mModel['stateTable'][curr_state] - self._mCurrentBytePos += 1 - return self._mCurrentState - - def get_current_charlen(self): - return self._mCurrentCharLen - - def get_coding_state_machine(self): - return self._mModel['name'] diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/compat.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/compat.py deleted file mode 100644 index d9e30add..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/compat.py +++ /dev/null @@ -1,34 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# Contributor(s): -# Ian Cordasco - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -import sys - - -if sys.version_info < (3, 0): - base_str = (str, unicode) -else: - base_str = (bytes, str) - - -def wrap_ord(a): - if sys.version_info < (3, 0) and isinstance(a, base_str): - return ord(a) - else: - return a diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/constants.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/constants.py deleted file mode 100644 index e4d148b3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/constants.py +++ /dev/null @@ -1,39 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -_debug = 0 - -eDetecting = 0 -eFoundIt = 1 -eNotMe = 2 - -eStart = 0 -eError = 1 -eItsMe = 2 - -SHORTCUT_THRESHOLD = 0.95 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/cp949prober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/cp949prober.py deleted file mode 100644 index ff4272f8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/cp949prober.py +++ /dev/null @@ -1,44 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import EUCKRDistributionAnalysis -from .mbcssm import CP949SMModel - - -class CP949Prober(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(CP949SMModel) - # NOTE: CP949 is a superset of EUC-KR, so the distribution should be - # not different. - self._mDistributionAnalyzer = EUCKRDistributionAnalysis() - self.reset() - - def get_charset_name(self): - return "CP949" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escprober.py deleted file mode 100644 index 80a844ff..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escprober.py +++ /dev/null @@ -1,86 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from . import constants -from .escsm import (HZSMModel, ISO2022CNSMModel, ISO2022JPSMModel, - ISO2022KRSMModel) -from .charsetprober import CharSetProber -from .codingstatemachine import CodingStateMachine -from .compat import wrap_ord - - -class EscCharSetProber(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self._mCodingSM = [ - CodingStateMachine(HZSMModel), - CodingStateMachine(ISO2022CNSMModel), - CodingStateMachine(ISO2022JPSMModel), - CodingStateMachine(ISO2022KRSMModel) - ] - self.reset() - - def reset(self): - CharSetProber.reset(self) - for codingSM in self._mCodingSM: - if not codingSM: - continue - codingSM.active = True - codingSM.reset() - self._mActiveSM = len(self._mCodingSM) - self._mDetectedCharset = None - - def get_charset_name(self): - return self._mDetectedCharset - - def get_confidence(self): - if self._mDetectedCharset: - return 0.99 - else: - return 0.00 - - def feed(self, aBuf): - for c in aBuf: - # PY3K: aBuf is a byte array, so c is an int, not a byte - for codingSM in self._mCodingSM: - if not codingSM: - continue - if not codingSM.active: - continue - codingState = codingSM.next_state(wrap_ord(c)) - if codingState == constants.eError: - codingSM.active = False - self._mActiveSM -= 1 - if self._mActiveSM <= 0: - self._mState = constants.eNotMe - return self.get_state() - elif codingState == constants.eItsMe: - self._mState = constants.eFoundIt - self._mDetectedCharset = codingSM.get_coding_state_machine() # nopep8 - return self.get_state() - - return self.get_state() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escsm.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escsm.py deleted file mode 100644 index bd302b4c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/escsm.py +++ /dev/null @@ -1,242 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .constants import eStart, eError, eItsMe - -HZ_cls = ( -1,0,0,0,0,0,0,0, # 00 - 07 -0,0,0,0,0,0,0,0, # 08 - 0f -0,0,0,0,0,0,0,0, # 10 - 17 -0,0,0,1,0,0,0,0, # 18 - 1f -0,0,0,0,0,0,0,0, # 20 - 27 -0,0,0,0,0,0,0,0, # 28 - 2f -0,0,0,0,0,0,0,0, # 30 - 37 -0,0,0,0,0,0,0,0, # 38 - 3f -0,0,0,0,0,0,0,0, # 40 - 47 -0,0,0,0,0,0,0,0, # 48 - 4f -0,0,0,0,0,0,0,0, # 50 - 57 -0,0,0,0,0,0,0,0, # 58 - 5f -0,0,0,0,0,0,0,0, # 60 - 67 -0,0,0,0,0,0,0,0, # 68 - 6f -0,0,0,0,0,0,0,0, # 70 - 77 -0,0,0,4,0,5,2,0, # 78 - 7f -1,1,1,1,1,1,1,1, # 80 - 87 -1,1,1,1,1,1,1,1, # 88 - 8f -1,1,1,1,1,1,1,1, # 90 - 97 -1,1,1,1,1,1,1,1, # 98 - 9f -1,1,1,1,1,1,1,1, # a0 - a7 -1,1,1,1,1,1,1,1, # a8 - af -1,1,1,1,1,1,1,1, # b0 - b7 -1,1,1,1,1,1,1,1, # b8 - bf -1,1,1,1,1,1,1,1, # c0 - c7 -1,1,1,1,1,1,1,1, # c8 - cf -1,1,1,1,1,1,1,1, # d0 - d7 -1,1,1,1,1,1,1,1, # d8 - df -1,1,1,1,1,1,1,1, # e0 - e7 -1,1,1,1,1,1,1,1, # e8 - ef -1,1,1,1,1,1,1,1, # f0 - f7 -1,1,1,1,1,1,1,1, # f8 - ff -) - -HZ_st = ( -eStart,eError, 3,eStart,eStart,eStart,eError,eError,# 00-07 -eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,# 08-0f -eItsMe,eItsMe,eError,eError,eStart,eStart, 4,eError,# 10-17 - 5,eError, 6,eError, 5, 5, 4,eError,# 18-1f - 4,eError, 4, 4, 4,eError, 4,eError,# 20-27 - 4,eItsMe,eStart,eStart,eStart,eStart,eStart,eStart,# 28-2f -) - -HZCharLenTable = (0, 0, 0, 0, 0, 0) - -HZSMModel = {'classTable': HZ_cls, - 'classFactor': 6, - 'stateTable': HZ_st, - 'charLenTable': HZCharLenTable, - 'name': "HZ-GB-2312"} - -ISO2022CN_cls = ( -2,0,0,0,0,0,0,0, # 00 - 07 -0,0,0,0,0,0,0,0, # 08 - 0f -0,0,0,0,0,0,0,0, # 10 - 17 -0,0,0,1,0,0,0,0, # 18 - 1f -0,0,0,0,0,0,0,0, # 20 - 27 -0,3,0,0,0,0,0,0, # 28 - 2f -0,0,0,0,0,0,0,0, # 30 - 37 -0,0,0,0,0,0,0,0, # 38 - 3f -0,0,0,4,0,0,0,0, # 40 - 47 -0,0,0,0,0,0,0,0, # 48 - 4f -0,0,0,0,0,0,0,0, # 50 - 57 -0,0,0,0,0,0,0,0, # 58 - 5f -0,0,0,0,0,0,0,0, # 60 - 67 -0,0,0,0,0,0,0,0, # 68 - 6f -0,0,0,0,0,0,0,0, # 70 - 77 -0,0,0,0,0,0,0,0, # 78 - 7f -2,2,2,2,2,2,2,2, # 80 - 87 -2,2,2,2,2,2,2,2, # 88 - 8f -2,2,2,2,2,2,2,2, # 90 - 97 -2,2,2,2,2,2,2,2, # 98 - 9f -2,2,2,2,2,2,2,2, # a0 - a7 -2,2,2,2,2,2,2,2, # a8 - af -2,2,2,2,2,2,2,2, # b0 - b7 -2,2,2,2,2,2,2,2, # b8 - bf -2,2,2,2,2,2,2,2, # c0 - c7 -2,2,2,2,2,2,2,2, # c8 - cf -2,2,2,2,2,2,2,2, # d0 - d7 -2,2,2,2,2,2,2,2, # d8 - df -2,2,2,2,2,2,2,2, # e0 - e7 -2,2,2,2,2,2,2,2, # e8 - ef -2,2,2,2,2,2,2,2, # f0 - f7 -2,2,2,2,2,2,2,2, # f8 - ff -) - -ISO2022CN_st = ( -eStart, 3,eError,eStart,eStart,eStart,eStart,eStart,# 00-07 -eStart,eError,eError,eError,eError,eError,eError,eError,# 08-0f -eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,# 10-17 -eItsMe,eItsMe,eItsMe,eError,eError,eError, 4,eError,# 18-1f -eError,eError,eError,eItsMe,eError,eError,eError,eError,# 20-27 - 5, 6,eError,eError,eError,eError,eError,eError,# 28-2f -eError,eError,eError,eItsMe,eError,eError,eError,eError,# 30-37 -eError,eError,eError,eError,eError,eItsMe,eError,eStart,# 38-3f -) - -ISO2022CNCharLenTable = (0, 0, 0, 0, 0, 0, 0, 0, 0) - -ISO2022CNSMModel = {'classTable': ISO2022CN_cls, - 'classFactor': 9, - 'stateTable': ISO2022CN_st, - 'charLenTable': ISO2022CNCharLenTable, - 'name': "ISO-2022-CN"} - -ISO2022JP_cls = ( -2,0,0,0,0,0,0,0, # 00 - 07 -0,0,0,0,0,0,2,2, # 08 - 0f -0,0,0,0,0,0,0,0, # 10 - 17 -0,0,0,1,0,0,0,0, # 18 - 1f -0,0,0,0,7,0,0,0, # 20 - 27 -3,0,0,0,0,0,0,0, # 28 - 2f -0,0,0,0,0,0,0,0, # 30 - 37 -0,0,0,0,0,0,0,0, # 38 - 3f -6,0,4,0,8,0,0,0, # 40 - 47 -0,9,5,0,0,0,0,0, # 48 - 4f -0,0,0,0,0,0,0,0, # 50 - 57 -0,0,0,0,0,0,0,0, # 58 - 5f -0,0,0,0,0,0,0,0, # 60 - 67 -0,0,0,0,0,0,0,0, # 68 - 6f -0,0,0,0,0,0,0,0, # 70 - 77 -0,0,0,0,0,0,0,0, # 78 - 7f -2,2,2,2,2,2,2,2, # 80 - 87 -2,2,2,2,2,2,2,2, # 88 - 8f -2,2,2,2,2,2,2,2, # 90 - 97 -2,2,2,2,2,2,2,2, # 98 - 9f -2,2,2,2,2,2,2,2, # a0 - a7 -2,2,2,2,2,2,2,2, # a8 - af -2,2,2,2,2,2,2,2, # b0 - b7 -2,2,2,2,2,2,2,2, # b8 - bf -2,2,2,2,2,2,2,2, # c0 - c7 -2,2,2,2,2,2,2,2, # c8 - cf -2,2,2,2,2,2,2,2, # d0 - d7 -2,2,2,2,2,2,2,2, # d8 - df -2,2,2,2,2,2,2,2, # e0 - e7 -2,2,2,2,2,2,2,2, # e8 - ef -2,2,2,2,2,2,2,2, # f0 - f7 -2,2,2,2,2,2,2,2, # f8 - ff -) - -ISO2022JP_st = ( -eStart, 3,eError,eStart,eStart,eStart,eStart,eStart,# 00-07 -eStart,eStart,eError,eError,eError,eError,eError,eError,# 08-0f -eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,# 10-17 -eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eError,eError,# 18-1f -eError, 5,eError,eError,eError, 4,eError,eError,# 20-27 -eError,eError,eError, 6,eItsMe,eError,eItsMe,eError,# 28-2f -eError,eError,eError,eError,eError,eError,eItsMe,eItsMe,# 30-37 -eError,eError,eError,eItsMe,eError,eError,eError,eError,# 38-3f -eError,eError,eError,eError,eItsMe,eError,eStart,eStart,# 40-47 -) - -ISO2022JPCharLenTable = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0) - -ISO2022JPSMModel = {'classTable': ISO2022JP_cls, - 'classFactor': 10, - 'stateTable': ISO2022JP_st, - 'charLenTable': ISO2022JPCharLenTable, - 'name': "ISO-2022-JP"} - -ISO2022KR_cls = ( -2,0,0,0,0,0,0,0, # 00 - 07 -0,0,0,0,0,0,0,0, # 08 - 0f -0,0,0,0,0,0,0,0, # 10 - 17 -0,0,0,1,0,0,0,0, # 18 - 1f -0,0,0,0,3,0,0,0, # 20 - 27 -0,4,0,0,0,0,0,0, # 28 - 2f -0,0,0,0,0,0,0,0, # 30 - 37 -0,0,0,0,0,0,0,0, # 38 - 3f -0,0,0,5,0,0,0,0, # 40 - 47 -0,0,0,0,0,0,0,0, # 48 - 4f -0,0,0,0,0,0,0,0, # 50 - 57 -0,0,0,0,0,0,0,0, # 58 - 5f -0,0,0,0,0,0,0,0, # 60 - 67 -0,0,0,0,0,0,0,0, # 68 - 6f -0,0,0,0,0,0,0,0, # 70 - 77 -0,0,0,0,0,0,0,0, # 78 - 7f -2,2,2,2,2,2,2,2, # 80 - 87 -2,2,2,2,2,2,2,2, # 88 - 8f -2,2,2,2,2,2,2,2, # 90 - 97 -2,2,2,2,2,2,2,2, # 98 - 9f -2,2,2,2,2,2,2,2, # a0 - a7 -2,2,2,2,2,2,2,2, # a8 - af -2,2,2,2,2,2,2,2, # b0 - b7 -2,2,2,2,2,2,2,2, # b8 - bf -2,2,2,2,2,2,2,2, # c0 - c7 -2,2,2,2,2,2,2,2, # c8 - cf -2,2,2,2,2,2,2,2, # d0 - d7 -2,2,2,2,2,2,2,2, # d8 - df -2,2,2,2,2,2,2,2, # e0 - e7 -2,2,2,2,2,2,2,2, # e8 - ef -2,2,2,2,2,2,2,2, # f0 - f7 -2,2,2,2,2,2,2,2, # f8 - ff -) - -ISO2022KR_st = ( -eStart, 3,eError,eStart,eStart,eStart,eError,eError,# 00-07 -eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,# 08-0f -eItsMe,eItsMe,eError,eError,eError, 4,eError,eError,# 10-17 -eError,eError,eError,eError, 5,eError,eError,eError,# 18-1f -eError,eError,eError,eItsMe,eStart,eStart,eStart,eStart,# 20-27 -) - -ISO2022KRCharLenTable = (0, 0, 0, 0, 0, 0) - -ISO2022KRSMModel = {'classTable': ISO2022KR_cls, - 'classFactor': 6, - 'stateTable': ISO2022KR_st, - 'charLenTable': ISO2022KRCharLenTable, - 'name': "ISO-2022-KR"} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/eucjpprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/eucjpprober.py deleted file mode 100644 index 8e64fdcc..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/eucjpprober.py +++ /dev/null @@ -1,90 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -import sys -from . import constants -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import EUCJPDistributionAnalysis -from .jpcntx import EUCJPContextAnalysis -from .mbcssm import EUCJPSMModel - - -class EUCJPProber(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(EUCJPSMModel) - self._mDistributionAnalyzer = EUCJPDistributionAnalysis() - self._mContextAnalyzer = EUCJPContextAnalysis() - self.reset() - - def reset(self): - MultiByteCharSetProber.reset(self) - self._mContextAnalyzer.reset() - - def get_charset_name(self): - return "EUC-JP" - - def feed(self, aBuf): - aLen = len(aBuf) - for i in range(0, aLen): - # PY3K: aBuf is a byte array, so aBuf[i] is an int, not a byte - codingState = self._mCodingSM.next_state(aBuf[i]) - if codingState == constants.eError: - if constants._debug: - sys.stderr.write(self.get_charset_name() - + ' prober hit error at byte ' + str(i) - + '\n') - self._mState = constants.eNotMe - break - elif codingState == constants.eItsMe: - self._mState = constants.eFoundIt - break - elif codingState == constants.eStart: - charLen = self._mCodingSM.get_current_charlen() - if i == 0: - self._mLastChar[1] = aBuf[0] - self._mContextAnalyzer.feed(self._mLastChar, charLen) - self._mDistributionAnalyzer.feed(self._mLastChar, charLen) - else: - self._mContextAnalyzer.feed(aBuf[i - 1:i + 1], charLen) - self._mDistributionAnalyzer.feed(aBuf[i - 1:i + 1], - charLen) - - self._mLastChar[0] = aBuf[aLen - 1] - - if self.get_state() == constants.eDetecting: - if (self._mContextAnalyzer.got_enough_data() and - (self.get_confidence() > constants.SHORTCUT_THRESHOLD)): - self._mState = constants.eFoundIt - - return self.get_state() - - def get_confidence(self): - contxtCf = self._mContextAnalyzer.get_confidence() - distribCf = self._mDistributionAnalyzer.get_confidence() - return max(contxtCf, distribCf) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrfreq.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrfreq.py deleted file mode 100644 index a179e4c2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrfreq.py +++ /dev/null @@ -1,596 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# Sampling from about 20M text materials include literature and computer technology - -# 128 --> 0.79 -# 256 --> 0.92 -# 512 --> 0.986 -# 1024 --> 0.99944 -# 2048 --> 0.99999 -# -# Idea Distribution Ratio = 0.98653 / (1-0.98653) = 73.24 -# Random Distribution Ration = 512 / (2350-512) = 0.279. -# -# Typical Distribution Ratio - -EUCKR_TYPICAL_DISTRIBUTION_RATIO = 6.0 - -EUCKR_TABLE_SIZE = 2352 - -# Char to FreqOrder table , -EUCKRCharToFreqOrder = ( \ - 13, 130, 120,1396, 481,1719,1720, 328, 609, 212,1721, 707, 400, 299,1722, 87, -1397,1723, 104, 536,1117,1203,1724,1267, 685,1268, 508,1725,1726,1727,1728,1398, -1399,1729,1730,1731, 141, 621, 326,1057, 368,1732, 267, 488, 20,1733,1269,1734, - 945,1400,1735, 47, 904,1270,1736,1737, 773, 248,1738, 409, 313, 786, 429,1739, - 116, 987, 813,1401, 683, 75,1204, 145,1740,1741,1742,1743, 16, 847, 667, 622, - 708,1744,1745,1746, 966, 787, 304, 129,1747, 60, 820, 123, 676,1748,1749,1750, -1751, 617,1752, 626,1753,1754,1755,1756, 653,1757,1758,1759,1760,1761,1762, 856, - 344,1763,1764,1765,1766, 89, 401, 418, 806, 905, 848,1767,1768,1769, 946,1205, - 709,1770,1118,1771, 241,1772,1773,1774,1271,1775, 569,1776, 999,1777,1778,1779, -1780, 337, 751,1058, 28, 628, 254,1781, 177, 906, 270, 349, 891,1079,1782, 19, -1783, 379,1784, 315,1785, 629, 754,1402, 559,1786, 636, 203,1206,1787, 710, 567, -1788, 935, 814,1789,1790,1207, 766, 528,1791,1792,1208,1793,1794,1795,1796,1797, -1403,1798,1799, 533,1059,1404,1405,1156,1406, 936, 884,1080,1800, 351,1801,1802, -1803,1804,1805, 801,1806,1807,1808,1119,1809,1157, 714, 474,1407,1810, 298, 899, - 885,1811,1120, 802,1158,1812, 892,1813,1814,1408, 659,1815,1816,1121,1817,1818, -1819,1820,1821,1822, 319,1823, 594, 545,1824, 815, 937,1209,1825,1826, 573,1409, -1022,1827,1210,1828,1829,1830,1831,1832,1833, 556, 722, 807,1122,1060,1834, 697, -1835, 900, 557, 715,1836,1410, 540,1411, 752,1159, 294, 597,1211, 976, 803, 770, -1412,1837,1838, 39, 794,1413, 358,1839, 371, 925,1840, 453, 661, 788, 531, 723, - 544,1023,1081, 869, 91,1841, 392, 430, 790, 602,1414, 677,1082, 457,1415,1416, -1842,1843, 475, 327,1024,1417, 795, 121,1844, 733, 403,1418,1845,1846,1847, 300, - 119, 711,1212, 627,1848,1272, 207,1849,1850, 796,1213, 382,1851, 519,1852,1083, - 893,1853,1854,1855, 367, 809, 487, 671,1856, 663,1857,1858, 956, 471, 306, 857, -1859,1860,1160,1084,1861,1862,1863,1864,1865,1061,1866,1867,1868,1869,1870,1871, - 282, 96, 574,1872, 502,1085,1873,1214,1874, 907,1875,1876, 827, 977,1419,1420, -1421, 268,1877,1422,1878,1879,1880, 308,1881, 2, 537,1882,1883,1215,1884,1885, - 127, 791,1886,1273,1423,1887, 34, 336, 404, 643,1888, 571, 654, 894, 840,1889, - 0, 886,1274, 122, 575, 260, 908, 938,1890,1275, 410, 316,1891,1892, 100,1893, -1894,1123, 48,1161,1124,1025,1895, 633, 901,1276,1896,1897, 115, 816,1898, 317, -1899, 694,1900, 909, 734,1424, 572, 866,1425, 691, 85, 524,1010, 543, 394, 841, -1901,1902,1903,1026,1904,1905,1906,1907,1908,1909, 30, 451, 651, 988, 310,1910, -1911,1426, 810,1216, 93,1912,1913,1277,1217,1914, 858, 759, 45, 58, 181, 610, - 269,1915,1916, 131,1062, 551, 443,1000, 821,1427, 957, 895,1086,1917,1918, 375, -1919, 359,1920, 687,1921, 822,1922, 293,1923,1924, 40, 662, 118, 692, 29, 939, - 887, 640, 482, 174,1925, 69,1162, 728,1428, 910,1926,1278,1218,1279, 386, 870, - 217, 854,1163, 823,1927,1928,1929,1930, 834,1931, 78,1932, 859,1933,1063,1934, -1935,1936,1937, 438,1164, 208, 595,1938,1939,1940,1941,1219,1125,1942, 280, 888, -1429,1430,1220,1431,1943,1944,1945,1946,1947,1280, 150, 510,1432,1948,1949,1950, -1951,1952,1953,1954,1011,1087,1955,1433,1043,1956, 881,1957, 614, 958,1064,1065, -1221,1958, 638,1001, 860, 967, 896,1434, 989, 492, 553,1281,1165,1959,1282,1002, -1283,1222,1960,1961,1962,1963, 36, 383, 228, 753, 247, 454,1964, 876, 678,1965, -1966,1284, 126, 464, 490, 835, 136, 672, 529, 940,1088,1435, 473,1967,1968, 467, - 50, 390, 227, 587, 279, 378, 598, 792, 968, 240, 151, 160, 849, 882,1126,1285, - 639,1044, 133, 140, 288, 360, 811, 563,1027, 561, 142, 523,1969,1970,1971, 7, - 103, 296, 439, 407, 506, 634, 990,1972,1973,1974,1975, 645,1976,1977,1978,1979, -1980,1981, 236,1982,1436,1983,1984,1089, 192, 828, 618, 518,1166, 333,1127,1985, - 818,1223,1986,1987,1988,1989,1990,1991,1992,1993, 342,1128,1286, 746, 842,1994, -1995, 560, 223,1287, 98, 8, 189, 650, 978,1288,1996,1437,1997, 17, 345, 250, - 423, 277, 234, 512, 226, 97, 289, 42, 167,1998, 201,1999,2000, 843, 836, 824, - 532, 338, 783,1090, 182, 576, 436,1438,1439, 527, 500,2001, 947, 889,2002,2003, -2004,2005, 262, 600, 314, 447,2006, 547,2007, 693, 738,1129,2008, 71,1440, 745, - 619, 688,2009, 829,2010,2011, 147,2012, 33, 948,2013,2014, 74, 224,2015, 61, - 191, 918, 399, 637,2016,1028,1130, 257, 902,2017,2018,2019,2020,2021,2022,2023, -2024,2025,2026, 837,2027,2028,2029,2030, 179, 874, 591, 52, 724, 246,2031,2032, -2033,2034,1167, 969,2035,1289, 630, 605, 911,1091,1168,2036,2037,2038,1441, 912, -2039, 623,2040,2041, 253,1169,1290,2042,1442, 146, 620, 611, 577, 433,2043,1224, - 719,1170, 959, 440, 437, 534, 84, 388, 480,1131, 159, 220, 198, 679,2044,1012, - 819,1066,1443, 113,1225, 194, 318,1003,1029,2045,2046,2047,2048,1067,2049,2050, -2051,2052,2053, 59, 913, 112,2054, 632,2055, 455, 144, 739,1291,2056, 273, 681, - 499,2057, 448,2058,2059, 760,2060,2061, 970, 384, 169, 245,1132,2062,2063, 414, -1444,2064,2065, 41, 235,2066, 157, 252, 877, 568, 919, 789, 580,2067, 725,2068, -2069,1292,2070,2071,1445,2072,1446,2073,2074, 55, 588, 66,1447, 271,1092,2075, -1226,2076, 960,1013, 372,2077,2078,2079,2080,2081,1293,2082,2083,2084,2085, 850, -2086,2087,2088,2089,2090, 186,2091,1068, 180,2092,2093,2094, 109,1227, 522, 606, -2095, 867,1448,1093, 991,1171, 926, 353,1133,2096, 581,2097,2098,2099,1294,1449, -1450,2100, 596,1172,1014,1228,2101,1451,1295,1173,1229,2102,2103,1296,1134,1452, - 949,1135,2104,2105,1094,1453,1454,1455,2106,1095,2107,2108,2109,2110,2111,2112, -2113,2114,2115,2116,2117, 804,2118,2119,1230,1231, 805,1456, 405,1136,2120,2121, -2122,2123,2124, 720, 701,1297, 992,1457, 927,1004,2125,2126,2127,2128,2129,2130, - 22, 417,2131, 303,2132, 385,2133, 971, 520, 513,2134,1174, 73,1096, 231, 274, - 962,1458, 673,2135,1459,2136, 152,1137,2137,2138,2139,2140,1005,1138,1460,1139, -2141,2142,2143,2144, 11, 374, 844,2145, 154,1232, 46,1461,2146, 838, 830, 721, -1233, 106,2147, 90, 428, 462, 578, 566,1175, 352,2148,2149, 538,1234, 124,1298, -2150,1462, 761, 565,2151, 686,2152, 649,2153, 72, 173,2154, 460, 415,2155,1463, -2156,1235, 305,2157,2158,2159,2160,2161,2162, 579,2163,2164,2165,2166,2167, 747, -2168,2169,2170,2171,1464, 669,2172,2173,2174,2175,2176,1465,2177, 23, 530, 285, -2178, 335, 729,2179, 397,2180,2181,2182,1030,2183,2184, 698,2185,2186, 325,2187, -2188, 369,2189, 799,1097,1015, 348,2190,1069, 680,2191, 851,1466,2192,2193, 10, -2194, 613, 424,2195, 979, 108, 449, 589, 27, 172, 81,1031, 80, 774, 281, 350, -1032, 525, 301, 582,1176,2196, 674,1045,2197,2198,1467, 730, 762,2199,2200,2201, -2202,1468,2203, 993,2204,2205, 266,1070, 963,1140,2206,2207,2208, 664,1098, 972, -2209,2210,2211,1177,1469,1470, 871,2212,2213,2214,2215,2216,1471,2217,2218,2219, -2220,2221,2222,2223,2224,2225,2226,2227,1472,1236,2228,2229,2230,2231,2232,2233, -2234,2235,1299,2236,2237, 200,2238, 477, 373,2239,2240, 731, 825, 777,2241,2242, -2243, 521, 486, 548,2244,2245,2246,1473,1300, 53, 549, 137, 875, 76, 158,2247, -1301,1474, 469, 396,1016, 278, 712,2248, 321, 442, 503, 767, 744, 941,1237,1178, -1475,2249, 82, 178,1141,1179, 973,2250,1302,2251, 297,2252,2253, 570,2254,2255, -2256, 18, 450, 206,2257, 290, 292,1142,2258, 511, 162, 99, 346, 164, 735,2259, -1476,1477, 4, 554, 343, 798,1099,2260,1100,2261, 43, 171,1303, 139, 215,2262, -2263, 717, 775,2264,1033, 322, 216,2265, 831,2266, 149,2267,1304,2268,2269, 702, -1238, 135, 845, 347, 309,2270, 484,2271, 878, 655, 238,1006,1478,2272, 67,2273, - 295,2274,2275, 461,2276, 478, 942, 412,2277,1034,2278,2279,2280, 265,2281, 541, -2282,2283,2284,2285,2286, 70, 852,1071,2287,2288,2289,2290, 21, 56, 509, 117, - 432,2291,2292, 331, 980, 552,1101, 148, 284, 105, 393,1180,1239, 755,2293, 187, -2294,1046,1479,2295, 340,2296, 63,1047, 230,2297,2298,1305, 763,1306, 101, 800, - 808, 494,2299,2300,2301, 903,2302, 37,1072, 14, 5,2303, 79, 675,2304, 312, -2305,2306,2307,2308,2309,1480, 6,1307,2310,2311,2312, 1, 470, 35, 24, 229, -2313, 695, 210, 86, 778, 15, 784, 592, 779, 32, 77, 855, 964,2314, 259,2315, - 501, 380,2316,2317, 83, 981, 153, 689,1308,1481,1482,1483,2318,2319, 716,1484, -2320,2321,2322,2323,2324,2325,1485,2326,2327, 128, 57, 68, 261,1048, 211, 170, -1240, 31,2328, 51, 435, 742,2329,2330,2331, 635,2332, 264, 456,2333,2334,2335, - 425,2336,1486, 143, 507, 263, 943,2337, 363, 920,1487, 256,1488,1102, 243, 601, -1489,2338,2339,2340,2341,2342,2343,2344, 861,2345,2346,2347,2348,2349,2350, 395, -2351,1490,1491, 62, 535, 166, 225,2352,2353, 668, 419,1241, 138, 604, 928,2354, -1181,2355,1492,1493,2356,2357,2358,1143,2359, 696,2360, 387, 307,1309, 682, 476, -2361,2362, 332, 12, 222, 156,2363, 232,2364, 641, 276, 656, 517,1494,1495,1035, - 416, 736,1496,2365,1017, 586,2366,2367,2368,1497,2369, 242,2370,2371,2372,1498, -2373, 965, 713,2374,2375,2376,2377, 740, 982,1499, 944,1500,1007,2378,2379,1310, -1501,2380,2381,2382, 785, 329,2383,2384,1502,2385,2386,2387, 932,2388,1503,2389, -2390,2391,2392,1242,2393,2394,2395,2396,2397, 994, 950,2398,2399,2400,2401,1504, -1311,2402,2403,2404,2405,1049, 749,2406,2407, 853, 718,1144,1312,2408,1182,1505, -2409,2410, 255, 516, 479, 564, 550, 214,1506,1507,1313, 413, 239, 444, 339,1145, -1036,1508,1509,1314,1037,1510,1315,2411,1511,2412,2413,2414, 176, 703, 497, 624, - 593, 921, 302,2415, 341, 165,1103,1512,2416,1513,2417,2418,2419, 376,2420, 700, -2421,2422,2423, 258, 768,1316,2424,1183,2425, 995, 608,2426,2427,2428,2429, 221, -2430,2431,2432,2433,2434,2435,2436,2437, 195, 323, 726, 188, 897, 983,1317, 377, - 644,1050, 879,2438, 452,2439,2440,2441,2442,2443,2444, 914,2445,2446,2447,2448, - 915, 489,2449,1514,1184,2450,2451, 515, 64, 427, 495,2452, 583,2453, 483, 485, -1038, 562, 213,1515, 748, 666,2454,2455,2456,2457, 334,2458, 780, 996,1008, 705, -1243,2459,2460,2461,2462,2463, 114,2464, 493,1146, 366, 163,1516, 961,1104,2465, - 291,2466,1318,1105,2467,1517, 365,2468, 355, 951,1244,2469,1319,2470, 631,2471, -2472, 218,1320, 364, 320, 756,1518,1519,1321,1520,1322,2473,2474,2475,2476, 997, -2477,2478,2479,2480, 665,1185,2481, 916,1521,2482,2483,2484, 584, 684,2485,2486, - 797,2487,1051,1186,2488,2489,2490,1522,2491,2492, 370,2493,1039,1187, 65,2494, - 434, 205, 463,1188,2495, 125, 812, 391, 402, 826, 699, 286, 398, 155, 781, 771, - 585,2496, 590, 505,1073,2497, 599, 244, 219, 917,1018, 952, 646,1523,2498,1323, -2499,2500, 49, 984, 354, 741,2501, 625,2502,1324,2503,1019, 190, 357, 757, 491, - 95, 782, 868,2504,2505,2506,2507,2508,2509, 134,1524,1074, 422,1525, 898,2510, - 161,2511,2512,2513,2514, 769,2515,1526,2516,2517, 411,1325,2518, 472,1527,2519, -2520,2521,2522,2523,2524, 985,2525,2526,2527,2528,2529,2530, 764,2531,1245,2532, -2533, 25, 204, 311,2534, 496,2535,1052,2536,2537,2538,2539,2540,2541,2542, 199, - 704, 504, 468, 758, 657,1528, 196, 44, 839,1246, 272, 750,2543, 765, 862,2544, -2545,1326,2546, 132, 615, 933,2547, 732,2548,2549,2550,1189,1529,2551, 283,1247, -1053, 607, 929,2552,2553,2554, 930, 183, 872, 616,1040,1147,2555,1148,1020, 441, - 249,1075,2556,2557,2558, 466, 743,2559,2560,2561, 92, 514, 426, 420, 526,2562, -2563,2564,2565,2566,2567,2568, 185,2569,2570,2571,2572, 776,1530, 658,2573, 362, -2574, 361, 922,1076, 793,2575,2576,2577,2578,2579,2580,1531, 251,2581,2582,2583, -2584,1532, 54, 612, 237,1327,2585,2586, 275, 408, 647, 111,2587,1533,1106, 465, - 3, 458, 9, 38,2588, 107, 110, 890, 209, 26, 737, 498,2589,1534,2590, 431, - 202, 88,1535, 356, 287,1107, 660,1149,2591, 381,1536, 986,1150, 445,1248,1151, - 974,2592,2593, 846,2594, 446, 953, 184,1249,1250, 727,2595, 923, 193, 883,2596, -2597,2598, 102, 324, 539, 817,2599, 421,1041,2600, 832,2601, 94, 175, 197, 406, -2602, 459,2603,2604,2605,2606,2607, 330, 555,2608,2609,2610, 706,1108, 389,2611, -2612,2613,2614, 233,2615, 833, 558, 931, 954,1251,2616,2617,1537, 546,2618,2619, -1009,2620,2621,2622,1538, 690,1328,2623, 955,2624,1539,2625,2626, 772,2627,2628, -2629,2630,2631, 924, 648, 863, 603,2632,2633, 934,1540, 864, 865,2634, 642,1042, - 670,1190,2635,2636,2637,2638, 168,2639, 652, 873, 542,1054,1541,2640,2641,2642, # 512, 256 -#Everything below is of no interest for detection purpose -2643,2644,2645,2646,2647,2648,2649,2650,2651,2652,2653,2654,2655,2656,2657,2658, -2659,2660,2661,2662,2663,2664,2665,2666,2667,2668,2669,2670,2671,2672,2673,2674, -2675,2676,2677,2678,2679,2680,2681,2682,2683,2684,2685,2686,2687,2688,2689,2690, -2691,2692,2693,2694,2695,2696,2697,2698,2699,1542, 880,2700,2701,2702,2703,2704, -2705,2706,2707,2708,2709,2710,2711,2712,2713,2714,2715,2716,2717,2718,2719,2720, -2721,2722,2723,2724,2725,1543,2726,2727,2728,2729,2730,2731,2732,1544,2733,2734, -2735,2736,2737,2738,2739,2740,2741,2742,2743,2744,2745,2746,2747,2748,2749,2750, -2751,2752,2753,2754,1545,2755,2756,2757,2758,2759,2760,2761,2762,2763,2764,2765, -2766,1546,2767,1547,2768,2769,2770,2771,2772,2773,2774,2775,2776,2777,2778,2779, -2780,2781,2782,2783,2784,2785,2786,1548,2787,2788,2789,1109,2790,2791,2792,2793, -2794,2795,2796,2797,2798,2799,2800,2801,2802,2803,2804,2805,2806,2807,2808,2809, -2810,2811,2812,1329,2813,2814,2815,2816,2817,2818,2819,2820,2821,2822,2823,2824, -2825,2826,2827,2828,2829,2830,2831,2832,2833,2834,2835,2836,2837,2838,2839,2840, -2841,2842,2843,2844,2845,2846,2847,2848,2849,2850,2851,2852,2853,2854,2855,2856, -1549,2857,2858,2859,2860,1550,2861,2862,1551,2863,2864,2865,2866,2867,2868,2869, -2870,2871,2872,2873,2874,1110,1330,2875,2876,2877,2878,2879,2880,2881,2882,2883, -2884,2885,2886,2887,2888,2889,2890,2891,2892,2893,2894,2895,2896,2897,2898,2899, -2900,2901,2902,2903,2904,2905,2906,2907,2908,2909,2910,2911,2912,2913,2914,2915, -2916,2917,2918,2919,2920,2921,2922,2923,2924,2925,2926,2927,2928,2929,2930,1331, -2931,2932,2933,2934,2935,2936,2937,2938,2939,2940,2941,2942,2943,1552,2944,2945, -2946,2947,2948,2949,2950,2951,2952,2953,2954,2955,2956,2957,2958,2959,2960,2961, -2962,2963,2964,1252,2965,2966,2967,2968,2969,2970,2971,2972,2973,2974,2975,2976, -2977,2978,2979,2980,2981,2982,2983,2984,2985,2986,2987,2988,2989,2990,2991,2992, -2993,2994,2995,2996,2997,2998,2999,3000,3001,3002,3003,3004,3005,3006,3007,3008, -3009,3010,3011,3012,1553,3013,3014,3015,3016,3017,1554,3018,1332,3019,3020,3021, -3022,3023,3024,3025,3026,3027,3028,3029,3030,3031,3032,3033,3034,3035,3036,3037, -3038,3039,3040,3041,3042,3043,3044,3045,3046,3047,3048,3049,3050,1555,3051,3052, -3053,1556,1557,3054,3055,3056,3057,3058,3059,3060,3061,3062,3063,3064,3065,3066, -3067,1558,3068,3069,3070,3071,3072,3073,3074,3075,3076,1559,3077,3078,3079,3080, -3081,3082,3083,1253,3084,3085,3086,3087,3088,3089,3090,3091,3092,3093,3094,3095, -3096,3097,3098,3099,3100,3101,3102,3103,3104,3105,3106,3107,3108,1152,3109,3110, -3111,3112,3113,1560,3114,3115,3116,3117,1111,3118,3119,3120,3121,3122,3123,3124, -3125,3126,3127,3128,3129,3130,3131,3132,3133,3134,3135,3136,3137,3138,3139,3140, -3141,3142,3143,3144,3145,3146,3147,3148,3149,3150,3151,3152,3153,3154,3155,3156, -3157,3158,3159,3160,3161,3162,3163,3164,3165,3166,3167,3168,3169,3170,3171,3172, -3173,3174,3175,3176,1333,3177,3178,3179,3180,3181,3182,3183,3184,3185,3186,3187, -3188,3189,1561,3190,3191,1334,3192,3193,3194,3195,3196,3197,3198,3199,3200,3201, -3202,3203,3204,3205,3206,3207,3208,3209,3210,3211,3212,3213,3214,3215,3216,3217, -3218,3219,3220,3221,3222,3223,3224,3225,3226,3227,3228,3229,3230,3231,3232,3233, -3234,1562,3235,3236,3237,3238,3239,3240,3241,3242,3243,3244,3245,3246,3247,3248, -3249,3250,3251,3252,3253,3254,3255,3256,3257,3258,3259,3260,3261,3262,3263,3264, -3265,3266,3267,3268,3269,3270,3271,3272,3273,3274,3275,3276,3277,1563,3278,3279, -3280,3281,3282,3283,3284,3285,3286,3287,3288,3289,3290,3291,3292,3293,3294,3295, -3296,3297,3298,3299,3300,3301,3302,3303,3304,3305,3306,3307,3308,3309,3310,3311, -3312,3313,3314,3315,3316,3317,3318,3319,3320,3321,3322,3323,3324,3325,3326,3327, -3328,3329,3330,3331,3332,3333,3334,3335,3336,3337,3338,3339,3340,3341,3342,3343, -3344,3345,3346,3347,3348,3349,3350,3351,3352,3353,3354,3355,3356,3357,3358,3359, -3360,3361,3362,3363,3364,1335,3365,3366,3367,3368,3369,3370,3371,3372,3373,3374, -3375,3376,3377,3378,3379,3380,3381,3382,3383,3384,3385,3386,3387,1336,3388,3389, -3390,3391,3392,3393,3394,3395,3396,3397,3398,3399,3400,3401,3402,3403,3404,3405, -3406,3407,3408,3409,3410,3411,3412,3413,3414,1337,3415,3416,3417,3418,3419,1338, -3420,3421,3422,1564,1565,3423,3424,3425,3426,3427,3428,3429,3430,3431,1254,3432, -3433,3434,1339,3435,3436,3437,3438,3439,1566,3440,3441,3442,3443,3444,3445,3446, -3447,3448,3449,3450,3451,3452,3453,3454,1255,3455,3456,3457,3458,3459,1567,1191, -3460,1568,1569,3461,3462,3463,1570,3464,3465,3466,3467,3468,1571,3469,3470,3471, -3472,3473,1572,3474,3475,3476,3477,3478,3479,3480,3481,3482,3483,3484,3485,3486, -1340,3487,3488,3489,3490,3491,3492,1021,3493,3494,3495,3496,3497,3498,1573,3499, -1341,3500,3501,3502,3503,3504,3505,3506,3507,3508,3509,3510,3511,1342,3512,3513, -3514,3515,3516,1574,1343,3517,3518,3519,1575,3520,1576,3521,3522,3523,3524,3525, -3526,3527,3528,3529,3530,3531,3532,3533,3534,3535,3536,3537,3538,3539,3540,3541, -3542,3543,3544,3545,3546,3547,3548,3549,3550,3551,3552,3553,3554,3555,3556,3557, -3558,3559,3560,3561,3562,3563,3564,3565,3566,3567,3568,3569,3570,3571,3572,3573, -3574,3575,3576,3577,3578,3579,3580,1577,3581,3582,1578,3583,3584,3585,3586,3587, -3588,3589,3590,3591,3592,3593,3594,3595,3596,3597,3598,3599,3600,3601,3602,3603, -3604,1579,3605,3606,3607,3608,3609,3610,3611,3612,3613,3614,3615,3616,3617,3618, -3619,3620,3621,3622,3623,3624,3625,3626,3627,3628,3629,1580,3630,3631,1581,3632, -3633,3634,3635,3636,3637,3638,3639,3640,3641,3642,3643,3644,3645,3646,3647,3648, -3649,3650,3651,3652,3653,3654,3655,3656,1582,3657,3658,3659,3660,3661,3662,3663, -3664,3665,3666,3667,3668,3669,3670,3671,3672,3673,3674,3675,3676,3677,3678,3679, -3680,3681,3682,3683,3684,3685,3686,3687,3688,3689,3690,3691,3692,3693,3694,3695, -3696,3697,3698,3699,3700,1192,3701,3702,3703,3704,1256,3705,3706,3707,3708,1583, -1257,3709,3710,3711,3712,3713,3714,3715,3716,1584,3717,3718,3719,3720,3721,3722, -3723,3724,3725,3726,3727,3728,3729,3730,3731,3732,3733,3734,3735,3736,3737,3738, -3739,3740,3741,3742,3743,3744,3745,1344,3746,3747,3748,3749,3750,3751,3752,3753, -3754,3755,3756,1585,3757,3758,3759,3760,3761,3762,3763,3764,3765,3766,1586,3767, -3768,3769,3770,3771,3772,3773,3774,3775,3776,3777,3778,1345,3779,3780,3781,3782, -3783,3784,3785,3786,3787,3788,3789,3790,3791,3792,3793,3794,3795,1346,1587,3796, -3797,1588,3798,3799,3800,3801,3802,3803,3804,3805,3806,1347,3807,3808,3809,3810, -3811,1589,3812,3813,3814,3815,3816,3817,3818,3819,3820,3821,1590,3822,3823,1591, -1348,3824,3825,3826,3827,3828,3829,3830,1592,3831,3832,1593,3833,3834,3835,3836, -3837,3838,3839,3840,3841,3842,3843,3844,1349,3845,3846,3847,3848,3849,3850,3851, -3852,3853,3854,3855,3856,3857,3858,1594,3859,3860,3861,3862,3863,3864,3865,3866, -3867,3868,3869,1595,3870,3871,3872,3873,1596,3874,3875,3876,3877,3878,3879,3880, -3881,3882,3883,3884,3885,3886,1597,3887,3888,3889,3890,3891,3892,3893,3894,3895, -1598,3896,3897,3898,1599,1600,3899,1350,3900,1351,3901,3902,1352,3903,3904,3905, -3906,3907,3908,3909,3910,3911,3912,3913,3914,3915,3916,3917,3918,3919,3920,3921, -3922,3923,3924,1258,3925,3926,3927,3928,3929,3930,3931,1193,3932,1601,3933,3934, -3935,3936,3937,3938,3939,3940,3941,3942,3943,1602,3944,3945,3946,3947,3948,1603, -3949,3950,3951,3952,3953,3954,3955,3956,3957,3958,3959,3960,3961,3962,3963,3964, -3965,1604,3966,3967,3968,3969,3970,3971,3972,3973,3974,3975,3976,3977,1353,3978, -3979,3980,3981,3982,3983,3984,3985,3986,3987,3988,3989,3990,3991,1354,3992,3993, -3994,3995,3996,3997,3998,3999,4000,4001,4002,4003,4004,4005,4006,4007,4008,4009, -4010,4011,4012,4013,4014,4015,4016,4017,4018,4019,4020,4021,4022,4023,1355,4024, -4025,4026,4027,4028,4029,4030,4031,4032,4033,4034,4035,4036,4037,4038,4039,4040, -1605,4041,4042,4043,4044,4045,4046,4047,4048,4049,4050,4051,4052,4053,4054,4055, -4056,4057,4058,4059,4060,1606,4061,4062,4063,4064,1607,4065,4066,4067,4068,4069, -4070,4071,4072,4073,4074,4075,4076,1194,4077,4078,1608,4079,4080,4081,4082,4083, -4084,4085,4086,4087,1609,4088,4089,4090,4091,4092,4093,4094,4095,4096,4097,4098, -4099,4100,4101,4102,4103,4104,4105,4106,4107,4108,1259,4109,4110,4111,4112,4113, -4114,4115,4116,4117,4118,4119,4120,4121,4122,4123,4124,1195,4125,4126,4127,1610, -4128,4129,4130,4131,4132,4133,4134,4135,4136,4137,1356,4138,4139,4140,4141,4142, -4143,4144,1611,4145,4146,4147,4148,4149,4150,4151,4152,4153,4154,4155,4156,4157, -4158,4159,4160,4161,4162,4163,4164,4165,4166,4167,4168,4169,4170,4171,4172,4173, -4174,4175,4176,4177,4178,4179,4180,4181,4182,4183,4184,4185,4186,4187,4188,4189, -4190,4191,4192,4193,4194,4195,4196,4197,4198,4199,4200,4201,4202,4203,4204,4205, -4206,4207,4208,4209,4210,4211,4212,4213,4214,4215,4216,4217,4218,4219,1612,4220, -4221,4222,4223,4224,4225,4226,4227,1357,4228,1613,4229,4230,4231,4232,4233,4234, -4235,4236,4237,4238,4239,4240,4241,4242,4243,1614,4244,4245,4246,4247,4248,4249, -4250,4251,4252,4253,4254,4255,4256,4257,4258,4259,4260,4261,4262,4263,4264,4265, -4266,4267,4268,4269,4270,1196,1358,4271,4272,4273,4274,4275,4276,4277,4278,4279, -4280,4281,4282,4283,4284,4285,4286,4287,1615,4288,4289,4290,4291,4292,4293,4294, -4295,4296,4297,4298,4299,4300,4301,4302,4303,4304,4305,4306,4307,4308,4309,4310, -4311,4312,4313,4314,4315,4316,4317,4318,4319,4320,4321,4322,4323,4324,4325,4326, -4327,4328,4329,4330,4331,4332,4333,4334,1616,4335,4336,4337,4338,4339,4340,4341, -4342,4343,4344,4345,4346,4347,4348,4349,4350,4351,4352,4353,4354,4355,4356,4357, -4358,4359,4360,1617,4361,4362,4363,4364,4365,1618,4366,4367,4368,4369,4370,4371, -4372,4373,4374,4375,4376,4377,4378,4379,4380,4381,4382,4383,4384,4385,4386,4387, -4388,4389,4390,4391,4392,4393,4394,4395,4396,4397,4398,4399,4400,4401,4402,4403, -4404,4405,4406,4407,4408,4409,4410,4411,4412,4413,4414,4415,4416,1619,4417,4418, -4419,4420,4421,4422,4423,4424,4425,1112,4426,4427,4428,4429,4430,1620,4431,4432, -4433,4434,4435,4436,4437,4438,4439,4440,4441,4442,1260,1261,4443,4444,4445,4446, -4447,4448,4449,4450,4451,4452,4453,4454,4455,1359,4456,4457,4458,4459,4460,4461, -4462,4463,4464,4465,1621,4466,4467,4468,4469,4470,4471,4472,4473,4474,4475,4476, -4477,4478,4479,4480,4481,4482,4483,4484,4485,4486,4487,4488,4489,1055,4490,4491, -4492,4493,4494,4495,4496,4497,4498,4499,4500,4501,4502,4503,4504,4505,4506,4507, -4508,4509,4510,4511,4512,4513,4514,4515,4516,4517,4518,1622,4519,4520,4521,1623, -4522,4523,4524,4525,4526,4527,4528,4529,4530,4531,4532,4533,4534,4535,1360,4536, -4537,4538,4539,4540,4541,4542,4543, 975,4544,4545,4546,4547,4548,4549,4550,4551, -4552,4553,4554,4555,4556,4557,4558,4559,4560,4561,4562,4563,4564,4565,4566,4567, -4568,4569,4570,4571,1624,4572,4573,4574,4575,4576,1625,4577,4578,4579,4580,4581, -4582,4583,4584,1626,4585,4586,4587,4588,4589,4590,4591,4592,4593,4594,4595,1627, -4596,4597,4598,4599,4600,4601,4602,4603,4604,4605,4606,4607,4608,4609,4610,4611, -4612,4613,4614,4615,1628,4616,4617,4618,4619,4620,4621,4622,4623,4624,4625,4626, -4627,4628,4629,4630,4631,4632,4633,4634,4635,4636,4637,4638,4639,4640,4641,4642, -4643,4644,4645,4646,4647,4648,4649,1361,4650,4651,4652,4653,4654,4655,4656,4657, -4658,4659,4660,4661,1362,4662,4663,4664,4665,4666,4667,4668,4669,4670,4671,4672, -4673,4674,4675,4676,4677,4678,4679,4680,4681,4682,1629,4683,4684,4685,4686,4687, -1630,4688,4689,4690,4691,1153,4692,4693,4694,1113,4695,4696,4697,4698,4699,4700, -4701,4702,4703,4704,4705,4706,4707,4708,4709,4710,4711,1197,4712,4713,4714,4715, -4716,4717,4718,4719,4720,4721,4722,4723,4724,4725,4726,4727,4728,4729,4730,4731, -4732,4733,4734,4735,1631,4736,1632,4737,4738,4739,4740,4741,4742,4743,4744,1633, -4745,4746,4747,4748,4749,1262,4750,4751,4752,4753,4754,1363,4755,4756,4757,4758, -4759,4760,4761,4762,4763,4764,4765,4766,4767,4768,1634,4769,4770,4771,4772,4773, -4774,4775,4776,4777,4778,1635,4779,4780,4781,4782,4783,4784,4785,4786,4787,4788, -4789,1636,4790,4791,4792,4793,4794,4795,4796,4797,4798,4799,4800,4801,4802,4803, -4804,4805,4806,1637,4807,4808,4809,1638,4810,4811,4812,4813,4814,4815,4816,4817, -4818,1639,4819,4820,4821,4822,4823,4824,4825,4826,4827,4828,4829,4830,4831,4832, -4833,1077,4834,4835,4836,4837,4838,4839,4840,4841,4842,4843,4844,4845,4846,4847, -4848,4849,4850,4851,4852,4853,4854,4855,4856,4857,4858,4859,4860,4861,4862,4863, -4864,4865,4866,4867,4868,4869,4870,4871,4872,4873,4874,4875,4876,4877,4878,4879, -4880,4881,4882,4883,1640,4884,4885,1641,4886,4887,4888,4889,4890,4891,4892,4893, -4894,4895,4896,4897,4898,4899,4900,4901,4902,4903,4904,4905,4906,4907,4908,4909, -4910,4911,1642,4912,4913,4914,1364,4915,4916,4917,4918,4919,4920,4921,4922,4923, -4924,4925,4926,4927,4928,4929,4930,4931,1643,4932,4933,4934,4935,4936,4937,4938, -4939,4940,4941,4942,4943,4944,4945,4946,4947,4948,4949,4950,4951,4952,4953,4954, -4955,4956,4957,4958,4959,4960,4961,4962,4963,4964,4965,4966,4967,4968,4969,4970, -4971,4972,4973,4974,4975,4976,4977,4978,4979,4980,1644,4981,4982,4983,4984,1645, -4985,4986,1646,4987,4988,4989,4990,4991,4992,4993,4994,4995,4996,4997,4998,4999, -5000,5001,5002,5003,5004,5005,1647,5006,1648,5007,5008,5009,5010,5011,5012,1078, -5013,5014,5015,5016,5017,5018,5019,5020,5021,5022,5023,5024,5025,5026,5027,5028, -1365,5029,5030,5031,5032,5033,5034,5035,5036,5037,5038,5039,1649,5040,5041,5042, -5043,5044,5045,1366,5046,5047,5048,5049,5050,5051,5052,5053,5054,5055,1650,5056, -5057,5058,5059,5060,5061,5062,5063,5064,5065,5066,5067,5068,5069,5070,5071,5072, -5073,5074,5075,5076,5077,1651,5078,5079,5080,5081,5082,5083,5084,5085,5086,5087, -5088,5089,5090,5091,5092,5093,5094,5095,5096,5097,5098,5099,5100,5101,5102,5103, -5104,5105,5106,5107,5108,5109,5110,1652,5111,5112,5113,5114,5115,5116,5117,5118, -1367,5119,5120,5121,5122,5123,5124,5125,5126,5127,5128,5129,1653,5130,5131,5132, -5133,5134,5135,5136,5137,5138,5139,5140,5141,5142,5143,5144,5145,5146,5147,5148, -5149,1368,5150,1654,5151,1369,5152,5153,5154,5155,5156,5157,5158,5159,5160,5161, -5162,5163,5164,5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,5176,5177, -5178,1370,5179,5180,5181,5182,5183,5184,5185,5186,5187,5188,5189,5190,5191,5192, -5193,5194,5195,5196,5197,5198,1655,5199,5200,5201,5202,1656,5203,5204,5205,5206, -1371,5207,1372,5208,5209,5210,5211,1373,5212,5213,1374,5214,5215,5216,5217,5218, -5219,5220,5221,5222,5223,5224,5225,5226,5227,5228,5229,5230,5231,5232,5233,5234, -5235,5236,5237,5238,5239,5240,5241,5242,5243,5244,5245,5246,5247,1657,5248,5249, -5250,5251,1658,1263,5252,5253,5254,5255,5256,1375,5257,5258,5259,5260,5261,5262, -5263,5264,5265,5266,5267,5268,5269,5270,5271,5272,5273,5274,5275,5276,5277,5278, -5279,5280,5281,5282,5283,1659,5284,5285,5286,5287,5288,5289,5290,5291,5292,5293, -5294,5295,5296,5297,5298,5299,5300,1660,5301,5302,5303,5304,5305,5306,5307,5308, -5309,5310,5311,5312,5313,5314,5315,5316,5317,5318,5319,5320,5321,1376,5322,5323, -5324,5325,5326,5327,5328,5329,5330,5331,5332,5333,1198,5334,5335,5336,5337,5338, -5339,5340,5341,5342,5343,1661,5344,5345,5346,5347,5348,5349,5350,5351,5352,5353, -5354,5355,5356,5357,5358,5359,5360,5361,5362,5363,5364,5365,5366,5367,5368,5369, -5370,5371,5372,5373,5374,5375,5376,5377,5378,5379,5380,5381,5382,5383,5384,5385, -5386,5387,5388,5389,5390,5391,5392,5393,5394,5395,5396,5397,5398,1264,5399,5400, -5401,5402,5403,5404,5405,5406,5407,5408,5409,5410,5411,5412,1662,5413,5414,5415, -5416,1663,5417,5418,5419,5420,5421,5422,5423,5424,5425,5426,5427,5428,5429,5430, -5431,5432,5433,5434,5435,5436,5437,5438,1664,5439,5440,5441,5442,5443,5444,5445, -5446,5447,5448,5449,5450,5451,5452,5453,5454,5455,5456,5457,5458,5459,5460,5461, -5462,5463,5464,5465,5466,5467,5468,5469,5470,5471,5472,5473,5474,5475,5476,5477, -5478,1154,5479,5480,5481,5482,5483,5484,5485,1665,5486,5487,5488,5489,5490,5491, -5492,5493,5494,5495,5496,5497,5498,5499,5500,5501,5502,5503,5504,5505,5506,5507, -5508,5509,5510,5511,5512,5513,5514,5515,5516,5517,5518,5519,5520,5521,5522,5523, -5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536,5537,5538,5539, -5540,5541,5542,5543,5544,5545,5546,5547,5548,1377,5549,5550,5551,5552,5553,5554, -5555,5556,5557,5558,5559,5560,5561,5562,5563,5564,5565,5566,5567,5568,5569,5570, -1114,5571,5572,5573,5574,5575,5576,5577,5578,5579,5580,5581,5582,5583,5584,5585, -5586,5587,5588,5589,5590,5591,5592,1378,5593,5594,5595,5596,5597,5598,5599,5600, -5601,5602,5603,5604,5605,5606,5607,5608,5609,5610,5611,5612,5613,5614,1379,5615, -5616,5617,5618,5619,5620,5621,5622,5623,5624,5625,5626,5627,5628,5629,5630,5631, -5632,5633,5634,1380,5635,5636,5637,5638,5639,5640,5641,5642,5643,5644,5645,5646, -5647,5648,5649,1381,1056,5650,5651,5652,5653,5654,5655,5656,5657,5658,5659,5660, -1666,5661,5662,5663,5664,5665,5666,5667,5668,1667,5669,1668,5670,5671,5672,5673, -5674,5675,5676,5677,5678,1155,5679,5680,5681,5682,5683,5684,5685,5686,5687,5688, -5689,5690,5691,5692,5693,5694,5695,5696,5697,5698,1669,5699,5700,5701,5702,5703, -5704,5705,1670,5706,5707,5708,5709,5710,1671,5711,5712,5713,5714,1382,5715,5716, -5717,5718,5719,5720,5721,5722,5723,5724,5725,1672,5726,5727,1673,1674,5728,5729, -5730,5731,5732,5733,5734,5735,5736,1675,5737,5738,5739,5740,5741,5742,5743,5744, -1676,5745,5746,5747,5748,5749,5750,5751,1383,5752,5753,5754,5755,5756,5757,5758, -5759,5760,5761,5762,5763,5764,5765,5766,5767,5768,1677,5769,5770,5771,5772,5773, -1678,5774,5775,5776, 998,5777,5778,5779,5780,5781,5782,5783,5784,5785,1384,5786, -5787,5788,5789,5790,5791,5792,5793,5794,5795,5796,5797,5798,5799,5800,1679,5801, -5802,5803,1115,1116,5804,5805,5806,5807,5808,5809,5810,5811,5812,5813,5814,5815, -5816,5817,5818,5819,5820,5821,5822,5823,5824,5825,5826,5827,5828,5829,5830,5831, -5832,5833,5834,5835,5836,5837,5838,5839,5840,5841,5842,5843,5844,5845,5846,5847, -5848,5849,5850,5851,5852,5853,5854,5855,1680,5856,5857,5858,5859,5860,5861,5862, -5863,5864,1681,5865,5866,5867,1682,5868,5869,5870,5871,5872,5873,5874,5875,5876, -5877,5878,5879,1683,5880,1684,5881,5882,5883,5884,1685,5885,5886,5887,5888,5889, -5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904,5905, -5906,5907,1686,5908,5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920, -5921,5922,5923,5924,5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,1687, -5936,5937,5938,5939,5940,5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951, -5952,1688,1689,5953,1199,5954,5955,5956,5957,5958,5959,5960,5961,1690,5962,5963, -5964,5965,5966,5967,5968,5969,5970,5971,5972,5973,5974,5975,5976,5977,5978,5979, -5980,5981,1385,5982,1386,5983,5984,5985,5986,5987,5988,5989,5990,5991,5992,5993, -5994,5995,5996,5997,5998,5999,6000,6001,6002,6003,6004,6005,6006,6007,6008,6009, -6010,6011,6012,6013,6014,6015,6016,6017,6018,6019,6020,6021,6022,6023,6024,6025, -6026,6027,1265,6028,6029,1691,6030,6031,6032,6033,6034,6035,6036,6037,6038,6039, -6040,6041,6042,6043,6044,6045,6046,6047,6048,6049,6050,6051,6052,6053,6054,6055, -6056,6057,6058,6059,6060,6061,6062,6063,6064,6065,6066,6067,6068,6069,6070,6071, -6072,6073,6074,6075,6076,6077,6078,6079,6080,6081,6082,6083,6084,1692,6085,6086, -6087,6088,6089,6090,6091,6092,6093,6094,6095,6096,6097,6098,6099,6100,6101,6102, -6103,6104,6105,6106,6107,6108,6109,6110,6111,6112,6113,6114,6115,6116,6117,6118, -6119,6120,6121,6122,6123,6124,6125,6126,6127,6128,6129,6130,6131,1693,6132,6133, -6134,6135,6136,1694,6137,6138,6139,6140,6141,1695,6142,6143,6144,6145,6146,6147, -6148,6149,6150,6151,6152,6153,6154,6155,6156,6157,6158,6159,6160,6161,6162,6163, -6164,6165,6166,6167,6168,6169,6170,6171,6172,6173,6174,6175,6176,6177,6178,6179, -6180,6181,6182,6183,6184,6185,1696,6186,6187,6188,6189,6190,6191,6192,6193,6194, -6195,6196,6197,6198,6199,6200,6201,6202,6203,6204,6205,6206,6207,6208,6209,6210, -6211,6212,6213,6214,6215,6216,6217,6218,6219,1697,6220,6221,6222,6223,6224,6225, -6226,6227,6228,6229,6230,6231,6232,6233,6234,6235,6236,6237,6238,6239,6240,6241, -6242,6243,6244,6245,6246,6247,6248,6249,6250,6251,6252,6253,1698,6254,6255,6256, -6257,6258,6259,6260,6261,6262,6263,1200,6264,6265,6266,6267,6268,6269,6270,6271, #1024 -6272,6273,6274,6275,6276,6277,6278,6279,6280,6281,6282,6283,6284,6285,6286,6287, -6288,6289,6290,6291,6292,6293,6294,6295,6296,6297,6298,6299,6300,6301,6302,1699, -6303,6304,1700,6305,6306,6307,6308,6309,6310,6311,6312,6313,6314,6315,6316,6317, -6318,6319,6320,6321,6322,6323,6324,6325,6326,6327,6328,6329,6330,6331,6332,6333, -6334,6335,6336,6337,6338,6339,1701,6340,6341,6342,6343,6344,1387,6345,6346,6347, -6348,6349,6350,6351,6352,6353,6354,6355,6356,6357,6358,6359,6360,6361,6362,6363, -6364,6365,6366,6367,6368,6369,6370,6371,6372,6373,6374,6375,6376,6377,6378,6379, -6380,6381,6382,6383,6384,6385,6386,6387,6388,6389,6390,6391,6392,6393,6394,6395, -6396,6397,6398,6399,6400,6401,6402,6403,6404,6405,6406,6407,6408,6409,6410,6411, -6412,6413,1702,6414,6415,6416,6417,6418,6419,6420,6421,6422,1703,6423,6424,6425, -6426,6427,6428,6429,6430,6431,6432,6433,6434,6435,6436,6437,6438,1704,6439,6440, -6441,6442,6443,6444,6445,6446,6447,6448,6449,6450,6451,6452,6453,6454,6455,6456, -6457,6458,6459,6460,6461,6462,6463,6464,6465,6466,6467,6468,6469,6470,6471,6472, -6473,6474,6475,6476,6477,6478,6479,6480,6481,6482,6483,6484,6485,6486,6487,6488, -6489,6490,6491,6492,6493,6494,6495,6496,6497,6498,6499,6500,6501,6502,6503,1266, -6504,6505,6506,6507,6508,6509,6510,6511,6512,6513,6514,6515,6516,6517,6518,6519, -6520,6521,6522,6523,6524,6525,6526,6527,6528,6529,6530,6531,6532,6533,6534,6535, -6536,6537,6538,6539,6540,6541,6542,6543,6544,6545,6546,6547,6548,6549,6550,6551, -1705,1706,6552,6553,6554,6555,6556,6557,6558,6559,6560,6561,6562,6563,6564,6565, -6566,6567,6568,6569,6570,6571,6572,6573,6574,6575,6576,6577,6578,6579,6580,6581, -6582,6583,6584,6585,6586,6587,6588,6589,6590,6591,6592,6593,6594,6595,6596,6597, -6598,6599,6600,6601,6602,6603,6604,6605,6606,6607,6608,6609,6610,6611,6612,6613, -6614,6615,6616,6617,6618,6619,6620,6621,6622,6623,6624,6625,6626,6627,6628,6629, -6630,6631,6632,6633,6634,6635,6636,6637,1388,6638,6639,6640,6641,6642,6643,6644, -1707,6645,6646,6647,6648,6649,6650,6651,6652,6653,6654,6655,6656,6657,6658,6659, -6660,6661,6662,6663,1708,6664,6665,6666,6667,6668,6669,6670,6671,6672,6673,6674, -1201,6675,6676,6677,6678,6679,6680,6681,6682,6683,6684,6685,6686,6687,6688,6689, -6690,6691,6692,6693,6694,6695,6696,6697,6698,6699,6700,6701,6702,6703,6704,6705, -6706,6707,6708,6709,6710,6711,6712,6713,6714,6715,6716,6717,6718,6719,6720,6721, -6722,6723,6724,6725,1389,6726,6727,6728,6729,6730,6731,6732,6733,6734,6735,6736, -1390,1709,6737,6738,6739,6740,6741,6742,1710,6743,6744,6745,6746,1391,6747,6748, -6749,6750,6751,6752,6753,6754,6755,6756,6757,1392,6758,6759,6760,6761,6762,6763, -6764,6765,6766,6767,6768,6769,6770,6771,6772,6773,6774,6775,6776,6777,6778,6779, -6780,1202,6781,6782,6783,6784,6785,6786,6787,6788,6789,6790,6791,6792,6793,6794, -6795,6796,6797,6798,6799,6800,6801,6802,6803,6804,6805,6806,6807,6808,6809,1711, -6810,6811,6812,6813,6814,6815,6816,6817,6818,6819,6820,6821,6822,6823,6824,6825, -6826,6827,6828,6829,6830,6831,6832,6833,6834,6835,6836,1393,6837,6838,6839,6840, -6841,6842,6843,6844,6845,6846,6847,6848,6849,6850,6851,6852,6853,6854,6855,6856, -6857,6858,6859,6860,6861,6862,6863,6864,6865,6866,6867,6868,6869,6870,6871,6872, -6873,6874,6875,6876,6877,6878,6879,6880,6881,6882,6883,6884,6885,6886,6887,6888, -6889,6890,6891,6892,6893,6894,6895,6896,6897,6898,6899,6900,6901,6902,1712,6903, -6904,6905,6906,6907,6908,6909,6910,1713,6911,6912,6913,6914,6915,6916,6917,6918, -6919,6920,6921,6922,6923,6924,6925,6926,6927,6928,6929,6930,6931,6932,6933,6934, -6935,6936,6937,6938,6939,6940,6941,6942,6943,6944,6945,6946,6947,6948,6949,6950, -6951,6952,6953,6954,6955,6956,6957,6958,6959,6960,6961,6962,6963,6964,6965,6966, -6967,6968,6969,6970,6971,6972,6973,6974,1714,6975,6976,6977,6978,6979,6980,6981, -6982,6983,6984,6985,6986,6987,6988,1394,6989,6990,6991,6992,6993,6994,6995,6996, -6997,6998,6999,7000,1715,7001,7002,7003,7004,7005,7006,7007,7008,7009,7010,7011, -7012,7013,7014,7015,7016,7017,7018,7019,7020,7021,7022,7023,7024,7025,7026,7027, -7028,1716,7029,7030,7031,7032,7033,7034,7035,7036,7037,7038,7039,7040,7041,7042, -7043,7044,7045,7046,7047,7048,7049,7050,7051,7052,7053,7054,7055,7056,7057,7058, -7059,7060,7061,7062,7063,7064,7065,7066,7067,7068,7069,7070,7071,7072,7073,7074, -7075,7076,7077,7078,7079,7080,7081,7082,7083,7084,7085,7086,7087,7088,7089,7090, -7091,7092,7093,7094,7095,7096,7097,7098,7099,7100,7101,7102,7103,7104,7105,7106, -7107,7108,7109,7110,7111,7112,7113,7114,7115,7116,7117,7118,7119,7120,7121,7122, -7123,7124,7125,7126,7127,7128,7129,7130,7131,7132,7133,7134,7135,7136,7137,7138, -7139,7140,7141,7142,7143,7144,7145,7146,7147,7148,7149,7150,7151,7152,7153,7154, -7155,7156,7157,7158,7159,7160,7161,7162,7163,7164,7165,7166,7167,7168,7169,7170, -7171,7172,7173,7174,7175,7176,7177,7178,7179,7180,7181,7182,7183,7184,7185,7186, -7187,7188,7189,7190,7191,7192,7193,7194,7195,7196,7197,7198,7199,7200,7201,7202, -7203,7204,7205,7206,7207,1395,7208,7209,7210,7211,7212,7213,1717,7214,7215,7216, -7217,7218,7219,7220,7221,7222,7223,7224,7225,7226,7227,7228,7229,7230,7231,7232, -7233,7234,7235,7236,7237,7238,7239,7240,7241,7242,7243,7244,7245,7246,7247,7248, -7249,7250,7251,7252,7253,7254,7255,7256,7257,7258,7259,7260,7261,7262,7263,7264, -7265,7266,7267,7268,7269,7270,7271,7272,7273,7274,7275,7276,7277,7278,7279,7280, -7281,7282,7283,7284,7285,7286,7287,7288,7289,7290,7291,7292,7293,7294,7295,7296, -7297,7298,7299,7300,7301,7302,7303,7304,7305,7306,7307,7308,7309,7310,7311,7312, -7313,1718,7314,7315,7316,7317,7318,7319,7320,7321,7322,7323,7324,7325,7326,7327, -7328,7329,7330,7331,7332,7333,7334,7335,7336,7337,7338,7339,7340,7341,7342,7343, -7344,7345,7346,7347,7348,7349,7350,7351,7352,7353,7354,7355,7356,7357,7358,7359, -7360,7361,7362,7363,7364,7365,7366,7367,7368,7369,7370,7371,7372,7373,7374,7375, -7376,7377,7378,7379,7380,7381,7382,7383,7384,7385,7386,7387,7388,7389,7390,7391, -7392,7393,7394,7395,7396,7397,7398,7399,7400,7401,7402,7403,7404,7405,7406,7407, -7408,7409,7410,7411,7412,7413,7414,7415,7416,7417,7418,7419,7420,7421,7422,7423, -7424,7425,7426,7427,7428,7429,7430,7431,7432,7433,7434,7435,7436,7437,7438,7439, -7440,7441,7442,7443,7444,7445,7446,7447,7448,7449,7450,7451,7452,7453,7454,7455, -7456,7457,7458,7459,7460,7461,7462,7463,7464,7465,7466,7467,7468,7469,7470,7471, -7472,7473,7474,7475,7476,7477,7478,7479,7480,7481,7482,7483,7484,7485,7486,7487, -7488,7489,7490,7491,7492,7493,7494,7495,7496,7497,7498,7499,7500,7501,7502,7503, -7504,7505,7506,7507,7508,7509,7510,7511,7512,7513,7514,7515,7516,7517,7518,7519, -7520,7521,7522,7523,7524,7525,7526,7527,7528,7529,7530,7531,7532,7533,7534,7535, -7536,7537,7538,7539,7540,7541,7542,7543,7544,7545,7546,7547,7548,7549,7550,7551, -7552,7553,7554,7555,7556,7557,7558,7559,7560,7561,7562,7563,7564,7565,7566,7567, -7568,7569,7570,7571,7572,7573,7574,7575,7576,7577,7578,7579,7580,7581,7582,7583, -7584,7585,7586,7587,7588,7589,7590,7591,7592,7593,7594,7595,7596,7597,7598,7599, -7600,7601,7602,7603,7604,7605,7606,7607,7608,7609,7610,7611,7612,7613,7614,7615, -7616,7617,7618,7619,7620,7621,7622,7623,7624,7625,7626,7627,7628,7629,7630,7631, -7632,7633,7634,7635,7636,7637,7638,7639,7640,7641,7642,7643,7644,7645,7646,7647, -7648,7649,7650,7651,7652,7653,7654,7655,7656,7657,7658,7659,7660,7661,7662,7663, -7664,7665,7666,7667,7668,7669,7670,7671,7672,7673,7674,7675,7676,7677,7678,7679, -7680,7681,7682,7683,7684,7685,7686,7687,7688,7689,7690,7691,7692,7693,7694,7695, -7696,7697,7698,7699,7700,7701,7702,7703,7704,7705,7706,7707,7708,7709,7710,7711, -7712,7713,7714,7715,7716,7717,7718,7719,7720,7721,7722,7723,7724,7725,7726,7727, -7728,7729,7730,7731,7732,7733,7734,7735,7736,7737,7738,7739,7740,7741,7742,7743, -7744,7745,7746,7747,7748,7749,7750,7751,7752,7753,7754,7755,7756,7757,7758,7759, -7760,7761,7762,7763,7764,7765,7766,7767,7768,7769,7770,7771,7772,7773,7774,7775, -7776,7777,7778,7779,7780,7781,7782,7783,7784,7785,7786,7787,7788,7789,7790,7791, -7792,7793,7794,7795,7796,7797,7798,7799,7800,7801,7802,7803,7804,7805,7806,7807, -7808,7809,7810,7811,7812,7813,7814,7815,7816,7817,7818,7819,7820,7821,7822,7823, -7824,7825,7826,7827,7828,7829,7830,7831,7832,7833,7834,7835,7836,7837,7838,7839, -7840,7841,7842,7843,7844,7845,7846,7847,7848,7849,7850,7851,7852,7853,7854,7855, -7856,7857,7858,7859,7860,7861,7862,7863,7864,7865,7866,7867,7868,7869,7870,7871, -7872,7873,7874,7875,7876,7877,7878,7879,7880,7881,7882,7883,7884,7885,7886,7887, -7888,7889,7890,7891,7892,7893,7894,7895,7896,7897,7898,7899,7900,7901,7902,7903, -7904,7905,7906,7907,7908,7909,7910,7911,7912,7913,7914,7915,7916,7917,7918,7919, -7920,7921,7922,7923,7924,7925,7926,7927,7928,7929,7930,7931,7932,7933,7934,7935, -7936,7937,7938,7939,7940,7941,7942,7943,7944,7945,7946,7947,7948,7949,7950,7951, -7952,7953,7954,7955,7956,7957,7958,7959,7960,7961,7962,7963,7964,7965,7966,7967, -7968,7969,7970,7971,7972,7973,7974,7975,7976,7977,7978,7979,7980,7981,7982,7983, -7984,7985,7986,7987,7988,7989,7990,7991,7992,7993,7994,7995,7996,7997,7998,7999, -8000,8001,8002,8003,8004,8005,8006,8007,8008,8009,8010,8011,8012,8013,8014,8015, -8016,8017,8018,8019,8020,8021,8022,8023,8024,8025,8026,8027,8028,8029,8030,8031, -8032,8033,8034,8035,8036,8037,8038,8039,8040,8041,8042,8043,8044,8045,8046,8047, -8048,8049,8050,8051,8052,8053,8054,8055,8056,8057,8058,8059,8060,8061,8062,8063, -8064,8065,8066,8067,8068,8069,8070,8071,8072,8073,8074,8075,8076,8077,8078,8079, -8080,8081,8082,8083,8084,8085,8086,8087,8088,8089,8090,8091,8092,8093,8094,8095, -8096,8097,8098,8099,8100,8101,8102,8103,8104,8105,8106,8107,8108,8109,8110,8111, -8112,8113,8114,8115,8116,8117,8118,8119,8120,8121,8122,8123,8124,8125,8126,8127, -8128,8129,8130,8131,8132,8133,8134,8135,8136,8137,8138,8139,8140,8141,8142,8143, -8144,8145,8146,8147,8148,8149,8150,8151,8152,8153,8154,8155,8156,8157,8158,8159, -8160,8161,8162,8163,8164,8165,8166,8167,8168,8169,8170,8171,8172,8173,8174,8175, -8176,8177,8178,8179,8180,8181,8182,8183,8184,8185,8186,8187,8188,8189,8190,8191, -8192,8193,8194,8195,8196,8197,8198,8199,8200,8201,8202,8203,8204,8205,8206,8207, -8208,8209,8210,8211,8212,8213,8214,8215,8216,8217,8218,8219,8220,8221,8222,8223, -8224,8225,8226,8227,8228,8229,8230,8231,8232,8233,8234,8235,8236,8237,8238,8239, -8240,8241,8242,8243,8244,8245,8246,8247,8248,8249,8250,8251,8252,8253,8254,8255, -8256,8257,8258,8259,8260,8261,8262,8263,8264,8265,8266,8267,8268,8269,8270,8271, -8272,8273,8274,8275,8276,8277,8278,8279,8280,8281,8282,8283,8284,8285,8286,8287, -8288,8289,8290,8291,8292,8293,8294,8295,8296,8297,8298,8299,8300,8301,8302,8303, -8304,8305,8306,8307,8308,8309,8310,8311,8312,8313,8314,8315,8316,8317,8318,8319, -8320,8321,8322,8323,8324,8325,8326,8327,8328,8329,8330,8331,8332,8333,8334,8335, -8336,8337,8338,8339,8340,8341,8342,8343,8344,8345,8346,8347,8348,8349,8350,8351, -8352,8353,8354,8355,8356,8357,8358,8359,8360,8361,8362,8363,8364,8365,8366,8367, -8368,8369,8370,8371,8372,8373,8374,8375,8376,8377,8378,8379,8380,8381,8382,8383, -8384,8385,8386,8387,8388,8389,8390,8391,8392,8393,8394,8395,8396,8397,8398,8399, -8400,8401,8402,8403,8404,8405,8406,8407,8408,8409,8410,8411,8412,8413,8414,8415, -8416,8417,8418,8419,8420,8421,8422,8423,8424,8425,8426,8427,8428,8429,8430,8431, -8432,8433,8434,8435,8436,8437,8438,8439,8440,8441,8442,8443,8444,8445,8446,8447, -8448,8449,8450,8451,8452,8453,8454,8455,8456,8457,8458,8459,8460,8461,8462,8463, -8464,8465,8466,8467,8468,8469,8470,8471,8472,8473,8474,8475,8476,8477,8478,8479, -8480,8481,8482,8483,8484,8485,8486,8487,8488,8489,8490,8491,8492,8493,8494,8495, -8496,8497,8498,8499,8500,8501,8502,8503,8504,8505,8506,8507,8508,8509,8510,8511, -8512,8513,8514,8515,8516,8517,8518,8519,8520,8521,8522,8523,8524,8525,8526,8527, -8528,8529,8530,8531,8532,8533,8534,8535,8536,8537,8538,8539,8540,8541,8542,8543, -8544,8545,8546,8547,8548,8549,8550,8551,8552,8553,8554,8555,8556,8557,8558,8559, -8560,8561,8562,8563,8564,8565,8566,8567,8568,8569,8570,8571,8572,8573,8574,8575, -8576,8577,8578,8579,8580,8581,8582,8583,8584,8585,8586,8587,8588,8589,8590,8591, -8592,8593,8594,8595,8596,8597,8598,8599,8600,8601,8602,8603,8604,8605,8606,8607, -8608,8609,8610,8611,8612,8613,8614,8615,8616,8617,8618,8619,8620,8621,8622,8623, -8624,8625,8626,8627,8628,8629,8630,8631,8632,8633,8634,8635,8636,8637,8638,8639, -8640,8641,8642,8643,8644,8645,8646,8647,8648,8649,8650,8651,8652,8653,8654,8655, -8656,8657,8658,8659,8660,8661,8662,8663,8664,8665,8666,8667,8668,8669,8670,8671, -8672,8673,8674,8675,8676,8677,8678,8679,8680,8681,8682,8683,8684,8685,8686,8687, -8688,8689,8690,8691,8692,8693,8694,8695,8696,8697,8698,8699,8700,8701,8702,8703, -8704,8705,8706,8707,8708,8709,8710,8711,8712,8713,8714,8715,8716,8717,8718,8719, -8720,8721,8722,8723,8724,8725,8726,8727,8728,8729,8730,8731,8732,8733,8734,8735, -8736,8737,8738,8739,8740,8741) - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrprober.py deleted file mode 100644 index 5982a46b..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euckrprober.py +++ /dev/null @@ -1,42 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import EUCKRDistributionAnalysis -from .mbcssm import EUCKRSMModel - - -class EUCKRProber(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(EUCKRSMModel) - self._mDistributionAnalyzer = EUCKRDistributionAnalysis() - self.reset() - - def get_charset_name(self): - return "EUC-KR" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwfreq.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwfreq.py deleted file mode 100644 index 576e7504..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwfreq.py +++ /dev/null @@ -1,428 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# EUCTW frequency table -# Converted from big5 work -# by Taiwan's Mandarin Promotion Council -# - -# 128 --> 0.42261 -# 256 --> 0.57851 -# 512 --> 0.74851 -# 1024 --> 0.89384 -# 2048 --> 0.97583 -# -# Idea Distribution Ratio = 0.74851/(1-0.74851) =2.98 -# Random Distribution Ration = 512/(5401-512)=0.105 -# -# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR - -EUCTW_TYPICAL_DISTRIBUTION_RATIO = 0.75 - -# Char to FreqOrder table , -EUCTW_TABLE_SIZE = 8102 - -EUCTWCharToFreqOrder = ( - 1,1800,1506, 255,1431, 198, 9, 82, 6,7310, 177, 202,3615,1256,2808, 110, # 2742 -3735, 33,3241, 261, 76, 44,2113, 16,2931,2184,1176, 659,3868, 26,3404,2643, # 2758 -1198,3869,3313,4060, 410,2211, 302, 590, 361,1963, 8, 204, 58,4296,7311,1931, # 2774 - 63,7312,7313, 317,1614, 75, 222, 159,4061,2412,1480,7314,3500,3068, 224,2809, # 2790 -3616, 3, 10,3870,1471, 29,2774,1135,2852,1939, 873, 130,3242,1123, 312,7315, # 2806 -4297,2051, 507, 252, 682,7316, 142,1914, 124, 206,2932, 34,3501,3173, 64, 604, # 2822 -7317,2494,1976,1977, 155,1990, 645, 641,1606,7318,3405, 337, 72, 406,7319, 80, # 2838 - 630, 238,3174,1509, 263, 939,1092,2644, 756,1440,1094,3406, 449, 69,2969, 591, # 2854 - 179,2095, 471, 115,2034,1843, 60, 50,2970, 134, 806,1868, 734,2035,3407, 180, # 2870 - 995,1607, 156, 537,2893, 688,7320, 319,1305, 779,2144, 514,2374, 298,4298, 359, # 2886 -2495, 90,2707,1338, 663, 11, 906,1099,2545, 20,2436, 182, 532,1716,7321, 732, # 2902 -1376,4062,1311,1420,3175, 25,2312,1056, 113, 399, 382,1949, 242,3408,2467, 529, # 2918 -3243, 475,1447,3617,7322, 117, 21, 656, 810,1297,2295,2329,3502,7323, 126,4063, # 2934 - 706, 456, 150, 613,4299, 71,1118,2036,4064, 145,3069, 85, 835, 486,2114,1246, # 2950 -1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,7324,2127,2354, 347,3736, 221, # 2966 -3503,3110,7325,1955,1153,4065, 83, 296,1199,3070, 192, 624, 93,7326, 822,1897, # 2982 -2810,3111, 795,2064, 991,1554,1542,1592, 27, 43,2853, 859, 139,1456, 860,4300, # 2998 - 437, 712,3871, 164,2392,3112, 695, 211,3017,2096, 195,3872,1608,3504,3505,3618, # 3014 -3873, 234, 811,2971,2097,3874,2229,1441,3506,1615,2375, 668,2076,1638, 305, 228, # 3030 -1664,4301, 467, 415,7327, 262,2098,1593, 239, 108, 300, 200,1033, 512,1247,2077, # 3046 -7328,7329,2173,3176,3619,2673, 593, 845,1062,3244, 88,1723,2037,3875,1950, 212, # 3062 - 266, 152, 149, 468,1898,4066,4302, 77, 187,7330,3018, 37, 5,2972,7331,3876, # 3078 -7332,7333, 39,2517,4303,2894,3177,2078, 55, 148, 74,4304, 545, 483,1474,1029, # 3094 -1665, 217,1869,1531,3113,1104,2645,4067, 24, 172,3507, 900,3877,3508,3509,4305, # 3110 - 32,1408,2811,1312, 329, 487,2355,2247,2708, 784,2674, 4,3019,3314,1427,1788, # 3126 - 188, 109, 499,7334,3620,1717,1789, 888,1217,3020,4306,7335,3510,7336,3315,1520, # 3142 -3621,3878, 196,1034, 775,7337,7338, 929,1815, 249, 439, 38,7339,1063,7340, 794, # 3158 -3879,1435,2296, 46, 178,3245,2065,7341,2376,7342, 214,1709,4307, 804, 35, 707, # 3174 - 324,3622,1601,2546, 140, 459,4068,7343,7344,1365, 839, 272, 978,2257,2572,3409, # 3190 -2128,1363,3623,1423, 697, 100,3071, 48, 70,1231, 495,3114,2193,7345,1294,7346, # 3206 -2079, 462, 586,1042,3246, 853, 256, 988, 185,2377,3410,1698, 434,1084,7347,3411, # 3222 - 314,2615,2775,4308,2330,2331, 569,2280, 637,1816,2518, 757,1162,1878,1616,3412, # 3238 - 287,1577,2115, 768,4309,1671,2854,3511,2519,1321,3737, 909,2413,7348,4069, 933, # 3254 -3738,7349,2052,2356,1222,4310, 765,2414,1322, 786,4311,7350,1919,1462,1677,2895, # 3270 -1699,7351,4312,1424,2437,3115,3624,2590,3316,1774,1940,3413,3880,4070, 309,1369, # 3286 -1130,2812, 364,2230,1653,1299,3881,3512,3882,3883,2646, 525,1085,3021, 902,2000, # 3302 -1475, 964,4313, 421,1844,1415,1057,2281, 940,1364,3116, 376,4314,4315,1381, 7, # 3318 -2520, 983,2378, 336,1710,2675,1845, 321,3414, 559,1131,3022,2742,1808,1132,1313, # 3334 - 265,1481,1857,7352, 352,1203,2813,3247, 167,1089, 420,2814, 776, 792,1724,3513, # 3350 -4071,2438,3248,7353,4072,7354, 446, 229, 333,2743, 901,3739,1200,1557,4316,2647, # 3366 -1920, 395,2744,2676,3740,4073,1835, 125, 916,3178,2616,4317,7355,7356,3741,7357, # 3382 -7358,7359,4318,3117,3625,1133,2547,1757,3415,1510,2313,1409,3514,7360,2145, 438, # 3398 -2591,2896,2379,3317,1068, 958,3023, 461, 311,2855,2677,4074,1915,3179,4075,1978, # 3414 - 383, 750,2745,2617,4076, 274, 539, 385,1278,1442,7361,1154,1964, 384, 561, 210, # 3430 - 98,1295,2548,3515,7362,1711,2415,1482,3416,3884,2897,1257, 129,7363,3742, 642, # 3446 - 523,2776,2777,2648,7364, 141,2231,1333, 68, 176, 441, 876, 907,4077, 603,2592, # 3462 - 710, 171,3417, 404, 549, 18,3118,2393,1410,3626,1666,7365,3516,4319,2898,4320, # 3478 -7366,2973, 368,7367, 146, 366, 99, 871,3627,1543, 748, 807,1586,1185, 22,2258, # 3494 - 379,3743,3180,7368,3181, 505,1941,2618,1991,1382,2314,7369, 380,2357, 218, 702, # 3510 -1817,1248,3418,3024,3517,3318,3249,7370,2974,3628, 930,3250,3744,7371, 59,7372, # 3526 - 585, 601,4078, 497,3419,1112,1314,4321,1801,7373,1223,1472,2174,7374, 749,1836, # 3542 - 690,1899,3745,1772,3885,1476, 429,1043,1790,2232,2116, 917,4079, 447,1086,1629, # 3558 -7375, 556,7376,7377,2020,1654, 844,1090, 105, 550, 966,1758,2815,1008,1782, 686, # 3574 -1095,7378,2282, 793,1602,7379,3518,2593,4322,4080,2933,2297,4323,3746, 980,2496, # 3590 - 544, 353, 527,4324, 908,2678,2899,7380, 381,2619,1942,1348,7381,1341,1252, 560, # 3606 -3072,7382,3420,2856,7383,2053, 973, 886,2080, 143,4325,7384,7385, 157,3886, 496, # 3622 -4081, 57, 840, 540,2038,4326,4327,3421,2117,1445, 970,2259,1748,1965,2081,4082, # 3638 -3119,1234,1775,3251,2816,3629, 773,1206,2129,1066,2039,1326,3887,1738,1725,4083, # 3654 - 279,3120, 51,1544,2594, 423,1578,2130,2066, 173,4328,1879,7386,7387,1583, 264, # 3670 - 610,3630,4329,2439, 280, 154,7388,7389,7390,1739, 338,1282,3073, 693,2857,1411, # 3686 -1074,3747,2440,7391,4330,7392,7393,1240, 952,2394,7394,2900,1538,2679, 685,1483, # 3702 -4084,2468,1436, 953,4085,2054,4331, 671,2395, 79,4086,2441,3252, 608, 567,2680, # 3718 -3422,4087,4088,1691, 393,1261,1791,2396,7395,4332,7396,7397,7398,7399,1383,1672, # 3734 -3748,3182,1464, 522,1119, 661,1150, 216, 675,4333,3888,1432,3519, 609,4334,2681, # 3750 -2397,7400,7401,7402,4089,3025, 0,7403,2469, 315, 231,2442, 301,3319,4335,2380, # 3766 -7404, 233,4090,3631,1818,4336,4337,7405, 96,1776,1315,2082,7406, 257,7407,1809, # 3782 -3632,2709,1139,1819,4091,2021,1124,2163,2778,1777,2649,7408,3074, 363,1655,3183, # 3798 -7409,2975,7410,7411,7412,3889,1567,3890, 718, 103,3184, 849,1443, 341,3320,2934, # 3814 -1484,7413,1712, 127, 67, 339,4092,2398, 679,1412, 821,7414,7415, 834, 738, 351, # 3830 -2976,2146, 846, 235,1497,1880, 418,1992,3749,2710, 186,1100,2147,2746,3520,1545, # 3846 -1355,2935,2858,1377, 583,3891,4093,2573,2977,7416,1298,3633,1078,2549,3634,2358, # 3862 - 78,3750,3751, 267,1289,2099,2001,1594,4094, 348, 369,1274,2194,2175,1837,4338, # 3878 -1820,2817,3635,2747,2283,2002,4339,2936,2748, 144,3321, 882,4340,3892,2749,3423, # 3894 -4341,2901,7417,4095,1726, 320,7418,3893,3026, 788,2978,7419,2818,1773,1327,2859, # 3910 -3894,2819,7420,1306,4342,2003,1700,3752,3521,2359,2650, 787,2022, 506, 824,3636, # 3926 - 534, 323,4343,1044,3322,2023,1900, 946,3424,7421,1778,1500,1678,7422,1881,4344, # 3942 - 165, 243,4345,3637,2521, 123, 683,4096, 764,4346, 36,3895,1792, 589,2902, 816, # 3958 - 626,1667,3027,2233,1639,1555,1622,3753,3896,7423,3897,2860,1370,1228,1932, 891, # 3974 -2083,2903, 304,4097,7424, 292,2979,2711,3522, 691,2100,4098,1115,4347, 118, 662, # 3990 -7425, 611,1156, 854,2381,1316,2861, 2, 386, 515,2904,7426,7427,3253, 868,2234, # 4006 -1486, 855,2651, 785,2212,3028,7428,1040,3185,3523,7429,3121, 448,7430,1525,7431, # 4022 -2164,4348,7432,3754,7433,4099,2820,3524,3122, 503, 818,3898,3123,1568, 814, 676, # 4038 -1444, 306,1749,7434,3755,1416,1030, 197,1428, 805,2821,1501,4349,7435,7436,7437, # 4054 -1993,7438,4350,7439,7440,2195, 13,2779,3638,2980,3124,1229,1916,7441,3756,2131, # 4070 -7442,4100,4351,2399,3525,7443,2213,1511,1727,1120,7444,7445, 646,3757,2443, 307, # 4086 -7446,7447,1595,3186,7448,7449,7450,3639,1113,1356,3899,1465,2522,2523,7451, 519, # 4102 -7452, 128,2132, 92,2284,1979,7453,3900,1512, 342,3125,2196,7454,2780,2214,1980, # 4118 -3323,7455, 290,1656,1317, 789, 827,2360,7456,3758,4352, 562, 581,3901,7457, 401, # 4134 -4353,2248, 94,4354,1399,2781,7458,1463,2024,4355,3187,1943,7459, 828,1105,4101, # 4150 -1262,1394,7460,4102, 605,4356,7461,1783,2862,7462,2822, 819,2101, 578,2197,2937, # 4166 -7463,1502, 436,3254,4103,3255,2823,3902,2905,3425,3426,7464,2712,2315,7465,7466, # 4182 -2332,2067, 23,4357, 193, 826,3759,2102, 699,1630,4104,3075, 390,1793,1064,3526, # 4198 -7467,1579,3076,3077,1400,7468,4105,1838,1640,2863,7469,4358,4359, 137,4106, 598, # 4214 -3078,1966, 780, 104, 974,2938,7470, 278, 899, 253, 402, 572, 504, 493,1339,7471, # 4230 -3903,1275,4360,2574,2550,7472,3640,3029,3079,2249, 565,1334,2713, 863, 41,7473, # 4246 -7474,4361,7475,1657,2333, 19, 463,2750,4107, 606,7476,2981,3256,1087,2084,1323, # 4262 -2652,2982,7477,1631,1623,1750,4108,2682,7478,2864, 791,2714,2653,2334, 232,2416, # 4278 -7479,2983,1498,7480,2654,2620, 755,1366,3641,3257,3126,2025,1609, 119,1917,3427, # 4294 - 862,1026,4109,7481,3904,3760,4362,3905,4363,2260,1951,2470,7482,1125, 817,4110, # 4310 -4111,3906,1513,1766,2040,1487,4112,3030,3258,2824,3761,3127,7483,7484,1507,7485, # 4326 -2683, 733, 40,1632,1106,2865, 345,4113, 841,2524, 230,4364,2984,1846,3259,3428, # 4342 -7486,1263, 986,3429,7487, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562,3907, # 4358 -3908,2939, 967,2751,2655,1349, 592,2133,1692,3324,2985,1994,4114,1679,3909,1901, # 4374 -2185,7488, 739,3642,2715,1296,1290,7489,4115,2198,2199,1921,1563,2595,2551,1870, # 4390 -2752,2986,7490, 435,7491, 343,1108, 596, 17,1751,4365,2235,3430,3643,7492,4366, # 4406 - 294,3527,2940,1693, 477, 979, 281,2041,3528, 643,2042,3644,2621,2782,2261,1031, # 4422 -2335,2134,2298,3529,4367, 367,1249,2552,7493,3530,7494,4368,1283,3325,2004, 240, # 4438 -1762,3326,4369,4370, 836,1069,3128, 474,7495,2148,2525, 268,3531,7496,3188,1521, # 4454 -1284,7497,1658,1546,4116,7498,3532,3533,7499,4117,3327,2684,1685,4118, 961,1673, # 4470 -2622, 190,2005,2200,3762,4371,4372,7500, 570,2497,3645,1490,7501,4373,2623,3260, # 4486 -1956,4374, 584,1514, 396,1045,1944,7502,4375,1967,2444,7503,7504,4376,3910, 619, # 4502 -7505,3129,3261, 215,2006,2783,2553,3189,4377,3190,4378, 763,4119,3763,4379,7506, # 4518 -7507,1957,1767,2941,3328,3646,1174, 452,1477,4380,3329,3130,7508,2825,1253,2382, # 4534 -2186,1091,2285,4120, 492,7509, 638,1169,1824,2135,1752,3911, 648, 926,1021,1324, # 4550 -4381, 520,4382, 997, 847,1007, 892,4383,3764,2262,1871,3647,7510,2400,1784,4384, # 4566 -1952,2942,3080,3191,1728,4121,2043,3648,4385,2007,1701,3131,1551, 30,2263,4122, # 4582 -7511,2026,4386,3534,7512, 501,7513,4123, 594,3431,2165,1821,3535,3432,3536,3192, # 4598 - 829,2826,4124,7514,1680,3132,1225,4125,7515,3262,4387,4126,3133,2336,7516,4388, # 4614 -4127,7517,3912,3913,7518,1847,2383,2596,3330,7519,4389, 374,3914, 652,4128,4129, # 4630 - 375,1140, 798,7520,7521,7522,2361,4390,2264, 546,1659, 138,3031,2445,4391,7523, # 4646 -2250, 612,1848, 910, 796,3765,1740,1371, 825,3766,3767,7524,2906,2554,7525, 692, # 4662 - 444,3032,2624, 801,4392,4130,7526,1491, 244,1053,3033,4131,4132, 340,7527,3915, # 4678 -1041,2987, 293,1168, 87,1357,7528,1539, 959,7529,2236, 721, 694,4133,3768, 219, # 4694 -1478, 644,1417,3331,2656,1413,1401,1335,1389,3916,7530,7531,2988,2362,3134,1825, # 4710 - 730,1515, 184,2827, 66,4393,7532,1660,2943, 246,3332, 378,1457, 226,3433, 975, # 4726 -3917,2944,1264,3537, 674, 696,7533, 163,7534,1141,2417,2166, 713,3538,3333,4394, # 4742 -3918,7535,7536,1186, 15,7537,1079,1070,7538,1522,3193,3539, 276,1050,2716, 758, # 4758 -1126, 653,2945,3263,7539,2337, 889,3540,3919,3081,2989, 903,1250,4395,3920,3434, # 4774 -3541,1342,1681,1718, 766,3264, 286, 89,2946,3649,7540,1713,7541,2597,3334,2990, # 4790 -7542,2947,2215,3194,2866,7543,4396,2498,2526, 181, 387,1075,3921, 731,2187,3335, # 4806 -7544,3265, 310, 313,3435,2299, 770,4134, 54,3034, 189,4397,3082,3769,3922,7545, # 4822 -1230,1617,1849, 355,3542,4135,4398,3336, 111,4136,3650,1350,3135,3436,3035,4137, # 4838 -2149,3266,3543,7546,2784,3923,3924,2991, 722,2008,7547,1071, 247,1207,2338,2471, # 4854 -1378,4399,2009, 864,1437,1214,4400, 373,3770,1142,2216, 667,4401, 442,2753,2555, # 4870 -3771,3925,1968,4138,3267,1839, 837, 170,1107, 934,1336,1882,7548,7549,2118,4139, # 4886 -2828, 743,1569,7550,4402,4140, 582,2384,1418,3437,7551,1802,7552, 357,1395,1729, # 4902 -3651,3268,2418,1564,2237,7553,3083,3772,1633,4403,1114,2085,4141,1532,7554, 482, # 4918 -2446,4404,7555,7556,1492, 833,1466,7557,2717,3544,1641,2829,7558,1526,1272,3652, # 4934 -4142,1686,1794, 416,2556,1902,1953,1803,7559,3773,2785,3774,1159,2316,7560,2867, # 4950 -4405,1610,1584,3036,2419,2754, 443,3269,1163,3136,7561,7562,3926,7563,4143,2499, # 4966 -3037,4406,3927,3137,2103,1647,3545,2010,1872,4144,7564,4145, 431,3438,7565, 250, # 4982 - 97, 81,4146,7566,1648,1850,1558, 160, 848,7567, 866, 740,1694,7568,2201,2830, # 4998 -3195,4147,4407,3653,1687, 950,2472, 426, 469,3196,3654,3655,3928,7569,7570,1188, # 5014 - 424,1995, 861,3546,4148,3775,2202,2685, 168,1235,3547,4149,7571,2086,1674,4408, # 5030 -3337,3270, 220,2557,1009,7572,3776, 670,2992, 332,1208, 717,7573,7574,3548,2447, # 5046 -3929,3338,7575, 513,7576,1209,2868,3339,3138,4409,1080,7577,7578,7579,7580,2527, # 5062 -3656,3549, 815,1587,3930,3931,7581,3550,3439,3777,1254,4410,1328,3038,1390,3932, # 5078 -1741,3933,3778,3934,7582, 236,3779,2448,3271,7583,7584,3657,3780,1273,3781,4411, # 5094 -7585, 308,7586,4412, 245,4413,1851,2473,1307,2575, 430, 715,2136,2449,7587, 270, # 5110 - 199,2869,3935,7588,3551,2718,1753, 761,1754, 725,1661,1840,4414,3440,3658,7589, # 5126 -7590, 587, 14,3272, 227,2598, 326, 480,2265, 943,2755,3552, 291, 650,1883,7591, # 5142 -1702,1226, 102,1547, 62,3441, 904,4415,3442,1164,4150,7592,7593,1224,1548,2756, # 5158 - 391, 498,1493,7594,1386,1419,7595,2055,1177,4416, 813, 880,1081,2363, 566,1145, # 5174 -4417,2286,1001,1035,2558,2599,2238, 394,1286,7596,7597,2068,7598, 86,1494,1730, # 5190 -3936, 491,1588, 745, 897,2948, 843,3340,3937,2757,2870,3273,1768, 998,2217,2069, # 5206 - 397,1826,1195,1969,3659,2993,3341, 284,7599,3782,2500,2137,2119,1903,7600,3938, # 5222 -2150,3939,4151,1036,3443,1904, 114,2559,4152, 209,1527,7601,7602,2949,2831,2625, # 5238 -2385,2719,3139, 812,2560,7603,3274,7604,1559, 737,1884,3660,1210, 885, 28,2686, # 5254 -3553,3783,7605,4153,1004,1779,4418,7606, 346,1981,2218,2687,4419,3784,1742, 797, # 5270 -1642,3940,1933,1072,1384,2151, 896,3941,3275,3661,3197,2871,3554,7607,2561,1958, # 5286 -4420,2450,1785,7608,7609,7610,3942,4154,1005,1308,3662,4155,2720,4421,4422,1528, # 5302 -2600, 161,1178,4156,1982, 987,4423,1101,4157, 631,3943,1157,3198,2420,1343,1241, # 5318 -1016,2239,2562, 372, 877,2339,2501,1160, 555,1934, 911,3944,7611, 466,1170, 169, # 5334 -1051,2907,2688,3663,2474,2994,1182,2011,2563,1251,2626,7612, 992,2340,3444,1540, # 5350 -2721,1201,2070,2401,1996,2475,7613,4424, 528,1922,2188,1503,1873,1570,2364,3342, # 5366 -3276,7614, 557,1073,7615,1827,3445,2087,2266,3140,3039,3084, 767,3085,2786,4425, # 5382 -1006,4158,4426,2341,1267,2176,3664,3199, 778,3945,3200,2722,1597,2657,7616,4427, # 5398 -7617,3446,7618,7619,7620,3277,2689,1433,3278, 131, 95,1504,3946, 723,4159,3141, # 5414 -1841,3555,2758,2189,3947,2027,2104,3665,7621,2995,3948,1218,7622,3343,3201,3949, # 5430 -4160,2576, 248,1634,3785, 912,7623,2832,3666,3040,3786, 654, 53,7624,2996,7625, # 5446 -1688,4428, 777,3447,1032,3950,1425,7626, 191, 820,2120,2833, 971,4429, 931,3202, # 5462 - 135, 664, 783,3787,1997, 772,2908,1935,3951,3788,4430,2909,3203, 282,2723, 640, # 5478 -1372,3448,1127, 922, 325,3344,7627,7628, 711,2044,7629,7630,3952,2219,2787,1936, # 5494 -3953,3345,2220,2251,3789,2300,7631,4431,3790,1258,3279,3954,3204,2138,2950,3955, # 5510 -3956,7632,2221, 258,3205,4432, 101,1227,7633,3280,1755,7634,1391,3281,7635,2910, # 5526 -2056, 893,7636,7637,7638,1402,4161,2342,7639,7640,3206,3556,7641,7642, 878,1325, # 5542 -1780,2788,4433, 259,1385,2577, 744,1183,2267,4434,7643,3957,2502,7644, 684,1024, # 5558 -4162,7645, 472,3557,3449,1165,3282,3958,3959, 322,2152, 881, 455,1695,1152,1340, # 5574 - 660, 554,2153,4435,1058,4436,4163, 830,1065,3346,3960,4437,1923,7646,1703,1918, # 5590 -7647, 932,2268, 122,7648,4438, 947, 677,7649,3791,2627, 297,1905,1924,2269,4439, # 5606 -2317,3283,7650,7651,4164,7652,4165, 84,4166, 112, 989,7653, 547,1059,3961, 701, # 5622 -3558,1019,7654,4167,7655,3450, 942, 639, 457,2301,2451, 993,2951, 407, 851, 494, # 5638 -4440,3347, 927,7656,1237,7657,2421,3348, 573,4168, 680, 921,2911,1279,1874, 285, # 5654 - 790,1448,1983, 719,2167,7658,7659,4441,3962,3963,1649,7660,1541, 563,7661,1077, # 5670 -7662,3349,3041,3451, 511,2997,3964,3965,3667,3966,1268,2564,3350,3207,4442,4443, # 5686 -7663, 535,1048,1276,1189,2912,2028,3142,1438,1373,2834,2952,1134,2012,7664,4169, # 5702 -1238,2578,3086,1259,7665, 700,7666,2953,3143,3668,4170,7667,4171,1146,1875,1906, # 5718 -4444,2601,3967, 781,2422, 132,1589, 203, 147, 273,2789,2402, 898,1786,2154,3968, # 5734 -3969,7668,3792,2790,7669,7670,4445,4446,7671,3208,7672,1635,3793, 965,7673,1804, # 5750 -2690,1516,3559,1121,1082,1329,3284,3970,1449,3794, 65,1128,2835,2913,2759,1590, # 5766 -3795,7674,7675, 12,2658, 45, 976,2579,3144,4447, 517,2528,1013,1037,3209,7676, # 5782 -3796,2836,7677,3797,7678,3452,7679,2602, 614,1998,2318,3798,3087,2724,2628,7680, # 5798 -2580,4172, 599,1269,7681,1810,3669,7682,2691,3088, 759,1060, 489,1805,3351,3285, # 5814 -1358,7683,7684,2386,1387,1215,2629,2252, 490,7685,7686,4173,1759,2387,2343,7687, # 5830 -4448,3799,1907,3971,2630,1806,3210,4449,3453,3286,2760,2344, 874,7688,7689,3454, # 5846 -3670,1858, 91,2914,3671,3042,3800,4450,7690,3145,3972,2659,7691,3455,1202,1403, # 5862 -3801,2954,2529,1517,2503,4451,3456,2504,7692,4452,7693,2692,1885,1495,1731,3973, # 5878 -2365,4453,7694,2029,7695,7696,3974,2693,1216, 237,2581,4174,2319,3975,3802,4454, # 5894 -4455,2694,3560,3457, 445,4456,7697,7698,7699,7700,2761, 61,3976,3672,1822,3977, # 5910 -7701, 687,2045, 935, 925, 405,2660, 703,1096,1859,2725,4457,3978,1876,1367,2695, # 5926 -3352, 918,2105,1781,2476, 334,3287,1611,1093,4458, 564,3146,3458,3673,3353, 945, # 5942 -2631,2057,4459,7702,1925, 872,4175,7703,3459,2696,3089, 349,4176,3674,3979,4460, # 5958 -3803,4177,3675,2155,3980,4461,4462,4178,4463,2403,2046, 782,3981, 400, 251,4179, # 5974 -1624,7704,7705, 277,3676, 299,1265, 476,1191,3804,2121,4180,4181,1109, 205,7706, # 5990 -2582,1000,2156,3561,1860,7707,7708,7709,4464,7710,4465,2565, 107,2477,2157,3982, # 6006 -3460,3147,7711,1533, 541,1301, 158, 753,4182,2872,3562,7712,1696, 370,1088,4183, # 6022 -4466,3563, 579, 327, 440, 162,2240, 269,1937,1374,3461, 968,3043, 56,1396,3090, # 6038 -2106,3288,3354,7713,1926,2158,4467,2998,7714,3564,7715,7716,3677,4468,2478,7717, # 6054 -2791,7718,1650,4469,7719,2603,7720,7721,3983,2661,3355,1149,3356,3984,3805,3985, # 6070 -7722,1076, 49,7723, 951,3211,3289,3290, 450,2837, 920,7724,1811,2792,2366,4184, # 6086 -1908,1138,2367,3806,3462,7725,3212,4470,1909,1147,1518,2423,4471,3807,7726,4472, # 6102 -2388,2604, 260,1795,3213,7727,7728,3808,3291, 708,7729,3565,1704,7730,3566,1351, # 6118 -1618,3357,2999,1886, 944,4185,3358,4186,3044,3359,4187,7731,3678, 422, 413,1714, # 6134 -3292, 500,2058,2345,4188,2479,7732,1344,1910, 954,7733,1668,7734,7735,3986,2404, # 6150 -4189,3567,3809,4190,7736,2302,1318,2505,3091, 133,3092,2873,4473, 629, 31,2838, # 6166 -2697,3810,4474, 850, 949,4475,3987,2955,1732,2088,4191,1496,1852,7737,3988, 620, # 6182 -3214, 981,1242,3679,3360,1619,3680,1643,3293,2139,2452,1970,1719,3463,2168,7738, # 6198 -3215,7739,7740,3361,1828,7741,1277,4476,1565,2047,7742,1636,3568,3093,7743, 869, # 6214 -2839, 655,3811,3812,3094,3989,3000,3813,1310,3569,4477,7744,7745,7746,1733, 558, # 6230 -4478,3681, 335,1549,3045,1756,4192,3682,1945,3464,1829,1291,1192, 470,2726,2107, # 6246 -2793, 913,1054,3990,7747,1027,7748,3046,3991,4479, 982,2662,3362,3148,3465,3216, # 6262 -3217,1946,2794,7749, 571,4480,7750,1830,7751,3570,2583,1523,2424,7752,2089, 984, # 6278 -4481,3683,1959,7753,3684, 852, 923,2795,3466,3685, 969,1519, 999,2048,2320,1705, # 6294 -7754,3095, 615,1662, 151, 597,3992,2405,2321,1049, 275,4482,3686,4193, 568,3687, # 6310 -3571,2480,4194,3688,7755,2425,2270, 409,3218,7756,1566,2874,3467,1002, 769,2840, # 6326 - 194,2090,3149,3689,2222,3294,4195, 628,1505,7757,7758,1763,2177,3001,3993, 521, # 6342 -1161,2584,1787,2203,2406,4483,3994,1625,4196,4197, 412, 42,3096, 464,7759,2632, # 6358 -4484,3363,1760,1571,2875,3468,2530,1219,2204,3814,2633,2140,2368,4485,4486,3295, # 6374 -1651,3364,3572,7760,7761,3573,2481,3469,7762,3690,7763,7764,2271,2091, 460,7765, # 6390 -4487,7766,3002, 962, 588,3574, 289,3219,2634,1116, 52,7767,3047,1796,7768,7769, # 6406 -7770,1467,7771,1598,1143,3691,4198,1984,1734,1067,4488,1280,3365, 465,4489,1572, # 6422 - 510,7772,1927,2241,1812,1644,3575,7773,4490,3692,7774,7775,2663,1573,1534,7776, # 6438 -7777,4199, 536,1807,1761,3470,3815,3150,2635,7778,7779,7780,4491,3471,2915,1911, # 6454 -2796,7781,3296,1122, 377,3220,7782, 360,7783,7784,4200,1529, 551,7785,2059,3693, # 6470 -1769,2426,7786,2916,4201,3297,3097,2322,2108,2030,4492,1404, 136,1468,1479, 672, # 6486 -1171,3221,2303, 271,3151,7787,2762,7788,2049, 678,2727, 865,1947,4493,7789,2013, # 6502 -3995,2956,7790,2728,2223,1397,3048,3694,4494,4495,1735,2917,3366,3576,7791,3816, # 6518 - 509,2841,2453,2876,3817,7792,7793,3152,3153,4496,4202,2531,4497,2304,1166,1010, # 6534 - 552, 681,1887,7794,7795,2957,2958,3996,1287,1596,1861,3154, 358, 453, 736, 175, # 6550 - 478,1117, 905,1167,1097,7796,1853,1530,7797,1706,7798,2178,3472,2287,3695,3473, # 6566 -3577,4203,2092,4204,7799,3367,1193,2482,4205,1458,2190,2205,1862,1888,1421,3298, # 6582 -2918,3049,2179,3474, 595,2122,7800,3997,7801,7802,4206,1707,2636, 223,3696,1359, # 6598 - 751,3098, 183,3475,7803,2797,3003, 419,2369, 633, 704,3818,2389, 241,7804,7805, # 6614 -7806, 838,3004,3697,2272,2763,2454,3819,1938,2050,3998,1309,3099,2242,1181,7807, # 6630 -1136,2206,3820,2370,1446,4207,2305,4498,7808,7809,4208,1055,2605, 484,3698,7810, # 6646 -3999, 625,4209,2273,3368,1499,4210,4000,7811,4001,4211,3222,2274,2275,3476,7812, # 6662 -7813,2764, 808,2606,3699,3369,4002,4212,3100,2532, 526,3370,3821,4213, 955,7814, # 6678 -1620,4214,2637,2427,7815,1429,3700,1669,1831, 994, 928,7816,3578,1260,7817,7818, # 6694 -7819,1948,2288, 741,2919,1626,4215,2729,2455, 867,1184, 362,3371,1392,7820,7821, # 6710 -4003,4216,1770,1736,3223,2920,4499,4500,1928,2698,1459,1158,7822,3050,3372,2877, # 6726 -1292,1929,2506,2842,3701,1985,1187,2071,2014,2607,4217,7823,2566,2507,2169,3702, # 6742 -2483,3299,7824,3703,4501,7825,7826, 666,1003,3005,1022,3579,4218,7827,4502,1813, # 6758 -2253, 574,3822,1603, 295,1535, 705,3823,4219, 283, 858, 417,7828,7829,3224,4503, # 6774 -4504,3051,1220,1889,1046,2276,2456,4004,1393,1599, 689,2567, 388,4220,7830,2484, # 6790 - 802,7831,2798,3824,2060,1405,2254,7832,4505,3825,2109,1052,1345,3225,1585,7833, # 6806 - 809,7834,7835,7836, 575,2730,3477, 956,1552,1469,1144,2323,7837,2324,1560,2457, # 6822 -3580,3226,4005, 616,2207,3155,2180,2289,7838,1832,7839,3478,4506,7840,1319,3704, # 6838 -3705,1211,3581,1023,3227,1293,2799,7841,7842,7843,3826, 607,2306,3827, 762,2878, # 6854 -1439,4221,1360,7844,1485,3052,7845,4507,1038,4222,1450,2061,2638,4223,1379,4508, # 6870 -2585,7846,7847,4224,1352,1414,2325,2921,1172,7848,7849,3828,3829,7850,1797,1451, # 6886 -7851,7852,7853,7854,2922,4006,4007,2485,2346, 411,4008,4009,3582,3300,3101,4509, # 6902 -1561,2664,1452,4010,1375,7855,7856, 47,2959, 316,7857,1406,1591,2923,3156,7858, # 6918 -1025,2141,3102,3157, 354,2731, 884,2224,4225,2407, 508,3706, 726,3583, 996,2428, # 6934 -3584, 729,7859, 392,2191,1453,4011,4510,3707,7860,7861,2458,3585,2608,1675,2800, # 6950 - 919,2347,2960,2348,1270,4511,4012, 73,7862,7863, 647,7864,3228,2843,2255,1550, # 6966 -1346,3006,7865,1332, 883,3479,7866,7867,7868,7869,3301,2765,7870,1212, 831,1347, # 6982 -4226,4512,2326,3830,1863,3053, 720,3831,4513,4514,3832,7871,4227,7872,7873,4515, # 6998 -7874,7875,1798,4516,3708,2609,4517,3586,1645,2371,7876,7877,2924, 669,2208,2665, # 7014 -2429,7878,2879,7879,7880,1028,3229,7881,4228,2408,7882,2256,1353,7883,7884,4518, # 7030 -3158, 518,7885,4013,7886,4229,1960,7887,2142,4230,7888,7889,3007,2349,2350,3833, # 7046 - 516,1833,1454,4014,2699,4231,4519,2225,2610,1971,1129,3587,7890,2766,7891,2961, # 7062 -1422, 577,1470,3008,1524,3373,7892,7893, 432,4232,3054,3480,7894,2586,1455,2508, # 7078 -2226,1972,1175,7895,1020,2732,4015,3481,4520,7896,2733,7897,1743,1361,3055,3482, # 7094 -2639,4016,4233,4521,2290, 895, 924,4234,2170, 331,2243,3056, 166,1627,3057,1098, # 7110 -7898,1232,2880,2227,3374,4522, 657, 403,1196,2372, 542,3709,3375,1600,4235,3483, # 7126 -7899,4523,2767,3230, 576, 530,1362,7900,4524,2533,2666,3710,4017,7901, 842,3834, # 7142 -7902,2801,2031,1014,4018, 213,2700,3376, 665, 621,4236,7903,3711,2925,2430,7904, # 7158 -2431,3302,3588,3377,7905,4237,2534,4238,4525,3589,1682,4239,3484,1380,7906, 724, # 7174 -2277, 600,1670,7907,1337,1233,4526,3103,2244,7908,1621,4527,7909, 651,4240,7910, # 7190 -1612,4241,2611,7911,2844,7912,2734,2307,3058,7913, 716,2459,3059, 174,1255,2701, # 7206 -4019,3590, 548,1320,1398, 728,4020,1574,7914,1890,1197,3060,4021,7915,3061,3062, # 7222 -3712,3591,3713, 747,7916, 635,4242,4528,7917,7918,7919,4243,7920,7921,4529,7922, # 7238 -3378,4530,2432, 451,7923,3714,2535,2072,4244,2735,4245,4022,7924,1764,4531,7925, # 7254 -4246, 350,7926,2278,2390,2486,7927,4247,4023,2245,1434,4024, 488,4532, 458,4248, # 7270 -4025,3715, 771,1330,2391,3835,2568,3159,2159,2409,1553,2667,3160,4249,7928,2487, # 7286 -2881,2612,1720,2702,4250,3379,4533,7929,2536,4251,7930,3231,4252,2768,7931,2015, # 7302 -2736,7932,1155,1017,3716,3836,7933,3303,2308, 201,1864,4253,1430,7934,4026,7935, # 7318 -7936,7937,7938,7939,4254,1604,7940, 414,1865, 371,2587,4534,4535,3485,2016,3104, # 7334 -4536,1708, 960,4255, 887, 389,2171,1536,1663,1721,7941,2228,4027,2351,2926,1580, # 7350 -7942,7943,7944,1744,7945,2537,4537,4538,7946,4539,7947,2073,7948,7949,3592,3380, # 7366 -2882,4256,7950,4257,2640,3381,2802, 673,2703,2460, 709,3486,4028,3593,4258,7951, # 7382 -1148, 502, 634,7952,7953,1204,4540,3594,1575,4541,2613,3717,7954,3718,3105, 948, # 7398 -3232, 121,1745,3837,1110,7955,4259,3063,2509,3009,4029,3719,1151,1771,3838,1488, # 7414 -4030,1986,7956,2433,3487,7957,7958,2093,7959,4260,3839,1213,1407,2803, 531,2737, # 7430 -2538,3233,1011,1537,7960,2769,4261,3106,1061,7961,3720,3721,1866,2883,7962,2017, # 7446 - 120,4262,4263,2062,3595,3234,2309,3840,2668,3382,1954,4542,7963,7964,3488,1047, # 7462 -2704,1266,7965,1368,4543,2845, 649,3383,3841,2539,2738,1102,2846,2669,7966,7967, # 7478 -1999,7968,1111,3596,2962,7969,2488,3842,3597,2804,1854,3384,3722,7970,7971,3385, # 7494 -2410,2884,3304,3235,3598,7972,2569,7973,3599,2805,4031,1460, 856,7974,3600,7975, # 7510 -2885,2963,7976,2886,3843,7977,4264, 632,2510, 875,3844,1697,3845,2291,7978,7979, # 7526 -4544,3010,1239, 580,4545,4265,7980, 914, 936,2074,1190,4032,1039,2123,7981,7982, # 7542 -7983,3386,1473,7984,1354,4266,3846,7985,2172,3064,4033, 915,3305,4267,4268,3306, # 7558 -1605,1834,7986,2739, 398,3601,4269,3847,4034, 328,1912,2847,4035,3848,1331,4270, # 7574 -3011, 937,4271,7987,3602,4036,4037,3387,2160,4546,3388, 524, 742, 538,3065,1012, # 7590 -7988,7989,3849,2461,7990, 658,1103, 225,3850,7991,7992,4547,7993,4548,7994,3236, # 7606 -1243,7995,4038, 963,2246,4549,7996,2705,3603,3161,7997,7998,2588,2327,7999,4550, # 7622 -8000,8001,8002,3489,3307, 957,3389,2540,2032,1930,2927,2462, 870,2018,3604,1746, # 7638 -2770,2771,2434,2463,8003,3851,8004,3723,3107,3724,3490,3390,3725,8005,1179,3066, # 7654 -8006,3162,2373,4272,3726,2541,3163,3108,2740,4039,8007,3391,1556,2542,2292, 977, # 7670 -2887,2033,4040,1205,3392,8008,1765,3393,3164,2124,1271,1689, 714,4551,3491,8009, # 7686 -2328,3852, 533,4273,3605,2181, 617,8010,2464,3308,3492,2310,8011,8012,3165,8013, # 7702 -8014,3853,1987, 618, 427,2641,3493,3394,8015,8016,1244,1690,8017,2806,4274,4552, # 7718 -8018,3494,8019,8020,2279,1576, 473,3606,4275,3395, 972,8021,3607,8022,3067,8023, # 7734 -8024,4553,4554,8025,3727,4041,4042,8026, 153,4555, 356,8027,1891,2888,4276,2143, # 7750 - 408, 803,2352,8028,3854,8029,4277,1646,2570,2511,4556,4557,3855,8030,3856,4278, # 7766 -8031,2411,3396, 752,8032,8033,1961,2964,8034, 746,3012,2465,8035,4279,3728, 698, # 7782 -4558,1892,4280,3608,2543,4559,3609,3857,8036,3166,3397,8037,1823,1302,4043,2706, # 7798 -3858,1973,4281,8038,4282,3167, 823,1303,1288,1236,2848,3495,4044,3398, 774,3859, # 7814 -8039,1581,4560,1304,2849,3860,4561,8040,2435,2161,1083,3237,4283,4045,4284, 344, # 7830 -1173, 288,2311, 454,1683,8041,8042,1461,4562,4046,2589,8043,8044,4563, 985, 894, # 7846 -8045,3399,3168,8046,1913,2928,3729,1988,8047,2110,1974,8048,4047,8049,2571,1194, # 7862 - 425,8050,4564,3169,1245,3730,4285,8051,8052,2850,8053, 636,4565,1855,3861, 760, # 7878 -1799,8054,4286,2209,1508,4566,4048,1893,1684,2293,8055,8056,8057,4287,4288,2210, # 7894 - 479,8058,8059, 832,8060,4049,2489,8061,2965,2490,3731, 990,3109, 627,1814,2642, # 7910 -4289,1582,4290,2125,2111,3496,4567,8062, 799,4291,3170,8063,4568,2112,1737,3013, # 7926 -1018, 543, 754,4292,3309,1676,4569,4570,4050,8064,1489,8065,3497,8066,2614,2889, # 7942 -4051,8067,8068,2966,8069,8070,8071,8072,3171,4571,4572,2182,1722,8073,3238,3239, # 7958 -1842,3610,1715, 481, 365,1975,1856,8074,8075,1962,2491,4573,8076,2126,3611,3240, # 7974 - 433,1894,2063,2075,8077, 602,2741,8078,8079,8080,8081,8082,3014,1628,3400,8083, # 7990 -3172,4574,4052,2890,4575,2512,8084,2544,2772,8085,8086,8087,3310,4576,2891,8088, # 8006 -4577,8089,2851,4578,4579,1221,2967,4053,2513,8090,8091,8092,1867,1989,8093,8094, # 8022 -8095,1895,8096,8097,4580,1896,4054, 318,8098,2094,4055,4293,8099,8100, 485,8101, # 8038 - 938,3862, 553,2670, 116,8102,3863,3612,8103,3498,2671,2773,3401,3311,2807,8104, # 8054 -3613,2929,4056,1747,2930,2968,8105,8106, 207,8107,8108,2672,4581,2514,8109,3015, # 8070 - 890,3614,3864,8110,1877,3732,3402,8111,2183,2353,3403,1652,8112,8113,8114, 941, # 8086 -2294, 208,3499,4057,2019, 330,4294,3865,2892,2492,3733,4295,8115,8116,8117,8118, # 8102 -#Everything below is of no interest for detection purpose -2515,1613,4582,8119,3312,3866,2516,8120,4058,8121,1637,4059,2466,4583,3867,8122, # 8118 -2493,3016,3734,8123,8124,2192,8125,8126,2162,8127,8128,8129,8130,8131,8132,8133, # 8134 -8134,8135,8136,8137,8138,8139,8140,8141,8142,8143,8144,8145,8146,8147,8148,8149, # 8150 -8150,8151,8152,8153,8154,8155,8156,8157,8158,8159,8160,8161,8162,8163,8164,8165, # 8166 -8166,8167,8168,8169,8170,8171,8172,8173,8174,8175,8176,8177,8178,8179,8180,8181, # 8182 -8182,8183,8184,8185,8186,8187,8188,8189,8190,8191,8192,8193,8194,8195,8196,8197, # 8198 -8198,8199,8200,8201,8202,8203,8204,8205,8206,8207,8208,8209,8210,8211,8212,8213, # 8214 -8214,8215,8216,8217,8218,8219,8220,8221,8222,8223,8224,8225,8226,8227,8228,8229, # 8230 -8230,8231,8232,8233,8234,8235,8236,8237,8238,8239,8240,8241,8242,8243,8244,8245, # 8246 -8246,8247,8248,8249,8250,8251,8252,8253,8254,8255,8256,8257,8258,8259,8260,8261, # 8262 -8262,8263,8264,8265,8266,8267,8268,8269,8270,8271,8272,8273,8274,8275,8276,8277, # 8278 -8278,8279,8280,8281,8282,8283,8284,8285,8286,8287,8288,8289,8290,8291,8292,8293, # 8294 -8294,8295,8296,8297,8298,8299,8300,8301,8302,8303,8304,8305,8306,8307,8308,8309, # 8310 -8310,8311,8312,8313,8314,8315,8316,8317,8318,8319,8320,8321,8322,8323,8324,8325, # 8326 -8326,8327,8328,8329,8330,8331,8332,8333,8334,8335,8336,8337,8338,8339,8340,8341, # 8342 -8342,8343,8344,8345,8346,8347,8348,8349,8350,8351,8352,8353,8354,8355,8356,8357, # 8358 -8358,8359,8360,8361,8362,8363,8364,8365,8366,8367,8368,8369,8370,8371,8372,8373, # 8374 -8374,8375,8376,8377,8378,8379,8380,8381,8382,8383,8384,8385,8386,8387,8388,8389, # 8390 -8390,8391,8392,8393,8394,8395,8396,8397,8398,8399,8400,8401,8402,8403,8404,8405, # 8406 -8406,8407,8408,8409,8410,8411,8412,8413,8414,8415,8416,8417,8418,8419,8420,8421, # 8422 -8422,8423,8424,8425,8426,8427,8428,8429,8430,8431,8432,8433,8434,8435,8436,8437, # 8438 -8438,8439,8440,8441,8442,8443,8444,8445,8446,8447,8448,8449,8450,8451,8452,8453, # 8454 -8454,8455,8456,8457,8458,8459,8460,8461,8462,8463,8464,8465,8466,8467,8468,8469, # 8470 -8470,8471,8472,8473,8474,8475,8476,8477,8478,8479,8480,8481,8482,8483,8484,8485, # 8486 -8486,8487,8488,8489,8490,8491,8492,8493,8494,8495,8496,8497,8498,8499,8500,8501, # 8502 -8502,8503,8504,8505,8506,8507,8508,8509,8510,8511,8512,8513,8514,8515,8516,8517, # 8518 -8518,8519,8520,8521,8522,8523,8524,8525,8526,8527,8528,8529,8530,8531,8532,8533, # 8534 -8534,8535,8536,8537,8538,8539,8540,8541,8542,8543,8544,8545,8546,8547,8548,8549, # 8550 -8550,8551,8552,8553,8554,8555,8556,8557,8558,8559,8560,8561,8562,8563,8564,8565, # 8566 -8566,8567,8568,8569,8570,8571,8572,8573,8574,8575,8576,8577,8578,8579,8580,8581, # 8582 -8582,8583,8584,8585,8586,8587,8588,8589,8590,8591,8592,8593,8594,8595,8596,8597, # 8598 -8598,8599,8600,8601,8602,8603,8604,8605,8606,8607,8608,8609,8610,8611,8612,8613, # 8614 -8614,8615,8616,8617,8618,8619,8620,8621,8622,8623,8624,8625,8626,8627,8628,8629, # 8630 -8630,8631,8632,8633,8634,8635,8636,8637,8638,8639,8640,8641,8642,8643,8644,8645, # 8646 -8646,8647,8648,8649,8650,8651,8652,8653,8654,8655,8656,8657,8658,8659,8660,8661, # 8662 -8662,8663,8664,8665,8666,8667,8668,8669,8670,8671,8672,8673,8674,8675,8676,8677, # 8678 -8678,8679,8680,8681,8682,8683,8684,8685,8686,8687,8688,8689,8690,8691,8692,8693, # 8694 -8694,8695,8696,8697,8698,8699,8700,8701,8702,8703,8704,8705,8706,8707,8708,8709, # 8710 -8710,8711,8712,8713,8714,8715,8716,8717,8718,8719,8720,8721,8722,8723,8724,8725, # 8726 -8726,8727,8728,8729,8730,8731,8732,8733,8734,8735,8736,8737,8738,8739,8740,8741) # 8742 - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwprober.py deleted file mode 100644 index fe652fe3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/euctwprober.py +++ /dev/null @@ -1,41 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import EUCTWDistributionAnalysis -from .mbcssm import EUCTWSMModel - -class EUCTWProber(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(EUCTWSMModel) - self._mDistributionAnalyzer = EUCTWDistributionAnalysis() - self.reset() - - def get_charset_name(self): - return "EUC-TW" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312freq.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312freq.py deleted file mode 100644 index 1238f510..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312freq.py +++ /dev/null @@ -1,472 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# GB2312 most frequently used character table -# -# Char to FreqOrder table , from hz6763 - -# 512 --> 0.79 -- 0.79 -# 1024 --> 0.92 -- 0.13 -# 2048 --> 0.98 -- 0.06 -# 6768 --> 1.00 -- 0.02 -# -# Ideal Distribution Ratio = 0.79135/(1-0.79135) = 3.79 -# Random Distribution Ration = 512 / (3755 - 512) = 0.157 -# -# Typical Distribution Ratio about 25% of Ideal one, still much higher that RDR - -GB2312_TYPICAL_DISTRIBUTION_RATIO = 0.9 - -GB2312_TABLE_SIZE = 3760 - -GB2312CharToFreqOrder = ( -1671, 749,1443,2364,3924,3807,2330,3921,1704,3463,2691,1511,1515, 572,3191,2205, -2361, 224,2558, 479,1711, 963,3162, 440,4060,1905,2966,2947,3580,2647,3961,3842, -2204, 869,4207, 970,2678,5626,2944,2956,1479,4048, 514,3595, 588,1346,2820,3409, - 249,4088,1746,1873,2047,1774, 581,1813, 358,1174,3590,1014,1561,4844,2245, 670, -1636,3112, 889,1286, 953, 556,2327,3060,1290,3141, 613, 185,3477,1367, 850,3820, -1715,2428,2642,2303,2732,3041,2562,2648,3566,3946,1349, 388,3098,2091,1360,3585, - 152,1687,1539, 738,1559, 59,1232,2925,2267,1388,1249,1741,1679,2960, 151,1566, -1125,1352,4271, 924,4296, 385,3166,4459, 310,1245,2850, 70,3285,2729,3534,3575, -2398,3298,3466,1960,2265, 217,3647, 864,1909,2084,4401,2773,1010,3269,5152, 853, -3051,3121,1244,4251,1895, 364,1499,1540,2313,1180,3655,2268, 562, 715,2417,3061, - 544, 336,3768,2380,1752,4075, 950, 280,2425,4382, 183,2759,3272, 333,4297,2155, -1688,2356,1444,1039,4540, 736,1177,3349,2443,2368,2144,2225, 565, 196,1482,3406, - 927,1335,4147, 692, 878,1311,1653,3911,3622,1378,4200,1840,2969,3149,2126,1816, -2534,1546,2393,2760, 737,2494, 13, 447, 245,2747, 38,2765,2129,2589,1079, 606, - 360, 471,3755,2890, 404, 848, 699,1785,1236, 370,2221,1023,3746,2074,2026,2023, -2388,1581,2119, 812,1141,3091,2536,1519, 804,2053, 406,1596,1090, 784, 548,4414, -1806,2264,2936,1100, 343,4114,5096, 622,3358, 743,3668,1510,1626,5020,3567,2513, -3195,4115,5627,2489,2991, 24,2065,2697,1087,2719, 48,1634, 315, 68, 985,2052, - 198,2239,1347,1107,1439, 597,2366,2172, 871,3307, 919,2487,2790,1867, 236,2570, -1413,3794, 906,3365,3381,1701,1982,1818,1524,2924,1205, 616,2586,2072,2004, 575, - 253,3099, 32,1365,1182, 197,1714,2454,1201, 554,3388,3224,2748, 756,2587, 250, -2567,1507,1517,3529,1922,2761,2337,3416,1961,1677,2452,2238,3153, 615, 911,1506, -1474,2495,1265,1906,2749,3756,3280,2161, 898,2714,1759,3450,2243,2444, 563, 26, -3286,2266,3769,3344,2707,3677, 611,1402, 531,1028,2871,4548,1375, 261,2948, 835, -1190,4134, 353, 840,2684,1900,3082,1435,2109,1207,1674, 329,1872,2781,4055,2686, -2104, 608,3318,2423,2957,2768,1108,3739,3512,3271,3985,2203,1771,3520,1418,2054, -1681,1153, 225,1627,2929, 162,2050,2511,3687,1954, 124,1859,2431,1684,3032,2894, - 585,4805,3969,2869,2704,2088,2032,2095,3656,2635,4362,2209, 256, 518,2042,2105, -3777,3657, 643,2298,1148,1779, 190, 989,3544, 414, 11,2135,2063,2979,1471, 403, -3678, 126, 770,1563, 671,2499,3216,2877, 600,1179, 307,2805,4937,1268,1297,2694, - 252,4032,1448,1494,1331,1394, 127,2256, 222,1647,1035,1481,3056,1915,1048, 873, -3651, 210, 33,1608,2516, 200,1520, 415, 102, 0,3389,1287, 817, 91,3299,2940, - 836,1814, 549,2197,1396,1669,2987,3582,2297,2848,4528,1070, 687, 20,1819, 121, -1552,1364,1461,1968,2617,3540,2824,2083, 177, 948,4938,2291, 110,4549,2066, 648, -3359,1755,2110,2114,4642,4845,1693,3937,3308,1257,1869,2123, 208,1804,3159,2992, -2531,2549,3361,2418,1350,2347,2800,2568,1291,2036,2680, 72, 842,1990, 212,1233, -1154,1586, 75,2027,3410,4900,1823,1337,2710,2676, 728,2810,1522,3026,4995, 157, - 755,1050,4022, 710, 785,1936,2194,2085,1406,2777,2400, 150,1250,4049,1206, 807, -1910, 534, 529,3309,1721,1660, 274, 39,2827, 661,2670,1578, 925,3248,3815,1094, -4278,4901,4252, 41,1150,3747,2572,2227,4501,3658,4902,3813,3357,3617,2884,2258, - 887, 538,4187,3199,1294,2439,3042,2329,2343,2497,1255, 107, 543,1527, 521,3478, -3568, 194,5062, 15, 961,3870,1241,1192,2664, 66,5215,3260,2111,1295,1127,2152, -3805,4135, 901,1164,1976, 398,1278, 530,1460, 748, 904,1054,1966,1426, 53,2909, - 509, 523,2279,1534, 536,1019, 239,1685, 460,2353, 673,1065,2401,3600,4298,2272, -1272,2363, 284,1753,3679,4064,1695, 81, 815,2677,2757,2731,1386, 859, 500,4221, -2190,2566, 757,1006,2519,2068,1166,1455, 337,2654,3203,1863,1682,1914,3025,1252, -1409,1366, 847, 714,2834,2038,3209, 964,2970,1901, 885,2553,1078,1756,3049, 301, -1572,3326, 688,2130,1996,2429,1805,1648,2930,3421,2750,3652,3088, 262,1158,1254, - 389,1641,1812, 526,1719, 923,2073,1073,1902, 468, 489,4625,1140, 857,2375,3070, -3319,2863, 380, 116,1328,2693,1161,2244, 273,1212,1884,2769,3011,1775,1142, 461, -3066,1200,2147,2212, 790, 702,2695,4222,1601,1058, 434,2338,5153,3640, 67,2360, -4099,2502, 618,3472,1329, 416,1132, 830,2782,1807,2653,3211,3510,1662, 192,2124, - 296,3979,1739,1611,3684, 23, 118, 324, 446,1239,1225, 293,2520,3814,3795,2535, -3116, 17,1074, 467,2692,2201, 387,2922, 45,1326,3055,1645,3659,2817, 958, 243, -1903,2320,1339,2825,1784,3289, 356, 576, 865,2315,2381,3377,3916,1088,3122,1713, -1655, 935, 628,4689,1034,1327, 441, 800, 720, 894,1979,2183,1528,5289,2702,1071, -4046,3572,2399,1571,3281, 79, 761,1103, 327, 134, 758,1899,1371,1615, 879, 442, - 215,2605,2579, 173,2048,2485,1057,2975,3317,1097,2253,3801,4263,1403,1650,2946, - 814,4968,3487,1548,2644,1567,1285, 2, 295,2636, 97, 946,3576, 832, 141,4257, -3273, 760,3821,3521,3156,2607, 949,1024,1733,1516,1803,1920,2125,2283,2665,3180, -1501,2064,3560,2171,1592, 803,3518,1416, 732,3897,4258,1363,1362,2458, 119,1427, - 602,1525,2608,1605,1639,3175, 694,3064, 10, 465, 76,2000,4846,4208, 444,3781, -1619,3353,2206,1273,3796, 740,2483, 320,1723,2377,3660,2619,1359,1137,1762,1724, -2345,2842,1850,1862, 912, 821,1866, 612,2625,1735,2573,3369,1093, 844, 89, 937, - 930,1424,3564,2413,2972,1004,3046,3019,2011, 711,3171,1452,4178, 428, 801,1943, - 432, 445,2811, 206,4136,1472, 730, 349, 73, 397,2802,2547, 998,1637,1167, 789, - 396,3217, 154,1218, 716,1120,1780,2819,4826,1931,3334,3762,2139,1215,2627, 552, -3664,3628,3232,1405,2383,3111,1356,2652,3577,3320,3101,1703, 640,1045,1370,1246, -4996, 371,1575,2436,1621,2210, 984,4033,1734,2638, 16,4529, 663,2755,3255,1451, -3917,2257,1253,1955,2234,1263,2951, 214,1229, 617, 485, 359,1831,1969, 473,2310, - 750,2058, 165, 80,2864,2419, 361,4344,2416,2479,1134, 796,3726,1266,2943, 860, -2715, 938, 390,2734,1313,1384, 248, 202, 877,1064,2854, 522,3907, 279,1602, 297, -2357, 395,3740, 137,2075, 944,4089,2584,1267,3802, 62,1533,2285, 178, 176, 780, -2440, 201,3707, 590, 478,1560,4354,2117,1075, 30, 74,4643,4004,1635,1441,2745, - 776,2596, 238,1077,1692,1912,2844, 605, 499,1742,3947, 241,3053, 980,1749, 936, -2640,4511,2582, 515,1543,2162,5322,2892,2993, 890,2148,1924, 665,1827,3581,1032, - 968,3163, 339,1044,1896, 270, 583,1791,1720,4367,1194,3488,3669, 43,2523,1657, - 163,2167, 290,1209,1622,3378, 550, 634,2508,2510, 695,2634,2384,2512,1476,1414, - 220,1469,2341,2138,2852,3183,2900,4939,2865,3502,1211,3680, 854,3227,1299,2976, -3172, 186,2998,1459, 443,1067,3251,1495, 321,1932,3054, 909, 753,1410,1828, 436, -2441,1119,1587,3164,2186,1258, 227, 231,1425,1890,3200,3942, 247, 959, 725,5254, -2741, 577,2158,2079, 929, 120, 174, 838,2813, 591,1115, 417,2024, 40,3240,1536, -1037, 291,4151,2354, 632,1298,2406,2500,3535,1825,1846,3451, 205,1171, 345,4238, - 18,1163, 811, 685,2208,1217, 425,1312,1508,1175,4308,2552,1033, 587,1381,3059, -2984,3482, 340,1316,4023,3972, 792,3176, 519, 777,4690, 918, 933,4130,2981,3741, - 90,3360,2911,2200,5184,4550, 609,3079,2030, 272,3379,2736, 363,3881,1130,1447, - 286, 779, 357,1169,3350,3137,1630,1220,2687,2391, 747,1277,3688,2618,2682,2601, -1156,3196,5290,4034,3102,1689,3596,3128, 874, 219,2783, 798, 508,1843,2461, 269, -1658,1776,1392,1913,2983,3287,2866,2159,2372, 829,4076, 46,4253,2873,1889,1894, - 915,1834,1631,2181,2318, 298, 664,2818,3555,2735, 954,3228,3117, 527,3511,2173, - 681,2712,3033,2247,2346,3467,1652, 155,2164,3382, 113,1994, 450, 899, 494, 994, -1237,2958,1875,2336,1926,3727, 545,1577,1550, 633,3473, 204,1305,3072,2410,1956, -2471, 707,2134, 841,2195,2196,2663,3843,1026,4940, 990,3252,4997, 368,1092, 437, -3212,3258,1933,1829, 675,2977,2893, 412, 943,3723,4644,3294,3283,2230,2373,5154, -2389,2241,2661,2323,1404,2524, 593, 787, 677,3008,1275,2059, 438,2709,2609,2240, -2269,2246,1446, 36,1568,1373,3892,1574,2301,1456,3962, 693,2276,5216,2035,1143, -2720,1919,1797,1811,2763,4137,2597,1830,1699,1488,1198,2090, 424,1694, 312,3634, -3390,4179,3335,2252,1214, 561,1059,3243,2295,2561, 975,5155,2321,2751,3772, 472, -1537,3282,3398,1047,2077,2348,2878,1323,3340,3076, 690,2906, 51, 369, 170,3541, -1060,2187,2688,3670,2541,1083,1683, 928,3918, 459, 109,4427, 599,3744,4286, 143, -2101,2730,2490, 82,1588,3036,2121, 281,1860, 477,4035,1238,2812,3020,2716,3312, -1530,2188,2055,1317, 843, 636,1808,1173,3495, 649, 181,1002, 147,3641,1159,2414, -3750,2289,2795, 813,3123,2610,1136,4368, 5,3391,4541,2174, 420, 429,1728, 754, -1228,2115,2219, 347,2223,2733, 735,1518,3003,2355,3134,1764,3948,3329,1888,2424, -1001,1234,1972,3321,3363,1672,1021,1450,1584, 226, 765, 655,2526,3404,3244,2302, -3665, 731, 594,2184, 319,1576, 621, 658,2656,4299,2099,3864,1279,2071,2598,2739, - 795,3086,3699,3908,1707,2352,2402,1382,3136,2475,1465,4847,3496,3865,1085,3004, -2591,1084, 213,2287,1963,3565,2250, 822, 793,4574,3187,1772,1789,3050, 595,1484, -1959,2770,1080,2650, 456, 422,2996, 940,3322,4328,4345,3092,2742, 965,2784, 739, -4124, 952,1358,2498,2949,2565, 332,2698,2378, 660,2260,2473,4194,3856,2919, 535, -1260,2651,1208,1428,1300,1949,1303,2942, 433,2455,2450,1251,1946, 614,1269, 641, -1306,1810,2737,3078,2912, 564,2365,1419,1415,1497,4460,2367,2185,1379,3005,1307, -3218,2175,1897,3063, 682,1157,4040,4005,1712,1160,1941,1399, 394, 402,2952,1573, -1151,2986,2404, 862, 299,2033,1489,3006, 346, 171,2886,3401,1726,2932, 168,2533, - 47,2507,1030,3735,1145,3370,1395,1318,1579,3609,4560,2857,4116,1457,2529,1965, - 504,1036,2690,2988,2405, 745,5871, 849,2397,2056,3081, 863,2359,3857,2096, 99, -1397,1769,2300,4428,1643,3455,1978,1757,3718,1440, 35,4879,3742,1296,4228,2280, - 160,5063,1599,2013, 166, 520,3479,1646,3345,3012, 490,1937,1545,1264,2182,2505, -1096,1188,1369,1436,2421,1667,2792,2460,1270,2122, 727,3167,2143, 806,1706,1012, -1800,3037, 960,2218,1882, 805, 139,2456,1139,1521, 851,1052,3093,3089, 342,2039, - 744,5097,1468,1502,1585,2087, 223, 939, 326,2140,2577, 892,2481,1623,4077, 982, -3708, 135,2131, 87,2503,3114,2326,1106, 876,1616, 547,2997,2831,2093,3441,4530, -4314, 9,3256,4229,4148, 659,1462,1986,1710,2046,2913,2231,4090,4880,5255,3392, -3274,1368,3689,4645,1477, 705,3384,3635,1068,1529,2941,1458,3782,1509, 100,1656, -2548, 718,2339, 408,1590,2780,3548,1838,4117,3719,1345,3530, 717,3442,2778,3220, -2898,1892,4590,3614,3371,2043,1998,1224,3483, 891, 635, 584,2559,3355, 733,1766, -1729,1172,3789,1891,2307, 781,2982,2271,1957,1580,5773,2633,2005,4195,3097,1535, -3213,1189,1934,5693,3262, 586,3118,1324,1598, 517,1564,2217,1868,1893,4445,3728, -2703,3139,1526,1787,1992,3882,2875,1549,1199,1056,2224,1904,2711,5098,4287, 338, -1993,3129,3489,2689,1809,2815,1997, 957,1855,3898,2550,3275,3057,1105,1319, 627, -1505,1911,1883,3526, 698,3629,3456,1833,1431, 746, 77,1261,2017,2296,1977,1885, - 125,1334,1600, 525,1798,1109,2222,1470,1945, 559,2236,1186,3443,2476,1929,1411, -2411,3135,1777,3372,2621,1841,1613,3229, 668,1430,1839,2643,2916, 195,1989,2671, -2358,1387, 629,3205,2293,5256,4439, 123,1310, 888,1879,4300,3021,3605,1003,1162, -3192,2910,2010, 140,2395,2859, 55,1082,2012,2901, 662, 419,2081,1438, 680,2774, -4654,3912,1620,1731,1625,5035,4065,2328, 512,1344, 802,5443,2163,2311,2537, 524, -3399, 98,1155,2103,1918,2606,3925,2816,1393,2465,1504,3773,2177,3963,1478,4346, - 180,1113,4655,3461,2028,1698, 833,2696,1235,1322,1594,4408,3623,3013,3225,2040, -3022, 541,2881, 607,3632,2029,1665,1219, 639,1385,1686,1099,2803,3231,1938,3188, -2858, 427, 676,2772,1168,2025, 454,3253,2486,3556, 230,1950, 580, 791,1991,1280, -1086,1974,2034, 630, 257,3338,2788,4903,1017, 86,4790, 966,2789,1995,1696,1131, - 259,3095,4188,1308, 179,1463,5257, 289,4107,1248, 42,3413,1725,2288, 896,1947, - 774,4474,4254, 604,3430,4264, 392,2514,2588, 452, 237,1408,3018, 988,4531,1970, -3034,3310, 540,2370,1562,1288,2990, 502,4765,1147, 4,1853,2708, 207, 294,2814, -4078,2902,2509, 684, 34,3105,3532,2551, 644, 709,2801,2344, 573,1727,3573,3557, -2021,1081,3100,4315,2100,3681, 199,2263,1837,2385, 146,3484,1195,2776,3949, 997, -1939,3973,1008,1091,1202,1962,1847,1149,4209,5444,1076, 493, 117,5400,2521, 972, -1490,2934,1796,4542,2374,1512,2933,2657, 413,2888,1135,2762,2314,2156,1355,2369, - 766,2007,2527,2170,3124,2491,2593,2632,4757,2437, 234,3125,3591,1898,1750,1376, -1942,3468,3138, 570,2127,2145,3276,4131, 962, 132,1445,4196, 19, 941,3624,3480, -3366,1973,1374,4461,3431,2629, 283,2415,2275, 808,2887,3620,2112,2563,1353,3610, - 955,1089,3103,1053, 96, 88,4097, 823,3808,1583, 399, 292,4091,3313, 421,1128, - 642,4006, 903,2539,1877,2082, 596, 29,4066,1790, 722,2157, 130, 995,1569, 769, -1485, 464, 513,2213, 288,1923,1101,2453,4316, 133, 486,2445, 50, 625, 487,2207, - 57, 423, 481,2962, 159,3729,1558, 491, 303, 482, 501, 240,2837, 112,3648,2392, -1783, 362, 8,3433,3422, 610,2793,3277,1390,1284,1654, 21,3823, 734, 367, 623, - 193, 287, 374,1009,1483, 816, 476, 313,2255,2340,1262,2150,2899,1146,2581, 782, -2116,1659,2018,1880, 255,3586,3314,1110,2867,2137,2564, 986,2767,5185,2006, 650, - 158, 926, 762, 881,3157,2717,2362,3587, 306,3690,3245,1542,3077,2427,1691,2478, -2118,2985,3490,2438, 539,2305, 983, 129,1754, 355,4201,2386, 827,2923, 104,1773, -2838,2771, 411,2905,3919, 376, 767, 122,1114, 828,2422,1817,3506, 266,3460,1007, -1609,4998, 945,2612,4429,2274, 726,1247,1964,2914,2199,2070,4002,4108, 657,3323, -1422, 579, 455,2764,4737,1222,2895,1670, 824,1223,1487,2525, 558, 861,3080, 598, -2659,2515,1967, 752,2583,2376,2214,4180, 977, 704,2464,4999,2622,4109,1210,2961, - 819,1541, 142,2284, 44, 418, 457,1126,3730,4347,4626,1644,1876,3671,1864, 302, -1063,5694, 624, 723,1984,3745,1314,1676,2488,1610,1449,3558,3569,2166,2098, 409, -1011,2325,3704,2306, 818,1732,1383,1824,1844,3757, 999,2705,3497,1216,1423,2683, -2426,2954,2501,2726,2229,1475,2554,5064,1971,1794,1666,2014,1343, 783, 724, 191, -2434,1354,2220,5065,1763,2752,2472,4152, 131, 175,2885,3434, 92,1466,4920,2616, -3871,3872,3866, 128,1551,1632, 669,1854,3682,4691,4125,1230, 188,2973,3290,1302, -1213, 560,3266, 917, 763,3909,3249,1760, 868,1958, 764,1782,2097, 145,2277,3774, -4462, 64,1491,3062, 971,2132,3606,2442, 221,1226,1617, 218, 323,1185,3207,3147, - 571, 619,1473,1005,1744,2281, 449,1887,2396,3685, 275, 375,3816,1743,3844,3731, - 845,1983,2350,4210,1377, 773, 967,3499,3052,3743,2725,4007,1697,1022,3943,1464, -3264,2855,2722,1952,1029,2839,2467, 84,4383,2215, 820,1391,2015,2448,3672, 377, -1948,2168, 797,2545,3536,2578,2645, 94,2874,1678, 405,1259,3071, 771, 546,1315, - 470,1243,3083, 895,2468, 981, 969,2037, 846,4181, 653,1276,2928, 14,2594, 557, -3007,2474, 156, 902,1338,1740,2574, 537,2518, 973,2282,2216,2433,1928, 138,2903, -1293,2631,1612, 646,3457, 839,2935, 111, 496,2191,2847, 589,3186, 149,3994,2060, -4031,2641,4067,3145,1870, 37,3597,2136,1025,2051,3009,3383,3549,1121,1016,3261, -1301, 251,2446,2599,2153, 872,3246, 637, 334,3705, 831, 884, 921,3065,3140,4092, -2198,1944, 246,2964, 108,2045,1152,1921,2308,1031, 203,3173,4170,1907,3890, 810, -1401,2003,1690, 506, 647,1242,2828,1761,1649,3208,2249,1589,3709,2931,5156,1708, - 498, 666,2613, 834,3817,1231, 184,2851,1124, 883,3197,2261,3710,1765,1553,2658, -1178,2639,2351, 93,1193, 942,2538,2141,4402, 235,1821, 870,1591,2192,1709,1871, -3341,1618,4126,2595,2334, 603, 651, 69, 701, 268,2662,3411,2555,1380,1606, 503, - 448, 254,2371,2646, 574,1187,2309,1770, 322,2235,1292,1801, 305, 566,1133, 229, -2067,2057, 706, 167, 483,2002,2672,3295,1820,3561,3067, 316, 378,2746,3452,1112, - 136,1981, 507,1651,2917,1117, 285,4591, 182,2580,3522,1304, 335,3303,1835,2504, -1795,1792,2248, 674,1018,2106,2449,1857,2292,2845, 976,3047,1781,2600,2727,1389, -1281, 52,3152, 153, 265,3950, 672,3485,3951,4463, 430,1183, 365, 278,2169, 27, -1407,1336,2304, 209,1340,1730,2202,1852,2403,2883, 979,1737,1062, 631,2829,2542, -3876,2592, 825,2086,2226,3048,3625, 352,1417,3724, 542, 991, 431,1351,3938,1861, -2294, 826,1361,2927,3142,3503,1738, 463,2462,2723, 582,1916,1595,2808, 400,3845, -3891,2868,3621,2254, 58,2492,1123, 910,2160,2614,1372,1603,1196,1072,3385,1700, -3267,1980, 696, 480,2430, 920, 799,1570,2920,1951,2041,4047,2540,1321,4223,2469, -3562,2228,1271,2602, 401,2833,3351,2575,5157, 907,2312,1256, 410, 263,3507,1582, - 996, 678,1849,2316,1480, 908,3545,2237, 703,2322, 667,1826,2849,1531,2604,2999, -2407,3146,2151,2630,1786,3711, 469,3542, 497,3899,2409, 858, 837,4446,3393,1274, - 786, 620,1845,2001,3311, 484, 308,3367,1204,1815,3691,2332,1532,2557,1842,2020, -2724,1927,2333,4440, 567, 22,1673,2728,4475,1987,1858,1144,1597, 101,1832,3601, - 12, 974,3783,4391, 951,1412, 1,3720, 453,4608,4041, 528,1041,1027,3230,2628, -1129, 875,1051,3291,1203,2262,1069,2860,2799,2149,2615,3278, 144,1758,3040, 31, - 475,1680, 366,2685,3184, 311,1642,4008,2466,5036,1593,1493,2809, 216,1420,1668, - 233, 304,2128,3284, 232,1429,1768,1040,2008,3407,2740,2967,2543, 242,2133, 778, -1565,2022,2620, 505,2189,2756,1098,2273, 372,1614, 708, 553,2846,2094,2278, 169, -3626,2835,4161, 228,2674,3165, 809,1454,1309, 466,1705,1095, 900,3423, 880,2667, -3751,5258,2317,3109,2571,4317,2766,1503,1342, 866,4447,1118, 63,2076, 314,1881, -1348,1061, 172, 978,3515,1747, 532, 511,3970, 6, 601, 905,2699,3300,1751, 276, -1467,3725,2668, 65,4239,2544,2779,2556,1604, 578,2451,1802, 992,2331,2624,1320, -3446, 713,1513,1013, 103,2786,2447,1661, 886,1702, 916, 654,3574,2031,1556, 751, -2178,2821,2179,1498,1538,2176, 271, 914,2251,2080,1325, 638,1953,2937,3877,2432, -2754, 95,3265,1716, 260,1227,4083, 775, 106,1357,3254, 426,1607, 555,2480, 772, -1985, 244,2546, 474, 495,1046,2611,1851,2061, 71,2089,1675,2590, 742,3758,2843, -3222,1433, 267,2180,2576,2826,2233,2092,3913,2435, 956,1745,3075, 856,2113,1116, - 451, 3,1988,2896,1398, 993,2463,1878,2049,1341,2718,2721,2870,2108, 712,2904, -4363,2753,2324, 277,2872,2349,2649, 384, 987, 435, 691,3000, 922, 164,3939, 652, -1500,1184,4153,2482,3373,2165,4848,2335,3775,3508,3154,2806,2830,1554,2102,1664, -2530,1434,2408, 893,1547,2623,3447,2832,2242,2532,3169,2856,3223,2078, 49,3770, -3469, 462, 318, 656,2259,3250,3069, 679,1629,2758, 344,1138,1104,3120,1836,1283, -3115,2154,1437,4448, 934, 759,1999, 794,2862,1038, 533,2560,1722,2342, 855,2626, -1197,1663,4476,3127, 85,4240,2528, 25,1111,1181,3673, 407,3470,4561,2679,2713, - 768,1925,2841,3986,1544,1165, 932, 373,1240,2146,1930,2673, 721,4766, 354,4333, - 391,2963, 187, 61,3364,1442,1102, 330,1940,1767, 341,3809,4118, 393,2496,2062, -2211, 105, 331, 300, 439, 913,1332, 626, 379,3304,1557, 328, 689,3952, 309,1555, - 931, 317,2517,3027, 325, 569, 686,2107,3084, 60,1042,1333,2794, 264,3177,4014, -1628, 258,3712, 7,4464,1176,1043,1778, 683, 114,1975, 78,1492, 383,1886, 510, - 386, 645,5291,2891,2069,3305,4138,3867,2939,2603,2493,1935,1066,1848,3588,1015, -1282,1289,4609, 697,1453,3044,2666,3611,1856,2412, 54, 719,1330, 568,3778,2459, -1748, 788, 492, 551,1191,1000, 488,3394,3763, 282,1799, 348,2016,1523,3155,2390, -1049, 382,2019,1788,1170, 729,2968,3523, 897,3926,2785,2938,3292, 350,2319,3238, -1718,1717,2655,3453,3143,4465, 161,2889,2980,2009,1421, 56,1908,1640,2387,2232, -1917,1874,2477,4921, 148, 83,3438, 592,4245,2882,1822,1055, 741, 115,1496,1624, - 381,1638,4592,1020, 516,3214, 458, 947,4575,1432, 211,1514,2926,1865,2142, 189, - 852,1221,1400,1486, 882,2299,4036, 351, 28,1122, 700,6479,6480,6481,6482,6483, # last 512 -#Everything below is of no interest for detection purpose -5508,6484,3900,3414,3974,4441,4024,3537,4037,5628,5099,3633,6485,3148,6486,3636, -5509,3257,5510,5973,5445,5872,4941,4403,3174,4627,5873,6276,2286,4230,5446,5874, -5122,6102,6103,4162,5447,5123,5323,4849,6277,3980,3851,5066,4246,5774,5067,6278, -3001,2807,5695,3346,5775,5974,5158,5448,6487,5975,5976,5776,3598,6279,5696,4806, -4211,4154,6280,6488,6489,6490,6281,4212,5037,3374,4171,6491,4562,4807,4722,4827, -5977,6104,4532,4079,5159,5324,5160,4404,3858,5359,5875,3975,4288,4610,3486,4512, -5325,3893,5360,6282,6283,5560,2522,4231,5978,5186,5449,2569,3878,6284,5401,3578, -4415,6285,4656,5124,5979,2506,4247,4449,3219,3417,4334,4969,4329,6492,4576,4828, -4172,4416,4829,5402,6286,3927,3852,5361,4369,4830,4477,4867,5876,4173,6493,6105, -4657,6287,6106,5877,5450,6494,4155,4868,5451,3700,5629,4384,6288,6289,5878,3189, -4881,6107,6290,6495,4513,6496,4692,4515,4723,5100,3356,6497,6291,3810,4080,5561, -3570,4430,5980,6498,4355,5697,6499,4724,6108,6109,3764,4050,5038,5879,4093,3226, -6292,5068,5217,4693,3342,5630,3504,4831,4377,4466,4309,5698,4431,5777,6293,5778, -4272,3706,6110,5326,3752,4676,5327,4273,5403,4767,5631,6500,5699,5880,3475,5039, -6294,5562,5125,4348,4301,4482,4068,5126,4593,5700,3380,3462,5981,5563,3824,5404, -4970,5511,3825,4738,6295,6501,5452,4516,6111,5881,5564,6502,6296,5982,6503,4213, -4163,3454,6504,6112,4009,4450,6113,4658,6297,6114,3035,6505,6115,3995,4904,4739, -4563,4942,4110,5040,3661,3928,5362,3674,6506,5292,3612,4791,5565,4149,5983,5328, -5259,5021,4725,4577,4564,4517,4364,6298,5405,4578,5260,4594,4156,4157,5453,3592, -3491,6507,5127,5512,4709,4922,5984,5701,4726,4289,6508,4015,6116,5128,4628,3424, -4241,5779,6299,4905,6509,6510,5454,5702,5780,6300,4365,4923,3971,6511,5161,3270, -3158,5985,4100, 867,5129,5703,6117,5363,3695,3301,5513,4467,6118,6512,5455,4232, -4242,4629,6513,3959,4478,6514,5514,5329,5986,4850,5162,5566,3846,4694,6119,5456, -4869,5781,3779,6301,5704,5987,5515,4710,6302,5882,6120,4392,5364,5705,6515,6121, -6516,6517,3736,5988,5457,5989,4695,2457,5883,4551,5782,6303,6304,6305,5130,4971, -6122,5163,6123,4870,3263,5365,3150,4871,6518,6306,5783,5069,5706,3513,3498,4409, -5330,5632,5366,5458,5459,3991,5990,4502,3324,5991,5784,3696,4518,5633,4119,6519, -4630,5634,4417,5707,4832,5992,3418,6124,5993,5567,4768,5218,6520,4595,3458,5367, -6125,5635,6126,4202,6521,4740,4924,6307,3981,4069,4385,6308,3883,2675,4051,3834, -4302,4483,5568,5994,4972,4101,5368,6309,5164,5884,3922,6127,6522,6523,5261,5460, -5187,4164,5219,3538,5516,4111,3524,5995,6310,6311,5369,3181,3386,2484,5188,3464, -5569,3627,5708,6524,5406,5165,4677,4492,6312,4872,4851,5885,4468,5996,6313,5709, -5710,6128,2470,5886,6314,5293,4882,5785,3325,5461,5101,6129,5711,5786,6525,4906, -6526,6527,4418,5887,5712,4808,2907,3701,5713,5888,6528,3765,5636,5331,6529,6530, -3593,5889,3637,4943,3692,5714,5787,4925,6315,6130,5462,4405,6131,6132,6316,5262, -6531,6532,5715,3859,5716,5070,4696,5102,3929,5788,3987,4792,5997,6533,6534,3920, -4809,5000,5998,6535,2974,5370,6317,5189,5263,5717,3826,6536,3953,5001,4883,3190, -5463,5890,4973,5999,4741,6133,6134,3607,5570,6000,4711,3362,3630,4552,5041,6318, -6001,2950,2953,5637,4646,5371,4944,6002,2044,4120,3429,6319,6537,5103,4833,6538, -6539,4884,4647,3884,6003,6004,4758,3835,5220,5789,4565,5407,6540,6135,5294,4697, -4852,6320,6321,3206,4907,6541,6322,4945,6542,6136,6543,6323,6005,4631,3519,6544, -5891,6545,5464,3784,5221,6546,5571,4659,6547,6324,6137,5190,6548,3853,6549,4016, -4834,3954,6138,5332,3827,4017,3210,3546,4469,5408,5718,3505,4648,5790,5131,5638, -5791,5465,4727,4318,6325,6326,5792,4553,4010,4698,3439,4974,3638,4335,3085,6006, -5104,5042,5166,5892,5572,6327,4356,4519,5222,5573,5333,5793,5043,6550,5639,5071, -4503,6328,6139,6551,6140,3914,3901,5372,6007,5640,4728,4793,3976,3836,4885,6552, -4127,6553,4451,4102,5002,6554,3686,5105,6555,5191,5072,5295,4611,5794,5296,6556, -5893,5264,5894,4975,5466,5265,4699,4976,4370,4056,3492,5044,4886,6557,5795,4432, -4769,4357,5467,3940,4660,4290,6141,4484,4770,4661,3992,6329,4025,4662,5022,4632, -4835,4070,5297,4663,4596,5574,5132,5409,5895,6142,4504,5192,4664,5796,5896,3885, -5575,5797,5023,4810,5798,3732,5223,4712,5298,4084,5334,5468,6143,4052,4053,4336, -4977,4794,6558,5335,4908,5576,5224,4233,5024,4128,5469,5225,4873,6008,5045,4729, -4742,4633,3675,4597,6559,5897,5133,5577,5003,5641,5719,6330,6560,3017,2382,3854, -4406,4811,6331,4393,3964,4946,6561,2420,3722,6562,4926,4378,3247,1736,4442,6332, -5134,6333,5226,3996,2918,5470,4319,4003,4598,4743,4744,4485,3785,3902,5167,5004, -5373,4394,5898,6144,4874,1793,3997,6334,4085,4214,5106,5642,4909,5799,6009,4419, -4189,3330,5899,4165,4420,5299,5720,5227,3347,6145,4081,6335,2876,3930,6146,3293, -3786,3910,3998,5900,5300,5578,2840,6563,5901,5579,6147,3531,5374,6564,6565,5580, -4759,5375,6566,6148,3559,5643,6336,6010,5517,6337,6338,5721,5902,3873,6011,6339, -6567,5518,3868,3649,5722,6568,4771,4947,6569,6149,4812,6570,2853,5471,6340,6341, -5644,4795,6342,6012,5723,6343,5724,6013,4349,6344,3160,6150,5193,4599,4514,4493, -5168,4320,6345,4927,3666,4745,5169,5903,5005,4928,6346,5725,6014,4730,4203,5046, -4948,3395,5170,6015,4150,6016,5726,5519,6347,5047,3550,6151,6348,4197,4310,5904, -6571,5581,2965,6152,4978,3960,4291,5135,6572,5301,5727,4129,4026,5905,4853,5728, -5472,6153,6349,4533,2700,4505,5336,4678,3583,5073,2994,4486,3043,4554,5520,6350, -6017,5800,4487,6351,3931,4103,5376,6352,4011,4321,4311,4190,5136,6018,3988,3233, -4350,5906,5645,4198,6573,5107,3432,4191,3435,5582,6574,4139,5410,6353,5411,3944, -5583,5074,3198,6575,6354,4358,6576,5302,4600,5584,5194,5412,6577,6578,5585,5413, -5303,4248,5414,3879,4433,6579,4479,5025,4854,5415,6355,4760,4772,3683,2978,4700, -3797,4452,3965,3932,3721,4910,5801,6580,5195,3551,5907,3221,3471,3029,6019,3999, -5908,5909,5266,5267,3444,3023,3828,3170,4796,5646,4979,4259,6356,5647,5337,3694, -6357,5648,5338,4520,4322,5802,3031,3759,4071,6020,5586,4836,4386,5048,6581,3571, -4679,4174,4949,6154,4813,3787,3402,3822,3958,3215,3552,5268,4387,3933,4950,4359, -6021,5910,5075,3579,6358,4234,4566,5521,6359,3613,5049,6022,5911,3375,3702,3178, -4911,5339,4521,6582,6583,4395,3087,3811,5377,6023,6360,6155,4027,5171,5649,4421, -4249,2804,6584,2270,6585,4000,4235,3045,6156,5137,5729,4140,4312,3886,6361,4330, -6157,4215,6158,3500,3676,4929,4331,3713,4930,5912,4265,3776,3368,5587,4470,4855, -3038,4980,3631,6159,6160,4132,4680,6161,6362,3923,4379,5588,4255,6586,4121,6587, -6363,4649,6364,3288,4773,4774,6162,6024,6365,3543,6588,4274,3107,3737,5050,5803, -4797,4522,5589,5051,5730,3714,4887,5378,4001,4523,6163,5026,5522,4701,4175,2791, -3760,6589,5473,4224,4133,3847,4814,4815,4775,3259,5416,6590,2738,6164,6025,5304, -3733,5076,5650,4816,5590,6591,6165,6592,3934,5269,6593,3396,5340,6594,5804,3445, -3602,4042,4488,5731,5732,3525,5591,4601,5196,6166,6026,5172,3642,4612,3202,4506, -4798,6366,3818,5108,4303,5138,5139,4776,3332,4304,2915,3415,4434,5077,5109,4856, -2879,5305,4817,6595,5913,3104,3144,3903,4634,5341,3133,5110,5651,5805,6167,4057, -5592,2945,4371,5593,6596,3474,4182,6367,6597,6168,4507,4279,6598,2822,6599,4777, -4713,5594,3829,6169,3887,5417,6170,3653,5474,6368,4216,2971,5228,3790,4579,6369, -5733,6600,6601,4951,4746,4555,6602,5418,5475,6027,3400,4665,5806,6171,4799,6028, -5052,6172,3343,4800,4747,5006,6370,4556,4217,5476,4396,5229,5379,5477,3839,5914, -5652,5807,4714,3068,4635,5808,6173,5342,4192,5078,5419,5523,5734,6174,4557,6175, -4602,6371,6176,6603,5809,6372,5735,4260,3869,5111,5230,6029,5112,6177,3126,4681, -5524,5915,2706,3563,4748,3130,6178,4018,5525,6604,6605,5478,4012,4837,6606,4534, -4193,5810,4857,3615,5479,6030,4082,3697,3539,4086,5270,3662,4508,4931,5916,4912, -5811,5027,3888,6607,4397,3527,3302,3798,2775,2921,2637,3966,4122,4388,4028,4054, -1633,4858,5079,3024,5007,3982,3412,5736,6608,3426,3236,5595,3030,6179,3427,3336, -3279,3110,6373,3874,3039,5080,5917,5140,4489,3119,6374,5812,3405,4494,6031,4666, -4141,6180,4166,6032,5813,4981,6609,5081,4422,4982,4112,3915,5653,3296,3983,6375, -4266,4410,5654,6610,6181,3436,5082,6611,5380,6033,3819,5596,4535,5231,5306,5113, -6612,4952,5918,4275,3113,6613,6376,6182,6183,5814,3073,4731,4838,5008,3831,6614, -4888,3090,3848,4280,5526,5232,3014,5655,5009,5737,5420,5527,6615,5815,5343,5173, -5381,4818,6616,3151,4953,6617,5738,2796,3204,4360,2989,4281,5739,5174,5421,5197, -3132,5141,3849,5142,5528,5083,3799,3904,4839,5480,2880,4495,3448,6377,6184,5271, -5919,3771,3193,6034,6035,5920,5010,6036,5597,6037,6378,6038,3106,5422,6618,5423, -5424,4142,6619,4889,5084,4890,4313,5740,6620,3437,5175,5307,5816,4199,5198,5529, -5817,5199,5656,4913,5028,5344,3850,6185,2955,5272,5011,5818,4567,4580,5029,5921, -3616,5233,6621,6622,6186,4176,6039,6379,6380,3352,5200,5273,2908,5598,5234,3837, -5308,6623,6624,5819,4496,4323,5309,5201,6625,6626,4983,3194,3838,4167,5530,5922, -5274,6381,6382,3860,3861,5599,3333,4292,4509,6383,3553,5481,5820,5531,4778,6187, -3955,3956,4324,4389,4218,3945,4325,3397,2681,5923,4779,5085,4019,5482,4891,5382, -5383,6040,4682,3425,5275,4094,6627,5310,3015,5483,5657,4398,5924,3168,4819,6628, -5925,6629,5532,4932,4613,6041,6630,4636,6384,4780,4204,5658,4423,5821,3989,4683, -5822,6385,4954,6631,5345,6188,5425,5012,5384,3894,6386,4490,4104,6632,5741,5053, -6633,5823,5926,5659,5660,5927,6634,5235,5742,5824,4840,4933,4820,6387,4859,5928, -4955,6388,4143,3584,5825,5346,5013,6635,5661,6389,5014,5484,5743,4337,5176,5662, -6390,2836,6391,3268,6392,6636,6042,5236,6637,4158,6638,5744,5663,4471,5347,3663, -4123,5143,4293,3895,6639,6640,5311,5929,5826,3800,6189,6393,6190,5664,5348,3554, -3594,4749,4603,6641,5385,4801,6043,5827,4183,6642,5312,5426,4761,6394,5665,6191, -4715,2669,6643,6644,5533,3185,5427,5086,5930,5931,5386,6192,6044,6645,4781,4013, -5745,4282,4435,5534,4390,4267,6045,5746,4984,6046,2743,6193,3501,4087,5485,5932, -5428,4184,4095,5747,4061,5054,3058,3862,5933,5600,6646,5144,3618,6395,3131,5055, -5313,6396,4650,4956,3855,6194,3896,5202,4985,4029,4225,6195,6647,5828,5486,5829, -3589,3002,6648,6397,4782,5276,6649,6196,6650,4105,3803,4043,5237,5830,6398,4096, -3643,6399,3528,6651,4453,3315,4637,6652,3984,6197,5535,3182,3339,6653,3096,2660, -6400,6654,3449,5934,4250,4236,6047,6401,5831,6655,5487,3753,4062,5832,6198,6199, -6656,3766,6657,3403,4667,6048,6658,4338,2897,5833,3880,2797,3780,4326,6659,5748, -5015,6660,5387,4351,5601,4411,6661,3654,4424,5935,4339,4072,5277,4568,5536,6402, -6662,5238,6663,5349,5203,6200,5204,6201,5145,4536,5016,5056,4762,5834,4399,4957, -6202,6403,5666,5749,6664,4340,6665,5936,5177,5667,6666,6667,3459,4668,6404,6668, -6669,4543,6203,6670,4276,6405,4480,5537,6671,4614,5205,5668,6672,3348,2193,4763, -6406,6204,5937,5602,4177,5669,3419,6673,4020,6205,4443,4569,5388,3715,3639,6407, -6049,4058,6206,6674,5938,4544,6050,4185,4294,4841,4651,4615,5488,6207,6408,6051, -5178,3241,3509,5835,6208,4958,5836,4341,5489,5278,6209,2823,5538,5350,5206,5429, -6675,4638,4875,4073,3516,4684,4914,4860,5939,5603,5389,6052,5057,3237,5490,3791, -6676,6409,6677,4821,4915,4106,5351,5058,4243,5539,4244,5604,4842,4916,5239,3028, -3716,5837,5114,5605,5390,5940,5430,6210,4332,6678,5540,4732,3667,3840,6053,4305, -3408,5670,5541,6410,2744,5240,5750,6679,3234,5606,6680,5607,5671,3608,4283,4159, -4400,5352,4783,6681,6411,6682,4491,4802,6211,6412,5941,6413,6414,5542,5751,6683, -4669,3734,5942,6684,6415,5943,5059,3328,4670,4144,4268,6685,6686,6687,6688,4372, -3603,6689,5944,5491,4373,3440,6416,5543,4784,4822,5608,3792,4616,5838,5672,3514, -5391,6417,4892,6690,4639,6691,6054,5673,5839,6055,6692,6056,5392,6212,4038,5544, -5674,4497,6057,6693,5840,4284,5675,4021,4545,5609,6418,4454,6419,6213,4113,4472, -5314,3738,5087,5279,4074,5610,4959,4063,3179,4750,6058,6420,6214,3476,4498,4716, -5431,4960,4685,6215,5241,6694,6421,6216,6695,5841,5945,6422,3748,5946,5179,3905, -5752,5545,5947,4374,6217,4455,6423,4412,6218,4803,5353,6696,3832,5280,6219,4327, -4702,6220,6221,6059,4652,5432,6424,3749,4751,6425,5753,4986,5393,4917,5948,5030, -5754,4861,4733,6426,4703,6697,6222,4671,5949,4546,4961,5180,6223,5031,3316,5281, -6698,4862,4295,4934,5207,3644,6427,5842,5950,6428,6429,4570,5843,5282,6430,6224, -5088,3239,6060,6699,5844,5755,6061,6431,2701,5546,6432,5115,5676,4039,3993,3327, -4752,4425,5315,6433,3941,6434,5677,4617,4604,3074,4581,6225,5433,6435,6226,6062, -4823,5756,5116,6227,3717,5678,4717,5845,6436,5679,5846,6063,5847,6064,3977,3354, -6437,3863,5117,6228,5547,5394,4499,4524,6229,4605,6230,4306,4500,6700,5951,6065, -3693,5952,5089,4366,4918,6701,6231,5548,6232,6702,6438,4704,5434,6703,6704,5953, -4168,6705,5680,3420,6706,5242,4407,6066,3812,5757,5090,5954,4672,4525,3481,5681, -4618,5395,5354,5316,5955,6439,4962,6707,4526,6440,3465,4673,6067,6441,5682,6708, -5435,5492,5758,5683,4619,4571,4674,4804,4893,4686,5493,4753,6233,6068,4269,6442, -6234,5032,4705,5146,5243,5208,5848,6235,6443,4963,5033,4640,4226,6236,5849,3387, -6444,6445,4436,4437,5850,4843,5494,4785,4894,6709,4361,6710,5091,5956,3331,6237, -4987,5549,6069,6711,4342,3517,4473,5317,6070,6712,6071,4706,6446,5017,5355,6713, -6714,4988,5436,6447,4734,5759,6715,4735,4547,4456,4754,6448,5851,6449,6450,3547, -5852,5318,6451,6452,5092,4205,6716,6238,4620,4219,5611,6239,6072,4481,5760,5957, -5958,4059,6240,6453,4227,4537,6241,5761,4030,4186,5244,5209,3761,4457,4876,3337, -5495,5181,6242,5959,5319,5612,5684,5853,3493,5854,6073,4169,5613,5147,4895,6074, -5210,6717,5182,6718,3830,6243,2798,3841,6075,6244,5855,5614,3604,4606,5496,5685, -5118,5356,6719,6454,5960,5357,5961,6720,4145,3935,4621,5119,5962,4261,6721,6455, -4786,5963,4375,4582,6245,6246,6247,6076,5437,4877,5856,3376,4380,6248,4160,6722, -5148,6456,5211,6457,6723,4718,6458,6724,6249,5358,4044,3297,6459,6250,5857,5615, -5497,5245,6460,5498,6725,6251,6252,5550,3793,5499,2959,5396,6461,6462,4572,5093, -5500,5964,3806,4146,6463,4426,5762,5858,6077,6253,4755,3967,4220,5965,6254,4989, -5501,6464,4352,6726,6078,4764,2290,5246,3906,5438,5283,3767,4964,2861,5763,5094, -6255,6256,4622,5616,5859,5860,4707,6727,4285,4708,4824,5617,6257,5551,4787,5212, -4965,4935,4687,6465,6728,6466,5686,6079,3494,4413,2995,5247,5966,5618,6729,5967, -5764,5765,5687,5502,6730,6731,6080,5397,6467,4990,6258,6732,4538,5060,5619,6733, -4719,5688,5439,5018,5149,5284,5503,6734,6081,4607,6259,5120,3645,5861,4583,6260, -4584,4675,5620,4098,5440,6261,4863,2379,3306,4585,5552,5689,4586,5285,6735,4864, -6736,5286,6082,6737,4623,3010,4788,4381,4558,5621,4587,4896,3698,3161,5248,4353, -4045,6262,3754,5183,4588,6738,6263,6739,6740,5622,3936,6741,6468,6742,6264,5095, -6469,4991,5968,6743,4992,6744,6083,4897,6745,4256,5766,4307,3108,3968,4444,5287, -3889,4343,6084,4510,6085,4559,6086,4898,5969,6746,5623,5061,4919,5249,5250,5504, -5441,6265,5320,4878,3242,5862,5251,3428,6087,6747,4237,5624,5442,6266,5553,4539, -6748,2585,3533,5398,4262,6088,5150,4736,4438,6089,6267,5505,4966,6749,6268,6750, -6269,5288,5554,3650,6090,6091,4624,6092,5690,6751,5863,4270,5691,4277,5555,5864, -6752,5692,4720,4865,6470,5151,4688,4825,6753,3094,6754,6471,3235,4653,6755,5213, -5399,6756,3201,4589,5865,4967,6472,5866,6473,5019,3016,6757,5321,4756,3957,4573, -6093,4993,5767,4721,6474,6758,5625,6759,4458,6475,6270,6760,5556,4994,5214,5252, -6271,3875,5768,6094,5034,5506,4376,5769,6761,2120,6476,5253,5770,6762,5771,5970, -3990,5971,5557,5558,5772,6477,6095,2787,4641,5972,5121,6096,6097,6272,6763,3703, -5867,5507,6273,4206,6274,4789,6098,6764,3619,3646,3833,3804,2394,3788,4936,3978, -4866,4899,6099,6100,5559,6478,6765,3599,5868,6101,5869,5870,6275,6766,4527,6767) - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312prober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312prober.py deleted file mode 100644 index 0325a2d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/gb2312prober.py +++ /dev/null @@ -1,41 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import GB2312DistributionAnalysis -from .mbcssm import GB2312SMModel - -class GB2312Prober(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(GB2312SMModel) - self._mDistributionAnalyzer = GB2312DistributionAnalysis() - self.reset() - - def get_charset_name(self): - return "GB2312" diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/hebrewprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/hebrewprober.py deleted file mode 100644 index ba225c5e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/hebrewprober.py +++ /dev/null @@ -1,283 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Shy Shalom -# Portions created by the Initial Developer are Copyright (C) 2005 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .charsetprober import CharSetProber -from .constants import eNotMe, eDetecting -from .compat import wrap_ord - -# This prober doesn't actually recognize a language or a charset. -# It is a helper prober for the use of the Hebrew model probers - -### General ideas of the Hebrew charset recognition ### -# -# Four main charsets exist in Hebrew: -# "ISO-8859-8" - Visual Hebrew -# "windows-1255" - Logical Hebrew -# "ISO-8859-8-I" - Logical Hebrew -# "x-mac-hebrew" - ?? Logical Hebrew ?? -# -# Both "ISO" charsets use a completely identical set of code points, whereas -# "windows-1255" and "x-mac-hebrew" are two different proper supersets of -# these code points. windows-1255 defines additional characters in the range -# 0x80-0x9F as some misc punctuation marks as well as some Hebrew-specific -# diacritics and additional 'Yiddish' ligature letters in the range 0xc0-0xd6. -# x-mac-hebrew defines similar additional code points but with a different -# mapping. -# -# As far as an average Hebrew text with no diacritics is concerned, all four -# charsets are identical with respect to code points. Meaning that for the -# main Hebrew alphabet, all four map the same values to all 27 Hebrew letters -# (including final letters). -# -# The dominant difference between these charsets is their directionality. -# "Visual" directionality means that the text is ordered as if the renderer is -# not aware of a BIDI rendering algorithm. The renderer sees the text and -# draws it from left to right. The text itself when ordered naturally is read -# backwards. A buffer of Visual Hebrew generally looks like so: -# "[last word of first line spelled backwards] [whole line ordered backwards -# and spelled backwards] [first word of first line spelled backwards] -# [end of line] [last word of second line] ... etc' " -# adding punctuation marks, numbers and English text to visual text is -# naturally also "visual" and from left to right. -# -# "Logical" directionality means the text is ordered "naturally" according to -# the order it is read. It is the responsibility of the renderer to display -# the text from right to left. A BIDI algorithm is used to place general -# punctuation marks, numbers and English text in the text. -# -# Texts in x-mac-hebrew are almost impossible to find on the Internet. From -# what little evidence I could find, it seems that its general directionality -# is Logical. -# -# To sum up all of the above, the Hebrew probing mechanism knows about two -# charsets: -# Visual Hebrew - "ISO-8859-8" - backwards text - Words and sentences are -# backwards while line order is natural. For charset recognition purposes -# the line order is unimportant (In fact, for this implementation, even -# word order is unimportant). -# Logical Hebrew - "windows-1255" - normal, naturally ordered text. -# -# "ISO-8859-8-I" is a subset of windows-1255 and doesn't need to be -# specifically identified. -# "x-mac-hebrew" is also identified as windows-1255. A text in x-mac-hebrew -# that contain special punctuation marks or diacritics is displayed with -# some unconverted characters showing as question marks. This problem might -# be corrected using another model prober for x-mac-hebrew. Due to the fact -# that x-mac-hebrew texts are so rare, writing another model prober isn't -# worth the effort and performance hit. -# -#### The Prober #### -# -# The prober is divided between two SBCharSetProbers and a HebrewProber, -# all of which are managed, created, fed data, inquired and deleted by the -# SBCSGroupProber. The two SBCharSetProbers identify that the text is in -# fact some kind of Hebrew, Logical or Visual. The final decision about which -# one is it is made by the HebrewProber by combining final-letter scores -# with the scores of the two SBCharSetProbers to produce a final answer. -# -# The SBCSGroupProber is responsible for stripping the original text of HTML -# tags, English characters, numbers, low-ASCII punctuation characters, spaces -# and new lines. It reduces any sequence of such characters to a single space. -# The buffer fed to each prober in the SBCS group prober is pure text in -# high-ASCII. -# The two SBCharSetProbers (model probers) share the same language model: -# Win1255Model. -# The first SBCharSetProber uses the model normally as any other -# SBCharSetProber does, to recognize windows-1255, upon which this model was -# built. The second SBCharSetProber is told to make the pair-of-letter -# lookup in the language model backwards. This in practice exactly simulates -# a visual Hebrew model using the windows-1255 logical Hebrew model. -# -# The HebrewProber is not using any language model. All it does is look for -# final-letter evidence suggesting the text is either logical Hebrew or visual -# Hebrew. Disjointed from the model probers, the results of the HebrewProber -# alone are meaningless. HebrewProber always returns 0.00 as confidence -# since it never identifies a charset by itself. Instead, the pointer to the -# HebrewProber is passed to the model probers as a helper "Name Prober". -# When the Group prober receives a positive identification from any prober, -# it asks for the name of the charset identified. If the prober queried is a -# Hebrew model prober, the model prober forwards the call to the -# HebrewProber to make the final decision. In the HebrewProber, the -# decision is made according to the final-letters scores maintained and Both -# model probers scores. The answer is returned in the form of the name of the -# charset identified, either "windows-1255" or "ISO-8859-8". - -# windows-1255 / ISO-8859-8 code points of interest -FINAL_KAF = 0xea -NORMAL_KAF = 0xeb -FINAL_MEM = 0xed -NORMAL_MEM = 0xee -FINAL_NUN = 0xef -NORMAL_NUN = 0xf0 -FINAL_PE = 0xf3 -NORMAL_PE = 0xf4 -FINAL_TSADI = 0xf5 -NORMAL_TSADI = 0xf6 - -# Minimum Visual vs Logical final letter score difference. -# If the difference is below this, don't rely solely on the final letter score -# distance. -MIN_FINAL_CHAR_DISTANCE = 5 - -# Minimum Visual vs Logical model score difference. -# If the difference is below this, don't rely at all on the model score -# distance. -MIN_MODEL_DISTANCE = 0.01 - -VISUAL_HEBREW_NAME = "ISO-8859-8" -LOGICAL_HEBREW_NAME = "windows-1255" - - -class HebrewProber(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self._mLogicalProber = None - self._mVisualProber = None - self.reset() - - def reset(self): - self._mFinalCharLogicalScore = 0 - self._mFinalCharVisualScore = 0 - # The two last characters seen in the previous buffer, - # mPrev and mBeforePrev are initialized to space in order to simulate - # a word delimiter at the beginning of the data - self._mPrev = ' ' - self._mBeforePrev = ' ' - # These probers are owned by the group prober. - - def set_model_probers(self, logicalProber, visualProber): - self._mLogicalProber = logicalProber - self._mVisualProber = visualProber - - def is_final(self, c): - return wrap_ord(c) in [FINAL_KAF, FINAL_MEM, FINAL_NUN, FINAL_PE, - FINAL_TSADI] - - def is_non_final(self, c): - # The normal Tsadi is not a good Non-Final letter due to words like - # 'lechotet' (to chat) containing an apostrophe after the tsadi. This - # apostrophe is converted to a space in FilterWithoutEnglishLetters - # causing the Non-Final tsadi to appear at an end of a word even - # though this is not the case in the original text. - # The letters Pe and Kaf rarely display a related behavior of not being - # a good Non-Final letter. Words like 'Pop', 'Winamp' and 'Mubarak' - # for example legally end with a Non-Final Pe or Kaf. However, the - # benefit of these letters as Non-Final letters outweighs the damage - # since these words are quite rare. - return wrap_ord(c) in [NORMAL_KAF, NORMAL_MEM, NORMAL_NUN, NORMAL_PE] - - def feed(self, aBuf): - # Final letter analysis for logical-visual decision. - # Look for evidence that the received buffer is either logical Hebrew - # or visual Hebrew. - # The following cases are checked: - # 1) A word longer than 1 letter, ending with a final letter. This is - # an indication that the text is laid out "naturally" since the - # final letter really appears at the end. +1 for logical score. - # 2) A word longer than 1 letter, ending with a Non-Final letter. In - # normal Hebrew, words ending with Kaf, Mem, Nun, Pe or Tsadi, - # should not end with the Non-Final form of that letter. Exceptions - # to this rule are mentioned above in isNonFinal(). This is an - # indication that the text is laid out backwards. +1 for visual - # score - # 3) A word longer than 1 letter, starting with a final letter. Final - # letters should not appear at the beginning of a word. This is an - # indication that the text is laid out backwards. +1 for visual - # score. - # - # The visual score and logical score are accumulated throughout the - # text and are finally checked against each other in GetCharSetName(). - # No checking for final letters in the middle of words is done since - # that case is not an indication for either Logical or Visual text. - # - # We automatically filter out all 7-bit characters (replace them with - # spaces) so the word boundary detection works properly. [MAP] - - if self.get_state() == eNotMe: - # Both model probers say it's not them. No reason to continue. - return eNotMe - - aBuf = self.filter_high_bit_only(aBuf) - - for cur in aBuf: - if cur == ' ': - # We stand on a space - a word just ended - if self._mBeforePrev != ' ': - # next-to-last char was not a space so self._mPrev is not a - # 1 letter word - if self.is_final(self._mPrev): - # case (1) [-2:not space][-1:final letter][cur:space] - self._mFinalCharLogicalScore += 1 - elif self.is_non_final(self._mPrev): - # case (2) [-2:not space][-1:Non-Final letter][ - # cur:space] - self._mFinalCharVisualScore += 1 - else: - # Not standing on a space - if ((self._mBeforePrev == ' ') and - (self.is_final(self._mPrev)) and (cur != ' ')): - # case (3) [-2:space][-1:final letter][cur:not space] - self._mFinalCharVisualScore += 1 - self._mBeforePrev = self._mPrev - self._mPrev = cur - - # Forever detecting, till the end or until both model probers return - # eNotMe (handled above) - return eDetecting - - def get_charset_name(self): - # Make the decision: is it Logical or Visual? - # If the final letter score distance is dominant enough, rely on it. - finalsub = self._mFinalCharLogicalScore - self._mFinalCharVisualScore - if finalsub >= MIN_FINAL_CHAR_DISTANCE: - return LOGICAL_HEBREW_NAME - if finalsub <= -MIN_FINAL_CHAR_DISTANCE: - return VISUAL_HEBREW_NAME - - # It's not dominant enough, try to rely on the model scores instead. - modelsub = (self._mLogicalProber.get_confidence() - - self._mVisualProber.get_confidence()) - if modelsub > MIN_MODEL_DISTANCE: - return LOGICAL_HEBREW_NAME - if modelsub < -MIN_MODEL_DISTANCE: - return VISUAL_HEBREW_NAME - - # Still no good, back to final letter distance, maybe it'll save the - # day. - if finalsub < 0.0: - return VISUAL_HEBREW_NAME - - # (finalsub > 0 - Logical) or (don't know what to do) default to - # Logical. - return LOGICAL_HEBREW_NAME - - def get_state(self): - # Remain active as long as any of the model probers are active. - if (self._mLogicalProber.get_state() == eNotMe) and \ - (self._mVisualProber.get_state() == eNotMe): - return eNotMe - return eDetecting diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jisfreq.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jisfreq.py deleted file mode 100644 index 064345b0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jisfreq.py +++ /dev/null @@ -1,569 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# Sampling from about 20M text materials include literature and computer technology -# -# Japanese frequency table, applied to both S-JIS and EUC-JP -# They are sorted in order. - -# 128 --> 0.77094 -# 256 --> 0.85710 -# 512 --> 0.92635 -# 1024 --> 0.97130 -# 2048 --> 0.99431 -# -# Ideal Distribution Ratio = 0.92635 / (1-0.92635) = 12.58 -# Random Distribution Ration = 512 / (2965+62+83+86-512) = 0.191 -# -# Typical Distribution Ratio, 25% of IDR - -JIS_TYPICAL_DISTRIBUTION_RATIO = 3.0 - -# Char to FreqOrder table , -JIS_TABLE_SIZE = 4368 - -JISCharToFreqOrder = ( - 40, 1, 6, 182, 152, 180, 295,2127, 285, 381,3295,4304,3068,4606,3165,3510, # 16 -3511,1822,2785,4607,1193,2226,5070,4608, 171,2996,1247, 18, 179,5071, 856,1661, # 32 -1262,5072, 619, 127,3431,3512,3230,1899,1700, 232, 228,1294,1298, 284, 283,2041, # 48 -2042,1061,1062, 48, 49, 44, 45, 433, 434,1040,1041, 996, 787,2997,1255,4305, # 64 -2108,4609,1684,1648,5073,5074,5075,5076,5077,5078,3687,5079,4610,5080,3927,3928, # 80 -5081,3296,3432, 290,2285,1471,2187,5082,2580,2825,1303,2140,1739,1445,2691,3375, # 96 -1691,3297,4306,4307,4611, 452,3376,1182,2713,3688,3069,4308,5083,5084,5085,5086, # 112 -5087,5088,5089,5090,5091,5092,5093,5094,5095,5096,5097,5098,5099,5100,5101,5102, # 128 -5103,5104,5105,5106,5107,5108,5109,5110,5111,5112,4097,5113,5114,5115,5116,5117, # 144 -5118,5119,5120,5121,5122,5123,5124,5125,5126,5127,5128,5129,5130,5131,5132,5133, # 160 -5134,5135,5136,5137,5138,5139,5140,5141,5142,5143,5144,5145,5146,5147,5148,5149, # 176 -5150,5151,5152,4612,5153,5154,5155,5156,5157,5158,5159,5160,5161,5162,5163,5164, # 192 -5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,1472, 598, 618, 820,1205, # 208 -1309,1412,1858,1307,1692,5176,5177,5178,5179,5180,5181,5182,1142,1452,1234,1172, # 224 -1875,2043,2149,1793,1382,2973, 925,2404,1067,1241, 960,1377,2935,1491, 919,1217, # 240 -1865,2030,1406,1499,2749,4098,5183,5184,5185,5186,5187,5188,2561,4099,3117,1804, # 256 -2049,3689,4309,3513,1663,5189,3166,3118,3298,1587,1561,3433,5190,3119,1625,2998, # 272 -3299,4613,1766,3690,2786,4614,5191,5192,5193,5194,2161, 26,3377, 2,3929, 20, # 288 -3691, 47,4100, 50, 17, 16, 35, 268, 27, 243, 42, 155, 24, 154, 29, 184, # 304 - 4, 91, 14, 92, 53, 396, 33, 289, 9, 37, 64, 620, 21, 39, 321, 5, # 320 - 12, 11, 52, 13, 3, 208, 138, 0, 7, 60, 526, 141, 151,1069, 181, 275, # 336 -1591, 83, 132,1475, 126, 331, 829, 15, 69, 160, 59, 22, 157, 55,1079, 312, # 352 - 109, 38, 23, 25, 10, 19, 79,5195, 61, 382,1124, 8, 30,5196,5197,5198, # 368 -5199,5200,5201,5202,5203,5204,5205,5206, 89, 62, 74, 34,2416, 112, 139, 196, # 384 - 271, 149, 84, 607, 131, 765, 46, 88, 153, 683, 76, 874, 101, 258, 57, 80, # 400 - 32, 364, 121,1508, 169,1547, 68, 235, 145,2999, 41, 360,3027, 70, 63, 31, # 416 - 43, 259, 262,1383, 99, 533, 194, 66, 93, 846, 217, 192, 56, 106, 58, 565, # 432 - 280, 272, 311, 256, 146, 82, 308, 71, 100, 128, 214, 655, 110, 261, 104,1140, # 448 - 54, 51, 36, 87, 67,3070, 185,2618,2936,2020, 28,1066,2390,2059,5207,5208, # 464 -5209,5210,5211,5212,5213,5214,5215,5216,4615,5217,5218,5219,5220,5221,5222,5223, # 480 -5224,5225,5226,5227,5228,5229,5230,5231,5232,5233,5234,5235,5236,3514,5237,5238, # 496 -5239,5240,5241,5242,5243,5244,2297,2031,4616,4310,3692,5245,3071,5246,3598,5247, # 512 -4617,3231,3515,5248,4101,4311,4618,3808,4312,4102,5249,4103,4104,3599,5250,5251, # 528 -5252,5253,5254,5255,5256,5257,5258,5259,5260,5261,5262,5263,5264,5265,5266,5267, # 544 -5268,5269,5270,5271,5272,5273,5274,5275,5276,5277,5278,5279,5280,5281,5282,5283, # 560 -5284,5285,5286,5287,5288,5289,5290,5291,5292,5293,5294,5295,5296,5297,5298,5299, # 576 -5300,5301,5302,5303,5304,5305,5306,5307,5308,5309,5310,5311,5312,5313,5314,5315, # 592 -5316,5317,5318,5319,5320,5321,5322,5323,5324,5325,5326,5327,5328,5329,5330,5331, # 608 -5332,5333,5334,5335,5336,5337,5338,5339,5340,5341,5342,5343,5344,5345,5346,5347, # 624 -5348,5349,5350,5351,5352,5353,5354,5355,5356,5357,5358,5359,5360,5361,5362,5363, # 640 -5364,5365,5366,5367,5368,5369,5370,5371,5372,5373,5374,5375,5376,5377,5378,5379, # 656 -5380,5381, 363, 642,2787,2878,2788,2789,2316,3232,2317,3434,2011, 165,1942,3930, # 672 -3931,3932,3933,5382,4619,5383,4620,5384,5385,5386,5387,5388,5389,5390,5391,5392, # 688 -5393,5394,5395,5396,5397,5398,5399,5400,5401,5402,5403,5404,5405,5406,5407,5408, # 704 -5409,5410,5411,5412,5413,5414,5415,5416,5417,5418,5419,5420,5421,5422,5423,5424, # 720 -5425,5426,5427,5428,5429,5430,5431,5432,5433,5434,5435,5436,5437,5438,5439,5440, # 736 -5441,5442,5443,5444,5445,5446,5447,5448,5449,5450,5451,5452,5453,5454,5455,5456, # 752 -5457,5458,5459,5460,5461,5462,5463,5464,5465,5466,5467,5468,5469,5470,5471,5472, # 768 -5473,5474,5475,5476,5477,5478,5479,5480,5481,5482,5483,5484,5485,5486,5487,5488, # 784 -5489,5490,5491,5492,5493,5494,5495,5496,5497,5498,5499,5500,5501,5502,5503,5504, # 800 -5505,5506,5507,5508,5509,5510,5511,5512,5513,5514,5515,5516,5517,5518,5519,5520, # 816 -5521,5522,5523,5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536, # 832 -5537,5538,5539,5540,5541,5542,5543,5544,5545,5546,5547,5548,5549,5550,5551,5552, # 848 -5553,5554,5555,5556,5557,5558,5559,5560,5561,5562,5563,5564,5565,5566,5567,5568, # 864 -5569,5570,5571,5572,5573,5574,5575,5576,5577,5578,5579,5580,5581,5582,5583,5584, # 880 -5585,5586,5587,5588,5589,5590,5591,5592,5593,5594,5595,5596,5597,5598,5599,5600, # 896 -5601,5602,5603,5604,5605,5606,5607,5608,5609,5610,5611,5612,5613,5614,5615,5616, # 912 -5617,5618,5619,5620,5621,5622,5623,5624,5625,5626,5627,5628,5629,5630,5631,5632, # 928 -5633,5634,5635,5636,5637,5638,5639,5640,5641,5642,5643,5644,5645,5646,5647,5648, # 944 -5649,5650,5651,5652,5653,5654,5655,5656,5657,5658,5659,5660,5661,5662,5663,5664, # 960 -5665,5666,5667,5668,5669,5670,5671,5672,5673,5674,5675,5676,5677,5678,5679,5680, # 976 -5681,5682,5683,5684,5685,5686,5687,5688,5689,5690,5691,5692,5693,5694,5695,5696, # 992 -5697,5698,5699,5700,5701,5702,5703,5704,5705,5706,5707,5708,5709,5710,5711,5712, # 1008 -5713,5714,5715,5716,5717,5718,5719,5720,5721,5722,5723,5724,5725,5726,5727,5728, # 1024 -5729,5730,5731,5732,5733,5734,5735,5736,5737,5738,5739,5740,5741,5742,5743,5744, # 1040 -5745,5746,5747,5748,5749,5750,5751,5752,5753,5754,5755,5756,5757,5758,5759,5760, # 1056 -5761,5762,5763,5764,5765,5766,5767,5768,5769,5770,5771,5772,5773,5774,5775,5776, # 1072 -5777,5778,5779,5780,5781,5782,5783,5784,5785,5786,5787,5788,5789,5790,5791,5792, # 1088 -5793,5794,5795,5796,5797,5798,5799,5800,5801,5802,5803,5804,5805,5806,5807,5808, # 1104 -5809,5810,5811,5812,5813,5814,5815,5816,5817,5818,5819,5820,5821,5822,5823,5824, # 1120 -5825,5826,5827,5828,5829,5830,5831,5832,5833,5834,5835,5836,5837,5838,5839,5840, # 1136 -5841,5842,5843,5844,5845,5846,5847,5848,5849,5850,5851,5852,5853,5854,5855,5856, # 1152 -5857,5858,5859,5860,5861,5862,5863,5864,5865,5866,5867,5868,5869,5870,5871,5872, # 1168 -5873,5874,5875,5876,5877,5878,5879,5880,5881,5882,5883,5884,5885,5886,5887,5888, # 1184 -5889,5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904, # 1200 -5905,5906,5907,5908,5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920, # 1216 -5921,5922,5923,5924,5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,5936, # 1232 -5937,5938,5939,5940,5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951,5952, # 1248 -5953,5954,5955,5956,5957,5958,5959,5960,5961,5962,5963,5964,5965,5966,5967,5968, # 1264 -5969,5970,5971,5972,5973,5974,5975,5976,5977,5978,5979,5980,5981,5982,5983,5984, # 1280 -5985,5986,5987,5988,5989,5990,5991,5992,5993,5994,5995,5996,5997,5998,5999,6000, # 1296 -6001,6002,6003,6004,6005,6006,6007,6008,6009,6010,6011,6012,6013,6014,6015,6016, # 1312 -6017,6018,6019,6020,6021,6022,6023,6024,6025,6026,6027,6028,6029,6030,6031,6032, # 1328 -6033,6034,6035,6036,6037,6038,6039,6040,6041,6042,6043,6044,6045,6046,6047,6048, # 1344 -6049,6050,6051,6052,6053,6054,6055,6056,6057,6058,6059,6060,6061,6062,6063,6064, # 1360 -6065,6066,6067,6068,6069,6070,6071,6072,6073,6074,6075,6076,6077,6078,6079,6080, # 1376 -6081,6082,6083,6084,6085,6086,6087,6088,6089,6090,6091,6092,6093,6094,6095,6096, # 1392 -6097,6098,6099,6100,6101,6102,6103,6104,6105,6106,6107,6108,6109,6110,6111,6112, # 1408 -6113,6114,2044,2060,4621, 997,1235, 473,1186,4622, 920,3378,6115,6116, 379,1108, # 1424 -4313,2657,2735,3934,6117,3809, 636,3233, 573,1026,3693,3435,2974,3300,2298,4105, # 1440 - 854,2937,2463, 393,2581,2417, 539, 752,1280,2750,2480, 140,1161, 440, 708,1569, # 1456 - 665,2497,1746,1291,1523,3000, 164,1603, 847,1331, 537,1997, 486, 508,1693,2418, # 1472 -1970,2227, 878,1220, 299,1030, 969, 652,2751, 624,1137,3301,2619, 65,3302,2045, # 1488 -1761,1859,3120,1930,3694,3516, 663,1767, 852, 835,3695, 269, 767,2826,2339,1305, # 1504 - 896,1150, 770,1616,6118, 506,1502,2075,1012,2519, 775,2520,2975,2340,2938,4314, # 1520 -3028,2086,1224,1943,2286,6119,3072,4315,2240,1273,1987,3935,1557, 175, 597, 985, # 1536 -3517,2419,2521,1416,3029, 585, 938,1931,1007,1052,1932,1685,6120,3379,4316,4623, # 1552 - 804, 599,3121,1333,2128,2539,1159,1554,2032,3810, 687,2033,2904, 952, 675,1467, # 1568 -3436,6121,2241,1096,1786,2440,1543,1924, 980,1813,2228, 781,2692,1879, 728,1918, # 1584 -3696,4624, 548,1950,4625,1809,1088,1356,3303,2522,1944, 502, 972, 373, 513,2827, # 1600 - 586,2377,2391,1003,1976,1631,6122,2464,1084, 648,1776,4626,2141, 324, 962,2012, # 1616 -2177,2076,1384, 742,2178,1448,1173,1810, 222, 102, 301, 445, 125,2420, 662,2498, # 1632 - 277, 200,1476,1165,1068, 224,2562,1378,1446, 450,1880, 659, 791, 582,4627,2939, # 1648 -3936,1516,1274, 555,2099,3697,1020,1389,1526,3380,1762,1723,1787,2229, 412,2114, # 1664 -1900,2392,3518, 512,2597, 427,1925,2341,3122,1653,1686,2465,2499, 697, 330, 273, # 1680 - 380,2162, 951, 832, 780, 991,1301,3073, 965,2270,3519, 668,2523,2636,1286, 535, # 1696 -1407, 518, 671, 957,2658,2378, 267, 611,2197,3030,6123, 248,2299, 967,1799,2356, # 1712 - 850,1418,3437,1876,1256,1480,2828,1718,6124,6125,1755,1664,2405,6126,4628,2879, # 1728 -2829, 499,2179, 676,4629, 557,2329,2214,2090, 325,3234, 464, 811,3001, 992,2342, # 1744 -2481,1232,1469, 303,2242, 466,1070,2163, 603,1777,2091,4630,2752,4631,2714, 322, # 1760 -2659,1964,1768, 481,2188,1463,2330,2857,3600,2092,3031,2421,4632,2318,2070,1849, # 1776 -2598,4633,1302,2254,1668,1701,2422,3811,2905,3032,3123,2046,4106,1763,1694,4634, # 1792 -1604, 943,1724,1454, 917, 868,2215,1169,2940, 552,1145,1800,1228,1823,1955, 316, # 1808 -1080,2510, 361,1807,2830,4107,2660,3381,1346,1423,1134,4108,6127, 541,1263,1229, # 1824 -1148,2540, 545, 465,1833,2880,3438,1901,3074,2482, 816,3937, 713,1788,2500, 122, # 1840 -1575, 195,1451,2501,1111,6128, 859, 374,1225,2243,2483,4317, 390,1033,3439,3075, # 1856 -2524,1687, 266, 793,1440,2599, 946, 779, 802, 507, 897,1081, 528,2189,1292, 711, # 1872 -1866,1725,1167,1640, 753, 398,2661,1053, 246, 348,4318, 137,1024,3440,1600,2077, # 1888 -2129, 825,4319, 698, 238, 521, 187,2300,1157,2423,1641,1605,1464,1610,1097,2541, # 1904 -1260,1436, 759,2255,1814,2150, 705,3235, 409,2563,3304, 561,3033,2005,2564, 726, # 1920 -1956,2343,3698,4109, 949,3812,3813,3520,1669, 653,1379,2525, 881,2198, 632,2256, # 1936 -1027, 778,1074, 733,1957, 514,1481,2466, 554,2180, 702,3938,1606,1017,1398,6129, # 1952 -1380,3521, 921, 993,1313, 594, 449,1489,1617,1166, 768,1426,1360, 495,1794,3601, # 1968 -1177,3602,1170,4320,2344, 476, 425,3167,4635,3168,1424, 401,2662,1171,3382,1998, # 1984 -1089,4110, 477,3169, 474,6130,1909, 596,2831,1842, 494, 693,1051,1028,1207,3076, # 2000 - 606,2115, 727,2790,1473,1115, 743,3522, 630, 805,1532,4321,2021, 366,1057, 838, # 2016 - 684,1114,2142,4322,2050,1492,1892,1808,2271,3814,2424,1971,1447,1373,3305,1090, # 2032 -1536,3939,3523,3306,1455,2199, 336, 369,2331,1035, 584,2393, 902, 718,2600,6131, # 2048 -2753, 463,2151,1149,1611,2467, 715,1308,3124,1268, 343,1413,3236,1517,1347,2663, # 2064 -2093,3940,2022,1131,1553,2100,2941,1427,3441,2942,1323,2484,6132,1980, 872,2368, # 2080 -2441,2943, 320,2369,2116,1082, 679,1933,3941,2791,3815, 625,1143,2023, 422,2200, # 2096 -3816,6133, 730,1695, 356,2257,1626,2301,2858,2637,1627,1778, 937, 883,2906,2693, # 2112 -3002,1769,1086, 400,1063,1325,3307,2792,4111,3077, 456,2345,1046, 747,6134,1524, # 2128 - 884,1094,3383,1474,2164,1059, 974,1688,2181,2258,1047, 345,1665,1187, 358, 875, # 2144 -3170, 305, 660,3524,2190,1334,1135,3171,1540,1649,2542,1527, 927, 968,2793, 885, # 2160 -1972,1850, 482, 500,2638,1218,1109,1085,2543,1654,2034, 876, 78,2287,1482,1277, # 2176 - 861,1675,1083,1779, 724,2754, 454, 397,1132,1612,2332, 893, 672,1237, 257,2259, # 2192 -2370, 135,3384, 337,2244, 547, 352, 340, 709,2485,1400, 788,1138,2511, 540, 772, # 2208 -1682,2260,2272,2544,2013,1843,1902,4636,1999,1562,2288,4637,2201,1403,1533, 407, # 2224 - 576,3308,1254,2071, 978,3385, 170, 136,1201,3125,2664,3172,2394, 213, 912, 873, # 2240 -3603,1713,2202, 699,3604,3699, 813,3442, 493, 531,1054, 468,2907,1483, 304, 281, # 2256 -4112,1726,1252,2094, 339,2319,2130,2639, 756,1563,2944, 748, 571,2976,1588,2425, # 2272 -2715,1851,1460,2426,1528,1392,1973,3237, 288,3309, 685,3386, 296, 892,2716,2216, # 2288 -1570,2245, 722,1747,2217, 905,3238,1103,6135,1893,1441,1965, 251,1805,2371,3700, # 2304 -2601,1919,1078, 75,2182,1509,1592,1270,2640,4638,2152,6136,3310,3817, 524, 706, # 2320 -1075, 292,3818,1756,2602, 317, 98,3173,3605,3525,1844,2218,3819,2502, 814, 567, # 2336 - 385,2908,1534,6137, 534,1642,3239, 797,6138,1670,1529, 953,4323, 188,1071, 538, # 2352 - 178, 729,3240,2109,1226,1374,2000,2357,2977, 731,2468,1116,2014,2051,6139,1261, # 2368 -1593, 803,2859,2736,3443, 556, 682, 823,1541,6140,1369,2289,1706,2794, 845, 462, # 2384 -2603,2665,1361, 387, 162,2358,1740, 739,1770,1720,1304,1401,3241,1049, 627,1571, # 2400 -2427,3526,1877,3942,1852,1500, 431,1910,1503, 677, 297,2795, 286,1433,1038,1198, # 2416 -2290,1133,1596,4113,4639,2469,1510,1484,3943,6141,2442, 108, 712,4640,2372, 866, # 2432 -3701,2755,3242,1348, 834,1945,1408,3527,2395,3243,1811, 824, 994,1179,2110,1548, # 2448 -1453, 790,3003, 690,4324,4325,2832,2909,3820,1860,3821, 225,1748, 310, 346,1780, # 2464 -2470, 821,1993,2717,2796, 828, 877,3528,2860,2471,1702,2165,2910,2486,1789, 453, # 2480 - 359,2291,1676, 73,1164,1461,1127,3311, 421, 604, 314,1037, 589, 116,2487, 737, # 2496 - 837,1180, 111, 244, 735,6142,2261,1861,1362, 986, 523, 418, 581,2666,3822, 103, # 2512 - 855, 503,1414,1867,2488,1091, 657,1597, 979, 605,1316,4641,1021,2443,2078,2001, # 2528 -1209, 96, 587,2166,1032, 260,1072,2153, 173, 94, 226,3244, 819,2006,4642,4114, # 2544 -2203, 231,1744, 782, 97,2667, 786,3387, 887, 391, 442,2219,4326,1425,6143,2694, # 2560 - 633,1544,1202, 483,2015, 592,2052,1958,2472,1655, 419, 129,4327,3444,3312,1714, # 2576 -1257,3078,4328,1518,1098, 865,1310,1019,1885,1512,1734, 469,2444, 148, 773, 436, # 2592 -1815,1868,1128,1055,4329,1245,2756,3445,2154,1934,1039,4643, 579,1238, 932,2320, # 2608 - 353, 205, 801, 115,2428, 944,2321,1881, 399,2565,1211, 678, 766,3944, 335,2101, # 2624 -1459,1781,1402,3945,2737,2131,1010, 844, 981,1326,1013, 550,1816,1545,2620,1335, # 2640 -1008, 371,2881, 936,1419,1613,3529,1456,1395,2273,1834,2604,1317,2738,2503, 416, # 2656 -1643,4330, 806,1126, 229, 591,3946,1314,1981,1576,1837,1666, 347,1790, 977,3313, # 2672 - 764,2861,1853, 688,2429,1920,1462, 77, 595, 415,2002,3034, 798,1192,4115,6144, # 2688 -2978,4331,3035,2695,2582,2072,2566, 430,2430,1727, 842,1396,3947,3702, 613, 377, # 2704 - 278, 236,1417,3388,3314,3174, 757,1869, 107,3530,6145,1194, 623,2262, 207,1253, # 2720 -2167,3446,3948, 492,1117,1935, 536,1838,2757,1246,4332, 696,2095,2406,1393,1572, # 2736 -3175,1782, 583, 190, 253,1390,2230, 830,3126,3389, 934,3245,1703,1749,2979,1870, # 2752 -2545,1656,2204, 869,2346,4116,3176,1817, 496,1764,4644, 942,1504, 404,1903,1122, # 2768 -1580,3606,2945,1022, 515, 372,1735, 955,2431,3036,6146,2797,1110,2302,2798, 617, # 2784 -6147, 441, 762,1771,3447,3607,3608,1904, 840,3037, 86, 939,1385, 572,1370,2445, # 2800 -1336, 114,3703, 898, 294, 203,3315, 703,1583,2274, 429, 961,4333,1854,1951,3390, # 2816 -2373,3704,4334,1318,1381, 966,1911,2322,1006,1155, 309, 989, 458,2718,1795,1372, # 2832 -1203, 252,1689,1363,3177, 517,1936, 168,1490, 562, 193,3823,1042,4117,1835, 551, # 2848 - 470,4645, 395, 489,3448,1871,1465,2583,2641, 417,1493, 279,1295, 511,1236,1119, # 2864 - 72,1231,1982,1812,3004, 871,1564, 984,3449,1667,2696,2096,4646,2347,2833,1673, # 2880 -3609, 695,3246,2668, 807,1183,4647, 890, 388,2333,1801,1457,2911,1765,1477,1031, # 2896 -3316,3317,1278,3391,2799,2292,2526, 163,3450,4335,2669,1404,1802,6148,2323,2407, # 2912 -1584,1728,1494,1824,1269, 298, 909,3318,1034,1632, 375, 776,1683,2061, 291, 210, # 2928 -1123, 809,1249,1002,2642,3038, 206,1011,2132, 144, 975, 882,1565, 342, 667, 754, # 2944 -1442,2143,1299,2303,2062, 447, 626,2205,1221,2739,2912,1144,1214,2206,2584, 760, # 2960 -1715, 614, 950,1281,2670,2621, 810, 577,1287,2546,4648, 242,2168, 250,2643, 691, # 2976 - 123,2644, 647, 313,1029, 689,1357,2946,1650, 216, 771,1339,1306, 808,2063, 549, # 2992 - 913,1371,2913,2914,6149,1466,1092,1174,1196,1311,2605,2396,1783,1796,3079, 406, # 3008 -2671,2117,3949,4649, 487,1825,2220,6150,2915, 448,2348,1073,6151,2397,1707, 130, # 3024 - 900,1598, 329, 176,1959,2527,1620,6152,2275,4336,3319,1983,2191,3705,3610,2155, # 3040 -3706,1912,1513,1614,6153,1988, 646, 392,2304,1589,3320,3039,1826,1239,1352,1340, # 3056 -2916, 505,2567,1709,1437,2408,2547, 906,6154,2672, 384,1458,1594,1100,1329, 710, # 3072 - 423,3531,2064,2231,2622,1989,2673,1087,1882, 333, 841,3005,1296,2882,2379, 580, # 3088 -1937,1827,1293,2585, 601, 574, 249,1772,4118,2079,1120, 645, 901,1176,1690, 795, # 3104 -2207, 478,1434, 516,1190,1530, 761,2080, 930,1264, 355, 435,1552, 644,1791, 987, # 3120 - 220,1364,1163,1121,1538, 306,2169,1327,1222, 546,2645, 218, 241, 610,1704,3321, # 3136 -1984,1839,1966,2528, 451,6155,2586,3707,2568, 907,3178, 254,2947, 186,1845,4650, # 3152 - 745, 432,1757, 428,1633, 888,2246,2221,2489,3611,2118,1258,1265, 956,3127,1784, # 3168 -4337,2490, 319, 510, 119, 457,3612, 274,2035,2007,4651,1409,3128, 970,2758, 590, # 3184 -2800, 661,2247,4652,2008,3950,1420,1549,3080,3322,3951,1651,1375,2111, 485,2491, # 3200 -1429,1156,6156,2548,2183,1495, 831,1840,2529,2446, 501,1657, 307,1894,3247,1341, # 3216 - 666, 899,2156,1539,2549,1559, 886, 349,2208,3081,2305,1736,3824,2170,2759,1014, # 3232 -1913,1386, 542,1397,2948, 490, 368, 716, 362, 159, 282,2569,1129,1658,1288,1750, # 3248 -2674, 276, 649,2016, 751,1496, 658,1818,1284,1862,2209,2087,2512,3451, 622,2834, # 3264 - 376, 117,1060,2053,1208,1721,1101,1443, 247,1250,3179,1792,3952,2760,2398,3953, # 3280 -6157,2144,3708, 446,2432,1151,2570,3452,2447,2761,2835,1210,2448,3082, 424,2222, # 3296 -1251,2449,2119,2836, 504,1581,4338, 602, 817, 857,3825,2349,2306, 357,3826,1470, # 3312 -1883,2883, 255, 958, 929,2917,3248, 302,4653,1050,1271,1751,2307,1952,1430,2697, # 3328 -2719,2359, 354,3180, 777, 158,2036,4339,1659,4340,4654,2308,2949,2248,1146,2232, # 3344 -3532,2720,1696,2623,3827,6158,3129,1550,2698,1485,1297,1428, 637, 931,2721,2145, # 3360 - 914,2550,2587, 81,2450, 612, 827,2646,1242,4655,1118,2884, 472,1855,3181,3533, # 3376 -3534, 569,1353,2699,1244,1758,2588,4119,2009,2762,2171,3709,1312,1531,6159,1152, # 3392 -1938, 134,1830, 471,3710,2276,1112,1535,3323,3453,3535, 982,1337,2950, 488, 826, # 3408 - 674,1058,1628,4120,2017, 522,2399, 211, 568,1367,3454, 350, 293,1872,1139,3249, # 3424 -1399,1946,3006,1300,2360,3324, 588, 736,6160,2606, 744, 669,3536,3828,6161,1358, # 3440 - 199, 723, 848, 933, 851,1939,1505,1514,1338,1618,1831,4656,1634,3613, 443,2740, # 3456 -3829, 717,1947, 491,1914,6162,2551,1542,4121,1025,6163,1099,1223, 198,3040,2722, # 3472 - 370, 410,1905,2589, 998,1248,3182,2380, 519,1449,4122,1710, 947, 928,1153,4341, # 3488 -2277, 344,2624,1511, 615, 105, 161,1212,1076,1960,3130,2054,1926,1175,1906,2473, # 3504 - 414,1873,2801,6164,2309, 315,1319,3325, 318,2018,2146,2157, 963, 631, 223,4342, # 3520 -4343,2675, 479,3711,1197,2625,3712,2676,2361,6165,4344,4123,6166,2451,3183,1886, # 3536 -2184,1674,1330,1711,1635,1506, 799, 219,3250,3083,3954,1677,3713,3326,2081,3614, # 3552 -1652,2073,4657,1147,3041,1752, 643,1961, 147,1974,3955,6167,1716,2037, 918,3007, # 3568 -1994, 120,1537, 118, 609,3184,4345, 740,3455,1219, 332,1615,3830,6168,1621,2980, # 3584 -1582, 783, 212, 553,2350,3714,1349,2433,2082,4124, 889,6169,2310,1275,1410, 973, # 3600 - 166,1320,3456,1797,1215,3185,2885,1846,2590,2763,4658, 629, 822,3008, 763, 940, # 3616 -1990,2862, 439,2409,1566,1240,1622, 926,1282,1907,2764, 654,2210,1607, 327,1130, # 3632 -3956,1678,1623,6170,2434,2192, 686, 608,3831,3715, 903,3957,3042,6171,2741,1522, # 3648 -1915,1105,1555,2552,1359, 323,3251,4346,3457, 738,1354,2553,2311,2334,1828,2003, # 3664 -3832,1753,2351,1227,6172,1887,4125,1478,6173,2410,1874,1712,1847, 520,1204,2607, # 3680 - 264,4659, 836,2677,2102, 600,4660,3833,2278,3084,6174,4347,3615,1342, 640, 532, # 3696 - 543,2608,1888,2400,2591,1009,4348,1497, 341,1737,3616,2723,1394, 529,3252,1321, # 3712 - 983,4661,1515,2120, 971,2592, 924, 287,1662,3186,4349,2700,4350,1519, 908,1948, # 3728 -2452, 156, 796,1629,1486,2223,2055, 694,4126,1259,1036,3392,1213,2249,2742,1889, # 3744 -1230,3958,1015, 910, 408, 559,3617,4662, 746, 725, 935,4663,3959,3009,1289, 563, # 3760 - 867,4664,3960,1567,2981,2038,2626, 988,2263,2381,4351, 143,2374, 704,1895,6175, # 3776 -1188,3716,2088, 673,3085,2362,4352, 484,1608,1921,2765,2918, 215, 904,3618,3537, # 3792 - 894, 509, 976,3043,2701,3961,4353,2837,2982, 498,6176,6177,1102,3538,1332,3393, # 3808 -1487,1636,1637, 233, 245,3962, 383, 650, 995,3044, 460,1520,1206,2352, 749,3327, # 3824 - 530, 700, 389,1438,1560,1773,3963,2264, 719,2951,2724,3834, 870,1832,1644,1000, # 3840 - 839,2474,3717, 197,1630,3394, 365,2886,3964,1285,2133, 734, 922, 818,1106, 732, # 3856 - 480,2083,1774,3458, 923,2279,1350, 221,3086, 85,2233,2234,3835,1585,3010,2147, # 3872 -1387,1705,2382,1619,2475, 133, 239,2802,1991,1016,2084,2383, 411,2838,1113, 651, # 3888 -1985,1160,3328, 990,1863,3087,1048,1276,2647, 265,2627,1599,3253,2056, 150, 638, # 3904 -2019, 656, 853, 326,1479, 680,1439,4354,1001,1759, 413,3459,3395,2492,1431, 459, # 3920 -4355,1125,3329,2265,1953,1450,2065,2863, 849, 351,2678,3131,3254,3255,1104,1577, # 3936 - 227,1351,1645,2453,2193,1421,2887, 812,2121, 634, 95,2435, 201,2312,4665,1646, # 3952 -1671,2743,1601,2554,2702,2648,2280,1315,1366,2089,3132,1573,3718,3965,1729,1189, # 3968 - 328,2679,1077,1940,1136, 558,1283, 964,1195, 621,2074,1199,1743,3460,3619,1896, # 3984 -1916,1890,3836,2952,1154,2112,1064, 862, 378,3011,2066,2113,2803,1568,2839,6178, # 4000 -3088,2919,1941,1660,2004,1992,2194, 142, 707,1590,1708,1624,1922,1023,1836,1233, # 4016 -1004,2313, 789, 741,3620,6179,1609,2411,1200,4127,3719,3720,4666,2057,3721, 593, # 4032 -2840, 367,2920,1878,6180,3461,1521, 628,1168, 692,2211,2649, 300, 720,2067,2571, # 4048 -2953,3396, 959,2504,3966,3539,3462,1977, 701,6181, 954,1043, 800, 681, 183,3722, # 4064 -1803,1730,3540,4128,2103, 815,2314, 174, 467, 230,2454,1093,2134, 755,3541,3397, # 4080 -1141,1162,6182,1738,2039, 270,3256,2513,1005,1647,2185,3837, 858,1679,1897,1719, # 4096 -2954,2324,1806, 402, 670, 167,4129,1498,2158,2104, 750,6183, 915, 189,1680,1551, # 4112 - 455,4356,1501,2455, 405,1095,2955, 338,1586,1266,1819, 570, 641,1324, 237,1556, # 4128 -2650,1388,3723,6184,1368,2384,1343,1978,3089,2436, 879,3724, 792,1191, 758,3012, # 4144 -1411,2135,1322,4357, 240,4667,1848,3725,1574,6185, 420,3045,1546,1391, 714,4358, # 4160 -1967, 941,1864, 863, 664, 426, 560,1731,2680,1785,2864,1949,2363, 403,3330,1415, # 4176 -1279,2136,1697,2335, 204, 721,2097,3838, 90,6186,2085,2505, 191,3967, 124,2148, # 4192 -1376,1798,1178,1107,1898,1405, 860,4359,1243,1272,2375,2983,1558,2456,1638, 113, # 4208 -3621, 578,1923,2609, 880, 386,4130, 784,2186,2266,1422,2956,2172,1722, 497, 263, # 4224 -2514,1267,2412,2610, 177,2703,3542, 774,1927,1344, 616,1432,1595,1018, 172,4360, # 4240 -2325, 911,4361, 438,1468,3622, 794,3968,2024,2173,1681,1829,2957, 945, 895,3090, # 4256 - 575,2212,2476, 475,2401,2681, 785,2744,1745,2293,2555,1975,3133,2865, 394,4668, # 4272 -3839, 635,4131, 639, 202,1507,2195,2766,1345,1435,2572,3726,1908,1184,1181,2457, # 4288 -3727,3134,4362, 843,2611, 437, 916,4669, 234, 769,1884,3046,3047,3623, 833,6187, # 4304 -1639,2250,2402,1355,1185,2010,2047, 999, 525,1732,1290,1488,2612, 948,1578,3728, # 4320 -2413,2477,1216,2725,2159, 334,3840,1328,3624,2921,1525,4132, 564,1056, 891,4363, # 4336 -1444,1698,2385,2251,3729,1365,2281,2235,1717,6188, 864,3841,2515, 444, 527,2767, # 4352 -2922,3625, 544, 461,6189, 566, 209,2437,3398,2098,1065,2068,3331,3626,3257,2137, # 4368 #last 512 -#Everything below is of no interest for detection purpose -2138,2122,3730,2888,1995,1820,1044,6190,6191,6192,6193,6194,6195,6196,6197,6198, # 4384 -6199,6200,6201,6202,6203,6204,6205,4670,6206,6207,6208,6209,6210,6211,6212,6213, # 4400 -6214,6215,6216,6217,6218,6219,6220,6221,6222,6223,6224,6225,6226,6227,6228,6229, # 4416 -6230,6231,6232,6233,6234,6235,6236,6237,3187,6238,6239,3969,6240,6241,6242,6243, # 4432 -6244,4671,6245,6246,4672,6247,6248,4133,6249,6250,4364,6251,2923,2556,2613,4673, # 4448 -4365,3970,6252,6253,6254,6255,4674,6256,6257,6258,2768,2353,4366,4675,4676,3188, # 4464 -4367,3463,6259,4134,4677,4678,6260,2267,6261,3842,3332,4368,3543,6262,6263,6264, # 4480 -3013,1954,1928,4135,4679,6265,6266,2478,3091,6267,4680,4369,6268,6269,1699,6270, # 4496 -3544,4136,4681,6271,4137,6272,4370,2804,6273,6274,2593,3971,3972,4682,6275,2236, # 4512 -4683,6276,6277,4684,6278,6279,4138,3973,4685,6280,6281,3258,6282,6283,6284,6285, # 4528 -3974,4686,2841,3975,6286,6287,3545,6288,6289,4139,4687,4140,6290,4141,6291,4142, # 4544 -6292,6293,3333,6294,6295,6296,4371,6297,3399,6298,6299,4372,3976,6300,6301,6302, # 4560 -4373,6303,6304,3843,3731,6305,4688,4374,6306,6307,3259,2294,6308,3732,2530,4143, # 4576 -6309,4689,6310,6311,6312,3048,6313,6314,4690,3733,2237,6315,6316,2282,3334,6317, # 4592 -6318,3844,6319,6320,4691,6321,3400,4692,6322,4693,6323,3049,6324,4375,6325,3977, # 4608 -6326,6327,6328,3546,6329,4694,3335,6330,4695,4696,6331,6332,6333,6334,4376,3978, # 4624 -6335,4697,3979,4144,6336,3980,4698,6337,6338,6339,6340,6341,4699,4700,4701,6342, # 4640 -6343,4702,6344,6345,4703,6346,6347,4704,6348,4705,4706,3135,6349,4707,6350,4708, # 4656 -6351,4377,6352,4709,3734,4145,6353,2506,4710,3189,6354,3050,4711,3981,6355,3547, # 4672 -3014,4146,4378,3735,2651,3845,3260,3136,2224,1986,6356,3401,6357,4712,2594,3627, # 4688 -3137,2573,3736,3982,4713,3628,4714,4715,2682,3629,4716,6358,3630,4379,3631,6359, # 4704 -6360,6361,3983,6362,6363,6364,6365,4147,3846,4717,6366,6367,3737,2842,6368,4718, # 4720 -2628,6369,3261,6370,2386,6371,6372,3738,3984,4719,3464,4720,3402,6373,2924,3336, # 4736 -4148,2866,6374,2805,3262,4380,2704,2069,2531,3138,2806,2984,6375,2769,6376,4721, # 4752 -4722,3403,6377,6378,3548,6379,6380,2705,3092,1979,4149,2629,3337,2889,6381,3338, # 4768 -4150,2557,3339,4381,6382,3190,3263,3739,6383,4151,4723,4152,2558,2574,3404,3191, # 4784 -6384,6385,4153,6386,4724,4382,6387,6388,4383,6389,6390,4154,6391,4725,3985,6392, # 4800 -3847,4155,6393,6394,6395,6396,6397,3465,6398,4384,6399,6400,6401,6402,6403,6404, # 4816 -4156,6405,6406,6407,6408,2123,6409,6410,2326,3192,4726,6411,6412,6413,6414,4385, # 4832 -4157,6415,6416,4158,6417,3093,3848,6418,3986,6419,6420,3849,6421,6422,6423,4159, # 4848 -6424,6425,4160,6426,3740,6427,6428,6429,6430,3987,6431,4727,6432,2238,6433,6434, # 4864 -4386,3988,6435,6436,3632,6437,6438,2843,6439,6440,6441,6442,3633,6443,2958,6444, # 4880 -6445,3466,6446,2364,4387,3850,6447,4388,2959,3340,6448,3851,6449,4728,6450,6451, # 4896 -3264,4729,6452,3193,6453,4389,4390,2706,3341,4730,6454,3139,6455,3194,6456,3051, # 4912 -2124,3852,1602,4391,4161,3853,1158,3854,4162,3989,4392,3990,4731,4732,4393,2040, # 4928 -4163,4394,3265,6457,2807,3467,3855,6458,6459,6460,3991,3468,4733,4734,6461,3140, # 4944 -2960,6462,4735,6463,6464,6465,6466,4736,4737,4738,4739,6467,6468,4164,2403,3856, # 4960 -6469,6470,2770,2844,6471,4740,6472,6473,6474,6475,6476,6477,6478,3195,6479,4741, # 4976 -4395,6480,2867,6481,4742,2808,6482,2493,4165,6483,6484,6485,6486,2295,4743,6487, # 4992 -6488,6489,3634,6490,6491,6492,6493,6494,6495,6496,2985,4744,6497,6498,4745,6499, # 5008 -6500,2925,3141,4166,6501,6502,4746,6503,6504,4747,6505,6506,6507,2890,6508,6509, # 5024 -6510,6511,6512,6513,6514,6515,6516,6517,6518,6519,3469,4167,6520,6521,6522,4748, # 5040 -4396,3741,4397,4749,4398,3342,2125,4750,6523,4751,4752,4753,3052,6524,2961,4168, # 5056 -6525,4754,6526,4755,4399,2926,4169,6527,3857,6528,4400,4170,6529,4171,6530,6531, # 5072 -2595,6532,6533,6534,6535,3635,6536,6537,6538,6539,6540,6541,6542,4756,6543,6544, # 5088 -6545,6546,6547,6548,4401,6549,6550,6551,6552,4402,3405,4757,4403,6553,6554,6555, # 5104 -4172,3742,6556,6557,6558,3992,3636,6559,6560,3053,2726,6561,3549,4173,3054,4404, # 5120 -6562,6563,3993,4405,3266,3550,2809,4406,6564,6565,6566,4758,4759,6567,3743,6568, # 5136 -4760,3744,4761,3470,6569,6570,6571,4407,6572,3745,4174,6573,4175,2810,4176,3196, # 5152 -4762,6574,4177,6575,6576,2494,2891,3551,6577,6578,3471,6579,4408,6580,3015,3197, # 5168 -6581,3343,2532,3994,3858,6582,3094,3406,4409,6583,2892,4178,4763,4410,3016,4411, # 5184 -6584,3995,3142,3017,2683,6585,4179,6586,6587,4764,4412,6588,6589,4413,6590,2986, # 5200 -6591,2962,3552,6592,2963,3472,6593,6594,4180,4765,6595,6596,2225,3267,4414,6597, # 5216 -3407,3637,4766,6598,6599,3198,6600,4415,6601,3859,3199,6602,3473,4767,2811,4416, # 5232 -1856,3268,3200,2575,3996,3997,3201,4417,6603,3095,2927,6604,3143,6605,2268,6606, # 5248 -3998,3860,3096,2771,6607,6608,3638,2495,4768,6609,3861,6610,3269,2745,4769,4181, # 5264 -3553,6611,2845,3270,6612,6613,6614,3862,6615,6616,4770,4771,6617,3474,3999,4418, # 5280 -4419,6618,3639,3344,6619,4772,4182,6620,2126,6621,6622,6623,4420,4773,6624,3018, # 5296 -6625,4774,3554,6626,4183,2025,3746,6627,4184,2707,6628,4421,4422,3097,1775,4185, # 5312 -3555,6629,6630,2868,6631,6632,4423,6633,6634,4424,2414,2533,2928,6635,4186,2387, # 5328 -6636,4775,6637,4187,6638,1891,4425,3202,3203,6639,6640,4776,6641,3345,6642,6643, # 5344 -3640,6644,3475,3346,3641,4000,6645,3144,6646,3098,2812,4188,3642,3204,6647,3863, # 5360 -3476,6648,3864,6649,4426,4001,6650,6651,6652,2576,6653,4189,4777,6654,6655,6656, # 5376 -2846,6657,3477,3205,4002,6658,4003,6659,3347,2252,6660,6661,6662,4778,6663,6664, # 5392 -6665,6666,6667,6668,6669,4779,4780,2048,6670,3478,3099,6671,3556,3747,4004,6672, # 5408 -6673,6674,3145,4005,3748,6675,6676,6677,6678,6679,3408,6680,6681,6682,6683,3206, # 5424 -3207,6684,6685,4781,4427,6686,4782,4783,4784,6687,6688,6689,4190,6690,6691,3479, # 5440 -6692,2746,6693,4428,6694,6695,6696,6697,6698,6699,4785,6700,6701,3208,2727,6702, # 5456 -3146,6703,6704,3409,2196,6705,4429,6706,6707,6708,2534,1996,6709,6710,6711,2747, # 5472 -6712,6713,6714,4786,3643,6715,4430,4431,6716,3557,6717,4432,4433,6718,6719,6720, # 5488 -6721,3749,6722,4006,4787,6723,6724,3644,4788,4434,6725,6726,4789,2772,6727,6728, # 5504 -6729,6730,6731,2708,3865,2813,4435,6732,6733,4790,4791,3480,6734,6735,6736,6737, # 5520 -4436,3348,6738,3410,4007,6739,6740,4008,6741,6742,4792,3411,4191,6743,6744,6745, # 5536 -6746,6747,3866,6748,3750,6749,6750,6751,6752,6753,6754,6755,3867,6756,4009,6757, # 5552 -4793,4794,6758,2814,2987,6759,6760,6761,4437,6762,6763,6764,6765,3645,6766,6767, # 5568 -3481,4192,6768,3751,6769,6770,2174,6771,3868,3752,6772,6773,6774,4193,4795,4438, # 5584 -3558,4796,4439,6775,4797,6776,6777,4798,6778,4799,3559,4800,6779,6780,6781,3482, # 5600 -6782,2893,6783,6784,4194,4801,4010,6785,6786,4440,6787,4011,6788,6789,6790,6791, # 5616 -6792,6793,4802,6794,6795,6796,4012,6797,6798,6799,6800,3349,4803,3483,6801,4804, # 5632 -4195,6802,4013,6803,6804,4196,6805,4014,4015,6806,2847,3271,2848,6807,3484,6808, # 5648 -6809,6810,4441,6811,4442,4197,4443,3272,4805,6812,3412,4016,1579,6813,6814,4017, # 5664 -6815,3869,6816,2964,6817,4806,6818,6819,4018,3646,6820,6821,4807,4019,4020,6822, # 5680 -6823,3560,6824,6825,4021,4444,6826,4198,6827,6828,4445,6829,6830,4199,4808,6831, # 5696 -6832,6833,3870,3019,2458,6834,3753,3413,3350,6835,4809,3871,4810,3561,4446,6836, # 5712 -6837,4447,4811,4812,6838,2459,4448,6839,4449,6840,6841,4022,3872,6842,4813,4814, # 5728 -6843,6844,4815,4200,4201,4202,6845,4023,6846,6847,4450,3562,3873,6848,6849,4816, # 5744 -4817,6850,4451,4818,2139,6851,3563,6852,6853,3351,6854,6855,3352,4024,2709,3414, # 5760 -4203,4452,6856,4204,6857,6858,3874,3875,6859,6860,4819,6861,6862,6863,6864,4453, # 5776 -3647,6865,6866,4820,6867,6868,6869,6870,4454,6871,2869,6872,6873,4821,6874,3754, # 5792 -6875,4822,4205,6876,6877,6878,3648,4206,4455,6879,4823,6880,4824,3876,6881,3055, # 5808 -4207,6882,3415,6883,6884,6885,4208,4209,6886,4210,3353,6887,3354,3564,3209,3485, # 5824 -2652,6888,2728,6889,3210,3755,6890,4025,4456,6891,4825,6892,6893,6894,6895,4211, # 5840 -6896,6897,6898,4826,6899,6900,4212,6901,4827,6902,2773,3565,6903,4828,6904,6905, # 5856 -6906,6907,3649,3650,6908,2849,3566,6909,3567,3100,6910,6911,6912,6913,6914,6915, # 5872 -4026,6916,3355,4829,3056,4457,3756,6917,3651,6918,4213,3652,2870,6919,4458,6920, # 5888 -2438,6921,6922,3757,2774,4830,6923,3356,4831,4832,6924,4833,4459,3653,2507,6925, # 5904 -4834,2535,6926,6927,3273,4027,3147,6928,3568,6929,6930,6931,4460,6932,3877,4461, # 5920 -2729,3654,6933,6934,6935,6936,2175,4835,2630,4214,4028,4462,4836,4215,6937,3148, # 5936 -4216,4463,4837,4838,4217,6938,6939,2850,4839,6940,4464,6941,6942,6943,4840,6944, # 5952 -4218,3274,4465,6945,6946,2710,6947,4841,4466,6948,6949,2894,6950,6951,4842,6952, # 5968 -4219,3057,2871,6953,6954,6955,6956,4467,6957,2711,6958,6959,6960,3275,3101,4843, # 5984 -6961,3357,3569,6962,4844,6963,6964,4468,4845,3570,6965,3102,4846,3758,6966,4847, # 6000 -3878,4848,4849,4029,6967,2929,3879,4850,4851,6968,6969,1733,6970,4220,6971,6972, # 6016 -6973,6974,6975,6976,4852,6977,6978,6979,6980,6981,6982,3759,6983,6984,6985,3486, # 6032 -3487,6986,3488,3416,6987,6988,6989,6990,6991,6992,6993,6994,6995,6996,6997,4853, # 6048 -6998,6999,4030,7000,7001,3211,7002,7003,4221,7004,7005,3571,4031,7006,3572,7007, # 6064 -2614,4854,2577,7008,7009,2965,3655,3656,4855,2775,3489,3880,4222,4856,3881,4032, # 6080 -3882,3657,2730,3490,4857,7010,3149,7011,4469,4858,2496,3491,4859,2283,7012,7013, # 6096 -7014,2365,4860,4470,7015,7016,3760,7017,7018,4223,1917,7019,7020,7021,4471,7022, # 6112 -2776,4472,7023,7024,7025,7026,4033,7027,3573,4224,4861,4034,4862,7028,7029,1929, # 6128 -3883,4035,7030,4473,3058,7031,2536,3761,3884,7032,4036,7033,2966,2895,1968,4474, # 6144 -3276,4225,3417,3492,4226,2105,7034,7035,1754,2596,3762,4227,4863,4475,3763,4864, # 6160 -3764,2615,2777,3103,3765,3658,3418,4865,2296,3766,2815,7036,7037,7038,3574,2872, # 6176 -3277,4476,7039,4037,4477,7040,7041,4038,7042,7043,7044,7045,7046,7047,2537,7048, # 6192 -7049,7050,7051,7052,7053,7054,4478,7055,7056,3767,3659,4228,3575,7057,7058,4229, # 6208 -7059,7060,7061,3660,7062,3212,7063,3885,4039,2460,7064,7065,7066,7067,7068,7069, # 6224 -7070,7071,7072,7073,7074,4866,3768,4867,7075,7076,7077,7078,4868,3358,3278,2653, # 6240 -7079,7080,4479,3886,7081,7082,4869,7083,7084,7085,7086,7087,7088,2538,7089,7090, # 6256 -7091,4040,3150,3769,4870,4041,2896,3359,4230,2930,7092,3279,7093,2967,4480,3213, # 6272 -4481,3661,7094,7095,7096,7097,7098,7099,7100,7101,7102,2461,3770,7103,7104,4231, # 6288 -3151,7105,7106,7107,4042,3662,7108,7109,4871,3663,4872,4043,3059,7110,7111,7112, # 6304 -3493,2988,7113,4873,7114,7115,7116,3771,4874,7117,7118,4232,4875,7119,3576,2336, # 6320 -4876,7120,4233,3419,4044,4877,4878,4482,4483,4879,4484,4234,7121,3772,4880,1045, # 6336 -3280,3664,4881,4882,7122,7123,7124,7125,4883,7126,2778,7127,4485,4486,7128,4884, # 6352 -3214,3887,7129,7130,3215,7131,4885,4045,7132,7133,4046,7134,7135,7136,7137,7138, # 6368 -7139,7140,7141,7142,7143,4235,7144,4886,7145,7146,7147,4887,7148,7149,7150,4487, # 6384 -4047,4488,7151,7152,4888,4048,2989,3888,7153,3665,7154,4049,7155,7156,7157,7158, # 6400 -7159,7160,2931,4889,4890,4489,7161,2631,3889,4236,2779,7162,7163,4891,7164,3060, # 6416 -7165,1672,4892,7166,4893,4237,3281,4894,7167,7168,3666,7169,3494,7170,7171,4050, # 6432 -7172,7173,3104,3360,3420,4490,4051,2684,4052,7174,4053,7175,7176,7177,2253,4054, # 6448 -7178,7179,4895,7180,3152,3890,3153,4491,3216,7181,7182,7183,2968,4238,4492,4055, # 6464 -7184,2990,7185,2479,7186,7187,4493,7188,7189,7190,7191,7192,4896,7193,4897,2969, # 6480 -4494,4898,7194,3495,7195,7196,4899,4495,7197,3105,2731,7198,4900,7199,7200,7201, # 6496 -4056,7202,3361,7203,7204,4496,4901,4902,7205,4497,7206,7207,2315,4903,7208,4904, # 6512 -7209,4905,2851,7210,7211,3577,7212,3578,4906,7213,4057,3667,4907,7214,4058,2354, # 6528 -3891,2376,3217,3773,7215,7216,7217,7218,7219,4498,7220,4908,3282,2685,7221,3496, # 6544 -4909,2632,3154,4910,7222,2337,7223,4911,7224,7225,7226,4912,4913,3283,4239,4499, # 6560 -7227,2816,7228,7229,7230,7231,7232,7233,7234,4914,4500,4501,7235,7236,7237,2686, # 6576 -7238,4915,7239,2897,4502,7240,4503,7241,2516,7242,4504,3362,3218,7243,7244,7245, # 6592 -4916,7246,7247,4505,3363,7248,7249,7250,7251,3774,4506,7252,7253,4917,7254,7255, # 6608 -3284,2991,4918,4919,3219,3892,4920,3106,3497,4921,7256,7257,7258,4922,7259,4923, # 6624 -3364,4507,4508,4059,7260,4240,3498,7261,7262,4924,7263,2992,3893,4060,3220,7264, # 6640 -7265,7266,7267,7268,7269,4509,3775,7270,2817,7271,4061,4925,4510,3776,7272,4241, # 6656 -4511,3285,7273,7274,3499,7275,7276,7277,4062,4512,4926,7278,3107,3894,7279,7280, # 6672 -4927,7281,4513,7282,7283,3668,7284,7285,4242,4514,4243,7286,2058,4515,4928,4929, # 6688 -4516,7287,3286,4244,7288,4517,7289,7290,7291,3669,7292,7293,4930,4931,4932,2355, # 6704 -4933,7294,2633,4518,7295,4245,7296,7297,4519,7298,7299,4520,4521,4934,7300,4246, # 6720 -4522,7301,7302,7303,3579,7304,4247,4935,7305,4936,7306,7307,7308,7309,3777,7310, # 6736 -4523,7311,7312,7313,4248,3580,7314,4524,3778,4249,7315,3581,7316,3287,7317,3221, # 6752 -7318,4937,7319,7320,7321,7322,7323,7324,4938,4939,7325,4525,7326,7327,7328,4063, # 6768 -7329,7330,4940,7331,7332,4941,7333,4526,7334,3500,2780,1741,4942,2026,1742,7335, # 6784 -7336,3582,4527,2388,7337,7338,7339,4528,7340,4250,4943,7341,7342,7343,4944,7344, # 6800 -7345,7346,3020,7347,4945,7348,7349,7350,7351,3895,7352,3896,4064,3897,7353,7354, # 6816 -7355,4251,7356,7357,3898,7358,3779,7359,3780,3288,7360,7361,4529,7362,4946,4530, # 6832 -2027,7363,3899,4531,4947,3222,3583,7364,4948,7365,7366,7367,7368,4949,3501,4950, # 6848 -3781,4951,4532,7369,2517,4952,4252,4953,3155,7370,4954,4955,4253,2518,4533,7371, # 6864 -7372,2712,4254,7373,7374,7375,3670,4956,3671,7376,2389,3502,4065,7377,2338,7378, # 6880 -7379,7380,7381,3061,7382,4957,7383,7384,7385,7386,4958,4534,7387,7388,2993,7389, # 6896 -3062,7390,4959,7391,7392,7393,4960,3108,4961,7394,4535,7395,4962,3421,4536,7396, # 6912 -4963,7397,4964,1857,7398,4965,7399,7400,2176,3584,4966,7401,7402,3422,4537,3900, # 6928 -3585,7403,3782,7404,2852,7405,7406,7407,4538,3783,2654,3423,4967,4539,7408,3784, # 6944 -3586,2853,4540,4541,7409,3901,7410,3902,7411,7412,3785,3109,2327,3903,7413,7414, # 6960 -2970,4066,2932,7415,7416,7417,3904,3672,3424,7418,4542,4543,4544,7419,4968,7420, # 6976 -7421,4255,7422,7423,7424,7425,7426,4067,7427,3673,3365,4545,7428,3110,2559,3674, # 6992 -7429,7430,3156,7431,7432,3503,7433,3425,4546,7434,3063,2873,7435,3223,4969,4547, # 7008 -4548,2898,4256,4068,7436,4069,3587,3786,2933,3787,4257,4970,4971,3788,7437,4972, # 7024 -3064,7438,4549,7439,7440,7441,7442,7443,4973,3905,7444,2874,7445,7446,7447,7448, # 7040 -3021,7449,4550,3906,3588,4974,7450,7451,3789,3675,7452,2578,7453,4070,7454,7455, # 7056 -7456,4258,3676,7457,4975,7458,4976,4259,3790,3504,2634,4977,3677,4551,4260,7459, # 7072 -7460,7461,7462,3907,4261,4978,7463,7464,7465,7466,4979,4980,7467,7468,2213,4262, # 7088 -7469,7470,7471,3678,4981,7472,2439,7473,4263,3224,3289,7474,3908,2415,4982,7475, # 7104 -4264,7476,4983,2655,7477,7478,2732,4552,2854,2875,7479,7480,4265,7481,4553,4984, # 7120 -7482,7483,4266,7484,3679,3366,3680,2818,2781,2782,3367,3589,4554,3065,7485,4071, # 7136 -2899,7486,7487,3157,2462,4072,4555,4073,4985,4986,3111,4267,2687,3368,4556,4074, # 7152 -3791,4268,7488,3909,2783,7489,2656,1962,3158,4557,4987,1963,3159,3160,7490,3112, # 7168 -4988,4989,3022,4990,4991,3792,2855,7491,7492,2971,4558,7493,7494,4992,7495,7496, # 7184 -7497,7498,4993,7499,3426,4559,4994,7500,3681,4560,4269,4270,3910,7501,4075,4995, # 7200 -4271,7502,7503,4076,7504,4996,7505,3225,4997,4272,4077,2819,3023,7506,7507,2733, # 7216 -4561,7508,4562,7509,3369,3793,7510,3590,2508,7511,7512,4273,3113,2994,2616,7513, # 7232 -7514,7515,7516,7517,7518,2820,3911,4078,2748,7519,7520,4563,4998,7521,7522,7523, # 7248 -7524,4999,4274,7525,4564,3682,2239,4079,4565,7526,7527,7528,7529,5000,7530,7531, # 7264 -5001,4275,3794,7532,7533,7534,3066,5002,4566,3161,7535,7536,4080,7537,3162,7538, # 7280 -7539,4567,7540,7541,7542,7543,7544,7545,5003,7546,4568,7547,7548,7549,7550,7551, # 7296 -7552,7553,7554,7555,7556,5004,7557,7558,7559,5005,7560,3795,7561,4569,7562,7563, # 7312 -7564,2821,3796,4276,4277,4081,7565,2876,7566,5006,7567,7568,2900,7569,3797,3912, # 7328 -7570,7571,7572,4278,7573,7574,7575,5007,7576,7577,5008,7578,7579,4279,2934,7580, # 7344 -7581,5009,7582,4570,7583,4280,7584,7585,7586,4571,4572,3913,7587,4573,3505,7588, # 7360 -5010,7589,7590,7591,7592,3798,4574,7593,7594,5011,7595,4281,7596,7597,7598,4282, # 7376 -5012,7599,7600,5013,3163,7601,5014,7602,3914,7603,7604,2734,4575,4576,4577,7605, # 7392 -7606,7607,7608,7609,3506,5015,4578,7610,4082,7611,2822,2901,2579,3683,3024,4579, # 7408 -3507,7612,4580,7613,3226,3799,5016,7614,7615,7616,7617,7618,7619,7620,2995,3290, # 7424 -7621,4083,7622,5017,7623,7624,7625,7626,7627,4581,3915,7628,3291,7629,5018,7630, # 7440 -7631,7632,7633,4084,7634,7635,3427,3800,7636,7637,4582,7638,5019,4583,5020,7639, # 7456 -3916,7640,3801,5021,4584,4283,7641,7642,3428,3591,2269,7643,2617,7644,4585,3592, # 7472 -7645,4586,2902,7646,7647,3227,5022,7648,4587,7649,4284,7650,7651,7652,4588,2284, # 7488 -7653,5023,7654,7655,7656,4589,5024,3802,7657,7658,5025,3508,4590,7659,7660,7661, # 7504 -1969,5026,7662,7663,3684,1821,2688,7664,2028,2509,4285,7665,2823,1841,7666,2689, # 7520 -3114,7667,3917,4085,2160,5027,5028,2972,7668,5029,7669,7670,7671,3593,4086,7672, # 7536 -4591,4087,5030,3803,7673,7674,7675,7676,7677,7678,7679,4286,2366,4592,4593,3067, # 7552 -2328,7680,7681,4594,3594,3918,2029,4287,7682,5031,3919,3370,4288,4595,2856,7683, # 7568 -3509,7684,7685,5032,5033,7686,7687,3804,2784,7688,7689,7690,7691,3371,7692,7693, # 7584 -2877,5034,7694,7695,3920,4289,4088,7696,7697,7698,5035,7699,5036,4290,5037,5038, # 7600 -5039,7700,7701,7702,5040,5041,3228,7703,1760,7704,5042,3229,4596,2106,4089,7705, # 7616 -4597,2824,5043,2107,3372,7706,4291,4090,5044,7707,4091,7708,5045,3025,3805,4598, # 7632 -4292,4293,4294,3373,7709,4599,7710,5046,7711,7712,5047,5048,3806,7713,7714,7715, # 7648 -5049,7716,7717,7718,7719,4600,5050,7720,7721,7722,5051,7723,4295,3429,7724,7725, # 7664 -7726,7727,3921,7728,3292,5052,4092,7729,7730,7731,7732,7733,7734,7735,5053,5054, # 7680 -7736,7737,7738,7739,3922,3685,7740,7741,7742,7743,2635,5055,7744,5056,4601,7745, # 7696 -7746,2560,7747,7748,7749,7750,3923,7751,7752,7753,7754,7755,4296,2903,7756,7757, # 7712 -7758,7759,7760,3924,7761,5057,4297,7762,7763,5058,4298,7764,4093,7765,7766,5059, # 7728 -3925,7767,7768,7769,7770,7771,7772,7773,7774,7775,7776,3595,7777,4299,5060,4094, # 7744 -7778,3293,5061,7779,7780,4300,7781,7782,4602,7783,3596,7784,7785,3430,2367,7786, # 7760 -3164,5062,5063,4301,7787,7788,4095,5064,5065,7789,3374,3115,7790,7791,7792,7793, # 7776 -7794,7795,7796,3597,4603,7797,7798,3686,3116,3807,5066,7799,7800,5067,7801,7802, # 7792 -4604,4302,5068,4303,4096,7803,7804,3294,7805,7806,5069,4605,2690,7807,3026,7808, # 7808 -7809,7810,7811,7812,7813,7814,7815,7816,7817,7818,7819,7820,7821,7822,7823,7824, # 7824 -7825,7826,7827,7828,7829,7830,7831,7832,7833,7834,7835,7836,7837,7838,7839,7840, # 7840 -7841,7842,7843,7844,7845,7846,7847,7848,7849,7850,7851,7852,7853,7854,7855,7856, # 7856 -7857,7858,7859,7860,7861,7862,7863,7864,7865,7866,7867,7868,7869,7870,7871,7872, # 7872 -7873,7874,7875,7876,7877,7878,7879,7880,7881,7882,7883,7884,7885,7886,7887,7888, # 7888 -7889,7890,7891,7892,7893,7894,7895,7896,7897,7898,7899,7900,7901,7902,7903,7904, # 7904 -7905,7906,7907,7908,7909,7910,7911,7912,7913,7914,7915,7916,7917,7918,7919,7920, # 7920 -7921,7922,7923,7924,3926,7925,7926,7927,7928,7929,7930,7931,7932,7933,7934,7935, # 7936 -7936,7937,7938,7939,7940,7941,7942,7943,7944,7945,7946,7947,7948,7949,7950,7951, # 7952 -7952,7953,7954,7955,7956,7957,7958,7959,7960,7961,7962,7963,7964,7965,7966,7967, # 7968 -7968,7969,7970,7971,7972,7973,7974,7975,7976,7977,7978,7979,7980,7981,7982,7983, # 7984 -7984,7985,7986,7987,7988,7989,7990,7991,7992,7993,7994,7995,7996,7997,7998,7999, # 8000 -8000,8001,8002,8003,8004,8005,8006,8007,8008,8009,8010,8011,8012,8013,8014,8015, # 8016 -8016,8017,8018,8019,8020,8021,8022,8023,8024,8025,8026,8027,8028,8029,8030,8031, # 8032 -8032,8033,8034,8035,8036,8037,8038,8039,8040,8041,8042,8043,8044,8045,8046,8047, # 8048 -8048,8049,8050,8051,8052,8053,8054,8055,8056,8057,8058,8059,8060,8061,8062,8063, # 8064 -8064,8065,8066,8067,8068,8069,8070,8071,8072,8073,8074,8075,8076,8077,8078,8079, # 8080 -8080,8081,8082,8083,8084,8085,8086,8087,8088,8089,8090,8091,8092,8093,8094,8095, # 8096 -8096,8097,8098,8099,8100,8101,8102,8103,8104,8105,8106,8107,8108,8109,8110,8111, # 8112 -8112,8113,8114,8115,8116,8117,8118,8119,8120,8121,8122,8123,8124,8125,8126,8127, # 8128 -8128,8129,8130,8131,8132,8133,8134,8135,8136,8137,8138,8139,8140,8141,8142,8143, # 8144 -8144,8145,8146,8147,8148,8149,8150,8151,8152,8153,8154,8155,8156,8157,8158,8159, # 8160 -8160,8161,8162,8163,8164,8165,8166,8167,8168,8169,8170,8171,8172,8173,8174,8175, # 8176 -8176,8177,8178,8179,8180,8181,8182,8183,8184,8185,8186,8187,8188,8189,8190,8191, # 8192 -8192,8193,8194,8195,8196,8197,8198,8199,8200,8201,8202,8203,8204,8205,8206,8207, # 8208 -8208,8209,8210,8211,8212,8213,8214,8215,8216,8217,8218,8219,8220,8221,8222,8223, # 8224 -8224,8225,8226,8227,8228,8229,8230,8231,8232,8233,8234,8235,8236,8237,8238,8239, # 8240 -8240,8241,8242,8243,8244,8245,8246,8247,8248,8249,8250,8251,8252,8253,8254,8255, # 8256 -8256,8257,8258,8259,8260,8261,8262,8263,8264,8265,8266,8267,8268,8269,8270,8271) # 8272 - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jpcntx.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jpcntx.py deleted file mode 100644 index 59aeb6a8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/jpcntx.py +++ /dev/null @@ -1,227 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .compat import wrap_ord - -NUM_OF_CATEGORY = 6 -DONT_KNOW = -1 -ENOUGH_REL_THRESHOLD = 100 -MAX_REL_THRESHOLD = 1000 -MINIMUM_DATA_THRESHOLD = 4 - -# This is hiragana 2-char sequence table, the number in each cell represents its frequency category -jp2CharContext = ( -(0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1), -(2,4,0,4,0,3,0,4,0,3,4,4,4,2,4,3,3,4,3,2,3,3,4,2,3,3,3,2,4,1,4,3,3,1,5,4,3,4,3,4,3,5,3,0,3,5,4,2,0,3,1,0,3,3,0,3,3,0,1,1,0,4,3,0,3,3,0,4,0,2,0,3,5,5,5,5,4,0,4,1,0,3,4), -(0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2), -(0,4,0,5,0,5,0,4,0,4,5,4,4,3,5,3,5,1,5,3,4,3,4,4,3,4,3,3,4,3,5,4,4,3,5,5,3,5,5,5,3,5,5,3,4,5,5,3,1,3,2,0,3,4,0,4,2,0,4,2,1,5,3,2,3,5,0,4,0,2,0,5,4,4,5,4,5,0,4,0,0,4,4), -(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0), -(0,3,0,4,0,3,0,3,0,4,5,4,3,3,3,3,4,3,5,4,4,3,5,4,4,3,4,3,4,4,4,4,5,3,4,4,3,4,5,5,4,5,5,1,4,5,4,3,0,3,3,1,3,3,0,4,4,0,3,3,1,5,3,3,3,5,0,4,0,3,0,4,4,3,4,3,3,0,4,1,1,3,4), -(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0), -(0,4,0,3,0,3,0,4,0,3,4,4,3,2,2,1,2,1,3,1,3,3,3,3,3,4,3,1,3,3,5,3,3,0,4,3,0,5,4,3,3,5,4,4,3,4,4,5,0,1,2,0,1,2,0,2,2,0,1,0,0,5,2,2,1,4,0,3,0,1,0,4,4,3,5,4,3,0,2,1,0,4,3), -(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0), -(0,3,0,5,0,4,0,2,1,4,4,2,4,1,4,2,4,2,4,3,3,3,4,3,3,3,3,1,4,2,3,3,3,1,4,4,1,1,1,4,3,3,2,0,2,4,3,2,0,3,3,0,3,1,1,0,0,0,3,3,0,4,2,2,3,4,0,4,0,3,0,4,4,5,3,4,4,0,3,0,0,1,4), -(1,4,0,4,0,4,0,4,0,3,5,4,4,3,4,3,5,4,3,3,4,3,5,4,4,4,4,3,4,2,4,3,3,1,5,4,3,2,4,5,4,5,5,4,4,5,4,4,0,3,2,2,3,3,0,4,3,1,3,2,1,4,3,3,4,5,0,3,0,2,0,4,5,5,4,5,4,0,4,0,0,5,4), -(0,5,0,5,0,4,0,3,0,4,4,3,4,3,3,3,4,0,4,4,4,3,4,3,4,3,3,1,4,2,4,3,4,0,5,4,1,4,5,4,4,5,3,2,4,3,4,3,2,4,1,3,3,3,2,3,2,0,4,3,3,4,3,3,3,4,0,4,0,3,0,4,5,4,4,4,3,0,4,1,0,1,3), -(0,3,1,4,0,3,0,2,0,3,4,4,3,1,4,2,3,3,4,3,4,3,4,3,4,4,3,2,3,1,5,4,4,1,4,4,3,5,4,4,3,5,5,4,3,4,4,3,1,2,3,1,2,2,0,3,2,0,3,1,0,5,3,3,3,4,3,3,3,3,4,4,4,4,5,4,2,0,3,3,2,4,3), -(0,2,0,3,0,1,0,1,0,0,3,2,0,0,2,0,1,0,2,1,3,3,3,1,2,3,1,0,1,0,4,2,1,1,3,3,0,4,3,3,1,4,3,3,0,3,3,2,0,0,0,0,1,0,0,2,0,0,0,0,0,4,1,0,2,3,2,2,2,1,3,3,3,4,4,3,2,0,3,1,0,3,3), -(0,4,0,4,0,3,0,3,0,4,4,4,3,3,3,3,3,3,4,3,4,2,4,3,4,3,3,2,4,3,4,5,4,1,4,5,3,5,4,5,3,5,4,0,3,5,5,3,1,3,3,2,2,3,0,3,4,1,3,3,2,4,3,3,3,4,0,4,0,3,0,4,5,4,4,5,3,0,4,1,0,3,4), -(0,2,0,3,0,3,0,0,0,2,2,2,1,0,1,0,0,0,3,0,3,0,3,0,1,3,1,0,3,1,3,3,3,1,3,3,3,0,1,3,1,3,4,0,0,3,1,1,0,3,2,0,0,0,0,1,3,0,1,0,0,3,3,2,0,3,0,0,0,0,0,3,4,3,4,3,3,0,3,0,0,2,3), -(2,3,0,3,0,2,0,1,0,3,3,4,3,1,3,1,1,1,3,1,4,3,4,3,3,3,0,0,3,1,5,4,3,1,4,3,2,5,5,4,4,4,4,3,3,4,4,4,0,2,1,1,3,2,0,1,2,0,0,1,0,4,1,3,3,3,0,3,0,1,0,4,4,4,5,5,3,0,2,0,0,4,4), -(0,2,0,1,0,3,1,3,0,2,3,3,3,0,3,1,0,0,3,0,3,2,3,1,3,2,1,1,0,0,4,2,1,0,2,3,1,4,3,2,0,4,4,3,1,3,1,3,0,1,0,0,1,0,0,0,1,0,0,0,0,4,1,1,1,2,0,3,0,0,0,3,4,2,4,3,2,0,1,0,0,3,3), -(0,1,0,4,0,5,0,4,0,2,4,4,2,3,3,2,3,3,5,3,3,3,4,3,4,2,3,0,4,3,3,3,4,1,4,3,2,1,5,5,3,4,5,1,3,5,4,2,0,3,3,0,1,3,0,4,2,0,1,3,1,4,3,3,3,3,0,3,0,1,0,3,4,4,4,5,5,0,3,0,1,4,5), -(0,2,0,3,0,3,0,0,0,2,3,1,3,0,4,0,1,1,3,0,3,4,3,2,3,1,0,3,3,2,3,1,3,0,2,3,0,2,1,4,1,2,2,0,0,3,3,0,0,2,0,0,0,1,0,0,0,0,2,2,0,3,2,1,3,3,0,2,0,2,0,0,3,3,1,2,4,0,3,0,2,2,3), -(2,4,0,5,0,4,0,4,0,2,4,4,4,3,4,3,3,3,1,2,4,3,4,3,4,4,5,0,3,3,3,3,2,0,4,3,1,4,3,4,1,4,4,3,3,4,4,3,1,2,3,0,4,2,0,4,1,0,3,3,0,4,3,3,3,4,0,4,0,2,0,3,5,3,4,5,2,0,3,0,0,4,5), -(0,3,0,4,0,1,0,1,0,1,3,2,2,1,3,0,3,0,2,0,2,0,3,0,2,0,0,0,1,0,1,1,0,0,3,1,0,0,0,4,0,3,1,0,2,1,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,4,2,2,3,1,0,3,0,0,0,1,4,4,4,3,0,0,4,0,0,1,4), -(1,4,1,5,0,3,0,3,0,4,5,4,4,3,5,3,3,4,4,3,4,1,3,3,3,3,2,1,4,1,5,4,3,1,4,4,3,5,4,4,3,5,4,3,3,4,4,4,0,3,3,1,2,3,0,3,1,0,3,3,0,5,4,4,4,4,4,4,3,3,5,4,4,3,3,5,4,0,3,2,0,4,4), -(0,2,0,3,0,1,0,0,0,1,3,3,3,2,4,1,3,0,3,1,3,0,2,2,1,1,0,0,2,0,4,3,1,0,4,3,0,4,4,4,1,4,3,1,1,3,3,1,0,2,0,0,1,3,0,0,0,0,2,0,0,4,3,2,4,3,5,4,3,3,3,4,3,3,4,3,3,0,2,1,0,3,3), -(0,2,0,4,0,3,0,2,0,2,5,5,3,4,4,4,4,1,4,3,3,0,4,3,4,3,1,3,3,2,4,3,0,3,4,3,0,3,4,4,2,4,4,0,4,5,3,3,2,2,1,1,1,2,0,1,5,0,3,3,2,4,3,3,3,4,0,3,0,2,0,4,4,3,5,5,0,0,3,0,2,3,3), -(0,3,0,4,0,3,0,1,0,3,4,3,3,1,3,3,3,0,3,1,3,0,4,3,3,1,1,0,3,0,3,3,0,0,4,4,0,1,5,4,3,3,5,0,3,3,4,3,0,2,0,1,1,1,0,1,3,0,1,2,1,3,3,2,3,3,0,3,0,1,0,1,3,3,4,4,1,0,1,2,2,1,3), -(0,1,0,4,0,4,0,3,0,1,3,3,3,2,3,1,1,0,3,0,3,3,4,3,2,4,2,0,1,0,4,3,2,0,4,3,0,5,3,3,2,4,4,4,3,3,3,4,0,1,3,0,0,1,0,0,1,0,0,0,0,4,2,3,3,3,0,3,0,0,0,4,4,4,5,3,2,0,3,3,0,3,5), -(0,2,0,3,0,0,0,3,0,1,3,0,2,0,0,0,1,0,3,1,1,3,3,0,0,3,0,0,3,0,2,3,1,0,3,1,0,3,3,2,0,4,2,2,0,2,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,2,1,2,0,1,0,1,0,0,0,1,3,1,2,0,0,0,1,0,0,1,4), -(0,3,0,3,0,5,0,1,0,2,4,3,1,3,3,2,1,1,5,2,1,0,5,1,2,0,0,0,3,3,2,2,3,2,4,3,0,0,3,3,1,3,3,0,2,5,3,4,0,3,3,0,1,2,0,2,2,0,3,2,0,2,2,3,3,3,0,2,0,1,0,3,4,4,2,5,4,0,3,0,0,3,5), -(0,3,0,3,0,3,0,1,0,3,3,3,3,0,3,0,2,0,2,1,1,0,2,0,1,0,0,0,2,1,0,0,1,0,3,2,0,0,3,3,1,2,3,1,0,3,3,0,0,1,0,0,0,0,0,2,0,0,0,0,0,2,3,1,2,3,0,3,0,1,0,3,2,1,0,4,3,0,1,1,0,3,3), -(0,4,0,5,0,3,0,3,0,4,5,5,4,3,5,3,4,3,5,3,3,2,5,3,4,4,4,3,4,3,4,5,5,3,4,4,3,4,4,5,4,4,4,3,4,5,5,4,2,3,4,2,3,4,0,3,3,1,4,3,2,4,3,3,5,5,0,3,0,3,0,5,5,5,5,4,4,0,4,0,1,4,4), -(0,4,0,4,0,3,0,3,0,3,5,4,4,2,3,2,5,1,3,2,5,1,4,2,3,2,3,3,4,3,3,3,3,2,5,4,1,3,3,5,3,4,4,0,4,4,3,1,1,3,1,0,2,3,0,2,3,0,3,0,0,4,3,1,3,4,0,3,0,2,0,4,4,4,3,4,5,0,4,0,0,3,4), -(0,3,0,3,0,3,1,2,0,3,4,4,3,3,3,0,2,2,4,3,3,1,3,3,3,1,1,0,3,1,4,3,2,3,4,4,2,4,4,4,3,4,4,3,2,4,4,3,1,3,3,1,3,3,0,4,1,0,2,2,1,4,3,2,3,3,5,4,3,3,5,4,4,3,3,0,4,0,3,2,2,4,4), -(0,2,0,1,0,0,0,0,0,1,2,1,3,0,0,0,0,0,2,0,1,2,1,0,0,1,0,0,0,0,3,0,0,1,0,1,1,3,1,0,0,0,1,1,0,1,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,1,2,2,0,3,4,0,0,0,1,1,0,0,1,0,0,0,0,0,1,1), -(0,1,0,0,0,1,0,0,0,0,4,0,4,1,4,0,3,0,4,0,3,0,4,0,3,0,3,0,4,1,5,1,4,0,0,3,0,5,0,5,2,0,1,0,0,0,2,1,4,0,1,3,0,0,3,0,0,3,1,1,4,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0), -(1,4,0,5,0,3,0,2,0,3,5,4,4,3,4,3,5,3,4,3,3,0,4,3,3,3,3,3,3,2,4,4,3,1,3,4,4,5,4,4,3,4,4,1,3,5,4,3,3,3,1,2,2,3,3,1,3,1,3,3,3,5,3,3,4,5,0,3,0,3,0,3,4,3,4,4,3,0,3,0,2,4,3), -(0,1,0,4,0,0,0,0,0,1,4,0,4,1,4,2,4,0,3,0,1,0,1,0,0,0,0,0,2,0,3,1,1,1,0,3,0,0,0,1,2,1,0,0,1,1,1,1,0,1,0,0,0,1,0,0,3,0,0,0,0,3,2,0,2,2,0,1,0,0,0,2,3,2,3,3,0,0,0,0,2,1,0), -(0,5,1,5,0,3,0,3,0,5,4,4,5,1,5,3,3,0,4,3,4,3,5,3,4,3,3,2,4,3,4,3,3,0,3,3,1,4,4,3,4,4,4,3,4,5,5,3,2,3,1,1,3,3,1,3,1,1,3,3,2,4,5,3,3,5,0,4,0,3,0,4,4,3,5,3,3,0,3,4,0,4,3), -(0,5,0,5,0,3,0,2,0,4,4,3,5,2,4,3,3,3,4,4,4,3,5,3,5,3,3,1,4,0,4,3,3,0,3,3,0,4,4,4,4,5,4,3,3,5,5,3,2,3,1,2,3,2,0,1,0,0,3,2,2,4,4,3,1,5,0,4,0,3,0,4,3,1,3,2,1,0,3,3,0,3,3), -(0,4,0,5,0,5,0,4,0,4,5,5,5,3,4,3,3,2,5,4,4,3,5,3,5,3,4,0,4,3,4,4,3,2,4,4,3,4,5,4,4,5,5,0,3,5,5,4,1,3,3,2,3,3,1,3,1,0,4,3,1,4,4,3,4,5,0,4,0,2,0,4,3,4,4,3,3,0,4,0,0,5,5), -(0,4,0,4,0,5,0,1,1,3,3,4,4,3,4,1,3,0,5,1,3,0,3,1,3,1,1,0,3,0,3,3,4,0,4,3,0,4,4,4,3,4,4,0,3,5,4,1,0,3,0,0,2,3,0,3,1,0,3,1,0,3,2,1,3,5,0,3,0,1,0,3,2,3,3,4,4,0,2,2,0,4,4), -(2,4,0,5,0,4,0,3,0,4,5,5,4,3,5,3,5,3,5,3,5,2,5,3,4,3,3,4,3,4,5,3,2,1,5,4,3,2,3,4,5,3,4,1,2,5,4,3,0,3,3,0,3,2,0,2,3,0,4,1,0,3,4,3,3,5,0,3,0,1,0,4,5,5,5,4,3,0,4,2,0,3,5), -(0,5,0,4,0,4,0,2,0,5,4,3,4,3,4,3,3,3,4,3,4,2,5,3,5,3,4,1,4,3,4,4,4,0,3,5,0,4,4,4,4,5,3,1,3,4,5,3,3,3,3,3,3,3,0,2,2,0,3,3,2,4,3,3,3,5,3,4,1,3,3,5,3,2,0,0,0,0,4,3,1,3,3), -(0,1,0,3,0,3,0,1,0,1,3,3,3,2,3,3,3,0,3,0,0,0,3,1,3,0,0,0,2,2,2,3,0,0,3,2,0,1,2,4,1,3,3,0,0,3,3,3,0,1,0,0,2,1,0,0,3,0,3,1,0,3,0,0,1,3,0,2,0,1,0,3,3,1,3,3,0,0,1,1,0,3,3), -(0,2,0,3,0,2,1,4,0,2,2,3,1,1,3,1,1,0,2,0,3,1,2,3,1,3,0,0,1,0,4,3,2,3,3,3,1,4,2,3,3,3,3,1,0,3,1,4,0,1,1,0,1,2,0,1,1,0,1,1,0,3,1,3,2,2,0,1,0,0,0,2,3,3,3,1,0,0,0,0,0,2,3), -(0,5,0,4,0,5,0,2,0,4,5,5,3,3,4,3,3,1,5,4,4,2,4,4,4,3,4,2,4,3,5,5,4,3,3,4,3,3,5,5,4,5,5,1,3,4,5,3,1,4,3,1,3,3,0,3,3,1,4,3,1,4,5,3,3,5,0,4,0,3,0,5,3,3,1,4,3,0,4,0,1,5,3), -(0,5,0,5,0,4,0,2,0,4,4,3,4,3,3,3,3,3,5,4,4,4,4,4,4,5,3,3,5,2,4,4,4,3,4,4,3,3,4,4,5,5,3,3,4,3,4,3,3,4,3,3,3,3,1,2,2,1,4,3,3,5,4,4,3,4,0,4,0,3,0,4,4,4,4,4,1,0,4,2,0,2,4), -(0,4,0,4,0,3,0,1,0,3,5,2,3,0,3,0,2,1,4,2,3,3,4,1,4,3,3,2,4,1,3,3,3,0,3,3,0,0,3,3,3,5,3,3,3,3,3,2,0,2,0,0,2,0,0,2,0,0,1,0,0,3,1,2,2,3,0,3,0,2,0,4,4,3,3,4,1,0,3,0,0,2,4), -(0,0,0,4,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,1,0,2,0,1,0,0,0,0,0,3,1,3,0,3,2,0,0,0,1,0,3,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,4,0,2,0,0,0,0,0,0,2), -(0,2,1,3,0,2,0,2,0,3,3,3,3,1,3,1,3,3,3,3,3,3,4,2,2,1,2,1,4,0,4,3,1,3,3,3,2,4,3,5,4,3,3,3,3,3,3,3,0,1,3,0,2,0,0,1,0,0,1,0,0,4,2,0,2,3,0,3,3,0,3,3,4,2,3,1,4,0,1,2,0,2,3), -(0,3,0,3,0,1,0,3,0,2,3,3,3,0,3,1,2,0,3,3,2,3,3,2,3,2,3,1,3,0,4,3,2,0,3,3,1,4,3,3,2,3,4,3,1,3,3,1,1,0,1,1,0,1,0,1,0,1,0,0,0,4,1,1,0,3,0,3,1,0,2,3,3,3,3,3,1,0,0,2,0,3,3), -(0,0,0,0,0,0,0,0,0,0,3,0,2,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,3,0,3,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,2,0,2,3,0,0,0,0,0,0,0,0,3), -(0,2,0,3,1,3,0,3,0,2,3,3,3,1,3,1,3,1,3,1,3,3,3,1,3,0,2,3,1,1,4,3,3,2,3,3,1,2,2,4,1,3,3,0,1,4,2,3,0,1,3,0,3,0,0,1,3,0,2,0,0,3,3,2,1,3,0,3,0,2,0,3,4,4,4,3,1,0,3,0,0,3,3), -(0,2,0,1,0,2,0,0,0,1,3,2,2,1,3,0,1,1,3,0,3,2,3,1,2,0,2,0,1,1,3,3,3,0,3,3,1,1,2,3,2,3,3,1,2,3,2,0,0,1,0,0,0,0,0,0,3,0,1,0,0,2,1,2,1,3,0,3,0,0,0,3,4,4,4,3,2,0,2,0,0,2,4), -(0,0,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,3,1,0,0,0,0,0,0,0,3), -(0,3,0,3,0,2,0,3,0,3,3,3,2,3,2,2,2,0,3,1,3,3,3,2,3,3,0,0,3,0,3,2,2,0,2,3,1,4,3,4,3,3,2,3,1,5,4,4,0,3,1,2,1,3,0,3,1,1,2,0,2,3,1,3,1,3,0,3,0,1,0,3,3,4,4,2,1,0,2,1,0,2,4), -(0,1,0,3,0,1,0,2,0,1,4,2,5,1,4,0,2,0,2,1,3,1,4,0,2,1,0,0,2,1,4,1,1,0,3,3,0,5,1,3,2,3,3,1,0,3,2,3,0,1,0,0,0,0,0,0,1,0,0,0,0,4,0,1,0,3,0,2,0,1,0,3,3,3,4,3,3,0,0,0,0,2,3), -(0,0,0,1,0,0,0,0,0,0,2,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,1,0,0,0,0,0,3), -(0,1,0,3,0,4,0,3,0,2,4,3,1,0,3,2,2,1,3,1,2,2,3,1,1,1,2,1,3,0,1,2,0,1,3,2,1,3,0,5,5,1,0,0,1,3,2,1,0,3,0,0,1,0,0,0,0,0,3,4,0,1,1,1,3,2,0,2,0,1,0,2,3,3,1,2,3,0,1,0,1,0,4), -(0,0,0,1,0,3,0,3,0,2,2,1,0,0,4,0,3,0,3,1,3,0,3,0,3,0,1,0,3,0,3,1,3,0,3,3,0,0,1,2,1,1,1,0,1,2,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,2,2,1,2,0,0,2,0,0,0,0,2,3,3,3,3,0,0,0,0,1,4), -(0,0,0,3,0,3,0,0,0,0,3,1,1,0,3,0,1,0,2,0,1,0,0,0,0,0,0,0,1,0,3,0,2,0,2,3,0,0,2,2,3,1,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,2,3), -(2,4,0,5,0,5,0,4,0,3,4,3,3,3,4,3,3,3,4,3,4,4,5,4,5,5,5,2,3,0,5,5,4,1,5,4,3,1,5,4,3,4,4,3,3,4,3,3,0,3,2,0,2,3,0,3,0,0,3,3,0,5,3,2,3,3,0,3,0,3,0,3,4,5,4,5,3,0,4,3,0,3,4), -(0,3,0,3,0,3,0,3,0,3,3,4,3,2,3,2,3,0,4,3,3,3,3,3,3,3,3,0,3,2,4,3,3,1,3,4,3,4,4,4,3,4,4,3,2,4,4,1,0,2,0,0,1,1,0,2,0,0,3,1,0,5,3,2,1,3,0,3,0,1,2,4,3,2,4,3,3,0,3,2,0,4,4), -(0,3,0,3,0,1,0,0,0,1,4,3,3,2,3,1,3,1,4,2,3,2,4,2,3,4,3,0,2,2,3,3,3,0,3,3,3,0,3,4,1,3,3,0,3,4,3,3,0,1,1,0,1,0,0,0,4,0,3,0,0,3,1,2,1,3,0,4,0,1,0,4,3,3,4,3,3,0,2,0,0,3,3), -(0,3,0,4,0,1,0,3,0,3,4,3,3,0,3,3,3,1,3,1,3,3,4,3,3,3,0,0,3,1,5,3,3,1,3,3,2,5,4,3,3,4,5,3,2,5,3,4,0,1,0,0,0,0,0,2,0,0,1,1,0,4,2,2,1,3,0,3,0,2,0,4,4,3,5,3,2,0,1,1,0,3,4), -(0,5,0,4,0,5,0,2,0,4,4,3,3,2,3,3,3,1,4,3,4,1,5,3,4,3,4,0,4,2,4,3,4,1,5,4,0,4,4,4,4,5,4,1,3,5,4,2,1,4,1,1,3,2,0,3,1,0,3,2,1,4,3,3,3,4,0,4,0,3,0,4,4,4,3,3,3,0,4,2,0,3,4), -(1,4,0,4,0,3,0,1,0,3,3,3,1,1,3,3,2,2,3,3,1,0,3,2,2,1,2,0,3,1,2,1,2,0,3,2,0,2,2,3,3,4,3,0,3,3,1,2,0,1,1,3,1,2,0,0,3,0,1,1,0,3,2,2,3,3,0,3,0,0,0,2,3,3,4,3,3,0,1,0,0,1,4), -(0,4,0,4,0,4,0,0,0,3,4,4,3,1,4,2,3,2,3,3,3,1,4,3,4,0,3,0,4,2,3,3,2,2,5,4,2,1,3,4,3,4,3,1,3,3,4,2,0,2,1,0,3,3,0,0,2,0,3,1,0,4,4,3,4,3,0,4,0,1,0,2,4,4,4,4,4,0,3,2,0,3,3), -(0,0,0,1,0,4,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,3,2,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2), -(0,2,0,3,0,4,0,4,0,1,3,3,3,0,4,0,2,1,2,1,1,1,2,0,3,1,1,0,1,0,3,1,0,0,3,3,2,0,1,1,0,0,0,0,0,1,0,2,0,2,2,0,3,1,0,0,1,0,1,1,0,1,2,0,3,0,0,0,0,1,0,0,3,3,4,3,1,0,1,0,3,0,2), -(0,0,0,3,0,5,0,0,0,0,1,0,2,0,3,1,0,1,3,0,0,0,2,0,0,0,1,0,0,0,1,1,0,0,4,0,0,0,2,3,0,1,4,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,1,0,0,0,0,0,0,0,2,0,0,3,0,0,0,0,0,3), -(0,2,0,5,0,5,0,1,0,2,4,3,3,2,5,1,3,2,3,3,3,0,4,1,2,0,3,0,4,0,2,2,1,1,5,3,0,0,1,4,2,3,2,0,3,3,3,2,0,2,4,1,1,2,0,1,1,0,3,1,0,1,3,1,2,3,0,2,0,0,0,1,3,5,4,4,4,0,3,0,0,1,3), -(0,4,0,5,0,4,0,4,0,4,5,4,3,3,4,3,3,3,4,3,4,4,5,3,4,5,4,2,4,2,3,4,3,1,4,4,1,3,5,4,4,5,5,4,4,5,5,5,2,3,3,1,4,3,1,3,3,0,3,3,1,4,3,4,4,4,0,3,0,4,0,3,3,4,4,5,0,0,4,3,0,4,5), -(0,4,0,4,0,3,0,3,0,3,4,4,4,3,3,2,4,3,4,3,4,3,5,3,4,3,2,1,4,2,4,4,3,1,3,4,2,4,5,5,3,4,5,4,1,5,4,3,0,3,2,2,3,2,1,3,1,0,3,3,3,5,3,3,3,5,4,4,2,3,3,4,3,3,3,2,1,0,3,2,1,4,3), -(0,4,0,5,0,4,0,3,0,3,5,5,3,2,4,3,4,0,5,4,4,1,4,4,4,3,3,3,4,3,5,5,2,3,3,4,1,2,5,5,3,5,5,2,3,5,5,4,0,3,2,0,3,3,1,1,5,1,4,1,0,4,3,2,3,5,0,4,0,3,0,5,4,3,4,3,0,0,4,1,0,4,4), -(1,3,0,4,0,2,0,2,0,2,5,5,3,3,3,3,3,0,4,2,3,4,4,4,3,4,0,0,3,4,5,4,3,3,3,3,2,5,5,4,5,5,5,4,3,5,5,5,1,3,1,0,1,0,0,3,2,0,4,2,0,5,2,3,2,4,1,3,0,3,0,4,5,4,5,4,3,0,4,2,0,5,4), -(0,3,0,4,0,5,0,3,0,3,4,4,3,2,3,2,3,3,3,3,3,2,4,3,3,2,2,0,3,3,3,3,3,1,3,3,3,0,4,4,3,4,4,1,1,4,4,2,0,3,1,0,1,1,0,4,1,0,2,3,1,3,3,1,3,4,0,3,0,1,0,3,1,3,0,0,1,0,2,0,0,4,4), -(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0), -(0,3,0,3,0,2,0,3,0,1,5,4,3,3,3,1,4,2,1,2,3,4,4,2,4,4,5,0,3,1,4,3,4,0,4,3,3,3,2,3,2,5,3,4,3,2,2,3,0,0,3,0,2,1,0,1,2,0,0,0,0,2,1,1,3,1,0,2,0,4,0,3,4,4,4,5,2,0,2,0,0,1,3), -(0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,1,0,0,1,1,0,0,0,4,2,1,1,0,1,0,3,2,0,0,3,1,1,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,1,0,0,0,2,0,0,0,1,4,0,4,2,1,0,0,0,0,0,1), -(0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,1,0,1,0,0,0,0,3,1,0,0,0,2,0,2,1,0,0,1,2,1,0,1,1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,1,3,1,0,0,0,0,0,1,0,0,2,1,0,0,0,0,0,0,0,0,2), -(0,4,0,4,0,4,0,3,0,4,4,3,4,2,4,3,2,0,4,4,4,3,5,3,5,3,3,2,4,2,4,3,4,3,1,4,0,2,3,4,4,4,3,3,3,4,4,4,3,4,1,3,4,3,2,1,2,1,3,3,3,4,4,3,3,5,0,4,0,3,0,4,3,3,3,2,1,0,3,0,0,3,3), -(0,4,0,3,0,3,0,3,0,3,5,5,3,3,3,3,4,3,4,3,3,3,4,4,4,3,3,3,3,4,3,5,3,3,1,3,2,4,5,5,5,5,4,3,4,5,5,3,2,2,3,3,3,3,2,3,3,1,2,3,2,4,3,3,3,4,0,4,0,2,0,4,3,2,2,1,2,0,3,0,0,4,1), -) - -class JapaneseContextAnalysis: - def __init__(self): - self.reset() - - def reset(self): - self._mTotalRel = 0 # total sequence received - # category counters, each interger counts sequence in its category - self._mRelSample = [0] * NUM_OF_CATEGORY - # if last byte in current buffer is not the last byte of a character, - # we need to know how many bytes to skip in next buffer - self._mNeedToSkipCharNum = 0 - self._mLastCharOrder = -1 # The order of previous char - # If this flag is set to True, detection is done and conclusion has - # been made - self._mDone = False - - def feed(self, aBuf, aLen): - if self._mDone: - return - - # The buffer we got is byte oriented, and a character may span in more than one - # buffers. In case the last one or two byte in last buffer is not - # complete, we record how many byte needed to complete that character - # and skip these bytes here. We can choose to record those bytes as - # well and analyse the character once it is complete, but since a - # character will not make much difference, by simply skipping - # this character will simply our logic and improve performance. - i = self._mNeedToSkipCharNum - while i < aLen: - order, charLen = self.get_order(aBuf[i:i + 2]) - i += charLen - if i > aLen: - self._mNeedToSkipCharNum = i - aLen - self._mLastCharOrder = -1 - else: - if (order != -1) and (self._mLastCharOrder != -1): - self._mTotalRel += 1 - if self._mTotalRel > MAX_REL_THRESHOLD: - self._mDone = True - break - self._mRelSample[jp2CharContext[self._mLastCharOrder][order]] += 1 - self._mLastCharOrder = order - - def got_enough_data(self): - return self._mTotalRel > ENOUGH_REL_THRESHOLD - - def get_confidence(self): - # This is just one way to calculate confidence. It works well for me. - if self._mTotalRel > MINIMUM_DATA_THRESHOLD: - return (self._mTotalRel - self._mRelSample[0]) / self._mTotalRel - else: - return DONT_KNOW - - def get_order(self, aBuf): - return -1, 1 - -class SJISContextAnalysis(JapaneseContextAnalysis): - def __init__(self): - self.charset_name = "SHIFT_JIS" - - def get_charset_name(self): - return self.charset_name - - def get_order(self, aBuf): - if not aBuf: - return -1, 1 - # find out current char's byte length - first_char = wrap_ord(aBuf[0]) - if ((0x81 <= first_char <= 0x9F) or (0xE0 <= first_char <= 0xFC)): - charLen = 2 - if (first_char == 0x87) or (0xFA <= first_char <= 0xFC): - self.charset_name = "CP932" - else: - charLen = 1 - - # return its order if it is hiragana - if len(aBuf) > 1: - second_char = wrap_ord(aBuf[1]) - if (first_char == 202) and (0x9F <= second_char <= 0xF1): - return second_char - 0x9F, charLen - - return -1, charLen - -class EUCJPContextAnalysis(JapaneseContextAnalysis): - def get_order(self, aBuf): - if not aBuf: - return -1, 1 - # find out current char's byte length - first_char = wrap_ord(aBuf[0]) - if (first_char == 0x8E) or (0xA1 <= first_char <= 0xFE): - charLen = 2 - elif first_char == 0x8F: - charLen = 3 - else: - charLen = 1 - - # return its order if it is hiragana - if len(aBuf) > 1: - second_char = wrap_ord(aBuf[1]) - if (first_char == 0xA4) and (0xA1 <= second_char <= 0xF3): - return second_char - 0xA1, charLen - - return -1, charLen - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langbulgarianmodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langbulgarianmodel.py deleted file mode 100644 index e5788fc6..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langbulgarianmodel.py +++ /dev/null @@ -1,229 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# 255: Control characters that usually does not exist in any text -# 254: Carriage/Return -# 253: symbol (punctuation) that does not belong to word -# 252: 0 - 9 - -# Character Mapping Table: -# this table is modified base on win1251BulgarianCharToOrderMap, so -# only number <64 is sure valid - -Latin5_BulgarianCharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82, # 40 -110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253, # 50 -253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71, # 60 -116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253, # 70 -194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209, # 80 -210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225, # 90 - 81,226,227,228,229,230,105,231,232,233,234,235,236, 45,237,238, # a0 - 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30, # b0 - 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,239, 67,240, 60, 56, # c0 - 1, 18, 9, 20, 11, 3, 23, 15, 2, 26, 12, 10, 14, 6, 4, 13, # d0 - 7, 8, 5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,241, 42, 16, # e0 - 62,242,243,244, 58,245, 98,246,247,248,249,250,251, 91,252,253, # f0 -) - -win1251BulgarianCharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82, # 40 -110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253, # 50 -253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71, # 60 -116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253, # 70 -206,207,208,209,210,211,212,213,120,214,215,216,217,218,219,220, # 80 -221, 78, 64, 83,121, 98,117,105,222,223,224,225,226,227,228,229, # 90 - 88,230,231,232,233,122, 89,106,234,235,236,237,238, 45,239,240, # a0 - 73, 80,118,114,241,242,243,244,245, 62, 58,246,247,248,249,250, # b0 - 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30, # c0 - 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,251, 67,252, 60, 56, # d0 - 1, 18, 9, 20, 11, 3, 23, 15, 2, 26, 12, 10, 14, 6, 4, 13, # e0 - 7, 8, 5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,253, 42, 16, # f0 -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 96.9392% -# first 1024 sequences:3.0618% -# rest sequences: 0.2992% -# negative sequences: 0.0020% -BulgarianLangModel = ( -0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,3,3,3,3,3, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,2,2,1,2,2, -3,1,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,0,1, -0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,3,3,0,3,1,0, -0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,2,3,2,2,1,3,3,3,3,2,2,2,1,1,2,0,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,2,3,2,2,3,3,1,1,2,3,3,2,3,3,3,3,2,1,2,0,2,0,3,0,0, -0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,1,3,3,3,3,3,2,3,2,3,3,3,3,3,2,3,3,1,3,0,3,0,2,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,3,1,3,3,2,3,3,3,1,3,3,2,3,2,2,2,0,0,2,0,2,0,2,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,3,3,1,2,2,3,2,1,1,2,0,2,0,0,0,0, -1,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,2,3,3,1,2,3,2,2,2,3,3,3,3,3,2,2,3,1,2,0,2,1,2,0,0, -0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,1,3,3,3,3,3,2,3,3,3,2,3,3,2,3,2,2,2,3,1,2,0,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,3,3,3,3,1,1,1,2,2,1,3,1,3,2,2,3,0,0,1,0,1,0,1,0,0, -0,0,0,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,2,2,3,2,2,3,1,2,1,1,1,2,3,1,3,1,2,2,0,1,1,1,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,1,3,2,2,3,3,1,2,3,1,1,3,3,3,3,1,2,2,1,1,1,0,2,0,2,0,1, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,2,2,3,3,3,2,2,1,1,2,0,2,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,0,1,2,1,3,3,2,3,3,3,3,3,2,3,2,1,0,3,1,2,1,2,1,2,3,2,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,1,1,2,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,1,3,3,2,3,3,2,2,2,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,3,0,3,3,3,3,3,2,1,1,2,1,3,3,0,3,1,1,1,1,3,2,0,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,1,1,3,1,3,3,2,3,2,2,2,3,0,2,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,2,3,3,2,2,3,2,1,1,1,1,1,3,1,3,1,1,0,0,0,1,0,0,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,2,3,2,0,3,2,0,3,0,2,0,0,2,1,3,1,0,0,1,0,0,0,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,2,1,1,1,1,2,1,1,2,1,1,1,2,2,1,2,1,1,1,0,1,1,0,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,2,1,3,1,1,2,1,3,2,1,1,0,1,2,3,2,1,1,1,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,3,2,2,1,0,1,0,0,1,0,0,0,2,1,0,3,0,0,1,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,2,3,2,3,3,1,3,2,1,1,1,2,1,1,2,1,3,0,1,0,0,0,1,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,1,2,2,3,3,2,3,2,2,2,3,1,2,2,1,1,2,1,1,2,2,0,1,1,0,1,0,2,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,2,1,3,1,0,2,2,1,3,2,1,0,0,2,0,2,0,1,0,0,0,0,0,0,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,3,1,2,0,2,3,1,2,3,2,0,1,3,1,2,1,1,1,0,0,1,0,0,2,2,2,3, -2,2,2,2,1,2,1,1,2,2,1,1,2,0,1,1,1,0,0,1,1,0,0,1,1,0,0,0,1,1,0,1, -3,3,3,3,3,2,1,2,2,1,2,0,2,0,1,0,1,2,1,2,1,1,0,0,0,1,0,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1, -3,3,2,3,3,1,1,3,1,0,3,2,1,0,0,0,1,2,0,2,0,1,0,0,0,1,0,1,2,1,2,2, -1,1,1,1,1,1,1,2,2,2,1,1,1,1,1,1,1,0,1,2,1,1,1,0,0,0,0,0,1,1,0,0, -3,1,0,1,0,2,3,2,2,2,3,2,2,2,2,2,1,0,2,1,2,1,1,1,0,1,2,1,2,2,2,1, -1,1,2,2,2,2,1,2,1,1,0,1,2,1,2,2,2,1,1,1,0,1,1,1,1,2,0,1,0,0,0,0, -2,3,2,3,3,0,0,2,1,0,2,1,0,0,0,0,2,3,0,2,0,0,0,0,0,1,0,0,2,0,1,2, -2,1,2,1,2,2,1,1,1,2,1,1,1,0,1,2,2,1,1,1,1,1,0,1,1,1,0,0,1,2,0,0, -3,3,2,2,3,0,2,3,1,1,2,0,0,0,1,0,0,2,0,2,0,0,0,1,0,1,0,1,2,0,2,2, -1,1,1,1,2,1,0,1,2,2,2,1,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,1,0,0, -2,3,2,3,3,0,0,3,0,1,1,0,1,0,0,0,2,2,1,2,0,0,0,0,0,0,0,0,2,0,1,2, -2,2,1,1,1,1,1,2,2,2,1,0,2,0,1,0,1,0,0,1,0,1,0,0,1,0,0,0,0,1,0,0, -3,3,3,3,2,2,2,2,2,0,2,1,1,1,1,2,1,2,1,1,0,2,0,1,0,1,0,0,2,0,1,2, -1,1,1,1,1,1,1,2,2,1,1,0,2,0,1,0,2,0,0,1,1,1,0,0,2,0,0,0,1,1,0,0, -2,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0,0,0,0,1,2,0,1,2, -2,2,2,1,1,2,1,1,2,2,2,1,2,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,1,1,0,0, -2,3,3,3,3,0,2,2,0,2,1,0,0,0,1,1,1,2,0,2,0,0,0,3,0,0,0,0,2,0,2,2, -1,1,1,2,1,2,1,1,2,2,2,1,2,0,1,1,1,0,1,1,1,1,0,2,1,0,0,0,1,1,0,0, -2,3,3,3,3,0,2,1,0,0,2,0,0,0,0,0,1,2,0,2,0,0,0,0,0,0,0,0,2,0,1,2, -1,1,1,2,1,1,1,1,2,2,2,0,1,0,1,1,1,0,0,1,1,1,0,0,1,0,0,0,0,1,0,0, -3,3,2,2,3,0,1,0,1,0,0,0,0,0,0,0,1,1,0,3,0,0,0,0,0,0,0,0,1,0,2,2, -1,1,1,1,1,2,1,1,2,2,1,2,2,1,0,1,1,1,1,1,0,1,0,0,1,0,0,0,1,1,0,0, -3,1,0,1,0,2,2,2,2,3,2,1,1,1,2,3,0,0,1,0,2,1,1,0,1,1,1,1,2,1,1,1, -1,2,2,1,2,1,2,2,1,1,0,1,2,1,2,2,1,1,1,0,0,1,1,1,2,1,0,1,0,0,0,0, -2,1,0,1,0,3,1,2,2,2,2,1,2,2,1,1,1,0,2,1,2,2,1,1,2,1,1,0,2,1,1,1, -1,2,2,2,2,2,2,2,1,2,0,1,1,0,2,1,1,1,1,1,0,0,1,1,1,1,0,1,0,0,0,0, -2,1,1,1,1,2,2,2,2,1,2,2,2,1,2,2,1,1,2,1,2,3,2,2,1,1,1,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,3,2,0,1,2,0,1,2,1,1,0,1,0,1,2,1,2,0,0,0,1,1,0,0,0,1,0,0,2, -1,1,0,0,1,1,0,1,1,1,1,0,2,0,1,1,1,0,0,1,1,0,0,0,0,1,0,0,0,1,0,0, -2,0,0,0,0,1,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,2,1,1,1, -1,2,2,2,2,1,1,2,1,2,1,1,1,0,2,1,2,1,1,1,0,2,1,1,1,1,0,1,0,0,0,0, -3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0, -1,1,0,1,0,1,1,1,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,3,2,0,0,0,0,1,0,0,0,0,0,0,1,1,0,2,0,0,0,0,0,0,0,0,1,0,1,2, -1,1,1,1,1,1,0,0,2,2,2,2,2,0,1,1,0,1,1,1,1,1,0,0,1,0,0,0,1,1,0,1, -2,3,1,2,1,0,1,1,0,2,2,2,0,0,1,0,0,1,1,1,1,0,0,0,0,0,0,0,1,0,1,2, -1,1,1,1,2,1,1,1,1,1,1,1,1,0,1,1,0,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0, -2,2,2,2,2,0,0,2,0,0,2,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,0,2,2, -1,1,1,1,1,0,0,1,2,1,1,0,1,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,2,2,0,0,2,0,1,1,0,0,0,1,0,0,2,0,2,0,0,0,0,0,0,0,0,0,0,1,1, -0,0,0,1,1,1,1,1,1,1,1,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,3,2,0,0,1,0,0,1,0,0,0,0,0,0,1,0,2,0,0,0,1,0,0,0,0,0,0,0,2, -1,1,0,0,1,0,0,0,1,1,0,0,1,0,1,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0, -2,1,2,2,2,1,2,1,2,2,1,1,2,1,1,1,0,1,1,1,1,2,0,1,0,1,1,1,1,0,1,1, -1,1,2,1,1,1,1,1,1,0,0,1,2,1,1,1,1,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0, -1,0,0,1,3,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,2,1,0,0,1,0,2,0,0,0,0,0,1,1,1,0,1,0,0,0,0,0,0,0,0,2,0,0,1, -0,2,0,1,0,0,1,1,2,0,1,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,2,2,0,1,1,0,2,1,0,1,1,1,0,0,1,0,2,0,1,0,0,0,0,0,0,0,0,0,1, -0,1,0,0,1,0,0,0,1,1,0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,2,2,0,0,1,0,0,0,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1, -0,1,0,1,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0, -2,0,1,0,0,1,2,1,1,1,1,1,1,2,2,1,0,0,1,0,1,0,0,0,0,1,1,1,1,0,0,0, -1,1,2,1,1,1,1,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,1,2,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1, -0,0,0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0, -0,1,1,0,1,1,1,0,0,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0, -1,0,1,0,0,1,1,1,1,1,1,1,1,1,1,1,0,0,1,0,2,0,0,2,0,1,0,0,1,0,0,1, -1,1,0,0,1,1,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0, -1,1,1,1,1,1,1,2,0,0,0,0,0,0,2,1,0,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,1,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -) - -Latin5BulgarianModel = { - 'charToOrderMap': Latin5_BulgarianCharToOrderMap, - 'precedenceMatrix': BulgarianLangModel, - 'mTypicalPositiveRatio': 0.969392, - 'keepEnglishLetter': False, - 'charsetName': "ISO-8859-5" -} - -Win1251BulgarianModel = { - 'charToOrderMap': win1251BulgarianCharToOrderMap, - 'precedenceMatrix': BulgarianLangModel, - 'mTypicalPositiveRatio': 0.969392, - 'keepEnglishLetter': False, - 'charsetName': "windows-1251" -} - - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langcyrillicmodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langcyrillicmodel.py deleted file mode 100644 index a86f54bd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langcyrillicmodel.py +++ /dev/null @@ -1,329 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# KOI8-R language model -# Character Mapping Table: -KOI8R_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 -191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206, # 80 -207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222, # 90 -223,224,225, 68,226,227,228,229,230,231,232,233,234,235,236,237, # a0 -238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253, # b0 - 27, 3, 21, 28, 13, 2, 39, 19, 26, 4, 23, 11, 8, 12, 5, 1, # c0 - 15, 16, 9, 7, 6, 14, 24, 10, 17, 18, 20, 25, 30, 29, 22, 54, # d0 - 59, 37, 44, 58, 41, 48, 53, 46, 55, 42, 60, 36, 49, 38, 31, 34, # e0 - 35, 43, 45, 32, 40, 52, 56, 33, 61, 62, 51, 57, 47, 63, 50, 70, # f0 -) - -win1251_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 -191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206, -207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222, -223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238, -239,240,241,242,243,244,245,246, 68,247,248,249,250,251,252,253, - 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35, - 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43, - 3, 21, 10, 19, 13, 2, 24, 20, 4, 23, 11, 8, 12, 5, 1, 15, - 9, 7, 6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16, -) - -latin5_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 -191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206, -207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222, -223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238, - 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35, - 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43, - 3, 21, 10, 19, 13, 2, 24, 20, 4, 23, 11, 8, 12, 5, 1, 15, - 9, 7, 6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16, -239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255, -) - -macCyrillic_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 - 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35, - 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43, -191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206, -207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222, -223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238, -239,240,241,242,243,244,245,246,247,248,249,250,251,252, 68, 16, - 3, 21, 10, 19, 13, 2, 24, 20, 4, 23, 11, 8, 12, 5, 1, 15, - 9, 7, 6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27,255, -) - -IBM855_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 -191,192,193,194, 68,195,196,197,198,199,200,201,202,203,204,205, -206,207,208,209,210,211,212,213,214,215,216,217, 27, 59, 54, 70, - 3, 37, 21, 44, 28, 58, 13, 41, 2, 48, 39, 53, 19, 46,218,219, -220,221,222,223,224, 26, 55, 4, 42,225,226,227,228, 23, 60,229, -230,231,232,233,234,235, 11, 36,236,237,238,239,240,241,242,243, - 8, 49, 12, 38, 5, 31, 1, 34, 15,244,245,246,247, 35, 16,248, - 43, 9, 45, 7, 32, 6, 40, 14, 52, 24, 56, 10, 33, 17, 61,249, -250, 18, 62, 20, 51, 25, 57, 30, 47, 29, 63, 22, 50,251,252,255, -) - -IBM866_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154, # 40 -155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253, # 50 -253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69, # 60 - 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253, # 70 - 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35, - 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43, - 3, 21, 10, 19, 13, 2, 24, 20, 4, 23, 11, 8, 12, 5, 1, 15, -191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206, -207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222, -223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238, - 9, 7, 6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16, -239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255, -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 97.6601% -# first 1024 sequences: 2.3389% -# rest sequences: 0.1237% -# negative sequences: 0.0009% -RussianLangModel = ( -0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,1,3,3,3,3,1,3,3,3,2,3,2,3,3, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,2,2,2,2,2,0,0,2, -3,3,3,2,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,2,3,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,2,2,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,2,3,3,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1, -0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1, -0,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,2,2,2,3,1,3,3,1,3,3,3,3,2,2,3,0,2,2,2,3,3,2,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,3,3,3,3,3,2,2,3,2,3,3,3,2,1,2,2,0,1,2,2,2,2,2,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,3,0,2,2,3,3,2,1,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,3,3,1,2,3,2,2,3,2,3,3,3,3,2,2,3,0,3,2,2,3,1,1,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,3,3,3,3,2,2,2,0,3,3,3,2,2,2,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,2,3,2,2,0,1,3,2,1,2,2,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,2,1,1,3,0,1,1,1,1,2,1,1,0,2,2,2,1,2,0,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,3,3,2,2,2,2,1,3,2,3,2,3,2,1,2,2,0,1,1,2,1,2,1,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,2,3,3,3,2,2,2,2,0,2,2,2,2,3,1,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -3,2,3,2,2,3,3,3,3,3,3,3,3,3,1,3,2,0,0,3,3,3,3,2,3,3,3,3,2,3,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,3,3,2,2,3,3,0,2,1,0,3,2,3,2,3,0,0,1,2,0,0,1,0,1,2,1,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,3,0,2,3,3,3,3,2,3,3,3,3,1,2,2,0,0,2,3,2,2,2,3,2,3,2,2,3,0,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,3,0,2,3,2,3,0,1,2,3,3,2,0,2,3,0,0,2,3,2,2,0,1,3,1,3,2,2,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,3,0,2,3,3,3,3,3,3,3,3,2,1,3,2,0,0,2,2,3,3,3,2,3,3,0,2,2,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,2,3,3,2,2,2,3,3,0,0,1,1,1,1,1,2,0,0,1,1,1,1,0,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,2,3,3,3,3,3,3,3,0,3,2,3,3,2,3,2,0,2,1,0,1,1,0,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,3,3,3,2,2,2,2,3,1,3,2,3,1,1,2,1,0,2,2,2,2,1,3,1,0, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -2,2,3,3,3,3,3,1,2,2,1,3,1,0,3,0,0,3,0,0,0,1,1,0,1,2,1,0,0,0,0,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,2,1,1,3,3,3,2,2,1,2,2,3,1,1,2,0,0,2,2,1,3,0,0,2,1,1,2,1,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,3,3,3,3,1,2,2,2,1,2,1,3,3,1,1,2,1,2,1,2,2,0,2,0,0,1,1,0,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,3,3,2,1,3,2,2,3,2,0,3,2,0,3,0,1,0,1,1,0,0,1,1,1,1,0,1,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,2,3,3,3,2,2,2,3,3,1,2,1,2,1,0,1,0,1,1,0,1,0,0,2,1,1,1,0,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0, -3,1,1,2,1,2,3,3,2,2,1,2,2,3,0,2,1,0,0,2,2,3,2,1,2,2,2,2,2,3,1,0, -0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,1,1,0,1,1,2,2,1,1,3,0,0,1,3,1,1,1,0,0,0,1,0,1,1,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,1,3,3,3,2,0,0,0,2,1,0,1,0,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,1,0,0,2,3,2,2,2,1,2,2,2,1,2,1,0,0,1,1,1,0,2,0,1,1,1,0,0,1,1, -1,0,0,0,0,0,1,2,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,3,0,0,0,0,1,0,0,0,0,3,0,1,2,1,0,0,0,0,0,0,0,1,1,0,0,1,1, -1,0,1,0,1,2,0,0,1,1,2,1,0,1,1,1,1,0,1,1,1,1,0,1,0,0,1,0,0,1,1,0, -2,2,3,2,2,2,3,1,2,2,2,2,2,2,2,2,1,1,1,1,1,1,1,0,1,0,1,1,1,0,2,1, -1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,0,1,1,0, -3,3,3,2,2,2,2,3,2,2,1,1,2,2,2,2,1,1,3,1,2,1,2,0,0,1,1,0,1,0,2,1, -1,1,1,1,1,2,1,0,1,1,1,1,0,1,0,0,1,1,0,0,1,0,1,0,0,1,0,0,0,1,1,0, -2,0,0,1,0,3,2,2,2,2,1,2,1,2,1,2,0,0,0,2,1,2,2,1,1,2,2,0,1,1,0,2, -1,1,1,1,1,0,1,1,1,2,1,1,1,2,1,0,1,2,1,1,1,1,0,1,1,1,0,0,1,0,0,1, -1,3,2,2,2,1,1,1,2,3,0,0,0,0,2,0,2,2,1,0,0,0,0,0,0,1,0,0,0,0,1,1, -1,0,1,1,0,1,0,1,1,0,1,1,0,2,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0, -2,3,2,3,2,1,2,2,2,2,1,0,0,0,2,0,0,1,1,0,0,0,0,0,0,0,1,1,0,0,2,1, -1,1,2,1,0,2,0,0,1,0,1,0,0,1,0,0,1,1,0,1,1,0,0,0,0,0,1,0,0,0,0,0, -3,0,0,1,0,2,2,2,3,2,2,2,2,2,2,2,0,0,0,2,1,2,1,1,1,2,2,0,0,0,1,2, -1,1,1,1,1,0,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,1,0,1,1,1,1,1,1,0,0,1, -2,3,2,3,3,2,0,1,1,1,0,0,1,0,2,0,1,1,3,1,0,0,0,0,0,0,0,1,0,0,2,1, -1,1,1,1,1,1,1,0,1,0,1,1,1,1,0,1,1,1,0,0,1,1,0,1,0,0,0,0,0,0,1,0, -2,3,3,3,3,1,2,2,2,2,0,1,1,0,2,1,1,1,2,1,0,1,1,0,0,1,0,1,0,0,2,0, -0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,3,3,2,0,0,1,1,2,2,1,0,0,2,0,1,1,3,0,0,1,0,0,0,0,0,1,0,1,2,1, -1,1,2,0,1,1,1,0,1,0,1,1,0,1,0,1,1,1,1,0,1,0,0,0,0,0,0,1,0,1,1,0, -1,3,2,3,2,1,0,0,2,2,2,0,1,0,2,0,1,1,1,0,1,0,0,0,3,0,1,1,0,0,2,1, -1,1,1,0,1,1,0,0,0,0,1,1,0,1,0,0,2,1,1,0,1,0,0,0,1,0,1,0,0,1,1,0, -3,1,2,1,1,2,2,2,2,2,2,1,2,2,1,1,0,0,0,2,2,2,0,0,0,1,2,1,0,1,0,1, -2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,2,1,1,1,0,1,0,1,1,0,1,1,1,0,0,1, -3,0,0,0,0,2,0,1,1,1,1,1,1,1,0,1,0,0,0,1,1,1,0,1,0,1,1,0,0,1,0,1, -1,1,0,0,1,0,0,0,1,0,1,1,0,0,1,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,1, -1,3,3,2,2,0,0,0,2,2,0,0,0,1,2,0,1,1,2,0,0,0,0,0,0,0,0,1,0,0,2,1, -0,1,1,0,0,1,1,0,0,0,1,1,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0, -2,3,2,3,2,0,0,0,0,1,1,0,0,0,2,0,2,0,2,0,0,0,0,0,1,0,0,1,0,0,1,1, -1,1,2,0,1,2,1,0,1,1,2,1,1,1,1,1,2,1,1,0,1,0,0,1,1,1,1,1,0,1,1,0, -1,3,2,2,2,1,0,0,2,2,1,0,1,2,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,1,1, -0,0,1,1,0,1,1,0,0,1,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,1,0,2,3,1,2,2,2,2,2,2,1,1,0,0,0,1,0,1,0,2,1,1,1,0,0,0,0,1, -1,1,0,1,1,0,1,1,1,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0, -2,0,2,0,0,1,0,3,2,1,2,1,2,2,0,1,0,0,0,2,1,0,0,2,1,1,1,1,0,2,0,2, -2,1,1,1,1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,0,0,0,1,1,1,1,0,1,0,0,1, -1,2,2,2,2,1,0,0,1,0,0,0,0,0,2,0,1,1,1,1,0,0,0,0,1,0,1,2,0,0,2,0, -1,0,1,1,1,2,1,0,1,0,1,1,0,0,1,0,1,1,1,0,1,0,0,0,1,0,0,1,0,1,1,0, -2,1,2,2,2,0,3,0,1,1,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -0,0,0,1,1,1,0,0,1,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0, -1,2,2,3,2,2,0,0,1,1,2,0,1,2,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1, -0,1,1,0,0,1,1,0,0,1,1,0,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0, -2,2,1,1,2,1,2,2,2,2,2,1,2,2,0,1,0,0,0,1,2,2,2,1,2,1,1,1,1,1,2,1, -1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,0,1, -1,2,2,2,2,0,1,0,2,2,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0, -0,0,1,0,0,1,0,0,0,0,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,2,2,0,0,0,2,2,2,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,1, -0,1,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,2,2,0,0,0,0,1,0,0,1,1,2,0,0,0,0,1,0,1,0,0,1,0,0,2,0,0,0,1, -0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0, -1,2,2,2,1,1,2,0,2,1,1,1,1,0,2,2,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,1, -0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -1,0,2,1,2,0,0,0,0,0,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0, -0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0, -1,0,0,0,0,2,0,1,2,1,0,1,1,1,0,1,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,1, -0,0,0,0,0,1,0,0,1,1,0,0,1,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1, -2,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -1,0,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -1,1,1,0,1,0,1,0,0,1,1,1,1,0,0,0,1,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -1,1,0,1,1,0,1,0,1,0,0,0,0,1,1,0,1,1,0,0,0,0,0,1,0,1,1,0,1,0,0,0, -0,1,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0, -) - -Koi8rModel = { - 'charToOrderMap': KOI8R_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "KOI8-R" -} - -Win1251CyrillicModel = { - 'charToOrderMap': win1251_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "windows-1251" -} - -Latin5CyrillicModel = { - 'charToOrderMap': latin5_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "ISO-8859-5" -} - -MacCyrillicModel = { - 'charToOrderMap': macCyrillic_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "MacCyrillic" -}; - -Ibm866Model = { - 'charToOrderMap': IBM866_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "IBM866" -} - -Ibm855Model = { - 'charToOrderMap': IBM855_CharToOrderMap, - 'precedenceMatrix': RussianLangModel, - 'mTypicalPositiveRatio': 0.976601, - 'keepEnglishLetter': False, - 'charsetName': "IBM855" -} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langgreekmodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langgreekmodel.py deleted file mode 100644 index ddb58376..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langgreekmodel.py +++ /dev/null @@ -1,225 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# 255: Control characters that usually does not exist in any text -# 254: Carriage/Return -# 253: symbol (punctuation) that does not belong to word -# 252: 0 - 9 - -# Character Mapping Table: -Latin7_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85, # 40 - 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253, # 50 -253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55, # 60 - 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253, # 70 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 80 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 90 -253,233, 90,253,253,253,253,253,253,253,253,253,253, 74,253,253, # a0 -253,253,253,253,247,248, 61, 36, 46, 71, 73,253, 54,253,108,123, # b0 -110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39, # c0 - 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15, # d0 -124, 1, 29, 20, 21, 3, 32, 13, 25, 5, 11, 16, 10, 6, 30, 4, # e0 - 9, 8, 14, 7, 2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253, # f0 -) - -win1253_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85, # 40 - 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253, # 50 -253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55, # 60 - 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253, # 70 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 80 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 90 -253,233, 61,253,253,253,253,253,253,253,253,253,253, 74,253,253, # a0 -253,253,253,253,247,253,253, 36, 46, 71, 73,253, 54,253,108,123, # b0 -110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39, # c0 - 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15, # d0 -124, 1, 29, 20, 21, 3, 32, 13, 25, 5, 11, 16, 10, 6, 30, 4, # e0 - 9, 8, 14, 7, 2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253, # f0 -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 98.2851% -# first 1024 sequences:1.7001% -# rest sequences: 0.0359% -# negative sequences: 0.0148% -GreekLangModel = ( -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,2,2,3,3,3,3,3,3,3,3,1,3,3,3,0,2,2,3,3,0,3,0,3,2,0,3,3,3,0, -3,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,0,3,3,0,3,2,3,3,0,3,2,3,3,3,0,0,3,0,3,0,3,3,2,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0, -0,2,3,2,2,3,3,3,3,3,3,3,3,0,3,3,3,3,0,2,3,3,0,3,3,3,3,2,3,3,3,0, -2,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,2,1,3,3,3,3,2,3,3,2,3,3,2,0, -0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,2,3,3,0, -2,0,1,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,2,3,0,0,0,0,3,3,0,3,1,3,3,3,0,3,3,0,3,3,3,3,0,0,0,0, -2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,0,3,0,3,3,3,3,3,0,3,2,2,2,3,0,2,3,3,3,3,3,2,3,3,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,3,2,2,2,3,3,3,3,0,3,1,3,3,3,3,2,3,3,3,3,3,3,3,2,2,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,2,0,3,0,0,0,3,3,2,3,3,3,3,3,0,0,3,2,3,0,2,3,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,3,3,3,3,0,0,3,3,0,2,3,0,3,0,3,3,3,0,0,3,0,3,0,2,2,3,3,0,0, -0,0,1,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,2,0,3,2,3,3,3,3,0,3,3,3,3,3,0,3,3,2,3,2,3,3,2,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,2,3,2,3,3,3,3,3,3,0,2,3,2,3,2,2,2,3,2,3,3,2,3,0,2,2,2,3,0, -2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,0,0,0,3,3,3,2,3,3,0,0,3,0,3,0,0,0,3,2,0,3,0,3,0,0,2,0,2,0, -0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,0,0,0,3,3,0,3,3,3,0,0,1,2,3,0, -3,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,2,0,0,3,2,2,3,3,0,3,3,3,3,3,2,1,3,0,3,2,3,3,2,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,3,0,2,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,3,0,3,2,3,0,0,3,3,3,0, -3,0,0,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,0,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,2,0,3,2,3,0,0,3,2,3,0, -2,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,1,2,2,3,3,3,3,3,3,0,2,3,0,3,0,0,0,3,3,0,3,0,2,0,0,2,3,1,0, -2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,3,3,3,3,0,3,0,3,3,2,3,0,3,3,3,3,3,3,0,3,3,3,0,2,3,0,0,3,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,3,3,3,0,0,3,0,0,0,3,3,0,3,0,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,0,0,0,3,3,3,3,3,3,0,0,3,0,2,0,0,0,3,3,0,3,0,3,0,0,2,0,2,0, -0,0,0,0,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,3,0,3,0,2,0,3,2,0,3,2,3,2,3,0,0,3,2,3,2,3,3,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,0,0,2,3,3,3,3,3,0,0,0,3,0,2,1,0,0,3,2,2,2,0,3,0,0,2,2,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,3,3,3,2,0,3,0,3,0,3,3,0,2,1,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,3,3,3,0,3,3,3,3,3,3,0,2,3,0,3,0,0,0,2,1,0,2,2,3,0,0,2,2,2,0, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,3,0,0,2,3,3,3,2,3,0,0,1,3,0,2,0,0,0,0,3,0,1,0,2,0,0,1,1,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,3,1,0,3,0,0,0,3,2,0,3,2,3,3,3,0,0,3,0,3,2,2,2,1,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,3,3,3,0,0,3,0,0,0,0,2,0,2,3,3,2,2,2,2,3,0,2,0,2,2,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,3,3,3,2,0,0,0,0,0,0,2,3,0,2,0,2,3,2,0,0,3,0,3,0,3,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,3,2,3,3,2,2,3,0,2,0,3,0,0,0,2,0,0,0,0,1,2,0,2,0,2,0, -0,2,0,2,0,2,2,0,0,1,0,2,2,2,0,2,2,2,0,2,2,2,0,0,2,0,0,1,0,0,0,0, -0,2,0,3,3,2,0,0,0,0,0,0,1,3,0,2,0,2,2,2,0,0,2,0,3,0,0,2,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,0,2,3,2,0,2,2,0,2,0,2,2,0,2,0,2,2,2,0,0,0,0,0,0,2,3,0,0,0,2, -0,1,2,0,0,0,0,2,2,0,0,0,2,1,0,2,2,0,0,0,0,0,0,1,0,2,0,0,0,0,0,0, -0,0,2,1,0,2,3,2,2,3,2,3,2,0,0,3,3,3,0,0,3,2,0,0,0,1,1,0,2,0,2,2, -0,2,0,2,0,2,2,0,0,2,0,2,2,2,0,2,2,2,2,0,0,2,0,0,0,2,0,1,0,0,0,0, -0,3,0,3,3,2,2,0,3,0,0,0,2,2,0,2,2,2,1,2,0,0,1,2,2,0,0,3,0,0,0,2, -0,1,2,0,0,0,1,2,0,0,0,0,0,0,0,2,2,0,1,0,0,2,0,0,0,2,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,3,3,2,2,0,0,0,2,0,2,3,3,0,2,0,0,0,0,0,0,2,2,2,0,2,2,0,2,0,2, -0,2,2,0,0,2,2,2,2,1,0,0,2,2,0,2,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0, -0,2,0,3,2,3,0,0,0,3,0,0,2,2,0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,0,2, -0,0,2,2,0,0,2,2,2,0,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,2,0,0,3,2,0,2,2,2,2,2,0,0,0,2,0,0,0,0,2,0,1,0,0,2,0,1,0,0,0, -0,2,2,2,0,2,2,0,1,2,0,2,2,2,0,2,2,2,2,1,2,2,0,0,2,0,0,0,0,0,0,0, -0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -0,2,0,2,0,2,2,0,0,0,0,1,2,1,0,0,2,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,3,2,3,0,0,2,0,0,0,2,2,0,2,0,0,0,1,0,0,2,0,2,0,2,2,0,0,0,0, -0,0,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0, -0,2,2,3,2,2,0,0,0,0,0,0,1,3,0,2,0,2,2,0,0,0,1,0,2,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,0,2,0,3,2,0,2,0,0,0,0,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -0,0,2,0,0,0,0,1,1,0,0,2,1,2,0,2,2,0,1,0,0,1,0,0,0,2,0,0,0,0,0,0, -0,3,0,2,2,2,0,0,2,0,0,0,2,0,0,0,2,3,0,2,0,0,0,0,0,0,2,2,0,0,0,2, -0,1,2,0,0,0,1,2,2,1,0,0,0,2,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,1,2,0,2,2,0,2,0,0,2,0,0,0,0,1,2,1,0,2,1,0,0,0,0,0,0,0,0,0,0, -0,0,2,0,0,0,3,1,2,2,0,2,0,0,0,0,2,0,0,0,2,0,0,3,0,0,0,0,2,2,2,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,1,0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,2, -0,2,2,0,0,2,2,2,2,2,0,1,2,0,0,0,2,2,0,1,0,2,0,0,2,2,0,0,0,0,0,0, -0,0,0,0,1,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,0,0,0,0,2,0,2,0,0,0,0,2, -0,1,2,0,0,0,0,2,2,1,0,1,0,1,0,2,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0, -0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,2,0,0,2,2,0,0,0,0,1,0,0,0,0,0,0,2, -0,2,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0, -0,2,2,2,2,0,0,0,3,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,1, -0,0,2,0,0,0,0,1,2,0,0,0,0,0,0,2,2,1,1,0,0,0,0,0,0,1,0,0,0,0,0,0, -0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,2,2,2,0,0,0,2,0,0,0,0,0,0,0,0,2, -0,0,1,0,0,0,0,2,1,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0, -0,3,0,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,2, -0,0,2,0,0,0,0,2,2,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,2,0,2,2,1,0,0,0,0,0,0,2,0,0,2,0,2,2,2,0,0,0,0,0,0,2,0,0,0,0,2, -0,0,2,0,0,2,0,2,2,0,0,0,0,2,0,2,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0, -0,0,3,0,0,0,2,2,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,0,0, -0,2,2,2,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1, -0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -0,2,0,0,0,2,0,0,0,0,0,1,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,2,0,0,0, -0,2,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,2,0,2,0,0,0, -0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -) - -Latin7GreekModel = { - 'charToOrderMap': Latin7_CharToOrderMap, - 'precedenceMatrix': GreekLangModel, - 'mTypicalPositiveRatio': 0.982851, - 'keepEnglishLetter': False, - 'charsetName': "ISO-8859-7" -} - -Win1253GreekModel = { - 'charToOrderMap': win1253_CharToOrderMap, - 'precedenceMatrix': GreekLangModel, - 'mTypicalPositiveRatio': 0.982851, - 'keepEnglishLetter': False, - 'charsetName': "windows-1253" -} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhebrewmodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhebrewmodel.py deleted file mode 100644 index 75f2bc7f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhebrewmodel.py +++ /dev/null @@ -1,201 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Simon Montagu -# Portions created by the Initial Developer are Copyright (C) 2005 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# Shoshannah Forbes - original C code (?) -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# 255: Control characters that usually does not exist in any text -# 254: Carriage/Return -# 253: symbol (punctuation) that does not belong to word -# 252: 0 - 9 - -# Windows-1255 language model -# Character Mapping Table: -win1255_CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 69, 91, 79, 80, 92, 89, 97, 90, 68,111,112, 82, 73, 95, 85, # 40 - 78,121, 86, 71, 67,102,107, 84,114,103,115,253,253,253,253,253, # 50 -253, 50, 74, 60, 61, 42, 76, 70, 64, 53,105, 93, 56, 65, 54, 49, # 60 - 66,110, 51, 43, 44, 63, 81, 77, 98, 75,108,253,253,253,253,253, # 70 -124,202,203,204,205, 40, 58,206,207,208,209,210,211,212,213,214, -215, 83, 52, 47, 46, 72, 32, 94,216,113,217,109,218,219,220,221, - 34,116,222,118,100,223,224,117,119,104,125,225,226, 87, 99,227, -106,122,123,228, 55,229,230,101,231,232,120,233, 48, 39, 57,234, - 30, 59, 41, 88, 33, 37, 36, 31, 29, 35,235, 62, 28,236,126,237, -238, 38, 45,239,240,241,242,243,127,244,245,246,247,248,249,250, - 9, 8, 20, 16, 3, 2, 24, 14, 22, 1, 25, 15, 4, 11, 6, 23, - 12, 19, 13, 26, 18, 27, 21, 17, 7, 10, 5,251,252,128, 96,253, -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 98.4004% -# first 1024 sequences: 1.5981% -# rest sequences: 0.087% -# negative sequences: 0.0015% -HebrewLangModel = ( -0,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,3,2,1,2,0,1,0,0, -3,0,3,1,0,0,1,3,2,0,1,1,2,0,2,2,2,1,1,1,1,2,1,1,1,2,0,0,2,2,0,1, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2, -1,2,1,2,1,2,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2, -1,2,1,3,1,1,0,0,2,0,0,0,1,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,1,2,2,1,3, -1,2,1,1,2,2,0,0,2,2,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,1,0,1,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,2,2,2,3,2, -1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,3,2,2,3,2,2,2,1,2,2,2,2, -1,2,1,1,2,2,0,1,2,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,0,2,2,2,2,2, -0,2,0,2,2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,0,2,2,2, -0,2,1,2,2,2,0,0,2,1,0,0,0,0,1,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,2,1,2,3,2,2,2, -1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,0, -3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,2,0,2, -0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,2,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,2,2,3,2,1,2,1,1,1, -0,1,1,1,1,1,3,0,1,0,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,1,1,0,0,1,0,0,1,0,0,0,0, -0,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2, -0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,2,3,3,3,2,1,2,3,3,2,3,3,3,3,2,3,2,1,2,0,2,1,2, -0,2,0,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0, -3,3,3,3,3,3,3,3,3,2,3,3,3,1,2,2,3,3,2,3,2,3,2,2,3,1,2,2,0,2,2,2, -0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,1,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,2,2,3,3,3,3,1,3,2,2,2, -0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,2,3,2,2,2,1,2,2,0,2,2,2,2, -0,2,0,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,1,3,2,3,3,2,3,3,2,2,1,2,2,2,2,2,2, -0,2,1,2,1,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,2,3,2,3,3,2,3,3,3,3,2,3,2,3,3,3,3,3,2,2,2,2,2,2,2,1, -0,2,0,1,2,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,2,1,2,3,3,3,3,3,3,3,2,3,2,3,2,1,2,3,0,2,1,2,2, -0,2,1,1,2,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,2,0, -3,3,3,3,3,3,3,3,3,2,3,3,3,3,2,1,3,1,2,2,2,1,2,3,3,1,2,1,2,2,2,2, -0,1,1,1,1,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,0,2,3,3,3,1,3,3,3,1,2,2,2,2,1,1,2,2,2,2,2,2, -0,2,0,1,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,2,3,3,3,2,2,3,3,3,2,1,2,3,2,3,2,2,2,2,1,2,1,1,1,2,2, -0,2,1,1,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,1,0,0,0,0,0, -1,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,2,3,3,2,3,1,2,2,2,2,3,2,3,1,1,2,2,1,2,2,1,1,0,2,2,2,2, -0,1,0,1,2,2,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0, -3,0,0,1,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,2,2,0, -0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,1,0,1,0,1,1,0,1,1,0,0,0,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,0,0,1,1,0,1,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -3,2,2,1,2,2,2,2,2,2,2,1,2,2,1,2,2,1,1,1,1,1,1,1,1,2,1,1,0,3,3,3, -0,3,0,2,2,2,2,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -2,2,2,3,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,2,1,2,2,2,1,1,1,2,0,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,2,2,2,2,2,2,0,2,2,0,0,0,0,0,0, -0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,1,0,2,1,0, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,1,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0, -0,3,1,1,2,2,2,2,2,1,2,2,2,1,1,2,2,2,2,2,2,2,1,2,2,1,0,1,1,1,1,0, -0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,2,1,1,1,1,2,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0, -0,0,2,0,0,0,0,0,0,0,0,1,1,0,0,0,0,1,1,0,0,1,1,0,0,0,0,0,0,1,0,0, -2,1,1,2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,1,2,1,2,1,1,1,1,0,0,0,0, -0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,2,1,2,2,2,2,2,2,2,2,2,2,1,2,1,2,1,1,2,1,1,1,2,1,2,1,2,0,1,0,1, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,3,1,2,2,2,1,2,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,2,1,2,1,1,0,1,0,1, -0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,1,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,2,2, -0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,1,1,1,1,1,1,1,0,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,2,0,1,1,1,0,1,0,0,0,1,1,0,1,1,0,0,0,0,0,1,1,0,0, -0,1,1,1,2,1,2,2,2,0,2,0,2,0,1,1,2,1,1,1,1,2,1,0,1,1,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,1,0,0,0,0,0,1,0,1,2,2,0,1,0,0,1,1,2,2,1,2,0,2,0,0,0,1,2,0,1, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,2,0,2,1,2,0,2,0,0,1,1,1,1,1,1,0,1,0,0,0,1,0,0,1, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,1,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,1,2,2,0,0,1,0,0,0,1,0,0,1, -1,1,2,1,0,1,1,1,0,1,0,1,1,1,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,2,1, -0,2,0,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,1,0,0,1,0,1,1,1,1,0,0,0,0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,1,0,0,0,1,1,0,1, -2,0,1,0,1,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,1,1,1,0,1,0,0,1,1,2,1,1,2,0,1,0,0,0,1,1,0,1, -1,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,0,0,2,1,1,2,0,2,0,0,0,1,1,0,1, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,2,2,1,2,1,1,0,1,0,0,0,1,1,0,1, -2,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,1,0,1, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,2,1,1,1,0,2,1,1,0,0,0,2,1,0,1, -1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,0,2,1,1,0,1,0,0,0,1,1,0,1, -2,2,1,1,1,0,1,1,0,1,1,0,1,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,0,1,2,1,0,2,0,0,0,1,1,0,1, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0, -0,1,0,0,2,0,2,1,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,1,0,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,1,0,1,0,0,1,0,0,0,1,0,0,1, -1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,0,0,0,0,0,1,0,1,1,0,0,1,0,0,2,1,1,1,1,1,0,1,0,0,0,0,1,0,1, -0,1,1,1,2,1,1,1,1,0,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,1,2,1,0,0,0,0,0,1,1,1,1,1,0,1,0,0,0,1,1,0,0, -) - -Win1255HebrewModel = { - 'charToOrderMap': win1255_CharToOrderMap, - 'precedenceMatrix': HebrewLangModel, - 'mTypicalPositiveRatio': 0.984004, - 'keepEnglishLetter': False, - 'charsetName': "windows-1255" -} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhungarianmodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhungarianmodel.py deleted file mode 100644 index 49d2f0fe..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langhungarianmodel.py +++ /dev/null @@ -1,225 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# 255: Control characters that usually does not exist in any text -# 254: Carriage/Return -# 253: symbol (punctuation) that does not belong to word -# 252: 0 - 9 - -# Character Mapping Table: -Latin2_HungarianCharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47, - 46, 71, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253, -253, 2, 18, 26, 17, 1, 27, 12, 20, 9, 22, 7, 6, 13, 4, 8, - 23, 67, 10, 5, 3, 21, 19, 65, 62, 16, 11,253,253,253,253,253, -159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174, -175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190, -191,192,193,194,195,196,197, 75,198,199,200,201,202,203,204,205, - 79,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220, -221, 51, 81,222, 78,223,224,225,226, 44,227,228,229, 61,230,231, -232,233,234, 58,235, 66, 59,236,237,238, 60, 69, 63,239,240,241, - 82, 14, 74,242, 70, 80,243, 72,244, 15, 83, 77, 84, 30, 76, 85, -245,246,247, 25, 73, 42, 24,248,249,250, 31, 56, 29,251,252,253, -) - -win1250HungarianCharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47, - 46, 72, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253, -253, 2, 18, 26, 17, 1, 27, 12, 20, 9, 22, 7, 6, 13, 4, 8, - 23, 67, 10, 5, 3, 21, 19, 65, 62, 16, 11,253,253,253,253,253, -161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176, -177,178,179,180, 78,181, 69,182,183,184,185,186,187,188,189,190, -191,192,193,194,195,196,197, 76,198,199,200,201,202,203,204,205, - 81,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220, -221, 51, 83,222, 80,223,224,225,226, 44,227,228,229, 61,230,231, -232,233,234, 58,235, 66, 59,236,237,238, 60, 70, 63,239,240,241, - 84, 14, 75,242, 71, 82,243, 73,244, 15, 85, 79, 86, 30, 77, 87, -245,246,247, 25, 74, 42, 24,248,249,250, 31, 56, 29,251,252,253, -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 94.7368% -# first 1024 sequences:5.2623% -# rest sequences: 0.8894% -# negative sequences: 0.0009% -HungarianLangModel = ( -0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3, -3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,2,3,3,1,1,2,2,2,2,2,1,2, -3,2,2,3,3,3,3,3,2,3,3,3,3,3,3,1,2,3,3,3,3,2,3,3,1,1,3,3,0,1,1,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0, -3,2,1,3,3,3,3,3,2,3,3,3,3,3,1,1,2,3,3,3,3,3,3,3,1,1,3,2,0,1,1,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,1,1,2,3,3,3,1,3,3,3,3,3,1,3,3,2,2,0,3,2,3, -0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,3,3,2,3,3,2,2,3,2,3,2,0,3,2,2, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0, -3,3,3,3,3,3,2,3,3,3,3,3,2,3,3,3,1,2,3,2,2,3,1,2,3,3,2,2,0,3,3,3, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,3,2,3,3,3,3,2,3,3,3,3,0,2,3,2, -0,0,0,1,1,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,3,3,3,1,1,1,3,3,2,1,3,2,2,3,2,1,3,2,2,1,0,3,3,1, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,2,2,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,3,2,2,3,1,1,3,2,0,1,1,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,1,3,3,3,3,3,2,2,1,3,3,3,0,1,1,2, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0, -3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,2,0,3,2,3, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,1,0, -3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,1,3,2,2,2,3,1,1,3,3,1,1,0,3,3,2, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,2,3,3,3,3,3,1,2,3,2,2,0,2,2,2, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,2,2,2,3,1,3,3,2,2,1,3,3,3,1,1,3,1,2,3,2,3,2,2,2,1,0,2,2,2, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0, -3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,2,2,3,2,1,0,3,2,0,1,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,1,0,3,3,3,3,0,2,3,0,0,2,1,0,1,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,2,2,3,3,2,2,2,2,3,3,0,1,2,3,2,3,2,2,3,2,1,2,0,2,2,2, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0, -3,3,3,3,3,3,1,2,3,3,3,2,1,2,3,3,2,2,2,3,2,3,3,1,3,3,1,1,0,2,3,2, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,1,2,2,2,2,3,3,3,1,1,1,3,3,1,1,3,1,1,3,2,1,2,3,1,1,0,2,2,2, -0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,2,1,2,1,1,3,3,1,1,1,1,3,3,1,1,2,2,1,2,1,1,2,2,1,1,0,2,2,1, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,1,1,2,1,1,3,3,1,0,1,1,3,3,2,0,1,1,2,3,1,0,2,2,1,0,0,1,3,2, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,2,1,3,3,3,3,3,1,2,3,2,3,3,2,1,1,3,2,3,2,1,2,2,0,1,2,1,0,0,1,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,3,3,2,2,2,2,3,1,2,2,1,1,3,3,0,3,2,1,2,3,2,1,3,3,1,1,0,2,1,3, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,3,3,2,2,2,3,2,3,3,3,2,1,1,3,3,1,1,1,2,2,3,2,3,2,2,2,1,0,2,2,1, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -1,0,0,3,3,3,3,3,0,0,3,3,2,3,0,0,0,2,3,3,1,0,1,2,0,0,1,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,2,3,3,3,3,3,1,2,3,3,2,2,1,1,0,3,3,2,2,1,2,2,1,0,2,2,0,1,1,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,2,2,1,3,1,2,3,3,2,2,1,1,2,2,1,1,1,1,3,2,1,1,1,1,2,1,0,1,2,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0, -2,3,3,1,1,1,1,1,3,3,3,0,1,1,3,3,1,1,1,1,1,2,2,0,3,1,1,2,0,2,1,1, -0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, -3,1,0,1,2,1,2,2,0,1,2,3,1,2,0,0,0,2,1,1,1,1,1,2,0,0,1,1,0,0,0,0, -1,2,1,2,2,2,1,2,1,2,0,2,0,2,2,1,1,2,1,1,2,1,1,1,0,1,0,0,0,1,1,0, -1,1,1,2,3,2,3,3,0,1,2,2,3,1,0,1,0,2,1,2,2,0,1,1,0,0,1,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,3,3,2,2,1,0,0,3,2,3,2,0,0,0,1,1,3,0,0,1,1,0,0,2,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,1,2,2,3,3,1,0,1,3,2,3,1,1,1,0,1,1,1,1,1,3,1,0,0,2,2,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,1,1,2,2,2,1,0,1,2,3,3,2,0,0,0,2,1,1,1,2,1,1,1,0,1,1,1,0,0,0, -1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,2,1,1,1,1,1,1,0,1,1,1,0,0,1,1, -3,2,2,1,0,0,1,1,2,2,0,3,0,1,2,1,1,0,0,1,1,1,0,1,1,1,1,0,2,1,1,1, -2,2,1,1,1,2,1,2,1,1,1,1,1,1,1,2,1,1,1,2,3,1,1,1,1,1,1,1,1,1,0,1, -2,3,3,0,1,0,0,0,3,3,1,0,0,1,2,2,1,0,0,0,0,2,0,0,1,1,1,0,2,1,1,1, -2,1,1,1,1,1,1,2,1,1,0,1,1,0,1,1,1,0,1,2,1,1,0,1,1,1,1,1,1,1,0,1, -2,3,3,0,1,0,0,0,2,2,0,0,0,0,1,2,2,0,0,0,0,1,0,0,1,1,0,0,2,0,1,0, -2,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1, -3,2,2,0,1,0,1,0,2,3,2,0,0,1,2,2,1,0,0,1,1,1,0,0,2,1,0,1,2,2,1,1, -2,1,1,1,1,1,1,2,1,1,1,1,1,1,0,2,1,0,1,1,0,1,1,1,0,1,1,2,1,1,0,1, -2,2,2,0,0,1,0,0,2,2,1,1,0,0,2,1,1,0,0,0,1,2,0,0,2,1,0,0,2,1,1,1, -2,1,1,1,1,2,1,2,1,1,1,2,2,1,1,2,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1, -1,2,3,0,0,0,1,0,3,2,1,0,0,1,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,2,1, -1,1,0,0,0,1,0,1,1,1,1,1,2,0,0,1,0,0,0,2,0,0,1,1,1,1,1,1,1,1,0,1, -3,0,0,2,1,2,2,1,0,0,2,1,2,2,0,0,0,2,1,1,1,0,1,1,0,0,1,1,2,0,0,0, -1,2,1,2,2,1,1,2,1,2,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,0,0,1, -1,3,2,0,0,0,1,0,2,2,2,0,0,0,2,2,1,0,0,0,0,3,1,1,1,1,0,0,2,1,1,1, -2,1,0,1,1,1,0,1,1,1,1,1,1,1,0,2,1,0,0,1,0,1,1,0,1,1,1,1,1,1,0,1, -2,3,2,0,0,0,1,0,2,2,0,0,0,0,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,1,0, -2,1,1,1,1,2,1,2,1,2,0,1,1,1,0,2,1,1,1,2,1,1,1,1,0,1,1,1,1,1,0,1, -3,1,1,2,2,2,3,2,1,1,2,2,1,1,0,1,0,2,2,1,1,1,1,1,0,0,1,1,0,1,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,0,0,0,0,0,2,2,0,0,0,0,2,2,1,0,0,0,1,1,0,0,1,2,0,0,2,1,1,1, -2,2,1,1,1,2,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,1,1,0,1,2,1,1,1,0,1, -1,0,0,1,2,3,2,1,0,0,2,0,1,1,0,0,0,1,1,1,1,0,1,1,0,0,1,0,0,0,0,0, -1,2,1,2,1,2,1,1,1,2,0,2,1,1,1,0,1,2,0,0,1,1,1,0,0,0,0,0,0,0,0,0, -2,3,2,0,0,0,0,0,1,1,2,1,0,0,1,1,1,0,0,0,0,2,0,0,1,1,0,0,2,1,1,1, -2,1,1,1,1,1,1,2,1,0,1,1,1,1,0,2,1,1,1,1,1,1,0,1,0,1,1,1,1,1,0,1, -1,2,2,0,1,1,1,0,2,2,2,0,0,0,3,2,1,0,0,0,1,1,0,0,1,1,0,1,1,1,0,0, -1,1,0,1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,0,0,1,1,1,0,1,0,1, -2,1,0,2,1,1,2,2,1,1,2,1,1,1,0,0,0,1,1,0,1,1,1,1,0,0,1,1,1,0,0,0, -1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,1,0, -1,2,3,0,0,0,1,0,2,2,0,0,0,0,2,2,0,0,0,0,0,1,0,0,1,0,0,0,2,0,1,0, -2,1,1,1,1,1,0,2,0,0,0,1,2,1,1,1,1,0,1,2,0,1,0,1,0,1,1,1,0,1,0,1, -2,2,2,0,0,0,1,0,2,1,2,0,0,0,1,1,2,0,0,0,0,1,0,0,1,1,0,0,2,1,0,1, -2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1, -1,2,2,0,0,0,1,0,2,2,2,0,0,0,1,1,0,0,0,0,0,1,1,0,2,0,0,1,1,1,0,1, -1,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,0,0,1,1,0,1,0,1,1,1,1,1,0,0,0,1, -1,0,0,1,0,1,2,1,0,0,1,1,1,2,0,0,0,1,1,0,1,0,1,1,0,0,1,0,0,0,0,0, -0,2,1,2,1,1,1,1,1,2,0,2,0,1,1,0,1,2,1,0,1,1,1,0,0,0,0,0,0,1,0,0, -2,1,1,0,1,2,0,0,1,1,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,2,1,0,1, -2,2,1,1,1,1,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,0,1,0,1,1,1,1,1,0,1, -1,2,2,0,0,0,0,0,1,1,0,0,0,0,2,1,0,0,0,0,0,2,0,0,2,2,0,0,2,0,0,1, -2,1,1,1,1,1,1,1,0,1,1,0,1,1,0,1,0,0,0,1,1,1,1,0,0,1,1,1,1,0,0,1, -1,1,2,0,0,3,1,0,2,1,1,1,0,0,1,1,1,0,0,0,1,1,0,0,0,1,0,0,1,0,1,0, -1,2,1,0,1,1,1,2,1,1,0,1,1,1,1,1,0,0,0,1,1,1,1,1,0,1,0,0,0,1,0,0, -2,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,2,0,0,0, -2,1,1,1,1,1,1,1,1,1,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,1,0,1, -2,1,1,1,2,1,1,1,0,1,1,2,1,0,0,0,0,1,1,1,1,0,1,0,0,0,0,1,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,1,0,1,1,1,1,1,0,0,1,1,2,1,0,0,0,1,1,0,0,0,1,1,0,0,1,0,1,0,0,0, -1,2,1,1,1,1,1,1,1,1,0,1,0,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0, -2,0,0,0,1,1,1,1,0,0,1,1,0,0,0,0,0,1,1,1,2,0,0,1,0,0,1,0,1,0,0,0, -0,1,1,1,1,1,1,1,1,2,0,1,1,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0, -1,0,0,1,1,1,1,1,0,0,2,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0, -0,1,1,1,1,1,1,0,1,1,0,1,0,1,1,0,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0,0, -1,0,0,1,1,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -0,1,1,1,1,1,0,0,1,1,0,1,0,1,0,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0, -0,0,0,1,0,0,0,0,0,0,1,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,1,1,1,0,1,0,0,1,1,0,1,0,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0, -2,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,0,1,0,0,1,0,1,0,1,1,1,0,0,1,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,0,1,1,1,1,0,0,0,1,1,1,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0, -0,1,1,1,1,1,1,0,1,1,0,1,0,1,0,0,1,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0, -) - -Latin2HungarianModel = { - 'charToOrderMap': Latin2_HungarianCharToOrderMap, - 'precedenceMatrix': HungarianLangModel, - 'mTypicalPositiveRatio': 0.947368, - 'keepEnglishLetter': True, - 'charsetName': "ISO-8859-2" -} - -Win1250HungarianModel = { - 'charToOrderMap': win1250HungarianCharToOrderMap, - 'precedenceMatrix': HungarianLangModel, - 'mTypicalPositiveRatio': 0.947368, - 'keepEnglishLetter': True, - 'charsetName': "windows-1250" -} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langthaimodel.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langthaimodel.py deleted file mode 100644 index 0508b1b1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/langthaimodel.py +++ /dev/null @@ -1,200 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Communicator client code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -# 255: Control characters that usually does not exist in any text -# 254: Carriage/Return -# 253: symbol (punctuation) that does not belong to word -# 252: 0 - 9 - -# The following result for thai was collected from a limited sample (1M). - -# Character Mapping Table: -TIS620CharToOrderMap = ( -255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255, # 00 -255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255, # 10 -253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253, # 20 -252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253, # 30 -253,182,106,107,100,183,184,185,101, 94,186,187,108,109,110,111, # 40 -188,189,190, 89, 95,112,113,191,192,193,194,253,253,253,253,253, # 50 -253, 64, 72, 73,114, 74,115,116,102, 81,201,117, 90,103, 78, 82, # 60 - 96,202, 91, 79, 84,104,105, 97, 98, 92,203,253,253,253,253,253, # 70 -209,210,211,212,213, 88,214,215,216,217,218,219,220,118,221,222, -223,224, 99, 85, 83,225,226,227,228,229,230,231,232,233,234,235, -236, 5, 30,237, 24,238, 75, 8, 26, 52, 34, 51,119, 47, 58, 57, - 49, 53, 55, 43, 20, 19, 44, 14, 48, 3, 17, 25, 39, 62, 31, 54, - 45, 9, 16, 2, 61, 15,239, 12, 42, 46, 18, 21, 76, 4, 66, 63, - 22, 10, 1, 36, 23, 13, 40, 27, 32, 35, 86,240,241,242,243,244, - 11, 28, 41, 29, 33,245, 50, 37, 6, 7, 67, 77, 38, 93,246,247, - 68, 56, 59, 65, 69, 60, 70, 80, 71, 87,248,249,250,251,252,253, -) - -# Model Table: -# total sequences: 100% -# first 512 sequences: 92.6386% -# first 1024 sequences:7.3177% -# rest sequences: 1.0230% -# negative sequences: 0.0436% -ThaiLangModel = ( -0,1,3,3,3,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,0,0,3,3,3,0,3,3,3,3, -0,3,3,0,0,0,1,3,0,3,3,2,3,3,0,1,2,3,3,3,3,0,2,0,2,0,0,3,2,1,2,2, -3,0,3,3,2,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,0,3,2,3,0,2,2,2,3, -0,2,3,0,0,0,0,1,0,1,2,3,1,1,3,2,2,0,1,1,0,0,1,0,0,0,0,0,0,0,1,1, -3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2,3,3,2,3,2,3,3,2,2,2, -3,1,2,3,0,3,3,2,2,1,2,3,3,1,2,0,1,3,0,1,0,0,1,0,0,0,0,0,0,0,1,1, -3,3,2,2,3,3,3,3,1,2,3,3,3,3,3,2,2,2,2,3,3,2,2,3,3,2,2,3,2,3,2,2, -3,3,1,2,3,1,2,2,3,3,1,0,2,1,0,0,3,1,2,1,0,0,1,0,0,0,0,0,0,1,0,1, -3,3,3,3,3,3,2,2,3,3,3,3,2,3,2,2,3,3,2,2,3,2,2,2,2,1,1,3,1,2,1,1, -3,2,1,0,2,1,0,1,0,1,1,0,1,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0, -3,3,3,2,3,2,3,3,2,2,3,2,3,3,2,3,1,1,2,3,2,2,2,3,2,2,2,2,2,1,2,1, -2,2,1,1,3,3,2,1,0,1,2,2,0,1,3,0,0,0,1,1,0,0,0,0,0,2,3,0,0,2,1,1, -3,3,2,3,3,2,0,0,3,3,0,3,3,0,2,2,3,1,2,2,1,1,1,0,2,2,2,0,2,2,1,1, -0,2,1,0,2,0,0,2,0,1,0,0,1,0,0,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0,1,0, -3,3,2,3,3,2,0,0,3,3,0,2,3,0,2,1,2,2,2,2,1,2,0,0,2,2,2,0,2,2,1,1, -0,2,1,0,2,0,0,2,0,1,1,0,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0, -3,3,2,3,2,3,2,0,2,2,1,3,2,1,3,2,1,2,3,2,2,3,0,2,3,2,2,1,2,2,2,2, -1,2,2,0,0,0,0,2,0,1,2,0,1,1,1,0,1,0,3,1,1,0,0,0,0,0,0,0,0,0,1,0, -3,3,2,3,3,2,3,2,2,2,3,2,2,3,2,2,1,2,3,2,2,3,1,3,2,2,2,3,2,2,2,3, -3,2,1,3,0,1,1,1,0,2,1,1,1,1,1,0,1,0,1,1,0,0,0,0,0,0,0,0,0,2,0,0, -1,0,0,3,0,3,3,3,3,3,0,0,3,0,2,2,3,3,3,3,3,0,0,0,1,1,3,0,0,0,0,2, -0,0,1,0,0,0,0,0,0,0,2,3,0,0,0,3,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0, -2,0,3,3,3,3,0,0,2,3,0,0,3,0,3,3,2,3,3,3,3,3,0,0,3,3,3,0,0,0,3,3, -0,0,3,0,0,0,0,2,0,0,2,1,1,3,0,0,1,0,0,2,3,0,1,0,0,0,0,0,0,0,1,0, -3,3,3,3,2,3,3,3,3,3,3,3,1,2,1,3,3,2,2,1,2,2,2,3,1,1,2,0,2,1,2,1, -2,2,1,0,0,0,1,1,0,1,0,1,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0, -3,0,2,1,2,3,3,3,0,2,0,2,2,0,2,1,3,2,2,1,2,1,0,0,2,2,1,0,2,1,2,2, -0,1,1,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,2,1,3,3,1,1,3,0,2,3,1,1,3,2,1,1,2,0,2,2,3,2,1,1,1,1,1,2, -3,0,0,1,3,1,2,1,2,0,3,0,0,0,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0, -3,3,1,1,3,2,3,3,3,1,3,2,1,3,2,1,3,2,2,2,2,1,3,3,1,2,1,3,1,2,3,0, -2,1,1,3,2,2,2,1,2,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2, -3,3,2,3,2,3,3,2,3,2,3,2,3,3,2,1,0,3,2,2,2,1,2,2,2,1,2,2,1,2,1,1, -2,2,2,3,0,1,3,1,1,1,1,0,1,1,0,2,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,2,3,2,2,1,1,3,2,3,2,3,2,0,3,2,2,1,2,0,2,2,2,1,2,2,2,2,1, -3,2,1,2,2,1,0,2,0,1,0,0,1,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,1, -3,3,3,3,3,2,3,1,2,3,3,2,2,3,0,1,1,2,0,3,3,2,2,3,0,1,1,3,0,0,0,0, -3,1,0,3,3,0,2,0,2,1,0,0,3,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,2,3,2,3,3,0,1,3,1,1,2,1,2,1,1,3,1,1,0,2,3,1,1,1,1,1,1,1,1, -3,1,1,2,2,2,2,1,1,1,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,2,2,1,1,2,1,3,3,2,3,2,2,3,2,2,3,1,2,2,1,2,0,3,2,1,2,2,2,2,2,1, -3,2,1,2,2,2,1,1,1,1,0,0,1,1,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,3,3,3,3,1,3,3,0,2,1,0,3,2,0,0,3,1,0,1,1,0,1,0,0,0,0,0,1, -1,0,0,1,0,3,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,2,2,2,3,0,0,1,3,0,3,2,0,3,2,2,3,3,3,3,3,1,0,2,2,2,0,2,2,1,2, -0,2,3,0,0,0,0,1,0,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, -3,0,2,3,1,3,3,2,3,3,0,3,3,0,3,2,2,3,2,3,3,3,0,0,2,2,3,0,1,1,1,3, -0,0,3,0,0,0,2,2,0,1,3,0,1,2,2,2,3,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1, -3,2,3,3,2,0,3,3,2,2,3,1,3,2,1,3,2,0,1,2,2,0,2,3,2,1,0,3,0,0,0,0, -3,0,0,2,3,1,3,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,1,3,2,2,2,1,2,0,1,3,1,1,3,1,3,0,0,2,1,1,1,1,2,1,1,1,0,2,1,0,1, -1,2,0,0,0,3,1,1,0,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,0,3,1,0,0,0,1,0, -3,3,3,3,2,2,2,2,2,1,3,1,1,1,2,0,1,1,2,1,2,1,3,2,0,0,3,1,1,1,1,1, -3,1,0,2,3,0,0,0,3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,2,3,0,3,3,0,2,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,2,3,1,3,0,0,1,2,0,0,2,0,3,3,2,3,3,3,2,3,0,0,2,2,2,0,0,0,2,2, -0,0,1,0,0,0,0,3,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -0,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,1,2,3,1,3,3,0,0,1,0,3,0,0,0,0,0, -0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,1,2,3,1,2,3,1,0,3,0,2,2,1,0,2,1,1,2,0,1,0,0,1,1,1,1,0,1,0,0, -1,0,0,0,0,1,1,0,3,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,3,3,2,1,0,1,1,1,3,1,2,2,2,2,2,2,1,1,1,1,0,3,1,0,1,3,1,1,1,1, -1,1,0,2,0,1,3,1,1,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,1, -3,0,2,2,1,3,3,2,3,3,0,1,1,0,2,2,1,2,1,3,3,1,0,0,3,2,0,0,0,0,2,1, -0,1,0,0,0,0,1,2,0,1,1,3,1,1,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0, -0,0,3,0,0,1,0,0,0,3,0,0,3,0,3,1,0,1,1,1,3,2,0,0,0,3,0,0,0,0,2,0, -0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0, -3,3,1,3,2,1,3,3,1,2,2,0,1,2,1,0,1,2,0,0,0,0,0,3,0,0,0,3,0,0,0,0, -3,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,1,2,0,3,3,3,2,2,0,1,1,0,1,3,0,0,0,2,2,0,0,0,0,3,1,0,1,0,0,0, -0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,2,3,1,2,0,0,2,1,0,3,1,0,1,2,0,1,1,1,1,3,0,0,3,1,1,0,2,2,1,1, -0,2,0,0,0,0,0,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,0,3,1,2,0,0,2,2,0,1,2,0,1,0,1,3,1,2,1,0,0,0,2,0,3,0,0,0,1,0, -0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,1,1,2,2,0,0,0,2,0,2,1,0,1,1,0,1,1,1,2,1,0,0,1,1,1,0,2,1,1,1, -0,1,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,1, -0,0,0,2,0,1,3,1,1,1,1,0,0,0,0,3,2,0,1,0,0,0,1,2,0,0,0,1,0,0,0,0, -0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,0,2,3,2,2,0,0,0,1,0,0,0,0,2,3,2,1,2,2,3,0,0,0,2,3,1,0,0,0,1,1, -0,0,1,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0, -3,3,2,2,0,1,0,0,0,0,2,0,2,0,1,0,0,0,1,1,0,0,0,2,1,0,1,0,1,1,0,0, -0,1,0,2,0,0,1,0,3,0,1,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,1,0,0,1,0,0,0,0,0,1,1,2,0,0,0,0,1,0,0,1,3,1,0,0,0,0,1,1,0,0, -0,1,0,0,0,0,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0, -3,3,1,1,1,1,2,3,0,0,2,1,1,1,1,1,0,2,1,1,0,0,0,2,1,0,1,2,1,1,0,1, -2,1,0,3,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,3,1,0,0,0,0,0,0,0,3,0,0,0,3,0,0,0,0,0,0,0,0,1,1,0,0,0,0,0,0,1, -0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,3,2,0,0,0,0,0,0,1,2,1,0,1,1,0,2,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,2,0,0,0,1,3,0,1,0,0,0,2,0,0,0,0,0,0,0,1,2,0,0,0,0,0, -3,3,0,0,1,1,2,0,0,1,2,1,0,1,1,1,0,1,1,0,0,2,1,1,0,1,0,0,1,1,1,0, -0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,2,2,1,0,0,0,0,1,0,0,0,0,3,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0, -2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,3,0,0,1,1,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -1,1,0,1,2,0,1,2,0,0,1,1,0,2,0,1,0,0,1,0,0,0,0,1,0,0,0,2,0,0,0,0, -1,0,0,1,0,1,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,1,0,0,0,0,0,0,0,1,1,0,1,1,0,2,1,3,0,0,0,0,1,1,0,0,0,0,0,0,0,3, -1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,1,0,1,0,0,2,0,0,2,0,0,1,1,2,0,0,1,1,0,0,0,1,0,0,0,1,1,0,0,0, -1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0, -1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,3,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0, -1,0,0,0,0,0,0,0,0,1,0,0,0,0,2,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,1,1,0,0,2,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, -) - -TIS620ThaiModel = { - 'charToOrderMap': TIS620CharToOrderMap, - 'precedenceMatrix': ThaiLangModel, - 'mTypicalPositiveRatio': 0.926386, - 'keepEnglishLetter': False, - 'charsetName': "TIS-620" -} - -# flake8: noqa diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/latin1prober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/latin1prober.py deleted file mode 100644 index eef35735..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/latin1prober.py +++ /dev/null @@ -1,139 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .charsetprober import CharSetProber -from .constants import eNotMe -from .compat import wrap_ord - -FREQ_CAT_NUM = 4 - -UDF = 0 # undefined -OTH = 1 # other -ASC = 2 # ascii capital letter -ASS = 3 # ascii small letter -ACV = 4 # accent capital vowel -ACO = 5 # accent capital other -ASV = 6 # accent small vowel -ASO = 7 # accent small other -CLASS_NUM = 8 # total classes - -Latin1_CharToClass = ( - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 00 - 07 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 08 - 0F - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 10 - 17 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 18 - 1F - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 20 - 27 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 28 - 2F - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 30 - 37 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 38 - 3F - OTH, ASC, ASC, ASC, ASC, ASC, ASC, ASC, # 40 - 47 - ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC, # 48 - 4F - ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC, # 50 - 57 - ASC, ASC, ASC, OTH, OTH, OTH, OTH, OTH, # 58 - 5F - OTH, ASS, ASS, ASS, ASS, ASS, ASS, ASS, # 60 - 67 - ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS, # 68 - 6F - ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS, # 70 - 77 - ASS, ASS, ASS, OTH, OTH, OTH, OTH, OTH, # 78 - 7F - OTH, UDF, OTH, ASO, OTH, OTH, OTH, OTH, # 80 - 87 - OTH, OTH, ACO, OTH, ACO, UDF, ACO, UDF, # 88 - 8F - UDF, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # 90 - 97 - OTH, OTH, ASO, OTH, ASO, UDF, ASO, ACO, # 98 - 9F - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # A0 - A7 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # A8 - AF - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # B0 - B7 - OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH, # B8 - BF - ACV, ACV, ACV, ACV, ACV, ACV, ACO, ACO, # C0 - C7 - ACV, ACV, ACV, ACV, ACV, ACV, ACV, ACV, # C8 - CF - ACO, ACO, ACV, ACV, ACV, ACV, ACV, OTH, # D0 - D7 - ACV, ACV, ACV, ACV, ACV, ACO, ACO, ACO, # D8 - DF - ASV, ASV, ASV, ASV, ASV, ASV, ASO, ASO, # E0 - E7 - ASV, ASV, ASV, ASV, ASV, ASV, ASV, ASV, # E8 - EF - ASO, ASO, ASV, ASV, ASV, ASV, ASV, OTH, # F0 - F7 - ASV, ASV, ASV, ASV, ASV, ASO, ASO, ASO, # F8 - FF -) - -# 0 : illegal -# 1 : very unlikely -# 2 : normal -# 3 : very likely -Latin1ClassModel = ( - # UDF OTH ASC ASS ACV ACO ASV ASO - 0, 0, 0, 0, 0, 0, 0, 0, # UDF - 0, 3, 3, 3, 3, 3, 3, 3, # OTH - 0, 3, 3, 3, 3, 3, 3, 3, # ASC - 0, 3, 3, 3, 1, 1, 3, 3, # ASS - 0, 3, 3, 3, 1, 2, 1, 2, # ACV - 0, 3, 3, 3, 3, 3, 3, 3, # ACO - 0, 3, 1, 3, 1, 1, 1, 3, # ASV - 0, 3, 1, 3, 1, 1, 3, 3, # ASO -) - - -class Latin1Prober(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self.reset() - - def reset(self): - self._mLastCharClass = OTH - self._mFreqCounter = [0] * FREQ_CAT_NUM - CharSetProber.reset(self) - - def get_charset_name(self): - return "windows-1252" - - def feed(self, aBuf): - aBuf = self.filter_with_english_letters(aBuf) - for c in aBuf: - charClass = Latin1_CharToClass[wrap_ord(c)] - freq = Latin1ClassModel[(self._mLastCharClass * CLASS_NUM) - + charClass] - if freq == 0: - self._mState = eNotMe - break - self._mFreqCounter[freq] += 1 - self._mLastCharClass = charClass - - return self.get_state() - - def get_confidence(self): - if self.get_state() == eNotMe: - return 0.01 - - total = sum(self._mFreqCounter) - if total < 0.01: - confidence = 0.0 - else: - confidence = ((self._mFreqCounter[3] - self._mFreqCounter[1] * 20.0) - / total) - if confidence < 0.0: - confidence = 0.0 - # lower the confidence of latin1 so that other more accurate - # detector can take priority. - confidence = confidence * 0.73 - return confidence diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcharsetprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcharsetprober.py deleted file mode 100644 index bb42f2fb..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcharsetprober.py +++ /dev/null @@ -1,86 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# Proofpoint, Inc. -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -import sys -from . import constants -from .charsetprober import CharSetProber - - -class MultiByteCharSetProber(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self._mDistributionAnalyzer = None - self._mCodingSM = None - self._mLastChar = [0, 0] - - def reset(self): - CharSetProber.reset(self) - if self._mCodingSM: - self._mCodingSM.reset() - if self._mDistributionAnalyzer: - self._mDistributionAnalyzer.reset() - self._mLastChar = [0, 0] - - def get_charset_name(self): - pass - - def feed(self, aBuf): - aLen = len(aBuf) - for i in range(0, aLen): - codingState = self._mCodingSM.next_state(aBuf[i]) - if codingState == constants.eError: - if constants._debug: - sys.stderr.write(self.get_charset_name() - + ' prober hit error at byte ' + str(i) - + '\n') - self._mState = constants.eNotMe - break - elif codingState == constants.eItsMe: - self._mState = constants.eFoundIt - break - elif codingState == constants.eStart: - charLen = self._mCodingSM.get_current_charlen() - if i == 0: - self._mLastChar[1] = aBuf[0] - self._mDistributionAnalyzer.feed(self._mLastChar, charLen) - else: - self._mDistributionAnalyzer.feed(aBuf[i - 1:i + 1], - charLen) - - self._mLastChar[0] = aBuf[aLen - 1] - - if self.get_state() == constants.eDetecting: - if (self._mDistributionAnalyzer.got_enough_data() and - (self.get_confidence() > constants.SHORTCUT_THRESHOLD)): - self._mState = constants.eFoundIt - - return self.get_state() - - def get_confidence(self): - return self._mDistributionAnalyzer.get_confidence() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcsgroupprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcsgroupprober.py deleted file mode 100644 index 03c9dcf3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcsgroupprober.py +++ /dev/null @@ -1,54 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# Proofpoint, Inc. -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .charsetgroupprober import CharSetGroupProber -from .utf8prober import UTF8Prober -from .sjisprober import SJISProber -from .eucjpprober import EUCJPProber -from .gb2312prober import GB2312Prober -from .euckrprober import EUCKRProber -from .cp949prober import CP949Prober -from .big5prober import Big5Prober -from .euctwprober import EUCTWProber - - -class MBCSGroupProber(CharSetGroupProber): - def __init__(self): - CharSetGroupProber.__init__(self) - self._mProbers = [ - UTF8Prober(), - SJISProber(), - EUCJPProber(), - GB2312Prober(), - EUCKRProber(), - CP949Prober(), - Big5Prober(), - EUCTWProber() - ] - self.reset() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcssm.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcssm.py deleted file mode 100644 index efe678ca..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/mbcssm.py +++ /dev/null @@ -1,572 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .constants import eStart, eError, eItsMe - -# BIG5 - -BIG5_cls = ( - 1,1,1,1,1,1,1,1, # 00 - 07 #allow 0x00 as legal value - 1,1,1,1,1,1,0,0, # 08 - 0f - 1,1,1,1,1,1,1,1, # 10 - 17 - 1,1,1,0,1,1,1,1, # 18 - 1f - 1,1,1,1,1,1,1,1, # 20 - 27 - 1,1,1,1,1,1,1,1, # 28 - 2f - 1,1,1,1,1,1,1,1, # 30 - 37 - 1,1,1,1,1,1,1,1, # 38 - 3f - 2,2,2,2,2,2,2,2, # 40 - 47 - 2,2,2,2,2,2,2,2, # 48 - 4f - 2,2,2,2,2,2,2,2, # 50 - 57 - 2,2,2,2,2,2,2,2, # 58 - 5f - 2,2,2,2,2,2,2,2, # 60 - 67 - 2,2,2,2,2,2,2,2, # 68 - 6f - 2,2,2,2,2,2,2,2, # 70 - 77 - 2,2,2,2,2,2,2,1, # 78 - 7f - 4,4,4,4,4,4,4,4, # 80 - 87 - 4,4,4,4,4,4,4,4, # 88 - 8f - 4,4,4,4,4,4,4,4, # 90 - 97 - 4,4,4,4,4,4,4,4, # 98 - 9f - 4,3,3,3,3,3,3,3, # a0 - a7 - 3,3,3,3,3,3,3,3, # a8 - af - 3,3,3,3,3,3,3,3, # b0 - b7 - 3,3,3,3,3,3,3,3, # b8 - bf - 3,3,3,3,3,3,3,3, # c0 - c7 - 3,3,3,3,3,3,3,3, # c8 - cf - 3,3,3,3,3,3,3,3, # d0 - d7 - 3,3,3,3,3,3,3,3, # d8 - df - 3,3,3,3,3,3,3,3, # e0 - e7 - 3,3,3,3,3,3,3,3, # e8 - ef - 3,3,3,3,3,3,3,3, # f0 - f7 - 3,3,3,3,3,3,3,0 # f8 - ff -) - -BIG5_st = ( - eError,eStart,eStart, 3,eError,eError,eError,eError,#00-07 - eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eError,#08-0f - eError,eStart,eStart,eStart,eStart,eStart,eStart,eStart#10-17 -) - -Big5CharLenTable = (0, 1, 1, 2, 0) - -Big5SMModel = {'classTable': BIG5_cls, - 'classFactor': 5, - 'stateTable': BIG5_st, - 'charLenTable': Big5CharLenTable, - 'name': 'Big5'} - -# CP949 - -CP949_cls = ( - 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,0,0, # 00 - 0f - 1,1,1,1,1,1,1,1, 1,1,1,0,1,1,1,1, # 10 - 1f - 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, # 20 - 2f - 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, # 30 - 3f - 1,4,4,4,4,4,4,4, 4,4,4,4,4,4,4,4, # 40 - 4f - 4,4,5,5,5,5,5,5, 5,5,5,1,1,1,1,1, # 50 - 5f - 1,5,5,5,5,5,5,5, 5,5,5,5,5,5,5,5, # 60 - 6f - 5,5,5,5,5,5,5,5, 5,5,5,1,1,1,1,1, # 70 - 7f - 0,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6, # 80 - 8f - 6,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6, # 90 - 9f - 6,7,7,7,7,7,7,7, 7,7,7,7,7,8,8,8, # a0 - af - 7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7, # b0 - bf - 7,7,7,7,7,7,9,2, 2,3,2,2,2,2,2,2, # c0 - cf - 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2, # d0 - df - 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2, # e0 - ef - 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,0, # f0 - ff -) - -CP949_st = ( -#cls= 0 1 2 3 4 5 6 7 8 9 # previous state = - eError,eStart, 3,eError,eStart,eStart, 4, 5,eError, 6, # eStart - eError,eError,eError,eError,eError,eError,eError,eError,eError,eError, # eError - eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe, # eItsMe - eError,eError,eStart,eStart,eError,eError,eError,eStart,eStart,eStart, # 3 - eError,eError,eStart,eStart,eStart,eStart,eStart,eStart,eStart,eStart, # 4 - eError,eStart,eStart,eStart,eStart,eStart,eStart,eStart,eStart,eStart, # 5 - eError,eStart,eStart,eStart,eStart,eError,eError,eStart,eStart,eStart, # 6 -) - -CP949CharLenTable = (0, 1, 2, 0, 1, 1, 2, 2, 0, 2) - -CP949SMModel = {'classTable': CP949_cls, - 'classFactor': 10, - 'stateTable': CP949_st, - 'charLenTable': CP949CharLenTable, - 'name': 'CP949'} - -# EUC-JP - -EUCJP_cls = ( - 4,4,4,4,4,4,4,4, # 00 - 07 - 4,4,4,4,4,4,5,5, # 08 - 0f - 4,4,4,4,4,4,4,4, # 10 - 17 - 4,4,4,5,4,4,4,4, # 18 - 1f - 4,4,4,4,4,4,4,4, # 20 - 27 - 4,4,4,4,4,4,4,4, # 28 - 2f - 4,4,4,4,4,4,4,4, # 30 - 37 - 4,4,4,4,4,4,4,4, # 38 - 3f - 4,4,4,4,4,4,4,4, # 40 - 47 - 4,4,4,4,4,4,4,4, # 48 - 4f - 4,4,4,4,4,4,4,4, # 50 - 57 - 4,4,4,4,4,4,4,4, # 58 - 5f - 4,4,4,4,4,4,4,4, # 60 - 67 - 4,4,4,4,4,4,4,4, # 68 - 6f - 4,4,4,4,4,4,4,4, # 70 - 77 - 4,4,4,4,4,4,4,4, # 78 - 7f - 5,5,5,5,5,5,5,5, # 80 - 87 - 5,5,5,5,5,5,1,3, # 88 - 8f - 5,5,5,5,5,5,5,5, # 90 - 97 - 5,5,5,5,5,5,5,5, # 98 - 9f - 5,2,2,2,2,2,2,2, # a0 - a7 - 2,2,2,2,2,2,2,2, # a8 - af - 2,2,2,2,2,2,2,2, # b0 - b7 - 2,2,2,2,2,2,2,2, # b8 - bf - 2,2,2,2,2,2,2,2, # c0 - c7 - 2,2,2,2,2,2,2,2, # c8 - cf - 2,2,2,2,2,2,2,2, # d0 - d7 - 2,2,2,2,2,2,2,2, # d8 - df - 0,0,0,0,0,0,0,0, # e0 - e7 - 0,0,0,0,0,0,0,0, # e8 - ef - 0,0,0,0,0,0,0,0, # f0 - f7 - 0,0,0,0,0,0,0,5 # f8 - ff -) - -EUCJP_st = ( - 3, 4, 3, 5,eStart,eError,eError,eError,#00-07 - eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe,eStart,eError,eStart,eError,eError,eError,#10-17 - eError,eError,eStart,eError,eError,eError, 3,eError,#18-1f - 3,eError,eError,eError,eStart,eStart,eStart,eStart#20-27 -) - -EUCJPCharLenTable = (2, 2, 2, 3, 1, 0) - -EUCJPSMModel = {'classTable': EUCJP_cls, - 'classFactor': 6, - 'stateTable': EUCJP_st, - 'charLenTable': EUCJPCharLenTable, - 'name': 'EUC-JP'} - -# EUC-KR - -EUCKR_cls = ( - 1,1,1,1,1,1,1,1, # 00 - 07 - 1,1,1,1,1,1,0,0, # 08 - 0f - 1,1,1,1,1,1,1,1, # 10 - 17 - 1,1,1,0,1,1,1,1, # 18 - 1f - 1,1,1,1,1,1,1,1, # 20 - 27 - 1,1,1,1,1,1,1,1, # 28 - 2f - 1,1,1,1,1,1,1,1, # 30 - 37 - 1,1,1,1,1,1,1,1, # 38 - 3f - 1,1,1,1,1,1,1,1, # 40 - 47 - 1,1,1,1,1,1,1,1, # 48 - 4f - 1,1,1,1,1,1,1,1, # 50 - 57 - 1,1,1,1,1,1,1,1, # 58 - 5f - 1,1,1,1,1,1,1,1, # 60 - 67 - 1,1,1,1,1,1,1,1, # 68 - 6f - 1,1,1,1,1,1,1,1, # 70 - 77 - 1,1,1,1,1,1,1,1, # 78 - 7f - 0,0,0,0,0,0,0,0, # 80 - 87 - 0,0,0,0,0,0,0,0, # 88 - 8f - 0,0,0,0,0,0,0,0, # 90 - 97 - 0,0,0,0,0,0,0,0, # 98 - 9f - 0,2,2,2,2,2,2,2, # a0 - a7 - 2,2,2,2,2,3,3,3, # a8 - af - 2,2,2,2,2,2,2,2, # b0 - b7 - 2,2,2,2,2,2,2,2, # b8 - bf - 2,2,2,2,2,2,2,2, # c0 - c7 - 2,3,2,2,2,2,2,2, # c8 - cf - 2,2,2,2,2,2,2,2, # d0 - d7 - 2,2,2,2,2,2,2,2, # d8 - df - 2,2,2,2,2,2,2,2, # e0 - e7 - 2,2,2,2,2,2,2,2, # e8 - ef - 2,2,2,2,2,2,2,2, # f0 - f7 - 2,2,2,2,2,2,2,0 # f8 - ff -) - -EUCKR_st = ( - eError,eStart, 3,eError,eError,eError,eError,eError,#00-07 - eItsMe,eItsMe,eItsMe,eItsMe,eError,eError,eStart,eStart #08-0f -) - -EUCKRCharLenTable = (0, 1, 2, 0) - -EUCKRSMModel = {'classTable': EUCKR_cls, - 'classFactor': 4, - 'stateTable': EUCKR_st, - 'charLenTable': EUCKRCharLenTable, - 'name': 'EUC-KR'} - -# EUC-TW - -EUCTW_cls = ( - 2,2,2,2,2,2,2,2, # 00 - 07 - 2,2,2,2,2,2,0,0, # 08 - 0f - 2,2,2,2,2,2,2,2, # 10 - 17 - 2,2,2,0,2,2,2,2, # 18 - 1f - 2,2,2,2,2,2,2,2, # 20 - 27 - 2,2,2,2,2,2,2,2, # 28 - 2f - 2,2,2,2,2,2,2,2, # 30 - 37 - 2,2,2,2,2,2,2,2, # 38 - 3f - 2,2,2,2,2,2,2,2, # 40 - 47 - 2,2,2,2,2,2,2,2, # 48 - 4f - 2,2,2,2,2,2,2,2, # 50 - 57 - 2,2,2,2,2,2,2,2, # 58 - 5f - 2,2,2,2,2,2,2,2, # 60 - 67 - 2,2,2,2,2,2,2,2, # 68 - 6f - 2,2,2,2,2,2,2,2, # 70 - 77 - 2,2,2,2,2,2,2,2, # 78 - 7f - 0,0,0,0,0,0,0,0, # 80 - 87 - 0,0,0,0,0,0,6,0, # 88 - 8f - 0,0,0,0,0,0,0,0, # 90 - 97 - 0,0,0,0,0,0,0,0, # 98 - 9f - 0,3,4,4,4,4,4,4, # a0 - a7 - 5,5,1,1,1,1,1,1, # a8 - af - 1,1,1,1,1,1,1,1, # b0 - b7 - 1,1,1,1,1,1,1,1, # b8 - bf - 1,1,3,1,3,3,3,3, # c0 - c7 - 3,3,3,3,3,3,3,3, # c8 - cf - 3,3,3,3,3,3,3,3, # d0 - d7 - 3,3,3,3,3,3,3,3, # d8 - df - 3,3,3,3,3,3,3,3, # e0 - e7 - 3,3,3,3,3,3,3,3, # e8 - ef - 3,3,3,3,3,3,3,3, # f0 - f7 - 3,3,3,3,3,3,3,0 # f8 - ff -) - -EUCTW_st = ( - eError,eError,eStart, 3, 3, 3, 4,eError,#00-07 - eError,eError,eError,eError,eError,eError,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eError,eStart,eError,#10-17 - eStart,eStart,eStart,eError,eError,eError,eError,eError,#18-1f - 5,eError,eError,eError,eStart,eError,eStart,eStart,#20-27 - eStart,eError,eStart,eStart,eStart,eStart,eStart,eStart #28-2f -) - -EUCTWCharLenTable = (0, 0, 1, 2, 2, 2, 3) - -EUCTWSMModel = {'classTable': EUCTW_cls, - 'classFactor': 7, - 'stateTable': EUCTW_st, - 'charLenTable': EUCTWCharLenTable, - 'name': 'x-euc-tw'} - -# GB2312 - -GB2312_cls = ( - 1,1,1,1,1,1,1,1, # 00 - 07 - 1,1,1,1,1,1,0,0, # 08 - 0f - 1,1,1,1,1,1,1,1, # 10 - 17 - 1,1,1,0,1,1,1,1, # 18 - 1f - 1,1,1,1,1,1,1,1, # 20 - 27 - 1,1,1,1,1,1,1,1, # 28 - 2f - 3,3,3,3,3,3,3,3, # 30 - 37 - 3,3,1,1,1,1,1,1, # 38 - 3f - 2,2,2,2,2,2,2,2, # 40 - 47 - 2,2,2,2,2,2,2,2, # 48 - 4f - 2,2,2,2,2,2,2,2, # 50 - 57 - 2,2,2,2,2,2,2,2, # 58 - 5f - 2,2,2,2,2,2,2,2, # 60 - 67 - 2,2,2,2,2,2,2,2, # 68 - 6f - 2,2,2,2,2,2,2,2, # 70 - 77 - 2,2,2,2,2,2,2,4, # 78 - 7f - 5,6,6,6,6,6,6,6, # 80 - 87 - 6,6,6,6,6,6,6,6, # 88 - 8f - 6,6,6,6,6,6,6,6, # 90 - 97 - 6,6,6,6,6,6,6,6, # 98 - 9f - 6,6,6,6,6,6,6,6, # a0 - a7 - 6,6,6,6,6,6,6,6, # a8 - af - 6,6,6,6,6,6,6,6, # b0 - b7 - 6,6,6,6,6,6,6,6, # b8 - bf - 6,6,6,6,6,6,6,6, # c0 - c7 - 6,6,6,6,6,6,6,6, # c8 - cf - 6,6,6,6,6,6,6,6, # d0 - d7 - 6,6,6,6,6,6,6,6, # d8 - df - 6,6,6,6,6,6,6,6, # e0 - e7 - 6,6,6,6,6,6,6,6, # e8 - ef - 6,6,6,6,6,6,6,6, # f0 - f7 - 6,6,6,6,6,6,6,0 # f8 - ff -) - -GB2312_st = ( - eError,eStart,eStart,eStart,eStart,eStart, 3,eError,#00-07 - eError,eError,eError,eError,eError,eError,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eError,eError,eStart,#10-17 - 4,eError,eStart,eStart,eError,eError,eError,eError,#18-1f - eError,eError, 5,eError,eError,eError,eItsMe,eError,#20-27 - eError,eError,eStart,eStart,eStart,eStart,eStart,eStart #28-2f -) - -# To be accurate, the length of class 6 can be either 2 or 4. -# But it is not necessary to discriminate between the two since -# it is used for frequency analysis only, and we are validing -# each code range there as well. So it is safe to set it to be -# 2 here. -GB2312CharLenTable = (0, 1, 1, 1, 1, 1, 2) - -GB2312SMModel = {'classTable': GB2312_cls, - 'classFactor': 7, - 'stateTable': GB2312_st, - 'charLenTable': GB2312CharLenTable, - 'name': 'GB2312'} - -# Shift_JIS - -SJIS_cls = ( - 1,1,1,1,1,1,1,1, # 00 - 07 - 1,1,1,1,1,1,0,0, # 08 - 0f - 1,1,1,1,1,1,1,1, # 10 - 17 - 1,1,1,0,1,1,1,1, # 18 - 1f - 1,1,1,1,1,1,1,1, # 20 - 27 - 1,1,1,1,1,1,1,1, # 28 - 2f - 1,1,1,1,1,1,1,1, # 30 - 37 - 1,1,1,1,1,1,1,1, # 38 - 3f - 2,2,2,2,2,2,2,2, # 40 - 47 - 2,2,2,2,2,2,2,2, # 48 - 4f - 2,2,2,2,2,2,2,2, # 50 - 57 - 2,2,2,2,2,2,2,2, # 58 - 5f - 2,2,2,2,2,2,2,2, # 60 - 67 - 2,2,2,2,2,2,2,2, # 68 - 6f - 2,2,2,2,2,2,2,2, # 70 - 77 - 2,2,2,2,2,2,2,1, # 78 - 7f - 3,3,3,3,3,2,2,3, # 80 - 87 - 3,3,3,3,3,3,3,3, # 88 - 8f - 3,3,3,3,3,3,3,3, # 90 - 97 - 3,3,3,3,3,3,3,3, # 98 - 9f - #0xa0 is illegal in sjis encoding, but some pages does - #contain such byte. We need to be more error forgiven. - 2,2,2,2,2,2,2,2, # a0 - a7 - 2,2,2,2,2,2,2,2, # a8 - af - 2,2,2,2,2,2,2,2, # b0 - b7 - 2,2,2,2,2,2,2,2, # b8 - bf - 2,2,2,2,2,2,2,2, # c0 - c7 - 2,2,2,2,2,2,2,2, # c8 - cf - 2,2,2,2,2,2,2,2, # d0 - d7 - 2,2,2,2,2,2,2,2, # d8 - df - 3,3,3,3,3,3,3,3, # e0 - e7 - 3,3,3,3,3,4,4,4, # e8 - ef - 3,3,3,3,3,3,3,3, # f0 - f7 - 3,3,3,3,3,0,0,0) # f8 - ff - - -SJIS_st = ( - eError,eStart,eStart, 3,eError,eError,eError,eError,#00-07 - eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe,eError,eError,eStart,eStart,eStart,eStart #10-17 -) - -SJISCharLenTable = (0, 1, 1, 2, 0, 0) - -SJISSMModel = {'classTable': SJIS_cls, - 'classFactor': 6, - 'stateTable': SJIS_st, - 'charLenTable': SJISCharLenTable, - 'name': 'Shift_JIS'} - -# UCS2-BE - -UCS2BE_cls = ( - 0,0,0,0,0,0,0,0, # 00 - 07 - 0,0,1,0,0,2,0,0, # 08 - 0f - 0,0,0,0,0,0,0,0, # 10 - 17 - 0,0,0,3,0,0,0,0, # 18 - 1f - 0,0,0,0,0,0,0,0, # 20 - 27 - 0,3,3,3,3,3,0,0, # 28 - 2f - 0,0,0,0,0,0,0,0, # 30 - 37 - 0,0,0,0,0,0,0,0, # 38 - 3f - 0,0,0,0,0,0,0,0, # 40 - 47 - 0,0,0,0,0,0,0,0, # 48 - 4f - 0,0,0,0,0,0,0,0, # 50 - 57 - 0,0,0,0,0,0,0,0, # 58 - 5f - 0,0,0,0,0,0,0,0, # 60 - 67 - 0,0,0,0,0,0,0,0, # 68 - 6f - 0,0,0,0,0,0,0,0, # 70 - 77 - 0,0,0,0,0,0,0,0, # 78 - 7f - 0,0,0,0,0,0,0,0, # 80 - 87 - 0,0,0,0,0,0,0,0, # 88 - 8f - 0,0,0,0,0,0,0,0, # 90 - 97 - 0,0,0,0,0,0,0,0, # 98 - 9f - 0,0,0,0,0,0,0,0, # a0 - a7 - 0,0,0,0,0,0,0,0, # a8 - af - 0,0,0,0,0,0,0,0, # b0 - b7 - 0,0,0,0,0,0,0,0, # b8 - bf - 0,0,0,0,0,0,0,0, # c0 - c7 - 0,0,0,0,0,0,0,0, # c8 - cf - 0,0,0,0,0,0,0,0, # d0 - d7 - 0,0,0,0,0,0,0,0, # d8 - df - 0,0,0,0,0,0,0,0, # e0 - e7 - 0,0,0,0,0,0,0,0, # e8 - ef - 0,0,0,0,0,0,0,0, # f0 - f7 - 0,0,0,0,0,0,4,5 # f8 - ff -) - -UCS2BE_st = ( - 5, 7, 7,eError, 4, 3,eError,eError,#00-07 - eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe, 6, 6, 6, 6,eError,eError,#10-17 - 6, 6, 6, 6, 6,eItsMe, 6, 6,#18-1f - 6, 6, 6, 6, 5, 7, 7,eError,#20-27 - 5, 8, 6, 6,eError, 6, 6, 6,#28-2f - 6, 6, 6, 6,eError,eError,eStart,eStart #30-37 -) - -UCS2BECharLenTable = (2, 2, 2, 0, 2, 2) - -UCS2BESMModel = {'classTable': UCS2BE_cls, - 'classFactor': 6, - 'stateTable': UCS2BE_st, - 'charLenTable': UCS2BECharLenTable, - 'name': 'UTF-16BE'} - -# UCS2-LE - -UCS2LE_cls = ( - 0,0,0,0,0,0,0,0, # 00 - 07 - 0,0,1,0,0,2,0,0, # 08 - 0f - 0,0,0,0,0,0,0,0, # 10 - 17 - 0,0,0,3,0,0,0,0, # 18 - 1f - 0,0,0,0,0,0,0,0, # 20 - 27 - 0,3,3,3,3,3,0,0, # 28 - 2f - 0,0,0,0,0,0,0,0, # 30 - 37 - 0,0,0,0,0,0,0,0, # 38 - 3f - 0,0,0,0,0,0,0,0, # 40 - 47 - 0,0,0,0,0,0,0,0, # 48 - 4f - 0,0,0,0,0,0,0,0, # 50 - 57 - 0,0,0,0,0,0,0,0, # 58 - 5f - 0,0,0,0,0,0,0,0, # 60 - 67 - 0,0,0,0,0,0,0,0, # 68 - 6f - 0,0,0,0,0,0,0,0, # 70 - 77 - 0,0,0,0,0,0,0,0, # 78 - 7f - 0,0,0,0,0,0,0,0, # 80 - 87 - 0,0,0,0,0,0,0,0, # 88 - 8f - 0,0,0,0,0,0,0,0, # 90 - 97 - 0,0,0,0,0,0,0,0, # 98 - 9f - 0,0,0,0,0,0,0,0, # a0 - a7 - 0,0,0,0,0,0,0,0, # a8 - af - 0,0,0,0,0,0,0,0, # b0 - b7 - 0,0,0,0,0,0,0,0, # b8 - bf - 0,0,0,0,0,0,0,0, # c0 - c7 - 0,0,0,0,0,0,0,0, # c8 - cf - 0,0,0,0,0,0,0,0, # d0 - d7 - 0,0,0,0,0,0,0,0, # d8 - df - 0,0,0,0,0,0,0,0, # e0 - e7 - 0,0,0,0,0,0,0,0, # e8 - ef - 0,0,0,0,0,0,0,0, # f0 - f7 - 0,0,0,0,0,0,4,5 # f8 - ff -) - -UCS2LE_st = ( - 6, 6, 7, 6, 4, 3,eError,eError,#00-07 - eError,eError,eError,eError,eItsMe,eItsMe,eItsMe,eItsMe,#08-0f - eItsMe,eItsMe, 5, 5, 5,eError,eItsMe,eError,#10-17 - 5, 5, 5,eError, 5,eError, 6, 6,#18-1f - 7, 6, 8, 8, 5, 5, 5,eError,#20-27 - 5, 5, 5,eError,eError,eError, 5, 5,#28-2f - 5, 5, 5,eError, 5,eError,eStart,eStart #30-37 -) - -UCS2LECharLenTable = (2, 2, 2, 2, 2, 2) - -UCS2LESMModel = {'classTable': UCS2LE_cls, - 'classFactor': 6, - 'stateTable': UCS2LE_st, - 'charLenTable': UCS2LECharLenTable, - 'name': 'UTF-16LE'} - -# UTF-8 - -UTF8_cls = ( - 1,1,1,1,1,1,1,1, # 00 - 07 #allow 0x00 as a legal value - 1,1,1,1,1,1,0,0, # 08 - 0f - 1,1,1,1,1,1,1,1, # 10 - 17 - 1,1,1,0,1,1,1,1, # 18 - 1f - 1,1,1,1,1,1,1,1, # 20 - 27 - 1,1,1,1,1,1,1,1, # 28 - 2f - 1,1,1,1,1,1,1,1, # 30 - 37 - 1,1,1,1,1,1,1,1, # 38 - 3f - 1,1,1,1,1,1,1,1, # 40 - 47 - 1,1,1,1,1,1,1,1, # 48 - 4f - 1,1,1,1,1,1,1,1, # 50 - 57 - 1,1,1,1,1,1,1,1, # 58 - 5f - 1,1,1,1,1,1,1,1, # 60 - 67 - 1,1,1,1,1,1,1,1, # 68 - 6f - 1,1,1,1,1,1,1,1, # 70 - 77 - 1,1,1,1,1,1,1,1, # 78 - 7f - 2,2,2,2,3,3,3,3, # 80 - 87 - 4,4,4,4,4,4,4,4, # 88 - 8f - 4,4,4,4,4,4,4,4, # 90 - 97 - 4,4,4,4,4,4,4,4, # 98 - 9f - 5,5,5,5,5,5,5,5, # a0 - a7 - 5,5,5,5,5,5,5,5, # a8 - af - 5,5,5,5,5,5,5,5, # b0 - b7 - 5,5,5,5,5,5,5,5, # b8 - bf - 0,0,6,6,6,6,6,6, # c0 - c7 - 6,6,6,6,6,6,6,6, # c8 - cf - 6,6,6,6,6,6,6,6, # d0 - d7 - 6,6,6,6,6,6,6,6, # d8 - df - 7,8,8,8,8,8,8,8, # e0 - e7 - 8,8,8,8,8,9,8,8, # e8 - ef - 10,11,11,11,11,11,11,11, # f0 - f7 - 12,13,13,13,14,15,0,0 # f8 - ff -) - -UTF8_st = ( - eError,eStart,eError,eError,eError,eError, 12, 10,#00-07 - 9, 11, 8, 7, 6, 5, 4, 3,#08-0f - eError,eError,eError,eError,eError,eError,eError,eError,#10-17 - eError,eError,eError,eError,eError,eError,eError,eError,#18-1f - eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,#20-27 - eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,eItsMe,#28-2f - eError,eError, 5, 5, 5, 5,eError,eError,#30-37 - eError,eError,eError,eError,eError,eError,eError,eError,#38-3f - eError,eError,eError, 5, 5, 5,eError,eError,#40-47 - eError,eError,eError,eError,eError,eError,eError,eError,#48-4f - eError,eError, 7, 7, 7, 7,eError,eError,#50-57 - eError,eError,eError,eError,eError,eError,eError,eError,#58-5f - eError,eError,eError,eError, 7, 7,eError,eError,#60-67 - eError,eError,eError,eError,eError,eError,eError,eError,#68-6f - eError,eError, 9, 9, 9, 9,eError,eError,#70-77 - eError,eError,eError,eError,eError,eError,eError,eError,#78-7f - eError,eError,eError,eError,eError, 9,eError,eError,#80-87 - eError,eError,eError,eError,eError,eError,eError,eError,#88-8f - eError,eError, 12, 12, 12, 12,eError,eError,#90-97 - eError,eError,eError,eError,eError,eError,eError,eError,#98-9f - eError,eError,eError,eError,eError, 12,eError,eError,#a0-a7 - eError,eError,eError,eError,eError,eError,eError,eError,#a8-af - eError,eError, 12, 12, 12,eError,eError,eError,#b0-b7 - eError,eError,eError,eError,eError,eError,eError,eError,#b8-bf - eError,eError,eStart,eStart,eStart,eStart,eError,eError,#c0-c7 - eError,eError,eError,eError,eError,eError,eError,eError #c8-cf -) - -UTF8CharLenTable = (0, 1, 0, 0, 0, 0, 2, 3, 3, 3, 4, 4, 5, 5, 6, 6) - -UTF8SMModel = {'classTable': UTF8_cls, - 'classFactor': 16, - 'stateTable': UTF8_st, - 'charLenTable': UTF8CharLenTable, - 'name': 'UTF-8'} diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcharsetprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcharsetprober.py deleted file mode 100644 index 37291bd2..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcharsetprober.py +++ /dev/null @@ -1,120 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -import sys -from . import constants -from .charsetprober import CharSetProber -from .compat import wrap_ord - -SAMPLE_SIZE = 64 -SB_ENOUGH_REL_THRESHOLD = 1024 -POSITIVE_SHORTCUT_THRESHOLD = 0.95 -NEGATIVE_SHORTCUT_THRESHOLD = 0.05 -SYMBOL_CAT_ORDER = 250 -NUMBER_OF_SEQ_CAT = 4 -POSITIVE_CAT = NUMBER_OF_SEQ_CAT - 1 -#NEGATIVE_CAT = 0 - - -class SingleByteCharSetProber(CharSetProber): - def __init__(self, model, reversed=False, nameProber=None): - CharSetProber.__init__(self) - self._mModel = model - # TRUE if we need to reverse every pair in the model lookup - self._mReversed = reversed - # Optional auxiliary prober for name decision - self._mNameProber = nameProber - self.reset() - - def reset(self): - CharSetProber.reset(self) - # char order of last character - self._mLastOrder = 255 - self._mSeqCounters = [0] * NUMBER_OF_SEQ_CAT - self._mTotalSeqs = 0 - self._mTotalChar = 0 - # characters that fall in our sampling range - self._mFreqChar = 0 - - def get_charset_name(self): - if self._mNameProber: - return self._mNameProber.get_charset_name() - else: - return self._mModel['charsetName'] - - def feed(self, aBuf): - if not self._mModel['keepEnglishLetter']: - aBuf = self.filter_without_english_letters(aBuf) - aLen = len(aBuf) - if not aLen: - return self.get_state() - for c in aBuf: - order = self._mModel['charToOrderMap'][wrap_ord(c)] - if order < SYMBOL_CAT_ORDER: - self._mTotalChar += 1 - if order < SAMPLE_SIZE: - self._mFreqChar += 1 - if self._mLastOrder < SAMPLE_SIZE: - self._mTotalSeqs += 1 - if not self._mReversed: - i = (self._mLastOrder * SAMPLE_SIZE) + order - model = self._mModel['precedenceMatrix'][i] - else: # reverse the order of the letters in the lookup - i = (order * SAMPLE_SIZE) + self._mLastOrder - model = self._mModel['precedenceMatrix'][i] - self._mSeqCounters[model] += 1 - self._mLastOrder = order - - if self.get_state() == constants.eDetecting: - if self._mTotalSeqs > SB_ENOUGH_REL_THRESHOLD: - cf = self.get_confidence() - if cf > POSITIVE_SHORTCUT_THRESHOLD: - if constants._debug: - sys.stderr.write('%s confidence = %s, we have a' - 'winner\n' % - (self._mModel['charsetName'], cf)) - self._mState = constants.eFoundIt - elif cf < NEGATIVE_SHORTCUT_THRESHOLD: - if constants._debug: - sys.stderr.write('%s confidence = %s, below negative' - 'shortcut threshhold %s\n' % - (self._mModel['charsetName'], cf, - NEGATIVE_SHORTCUT_THRESHOLD)) - self._mState = constants.eNotMe - - return self.get_state() - - def get_confidence(self): - r = 0.01 - if self._mTotalSeqs > 0: - r = ((1.0 * self._mSeqCounters[POSITIVE_CAT]) / self._mTotalSeqs - / self._mModel['mTypicalPositiveRatio']) - r = r * self._mFreqChar / self._mTotalChar - if r >= 1.0: - r = 0.99 - return r diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcsgroupprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcsgroupprober.py deleted file mode 100644 index 1b6196cd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sbcsgroupprober.py +++ /dev/null @@ -1,69 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from .charsetgroupprober import CharSetGroupProber -from .sbcharsetprober import SingleByteCharSetProber -from .langcyrillicmodel import (Win1251CyrillicModel, Koi8rModel, - Latin5CyrillicModel, MacCyrillicModel, - Ibm866Model, Ibm855Model) -from .langgreekmodel import Latin7GreekModel, Win1253GreekModel -from .langbulgarianmodel import Latin5BulgarianModel, Win1251BulgarianModel -from .langhungarianmodel import Latin2HungarianModel, Win1250HungarianModel -from .langthaimodel import TIS620ThaiModel -from .langhebrewmodel import Win1255HebrewModel -from .hebrewprober import HebrewProber - - -class SBCSGroupProber(CharSetGroupProber): - def __init__(self): - CharSetGroupProber.__init__(self) - self._mProbers = [ - SingleByteCharSetProber(Win1251CyrillicModel), - SingleByteCharSetProber(Koi8rModel), - SingleByteCharSetProber(Latin5CyrillicModel), - SingleByteCharSetProber(MacCyrillicModel), - SingleByteCharSetProber(Ibm866Model), - SingleByteCharSetProber(Ibm855Model), - SingleByteCharSetProber(Latin7GreekModel), - SingleByteCharSetProber(Win1253GreekModel), - SingleByteCharSetProber(Latin5BulgarianModel), - SingleByteCharSetProber(Win1251BulgarianModel), - SingleByteCharSetProber(Latin2HungarianModel), - SingleByteCharSetProber(Win1250HungarianModel), - SingleByteCharSetProber(TIS620ThaiModel), - ] - hebrewProber = HebrewProber() - logicalHebrewProber = SingleByteCharSetProber(Win1255HebrewModel, - False, hebrewProber) - visualHebrewProber = SingleByteCharSetProber(Win1255HebrewModel, True, - hebrewProber) - hebrewProber.set_model_probers(logicalHebrewProber, visualHebrewProber) - self._mProbers.extend([hebrewProber, logicalHebrewProber, - visualHebrewProber]) - - self.reset() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sjisprober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sjisprober.py deleted file mode 100644 index cd0e9e70..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/sjisprober.py +++ /dev/null @@ -1,91 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -import sys -from .mbcharsetprober import MultiByteCharSetProber -from .codingstatemachine import CodingStateMachine -from .chardistribution import SJISDistributionAnalysis -from .jpcntx import SJISContextAnalysis -from .mbcssm import SJISSMModel -from . import constants - - -class SJISProber(MultiByteCharSetProber): - def __init__(self): - MultiByteCharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(SJISSMModel) - self._mDistributionAnalyzer = SJISDistributionAnalysis() - self._mContextAnalyzer = SJISContextAnalysis() - self.reset() - - def reset(self): - MultiByteCharSetProber.reset(self) - self._mContextAnalyzer.reset() - - def get_charset_name(self): - return self._mContextAnalyzer.get_charset_name() - - def feed(self, aBuf): - aLen = len(aBuf) - for i in range(0, aLen): - codingState = self._mCodingSM.next_state(aBuf[i]) - if codingState == constants.eError: - if constants._debug: - sys.stderr.write(self.get_charset_name() - + ' prober hit error at byte ' + str(i) - + '\n') - self._mState = constants.eNotMe - break - elif codingState == constants.eItsMe: - self._mState = constants.eFoundIt - break - elif codingState == constants.eStart: - charLen = self._mCodingSM.get_current_charlen() - if i == 0: - self._mLastChar[1] = aBuf[0] - self._mContextAnalyzer.feed(self._mLastChar[2 - charLen:], - charLen) - self._mDistributionAnalyzer.feed(self._mLastChar, charLen) - else: - self._mContextAnalyzer.feed(aBuf[i + 1 - charLen:i + 3 - - charLen], charLen) - self._mDistributionAnalyzer.feed(aBuf[i - 1:i + 1], - charLen) - - self._mLastChar[0] = aBuf[aLen - 1] - - if self.get_state() == constants.eDetecting: - if (self._mContextAnalyzer.got_enough_data() and - (self.get_confidence() > constants.SHORTCUT_THRESHOLD)): - self._mState = constants.eFoundIt - - return self.get_state() - - def get_confidence(self): - contxtCf = self._mContextAnalyzer.get_confidence() - distribCf = self._mDistributionAnalyzer.get_confidence() - return max(contxtCf, distribCf) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/universaldetector.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/universaldetector.py deleted file mode 100644 index 476522b9..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/universaldetector.py +++ /dev/null @@ -1,170 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is Mozilla Universal charset detector code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 2001 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# Shy Shalom - original C code -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from . import constants -import sys -import codecs -from .latin1prober import Latin1Prober # windows-1252 -from .mbcsgroupprober import MBCSGroupProber # multi-byte character sets -from .sbcsgroupprober import SBCSGroupProber # single-byte character sets -from .escprober import EscCharSetProber # ISO-2122, etc. -import re - -MINIMUM_THRESHOLD = 0.20 -ePureAscii = 0 -eEscAscii = 1 -eHighbyte = 2 - - -class UniversalDetector: - def __init__(self): - self._highBitDetector = re.compile(b'[\x80-\xFF]') - self._escDetector = re.compile(b'(\033|~{)') - self._mEscCharSetProber = None - self._mCharSetProbers = [] - self.reset() - - def reset(self): - self.result = {'encoding': None, 'confidence': 0.0} - self.done = False - self._mStart = True - self._mGotData = False - self._mInputState = ePureAscii - self._mLastChar = b'' - if self._mEscCharSetProber: - self._mEscCharSetProber.reset() - for prober in self._mCharSetProbers: - prober.reset() - - def feed(self, aBuf): - if self.done: - return - - aLen = len(aBuf) - if not aLen: - return - - if not self._mGotData: - # If the data starts with BOM, we know it is UTF - if aBuf[:3] == codecs.BOM_UTF8: - # EF BB BF UTF-8 with BOM - self.result = {'encoding': "UTF-8-SIG", 'confidence': 1.0} - elif aBuf[:4] == codecs.BOM_UTF32_LE: - # FF FE 00 00 UTF-32, little-endian BOM - self.result = {'encoding': "UTF-32LE", 'confidence': 1.0} - elif aBuf[:4] == codecs.BOM_UTF32_BE: - # 00 00 FE FF UTF-32, big-endian BOM - self.result = {'encoding': "UTF-32BE", 'confidence': 1.0} - elif aBuf[:4] == b'\xFE\xFF\x00\x00': - # FE FF 00 00 UCS-4, unusual octet order BOM (3412) - self.result = { - 'encoding': "X-ISO-10646-UCS-4-3412", - 'confidence': 1.0 - } - elif aBuf[:4] == b'\x00\x00\xFF\xFE': - # 00 00 FF FE UCS-4, unusual octet order BOM (2143) - self.result = { - 'encoding': "X-ISO-10646-UCS-4-2143", - 'confidence': 1.0 - } - elif aBuf[:2] == codecs.BOM_LE: - # FF FE UTF-16, little endian BOM - self.result = {'encoding': "UTF-16LE", 'confidence': 1.0} - elif aBuf[:2] == codecs.BOM_BE: - # FE FF UTF-16, big endian BOM - self.result = {'encoding': "UTF-16BE", 'confidence': 1.0} - - self._mGotData = True - if self.result['encoding'] and (self.result['confidence'] > 0.0): - self.done = True - return - - if self._mInputState == ePureAscii: - if self._highBitDetector.search(aBuf): - self._mInputState = eHighbyte - elif ((self._mInputState == ePureAscii) and - self._escDetector.search(self._mLastChar + aBuf)): - self._mInputState = eEscAscii - - self._mLastChar = aBuf[-1:] - - if self._mInputState == eEscAscii: - if not self._mEscCharSetProber: - self._mEscCharSetProber = EscCharSetProber() - if self._mEscCharSetProber.feed(aBuf) == constants.eFoundIt: - self.result = {'encoding': self._mEscCharSetProber.get_charset_name(), - 'confidence': self._mEscCharSetProber.get_confidence()} - self.done = True - elif self._mInputState == eHighbyte: - if not self._mCharSetProbers: - self._mCharSetProbers = [MBCSGroupProber(), SBCSGroupProber(), - Latin1Prober()] - for prober in self._mCharSetProbers: - if prober.feed(aBuf) == constants.eFoundIt: - self.result = {'encoding': prober.get_charset_name(), - 'confidence': prober.get_confidence()} - self.done = True - break - - def close(self): - if self.done: - return - if not self._mGotData: - if constants._debug: - sys.stderr.write('no data received!\n') - return - self.done = True - - if self._mInputState == ePureAscii: - self.result = {'encoding': 'ascii', 'confidence': 1.0} - return self.result - - if self._mInputState == eHighbyte: - proberConfidence = None - maxProberConfidence = 0.0 - maxProber = None - for prober in self._mCharSetProbers: - if not prober: - continue - proberConfidence = prober.get_confidence() - if proberConfidence > maxProberConfidence: - maxProberConfidence = proberConfidence - maxProber = prober - if maxProber and (maxProberConfidence > MINIMUM_THRESHOLD): - self.result = {'encoding': maxProber.get_charset_name(), - 'confidence': maxProber.get_confidence()} - return self.result - - if constants._debug: - sys.stderr.write('no probers hit minimum threshhold\n') - for prober in self._mCharSetProbers[0].mProbers: - if not prober: - continue - sys.stderr.write('%s confidence = %s\n' % - (prober.get_charset_name(), - prober.get_confidence())) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/utf8prober.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/utf8prober.py deleted file mode 100644 index 1c0bb5d8..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/chardet/utf8prober.py +++ /dev/null @@ -1,76 +0,0 @@ -######################## BEGIN LICENSE BLOCK ######################## -# The Original Code is mozilla.org code. -# -# The Initial Developer of the Original Code is -# Netscape Communications Corporation. -# Portions created by the Initial Developer are Copyright (C) 1998 -# the Initial Developer. All Rights Reserved. -# -# Contributor(s): -# Mark Pilgrim - port to Python -# -# This library is free software; you can redistribute it and/or -# modify it under the terms of the GNU Lesser General Public -# License as published by the Free Software Foundation; either -# version 2.1 of the License, or (at your option) any later version. -# -# This library is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# Lesser General Public License for more details. -# -# You should have received a copy of the GNU Lesser General Public -# License along with this library; if not, write to the Free Software -# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA -# 02110-1301 USA -######################### END LICENSE BLOCK ######################### - -from . import constants -from .charsetprober import CharSetProber -from .codingstatemachine import CodingStateMachine -from .mbcssm import UTF8SMModel - -ONE_CHAR_PROB = 0.5 - - -class UTF8Prober(CharSetProber): - def __init__(self): - CharSetProber.__init__(self) - self._mCodingSM = CodingStateMachine(UTF8SMModel) - self.reset() - - def reset(self): - CharSetProber.reset(self) - self._mCodingSM.reset() - self._mNumOfMBChar = 0 - - def get_charset_name(self): - return "utf-8" - - def feed(self, aBuf): - for c in aBuf: - codingState = self._mCodingSM.next_state(c) - if codingState == constants.eError: - self._mState = constants.eNotMe - break - elif codingState == constants.eItsMe: - self._mState = constants.eFoundIt - break - elif codingState == constants.eStart: - if self._mCodingSM.get_current_charlen() >= 2: - self._mNumOfMBChar += 1 - - if self.get_state() == constants.eDetecting: - if self.get_confidence() > constants.SHORTCUT_THRESHOLD: - self._mState = constants.eFoundIt - - return self.get_state() - - def get_confidence(self): - unlike = 0.99 - if self._mNumOfMBChar < 6: - for i in range(0, self._mNumOfMBChar): - unlike = unlike * ONE_CHAR_PROB - return 1.0 - unlike - else: - return unlike diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/__init__.py deleted file mode 100644 index f48ac4af..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/__init__.py +++ /dev/null @@ -1,69 +0,0 @@ -""" -urllib3 - Thread-safe connection pooling and re-using. -""" - -__author__ = 'Andrey Petrov (andrey.petrov@shazow.net)' -__license__ = 'MIT' -__version__ = '1.10.4' - - -from .connectionpool import ( - HTTPConnectionPool, - HTTPSConnectionPool, - connection_from_url -) - -from . import exceptions -from .filepost import encode_multipart_formdata -from .poolmanager import PoolManager, ProxyManager, proxy_from_url -from .response import HTTPResponse -from .util.request import make_headers -from .util.url import get_host -from .util.timeout import Timeout -from .util.retry import Retry - - -# Set default logging handler to avoid "No handler found" warnings. -import logging -try: # Python 2.7+ - from logging import NullHandler -except ImportError: - class NullHandler(logging.Handler): - def emit(self, record): - pass - -logging.getLogger(__name__).addHandler(NullHandler()) - -def add_stderr_logger(level=logging.DEBUG): - """ - Helper for quickly adding a StreamHandler to the logger. Useful for - debugging. - - Returns the handler after adding it. - """ - # This method needs to be in this __init__.py to get the __name__ correct - # even if urllib3 is vendored within another package. - logger = logging.getLogger(__name__) - handler = logging.StreamHandler() - handler.setFormatter(logging.Formatter('%(asctime)s %(levelname)s %(message)s')) - logger.addHandler(handler) - logger.setLevel(level) - logger.debug('Added a stderr logging handler to logger: %s' % __name__) - return handler - -# ... Clean up. -del NullHandler - - -import warnings -# SecurityWarning's always go off by default. -warnings.simplefilter('always', exceptions.SecurityWarning, append=True) -# InsecurePlatformWarning's don't vary between requests, so we keep it default. -warnings.simplefilter('default', exceptions.InsecurePlatformWarning, - append=True) - -def disable_warnings(category=exceptions.HTTPWarning): - """ - Helper for quickly disabling all urllib3 warnings. - """ - warnings.simplefilter('ignore', category) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/_collections.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/_collections.py deleted file mode 100644 index 279416ce..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/_collections.py +++ /dev/null @@ -1,323 +0,0 @@ -from collections import Mapping, MutableMapping -try: - from threading import RLock -except ImportError: # Platform-specific: No threads available - class RLock: - def __enter__(self): - pass - - def __exit__(self, exc_type, exc_value, traceback): - pass - - -try: # Python 2.7+ - from collections import OrderedDict -except ImportError: - from .packages.ordered_dict import OrderedDict -from .packages.six import iterkeys, itervalues, PY3 - - -__all__ = ['RecentlyUsedContainer', 'HTTPHeaderDict'] - - -_Null = object() - - -class RecentlyUsedContainer(MutableMapping): - """ - Provides a thread-safe dict-like container which maintains up to - ``maxsize`` keys while throwing away the least-recently-used keys beyond - ``maxsize``. - - :param maxsize: - Maximum number of recent elements to retain. - - :param dispose_func: - Every time an item is evicted from the container, - ``dispose_func(value)`` is called. Callback which will get called - """ - - ContainerCls = OrderedDict - - def __init__(self, maxsize=10, dispose_func=None): - self._maxsize = maxsize - self.dispose_func = dispose_func - - self._container = self.ContainerCls() - self.lock = RLock() - - def __getitem__(self, key): - # Re-insert the item, moving it to the end of the eviction line. - with self.lock: - item = self._container.pop(key) - self._container[key] = item - return item - - def __setitem__(self, key, value): - evicted_value = _Null - with self.lock: - # Possibly evict the existing value of 'key' - evicted_value = self._container.get(key, _Null) - self._container[key] = value - - # If we didn't evict an existing value, we might have to evict the - # least recently used item from the beginning of the container. - if len(self._container) > self._maxsize: - _key, evicted_value = self._container.popitem(last=False) - - if self.dispose_func and evicted_value is not _Null: - self.dispose_func(evicted_value) - - def __delitem__(self, key): - with self.lock: - value = self._container.pop(key) - - if self.dispose_func: - self.dispose_func(value) - - def __len__(self): - with self.lock: - return len(self._container) - - def __iter__(self): - raise NotImplementedError('Iteration over this class is unlikely to be threadsafe.') - - def clear(self): - with self.lock: - # Copy pointers to all values, then wipe the mapping - values = list(itervalues(self._container)) - self._container.clear() - - if self.dispose_func: - for value in values: - self.dispose_func(value) - - def keys(self): - with self.lock: - return list(iterkeys(self._container)) - - -_dict_setitem = dict.__setitem__ -_dict_getitem = dict.__getitem__ -_dict_delitem = dict.__delitem__ -_dict_contains = dict.__contains__ -_dict_setdefault = dict.setdefault - - -class HTTPHeaderDict(dict): - """ - :param headers: - An iterable of field-value pairs. Must not contain multiple field names - when compared case-insensitively. - - :param kwargs: - Additional field-value pairs to pass in to ``dict.update``. - - A ``dict`` like container for storing HTTP Headers. - - Field names are stored and compared case-insensitively in compliance with - RFC 7230. Iteration provides the first case-sensitive key seen for each - case-insensitive pair. - - Using ``__setitem__`` syntax overwrites fields that compare equal - case-insensitively in order to maintain ``dict``'s api. For fields that - compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add`` - in a loop. - - If multiple fields that are equal case-insensitively are passed to the - constructor or ``.update``, the behavior is undefined and some will be - lost. - - >>> headers = HTTPHeaderDict() - >>> headers.add('Set-Cookie', 'foo=bar') - >>> headers.add('set-cookie', 'baz=quxx') - >>> headers['content-length'] = '7' - >>> headers['SET-cookie'] - 'foo=bar, baz=quxx' - >>> headers['Content-Length'] - '7' - """ - - def __init__(self, headers=None, **kwargs): - dict.__init__(self) - if headers is not None: - if isinstance(headers, HTTPHeaderDict): - self._copy_from(headers) - else: - self.extend(headers) - if kwargs: - self.extend(kwargs) - - def __setitem__(self, key, val): - return _dict_setitem(self, key.lower(), (key, val)) - - def __getitem__(self, key): - val = _dict_getitem(self, key.lower()) - return ', '.join(val[1:]) - - def __delitem__(self, key): - return _dict_delitem(self, key.lower()) - - def __contains__(self, key): - return _dict_contains(self, key.lower()) - - def __eq__(self, other): - if not isinstance(other, Mapping) and not hasattr(other, 'keys'): - return False - if not isinstance(other, type(self)): - other = type(self)(other) - return dict((k1, self[k1]) for k1 in self) == dict((k2, other[k2]) for k2 in other) - - def __ne__(self, other): - return not self.__eq__(other) - - values = MutableMapping.values - get = MutableMapping.get - update = MutableMapping.update - - if not PY3: # Python 2 - iterkeys = MutableMapping.iterkeys - itervalues = MutableMapping.itervalues - - __marker = object() - - def pop(self, key, default=__marker): - '''D.pop(k[,d]) -> v, remove specified key and return the corresponding value. - If key is not found, d is returned if given, otherwise KeyError is raised. - ''' - # Using the MutableMapping function directly fails due to the private marker. - # Using ordinary dict.pop would expose the internal structures. - # So let's reinvent the wheel. - try: - value = self[key] - except KeyError: - if default is self.__marker: - raise - return default - else: - del self[key] - return value - - def discard(self, key): - try: - del self[key] - except KeyError: - pass - - def add(self, key, val): - """Adds a (name, value) pair, doesn't overwrite the value if it already - exists. - - >>> headers = HTTPHeaderDict(foo='bar') - >>> headers.add('Foo', 'baz') - >>> headers['foo'] - 'bar, baz' - """ - key_lower = key.lower() - new_vals = key, val - # Keep the common case aka no item present as fast as possible - vals = _dict_setdefault(self, key_lower, new_vals) - if new_vals is not vals: - # new_vals was not inserted, as there was a previous one - if isinstance(vals, list): - # If already several items got inserted, we have a list - vals.append(val) - else: - # vals should be a tuple then, i.e. only one item so far - # Need to convert the tuple to list for further extension - _dict_setitem(self, key_lower, [vals[0], vals[1], val]) - - def extend(self, *args, **kwargs): - """Generic import function for any type of header-like object. - Adapted version of MutableMapping.update in order to insert items - with self.add instead of self.__setitem__ - """ - if len(args) > 1: - raise TypeError("extend() takes at most 1 positional " - "arguments ({} given)".format(len(args))) - other = args[0] if len(args) >= 1 else () - - if isinstance(other, HTTPHeaderDict): - for key, val in other.iteritems(): - self.add(key, val) - elif isinstance(other, Mapping): - for key in other: - self.add(key, other[key]) - elif hasattr(other, "keys"): - for key in other.keys(): - self.add(key, other[key]) - else: - for key, value in other: - self.add(key, value) - - for key, value in kwargs.items(): - self.add(key, value) - - def getlist(self, key): - """Returns a list of all the values for the named field. Returns an - empty list if the key doesn't exist.""" - try: - vals = _dict_getitem(self, key.lower()) - except KeyError: - return [] - else: - if isinstance(vals, tuple): - return [vals[1]] - else: - return vals[1:] - - # Backwards compatibility for httplib - getheaders = getlist - getallmatchingheaders = getlist - iget = getlist - - def __repr__(self): - return "%s(%s)" % (type(self).__name__, dict(self.itermerged())) - - def _copy_from(self, other): - for key in other: - val = _dict_getitem(other, key) - if isinstance(val, list): - # Don't need to convert tuples - val = list(val) - _dict_setitem(self, key, val) - - def copy(self): - clone = type(self)() - clone._copy_from(self) - return clone - - def iteritems(self): - """Iterate over all header lines, including duplicate ones.""" - for key in self: - vals = _dict_getitem(self, key) - for val in vals[1:]: - yield vals[0], val - - def itermerged(self): - """Iterate over all headers, merging duplicate ones together.""" - for key in self: - val = _dict_getitem(self, key) - yield val[0], ', '.join(val[1:]) - - def items(self): - return list(self.iteritems()) - - @classmethod - def from_httplib(cls, message): # Python 2 - """Read headers from a Python 2 httplib message object.""" - # python2.7 does not expose a proper API for exporting multiheaders - # efficiently. This function re-reads raw lines from the message - # object and extracts the multiheaders properly. - headers = [] - - for line in message.headers: - if line.startswith((' ', '\t')): - key, value = headers[-1] - headers[-1] = (key, value + '\r\n' + line.rstrip()) - continue - - key, value = line.split(':', 1) - headers.append((key, value.strip())) - - return cls(headers) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connection.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connection.py deleted file mode 100644 index 2a8c3596..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connection.py +++ /dev/null @@ -1,264 +0,0 @@ -import datetime -import sys -import socket -from socket import timeout as SocketTimeout -import warnings -from .packages import six - -try: # Python 3 - from http.client import HTTPConnection as _HTTPConnection, HTTPException -except ImportError: - from httplib import HTTPConnection as _HTTPConnection, HTTPException - - -class DummyConnection(object): - "Used to detect a failed ConnectionCls import." - pass - - -try: # Compiled with SSL? - HTTPSConnection = DummyConnection - import ssl - BaseSSLError = ssl.SSLError -except (ImportError, AttributeError): # Platform-specific: No SSL. - ssl = None - - class BaseSSLError(BaseException): - pass - - -try: # Python 3: - # Not a no-op, we're adding this to the namespace so it can be imported. - ConnectionError = ConnectionError -except NameError: # Python 2: - class ConnectionError(Exception): - pass - - -from .exceptions import ( - ConnectTimeoutError, - SystemTimeWarning, - SecurityWarning, -) -from .packages.ssl_match_hostname import match_hostname - -from .util.ssl_ import ( - resolve_cert_reqs, - resolve_ssl_version, - ssl_wrap_socket, - assert_fingerprint, -) - - -from .util import connection - -port_by_scheme = { - 'http': 80, - 'https': 443, -} - -RECENT_DATE = datetime.date(2014, 1, 1) - - -class HTTPConnection(_HTTPConnection, object): - """ - Based on httplib.HTTPConnection but provides an extra constructor - backwards-compatibility layer between older and newer Pythons. - - Additional keyword parameters are used to configure attributes of the connection. - Accepted parameters include: - - - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool` - - ``source_address``: Set the source address for the current connection. - - .. note:: This is ignored for Python 2.6. It is only applied for 2.7 and 3.x - - - ``socket_options``: Set specific options on the underlying socket. If not specified, then - defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling - Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy. - - For example, if you wish to enable TCP Keep Alive in addition to the defaults, - you might pass:: - - HTTPConnection.default_socket_options + [ - (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1), - ] - - Or you may want to disable the defaults by passing an empty list (e.g., ``[]``). - """ - - default_port = port_by_scheme['http'] - - #: Disable Nagle's algorithm by default. - #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]`` - default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)] - - #: Whether this connection verifies the host's certificate. - is_verified = False - - def __init__(self, *args, **kw): - if six.PY3: # Python 3 - kw.pop('strict', None) - - # Pre-set source_address in case we have an older Python like 2.6. - self.source_address = kw.get('source_address') - - if sys.version_info < (2, 7): # Python 2.6 - # _HTTPConnection on Python 2.6 will balk at this keyword arg, but - # not newer versions. We can still use it when creating a - # connection though, so we pop it *after* we have saved it as - # self.source_address. - kw.pop('source_address', None) - - #: The socket options provided by the user. If no options are - #: provided, we use the default options. - self.socket_options = kw.pop('socket_options', self.default_socket_options) - - # Superclass also sets self.source_address in Python 2.7+. - _HTTPConnection.__init__(self, *args, **kw) - - def _new_conn(self): - """ Establish a socket connection and set nodelay settings on it. - - :return: New socket connection. - """ - extra_kw = {} - if self.source_address: - extra_kw['source_address'] = self.source_address - - if self.socket_options: - extra_kw['socket_options'] = self.socket_options - - try: - conn = connection.create_connection( - (self.host, self.port), self.timeout, **extra_kw) - - except SocketTimeout: - raise ConnectTimeoutError( - self, "Connection to %s timed out. (connect timeout=%s)" % - (self.host, self.timeout)) - - return conn - - def _prepare_conn(self, conn): - self.sock = conn - # the _tunnel_host attribute was added in python 2.6.3 (via - # http://hg.python.org/cpython/rev/0f57b30a152f) so pythons 2.6(0-2) do - # not have them. - if getattr(self, '_tunnel_host', None): - # TODO: Fix tunnel so it doesn't depend on self.sock state. - self._tunnel() - # Mark this connection as not reusable - self.auto_open = 0 - - def connect(self): - conn = self._new_conn() - self._prepare_conn(conn) - - -class HTTPSConnection(HTTPConnection): - default_port = port_by_scheme['https'] - - def __init__(self, host, port=None, key_file=None, cert_file=None, - strict=None, timeout=socket._GLOBAL_DEFAULT_TIMEOUT, **kw): - - HTTPConnection.__init__(self, host, port, strict=strict, - timeout=timeout, **kw) - - self.key_file = key_file - self.cert_file = cert_file - - # Required property for Google AppEngine 1.9.0 which otherwise causes - # HTTPS requests to go out as HTTP. (See Issue #356) - self._protocol = 'https' - - def connect(self): - conn = self._new_conn() - self._prepare_conn(conn) - self.sock = ssl.wrap_socket(conn, self.key_file, self.cert_file) - - -class VerifiedHTTPSConnection(HTTPSConnection): - """ - Based on httplib.HTTPSConnection but wraps the socket with - SSL certification. - """ - cert_reqs = None - ca_certs = None - ssl_version = None - assert_fingerprint = None - - def set_cert(self, key_file=None, cert_file=None, - cert_reqs=None, ca_certs=None, - assert_hostname=None, assert_fingerprint=None): - - self.key_file = key_file - self.cert_file = cert_file - self.cert_reqs = cert_reqs - self.ca_certs = ca_certs - self.assert_hostname = assert_hostname - self.assert_fingerprint = assert_fingerprint - - def connect(self): - # Add certificate verification - conn = self._new_conn() - - resolved_cert_reqs = resolve_cert_reqs(self.cert_reqs) - resolved_ssl_version = resolve_ssl_version(self.ssl_version) - - hostname = self.host - if getattr(self, '_tunnel_host', None): - # _tunnel_host was added in Python 2.6.3 - # (See: http://hg.python.org/cpython/rev/0f57b30a152f) - - self.sock = conn - # Calls self._set_hostport(), so self.host is - # self._tunnel_host below. - self._tunnel() - # Mark this connection as not reusable - self.auto_open = 0 - - # Override the host with the one we're requesting data from. - hostname = self._tunnel_host - - is_time_off = datetime.date.today() < RECENT_DATE - if is_time_off: - warnings.warn(( - 'System time is way off (before {0}). This will probably ' - 'lead to SSL verification errors').format(RECENT_DATE), - SystemTimeWarning - ) - - # Wrap socket using verification with the root certs in - # trusted_root_certs - self.sock = ssl_wrap_socket(conn, self.key_file, self.cert_file, - cert_reqs=resolved_cert_reqs, - ca_certs=self.ca_certs, - server_hostname=hostname, - ssl_version=resolved_ssl_version) - - if self.assert_fingerprint: - assert_fingerprint(self.sock.getpeercert(binary_form=True), - self.assert_fingerprint) - elif resolved_cert_reqs != ssl.CERT_NONE \ - and self.assert_hostname is not False: - cert = self.sock.getpeercert() - if not cert.get('subjectAltName', ()): - warnings.warn(( - 'Certificate has no `subjectAltName`, falling back to check for a `commonName` for now. ' - 'This feature is being removed by major browsers and deprecated by RFC 2818. ' - '(See https://github.com/shazow/urllib3/issues/497 for details.)'), - SecurityWarning - ) - match_hostname(cert, self.assert_hostname or hostname) - - self.is_verified = (resolved_cert_reqs == ssl.CERT_REQUIRED - or self.assert_fingerprint is not None) - - -if ssl: - # Make a copy for testing. - UnverifiedHTTPSConnection = HTTPSConnection - HTTPSConnection = VerifiedHTTPSConnection -else: - HTTPSConnection = DummyConnection diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connectionpool.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connectionpool.py deleted file mode 100644 index 117269ac..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/connectionpool.py +++ /dev/null @@ -1,795 +0,0 @@ -import errno -import logging -import sys -import warnings - -from socket import error as SocketError, timeout as SocketTimeout -import socket - -try: # Python 3 - from queue import LifoQueue, Empty, Full -except ImportError: - from Queue import LifoQueue, Empty, Full - import Queue as _ # Platform-specific: Windows - - -from .exceptions import ( - ClosedPoolError, - ProtocolError, - EmptyPoolError, - HostChangedError, - LocationValueError, - MaxRetryError, - ProxyError, - ReadTimeoutError, - SSLError, - TimeoutError, - InsecureRequestWarning, -) -from .packages.ssl_match_hostname import CertificateError -from .packages import six -from .connection import ( - port_by_scheme, - DummyConnection, - HTTPConnection, HTTPSConnection, VerifiedHTTPSConnection, - HTTPException, BaseSSLError, ConnectionError -) -from .request import RequestMethods -from .response import HTTPResponse - -from .util.connection import is_connection_dropped -from .util.retry import Retry -from .util.timeout import Timeout -from .util.url import get_host - - -xrange = six.moves.xrange - -log = logging.getLogger(__name__) - -_Default = object() - - -## Pool objects -class ConnectionPool(object): - """ - Base class for all connection pools, such as - :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`. - """ - - scheme = None - QueueCls = LifoQueue - - def __init__(self, host, port=None): - if not host: - raise LocationValueError("No host specified.") - - # httplib doesn't like it when we include brackets in ipv6 addresses - self.host = host.strip('[]') - self.port = port - - def __str__(self): - return '%s(host=%r, port=%r)' % (type(self).__name__, - self.host, self.port) - - def __enter__(self): - return self - - def __exit__(self, exc_type, exc_val, exc_tb): - self.close() - # Return False to re-raise any potential exceptions - return False - - def close(): - """ - Close all pooled connections and disable the pool. - """ - pass - - -# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252 -_blocking_errnos = set([errno.EAGAIN, errno.EWOULDBLOCK]) - - -class HTTPConnectionPool(ConnectionPool, RequestMethods): - """ - Thread-safe connection pool for one host. - - :param host: - Host used for this HTTP Connection (e.g. "localhost"), passed into - :class:`httplib.HTTPConnection`. - - :param port: - Port used for this HTTP Connection (None is equivalent to 80), passed - into :class:`httplib.HTTPConnection`. - - :param strict: - Causes BadStatusLine to be raised if the status line can't be parsed - as a valid HTTP/1.0 or 1.1 status line, passed into - :class:`httplib.HTTPConnection`. - - .. note:: - Only works in Python 2. This parameter is ignored in Python 3. - - :param timeout: - Socket timeout in seconds for each individual connection. This can - be a float or integer, which sets the timeout for the HTTP request, - or an instance of :class:`urllib3.util.Timeout` which gives you more - fine-grained control over request timeouts. After the constructor has - been parsed, this is always a `urllib3.util.Timeout` object. - - :param maxsize: - Number of connections to save that can be reused. More than 1 is useful - in multithreaded situations. If ``block`` is set to false, more - connections will be created but they will not be saved once they've - been used. - - :param block: - If set to True, no more than ``maxsize`` connections will be used at - a time. When no free connections are available, the call will block - until a connection has been released. This is a useful side effect for - particular multithreaded situations where one does not want to use more - than maxsize connections per host to prevent flooding. - - :param headers: - Headers to include with all requests, unless other headers are given - explicitly. - - :param retries: - Retry configuration to use by default with requests in this pool. - - :param _proxy: - Parsed proxy URL, should not be used directly, instead, see - :class:`urllib3.connectionpool.ProxyManager`" - - :param _proxy_headers: - A dictionary with proxy headers, should not be used directly, - instead, see :class:`urllib3.connectionpool.ProxyManager`" - - :param \**conn_kw: - Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`, - :class:`urllib3.connection.HTTPSConnection` instances. - """ - - scheme = 'http' - ConnectionCls = HTTPConnection - - def __init__(self, host, port=None, strict=False, - timeout=Timeout.DEFAULT_TIMEOUT, maxsize=1, block=False, - headers=None, retries=None, - _proxy=None, _proxy_headers=None, - **conn_kw): - ConnectionPool.__init__(self, host, port) - RequestMethods.__init__(self, headers) - - self.strict = strict - - if not isinstance(timeout, Timeout): - timeout = Timeout.from_float(timeout) - - if retries is None: - retries = Retry.DEFAULT - - self.timeout = timeout - self.retries = retries - - self.pool = self.QueueCls(maxsize) - self.block = block - - self.proxy = _proxy - self.proxy_headers = _proxy_headers or {} - - # Fill the queue up so that doing get() on it will block properly - for _ in xrange(maxsize): - self.pool.put(None) - - # These are mostly for testing and debugging purposes. - self.num_connections = 0 - self.num_requests = 0 - self.conn_kw = conn_kw - - if self.proxy: - # Enable Nagle's algorithm for proxies, to avoid packet fragmentation. - # We cannot know if the user has added default socket options, so we cannot replace the - # list. - self.conn_kw.setdefault('socket_options', []) - - def _new_conn(self): - """ - Return a fresh :class:`HTTPConnection`. - """ - self.num_connections += 1 - log.info("Starting new HTTP connection (%d): %s" % - (self.num_connections, self.host)) - - conn = self.ConnectionCls(host=self.host, port=self.port, - timeout=self.timeout.connect_timeout, - strict=self.strict, **self.conn_kw) - return conn - - def _get_conn(self, timeout=None): - """ - Get a connection. Will return a pooled connection if one is available. - - If no connections are available and :prop:`.block` is ``False``, then a - fresh connection is returned. - - :param timeout: - Seconds to wait before giving up and raising - :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and - :prop:`.block` is ``True``. - """ - conn = None - try: - conn = self.pool.get(block=self.block, timeout=timeout) - - except AttributeError: # self.pool is None - raise ClosedPoolError(self, "Pool is closed.") - - except Empty: - if self.block: - raise EmptyPoolError(self, - "Pool reached maximum size and no more " - "connections are allowed.") - pass # Oh well, we'll create a new connection then - - # If this is a persistent connection, check if it got disconnected - if conn and is_connection_dropped(conn): - log.info("Resetting dropped connection: %s" % self.host) - conn.close() - if getattr(conn, 'auto_open', 1) == 0: - # This is a proxied connection that has been mutated by - # httplib._tunnel() and cannot be reused (since it would - # attempt to bypass the proxy) - conn = None - - return conn or self._new_conn() - - def _put_conn(self, conn): - """ - Put a connection back into the pool. - - :param conn: - Connection object for the current host and port as returned by - :meth:`._new_conn` or :meth:`._get_conn`. - - If the pool is already full, the connection is closed and discarded - because we exceeded maxsize. If connections are discarded frequently, - then maxsize should be increased. - - If the pool is closed, then the connection will be closed and discarded. - """ - try: - self.pool.put(conn, block=False) - return # Everything is dandy, done. - except AttributeError: - # self.pool is None. - pass - except Full: - # This should never happen if self.block == True - log.warning( - "Connection pool is full, discarding connection: %s" % - self.host) - - # Connection never got put back into the pool, close it. - if conn: - conn.close() - - def _validate_conn(self, conn): - """ - Called right before a request is made, after the socket is created. - """ - pass - - def _prepare_proxy(self, conn): - # Nothing to do for HTTP connections. - pass - - def _get_timeout(self, timeout): - """ Helper that always returns a :class:`urllib3.util.Timeout` """ - if timeout is _Default: - return self.timeout.clone() - - if isinstance(timeout, Timeout): - return timeout.clone() - else: - # User passed us an int/float. This is for backwards compatibility, - # can be removed later - return Timeout.from_float(timeout) - - def _raise_timeout(self, err, url, timeout_value): - """Is the error actually a timeout? Will raise a ReadTimeout or pass""" - - if isinstance(err, SocketTimeout): - raise ReadTimeoutError(self, url, "Read timed out. (read timeout=%s)" % timeout_value) - - # See the above comment about EAGAIN in Python 3. In Python 2 we have - # to specifically catch it and throw the timeout error - if hasattr(err, 'errno') and err.errno in _blocking_errnos: - raise ReadTimeoutError(self, url, "Read timed out. (read timeout=%s)" % timeout_value) - - # Catch possible read timeouts thrown as SSL errors. If not the - # case, rethrow the original. We need to do this because of: - # http://bugs.python.org/issue10272 - if 'timed out' in str(err) or 'did not complete (read)' in str(err): # Python 2.6 - raise ReadTimeoutError(self, url, "Read timed out. (read timeout=%s)" % timeout_value) - - def _make_request(self, conn, method, url, timeout=_Default, - **httplib_request_kw): - """ - Perform a request on a given urllib connection object taken from our - pool. - - :param conn: - a connection from one of our connection pools - - :param timeout: - Socket timeout in seconds for the request. This can be a - float or integer, which will set the same timeout value for - the socket connect and the socket read, or an instance of - :class:`urllib3.util.Timeout`, which gives you more fine-grained - control over your timeouts. - """ - self.num_requests += 1 - - timeout_obj = self._get_timeout(timeout) - timeout_obj.start_connect() - conn.timeout = timeout_obj.connect_timeout - - # Trigger any extra validation we need to do. - try: - self._validate_conn(conn) - except (SocketTimeout, BaseSSLError) as e: - # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout. - self._raise_timeout(err=e, url=url, timeout_value=conn.timeout) - raise - - # conn.request() calls httplib.*.request, not the method in - # urllib3.request. It also calls makefile (recv) on the socket. - conn.request(method, url, **httplib_request_kw) - - # Reset the timeout for the recv() on the socket - read_timeout = timeout_obj.read_timeout - - # App Engine doesn't have a sock attr - if getattr(conn, 'sock', None): - # In Python 3 socket.py will catch EAGAIN and return None when you - # try and read into the file pointer created by http.client, which - # instead raises a BadStatusLine exception. Instead of catching - # the exception and assuming all BadStatusLine exceptions are read - # timeouts, check for a zero timeout before making the request. - if read_timeout == 0: - raise ReadTimeoutError( - self, url, "Read timed out. (read timeout=%s)" % read_timeout) - if read_timeout is Timeout.DEFAULT_TIMEOUT: - conn.sock.settimeout(socket.getdefaulttimeout()) - else: # None or a value - conn.sock.settimeout(read_timeout) - - # Receive the response from the server - try: - try: # Python 2.7, use buffering of HTTP responses - httplib_response = conn.getresponse(buffering=True) - except TypeError: # Python 2.6 and older - httplib_response = conn.getresponse() - except (SocketTimeout, BaseSSLError, SocketError) as e: - self._raise_timeout(err=e, url=url, timeout_value=read_timeout) - raise - - # AppEngine doesn't have a version attr. - http_version = getattr(conn, '_http_vsn_str', 'HTTP/?') - log.debug("\"%s %s %s\" %s %s" % (method, url, http_version, - httplib_response.status, - httplib_response.length)) - return httplib_response - - def close(self): - """ - Close all pooled connections and disable the pool. - """ - # Disable access to the pool - old_pool, self.pool = self.pool, None - - try: - while True: - conn = old_pool.get(block=False) - if conn: - conn.close() - - except Empty: - pass # Done. - - def is_same_host(self, url): - """ - Check if the given ``url`` is a member of the same host as this - connection pool. - """ - if url.startswith('/'): - return True - - # TODO: Add optional support for socket.gethostbyname checking. - scheme, host, port = get_host(url) - - # Use explicit default port for comparison when none is given - if self.port and not port: - port = port_by_scheme.get(scheme) - elif not self.port and port == port_by_scheme.get(scheme): - port = None - - return (scheme, host, port) == (self.scheme, self.host, self.port) - - def urlopen(self, method, url, body=None, headers=None, retries=None, - redirect=True, assert_same_host=True, timeout=_Default, - pool_timeout=None, release_conn=None, **response_kw): - """ - Get a connection from the pool and perform an HTTP request. This is the - lowest level call for making a request, so you'll need to specify all - the raw details. - - .. note:: - - More commonly, it's appropriate to use a convenience method provided - by :class:`.RequestMethods`, such as :meth:`request`. - - .. note:: - - `release_conn` will only behave as expected if - `preload_content=False` because we want to make - `preload_content=False` the default behaviour someday soon without - breaking backwards compatibility. - - :param method: - HTTP request method (such as GET, POST, PUT, etc.) - - :param body: - Data to send in the request body (useful for creating - POST requests, see HTTPConnectionPool.post_url for - more convenience). - - :param headers: - Dictionary of custom headers to send, such as User-Agent, - If-None-Match, etc. If None, pool headers are used. If provided, - these headers completely replace any pool-specific headers. - - :param retries: - Configure the number of retries to allow before raising a - :class:`~urllib3.exceptions.MaxRetryError` exception. - - Pass ``None`` to retry until you receive a response. Pass a - :class:`~urllib3.util.retry.Retry` object for fine-grained control - over different types of retries. - Pass an integer number to retry connection errors that many times, - but no other types of errors. Pass zero to never retry. - - If ``False``, then retries are disabled and any exception is raised - immediately. Also, instead of raising a MaxRetryError on redirects, - the redirect response will be returned. - - :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. - - :param redirect: - If True, automatically handle redirects (status codes 301, 302, - 303, 307, 308). Each redirect counts as a retry. Disabling retries - will disable redirect, too. - - :param assert_same_host: - If ``True``, will make sure that the host of the pool requests is - consistent else will raise HostChangedError. When False, you can - use the pool on an HTTP proxy and request foreign hosts. - - :param timeout: - If specified, overrides the default timeout for this one - request. It may be a float (in seconds) or an instance of - :class:`urllib3.util.Timeout`. - - :param pool_timeout: - If set and the pool is set to block=True, then this method will - block for ``pool_timeout`` seconds and raise EmptyPoolError if no - connection is available within the time period. - - :param release_conn: - If False, then the urlopen call will not release the connection - back into the pool once a response is received (but will release if - you read the entire contents of the response such as when - `preload_content=True`). This is useful if you're not preloading - the response's content immediately. You will need to call - ``r.release_conn()`` on the response ``r`` to return the connection - back into the pool. If None, it takes the value of - ``response_kw.get('preload_content', True)``. - - :param \**response_kw: - Additional parameters are passed to - :meth:`urllib3.response.HTTPResponse.from_httplib` - """ - if headers is None: - headers = self.headers - - if not isinstance(retries, Retry): - retries = Retry.from_int(retries, redirect=redirect, default=self.retries) - - if release_conn is None: - release_conn = response_kw.get('preload_content', True) - - # Check host - if assert_same_host and not self.is_same_host(url): - raise HostChangedError(self, url, retries) - - conn = None - - # Merge the proxy headers. Only do this in HTTP. We have to copy the - # headers dict so we can safely change it without those changes being - # reflected in anyone else's copy. - if self.scheme == 'http': - headers = headers.copy() - headers.update(self.proxy_headers) - - # Must keep the exception bound to a separate variable or else Python 3 - # complains about UnboundLocalError. - err = None - - try: - # Request a connection from the queue. - timeout_obj = self._get_timeout(timeout) - conn = self._get_conn(timeout=pool_timeout) - - conn.timeout = timeout_obj.connect_timeout - - is_new_proxy_conn = self.proxy is not None and not getattr(conn, 'sock', None) - if is_new_proxy_conn: - self._prepare_proxy(conn) - - # Make the request on the httplib connection object. - httplib_response = self._make_request(conn, method, url, - timeout=timeout_obj, - body=body, headers=headers) - - # If we're going to release the connection in ``finally:``, then - # the request doesn't need to know about the connection. Otherwise - # it will also try to release it and we'll have a double-release - # mess. - response_conn = not release_conn and conn - - # Import httplib's response into our own wrapper object - response = HTTPResponse.from_httplib(httplib_response, - pool=self, - connection=response_conn, - **response_kw) - - # else: - # The connection will be put back into the pool when - # ``response.release_conn()`` is called (implicitly by - # ``response.read()``) - - except Empty: - # Timed out by queue. - raise EmptyPoolError(self, "No pool connections are available.") - - except (BaseSSLError, CertificateError) as e: - # Close the connection. If a connection is reused on which there - # was a Certificate error, the next request will certainly raise - # another Certificate error. - if conn: - conn.close() - conn = None - raise SSLError(e) - - except SSLError: - # Treat SSLError separately from BaseSSLError to preserve - # traceback. - if conn: - conn.close() - conn = None - raise - - except (TimeoutError, HTTPException, SocketError, ConnectionError) as e: - if conn: - # Discard the connection for these exceptions. It will be - # be replaced during the next _get_conn() call. - conn.close() - conn = None - - if isinstance(e, SocketError) and self.proxy: - e = ProxyError('Cannot connect to proxy.', e) - elif isinstance(e, (SocketError, HTTPException)): - e = ProtocolError('Connection aborted.', e) - - retries = retries.increment(method, url, error=e, _pool=self, - _stacktrace=sys.exc_info()[2]) - retries.sleep() - - # Keep track of the error for the retry warning. - err = e - - finally: - if release_conn: - # Put the connection back to be reused. If the connection is - # expired then it will be None, which will get replaced with a - # fresh connection during _get_conn. - self._put_conn(conn) - - if not conn: - # Try again - log.warning("Retrying (%r) after connection " - "broken by '%r': %s" % (retries, err, url)) - return self.urlopen(method, url, body, headers, retries, - redirect, assert_same_host, - timeout=timeout, pool_timeout=pool_timeout, - release_conn=release_conn, **response_kw) - - # Handle redirect? - redirect_location = redirect and response.get_redirect_location() - if redirect_location: - if response.status == 303: - method = 'GET' - - try: - retries = retries.increment(method, url, response=response, _pool=self) - except MaxRetryError: - if retries.raise_on_redirect: - raise - return response - - log.info("Redirecting %s -> %s" % (url, redirect_location)) - return self.urlopen(method, redirect_location, body, headers, - retries=retries, redirect=redirect, - assert_same_host=assert_same_host, - timeout=timeout, pool_timeout=pool_timeout, - release_conn=release_conn, **response_kw) - - # Check if we should retry the HTTP response. - if retries.is_forced_retry(method, status_code=response.status): - retries = retries.increment(method, url, response=response, _pool=self) - retries.sleep() - log.info("Forced retry: %s" % url) - return self.urlopen(method, url, body, headers, - retries=retries, redirect=redirect, - assert_same_host=assert_same_host, - timeout=timeout, pool_timeout=pool_timeout, - release_conn=release_conn, **response_kw) - - return response - - -class HTTPSConnectionPool(HTTPConnectionPool): - """ - Same as :class:`.HTTPConnectionPool`, but HTTPS. - - When Python is compiled with the :mod:`ssl` module, then - :class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates, - instead of :class:`.HTTPSConnection`. - - :class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``, - ``assert_hostname`` and ``host`` in this order to verify connections. - If ``assert_hostname`` is False, no verification is done. - - The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs`` and - ``ssl_version`` are only used if :mod:`ssl` is available and are fed into - :meth:`urllib3.util.ssl_wrap_socket` to upgrade the connection socket - into an SSL socket. - """ - - scheme = 'https' - ConnectionCls = HTTPSConnection - - def __init__(self, host, port=None, - strict=False, timeout=Timeout.DEFAULT_TIMEOUT, maxsize=1, - block=False, headers=None, retries=None, - _proxy=None, _proxy_headers=None, - key_file=None, cert_file=None, cert_reqs=None, - ca_certs=None, ssl_version=None, - assert_hostname=None, assert_fingerprint=None, - **conn_kw): - - HTTPConnectionPool.__init__(self, host, port, strict, timeout, maxsize, - block, headers, retries, _proxy, _proxy_headers, - **conn_kw) - self.key_file = key_file - self.cert_file = cert_file - self.cert_reqs = cert_reqs - self.ca_certs = ca_certs - self.ssl_version = ssl_version - self.assert_hostname = assert_hostname - self.assert_fingerprint = assert_fingerprint - - def _prepare_conn(self, conn): - """ - Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket` - and establish the tunnel if proxy is used. - """ - - if isinstance(conn, VerifiedHTTPSConnection): - conn.set_cert(key_file=self.key_file, - cert_file=self.cert_file, - cert_reqs=self.cert_reqs, - ca_certs=self.ca_certs, - assert_hostname=self.assert_hostname, - assert_fingerprint=self.assert_fingerprint) - conn.ssl_version = self.ssl_version - - return conn - - def _prepare_proxy(self, conn): - """ - Establish tunnel connection early, because otherwise httplib - would improperly set Host: header to proxy's IP:port. - """ - # Python 2.7+ - try: - set_tunnel = conn.set_tunnel - except AttributeError: # Platform-specific: Python 2.6 - set_tunnel = conn._set_tunnel - - if sys.version_info <= (2, 6, 4) and not self.proxy_headers: # Python 2.6.4 and older - set_tunnel(self.host, self.port) - else: - set_tunnel(self.host, self.port, self.proxy_headers) - - conn.connect() - - def _new_conn(self): - """ - Return a fresh :class:`httplib.HTTPSConnection`. - """ - self.num_connections += 1 - log.info("Starting new HTTPS connection (%d): %s" - % (self.num_connections, self.host)) - - if not self.ConnectionCls or self.ConnectionCls is DummyConnection: - raise SSLError("Can't connect to HTTPS URL because the SSL " - "module is not available.") - - actual_host = self.host - actual_port = self.port - if self.proxy is not None: - actual_host = self.proxy.host - actual_port = self.proxy.port - - conn = self.ConnectionCls(host=actual_host, port=actual_port, - timeout=self.timeout.connect_timeout, - strict=self.strict, **self.conn_kw) - - return self._prepare_conn(conn) - - def _validate_conn(self, conn): - """ - Called right before a request is made, after the socket is created. - """ - super(HTTPSConnectionPool, self)._validate_conn(conn) - - # Force connect early to allow us to validate the connection. - if not getattr(conn, 'sock', None): # AppEngine might not have `.sock` - conn.connect() - - if not conn.is_verified: - warnings.warn(( - 'Unverified HTTPS request is being made. ' - 'Adding certificate verification is strongly advised. See: ' - 'https://urllib3.readthedocs.org/en/latest/security.html'), - InsecureRequestWarning) - - -def connection_from_url(url, **kw): - """ - Given a url, return an :class:`.ConnectionPool` instance of its host. - - This is a shortcut for not having to parse out the scheme, host, and port - of the url before creating an :class:`.ConnectionPool` instance. - - :param url: - Absolute URL string that must include the scheme. Port is optional. - - :param \**kw: - Passes additional parameters to the constructor of the appropriate - :class:`.ConnectionPool`. Useful for specifying things like - timeout, maxsize, headers, etc. - - Example:: - - >>> conn = connection_from_url('http://google.com/') - >>> r = conn.request('GET', '/') - """ - scheme, host, port = get_host(url) - if scheme == 'https': - return HTTPSConnectionPool(host, port=port, **kw) - else: - return HTTPConnectionPool(host, port=port, **kw) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/__init__.py deleted file mode 100644 index e69de29b..00000000 diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.py deleted file mode 100644 index c6b266f5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.py +++ /dev/null @@ -1,114 +0,0 @@ -""" -NTLM authenticating pool, contributed by erikcederstran - -Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10 -""" - -try: - from http.client import HTTPSConnection -except ImportError: - from httplib import HTTPSConnection -from logging import getLogger -from ntlm import ntlm - -from urllib3 import HTTPSConnectionPool - - -log = getLogger(__name__) - - -class NTLMConnectionPool(HTTPSConnectionPool): - """ - Implements an NTLM authentication version of an urllib3 connection pool - """ - - scheme = 'https' - - def __init__(self, user, pw, authurl, *args, **kwargs): - """ - authurl is a random URL on the server that is protected by NTLM. - user is the Windows user, probably in the DOMAIN\\username format. - pw is the password for the user. - """ - super(NTLMConnectionPool, self).__init__(*args, **kwargs) - self.authurl = authurl - self.rawuser = user - user_parts = user.split('\\', 1) - self.domain = user_parts[0].upper() - self.user = user_parts[1] - self.pw = pw - - def _new_conn(self): - # Performs the NTLM handshake that secures the connection. The socket - # must be kept open while requests are performed. - self.num_connections += 1 - log.debug('Starting NTLM HTTPS connection no. %d: https://%s%s' % - (self.num_connections, self.host, self.authurl)) - - headers = {} - headers['Connection'] = 'Keep-Alive' - req_header = 'Authorization' - resp_header = 'www-authenticate' - - conn = HTTPSConnection(host=self.host, port=self.port) - - # Send negotiation message - headers[req_header] = ( - 'NTLM %s' % ntlm.create_NTLM_NEGOTIATE_MESSAGE(self.rawuser)) - log.debug('Request headers: %s' % headers) - conn.request('GET', self.authurl, None, headers) - res = conn.getresponse() - reshdr = dict(res.getheaders()) - log.debug('Response status: %s %s' % (res.status, res.reason)) - log.debug('Response headers: %s' % reshdr) - log.debug('Response data: %s [...]' % res.read(100)) - - # Remove the reference to the socket, so that it can not be closed by - # the response object (we want to keep the socket open) - res.fp = None - - # Server should respond with a challenge message - auth_header_values = reshdr[resp_header].split(', ') - auth_header_value = None - for s in auth_header_values: - if s[:5] == 'NTLM ': - auth_header_value = s[5:] - if auth_header_value is None: - raise Exception('Unexpected %s response header: %s' % - (resp_header, reshdr[resp_header])) - - # Send authentication message - ServerChallenge, NegotiateFlags = \ - ntlm.parse_NTLM_CHALLENGE_MESSAGE(auth_header_value) - auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(ServerChallenge, - self.user, - self.domain, - self.pw, - NegotiateFlags) - headers[req_header] = 'NTLM %s' % auth_msg - log.debug('Request headers: %s' % headers) - conn.request('GET', self.authurl, None, headers) - res = conn.getresponse() - log.debug('Response status: %s %s' % (res.status, res.reason)) - log.debug('Response headers: %s' % dict(res.getheaders())) - log.debug('Response data: %s [...]' % res.read()[:100]) - if res.status != 200: - if res.status == 401: - raise Exception('Server rejected request: wrong ' - 'username or password') - raise Exception('Wrong server response: %s %s' % - (res.status, res.reason)) - - res.fp = None - log.debug('Connection established') - return conn - - def urlopen(self, method, url, body=None, headers=None, retries=3, - redirect=True, assert_same_host=True): - if headers is None: - headers = {} - headers['Connection'] = 'Keep-Alive' - return super(NTLMConnectionPool, self).urlopen(method, url, body, - headers, retries, - redirect, - assert_same_host) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.py deleted file mode 100644 index b2c34a89..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.py +++ /dev/null @@ -1,293 +0,0 @@ -'''SSL with SNI_-support for Python 2. Follow these instructions if you would -like to verify SSL certificates in Python 2. Note, the default libraries do -*not* do certificate checking; you need to do additional work to validate -certificates yourself. - -This needs the following packages installed: - -* pyOpenSSL (tested with 0.13) -* ndg-httpsclient (tested with 0.3.2) -* pyasn1 (tested with 0.1.6) - -You can install them with the following command: - - pip install pyopenssl ndg-httpsclient pyasn1 - -To activate certificate checking, call -:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code -before you begin making HTTP requests. This can be done in a ``sitecustomize`` -module, or at any other time before your application begins using ``urllib3``, -like this:: - - try: - import urllib3.contrib.pyopenssl - urllib3.contrib.pyopenssl.inject_into_urllib3() - except ImportError: - pass - -Now you can use :mod:`urllib3` as you normally would, and it will support SNI -when the required modules are installed. - -Activating this module also has the positive side effect of disabling SSL/TLS -compression in Python 2 (see `CRIME attack`_). - -If you want to configure the default list of supported cipher suites, you can -set the ``urllib3.contrib.pyopenssl.DEFAULT_SSL_CIPHER_LIST`` variable. - -Module Variables ----------------- - -:var DEFAULT_SSL_CIPHER_LIST: The list of supported SSL/TLS cipher suites. - -.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication -.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit) - -''' - -try: - from ndg.httpsclient.ssl_peer_verification import SUBJ_ALT_NAME_SUPPORT - from ndg.httpsclient.subj_alt_name import SubjectAltName as BaseSubjectAltName -except SyntaxError as e: - raise ImportError(e) - -import OpenSSL.SSL -from pyasn1.codec.der import decoder as der_decoder -from pyasn1.type import univ, constraint -from socket import _fileobject, timeout -import ssl -import select - -from .. import connection -from .. import util - -__all__ = ['inject_into_urllib3', 'extract_from_urllib3'] - -# SNI only *really* works if we can read the subjectAltName of certificates. -HAS_SNI = SUBJ_ALT_NAME_SUPPORT - -# Map from urllib3 to PyOpenSSL compatible parameter-values. -_openssl_versions = { - ssl.PROTOCOL_SSLv23: OpenSSL.SSL.SSLv23_METHOD, - ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD, -} - -try: - _openssl_versions.update({ssl.PROTOCOL_SSLv3: OpenSSL.SSL.SSLv3_METHOD}) -except AttributeError: - pass - -_openssl_verify = { - ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE, - ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER, - ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER - + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT, -} - -DEFAULT_SSL_CIPHER_LIST = util.ssl_.DEFAULT_CIPHERS - - -orig_util_HAS_SNI = util.HAS_SNI -orig_connection_ssl_wrap_socket = connection.ssl_wrap_socket - - -def inject_into_urllib3(): - 'Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.' - - connection.ssl_wrap_socket = ssl_wrap_socket - util.HAS_SNI = HAS_SNI - - -def extract_from_urllib3(): - 'Undo monkey-patching by :func:`inject_into_urllib3`.' - - connection.ssl_wrap_socket = orig_connection_ssl_wrap_socket - util.HAS_SNI = orig_util_HAS_SNI - - -### Note: This is a slightly bug-fixed version of same from ndg-httpsclient. -class SubjectAltName(BaseSubjectAltName): - '''ASN.1 implementation for subjectAltNames support''' - - # There is no limit to how many SAN certificates a certificate may have, - # however this needs to have some limit so we'll set an arbitrarily high - # limit. - sizeSpec = univ.SequenceOf.sizeSpec + \ - constraint.ValueSizeConstraint(1, 1024) - - -### Note: This is a slightly bug-fixed version of same from ndg-httpsclient. -def get_subj_alt_name(peer_cert): - # Search through extensions - dns_name = [] - if not SUBJ_ALT_NAME_SUPPORT: - return dns_name - - general_names = SubjectAltName() - for i in range(peer_cert.get_extension_count()): - ext = peer_cert.get_extension(i) - ext_name = ext.get_short_name() - if ext_name != 'subjectAltName': - continue - - # PyOpenSSL returns extension data in ASN.1 encoded form - ext_dat = ext.get_data() - decoded_dat = der_decoder.decode(ext_dat, - asn1Spec=general_names) - - for name in decoded_dat: - if not isinstance(name, SubjectAltName): - continue - for entry in range(len(name)): - component = name.getComponentByPosition(entry) - if component.getName() != 'dNSName': - continue - dns_name.append(str(component.getComponent())) - - return dns_name - - -class WrappedSocket(object): - '''API-compatibility wrapper for Python OpenSSL's Connection-class. - - Note: _makefile_refs, _drop() and _reuse() are needed for the garbage - collector of pypy. - ''' - - def __init__(self, connection, socket, suppress_ragged_eofs=True): - self.connection = connection - self.socket = socket - self.suppress_ragged_eofs = suppress_ragged_eofs - self._makefile_refs = 0 - - def fileno(self): - return self.socket.fileno() - - def makefile(self, mode, bufsize=-1): - self._makefile_refs += 1 - return _fileobject(self, mode, bufsize, close=True) - - def recv(self, *args, **kwargs): - try: - data = self.connection.recv(*args, **kwargs) - except OpenSSL.SSL.SysCallError as e: - if self.suppress_ragged_eofs and e.args == (-1, 'Unexpected EOF'): - return b'' - else: - raise - except OpenSSL.SSL.ZeroReturnError as e: - if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: - return b'' - else: - raise - except OpenSSL.SSL.WantReadError: - rd, wd, ed = select.select( - [self.socket], [], [], self.socket.gettimeout()) - if not rd: - raise timeout('The read operation timed out') - else: - return self.recv(*args, **kwargs) - else: - return data - - def settimeout(self, timeout): - return self.socket.settimeout(timeout) - - def _send_until_done(self, data): - while True: - try: - return self.connection.send(data) - except OpenSSL.SSL.WantWriteError: - _, wlist, _ = select.select([], [self.socket], [], - self.socket.gettimeout()) - if not wlist: - raise timeout() - continue - - def sendall(self, data): - while len(data): - sent = self._send_until_done(data) - data = data[sent:] - - def close(self): - if self._makefile_refs < 1: - return self.connection.shutdown() - else: - self._makefile_refs -= 1 - - def getpeercert(self, binary_form=False): - x509 = self.connection.get_peer_certificate() - - if not x509: - return x509 - - if binary_form: - return OpenSSL.crypto.dump_certificate( - OpenSSL.crypto.FILETYPE_ASN1, - x509) - - return { - 'subject': ( - (('commonName', x509.get_subject().CN),), - ), - 'subjectAltName': [ - ('DNS', value) - for value in get_subj_alt_name(x509) - ] - } - - def _reuse(self): - self._makefile_refs += 1 - - def _drop(self): - if self._makefile_refs < 1: - self.close() - else: - self._makefile_refs -= 1 - - -def _verify_callback(cnx, x509, err_no, err_depth, return_code): - return err_no == 0 - - -def ssl_wrap_socket(sock, keyfile=None, certfile=None, cert_reqs=None, - ca_certs=None, server_hostname=None, - ssl_version=None): - ctx = OpenSSL.SSL.Context(_openssl_versions[ssl_version]) - if certfile: - keyfile = keyfile or certfile # Match behaviour of the normal python ssl library - ctx.use_certificate_file(certfile) - if keyfile: - ctx.use_privatekey_file(keyfile) - if cert_reqs != ssl.CERT_NONE: - ctx.set_verify(_openssl_verify[cert_reqs], _verify_callback) - if ca_certs: - try: - ctx.load_verify_locations(ca_certs, None) - except OpenSSL.SSL.Error as e: - raise ssl.SSLError('bad ca_certs: %r' % ca_certs, e) - else: - ctx.set_default_verify_paths() - - # Disable TLS compression to migitate CRIME attack (issue #309) - OP_NO_COMPRESSION = 0x20000 - ctx.set_options(OP_NO_COMPRESSION) - - # Set list of supported ciphersuites. - ctx.set_cipher_list(DEFAULT_SSL_CIPHER_LIST) - - cnx = OpenSSL.SSL.Connection(ctx, sock) - cnx.set_tlsext_host_name(server_hostname) - cnx.set_connect_state() - while True: - try: - cnx.do_handshake() - except OpenSSL.SSL.WantReadError: - rd, _, _ = select.select([sock], [], [], sock.gettimeout()) - if not rd: - raise timeout('select timed out') - continue - except OpenSSL.SSL.Error as e: - raise ssl.SSLError('bad handshake', e) - break - - return WrappedSocket(cnx, sock) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/exceptions.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/exceptions.py deleted file mode 100644 index 31bda1c0..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/exceptions.py +++ /dev/null @@ -1,169 +0,0 @@ - -## Base Exceptions - -class HTTPError(Exception): - "Base exception used by this module." - pass - -class HTTPWarning(Warning): - "Base warning used by this module." - pass - - - -class PoolError(HTTPError): - "Base exception for errors caused within a pool." - def __init__(self, pool, message): - self.pool = pool - HTTPError.__init__(self, "%s: %s" % (pool, message)) - - def __reduce__(self): - # For pickling purposes. - return self.__class__, (None, None) - - -class RequestError(PoolError): - "Base exception for PoolErrors that have associated URLs." - def __init__(self, pool, url, message): - self.url = url - PoolError.__init__(self, pool, message) - - def __reduce__(self): - # For pickling purposes. - return self.__class__, (None, self.url, None) - - -class SSLError(HTTPError): - "Raised when SSL certificate fails in an HTTPS connection." - pass - - -class ProxyError(HTTPError): - "Raised when the connection to a proxy fails." - pass - - -class DecodeError(HTTPError): - "Raised when automatic decoding based on Content-Type fails." - pass - - -class ProtocolError(HTTPError): - "Raised when something unexpected happens mid-request/response." - pass - - -#: Renamed to ProtocolError but aliased for backwards compatibility. -ConnectionError = ProtocolError - - -## Leaf Exceptions - -class MaxRetryError(RequestError): - """Raised when the maximum number of retries is exceeded. - - :param pool: The connection pool - :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool` - :param string url: The requested Url - :param exceptions.Exception reason: The underlying error - - """ - - def __init__(self, pool, url, reason=None): - self.reason = reason - - message = "Max retries exceeded with url: %s (Caused by %r)" % ( - url, reason) - - RequestError.__init__(self, pool, url, message) - - -class HostChangedError(RequestError): - "Raised when an existing pool gets a request for a foreign host." - - def __init__(self, pool, url, retries=3): - message = "Tried to open a foreign host with url: %s" % url - RequestError.__init__(self, pool, url, message) - self.retries = retries - - -class TimeoutStateError(HTTPError): - """ Raised when passing an invalid state to a timeout """ - pass - - -class TimeoutError(HTTPError): - """ Raised when a socket timeout error occurs. - - Catching this error will catch both :exc:`ReadTimeoutErrors - ` and :exc:`ConnectTimeoutErrors `. - """ - pass - - -class ReadTimeoutError(TimeoutError, RequestError): - "Raised when a socket timeout occurs while receiving data from a server" - pass - - -# This timeout error does not have a URL attached and needs to inherit from the -# base HTTPError -class ConnectTimeoutError(TimeoutError): - "Raised when a socket timeout occurs while connecting to a server" - pass - - -class EmptyPoolError(PoolError): - "Raised when a pool runs out of connections and no more are allowed." - pass - - -class ClosedPoolError(PoolError): - "Raised when a request enters a pool after the pool has been closed." - pass - - -class LocationValueError(ValueError, HTTPError): - "Raised when there is something wrong with a given URL input." - pass - - -class LocationParseError(LocationValueError): - "Raised when get_host or similar fails to parse the URL input." - - def __init__(self, location): - message = "Failed to parse: %s" % location - HTTPError.__init__(self, message) - - self.location = location - - -class ResponseError(HTTPError): - "Used as a container for an error reason supplied in a MaxRetryError." - GENERIC_ERROR = 'too many error responses' - SPECIFIC_ERROR = 'too many {status_code} error responses' - - -class SecurityWarning(HTTPWarning): - "Warned when perfoming security reducing actions" - pass - - -class InsecureRequestWarning(SecurityWarning): - "Warned when making an unverified HTTPS request." - pass - - -class SystemTimeWarning(SecurityWarning): - "Warned when system time is suspected to be wrong" - pass - - -class InsecurePlatformWarning(SecurityWarning): - "Warned when certain SSL configuration is not available on a platform." - pass - - -class ResponseNotChunked(ProtocolError, ValueError): - "Response needs to be chunked in order to read it as chunks." - pass diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/fields.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/fields.py deleted file mode 100644 index c853f8d5..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/fields.py +++ /dev/null @@ -1,177 +0,0 @@ -import email.utils -import mimetypes - -from .packages import six - - -def guess_content_type(filename, default='application/octet-stream'): - """ - Guess the "Content-Type" of a file. - - :param filename: - The filename to guess the "Content-Type" of using :mod:`mimetypes`. - :param default: - If no "Content-Type" can be guessed, default to `default`. - """ - if filename: - return mimetypes.guess_type(filename)[0] or default - return default - - -def format_header_param(name, value): - """ - Helper function to format and quote a single header parameter. - - Particularly useful for header parameters which might contain - non-ASCII values, like file names. This follows RFC 2231, as - suggested by RFC 2388 Section 4.4. - - :param name: - The name of the parameter, a string expected to be ASCII only. - :param value: - The value of the parameter, provided as a unicode string. - """ - if not any(ch in value for ch in '"\\\r\n'): - result = '%s="%s"' % (name, value) - try: - result.encode('ascii') - except UnicodeEncodeError: - pass - else: - return result - if not six.PY3: # Python 2: - value = value.encode('utf-8') - value = email.utils.encode_rfc2231(value, 'utf-8') - value = '%s*=%s' % (name, value) - return value - - -class RequestField(object): - """ - A data container for request body parameters. - - :param name: - The name of this request field. - :param data: - The data/value body. - :param filename: - An optional filename of the request field. - :param headers: - An optional dict-like object of headers to initially use for the field. - """ - def __init__(self, name, data, filename=None, headers=None): - self._name = name - self._filename = filename - self.data = data - self.headers = {} - if headers: - self.headers = dict(headers) - - @classmethod - def from_tuples(cls, fieldname, value): - """ - A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters. - - Supports constructing :class:`~urllib3.fields.RequestField` from - parameter of key/value strings AND key/filetuple. A filetuple is a - (filename, data, MIME type) tuple where the MIME type is optional. - For example:: - - 'foo': 'bar', - 'fakefile': ('foofile.txt', 'contents of foofile'), - 'realfile': ('barfile.txt', open('realfile').read()), - 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'), - 'nonamefile': 'contents of nonamefile field', - - Field names and filenames must be unicode. - """ - if isinstance(value, tuple): - if len(value) == 3: - filename, data, content_type = value - else: - filename, data = value - content_type = guess_content_type(filename) - else: - filename = None - content_type = None - data = value - - request_param = cls(fieldname, data, filename=filename) - request_param.make_multipart(content_type=content_type) - - return request_param - - def _render_part(self, name, value): - """ - Overridable helper function to format a single header parameter. - - :param name: - The name of the parameter, a string expected to be ASCII only. - :param value: - The value of the parameter, provided as a unicode string. - """ - return format_header_param(name, value) - - def _render_parts(self, header_parts): - """ - Helper function to format and quote a single header. - - Useful for single headers that are composed of multiple items. E.g., - 'Content-Disposition' fields. - - :param header_parts: - A sequence of (k, v) typles or a :class:`dict` of (k, v) to format - as `k1="v1"; k2="v2"; ...`. - """ - parts = [] - iterable = header_parts - if isinstance(header_parts, dict): - iterable = header_parts.items() - - for name, value in iterable: - if value: - parts.append(self._render_part(name, value)) - - return '; '.join(parts) - - def render_headers(self): - """ - Renders the headers for this request field. - """ - lines = [] - - sort_keys = ['Content-Disposition', 'Content-Type', 'Content-Location'] - for sort_key in sort_keys: - if self.headers.get(sort_key, False): - lines.append('%s: %s' % (sort_key, self.headers[sort_key])) - - for header_name, header_value in self.headers.items(): - if header_name not in sort_keys: - if header_value: - lines.append('%s: %s' % (header_name, header_value)) - - lines.append('\r\n') - return '\r\n'.join(lines) - - def make_multipart(self, content_disposition=None, content_type=None, - content_location=None): - """ - Makes this request field into a multipart request field. - - This method overrides "Content-Disposition", "Content-Type" and - "Content-Location" headers to the request parameter. - - :param content_type: - The 'Content-Type' of the request body. - :param content_location: - The 'Content-Location' of the request body. - - """ - self.headers['Content-Disposition'] = content_disposition or 'form-data' - self.headers['Content-Disposition'] += '; '.join([ - '', self._render_parts( - (('name', self._name), ('filename', self._filename)) - ) - ]) - self.headers['Content-Type'] = content_type - self.headers['Content-Location'] = content_location diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/filepost.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/filepost.py deleted file mode 100644 index 0fbf488d..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/filepost.py +++ /dev/null @@ -1,93 +0,0 @@ -import codecs - -from uuid import uuid4 -from io import BytesIO - -from .packages import six -from .packages.six import b -from .fields import RequestField - -writer = codecs.lookup('utf-8')[3] - - -def choose_boundary(): - """ - Our embarassingly-simple replacement for mimetools.choose_boundary. - """ - return uuid4().hex - - -def iter_field_objects(fields): - """ - Iterate over fields. - - Supports list of (k, v) tuples and dicts, and lists of - :class:`~urllib3.fields.RequestField`. - - """ - if isinstance(fields, dict): - i = six.iteritems(fields) - else: - i = iter(fields) - - for field in i: - if isinstance(field, RequestField): - yield field - else: - yield RequestField.from_tuples(*field) - - -def iter_fields(fields): - """ - .. deprecated:: 1.6 - - Iterate over fields. - - The addition of :class:`~urllib3.fields.RequestField` makes this function - obsolete. Instead, use :func:`iter_field_objects`, which returns - :class:`~urllib3.fields.RequestField` objects. - - Supports list of (k, v) tuples and dicts. - """ - if isinstance(fields, dict): - return ((k, v) for k, v in six.iteritems(fields)) - - return ((k, v) for k, v in fields) - - -def encode_multipart_formdata(fields, boundary=None): - """ - Encode a dictionary of ``fields`` using the multipart/form-data MIME format. - - :param fields: - Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`). - - :param boundary: - If not specified, then a random boundary will be generated using - :func:`mimetools.choose_boundary`. - """ - body = BytesIO() - if boundary is None: - boundary = choose_boundary() - - for field in iter_field_objects(fields): - body.write(b('--%s\r\n' % (boundary))) - - writer(body).write(field.render_headers()) - data = field.data - - if isinstance(data, int): - data = str(data) # Backwards compatibility - - if isinstance(data, six.text_type): - writer(body).write(data) - else: - body.write(data) - - body.write(b'\r\n') - - body.write(b('--%s--\r\n' % (boundary))) - - content_type = str('multipart/form-data; boundary=%s' % boundary) - - return body.getvalue(), content_type diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/__init__.py deleted file mode 100644 index 37e83515..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/__init__.py +++ /dev/null @@ -1,4 +0,0 @@ -from __future__ import absolute_import - -from . import ssl_match_hostname - diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ordered_dict.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ordered_dict.py deleted file mode 100644 index 4479363c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ordered_dict.py +++ /dev/null @@ -1,259 +0,0 @@ -# Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy. -# Passes Python2.7's test suite and incorporates all the latest updates. -# Copyright 2009 Raymond Hettinger, released under the MIT License. -# http://code.activestate.com/recipes/576693/ -try: - from thread import get_ident as _get_ident -except ImportError: - from dummy_thread import get_ident as _get_ident - -try: - from _abcoll import KeysView, ValuesView, ItemsView -except ImportError: - pass - - -class OrderedDict(dict): - 'Dictionary that remembers insertion order' - # An inherited dict maps keys to values. - # The inherited dict provides __getitem__, __len__, __contains__, and get. - # The remaining methods are order-aware. - # Big-O running times for all methods are the same as for regular dictionaries. - - # The internal self.__map dictionary maps keys to links in a doubly linked list. - # The circular doubly linked list starts and ends with a sentinel element. - # The sentinel element never gets deleted (this simplifies the algorithm). - # Each link is stored as a list of length three: [PREV, NEXT, KEY]. - - def __init__(self, *args, **kwds): - '''Initialize an ordered dictionary. Signature is the same as for - regular dictionaries, but keyword arguments are not recommended - because their insertion order is arbitrary. - - ''' - if len(args) > 1: - raise TypeError('expected at most 1 arguments, got %d' % len(args)) - try: - self.__root - except AttributeError: - self.__root = root = [] # sentinel node - root[:] = [root, root, None] - self.__map = {} - self.__update(*args, **kwds) - - def __setitem__(self, key, value, dict_setitem=dict.__setitem__): - 'od.__setitem__(i, y) <==> od[i]=y' - # Setting a new item creates a new link which goes at the end of the linked - # list, and the inherited dictionary is updated with the new key/value pair. - if key not in self: - root = self.__root - last = root[0] - last[1] = root[0] = self.__map[key] = [last, root, key] - dict_setitem(self, key, value) - - def __delitem__(self, key, dict_delitem=dict.__delitem__): - 'od.__delitem__(y) <==> del od[y]' - # Deleting an existing item uses self.__map to find the link which is - # then removed by updating the links in the predecessor and successor nodes. - dict_delitem(self, key) - link_prev, link_next, key = self.__map.pop(key) - link_prev[1] = link_next - link_next[0] = link_prev - - def __iter__(self): - 'od.__iter__() <==> iter(od)' - root = self.__root - curr = root[1] - while curr is not root: - yield curr[2] - curr = curr[1] - - def __reversed__(self): - 'od.__reversed__() <==> reversed(od)' - root = self.__root - curr = root[0] - while curr is not root: - yield curr[2] - curr = curr[0] - - def clear(self): - 'od.clear() -> None. Remove all items from od.' - try: - for node in self.__map.itervalues(): - del node[:] - root = self.__root - root[:] = [root, root, None] - self.__map.clear() - except AttributeError: - pass - dict.clear(self) - - def popitem(self, last=True): - '''od.popitem() -> (k, v), return and remove a (key, value) pair. - Pairs are returned in LIFO order if last is true or FIFO order if false. - - ''' - if not self: - raise KeyError('dictionary is empty') - root = self.__root - if last: - link = root[0] - link_prev = link[0] - link_prev[1] = root - root[0] = link_prev - else: - link = root[1] - link_next = link[1] - root[1] = link_next - link_next[0] = root - key = link[2] - del self.__map[key] - value = dict.pop(self, key) - return key, value - - # -- the following methods do not depend on the internal structure -- - - def keys(self): - 'od.keys() -> list of keys in od' - return list(self) - - def values(self): - 'od.values() -> list of values in od' - return [self[key] for key in self] - - def items(self): - 'od.items() -> list of (key, value) pairs in od' - return [(key, self[key]) for key in self] - - def iterkeys(self): - 'od.iterkeys() -> an iterator over the keys in od' - return iter(self) - - def itervalues(self): - 'od.itervalues -> an iterator over the values in od' - for k in self: - yield self[k] - - def iteritems(self): - 'od.iteritems -> an iterator over the (key, value) items in od' - for k in self: - yield (k, self[k]) - - def update(*args, **kwds): - '''od.update(E, **F) -> None. Update od from dict/iterable E and F. - - If E is a dict instance, does: for k in E: od[k] = E[k] - If E has a .keys() method, does: for k in E.keys(): od[k] = E[k] - Or if E is an iterable of items, does: for k, v in E: od[k] = v - In either case, this is followed by: for k, v in F.items(): od[k] = v - - ''' - if len(args) > 2: - raise TypeError('update() takes at most 2 positional ' - 'arguments (%d given)' % (len(args),)) - elif not args: - raise TypeError('update() takes at least 1 argument (0 given)') - self = args[0] - # Make progressively weaker assumptions about "other" - other = () - if len(args) == 2: - other = args[1] - if isinstance(other, dict): - for key in other: - self[key] = other[key] - elif hasattr(other, 'keys'): - for key in other.keys(): - self[key] = other[key] - else: - for key, value in other: - self[key] = value - for key, value in kwds.items(): - self[key] = value - - __update = update # let subclasses override update without breaking __init__ - - __marker = object() - - def pop(self, key, default=__marker): - '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value. - If key is not found, d is returned if given, otherwise KeyError is raised. - - ''' - if key in self: - result = self[key] - del self[key] - return result - if default is self.__marker: - raise KeyError(key) - return default - - def setdefault(self, key, default=None): - 'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od' - if key in self: - return self[key] - self[key] = default - return default - - def __repr__(self, _repr_running={}): - 'od.__repr__() <==> repr(od)' - call_key = id(self), _get_ident() - if call_key in _repr_running: - return '...' - _repr_running[call_key] = 1 - try: - if not self: - return '%s()' % (self.__class__.__name__,) - return '%s(%r)' % (self.__class__.__name__, self.items()) - finally: - del _repr_running[call_key] - - def __reduce__(self): - 'Return state information for pickling' - items = [[k, self[k]] for k in self] - inst_dict = vars(self).copy() - for k in vars(OrderedDict()): - inst_dict.pop(k, None) - if inst_dict: - return (self.__class__, (items,), inst_dict) - return self.__class__, (items,) - - def copy(self): - 'od.copy() -> a shallow copy of od' - return self.__class__(self) - - @classmethod - def fromkeys(cls, iterable, value=None): - '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S - and values equal to v (which defaults to None). - - ''' - d = cls() - for key in iterable: - d[key] = value - return d - - def __eq__(self, other): - '''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive - while comparison to a regular mapping is order-insensitive. - - ''' - if isinstance(other, OrderedDict): - return len(self)==len(other) and self.items() == other.items() - return dict.__eq__(self, other) - - def __ne__(self, other): - return not self == other - - # -- the following methods are only used in Python 2.7 -- - - def viewkeys(self): - "od.viewkeys() -> a set-like object providing a view on od's keys" - return KeysView(self) - - def viewvalues(self): - "od.viewvalues() -> an object providing a view on od's values" - return ValuesView(self) - - def viewitems(self): - "od.viewitems() -> a set-like object providing a view on od's items" - return ItemsView(self) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/six.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/six.py deleted file mode 100644 index 27d80112..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/six.py +++ /dev/null @@ -1,385 +0,0 @@ -"""Utilities for writing code that runs on Python 2 and 3""" - -#Copyright (c) 2010-2011 Benjamin Peterson - -#Permission is hereby granted, free of charge, to any person obtaining a copy of -#this software and associated documentation files (the "Software"), to deal in -#the Software without restriction, including without limitation the rights to -#use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of -#the Software, and to permit persons to whom the Software is furnished to do so, -#subject to the following conditions: - -#The above copyright notice and this permission notice shall be included in all -#copies or substantial portions of the Software. - -#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -#IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS -#FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR -#COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER -#IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN -#CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -import operator -import sys -import types - -__author__ = "Benjamin Peterson " -__version__ = "1.2.0" # Revision 41c74fef2ded - - -# True if we are running on Python 3. -PY3 = sys.version_info[0] == 3 - -if PY3: - string_types = str, - integer_types = int, - class_types = type, - text_type = str - binary_type = bytes - - MAXSIZE = sys.maxsize -else: - string_types = basestring, - integer_types = (int, long) - class_types = (type, types.ClassType) - text_type = unicode - binary_type = str - - if sys.platform.startswith("java"): - # Jython always uses 32 bits. - MAXSIZE = int((1 << 31) - 1) - else: - # It's possible to have sizeof(long) != sizeof(Py_ssize_t). - class X(object): - def __len__(self): - return 1 << 31 - try: - len(X()) - except OverflowError: - # 32-bit - MAXSIZE = int((1 << 31) - 1) - else: - # 64-bit - MAXSIZE = int((1 << 63) - 1) - del X - - -def _add_doc(func, doc): - """Add documentation to a function.""" - func.__doc__ = doc - - -def _import_module(name): - """Import module, returning the module after the last dot.""" - __import__(name) - return sys.modules[name] - - -class _LazyDescr(object): - - def __init__(self, name): - self.name = name - - def __get__(self, obj, tp): - result = self._resolve() - setattr(obj, self.name, result) - # This is a bit ugly, but it avoids running this again. - delattr(tp, self.name) - return result - - -class MovedModule(_LazyDescr): - - def __init__(self, name, old, new=None): - super(MovedModule, self).__init__(name) - if PY3: - if new is None: - new = name - self.mod = new - else: - self.mod = old - - def _resolve(self): - return _import_module(self.mod) - - -class MovedAttribute(_LazyDescr): - - def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): - super(MovedAttribute, self).__init__(name) - if PY3: - if new_mod is None: - new_mod = name - self.mod = new_mod - if new_attr is None: - if old_attr is None: - new_attr = name - else: - new_attr = old_attr - self.attr = new_attr - else: - self.mod = old_mod - if old_attr is None: - old_attr = name - self.attr = old_attr - - def _resolve(self): - module = _import_module(self.mod) - return getattr(module, self.attr) - - - -class _MovedItems(types.ModuleType): - """Lazy loading of moved objects""" - - -_moved_attributes = [ - MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), - MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), - MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), - MovedAttribute("map", "itertools", "builtins", "imap", "map"), - MovedAttribute("reload_module", "__builtin__", "imp", "reload"), - MovedAttribute("reduce", "__builtin__", "functools"), - MovedAttribute("StringIO", "StringIO", "io"), - MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), - MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), - - MovedModule("builtins", "__builtin__"), - MovedModule("configparser", "ConfigParser"), - MovedModule("copyreg", "copy_reg"), - MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), - MovedModule("http_cookies", "Cookie", "http.cookies"), - MovedModule("html_entities", "htmlentitydefs", "html.entities"), - MovedModule("html_parser", "HTMLParser", "html.parser"), - MovedModule("http_client", "httplib", "http.client"), - MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), - MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), - MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), - MovedModule("cPickle", "cPickle", "pickle"), - MovedModule("queue", "Queue"), - MovedModule("reprlib", "repr"), - MovedModule("socketserver", "SocketServer"), - MovedModule("tkinter", "Tkinter"), - MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), - MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), - MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), - MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), - MovedModule("tkinter_tix", "Tix", "tkinter.tix"), - MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), - MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), - MovedModule("tkinter_colorchooser", "tkColorChooser", - "tkinter.colorchooser"), - MovedModule("tkinter_commondialog", "tkCommonDialog", - "tkinter.commondialog"), - MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), - MovedModule("tkinter_font", "tkFont", "tkinter.font"), - MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), - MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", - "tkinter.simpledialog"), - MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), - MovedModule("winreg", "_winreg"), -] -for attr in _moved_attributes: - setattr(_MovedItems, attr.name, attr) -del attr - -moves = sys.modules[__name__ + ".moves"] = _MovedItems("moves") - - -def add_move(move): - """Add an item to six.moves.""" - setattr(_MovedItems, move.name, move) - - -def remove_move(name): - """Remove item from six.moves.""" - try: - delattr(_MovedItems, name) - except AttributeError: - try: - del moves.__dict__[name] - except KeyError: - raise AttributeError("no such move, %r" % (name,)) - - -if PY3: - _meth_func = "__func__" - _meth_self = "__self__" - - _func_code = "__code__" - _func_defaults = "__defaults__" - - _iterkeys = "keys" - _itervalues = "values" - _iteritems = "items" -else: - _meth_func = "im_func" - _meth_self = "im_self" - - _func_code = "func_code" - _func_defaults = "func_defaults" - - _iterkeys = "iterkeys" - _itervalues = "itervalues" - _iteritems = "iteritems" - - -try: - advance_iterator = next -except NameError: - def advance_iterator(it): - return it.next() -next = advance_iterator - - -if PY3: - def get_unbound_function(unbound): - return unbound - - Iterator = object - - def callable(obj): - return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) -else: - def get_unbound_function(unbound): - return unbound.im_func - - class Iterator(object): - - def next(self): - return type(self).__next__(self) - - callable = callable -_add_doc(get_unbound_function, - """Get the function out of a possibly unbound function""") - - -get_method_function = operator.attrgetter(_meth_func) -get_method_self = operator.attrgetter(_meth_self) -get_function_code = operator.attrgetter(_func_code) -get_function_defaults = operator.attrgetter(_func_defaults) - - -def iterkeys(d): - """Return an iterator over the keys of a dictionary.""" - return iter(getattr(d, _iterkeys)()) - -def itervalues(d): - """Return an iterator over the values of a dictionary.""" - return iter(getattr(d, _itervalues)()) - -def iteritems(d): - """Return an iterator over the (key, value) pairs of a dictionary.""" - return iter(getattr(d, _iteritems)()) - - -if PY3: - def b(s): - return s.encode("latin-1") - def u(s): - return s - if sys.version_info[1] <= 1: - def int2byte(i): - return bytes((i,)) - else: - # This is about 2x faster than the implementation above on 3.2+ - int2byte = operator.methodcaller("to_bytes", 1, "big") - import io - StringIO = io.StringIO - BytesIO = io.BytesIO -else: - def b(s): - return s - def u(s): - return unicode(s, "unicode_escape") - int2byte = chr - import StringIO - StringIO = BytesIO = StringIO.StringIO -_add_doc(b, """Byte literal""") -_add_doc(u, """Text literal""") - - -if PY3: - import builtins - exec_ = getattr(builtins, "exec") - - - def reraise(tp, value, tb=None): - if value.__traceback__ is not tb: - raise value.with_traceback(tb) - raise value - - - print_ = getattr(builtins, "print") - del builtins - -else: - def exec_(code, globs=None, locs=None): - """Execute code in a namespace.""" - if globs is None: - frame = sys._getframe(1) - globs = frame.f_globals - if locs is None: - locs = frame.f_locals - del frame - elif locs is None: - locs = globs - exec("""exec code in globs, locs""") - - - exec_("""def reraise(tp, value, tb=None): - raise tp, value, tb -""") - - - def print_(*args, **kwargs): - """The new-style print function.""" - fp = kwargs.pop("file", sys.stdout) - if fp is None: - return - def write(data): - if not isinstance(data, basestring): - data = str(data) - fp.write(data) - want_unicode = False - sep = kwargs.pop("sep", None) - if sep is not None: - if isinstance(sep, unicode): - want_unicode = True - elif not isinstance(sep, str): - raise TypeError("sep must be None or a string") - end = kwargs.pop("end", None) - if end is not None: - if isinstance(end, unicode): - want_unicode = True - elif not isinstance(end, str): - raise TypeError("end must be None or a string") - if kwargs: - raise TypeError("invalid keyword arguments to print()") - if not want_unicode: - for arg in args: - if isinstance(arg, unicode): - want_unicode = True - break - if want_unicode: - newline = unicode("\n") - space = unicode(" ") - else: - newline = "\n" - space = " " - if sep is None: - sep = space - if end is None: - end = newline - for i, arg in enumerate(args): - if i: - write(sep) - write(arg) - write(end) - -_add_doc(reraise, """Reraise an exception.""") - - -def with_metaclass(meta, base=object): - """Create a base class with a metaclass.""" - return meta("NewBase", (base,), {}) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.py deleted file mode 100644 index dd59a75f..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -try: - # Python 3.2+ - from ssl import CertificateError, match_hostname -except ImportError: - try: - # Backport of the function from a pypi module - from backports.ssl_match_hostname import CertificateError, match_hostname - except ImportError: - # Our vendored copy - from ._implementation import CertificateError, match_hostname - -# Not needed, but documenting what we provide. -__all__ = ('CertificateError', 'match_hostname') diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.py deleted file mode 100644 index 52f42873..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.py +++ /dev/null @@ -1,105 +0,0 @@ -"""The match_hostname() function from Python 3.3.3, essential when using SSL.""" - -# Note: This file is under the PSF license as the code comes from the python -# stdlib. http://docs.python.org/3/license.html - -import re - -__version__ = '3.4.0.2' - -class CertificateError(ValueError): - pass - - -def _dnsname_match(dn, hostname, max_wildcards=1): - """Matching according to RFC 6125, section 6.4.3 - - http://tools.ietf.org/html/rfc6125#section-6.4.3 - """ - pats = [] - if not dn: - return False - - # Ported from python3-syntax: - # leftmost, *remainder = dn.split(r'.') - parts = dn.split(r'.') - leftmost = parts[0] - remainder = parts[1:] - - wildcards = leftmost.count('*') - if wildcards > max_wildcards: - # Issue #17980: avoid denials of service by refusing more - # than one wildcard per fragment. A survey of established - # policy among SSL implementations showed it to be a - # reasonable choice. - raise CertificateError( - "too many wildcards in certificate DNS name: " + repr(dn)) - - # speed up common case w/o wildcards - if not wildcards: - return dn.lower() == hostname.lower() - - # RFC 6125, section 6.4.3, subitem 1. - # The client SHOULD NOT attempt to match a presented identifier in which - # the wildcard character comprises a label other than the left-most label. - if leftmost == '*': - # When '*' is a fragment by itself, it matches a non-empty dotless - # fragment. - pats.append('[^.]+') - elif leftmost.startswith('xn--') or hostname.startswith('xn--'): - # RFC 6125, section 6.4.3, subitem 3. - # The client SHOULD NOT attempt to match a presented identifier - # where the wildcard character is embedded within an A-label or - # U-label of an internationalized domain name. - pats.append(re.escape(leftmost)) - else: - # Otherwise, '*' matches any dotless string, e.g. www* - pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) - - # add the remaining fragments, ignore any wildcards - for frag in remainder: - pats.append(re.escape(frag)) - - pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) - return pat.match(hostname) - - -def match_hostname(cert, hostname): - """Verify that *cert* (in decoded format as returned by - SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 - rules are followed, but IP addresses are not accepted for *hostname*. - - CertificateError is raised on failure. On success, the function - returns nothing. - """ - if not cert: - raise ValueError("empty or no certificate") - dnsnames = [] - san = cert.get('subjectAltName', ()) - for key, value in san: - if key == 'DNS': - if _dnsname_match(value, hostname): - return - dnsnames.append(value) - if not dnsnames: - # The subject is only checked when there is no dNSName entry - # in subjectAltName - for sub in cert.get('subject', ()): - for key, value in sub: - # XXX according to RFC 2818, the most specific Common Name - # must be used. - if key == 'commonName': - if _dnsname_match(value, hostname): - return - dnsnames.append(value) - if len(dnsnames) > 1: - raise CertificateError("hostname %r " - "doesn't match either of %s" - % (hostname, ', '.join(map(repr, dnsnames)))) - elif len(dnsnames) == 1: - raise CertificateError("hostname %r " - "doesn't match %r" - % (hostname, dnsnames[0])) - else: - raise CertificateError("no appropriate commonName or " - "subjectAltName fields were found") diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/poolmanager.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/poolmanager.py deleted file mode 100644 index b8d1e745..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/poolmanager.py +++ /dev/null @@ -1,280 +0,0 @@ -import logging - -try: # Python 3 - from urllib.parse import urljoin -except ImportError: - from urlparse import urljoin - -from ._collections import RecentlyUsedContainer -from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool -from .connectionpool import port_by_scheme -from .exceptions import LocationValueError, MaxRetryError -from .request import RequestMethods -from .util.url import parse_url -from .util.retry import Retry - - -__all__ = ['PoolManager', 'ProxyManager', 'proxy_from_url'] - - -pool_classes_by_scheme = { - 'http': HTTPConnectionPool, - 'https': HTTPSConnectionPool, -} - -log = logging.getLogger(__name__) - -SSL_KEYWORDS = ('key_file', 'cert_file', 'cert_reqs', 'ca_certs', - 'ssl_version') - - -class PoolManager(RequestMethods): - """ - Allows for arbitrary requests while transparently keeping track of - necessary connection pools for you. - - :param num_pools: - Number of connection pools to cache before discarding the least - recently used pool. - - :param headers: - Headers to include with all requests, unless other headers are given - explicitly. - - :param \**connection_pool_kw: - Additional parameters are used to create fresh - :class:`urllib3.connectionpool.ConnectionPool` instances. - - Example:: - - >>> manager = PoolManager(num_pools=2) - >>> r = manager.request('GET', 'http://google.com/') - >>> r = manager.request('GET', 'http://google.com/mail') - >>> r = manager.request('GET', 'http://yahoo.com/') - >>> len(manager.pools) - 2 - - """ - - proxy = None - - def __init__(self, num_pools=10, headers=None, **connection_pool_kw): - RequestMethods.__init__(self, headers) - self.connection_pool_kw = connection_pool_kw - self.pools = RecentlyUsedContainer(num_pools, - dispose_func=lambda p: p.close()) - - def __enter__(self): - return self - - def __exit__(self, exc_type, exc_val, exc_tb): - self.clear() - # Return False to re-raise any potential exceptions - return False - - def _new_pool(self, scheme, host, port): - """ - Create a new :class:`ConnectionPool` based on host, port and scheme. - - This method is used to actually create the connection pools handed out - by :meth:`connection_from_url` and companion methods. It is intended - to be overridden for customization. - """ - pool_cls = pool_classes_by_scheme[scheme] - kwargs = self.connection_pool_kw - if scheme == 'http': - kwargs = self.connection_pool_kw.copy() - for kw in SSL_KEYWORDS: - kwargs.pop(kw, None) - - return pool_cls(host, port, **kwargs) - - def clear(self): - """ - Empty our store of pools and direct them all to close. - - This will not affect in-flight connections, but they will not be - re-used after completion. - """ - self.pools.clear() - - def connection_from_host(self, host, port=None, scheme='http'): - """ - Get a :class:`ConnectionPool` based on the host, port, and scheme. - - If ``port`` isn't given, it will be derived from the ``scheme`` using - ``urllib3.connectionpool.port_by_scheme``. - """ - - if not host: - raise LocationValueError("No host specified.") - - scheme = scheme or 'http' - port = port or port_by_scheme.get(scheme, 80) - pool_key = (scheme, host, port) - - with self.pools.lock: - # If the scheme, host, or port doesn't match existing open - # connections, open a new ConnectionPool. - pool = self.pools.get(pool_key) - if pool: - return pool - - # Make a fresh ConnectionPool of the desired type - pool = self._new_pool(scheme, host, port) - self.pools[pool_key] = pool - - return pool - - def connection_from_url(self, url): - """ - Similar to :func:`urllib3.connectionpool.connection_from_url` but - doesn't pass any additional parameters to the - :class:`urllib3.connectionpool.ConnectionPool` constructor. - - Additional parameters are taken from the :class:`.PoolManager` - constructor. - """ - u = parse_url(url) - return self.connection_from_host(u.host, port=u.port, scheme=u.scheme) - - def urlopen(self, method, url, redirect=True, **kw): - """ - Same as :meth:`urllib3.connectionpool.HTTPConnectionPool.urlopen` - with custom cross-host redirect logic and only sends the request-uri - portion of the ``url``. - - The given ``url`` parameter must be absolute, such that an appropriate - :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it. - """ - u = parse_url(url) - conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme) - - kw['assert_same_host'] = False - kw['redirect'] = False - if 'headers' not in kw: - kw['headers'] = self.headers - - if self.proxy is not None and u.scheme == "http": - response = conn.urlopen(method, url, **kw) - else: - response = conn.urlopen(method, u.request_uri, **kw) - - redirect_location = redirect and response.get_redirect_location() - if not redirect_location: - return response - - # Support relative URLs for redirecting. - redirect_location = urljoin(url, redirect_location) - - # RFC 7231, Section 6.4.4 - if response.status == 303: - method = 'GET' - - retries = kw.get('retries') - if not isinstance(retries, Retry): - retries = Retry.from_int(retries, redirect=redirect) - - try: - retries = retries.increment(method, url, response=response, _pool=conn) - except MaxRetryError: - if retries.raise_on_redirect: - raise - return response - - kw['retries'] = retries - kw['redirect'] = redirect - - log.info("Redirecting %s -> %s" % (url, redirect_location)) - return self.urlopen(method, redirect_location, **kw) - - -class ProxyManager(PoolManager): - """ - Behaves just like :class:`PoolManager`, but sends all requests through - the defined proxy, using the CONNECT method for HTTPS URLs. - - :param proxy_url: - The URL of the proxy to be used. - - :param proxy_headers: - A dictionary contaning headers that will be sent to the proxy. In case - of HTTP they are being sent with each request, while in the - HTTPS/CONNECT case they are sent only once. Could be used for proxy - authentication. - - Example: - >>> proxy = urllib3.ProxyManager('http://localhost:3128/') - >>> r1 = proxy.request('GET', 'http://google.com/') - >>> r2 = proxy.request('GET', 'http://httpbin.org/') - >>> len(proxy.pools) - 1 - >>> r3 = proxy.request('GET', 'https://httpbin.org/') - >>> r4 = proxy.request('GET', 'https://twitter.com/') - >>> len(proxy.pools) - 3 - - """ - - def __init__(self, proxy_url, num_pools=10, headers=None, - proxy_headers=None, **connection_pool_kw): - - if isinstance(proxy_url, HTTPConnectionPool): - proxy_url = '%s://%s:%i' % (proxy_url.scheme, proxy_url.host, - proxy_url.port) - proxy = parse_url(proxy_url) - if not proxy.port: - port = port_by_scheme.get(proxy.scheme, 80) - proxy = proxy._replace(port=port) - - assert proxy.scheme in ("http", "https"), \ - 'Not supported proxy scheme %s' % proxy.scheme - - self.proxy = proxy - self.proxy_headers = proxy_headers or {} - - connection_pool_kw['_proxy'] = self.proxy - connection_pool_kw['_proxy_headers'] = self.proxy_headers - - super(ProxyManager, self).__init__( - num_pools, headers, **connection_pool_kw) - - def connection_from_host(self, host, port=None, scheme='http'): - if scheme == "https": - return super(ProxyManager, self).connection_from_host( - host, port, scheme) - - return super(ProxyManager, self).connection_from_host( - self.proxy.host, self.proxy.port, self.proxy.scheme) - - def _set_proxy_headers(self, url, headers=None): - """ - Sets headers needed by proxies: specifically, the Accept and Host - headers. Only sets headers not provided by the user. - """ - headers_ = {'Accept': '*/*'} - - netloc = parse_url(url).netloc - if netloc: - headers_['Host'] = netloc - - if headers: - headers_.update(headers) - return headers_ - - def urlopen(self, method, url, redirect=True, **kw): - "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute." - u = parse_url(url) - - if u.scheme == "http": - # For proxied HTTPS requests, httplib sets the necessary headers - # on the CONNECT to the proxy. For HTTP, we'll definitely - # need to set 'Host' at the very least. - headers = kw.get('headers', self.headers) - kw['headers'] = self._set_proxy_headers(url, headers) - - return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw) - - -def proxy_from_url(url, **kw): - return ProxyManager(proxy_url=url, **kw) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/request.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/request.py deleted file mode 100644 index b08d6c92..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/request.py +++ /dev/null @@ -1,141 +0,0 @@ -try: - from urllib.parse import urlencode -except ImportError: - from urllib import urlencode - -from .filepost import encode_multipart_formdata - - -__all__ = ['RequestMethods'] - - -class RequestMethods(object): - """ - Convenience mixin for classes who implement a :meth:`urlopen` method, such - as :class:`~urllib3.connectionpool.HTTPConnectionPool` and - :class:`~urllib3.poolmanager.PoolManager`. - - Provides behavior for making common types of HTTP request methods and - decides which type of request field encoding to use. - - Specifically, - - :meth:`.request_encode_url` is for sending requests whose fields are - encoded in the URL (such as GET, HEAD, DELETE). - - :meth:`.request_encode_body` is for sending requests whose fields are - encoded in the *body* of the request using multipart or www-form-urlencoded - (such as for POST, PUT, PATCH). - - :meth:`.request` is for making any kind of request, it will look up the - appropriate encoding format and use one of the above two methods to make - the request. - - Initializer parameters: - - :param headers: - Headers to include with all requests, unless other headers are given - explicitly. - """ - - _encode_url_methods = set(['DELETE', 'GET', 'HEAD', 'OPTIONS']) - - def __init__(self, headers=None): - self.headers = headers or {} - - def urlopen(self, method, url, body=None, headers=None, - encode_multipart=True, multipart_boundary=None, - **kw): # Abstract - raise NotImplemented("Classes extending RequestMethods must implement " - "their own ``urlopen`` method.") - - def request(self, method, url, fields=None, headers=None, **urlopen_kw): - """ - Make a request using :meth:`urlopen` with the appropriate encoding of - ``fields`` based on the ``method`` used. - - This is a convenience method that requires the least amount of manual - effort. It can be used in most situations, while still having the - option to drop down to more specific methods when necessary, such as - :meth:`request_encode_url`, :meth:`request_encode_body`, - or even the lowest level :meth:`urlopen`. - """ - method = method.upper() - - if method in self._encode_url_methods: - return self.request_encode_url(method, url, fields=fields, - headers=headers, - **urlopen_kw) - else: - return self.request_encode_body(method, url, fields=fields, - headers=headers, - **urlopen_kw) - - def request_encode_url(self, method, url, fields=None, **urlopen_kw): - """ - Make a request using :meth:`urlopen` with the ``fields`` encoded in - the url. This is useful for request methods like GET, HEAD, DELETE, etc. - """ - if fields: - url += '?' + urlencode(fields) - return self.urlopen(method, url, **urlopen_kw) - - def request_encode_body(self, method, url, fields=None, headers=None, - encode_multipart=True, multipart_boundary=None, - **urlopen_kw): - """ - Make a request using :meth:`urlopen` with the ``fields`` encoded in - the body. This is useful for request methods like POST, PUT, PATCH, etc. - - When ``encode_multipart=True`` (default), then - :meth:`urllib3.filepost.encode_multipart_formdata` is used to encode - the payload with the appropriate content type. Otherwise - :meth:`urllib.urlencode` is used with the - 'application/x-www-form-urlencoded' content type. - - Multipart encoding must be used when posting files, and it's reasonably - safe to use it in other times too. However, it may break request - signing, such as with OAuth. - - Supports an optional ``fields`` parameter of key/value strings AND - key/filetuple. A filetuple is a (filename, data, MIME type) tuple where - the MIME type is optional. For example:: - - fields = { - 'foo': 'bar', - 'fakefile': ('foofile.txt', 'contents of foofile'), - 'realfile': ('barfile.txt', open('realfile').read()), - 'typedfile': ('bazfile.bin', open('bazfile').read(), - 'image/jpeg'), - 'nonamefile': 'contents of nonamefile field', - } - - When uploading a file, providing a filename (the first parameter of the - tuple) is optional but recommended to best mimick behavior of browsers. - - Note that if ``headers`` are supplied, the 'Content-Type' header will - be overwritten because it depends on the dynamic random boundary string - which is used to compose the body of the request. The random boundary - string can be explicitly set with the ``multipart_boundary`` parameter. - """ - if headers is None: - headers = self.headers - - extra_kw = {'headers': {}} - - if fields: - if 'body' in urlopen_kw: - raise TypeError('request got values for both \'fields\' and \'body\', can only specify one.') - - if encode_multipart: - body, content_type = encode_multipart_formdata(fields, boundary=multipart_boundary) - else: - body, content_type = urlencode(fields), 'application/x-www-form-urlencoded' - - extra_kw['body'] = body - extra_kw['headers'] = {'Content-Type': content_type} - - extra_kw['headers'].update(headers) - extra_kw.update(urlopen_kw) - - return self.urlopen(method, url, **extra_kw) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/response.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/response.py deleted file mode 100644 index 24140c4c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/response.py +++ /dev/null @@ -1,466 +0,0 @@ -try: - import http.client as httplib -except ImportError: - import httplib -import zlib -import io -from socket import timeout as SocketTimeout - -from ._collections import HTTPHeaderDict -from .exceptions import ( - ProtocolError, DecodeError, ReadTimeoutError, ResponseNotChunked -) -from .packages.six import string_types as basestring, binary_type, PY3 -from .connection import HTTPException, BaseSSLError -from .util.response import is_fp_closed - - -class DeflateDecoder(object): - - def __init__(self): - self._first_try = True - self._data = binary_type() - self._obj = zlib.decompressobj() - - def __getattr__(self, name): - return getattr(self._obj, name) - - def decompress(self, data): - if not data: - return data - - if not self._first_try: - return self._obj.decompress(data) - - self._data += data - try: - return self._obj.decompress(data) - except zlib.error: - self._first_try = False - self._obj = zlib.decompressobj(-zlib.MAX_WBITS) - try: - return self.decompress(self._data) - finally: - self._data = None - - -class GzipDecoder(object): - - def __init__(self): - self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) - - def __getattr__(self, name): - return getattr(self._obj, name) - - def decompress(self, data): - if not data: - return data - return self._obj.decompress(data) - - -def _get_decoder(mode): - if mode == 'gzip': - return GzipDecoder() - - return DeflateDecoder() - - -class HTTPResponse(io.IOBase): - """ - HTTP Response container. - - Backwards-compatible to httplib's HTTPResponse but the response ``body`` is - loaded and decoded on-demand when the ``data`` property is accessed. This - class is also compatible with the Python standard library's :mod:`io` - module, and can hence be treated as a readable object in the context of that - framework. - - Extra parameters for behaviour not present in httplib.HTTPResponse: - - :param preload_content: - If True, the response's body will be preloaded during construction. - - :param decode_content: - If True, attempts to decode specific content-encoding's based on headers - (like 'gzip' and 'deflate') will be skipped and raw data will be used - instead. - - :param original_response: - When this HTTPResponse wrapper is generated from an httplib.HTTPResponse - object, it's convenient to include the original for debug purposes. It's - otherwise unused. - """ - - CONTENT_DECODERS = ['gzip', 'deflate'] - REDIRECT_STATUSES = [301, 302, 303, 307, 308] - - def __init__(self, body='', headers=None, status=0, version=0, reason=None, - strict=0, preload_content=True, decode_content=True, - original_response=None, pool=None, connection=None): - - if isinstance(headers, HTTPHeaderDict): - self.headers = headers - else: - self.headers = HTTPHeaderDict(headers) - self.status = status - self.version = version - self.reason = reason - self.strict = strict - self.decode_content = decode_content - - self._decoder = None - self._body = None - self._fp = None - self._original_response = original_response - self._fp_bytes_read = 0 - - if body and isinstance(body, (basestring, binary_type)): - self._body = body - - self._pool = pool - self._connection = connection - - if hasattr(body, 'read'): - self._fp = body - - # Are we using the chunked-style of transfer encoding? - self.chunked = False - self.chunk_left = None - tr_enc = self.headers.get('transfer-encoding', '').lower() - # Don't incur the penalty of creating a list and then discarding it - encodings = (enc.strip() for enc in tr_enc.split(",")) - if "chunked" in encodings: - self.chunked = True - - # We certainly don't want to preload content when the response is chunked. - if not self.chunked and preload_content and not self._body: - self._body = self.read(decode_content=decode_content) - - def get_redirect_location(self): - """ - Should we redirect and where to? - - :returns: Truthy redirect location string if we got a redirect status - code and valid location. ``None`` if redirect status and no - location. ``False`` if not a redirect status code. - """ - if self.status in self.REDIRECT_STATUSES: - return self.headers.get('location') - - return False - - def release_conn(self): - if not self._pool or not self._connection: - return - - self._pool._put_conn(self._connection) - self._connection = None - - @property - def data(self): - # For backwords-compat with earlier urllib3 0.4 and earlier. - if self._body: - return self._body - - if self._fp: - return self.read(cache_content=True) - - def tell(self): - """ - Obtain the number of bytes pulled over the wire so far. May differ from - the amount of content returned by :meth:``HTTPResponse.read`` if bytes - are encoded on the wire (e.g, compressed). - """ - return self._fp_bytes_read - - def _init_decoder(self): - """ - Set-up the _decoder attribute if necessar. - """ - # Note: content-encoding value should be case-insensitive, per RFC 7230 - # Section 3.2 - content_encoding = self.headers.get('content-encoding', '').lower() - if self._decoder is None and content_encoding in self.CONTENT_DECODERS: - self._decoder = _get_decoder(content_encoding) - - def _decode(self, data, decode_content, flush_decoder): - """ - Decode the data passed in and potentially flush the decoder. - """ - try: - if decode_content and self._decoder: - data = self._decoder.decompress(data) - except (IOError, zlib.error) as e: - content_encoding = self.headers.get('content-encoding', '').lower() - raise DecodeError( - "Received response with content-encoding: %s, but " - "failed to decode it." % content_encoding, e) - - if flush_decoder and decode_content and self._decoder: - buf = self._decoder.decompress(binary_type()) - data += buf + self._decoder.flush() - - return data - - def read(self, amt=None, decode_content=None, cache_content=False): - """ - Similar to :meth:`httplib.HTTPResponse.read`, but with two additional - parameters: ``decode_content`` and ``cache_content``. - - :param amt: - How much of the content to read. If specified, caching is skipped - because it doesn't make sense to cache partial content as the full - response. - - :param decode_content: - If True, will attempt to decode the body based on the - 'content-encoding' header. - - :param cache_content: - If True, will save the returned data such that the same result is - returned despite of the state of the underlying file object. This - is useful if you want the ``.data`` property to continue working - after having ``.read()`` the file object. (Overridden if ``amt`` is - set.) - """ - self._init_decoder() - if decode_content is None: - decode_content = self.decode_content - - if self._fp is None: - return - - flush_decoder = False - - try: - try: - if amt is None: - # cStringIO doesn't like amt=None - data = self._fp.read() - flush_decoder = True - else: - cache_content = False - data = self._fp.read(amt) - if amt != 0 and not data: # Platform-specific: Buggy versions of Python. - # Close the connection when no data is returned - # - # This is redundant to what httplib/http.client _should_ - # already do. However, versions of python released before - # December 15, 2012 (http://bugs.python.org/issue16298) do - # not properly close the connection in all cases. There is - # no harm in redundantly calling close. - self._fp.close() - flush_decoder = True - - except SocketTimeout: - # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but - # there is yet no clean way to get at it from this context. - raise ReadTimeoutError(self._pool, None, 'Read timed out.') - - except BaseSSLError as e: - # FIXME: Is there a better way to differentiate between SSLErrors? - if 'read operation timed out' not in str(e): # Defensive: - # This shouldn't happen but just in case we're missing an edge - # case, let's avoid swallowing SSL errors. - raise - - raise ReadTimeoutError(self._pool, None, 'Read timed out.') - - except HTTPException as e: - # This includes IncompleteRead. - raise ProtocolError('Connection broken: %r' % e, e) - - self._fp_bytes_read += len(data) - - data = self._decode(data, decode_content, flush_decoder) - - if cache_content: - self._body = data - - return data - - finally: - if self._original_response and self._original_response.isclosed(): - self.release_conn() - - def stream(self, amt=2**16, decode_content=None): - """ - A generator wrapper for the read() method. A call will block until - ``amt`` bytes have been read from the connection or until the - connection is closed. - - :param amt: - How much of the content to read. The generator will return up to - much data per iteration, but may return less. This is particularly - likely when using compressed data. However, the empty string will - never be returned. - - :param decode_content: - If True, will attempt to decode the body based on the - 'content-encoding' header. - """ - if self.chunked: - for line in self.read_chunked(amt, decode_content=decode_content): - yield line - else: - while not is_fp_closed(self._fp): - data = self.read(amt=amt, decode_content=decode_content) - - if data: - yield data - - @classmethod - def from_httplib(ResponseCls, r, **response_kw): - """ - Given an :class:`httplib.HTTPResponse` instance ``r``, return a - corresponding :class:`urllib3.response.HTTPResponse` object. - - Remaining parameters are passed to the HTTPResponse constructor, along - with ``original_response=r``. - """ - headers = r.msg - if not isinstance(headers, HTTPHeaderDict): - if PY3: # Python 3 - headers = HTTPHeaderDict(headers.items()) - else: # Python 2 - headers = HTTPHeaderDict.from_httplib(headers) - - # HTTPResponse objects in Python 3 don't have a .strict attribute - strict = getattr(r, 'strict', 0) - resp = ResponseCls(body=r, - headers=headers, - status=r.status, - version=r.version, - reason=r.reason, - strict=strict, - original_response=r, - **response_kw) - return resp - - # Backwards-compatibility methods for httplib.HTTPResponse - def getheaders(self): - return self.headers - - def getheader(self, name, default=None): - return self.headers.get(name, default) - - # Overrides from io.IOBase - def close(self): - if not self.closed: - self._fp.close() - - @property - def closed(self): - if self._fp is None: - return True - elif hasattr(self._fp, 'closed'): - return self._fp.closed - elif hasattr(self._fp, 'isclosed'): # Python 2 - return self._fp.isclosed() - else: - return True - - def fileno(self): - if self._fp is None: - raise IOError("HTTPResponse has no file to get a fileno from") - elif hasattr(self._fp, "fileno"): - return self._fp.fileno() - else: - raise IOError("The file-like object this HTTPResponse is wrapped " - "around has no file descriptor") - - def flush(self): - if self._fp is not None and hasattr(self._fp, 'flush'): - return self._fp.flush() - - def readable(self): - # This method is required for `io` module compatibility. - return True - - def readinto(self, b): - # This method is required for `io` module compatibility. - temp = self.read(len(b)) - if len(temp) == 0: - return 0 - else: - b[:len(temp)] = temp - return len(temp) - - def _update_chunk_length(self): - # First, we'll figure out length of a chunk and then - # we'll try to read it from socket. - if self.chunk_left is not None: - return - line = self._fp.fp.readline() - line = line.split(b';', 1)[0] - try: - self.chunk_left = int(line, 16) - except ValueError: - # Invalid chunked protocol response, abort. - self.close() - raise httplib.IncompleteRead(line) - - def _handle_chunk(self, amt): - returned_chunk = None - if amt is None: - chunk = self._fp._safe_read(self.chunk_left) - returned_chunk = chunk - self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. - self.chunk_left = None - elif amt < self.chunk_left: - value = self._fp._safe_read(amt) - self.chunk_left = self.chunk_left - amt - returned_chunk = value - elif amt == self.chunk_left: - value = self._fp._safe_read(amt) - self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. - self.chunk_left = None - returned_chunk = value - else: # amt > self.chunk_left - returned_chunk = self._fp._safe_read(self.chunk_left) - self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. - self.chunk_left = None - return returned_chunk - - def read_chunked(self, amt=None, decode_content=None): - """ - Similar to :meth:`HTTPResponse.read`, but with an additional - parameter: ``decode_content``. - - :param decode_content: - If True, will attempt to decode the body based on the - 'content-encoding' header. - """ - self._init_decoder() - # FIXME: Rewrite this method and make it a class with a better structured logic. - if not self.chunked: - raise ResponseNotChunked("Response is not chunked. " - "Header 'transfer-encoding: chunked' is missing.") - - if self._original_response and self._original_response._method.upper() == 'HEAD': - # Don't bother reading the body of a HEAD request. - # FIXME: Can we do this somehow without accessing private httplib _method? - self._original_response.close() - return - - while True: - self._update_chunk_length() - if self.chunk_left == 0: - break - chunk = self._handle_chunk(amt) - yield self._decode(chunk, decode_content=decode_content, - flush_decoder=True) - - # Chunk content ends with \r\n: discard it. - while True: - line = self._fp.fp.readline() - if not line: - # Some sites may not end with '\r\n'. - break - if line == b'\r\n': - break - - # We read everything; close the "file". - if self._original_response: - self._original_response.close() - self.release_conn() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/__init__.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/__init__.py deleted file mode 100644 index 8becc814..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/__init__.py +++ /dev/null @@ -1,24 +0,0 @@ -# For backwards compatibility, provide imports that used to be here. -from .connection import is_connection_dropped -from .request import make_headers -from .response import is_fp_closed -from .ssl_ import ( - SSLContext, - HAS_SNI, - assert_fingerprint, - resolve_cert_reqs, - resolve_ssl_version, - ssl_wrap_socket, -) -from .timeout import ( - current_time, - Timeout, -) - -from .retry import Retry -from .url import ( - get_host, - parse_url, - split_first, - Url, -) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/connection.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/connection.py deleted file mode 100644 index 859aec6e..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/connection.py +++ /dev/null @@ -1,98 +0,0 @@ -import socket -try: - from select import poll, POLLIN -except ImportError: # `poll` doesn't exist on OSX and other platforms - poll = False - try: - from select import select - except ImportError: # `select` doesn't exist on AppEngine. - select = False - - -def is_connection_dropped(conn): # Platform-specific - """ - Returns True if the connection is dropped and should be closed. - - :param conn: - :class:`httplib.HTTPConnection` object. - - Note: For platforms like AppEngine, this will always return ``False`` to - let the platform handle connection recycling transparently for us. - """ - sock = getattr(conn, 'sock', False) - if sock is False: # Platform-specific: AppEngine - return False - if sock is None: # Connection already closed (such as by httplib). - return True - - if not poll: - if not select: # Platform-specific: AppEngine - return False - - try: - return select([sock], [], [], 0.0)[0] - except socket.error: - return True - - # This version is better on platforms that support it. - p = poll() - p.register(sock, POLLIN) - for (fno, ev) in p.poll(0.0): - if fno == sock.fileno(): - # Either data is buffered (bad), or the connection is dropped. - return True - - -# This function is copied from socket.py in the Python 2.7 standard -# library test suite. Added to its signature is only `socket_options`. -def create_connection(address, timeout=socket._GLOBAL_DEFAULT_TIMEOUT, - source_address=None, socket_options=None): - """Connect to *address* and return the socket object. - - Convenience function. Connect to *address* (a 2-tuple ``(host, - port)``) and return the socket object. Passing the optional - *timeout* parameter will set the timeout on the socket instance - before attempting to connect. If no *timeout* is supplied, the - global default timeout setting returned by :func:`getdefaulttimeout` - is used. If *source_address* is set it must be a tuple of (host, port) - for the socket to bind as a source address before making the connection. - An host of '' or port 0 tells the OS to use the default. - """ - - host, port = address - err = None - for res in socket.getaddrinfo(host, port, 0, socket.SOCK_STREAM): - af, socktype, proto, canonname, sa = res - sock = None - try: - sock = socket.socket(af, socktype, proto) - - # If provided, set socket level options before connecting. - # This is the only addition urllib3 makes to this function. - _set_socket_options(sock, socket_options) - - if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT: - sock.settimeout(timeout) - if source_address: - sock.bind(source_address) - sock.connect(sa) - return sock - - except socket.error as _: - err = _ - if sock is not None: - sock.close() - sock = None - - if err is not None: - raise err - else: - raise socket.error("getaddrinfo returns an empty list") - - -def _set_socket_options(sock, options): - if options is None: - return - - for opt in options: - sock.setsockopt(*opt) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/request.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/request.py deleted file mode 100644 index bc64f6b1..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/request.py +++ /dev/null @@ -1,71 +0,0 @@ -from base64 import b64encode - -from ..packages.six import b - -ACCEPT_ENCODING = 'gzip,deflate' - - -def make_headers(keep_alive=None, accept_encoding=None, user_agent=None, - basic_auth=None, proxy_basic_auth=None, disable_cache=None): - """ - Shortcuts for generating request headers. - - :param keep_alive: - If ``True``, adds 'connection: keep-alive' header. - - :param accept_encoding: - Can be a boolean, list, or string. - ``True`` translates to 'gzip,deflate'. - List will get joined by comma. - String will be used as provided. - - :param user_agent: - String representing the user-agent you want, such as - "python-urllib3/0.6" - - :param basic_auth: - Colon-separated username:password string for 'authorization: basic ...' - auth header. - - :param proxy_basic_auth: - Colon-separated username:password string for 'proxy-authorization: basic ...' - auth header. - - :param disable_cache: - If ``True``, adds 'cache-control: no-cache' header. - - Example:: - - >>> make_headers(keep_alive=True, user_agent="Batman/1.0") - {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'} - >>> make_headers(accept_encoding=True) - {'accept-encoding': 'gzip,deflate'} - """ - headers = {} - if accept_encoding: - if isinstance(accept_encoding, str): - pass - elif isinstance(accept_encoding, list): - accept_encoding = ','.join(accept_encoding) - else: - accept_encoding = ACCEPT_ENCODING - headers['accept-encoding'] = accept_encoding - - if user_agent: - headers['user-agent'] = user_agent - - if keep_alive: - headers['connection'] = 'keep-alive' - - if basic_auth: - headers['authorization'] = 'Basic ' + \ - b64encode(b(basic_auth)).decode('utf-8') - - if proxy_basic_auth: - headers['proxy-authorization'] = 'Basic ' + \ - b64encode(b(proxy_basic_auth)).decode('utf-8') - - if disable_cache: - headers['cache-control'] = 'no-cache' - - return headers diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/response.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/response.py deleted file mode 100644 index 45fff552..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/response.py +++ /dev/null @@ -1,22 +0,0 @@ -def is_fp_closed(obj): - """ - Checks whether a given file-like object is closed. - - :param obj: - The file-like object to check. - """ - - try: - # Check via the official file-like-object way. - return obj.closed - except AttributeError: - pass - - try: - # Check if the object is a container for another file-like object that - # gets released on exhaustion (e.g. HTTPResponse). - return obj.fp is None - except AttributeError: - pass - - raise ValueError("Unable to determine whether fp is closed.") diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/retry.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/retry.py deleted file mode 100644 index 7e0959df..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/retry.py +++ /dev/null @@ -1,285 +0,0 @@ -import time -import logging - -from ..exceptions import ( - ConnectTimeoutError, - MaxRetryError, - ProtocolError, - ReadTimeoutError, - ResponseError, -) -from ..packages import six - - -log = logging.getLogger(__name__) - - -class Retry(object): - """ Retry configuration. - - Each retry attempt will create a new Retry object with updated values, so - they can be safely reused. - - Retries can be defined as a default for a pool:: - - retries = Retry(connect=5, read=2, redirect=5) - http = PoolManager(retries=retries) - response = http.request('GET', 'http://example.com/') - - Or per-request (which overrides the default for the pool):: - - response = http.request('GET', 'http://example.com/', retries=Retry(10)) - - Retries can be disabled by passing ``False``:: - - response = http.request('GET', 'http://example.com/', retries=False) - - Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless - retries are disabled, in which case the causing exception will be raised. - - :param int total: - Total number of retries to allow. Takes precedence over other counts. - - Set to ``None`` to remove this constraint and fall back on other - counts. It's a good idea to set this to some sensibly-high value to - account for unexpected edge cases and avoid infinite retry loops. - - Set to ``0`` to fail on the first retry. - - Set to ``False`` to disable and imply ``raise_on_redirect=False``. - - :param int connect: - How many connection-related errors to retry on. - - These are errors raised before the request is sent to the remote server, - which we assume has not triggered the server to process the request. - - Set to ``0`` to fail on the first retry of this type. - - :param int read: - How many times to retry on read errors. - - These errors are raised after the request was sent to the server, so the - request may have side-effects. - - Set to ``0`` to fail on the first retry of this type. - - :param int redirect: - How many redirects to perform. Limit this to avoid infinite redirect - loops. - - A redirect is a HTTP response with a status code 301, 302, 303, 307 or - 308. - - Set to ``0`` to fail on the first retry of this type. - - Set to ``False`` to disable and imply ``raise_on_redirect=False``. - - :param iterable method_whitelist: - Set of uppercased HTTP method verbs that we should retry on. - - By default, we only retry on methods which are considered to be - indempotent (multiple requests with the same parameters end with the - same state). See :attr:`Retry.DEFAULT_METHOD_WHITELIST`. - - :param iterable status_forcelist: - A set of HTTP status codes that we should force a retry on. - - By default, this is disabled with ``None``. - - :param float backoff_factor: - A backoff factor to apply between attempts. urllib3 will sleep for:: - - {backoff factor} * (2 ^ ({number of total retries} - 1)) - - seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep - for [0.1s, 0.2s, 0.4s, ...] between retries. It will never be longer - than :attr:`Retry.MAX_BACKOFF`. - - By default, backoff is disabled (set to 0). - - :param bool raise_on_redirect: Whether, if the number of redirects is - exhausted, to raise a MaxRetryError, or to return a response with a - response code in the 3xx range. - """ - - DEFAULT_METHOD_WHITELIST = frozenset([ - 'HEAD', 'GET', 'PUT', 'DELETE', 'OPTIONS', 'TRACE']) - - #: Maximum backoff time. - BACKOFF_MAX = 120 - - def __init__(self, total=10, connect=None, read=None, redirect=None, - method_whitelist=DEFAULT_METHOD_WHITELIST, status_forcelist=None, - backoff_factor=0, raise_on_redirect=True, _observed_errors=0): - - self.total = total - self.connect = connect - self.read = read - - if redirect is False or total is False: - redirect = 0 - raise_on_redirect = False - - self.redirect = redirect - self.status_forcelist = status_forcelist or set() - self.method_whitelist = method_whitelist - self.backoff_factor = backoff_factor - self.raise_on_redirect = raise_on_redirect - self._observed_errors = _observed_errors # TODO: use .history instead? - - def new(self, **kw): - params = dict( - total=self.total, - connect=self.connect, read=self.read, redirect=self.redirect, - method_whitelist=self.method_whitelist, - status_forcelist=self.status_forcelist, - backoff_factor=self.backoff_factor, - raise_on_redirect=self.raise_on_redirect, - _observed_errors=self._observed_errors, - ) - params.update(kw) - return type(self)(**params) - - @classmethod - def from_int(cls, retries, redirect=True, default=None): - """ Backwards-compatibility for the old retries format.""" - if retries is None: - retries = default if default is not None else cls.DEFAULT - - if isinstance(retries, Retry): - return retries - - redirect = bool(redirect) and None - new_retries = cls(retries, redirect=redirect) - log.debug("Converted retries value: %r -> %r" % (retries, new_retries)) - return new_retries - - def get_backoff_time(self): - """ Formula for computing the current backoff - - :rtype: float - """ - if self._observed_errors <= 1: - return 0 - - backoff_value = self.backoff_factor * (2 ** (self._observed_errors - 1)) - return min(self.BACKOFF_MAX, backoff_value) - - def sleep(self): - """ Sleep between retry attempts using an exponential backoff. - - By default, the backoff factor is 0 and this method will return - immediately. - """ - backoff = self.get_backoff_time() - if backoff <= 0: - return - time.sleep(backoff) - - def _is_connection_error(self, err): - """ Errors when we're fairly sure that the server did not receive the - request, so it should be safe to retry. - """ - return isinstance(err, ConnectTimeoutError) - - def _is_read_error(self, err): - """ Errors that occur after the request has been started, so we should - assume that the server began processing it. - """ - return isinstance(err, (ReadTimeoutError, ProtocolError)) - - def is_forced_retry(self, method, status_code): - """ Is this method/status code retryable? (Based on method/codes whitelists) - """ - if self.method_whitelist and method.upper() not in self.method_whitelist: - return False - - return self.status_forcelist and status_code in self.status_forcelist - - def is_exhausted(self): - """ Are we out of retries? """ - retry_counts = (self.total, self.connect, self.read, self.redirect) - retry_counts = list(filter(None, retry_counts)) - if not retry_counts: - return False - - return min(retry_counts) < 0 - - def increment(self, method=None, url=None, response=None, error=None, _pool=None, _stacktrace=None): - """ Return a new Retry object with incremented retry counters. - - :param response: A response object, or None, if the server did not - return a response. - :type response: :class:`~urllib3.response.HTTPResponse` - :param Exception error: An error encountered during the request, or - None if the response was received successfully. - - :return: A new ``Retry`` object. - """ - if self.total is False and error: - # Disabled, indicate to re-raise the error. - raise six.reraise(type(error), error, _stacktrace) - - total = self.total - if total is not None: - total -= 1 - - _observed_errors = self._observed_errors - connect = self.connect - read = self.read - redirect = self.redirect - cause = 'unknown' - - if error and self._is_connection_error(error): - # Connect retry? - if connect is False: - raise six.reraise(type(error), error, _stacktrace) - elif connect is not None: - connect -= 1 - _observed_errors += 1 - - elif error and self._is_read_error(error): - # Read retry? - if read is False: - raise six.reraise(type(error), error, _stacktrace) - elif read is not None: - read -= 1 - _observed_errors += 1 - - elif response and response.get_redirect_location(): - # Redirect retry? - if redirect is not None: - redirect -= 1 - cause = 'too many redirects' - - else: - # Incrementing because of a server error like a 500 in - # status_forcelist and a the given method is in the whitelist - _observed_errors += 1 - cause = ResponseError.GENERIC_ERROR - if response and response.status: - cause = ResponseError.SPECIFIC_ERROR.format( - status_code=response.status) - - new_retry = self.new( - total=total, - connect=connect, read=read, redirect=redirect, - _observed_errors=_observed_errors) - - if new_retry.is_exhausted(): - raise MaxRetryError(_pool, url, error or ResponseError(cause)) - - log.debug("Incremented Retry for (url='%s'): %r" % (url, new_retry)) - - return new_retry - - - def __repr__(self): - return ('{cls.__name__}(total={self.total}, connect={self.connect}, ' - 'read={self.read}, redirect={self.redirect})').format( - cls=type(self), self=self) - - -# For backwards compatibility (equivalent to pre-v1.9): -Retry.DEFAULT = Retry(3) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/ssl_.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/ssl_.py deleted file mode 100644 index b846d42c..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/ssl_.py +++ /dev/null @@ -1,280 +0,0 @@ -from binascii import hexlify, unhexlify -from hashlib import md5, sha1, sha256 - -from ..exceptions import SSLError, InsecurePlatformWarning - - -SSLContext = None -HAS_SNI = False -create_default_context = None - -import errno -import warnings - -try: # Test for SSL features - import ssl - from ssl import wrap_socket, CERT_NONE, PROTOCOL_SSLv23 - from ssl import HAS_SNI # Has SNI? -except ImportError: - pass - - -try: - from ssl import OP_NO_SSLv2, OP_NO_SSLv3, OP_NO_COMPRESSION -except ImportError: - OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000 - OP_NO_COMPRESSION = 0x20000 - -# A secure default. -# Sources for more information on TLS ciphers: -# -# - https://wiki.mozilla.org/Security/Server_Side_TLS -# - https://www.ssllabs.com/projects/best-practices/index.html -# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/ -# -# The general intent is: -# - Prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE), -# - prefer ECDHE over DHE for better performance, -# - prefer any AES-GCM over any AES-CBC for better performance and security, -# - use 3DES as fallback which is secure but slow, -# - disable NULL authentication, MD5 MACs and DSS for security reasons. -DEFAULT_CIPHERS = ( - 'ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+HIGH:' - 'DH+HIGH:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+HIGH:RSA+3DES:!aNULL:' - '!eNULL:!MD5' -) - -try: - from ssl import SSLContext # Modern SSL? -except ImportError: - import sys - - class SSLContext(object): # Platform-specific: Python 2 & 3.1 - supports_set_ciphers = ((2, 7) <= sys.version_info < (3,) or - (3, 2) <= sys.version_info) - - def __init__(self, protocol_version): - self.protocol = protocol_version - # Use default values from a real SSLContext - self.check_hostname = False - self.verify_mode = ssl.CERT_NONE - self.ca_certs = None - self.options = 0 - self.certfile = None - self.keyfile = None - self.ciphers = None - - def load_cert_chain(self, certfile, keyfile): - self.certfile = certfile - self.keyfile = keyfile - - def load_verify_locations(self, location): - self.ca_certs = location - - def set_ciphers(self, cipher_suite): - if not self.supports_set_ciphers: - raise TypeError( - 'Your version of Python does not support setting ' - 'a custom cipher suite. Please upgrade to Python ' - '2.7, 3.2, or later if you need this functionality.' - ) - self.ciphers = cipher_suite - - def wrap_socket(self, socket, server_hostname=None): - warnings.warn( - 'A true SSLContext object is not available. This prevents ' - 'urllib3 from configuring SSL appropriately and may cause ' - 'certain SSL connections to fail. For more information, see ' - 'https://urllib3.readthedocs.org/en/latest/security.html' - '#insecureplatformwarning.', - InsecurePlatformWarning - ) - kwargs = { - 'keyfile': self.keyfile, - 'certfile': self.certfile, - 'ca_certs': self.ca_certs, - 'cert_reqs': self.verify_mode, - 'ssl_version': self.protocol, - } - if self.supports_set_ciphers: # Platform-specific: Python 2.7+ - return wrap_socket(socket, ciphers=self.ciphers, **kwargs) - else: # Platform-specific: Python 2.6 - return wrap_socket(socket, **kwargs) - - -def assert_fingerprint(cert, fingerprint): - """ - Checks if given fingerprint matches the supplied certificate. - - :param cert: - Certificate as bytes object. - :param fingerprint: - Fingerprint as string of hexdigits, can be interspersed by colons. - """ - - # Maps the length of a digest to a possible hash function producing - # this digest. - hashfunc_map = { - 16: md5, - 20: sha1, - 32: sha256, - } - - fingerprint = fingerprint.replace(':', '').lower() - digest_length, odd = divmod(len(fingerprint), 2) - - if odd or digest_length not in hashfunc_map: - raise SSLError('Fingerprint is of invalid length.') - - # We need encode() here for py32; works on py2 and p33. - fingerprint_bytes = unhexlify(fingerprint.encode()) - - hashfunc = hashfunc_map[digest_length] - - cert_digest = hashfunc(cert).digest() - - if not cert_digest == fingerprint_bytes: - raise SSLError('Fingerprints did not match. Expected "{0}", got "{1}".' - .format(hexlify(fingerprint_bytes), - hexlify(cert_digest))) - - -def resolve_cert_reqs(candidate): - """ - Resolves the argument to a numeric constant, which can be passed to - the wrap_socket function/method from the ssl module. - Defaults to :data:`ssl.CERT_NONE`. - If given a string it is assumed to be the name of the constant in the - :mod:`ssl` module or its abbrevation. - (So you can specify `REQUIRED` instead of `CERT_REQUIRED`. - If it's neither `None` nor a string we assume it is already the numeric - constant which can directly be passed to wrap_socket. - """ - if candidate is None: - return CERT_NONE - - if isinstance(candidate, str): - res = getattr(ssl, candidate, None) - if res is None: - res = getattr(ssl, 'CERT_' + candidate) - return res - - return candidate - - -def resolve_ssl_version(candidate): - """ - like resolve_cert_reqs - """ - if candidate is None: - return PROTOCOL_SSLv23 - - if isinstance(candidate, str): - res = getattr(ssl, candidate, None) - if res is None: - res = getattr(ssl, 'PROTOCOL_' + candidate) - return res - - return candidate - - -def create_urllib3_context(ssl_version=None, cert_reqs=None, - options=None, ciphers=None): - """All arguments have the same meaning as ``ssl_wrap_socket``. - - By default, this function does a lot of the same work that - ``ssl.create_default_context`` does on Python 3.4+. It: - - - Disables SSLv2, SSLv3, and compression - - Sets a restricted set of server ciphers - - If you wish to enable SSLv3, you can do:: - - from urllib3.util import ssl_ - context = ssl_.create_urllib3_context() - context.options &= ~ssl_.OP_NO_SSLv3 - - You can do the same to enable compression (substituting ``COMPRESSION`` - for ``SSLv3`` in the last line above). - - :param ssl_version: - The desired protocol version to use. This will default to - PROTOCOL_SSLv23 which will negotiate the highest protocol that both - the server and your installation of OpenSSL support. - :param cert_reqs: - Whether to require the certificate verification. This defaults to - ``ssl.CERT_REQUIRED``. - :param options: - Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``, - ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``. - :param ciphers: - Which cipher suites to allow the server to select. - :returns: - Constructed SSLContext object with specified options - :rtype: SSLContext - """ - context = SSLContext(ssl_version or ssl.PROTOCOL_SSLv23) - - # Setting the default here, as we may have no ssl module on import - cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs - - if options is None: - options = 0 - # SSLv2 is easily broken and is considered harmful and dangerous - options |= OP_NO_SSLv2 - # SSLv3 has several problems and is now dangerous - options |= OP_NO_SSLv3 - # Disable compression to prevent CRIME attacks for OpenSSL 1.0+ - # (issue #309) - options |= OP_NO_COMPRESSION - - context.options |= options - - if getattr(context, 'supports_set_ciphers', True): # Platform-specific: Python 2.6 - context.set_ciphers(ciphers or DEFAULT_CIPHERS) - - context.verify_mode = cert_reqs - if getattr(context, 'check_hostname', None) is not None: # Platform-specific: Python 3.2 - # We do our own verification, including fingerprints and alternative - # hostnames. So disable it here - context.check_hostname = False - return context - - -def ssl_wrap_socket(sock, keyfile=None, certfile=None, cert_reqs=None, - ca_certs=None, server_hostname=None, - ssl_version=None, ciphers=None, ssl_context=None): - """ - All arguments except for server_hostname and ssl_context have the same - meaning as they do when using :func:`ssl.wrap_socket`. - - :param server_hostname: - When SNI is supported, the expected hostname of the certificate - :param ssl_context: - A pre-made :class:`SSLContext` object. If none is provided, one will - be created using :func:`create_urllib3_context`. - :param ciphers: - A string of ciphers we wish the client to support. This is not - supported on Python 2.6 as the ssl module does not support it. - """ - context = ssl_context - if context is None: - context = create_urllib3_context(ssl_version, cert_reqs, - ciphers=ciphers) - - if ca_certs: - try: - context.load_verify_locations(ca_certs) - except IOError as e: # Platform-specific: Python 2.6, 2.7, 3.2 - raise SSLError(e) - # Py33 raises FileNotFoundError which subclasses OSError - # These are not equivalent unless we check the errno attribute - except OSError as e: # Platform-specific: Python 3.3 and beyond - if e.errno == errno.ENOENT: - raise SSLError(e) - raise - if certfile: - context.load_cert_chain(certfile, keyfile) - if HAS_SNI: # Platform-specific: OpenSSL with enabled SNI - return context.wrap_socket(sock, server_hostname=server_hostname) - return context.wrap_socket(sock) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/timeout.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/timeout.py deleted file mode 100644 index ea7027f3..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/timeout.py +++ /dev/null @@ -1,240 +0,0 @@ -# The default socket timeout, used by httplib to indicate that no timeout was -# specified by the user -from socket import _GLOBAL_DEFAULT_TIMEOUT -import time - -from ..exceptions import TimeoutStateError - -# A sentinel value to indicate that no timeout was specified by the user in -# urllib3 -_Default = object() - -def current_time(): - """ - Retrieve the current time. This function is mocked out in unit testing. - """ - return time.time() - - -class Timeout(object): - """ Timeout configuration. - - Timeouts can be defined as a default for a pool:: - - timeout = Timeout(connect=2.0, read=7.0) - http = PoolManager(timeout=timeout) - response = http.request('GET', 'http://example.com/') - - Or per-request (which overrides the default for the pool):: - - response = http.request('GET', 'http://example.com/', timeout=Timeout(10)) - - Timeouts can be disabled by setting all the parameters to ``None``:: - - no_timeout = Timeout(connect=None, read=None) - response = http.request('GET', 'http://example.com/, timeout=no_timeout) - - - :param total: - This combines the connect and read timeouts into one; the read timeout - will be set to the time leftover from the connect attempt. In the - event that both a connect timeout and a total are specified, or a read - timeout and a total are specified, the shorter timeout will be applied. - - Defaults to None. - - :type total: integer, float, or None - - :param connect: - The maximum amount of time to wait for a connection attempt to a server - to succeed. Omitting the parameter will default the connect timeout to - the system default, probably `the global default timeout in socket.py - `_. - None will set an infinite timeout for connection attempts. - - :type connect: integer, float, or None - - :param read: - The maximum amount of time to wait between consecutive - read operations for a response from the server. Omitting - the parameter will default the read timeout to the system - default, probably `the global default timeout in socket.py - `_. - None will set an infinite timeout. - - :type read: integer, float, or None - - .. note:: - - Many factors can affect the total amount of time for urllib3 to return - an HTTP response. - - For example, Python's DNS resolver does not obey the timeout specified - on the socket. Other factors that can affect total request time include - high CPU load, high swap, the program running at a low priority level, - or other behaviors. - - In addition, the read and total timeouts only measure the time between - read operations on the socket connecting the client and the server, - not the total amount of time for the request to return a complete - response. For most requests, the timeout is raised because the server - has not sent the first byte in the specified time. This is not always - the case; if a server streams one byte every fifteen seconds, a timeout - of 20 seconds will not trigger, even though the request will take - several minutes to complete. - - If your goal is to cut off any request after a set amount of wall clock - time, consider having a second "watcher" thread to cut off a slow - request. - """ - - #: A sentinel object representing the default timeout value - DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT - - def __init__(self, total=None, connect=_Default, read=_Default): - self._connect = self._validate_timeout(connect, 'connect') - self._read = self._validate_timeout(read, 'read') - self.total = self._validate_timeout(total, 'total') - self._start_connect = None - - def __str__(self): - return '%s(connect=%r, read=%r, total=%r)' % ( - type(self).__name__, self._connect, self._read, self.total) - - @classmethod - def _validate_timeout(cls, value, name): - """ Check that a timeout attribute is valid. - - :param value: The timeout value to validate - :param name: The name of the timeout attribute to validate. This is - used to specify in error messages. - :return: The validated and casted version of the given value. - :raises ValueError: If the type is not an integer or a float, or if it - is a numeric value less than zero. - """ - if value is _Default: - return cls.DEFAULT_TIMEOUT - - if value is None or value is cls.DEFAULT_TIMEOUT: - return value - - try: - float(value) - except (TypeError, ValueError): - raise ValueError("Timeout value %s was %s, but it must be an " - "int or float." % (name, value)) - - try: - if value < 0: - raise ValueError("Attempted to set %s timeout to %s, but the " - "timeout cannot be set to a value less " - "than 0." % (name, value)) - except TypeError: # Python 3 - raise ValueError("Timeout value %s was %s, but it must be an " - "int or float." % (name, value)) - - return value - - @classmethod - def from_float(cls, timeout): - """ Create a new Timeout from a legacy timeout value. - - The timeout value used by httplib.py sets the same timeout on the - connect(), and recv() socket requests. This creates a :class:`Timeout` - object that sets the individual timeouts to the ``timeout`` value - passed to this function. - - :param timeout: The legacy timeout value. - :type timeout: integer, float, sentinel default object, or None - :return: Timeout object - :rtype: :class:`Timeout` - """ - return Timeout(read=timeout, connect=timeout) - - def clone(self): - """ Create a copy of the timeout object - - Timeout properties are stored per-pool but each request needs a fresh - Timeout object to ensure each one has its own start/stop configured. - - :return: a copy of the timeout object - :rtype: :class:`Timeout` - """ - # We can't use copy.deepcopy because that will also create a new object - # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to - # detect the user default. - return Timeout(connect=self._connect, read=self._read, - total=self.total) - - def start_connect(self): - """ Start the timeout clock, used during a connect() attempt - - :raises urllib3.exceptions.TimeoutStateError: if you attempt - to start a timer that has been started already. - """ - if self._start_connect is not None: - raise TimeoutStateError("Timeout timer has already been started.") - self._start_connect = current_time() - return self._start_connect - - def get_connect_duration(self): - """ Gets the time elapsed since the call to :meth:`start_connect`. - - :return: Elapsed time. - :rtype: float - :raises urllib3.exceptions.TimeoutStateError: if you attempt - to get duration for a timer that hasn't been started. - """ - if self._start_connect is None: - raise TimeoutStateError("Can't get connect duration for timer " - "that has not started.") - return current_time() - self._start_connect - - @property - def connect_timeout(self): - """ Get the value to use when setting a connection timeout. - - This will be a positive float or integer, the value None - (never timeout), or the default system timeout. - - :return: Connect timeout. - :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None - """ - if self.total is None: - return self._connect - - if self._connect is None or self._connect is self.DEFAULT_TIMEOUT: - return self.total - - return min(self._connect, self.total) - - @property - def read_timeout(self): - """ Get the value for the read timeout. - - This assumes some time has elapsed in the connection timeout and - computes the read timeout appropriately. - - If self.total is set, the read timeout is dependent on the amount of - time taken by the connect timeout. If the connection time has not been - established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be - raised. - - :return: Value to use for the read timeout. - :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None - :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect` - has not yet been called on this object. - """ - if (self.total is not None and - self.total is not self.DEFAULT_TIMEOUT and - self._read is not None and - self._read is not self.DEFAULT_TIMEOUT): - # In case the connect timeout has not yet been established. - if self._start_connect is None: - return self._read - return max(0, min(self.total - self.get_connect_duration(), - self._read)) - elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT: - return max(0, self.total - self.get_connect_duration()) - else: - return self._read diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/url.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/url.py deleted file mode 100644 index e58050cd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/packages/urllib3/util/url.py +++ /dev/null @@ -1,214 +0,0 @@ -from collections import namedtuple - -from ..exceptions import LocationParseError - - -url_attrs = ['scheme', 'auth', 'host', 'port', 'path', 'query', 'fragment'] - - -class Url(namedtuple('Url', url_attrs)): - """ - Datastructure for representing an HTTP URL. Used as a return value for - :func:`parse_url`. - """ - slots = () - - def __new__(cls, scheme=None, auth=None, host=None, port=None, path=None, - query=None, fragment=None): - if path and not path.startswith('/'): - path = '/' + path - return super(Url, cls).__new__(cls, scheme, auth, host, port, path, - query, fragment) - - @property - def hostname(self): - """For backwards-compatibility with urlparse. We're nice like that.""" - return self.host - - @property - def request_uri(self): - """Absolute path including the query string.""" - uri = self.path or '/' - - if self.query is not None: - uri += '?' + self.query - - return uri - - @property - def netloc(self): - """Network location including host and port""" - if self.port: - return '%s:%d' % (self.host, self.port) - return self.host - - @property - def url(self): - """ - Convert self into a url - - This function should more or less round-trip with :func:`.parse_url`. The - returned url may not be exactly the same as the url inputted to - :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls - with a blank port will have : removed). - - Example: :: - - >>> U = parse_url('http://google.com/mail/') - >>> U.url - 'http://google.com/mail/' - >>> Url('http', 'username:password', 'host.com', 80, - ... '/path', 'query', 'fragment').url - 'http://username:password@host.com:80/path?query#fragment' - """ - scheme, auth, host, port, path, query, fragment = self - url = '' - - # We use "is not None" we want things to happen with empty strings (or 0 port) - if scheme is not None: - url += scheme + '://' - if auth is not None: - url += auth + '@' - if host is not None: - url += host - if port is not None: - url += ':' + str(port) - if path is not None: - url += path - if query is not None: - url += '?' + query - if fragment is not None: - url += '#' + fragment - - return url - - def __str__(self): - return self.url - -def split_first(s, delims): - """ - Given a string and an iterable of delimiters, split on the first found - delimiter. Return two split parts and the matched delimiter. - - If not found, then the first part is the full input string. - - Example:: - - >>> split_first('foo/bar?baz', '?/=') - ('foo', 'bar?baz', '/') - >>> split_first('foo/bar?baz', '123') - ('foo/bar?baz', '', None) - - Scales linearly with number of delims. Not ideal for large number of delims. - """ - min_idx = None - min_delim = None - for d in delims: - idx = s.find(d) - if idx < 0: - continue - - if min_idx is None or idx < min_idx: - min_idx = idx - min_delim = d - - if min_idx is None or min_idx < 0: - return s, '', None - - return s[:min_idx], s[min_idx+1:], min_delim - - -def parse_url(url): - """ - Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is - performed to parse incomplete urls. Fields not provided will be None. - - Partly backwards-compatible with :mod:`urlparse`. - - Example:: - - >>> parse_url('http://google.com/mail/') - Url(scheme='http', host='google.com', port=None, path='/mail/', ...) - >>> parse_url('google.com:80') - Url(scheme=None, host='google.com', port=80, path=None, ...) - >>> parse_url('/foo?bar') - Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...) - """ - - # While this code has overlap with stdlib's urlparse, it is much - # simplified for our needs and less annoying. - # Additionally, this implementations does silly things to be optimal - # on CPython. - - if not url: - # Empty - return Url() - - scheme = None - auth = None - host = None - port = None - path = None - fragment = None - query = None - - # Scheme - if '://' in url: - scheme, url = url.split('://', 1) - - # Find the earliest Authority Terminator - # (http://tools.ietf.org/html/rfc3986#section-3.2) - url, path_, delim = split_first(url, ['/', '?', '#']) - - if delim: - # Reassemble the path - path = delim + path_ - - # Auth - if '@' in url: - # Last '@' denotes end of auth part - auth, url = url.rsplit('@', 1) - - # IPv6 - if url and url[0] == '[': - host, url = url.split(']', 1) - host += ']' - - # Port - if ':' in url: - _host, port = url.split(':', 1) - - if not host: - host = _host - - if port: - # If given, ports must be integers. - if not port.isdigit(): - raise LocationParseError(url) - port = int(port) - else: - # Blank ports are cool, too. (rfc3986#section-3.2.3) - port = None - - elif not host and url: - host = url - - if not path: - return Url(scheme, auth, host, port, path, query, fragment) - - # Fragment - if '#' in path: - path, fragment = path.split('#', 1) - - # Query - if '?' in path: - path, query = path.split('?', 1) - - return Url(scheme, auth, host, port, path, query, fragment) - -def get_host(url): - """ - Deprecated. Use :func:`.parse_url` instead. - """ - p = parse_url(url) - return p.scheme or 'http', p.hostname, p.port diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/sessions.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/sessions.py deleted file mode 100644 index 820919ee..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/sessions.py +++ /dev/null @@ -1,677 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.session -~~~~~~~~~~~~~~~~ - -This module provides a Session object to manage and persist settings across -requests (cookies, auth, proxies). - -""" -import os -from collections import Mapping -from datetime import datetime - -from .auth import _basic_auth_str -from .compat import cookielib, OrderedDict, urljoin, urlparse -from .cookies import ( - cookiejar_from_dict, extract_cookies_to_jar, RequestsCookieJar, merge_cookies) -from .models import Request, PreparedRequest, DEFAULT_REDIRECT_LIMIT -from .hooks import default_hooks, dispatch_hook -from .utils import to_key_val_list, default_headers, to_native_string -from .exceptions import ( - TooManyRedirects, InvalidSchema, ChunkedEncodingError, ContentDecodingError) -from .packages.urllib3._collections import RecentlyUsedContainer -from .structures import CaseInsensitiveDict - -from .adapters import HTTPAdapter - -from .utils import ( - requote_uri, get_environ_proxies, get_netrc_auth, should_bypass_proxies, - get_auth_from_url -) - -from .status_codes import codes - -# formerly defined here, reexposed here for backward compatibility -from .models import REDIRECT_STATI - -REDIRECT_CACHE_SIZE = 1000 - - -def merge_setting(request_setting, session_setting, dict_class=OrderedDict): - """ - Determines appropriate setting for a given request, taking into account the - explicit setting on that request, and the setting in the session. If a - setting is a dictionary, they will be merged together using `dict_class` - """ - - if session_setting is None: - return request_setting - - if request_setting is None: - return session_setting - - # Bypass if not a dictionary (e.g. verify) - if not ( - isinstance(session_setting, Mapping) and - isinstance(request_setting, Mapping) - ): - return request_setting - - merged_setting = dict_class(to_key_val_list(session_setting)) - merged_setting.update(to_key_val_list(request_setting)) - - # Remove keys that are set to None. - for (k, v) in request_setting.items(): - if v is None: - del merged_setting[k] - - merged_setting = dict((k, v) for (k, v) in merged_setting.items() if v is not None) - - return merged_setting - - -def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict): - """ - Properly merges both requests and session hooks. - - This is necessary because when request_hooks == {'response': []}, the - merge breaks Session hooks entirely. - """ - if session_hooks is None or session_hooks.get('response') == []: - return request_hooks - - if request_hooks is None or request_hooks.get('response') == []: - return session_hooks - - return merge_setting(request_hooks, session_hooks, dict_class) - - -class SessionRedirectMixin(object): - def resolve_redirects(self, resp, req, stream=False, timeout=None, - verify=True, cert=None, proxies=None, **adapter_kwargs): - """Receives a Response. Returns a generator of Responses.""" - - i = 0 - hist = [] # keep track of history - - while resp.is_redirect: - prepared_request = req.copy() - - if i > 0: - # Update history and keep track of redirects. - hist.append(resp) - new_hist = list(hist) - resp.history = new_hist - - try: - resp.content # Consume socket so it can be released - except (ChunkedEncodingError, ContentDecodingError, RuntimeError): - resp.raw.read(decode_content=False) - - if i >= self.max_redirects: - raise TooManyRedirects('Exceeded %s redirects.' % self.max_redirects) - - # Release the connection back into the pool. - resp.close() - - url = resp.headers['location'] - method = req.method - - # Handle redirection without scheme (see: RFC 1808 Section 4) - if url.startswith('//'): - parsed_rurl = urlparse(resp.url) - url = '%s:%s' % (parsed_rurl.scheme, url) - - # The scheme should be lower case... - parsed = urlparse(url) - url = parsed.geturl() - - # Facilitate relative 'location' headers, as allowed by RFC 7231. - # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource') - # Compliant with RFC3986, we percent encode the url. - if not parsed.netloc: - url = urljoin(resp.url, requote_uri(url)) - else: - url = requote_uri(url) - - prepared_request.url = to_native_string(url) - # Cache the url, unless it redirects to itself. - if resp.is_permanent_redirect and req.url != prepared_request.url: - self.redirect_cache[req.url] = prepared_request.url - - # http://tools.ietf.org/html/rfc7231#section-6.4.4 - if (resp.status_code == codes.see_other and - method != 'HEAD'): - method = 'GET' - - # Do what the browsers do, despite standards... - # First, turn 302s into GETs. - if resp.status_code == codes.found and method != 'HEAD': - method = 'GET' - - # Second, if a POST is responded to with a 301, turn it into a GET. - # This bizarre behaviour is explained in Issue 1704. - if resp.status_code == codes.moved and method == 'POST': - method = 'GET' - - prepared_request.method = method - - # https://github.com/kennethreitz/requests/issues/1084 - if resp.status_code not in (codes.temporary_redirect, codes.permanent_redirect): - if 'Content-Length' in prepared_request.headers: - del prepared_request.headers['Content-Length'] - - prepared_request.body = None - - headers = prepared_request.headers - try: - del headers['Cookie'] - except KeyError: - pass - - # Extract any cookies sent on the response to the cookiejar - # in the new request. Because we've mutated our copied prepared - # request, use the old one that we haven't yet touched. - extract_cookies_to_jar(prepared_request._cookies, req, resp.raw) - prepared_request._cookies.update(self.cookies) - prepared_request.prepare_cookies(prepared_request._cookies) - - # Rebuild auth and proxy information. - proxies = self.rebuild_proxies(prepared_request, proxies) - self.rebuild_auth(prepared_request, resp) - - # Override the original request. - req = prepared_request - - resp = self.send( - req, - stream=stream, - timeout=timeout, - verify=verify, - cert=cert, - proxies=proxies, - allow_redirects=False, - **adapter_kwargs - ) - - extract_cookies_to_jar(self.cookies, prepared_request, resp.raw) - - i += 1 - yield resp - - def rebuild_auth(self, prepared_request, response): - """ - When being redirected we may want to strip authentication from the - request to avoid leaking credentials. This method intelligently removes - and reapplies authentication where possible to avoid credential loss. - """ - headers = prepared_request.headers - url = prepared_request.url - - if 'Authorization' in headers: - # If we get redirected to a new host, we should strip out any - # authentication headers. - original_parsed = urlparse(response.request.url) - redirect_parsed = urlparse(url) - - if (original_parsed.hostname != redirect_parsed.hostname): - del headers['Authorization'] - - # .netrc might have more auth for us on our new host. - new_auth = get_netrc_auth(url) if self.trust_env else None - if new_auth is not None: - prepared_request.prepare_auth(new_auth) - - return - - def rebuild_proxies(self, prepared_request, proxies): - """ - This method re-evaluates the proxy configuration by considering the - environment variables. If we are redirected to a URL covered by - NO_PROXY, we strip the proxy configuration. Otherwise, we set missing - proxy keys for this URL (in case they were stripped by a previous - redirect). - - This method also replaces the Proxy-Authorization header where - necessary. - """ - headers = prepared_request.headers - url = prepared_request.url - scheme = urlparse(url).scheme - new_proxies = proxies.copy() if proxies is not None else {} - - if self.trust_env and not should_bypass_proxies(url): - environ_proxies = get_environ_proxies(url) - - proxy = environ_proxies.get(scheme) - - if proxy: - new_proxies.setdefault(scheme, environ_proxies[scheme]) - - if 'Proxy-Authorization' in headers: - del headers['Proxy-Authorization'] - - try: - username, password = get_auth_from_url(new_proxies[scheme]) - except KeyError: - username, password = None, None - - if username and password: - headers['Proxy-Authorization'] = _basic_auth_str(username, password) - - return new_proxies - - -class Session(SessionRedirectMixin): - """A Requests session. - - Provides cookie persistence, connection-pooling, and configuration. - - Basic Usage:: - - >>> import requests - >>> s = requests.Session() - >>> s.get('http://httpbin.org/get') - 200 - """ - - __attrs__ = [ - 'headers', 'cookies', 'auth', 'proxies', 'hooks', 'params', 'verify', - 'cert', 'prefetch', 'adapters', 'stream', 'trust_env', - 'max_redirects', - ] - - def __init__(self): - - #: A case-insensitive dictionary of headers to be sent on each - #: :class:`Request ` sent from this - #: :class:`Session `. - self.headers = default_headers() - - #: Default Authentication tuple or object to attach to - #: :class:`Request `. - self.auth = None - - #: Dictionary mapping protocol to the URL of the proxy (e.g. - #: {'http': 'foo.bar:3128'}) to be used on each - #: :class:`Request `. - self.proxies = {} - - #: Event-handling hooks. - self.hooks = default_hooks() - - #: Dictionary of querystring data to attach to each - #: :class:`Request `. The dictionary values may be lists for - #: representing multivalued query parameters. - self.params = {} - - #: Stream response content default. - self.stream = False - - #: SSL Verification default. - self.verify = True - - #: SSL certificate default. - self.cert = None - - #: Maximum number of redirects allowed. If the request exceeds this - #: limit, a :class:`TooManyRedirects` exception is raised. - self.max_redirects = DEFAULT_REDIRECT_LIMIT - - #: Should we trust the environment? - self.trust_env = True - - #: A CookieJar containing all currently outstanding cookies set on this - #: session. By default it is a - #: :class:`RequestsCookieJar `, but - #: may be any other ``cookielib.CookieJar`` compatible object. - self.cookies = cookiejar_from_dict({}) - - # Default connection adapters. - self.adapters = OrderedDict() - self.mount('https://', HTTPAdapter()) - self.mount('http://', HTTPAdapter()) - - # Only store 1000 redirects to prevent using infinite memory - self.redirect_cache = RecentlyUsedContainer(REDIRECT_CACHE_SIZE) - - def __enter__(self): - return self - - def __exit__(self, *args): - self.close() - - def prepare_request(self, request): - """Constructs a :class:`PreparedRequest ` for - transmission and returns it. The :class:`PreparedRequest` has settings - merged from the :class:`Request ` instance and those of the - :class:`Session`. - - :param request: :class:`Request` instance to prepare with this - session's settings. - """ - cookies = request.cookies or {} - - # Bootstrap CookieJar. - if not isinstance(cookies, cookielib.CookieJar): - cookies = cookiejar_from_dict(cookies) - - # Merge with session cookies - merged_cookies = merge_cookies( - merge_cookies(RequestsCookieJar(), self.cookies), cookies) - - - # Set environment's basic authentication if not explicitly set. - auth = request.auth - if self.trust_env and not auth and not self.auth: - auth = get_netrc_auth(request.url) - - p = PreparedRequest() - p.prepare( - method=request.method.upper(), - url=request.url, - files=request.files, - data=request.data, - json=request.json, - headers=merge_setting(request.headers, self.headers, dict_class=CaseInsensitiveDict), - params=merge_setting(request.params, self.params), - auth=merge_setting(auth, self.auth), - cookies=merged_cookies, - hooks=merge_hooks(request.hooks, self.hooks), - ) - return p - - def request(self, method, url, - params=None, - data=None, - headers=None, - cookies=None, - files=None, - auth=None, - timeout=None, - allow_redirects=True, - proxies=None, - hooks=None, - stream=None, - verify=None, - cert=None, - json=None): - """Constructs a :class:`Request `, prepares it and sends it. - Returns :class:`Response ` object. - - :param method: method for the new :class:`Request` object. - :param url: URL for the new :class:`Request` object. - :param params: (optional) Dictionary or bytes to be sent in the query - string for the :class:`Request`. - :param data: (optional) Dictionary or bytes to send in the body of the - :class:`Request`. - :param json: (optional) json to send in the body of the - :class:`Request`. - :param headers: (optional) Dictionary of HTTP Headers to send with the - :class:`Request`. - :param cookies: (optional) Dict or CookieJar object to send with the - :class:`Request`. - :param files: (optional) Dictionary of ``'filename': file-like-objects`` - for multipart encoding upload. - :param auth: (optional) Auth tuple or callable to enable - Basic/Digest/Custom HTTP Auth. - :param timeout: (optional) How long to wait for the server to send - data before giving up, as a float, or a (`connect timeout, read - timeout `_) tuple. - :type timeout: float or tuple - :param allow_redirects: (optional) Set to True by default. - :type allow_redirects: bool - :param proxies: (optional) Dictionary mapping protocol to the URL of - the proxy. - :param stream: (optional) whether to immediately download the response - content. Defaults to ``False``. - :param verify: (optional) if ``True``, the SSL cert will be verified. - A CA_BUNDLE path can also be provided. - :param cert: (optional) if String, path to ssl client cert file (.pem). - If Tuple, ('cert', 'key') pair. - """ - - method = to_native_string(method) - - # Create the Request. - req = Request( - method = method.upper(), - url = url, - headers = headers, - files = files, - data = data or {}, - json = json, - params = params or {}, - auth = auth, - cookies = cookies, - hooks = hooks, - ) - prep = self.prepare_request(req) - - proxies = proxies or {} - - settings = self.merge_environment_settings( - prep.url, proxies, stream, verify, cert - ) - - # Send the request. - send_kwargs = { - 'timeout': timeout, - 'allow_redirects': allow_redirects, - } - send_kwargs.update(settings) - resp = self.send(prep, **send_kwargs) - - return resp - - def get(self, url, **kwargs): - """Sends a GET request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - kwargs.setdefault('allow_redirects', True) - return self.request('GET', url, **kwargs) - - def options(self, url, **kwargs): - """Sends a OPTIONS request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - kwargs.setdefault('allow_redirects', True) - return self.request('OPTIONS', url, **kwargs) - - def head(self, url, **kwargs): - """Sends a HEAD request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - kwargs.setdefault('allow_redirects', False) - return self.request('HEAD', url, **kwargs) - - def post(self, url, data=None, json=None, **kwargs): - """Sends a POST request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param json: (optional) json to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - return self.request('POST', url, data=data, json=json, **kwargs) - - def put(self, url, data=None, **kwargs): - """Sends a PUT request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - return self.request('PUT', url, data=data, **kwargs) - - def patch(self, url, data=None, **kwargs): - """Sends a PATCH request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - return self.request('PATCH', url, data=data, **kwargs) - - def delete(self, url, **kwargs): - """Sends a DELETE request. Returns :class:`Response` object. - - :param url: URL for the new :class:`Request` object. - :param \*\*kwargs: Optional arguments that ``request`` takes. - """ - - return self.request('DELETE', url, **kwargs) - - def send(self, request, **kwargs): - """Send a given PreparedRequest.""" - # Set defaults that the hooks can utilize to ensure they always have - # the correct parameters to reproduce the previous request. - kwargs.setdefault('stream', self.stream) - kwargs.setdefault('verify', self.verify) - kwargs.setdefault('cert', self.cert) - kwargs.setdefault('proxies', self.proxies) - - # It's possible that users might accidentally send a Request object. - # Guard against that specific failure case. - if not isinstance(request, PreparedRequest): - raise ValueError('You can only send PreparedRequests.') - - checked_urls = set() - while request.url in self.redirect_cache: - checked_urls.add(request.url) - new_url = self.redirect_cache.get(request.url) - if new_url in checked_urls: - break - request.url = new_url - - # Set up variables needed for resolve_redirects and dispatching of hooks - allow_redirects = kwargs.pop('allow_redirects', True) - stream = kwargs.get('stream') - hooks = request.hooks - - # Get the appropriate adapter to use - adapter = self.get_adapter(url=request.url) - - # Start time (approximately) of the request - start = datetime.utcnow() - - # Send the request - r = adapter.send(request, **kwargs) - - # Total elapsed time of the request (approximately) - r.elapsed = datetime.utcnow() - start - - # Response manipulation hooks - r = dispatch_hook('response', hooks, r, **kwargs) - - # Persist cookies - if r.history: - - # If the hooks create history then we want those cookies too - for resp in r.history: - extract_cookies_to_jar(self.cookies, resp.request, resp.raw) - - extract_cookies_to_jar(self.cookies, request, r.raw) - - # Redirect resolving generator. - gen = self.resolve_redirects(r, request, **kwargs) - - # Resolve redirects if allowed. - history = [resp for resp in gen] if allow_redirects else [] - - # Shuffle things around if there's history. - if history: - # Insert the first (original) request at the start - history.insert(0, r) - # Get the last request made - r = history.pop() - r.history = history - - if not stream: - r.content - - return r - - def merge_environment_settings(self, url, proxies, stream, verify, cert): - """Check the environment and merge it with some settings.""" - # Gather clues from the surrounding environment. - if self.trust_env: - # Set environment's proxies. - env_proxies = get_environ_proxies(url) or {} - for (k, v) in env_proxies.items(): - proxies.setdefault(k, v) - - # Look for requests environment configuration and be compatible - # with cURL. - if verify is True or verify is None: - verify = (os.environ.get('REQUESTS_CA_BUNDLE') or - os.environ.get('CURL_CA_BUNDLE')) - - # Merge all the kwargs. - proxies = merge_setting(proxies, self.proxies) - stream = merge_setting(stream, self.stream) - verify = merge_setting(verify, self.verify) - cert = merge_setting(cert, self.cert) - - return {'verify': verify, 'proxies': proxies, 'stream': stream, - 'cert': cert} - - def get_adapter(self, url): - """Returns the appropriate connnection adapter for the given URL.""" - for (prefix, adapter) in self.adapters.items(): - - if url.lower().startswith(prefix): - return adapter - - # Nothing matches :-/ - raise InvalidSchema("No connection adapters were found for '%s'" % url) - - def close(self): - """Closes all adapters and as such the session""" - for v in self.adapters.values(): - v.close() - - def mount(self, prefix, adapter): - """Registers a connection adapter to a prefix. - - Adapters are sorted in descending order by key length.""" - - self.adapters[prefix] = adapter - keys_to_move = [k for k in self.adapters if len(k) < len(prefix)] - - for key in keys_to_move: - self.adapters[key] = self.adapters.pop(key) - - def __getstate__(self): - state = dict((attr, getattr(self, attr, None)) for attr in self.__attrs__) - state['redirect_cache'] = dict(self.redirect_cache) - return state - - def __setstate__(self, state): - redirect_cache = state.pop('redirect_cache', {}) - for attr, value in state.items(): - setattr(self, attr, value) - - self.redirect_cache = RecentlyUsedContainer(REDIRECT_CACHE_SIZE) - for redirect, to in redirect_cache.items(): - self.redirect_cache[redirect] = to - - -def session(): - """Returns a :class:`Session` for context-management.""" - - return Session() diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/status_codes.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/status_codes.py deleted file mode 100644 index e0887f21..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/status_codes.py +++ /dev/null @@ -1,89 +0,0 @@ -# -*- coding: utf-8 -*- - -from .structures import LookupDict - -_codes = { - - # Informational. - 100: ('continue',), - 101: ('switching_protocols',), - 102: ('processing',), - 103: ('checkpoint',), - 122: ('uri_too_long', 'request_uri_too_long'), - 200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'), - 201: ('created',), - 202: ('accepted',), - 203: ('non_authoritative_info', 'non_authoritative_information'), - 204: ('no_content',), - 205: ('reset_content', 'reset'), - 206: ('partial_content', 'partial'), - 207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'), - 208: ('already_reported',), - 226: ('im_used',), - - # Redirection. - 300: ('multiple_choices',), - 301: ('moved_permanently', 'moved', '\\o-'), - 302: ('found',), - 303: ('see_other', 'other'), - 304: ('not_modified',), - 305: ('use_proxy',), - 306: ('switch_proxy',), - 307: ('temporary_redirect', 'temporary_moved', 'temporary'), - 308: ('permanent_redirect', - 'resume_incomplete', 'resume',), # These 2 to be removed in 3.0 - - # Client Error. - 400: ('bad_request', 'bad'), - 401: ('unauthorized',), - 402: ('payment_required', 'payment'), - 403: ('forbidden',), - 404: ('not_found', '-o-'), - 405: ('method_not_allowed', 'not_allowed'), - 406: ('not_acceptable',), - 407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'), - 408: ('request_timeout', 'timeout'), - 409: ('conflict',), - 410: ('gone',), - 411: ('length_required',), - 412: ('precondition_failed', 'precondition'), - 413: ('request_entity_too_large',), - 414: ('request_uri_too_large',), - 415: ('unsupported_media_type', 'unsupported_media', 'media_type'), - 416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'), - 417: ('expectation_failed',), - 418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'), - 422: ('unprocessable_entity', 'unprocessable'), - 423: ('locked',), - 424: ('failed_dependency', 'dependency'), - 425: ('unordered_collection', 'unordered'), - 426: ('upgrade_required', 'upgrade'), - 428: ('precondition_required', 'precondition'), - 429: ('too_many_requests', 'too_many'), - 431: ('header_fields_too_large', 'fields_too_large'), - 444: ('no_response', 'none'), - 449: ('retry_with', 'retry'), - 450: ('blocked_by_windows_parental_controls', 'parental_controls'), - 451: ('unavailable_for_legal_reasons', 'legal_reasons'), - 499: ('client_closed_request',), - - # Server Error. - 500: ('internal_server_error', 'server_error', '/o\\', '✗'), - 501: ('not_implemented',), - 502: ('bad_gateway',), - 503: ('service_unavailable', 'unavailable'), - 504: ('gateway_timeout',), - 505: ('http_version_not_supported', 'http_version'), - 506: ('variant_also_negotiates',), - 507: ('insufficient_storage',), - 509: ('bandwidth_limit_exceeded', 'bandwidth'), - 510: ('not_extended',), -} - -codes = LookupDict(name='status_codes') - -for (code, titles) in list(_codes.items()): - for title in titles: - setattr(codes, title, code) - if not title.startswith('\\'): - setattr(codes, title.upper(), code) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/structures.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/structures.py deleted file mode 100644 index 3e5f2faa..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/structures.py +++ /dev/null @@ -1,104 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.structures -~~~~~~~~~~~~~~~~~~~ - -Data structures that power Requests. - -""" - -import collections - - -class CaseInsensitiveDict(collections.MutableMapping): - """ - A case-insensitive ``dict``-like object. - - Implements all methods and operations of - ``collections.MutableMapping`` as well as dict's ``copy``. Also - provides ``lower_items``. - - All keys are expected to be strings. The structure remembers the - case of the last key to be set, and ``iter(instance)``, - ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()`` - will contain case-sensitive keys. However, querying and contains - testing is case insensitive:: - - cid = CaseInsensitiveDict() - cid['Accept'] = 'application/json' - cid['aCCEPT'] == 'application/json' # True - list(cid) == ['Accept'] # True - - For example, ``headers['content-encoding']`` will return the - value of a ``'Content-Encoding'`` response header, regardless - of how the header name was originally stored. - - If the constructor, ``.update``, or equality comparison - operations are given keys that have equal ``.lower()``s, the - behavior is undefined. - - """ - def __init__(self, data=None, **kwargs): - self._store = dict() - if data is None: - data = {} - self.update(data, **kwargs) - - def __setitem__(self, key, value): - # Use the lowercased key for lookups, but store the actual - # key alongside the value. - self._store[key.lower()] = (key, value) - - def __getitem__(self, key): - return self._store[key.lower()][1] - - def __delitem__(self, key): - del self._store[key.lower()] - - def __iter__(self): - return (casedkey for casedkey, mappedvalue in self._store.values()) - - def __len__(self): - return len(self._store) - - def lower_items(self): - """Like iteritems(), but with all lowercase keys.""" - return ( - (lowerkey, keyval[1]) - for (lowerkey, keyval) - in self._store.items() - ) - - def __eq__(self, other): - if isinstance(other, collections.Mapping): - other = CaseInsensitiveDict(other) - else: - return NotImplemented - # Compare insensitively - return dict(self.lower_items()) == dict(other.lower_items()) - - # Copy is required - def copy(self): - return CaseInsensitiveDict(self._store.values()) - - def __repr__(self): - return str(dict(self.items())) - -class LookupDict(dict): - """Dictionary lookup object.""" - - def __init__(self, name=None): - self.name = name - super(LookupDict, self).__init__() - - def __repr__(self): - return '' % (self.name) - - def __getitem__(self, key): - # We allow fall-through here, so values default to None - - return self.__dict__.get(key, None) - - def get(self, key, default=None): - return self.__dict__.get(key, default) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/utils.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/utils.py deleted file mode 100644 index 8fba62dd..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/requests/utils.py +++ /dev/null @@ -1,707 +0,0 @@ -# -*- coding: utf-8 -*- - -""" -requests.utils -~~~~~~~~~~~~~~ - -This module provides utility functions that are used within Requests -that are also useful for external consumption. - -""" - -import cgi -import codecs -import collections -import io -import os -import platform -import re -import sys -import socket -import struct -import warnings - -from . import __version__ -from . import certs -from .compat import parse_http_list as _parse_list_header -from .compat import (quote, urlparse, bytes, str, OrderedDict, unquote, is_py2, - builtin_str, getproxies, proxy_bypass, urlunparse, - basestring) -from .cookies import RequestsCookieJar, cookiejar_from_dict -from .structures import CaseInsensitiveDict -from .exceptions import InvalidURL - -_hush_pyflakes = (RequestsCookieJar,) - -NETRC_FILES = ('.netrc', '_netrc') - -DEFAULT_CA_BUNDLE_PATH = certs.where() - - -def dict_to_sequence(d): - """Returns an internal sequence dictionary update.""" - - if hasattr(d, 'items'): - d = d.items() - - return d - - -def super_len(o): - if hasattr(o, '__len__'): - return len(o) - - if hasattr(o, 'len'): - return o.len - - if hasattr(o, 'fileno'): - try: - fileno = o.fileno() - except io.UnsupportedOperation: - pass - else: - return os.fstat(fileno).st_size - - if hasattr(o, 'getvalue'): - # e.g. BytesIO, cStringIO.StringIO - return len(o.getvalue()) - - -def get_netrc_auth(url): - """Returns the Requests tuple auth for a given url from netrc.""" - - try: - from netrc import netrc, NetrcParseError - - netrc_path = None - - for f in NETRC_FILES: - try: - loc = os.path.expanduser('~/{0}'.format(f)) - except KeyError: - # os.path.expanduser can fail when $HOME is undefined and - # getpwuid fails. See http://bugs.python.org/issue20164 & - # https://github.com/kennethreitz/requests/issues/1846 - return - - if os.path.exists(loc): - netrc_path = loc - break - - # Abort early if there isn't one. - if netrc_path is None: - return - - ri = urlparse(url) - - # Strip port numbers from netloc - host = ri.netloc.split(':')[0] - - try: - _netrc = netrc(netrc_path).authenticators(host) - if _netrc: - # Return with login / password - login_i = (0 if _netrc[0] else 1) - return (_netrc[login_i], _netrc[2]) - except (NetrcParseError, IOError): - # If there was a parsing error or a permissions issue reading the file, - # we'll just skip netrc auth - pass - - # AppEngine hackiness. - except (ImportError, AttributeError): - pass - - -def guess_filename(obj): - """Tries to guess the filename of the given object.""" - name = getattr(obj, 'name', None) - if (name and isinstance(name, basestring) and name[0] != '<' and - name[-1] != '>'): - return os.path.basename(name) - - -def from_key_val_list(value): - """Take an object and test to see if it can be represented as a - dictionary. Unless it can not be represented as such, return an - OrderedDict, e.g., - - :: - - >>> from_key_val_list([('key', 'val')]) - OrderedDict([('key', 'val')]) - >>> from_key_val_list('string') - ValueError: need more than 1 value to unpack - >>> from_key_val_list({'key': 'val'}) - OrderedDict([('key', 'val')]) - """ - if value is None: - return None - - if isinstance(value, (str, bytes, bool, int)): - raise ValueError('cannot encode objects that are not 2-tuples') - - return OrderedDict(value) - - -def to_key_val_list(value): - """Take an object and test to see if it can be represented as a - dictionary. If it can be, return a list of tuples, e.g., - - :: - - >>> to_key_val_list([('key', 'val')]) - [('key', 'val')] - >>> to_key_val_list({'key': 'val'}) - [('key', 'val')] - >>> to_key_val_list('string') - ValueError: cannot encode objects that are not 2-tuples. - """ - if value is None: - return None - - if isinstance(value, (str, bytes, bool, int)): - raise ValueError('cannot encode objects that are not 2-tuples') - - if isinstance(value, collections.Mapping): - value = value.items() - - return list(value) - - -# From mitsuhiko/werkzeug (used with permission). -def parse_list_header(value): - """Parse lists as described by RFC 2068 Section 2. - - In particular, parse comma-separated lists where the elements of - the list may include quoted-strings. A quoted-string could - contain a comma. A non-quoted string could have quotes in the - middle. Quotes are removed automatically after parsing. - - It basically works like :func:`parse_set_header` just that items - may appear multiple times and case sensitivity is preserved. - - The return value is a standard :class:`list`: - - >>> parse_list_header('token, "quoted value"') - ['token', 'quoted value'] - - To create a header from the :class:`list` again, use the - :func:`dump_header` function. - - :param value: a string with a list header. - :return: :class:`list` - """ - result = [] - for item in _parse_list_header(value): - if item[:1] == item[-1:] == '"': - item = unquote_header_value(item[1:-1]) - result.append(item) - return result - - -# From mitsuhiko/werkzeug (used with permission). -def parse_dict_header(value): - """Parse lists of key, value pairs as described by RFC 2068 Section 2 and - convert them into a python dict: - - >>> d = parse_dict_header('foo="is a fish", bar="as well"') - >>> type(d) is dict - True - >>> sorted(d.items()) - [('bar', 'as well'), ('foo', 'is a fish')] - - If there is no value for a key it will be `None`: - - >>> parse_dict_header('key_without_value') - {'key_without_value': None} - - To create a header from the :class:`dict` again, use the - :func:`dump_header` function. - - :param value: a string with a dict header. - :return: :class:`dict` - """ - result = {} - for item in _parse_list_header(value): - if '=' not in item: - result[item] = None - continue - name, value = item.split('=', 1) - if value[:1] == value[-1:] == '"': - value = unquote_header_value(value[1:-1]) - result[name] = value - return result - - -# From mitsuhiko/werkzeug (used with permission). -def unquote_header_value(value, is_filename=False): - r"""Unquotes a header value. (Reversal of :func:`quote_header_value`). - This does not use the real unquoting but what browsers are actually - using for quoting. - - :param value: the header value to unquote. - """ - if value and value[0] == value[-1] == '"': - # this is not the real unquoting, but fixing this so that the - # RFC is met will result in bugs with internet explorer and - # probably some other browsers as well. IE for example is - # uploading files with "C:\foo\bar.txt" as filename - value = value[1:-1] - - # if this is a filename and the starting characters look like - # a UNC path, then just return the value without quotes. Using the - # replace sequence below on a UNC path has the effect of turning - # the leading double slash into a single slash and then - # _fix_ie_filename() doesn't work correctly. See #458. - if not is_filename or value[:2] != '\\\\': - return value.replace('\\\\', '\\').replace('\\"', '"') - return value - - -def dict_from_cookiejar(cj): - """Returns a key/value dictionary from a CookieJar. - - :param cj: CookieJar object to extract cookies from. - """ - - cookie_dict = {} - - for cookie in cj: - cookie_dict[cookie.name] = cookie.value - - return cookie_dict - - -def add_dict_to_cookiejar(cj, cookie_dict): - """Returns a CookieJar from a key/value dictionary. - - :param cj: CookieJar to insert cookies into. - :param cookie_dict: Dict of key/values to insert into CookieJar. - """ - - cj2 = cookiejar_from_dict(cookie_dict) - cj.update(cj2) - return cj - - -def get_encodings_from_content(content): - """Returns encodings from given content string. - - :param content: bytestring to extract encodings from. - """ - warnings.warn(( - 'In requests 3.0, get_encodings_from_content will be removed. For ' - 'more information, please see the discussion on issue #2266. (This' - ' warning should only appear once.)'), - DeprecationWarning) - - charset_re = re.compile(r']', flags=re.I) - pragma_re = re.compile(r']', flags=re.I) - xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]') - - return (charset_re.findall(content) + - pragma_re.findall(content) + - xml_re.findall(content)) - - -def get_encoding_from_headers(headers): - """Returns encodings from given HTTP Header Dict. - - :param headers: dictionary to extract encoding from. - """ - - content_type = headers.get('content-type') - - if not content_type: - return None - - content_type, params = cgi.parse_header(content_type) - - if 'charset' in params: - return params['charset'].strip("'\"") - - if 'text' in content_type: - return 'ISO-8859-1' - - -def stream_decode_response_unicode(iterator, r): - """Stream decodes a iterator.""" - - if r.encoding is None: - for item in iterator: - yield item - return - - decoder = codecs.getincrementaldecoder(r.encoding)(errors='replace') - for chunk in iterator: - rv = decoder.decode(chunk) - if rv: - yield rv - rv = decoder.decode(b'', final=True) - if rv: - yield rv - - -def iter_slices(string, slice_length): - """Iterate over slices of a string.""" - pos = 0 - while pos < len(string): - yield string[pos:pos + slice_length] - pos += slice_length - - -def get_unicode_from_response(r): - """Returns the requested content back in unicode. - - :param r: Response object to get unicode content from. - - Tried: - - 1. charset from content-type - 2. fall back and replace all unicode characters - - """ - warnings.warn(( - 'In requests 3.0, get_unicode_from_response will be removed. For ' - 'more information, please see the discussion on issue #2266. (This' - ' warning should only appear once.)'), - DeprecationWarning) - - tried_encodings = [] - - # Try charset from content-type - encoding = get_encoding_from_headers(r.headers) - - if encoding: - try: - return str(r.content, encoding) - except UnicodeError: - tried_encodings.append(encoding) - - # Fall back: - try: - return str(r.content, encoding, errors='replace') - except TypeError: - return r.content - - -# The unreserved URI characters (RFC 3986) -UNRESERVED_SET = frozenset( - "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" - + "0123456789-._~") - - -def unquote_unreserved(uri): - """Un-escape any percent-escape sequences in a URI that are unreserved - characters. This leaves all reserved, illegal and non-ASCII bytes encoded. - """ - parts = uri.split('%') - for i in range(1, len(parts)): - h = parts[i][0:2] - if len(h) == 2 and h.isalnum(): - try: - c = chr(int(h, 16)) - except ValueError: - raise InvalidURL("Invalid percent-escape sequence: '%s'" % h) - - if c in UNRESERVED_SET: - parts[i] = c + parts[i][2:] - else: - parts[i] = '%' + parts[i] - else: - parts[i] = '%' + parts[i] - return ''.join(parts) - - -def requote_uri(uri): - """Re-quote the given URI. - - This function passes the given URI through an unquote/quote cycle to - ensure that it is fully and consistently quoted. - """ - safe_with_percent = "!#$%&'()*+,/:;=?@[]~" - safe_without_percent = "!#$&'()*+,/:;=?@[]~" - try: - # Unquote only the unreserved characters - # Then quote only illegal characters (do not quote reserved, - # unreserved, or '%') - return quote(unquote_unreserved(uri), safe=safe_with_percent) - except InvalidURL: - # We couldn't unquote the given URI, so let's try quoting it, but - # there may be unquoted '%'s in the URI. We need to make sure they're - # properly quoted so they do not cause issues elsewhere. - return quote(uri, safe=safe_without_percent) - - -def address_in_network(ip, net): - """ - This function allows you to check if on IP belongs to a network subnet - Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24 - returns False if ip = 192.168.1.1 and net = 192.168.100.0/24 - """ - ipaddr = struct.unpack('=L', socket.inet_aton(ip))[0] - netaddr, bits = net.split('/') - netmask = struct.unpack('=L', socket.inet_aton(dotted_netmask(int(bits))))[0] - network = struct.unpack('=L', socket.inet_aton(netaddr))[0] & netmask - return (ipaddr & netmask) == (network & netmask) - - -def dotted_netmask(mask): - """ - Converts mask from /xx format to xxx.xxx.xxx.xxx - Example: if mask is 24 function returns 255.255.255.0 - """ - bits = 0xffffffff ^ (1 << 32 - mask) - 1 - return socket.inet_ntoa(struct.pack('>I', bits)) - - -def is_ipv4_address(string_ip): - try: - socket.inet_aton(string_ip) - except socket.error: - return False - return True - - -def is_valid_cidr(string_network): - """Very simple check of the cidr format in no_proxy variable""" - if string_network.count('/') == 1: - try: - mask = int(string_network.split('/')[1]) - except ValueError: - return False - - if mask < 1 or mask > 32: - return False - - try: - socket.inet_aton(string_network.split('/')[0]) - except socket.error: - return False - else: - return False - return True - - -def should_bypass_proxies(url): - """ - Returns whether we should bypass proxies or not. - """ - get_proxy = lambda k: os.environ.get(k) or os.environ.get(k.upper()) - - # First check whether no_proxy is defined. If it is, check that the URL - # we're getting isn't in the no_proxy list. - no_proxy = get_proxy('no_proxy') - netloc = urlparse(url).netloc - - if no_proxy: - # We need to check whether we match here. We need to see if we match - # the end of the netloc, both with and without the port. - no_proxy = no_proxy.replace(' ', '').split(',') - - ip = netloc.split(':')[0] - if is_ipv4_address(ip): - for proxy_ip in no_proxy: - if is_valid_cidr(proxy_ip): - if address_in_network(ip, proxy_ip): - return True - else: - for host in no_proxy: - if netloc.endswith(host) or netloc.split(':')[0].endswith(host): - # The URL does match something in no_proxy, so we don't want - # to apply the proxies on this URL. - return True - - # If the system proxy settings indicate that this URL should be bypassed, - # don't proxy. - # The proxy_bypass function is incredibly buggy on OS X in early versions - # of Python 2.6, so allow this call to fail. Only catch the specific - # exceptions we've seen, though: this call failing in other ways can reveal - # legitimate problems. - try: - bypass = proxy_bypass(netloc) - except (TypeError, socket.gaierror): - bypass = False - - if bypass: - return True - - return False - -def get_environ_proxies(url): - """Return a dict of environment proxies.""" - if should_bypass_proxies(url): - return {} - else: - return getproxies() - - -def default_user_agent(name="python-requests"): - """Return a string representing the default user agent.""" - _implementation = platform.python_implementation() - - if _implementation == 'CPython': - _implementation_version = platform.python_version() - elif _implementation == 'PyPy': - _implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major, - sys.pypy_version_info.minor, - sys.pypy_version_info.micro) - if sys.pypy_version_info.releaselevel != 'final': - _implementation_version = ''.join([_implementation_version, sys.pypy_version_info.releaselevel]) - elif _implementation == 'Jython': - _implementation_version = platform.python_version() # Complete Guess - elif _implementation == 'IronPython': - _implementation_version = platform.python_version() # Complete Guess - else: - _implementation_version = 'Unknown' - - try: - p_system = platform.system() - p_release = platform.release() - except IOError: - p_system = 'Unknown' - p_release = 'Unknown' - - return " ".join(['%s/%s' % (name, __version__), - '%s/%s' % (_implementation, _implementation_version), - '%s/%s' % (p_system, p_release)]) - - -def default_headers(): - return CaseInsensitiveDict({ - 'User-Agent': default_user_agent(), - 'Accept-Encoding': ', '.join(('gzip', 'deflate')), - 'Accept': '*/*', - 'Connection': 'keep-alive', - }) - - -def parse_header_links(value): - """Return a dict of parsed link headers proxies. - - i.e. Link: ; rel=front; type="image/jpeg",; rel=back;type="image/jpeg" - - """ - - links = [] - - replace_chars = " '\"" - - for val in re.split(", *<", value): - try: - url, params = val.split(";", 1) - except ValueError: - url, params = val, '' - - link = {} - - link["url"] = url.strip("<> '\"") - - for param in params.split(";"): - try: - key, value = param.split("=") - except ValueError: - break - - link[key.strip(replace_chars)] = value.strip(replace_chars) - - links.append(link) - - return links - - -# Null bytes; no need to recreate these on each call to guess_json_utf -_null = '\x00'.encode('ascii') # encoding to ASCII for Python 3 -_null2 = _null * 2 -_null3 = _null * 3 - - -def guess_json_utf(data): - # JSON always starts with two ASCII characters, so detection is as - # easy as counting the nulls and from their location and count - # determine the encoding. Also detect a BOM, if present. - sample = data[:4] - if sample in (codecs.BOM_UTF32_LE, codecs.BOM32_BE): - return 'utf-32' # BOM included - if sample[:3] == codecs.BOM_UTF8: - return 'utf-8-sig' # BOM included, MS style (discouraged) - if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE): - return 'utf-16' # BOM included - nullcount = sample.count(_null) - if nullcount == 0: - return 'utf-8' - if nullcount == 2: - if sample[::2] == _null2: # 1st and 3rd are null - return 'utf-16-be' - if sample[1::2] == _null2: # 2nd and 4th are null - return 'utf-16-le' - # Did not detect 2 valid UTF-16 ascii-range characters - if nullcount == 3: - if sample[:3] == _null3: - return 'utf-32-be' - if sample[1:] == _null3: - return 'utf-32-le' - # Did not detect a valid UTF-32 ascii-range character - return None - - -def prepend_scheme_if_needed(url, new_scheme): - '''Given a URL that may or may not have a scheme, prepend the given scheme. - Does not replace a present scheme with the one provided as an argument.''' - scheme, netloc, path, params, query, fragment = urlparse(url, new_scheme) - - # urlparse is a finicky beast, and sometimes decides that there isn't a - # netloc present. Assume that it's being over-cautious, and switch netloc - # and path if urlparse decided there was no netloc. - if not netloc: - netloc, path = path, netloc - - return urlunparse((scheme, netloc, path, params, query, fragment)) - - -def get_auth_from_url(url): - """Given a url with authentication components, extract them into a tuple of - username,password.""" - parsed = urlparse(url) - - try: - auth = (unquote(parsed.username), unquote(parsed.password)) - except (AttributeError, TypeError): - auth = ('', '') - - return auth - - -def to_native_string(string, encoding='ascii'): - """ - Given a string object, regardless of type, returns a representation of that - string in the native string type, encoding and decoding where necessary. - This assumes ASCII unless told otherwise. - """ - out = None - - if isinstance(string, builtin_str): - out = string - else: - if is_py2: - out = string.encode(encoding) - else: - out = string.decode(encoding) - - return out - - -def urldefragauth(url): - """ - Given a url remove the fragment and the authentication part - """ - scheme, netloc, path, params, query, fragment = urlparse(url) - - # see func:`prepend_scheme_if_needed` - if not netloc: - netloc, path = path, netloc - - netloc = netloc.rsplit('@', 1)[-1] - - return urlunparse((scheme, netloc, path, params, query, '')) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/six.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/six.py deleted file mode 100644 index 190c0239..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/vendored/six.py +++ /dev/null @@ -1,868 +0,0 @@ -"""Utilities for writing code that runs on Python 2 and 3""" - -# Copyright (c) 2010-2015 Benjamin Peterson -# -# Permission is hereby granted, free of charge, to any person obtaining a copy -# of this software and associated documentation files (the "Software"), to deal -# in the Software without restriction, including without limitation the rights -# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -# copies of the Software, and to permit persons to whom the Software is -# furnished to do so, subject to the following conditions: -# -# The above copyright notice and this permission notice shall be included in all -# copies or substantial portions of the Software. -# -# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -# SOFTWARE. - -from __future__ import absolute_import - -import functools -import itertools -import operator -import sys -import types - -__author__ = "Benjamin Peterson " -__version__ = "1.10.0" - - -# Useful for very coarse version differentiation. -PY2 = sys.version_info[0] == 2 -PY3 = sys.version_info[0] == 3 -PY34 = sys.version_info[0:2] >= (3, 4) - -if PY3: - string_types = str, - integer_types = int, - class_types = type, - text_type = str - binary_type = bytes - - MAXSIZE = sys.maxsize -else: - string_types = basestring, - integer_types = (int, long) - class_types = (type, types.ClassType) - text_type = unicode - binary_type = str - - if sys.platform.startswith("java"): - # Jython always uses 32 bits. - MAXSIZE = int((1 << 31) - 1) - else: - # It's possible to have sizeof(long) != sizeof(Py_ssize_t). - class X(object): - - def __len__(self): - return 1 << 31 - try: - len(X()) - except OverflowError: - # 32-bit - MAXSIZE = int((1 << 31) - 1) - else: - # 64-bit - MAXSIZE = int((1 << 63) - 1) - del X - - -def _add_doc(func, doc): - """Add documentation to a function.""" - func.__doc__ = doc - - -def _import_module(name): - """Import module, returning the module after the last dot.""" - __import__(name) - return sys.modules[name] - - -class _LazyDescr(object): - - def __init__(self, name): - self.name = name - - def __get__(self, obj, tp): - result = self._resolve() - setattr(obj, self.name, result) # Invokes __set__. - try: - # This is a bit ugly, but it avoids running this again by - # removing this descriptor. - delattr(obj.__class__, self.name) - except AttributeError: - pass - return result - - -class MovedModule(_LazyDescr): - - def __init__(self, name, old, new=None): - super(MovedModule, self).__init__(name) - if PY3: - if new is None: - new = name - self.mod = new - else: - self.mod = old - - def _resolve(self): - return _import_module(self.mod) - - def __getattr__(self, attr): - _module = self._resolve() - value = getattr(_module, attr) - setattr(self, attr, value) - return value - - -class _LazyModule(types.ModuleType): - - def __init__(self, name): - super(_LazyModule, self).__init__(name) - self.__doc__ = self.__class__.__doc__ - - def __dir__(self): - attrs = ["__doc__", "__name__"] - attrs += [attr.name for attr in self._moved_attributes] - return attrs - - # Subclasses should override this - _moved_attributes = [] - - -class MovedAttribute(_LazyDescr): - - def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): - super(MovedAttribute, self).__init__(name) - if PY3: - if new_mod is None: - new_mod = name - self.mod = new_mod - if new_attr is None: - if old_attr is None: - new_attr = name - else: - new_attr = old_attr - self.attr = new_attr - else: - self.mod = old_mod - if old_attr is None: - old_attr = name - self.attr = old_attr - - def _resolve(self): - module = _import_module(self.mod) - return getattr(module, self.attr) - - -class _SixMetaPathImporter(object): - - """ - A meta path importer to import six.moves and its submodules. - - This class implements a PEP302 finder and loader. It should be compatible - with Python 2.5 and all existing versions of Python3 - """ - - def __init__(self, six_module_name): - self.name = six_module_name - self.known_modules = {} - - def _add_module(self, mod, *fullnames): - for fullname in fullnames: - self.known_modules[self.name + "." + fullname] = mod - - def _get_module(self, fullname): - return self.known_modules[self.name + "." + fullname] - - def find_module(self, fullname, path=None): - if fullname in self.known_modules: - return self - return None - - def __get_module(self, fullname): - try: - return self.known_modules[fullname] - except KeyError: - raise ImportError("This loader does not know module " + fullname) - - def load_module(self, fullname): - try: - # in case of a reload - return sys.modules[fullname] - except KeyError: - pass - mod = self.__get_module(fullname) - if isinstance(mod, MovedModule): - mod = mod._resolve() - else: - mod.__loader__ = self - sys.modules[fullname] = mod - return mod - - def is_package(self, fullname): - """ - Return true, if the named module is a package. - - We need this method to get correct spec objects with - Python 3.4 (see PEP451) - """ - return hasattr(self.__get_module(fullname), "__path__") - - def get_code(self, fullname): - """Return None - - Required, if is_package is implemented""" - self.__get_module(fullname) # eventually raises ImportError - return None - get_source = get_code # same as get_code - -_importer = _SixMetaPathImporter(__name__) - - -class _MovedItems(_LazyModule): - - """Lazy loading of moved objects""" - __path__ = [] # mark as package - - -_moved_attributes = [ - MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), - MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), - MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"), - MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), - MovedAttribute("intern", "__builtin__", "sys"), - MovedAttribute("map", "itertools", "builtins", "imap", "map"), - MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), - MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), - MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), - MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"), - MovedAttribute("reduce", "__builtin__", "functools"), - MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), - MovedAttribute("StringIO", "StringIO", "io"), - MovedAttribute("UserDict", "UserDict", "collections"), - MovedAttribute("UserList", "UserList", "collections"), - MovedAttribute("UserString", "UserString", "collections"), - MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), - MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), - MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"), - MovedModule("builtins", "__builtin__"), - MovedModule("configparser", "ConfigParser"), - MovedModule("copyreg", "copy_reg"), - MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), - MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"), - MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), - MovedModule("http_cookies", "Cookie", "http.cookies"), - MovedModule("html_entities", "htmlentitydefs", "html.entities"), - MovedModule("html_parser", "HTMLParser", "html.parser"), - MovedModule("http_client", "httplib", "http.client"), - MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), - MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"), - MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), - MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), - MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), - MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), - MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), - MovedModule("cPickle", "cPickle", "pickle"), - MovedModule("queue", "Queue"), - MovedModule("reprlib", "repr"), - MovedModule("socketserver", "SocketServer"), - MovedModule("_thread", "thread", "_thread"), - MovedModule("tkinter", "Tkinter"), - MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), - MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), - MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), - MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), - MovedModule("tkinter_tix", "Tix", "tkinter.tix"), - MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), - MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), - MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), - MovedModule("tkinter_colorchooser", "tkColorChooser", - "tkinter.colorchooser"), - MovedModule("tkinter_commondialog", "tkCommonDialog", - "tkinter.commondialog"), - MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), - MovedModule("tkinter_font", "tkFont", "tkinter.font"), - MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), - MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", - "tkinter.simpledialog"), - MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), - MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), - MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), - MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), - MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), - MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), -] -# Add windows specific modules. -if sys.platform == "win32": - _moved_attributes += [ - MovedModule("winreg", "_winreg"), - ] - -for attr in _moved_attributes: - setattr(_MovedItems, attr.name, attr) - if isinstance(attr, MovedModule): - _importer._add_module(attr, "moves." + attr.name) -del attr - -_MovedItems._moved_attributes = _moved_attributes - -moves = _MovedItems(__name__ + ".moves") -_importer._add_module(moves, "moves") - - -class Module_six_moves_urllib_parse(_LazyModule): - - """Lazy loading of moved objects in six.moves.urllib_parse""" - - -_urllib_parse_moved_attributes = [ - MovedAttribute("ParseResult", "urlparse", "urllib.parse"), - MovedAttribute("SplitResult", "urlparse", "urllib.parse"), - MovedAttribute("parse_qs", "urlparse", "urllib.parse"), - MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), - MovedAttribute("urldefrag", "urlparse", "urllib.parse"), - MovedAttribute("urljoin", "urlparse", "urllib.parse"), - MovedAttribute("urlparse", "urlparse", "urllib.parse"), - MovedAttribute("urlsplit", "urlparse", "urllib.parse"), - MovedAttribute("urlunparse", "urlparse", "urllib.parse"), - MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), - MovedAttribute("quote", "urllib", "urllib.parse"), - MovedAttribute("quote_plus", "urllib", "urllib.parse"), - MovedAttribute("unquote", "urllib", "urllib.parse"), - MovedAttribute("unquote_plus", "urllib", "urllib.parse"), - MovedAttribute("urlencode", "urllib", "urllib.parse"), - MovedAttribute("splitquery", "urllib", "urllib.parse"), - MovedAttribute("splittag", "urllib", "urllib.parse"), - MovedAttribute("splituser", "urllib", "urllib.parse"), - MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), - MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), - MovedAttribute("uses_params", "urlparse", "urllib.parse"), - MovedAttribute("uses_query", "urlparse", "urllib.parse"), - MovedAttribute("uses_relative", "urlparse", "urllib.parse"), -] -for attr in _urllib_parse_moved_attributes: - setattr(Module_six_moves_urllib_parse, attr.name, attr) -del attr - -Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes - -_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), - "moves.urllib_parse", "moves.urllib.parse") - - -class Module_six_moves_urllib_error(_LazyModule): - - """Lazy loading of moved objects in six.moves.urllib_error""" - - -_urllib_error_moved_attributes = [ - MovedAttribute("URLError", "urllib2", "urllib.error"), - MovedAttribute("HTTPError", "urllib2", "urllib.error"), - MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), -] -for attr in _urllib_error_moved_attributes: - setattr(Module_six_moves_urllib_error, attr.name, attr) -del attr - -Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes - -_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), - "moves.urllib_error", "moves.urllib.error") - - -class Module_six_moves_urllib_request(_LazyModule): - - """Lazy loading of moved objects in six.moves.urllib_request""" - - -_urllib_request_moved_attributes = [ - MovedAttribute("urlopen", "urllib2", "urllib.request"), - MovedAttribute("install_opener", "urllib2", "urllib.request"), - MovedAttribute("build_opener", "urllib2", "urllib.request"), - MovedAttribute("pathname2url", "urllib", "urllib.request"), - MovedAttribute("url2pathname", "urllib", "urllib.request"), - MovedAttribute("getproxies", "urllib", "urllib.request"), - MovedAttribute("Request", "urllib2", "urllib.request"), - MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), - MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), - MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), - MovedAttribute("BaseHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), - MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), - MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), - MovedAttribute("FileHandler", "urllib2", "urllib.request"), - MovedAttribute("FTPHandler", "urllib2", "urllib.request"), - MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), - MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), - MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), - MovedAttribute("urlretrieve", "urllib", "urllib.request"), - MovedAttribute("urlcleanup", "urllib", "urllib.request"), - MovedAttribute("URLopener", "urllib", "urllib.request"), - MovedAttribute("FancyURLopener", "urllib", "urllib.request"), - MovedAttribute("proxy_bypass", "urllib", "urllib.request"), -] -for attr in _urllib_request_moved_attributes: - setattr(Module_six_moves_urllib_request, attr.name, attr) -del attr - -Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes - -_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), - "moves.urllib_request", "moves.urllib.request") - - -class Module_six_moves_urllib_response(_LazyModule): - - """Lazy loading of moved objects in six.moves.urllib_response""" - - -_urllib_response_moved_attributes = [ - MovedAttribute("addbase", "urllib", "urllib.response"), - MovedAttribute("addclosehook", "urllib", "urllib.response"), - MovedAttribute("addinfo", "urllib", "urllib.response"), - MovedAttribute("addinfourl", "urllib", "urllib.response"), -] -for attr in _urllib_response_moved_attributes: - setattr(Module_six_moves_urllib_response, attr.name, attr) -del attr - -Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes - -_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), - "moves.urllib_response", "moves.urllib.response") - - -class Module_six_moves_urllib_robotparser(_LazyModule): - - """Lazy loading of moved objects in six.moves.urllib_robotparser""" - - -_urllib_robotparser_moved_attributes = [ - MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), -] -for attr in _urllib_robotparser_moved_attributes: - setattr(Module_six_moves_urllib_robotparser, attr.name, attr) -del attr - -Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes - -_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), - "moves.urllib_robotparser", "moves.urllib.robotparser") - - -class Module_six_moves_urllib(types.ModuleType): - - """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" - __path__ = [] # mark as package - parse = _importer._get_module("moves.urllib_parse") - error = _importer._get_module("moves.urllib_error") - request = _importer._get_module("moves.urllib_request") - response = _importer._get_module("moves.urllib_response") - robotparser = _importer._get_module("moves.urllib_robotparser") - - def __dir__(self): - return ['parse', 'error', 'request', 'response', 'robotparser'] - -_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"), - "moves.urllib") - - -def add_move(move): - """Add an item to six.moves.""" - setattr(_MovedItems, move.name, move) - - -def remove_move(name): - """Remove item from six.moves.""" - try: - delattr(_MovedItems, name) - except AttributeError: - try: - del moves.__dict__[name] - except KeyError: - raise AttributeError("no such move, %r" % (name,)) - - -if PY3: - _meth_func = "__func__" - _meth_self = "__self__" - - _func_closure = "__closure__" - _func_code = "__code__" - _func_defaults = "__defaults__" - _func_globals = "__globals__" -else: - _meth_func = "im_func" - _meth_self = "im_self" - - _func_closure = "func_closure" - _func_code = "func_code" - _func_defaults = "func_defaults" - _func_globals = "func_globals" - - -try: - advance_iterator = next -except NameError: - def advance_iterator(it): - return it.next() -next = advance_iterator - - -try: - callable = callable -except NameError: - def callable(obj): - return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) - - -if PY3: - def get_unbound_function(unbound): - return unbound - - create_bound_method = types.MethodType - - def create_unbound_method(func, cls): - return func - - Iterator = object -else: - def get_unbound_function(unbound): - return unbound.im_func - - def create_bound_method(func, obj): - return types.MethodType(func, obj, obj.__class__) - - def create_unbound_method(func, cls): - return types.MethodType(func, None, cls) - - class Iterator(object): - - def next(self): - return type(self).__next__(self) - - callable = callable -_add_doc(get_unbound_function, - """Get the function out of a possibly unbound function""") - - -get_method_function = operator.attrgetter(_meth_func) -get_method_self = operator.attrgetter(_meth_self) -get_function_closure = operator.attrgetter(_func_closure) -get_function_code = operator.attrgetter(_func_code) -get_function_defaults = operator.attrgetter(_func_defaults) -get_function_globals = operator.attrgetter(_func_globals) - - -if PY3: - def iterkeys(d, **kw): - return iter(d.keys(**kw)) - - def itervalues(d, **kw): - return iter(d.values(**kw)) - - def iteritems(d, **kw): - return iter(d.items(**kw)) - - def iterlists(d, **kw): - return iter(d.lists(**kw)) - - viewkeys = operator.methodcaller("keys") - - viewvalues = operator.methodcaller("values") - - viewitems = operator.methodcaller("items") -else: - def iterkeys(d, **kw): - return d.iterkeys(**kw) - - def itervalues(d, **kw): - return d.itervalues(**kw) - - def iteritems(d, **kw): - return d.iteritems(**kw) - - def iterlists(d, **kw): - return d.iterlists(**kw) - - viewkeys = operator.methodcaller("viewkeys") - - viewvalues = operator.methodcaller("viewvalues") - - viewitems = operator.methodcaller("viewitems") - -_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") -_add_doc(itervalues, "Return an iterator over the values of a dictionary.") -_add_doc(iteritems, - "Return an iterator over the (key, value) pairs of a dictionary.") -_add_doc(iterlists, - "Return an iterator over the (key, [values]) pairs of a dictionary.") - - -if PY3: - def b(s): - return s.encode("latin-1") - - def u(s): - return s - unichr = chr - import struct - int2byte = struct.Struct(">B").pack - del struct - byte2int = operator.itemgetter(0) - indexbytes = operator.getitem - iterbytes = iter - import io - StringIO = io.StringIO - BytesIO = io.BytesIO - _assertCountEqual = "assertCountEqual" - if sys.version_info[1] <= 1: - _assertRaisesRegex = "assertRaisesRegexp" - _assertRegex = "assertRegexpMatches" - else: - _assertRaisesRegex = "assertRaisesRegex" - _assertRegex = "assertRegex" -else: - def b(s): - return s - # Workaround for standalone backslash - - def u(s): - return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape") - unichr = unichr - int2byte = chr - - def byte2int(bs): - return ord(bs[0]) - - def indexbytes(buf, i): - return ord(buf[i]) - iterbytes = functools.partial(itertools.imap, ord) - import StringIO - StringIO = BytesIO = StringIO.StringIO - _assertCountEqual = "assertItemsEqual" - _assertRaisesRegex = "assertRaisesRegexp" - _assertRegex = "assertRegexpMatches" -_add_doc(b, """Byte literal""") -_add_doc(u, """Text literal""") - - -def assertCountEqual(self, *args, **kwargs): - return getattr(self, _assertCountEqual)(*args, **kwargs) - - -def assertRaisesRegex(self, *args, **kwargs): - return getattr(self, _assertRaisesRegex)(*args, **kwargs) - - -def assertRegex(self, *args, **kwargs): - return getattr(self, _assertRegex)(*args, **kwargs) - - -if PY3: - exec_ = getattr(moves.builtins, "exec") - - def reraise(tp, value, tb=None): - if value is None: - value = tp() - if value.__traceback__ is not tb: - raise value.with_traceback(tb) - raise value - -else: - def exec_(_code_, _globs_=None, _locs_=None): - """Execute code in a namespace.""" - if _globs_ is None: - frame = sys._getframe(1) - _globs_ = frame.f_globals - if _locs_ is None: - _locs_ = frame.f_locals - del frame - elif _locs_ is None: - _locs_ = _globs_ - exec("""exec _code_ in _globs_, _locs_""") - - exec_("""def reraise(tp, value, tb=None): - raise tp, value, tb -""") - - -if sys.version_info[:2] == (3, 2): - exec_("""def raise_from(value, from_value): - if from_value is None: - raise value - raise value from from_value -""") -elif sys.version_info[:2] > (3, 2): - exec_("""def raise_from(value, from_value): - raise value from from_value -""") -else: - def raise_from(value, from_value): - raise value - - -print_ = getattr(moves.builtins, "print", None) -if print_ is None: - def print_(*args, **kwargs): - """The new-style print function for Python 2.4 and 2.5.""" - fp = kwargs.pop("file", sys.stdout) - if fp is None: - return - - def write(data): - if not isinstance(data, basestring): - data = str(data) - # If the file has an encoding, encode unicode with it. - if (isinstance(fp, file) and - isinstance(data, unicode) and - fp.encoding is not None): - errors = getattr(fp, "errors", None) - if errors is None: - errors = "strict" - data = data.encode(fp.encoding, errors) - fp.write(data) - want_unicode = False - sep = kwargs.pop("sep", None) - if sep is not None: - if isinstance(sep, unicode): - want_unicode = True - elif not isinstance(sep, str): - raise TypeError("sep must be None or a string") - end = kwargs.pop("end", None) - if end is not None: - if isinstance(end, unicode): - want_unicode = True - elif not isinstance(end, str): - raise TypeError("end must be None or a string") - if kwargs: - raise TypeError("invalid keyword arguments to print()") - if not want_unicode: - for arg in args: - if isinstance(arg, unicode): - want_unicode = True - break - if want_unicode: - newline = unicode("\n") - space = unicode(" ") - else: - newline = "\n" - space = " " - if sep is None: - sep = space - if end is None: - end = newline - for i, arg in enumerate(args): - if i: - write(sep) - write(arg) - write(end) -if sys.version_info[:2] < (3, 3): - _print = print_ - - def print_(*args, **kwargs): - fp = kwargs.get("file", sys.stdout) - flush = kwargs.pop("flush", False) - _print(*args, **kwargs) - if flush and fp is not None: - fp.flush() - -_add_doc(reraise, """Reraise an exception.""") - -if sys.version_info[0:2] < (3, 4): - def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS, - updated=functools.WRAPPER_UPDATES): - def wrapper(f): - f = functools.wraps(wrapped, assigned, updated)(f) - f.__wrapped__ = wrapped - return f - return wrapper -else: - wraps = functools.wraps - - -def with_metaclass(meta, *bases): - """Create a base class with a metaclass.""" - # This requires a bit of explanation: the basic idea is to make a dummy - # metaclass for one level of class instantiation that replaces itself with - # the actual metaclass. - class metaclass(meta): - - def __new__(cls, name, this_bases, d): - return meta(name, bases, d) - return type.__new__(metaclass, 'temporary_class', (), {}) - - -def add_metaclass(metaclass): - """Class decorator for creating a class with a metaclass.""" - def wrapper(cls): - orig_vars = cls.__dict__.copy() - slots = orig_vars.get('__slots__') - if slots is not None: - if isinstance(slots, str): - slots = [slots] - for slots_var in slots: - orig_vars.pop(slots_var) - orig_vars.pop('__dict__', None) - orig_vars.pop('__weakref__', None) - return metaclass(cls.__name__, cls.__bases__, orig_vars) - return wrapper - - -def python_2_unicode_compatible(klass): - """ - A decorator that defines __unicode__ and __str__ methods under Python 2. - Under Python 3 it does nothing. - - To support Python 2 and 3 with a single code base, define a __str__ method - returning text and apply this decorator to the class. - """ - if PY2: - if '__str__' not in klass.__dict__: - raise ValueError("@python_2_unicode_compatible cannot be applied " - "to %s because it doesn't define __str__()." % - klass.__name__) - klass.__unicode__ = klass.__str__ - klass.__str__ = lambda self: self.__unicode__().encode('utf-8') - return klass - - -# Complete the moves implementation. -# This code is at the end of this module to speed up module loading. -# Turn this module into a package. -__path__ = [] # required for PEP 302 and PEP 451 -__package__ = __name__ # see PEP 366 @ReservedAssignment -if globals().get("__spec__") is not None: - __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable -# Remove other six meta path importers, since they cause problems. This can -# happen if six is removed from sys.modules and then reloaded. (Setuptools does -# this for some reason.) -if sys.meta_path: - for i, importer in enumerate(sys.meta_path): - # Here's some real nastiness: Another "instance" of the six module might - # be floating around. Therefore, we can't use isinstance() to check for - # the six meta path importer, since the other six instance will have - # inserted an importer with different class. - if (type(importer).__name__ == "_SixMetaPathImporter" and - importer.name == __name__): - del sys.meta_path[i] - break - del i, importer -# Finally, add the importer to the meta path import hook. -sys.meta_path.append(_importer) diff --git a/.eggs/botocore-1.10.75-py2.7.egg/botocore/waiter.py b/.eggs/botocore-1.10.75-py2.7.egg/botocore/waiter.py deleted file mode 100644 index bc51facf..00000000 --- a/.eggs/botocore-1.10.75-py2.7.egg/botocore/waiter.py +++ /dev/null @@ -1,331 +0,0 @@ -# Copyright 2012-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"). You -# may not use this file except in compliance with the License. A copy of -# the License is located at -# -# http://aws.amazon.com/apache2.0/ -# -# or in the "license" file accompanying this file. This file is -# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF -# ANY KIND, either express or implied. See the License for the specific -# language governing permissions and limitations under the License. -import jmespath -import logging -import time - -from botocore.utils import get_service_module_name -from botocore.docs.docstring import WaiterDocstring -from .exceptions import WaiterError, ClientError, WaiterConfigError -from . import xform_name - - -logger = logging.getLogger(__name__) - - -def create_waiter_with_client(waiter_name, waiter_model, client): - """ - - :type waiter_name: str - :param waiter_name: The name of the waiter. The name should match - the name (including the casing) of the key name in the waiter - model file (typically this is CamelCasing). - - :type waiter_model: botocore.waiter.WaiterModel - :param waiter_model: The model for the waiter configuration. - - :type client: botocore.client.BaseClient - :param client: The botocore client associated with the service. - - :rtype: botocore.waiter.Waiter - :return: The waiter object. - - """ - single_waiter_config = waiter_model.get_waiter(waiter_name) - operation_name = xform_name(single_waiter_config.operation) - operation_method = NormalizedOperationMethod( - getattr(client, operation_name)) - - # Create a new wait method that will serve as a proxy to the underlying - # Waiter.wait method. This is needed to attach a docstring to the - # method. - def wait(self, **kwargs): - Waiter.wait(self, **kwargs) - - wait.__doc__ = WaiterDocstring( - waiter_name=waiter_name, - event_emitter=client.meta.events, - service_model=client.meta.service_model, - service_waiter_model=waiter_model, - include_signature=False - ) - - # Rename the waiter class based on the type of waiter. - waiter_class_name = str('%s.Waiter.%s' % ( - get_service_module_name(client.meta.service_model), - waiter_name)) - - # Create the new waiter class - documented_waiter_cls = type( - waiter_class_name, (Waiter,), {'wait': wait}) - - # Return an instance of the new waiter class. - return documented_waiter_cls( - waiter_name, single_waiter_config, operation_method - ) - - -class NormalizedOperationMethod(object): - def __init__(self, client_method): - self._client_method = client_method - - def __call__(self, **kwargs): - try: - return self._client_method(**kwargs) - except ClientError as e: - return e.response - - -class WaiterModel(object): - SUPPORTED_VERSION = 2 - - def __init__(self, waiter_config): - """ - - Note that the WaiterModel takes ownership of the waiter_config. - It may or may not mutate the waiter_config. If this is a concern, - it is best to make a copy of the waiter config before passing it to - the WaiterModel. - - :type waiter_config: dict - :param waiter_config: The loaded waiter config - from the *.waiters.json file. This can be - obtained from a botocore Loader object as well. - - """ - self._waiter_config = waiter_config['waiters'] - - # These are part of the public API. Changing these - # will result in having to update the consuming code, - # so don't change unless you really need to. - version = waiter_config.get('version', 'unknown') - self._verify_supported_version(version) - self.version = version - self.waiter_names = list(sorted(waiter_config['waiters'].keys())) - - def _verify_supported_version(self, version): - if version != self.SUPPORTED_VERSION: - raise WaiterConfigError( - error_msg=("Unsupported waiter version, supported version " - "must be: %s, but version of waiter config " - "is: %s" % (self.SUPPORTED_VERSION, - version))) - - def get_waiter(self, waiter_name): - try: - single_waiter_config = self._waiter_config[waiter_name] - except KeyError: - raise ValueError("Waiter does not exist: %s" % waiter_name) - return SingleWaiterConfig(single_waiter_config) - - -class SingleWaiterConfig(object): - """Represents the waiter configuration for a single waiter. - - A single waiter is considered the configuration for a single - value associated with a named waiter (i.e TableExists). - - """ - def __init__(self, single_waiter_config): - self._config = single_waiter_config - - # These attributes are part of the public API. - self.description = single_waiter_config.get('description', '') - # Per the spec, these three fields are required. - self.operation = single_waiter_config['operation'] - self.delay = single_waiter_config['delay'] - self.max_attempts = single_waiter_config['maxAttempts'] - - @property - def acceptors(self): - acceptors = [] - for acceptor_config in self._config['acceptors']: - acceptor = AcceptorConfig(acceptor_config) - acceptors.append(acceptor) - return acceptors - - -class AcceptorConfig(object): - def __init__(self, config): - self.state = config['state'] - self.matcher = config['matcher'] - self.expected = config['expected'] - self.argument = config.get('argument') - self.matcher_func = self._create_matcher_func() - - def _create_matcher_func(self): - # An acceptor function is a callable that takes a single value. The - # parsed AWS response. Note that the parsed error response is also - # provided in the case of errors, so it's entirely possible to - # handle all the available matcher capabilities in the future. - # There's only three supported matchers, so for now, this is all - # contained to a single method. If this grows, we can expand this - # out to separate methods or even objects. - - if self.matcher == 'path': - return self._create_path_matcher() - elif self.matcher == 'pathAll': - return self._create_path_all_matcher() - elif self.matcher == 'pathAny': - return self._create_path_any_matcher() - elif self.matcher == 'status': - return self._create_status_matcher() - elif self.matcher == 'error': - return self._create_error_matcher() - else: - raise WaiterConfigError( - error_msg="Unknown acceptor: %s" % self.matcher) - - def _create_path_matcher(self): - expression = jmespath.compile(self.argument) - expected = self.expected - - def acceptor_matches(response): - if 'Error' in response: - return - return expression.search(response) == expected - return acceptor_matches - - def _create_path_all_matcher(self): - expression = jmespath.compile(self.argument) - expected = self.expected - - def acceptor_matches(response): - if 'Error' in response: - return - result = expression.search(response) - if not isinstance(result, list) or not result: - # pathAll matcher must result in a list. - # Also we require at least one element in the list, - # that is, an empty list should not result in this - # acceptor match. - return False - for element in result: - if element != expected: - return False - return True - return acceptor_matches - - def _create_path_any_matcher(self): - expression = jmespath.compile(self.argument) - expected = self.expected - - def acceptor_matches(response): - if 'Error' in response: - return - result = expression.search(response) - if not isinstance(result, list) or not result: - # pathAny matcher must result in a list. - # Also we require at least one element in the list, - # that is, an empty list should not result in this - # acceptor match. - return False - for element in result: - if element == expected: - return True - return False - return acceptor_matches - - def _create_status_matcher(self): - expected = self.expected - - def acceptor_matches(response): - # We don't have any requirements on the expected incoming data - # other than it is a dict, so we don't assume there's - # a ResponseMetadata.HTTPStatusCode. - status_code = response.get('ResponseMetadata', {}).get( - 'HTTPStatusCode') - return status_code == expected - return acceptor_matches - - def _create_error_matcher(self): - expected = self.expected - - def acceptor_matches(response): - # When the client encounters an error, it will normally raise - # an exception. However, the waiter implementation will catch - # this exception, and instead send us the parsed error - # response. So response is still a dictionary, and in the case - # of an error response will contain the "Error" and - # "ResponseMetadata" key. - return response.get("Error", {}).get("Code", "") == expected - return acceptor_matches - - -class Waiter(object): - def __init__(self, name, config, operation_method): - """ - - :type name: string - :param name: The name of the waiter - - :type config: botocore.waiter.SingleWaiterConfig - :param config: The configuration for the waiter. - - :type operation_method: callable - :param operation_method: A callable that accepts **kwargs - and returns a response. For example, this can be - a method from a botocore client. - - """ - self._operation_method = operation_method - # The two attributes are exposed to allow for introspection - # and documentation. - self.name = name - self.config = config - - def wait(self, **kwargs): - acceptors = list(self.config.acceptors) - current_state = 'waiting' - # pop the invocation specific config - config = kwargs.pop('WaiterConfig', {}) - sleep_amount = config.get('Delay', self.config.delay) - max_attempts = config.get('MaxAttempts', self.config.max_attempts) - num_attempts = 0 - - while True: - response = self._operation_method(**kwargs) - num_attempts += 1 - for acceptor in acceptors: - if acceptor.matcher_func(response): - current_state = acceptor.state - break - else: - # If none of the acceptors matched, we should - # transition to the failure state if an error - # response was received. - if 'Error' in response: - # Transition to a failure state, which we - # can just handle here by raising an exception. - raise WaiterError( - name=self.name, - reason=response['Error'].get('Message', 'Unknown'), - last_response=response - ) - if current_state == 'success': - logger.debug("Waiting complete, waiter matched the " - "success state.") - return - if current_state == 'failure': - raise WaiterError( - name=self.name, - reason='Waiter encountered a terminal failure state', - last_response=response, - ) - if num_attempts >= max_attempts: - raise WaiterError( - name=self.name, - reason='Max attempts exceeded', - last_response=response - ) - time.sleep(sleep_amount) diff --git a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/PKG-INFO b/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/PKG-INFO deleted file mode 100644 index e03caec4..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/PKG-INFO +++ /dev/null @@ -1,52 +0,0 @@ -Metadata-Version: 1.2 -Name: futures -Version: 3.2.0 -Summary: Backport of the concurrent.futures package from Python 3 -Home-page: https://github.com/agronholm/pythonfutures -Author: Alex Grönholm -Author-email: alex.gronholm@nextday.fi -License: PSF -Description: .. image:: https://travis-ci.org/agronholm/pythonfutures.svg?branch=master - :target: https://travis-ci.org/agronholm/pythonfutures - :alt: Build Status - - This is a backport of the `concurrent.futures`_ standard library module to Python 2. - - It should not be installed on Python 3, although there should be no harm in doing so, as the - standard library takes precedence over third party libraries. - - To conditionally require this library only on Python 2, you can do this in your ``setup.py``: - - .. code-block:: python - - setup( - ... - extras_require={ - ':python_version == "2.7"': ['futures'] - } - ) - - Or, using the newer syntax: - - .. code-block:: python - - setup( - ... - install_requires={ - 'futures; python_version == "2.7"' - } - ) - - .. warning:: The ``ProcessPoolExecutor`` class has known (unfixable) problems on Python 2 and - should not be relied on for mission critical work. - - .. _concurrent.futures: https://docs.python.org/library/concurrent.futures.html - -Platform: UNKNOWN -Classifier: License :: OSI Approved :: Python Software Foundation License -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: Programming Language :: Python :: 2.6 -Classifier: Programming Language :: Python :: 2.7 -Classifier: Programming Language :: Python :: 2 :: Only -Requires-Python: >=2.6, <3 diff --git a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/SOURCES.txt b/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/SOURCES.txt deleted file mode 100644 index 74f5f722..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/SOURCES.txt +++ /dev/null @@ -1,23 +0,0 @@ -LICENSE -MANIFEST.in -README.rst -crawl.py -primes.py -setup.cfg -setup.py -test_futures.py -tox.ini -concurrent/__init__.py -concurrent/futures/__init__.py -concurrent/futures/_base.py -concurrent/futures/process.py -concurrent/futures/thread.py -docs/Makefile -docs/conf.py -docs/index.rst -docs/make.bat -futures.egg-info/PKG-INFO -futures.egg-info/SOURCES.txt -futures.egg-info/dependency_links.txt -futures.egg-info/not-zip-safe -futures.egg-info/top_level.txt \ No newline at end of file diff --git a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/dependency_links.txt b/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/dependency_links.txt deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/dependency_links.txt +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/not-zip-safe b/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/not-zip-safe deleted file mode 100644 index 8b137891..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/not-zip-safe +++ /dev/null @@ -1 +0,0 @@ - diff --git a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/top_level.txt b/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/top_level.txt deleted file mode 100644 index e4d7bdcb..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/EGG-INFO/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -concurrent diff --git a/.eggs/futures-3.2.0-py2.7.egg/concurrent/__init__.py b/.eggs/futures-3.2.0-py2.7.egg/concurrent/__init__.py deleted file mode 100644 index b36383a6..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/concurrent/__init__.py +++ /dev/null @@ -1,3 +0,0 @@ -from pkgutil import extend_path - -__path__ = extend_path(__path__, __name__) diff --git a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/__init__.py b/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/__init__.py deleted file mode 100644 index 428b14bd..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/__init__.py +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright 2009 Brian Quinlan. All Rights Reserved. -# Licensed to PSF under a Contributor Agreement. - -"""Execute computations asynchronously using threads or processes.""" - -__author__ = 'Brian Quinlan (brian@sweetapp.com)' - -from concurrent.futures._base import (FIRST_COMPLETED, - FIRST_EXCEPTION, - ALL_COMPLETED, - CancelledError, - TimeoutError, - Future, - Executor, - wait, - as_completed) -from concurrent.futures.thread import ThreadPoolExecutor - -try: - from concurrent.futures.process import ProcessPoolExecutor -except ImportError: - # some platforms don't have multiprocessing - pass diff --git a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/_base.py b/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/_base.py deleted file mode 100644 index 510ffa53..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/_base.py +++ /dev/null @@ -1,667 +0,0 @@ -# Copyright 2009 Brian Quinlan. All Rights Reserved. -# Licensed to PSF under a Contributor Agreement. - -import collections -import logging -import threading -import itertools -import time -import types - -__author__ = 'Brian Quinlan (brian@sweetapp.com)' - -FIRST_COMPLETED = 'FIRST_COMPLETED' -FIRST_EXCEPTION = 'FIRST_EXCEPTION' -ALL_COMPLETED = 'ALL_COMPLETED' -_AS_COMPLETED = '_AS_COMPLETED' - -# Possible future states (for internal use by the futures package). -PENDING = 'PENDING' -RUNNING = 'RUNNING' -# The future was cancelled by the user... -CANCELLED = 'CANCELLED' -# ...and _Waiter.add_cancelled() was called by a worker. -CANCELLED_AND_NOTIFIED = 'CANCELLED_AND_NOTIFIED' -FINISHED = 'FINISHED' - -_FUTURE_STATES = [ - PENDING, - RUNNING, - CANCELLED, - CANCELLED_AND_NOTIFIED, - FINISHED -] - -_STATE_TO_DESCRIPTION_MAP = { - PENDING: "pending", - RUNNING: "running", - CANCELLED: "cancelled", - CANCELLED_AND_NOTIFIED: "cancelled", - FINISHED: "finished" -} - -# Logger for internal use by the futures package. -LOGGER = logging.getLogger("concurrent.futures") - -class Error(Exception): - """Base class for all future-related exceptions.""" - pass - -class CancelledError(Error): - """The Future was cancelled.""" - pass - -class TimeoutError(Error): - """The operation exceeded the given deadline.""" - pass - -class _Waiter(object): - """Provides the event that wait() and as_completed() block on.""" - def __init__(self): - self.event = threading.Event() - self.finished_futures = [] - - def add_result(self, future): - self.finished_futures.append(future) - - def add_exception(self, future): - self.finished_futures.append(future) - - def add_cancelled(self, future): - self.finished_futures.append(future) - -class _AsCompletedWaiter(_Waiter): - """Used by as_completed().""" - - def __init__(self): - super(_AsCompletedWaiter, self).__init__() - self.lock = threading.Lock() - - def add_result(self, future): - with self.lock: - super(_AsCompletedWaiter, self).add_result(future) - self.event.set() - - def add_exception(self, future): - with self.lock: - super(_AsCompletedWaiter, self).add_exception(future) - self.event.set() - - def add_cancelled(self, future): - with self.lock: - super(_AsCompletedWaiter, self).add_cancelled(future) - self.event.set() - -class _FirstCompletedWaiter(_Waiter): - """Used by wait(return_when=FIRST_COMPLETED).""" - - def add_result(self, future): - super(_FirstCompletedWaiter, self).add_result(future) - self.event.set() - - def add_exception(self, future): - super(_FirstCompletedWaiter, self).add_exception(future) - self.event.set() - - def add_cancelled(self, future): - super(_FirstCompletedWaiter, self).add_cancelled(future) - self.event.set() - -class _AllCompletedWaiter(_Waiter): - """Used by wait(return_when=FIRST_EXCEPTION and ALL_COMPLETED).""" - - def __init__(self, num_pending_calls, stop_on_exception): - self.num_pending_calls = num_pending_calls - self.stop_on_exception = stop_on_exception - self.lock = threading.Lock() - super(_AllCompletedWaiter, self).__init__() - - def _decrement_pending_calls(self): - with self.lock: - self.num_pending_calls -= 1 - if not self.num_pending_calls: - self.event.set() - - def add_result(self, future): - super(_AllCompletedWaiter, self).add_result(future) - self._decrement_pending_calls() - - def add_exception(self, future): - super(_AllCompletedWaiter, self).add_exception(future) - if self.stop_on_exception: - self.event.set() - else: - self._decrement_pending_calls() - - def add_cancelled(self, future): - super(_AllCompletedWaiter, self).add_cancelled(future) - self._decrement_pending_calls() - -class _AcquireFutures(object): - """A context manager that does an ordered acquire of Future conditions.""" - - def __init__(self, futures): - self.futures = sorted(futures, key=id) - - def __enter__(self): - for future in self.futures: - future._condition.acquire() - - def __exit__(self, *args): - for future in self.futures: - future._condition.release() - -def _create_and_install_waiters(fs, return_when): - if return_when == _AS_COMPLETED: - waiter = _AsCompletedWaiter() - elif return_when == FIRST_COMPLETED: - waiter = _FirstCompletedWaiter() - else: - pending_count = sum( - f._state not in [CANCELLED_AND_NOTIFIED, FINISHED] for f in fs) - - if return_when == FIRST_EXCEPTION: - waiter = _AllCompletedWaiter(pending_count, stop_on_exception=True) - elif return_when == ALL_COMPLETED: - waiter = _AllCompletedWaiter(pending_count, stop_on_exception=False) - else: - raise ValueError("Invalid return condition: %r" % return_when) - - for f in fs: - f._waiters.append(waiter) - - return waiter - - -def _yield_finished_futures(fs, waiter, ref_collect): - """ - Iterate on the list *fs*, yielding finished futures one by one in - reverse order. - Before yielding a future, *waiter* is removed from its waiters - and the future is removed from each set in the collection of sets - *ref_collect*. - - The aim of this function is to avoid keeping stale references after - the future is yielded and before the iterator resumes. - """ - while fs: - f = fs[-1] - for futures_set in ref_collect: - futures_set.remove(f) - with f._condition: - f._waiters.remove(waiter) - del f - # Careful not to keep a reference to the popped value - yield fs.pop() - - -def as_completed(fs, timeout=None): - """An iterator over the given futures that yields each as it completes. - - Args: - fs: The sequence of Futures (possibly created by different Executors) to - iterate over. - timeout: The maximum number of seconds to wait. If None, then there - is no limit on the wait time. - - Returns: - An iterator that yields the given Futures as they complete (finished or - cancelled). If any given Futures are duplicated, they will be returned - once. - - Raises: - TimeoutError: If the entire result iterator could not be generated - before the given timeout. - """ - if timeout is not None: - end_time = timeout + time.time() - - fs = set(fs) - total_futures = len(fs) - with _AcquireFutures(fs): - finished = set( - f for f in fs - if f._state in [CANCELLED_AND_NOTIFIED, FINISHED]) - pending = fs - finished - waiter = _create_and_install_waiters(fs, _AS_COMPLETED) - finished = list(finished) - try: - for f in _yield_finished_futures(finished, waiter, - ref_collect=(fs,)): - f = [f] - yield f.pop() - - while pending: - if timeout is None: - wait_timeout = None - else: - wait_timeout = end_time - time.time() - if wait_timeout < 0: - raise TimeoutError( - '%d (of %d) futures unfinished' % ( - len(pending), total_futures)) - - waiter.event.wait(wait_timeout) - - with waiter.lock: - finished = waiter.finished_futures - waiter.finished_futures = [] - waiter.event.clear() - - # reverse to keep finishing order - finished.reverse() - for f in _yield_finished_futures(finished, waiter, - ref_collect=(fs, pending)): - f = [f] - yield f.pop() - - finally: - # Remove waiter from unfinished futures - for f in fs: - with f._condition: - f._waiters.remove(waiter) - -DoneAndNotDoneFutures = collections.namedtuple( - 'DoneAndNotDoneFutures', 'done not_done') -def wait(fs, timeout=None, return_when=ALL_COMPLETED): - """Wait for the futures in the given sequence to complete. - - Args: - fs: The sequence of Futures (possibly created by different Executors) to - wait upon. - timeout: The maximum number of seconds to wait. If None, then there - is no limit on the wait time. - return_when: Indicates when this function should return. The options - are: - - FIRST_COMPLETED - Return when any future finishes or is - cancelled. - FIRST_EXCEPTION - Return when any future finishes by raising an - exception. If no future raises an exception - then it is equivalent to ALL_COMPLETED. - ALL_COMPLETED - Return when all futures finish or are cancelled. - - Returns: - A named 2-tuple of sets. The first set, named 'done', contains the - futures that completed (is finished or cancelled) before the wait - completed. The second set, named 'not_done', contains uncompleted - futures. - """ - with _AcquireFutures(fs): - done = set(f for f in fs - if f._state in [CANCELLED_AND_NOTIFIED, FINISHED]) - not_done = set(fs) - done - - if (return_when == FIRST_COMPLETED) and done: - return DoneAndNotDoneFutures(done, not_done) - elif (return_when == FIRST_EXCEPTION) and done: - if any(f for f in done - if not f.cancelled() and f.exception() is not None): - return DoneAndNotDoneFutures(done, not_done) - - if len(done) == len(fs): - return DoneAndNotDoneFutures(done, not_done) - - waiter = _create_and_install_waiters(fs, return_when) - - waiter.event.wait(timeout) - for f in fs: - with f._condition: - f._waiters.remove(waiter) - - done.update(waiter.finished_futures) - return DoneAndNotDoneFutures(done, set(fs) - done) - -class Future(object): - """Represents the result of an asynchronous computation.""" - - def __init__(self): - """Initializes the future. Should not be called by clients.""" - self._condition = threading.Condition() - self._state = PENDING - self._result = None - self._exception = None - self._traceback = None - self._waiters = [] - self._done_callbacks = [] - - def _invoke_callbacks(self): - for callback in self._done_callbacks: - try: - callback(self) - except Exception: - LOGGER.exception('exception calling callback for %r', self) - except BaseException: - # Explicitly let all other new-style exceptions through so - # that we can catch all old-style exceptions with a simple - # "except:" clause below. - # - # All old-style exception objects are instances of - # types.InstanceType, but "except types.InstanceType:" does - # not catch old-style exceptions for some reason. Thus, the - # only way to catch all old-style exceptions without catching - # any new-style exceptions is to filter out the new-style - # exceptions, which all derive from BaseException. - raise - except: - # Because of the BaseException clause above, this handler only - # executes for old-style exception objects. - LOGGER.exception('exception calling callback for %r', self) - - def __repr__(self): - with self._condition: - if self._state == FINISHED: - if self._exception: - return '<%s at %#x state=%s raised %s>' % ( - self.__class__.__name__, - id(self), - _STATE_TO_DESCRIPTION_MAP[self._state], - self._exception.__class__.__name__) - else: - return '<%s at %#x state=%s returned %s>' % ( - self.__class__.__name__, - id(self), - _STATE_TO_DESCRIPTION_MAP[self._state], - self._result.__class__.__name__) - return '<%s at %#x state=%s>' % ( - self.__class__.__name__, - id(self), - _STATE_TO_DESCRIPTION_MAP[self._state]) - - def cancel(self): - """Cancel the future if possible. - - Returns True if the future was cancelled, False otherwise. A future - cannot be cancelled if it is running or has already completed. - """ - with self._condition: - if self._state in [RUNNING, FINISHED]: - return False - - if self._state in [CANCELLED, CANCELLED_AND_NOTIFIED]: - return True - - self._state = CANCELLED - self._condition.notify_all() - - self._invoke_callbacks() - return True - - def cancelled(self): - """Return True if the future was cancelled.""" - with self._condition: - return self._state in [CANCELLED, CANCELLED_AND_NOTIFIED] - - def running(self): - """Return True if the future is currently executing.""" - with self._condition: - return self._state == RUNNING - - def done(self): - """Return True of the future was cancelled or finished executing.""" - with self._condition: - return self._state in [CANCELLED, CANCELLED_AND_NOTIFIED, FINISHED] - - def __get_result(self): - if self._exception: - if isinstance(self._exception, types.InstanceType): - # The exception is an instance of an old-style class, which - # means type(self._exception) returns types.ClassType instead - # of the exception's actual class type. - exception_type = self._exception.__class__ - else: - exception_type = type(self._exception) - raise exception_type, self._exception, self._traceback - else: - return self._result - - def add_done_callback(self, fn): - """Attaches a callable that will be called when the future finishes. - - Args: - fn: A callable that will be called with this future as its only - argument when the future completes or is cancelled. The callable - will always be called by a thread in the same process in which - it was added. If the future has already completed or been - cancelled then the callable will be called immediately. These - callables are called in the order that they were added. - """ - with self._condition: - if self._state not in [CANCELLED, CANCELLED_AND_NOTIFIED, FINISHED]: - self._done_callbacks.append(fn) - return - fn(self) - - def result(self, timeout=None): - """Return the result of the call that the future represents. - - Args: - timeout: The number of seconds to wait for the result if the future - isn't done. If None, then there is no limit on the wait time. - - Returns: - The result of the call that the future represents. - - Raises: - CancelledError: If the future was cancelled. - TimeoutError: If the future didn't finish executing before the given - timeout. - Exception: If the call raised then that exception will be raised. - """ - with self._condition: - if self._state in [CANCELLED, CANCELLED_AND_NOTIFIED]: - raise CancelledError() - elif self._state == FINISHED: - return self.__get_result() - - self._condition.wait(timeout) - - if self._state in [CANCELLED, CANCELLED_AND_NOTIFIED]: - raise CancelledError() - elif self._state == FINISHED: - return self.__get_result() - else: - raise TimeoutError() - - def exception_info(self, timeout=None): - """Return a tuple of (exception, traceback) raised by the call that the - future represents. - - Args: - timeout: The number of seconds to wait for the exception if the - future isn't done. If None, then there is no limit on the wait - time. - - Returns: - The exception raised by the call that the future represents or None - if the call completed without raising. - - Raises: - CancelledError: If the future was cancelled. - TimeoutError: If the future didn't finish executing before the given - timeout. - """ - with self._condition: - if self._state in [CANCELLED, CANCELLED_AND_NOTIFIED]: - raise CancelledError() - elif self._state == FINISHED: - return self._exception, self._traceback - - self._condition.wait(timeout) - - if self._state in [CANCELLED, CANCELLED_AND_NOTIFIED]: - raise CancelledError() - elif self._state == FINISHED: - return self._exception, self._traceback - else: - raise TimeoutError() - - def exception(self, timeout=None): - """Return the exception raised by the call that the future represents. - - Args: - timeout: The number of seconds to wait for the exception if the - future isn't done. If None, then there is no limit on the wait - time. - - Returns: - The exception raised by the call that the future represents or None - if the call completed without raising. - - Raises: - CancelledError: If the future was cancelled. - TimeoutError: If the future didn't finish executing before the given - timeout. - """ - return self.exception_info(timeout)[0] - - # The following methods should only be used by Executors and in tests. - def set_running_or_notify_cancel(self): - """Mark the future as running or process any cancel notifications. - - Should only be used by Executor implementations and unit tests. - - If the future has been cancelled (cancel() was called and returned - True) then any threads waiting on the future completing (though calls - to as_completed() or wait()) are notified and False is returned. - - If the future was not cancelled then it is put in the running state - (future calls to running() will return True) and True is returned. - - This method should be called by Executor implementations before - executing the work associated with this future. If this method returns - False then the work should not be executed. - - Returns: - False if the Future was cancelled, True otherwise. - - Raises: - RuntimeError: if this method was already called or if set_result() - or set_exception() was called. - """ - with self._condition: - if self._state == CANCELLED: - self._state = CANCELLED_AND_NOTIFIED - for waiter in self._waiters: - waiter.add_cancelled(self) - # self._condition.notify_all() is not necessary because - # self.cancel() triggers a notification. - return False - elif self._state == PENDING: - self._state = RUNNING - return True - else: - LOGGER.critical('Future %s in unexpected state: %s', - id(self), - self._state) - raise RuntimeError('Future in unexpected state') - - def set_result(self, result): - """Sets the return value of work associated with the future. - - Should only be used by Executor implementations and unit tests. - """ - with self._condition: - self._result = result - self._state = FINISHED - for waiter in self._waiters: - waiter.add_result(self) - self._condition.notify_all() - self._invoke_callbacks() - - def set_exception_info(self, exception, traceback): - """Sets the result of the future as being the given exception - and traceback. - - Should only be used by Executor implementations and unit tests. - """ - with self._condition: - self._exception = exception - self._traceback = traceback - self._state = FINISHED - for waiter in self._waiters: - waiter.add_exception(self) - self._condition.notify_all() - self._invoke_callbacks() - - def set_exception(self, exception): - """Sets the result of the future as being the given exception. - - Should only be used by Executor implementations and unit tests. - """ - self.set_exception_info(exception, None) - -class Executor(object): - """This is an abstract base class for concrete asynchronous executors.""" - - def submit(self, fn, *args, **kwargs): - """Submits a callable to be executed with the given arguments. - - Schedules the callable to be executed as fn(*args, **kwargs) and returns - a Future instance representing the execution of the callable. - - Returns: - A Future representing the given call. - """ - raise NotImplementedError() - - def map(self, fn, *iterables, **kwargs): - """Returns an iterator equivalent to map(fn, iter). - - Args: - fn: A callable that will take as many arguments as there are - passed iterables. - timeout: The maximum number of seconds to wait. If None, then there - is no limit on the wait time. - - Returns: - An iterator equivalent to: map(func, *iterables) but the calls may - be evaluated out-of-order. - - Raises: - TimeoutError: If the entire result iterator could not be generated - before the given timeout. - Exception: If fn(*args) raises for any values. - """ - timeout = kwargs.get('timeout') - if timeout is not None: - end_time = timeout + time.time() - - fs = [self.submit(fn, *args) for args in itertools.izip(*iterables)] - - # Yield must be hidden in closure so that the futures are submitted - # before the first iterator value is required. - def result_iterator(): - try: - # reverse to keep finishing order - fs.reverse() - while fs: - # Careful not to keep a reference to the popped future - if timeout is None: - yield fs.pop().result() - else: - yield fs.pop().result(end_time - time.time()) - finally: - for future in fs: - future.cancel() - return result_iterator() - - def shutdown(self, wait=True): - """Clean-up the resources associated with the Executor. - - It is safe to call this method several times. Otherwise, no other - methods can be called after this one. - - Args: - wait: If True then shutdown will not return until all running - futures have finished executing and the resources used by the - executor have been reclaimed. - """ - pass - - def __enter__(self): - return self - - def __exit__(self, exc_type, exc_val, exc_tb): - self.shutdown(wait=True) - return False diff --git a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/process.py b/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/process.py deleted file mode 100644 index fa5b96fd..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/process.py +++ /dev/null @@ -1,363 +0,0 @@ -# Copyright 2009 Brian Quinlan. All Rights Reserved. -# Licensed to PSF under a Contributor Agreement. - -"""Implements ProcessPoolExecutor. - -The follow diagram and text describe the data-flow through the system: - -|======================= In-process =====================|== Out-of-process ==| - -+----------+ +----------+ +--------+ +-----------+ +---------+ -| | => | Work Ids | => | | => | Call Q | => | | -| | +----------+ | | +-----------+ | | -| | | ... | | | | ... | | | -| | | 6 | | | | 5, call() | | | -| | | 7 | | | | ... | | | -| Process | | ... | | Local | +-----------+ | Process | -| Pool | +----------+ | Worker | | #1..n | -| Executor | | Thread | | | -| | +----------- + | | +-----------+ | | -| | <=> | Work Items | <=> | | <= | Result Q | <= | | -| | +------------+ | | +-----------+ | | -| | | 6: call() | | | | ... | | | -| | | future | | | | 4, result | | | -| | | ... | | | | 3, except | | | -+----------+ +------------+ +--------+ +-----------+ +---------+ - -Executor.submit() called: -- creates a uniquely numbered _WorkItem and adds it to the "Work Items" dict -- adds the id of the _WorkItem to the "Work Ids" queue - -Local worker thread: -- reads work ids from the "Work Ids" queue and looks up the corresponding - WorkItem from the "Work Items" dict: if the work item has been cancelled then - it is simply removed from the dict, otherwise it is repackaged as a - _CallItem and put in the "Call Q". New _CallItems are put in the "Call Q" - until "Call Q" is full. NOTE: the size of the "Call Q" is kept small because - calls placed in the "Call Q" can no longer be cancelled with Future.cancel(). -- reads _ResultItems from "Result Q", updates the future stored in the - "Work Items" dict and deletes the dict entry - -Process #1..n: -- reads _CallItems from "Call Q", executes the calls, and puts the resulting - _ResultItems in "Request Q" -""" - -import atexit -from concurrent.futures import _base -import Queue as queue -import multiprocessing -import threading -import weakref -import sys - -__author__ = 'Brian Quinlan (brian@sweetapp.com)' - -# Workers are created as daemon threads and processes. This is done to allow the -# interpreter to exit when there are still idle processes in a -# ProcessPoolExecutor's process pool (i.e. shutdown() was not called). However, -# allowing workers to die with the interpreter has two undesirable properties: -# - The workers would still be running during interpretor shutdown, -# meaning that they would fail in unpredictable ways. -# - The workers could be killed while evaluating a work item, which could -# be bad if the callable being evaluated has external side-effects e.g. -# writing to a file. -# -# To work around this problem, an exit handler is installed which tells the -# workers to exit when their work queues are empty and then waits until the -# threads/processes finish. - -_threads_queues = weakref.WeakKeyDictionary() -_shutdown = False - -def _python_exit(): - global _shutdown - _shutdown = True - items = list(_threads_queues.items()) if _threads_queues else () - for t, q in items: - q.put(None) - for t, q in items: - t.join(sys.maxint) - -# Controls how many more calls than processes will be queued in the call queue. -# A smaller number will mean that processes spend more time idle waiting for -# work while a larger number will make Future.cancel() succeed less frequently -# (Futures in the call queue cannot be cancelled). -EXTRA_QUEUED_CALLS = 1 - -class _WorkItem(object): - def __init__(self, future, fn, args, kwargs): - self.future = future - self.fn = fn - self.args = args - self.kwargs = kwargs - -class _ResultItem(object): - def __init__(self, work_id, exception=None, result=None): - self.work_id = work_id - self.exception = exception - self.result = result - -class _CallItem(object): - def __init__(self, work_id, fn, args, kwargs): - self.work_id = work_id - self.fn = fn - self.args = args - self.kwargs = kwargs - -def _process_worker(call_queue, result_queue): - """Evaluates calls from call_queue and places the results in result_queue. - - This worker is run in a separate process. - - Args: - call_queue: A multiprocessing.Queue of _CallItems that will be read and - evaluated by the worker. - result_queue: A multiprocessing.Queue of _ResultItems that will written - to by the worker. - shutdown: A multiprocessing.Event that will be set as a signal to the - worker that it should exit when call_queue is empty. - """ - while True: - call_item = call_queue.get(block=True) - if call_item is None: - # Wake up queue management thread - result_queue.put(None) - return - try: - r = call_item.fn(*call_item.args, **call_item.kwargs) - except: - e = sys.exc_info()[1] - result_queue.put(_ResultItem(call_item.work_id, - exception=e)) - else: - result_queue.put(_ResultItem(call_item.work_id, - result=r)) - -def _add_call_item_to_queue(pending_work_items, - work_ids, - call_queue): - """Fills call_queue with _WorkItems from pending_work_items. - - This function never blocks. - - Args: - pending_work_items: A dict mapping work ids to _WorkItems e.g. - {5: <_WorkItem...>, 6: <_WorkItem...>, ...} - work_ids: A queue.Queue of work ids e.g. Queue([5, 6, ...]). Work ids - are consumed and the corresponding _WorkItems from - pending_work_items are transformed into _CallItems and put in - call_queue. - call_queue: A multiprocessing.Queue that will be filled with _CallItems - derived from _WorkItems. - """ - while True: - if call_queue.full(): - return - try: - work_id = work_ids.get(block=False) - except queue.Empty: - return - else: - work_item = pending_work_items[work_id] - - if work_item.future.set_running_or_notify_cancel(): - call_queue.put(_CallItem(work_id, - work_item.fn, - work_item.args, - work_item.kwargs), - block=True) - else: - del pending_work_items[work_id] - continue - -def _queue_management_worker(executor_reference, - processes, - pending_work_items, - work_ids_queue, - call_queue, - result_queue): - """Manages the communication between this process and the worker processes. - - This function is run in a local thread. - - Args: - executor_reference: A weakref.ref to the ProcessPoolExecutor that owns - this thread. Used to determine if the ProcessPoolExecutor has been - garbage collected and that this function can exit. - process: A list of the multiprocessing.Process instances used as - workers. - pending_work_items: A dict mapping work ids to _WorkItems e.g. - {5: <_WorkItem...>, 6: <_WorkItem...>, ...} - work_ids_queue: A queue.Queue of work ids e.g. Queue([5, 6, ...]). - call_queue: A multiprocessing.Queue that will be filled with _CallItems - derived from _WorkItems for processing by the process workers. - result_queue: A multiprocessing.Queue of _ResultItems generated by the - process workers. - """ - nb_shutdown_processes = [0] - def shutdown_one_process(): - """Tell a worker to terminate, which will in turn wake us again""" - call_queue.put(None) - nb_shutdown_processes[0] += 1 - while True: - _add_call_item_to_queue(pending_work_items, - work_ids_queue, - call_queue) - - result_item = result_queue.get(block=True) - if result_item is not None: - work_item = pending_work_items[result_item.work_id] - del pending_work_items[result_item.work_id] - - if result_item.exception: - work_item.future.set_exception(result_item.exception) - else: - work_item.future.set_result(result_item.result) - # Delete references to object. See issue16284 - del work_item - # Check whether we should start shutting down. - executor = executor_reference() - # No more work items can be added if: - # - The interpreter is shutting down OR - # - The executor that owns this worker has been collected OR - # - The executor that owns this worker has been shutdown. - if _shutdown or executor is None or executor._shutdown_thread: - # Since no new work items can be added, it is safe to shutdown - # this thread if there are no pending work items. - if not pending_work_items: - while nb_shutdown_processes[0] < len(processes): - shutdown_one_process() - # If .join() is not called on the created processes then - # some multiprocessing.Queue methods may deadlock on Mac OS - # X. - for p in processes: - p.join() - call_queue.close() - return - del executor - -_system_limits_checked = False -_system_limited = None -def _check_system_limits(): - global _system_limits_checked, _system_limited - if _system_limits_checked: - if _system_limited: - raise NotImplementedError(_system_limited) - _system_limits_checked = True - try: - import os - nsems_max = os.sysconf("SC_SEM_NSEMS_MAX") - except (AttributeError, ValueError): - # sysconf not available or setting not available - return - if nsems_max == -1: - # indetermine limit, assume that limit is determined - # by available memory only - return - if nsems_max >= 256: - # minimum number of semaphores available - # according to POSIX - return - _system_limited = "system provides too few semaphores (%d available, 256 necessary)" % nsems_max - raise NotImplementedError(_system_limited) - - -class ProcessPoolExecutor(_base.Executor): - def __init__(self, max_workers=None): - """Initializes a new ProcessPoolExecutor instance. - - Args: - max_workers: The maximum number of processes that can be used to - execute the given calls. If None or not given then as many - worker processes will be created as the machine has processors. - """ - _check_system_limits() - - if max_workers is None: - self._max_workers = multiprocessing.cpu_count() - else: - if max_workers <= 0: - raise ValueError("max_workers must be greater than 0") - - self._max_workers = max_workers - - # Make the call queue slightly larger than the number of processes to - # prevent the worker processes from idling. But don't make it too big - # because futures in the call queue cannot be cancelled. - self._call_queue = multiprocessing.Queue(self._max_workers + - EXTRA_QUEUED_CALLS) - self._result_queue = multiprocessing.Queue() - self._work_ids = queue.Queue() - self._queue_management_thread = None - self._processes = set() - - # Shutdown is a two-step process. - self._shutdown_thread = False - self._shutdown_lock = threading.Lock() - self._queue_count = 0 - self._pending_work_items = {} - - def _start_queue_management_thread(self): - # When the executor gets lost, the weakref callback will wake up - # the queue management thread. - def weakref_cb(_, q=self._result_queue): - q.put(None) - if self._queue_management_thread is None: - self._queue_management_thread = threading.Thread( - target=_queue_management_worker, - args=(weakref.ref(self, weakref_cb), - self._processes, - self._pending_work_items, - self._work_ids, - self._call_queue, - self._result_queue)) - self._queue_management_thread.daemon = True - self._queue_management_thread.start() - _threads_queues[self._queue_management_thread] = self._result_queue - - def _adjust_process_count(self): - for _ in range(len(self._processes), self._max_workers): - p = multiprocessing.Process( - target=_process_worker, - args=(self._call_queue, - self._result_queue)) - p.start() - self._processes.add(p) - - def submit(self, fn, *args, **kwargs): - with self._shutdown_lock: - if self._shutdown_thread: - raise RuntimeError('cannot schedule new futures after shutdown') - - f = _base.Future() - w = _WorkItem(f, fn, args, kwargs) - - self._pending_work_items[self._queue_count] = w - self._work_ids.put(self._queue_count) - self._queue_count += 1 - # Wake up queue management thread - self._result_queue.put(None) - - self._start_queue_management_thread() - self._adjust_process_count() - return f - submit.__doc__ = _base.Executor.submit.__doc__ - - def shutdown(self, wait=True): - with self._shutdown_lock: - self._shutdown_thread = True - if self._queue_management_thread: - # Wake up queue management thread - self._result_queue.put(None) - if wait: - self._queue_management_thread.join(sys.maxint) - # To reduce the risk of openning too many files, remove references to - # objects that use file descriptors. - self._queue_management_thread = None - self._call_queue = None - self._result_queue = None - self._processes = None - shutdown.__doc__ = _base.Executor.shutdown.__doc__ - -atexit.register(_python_exit) diff --git a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/thread.py b/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/thread.py deleted file mode 100644 index bb0ce9d7..00000000 --- a/.eggs/futures-3.2.0-py2.7.egg/concurrent/futures/thread.py +++ /dev/null @@ -1,160 +0,0 @@ -# Copyright 2009 Brian Quinlan. All Rights Reserved. -# Licensed to PSF under a Contributor Agreement. - -"""Implements ThreadPoolExecutor.""" - -import atexit -from concurrent.futures import _base -import itertools -import Queue as queue -import threading -import weakref -import sys - -try: - from multiprocessing import cpu_count -except ImportError: - # some platforms don't have multiprocessing - def cpu_count(): - return None - -__author__ = 'Brian Quinlan (brian@sweetapp.com)' - -# Workers are created as daemon threads. This is done to allow the interpreter -# to exit when there are still idle threads in a ThreadPoolExecutor's thread -# pool (i.e. shutdown() was not called). However, allowing workers to die with -# the interpreter has two undesirable properties: -# - The workers would still be running during interpretor shutdown, -# meaning that they would fail in unpredictable ways. -# - The workers could be killed while evaluating a work item, which could -# be bad if the callable being evaluated has external side-effects e.g. -# writing to a file. -# -# To work around this problem, an exit handler is installed which tells the -# workers to exit when their work queues are empty and then waits until the -# threads finish. - -_threads_queues = weakref.WeakKeyDictionary() -_shutdown = False - -def _python_exit(): - global _shutdown - _shutdown = True - items = list(_threads_queues.items()) if _threads_queues else () - for t, q in items: - q.put(None) - for t, q in items: - t.join(sys.maxint) - -atexit.register(_python_exit) - -class _WorkItem(object): - def __init__(self, future, fn, args, kwargs): - self.future = future - self.fn = fn - self.args = args - self.kwargs = kwargs - - def run(self): - if not self.future.set_running_or_notify_cancel(): - return - - try: - result = self.fn(*self.args, **self.kwargs) - except: - e, tb = sys.exc_info()[1:] - self.future.set_exception_info(e, tb) - else: - self.future.set_result(result) - -def _worker(executor_reference, work_queue): - try: - while True: - work_item = work_queue.get(block=True) - if work_item is not None: - work_item.run() - # Delete references to object. See issue16284 - del work_item - continue - executor = executor_reference() - # Exit if: - # - The interpreter is shutting down OR - # - The executor that owns the worker has been collected OR - # - The executor that owns the worker has been shutdown. - if _shutdown or executor is None or executor._shutdown: - # Notice other workers - work_queue.put(None) - return - del executor - except: - _base.LOGGER.critical('Exception in worker', exc_info=True) - - -class ThreadPoolExecutor(_base.Executor): - - # Used to assign unique thread names when thread_name_prefix is not supplied. - _counter = itertools.count().next - - def __init__(self, max_workers=None, thread_name_prefix=''): - """Initializes a new ThreadPoolExecutor instance. - - Args: - max_workers: The maximum number of threads that can be used to - execute the given calls. - thread_name_prefix: An optional name prefix to give our threads. - """ - if max_workers is None: - # Use this number because ThreadPoolExecutor is often - # used to overlap I/O instead of CPU work. - max_workers = (cpu_count() or 1) * 5 - if max_workers <= 0: - raise ValueError("max_workers must be greater than 0") - - self._max_workers = max_workers - self._work_queue = queue.Queue() - self._threads = set() - self._shutdown = False - self._shutdown_lock = threading.Lock() - self._thread_name_prefix = (thread_name_prefix or - ("ThreadPoolExecutor-%d" % self._counter())) - - def submit(self, fn, *args, **kwargs): - with self._shutdown_lock: - if self._shutdown: - raise RuntimeError('cannot schedule new futures after shutdown') - - f = _base.Future() - w = _WorkItem(f, fn, args, kwargs) - - self._work_queue.put(w) - self._adjust_thread_count() - return f - submit.__doc__ = _base.Executor.submit.__doc__ - - def _adjust_thread_count(self): - # When the executor gets lost, the weakref callback will wake up - # the worker threads. - def weakref_cb(_, q=self._work_queue): - q.put(None) - # TODO(bquinlan): Should avoid creating new threads if there are more - # idle threads than items in the work queue. - num_threads = len(self._threads) - if num_threads < self._max_workers: - thread_name = '%s_%d' % (self._thread_name_prefix or self, - num_threads) - t = threading.Thread(name=thread_name, target=_worker, - args=(weakref.ref(self, weakref_cb), - self._work_queue)) - t.daemon = True - t.start() - self._threads.add(t) - _threads_queues[t] = self._work_queue - - def shutdown(self, wait=True): - with self._shutdown_lock: - self._shutdown = True - self._work_queue.put(None) - if wait: - for t in self._threads: - t.join(sys.maxint) - shutdown.__doc__ = _base.Executor.shutdown.__doc__ diff --git a/.eggs/jmespath-0.9.3-py2.7.egg b/.eggs/jmespath-0.9.3-py2.7.egg deleted file mode 100644 index 9e3c37ea..00000000 Binary files a/.eggs/jmespath-0.9.3-py2.7.egg and /dev/null differ diff --git a/.eggs/s3transfer-0.1.13-py2.7.egg b/.eggs/s3transfer-0.1.13-py2.7.egg deleted file mode 100644 index 5d293ec8..00000000 Binary files a/.eggs/s3transfer-0.1.13-py2.7.egg and /dev/null differ diff --git a/CHANGELOG b/CHANGELOG index 7a9846a7..47ead7e6 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -6,21 +6,28 @@ All notable changes to this project will be documented in this file. The format is based on `Keep a Changelog `_ and this project adheres to `Semantic Versioning `_ -Unreleased +2019-02-15 - 2.1.1 ------------------ Added ~~~~~~~ - +- Several new PREDICT variables to the config. +- Multilabel classification workflow. +- New oversampling strategy. +- RankedSVM multilabel classification and Relief feature selection. Changed ~~~~~~~ +- Major reduction in memory usage, especially due to PREDICT updates. +- Only use first configuration in the classify config. +- Outputs are now in multiple subfolders instead of one big folder. Fixed ~~~~~ - +- Minor bug in test workflow: needed str of label in appending to classify. +- There was a bug in using a .ini file as a config. 2.1.0 - 2018-08-09 diff --git a/README.md b/README.md index 0ae97aa1..a5210a05 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ [![Build Status](https://travis-ci.com/MStarmans91/WORC.svg?token=qyvaeq7Cpwu7hJGB98Gp&branch=master)](https://travis-ci.com/MStarmans91/WORC) -# WORC v2.1.0 +# WORC v2.1.1 ## Workflow for Optimal Radiomics Classification @@ -34,9 +34,13 @@ The documentation can then be viewed in a browser by opening `PACKAGE_ROOT\build WORC currently only supports Unix with Python 2 (>2.7.6) systems. Windows is not supported, although WORC can still work under windows. -The package can be installed through pip (Note due to a bug, the versioning like this is needed): +Please first install PREDICT: - pip install "WORC==2.1.0_2" + pip install PREDICT + +The package can be installed through pip: + + pip install WORC Alternatively, you can directly install WORC from this repository: @@ -78,6 +82,12 @@ mounts['test'] = os.path.join(packagedir, 'WORC', 'resources', 'fastr_tests') Note that the Python site package does not work properly in virtual environments. You must then manually locate the packagedir. +### Optional: Graphviz +WORC can draw the network and save it as a SVG image using [graphviz](https://www.graphviz.org/). In order to do so, +please make sure you install graphviz: + + apt install graphiv + ### Optional: Elastix Image registration is included in WORC through [elastix and transformix](http://elastix.isi.uu.nl/). In order to use elastix, please download the binaries and place them in your @@ -127,6 +137,8 @@ WORC/resources/fastr_tests directory. The example is explained in more detail in ## License This package is covered by the open source [APACHE 2.0 License](APACHE-LICENSE-2.0). +When using WORC, please cite this repository. + ## Contact We are happy to help you with any questions. Please contact us on the [WORC google group](https://groups.google.com/forum/#!forum/worc-users). diff --git a/README.rst b/README.rst index d225b39c..3afa271c 100644 --- a/README.rst +++ b/README.rst @@ -1,6 +1,6 @@ |Build Status| -WORC v2.1.0 +WORC v2.1.1 =========== Workflow for Optimal Radiomics Classification @@ -48,12 +48,25 @@ The documentation can then be viewed in a browser by opening ``PACKAGE_ROOT\build\sphinx\html\index.html``. Installation -------------- +------------ WORC currently only supports Unix with Python 2 (>2.7.6) systems. Windows is not supported, although WORC can still work under windows. -The package can be installed by running the setup file: +Please first install PREDICT: + +:: + + pip install PREDICT + + +The package can be installed through pip: + +:: + + pip install WORC + +Alternatively, you can directly install WORC from this repository: :: @@ -69,6 +82,18 @@ Several tools have some (mandatory) prerequisites which are listed below. We highly recommend you to install these to maximally profit from our toolbox. +PREDICT +~~~~~~~ + +Most of the default tools in WORC use +`PREDICT `__, our in-house +feature extraction and classification toolbox. Currently, you do need to +manually install PREDICT from the Github or with pip: + +:: + + pip install PREDICT + Fastr Configuration ~~~~~~~~~~~~~~~~~~~ @@ -101,6 +126,17 @@ tools, datatypes and mounts to your FASTR configuration Note that the Python site package does not work properly in virtual environments. You must then manually locate the packagedir. +Optional: Graphviz +~~~~~~~~~~~~~~~~~~ + +WORC can draw the network and save it as a SVG image using +`graphviz `__. In order to do so, please make +sure you install graphviz: + +:: + + apt install graphiv + Optional: Elastix ~~~~~~~~~~~~~~~~~ @@ -135,7 +171,7 @@ need to input them on every request: chmod 600 ~/.netrc 3rd-party packages used in WORC: -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------- - FASTR (Workflow design and building) - xnat (Collecting data from XNAT) @@ -172,6 +208,8 @@ License This package is covered by the open source `APACHE 2.0 License `__. +When using WORC, please cite this repository. + Contact ------- diff --git a/WORC.egg-info/PKG-INFO b/WORC.egg-info/PKG-INFO index 420312da..007187fe 100644 --- a/WORC.egg-info/PKG-INFO +++ b/WORC.egg-info/PKG-INFO @@ -1,6 +1,6 @@ Metadata-Version: 1.1 Name: WORC -Version: 2.1.0 +Version: 2.1.1 Summary: Workflow for Optimal Radiomics Classification. Home-page: https://github.com/MStarmans91/WORC Author: M. Starmans @@ -8,7 +8,7 @@ Author-email: m.starmans@erasmusmc.nl License: Apache License, Version 2.0 Description: |Build Status| - WORC v2.1.0 + WORC v2.1.1 =========== Workflow for Optimal Radiomics Classification @@ -56,12 +56,19 @@ Description: |Build Status| ``PACKAGE_ROOT\build\sphinx\html\index.html``. Installation - ------------- + ------------ WORC currently only supports Unix with Python 2 (>2.7.6) systems. Windows is not supported, although WORC can still work under windows. - The package can be installed by running the setup file: + The package can be installed through pip (Note due to a bug, the + versioning like this is needed): + + :: + + pip install WORC + + Alternatively, you can directly install WORC from this repository: :: @@ -77,6 +84,18 @@ Description: |Build Status| below. We highly recommend you to install these to maximally profit from our toolbox. + PREDICT + ~~~~~~~ + + Most of the default tools in WORC use + `PREDICT `__, our in-house + feature extraction and classification toolbox. Currently, you do need to + manually install PREDICT from the Github or with pip: + + :: + + pip install PREDICT + Fastr Configuration ~~~~~~~~~~~~~~~~~~~ @@ -109,6 +128,17 @@ Description: |Build Status| Note that the Python site package does not work properly in virtual environments. You must then manually locate the packagedir. + Optional: Graphviz + ~~~~~~~~~~~~~~~~~~ + + WORC can draw the network and save it as a SVG image using + `graphviz `__. In order to do so, please make + sure you install graphviz: + + :: + + apt install graphiv + Optional: Elastix ~~~~~~~~~~~~~~~~~ @@ -143,7 +173,7 @@ Description: |Build Status| chmod 600 ~/.netrc 3rd-party packages used in WORC: - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + -------------------------------- - FASTR (Workflow design and building) - xnat (Collecting data from XNAT) @@ -180,6 +210,8 @@ Description: |Build Status| This package is covered by the open source `APACHE 2.0 License `__. + When using WORC, please cite this repository. + Contact ------- @@ -196,7 +228,7 @@ Description: |Build Status| Keywords: bioinformatics radiomics features Platform: UNKNOWN -Classifier: Development Status :: 3 - Alpha +Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: Intended Audience :: Science/Research Classifier: Intended Audience :: Healthcare Industry diff --git a/WORC.egg-info/SOURCES.txt b/WORC.egg-info/SOURCES.txt index 2c59f567..a4c6a5bf 100644 --- a/WORC.egg-info/SOURCES.txt +++ b/WORC.egg-info/SOURCES.txt @@ -140,4 +140,44 @@ WORC/resources/fastr_types/ZipFile.py WORC/tools/Elastix.py WORC/tools/Evaluate.py WORC/tools/Transformix.py -WORC/tools/__init__.py \ No newline at end of file +WORC/tools/__init__.py +docs/_build/html/.buildinfo +docs/_build/html/WORC.IOparser.html +docs/_build/html/WORC.html +docs/_build/html/WORC.processing.html +docs/_build/html/WORC.tools.html +docs/_build/html/genindex.html +docs/_build/html/index.html +docs/_build/html/modules.html +docs/_build/html/objects.inv +docs/_build/html/py-modindex.html +docs/_build/html/search.html +docs/_build/html/searchindex.js +docs/_build/html/_sources/WORC.IOparser.rst.txt +docs/_build/html/_sources/WORC.processing.rst.txt +docs/_build/html/_sources/WORC.rst.txt +docs/_build/html/_sources/WORC.tools.rst.txt +docs/_build/html/_sources/index.rst.txt +docs/_build/html/_sources/modules.rst.txt +docs/_build/html/_static/ajax-loader.gif +docs/_build/html/_static/alabaster.css +docs/_build/html/_static/basic.css +docs/_build/html/_static/comment-bright.png +docs/_build/html/_static/comment-close.png +docs/_build/html/_static/comment.png +docs/_build/html/_static/custom.css +docs/_build/html/_static/doctools.js +docs/_build/html/_static/down-pressed.png +docs/_build/html/_static/down.png +docs/_build/html/_static/file.png +docs/_build/html/_static/jquery-3.1.0.js +docs/_build/html/_static/jquery.js +docs/_build/html/_static/minus.png +docs/_build/html/_static/plus.png +docs/_build/html/_static/pygments.css +docs/_build/html/_static/searchtools.js +docs/_build/html/_static/underscore-1.3.1.js +docs/_build/html/_static/underscore.js +docs/_build/html/_static/up-pressed.png +docs/_build/html/_static/up.png +docs/_build/html/_static/websupport.js \ No newline at end of file diff --git a/WORC.egg-info/requires.txt b/WORC.egg-info/requires.txt index 1fb403d4..2586c8b7 100644 --- a/WORC.egg-info/requires.txt +++ b/WORC.egg-info/requires.txt @@ -11,3 +11,4 @@ six>=1.10.0 sphinx>=1.4 pyOpenSSL>=16.2.0 boto3>=1.7.74 +PREDICT diff --git a/WORC/IOparser/config_WORC.py b/WORC/IOparser/config_WORC.py index caa60e90..5743a880 100644 --- a/WORC/IOparser/config_WORC.py +++ b/WORC/IOparser/config_WORC.py @@ -36,27 +36,18 @@ def load_config(config_file_path): 'SVMFeatures': dict()} settings_dict['ImageFeatures']['image_type'] =\ - [str(item).strip() for item in - settings['ImageFeatures']['image_type'].split(',')] - - settings_dict['General']['patientclass'] =\ - str(settings['General']['patientclass']) + str(settings['ImageFeatures']['image_type']) settings_dict['General']['FeatureCalculator'] =\ str(settings['General']['FeatureCalculator']) + settings_dict['General']['Preprocessing'] =\ + str(settings['General']['Preprocessing']) + settings_dict['General']['PCE'] =\ settings['General'].getboolean('PCE') settings_dict['General']['Segmentix'] =\ settings['General'].getboolean('Segmentix') - # settings_dict['General']['gridsearch_SVM'] =\ - # str(settings['General']['gridsearch_SVM']) - - # for key in settings['SVMFeatures'].keys(): - # settings_dict['SVMFeatures'][key] =\ - # [str(item).strip() for item in - # settings['SVMFeatures'][key].split(',')] - return settings_dict diff --git a/WORC/IOparser/config_WORC.pyc b/WORC/IOparser/config_WORC.pyc index fd75133d..4ad6a215 100644 Binary files a/WORC/IOparser/config_WORC.pyc and b/WORC/IOparser/config_WORC.pyc differ diff --git a/WORC/IOparser/config_preprocessing.py b/WORC/IOparser/config_preprocessing.py index ce358c19..514c39ed 100644 --- a/WORC/IOparser/config_preprocessing.py +++ b/WORC/IOparser/config_preprocessing.py @@ -35,7 +35,7 @@ def load_config(config_file_path): settings_dict = {'Normalize': dict(), 'ImageFeatures': dict()} settings_dict['Normalize']['ROI'] =\ - settings['Normalize'].getboolean('ROI') + str(settings['Normalize']['ROI']) settings_dict['Normalize']['Method'] =\ str(settings['Normalize']['Method']) diff --git a/WORC/IOparser/config_segmentix.pyc b/WORC/IOparser/config_segmentix.pyc index 3cbb3853..e9487ec1 100644 Binary files a/WORC/IOparser/config_segmentix.pyc and b/WORC/IOparser/config_segmentix.pyc differ diff --git a/WORC/WORC.py b/WORC/WORC.py index 068e6b4f..e82f972e 100644 --- a/WORC/WORC.py +++ b/WORC/WORC.py @@ -174,10 +174,11 @@ def defaultconfig(self): config['Segmentix']['segtype'] = 'None' config['Segmentix']['segradius'] = '5' config['Segmentix']['N_blobs'] = '1' + config['Segmentix']['fillholes'] = 'False' # Preprocessing config['Normalize'] = dict() - config['Normalize']['ROI'] = 'False' + config['Normalize']['ROI'] = 'Full' config['Normalize']['Method'] = 'z_score' # PREDICT - Feature calculation @@ -222,7 +223,7 @@ def defaultconfig(self): # Vessel features radius for erosion to determine boudnary config['ImageFeatures']['vessel_radius'] = '5' - ## PREDICT - Feature selection + # PREDICT - Feature selection config['Featsel'] = dict() config['Featsel']['Variance'] = 'True' config['Featsel']['SelectFromModel'] = 'False' @@ -231,13 +232,24 @@ def defaultconfig(self): config['Featsel']['StatisticalTestUse'] = 'False' config['Featsel']['StatisticalTestMetric'] = 'ttest, Welch, Wilcoxon, MannWhitneyU' config['Featsel']['StatisticalTestThreshold'] = '0.02, 0.2' + config['Featsel']['ReliefUse'] = 'False' + config['Featsel']['ReliefNN'] = '2, 4' + config['Featsel']['ReliefSampleSize'] = '1, 1' + config['Featsel']['ReliefDistanceP'] = '1, 3' + config['Featsel']['ReliefNumFeatures'] = '25, 200' # PREDICT - Gridsearch options config['SelectFeatGroup'] = dict() config['SelectFeatGroup']['shape_features'] = 'True, False' config['SelectFeatGroup']['histogram_features'] = 'True, False' config['SelectFeatGroup']['orientation_features'] = 'True, False' - config['SelectFeatGroup']['texture_features'] = 'True, False' + config['SelectFeatGroup']['texture_Gabor_features'] = 'True, False' + config['SelectFeatGroup']['texture_GLCM_features'] = 'True, False' + config['SelectFeatGroup']['texture_GLCMMS_features'] = 'True, False' + config['SelectFeatGroup']['texture_GLRLM_features'] = 'True, False' + config['SelectFeatGroup']['texture_GLSZM_features'] = 'True, False' + config['SelectFeatGroup']['texture_NGTDM_features'] = 'True, False' + config['SelectFeatGroup']['texture_LBP_features'] = 'True, False' config['SelectFeatGroup']['patient_features'] = 'False' config['SelectFeatGroup']['semantic_features'] = 'False' config['SelectFeatGroup']['coliage_features'] = 'False' @@ -245,13 +257,13 @@ def defaultconfig(self): config['SelectFeatGroup']['vessel_features'] = 'False' config['SelectFeatGroup']['phase_features'] = 'False' - ## PREDICT - Feature imputation + # PREDICT - Feature imputation config['Imputation'] = dict() config['Imputation']['use'] = 'False' config['Imputation']['strategy'] = 'mean' config['Imputation']['n_neighbors'] = '5' - ## PREDICT - Classification + # PREDICT - Classification config['Classification'] = dict() config['Classification']['fastr'] = 'False' config['Classification']['fastr_plugin'] = self.fastr_plugin @@ -259,12 +271,13 @@ def defaultconfig(self): config['Classification']['Kernel'] = 'polynomial' config['CrossValidation'] = dict() - config['CrossValidation']['N_iterations'] = '50' + config['CrossValidation']['N_iterations'] = '100' config['CrossValidation']['test_size'] = '0.2' # PREDICT - Options for the labels that are used (not only genetics) config['Genetics'] = dict() config['Genetics']['label_names'] = 'Label1, Label2' + config['Genetics']['modus'] = 'singlelabel' config['Genetics']['url'] = 'WIP' config['Genetics']['projectID'] = 'WIP' @@ -285,6 +298,7 @@ def defaultconfig(self): config['SampleProcessing']['SMOTE'] = 'True' config['SampleProcessing']['SMOTE_ratio'] = '1.0' config['SampleProcessing']['SMOTE_neighbors'] = '10' + config['SampleProcessing']['Oversampling'] = 'False' # PREDICT - Ensemble options config['Ensemble'] = dict() @@ -338,9 +352,9 @@ def build_training(self): # BUG: We currently use the first configuration as general config image_types = list() for c in range(len(self.configs)): - if type(self.configs[c]) == str(): + if type(self.configs[c]) == str: # Probably, c is a configuration file - self.configs[c] = config_io.load_config(c) + self.configs[c] = config_io.load_config(self.configs[c]) image_types.append(self.configs[c]['ImageFeatures']['image_type']) # Classification tool and label source @@ -731,7 +745,7 @@ def build_training(self): self.network.sinks_segmentations_segmentix_train[label].input = self.network.nodes_segmentix_train[label].outputs['segmentation_out'] if self.images_test or self.features_test: - self.network.sinks_segmentations_segmentix_test[label] = self.network.create_sink('ITKImageFile', id_='segmentation_out_segmentix_test_' + label) + self.network.sinks_segmentations_segmentix_test[label] = self.network.create_sink('ITKImageFile', id_='segmentations_out_segmentix_test_' + label) self.network.nodes_segmentix_test[label] = self.network.create_node('Segmentix', memory='6G', id_='segmentix_test_' + label) if hasattr(self.network, 'transformix_seg_nodes_test'): if label in self.network.transformix_seg_nodes_test.keys(): @@ -781,7 +795,7 @@ def build_training(self): if self.images_test or self.features_test: # Add the features from this modality to the classifier node input - self.network.links_C1_test[label] = self.network.classify.inputs['features_test'][label] << self.network.calcfeatures_test[label].outputs['features'] + self.network.links_C1_test[label] = self.network.classify.inputs['features_test'][str(label)] << self.network.calcfeatures_test[label].outputs['features'] self.network.links_C1_test[label].collapse = 'test' # Save output @@ -850,17 +864,22 @@ def set(self): # If the configuration files are confiparse objects, write to file for num, c in enumerate(self.configs): - if type(c) == configparser.ConfigParser: - cfile = os.path.join(fastr.config.mounts['tmp'], self.name, ("config_{}_{}.ini").format(self.name, num)) - if not os.path.exists(os.path.dirname(cfile)): - os.makedirs(os.path.dirname(cfile)) - with open(cfile, 'w') as configfile: - c.write(configfile) - self.fastrconfigs.append(os.path.join("vfs://tmp/", self.name, ("config_{}_{}.ini").format(self.name, num))) + if type(c) != configparser.ConfigParser: + # A filepath (not a fastr source) is provided. Hence we read + # the config file and convert it to a configparser object + config = configparser.ConfigParser() + config.read(c) + c = config + cfile = os.path.join(fastr.config.mounts['tmp'], self.name, ("config_{}_{}.ini").format(self.name, num)) + if not os.path.exists(os.path.dirname(cfile)): + os.makedirs(os.path.dirname(cfile)) + with open(cfile, 'w') as configfile: + c.write(configfile) + self.fastrconfigs.append(os.path.join("vfs://tmp/", self.name, ("config_{}_{}.ini").format(self.name, num))) # Generate gridsearch parameter files if required # TODO: We now use the first configuration for the classifier, but his needs to be separated from the rest per modality - self.source_data['config_classification'] = self.fastrconfigs + self.source_data['config_classification'] = self.fastrconfigs[0] # Set source and sink data self.source_data['patientclass_train'] = self.labels_train @@ -943,24 +962,24 @@ def set(self): if self.features_test and len(self.features_test) - 1 >= num: self.source_data['features_test_' + label] = self.features_test[num] - self.sink_data['segmentations_out_segmentix_train_' + label] = ("vfs://output/{}/seg_{}_segmentix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['segmentations_out_elastix_train_' + label] = ("vfs://output/{}/seg_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['images_out_elastix_train_' + label] = ("vfs://output/{}/im_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['features_train_' + label] = ("vfs://output/{}/features_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['segmentations_out_segmentix_train_' + label] = ("vfs://output/{}/Segmentations/seg_{}_segmentix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['segmentations_out_elastix_train_' + label] = ("vfs://output/{}/Elastix/seg_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['images_out_elastix_train_' + label] = ("vfs://output/{}/Elastix/im_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['features_train_' + label] = ("vfs://output/{}/Features/features_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) if self.labels_test: - self.sink_data['segmentations_out_segmentix_test_' + label] = ("vfs://output/{}/seg_{}_segmentix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['segmentations_out_elastix_test_' + label] = ("vfs://output/{}/seg_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['images_out_elastix_test_' + label] = ("vfs://output/{}/im_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) - self.sink_data['features_test_' + label] = ("vfs://output/{}/features_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['segmentations_out_segmentix_test_' + label] = ("vfs://output/Segmentations/{}/seg_{}_segmentix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['segmentations_out_elastix_test_' + label] = ("vfs://output/{}/Elastix/seg_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['images_out_elastix_test_' + label] = ("vfs://output/{}/Images/im_{}_elastix_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['features_test_' + label] = ("vfs://output/{}/Features/features_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) # Add elastix sinks if used if self.segmode: # Segmode is only non-empty if segmentations are provided if self.segmode == 'Register': - self.sink_data['transformations_train_' + label] = ("vfs://output/{}/transformation_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['transformations_train_' + label] = ("vfs://output/{}/Elastix/transformation_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) if self.images_test or self.features_test: - self.sink_data['transformations_test_' + label] = ("vfs://output/{}/transformation_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) + self.sink_data['transformations_test_' + label] = ("vfs://output/{}/Elastix/transformation_{}_{{sample_id}}_{{cardinality}}{{ext}}").format(self.name, label) def execute(self): """ Execute the network through the fastr.network.execute command. """ diff --git a/WORC/WORC.pyc b/WORC/WORC.pyc index df2ecdc6..425c6a77 100644 Binary files a/WORC/WORC.pyc and b/WORC/WORC.pyc differ diff --git a/WORC/processing/ExtractNLargestBlobsn.pyc b/WORC/processing/ExtractNLargestBlobsn.pyc index b746088e..68f058ad 100644 Binary files a/WORC/processing/ExtractNLargestBlobsn.pyc and b/WORC/processing/ExtractNLargestBlobsn.pyc differ diff --git a/WORC/resources/fastr_tools/worc/bin/preprocessing.py b/WORC/resources/fastr_tools/worc/bin/preprocessing.py index ad88d519..b82d2953 100644 --- a/WORC/resources/fastr_tools/worc/bin/preprocessing.py +++ b/WORC/resources/fastr_tools/worc/bin/preprocessing.py @@ -76,16 +76,16 @@ def main(): metadata.RescaleIntercept # Apply the preprocessing - if not config['Normalize']['ROI']: + if config['Normalize']['ROI'] == 'Full': print('Apply z-scoring on full image.') image = sitk.Normalize(image) - else: + elif config['Normalize']['ROI'] == 'True': print('Apply scaling of image based on a Region Of Interest.') if args.mask is None: raise IOError('Mask input required for ROI normalization.') else: if config['Normalize']['Method'] == 'z_score': - # Apply scaling using z-scoring based on the ROI + print('Apply scaling using z-scoring based on the ROI') # Cast to float to allow proper processing image = sitk.Cast(image, 9) @@ -99,7 +99,7 @@ def main(): shift=-ROI_mean, scale=1.0/ROI_std) elif config['Normalize']['Method'] == 'minmed': - # Apply scaling using the minimum and mean of the ROI + print('Apply scaling using the minimum and mean of the ROI') image = sitk.Cast(image, 9) LabelFilter = sitk.LabelStatisticsImageFilter() @@ -110,6 +110,8 @@ def main(): image = sitk.ShiftScale(image, shift=-ROI_minimum, scale=0.5/ROI_median) + else: + print('No preprocessing was applied.') # Save the output sitk.WriteImage(image, args.out) diff --git a/WORC/resources/fastr_tools/worc/segmentix/bin/segmentix.pyc b/WORC/resources/fastr_tools/worc/segmentix/bin/segmentix.pyc index a431ea36..66402c0b 100644 Binary files a/WORC/resources/fastr_tools/worc/segmentix/bin/segmentix.pyc and b/WORC/resources/fastr_tools/worc/segmentix/bin/segmentix.pyc differ diff --git a/WORC/tools/Evaluate.py b/WORC/tools/Evaluate.py index 3dd4c6a1..6ca15935 100644 --- a/WORC/tools/Evaluate.py +++ b/WORC/tools/Evaluate.py @@ -26,7 +26,7 @@ class Evaluate(object): def __init__(self, label_type, ensemble=50, scores='percentages', network=None, features=None, fastr_plugin='ProcessPoolExecution', - name='Evaluate'): + name='Example'): ''' Build a network that evaluates the performance of an estimator. @@ -45,7 +45,7 @@ def __init__(self, label_type, ensemble=50, scores='percentages', self.network = fastr.Network(id_="Evaluate") self.mode = 'StandAlone' self.fastr_plugin = fastr_plugin - self.name = name + self.name = 'WORC_Evaluate_' + name self.fastr_tmpdir = os.path.join(fastr.config.mounts['tmp'], self.name) if features is None and self.mode == 'StandAlone': @@ -65,17 +65,17 @@ def create_network(self): # Create all nodes self.network.node_ROC =\ - self.network.create_node('PlotROC', memory='4G', id_='plot_ROC') + self.network.create_node('PlotROC', memory='20G', id_='plot_ROC') self.network.node_SVM =\ - self.network.create_node('PlotSVM', memory='4G', id_='plot_SVM') + self.network.create_node('PlotSVM', memory='20G', id_='plot_SVM') self.network.node_Barchart =\ self.network.create_node('PlotBarchart', memory='4G', id_='plot_Barchart') self.network.node_STest =\ self.network.create_node('StatisticalTestFeatures', memory='4G', id_='statistical_test_features') self.network.node_Ranked_Percentages =\ - self.network.create_node('PlotRankedScores', memory='4G', id_='plot_ranked_percentages') + self.network.create_node('PlotRankedScores', memory='20G', id_='plot_ranked_percentages') self.network.node_Ranked_Posteriors =\ - self.network.create_node('PlotRankedScores', memory='4G', id_='plot_ranked_posteriors') + self.network.create_node('PlotRankedScores', memory='20G', id_='plot_ranked_posteriors') # Create sinks self.network.sink_ROC_PNG =\ diff --git a/dist/WORC-2.1.0_2.tar.gz b/dist/WORC-2.1.0_2.tar.gz deleted file mode 100644 index 368bda59..00000000 Binary files a/dist/WORC-2.1.0_2.tar.gz and /dev/null differ diff --git a/dist/WORC-2.1.1.tar.gz b/dist/WORC-2.1.1.tar.gz new file mode 100644 index 00000000..fa2ab7ab Binary files /dev/null and b/dist/WORC-2.1.1.tar.gz differ diff --git a/docs/Makefile b/docs/Makefile index 278e6ff3..c0118b42 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -5,8 +5,8 @@ SPHINXOPTS = SPHINXBUILD = sphinx-build SPHINXPROJ = WORC -SOURCEDIR = source -BUILDDIR = build +SOURCEDIR = . +BUILDDIR = _build # Put it first so that "make" without argument is like "make help". help: diff --git a/docs/WORC.IOparser.rst b/docs/WORC.IOparser.rst index 1ec14d16..35cddac7 100644 --- a/docs/WORC.IOparser.rst +++ b/docs/WORC.IOparser.rst @@ -4,24 +4,24 @@ WORC.IOparser package Submodules ---------- -WORC.IOparser.config\_WORC module ---------------------------------- +WORC.IOparser.config_WORC module +-------------------------------- .. automodule:: WORC.IOparser.config_WORC :members: :undoc-members: :show-inheritance: -WORC.IOparser.config\_preprocessing module ------------------------------------------- +WORC.IOparser.config_preprocessing module +----------------------------------------- .. automodule:: WORC.IOparser.config_preprocessing :members: :undoc-members: :show-inheritance: -WORC.IOparser.config\_segmentix module --------------------------------------- +WORC.IOparser.config_segmentix module +------------------------------------- .. automodule:: WORC.IOparser.config_segmentix :members: diff --git a/docs/_build/doctrees/WORC.IOparser.doctree b/docs/_build/doctrees/WORC.IOparser.doctree new file mode 100644 index 00000000..7bc7f1a4 Binary files /dev/null and b/docs/_build/doctrees/WORC.IOparser.doctree differ diff --git a/docs/_build/doctrees/WORC.doctree b/docs/_build/doctrees/WORC.doctree new file mode 100644 index 00000000..e3a68363 Binary files /dev/null and b/docs/_build/doctrees/WORC.doctree differ diff --git a/docs/_build/doctrees/WORC.processing.doctree b/docs/_build/doctrees/WORC.processing.doctree new file mode 100644 index 00000000..0420e329 Binary files /dev/null and b/docs/_build/doctrees/WORC.processing.doctree differ diff --git a/docs/_build/doctrees/WORC.tools.doctree b/docs/_build/doctrees/WORC.tools.doctree new file mode 100644 index 00000000..ce2d0575 Binary files /dev/null and b/docs/_build/doctrees/WORC.tools.doctree differ diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle new file mode 100644 index 00000000..5fbca10f Binary files /dev/null and b/docs/_build/doctrees/environment.pickle differ diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree new file mode 100644 index 00000000..88c1983b Binary files /dev/null and b/docs/_build/doctrees/index.doctree differ diff --git a/docs/_build/doctrees/modules.doctree b/docs/_build/doctrees/modules.doctree new file mode 100644 index 00000000..1bde6640 Binary files /dev/null and b/docs/_build/doctrees/modules.doctree differ diff --git a/docs/build/html/.buildinfo b/docs/_build/html/.buildinfo similarity index 82% rename from docs/build/html/.buildinfo rename to docs/_build/html/.buildinfo index 7865d498..d9d0ee9b 100644 --- a/docs/build/html/.buildinfo +++ b/docs/_build/html/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 48e21ef0e99f2acb95f5fb6695709a8d +config: 84e41921f4afb45f609a372870d7d850 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_build/html/WORC.IOparser.html b/docs/_build/html/WORC.IOparser.html new file mode 100644 index 00000000..bd6bb434 --- /dev/null +++ b/docs/_build/html/WORC.IOparser.html @@ -0,0 +1,160 @@ + + + + + + + + WORC.IOparser package — WORC 2.1.1 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

WORC.IOparser package

+
+

Submodules

+
+
+

WORC.IOparser.config_WORC module

+
+
+WORC.IOparser.config_WORC.load_config(config_file_path)
+

Parse a WORC configuration file.

+
+
Arguments:
+
config_file_path: path to the configuration file to be parsed.
+
Returns:
+
settings_dict: dictionary containing all parsed settings.
+
+
+ +
+
+

WORC.IOparser.config_preprocessing module

+
+
+WORC.IOparser.config_preprocessing.load_config(config_file_path)
+

Parse a WORC configuration file.

+
+
Arguments:
+
config_file_path: path to the configuration file to be parsed.
+
Returns:
+
settings_dict: dictionary containing all parsed settings.
+
+
+ +
+
+

WORC.IOparser.config_segmentix module

+
+
+WORC.IOparser.config_segmentix.load_config(config_file_path)
+

Parse a segmentix configuration file.

+
+
Arguments:
+
config_file_path: path to the configuration file to be parsed.
+
Returns:
+
settings_dict: dictionary containing all parsed settings.
+
+
+ +
+
+

Module contents

+
+
+ + +
+
+
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/_build/html/WORC.html b/docs/_build/html/WORC.html new file mode 100644 index 00000000..a6b6fd3f --- /dev/null +++ b/docs/_build/html/WORC.html @@ -0,0 +1,311 @@ + + + + + + + + WORC package — WORC 2.1.1 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

WORC package

+ +
+

Submodules

+
+
+

WORC.WORC module

+
+
+class WORC.WORC.Tools
+

Bases: object

+

This object can be used to create other pipelines besides the default +Radiomics executions. Currently only includes a registratio pipeline.

+
+ +
+
+class WORC.WORC.WORC(name='WORC')
+

Bases: object

+

A Workflow for Optimal Radiomics Classification (WORC) object that +serves as a pipeline spawner and manager for optimizating radiomics +studies. Depending on the attributes set, the object will spawn an +appropriate pipeline and manage it.

+

Note that many attributes are lists and can therefore contain multiple +instances. For example, when providing two sequences per patient, +the “images” list contains two items. The type of items in the lists +is described below.

+

All objects that serve as source for your network, i.e. refer to +actual files to be used, should be formatted as fastr sources suited for +one of the fastr plugings, see also +http://fastr.readthedocs.io/en/stable/fastr.reference.html#ioplugin-reference +The objects should be lists of these fastr sources or dictionaries with the +sample ID’s, e.g.

+
+
images_train = [{‘Patient001’: vfs://input/CT001.nii.gz,
+
+
‘Patient002’: vfs://input/CT002.nii.gz},
+
+
{‘Patient001’: vfs://input/MR001.nii.gz,
+
‘Patient002’: vfs://input/MR002.nii.gz}]
+
+
+
+
+
+
name: String, default ‘WORC’
+
name of the network.
+
configs: list, required
+
Configuration parameters, either ConfigParser objects +created through the defaultconfig function or paths of config .ini +files. (list, required)
+
labels: list, required
+
Paths to files containing patient labels (.txt files).
+
network: automatically generated
+
The FASTR network generated through the “build” function.
+
images: list, optional
+
Paths refering to the images used for Radiomics computation. Images +should be of the ITK Image type.
+
segmentations: list, optional
+
Paths refering to the segmentations used for Radiomics computation. +Segmentations should be of the ITK Image type.
+
+

semantics: semantic features per image type (list, optional)

+

masks: state which pixels of images are valid (list, optional)

+

features: input Radiomics features for classification (list, optional)

+

metadata: DICOM headers belonging to images (list, optional)

+

Elastix_Para: parameter files for Elastix (list, optional)

+

fastr_plugin: plugin to use for FASTR execution

+

fastr_tempdir: temporary directory to use for FASTR execution

+

additions: additional inputs for your network (dict, optional)

+

source_data: data to use as sources for FASTR (dict)

+

sink_data: data to use as sinks for FASTR (dict)

+
+
CopyMetadata: Boolean, default True
+
when using elastix, copy metadata from image to segmentation or not
+
+
+
+
+add_tools()
+
+ +
+
+build(wtype='training')
+

Build the network based on the given attributes.

+
+
wtype: string, default ‘training’
+

Specify the WORC execution type. +- testing: use if you have a trained classifier and want to

+
+
train it on some new images.
+
    +
  • training: use if you want to train a classifier from a dataset.
  • +
+
+
+
+ +
+
+build_testing()
+

todo

+
+ +
+
+build_training()
+

Build the training network based on the given attributes.

+
+ +
+
+defaultconfig()
+

Generate a configparser object holding all default configuration values.

+
+
Returns:
+
config: configparser configuration file
+
+
+ +
+
+execute()
+

Execute the network through the fastr.network.execute command.

+
+ +
+
+set()
+

Set the FASTR source and sink data based on the given attributes.

+
+ +
+ +
+
+

WORC.addexceptions module

+

This module contains all WORC-related Exceptions

+
+
+exception WORC.addexceptions.WORCError
+

Bases: exceptions.Exception

+

This is the base class for all WORC related exceptions. Catching this +class of exceptions should ensure a proper execution of WORC.

+
+ +
+
+exception WORC.addexceptions.WORCIOError
+

Bases: WORC.addexceptions.WORCError, exceptions.IOError

+

IOError in WORC

+
+ +
+
+exception WORC.addexceptions.WORCNotImplementedError
+

Bases: WORC.addexceptions.WORCError, exceptions.NotImplementedError

+

This function/method has not been implemented on purpose (e.g. should be +overwritten in a sub-class)

+
+ +
+
+exception WORC.addexceptions.WORCTypeError
+

Bases: WORC.addexceptions.WORCError, exceptions.TypeError

+

TypeError in the WORC system

+
+ +
+
+

Module contents

+
+
+ + +
+
+
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/_build/html/WORC.processing.html b/docs/_build/html/WORC.processing.html new file mode 100644 index 00000000..2a86cc40 --- /dev/null +++ b/docs/_build/html/WORC.processing.html @@ -0,0 +1,210 @@ + + + + + + + + WORC.processing package — WORC 2.1.1 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

WORC.processing package

+
+

Submodules

+
+
+

WORC.processing.ExtractNLargestBlobsn module

+
+
+WORC.processing.ExtractNLargestBlobsn.ExtractNLargestBlobsn(binaryImage, numberToExtract=1)
+

Extract N largest blobs from binary image.

+
+
Arguments:
+
binaryImage: boolean numpy array one or several contours. +numberToExtract: number of blobs to extract (integer).
+
Returns:
+
+
binaryImage: boolean numpy are containing only the N
+
extracted blobs.
+
+
+
+
+ +
+
+

WORC.processing.RTStructReader module

+

@author: Zhenwei.Shi, Maastro

+

usage:

+
+

paste this file in same directory as your main script file +and use the following lines

+

import DCM_ImgRT_Reader_ZW

+

path1=r’c:ABCFolderContainingDicomOfimageCTscan’ +path2=r’c:ABCFolderContainingDicomOfRTstruct’ +DCM_ImgRT_Reader_ZW.Img_Bimask(image_path=path1,rtstruct_path=path2,ROI_name)

+
+
+
+WORC.processing.RTStructReader.ROI_ref(rtstruct_path, ROI_name)
+
+ +
+
+WORC.processing.RTStructReader.RTStructReader(RTStructFile, ROI_name, image_folder)
+
+
Input:
+

image_path is directory containing dicom files +rtstruct_path is directory containing RTstruct files

+
+
ROI_name is the ROI stored in RTstructure
+
+
Output:
+
mask file written in current directory +image volume file written in current directory
+
+
+ +
+
+WORC.processing.RTStructReader.get_dicoms(input_dir, logfile=None)
+
+ +
+
+WORC.processing.RTStructReader.get_pixels(scan)
+
+ +
+
+WORC.processing.RTStructReader.load_dicom(dicom_folder)
+
+ +
+
+WORC.processing.RTStructReader.match_ROIid(rtstruct_path, ROI_number)
+
+ +
+
+WORC.processing.RTStructReader.poly2mask(vertex_row_coords, vertex_col_coords, shape)
+
+ +
+
+

WORC.processing.classes module

+
+
+class WORC.processing.classes.switch(value)
+

Bases: object

+

Object to mimic the MATLAB switch - case statement.

+
+
+match(*args)
+

Indicate whether or not to enter a case suite

+
+ +
+ +
+
+

Module contents

+
+
+ + +
+
+
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/_build/html/WORC.tools.html b/docs/_build/html/WORC.tools.html new file mode 100644 index 00000000..b0033417 --- /dev/null +++ b/docs/_build/html/WORC.tools.html @@ -0,0 +1,197 @@ + + + + + + + + WORC.tools package — WORC 2.1.1 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

WORC.tools package

+
+

Submodules

+
+
+

WORC.tools.Elastix module

+
+
+class WORC.tools.Elastix.Elastix
+

Bases: object

+
+
+addchangeorder()
+
+ +
+
+create_bbox(seg, pad=[2, 25, 25])
+

Create a bounding box around an input segmentation +with a certain padding

+
+ +
+
+create_network(nettype)
+
+ +
+
+execute()
+
+ +
+
+getparametermap(model='affine', size=(512, 512, 128))
+
+ +
+ +
+
+

WORC.tools.Evaluate module

+
+
+class WORC.tools.Evaluate.Evaluate(label_type, ensemble=50, scores='percentages', network=None, features=None, fastr_plugin='ProcessPoolExecution', name='Example')
+

Bases: object

+
+
+create_network()
+

Add evaluate components to network.

+
+ +
+
+execute()
+

Execute the network through the fastr.network.execute command.

+
+ +
+
+set(estimator=None, pinfo=None, images=None, segmentations=None, config=None, features=None, sink_data={})
+

Set the sources and sinks based on the provided attributes.

+
+ +
+ +
+
+

WORC.tools.Transformix module

+
+
+class WORC.tools.Transformix.Transformix
+

Bases: object

+
+
+create_network()
+
+ +
+
+execute()
+
+ +
+ +
+
+

Module contents

+
+
+ + +
+
+
+ +
+
+ + + + + + + \ No newline at end of file diff --git a/docs/_build/html/_sources/WORC.IOparser.rst.txt b/docs/_build/html/_sources/WORC.IOparser.rst.txt new file mode 100644 index 00000000..35cddac7 --- /dev/null +++ b/docs/_build/html/_sources/WORC.IOparser.rst.txt @@ -0,0 +1,38 @@ +WORC.IOparser package +===================== + +Submodules +---------- + +WORC.IOparser.config_WORC module +-------------------------------- + +.. automodule:: WORC.IOparser.config_WORC + :members: + :undoc-members: + :show-inheritance: + +WORC.IOparser.config_preprocessing module +----------------------------------------- + +.. automodule:: WORC.IOparser.config_preprocessing + :members: + :undoc-members: + :show-inheritance: + +WORC.IOparser.config_segmentix module +------------------------------------- + +.. automodule:: WORC.IOparser.config_segmentix + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: WORC.IOparser + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/WORC.processing.rst.txt b/docs/_build/html/_sources/WORC.processing.rst.txt new file mode 100644 index 00000000..1e968aed --- /dev/null +++ b/docs/_build/html/_sources/WORC.processing.rst.txt @@ -0,0 +1,38 @@ +WORC.processing package +======================= + +Submodules +---------- + +WORC.processing.ExtractNLargestBlobsn module +-------------------------------------------- + +.. automodule:: WORC.processing.ExtractNLargestBlobsn + :members: + :undoc-members: + :show-inheritance: + +WORC.processing.RTStructReader module +------------------------------------- + +.. automodule:: WORC.processing.RTStructReader + :members: + :undoc-members: + :show-inheritance: + +WORC.processing.classes module +------------------------------ + +.. automodule:: WORC.processing.classes + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: WORC.processing + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/WORC.rst.txt b/docs/_build/html/_sources/WORC.rst.txt new file mode 100644 index 00000000..0ac3b73c --- /dev/null +++ b/docs/_build/html/_sources/WORC.rst.txt @@ -0,0 +1,39 @@ +WORC package +============ + +Subpackages +----------- + +.. toctree:: + + WORC.IOparser + WORC.processing + WORC.tools + +Submodules +---------- + +WORC.WORC module +---------------- + +.. automodule:: WORC.WORC + :members: + :undoc-members: + :show-inheritance: + +WORC.addexceptions module +------------------------- + +.. automodule:: WORC.addexceptions + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: WORC + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/WORC.tools.rst.txt b/docs/_build/html/_sources/WORC.tools.rst.txt new file mode 100644 index 00000000..dd491568 --- /dev/null +++ b/docs/_build/html/_sources/WORC.tools.rst.txt @@ -0,0 +1,38 @@ +WORC.tools package +================== + +Submodules +---------- + +WORC.tools.Elastix module +------------------------- + +.. automodule:: WORC.tools.Elastix + :members: + :undoc-members: + :show-inheritance: + +WORC.tools.Evaluate module +-------------------------- + +.. automodule:: WORC.tools.Evaluate + :members: + :undoc-members: + :show-inheritance: + +WORC.tools.Transformix module +----------------------------- + +.. automodule:: WORC.tools.Transformix + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: WORC.tools + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/build/html/_sources/index.rst.txt b/docs/_build/html/_sources/index.rst.txt similarity index 82% rename from docs/build/html/_sources/index.rst.txt rename to docs/_build/html/_sources/index.rst.txt index 9d30b71f..9e4c8aab 100644 --- a/docs/build/html/_sources/index.rst.txt +++ b/docs/_build/html/_sources/index.rst.txt @@ -1,12 +1,12 @@ .. WORC documentation master file, created by - sphinx-quickstart on Fri Aug 10 13:26:24 2018. + sphinx-quickstart on Fri Feb 15 17:36:43 2019. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Welcome to WORC's documentation! ================================ -.. include:: ../../README.rst + .. include:: ../README.rst .. toctree:: :maxdepth: 2 diff --git a/docs/_build/html/_sources/modules.rst.txt b/docs/_build/html/_sources/modules.rst.txt new file mode 100644 index 00000000..2ca6467a --- /dev/null +++ b/docs/_build/html/_sources/modules.rst.txt @@ -0,0 +1,7 @@ +WORC +==== + +.. toctree:: + :maxdepth: 4 + + WORC diff --git a/docs/build/html/_static/ajax-loader.gif b/docs/_build/html/_static/ajax-loader.gif similarity index 100% rename from docs/build/html/_static/ajax-loader.gif rename to docs/_build/html/_static/ajax-loader.gif diff --git a/docs/build/html/_static/alabaster.css b/docs/_build/html/_static/alabaster.css similarity index 93% rename from docs/build/html/_static/alabaster.css rename to docs/_build/html/_static/alabaster.css index 25e77387..be65b137 100644 --- a/docs/build/html/_static/alabaster.css +++ b/docs/_build/html/_static/alabaster.css @@ -1,9 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @import url("basic.css"); /* -- page layout ----------------------------------------------------------- */ body { - font-family: Georgia, serif; + font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; font-size: 17px; background-color: #fff; color: #000; @@ -107,7 +159,7 @@ div.sphinxsidebarwrapper p.blurb { div.sphinxsidebar h3, div.sphinxsidebar h4 { - font-family: Georgia, serif; + font-family: 'Garamond', 'Georgia', serif; color: #444; font-size: 24px; font-weight: normal; @@ -151,7 +203,7 @@ div.sphinxsidebar ul li.toctree-l2 > a { div.sphinxsidebar input { border: 1px solid #CCC; - font-family: Georgia, serif; + font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; font-size: 1em; } @@ -184,7 +236,7 @@ div.body h3, div.body h4, div.body h5, div.body h6 { - font-family: Georgia, serif; + font-family: 'Garamond', 'Georgia', serif; font-weight: normal; margin: 30px 0px 10px 0px; padding: 0; @@ -225,7 +277,7 @@ div.admonition tt.xref, div.admonition code.xref, div.admonition a tt { } div.admonition p.admonition-title { - font-family: Georgia, serif; + font-family: 'Garamond', 'Georgia', serif; font-weight: normal; font-size: 24px; margin: 0 0 10px 0; @@ -638,51 +690,4 @@ table.docutils.citation, table.docutils.citation td, table.docutils.citation th -moz-box-shadow: none; -webkit-box-shadow: none; box-shadow: none; -} - - -/* relbar */ - -.related { - line-height: 30px; - width: 100%; - font-size: 0.9rem; -} - -.related.top { - border-bottom: 1px solid #EEE; - margin-bottom: 20px; -} - -.related.bottom { - border-top: 1px solid #EEE; -} - -.related ul { - padding: 0; - margin: 0; - list-style: none; -} - -.related li { - display: inline; -} - -nav#rellinks { - float: right; -} - -nav#rellinks li+li:before { - content: "|"; -} - -nav#breadcrumbs li+li:before { - content: "\00BB"; -} - -/* Hide certain items when printing */ -@media print { - div.related { - display: none; - } } \ No newline at end of file diff --git a/docs/build/html/_static/basic.css b/docs/_build/html/_static/basic.css similarity index 94% rename from docs/build/html/_static/basic.css rename to docs/_build/html/_static/basic.css index 19ced105..7ed0e58e 100644 --- a/docs/build/html/_static/basic.css +++ b/docs/_build/html/_static/basic.css @@ -4,7 +4,7 @@ * * Sphinx stylesheet -- basic theme. * - * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -82,21 +82,9 @@ div.sphinxsidebar input { } div.sphinxsidebar #searchbox input[type="text"] { - float: left; - width: 80%; - padding: 0.25em; - box-sizing: border-box; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - float: left; - width: 20%; - border-left: none; - padding: 0.25em; - box-sizing: border-box; + width: 170px; } - img { border: 0; max-width: 100%; @@ -211,11 +199,6 @@ table.modindextable td { /* -- general body styles --------------------------------------------------- */ -div.body { - min-width: 450px; - max-width: 800px; -} - div.body p, div.body dd, div.body li, div.body blockquote { -moz-hyphens: auto; -ms-hyphens: auto; @@ -349,11 +332,6 @@ table.docutils { border-collapse: collapse; } -table.align-center { - margin-left: auto; - margin-right: auto; -} - table caption span.caption-number { font-style: italic; } @@ -420,13 +398,6 @@ table.field-list td, table.field-list th { margin: 0; } -.field-name { - -moz-hyphens: manual; - -ms-hyphens: manual; - -webkit-hyphens: manual; - hyphens: manual; -} - /* -- other body styles ----------------------------------------------------- */ ol.arabic { @@ -467,14 +438,10 @@ dd { margin-left: 30px; } -dt:target, span.highlighted { +dt:target, .highlighted { background-color: #fbe54e; } -rect.highlighted { - fill: #fbe54e; -} - dl.glossary dt { font-weight: bold; font-size: 1.1em; diff --git a/docs/build/html/_static/comment-bright.png b/docs/_build/html/_static/comment-bright.png similarity index 100% rename from docs/build/html/_static/comment-bright.png rename to docs/_build/html/_static/comment-bright.png diff --git a/docs/build/html/_static/comment-close.png b/docs/_build/html/_static/comment-close.png similarity index 100% rename from docs/build/html/_static/comment-close.png rename to docs/_build/html/_static/comment-close.png diff --git a/docs/build/html/_static/comment.png b/docs/_build/html/_static/comment.png similarity index 100% rename from docs/build/html/_static/comment.png rename to docs/_build/html/_static/comment.png diff --git a/docs/build/html/_static/custom.css b/docs/_build/html/_static/custom.css similarity index 100% rename from docs/build/html/_static/custom.css rename to docs/_build/html/_static/custom.css diff --git a/docs/build/html/_static/doctools.js b/docs/_build/html/_static/doctools.js similarity index 80% rename from docs/build/html/_static/doctools.js rename to docs/_build/html/_static/doctools.js index d8928926..81634956 100644 --- a/docs/build/html/_static/doctools.js +++ b/docs/_build/html/_static/doctools.js @@ -4,7 +4,7 @@ * * Sphinx JavaScript utilities for all documentation. * - * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -45,7 +45,7 @@ jQuery.urlencode = encodeURIComponent; * it will always return arrays of strings for the value parts. */ jQuery.getQueryParameters = function(s) { - if (typeof s === 'undefined') + if (typeof s == 'undefined') s = document.location.search; var parts = s.substr(s.indexOf('?') + 1).split('&'); var result = {}; @@ -66,55 +66,29 @@ jQuery.getQueryParameters = function(s) { * span elements with the given class name. */ jQuery.fn.highlightText = function(text, className) { - function highlight(node, addItems) { - if (node.nodeType === 3) { + function highlight(node) { + if (node.nodeType == 3) { var val = node.nodeValue; var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && - !jQuery(node.parentNode).hasClass(className) && - !jQuery(node.parentNode).hasClass("nohighlight")) { - var span; - var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.className = className; - } + if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; span.appendChild(document.createTextNode(val.substr(pos, text.length))); node.parentNode.insertBefore(span, node.parentNode.insertBefore( document.createTextNode(val.substr(pos + text.length)), node.nextSibling)); node.nodeValue = val.substr(0, pos); - if (isInSVG) { - var bbox = span.getBBox(); - var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute('class', className); - var parentOfText = node.parentNode.parentNode; - addItems.push({ - "parent": node.parentNode, - "target": rect}); - } } } else if (!jQuery(node).is("button, select, textarea")) { jQuery.each(node.childNodes, function() { - highlight(this, addItems); + highlight(this); }); } } - var addItems = []; - var result = this.each(function() { - highlight(this, addItems); + return this.each(function() { + highlight(this); }); - for (var i = 0; i < addItems.length; ++i) { - jQuery(addItems[i].parent).before(addItems[i].target); - } - return result; }; /* @@ -157,21 +131,21 @@ var Documentation = { * i18n support */ TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, LOCALE : 'unknown', // gettext and ngettext don't access this so that the functions // can safely bound to a different name (_ = Documentation.gettext) gettext : function(string) { var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated === 'undefined') + if (typeof translated == 'undefined') return string; - return (typeof translated === 'string') ? translated : translated[0]; + return (typeof translated == 'string') ? translated : translated[0]; }, ngettext : function(singular, plural, n) { var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated === 'undefined') + if (typeof translated == 'undefined') return (n == 1) ? singular : plural; return translated[Documentation.PLURALEXPR(n)]; }, @@ -206,7 +180,7 @@ var Documentation = { * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 */ fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) + if (document.location.hash) window.setTimeout(function() { document.location.href += ''; }, 10); @@ -242,7 +216,7 @@ var Documentation = { var src = $(this).attr('src'); var idnum = $(this).attr('id').substr(7); $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) === 'minus.png') + if (src.substr(-9) == 'minus.png') $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); else $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); @@ -274,7 +248,7 @@ var Documentation = { var path = document.location.pathname; var parts = path.split(/\//); $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this === '..') + if (this == '..') parts.pop(); }); var url = parts.join('/'); diff --git a/docs/build/html/_static/down-pressed.png b/docs/_build/html/_static/down-pressed.png similarity index 100% rename from docs/build/html/_static/down-pressed.png rename to docs/_build/html/_static/down-pressed.png diff --git a/docs/build/html/_static/down.png b/docs/_build/html/_static/down.png similarity index 100% rename from docs/build/html/_static/down.png rename to docs/_build/html/_static/down.png diff --git a/docs/build/html/_static/file.png b/docs/_build/html/_static/file.png similarity index 100% rename from docs/build/html/_static/file.png rename to docs/_build/html/_static/file.png diff --git a/docs/build/html/_static/jquery-3.2.1.js b/docs/_build/html/_static/jquery-3.1.0.js similarity index 94% rename from docs/build/html/_static/jquery-3.2.1.js rename to docs/_build/html/_static/jquery-3.1.0.js index d2d8ca47..f2fc2747 100644 --- a/docs/build/html/_static/jquery-3.2.1.js +++ b/docs/_build/html/_static/jquery-3.1.0.js @@ -1,15 +1,16 @@ +/*eslint-disable no-unused-vars*/ /*! - * jQuery JavaScript Library v3.2.1 + * jQuery JavaScript Library v3.1.0 * https://jquery.com/ * * Includes Sizzle.js * https://sizzlejs.com/ * - * Copyright JS Foundation and other contributors + * Copyright jQuery Foundation and other contributors * Released under the MIT license * https://jquery.org/license * - * Date: 2017-03-20T18:59Z + * Date: 2016-07-07T21:44Z */ ( function( global, factory ) { @@ -82,13 +83,13 @@ var support = {}; doc.head.appendChild( script ).parentNode.removeChild( script ); } /* global Symbol */ -// Defining this global in .eslintrc.json would create a danger of using the global +// Defining this global in .eslintrc would create a danger of using the global // unguarded in another place, it seems safer to define global only for this module var - version = "3.2.1", + version = "3.1.0", // Define a local copy of jQuery jQuery = function( selector, context ) { @@ -128,14 +129,13 @@ jQuery.fn = jQuery.prototype = { // Get the Nth element in the matched element set OR // Get the whole matched element set as a clean array get: function( num ) { + return num != null ? - // Return all the elements in a clean array - if ( num == null ) { - return slice.call( this ); - } + // Return just the one element from the set + ( num < 0 ? this[ num + this.length ] : this[ num ] ) : - // Return just the one element from the set - return num < 0 ? this[ num + this.length ] : this[ num ]; + // Return all the elements in a clean array + slice.call( this ); }, // Take an array of elements and push it onto the stack @@ -236,11 +236,11 @@ jQuery.extend = jQuery.fn.extend = function() { // Recurse if we're merging plain objects or arrays if ( deep && copy && ( jQuery.isPlainObject( copy ) || - ( copyIsArray = Array.isArray( copy ) ) ) ) { + ( copyIsArray = jQuery.isArray( copy ) ) ) ) { if ( copyIsArray ) { copyIsArray = false; - clone = src && Array.isArray( src ) ? src : []; + clone = src && jQuery.isArray( src ) ? src : []; } else { clone = src && jQuery.isPlainObject( src ) ? src : {}; @@ -279,6 +279,8 @@ jQuery.extend( { return jQuery.type( obj ) === "function"; }, + isArray: Array.isArray, + isWindow: function( obj ) { return obj != null && obj === obj.window; }, @@ -353,6 +355,10 @@ jQuery.extend( { return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); }, + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + }, + each: function( obj, callback ) { var length, i = 0; @@ -537,14 +543,14 @@ function isArrayLike( obj ) { } var Sizzle = /*! - * Sizzle CSS Selector Engine v2.3.3 + * Sizzle CSS Selector Engine v2.3.0 * https://sizzlejs.com/ * * Copyright jQuery Foundation and other contributors * Released under the MIT license * http://jquery.org/license * - * Date: 2016-08-08 + * Date: 2016-01-04 */ (function( window ) { @@ -690,7 +696,7 @@ var i, // CSS string/identifier serialization // https://drafts.csswg.org/cssom/#common-serializing-idioms - rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\x80-\uFFFF\w-]/g, fcssescape = function( ch, asCodePoint ) { if ( asCodePoint ) { @@ -717,7 +723,7 @@ var i, disabledAncestor = addCombinator( function( elem ) { - return elem.disabled === true && ("form" in elem || "label" in elem); + return elem.disabled === true; }, { dir: "parentNode", next: "legend" } ); @@ -1003,54 +1009,26 @@ function createButtonPseudo( type ) { * @param {Boolean} disabled true for :disabled; false for :enabled */ function createDisabledPseudo( disabled ) { - - // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + // Known :disabled false positives: + // IE: *[disabled]:not(button, input, select, textarea, optgroup, option, menuitem, fieldset) + // not IE: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable return function( elem ) { - // Only certain elements can match :enabled or :disabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled - if ( "form" in elem ) { - - // Check for inherited disabledness on relevant non-disabled elements: - // * listed form-associated elements in a disabled fieldset - // https://html.spec.whatwg.org/multipage/forms.html#category-listed - // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled - // * option elements in a disabled optgroup - // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled - // All such elements have a "form" property. - if ( elem.parentNode && elem.disabled === false ) { - - // Option elements defer to a parent optgroup if present - if ( "label" in elem ) { - if ( "label" in elem.parentNode ) { - return elem.parentNode.disabled === disabled; - } else { - return elem.disabled === disabled; - } - } - - // Support: IE 6 - 11 - // Use the isDisabled shortcut property to check for disabled fieldset ancestors - return elem.isDisabled === disabled || + // Check form elements and option elements for explicit disabling + return "label" in elem && elem.disabled === disabled || + "form" in elem && elem.disabled === disabled || - // Where there is no isDisabled, check manually - /* jshint -W018 */ - elem.isDisabled !== !disabled && - disabledAncestor( elem ) === disabled; - } - - return elem.disabled === disabled; + // Check non-disabled form elements for fieldset[disabled] ancestors + "form" in elem && elem.disabled === false && ( + // Support: IE6-11+ + // Ancestry is covered for us + elem.isDisabled === disabled || - // Try to winnow out elements that can't be disabled before trusting the disabled property. - // Some victims get caught in our net (label, legend, menu, track), but it shouldn't - // even exist on them, let alone have a boolean value. - } else if ( "label" in elem ) { - return elem.disabled === disabled; - } - - // Remaining elements are neither :enabled nor :disabled - return false; + // Otherwise, assume any non-